@hydranium/core 1.0.0-next.10

package/lib/testing/stub-hydranium-text-documents.js

@@ -0,0 +1,164 @@
+/********************************************************************************
+ * 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 { Disposable } from 'vscode-languageserver';
+import { LANGUAGE_CLIENT_ID } from '../documents/client-ids.js';
+/** Build a {@link StubHydraniumTextDocuments}. */
+export function makeStubHydraniumTextDocuments() {
+    const docs = new Map();
+    const changes = [];
+    const saves = [];
+    const languageClientOpen = new Set();
+    const appliedEdits = [];
+    const staged = [];
+    let applyEditHandler = () => ({ applied: true });
+    const saveListeners = [];
+    const closeListeners = [];
+    return {
+        get changes() {
+            return changes;
+        },
+        get saves() {
+            return saves;
+        },
+        get appliedEdits() {
+            return appliedEdits;
+        },
+        get staged() {
+            return staged;
+        },
+        get(uri) {
+            const doc = docs.get(uri);
+            return doc ? { version: doc.version, getText: () => doc.text } : undefined;
+        },
+        version(uri) {
+            return docs.get(uri)?.version ?? 0;
+        },
+        notifyDidChangeTextDocument(event, clientId = LANGUAGE_CLIENT_ID) {
+            const existing = docs.get(event.textDocument.uri);
+            const next = {
+                uri: event.textDocument.uri,
+                version: event.textDocument.version,
+                text: event.contentChanges[0]?.text ?? '',
+                clientId
+            };
+            if (existing && next.version <= existing.version) {
+                return;
+            }
+            docs.set(event.textDocument.uri, next);
+            changes.push(next);
+        },
+        applyContentChange(uri, text, clientId) {
+            const existing = docs.get(uri);
+            if (!existing) {
+                throw new Error(`Document ${uri} is not open for content changes`);
+            }
+            const changed = existing.text !== text;
+            // Mirrors the real store: step the version iff the content changed;
+            // an identical write mints no new version (the original author stays
+            // on record) but is still recorded as a change (rebuild fires).
+            const next = changed ? { uri, version: existing.version + 1, text, clientId } : existing;
+            docs.set(uri, next);
+            changes.push({ uri, version: next.version, text, clientId });
+            return next.version;
+        },
+        notifyDidSaveTextDocument(event, clientId) {
+            saves.push({ uri: event.textDocument.uri, clientId });
+            for (const listener of saveListeners.slice()) {
+                listener({ document: { uri: event.textDocument.uri }, clientId });
+            }
+        },
+        onDidSave(listener) {
+            saveListeners.push(listener);
+            return Disposable.create(() => {
+                const idx = saveListeners.indexOf(listener);
+                if (idx >= 0) {
+                    saveListeners.splice(idx, 1);
+                }
+            });
+        },
+        onDidClose(listener) {
+            closeListeners.push(listener);
+            return Disposable.create(() => {
+                const idx = closeListeners.indexOf(listener);
+                if (idx >= 0) {
+                    closeListeners.splice(idx, 1);
+                }
+            });
+        },
+        getAuthor(uri) {
+            return docs.get(uri)?.clientId;
+        },
+        isOpenInLanguageClient(uri) {
+            return languageClientOpen.has(uri);
+        },
+        isOpenInAnyClient(uri) {
+            return docs.has(uri) || languageClientOpen.has(uri);
+        },
+        openDocuments() {
+            // Merge the two seeding channels: `seedOpen` records the holding client
+            // on the doc entry, `seedOpenInLanguageClient` marks the LSP client.
+            const clientsByUri = new Map();
+            for (const [uri, entry] of docs) {
+                clientsByUri.set(uri, new Set([entry.clientId]));
+            }
+            for (const uri of languageClientOpen) {
+                const clients = clientsByUri.get(uri) ?? new Set();
+                clients.add(LANGUAGE_CLIENT_ID);
+                clientsByUri.set(uri, clients);
+            }
+            // The real store keys by canonical identity; the stub's plain-string
+            // keys stand in for it (single stub-boundary cast, like `fireClose`).
+            return [...clientsByUri].map(([uri, clients]) => ({ uri: uri, clients: [...clients] }));
+        },
+        setApplyEditHandler(handler) {
+            applyEditHandler = handler;
+        },
+        async applyEditToLanguageClient(uri, newText, options) {
+            appliedEdits.push({ uri, text: newText, label: options?.label });
+            return applyEditHandler(uri, newText);
+        },
+        stagePendingContent(uri, text) {
+            staged.push({ uri, text });
+        },
+        seedOpen(uri, text, clientId) {
+            docs.set(uri, { uri, version: 1, text, clientId });
+        },
+        seedOpenInLanguageClient(uri) {
+            languageClientOpen.add(uri);
+        },
+        fireClose(uri, clientId) {
+            // Drop the closing client's hold BEFORE notifying, matching the real
+            // class: listeners detect the last-close transition by consulting
+            // `isOpenInAnyClient`, which reads the already-decremented state.
+            const holder = docs.get(uri);
+            if (holder && holder.clientId === clientId) {
+                docs.delete(uri);
+            }
+            if (clientId === LANGUAGE_CLIENT_ID) {
+                languageClientOpen.delete(uri);
+            }
+            const event = { document: { uri }, clientId };
+            for (const listener of closeListeners.slice()) {
+                listener(event);
+            }
+        },
+        reset() {
+            docs.clear();
+            changes.length = 0;
+            saves.length = 0;
+            languageClientOpen.clear();
+            appliedEdits.length = 0;
+            staged.length = 0;
+            saveListeners.length = 0;
+            closeListeners.length = 0;
+            applyEditHandler = () => ({ applied: true });
+        }
+    };
+}
+//# sourceMappingURL=stub-hydranium-text-documents.js.map

