@hydranium/core 1.0.0-next.10

package/lib/testing/fake-document.d.ts

@@ -0,0 +1,71 @@
+/********************************************************************************
+ * 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 { DocumentState, type AstNode, type LangiumDocument, type URI } from '@hydranium/langium';
+/**
+ * Build a typed AST-node fixture for unit tests.
+ *
+ * Langium AST node types are nominal interfaces generated from the grammar, so
+ * an object literal can never structurally satisfy one — every test that needs
+ * a node otherwise writes `{ $type: 'X', … } as unknown as SomeNode`. This
+ * helper encapsulates that single unavoidable cast in one audited place and
+ * hands back a value typed as `T`, so call sites stay cast-free and
+ * intention-revealing.
+ *
+ * It deliberately does NOT set the `$synthetic` marker: a test fixture is not a
+ * framework synthetic node, and marking it would change scope/index behaviour.
+ * A test that wants a genuine synthetic node calls `markSynthetic` explicitly.
+ *
+ * @param node the node shape — `$type` is required; every other property is a
+ *   value the test cares about (`$container`, cross-reference values, internal
+ *   `_id` fields, …). The object is returned by reference, not copied.
+ */
+export declare function makeFakeAstNode<TAst extends AstNode = AstNode>(node: {
+    $type: string;
+} & Record<string, unknown>): TAst;
+/**
+ * Options for {@link makeFakeDocument}.
+ *
+ * `text` defaults to a cycle-safe JSON rendering of `root` so fingerprint-based
+ * dedup paths (e.g. `DataServer.dispatchPhaseEvent`) have a deterministic
+ * input — passing an explicit value is only necessary when a test asserts on
+ * the document text or relies on a grammar-realistic serialisation.
+ */
+export interface FakeDocumentOptions<TAst extends AstNode, TDiagnostic> {
+    text?: string;
+    version?: number;
+    state?: DocumentState;
+    diagnostics?: TDiagnostic[];
+    /** Override the parserErrors / lexerErrors arrays returned from `parseResult`. */
+    parseResult?: Partial<LangiumDocument<TAst>['parseResult']>;
+    /**
+     * Cross-reference list. Defaults to `[]`. Loosely typed because a full
+     * Langium `Reference` is not constructible in a unit test, so tests
+     * exercising CST / reference paths pass the minimal shape they need.
+     */
+    references?: readonly unknown[];
+    /**
+     * Full `textDocument` override for tests that need a real `TextDocument` —
+     * the LSP position API (`positionAt` / `offsetAt`), which the minimal
+     * default lacks. Defaults to a `{ uri, version, getText }` shell.
+     */
+    textDocument?: LangiumDocument<TAst>['textDocument'];
+}
+/**
+ * Build a {@link LangiumDocument} shell suitable for stub services trees in
+ * unit tests. The returned document satisfies the structural shape Langium
+ * production code reads from — `uri`, `parseResult`, `textDocument`,
+ * `diagnostics`, `state` — without spinning up a real grammar.
+ *
+ * Default state is {@link DocumentState.Validated} so callers exercising the
+ * post-build read path (`getDocument` → assert AST) work without explicit
+ * staging. Override via `options.state` for tests that gate on earlier
+ * phases.
+ */
+export declare function makeFakeDocument<TAst extends AstNode = AstNode, TDiagnostic = unknown>(uri: string | URI, root: TAst, options?: FakeDocumentOptions<TAst, TDiagnostic>): LangiumDocument<TAst>;
+//# sourceMappingURL=fake-document.d.ts.map

