grf-cli 1.0.2 → 1.0.4

package/dist/ui/prompt.js

@@ -0,0 +1,223 @@
+"use strict";
+/**
+ * 用户交互提示模块
+ * 封装确认提示和用户输入功能
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.confirm = confirm;
+exports.prompt = prompt;
+exports.selectByNumber = selectByNumber;
+exports.showCancelled = showCancelled;
+exports.showWarning = showWarning;
+exports.showInfo = showInfo;
+exports.showSuccess = showSuccess;
+const readline = __importStar(require("readline"));
+const chalk_1 = __importDefault(require("chalk"));
+/**
+ * 显示确认提示，等待用户输入 y/n
+ * @param message 提示消息
+ * @param options 配置选项
+ * @returns 用户是否确认
+ *
+ * @example
+ * ```typescript
+ * // 默认为 No
+ * const confirmed = await confirm("Are you sure?");
+ *
+ * // 默认为 Yes
+ * const confirmed = await confirm("Continue?", { defaultValue: true });
+ * ```
+ */
+async function confirm(message, options = {}) {
+    const { defaultValue = false, suffix } = options;
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    // 根据默认值确定提示后缀
+    const promptSuffix = suffix ?? (defaultValue ? "(Y/n)" : "(y/N)");
+    return new Promise((resolve) => {
+        rl.question(`${message} ${promptSuffix} `, (answer) => {
+            rl.close();
+            const trimmedAnswer = answer.trim().toLowerCase();
+            // 如果用户直接按回车，使用默认值
+            if (trimmedAnswer === "") {
+                resolve(defaultValue);
+                return;
+            }
+            // 检查是否为肯定回答
+            resolve(trimmedAnswer === "y" || trimmedAnswer === "yes");
+        });
+    });
+}
+/**
+ * 显示输入提示，等待用户输入
+ * @param message 提示消息
+ * @param options 配置选项
+ * @returns 用户输入的内容
+ *
+ * @example
+ * ```typescript
+ * const name = await prompt("Enter repository name:");
+ *
+ * const name = await prompt("Enter name:", {
+ *   defaultValue: "default-name",
+ *   validate: (input) => input.length > 0 || "Name cannot be empty"
+ * });
+ * ```
+ */
+async function prompt(message, options = {}) {
+    const { defaultValue, allowEmpty = false, validate } = options;
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    // 构建提示消息
+    let promptMessage = message;
+    if (defaultValue) {
+        promptMessage += chalk_1.default.gray(` (${defaultValue})`);
+    }
+    promptMessage += " ";
+    return new Promise((resolve) => {
+        const askQuestion = () => {
+            rl.question(promptMessage, (answer) => {
+                const trimmedAnswer = answer.trim();
+                // 如果用户直接按回车且有默认值，使用默认值
+                if (trimmedAnswer === "" && defaultValue !== undefined) {
+                    rl.close();
+                    resolve(defaultValue);
+                    return;
+                }
+                // 检查是否允许空输入
+                if (trimmedAnswer === "" && !allowEmpty) {
+                    console.log(chalk_1.default.red("Input cannot be empty. Please try again."));
+                    askQuestion();
+                    return;
+                }
+                // 执行验证
+                if (validate) {
+                    const validationResult = validate(trimmedAnswer);
+                    if (validationResult !== true) {
+                        const errorMessage = typeof validationResult === "string"
+                            ? validationResult
+                            : "Invalid input. Please try again.";
+                        console.log(chalk_1.default.red(errorMessage));
+                        askQuestion();
+                        return;
+                    }
+                }
+                rl.close();
+                resolve(trimmedAnswer);
+            });
+        };
+        askQuestion();
+    });
+}
+/**
+ * 显示带有选项的选择提示
+ * @param message 提示消息
+ * @param choices 选项列表
+ * @returns 用户选择的选项索引
+ *
+ * @example
+ * ```typescript
+ * const index = await select("Choose an option:", [
+ *   "Option 1",
+ *   "Option 2",
+ *   "Option 3"
+ * ]);
+ * ```
+ */
+async function selectByNumber(message, choices) {
+    console.log(message);
+    console.log();
+    // 显示选项
+    choices.forEach((choice, index) => {
+        console.log(`  ${chalk_1.default.cyan(index + 1)}. ${choice}`);
+    });
+    console.log();
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    return new Promise((resolve) => {
+        const askQuestion = () => {
+            rl.question(`Enter number (1-${choices.length}): `, (answer) => {
+                const num = parseInt(answer.trim(), 10);
+                if (isNaN(num) || num < 1 || num > choices.length) {
+                    console.log(chalk_1.default.red(`Please enter a number between 1 and ${choices.length}.`));
+                    askQuestion();
+                    return;
+                }
+                rl.close();
+                resolve(num - 1);
+            });
+        };
+        askQuestion();
+    });
+}
+/**
+ * 显示操作取消消息
+ * @param message 可选的自定义消息
+ */
+function showCancelled(message) {
+    console.log(chalk_1.default.yellow(message ?? "Operation cancelled."));
+}
+/**
+ * 显示警告消息
+ * @param message 警告消息
+ */
+function showWarning(message) {
+    console.log(chalk_1.default.yellow(`⚠️  ${message}`));
+}
+/**
+ * 显示信息消息
+ * @param message 信息消息
+ */
+function showInfo(message) {
+    console.log(chalk_1.default.blue(`ℹ️  ${message}`));
+}
+/**
+ * 显示成功消息
+ * @param message 成功消息
+ */
+function showSuccess(message) {
+    console.log(chalk_1.default.green(`✓ ${message}`));
+}
+//# sourceMappingURL=prompt.js.map

