langium-zod 0.3.6 → 0.5.0

package/README.md

@@ -16,6 +16,46 @@ import { generateZodSchemas } from 'langium-zod';
 const source = generateZodSchemas({ grammar, services });
 ```
 
+### Programmatic options
+
+```ts
+generateZodSchemas({
+	grammar,
+	outputPath: 'src/generated/zod-schemas.ts',
+	include: ['Greeting', 'Tag'],
+	exclude: ['InternalNode'],
+	stripInternals: true,
+	projection: {
+		defaults: { strip: ['$container', '$document'] },
+		types: {
+			Greeting: { fields: ['name', 'tags'] }
+		}
+	},
+	conformance: {
+		astTypesPath: 'src/generated/ast.ts'
+	},
+	crossRefValidation: true
+});
+```
+
+### CLI options
+
+```sh
+langium-zod generate \
+	--config langium-config.json \
+	--out src/generated/zod-schemas.ts \
+	--include Greeting,Tag \
+	--exclude InternalNode \
+	--projection projection.json \
+	--strip-internals \
+	--conformance \
+	--ast-types src/generated/ast.ts \
+	--conformance-out src/generated/zod-schemas.conformance.ts \
+	--cross-ref-validation
+```
+
+`zRef` is exported from the package for manual schema customization in runtime-aware validation flows.
+
 Generated output uses Zod 4 and exports named schemas like `<TypeName>Schema`.
 
 ## Requirements

package/dist/api.d.ts

@@ -1,3 +1,4 @@
 import type { ZodGeneratorConfig } from './config.js';
+export type PublicZodGeneratorConfig = ZodGeneratorConfig;
 export declare function generateZodSchemas(config: ZodGeneratorConfig): string;
 //# sourceMappingURL=api.d.ts.map

package/dist/api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AActD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CA4CrE"}
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAStD,MAAM,MAAM,wBAAwB,GAAG,kBAAkB,CAAC;AAS1D,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CA8FrE"}

package/dist/api.js

@@ -1,9 +1,11 @@
 import { mkdirSync, writeFileSync } from 'node:fs';
 import { dirname } from 'node:path';
 import { collectAst } from 'langium/grammar';
+import { generateConformanceSource, inferConformanceOutputPath } from './conformance.js';
 import { ZodGeneratorError } from './errors.js';
 import { extractTypeDescriptors } from './extractor.js';
 import { generateZodCode } from './generator.js';
+import { applyProjectionToDescriptors, resolveEffectiveStripFields } from './projection.js';
 import { detectRecursiveTypes } from './recursion-detector.js';
 function resolveAstTypes(astTypes) {
     return {
@@ -25,10 +27,7 @@ export function generateZodSchemas(config) {
         });
     }
     const astTypes = resolveAstTypes(rawAstTypes);
-    const rawDescriptors = extractTypeDescriptors(astTypes, {
-        include: config.include,
-        exclude: config.exclude
-    });
+    const rawDescriptors = buildDescriptorPipeline(astTypes, config);
     // Apply regexOverrides: upgrade primitive-alias schemas to regex-enum for types
     // whose Langium grammar rule is too complex for automatic regex derivation.
     const overrides = config.regexOverrides ?? {};
@@ -45,11 +44,62 @@ export function generateZodSchemas(config) {
         return d;
     });
     const recursiveTypes = detectRecursiveTypes(descriptors);
-    const source = generateZodCode(descriptors, recursiveTypes);
+    const surfaceDescriptors = applyProjectionToDescriptors(descriptors, {
+        projection: config.projection,
+        stripInternals: config.stripInternals
+    });
+    const source = generateZodCode(descriptors, recursiveTypes, {
+        projection: config.projection,
+        stripInternals: config.stripInternals,
+        crossRefValidation: config.crossRefValidation
+    });
     if (config.outputPath) {
         mkdirSync(dirname(config.outputPath), { recursive: true });
         writeFileSync(config.outputPath, source, 'utf8');
     }
+    if (config.conformance) {
+        if (!config.outputPath) {
+            throw new ZodGeneratorError('Conformance generation requires outputPath', {
+                suggestion: 'Provide outputPath when conformance generation is enabled'
+            });
+        }
+        if (!config.conformance.astTypesPath) {
+            throw new ZodGeneratorError('Conformance generation requires astTypesPath', {
+                suggestion: 'Provide conformance.astTypesPath or use CLI --ast-types/auto-resolution'
+            });
+        }
+        const schemaTypeNames = surfaceDescriptors
+            .filter((descriptor) => descriptor.kind === 'object')
+            .map((descriptor) => descriptor.name);
+        if (schemaTypeNames.length === 0) {
+            console.warn('Warning: Conformance generation skipped because no schemas remain after filtering.');
+            return source;
+        }
+        const conformanceOutputPath = inferConformanceOutputPath(config.outputPath, config.conformance.outputPath);
+        const conformance = generateConformanceSource({
+            schemaOutputPath: config.outputPath,
+            conformanceOutputPath,
+            astTypesPath: config.conformance.astTypesPath,
+            schemaTypeNames,
+            stripFields: resolveEffectiveStripFields({
+                projection: config.projection,
+                stripInternals: config.stripInternals
+            }),
+            projection: config.projection
+        });
+        for (const missingType of conformance.missingAstTypes) {
+            console.warn(`Warning: Missing AST export for conformance type ${missingType}; skipping.`);
+        }
+        mkdirSync(dirname(conformanceOutputPath), { recursive: true });
+        writeFileSync(conformanceOutputPath, conformance.source, 'utf8');
+    }
     return source;
 }
+function buildDescriptorPipeline(astTypes, config) {
+    const descriptors = extractTypeDescriptors(astTypes, {
+        include: config.include,
+        exclude: config.exclude
+    });
+    return descriptors;
+}
 //# sourceMappingURL=api.js.map

package/dist/api.js.map

@@ -1 +1 @@
-{"version":3,"file":"api.js","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAG/D,SAAS,eAAe,CAAC,QAAsB;IAC9C,OAAO;QACN,UAAU,EAAE,QAAQ,CAAC,UAAU,IAAI,EAAE;QACrC,MAAM,EAAE,QAAQ,CAAC,MAAM,IAAI,EAAE;KAC7B,CAAC;AACH,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,MAA0B;IAC5D,IAAI,WAAyB,CAAC;IAC9B,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACrB,WAAW,GAAG,MAAM,CAAC,QAAQ,CAAC;IAC/B,CAAC;SAAM,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QAC3B,WAAW,GAAG,UAAU,CAAC,MAAM,CAAC,OAAO,CAA4B,CAAC;IACrE,CAAC;SAAM,CAAC;QACP,MAAM,IAAI,iBAAiB,CAAC,mDAAmD,EAAE;YAChF,UAAU,EAAE,uEAAuE;SACnF,CAAC,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,eAAe,CAAC,WAAW,CAAC,CAAC;IAE9C,MAAM,cAAc,GAAG,sBAAsB,CAAC,QAAQ,EAAE;QACvD,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,OAAO,EAAE,MAAM,CAAC,OAAO;KACvB,CAAC,CAAC;IAEH,gFAAgF;IAChF,4EAA4E;IAC5E,MAAM,SAAS,GAAG,MAAM,CAAC,cAAc,IAAI,EAAE,CAAC;IAC9C,MAAM,WAAW,GAAwB,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACjE,MAAM,QAAQ,GAAG,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,QAAQ,IAAI,CAAC,CAAC,CAAC,IAAI,KAAK,iBAAiB,IAAI,CAAC,CAAC,IAAI,KAAK,YAAY,CAAC,EAAE,CAAC;YAC3E,OAAO;gBACN,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,IAAI,EAAE,YAAY;gBAClB,KAAK,EAAE,QAAQ;gBACf,QAAQ,EAAE,CAAC,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC,CAAE,CAA4B,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE;aAC9C,CAAC;QACpC,CAAC;QACD,OAAO,CAAC,CAAC;IACV,CAAC,CAAC,CAAC;IAEH,MAAM,cAAc,GAAG,oBAAoB,CAAC,WAAW,CAAC,CAAC;IACzD,MAAM,MAAM,GAAG,eAAe,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;IAE5D,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;QACvB,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3D,aAAa,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAClD,CAAC;IAED,OAAO,MAAM,CAAC;AACf,CAAC"}
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"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"}

package/dist/cli.d.ts

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+import type { ZodGeneratorConfig } from './config.js';
+/** User-facing config file shape (langium-zod.config.js / .ts) */
+export interface LangiumZodConfig extends Omit<ZodGeneratorConfig, 'grammar' | 'services' | 'astTypes'> {
+    /**
+     * Path to `langium-config.json`. Defaults to `langium-config.json` in cwd.
+     * Only used when picked up via the CLI; programmatic API ignores it.
+     */
+    langiumConfig?: string;
+    /** Explicit output path. Overrides derived path from langium-config.json `out` field. */
+    outputPath?: string;
+}
+export declare function resolveFilterOverrides(base: Pick<LangiumZodConfig, 'include' | 'exclude'>, includeArg?: string, excludeArg?: string): Pick<LangiumZodConfig, 'include' | 'exclude'>;
+export declare function getUnknownFilterNames(requested: string[] | undefined, availableTypeNames: string[]): string[];
+export interface GenerateOptions {
+    /** Absolute path to langium-config.json */
+    langiumConfigPath: string;
+    /** Merged generator config (from user's langium-zod.config.js + CLI flags) */
+    config?: LangiumZodConfig;
+}
+export declare function generate(opts: GenerateOptions): Promise<void>;
+export declare function main(): Promise<void>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAgBA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAQtD,kEAAkE;AAClE,MAAM,WAAW,gBAChB,SAAQ,IAAI,CAAC,kBAAkB,EAAE,SAAS,GAAG,UAAU,GAAG,UAAU,CAAC;IACrE;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,yFAAyF;IACzF,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAuCD,wBAAgB,sBAAsB,CACrC,IAAI,EAAE,IAAI,CAAC,gBAAgB,EAAE,SAAS,GAAG,SAAS,CAAC,EACnD,UAAU,CAAC,EAAE,MAAM,EACnB,UAAU,CAAC,EAAE,MAAM,GACjB,IAAI,CAAC,gBAAgB,EAAE,SAAS,GAAG,SAAS,CAAC,CAc/C;AAoBD,wBAAgB,qBAAqB,CACpC,SAAS,EAAE,MAAM,EAAE,GAAG,SAAS,EAC/B,kBAAkB,EAAE,MAAM,EAAE,GAC1B,MAAM,EAAE,CAOV;AAyED,MAAM,WAAW,eAAe;IAC/B,2CAA2C;IAC3C,iBAAiB,EAAE,MAAM,CAAC;IAC1B,8EAA8E;IAC9E,MAAM,CAAC,EAAE,gBAAgB,CAAC;CAC1B;AAED,wBAAsB,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CA0FnE;AAMD,wBAAsB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAmG1C"}

package/dist/cli.js

@@ -0,0 +1,298 @@
+#!/usr/bin/env node
+/**
+ * langium-zod CLI
+ *
+ * Usage:
+ *   langium-zod generate [--config langium-config.json] [--out src/generated/zod-schemas.ts]
+ *   langium-zod --help
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { URI } from 'langium';
+import { createLangiumGrammarServices, resolveImportUri } from 'langium/grammar';
+import { NodeFileSystem } from 'langium/node';
+import { generateZodSchemas } from './api.js';
+import { resolveAstTypesPath } from './conformance.js';
+import { loadProjectionConfig } from './projection.js';
+function parseCsvList(value) {
+    const seen = new Set();
+    const parsed = [];
+    for (const entry of value.split(',')) {
+        const normalized = entry.trim();
+        if (!normalized || seen.has(normalized)) {
+            continue;
+        }
+        seen.add(normalized);
+        parsed.push(normalized);
+    }
+    return parsed;
+}
+function getArgValue(args, flag) {
+    const idx = args.indexOf(flag);
+    if (idx < 0) {
+        return undefined;
+    }
+    const value = args[idx + 1];
+    if (value == null || value.startsWith('--')) {
+        throw new Error(`Missing value for ${flag}`);
+    }
+    return value;
+}
+export function resolveFilterOverrides(base, includeArg, excludeArg) {
+    const includeFromCli = includeArg === undefined ? undefined : parseCsvList(includeArg);
+    const excludeFromCli = excludeArg === undefined ? undefined : parseCsvList(excludeArg);
+    const includeSource = includeFromCli ?? base.include ?? [];
+    const excludeSource = excludeFromCli ?? base.exclude ?? [];
+    const excludeSet = new Set(excludeSource);
+    const include = includeSource.filter((name) => !excludeSet.has(name));
+    return {
+        include,
+        exclude: excludeSource
+    };
+}
+function warnUnknownFilterNames(filterName, requested, availableTypeNames) {
+    const unknown = getUnknownFilterNames(requested, availableTypeNames);
+    if (unknown.length === 0) {
+        return;
+    }
+    const availableList = availableTypeNames.length > 0
+        ? availableTypeNames.join(', ')
+        : '(none)';
+    console.warn(`Warning: Unknown ${filterName} type name(s): ${unknown.join(', ')}. Available types: ${availableList}`);
+}
+export function getUnknownFilterNames(requested, availableTypeNames) {
+    if (!requested || requested.length === 0) {
+        return [];
+    }
+    const available = new Set(availableTypeNames);
+    return requested.filter((name) => !available.has(name));
+}
+// ────────────────────────────────────────────────────────────────────────────
+// Helpers
+// ────────────────────────────────────────────────────────────────────────────
+function printHelp() {
+    console.log(`
+langium-zod — generate Zod schemas from Langium grammar files
+
+USAGE
+  langium-zod generate [options]
+
+OPTIONS
+  --config <path>   Path to langium-config.json  (default: langium-config.json)
+  --out    <path>   Output file path              (default: <out>/zod-schemas.ts)
+	--include <csv>   Comma-separated type allowlist
+	--exclude <csv>   Comma-separated type blocklist
+	--projection <file> Projection config JSON file
+	--strip-internals  Strip internal Langium metadata fields
+	--conformance     Generate conformance artifact
+	--ast-types <path> Path to generated AST declarations (ast.ts)
+	--conformance-out <path> Output path for conformance artifact
+	--cross-ref-validation Emit runtime cross-reference schema factories
+  --help            Show this help message
+
+CONFIGURATION
+  Create a langium-zod.config.js (or .mjs) in the same directory as
+  langium-config.json to customise generation:
+
+    // langium-zod.config.js
+    export default {
+      outputPath: 'src/generated/zod-schemas.ts',
+      regexOverrides: {
+        BigDecimal: String.raw\`^[+-]?(\\.[0-9]+|[0-9]+\\.[0-9]*)([eE][+-]?[0-9]+)?$\`,
+      },
+      include: [],  // allowlist of type names to include
+      exclude: [],  // blocklist of type names to exclude
+    };
+`);
+}
+/**
+ * Recursively load imported grammar files so that DocumentBuilder can link
+ * cross-file references correctly (mirrors langium-cli's eagerLoad strategy).
+ */
+async function eagerLoad(document, documents, visited = new Set()) {
+    const key = document.uri.toString();
+    if (visited.has(key))
+        return;
+    visited.add(key);
+    const grammar = document.parseResult?.value;
+    if (!grammar)
+        return;
+    // Grammar.imports is an array of GrammarImport nodes; resolveImportUri handles the URI
+    const imports = grammar.imports ?? [];
+    for (const imp of imports) {
+        const importUri = resolveImportUri(imp);
+        if (importUri) {
+            const importedDoc = await documents.getOrCreateDocument(importUri);
+            await eagerLoad(importedDoc, documents, visited);
+        }
+    }
+}
+export async function generate(opts) {
+    const { langiumConfigPath } = opts;
+    const userConfig = opts.config ?? {};
+    // ── 1. Load langium-config.json ─────────────────────────────────────────
+    if (!existsSync(langiumConfigPath)) {
+        throw new Error(`langium-config.json not found: ${langiumConfigPath}`);
+    }
+    const langiumConfig = JSON.parse(readFileSync(langiumConfigPath, 'utf8'));
+    const configDir = dirname(langiumConfigPath);
+    const languages = langiumConfig.languages;
+    if (!languages || languages.length === 0) {
+        throw new Error('No languages defined in langium-config.json');
+    }
+    const grammarRelPath = languages[0].grammar;
+    const grammarAbsPath = resolve(configDir, grammarRelPath);
+    if (!existsSync(grammarAbsPath)) {
+        throw new Error(`Grammar file not found: ${grammarAbsPath}`);
+    }
+    // ── 2. Resolve output path ───────────────────────────────────────────────
+    const outDir = langiumConfig.out
+        ? resolve(configDir, langiumConfig.out)
+        : resolve(configDir, 'src/generated');
+    const outputPath = userConfig.outputPath ?? join(outDir, 'zod-schemas.ts');
+    const conformanceConfig = userConfig.conformance;
+    if (conformanceConfig) {
+        const resolvedAstTypesPath = conformanceConfig.astTypesPath
+            ? resolve(configDir, conformanceConfig.astTypesPath)
+            : langiumConfig.astTypes
+                ? resolve(configDir, langiumConfig.astTypes)
+                : resolveAstTypesPath(configDir, outDir);
+        if (!existsSync(resolvedAstTypesPath)) {
+            throw new Error(`Unable to resolve ast types path for conformance: ${resolvedAstTypesPath}`);
+        }
+        userConfig.conformance = {
+            astTypesPath: resolvedAstTypesPath,
+            outputPath: conformanceConfig.outputPath
+        };
+    }
+    // ── 3. Parse grammar using Langium services ──────────────────────────────
+    const { shared, grammar: grammarServices } = createLangiumGrammarServices(NodeFileSystem);
+    void grammarServices; // used only for type-checking if needed later
+    const langiumDocuments = shared.workspace.LangiumDocuments;
+    const documentBuilder = shared.workspace.DocumentBuilder;
+    const grammarUri = URI.file(grammarAbsPath);
+    const entryDocument = await langiumDocuments.getOrCreateDocument(grammarUri);
+    // Recursively load imported files so references resolve correctly
+    await eagerLoad(entryDocument, langiumDocuments);
+    // Build (parse + link) all loaded documents
+    await documentBuilder.build(langiumDocuments.all.toArray(), {
+        validation: false,
+    });
+    const grammar = entryDocument.parseResult.value;
+    const availableTypeNames = [
+        ...(grammar.interfaces ?? []).map((entry) => entry.name),
+        ...(grammar.types ?? []).map((entry) => entry.name)
+    ]
+        .filter((name) => typeof name === 'string')
+        .sort((left, right) => left.localeCompare(right));
+    warnUnknownFilterNames('include', userConfig.include, availableTypeNames);
+    warnUnknownFilterNames('exclude', userConfig.exclude, availableTypeNames);
+    // ── 4. Generate schemas ──────────────────────────────────────────────────
+    const { langiumConfig: _ignored, outputPath: _op, ...restConfig } = userConfig;
+    generateZodSchemas({
+        grammar,
+        outputPath,
+        ...restConfig,
+    });
+    console.log(`✓ Generated Zod schemas → ${outputPath}`);
+}
+// ────────────────────────────────────────────────────────────────────────────
+// CLI entry point
+// ────────────────────────────────────────────────────────────────────────────
+export async function main() {
+    const args = process.argv.slice(2);
+    if (args.length === 0 || args.includes('--help') || args.includes('-h')) {
+        printHelp();
+        process.exit(0);
+    }
+    const command = args[0];
+    if (command !== 'generate') {
+        console.error(`Unknown command: ${command}`);
+        printHelp();
+        process.exit(1);
+    }
+    // ── Parse flags ──────────────────────────────────────────────────────────
+    const configFlagIdx = args.indexOf('--config');
+    const configFlagValue = configFlagIdx >= 0 ? args[configFlagIdx + 1] : undefined;
+    const outFlagIdx = args.indexOf('--out');
+    const outFlagValue = outFlagIdx >= 0 ? args[outFlagIdx + 1] : undefined;
+    const includeFlagValue = getArgValue(args, '--include');
+    const excludeFlagValue = getArgValue(args, '--exclude');
+    const projectionFlagValue = getArgValue(args, '--projection');
+    const astTypesFlagValue = getArgValue(args, '--ast-types');
+    const conformanceOutFlagValue = getArgValue(args, '--conformance-out');
+    const stripInternalsEnabled = args.includes('--strip-internals');
+    const conformanceEnabled = args.includes('--conformance');
+    const crossRefValidationEnabled = args.includes('--cross-ref-validation');
+    // ── Locate langium-config.json ───────────────────────────────────────────
+    const configFileName = configFlagValue ?? 'langium-config.json';
+    const langiumConfigPath = resolve(process.cwd(), configFileName);
+    // ── Load optional langium-zod.config.js ──────────────────────────────────
+    const configDir = dirname(langiumConfigPath);
+    let userConfig = {};
+    for (const candidate of [
+        'langium-zod.config.js',
+        'langium-zod.config.mjs',
+    ]) {
+        const candidatePath = join(configDir, candidate);
+        if (existsSync(candidatePath)) {
+            const mod = await import(pathToFileURL(candidatePath).href);
+            userConfig = (mod.default ?? mod);
+            break;
+        }
+    }
+    // CLI --out flag overrides config file outputPath
+    if (outFlagValue) {
+        userConfig = { ...userConfig, outputPath: resolve(process.cwd(), outFlagValue) };
+    }
+    const filterOverrides = resolveFilterOverrides(userConfig, includeFlagValue, excludeFlagValue);
+    userConfig = {
+        ...userConfig,
+        ...filterOverrides
+    };
+    if (projectionFlagValue) {
+        const projectionPath = resolve(process.cwd(), projectionFlagValue);
+        userConfig = {
+            ...userConfig,
+            projection: loadProjectionConfig(projectionPath)
+        };
+    }
+    if (stripInternalsEnabled) {
+        userConfig = {
+            ...userConfig,
+            stripInternals: true
+        };
+    }
+    if (conformanceEnabled) {
+        userConfig = {
+            ...userConfig,
+            conformance: {
+                astTypesPath: astTypesFlagValue ? resolve(process.cwd(), astTypesFlagValue) : undefined,
+                outputPath: conformanceOutFlagValue ? resolve(process.cwd(), conformanceOutFlagValue) : undefined
+            }
+        };
+    }
+    if (crossRefValidationEnabled) {
+        userConfig = {
+            ...userConfig,
+            crossRefValidation: true
+        };
+    }
+    try {
+        await generate({ langiumConfigPath, config: userConfig });
+    }
+    catch (err) {
+        console.error('Error:', err instanceof Error ? err.message : String(err));
+        process.exit(1);
+    }
+}
+// Guard against library imports running the CLI
+const isMain = process.argv[1] != null &&
+    (process.argv[1].endsWith('/cli.js') ||
+        process.argv[1].endsWith('/cli.ts') ||
+        process.argv[1].endsWith('langium-zod'));
+if (isMain) {
+    void main();
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/config.d.ts

@@ -1,5 +1,6 @@
 import type { Grammar, LangiumCoreServices } from 'langium';
 import type { AstTypesLike } from './types.js';
+import type { ProjectionConfig } from './projection.js';
 export interface FilterConfig {
     include?: string[];
     exclude?: string[];
@@ -9,6 +10,13 @@ export interface ZodGeneratorConfig extends FilterConfig {
     services?: LangiumCoreServices;
     outputPath?: string;
     astTypes?: AstTypesLike;
+    projection?: ProjectionConfig;
+    stripInternals?: boolean;
+    crossRefValidation?: boolean;
+    conformance?: {
+        astTypesPath?: string;
+        outputPath?: string;
+    };
     /**
      * Override the generated schema for specific type names.
      *

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,MAAM,WAAW,YAAY;IAC5B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,kBAAmB,SAAQ,YAAY;IACvD,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,EAAE,CAAC;IAC9B,QAAQ,CAAC,EAAE,mBAAmB,CAAC;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB;;;;;;;;;;;;;;;OAeG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACxC;AAED,eAAO,MAAM,mBAAmB,iCAAiC,CAAC;AAElE,wBAAgB,qBAAqB,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,QAAQ,CAAC,YAAY,CAAC,CAKnF"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,MAAM,WAAW,YAAY;IAC5B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,kBAAmB,SAAQ,YAAY;IACvD,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,EAAE,CAAC;IAC9B,QAAQ,CAAC,EAAE,mBAAmB,CAAC;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,WAAW,CAAC,EAAE;QACb,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,UAAU,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IACF;;;;;;;;;;;;;;;OAeG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACxC;AAED,eAAO,MAAM,mBAAmB,iCAAiC,CAAC;AAElE,wBAAgB,qBAAqB,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,QAAQ,CAAC,YAAY,CAAC,CAKnF"}

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAgCA,MAAM,CAAC,MAAM,mBAAmB,GAAG,8BAA8B,CAAC;AAElE,MAAM,UAAU,qBAAqB,CAAC,MAAqB;IAC1D,OAAO;QACN,OAAO,EAAE,MAAM,EAAE,OAAO,IAAI,EAAE;QAC9B,OAAO,EAAE,MAAM,EAAE,OAAO,IAAI,EAAE;KAC9B,CAAC;AACH,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAwCA,MAAM,CAAC,MAAM,mBAAmB,GAAG,8BAA8B,CAAC;AAElE,MAAM,UAAU,qBAAqB,CAAC,MAAqB;IAC1D,OAAO;QACN,OAAO,EAAE,MAAM,EAAE,OAAO,IAAI,EAAE;QAC9B,OAAO,EAAE,MAAM,EAAE,OAAO,IAAI,EAAE;KAC9B,CAAC;AACH,CAAC"}

package/dist/conformance.d.ts

@@ -0,0 +1,17 @@
+import type { ProjectionConfig } from './projection.js';
+export interface ConformanceGenerationOptions {
+    schemaOutputPath: string;
+    conformanceOutputPath?: string;
+    astTypesPath: string;
+    schemaTypeNames: string[];
+    stripFields: string[];
+    projection?: ProjectionConfig;
+}
+export declare function inferConformanceOutputPath(schemaOutputPath: string, overridePath?: string): string;
+export declare function collectAstExportNames(astTypesPath: string): Set<string>;
+export declare function generateConformanceSource(options: ConformanceGenerationOptions): {
+    source: string;
+    missingAstTypes: string[];
+};
+export declare function resolveAstTypesPath(configDir: string, langiumOutDir: string, explicitAstTypesPath?: string): string;
+//# sourceMappingURL=conformance.d.ts.map

package/dist/conformance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conformance.d.ts","sourceRoot":"","sources":["../src/conformance.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,MAAM,WAAW,4BAA4B;IAC5C,gBAAgB,EAAE,MAAM,CAAC;IACzB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,UAAU,CAAC,EAAE,gBAAgB,CAAC;CAC9B;AAuBD,wBAAgB,0BAA0B,CACzC,gBAAgB,EAAE,MAAM,EACxB,YAAY,CAAC,EAAE,MAAM,GACnB,MAAM,CASR;AAED,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAevE;AAED,wBAAgB,yBAAyB,CACxC,OAAO,EAAE,4BAA4B,GACnC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,EAAE,CAAA;CAAE,CA2D/C;AAED,wBAAgB,mBAAmB,CAClC,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,EACrB,oBAAoB,CAAC,EAAE,MAAM,GAC3B,MAAM,CAKR"}