@yarn-tool/static-file 3.0.4 → 3.0.6

package/lib/const.d.ts

@@ -1,8 +1,62 @@
+/**
+ * Static file mapping constants / 靜態檔案映射常量
+ *
+ * This module defines the default static file mappings for different project scenarios.
+ * 此模組定義了不同專案情境的預設靜態檔案映射。
+ *
+ * @module const
+ */
 import { _Key, IStaticFilesMapArray } from './types';
-declare const _defaultCopyStaticFiles: [[".npmignore", "file/npmignore"], [".gitignore", "file/gitignore"], [".eslintignore", "file/eslintignore"], [".nvmrc", "file/nvmrc"], [".browserslistrc", "file/browserslistrc"], ["tsconfig.json.tpl", "file/tsconfig.json.tpl", "tsconfig.json"], ["test/tsconfig.json.tpl", "file/test/tsconfig.json.tpl", "test/tsconfig.json"], ["tsconfig.esm.json.tpl", "file/tsconfig.esm.json.tpl", "tsconfig.esm.json"], ["tsconfig.tsdx.json.tpl", "file/tsconfig.tsdx.json.tpl", "tsconfig.tsdx.json"], [".eslintrc.json.tpl", "file/eslintrc.json.tpl", ".eslintrc.json"], ["README.md", "file/README.md"], [".nycrc.tpl", "file/nycrc"], [".mocharc.yml.tpl", "file/mocharc.yml"], ["jest.config.js", "file/jest.config.auto.js"], [".nowignore", "file/nowignore"], ["now.json.tpl", "file/now.json.tpl", "now.json"], [".npmrc.tpl", "file/npmrc", ".npmrc"], ["tsdx.config.js.tpl", "file/tsdx.config.js", "tsdx.config.js"], ["tsc-multi.json.tpl", "file/tsc-multi.json.tpl", "tsc-multi.json"], ["test/__root.ts", "file/test/__root.ts"], ["test/fixtures/.gitkeep", "file/test/fixtures/.gitkeep"], ...["test/temp.ts", "file/test/temp.ts"][]];
-declare const _defaultCopyStaticFilesRootOnly: [["lerna.json.tpl", "file/lerna.json.tpl", "lerna.json"], ["pnpm-workspace.yaml.tpl", "file/pnpm-workspace.yaml", "pnpm-workspace.yaml"], [".github/workflows/coverage.yml", "file/github/workflows/coverage.yml"], [".github/workflows/action-yarnlock-dedupe.yml", "file/github/workflows/action-yarnlock-dedupe.yml"], [".github/workflows/build.yml", "file/github/workflows/build.yml"], [".github/workflows/yarn-lock-changes.yml", "file/github/workflows/yarn-lock-changes.yml"], [".github/commit-convention.md", "file/github/commit-convention.md"], ...[".github/dependabot.yml" | ".github/workflows/codeql-analysis.yml" | ".github/workflows/cmd-rebase.yml", "file/github/dependabot.yml" | "file/github/workflows/codeql-analysis.yml" | "file/github/workflows/cmd-rebase.yml"][], [".node-version", "file/node-version"], ["tsconfig.json", "file/tsconfig.json.tpl", "tsconfig.json"], [".eslintrc.json", "file/eslintrc.json.tpl", ".eslintrc.json"], [".yarnrc.yml.tpl", "file/root/yarnrc.yml", ".yarnrc.yml"], ["jest.config.js", "file/jest.config.js"], ["jest.config.js.tpl", "file/jest.config.js"], ["jest.config.auto.js.tpl", "file/jest.config.auto.js"], [".editorconfig.tpl", "file/tpl.editorconfig"], [".editorconfig", "file/tpl.editorconfig"], ["global.tsdx.d.ts", "file/root/global.tsdx.d.ts"]];
-declare const _defaultCopyStaticFilesWsRootOnly: [["lerna.json.tpl", "file/lerna.json.tpl"], ["pnpm-workspace.yaml", "file/pnpm-workspace.yaml"], ["tsconfig.json", "file/tsconfig.json.tpl"], ["tsc-multi.json.tpl", "file/tsc-multi.json.tpl", "tsc-multi.json"], ["__root_ws.ts", "file/ws-root/__root_ws.ts"], ["jest.config.js", "file/ws-root/jest.config.js"], ["jest-preset.js", "file/ws-root/jest-preset.js"], [".run/lerna_publish_yes.run.xml", "file/ws-root/.run/lerna_publish_yes.run.xml"]];
+/**
+ * Default static files for package-level copying / 套件層級複製的預設靜態檔案
+ *
+ * Contains common configuration files that should be copied to each package.
+ * 包含應複製到每個套件的常用配置檔案。
+ *
+ * Each entry follows the format: [targetFile, staticFile, detectFile?]
+ * 每個條目遵循格式：[目標檔案, 靜態檔案, 檢測檔案?]
+ *
+ * - targetFile: The destination file path / 目標檔案路徑
+ * - staticFile: The source static file path (relative to static root) / 來源靜態檔案路徑（相對於靜態根目錄）
+ * - detectFile: Optional file to check for existence before copying / 可選的檢測檔案，複製前檢查是否存在
+ */
+declare const _defaultCopyStaticFiles: [[".npmignore", "file/npmignore"], [".gitignore", "file/gitignore"], [".eslintignore", "file/eslintignore"], ["tsconfig.json.tpl", "file/tsconfig.json.tpl", "tsconfig.json"], ["test/tsconfig.json.tpl", "file/test/tsconfig.json.tpl", "test/tsconfig.json"], ["test/tsconfig.json", "file/test/tsconfig.json.tpl"], ["tsconfig.esm.json.tpl", "file/tsconfig.esm.json.tpl", "tsconfig.esm.json"], ["tsconfig.tsdx.json.tpl", "file/tsconfig.tsdx.json.tpl", "tsconfig.tsdx.json"], ["tsconfig.json", "file/tsconfig.json.tpl"], [".eslintrc.json.tpl", "file/eslintrc.json.tpl", ".eslintrc.json"], ["README.md", "file/README.md"], [".mocharc.yml.tpl", "file/mocharc.yml"], ["jest.config.js", "file/jest.config.auto.js"], [".nowignore", "file/nowignore"], ["now.json.tpl", "file/now.json.tpl", "now.json"], ["tsdx.config.js.tpl", "file/tsdx.config.js", "tsdx.config.js"], ["test/__root.ts", "file/test/__root.ts"], ["test/fixtures/.gitkeep", "file/test/fixtures/.gitkeep"], ...["test/temp.ts", "file/test/temp.ts"][]];
+/**
+ * Default static files for root-level only copying / 僅根目錄層級複製的預設靜態檔案
+ *
+ * Contains configuration files that should only be copied to the workspace root.
+ * 包含僅應複製到工作區根目錄的配置檔案。
+ *
+ * These files are typically shared across all packages in a monorepo.
+ * 這些檔案通常在 monorepo 中的所有套件之間共享。
+ */
+declare const _defaultCopyStaticFilesRootOnly: [["lerna.json.tpl", "file/lerna.json.tpl", "lerna.json"], ["pnpm-workspace.yaml.tpl", "file/pnpm-workspace.yaml", "pnpm-workspace.yaml"], [".github/workflows/coverage.yml", "file/github/workflows/coverage.yml"], [".github/workflows/action-yarnlock-dedupe.yml", "file/github/workflows/action-yarnlock-dedupe.yml"], [".github/workflows/build.yml", "file/github/workflows/build.yml"], [".github/workflows/yarn-lock-changes.yml", "file/github/workflows/yarn-lock-changes.yml"], [".github/commit-convention.md", "file/github/commit-convention.md"], ...[".github/dependabot.yml" | ".github/workflows/codeql-analysis.yml" | ".github/workflows/cmd-rebase.yml", "file/github/dependabot.yml" | "file/github/workflows/codeql-analysis.yml" | "file/github/workflows/cmd-rebase.yml"][], [".node-version", "file/nvmrc"], [".nvmrc", "file/nvmrc"], [".eslintrc.json", "file/eslintrc.json.tpl", ".eslintrc.json"], [".yarnrc.yml.tpl", "file/root/yarnrc.yml", ".yarnrc.yml"], [".npmrc.tpl", "file/npmrc", ".npmrc"], ["jest.config.js", "file/jest.config.js"], ["jest.config.js.tpl", "file/jest.config.js"], ["jest.config.auto.js.tpl", "file/jest.config.auto.js"], [".editorconfig.tpl", "file/tpl.editorconfig"], [".editorconfig", "file/tpl.editorconfig"], ["global.tsdx.d.ts", "file/root/global.tsdx.d.ts"], [".browserslistrc", "file/ws-root/browserslistrc"], ["tsc-multi.json.tpl", "file/tsc-multi.json.tpl", "tsc-multi.json"], [".nycrc.tpl", "file/nycrc"]];
+/**
+ * Default static files for workspace root only / 僅工作區根目錄的預設靜態檔案
+ *
+ * Contains files specific to workspace root management.
+ * 包含特定於工作區根目錄管理的檔案。
+ */
+declare const _defaultCopyStaticFilesWsRootOnly: [["lerna.json.tpl", "file/lerna.json.tpl"], ["pnpm-workspace.yaml", "file/pnpm-workspace.yaml"], ["tsc-multi.json.tpl", "file/tsc-multi.json.tpl", "tsc-multi.json"], ["__root_ws.ts", "file/ws-root/__root_ws.ts"], ["jest.config.js", "file/ws-root/jest.config.js"], ["jest-preset.js", "file/ws-root/jest-preset.js"], [".run/lerna_publish_yes.run.xml", "file/ws-root/.run/lerna_publish_yes.run.xml"]];
+/**
+ * Frozen default static files for package-level / 凍結的套件層級預設靜態檔案
+ *
+ * Use this for copying static files to individual packages.
+ * 用於將靜態檔案複製到各個套件。
+ */
 export declare const defaultCopyStaticFiles: IStaticFilesMapArray<_Key<typeof _defaultCopyStaticFiles>>;