package/lib/testing/stub-hydranium-text-documents.js.map

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

package/lib/testing/stub-index-manager.d.ts

@@ -0,0 +1,40 @@
+/********************************************************************************
+ * 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 AstNodeDescription } from '@hydranium/langium';
+import type { HydraniumIndexManager } from '../langium/workspace/index-manager.js';
+/**
+ * Stub for the framework's {@link HydraniumIndexManager}, backed by a flat list
+ * of descriptions a test seeds directly. It stands in for the GLOBAL INDEX — the
+ * source Langium's `DefaultScopeProvider.getGlobalScope` reads — so a test can
+ * assert what a scope does and does not fall through to without a workspace,
+ * a parse or a build.
+ *
+ * # Stub-vs-real surface
+ *
+ * `Pick` claims only the three read methods, so TypeScript keeps their
+ * signatures in lockstep with the real class and every other member of it (the
+ * `updateContent` / `removeContent` index maintenance, the reference index,
+ * `resolveElement*`, `getElementsInProject`) is unreachable through this
+ * interface. A test that needs one of those wants the real class over a real
+ * workspace.
+ *
+ * `nodeType` filtering is an exact `type` match, NOT the reflection subtype test
+ * the real manager applies — the stub binds no `AstReflection`. So a fixture
+ * asserting subtype visibility must name the concrete type, or it is asserting
+ * against the stub rather than against the framework.
+ */
+export interface StubIndexManager extends Pick<HydraniumIndexManager, 'allElements' | 'getElementsByName' | 'getElementByName'> {
+    /** Mutable seed; push / splice to model an index changing between assertions. */
+    readonly descriptions: AstNodeDescription[];
+    /** Drop every seeded description. */
+    reset(): void;
+}
+/** Build a {@link StubIndexManager}. Initial `descriptions` are pushed onto the mutable backing array. */
+export declare function makeStubIndexManager(initialDescriptions?: readonly AstNodeDescription[]): StubIndexManager;
+//# sourceMappingURL=stub-index-manager.d.ts.map

package/lib/testing/stub-index-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stub-index-manager.d.ts","sourceRoot":"","sources":["../../src/testing/stub-index-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EAAE,KAAK,kBAAkB,EAAuB,MAAM,oBAAoB,CAAC;AAClF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AAEnF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,gBAAiB,SAAQ,IAAI,CAAC,qBAAqB,EAAE,aAAa,GAAG,mBAAmB,GAAG,kBAAkB,CAAC;IAC5H,iFAAiF;IACjF,QAAQ,CAAC,YAAY,EAAE,kBAAkB,EAAE,CAAC;IAC5C,qCAAqC;IACrC,KAAK,IAAI,IAAI,CAAC;CAChB;AAED,0GAA0G;AAC1G,wBAAgB,oBAAoB,CAAC,mBAAmB,GAAE,SAAS,kBAAkB,EAAO,GAAG,gBAAgB,CAqC9G"}