package/dist/ui/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../src/ui/prompt.ts"],"names":[],"mappings":"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"}

package/dist/ui/spinner.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Spinner 封装模块
+ * 提供统一的加载指示器接口
+ */
+import { type Ora, type Options as OraOptions } from "ora";
+/**
+ * Spinner 配置选项
+ */
+export interface SpinnerOptions {
+    /** 初始文本 */
+    text?: string;
+    /** 是否立即启动 */
+    start?: boolean;
+    /** 颜色 */
+    color?: OraOptions["color"];
+    /** 前缀文本 */
+    prefixText?: string;
+}
+/**
+ * Spinner 实例类型
+ */
+export type Spinner = Ora;
+/**
+ * 创建一个新的 spinner 实例
+ * @param textOrOptions 文本或配置选项
+ * @returns Spinner 实例
+ *
+ * @example
+ * ```typescript
+ * // 简单用法
+ * const spinner = createSpinner("Loading...");
+ * spinner.start();
+ * // ... 执行操作
+ * spinner.succeed("Done!");
+ *
+ * // 使用选项
+ * const spinner = createSpinner({
+ *   text: "Processing...",
+ *   color: "cyan",
+ *   start: true
+ * });
+ * ```
+ */
+export declare function createSpinner(textOrOptions?: string | SpinnerOptions): Spinner;
+/**
+ * 创建并立即启动一个 spinner
+ * @param text 显示文本
+ * @returns 已启动的 Spinner 实例
+ *
+ * @example
+ * ```typescript
+ * const spinner = startSpinner("Cloning repository...");
+ * // ... 执行操作
+ * spinner.succeed("Repository cloned!");
+ * ```
+ */
+export declare function startSpinner(text: string): Spinner;
+/**
+ * 带有成功/失败回调的 spinner 包装器
+ * @param text 初始文本
+ * @param task 要执行的异步任务
+ * @returns 任务结果
+ *
+ * @example
+ * ```typescript
+ * const result = await withSpinner("Fetching data...", async (spinner) => {
+ *   const data = await fetchData();
+ *   spinner.text = "Processing data...";
+ *   return processData(data);
+ * });
+ * ```
+ */
+export declare function withSpinner<T>(text: string, task: (spinner: Spinner) => Promise<T>): Promise<T>;
+/**
+ * 带有自定义成功/失败消息的 spinner 包装器
+ * @param options 配置选项
+ * @param task 要执行的异步任务
+ * @returns 任务结果
+ *
+ * @example
+ * ```typescript
+ * const result = await withSpinnerMessages(
+ *   {
+ *     start: "Cloning repository...",
+ *     success: "Repository cloned successfully!",
+ *     fail: "Failed to clone repository"
+ *   },
+ *   async () => {
+ *     return await cloneRepo(url);
+ *   }
+ * );
+ * ```
+ */
+export declare function withSpinnerMessages<T>(options: {
+    start: string;
+    success?: string;
+    fail?: string;
+}, task: (spinner: Spinner) => Promise<T>): Promise<T>;
+//# sourceMappingURL=spinner.d.ts.map

