@yarn-tool/static-file 3.0.33 → 3.0.35
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.
- package/CHANGELOG.md +51 -0
- package/README.md +2 -2
- package/file/gitignore +16 -13
- package/file/npmignore +79 -14
- package/lib/const.d.ts +18 -1
- package/lib/const.js +20 -2
- package/lib/const.js.map +1 -1
- package/lib/copyStaticFilesByRootData.d.ts +52 -0
- package/lib/copyStaticFilesByRootData.js +53 -0
- package/lib/copyStaticFilesByRootData.js.map +1 -0
- package/lib/root/getRootCopyStaticFiles.d.ts +2 -1
- package/lib/root/getRootCopyStaticFiles.js +10 -0
- package/lib/root/getRootCopyStaticFiles.js.map +1 -1
- package/package.json +5 -3
- package/playwright.config.js.map +1 -0
- package/test/copyStaticFiles.test.js.map +1 -1
- package/test/copyStaticFiles.test.ts.snapshot +2 -22
- package/test/copyStaticFilesByRootData.test.js.map +1 -0
- package/test/copyStaticFilesByRootData.test.ts.snapshot +639 -0
- package/test/fixtures/empty-pkg/package.json +4 -0
- package/test/fixtures/out/gitignore +16 -13
- package/test/fixtures/out/npmignore +79 -14
- package/test/fixtures/split/git/00-header.txt +1 -1
- package/test/fixtures/split/git/10-project.txt +1 -1
- package/test/fixtures/split/git/20-test.txt +1 -1
- package/test/fixtures/split/git/40-env.txt +1 -1
- package/test/fixtures/split/git/90-misc.txt +1 -1
- package/test/fixtures/split/git/99-whitelist.txt +1 -1
- package/test/fixtures/split/npm/01-hidden.txt +1 -1
- package/test/fixtures/split/npm/05-source.txt +1 -1
- package/test/fixtures/split/npm/10-project.txt +1 -1
- package/test/fixtures/split/npm/20-test.txt +3 -1
- package/test/fixtures/split/npm/30-ide.txt +1 -1
- package/test/fixtures/split/npm/40-env.txt +1 -1
- package/test/fixtures/split/npm/90-misc.txt +1 -1
- package/test/fixtures/split/other/90-duplicates.txt +2 -2
- package/test/fixtures/split/shared/10-project.txt +1 -1
- package/test/fixtures/split/shared/20-test.txt +4 -1
- package/test/fixtures/split/shared/30-ide.txt +1 -1
- package/test/fixtures/split/shared/40-env.txt +1 -1
- package/test/fixtures/split/shared/90-misc.txt +1 -1
- package/test/scripts/compose-split-ignore-files.js +1 -1
- package/test/scripts/compose-split-ignore-files.js.map +1 -1
- package/test/scripts/lib/ignore-split.d.ts +24 -64
- package/test/scripts/lib/ignore-split.js +41 -75
- package/test/scripts/lib/ignore-split.js.map +1 -1
- package/test/scripts/split-ignore-files.js +19 -19
- package/test/scripts/split-ignore-files.js.map +1 -1
- package/test/scripts/update-npmignore-static-files.js +25 -2
- package/test/scripts/update-npmignore-static-files.js.map +1 -1
- package/file/playwright.config.ts +0 -6
- package/file/test/__root.js.map +0 -1
- package/file/test/temp.js.map +0 -1
- package/file/tsdx/index.cjs.map +0 -1
- package/file/tsdx/index.js.map +0 -1
- package/file/ws-root/__root_ws.js.map +0 -1
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
"use strict";
|
|
2
2
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
-
exports.IGNORE_SPLIT_GENERATORS = exports.SPLIT_ROOT = exports.IGNORE_SPLIT_TARGETS = exports.EMITTED_BUCKETS = exports.TOPICS = void 0;
|
|
3
|
+
exports.IGNORE_SPLIT_GENERATORS = exports.SPLIT_ROOT = exports.IGNORE_SPLIT_TARGETS = exports.EMITTED_BUCKETS = exports.TOPICS = exports.EnumIgnoreSplitTargetBucket = void 0;
|
|
4
4
|
exports.getSplitFragmentPath = getSplitFragmentPath;
|
|
5
5
|
exports.genTestBuildArtifacts = genTestBuildArtifacts;
|
|
6
6
|
exports.genSourceMaps = genSourceMaps;
|
|
@@ -10,41 +10,31 @@ exports.readSplitFragment = readSplitFragment;
|
|
|
10
10
|
exports.expandGenPlaceholders = expandGenPlaceholders;
|
|
11
11
|
/**
|
|
12
12
|
* 忽略規則分割片段的主題定義與共用輔助(分割與組合腳本的單一事實來源)
|
|
13
|
-
* Topic definitions and shared helpers of the split ignore-rule fragments
|
|
14
|
-
* (the single source of truth for the split and compose scripts)
|
|
15
13
|
*
|
|
16
14
|
* 片段檔案位於 test/fixtures/split/{git,npm,shared,other}/NN-topic.txt,
|
|
17
15
|
* 依「第一層 git 專用 / npm 發布專用 / 兩類共用 / 其他、第二層主題分類」保存。
|
|
18
16
|
*
|
|
19
|
-
* Fragments live in test/fixtures/split/{git,npm,shared,other}/NN-topic.txt,
|
|
20
|
-
* sorted by the first-level buckets (git-only / npm-only / shared / other)
|
|
21
|
-
* and the second-level topics below.
|
|
22
|
-
*
|
|
23
17
|
* 重複的語法矩陣(測試建置產物、*.map、spec 副檔名…)不逐行手寫:
|
|
24
18
|
* 片段中只放 `# %gen:NAME%` 佔位行,組合時由本檔的產生器展開,
|
|
25
19
|
* 以單一事實來源避免多份手抄副本漂移。
|
|
26
20
|
*
|
|
27
|
-
* Repetitive matrices (test build artifacts, *.map, spec filenames…) are never
|
|
28
|
-
* hand-copied: fragments only carry a `# %gen:NAME%` placeholder line, which the
|
|
29
|
-
* generators below expand at composition time — a single source of truth instead
|
|
30
|
-
* of drifting manual copies.
|
|
31
|
-
*
|
|
32
21
|
* 本檔是「分割(split-ignore-files.ts)」與「組合(compose-split-ignore-files.ts)」
|
|
33
22
|
* 兩支腳本的共用事實來源:主題、分類 ↔ 檔名、片段路徑慣例與輔助區塊定義都只存在於此。
|
|
34
|
-
* This file is the shared source of truth for both scripts (split-ignore-files.ts
|
|
35
|
-
* and compose-split-ignore-files.ts): topics, the bucket ↔ file name mapping, the
|
|
36
|
-
* fragment path convention, and the generator blocks are all defined here only.
|
|
37
23
|
*/
|
|
38
24
|
const fs_1 = require("fs");
|
|
39
25
|
const path_1 = require("path");
|
|
40
26
|
const __root_1 = require("../../__root");
|
|
27
|
+
var EnumIgnoreSplitTargetBucket;
|
|
28
|
+
(function (EnumIgnoreSplitTargetBucket) {
|
|
29
|
+
EnumIgnoreSplitTargetBucket["git"] = "git";
|
|
30
|
+
EnumIgnoreSplitTargetBucket["npm"] = "npm";
|
|
31
|
+
EnumIgnoreSplitTargetBucket["shared"] = "shared";
|
|
32
|
+
EnumIgnoreSplitTargetBucket["other"] = "other";
|
|
33
|
+
})(EnumIgnoreSplitTargetBucket || (exports.EnumIgnoreSplitTargetBucket = EnumIgnoreSplitTargetBucket = {}));
|
|
41
34
|
/**
|
|
42
35
|
* 二層分類主題,陣列順序即全域組合順序
|
|
43
|
-
* Second-level topics; the array order is the global assembly order
|
|
44
36
|
*
|
|
45
37
|
* 編號前綴刻意留出間隙(05、10、20…),方便日後插入新主題而不需重排。
|
|
46
|
-
* The numeric prefixes leave gaps (05, 10, 20…) so new topics can be inserted
|
|
47
|
-
* without renumbering the rest.
|
|
48
38
|
*/
|
|
49
39
|
exports.TOPICS = [
|
|
50
40
|
{ id: '00-header', zh: '檔案頭', en: 'file header' },
|
|
@@ -59,56 +49,46 @@ exports.TOPICS = [
|
|
|
59
49
|
];
|
|
60
50
|
/**
|
|
61
51
|
* 會輸出到組合結果的分類(other 永不輸出)
|
|
62
|
-
* Buckets emitted into the composed output (other is never emitted)
|
|
63
52
|
*/
|
|
64
|
-
exports.EMITTED_BUCKETS = [
|
|
53
|
+
exports.EMITTED_BUCKETS = [EnumIgnoreSplitTargetBucket.git, EnumIgnoreSplitTargetBucket.npm, EnumIgnoreSplitTargetBucket.shared];
|
|
65
54
|
/**
|
|
66
55
|
* 組合目標:分類與對應的 ignore 檔名,為「分類 ↔ 檔名」的單一事實來源
|
|
67
|
-
* Composition targets: the bucket and its ignore file name — the single source
|
|
68
|
-
* of truth for the bucket ↔ file-name mapping
|
|
69
56
|
*/
|
|
70
57
|
exports.IGNORE_SPLIT_TARGETS = [
|
|
71
|
-
{ bucket:
|
|
72
|
-
{ bucket:
|
|
58
|
+
{ bucket: EnumIgnoreSplitTargetBucket.git, fileName: 'gitignore' },
|
|
59
|
+
{ bucket: EnumIgnoreSplitTargetBucket.npm, fileName: 'npmignore' },
|
|
73
60
|
];
|
|
74
61
|
/**
|
|
75
|
-
* 分類片段的根目錄
|
|
62
|
+
* 分類片段的根目錄
|
|
76
63
|
*/
|
|
77
64
|
exports.SPLIT_ROOT = (0, path_1.join)(__root_1.__ROOT, 'test', 'fixtures', 'split');
|
|
78
65
|
/**
|
|
79
66
|
* 取得片段檔案路徑,命名慣例為 `<分類>/<主題>.txt`
|
|
80
|
-
* Get a fragment file path, following the `<bucket>/<topic>.txt` naming convention
|
|
81
67
|
*
|
|
82
68
|
* 分割腳本與組合腳本共用此函式,避免各自拼出不同的存放位置。
|
|
83
|
-
* Shared by the split and compose scripts so neither builds its own location.
|
|
84
69
|
*
|
|
85
|
-
* @param bucket - 分類
|
|
86
|
-
* @param topic - 主題編號
|
|
87
|
-
* @returns 片段檔案的絕對路徑
|
|
70
|
+
* @param bucket - 分類
|
|
71
|
+
* @param topic - 主題編號
|
|
72
|
+
* @returns 片段檔案的絕對路徑
|
|
88
73
|
*/
|
|
89
74
|
function getSplitFragmentPath(bucket, topic) {
|
|
90
75
|
return (0, path_1.join)(exports.SPLIT_ROOT, bucket, `${topic}.txt`);
|
|
91
76
|
}
|
|
92
77
|
/**
|
|
93
|
-
* 片段中的佔位行:`# %gen:<名稱>%`
|
|
94
78
|
* Placeholder line inside a fragment: `# %gen:<name>%`
|
|
95
79
|
*/
|
|
96
80
|
const GEN_PLACEHOLDER_RE = /^# %gen:([a-z0-9-]+)%$/;
|
|
97
81
|
/**
|
|
98
82
|
* git:測試建置產物矩陣
|
|
99
|
-
* git: test build artifact matrix
|
|
100
83
|
*
|
|
101
84
|
* 覆蓋 temp 產物、source map,以及 js/d.ts、mjs/d.mts、cjs/d.cts 三個族系
|
|
102
85
|
* 在 test、tests、packages/* 等目錄下的組合。
|
|
103
86
|
*
|
|
104
|
-
*
|
|
105
|
-
* families across the test, tests, and packages/* directories.
|
|
106
|
-
*
|
|
107
|
-
* @returns 片段內容行(含分類說明註解與組內空行)/ Fragment lines (including its description comment and intra-group blanks)
|
|
87
|
+
* @returns 片段內容行(含分類說明註解與組內空行)
|
|
108
88
|
*/
|
|
109
89
|
function genTestBuildArtifacts() {
|
|
110
90
|
const lines = [
|
|
111
|
-
'#
|
|
91
|
+
'# test build artifacts (generated by shared helper)',
|
|
112
92
|
];
|
|
113
93
|
for (const dir of ['test', 'tests']) {
|
|
114
94
|
lines.push(`${dir}/temp*`, `${dir}/**/*.map`);
|
|
@@ -116,8 +96,6 @@ function genTestBuildArtifacts() {
|
|
|
116
96
|
lines.push('/packages/*/test/temp*', '/packages/*/tests/temp*', '');
|
|
117
97
|
/**
|
|
118
98
|
* 每個族系:實作副檔名與其聲明檔配對,重複的目錄組合交給迴圈展開
|
|
119
|
-
* Per family: the implementation extension paired with its declaration file,
|
|
120
|
-
* with the repeated directory combinations expanded by the loop
|
|
121
99
|
*/
|
|
122
100
|
const families = [
|
|
123
101
|
['js', 'd.ts'],
|
|
@@ -140,17 +118,14 @@ function genTestBuildArtifacts() {
|
|
|
140
118
|
}
|
|
141
119
|
/**
|
|
142
120
|
* git:*.map 對應檔規則
|
|
143
|
-
* git: *.map source file rules
|
|
144
121
|
*
|
|
145
122
|
* 六種模組副檔名的對應檔,一行一個族系無法由其他規則取代,故集中產生。
|
|
146
|
-
* The mapping files of six module extensions; centralized here since no single
|
|
147
|
-
* rule can cover them.
|
|
148
123
|
*
|
|
149
|
-
* @returns 片段內容行
|
|
124
|
+
* @returns 片段內容行
|
|
150
125
|
*/
|
|
151
126
|
function genSourceMaps() {
|
|
152
127
|
return [
|
|
153
|
-
'# *.map
|
|
128
|
+
'# *.map files (generated by shared helper)',
|
|
154
129
|
'*.js.map',
|
|
155
130
|
'*.cjs.map',
|
|
156
131
|
'*.mjs.map',
|
|
@@ -161,22 +136,26 @@ function genSourceMaps() {
|
|
|
161
136
|
}
|
|
162
137
|
/**
|
|
163
138
|
* npm:spec / test 副檔名矩陣
|
|
164
|
-
* npm: spec & test filename matrix
|
|
165
139
|
*
|
|
166
140
|
* 四種前綴(spec、test、node-spec、node-test)× 四組副檔名族系
|
|
167
141
|
* (d.ts+js/ts、d.cts+cjs/cts、d.mts+mjs/mts、d.tsx+tsx)的笛卡兒積。
|
|
168
142
|
*
|
|
169
|
-
* The cartesian product of four prefixes (spec, test, node-spec, node-test)
|
|
170
|
-
* and four extension families (d.ts+js/ts, d.cts+cjs/cts, d.mts+mjs/mts,
|
|
171
|
-
* d.tsx+tsx).
|
|
172
|
-
*
|
|
173
143
|
* @returns 片段內容行 / Fragment lines
|
|
174
144
|
*/
|
|
175
145
|
function genSpecFiles() {
|
|
176
146
|
const lines = [
|
|
177
|
-
'# spec
|
|
147
|
+
'# spec & test filename matrix (generated by shared helper)',
|
|
148
|
+
];
|
|
149
|
+
const prefixes = [
|
|
150
|
+
'spec',
|
|
151
|
+
'test',
|
|
152
|
+
'node-spec',
|
|
153
|
+
'node-test',
|
|
154
|
+
'playwright-spec',
|
|
155
|
+
'playwright-test',
|
|
156
|
+
'playwright.spec',
|
|
157
|
+
'playwright.test',
|
|
178
158
|
];
|
|
179
|
-
const prefixes = ['spec', 'test', 'node-spec', 'node-test'];
|
|
180
159
|
const families = [
|
|
181
160
|
{ decl: 'd.ts', impls: ['js', 'ts'] },
|
|
182
161
|
{ decl: 'd.cts', impls: ['cjs', 'cts'] },
|
|
@@ -201,20 +180,15 @@ function genSpecFiles() {
|
|
|
201
180
|
}
|
|
202
181
|
/**
|
|
203
182
|
* npm:來源與聲明檔規則群
|
|
204
|
-
* npm: source & declaration rule groups
|
|
205
183
|
*
|
|
206
184
|
* 三種聲明副檔名(d.ts、d.mts、d.cts)各自的白名單與 /bin 目錄規則,
|
|
207
185
|
* 必須維持在相鄰行才能與前後的排除規則正確互動。
|
|
208
186
|
*
|
|
209
|
-
*
|
|
210
|
-
* (d.ts, d.mts, d.cts); they must stay on adjacent lines to interact correctly
|
|
211
|
-
* with the surrounding exclusion rules.
|
|
212
|
-
*
|
|
213
|
-
* @returns 片段內容行 / Fragment lines
|
|
187
|
+
* @returns 片段內容行
|
|
214
188
|
*/
|
|
215
189
|
function genNpmSourceDeclarations() {
|
|
216
190
|
const lines = [
|
|
217
|
-
'# npm
|
|
191
|
+
'# npm source & declaration rules (generated by shared helper)',
|
|
218
192
|
];
|
|
219
193
|
['d.ts', 'd.mts', 'd.cts'].forEach((decl, index) => {
|
|
220
194
|
if (index) {
|
|
@@ -226,27 +200,22 @@ function genNpmSourceDeclarations() {
|
|
|
226
200
|
}
|
|
227
201
|
/**
|
|
228
202
|
* 產生器註冊表:鍵名對應片段中的 `# %gen:NAME%` 佔位名稱
|
|
229
|
-
* Generator registry: keys match the `# %gen:NAME%` placeholder names in fragments
|
|
230
203
|
*/
|
|
231
204
|
exports.IGNORE_SPLIT_GENERATORS = {
|
|
232
|
-
'test-build-artifacts': { generate: genTestBuildArtifacts, topic: '20-test', bucket:
|
|
233
|
-
'source-maps': { generate: genSourceMaps, topic: '10-project', bucket:
|
|
234
|
-
'spec-files': { generate: genSpecFiles, topic: '20-test', bucket:
|
|
235
|
-
'npm-source-declarations': { generate: genNpmSourceDeclarations, topic: '05-source', bucket:
|
|
205
|
+
'test-build-artifacts': { generate: genTestBuildArtifacts, topic: '20-test', bucket: EnumIgnoreSplitTargetBucket.git },
|
|
206
|
+
'source-maps': { generate: genSourceMaps, topic: '10-project', bucket: EnumIgnoreSplitTargetBucket.git },
|
|
207
|
+
'spec-files': { generate: genSpecFiles, topic: '20-test', bucket: EnumIgnoreSplitTargetBucket.npm },
|
|
208
|
+
'npm-source-declarations': { generate: genNpmSourceDeclarations, topic: '05-source', bucket: EnumIgnoreSplitTargetBucket.npm },
|
|
236
209
|
};
|
|
237
210
|
/**
|
|
238
211
|
* 讀取單一分類片段的所有行
|
|
239
|
-
* Read every line of a single classified fragment
|
|
240
212
|
*
|
|
241
213
|
* 片段首行是分類標頭(主題 × 分類),組合時保留為輸出檔的區段標記;
|
|
242
214
|
* 檔案不存在(該分類 × 主題沒有片段)時回傳空陣列。
|
|
243
|
-
* The first line is the classification header (topic × bucket), kept as the
|
|
244
|
-
* section marker of the composed output; a missing file (no fragment for that
|
|
245
|
-
* bucket × topic combination) yields an empty array.
|
|
246
215
|
*
|
|
247
|
-
* @param bucket - 分類:git、npm 或 shared
|
|
248
|
-
* @param topic - 主題編號({@link TOPICS} 的 id
|
|
249
|
-
* @returns
|
|
216
|
+
* @param bucket - 分類:git、npm 或 shared
|
|
217
|
+
* @param topic - 主題編號({@link TOPICS} 的 id)
|
|
218
|
+
* @returns 片段行陣列(已去除結尾空行)
|
|
250
219
|
*/
|
|
251
220
|
function readSplitFragment(bucket, topic) {
|
|
252
221
|
const path = getSplitFragmentPath(bucket, topic);
|
|
@@ -261,14 +230,11 @@ function readSplitFragment(bucket, topic) {
|
|
|
261
230
|
}
|
|
262
231
|
/**
|
|
263
232
|
* 將 `# %gen:NAME%` 佔位行展開為對應產生器的輸出
|
|
264
|
-
* Expand `# %gen:NAME%` placeholder lines into the matching generator output
|
|
265
233
|
*
|
|
266
234
|
* 其餘行原樣保留;遇到未註冊的佔位名稱時拋錯,避免靜默產出不完整的檔案。
|
|
267
|
-
* All other lines pass through unchanged; an unregistered placeholder name
|
|
268
|
-
* throws instead of silently producing an incomplete file.
|
|
269
235
|
*
|
|
270
|
-
* @param lines - 組合後的行陣列
|
|
271
|
-
* @returns 展開後的行陣列
|
|
236
|
+
* @param lines - 組合後的行陣列
|
|
237
|
+
* @returns 展開後的行陣列
|
|
272
238
|
*/
|
|
273
239
|
function expandGenPlaceholders(lines) {
|
|
274
240
|
return lines.flatMap((line) => {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"ignore-split.js","sourceRoot":"","sources":["ignore-split.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * 忽略規則分割片段的主題定義與共用輔助(分割與組合腳本的單一事實來源)\n * Topic definitions and shared helpers of the split ignore-rule fragments\n * (the single source of truth for the split and compose scripts)\n *\n * 片段檔案位於 test/fixtures/split/{git,npm,shared,other}/NN-topic.txt,\n * 依「第一層 git 專用 / npm 發布專用 / 兩類共用 / 其他、第二層主題分類」保存。\n *\n * Fragments live in test/fixtures/split/{git,npm,shared,other}/NN-topic.txt,\n * sorted by the first-level buckets (git-only / npm-only / shared / other)\n * and the second-level topics below.\n *\n * 重複的語法矩陣(測試建置產物、*.map、spec 副檔名…)不逐行手寫:\n * 片段中只放 `# %gen:NAME%` 佔位行,組合時由本檔的產生器展開,\n * 以單一事實來源避免多份手抄副本漂移。\n *\n * Repetitive matrices (test build artifacts, *.map, spec filenames…) are never\n * hand-copied: fragments only carry a `# %gen:NAME%` placeholder line, which the\n * generators below expand at composition time — a single source of truth instead\n * of drifting manual copies.\n *\n * 本檔是「分割(split-ignore-files.ts)」與「組合(compose-split-ignore-files.ts)」\n * 兩支腳本的共用事實來源:主題、分類 ↔ 檔名、片段路徑慣例與輔助區塊定義都只存在於此。\n * This file is the shared source of truth for both scripts (split-ignore-files.ts\n * and compose-split-ignore-files.ts): topics, the bucket ↔ file name mapping, the\n * fragment path convention, and the generator blocks are all defined here only.\n */\nimport { existsSync, readFileSync } from 'fs';\nimport { join } from 'path';\nimport { __ROOT } from '../../__root';\n\n/**\n * 二層分類主題,陣列順序即全域組合順序\n * Second-level topics; the array order is the global assembly order\n *\n * 編號前綴刻意留出間隙(05、10、20…),方便日後插入新主題而不需重排。\n * The numeric prefixes leave gaps (05, 10, 20…) so new topics can be inserted\n * without renumbering the rest.\n */\nexport const TOPICS = [\n\t{ id: '00-header', zh: '檔案頭', en: 'file header' },\n\t{ id: '01-hidden', zh: '根目錄隱藏檔', en: 'root hidden files' },\n\t{ id: '05-source', zh: 'npm 來源檔規則', en: 'npm source rules' },\n\t{ id: '10-project', zh: '專案檔', en: 'project files' },\n\t{ id: '20-test', zh: '測試檔', en: 'test files' },\n\t{ id: '30-ide', zh: 'IDE 與編輯器設定', en: 'IDE & editor settings' },\n\t{ id: '40-env', zh: '環境設定', en: 'environment settings' },\n\t{ id: '90-misc', zh: '未分類', en: 'unclassified' },\n\t{ id: '99-whitelist', zh: '白名單例外', en: 'whitelist exceptions' },\n] as const;\n\n/**\n * 主題 id 的聯合型別,由 {@link TOPICS} 派生\n * Union of topic ids, derived from {@link TOPICS}\n */\nexport type IIgnoreSplitTopicId = typeof TOPICS[number]['id'];\n\n/**\n * 會輸出到組合結果的分類(other 永不輸出)\n * Buckets emitted into the composed output (other is never emitted)\n */\nexport const EMITTED_BUCKETS = ['git', 'npm', 'shared'] as const;\n\n/**\n * 輸出分類的聯合型別,由 {@link EMITTED_BUCKETS} 派生\n * Union of emitted buckets, derived from {@link EMITTED_BUCKETS}\n */\nexport type IIgnoreSplitEmittedBucket = typeof EMITTED_BUCKETS[number];\n\n/**\n * 全部分類的聯合型別(含永不輸出的 other)\n * Union of all buckets (including the never-emitted other)\n */\nexport type IIgnoreSplitBucket = IIgnoreSplitEmittedBucket | 'other';\n\n/**\n * 組合目標:分類與對應的 ignore 檔名,為「分類 ↔ 檔名」的單一事實來源\n * Composition targets: the bucket and its ignore file name — the single source\n * of truth for the bucket ↔ file-name mapping\n */\nexport const IGNORE_SPLIT_TARGETS = [\n\t{ bucket: 'git', fileName: 'gitignore' },\n\t{ bucket: 'npm', fileName: 'npmignore' },\n] as const;\n\n/**\n * 可作為組合目標的分類,由 {@link IGNORE_SPLIT_TARGETS} 派生\n * Buckets usable as composition targets, derived from {@link IGNORE_SPLIT_TARGETS}\n */\nexport type IIgnoreSplitTargetBucket = typeof IGNORE_SPLIT_TARGETS[number]['bucket'];\n\n/**\n * 分類片段的根目錄 / Root directory of the classified fragments\n */\nexport const SPLIT_ROOT = join(__ROOT, 'test', 'fixtures', 'split');\n\n/**\n * 取得片段檔案路徑,命名慣例為 `<分類>/<主題>.txt`\n * Get a fragment file path, following the `<bucket>/<topic>.txt` naming convention\n *\n * 分割腳本與組合腳本共用此函式,避免各自拼出不同的存放位置。\n * Shared by the split and compose scripts so neither builds its own location.\n *\n * @param bucket - 分類 / Bucket\n * @param topic - 主題編號 / Topic id\n * @returns 片段檔案的絕對路徑 / The absolute path of the fragment file\n */\nexport function getSplitFragmentPath(bucket: string, topic: string): string\n{\n\treturn join(SPLIT_ROOT, bucket, `${topic}.txt`);\n}\n\n/**\n * 片段中的佔位行:`# %gen:<名稱>%`\n * Placeholder line inside a fragment: `# %gen:<name>%`\n */\nconst GEN_PLACEHOLDER_RE = /^# %gen:([a-z0-9-]+)%$/;\n\n/**\n * git:測試建置產物矩陣\n * git: test build artifact matrix\n *\n * 覆蓋 temp 產物、source map,以及 js/d.ts、mjs/d.mts、cjs/d.cts 三個族系\n * 在 test、tests、packages/* 等目錄下的組合。\n *\n * Covers temp artifacts, source maps, and the js/d.ts, mjs/d.mts, cjs/d.cts\n * families across the test, tests, and packages/* directories.\n *\n * @returns 片段內容行(含分類說明註解與組內空行)/ Fragment lines (including its description comment and intra-group blanks)\n */\nexport function genTestBuildArtifacts(): string[]\n{\n\tconst lines: string[] = [\n\t\t'# 測試建置產物(共用輔助產生)/ test build artifacts (generated by shared helper)',\n\t];\n\n\tfor (const dir of ['test', 'tests'])\n\t{\n\t\tlines.push(`${dir}/temp*`, `${dir}/**/*.map`);\n\t}\n\n\tlines.push('/packages/*/test/temp*', '/packages/*/tests/temp*', '');\n\n\t/**\n\t * 每個族系:實作副檔名與其聲明檔配對,重複的目錄組合交給迴圈展開\n\t * Per family: the implementation extension paired with its declaration file,\n\t * with the repeated directory combinations expanded by the loop\n\t */\n\tconst families: [string, string][] = [\n\t\t['js', 'd.ts'],\n\t\t['mjs', 'd.mts'],\n\t\t['cjs', 'd.cts'],\n\t];\n\n\tfamilies.forEach(([ext, decl], index) =>\n\t{\n\t\tif (index)\n\t\t{\n\t\t\tlines.push('');\n\t\t}\n\n\t\tfor (const dir of ['test', 'tests'])\n\t\t{\n\t\t\tlines.push(`${dir}/**/*.${ext}`, `${dir}/**/*.${decl}`, `${dir}/*.${ext}`, `${dir}/*.${decl}`);\n\t\t}\n\n\t\tlines.push(`bin/*.${decl}`, `bin/**/*.${decl}`, `/packages/*/bin/*.${decl}`);\n\n\t\tfor (const dir of ['/packages/*/test', '/packages/*/tests'])\n\t\t{\n\t\t\tlines.push(`${dir}/**/*.${ext}`, `${dir}/**/*.${decl}`, `${dir}/*.${ext}`, `${dir}/*.${decl}`);\n\t\t}\n\t});\n\n\treturn lines;\n}\n\n/**\n * git:*.map 對應檔規則\n * git: *.map source file rules\n *\n * 六種模組副檔名的對應檔,一行一個族系無法由其他規則取代,故集中產生。\n * The mapping files of six module extensions; centralized here since no single\n * rule can cover them.\n *\n * @returns 片段內容行 / Fragment lines\n */\nexport function genSourceMaps(): string[]\n{\n\treturn [\n\t\t'# *.map 對應檔(共用輔助產生)/ *.map files (generated by shared helper)',\n\t\t'*.js.map',\n\t\t'*.cjs.map',\n\t\t'*.mjs.map',\n\t\t'*.ts.map',\n\t\t'*.cts.map',\n\t\t'*.mts.map',\n\t];\n}\n\n/**\n * npm:spec / test 副檔名矩陣\n * npm: spec & test filename matrix\n *\n * 四種前綴(spec、test、node-spec、node-test)× 四組副檔名族系\n * (d.ts+js/ts、d.cts+cjs/cts、d.mts+mjs/mts、d.tsx+tsx)的笛卡兒積。\n *\n * The cartesian product of four prefixes (spec, test, node-spec, node-test)\n * and four extension families (d.ts+js/ts, d.cts+cjs/cts, d.mts+mjs/mts,\n * d.tsx+tsx).\n *\n * @returns 片段內容行 / Fragment lines\n */\nexport function genSpecFiles(): string[]\n{\n\tconst lines: string[] = [\n\t\t'# spec / test 副檔名矩陣(共用輔助產生)/ spec & test filename matrix (generated by shared helper)',\n\t];\n\n\tconst prefixes = ['spec', 'test', 'node-spec', 'node-test'];\n\n\tconst families = [\n\t\t{ decl: 'd.ts', impls: ['js', 'ts'] },\n\t\t{ decl: 'd.cts', impls: ['cjs', 'cts'] },\n\t\t{ decl: 'd.mts', impls: ['mjs', 'mts'] },\n\t\t{ decl: 'd.tsx', impls: ['tsx'] },\n\t];\n\n\tprefixes.forEach((prefix, prefixIndex) =>\n\t{\n\t\tif (prefixIndex)\n\t\t{\n\t\t\tlines.push('');\n\t\t}\n\n\t\tfamilies.forEach((family, familyIndex) =>\n\t\t{\n\t\t\tif (familyIndex)\n\t\t\t{\n\t\t\t\tlines.push('');\n\t\t\t}\n\n\t\t\tlines.push(`*.${prefix}.${family.decl}`);\n\n\t\t\tfor (const impl of family.impls)\n\t\t\t{\n\t\t\t\tlines.push(`*.${prefix}.${impl}`);\n\t\t\t}\n\t\t});\n\t});\n\n\treturn lines;\n}\n\n/**\n * npm:來源與聲明檔規則群\n * npm: source & declaration rule groups\n *\n * 三種聲明副檔名(d.ts、d.mts、d.cts)各自的白名單與 /bin 目錄規則,\n * 必須維持在相鄰行才能與前後的排除規則正確互動。\n *\n * The whitelist and /bin rules for the three declaration extensions\n * (d.ts, d.mts, d.cts); they must stay on adjacent lines to interact correctly\n * with the surrounding exclusion rules.\n *\n * @returns 片段內容行 / Fragment lines\n */\nexport function genNpmSourceDeclarations(): string[]\n{\n\tconst lines: string[] = [\n\t\t'# npm 來源與聲明檔規則(共用輔助產生)/ npm source & declaration rules (generated by shared helper)',\n\t];\n\n\t['d.ts', 'd.mts', 'd.cts'].forEach((decl, index) =>\n\t{\n\t\tif (index)\n\t\t{\n\t\t\tlines.push('');\n\t\t}\n\n\t\tlines.push(`!*.${decl}`, `/bin/**/*.${decl}`, `/bin/*.${decl}`);\n\t});\n\n\treturn lines;\n}\n\n/**\n * 共用輔助區塊的註冊資料:產生函式、所屬主題與所屬分類都登记在此,\n * 分割腳本據此決定佔位行寫入哪個片段,組合腳本據此展開佔位內容\n * Registration of a shared generator: the generate function, its topic, and its\n * bucket all live here, so the split script knows which fragment receives the\n * placeholder line and the compose script knows what to expand it into\n */\nexport interface IIgnoreSplitGenerator\n{\n\t/**\n\t * 產生區塊內容(含說明註解與組內空行)\n\t * Produce the block content (including its description comment and intra-group blanks)\n\t */\n\tgenerate: () => string[];\n\n\t/**\n\t * 區塊所屬主題 / The topic this block belongs to\n\t */\n\ttopic: IIgnoreSplitTopicId;\n\n\t/**\n\t * 區塊所屬分類;只有目標分類(git / npm)會以輔助產生\n\t * Bucket of the block; only target buckets (git / npm) are produced by helpers\n\t */\n\tbucket: IIgnoreSplitTargetBucket;\n}\n\n/**\n * 產生器註冊表:鍵名對應片段中的 `# %gen:NAME%` 佔位名稱\n * Generator registry: keys match the `# %gen:NAME%` placeholder names in fragments\n */\nexport const IGNORE_SPLIT_GENERATORS: Record<string, IIgnoreSplitGenerator> = {\n\t'test-build-artifacts': { generate: genTestBuildArtifacts, topic: '20-test', bucket: 'git' },\n\t'source-maps': { generate: genSourceMaps, topic: '10-project', bucket: 'git' },\n\t'spec-files': { generate: genSpecFiles, topic: '20-test', bucket: 'npm' },\n\t'npm-source-declarations': { generate: genNpmSourceDeclarations, topic: '05-source', bucket: 'npm' },\n};\n\n/**\n * 讀取單一分類片段的所有行\n * Read every line of a single classified fragment\n *\n * 片段首行是分類標頭(主題 × 分類),組合時保留為輸出檔的區段標記;\n * 檔案不存在(該分類 × 主題沒有片段)時回傳空陣列。\n * The first line is the classification header (topic × bucket), kept as the\n * section marker of the composed output; a missing file (no fragment for that\n * bucket × topic combination) yields an empty array.\n *\n * @param bucket - 分類:git、npm 或 shared / Bucket: git, npm, or shared\n * @param topic - 主題編號({@link TOPICS} 的 id)/ Topic id (see {@link TOPICS})\n * @returns 片段行陣列(已去除結尾空行)/ Fragment lines (trailing blanks removed)\n */\nexport function readSplitFragment(bucket: string, topic: string): string[]\n{\n\tconst path = getSplitFragmentPath(bucket, topic);\n\n\tif (!existsSync(path))\n\t{\n\t\treturn [];\n\t}\n\n\tconst lines = readFileSync(path, 'utf8').split(/\\r?\\n/);\n\n\twhile (lines.length > 0 && lines[lines.length - 1] === '')\n\t{\n\t\tlines.pop();\n\t}\n\n\treturn lines;\n}\n\n/**\n * 將 `# %gen:NAME%` 佔位行展開為對應產生器的輸出\n * Expand `# %gen:NAME%` placeholder lines into the matching generator output\n *\n * 其餘行原樣保留;遇到未註冊的佔位名稱時拋錯,避免靜默產出不完整的檔案。\n * All other lines pass through unchanged; an unregistered placeholder name\n * throws instead of silently producing an incomplete file.\n *\n * @param lines - 組合後的行陣列 / The assembled line array\n * @returns 展開後的行陣列 / The expanded line array\n */\nexport function expandGenPlaceholders(lines: readonly string[]): string[]\n{\n\treturn lines.flatMap((line) =>\n\t{\n\t\tconst matched = GEN_PLACEHOLDER_RE.exec(line);\n\n\t\tif (!matched)\n\t\t{\n\t\t\treturn [line];\n\t\t}\n\n\t\tconst generator = IGNORE_SPLIT_GENERATORS[matched[1]];\n\n\t\tif (!generator)\n\t\t{\n\t\t\tthrow new Error(`unknown ignore split generator placeholder: ${line}`);\n\t\t}\n\n\t\treturn generator.generate();\n\t});\n}\n"]}
|
|
1
|
+
{"version":3,"file":"ignore-split.js","sourceRoot":"","sources":["ignore-split.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * 忽略規則分割片段的主題定義與共用輔助(分割與組合腳本的單一事實來源)\n *\n * 片段檔案位於 test/fixtures/split/{git,npm,shared,other}/NN-topic.txt,\n * 依「第一層 git 專用 / npm 發布專用 / 兩類共用 / 其他、第二層主題分類」保存。\n *\n * 重複的語法矩陣(測試建置產物、*.map、spec 副檔名…)不逐行手寫:\n * 片段中只放 `# %gen:NAME%` 佔位行,組合時由本檔的產生器展開,\n * 以單一事實來源避免多份手抄副本漂移。\n *\n * 本檔是「分割(split-ignore-files.ts)」與「組合(compose-split-ignore-files.ts)」\n * 兩支腳本的共用事實來源:主題、分類 ↔ 檔名、片段路徑慣例與輔助區塊定義都只存在於此。\n */\nimport { existsSync, readFileSync } from 'fs';\nimport { join } from 'path';\nimport { __ROOT } from '../../__root';\n\nexport enum EnumIgnoreSplitTargetBucket\n{\n\tgit = 'git',\n\tnpm = 'npm',\n\tshared = 'shared',\n\tother = 'other',\n}\n\n/**\n * 二層分類主題,陣列順序即全域組合順序\n *\n * 編號前綴刻意留出間隙(05、10、20…),方便日後插入新主題而不需重排。\n */\nexport const TOPICS = [\n\t{ id: '00-header', zh: '檔案頭', en: 'file header' },\n\t{ id: '01-hidden', zh: '根目錄隱藏檔', en: 'root hidden files' },\n\t{ id: '05-source', zh: 'npm 來源檔規則', en: 'npm source rules' },\n\t{ id: '10-project', zh: '專案檔', en: 'project files' },\n\t{ id: '20-test', zh: '測試檔', en: 'test files' },\n\t{ id: '30-ide', zh: 'IDE 與編輯器設定', en: 'IDE & editor settings' },\n\t{ id: '40-env', zh: '環境設定', en: 'environment settings' },\n\t{ id: '90-misc', zh: '未分類', en: 'unclassified' },\n\t{ id: '99-whitelist', zh: '白名單例外', en: 'whitelist exceptions' },\n] as const;\n\n/**\n * 主題 id 的聯合型別,由 {@link TOPICS} 派生\n */\nexport type IIgnoreSplitTopicId = typeof TOPICS[number]['id'];\n\n/**\n * 會輸出到組合結果的分類(other 永不輸出)\n */\nexport const EMITTED_BUCKETS = [EnumIgnoreSplitTargetBucket.git, EnumIgnoreSplitTargetBucket.npm, EnumIgnoreSplitTargetBucket.shared] as const;\n\n/**\n * 輸出分類的聯合型別,由 {@link EMITTED_BUCKETS} 派生\n */\nexport type IIgnoreSplitEmittedBucket = typeof EMITTED_BUCKETS[number];\n\n/**\n * 組合目標:分類與對應的 ignore 檔名,為「分類 ↔ 檔名」的單一事實來源\n */\nexport const IGNORE_SPLIT_TARGETS = [\n\t{ bucket: EnumIgnoreSplitTargetBucket.git, fileName: 'gitignore' },\n\t{ bucket: EnumIgnoreSplitTargetBucket.npm, fileName: 'npmignore' },\n] as const;\n\n/**\n * 可作為組合目標的分類,由 {@link IGNORE_SPLIT_TARGETS} 派生\n */\nexport type IIgnoreSplitTargetBucket = typeof IGNORE_SPLIT_TARGETS[number]['bucket'];\n\n/**\n * 分類片段的根目錄\n */\nexport const SPLIT_ROOT = join(__ROOT, 'test', 'fixtures', 'split');\n\n/**\n * 取得片段檔案路徑,命名慣例為 `<分類>/<主題>.txt`\n *\n * 分割腳本與組合腳本共用此函式,避免各自拼出不同的存放位置。\n *\n * @param bucket - 分類\n * @param topic - 主題編號\n * @returns 片段檔案的絕對路徑\n */\nexport function getSplitFragmentPath(bucket: EnumIgnoreSplitTargetBucket, topic: IIgnoreSplitTopicId): string\n{\n\treturn join(SPLIT_ROOT, bucket, `${topic}.txt`);\n}\n\n/**\n * Placeholder line inside a fragment: `# %gen:<name>%`\n */\nconst GEN_PLACEHOLDER_RE = /^# %gen:([a-z0-9-]+)%$/;\n\n/**\n * git:測試建置產物矩陣\n *\n * 覆蓋 temp 產物、source map,以及 js/d.ts、mjs/d.mts、cjs/d.cts 三個族系\n * 在 test、tests、packages/* 等目錄下的組合。\n *\n * @returns 片段內容行(含分類說明註解與組內空行)\n */\nexport function genTestBuildArtifacts(): string[]\n{\n\tconst lines: string[] = [\n\t\t'# test build artifacts (generated by shared helper)',\n\t];\n\n\tfor (const dir of ['test', 'tests'])\n\t{\n\t\tlines.push(`${dir}/temp*`, `${dir}/**/*.map`);\n\t}\n\n\tlines.push('/packages/*/test/temp*', '/packages/*/tests/temp*', '');\n\n\t/**\n\t * 每個族系:實作副檔名與其聲明檔配對,重複的目錄組合交給迴圈展開\n\t */\n\tconst families: [ext: string, decl: string][] = [\n\t\t['js', 'd.ts'],\n\t\t['mjs', 'd.mts'],\n\t\t['cjs', 'd.cts'],\n\t];\n\n\tfamilies.forEach(([ext, decl], index) =>\n\t{\n\t\tif (index)\n\t\t{\n\t\t\tlines.push('');\n\t\t}\n\n\t\tfor (const dir of ['test', 'tests'])\n\t\t{\n\t\t\tlines.push(`${dir}/**/*.${ext}`, `${dir}/**/*.${decl}`, `${dir}/*.${ext}`, `${dir}/*.${decl}`);\n\t\t}\n\n\t\tlines.push(`bin/*.${decl}`, `bin/**/*.${decl}`, `/packages/*/bin/*.${decl}`);\n\n\t\tfor (const dir of ['/packages/*/test', '/packages/*/tests'])\n\t\t{\n\t\t\tlines.push(`${dir}/**/*.${ext}`, `${dir}/**/*.${decl}`, `${dir}/*.${ext}`, `${dir}/*.${decl}`);\n\t\t}\n\t});\n\n\treturn lines;\n}\n\n/**\n * git:*.map 對應檔規則\n *\n * 六種模組副檔名的對應檔,一行一個族系無法由其他規則取代,故集中產生。\n *\n * @returns 片段內容行\n */\nexport function genSourceMaps(): string[]\n{\n\treturn [\n\t\t'# *.map files (generated by shared helper)',\n\t\t'*.js.map',\n\t\t'*.cjs.map',\n\t\t'*.mjs.map',\n\t\t'*.ts.map',\n\t\t'*.cts.map',\n\t\t'*.mts.map',\n\t];\n}\n\n/**\n * npm:spec / test 副檔名矩陣\n *\n * 四種前綴(spec、test、node-spec、node-test)× 四組副檔名族系\n * (d.ts+js/ts、d.cts+cjs/cts、d.mts+mjs/mts、d.tsx+tsx)的笛卡兒積。\n *\n * @returns 片段內容行 / Fragment lines\n */\nexport function genSpecFiles(): string[]\n{\n\tconst lines: string[] = [\n\t\t'# spec & test filename matrix (generated by shared helper)',\n\t];\n\n\tconst prefixes = [\n\t\t'spec',\n\t\t'test',\n\t\t'node-spec',\n\t\t'node-test',\n\t\t'playwright-spec',\n\t\t'playwright-test',\n\t\t'playwright.spec',\n\t\t'playwright.test',\n\t];\n\n\tconst families = [\n\t\t{ decl: 'd.ts', impls: ['js', 'ts'] },\n\t\t{ decl: 'd.cts', impls: ['cjs', 'cts'] },\n\t\t{ decl: 'd.mts', impls: ['mjs', 'mts'] },\n\t\t{ decl: 'd.tsx', impls: ['tsx'] },\n\t];\n\n\tprefixes.forEach((prefix, prefixIndex) =>\n\t{\n\t\tif (prefixIndex)\n\t\t{\n\t\t\tlines.push('');\n\t\t}\n\n\t\tfamilies.forEach((family, familyIndex) =>\n\t\t{\n\t\t\tif (familyIndex)\n\t\t\t{\n\t\t\t\tlines.push('');\n\t\t\t}\n\n\t\t\tlines.push(`*.${prefix}.${family.decl}`);\n\n\t\t\tfor (const impl of family.impls)\n\t\t\t{\n\t\t\t\tlines.push(`*.${prefix}.${impl}`);\n\t\t\t}\n\t\t});\n\t});\n\n\treturn lines;\n}\n\n/**\n * npm:來源與聲明檔規則群\n *\n * 三種聲明副檔名(d.ts、d.mts、d.cts)各自的白名單與 /bin 目錄規則,\n * 必須維持在相鄰行才能與前後的排除規則正確互動。\n *\n * @returns 片段內容行\n */\nexport function genNpmSourceDeclarations(): string[]\n{\n\tconst lines: string[] = [\n\t\t'# npm source & declaration rules (generated by shared helper)',\n\t];\n\n\t['d.ts', 'd.mts', 'd.cts'].forEach((decl, index) =>\n\t{\n\t\tif (index)\n\t\t{\n\t\t\tlines.push('');\n\t\t}\n\n\t\tlines.push(`!*.${decl}`, `/bin/**/*.${decl}`, `/bin/*.${decl}`);\n\t});\n\n\treturn lines;\n}\n\n/**\n * 共用輔助區塊的註冊資料:產生函式、所屬主題與所屬分類都登记在此,\n * 分割腳本據此決定佔位行寫入哪個片段,組合腳本據此展開佔位內容\n */\nexport interface IIgnoreSplitGenerator\n{\n\t/**\n\t * 產生區塊內容(含說明註解與組內空行)\n\t */\n\tgenerate: () => string[];\n\n\t/**\n\t * 區塊所屬主題\n\t */\n\ttopic: IIgnoreSplitTopicId;\n\n\t/**\n\t * 區塊所屬分類;只有目標分類(git / npm)會以輔助產生\n\t */\n\tbucket: IIgnoreSplitTargetBucket;\n}\n\n/**\n * 產生器註冊表:鍵名對應片段中的 `# %gen:NAME%` 佔位名稱\n */\nexport const IGNORE_SPLIT_GENERATORS: Record<string, IIgnoreSplitGenerator> = {\n\t'test-build-artifacts': { generate: genTestBuildArtifacts, topic: '20-test', bucket: EnumIgnoreSplitTargetBucket.git },\n\t'source-maps': { generate: genSourceMaps, topic: '10-project', bucket: EnumIgnoreSplitTargetBucket.git },\n\t'spec-files': { generate: genSpecFiles, topic: '20-test', bucket: EnumIgnoreSplitTargetBucket.npm },\n\t'npm-source-declarations': { generate: genNpmSourceDeclarations, topic: '05-source', bucket: EnumIgnoreSplitTargetBucket.npm },\n};\n\n/**\n * 讀取單一分類片段的所有行\n *\n * 片段首行是分類標頭(主題 × 分類),組合時保留為輸出檔的區段標記;\n * 檔案不存在(該分類 × 主題沒有片段)時回傳空陣列。\n *\n * @param bucket - 分類:git、npm 或 shared\n * @param topic - 主題編號({@link TOPICS} 的 id)\n * @returns 片段行陣列(已去除結尾空行)\n */\nexport function readSplitFragment(bucket: EnumIgnoreSplitTargetBucket, topic: IIgnoreSplitTopicId): string[]\n{\n\tconst path = getSplitFragmentPath(bucket, topic);\n\n\tif (!existsSync(path))\n\t{\n\t\treturn [];\n\t}\n\n\tconst lines = readFileSync(path, 'utf8').split(/\\r?\\n/);\n\n\twhile (lines.length > 0 && lines[lines.length - 1] === '')\n\t{\n\t\tlines.pop();\n\t}\n\n\treturn lines;\n}\n\n/**\n * 將 `# %gen:NAME%` 佔位行展開為對應產生器的輸出\n *\n * 其餘行原樣保留;遇到未註冊的佔位名稱時拋錯,避免靜默產出不完整的檔案。\n *\n * @param lines - 組合後的行陣列\n * @returns 展開後的行陣列\n */\nexport function expandGenPlaceholders(lines: readonly string[]): string[]\n{\n\treturn lines.flatMap((line) =>\n\t{\n\t\tconst matched = GEN_PLACEHOLDER_RE.exec(line);\n\n\t\tif (!matched)\n\t\t{\n\t\t\treturn [line];\n\t\t}\n\n\t\tconst generator = IGNORE_SPLIT_GENERATORS[matched[1]];\n\n\t\tif (!generator)\n\t\t{\n\t\t\tthrow new Error(`unknown ignore split generator placeholder: ${line}`);\n\t\t}\n\n\t\treturn generator.generate();\n\t});\n}\n"]}
|
|
@@ -83,8 +83,8 @@ const REDUNDANT = {
|
|
|
83
83
|
* it also appears in that other source
|
|
84
84
|
*/
|
|
85
85
|
const COMPLEMENT = {
|
|
86
|
-
git:
|
|
87
|
-
npm:
|
|
86
|
+
[ignore_split_1.EnumIgnoreSplitTargetBucket.git]: ignore_split_1.EnumIgnoreSplitTargetBucket.npm,
|
|
87
|
+
[ignore_split_1.EnumIgnoreSplitTargetBucket.npm]: ignore_split_1.EnumIgnoreSplitTargetBucket.git,
|
|
88
88
|
};
|
|
89
89
|
/**
|
|
90
90
|
* 主題分類規則(依序比對,第一個符合者勝出)
|
|
@@ -224,7 +224,7 @@ function processFile(file, lines, otherSet) {
|
|
|
224
224
|
* 規則行:同時出現在另一份來源檔即為共用分類
|
|
225
225
|
* A rule line that also appears in the other source belongs to the shared bucket
|
|
226
226
|
*/
|
|
227
|
-
const bucket = otherSet.has(line) ?
|
|
227
|
+
const bucket = otherSet.has(line) ? ignore_split_1.EnumIgnoreSplitTargetBucket.shared : file;
|
|
228
228
|
/**
|
|
229
229
|
* 1. 命中共用輔助的重複語法 → 以佔位行取代
|
|
230
230
|
* 1. A repeated matrix covered by a shared generator → replaced by a placeholder
|
|
@@ -288,8 +288,8 @@ function processFile(file, lines, otherSet) {
|
|
|
288
288
|
* git 檔案首行的官方說明保留為 00-header 片段
|
|
289
289
|
* The official note on line 1 of the gitignore becomes the 00-header fragment
|
|
290
290
|
*/
|
|
291
|
-
if (i === 0 && file ===
|
|
292
|
-
assign[i] = { kind: EnumIgnoreSplitLineKind.Fragment, bucket:
|
|
291
|
+
if (i === 0 && file === ignore_split_1.EnumIgnoreSplitTargetBucket.git) {
|
|
292
|
+
assign[i] = { kind: EnumIgnoreSplitLineKind.Fragment, bucket: ignore_split_1.EnumIgnoreSplitTargetBucket.git, topic: '00-header' };
|
|
293
293
|
continue;
|
|
294
294
|
}
|
|
295
295
|
let topic;
|
|
@@ -363,7 +363,7 @@ function main() {
|
|
|
363
363
|
* 共用規則只在 git 通過時寫入(避免 git / npm 各推一次造成重複)
|
|
364
364
|
* Shared rules are written only during the git pass (to avoid pushing once per source file)
|
|
365
365
|
*/
|
|
366
|
-
if (current.bucket ===
|
|
366
|
+
if (current.bucket === ignore_split_1.EnumIgnoreSplitTargetBucket.shared && file === ignore_split_1.EnumIgnoreSplitTargetBucket.npm) {
|
|
367
367
|
continue;
|
|
368
368
|
}
|
|
369
369
|
if (current.kind === EnumIgnoreSplitLineKind.Gen) {
|
|
@@ -406,23 +406,23 @@ function main() {
|
|
|
406
406
|
*/
|
|
407
407
|
{
|
|
408
408
|
const content = [
|
|
409
|
-
'#
|
|
410
|
-
'#
|
|
411
|
-
'#
|
|
409
|
+
'# other: duplicated & redundant rules (never emitted)',
|
|
410
|
+
'# these rules are never emitted into out/gitignore or out/npmignore; kept for auditing only',
|
|
411
|
+
'# repetitive matrices are generated by the shared helper, see test/scripts/lib/ignore-split.ts',
|
|
412
412
|
'',
|
|
413
|
-
'#
|
|
414
|
-
...droppedLines(report.dropped.redundant,
|
|
413
|
+
'# gitignore source: covered by a broader rule',
|
|
414
|
+
...droppedLines(report.dropped.redundant, ignore_split_1.EnumIgnoreSplitTargetBucket.git),
|
|
415
415
|
'',
|
|
416
|
-
'#
|
|
417
|
-
...droppedLines(report.dropped.redundant,
|
|
416
|
+
'# npmignore source: covered by a broader rule',
|
|
417
|
+
...droppedLines(report.dropped.redundant, ignore_split_1.EnumIgnoreSplitTargetBucket.npm),
|
|
418
418
|
'',
|
|
419
|
-
'#
|
|
420
|
-
...droppedLines(report.dropped.dup,
|
|
419
|
+
'# gitignore source: duplicated',
|
|
420
|
+
...droppedLines(report.dropped.dup, ignore_split_1.EnumIgnoreSplitTargetBucket.git),
|
|
421
421
|
'',
|
|
422
|
-
'#
|
|
423
|
-
...droppedLines(report.dropped.dup,
|
|
422
|
+
'# npmignore source: duplicated',
|
|
423
|
+
...droppedLines(report.dropped.dup, ignore_split_1.EnumIgnoreSplitTargetBucket.npm),
|
|
424
424
|
];
|
|
425
|
-
const path = (0, ignore_split_1.getSplitFragmentPath)(
|
|
425
|
+
const path = (0, ignore_split_1.getSplitFragmentPath)(ignore_split_1.EnumIgnoreSplitTargetBucket.other, '90-duplicates');
|
|
426
426
|
(0, fs_1.mkdirSync)((0, path_1.dirname)(path), { recursive: true });
|
|
427
427
|
(0, fs_1.writeFileSync)(path, content.join('\n') + '\n', 'utf8');
|
|
428
428
|
written.add(path);
|
|
@@ -433,7 +433,7 @@ function main() {
|
|
|
433
433
|
* Remove fragment files not rewritten by this run (leftovers after a topic
|
|
434
434
|
* rename or removal); per-file unlink instead of a destructive directory wipe
|
|
435
435
|
*/
|
|
436
|
-
for (const bucket of [...ignore_split_1.EMITTED_BUCKETS,
|
|
436
|
+
for (const bucket of [...ignore_split_1.EMITTED_BUCKETS, ignore_split_1.EnumIgnoreSplitTargetBucket.other]) {
|
|
437
437
|
const dir = (0, path_1.join)(ignore_split_1.SPLIT_ROOT, bucket);
|
|
438
438
|
if (!(0, fs_1.existsSync)(dir)) {
|
|
439
439
|
continue;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"split-ignore-files.js","sourceRoot":"","sources":["split-ignore-files.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * 將 file/gitignore / file/npmignore 分割為 test/fixtures/split/ 的分類片段\n * Split file/gitignore & file/npmignore into classified fragments under test/fixtures/split/\n *\n * 單一事實來源:主題({@link TOPICS})、分類 ↔ 檔名({@link IGNORE_SPLIT_TARGETS})、\n * 共用輔助區塊({@link IGNORE_SPLIT_GENERATORS})與片段路徑慣例({@link getSplitFragmentPath})\n * 皆引用 ./lib/ignore-split;本檔只保留分類邏輯本身。\n *\n * Single source of truth: topics ({@link TOPICS}), bucket ↔ file name\n * ({@link IGNORE_SPLIT_TARGETS}), shared generated blocks\n * ({@link IGNORE_SPLIT_GENERATORS}), and the fragment path convention\n * ({@link getSplitFragmentPath}) all come from ./lib/ignore-split; this script\n * only owns the classification logic itself.\n *\n * 分類流程:比對主題 → 命中共用輔助的重複語法改寫為佔位行 → 同檔重複與冗餘規則\n * 捨棄(寫入 other/)→ 段落註解併入下一個規則行的主題 → 依分類與主題寫出片段。\n *\n * Classification flow: match the topic → replace repeated matrices covered by a\n * shared generator with a placeholder line → drop same-file duplicates and\n * redundant rules (recorded in other/) → attach each section comment to the\n * topic of the following rule line → write out fragments by bucket and topic.\n *\n * 規格語意(必須保留):`x/` 只針對目錄、`/x` 只錨定根目錄,兩者與 `x` 皆為\n * 不同規則;本檔所有比對(共用判定、同檔重複、輔助產生、冗餘判定)都以完整\n * 字串進行,不做任何正規化;冗餘表只允許「廣義規則的匹配集合嚴格包含該行」。\n *\n * Pattern semantics (must be preserved): `x/` targets directories only and `/x`\n * anchors to the root, so both differ from `x`; every comparison in this script\n * (shared detection, same-file duplicates, generator matching, redundancy) uses\n * the full string with no normalization, and the redundancy table only allows a\n * broader rule whose match set strictly contains the line.\n *\n * 執行 / run: tsx packages/@yarn-tool/static-file/test/scripts/split-ignore-files.ts\n * 輸出 / output: test/fixtures/split/{git,npm,shared,other}/*.txt\n */\nimport { existsSync, mkdirSync, readFileSync, readdirSync, unlinkSync, writeFileSync } from 'fs';\nimport { dirname, join } from 'path';\nimport { __ROOT } from '../__root';\nimport type {\n\tIIgnoreSplitEmittedBucket,\n\tIIgnoreSplitTargetBucket,\n\tIIgnoreSplitTopicId,\n} from './lib/ignore-split';\nimport {\n\tEMITTED_BUCKETS,\n\tIGNORE_SPLIT_GENERATORS,\n\tIGNORE_SPLIT_TARGETS,\n\tSPLIT_ROOT,\n\tTOPICS,\n\tgetSplitFragmentPath,\n} from './lib/ignore-split';\n\n/**\n * 片段檔標頭中的分類名稱(僅輸出分類需要標頭;other 有固定檔頭不經此表)\n * Bucket names shown in fragment headers (only emitted buckets need a header;\n * other has its own fixed header and does not use this table)\n */\nconst BUCKET_LABEL: Record<IIgnoreSplitEmittedBucket, string> = {\n\tgit: 'git 專用 / git only',\n\tnpm: 'npm 發布專用 / npm publish only',\n\tshared: '兩類共用 / shared',\n};\n\n/**\n * 冗餘規則:已被更廣泛的規則涵蓋,不輸出到組合結果,僅記錄於 other/ 供稽核\n * Redundant rules: covered by a broader rule, never emitted into the composed\n * output, only recorded in other/ for auditing\n *\n * 鍵為 `<分類>:<規則>`;只有該分類專屬(非共用)的行才會比對。\n * Keyed as `<bucket>:<rule>`; only bucket-specific (non-shared) lines are matched.\n *\n * 「涵蓋」指語意上的匹配集合包含(例:`coverage` 匹配任意層級,故包含只針對\n * 根目錄的 `/coverage`),絕非字串相同或正規化後相同;`x/`(只針對目錄)與\n * `/x`(只錨定根目錄)都是獨立規則,每條的廣義規則必須仍然存在於同一份來源\n * 檔,否則該條不得列為冗餘。\n * \"Covered\" means semantic containment of the match sets (e.g. `coverage`\n * matches any depth and therefore contains root-anchored `/coverage`), never\n * string equality or equality after normalization; `x/` (directories only) and\n * `/x` (root-anchored only) are rules in their own right, and each broader rule\n * must still exist in the same source file or the entry must not be listed.\n */\nconst REDUNDANT: Record<string, string> = {\n\t'git:/coverage': '已被 `coverage` 涵蓋 / covered by `coverage`',\n\t'git:/.next/': '已被 `.next` 涵蓋 / covered by `.next`',\n\t'git:/out/': '已被 `/out` 涵蓋 / covered by `/out`',\n\t'git:**/node_modules': '已被 `node_modules` 涵蓋 / covered by `node_modules`',\n\t'git:test/temp*/': '已被輔助產生的 `test/temp*` 涵蓋 / covered by generated `test/temp*`',\n\t'npm:/node_modules/': '已被 `node_modules` 涵蓋 / covered by `node_modules`',\n\t'npm:**/node_modules/': '已被 `node_modules` 涵蓋 / covered by `node_modules`',\n\t'npm:jest.config.js': '已被 `jest.config.*` 涵蓋 / covered by `jest.config.*`',\n};\n\n/**\n * 每個目標分類的「另一份」來源分類;共用規則即以「同時出現在另一份」判定\n * The complementary source bucket of each target; a rule counts as shared when\n * it also appears in that other source\n */\nconst COMPLEMENT: Record<IIgnoreSplitTargetBucket, IIgnoreSplitTargetBucket> = {\n\tgit: 'npm',\n\tnpm: 'git',\n};\n\n/**\n * 主題分類規則(依序比對,第一個符合者勝出)\n * Topic rules (checked in order; the first match wins)\n */\nconst RULES: [RegExp, IIgnoreSplitTopicId][] = [\n\t[/^!\\*\\.d\\.(ts|mts|cts)$/, '05-source'],\n\t[/^!\\/src\\/\\*\\*/, '05-source'],\n\t[/^!\\/(README|CHANGELOG)\\.md$/, '10-project'],\n\t/**\n\t * `!.github` 必須排在「巢狀 .github 排除規則」(原檔 163 < 201)之前,\n\t * 否則嵌套 .github 會被白名單重新放行;`!/.github`(202)維持 99。\n\t * `!.github` must stay before the nested-.github exclusion rule (original\n\t * line 163 < 201) so nested .github remains re-excluded; `!/.github` (202)\n\t * stays in 99.\n\t */\n\t[/^!\\.github$/, '10-project'],\n\t[/^!/, '99-whitelist'],\n\t/**\n\t * 根目錄隱藏檔規則須早於 `!*.d.ts`(原檔 17 < 26),\n\t * 否則根目錄的 *.d.ts 會被後置的 `/.*` 重新排除。\n\t * The root hidden-file rule must precede `!*.d.ts` (original line 17 < 26),\n\t * otherwise root *.d.ts files get re-excluded by the later `/.*`.\n\t */\n\t[/^\\/\\.\\*$/, '01-hidden'],\n\t[/^\\*\\.ts$/, '05-source'],\n\t[/^\\/bin\\//, '05-source'],\n\t/**\n\t * 環境與 IDE 規則須早於測試規則:`.env.test.local` 含 `.test.` 但並非測試檔\n\t * Environment and IDE rules must precede the test rules: `.env.test.local`\n\t * contains `.test.` but is not a test file\n\t */\n\t[/^\\.env/, '40-env'],\n\t[/^\\/certificates$/, '40-env'],\n\t[/\\.pem$/, '40-env'],\n\t[/vercel|\\.nowignore|^\\/?now\\.json$/, '40-env'],\n\t[/^\\.?nvmrc$|^\\.node-version$/, '40-env'],\n\t[/^\\.?(idea|vscode)$/, '30-ide'],\n\t[/\\.(suo|ntvs\\*|njsproj|sln|sw\\?)$/, '30-ide'],\n\t[/^(clinerules|kilocode|cline|junie|gemini|copilot|claude|agents|aiassistant)$/, '30-ide'],\n\t[/intellij/, '30-ide'],\n\t[/^(tests?|__tests?__|__mocks__|__snapshots__|__fixtures__|__file_snapshots__)$/, '20-test'],\n\t[/^\\/?(tests?|__tests?__|__mocks__|__snapshots__|__fixtures__|fixture)\\//, '20-test'],\n\t[/\\/test\\//, '20-test'],\n\t[/\\.(spec|test|node-spec|node-test|stories)\\./, '20-test'],\n\t[/^\\.gitkeep$/, '20-test'],\n\t[/jest|karma|mocha|nyc|coverage/i, '20-test'],\n\t[/\\.snap(shot)?$/, '20-test'],\n\t[/\\/stories\\//, '20-test'],\n\t[/^\\.DS_Store$/, '90-misc'],\n\t[/^~ci\\.|^\\/~\\*/, '90-misc'],\n\t[/\\.stackdump$|^\\*\\.bak$|^\\*\\.old$/, '90-misc'],\n\t[/^\\.opt-(in|out)$|^\\*\\.stat$|^\\.codenomad$|^\\.logs$|^\\.agentbridge$|^openspec\\/$|^cz-adapter$/, '90-misc'],\n\t[/.*/, '10-project'],\n];\n\n/**\n * 每個輔助區塊涵蓋的規則集合(排除空行與說明註解),\n * 用於在來源檔中找出該以佔位行取代的重複行\n * The rule set covered by each generator (blank lines and description comments\n * excluded), used to find the repeated source lines that a placeholder replaces\n */\nconst GENERATOR_RULE_SETS: Record<string, ReadonlySet<string>> = Object.fromEntries(\n\tObject.entries(IGNORE_SPLIT_GENERATORS).map(([name, { generate }]) => [\n\t\tname,\n\t\tnew Set(generate().filter(line => line !== '' && !line.startsWith('#'))),\n\t]),\n);\n\n/**\n * 分割統計,僅供執行結束時輸出 / Split statistics, printed at the end of a run\n */\ninterface ISplitReport\n{\n\tfragments: Record<string, number>;\n\tgen: Record<string, number>;\n\tdropped: {\n\t\tredundant: { bucket: IIgnoreSplitTargetBucket; line: string; note: string }[];\n\t\tdup: { bucket: IIgnoreSplitTargetBucket; line: string }[];\n\t};\n}\n\nconst report: ISplitReport = {\n\tfragments: {},\n\tgen: {},\n\tdropped: {\n\t\tredundant: [],\n\t\tdup: [],\n\t},\n};\n\n/**\n * 行指派的種類:以 enum 取代字串聯合,避免字串筆誤;\n * 字串值與原字面值一致,report 與 JSON 輸出不受影響\n * The kind of a line assignment: an enum instead of a string union, so a typo\n * cannot slip in; the string values match the previous literals, keeping the\n * report and JSON output unchanged\n */\nenum EnumIgnoreSplitLineKind\n{\n\tComment = 'comment',\n\tGen = 'gen',\n\tDropped = 'dropped',\n\tFragment = 'fragment',\n}\n\n/**\n * 單一行的分類指派(判別聯合,依 {@link EnumIgnoreSplitLineKind} 收斂)\n * The classification assigned to a single line (a discriminated union narrowed by {@link EnumIgnoreSplitLineKind})\n */\ntype ILineAssignment =\n\t| { kind: EnumIgnoreSplitLineKind.Comment }\n\t| { kind: EnumIgnoreSplitLineKind.Gen; bucket: IIgnoreSplitTargetBucket; topic: IIgnoreSplitTopicId; genName: string }\n\t| { kind: EnumIgnoreSplitLineKind.Dropped; topic: IIgnoreSplitTopicId }\n\t| { kind: EnumIgnoreSplitLineKind.Fragment; bucket: IIgnoreSplitEmittedBucket; topic: IIgnoreSplitTopicId };\n\n/**\n * 已解析的行指派:第二輪會把每個段落註解改為 Fragment,\n * 故回傳型別不再包含 Comment,後續只會遇到 Gen / Dropped / Fragment\n * Resolved line assignment: the second pass converts every section comment into\n * a Fragment, so the returned type no longer includes Comment and later stages\n * only see Gen / Dropped / Fragment\n */\ntype IResolvedAssignment = Exclude<ILineAssignment, { kind: EnumIgnoreSplitLineKind.Comment }>;\n\n/**\n * 判斷單一規則行所屬的主題\n * Decide which topic a single rule line belongs to\n */\nfunction classifyTopic(line: string): IIgnoreSplitTopicId\n{\n\tfor (const [re, topic] of RULES)\n\t{\n\t\tif (re.test(line))\n\t\t{\n\t\t\treturn topic;\n\t\t}\n\t}\n\n\treturn '10-project';\n}\n\n/**\n * 讀取來源檔並去除結尾空行 / Read a source file and strip its trailing blank lines\n */\nfunction readLines(path: string): string[]\n{\n\tconst lines = readFileSync(path, 'utf8').split(/\\r?\\n/);\n\n\twhile (lines.length > 0 && lines[lines.length - 1] === '')\n\t{\n\t\tlines.pop();\n\t}\n\n\treturn lines;\n}\n\n/**\n * 判斷單一來源檔每一行的分類與主題\n * Decide the bucket and topic of every line in one source file\n *\n * @param file - 來源所屬的目標分類 / The target bucket of the source file\n * @param lines - 來源檔的所有行 / Every line of the source file\n * @param otherSet - 另一份來源檔的非空行集合(共用判定基準)/ The non-blank line set of the complementary source (the shared-bucket basis)\n */\nfunction processFile(\n\tfile: IIgnoreSplitTargetBucket,\n\tlines: string[],\n\totherSet: ReadonlySet<string>,\n): { lines: string[]; assign: (IResolvedAssignment | null)[] }\n{\n\tconst seen = new Set<string>();\n\tconst assign = new Array<ILineAssignment | null>(lines.length).fill(null);\n\n\tfor (let i = 0; i < lines.length; i++)\n\t{\n\t\tconst line = lines[i];\n\n\t\tif (line === '')\n\t\t{\n\t\t\tcontinue;\n\t\t}\n\n\t\t/**\n\t\t * 段落註解為「# 後接空白」的形式;`#jest.config.js` 這類被註解掉的規則\n\t\t * 不符合此形式,仍視為規則行走一般分類\n\t\t * A section comment is `#` followed by whitespace; a commented-out rule\n\t\t * like `#jest.config.js` does not match and is classified as a rule line\n\t\t */\n\t\tif (/^#\\s/.test(line))\n\t\t{\n\t\t\tassign[i] = { kind: EnumIgnoreSplitLineKind.Comment };\n\t\t\tcontinue;\n\t\t}\n\n\t\t/**\n\t\t * 規則行:同時出現在另一份來源檔即為共用分類\n\t\t * A rule line that also appears in the other source belongs to the shared bucket\n\t\t */\n\t\tconst bucket: IIgnoreSplitEmittedBucket = otherSet.has(line) ? 'shared' : file;\n\n\t\t/**\n\t\t * 1. 命中共用輔助的重複語法 → 以佔位行取代\n\t\t * 1. A repeated matrix covered by a shared generator → replaced by a placeholder\n\t\t */\n\t\tlet genName: string | undefined;\n\n\t\tif (bucket === file)\n\t\t{\n\t\t\tfor (const [name, ruleSet] of Object.entries(GENERATOR_RULE_SETS))\n\t\t\t{\n\t\t\t\tconst generator = IGNORE_SPLIT_GENERATORS[name];\n\n\t\t\t\tif (generator.bucket === file && ruleSet.has(line))\n\t\t\t\t{\n\t\t\t\t\tgenName = name;\n\t\t\t\t\tbreak;\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\tif (genName)\n\t\t{\n\t\t\tassign[i] = { kind: EnumIgnoreSplitLineKind.Gen, bucket: file, topic: IGNORE_SPLIT_GENERATORS[genName].topic, genName };\n\t\t\treport.gen[genName] = (report.gen[genName] || 0) + 1;\n\t\t\tcontinue;\n\t\t}\n\n\t\tconst topic = classifyTopic(line);\n\n\t\t/**\n\t\t * 2. 同檔內重複出現 → other\n\t\t * 2. Repeated within the same file → other\n\t\t */\n\t\tif (seen.has(line))\n\t\t{\n\t\t\tassign[i] = { kind: EnumIgnoreSplitLineKind.Dropped, topic };\n\t\t\treport.dropped.dup.push({ bucket: file, line });\n\t\t\tcontinue;\n\t\t}\n\t\tseen.add(line);\n\n\t\t/**\n\t\t * 3. 冗餘(已被更廣泛的規則涵蓋)→ other\n\t\t * 3. Redundant (covered by a broader rule) → other\n\t\t */\n\t\tconst redundantNote = REDUNDANT[`${file}:${line}`];\n\n\t\tif (bucket === file && redundantNote)\n\t\t{\n\t\t\tassign[i] = { kind: EnumIgnoreSplitLineKind.Dropped, topic };\n\t\t\treport.dropped.redundant.push({ bucket: file, line, note: redundantNote });\n\t\t\tcontinue;\n\t\t}\n\n\t\t/**\n\t\t * 4. 一般規則 → 分類到 fragment\n\t\t * 4. An ordinary rule → classified into a fragment\n\t\t */\n\t\tassign[i] = { kind: EnumIgnoreSplitLineKind.Fragment, bucket, topic };\n\t}\n\n\t/**\n\t * 段落註解:主題採用下一個規則行的主題;分類採用同主題且會輸出的規則行。\n\t * 規則行被佔位或丟棄時,繼續向後找同主題的下一個輸出行。\n\t * A section comment adopts the topic of the next rule line and the bucket of\n\t * an emitted line of that topic; when that line is dropped or replaced by a\n\t * placeholder, it keeps scanning forward for the next emitted line of the\n\t * same topic.\n\t */\n\tfor (let i = 0; i < lines.length; i++)\n\t{\n\t\tconst current = assign[i];\n\n\t\tif (!current || current.kind !== EnumIgnoreSplitLineKind.Comment)\n\t\t{\n\t\t\tcontinue;\n\t\t}\n\n\t\t/**\n\t\t * git 檔案首行的官方說明保留為 00-header 片段\n\t\t * The official note on line 1 of the gitignore becomes the 00-header fragment\n\t\t */\n\t\tif (i === 0 && file === 'git')\n\t\t{\n\t\t\tassign[i] = { kind: EnumIgnoreSplitLineKind.Fragment, bucket: 'git', topic: '00-header' };\n\t\t\tcontinue;\n\t\t}\n\n\t\tlet topic: IIgnoreSplitTopicId | undefined;\n\n\t\tfor (let j = i + 1; j < lines.length; j++)\n\t\t{\n\t\t\tconst next = assign[j];\n\n\t\t\tif (!next || next.kind === EnumIgnoreSplitLineKind.Comment)\n\t\t\t{\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\ttopic = next.topic;\n\t\t\tbreak;\n\t\t}\n\n\t\tconst resolvedTopic = topic ?? '90-misc';\n\t\tlet bucket: IIgnoreSplitEmittedBucket = file;\n\n\t\tfor (let j = i + 1; j < lines.length; j++)\n\t\t{\n\t\t\tconst next = assign[j];\n\n\t\t\tif (!next || next.kind !== EnumIgnoreSplitLineKind.Fragment || next.topic !== resolvedTopic)\n\t\t\t{\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tbucket = next.bucket;\n\t\t\tbreak;\n\t\t}\n\n\t\tassign[i] = { kind: EnumIgnoreSplitLineKind.Fragment, bucket, topic: resolvedTopic };\n\t}\n\n\treturn { lines, assign: assign as (IResolvedAssignment | null)[] };\n}\n\n/**\n * 依分類取出被丟棄的規則行(供 other/ 片段分段列出)\n * Collect the dropped rule lines of one bucket (for the sections of other/)\n */\nfunction droppedLines(\n\tentries: readonly { bucket: IIgnoreSplitTargetBucket; line: string }[],\n\tbucket: IIgnoreSplitTargetBucket,\n): string[]\n{\n\treturn entries.filter(entry => entry.bucket === bucket).map(entry => entry.line);\n}\n\n/**\n * 腳本進入點:分割兩份來源檔並寫出分類片段\n * Script entry: split both source files and write out the classified fragments\n */\nfunction main(): void\n{\n\t/**\n\t * 讀取兩份來源檔(檔名來自 {@link IGNORE_SPLIT_TARGETS})\n\t * Read both source files (file names come from {@link IGNORE_SPLIT_TARGETS})\n\t */\n\tconst files = {} as Record<IIgnoreSplitTargetBucket, string[]>;\n\n\tfor (const { bucket, fileName } of IGNORE_SPLIT_TARGETS)\n\t{\n\t\tfiles[bucket] = readLines(join(__ROOT, 'file', fileName));\n\t}\n\n\tconst ruleLineSets = {} as Record<IIgnoreSplitTargetBucket, ReadonlySet<string>>;\n\n\tfor (const { bucket } of IGNORE_SPLIT_TARGETS)\n\t{\n\t\truleLineSets[bucket] = new Set(files[bucket].filter(line => line !== ''));\n\t}\n\n\tconst results = {} as Record<IIgnoreSplitTargetBucket, ReturnType<typeof processFile>>;\n\n\tfor (const { bucket } of IGNORE_SPLIT_TARGETS)\n\t{\n\t\tresults[bucket] = processFile(bucket, files[bucket], ruleLineSets[COMPLEMENT[bucket]]);\n\t}\n\n\t/**\n\t * 建立 groups[分類][主題] = 行陣列(依原始順序)\n\t * Build groups[bucket][topic] = line arrays (in original order)\n\t */\n\tconst groups = {} as Record<IIgnoreSplitEmittedBucket, Record<IIgnoreSplitTopicId, string[]>>;\n\n\tfor (const bucket of EMITTED_BUCKETS)\n\t{\n\t\tgroups[bucket] = Object.fromEntries(TOPICS.map(({ id }) => [id, [] as string[]])) as Record<IIgnoreSplitTopicId, string[]>;\n\t}\n\n\tconst emittedGen = new Set<string>();\n\n\tfor (const { bucket: file } of IGNORE_SPLIT_TARGETS)\n\t{\n\t\tconst { lines, assign } = results[file];\n\n\t\tfor (let i = 0; i < lines.length; i++)\n\t\t{\n\t\t\tconst current = assign[i];\n\n\t\t\tif (!current || current.kind === EnumIgnoreSplitLineKind.Dropped)\n\t\t\t{\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\t/**\n\t\t\t * 共用規則只在 git 通過時寫入(避免 git / npm 各推一次造成重複)\n\t\t\t * Shared rules are written only during the git pass (to avoid pushing once per source file)\n\t\t\t */\n\t\t\tif (current.bucket === 'shared' && file === 'npm')\n\t\t\t{\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tif (current.kind === EnumIgnoreSplitLineKind.Gen)\n\t\t\t{\n\t\t\t\tconst key = `${current.bucket}|${current.topic}|${current.genName}`;\n\n\t\t\t\tif (emittedGen.has(key))\n\t\t\t\t{\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\t\t\t\temittedGen.add(key);\n\t\t\t\tgroups[current.bucket][current.topic].push(`# %gen:${current.genName}%`);\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tgroups[current.bucket][current.topic].push(lines[i]);\n\t\t}\n\t}\n\n\tconst written = new Set<string>();\n\n\tfor (const bucket of EMITTED_BUCKETS)\n\t{\n\t\tfor (const { id: topic, zh, en } of TOPICS)\n\t\t{\n\t\t\tconst content = groups[bucket][topic];\n\t\t\tconst path = getSplitFragmentPath(bucket, topic);\n\n\t\t\tif (content.length === 0)\n\t\t\t{\n\t\t\t\t/**\n\t\t\t\t * 該分類 × 主題已無內容:刪除舊檔,避免組合腳本讀到過期片段\n\t\t\t\t * This bucket × topic is now empty: remove the stale file so the compose script cannot read outdated content\n\t\t\t\t */\n\t\t\t\tif (existsSync(path))\n\t\t\t\t{\n\t\t\t\t\tunlinkSync(path);\n\t\t\t\t}\n\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tconst header = `# ${zh} / ${en} · ${BUCKET_LABEL[bucket]}`;\n\n\t\t\tmkdirSync(dirname(path), { recursive: true });\n\t\t\twriteFileSync(path, [header, ...content].join('\\n') + '\\n', 'utf8');\n\n\t\t\twritten.add(path);\n\t\t\treport.fragments[`${bucket}/${topic}`] = content.length;\n\t\t}\n\t}\n\n\t/**\n\t * other:不輸出的冗餘與重複規則,僅留存供稽核\n\t * other: duplicated and redundant rules, kept for auditing only\n\t */\n\t{\n\t\tconst content = [\n\t\t\t'# 其他:不輸出的重複與冗餘規則 / other: duplicated & redundant rules (never emitted)',\n\t\t\t'# 本目錄規則不會進入 out/gitignore 或 out/npmignore;僅留存供稽核 / these rules are never emitted into out/gitignore or out/npmignore; kept for auditing only',\n\t\t\t'# 重複語法(測試矩陣、*.map…)改由共用輔助產生,見 test/scripts/lib/ignore-split.ts / repetitive matrices are generated by the shared helper, see test/scripts/lib/ignore-split.ts',\n\t\t\t'',\n\t\t\t'# git 專用檔:已被更廣泛的規則涵蓋 / gitignore source: covered by a broader rule',\n\t\t\t...droppedLines(report.dropped.redundant, 'git'),\n\t\t\t'',\n\t\t\t'# npm 發布專用檔:已被更廣泛的規則涵蓋 / npmignore source: covered by a broader rule',\n\t\t\t...droppedLines(report.dropped.redundant, 'npm'),\n\t\t\t'',\n\t\t\t'# git 專用檔中重複出現 / duplicated in the gitignore source',\n\t\t\t...droppedLines(report.dropped.dup, 'git'),\n\t\t\t'',\n\t\t\t'# npm 發布專用檔中重複出現 / duplicated in the npmignore source',\n\t\t\t...droppedLines(report.dropped.dup, 'npm'),\n\t\t];\n\n\t\tconst path = getSplitFragmentPath('other', '90-duplicates');\n\n\t\tmkdirSync(dirname(path), { recursive: true });\n\t\twriteFileSync(path, content.join('\\n') + '\\n', 'utf8');\n\n\t\twritten.add(path);\n\t}\n\n\t/**\n\t * 清理未重寫的片段檔(主題改名或刪除後的殘留),\n\t * 以逐檔 unlink 取代整目錄刪除,避免破壞性操作\n\t * Remove fragment files not rewritten by this run (leftovers after a topic\n\t * rename or removal); per-file unlink instead of a destructive directory wipe\n\t */\n\tfor (const bucket of [...EMITTED_BUCKETS, 'other'])\n\t{\n\t\tconst dir = join(SPLIT_ROOT, bucket);\n\n\t\tif (!existsSync(dir))\n\t\t{\n\t\t\tcontinue;\n\t\t}\n\n\t\tfor (const entry of readdirSync(dir))\n\t\t{\n\t\t\tif (!entry.endsWith('.txt'))\n\t\t\t{\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tconst path = join(dir, entry);\n\n\t\t\tif (!written.has(path))\n\t\t\t{\n\t\t\t\tunlinkSync(path);\n\t\t\t}\n\t\t}\n\t}\n\n\tconsole.log(JSON.stringify({ fragments: report.fragments, gen: report.gen, dropped: report.dropped }, null, 2));\n}\n\nmain();\n"]}
|
|
1
|
+
{"version":3,"file":"split-ignore-files.js","sourceRoot":"","sources":["split-ignore-files.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * 將 file/gitignore / file/npmignore 分割為 test/fixtures/split/ 的分類片段\n * Split file/gitignore & file/npmignore into classified fragments under test/fixtures/split/\n *\n * 單一事實來源:主題({@link TOPICS})、分類 ↔ 檔名({@link IGNORE_SPLIT_TARGETS})、\n * 共用輔助區塊({@link IGNORE_SPLIT_GENERATORS})與片段路徑慣例({@link getSplitFragmentPath})\n * 皆引用 ./lib/ignore-split;本檔只保留分類邏輯本身。\n *\n * Single source of truth: topics ({@link TOPICS}), bucket ↔ file name\n * ({@link IGNORE_SPLIT_TARGETS}), shared generated blocks\n * ({@link IGNORE_SPLIT_GENERATORS}), and the fragment path convention\n * ({@link getSplitFragmentPath}) all come from ./lib/ignore-split; this script\n * only owns the classification logic itself.\n *\n * 分類流程:比對主題 → 命中共用輔助的重複語法改寫為佔位行 → 同檔重複與冗餘規則\n * 捨棄(寫入 other/)→ 段落註解併入下一個規則行的主題 → 依分類與主題寫出片段。\n *\n * Classification flow: match the topic → replace repeated matrices covered by a\n * shared generator with a placeholder line → drop same-file duplicates and\n * redundant rules (recorded in other/) → attach each section comment to the\n * topic of the following rule line → write out fragments by bucket and topic.\n *\n * 規格語意(必須保留):`x/` 只針對目錄、`/x` 只錨定根目錄,兩者與 `x` 皆為\n * 不同規則;本檔所有比對(共用判定、同檔重複、輔助產生、冗餘判定)都以完整\n * 字串進行,不做任何正規化;冗餘表只允許「廣義規則的匹配集合嚴格包含該行」。\n *\n * Pattern semantics (must be preserved): `x/` targets directories only and `/x`\n * anchors to the root, so both differ from `x`; every comparison in this script\n * (shared detection, same-file duplicates, generator matching, redundancy) uses\n * the full string with no normalization, and the redundancy table only allows a\n * broader rule whose match set strictly contains the line.\n *\n * 執行 / run: tsx packages/@yarn-tool/static-file/test/scripts/split-ignore-files.ts\n * 輸出 / output: test/fixtures/split/{git,npm,shared,other}/*.txt\n */\nimport { existsSync, mkdirSync, readFileSync, readdirSync, unlinkSync, writeFileSync } from 'fs';\nimport { dirname, join } from 'path';\nimport { __ROOT } from '../__root';\nimport type {\n\tIIgnoreSplitEmittedBucket,\n\tIIgnoreSplitTargetBucket,\n\tIIgnoreSplitTopicId,\n} from './lib/ignore-split';\nimport {\n\tEMITTED_BUCKETS,\n\tEnumIgnoreSplitTargetBucket,\n\tIGNORE_SPLIT_GENERATORS,\n\tIGNORE_SPLIT_TARGETS,\n\tSPLIT_ROOT,\n\tTOPICS,\n\tgetSplitFragmentPath,\n} from './lib/ignore-split';\n\n/**\n * 片段檔標頭中的分類名稱(僅輸出分類需要標頭;other 有固定檔頭不經此表)\n * Bucket names shown in fragment headers (only emitted buckets need a header;\n * other has its own fixed header and does not use this table)\n */\nconst BUCKET_LABEL: Record<IIgnoreSplitEmittedBucket, string> = {\n\tgit: 'git 專用 / git only',\n\tnpm: 'npm 發布專用 / npm publish only',\n\tshared: '兩類共用 / shared',\n};\n\n/**\n * 冗餘規則:已被更廣泛的規則涵蓋,不輸出到組合結果,僅記錄於 other/ 供稽核\n * Redundant rules: covered by a broader rule, never emitted into the composed\n * output, only recorded in other/ for auditing\n *\n * 鍵為 `<分類>:<規則>`;只有該分類專屬(非共用)的行才會比對。\n * Keyed as `<bucket>:<rule>`; only bucket-specific (non-shared) lines are matched.\n *\n * 「涵蓋」指語意上的匹配集合包含(例:`coverage` 匹配任意層級,故包含只針對\n * 根目錄的 `/coverage`),絕非字串相同或正規化後相同;`x/`(只針對目錄)與\n * `/x`(只錨定根目錄)都是獨立規則,每條的廣義規則必須仍然存在於同一份來源\n * 檔,否則該條不得列為冗餘。\n * \"Covered\" means semantic containment of the match sets (e.g. `coverage`\n * matches any depth and therefore contains root-anchored `/coverage`), never\n * string equality or equality after normalization; `x/` (directories only) and\n * `/x` (root-anchored only) are rules in their own right, and each broader rule\n * must still exist in the same source file or the entry must not be listed.\n */\nconst REDUNDANT: Record<string, string> = {\n\t'git:/coverage': '已被 `coverage` 涵蓋 / covered by `coverage`',\n\t'git:/.next/': '已被 `.next` 涵蓋 / covered by `.next`',\n\t'git:/out/': '已被 `/out` 涵蓋 / covered by `/out`',\n\t'git:**/node_modules': '已被 `node_modules` 涵蓋 / covered by `node_modules`',\n\t'git:test/temp*/': '已被輔助產生的 `test/temp*` 涵蓋 / covered by generated `test/temp*`',\n\t'npm:/node_modules/': '已被 `node_modules` 涵蓋 / covered by `node_modules`',\n\t'npm:**/node_modules/': '已被 `node_modules` 涵蓋 / covered by `node_modules`',\n\t'npm:jest.config.js': '已被 `jest.config.*` 涵蓋 / covered by `jest.config.*`',\n};\n\n/**\n * 每個目標分類的「另一份」來源分類;共用規則即以「同時出現在另一份」判定\n * The complementary source bucket of each target; a rule counts as shared when\n * it also appears in that other source\n */\nconst COMPLEMENT: Record<IIgnoreSplitTargetBucket, IIgnoreSplitTargetBucket> = {\n\t[EnumIgnoreSplitTargetBucket.git]: EnumIgnoreSplitTargetBucket.npm,\n\t[EnumIgnoreSplitTargetBucket.npm]: EnumIgnoreSplitTargetBucket.git,\n};\n\n/**\n * 主題分類規則(依序比對,第一個符合者勝出)\n * Topic rules (checked in order; the first match wins)\n */\nconst RULES: [RegExp, IIgnoreSplitTopicId][] = [\n\t[/^!\\*\\.d\\.(ts|mts|cts)$/, '05-source'],\n\t[/^!\\/src\\/\\*\\*/, '05-source'],\n\t[/^!\\/(README|CHANGELOG)\\.md$/, '10-project'],\n\t/**\n\t * `!.github` 必須排在「巢狀 .github 排除規則」(原檔 163 < 201)之前,\n\t * 否則嵌套 .github 會被白名單重新放行;`!/.github`(202)維持 99。\n\t * `!.github` must stay before the nested-.github exclusion rule (original\n\t * line 163 < 201) so nested .github remains re-excluded; `!/.github` (202)\n\t * stays in 99.\n\t */\n\t[/^!\\.github$/, '10-project'],\n\t[/^!/, '99-whitelist'],\n\t/**\n\t * 根目錄隱藏檔規則須早於 `!*.d.ts`(原檔 17 < 26),\n\t * 否則根目錄的 *.d.ts 會被後置的 `/.*` 重新排除。\n\t * The root hidden-file rule must precede `!*.d.ts` (original line 17 < 26),\n\t * otherwise root *.d.ts files get re-excluded by the later `/.*`.\n\t */\n\t[/^\\/\\.\\*$/, '01-hidden'],\n\t[/^\\*\\.ts$/, '05-source'],\n\t[/^\\/bin\\//, '05-source'],\n\t/**\n\t * 環境與 IDE 規則須早於測試規則:`.env.test.local` 含 `.test.` 但並非測試檔\n\t * Environment and IDE rules must precede the test rules: `.env.test.local`\n\t * contains `.test.` but is not a test file\n\t */\n\t[/^\\.env/, '40-env'],\n\t[/^\\/certificates$/, '40-env'],\n\t[/\\.pem$/, '40-env'],\n\t[/vercel|\\.nowignore|^\\/?now\\.json$/, '40-env'],\n\t[/^\\.?nvmrc$|^\\.node-version$/, '40-env'],\n\t[/^\\.?(idea|vscode)$/, '30-ide'],\n\t[/\\.(suo|ntvs\\*|njsproj|sln|sw\\?)$/, '30-ide'],\n\t[/^(clinerules|kilocode|cline|junie|gemini|copilot|claude|agents|aiassistant)$/, '30-ide'],\n\t[/intellij/, '30-ide'],\n\t[/^(tests?|__tests?__|__mocks__|__snapshots__|__fixtures__|__file_snapshots__)$/, '20-test'],\n\t[/^\\/?(tests?|__tests?__|__mocks__|__snapshots__|__fixtures__|fixture)\\//, '20-test'],\n\t[/\\/test\\//, '20-test'],\n\t[/\\.(spec|test|node-spec|node-test|stories)\\./, '20-test'],\n\t[/^\\.gitkeep$/, '20-test'],\n\t[/jest|karma|mocha|nyc|coverage/i, '20-test'],\n\t[/\\.snap(shot)?$/, '20-test'],\n\t[/\\/stories\\//, '20-test'],\n\t[/^\\.DS_Store$/, '90-misc'],\n\t[/^~ci\\.|^\\/~\\*/, '90-misc'],\n\t[/\\.stackdump$|^\\*\\.bak$|^\\*\\.old$/, '90-misc'],\n\t[/^\\.opt-(in|out)$|^\\*\\.stat$|^\\.codenomad$|^\\.logs$|^\\.agentbridge$|^openspec\\/$|^cz-adapter$/, '90-misc'],\n\t[/.*/, '10-project'],\n];\n\n/**\n * 每個輔助區塊涵蓋的規則集合(排除空行與說明註解),\n * 用於在來源檔中找出該以佔位行取代的重複行\n * The rule set covered by each generator (blank lines and description comments\n * excluded), used to find the repeated source lines that a placeholder replaces\n */\nconst GENERATOR_RULE_SETS: Record<string, ReadonlySet<string>> = Object.fromEntries(\n\tObject.entries(IGNORE_SPLIT_GENERATORS).map(([name, { generate }]) => [\n\t\tname,\n\t\tnew Set(generate().filter(line => line !== '' && !line.startsWith('#'))),\n\t]),\n);\n\n/**\n * 分割統計,僅供執行結束時輸出 / Split statistics, printed at the end of a run\n */\ninterface ISplitReport\n{\n\tfragments: Record<string, number>;\n\tgen: Record<string, number>;\n\tdropped: {\n\t\tredundant: { bucket: IIgnoreSplitTargetBucket; line: string; note: string }[];\n\t\tdup: { bucket: IIgnoreSplitTargetBucket; line: string }[];\n\t};\n}\n\nconst report: ISplitReport = {\n\tfragments: {},\n\tgen: {},\n\tdropped: {\n\t\tredundant: [],\n\t\tdup: [],\n\t},\n};\n\n/**\n * 行指派的種類:以 enum 取代字串聯合,避免字串筆誤;\n * 字串值與原字面值一致,report 與 JSON 輸出不受影響\n * The kind of a line assignment: an enum instead of a string union, so a typo\n * cannot slip in; the string values match the previous literals, keeping the\n * report and JSON output unchanged\n */\nenum EnumIgnoreSplitLineKind\n{\n\tComment = 'comment',\n\tGen = 'gen',\n\tDropped = 'dropped',\n\tFragment = 'fragment',\n}\n\n/**\n * 單一行的分類指派(判別聯合,依 {@link EnumIgnoreSplitLineKind} 收斂)\n * The classification assigned to a single line (a discriminated union narrowed by {@link EnumIgnoreSplitLineKind})\n */\ntype ILineAssignment =\n\t| { kind: EnumIgnoreSplitLineKind.Comment }\n\t| { kind: EnumIgnoreSplitLineKind.Gen; bucket: IIgnoreSplitTargetBucket; topic: IIgnoreSplitTopicId; genName: string }\n\t| { kind: EnumIgnoreSplitLineKind.Dropped; topic: IIgnoreSplitTopicId }\n\t| { kind: EnumIgnoreSplitLineKind.Fragment; bucket: IIgnoreSplitEmittedBucket; topic: IIgnoreSplitTopicId };\n\n/**\n * 已解析的行指派:第二輪會把每個段落註解改為 Fragment,\n * 故回傳型別不再包含 Comment,後續只會遇到 Gen / Dropped / Fragment\n * Resolved line assignment: the second pass converts every section comment into\n * a Fragment, so the returned type no longer includes Comment and later stages\n * only see Gen / Dropped / Fragment\n */\ntype IResolvedAssignment = Exclude<ILineAssignment, { kind: EnumIgnoreSplitLineKind.Comment }>;\n\n/**\n * 判斷單一規則行所屬的主題\n * Decide which topic a single rule line belongs to\n */\nfunction classifyTopic(line: string): IIgnoreSplitTopicId\n{\n\tfor (const [re, topic] of RULES)\n\t{\n\t\tif (re.test(line))\n\t\t{\n\t\t\treturn topic;\n\t\t}\n\t}\n\n\treturn '10-project';\n}\n\n/**\n * 讀取來源檔並去除結尾空行 / Read a source file and strip its trailing blank lines\n */\nfunction readLines(path: string): string[]\n{\n\tconst lines = readFileSync(path, 'utf8').split(/\\r?\\n/);\n\n\twhile (lines.length > 0 && lines[lines.length - 1] === '')\n\t{\n\t\tlines.pop();\n\t}\n\n\treturn lines;\n}\n\n/**\n * 判斷單一來源檔每一行的分類與主題\n * Decide the bucket and topic of every line in one source file\n *\n * @param file - 來源所屬的目標分類 / The target bucket of the source file\n * @param lines - 來源檔的所有行 / Every line of the source file\n * @param otherSet - 另一份來源檔的非空行集合(共用判定基準)/ The non-blank line set of the complementary source (the shared-bucket basis)\n */\nfunction processFile(\n\tfile: IIgnoreSplitTargetBucket,\n\tlines: string[],\n\totherSet: ReadonlySet<string>,\n): { lines: string[]; assign: (IResolvedAssignment | null)[] }\n{\n\tconst seen = new Set<string>();\n\tconst assign = new Array<ILineAssignment | null>(lines.length).fill(null);\n\n\tfor (let i = 0; i < lines.length; i++)\n\t{\n\t\tconst line = lines[i];\n\n\t\tif (line === '')\n\t\t{\n\t\t\tcontinue;\n\t\t}\n\n\t\t/**\n\t\t * 段落註解為「# 後接空白」的形式;`#jest.config.js` 這類被註解掉的規則\n\t\t * 不符合此形式,仍視為規則行走一般分類\n\t\t * A section comment is `#` followed by whitespace; a commented-out rule\n\t\t * like `#jest.config.js` does not match and is classified as a rule line\n\t\t */\n\t\tif (/^#\\s/.test(line))\n\t\t{\n\t\t\tassign[i] = { kind: EnumIgnoreSplitLineKind.Comment };\n\t\t\tcontinue;\n\t\t}\n\n\t\t/**\n\t\t * 規則行:同時出現在另一份來源檔即為共用分類\n\t\t * A rule line that also appears in the other source belongs to the shared bucket\n\t\t */\n\t\tconst bucket: IIgnoreSplitEmittedBucket = otherSet.has(line) ? EnumIgnoreSplitTargetBucket.shared : file;\n\n\t\t/**\n\t\t * 1. 命中共用輔助的重複語法 → 以佔位行取代\n\t\t * 1. A repeated matrix covered by a shared generator → replaced by a placeholder\n\t\t */\n\t\tlet genName: string | undefined;\n\n\t\tif (bucket === file)\n\t\t{\n\t\t\tfor (const [name, ruleSet] of Object.entries(GENERATOR_RULE_SETS))\n\t\t\t{\n\t\t\t\tconst generator = IGNORE_SPLIT_GENERATORS[name];\n\n\t\t\t\tif (generator.bucket === file && ruleSet.has(line))\n\t\t\t\t{\n\t\t\t\t\tgenName = name;\n\t\t\t\t\tbreak;\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\tif (genName)\n\t\t{\n\t\t\tassign[i] = { kind: EnumIgnoreSplitLineKind.Gen, bucket: file, topic: IGNORE_SPLIT_GENERATORS[genName].topic, genName };\n\t\t\treport.gen[genName] = (report.gen[genName] || 0) + 1;\n\t\t\tcontinue;\n\t\t}\n\n\t\tconst topic = classifyTopic(line);\n\n\t\t/**\n\t\t * 2. 同檔內重複出現 → other\n\t\t * 2. Repeated within the same file → other\n\t\t */\n\t\tif (seen.has(line))\n\t\t{\n\t\t\tassign[i] = { kind: EnumIgnoreSplitLineKind.Dropped, topic };\n\t\t\treport.dropped.dup.push({ bucket: file, line });\n\t\t\tcontinue;\n\t\t}\n\t\tseen.add(line);\n\n\t\t/**\n\t\t * 3. 冗餘(已被更廣泛的規則涵蓋)→ other\n\t\t * 3. Redundant (covered by a broader rule) → other\n\t\t */\n\t\tconst redundantNote = REDUNDANT[`${file}:${line}`];\n\n\t\tif (bucket === file && redundantNote)\n\t\t{\n\t\t\tassign[i] = { kind: EnumIgnoreSplitLineKind.Dropped, topic };\n\t\t\treport.dropped.redundant.push({ bucket: file, line, note: redundantNote });\n\t\t\tcontinue;\n\t\t}\n\n\t\t/**\n\t\t * 4. 一般規則 → 分類到 fragment\n\t\t * 4. An ordinary rule → classified into a fragment\n\t\t */\n\t\tassign[i] = { kind: EnumIgnoreSplitLineKind.Fragment, bucket, topic };\n\t}\n\n\t/**\n\t * 段落註解:主題採用下一個規則行的主題;分類採用同主題且會輸出的規則行。\n\t * 規則行被佔位或丟棄時,繼續向後找同主題的下一個輸出行。\n\t * A section comment adopts the topic of the next rule line and the bucket of\n\t * an emitted line of that topic; when that line is dropped or replaced by a\n\t * placeholder, it keeps scanning forward for the next emitted line of the\n\t * same topic.\n\t */\n\tfor (let i = 0; i < lines.length; i++)\n\t{\n\t\tconst current = assign[i];\n\n\t\tif (!current || current.kind !== EnumIgnoreSplitLineKind.Comment)\n\t\t{\n\t\t\tcontinue;\n\t\t}\n\n\t\t/**\n\t\t * git 檔案首行的官方說明保留為 00-header 片段\n\t\t * The official note on line 1 of the gitignore becomes the 00-header fragment\n\t\t */\n\t\tif (i === 0 && file === EnumIgnoreSplitTargetBucket.git)\n\t\t{\n\t\t\tassign[i] = { kind: EnumIgnoreSplitLineKind.Fragment, bucket: EnumIgnoreSplitTargetBucket.git, topic: '00-header' };\n\t\t\tcontinue;\n\t\t}\n\n\t\tlet topic: IIgnoreSplitTopicId | undefined;\n\n\t\tfor (let j = i + 1; j < lines.length; j++)\n\t\t{\n\t\t\tconst next = assign[j];\n\n\t\t\tif (!next || next.kind === EnumIgnoreSplitLineKind.Comment)\n\t\t\t{\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\ttopic = next.topic;\n\t\t\tbreak;\n\t\t}\n\n\t\tconst resolvedTopic = topic ?? '90-misc';\n\t\tlet bucket: IIgnoreSplitEmittedBucket = file;\n\n\t\tfor (let j = i + 1; j < lines.length; j++)\n\t\t{\n\t\t\tconst next = assign[j];\n\n\t\t\tif (!next || next.kind !== EnumIgnoreSplitLineKind.Fragment || next.topic !== resolvedTopic)\n\t\t\t{\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tbucket = next.bucket;\n\t\t\tbreak;\n\t\t}\n\n\t\tassign[i] = { kind: EnumIgnoreSplitLineKind.Fragment, bucket, topic: resolvedTopic };\n\t}\n\n\treturn { lines, assign: assign as (IResolvedAssignment | null)[] };\n}\n\n/**\n * 依分類取出被丟棄的規則行(供 other/ 片段分段列出)\n * Collect the dropped rule lines of one bucket (for the sections of other/)\n */\nfunction droppedLines(\n\tentries: readonly { bucket: IIgnoreSplitTargetBucket; line: string }[],\n\tbucket: IIgnoreSplitTargetBucket,\n): string[]\n{\n\treturn entries.filter(entry => entry.bucket === bucket).map(entry => entry.line);\n}\n\n/**\n * 腳本進入點:分割兩份來源檔並寫出分類片段\n * Script entry: split both source files and write out the classified fragments\n */\nfunction main(): void\n{\n\t/**\n\t * 讀取兩份來源檔(檔名來自 {@link IGNORE_SPLIT_TARGETS})\n\t * Read both source files (file names come from {@link IGNORE_SPLIT_TARGETS})\n\t */\n\tconst files = {} as Record<IIgnoreSplitTargetBucket, string[]>;\n\n\tfor (const { bucket, fileName } of IGNORE_SPLIT_TARGETS)\n\t{\n\t\tfiles[bucket] = readLines(join(__ROOT, 'file', fileName));\n\t}\n\n\tconst ruleLineSets = {} as Record<IIgnoreSplitTargetBucket, ReadonlySet<string>>;\n\n\tfor (const { bucket } of IGNORE_SPLIT_TARGETS)\n\t{\n\t\truleLineSets[bucket] = new Set(files[bucket].filter(line => line !== ''));\n\t}\n\n\tconst results = {} as Record<IIgnoreSplitTargetBucket, ReturnType<typeof processFile>>;\n\n\tfor (const { bucket } of IGNORE_SPLIT_TARGETS)\n\t{\n\t\tresults[bucket] = processFile(bucket, files[bucket], ruleLineSets[COMPLEMENT[bucket]]);\n\t}\n\n\t/**\n\t * 建立 groups[分類][主題] = 行陣列(依原始順序)\n\t * Build groups[bucket][topic] = line arrays (in original order)\n\t */\n\tconst groups = {} as Record<IIgnoreSplitEmittedBucket, Record<IIgnoreSplitTopicId, string[]>>;\n\n\tfor (const bucket of EMITTED_BUCKETS)\n\t{\n\t\tgroups[bucket] = Object.fromEntries(TOPICS.map(({ id }) => [id, [] as string[]])) as Record<IIgnoreSplitTopicId, string[]>;\n\t}\n\n\tconst emittedGen = new Set<string>();\n\n\tfor (const { bucket: file } of IGNORE_SPLIT_TARGETS)\n\t{\n\t\tconst { lines, assign } = results[file];\n\n\t\tfor (let i = 0; i < lines.length; i++)\n\t\t{\n\t\t\tconst current = assign[i];\n\n\t\t\tif (!current || current.kind === EnumIgnoreSplitLineKind.Dropped)\n\t\t\t{\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\t/**\n\t\t\t * 共用規則只在 git 通過時寫入(避免 git / npm 各推一次造成重複)\n\t\t\t * Shared rules are written only during the git pass (to avoid pushing once per source file)\n\t\t\t */\n\t\t\tif (current.bucket === EnumIgnoreSplitTargetBucket.shared && file === EnumIgnoreSplitTargetBucket.npm)\n\t\t\t{\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tif (current.kind === EnumIgnoreSplitLineKind.Gen)\n\t\t\t{\n\t\t\t\tconst key = `${current.bucket}|${current.topic}|${current.genName}`;\n\n\t\t\t\tif (emittedGen.has(key))\n\t\t\t\t{\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\t\t\t\temittedGen.add(key);\n\t\t\t\tgroups[current.bucket][current.topic].push(`# %gen:${current.genName}%`);\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tgroups[current.bucket][current.topic].push(lines[i]);\n\t\t}\n\t}\n\n\tconst written = new Set<string>();\n\n\tfor (const bucket of EMITTED_BUCKETS)\n\t{\n\t\tfor (const { id: topic, zh, en } of TOPICS)\n\t\t{\n\t\t\tconst content = groups[bucket][topic];\n\t\t\tconst path = getSplitFragmentPath(bucket, topic);\n\n\t\t\tif (content.length === 0)\n\t\t\t{\n\t\t\t\t/**\n\t\t\t\t * 該分類 × 主題已無內容:刪除舊檔,避免組合腳本讀到過期片段\n\t\t\t\t * This bucket × topic is now empty: remove the stale file so the compose script cannot read outdated content\n\t\t\t\t */\n\t\t\t\tif (existsSync(path))\n\t\t\t\t{\n\t\t\t\t\tunlinkSync(path);\n\t\t\t\t}\n\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tconst header = `# ${zh} / ${en} · ${BUCKET_LABEL[bucket]}`;\n\n\t\t\tmkdirSync(dirname(path), { recursive: true });\n\t\t\twriteFileSync(path, [header, ...content].join('\\n') + '\\n', 'utf8');\n\n\t\t\twritten.add(path);\n\t\t\treport.fragments[`${bucket}/${topic}`] = content.length;\n\t\t}\n\t}\n\n\t/**\n\t * other:不輸出的冗餘與重複規則,僅留存供稽核\n\t * other: duplicated and redundant rules, kept for auditing only\n\t */\n\t{\n\t\tconst content = [\n\t\t\t'# other: duplicated & redundant rules (never emitted)',\n\t\t\t'# these rules are never emitted into out/gitignore or out/npmignore; kept for auditing only',\n\t\t\t'# repetitive matrices are generated by the shared helper, see test/scripts/lib/ignore-split.ts',\n\t\t\t'',\n\t\t\t'# gitignore source: covered by a broader rule',\n\t\t\t...droppedLines(report.dropped.redundant, EnumIgnoreSplitTargetBucket.git),\n\t\t\t'',\n\t\t\t'# npmignore source: covered by a broader rule',\n\t\t\t...droppedLines(report.dropped.redundant, EnumIgnoreSplitTargetBucket.npm),\n\t\t\t'',\n\t\t\t'# gitignore source: duplicated',\n\t\t\t...droppedLines(report.dropped.dup, EnumIgnoreSplitTargetBucket.git),\n\t\t\t'',\n\t\t\t'# npmignore source: duplicated',\n\t\t\t...droppedLines(report.dropped.dup, EnumIgnoreSplitTargetBucket.npm),\n\t\t];\n\n\t\tconst path = getSplitFragmentPath(EnumIgnoreSplitTargetBucket.other, '90-duplicates' as any);\n\n\t\tmkdirSync(dirname(path), { recursive: true });\n\t\twriteFileSync(path, content.join('\\n') + '\\n', 'utf8');\n\n\t\twritten.add(path);\n\t}\n\n\t/**\n\t * 清理未重寫的片段檔(主題改名或刪除後的殘留),\n\t * 以逐檔 unlink 取代整目錄刪除,避免破壞性操作\n\t * Remove fragment files not rewritten by this run (leftovers after a topic\n\t * rename or removal); per-file unlink instead of a destructive directory wipe\n\t */\n\tfor (const bucket of [...EMITTED_BUCKETS, EnumIgnoreSplitTargetBucket.other])\n\t{\n\t\tconst dir = join(SPLIT_ROOT, bucket);\n\n\t\tif (!existsSync(dir))\n\t\t{\n\t\t\tcontinue;\n\t\t}\n\n\t\tfor (const entry of readdirSync(dir))\n\t\t{\n\t\t\tif (!entry.endsWith('.txt'))\n\t\t\t{\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tconst path = join(dir, entry);\n\n\t\t\tif (!written.has(path))\n\t\t\t{\n\t\t\t\tunlinkSync(path);\n\t\t\t}\n\t\t}\n\t}\n\n\tconsole.log(JSON.stringify({ fragments: report.fragments, gen: report.gen, dropped: report.dropped }, null, 2));\n}\n\nmain();\n"]}
|