UNPKG

starving-orange

Version:

Random nickname generator combining Korean adjectives and fruits

91 lines 2.95 kB
import { adjectives } from "./data/adjectives"; import { fruits, vegetables } from "./data/nouns"; declare const nouns: string[]; export interface NicknameOptions { /** 사용할 형용사 배열 (기본값: 내장 형용사 목록) */ customAdjectives?: string[]; /** 사용할 명사 배열 (기본값: 내장 명사 목록) */ customNouns?: string[]; /** 시드 값 (재현 가능한 랜덤 생성을 위해) */ seed?: number; /** 띄어쓰기 없이 닉네임 생성 (기본값: false) */ noSpacing?: boolean; } export interface GenerateResult { /** 생성된 닉네임 */ nickname: string; /** 사용된 형용사 */ adjective: string; /** 사용된 명사 */ noun: string; } /** * 한글 형용사와 명사를 조합한 랜덤 닉네임을 생성합니다. * * @param options 닉네임 생성 옵션 * @returns 생성된 닉네임 정보 * * @example * ```typescript * import { generateNickname } from 'starving-orange'; * * 1. 기본 사용법 (띄어쓰기 있음) * const result = generateNickname(); * console.log(result.nickname); // "배고픈 귤" * * 2. 띄어쓰기 없는 닉네임 * const noSpaceResult = generateNickname({ noSpacing: true }); * console.log(noSpaceResult.nickname); // "배고픈귤" * * 3. 커스텀 옵션 사용 * const customResult = generateNickname({ * customAdjectives: ["멋진", "귀여운"], * customNouns: ["딸기", "바나나"], * seed: 12345, * noSpacing: true * }); * ``` */ export declare function generateNickname(options?: NicknameOptions): GenerateResult; /** * 여러 개의 닉네임을 한번에 생성합니다. * * @param count 생성할 닉네임 개수 * @param options 닉네임 생성 옵션 * @returns 생성된 닉네임 정보 배열 * * @example * ```typescript * import { generateMultipleNicknames } from 'starving-orange'; * * const results = generateMultipleNicknames(5); * results.forEach(result => { * console.log(result.nickname); * }); * ``` */ export declare function generateMultipleNicknames(count: number, options?: NicknameOptions): GenerateResult[]; /** * 사용 가능한 형용사 목록을 반환합니다. */ export declare function getAvailableAdjectives(): string[]; /** * 사용 가능한 명사 목록을 반환합니다. */ export declare function getAvailableNouns(): string[]; /** * 사용 가능한 과일 목록을 반환합니다. * @deprecated 대신 getAvailableNouns()를 사용하세요. */ export declare function getAvailableFruits(): string[]; /** * 사용 가능한 야채 목록을 반환합니다. */ export declare function getAvailableVegetables(): string[]; /** * 가능한 닉네임 조합의 총 개수를 반환합니다. */ export declare function getTotalCombinations(options?: NicknameOptions): number; export default generateNickname; export { adjectives, fruits, vegetables, nouns }; //# sourceMappingURL=index.d.ts.map