@venizia/dev-configs 0.4.3 → 0.4.5

package/dist/cli/check.js

@@ -0,0 +1,319 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CheckCommand = void 0;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const catalog_1 = require("../checks/catalog");
+const module_cycles_1 = require("../checks/module-cycles");
+const run_1 = require("../checks/purity/run");
+const split_report_1 = require("../checks/split-report");
+const test_controls_1 = require("../checks/test-controls");
+const test_dead_code_1 = require("../checks/test-dead-code");
+const test_mutate_1 = require("../checks/test-mutate");
+const test_weight_1 = require("../checks/test-weight");
+const USAGE = `Usage: devz check <name> [options]
+
+Checks:
+  purity [package] --claims <file> [--json]   probe every entry claimed browser-pure (needs a build)
+  module-cycles <dir> [--max <n>]             list the import cycles of a built ESM folder
+  split-report [--dist <dir>] [folder...]     report hub files, stray types, missing barrels, long files, cycles (never a gate)
+  catalog [--glob <pattern>]... [--pinned <file>]... [--preset-prefix <prefix>]
+                                              guard dependency ranges against the root workspaces.catalog
+  test-weight [--top <n>] <junit.xml>...      per-file time, cases, assertions, duplicates and skips from bun's JUnit report
+  test-dead-code                              list support files under __tests__ that no other file refers to (candidates)
+  test-mutate <ledger.json>                   replay a mutation ledger: the survivor must go red under each mutant
+  test-controls <registry.json>               fail when a registered positive-control test is gone
+
+purity
+  --claims <file>   a module that exports PURITY_CLAIMS (the claims) and, optionally, PURITY_OPTIONS
+  [package]         probe only the rows of this package; a token that matches nothing fails
+  --json            print the verdict as JSON (no paths of this machine, no timing) instead of the report
+
+
+test-weight, test-dead-code, test-mutate, test-controls: the tools of the trim-tests method, see
+  .agents/knowledge/process/trimming-tests.md in the IGNIS repository. Produce the JUnit files with
+  bun test ./src --parallel --reporter=junit --reporter-outfile=<file>.
+
+module-cycles
+  <dir>, or --dist <dir>   the built folder (dist/esm); exits 1 when more cycles than --max, 2 on a usage error
+
+split-report
+  --dist <dir>   the built ESM folder inside a package: dist/esm, or dist where one build is published (default dist)
+  [folder...]    package folders to report; none scans every packages/* and examples/* that has a src/
+
+catalog
+  --glob <pattern>      a manifest glob beside packages/*/package.json (repeatable)
+  --pinned <file>       a manifest outside the workspace: its catalogued ranges must equal the catalog's (repeatable)
+  --preset-prefix <p>   files under this prefix are presets: catalog: is allowed in their peerDependencies
+
+  --help            print this text and exit`;
+/** A usage error: nothing was probed. */
+const USAGE_ERROR_CODE = 2;
+const parsePurityArguments = (args) => {
+    const parsed = { json: false };
+    for (let index = 0; index < args.length; index += 1) {
+        const arg = args[index];
+        if (arg === '--json') {
+            parsed.json = true;
+            continue;
+        }
+        if (arg === '--claims') {
+            const value = args[index + 1];
+            if (value === undefined || value.startsWith('--')) {
+                return '--claims needs a file';
+            }
+            parsed.claimsFile = value;
+            index += 1;
+            continue;
+        }
+        if (arg.startsWith('--')) {
+            return `unknown option "${arg}"`;
+        }
+        if (parsed.filter !== undefined) {
+            return `unexpected argument "${arg}"`;
+        }
+        parsed.filter = arg;
+    }
+    return parsed;
+};
+/** Splits repeatable `--name value` options and positionals; `undefined` for an option that lacks its value. */
+const parseRepeatable = (opts) => {
+    const { args, repeatable, single } = opts;
+    const values = {};
+    const positionals = [];
+    for (let index = 0; index < args.length; index += 1) {
+        const arg = args[index];
+        if (arg.startsWith('--')) {
+            const name = arg.slice(2);
+            if (!repeatable.includes(name) && !single.includes(name)) {
+                return `unknown option "${arg}"`;
+            }
+            const value = args[index + 1];
+            if (value === undefined || value.startsWith('--')) {
+                return `${arg} needs a value`;
+            }
+            values[name] = [...(values[name] ?? []), value];
+            index += 1;
+            continue;
+        }
+        positionals.push(arg);
+    }
+    return { positionals, values };
+};
+/** `devz check <name>`: runs one of the shared repository gates in the current folder. */
+class CheckCommand {
+    static runTestWeight(opts) {
+        const parsed = parseRepeatable({ args: opts.args, repeatable: [], single: ['top'] });
+        if (typeof parsed === 'string' || parsed.positionals.length === 0) {
+            console.error(`devz check test-weight: ${typeof parsed === 'string' ? parsed : 'give at least one JUnit file'}\n${USAGE}`);
+            return USAGE_ERROR_CODE;
+        }
+        const reports = parsed.positionals.map((file) => {
+            const path = (0, node_path_1.resolve)(opts.root, file);
+            return {
+                label: (0, node_path_1.basename)(file).replace(/\.xml$/, ''),
+                xml: (0, node_fs_1.existsSync)(path) ? (0, node_fs_1.readFileSync)(path, 'utf8') : '',
+            };
+        });
+        const missing = parsed.positionals.filter((file) => !(0, node_fs_1.existsSync)((0, node_path_1.resolve)(opts.root, file)));
+        if (missing.length > 0) {
+            console.error(`devz check test-weight: not found: ${missing.join(', ')}`);
+            return USAGE_ERROR_CODE;
+        }
+        const top = parsed.values.top?.[0] === undefined ? undefined : Number(parsed.values.top[0]);
+        for (const line of (0, test_weight_1.formatTestWeight)({ report: (0, test_weight_1.analyseJunit)({ reports }), top })) {
+            console.log(line);
+        }
+        return 0;
+    }
+    static runTestDeadCode(opts) {
+        if (opts.args.length > 0) {
+            console.error(`devz check test-dead-code: unexpected argument "${opts.args[0]}"\n${USAGE}`);
+            return USAGE_ERROR_CODE;
+        }
+        const candidates = (0, test_dead_code_1.findDeadTestCode)({ root: opts.root });
+        for (const kind of ['unreferenced', 'folder-referenced']) {
+            const own = candidates.filter((candidate) => candidate.kind === kind);
+            console.log(`${kind}: ${own.length}`);
+            for (const candidate of own) {
+                console.log(`  ${candidate.file}`);
+            }
+        }
+        console.log('\nThese are candidates: delete one, run the package suite, and keep it if anything fails or loads it by a built path.');
+        return 0;
+    }
+    static runTestMutate(opts) {
+        const [file, ...extra] = opts.args;
+        if (file === undefined || extra.length > 0) {
+            console.error(`devz check test-mutate: give one ledger file\n${USAGE}`);
+            return USAGE_ERROR_CODE;
+        }
+        const path = (0, node_path_1.resolve)(opts.root, file);
+        if (!(0, node_fs_1.existsSync)(path)) {
+            console.error(`devz check test-mutate: ledger not found: ${file}`);
+            return USAGE_ERROR_CODE;
+        }
+        const ledger = JSON.parse((0, node_fs_1.readFileSync)(path, 'utf8'));
+        if (!Array.isArray(ledger.mutants)) {
+            console.error(`devz check test-mutate: ${file} has no "mutants" array`);
+            return USAGE_ERROR_CODE;
+        }
+        const results = (0, test_mutate_1.replayLedger)({ root: opts.root, ledger });
+        for (const line of (0, test_mutate_1.formatLedgerResults)(results)) {
+            console.log(line);
+        }
+        return results.every((result) => result.ok) ? 0 : 1;
+    }
+    static async runTestControls(opts) {
+        const [file, ...extra] = opts.args;
+        if (file === undefined || extra.length > 0) {
+            console.error(`devz check test-controls: give one registry file\n${USAGE}`);
+            return USAGE_ERROR_CODE;
+        }
+        const path = (0, node_path_1.resolve)(opts.root, file);
+        if (!(0, node_fs_1.existsSync)(path)) {
+            console.error(`devz check test-controls: registry not found: ${file}`);
+            return USAGE_ERROR_CODE;
+        }
+        const registry = JSON.parse((0, node_fs_1.readFileSync)(path, 'utf8'));
+        if (!Array.isArray(registry.controls)) {
+            console.error(`devz check test-controls: ${file} has no "controls" array`);
+            return USAGE_ERROR_CODE;
+        }
+        const report = await (0, test_controls_1.checkControls)({ root: opts.root, controls: registry.controls });
+        if (report.problems.length === 0) {
+            console.log(`test-controls: OK - ${report.checked} registered controls found`);
+            return 0;
+        }
+        console.error(`test-controls: ${report.problems.length} of ${report.checked} registered controls are gone:`);
+        for (const problem of report.problems) {
+            console.error(`  [${problem.entry.gate}] ${problem.message}`);
+        }
+        return 1;
+    }
+    static runSplitReport(opts) {
+        const parsed = parseRepeatable({ args: opts.args, repeatable: [], single: ['dist'] });
+        if (typeof parsed === 'string') {
+            console.error(`devz check split-report: ${parsed}\n${USAGE}`);
+            return USAGE_ERROR_CODE;
+        }
+        const targets = parsed.positionals.length
+            ? parsed.positionals.map((target) => (0, node_path_1.resolve)(opts.root, target))
+            : split_report_1.SplitReport.defaultTargets({ root: opts.root });
+        for (const packageDir of targets) {
+            split_report_1.SplitReport.run({ packageDir, distDir: parsed.values.dist?.[0] });
+        }
+        return 0;
+    }
+    static async runCatalog(opts) {
+        const parsed = parseRepeatable({
+            args: opts.args,
+            repeatable: ['glob', 'pinned'],
+            single: ['preset-prefix'],
+        });
+        if (typeof parsed === 'string' || parsed.positionals.length > 0) {
+            console.error(`devz check catalog: ${typeof parsed === 'string' ? parsed : `unexpected argument "${parsed.positionals[0]}"`}\n${USAGE}`);
+            return USAGE_ERROR_CODE;
+        }
+        const report = await (0, catalog_1.findCatalogProblems)({
+            root: opts.root,
+            globs: parsed.values.glob,
+            pinned: parsed.values.pinned,
+            presetPrefix: parsed.values['preset-prefix']?.[0],
+        });
+        if (report.noCatalog) {
+            console.error('check-catalog: no `workspaces.catalog` in the root package.json');
+            return 1;
+        }
+        if (report.problems.length === 0) {
+            console.log(`check-catalog: OK - ${report.entries} entries, ${report.referenced} referenced`);
+            return 0;
+        }
+        console.error(`check-catalog: ${report.problems.length} problem(s):`);
+        for (const problem of report.problems) {
+            console.error(`  ${problem.file}: ${problem.message}`);
+        }
+        return 1;
+    }
+    static async run(opts) {
+        const { root, args = [] } = opts;
+        const [name, ...rest] = args;
+        if (name === undefined || name === '--help' || name === '-h') {
+            console.log(USAGE);
+            return name === undefined ? USAGE_ERROR_CODE : 0;
+        }
+        if (name === 'module-cycles') {
+            return (0, module_cycles_1.runModuleCycles)({
+                args: rest,
+                print: (line) => console.log(line),
+                printError: (line) => console.error(line),
+            });
+        }
+        if (name === 'split-report') {
+            return CheckCommand.runSplitReport({ root, args: rest });
+        }
+        if (name === 'catalog') {
+            return CheckCommand.runCatalog({ root, args: rest });
+        }
+        if (name === 'test-weight') {
+            return CheckCommand.runTestWeight({ root, args: rest });
+        }
+        if (name === 'test-dead-code') {
+            return CheckCommand.runTestDeadCode({ root, args: rest });
+        }
+        if (name === 'test-mutate') {
+            return CheckCommand.runTestMutate({ root, args: rest });
+        }
+        if (name === 'test-controls') {
+            return CheckCommand.runTestControls({ root, args: rest });
+        }
+        if (name !== 'purity') {
+            console.error(`devz check: unknown check "${name}"\n${USAGE}`);
+            return USAGE_ERROR_CODE;
+        }
+        if (rest.includes('--help') || rest.includes('-h')) {
+            console.log(USAGE);
+            return 0;
+        }
+        const parsed = parsePurityArguments(rest);
+        if (typeof parsed === 'string') {
+            console.error(`devz check purity: ${parsed}\n${USAGE}`);
+            return USAGE_ERROR_CODE;
+        }
+        if (parsed.claimsFile === undefined) {
+            console.error(`devz check purity: --claims <file> is required\n${USAGE}`);
+            return USAGE_ERROR_CODE;
+        }
+        const claimsPath = (0, node_path_1.isAbsolute)(parsed.claimsFile)
+            ? parsed.claimsFile
+            : (0, node_path_1.resolve)(root, parsed.claimsFile);
+        if (!(0, node_fs_1.existsSync)(claimsPath)) {
+            console.error(`devz check purity: claims file not found: ${parsed.claimsFile}`);
+            return USAGE_ERROR_CODE;
+        }
+        const claimsModule = await import(claimsPath);
+        if (!Array.isArray(claimsModule.PURITY_CLAIMS)) {
+            console.error(`devz check purity: ${parsed.claimsFile} does not export PURITY_CLAIMS`);
+            return USAGE_ERROR_CODE;
+        }
+        const lines = [];
+        const report = await (0, run_1.checkPurity)({
+            root,
+            claims: claimsModule.PURITY_CLAIMS,
+            options: claimsModule.PURITY_OPTIONS,
+            filter: parsed.filter,
+            claimsFile: (0, node_path_1.relative)(root, claimsPath),
+            print: (line) => (parsed.json ? lines.push(line) : console.log(line)),
+            printError: (line) => console.error(line),
+        });
+        if (report === undefined) {
+            return 1;
+        }
+        if (parsed.json) {
+            console.log(JSON.stringify(report, null, 2));
+        }
+        return report.failed > 0 ? 1 : 0;
+    }
+}
+exports.CheckCommand = CheckCommand;
+//# sourceMappingURL=check.js.map