package/dist/ui/spinner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spinner.d.ts","sourceRoot":"","sources":["../../src/ui/spinner.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAY,EAAE,KAAK,GAAG,EAAE,KAAK,OAAO,IAAI,UAAU,EAAE,MAAM,KAAK,CAAC;AAGhE;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,WAAW;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa;IACb,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS;IACT,KAAK,CAAC,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;IAC5B,WAAW;IACX,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,MAAM,OAAO,GAAG,GAAG,CAAC;AAE1B;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,aAAa,CAC3B,aAAa,CAAC,EAAE,MAAM,GAAG,cAAc,GACtC,OAAO,CAiBT;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAElD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,WAAW,CAAC,CAAC,EACjC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,GACrC,OAAO,CAAC,CAAC,CAAC,CAWZ;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,mBAAmB,CAAC,CAAC,EACzC,OAAO,EAAE;IACP,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,EACD,IAAI,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,GACrC,OAAO,CAAC,CAAC,CAAC,CAmBZ"}

package/dist/ui/spinner.js

@@ -0,0 +1,136 @@
+"use strict";
+/**
+ * Spinner 封装模块
+ * 提供统一的加载指示器接口
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSpinner = createSpinner;
+exports.startSpinner = startSpinner;
+exports.withSpinner = withSpinner;
+exports.withSpinnerMessages = withSpinnerMessages;
+const ora_1 = __importDefault(require("ora"));
+const chalk_1 = __importDefault(require("chalk"));
+/**
+ * 创建一个新的 spinner 实例
+ * @param textOrOptions 文本或配置选项
+ * @returns Spinner 实例
+ *
+ * @example
+ * ```typescript
+ * // 简单用法
+ * const spinner = createSpinner("Loading...");
+ * spinner.start();
+ * // ... 执行操作
+ * spinner.succeed("Done!");
+ *
+ * // 使用选项
+ * const spinner = createSpinner({
+ *   text: "Processing...",
+ *   color: "cyan",
+ *   start: true
+ * });
+ * ```
+ */
+function createSpinner(textOrOptions) {
+    if (typeof textOrOptions === "string") {
+        return (0, ora_1.default)(textOrOptions);
+    }
+    const options = textOrOptions ?? {};
+    const spinner = (0, ora_1.default)({
+        text: options.text,
+        color: options.color,
+        prefixText: options.prefixText,
+    });
+    if (options.start) {
+        spinner.start();
+    }
+    return spinner;
+}
+/**
+ * 创建并立即启动一个 spinner
+ * @param text 显示文本
+ * @returns 已启动的 Spinner 实例
+ *
+ * @example
+ * ```typescript
+ * const spinner = startSpinner("Cloning repository...");
+ * // ... 执行操作
+ * spinner.succeed("Repository cloned!");
+ * ```
+ */
+function startSpinner(text) {
+    return (0, ora_1.default)(text).start();
+}
+/**
+ * 带有成功/失败回调的 spinner 包装器
+ * @param text 初始文本
+ * @param task 要执行的异步任务
+ * @returns 任务结果
+ *
+ * @example
+ * ```typescript
+ * const result = await withSpinner("Fetching data...", async (spinner) => {
+ *   const data = await fetchData();
+ *   spinner.text = "Processing data...";
+ *   return processData(data);
+ * });
+ * ```
+ */
+async function withSpinner(text, task) {
+    const spinner = (0, ora_1.default)(text).start();
+    try {
+        const result = await task(spinner);
+        spinner.succeed();
+        return result;
+    }
+    catch (error) {
+        spinner.fail();
+        throw error;
+    }
+}
+/**
+ * 带有自定义成功/失败消息的 spinner 包装器
+ * @param options 配置选项
+ * @param task 要执行的异步任务
+ * @returns 任务结果
+ *
+ * @example
+ * ```typescript
+ * const result = await withSpinnerMessages(
+ *   {
+ *     start: "Cloning repository...",
+ *     success: "Repository cloned successfully!",
+ *     fail: "Failed to clone repository"
+ *   },
+ *   async () => {
+ *     return await cloneRepo(url);
+ *   }
+ * );
+ * ```
+ */
+async function withSpinnerMessages(options, task) {
+    const spinner = (0, ora_1.default)(options.start).start();
+    try {
+        const result = await task(spinner);
+        if (options.success) {
+            spinner.succeed(chalk_1.default.green(options.success));
+        }
+        else {
+            spinner.succeed();
+        }
+        return result;
+    }
+    catch (error) {
+        if (options.fail) {
+            spinner.fail(chalk_1.default.red(options.fail));
+        }
+        else {
+            spinner.fail();
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=spinner.js.map

package/dist/ui/spinner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spinner.js","sourceRoot":"","sources":["../../src/ui/spinner.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;AA6CH,sCAmBC;AAcD,oCAEC;AAiBD,kCAcC;AAsBD,kDA0BC;AA7JD,8CAAgE;AAChE,kDAA0B;AAqB1B;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,SAAgB,aAAa,CAC3B,aAAuC;IAEvC,IAAI,OAAO,aAAa,KAAK,QAAQ,EAAE,CAAC;QACtC,OAAO,IAAA,aAAG,EAAC,aAAa,CAAC,CAAC;IAC5B,CAAC;IAED,MAAM,OAAO,GAAG,aAAa,IAAI,EAAE,CAAC;IACpC,MAAM,OAAO,GAAG,IAAA,aAAG,EAAC;QAClB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,UAAU,EAAE,OAAO,CAAC,UAAU;KAC/B,CAAC,CAAC;IAEH,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,OAAO,CAAC,KAAK,EAAE,CAAC;IAClB,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;;;;;;GAWG;AACH,SAAgB,YAAY,CAAC,IAAY;IACvC,OAAO,IAAA,aAAG,EAAC,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;AAC3B,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACI,KAAK,UAAU,WAAW,CAC/B,IAAY,EACZ,IAAsC;IAEtC,MAAM,OAAO,GAAG,IAAA,aAAG,EAAC,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;IAElC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,CAAC;QACnC,OAAO,CAAC,OAAO,EAAE,CAAC;QAClB,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,IAAI,EAAE,CAAC;QACf,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACI,KAAK,UAAU,mBAAmB,CACvC,OAIC,EACD,IAAsC;IAEtC,MAAM,OAAO,GAAG,IAAA,aAAG,EAAC,OAAO,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC;IAE3C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,CAAC;QACnC,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACpB,OAAO,CAAC,OAAO,CAAC,eAAK,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;QAChD,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,OAAO,EAAE,CAAC;QACpB,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,OAAO,CAAC,IAAI,CAAC,eAAK,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QACxC,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/ui/table.d.ts

@@ -0,0 +1,142 @@
+/**
+ * 表格输出模块
+ * 封装表格格式化和输出功能
+ */
+/**
+ * 将字符串填充到指定宽度（右侧填充空格）
+ * @param str 原始字符串
+ * @param width 目标宽度
+ * @returns 填充后的字符串
+ *
+ * @example
+ * ```typescript
+ * padEnd("hello", 10); // "hello     "
+ * padEnd("hello world", 5); // "hello world" (不截断)
+ * ```
+ */
+export declare function padEnd(str: string, width: number): string;
+/**
+ * 将字符串填充到指定宽度（左侧填充空格）
+ * @param str 原始字符串
+ * @param width 目标宽度
+ * @returns 填充后的字符串
+ *
+ * @example
+ * ```typescript
+ * padStart("42", 5); // "   42"
+ * ```
+ */
+export declare function padStart(str: string, width: number): string;
+/**
+ * 截断长字符串
+ * @param str 原始字符串
+ * @param maxLength 最大长度
+ * @param suffix 截断后缀，默认为 "..."
+ * @returns 截断后的字符串
+ *
+ * @example
+ * ```typescript
+ * truncate("hello world", 8); // "hello..."
+ * truncate("hello", 10); // "hello"
+ * ```
+ */
+export declare function truncate(str: string, maxLength: number, suffix?: string): string;
+/**
+ * 表格列定义
+ */
+export interface TableColumn {
+    /** 列标题 */
+    header: string;
+    /** 列宽度 */
+    width: number;
+    /** 对齐方式 */
+    align?: "left" | "right" | "center";
+}
+/**
+ * 表格配置选项
+ */
+export interface TableOptions {
+    /** 列定义 */
+    columns: TableColumn[];
+    /** 行前缀（缩进） */
+    indent?: string;
+    /** 是否显示表头 */
+    showHeader?: boolean;
+    /** 表头颜色 */
+    headerColor?: "gray" | "white" | "cyan" | "yellow";
+}
+/**
+ * 打印表格
+ * @param options 表格配置
+ * @param rows 数据行（每行是一个字符串数组）
+ *
+ * @example
+ * ```typescript
+ * printTable(
+ *   {
+ *     columns: [
+ *       { header: "NAME", width: 20 },
+ *       { header: "STATUS", width: 15 },
+ *       { header: "COUNT", width: 10, align: "right" }
+ *     ],
+ *     indent: "  ",
+ *     showHeader: true
+ *   },
+ *   [
+ *     ["repo1", "active", "42"],
+ *     ["repo2", "inactive", "0"]
+ *   ]
+ * );
+ * ```
+ */
+export declare function printTable(options: TableOptions, rows: string[][]): void;
+/**
+ * 打印简单的键值对列表
+ * @param items 键值对数组
+ * @param options 配置选项
+ *
+ * @example
+ * ```typescript
+ * printKeyValue([
+ *   { key: "Name", value: "my-repo" },
+ *   { key: "Path", value: "/path/to/repo" },
+ *   { key: "Branch", value: "main" }
+ * ], { indent: "  ", keyWidth: 10 });
+ * ```
+ */
+export declare function printKeyValue(items: {
+    key: string;
+    value: string;
+}[], options?: {
+    indent?: string;
+    keyWidth?: number;
+    separator?: string;
+}): void;
+/**
+ * 打印分隔线
+ * @param length 分隔线长度
+ * @param char 分隔字符，默认为 "-"
+ */
+export declare function printSeparator(length: number, char?: string): void;
+/**
+ * 打印空行
+ * @param count 空行数量，默认为 1
+ */
+export declare function printEmptyLine(count?: number): void;
+/**
+ * 打印标题
+ * @param title 标题文本
+ * @param options 配置选项
+ */
+export declare function printTitle(title: string, options?: {
+    bold?: boolean;
+    icon?: string;
+}): void;
+/**
+ * 打印统计信息
+ * @param total 总数
+ * @param unit 单位（单数形式）
+ * @param pluralUnit 单位（复数形式），默认为单数形式加 "s"
+ */
+export declare function printTotal(total: number, unit: string, pluralUnit?: string): void;
+//# sourceMappingURL=table.d.ts.map

package/dist/ui/table.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"table.d.ts","sourceRoot":"","sources":["../../src/ui/table.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;;;;;;;;;;GAWG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAGzD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAG3D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,QAAQ,CACtB,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,EACjB,MAAM,SAAQ,GACb,MAAM,CAGR;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,UAAU;IACV,MAAM,EAAE,MAAM,CAAC;IACf,UAAU;IACV,KAAK,EAAE,MAAM,CAAC;IACd,WAAW;IACX,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,UAAU;IACV,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,cAAc;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa;IACb,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW;IACX,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC;CACpD;AA0BD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,IAAI,CAwBxE;AA0BD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,EACvC,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GACvE,IAAI,CAON;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,SAAM,GAAG,IAAI,CAE/D;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,SAAI,GAAG,IAAI,CAI9C;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,GAC9C,IAAI,CAIN;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,UAAU,CAAC,EAAE,MAAM,GAClB,IAAI,CAGN"}