wbw-cli-tools-lib 1.0.0

package/README.md

@@ -0,0 +1,291 @@
+# wbw-cli-tools-lib
+
+CLI 工具库 - 封装 commander、@inquirer/prompts、ora、chalk、figlet、cli-cursor，提供链式 API、工厂模式、事件系统与插件机制。
+
+## 安装
+
+```bash
+npm install wbw-cli-tools-lib
+```
+
+## 快速开始
+
+```ts
+import { CliTools } from 'wbw-cli-tools-lib';
+
+const cli = CliTools.create({
+  commandName: 'my-cli',
+  commandDescription: '我的CLI工具',
+});
+
+cli
+  .printBanner('My App')
+  .addOption('-n, --name <name>', '你的名字', 'World')
+  .addOption('-d, --debug', '调试模式')
+  .addOption('-p, --port <port>', '端口号', 3000)
+  .onAction(async (opts) => {
+    if (opts.debug) {
+      cli.spinnerStart('加载中...');
+      await new Promise(r => setTimeout(r, 1000));
+      cli.spinnerSucceed('完成!');
+    }
+    cli.success(`你好, ${opts.name}! 端口: ${opts.port}`);
+  });
+
+cli.parse();
+```
+
+## 核心特性
+
+### 工厂模式
+
+```ts
+const cli = CliTools.create({
+  commandName: 'my-cli',
+  commandDescription: '描述',
+  color: true,
+  cursor: true,
+  logger: myLogger,
+});
+```
+
+### 链式 API
+
+```ts
+cli
+  .setName('my-cli')
+  .setVersion('1.0.0')
+  .addOption('-d, --debug', '调试模式')
+  .success('操作成功')
+  .info('提示信息')
+  .warn('警告信息')
+  .error('错误信息');
+```
+
+### 事件系统
+
+```ts
+// 监听事件
+cli.on('spinner:start', ({ text }) => console.log(`开始: ${text}`));
+cli.on('spinner:stop', () => console.log('停止'));
+cli.on('prompt:cancel', ({ type }) => console.log(`取消: ${type}`));
+cli.on('error', ({ error, context }) => console.error(context, error));
+
+// 取消监听
+cli.off('spinner:start', handler);
+```
+
+**可用事件：**
+
+| 事件 | 数据 | 说明 |
+|------|------|------|
+| `init` | `void` | 实例创建后触发 |
+| `parse:before` | `void` | 命令解析前触发 |
+| `parse:after` | `void` | 命令解析后触发 |
+| `spinner:start` | `{ text }` | Spinner 启动 |
+| `spinner:stop` | `void` | Spinner 停止 |
+| `spinner:succeed` | `{ text? }` | Spinner 成功 |
+| `spinner:fail` | `{ text? }` | Spinner 失败 |
+| `prompt:before` | `{ type, message }` | Prompt 开始前 |
+| `prompt:after` | `{ type, result }` | Prompt 结束后 |
+| `prompt:cancel` | `{ type }` | Prompt 被取消 |
+| `plugin:load` | `{ name }` | 插件加载 |
+| `error` | `{ error, context? }` | 错误发生 |
+
+### 插件系统
+
+```ts
+const myPlugin: CliToolsPlugin = {
+  name: 'my-plugin',
+  version: '1.0.0',
+  install(cli) {
+    cli.on('init', () => console.log('Plugin loaded'));
+  },
+};
+
+// 注册插件
+await cli.use(myPlugin);
+
+// 获取已加载插件
+console.log(cli.getPlugins()); // ['my-plugin']
+```
+
+### 配置文件加载
+
+```ts
+// .myclirc
+{ "theme": "dark", "verbose": true }
+
+// 加载配置
+const { config, source } = await cli.loadConfig({
+  sources: ['.myclirc', 'package.json#myCli'],
+  defaults: { theme: 'light', verbose: false },
+});
+
+// 获取配置值
+const theme = cli.getConfigValue<string>('theme', 'light');
+```
+
+### 自定义日志器
+
+```ts
+const myLogger: Logger = {
+  level: 'info',  // 只显示 info 及以上级别
+  log: (...args) => console.log('[LOG]', ...args),
+  error: (...args) => console.error('[ERR]', ...args),
+  warn: (...args) => console.warn('[WARN]', ...args),
+  info: (...args) => console.info('[INFO]', ...args),
+  debug: (...args) => console.debug('[DEBUG]', ...args),
+};
+
+const cli = CliTools.create({ logger: myLogger });
+```
+
+### 错误处理
+
+所有 prompt 方法在用户取消时返回 `null`（而非抛出异常）：
+
+```ts
+const name = await cli.promptInput('请输入名字:');
+if (name === null) {
+  cli.warn('已取消');
+  return;
+}
+
+const lang = await cli.promptSelect('选择语言:', ['TS', 'JS']);
+if (lang === null) return;
+
+const pwd = await cli.promptPassword('密码:', { minLength: 6 });
+if (pwd === null) return;
+```
+
+### 泛型 ChoiceOption
+
+```ts
+// 使用对象选项
+await cli.promptSelect('选择:', [
+  { value: 'ts', name: 'TypeScript' },
+  { value: 'js', name: 'JavaScript' },
+]);
+
+// 简写（字符串）
+await cli.promptSelect('选择:', ['TypeScript', 'JavaScript']);
+
+// 带描述和禁用状态
+await cli.promptSelect('选择:', [
+  { value: 'ts', name: 'TypeScript', description: '强类型' },
+  { value: 'legacy', name: 'Legacy', disabled: '已废弃' },
+]);
+
+// checkbox 默认选中
+await cli.promptCheckbox('选择功能:', [
+  { value: 'eslint', name: 'ESLint', checked: true },
+  { value: 'prettier', name: 'Prettier' },
+]);
+```
+
+## API 列表
+
+### 工厂方法
+
+| 方法 | 说明 |
+|------|------|
+| `CliTools.create(options?)` | 创建实例 |
+
+### Commander
+
+| 方法 | 说明 |
+|------|------|
+| `setName(name)` | 设置命令名称 |
+| `setVersion(version)` | 设置版本号 |
+| `setDescription(desc)` | 设置描述 |
+| `addOption(flags, desc, default?)` | 添加选项 |
+| `addArgument(name, desc)` | 添加参数 |
+| `addCommand(name, desc, action)` | 注册子命令 |
+| `onAction(callback)` | 设置主回调 |
+| `parse(argv?)` | 解析参数 |
+| `parseAsync(argv?)` | 异步解析 |
+| `getProgram()` | 获取 Commander 实例 |
+
+### Inquirer Prompts
+
+| 方法 | 返回值 | 说明 |
+|------|--------|------|
+| `promptInput(msg, opts?)` | `string \| null` | 文本输入 |
+| `promptConfirm(msg, default?)` | `boolean \| null` | 确认提示 |
+| `promptSelect(msg, choices)` | `string \| null` | 列表选择 |
+| `promptCheckbox(msg, choices)` | `string[] \| null` | 多选 |
+| `promptPassword(msg, opts?)` | `string \| null` | 密码输入 |
+
+### Spinner
+
+| 方法 | 说明 |
+|------|------|
+| `spinnerStart(text, opts?)` | 启动 Spinner |
+| `spinnerStop()` | 停止 |
+| `spinnerSucceed(text?)` | 成功状态 |
+| `spinnerFail(text?)` | 失败状态 |
+| `spinnerWarn(text?)` | 警告状态 |
+| `spinnerInfo(text?)` | 信息状态 |
+| `spinnerPersist(symbol?, text?)` | 持久化 |
+| `spinnerText(text)` | 更新文本 |
+| `getSpinner()` | 获取实例 |
+
+### 颜色输出
+
+| 方法 | 说明 |
+|------|------|
+| `logRed/Green/Yellow/Blue/Cyan/Magenta/White/Gray(text)` | 彩色输出 |
+| `logBold(text)` | 加粗 |
+| `logUnderline(text)` | 下划线 |
+| `success(text)` | ✔ 成功 |
+| `error(text)` | ✖ 错误 |
+| `warn(text)` | ⚠ 警告 |
+| `info(text)` | ℹ 信息 |
+
+### ASCII Art
+
+| 方法 | 说明 |
+|------|------|
+| `printBanner(text, font?)` | 生成并输出 |
+| `banner(text, font?)` | 生成（不输出） |
+| `bannerAsync(text, font?)` | 异步生成 |
+| `getFonts()` | 获取字体列表 |
+
+### 光标控制
+
+| 方法 | 说明 |
+|------|------|
+| `cursorShow()` | 显示 |
+| `cursorHide()` | 隐藏 |
+| `cursorToggle(force?)` | 切换 |
+
+### 日志工具
+
+| 方法 | 说明 |
+|------|------|
+| `print(text)` | 输出日志 |
+| `logWithPrefix(prefix, text)` | 带前缀日志 |
+| `newline()` | 空行 |
+| `divider(char?, length?)` | 分隔线 |
+
+### 事件与插件
+
+| 方法 | 说明 |
+|------|------|
+| `on(event, handler)` | 监听事件 |
+| `off(event, handler)` | 取消监听 |
+| `use(plugin)` | 注册插件 |
+| `getPlugins()` | 获取插件列表 |
+
+### 配置
+
+| 方法 | 说明 |
+|------|------|
+| `loadConfig(options)` | 加载配置文件 |
+| `getConfig()` | 获取配置 |
+| `getConfigValue<T>(key, default?)` | 获取配置值 |
+
+## 许可证
+
+GPLv3.0-only

package/dist/esm/index.d.ts