package/lib/testing/stub-index-manager.js

@@ -0,0 +1,38 @@
+/********************************************************************************
+ * 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 { stream } from '@hydranium/langium';
+/** Build a {@link StubIndexManager}. Initial `descriptions` are pushed onto the mutable backing array. */
+export function makeStubIndexManager(initialDescriptions = []) {
+    const descriptions = [...initialDescriptions];
+    const matching = (name, type, languageId) => descriptions.filter(description => description.name === name &&
+        (type === undefined || description.type === type) &&
+        // The real manager derives the language id from the document URI via
+        // the service registry; the stub has neither, so it can only honour
+        // an unfiltered query.
+        languageId === undefined);
+    return {
+        get descriptions() {
+            return descriptions;
+        },
+        allElements(nodeType, uris) {
+            return stream(descriptions.filter(description => (nodeType === undefined || description.type === nodeType) &&
+                (uris === undefined || uris.has(description.documentUri.toString()))));
+        },
+        getElementsByName(name, type, languageId) {
+            return matching(name, type, languageId);
+        },
+        getElementByName(name, type, languageId) {
+            return matching(name, type, languageId)[0];
+        },
+        reset() {
+            descriptions.length = 0;
+        }
+    };
+}
+//# sourceMappingURL=stub-index-manager.js.map

package/lib/testing/stub-index-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stub-index-manager.js","sourceRoot":"","sources":["../../src/testing/stub-index-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EAA2B,MAAM,EAAe,MAAM,oBAAoB,CAAC;AA+BlF,0GAA0G;AAC1G,MAAM,UAAU,oBAAoB,CAAC,sBAAqD,EAAE;IACzF,MAAM,YAAY,GAAyB,CAAC,GAAG,mBAAmB,CAAC,CAAC;IAEpE,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAE,IAAa,EAAE,UAAmB,EAAwB,EAAE,CACzF,YAAY,CAAC,MAAM,CAChB,WAAW,CAAC,EAAE,CACX,WAAW,CAAC,IAAI,KAAK,IAAI;QACzB,CAAC,IAAI,KAAK,SAAS,IAAI,WAAW,CAAC,IAAI,KAAK,IAAI,CAAC;QACjD,qEAAqE;QACrE,oEAAoE;QACpE,uBAAuB;QACvB,UAAU,KAAK,SAAS,CAC7B,CAAC;IAEL,OAAO;QACJ,IAAI,YAAY;YACb,OAAO,YAAY,CAAC;QACvB,CAAC;QACD,WAAW,CAAC,QAAiB,EAAE,IAAkB;YAC9C,OAAO,MAAM,CACV,YAAY,CAAC,MAAM,CAChB,WAAW,CAAC,EAAE,CACX,CAAC,QAAQ,KAAK,SAAS,IAAI,WAAW,CAAC,IAAI,KAAK,QAAQ,CAAC;gBACzD,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC,CAAC,CACzE,CACH,CAAC;QACL,CAAC;QACD,iBAAiB,CAAC,IAAY,EAAE,IAAa,EAAE,UAAmB;YAC/D,OAAO,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;QAC3C,CAAC;QACD,gBAAgB,CAAC,IAAY,EAAE,IAAa,EAAE,UAAmB;YAC9D,OAAO,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9C,CAAC;QACD,KAAK;YACF,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC;QAC3B,CAAC;KACH,CAAC;AACL,CAAC"}

package/lib/testing/stub-langium-documents.d.ts