package/lib/testing/fake-document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fake-document.d.ts","sourceRoot":"","sources":["../../src/testing/fake-document.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EAAE,aAAa,EAAE,KAAK,OAAO,EAAE,KAAK,eAAe,EAAY,KAAK,GAAG,EAAE,MAAM,oBAAoB,CAAC;AAE3G;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,eAAe,CAAC,IAAI,SAAS,OAAO,GAAG,OAAO,EAAE,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAEvH;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,mBAAmB,CAAC,IAAI,SAAS,OAAO,EAAE,WAAW;IACnE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,WAAW,CAAC,EAAE,WAAW,EAAE,CAAC;IAC5B,kFAAkF;IAClF,WAAW,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC;IAC5D;;;;OAIG;IACH,UAAU,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;IAChC;;;;OAIG;IACH,YAAY,CAAC,EAAE,eAAe,CAAC,IAAI,CAAC,CAAC,cAAc,CAAC,CAAC;CACvD;AAiBD;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,SAAS,OAAO,GAAG,OAAO,EAAE,WAAW,GAAG,OAAO,EACnF,GAAG,EAAE,MAAM,GAAG,GAAG,EACjB,IAAI,EAAE,IAAI,EACV,OAAO,GAAE,mBAAmB,CAAC,IAAI,EAAE,WAAW,CAAM,GACpD,eAAe,CAAC,IAAI,CAAC,CA2BvB"}

package/lib/testing/fake-document.js

@@ -0,0 +1,85 @@
+/********************************************************************************
+ * 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 { DocumentState, UriUtils } from '@hydranium/langium';
+/**
+ * Build a typed AST-node fixture for unit tests.
+ *
+ * Langium AST node types are nominal interfaces generated from the grammar, so
+ * an object literal can never structurally satisfy one — every test that needs
+ * a node otherwise writes `{ $type: 'X', … } as unknown as SomeNode`. This
+ * helper encapsulates that single unavoidable cast in one audited place and
+ * hands back a value typed as `T`, so call sites stay cast-free and
+ * intention-revealing.
+ *
+ * It deliberately does NOT set the `$synthetic` marker: a test fixture is not a
+ * framework synthetic node, and marking it would change scope/index behaviour.
+ * A test that wants a genuine synthetic node calls `markSynthetic` explicitly.
+ *
+ * @param node the node shape — `$type` is required; every other property is a
+ *   value the test cares about (`$container`, cross-reference values, internal
+ *   `_id` fields, …). The object is returned by reference, not copied.
+ */
+export function makeFakeAstNode(node) {
+    return node;
+}
+/**
+ * Serialise `root` for the fake document's default text. AST fixtures routinely
+ * carry `$container` back-references (child → parent → child), so a plain
+ * `JSON.stringify` throws on the cycle; fall back to a minimal, deterministic
+ * `$type` marker in that case. The default text is only for fingerprint / dedup
+ * determinism — tests that assert on document text pass an explicit `text`.
+ */
+function stringifyFakeRoot(root) {
+    try {
+        return JSON.stringify(root);
+    }
+    catch {
+        return JSON.stringify({ $type: root?.$type });
+    }
+}
+/**
+ * Build a {@link LangiumDocument} shell suitable for stub services trees in
+ * unit tests. The returned document satisfies the structural shape Langium
+ * production code reads from — `uri`, `parseResult`, `textDocument`,
+ * `diagnostics`, `state` — without spinning up a real grammar.
+ *
+ * Default state is {@link DocumentState.Validated} so callers exercising the
+ * post-build read path (`getDocument` → assert AST) work without explicit
+ * staging. Override via `options.state` for tests that gate on earlier
+ * phases.
+ */
+export function makeFakeDocument(uri, root, options = {}) {
+    const parsed = UriUtils.toUri(uri);
+    const text = options.text ?? stringifyFakeRoot(root);
+    const version = options.version ?? 1;
+    const document = {
+        uri: parsed,
+        parseResult: {
+            value: root,
+            parserErrors: [],
+            lexerErrors: [],
+            ...options.parseResult
+        },
+        textDocument: options.textDocument ?? {
+            uri: parsed.toString(),
+            version,
+            getText: () => text
+        },
+        diagnostics: (options.diagnostics ?? []),
+        references: options.references ?? [],
+        state: options.state ?? DocumentState.Validated
+    };
+    // Wire the root → document back-reference the real LangiumDocumentFactory
+    // sets, so consumers that resolve a node's owning document (e.g. the
+    // transfer encoder deriving the encode context's URI) see the fake as
+    // attached rather than detached.
+    root.$document = document;
+    return document;
+}
+//# sourceMappingURL=fake-document.js.map

