@yarn-tool/static-file 3.0.4 → 3.0.5

package/lib/getRowOfStaticFilesMapArray.js

@@ -2,6 +2,38 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getRowOfStaticFilesMapArray = getRowOfStaticFilesMapArray;
 const parseStaticMap_1 = require("./parseStaticMap");
+/**
+ * Get a specific row from static files map array / 從靜態檔案映射陣列獲取特定行
+ *
+ * Retrieves a specific entry from the static files map based on the target file key.
+ * 根據目標檔案鍵從靜態檔案映射中檢索特定條目。
+ *
+ * @template T - The static files map type / 靜態檔案映射類型
+ * @template K - The target file key type / 目標檔案鍵類型
+ *
+ * @param file_map - The static files map (array or record format) / 靜態檔案映射（陣列或記錄格式）
+ * @param key - The target file key to search for / 要搜尋的目標檔案鍵
+ *
+ * @returns The matching entry or undefined if not found / 匹配的條目，如果未找到則返回 undefined
+ *
+ * @example
+ * ```typescript
+ * import { getRowOfStaticFilesMapArray } from '@yarn-tool/static-file';
+ * import { defaultCopyStaticFiles } from '@yarn-tool/static-file/lib/const';
+ *
+ * // Get the entry for .gitignore
+ * // 獲取 .gitignore 的條目
+ * const entry = getRowOfStaticFilesMapArray(defaultCopyStaticFiles, '.gitignore');
+ * // Returns: ['.gitignore', 'file/gitignore']
+ * // 返回：['.gitignore', 'file/gitignore']
+ *
+ * // Get the entry for tsconfig.json.tpl
+ * // 獲取 tsconfig.json.tpl 的條目
+ * const tsconfigEntry = getRowOfStaticFilesMapArray(defaultCopyStaticFiles, 'tsconfig.json.tpl');
+ * // Returns: ['tsconfig.json.tpl', 'file/tsconfig.json.tpl', 'tsconfig.json']
+ * // 返回：['tsconfig.json.tpl', 'file/tsconfig.json.tpl', 'tsconfig.json']
+ * ```
+ */
 function getRowOfStaticFilesMapArray(file_map, key) {
     return (0, parseStaticMap_1.parseStaticMap)(file_map).find(a => a[0] === key);
 }

package/lib/getRowOfStaticFilesMapArray.js.map

@@ -1 +1 @@
-{"version":3,"file":"getRowOfStaticFilesMapArray.js","sourceRoot":"","sources":["getRowOfStaticFilesMapArray.ts"],"names":[],"mappings":";;AAUA,kEAGC;AALD,qDAAkD;AAElD,SAAgB,2BAA2B,CAA+D,QAAW,EAAE,GAAM;IAE5H,OAAO,IAAA,+BAAc,EAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,CAAiC,CAAA;AACxF,CAAC","sourcesContent":["import {\n\tIStaticFiles,\n\tIStaticFilesID,\n\tIStaticFilesKey,\n\tIStaticFilesMapArray,\n\tIStaticFilesMapArrayEntry,\n\tIStaticFilesMapRecord,\n} from './types';\nimport { parseStaticMap } from './parseStaticMap';\n\nexport function getRowOfStaticFilesMapArray<T extends IStaticFiles<string>, K extends IStaticFilesKey<T>>(file_map: T, key: K)\n{\n\treturn parseStaticMap(file_map).find(a => a[0] === key) as IStaticFilesMapArrayEntry<K>\n}\n"]}
+{"version":3,"file":"getRowOfStaticFilesMapArray.js","sourceRoot":"","sources":["getRowOfStaticFilesMapArray.ts"],"names":[],"mappings":";;AAkDA,kEAGC;AArCD,qDAAkD;AAElD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,SAAgB,2BAA2B,CAA+D,QAAW,EAAE,GAAM;IAE5H,OAAO,IAAA,+BAAc,EAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,CAAiC,CAAA;AACxF,CAAC","sourcesContent":["/**\n * Get row from static files map array / 從靜態檔案映射陣列獲取行\n *\n * This module provides a function to retrieve a specific entry from a static files map.\n * 此模組提供從靜態檔案映射中檢索特定條目的函數。\n *\n * @module getRowOfStaticFilesMapArray\n */\nimport {\n\tIStaticFiles,\n\tIStaticFilesID,\n\tIStaticFilesKey,\n\tIStaticFilesMapArray,\n\tIStaticFilesMapArrayEntry,\n\tIStaticFilesMapRecord,\n} from './types';\nimport { parseStaticMap } from './parseStaticMap';\n\n/**\n * Get a specific row from static files map array / 從靜態檔案映射陣列獲取特定行\n *\n * Retrieves a specific entry from the static files map based on the target file key.\n * 根據目標檔案鍵從靜態檔案映射中檢索特定條目。\n *\n * @template T - The static files map type / 靜態檔案映射類型\n * @template K - The target file key type / 目標檔案鍵類型\n *\n * @param file_map - The static files map (array or record format) / 靜態檔案映射（陣列或記錄格式）\n * @param key - The target file key to search for / 要搜尋的目標檔案鍵\n *\n * @returns The matching entry or undefined if not found / 匹配的條目，如果未找到則返回 undefined\n *\n * @example\n * ```typescript\n * import { getRowOfStaticFilesMapArray } from '@yarn-tool/static-file';\n * import { defaultCopyStaticFiles } from '@yarn-tool/static-file/lib/const';\n *\n * // Get the entry for .gitignore\n * // 獲取 .gitignore 的條目\n * const entry = getRowOfStaticFilesMapArray(defaultCopyStaticFiles, '.gitignore');\n * // Returns: ['.gitignore', 'file/gitignore']\n * // 返回：['.gitignore', 'file/gitignore']\n *\n * // Get the entry for tsconfig.json.tpl\n * // 獲取 tsconfig.json.tpl 的條目\n * const tsconfigEntry = getRowOfStaticFilesMapArray(defaultCopyStaticFiles, 'tsconfig.json.tpl');\n * // Returns: ['tsconfig.json.tpl', 'file/tsconfig.json.tpl', 'tsconfig.json']\n * // 返回：['tsconfig.json.tpl', 'file/tsconfig.json.tpl', 'tsconfig.json']\n * ```\n */\nexport function getRowOfStaticFilesMapArray<T extends IStaticFiles<string>, K extends IStaticFilesKey<T>>(file_map: T, key: K)\n{\n\treturn parseStaticMap(file_map).find(a => a[0] === key) as IStaticFilesMapArrayEntry<K>\n}\n"]}

package/lib/getStaticFile.d.ts

@@ -1,2 +1,44 @@
+/**
+ * Get static file entry / 獲取靜態檔案條目
+ *
+ * This module provides a convenience function to retrieve a static file entry.
+ * 此模組提供獲取靜態檔案條目的便利函數。
+ *
+ * @module getStaticFile
+ */
 import { ICopyStaticFilesOptions } from './types';