@@ -0,0 +1,53 @@
+/********************************************************************************
+ * 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 AstNode, type LangiumDocument, type LangiumDocuments, type URI } from '@hydranium/langium';
+import { type FakeDocumentOptions } from './fake-document.js';
+/**
+ * Map-backed stub for Langium's {@link LangiumDocuments} registry. Implements
+ * the surface real consumer code reads from on test paths
+ * (`getDocument` / `hasDocument` / `getOrCreateDocument` / `all`) plus
+ * test-only helpers: `set` (mutate the registry), `clear`, and `entries`
+ * (read the backing map directly).
+ *
+ * # Stub-vs-real surface
+ *
+ * Picks only the methods the framework reads on test paths from
+ * {@link LangiumDocuments}; the compiler enforces those signatures stay
+ * aligned with the real interface. Methods Langium adds in the future
+ * (or methods the stub doesn't claim — `deleteDocument`, etc.) can't be
+ * called through this stub interface; consumers that need them either
+ * extend the Pick or wire the real registry.
+ *
+ * Returned as a structural value rather than a class subclass because
+ * Langium doesn't expose a constructable `LangiumDocuments` registry —
+ * production code reads the slot value through the `LangiumDocuments`
+ * interface and a narrowing cast bridges the stub at the binding site.
+ */
+export interface StubLangiumDocuments<TAst extends AstNode = AstNode, TDiagnostic = unknown> extends Pick<LangiumDocuments, 'getDocument' | 'hasDocument' | 'getOrCreateDocument' | 'all'> {
+    /**
+     * Replace (or insert) the {@link LangiumDocument} at the given URI. Returns
+     * the inserted document so call sites can chain to phase-fire helpers
+     * without a separate lookup.
+     */
+    set(uri: string | URI, root: TAst, options?: FakeDocumentOptions<TAst, TDiagnostic>): LangiumDocument<TAst>;
+    /** Drop every entry. Useful for `beforeEach` resets without rebuilding the bundle. */
+    clear(): void;
+    /** Direct accessor on the underlying map — for assertion-side reads in tests. */
+    readonly entries: ReadonlyMap<string, LangiumDocument<TAst>>;
+}
+/**
+ * Build a {@link StubLangiumDocuments}. Seed entries via the optional
+ * `seeds` parameter so simple tests don't need a separate `set` call.
+ */
+export declare function makeStubLangiumDocuments<TAst extends AstNode = AstNode, TDiagnostic = unknown>(seeds?: ReadonlyArray<{
+    uri: string | URI;
+    root: TAst;
+    options?: FakeDocumentOptions<TAst, TDiagnostic>;
+}>): StubLangiumDocuments<TAst, TDiagnostic>;
+//# sourceMappingURL=stub-langium-documents.d.ts.map

package/lib/testing/stub-langium-documents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stub-langium-documents.d.ts","sourceRoot":"","sources":["../../src/testing/stub-langium-documents.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EAAE,KAAK,OAAO,EAAE,KAAK,eAAe,EAAE,KAAK,gBAAgB,EAAU,KAAK,GAAG,EAAE,MAAM,oBAAoB,CAAC;AACjH,OAAO,EAAqC,KAAK,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEjG;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,oBAAoB,CAAC,IAAI,SAAS,OAAO,GAAG,OAAO,EAAE,WAAW,GAAG,OAAO,CAAE,SAAQ,IAAI,CACtG,gBAAgB,EAChB,aAAa,GAAG,aAAa,GAAG,qBAAqB,GAAG,KAAK,CAC/D;IACE;;;;OAIG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,mBAAmB,CAAC,IAAI,EAAE,WAAW,CAAC,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IAC5G,sFAAsF;IACtF,KAAK,IAAI,IAAI,CAAC;IACd,iFAAiF;IACjF,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC;CAC/D;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,SAAS,OAAO,GAAG,OAAO,EAAE,WAAW,GAAG,OAAO,EAC3F,KAAK,GAAE,aAAa,CAAC;IAAE,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;IAAC,IAAI,EAAE,IAAI,CAAC;IAAC,OAAO,CAAC,EAAE,mBAAmB,CAAC,IAAI,EAAE,WAAW,CAAC,CAAA;CAAE,CAAM,GAC9G,oBAAoB,CAAC,IAAI,EAAE,WAAW,CAAC,CAgDzC"}

package/lib/testing/stub-langium-documents.js