package/lib/testing/fake-document.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fake-document.js","sourceRoot":"","sources":["../../src/testing/fake-document.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EAAE,aAAa,EAAsC,QAAQ,EAAY,MAAM,oBAAoB,CAAC;AAE3G;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,eAAe,CAAiC,IAAiD;IAC9G,OAAO,IAAuB,CAAC;AAClC,CAAC;AA+BD;;;;;;GAMG;AACH,SAAS,iBAAiB,CAAC,IAAa;IACrC,IAAI,CAAC;QACF,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACN,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAG,IAAwC,EAAE,KAAK,EAAE,CAAC,CAAC;IACtF,CAAC;AACJ,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,gBAAgB,CAC7B,GAAiB,EACjB,IAAU,EACV,UAAkD,EAAE;IAEpD,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACnC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,iBAAiB,CAAC,IAAI,CAAC,CAAC;IACrD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,CAAC,CAAC;IACrC,MAAM,QAAQ,GAAG;QACd,GAAG,EAAE,MAAM;QACX,WAAW,EAAE;YACV,KAAK,EAAE,IAAI;YACX,YAAY,EAAE,EAAE;YAChB,WAAW,EAAE,EAAE;YACf,GAAG,OAAO,CAAC,WAAW;SACxB;QACD,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI;YACnC,GAAG,EAAE,MAAM,CAAC,QAAQ,EAAE;YACtB,OAAO;YACP,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI;SACrB;QACD,WAAW,EAAE,CAAC,OAAO,CAAC,WAAW,IAAI,EAAE,CAAU;QACjD,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,EAAE;QACpC,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,aAAa,CAAC,SAAS;KACb,CAAC;IACtC,0EAA0E;IAC1E,qEAAqE;IACrE,sEAAsE;IACtE,iCAAiC;IAChC,IAA8C,CAAC,SAAS,GAAG,QAAQ,CAAC;IACrE,OAAO,QAAQ,CAAC;AACnB,CAAC"}

package/lib/testing/fake-reflection.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';
+/** Per-property metadata a {@link makeFakeReflection} type map may declare. */
+export interface FakeReflectionProperty {
+    defaultValue?: unknown;
+    referenceType?: string;
+}
+/**
+ * Build a minimal {@link AstReflection} for serializer / encoder tests.
+ *
+ * Only `getTypeMetaData(type).properties[prop]` — with the optional
+ * `defaultValue` / `referenceType` the serialization utilities read — is
+ * populated; every other reflection member is absent, so an accidental new
+ * dependency throws loudly rather than silently returning `undefined`. Pass a
+ * `type -> property -> metadata` map.
+ *
+ * The single unavoidable cast (an object literal can't structurally satisfy the
+ * generated `AstReflection` interface) is encapsulated here so call sites stay
+ * cast-free — the reflection sibling of `makeFakeAstNode`.
+ */
+export declare function makeFakeReflection(types: Record<string, Record<string, FakeReflectionProperty>>): AstReflection;
+//# sourceMappingURL=fake-reflection.d.ts.map

package/lib/testing/fake-reflection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fake-reflection.d.ts","sourceRoot":"","sources":["../../src/testing/fake-reflection.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,KAAK,EAAE,aAAa,EAAgB,MAAM,oBAAoB,CAAC;AAEtE,+EAA+E;AAC/E,MAAM,WAAW,sBAAsB;IACpC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC,GAAG,aAAa,CAQ/G"}

package/lib/testing/fake-reflection.js

@@ -0,0 +1,30 @@
+/********************************************************************************
+ * 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
+ ********************************************************************************/
+/**
+ * Build a minimal {@link AstReflection} for serializer / encoder tests.
+ *
+ * Only `getTypeMetaData(type).properties[prop]` — with the optional
+ * `defaultValue` / `referenceType` the serialization utilities read — is
+ * populated; every other reflection member is absent, so an accidental new
+ * dependency throws loudly rather than silently returning `undefined`. Pass a
+ * `type -> property -> metadata` map.
+ *
+ * The single unavoidable cast (an object literal can't structurally satisfy the
+ * generated `AstReflection` interface) is encapsulated here so call sites stay
+ * cast-free — the reflection sibling of `makeFakeAstNode`.
+ */
+export function makeFakeReflection(types) {
+    return {
+        getTypeMetaData: (type) => ({
+            name: type,
+            properties: types[type] ?? {}
+        })
+    };
+}
+//# sourceMappingURL=fake-reflection.js.map

