@hydranium/core 1.0.0-next.10

package/lib/langium/serialization/abstract-serializer.js.map

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

package/lib/langium/serialization/index.d.ts

@@ -0,0 +1,14 @@
+/********************************************************************************
+ * 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
+ ********************************************************************************/
+export * from './abstract-serializer.js';
+export * from './json-serializer.js';
+export * from './serialization-util.js';
+export * from './serializer.js';
+export * from './yaml-serializer.js';
+//# sourceMappingURL=index.d.ts.map

package/lib/langium/serialization/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/langium/serialization/index.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC"}

package/lib/langium/serialization/index.js

@@ -0,0 +1,14 @@
+/********************************************************************************
+ * 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
+ ********************************************************************************/
+export * from './abstract-serializer.js';
+export * from './json-serializer.js';
+export * from './serialization-util.js';
+export * from './serializer.js';
+export * from './yaml-serializer.js';
+//# sourceMappingURL=index.js.map

package/lib/langium/serialization/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/langium/serialization/index.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC"}

package/lib/langium/serialization/json-serializer.d.ts

@@ -0,0 +1,106 @@
+/********************************************************************************
+ * 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 MaybePromise, type TransferElement } from '@hydranium/protocol';
+import { type AstNode } from '@hydranium/langium';
+import { type HydraniumLanguageServices } from '../language-module.js';
+import { AbstractSerializer, type AbstractSerializerOptions } from './abstract-serializer.js';
+/**
+ * Options for {@link JsonSerializer}. Extends the format-agnostic
+ * {@link AbstractSerializerOptions} with JSON-specific style settings.
+ */
+export interface JsonSerializerOptions extends AbstractSerializerOptions {
+    /**
+     * Indentation policy:
+     * - a number — spaces per level (default 2)
+     * - `'tab'` — single tab character per level
+     * - `false` — compact output, no newlines or indent whitespace
+     */
+    readonly indent?: number | 'tab' | false;
+    /**
+     * How to encode cross-references in the output:
+     * - `'object-wrapper'` (default) — emit as `{ "$ref": "<id>" }`. Disambiguates
+     *   references from plain string values without requiring schema knowledge
+     *   on the consumer.
+     * - `'string'` — emit as a bare string value: `"<id>"`. Consumer must know
+     *   from a schema or other context which properties are references.
+     */
+    readonly referenceEncoding?: 'object-wrapper' | 'string';
+}
+/**
+ * Hand-written grammar-aware AST → JSON serializer.
+ *
+ * Sibling of `YamlSerializer` sharing the
+ * format-agnostic dispatch in {@link AbstractSerializer}. Use cases:
+ *
+ * - Deterministic test snapshots — no YAML whitespace ambiguity.
+ * - Alternative wire format for the model-server RPC — smaller payload,
+ *   faster client parse via native `JSON.parse`.
+ * - Debug dumps of AST or transfer-model trees.
+ *
+ * The grammar-side defaults (property order, references-as-objects flag)
+ * and the format-style options (indent, reference encoding) are tuned
+ * independently — the same `propertyOrder` map used by a YAML serializer
+ * drives the property layout of the JSON output.
+ *
+ * **Note on `unquotedProperties` (YAML)**: JSON cannot emit bare string
+ * values, so the equivalent YAML notion does not exist here. Grammar
+ * terminals that YAML serializes unquoted (e.g. `kind: one-to-many`) become
+ * quoted JSON strings (`"kind": "one-to-many"`).
+ */
+export declare class JsonSerializer<TAst extends AstNode = AstNode, TTransfer extends TransferElement = TransferElement> extends AbstractSerializer<TAst, TTransfer> {
+    /** Default spaces per indentation level when `indent` is omitted. */
+    static readonly DEFAULT_INDENT = 2;
+    /** Default reference encoding when `referenceEncoding` is omitted. */
+    static readonly DEFAULT_REFERENCE_ENCODING: "object-wrapper";
+    /** Narrows the inherited {@link AbstractSerializer.options} field to the JSON-specific shape. */
+    protected readonly options: JsonSerializerOptions;
+    protected readonly compact: boolean;
+    protected readonly indentUnit: string;
+    protected readonly referenceEncoding: 'object-wrapper' | 'string';
+    constructor(services: HydraniumLanguageServices, options?: JsonSerializerOptions);
+    /**
+     * Serialize an AST or transfer-model node as a JSON object. Properties are
+     * emitted in grammar-declared order ({@link getOrderedPropertyNames}); empty
+     * or default-valued properties are skipped per the shared
+     * {@link shouldSkipProperty} rules.
+     *
+     * @param _isArrayElement unused — JSON does not need the YAML
+     *        `- ` alignment hint; nested objects nest the same way regardless
+     *        of array context.
+     */
+    protected serializeNode(node: AstNode | Record<string, unknown>, indentationLevel: number, _isArrayElement?: boolean): MaybePromise<string>;
+    /**
+     * Iterate `propNames` from `startIndex`, serialise each property, and
+     * accumulate the resulting JSON object entries. Stays on the sync fast
+     * path while every {@link serializePropertyValue} returns a string; the
+     * moment one returns a Promise, switches to a `.then`-chained tail. Keeps
+     * the all-sync case Promise-free even though the declared return type is
+     * the union.
+     */
+    protected collectObjectEntries(node: AstNode | Record<string, unknown>, nodeType: string, propNames: readonly string[], indentationLevel: number, entries: (readonly [string, string])[], startIndex: number): MaybePromise<string>;
+    /** Serialize an array of non-reference values as a JSON array. */
+    protected serializeArray(items: unknown[], nodeType: string, key: string, indentationLevel: number): MaybePromise<string>;
+    /** Same sync-or-async tail pattern as {@link collectObjectEntries}, for array elements. */
+    protected collectArrayElements(items: unknown[], nodeType: string, key: string, indentationLevel: number, elements: string[], startIndex: number): MaybePromise<string>;
+    /** Serialize an array of reference values (Langium References or plain strings) as a JSON array. */
+    protected serializeReferenceArray(items: unknown[], indentationLevel: number): MaybePromise<string>;
+    /** Same sync-or-async tail pattern as {@link collectArrayElements}, for reference-array elements. */
+    protected collectReferenceArrayElements(items: unknown[], indentationLevel: number, elements: string[], startIndex: number): MaybePromise<string>;
+    /**
+     * Format a cross-reference value per {@link JsonSerializerOptions.referenceEncoding}.
+     * Default is an object wrapper `{ "$ref": "<id>" }`; the alternative is a
+     * bare string `"<id>"`. Subclasses may override for adopter-specific
+     * encodings.
+     */
+    protected formatReferenceValue(value: string): MaybePromise<string>;
+    protected composeObject(entries: readonly (readonly [string, string])[], indentationLevel: number): string;
+    protected composeArray(elements: readonly string[], indentationLevel: number): string;
+    protected indent(level: number): string;
+}
+//# sourceMappingURL=json-serializer.d.ts.map