@@ -0,0 +1,62 @@
+/********************************************************************************
+ * 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 { stream } from '@hydranium/langium';
+import { makeFakeAstNode, makeFakeDocument } from './fake-document.js';
+/**
+ * Build a {@link StubLangiumDocuments}. Seed entries via the optional
+ * `seeds` parameter so simple tests don't need a separate `set` call.
+ */
+export function makeStubLangiumDocuments(seeds = []) {
+    const docs = new Map();
+    const stub = {
+        get entries() {
+            return docs;
+        },
+        get all() {
+            // A `Stream`, not an array: the picked signature promises one, and
+            // framework code reads `documents.all.toArray()`. Returning an array
+            // behind the cast let that call throw against the stub while every
+            // signature still typechecked. Use `entries` for a size.
+            return stream(docs.values());
+        },
+        set(uri, root, options) {
+            const key = typeof uri === 'string' ? uri : uri.toString();
+            const doc = makeFakeDocument(uri, root, options);
+            docs.set(key, doc);
+            return doc;
+        },
+        clear() {
+            docs.clear();
+        },
+        getDocument(uri) {
+            return docs.get(uri.toString());
+        },
+        hasDocument(uri) {
+            return docs.has(uri.toString());
+        },
+        async getOrCreateDocument(uri) {
+            const existing = docs.get(uri.toString());
+            if (existing) {
+                return existing;
+            }
+            // Registered on creation, as `DefaultLangiumDocuments` does — a
+            // caller that reads it back through `getDocument` must find it. The
+            // root is a `$type: 'unknown'` placeholder because the stub has no
+            // parser, so a test asserting on the root has to `set` first.
+            const placeholder = makeFakeDocument(uri, makeFakeAstNode({ $type: 'unknown' }));
+            docs.set(uri.toString(), placeholder);
+            return placeholder;
+        }
+    };
+    for (const seed of seeds) {
+        stub.set(seed.uri, seed.root, seed.options);
+    }
+    return stub;
+}
+//# sourceMappingURL=stub-langium-documents.js.map

package/lib/testing/stub-langium-documents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stub-langium-documents.js","sourceRoot":"","sources":["../../src/testing/stub-langium-documents.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EAA6D,MAAM,EAAY,MAAM,oBAAoB,CAAC;AACjH,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAA4B,MAAM,oBAAoB,CAAC;AAuCjG;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CACrC,QAA4G,EAAE;IAE9G,MAAM,IAAI,GAAG,IAAI,GAAG,EAAiC,CAAC;IAEtD,MAAM,IAAI,GAA4C;QACnD,IAAI,OAAO;YACR,OAAO,IAAI,CAAC;QACf,CAAC;QACD,IAAI,GAAG;YACJ,mEAAmE;YACnE,qEAAqE;YACrE,mEAAmE;YACnE,yDAAyD;YACzD,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,CAAuC,CAAC;QACtE,CAAC;QACD,GAAG,CAAC,GAAiB,EAAE,IAAU,EAAE,OAAgD;YAChF,MAAM,GAAG,GAAG,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;YAC3D,MAAM,GAAG,GAAG,gBAAgB,CAAoB,GAAG,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;YACpE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;YACnB,OAAO,GAAG,CAAC;QACd,CAAC;QACD,KAAK;YACF,IAAI,CAAC,KAAK,EAAE,CAAC;QAChB,CAAC;QACD,WAAW,CAAC,GAAQ;YACjB,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAgC,CAAC;QAClE,CAAC;QACD,WAAW,CAAC,GAAQ;YACjB,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC;QACnC,CAAC;QACD,KAAK,CAAC,mBAAmB,CAAC,GAAQ;YAC/B,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC;YAC1C,IAAI,QAAQ,EAAE,CAAC;gBACZ,OAAO,QAA2B,CAAC;YACtC,CAAC;YACD,gEAAgE;YAChE,oEAAoE;YACpE,mEAAmE;YACnE,8DAA8D;YAC9D,MAAM,WAAW,GAAG,gBAAgB,CAAC,GAAG,EAAE,eAAe,CAAO,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC;YACvF,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,WAAW,CAAC,CAAC;YACtC,OAAO,WAA8B,CAAC;QACzC,CAAC;KACH,CAAC;IAEF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACxB,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IAC/C,CAAC;IACD,OAAO,IAAI,CAAC;AACf,CAAC"}

package/lib/testing/stub-model-service.d.ts

