@hydranium/cli 1.0.0-next.4 → 1.0.0-next.400

package/lib/commands/generate-ast-builder.js

@@ -0,0 +1,191 @@
+/********************************************************************************
+ * Copyright (c) 2026 CrossBreeze, EclipseSource and others.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the MIT License which is available in the project root.
+ *
+ * SPDX-License-Identifier: MIT
+ ********************************************************************************/
+import * as fs from 'fs';
+import * as path from 'path';
+import { relativeImportPath } from './generated-module-path.js';
+/**
+ * Langium declares this type alias inside each language's namespace in a
+ * multi-language project. Its presence is what marks a namespace as a grammar's
+ * type registry rather than an incidental one.
+ */
+const NAMESPACED_AST_TYPE_NAME = 'AstType';
+/** Export name of the merged, whole-project binding. */
+const MERGED_EXPORT_NAME = 'astNode';
+/**
+ * Emit a module binding {@link makeAstNodeBuilder} to a project's reflection,
+ * once per grammar plus once across all of them.
+ *
+ * **The binding is boilerplate with exactly one degree of freedom** — the type
+ * map — so hand-writing it buys nothing and goes stale the moment a grammar is
+ * added. Generating it is also the only way a narrowed binding can exist at all:
+ * the per-grammar type maps live in namespaces Langium emits only on its
+ * multi-language path, so a single-grammar project gets the merged binding alone
+ * and there is nothing to narrow.
+ *
+ * **A narrowed binding is only as narrow as its grammar's import closure.**
+ * Langium's per-grammar `AstType` lists everything REACHABLE from that grammar,
+ * so where one grammar imports all the others its map equals the project's and
+ * its binding checks nothing the merged one does not. The emitted doc says so at
+ * each declaration rather than promising a guarantee the type map cannot give.
+ *
+ * Answers `false` when the AST source declares no whole-project type alias,
+ * which means the file did not come from `langium generate` and the caller
+ * should report rather than write a module that cannot compile.
+ */
+export function emitAstBuilder(astSource, options) {
+    const content = buildAstBuilderSource(astSource, options);
+    if (content === undefined) {
+        return false;
+    }
+    fs.mkdirSync(path.dirname(options.outFile), { recursive: true });
+    if (fs.existsSync(options.outFile) && fs.readFileSync(options.outFile, 'utf-8') === content) {
+        console.log('AST builder is up to date.');
+        return true;
+    }
+    fs.writeFileSync(options.outFile, content, 'utf-8');
+    console.log(`Generated: ${options.outFile}`);
+    return true;
+}
+/**
+ * The module text {@link emitAstBuilder} would write, or `undefined` when the
+ * AST source declares no whole-project type alias. Pure over its inputs, so the
+ * emitted shape is testable without touching a filesystem.
+ */
+export function buildAstBuilderSource(astSource, options) {
+    const mergedTypeMap = `${options.languageId}AstType`;
+    if (!astSource.getTypeAlias(mergedTypeMap)) {
+        return undefined;
+    }
+    const bindings = [{ exportName: MERGED_EXPORT_NAME, typeMap: mergedTypeMap }];
+    for (const namespace of findGrammarNamespaces(astSource)) {
+        bindings.push({
+            exportName: builderExportName(namespace),
+            typeMap: `${namespace}.${NAMESPACED_AST_TYPE_NAME}`,
+            namespace
+        });
+    }
+    assertDistinctExportNames(bindings);
+    return renderAstBuilder(bindings, {
+        reflectionName: findReflectionConstName(astSource, options.languageId),
+        importPath: relativeImportPath(options.outFile, options.astFile),
+        regenCommand: options.regenCommand
+    });
+}
+/**
+ * Namespaces that carry a grammar's type registry, in declaration order.
+ *
+ * Keyed on the nested `AstType` alias rather than on the namespace being
+ * exported, because an adopter's augmentation can add namespaces to the same
+ * file for unrelated reasons and only the ones Langium emits per grammar have
+ * a type map to bind.
+ */
+function findGrammarNamespaces(astSource) {
+    const names = [];
+    for (const module of astSource.getModules()) {
+        const name = module.getName();
+        if (name && module.getTypeAlias(NAMESPACED_AST_TYPE_NAME)) {
+            names.push(name);
+        }
+    }
+    return names;
+}
+/**
+ * `Domain` → `domainNode`. Lower-cases the leading character only, so a grammar
+ * named `OrderFlow` reads as `orderFlowNode` rather than losing its word break.
+ */
+function builderExportName(namespace) {
+    return `${namespace.charAt(0).toLowerCase()}${namespace.slice(1)}Node`;
+}
+/**
+ * Two grammars whose names differ only in their leading character collapse to
+ * one export. Emitting anyway would silently drop a binding, so fail with both
+ * names rather than leave the caller to discover it at compile time.
+ */
+function assertDistinctExportNames(bindings) {
+    const seen = new Map();
+    for (const binding of bindings) {
+        const previous = seen.get(binding.exportName);
+        if (previous !== undefined) {
+            throw new Error(`Cannot emit the AST builder: grammars '${previous}' and '${binding.namespace}' both map to the export ` +
+                `'${binding.exportName}'. Rename one grammar so the generated bindings stay distinct.`);
+        }
+        seen.set(binding.exportName, binding.namespace ?? MERGED_EXPORT_NAME);
+    }
+}
+/**
+ * Name of the const holding the project's reflection instance.
+ *
+ * Langium emits `export const reflection = new <LanguageId>AstReflection()`, but
+ * the const is located by its initializer rather than by that name so a renamed
+ * export still resolves. Falls back to the emitted default when no declaration
+ * matches, which keeps the output compiling against a stock Langium file.
+ */
+function findReflectionConstName(astSource, languageId) {
+    const reflectionClass = `${languageId}AstReflection`;
+    for (const declaration of astSource.getVariableDeclarations()) {
+        if (declaration.getInitializer()?.getText().replace(/\s/g, '') === `new${reflectionClass}()`) {
+            return declaration.getName();
+        }
+    }
+    return 'reflection';
+}
+function renderAstBuilder(bindings, context) {
+    const imported = [context.reflectionName, ...bindings.map(binding => `type ${binding.namespace ?? binding.typeMap}`)];
+    const out = [];
+    out.push('/******************************************************************************');
+    out.push(' * Generated from the Langium AST — DO NOT EDIT MANUALLY!');
+    out.push(` * ${context.regenCommand}`);
+    out.push(' ******************************************************************************/');
+    out.push('');
+    out.push('/* eslint-disable */');
+    out.push('');
+    out.push("import { makeAstNodeBuilder } from '@hydranium/core';");
+    out.push(`import { ${imported.join(', ')} } from '${context.importPath}';`);
+    out.push('');
+    // A single-grammar project has nothing to narrow to, so the merged binding is
+    // simply THE binding there and must not point at a sibling that was not emitted.
+    const narrowed = bindings.some(binding => binding.namespace !== undefined);
+    const guarantee = [
+        ' * Mandatory fields are a type error at the call site, and grammar-declared',
+        ' * containment arrays are materialised from reflection metadata, so a built',
+        ' * node carries `[]` where a cast literal would leave `undefined`.'
+    ];
+    for (const binding of bindings) {
+        out.push('/**');
+        if (binding.namespace !== undefined) {
+            out.push(` * AST-node factory narrowed to the '${binding.namespace}' grammar.`);
+            out.push(' *');
+            out.push(' * Narrowed by grammar REACHABILITY, not by ownership: a grammar that');
+            out.push(" * imports another sees that one's types too, so this binding is only as");
+            out.push(` * narrow as '${binding.namespace}'s import closure. Where that closure is the`);
+            out.push(' * whole project, it accepts exactly what the merged binding does and the');
+            out.push(' * choice is documentation rather than a check.');
+            out.push(' *');
+            out.push(...guarantee);
+        }
+        else if (narrowed) {
+            out.push(' * AST-node factory spanning every grammar in this project.');
+            out.push(' *');
+            out.push(' * Prefer the narrowed binding matching the grammar the call site works in:');
+            out.push(" * it rejects a type outside that grammar's import closure, which this one");
+            out.push(' * accepts from anywhere. Reach for this one where a call site genuinely');
+            out.push(' * spans grammars.');
+        }
+        else {
+            out.push(" * AST-node factory for this project's grammar.");
+            out.push(' *');
+            out.push(...guarantee);
+        }
+        out.push(' */');
+        out.push(`export const ${binding.exportName} = makeAstNodeBuilder<${binding.typeMap}>(${context.reflectionName});`);
+        out.push('');
+    }
+    return out.join('\n');
+}
+//# sourceMappingURL=generate-ast-builder.js.map