@@ -0,0 +1,738 @@
+import { Command } from "commander";
+import { Options, Ora } from "ora";
+//#region src/types.d.ts
+/**
+ * CLI 工具配置选项
+ * @public
+ */
+interface CliToolsOptions {
+  /**
+   * 是否启用彩色输出（默认：true）
+   */
+  color?: boolean;
+  /**
+   * 是否启用光标控制（默认：true）
+   */
+  cursor?: boolean;
+  /**
+   * 默认命令名称
+   */
+  commandName?: string;
+  /**
+   * 默认命令描述
+   */
+  commandDescription?: string;
+  /**
+   * 自定义日志器（默认：console）
+   */
+  logger?: Logger;
+  /**
+   * 已注册的插件列表
+   */
+  plugins?: CliToolsPlugin[];
+}
+/**
+ * 日志级别
+ * @public
+ */
+type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+/**
+ * 自定义日志器接口
+ * @public
+ */
+interface Logger {
+  /** 当前日志级别（低于此级别的日志将被忽略） */
+  level?: LogLevel;
+  log: (...args: unknown[]) => void;
+  error?: (...args: unknown[]) => void;
+  warn?: (...args: unknown[]) => void;
+  info?: (...args: unknown[]) => void;
+  debug?: (...args: unknown[]) => void;
+}
+/**
+ * 事件映射表
+ * @public
+ */
+interface CliToolsEventMap {
+  /** 实例创建后触发 */
+  'init': void;
+  /** 命令解析前触发 */
+  'parse:before': void;
+  /** 命令解析后触发 */
+  'parse:after': void;
+  /** Spinner 启动时触发 */
+  'spinner:start': {
+    text: string;
+  };
+  /** Spinner 停止时触发 */
+  'spinner:stop': void;
+  /** Spinner 成功时触发 */
+  'spinner:succeed': {
+    text?: string;
+  };
+  /** Spinner 失败时触发 */
+  'spinner:fail': {
+    text?: string;
+  };
+  /** Prompt 开始前触发 */
+  'prompt:before': {
+    type: string;
+    message: string;
+  };
+  /** Prompt 结束后触发 */
+  'prompt:after': {
+    type: string;
+    result: unknown;
+  };
+  /** Prompt 被取消时触发 */
+  'prompt:cancel': {
+    type: string;
+  };
+  /** 插件加载时触发 */
+  'plugin:load': {
+    name: string;
+  };
+  /** 错误发生时触发 */
+  'error': {
+    error: Error;
+    context?: string;
+  };
+}
+/**
+ * 事件回调函数类型
+ * @public
+ */
+type CliToolsEventHandler<T = void> = (data: T) => void | Promise<void>;
+/**
+ * 插件接口
+ * @public
+ */
+interface CliToolsPlugin {
+  /** 插件名称 */
+  name: string;
+  /** 插件版本 */
+  version?: string;
+  /**
+   * 安装插件
+   * @param cli - CliTools 实例
+   */
+  install(cli: unknown): void | Promise<void>;
+}
+/**
+ * 列表选项（用于 select/checkbox 提示）
+ * @public
+ */
+interface ChoiceOption<T = string> {
+  /** 选项值 */
+  value: T;
+  /** 选项显示名称 */
+  name: string;
+  /** 选项描述 */
+  description?: string;
+  /** 是否禁用 */
+  disabled?: boolean | string;
+  /** 是否默认选中（仅 checkbox） */
+  checked?: boolean;
+}
+/**
+ * promptPassword 选项
+ * @public
+ */
+interface PromptPasswordOptions {
+  /** 遮罩字符（默认 '*'） */
+  mask?: string | boolean;
+  /** 最小长度（0 = 不限制） */
+  minLength?: number;
+  /** 验证函数 */
+  validate?: (value: string) => boolean | string | Promise<string | boolean>;
+}
+/**
+ * promptInput 选项
+ * @public
+ */
+interface PromptInputOptions {
+  /** 默认值 */
+  defaultValue?: string;
+  /** 验证函数 */
+  validate?: (value: string) => boolean | string | Promise<string | boolean>;
+  /** 是否必填 */
+  required?: boolean;
+}
+/**
+ * 配置文件加载选项
+ * @public
+ */
+interface LoadConfigOptions {
+  /** 配置文件路径列表（按优先级排序） */
+  sources?: string[];
+  /** 默认配置 */
+  defaults?: Record<string, unknown>;
+  /** 是否自动合并 defaults（默认：true） */
+  mergeDefaults?: boolean;
+}
+/**
+ * 已解析的配置结果
+ * @public
+ */
+interface ResolvedConfig {
+  /** 配置来源文件路径 */
+  source?: string;
+  /** 配置内容 */
+  config: Record<string, unknown>;
+}
+/**
+ * Option 类型安全定义
+ * @public
+ */
+type OptionValue = string | boolean | number;
+//#endregion
+//#region src/cli-tools.d.ts
+/**
+ * CLI 工具库主类
+ *
+ * 封装 commander、@inquirer/prompts、ora、chalk、figlet、cli-cursor，
+ * 提供链式 API、工厂模式、事件系统与插件机制。
+ *
+ * @example
+ * ```ts
+ * const cli = CliTools.create({
+ *   commandName: 'my-cli',
+ *   commandDescription: '我的CLI工具',
+ * });
+ *
+ * cli
+ *   .printBanner('My App')
+ *   .addOption('-d, --debug', '调试模式')
+ *   .onAction(async (opts, cmd) => {
+ *     if (opts.debug) cli.success('调试已开启');
+ *   });
+ *
+ * cli.parse();
+ * ```
+ *
+ * @public
+ */
+declare class CliTools {
+  private _program;
+  private _spinner;
+  private _options;
+  private _cursorHidden;
+  private _exitHandlerRegistered;
+  private _plugins;
+  private _eventHandlers;
+  private _config;
+  private constructor();
+  /**
+   * 工厂方法：创建 CliTools 实例
+   *
+   * @param options - 配置选项
+   * @returns CliTools 实例
+   *
+   * @example
+   * ```ts
+   * const cli = CliTools.create({
+   *   commandName: 'my-cli',
+   *   commandDescription: '我的CLI工具',
+   *   logger: myLogger,
+   *   plugins: [myPlugin],
+   * });
+   * ```
+   */
+  static create(options?: CliToolsOptions): CliTools;
+  /**
+   * 监听事件
+   *
+   * @param event - 事件名称
+   * @param handler - 事件处理器
+   * @returns 当前实例（支持链式调用）
+   *
+   * @example
+   * ```ts
+   * cli.on('spinner:stop', () => console.log('Spinner 已停止'));
+   * cli.on('error', ({ error }) => console.error(error));
+   * ```
+   */
+  on<K extends keyof CliToolsEventMap>(event: K, handler: CliToolsEventHandler<CliToolsEventMap[K]>): this;
+  /**
+   * 取消监听事件
+   *
+   * @param event - 事件名称
+   * @param handler - 要移除的事件处理器
+   * @returns 当前实例
+   */
+  off<K extends keyof CliToolsEventMap>(event: K, handler: CliToolsEventHandler<CliToolsEventMap[K]>): this;
+  /**
+   * 触发事件（仅内部使用）
+   *
+   * @private
+   */
+  private _emit;
+  /**
+   * 注册插件
+   *
+   * @param plugin - 插件实例
+   * @returns 当前实例
+   *
+   * @example
+   * ```ts
+   * const myPlugin: CliToolsPlugin = {
+   *   name: 'my-plugin',
+   *   install(cli) {
+   *     cli.on('init', () => console.log('Plugin loaded'));
+   *   },
+   * };
+   * cli.use(myPlugin);
+   * ```
+   */
+  use(plugin: CliToolsPlugin): Promise<this>;
+  /**
+   * 获取已加载的插件列表
+   *
+   * @returns 插件名称数组
+   */
+  getPlugins(): string[];
+  /**
+   * 加载配置文件
+   *
+   * 支持 JSON 格式的配置文件。按 sources 顺序查找，优先使用第一个找到的文件。
+   *
+   * @param options - 配置加载选项
+   * @returns 解析后的配置结果，未找到文件则返回 defaults
+   *
+   * @example
+   * ```ts
+   * const { config } = await cli.loadConfig({
+   *   sources: ['.myclirc', 'package.json#myCli'],
+   *   defaults: { theme: 'dark', verbose: false },
+   * });
+   * console.log(config.theme); // 'dark'
+   * ```
+   */
+  loadConfig(options?: LoadConfigOptions): Promise<ResolvedConfig>;
+  /**
+   * 获取已加载的配置
+   *
+   * @returns 当前配置对象
+   */
+  getConfig(): Record<string, unknown>;
+  /**
+   * 获取配置值（支持类型断言）
+   *
+   * @param key - 配置键名
+   * @param defaultValue - 默认值
+   * @returns 配置值
+   *
+   * @example
+   * ```ts
+   * const theme = cli.getConfigValue<string>('theme', 'light');
+   * ```
+   */
+  getConfigValue<T>(key: string, defaultValue?: T): T;
+  /**
+   * 设置命令名称
+   *
+   * @param name - 命令名称
+   * @returns 当前实例
+   */
+  setName(name: string): this;
+  /**
+   * 设置命令版本号
+   *
+   * @param version - 版本号字符串
+   * @returns 当前实例
+   */
+  setVersion(version: string): this;
+  /**
+   * 设置命令描述
+   *
+   * @param description - 描述文本
+   * @returns 当前实例
+   */
+  setDescription(description: string): this;
+  /**
+   * 添加命令行选项
+   *
+   * @param flags - 选项标志（如 `'-d, --debug'`）
+   * @param description - 选项描述
+   * @param defaultValue - 默认值（仅支持 string | boolean | number）
+   * @returns 当前实例
+   *
+   * @example
+   * ```ts
+   * cli.addOption('-n, --name <name>', '你的名字', 'World');
+   * cli.addOption('-d, --debug', '调试模式');
+   * cli.addOption('-p, --port <port>', '端口号', 3000);
+   * ```
+   */
+  addOption(flags: string, description: string, defaultValue?: OptionValue): this;
+  /**
+   * 添加命令行参数
+   *
+   * @param name - 参数名称（如 `'<file>'` 或 `'[file]'`）
+   * @param description - 参数描述
+   * @returns 当前实例
+   */
+  addArgument(name: string, description: string): this;
+  /**
+   * 注册子命令
+   *
+   * @param name - 子命令名称
+   * @param description - 子命令描述
+   * @param action - 子命令执行回调
+   * @returns 当前实例
+   *
+   * @example
+   * ```ts
+   * cli.addCommand('init', '初始化项目', async (options, cmd) => {
+   *   console.log('项目已初始化');
+   * });
+   * ```
+   */
+  addCommand(name: string, description: string, action: (...args: unknown[]) => void | Promise<void>): this;
+  /**
+   * 设置主命令的执行回调
+   *
+   * @param action - 执行回调，参数为解析后的 options 和 Command 实例
+   * @returns 当前实例
+   */
+  onAction(action: (options: Record<string, unknown>, command: Command) => void | Promise<void>): this;
+  /**
+   * 解析命令行参数
+   *
+   * @param argv - 参数数组（默认 process.argv）
+   * @returns 当前实例
+   */
+  parse(argv?: string[]): this;
+  /**
+   * 解析命令行参数并返回 Command 实例
+   *
+   * @param argv - 参数数组（默认 process.argv）
+   * @returns Commander Command 实例
+   */
+  parseAsync(argv?: string[]): Promise<Command>;
+  /**
+   * 获取底层 Commander Command 实例，用于高级定制
+   *
+   * @returns Commander Command 实例
+   */
+  getProgram(): Command;
+  /**
+   * 文本输入提示
+   *
+   * @param message - 提示消息
+   * @param options - 额外配置
+   * @returns 用户输入的文本，用户取消返回 null
+   *
+   * @example
+   * ```ts
+   * const name = await cli.promptInput('请输入你的名字:', { defaultValue: 'wbw' });
+   * if (name === null) cli.warn('已取消');
+   * ```
+   */
+  promptInput(message: string, options?: PromptInputOptions): Promise<string | null>;
+  /**
+   * 确认提示（是/否）
+   *
+   * @param message - 提示消息
+   * @param defaultValue - 默认值
+   * @returns 用户选择的结果，用户取消返回 null
+   *
+   * @example
+   * ```ts
+   * const ok = await cli.promptConfirm('确认继续?');
+   * if (ok === null) cli.warn('已取消');
+   * ```
+   */
+  promptConfirm(message: string, defaultValue?: boolean): Promise<boolean | null>;
+  /**
+   * 列表选择提示
+   *
+   * @param message - 提示消息
+   * @param choices - 选项数组
+   * @returns 用户选择的值，用户取消返回 null
+   *
+   * @example
+   * ```ts
+   * const lang = await cli.promptSelect('选择语言:', ['TypeScript', 'JavaScript']);
+   * if (lang === null) return;
+   * cli.success(`你选择了: ${lang}`);
+   * ```
+   */
+  promptSelect(message: string, choices: (string | ChoiceOption)[]): Promise<string | null>;
+  /**
+   * 多选提示（复选框）
+   *
+   * @param message - 提示消息
+   * @param choices - 选项数组
+   * @returns 用户选择的值数组，用户取消返回 null
+   *
+   * @example
+   * ```ts
+   * const features = await cli.promptCheckbox('选择功能:', ['ESLint', 'Prettier']);
+   * if (features === null) return;
+   * cli.success(`已选择: ${features.join(', ')}`);
+   * ```
+   */
+  promptCheckbox(message: string, choices: (string | ChoiceOption)[]): Promise<string[] | null>;
+  /**
+   * 密码输入提示（内容隐藏）
+   *
+   * @param message - 提示消息
+   * @param options - 密码选项（mask、minLength、validate）
+   * @returns 用户输入的密码文本，用户取消返回 null
+   *
+   * @example
+   * ```ts
+   * const pwd = await cli.promptPassword('请输入密码:', { minLength: 6 });
+   * if (pwd === null) return;
+   * cli.success(`密码长度: ${pwd.length}`);
+   * ```
+   */
+  promptPassword(message: string, options?: PromptPasswordOptions): Promise<string | null>;
+  /**
+   * 创建并启动 Spinner
+   *
+   * @param text - 显示文本
+   * @param options - ora 配置选项
+   * @returns 当前实例
+   *
+   * @example
+   * ```ts
+   * cli.spinnerStart('加载中...').spinnerSucceed('完成!');
+   * ```
+   */
+  spinnerStart(text: string, options?: Options): this;
+  /**
+   * 停止 Spinner
+   *
+   * @returns 当前实例
+   */
+  spinnerStop(): this;
+  /**
+   * Spinner 成功状态（✔）
+   *
+   * @param text - 成功消息
+   * @returns 当前实例
+   */
+  spinnerSucceed(text?: string): this;
+  /**
+   * Spinner 失败状态（✖）
+   *
+   * @param text - 失败消息
+   * @returns 当前实例
+   */
+  spinnerFail(text?: string): this;
+  /**
+   * Spinner 警告状态（⚠）
+   *
+   * @param text - 警告消息
+   * @returns 当前实例
+   */
+  spinnerWarn(text?: string): this;
+  /**
+   * Spinner 信息状态（ℹ）
+   *
+   * @param text - 信息消息
+   * @returns 当前实例
+   */
+  spinnerInfo(text?: string): this;
+  /**
+   * 持久化 Spinner（停止并保留文本）
+   *
+   * @param symbol - 替代符号
+   * @param text - 保留的文本
+   * @returns 当前实例
+   */
+  spinnerPersist(symbol?: string, text?: string): this;
+  /**
+   * 更新 Spinner 文本
+   *
+   * @param text - 新文本
+   * @returns 当前实例
+   */
+  spinnerText(text: string): this;
+  /**
+   * 获取当前 Spinner 实例（用于高级操作）
+   *
+   * @returns 当前 Spinner 实例，若未创建则返回 null
+   */
+  getSpinner(): Ora | null;
+  /** @private */
+  private _out;
+  /** @private */
+  private _logWithLevel;
+  /** @private */
+  private _logDebug;
+  logRed(text: string): this;
+  logGreen(text: string): this;
+  logYellow(text: string): this;
+  logBlue(text: string): this;
+  logCyan(text: string): this;
+  logMagenta(text: string): this;
+  logWhite(text: string): this;
+  logGray(text: string): this;
+  logBold(text: string): this;
+  logUnderline(text: string): this;
+  /**
+   * 输出成功信息（绿色 + ✔）
+   *
+   * @param text - 文本内容
+   * @returns 当前实例
+   *
+   * @example
+   * ```ts
+   * cli.success('操作成功!');
+   * ```
+   */
+  success(text: string): this;
+  /**
+   * 输出错误信息（红色 + ✖）
+   *
+   * @param text - 文本内容
+   * @returns 当前实例
+   *
+   * @example
+   * ```ts
+   * cli.error('操作失败!');
+   * ```
+   */
+  error(text: string): this;
+  /**
+   * 输出警告信息（黄色 + ⚠）
+   *
+   * @param text - 文本内容
+   * @returns 当前实例
+   *
+   * @example
+   * ```ts
+   * cli.warn('请注意!');
+   * ```
+   */
+  warn(text: string): this;
+  /**
+   * 输出提示信息（蓝色 + ℹ）
+   *
+   * @param text - 文本内容
+   * @returns 当前实例
+   *
+   * @example
+   * ```ts
+   * cli.info('提示信息');
+   * ```
+   */
+  info(text: string): this;
+  /**
+   * 生成并输出 ASCII Art 文本
+   *
+   * @param text - 要转换的文本
+   * @param font - figlet 字体名称（默认 'Standard'）
+   * @returns 当前实例
+   *
+   * @example
+   * ```ts
+   * cli.printBanner('Hello');
+   * cli.printBanner('Big', 'Big');
+   * ```
+   */
+  printBanner(text: string, font?: string): this;
+  /**
+   * 生成 ASCII Art 文本（不输出）
+   *
+   * @param text - 要转换的文本
+   * @param font - figlet 字体名称（默认 'Standard'）
+   * @returns 生成的 ASCII Art 文本
+   *
+   * @example
+   * ```ts
+   * const art = cli.banner('Hello');
+   * fs.writeFileSync('banner.txt', art);
+   * ```
+   */
+  banner(text: string, font?: string): string;
+  /**
+   * 异步生成 ASCII Art 文本
+   *
+   * @param text - 要转换的文本
+   * @param font - figlet 字体名称（默认 'Standard'）
+   * @returns Promise，解析为 ASCII Art 文本
+   */
+  bannerAsync(text: string, font?: string): Promise<string>;
+  /**
+   * 获取所有可用的 figlet 字体列表
+   *
+   * @returns 字体名称数组
+   */
+  getFonts(): string[];
+  /** @private */
+  private _hideCursor;
+  /** @private */
+  private _showCursor;
+  /** @private */
+  private _registerExitHandler;
+  /**
+   * 显示终端光标
+   *
+   * @returns 当前实例
+   */
+  cursorShow(): this;
+  /**
+   * 隐藏终端光标
+   *
+   * @returns 当前实例
+   */
+  cursorHide(): this;
+  /**
+   * 切换光标可见性
+   *
+   * @param force - true 显示，false 隐藏，undefined 切换
+   * @returns 当前实例
+   */
+  cursorToggle(force?: boolean): this;
+  /**
+   * 输出普通日志
+   *
+   * @param text - 文本内容
+   * @returns 当前实例
+   *
+   * @example
+   * ```ts
+   * cli.print('Hello World');
+   * ```
+   */
+  print(text: string): this;
+  /**
+   * 输出带前缀的日志
+   *
+   * @param prefix - 前缀文本
+   * @param text - 日志内容
+   * @returns 当前实例
+   *
+   * @example
+   * ```ts
+   * cli.logWithPrefix('[INFO]', '任务完成');
+   * ```
+   */
+  logWithPrefix(prefix: string, text: string): this;
+  /**
+   * 输出空行
+   *
+   * @returns 当前实例
+   */
+  newline(): this;
+  /**
+   * 输出分隔线
+   *
+   * @param char - 分隔线字符
+   * @param length - 分隔线长度
+   * @returns 当前实例
+   *
+   * @example
+   * ```ts
+   * cli.divider('=', 50);
+   * ```
+   */
+  divider(char?: string, length?: number): this;
+}
+//#endregion
+export { type ChoiceOption, CliTools, type CliToolsEventHandler, type CliToolsEventMap, type CliToolsOptions, type CliToolsPlugin, type LoadConfigOptions, type LogLevel, type Logger, type OptionValue, type PromptInputOptions, type PromptPasswordOptions, type ResolvedConfig };
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/index.js