@@ -0,0 +1,31 @@
+/********************************************************************************
+ * 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 { TransferDiagnostic, TransferElement } from '@hydranium/protocol';
+import type { AstNode } from '@hydranium/langium';
+import { ModelService, type ModelServiceOptions } from '../langium/model-service/model-service.js';
+import type { ServerSharedServices } from '../langium/module.js';
+/** The type of the model-service test double produced by {@link makeStubModelService}. */
+export type StubModelService<TAst extends AstNode, TDiagnostic extends TransferDiagnostic = TransferDiagnostic, TTransfer extends TransferElement = TransferElement> = ModelService<TAst, TDiagnostic, TTransfer>;
+/**
+ * Build a {@link StubModelService} — a {@link ModelService} test double that
+ * takes `serialize` as a constructor callback. The stub services tree has no
+ * `ServiceRegistry`, so the framework default `serialize` path would fail; the
+ * callback supplies a grammar-free serializer instead. The bundle assembled by
+ * `makeTestServices` wires this stub automatically.
+ *
+ * `options` are the framework {@link ModelServiceOptions}, forwarded verbatim, so
+ * a test can exercise an option-gated code path (`serializeBuilds`, the slow-warn
+ * threshold) without hand-rolling a subclass just to reach the constructor.
+ *
+ * Adopters that need richer override behaviour — the framework's own extension
+ * surface is {@link ModelService.rewriteModel} alongside `serialize` — should
+ * subclass {@link ModelService} directly instead.
+ */
+export declare function makeStubModelService<TAst extends AstNode, TDiagnostic extends TransferDiagnostic = TransferDiagnostic, TTransfer extends TransferElement = TransferElement>(services: ServerSharedServices, serialize: (uri: string, root: TTransfer) => string, options?: ModelServiceOptions): StubModelService<TAst, TDiagnostic, TTransfer>;
+//# sourceMappingURL=stub-model-service.d.ts.map

package/lib/testing/stub-model-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stub-model-service.d.ts","sourceRoot":"","sources":["../../src/testing/stub-model-service.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,KAAK,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC/E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,2CAA2C,CAAC;AACnG,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AA2BjE,0FAA0F;AAC1F,MAAM,MAAM,gBAAgB,CACzB,IAAI,SAAS,OAAO,EACpB,WAAW,SAAS,kBAAkB,GAAG,kBAAkB,EAC3D,SAAS,SAAS,eAAe,GAAG,eAAe,IAClD,YAAY,CAAC,IAAI,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC;AAE/C;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oBAAoB,CACjC,IAAI,SAAS,OAAO,EACpB,WAAW,SAAS,kBAAkB,GAAG,kBAAkB,EAC3D,SAAS,SAAS,eAAe,GAAG,eAAe,EAEnD,QAAQ,EAAE,oBAAoB,EAC9B,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,KAAK,MAAM,EACnD,OAAO,CAAC,EAAE,mBAAmB,GAC7B,gBAAgB,CAAC,IAAI,EAAE,WAAW,EAAE,SAAS,CAAC,CAEhD"}

package/lib/testing/stub-model-service.js

@@ -0,0 +1,45 @@
+/********************************************************************************
+ * 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 { ModelService } from '../langium/model-service/model-service.js';
+/**
+ * Implementation detail of {@link makeStubModelService}. A {@link ModelService}
+ * subclass that takes `serialize` as a constructor callback — the test stub
+ * services tree has no `ServiceRegistry`, so the framework default `serialize`
+ * path would fail. Construct it through the factory; the {@link StubModelService}
+ * type alias is the public type name.
+ */
+class StubModelServiceImpl extends ModelService {
+    serializeFn;
+    constructor(services, serializeFn, options) {
+        super(services, options);
+        this.serializeFn = serializeFn;
+    }
+    serialize(uri, root) {
+        return this.serializeFn(uri, root);
+    }
+}
+/**
+ * Build a {@link StubModelService} — a {@link ModelService} test double that
+ * takes `serialize` as a constructor callback. The stub services tree has no
+ * `ServiceRegistry`, so the framework default `serialize` path would fail; the
+ * callback supplies a grammar-free serializer instead. The bundle assembled by
+ * `makeTestServices` wires this stub automatically.
+ *
+ * `options` are the framework {@link ModelServiceOptions}, forwarded verbatim, so
+ * a test can exercise an option-gated code path (`serializeBuilds`, the slow-warn
+ * threshold) without hand-rolling a subclass just to reach the constructor.
+ *
+ * Adopters that need richer override behaviour — the framework's own extension
+ * surface is {@link ModelService.rewriteModel} alongside `serialize` — should
+ * subclass {@link ModelService} directly instead.
+ */
+export function makeStubModelService(services, serialize, options) {
+    return new StubModelServiceImpl(services, serialize, options);
+}
+//# sourceMappingURL=stub-model-service.js.map