package/lib/testing/fake-reflection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fake-reflection.js","sourceRoot":"","sources":["../../src/testing/fake-reflection.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAUlF;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAA6D;IAC7F,OAAO;QACJ,eAAe,EAAE,CAAC,IAAY,EAAgB,EAAE,CAC7C,CAAC;YACE,IAAI,EAAE,IAAI;YACV,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE;SAC/B,CAA4B;KACN,CAAC;AACjC,CAAC"}

package/lib/testing/index.d.ts

@@ -0,0 +1,44 @@
+/********************************************************************************
+ * 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
+ ********************************************************************************/
+/**
+ * `@hydranium/core/testing` — the framework's BROWSER-NEUTRAL test-support
+ * surface: Langium-layer doubles for the shared-services slots, the harness that
+ * composes them into a services tree, the fake AST / document / reflection
+ * builders, the snapshot and URI-policy conformance primitives, the
+ * structured-write pipeline driver, and a re-export of `langium/test`.
+ *
+ * Neutrality is gated (`scripts/check-neutral-bundles.mjs`). The test support
+ * that needs a real filesystem or a Node stream transport — the scratch
+ * workspace, the golden corpus, the LSP transport and its harness — lives at
+ * `@hydranium/core/testing/node`, on the same rule the package surface uses:
+ * the portable name is the short one.
+ */
+export * from './ast-snapshot.js';
+export * from './document-uri-policy-conformance.js';
+export * from './fake-description.js';
+export * from './fake-document.js';
+export * from './fake-reflection.js';
+export * from './langium-test-helpers.js';
+export * from './make-noop-language-services.js';
+export * from './make-noop-shared-services.js';
+export * from './make-test-services.js';
+export * from './make-test-tracer.js';
+export * from './parse-semantic-root.js';
+export * from './run-update-pipeline.js';
+export * from './stub-document-builder.js';
+export * from './stub-index-manager.js';
+export * from './stub-langium-documents.js';
+export * from './stub-model-service.js';
+export * from './stub-ast-document-manager.js';
+export * from './stub-project-manager.js';
+export * from './stub-self-save-registry.js';
+export * from './stub-service-registry.js';
+export * from './stub-hydranium-text-documents.js';
+export * from './stub-writable-file-system.js';
+//# sourceMappingURL=index.d.ts.map

package/lib/testing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF;;;;;;;;;;;;GAYG;AAEH,cAAc,mBAAmB,CAAC;AAClC,cAAc,sCAAsC,CAAC;AACrD,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,kCAAkC,CAAC;AACjD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,yBAAyB,CAAC;AACxC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,yBAAyB,CAAC;AACxC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,oCAAoC,CAAC;AACnD,cAAc,gCAAgC,CAAC"}

package/lib/testing/index.js

@@ -0,0 +1,44 @@
+/********************************************************************************
+ * 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
+ ********************************************************************************/
+/**
+ * `@hydranium/core/testing` — the framework's BROWSER-NEUTRAL test-support
+ * surface: Langium-layer doubles for the shared-services slots, the harness that
+ * composes them into a services tree, the fake AST / document / reflection
+ * builders, the snapshot and URI-policy conformance primitives, the
+ * structured-write pipeline driver, and a re-export of `langium/test`.
+ *
+ * Neutrality is gated (`scripts/check-neutral-bundles.mjs`). The test support
+ * that needs a real filesystem or a Node stream transport — the scratch
+ * workspace, the golden corpus, the LSP transport and its harness — lives at
+ * `@hydranium/core/testing/node`, on the same rule the package surface uses:
+ * the portable name is the short one.
+ */
+export * from './ast-snapshot.js';
+export * from './document-uri-policy-conformance.js';
+export * from './fake-description.js';
+export * from './fake-document.js';
+export * from './fake-reflection.js';
+export * from './langium-test-helpers.js';
+export * from './make-noop-language-services.js';
+export * from './make-noop-shared-services.js';
+export * from './make-test-services.js';
+export * from './make-test-tracer.js';
+export * from './parse-semantic-root.js';
+export * from './run-update-pipeline.js';
+export * from './stub-document-builder.js';
+export * from './stub-index-manager.js';
+export * from './stub-langium-documents.js';
+export * from './stub-model-service.js';
+export * from './stub-ast-document-manager.js';
+export * from './stub-project-manager.js';
+export * from './stub-self-save-registry.js';
+export * from './stub-service-registry.js';
+export * from './stub-hydranium-text-documents.js';
+export * from './stub-writable-file-system.js';
+//# sourceMappingURL=index.js.map