package/lib/langium/serialization/json-serializer.d.ts.map

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

package/lib/langium/serialization/json-serializer.js

@@ -0,0 +1,198 @@
+/********************************************************************************
+ * 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 { isPromiseLike } from '@hydranium/protocol';
+import { AbstractSerializer } from './abstract-serializer.js';
+/**
+ * Hand-written grammar-aware AST → JSON serializer.
+ *
+ * Sibling of `YamlSerializer` sharing the
+ * format-agnostic dispatch in {@link AbstractSerializer}. Use cases:
+ *
+ * - Deterministic test snapshots — no YAML whitespace ambiguity.
+ * - Alternative wire format for the model-server RPC — smaller payload,
+ *   faster client parse via native `JSON.parse`.
+ * - Debug dumps of AST or transfer-model trees.
+ *
+ * The grammar-side defaults (property order, references-as-objects flag)
+ * and the format-style options (indent, reference encoding) are tuned
+ * independently — the same `propertyOrder` map used by a YAML serializer
+ * drives the property layout of the JSON output.
+ *
+ * **Note on `unquotedProperties` (YAML)**: JSON cannot emit bare string
+ * values, so the equivalent YAML notion does not exist here. Grammar
+ * terminals that YAML serializes unquoted (e.g. `kind: one-to-many`) become
+ * quoted JSON strings (`"kind": "one-to-many"`).
+ */
+export class JsonSerializer extends AbstractSerializer {
+    /** Default spaces per indentation level when `indent` is omitted. */
+    static DEFAULT_INDENT = 2;
+    /** Default reference encoding when `referenceEncoding` is omitted. */
+    static DEFAULT_REFERENCE_ENCODING = 'object-wrapper';
+    compact;
+    indentUnit;
+    referenceEncoding;
+    constructor(services, options = {}) {
+        super(services, options);
+        const indent = options.indent ?? JsonSerializer.DEFAULT_INDENT;
+        this.compact = indent === false;
+        this.indentUnit = indent === false ? '' : indent === 'tab' ? '\t' : ' '.repeat(indent);
+        this.referenceEncoding = options.referenceEncoding ?? JsonSerializer.DEFAULT_REFERENCE_ENCODING;
+    }
+    /**
+     * Serialize an AST or transfer-model node as a JSON object. Properties are
+     * emitted in grammar-declared order ({@link getOrderedPropertyNames}); empty
+     * or default-valued properties are skipped per the shared
+     * {@link shouldSkipProperty} rules.
+     *
+     * @param _isArrayElement unused — JSON does not need the YAML
+     *        `- ` alignment hint; nested objects nest the same way regardless
+     *        of array context.
+     */
+    serializeNode(node, indentationLevel, _isArrayElement = false) {
+        const nodeType = node.$type;
+        const propNames = this.getOrderedPropertyNames(node, nodeType);
+        return this.collectObjectEntries(node, nodeType, propNames, indentationLevel, [], 0);
+    }
+    /**
+     * Iterate `propNames` from `startIndex`, serialise each property, and
+     * accumulate the resulting JSON object entries. Stays on the sync fast
+     * path while every {@link serializePropertyValue} returns a string; the
+     * moment one returns a Promise, switches to a `.then`-chained tail. Keeps
+     * the all-sync case Promise-free even though the declared return type is
+     * the union.
+     */
+    collectObjectEntries(node, nodeType, propNames, indentationLevel, entries, startIndex) {
+        for (let i = startIndex; i < propNames.length; i++) {
+            const prop = propNames[i];
+            const propValue = node[prop];
+            if (this.shouldSkipProperty(nodeType, prop, propValue)) {
+                continue;
+            }
+            const maybe = this.serializePropertyValue(nodeType, prop, propValue, indentationLevel + 1);
+            if (isPromiseLike(maybe)) {
+                const resumeAt = i + 1;
+                return maybe.then(serialized => {
+                    if (serialized !== undefined) {
+                        entries.push([prop, serialized]);
+                    }
+                    return this.collectObjectEntries(node, nodeType, propNames, indentationLevel, entries, resumeAt);
+                });
+            }
+            if (maybe !== undefined) {
+                entries.push([prop, maybe]);
+            }
+        }
+        if (entries.length === 0) {
+            return '{}';
+        }
+        return this.composeObject(entries, indentationLevel);
+    }
+    /** Serialize an array of non-reference values as a JSON array. */
+    serializeArray(items, nodeType, key, indentationLevel) {
+        return this.collectArrayElements(items, nodeType, key, indentationLevel, [], 0);
+    }
+    /** Same sync-or-async tail pattern as {@link collectObjectEntries}, for array elements. */
+    collectArrayElements(items, nodeType, key, indentationLevel, elements, startIndex) {
+        for (let i = startIndex; i < items.length; i++) {
+            const item = items[i];
+            if (item === undefined) {
+                continue;
+            }
+            const maybe = this.serializePropertyValue(nodeType, key, item, indentationLevel + 1, /* isArrayElement */ true);
+            if (isPromiseLike(maybe)) {
+                const resumeAt = i + 1;
+                return maybe.then(serialized => {
+                    if (serialized !== undefined) {
+                        elements.push(serialized);
+                    }
+                    return this.collectArrayElements(items, nodeType, key, indentationLevel, elements, resumeAt);
+                });
+            }
+            if (maybe !== undefined) {
+                elements.push(maybe);
+            }
+        }
+        return this.composeArray(elements, indentationLevel);
+    }
+    /** Serialize an array of reference values (Langium References or plain strings) as a JSON array. */
+    serializeReferenceArray(items, indentationLevel) {
+        return this.collectReferenceArrayElements(items, indentationLevel, [], 0);
+    }
+    /** Same sync-or-async tail pattern as {@link collectArrayElements}, for reference-array elements. */
+    collectReferenceArrayElements(items, indentationLevel, elements, startIndex) {
+        for (let i = startIndex; i < items.length; i++) {
+            const item = items[i];
+            if (item === undefined) {
+                continue;
+            }
+            const refText = this.serializeReferenceText(item);
+            let maybe;
+            if (refText !== undefined) {
+                maybe = this.formatReferenceValue(refText);
+            }
+            else if (typeof item === 'string') {
+                maybe = this.formatReferenceValue(item);
+            }
+            if (maybe === undefined) {
+                continue;
+            }
+            if (isPromiseLike(maybe)) {
+                const resumeAt = i + 1;
+                return maybe.then(formatted => {
+                    elements.push(formatted);
+                    return this.collectReferenceArrayElements(items, indentationLevel, elements, resumeAt);
+                });
+            }
+            elements.push(maybe);
+        }
+        return this.composeArray(elements, indentationLevel);
+    }
+    /**
+     * Format a cross-reference value per {@link JsonSerializerOptions.referenceEncoding}.
+     * Default is an object wrapper `{ "$ref": "<id>" }`; the alternative is a
+     * bare string `"<id>"`. Subclasses may override for adopter-specific
+     * encodings.
+     */
+    formatReferenceValue(value) {
+        if (this.referenceEncoding === 'string') {
+            return JSON.stringify(value);
+        }
+        if (this.compact) {
+            return `{${JSON.stringify('$ref')}:${JSON.stringify(value)}}`;
+        }
+        return `{ ${JSON.stringify('$ref')}: ${JSON.stringify(value)} }`;
+    }
+    composeObject(entries, indentationLevel) {
+        const inner = this.indent(indentationLevel + 1);
+        const outer = this.indent(indentationLevel);
+        const kvSep = this.compact ? ':' : ': ';
+        const entrySep = this.compact ? ',' : `,\n${inner}`;
+        const open = this.compact ? '{' : `{\n${inner}`;
+        const close = this.compact ? '}' : `\n${outer}}`;
+        return open + entries.map(([key, value]) => `${JSON.stringify(key)}${kvSep}${value}`).join(entrySep) + close;
+    }
+    composeArray(elements, indentationLevel) {
+        if (elements.length === 0) {
+            return '[]';
+        }
+        const inner = this.indent(indentationLevel + 1);
+        const outer = this.indent(indentationLevel);
+        if (this.compact) {
+            return `[${elements.join(',')}]`;
+        }
+        return `[\n${inner}${elements.join(`,\n${inner}`)}\n${outer}]`;
+    }
+    indent(level) {
+        if (this.compact || this.indentUnit === '') {
+            return '';
+        }
+        return this.indentUnit.repeat(level);
+    }
+}
+//# sourceMappingURL=json-serializer.js.map