+/**
+ * Get a static file entry by file ID / 根據檔案 ID 獲取靜態檔案條目
+ *
+ * Retrieves the static file entry for a given file ID from the file map.
+ * 從檔案映射中根據給定的檔案 ID 檢索靜態檔案條目。
+ *
+ * @template K - The file ID type / 檔案 ID 類型
+ *
+ * @param file_id - The file ID to look up / 要查找的檔案 ID
+ * @param options - Optional configuration / 可選配置
+ * @param options.file_map - Custom file map (defaults to defaultCopyStaticFiles) / 自訂檔案映射（預設為 defaultCopyStaticFiles）
+ *
+ * @returns The static file entry or undefined if not found / 靜態檔案條目，如果未找到則返回 undefined
+ *
+ * @example
+ * ```typescript
+ * import { getStaticFile } from '@yarn-tool/static-file';
+ *
+ * // Get the .gitignore entry from default file map
+ * // 從預設檔案映射獲取 .gitignore 條目
+ * const entry = getStaticFile('.gitignore');
+ * // Returns: ['.gitignore', 'file/gitignore']
+ * // 返回：['.gitignore', 'file/gitignore']
+ *
+ * // Get entry from custom file map
+ * // 從自訂檔案映射獲取條目
+ * const customEntry = getStaticFile('README.md', {
+ *   file_map: [
+ *     ['README.md', 'file/README.md'],
+ *     ['.gitignore', 'file/gitignore']
+ *   ]
+ * });
+ * ```
+ */
 export declare function getStaticFile<K extends string>(file_id: K, options?: Pick<ICopyStaticFilesOptions<K>, 'file_map'>): import("./types").IStaticFilesMapArrayEntry<K>;

package/lib/getStaticFile.js

@@ -3,6 +3,40 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getStaticFile = getStaticFile;
 const const_1 = require("./const");
 const getRowOfStaticFilesMapArray_1 = require("./getRowOfStaticFilesMapArray");
+/**
+ * Get a static file entry by file ID / 根據檔案 ID 獲取靜態檔案條目
+ *
+ * Retrieves the static file entry for a given file ID from the file map.
+ * 從檔案映射中根據給定的檔案 ID 檢索靜態檔案條目。
+ *
+ * @template K - The file ID type / 檔案 ID 類型
+ *
+ * @param file_id - The file ID to look up / 要查找的檔案 ID
+ * @param options - Optional configuration / 可選配置
+ * @param options.file_map - Custom file map (defaults to defaultCopyStaticFiles) / 自訂檔案映射（預設為 defaultCopyStaticFiles）
+ *
+ * @returns The static file entry or undefined if not found / 靜態檔案條目，如果未找到則返回 undefined
+ *
+ * @example
+ * ```typescript
+ * import { getStaticFile } from '@yarn-tool/static-file';
+ *
+ * // Get the .gitignore entry from default file map
+ * // 從預設檔案映射獲取 .gitignore 條目
+ * const entry = getStaticFile('.gitignore');
+ * // Returns: ['.gitignore', 'file/gitignore']
+ * // 返回：['.gitignore', 'file/gitignore']
+ *
+ * // Get entry from custom file map
+ * // 從自訂檔案映射獲取條目
+ * const customEntry = getStaticFile('README.md', {
+ *   file_map: [
+ *     ['README.md', 'file/README.md'],
+ *     ['.gitignore', 'file/gitignore']
+ *   ]
+ * });
+ * ```
+ */
 function getStaticFile(file_id, options) {
     return (0, getRowOfStaticFilesMapArray_1.getRowOfStaticFilesMapArray)((options === null || options === void 0 ? void 0 : options.file_map) || const_1.defaultCopyStaticFiles, file_id);
 }

package/lib/getStaticFile.js.map

@@ -1 +1 @@
-{"version":3,"file":"getStaticFile.js","sourceRoot":"","sources":["getStaticFile.ts"],"names":[],"mappings":";;AAKA,sCAKC;AARD,mCAAiD;AACjD,+EAA4E;AAE5E,SAAgB,aAAa,CAAmB,OAAU,EACzD,OAAsD;IAGtD,OAAO,IAAA,yDAA2B,EAAC,CAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,QAAQ,KAAI,8BAAsB,EAAE,OAAO,CAAC,CAAA;AACzF,CAAC","sourcesContent":["import { ICopyStaticFilesOptions, IStaticFilesMapArray } from './types';\nimport { parseStaticMap } from './parseStaticMap';\nimport { defaultCopyStaticFiles } from './const';\nimport { getRowOfStaticFilesMapArray } from './getRowOfStaticFilesMapArray';\n\nexport function getStaticFile<K extends string>(file_id: K,\n\toptions?: Pick<ICopyStaticFilesOptions<K>, 'file_map'>,\n)\n{\n\treturn getRowOfStaticFilesMapArray(options?.file_map || defaultCopyStaticFiles, file_id)\n}\n"]}
+{"version":3,"file":"getStaticFile.js","sourceRoot":"","sources":["getStaticFile.ts"],"names":[],"mappings":";;AA+CA,sCAKC;AA1CD,mCAAiD;AACjD,+EAA4E;AAE5E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,SAAgB,aAAa,CAAmB,OAAU,EACzD,OAAsD;IAGtD,OAAO,IAAA,yDAA2B,EAAC,CAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,QAAQ,KAAI,8BAAsB,EAAE,OAAO,CAAC,CAAA;AACzF,CAAC","sourcesContent":["/**\n * Get static file entry / 獲取靜態檔案條目\n *\n * This module provides a convenience function to retrieve a static file entry.\n * 此模組提供獲取靜態檔案條目的便利函數。\n *\n * @module getStaticFile\n */\nimport { ICopyStaticFilesOptions, IStaticFilesMapArray } from './types';\nimport { parseStaticMap } from './parseStaticMap';\nimport { defaultCopyStaticFiles } from './const';\nimport { getRowOfStaticFilesMapArray } from './getRowOfStaticFilesMapArray';\n\n/**\n * Get a static file entry by file ID / 根據檔案 ID 獲取靜態檔案條目\n *\n * Retrieves the static file entry for a given file ID from the file map.\n * 從檔案映射中根據給定的檔案 ID 檢索靜態檔案條目。\n *\n * @template K - The file ID type / 檔案 ID 類型\n *\n * @param file_id - The file ID to look up / 要查找的檔案 ID\n * @param options - Optional configuration / 可選配置\n * @param options.file_map - Custom file map (defaults to defaultCopyStaticFiles) / 自訂檔案映射（預設為 defaultCopyStaticFiles）\n *\n * @returns The static file entry or undefined if not found / 靜態檔案條目，如果未找到則返回 undefined\n *\n * @example\n * ```typescript\n * import { getStaticFile } from '@yarn-tool/static-file';\n *\n * // Get the .gitignore entry from default file map\n * // 從預設檔案映射獲取 .gitignore 條目\n * const entry = getStaticFile('.gitignore');\n * // Returns: ['.gitignore', 'file/gitignore']\n * // 返回：['.gitignore', 'file/gitignore']\n *\n * // Get entry from custom file map\n * // 從自訂檔案映射獲取條目\n * const customEntry = getStaticFile('README.md', {\n *   file_map: [\n *     ['README.md', 'file/README.md'],\n *     ['.gitignore', 'file/gitignore']\n *   ]\n * });\n * ```\n */\nexport function getStaticFile<K extends string>(file_id: K,\n\toptions?: Pick<ICopyStaticFilesOptions<K>, 'file_map'>,\n)\n{\n\treturn getRowOfStaticFilesMapArray(options?.file_map || defaultCopyStaticFiles, file_id)\n}\n"]}

