@yarn-tool/static-file 3.0.19 → 3.0.20

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (81) hide show
  1. package/CHANGELOG.md +56 -0
  2. package/README.md +110 -3
  3. package/file/npmignore +31 -0
  4. package/file/test/__root-core.cjs +1 -1
  5. package/file/test/__root-core.mjs +1 -1
  6. package/file/test/__root.js.map +1 -0
  7. package/file/test/__root.ts +9 -2
  8. package/file/test/temp.js.map +1 -0
  9. package/file/test/tsconfig.json.tpl +7 -0
  10. package/file/tsconfig.esm.json.tpl +9 -1
  11. package/file/tsconfig.json.tpl +9 -1
  12. package/file/tsconfig.tsdx.json.tpl +4 -0
  13. package/file/tsdx/index.cjs.map +1 -0
  14. package/file/ws-root/__root_ws.js.map +1 -0
  15. package/lib/const.js +120 -27
  16. package/lib/const.js.map +1 -1
  17. package/lib/copyStaticFiles.d.ts +62 -2
  18. package/lib/copyStaticFiles.js +156 -9
  19. package/lib/copyStaticFiles.js.map +1 -1
  20. package/lib/copyStaticFilesEntry.d.ts +72 -25
  21. package/lib/copyStaticFilesEntry.js +133 -34
  22. package/lib/copyStaticFilesEntry.js.map +1 -1
  23. package/lib/mergeIgnoreFiles.d.ts +52 -0
  24. package/lib/mergeIgnoreFiles.js +146 -0
  25. package/lib/mergeIgnoreFiles.js.map +1 -0
  26. package/lib/parseStaticMap.js +16 -3
  27. package/lib/parseStaticMap.js.map +1 -1
  28. package/lib/reMapStaticFilesMapArray.js +26 -5
  29. package/lib/reMapStaticFilesMapArray.js.map +1 -1
  30. package/lib/root/getRootCopyStaticFiles.js +17 -2
  31. package/lib/root/getRootCopyStaticFiles.js.map +1 -1
  32. package/lib/types.d.ts +71 -0
  33. package/lib/types.js.map +1 -1
  34. package/package.json +22 -5
  35. package/test/__root-core.cjs +1 -0
  36. package/test/__root-core.d.cts +1 -0
  37. package/test/__root-core.d.mts +1 -0
  38. package/test/__root-core.d.ts +1 -0
  39. package/test/__root-core.mjs +8 -0
  40. package/test/__root.d.ts +32 -0
  41. package/test/__root.js +54 -0
  42. package/test/__root.js.map +1 -0
  43. package/test/copyStaticFiles.test.js.map +1 -0
  44. package/test/copyStaticFiles.test.ts.snapshot +439 -0
  45. package/test/fixtures/out/gitignore +242 -0
  46. package/test/fixtures/out/npmignore +216 -0
  47. package/test/fixtures/split/git/00-header.txt +2 -0
  48. package/test/fixtures/split/git/10-project.txt +24 -0
  49. package/test/fixtures/split/git/20-test.txt +9 -0
  50. package/test/fixtures/split/git/40-env.txt +10 -0
  51. package/test/fixtures/split/git/90-misc.txt +6 -0
  52. package/test/fixtures/split/git/99-whitelist.txt +40 -0
  53. package/test/fixtures/split/npm/01-hidden.txt +2 -0
  54. package/test/fixtures/split/npm/05-source.txt +7 -0
  55. package/test/fixtures/split/npm/10-project.txt +31 -0
  56. package/test/fixtures/split/npm/20-test.txt +20 -0
  57. package/test/fixtures/split/npm/30-ide.txt +2 -0
  58. package/test/fixtures/split/npm/40-env.txt +2 -0
  59. package/test/fixtures/split/npm/90-misc.txt +4 -0
  60. package/test/fixtures/split/other/90-duplicates.txt +33 -0
  61. package/test/fixtures/split/shared/10-project.txt +38 -0
  62. package/test/fixtures/split/shared/20-test.txt +7 -0
  63. package/test/fixtures/split/shared/30-ide.txt +8 -0
  64. package/test/fixtures/split/shared/40-env.txt +6 -0
  65. package/test/fixtures/split/shared/90-misc.txt +10 -0
  66. package/test/scripts/compose-split-ignore-files.d.ts +1 -0
  67. package/test/scripts/compose-split-ignore-files.js +80 -0
  68. package/test/scripts/compose-split-ignore-files.js.map +1 -0
  69. package/test/scripts/lib/ignore-split.d.ts +205 -0
  70. package/test/scripts/lib/ignore-split.js +286 -0
  71. package/test/scripts/lib/ignore-split.js.map +1 -0
  72. package/test/scripts/split-ignore-files.d.ts +1 -0
  73. package/test/scripts/split-ignore-files.js +454 -0
  74. package/test/scripts/split-ignore-files.js.map +1 -0
  75. package/test/scripts/update-npmignore-static-files.d.ts +1 -0
  76. package/test/scripts/update-npmignore-static-files.js +121 -0
  77. package/test/scripts/update-npmignore-static-files.js.map +1 -0
  78. package/test/temp.d.ts +3 -0
  79. package/test/temp.js +5 -0
  80. package/test/temp.js.map +1 -0
  81. package/test/tsconfig.json.tpl +13 -0
package/CHANGELOG.md CHANGED
@@ -3,6 +3,62 @@
3
3
  All notable changes to this project will be documented in this file.
4
4
  See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
5
5
 