package/lib/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF;;;;;;;;;;;;GAYG;AAEH,cAAc,mBAAmB,CAAC;AAClC,cAAc,sCAAsC,CAAC;AACrD,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,kCAAkC,CAAC;AACjD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,yBAAyB,CAAC;AACxC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,yBAAyB,CAAC;AACxC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,oCAAoC,CAAC;AACnD,cAAc,gCAAgC,CAAC"}

package/lib/testing/langium-test-helpers.d.ts

@@ -0,0 +1,26 @@
+/********************************************************************************
+ * 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
+ ********************************************************************************/
+/**
+ * Re-exports of Langium's `langium/test` helpers, so that
+ * `@hydranium/core/testing` is one import location for both test patterns:
+ *
+ * - the stubs from this subpath (`makeTestServices`, the `Stub*` classes) —
+ *   when the unit under test is a framework production class and can be
+ *   exercised without a real Langium grammar, against a
+ *   `ServerSharedServices`-shaped tree that no parser drives;
+ * - the Langium helpers re-exported here (`parseHelper`, `expectCompletion`,
+ *   `expectError`, …) — when the unit under test needs the AST a real grammar
+ *   produces.
+ *
+ * The re-export is verbatim and uncurated: the source of truth for the helpers'
+ * contracts stays Langium upstream, so a rename there surfaces here rather than
+ * being absorbed by a hand-maintained list.
+ */
+export * from '@hydranium/langium/test';
+//# sourceMappingURL=langium-test-helpers.d.ts.map

package/lib/testing/langium-test-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"langium-test-helpers.d.ts","sourceRoot":"","sources":["../../src/testing/langium-test-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF;;;;;;;;;;;;;;;GAeG;AACH,cAAc,yBAAyB,CAAC"}

package/lib/testing/langium-test-helpers.js

@@ -0,0 +1,26 @@
+/********************************************************************************
+ * 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
+ ********************************************************************************/
+/**
+ * Re-exports of Langium's `langium/test` helpers, so that
+ * `@hydranium/core/testing` is one import location for both test patterns:
+ *
+ * - the stubs from this subpath (`makeTestServices`, the `Stub*` classes) —
+ *   when the unit under test is a framework production class and can be
+ *   exercised without a real Langium grammar, against a
+ *   `ServerSharedServices`-shaped tree that no parser drives;
+ * - the Langium helpers re-exported here (`parseHelper`, `expectCompletion`,
+ *   `expectError`, …) — when the unit under test needs the AST a real grammar
+ *   produces.
+ *
+ * The re-export is verbatim and uncurated: the source of truth for the helpers'
+ * contracts stays Langium upstream, so a rename there surfaces here rather than
+ * being absorbed by a hand-maintained list.
+ */
+export * from '@hydranium/langium/test';
+//# sourceMappingURL=langium-test-helpers.js.map

package/lib/testing/langium-test-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"langium-test-helpers.js","sourceRoot":"","sources":["../../src/testing/langium-test-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF;;;;;;;;;;;;;;;GAeG;AACH,cAAc,yBAAyB,CAAC"}

package/lib/testing/make-noop-language-services.d.ts