package/lib/commands/generate-ast-builder.js.map

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

package/lib/commands/generate-languages.d.ts

@@ -0,0 +1,35 @@
+/********************************************************************************
+ * Copyright (c) 2026 EclipseSource and others.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the MIT License which is available in the project root.
+ *
+ * SPDX-License-Identifier: MIT
+ ********************************************************************************/
+import { type SourceFile } from 'ts-morph';
+/** Inputs for {@link emitLanguages}, resolved by the transfer-model command. */
+export interface EmitLanguagesOptions {
+    /** Destination path for the generated languages module. */
+    outFile: string;
+    /** Header line naming the command that regenerates the file. */
+    regenCommand: string;
+}
+/**
+ * Emit a module stating each grammar's language id and file extensions for a
+ * package a client can depend on.
+ *
+ * Read from the `<Grammar>LanguageMetaData` consts langium-cli writes into
+ * `module.ts`, which is the only place the ids exist outside `langium-config.json`
+ * and which a client cannot import, since it pulls in Langium. Generating the
+ * copy instead of writing it by hand is what keeps every host's id list in step
+ * with the grammars.
+ */
+export declare function emitLanguages(moduleSource: SourceFile, options: EmitLanguagesOptions): void;
+/**
+ * The module text {@link emitLanguages} would write. Pure over its inputs, so
+ * the emitted shape is testable without touching a filesystem. Throws when the
+ * source declares no metadata, since an empty list would make every host
+ * register nothing without an error.
+ */
+export declare function buildLanguagesSource(moduleSource: SourceFile, options: Pick<EmitLanguagesOptions, 'regenCommand'>): string;
+//# sourceMappingURL=generate-languages.d.ts.map