package/dist/cli/check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.js","sourceRoot":"","sources":["../../src/cli/check.ts"],"names":[],"mappings":"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","sourcesContent":["import { existsSync, readFileSync } from 'node:fs';\nimport { basename, isAbsolute, relative, resolve } from 'node:path';\nimport { findCatalogProblems } from '../checks/catalog';\nimport { runModuleCycles } from '../checks/module-cycles';\nimport { checkPurity } from '../checks/purity/run';\nimport { SplitReport } from '../checks/split-report';\nimport { checkControls } from '../checks/test-controls';\nimport type { IControlEntry } from '../checks/test-controls';\nimport { findDeadTestCode } from '../checks/test-dead-code';\nimport { formatLedgerResults, replayLedger } from '../checks/test-mutate';\nimport type { ILedger } from '../checks/test-mutate';\nimport { analyseJunit, formatTestWeight } from '../checks/test-weight';\nimport type { IPurityClaim, IPurityOptions } from '../checks/purity/manifest';\n\nconst USAGE = `Usage: devz check <name> [options]\n\nChecks:\n  purity [package] --claims <file> [--json]   probe every entry claimed browser-pure (needs a build)\n  module-cycles <dir> [--max <n>]             list the import cycles of a built ESM folder\n  split-report [--dist <dir>] [folder...]     report hub files, stray types, missing barrels, long files, cycles (never a gate)\n  catalog [--glob <pattern>]... [--pinned <file>]... [--preset-prefix <prefix>]\n                                              guard dependency ranges against the root workspaces.catalog\n  test-weight [--top <n>] <junit.xml>...      per-file time, cases, assertions, duplicates and skips from bun's JUnit report\n  test-dead-code                              list support files under __tests__ that no other file refers to (candidates)\n  test-mutate <ledger.json>                   replay a mutation ledger: the survivor must go red under each mutant\n  test-controls <registry.json>               fail when a registered positive-control test is gone\n\npurity\n  --claims <file>   a module that exports PURITY_CLAIMS (the claims) and, optionally, PURITY_OPTIONS\n  [package]         probe only the rows of this package; a token that matches nothing fails\n  --json            print the verdict as JSON (no paths of this machine, no timing) instead of the report\n\n\ntest-weight, test-dead-code, test-mutate, test-controls: the tools of the trim-tests method, see\n  .agents/knowledge/process/trimming-tests.md in the IGNIS repository. Produce the JUnit files with\n  bun test ./src --parallel --reporter=junit --reporter-outfile=<file>.\n\nmodule-cycles\n  <dir>, or --dist <dir>   the built folder (dist/esm); exits 1 when more cycles than --max, 2 on a usage error\n\nsplit-report\n  --dist <dir>   the built ESM folder inside a package: dist/esm, or dist where one build is published (default dist)\n  [folder...]    package folders to report; none scans every packages/* and examples/* that has a src/\n\ncatalog\n  --glob <pattern>      a manifest glob beside packages/*/package.json (repeatable)\n  --pinned <file>       a manifest outside the workspace: its catalogued ranges must equal the catalog's (repeatable)\n  --preset-prefix <p>   files under this prefix are presets: catalog: is allowed in their peerDependencies\n\n  --help            print this text and exit`;\n\n/** A usage error: nothing was probed. */\nconst USAGE_ERROR_CODE = 2;\n\ninterface IClaimsModule {\n  PURITY_CLAIMS?: IPurityClaim[];\n  PURITY_OPTIONS?: IPurityOptions;\n}\n\ninterface IPurityArguments {\n  claimsFile?: string;\n  filter?: string;\n  json: boolean;\n}\n\nconst parsePurityArguments = (args: string[]): IPurityArguments | string => {\n  const parsed: IPurityArguments = { json: false };\n\n  for (let index = 0; index < args.length; index += 1) {\n    const arg = args[index];\n\n    if (arg === '--json') {\n      parsed.json = true;\n      continue;\n    }\n\n    if (arg === '--claims') {\n      const value = args[index + 1];\n      if (value === undefined || value.startsWith('--')) {\n        return '--claims needs a file';\n      }\n\n      parsed.claimsFile = value;\n      index += 1;\n      continue;\n    }\n\n    if (arg.startsWith('--')) {\n      return `unknown option \"${arg}\"`;\n    }\n\n    if (parsed.filter !== undefined) {\n      return `unexpected argument \"${arg}\"`;\n    }\n\n    parsed.filter = arg;\n  }\n\n  return parsed;\n};\n\n/** Splits repeatable `--name value` options and positionals; `undefined` for an option that lacks its value. */\nconst parseRepeatable = (opts: {\n  args: string[];\n  repeatable: string[];\n  single: string[];\n}): { positionals: string[]; values: Record<string, string[]> } | string => {\n  const { args, repeatable, single } = opts;\n  const values: Record<string, string[]> = {};\n  const positionals: string[] = [];\n\n  for (let index = 0; index < args.length; index += 1) {\n    const arg = args[index];\n\n    if (arg.startsWith('--')) {\n      const name = arg.slice(2);\n      if (!repeatable.includes(name) && !single.includes(name)) {\n        return `unknown option \"${arg}\"`;\n      }\n\n      const value = args[index + 1];\n      if (value === undefined || value.startsWith('--')) {\n        return `${arg} needs a value`;\n      }\n\n      values[name] = [...(values[name] ?? []), value];\n      index += 1;\n      continue;\n    }\n\n    positionals.push(arg);\n  }\n\n  return { positionals, values };\n};\n\n/** `devz check <name>`: runs one of the shared repository gates in the current folder. */\nexport class CheckCommand {\n  private static runTestWeight(opts: { root: string; args: string[] }): number {\n    const parsed = parseRepeatable({ args: opts.args, repeatable: [], single: ['top'] });\n    if (typeof parsed === 'string' || parsed.positionals.length === 0) {\n      console.error(\n        `devz check test-weight: ${typeof parsed === 'string' ? parsed : 'give at least one JUnit file'}\\n${USAGE}`,\n      );\n      return USAGE_ERROR_CODE;\n    }\n\n    const reports = parsed.positionals.map((file) => {\n      const path = resolve(opts.root, file);\n      return {\n        label: basename(file).replace(/\\.xml$/, ''),\n        xml: existsSync(path) ? readFileSync(path, 'utf8') : '',\n      };\n    });\n    const missing = parsed.positionals.filter((file) => !existsSync(resolve(opts.root, file)));\n    if (missing.length > 0) {\n      console.error(`devz check test-weight: not found: ${missing.join(', ')}`);\n      return USAGE_ERROR_CODE;\n    }\n\n    const top = parsed.values.top?.[0] === undefined ? undefined : Number(parsed.values.top[0]);\n    for (const line of formatTestWeight({ report: analyseJunit({ reports }), top })) {\n      console.log(line);\n    }\n\n    return 0;\n  }\n\n  private static runTestDeadCode(opts: { root: string; args: string[] }): number {\n    if (opts.args.length > 0) {\n      console.error(`devz check test-dead-code: unexpected argument \"${opts.args[0]}\"\\n${USAGE}`);\n      return USAGE_ERROR_CODE;\n    }\n\n    const candidates = findDeadTestCode({ root: opts.root });\n    for (const kind of ['unreferenced', 'folder-referenced'] as const) {\n      const own = candidates.filter((candidate) => candidate.kind === kind);\n      console.log(`${kind}: ${own.length}`);\n      for (const candidate of own) {\n        console.log(`  ${candidate.file}`);\n      }\n    }\n    console.log(\n      '\\nThese are candidates: delete one, run the package suite, and keep it if anything fails or loads it by a built path.',\n    );\n\n    return 0;\n  }\n\n  private static runTestMutate(opts: { root: string; args: string[] }): number {\n    const [file, ...extra] = opts.args;\n    if (file === undefined || extra.length > 0) {\n      console.error(`devz check test-mutate: give one ledger file\\n${USAGE}`);\n      return USAGE_ERROR_CODE;\n    }\n\n    const path = resolve(opts.root, file);\n    if (!existsSync(path)) {\n      console.error(`devz check test-mutate: ledger not found: ${file}`);\n      return USAGE_ERROR_CODE;\n    }\n\n    const ledger: ILedger = JSON.parse(readFileSync(path, 'utf8'));\n    if (!Array.isArray(ledger.mutants)) {\n      console.error(`devz check test-mutate: ${file} has no \"mutants\" array`);\n      return USAGE_ERROR_CODE;\n    }\n\n    const results = replayLedger({ root: opts.root, ledger });\n    for (const line of formatLedgerResults(results)) {\n      console.log(line);\n    }\n\n    return results.every((result) => result.ok) ? 0 : 1;\n  }\n\n  private static async runTestControls(opts: { root: string; args: string[] }): Promise<number> {\n    const [file, ...extra] = opts.args;\n    if (file === undefined || extra.length > 0) {\n      console.error(`devz check test-controls: give one registry file\\n${USAGE}`);\n      return USAGE_ERROR_CODE;\n    }\n\n    const path = resolve(opts.root, file);\n    if (!existsSync(path)) {\n      console.error(`devz check test-controls: registry not found: ${file}`);\n      return USAGE_ERROR_CODE;\n    }\n\n    const registry: { controls?: IControlEntry[] } = JSON.parse(readFileSync(path, 'utf8'));\n    if (!Array.isArray(registry.controls)) {\n      console.error(`devz check test-controls: ${file} has no \"controls\" array`);\n      return USAGE_ERROR_CODE;\n    }\n\n    const report = await checkControls({ root: opts.root, controls: registry.controls });\n    if (report.problems.length === 0) {\n      console.log(`test-controls: OK - ${report.checked} registered controls found`);\n      return 0;\n    }\n\n    console.error(\n      `test-controls: ${report.problems.length} of ${report.checked} registered controls are gone:`,\n    );\n    for (const problem of report.problems) {\n      console.error(`  [${problem.entry.gate}] ${problem.message}`);\n    }\n\n    return 1;\n  }\n\n  private static runSplitReport(opts: { root: string; args: string[] }): number {\n    const parsed = parseRepeatable({ args: opts.args, repeatable: [], single: ['dist'] });\n    if (typeof parsed === 'string') {\n      console.error(`devz check split-report: ${parsed}\\n${USAGE}`);\n      return USAGE_ERROR_CODE;\n    }\n\n    const targets = parsed.positionals.length\n      ? parsed.positionals.map((target) => resolve(opts.root, target))\n      : SplitReport.defaultTargets({ root: opts.root });\n\n    for (const packageDir of targets) {\n      SplitReport.run({ packageDir, distDir: parsed.values.dist?.[0] });\n    }\n\n    return 0;\n  }\n\n  private static async runCatalog(opts: { root: string; args: string[] }): Promise<number> {\n    const parsed = parseRepeatable({\n      args: opts.args,\n      repeatable: ['glob', 'pinned'],\n      single: ['preset-prefix'],\n    });\n    if (typeof parsed === 'string' || parsed.positionals.length > 0) {\n      console.error(\n        `devz check catalog: ${typeof parsed === 'string' ? parsed : `unexpected argument \"${parsed.positionals[0]}\"`}\\n${USAGE}`,\n      );\n      return USAGE_ERROR_CODE;\n    }\n\n    const report = await findCatalogProblems({\n      root: opts.root,\n      globs: parsed.values.glob,\n      pinned: parsed.values.pinned,\n      presetPrefix: parsed.values['preset-prefix']?.[0],\n    });\n\n    if (report.noCatalog) {\n      console.error('check-catalog: no `workspaces.catalog` in the root package.json');\n      return 1;\n    }\n\n    if (report.problems.length === 0) {\n      console.log(`check-catalog: OK - ${report.entries} entries, ${report.referenced} referenced`);\n      return 0;\n    }\n\n    console.error(`check-catalog: ${report.problems.length} problem(s):`);\n    for (const problem of report.problems) {\n      console.error(`  ${problem.file}: ${problem.message}`);\n    }\n\n    return 1;\n  }\n\n  static async run(opts: { root: string; args?: string[] }): Promise<number> {\n    const { root, args = [] } = opts;\n    const [name, ...rest] = args;\n\n    if (name === undefined || name === '--help' || name === '-h') {\n      console.log(USAGE);\n      return name === undefined ? USAGE_ERROR_CODE : 0;\n    }\n\n    if (name === 'module-cycles') {\n      return runModuleCycles({\n        args: rest,\n        print: (line) => console.log(line),\n        printError: (line) => console.error(line),\n      });\n    }\n\n    if (name === 'split-report') {\n      return CheckCommand.runSplitReport({ root, args: rest });\n    }\n\n    if (name === 'catalog') {\n      return CheckCommand.runCatalog({ root, args: rest });\n    }\n\n    if (name === 'test-weight') {\n      return CheckCommand.runTestWeight({ root, args: rest });\n    }\n\n    if (name === 'test-dead-code') {\n      return CheckCommand.runTestDeadCode({ root, args: rest });\n    }\n\n    if (name === 'test-mutate') {\n      return CheckCommand.runTestMutate({ root, args: rest });\n    }\n\n    if (name === 'test-controls') {\n      return CheckCommand.runTestControls({ root, args: rest });\n    }\n\n    if (name !== 'purity') {\n      console.error(`devz check: unknown check \"${name}\"\\n${USAGE}`);\n      return USAGE_ERROR_CODE;\n    }\n\n    if (rest.includes('--help') || rest.includes('-h')) {\n      console.log(USAGE);\n      return 0;\n    }\n\n    const parsed = parsePurityArguments(rest);\n    if (typeof parsed === 'string') {\n      console.error(`devz check purity: ${parsed}\\n${USAGE}`);\n      return USAGE_ERROR_CODE;\n    }\n\n    if (parsed.claimsFile === undefined) {\n      console.error(`devz check purity: --claims <file> is required\\n${USAGE}`);\n      return USAGE_ERROR_CODE;\n    }\n\n    const claimsPath = isAbsolute(parsed.claimsFile)\n      ? parsed.claimsFile\n      : resolve(root, parsed.claimsFile);\n    if (!existsSync(claimsPath)) {\n      console.error(`devz check purity: claims file not found: ${parsed.claimsFile}`);\n      return USAGE_ERROR_CODE;\n    }\n\n    const claimsModule: IClaimsModule = await import(claimsPath);\n    if (!Array.isArray(claimsModule.PURITY_CLAIMS)) {\n      console.error(`devz check purity: ${parsed.claimsFile} does not export PURITY_CLAIMS`);\n      return USAGE_ERROR_CODE;\n    }\n\n    const lines: string[] = [];\n    const report = await checkPurity({\n      root,\n      claims: claimsModule.PURITY_CLAIMS,\n      options: claimsModule.PURITY_OPTIONS,\n      filter: parsed.filter,\n      claimsFile: relative(root, claimsPath),\n      print: (line) => (parsed.json ? lines.push(line) : console.log(line)),\n      printError: (line) => console.error(line),\n    });\n\n    if (report === undefined) {\n      return 1;\n    }\n\n    if (parsed.json) {\n      console.log(JSON.stringify(report, null, 2));\n    }\n\n    return report.failed > 0 ? 1 : 0;\n  }\n}\n"]}

package/dist/cli/codemod/const-classes.d.ts

@@ -0,0 +1,80 @@
+import type ts from 'typescript';
+type TTypeScript = typeof ts;
+/** What the user may change for one declaration, from the mapping file. */
+export interface IConstClassOverride {
+    /** The class name. */
+    class?: string;
+    /** The type name; only a property of an interface or object type gets a new one. */
+    type?: string;
+    /** A member key per literal value: `{ "read-only": "READ_ONLY" }`. */
+    members?: Record<string, string>;
+    /** Leave this declaration alone. */
+    skip?: boolean;
+}
+export type TConstClassMap = Record<string, IConstClassOverride>;
+export interface IConstClassProposal {
+    /** The key of the mapping file: `path/to/file.ts#TName` or `path/to/file.ts#IContainer.property`. */
+    id: string;
+    line: number;
+    className: string;
+    typeName: string;
+    /** The literal values and the member key each one gets, in order. */
+    members: Array<{
+        value: string;
+        key: string;
+    }>;
+    /** What the union also held: `null` or `undefined`. */
+    nullish: string[];
+}
+export interface IConstClassUntouched {
+    line: number;
+    column: number;
+    reason: string;
+}
+export interface IConstClassResult {
+    output: string;
+    changed: boolean;
+    proposals: IConstClassProposal[];
+    untouched: IConstClassUntouched[];
+}
+/**
+ * Turns the string-literal unions of exported declarations into const classes: an exported type
+ * alias, and a property of an exported interface or object type. The values stay the same, so every
+ * existing literal still type-checks and no call site changes. A union it cannot name is reported.
+ */
+export declare class ConstClasses {
+    static convert(opts: {
+        typescript: TTypeScript;
+        fileName: string;
+        source: string;
+        /** The id prefix of the mapping file: the path of the file relative to the project root. */
+        relativePath?: string;
+        overrides?: TConstClassMap;
+        importFrom?: string;
+    }): IConstClassResult;
+    private static planMembers;
+    /** Every top-level name the file declares or imports. */
+    private static declaredNames;
+    private static isExported;
+    /** The string values of a union, and its `null` or `undefined` members; the union must be string literals (and nullish) only. */
+    private static readUnion;
+    /** At least two string literals, and nothing else but `null` or `undefined`. */
+    private static isEnumerable;
+    private static checkPlan;
+    private static renderClass;
+    /** Reports every string-literal union of an exported declaration the codemod did not handle: it cannot name those. */
+    private static findStrays;
+    private static isKeySet;
+    /** The edit that makes `TConstValue` available: nothing when the file has it, a specifier on an import from the same module, else a new import line. */
+    private static planImport;
+}
+/** `devz codemod const-classes [paths...] [--write | --check]`. */
+export declare class ConstClassesCommand {
+    static readonly USAGE = "Usage: devz codemod const-classes [paths...] [--write | --check] [--map <file>] [--emit-map <file>] [--import-from <module>] [--include-tests]\n\nTurns a string-literal union in an exported declaration into a const class (SCHEME_SET, isValid) plus\n`TConstValue<typeof X>`, the shape the venizia/const-class-values lint rule asks for. It handles an\nexported type alias and a property of an exported interface or object type. The values stay the same,\nso every existing literal still type-checks and no call site changes.\n\nIt has to choose names: the class is the type name without its leading T, in the plural; a member is\nthe value in upper snake case. The dry run prints every proposal.\n\n  --write              write the changed files (without it, nothing is written)\n  --check              dry run that exits 1 while a union can be converted or is left untouched (for CI)\n  --map <file>         a JSON file of overrides, keyed by the id the dry run prints\n  --emit-map <file>    write the proposals as a mapping file to edit, then pass it with --map\n  --import-from <m>    where TConstValue is imported from (default @venizia/ignis-helpers/common)\n  --include-tests      also convert test files (skipped by default)\n  --help               print this text and exit\n\nA mapping entry: { \"src/a.ts#TMode\": { \"class\": \"Modes\", \"members\": { \"read-only\": \"READ_ONLY\" } } },\nor { \"skip\": true }. A union in a parameter, a return type, a generic or a nested type is reported as\nleft untouched: it has no name, so write that class by hand. Key sets (Pick, Omit, Extract, Exclude,\nRecord, mapped types) are not enumerable values and are never touched.";
+    static run(opts: {
+        root: string;
+        args: string[];
+    }): Promise<number>;
+}
+export {};
+//# sourceMappingURL=const-classes.d.ts.map

package/dist/cli/codemod/const-classes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"const-classes.d.ts","sourceRoot":"","sources":["../../../src/cli/codemod/const-classes.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,YAAY,CAAC;AAGjC,KAAK,WAAW,GAAG,OAAO,EAAE,CAAC;AAU7B,2EAA2E;AAC3E,MAAM,WAAW,mBAAmB;IAClC,sBAAsB;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oFAAoF;IACpF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,oCAAoC;IACpC,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;AAEjE,MAAM,WAAW,mBAAmB;IAClC,qGAAqG;IACrG,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,OAAO,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,uDAAuD;IACvD,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,mBAAmB,EAAE,CAAC;IACjC,SAAS,EAAE,oBAAoB,EAAE,CAAC;CACnC;AA4CD;;;;GAIG;AACH,qBAAa,YAAY;IACvB,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE;QACnB,UAAU,EAAE,WAAW,CAAC;QACxB,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,4FAA4F;QAC5F,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,SAAS,CAAC,EAAE,cAAc,CAAC;QAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,GAAG,iBAAiB;IA4KrB,OAAO,CAAC,MAAM,CAAC,WAAW;IA8C1B,yDAAyD;IACzD,OAAO,CAAC,MAAM,CAAC,aAAa;IAoD5B,OAAO,CAAC,MAAM,CAAC,UAAU;IAQzB,iIAAiI;IACjI,OAAO,CAAC,MAAM,CAAC,SAAS;IA+BxB,gFAAgF;IAChF,OAAO,CAAC,MAAM,CAAC,YAAY;IAuB3B,OAAO,CAAC,MAAM,CAAC,SAAS;IAqCxB,OAAO,CAAC,MAAM,CAAC,WAAW;IAuB1B,sHAAsH;IACtH,OAAO,CAAC,MAAM,CAAC,UAAU;IAkCzB,OAAO,CAAC,MAAM,CAAC,QAAQ;IA2BvB,wJAAwJ;IACxJ,OAAO,CAAC,MAAM,CAAC,UAAU;CAqD1B;AAyDD,mEAAmE;AACnE,qBAAa,mBAAmB;IAC9B,MAAM,CAAC,QAAQ,CAAC,KAAK,ipDAAS;WAEjB,GAAG,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC;CA2K1E"}