import { mkdir, readFile, readdir } from "node:fs/promises"; import { i18nReportArtifactSchema } from "./contracts/release-artifacts.ts"; import { writeValidatedJsonArtifact } from "./lib/validated-json-artifact.ts"; import { findTechLogBehavioralLiteralViolations } from "./lib/tech-log-i18n-policy.ts"; import path from "node:path"; import { EN_MESSAGES, KO_MESSAGES, MESSAGE_CATALOGS } from "../src/presentation/i18n/catalog.ts"; const fixtureMode = process.argv.includes("--fixture"); const failures: string[] = []; const sourceExtensions = /\.(?:ts|tsx|mts|cts)$/; const koreanLiteral = /[가-힣]/; const rawFailureRender = /(? { const result: string[] = []; for (const entry of await readdir(directory, { withFileTypes: true })) { const target = path.join(directory, entry.name); if (entry.isDirectory()) result.push(...(await listSourceFiles(target))); else if (sourceExtensions.test(entry.name)) result.push(target); } return result; } function placeholders(template: string): string[] { return [...template.matchAll(/\{([a-zA-Z][a-zA-Z0-9]*)\}/g)] .map((match) => match[1]) .sort(); } if (!fixtureMode) { const canonicalKeys = Object.keys(KO_MESSAGES).sort(); for (const [locale, catalog] of Object.entries(MESSAGE_CATALOGS)) { const readableCatalog = catalog as Readonly>; const canonicalCatalog = KO_MESSAGES as Readonly>; const keys = Object.keys(catalog).sort(); if (JSON.stringify(keys) !== JSON.stringify(canonicalKeys)) { failures.push(`${locale} catalog keys do not match ko-KR`); } for (const key of canonicalKeys) { if ( JSON.stringify(placeholders(readableCatalog[key] ?? "")) !== JSON.stringify(placeholders(canonicalCatalog[key] ?? "")) ) { failures.push(`${locale}:${key} interpolation parameters do not match`); } } } if (Object.keys(EN_MESSAGES).length !== canonicalKeys.length) { failures.push("en-US catalog key count does not match ko-KR"); } } // 08-04. Screen code under these directories must take its words from the // catalog. `src/presentation/examples` is the component gallery and stays out // of scope on purpose. Fixture mode runs the same discovery on a fixture tree. const sourceRoot = fixtureMode ? "tests/fixtures/i18n/forbidden" : "."; const commonDirectories = [ "src/presentation/boundaries", "src/presentation/components", "src/presentation/design-system", "src/presentation/forms", "src/presentation/layouts", "src/presentation/pages", "src/presentation/routes", "src/presentation/templates", ]; async function featurePresentationDirectories(root: string): Promise { const features = path.join(root, "src/features"); const entries = await readdir(features, { withFileTypes: true }).catch( () => [], ); return entries .filter((entry) => entry.isDirectory()) .map((entry) => path.join("src/features", entry.name, "presentation")); } async function existingSourceFiles(directory: string): Promise { return listSourceFiles(directory).catch((error: NodeJS.ErrnoException) => { if (error.code === "ENOENT") return []; throw error; }); } // Template sync (af3d8e6). TechLog's presentation is held to its own // behavioral-literal policy (scripts/lib/tech-log-i18n-policy.ts), which reads // string literals and JSX text rather than whole files, so the whole-file // Korean rule above applies to every other feature and not to it. const techLogPresentation = path.join("src/features", "tech-log", "presentation"); const sourceDirectories = [ ...commonDirectories, ...(await featurePresentationDirectories(sourceRoot)).filter( (directory) => directory !== techLogPresentation, ), ].map((directory) => path.join(sourceRoot, directory)); const sources = ( await Promise.all(sourceDirectories.map(existingSourceFiles)) ).flat(); const techLogSources = fixtureMode ? [] : await existingSourceFiles(techLogPresentation); for (const file of sources) { const source = await readFile(file, "utf8"); if (koreanLiteral.test(source)) { failures.push(`hardcoded common user-facing locale literal in ${file}`); } if (rawFailureRender.test(source)) { failures.push(`raw backend/error message rendered in ${file}`); } if (source.includes("dangerouslySetInnerHTML")) { failures.push(`untrusted HTML interpolation boundary in ${file}`); } } for (const file of techLogSources) { const source = await readFile(file, "utf8"); for (const violation of findTechLogBehavioralLiteralViolations(source)) { failures.push( `hardcoded TechLog behavioral locale literal in ${file}:${violation.kind}:${violation.text}`, ); } if (rawFailureRender.test(source)) { failures.push(`raw backend/error message rendered in ${file}`); } if (source.includes("dangerouslySetInnerHTML")) { failures.push(`untrusted HTML interpolation boundary in ${file}`); } } const report = i18nReportArtifactSchema.parse({ schemaVersion: 1, mode: fixtureMode ? "negative-fixture" : "source", localeCount: Object.keys(MESSAGE_CATALOGS).length + 1, messageKeyCount: Object.keys(KO_MESSAGES).length, checkedFiles: sources.length + techLogSources.length, failures, passed: failures.length === 0, }); await mkdir("artifacts/quality", { recursive: true }); await writeValidatedJsonArtifact({ path: fixtureMode ? "artifacts/quality/i18n-fixture.json" : "artifacts/quality/i18n.json", schema: i18nReportArtifactSchema, value: report, }); // Every fixture file must be rejected on its own; one rejected file must not // hide a directory the discovery above stopped reaching. const fixtureFiles = fixtureMode ? await listSourceFiles(sourceRoot) : []; const unrejectedFixtures = fixtureFiles.filter( (file) => !failures.some((failure) => failure.endsWith(file)), ); if (fixtureMode && (fixtureFiles.length === 0 || unrejectedFixtures.length > 0)) { process.stderr.write( `I18n fixture was not rejected:\n${unrejectedFixtures.join("\n") || "(no fixture files found)"}\n`, ); process.exit(2); } if (failures.length > 0) { process.stderr.write(`I18n contract failed:\n${failures.join("\n")}\n`); process.exit(1); } process.stdout.write( `I18n contract: ${report.messageKeyCount} keys across ${report.localeCount} locales PASS\n`, );