package/lib/commands/generate-languages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-languages.d.ts","sourceRoot":"","sources":["../../src/commands/generate-languages.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAKlF,OAAO,EAAiD,KAAK,UAAU,EAAc,MAAM,UAAU,CAAC;AAEtG,gFAAgF;AAChF,MAAM,WAAW,oBAAoB;IAClC,2DAA2D;IAC3D,OAAO,EAAE,MAAM,CAAC;IAChB,gEAAgE;IAChE,YAAY,EAAE,MAAM,CAAC;CACvB;AAWD;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,YAAY,EAAE,UAAU,EAAE,OAAO,EAAE,oBAAoB,GAAG,IAAI,CAS3F;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,CAAC,oBAAoB,EAAE,cAAc,CAAC,GAAG,MAAM,CA6C1H"}

package/lib/commands/generate-languages.js

@@ -0,0 +1,105 @@
+/********************************************************************************
+ * Copyright (c) 2026 EclipseSource and others.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the MIT License which is available in the project root.
+ *
+ * SPDX-License-Identifier: MIT
+ ********************************************************************************/
+import * as fs from 'fs';
+import * as path from 'path';
+import { kebab } from './kebab.js';
+import { SyntaxKind } from 'ts-morph';
+/** Suffix langium-cli gives each grammar's metadata const in `module.ts`. */
+const METADATA_SUFFIX = 'LanguageMetaData';
+/**
+ * Emit a module stating each grammar's language id and file extensions for a
+ * package a client can depend on.
+ *
+ * Read from the `<Grammar>LanguageMetaData` consts langium-cli writes into
+ * `module.ts`, which is the only place the ids exist outside `langium-config.json`
+ * and which a client cannot import, since it pulls in Langium. Generating the
+ * copy instead of writing it by hand is what keeps every host's id list in step
+ * with the grammars.
+ */
+export function emitLanguages(moduleSource, options) {
+    const content = buildLanguagesSource(moduleSource, options);
+    fs.mkdirSync(path.dirname(options.outFile), { recursive: true });
+    if (fs.existsSync(options.outFile) && fs.readFileSync(options.outFile, 'utf-8') === content) {
+        console.log('Languages module is up to date.');
+        return;
+    }
+    fs.writeFileSync(options.outFile, content, 'utf-8');
+    console.log(`Generated: ${options.outFile}`);
+}
+/**
+ * The module text {@link emitLanguages} would write. Pure over its inputs, so
+ * the emitted shape is testable without touching a filesystem. Throws when the
+ * source declares no metadata, since an empty list would make every host
+ * register nothing without an error.
+ */
+export function buildLanguagesSource(moduleSource, options) {
+    const entries = [];
+    const grammarsByConst = new Map();
+    for (const declaration of moduleSource.getVariableDeclarations()) {
+        const name = declaration.getName();
+        if (!name.endsWith(METADATA_SUFFIX)) {
+            continue;
+        }
+        const literal = objectLiteralOf(declaration.getInitializer());
+        const grammar = name.slice(0, -METADATA_SUFFIX.length);
+        const constName = `${kebab(grammar).replace(/-/g, '_').toUpperCase()}_LANGUAGE`;
+        const clash = grammarsByConst.get(constName);
+        if (clash !== undefined) {
+            throw new Error(`Cannot emit the languages module: grammars '${clash}' and '${grammar}' both map to '${constName}'. ` +
+                'Rename one grammar so the generated constants stay distinct.');
+        }
+        grammarsByConst.set(constName, grammar);
+        entries.push({
+            constName,
+            languageId: stringProperty(literal, name, 'languageId'),
+            fileExtensions: stringArrayProperty(literal, name, 'fileExtensions')
+        });
+    }
+    if (entries.length === 0) {
+        throw new Error(`Cannot emit the languages module: ${moduleSource.getFilePath()} declares no '<Grammar>${METADATA_SUFFIX}'.`);
+    }
+    const out = [];
+    out.push('/******************************************************************************');
+    out.push(' * Generated from the Langium language metadata — DO NOT EDIT MANUALLY!');
+    out.push(` * ${options.regenCommand}`);
+    out.push(' ******************************************************************************/');
+    out.push('');
+    for (const entry of entries) {
+        const extensions = entry.fileExtensions.map(extension => JSON.stringify(extension)).join(', ');
+        out.push(`export const ${entry.constName} = { languageId: ${JSON.stringify(entry.languageId)}, fileExtensions: [${extensions}] } as const;`);
+    }
+    out.push('');
+    out.push('/** Every language of the project, in the order langium-cli declares them. */');
+    out.push(`export const ALL_LANGUAGES = [${entries.map(entry => entry.constName).join(', ')}] as const;`);
+    return out.join('\n') + '\n';
+}
+/** The object literal under `as const` / `satisfies` wrappers, which langium-cli adds. */
+function objectLiteralOf(initializer) {
+    return (initializer?.asKind(SyntaxKind.ObjectLiteralExpression) ?? initializer?.getFirstDescendantByKind(SyntaxKind.ObjectLiteralExpression));
+}
+function stringProperty(literal, owner, key) {
+    const value = literal?.getProperty(key)?.asKind(SyntaxKind.PropertyAssignment)?.getInitializer()?.asKind(SyntaxKind.StringLiteral);
+    if (value === undefined) {
+        throw new Error(`Cannot emit the languages module: ${owner} has no string '${key}'.`);
+    }
+    return value.getLiteralValue();
+}
+function stringArrayProperty(literal, owner, key) {
+    const array = literal
+        ?.getProperty(key)
+        ?.asKind(SyntaxKind.PropertyAssignment)
+        ?.getInitializer()
+        ?.asKind(SyntaxKind.ArrayLiteralExpression);
+    const values = array?.getElements().map(element => element.asKind(SyntaxKind.StringLiteral)?.getLiteralValue());
+    if (values === undefined || !values.every((value) => value !== undefined)) {
+        throw new Error(`Cannot emit the languages module: ${owner} has no string array '${key}'.`);
+    }
+    return values;
+}
+//# sourceMappingURL=generate-languages.js.map

