@hydranium/cli 1.0.0-next.30 → 1.0.0-next.300

package/lib/commands/ast-ground-truth.js.map

@@ -1 +1 @@
-{"version":3,"file":"ast-ground-truth.js","sourceRoot":"","sources":["../../src/commands/ast-ground-truth.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,cAAc,EAA2B,MAAM,uBAAuB,CAAC;AAE/F;;;GAGG;AACH,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,8BAA8B,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAYvF,oEAAoE;AACpE,MAAM,UAAU,0BAA0B,CAAC,OAAqC;IAC7E,MAAM,IAAI,GAAG,CAAC,YAAY,EAAE,OAAO,CAAC,cAAc,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IACvE,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QACjC,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7C,CAAC;IACD,OAAO,IAAI,CAAC;AACf,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAqC;IACpE,OAAO,cAAc,CAAC,CAAC,2BAA2B,EAAE,MAAM,EAAE,GAAG,0BAA0B,CAAC,OAAO,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;AACjH,CAAC"}
+{"version":3,"file":"ast-ground-truth.js","sourceRoot":"","sources":["../../src/commands/ast-ground-truth.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,cAAc,EAA2B,MAAM,uBAAuB,CAAC;AAE/F;;;GAGG;AACH,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,8BAA8B,EAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAYvF,oEAAoE;AACpE,MAAM,UAAU,0BAA0B,CAAC,OAAqC;IAC7E,MAAM,IAAI,GAAG,CAAC,YAAY,EAAE,OAAO,CAAC,cAAc,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IACvE,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QACjC,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7C,CAAC;IACD,OAAO,IAAI,CAAC;AACf,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAqC;IACpE,OAAO,cAAc,CAAC,CAAC,MAAM,EAAE,GAAG,0BAA0B,CAAC,OAAO,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;AACpF,CAAC"}

package/lib/commands/client-session.d.ts

@@ -0,0 +1,17 @@
+/********************************************************************************
+ * 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 type { TransferElement } from '@hydranium/protocol';
+import type { DataServerProtocol } from '@hydranium/protocol/data';
+/**
+ * Run `fn` as the client session `clientId`, and end the session whether `fn`
+ * succeeded or not, which closes whatever it left open. An end that fails
+ * after a failed `fn` is swallowed: `fn`'s error is the one the user needs.
+ */
+export declare function withClientSession<T>(server: Pick<DataServerProtocol<TransferElement>, 'createSession' | 'closeSession'>, clientId: string, fn: () => Promise<T>): Promise<T>;
+//# sourceMappingURL=client-session.d.ts.map

package/lib/commands/client-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-session.d.ts","sourceRoot":"","sources":["../../src/commands/client-session.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAEnE;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,CAAC,EACtC,MAAM,EAAE,IAAI,CAAC,kBAAkB,CAAC,eAAe,CAAC,EAAE,eAAe,GAAG,cAAc,CAAC,EACnF,QAAQ,EAAE,MAAM,EAChB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACpB,OAAO,CAAC,CAAC,CAAC,CAWZ"}

package/lib/commands/client-session.js

@@ -0,0 +1,27 @@
+/********************************************************************************
+ * 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
+ ********************************************************************************/
+/**
+ * Run `fn` as the client session `clientId`, and end the session whether `fn`
+ * succeeded or not, which closes whatever it left open. An end that fails
+ * after a failed `fn` is swallowed: `fn`'s error is the one the user needs.
+ */
+export async function withClientSession(server, clientId, fn) {
+    await server.createSession({ clientId, label: 'hydranium-cli' });
+    let result;
+    try {
+        result = await fn();
+    }
+    catch (error) {
+        await server.closeSession({ clientId }).catch(() => undefined);
+        throw error;
+    }
+    await server.closeSession({ clientId });
+    return result;
+}
+//# sourceMappingURL=client-session.js.map

package/lib/commands/client-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-session.js","sourceRoot":"","sources":["../../src/commands/client-session.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAKlF;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACpC,MAAmF,EACnF,QAAgB,EAChB,EAAoB;IAEpB,MAAM,MAAM,CAAC,aAAa,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,eAAe,EAAE,CAAC,CAAC;IACjE,IAAI,MAAS,CAAC;IACd,IAAI,CAAC;QACF,MAAM,GAAG,MAAM,EAAE,EAAE,CAAC;IACvB,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACvB,MAAM,MAAM,CAAC,YAAY,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC/D,MAAM,KAAK,CAAC;IACf,CAAC;IACD,MAAM,MAAM,CAAC,YAAY,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;IACxC,OAAO,MAAM,CAAC;AACjB,CAAC"}

package/lib/commands/create-args.d.ts

@@ -0,0 +1,17 @@
+/********************************************************************************
+ * 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 UsageError } from './harness-args.js';
+import { type CreateCommandOptions } from './create.js';
+/** Every flag `create` accepts, each of which takes a value. */
+export declare const CREATE_FLAGS: readonly string[];
+/** The `--help` text, as data, held to {@link CREATE_FLAGS} by a test. */
+export declare const CREATE_HELP: readonly string[];
+export declare function parseCreateArgs(args: string[], onError?: UsageError): CreateCommandOptions;
+export declare function runCreateCommand(args: string[]): Promise<void>;
+//# sourceMappingURL=create-args.d.ts.map

package/lib/commands/create-args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-args.d.ts","sourceRoot":"","sources":["../../src/commands/create-args.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EASJ,KAAK,UAAU,EACjB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,KAAK,oBAAoB,EAAa,MAAM,aAAa,CAAC;AAInE,gEAAgE;AAChE,eAAO,MAAM,YAAY,EAAE,SAAS,MAAM,EAAgD,CAAC;AAE3F,0EAA0E;AAC1E,eAAO,MAAM,WAAW,EAAE,SAAS,MAAM,EAexC,CAAC;AAEF,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,UAA0B,GAAG,oBAAoB,CAczG;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAM9D"}

package/lib/commands/create-args.js

@@ -0,0 +1,53 @@
+/********************************************************************************
+ * 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 { assertRequired, exitWithUsage, helpRequested, logHelpLines, parseFlagOptions, parseServerSpawnOptions, printHelp, SERVER_SPAWN_VALUE_FLAGS } from './harness-args.js';
+import { runCreate } from './create.js';
+const OWN_FLAGS = ['--uri', '--content', '--client-id'];
+/** Every flag `create` accepts, each of which takes a value. */
+export const CREATE_FLAGS = [...SERVER_SPAWN_VALUE_FLAGS, ...OWN_FLAGS];
+/** The `--help` text, as data, held to {@link CREATE_FLAGS} by a test. */
+export const CREATE_HELP = [
+    'Usage: hydranium-cli create --server "<cmd>..." --uri <uri> --content <text|@file> [--client-id <id>] [--cwd <dir>] [--log-level <lvl>] [--log-file <file>] [--log-file-level <lvl>]',
+    '',
+    'Create the document at `<uri>` with `<content>` via createModelDocument, and persist it',
+    'as given. Fails when the file exists or a client has it open.',
+    'Output is the post-save envelope as a single JSON line.',
+    '',
+    'Options:',
+    '  --server "<cmd>"      Command-line for the data-server subprocess (required).',
+    '  --uri <uri>           Document URI (required).',
+    '  --content <text>      Content to write (required). Prefix `@` to read from a file',
+    '                        (escape with `\\@` for literal `@`-leading content).',
+    '  --client-id <id>      clientId for authorship attribution. Default: hydranium-cli.',
+    '  --cwd <dir>           Working directory for the spawned child. Default: cwd.',
+    ...logHelpLines(22, 'the spawned server')
+];
+export function parseCreateArgs(args, onError = exitWithUsage) {
+    const { serverCommand, serverArgs, cwd, logLevel, logFile, logFileLevel, extra } = parseServerSpawnOptions(args, 'create', onError);
+    const { uri, content, clientId } = parseFlagOptions(extra, 'create', OWN_FLAGS, onError);
+    return {
+        serverCommand,
+        serverArgs,
+        cwd,
+        logLevel,
+        logFile,
+        logFileLevel,
+        uri: assertRequired(uri, '--uri', 'create', onError),
+        content: assertRequired(content, '--content', 'create', onError),
+        clientId
+    };
+}
+export function runCreateCommand(args) {
+    if (helpRequested(args, CREATE_FLAGS)) {
+        printHelp(CREATE_HELP);
+        return Promise.resolve();
+    }
+    return runCreate(parseCreateArgs(args));
+}
+//# sourceMappingURL=create-args.js.map

package/lib/commands/create-args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-args.js","sourceRoot":"","sources":["../../src/commands/create-args.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EACJ,cAAc,EACd,aAAa,EACb,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,uBAAuB,EACvB,SAAS,EACT,wBAAwB,EAE1B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAA6B,SAAS,EAAE,MAAM,aAAa,CAAC;AAEnE,MAAM,SAAS,GAAG,CAAC,OAAO,EAAE,WAAW,EAAE,aAAa,CAAU,CAAC;AAEjE,gEAAgE;AAChE,MAAM,CAAC,MAAM,YAAY,GAAsB,CAAC,GAAG,wBAAwB,EAAE,GAAG,SAAS,CAAC,CAAC;AAE3F,0EAA0E;AAC1E,MAAM,CAAC,MAAM,WAAW,GAAsB;IAC3C,sLAAsL;IACtL,EAAE;IACF,yFAAyF;IACzF,+DAA+D;IAC/D,yDAAyD;IACzD,EAAE;IACF,UAAU;IACV,iFAAiF;IACjF,kDAAkD;IAClD,qFAAqF;IACrF,8EAA8E;IAC9E,sFAAsF;IACtF,gFAAgF;IAChF,GAAG,YAAY,CAAC,EAAE,EAAE,oBAAoB,CAAC;CAC3C,CAAC;AAEF,MAAM,UAAU,eAAe,CAAC,IAAc,EAAE,OAAO,GAAe,aAAa;IAChF,MAAM,EAAE,aAAa,EAAE,UAAU,EAAE,GAAG,EAAE,QAAQ,EAAE,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,GAAG,uBAAuB,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IACpI,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,gBAAgB,CAAC,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;IACzF,OAAO;QACJ,aAAa;QACb,UAAU;QACV,GAAG;QACH,QAAQ;QACR,OAAO;QACP,YAAY;QACZ,GAAG,EAAE,cAAc,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC;QACpD,OAAO,EAAE,cAAc,CAAC,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,CAAC;QAChE,QAAQ;KACV,CAAC;AACL,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAc;IAC5C,IAAI,aAAa,CAAC,IAAI,EAAE,YAAY,CAAC,EAAE,CAAC;QACrC,SAAS,CAAC,WAAW,CAAC,CAAC;QACvB,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC5B,CAAC;IACD,OAAO,SAAS,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC;AAC3C,CAAC"}

package/lib/commands/create.d.ts

@@ -0,0 +1,38 @@
+/********************************************************************************
+ * 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 { TransferElement } from '@hydranium/protocol';
+import type { DataServerProtocol } from '@hydranium/protocol/data';
+import { type LogOptions } from '../log-level.js';
+/**
+ * Options for the {@link runCreate} subcommand. Creates the document at `uri`
+ * with `content` (literal text or `@<path>` for a file reference) via the
+ * data-server's `createModelDocument` RPC, and persists that text as it is.
+ * Fails when the file exists or a client has it open. Writes the post-save
+ * envelope as a single JSON line, as `save` does.
+ *
+ * `clientId` defaults to `'hydranium-cli'`. The command creates as a client
+ * session under it: it registers the session, creates the document, persists
+ * it, since a created document reaches disk only with a save, and ends the
+ * session.
+ */
+export interface CreateCommandOptions extends LogOptions {
+    readonly serverCommand: string;
+    readonly serverArgs?: readonly string[];
+    readonly cwd?: string;
+    readonly uri: string;
+    /** Literal content text, or `@<path>` to read from a file. */
+    readonly content: string;
+    readonly clientId?: string;
+    readonly write?: (line: string) => void;
+    readonly __proxyForTest?: DataServerProtocol<TransferElement>;
+    /** Test-only: override the file-reader so unit tests can stub `@<path>` expansion. */
+    readonly __readFileForTest?: (path: string) => Promise<string>;
+}
+export declare function runCreate(options: CreateCommandOptions): Promise<void>;
+//# sourceMappingURL=create.d.ts.map

package/lib/commands/create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../src/commands/create.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EAAU,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAK1D;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,oBAAqB,SAAQ,UAAU;IACrD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,8DAA8D;IAC9D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,QAAQ,CAAC,cAAc,CAAC,EAAE,kBAAkB,CAAC,eAAe,CAAC,CAAC;IAC9D,sFAAsF;IACtF,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CACjE;AAED,wBAAsB,SAAS,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqB5E"}

package/lib/commands/create.js

@@ -0,0 +1,43 @@
+/********************************************************************************
+ * 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 { logEnv } from '../log-level.js';
+import { withDataServer } from '../spawn-data-server.js';
+import { withClientSession } from './client-session.js';
+import { resolveContent } from './harness-args.js';
+export async function runCreate(options) {
+    const write = options.write ?? ((line) => process.stdout.write(line));
+    const clientId = options.clientId ?? 'hydranium-cli';
+    const text = await resolveContent(options.content, options.__readFileForTest);
+    if (options.__proxyForTest) {
+        write(`${JSON.stringify(await createPersisted(options.__proxyForTest, options.uri, clientId, text))}\n`);
+        return;
+    }
+    await withDataServer({
+        command: options.serverCommand,
+        args: options.serverArgs,
+        cwd: options.cwd,
+        env: logEnv(options)
+    }, async (server) => {
+        write(`${JSON.stringify(await createPersisted(server, options.uri, clientId, text))}\n`);
+    });
+}
+/**
+ * Create `uri` with `text` as the session `clientId` and persist it, then end
+ * the session. The persist is gated on the version the create made, so a
+ * write that landed before the create's answer or after it, another client's
+ * or an integrity repair, fails the command with a conflict and nothing
+ * persists.
+ */
+function createPersisted(server, uri, clientId, text) {
+    return withClientSession(server, clientId, async () => {
+        const created = await server.createModelDocument({ uri, clientId, text });
+        return server.persistModelDocument({ uri, clientId, baseVersion: created.created.version });
+    });
+}
+//# sourceMappingURL=create.js.map

package/lib/commands/create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.js","sourceRoot":"","sources":["../../src/commands/create.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAIlF,OAAO,EAAE,MAAM,EAAmB,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AA4BnD,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,OAA6B;IAC1D,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC,IAAY,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IAC9E,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,eAAe,CAAC;IACrD,MAAM,IAAI,GAAG,MAAM,cAAc,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAE9E,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;QAC1B,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,eAAe,CAAC,OAAO,CAAC,cAAc,EAAE,OAAO,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;QACzG,OAAO;IACV,CAAC;IAED,MAAM,cAAc,CACjB;QACG,OAAO,EAAE,OAAO,CAAC,aAAa;QAC9B,IAAI,EAAE,OAAO,CAAC,UAAU;QACxB,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,GAAG,EAAE,MAAM,CAAC,OAAO,CAAC;KACtB,EACD,KAAK,EAAC,MAAM,EAAC,EAAE;QACZ,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;IAC5F,CAAC,CACH,CAAC;AACL,CAAC;AAED;;;;;;GAMG;AACH,SAAS,eAAe,CACrB,MAAoI,EACpI,GAAW,EACX,QAAgB,EAChB,IAAY;IAEZ,OAAO,iBAAiB,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,IAAI,EAAE;QACnD,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1E,OAAO,MAAM,CAAC,oBAAoB,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,WAAW,EAAE,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAC/F,CAAC,CAAC,CAAC;AACN,CAAC"}

package/lib/commands/delete-args.d.ts

@@ -0,0 +1,17 @@
+/********************************************************************************
+ * 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 UsageError } from './harness-args.js';
+import { type DeleteCommandOptions } from './delete.js';
+/** Every flag `delete` accepts, each of which takes a value. */
+export declare const DELETE_FLAGS: readonly string[];
+/** The `--help` text, as data, held to {@link DELETE_FLAGS} by a test. */
+export declare const DELETE_HELP: readonly string[];
+export declare function parseDeleteArgs(args: string[], onError?: UsageError): DeleteCommandOptions;
+export declare function runDeleteCommand(args: string[]): Promise<void>;
+//# sourceMappingURL=delete-args.d.ts.map

package/lib/commands/delete-args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete-args.d.ts","sourceRoot":"","sources":["../../src/commands/delete-args.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EASJ,KAAK,UAAU,EACjB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,KAAK,oBAAoB,EAAa,MAAM,aAAa,CAAC;AAInE,gEAAgE;AAChE,eAAO,MAAM,YAAY,EAAE,SAAS,MAAM,EAAgD,CAAC;AAE3F,0EAA0E;AAC1E,eAAO,MAAM,WAAW,EAAE,SAAS,MAAM,EAYxC,CAAC;AAEF,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,UAA0B,GAAG,oBAAoB,CAazG;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAM9D"}

package/lib/commands/delete-args.js

@@ -0,0 +1,49 @@
+/********************************************************************************
+ * 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 { assertRequired, exitWithUsage, helpRequested, logHelpLines, parseFlagOptions, parseServerSpawnOptions, printHelp, SERVER_SPAWN_VALUE_FLAGS } from './harness-args.js';
+import { runDelete } from './delete.js';
+const OWN_FLAGS = ['--uri', '--client-id'];
+/** Every flag `delete` accepts, each of which takes a value. */
+export const DELETE_FLAGS = [...SERVER_SPAWN_VALUE_FLAGS, ...OWN_FLAGS];
+/** The `--help` text, as data, held to {@link DELETE_FLAGS} by a test. */
+export const DELETE_HELP = [
+    'Usage: hydranium-cli delete --server "<cmd>..." --uri <uri> [--client-id <id>] [--cwd <dir>] [--log-level <lvl>] [--log-file <file>] [--log-file-level <lvl>]',
+    '',
+    'Delete the document at `<uri>`, its file and then the document, via deleteModelDocument,',
+    'whatever text it holds. Prints nothing.',
+    '',
+    'Options:',
+    '  --server "<cmd>"      Command-line for the data-server subprocess (required).',
+    '  --uri <uri>           Document URI (required).',
+    '  --client-id <id>      clientId the deletion is attributed to. Default: hydranium-cli.',
+    '  --cwd <dir>           Working directory for the spawned child. Default: cwd.',
+    ...logHelpLines(22, 'the spawned server')
+];
+export function parseDeleteArgs(args, onError = exitWithUsage) {
+    const { serverCommand, serverArgs, cwd, logLevel, logFile, logFileLevel, extra } = parseServerSpawnOptions(args, 'delete', onError);
+    const { uri, clientId } = parseFlagOptions(extra, 'delete', OWN_FLAGS, onError);
+    return {
+        serverCommand,
+        serverArgs,
+        cwd,
+        logLevel,
+        logFile,
+        logFileLevel,
+        uri: assertRequired(uri, '--uri', 'delete', onError),
+        clientId
+    };
+}
+export function runDeleteCommand(args) {
+    if (helpRequested(args, DELETE_FLAGS)) {
+        printHelp(DELETE_HELP);
+        return Promise.resolve();
+    }
+    return runDelete(parseDeleteArgs(args));
+}
+//# sourceMappingURL=delete-args.js.map

package/lib/commands/delete-args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete-args.js","sourceRoot":"","sources":["../../src/commands/delete-args.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EACJ,cAAc,EACd,aAAa,EACb,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,uBAAuB,EACvB,SAAS,EACT,wBAAwB,EAE1B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAA6B,SAAS,EAAE,MAAM,aAAa,CAAC;AAEnE,MAAM,SAAS,GAAG,CAAC,OAAO,EAAE,aAAa,CAAU,CAAC;AAEpD,gEAAgE;AAChE,MAAM,CAAC,MAAM,YAAY,GAAsB,CAAC,GAAG,wBAAwB,EAAE,GAAG,SAAS,CAAC,CAAC;AAE3F,0EAA0E;AAC1E,MAAM,CAAC,MAAM,WAAW,GAAsB;IAC3C,+JAA+J;IAC/J,EAAE;IACF,0FAA0F;IAC1F,yCAAyC;IACzC,EAAE;IACF,UAAU;IACV,iFAAiF;IACjF,kDAAkD;IAClD,yFAAyF;IACzF,gFAAgF;IAChF,GAAG,YAAY,CAAC,EAAE,EAAE,oBAAoB,CAAC;CAC3C,CAAC;AAEF,MAAM,UAAU,eAAe,CAAC,IAAc,EAAE,OAAO,GAAe,aAAa;IAChF,MAAM,EAAE,aAAa,EAAE,UAAU,EAAE,GAAG,EAAE,QAAQ,EAAE,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,GAAG,uBAAuB,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IACpI,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,gBAAgB,CAAC,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;IAChF,OAAO;QACJ,aAAa;QACb,UAAU;QACV,GAAG;QACH,QAAQ;QACR,OAAO;QACP,YAAY;QACZ,GAAG,EAAE,cAAc,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC;QACpD,QAAQ;KACV,CAAC;AACL,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAc;IAC5C,IAAI,aAAa,CAAC,IAAI,EAAE,YAAY,CAAC,EAAE,CAAC;QACrC,SAAS,CAAC,WAAW,CAAC,CAAC;QACvB,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC5B,CAAC;IACD,OAAO,SAAS,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC;AAC3C,CAAC"}

package/lib/commands/delete.d.ts

@@ -0,0 +1,30 @@
+/********************************************************************************
+ * 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 { TransferElement } from '@hydranium/protocol';
+import type { DataServerProtocol } from '@hydranium/protocol/data';
+import { type LogOptions } from '../log-level.js';
+/**
+ * Options for the {@link runDelete} subcommand. Deletes the document at `uri`,
+ * its file and then the document, via the data-server's `deleteModelDocument`
+ * RPC, whatever text it holds. Prints nothing; a failed delete rejects.
+ *
+ * `clientId` defaults to `'hydranium-cli'`. The command deletes as a client
+ * session under it: it registers the session, opens the document, deletes it,
+ * and ends the session.
+ */
+export interface DeleteCommandOptions extends LogOptions {
+    readonly serverCommand: string;
+    readonly serverArgs?: readonly string[];
+    readonly cwd?: string;
+    readonly uri: string;
+    readonly clientId?: string;
+    readonly __proxyForTest?: DataServerProtocol<TransferElement>;
+}
+export declare function runDelete(options: DeleteCommandOptions): Promise<void>;
+//# sourceMappingURL=delete.d.ts.map

package/lib/commands/delete.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete.d.ts","sourceRoot":"","sources":["../../src/commands/delete.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EAAU,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAI1D;;;;;;;;GAQG;AACH,MAAM,WAAW,oBAAqB,SAAQ,UAAU;IACrD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,cAAc,CAAC,EAAE,kBAAkB,CAAC,eAAe,CAAC,CAAC;CAChE;AAED,wBAAsB,SAAS,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAe5E"}

package/lib/commands/delete.js

@@ -0,0 +1,32 @@
+/********************************************************************************
+ * 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 { logEnv } from '../log-level.js';
+import { withDataServer } from '../spawn-data-server.js';
+import { withClientSession } from './client-session.js';
+export async function runDelete(options) {
+    const clientId = options.clientId ?? 'hydranium-cli';
+    if (options.__proxyForTest) {
+        await deleteOpened(options.__proxyForTest, options.uri, clientId);
+        return;
+    }
+    await withDataServer({
+        command: options.serverCommand,
+        args: options.serverArgs,
+        cwd: options.cwd,
+        env: logEnv(options)
+    }, server => deleteOpened(server, options.uri, clientId));
+}
+/** Open `uri` as the session `clientId` and delete it, then end the session. */
+function deleteOpened(server, uri, clientId) {
+    return withClientSession(server, clientId, async () => {
+        await server.openModelDocument({ uri, clientId });
+        await server.deleteModelDocument({ uri, clientId, baseVersion: 'any' });
+    });
+}
+//# sourceMappingURL=delete.js.map

package/lib/commands/delete.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete.js","sourceRoot":"","sources":["../../src/commands/delete.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAIlF,OAAO,EAAE,MAAM,EAAmB,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAoBxD,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,OAA6B;IAC1D,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,eAAe,CAAC;IACrD,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;QAC1B,MAAM,YAAY,CAAC,OAAO,CAAC,cAAc,EAAE,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QAClE,OAAO;IACV,CAAC;IACD,MAAM,cAAc,CACjB;QACG,OAAO,EAAE,OAAO,CAAC,aAAa;QAC9B,IAAI,EAAE,OAAO,CAAC,UAAU;QACxB,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,GAAG,EAAE,MAAM,CAAC,OAAO,CAAC;KACtB,EACD,MAAM,CAAC,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC,CACvD,CAAC;AACL,CAAC;AAED,gFAAgF;AAChF,SAAS,YAAY,CAClB,MAAiI,EACjI,GAAW,EACX,QAAgB;IAEhB,OAAO,iBAAiB,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,IAAI,EAAE;QACnD,MAAM,MAAM,CAAC,iBAAiB,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,CAAC;QAClD,MAAM,MAAM,CAAC,mBAAmB,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,CAAC;IAC3E,CAAC,CAAC,CAAC;AACN,CAAC"}

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

@@ -0,0 +1,49 @@
+/********************************************************************************
+ * 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 type { SourceFile } from 'ts-morph';
+/** Inputs for {@link emitAstBuilder}, resolved by the transfer-model command. */
+export interface EmitAstBuilderOptions {
+    /** Destination path for the generated builder module. */
+    outFile: string;
+    /** Path to the Langium-generated AST file the builder imports from. */
+    astFile: 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 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 declare function emitAstBuilder(astSource: SourceFile, options: EmitAstBuilderOptions): boolean;
+/**
+ * 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 declare function buildAstBuilderSource(astSource: SourceFile, options: EmitAstBuilderOptions): string | undefined;
+//# sourceMappingURL=generate-ast-builder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"generate-ast-builder.d.ts","sourceRoot":"","sources":["../../src/commands/generate-ast-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAIlF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C,iFAAiF;AACjF,MAAM,WAAW,qBAAqB;IACnC,yDAAyD;IACzD,OAAO,EAAE,MAAM,CAAC;IAChB,uEAAuE;IACvE,OAAO,EAAE,MAAM,CAAC;IAChB,2EAA2E;IAC3E,UAAU,EAAE,MAAM,CAAC;IACnB,gEAAgE;IAChE,YAAY,EAAE,MAAM,CAAC;CACvB;AAyBD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,UAAU,EAAE,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAc7F;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,UAAU,EAAE,OAAO,EAAE,qBAAqB,GAAG,MAAM,GAAG,SAAS,CAqB/G"}

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

@@ -0,0 +1,200 @@
+/********************************************************************************
+ * 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';
+/**
+ * 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';
+}
+/**
+ * Module specifier for the AST file as seen from the generated module's own
+ * directory. Emitted with a `.js` extension and posix separators because the
+ * output is ESM TypeScript, where the specifier names the compiled sibling.
+ */
+function relativeImportPath(outFile, astFile) {
+    const relative = path.relative(path.dirname(path.resolve(outFile)), path.resolve(astFile));
+    const posix = relative.split(path.sep).join('/').replace(/\.ts$/, '.js');
+    return posix.startsWith('.') ? posix : `./${posix}`;
+}
+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