@@ -0,0 +1,39 @@
+/********************************************************************************
+ * 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 { ServerLanguageServices } from '../langium/language-module.js';
+import { type NoopSharedServicesOverrides } from './make-noop-shared-services.js';
+/**
+ * Overrides for {@link makeNoopLanguageServices}. `shared` flows into
+ * {@link makeNoopSharedServices} (so the shared tree gets its no-op defaults);
+ * every other key is a loosely-typed per-language slot group (`references`,
+ * `ast`, `serializer`, `integrity`, `updateRewrite`, `validation`, the
+ * language-level `workspace`, …) spread onto the result, so a test drops in the
+ * one or two service stubs the class under test reads without a per-slot cast.
+ */
+export interface NoopLanguageServicesOverrides {
+    /** Overrides for the `shared` sub-tree — forwarded to {@link makeNoopSharedServices}. */
+    shared?: NoopSharedServicesOverrides;
+    /** Any per-language slot the class under test reads. */
+    [slot: string]: unknown;
+}
+/**
+ * Build a {@link ServerLanguageServices} tree whose `shared` sub-tree carries
+ * the {@link makeNoopSharedServices} no-op defaults, leaving the per-language
+ * slots for the caller to fill through `overrides`.
+ *
+ * The single unavoidable cast — an assembled literal can't structurally satisfy
+ * the full `ServerLanguageServices` (it omits the Langium per-language surface a
+ * unit test doesn't touch) — is encapsulated here, so a test constructing a
+ * framework per-language service (`DefaultIntegrityService`,
+ * `DefaultAstExtensionService`, `DefaultScopeExtensionService`,
+ * `DefaultUpdateRewriteService`, …) stays cast-free. The per-language sibling of
+ * {@link makeNoopSharedServices}.
+ */
+export declare function makeNoopLanguageServices(overrides?: NoopLanguageServicesOverrides): ServerLanguageServices;
+//# sourceMappingURL=make-noop-language-services.d.ts.map

package/lib/testing/make-noop-language-services.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"make-noop-language-services.d.ts","sourceRoot":"","sources":["../../src/testing/make-noop-language-services.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAC5E,OAAO,EAA0B,KAAK,2BAA2B,EAAE,MAAM,gCAAgC,CAAC;AAE1G;;;;;;;GAOG;AACH,MAAM,WAAW,6BAA6B;IAC3C,yFAAyF;IACzF,MAAM,CAAC,EAAE,2BAA2B,CAAC;IACrC,wDAAwD;IACxD,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,GAAE,6BAAkC,GAAG,sBAAsB,CAM9G"}

package/lib/testing/make-noop-language-services.js

@@ -0,0 +1,30 @@
+/********************************************************************************
+ * 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 { makeNoopSharedServices } from './make-noop-shared-services.js';
+/**
+ * Build a {@link ServerLanguageServices} tree whose `shared` sub-tree carries
+ * the {@link makeNoopSharedServices} no-op defaults, leaving the per-language
+ * slots for the caller to fill through `overrides`.
+ *
+ * The single unavoidable cast — an assembled literal can't structurally satisfy
+ * the full `ServerLanguageServices` (it omits the Langium per-language surface a
+ * unit test doesn't touch) — is encapsulated here, so a test constructing a
+ * framework per-language service (`DefaultIntegrityService`,
+ * `DefaultAstExtensionService`, `DefaultScopeExtensionService`,
+ * `DefaultUpdateRewriteService`, …) stays cast-free. The per-language sibling of
+ * {@link makeNoopSharedServices}.
+ */
+export function makeNoopLanguageServices(overrides = {}) {
+    const { shared, ...rest } = overrides;
+    return {
+        shared: makeNoopSharedServices(shared),
+        ...rest
+    };
+}
+//# sourceMappingURL=make-noop-language-services.js.map

package/lib/testing/make-noop-language-services.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"make-noop-language-services.js","sourceRoot":"","sources":["../../src/testing/make-noop-language-services.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAGlF,OAAO,EAAE,sBAAsB,EAAoC,MAAM,gCAAgC,CAAC;AAiB1G;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,wBAAwB,CAAC,YAA2C,EAAE;IACnF,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,SAAS,CAAC;IACtC,OAAO;QACJ,MAAM,EAAE,sBAAsB,CAAC,MAAM,CAAC;QACtC,GAAG,IAAI;KAC4B,CAAC;AAC1C,CAAC"}

