fast-cocos 1.1.22 → 1.1.24

package/dist/json/src/JsonUtils.js

@@ -13,13 +13,29 @@ class JsonUtils {
      * @param options JSON 合并选项
      */
     merge(options) {
-        utils_1.utils.writeJson(this.getOutputPath(options), this.mergeJsonFiles(options));
+        utils_1.utils.writeJson(this.getMergeOutputPath(options), this.mergeJsonFiles(options));
+    }
+    /**
+     * 将单个 JSON 文件拆分为多个文件。
+     * @param options JSON 拆分选项
+     */
+    split(options) {
+        const content = utils_1.utils.readJson(options.source);
+        if (content == null) {
+            throw new Error(`source json not found: ${options.source}`);
+        }
+        utils_1.utils.mkdir(options.output);
+        if (options.type === "array") {
+            this.splitArray(content, options);
+            return;
+        }
+        this.splitMap(content, options);
     }
     /**
      * 获取合并结果的输出路径。
      * @param options JSON 合并选项
      */
-    getOutputPath(options) {
+    getMergeOutputPath(options) {
         return path_1.default.join(options.output, options.file || DEFAULT_MERGE_FILE);
     }
     /**
@@ -30,21 +46,61 @@ class JsonUtils {
         return path_1.default.basename(filePath, path_1.default.extname(filePath));
     }
     /**
-     * 递归读取目录中的 JSON 文件，并按文件名合并为一个对象。
+     * 递归读取目录中的 JSON 文件，并按 type 合并为对象映射表或数组。
      * @param options JSON 合并选项
      */
     mergeJsonFiles(options) {
-        const outputPath = this.getOutputPath(options);
-        const sourceFiles = utils_1.utils.findFiles(options.source, [".json"]);
+        const outputPath = this.getMergeOutputPath(options);
+        const sourceFiles = utils_1.utils
+            .findFiles(options.source, [".json"])
+            .filter((filePath) => path_1.default.resolve(filePath) !== path_1.default.resolve(outputPath));
+        if (options.type === "array") {
+            return sourceFiles.map((filePath) => utils_1.utils.readJson(filePath));
+        }
         const merged = {};
         // 将每个 JSON 文件内容挂到对应文件名 key 下。
-        sourceFiles
-            .filter((filePath) => path_1.default.resolve(filePath) !== path_1.default.resolve(outputPath))
-            .forEach((filePath) => {
+        sourceFiles.forEach((filePath) => {
             const json = utils_1.utils.readJson(filePath);
             merged[this.getJsonFileKey(filePath)] = json;
         });
         return merged;
     }
+    /**
+     * 按对象 key 拆分映射表。
+     * @param content JSON 内容
+     * @param options 拆分选项
+     */
+    splitMap(content, options) {
+        if (Array.isArray(content) || typeof content !== "object") {
+            throw new Error("type=map expects a JSON object");
+        }
+        Object.entries(content).forEach(([key, value]) => {
+            utils_1.utils.writeJson(path_1.default.join(options.output, `${key}.json`), value);
+        });
+    }
+    /**
+     * 按指定字段拆分数组。
+     * @param content JSON 内容
+     * @param options 拆分选项
+     */
+    splitArray(content, options) {
+        if (!Array.isArray(content)) {
+            throw new Error("type=array expects a JSON array");
+        }
+        if (!options.field) {
+            throw new Error("split with type=array requires field");
+        }
+        const field = options.field;
+        content.forEach((item, index) => {
+            if (item == null || typeof item !== "object" || Array.isArray(item)) {
+                throw new Error(`array item at index ${index} is not an object`);
+            }
+            const fileName = item[field];
+            if (fileName == null || fileName === "") {
+                throw new Error(`array item at index ${index} missing field: ${field}`);
+            }
+            utils_1.utils.writeJson(path_1.default.join(options.output, `${String(fileName)}.json`), item);
+        });
+    }
 }
 exports.jsonUtils = new JsonUtils();

package/dist/json/src/index.js

@@ -12,21 +12,46 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const commander_1 = require("commander");
 const JsonUtils_1 = require("./JsonUtils");
 /**
- * 解析 JSON 合并命令参数，并将目录中的 JSON 文件合并输出。
+ * 解析 JSON 合并/拆分命令参数，并执行对应操作。
  */
 function main() {
     return __awaiter(this, void 0, void 0, function* () {
         commander_1.program
             .name("json")
-            .description("json utility")
+            .description("Merge or split JSON files. Default action is merge.")
             .version("1.0.0")
-            .requiredOption("-s, --source <source>", "source directory")
+            .requiredOption("-s, --source <source>", "merge: source directory; split: source JSON file")
             .requiredOption("-o, --output <output>", "output directory")
-            .option("-m, --merge <merge>")
-            .option("-f, --file <file name>", "file name")
+            .option("-p, --split", "split one JSON file into multiple files", false)
+            .option("-f, --file <file name>", "merge: output file name (default: merge.json)")
+            .option("-t, --type <type>", "JSON content format: map | array", "map")
+            .option("-k, --field <field>", "split + array: field used as output file name")
             .parse(process.argv);
         const options = commander_1.program.opts();
-        JsonUtils_1.jsonUtils.merge(options);
+        if (options.type !== "map" && options.type !== "array") {
+            console.error(`invalid type: ${options.type}, expected map | array`);
+            process.exit(1);
+        }
+        const type = options.type;
+        if (options.split) {
+            if (type === "array" && !options.field) {
+                console.error("split with type=array requires -k, --field <field>");
+                process.exit(1);
+            }
+            JsonUtils_1.jsonUtils.split({
+                source: options.source,
+                output: options.output,
+                type,
+                field: options.field
+            });
+            return;
+        }
+        JsonUtils_1.jsonUtils.merge({
+            source: options.source,
+            output: options.output,
+            file: options.file,
+            type
+        });
     });
 }
 // 捕获入口异步异常并以非零状态码退出。

package/dist/xlsx/template/xlsx.txt

@@ -1,32 +1,32 @@
-// 数字序列
+/** 数字序列 */
 type BuildNumbers<N extends number, Result extends number[] = []> = Result["length"] extends N
     ? never
     : [...Result, Result["length"]] extends [infer _, ...infer Rest]
     ? Result["length"] | BuildNumbers<N, [...Result, Result["length"]]>
     : never;
 
-// 生成 1 到 10 的数字
+/** 生成 1 到 10 的数字 */
 type NumberRange = Exclude<BuildNumbers<11>, 0>;
 
-// Excel版本
+/** Excel版本 */
 type XlsxVersion = `v${NumberRange}`;
 
-// 整数
+/** 整数 */
 export type int = number;
 
-// 浮点数
+/** 浮点数 */
 export type float = number;
 
-// Excel工作表数据
+/** Excel工作表数据 */
 type XlsxData<T = unknown> = { [key: string]: T };
 
-// Excel工作表管理
+/** Excel工作表管理 */
 class Xlsx {
     private static _instance: Xlsx;
     public static get instance(): Xlsx {
         return Xlsx._instance ?? (Xlsx._instance = new Xlsx());
     }
-    [key: string]: any;
+    // [key: string]: any;
     private readonly sheetToKey: Map<string, string>;
 {0}
     private constructor() {
@@ -35,7 +35,7 @@ class Xlsx {
         const keys = Object.keys(this).filter((it) => it != "sheetToKey");
         const values = Object.values(this);
         for (const value of values) {
-            const key = keys.find((key) => this[key] === value);
+            const key = keys.find((key) => (this as any)[key] === value);
             key && this.sheetToKey.set(value, key);
         }
     }
@@ -56,24 +56,24 @@ class Xlsx {
     public updateSheet<T>(sheetName: string, data: T): void {
         const key = this.sheetToKey.get(sheetName);
         if (!key) {
-            this[sheetName] = data;
+            (this as any)[sheetName] = data;
             console.warn(`强制更新表【${sheetName}】`);
             return;
         }
 
         if (sheetName.endsWith("KVMap") || (!sheetName.endsWith("VMap") && sheetName.endsWith("Map"))) {
-            this[key] = this.toMap(data as { [key: string]: unknown });
+            (this as any)[key] = this.toMap(data as { [key: string]: unknown });
             return;
         }
 
-        this[key] = data;
+        (this as any)[key] = data;
     }
 
     /**
      * 检查没有的配置表
      */
     public checkNotSheet(): string[] {
-        return [...this.sheetToKey.keys()].filter((sheetName) => typeof this[sheetName] == "string");
+        return [...this.sheetToKey.keys()].filter((sheetName) => typeof (this as any)[sheetName] == "string");
     }
 
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fast-cocos",
-  "version": "1.1.22",
+  "version": "1.1.24",
   "scripts": {
     "clean": "rm -rf dist",
     "start": "node ./dist/index.js",