@boruto_vk7/gerarnick

Gerador de nicks personalizados com símbolos e fontes estilizadas para Free Fire, Discord, Instagram e outros jogos/plataformas.

Baseado no algoritmo do Mobileverso com suporte a:

• 7 estilos de fontes Unicode
• 11 categorias de símbolos
• Espaços invisíveis
• Geração de variações aleatórias

🚀 Instalação

npm install @boruto_vk7/gerarnick
# ou
yarn add @boruto_vk7/gerarnick
# ou
pnpm add @boruto_vk7/gerarnick

📖 Uso Básico

Geração Simples

import NickGenerator from '@boruto_vk7/gerarnick';

// Gerar nick simples
const result = NickGenerator.generate({
  text: 'Boruto'
});

console.log(result.generated); // "Boruto"

Com Fonte Estilizada

import NickGenerator from '@boruto_vk7/gerarnick';

// Aplicar fonte Fullwidth (grandes)
const result = NickGenerator.generate({
  text: 'Boruto',
  fonts: ['fullwidth']
});

console.log(result.generated); // "Ｂｏｒｕｔｏ"

Com Símbolos

import NickGenerator from '@boruto_vk7/gerarnick';

// Adicionar símbolos decorativos
const result = NickGenerator.generate({
  text: 'Boruto',
  leftSymbol: '꧁',
  rightSymbol: '꧂'
});

console.log(result.generated); // "꧁ Boruto ꧂"

Combinando Múltiplas Opções

import NickGenerator from '@boruto_vk7/gerarnick';

const result = NickGenerator.generate({
  text: 'Boruto',
  fonts: ['fullwidth', 'circled'],
  leftSymbol: '✨',
  rightSymbol: '✨',
  addInvisibleSpace: true
});

console.log(result.generated); // "✨ Ⓑⓞⓡⓤⓣⓞ ✨ㅤ"

🎨 Estilos de Fonte Disponíveis

| ID | Nome | Exemplo | |---|---|---| | fullwidth | Fullwidth (Grandes) | Ｂｏｒｕｔｏ | | superscript | Superscript | ᴮᵒʳᵘᵗᵒ | | subscript | Subscript | ᵦₒᵣᵤₜₒ | | small_caps | Maiúsculas Pequenas | ʙᴏʀᴜᴛᴏ | | circled | Circuladas | Ⓑⓞⓡⓤⓣⓞ | | bold_italic | Negrito Itálico | 𝑩𝒐𝒓𝒖𝒕𝒐 | | fraktur | Fraktur (Gótico) | 𝔉𝔯𝔞𝔨𝔱𝔲𝔯 |

🎯 Categorias de Símbolos

• Bordas & Decoração: ꧁ ꧂ ✿ ❀ ✦ ✧ ★ ☆ ⭐ ✨
• Cantos: 「」『』【】〖〗
• Divisores: ━ ─ • ◦ ◾ ◽ ▪ ▫ ■ □
• Setas: → ← ↑ ↓ ↔ ↕ ⇒ ⇐ ⇑ ⇓
• Matemática: ± × ÷ ≈ ≠ ≤ ≥ ∞ √ ∑
• Geométricos: ◆ ◇ ■ □ ▲ △ ▼ ▽ ◎ ●
• Corações: ❤ 💔 💕 💖 💗 💘 💝 💞 💟 ♡
• Estrelas: ⭐ ✨ ★ ☆ ✦ ✧ ✩ ✪ ✫ ✬
• Japonês: あ い う え お か き く け こ
• Coreano: 가 나 다 라 마 바 사 아 자 차
• Chinês: 中 国 日 本 火 水 木 金 土 人

📚 API Completa

NickGenerator.generate(options)

Gera um nick personalizado com as opções fornecidas.

Parâmetros:

interface NickGeneratorOptions {
  text: string;                    // Texto do nick (obrigatório)
  fonts?: string[];                // IDs de estilos de fonte
  leftSymbol?: string;             // Símbolo esquerdo
  rightSymbol?: string;            // Símbolo direito
  addInvisibleSpace?: boolean;     // Adicionar espaço invisível
  spaceType?: 'large' | 'medium' | 'small';  // Tipo de espaço
}

Retorno:

interface GeneratedNick {
  original: string;    // Texto original
  generated: string;   // Nick gerado
  fonts: string[];     // Fontes aplicadas
  leftSymbol?: string; // Símbolo esquerdo usado
  rightSymbol?: string; // Símbolo direito usado
}

NickGenerator.generateWithRandomFonts(text, fontCount?)

Gera um nick com fontes aleatórias.

const result = NickGenerator.generateWithRandomFonts('Boruto', 2);

NickGenerator.generateWithRandomSymbols(text)

Gera um nick com símbolos aleatórios.