package/lib/testing/make-noop-shared-services.d.ts

@@ -0,0 +1,61 @@
+/********************************************************************************
+ * 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 Clock, type Logger, type Tracer } from '@hydranium/protocol';
+import type { ServerSharedServicesMinimal } from '../langium/shared-services.js';
+/**
+ * Overrides for {@link makeNoopSharedServices}. The three observability slots
+ * are typed (they are the boilerplate this helper exists to default);
+ * `workspace` and any other slot are loosely typed so a test can drop in a
+ * structurally-narrower stub (a `Pick` of `LangiumDocuments`, an inline
+ * `{ wsRelativePath }` `WorkspaceManager`, …) without a per-slot cast — the
+ * single boundary cast lives inside {@link makeNoopSharedServices}.
+ */
+export interface NoopSharedServicesOverrides {
+    /** Bound on the top-level `Clock` slot. Default: {@link SystemClock}. */
+    Clock?: Clock;
+    /**
+     * Bound on the top-level `Logger` slot AND wrapped by the default `Tracer`
+     * (pass a `makeCapturingLogger().logger` to see tracer-emitted lines too).
+     * Default: {@link NoopLogger}.
+     */
+    Logger?: Logger;
+    /** Bound on the top-level `Tracer` slot. Default: a `DefaultTracer` over `Logger` + `Clock`. */
+    Tracer?: Tracer;
+    /** Per-slot `workspace` overrides. Slots left out resolve to `undefined`. */
+    workspace?: Record<string, unknown>;
+    /** Any other minimal slot (`ServiceRegistry`, `AstReflection`, `additionalDocuments`, …). */
+    [slot: string]: unknown;
+}
+/**
+ * Build a {@link ServerSharedServicesMinimal} tree backed by no-op defaults for
+ * the observability slots every framework component reads (`Clock` / `Logger` /
+ * `Tracer`) plus an empty `additionalDocuments`, leaving every other slot for
+ * the caller to fill through `overrides`.
+ *
+ * The single unavoidable cast — an assembled literal can't structurally satisfy
+ * the full `ServerSharedServicesMinimal` (it omits the many Langium slots a unit
+ * test doesn't touch: `ServiceRegistry`, `AstNodeLocator`, `IndexManager`, …) —
+ * is encapsulated here so call sites stay cast-free and intention-revealing.
+ * It is the shared-services sibling of `makeFakeAstNode` / `makeFakeReflection`:
+ * a test that reads an unset slot gets `undefined` and should override it.
+ *
+ * `overrides` is loosely typed on purpose (see {@link NoopSharedServicesOverrides})
+ * so structurally-narrower stubs slot in without a per-slot cast. For a fully
+ * wired tree with real Langium-layer stubs (LangiumDocuments / DocumentBuilder /
+ * ModelService / …) use `makeTestServices` instead — this helper is the light
+ * option for services that read only a handful of slots.
+ *
+ * The return type defaults to {@link ServerSharedServicesMinimal}; a consumer
+ * whose constructor declares the fuller `ServerSharedServices` requests it via
+ * the type parameter (`makeNoopSharedServices<ServerSharedServices>(...)`) so
+ * the value is assignable without a call-site cast — the extra LSP-bound slots
+ * are still undefined and should be overridden if the code under test reads them.
+ */
+export declare function makeNoopSharedServices<T extends ServerSharedServicesMinimal = ServerSharedServicesMinimal>(overrides?: NoopSharedServicesOverrides): T;
+//# sourceMappingURL=make-noop-shared-services.d.ts.map

package/lib/testing/make-noop-shared-services.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"make-noop-shared-services.d.ts","sourceRoot":"","sources":["../../src/testing/make-noop-shared-services.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EAAE,KAAK,KAAK,EAAiB,KAAK,MAAM,EAA2B,KAAK,MAAM,EAAE,MAAM,qBAAqB,CAAC;AACnH,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAEjF;;;;;;;GAOG;AACH,MAAM,WAAW,2BAA2B;IACzC,yEAAyE;IACzE,KAAK,CAAC,EAAE,KAAK,CAAC;IACd;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gGAAgG;IAChG,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6EAA6E;IAC7E,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,6FAA6F;IAC7F,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,SAAS,2BAA2B,GAAG,2BAA2B,EACvG,SAAS,GAAE,2BAAgC,GAC3C,CAAC,CAaH"}