package/lib/langium/serialization/json-serializer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-serializer.js","sourceRoot":"","sources":["../../../src/langium/serialization/json-serializer.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EAAE,aAAa,EAA2C,MAAM,qBAAqB,CAAC;AAG7F,OAAO,EAAE,kBAAkB,EAAkC,MAAM,0BAA0B,CAAC;AAyB9F;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,OAAO,cAAoG,SAAQ,kBAGxH;IACE,qEAAqE;IACrE,MAAM,CAAU,cAAc,GAAG,CAAC,CAAC;IACnC,sEAAsE;IACtE,MAAM,CAAU,0BAA0B,GAAG,gBAAyB,CAAC;IAKpD,OAAO,CAAU;IACjB,UAAU,CAAS;IACnB,iBAAiB,CAA8B;IAElE,YAAY,QAAmC,EAAE,UAAiC,EAAE;QACjF,KAAK,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACzB,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,cAAc,CAAC,cAAc,CAAC;QAC/D,IAAI,CAAC,OAAO,GAAG,MAAM,KAAK,KAAK,CAAC;QAChC,IAAI,CAAC,UAAU,GAAG,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACvF,IAAI,CAAC,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,IAAI,cAAc,CAAC,0BAA0B,CAAC;IACnG,CAAC;IAED;;;;;;;;;OASG;IACgB,aAAa,CAC7B,IAAuC,EACvC,gBAAwB,EACxB,eAAe,GAAG,KAAK;QAEvB,MAAM,QAAQ,GAAI,IAAgB,CAAC,KAAK,CAAC;QACzC,MAAM,SAAS,GAAG,IAAI,CAAC,uBAAuB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAC/D,OAAO,IAAI,CAAC,oBAAoB,CAAC,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,gBAAgB,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;IACxF,CAAC;IAED;;;;;;;OAOG;IACO,oBAAoB,CAC3B,IAAuC,EACvC,QAAgB,EAChB,SAA4B,EAC5B,gBAAwB,EACxB,OAAsC,EACtC,UAAkB;QAElB,KAAK,IAAI,CAAC,GAAG,UAAU,EAAE,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAClD,MAAM,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;YAC1B,MAAM,SAAS,GAAI,IAAuB,CAAC,IAAI,CAAC,CAAC;YACjD,IAAI,IAAI,CAAC,kBAAkB,CAAC,QAAQ,EAAE,IAAI,EAAE,SAAS,CAAC,EAAE,CAAC;gBACtD,SAAS;YACZ,CAAC;YACD,MAAM,KAAK,GAAG,IAAI,CAAC,sBAAsB,CAAC,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,gBAAgB,GAAG,CAAC,CAAC,CAAC;YAC3F,IAAI,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;gBACxB,MAAM,QAAQ,GAAG,CAAC,GAAG,CAAC,CAAC;gBACvB,OAAO,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE;oBAC5B,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;wBAC5B,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC;oBACpC,CAAC;oBACD,OAAO,IAAI,CAAC,oBAAoB,CAAC,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,gBAAgB,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;gBACpG,CAAC,CAAC,CAAC;YACN,CAAC;YACD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACvB,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;YAC/B,CAAC;QACJ,CAAC;QACD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO,IAAI,CAAC;QACf,CAAC;QACD,OAAO,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC;IACxD,CAAC;IAED,kEAAkE;IAC/C,cAAc,CAAC,KAAgB,EAAE,QAAgB,EAAE,GAAW,EAAE,gBAAwB;QACxG,OAAO,IAAI,CAAC,oBAAoB,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,gBAAgB,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;IACnF,CAAC;IAED,2FAA2F;IACjF,oBAAoB,CAC3B,KAAgB,EAChB,QAAgB,EAChB,GAAW,EACX,gBAAwB,EACxB,QAAkB,EAClB,UAAkB;QAElB,KAAK,IAAI,CAAC,GAAG,UAAU,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC9C,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACtB,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;gBACtB,SAAS;YACZ,CAAC;YACD,MAAM,KAAK,GAAG,IAAI,CAAC,sBAAsB,CAAC,QAAQ,EAAE,GAAG,EAAE,IAAI,EAAE,gBAAgB,GAAG,CAAC,EAAE,oBAAoB,CAAC,IAAI,CAAC,CAAC;YAChH,IAAI,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;gBACxB,MAAM,QAAQ,GAAG,CAAC,GAAG,CAAC,CAAC;gBACvB,OAAO,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE;oBAC5B,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;wBAC5B,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;oBAC7B,CAAC;oBACD,OAAO,IAAI,CAAC,oBAAoB,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,gBAAgB,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;gBAChG,CAAC,CAAC,CAAC;YACN,CAAC;YACD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACvB,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACxB,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC;IACxD,CAAC;IAED,oGAAoG;IACjF,uBAAuB,CAAC,KAAgB,EAAE,gBAAwB;QAClF,OAAO,IAAI,CAAC,6BAA6B,CAAC,KAAK,EAAE,gBAAgB,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;IAC7E,CAAC;IAED,qGAAqG;IAC3F,6BAA6B,CACpC,KAAgB,EAChB,gBAAwB,EACxB,QAAkB,EAClB,UAAkB;QAElB,KAAK,IAAI,CAAC,GAAG,UAAU,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC9C,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACtB,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;gBACtB,SAAS;YACZ,CAAC;YACD,MAAM,OAAO,GAAG,IAAI,CAAC,sBAAsB,CAAC,IAAI,CAAC,CAAC;YAClD,IAAI,KAAuC,CAAC;YAC5C,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;gBACzB,KAAK,GAAG,IAAI,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC;YAC9C,CAAC;iBAAM,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACnC,KAAK,GAAG,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC;YAC3C,CAAC;YACD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACvB,SAAS;YACZ,CAAC;YACD,IAAI,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;gBACxB,MAAM,QAAQ,GAAG,CAAC,GAAG,CAAC,CAAC;gBACvB,OAAO,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE;oBAC3B,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;oBACzB,OAAO,IAAI,CAAC,6BAA6B,CAAC,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;gBAC1F,CAAC,CAAC,CAAC;YACN,CAAC;YACD,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACxB,CAAC;QACD,OAAO,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC;IACxD,CAAC;IAED;;;;;OAKG;IACgB,oBAAoB,CAAC,KAAa;QAClD,IAAI,IAAI,CAAC,iBAAiB,KAAK,QAAQ,EAAE,CAAC;YACvC,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC;QACD,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAChB,OAAO,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC;QACjE,CAAC;QACD,OAAO,KAAK,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC;IACpE,CAAC;IAES,aAAa,CAAC,OAA+C,EAAE,gBAAwB;QAC9F,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,gBAAgB,GAAG,CAAC,CAAC,CAAC;QAChD,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;QAC5C,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;QACxC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,KAAK,EAAE,CAAC;QACpD,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,KAAK,EAAE,CAAC;QAChD,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,KAAK,GAAG,CAAC;QACjD,OAAO,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,KAAK,GAAG,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAC;IAChH,CAAC;IAES,YAAY,CAAC,QAA2B,EAAE,gBAAwB;QACzE,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,IAAI,CAAC;QACf,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,gBAAgB,GAAG,CAAC,CAAC,CAAC;QAChD,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;QAC5C,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAChB,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;QACpC,CAAC;QACD,OAAO,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,MAAM,KAAK,EAAE,CAAC,KAAK,KAAK,GAAG,CAAC;IAClE,CAAC;IAES,MAAM,CAAC,KAAa;QAC3B,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,UAAU,KAAK,EAAE,EAAE,CAAC;YAC1C,OAAO,EAAE,CAAC;QACb,CAAC;QACD,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACxC,CAAC"}