const result = NickGenerator.generateWithRandomSymbols('Boruto');

NickGenerator.generateVariations(text, count?)

Gera múltiplas variações de um nick.

const variations = NickGenerator.generateVariations('Boruto', 5);
// Retorna array com 5 variações diferentes

NickGenerator.applyFont(text, fontId)

Aplica apenas um estilo de fonte.

const result = NickGenerator.applyFont('Boruto', 'fullwidth');
// "Ｂｏｒｕｔｏ"

NickGenerator.applyFonts(text, fontIds)

Aplica múltiplos estilos de fonte em sequência.

const result = NickGenerator.applyFonts('A', ['fullwidth', 'circled']);

NickGenerator.addSymbols(text, leftSymbol?, rightSymbol?)

Adiciona símbolos ao redor do texto.

const result = NickGenerator.addSymbols('Boruto', '✨', '✨');
// "✨ Boruto ✨"

NickGenerator.addInvisibleSpace(text, spaceType?)

Adiciona espaço invisível ao final do texto.

const result = NickGenerator.addInvisibleSpace('Boruto', 'large');
// "Borutomㅤ"

getAllFontStyles()

Retorna todos os estilos de fonte disponíveis.

import { getAllFontStyles } from '@boruto_vk7/gerarnick';

const fonts = getAllFontStyles();

getAllSymbols()

Retorna todos os símbolos disponíveis.

import { getAllSymbols } from '@boruto_vk7/gerarnick';

const symbols = getAllSymbols();

getSymbolsByCategory(categoryId)

Retorna símbolos de uma categoria específica.

import { getSymbolsByCategory } from '@boruto_vk7/gerarnick';

const hearts = getSymbolsByCategory('hearts');
// ["❤", "💔", "💕", ...]

💡 Exemplos Práticos

Exemplo 1: Nick para Free Fire

import NickGenerator from '@boruto_vk7/gerarnick';

const nick = NickGenerator.generate({
  text: 'Player123',
  fonts: ['fullwidth'],
  leftSymbol: '꧁',
  rightSymbol: '꧂'
});

console.log(nick.generated); // "꧁ Ｐｌａｙｅｒ１２３ ꧂"

Exemplo 2: Gerar Variações Aleatórias

import NickGenerator from '@boruto_vk7/gerarnick';

const variations = NickGenerator.generateVariations('Ninja', 10);

variations.forEach((nick, index) => {
  console.log(`${index + 1}. ${nick.generated}`);
});

Exemplo 3: Usar em um CLI

import NickGenerator, { getAllFontStyles } from '@boruto_vk7/gerarnick';

const text = process.argv[2] || 'DefaultNick';
const fonts = getAllFontStyles().slice(0, 2).map(f => f.id);

const result = NickGenerator.generate({
  text,
  fonts,
  leftSymbol: '✨',
  rightSymbol: '✨'
});

console.log(`Original: ${result.original}`);
console.log(`Gerado: ${result.generated}`);

Exemplo 4: Integrar em um Discord Bot

import NickGenerator from '@boruto_vk7/gerarnick';

bot.command('nick', (ctx) => {
  const text = ctx.args.join(' ') || 'Player';
  const nick = NickGenerator.generateWithRandomSymbols(text);
  ctx.reply(`Seu novo nick: \`${nick.generated}\``);
});

🧪 Testes

npm run test              # Executar testes
npm run test:watch       # Modo watch
npm run test:coverage    # Cobertura de testes

🔨 Desenvolvimento

npm run build            # Compilar TypeScript
npm run lint             # Verificar linting
npm run format           # Formatar código

📦 Estrutura do Projeto

gerarnick/
├── src/
│   ├── index.ts         # Classe principal NickGenerator
│   ├── fonts.ts         # Transformações de fontes
│   └── symbols.ts       # Símbolos e categorias
├── tests/
│   └── index.test.ts    # Testes unitários
├── dist/                # Código compilado (gerado)
├── package.json
├── tsconfig.json
└── README.md

🤝 Contribuindo

Contribuições são bem-vindas! Por favor:

1. Faça um fork do projeto
2. Crie uma branch para sua feature (git checkout -b feature/AmazingFeature)
3. Commit suas mudanças (git commit -m 'Add some AmazingFeature')
4. Push para a branch (git push origin feature/AmazingFeature)
5. Abra um Pull Request

📝 Licença

Este projeto está licenciado sob a Licença MIT - veja o arquivo LICENSE para detalhes.

🙏 Créditos

• Inspirado no Mobileverso
• Símbolos Unicode do Unicode.org
• Desenvolvido por @Boruto_vk7

📞 Suporte

Se encontrar problemas ou tiver sugestões, abra uma issue.

Divirta-se criando nicks personalizados! 🎮✨