grf-cli 1.0.0 → 1.0.3

package/dist/ui/table.js

@@ -0,0 +1,213 @@
+"use strict";
+/**
+ * 表格输出模块
+ * 封装表格格式化和输出功能
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.padEnd = padEnd;
+exports.padStart = padStart;
+exports.truncate = truncate;
+exports.printTable = printTable;
+exports.printKeyValue = printKeyValue;
+exports.printSeparator = printSeparator;
+exports.printEmptyLine = printEmptyLine;
+exports.printTitle = printTitle;
+exports.printTotal = printTotal;
+const chalk_1 = __importDefault(require("chalk"));
+/**
+ * 将字符串填充到指定宽度（右侧填充空格）
+ * @param str 原始字符串
+ * @param width 目标宽度
+ * @returns 填充后的字符串
+ *
+ * @example
+ * ```typescript
+ * padEnd("hello", 10); // "hello     "
+ * padEnd("hello world", 5); // "hello world" (不截断)
+ * ```
+ */
+function padEnd(str, width) {
+    if (str.length >= width)
+        return str;
+    return str + " ".repeat(width - str.length);
+}
+/**
+ * 将字符串填充到指定宽度（左侧填充空格）
+ * @param str 原始字符串
+ * @param width 目标宽度
+ * @returns 填充后的字符串
+ *
+ * @example
+ * ```typescript
+ * padStart("42", 5); // "   42"
+ * ```
+ */
+function padStart(str, width) {
+    if (str.length >= width)
+        return str;
+    return " ".repeat(width - str.length) + str;
+}
+/**
+ * 截断长字符串
+ * @param str 原始字符串
+ * @param maxLength 最大长度
+ * @param suffix 截断后缀，默认为 "..."
+ * @returns 截断后的字符串
+ *
+ * @example
+ * ```typescript
+ * truncate("hello world", 8); // "hello..."
+ * truncate("hello", 10); // "hello"
+ * ```
+ */
+function truncate(str, maxLength, suffix = "...") {
+    if (str.length <= maxLength)
+        return str;
+    return str.slice(0, maxLength - suffix.length) + suffix;
+}
+/**
+ * 格式化单元格内容
+ * @param value 单元格值
+ * @param column 列定义
+ * @returns 格式化后的字符串
+ */
+function formatCell(value, column) {
+    const truncated = truncate(value, column.width - 2);
+    switch (column.align) {
+        case "right":
+            return padStart(truncated, column.width);
+        case "center": {
+            const totalPadding = column.width - truncated.length;
+            const leftPadding = Math.floor(totalPadding / 2);
+            const rightPadding = totalPadding - leftPadding;
+            return " ".repeat(leftPadding) + truncated + " ".repeat(rightPadding);
+        }
+        case "left":
+        default:
+            return padEnd(truncated, column.width);
+    }
+}
+/**
+ * 打印表格
+ * @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"]
+ *   ]
+ * );
+ * ```
+ */
+function printTable(options, rows) {
+    const { columns, indent = "", showHeader = true, headerColor = "gray", } = options;
+    // 打印表头
+    if (showHeader) {
+        const headerRow = columns
+            .map((col) => formatCell(col.header, col))
+            .join("");
+        const coloredHeader = applyColor(headerRow, headerColor);
+        console.log(indent + coloredHeader);
+    }
+    // 打印数据行
+    for (const row of rows) {
+        const formattedRow = columns
+            .map((col, index) => formatCell(row[index] ?? "", col))
+            .join("");
+        console.log(indent + formattedRow);
+    }
+}
+/**
+ * 应用颜色
+ * @param text 文本
+ * @param color 颜色名称
+ * @returns 带颜色的文本
+ */
+function applyColor(text, color) {
+    switch (color) {
+        case "gray":
+            return chalk_1.default.gray(text);
+        case "white":
+            return chalk_1.default.white(text);
+        case "cyan":
+            return chalk_1.default.cyan(text);
+        case "yellow":
+            return chalk_1.default.yellow(text);
+        default:
+            return text;
+    }
+}
+/**
+ * 打印简单的键值对列表
+ * @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 });
+ * ```
+ */
+function printKeyValue(items, options = {}) {
+    const { indent = "", keyWidth = 12, separator = ":" } = options;
+    for (const item of items) {
+        const key = chalk_1.default.gray(padEnd(item.key + separator, keyWidth));
+        console.log(`${indent}${key} ${item.value}`);
+    }
+}
+/**
+ * 打印分隔线
+ * @param length 分隔线长度
+ * @param char 分隔字符，默认为 "-"
+ */
+function printSeparator(length, char = "-") {
+    console.log(chalk_1.default.gray(char.repeat(length)));
+}
+/**
+ * 打印空行
+ * @param count 空行数量，默认为 1
+ */
+function printEmptyLine(count = 1) {
+    for (let i = 0; i < count; i++) {
+        console.log();
+    }
+}
+/**
+ * 打印标题
+ * @param title 标题文本
+ * @param options 配置选项
+ */
+function printTitle(title, options = {}) {
+    const { bold = true, icon } = options;
+    const text = icon ? `${icon} ${title}` : title;
+    console.log(bold ? chalk_1.default.bold(text) : text);
+}
+/**
+ * 打印统计信息
+ * @param total 总数
+ * @param unit 单位（单数形式）
+ * @param pluralUnit 单位（复数形式），默认为单数形式加 "s"
+ */
+function printTotal(total, unit, pluralUnit) {
+    const actualUnit = total === 1 ? unit : (pluralUnit ?? unit + "s");
+    console.log(chalk_1.default.gray(`Total: ${total} ${actualUnit}`));
+}
+//# sourceMappingURL=table.js.map