package/lib/langium/serialization/serialization-util.d.ts

@@ -0,0 +1,29 @@
+/********************************************************************************
+ * 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 AstReflection } from '@hydranium/langium';
+/**
+ * Whether `(type, property)` declares a Langium cross-reference. Driven by the
+ * generated AST reflection metadata: a property is a reference when its
+ * `propertyMetaData` carries a `referenceType`.
+ *
+ * Used by serializers to dispatch reference values (Langium `Reference` objects
+ * or transfer-model plain string IDs) through reference-formatting paths
+ * instead of generic value serialization.
+ */
+export declare function isReferenceProperty(reflection: AstReflection, type: string, property: string): boolean;
+/**
+ * Whether the given value equals the property's grammar-declared default. Used
+ * to skip default-valued properties during serialization (smaller wire shape,
+ * cleaner round-trip).
+ *
+ * Reads `defaultValue` from the Langium reflection metadata; values without a
+ * declared default never compare equal here.
+ */
+export declare function isDefaultValue(reflection: AstReflection, type: string, property: string, value: unknown): boolean;
+//# sourceMappingURL=serialization-util.d.ts.map

package/lib/langium/serialization/serialization-util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialization-util.d.ts","sourceRoot":"","sources":["../../../src/langium/serialization/serialization-util.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAItG;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAKjH"}