package/lib/parseStaticMap.d.ts

@@ -1,4 +1,43 @@
+/**
+ * Parse static file map / 解析靜態檔案映射
+ *
+ * This module provides functions to parse different static file map formats
+ * into a unified array format.
+ * 此模組提供將不同靜態檔案映射格式解析為統一陣列格式的函數。
+ *
+ * @module parseStaticMap
+ */
 import { IStaticFiles, IStaticFilesID, IStaticFilesMapArray, IStaticFilesMapRecord } from './types';
+/**
+ * Parse static file map from array format / 從陣列格式解析靜態檔案映射
+ *
+ * Converts an array-based file map to a normalized array format.
+ * 將基於陣列的檔案映射轉換為標準化陣列格式。
+ *
+ * @template K - The target file path type / 目標檔案路徑類型
+ * @param file_map - The array-based file map / 基於陣列的檔案映射
+ * @returns Normalized array of file map entries / 標準化的檔案映射條目陣列
+ */
 export declare function parseStaticMap<K extends string>(file_map: IStaticFilesMapArray<K>): IStaticFilesMapArray<K | IStaticFilesID>;
+/**
+ * Parse static file map from record format / 從記錄格式解析靜態檔案映射
+ *
+ * Converts a record-based file map to a normalized array format.
+ * 將基於記錄的檔案映射轉換為標準化陣列格式。
+ *
+ * @template K - The target file path type / 目標檔案路徑類型
+ * @param file_map - The record-based file map / 基於記錄的檔案映射
+ * @returns Normalized array of file map entries / 標準化的檔案映射條目陣列
+ */
 export declare function parseStaticMap<K extends string>(file_map: IStaticFilesMapRecord<K>): IStaticFilesMapArray<K | IStaticFilesID>;
+/**
+ * Parse static file map from any supported format / 從任何支援的格式解析靜態檔案映射
+ *
+ * Unified function that handles both array and record formats.
+ * 處理陣列和記錄格式的統一函數。
+ *
+ * @template K - The target file path type / 目標檔案路徑類型
+ * @param file_map - The file map in any supported format / 任何支援格式的檔案映射
+ * @returns Normalized array of file map entries / 標準化的檔案映射條目陣列
+ */
 export declare function parseStaticMap<K extends string>(file_map: IStaticFiles<K>): IStaticFilesMapArray<K | IStaticFilesID>;

package/lib/parseStaticMap.js

@@ -1,15 +1,22 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.parseStaticMap = parseStaticMap;
+/**
+ * Implementation of parseStaticMap / parseStaticMap 的實現
+ * @internal
+ */
 function parseStaticMap(file_map) {
     let ls;
+    // Handle array format / 處理陣列格式
     if (Array.isArray(file_map)) {
         ls = Object.values(file_map);
     }
+    // Handle record format / 處理記錄格式
     else {
         // @ts-ignore
         ls = Object.entries(file_map);
     }
+    // Filter out invalid entries / 過濾無效條目
     return ls.filter(v => v && Array.isArray(v) && v.length > 1);
 }
 //# sourceMappingURL=parseStaticMap.js.map

package/lib/parseStaticMap.js.map

@@ -1 +1 @@
-{"version":3,"file":"parseStaticMap.js","sourceRoot":"","sources":["parseStaticMap.ts"],"names":[],"mappings":";;AAWA,wCAeC;AAfD,SAAgB,cAAc,CAAmB,QAAyB;IAEzE,IAAI,EAA2B,CAAC;IAEhC,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAC3B,CAAC;QACA,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;IAC7B,CAAC;SAED,CAAC;QACA,aAAa;QACb,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;IAC9B,CAAC;IAED,OAAO,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AAC9D,CAAC","sourcesContent":["import {\n\tIStaticFiles,\n\tIStaticFilesID,\n\tIStaticFilesMapArray,\n\tIStaticFilesMapRecord,\n\tIStaticFilesMapArrayEntry,\n} from './types';\n\nexport function parseStaticMap<K extends string>(file_map: IStaticFilesMapArray<K>): IStaticFilesMapArray<K | IStaticFilesID>\nexport function parseStaticMap<K extends string>(file_map: IStaticFilesMapRecord<K>): IStaticFilesMapArray<K | IStaticFilesID>\nexport function parseStaticMap<K extends string>(file_map: IStaticFiles<K>): IStaticFilesMapArray<K | IStaticFilesID>\nexport function parseStaticMap<K extends string>(file_map: IStaticFiles<K>): IStaticFilesMapArray<K | IStaticFilesID>\n{\n\tlet ls: IStaticFilesMapArray<K>;\n\n\tif (Array.isArray(file_map))\n\t{\n\t\tls = Object.values(file_map)\n\t}\n\telse\n\t{\n\t\t// @ts-ignore\n\t\tls = Object.entries(file_map)\n\t}\n\n\treturn ls.filter(v => v && Array.isArray(v) && v.length > 1);\n}\n"]}
+{"version":3,"file":"parseStaticMap.js","sourceRoot":"","sources":["parseStaticMap.ts"],"names":[],"mappings":";;AAyDA,wCAkBC;AAtBD;;;GAGG;AACH,SAAgB,cAAc,CAAmB,QAAyB;IAEzE,IAAI,EAA2B,CAAC;IAEhC,+BAA+B;IAC/B,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAC3B,CAAC;QACA,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;IAC7B,CAAC;IACD,gCAAgC;SAEhC,CAAC;QACA,aAAa;QACb,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;IAC9B,CAAC;IAED,sCAAsC;IACtC,OAAO,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AAC9D,CAAC","sourcesContent":["/**\n * Parse static file map / 解析靜態檔案映射\n *\n * This module provides functions to parse different static file map formats\n * into a unified array format.\n * 此模組提供將不同靜態檔案映射格式解析為統一陣列格式的函數。\n *\n * @module parseStaticMap\n */\nimport {\n\tIStaticFiles,\n\tIStaticFilesID,\n\tIStaticFilesMapArray,\n\tIStaticFilesMapRecord,\n\tIStaticFilesMapArrayEntry,\n} from './types';\n\n/**\n * Parse static file map from array format / 從陣列格式解析靜態檔案映射\n *\n * Converts an array-based file map to a normalized array format.\n * 將基於陣列的檔案映射轉換為標準化陣列格式。\n *\n * @template K - The target file path type / 目標檔案路徑類型\n * @param file_map - The array-based file map / 基於陣列的檔案映射\n * @returns Normalized array of file map entries / 標準化的檔案映射條目陣列\n */\nexport function parseStaticMap<K extends string>(file_map: IStaticFilesMapArray<K>): IStaticFilesMapArray<K | IStaticFilesID>\n\n/**\n * Parse static file map from record format / 從記錄格式解析靜態檔案映射\n *\n * Converts a record-based file map to a normalized array format.\n * 將基於記錄的檔案映射轉換為標準化陣列格式。\n *\n * @template K - The target file path type / 目標檔案路徑類型\n * @param file_map - The record-based file map / 基於記錄的檔案映射\n * @returns Normalized array of file map entries / 標準化的檔案映射條目陣列\n */\nexport function parseStaticMap<K extends string>(file_map: IStaticFilesMapRecord<K>): IStaticFilesMapArray<K | IStaticFilesID>\n\n/**\n * Parse static file map from any supported format / 從任何支援的格式解析靜態檔案映射\n *\n * Unified function that handles both array and record formats.\n * 處理陣列和記錄格式的統一函數。\n *\n * @template K - The target file path type / 目標檔案路徑類型\n * @param file_map - The file map in any supported format / 任何支援格式的檔案映射\n * @returns Normalized array of file map entries / 標準化的檔案映射條目陣列\n */\nexport function parseStaticMap<K extends string>(file_map: IStaticFiles<K>): IStaticFilesMapArray<K | IStaticFilesID>\n\n/**\n * Implementation of parseStaticMap / parseStaticMap 的實現\n * @internal\n */\nexport function parseStaticMap<K extends string>(file_map: IStaticFiles<K>): IStaticFilesMapArray<K | IStaticFilesID>\n{\n\tlet ls: IStaticFilesMapArray<K>;\n\n\t// Handle array format / 處理陣列格式\n\tif (Array.isArray(file_map))\n\t{\n\t\tls = Object.values(file_map)\n\t}\n\t// Handle record format / 處理記錄格式\n\telse\n\t{\n\t\t// @ts-ignore\n\t\tls = Object.entries(file_map)\n\t}\n\n\t// Filter out invalid entries / 過濾無效條目\n\treturn ls.filter(v => v && Array.isArray(v) && v.length > 1);\n}\n"]}