package/dist/ui/table.js.map

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

package/dist/utils/constants.d.ts

@@ -0,0 +1,152 @@
+/**
+ * 常量定义模块
+ * 项目中使用的各种常量
+ */
+/**
+ * 目录名称常量
+ */
+export declare const DIR_NAMES: {
+    /** .gitreference 目录名 */
+    readonly GITREFERENCE: ".gitreference";
+    /** .git 目录名 */
+    readonly GIT: ".git";
+};
+/**
+ * 文件名称常量
+ */
+export declare const FILE_NAMES: {
+    /** 加载状态文件 */
+    readonly LOADING_JSON: "loading.json";
+    /** 仓库元信息文件 */
+    readonly META_JSON: "meta.json";
+    /** 旧版元信息文件名 */
+    readonly GRF_META_JSON: ".grf-meta.json";
+    /** 旧版元信息文件名 */
+    readonly GITREFERENCE_META_JSON: ".gitreference-meta.json";
+    /** Git 忽略文件 */
+    readonly GITIGNORE: ".gitignore";
+    /** 全局配置文件 */
+    readonly CONFIG_JSON: "config.json";
+};
+/**
+ * 默认值常量
+ */
+export declare const DEFAULTS: {
+    /** 默认分支名 */
+    readonly BRANCH: "main";
+    /** 默认浅克隆深度 */
+    readonly SHALLOW_DEPTH: 1;
+    /** 是否默认使用浅克隆 */
+    readonly SHALLOW_CLONE: true;
+    /** 短 commit ID 长度 */
+    readonly SHORT_COMMIT_LENGTH: 7;
+};
+/**
+ * 表格列宽常量
+ */
+export declare const TABLE_COLUMNS: {
+    /** 仓库名称列宽 */
+    readonly NAME: 40;
+    /** 分支列宽 */
+    readonly BRANCH: 15;
+    /** Commit ID 列宽 */
+    readonly COMMIT: 10;
+    /** 日期列宽 */
+    readonly DATE: 12;
+    /** 路径列宽 */
+    readonly PATH: 30;
+    /** 状态列宽 */
+    readonly STATUS: 15;
+};
+/**
+ * 排除的文件/目录列表（复制时排除）
+ */
+export declare const COPY_EXCLUDES: readonly [".git", "meta.json", ".grf-meta.json", ".gitreference-meta.json"];
+/**
+ * Git 相关常量
+ */
+export declare const GIT: {
+    /** 远程名称 */
+    readonly REMOTE_NAME: "origin";
+    /** 默认分支候选列表 */
+    readonly DEFAULT_BRANCHES: readonly ["main", "master"];
+};
+/**
+ * 超时设置（毫秒）
+ */
+export declare const TIMEOUTS: {
+    /** Git 操作超时 */
+    readonly GIT_OPERATION: 60000;
+    /** 网络请求超时 */
+    readonly NETWORK_REQUEST: 30000;
+};
+/**
+ * 限制设置
+ */
+export declare const LIMITS: {
+    /** 最大路径长度 */
+    readonly MAX_PATH_LENGTH: 260;
+    /** 最大仓库名称长度 */
+    readonly MAX_REPO_NAME_LENGTH: 255;
+    /** 最大并发操作数 */
+    readonly MAX_CONCURRENT_OPERATIONS: 5;
+};
+/**
+ * 正则表达式模式
+ */
+export declare const PATTERNS: {
+    /** HTTPS Git URL */
+    readonly HTTPS_GIT_URL: RegExp;
+    /** SSH Git URL */
+    readonly SSH_GIT_URL: RegExp;
+    /** 非法文件名字符 */
+    readonly INVALID_FILENAME_CHARS: RegExp;
+    /** 非法分支名字符 */
+    readonly INVALID_BRANCH_CHARS: RegExp;
+};
+/**
+ * 消息模板
+ */
+export declare const MESSAGES: {
+    /** 操作取消 */
+    readonly OPERATION_CANCELLED: "Operation cancelled.";
+    /** 无仓库可清理 */
+    readonly NO_REPOS_TO_CLEAN: "No repositories to clean.";
+    /** 无已缓存仓库 */
+    readonly NO_CACHED_REPOS: "No repositories cached yet.";
+    /** 无已加载参考代码 */
+    readonly NO_LOADED_REFS: "No loaded reference code in current project.";
+    /** 仓库未找到 */
+    readonly REPO_NOT_FOUND: (name: string) => string;
+    /** 仓库已存在 */
+    readonly REPO_ALREADY_EXISTS: (name: string) => string;
+};
+/**
+ * 命令提示
+ */
+export declare const HINTS: {
+    /** 添加仓库提示 */
+    readonly ADD_REPO: "Use 'grf add <url>' to add a repository.";
+    /** 查看列表提示 */
+    readonly LIST_REPOS: "Use 'grf list' to see all cached repositories.";
+    /** 查看已加载提示 */
+    readonly LIST_LOADED: "Use 'grf unload --list' to see all loaded reference code.";
+    /** 加载仓库提示 */
+    readonly LOAD_REPO: "Use 'grf load <name>' to load reference code to workspace.";
+    /** 更新仓库提示 */
+    readonly UPDATE_REPO: "Use 'grf update <name>' to update the repository.";
+    /** 清理仓库提示 */
+    readonly CLEAN_REPO: "Use 'grf clean <name>' to remove the repository.";
+};
+/**
+ * 应用信息
+ */
+export declare const APP_INFO: {
+    /** 应用名称 */
+    readonly NAME: "gitreference";
+    /** 命令名称 */
+    readonly COMMAND: "grf";
+    /** 配置目录名 */
+    readonly CONFIG_DIR: ".gitreference";
+};
+//# sourceMappingURL=constants.d.ts.map