package/lib/commands/generate-languages.js.map

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

package/lib/commands/generate-transfer-builder.d.ts

@@ -0,0 +1,33 @@
+/********************************************************************************
+ * Copyright (c) 2026 EclipseSource and others.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the MIT License which is available in the project root.
+ *
+ * SPDX-License-Identifier: MIT
+ ********************************************************************************/
+/** Inputs for {@link emitTransferBuilder}, resolved by the transfer-model command. */
+export interface EmitTransferBuilderOptions {
+    /** Destination path for the generated builder module. */
+    outFile: string;
+    /** Path of the generated transfer model the builder binds to. */
+    transferModelFile: string;
+    /** Language id derived from the `<LanguageId>AstReflection` class name. */
+    languageId: string;
+    /** Header line naming the command that regenerates the file. */
+    regenCommand: string;
+}
+/**
+ * Emit a test module binding `makeTransferNodeBuilder` to the transfer model's
+ * reflection and type map, as `transferNode`.
+ *
+ * The module usually sits in a test tree of the server package while the
+ * transfer model sits in a protocol package of its own, and a relative import
+ * would reach into that package's sources. Across packages it therefore imports
+ * the model by the package's name, which relies on the package's main entry
+ * re-exporting the generated model; within one package it imports by path.
+ */
+export declare function emitTransferBuilder(options: EmitTransferBuilderOptions): void;
+/** The module text {@link emitTransferBuilder} would write. */
+export declare function buildTransferBuilderSource(options: EmitTransferBuilderOptions): string;
+//# sourceMappingURL=generate-transfer-builder.d.ts.map

