음성 타입 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
142 lines
6.0 KiB
TypeScript
142 lines
6.0 KiB
TypeScript
import { spawn } from "node:child_process";
|
|
import { mkdir, readdir, readFile, rm, writeFile } from "node:fs/promises";
|
|
import path from "node:path";
|
|
import { fileURLToPath } from "node:url";
|
|
|
|
/**
|
|
* The negative type fixtures (FE-GATE-003). Each fixture under
|
|
* tests/fixtures/typecheck states on its first line what tsc must say about
|
|
* it: `// expect: TS2322` (compilation fails and reports TS2322) or
|
|
* `// expect: pass` (it compiles; tests/fixtures/typecheck/invalid-diagnostics-port.ts
|
|
* holds one `@ts-expect-error` per violation). Every fixture compiles alone
|
|
* with tests/fixtures/typecheck/tsconfig.base.json, as the 23 one-file
|
|
* tsconfigs and package scripts this runner replaces did (design-docs
|
|
* repo-structure/04-frontend-layout.md §5.3 (가)).
|
|
*
|
|
* The check is the one run-ci-gate.ts applied to each of those commands:
|
|
* tsc exits 1 and its output contains `error TS<code>:`. A fixture without an
|
|
* expectation line fails, and so does a directory with no fixtures, so a new
|
|
* fixture cannot be skipped and an empty run cannot pass (R8).
|
|
*/
|
|
|
|
export const TYPE_FIXTURE_ROOT = "tests/fixtures/typecheck";
|
|
const BASE_CONFIG = `${TYPE_FIXTURE_ROOT}/tsconfig.base.json`;
|
|
/**
|
|
* tsc resolves `types` from the tsconfig's directory upwards, so the one-file
|
|
* tsconfigs are written inside the repository, in the ignored `.tmp/`.
|
|
*/
|
|
const CONFIG_ROOT = ".tmp/type-fixtures";
|
|
const EXPECTATION = /^\/\/ expect: (pass|TS\d{4,5})$/u;
|
|
/** Helpers that fixtures import are not fixtures. */
|
|
const FIXTURE_FILE = /^invalid-[\w-]+\.tsx?$/u;
|
|
const CONCURRENCY = 4;
|
|
|
|
export type TypeFixtureExpectation = { kind: "pass" } | { kind: "fail"; code: string };
|
|
|
|
export interface TypeFixtureResult {
|
|
file: string;
|
|
expectation: TypeFixtureExpectation | undefined;
|
|
passed: boolean;
|
|
/** The diagnostic lines that met the expectation, or all output on failure. */
|
|
evidence: string[];
|
|
}
|
|
|
|
export function parseTypeFixtureExpectation(source: string): TypeFixtureExpectation | undefined {
|
|
const match = EXPECTATION.exec(source.split("\n", 1)[0]?.trimEnd() ?? "");
|
|
if (!match?.[1]) return undefined;
|
|
return match[1] === "pass" ? { kind: "pass" } : { kind: "fail", code: match[1] };
|
|
}
|
|
|
|
export async function listTypeFixtures(root: string): Promise<string[]> {
|
|
return (await readdir(path.join(root, TYPE_FIXTURE_ROOT)))
|
|
.filter((name) => FIXTURE_FILE.test(name))
|
|
.sort()
|
|
.map((name) => `${TYPE_FIXTURE_ROOT}/${name}`);
|
|
}
|
|
|
|
export function judgeTypeFixture(
|
|
expectation: TypeFixtureExpectation,
|
|
exitCode: number | null,
|
|
output: string,
|
|
): Pick<TypeFixtureResult, "passed" | "evidence"> {
|
|
const lines = output.split("\n").filter((line) => line.trim().length > 0);
|
|
if (expectation.kind === "pass") {
|
|
return { passed: exitCode === 0, evidence: lines };
|
|
}
|
|
const matching = lines.filter((line) => line.includes(`error ${expectation.code}:`));
|
|
return exitCode === 1 && matching.length > 0
|
|
? { passed: true, evidence: matching }
|
|
: { passed: false, evidence: [`tsc exit ${exitCode}`, ...lines] };
|
|
}
|
|
|
|
function runTsc(root: string, config: string): Promise<{ exitCode: number | null; output: string }> {
|
|
return new Promise((resolve, reject) => {
|
|
const child = spawn(path.join(root, "node_modules/.bin/tsc"), ["--project", config, "--pretty", "false"], {
|
|
cwd: root,
|
|
stdio: ["ignore", "pipe", "pipe"],
|
|
});
|
|
let output = "";
|
|
child.stdout.on("data", (chunk: Buffer) => (output += chunk.toString("utf8")));
|
|
child.stderr.on("data", (chunk: Buffer) => (output += chunk.toString("utf8")));
|
|
child.on("error", reject);
|
|
child.on("close", (exitCode) => resolve({ exitCode, output }));
|
|
});
|
|
}
|
|
|
|
async function checkTypeFixture(root: string, file: string): Promise<TypeFixtureResult> {
|
|
const expectation = parseTypeFixtureExpectation(await readFile(path.join(root, file), "utf8"));
|
|
if (!expectation) {
|
|
return { file, expectation, passed: false, evidence: ["missing `// expect:` first line"] };
|
|
}
|
|
const config = path.join(CONFIG_ROOT, `tsconfig.${path.basename(file).replace(/\.tsx?$/u, "")}.json`);
|
|
const fromConfig = (target: string) => path.relative(path.dirname(config), target);
|
|
await writeFile(
|
|
path.join(root, config),
|
|
`${JSON.stringify({ extends: fromConfig(BASE_CONFIG), files: [fromConfig(file)] }, null, 2)}\n`,
|
|
);
|
|
const { exitCode, output } = await runTsc(root, config);
|
|
return { file, expectation, ...judgeTypeFixture(expectation, exitCode, output) };
|
|
}
|
|
|
|
export async function checkTypeFixtures(root: string): Promise<TypeFixtureResult[]> {
|
|
const fixtures = await listTypeFixtures(root);
|
|
await rm(path.join(root, CONFIG_ROOT), { recursive: true, force: true });
|
|
await mkdir(path.join(root, CONFIG_ROOT), { recursive: true });
|
|
const results: TypeFixtureResult[] = new Array(fixtures.length);
|
|
let next = 0;
|
|
await Promise.all(
|
|
Array.from({ length: Math.min(CONCURRENCY, fixtures.length) }, async () => {
|
|
while (next < fixtures.length) {
|
|
const index = next++;
|
|
results[index] = await checkTypeFixture(root, fixtures[index]!);
|
|
}
|
|
}),
|
|
);
|
|
return results;
|
|
}
|
|
|
|
function describeExpectation(expectation: TypeFixtureExpectation | undefined): string {
|
|
if (!expectation) return "no expectation";
|
|
return expectation.kind === "pass" ? "expect pass" : `expect ${expectation.code}`;
|
|
}
|
|
|
|
if (process.argv[1] && path.resolve(process.argv[1]) === fileURLToPath(import.meta.url)) {
|
|
const results = await checkTypeFixtures(process.cwd());
|
|
for (const result of results) {
|
|
process.stdout.write(
|
|
`${result.passed ? "PASS" : "FAIL"} ${result.file} (${describeExpectation(result.expectation)})\n`,
|
|
);
|
|
for (const line of result.evidence) process.stdout.write(` ${line}\n`);
|
|
}
|
|
const failed = results.filter(({ passed }) => !passed);
|
|
if (results.length === 0) {
|
|
process.stderr.write(`Type fixtures: FAIL (no fixtures under ${TYPE_FIXTURE_ROOT})\n`);
|
|
process.exitCode = 1;
|
|
} else if (failed.length > 0) {
|
|
process.stderr.write(`Type fixtures: FAIL (${failed.length} of ${results.length})\n`);
|
|
process.exitCode = 1;
|
|
} else {
|
|
process.stdout.write(`Type fixtures: PASS (${results.length} fixtures)\n`);
|
|
}
|
|
}
|