6
+ ## [3.0.20](https://github.com/bluelovers/ws-yarn-workspaces/compare/@yarn-tool/static-file@3.0.19...@yarn-tool/static-file@3.0.20) (2026-10-12)
7
+
8
+
9
+ ### BREAKING CHANGES
10
+
11
+ * **static-file:** 支援在重置靜態檔案時自動合併既有的 ignore 規則
12
+ * **ignore:** 重構內部架構並優化換行符號處理邏輯
13
+
14
+
15
+
16
+ ### ✨ Features
17
+
18
+ * **ignore:** 引入行解析 (Tokenization) 機制並擴充去重控制選項 ([eaec5e4](https://github.com/bluelovers/ws-yarn-workspaces/commit/eaec5e439ebed6a50d23a54ce3f78e37dd6e1686))
19
+ * **ignore:** 擴充 IgnoreFile API 並優化規則處理流程 ([496a0f5](https://github.com/bluelovers/ws-yarn-workspaces/commit/496a0f5455e55c60fec51999e42201af61dbd472))
20
+ * **scripts:** 實作忽略規則分割流程並建立單一事實來源 ([d83d90d](https://github.com/bluelovers/ws-yarn-workspaces/commit/d83d90dde88efb6675ea6aa5c219a59d950901dd))
21
+ * **static-file:** 支援在重置靜態檔案時自動合併既有的 ignore 規則 ([11ab7c6](https://github.com/bluelovers/ws-yarn-workspaces/commit/11ab7c6023e142b74694365fe9a0f78e3c000d92))
22
+
23
+
24
+ ### 📦 Code Refactoring
25
+
26
+ * **@yarn-tool/static-file:** 優化測試路徑處理與 TypeScript 配置 ([280dea2](https://github.com/bluelovers/ws-yarn-workspaces/commit/280dea20072cf78bfc24426f3cad5c0f888d9b3e))
27
+ * **ignore:** 重構內部架構並優化換行符號處理邏輯 ([2067ef8](https://github.com/bluelovers/ws-yarn-workspaces/commit/2067ef8fd69a054a040c77c759804c94ab20de8d))
28
+ * **static-file:** 重構靜態檔案複製邏輯以分離路徑解析與檔案寫入 ([53a7e55](https://github.com/bluelovers/ws-yarn-workspaces/commit/53a7e558c6bc42e3565dce162097fb0b114f3243))
29
+
30
+
31
+ ### 📚 Documentation
32
+
33
+ * add jsdoc ([9cb9b13](https://github.com/bluelovers/ws-yarn-workspaces/commit/9cb9b13eda8c357221ad1b754458aa9916eada22))
34
+
35
+
36
+ ### 🚨 Tests
37
+
38
+ * **@yarn-tool/static-file:** 建立基於分類片段的忽略規則測試架構 ([f0a15c1](https://github.com/bluelovers/ws-yarn-workspaces/commit/f0a15c1f7306c5d61d0779be35e3635504190963))
39
+
40
+
41
+ ### 🛠 Build System
42
+
43
+ * update build ([5fb6966](https://github.com/bluelovers/ws-yarn-workspaces/commit/5fb6966a57ec31ba89d8c20aa676c60755b7b286))
44
+ * update build ([3186340](https://github.com/bluelovers/ws-yarn-workspaces/commit/3186340758172427cb1e9b8955f6fd677abac625))
45
+ * **@yarn-tool/static-file:** 更新 tsconfig 範本以排除編譯與測試目錄 ([3286c71](https://github.com/bluelovers/ws-yarn-workspaces/commit/3286c714fa9ce2621abfac5514f54d2a0a8d9b1c))
46
+ * **deps:** 更新測試腳本與依賴以支援 node:test ([f9c71c7](https://github.com/bluelovers/ws-yarn-workspaces/commit/f9c71c795c792c5c7ed9d613ce7e9c3c726c39d5))
47
+
48
+
49
+ ### ♻️ Chores
50
+
51
+ * **config:** 更新自動生成腳本註解與忽略檔案規則 ([8428290](https://github.com/bluelovers/ws-yarn-workspaces/commit/84282900016fb9d5794dbe69d458c958f773b411))
52
+ * **deps:** 更新各套件依賴版本 ([569f075](https://github.com/bluelovers/ws-yarn-workspaces/commit/569f0756189cdadf69955d8e388ac0a6a8988056))
53
+ * **workspace:** 更新測試指令路徑與新增工作區搜尋選項 ([a80039d](https://github.com/bluelovers/ws-yarn-workspaces/commit/a80039dd8c691e047466966ffc8f8a4e2e31c03f))
54
+
55
+
56
+ ### 🔖 Miscellaneous
57
+
58
+ * . ([e5788f8](https://github.com/bluelovers/ws-yarn-workspaces/commit/e5788f84551b870490a96d0a5d67d8d542481373))
59
+
60
+
61
+
6
62
  ## [3.0.19](https://github.com/bluelovers/ws-yarn-workspaces/compare/@yarn-tool/static-file@3.0.18...@yarn-tool/static-file@3.0.19) (2026-09-10)
7
63
 
8
64
 
package/README.md CHANGED
@@ -1,8 +1,18 @@
1
- # README.md
1
+ # @yarn-tool/static-file
2
2
 
3
-
3
+ 用於將靜態設定檔案 (static configuration files) 複製到 yarn 工作區專案的工具 / A utility for copying static configuration files to yarn workspace projects
4
4
 
5
- ## install
5
+ ## 功能特色 (Features)
6
+
7
+ - `copyStaticFiles()` - 依檔案映射 (File map) 將靜態樣板批量複製到目標目錄
8
+ - `detectFile` 機制 - 目標已存在正式設定檔時自動跳過,避免覆蓋既有設定
9
+ - `defaultCopyStaticFiles` / `defaultCopyStaticFilesRootOnly` / `defaultCopyStaticFilesWsRootOnly` - 依情境內建的三套預設清單(套件層級、僅根目錄、僅工作區根目錄)
10
+ - `getRootCopyStaticFilesAuto()` - 依專案根目錄結構自動挑選要複製的清單
11
+ - `getWsCopyStaticFiles()` - 取得工作區 (Workspace) 完整設定所需的合併清單,並自動將 `.tpl` 樣板重新映射 (Remap) 為正式檔名
12
+ - `getStaticFile()` / `getRowOfStaticFilesMapArray()` - 依檔案 ID 查詢單一映射條目
13
+ - `reMapStaticFilesMapArray()` - 將樣板條目的目標路徑重新映射為其他名稱
14
+
15
+ ## 安裝 (Installation)
6
16
 
7
17
  ```bash
8
18
  yarn add @yarn-tool/static-file
@@ -15,3 +25,100 @@ pnpm add @yarn-tool/static-file
15
25
  npm install @yarn-tool/static-file
16
26
  ```
17
27
 
28
+ ## 使用方式 (Usage)
29
+
30
+ ```typescript
31
+ import { copyStaticFiles } from '@yarn-tool/static-file';
32
+
33
+ // 將預設靜態檔案複製到當前目錄
34
+ // Copy default static files to the current directory
35
+ copyStaticFiles({
36
+ cwd: process.cwd(),
37
+ overwrite: true,
38
+ });
39
+
40
+ // 使用自訂檔案映射
41
+ // With a custom file map
42
+ copyStaticFiles({
43
+ cwd: '/path/to/project',
44
+ file_map: [
45
+ ['.gitignore', 'file/gitignore'],
46
+ ['README.md', 'file/README.md'],
47
+ ],
48
+ });
49
+ ```
50
+
51
+ 進階用法 (Advanced usage):
52
+
53
+ ```typescript
54
+ import { getRootCopyStaticFilesAuto } from '@yarn-tool/static-file/lib/root/getRootCopyStaticFiles';
55
+ import { getWsCopyStaticFiles } from '@yarn-tool/static-file/lib/ws/wsCopyStaticFiles';
56
+ import { getStaticFile } from '@yarn-tool/static-file/lib/getStaticFile';
57
+
58
+ // 依根目錄結構挑選清單 / Pick the list based on the root structure
59
+ const file_map = getRootCopyStaticFilesAuto({ isRoot: true, hasWorkspace: false });
60
+
61
+ // 查詢單一條目 / Look up a single entry
62
+ console.dir(getStaticFile('.gitignore')); // ['.gitignore', 'file/gitignore']
63
+
64
+ // 工作區完整清單 / Full workspace list
65
+ console.dir(getWsCopyStaticFiles());
66
+ ```
67
+
68
+ ## API 文件 (API Documentation)
69
+
70
+ ### `copyStaticFiles(options)`
71
+
72
+ 主入口 (Main entry),回傳實際複製成功的條目陣列。
73
+
74
+ | 參數 | 型別 | 說明 |
75
+ | --- | --- | --- |
76
+ | `options.cwd` | `string` | 目標目錄(必填,不存在時拋出 `TypeError`) |
77
+ | `options.staticRoot` | `string?` | 靜態樣板來源目錄,預設為本套件的 `file/` 目錄 |
78
+ | `options.overwrite` | `boolean?` | 是否覆寫已存在的檔案,預設 `false` |
79
+ | `options.file_map` | `IStaticFiles` | 自訂映射;省略時使用 `defaultCopyStaticFiles` |
80
+
81
+ ### 檔案映射條目 (Map entry)
82
+
83
+ 每個條目為三元組 (Tuple):`[targetFile, staticFile, detectFile?]`
84
+
85
+ - `targetFile` - 目標檔案路徑(相對於 `cwd`)
86
+ - `staticFile` - 來源樣板路徑(相對於 `staticRoot`)
87
+ - `detectFile` - 可選的檢測路徑;若該檔案已存在則跳過此條目
88
+
89
+ ### 內建清單 (Built-in lists)
90
+
91
+ 以子路徑 `@yarn-tool/static-file/lib/const` 匯入:
92
+
93
+ - `defaultCopyStaticFiles` - 各套件都需要的檔案(`.gitignore`、`.npmignore`、`tsconfig.json`、`jest.config.js`、`test/` 樣板等)
94
+ - `defaultCopyStaticFilesRootOnly` - 只給專案根目錄的檔案(`lerna.json`、`pnpm-workspace.yaml`、`.github/`、`.nvmrc` 等)
95
+ - `defaultCopyStaticFilesWsRootOnly` - 只給工作區根目錄的檔案(`__root_ws.ts`、`jest-preset.js`、`.run/` 等)
96
+
97
+ ### 其他函式 (Other functions)
98
+
99
+ | 函式 | 子路徑 | 說明 |
100
+ | --- | --- | --- |
101
+ | `getRootCopyStaticFilesAuto(rootData)` | `lib/root/getRootCopyStaticFiles` | 依 `isRoot` / `hasWorkspace` 決定要複製的清單 |
102
+ | `getWsCopyStaticFiles()` | `lib/ws/wsCopyStaticFiles` | 合併三套清單並重新映射 `.tpl` 樣板檔名 |
103
+ | `parseStaticMap(file_map)` | `lib/parseStaticMap` | 將陣列或記錄 (Record) 格式統一成條目陣列 |
104
+ | `getRowOfStaticFilesMapArray(file_map, key)` | `lib/getRowOfStaticFilesMapArray` | 依目標檔名查詢條目 |
105
+ | `getStaticFile(file_id, options?)` | `lib/getStaticFile` | 依檔案 ID 查詢條目(預設清單) |
106
+ | `reMapStaticFilesMapArray(file_map, replaceMap)` | `lib/reMapStaticFilesMapArray` | 以「新路徑 → 舊路徑」建立重新映射後的新清單 |
107
+ | `replaceTargetOfStaticFilesMapArrayEntry(entry, targetFile)` | `lib/replaceTargetOfStaticFilesMapArrayEntry` | 保留來源、只替換目標路徑 |
108
+
109
+ ### 邊界情況 (Edge cases)
110
+
111
+ - `cwd` 不是字串或為空字串 → 拋出 `TypeError`
112
+ - `cwd` 目錄不存在 → 拋出 `TypeError`
113
+ - 解析後的 `file_map` 為空 → 拋出 `TypeError`
114
+ - 來源樣板檔案不存在 → 拋出 `Error`(表示清單與 `file/` 目錄不同步)
115
+ - 已存在 `detectFile` 的目標會被跳過,且不出現在回傳陣列中
116
+
117
+ ## 設定 (Configuration)
118
+
119
+ 本套件沒有設定檔 (Config file),行為完全由 `copyStaticFiles()` 的 `options` 與所選的內建清單決定:
120
+
121
+ - **樣板來源**:以 `staticRoot` 覆寫預設的 `file/` 目錄,即可使用自備的樣板集。
122
+ - **覆寫策略**:`overwrite` 為 `false` 時,已存在的目標檔案維持原狀(`errorOnExist: false`,不會中斷批次)。
123
+ - **情境選擇**:一般套件用 `defaultCopyStaticFiles`;獨立專案根目錄用 `getRootCopyStaticFilesAuto({ isRoot: true, hasWorkspace: false })`;工作區根目錄用 `getWsCopyStaticFiles()`。
124
+ - **忽略清單**:`.npmignore` / `.gitignore` 中的 `!file/` 白名單由 `test/scripts/update-npmignore-static-files.ts` 依 `lib/const.ts` 自動產生。
package/file/npmignore CHANGED
@@ -124,10 +124,41 @@ now.json
124
124
  *.test.d.tsx
125
125
  *.test.tsx
126
126
 
127
+ *.node-spec.d.ts
128
+ *.node-spec.js
129
+ *.node-spec.ts
130
+
131
+ *.node-spec.d.cts
132
+ *.node-spec.cjs
133
+ *.node-spec.cts
134
+
135
+ *.node-spec.d.mts
136
+ *.node-spec.mjs
137
+ *.node-spec.mts
138
+
139
+ *.node-spec.d.tsx
140
+ *.node-spec.tsx
141
+
142
+ *.node-test.d.ts
143
+ *.node-test.js
144
+ *.node-test.ts
145
+
146
+ *.node-test.d.cts
147
+ *.node-test.cjs
148
+ *.node-test.cts
149
+
150
+ *.node-test.d.mts
151
+ *.node-test.mjs
152
+ *.node-test.mts
153
+
154
+ *.node-test.d.tsx
155
+ *.node-test.tsx
156
+
127
157
  __mocks__
128
158
  __tests__
129
159
  __snapshots__
130
160
  *.snap
161
+ *.snapshot
131
162
  npm-shrinkwrap.json
132
163
  /example/
133
164
  *.stat
@@ -1 +1 @@
1
- module.exports.__ROOT_CORE = require('upath2').resolve(__dirname, '..');
1
+ module.exports.__ROOT_CORE = require('path').resolve(__dirname, '..');
@@ -1,4 +1,4 @@
1
- import path from 'upath2';
1
+ import path from 'path';
2
2
  import { fileURLToPath } from 'url';
3
3
 
4
4
  // @ts-ignore
@@ -0,0 +1 @@
1
+ {"version":3,"file":"__root.js","sourceRoot":"","sources":["__root.ts"],"names":[],"mappings":";;;;AAAA;;;;;;;;GAQG;AACH,8BAA8B;AAC9B;;GAEG;AACH,2BAA2B;AAC3B,4DAA0B;AAC1B,aAAa;AACb,uDAAgD;AAEhD;;GAEG;AACU,QAAA,MAAM,GAAG,gBAAI,CAAC,SAAS,CAAC,6BAAW,CAAC,CAAC;AAErC,QAAA,KAAK,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC;AAElD;;;;;GAKG;AACU,QAAA,WAAW,GAAG,gBAAI,CAAC,IAAI,CAAC,cAAM,EAAE,MAAM,CAAC,CAAC;AAErD;;;;;GAKG;AACU,QAAA,eAAe,GAAG,gBAAI,CAAC,IAAI,CAAC,mBAAW,EAAE,UAAU,CAAC,CAAC;AAElE;;;;;;;;;;;GAWG;AACU,QAAA,WAAW,GAAG,gBAAI,CAAC,IAAI,CAAC,mBAAW,EAAE,MAAM,CAAC,CAAC","sourcesContent":["/**\n * 測試路徑架構 / Test Path Structure\n *\n * test/\n * ├── fixtures/ ← 測試資料夾(唯讀)\n * └── temp/ ← 臨時檔案(可寫,永遠建立子資料夾)\n * ├── fake-lib/\n * └── temp-pkg/\n */\n/// <reference types=\"node\" />\n/**\n * 如果不需要 upath2 可改用 path\n */\n// import path from 'path';\nimport path from 'upath2';\n// @ts-ignore\nimport { __ROOT_CORE } from './__root-core.cjs';\n\n/**\n * 專案根目錄\n */\nexport const __ROOT = path.normalize(__ROOT_CORE);\n\nexport const isWin = process.platform === \"win32\";\n\n/**\n * 測試資料夾\n * 基於 {@link __ROOT}\n *\n * @default test\n */\nexport const __TEST_ROOT = path.join(__ROOT, 'test');\n\n/**\n * 測試資料夾(唯讀)\n * 基於 {@link __TEST_ROOT}\n *\n * @default test/fixtures\n */\nexport const __TEST_FIXTURES = path.join(__TEST_ROOT, 'fixtures');\n\n/**\n * 臨時檔案(可寫,永遠建立子資料夾)\n * 基於 {@link __TEST_ROOT}\n *\n * test/\n * ├── fixtures/ ← 測試資料夾(唯讀)\n * └── temp/ ← 臨時檔案(可寫,永遠建立子資料夾)\n * ├── fake-lib/\n * └── temp-pkg/\n *\n * @default test/temp\n */\nexport const __TEST_TEMP = path.join(__TEST_ROOT, 'temp');\n"]}
@@ -8,19 +8,24 @@
8
8
  * └── temp-pkg/
9
9
  */
10
10
  /// <reference types="node" />
11
+ /**
12
+ * 如果不需要 upath2 可改用 path
13
+ */
14
+ // import path from 'path';
11
15
  import path from 'upath2';
12
16
  // @ts-ignore
13
- import { __ROOT_CORE as __ROOT } from './__root-core.cjs';
17
+ import { __ROOT_CORE } from './__root-core.cjs';
14
18
 
15
19
  /**
16
20
  * 專案根目錄
17
21
  */
18
- export { __ROOT }
22
+ export const __ROOT = path.normalize(__ROOT_CORE);
19
23
 
20
24
  export const isWin = process.platform === "win32";
21
25
 
22
26
  /**
23
27
  * 測試資料夾
28
+ * 基於 {@link __ROOT}
24
29
  *
25
30
  * @default test
26
31
  */
@@ -28,6 +33,7 @@ export const __TEST_ROOT = path.join(__ROOT, 'test');
28
33
 
29
34
  /**
30
35
  * 測試資料夾(唯讀)
36
+ * 基於 {@link __TEST_ROOT}
31
37
  *
32
38
  * @default test/fixtures
33
39
  */
@@ -35,6 +41,7 @@ export const __TEST_FIXTURES = path.join(__TEST_ROOT, 'fixtures');
35
41
 
36
42
  /**
37
43
  * 臨時檔案(可寫,永遠建立子資料夾)
44
+ * 基於 {@link __TEST_ROOT}
38
45
  *
39
46
  * test/
40
47
  * ├── fixtures/ ← 測試資料夾(唯讀)
@@ -0,0 +1 @@
1
+ {"version":3,"file":"temp.js","sourceRoot":"","sources":["temp.ts"],"names":[],"mappings":";AAAA,8BAA8B","sourcesContent":["/// <reference types=\"node\" />\n\n"]}
@@ -16,5 +16,12 @@
16
16
  },
17
17
  "include": [
18
18
  "test"
19
+ ],
20
+ "exclude": [
21
+ "node_modules",
22
+ "__fixtures__",
23
+ "__snapshots__",
24
+ "coverage",
25
+ "dist"
19
26
  ]
20
27
  }
@@ -10,5 +10,13 @@
10
10
  "jest",
11
11
  "node"
12
12
  ]
13
- }
13
+ },
14
+ "exclude": [
15
+ "dist",
16
+ "node_modules",
17
+ "__fixtures__",
18
+ "__snapshots__",
19
+ "coverage",
20
+ "test"
21
+ ]
14
22
  }
@@ -6,5 +6,13 @@
6
6
  "jest",
7
7
  "node"
8
8
  ]
9
- }
9
+ },
10
+ "exclude": [
11
+ "dist",
12
+ "node_modules",
13
+ "__fixtures__",
14
+ "__snapshots__",
15
+ "coverage",
16
+ "test"
17
+ ]
10
18
  }
@@ -7,6 +7,10 @@
7
7
  },
8
8
  "exclude": [
9
9
  "dist",
10
+ "node_modules",
11
+ "__fixtures__",
12
+ "__snapshots__",
13
+ "coverage",
10
14
  "test"
11
15
  ]
12
16
  }
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.cjs","sourceRoot":"","sources":["index.cts"],"names":[],"mappings":";;AAAA,4DAAwB;AAGxB,iBAAS,eAAC,CAAA","sourcesContent":["import _ from './index';\n\n// @ts-ignore\nexport = _\n"]}
@@ -0,0 +1 @@
1
+ {"version":3,"file":"__root_ws.js","sourceRoot":"","sources":["__root_ws.ts"],"names":[],"mappings":";;;AAAA,+BAA4B;AAEf,QAAA,SAAS,GAAG,IAAA,WAAI,EAAC,SAAS,CAAC,CAAC;AAE5B,QAAA,KAAK,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC","sourcesContent":["import { join } from \"path\";\n\nexport const __ROOT_WS = join(__dirname);\n\nexport const isWin = process.platform === \"win32\";\n"]}
package/lib/const.js CHANGED
@@ -15,29 +15,56 @@ exports.defaultCopyStaticFilesWsRootOnly = exports.defaultCopyStaticFilesRootOnl
15
15
  * - detectFile: Optional file to check for existence before copying / 可選的檢測檔案,複製前檢查是否存在
16
16
  */
17
17
  const _defaultCopyStaticFiles = [
18
- // Ignore files / 忽略檔案
18
+ /**
19
+ * 忽略檔案
20
+ * Ignore files
21
+ */
19
22
  ['.npmignore', 'file/npmignore'],
20
23
  ['.gitignore', 'file/gitignore'],
21
24
  ['.eslintignore', 'file/eslintignore'],
22
- // TypeScript configuration / TypeScript 配置
25
+ /**
26
+ * TypeScript 配置
27
+ * TypeScript configuration
28
+ */
23
29
  ['tsconfig.json', 'file/tsconfig.json.tpl'],
24
30
  ['tsconfig.json.tpl', 'file/tsconfig.json.tpl'],
25
31
  ['test/tsconfig.json.tpl', 'file/test/tsconfig.json.tpl', 'test/tsconfig.json'],
26
32
  ['tsconfig.esm.json.tpl', 'file/tsconfig.esm.json.tpl', 'tsconfig.esm.json'],
27
33
  ['tsconfig.tsdx.json.tpl', 'file/tsconfig.tsdx.json.tpl', 'tsconfig.tsdx.json'],
28
- // ESLint configuration / ESLint 配置
34
+ /**
35
+ * ESLint 配置
36
+ * ESLint configuration
37
+ */
29
38
  ['.eslintrc.json.tpl', 'file/eslintrc.json.tpl', '.eslintrc.json'],
30
- // Documentation / 文檔
39
+ /**
40
+ * 文件
41
+ * Documentation
42
+ */
31
43
  ['README.md', 'file/README.md'],
32
- // Test configuration / 測試配置
44
+ /**
45
+ * 測試配置
46
+ * Test configuration
47
+ */
33
48
  ['.mocharc.yml.tpl', 'file/mocharc.yml'],
34
49
  ['jest.config.js', 'file/jest.config.auto.js'],
35
- // Now/Zeit deployment / Now/Zeit 部署配置
50
+ /**
51
+ * Now/Zeit 部署配置
52
+ * Now/Zeit deployment
53
+ */
36
54
  ['.nowignore', 'file/nowignore'],
37
55
  ['now.json.tpl', 'file/now.json.tpl', 'now.json'],
38
- // TSDX configuration / TSDX 配置
56
+ /**
57
+ * TSDX 配置
58
+ * TSDX configuration
59
+ */
39
60
  ['tsdx.config.js.tpl', 'file/tsdx.config.js', 'tsdx.config.js'],
40
- // test / 測試
61
+ /**
62
+ * 測試
63
+ * test
64
+ *
65
+ * 以展開運算式一次產生 test/ 底下的固定樣板條目
66
+ * Expands into template entries under test/ in one go
67
+ */
41
68
  ...([
42
69
  'temp.ts',
43
70
  '__root.ts',
@@ -46,7 +73,10 @@ const _defaultCopyStaticFiles = [
46
73
  '__root-core.d.cts',
47
74
  '__root-core.d.mts',
48
75
  '__root-core.d.ts',
49
- // Test fixtures / 測試固定檔案
76
+ /**
77
+ * 測試固定檔案
78
+ * Test fixtures
79
+ */
50
80
  'fixtures/.gitkeep',
51
81
  ].map(file => [
52
82
  `test/${file}`,
@@ -64,13 +94,22 @@ const _defaultCopyStaticFiles = [
64
94
  * 這些檔案通常在 monorepo 中的所有套件之間共享。
65
95
  */
66
96
  const _defaultCopyStaticFilesRootOnly = [
67
- // Monorepo configuration / Monorepo 配置
97
+ /**
98
+ * Monorepo 配置
99
+ * Monorepo configuration
100
+ */
68
101
  ['lerna.json.tpl', 'file/lerna.json.tpl', 'lerna.json'],
69
102
  ['pnpm-workspace.yaml.tpl', 'file/pnpm-workspace.yaml'],
70
- // GitHub Actions workflows / GitHub Actions 工作流程
103
+ /**
104
+ * GitHub Actions 工作流程
105
+ * GitHub Actions workflows
106
+ */
71
107
  ['.github/workflows/build-pnpm.yml', 'file/github/workflows/build-pnpm.yml'],
72
108
  ['.github/workflows/build-yarn.yml', 'file/github/workflows/build-yarn.yml'],
73
- // Additional GitHub configuration / 額外的 GitHub 配置
109
+ /**
110
+ * 額外的 GitHub 配置
111
+ * Additional GitHub configuration
112
+ */
74
113
  ...([
75
114
  'dependabot.yml',
76
115
  'commit-convention.md',
@@ -82,30 +121,63 @@ const _defaultCopyStaticFilesRootOnly = [
82
121
  // 'workflows/yarn-lock-changes.yml',
83
122
  // ---
84
123
  ].map(file => [`.github/${file}`, `file/github/${file}`])),
85
- // Node version files / Node 版本檔案
124
+ /**
125
+ * Node 版本檔案
126
+ * Node version files
127
+ */
86
128
  ['.node-version.tpl', 'file/nvmrc'],
87
129
  ['.nvmrc.tpl', 'file/nvmrc'],
88
- // Root TypeScript configuration / 根目錄 TypeScript 配置
130
+ /**
131
+ * 根目錄 TypeScript 配置
132
+ * Root TypeScript configuration
133
+ *
134
+ * 注意:此處目標為 .eslintrc.json,屬於根目錄專用的 ESLint 設定
135
+ * Note: the target here is .eslintrc.json, the ESLint config used only at the root
136
+ */
89
137
  ['.eslintrc.json', 'file/eslintrc.json.tpl', '.eslintrc.json'],
90
138
  //['changelog-option.js', 'file/changelog-option.js', 'changelog-option.js.tpl'],
91
- // Package manager configuration / 套件管理器配置
139
+ /**
140
+ * 套件管理器配置
141
+ * Package manager configuration
142
+ */
92
143
  ['.yarnrc.yml.tpl', 'file/root/yarnrc.yml', '.yarnrc.yml'],
93
144
  ['.npmrc.tpl', 'file/npmrc', '.npmrc'],
94
145
  ['.env.tpl', 'file/env'],
95
- // Jest configuration / Jest 配置
146
+ /**
147
+ * Jest 配置
148
+ * Jest configuration
149
+ *
150
+ * 僅放置 .tpl 樣板,正式設定檔交由工作區層級建立
151
+ * Only the .tpl template is shipped here; the real config is created by the workspace layer
152
+ */
96
153
  // ['jest.config.js', 'file/jest.config.js'],
97
154
  // ['jest.config.js.tpl', 'file/jest.config.js'],
98
155
  ['jest.config.auto.js.tpl', 'file/jest.config.auto.js'],
99
- // Editor configuration / 編輯器配置
156
+ /**
157
+ * 編輯器配置
158
+ * Editor configuration
159
+ */
100
160
  ['.editorconfig.tpl', 'file/tpl.editorconfig'],
101
161
  ['.editorconfig', 'file/tpl.editorconfig'],
102
- // Global type declarations / 全局類型聲明
162
+ /**
163
+ * 全域型別宣告
164
+ * Global type declarations
165
+ */
103
166
  ['global.tsdx.d.ts', 'file/root/global.tsdx.d.ts'],
104
- // Browserslist configuration / Browserslist 配置
167
+ /**
168
+ * Browserslist 配置
169
+ * Browserslist configuration
170
+ */
105
171
  ['.browserslistrc', 'file/ws-root/browserslistrc'],
106
- // TSC multi configuration / TSC 多配置
172
+ /**
173
+ * TSC 多配置
174
+ * TSC multi configuration
175
+ */
107
176
  // ['tsc-multi.json.tpl', 'file/tsc-multi.json.tpl', 'tsc-multi.json'],
108
- // NYC coverage configuration / NYC 覆蓋率配置
177
+ /**
178
+ * NYC 覆蓋率配置
179
+ * NYC coverage configuration
180
+ */
109
181
  // ['.nycrc.tpl', 'file/nycrc', '.nycrc'],
110
182
  ];
111
183
  /**
@@ -115,19 +187,40 @@ const _defaultCopyStaticFilesRootOnly = [
115
187
  * 包含特定於工作區根目錄管理的檔案。
116
188
  */
117
189
  const _defaultCopyStaticFilesWsRootOnly = [
118
- // Lerna configuration / Lerna 配置
190
+ /**
191
+ * Lerna 配置
192
+ * Lerna configuration
193
+ */
119
194
  ['lerna.json.tpl', 'file/lerna.json.tpl'],
120
- // pnpm workspace configuration / pnpm 工作區配置
195
+ /**
196
+ * pnpm 工作區配置
197
+ * pnpm workspace configuration
198
+ */
121
199
  ['pnpm-workspace.yaml', 'file/pnpm-workspace.yaml'],
122
- // TSC multi configuration / TSC 多配置
200
+ /**
201
+ * TSC 多配置
202
+ * TSC multi configuration
203
+ */
123
204
  // ['tsc-multi.json.tpl', 'file/tsc-multi.json.tpl', 'tsc-multi.json'],
124
- // Workspace root file / 工作區根目錄檔案
205
+ /**
206
+ * 工作區根目錄檔案
207
+ * Workspace root file
208
+ */
125
209
  ['__root_ws.ts', 'file/ws-root/__root_ws.ts'],
126
- // Jest configuration / Jest 配置
210
+ /**
211
+ * Jest 配置
212
+ * Jest configuration
213
+ *
214
+ * 工作區根目錄同時提供正式設定與樣板兩種形式
215
+ * The workspace root ships both the real config and the template form
216
+ */
127
217
  ['jest.config.js', 'file/ws-root/jest.config.js'],
128
218
  ['jest-preset.js', 'file/ws-root/jest-preset.js'],
129
219
  ['jest.config.js.tpl', 'file/ws-root/jest.config.js'],
130
- // Run configurations / 執行配置
220
+ /**
221
+ * 執行配置
222
+ * Run configurations
223
+ */
131
224
  ['.run/lerna_publish_yes.run.xml', 'file/ws-root/.run/lerna_publish_yes.run.xml'],
132
225
  ];
133
226
  /**
package/lib/const.js.map CHANGED
@@ -1 +1 @@
1
- {"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', 'file/tsconfig.json.tpl'],\n\t['tsconfig.json.tpl', 'file/tsconfig.json.tpl'],\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\t['tsconfig.tsdx.json.tpl', 'file/tsconfig.tsdx.json.tpl', 'tsconfig.tsdx.json'],\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\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 / 測試\n\t...(([\n\t\t'temp.ts',\n\n\t\t'__root.ts',\n\n\t\t'__root-core.cjs',\n\t\t'__root-core.mjs',\n\n\t\t'__root-core.d.cts',\n\t\t'__root-core.d.mts',\n\n\t\t'__root-core.d.ts',\n\n\t\t// Test fixtures / 測試固定檔案\n\t\t'fixtures/.gitkeep',\n\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'],\n\n\t// GitHub Actions workflows / GitHub Actions 工作流程\n\t['.github/workflows/build-pnpm.yml', 'file/github/workflows/build-pnpm.yml'],\n\t['.github/workflows/build-yarn.yml', 'file/github/workflows/build-yarn.yml'],\n\n\t// Additional GitHub configuration / 額外的 GitHub 配置\n\t...(([\n\t\t'dependabot.yml',\n\t\t'commit-convention.md',\n\n\t\t// ---\n\n\t\t// 'workflows/codeql-analysis.yml',\n\t\t// 'workflows/cmd-rebase.yml',\n\n\t\t// 'workflows/coverage.yml',\n\t\t// 'workflows/action-yarnlock-dedupe.yml',\n\t\t// 'workflows/yarn-lock-changes.yml',\n\n\t\t// ---\n\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.tpl', 'file/nvmrc'],\n\t['.nvmrc.tpl', '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['.env.tpl', 'file/env'],\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', '.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['jest.config.js.tpl', 'file/ws-root/jest.config.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"]}
1
+ {"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/**\n\t * 忽略檔案\n\t * Ignore files\n\t */\n\t['.npmignore', 'file/npmignore'],\n\t['.gitignore', 'file/gitignore'],\n\t['.eslintignore', 'file/eslintignore'],\n\n\t/**\n\t * TypeScript 配置\n\t * TypeScript configuration\n\t */\n\t['tsconfig.json', 'file/tsconfig.json.tpl'],\n\t['tsconfig.json.tpl', 'file/tsconfig.json.tpl'],\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\t['tsconfig.tsdx.json.tpl', 'file/tsconfig.tsdx.json.tpl', 'tsconfig.tsdx.json'],\n\n\t/**\n\t * ESLint 配置\n\t * ESLint configuration\n\t */\n\t['.eslintrc.json.tpl', 'file/eslintrc.json.tpl', '.eslintrc.json'],\n\n\t/**\n\t * 文件\n\t * Documentation\n\t */\n\t['README.md', 'file/README.md'],\n\n\t/**\n\t * 測試配置\n\t * Test configuration\n\t */\n\t['.mocharc.yml.tpl', 'file/mocharc.yml'],\n\n\t['jest.config.js', 'file/jest.config.auto.js'],\n\n\t/**\n\t * Now/Zeit 部署配置\n\t * Now/Zeit deployment\n\t */\n\t['.nowignore', 'file/nowignore'],\n\t['now.json.tpl', 'file/now.json.tpl', 'now.json'],\n\n\t/**\n\t * TSDX 配置\n\t * TSDX configuration\n\t */\n\t['tsdx.config.js.tpl', 'file/tsdx.config.js', 'tsdx.config.js'],\n\n\t/**\n\t * 測試\n\t * test\n\t *\n\t * 以展開運算式一次產生 test/ 底下的固定樣板條目\n\t * Expands into template entries under test/ in one go\n\t */\n\t...(([\n\t\t'temp.ts',\n\n\t\t'__root.ts',\n\n\t\t'__root-core.cjs',\n\t\t'__root-core.mjs',\n\n\t\t'__root-core.d.cts',\n\t\t'__root-core.d.mts',\n\n\t\t'__root-core.d.ts',\n\n\t\t/**\n\t\t * 測試固定檔案\n\t\t * Test fixtures\n\t\t */\n\t\t'fixtures/.gitkeep',\n\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/**\n\t * Monorepo 配置\n\t * Monorepo configuration\n\t */\n\t['lerna.json.tpl', 'file/lerna.json.tpl', 'lerna.json'],\n\t['pnpm-workspace.yaml.tpl', 'file/pnpm-workspace.yaml'],\n\n\t/**\n\t * GitHub Actions 工作流程\n\t * GitHub Actions workflows\n\t */\n\t['.github/workflows/build-pnpm.yml', 'file/github/workflows/build-pnpm.yml'],\n\t['.github/workflows/build-yarn.yml', 'file/github/workflows/build-yarn.yml'],\n\n\t/**\n\t * 額外的 GitHub 配置\n\t * Additional GitHub configuration\n\t */\n\t...(([\n\t\t'dependabot.yml',\n\t\t'commit-convention.md',\n\n\t\t// ---\n\n\t\t// 'workflows/codeql-analysis.yml',\n\t\t// 'workflows/cmd-rebase.yml',\n\n\t\t// 'workflows/coverage.yml',\n\t\t// 'workflows/action-yarnlock-dedupe.yml',\n\t\t// 'workflows/yarn-lock-changes.yml',\n\n\t\t// ---\n\n\t] as const).map(file => [`.github/${file}`, `file/github/${file}`] as const satisfies IStaticFilesMapArrayEntry<string>)),\n\n\t/**\n\t * Node 版本檔案\n\t * Node version files\n\t */\n\t['.node-version.tpl', 'file/nvmrc'],\n\t['.nvmrc.tpl', 'file/nvmrc'],\n\n\t/**\n\t * 根目錄 TypeScript 配置\n\t * Root TypeScript configuration\n\t *\n\t * 注意:此處目標為 .eslintrc.json,屬於根目錄專用的 ESLint 設定\n\t * Note: the target here is .eslintrc.json, the ESLint config used only at the root\n\t */\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/**\n\t * 套件管理器配置\n\t * Package manager configuration\n\t */\n\t['.yarnrc.yml.tpl', 'file/root/yarnrc.yml', '.yarnrc.yml'],\n\t['.npmrc.tpl', 'file/npmrc', '.npmrc'],\n\n\t['.env.tpl', 'file/env'],\n\n\t/**\n\t * Jest 配置\n\t * Jest configuration\n\t *\n\t * 僅放置 .tpl 樣板,正式設定檔交由工作區層級建立\n\t * Only the .tpl template is shipped here; the real config is created by the workspace layer\n\t */\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/**\n\t * 編輯器配置\n\t * Editor configuration\n\t */\n\t['.editorconfig.tpl', 'file/tpl.editorconfig'],\n\t['.editorconfig', 'file/tpl.editorconfig'],\n\n\t/**\n\t * 全域型別宣告\n\t * Global type declarations\n\t */\n\t['global.tsdx.d.ts', 'file/root/global.tsdx.d.ts'],\n\n\t/**\n\t * Browserslist 配置\n\t * Browserslist configuration\n\t */\n\t['.browserslistrc', 'file/ws-root/browserslistrc'],\n\n\t/**\n\t * TSC 多配置\n\t * TSC multi configuration\n\t */\n\t// ['tsc-multi.json.tpl', 'file/tsc-multi.json.tpl', 'tsc-multi.json'],\n\n\t/**\n\t * NYC 覆蓋率配置\n\t * NYC coverage configuration\n\t */\n\t// ['.nycrc.tpl', 'file/nycrc', '.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/**\n\t * Lerna 配置\n\t * Lerna configuration\n\t */\n\t['lerna.json.tpl', 'file/lerna.json.tpl'],\n\n\t/**\n\t * pnpm 工作區配置\n\t * pnpm workspace configuration\n\t */\n\t['pnpm-workspace.yaml', 'file/pnpm-workspace.yaml'],\n\n\t/**\n\t * TSC 多配置\n\t * TSC multi configuration\n\t */\n\t// ['tsc-multi.json.tpl', 'file/tsc-multi.json.tpl', 'tsc-multi.json'],\n\n\t/**\n\t * 工作區根目錄檔案\n\t * Workspace root file\n\t */\n\t['__root_ws.ts', 'file/ws-root/__root_ws.ts'],\n\n\t/**\n\t * Jest 配置\n\t * Jest configuration\n\t *\n\t * 工作區根目錄同時提供正式設定與樣板兩種形式\n\t * The workspace root ships both the real config and the template form\n\t */\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['jest.config.js.tpl', 'file/ws-root/jest.config.js'],\n\n\t/**\n\t * 執行配置\n\t * Run configurations\n\t */\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"]}