package/lib/testing/make-noop-shared-services.js

@@ -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 { DefaultTracer, NoopLogger, SystemClock } from '@hydranium/protocol';
+/**
+ * Build a {@link ServerSharedServicesMinimal} tree backed by no-op defaults for
+ * the observability slots every framework component reads (`Clock` / `Logger` /
+ * `Tracer`) plus an empty `additionalDocuments`, leaving every other slot for
+ * the caller to fill through `overrides`.
+ *
+ * The single unavoidable cast — an assembled literal can't structurally satisfy
+ * the full `ServerSharedServicesMinimal` (it omits the many Langium slots a unit
+ * test doesn't touch: `ServiceRegistry`, `AstNodeLocator`, `IndexManager`, …) —
+ * is encapsulated here so call sites stay cast-free and intention-revealing.
+ * It is the shared-services sibling of `makeFakeAstNode` / `makeFakeReflection`:
+ * a test that reads an unset slot gets `undefined` and should override it.
+ *
+ * `overrides` is loosely typed on purpose (see {@link NoopSharedServicesOverrides})
+ * so structurally-narrower stubs slot in without a per-slot cast. For a fully
+ * wired tree with real Langium-layer stubs (LangiumDocuments / DocumentBuilder /
+ * ModelService / …) use `makeTestServices` instead — this helper is the light
+ * option for services that read only a handful of slots.
+ *
+ * The return type defaults to {@link ServerSharedServicesMinimal}; a consumer
+ * whose constructor declares the fuller `ServerSharedServices` requests it via
+ * the type parameter (`makeNoopSharedServices<ServerSharedServices>(...)`) so
+ * the value is assignable without a call-site cast — the extra LSP-bound slots
+ * are still undefined and should be overridden if the code under test reads them.
+ */
+export function makeNoopSharedServices(overrides = {}) {
+    const { Clock: clock, Logger: logger, Tracer: tracer, workspace, additionalDocuments, ...restTop } = overrides;
+    const resolvedClock = clock ?? new SystemClock();
+    const resolvedLogger = logger ?? new NoopLogger();
+    const resolvedTracer = tracer ?? new DefaultTracer(resolvedLogger, resolvedClock);
+    return {
+        Clock: resolvedClock,
+        Logger: resolvedLogger,
+        Tracer: resolvedTracer,
+        additionalDocuments: additionalDocuments ?? {},
+        ...restTop,
+        workspace: { ...(workspace ?? {}) }
+    };
+}
+//# sourceMappingURL=make-noop-shared-services.js.map

package/lib/testing/make-noop-shared-services.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"make-noop-shared-services.js","sourceRoot":"","sources":["../../src/testing/make-noop-shared-services.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EAAc,aAAa,EAAe,UAAU,EAAE,WAAW,EAAe,MAAM,qBAAqB,CAAC;AA4BnH;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,sBAAsB,CACnC,YAAyC,EAAE;IAE3C,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,mBAAmB,EAAE,GAAG,OAAO,EAAE,GAAG,SAAS,CAAC;IAC/G,MAAM,aAAa,GAAG,KAAK,IAAI,IAAI,WAAW,EAAE,CAAC;IACjD,MAAM,cAAc,GAAG,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;IAClD,MAAM,cAAc,GAAG,MAAM,IAAI,IAAI,aAAa,CAAC,cAAc,EAAE,aAAa,CAAC,CAAC;IAClF,OAAO;QACJ,KAAK,EAAE,aAAa;QACpB,MAAM,EAAE,cAAc;QACtB,MAAM,EAAE,cAAc;QACtB,mBAAmB,EAAE,mBAAmB,IAAI,EAAE;QAC9C,GAAG,OAAO;QACV,SAAS,EAAE,EAAE,GAAG,CAAC,SAAS,IAAI,EAAE,CAAC,EAAE;KACrB,CAAC;AACrB,CAAC"}