@@ -0,0 +1,2 @@
+import{Command as e}from"commander";import t from"ora";import n from"cli-cursor";import r from"chalk";import i from"figlet";import a from"@inquirer/input";import o from"@inquirer/confirm";import s from"@inquirer/select";import c from"@inquirer/checkbox";import l from"@inquirer/password";import{existsSync as u,readFileSync as d}from"node:fs";import{resolve as f}from"node:path";const p={debug:0,info:1,warn:2,error:3};var m=class m{constructor(t={}){if(this._spinner=null,this._cursorHidden=!1,this._exitHandlerRegistered=!1,this._plugins=[],this._eventHandlers=new Map,this._config={},this._options={color:t.color??!0,cursor:t.cursor??!0,commandName:t.commandName??`cli-tools`,commandDescription:t.commandDescription??`CLI 工具库`,logger:t.logger??console},this._program=new e,this._program.name(this._options.commandName),this._program.description(this._options.commandDescription),this._options.color||(r.level=0),this._options.cursor||this._hideCursor(),t.plugins)for(let e of t.plugins)this.use(e);this._emit(`init`)}static create(e){return new m(e)}on(e,t){return this._eventHandlers.has(e)||this._eventHandlers.set(e,new Set),this._eventHandlers.get(e).add(t),this}off(e,t){return this._eventHandlers.get(e)?.delete(t),this}_emit(e,t){let n=this._eventHandlers.get(e);if(n)for(let r of n)try{r(t)}catch(t){this._options.logger.error?.(`[Event:${e}] Handler error:`,t)}}async use(e){return this._plugins.some(t=>t.name===e.name)?(this._logDebug(`Plugin "${e.name}" already loaded, skipping`),this):(this._plugins.push(e),this._emit(`plugin:load`,{name:e.name}),await e.install(this),this._logDebug(`Plugin "${e.name}" loaded`),this)}getPlugins(){return this._plugins.map(e=>e.name)}async loadConfig(e={}){let{sources:t=[],defaults:n={},mergeDefaults:r=!0}=e;for(let e of t){let[t,i]=e.split(`#`),a=f(t);if(u(a))try{let t=d(a,`utf-8`),o=JSON.parse(t);i&&typeof o==`object`&&o&&(o=o[i]??{});let s=r?{...n,...o}:o;return this._config=s,this._logDebug(`Config loaded from ${e}`),{source:e,config:s}}catch(t){this._options.logger.error?.(`Failed to load config from ${e}:`,t)}}return this._config={...n},{config:{...n}}}getConfig(){return{...this._config}}getConfigValue(e,t){let n=this._config[e];return n===void 0?t:n}setName(e){return this._program.name(e),this}setVersion(e){return this._program.version(e),this}setDescription(e){return this._program.description(e),this}addOption(e,t,n){return typeof n==`number`?this._program.option(e,t,e=>Number(e),n):this._program.option(e,t,n),this}addArgument(e,t){return this._program.argument(e,t),this}addCommand(e,t,n){return this._program.command(e).description(t).action(n),this}onAction(e){return this._program.action((...t)=>{let n=t[1],r=n.opts();return this._emit(`parse:after`),e(r,n)}),this}parse(e){return this._emit(`parse:before`),this._program.parse(e),this}parseAsync(e){return this._emit(`parse:before`),this._program.parseAsync(e)}getProgram(){return this._program}async promptInput(e,t){this._emit(`prompt:before`,{type:`input`,message:e});try{let n=await a({message:e,default:t?.defaultValue,validate:t?.validate,required:t?.required});return this._emit(`prompt:after`,{type:`input`,result:n}),n}catch(e){return this._emit(`prompt:cancel`,{type:`input`}),this._emit(`error`,{error:e,context:`promptInput`}),null}}async promptConfirm(e,t){this._emit(`prompt:before`,{type:`confirm`,message:e});try{let n=await o({message:e,default:t});return this._emit(`prompt:after`,{type:`confirm`,result:n}),n}catch(e){return this._emit(`prompt:cancel`,{type:`confirm`}),this._emit(`error`,{error:e,context:`promptConfirm`}),null}}async promptSelect(e,t){this._emit(`prompt:before`,{type:`select`,message:e});try{let n=await s({message:e,choices:t.map(e=>typeof e==`string`?{name:e,value:e}:{name:e.name,value:e.value})});return this._emit(`prompt:after`,{type:`select`,result:n}),n}catch(e){return this._emit(`prompt:cancel`,{type:`select`}),this._emit(`error`,{error:e,context:`promptSelect`}),null}}async promptCheckbox(e,t){this._emit(`prompt:before`,{type:`checkbox`,message:e});try{let n=await c({message:e,choices:t.map(e=>typeof e==`string`?{name:e,value:e,checked:!1}:{name:e.name,value:e.value,checked:e.checked??!1})});return this._emit(`prompt:after`,{type:`checkbox`,result:n}),n}catch(e){return this._emit(`prompt:cancel`,{type:`checkbox`}),this._emit(`error`,{error:e,context:`promptCheckbox`}),null}}async promptPassword(e,t){this._emit(`prompt:before`,{type:`password`,message:e});try{let{mask:n,minLength:r,validate:i}=t??{},a=await l({message:e,mask:n,validate:async e=>r&&r>0&&e.length<r?`密码长度不能少于 ${r} 个字符`:!i||i(e)});return this._emit(`prompt:after`,{type:`password`,result:a}),a}catch(e){return this._emit(`prompt:cancel`,{type:`password`}),this._emit(`error`,{error:e,context:`promptPassword`}),null}}spinnerStart(e,n){return this._emit(`spinner:start`,{text:e}),this._spinner=t({text:e,...n}).start(),this}spinnerStop(){return this._spinner?.stop(),this._spinner=null,this._emit(`spinner:stop`),this}spinnerSucceed(e){return this._spinner?.succeed(e),this._spinner=null,this._emit(`spinner:succeed`,{text:e}),this}spinnerFail(e){return this._spinner?.fail(e),this._spinner=null,this._emit(`spinner:fail`,{text:e}),this}spinnerWarn(e){return this._spinner?.warn(e),this._spinner=null,this._emit(`spinner:stop`),this}spinnerInfo(e){return this._spinner?.info(e),this._spinner=null,this._emit(`spinner:stop`),this}spinnerPersist(e,t){return this._spinner?.stopAndPersist({symbol:e,text:t}),this._spinner=null,this._emit(`spinner:stop`),this}spinnerText(e){return this._spinner&&(this._spinner.text=e),this}getSpinner(){return this._spinner}_out(e){this._options.logger.log(e)}_logWithLevel(e,t){let n=this._options.logger.level??`debug`;p[e]<p[n]||(e===`error`?(this._options.logger.error??this._options.logger.log)(t):e===`warn`?(this._options.logger.warn??this._options.logger.log)(t):e===`info`?(this._options.logger.info??this._options.logger.log)(t):(this._options.logger.debug??this._options.logger.log)(t))}_logDebug(e){this._logWithLevel(`debug`,e)}logRed(e){return this._out(r.red(e)),this}logGreen(e){return this._out(r.green(e)),this}logYellow(e){return this._out(r.yellow(e)),this}logBlue(e){return this._out(r.blue(e)),this}logCyan(e){return this._out(r.cyan(e)),this}logMagenta(e){return this._out(r.magenta(e)),this}logWhite(e){return this._out(r.white(e)),this}logGray(e){return this._out(r.gray(e)),this}logBold(e){return this._out(r.bold(e)),this}logUnderline(e){return this._out(r.underline(e)),this}success(e){return this._out(r.green(`✔ ${e}`)),this}error(e){return this._out(r.red(`✖ ${e}`)),this}warn(e){return this._out(r.yellow(`⚠ ${e}`)),this}info(e){return this._out(r.blue(`ℹ ${e}`)),this}printBanner(e,t){let n=i.textSync(e,{font:t});return this._out(r.cyan(n)),this}banner(e,t){return i.textSync(e,{font:t})}bannerAsync(e,t){return i.text(e,{font:t})}getFonts(){return i.fontsSync()}_hideCursor(){n.hide(),this._cursorHidden=!0,this._registerExitHandler()}_showCursor(){this._cursorHidden&&=(n.show(),!1)}_registerExitHandler(){if(this._exitHandlerRegistered)return;this._exitHandlerRegistered=!0;let e=()=>{this._showCursor(),this._spinner?.isSpinning&&this._spinner.stop()};process.on(`exit`,e),process.on(`SIGINT`,()=>{e(),process.exit(130)}),process.on(`SIGTERM`,()=>{e(),process.exit(143)})}cursorShow(){return this._showCursor(),this}cursorHide(){return this._hideCursor(),this}cursorToggle(e){return e===!0?this._showCursor():e===!1?this._hideCursor():this._cursorHidden?this._showCursor():this._hideCursor(),this}print(e){return this._out(e),this}logWithPrefix(e,t){return this._out(`${r.gray(e)} ${t}`),this}newline(){return this._out(``),this}divider(e=`─`,t=40){return this._out(r.gray(e.repeat(t))),this}};export{m as CliTools};
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/cli-tools.ts"],"sourcesContent":["import { Command } from 'commander';\nimport ora, { type Ora, type Options as OraOptions } from 'ora';\nimport cliCursor from 'cli-cursor';\nimport chalk from 'chalk';\nimport figlet from 'figlet';\nimport input from '@inquirer/input';\nimport confirm from '@inquirer/confirm';\nimport select from '@inquirer/select';\nimport checkbox from '@inquirer/checkbox';\nimport password from '@inquirer/password';\nimport { readFileSync, existsSync } from 'node:fs';\nimport { resolve } from 'node:path';\nimport type {\n\tCliToolsOptions,\n\tLogger,\n\tLogLevel,\n\tCliToolsPlugin,\n\tCliToolsEventMap,\n\tCliToolsEventHandler,\n\tChoiceOption,\n\tPromptInputOptions,\n\tPromptPasswordOptions,\n\tLoadConfigOptions,\n\tResolvedConfig,\n\tOptionValue,\n} from './types.js';\n\nconst LOG_LEVEL_PRIORITY: Record<LogLevel, number> = {\n\tdebug: 0,\n\tinfo: 1,\n\twarn: 2,\n\terror: 3,\n};\n\n/**\n * CLI 工具库主类\n *\n * 封装 commander、@inquirer/prompts、ora、chalk、figlet、cli-cursor，\n * 提供链式 API、工厂模式、事件系统与插件机制。\n *\n * @example\n * ```ts\n * const cli = CliTools.create({\n *   commandName: 'my-cli',\n *   commandDescription: '我的CLI工具',\n * });\n *\n * cli\n *   .printBanner('My App')\n *   .addOption('-d, --debug', '调试模式')\n *   .onAction(async (opts, cmd) => {\n *     if (opts.debug) cli.success('调试已开启');\n *   });\n *\n * cli.parse();\n * ```\n *\n * @public\n */\nexport class CliTools {\n\tprivate _program: Command;\n\tprivate _spinner: Ora | null = null;\n\tprivate _options: Required<Omit<CliToolsOptions, 'logger' | 'plugins'>> & { logger: Logger };\n\tprivate _cursorHidden = false;\n\tprivate _exitHandlerRegistered = false;\n\tprivate _plugins: CliToolsPlugin[] = [];\n\tprivate _eventHandlers = new Map<string, Set<CliToolsEventHandler>>();\n\tprivate _config: Record<string, unknown> = {};\n\n\tprivate constructor(options: CliToolsOptions = {}) {\n\t\tthis._options = {\n\t\t\tcolor: options.color ?? true,\n\t\t\tcursor: options.cursor ?? true,\n\t\t\tcommandName: options.commandName ?? 'cli-tools',\n\t\t\tcommandDescription: options.commandDescription ?? 'CLI 工具库',\n\t\t\tlogger: options.logger ?? console,\n\t\t};\n\n\t\tthis._program = new Command();\n\t\tthis._program.name(this._options.commandName);\n\t\tthis._program.description(this._options.commandDescription);\n\n\t\tif (!this._options.color) {\n\t\t\tchalk.level = 0;\n\t\t}\n\t\tif (!this._options.cursor) {\n\t\t\tthis._hideCursor();\n\t\t}\n\n\t\tif (options.plugins) {\n\t\t\tfor (const plugin of options.plugins) {\n\t\t\t\tthis.use(plugin);\n\t\t\t}\n\t\t}\n\n\t\tthis._emit('init');\n\t}\n\n\t// ═══════════════════════════════════════════\n\t//  工厂模式\n\t// ═══════════════════════════════════════════\n\n\t/**\n\t * 工厂方法：创建 CliTools 实例\n\t *\n\t * @param options - 配置选项\n\t * @returns CliTools 实例\n\t *\n\t * @example\n\t * ```ts\n\t * const cli = CliTools.create({\n\t *   commandName: 'my-cli',\n\t *   commandDescription: '我的CLI工具',\n\t *   logger: myLogger,\n\t *   plugins: [myPlugin],\n\t * });\n\t * ```\n\t */\n\tstatic create(options?: CliToolsOptions): CliTools {\n\t\treturn new CliTools(options);\n\t}\n\n\t// ═══════════════════════════════════════════\n\t//  事件系统\n\t// ═══════════════════════════════════════════\n\n\t/**\n\t * 监听事件\n\t *\n\t * @param event - 事件名称\n\t * @param handler - 事件处理器\n\t * @returns 当前实例（支持链式调用）\n\t *\n\t * @example\n\t * ```ts\n\t * cli.on('spinner:stop', () => console.log('Spinner 已停止'));\n\t * cli.on('error', ({ error }) => console.error(error));\n\t * ```\n\t */\n\ton<K extends keyof CliToolsEventMap>(event: K, handler: CliToolsEventHandler<CliToolsEventMap[K]>): this {\n\t\tif (!this._eventHandlers.has(event)) {\n\t\t\tthis._eventHandlers.set(event, new Set());\n\t\t}\n\t\tthis._eventHandlers.get(event)!.add(handler as CliToolsEventHandler);\n\t\treturn this;\n\t}\n\n\t/**\n\t * 取消监听事件\n\t *\n\t * @param event - 事件名称\n\t * @param handler - 要移除的事件处理器\n\t * @returns 当前实例\n\t */\n\toff<K extends keyof CliToolsEventMap>(event: K, handler: CliToolsEventHandler<CliToolsEventMap[K]>): this {\n\t\tthis._eventHandlers.get(event)?.delete(handler as CliToolsEventHandler);\n\t\treturn this;\n\t}\n\n\t/**\n\t * 触发事件（仅内部使用）\n\t *\n\t * @private\n\t */\n\tprivate _emit<K extends keyof CliToolsEventMap>(event: K, data?: CliToolsEventMap[K]): void {\n\t\tconst handlers = this._eventHandlers.get(event);\n\t\tif (!handlers) return;\n\t\tfor (const handler of handlers) {\n\t\t\ttry {\n\t\t\t\thandler(data as never);\n\t\t\t} catch (e) {\n\t\t\t\tthis._options.logger.error?.(`[Event:${event}] Handler error:`, e);\n\t\t\t}\n\t\t}\n\t}\n\n\t// ═══════════════════════════════════════════\n\t//  插件系统\n\t// ═══════════════════════════════════════════\n\n\t/**\n\t * 注册插件\n\t *\n\t * @param plugin - 插件实例\n\t * @returns 当前实例\n\t *\n\t * @example\n\t * ```ts\n\t * const myPlugin: CliToolsPlugin = {\n\t *   name: 'my-plugin',\n\t *   install(cli) {\n\t *     cli.on('init', () => console.log('Plugin loaded'));\n\t *   },\n\t * };\n\t * cli.use(myPlugin);\n\t * ```\n\t */\n\tasync use(plugin: CliToolsPlugin): Promise<this> {\n\t\tif (this._plugins.some(p => p.name === plugin.name)) {\n\t\t\tthis._logDebug(`Plugin \"${plugin.name}\" already loaded, skipping`);\n\t\t\treturn this;\n\t\t}\n\t\tthis._plugins.push(plugin);\n\t\tthis._emit('plugin:load', { name: plugin.name });\n\t\tawait plugin.install(this);\n\t\tthis._logDebug(`Plugin \"${plugin.name}\" loaded`);\n\t\treturn this;\n\t}\n\n\t/**\n\t * 获取已加载的插件列表\n\t *\n\t * @returns 插件名称数组\n\t */\n\tgetPlugins(): string[] {\n\t\treturn this._plugins.map(p => p.name);\n\t}\n\n\t// ═══════════════════════════════════════════\n\t//  配置文件加载\n\t// ═══════════════════════════════════════════\n\n\t/**\n\t * 加载配置文件\n\t *\n\t * 支持 JSON 格式的配置文件。按 sources 顺序查找，优先使用第一个找到的文件。\n\t *\n\t * @param options - 配置加载选项\n\t * @returns 解析后的配置结果，未找到文件则返回 defaults\n\t *\n\t * @example\n\t * ```ts\n\t * const { config } = await cli.loadConfig({\n\t *   sources: ['.myclirc', 'package.json#myCli'],\n\t *   defaults: { theme: 'dark', verbose: false },\n\t * });\n\t * console.log(config.theme); // 'dark'\n\t * ```\n\t */\n\tasync loadConfig(options: LoadConfigOptions = {}): Promise<ResolvedConfig> {\n\t\tconst { sources = [], defaults = {}, mergeDefaults = true } = options;\n\n\t\tfor (const source of sources) {\n\t\t\tconst [filePath, jsonKey] = source.split('#');\n\t\t\tconst fullPath = resolve(filePath);\n\n\t\t\tif (!existsSync(fullPath)) continue;\n\n\t\t\ttry {\n\t\t\t\tconst raw = readFileSync(fullPath, 'utf-8');\n\t\t\t\tlet parsed: Record<string, unknown> = JSON.parse(raw);\n\n\t\t\t\tif (jsonKey && typeof parsed === 'object' && parsed !== null) {\n\t\t\t\t\tparsed = (parsed[jsonKey] as Record<string, unknown>) ?? {};\n\t\t\t\t}\n\n\t\t\t\tconst config = mergeDefaults ? { ...defaults, ...parsed } : parsed;\n\t\t\t\tthis._config = config;\n\t\t\t\tthis._logDebug(`Config loaded from ${source}`);\n\t\t\t\treturn { source, config };\n\t\t\t} catch (e) {\n\t\t\t\tthis._options.logger.error?.(`Failed to load config from ${source}:`, e);\n\t\t\t}\n\t\t}\n\n\t\tthis._config = { ...defaults };\n\t\treturn { config: { ...defaults } };\n\t}\n\n\t/**\n\t * 获取已加载的配置\n\t *\n\t * @returns 当前配置对象\n\t */\n\tgetConfig(): Record<string, unknown> {\n\t\treturn { ...this._config };\n\t}\n\n\t/**\n\t * 获取配置值（支持类型断言）\n\t *\n\t * @param key - 配置键名\n\t * @param defaultValue - 默认值\n\t * @returns 配置值\n\t *\n\t * @example\n\t * ```ts\n\t * const theme = cli.getConfigValue<string>('theme', 'light');\n\t * ```\n\t */\n\tgetConfigValue<T>(key: string, defaultValue?: T): T {\n\t\tconst value = this._config[key];\n\t\treturn (value !== undefined ? value : defaultValue) as T;\n\t}\n\n\t// ═══════════════════════════════════════════\n\t//  Commander 封装（链式）\n\t// ═══════════════════════════════════════════\n\n\t/**\n\t * 设置命令名称\n\t *\n\t * @param name - 命令名称\n\t * @returns 当前实例\n\t */\n\tsetName(name: string): this {\n\t\tthis._program.name(name);\n\t\treturn this;\n\t}\n\n\t/**\n\t * 设置命令版本号\n\t *\n\t * @param version - 版本号字符串\n\t * @returns 当前实例\n\t */\n\tsetVersion(version: string): this {\n\t\tthis._program.version(version);\n\t\treturn this;\n\t}\n\n\t/**\n\t * 设置命令描述\n\t *\n\t * @param description - 描述文本\n\t * @returns 当前实例\n\t */\n\tsetDescription(description: string): this {\n\t\tthis._program.description(description);\n\t\treturn this;\n\t}\n\n\t/**\n\t * 添加命令行选项\n\t *\n\t * @param flags - 选项标志（如 `'-d, --debug'`）\n\t * @param description - 选项描述\n\t * @param defaultValue - 默认值（仅支持 string | boolean | number）\n\t * @returns 当前实例\n\t *\n\t * @example\n\t * ```ts\n\t * cli.addOption('-n, --name <name>', '你的名字', 'World');\n\t * cli.addOption('-d, --debug', '调试模式');\n\t * cli.addOption('-p, --port <port>', '端口号', 3000);\n\t * ```\n\t */\n\taddOption(flags: string, description: string, defaultValue?: OptionValue): this {\n\t\tif (typeof defaultValue === 'number') {\n\t\t\tthis._program.option(flags, description, (val: string) => Number(val), defaultValue);\n\t\t} else {\n\t\t\tthis._program.option(flags, description, defaultValue);\n\t\t}\n\t\treturn this;\n\t}\n\n\t/**\n\t * 添加命令行参数\n\t *\n\t * @param name - 参数名称（如 `'<file>'` 或 `'[file]'`）\n\t * @param description - 参数描述\n\t * @returns 当前实例\n\t */\n\taddArgument(name: string, description: string): this {\n\t\tthis._program.argument(name, description);\n\t\treturn this;\n\t}\n\n\t/**\n\t * 注册子命令\n\t *\n\t * @param name - 子命令名称\n\t * @param description - 子命令描述\n\t * @param action - 子命令执行回调\n\t * @returns 当前实例\n\t *\n\t * @example\n\t * ```ts\n\t * cli.addCommand('init', '初始化项目', async (options, cmd) => {\n\t *   console.log('项目已初始化');\n\t * });\n\t * ```\n\t */\n\taddCommand(name: string, description: string, action: (...args: unknown[]) => void | Promise<void>): this {\n\t\tthis._program.command(name).description(description).action(action as (...a: unknown[]) => void);\n\t\treturn this;\n\t}\n\n\t/**\n\t * 设置主命令的执行回调\n\t *\n\t * @param action - 执行回调，参数为解析后的 options 和 Command 实例\n\t * @returns 当前实例\n\t */\n\tonAction(action: (options: Record<string, unknown>, command: Command) => void | Promise<void>): this {\n\t\tthis._program.action((...args: [string[], Command]) => {\n\t\t\tconst command = args[1];\n\t\t\tconst opts = command.opts();\n\t\t\tthis._emit('parse:after');\n\t\t\treturn action(opts as Record<string, unknown>, command);\n\t\t});\n\t\treturn this;\n\t}\n\n\t/**\n\t * 解析命令行参数\n\t *\n\t * @param argv - 参数数组（默认 process.argv）\n\t * @returns 当前实例\n\t */\n\tparse(argv?: string[]): this {\n\t\tthis._emit('parse:before');\n\t\tthis._program.parse(argv);\n\t\treturn this;\n\t}\n\n\t/**\n\t * 解析命令行参数并返回 Command 实例\n\t *\n\t * @param argv - 参数数组（默认 process.argv）\n\t * @returns Commander Command 实例\n\t */\n\tparseAsync(argv?: string[]): Promise<Command> {\n\t\tthis._emit('parse:before');\n\t\treturn this._program.parseAsync(argv);\n\t}\n\n\t/**\n\t * 获取底层 Commander Command 实例，用于高级定制\n\t *\n\t * @returns Commander Command 实例\n\t */\n\tgetProgram(): Command {\n\t\treturn this._program;\n\t}\n\n\t// ═══════════════════════════════════════════\n\t//  Inquirer Prompts 封装（带错误处理）\n\t// ═══════════════════════════════════════════\n\n\t/**\n\t * 文本输入提示\n\t *\n\t * @param message - 提示消息\n\t * @param options - 额外配置\n\t * @returns 用户输入的文本，用户取消返回 null\n\t *\n\t * @example\n\t * ```ts\n\t * const name = await cli.promptInput('请输入你的名字:', { defaultValue: 'wbw' });\n\t * if (name === null) cli.warn('已取消');\n\t * ```\n\t */\n\tasync promptInput(message: string, options?: PromptInputOptions): Promise<string | null> {\n\t\tthis._emit('prompt:before', { type: 'input', message });\n\t\ttry {\n\t\t\tconst result = await input({\n\t\t\t\tmessage,\n\t\t\t\tdefault: options?.defaultValue,\n\t\t\t\tvalidate: options?.validate,\n\t\t\t\trequired: options?.required,\n\t\t\t});\n\t\t\tthis._emit('prompt:after', { type: 'input', result });\n\t\t\treturn result;\n\t\t} catch (e) {\n\t\t\tthis._emit('prompt:cancel', { type: 'input' });\n\t\t\tthis._emit('error', { error: e as Error, context: 'promptInput' });\n\t\t\treturn null;\n\t\t}\n\t}\n\n\t/**\n\t * 确认提示（是/否）\n\t *\n\t * @param message - 提示消息\n\t * @param defaultValue - 默认值\n\t * @returns 用户选择的结果，用户取消返回 null\n\t *\n\t * @example\n\t * ```ts\n\t * const ok = await cli.promptConfirm('确认继续?');\n\t * if (ok === null) cli.warn('已取消');\n\t * ```\n\t */\n\tasync promptConfirm(message: string, defaultValue?: boolean): Promise<boolean | null> {\n\t\tthis._emit('prompt:before', { type: 'confirm', message });\n\t\ttry {\n\t\t\tconst result = await confirm({ message, default: defaultValue });\n\t\t\tthis._emit('prompt:after', { type: 'confirm', result });\n\t\t\treturn result;\n\t\t} catch (e) {\n\t\t\tthis._emit('prompt:cancel', { type: 'confirm' });\n\t\t\tthis._emit('error', { error: e as Error, context: 'promptConfirm' });\n\t\t\treturn null;\n\t\t}\n\t}\n\n\t/**\n\t * 列表选择提示\n\t *\n\t * @param message - 提示消息\n\t * @param choices - 选项数组\n\t * @returns 用户选择的值，用户取消返回 null\n\t *\n\t * @example\n\t * ```ts\n\t * const lang = await cli.promptSelect('选择语言:', ['TypeScript', 'JavaScript']);\n\t * if (lang === null) return;\n\t * cli.success(`你选择了: ${lang}`);\n\t * ```\n\t */\n\tasync promptSelect(message: string, choices: (string | ChoiceOption)[]): Promise<string | null> {\n\t\tthis._emit('prompt:before', { type: 'select', message });\n\t\ttry {\n\t\t\tconst formattedChoices = choices.map(c =>\n\t\t\t\ttypeof c === 'string' ? { name: c, value: c } : { name: c.name, value: c.value }\n\t\t\t);\n\t\t\tconst result = await select({\n\t\t\t\tmessage,\n\t\t\t\tchoices: formattedChoices as never,\n\t\t\t});\n\t\t\tthis._emit('prompt:after', { type: 'select', result });\n\t\t\treturn result as string;\n\t\t} catch (e) {\n\t\t\tthis._emit('prompt:cancel', { type: 'select' });\n\t\t\tthis._emit('error', { error: e as Error, context: 'promptSelect' });\n\t\t\treturn null;\n\t\t}\n\t}\n\n\t/**\n\t * 多选提示（复选框）\n\t *\n\t * @param message - 提示消息\n\t * @param choices - 选项数组\n\t * @returns 用户选择的值数组，用户取消返回 null\n\t *\n\t * @example\n\t * ```ts\n\t * const features = await cli.promptCheckbox('选择功能:', ['ESLint', 'Prettier']);\n\t * if (features === null) return;\n\t * cli.success(`已选择: ${features.join(', ')}`);\n\t * ```\n\t */\n\tasync promptCheckbox(message: string, choices: (string | ChoiceOption)[]): Promise<string[] | null> {\n\t\tthis._emit('prompt:before', { type: 'checkbox', message });\n\t\ttry {\n\t\t\tconst formattedChoices = choices.map(c =>\n\t\t\t\ttypeof c === 'string'\n\t\t\t\t\t? { name: c, value: c, checked: false }\n\t\t\t\t\t: { name: c.name, value: c.value, checked: c.checked ?? false }\n\t\t\t);\n\t\t\tconst result = await checkbox({\n\t\t\t\tmessage,\n\t\t\t\tchoices: formattedChoices as never,\n\t\t\t});\n\t\t\tthis._emit('prompt:after', { type: 'checkbox', result });\n\t\t\treturn result as string[];\n\t\t} catch (e) {\n\t\t\tthis._emit('prompt:cancel', { type: 'checkbox' });\n\t\t\tthis._emit('error', { error: e as Error, context: 'promptCheckbox' });\n\t\t\treturn null;\n\t\t}\n\t}\n\n\t/**\n\t * 密码输入提示（内容隐藏）\n\t *\n\t * @param message - 提示消息\n\t * @param options - 密码选项（mask、minLength、validate）\n\t * @returns 用户输入的密码文本，用户取消返回 null\n\t *\n\t * @example\n\t * ```ts\n\t * const pwd = await cli.promptPassword('请输入密码:', { minLength: 6 });\n\t * if (pwd === null) return;\n\t * cli.success(`密码长度: ${pwd.length}`);\n\t * ```\n\t */\n\tasync promptPassword(message: string, options?: PromptPasswordOptions): Promise<string | null> {\n\t\tthis._emit('prompt:before', { type: 'password', message });\n\t\ttry {\n\t\t\tconst { mask, minLength, validate } = options ?? {};\n\n\t\t\tconst combinedValidate = async (value: string): Promise<boolean | string> => {\n\t\t\t\tif (minLength && minLength > 0 && value.length < minLength) {\n\t\t\t\t\treturn `密码长度不能少于 ${minLength} 个字符`;\n\t\t\t\t}\n\t\t\t\tif (validate) {\n\t\t\t\t\treturn validate(value);\n\t\t\t\t}\n\t\t\t\treturn true;\n\t\t\t};\n\n\t\t\tconst result = await password({\n\t\t\t\tmessage,\n\t\t\t\tmask,\n\t\t\t\tvalidate: combinedValidate,\n\t\t\t});\n\t\t\tthis._emit('prompt:after', { type: 'password', result });\n\t\t\treturn result;\n\t\t} catch (e) {\n\t\t\tthis._emit('prompt:cancel', { type: 'password' });\n\t\t\tthis._emit('error', { error: e as Error, context: 'promptPassword' });\n\t\t\treturn null;\n\t\t}\n\t}\n\n\t// ═══════════════════════════════════════════\n\t//  Ora Spinner 封装（链式）\n\t// ═══════════════════════════════════════════\n\n\t/**\n\t * 创建并启动 Spinner\n\t *\n\t * @param text - 显示文本\n\t * @param options - ora 配置选项\n\t * @returns 当前实例\n\t *\n\t * @example\n\t * ```ts\n\t * cli.spinnerStart('加载中...').spinnerSucceed('完成!');\n\t * ```\n\t */\n\tspinnerStart(text: string, options?: OraOptions): this {\n\t\tthis._emit('spinner:start', { text });\n\t\tthis._spinner = ora({ text, ...options }).start();\n\t\treturn this;\n\t}\n\n\t/**\n\t * 停止 Spinner\n\t *\n\t * @returns 当前实例\n\t */\n\tspinnerStop(): this {\n\t\tthis._spinner?.stop();\n\t\tthis._spinner = null;\n\t\tthis._emit('spinner:stop');\n\t\treturn this;\n\t}\n\n\t/**\n\t * Spinner 成功状态（✔）\n\t *\n\t * @param text - 成功消息\n\t * @returns 当前实例\n\t */\n\tspinnerSucceed(text?: string): this {\n\t\tthis._spinner?.succeed(text);\n\t\tthis._spinner = null;\n\t\tthis._emit('spinner:succeed', { text });\n\t\treturn this;\n\t}\n\n\t/**\n\t * Spinner 失败状态（✖）\n\t *\n\t * @param text - 失败消息\n\t * @returns 当前实例\n\t */\n\tspinnerFail(text?: string): this {\n\t\tthis._spinner?.fail(text);\n\t\tthis._spinner = null;\n\t\tthis._emit('spinner:fail', { text });\n\t\treturn this;\n\t}\n\n\t/**\n\t * Spinner 警告状态（⚠）\n\t *\n\t * @param text - 警告消息\n\t * @returns 当前实例\n\t */\n\tspinnerWarn(text?: string): this {\n\t\tthis._spinner?.warn(text);\n\t\tthis._spinner = null;\n\t\tthis._emit('spinner:stop');\n\t\treturn this;\n\t}\n\n\t/**\n\t * Spinner 信息状态（ℹ）\n\t *\n\t * @param text - 信息消息\n\t * @returns 当前实例\n\t */\n\tspinnerInfo(text?: string): this {\n\t\tthis._spinner?.info(text);\n\t\tthis._spinner = null;\n\t\tthis._emit('spinner:stop');\n\t\treturn this;\n\t}\n\n\t/**\n\t * 持久化 Spinner（停止并保留文本）\n\t *\n\t * @param symbol - 替代符号\n\t * @param text - 保留的文本\n\t * @returns 当前实例\n\t */\n\tspinnerPersist(symbol?: string, text?: string): this {\n\t\tthis._spinner?.stopAndPersist({ symbol, text });\n\t\tthis._spinner = null;\n\t\tthis._emit('spinner:stop');\n\t\treturn this;\n\t}\n\n\t/**\n\t * 更新 Spinner 文本\n\t *\n\t * @param text - 新文本\n\t * @returns 当前实例\n\t */\n\tspinnerText(text: string): this {\n\t\tif (this._spinner) {\n\t\t\tthis._spinner.text = text;\n\t\t}\n\t\treturn this;\n\t}\n\n\t/**\n\t * 获取当前 Spinner 实例（用于高级操作）\n\t *\n\t * @returns 当前 Spinner 实例，若未创建则返回 null\n\t */\n\tgetSpinner(): Ora | null {\n\t\treturn this._spinner;\n\t}\n\n\t// ═══════════════════════════════════════════\n\t//  Chalk 颜色工具（链式）\n\t// ═══════════════════════════════════════════\n\n\t/** @private */\n\tprivate _out(text: string): void {\n\t\tthis._options.logger.log(text);\n\t}\n\n\t/** @private */\n\tprivate _logWithLevel(level: LogLevel, text: string): void {\n\t\tconst currentLevel = this._options.logger.level ?? 'debug';\n\t\tif (LOG_LEVEL_PRIORITY[level] < LOG_LEVEL_PRIORITY[currentLevel]) return;\n\n\t\tif (level === 'error') {\n\t\t\t(this._options.logger.error ?? this._options.logger.log)(text);\n\t\t} else if (level === 'warn') {\n\t\t\t(this._options.logger.warn ?? this._options.logger.log)(text);\n\t\t} else if (level === 'info') {\n\t\t\t(this._options.logger.info ?? this._options.logger.log)(text);\n\t\t} else {\n\t\t\t(this._options.logger.debug ?? this._options.logger.log)(text);\n\t\t}\n\t}\n\n\t/** @private */\n\tprivate _logDebug(text: string): void {\n\t\tthis._logWithLevel('debug', text);\n\t}\n\n\tlogRed(text: string): this { this._out(chalk.red(text)); return this; }\n\tlogGreen(text: string): this { this._out(chalk.green(text)); return this; }\n\tlogYellow(text: string): this { this._out(chalk.yellow(text)); return this; }\n\tlogBlue(text: string): this { this._out(chalk.blue(text)); return this; }\n\tlogCyan(text: string): this { this._out(chalk.cyan(text)); return this; }\n\tlogMagenta(text: string): this { this._out(chalk.magenta(text)); return this; }\n\tlogWhite(text: string): this { this._out(chalk.white(text)); return this; }\n\tlogGray(text: string): this { this._out(chalk.gray(text)); return this; }\n\tlogBold(text: string): this { this._out(chalk.bold(text)); return this; }\n\tlogUnderline(text: string): this { this._out(chalk.underline(text)); return this; }\n\n\t/**\n\t * 输出成功信息（绿色 + ✔）\n\t *\n\t * @param text - 文本内容\n\t * @returns 当前实例\n\t *\n\t * @example\n\t * ```ts\n\t * cli.success('操作成功!');\n\t * ```\n\t */\n\tsuccess(text: string): this {\n\t\tthis._out(chalk.green(`✔ ${text}`));\n\t\treturn this;\n\t}\n\n\t/**\n\t * 输出错误信息（红色 + ✖）\n\t *\n\t * @param text - 文本内容\n\t * @returns 当前实例\n\t *\n\t * @example\n\t * ```ts\n\t * cli.error('操作失败!');\n\t * ```\n\t */\n\terror(text: string): this {\n\t\tthis._out(chalk.red(`✖ ${text}`));\n\t\treturn this;\n\t}\n\n\t/**\n\t * 输出警告信息（黄色 + ⚠）\n\t *\n\t * @param text - 文本内容\n\t * @returns 当前实例\n\t *\n\t * @example\n\t * ```ts\n\t * cli.warn('请注意!');\n\t * ```\n\t */\n\twarn(text: string): this {\n\t\tthis._out(chalk.yellow(`⚠ ${text}`));\n\t\treturn this;\n\t}\n\n\t/**\n\t * 输出提示信息（蓝色 + ℹ）\n\t *\n\t * @param text - 文本内容\n\t * @returns 当前实例\n\t *\n\t * @example\n\t * ```ts\n\t * cli.info('提示信息');\n\t * ```\n\t */\n\tinfo(text: string): this {\n\t\tthis._out(chalk.blue(`ℹ ${text}`));\n\t\treturn this;\n\t}\n\n\t// ═══════════════════════════════════════════\n\t//  Figlet ASCII Art 封装\n\t// ═══════════════════════════════════════════\n\n\t/**\n\t * 生成并输出 ASCII Art 文本\n\t *\n\t * @param text - 要转换的文本\n\t * @param font - figlet 字体名称（默认 'Standard'）\n\t * @returns 当前实例\n\t *\n\t * @example\n\t * ```ts\n\t * cli.printBanner('Hello');\n\t * cli.printBanner('Big', 'Big');\n\t * ```\n\t */\n\tprintBanner(text: string, font?: string): this {\n\t\tconst art = figlet.textSync(text, { font: font as figlet.Fonts });\n\t\tthis._out(chalk.cyan(art));\n\t\treturn this;\n\t}\n\n\t/**\n\t * 生成 ASCII Art 文本（不输出）\n\t *\n\t * @param text - 要转换的文本\n\t * @param font - figlet 字体名称（默认 'Standard'）\n\t * @returns 生成的 ASCII Art 文本\n\t *\n\t * @example\n\t * ```ts\n\t * const art = cli.banner('Hello');\n\t * fs.writeFileSync('banner.txt', art);\n\t * ```\n\t */\n\tbanner(text: string, font?: string): string {\n\t\treturn figlet.textSync(text, { font: font as figlet.Fonts });\n\t}\n\n\t/**\n\t * 异步生成 ASCII Art 文本\n\t *\n\t * @param text - 要转换的文本\n\t * @param font - figlet 字体名称（默认 'Standard'）\n\t * @returns Promise，解析为 ASCII Art 文本\n\t */\n\tbannerAsync(text: string, font?: string): Promise<string> {\n\t\treturn figlet.text(text, { font: font as figlet.Fonts });\n\t}\n\n\t/**\n\t * 获取所有可用的 figlet 字体列表\n\t *\n\t * @returns 字体名称数组\n\t */\n\tgetFonts(): string[] {\n\t\treturn figlet.fontsSync();\n\t}\n\n\t// ═══════════════════════════════════════════\n\t//  光标控制\n\t// ═══════════════════════════════════════════\n\n\t/** @private */\n\tprivate _hideCursor(): void {\n\t\tcliCursor.hide();\n\t\tthis._cursorHidden = true;\n\t\tthis._registerExitHandler();\n\t}\n\n\t/** @private */\n\tprivate _showCursor(): void {\n\t\tif (this._cursorHidden) {\n\t\t\tcliCursor.show();\n\t\t\tthis._cursorHidden = false;\n\t\t}\n\t}\n\n\t/** @private */\n\tprivate _registerExitHandler(): void {\n\t\tif (this._exitHandlerRegistered) return;\n\t\tthis._exitHandlerRegistered = true;\n\n\t\tconst cleanup = (): void => {\n\t\t\tthis._showCursor();\n\t\t\tif (this._spinner?.isSpinning) {\n\t\t\t\tthis._spinner.stop();\n\t\t\t}\n\t\t};\n\n\t\tprocess.on('exit', cleanup);\n\t\tprocess.on('SIGINT', () => { cleanup(); process.exit(130); });\n\t\tprocess.on('SIGTERM', () => { cleanup(); process.exit(143); });\n\t}\n\n\t/**\n\t * 显示终端光标\n\t *\n\t * @returns 当前实例\n\t */\n\tcursorShow(): this {\n\t\tthis._showCursor();\n\t\treturn this;\n\t}\n\n\t/**\n\t * 隐藏终端光标\n\t *\n\t * @returns 当前实例\n\t */\n\tcursorHide(): this {\n\t\tthis._hideCursor();\n\t\treturn this;\n\t}\n\n\t/**\n\t * 切换光标可见性\n\t *\n\t * @param force - true 显示，false 隐藏，undefined 切换\n\t * @returns 当前实例\n\t */\n\tcursorToggle(force?: boolean): this {\n\t\tif (force === true) {\n\t\t\tthis._showCursor();\n\t\t} else if (force === false) {\n\t\t\tthis._hideCursor();\n\t\t} else {\n\t\t\tif (this._cursorHidden) {\n\t\t\t\tthis._showCursor();\n\t\t\t} else {\n\t\t\t\tthis._hideCursor();\n\t\t\t}\n\t\t}\n\t\treturn this;\n\t}\n\n\t// ═══════════════════════════════════════════\n\t//  通用日志\n\t// ═══════════════════════════════════════════\n\n\t/**\n\t * 输出普通日志\n\t *\n\t * @param text - 文本内容\n\t * @returns 当前实例\n\t *\n\t * @example\n\t * ```ts\n\t * cli.print('Hello World');\n\t * ```\n\t */\n\tprint(text: string): this {\n\t\tthis._out(text);\n\t\treturn this;\n\t}\n\n\t/**\n\t * 输出带前缀的日志\n\t *\n\t * @param prefix - 前缀文本\n\t * @param text - 日志内容\n\t * @returns 当前实例\n\t *\n\t * @example\n\t * ```ts\n\t * cli.logWithPrefix('[INFO]', '任务完成');\n\t * ```\n\t */\n\tlogWithPrefix(prefix: string, text: string): this {\n\t\tthis._out(`${chalk.gray(prefix)} ${text}`);\n\t\treturn this;\n\t}\n\n\t/**\n\t * 输出空行\n\t *\n\t * @returns 当前实例\n\t */\n\tnewline(): this {\n\t\tthis._out('');\n\t\treturn this;\n\t}\n\n\t/**\n\t * 输出分隔线\n\t *\n\t * @param char - 分隔线字符\n\t * @param length - 分隔线长度\n\t * @returns 当前实例\n\t *\n\t * @example\n\t * ```ts\n\t * cli.divider('=', 50);\n\t * ```\n\t */\n\tdivider(char = '─', length = 40): this {\n\t\tthis._out(chalk.gray(char.repeat(length)));\n\t\treturn this;\n\t}\n}\n"],"mappings":"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"}

package/dist/index.js

@@ -0,0 +1,2 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});var e=Object.create,t=Object.defineProperty,n=Object.getOwnPropertyDescriptor,r=Object.getOwnPropertyNames,i=Object.getPrototypeOf,a=Object.prototype.hasOwnProperty,o=(e,i,o,s)=>{if(i&&typeof i==`object`||typeof i==`function`)for(var c=r(i),l=0,u=c.length,d;l<u;l++)d=c[l],!a.call(e,d)&&d!==o&&t(e,d,{get:(e=>i[e]).bind(null,d),enumerable:!(s=n(i,d))||s.enumerable});return e},s=(n,r,a)=>(a=n==null?{}:e(i(n)),o(r||!n||!n.__esModule?t(a,`default`,{value:n,enumerable:!0}):a,n));let c=require("commander"),l=require("ora");l=s(l,1);let u=require("cli-cursor");u=s(u,1);let d=require("chalk");d=s(d,1);let f=require("figlet");f=s(f,1);let p=require("@inquirer/input");p=s(p,1);let m=require("@inquirer/confirm");m=s(m,1);let h=require("@inquirer/select");h=s(h,1);let g=require("@inquirer/checkbox");g=s(g,1);let _=require("@inquirer/password");_=s(_,1);let v=require("node:fs"),y=require("node:path");const b={debug:0,info:1,warn:2,error:3};var x=class e{constructor(e={}){if(this._spinner=null,this._cursorHidden=!1,this._exitHandlerRegistered=!1,this._plugins=[],this._eventHandlers=new Map,this._config={},this._options={color:e.color??!0,cursor:e.cursor??!0,commandName:e.commandName??`cli-tools`,commandDescription:e.commandDescription??`CLI 工具库`,logger:e.logger??console},this._program=new c.Command,this._program.name(this._options.commandName),this._program.description(this._options.commandDescription),this._options.color||(d.default.level=0),this._options.cursor||this._hideCursor(),e.plugins)for(let t of e.plugins)this.use(t);this._emit(`init`)}static create(t){return new e(t)}on(e,t){return this._eventHandlers.has(e)||this._eventHandlers.set(e,new Set),this._eventHandlers.get(e).add(t),this}off(e,t){return this._eventHandlers.get(e)?.delete(t),this}_emit(e,t){let n=this._eventHandlers.get(e);if(n)for(let r of n)try{r(t)}catch(t){this._options.logger.error?.(`[Event:${e}] Handler error:`,t)}}async use(e){return this._plugins.some(t=>t.name===e.name)?(this._logDebug(`Plugin "${e.name}" already loaded, skipping`),this):(this._plugins.push(e),this._emit(`plugin:load`,{name:e.name}),await e.install(this),this._logDebug(`Plugin "${e.name}" loaded`),this)}getPlugins(){return this._plugins.map(e=>e.name)}async loadConfig(e={}){let{sources:t=[],defaults:n={},mergeDefaults:r=!0}=e;for(let e of t){let[t,i]=e.split(`#`),a=(0,y.resolve)(t);if((0,v.existsSync)(a))try{let t=(0,v.readFileSync)(a,`utf-8`),o=JSON.parse(t);i&&typeof o==`object`&&o&&(o=o[i]??{});let s=r?{...n,...o}:o;return this._config=s,this._logDebug(`Config loaded from ${e}`),{source:e,config:s}}catch(t){this._options.logger.error?.(`Failed to load config from ${e}:`,t)}}return this._config={...n},{config:{...n}}}getConfig(){return{...this._config}}getConfigValue(e,t){let n=this._config[e];return n===void 0?t:n}setName(e){return this._program.name(e),this}setVersion(e){return this._program.version(e),this}setDescription(e){return this._program.description(e),this}addOption(e,t,n){return typeof n==`number`?this._program.option(e,t,e=>Number(e),n):this._program.option(e,t,n),this}addArgument(e,t){return this._program.argument(e,t),this}addCommand(e,t,n){return this._program.command(e).description(t).action(n),this}onAction(e){return this._program.action((...t)=>{let n=t[1],r=n.opts();return this._emit(`parse:after`),e(r,n)}),this}parse(e){return this._emit(`parse:before`),this._program.parse(e),this}parseAsync(e){return this._emit(`parse:before`),this._program.parseAsync(e)}getProgram(){return this._program}async promptInput(e,t){this._emit(`prompt:before`,{type:`input`,message:e});try{let n=await(0,p.default)({message:e,default:t?.defaultValue,validate:t?.validate,required:t?.required});return this._emit(`prompt:after`,{type:`input`,result:n}),n}catch(e){return this._emit(`prompt:cancel`,{type:`input`}),this._emit(`error`,{error:e,context:`promptInput`}),null}}async promptConfirm(e,t){this._emit(`prompt:before`,{type:`confirm`,message:e});try{let n=await(0,m.default)({message:e,default:t});return this._emit(`prompt:after`,{type:`confirm`,result:n}),n}catch(e){return this._emit(`prompt:cancel`,{type:`confirm`}),this._emit(`error`,{error:e,context:`promptConfirm`}),null}}async promptSelect(e,t){this._emit(`prompt:before`,{type:`select`,message:e});try{let n=await(0,h.default)({message:e,choices:t.map(e=>typeof e==`string`?{name:e,value:e}:{name:e.name,value:e.value})});return this._emit(`prompt:after`,{type:`select`,result:n}),n}catch(e){return this._emit(`prompt:cancel`,{type:`select`}),this._emit(`error`,{error:e,context:`promptSelect`}),null}}async promptCheckbox(e,t){this._emit(`prompt:before`,{type:`checkbox`,message:e});try{let n=await(0,g.default)({message:e,choices:t.map(e=>typeof e==`string`?{name:e,value:e,checked:!1}:{name:e.name,value:e.value,checked:e.checked??!1})});return this._emit(`prompt:after`,{type:`checkbox`,result:n}),n}catch(e){return this._emit(`prompt:cancel`,{type:`checkbox`}),this._emit(`error`,{error:e,context:`promptCheckbox`}),null}}async promptPassword(e,t){this._emit(`prompt:before`,{type:`password`,message:e});try{let{mask:n,minLength:r,validate:i}=t??{},a=await(0,_.default)({message:e,mask:n,validate:async e=>r&&r>0&&e.length<r?`密码长度不能少于 ${r} 个字符`:!i||i(e)});return this._emit(`prompt:after`,{type:`password`,result:a}),a}catch(e){return this._emit(`prompt:cancel`,{type:`password`}),this._emit(`error`,{error:e,context:`promptPassword`}),null}}spinnerStart(e,t){return this._emit(`spinner:start`,{text:e}),this._spinner=(0,l.default)({text:e,...t}).start(),this}spinnerStop(){return this._spinner?.stop(),this._spinner=null,this._emit(`spinner:stop`),this}spinnerSucceed(e){return this._spinner?.succeed(e),this._spinner=null,this._emit(`spinner:succeed`,{text:e}),this}spinnerFail(e){return this._spinner?.fail(e),this._spinner=null,this._emit(`spinner:fail`,{text:e}),this}spinnerWarn(e){return this._spinner?.warn(e),this._spinner=null,this._emit(`spinner:stop`),this}spinnerInfo(e){return this._spinner?.info(e),this._spinner=null,this._emit(`spinner:stop`),this}spinnerPersist(e,t){return this._spinner?.stopAndPersist({symbol:e,text:t}),this._spinner=null,this._emit(`spinner:stop`),this}spinnerText(e){return this._spinner&&(this._spinner.text=e),this}getSpinner(){return this._spinner}_out(e){this._options.logger.log(e)}_logWithLevel(e,t){let n=this._options.logger.level??`debug`;b[e]<b[n]||(e===`error`?(this._options.logger.error??this._options.logger.log)(t):e===`warn`?(this._options.logger.warn??this._options.logger.log)(t):e===`info`?(this._options.logger.info??this._options.logger.log)(t):(this._options.logger.debug??this._options.logger.log)(t))}_logDebug(e){this._logWithLevel(`debug`,e)}logRed(e){return this._out(d.default.red(e)),this}logGreen(e){return this._out(d.default.green(e)),this}logYellow(e){return this._out(d.default.yellow(e)),this}logBlue(e){return this._out(d.default.blue(e)),this}logCyan(e){return this._out(d.default.cyan(e)),this}logMagenta(e){return this._out(d.default.magenta(e)),this}logWhite(e){return this._out(d.default.white(e)),this}logGray(e){return this._out(d.default.gray(e)),this}logBold(e){return this._out(d.default.bold(e)),this}logUnderline(e){return this._out(d.default.underline(e)),this}success(e){return this._out(d.default.green(`✔ ${e}`)),this}error(e){return this._out(d.default.red(`✖ ${e}`)),this}warn(e){return this._out(d.default.yellow(`⚠ ${e}`)),this}info(e){return this._out(d.default.blue(`ℹ ${e}`)),this}printBanner(e,t){let n=f.default.textSync(e,{font:t});return this._out(d.default.cyan(n)),this}banner(e,t){return f.default.textSync(e,{font:t})}bannerAsync(e,t){return f.default.text(e,{font:t})}getFonts(){return f.default.fontsSync()}_hideCursor(){u.default.hide(),this._cursorHidden=!0,this._registerExitHandler()}_showCursor(){this._cursorHidden&&=(u.default.show(),!1)}_registerExitHandler(){if(this._exitHandlerRegistered)return;this._exitHandlerRegistered=!0;let e=()=>{this._showCursor(),this._spinner?.isSpinning&&this._spinner.stop()};process.on(`exit`,e),process.on(`SIGINT`,()=>{e(),process.exit(130)}),process.on(`SIGTERM`,()=>{e(),process.exit(143)})}cursorShow(){return this._showCursor(),this}cursorHide(){return this._hideCursor(),this}cursorToggle(e){return e===!0?this._showCursor():e===!1?this._hideCursor():this._cursorHidden?this._showCursor():this._hideCursor(),this}print(e){return this._out(e),this}logWithPrefix(e,t){return this._out(`${d.default.gray(e)} ${t}`),this}newline(){return this._out(``),this}divider(e=`─`,t=40){return this._out(d.default.gray(e.repeat(t))),this}};exports.CliTools=x;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["Command"],"sources":["../src/cli-tools.ts"],"sourcesContent":["import { Command } from 'commander';\nimport ora, { type Ora, type Options as OraOptions } from 'ora';\nimport cliCursor from 'cli-cursor';\nimport chalk from 'chalk';\nimport figlet from 'figlet';\nimport input from '@inquirer/input';\nimport confirm from '@inquirer/confirm';\nimport select from '@inquirer/select';\nimport checkbox from '@inquirer/checkbox';\nimport password from '@inquirer/password';\nimport { readFileSync, existsSync } from 'node:fs';\nimport { resolve } from 'node:path';\nimport type {\n\tCliToolsOptions,\n\tLogger,\n\tLogLevel,\n\tCliToolsPlugin,\n\tCliToolsEventMap,\n\tCliToolsEventHandler,\n\tChoiceOption,\n\tPromptInputOptions,\n\tPromptPasswordOptions,\n\tLoadConfigOptions,\n\tResolvedConfig,\n\tOptionValue,\n} from './types.js';\n\nconst LOG_LEVEL_PRIORITY: Record<LogLevel, number> = {\n\tdebug: 0,\n\tinfo: 1,\n\twarn: 2,\n\terror: 3,\n};\n\n/**\n * CLI 工具库主类\n *\n * 封装 commander、@inquirer/prompts、ora、chalk、figlet、cli-cursor，\n * 提供链式 API、工厂模式、事件系统与插件机制。\n *\n * @example\n * ```ts\n * const cli = CliTools.create({\n *   commandName: 'my-cli',\n *   commandDescription: '我的CLI工具',\n * });\n *\n * cli\n *   .printBanner('My App')\n *   .addOption('-d, --debug', '调试模式')\n *   .onAction(async (opts, cmd) => {\n *     if (opts.debug) cli.success('调试已开启');\n *   });\n *\n * cli.parse();\n * ```\n *\n * @public\n */\nexport class CliTools {\n\tprivate _program: Command;\n\tprivate _spinner: Ora | null = null;\n\tprivate _options: Required<Omit<CliToolsOptions, 'logger' | 'plugins'>> & { logger: Logger };\n\tprivate _cursorHidden = false;\n\tprivate _exitHandlerRegistered = false;\n\tprivate _plugins: CliToolsPlugin[] = [];\n\tprivate _eventHandlers = new Map<string, Set<CliToolsEventHandler>>();\n\tprivate _config: Record<string, unknown> = {};\n\n\tprivate constructor(options: CliToolsOptions = {}) {\n\t\tthis._options = {\n\t\t\tcolor: options.color ?? true,\n\t\t\tcursor: options.cursor ?? true,\n\t\t\tcommandName: options.commandName ?? 'cli-tools',\n\t\t\tcommandDescription: options.commandDescription ?? 'CLI 工具库',\n\t\t\tlogger: options.logger ?? console,\n\t\t};\n\n\t\tthis._program = new Command();\n\t\tthis._program.name(this._options.commandName);\n\t\tthis._program.description(this._options.commandDescription);\n\n\t\tif (!this._options.color) {\n\t\t\tchalk.level = 0;\n\t\t}\n\t\tif (!this._options.cursor) {\n\t\t\tthis._hideCursor();\n\t\t}\n\n\t\tif (options.plugins) {\n\t\t\tfor (const plugin of options.plugins) {\n\t\t\t\tthis.use(plugin);\n\t\t\t}\n\t\t}\n\n\t\tthis._emit('init');\n\t}\n\n\t// ═══════════════════════════════════════════\n\t//  工厂模式\n\t// ═══════════════════════════════════════════\n\n\t/**\n\t * 工厂方法：创建 CliTools 实例\n\t *\n\t * @param options - 配置选项\n\t * @returns CliTools 实例\n\t *\n\t * @example\n\t * ```ts\n\t * const cli = CliTools.create({\n\t *   commandName: 'my-cli',\n\t *   commandDescription: '我的CLI工具',\n\t *   logger: myLogger,\n\t *   plugins: [myPlugin],\n\t * });\n\t * ```\n\t */\n\tstatic create(options?: CliToolsOptions): CliTools {\n\t\treturn new CliTools(options);\n\t}\n\n\t// ═══════════════════════════════════════════\n\t//  事件系统\n\t// ═══════════════════════════════════════════\n\n\t/**\n\t * 监听事件\n\t *\n\t * @param event - 事件名称\n\t * @param handler - 事件处理器\n\t * @returns 当前实例（支持链式调用）\n\t *\n\t * @example\n\t * ```ts\n\t * cli.on('spinner:stop', () => console.log('Spinner 已停止'));\n\t * cli.on('error', ({ error }) => console.error(error));\n\t * ```\n\t */\n\ton<K extends keyof CliToolsEventMap>(event: K, handler: CliToolsEventHandler<CliToolsEventMap[K]>): this {\n\t\tif (!this._eventHandlers.has(event)) {\n\t\t\tthis._eventHandlers.set(event, new Set());\n\t\t}\n\t\tthis._eventHandlers.get(event)!.add(handler as CliToolsEventHandler);\n\t\treturn this;\n\t}\n\n\t/**\n\t * 取消监听事件\n\t *\n\t * @param event - 事件名称\n\t * @param handler - 要移除的事件处理器\n\t * @returns 当前实例\n\t */\n\toff<K extends keyof CliToolsEventMap>(event: K, handler: CliToolsEventHandler<CliToolsEventMap[K]>): this {\n\t\tthis._eventHandlers.get(event)?.delete(handler as CliToolsEventHandler);\n\t\treturn this;\n\t}\n\n\t/**\n\t * 触发事件（仅内部使用）\n\t *\n\t * @private\n\t */\n\tprivate _emit<K extends keyof CliToolsEventMap>(event: K, data?: CliToolsEventMap[K]): void {\n\t\tconst handlers = this._eventHandlers.get(event);\n\t\tif (!handlers) return;\n\t\tfor (const handler of handlers) {\n\t\t\ttry {\n\t\t\t\thandler(data as never);\n\t\t\t} catch (e) {\n\t\t\t\tthis._options.logger.error?.(`[Event:${event}] Handler error:`, e);\n\t\t\t}\n\t\t}\n\t}\n\n\t// ═══════════════════════════════════════════\n\t//  插件系统\n\t// ═══════════════════════════════════════════\n\n\t/**\n\t * 注册插件\n\t *\n\t * @param plugin - 插件实例\n\t * @returns 当前实例\n\t *\n\t * @example\n\t * ```ts\n\t * const myPlugin: CliToolsPlugin = {\n\t *   name: 'my-plugin',\n\t *   install(cli) {\n\t *     cli.on('init', () => console.log('Plugin loaded'));\n\t *   },\n\t * };\n\t * cli.use(myPlugin);\n\t * ```\n\t */\n\tasync use(plugin: CliToolsPlugin): Promise<this> {\n\t\tif (this._plugins.some(p => p.name === plugin.name)) {\n\t\t\tthis._logDebug(`Plugin \"${plugin.name}\" already loaded, skipping`);\n\t\t\treturn this;\n\t\t}\n\t\tthis._plugins.push(plugin);\n\t\tthis._emit('plugin:load', { name: plugin.name });\n\t\tawait plugin.install(this);\n\t\tthis._logDebug(`Plugin \"${plugin.name}\" loaded`);\n\t\treturn this;\n\t}\n\n\t/**\n\t * 获取已加载的插件列表\n\t *\n\t * @returns 插件名称数组\n\t */\n\tgetPlugins(): string[] {\n\t\treturn this._plugins.map(p => p.name);\n\t}\n\n\t// ═══════════════════════════════════════════\n\t//  配置文件加载\n\t// ═══════════════════════════════════════════\n\n\t/**\n\t * 加载配置文件\n\t *\n\t * 支持 JSON 格式的配置文件。按 sources 顺序查找，优先使用第一个找到的文件。\n\t *\n\t * @param options - 配置加载选项\n\t * @returns 解析后的配置结果，未找到文件则返回 defaults\n\t *\n\t * @example\n\t * ```ts\n\t * const { config } = await cli.loadConfig({\n\t *   sources: ['.myclirc', 'package.json#myCli'],\n\t *   defaults: { theme: 'dark', verbose: false },\n\t * });\n\t * console.log(config.theme); // 'dark'\n\t * ```\n\t */\n\tasync loadConfig(options: LoadConfigOptions = {}): Promise<ResolvedConfig> {\n\t\tconst { sources = [], defaults = {}, mergeDefaults = true } = options;\n\n\t\tfor (const source of sources) {\n\t\t\tconst [filePath, jsonKey] = source.split('#');\n\t\t\tconst fullPath = resolve(filePath);\n\n\t\t\tif (!existsSync(fullPath)) continue;\n\n\t\t\ttry {\n\t\t\t\tconst raw = readFileSync(fullPath, 'utf-8');\n\t\t\t\tlet parsed: Record<string, unknown> = JSON.parse(raw);\n\n\t\t\t\tif (jsonKey && typeof parsed === 'object' && parsed !== null) {\n\t\t\t\t\tparsed = (parsed[jsonKey] as Record<string, unknown>) ?? {};\n\t\t\t\t}\n\n\t\t\t\tconst config = mergeDefaults ? { ...defaults, ...parsed } : parsed;\n\t\t\t\tthis._config = config;\n\t\t\t\tthis._logDebug(`Config loaded from ${source}`);\n\t\t\t\treturn { source, config };\n\t\t\t} catch (e) {\n\t\t\t\tthis._options.logger.error?.(`Failed to load config from ${source}:`, e);\n\t\t\t}\n\t\t}\n\n\t\tthis._config = { ...defaults };\n\t\treturn { config: { ...defaults } };\n\t}\n\n\t/**\n\t * 获取已加载的配置\n\t *\n\t * @returns 当前配置对象\n\t */\n\tgetConfig(): Record<string, unknown> {\n\t\treturn { ...this._config };\n\t}\n\n\t/**\n\t * 获取配置值（支持类型断言）\n\t *\n\t * @param key - 配置键名\n\t * @param defaultValue - 默认值\n\t * @returns 配置值\n\t *\n\t * @example\n\t * ```ts\n\t * const theme = cli.getConfigValue<string>('theme', 'light');\n\t * ```\n\t */\n\tgetConfigValue<T>(key: string, defaultValue?: T): T {\n\t\tconst value = this._config[key];\n\t\treturn (value !== undefined ? value : defaultValue) as T;\n\t}\n\n\t// ═══════════════════════════════════════════\n\t//  Commander 封装（链式）\n\t// ═══════════════════════════════════════════\n\n\t/**\n\t * 设置命令名称\n\t *\n\t * @param name - 命令名称\n\t * @returns 当前实例\n\t */\n\tsetName(name: string): this {\n\t\tthis._program.name(name);\n\t\treturn this;\n\t}\n\n\t/**\n\t * 设置命令版本号\n\t *\n\t * @param version - 版本号字符串\n\t * @returns 当前实例\n\t */\n\tsetVersion(version: string): this {\n\t\tthis._program.version(version);\n\t\treturn this;\n\t}\n\n\t/**\n\t * 设置命令描述\n\t *\n\t * @param description - 描述文本\n\t * @returns 当前实例\n\t */\n\tsetDescription(description: string): this {\n\t\tthis._program.description(description);\n\t\treturn this;\n\t}\n\n\t/**\n\t * 添加命令行选项\n\t *\n\t * @param flags - 选项标志（如 `'-d, --debug'`）\n\t * @param description - 选项描述\n\t * @param defaultValue - 默认值（仅支持 string | boolean | number）\n\t * @returns 当前实例\n\t *\n\t * @example\n\t * ```ts\n\t * cli.addOption('-n, --name <name>', '你的名字', 'World');\n\t * cli.addOption('-d, --debug', '调试模式');\n\t * cli.addOption('-p, --port <port>', '端口号', 3000);\n\t * ```\n\t */\n\taddOption(flags: string, description: string, defaultValue?: OptionValue): this {\n\t\tif (typeof defaultValue === 'number') {\n\t\t\tthis._program.option(flags, description, (val: string) => Number(val), defaultValue);\n\t\t} else {\n\t\t\tthis._program.option(flags, description, defaultValue);\n\t\t}\n\t\treturn this;\n\t}\n\n\t/**\n\t * 添加命令行参数\n\t *\n\t * @param name - 参数名称（如 `'<file>'` 或 `'[file]'`）\n\t * @param description - 参数描述\n\t * @returns 当前实例\n\t */\n\taddArgument(name: string, description: string): this {\n\t\tthis._program.argument(name, description);\n\t\treturn this;\n\t}\n\n\t/**\n\t * 注册子命令\n\t *\n\t * @param name - 子命令名称\n\t * @param description - 子命令描述\n\t * @param action - 子命令执行回调\n\t * @returns 当前实例\n\t *\n\t * @example\n\t * ```ts\n\t * cli.addCommand('init', '初始化项目', async (options, cmd) => {\n\t *   console.log('项目已初始化');\n\t * });\n\t * ```\n\t */\n\taddCommand(name: string, description: string, action: (...args: unknown[]) => void | Promise<void>): this {\n\t\tthis._program.command(name).description(description).action(action as (...a: unknown[]) => void);\n\t\treturn this;\n\t}\n\n\t/**\n\t * 设置主命令的执行回调\n\t *\n\t * @param action - 执行回调，参数为解析后的 options 和 Command 实例\n\t * @returns 当前实例\n\t */\n\tonAction(action: (options: Record<string, unknown>, command: Command) => void | Promise<void>): this {\n\t\tthis._program.action((...args: [string[], Command]) => {\n\t\t\tconst command = args[1];\n\t\t\tconst opts = command.opts();\n\t\t\tthis._emit('parse:after');\n\t\t\treturn action(opts as Record<string, unknown>, command);\n\t\t});\n\t\treturn this;\n\t}\n\n\t/**\n\t * 解析命令行参数\n\t *\n\t * @param argv - 参数数组（默认 process.argv）\n\t * @returns 当前实例\n\t */\n\tparse(argv?: string[]): this {\n\t\tthis._emit('parse:before');\n\t\tthis._program.parse(argv);\n\t\treturn this;\n\t}\n\n\t/**\n\t * 解析命令行参数并返回 Command 实例\n\t *\n\t * @param argv - 参数数组（默认 process.argv）\n\t * @returns Commander Command 实例\n\t */\n\tparseAsync(argv?: string[]): Promise<Command> {\n\t\tthis._emit('parse:before');\n\t\treturn this._program.parseAsync(argv);\n\t}\n\n\t/**\n\t * 获取底层 Commander Command 实例，用于高级定制\n\t *\n\t * @returns Commander Command 实例\n\t */\n\tgetProgram(): Command {\n\t\treturn this._program;\n\t}\n\n\t// ═══════════════════════════════════════════\n\t//  Inquirer Prompts 封装（带错误处理）\n\t// ═══════════════════════════════════════════\n\n\t/**\n\t * 文本输入提示\n\t *\n\t * @param message - 提示消息\n\t * @param options - 额外配置\n\t * @returns 用户输入的文本，用户取消返回 null\n\t *\n\t * @example\n\t * ```ts\n\t * const name = await cli.promptInput('请输入你的名字:', { defaultValue: 'wbw' });\n\t * if (name === null) cli.warn('已取消');\n\t * ```\n\t */\n\tasync promptInput(message: string, options?: PromptInputOptions): Promise<string | null> {\n\t\tthis._emit('prompt:before', { type: 'input', message });\n\t\ttry {\n\t\t\tconst result = await input({\n\t\t\t\tmessage,\n\t\t\t\tdefault: options?.defaultValue,\n\t\t\t\tvalidate: options?.validate,\n\t\t\t\trequired: options?.required,\n\t\t\t});\n\t\t\tthis._emit('prompt:after', { type: 'input', result });\n\t\t\treturn result;\n\t\t} catch (e) {\n\t\t\tthis._emit('prompt:cancel', { type: 'input' });\n\t\t\tthis._emit('error', { error: e as Error, context: 'promptInput' });\n\t\t\treturn null;\n\t\t}\n\t}\n\n\t/**\n\t * 确认提示（是/否）\n\t *\n\t * @param message - 提示消息\n\t * @param defaultValue - 默认值\n\t * @returns 用户选择的结果，用户取消返回 null\n\t *\n\t * @example\n\t * ```ts\n\t * const ok = await cli.promptConfirm('确认继续?');\n\t * if (ok === null) cli.warn('已取消');\n\t * ```\n\t */\n\tasync promptConfirm(message: string, defaultValue?: boolean): Promise<boolean | null> {\n\t\tthis._emit('prompt:before', { type: 'confirm', message });\n\t\ttry {\n\t\t\tconst result = await confirm({ message, default: defaultValue });\n\t\t\tthis._emit('prompt:after', { type: 'confirm', result });\n\t\t\treturn result;\n\t\t} catch (e) {\n\t\t\tthis._emit('prompt:cancel', { type: 'confirm' });\n\t\t\tthis._emit('error', { error: e as Error, context: 'promptConfirm' });\n\t\t\treturn null;\n\t\t}\n\t}\n\n\t/**\n\t * 列表选择提示\n\t *\n\t * @param message - 提示消息\n\t * @param choices - 选项数组\n\t * @returns 用户选择的值，用户取消返回 null\n\t *\n\t * @example\n\t * ```ts\n\t * const lang = await cli.promptSelect('选择语言:', ['TypeScript', 'JavaScript']);\n\t * if (lang === null) return;\n\t * cli.success(`你选择了: ${lang}`);\n\t * ```\n\t */\n\tasync promptSelect(message: string, choices: (string | ChoiceOption)[]): Promise<string | null> {\n\t\tthis._emit('prompt:before', { type: 'select', message });\n\t\ttry {\n\t\t\tconst formattedChoices = choices.map(c =>\n\t\t\t\ttypeof c === 'string' ? { name: c, value: c } : { name: c.name, value: c.value }\n\t\t\t);\n\t\t\tconst result = await select({\n\t\t\t\tmessage,\n\t\t\t\tchoices: formattedChoices as never,\n\t\t\t});\n\t\t\tthis._emit('prompt:after', { type: 'select', result });\n\t\t\treturn result as string;\n\t\t} catch (e) {\n\t\t\tthis._emit('prompt:cancel', { type: 'select' });\n\t\t\tthis._emit('error', { error: e as Error, context: 'promptSelect' });\n\t\t\treturn null;\n\t\t}\n\t}\n\n\t/**\n\t * 多选提示（复选框）\n\t *\n\t * @param message - 提示消息\n\t * @param choices - 选项数组\n\t * @returns 用户选择的值数组，用户取消返回 null\n\t *\n\t * @example\n\t * ```ts\n\t * const features = await cli.promptCheckbox('选择功能:', ['ESLint', 'Prettier']);\n\t * if (features === null) return;\n\t * cli.success(`已选择: ${features.join(', ')}`);\n\t * ```\n\t */\n\tasync promptCheckbox(message: string, choices: (string | ChoiceOption)[]): Promise<string[] | null> {\n\t\tthis._emit('prompt:before', { type: 'checkbox', message });\n\t\ttry {\n\t\t\tconst formattedChoices = choices.map(c =>\n\t\t\t\ttypeof c === 'string'\n\t\t\t\t\t? { name: c, value: c, checked: false }\n\t\t\t\t\t: { name: c.name, value: c.value, checked: c.checked ?? false }\n\t\t\t);\n\t\t\tconst result = await checkbox({\n\t\t\t\tmessage,\n\t\t\t\tchoices: formattedChoices as never,\n\t\t\t});\n\t\t\tthis._emit('prompt:after', { type: 'checkbox', result });\n\t\t\treturn result as string[];\n\t\t} catch (e) {\n\t\t\tthis._emit('prompt:cancel', { type: 'checkbox' });\n\t\t\tthis._emit('error', { error: e as Error, context: 'promptCheckbox' });\n\t\t\treturn null;\n\t\t}\n\t}\n\n\t/**\n\t * 密码输入提示（内容隐藏）\n\t *\n\t * @param message - 提示消息\n\t * @param options - 密码选项（mask、minLength、validate）\n\t * @returns 用户输入的密码文本，用户取消返回 null\n\t *\n\t * @example\n\t * ```ts\n\t * const pwd = await cli.promptPassword('请输入密码:', { minLength: 6 });\n\t * if (pwd === null) return;\n\t * cli.success(`密码长度: ${pwd.length}`);\n\t * ```\n\t */\n\tasync promptPassword(message: string, options?: PromptPasswordOptions): Promise<string | null> {\n\t\tthis._emit('prompt:before', { type: 'password', message });\n\t\ttry {\n\t\t\tconst { mask, minLength, validate } = options ?? {};\n\n\t\t\tconst combinedValidate = async (value: string): Promise<boolean | string> => {\n\t\t\t\tif (minLength && minLength > 0 && value.length < minLength) {\n\t\t\t\t\treturn `密码长度不能少于 ${minLength} 个字符`;\n\t\t\t\t}\n\t\t\t\tif (validate) {\n\t\t\t\t\treturn validate(value);\n\t\t\t\t}\n\t\t\t\treturn true;\n\t\t\t};\n\n\t\t\tconst result = await password({\n\t\t\t\tmessage,\n\t\t\t\tmask,\n\t\t\t\tvalidate: combinedValidate,\n\t\t\t});\n\t\t\tthis._emit('prompt:after', { type: 'password', result });\n\t\t\treturn result;\n\t\t} catch (e) {\n\t\t\tthis._emit('prompt:cancel', { type: 'password' });\n\t\t\tthis._emit('error', { error: e as Error, context: 'promptPassword' });\n\t\t\treturn null;\n\t\t}\n\t}\n\n\t// ═══════════════════════════════════════════\n\t//  Ora Spinner 封装（链式）\n\t// ═══════════════════════════════════════════\n\n\t/**\n\t * 创建并启动 Spinner\n\t *\n\t * @param text - 显示文本\n\t * @param options - ora 配置选项\n\t * @returns 当前实例\n\t *\n\t * @example\n\t * ```ts\n\t * cli.spinnerStart('加载中...').spinnerSucceed('完成!');\n\t * ```\n\t */\n\tspinnerStart(text: string, options?: OraOptions): this {\n\t\tthis._emit('spinner:start', { text });\n\t\tthis._spinner = ora({ text, ...options }).start();\n\t\treturn this;\n\t}\n\n\t/**\n\t * 停止 Spinner\n\t *\n\t * @returns 当前实例\n\t */\n\tspinnerStop(): this {\n\t\tthis._spinner?.stop();\n\t\tthis._spinner = null;\n\t\tthis._emit('spinner:stop');\n\t\treturn this;\n\t}\n\n\t/**\n\t * Spinner 成功状态（✔）\n\t *\n\t * @param text - 成功消息\n\t * @returns 当前实例\n\t */\n\tspinnerSucceed(text?: string): this {\n\t\tthis._spinner?.succeed(text);\n\t\tthis._spinner = null;\n\t\tthis._emit('spinner:succeed', { text });\n\t\treturn this;\n\t}\n\n\t/**\n\t * Spinner 失败状态（✖）\n\t *\n\t * @param text - 失败消息\n\t * @returns 当前实例\n\t */\n\tspinnerFail(text?: string): this {\n\t\tthis._spinner?.fail(text);\n\t\tthis._spinner = null;\n\t\tthis._emit('spinner:fail', { text });\n\t\treturn this;\n\t}\n\n\t/**\n\t * Spinner 警告状态（⚠）\n\t *\n\t * @param text - 警告消息\n\t * @returns 当前实例\n\t */\n\tspinnerWarn(text?: string): this {\n\t\tthis._spinner?.warn(text);\n\t\tthis._spinner = null;\n\t\tthis._emit('spinner:stop');\n\t\treturn this;\n\t}\n\n\t/**\n\t * Spinner 信息状态（ℹ）\n\t *\n\t * @param text - 信息消息\n\t * @returns 当前实例\n\t */\n\tspinnerInfo(text?: string): this {\n\t\tthis._spinner?.info(text);\n\t\tthis._spinner = null;\n\t\tthis._emit('spinner:stop');\n\t\treturn this;\n\t}\n\n\t/**\n\t * 持久化 Spinner（停止并保留文本）\n\t *\n\t * @param symbol - 替代符号\n\t * @param text - 保留的文本\n\t * @returns 当前实例\n\t */\n\tspinnerPersist(symbol?: string, text?: string): this {\n\t\tthis._spinner?.stopAndPersist({ symbol, text });\n\t\tthis._spinner = null;\n\t\tthis._emit('spinner:stop');\n\t\treturn this;\n\t}\n\n\t/**\n\t * 更新 Spinner 文本\n\t *\n\t * @param text - 新文本\n\t * @returns 当前实例\n\t */\n\tspinnerText(text: string): this {\n\t\tif (this._spinner) {\n\t\t\tthis._spinner.text = text;\n\t\t}\n\t\treturn this;\n\t}\n\n\t/**\n\t * 获取当前 Spinner 实例（用于高级操作）\n\t *\n\t * @returns 当前 Spinner 实例，若未创建则返回 null\n\t */\n\tgetSpinner(): Ora | null {\n\t\treturn this._spinner;\n\t}\n\n\t// ═══════════════════════════════════════════\n\t//  Chalk 颜色工具（链式）\n\t// ═══════════════════════════════════════════\n\n\t/** @private */\n\tprivate _out(text: string): void {\n\t\tthis._options.logger.log(text);\n\t}\n\n\t/** @private */\n\tprivate _logWithLevel(level: LogLevel, text: string): void {\n\t\tconst currentLevel = this._options.logger.level ?? 'debug';\n\t\tif (LOG_LEVEL_PRIORITY[level] < LOG_LEVEL_PRIORITY[currentLevel]) return;\n\n\t\tif (level === 'error') {\n\t\t\t(this._options.logger.error ?? this._options.logger.log)(text);\n\t\t} else if (level === 'warn') {\n\t\t\t(this._options.logger.warn ?? this._options.logger.log)(text);\n\t\t} else if (level === 'info') {\n\t\t\t(this._options.logger.info ?? this._options.logger.log)(text);\n\t\t} else {\n\t\t\t(this._options.logger.debug ?? this._options.logger.log)(text);\n\t\t}\n\t}\n\n\t/** @private */\n\tprivate _logDebug(text: string): void {\n\t\tthis._logWithLevel('debug', text);\n\t}\n\n\tlogRed(text: string): this { this._out(chalk.red(text)); return this; }\n\tlogGreen(text: string): this { this._out(chalk.green(text)); return this; }\n\tlogYellow(text: string): this { this._out(chalk.yellow(text)); return this; }\n\tlogBlue(text: string): this { this._out(chalk.blue(text)); return this; }\n\tlogCyan(text: string): this { this._out(chalk.cyan(text)); return this; }\n\tlogMagenta(text: string): this { this._out(chalk.magenta(text)); return this; }\n\tlogWhite(text: string): this { this._out(chalk.white(text)); return this; }\n\tlogGray(text: string): this { this._out(chalk.gray(text)); return this; }\n\tlogBold(text: string): this { this._out(chalk.bold(text)); return this; }\n\tlogUnderline(text: string): this { this._out(chalk.underline(text)); return this; }\n\n\t/**\n\t * 输出成功信息（绿色 + ✔）\n\t *\n\t * @param text - 文本内容\n\t * @returns 当前实例\n\t *\n\t * @example\n\t * ```ts\n\t * cli.success('操作成功!');\n\t * ```\n\t */\n\tsuccess(text: string): this {\n\t\tthis._out(chalk.green(`✔ ${text}`));\n\t\treturn this;\n\t}\n\n\t/**\n\t * 输出错误信息（红色 + ✖）\n\t *\n\t * @param text - 文本内容\n\t * @returns 当前实例\n\t *\n\t * @example\n\t * ```ts\n\t * cli.error('操作失败!');\n\t * ```\n\t */\n\terror(text: string): this {\n\t\tthis._out(chalk.red(`✖ ${text}`));\n\t\treturn this;\n\t}\n\n\t/**\n\t * 输出警告信息（黄色 + ⚠）\n\t *\n\t * @param text - 文本内容\n\t * @returns 当前实例\n\t *\n\t * @example\n\t * ```ts\n\t * cli.warn('请注意!');\n\t * ```\n\t */\n\twarn(text: string): this {\n\t\tthis._out(chalk.yellow(`⚠ ${text}`));\n\t\treturn this;\n\t}\n\n\t/**\n\t * 输出提示信息（蓝色 + ℹ）\n\t *\n\t * @param text - 文本内容\n\t * @returns 当前实例\n\t *\n\t * @example\n\t * ```ts\n\t * cli.info('提示信息');\n\t * ```\n\t */\n\tinfo(text: string): this {\n\t\tthis._out(chalk.blue(`ℹ ${text}`));\n\t\treturn this;\n\t}\n\n\t// ═══════════════════════════════════════════\n\t//  Figlet ASCII Art 封装\n\t// ═══════════════════════════════════════════\n\n\t/**\n\t * 生成并输出 ASCII Art 文本\n\t *\n\t * @param text - 要转换的文本\n\t * @param font - figlet 字体名称（默认 'Standard'）\n\t * @returns 当前实例\n\t *\n\t * @example\n\t * ```ts\n\t * cli.printBanner('Hello');\n\t * cli.printBanner('Big', 'Big');\n\t * ```\n\t */\n\tprintBanner(text: string, font?: string): this {\n\t\tconst art = figlet.textSync(text, { font: font as figlet.Fonts });\n\t\tthis._out(chalk.cyan(art));\n\t\treturn this;\n\t}\n\n\t/**\n\t * 生成 ASCII Art 文本（不输出）\n\t *\n\t * @param text - 要转换的文本\n\t * @param font - figlet 字体名称（默认 'Standard'）\n\t * @returns 生成的 ASCII Art 文本\n\t *\n\t * @example\n\t * ```ts\n\t * const art = cli.banner('Hello');\n\t * fs.writeFileSync('banner.txt', art);\n\t * ```\n\t */\n\tbanner(text: string, font?: string): string {\n\t\treturn figlet.textSync(text, { font: font as figlet.Fonts });\n\t}\n\n\t/**\n\t * 异步生成 ASCII Art 文本\n\t *\n\t * @param text - 要转换的文本\n\t * @param font - figlet 字体名称（默认 'Standard'）\n\t * @returns Promise，解析为 ASCII Art 文本\n\t */\n\tbannerAsync(text: string, font?: string): Promise<string> {\n\t\treturn figlet.text(text, { font: font as figlet.Fonts });\n\t}\n\n\t/**\n\t * 获取所有可用的 figlet 字体列表\n\t *\n\t * @returns 字体名称数组\n\t */\n\tgetFonts(): string[] {\n\t\treturn figlet.fontsSync();\n\t}\n\n\t// ═══════════════════════════════════════════\n\t//  光标控制\n\t// ═══════════════════════════════════════════\n\n\t/** @private */\n\tprivate _hideCursor(): void {\n\t\tcliCursor.hide();\n\t\tthis._cursorHidden = true;\n\t\tthis._registerExitHandler();\n\t}\n\n\t/** @private */\n\tprivate _showCursor(): void {\n\t\tif (this._cursorHidden) {\n\t\t\tcliCursor.show();\n\t\t\tthis._cursorHidden = false;\n\t\t}\n\t}\n\n\t/** @private */\n\tprivate _registerExitHandler(): void {\n\t\tif (this._exitHandlerRegistered) return;\n\t\tthis._exitHandlerRegistered = true;\n\n\t\tconst cleanup = (): void => {\n\t\t\tthis._showCursor();\n\t\t\tif (this._spinner?.isSpinning) {\n\t\t\t\tthis._spinner.stop();\n\t\t\t}\n\t\t};\n\n\t\tprocess.on('exit', cleanup);\n\t\tprocess.on('SIGINT', () => { cleanup(); process.exit(130); });\n\t\tprocess.on('SIGTERM', () => { cleanup(); process.exit(143); });\n\t}\n\n\t/**\n\t * 显示终端光标\n\t *\n\t * @returns 当前实例\n\t */\n\tcursorShow(): this {\n\t\tthis._showCursor();\n\t\treturn this;\n\t}\n\n\t/**\n\t * 隐藏终端光标\n\t *\n\t * @returns 当前实例\n\t */\n\tcursorHide(): this {\n\t\tthis._hideCursor();\n\t\treturn this;\n\t}\n\n\t/**\n\t * 切换光标可见性\n\t *\n\t * @param force - true 显示，false 隐藏，undefined 切换\n\t * @returns 当前实例\n\t */\n\tcursorToggle(force?: boolean): this {\n\t\tif (force === true) {\n\t\t\tthis._showCursor();\n\t\t} else if (force === false) {\n\t\t\tthis._hideCursor();\n\t\t} else {\n\t\t\tif (this._cursorHidden) {\n\t\t\t\tthis._showCursor();\n\t\t\t} else {\n\t\t\t\tthis._hideCursor();\n\t\t\t}\n\t\t}\n\t\treturn this;\n\t}\n\n\t// ═══════════════════════════════════════════\n\t//  通用日志\n\t// ═══════════════════════════════════════════\n\n\t/**\n\t * 输出普通日志\n\t *\n\t * @param text - 文本内容\n\t * @returns 当前实例\n\t *\n\t * @example\n\t * ```ts\n\t * cli.print('Hello World');\n\t * ```\n\t */\n\tprint(text: string): this {\n\t\tthis._out(text);\n\t\treturn this;\n\t}\n\n\t/**\n\t * 输出带前缀的日志\n\t *\n\t * @param prefix - 前缀文本\n\t * @param text - 日志内容\n\t * @returns 当前实例\n\t *\n\t * @example\n\t * ```ts\n\t * cli.logWithPrefix('[INFO]', '任务完成');\n\t * ```\n\t */\n\tlogWithPrefix(prefix: string, text: string): this {\n\t\tthis._out(`${chalk.gray(prefix)} ${text}`);\n\t\treturn this;\n\t}\n\n\t/**\n\t * 输出空行\n\t *\n\t * @returns 当前实例\n\t */\n\tnewline(): this {\n\t\tthis._out('');\n\t\treturn this;\n\t}\n\n\t/**\n\t * 输出分隔线\n\t *\n\t * @param char - 分隔线字符\n\t * @param length - 分隔线长度\n\t * @returns 当前实例\n\t *\n\t * @example\n\t * ```ts\n\t * cli.divider('=', 50);\n\t * ```\n\t */\n\tdivider(char = '─', length = 40): this {\n\t\tthis._out(chalk.gray(char.repeat(length)));\n\t\treturn this;\n\t}\n}\n"],"mappings":"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"}