package/lib/testing/stub-model-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stub-model-service.js","sourceRoot":"","sources":["../../src/testing/stub-model-service.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAIlF,OAAO,EAAE,YAAY,EAA4B,MAAM,2CAA2C,CAAC;AAGnG;;;;;;GAMG;AACH,MAAM,oBAIJ,SAAQ,YAA0C;IAG3B;IAFtB,YACG,QAA8B,EACX,WAAqD,EACxE,OAA6B;QAE7B,KAAK,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAHN,gBAAW,GAAX,WAAW,CAA0C;IAI3E,CAAC;IAEkB,SAAS,CAAC,GAAW,EAAE,IAAe;QACtD,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACtC,CAAC;CACH;AASD;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,oBAAoB,CAKjC,QAA8B,EAC9B,SAAmD,EACnD,OAA6B;IAE7B,OAAO,IAAI,oBAAoB,CAA+B,QAAQ,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;AAC/F,CAAC"}

package/lib/testing/stub-project-manager.d.ts

@@ -0,0 +1,43 @@
+/********************************************************************************
+ * 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 Project } from '@hydranium/protocol';
+import { type URI } from '@hydranium/langium';
+import type { ProjectChangeEvent } from '../langium/project/project-change-event.js';
+import type { ProjectManager } from '../langium/project/project-manager.js';
+/**
+ * Stub for {@link ProjectManager}. Backed by a mutable `projects` array so
+ * tests can rearrange the registry between assertions, with test-only
+ * helpers:
+ *
+ * - {@link ownUri} — declare which project owns a given URI. Drives
+ *   {@link getProject} lookups so tests can model multi-project workspaces
+ *   without spinning up an `AbstractProjectManager`.
+ * - {@link fireProjectsChanged} — synchronously deliver a synthetic
+ *   {@link ProjectChangeEvent} to subscribers.
+ *
+ * `getProjectUris` / `getVisibleProjects` / `isVisible` answer from the
+ * declared ownership and the projects' `dependencies`, matching what
+ * `AbstractProjectManager` computes. `discoverProjects` and
+ * `isProjectDescriptor` are inert defaults (no-op / always `false`);
+ * override the returned object's methods for tests that need discovery
+ * behaviour.
+ */
+export interface StubProjectManager<TProject extends Project = Project> extends ProjectManager<TProject> {
+    /** Mutable project list; push / splice to model a changing registry. */
+    readonly projects: TProject[];
+    /** Declare which project owns the given URI for {@link getProject} lookups. */
+    ownUri(uri: string | URI, projectId: string): void;
+    /** Synchronously deliver a {@link ProjectChangeEvent} to every registered listener. */
+    fireProjectsChanged(event: ProjectChangeEvent<TProject>): void;
+    /** Drop ownership state, projects, and listeners. */
+    reset(): void;
+}
+/** Build a {@link StubProjectManager}. Initial `projects` are pushed onto the mutable backing array. */
+export declare function makeStubProjectManager<TProject extends Project = Project>(initialProjects?: readonly TProject[]): StubProjectManager<TProject>;
+//# sourceMappingURL=stub-project-manager.d.ts.map

package/lib/testing/stub-project-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stub-project-manager.d.ts","sourceRoot":"","sources":["../../src/testing/stub-project-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EAAE,KAAK,OAAO,EAAiC,MAAM,qBAAqB,CAAC;AAClF,OAAO,EAA0B,KAAK,GAAG,EAAY,MAAM,oBAAoB,CAAC;AAGhF,OAAO,KAAK,EAAE,kBAAkB,EAAyB,MAAM,4CAA4C,CAAC;AAC5G,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAE5E;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,kBAAkB,CAAC,QAAQ,SAAS,OAAO,GAAG,OAAO,CAAE,SAAQ,cAAc,CAAC,QAAQ,CAAC;IACrG,wEAAwE;IACxE,QAAQ,CAAC,QAAQ,EAAE,QAAQ,EAAE,CAAC;IAC9B,+EAA+E;IAC/E,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACnD,uFAAuF;IACvF,mBAAmB,CAAC,KAAK,EAAE,kBAAkB,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC;IAC/D,qDAAqD;IACrD,KAAK,IAAI,IAAI,CAAC;CAChB;AAED,wGAAwG;AACxG,wBAAgB,sBAAsB,CAAC,QAAQ,SAAS,OAAO,GAAG,OAAO,EACtE,eAAe,GAAE,SAAS,QAAQ,EAAO,GACzC,kBAAkB,CAAC,QAAQ,CAAC,CAgH9B"}