package/lib/reMapStaticFilesMapArray.d.ts

@@ -1,2 +1,41 @@
+/**
+ * Remap static files map array / 重新映射靜態檔案映射陣列
+ *
+ * This module provides a function to remap target file paths in a static files map.
+ * 此模組提供重新映射靜態檔案映射中目標檔案路徑的函數。
+ *
+ * @module reMapStaticFilesMapArray
+ */
 import { IStaticFiles, IStaticFilesKey, IStaticFilesMapArray } from './types';
+/**
+ * Remap static files map array with new target paths / 使用新目標路徑重新映射靜態檔案映射陣列
+ *
+ * Creates a new static files map array by replacing target file paths according to the provided mapping.
+ * 根據提供的映射關係，通過替換目標檔案路徑來創建新的靜態檔案映射陣列。
+ *
+ * This is useful when you want to copy the same static file to different target locations.
+ * 當您想將同一個靜態檔案複製到不同的目標位置時，這非常有用。
+ *
+ * @template T - The source static files map type / 來源靜態檔案映射類型
+ * @template N - The new target file path type / 新目標檔案路徑類型
+ *
+ * @param file_map - The source static files map / 來源靜態檔案映射
+ * @param replaceMap - A record mapping new target paths to old target paths / 將新路徑映射到舊路徑的記錄
+ *
+ * @returns A new static files map array with remapped entries / 重新映射條目的新靜態檔案映射陣列
+ *
+ * @example
+ * ```typescript
+ * import { reMapStaticFilesMapArray } from '@yarn-tool/static-file';
+ * import { defaultCopyStaticFiles } from '@yarn-tool/static-file/lib/const';
+ *
+ * // Remap tsconfig.json.tpl to tsconfig.json
+ * // 將 tsconfig.json.tpl 重新映射為 tsconfig.json
+ * const remapped = reMapStaticFilesMapArray(defaultCopyStaticFiles, {
+ *   'tsconfig.json': 'tsconfig.json.tpl'
+ * });
+ * // The result will have an entry for 'tsconfig.json' instead of 'tsconfig.json.tpl'
+ * // 結果將包含 'tsconfig.json' 的條目，而不是 'tsconfig.json.tpl'
+ * ```
+ */
 export declare function reMapStaticFilesMapArray<T extends IStaticFiles<string>, N extends string>(file_map: T, replaceMap: Record<N, IStaticFilesKey<T>>): IStaticFilesMapArray<IStaticFilesKey<T> | N>;

package/lib/reMapStaticFilesMapArray.js

@@ -5,16 +5,52 @@ const parseStaticMap_1 = require("./parseStaticMap");
 const getRowOfStaticFilesMapArray_1 = require("./getRowOfStaticFilesMapArray");
 const replaceTargetOfStaticFilesMapArrayEntry_1 = require("./replaceTargetOfStaticFilesMapArrayEntry");
 const array_hyper_unique_1 = require("array-hyper-unique");
+/**
+ * Remap static files map array with new target paths / 使用新目標路徑重新映射靜態檔案映射陣列
+ *
+ * Creates a new static files map array by replacing target file paths according to the provided mapping.
+ * 根據提供的映射關係，通過替換目標檔案路徑來創建新的靜態檔案映射陣列。
+ *
+ * This is useful when you want to copy the same static file to different target locations.
+ * 當您想將同一個靜態檔案複製到不同的目標位置時，這非常有用。
+ *
+ * @template T - The source static files map type / 來源靜態檔案映射類型
+ * @template N - The new target file path type / 新目標檔案路徑類型
+ *
+ * @param file_map - The source static files map / 來源靜態檔案映射
+ * @param replaceMap - A record mapping new target paths to old target paths / 將新路徑映射到舊路徑的記錄
+ *
+ * @returns A new static files map array with remapped entries / 重新映射條目的新靜態檔案映射陣列
+ *
+ * @example
+ * ```typescript
+ * import { reMapStaticFilesMapArray } from '@yarn-tool/static-file';
+ * import { defaultCopyStaticFiles } from '@yarn-tool/static-file/lib/const';
+ *
+ * // Remap tsconfig.json.tpl to tsconfig.json
+ * // 將 tsconfig.json.tpl 重新映射為 tsconfig.json
+ * const remapped = reMapStaticFilesMapArray(defaultCopyStaticFiles, {
+ *   'tsconfig.json': 'tsconfig.json.tpl'
+ * });
+ * // The result will have an entry for 'tsconfig.json' instead of 'tsconfig.json.tpl'
+ * // 結果將包含 'tsconfig.json' 的條目，而不是 'tsconfig.json.tpl'
+ * ```
+ */
 function reMapStaticFilesMapArray(file_map, replaceMap) {
+    // Parse the source file map / 解析來源檔案映射
     const ls = (0, parseStaticMap_1.parseStaticMap)(file_map);
+    // Process each replacement mapping / 處理每個替換映射
     const arr = Object.entries(replaceMap)
         .reduce((arr, [targetNew, targetOld]) => {
+        // Find the original entry / 查找原始條目
         let old = (0, getRowOfStaticFilesMapArray_1.getRowOfStaticFilesMapArray)(ls, targetOld);
+        // If entry exists, create a new entry with the new target path / 如果條目存在，使用新目標路徑創建新條目
         if (old === null || old === void 0 ? void 0 : old.length) {
             arr.push((0, replaceTargetOfStaticFilesMapArrayEntry_1.replaceTargetOfStaticFilesMapArrayEntry)(old, targetNew));
         }
         return arr;
     }, []);
+    // Combine remapped entries with original entries and remove duplicates / 合併重新映射的條目與原始條目並移除重複項
     return (0, array_hyper_unique_1.array_unique_overwrite)(arr.concat(ls));
 }
 //# sourceMappingURL=reMapStaticFilesMapArray.js.map

