✨ Features

• 🎯 Smart Generation - Creates unique, meaningful rapper names
• 🌍 Trilingual - Supports English, Chinese (中文) and Japanese (日本語)
• 📦 Zero Dependencies - Lightweight and fast
• 🔧 Dual Usage - Use as library or CLI tool
• 💪 TypeScript - Full type definitions included
• ⚡ ESM & CJS - Works with any module system

📦 Installation

npm install rap-name-generator

Or use directly with npx:

npx rap-name-generator

🚀 Quick Start

Library Usage

import { generateRapNames, generateRandomRapName } from 'rap-name-generator';

// Generate a single random name
const name = generateRandomRapName();
console.log(name); // => "Lil' FlowMaster"

// Generate multiple names with descriptions
const names = generateRapNames({ count: 5 });
// => [{ name: "Big FlowKing", description: "Represents dominance..." }, ...]

// Chinese rap names (中文说唱名)
const chineseNames = generateRapNames({ language: 'zh', count: 5 });
// => [{ name: "MC龙飞", description: "象征着力量..." }, ...]

// Japanese rap names (日本語ラップ名)
const japaneseNames = generateRapNames({ language: 'ja', count: 5 });
// => [{ name: "龍王 Flow", description: "龍の王、最強のラッパー..." }, ...]

CLI Usage

# Generate 8 random names
rap-name

# Single random name
rap-name -r

# Chinese names
rap-name -l zh

# Japanese names
rap-name -l ja

# Personalized
rap-name -n Alex -a Wild

# JSON output
rap-name -j -c 5

📖 API

generateRandomRapName(language?)

generateRandomRapName();        // English
generateRandomRapName('zh');    // Chinese
generateRandomRapName('ja');    // Japanese

generateRapNames(options?)

| Option | Type | Default | Description | |--------|------|---------|-------------| | language | 'en' \| 'zh' \| 'ja' | 'en' | Language | | count | number | 8 | Number of names | | firstName | string | - | Your name | | adjective | string | - | Style word |

Returns: Array<{ name: string, description: string }>

🎯 CLI Options

| Option | Alias | Description | |--------|-------|-------------| | --help | -h | Show help | | --random | -r | Single random name | | --count <n> | -c | Number of names | | --lang <en\|zh\|ja> | -l | Language | | --name <name> | -n | Your first name | | --adjective <word> | -a | Style word | | --json | -j | JSON output |

🎨 Name Examples

| English | Chinese | Japanese | |---------|---------|----------| | Big FlowKing | MC龙飞 | 龍王 Flow | | Lil' Phoenix | 狂野虎 | ヤング ドラゴン | | Young Dragon | 街头霸王 | 雷神 King | | Ice Storm | 雷神韵 | 炎帝マスター | | Shadow Ghost | 火焰哥 | 侍 Boss |

📄 License

MIT