package/lib/testing/stub-project-manager.js

@@ -0,0 +1,125 @@
+/********************************************************************************
+ * 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 { UNQUALIFIED_PROJECT_REFERENCE } from '@hydranium/protocol';
+import { AstUtils, UriUtils } from '@hydranium/langium';
+import { Disposable } from 'vscode-languageserver';
+/** Build a {@link StubProjectManager}. Initial `projects` are pushed onto the mutable backing array. */
+export function makeStubProjectManager(initialProjects = []) {
+    const projects = [...initialProjects];
+    const listeners = [];
+    const ownership = new Map();
+    return {
+        get projects() {
+            return projects;
+        },
+        ready: Promise.resolve(),
+        async discoverProjects(_folders) {
+            // No-op default: the stub's registry is seeded directly. Tests that
+            // exercise discovery semantics override this method or use a real
+            // `AbstractProjectManager` subclass.
+        },
+        isProjectDescriptor() {
+            return false;
+        },
+        isSingleProject() {
+            return projects.length <= 1;
+        },
+        isUnqualifiedProjectReference(uri) {
+            const project = this.getProject(uri);
+            return project === undefined || project.referenceName === UNQUALIFIED_PROJECT_REFERENCE;
+        },
+        getProjects() {
+            return projects;
+        },
+        getProjectById(id) {
+            return projects.find(project => project.id === id);
+        },
+        getProject(uri) {
+            const key = typeof uri === 'string' ? uri : uri.toString();
+            const projectId = ownership.get(key);
+            return projectId ? projects.find(project => project.id === projectId) : undefined;
+        },
+        getProjectForNode(node) {
+            const uri = AstUtils.findRootNode(node).$document?.uri;
+            return uri ? this.getProject(uri) : undefined;
+        },
+        getProjectUris(projectId) {
+            // Registration gates the ownership scan, as in `AbstractProjectManager`:
+            // an id no project carries owns nothing, whatever the ownership map
+            // says. Without the gate a test could assert membership for a project
+            // that was never registered.
+            if (!projects.some(project => project.id === projectId)) {
+                return [];
+            }
+            return [...ownership.entries()].filter(([, id]) => id === projectId).map(([uri]) => UriUtils.toUri(uri));
+        },
+        getVisibleProjects(projectId) {
+            // Transitive closure of `Project.dependencies` including the source
+            // — mirrors `AbstractProjectManager.getVisibleProjects` so tests
+            // observe the same visibility model the production manager does.
+            if (!projects.some(project => project.id === projectId)) {
+                return [];
+            }
+            const visited = new Set();
+            const ordered = [];
+            const walk = (id) => {
+                if (visited.has(id)) {
+                    return;
+                }
+                visited.add(id);
+                const project = projects.find(p => p.id === id);
+                if (!project) {
+                    return;
+                }
+                ordered.push(id);
+                for (const dep of project.dependencies ?? []) {
+                    walk(dep);
+                }
+            };
+            walk(projectId);
+            return ordered;
+        },
+        isVisible(sourceProjectId, targetProjectId, selfVisible = false) {
+            // Same logic as AbstractProjectManager.isVisible — kept inline so the
+            // stub stays self-contained.
+            const visible = this.getVisibleProjects(sourceProjectId);
+            if (visible.length === 0) {
+                return false;
+            }
+            if (sourceProjectId === targetProjectId) {
+                return selfVisible;
+            }
+            return visible.includes(targetProjectId);
+        },
+        onProjectsChanged(listener) {
+            listeners.push(listener);
+            return Disposable.create(() => {
+                const idx = listeners.indexOf(listener);
+                if (idx >= 0) {
+                    listeners.splice(idx, 1);
+                }
+            });
+        },
+        ownUri(uri, projectId) {
+            const key = typeof uri === 'string' ? uri : uri.toString();
+            ownership.set(key, projectId);
+        },
+        fireProjectsChanged(event) {
+            for (const listener of listeners.slice()) {
+                listener(event);
+            }
+        },
+        reset() {
+            projects.length = 0;
+            listeners.length = 0;
+            ownership.clear();
+        }
+    };
+}
+//# sourceMappingURL=stub-project-manager.js.map