package/lib/reMapStaticFilesMapArray.js.map

@@ -1 +1 @@
-{"version":3,"file":"reMapStaticFilesMapArray.js","sourceRoot":"","sources":["reMapStaticFilesMapArray.ts"],"names":[],"mappings":";;AAMA,4DAqBC;AA1BD,qDAAkD;AAClD,+EAA4E;AAC5E,uGAAoG;AACpG,2DAA4D;AAE5D,SAAgB,wBAAwB,CAAmD,QAAW,EACrG,UAAyC;IAGzC,MAAM,EAAE,GAAG,IAAA,+BAAc,EAAC,QAAQ,CAAC,CAAC;IACpC,MAAM,GAAG,GAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAA+B;SACnE,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC,EAAE,EAAE;QAGvC,IAAI,GAAG,GAAG,IAAA,yDAA2B,EAAC,EAAE,EAAE,SAAS,CAAC,CAAA;QAEpD,IAAI,GAAG,aAAH,GAAG,uBAAH,GAAG,CAAE,MAAM,EACf,CAAC;YACA,GAAG,CAAC,IAAI,CAAC,IAAA,iFAAuC,EAAC,GAAG,EAAE,SAAS,CAAC,CAAC,CAAA;QAClE,CAAC;QAED,OAAO,GAAG,CAAA;IACX,CAAC,EAAE,EAA6B,CAAC,CACjC;IAED,OAAO,IAAA,2CAAsB,EAAC,GAAG,CAAC,MAAM,CAAC,EAAS,CAAC,CAAiD,CAAA;AACrG,CAAC","sourcesContent":["import { IStaticFiles, IStaticFilesKey, IStaticFilesMapArray, IStaticFilesMapArrayEntry } from './types';\nimport { parseStaticMap } from './parseStaticMap';\nimport { getRowOfStaticFilesMapArray } from './getRowOfStaticFilesMapArray';\nimport { replaceTargetOfStaticFilesMapArrayEntry } from './replaceTargetOfStaticFilesMapArrayEntry';\nimport { array_unique_overwrite } from 'array-hyper-unique';\n\nexport function reMapStaticFilesMapArray<T extends IStaticFiles<string>, N extends string>(file_map: T,\n\treplaceMap: Record<N, IStaticFilesKey<T>>,\n)\n{\n\tconst ls = parseStaticMap(file_map);\n\tconst arr = (Object.entries(replaceMap) as [N, IStaticFilesKey<T>][])\n\t\t.reduce((arr, [targetNew, targetOld]) =>\n\t\t{\n\n\t\t\tlet old = getRowOfStaticFilesMapArray(ls, targetOld)\n\n\t\t\tif (old?.length)\n\t\t\t{\n\t\t\t\tarr.push(replaceTargetOfStaticFilesMapArrayEntry(old, targetNew))\n\t\t\t}\n\n\t\t\treturn arr\n\t\t}, [] as IStaticFilesMapArray<N>)\n\t;\n\n\treturn array_unique_overwrite(arr.concat(ls as any)) as IStaticFilesMapArray<IStaticFilesKey<T> | N>\n}\n"]}
+{"version":3,"file":"reMapStaticFilesMapArray.js","sourceRoot":"","sources":["reMapStaticFilesMapArray.ts"],"names":[],"mappings":";;AA6CA,4DA2BC;AA/DD,qDAAkD;AAClD,+EAA4E;AAC5E,uGAAoG;AACpG,2DAA4D;AAE5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,SAAgB,wBAAwB,CAAmD,QAAW,EACrG,UAAyC;IAGzC,uCAAuC;IACvC,MAAM,EAAE,GAAG,IAAA,+BAAc,EAAC,QAAQ,CAAC,CAAC;IAEpC,8CAA8C;IAC9C,MAAM,GAAG,GAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAA+B;SACnE,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC,EAAE,EAAE;QAGvC,mCAAmC;QACnC,IAAI,GAAG,GAAG,IAAA,yDAA2B,EAAC,EAAE,EAAE,SAAS,CAAC,CAAA;QAEpD,qFAAqF;QACrF,IAAI,GAAG,aAAH,GAAG,uBAAH,GAAG,CAAE,MAAM,EACf,CAAC;YACA,GAAG,CAAC,IAAI,CAAC,IAAA,iFAAuC,EAAC,GAAG,EAAE,SAAS,CAAC,CAAC,CAAA;QAClE,CAAC;QAED,OAAO,GAAG,CAAA;IACX,CAAC,EAAE,EAA6B,CAAC,CACjC;IAED,8FAA8F;IAC9F,OAAO,IAAA,2CAAsB,EAAC,GAAG,CAAC,MAAM,CAAC,EAAS,CAAC,CAAiD,CAAA;AACrG,CAAC","sourcesContent":["/**\n * Remap static files map array / 重新映射靜態檔案映射陣列\n *\n * This module provides a function to remap target file paths in a static files map.\n * 此模組提供重新映射靜態檔案映射中目標檔案路徑的函數。\n *\n * @module reMapStaticFilesMapArray\n */\nimport { IStaticFiles, IStaticFilesKey, IStaticFilesMapArray, IStaticFilesMapArrayEntry } from './types';\nimport { parseStaticMap } from './parseStaticMap';\nimport { getRowOfStaticFilesMapArray } from './getRowOfStaticFilesMapArray';\nimport { replaceTargetOfStaticFilesMapArrayEntry } from './replaceTargetOfStaticFilesMapArrayEntry';\nimport { array_unique_overwrite } from 'array-hyper-unique';\n\n/**\n * Remap static files map array with new target paths / 使用新目標路徑重新映射靜態檔案映射陣列\n *\n * Creates a new static files map array by replacing target file paths according to the provided mapping.\n * 根據提供的映射關係，通過替換目標檔案路徑來創建新的靜態檔案映射陣列。\n *\n * This is useful when you want to copy the same static file to different target locations.\n * 當您想將同一個靜態檔案複製到不同的目標位置時，這非常有用。\n *\n * @template T - The source static files map type / 來源靜態檔案映射類型\n * @template N - The new target file path type / 新目標檔案路徑類型\n *\n * @param file_map - The source static files map / 來源靜態檔案映射\n * @param replaceMap - A record mapping new target paths to old target paths / 將新路徑映射到舊路徑的記錄\n *\n * @returns A new static files map array with remapped entries / 重新映射條目的新靜態檔案映射陣列\n *\n * @example\n * ```typescript\n * import { reMapStaticFilesMapArray } from '@yarn-tool/static-file';\n * import { defaultCopyStaticFiles } from '@yarn-tool/static-file/lib/const';\n *\n * // Remap tsconfig.json.tpl to tsconfig.json\n * // 將 tsconfig.json.tpl 重新映射為 tsconfig.json\n * const remapped = reMapStaticFilesMapArray(defaultCopyStaticFiles, {\n *   'tsconfig.json': 'tsconfig.json.tpl'\n * });\n * // The result will have an entry for 'tsconfig.json' instead of 'tsconfig.json.tpl'\n * // 結果將包含 'tsconfig.json' 的條目，而不是 'tsconfig.json.tpl'\n * ```\n */\nexport function reMapStaticFilesMapArray<T extends IStaticFiles<string>, N extends string>(file_map: T,\n\treplaceMap: Record<N, IStaticFilesKey<T>>,\n)\n{\n\t// Parse the source file map / 解析來源檔案映射\n\tconst ls = parseStaticMap(file_map);\n\n\t// Process each replacement mapping / 處理每個替換映射\n\tconst arr = (Object.entries(replaceMap) as [N, IStaticFilesKey<T>][])\n\t\t.reduce((arr, [targetNew, targetOld]) =>\n\t\t{\n\n\t\t\t// Find the original entry / 查找原始條目\n\t\t\tlet old = getRowOfStaticFilesMapArray(ls, targetOld)\n\n\t\t\t// If entry exists, create a new entry with the new target path / 如果條目存在，使用新目標路徑創建新條目\n\t\t\tif (old?.length)\n\t\t\t{\n\t\t\t\tarr.push(replaceTargetOfStaticFilesMapArrayEntry(old, targetNew))\n\t\t\t}\n\n\t\t\treturn arr\n\t\t}, [] as IStaticFilesMapArray<N>)\n\t;\n\n\t// Combine remapped entries with original entries and remove duplicates / 合併重新映射的條目與原始條目並移除重複項\n\treturn array_unique_overwrite(arr.concat(ls as any)) as IStaticFilesMapArray<IStaticFilesKey<T> | N>\n}\n"]}