package/package.json

@@ -0,0 +1,57 @@
+{
+	"name": "wbw-cli-tools-lib",
+	"version": "1.0.0",
+	"description": "CLI工具库 - 封装inquirer/commander/ora/chalk/figlet等",
+	"type": "module",
+	"main": "./dist/index.js",
+	"module": "./dist/esm/index.js",
+	"types": "./dist/esm/index.d.ts",
+	"exports": {
+		".": {
+			"import": {
+				"types": "./dist/esm/index.d.ts",
+				"default": "./dist/esm/index.js"
+			},
+			"require": {
+				"types": "./dist/esm/index.d.ts",
+				"default": "./dist/index.js"
+			}
+		}
+	},
+	"files": [
+		"dist"
+	],
+	"author": {
+		"name": "wbw121124"
+	},
+	"license": "GPLv3.0-only",
+	"private": false,
+	"sideEffects": false,
+	"engines": {
+		"node": ">=18.0.0"
+	},
+	"scripts": {
+		"typecheck": "tsc --noEmit",
+		"build": "npm run typecheck && rolldown -c",
+		"clean": "rimraf dist",
+		"doc": "rimraf docs && typedoc",
+		"dev": "npm run doc && npm run build"
+	},
+	"dependencies": {
+		"@inquirer/prompts": "^7.0.0",
+		"commander": "^13.0.0",
+		"ora": "^8.0.0",
+		"cli-cursor": "^4.0.0",
+		"chalk": "^5.4.1",
+		"figlet": "^1.8.0"
+	},
+	"devDependencies": {
+		"@types/figlet": "^1.7.0",
+		"@types/node": "^22.0.0",
+		"rolldown": "^1.2.0",
+		"rolldown-plugin-dts": "^0.27.14",
+		"typedoc": "^0.28.20",
+		"typescript": "^5.7.0",
+		"rimraf": "^6.0.0"
+	}
+}