package/lib/commands/generate-transfer-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-transfer-builder.d.ts","sourceRoot":"","sources":["../../src/commands/generate-transfer-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAOlF,sFAAsF;AACtF,MAAM,WAAW,0BAA0B;IACxC,yDAAyD;IACzD,OAAO,EAAE,MAAM,CAAC;IAChB,iEAAiE;IACjE,iBAAiB,EAAE,MAAM,CAAC;IAC1B,2EAA2E;IAC3E,UAAU,EAAE,MAAM,CAAC;IACnB,gEAAgE;IAChE,YAAY,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,0BAA0B,GAAG,IAAI,CAS7E;AAED,+DAA+D;AAC/D,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,0BAA0B,GAAG,MAAM,CA2BtF"}

package/lib/commands/generate-transfer-builder.js

@@ -0,0 +1,86 @@
+/********************************************************************************
+ * Copyright (c) 2026 EclipseSource and others.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the MIT License which is available in the project root.
+ *
+ * SPDX-License-Identifier: MIT
+ ********************************************************************************/
+import * as fs from 'fs';
+import * as path from 'path';
+import { describeError } from '@hydranium/protocol';
+import { relativeImportPath } from './generated-module-path.js';
+/**
+ * Emit a test module binding `makeTransferNodeBuilder` to the transfer model's
+ * reflection and type map, as `transferNode`.
+ *
+ * The module usually sits in a test tree of the server package while the
+ * transfer model sits in a protocol package of its own, and a relative import
+ * would reach into that package's sources. Across packages it therefore imports
+ * the model by the package's name, which relies on the package's main entry
+ * re-exporting the generated model; within one package it imports by path.
+ */
+export function emitTransferBuilder(options) {
+    const content = buildTransferBuilderSource(options);
+    fs.mkdirSync(path.dirname(options.outFile), { recursive: true });
+    if (fs.existsSync(options.outFile) && fs.readFileSync(options.outFile, 'utf-8') === content) {
+        console.log('Transfer builder is up to date.');
+        return;
+    }
+    fs.writeFileSync(options.outFile, content, 'utf-8');
+    console.log(`Generated: ${options.outFile}`);
+}
+/** The module text {@link emitTransferBuilder} would write. */
+export function buildTransferBuilderSource(options) {
+    const modelPackage = owningPackage(options.transferModelFile);
+    const specifier = modelPackage !== undefined && modelPackage.dir !== owningPackage(options.outFile)?.dir
+        ? modelPackage.name
+        : relativeImportPath(options.outFile, options.transferModelFile);
+    const reflection = `${options.languageId}TransferReflection`;
+    const typeMap = `${options.languageId}TransferTypes`;
+    return [
+        '/******************************************************************************',
+        ' * Generated from the Langium AST — DO NOT EDIT MANUALLY!',
+        ` * ${options.regenCommand}`,
+        ' ******************************************************************************/',
+        '',
+        '/* eslint-disable */',
+        '',
+        "import { makeTransferNodeBuilder } from '@hydranium/protocol/testing';",
+        `import { ${reflection}, type ${typeMap} } from '${specifier}';`,
+        '',
+        '/**',
+        " * Transfer-node factory for this project's grammar, for tests. It fills the",
+        ' * grammar defaults, so a test names only the fields it cares about;',
+        ' * `transferNode.partial` fills none and types the node as incomplete.',
+        ' */',
+        `export const transferNode = makeTransferNodeBuilder<${typeMap}, typeof ${reflection}>(${reflection});`,
+        ''
+    ].join('\n');
+}
+/** The nearest `package.json` at or above `file` that names a package. */
+function owningPackage(file) {
+    let dir = path.dirname(path.resolve(file));
+    for (;;) {
+        const manifest = path.join(dir, 'package.json');
+        if (fs.existsSync(manifest)) {
+            let parsed;
+            try {
+                parsed = JSON.parse(fs.readFileSync(manifest, 'utf-8'));
+            }
+            catch (error) {
+                throw new Error(`Cannot read '${manifest}' to name the transfer model's package: ${describeError(error)}`);
+            }
+            const name = typeof parsed === 'object' && parsed !== null && 'name' in parsed ? parsed.name : undefined;
+            if (typeof name === 'string') {
+                return { dir, name };
+            }
+        }
+        const parent = path.dirname(dir);
+        if (parent === dir) {
+            return undefined;
+        }
+        dir = parent;
+    }
+}
+//# sourceMappingURL=generate-transfer-builder.js.map