package/lib/replaceTargetOfStaticFilesMapArrayEntry.d.ts

@@ -1,2 +1,35 @@
+/**
+ * Replace target of static files map array entry / 替換靜態檔案映射陣列條目的目標
+ *
+ * This module provides a function to replace the target file path in an entry.
+ * 此模組提供替換條目中目標檔案路徑的函數。
+ *
+ * @module replaceTargetOfStaticFilesMapArrayEntry
+ */
 import { IStaticFilesMapArrayEntry } from './types';
+/**
+ * Replace the target file path in a static files map entry / 替換靜態檔案映射條目中的目標檔案路徑
+ *
+ * Creates a new entry with the same source file but a different target file path.
+ * 創建一個具有相同來源檔案但不同目標檔案路徑的新條目。
+ *
+ * @template K - The new target file path type / 新目標檔案路徑類型
+ *
+ * @param entry - The original entry / 原始條目
+ * @param targetFile - The new target file path / 新目標檔案路徑
+ *
+ * @returns A new entry with the replaced target file path / 替換目標檔案路徑後的新條目
+ *
+ * @example
+ * ```typescript
+ * import { replaceTargetOfStaticFilesMapArrayEntry } from '@yarn-tool/static-file';
+ *
+ * // Replace target file path
+ * // 替換目標檔案路徑
+ * const original = ['tsconfig.json.tpl', 'file/tsconfig.json.tpl', 'tsconfig.json'];
+ * const newEntry = replaceTargetOfStaticFilesMapArrayEntry(original, 'tsconfig.json');
+ * // Returns: ['tsconfig.json', 'file/tsconfig.json.tpl', 'tsconfig.json']
+ * // 返回：['tsconfig.json', 'file/tsconfig.json.tpl', 'tsconfig.json']
+ * ```
+ */
 export declare function replaceTargetOfStaticFilesMapArrayEntry<K extends string>(entry: IStaticFilesMapArrayEntry<string>, targetFile: K): IStaticFilesMapArrayEntry<K>;

package/lib/replaceTargetOfStaticFilesMapArrayEntry.js

@@ -1,6 +1,31 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.replaceTargetOfStaticFilesMapArrayEntry = replaceTargetOfStaticFilesMapArrayEntry;
+/**
+ * Replace the target file path in a static files map entry / 替換靜態檔案映射條目中的目標檔案路徑
+ *
+ * Creates a new entry with the same source file but a different target file path.
+ * 創建一個具有相同來源檔案但不同目標檔案路徑的新條目。
+ *
+ * @template K - The new target file path type / 新目標檔案路徑類型
+ *
+ * @param entry - The original entry / 原始條目
+ * @param targetFile - The new target file path / 新目標檔案路徑
+ *
+ * @returns A new entry with the replaced target file path / 替換目標檔案路徑後的新條目
+ *
+ * @example
+ * ```typescript
+ * import { replaceTargetOfStaticFilesMapArrayEntry } from '@yarn-tool/static-file';
+ *
+ * // Replace target file path
+ * // 替換目標檔案路徑
+ * const original = ['tsconfig.json.tpl', 'file/tsconfig.json.tpl', 'tsconfig.json'];
+ * const newEntry = replaceTargetOfStaticFilesMapArrayEntry(original, 'tsconfig.json');
+ * // Returns: ['tsconfig.json', 'file/tsconfig.json.tpl', 'tsconfig.json']
+ * // 返回：['tsconfig.json', 'file/tsconfig.json.tpl', 'tsconfig.json']
+ * ```
+ */
 function replaceTargetOfStaticFilesMapArrayEntry(entry, targetFile) {
     return [targetFile, ...entry.slice(1)];
 }

package/lib/replaceTargetOfStaticFilesMapArrayEntry.js.map

