easyutilssdk 0.1.2 → 0.1.4

package/README.md

@@ -1,15 +1,39 @@
-# 🚀 Welcome to your new awesome project!
-
-This project has been created using **webpack-cli**, you can now run
-
+## typedoc使用说明
+依赖`tsconfig.json`的配置信息，用于生成文档
+### package.json
 ```
-npm run build
+scripts:{
+  "typedoc": "typedoc"
+},
+"devDependencies": {
+  "typedoc": "^0.28.15"
+}
 ```
 
-or
-
+### typedoc.json
 ```
-yarn build
+{
+  "entryPoints": ["./node/**/*.{ts,tsx}", "./src/**/*.{ts,tsx}"],
+  "exclude": ["*/__tests__/*.ts", "node/codeCommentTest/*.ts", "./node/index.ts", "./src/index.ts"],
+  "out": "docs",
+  "name": "EasyUtilsSDK",
+  "readme": "README.md",
+  "theme": "default",
+  "excludePrivate": true,
+  "excludeProtected": true,
+  "includeVersion": true,
+  "disableSources": false,
+}
 ```
 
-to bundle your application
+### 其他说明
+实践过程中为了更好的生成文档，做了如下调试：
+* 调整`"entryPoints": ["./node/**/*.{ts,tsx}", "./src/**/*.{ts,tsx}"]`,将所有的ts文件都产出文档。
+* 以`easyutilssdk/node/fs.ts`为例，同时导出了`nodeFsUtils`以及具体方法，正常使用应该使用`nodeFsUtils`，具体方法导出是为了产出doc文档
+* 以`easyutilssdk/node/fs.ts`为例，在头部声明`@module`用于生成doc文档
+```
+/**
+ * @module fs
+ * @description 文件系统工具模块，提供文件和文件夹操作的实用方法
+ */
+```

package/dist/__tests__/common.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/__tests__/json.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/common.d.ts

@@ -0,0 +1,4 @@
+declare const commonUtils: {
+    delay: (seconds: number) => Promise<void>;
+};
+export default commonUtils;

package/dist/excel.d.ts

@@ -0,0 +1,9 @@
+export interface jsonToExcelParams {
+    mergeRow?: boolean;
+    sheetName?: string;
+}
+declare const excelUtils: {
+    jsonToExcel: (jsonData: any[], fileName?: string, params?: jsonToExcelParams) => any[];
+    excelToJson: (filePath: string, sheetName?: string) => any[];
+};
+export default excelUtils;

package/dist/index.d.ts