package/lib/langium/serialization/serialization-util.js

@@ -0,0 +1,37 @@
+/********************************************************************************
+ * 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
+ ********************************************************************************/
+/**
+ * Whether `(type, property)` declares a Langium cross-reference. Driven by the
+ * generated AST reflection metadata: a property is a reference when its
+ * `propertyMetaData` carries a `referenceType`.
+ *
+ * Used by serializers to dispatch reference values (Langium `Reference` objects
+ * or transfer-model plain string IDs) through reference-formatting paths
+ * instead of generic value serialization.
+ */
+export function isReferenceProperty(reflection, type, property) {
+    const typeMetaData = reflection.getTypeMetaData(type);
+    const propertyMetaData = typeMetaData.properties[property];
+    return propertyMetaData !== undefined && 'referenceType' in propertyMetaData;
+}
+/**
+ * Whether the given value equals the property's grammar-declared default. Used
+ * to skip default-valued properties during serialization (smaller wire shape,
+ * cleaner round-trip).
+ *
+ * Reads `defaultValue` from the Langium reflection metadata; values without a
+ * declared default never compare equal here.
+ */
+export function isDefaultValue(reflection, type, property, value) {
+    const typeMetaData = reflection.getTypeMetaData(type);
+    const propertyMetaData = typeMetaData.properties[property];
+    const defaultValue = propertyMetaData?.defaultValue;
+    return defaultValue !== undefined && value === defaultValue;
+}
+//# sourceMappingURL=serialization-util.js.map

