음성 타입 fixture마다 옵션이 같은 tsconfig 하나, package script 하나, 게이트 명령 하나가 있었다(23벌). 옵션은 모두 같고 파일 하나만 달라서 fixture를 더할 때마다 세 곳을 같이 고쳤다. `tsconfig.recipes.json`도 `tsconfig.test.json`과 lib가 같고 types만 하나 적었다. `tsconfig.web-worker.json`은 `files: []`로 0파일을 검사하고 통과했다 (2026-09-25 리뷰가 기록, FE-GATE-003이 통과로 보였다). 고른 방법(design-docs repo-structure/04-frontend-layout.md 5.3절 (가), 소유자 승인 2026-11-07): - fixture 첫 줄에 기대(`// expect: TS2322`, `// expect: pass`)를 쓰고 `scripts/check-type-fixtures.ts`가 fixture마다 `.tmp/type-fixtures/`에 한 파일 tsconfig를 써서 tsc를 돈다. 판정은 run-ci-gate.ts가 명령마다 하던 것과 같다(exit 1과 `error TS<code>:`). 결과를 fixture별로 출력한다. 기대 줄이 없는 fixture와 fixture 0개는 실패한다. - recipes는 `tsconfig.test.json` include로 옮긴다. - web-worker tsconfig와 script는 지운다(결정 D4). Worker를 들일 때 더하는 단계는 매뉴얼 03에 쓴다(뒤 커밋). - `scripts/check-typecheck-inputs.ts`를 `check:types` 끝에 둔다. package script가 tsc에 넘기는 tsconfig마다 이 repo 파일이 1개 이상인지 본다. `files: []` tsconfig가 통과로 보이던 구멍을 막는다(R8). 버린 것: TypeScript API로 한 프로세스에서 돌리는 방법. 이 repo의 TypeScript 7.0(네이티브판)은 JS API를 싣지 않는다. 위반마다 `@ts-expect-error`를 쓰는 방법(5.3절 (나))은 오류 코드 고정을 잃는다. 위험: recipe가 이제 `vite/client` 타입이 있는 프로그램에서 검사된다. recipe가 `import.meta.env`를 쓰면 전에는 실패했고 이제는 통과한다 (복사한 제품도 Vite라 가치가 작다, 설계 5.1절). CI 계약 기준선을 다시 받았다(명령 99 → 76). 검증(desktop): `check:types:fixtures` 23개 PASS, 각 fixture의 기대 코드가 출력에 그대로 나온다. `TelemetryPort.emit` 인자를 `string`으로 넓히는 변이(2026-09-25 리뷰 07-05)에서 `invalid-diagnostics-port.ts`가 TS2578로 FAIL, 실행기 rc=1. 되돌린 뒤 작업 트리 0줄. `check:types` rc=0 (Typecheck inputs: app 379, node 312, service-worker 22, test 915). Refs: design-docs repo-structure/04-frontend-layout.md 5.3·9.2·9.3절, README.md 3.4절 D4
71 lines
2.7 KiB
TypeScript
71 lines
2.7 KiB
TypeScript
import { existsSync, readFileSync } from "node:fs";
|
|
import path from "node:path";
|
|
|
|
import { describe, expect, it } from "vitest";
|
|
|
|
// src/.generated is gitignored (R-0): every entry point that loads the product
|
|
// index must render it first, or a fresh checkout cannot run the gates.
|
|
const GENERATE = "node scripts/generate-product-feature-index.ts && ";
|
|
// Entry points the import walk below cannot see (tsc, vite, storybook).
|
|
const NON_NODE_ENTRY_SCRIPTS = [
|
|
"dev",
|
|
"storybook",
|
|
"build:storybook",
|
|
"check:types:app",
|
|
"check:types:node",
|
|
"check:types:test",
|
|
// Its fixtures, compiled through the TypeScript API, import the index.
|
|
"check:types:fixtures",
|
|
] as const;
|
|
|
|
const ROOT = process.cwd();
|
|
const GENERATED_DIR = path.join(ROOT, "src/.generated");
|
|
const RELATIVE_IMPORT =
|
|
/(?:import|export)\s[^'"]*?from\s+["'](\.{1,2}\/[^"']+)["']|import\(\s*["'](\.{1,2}\/[^"']+)["']\s*\)/gu;
|
|
|
|
function reachesGeneratedIndex(file: string, seen = new Set<string>()): boolean {
|
|
if (seen.has(file) || !existsSync(file)) return false;
|
|
seen.add(file);
|
|
for (const match of readFileSync(file, "utf8").matchAll(RELATIVE_IMPORT)) {
|
|
const resolved = path.resolve(path.dirname(file), match[1] ?? match[2] ?? "");
|
|
if (resolved.startsWith(GENERATED_DIR)) return true;
|
|
if (reachesGeneratedIndex(resolved, seen)) return true;
|
|
}
|
|
return false;
|
|
}
|
|
|
|
function packageScripts(): Record<string, string> {
|
|
return (JSON.parse(readFileSync("package.json", "utf8")) as { scripts: Record<string, string> })
|
|
.scripts;
|
|
}
|
|
|
|
describe("product index entry points", () => {
|
|
it("renders the generated index before tsc, vite and storybook entry points", () => {
|
|
const scripts = packageScripts();
|
|
for (const name of NON_NODE_ENTRY_SCRIPTS) {
|
|
expect(scripts[name]?.startsWith(GENERATE), name).toBe(true);
|
|
}
|
|
});
|
|
|
|
it("renders the generated index before every node script that imports it", () => {
|
|
const missing = Object.entries(packageScripts())
|
|
.filter(([, command]) => !command.startsWith(GENERATE))
|
|
.filter(([, command]) =>
|
|
[...command.matchAll(/node\s+(scripts\/[\w./-]+\.ts)/gu)]
|
|
.map((match) => match[1] ?? "")
|
|
.filter((entry) => entry !== "scripts/run-vitest.ts")
|
|
.some((entry) => reachesGeneratedIndex(path.join(ROOT, entry))),
|
|
)
|
|
.map(([name]) => name);
|
|
expect(missing).toEqual([]);
|
|
});
|
|
|
|
it("renders the generated index before every Vitest run", () => {
|
|
const runner = readFileSync("scripts/run-vitest.ts", "utf8");
|
|
expect(runner.indexOf("generate-product-feature-index.ts")).toBeGreaterThan(-1);
|
|
expect(runner.indexOf("generate-product-feature-index.ts")).toBeLessThan(
|
|
runner.indexOf("vitestEntry, ...process.argv"),
|
|
);
|
|
});
|
|
});
|