package/dist/utils/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/utils/constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,eAAO,MAAM,SAAS;IACpB,wBAAwB;;IAExB,eAAe;;CAEP,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,UAAU;IACrB,aAAa;;IAEb,cAAc;;IAEd,eAAe;;IAEf,eAAe;;IAEf,eAAe;;IAEf,aAAa;;CAEL,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,QAAQ;IACnB,YAAY;;IAEZ,cAAc;;IAEd,gBAAgB;;IAEhB,qBAAqB;;CAEb,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,aAAa;IACxB,aAAa;;IAEb,WAAW;;IAEX,mBAAmB;;IAEnB,WAAW;;IAEX,WAAW;;IAEX,WAAW;;CAEH,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,aAAa,6EAKhB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,GAAG;IACd,WAAW;;IAEX,eAAe;;CAEP,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,QAAQ;IACnB,eAAe;;IAEf,aAAa;;CAEL,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,MAAM;IACjB,aAAa;;IAEb,eAAe;;IAEf,cAAc;;CAEN,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,QAAQ;IACnB,oBAAoB;;IAEpB,kBAAkB;;IAElB,cAAc;;IAEd,cAAc;;CAEN,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,QAAQ;IACnB,WAAW;;IAEX,aAAa;;IAEb,aAAa;;IAEb,eAAe;;IAEf,YAAY;oCACW,MAAM;IAC7B,YAAY;yCACgB,MAAM;CAC1B,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,KAAK;IAChB,aAAa;;IAEb,aAAa;;IAEb,cAAc;;IAEd,aAAa;;IAEb,aAAa;;IAEb,aAAa;;CAEL,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,QAAQ;IACnB,WAAW;;IAEX,WAAW;;IAEX,YAAY;;CAEJ,CAAC"}

