@amritk/mjst 0.12.2 → 0.13.0

package/dist/cli.js

@@ -1,395 +1,322 @@
 #!/usr/bin/env node
-import { execFile } from 'node:child_process';
-import { mkdir, readdir, unlink, writeFile } from 'node:fs/promises';
-import { basename, dirname, join, relative, resolve, sep } from 'node:path';
-import { promisify } from 'node:util';
-import { buildSchema } from '@amritk/generate-parsers';
-import { buildValidatorSchema } from '@amritk/generate-validators';
-import { deriveRootTypeName } from '@amritk/helpers/derive-root-type-name';
+import { execFile } from "node:child_process";
+import { mkdir, readdir, unlink, writeFile } from "node:fs/promises";
+import { basename, dirname, join, relative, resolve, sep } from "node:path";
+import { promisify } from "node:util";
+import { buildSchema } from "@amritk/generate-parsers";
+import { buildValidatorSchema } from "@amritk/generate-validators";
+import { deriveRootTypeName } from "@amritk/helpers/derive-root-type-name";
 const execFileAsync = promisify(execFile);
-import { combineGeneratedFiles } from './combine-files.js';
-import { detectHelpersMode } from './detect-helpers-mode.js';
-import { emitExamples } from './emit-examples.js';
-import { HELP_TEXT } from './help-text.js';
-import { loadConfig } from './load-config.js';
-import { loadSchema } from './load-schema.js';
-import { parseCliArgs } from './parse-cli-args.js';
-import { readVersion } from './read-version.js';
-import { resolveImportExt } from './resolve-import-ext.js';
-/** True when the args request the CLI version (`version`, `--version`, or `-v`). */
-const isVersionRequest = (args) => args[0] === 'version' || args.includes('--version') || args.includes('-v');
-/** True when the args request usage help (`help`, `--help`, or `-h`). */
-const isHelpRequest = (args) => args[0] === 'help' || args.includes('--help') || args.includes('-h');
-/** The schema's base filename without extension, used to derive the root type name. */
-const schemaBaseName = (schemaPath) => basename(schemaPath).replace(/\.[^.]+$/, '');
-/**
- * Resolves and reports the helpers mode. An explicit `--helpers` wins; otherwise
- * it is auto-detected from the nearest package.json. When detection falls back to
- * embedded, nudge the user toward declaring `@amritk/helpers` so multiple
- * generated trees can share a single runtime helper copy.
- */
+import { combineGeneratedFiles } from "./combine-files.js";
+import { detectHelpersMode } from "./detect-helpers-mode.js";
+import { emitExamples } from "./emit-examples.js";
+import { HELP_TEXT } from "./help-text.js";
+import { loadConfig } from "./load-config.js";
+import { loadSchema } from "./load-schema.js";
+import { parseCliArgs } from "./parse-cli-args.js";
+import { readVersion } from "./read-version.js";
+import { resolveImportExt } from "./resolve-import-ext.js";
+const isVersionRequest = (args) => args[0] === "version" || args.includes("--version") || args.includes("-v");
+const isHelpRequest = (args) => args[0] === "help" || args.includes("--help") || args.includes("-h");
+const schemaBaseName = (schemaPath) => basename(schemaPath).replace(/\.[^.]+$/, "");
 const resolveHelpersMode = (config, outputDir) => {
-    const helpersMode = config.helpers ?? detectHelpersMode(outputDir);
-    console.log(`Helpers mode: ${helpersMode}${config.helpers ? ' (explicit)' : ' (auto-detected)'}`);
-    if (!config.helpers && helpersMode === 'embedded') {
-        console.log('Tip: add @amritk/helpers as a dependency to share one runtime helper copy across generated trees ' +
-            '(or pass --helpers embedded to silence this).');
-    }
-    return helpersMode;
+  const helpersMode = config.helpers ?? detectHelpersMode(outputDir);
+  console.log(`Helpers mode: ${helpersMode}${config.helpers ? " (explicit)" : " (auto-detected)"}`);
+  if (!config.helpers && helpersMode === "embedded") {
+    console.log("Tip: add @amritk/helpers as a dependency to share one runtime helper copy across generated trees (or pass --helpers embedded to silence this).");
+  }
+  return helpersMode;
 };
