import { readdir, readFile } from "node:fs/promises"; import path from "node:path"; /** * 1105/16-04. What a product feature leaves behind after * `test:sample-removal -- --feature=` deleted its folders, in the copy the * drill made. * * - `src/`: any file whose path or text still names the feature ID or its * folder. Platform source never names a product feature, so a name left * there is a reference the type checker cannot see (a catalog key, a * runtime override, a link). * - `tests/`: a file named after the feature, or one that imports from the * feature's `src/features//` or `tests/features//`. The test * text is not searched for the bare name: the template's own tests use * example IDs as data (`tests/unit/create-feature.test.ts` writes * `invoice-feature`, the manual's example, 51 times), and the drill flagged * them as residue of a product feature that took that name. A test that * still depends on the removed feature fails `test:all`, which the drill * runs. * * The reference sample keeps its own, wider pattern in * scripts/test-sample-removal.ts: the template owns all of its files. */ function escapeRegExp(value: string): string { return value.replace(/[.*+?^${}()|[\]\\]/gu, "\\$&"); } async function filesUnder(directory: string): Promise { const entries = await readdir(directory, { withFileTypes: true }).catch(() => []); const nested = await Promise.all( entries.map((entry) => { const target = path.join(directory, entry.name); return entry.isDirectory() ? filesUnder(target) : Promise.resolve([target]); }), ); return nested.flat(); } export async function productFeatureResidue( root: string, featureId: string, directory: string, ): Promise { const names = [...new Set([featureId, directory])].map(escapeRegExp).join("|"); const named = new RegExp(names, "iu"); const imported = new RegExp( String.raw`(?:\bfrom\s*|\bimport\s*\(\s*|\bimport\s+|\bmock\s*\(\s*)["'][^"'\n]*/features/(?:${names})/`, "u", ); const residue: string[] = []; const relative = (file: string) => path.relative(root, file).split(path.sep).join("/"); for (const file of await filesUnder(path.join(root, "src"))) { const name = relative(file); if (named.test(`${name}\n${await readFile(file, "utf8")}`)) residue.push(name); } for (const file of await filesUnder(path.join(root, "tests"))) { const name = relative(file); if (named.test(name) || imported.test(await readFile(file, "utf8"))) residue.push(name); } return residue.sort(); }