package/dist/utils/constants.js

@@ -0,0 +1,160 @@
+"use strict";
+/**
+ * 常量定义模块
+ * 项目中使用的各种常量
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.APP_INFO = exports.HINTS = exports.MESSAGES = exports.PATTERNS = exports.LIMITS = exports.TIMEOUTS = exports.GIT = exports.COPY_EXCLUDES = exports.TABLE_COLUMNS = exports.DEFAULTS = exports.FILE_NAMES = exports.DIR_NAMES = void 0;
+/**
+ * 目录名称常量
+ */
+exports.DIR_NAMES = {
+    /** .gitreference 目录名 */
+    GITREFERENCE: ".gitreference",
+    /** .git 目录名 */
+    GIT: ".git",
+};
+/**
+ * 文件名称常量
+ */
+exports.FILE_NAMES = {
+    /** 加载状态文件 */
+    LOADING_JSON: "loading.json",
+    /** 仓库元信息文件 */
+    META_JSON: "meta.json",
+    /** 旧版元信息文件名 */
+    GRF_META_JSON: ".grf-meta.json",
+    /** 旧版元信息文件名 */
+    GITREFERENCE_META_JSON: ".gitreference-meta.json",
+    /** Git 忽略文件 */
+    GITIGNORE: ".gitignore",
+    /** 全局配置文件 */
+    CONFIG_JSON: "config.json",
+};
+/**
+ * 默认值常量
+ */
+exports.DEFAULTS = {
+    /** 默认分支名 */
+    BRANCH: "main",
+    /** 默认浅克隆深度 */
+    SHALLOW_DEPTH: 1,
+    /** 是否默认使用浅克隆 */
+    SHALLOW_CLONE: true,
+    /** 短 commit ID 长度 */
+    SHORT_COMMIT_LENGTH: 7,
+};
+/**
+ * 表格列宽常量
+ */
+exports.TABLE_COLUMNS = {
+    /** 仓库名称列宽 */
+    NAME: 40,
+    /** 分支列宽 */
+    BRANCH: 15,
+    /** Commit ID 列宽 */
+    COMMIT: 10,
+    /** 日期列宽 */
+    DATE: 12,
+    /** 路径列宽 */
+    PATH: 30,
+    /** 状态列宽 */
+    STATUS: 15,
+};
+/**
+ * 排除的文件/目录列表（复制时排除）
+ */
+exports.COPY_EXCLUDES = [
+    ".git",
+    "meta.json",
+    ".grf-meta.json",
+    ".gitreference-meta.json",
+];
+/**
+ * Git 相关常量
+ */
+exports.GIT = {
+    /** 远程名称 */
+    REMOTE_NAME: "origin",
+    /** 默认分支候选列表 */
+    DEFAULT_BRANCHES: ["main", "master"],
+};
+/**
+ * 超时设置（毫秒）
+ */
+exports.TIMEOUTS = {
+    /** Git 操作超时 */
+    GIT_OPERATION: 60000,
+    /** 网络请求超时 */
+    NETWORK_REQUEST: 30000,
+};
+/**
+ * 限制设置
+ */
+exports.LIMITS = {
+    /** 最大路径长度 */
+    MAX_PATH_LENGTH: 260,
+    /** 最大仓库名称长度 */
+    MAX_REPO_NAME_LENGTH: 255,
+    /** 最大并发操作数 */
+    MAX_CONCURRENT_OPERATIONS: 5,
+};
+/**
+ * 正则表达式模式
+ */
+exports.PATTERNS = {
+    /** HTTPS Git URL */
+    HTTPS_GIT_URL: /^https?:\/\/[^/]+\/[^/]+\/[^/]+/,
+    /** SSH Git URL */
+    SSH_GIT_URL: /^git@[^:]+:[^/]+\/[^/]+/,
+    /** 非法文件名字符 */
+    INVALID_FILENAME_CHARS: /[<>:"|?*\x00-\x1f]/,
+    /** 非法分支名字符 */
+    INVALID_BRANCH_CHARS: /[\s~^:?*\[\]\\@{}\x00-\x1f\x7f]/,
+};
+/**
+ * 消息模板
+ */
+exports.MESSAGES = {
+    /** 操作取消 */
+    OPERATION_CANCELLED: "Operation cancelled.",
+    /** 无仓库可清理 */
+    NO_REPOS_TO_CLEAN: "No repositories to clean.",
+    /** 无已缓存仓库 */
+    NO_CACHED_REPOS: "No repositories cached yet.",
+    /** 无已加载参考代码 */
+    NO_LOADED_REFS: "No loaded reference code in current project.",
+    /** 仓库未找到 */
+    REPO_NOT_FOUND: (name) => `Repository not found: ${name}`,
+    /** 仓库已存在 */
+    REPO_ALREADY_EXISTS: (name) => `Repository already exists: ${name}`,
+};
+/**
+ * 命令提示
+ */
+exports.HINTS = {
+    /** 添加仓库提示 */
+    ADD_REPO: "Use 'grf add <url>' to add a repository.",
+    /** 查看列表提示 */
+    LIST_REPOS: "Use 'grf list' to see all cached repositories.",
+    /** 查看已加载提示 */
+    LIST_LOADED: "Use 'grf unload --list' to see all loaded reference code.",
+    /** 加载仓库提示 */
+    LOAD_REPO: "Use 'grf load <name>' to load reference code to workspace.",
+    /** 更新仓库提示 */
+    UPDATE_REPO: "Use 'grf update <name>' to update the repository.",
+    /** 清理仓库提示 */
+    CLEAN_REPO: "Use 'grf clean <name>' to remove the repository.",
+};
+/**
+ * 应用信息
+ */
+exports.APP_INFO = {
+    /** 应用名称 */
+    NAME: "gitreference",
+    /** 命令名称 */
+    COMMAND: "grf",
+    /** 配置目录名 */
+    CONFIG_DIR: ".gitreference",
+};
+//# sourceMappingURL=constants.js.map

package/dist/utils/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/utils/constants.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH;;GAEG;AACU,QAAA,SAAS,GAAG;IACvB,wBAAwB;IACxB,YAAY,EAAE,eAAe;IAC7B,eAAe;IACf,GAAG,EAAE,MAAM;CACH,CAAC;AAEX;;GAEG;AACU,QAAA,UAAU,GAAG;IACxB,aAAa;IACb,YAAY,EAAE,cAAc;IAC5B,cAAc;IACd,SAAS,EAAE,WAAW;IACtB,eAAe;IACf,aAAa,EAAE,gBAAgB;IAC/B,eAAe;IACf,sBAAsB,EAAE,yBAAyB;IACjD,eAAe;IACf,SAAS,EAAE,YAAY;IACvB,aAAa;IACb,WAAW,EAAE,aAAa;CAClB,CAAC;AAEX;;GAEG;AACU,QAAA,QAAQ,GAAG;IACtB,YAAY;IACZ,MAAM,EAAE,MAAM;IACd,cAAc;IACd,aAAa,EAAE,CAAC;IAChB,gBAAgB;IAChB,aAAa,EAAE,IAAI;IACnB,qBAAqB;IACrB,mBAAmB,EAAE,CAAC;CACd,CAAC;AAEX;;GAEG;AACU,QAAA,aAAa,GAAG;IAC3B,aAAa;IACb,IAAI,EAAE,EAAE;IACR,WAAW;IACX,MAAM,EAAE,EAAE;IACV,mBAAmB;IACnB,MAAM,EAAE,EAAE;IACV,WAAW;IACX,IAAI,EAAE,EAAE;IACR,WAAW;IACX,IAAI,EAAE,EAAE;IACR,WAAW;IACX,MAAM,EAAE,EAAE;CACF,CAAC;AAEX;;GAEG;AACU,QAAA,aAAa,GAAG;IAC3B,MAAM;IACN,WAAW;IACX,gBAAgB;IAChB,yBAAyB;CACjB,CAAC;AAEX;;GAEG;AACU,QAAA,GAAG,GAAG;IACjB,WAAW;IACX,WAAW,EAAE,QAAQ;IACrB,eAAe;IACf,gBAAgB,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC;CAC5B,CAAC;AAEX;;GAEG;AACU,QAAA,QAAQ,GAAG;IACtB,eAAe;IACf,aAAa,EAAE,KAAK;IACpB,aAAa;IACb,eAAe,EAAE,KAAK;CACd,CAAC;AAEX;;GAEG;AACU,QAAA,MAAM,GAAG;IACpB,aAAa;IACb,eAAe,EAAE,GAAG;IACpB,eAAe;IACf,oBAAoB,EAAE,GAAG;IACzB,cAAc;IACd,yBAAyB,EAAE,CAAC;CACpB,CAAC;AAEX;;GAEG;AACU,QAAA,QAAQ,GAAG;IACtB,oBAAoB;IACpB,aAAa,EAAE,iCAAiC;IAChD,kBAAkB;IAClB,WAAW,EAAE,yBAAyB;IACtC,cAAc;IACd,sBAAsB,EAAE,oBAAoB;IAC5C,cAAc;IACd,oBAAoB,EAAE,iCAAiC;CAC/C,CAAC;AAEX;;GAEG;AACU,QAAA,QAAQ,GAAG;IACtB,WAAW;IACX,mBAAmB,EAAE,sBAAsB;IAC3C,aAAa;IACb,iBAAiB,EAAE,2BAA2B;IAC9C,aAAa;IACb,eAAe,EAAE,6BAA6B;IAC9C,eAAe;IACf,cAAc,EAAE,8CAA8C;IAC9D,YAAY;IACZ,cAAc,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,yBAAyB,IAAI,EAAE;IACjE,YAAY;IACZ,mBAAmB,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,8BAA8B,IAAI,EAAE;CACnE,CAAC;AAEX;;GAEG;AACU,QAAA,KAAK,GAAG;IACnB,aAAa;IACb,QAAQ,EAAE,0CAA0C;IACpD,aAAa;IACb,UAAU,EAAE,gDAAgD;IAC5D,cAAc;IACd,WAAW,EAAE,2DAA2D;IACxE,aAAa;IACb,SAAS,EAAE,4DAA4D;IACvE,aAAa;IACb,WAAW,EAAE,mDAAmD;IAChE,aAAa;IACb,UAAU,EAAE,kDAAkD;CACtD,CAAC;AAEX;;GAEG;AACU,QAAA,QAAQ,GAAG;IACtB,WAAW;IACX,IAAI,EAAE,cAAc;IACpB,WAAW;IACX,OAAO,EAAE,KAAK;IACd,YAAY;IACZ,UAAU,EAAE,eAAe;CACnB,CAAC"}

package/dist/utils/error.d.ts

@@ -0,0 +1,109 @@
+/**
+ * 错误处理模块
+ * 提供统一的错误处理工具
+ */
+import { GrfError, ErrorCode } from "../types/index.js";
+/**
+ * 错误处理选项
+ */
+export interface HandleErrorOptions {
+    /** 是否退出进程 */
+    exit?: boolean;
+    /** 退出码 */
+    exitCode?: number;
+    /** 是否显示详细信息 */
+    verbose?: boolean;
+    /** 额外的提示信息 */
+    hints?: string[];
+}
+/**
+ * 统一处理错误并输出到控制台
+ * @param error 错误对象
+ * @param options 处理选项
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await someOperation();
+ * } catch (error) {
+ *   handleError(error, { exit: true });
+ * }
+ * ```
+ */
+export declare function handleError(error: unknown, options?: HandleErrorOptions): void;
+/**
+ * 获取错误消息
+ * @param error 错误对象
+ * @returns 错误消息字符串
+ */
+export declare function getErrorMessage(error: unknown): string;
+/**
+ * 创建一个 GrfError 实例
+ * @param code 错误码
+ * @param message 错误消息
+ * @returns GrfError 实例
+ *
+ * @example
+ * ```typescript
+ * throw createError(ErrorCode.REPO_NOT_FOUND, "Repository 'my-repo' not found");
+ * ```
+ */
+export declare function createError(code: ErrorCode, message: string): GrfError;
+/**
+ * 包装异步操作，统一处理错误
+ * @param operation 异步操作
+ * @param options 错误处理选项
+ * @returns 操作结果或 undefined（如果发生错误且不退出）
+ *
+ * @example
+ * ```typescript
+ * const result = await wrapAsync(
+ *   async () => await fetchData(),
+ *   { exit: true }
+ * );
+ * ```
+ */
+export declare function wrapAsync<T>(operation: () => Promise<T>, options?: HandleErrorOptions): Promise<T | undefined>;
+/**
+ * 断言条件为真，否则抛出错误
+ * @param condition 条件
+ * @param code 错误码
+ * @param message 错误消息
+ *
+ * @example
+ * ```typescript
+ * assertCondition(repo !== null, ErrorCode.REPO_NOT_FOUND, "Repository not found");
+ * ```
+ */
+export declare function assertCondition(condition: boolean, code: ErrorCode, message: string): asserts condition;
+/**
+ * 断言值不为 null 或 undefined
+ * @param value 要检查的值
+ * @param code 错误码
+ * @param message 错误消息
+ * @returns 非空值
+ *
+ * @example
+ * ```typescript
+ * const repo = assertNotNull(
+ *   await repository.get(name),
+ *   ErrorCode.REPO_NOT_FOUND,
+ *   `Repository '${name}' not found`
+ * );
+ * ```
+ */
+export declare function assertNotNull<T>(value: T | null | undefined, code: ErrorCode, message: string): T;
+/**
+ * 检查是否为 GrfError
+ * @param error 错误对象
+ * @returns 是否为 GrfError
+ */
+export declare function isGrfError(error: unknown): error is GrfError;
+/**
+ * 检查错误是否为特定错误码
+ * @param error 错误对象
+ * @param code 错误码
+ * @returns 是否匹配
+ */
+export declare function isErrorCode(error: unknown, code: ErrorCode): boolean;
+//# sourceMappingURL=error.d.ts.map

package/dist/utils/error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../src/utils/error.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAExD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,aAAa;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,UAAU;IACV,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,cAAc;IACd,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,kBAAuB,GAC/B,IAAI,CA+BN;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CActD;AAkED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,QAAQ,CAEtE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAC/B,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAWxB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,OAAO,EAClB,IAAI,EAAE,SAAS,EACf,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,SAAS,CAInB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAC7B,KAAK,EAAE,CAAC,GAAG,IAAI,GAAG,SAAS,EAC3B,IAAI,EAAE,SAAS,EACf,OAAO,EAAE,MAAM,GACd,CAAC,CAKH;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAE5D;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,GAAG,OAAO,CAEpE"}