+/**
+ * Frozen default static files for root-level only / 凍結的僅根目錄層級預設靜態檔案
+ *
+ * Use this for copying static files to the workspace root only.
+ * 用於將靜態檔案僅複製到工作區根目錄。
+ */
 export declare const defaultCopyStaticFilesRootOnly: IStaticFilesMapArray<_Key<typeof _defaultCopyStaticFilesRootOnly>>;
+/**
+ * Frozen default static files for workspace root / 凍結的工作區根目錄預設靜態檔案
+ *
+ * Use this for workspace root specific file management.
+ * 用於工作區根目錄特定的檔案管理。
+ */
 export declare const defaultCopyStaticFilesWsRootOnly: IStaticFilesMapArray<_Key<typeof _defaultCopyStaticFilesWsRootOnly>>;
 export {};

package/lib/const.js

@@ -1,29 +1,48 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.defaultCopyStaticFilesWsRootOnly = exports.defaultCopyStaticFilesRootOnly = exports.defaultCopyStaticFiles = void 0;
+/**
+ * Default static files for package-level copying / 套件層級複製的預設靜態檔案
+ *
+ * Contains common configuration files that should be copied to each package.
+ * 包含應複製到每個套件的常用配置檔案。
+ *
+ * Each entry follows the format: [targetFile, staticFile, detectFile?]
+ * 每個條目遵循格式：[目標檔案, 靜態檔案, 檢測檔案?]
+ *
+ * - targetFile: The destination file path / 目標檔案路徑
+ * - staticFile: The source static file path (relative to static root) / 來源靜態檔案路徑（相對於靜態根目錄）
+ * - detectFile: Optional file to check for existence before copying / 可選的檢測檔案，複製前檢查是否存在
+ */
 const _defaultCopyStaticFiles = [
+    // Ignore files / 忽略檔案
     ['.npmignore', 'file/npmignore'],
     ['.gitignore', 'file/gitignore'],
     ['.eslintignore', 'file/eslintignore'],
-    ['.nvmrc', 'file/nvmrc'],
-    ['.browserslistrc', 'file/browserslistrc'],
+    // TypeScript configuration / TypeScript 配置
     ['tsconfig.json.tpl', 'file/tsconfig.json.tpl', 'tsconfig.json'],
     ['test/tsconfig.json.tpl', 'file/test/tsconfig.json.tpl', 'test/tsconfig.json'],
+    ['test/tsconfig.json', 'file/test/tsconfig.json.tpl'],
     ['tsconfig.esm.json.tpl', 'file/tsconfig.esm.json.tpl', 'tsconfig.esm.json'],
     ['tsconfig.tsdx.json.tpl', 'file/tsconfig.tsdx.json.tpl', 'tsconfig.tsdx.json'],
+    ['tsconfig.json', 'file/tsconfig.json.tpl'],
+    // ESLint configuration / ESLint 配置
     ['.eslintrc.json.tpl', 'file/eslintrc.json.tpl', '.eslintrc.json'],
+    // Documentation / 文檔
     ['README.md', 'file/README.md'],
-    ['.nycrc.tpl', 'file/nycrc'],
+    // Test configuration / 測試配置
     ['.mocharc.yml.tpl', 'file/mocharc.yml'],
     //['jest.config.js', 'file/jest.config.js'],
     ['jest.config.js', 'file/jest.config.auto.js'],
+    // Now/Zeit deployment / Now/Zeit 部署配置
     ['.nowignore', 'file/nowignore'],
     ['now.json.tpl', 'file/now.json.tpl', 'now.json'],
-    ['.npmrc.tpl', 'file/npmrc', '.npmrc'],
+    // TSDX configuration / TSDX 配置
     ['tsdx.config.js.tpl', 'file/tsdx.config.js', 'tsdx.config.js'],
-    ['tsc-multi.json.tpl', 'file/tsc-multi.json.tpl', 'tsc-multi.json'],
+    // Test fixtures / 測試固定檔案
     ['test/__root.ts', 'file/test/__root.ts'],
     ['test/fixtures/.gitkeep', 'file/test/fixtures/.gitkeep'],
+    // Temporary test files / 臨時測試檔案
     ...([
         'temp.ts',
     ].map(file => [
@@ -32,42 +51,96 @@ const _defaultCopyStaticFiles = [
     ])),
     //['changelog-option.js.tpl', 'file/changelog-option.js', 'changelog-option.js'],
 ];
+/**
+ * Default static files for root-level only copying / 僅根目錄層級複製的預設靜態檔案
+ *
+ * Contains configuration files that should only be copied to the workspace root.
+ * 包含僅應複製到工作區根目錄的配置檔案。
+ *
+ * These files are typically shared across all packages in a monorepo.
+ * 這些檔案通常在 monorepo 中的所有套件之間共享。
+ */
 const _defaultCopyStaticFilesRootOnly = [
+    // Monorepo configuration / Monorepo 配置
     ['lerna.json.tpl', 'file/lerna.json.tpl', 'lerna.json'],
     ['pnpm-workspace.yaml.tpl', 'file/pnpm-workspace.yaml', 'pnpm-workspace.yaml'],
+    // GitHub Actions workflows / GitHub Actions 工作流程
     ['.github/workflows/coverage.yml', 'file/github/workflows/coverage.yml'],
     ['.github/workflows/action-yarnlock-dedupe.yml', 'file/github/workflows/action-yarnlock-dedupe.yml'],
     ['.github/workflows/build.yml', 'file/github/workflows/build.yml'],
     ['.github/workflows/yarn-lock-changes.yml', 'file/github/workflows/yarn-lock-changes.yml'],
     ['.github/commit-convention.md', 'file/github/commit-convention.md'],
+    // Additional GitHub configuration / 額外的 GitHub 配置
     ...([
         'dependabot.yml',
         'workflows/codeql-analysis.yml',
         'workflows/cmd-rebase.yml',
     ].map(file => [`.github/${file}`, `file/github/${file}`])),
-    ['.node-version', 'file/node-version'],
-    ['tsconfig.json', 'file/tsconfig.json.tpl', 'tsconfig.json'],
+    // Node version files / Node 版本檔案
+    ['.node-version', 'file/nvmrc'],
+    ['.nvmrc', 'file/nvmrc'],
+    // Root TypeScript configuration / 根目錄 TypeScript 配置
     ['.eslintrc.json', 'file/eslintrc.json.tpl', '.eslintrc.json'],
     //['changelog-option.js', 'file/changelog-option.js', 'changelog-option.js.tpl'],
+    // Package manager configuration / 套件管理器配置
     ['.yarnrc.yml.tpl', 'file/root/yarnrc.yml', '.yarnrc.yml'],
+    ['.npmrc.tpl', 'file/npmrc', '.npmrc'],
+    // Jest configuration / Jest 配置
     ['jest.config.js', 'file/jest.config.js'],
     ['jest.config.js.tpl', 'file/jest.config.js'],
     ['jest.config.auto.js.tpl', 'file/jest.config.auto.js'],
+    // Editor configuration / 編輯器配置
     ['.editorconfig.tpl', 'file/tpl.editorconfig'],
     ['.editorconfig', 'file/tpl.editorconfig'],
+    // Global type declarations / 全局類型聲明
     ['global.tsdx.d.ts', 'file/root/global.tsdx.d.ts'],
+    // Browserslist configuration / Browserslist 配置
+    ['.browserslistrc', 'file/ws-root/browserslistrc'],
+    // TSC multi configuration / TSC 多配置
+    ['tsc-multi.json.tpl', 'file/tsc-multi.json.tpl', 'tsc-multi.json'],
+    // NYC coverage configuration / NYC 覆蓋率配置
+    ['.nycrc.tpl', 'file/nycrc'],
 ];
+/**
+ * Default static files for workspace root only / 僅工作區根目錄的預設靜態檔案
+ *
+ * Contains files specific to workspace root management.
+ * 包含特定於工作區根目錄管理的檔案。
+ */
 const _defaultCopyStaticFilesWsRootOnly = [
+    // Lerna configuration / Lerna 配置
     ['lerna.json.tpl', 'file/lerna.json.tpl'],
+    // pnpm workspace configuration / pnpm 工作區配置
     ['pnpm-workspace.yaml', 'file/pnpm-workspace.yaml'],
-    ['tsconfig.json', 'file/tsconfig.json.tpl'],
+    // TSC multi configuration / TSC 多配置
     ['tsc-multi.json.tpl', 'file/tsc-multi.json.tpl', 'tsc-multi.json'],
+    // Workspace root file / 工作區根目錄檔案
     ['__root_ws.ts', 'file/ws-root/__root_ws.ts'],
+    // Jest configuration / Jest 配置
     ['jest.config.js', 'file/ws-root/jest.config.js'],
     ['jest-preset.js', 'file/ws-root/jest-preset.js'],
+    // Run configurations / 執行配置
     ['.run/lerna_publish_yes.run.xml', 'file/ws-root/.run/lerna_publish_yes.run.xml'],
 ];
+/**
+ * Frozen default static files for package-level / 凍結的套件層級預設靜態檔案
+ *
+ * Use this for copying static files to individual packages.
+ * 用於將靜態檔案複製到各個套件。
+ */
 exports.defaultCopyStaticFiles = Object.freeze(_defaultCopyStaticFiles);
+/**
+ * Frozen default static files for root-level only / 凍結的僅根目錄層級預設靜態檔案
+ *
+ * Use this for copying static files to the workspace root only.
+ * 用於將靜態檔案僅複製到工作區根目錄。
+ */
 exports.defaultCopyStaticFilesRootOnly = Object.freeze(_defaultCopyStaticFilesRootOnly);
+/**
+ * Frozen default static files for workspace root / 凍結的工作區根目錄預設靜態檔案
+ *
+ * Use this for workspace root specific file management.
+ * 用於工作區根目錄特定的檔案管理。
+ */
 exports.defaultCopyStaticFilesWsRootOnly = Object.freeze(_defaultCopyStaticFilesWsRootOnly);
 //# sourceMappingURL=const.js.map

package/lib/const.js.map

@@ -1 +1 @@
-{"version":3,"file":"const.js","sourceRoot":"","sources":["const.ts"],"names":[],"mappings":"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","sourcesContent":["import { _Key, IStaticFilesKey, IStaticFilesMapArray, IStaticFilesMapArrayEntry } from './types';\n\nconst _defaultCopyStaticFiles = [\n\n\t['.npmignore', 'file/npmignore'],\n\t['.gitignore', 'file/gitignore'],\n\n\t['.eslintignore', 'file/eslintignore'],\n\n\t['.nvmrc', 'file/nvmrc'],\n\t['.browserslistrc', 'file/browserslistrc'],\n\n\t['tsconfig.json.tpl', 'file/tsconfig.json.tpl', 'tsconfig.json'],\n\n\t['test/tsconfig.json.tpl', 'file/test/tsconfig.json.tpl', 'test/tsconfig.json'],\n\n\t['tsconfig.esm.json.tpl', 'file/tsconfig.esm.json.tpl', 'tsconfig.esm.json'],\n\n\t['tsconfig.tsdx.json.tpl', 'file/tsconfig.tsdx.json.tpl', 'tsconfig.tsdx.json'],\n\n\t['.eslintrc.json.tpl', 'file/eslintrc.json.tpl', '.eslintrc.json'],\n\n\t['README.md', 'file/README.md'],\n\n\t['.nycrc.tpl', 'file/nycrc'],\n\n\t['.mocharc.yml.tpl', 'file/mocharc.yml'],\n\t//['jest.config.js', 'file/jest.config.js'],\n\t['jest.config.js', 'file/jest.config.auto.js'],\n\n\t['.nowignore', 'file/nowignore'],\n\n\t['now.json.tpl', 'file/now.json.tpl', 'now.json'],\n\n\t['.npmrc.tpl', 'file/npmrc', '.npmrc'],\n\n\t['tsdx.config.js.tpl', 'file/tsdx.config.js', 'tsdx.config.js'],\n\n\t['tsc-multi.json.tpl', 'file/tsc-multi.json.tpl', 'tsc-multi.json'],\n\n\t['test/__root.ts', 'file/test/__root.ts'],\n\t['test/fixtures/.gitkeep', 'file/test/fixtures/.gitkeep'],\n\n\t...(([\n\t\t'temp.ts',\n\t] as const).map(file => [\n\t\t`test/${file}`,\n\t\t`file/test/${file}`\n\t] as const satisfies IStaticFilesMapArrayEntry<string>)),\n\n\t//['changelog-option.js.tpl', 'file/changelog-option.js', 'changelog-option.js'],\n\n] as const satisfies IStaticFilesMapArray<string>;\n\nconst _defaultCopyStaticFilesRootOnly = [\n\n\t['lerna.json.tpl', 'file/lerna.json.tpl', 'lerna.json'],\n\n\t['pnpm-workspace.yaml.tpl', 'file/pnpm-workspace.yaml', 'pnpm-workspace.yaml'],\n\n\t['.github/workflows/coverage.yml', 'file/github/workflows/coverage.yml'],\n\n\t['.github/workflows/action-yarnlock-dedupe.yml', 'file/github/workflows/action-yarnlock-dedupe.yml'],\n\n\t['.github/workflows/build.yml', 'file/github/workflows/build.yml'],\n\n\t['.github/workflows/yarn-lock-changes.yml', 'file/github/workflows/yarn-lock-changes.yml'],\n\n\t['.github/commit-convention.md', 'file/github/commit-convention.md'],\n\n\t...(([\n\t\t'dependabot.yml',\n\t\t'workflows/codeql-analysis.yml',\n\t\t'workflows/cmd-rebase.yml',\n\t] as const).map(file => [`.github/${file}`, `file/github/${file}`] as const satisfies IStaticFilesMapArrayEntry<string>)),\n\n\t['.node-version', 'file/node-version'],\n\n\t['tsconfig.json', 'file/tsconfig.json.tpl', 'tsconfig.json'],\n\n\t['.eslintrc.json', 'file/eslintrc.json.tpl', '.eslintrc.json'],\n\n\t//['changelog-option.js', 'file/changelog-option.js', 'changelog-option.js.tpl'],\n\n\t['.yarnrc.yml.tpl', 'file/root/yarnrc.yml', '.yarnrc.yml'],\n\n\t['jest.config.js', 'file/jest.config.js'],\n\n\t['jest.config.js.tpl', 'file/jest.config.js'],\n\t['jest.config.auto.js.tpl', 'file/jest.config.auto.js'],\n\n\t['.editorconfig.tpl', 'file/tpl.editorconfig'],\n\t['.editorconfig', 'file/tpl.editorconfig'],\n\n\t['global.tsdx.d.ts', 'file/root/global.tsdx.d.ts'],\n\n] as const satisfies IStaticFilesMapArray<string>;\n\nconst _defaultCopyStaticFilesWsRootOnly = [\n\n\t['lerna.json.tpl', 'file/lerna.json.tpl'],\n\n\t['pnpm-workspace.yaml', 'file/pnpm-workspace.yaml'],\n\n\t['tsconfig.json', 'file/tsconfig.json.tpl'],\n\n\t['tsc-multi.json.tpl', 'file/tsc-multi.json.tpl', 'tsc-multi.json'],\n\n\t['__root_ws.ts', 'file/ws-root/__root_ws.ts'],\n\n\t['jest.config.js', 'file/ws-root/jest.config.js'],\n\t['jest-preset.js', 'file/ws-root/jest-preset.js'],\n\n\t['.run/lerna_publish_yes.run.xml', 'file/ws-root/.run/lerna_publish_yes.run.xml'],\n\n] as const satisfies IStaticFilesMapArray<string>;\n\nexport const defaultCopyStaticFiles = Object.freeze(_defaultCopyStaticFiles) as any as IStaticFilesMapArray<_Key<typeof _defaultCopyStaticFiles>>;\n\nexport const defaultCopyStaticFilesRootOnly = Object.freeze(_defaultCopyStaticFilesRootOnly) as any as IStaticFilesMapArray<_Key<typeof _defaultCopyStaticFilesRootOnly>>;\n\nexport const defaultCopyStaticFilesWsRootOnly = Object.freeze(_defaultCopyStaticFilesWsRootOnly) as any as IStaticFilesMapArray<_Key<typeof _defaultCopyStaticFilesWsRootOnly>>;\n"]}
+{"version":3,"file":"const.js","sourceRoot":"","sources":["const.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Static file mapping constants / 靜態檔案映射常量\n *\n * This module defines the default static file mappings for different project scenarios.\n * 此模組定義了不同專案情境的預設靜態檔案映射。\n *\n * @module const\n */\nimport { _Key, IStaticFilesKey, IStaticFilesMapArray, IStaticFilesMapArrayEntry } from './types';\n\n/**\n * Default static files for package-level copying / 套件層級複製的預設靜態檔案\n *\n * Contains common configuration files that should be copied to each package.\n * 包含應複製到每個套件的常用配置檔案。\n *\n * Each entry follows the format: [targetFile, staticFile, detectFile?]\n * 每個條目遵循格式：[目標檔案, 靜態檔案, 檢測檔案?]\n *\n * - targetFile: The destination file path / 目標檔案路徑\n * - staticFile: The source static file path (relative to static root) / 來源靜態檔案路徑（相對於靜態根目錄）\n * - detectFile: Optional file to check for existence before copying / 可選的檢測檔案，複製前檢查是否存在\n */\nconst _defaultCopyStaticFiles = [\n\n\t// Ignore files / 忽略檔案\n\t['.npmignore', 'file/npmignore'],\n\t['.gitignore', 'file/gitignore'],\n\t['.eslintignore', 'file/eslintignore'],\n\n\t// TypeScript configuration / TypeScript 配置\n\t['tsconfig.json.tpl', 'file/tsconfig.json.tpl', 'tsconfig.json'],\n\n\t['test/tsconfig.json.tpl', 'file/test/tsconfig.json.tpl', 'test/tsconfig.json'],\n\t['test/tsconfig.json', 'file/test/tsconfig.json.tpl'],\n\n\t['tsconfig.esm.json.tpl', 'file/tsconfig.esm.json.tpl', 'tsconfig.esm.json'],\n\t['tsconfig.tsdx.json.tpl', 'file/tsconfig.tsdx.json.tpl', 'tsconfig.tsdx.json'],\n\n\t['tsconfig.json', 'file/tsconfig.json.tpl'],\n\n\t// ESLint configuration / ESLint 配置\n\t['.eslintrc.json.tpl', 'file/eslintrc.json.tpl', '.eslintrc.json'],\n\n\t// Documentation / 文檔\n\t['README.md', 'file/README.md'],\n\n\t// Test configuration / 測試配置\n\t['.mocharc.yml.tpl', 'file/mocharc.yml'],\n\t//['jest.config.js', 'file/jest.config.js'],\n\t['jest.config.js', 'file/jest.config.auto.js'],\n\n\t// Now/Zeit deployment / Now/Zeit 部署配置\n\t['.nowignore', 'file/nowignore'],\n\t['now.json.tpl', 'file/now.json.tpl', 'now.json'],\n\n\t// TSDX configuration / TSDX 配置\n\t['tsdx.config.js.tpl', 'file/tsdx.config.js', 'tsdx.config.js'],\n\n\t// Test fixtures / 測試固定檔案\n\t['test/__root.ts', 'file/test/__root.ts'],\n\t['test/fixtures/.gitkeep', 'file/test/fixtures/.gitkeep'],\n\n\t// Temporary test files / 臨時測試檔案\n\t...(([\n\t\t'temp.ts',\n\t] as const).map(file => [\n\t\t`test/${file}`,\n\t\t`file/test/${file}`\n\t] as const satisfies IStaticFilesMapArrayEntry<string>)),\n\n\t//['changelog-option.js.tpl', 'file/changelog-option.js', 'changelog-option.js'],\n\n] as const satisfies IStaticFilesMapArray<string>;\n\n/**\n * Default static files for root-level only copying / 僅根目錄層級複製的預設靜態檔案\n *\n * Contains configuration files that should only be copied to the workspace root.\n * 包含僅應複製到工作區根目錄的配置檔案。\n *\n * These files are typically shared across all packages in a monorepo.\n * 這些檔案通常在 monorepo 中的所有套件之間共享。\n */\nconst _defaultCopyStaticFilesRootOnly = [\n\n\t// Monorepo configuration / Monorepo 配置\n\t['lerna.json.tpl', 'file/lerna.json.tpl', 'lerna.json'],\n\t['pnpm-workspace.yaml.tpl', 'file/pnpm-workspace.yaml', 'pnpm-workspace.yaml'],\n\n\t// GitHub Actions workflows / GitHub Actions 工作流程\n\t['.github/workflows/coverage.yml', 'file/github/workflows/coverage.yml'],\n\t['.github/workflows/action-yarnlock-dedupe.yml', 'file/github/workflows/action-yarnlock-dedupe.yml'],\n\t['.github/workflows/build.yml', 'file/github/workflows/build.yml'],\n\t['.github/workflows/yarn-lock-changes.yml', 'file/github/workflows/yarn-lock-changes.yml'],\n\t['.github/commit-convention.md', 'file/github/commit-convention.md'],\n\n\t// Additional GitHub configuration / 額外的 GitHub 配置\n\t...(([\n\t\t'dependabot.yml',\n\t\t'workflows/codeql-analysis.yml',\n\t\t'workflows/cmd-rebase.yml',\n\t] as const).map(file => [`.github/${file}`, `file/github/${file}`] as const satisfies IStaticFilesMapArrayEntry<string>)),\n\n\t// Node version files / Node 版本檔案\n\t['.node-version', 'file/nvmrc'],\n\t['.nvmrc', 'file/nvmrc'],\n\n\t// Root TypeScript configuration / 根目錄 TypeScript 配置\n\t['.eslintrc.json', 'file/eslintrc.json.tpl', '.eslintrc.json'],\n\n\t//['changelog-option.js', 'file/changelog-option.js', 'changelog-option.js.tpl'],\n\n\t// Package manager configuration / 套件管理器配置\n\t['.yarnrc.yml.tpl', 'file/root/yarnrc.yml', '.yarnrc.yml'],\n\t['.npmrc.tpl', 'file/npmrc', '.npmrc'],\n\n\t// Jest configuration / Jest 配置\n\t['jest.config.js', 'file/jest.config.js'],\n\t['jest.config.js.tpl', 'file/jest.config.js'],\n\t['jest.config.auto.js.tpl', 'file/jest.config.auto.js'],\n\n\t// Editor configuration / 編輯器配置\n\t['.editorconfig.tpl', 'file/tpl.editorconfig'],\n\t['.editorconfig', 'file/tpl.editorconfig'],\n\n\t// Global type declarations / 全局類型聲明\n\t['global.tsdx.d.ts', 'file/root/global.tsdx.d.ts'],\n\n\t// Browserslist configuration / Browserslist 配置\n\t['.browserslistrc', 'file/ws-root/browserslistrc'],\n\n\t// TSC multi configuration / TSC 多配置\n\t['tsc-multi.json.tpl', 'file/tsc-multi.json.tpl', 'tsc-multi.json'],\n\n\t// NYC coverage configuration / NYC 覆蓋率配置\n\t['.nycrc.tpl', 'file/nycrc'],\n\n] as const satisfies IStaticFilesMapArray<string>;\n\n/**\n * Default static files for workspace root only / 僅工作區根目錄的預設靜態檔案\n *\n * Contains files specific to workspace root management.\n * 包含特定於工作區根目錄管理的檔案。\n */\nconst _defaultCopyStaticFilesWsRootOnly = [\n\n\t// Lerna configuration / Lerna 配置\n\t['lerna.json.tpl', 'file/lerna.json.tpl'],\n\n\t// pnpm workspace configuration / pnpm 工作區配置\n\t['pnpm-workspace.yaml', 'file/pnpm-workspace.yaml'],\n\n\t// TSC multi configuration / TSC 多配置\n\t['tsc-multi.json.tpl', 'file/tsc-multi.json.tpl', 'tsc-multi.json'],\n\n\t// Workspace root file / 工作區根目錄檔案\n\t['__root_ws.ts', 'file/ws-root/__root_ws.ts'],\n\n\t// Jest configuration / Jest 配置\n\t['jest.config.js', 'file/ws-root/jest.config.js'],\n\t['jest-preset.js', 'file/ws-root/jest-preset.js'],\n\n\t// Run configurations / 執行配置\n\t['.run/lerna_publish_yes.run.xml', 'file/ws-root/.run/lerna_publish_yes.run.xml'],\n\n] as const satisfies IStaticFilesMapArray<string>;\n\n/**\n * Frozen default static files for package-level / 凍結的套件層級預設靜態檔案\n *\n * Use this for copying static files to individual packages.\n * 用於將靜態檔案複製到各個套件。\n */\nexport const defaultCopyStaticFiles = Object.freeze(_defaultCopyStaticFiles) as any as IStaticFilesMapArray<_Key<typeof _defaultCopyStaticFiles>>;\n\n/**\n * Frozen default static files for root-level only / 凍結的僅根目錄層級預設靜態檔案\n *\n * Use this for copying static files to the workspace root only.\n * 用於將靜態檔案僅複製到工作區根目錄。\n */\nexport const defaultCopyStaticFilesRootOnly = Object.freeze(_defaultCopyStaticFilesRootOnly) as any as IStaticFilesMapArray<_Key<typeof _defaultCopyStaticFilesRootOnly>>;\n\n/**\n * Frozen default static files for workspace root / 凍結的工作區根目錄預設靜態檔案\n *\n * Use this for workspace root specific file management.\n * 用於工作區根目錄特定的檔案管理。\n */\nexport const defaultCopyStaticFilesWsRootOnly = Object.freeze(_defaultCopyStaticFilesWsRootOnly) as any as IStaticFilesMapArray<_Key<typeof _defaultCopyStaticFilesWsRootOnly>>;\n"]}

package/lib/copyStaticFiles.d.ts

@@ -1,2 +1,52 @@
+/**
+ * Copy static files main function / 複製靜態檔案主函數
+ *
+ * This module provides the main function for copying static files to a target directory.
+ * 此模組提供將靜態檔案複製到目標目錄的主函數。
+ *
+ * @module copyStaticFiles
+ */
 import { ICopyStaticFilesOptions, IStaticFilesMapArrayEntry } from './types';
+/**
+ * Copy static files to a target directory / 將靜態檔案複製到目標目錄
+ *
+ * Copies static files based on the provided file map configuration.
+ * 根據提供的檔案映射配置複製靜態檔案。
+ *
+ * @template K - The target file path type / 目標檔案路徑類型
+ *
+ * @param options - Copy options / 複製選項
+ * @param options.cwd - Current working directory (required) / 當前工作目錄（必填）
+ * @param options.staticRoot - Root directory of static files (defaults to package root) / 靜態檔案根目錄（預設為套件根目錄）
+ * @param options.overwrite - Whether to overwrite existing files / 是否覆蓋已存在的檔案
+ * @param options.file_map - Custom file mapping configuration / 自訂檔案映射配置
+ *
+ * @returns Array of entries that were successfully copied / 成功複製的條目陣列
+ *
+ * @throws {TypeError} When options.cwd is not a valid string / 當 options.cwd 不是有效的字串時
+ * @throws {TypeError} When options.cwd directory does not exist / 當 options.cwd 目錄不存在時
+ * @throws {TypeError} When file_map is invalid / 當 file_map 無效時
+ *
+ * @example
+ * ```typescript
+ * import { copyStaticFiles } from '@yarn-tool/static-file';
+ *
+ * // Copy default static files to current directory
+ * // 複製預設靜態檔案到當前目錄
+ * copyStaticFiles({
+ *   cwd: process.cwd(),
+ *   overwrite: true
+ * });
+ *
+ * // Copy with custom file map
+ * // 使用自訂檔案映射複製
+ * copyStaticFiles({
+ *   cwd: '/path/to/project',
+ *   file_map: [
+ *     ['.gitignore', 'file/gitignore'],
+ *     ['README.md', 'file/README.md']
+ *   ]
+ * });
+ * ```
+ */
 export declare function copyStaticFiles<K extends string>(options: ICopyStaticFilesOptions<K>): IStaticFilesMapArrayEntry<string | K>[];

package/lib/copyStaticFiles.js

@@ -6,20 +6,68 @@ const const_1 = require("./const");
 const parseStaticMap_1 = require("./parseStaticMap");
 const copyStaticFilesEntry_1 = require("./copyStaticFilesEntry");
 const __root_1 = require("../__root");
+/**
+ * Copy static files to a target directory / 將靜態檔案複製到目標目錄
+ *
+ * Copies static files based on the provided file map configuration.
+ * 根據提供的檔案映射配置複製靜態檔案。
+ *
+ * @template K - The target file path type / 目標檔案路徑類型
+ *
+ * @param options - Copy options / 複製選項
+ * @param options.cwd - Current working directory (required) / 當前工作目錄（必填）
+ * @param options.staticRoot - Root directory of static files (defaults to package root) / 靜態檔案根目錄（預設為套件根目錄）
+ * @param options.overwrite - Whether to overwrite existing files / 是否覆蓋已存在的檔案
+ * @param options.file_map - Custom file mapping configuration / 自訂檔案映射配置
+ *
+ * @returns Array of entries that were successfully copied / 成功複製的條目陣列
+ *
+ * @throws {TypeError} When options.cwd is not a valid string / 當 options.cwd 不是有效的字串時
+ * @throws {TypeError} When options.cwd directory does not exist / 當 options.cwd 目錄不存在時
+ * @throws {TypeError} When file_map is invalid / 當 file_map 無效時
+ *
+ * @example
+ * ```typescript
+ * import { copyStaticFiles } from '@yarn-tool/static-file';
+ *
+ * // Copy default static files to current directory
+ * // 複製預設靜態檔案到當前目錄
+ * copyStaticFiles({
+ *   cwd: process.cwd(),
+ *   overwrite: true
+ * });
+ *
+ * // Copy with custom file map
+ * // 使用自訂檔案映射複製
+ * copyStaticFiles({
+ *   cwd: '/path/to/project',
+ *   file_map: [
+ *     ['.gitignore', 'file/gitignore'],
+ *     ['README.md', 'file/README.md']
+ *   ]
+ * });
+ * ```
+ */
 function copyStaticFiles(options) {
     var _a, _b;
+    // Validate cwd parameter / 驗證 cwd 參數
     if (typeof options.cwd !== 'string' || !((_a = options.cwd) === null || _a === void 0 ? void 0 : _a.length) || !options.cwd) {
         throw new TypeError(`options.cwd must is string`);
     }
+    // Check if cwd directory exists / 檢查 cwd 目錄是否存在
     if (!(0, fs_extra_1.pathExistsSync)(options.cwd)) {
         throw new TypeError(`options.cwd not exists`);
     }
+    // Parse the file map / 解析檔案映射
     let ls = (0, parseStaticMap_1.parseStaticMap)((_b = options.file_map) !== null && _b !== void 0 ? _b : const_1.defaultCopyStaticFiles);
+    // Validate parsed file map / 驗證解析後的檔案映射
     if (!ls.length) {
         throw new TypeError(`Invalid file map: ${options.file_map}`);
     }
+    // Determine static root directory / 確定靜態檔案根目錄
     const staticRoot = options.staticRoot || __root_1.__STATIC_ROOT;
     const { cwd, overwrite } = options;
+    // Filter and copy files / 過濾並複製檔案
     return ls.filter((entry) => {
         return (0, copyStaticFilesEntry_1.copyStaticFilesEntry)(entry, cwd, staticRoot, overwrite);
     });

package/lib/copyStaticFiles.js.map

@@ -1 +1 @@
-{"version":3,"file":"copyStaticFiles.js","sourceRoot":"","sources":["copyStaticFiles.ts"],"names":[],"mappings":";;AAQA,0CA2BC;AAlCD,uCAAgG;AAEhG,mCAAiD;AACjD,qDAAkD;AAClD,iEAA8D;AAC9D,sCAA0C;AAE1C,SAAgB,eAAe,CAAmB,OAAmC;;IAEpF,IAAI,OAAO,OAAO,CAAC,GAAG,KAAK,QAAQ,IAAI,CAAC,CAAA,MAAA,OAAO,CAAC,GAAG,0CAAE,MAAM,CAAA,IAAI,CAAC,OAAO,CAAC,GAAG,EAC3E,CAAC;QACA,MAAM,IAAI,SAAS,CAAC,4BAA4B,CAAC,CAAA;IAClD,CAAC;IAED,IAAI,CAAC,IAAA,yBAAc,EAAC,OAAO,CAAC,GAAG,CAAC,EAChC,CAAC;QACA,MAAM,IAAI,SAAS,CAAC,wBAAwB,CAAC,CAAA;IAC9C,CAAC;IAED,IAAI,EAAE,GAAG,IAAA,+BAAc,EAAI,MAAA,OAAO,CAAC,QAAQ,mCAAI,8BAAiD,CAAC,CAAC;IAElG,IAAI,CAAC,EAAE,CAAC,MAAM,EACd,CAAC;QACA,MAAM,IAAI,SAAS,CAAC,qBAAqB,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAA;IAC7D,CAAC;IAED,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,sBAAa,CAAC;IACvD,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC;IAEnC,OAAO,EAAE,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE;QAEzB,OAAO,IAAA,2CAAoB,EAAC,KAAK,EAAE,GAAG,EAAE,UAAU,EAAE,SAAS,CAAC,CAAA;IAC/D,CAAC,CAAC,CACD;AACH,CAAC","sourcesContent":["import { ICopyStaticFilesOptions, IStaticFilesMapArray, IStaticFilesMapArrayEntry } from './types';\nimport { CopyOptionsSync, copySync, ensureDirSync, existsSync, pathExistsSync } from 'fs-extra';\nimport { dirname, resolve } from 'path';\nimport { defaultCopyStaticFiles } from './const';\nimport { parseStaticMap } from './parseStaticMap';\nimport { copyStaticFilesEntry } from './copyStaticFilesEntry';\nimport { __STATIC_ROOT } from '../__root';\n\nexport function copyStaticFiles<K extends string>(options: ICopyStaticFilesOptions<K>)\n{\n\tif (typeof options.cwd !== 'string' || !options.cwd?.length || !options.cwd)\n\t{\n\t\tthrow new TypeError(`options.cwd must is string`)\n\t}\n\n\tif (!pathExistsSync(options.cwd))\n\t{\n\t\tthrow new TypeError(`options.cwd not exists`)\n\t}\n\n\tlet ls = parseStaticMap<K>(options.file_map ?? defaultCopyStaticFiles as IStaticFilesMapArray<K>);\n\n\tif (!ls.length)\n\t{\n\t\tthrow new TypeError(`Invalid file map: ${options.file_map}`)\n\t}\n\n\tconst staticRoot = options.staticRoot || __STATIC_ROOT;\n\tconst { cwd, overwrite } = options;\n\n\treturn ls.filter((entry) =>\n\t\t{\n\t\t\treturn copyStaticFilesEntry(entry, cwd, staticRoot, overwrite)\n\t\t})\n\t\t;\n}\n"]}
+{"version":3,"file":"copyStaticFiles.js","sourceRoot":"","sources":["copyStaticFiles.ts"],"names":[],"mappings":";;AA0DA,0CAiCC;AAlFD,uCAAgG;AAEhG,mCAAiD;AACjD,qDAAkD;AAClD,iEAA8D;AAC9D,sCAA0C;AAE1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,SAAgB,eAAe,CAAmB,OAAmC;;IAEpF,qCAAqC;IACrC,IAAI,OAAO,OAAO,CAAC,GAAG,KAAK,QAAQ,IAAI,CAAC,CAAA,MAAA,OAAO,CAAC,GAAG,0CAAE,MAAM,CAAA,IAAI,CAAC,OAAO,CAAC,GAAG,EAC3E,CAAC;QACA,MAAM,IAAI,SAAS,CAAC,4BAA4B,CAAC,CAAA;IAClD,CAAC;IAED,gDAAgD;IAChD,IAAI,CAAC,IAAA,yBAAc,EAAC,OAAO,CAAC,GAAG,CAAC,EAChC,CAAC;QACA,MAAM,IAAI,SAAS,CAAC,wBAAwB,CAAC,CAAA;IAC9C,CAAC;IAED,8BAA8B;IAC9B,IAAI,EAAE,GAAG,IAAA,+BAAc,EAAI,MAAA,OAAO,CAAC,QAAQ,mCAAI,8BAAiD,CAAC,CAAC;IAElG,wCAAwC;IACxC,IAAI,CAAC,EAAE,CAAC,MAAM,EACd,CAAC;QACA,MAAM,IAAI,SAAS,CAAC,qBAAqB,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAA;IAC7D,CAAC;IAED,8CAA8C;IAC9C,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,sBAAa,CAAC;IACvD,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC;IAEnC,kCAAkC;IAClC,OAAO,EAAE,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE;QAEzB,OAAO,IAAA,2CAAoB,EAAC,KAAK,EAAE,GAAG,EAAE,UAAU,EAAE,SAAS,CAAC,CAAA;IAC/D,CAAC,CAAC,CACD;AACH,CAAC","sourcesContent":["/**\n * Copy static files main function / 複製靜態檔案主函數\n *\n * This module provides the main function for copying static files to a target directory.\n * 此模組提供將靜態檔案複製到目標目錄的主函數。\n *\n * @module copyStaticFiles\n */\nimport { ICopyStaticFilesOptions, IStaticFilesMapArray, IStaticFilesMapArrayEntry } from './types';\nimport { CopyOptionsSync, copySync, ensureDirSync, existsSync, pathExistsSync } from 'fs-extra';\nimport { dirname, resolve } from 'path';\nimport { defaultCopyStaticFiles } from './const';\nimport { parseStaticMap } from './parseStaticMap';\nimport { copyStaticFilesEntry } from './copyStaticFilesEntry';\nimport { __STATIC_ROOT } from '../__root';\n\n/**\n * Copy static files to a target directory / 將靜態檔案複製到目標目錄\n *\n * Copies static files based on the provided file map configuration.\n * 根據提供的檔案映射配置複製靜態檔案。\n *\n * @template K - The target file path type / 目標檔案路徑類型\n *\n * @param options - Copy options / 複製選項\n * @param options.cwd - Current working directory (required) / 當前工作目錄（必填）\n * @param options.staticRoot - Root directory of static files (defaults to package root) / 靜態檔案根目錄（預設為套件根目錄）\n * @param options.overwrite - Whether to overwrite existing files / 是否覆蓋已存在的檔案\n * @param options.file_map - Custom file mapping configuration / 自訂檔案映射配置\n *\n * @returns Array of entries that were successfully copied / 成功複製的條目陣列\n *\n * @throws {TypeError} When options.cwd is not a valid string / 當 options.cwd 不是有效的字串時\n * @throws {TypeError} When options.cwd directory does not exist / 當 options.cwd 目錄不存在時\n * @throws {TypeError} When file_map is invalid / 當 file_map 無效時\n *\n * @example\n * ```typescript\n * import { copyStaticFiles } from '@yarn-tool/static-file';\n *\n * // Copy default static files to current directory\n * // 複製預設靜態檔案到當前目錄\n * copyStaticFiles({\n *   cwd: process.cwd(),\n *   overwrite: true\n * });\n *\n * // Copy with custom file map\n * // 使用自訂檔案映射複製\n * copyStaticFiles({\n *   cwd: '/path/to/project',\n *   file_map: [\n *     ['.gitignore', 'file/gitignore'],\n *     ['README.md', 'file/README.md']\n *   ]\n * });\n * ```\n */\nexport function copyStaticFiles<K extends string>(options: ICopyStaticFilesOptions<K>)\n{\n\t// Validate cwd parameter / 驗證 cwd 參數\n\tif (typeof options.cwd !== 'string' || !options.cwd?.length || !options.cwd)\n\t{\n\t\tthrow new TypeError(`options.cwd must is string`)\n\t}\n\n\t// Check if cwd directory exists / 檢查 cwd 目錄是否存在\n\tif (!pathExistsSync(options.cwd))\n\t{\n\t\tthrow new TypeError(`options.cwd not exists`)\n\t}\n\n\t// Parse the file map / 解析檔案映射\n\tlet ls = parseStaticMap<K>(options.file_map ?? defaultCopyStaticFiles as IStaticFilesMapArray<K>);\n\n\t// Validate parsed file map / 驗證解析後的檔案映射\n\tif (!ls.length)\n\t{\n\t\tthrow new TypeError(`Invalid file map: ${options.file_map}`)\n\t}\n\n\t// Determine static root directory / 確定靜態檔案根目錄\n\tconst staticRoot = options.staticRoot || __STATIC_ROOT;\n\tconst { cwd, overwrite } = options;\n\n\t// Filter and copy files / 過濾並複製檔案\n\treturn ls.filter((entry) =>\n\t\t{\n\t\t\treturn copyStaticFilesEntry(entry, cwd, staticRoot, overwrite)\n\t\t})\n\t\t;\n}\n"]}

package/lib/copyStaticFilesEntry.d.ts

@@ -1,2 +1,52 @@
+/**
+ * Copy single static file entry / 複製單個靜態檔案條目
+ *
+ * This module provides the function for copying a single static file entry.
+ * 此模組提供複製單個靜態檔案條目的函數。
+ *
+ * @module copyStaticFilesEntry
+ */
 import { IStaticFilesMapArrayEntry } from './types';
+/**
+ * Copy a single static file entry / 複製單個靜態檔案條目
+ *
+ * Copies a single static file from the static root to the target directory.
+ * 從靜態根目錄複製單個靜態檔案到目標目錄。
+ *
+ * @param entry - The static file entry / 靜態檔案條目
+ * @param entry.0 - targetFile: Target file path / 目標檔案路徑
+ * @param entry.1 - staticFile: Source static file path / 來源靜態檔案路徑
+ * @param entry.2 - detectFile: Optional file to check for existence / 可選的檢測檔案
+ *
+ * @param cwd - Current working directory / 當前工作目錄
+ * @param staticRoot - Root directory of static files (defaults to package root) / 靜態檔案根目錄（預設為套件根目錄）
+ * @param overwrite - Whether to overwrite existing files (defaults to false) / 是否覆蓋已存在的檔案（預設為 false）
+ *
+ * @returns true if file was copied, undefined if skipped (detect file exists) / 如果檔案已複製則返回 true，如果跳過（檢測檔案存在）則返回 undefined
+ *
+ * @throws {Error} When the source static file does not exist / 當來源靜態檔案不存在時
+ *
+ * @example
+ * ```typescript
+ * import { copyStaticFilesEntry } from '@yarn-tool/static-file';
+ *
+ * // Copy a single file
+ * // 複製單個檔案
+ * const result = copyStaticFilesEntry(
+ *   ['.gitignore', 'file/gitignore'],
+ *   '/path/to/project',
+ *   '/path/to/static/root',
+ *   false
+ * );
+ *
+ * // With detect file - skips if detect file exists
+ * // 使用檢測檔案 - 如果檢測檔案存在則跳過
+ * const result = copyStaticFilesEntry(
+ *   ['tsconfig.json', 'file/tsconfig.json.tpl', 'tsconfig.json'],
+ *   '/path/to/project'
+ * );
+ * // Skips copy if tsconfig.json already exists in the project
+ * // 如果 tsconfig.json 已存在於專案中則跳過複製
+ * ```
+ */
 export declare function copyStaticFilesEntry(entry: IStaticFilesMapArrayEntry<string>, cwd: string, staticRoot?: string, overwrite?: boolean): boolean;

package/lib/copyStaticFilesEntry.js

@@ -4,20 +4,68 @@ exports.copyStaticFilesEntry = copyStaticFilesEntry;
 const path_1 = require("path");
 const fs_extra_1 = require("fs-extra");
 const __root_1 = require("../__root");
+/**
+ * Copy a single static file entry / 複製單個靜態檔案條目
+ *
+ * Copies a single static file from the static root to the target directory.
+ * 從靜態根目錄複製單個靜態檔案到目標目錄。
+ *
+ * @param entry - The static file entry / 靜態檔案條目
+ * @param entry.0 - targetFile: Target file path / 目標檔案路徑
+ * @param entry.1 - staticFile: Source static file path / 來源靜態檔案路徑
+ * @param entry.2 - detectFile: Optional file to check for existence / 可選的檢測檔案
+ *
+ * @param cwd - Current working directory / 當前工作目錄
+ * @param staticRoot - Root directory of static files (defaults to package root) / 靜態檔案根目錄（預設為套件根目錄）
+ * @param overwrite - Whether to overwrite existing files (defaults to false) / 是否覆蓋已存在的檔案（預設為 false）
+ *
+ * @returns true if file was copied, undefined if skipped (detect file exists) / 如果檔案已複製則返回 true，如果跳過（檢測檔案存在）則返回 undefined
+ *
+ * @throws {Error} When the source static file does not exist / 當來源靜態檔案不存在時
+ *
+ * @example
+ * ```typescript
+ * import { copyStaticFilesEntry } from '@yarn-tool/static-file';
+ *
+ * // Copy a single file
+ * // 複製單個檔案
+ * const result = copyStaticFilesEntry(
+ *   ['.gitignore', 'file/gitignore'],
+ *   '/path/to/project',
+ *   '/path/to/static/root',
+ *   false
+ * );
+ *
+ * // With detect file - skips if detect file exists
+ * // 使用檢測檔案 - 如果檢測檔案存在則跳過
+ * const result = copyStaticFilesEntry(
+ *   ['tsconfig.json', 'file/tsconfig.json.tpl', 'tsconfig.json'],
+ *   '/path/to/project'
+ * );
+ * // Skips copy if tsconfig.json already exists in the project
+ * // 如果 tsconfig.json 已存在於專案中則跳過複製
+ * ```
+ */
 function copyStaticFilesEntry(entry, cwd, staticRoot = __root_1.__STATIC_ROOT, overwrite) {
     const [targetFile, staticFile, detectFile] = entry;
+    // Check if detect file exists - skip copy if it does / 檢查檢測檔案是否存在 - 如果存在則跳過複製
     if (detectFile === null || detectFile === void 0 ? void 0 : detectFile.length) {
         const fc = (0, path_1.resolve)(cwd, detectFile);
         if ((0, fs_extra_1.existsSync)(fc)) {
             return;
         }
     }
+    // Resolve source file path / 解析來源檔案路徑
     const fb = (0, path_1.resolve)(staticRoot, staticFile);
+    // Verify source file exists / 驗證來源檔案是否存在
     if (!(0, fs_extra_1.existsSync)(fb)) {
         throw new Error(`file not exists. ${fb}`);
     }
+    // Resolve target file path / 解析目標檔案路徑
     const fa = (0, path_1.resolve)(cwd, targetFile);
+    // Ensure target directory exists / 確保目標目錄存在
     (0, fs_extra_1.ensureDirSync)((0, path_1.dirname)(fa));
+    // Copy the file / 複製檔案
     (0, fs_extra_1.copySync)(fb, fa, {
         overwrite: overwrite || false,
         preserveTimestamps: true,

package/lib/copyStaticFilesEntry.js.map

@@ -1 +1 @@
-{"version":3,"file":"copyStaticFilesEntry.js","sourceRoot":"","sources":["copyStaticFilesEntry.ts"],"names":[],"mappings":";;AAKA,oDAmCC;AAvCD,+BAAwC;AACxC,uCAA+D;AAC/D,sCAA0C;AAE1C,SAAgB,oBAAoB,CAAC,KAAwC,EAC5E,GAAW,EACX,aAAqB,sBAAa,EAClC,SAAmB;IAGnB,MAAM,CAAC,UAAU,EAAE,UAAU,EAAE,UAAU,CAAC,GAAG,KAAK,CAAC;IAEnD,IAAI,UAAU,aAAV,UAAU,uBAAV,UAAU,CAAE,MAAM,EACtB,CAAC;QACA,MAAM,EAAE,GAAG,IAAA,cAAO,EAAC,GAAG,EAAE,UAAU,CAAC,CAAC;QAEpC,IAAI,IAAA,qBAAU,EAAC,EAAE,CAAC,EAClB,CAAC;YACA,OAAO;QACR,CAAC;IACF,CAAC;IAED,MAAM,EAAE,GAAG,IAAA,cAAO,EAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IAE3C,IAAI,CAAC,IAAA,qBAAU,EAAC,EAAE,CAAC,EACnB,CAAC;QACA,MAAM,IAAI,KAAK,CAAC,oBAAoB,EAAE,EAAE,CAAC,CAAA;IAC1C,CAAC;IAED,MAAM,EAAE,GAAG,IAAA,cAAO,EAAC,GAAG,EAAE,UAAU,CAAC,CAAC;IAEpC,IAAA,wBAAa,EAAC,IAAA,cAAO,EAAC,EAAE,CAAC,CAAC,CAAA;IAC1B,IAAA,mBAAQ,EAAC,EAAE,EAAE,EAAE,EAAE;QAChB,SAAS,EAAE,SAAS,IAAI,KAAK;QAC7B,kBAAkB,EAAE,IAAI;QACxB,YAAY,EAAE,KAAK;KACnB,CAAC,CAAC;IAEH,OAAO,IAAI,CAAC;AACb,CAAC","sourcesContent":["import { IStaticFilesMapArrayEntry } from './types';\nimport { dirname, resolve } from 'path';\nimport { copySync, ensureDirSync, existsSync } from 'fs-extra';\nimport { __STATIC_ROOT } from '../__root';\n\nexport function copyStaticFilesEntry(entry: IStaticFilesMapArrayEntry<string>,\n\tcwd: string,\n\tstaticRoot: string = __STATIC_ROOT,\n\toverwrite?: boolean,\n)\n{\n\tconst [targetFile, staticFile, detectFile] = entry;\n\n\tif (detectFile?.length)\n\t{\n\t\tconst fc = resolve(cwd, detectFile);\n\n\t\tif (existsSync(fc))\n\t\t{\n\t\t\treturn;\n\t\t}\n\t}\n\n\tconst fb = resolve(staticRoot, staticFile);\n\n\tif (!existsSync(fb))\n\t{\n\t\tthrow new Error(`file not exists. ${fb}`)\n\t}\n\n\tconst fa = resolve(cwd, targetFile);\n\n\tensureDirSync(dirname(fa))\n\tcopySync(fb, fa, {\n\t\toverwrite: overwrite || false,\n\t\tpreserveTimestamps: true,\n\t\terrorOnExist: false,\n\t});\n\n\treturn true;\n}\n"]}
+{"version":3,"file":"copyStaticFilesEntry.js","sourceRoot":"","sources":["copyStaticFilesEntry.ts"],"names":[],"mappings":";;AAuDA,oDA0CC;AAxFD,+BAAwC;AACxC,uCAA+D;AAC/D,sCAA0C;AAE1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,SAAgB,oBAAoB,CAAC,KAAwC,EAC5E,GAAW,EACX,aAAqB,sBAAa,EAClC,SAAmB;IAGnB,MAAM,CAAC,UAAU,EAAE,UAAU,EAAE,UAAU,CAAC,GAAG,KAAK,CAAC;IAEnD,8EAA8E;IAC9E,IAAI,UAAU,aAAV,UAAU,uBAAV,UAAU,CAAE,MAAM,EACtB,CAAC;QACA,MAAM,EAAE,GAAG,IAAA,cAAO,EAAC,GAAG,EAAE,UAAU,CAAC,CAAC;QAEpC,IAAI,IAAA,qBAAU,EAAC,EAAE,CAAC,EAClB,CAAC;YACA,OAAO;QACR,CAAC;IACF,CAAC;IAED,sCAAsC;IACtC,MAAM,EAAE,GAAG,IAAA,cAAO,EAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IAE3C,yCAAyC;IACzC,IAAI,CAAC,IAAA,qBAAU,EAAC,EAAE,CAAC,EACnB,CAAC;QACA,MAAM,IAAI,KAAK,CAAC,oBAAoB,EAAE,EAAE,CAAC,CAAA;IAC1C,CAAC;IAED,sCAAsC;IACtC,MAAM,EAAE,GAAG,IAAA,cAAO,EAAC,GAAG,EAAE,UAAU,CAAC,CAAC;IAEpC,4CAA4C;IAC5C,IAAA,wBAAa,EAAC,IAAA,cAAO,EAAC,EAAE,CAAC,CAAC,CAAA;IAE1B,uBAAuB;IACvB,IAAA,mBAAQ,EAAC,EAAE,EAAE,EAAE,EAAE;QAChB,SAAS,EAAE,SAAS,IAAI,KAAK;QAC7B,kBAAkB,EAAE,IAAI;QACxB,YAAY,EAAE,KAAK;KACnB,CAAC,CAAC;IAEH,OAAO,IAAI,CAAC;AACb,CAAC","sourcesContent":["/**\n * Copy single static file entry / 複製單個靜態檔案條目\n *\n * This module provides the function for copying a single static file entry.\n * 此模組提供複製單個靜態檔案條目的函數。\n *\n * @module copyStaticFilesEntry\n */\nimport { IStaticFilesMapArrayEntry } from './types';\nimport { dirname, resolve } from 'path';\nimport { copySync, ensureDirSync, existsSync } from 'fs-extra';\nimport { __STATIC_ROOT } from '../__root';\n\n/**\n * Copy a single static file entry / 複製單個靜態檔案條目\n *\n * Copies a single static file from the static root to the target directory.\n * 從靜態根目錄複製單個靜態檔案到目標目錄。\n *\n * @param entry - The static file entry / 靜態檔案條目\n * @param entry.0 - targetFile: Target file path / 目標檔案路徑\n * @param entry.1 - staticFile: Source static file path / 來源靜態檔案路徑\n * @param entry.2 - detectFile: Optional file to check for existence / 可選的檢測檔案\n *\n * @param cwd - Current working directory / 當前工作目錄\n * @param staticRoot - Root directory of static files (defaults to package root) / 靜態檔案根目錄（預設為套件根目錄）\n * @param overwrite - Whether to overwrite existing files (defaults to false) / 是否覆蓋已存在的檔案（預設為 false）\n *\n * @returns true if file was copied, undefined if skipped (detect file exists) / 如果檔案已複製則返回 true，如果跳過（檢測檔案存在）則返回 undefined\n *\n * @throws {Error} When the source static file does not exist / 當來源靜態檔案不存在時\n *\n * @example\n * ```typescript\n * import { copyStaticFilesEntry } from '@yarn-tool/static-file';\n *\n * // Copy a single file\n * // 複製單個檔案\n * const result = copyStaticFilesEntry(\n *   ['.gitignore', 'file/gitignore'],\n *   '/path/to/project',\n *   '/path/to/static/root',\n *   false\n * );\n *\n * // With detect file - skips if detect file exists\n * // 使用檢測檔案 - 如果檢測檔案存在則跳過\n * const result = copyStaticFilesEntry(\n *   ['tsconfig.json', 'file/tsconfig.json.tpl', 'tsconfig.json'],\n *   '/path/to/project'\n * );\n * // Skips copy if tsconfig.json already exists in the project\n * // 如果 tsconfig.json 已存在於專案中則跳過複製\n * ```\n */\nexport function copyStaticFilesEntry(entry: IStaticFilesMapArrayEntry<string>,\n\tcwd: string,\n\tstaticRoot: string = __STATIC_ROOT,\n\toverwrite?: boolean,\n)\n{\n\tconst [targetFile, staticFile, detectFile] = entry;\n\n\t// Check if detect file exists - skip copy if it does / 檢查檢測檔案是否存在 - 如果存在則跳過複製\n\tif (detectFile?.length)\n\t{\n\t\tconst fc = resolve(cwd, detectFile);\n\n\t\tif (existsSync(fc))\n\t\t{\n\t\t\treturn;\n\t\t}\n\t}\n\n\t// Resolve source file path / 解析來源檔案路徑\n\tconst fb = resolve(staticRoot, staticFile);\n\n\t// Verify source file exists / 驗證來源檔案是否存在\n\tif (!existsSync(fb))\n\t{\n\t\tthrow new Error(`file not exists. ${fb}`)\n\t}\n\n\t// Resolve target file path / 解析目標檔案路徑\n\tconst fa = resolve(cwd, targetFile);\n\n\t// Ensure target directory exists / 確保目標目錄存在\n\tensureDirSync(dirname(fa))\n\n\t// Copy the file / 複製檔案\n\tcopySync(fb, fa, {\n\t\toverwrite: overwrite || false,\n\t\tpreserveTimestamps: true,\n\t\terrorOnExist: false,\n\t});\n\n\treturn true;\n}\n"]}

package/lib/getRowOfStaticFilesMapArray.d.ts

@@ -1,2 +1,42 @@
+/**
+ * Get row from static files map array / 從靜態檔案映射陣列獲取行
+ *
+ * This module provides a function to retrieve a specific entry from a static files map.
+ * 此模組提供從靜態檔案映射中檢索特定條目的函數。
+ *
+ * @module getRowOfStaticFilesMapArray
+ */
 import { IStaticFiles, IStaticFilesKey, IStaticFilesMapArrayEntry } from './types';
+/**
+ * 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']
+ * ```
+ */
 export declare function getRowOfStaticFilesMapArray<T extends IStaticFiles<string>, K extends IStaticFilesKey<T>>(file_map: T, key: K): IStaticFilesMapArrayEntry<K>;