-/**
- * Extracts the --config flag value from process args before full parsing.
- * We need this early so we can load the config file first, then overlay CLI flags.
- */
 const extractConfigPath = (args) => {
-    for (let i = 0; i < args.length; i++) {
-        const arg = args[i];
-        if (arg === '--config' && args[i + 1] && !args[i + 1]?.startsWith('--')) {
-            return args[i + 1];
-        }
-        if (arg?.startsWith('--config=')) {
-            return arg.slice('--config='.length);
-        }
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    if (arg === "--config" && args[i + 1] && !args[i + 1]?.startsWith("--")) {
+      return args[i + 1];
+    }
+    if (arg?.startsWith("--config=")) {
+      return arg.slice("--config=".length);
     }
-    return undefined;
+  }
+  return void 0;
 };
-const DEFAULT_BANNER_TEXT = 'This file was auto-generated by @amritk/mjst.\n * Do not edit it manually — your changes will be overwritten on the next generation.';
+const DEFAULT_BANNER_TEXT = "This file was auto-generated by @amritk/mjst.\n * Do not edit it manually \u2014 your changes will be overwritten on the next generation.";
 const resolveBanner = (banner) => {
-    if (!banner)
-        return '';
-    const text = banner === true ? DEFAULT_BANNER_TEXT : banner;
-    return `/**\n * ${text}\n */\n\n`;
+  if (!banner)
+    return "";
+  const text = banner === true ? DEFAULT_BANNER_TEXT : banner;
+  return `/**
+ * ${text}
+ */
+
+`;
 };
-/** Writes a generated file, creating any parent directories the filename implies. */
 const writeGeneratedFile = async (baseDir, filename, content) => {
-    const filePath = join(baseDir, filename);
-    await mkdir(dirname(filePath), { recursive: true });
-    await writeFile(filePath, content, 'utf-8');
+  const filePath = join(baseDir, filename);
+  await mkdir(dirname(filePath), { recursive: true });
+  await writeFile(filePath, content, "utf-8");
 };