package/lib/commands/generate-transfer-builder.js.map

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

package/lib/commands/generate-transfer-model-args.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generate-transfer-model-args.d.ts","sourceRoot":"","sources":["../../src/commands/generate-transfer-model-args.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAIlF,OAAO,EAA6C,KAAK,4BAA4B,EAAE,MAAM,8BAA8B,CAAC;AAC5H,OAAO,EAA2C,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAG7F;;;;;;;;GAQG;AACH,eAAO,MAAM,6BAA6B,EAAE,SAAS,MAAM,EAa1D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,mCAAmC,EAAE,SAAS,MAAM,EAAqE,CAAC;AAEvI,2FAA2F;AAC3F,eAAO,MAAM,4BAA4B,EAAE,SAAS,MAAM,EA4BzD,CAAC;AAEF,2FAA2F;AAC3F,MAAM,WAAW,qBAAqB;IACnC,KAAK,EAAE,OAAO,CAAC,4BAA4B,CAAC,CAAC;IAC7C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,KAAK,EAAE,OAAO,CAAC;CACjB;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,UAA0B,GAAG,qBAAqB,CAsE/G;AAcD,wBAAgB,+BAA+B,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAiCpF"}
+{"version":3,"file":"generate-transfer-model-args.d.ts","sourceRoot":"","sources":["../../src/commands/generate-transfer-model-args.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAIlF,OAAO,EAA6C,KAAK,4BAA4B,EAAE,MAAM,8BAA8B,CAAC;AAC5H,OAAO,EAA2C,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAG7F;;;;;;;;GAQG;AACH,eAAO,MAAM,6BAA6B,EAAE,SAAS,MAAM,EAgB1D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,mCAAmC,EAAE,SAAS,MAAM,EAAqE,CAAC;AAEvI,2FAA2F;AAC3F,eAAO,MAAM,4BAA4B,EAAE,SAAS,MAAM,EAyCzD,CAAC;AAEF,2FAA2F;AAC3F,MAAM,WAAW,qBAAqB;IACnC,KAAK,EAAE,OAAO,CAAC,4BAA4B,CAAC,CAAC;IAC7C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,KAAK,EAAE,OAAO,CAAC;CACjB;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,UAA0B,GAAG,qBAAqB,CA+E/G;AAcD,wBAAgB,+BAA+B,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAiCpF"}

package/lib/commands/generate-transfer-model-args.js

@@ -27,6 +27,9 @@ export const GENERATE_TRANSFER_MODEL_FLAGS = [
     '--ast-file',
     '--augmentation-file',
     '--out-file',
+    '--ast-builder-file',
+    '--transfer-builder-file',
+    '--languages-file',
     '--element-type-name',
     '--terminals-name',
     '--terminals-source-name',
@@ -44,11 +47,13 @@ export const GENERATE_TRANSFER_MODEL_VALUE_FLAGS = GENERATE_TRANSFER_MODEL_FLAGS
 export const GENERATE_TRANSFER_MODEL_HELP = [
     'Usage: hydranium-cli generate-transfer-model [options]',
     '',
-    'Generate a serializable transfer-model TypeScript file from a Langium AST. The',
-    'required inputs (--ast-file / --augmentation-file / --out-file) may instead come',
-    'from a --config JSON file, and --ast-file can be auto-discovered from a Langium',
-    "config's `out` directory. Precedence, highest first: explicit flags, then the",
-    '--config file, then the langium-config-derived --ast-file.',
+    'Generate a serializable transfer-model TypeScript file from a Langium AST, and',
+    'optionally an AST-node builder bound to the same reflection and a transfer-node',
+    'builder for tests. The required inputs (--ast-file / --augmentation-file /',
+    '--out-file) may instead come from a --config JSON file, and --ast-file can be',
+    "auto-discovered from a Langium config's `out` directory. Precedence, highest",
+    'first: explicit flags, then the --config file, then the langium-config-derived',
+    '--ast-file.',
     '',
     'Options:',
     '  --config <path>               JSON config supplying any of the options below.',
@@ -63,6 +68,17 @@ export const GENERATE_TRANSFER_MODEL_HELP = [
     '                                directory: it treats that directory as exclusively',
     '                                its own, so every `langium generate` reports this',
     '                                file as unexpected and offers to delete it.',
+    '  --ast-builder-file <path>     Also emit an AST-node builder module here: one',
+    '                                makeAstNodeBuilder binding per grammar, plus one',
+    '                                spanning all of them. Omit if nothing constructs',
+    '                                AST nodes. Same restriction as --out-file: keep it',
+    "                                out of langium-cli's own `out` directory.",
+    '  --transfer-builder-file <p>   Also emit a test module here binding',
+    '                                makeTransferNodeBuilder to the transfer model as',
+    '                                transferNode. Import it from tests only.',
+    "  --languages-file <path>       Also emit each grammar's language id and file",
+    '                                extensions here, read from the module.ts beside',
+    '                                --ast-file, for a package without Langium.',
     '  --element-type-name <name>    Base element type name in output. Default: TransferElement.',
     '  --terminals-name <name>       Terminals const name in output. Default: ModelTerminals.',
     '  --terminals-source-name <n>   Source-side terminals variable name. Default: <LanguageId>Terminals.',
@@ -106,6 +122,15 @@ export function parseGenerateOptions(args, onError = exitWithUsage) {
             case '--out-file':
                 flags.outFile = next();
                 break;
+            case '--ast-builder-file':
+                flags.astBuilderFile = next();
+                break;
+            case '--transfer-builder-file':
+                flags.transferBuilderFile = next();
+                break;
+            case '--languages-file':
+                flags.languagesFile = next();
+                break;
             case '--element-type-name':
                 flags.elementTypeName = next();
                 break;

package/lib/commands/generate-transfer-model-args.js.map

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

package/lib/commands/generate-transfer-model-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generate-transfer-model-config.d.ts","sourceRoot":"","sources":["../../src/commands/generate-transfer-model-config.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAIlF,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,8BAA8B,CAAC;AAUjF;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,4BAA4B,CAAC,CAmCjG;AAED;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAAC,iBAAiB,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAa5F;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,4BAA4B,CAAC,CAAC,GAAG,4BAA4B,CAmChI"}
+{"version":3,"file":"generate-transfer-model-config.d.ts","sourceRoot":"","sources":["../../src/commands/generate-transfer-model-config.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAKlF,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,8BAA8B,CAAC;AAUjF;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,4BAA4B,CAAC,CAsCjG;AAED;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAAC,iBAAiB,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAa5F;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,4BAA4B,CAAC,CAAC,GAAG,4BAA4B,CAsChI"}

package/lib/commands/generate-transfer-model-config.js

@@ -8,8 +8,9 @@
  ********************************************************************************/
 import * as fs from 'node:fs';
 import * as path from 'node:path';
+import { describeError } from '@hydranium/protocol';
 /** Path-valued option keys — resolved relative to a config/langium-config file's directory. */
-const PATH_KEYS = ['astFile', 'augmentationFile', 'outFile'];
+const PATH_KEYS = ['astFile', 'augmentationFile', 'outFile', 'astBuilderFile', 'transferBuilderFile', 'languagesFile'];
 /** Resolve `value` against `baseDir` when it is relative; absolute paths pass through. */
 function resolveAgainst(baseDir, value) {
     return path.isAbsolute(value) ? value : path.resolve(baseDir, value);
@@ -27,7 +28,7 @@ export function loadTransferModelConfig(configPath) {
         raw = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
     }
     catch (error) {
-        throw new Error(`Cannot read transfer-model config '${configPath}': ${error instanceof Error ? error.message : String(error)}`);
+        throw new Error(`Cannot read transfer-model config '${configPath}': ${describeError(error)}`);
     }
     if (typeof raw !== 'object' || raw === null || Array.isArray(raw)) {
         throw new Error(`Transfer-model config '${configPath}' must be a JSON object.`);
@@ -39,6 +40,9 @@ export function loadTransferModelConfig(configPath) {
         'astFile',
         'augmentationFile',
         'outFile',
+        'astBuilderFile',
+        'transferBuilderFile',
+        'languagesFile',
         'elementTypeName',
         'terminalsName',
         'terminalsSourceName',
@@ -70,7 +74,7 @@ export function deriveAstFileFromLangiumConfig(langiumConfigPath) {
         raw = JSON.parse(fs.readFileSync(langiumConfigPath, 'utf-8'));
     }
     catch (error) {
-        throw new Error(`Cannot read langium-config '${langiumConfigPath}': ${error instanceof Error ? error.message : String(error)}`);
+        throw new Error(`Cannot read langium-config '${langiumConfigPath}': ${describeError(error)}`);
     }
     const out = raw?.out;
     if (typeof out !== 'string') {
@@ -111,6 +115,9 @@ export function mergeTransferModelOptions(...sources) {
         astFile: astFile,
         augmentationFile: augmentationFile,
         outFile: outFile,
+        astBuilderFile: pick('astBuilderFile'),
+        transferBuilderFile: pick('transferBuilderFile'),
+        languagesFile: pick('languagesFile'),
         elementTypeName: pick('elementTypeName'),
         terminalsName: pick('terminalsName'),
         terminalsSourceName: pick('terminalsSourceName'),