@@ -1 +1 @@
-{"version":3,"file":"replaceTargetOfStaticFilesMapArrayEntry.js","sourceRoot":"","sources":["replaceTargetOfStaticFilesMapArrayEntry.ts"],"names":[],"mappings":";;AAEA,0FAGC;AAHD,SAAgB,uCAAuC,CAAmB,KAAwC,EAAE,UAAa;IAEhI,OAAO,CAAC,UAAU,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAiC,CAAA;AACvE,CAAC","sourcesContent":["import { IStaticFilesMapArrayEntry } from './types';\n\nexport function replaceTargetOfStaticFilesMapArrayEntry<K extends string>(entry: IStaticFilesMapArrayEntry<string>, targetFile: K)\n{\n\treturn [targetFile, ...entry.slice(1)] as IStaticFilesMapArrayEntry<K>\n}\n"]}
+{"version":3,"file":"replaceTargetOfStaticFilesMapArrayEntry.js","sourceRoot":"","sources":["replaceTargetOfStaticFilesMapArrayEntry.ts"],"names":[],"mappings":";;AAmCA,0FAGC;AA5BD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,SAAgB,uCAAuC,CAAmB,KAAwC,EAAE,UAAa;IAEhI,OAAO,CAAC,UAAU,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAiC,CAAA;AACvE,CAAC","sourcesContent":["/**\n * Replace target of static files map array entry / 替換靜態檔案映射陣列條目的目標\n *\n * This module provides a function to replace the target file path in an entry.\n * 此模組提供替換條目中目標檔案路徑的函數。\n *\n * @module replaceTargetOfStaticFilesMapArrayEntry\n */\nimport { IStaticFilesMapArrayEntry } from './types';\n\n/**\n * Replace the target file path in a static files map entry / 替換靜態檔案映射條目中的目標檔案路徑\n *\n * Creates a new entry with the same source file but a different target file path.\n * 創建一個具有相同來源檔案但不同目標檔案路徑的新條目。\n *\n * @template K - The new target file path type / 新目標檔案路徑類型\n *\n * @param entry - The original entry / 原始條目\n * @param targetFile - The new target file path / 新目標檔案路徑\n *\n * @returns A new entry with the replaced target file path / 替換目標檔案路徑後的新條目\n *\n * @example\n * ```typescript\n * import { replaceTargetOfStaticFilesMapArrayEntry } from '@yarn-tool/static-file';\n *\n * // Replace target file path\n * // 替換目標檔案路徑\n * const original = ['tsconfig.json.tpl', 'file/tsconfig.json.tpl', 'tsconfig.json'];\n * const newEntry = replaceTargetOfStaticFilesMapArrayEntry(original, 'tsconfig.json');\n * // Returns: ['tsconfig.json', 'file/tsconfig.json.tpl', 'tsconfig.json']\n * // 返回：['tsconfig.json', 'file/tsconfig.json.tpl', 'tsconfig.json']\n * ```\n */\nexport function replaceTargetOfStaticFilesMapArrayEntry<K extends string>(entry: IStaticFilesMapArrayEntry<string>, targetFile: K)\n{\n\treturn [targetFile, ...entry.slice(1)] as IStaticFilesMapArrayEntry<K>\n}\n"]}

package/lib/root/getRootCopyStaticFiles.d.ts

@@ -1,3 +1,57 @@
+/**
+ * Get root copy static files configuration / 獲取根目錄複製靜態檔案配置
+ *
+ * This module provides a function to determine the appropriate static files
+ * to copy based on the project root structure.
+ * 此模組提供根據專案根目錄結構確定要複製的適當靜態檔案的函數。
+ *
+ * @module getRootCopyStaticFiles
+ */
 import { IFindRootReturnType } from '@yarn-tool/find-root';
 import { IStaticFilesMapArray } from '../types';
+/**
+ * Get the appropriate static files map based on root data / 根據根目錄數據獲取適當的靜態檔案映射
+ *
+ * Determines which static files should be copied based on whether the current
+ * directory is the workspace root and whether it has workspaces.
+ * 根據當前目錄是否為工作區根目錄以及是否具有工作區，確定應複製哪些靜態檔案。
+ *
+ * @param rootData - Information about the project root / 關於專案根目錄的資訊
+ * @param rootData.isRoot - Whether the current directory is the workspace root / 當前目錄是否為工作區根目錄
+ * @param rootData.hasWorkspace - Whether the project has workspaces / 專案是否具有工作區
+ *
+ * @returns An array of static file entries to copy / 要複製的靜態檔案條目陣列
+ *
+ * @example
+ * ```typescript
+ * import { getRootCopyStaticFilesAuto } from '@yarn-tool/static-file';
+ *
+ * // For a workspace root with workspaces
+ * // 對於具有工作區的工作區根目錄
+ * const files1 = getRootCopyStaticFilesAuto({
+ *   isRoot: true,
+ *   hasWorkspace: true
+ * });
+ * // Returns only defaultCopyStaticFiles (not root-only files)
+ * // 僅返回 defaultCopyStaticFiles（不包含僅根目錄的檔案）
+ *
+ * // For a standalone project root
+ * // 對於獨立專案根目錄
+ * const files2 = getRootCopyStaticFilesAuto({
+ *   isRoot: true,
+ *   hasWorkspace: false
+ * });
+ * // Returns defaultCopyStaticFiles + defaultCopyStaticFilesRootOnly
+ * // 返回 defaultCopyStaticFiles + defaultCopyStaticFilesRootOnly
+ *
+ * // For a package within a workspace
+ * // 對於工作區內的套件
+ * const files3 = getRootCopyStaticFilesAuto({
+ *   isRoot: false,
+ *   hasWorkspace: true
+ * });
+ * // Returns only defaultCopyStaticFiles
+ * // 僅返回 defaultCopyStaticFiles
+ * ```
+ */
 export declare function getRootCopyStaticFilesAuto(rootData: Pick<IFindRootReturnType, 'isRoot' | 'hasWorkspace'>): IStaticFilesMapArray<string>;

package/lib/root/getRootCopyStaticFiles.js

@@ -2,10 +2,57 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getRootCopyStaticFilesAuto = getRootCopyStaticFilesAuto;
 const const_1 = require("../const");