package/lib/langium/serialization/serialization-util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialization-util.js","sourceRoot":"","sources":["../../../src/langium/serialization/serialization-util.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAIlF;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB,CAAC,UAAyB,EAAE,IAAY,EAAE,QAAgB;IAC1F,MAAM,YAAY,GAAG,UAAU,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;IACtD,MAAM,gBAAgB,GAAG,YAAY,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IAC3D,OAAO,gBAAgB,KAAK,SAAS,IAAI,eAAe,IAAI,gBAAgB,CAAC;AAChF,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAAC,UAAyB,EAAE,IAAY,EAAE,QAAgB,EAAE,KAAc;IACrG,MAAM,YAAY,GAAG,UAAU,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;IACtD,MAAM,gBAAgB,GAAG,YAAY,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IAC3D,MAAM,YAAY,GAAG,gBAAgB,EAAE,YAAY,CAAC;IACpD,OAAO,YAAY,KAAK,SAAS,IAAI,KAAK,KAAK,YAAY,CAAC;AAC/D,CAAC"}

package/lib/langium/serialization/serializer.d.ts

@@ -0,0 +1,66 @@
+/********************************************************************************
+ * 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 MaybePromise, type TransferElement } from '@hydranium/protocol';
+import type { AstNode } from '@hydranium/langium';
+/**
+ * Serializes a semantic-model element back to its source-text representation.
+ *
+ * Implementations must round-trip: `parse(serializeAst(model))` should yield
+ * the same AST shape as `model` (modulo CST-node noise that doesn't round-trip
+ * cleanly).
+ *
+ * **Two shapes, two methods.** The framework recognises two distinct shapes for
+ * a semantic-model element — both flow through the same property walker but
+ * the interface keeps them on separate methods so the type system stays honest:
+ *
+ * - {@link serializeAst} consumes a Langium AST element — cross-references are
+ *   `Reference<T>` objects with `$refText`, `ref`, etc.
+ * - {@link serializeTransfer} consumes a transfer-model element —
+ *   structurally equivalent to the AST but with cross-references represented
+ *   as plain strings (the names that `Reference.$refText` would return).
+ *
+ * Adopters who only have AST inputs use {@link serializeAst} and leave the
+ * default {@link serializeTransfer} (which delegates back) untouched. Adopters
+ * who need shape-specific formatting override both independently.
+ *
+ * Neither method requires the input to be the grammar root — the walker is
+ * recursive and shape-agnostic, so any element from either tree serializes
+ * correctly. Callers typically pass a root (that's what
+ * `ModelService.serialize`
+ * and the GLSP source-model flows hand in), but sub-tree serialization works
+ * for unit tests, snippet rendering, and tooling.
+ */
+export interface Serializer<TAst extends AstNode = AstNode, TTransfer extends TransferElement = TransferElement> {
+    /**
+     * Serialize a Langium AST element — cross-references are `Reference<T>`
+     * objects. Typically the grammar root, but any AST node works.
+     *
+     * Returns {@link MaybePromise} so adopters with async needs (remote schema
+     * lookup, external canonical-value resolution, third-party async formatter)
+     * can return a `Promise<string>`. Sync implementations return a bare string
+     * directly — the union widening is non-breaking. Callers gate with
+     * `isPromiseLike` or naive `await` per the framework house
+     * style (guard in hot loops, naive `await` for one-shot calls).
+     */
+    serializeAst(model: TAst): MaybePromise<string>;
+    /**
+     * Serialize a transfer-model element — cross-references are plain `string`
+     * ids (the values `Reference.$refText` would return on an AST node).
+     * Typically the transfer root, but any transfer element works.
+     *
+     * The default implementation on `AbstractSerializer`
+     * delegates to {@link serializeAst} because the underlying property walker
+     * is shape-agnostic — both shapes flow through the same
+     * `serializePropertyValue` dispatch with the same `serializeReferenceText` read.
+     * Adopters who need shape-specific formatting override this method
+     * independently.
+     */
+    serializeTransfer(model: TTransfer): MaybePromise<string>;
+}
+//# sourceMappingURL=serializer.d.ts.map

package/lib/langium/serialization/serializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializer.d.ts","sourceRoot":"","sources":["../../../src/langium/serialization/serializer.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC9E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAElD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,WAAW,UAAU,CAAC,IAAI,SAAS,OAAO,GAAG,OAAO,EAAE,SAAS,SAAS,eAAe,GAAG,eAAe;IAC5G;;;;;;;;;;OAUG;IACH,YAAY,CAAC,KAAK,EAAE,IAAI,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IAEhD;;;;;;;;;;;OAWG;IACH,iBAAiB,CAAC,KAAK,EAAE,SAAS,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;CAC5D"}

package/lib/langium/serialization/serializer.js

@@ -0,0 +1,10 @@
+/********************************************************************************
+ * 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
+ ********************************************************************************/
+export {};
+//# sourceMappingURL=serializer.js.map

package/lib/langium/serialization/serializer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializer.js","sourceRoot":"","sources":["../../../src/langium/serialization/serializer.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF"}