-/**
- * Emits fast-check arbitrary + example files for one schema (delegating to
- * {@link emitExamples}) and logs each written path. The files land in an
- * `examples/` subdirectory of `outputDir` so they never collide with the parser
- * files, which share the same `<name>.ts` / `index.ts` names. `subDir` mirrors a
- * schema's nested location under `--schema-dir`. The example sources are left out
- * of `--build`: they import the `fast-check` peer dependency and are meant to be
- * consumed by tests, not compiled alongside the runtime parsers.
- */
-const runExamples = async (config, schema, rootTypeName, outputDir, subDir = '') => {
-    const written = await emitExamples({
-        schema: schema,
-        rootTypeName,
-        outputDir,
-        subDir,
-        bannerPrefix: config.banner ? resolveBanner(config.banner) : '',
-        // Spread conditionally: `exactOptionalPropertyTypes` rejects an explicit
-        // `undefined` for the optional `typeSuffix`.
-        ...(config.typeSuffix !== undefined ? { typeSuffix: config.typeSuffix } : {}),
-    });
-    for (const path of written) {
-        console.log(`Generated example: ${path}`);
-    }
+const runExamples = async (config, schema, rootTypeName, outputDir, subDir = "") => {
+  const written = await emitExamples({
+    schema,
+    rootTypeName,
+    outputDir,
+    subDir,
+    bannerPrefix: config.banner ? resolveBanner(config.banner) : "",
+    // Spread conditionally: `exactOptionalPropertyTypes` rejects an explicit
+    // `undefined` for the optional `typeSuffix`.
+    ...config.typeSuffix !== void 0 ? { typeSuffix: config.typeSuffix } : {}
+  });
+  for (const path of written) {
+    console.log(`Generated example: ${path}`);
+  }
 };
-/**
- * Compiles the generated `.ts` files to `.js`/`.d.ts` with a temporary tsconfig,
- * then removes the intermediate sources. `tsFiles` are paths relative to `outputDir`.
- */
 const buildOutput = async (outputDir, tsFiles, typesOnly) => {
-    // Write a minimal tsconfig so tsc can compile the generated files without
-    // inheriting settings like allowImportingTsExtensions that block emission.
-    // In 'package' mode tsc finds @amritk/helpers via the consumer's node_modules.
-    // In 'embedded' mode the helpers live under ./_helpers and need no resolution.
-    const tsconfigContent = JSON.stringify({
-        compilerOptions: {
-            target: 'ESNext',
-            module: 'ESNext',
-            moduleResolution: 'bundler',
-            declaration: true,
-            emitDeclarationOnly: typesOnly,
-            skipLibCheck: true,
-        },
-        include: tsFiles.map((file) => `./${file}`),
-    }, null, 2);
-    const tsconfigPath = join(outputDir, '.tsconfig-mjst-build.json');
-    await writeFile(tsconfigPath, tsconfigContent, 'utf-8');
-    try {
-        await execFileAsync('npx', ['tsc', '--project', tsconfigPath]);
-    }
-    catch (error) {
-        const details = error;
-        // A spawn failure (ENOENT) means the *tool* is missing, not that the code is
-        // wrong — pointing the user at "the generated files" would send them hunting
-        // for a compile error that doesn't exist. Report the missing executable.
-        if (details.code === 'ENOENT') {
-            throw new Error('Could not run `npx tsc` to compile the generated files: `npx` (or `tsc`) was not found. ' +
-                'Install TypeScript (e.g. `npm install -D typescript`) or drop --build to skip compilation.');
-        }
-        // Otherwise tsc ran and reported real errors on stdout; surface them so the
-        // user sees *what* failed instead of a bare "compilation failed".
-        const output = [details.stdout, details.stderr].filter(Boolean).join('\n').trim();
-        throw new Error(`TypeScript compilation failed. Check the generated files for errors.${output ? `\n\n${output}` : ''}`);
-    }
-    finally {
-        await unlink(tsconfigPath);
-    }
-    // Remove the intermediate .ts files now that .js and .d.ts have been produced
-    for (const file of tsFiles) {
-        await unlink(join(outputDir, file));
-        console.log(`Built: ${file.replace(/\.ts$/, '.js')}`);
-        console.log(`Built: ${file.replace(/\.ts$/, '.d.ts')}`);
-    }
-    console.log(`\nTotal files built: ${tsFiles.length * 2}`);
+  const tsconfigContent = JSON.stringify({
+    compilerOptions: {
+      target: "ESNext",
+      module: "ESNext",
+      moduleResolution: "bundler",
+      declaration: true,
+      emitDeclarationOnly: typesOnly,
+      skipLibCheck: true
+    },
+    include: tsFiles.map((file) => `./${file}`)
+  }, null, 2);
+  const tsconfigPath = join(outputDir, ".tsconfig-mjst-build.json");
+  await writeFile(tsconfigPath, tsconfigContent, "utf-8");
+  try {
+    await execFileAsync("npx", ["tsc", "--project", tsconfigPath]);
+  } catch (error) {
+    const details = error;
+    if (details.code === "ENOENT") {
+      throw new Error("Could not run `npx tsc` to compile the generated files: `npx` (or `tsc`) was not found. Install TypeScript (e.g. `npm install -D typescript`) or drop --build to skip compilation.");
+    }
+    const output = [details.stdout, details.stderr].filter(Boolean).join("\n").trim();
+    throw new Error(`TypeScript compilation failed. Check the generated files for errors.${output ? `
+
+${output}` : ""}`);
+  } finally {
+    await unlink(tsconfigPath);
+  }
+  for (const file of tsFiles) {
+    await unlink(join(outputDir, file));
+    console.log(`Built: ${file.replace(/\.ts$/, ".js")}`);
+    console.log(`Built: ${file.replace(/\.ts$/, ".d.ts")}`);
+  }
+  console.log(`
+Total files built: ${tsFiles.length * 2}`);
 };
-/** Recursively collects every `*.json` file under `dir`, returning absolute paths. */
 const findJsonSchemas = async (dir) => {
-    const entries = await readdir(dir, { withFileTypes: true });
-    const results = [];
-    for (const entry of entries) {
-        const full = join(dir, entry.name);
-        if (entry.isDirectory()) {
-            // `node_modules` holds dependency schemas that aren't the user's, and
-            // dot-directories (`.git`, `.cache`, ...) hold tooling state — descending
-            // into either pulls in `.json` files the user never meant to generate from.
-            if (entry.name === 'node_modules' || entry.name.startsWith('.'))
-                continue;
-            results.push(...(await findJsonSchemas(full)));
-        }
-        else if (entry.isFile() && entry.name.endsWith('.json')) {
-            results.push(full);
-        }
-    }
-    return results;
+  const entries = await readdir(dir, { withFileTypes: true });
+  const results = [];
+  for (const entry of entries) {
+    const full = join(dir, entry.name);
+    if (entry.isDirectory()) {
+      if (entry.name === "node_modules" || entry.name.startsWith("."))
+        continue;
+      results.push(...await findJsonSchemas(full));
+    } else if (entry.isFile() && entry.name.endsWith(".json")) {
+      results.push(full);
+    }
+  }
+  return results;
 };
-/**
- * Emits validator files (`validateX` / `isX`) for one schema into `validatorsSubDir`
- * (a path relative to `outputDir`). The validators carry the same schema-derived
- * filenames as the parsers, so they live in their own subdirectory to avoid
- * colliding. Returns the written `.ts` paths relative to `outputDir` so the caller
- * can fold them into a `--build` compilation.
- */
 const runValidators = async (config, schema, rootTypeName, outputDir, validatorsSubDir) => {
-    const files = await buildValidatorSchema(schema, rootTypeName, config.typeSuffix);
-    const written = [];
-    for (const file of files) {
-        const content = config.banner ? resolveBanner(config.banner) + file.content : file.content;
-        const relFilename = join(validatorsSubDir, file.filename);
-        await writeGeneratedFile(outputDir, relFilename, content);
-        written.push(relFilename);
-        console.log(`Generated: ${relFilename}`);
-    }
-    return written;
+  const files = await buildValidatorSchema(schema, rootTypeName, config.typeSuffix);
+  const written = [];
+  for (const file of files) {
+    const content = config.banner ? resolveBanner(config.banner) + file.content : file.content;
+    const relFilename = join(validatorsSubDir, file.filename);
+    await writeGeneratedFile(outputDir, relFilename, content);
+    written.push(relFilename);
+    console.log(`Generated: ${relFilename}`);
+  }
+  return written;
 };
-/** Generates parsers for a single schema (the original one-schema-in, one-outDir-out flow). */
 const runSingle = async (config, schemaPath, outputDir) => {
-    const schema = await loadSchema(config, schemaPath);
-    await mkdir(outputDir, { recursive: true });
-    const helpersMode = resolveHelpersMode(config, outputDir);
-    const rootTypeName = config.rootType ?? deriveRootTypeName(schema, schemaBaseName(schemaPath));
-    console.log(`Root type: ${rootTypeName}`);
-    const files = await buildSchema(schema, rootTypeName, undefined, config.typesOnly, config.logWarnings, config.strict, helpersMode, undefined, config.readonly, config.stripUnknown, config.typeSuffix, resolveImportExt(config), config.caseInsensitive);
-    for (const file of files) {
-        const isHelper = file.filename.startsWith('_helpers/');
-        const content = config.banner && !isHelper ? resolveBanner(config.banner) + file.content : file.content;
-        await writeGeneratedFile(outputDir, file.filename, content);
-        console.log(`Generated: ${file.filename}`);
-    }
-    const validatorFiles = config.validators
-        ? await runValidators(config, schema, rootTypeName, outputDir, 'validators')
-        : [];
-    if (config.examples) {
-        await runExamples(config, schema, rootTypeName, outputDir);
-    }
-    if (config.build) {
-        await buildOutput(outputDir, [...files.map((f) => f.filename), ...validatorFiles], config.typesOnly);
-    }
-    else {
-        console.log(`\nTotal files generated: ${files.length + validatorFiles.length}`);
-    }
+  const schema = await loadSchema(config, schemaPath);
+  await mkdir(outputDir, { recursive: true });
+  const helpersMode = resolveHelpersMode(config, outputDir);
+  const rootTypeName = config.rootType ?? deriveRootTypeName(schema, schemaBaseName(schemaPath));
+  console.log(`Root type: ${rootTypeName}`);
+  const files = await buildSchema(schema, rootTypeName, void 0, config.typesOnly, config.logWarnings, config.strict, helpersMode, void 0, config.readonly, config.stripUnknown, config.typeSuffix, resolveImportExt(config), config.caseInsensitive);
+  for (const file of files) {
+    const isHelper = file.filename.startsWith("_helpers/");
+    const content = config.banner && !isHelper ? resolveBanner(config.banner) + file.content : file.content;
+    await writeGeneratedFile(outputDir, file.filename, content);
+    console.log(`Generated: ${file.filename}`);
+  }
+  const validatorFiles = config.validators ? await runValidators(config, schema, rootTypeName, outputDir, "validators") : [];
+  if (config.examples) {
+    await runExamples(config, schema, rootTypeName, outputDir);
+  }
+  if (config.build) {
+    await buildOutput(outputDir, [...files.map((f) => f.filename), ...validatorFiles], config.typesOnly);
+  } else {
+    console.log(`
+Total files generated: ${files.length + validatorFiles.length}`);
+  }
 };
-/**
- * Generates a single self-contained file from one schema, concatenating every
- * generated definition (and dropping the cross-file imports that are no longer
- * needed) into `outFilePath`. Currently used for types-only output.
- */
 const runSingleFile = async (config, schemaPath, outFilePath) => {
-    const schema = await loadSchema(config, schemaPath);
-    const outputDir = dirname(outFilePath);
-    await mkdir(outputDir, { recursive: true });
-    const rootTypeName = config.rootType ?? deriveRootTypeName(schema, schemaBaseName(schemaPath));
-    console.log(`Root type: ${rootTypeName}`);
-    const files = await buildSchema(schema, rootTypeName, undefined, config.typesOnly, config.logWarnings, config.strict, config.helpers ?? 'package', undefined, config.readonly, config.stripUnknown, config.typeSuffix, resolveImportExt(config), config.caseInsensitive);
-    const combined = combineGeneratedFiles(files);
-    await writeFile(outFilePath, config.banner ? resolveBanner(config.banner) + combined : combined, 'utf-8');
-    console.log(`Generated: ${relative(process.cwd(), outFilePath)}`);
-    if (config.examples) {
-        await runExamples(config, schema, rootTypeName, outputDir);
-    }
-    if (config.build) {
-        await buildOutput(outputDir, [basename(outFilePath)], config.typesOnly);
-    }
-    else {
-        console.log(`\nTotal files generated: 1`);
-    }
+  const schema = await loadSchema(config, schemaPath);
+  const outputDir = dirname(outFilePath);
+  await mkdir(outputDir, { recursive: true });
+  const rootTypeName = config.rootType ?? deriveRootTypeName(schema, schemaBaseName(schemaPath));
+  console.log(`Root type: ${rootTypeName}`);
+  const files = await buildSchema(schema, rootTypeName, void 0, config.typesOnly, config.logWarnings, config.strict, config.helpers ?? "package", void 0, config.readonly, config.stripUnknown, config.typeSuffix, resolveImportExt(config), config.caseInsensitive);
+  const combined = combineGeneratedFiles(files);
+  await writeFile(outFilePath, config.banner ? resolveBanner(config.banner) + combined : combined, "utf-8");
+  console.log(`Generated: ${relative(process.cwd(), outFilePath)}`);
+  if (config.examples) {
+    await runExamples(config, schema, rootTypeName, outputDir);
+  }
+  if (config.build) {
+    await buildOutput(outputDir, [basename(outFilePath)], config.typesOnly);
+  } else {
+    console.log(`
+Total files generated: 1`);
+  }
 };
-/**
- * Generates parsers for every JSON Schema under `schemaDir`, mirroring the directory
- * layout into `outDir`. Each schema's output lands in its own subdirectory (so files
- * from different schemas never collide) and the runtime helpers are emitted once into a
- * shared `outDir/_helpers/` that every nested parser imports from.
- */
 const runRecursive = async (config, schemaDir, outputDir) => {
-    if (config.input && config.input !== 'json') {
-        console.error("Error: --schemaDir only supports JSON Schema files; remove --input or set it to 'json'.");
-        process.exit(1);
-    }
-    const schemaFiles = await findJsonSchemas(schemaDir);
-    if (schemaFiles.length === 0) {
-        console.error(`Error: no .json schema files found under ${schemaDir}.`);
-        process.exit(1);
-    }
-    await mkdir(outputDir, { recursive: true });
-    const helpersMode = resolveHelpersMode(config, outputDir);
-    // Helper sources are identical across schemas, so collect them by filename and
-    // write the deduplicated set once at the output root.
-    const sharedHelpers = new Map();
-    const writtenTsFiles = [];
-    for (const schemaFile of schemaFiles) {
-        const relPath = relative(schemaDir, schemaFile);
-        const relNoExt = relPath.slice(0, -'.json'.length);
-        const schemaSubDir = join(outputDir, relNoExt);
-        // Depth of the schema's output subdirectory, used to build the relative import
-        // path back to the shared `_helpers/` at the output root (../, ../../, ...).
-        const depth = relNoExt.split(sep).filter(Boolean).length;
-        const helpersImportPrefix = '../'.repeat(depth);
-        const schema = await loadSchema(config, schemaFile);
-        const rootTypeName = deriveRootTypeName(schema, schemaBaseName(schemaFile));
-        console.log(`\n${relPath} → ${relNoExt}/ (root type: ${rootTypeName})`);
-        const files = await buildSchema(schema, rootTypeName, undefined, config.typesOnly, config.logWarnings, config.strict, helpersMode, helpersImportPrefix, config.readonly, config.stripUnknown, config.typeSuffix, resolveImportExt(config), config.caseInsensitive);
-        for (const file of files) {
-            if (file.filename.startsWith('_helpers/')) {
-                sharedHelpers.set(file.filename, file.content);
-                continue;
-            }
-            const content = config.banner ? resolveBanner(config.banner) + file.content : file.content;
-            await writeGeneratedFile(schemaSubDir, file.filename, content);
-            const relativeFilename = join(relNoExt, file.filename);
-            writtenTsFiles.push(relativeFilename);
-            console.log(`Generated: ${relativeFilename}`);
-        }
-        if (config.validators) {
-            // Mirror the parser layout under a top-level `validators/` tree so each
-            // schema's validators sit beside their parser counterparts without sharing
-            // a filename.
-            const validatorFiles = await runValidators(config, schema, rootTypeName, outputDir, join('validators', relNoExt));
-            writtenTsFiles.push(...validatorFiles);
-        }
-        if (config.examples) {
-            await runExamples(config, schema, rootTypeName, outputDir, relNoExt);
-        }
-    }
-    for (const [filename, content] of sharedHelpers) {
-        await writeGeneratedFile(outputDir, filename, content);
-        writtenTsFiles.push(filename);
-        console.log(`Generated: ${filename}`);
-    }
-    if (config.build) {
-        await buildOutput(outputDir, writtenTsFiles, config.typesOnly);
-    }
-    else {
-        console.log(`\nTotal files generated: ${writtenTsFiles.length}`);
+  if (config.input && config.input !== "json") {
+    console.error("Error: --schemaDir only supports JSON Schema files; remove --input or set it to 'json'.");
+    process.exit(1);
+  }
+  const schemaFiles = await findJsonSchemas(schemaDir);
+  if (schemaFiles.length === 0) {
+    console.error(`Error: no .json schema files found under ${schemaDir}.`);
+    process.exit(1);
+  }
+  await mkdir(outputDir, { recursive: true });
+  const helpersMode = resolveHelpersMode(config, outputDir);
+  const sharedHelpers = /* @__PURE__ */ new Map();
+  const writtenTsFiles = [];
+  for (const schemaFile of schemaFiles) {
+    const relPath = relative(schemaDir, schemaFile);
+    const relNoExt = relPath.slice(0, -".json".length);
+    const schemaSubDir = join(outputDir, relNoExt);
+    const depth = relNoExt.split(sep).filter(Boolean).length;
+    const helpersImportPrefix = "../".repeat(depth);
+    const schema = await loadSchema(config, schemaFile);
+    const rootTypeName = deriveRootTypeName(schema, schemaBaseName(schemaFile));
+    console.log(`
+${relPath} \u2192 ${relNoExt}/ (root type: ${rootTypeName})`);
+    const files = await buildSchema(schema, rootTypeName, void 0, config.typesOnly, config.logWarnings, config.strict, helpersMode, helpersImportPrefix, config.readonly, config.stripUnknown, config.typeSuffix, resolveImportExt(config), config.caseInsensitive);
+    for (const file of files) {
+      if (file.filename.startsWith("_helpers/")) {
+        sharedHelpers.set(file.filename, file.content);
+        continue;
+      }
+      const content = config.banner ? resolveBanner(config.banner) + file.content : file.content;
+      await writeGeneratedFile(schemaSubDir, file.filename, content);
+      const relativeFilename = join(relNoExt, file.filename);
+      writtenTsFiles.push(relativeFilename);
+      console.log(`Generated: ${relativeFilename}`);
+    }
+    if (config.validators) {
+      const validatorFiles = await runValidators(config, schema, rootTypeName, outputDir, join("validators", relNoExt));
+      writtenTsFiles.push(...validatorFiles);
     }
+    if (config.examples) {
+      await runExamples(config, schema, rootTypeName, outputDir, relNoExt);
+    }
+  }
+  for (const [filename, content] of sharedHelpers) {
+    await writeGeneratedFile(outputDir, filename, content);
+    writtenTsFiles.push(filename);
+    console.log(`Generated: ${filename}`);
+  }
+  if (config.build) {
+    await buildOutput(outputDir, writtenTsFiles, config.typesOnly);
+  } else {
+    console.log(`
+Total files generated: ${writtenTsFiles.length}`);
+  }
 };
 const run = async () => {
-    // Skip the first two args (node executable and script path)
-    const args = process.argv.slice(2);
-    // `mjst lint <files>` delegates to the linter, which owns its own flag parsing
-    // and `--help` (yargs) — so this must run before the shared version/help checks,
-    // otherwise `mjst lint --help` would print the codegen help instead.
-    if (args[0] === 'lint') {
-        const { run: lintRun } = await import('./lint/run.js');
-        const result = await lintRun(args.slice(1));
-        if (result.stdout)
-            process.stdout.write(result.stdout);
-        if (result.stderr)
-            process.stderr.write(result.stderr);
-        process.exit(result.code);
-    }
-    if (isVersionRequest(args)) {
-        console.log(await readVersion());
-        return;
-    }
-    // Bare `mjst` and `mjst --help` both print usage rather than erroring on a
-    // missing --out-dir — a first-run user needs to see the flags, not a failure.
-    if (args.length === 0 || isHelpRequest(args)) {
-        console.log(HELP_TEXT);
-        return;
-    }
-    const configPath = extractConfigPath(args);
-    // Start with config file values if provided, then overlay CLI flags on top
-    const fileConfig = configPath ? await loadConfig(configPath) : {};
-    const cliConfig = parseCliArgs(args);
-    const config = { ...fileConfig, ...cliConfig };
-    if (config.outDir && config.outFile) {
-        console.error('Error: provide only one of --out-dir or --out-file, not both.');
-        process.exit(1);
-    }
-    // --root-type names a single root; under --schema-dir each schema derives its
-    // own root name, so a single override would be ambiguous.
-    if (config.rootType && config.schemaDir) {
-        console.error('Error: --root-type cannot be combined with --schema-dir; each schema derives its own root type.');
-        process.exit(1);
-    }
-    // tsc cannot emit from `.ts` import specifiers (allowImportingTsExtensions
-    // requires noEmit), so compiled output and stripping-ready sources are
-    // mutually exclusive.
-    if (config.build && config.importExt === 'ts') {
-        console.error('Error: --import-ext ts cannot be combined with --build. Drop --build to keep runnable .ts sources.');
-        process.exit(1);
-    }
-    // Validators are runtime code (validateX / isX), so they have nothing to emit
-    // in the type-only flows.
-    if (config.validators && config.typesOnly) {
-        console.error('Error: --validators cannot be combined with --types-only, which emits no runtime code.');
-        process.exit(1);
-    }
-    if (config.validators && config.outFile) {
-        console.error('Error: --validators cannot be combined with --out-file. Use --out-dir to emit validator files.');
-        process.exit(1);
-    }
-    // Single-file output is the alternative to a directory of files.
-    if (config.outFile) {
-        if (!config.typesOnly) {
-            console.error('Error: --out-file currently supports only --types-only output. Add --types-only or use --out-dir.');
-            process.exit(1);
-        }
-        if (config.schemaDir) {
-            console.error('Error: --out-file cannot be combined with --schema-dir; use --out-dir for recursive output.');
-            process.exit(1);
-        }
-        if (!config.schema) {
-            console.error('Error: --schema is required. Provide a path to a JSON Schema.');
-            process.exit(1);
-        }
-        await runSingleFile(config, resolve(config.schema), resolve(config.outFile));
-        return;
-    }
-    if (!config.outDir) {
-        console.error('Error: --out-dir or --out-file is required. Provide an output destination for generated files.');
-        process.exit(1);
+  const args = process.argv.slice(2);
+  if (args[0] === "lint") {
+    const { run: lintRun } = await import("./lint/run.js");
+    const result = await lintRun(args.slice(1));
+    if (result.stdout)
+      process.stdout.write(result.stdout);
+    if (result.stderr)
+      process.stderr.write(result.stderr);
+    process.exit(result.code);
+  }
+  if (args[0] === "compile-api") {
+    const { run: compileApiRun } = await import("./compile-api/run.js");
+    const result = await compileApiRun(args.slice(1));
+    if (result.stdout)
+      process.stdout.write(result.stdout);
+    if (result.stderr)
+      process.stderr.write(result.stderr);
+    process.exit(result.code);
+  }
+  if (isVersionRequest(args)) {
+    console.log(await readVersion());
+    return;
+  }
+  if (args.length === 0 || isHelpRequest(args)) {
+    console.log(HELP_TEXT);
+    return;
+  }
+  const configPath = extractConfigPath(args);
+  const fileConfig = configPath ? await loadConfig(configPath) : {};
+  const cliConfig = parseCliArgs(args);
+  const config = { ...fileConfig, ...cliConfig };
+  if (config.outDir && config.outFile) {
+    console.error("Error: provide only one of --out-dir or --out-file, not both.");
+    process.exit(1);
+  }
+  if (config.rootType && config.schemaDir) {
+    console.error("Error: --root-type cannot be combined with --schema-dir; each schema derives its own root type.");
+    process.exit(1);
+  }
+  if (config.build && config.importExt === "ts") {
+    console.error("Error: --import-ext ts cannot be combined with --build. Drop --build to keep runnable .ts sources.");
+    process.exit(1);
+  }
+  if (config.validators && config.typesOnly) {
+    console.error("Error: --validators cannot be combined with --types-only, which emits no runtime code.");
+    process.exit(1);
+  }
+  if (config.validators && config.outFile) {
+    console.error("Error: --validators cannot be combined with --out-file. Use --out-dir to emit validator files.");
+    process.exit(1);
+  }
+  if (config.outFile) {
+    if (!config.typesOnly) {
+      console.error("Error: --out-file currently supports only --types-only output. Add --types-only or use --out-dir.");
+      process.exit(1);
     }
-    const outputDir = resolve(config.outDir);
-    // schemaDir activates recursive mode and takes precedence over a single schema.
     if (config.schemaDir) {
-        await runRecursive(config, resolve(config.schemaDir), outputDir);
-        return;
+      console.error("Error: --out-file cannot be combined with --schema-dir; use --out-dir for recursive output.");
+      process.exit(1);
     }
     if (!config.schema) {
-        console.error('Error: --schema (or --schemaDir) is required. Provide a path to a JSON Schema.');
-        process.exit(1);
-    }
-    await runSingle(config, resolve(config.schema), outputDir);
+      console.error("Error: --schema is required. Provide a path to a JSON Schema.");
+      process.exit(1);
+    }
+    await runSingleFile(config, resolve(config.schema), resolve(config.outFile));
+    return;
+  }
+  if (!config.outDir) {
+    console.error("Error: --out-dir or --out-file is required. Provide an output destination for generated files.");
+    process.exit(1);
+  }
+  const outputDir = resolve(config.outDir);
+  if (config.schemaDir) {
+    await runRecursive(config, resolve(config.schemaDir), outputDir);
+    return;
+  }
+  if (!config.schema) {
+    console.error("Error: --schema (or --schemaDir) is required. Provide a path to a JSON Schema.");
+    process.exit(1);
+  }
+  await runSingle(config, resolve(config.schema), outputDir);
 };
 run().catch((error) => {
-    console.error(error instanceof Error ? error.message : error);
-    process.exit(1);
+  console.error(error instanceof Error ? error.message : error);
+  process.exit(1);
 });