+/**
+ * Get the appropriate static files map based on root data / 根據根目錄數據獲取適當的靜態檔案映射
+ *
+ * Determines which static files should be copied based on whether the current
+ * directory is the workspace root and whether it has workspaces.
+ * 根據當前目錄是否為工作區根目錄以及是否具有工作區，確定應複製哪些靜態檔案。
+ *
+ * @param rootData - Information about the project root / 關於專案根目錄的資訊
+ * @param rootData.isRoot - Whether the current directory is the workspace root / 當前目錄是否為工作區根目錄
+ * @param rootData.hasWorkspace - Whether the project has workspaces / 專案是否具有工作區
+ *
+ * @returns An array of static file entries to copy / 要複製的靜態檔案條目陣列
+ *
+ * @example
+ * ```typescript
+ * import { getRootCopyStaticFilesAuto } from '@yarn-tool/static-file';
+ *
+ * // For a workspace root with workspaces
+ * // 對於具有工作區的工作區根目錄
+ * const files1 = getRootCopyStaticFilesAuto({
+ *   isRoot: true,
+ *   hasWorkspace: true
+ * });
+ * // Returns only defaultCopyStaticFiles (not root-only files)
+ * // 僅返回 defaultCopyStaticFiles（不包含僅根目錄的檔案）
+ *
+ * // For a standalone project root
+ * // 對於獨立專案根目錄
+ * const files2 = getRootCopyStaticFilesAuto({
+ *   isRoot: true,
+ *   hasWorkspace: false
+ * });
+ * // Returns defaultCopyStaticFiles + defaultCopyStaticFilesRootOnly
+ * // 返回 defaultCopyStaticFiles + defaultCopyStaticFilesRootOnly
+ *
+ * // For a package within a workspace
+ * // 對於工作區內的套件
+ * const files3 = getRootCopyStaticFilesAuto({
+ *   isRoot: false,
+ *   hasWorkspace: true
+ * });
+ * // Returns only defaultCopyStaticFiles
+ * // 僅返回 defaultCopyStaticFiles
+ * ```
+ */
 function getRootCopyStaticFilesAuto(rootData) {
+    // Start with default package-level files / 從預設套件層級檔案開始
     let file_map = [
         ...const_1.defaultCopyStaticFiles,
     ];
+    // Add root-only files if this is the root and has no workspaces / 如果這是根目錄且沒有工作區，則添加僅根目錄的檔案
     if (rootData.isRoot) {
         if (!rootData.hasWorkspace) {
             file_map = [

package/lib/root/getRootCopyStaticFiles.js.map

@@ -1 +1 @@
-{"version":3,"file":"getRootCopyStaticFiles.js","sourceRoot":"","sources":["getRootCopyStaticFiles.ts"],"names":[],"mappings":";;AAIA,gEAkBC;AApBD,oCAAkF;AAElF,SAAgB,0BAA0B,CAAC,QAA6D;IAEvG,IAAI,QAAQ,GAAiC;QAC5C,GAAG,8BAAsB;KACzB,CAAC;IAEF,IAAI,QAAQ,CAAC,MAAM,EACnB,CAAC;QACA,IAAI,CAAC,QAAQ,CAAC,YAAY,EAC1B,CAAC;YACA,QAAQ,GAAG;gBACV,GAAG,QAAQ;gBACX,GAAG,sCAA8B;aACjC,CAAC;QACH,CAAC;IACF,CAAC;IAED,OAAO,QAAQ,CAAA;AAChB,CAAC","sourcesContent":["import { IFindRootReturnType } from '@yarn-tool/find-root';\nimport { IStaticFilesMapArray } from '../types';\nimport { defaultCopyStaticFiles, defaultCopyStaticFilesRootOnly } from '../const';\n\nexport function getRootCopyStaticFilesAuto(rootData: Pick<IFindRootReturnType, 'isRoot'| 'hasWorkspace'>)\n{\n\tlet file_map: IStaticFilesMapArray<string> = [\n\t\t...defaultCopyStaticFiles,\n\t];\n\n\tif (rootData.isRoot)\n\t{\n\t\tif (!rootData.hasWorkspace)\n\t\t{\n\t\t\tfile_map = [\n\t\t\t\t...file_map,\n\t\t\t\t...defaultCopyStaticFilesRootOnly,\n\t\t\t];\n\t\t}\n\t}\n\n\treturn file_map\n}\n"]}
+{"version":3,"file":"getRootCopyStaticFiles.js","sourceRoot":"","sources":["getRootCopyStaticFiles.ts"],"names":[],"mappings":";;AA0DA,gEAoBC;AAnED,oCAAkF;AAElF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,SAAgB,0BAA0B,CAAC,QAA6D;IAEvG,uDAAuD;IACvD,IAAI,QAAQ,GAAiC;QAC5C,GAAG,8BAAsB;KACzB,CAAC;IAEF,2FAA2F;IAC3F,IAAI,QAAQ,CAAC,MAAM,EACnB,CAAC;QACA,IAAI,CAAC,QAAQ,CAAC,YAAY,EAC1B,CAAC;YACA,QAAQ,GAAG;gBACV,GAAG,QAAQ;gBACX,GAAG,sCAA8B;aACjC,CAAC;QACH,CAAC;IACF,CAAC;IAED,OAAO,QAAQ,CAAA;AAChB,CAAC","sourcesContent":["/**\n * Get root copy static files configuration / 獲取根目錄複製靜態檔案配置\n *\n * This module provides a function to determine the appropriate static files\n * to copy based on the project root structure.\n * 此模組提供根據專案根目錄結構確定要複製的適當靜態檔案的函數。\n *\n * @module getRootCopyStaticFiles\n */\nimport { IFindRootReturnType } from '@yarn-tool/find-root';\nimport { IStaticFilesMapArray } from '../types';\nimport { defaultCopyStaticFiles, defaultCopyStaticFilesRootOnly } from '../const';\n\n/**\n * Get the appropriate static files map based on root data / 根據根目錄數據獲取適當的靜態檔案映射\n *\n * Determines which static files should be copied based on whether the current\n * directory is the workspace root and whether it has workspaces.\n * 根據當前目錄是否為工作區根目錄以及是否具有工作區，確定應複製哪些靜態檔案。\n *\n * @param rootData - Information about the project root / 關於專案根目錄的資訊\n * @param rootData.isRoot - Whether the current directory is the workspace root / 當前目錄是否為工作區根目錄\n * @param rootData.hasWorkspace - Whether the project has workspaces / 專案是否具有工作區\n *\n * @returns An array of static file entries to copy / 要複製的靜態檔案條目陣列\n *\n * @example\n * ```typescript\n * import { getRootCopyStaticFilesAuto } from '@yarn-tool/static-file';\n *\n * // For a workspace root with workspaces\n * // 對於具有工作區的工作區根目錄\n * const files1 = getRootCopyStaticFilesAuto({\n *   isRoot: true,\n *   hasWorkspace: true\n * });\n * // Returns only defaultCopyStaticFiles (not root-only files)\n * // 僅返回 defaultCopyStaticFiles（不包含僅根目錄的檔案）\n *\n * // For a standalone project root\n * // 對於獨立專案根目錄\n * const files2 = getRootCopyStaticFilesAuto({\n *   isRoot: true,\n *   hasWorkspace: false\n * });\n * // Returns defaultCopyStaticFiles + defaultCopyStaticFilesRootOnly\n * // 返回 defaultCopyStaticFiles + defaultCopyStaticFilesRootOnly\n *\n * // For a package within a workspace\n * // 對於工作區內的套件\n * const files3 = getRootCopyStaticFilesAuto({\n *   isRoot: false,\n *   hasWorkspace: true\n * });\n * // Returns only defaultCopyStaticFiles\n * // 僅返回 defaultCopyStaticFiles\n * ```\n */\nexport function getRootCopyStaticFilesAuto(rootData: Pick<IFindRootReturnType, 'isRoot'| 'hasWorkspace'>)\n{\n\t// Start with default package-level files / 從預設套件層級檔案開始\n\tlet file_map: IStaticFilesMapArray<string> = [\n\t\t...defaultCopyStaticFiles,\n\t];\n\n\t// Add root-only files if this is the root and has no workspaces / 如果這是根目錄且沒有工作區，則添加僅根目錄的檔案\n\tif (rootData.isRoot)\n\t{\n\t\tif (!rootData.hasWorkspace)\n\t\t{\n\t\t\tfile_map = [\n\t\t\t\t...file_map,\n\t\t\t\t...defaultCopyStaticFilesRootOnly,\n\t\t\t];\n\t\t}\n\t}\n\n\treturn file_map\n}\n"]}