@@ -1,5 +1,8 @@
 export type { SortOptions } from './json';
 declare const easyutilssdk: {
+    common: {
+        delay: (seconds: number) => Promise<void>;
+    };
     json: {
         sortObjectKeys: (obj: any, { sortType }?: import("./json").SortOptions) => object | null;
         sortJson: (jsonString: string, { sortType }?: import("./json").SortOptions) => string;

package/dist/middleware.d.ts

@@ -0,0 +1,61 @@
+/**
+ * 中间件系统核心类
+ * 支持添加、移除和执行中间件
+ */
+declare class MiddlewareManager {
+    constructor();
+    /**
+     * 添加中间件
+     * @param {Function} middleware - 中间件函数
+     * @param {Object} options - 配置选项
+     * @param {string} options.name - 中间件名称
+     * @param {number} options.priority - 优先级，数字越大优先级越高
+     */
+    use(middleware: any, options?: {}): this;
+    /**
+     * 移除中间件
+     * @param {string} name - 中间件名称
+     */
+    remove(name: any): this;
+    /**
+     * 执行所有中间件
+     * @param {*} context - 上下文对象
+     * @param {*} next - 下一个处理器
+     */
+    execute(context: any, next: any): Promise<void>;
+    /**
+     * 组合中间件函数
+     * @param {Array} middlewares - 中间件数组
+     * @returns {Function}
+     */
+    _compose(middlewares: any): (context: any, next: any) => Promise<any>;
+    /**
+     * 获取所有中间件信息
+     * @returns {Array}
+     */
+    getMiddlewares(): any;
+}
+/**
+ * 创建中间件管理器实例
+ * @returns {MiddlewareManager}
+ */
+export declare function createMiddlewareManager(): MiddlewareManager;
+/**
+ * 工具函数：创建一个简单的日志中间件
+ * @param {string} prefix - 日志前缀
+ * @returns {Function}
+ */
+export declare function createLoggerMiddleware(prefix?: string): (context: any, next: any) => any;
+/**
+ * 工具函数：创建一个错误处理中间件
+ * @param {Function} errorHandler - 错误处理器
+ * @returns {Function}
+ */
+export declare function createErrorMiddleware(errorHandler: any): (context: any, next: any) => any;
+/**
+ * 工具函数：创建一个超时中间件
+ * @param {number} timeout - 超时时间（毫秒）
+ * @returns {Function}
+ */
+export declare function createTimeoutMiddleware(timeout: any): (context: any, next: any) => Promise<unknown>;
+export default MiddlewareManager;

package/dist/node/babel.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @module nodeBabel
+ * @description Babel AST 工具模块，提供代码注释提取、处理和还原功能
+ */
+/**
+ * 提取代码文件中的注释选项
+ */
+export interface extractCommentsToFileOptions {
+    includeKeys?: string[];
+}
+/**
+ * 主函数：提取指定文件的注释并保存到另一文件，然后从源文件中删除注释
+ * @param sourcePath - 源文件路径
+ * @param commentsOutputPath - 注释输出文件路径
+ * @param metadataPath - 元数据文件路径
+ * @param options - 提取选项
+ */
+export declare function extractCommentsToFile(sourcePath: string, commentsOutputPath: string, metadataPath: string, options?: extractCommentsToFileOptions): Promise<void>;
+/**
+ * 还原代码文件（将注释加回到无注释的代码中）
+ * @param codePath - 无注释的代码文件路径
+ * @param metadataPath - 元数据文件路径
+ * @param outputPath - 还原后的代码输出路径
+ */
+export declare function restoreCodeFromFile(codePath: string, metadataPath: string, outputPath: string): Promise<void>;
+export declare const nodeBabelUtils: {
+    extractCommentsToFile: typeof extractCommentsToFile;
+    restoreCodeFromFile: typeof restoreCodeFromFile;
+};

package/dist/node/excel.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @module nodeExcel
+ * @description Excel 文件处理工具模块，提供 Excel 与 JSON 格式相互转换的功能
+ */
+/**
+ * 将Excel文件转换为JSON数据
+ * @param filePath - Excel文件路径
+ * @param sheetName - 工作表名称（可选，默认为第一个工作表）
+ * @returns JSON数据数组
+ */
+export declare const excelToJson: (filePath: string, sheetName?: string) => any[];
+/**
+ * 将Excel文件转换为JSON并保存到文件
+ * @param excelPath - Excel文件路径
+ * @param jsonPath - 输出JSON文件路径（可选，默认与Excel同名但扩展名为.json）
+ * @param sheetName - 工作表名称（可选，默认为第一个工作表）
+ */
+export declare const excelToJsonFile: (excelPath: string, jsonPath?: string, sheetName?: string) => void;
+export declare const nodeExcelUtils: {
+    excelToJson: (filePath: string, sheetName?: string) => any[];
+    excelToJsonFile: (excelPath: string, jsonPath?: string, sheetName?: string) => void;
+};

package/dist/node/fs.d.ts

@@ -1,27 +1,37 @@
-export interface LoopFolderCallback {
-    (filePath: string, isDirectory: boolean, index: number): void;
-}
 /**
-   * 读取文件并转换为JSON
-   * @param filePath 文件路径
-   * @returns 转换之后的JSON对象
-   */
+ * @module nodeFs
+ * @description 文件系统工具模块，提供文件和文件夹操作的实用方法
+ */
+/**
+ * 读取文件并转换为JSON，仅执行JSON.parse
+ * @param filePath - 文件路径
+ * @returns 转换之后的JSON对象
+ */
 export declare const readFileToJSONSync: (filePath: string) => object;
 /**
-   * 拷贝文件夹至目标目录
-   * @param source 源文件夹
-   * @param target 目标文件夹
-   */
+ * 拷贝文件夹下所有文件至目标目录
+ * todo 增加控制是否覆盖
+ * @param source - 源文件夹
+ * @param target - 目标文件夹
+ */
 export declare const copyFolderSync: (source: string, target: string) => void;
 /**
-   * 递归遍历文件夹执行特定回调
-   * @param folderPath 文件夹路径
-   * @param callBack 回调方法
-   */
+ * 文件夹遍历回调方法
+ * @param filePath - 文件路径
+ * @param isDirectory - 是否为文件夹
+ * @param index - 文件索引
+ */
+export interface LoopFolderCallback {
+    (filePath: string, isDirectory: boolean, index: number): void;
+}
+/**
+ * 递归遍历文件夹执行特定回调
+ * @param folderPath - 文件夹路径
+ * @param callBack - 回调方法
+ */
 export declare const loopFolderSync: (folderPath: string, callBack: LoopFolderCallback) => void;
-declare const fsUtils: {
+export declare const nodeFsUtils: {
     readFileToJSONSync: (filePath: string) => object;
     copyFolderSync: (source: string, target: string) => void;
     loopFolderSync: (folderPath: string, callBack: LoopFolderCallback) => void;
 };
-export default fsUtils;

package/dist/node/index.d.ts

@@ -1,13 +1,4 @@
-export type { LoopFolderCallback } from './fs';
-declare const _default: {
-    fs: {
-        readFileToJSONSync: (filePath: string) => object;
-        copyFolderSync: (source: string, target: string) => void;
-        loopFolderSync: (folderPath: string, callBack: import("./fs").LoopFolderCallback) => void;
-    };
-    json: {
-        sortObjectKeys: (obj: any, { sortType }?: import("../src/json").SortOptions) => object | null;
-        sortJson: (jsonString: string, { sortType }?: import("../src/json").SortOptions) => string;
-    };
-};
-export default _default;
+export * from './fs';
+export * from './babel';
+export * from './excel';
+export * from '../src/index';

package/dist/node/index.js

@@ -1,8 +1,8 @@
 /**
      *   版本信息
      *   realBranch(真实分支): dev
-     *   buildTime(打包时间): 2025/6/13 14:04:02
-     *   commitId(最后一条提交SHA): cf6388cbd07d30888bee6f48775ceab6d99ae7da
+     *   buildTime(打包时间): 2025/12/30 17:02:35
+     *   commitId(最后一条提交SHA): c774ff55af1a47a8b14369f4a6f3a781e1bd4245
      */
 
 /*
@@ -17,13 +17,33 @@
 /******/ 	"use strict";
 /******/ 	var __webpack_modules__ = ({
 
+/***/ "./node/babel.ts":
+/*!***********************!*\
+  !*** ./node/babel.ts ***!
+  \***********************/
+/***/ ((__unused_webpack_module, __webpack_exports__, __webpack_require__) => {
+
+eval("{__webpack_require__.r(__webpack_exports__);\n/* harmony export */ __webpack_require__.d(__webpack_exports__, {\n/* harmony export */   extractCommentsToFile: () => (/* binding */ extractCommentsToFile),\n/* harmony export */   nodeBabelUtils: () => (/* binding */ nodeBabelUtils),\n/* harmony export */   restoreCodeFromFile: () => (/* binding */ restoreCodeFromFile)\n/* harmony export */ });\n/* harmony import */ var fs__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! fs */ \"fs\");\n/* harmony import */ var fs__WEBPACK_IMPORTED_MODULE_0___default = /*#__PURE__*/__webpack_require__.n(fs__WEBPACK_IMPORTED_MODULE_0__);\n/* harmony import */ var path__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(/*! path */ \"path\");\n/* harmony import */ var path__WEBPACK_IMPORTED_MODULE_1___default = /*#__PURE__*/__webpack_require__.n(path__WEBPACK_IMPORTED_MODULE_1__);\n/* harmony import */ var _babel_parser__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(/*! @babel/parser */ \"@babel/parser\");\n/* harmony import */ var _babel_parser__WEBPACK_IMPORTED_MODULE_2___default = /*#__PURE__*/__webpack_require__.n(_babel_parser__WEBPACK_IMPORTED_MODULE_2__);\n/**\n * @module nodeBabel\n * @description Babel AST 工具模块，提供代码注释提取、处理和还原功能\n */\nvar __awaiter = (undefined && undefined.__awaiter) || function (thisArg, _arguments, P, generator) {\n    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }\n    return new (P || (P = Promise))(function (resolve, reject) {\n        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }\n        function rejected(value) { try { step(generator[\"throw\"](value)); } catch (e) { reject(e); } }\n        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }\n        step((generator = generator.apply(thisArg, _arguments || [])).next());\n    });\n};\nvar __generator = (undefined && undefined.__generator) || function (thisArg, body) {\n    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === \"function\" ? Iterator : Object).prototype);\n    return g.next = verb(0), g[\"throw\"] = verb(1), g[\"return\"] = verb(2), typeof Symbol === \"function\" && (g[Symbol.iterator] = function() { return this; }), g;\n    function verb(n) { return function (v) { return step([n, v]); }; }\n    function step(op) {\n        if (f) throw new TypeError(\"Generator is already executing.\");\n        while (g && (g = 0, op[0] && (_ = 0)), _) try {\n            if (f = 1, y && (t = op[0] & 2 ? y[\"return\"] : op[0] ? y[\"throw\"] || ((t = y[\"return\"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;\n            if (y = 0, t) op = [op[0] & 2, t.value];\n            switch (op[0]) {\n                case 0: case 1: t = op; break;\n                case 4: _.label++; return { value: op[1], done: false };\n                case 5: _.label++; y = op[1]; op = [0]; continue;\n                case 7: op = _.ops.pop(); _.trys.pop(); continue;\n                default:\n                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }\n                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }\n                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }\n                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }\n                    if (t[2]) _.ops.pop();\n                    _.trys.pop(); continue;\n            }\n            op = body.call(thisArg, _);\n        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }\n        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };\n    }\n};\nvar __spreadArray = (undefined && undefined.__spreadArray) || function (to, from, pack) {\n    if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {\n        if (ar || !(i in from)) {\n            if (!ar) ar = Array.prototype.slice.call(from, 0, i);\n            ar[i] = from[i];\n        }\n    }\n    return to.concat(ar || Array.prototype.slice.call(from));\n};\n\n\n\n/**\n * 提取代码文件中的注释\n * @param filePath - 源代码文件路径\n * @param options - 提取选项\n * @returns 包含注释数组和原始文件内容的对象\n */\nfunction extractComments(filePath, options) {\n    return __awaiter(this, void 0, void 0, function () {\n        var fileContent, ast, comments, _loop_1, i, error_1;\n        return __generator(this, function (_a) {\n            switch (_a.label) {\n                case 0:\n                    _a.trys.push([0, 2, , 3]);\n                    return [4 /*yield*/, fs__WEBPACK_IMPORTED_MODULE_0__.readFileSync(filePath, 'utf-8')];\n                case 1:\n                    fileContent = _a.sent();\n                    ast = _babel_parser__WEBPACK_IMPORTED_MODULE_2__.parse(fileContent, {\n                        sourceType: 'module',\n                        attachComment: true,\n                        plugins: [\n                            'jsx',\n                            'typescript'\n                        ]\n                    });\n                    comments = [];\n                    // 提取文件开头的注释\n                    if (ast.comments) {\n                        _loop_1 = function (i) {\n                            var comment = ast.comments[i];\n                            var includeKeys = options === null || options === void 0 ? void 0 : options.includeKeys;\n                            var pushFlag = true;\n                            if (includeKeys) {\n                                pushFlag = false;\n                                if (includeKeys.some(function (key) { return comment.value.includes(key); })) {\n                                    pushFlag = true;\n                                }\n                            }\n                            if (pushFlag) {\n                                comments.push({\n                                    type: comment.type, // 'CommentLine' for // or 'CommentBlock' for /* */\n                                    value: comment.value,\n                                    start: comment.start,\n                                    end: comment.end,\n                                    loc: comment.loc\n                                });\n                            }\n                        };\n                        for (i = 0; i < ast.comments.length; i++) {\n                            _loop_1(i);\n                        }\n                    }\n                    // 按起始位置排序，处理可能为undefined的情况\n                    comments.sort(function (a, b) { var _a, _b; return ((_a = a.start) !== null && _a !== void 0 ? _a : 0) - ((_b = b.start) !== null && _b !== void 0 ? _b : 0); });\n                    return [2 /*return*/, {\n                            comments: comments,\n                            originalContent: fileContent\n                        }];\n                case 2:\n                    error_1 = _a.sent();\n                    console.error(\"\\u89E3\\u6790\\u6587\\u4EF6 \".concat(filePath, \" \\u65F6\\u51FA\\u9519:\"), error_1.message);\n                    return [2 /*return*/, {\n                            comments: [],\n                            originalContent: ''\n                        }];\n                case 3: return [2 /*return*/];\n            }\n        });\n    });\n}\n/**\n * 将注释保存到文件\n * @param comments - 注释数组\n * @param outputPath - 输出文件路径\n * @param sourceFileName - 源文件名\n */\nfunction saveCommentsToFile(comments, outputPath, sourceFileName) {\n    return __awaiter(this, void 0, void 0, function () {\n        var header, commentLines, output;\n        return __generator(this, function (_a) {\n            switch (_a.label) {\n                case 0:\n                    header = \"\\u6E90\\u6587\\u4EF6: \".concat(sourceFileName, \"\\n\\u63D0\\u53D6\\u65F6\\u95F4: \").concat(new Date().toLocaleString(), \"\\n\\u6CE8\\u91CA\\u603B\\u6570: \").concat(comments.length, \"\\n\\n\");\n                    commentLines = comments.map(function (comment) {\n                        var _a, _b;\n                        var type = comment.type === 'CommentLine' ? '单行注释' : '块注释';\n                        var CommentLine = (_b = (_a = comment.loc) === null || _a === void 0 ? void 0 : _a.start) === null || _b === void 0 ? void 0 : _b.line;\n                        return \"[\\u4F4D\\u7F6E: \".concat(comment.start, \"-\").concat(comment.end, \"] [\\u7B2C\").concat(CommentLine, \"\\u884C] [\").concat(type, \"]: \").concat(comment.type === 'CommentLine' ? '//' : '/*').concat(comment.value).concat(comment.type === 'CommentBlock' ? '*/' : '');\n                    });\n                    output = header + commentLines.join('\\n\\n');\n                    return [4 /*yield*/, fs__WEBPACK_IMPORTED_MODULE_0__.writeFileSync(outputPath, output, 'utf-8')];\n                case 1:\n                    _a.sent();\n                    return [2 /*return*/];\n            }\n        });\n    });\n}\n/**\n * 保存注释和代码位置信息到元数据文件\n * @param comments - 注释数组\n * @param metadataPath - 元数据文件路径\n */\nfunction saveCommentsMetadata(comments, metadataPath) {\n    return __awaiter(this, void 0, void 0, function () {\n        var metadata;\n        return __generator(this, function (_a) {\n            switch (_a.label) {\n                case 0:\n                    metadata = {\n                        // extractTime: new Date().toISOString(),\n                        comments: comments.map(function (comment) { return ({\n                            type: comment.type,\n                            value: comment.value,\n                            start: comment.start,\n                            end: comment.end,\n                            loc: comment.loc\n                        }); })\n                    };\n                    return [4 /*yield*/, fs__WEBPACK_IMPORTED_MODULE_0__.writeFileSync(metadataPath, JSON.stringify(metadata, null, 2), 'utf-8')];\n                case 1:\n                    _a.sent();\n                    return [2 /*return*/];\n            }\n        });\n    });\n}\n/**\n * 从元数据文件加载注释信息\n * @param metadataPath - 元数据文件路径\n * @returns 注释数组或null（如果文件不存在）\n */\nfunction loadCommentsMetadata(metadataPath) {\n    return __awaiter(this, void 0, void 0, function () {\n        var metadataContent, metadata, error_2;\n        return __generator(this, function (_a) {\n            switch (_a.label) {\n                case 0:\n                    _a.trys.push([0, 3, , 4]);\n                    return [4 /*yield*/, fs__WEBPACK_IMPORTED_MODULE_0__.existsSync(metadataPath)];\n                case 1:\n                    if (!(_a.sent())) {\n                        return [2 /*return*/, null];\n                    }\n                    return [4 /*yield*/, fs__WEBPACK_IMPORTED_MODULE_0__.readFileSync(metadataPath, 'utf-8')];\n                case 2:\n                    metadataContent = _a.sent();\n                    metadata = JSON.parse(metadataContent);\n                    return [2 /*return*/, metadata.comments];\n                case 3:\n                    error_2 = _a.sent();\n                    console.error(\"\\u52A0\\u8F7D\\u5143\\u6570\\u636E\\u6587\\u4EF6 \".concat(metadataPath, \" \\u65F6\\u51FA\\u9519:\"), error_2.message);\n                    return [2 /*return*/, null];\n                case 4: return [2 /*return*/];\n            }\n        });\n    });\n}\n/**\n * 从源代码中移除注释\n * @param filePath - 源代码文件路径\n * @param comments - 注释数组\n * @returns 移除注释后的代码和相关信息\n */\nfunction removeCommentsFromFile(filePath, comments) {\n    return __awaiter(this, void 0, void 0, function () {\n        var fileContent, validComments, codeWithoutComments, _i, validComments_1, comment, error_3;\n        return __generator(this, function (_a) {\n            switch (_a.label) {\n                case 0:\n                    _a.trys.push([0, 2, , 3]);\n                    return [4 /*yield*/, fs__WEBPACK_IMPORTED_MODULE_0__.readFileSync(filePath, 'utf-8')];\n                case 1:\n                    fileContent = _a.sent();\n                    validComments = comments.filter(function (comment) {\n                        return comment.start !== undefined && comment.end !== undefined;\n                    });\n                    validComments.sort(function (a, b) { var _a, _b; return ((_a = b.start) !== null && _a !== void 0 ? _a : 0) - ((_b = a.start) !== null && _b !== void 0 ? _b : 0); });\n                    codeWithoutComments = fileContent;\n                    for (_i = 0, validComments_1 = validComments; _i < validComments_1.length; _i++) {\n                        comment = validComments_1[_i];\n                        if (comment.start !== undefined && comment.end !== undefined) {\n                            codeWithoutComments = codeWithoutComments.slice(0, comment.start) + codeWithoutComments.slice(comment.end);\n                        }\n                    }\n                    return [2 /*return*/, {\n                            code: codeWithoutComments\n                        }];\n                case 2:\n                    error_3 = _a.sent();\n                    console.error(\"\\u5904\\u7406\\u6587\\u4EF6 \".concat(filePath, \" \\u65F6\\u51FA\\u9519:\"), error_3.message);\n                    return [2 /*return*/, null];\n                case 3: return [2 /*return*/];\n            }\n        });\n    });\n}\n/**\n * 将注释还原到代码中\n * @param codeWithoutComments - 不包含注释的代码\n * @param comments - 注释数组\n * @returns 还原后的完整代码\n */\nfunction restoreCommentsToCode(codeWithoutComments, comments) {\n    if (!comments || comments.length === 0) {\n        return codeWithoutComments;\n    }\n    // 过滤掉start为undefined的注释，然后按位置升序排列\n    var validComments = comments.filter(function (comment) { return comment.start !== undefined; });\n    var sortedComments = __spreadArray([], validComments, true).sort(function (a, b) { var _a, _b; return ((_a = a.start) !== null && _a !== void 0 ? _a : 0) - ((_b = b.start) !== null && _b !== void 0 ? _b : 0); });\n    var restoredCode = codeWithoutComments;\n    for (var i = 0; i < sortedComments.length; i++) {\n        var comment = sortedComments[i];\n        if (comment.start === undefined)\n            continue;\n        var commentText = comment.type === 'CommentLine'\n            ? '//' + comment.value\n            : '/*' + comment.value + '*/';\n        // 在指定位置插入注释\n        restoredCode = restoredCode.slice(0, comment.start) + commentText + restoredCode.slice(comment.start);\n    }\n    return restoredCode;\n}\n/**\n * 主函数：提取指定文件的注释并保存到另一文件，然后从源文件中删除注释\n * @param sourcePath - 源文件路径\n * @param commentsOutputPath - 注释输出文件路径\n * @param metadataPath - 元数据文件路径\n * @param options - 提取选项\n */\nfunction extractCommentsToFile(sourcePath, commentsOutputPath, metadataPath, options) {\n    return __awaiter(this, void 0, void 0, function () {\n        var _a, comments, originalContent, result, restoredCode, error_4;\n        return __generator(this, function (_b) {\n            switch (_b.label) {\n                case 0:\n                    _b.trys.push([0, 8, , 9]);\n                    return [4 /*yield*/, extractComments(sourcePath, options)];\n                case 1:\n                    _a = _b.sent(), comments = _a.comments, originalContent = _a.originalContent;\n                    if (!(comments.length > 0)) return [3 /*break*/, 7];\n                    // 保存注释到文件\n                    return [4 /*yield*/, saveCommentsToFile(comments, commentsOutputPath, path__WEBPACK_IMPORTED_MODULE_1__.basename(sourcePath))];\n                case 2:\n                    // 保存注释到文件\n                    _b.sent();\n                    // 保存注释元数据\n                    return [4 /*yield*/, saveCommentsMetadata(comments, metadataPath)];\n                case 3:\n                    // 保存注释元数据\n                    _b.sent();\n                    return [4 /*yield*/, removeCommentsFromFile(sourcePath, comments)];\n                case 4:\n                    result = _b.sent();\n                    if (!(result !== null)) return [3 /*break*/, 6];\n                    return [4 /*yield*/, fs__WEBPACK_IMPORTED_MODULE_0__.writeFileSync(commentsOutputPath, result.code, 'utf-8')];\n                case 5:\n                    _b.sent();\n                    restoredCode = restoreCommentsToCode(result.code, comments);\n                    if (restoredCode === originalContent) {\n                        // console.log('验证成功：代码可以完美还原');\n                    }\n                    else {\n                        // console.log('警告：还原的代码与原始代码不完全一致');\n                    }\n                    _b.label = 6;\n                case 6: return [3 /*break*/, 7];\n                case 7: return [3 /*break*/, 9];\n                case 8:\n                    error_4 = _b.sent();\n                    console.error('提取注释时出错:', error_4.message);\n                    return [3 /*break*/, 9];\n                case 9: return [2 /*return*/];\n            }\n        });\n    });\n}\n/**\n * 还原代码文件（将注释加回到无注释的代码中）\n * @param codePath - 无注释的代码文件路径\n * @param metadataPath - 元数据文件路径\n * @param outputPath - 还原后的代码输出路径\n */\nfunction restoreCodeFromFile(codePath, metadataPath, outputPath) {\n    return __awaiter(this, void 0, void 0, function () {\n        var comments, codeWithoutComments, restoredCode, error_5;\n        return __generator(this, function (_a) {\n            switch (_a.label) {\n                case 0:\n                    _a.trys.push([0, 4, , 5]);\n                    return [4 /*yield*/, loadCommentsMetadata(metadataPath)];\n                case 1:\n                    comments = _a.sent();\n                    if (!comments) {\n                        console.error('无法加载注释元数据');\n                        return [2 /*return*/];\n                    }\n                    return [4 /*yield*/, fs__WEBPACK_IMPORTED_MODULE_0__.readFileSync(codePath, 'utf-8')];\n                case 2:\n                    codeWithoutComments = _a.sent();\n                    restoredCode = restoreCommentsToCode(codeWithoutComments, comments);\n                    // 保存还原后的代码\n                    return [4 /*yield*/, fs__WEBPACK_IMPORTED_MODULE_0__.writeFileSync(outputPath, restoredCode, 'utf-8')];\n                case 3:\n                    // 保存还原后的代码\n                    _a.sent();\n                    return [3 /*break*/, 5];\n                case 4:\n                    error_5 = _a.sent();\n                    console.error('还原代码时出错:', error_5.message);\n                    return [3 /*break*/, 5];\n                case 5: return [2 /*return*/];\n            }\n        });\n    });\n}\n// 按模块导出方便外部调用\nvar nodeBabelUtils = {\n    extractCommentsToFile: extractCommentsToFile,\n    restoreCodeFromFile: restoreCodeFromFile\n};\n\n\n//# sourceURL=webpack://easyutilssdk/./node/babel.ts?\n}");
+
+/***/ }),
+
+/***/ "./node/excel.ts":
+/*!***********************!*\
+  !*** ./node/excel.ts ***!
+  \***********************/
+/***/ ((__unused_webpack_module, __webpack_exports__, __webpack_require__) => {
+
+eval("{__webpack_require__.r(__webpack_exports__);\n/* harmony export */ __webpack_require__.d(__webpack_exports__, {\n/* harmony export */   excelToJson: () => (/* binding */ excelToJson),\n/* harmony export */   excelToJsonFile: () => (/* binding */ excelToJsonFile),\n/* harmony export */   nodeExcelUtils: () => (/* binding */ nodeExcelUtils)\n/* harmony export */ });\n/* harmony import */ var xlsx__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! xlsx */ \"xlsx\");\n/* harmony import */ var xlsx__WEBPACK_IMPORTED_MODULE_0___default = /*#__PURE__*/__webpack_require__.n(xlsx__WEBPACK_IMPORTED_MODULE_0__);\n/* harmony import */ var fs__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(/*! fs */ \"fs\");\n/* harmony import */ var fs__WEBPACK_IMPORTED_MODULE_1___default = /*#__PURE__*/__webpack_require__.n(fs__WEBPACK_IMPORTED_MODULE_1__);\n/* harmony import */ var path__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(/*! path */ \"path\");\n/* harmony import */ var path__WEBPACK_IMPORTED_MODULE_2___default = /*#__PURE__*/__webpack_require__.n(path__WEBPACK_IMPORTED_MODULE_2__);\n/**\n * @module nodeExcel\n * @description Excel 文件处理工具模块，提供 Excel 与 JSON 格式相互转换的功能\n */\n\n\n\n/**\n * 将Excel文件转换为JSON数据\n * @param filePath - Excel文件路径\n * @param sheetName - 工作表名称（可选，默认为第一个工作表）\n * @returns JSON数据数组\n */\nvar excelToJson = function (filePath, sheetName) {\n    // 检查文件是否存在\n    if (!fs__WEBPACK_IMPORTED_MODULE_1__.existsSync(filePath)) {\n        throw new Error(\"File \\\"\".concat(filePath, \"\\\" not found\"));\n    }\n    // 读取Excel文件\n    var workbook = (0,xlsx__WEBPACK_IMPORTED_MODULE_0__.readFile)(filePath);\n    // 获取工作表名称\n    var firstSheetName = workbook.SheetNames[0];\n    var targetSheetName = sheetName || firstSheetName;\n    // 检查指定的工作表是否存在\n    if (!workbook.SheetNames.includes(targetSheetName)) {\n        throw new Error(\"Sheet \\\"\".concat(targetSheetName, \"\\\" not found in the workbook\"));\n    }\n    // 获取工作表\n    var worksheet = workbook.Sheets[targetSheetName];\n    // 将工作表转换为JSON\n    var jsonData = xlsx__WEBPACK_IMPORTED_MODULE_0__.utils.sheet_to_json(worksheet);\n    return jsonData;\n};\n/**\n * 将Excel文件转换为JSON并保存到文件\n * @param excelPath - Excel文件路径\n * @param jsonPath - 输出JSON文件路径（可选，默认与Excel同名但扩展名为.json）\n * @param sheetName - 工作表名称（可选，默认为第一个工作表）\n */\nvar excelToJsonFile = function (excelPath, jsonPath, sheetName) {\n    try {\n        // 转换Excel为JSON数据\n        var jsonData = excelToJson(excelPath, sheetName);\n        // 确定输出文件路径\n        var outputPath = jsonPath || excelPath.replace(path__WEBPACK_IMPORTED_MODULE_2__.extname(excelPath), '.json');\n        // 写入JSON文件\n        fs__WEBPACK_IMPORTED_MODULE_1__.writeFileSync(outputPath, JSON.stringify(jsonData, null, 2));\n        console.log(\"Successfully converted \\\"\".concat(excelPath, \"\\\" to \\\"\").concat(outputPath, \"\\\"\"));\n    }\n    catch (error) {\n        console.error('Error converting Excel to JSON:', error);\n        throw error;\n    }\n};\n// 按模块导出方便外部调用\nvar nodeExcelUtils = {\n    excelToJson: excelToJson,\n    excelToJsonFile: excelToJsonFile,\n};\n\n\n//# sourceURL=webpack://easyutilssdk/./node/excel.ts?\n}");
+
+/***/ }),
+
 /***/ "./node/fs.ts":
 /*!********************!*\
   !*** ./node/fs.ts ***!
   \********************/
 /***/ ((__unused_webpack_module, __webpack_exports__, __webpack_require__) => {
 
-eval("__webpack_require__.r(__webpack_exports__);\n/* harmony export */ __webpack_require__.d(__webpack_exports__, {\n/* harmony export */   copyFolderSync: () => (/* binding */ copyFolderSync),\n/* harmony export */   \"default\": () => (__WEBPACK_DEFAULT_EXPORT__),\n/* harmony export */   loopFolderSync: () => (/* binding */ loopFolderSync),\n/* harmony export */   readFileToJSONSync: () => (/* binding */ readFileToJSONSync)\n/* harmony export */ });\n/* harmony import */ var fs__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! fs */ \"fs\");\n/* harmony import */ var fs__WEBPACK_IMPORTED_MODULE_0___default = /*#__PURE__*/__webpack_require__.n(fs__WEBPACK_IMPORTED_MODULE_0__);\n/* harmony import */ var path__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(/*! path */ \"path\");\n/* harmony import */ var path__WEBPACK_IMPORTED_MODULE_1___default = /*#__PURE__*/__webpack_require__.n(path__WEBPACK_IMPORTED_MODULE_1__);\n\n\n/**\n   * 读取文件并转换为JSON\n   * @param filePath 文件路径\n   * @returns 转换之后的JSON对象\n   */\nvar readFileToJSONSync = function (filePath) {\n    try {\n        var fileStr = fs__WEBPACK_IMPORTED_MODULE_0__.readFileSync(filePath, 'utf8');\n        return JSON.parse(fileStr);\n    }\n    catch (error) {\n        console.error(\"Failed to read or parse setting file \".concat(filePath, \":\"), error);\n        return {};\n    }\n};\n/**\n   * 拷贝文件夹至目标目录\n   * @param source 源文件夹\n   * @param target 目标文件夹\n   */\nvar copyFolderSync = function (source, target) {\n    if (!fs__WEBPACK_IMPORTED_MODULE_0__.existsSync(target)) {\n        fs__WEBPACK_IMPORTED_MODULE_0__.mkdirSync(target);\n    }\n    var files = fs__WEBPACK_IMPORTED_MODULE_0__.readdirSync(source);\n    for (var _i = 0, files_1 = files; _i < files_1.length; _i++) {\n        var file = files_1[_i];\n        var sourcePath = path__WEBPACK_IMPORTED_MODULE_1__.join(source, file);\n        var targetPath = path__WEBPACK_IMPORTED_MODULE_1__.join(target, file);\n        if (fs__WEBPACK_IMPORTED_MODULE_0__.lstatSync(sourcePath).isDirectory()) {\n            copyFolderSync(sourcePath, targetPath);\n        }\n        else {\n            fs__WEBPACK_IMPORTED_MODULE_0__.copyFileSync(sourcePath, targetPath);\n        }\n    }\n};\n/**\n   * 递归遍历文件夹执行特定回调\n   * @param folderPath 文件夹路径\n   * @param callBack 回调方法\n   */\nvar loopFolderSync = function (folderPath, callBack) {\n    if (!fs__WEBPACK_IMPORTED_MODULE_0__.existsSync(folderPath)) {\n        return;\n    }\n    fs__WEBPACK_IMPORTED_MODULE_0__.readdirSync(folderPath).forEach(function (file, index) {\n        var curPath = path__WEBPACK_IMPORTED_MODULE_1__.join(folderPath, file);\n        var isDirectory = fs__WEBPACK_IMPORTED_MODULE_0__.lstatSync(curPath).isDirectory();\n        if (isDirectory) {\n            loopFolderSync(curPath, callBack);\n        }\n        callBack(curPath, isDirectory, index);\n    });\n};\nvar fsUtils = {\n    readFileToJSONSync: readFileToJSONSync,\n    copyFolderSync: copyFolderSync,\n    loopFolderSync: loopFolderSync\n};\n/* harmony default export */ const __WEBPACK_DEFAULT_EXPORT__ = (fsUtils);\n\n\n//# sourceURL=webpack://easyutilssdk/./node/fs.ts?");
+eval("{__webpack_require__.r(__webpack_exports__);\n/* harmony export */ __webpack_require__.d(__webpack_exports__, {\n/* harmony export */   copyFolderSync: () => (/* binding */ copyFolderSync),\n/* harmony export */   loopFolderSync: () => (/* binding */ loopFolderSync),\n/* harmony export */   nodeFsUtils: () => (/* binding */ nodeFsUtils),\n/* harmony export */   readFileToJSONSync: () => (/* binding */ readFileToJSONSync)\n/* harmony export */ });\n/* harmony import */ var fs__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! fs */ \"fs\");\n/* harmony import */ var fs__WEBPACK_IMPORTED_MODULE_0___default = /*#__PURE__*/__webpack_require__.n(fs__WEBPACK_IMPORTED_MODULE_0__);\n/* harmony import */ var path__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(/*! path */ \"path\");\n/* harmony import */ var path__WEBPACK_IMPORTED_MODULE_1___default = /*#__PURE__*/__webpack_require__.n(path__WEBPACK_IMPORTED_MODULE_1__);\n/**\n * @module nodeFs\n * @description 文件系统工具模块，提供文件和文件夹操作的实用方法\n */\n\n\n/**\n * 读取文件并转换为JSON，仅执行JSON.parse\n * @param filePath - 文件路径\n * @returns 转换之后的JSON对象\n */\nvar readFileToJSONSync = function (filePath) {\n    try {\n        var fileStr = fs__WEBPACK_IMPORTED_MODULE_0__.readFileSync(filePath, 'utf8');\n        return JSON.parse(fileStr);\n    }\n    catch (error) {\n        console.error(\"Failed to read or parse setting file \".concat(filePath, \":\"), error);\n        return {};\n    }\n};\n/**\n * 拷贝文件夹下所有文件至目标目录\n * todo 增加控制是否覆盖\n * @param source - 源文件夹\n * @param target - 目标文件夹\n */\nvar copyFolderSync = function (source, target) {\n    if (!fs__WEBPACK_IMPORTED_MODULE_0__.existsSync(target)) {\n        fs__WEBPACK_IMPORTED_MODULE_0__.mkdirSync(target);\n    }\n    var files = fs__WEBPACK_IMPORTED_MODULE_0__.readdirSync(source);\n    for (var _i = 0, files_1 = files; _i < files_1.length; _i++) {\n        var file = files_1[_i];\n        var sourcePath = path__WEBPACK_IMPORTED_MODULE_1__.join(source, file);\n        var targetPath = path__WEBPACK_IMPORTED_MODULE_1__.join(target, file);\n        if (fs__WEBPACK_IMPORTED_MODULE_0__.lstatSync(sourcePath).isDirectory()) {\n            copyFolderSync(sourcePath, targetPath);\n        }\n        else {\n            fs__WEBPACK_IMPORTED_MODULE_0__.copyFileSync(sourcePath, targetPath);\n        }\n    }\n};\n/**\n * 递归遍历文件夹执行特定回调\n * @param folderPath - 文件夹路径\n * @param callBack - 回调方法\n */\nvar loopFolderSync = function (folderPath, callBack) {\n    if (!fs__WEBPACK_IMPORTED_MODULE_0__.existsSync(folderPath)) {\n        return;\n    }\n    fs__WEBPACK_IMPORTED_MODULE_0__.readdirSync(folderPath).forEach(function (file, index) {\n        var curPath = path__WEBPACK_IMPORTED_MODULE_1__.join(folderPath, file);\n        var isDirectory = fs__WEBPACK_IMPORTED_MODULE_0__.lstatSync(curPath).isDirectory();\n        if (isDirectory) {\n            loopFolderSync(curPath, callBack);\n        }\n        callBack(curPath, isDirectory, index);\n    });\n};\n// 按模块导出方便外部调用\nvar nodeFsUtils = {\n    readFileToJSONSync: readFileToJSONSync,\n    copyFolderSync: copyFolderSync,\n    loopFolderSync: loopFolderSync\n};\n\n\n//# sourceURL=webpack://easyutilssdk/./node/fs.ts?\n}");
 
 /***/ }),
 
@@ -33,7 +53,17 @@ eval("__webpack_require__.r(__webpack_exports__);\n/* harmony export */ __webpac
   \***********************/
 /***/ ((__unused_webpack_module, __webpack_exports__, __webpack_require__) => {
 
-eval("__webpack_require__.r(__webpack_exports__);\n/* harmony export */ __webpack_require__.d(__webpack_exports__, {\n/* harmony export */   \"default\": () => (__WEBPACK_DEFAULT_EXPORT__)\n/* harmony export */ });\n/* harmony import */ var _fs__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ./fs */ \"./node/fs.ts\");\n/* harmony import */ var _src_index__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(/*! ../src/index */ \"./src/index.ts\");\nvar __assign = (undefined && undefined.__assign) || function () {\n    __assign = Object.assign || function(t) {\n        for (var s, i = 1, n = arguments.length; i < n; i++) {\n            s = arguments[i];\n            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))\n                t[p] = s[p];\n        }\n        return t;\n    };\n    return __assign.apply(this, arguments);\n};\n// 使用命名导出替代默认导出\n\n\n/* harmony default export */ const __WEBPACK_DEFAULT_EXPORT__ = (__assign(__assign({}, _src_index__WEBPACK_IMPORTED_MODULE_1__[\"default\"]), { fs: _fs__WEBPACK_IMPORTED_MODULE_0__[\"default\"] }));\n\n\n//# sourceURL=webpack://easyutilssdk/./node/index.ts?");
+eval("{__webpack_require__.r(__webpack_exports__);\n/* harmony export */ __webpack_require__.d(__webpack_exports__, {\n/* harmony export */   commonUtils: () => (/* reexport safe */ _src_index__WEBPACK_IMPORTED_MODULE_3__.commonUtils),\n/* harmony export */   copyFolderSync: () => (/* reexport safe */ _fs__WEBPACK_IMPORTED_MODULE_0__.copyFolderSync),\n/* harmony export */   delay: () => (/* reexport safe */ _src_index__WEBPACK_IMPORTED_MODULE_3__.delay),\n/* harmony export */   excelToJson: () => (/* reexport safe */ _excel__WEBPACK_IMPORTED_MODULE_2__.excelToJson),\n/* harmony export */   excelToJsonFile: () => (/* reexport safe */ _excel__WEBPACK_IMPORTED_MODULE_2__.excelToJsonFile),\n/* harmony export */   extractCommentsToFile: () => (/* reexport safe */ _babel__WEBPACK_IMPORTED_MODULE_1__.extractCommentsToFile),\n/* harmony export */   jsonUtils: () => (/* reexport safe */ _src_index__WEBPACK_IMPORTED_MODULE_3__.jsonUtils),\n/* harmony export */   loopFolderSync: () => (/* reexport safe */ _fs__WEBPACK_IMPORTED_MODULE_0__.loopFolderSync),\n/* harmony export */   nodeBabelUtils: () => (/* reexport safe */ _babel__WEBPACK_IMPORTED_MODULE_1__.nodeBabelUtils),\n/* harmony export */   nodeExcelUtils: () => (/* reexport safe */ _excel__WEBPACK_IMPORTED_MODULE_2__.nodeExcelUtils),\n/* harmony export */   nodeFsUtils: () => (/* reexport safe */ _fs__WEBPACK_IMPORTED_MODULE_0__.nodeFsUtils),\n/* harmony export */   readFileToJSONSync: () => (/* reexport safe */ _fs__WEBPACK_IMPORTED_MODULE_0__.readFileToJSONSync),\n/* harmony export */   restoreCodeFromFile: () => (/* reexport safe */ _babel__WEBPACK_IMPORTED_MODULE_1__.restoreCodeFromFile),\n/* harmony export */   sortJsonByKeys: () => (/* reexport safe */ _src_index__WEBPACK_IMPORTED_MODULE_3__.sortJsonByKeys),\n/* harmony export */   sortJsonStringByKeys: () => (/* reexport safe */ _src_index__WEBPACK_IMPORTED_MODULE_3__.sortJsonStringByKeys)\n/* harmony export */ });\n/* harmony import */ var _fs__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ./fs */ \"./node/fs.ts\");\n/* harmony import */ var _babel__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(/*! ./babel */ \"./node/babel.ts\");\n/* harmony import */ var _excel__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(/*! ./excel */ \"./node/excel.ts\");\n/* harmony import */ var _src_index__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(/*! ../src/index */ \"./src/index.ts\");\n// // 使用命名导出替代默认导出\n// import fsUtils from './fs';\n// import babelUtils from './babel';\n// import excelUtils from './excel';\n// // 如果需要导出类型，可以单独导出\n// export type { LoopFolderCallback } from './fs';\n// export type { extractCommentsToFileOptions } from './babel';\n// import webUtils from '../src/index';\n// // 将默认导出改为命名导出，这样TypeDoc能更好地识别和生成文档\n// export const common = webUtils.common;\n// export const json = webUtils.json;\n// export const fs = fsUtils;\n// export const babel = babelUtils;\n// export const excel = excelUtils;\n// // 保留默认导出以保持向后兼容性\n// const easyUtilsSdk = {\n//   ...webUtils,\n//   fs: fsUtils,\n//   babel: babelUtils,\n//   excel: excelUtils,\n// };\n// export default easyUtilsSdk;\n\n\n\n\n\n\n//# sourceURL=webpack://easyutilssdk/./node/index.ts?\n}");
+
+/***/ }),
+
+/***/ "./src/common.ts":
+/*!***********************!*\
+  !*** ./src/common.ts ***!
+  \***********************/
+/***/ ((__unused_webpack_module, __webpack_exports__, __webpack_require__) => {
+
+eval("{__webpack_require__.r(__webpack_exports__);\n/* harmony export */ __webpack_require__.d(__webpack_exports__, {\n/* harmony export */   commonUtils: () => (/* binding */ commonUtils),\n/* harmony export */   delay: () => (/* binding */ delay)\n/* harmony export */ });\n/**\n * @module common\n * @description 通用工具类\n */\n/**\n * async await 延迟几秒\n * @param seconds - 秒数\n * @returns\n */\nvar delay = function (seconds) {\n    return new Promise(function (resolve) {\n        setTimeout(function () {\n            resolve();\n        }, seconds * 1000);\n    });\n};\nvar commonUtils = {\n    delay: delay\n};\n\n\n//# sourceURL=webpack://easyutilssdk/./src/common.ts?\n}");
 
 /***/ }),
 
@@ -43,7 +73,7 @@ eval("__webpack_require__.r(__webpack_exports__);\n/* harmony export */ __webpac
   \**********************/
 /***/ ((__unused_webpack_module, __webpack_exports__, __webpack_require__) => {
 
-eval("__webpack_require__.r(__webpack_exports__);\n/* harmony export */ __webpack_require__.d(__webpack_exports__, {\n/* harmony export */   \"default\": () => (__WEBPACK_DEFAULT_EXPORT__)\n/* harmony export */ });\n/* harmony import */ var _json__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ./json */ \"./src/json.ts\");\n// 使用命名导出替代默认导出\n\nvar easyutilssdk = {\n    json: _json__WEBPACK_IMPORTED_MODULE_0__[\"default\"],\n};\n/* harmony default export */ const __WEBPACK_DEFAULT_EXPORT__ = (easyutilssdk);\n\n\n//# sourceURL=webpack://easyutilssdk/./src/index.ts?");
+eval("{__webpack_require__.r(__webpack_exports__);\n/* harmony export */ __webpack_require__.d(__webpack_exports__, {\n/* harmony export */   commonUtils: () => (/* reexport safe */ _common__WEBPACK_IMPORTED_MODULE_0__.commonUtils),\n/* harmony export */   delay: () => (/* reexport safe */ _common__WEBPACK_IMPORTED_MODULE_0__.delay),\n/* harmony export */   jsonUtils: () => (/* reexport safe */ _json__WEBPACK_IMPORTED_MODULE_1__.jsonUtils),\n/* harmony export */   sortJsonByKeys: () => (/* reexport safe */ _json__WEBPACK_IMPORTED_MODULE_1__.sortJsonByKeys),\n/* harmony export */   sortJsonStringByKeys: () => (/* reexport safe */ _json__WEBPACK_IMPORTED_MODULE_1__.sortJsonStringByKeys)\n/* harmony export */ });\n/* harmony import */ var _common__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ./common */ \"./src/common.ts\");\n/* harmony import */ var _json__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(/*! ./json */ \"./src/json.ts\");\n// // 使用命名导出替代默认导出\n// import commonUtils from './common';\n// import jsonUtils from './json';\n// // import fileUtils from './file';\n// // 如果需要导出类型，可以单独导出\n// export type { SortOptions } from './json';\n// const easyutilssdk = {\n//   common: commonUtils,\n//   json: jsonUtils,\n//   // fileFe: fileUtils\n// };\n// export default easyutilssdk\n\n\n\n\n//# sourceURL=webpack://easyutilssdk/./src/index.ts?\n}");
 
 /***/ }),
 
@@ -53,7 +83,17 @@ eval("__webpack_require__.r(__webpack_exports__);\n/* harmony export */ __webpac
   \*********************/
 /***/ ((__unused_webpack_module, __webpack_exports__, __webpack_require__) => {
 
-eval("__webpack_require__.r(__webpack_exports__);\n/* harmony export */ __webpack_require__.d(__webpack_exports__, {\n/* harmony export */   \"default\": () => (__WEBPACK_DEFAULT_EXPORT__)\n/* harmony export */ });\n/**\n * 对JSON对象按照key进行升序或者降序排序\n * @param obj JSON对象\n * @param SortOptions 排序参数：sortType为排序方式，asc升序，desc降序，默认asc\n * @returns 排序之后的JSON对象\n */\nvar sortObjectKeys = function (obj, _a) {\n    var _b = _a === void 0 ? {} : _a, _c = _b.sortType, sortType = _c === void 0 ? 'asc' : _c;\n    if (typeof obj !== 'object' || obj === null) {\n        return obj;\n    }\n    if (Array.isArray(obj)) {\n        return obj.map(function (item) { return sortObjectKeys(item, { sortType: sortType }); });\n    }\n    return Object.keys(obj)\n        .sort(function (a, b) {\n        var res = sortType === 'desc'\n            ? b.toLowerCase().localeCompare(a.toLowerCase())\n            : a.toLowerCase().localeCompare(b.toLowerCase());\n        return res;\n    })\n        .reduce(function (acc, key) {\n        acc[key] = sortObjectKeys(obj[key], { sortType: sortType });\n        return acc;\n    }, {});\n};\n/**\n * 将JSON字符串格式化并按照key进行排序\n * @param jsonString 原始JSON字符串\n * @param SortOptions 排序参数：sortType为排序方式，asc升序，desc降序，默认asc\n * @returns 格式化之后的JSON字符串\n */\nvar sortJson = function (jsonString, _a) {\n    var _b = _a === void 0 ? {} : _a, _c = _b.sortType, sortType = _c === void 0 ? 'asc' : _c;\n    try {\n        var parsed = JSON.parse(jsonString);\n        var sortedParsed = sortObjectKeys(parsed, { sortType: sortType });\n        return JSON.stringify(sortedParsed, null, 2);\n    }\n    catch (e) {\n        console.error('Failed to parse JSON string:', e);\n        return jsonString; // Return original string if parsing fails\n    }\n};\nvar jsonUtils = {\n    sortObjectKeys: sortObjectKeys,\n    sortJson: sortJson\n};\n/* harmony default export */ const __WEBPACK_DEFAULT_EXPORT__ = (jsonUtils);\n\n\n//# sourceURL=webpack://easyutilssdk/./src/json.ts?");
+eval("{__webpack_require__.r(__webpack_exports__);\n/* harmony export */ __webpack_require__.d(__webpack_exports__, {\n/* harmony export */   jsonUtils: () => (/* binding */ jsonUtils),\n/* harmony export */   sortJsonByKeys: () => (/* binding */ sortJsonByKeys),\n/* harmony export */   sortJsonStringByKeys: () => (/* binding */ sortJsonStringByKeys)\n/* harmony export */ });\n/**\n * @module json\n * @description json对象相关工具类\n */\n/**\n * 对JSON对象按照key进行升序或者降序排序\n * @param obj JSON对象\n * @param SortOptions 排序参数：sortType为排序方式，asc升序，desc降序，默认asc\n * @returns 排序之后的JSON对象\n */\nvar sortJsonByKeys = function (obj, _a) {\n    var _b = _a === void 0 ? {} : _a, _c = _b.sortType, sortType = _c === void 0 ? 'asc' : _c;\n    if (typeof obj !== 'object' || obj === null) {\n        return obj;\n    }\n    if (Array.isArray(obj)) {\n        return obj.map(function (item) { return sortJsonByKeys(item, { sortType: sortType }); });\n    }\n    return Object.keys(obj)\n        .sort(function (a, b) {\n        var res = sortType === 'desc'\n            ? b.toLowerCase().localeCompare(a.toLowerCase())\n            : a.toLowerCase().localeCompare(b.toLowerCase());\n        return res;\n    })\n        .reduce(function (acc, key) {\n        acc[key] = sortJsonByKeys(obj[key], { sortType: sortType });\n        return acc;\n    }, {});\n};\n/**\n * 将JSON字符串格式化并按照key进行排序\n * @param jsonString 原始JSON字符串\n * @param SortOptions 排序参数：sortType为排序方式，asc升序，desc降序，默认asc\n * @returns 格式化之后的JSON字符串\n */\nvar sortJsonStringByKeys = function (jsonString, _a) {\n    var _b = _a === void 0 ? {} : _a, _c = _b.sortType, sortType = _c === void 0 ? 'asc' : _c;\n    try {\n        var parsed = JSON.parse(jsonString);\n        var sortedParsed = sortJsonByKeys(parsed, { sortType: sortType });\n        return JSON.stringify(sortedParsed, null, 2);\n    }\n    catch (e) {\n        console.error('Failed to parse JSON string:', e);\n        return jsonString; // Return original string if parsing fails\n    }\n};\nvar jsonUtils = {\n    sortJsonByKeys: sortJsonByKeys,\n    sortJsonStringByKeys: sortJsonStringByKeys\n};\n\n\n//# sourceURL=webpack://easyutilssdk/./src/json.ts?\n}");
+
+/***/ }),
+
+/***/ "@babel/parser":
+/*!********************************!*\
+  !*** external "@babel/parser" ***!
+  \********************************/
+/***/ ((module) => {
+
+module.exports = require("@babel/parser");
 
 /***/ }),
 
@@ -75,6 +115,16 @@ module.exports = require("fs");
 
 module.exports = require("path");
 
+/***/ }),
+
+/***/ "xlsx":
+/*!***********************!*\
+  !*** external "xlsx" ***!
+  \***********************/
+/***/ ((module) => {
+
+module.exports = require("xlsx");
+
 /***/ })
 
 /******/ 	});

package/dist/png.d.ts

@@ -0,0 +1,17 @@
+import JSZip from "jszip";
+export interface pngCompareResult {
+    diffNum: number;
+    oldImageElement: HTMLImageElement;
+    newImageElement: HTMLImageElement;
+    diffImageData: HTMLImageElement;
+}
+declare const fileUtils: {
+    zipUpdateToFiles: (e: any) => Promise<any>;
+    htmlToPngUrl: (dom: HTMLElement) => Promise<string>;
+    htmlToPngDownLoad: (dom: HTMLElement, fileName: string) => Promise<void>;
+    htmlToPngAddToZip: (dom: HTMLElement, fileName: string, zipObj: JSZip) => Promise<void>;
+    downLoadZip: (zipObj: JSZip, fileName: string) => Promise<void>;
+    comparePng: (leftFile: File, rightFile: File) => Promise<pngCompareResult>;
+    comparePngUrl: (leftPngUrl: string, rightPngUrl: string) => Promise<pngCompareResult>;
+};
+export default fileUtils;

package/dist/web/index.js

@@ -1,8 +1,8 @@
 /**
      *   版本信息
      *   realBranch(真实分支): dev
-     *   buildTime(打包时间): 2025/6/13 14:03:58
-     *   commitId(最后一条提交SHA): cf6388cbd07d30888bee6f48775ceab6d99ae7da
+     *   buildTime(打包时间): 2025/12/30 17:02:31
+     *   commitId(最后一条提交SHA): c774ff55af1a47a8b14369f4a6f3a781e1bd4245
      */
 
 /*
@@ -15,13 +15,23 @@
  */
 /******/ var __webpack_modules__ = ({
 
+/***/ "./src/common.ts":
+/*!***********************!*\
+  !*** ./src/common.ts ***!
+  \***********************/
+/***/ ((__unused_webpack_module, __webpack_exports__, __webpack_require__) => {
+
+eval("{__webpack_require__.r(__webpack_exports__);\n/* harmony export */ __webpack_require__.d(__webpack_exports__, {\n/* harmony export */   commonUtils: () => (/* binding */ commonUtils),\n/* harmony export */   delay: () => (/* binding */ delay)\n/* harmony export */ });\n/**\n * @module common\n * @description 通用工具类\n */\n/**\n * async await 延迟几秒\n * @param seconds - 秒数\n * @returns\n */\nvar delay = function (seconds) {\n    return new Promise(function (resolve) {\n        setTimeout(function () {\n            resolve();\n        }, seconds * 1000);\n    });\n};\nvar commonUtils = {\n    delay: delay\n};\n\n\n//# sourceURL=webpack://easyutilssdk/./src/common.ts?\n}");
+
+/***/ }),
+
 /***/ "./src/index.ts":
 /*!**********************!*\
   !*** ./src/index.ts ***!
   \**********************/
 /***/ ((__unused_webpack_module, __webpack_exports__, __webpack_require__) => {
 
-eval("__webpack_require__.r(__webpack_exports__);\n/* harmony export */ __webpack_require__.d(__webpack_exports__, {\n/* harmony export */   \"default\": () => (__WEBPACK_DEFAULT_EXPORT__)\n/* harmony export */ });\n/* harmony import */ var _json__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ./json */ \"./src/json.ts\");\n// 使用命名导出替代默认导出\n\nvar easyutilssdk = {\n    json: _json__WEBPACK_IMPORTED_MODULE_0__[\"default\"],\n};\n/* harmony default export */ const __WEBPACK_DEFAULT_EXPORT__ = (easyutilssdk);\n\n\n//# sourceURL=webpack://easyutilssdk/./src/index.ts?");
+eval("{__webpack_require__.r(__webpack_exports__);\n/* harmony export */ __webpack_require__.d(__webpack_exports__, {\n/* harmony export */   commonUtils: () => (/* reexport safe */ _common__WEBPACK_IMPORTED_MODULE_0__.commonUtils),\n/* harmony export */   delay: () => (/* reexport safe */ _common__WEBPACK_IMPORTED_MODULE_0__.delay),\n/* harmony export */   jsonUtils: () => (/* reexport safe */ _json__WEBPACK_IMPORTED_MODULE_1__.jsonUtils),\n/* harmony export */   sortJsonByKeys: () => (/* reexport safe */ _json__WEBPACK_IMPORTED_MODULE_1__.sortJsonByKeys),\n/* harmony export */   sortJsonStringByKeys: () => (/* reexport safe */ _json__WEBPACK_IMPORTED_MODULE_1__.sortJsonStringByKeys)\n/* harmony export */ });\n/* harmony import */ var _common__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ./common */ \"./src/common.ts\");\n/* harmony import */ var _json__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(/*! ./json */ \"./src/json.ts\");\n// // 使用命名导出替代默认导出\n// import commonUtils from './common';\n// import jsonUtils from './json';\n// // import fileUtils from './file';\n// // 如果需要导出类型，可以单独导出\n// export type { SortOptions } from './json';\n// const easyutilssdk = {\n//   common: commonUtils,\n//   json: jsonUtils,\n//   // fileFe: fileUtils\n// };\n// export default easyutilssdk\n\n\n\n\n//# sourceURL=webpack://easyutilssdk/./src/index.ts?\n}");
 
 /***/ }),
 
@@ -31,7 +41,7 @@ eval("__webpack_require__.r(__webpack_exports__);\n/* harmony export */ __webpac
   \*********************/
 /***/ ((__unused_webpack_module, __webpack_exports__, __webpack_require__) => {
 
-eval("__webpack_require__.r(__webpack_exports__);\n/* harmony export */ __webpack_require__.d(__webpack_exports__, {\n/* harmony export */   \"default\": () => (__WEBPACK_DEFAULT_EXPORT__)\n/* harmony export */ });\n/**\n * 对JSON对象按照key进行升序或者降序排序\n * @param obj JSON对象\n * @param SortOptions 排序参数：sortType为排序方式，asc升序，desc降序，默认asc\n * @returns 排序之后的JSON对象\n */\nvar sortObjectKeys = function (obj, _a) {\n    var _b = _a === void 0 ? {} : _a, _c = _b.sortType, sortType = _c === void 0 ? 'asc' : _c;\n    if (typeof obj !== 'object' || obj === null) {\n        return obj;\n    }\n    if (Array.isArray(obj)) {\n        return obj.map(function (item) { return sortObjectKeys(item, { sortType: sortType }); });\n    }\n    return Object.keys(obj)\n        .sort(function (a, b) {\n        var res = sortType === 'desc'\n            ? b.toLowerCase().localeCompare(a.toLowerCase())\n            : a.toLowerCase().localeCompare(b.toLowerCase());\n        return res;\n    })\n        .reduce(function (acc, key) {\n        acc[key] = sortObjectKeys(obj[key], { sortType: sortType });\n        return acc;\n    }, {});\n};\n/**\n * 将JSON字符串格式化并按照key进行排序\n * @param jsonString 原始JSON字符串\n * @param SortOptions 排序参数：sortType为排序方式，asc升序，desc降序，默认asc\n * @returns 格式化之后的JSON字符串\n */\nvar sortJson = function (jsonString, _a) {\n    var _b = _a === void 0 ? {} : _a, _c = _b.sortType, sortType = _c === void 0 ? 'asc' : _c;\n    try {\n        var parsed = JSON.parse(jsonString);\n        var sortedParsed = sortObjectKeys(parsed, { sortType: sortType });\n        return JSON.stringify(sortedParsed, null, 2);\n    }\n    catch (e) {\n        console.error('Failed to parse JSON string:', e);\n        return jsonString; // Return original string if parsing fails\n    }\n};\nvar jsonUtils = {\n    sortObjectKeys: sortObjectKeys,\n    sortJson: sortJson\n};\n/* harmony default export */ const __WEBPACK_DEFAULT_EXPORT__ = (jsonUtils);\n\n\n//# sourceURL=webpack://easyutilssdk/./src/json.ts?");
+eval("{__webpack_require__.r(__webpack_exports__);\n/* harmony export */ __webpack_require__.d(__webpack_exports__, {\n/* harmony export */   jsonUtils: () => (/* binding */ jsonUtils),\n/* harmony export */   sortJsonByKeys: () => (/* binding */ sortJsonByKeys),\n/* harmony export */   sortJsonStringByKeys: () => (/* binding */ sortJsonStringByKeys)\n/* harmony export */ });\n/**\n * @module json\n * @description json对象相关工具类\n */\n/**\n * 对JSON对象按照key进行升序或者降序排序\n * @param obj JSON对象\n * @param SortOptions 排序参数：sortType为排序方式，asc升序，desc降序，默认asc\n * @returns 排序之后的JSON对象\n */\nvar sortJsonByKeys = function (obj, _a) {\n    var _b = _a === void 0 ? {} : _a, _c = _b.sortType, sortType = _c === void 0 ? 'asc' : _c;\n    if (typeof obj !== 'object' || obj === null) {\n        return obj;\n    }\n    if (Array.isArray(obj)) {\n        return obj.map(function (item) { return sortJsonByKeys(item, { sortType: sortType }); });\n    }\n    return Object.keys(obj)\n        .sort(function (a, b) {\n        var res = sortType === 'desc'\n            ? b.toLowerCase().localeCompare(a.toLowerCase())\n            : a.toLowerCase().localeCompare(b.toLowerCase());\n        return res;\n    })\n        .reduce(function (acc, key) {\n        acc[key] = sortJsonByKeys(obj[key], { sortType: sortType });\n        return acc;\n    }, {});\n};\n/**\n * 将JSON字符串格式化并按照key进行排序\n * @param jsonString 原始JSON字符串\n * @param SortOptions 排序参数：sortType为排序方式，asc升序，desc降序，默认asc\n * @returns 格式化之后的JSON字符串\n */\nvar sortJsonStringByKeys = function (jsonString, _a) {\n    var _b = _a === void 0 ? {} : _a, _c = _b.sortType, sortType = _c === void 0 ? 'asc' : _c;\n    try {\n        var parsed = JSON.parse(jsonString);\n        var sortedParsed = sortJsonByKeys(parsed, { sortType: sortType });\n        return JSON.stringify(sortedParsed, null, 2);\n    }\n    catch (e) {\n        console.error('Failed to parse JSON string:', e);\n        return jsonString; // Return original string if parsing fails\n    }\n};\nvar jsonUtils = {\n    sortJsonByKeys: sortJsonByKeys,\n    sortJsonStringByKeys: sortJsonStringByKeys\n};\n\n\n//# sourceURL=webpack://easyutilssdk/./src/json.ts?\n}");
 
 /***/ })
 
@@ -96,6 +106,10 @@ eval("__webpack_require__.r(__webpack_exports__);\n/* harmony export */ __webpac
 /******/ // Load entry module and return exports
 /******/ // This entry module can't be inlined because the eval devtool is used.
 /******/ var __webpack_exports__ = __webpack_require__("./src/index.ts");
-/******/ const __webpack_exports__default = __webpack_exports__["default"];
-/******/ export { __webpack_exports__default as default };
+/******/ const __webpack_exports__commonUtils = __webpack_exports__.commonUtils;
+/******/ const __webpack_exports__delay = __webpack_exports__.delay;
+/******/ const __webpack_exports__jsonUtils = __webpack_exports__.jsonUtils;
+/******/ const __webpack_exports__sortJsonByKeys = __webpack_exports__.sortJsonByKeys;
+/******/ const __webpack_exports__sortJsonStringByKeys = __webpack_exports__.sortJsonStringByKeys;
+/******/ export { __webpack_exports__commonUtils as commonUtils, __webpack_exports__delay as delay, __webpack_exports__jsonUtils as jsonUtils, __webpack_exports__sortJsonByKeys as sortJsonByKeys, __webpack_exports__sortJsonStringByKeys as sortJsonStringByKeys };
 /******/ 

package/jest.config.js

@@ -0,0 +1,14 @@
+module.exports = {
+  preset: 'ts-jest',
+  testEnvironment: 'node',
+  roots: ['<rootDir>/src', '<rootDir>/node'],
+  testMatch: ['**/__tests__/**/*.+(ts|tsx|js)', '**/?(*.)+(spec|test).+(ts|tsx|js)'],
+  transform: {
+    '^.+\\.(ts|tsx)$': 'ts-jest',
+  },
+  collectCoverageFrom: [
+    'src/**/*.{ts,tsx}',
+    '!src/index.ts',
+    '!src/**/*.d.ts'
+  ]
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "easyutilssdk",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "main": "dist/node/index.js",
   "browser": "dist/web/index.js",
   "author": "liuyk",
@@ -11,13 +11,19 @@
     "build:node": "webpack --config webpack.node.config.js",
     "build": "npm run build:web && npm run build:node",
     "watch": "webpack --watch",
-    "serve": "webpack serve"
+    "serve": "webpack serve",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "typedoc": "typedoc"
   },
   "devDependencies": {
+    "@types/jest": "^30.0.0",
     "@webpack-cli/generators": "^3.0.7",
     "autoprefixer": "^10.4.21",
     "css-loader": "^7.1.2",
     "html-webpack-plugin": "^5.6.3",
+    "jest": "^30.1.3",
     "less": "^4.3.0",
     "less-loader": "^12.2.0",
     "mini-css-extract-plugin": "^2.9.2",
@@ -25,12 +31,28 @@
     "postcss-loader": "^8.1.1",
     "prettier": "^3.5.3",
     "style-loader": "^4.0.0",
+    "ts-jest": "^29.4.1",
     "ts-loader": "^9.5.2",
+    "typedoc": "^0.28.15",
     "typescript": "^5.8.3",
     "webpack": "^5.99.7",
     "webpack-cli": "^5.1.4",
     "webpack-dev-server": "^5.2.1",
     "webpack-node-externals": "^3.0.0"
   },
-  "description": "easyutilssdk"
+  "description": "easyutilssdk",
+  "dependencies": {
+    "@babel/generator": "^7.28.3",
+    "@babel/parser": "^7.28.4",
+    "@babel/preset-env": "^7.28.3",
+    "@babel/preset-react": "^7.27.1",
+    "@babel/preset-typescript": "^7.27.1",
+    "@babel/traverse": "^7.28.4",
+    "@babel/types": "^7.28.4",
+    "file-saver": "^2.0.5",
+    "html2canvas": "^1.4.1",
+    "jszip": "^3.10.1",
+    "pixelmatch": "^7.1.0",
+    "xlsx": "^0.18.5"
+  }
 }

package/typedoc.json

@@ -0,0 +1,12 @@
+{
+  "entryPoints": ["./node/**/*.{ts,tsx}", "./src/**/*.{ts,tsx}"],
+  "exclude": ["*/__tests__/*.ts", "node/codeCommentTest/*.ts", "./node/index.ts", "./src/index.ts"],
+  "out": "docs",
+  "name": "EasyUtilsSDK",
+  "readme": "README.md",
+  "theme": "default",
+  "excludePrivate": true,
+  "excludeProtected": true,
+  "includeVersion": true,
+  "disableSources": false,
+}