@hydranium/core 1.0.0-next.10

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

@@ -0,0 +1 @@
+{"version":3,"file":"stub-project-manager.js","sourceRoot":"","sources":["../../src/testing/stub-project-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EAAgB,6BAA6B,EAAE,MAAM,qBAAqB,CAAC;AAClF,OAAO,EAAgB,QAAQ,EAAY,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAChF,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAkCnD,wGAAwG;AACxG,MAAM,UAAU,sBAAsB,CACnC,kBAAuC,EAAE;IAEzC,MAAM,QAAQ,GAAe,CAAC,GAAG,eAAe,CAAC,CAAC;IAClD,MAAM,SAAS,GAAsC,EAAE,CAAC;IACxD,MAAM,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAC;IAE5C,OAAO;QACJ,IAAI,QAAQ;YACT,OAAO,QAAQ,CAAC;QACnB,CAAC;QACD,KAAK,EAAE,OAAO,CAAC,OAAO,EAAE;QACxB,KAAK,CAAC,gBAAgB,CAAC,QAAoC;YACxD,oEAAoE;YACpE,kEAAkE;YAClE,qCAAqC;QACxC,CAAC;QACD,mBAAmB;YAChB,OAAO,KAAK,CAAC;QAChB,CAAC;QACD,eAAe;YACZ,OAAO,QAAQ,CAAC,MAAM,IAAI,CAAC,CAAC;QAC/B,CAAC;QACD,6BAA6B,CAAC,GAAiB;YAC5C,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;YACrC,OAAO,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,aAAa,KAAK,6BAA6B,CAAC;QAC3F,CAAC;QACD,WAAW;YACR,OAAO,QAAQ,CAAC;QACnB,CAAC;QACD,cAAc,CAAC,EAAU;YACtB,OAAO,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QACtD,CAAC;QACD,UAAU,CAAC,GAAiB;YACzB,MAAM,GAAG,GAAG,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;YAC3D,MAAM,SAAS,GAAG,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACrC,OAAO,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACrF,CAAC;QACD,iBAAiB,CAAC,IAAa;YAC5B,MAAM,GAAG,GAAG,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,GAAG,CAAC;YACvD,OAAO,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACjD,CAAC;QACD,cAAc,CAAC,SAAiB;YAC7B,yEAAyE;YACzE,oEAAoE;YACpE,sEAAsE;YACtE,6BAA6B;YAC7B,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,KAAK,SAAS,CAAC,EAAE,CAAC;gBACvD,OAAO,EAAE,CAAC;YACb,CAAC;YACD,OAAO,CAAC,GAAG,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;QAC5G,CAAC;QACD,kBAAkB,CAAC,SAAiB;YACjC,oEAAoE;YACpE,iEAAiE;YACjE,iEAAiE;YACjE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,KAAK,SAAS,CAAC,EAAE,CAAC;gBACvD,OAAO,EAAE,CAAC;YACb,CAAC;YACD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;YAClC,MAAM,OAAO,GAAa,EAAE,CAAC;YAC7B,MAAM,IAAI,GAAG,CAAC,EAAU,EAAQ,EAAE;gBAC/B,IAAI,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;oBACnB,OAAO;gBACV,CAAC;gBACD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBAChB,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;gBAChD,IAAI,CAAC,OAAO,EAAE,CAAC;oBACZ,OAAO;gBACV,CAAC;gBACD,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBACjB,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,YAAY,IAAI,EAAE,EAAE,CAAC;oBAC5C,IAAI,CAAC,GAAG,CAAC,CAAC;gBACb,CAAC;YACJ,CAAC,CAAC;YACF,IAAI,CAAC,SAAS,CAAC,CAAC;YAChB,OAAO,OAAO,CAAC;QAClB,CAAC;QACD,SAAS,CAAC,eAAuB,EAAE,eAAuB,EAAE,WAAW,GAAG,KAAK;YAC5E,sEAAsE;YACtE,6BAA6B;YAC7B,MAAM,OAAO,GAAG,IAAI,CAAC,kBAAkB,CAAC,eAAe,CAAC,CAAC;YACzD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACxB,OAAO,KAAK,CAAC;YAChB,CAAC;YACD,IAAI,eAAe,KAAK,eAAe,EAAE,CAAC;gBACvC,OAAO,WAAW,CAAC;YACtB,CAAC;YACD,OAAO,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;QAC5C,CAAC;QACD,iBAAiB,CAAC,QAAyC;YACxD,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACzB,OAAO,UAAU,CAAC,MAAM,CAAC,GAAG,EAAE;gBAC3B,MAAM,GAAG,GAAG,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;gBACxC,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC;oBACZ,SAAS,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;gBAC5B,CAAC;YACJ,CAAC,CAAC,CAAC;QACN,CAAC;QACD,MAAM,CAAC,GAAG,EAAE,SAAS;YAClB,MAAM,GAAG,GAAG,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;YAC3D,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QACjC,CAAC;QACD,mBAAmB,CAAC,KAAK;YACtB,KAAK,MAAM,QAAQ,IAAI,SAAS,CAAC,KAAK,EAAE,EAAE,CAAC;gBACxC,QAAQ,CAAC,KAAK,CAAC,CAAC;YACnB,CAAC;QACJ,CAAC;QACD,KAAK;YACF,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;YACpB,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC;YACrB,SAAS,CAAC,KAAK,EAAE,CAAC;QACrB,CAAC;KACH,CAAC;AACL,CAAC"}

package/lib/testing/stub-self-save-registry.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 { SelfSaveRegistry } from '../documents/self-save-registry.js';
+/**
+ * Stub for the framework's {@link SelfSaveRegistry}. Records `register` calls
+ * so tests can assert that a save path correctly notified the registry.
+ *
+ * # Stub-vs-real surface
+ *
+ * The stub declares only the methods exercised by tests via
+ * `Pick<SelfSaveRegistry, ...>` — TypeScript enforces that each picked
+ * method's signature stays in lockstep with the real class. `matches`, the
+ * only other member, is not claimed and so cannot be called through this
+ * interface; a test that needs the TTL / mtime matching either picks it here
+ * or uses the real class.
+ */
+export interface StubSelfSaveRegistry extends Pick<SelfSaveRegistry, 'register'> {
+    readonly registerCalls: ReadonlyArray<{
+        fsPath: string;
+        mtimeMs: number;
+    }>;
+    reset(): void;
+}
+export declare function makeStubSelfSaveRegistry(): StubSelfSaveRegistry;
+//# sourceMappingURL=stub-self-save-registry.d.ts.map

package/lib/testing/stub-self-save-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stub-self-save-registry.d.ts","sourceRoot":"","sources":["../../src/testing/stub-self-save-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAE3E;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,oBAAqB,SAAQ,IAAI,CAAC,gBAAgB,EAAE,UAAU,CAAC;IAC7E,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3E,KAAK,IAAI,IAAI,CAAC;CAChB;AAED,wBAAgB,wBAAwB,IAAI,oBAAoB,CAa/D"}

package/lib/testing/stub-self-save-registry.js

@@ -0,0 +1,23 @@
+/********************************************************************************
+ * 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 function makeStubSelfSaveRegistry() {
+    const registerCalls = [];
+    return {
+        get registerCalls() {
+            return registerCalls;
+        },
+        register(fsPath, mtimeMs) {
+            registerCalls.push({ fsPath, mtimeMs });
+        },
+        reset() {
+            registerCalls.length = 0;
+        }
+    };
+}
+//# sourceMappingURL=stub-self-save-registry.js.map

package/lib/testing/stub-self-save-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stub-self-save-registry.js","sourceRoot":"","sources":["../../src/testing/stub-self-save-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAsBlF,MAAM,UAAU,wBAAwB;IACrC,MAAM,aAAa,GAA0C,EAAE,CAAC;IAChE,OAAO;QACJ,IAAI,aAAa;YACd,OAAO,aAAa,CAAC;QACxB,CAAC;QACD,QAAQ,CAAC,MAAM,EAAE,OAAO;YACrB,aAAa,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;QAC3C,CAAC;QACD,KAAK;YACF,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC;QAC5B,CAAC;KACH,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,95 @@
+/********************************************************************************
+ * 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 { ExtendedServiceRegistry } from '../langium/service-registry.js';
+import { type NoopLanguageServicesOverrides } from './make-noop-language-services.js';
+/**
+ * One language to register on a {@link StubServiceRegistry}. Only
+ * {@link languageId} and {@link fileExtensions} are required — they are what
+ * Langium's routing ladder actually reads.
+ */
+export interface StubLanguageDescriptor {
+    /** The language's id, as `LanguageMetaData.languageId`. */
+    readonly languageId: string;
+    /** Extensions routed to this language, leading dot included (`'.fake'`). */
+    readonly fileExtensions: readonly string[];
+    /** Whole file names routed to this language (Langium's `fileNameMap` rung). */
+    readonly fileNames?: readonly string[];
+    /**
+     * AST `$type`s this language's grammar produces. Synthesised into a minimal
+     * `Grammar` — one entry-less parser rule per type — which is exactly what
+     * `collectProducibleTypes` reads, so type→language routing
+     * (`buildLanguageTypeIndex`, `DataServer.resolveReferenceLanguage`) resolves
+     * against this stub the same way it does against generated grammars.
+     *
+     * Entry-less on purpose: `reachableParserRules` falls back to every parser
+     * rule when a grammar declares no entry rule, so each listed type is
+     * produced. A test that needs the reachability semantics itself (a rule
+     * present but unreachable) should build a real grammar rather than list it
+     * here.
+     */
+    readonly producedTypes?: readonly string[];
+    /**
+     * Per-language service slots the code under test reads (`references`,
+     * `serializer`, `ast`, …). Forwarded to {@link makeNoopLanguageServices},
+     * which supplies no-op defaults for the `shared` sub-tree only — an unlisted
+     * per-language slot stays absent and reads `undefined`.
+     */
+    readonly services?: NoopLanguageServicesOverrides;
+}
+/** Optional configuration for {@link makeStubServiceRegistry}. */
+export interface MakeStubServiceRegistryOptions {
+    /**
+     * Documents to declare open with a client-supplied `languageId`, as
+     * `{ [uri]: languageId }`. Drives the FIRST rung of Langium's lookup ladder
+     * (languageId, then file name, then extension) by standing in for the
+     * `workspace.TextDocuments` provider the registry consults.
+     */
+    readonly openLanguageIds?: Readonly<Record<string, string>>;
+}
+/**
+ * Test-facing view of a stub registry: the real
+ * {@link ExtendedServiceRegistry} surface plus seeding/introspection helpers.
+ */
+export interface StubServiceRegistry extends ExtendedServiceRegistry<ServerLanguageServices> {
+    /**
+     * Narrows Langium's `readonly LangiumCoreServices[]` to the framework's
+     * per-language type, so call sites reading a framework slot off a
+     * registered language (`references`, `serializer`, …) stay cast-free.
+     */
+    readonly all: readonly ServerLanguageServices[];
+    /** Registered stub language services by id, in registration order. */
+    readonly languagesById: ReadonlyMap<string, ServerLanguageServices>;
+    /**
+     * Declare `uri` open under `languageId`, so `getServices(uri)` resolves by
+     * the declared id rather than the extension. Pass an unregistered id to
+     * exercise the fall-through to file name / extension.
+     */
+    seedOpen(uri: string, languageId: string): void;
+    /** Undo a {@link seedOpen} — the document is no longer open. */
+    seedClosed(uri: string): void;
+}
+/**
+ * Build a {@link StubServiceRegistry} over the given stub languages.
+ *
+ * **The registry is REAL.** This double stubs the *languages*, not the
+ * registry: the returned object is the framework's own
+ * {@link ExtendedServiceRegistry}, so `getServices` walks Langium's actual
+ * lookup ladder (declared languageId → file name → extension), throws
+ * Langium's actual messages on a miss, and picks up `hasServices`,
+ * `getServicesById` and `getServicesByExtension` for free. Hand-rolled
+ * registry objects re-implement that ladder, and a re-implementation is
+ * exactly the fixture-vs-reality gap that lets a multi-grammar defect pass
+ * a green test.
+ *
+ * Pass the same descriptors to `makeTestServices`' `languages` option to
+ * get the registry bound on a full shared-services tree.
+ */
+export declare function makeStubServiceRegistry(languages: readonly StubLanguageDescriptor[], options?: MakeStubServiceRegistryOptions): StubServiceRegistry;
+//# sourceMappingURL=stub-service-registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stub-service-registry.d.ts","sourceRoot":"","sources":["../../src/testing/stub-service-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAIlF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAC5E,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,EAA4B,KAAK,6BAA6B,EAAE,MAAM,kCAAkC,CAAC;AAEhH;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACpC,2DAA2D;IAC3D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,4EAA4E;IAC5E,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C,+EAA+E;IAC/E,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC;;;;;;;;;;;;OAYG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,6BAA6B,CAAC;CACpD;AAED,kEAAkE;AAClE,MAAM,WAAW,8BAA8B;IAC5C;;;;;OAKG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAC9D;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAoB,SAAQ,uBAAuB,CAAC,sBAAsB,CAAC;IACzF;;;;OAIG;IACH,QAAQ,CAAC,GAAG,EAAE,SAAS,sBAAsB,EAAE,CAAC;IAChD,sEAAsE;IACtE,QAAQ,CAAC,aAAa,EAAE,WAAW,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;IACpE;;;;OAIG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAChD,gEAAgE;IAChE,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAkED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,uBAAuB,CACpC,SAAS,EAAE,SAAS,sBAAsB,EAAE,EAC5C,OAAO,GAAE,8BAAmC,GAC5C,mBAAmB,CAwBrB"}

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

@@ -0,0 +1,108 @@
+/********************************************************************************
+ * 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 { ExtendedServiceRegistry } from '../langium/service-registry.js';
+import { makeNoopLanguageServices } from './make-noop-language-services.js';
+/**
+ * Minimal `Grammar` carrying one parser rule per produced `$type`. Shaped for
+ * `collectProducibleTypes`, which reads `rules[].name` / `fragment` /
+ * `dataType` / `returnType` / `inferredType` and walks each rule's contents —
+ * an empty `Group` is a well-formed, action-free rule definition.
+ */
+function makeStubGrammar(producedTypes) {
+    return {
+        $type: 'Grammar',
+        rules: producedTypes.map(name => ({ $type: 'ParserRule', name, definition: { $type: 'Group', elements: [] } }))
+    };
+}
+/**
+ * A `TextDocumentProvider` over a plain uri→languageId map. Only `languageId`
+ * is populated: it is the sole field `DefaultServiceRegistry.getServices` reads
+ * off the returned document, so a fuller `TextDocument` shell would state a
+ * fidelity the stub does not have.
+ */
+function makeLanguageIdProvider(openLanguageIds) {
+    return {
+        get(uri) {
+            const languageId = openLanguageIds.get(uri.toString());
+            return languageId === undefined ? undefined : { languageId };
+        }
+    };
+}
+/**
+ * The framework's own {@link ExtendedServiceRegistry}, carrying stub languages
+ * and the seeding hooks {@link StubServiceRegistry} adds.
+ *
+ * Private per the test-support convention for doubles that must subclass a real
+ * production class (see `makeStubModelService`): the class is an implementation
+ * detail, {@link makeStubServiceRegistry} is the entry point.
+ */
+class StubServiceRegistryImpl extends ExtendedServiceRegistry {
+    openLanguageIds;
+    languagesById = new Map();
+    get all() {
+        return super.all;
+    }
+    constructor(openLanguageIds) {
+        // Langium reads exactly one thing off this argument — `workspace.TextDocuments`
+        // — and only to resolve an open document's declared languageId. Passing a
+        // provider-only shell keeps the stub free of a full shared-services tree.
+        super({ workspace: { TextDocuments: makeLanguageIdProvider(openLanguageIds) } });
+        this.openLanguageIds = openLanguageIds;
+    }
+    register(language) {
+        super.register(language);
+        this.languagesById.set(language.LanguageMetaData.languageId, language);
+    }
+    seedOpen(uri, languageId) {
+        this.openLanguageIds.set(uri, languageId);
+    }
+    seedClosed(uri) {
+        this.openLanguageIds.delete(uri);
+    }
+}
+/**
+ * Build a {@link StubServiceRegistry} over the given stub languages.
+ *
+ * **The registry is REAL.** This double stubs the *languages*, not the
+ * registry: the returned object is the framework's own
+ * {@link ExtendedServiceRegistry}, so `getServices` walks Langium's actual
+ * lookup ladder (declared languageId → file name → extension), throws
+ * Langium's actual messages on a miss, and picks up `hasServices`,
+ * `getServicesById` and `getServicesByExtension` for free. Hand-rolled
+ * registry objects re-implement that ladder, and a re-implementation is
+ * exactly the fixture-vs-reality gap that lets a multi-grammar defect pass
+ * a green test.
+ *
+ * Pass the same descriptors to `makeTestServices`' `languages` option to
+ * get the registry bound on a full shared-services tree.
+ */
+export function makeStubServiceRegistry(languages, options = {}) {
+    const registry = new StubServiceRegistryImpl(new Map(Object.entries(options.openLanguageIds ?? {})));
+    for (const descriptor of languages) {
+        registry.register(makeNoopLanguageServices({
+            // A real language always HAS the `references` group, so code
+            // reading `language.references.X` off a routed language is right to
+            // do so without a second optional chain. Seeding it empty keeps
+            // that true for a descriptor that names no reference service; the
+            // individual slots stay absent, so an unstubbed one still reads
+            // `undefined` rather than silently answering. A descriptor
+            // supplying `references` replaces this wholesale.
+            references: {},
+            ...descriptor.services,
+            Grammar: makeStubGrammar(descriptor.producedTypes ?? []),
+            LanguageMetaData: {
+                languageId: descriptor.languageId,
+                fileExtensions: [...descriptor.fileExtensions],
+                ...(descriptor.fileNames ? { fileNames: [...descriptor.fileNames] } : {})
+            }
+        }));
+    }
+    return registry;
+}
+//# sourceMappingURL=stub-service-registry.js.map

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

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

package/lib/testing/stub-writable-file-system.d.ts

@@ -0,0 +1,42 @@
+/********************************************************************************
+ * 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 { WritableFileSystemProvider } from '../documents/ast-document-manager.js';
+import type { StubSelfSaveRegistry } from './stub-self-save-registry.js';
+/**
+ * Stub for {@link WritableFileSystemProvider}. Records `writeFile` calls so
+ * tests can assert on the save path; reads return empty strings / empty
+ * directory listings (the framework's read paths don't run against this
+ * stub in the tests exercised today).
+ *
+ * When constructed with a {@link StubSelfSaveRegistry}, `writeFile` notifies
+ * the registry with the current wall-clock as the mtime — standing in for
+ * `DefaultFileSystemProvider.writeFile`, which registers the written file's
+ * real mtime so the watcher echo for the server's own write is suppressed.
+ *
+ * # Stub-vs-real surface
+ *
+ * Picks only the framework-relevant methods from {@link WritableFileSystemProvider}
+ * (`readFile`, `readDirectory`, `writeFile`); the compiler enforces those
+ * signatures stay aligned with the real interface. Langium's wider
+ * `FileSystemProvider` surface (`stat`, `statSync`, `exists`, `existsSync`,
+ * etc.) is deliberately not picked — tests that need it should construct
+ * the real `DefaultFileSystemProvider` instead. Binding the stub at
+ * `services.workspace.FileSystemProvider` therefore needs a narrowing cast at
+ * the binding site; casting the object literal itself would hide drift on the
+ * picked methods too.
+ */
+export interface StubWritableFileSystem extends Pick<WritableFileSystemProvider, 'readFile' | 'readDirectory' | 'writeFile'> {
+    readonly writes: ReadonlyArray<{
+        uri: string;
+        content: string;
+    }>;
+    reset(): void;
+}
+export declare function makeStubWritableFileSystem(selfSaveRegistry?: StubSelfSaveRegistry): StubWritableFileSystem;
+//# sourceMappingURL=stub-writable-file-system.d.ts.map

package/lib/testing/stub-writable-file-system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stub-writable-file-system.d.ts","sourceRoot":"","sources":["../../src/testing/stub-writable-file-system.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAGlF,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,sCAAsC,CAAC;AACvF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAEzE;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,WAAW,sBAAuB,SAAQ,IAAI,CAAC,0BAA0B,EAAE,UAAU,GAAG,eAAe,GAAG,WAAW,CAAC;IACzH,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjE,KAAK,IAAI,IAAI,CAAC;CAChB;AAED,wBAAgB,0BAA0B,CAAC,gBAAgB,CAAC,EAAE,oBAAoB,GAAG,sBAAsB,CAgB1G"}

package/lib/testing/stub-writable-file-system.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
+ ********************************************************************************/
+export function makeStubWritableFileSystem(selfSaveRegistry) {
+    const writes = [];
+    return {
+        get writes() {
+            return writes;
+        },
+        readFile: async () => '',
+        readDirectory: async () => [],
+        async writeFile(uri, content) {
+            writes.push({ uri: uri.toString(), content });
+            selfSaveRegistry?.register(uri.fsPath, Date.now());
+        },
+        reset() {
+            writes.length = 0;
+        }
+    };
+}
+//# sourceMappingURL=stub-writable-file-system.js.map

package/lib/testing/stub-writable-file-system.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stub-writable-file-system.js","sourceRoot":"","sources":["../../src/testing/stub-writable-file-system.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAkClF,MAAM,UAAU,0BAA0B,CAAC,gBAAuC;IAC/E,MAAM,MAAM,GAAuC,EAAE,CAAC;IACtD,OAAO;QACJ,IAAI,MAAM;YACP,OAAO,MAAM,CAAC;QACjB,CAAC;QACD,QAAQ,EAAE,KAAK,IAAI,EAAE,CAAC,EAAE;QACxB,aAAa,EAAE,KAAK,IAAI,EAAE,CAAC,EAAE;QAC7B,KAAK,CAAC,SAAS,CAAC,GAAQ,EAAE,OAAe;YACtC,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;YAC9C,gBAAgB,EAAE,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;QACtD,CAAC;QACD,KAAK;YACF,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;QACrB,CAAC;KACH,CAAC;AACL,CAAC"}

package/lib/util/connection-liveness.d.ts

@@ -0,0 +1,25 @@
+/********************************************************************************
+ * 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 `err` means "the peer is gone", as opposed to a genuine failure of
+ * the operation.
+ *
+ * The distinction is a **log-severity** one, and it matters because the two are
+ * indistinguishable at the call site otherwise. Pushing an edit to a language
+ * client that has already disconnected is a no-op, not a fault — it happens on
+ * every ordinary shutdown, and reporting it at `error` turns routine teardown
+ * into something that looks like it needs investigation. A real `applyEdit`
+ * failure (the client refused, the request malformed) still deserves `error`.
+ *
+ * Callers that only need to *survive* a dead connection rather than classify it
+ * should just catch — see `LspLogger.emit`, whose fallback path does exactly
+ * that, since a logger has nowhere to report a logging failure anyway.
+ */
+export declare function isConnectionGoneError(err: unknown): boolean;
+//# sourceMappingURL=connection-liveness.d.ts.map

package/lib/util/connection-liveness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection-liveness.d.ts","sourceRoot":"","sources":["../../src/util/connection-liveness.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAoBlF;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAI3D"}

package/lib/util/connection-liveness.js

@@ -0,0 +1,46 @@
+/********************************************************************************
+ * 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
+ ********************************************************************************/
+/**
+ * Phrases `vscode-jsonrpc` uses when a call loses its connection. Matched on the
+ * message because the condition surfaces in two different shapes:
+ *
+ * - a **throw** from `throwIfClosedOrDisposed` (`Connection is disposed.` /
+ *   `Connection is closed.`), a `ConnectionError` raised synchronously by
+ *   `sendRequest` / `sendNotification` and by `RemoteConsole.send`;
+ * - a **rejection** of an already-issued request (`Pending response rejected
+ *   since connection got disposed`), a `ResponseError` produced when the
+ *   pending-response map is drained on teardown.
+ *
+ * Both are typed, but they are different error classes carrying codes from
+ * different enums, so no single code check covers both. Kept
+ * lowercase-normalised and anchored on `connection` so an unrelated "disposed"
+ * message cannot match.
+ */
+const CONNECTION_GONE_PATTERNS = [/connection is disposed/, /connection is closed/, /connection got disposed/, /connection got closed/];
+/**
+ * Whether `err` means "the peer is gone", as opposed to a genuine failure of
+ * the operation.
+ *
+ * The distinction is a **log-severity** one, and it matters because the two are
+ * indistinguishable at the call site otherwise. Pushing an edit to a language
+ * client that has already disconnected is a no-op, not a fault — it happens on
+ * every ordinary shutdown, and reporting it at `error` turns routine teardown
+ * into something that looks like it needs investigation. A real `applyEdit`
+ * failure (the client refused, the request malformed) still deserves `error`.
+ *
+ * Callers that only need to *survive* a dead connection rather than classify it
+ * should just catch — see `LspLogger.emit`, whose fallback path does exactly
+ * that, since a logger has nowhere to report a logging failure anyway.
+ */
+export function isConnectionGoneError(err) {
+    const message = err instanceof Error ? err.message : String(err);
+    const normalized = message.toLowerCase();
+    return CONNECTION_GONE_PATTERNS.some(pattern => pattern.test(normalized));
+}
+//# sourceMappingURL=connection-liveness.js.map

package/lib/util/connection-liveness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection-liveness.js","sourceRoot":"","sources":["../../src/util/connection-liveness.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,wBAAwB,GAAG,CAAC,wBAAwB,EAAE,sBAAsB,EAAE,yBAAyB,EAAE,uBAAuB,CAAC,CAAC;AAExI;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,qBAAqB,CAAC,GAAY;IAC/C,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACjE,MAAM,UAAU,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IACzC,OAAO,wBAAwB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;AAC7E,CAAC"}

package/lib/util/environment.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
+ ********************************************************************************/
+/** `process.env` when a Node `process` exposes it, else `undefined`. */
+export declare function processEnv(): NodeJS.ProcessEnv | undefined;
+/** `process.pid` when available, else `undefined` (browser). */
+export declare function processPid(): number | undefined;
+/**
+ * Whether the host filesystem treats paths case-insensitively — `true` on
+ * Windows and macOS, `false` on Linux and in a browser.
+ *
+ * Capability cannot be detected without touching the filesystem, so this reads
+ * `process.platform` and answers `false` when there is none. That default is
+ * the safe one: folding case where the filesystem does NOT would make two
+ * genuinely distinct files collide, which is a correctness bug, whereas failing
+ * to fold merely misses an optimisation.
+ */
+export declare function isCaseInsensitiveFileSystem(): boolean;
+/** Node `process` lifecycle / error / signal events accepted by {@link onProcessEvent}. */
+export type ProcessEvent = 'exit' | 'beforeExit' | 'uncaughtException' | 'unhandledRejection' | 'rejectionHandled' | 'warning' | 'SIGINT' | 'SIGTERM' | 'SIGHUP';
+/**
+ * Register a process lifecycle handler (`'exit'`, `'unhandledRejection'`, …) if
+ * a Node `process` with `on` is present; a no-op in a browser worker (no
+ * `process`, no such events).
+ */
+export declare function onProcessEvent(event: ProcessEvent, handler: (...args: unknown[]) => void): void;
+/**
+ * Write already-formatted text to the process's standard error, when a
+ * Node-like `process` exposes one. Returns `true` when the text was written and
+ * `false` in a browser, so a caller can fall back to `console.*`.
+ *
+ * Exists because **a server's stdout is a data channel, not a log channel**: an
+ * LSP or data-server head launched over stdio carries JSON-RPC frames on
+ * stdout, so a log line written there corrupts the protocol stream. `stderr` is
+ * the diagnostics channel by the same convention, and is the stream a parent
+ * process inherits when it spawns a head as a child.
+ */
+export declare function writeStderr(text: string): boolean;
+/**
+ * `process.memoryUsage()` guarded for non-Node hosts — `undefined` in a browser
+ * (where a partial `process` shim has no `memoryUsage`).
+ */
+export declare function currentMemoryUsage(): {
+    heapUsed: number;
+    heapTotal: number;
+    rss: number;
+} | undefined;
+//# sourceMappingURL=environment.d.ts.map

package/lib/util/environment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.d.ts","sourceRoot":"","sources":["../../src/util/environment.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAYlF,wEAAwE;AACxE,wBAAgB,UAAU,IAAI,MAAM,CAAC,UAAU,GAAG,SAAS,CAE1D;AAED,gEAAgE;AAChE,wBAAgB,UAAU,IAAI,MAAM,GAAG,SAAS,CAE/C;AAED;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,IAAI,OAAO,CAGrD;AAED,2FAA2F;AAC3F,MAAM,MAAM,YAAY,GACrB,MAAM,GAAG,YAAY,GAAG,mBAAmB,GAAG,oBAAoB,GAAG,kBAAkB,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEzI;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,IAAI,CAI/F;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAMjD;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAKrG"}

package/lib/util/environment.js

@@ -0,0 +1,78 @@
+/********************************************************************************
+ * 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
+ ********************************************************************************/
+// The single home for Node-global access in neutral (`.`-entry) code. Neutral
+// code never touches `process` / `Buffer` directly (enforced by the eslint
+// `no-restricted-globals` ban, whose only neutral exemption is this module); it
+// goes through these guarded accessors so it degrades cleanly in a browser.
+//
+// Capability-detected, NOT environment-detected: bundlers inject a partial
+// `process` shim into browser builds (Theia's browser-app has `process.env` but
+// no `process.memoryUsage` / `fs`), so `typeof process` alone is not a reliable
+// "am I in Node" check. Each accessor only claims the specific API it tests.
+/** `process.env` when a Node `process` exposes it, else `undefined`. */
+export function processEnv() {
+    return typeof process !== 'undefined' && process.env ? process.env : undefined;
+}
+/** `process.pid` when available, else `undefined` (browser). */
+export function processPid() {
+    return typeof process !== 'undefined' ? process.pid : undefined;
+}
+/**
+ * Whether the host filesystem treats paths case-insensitively — `true` on
+ * Windows and macOS, `false` on Linux and in a browser.
+ *
+ * Capability cannot be detected without touching the filesystem, so this reads
+ * `process.platform` and answers `false` when there is none. That default is
+ * the safe one: folding case where the filesystem does NOT would make two
+ * genuinely distinct files collide, which is a correctness bug, whereas failing
+ * to fold merely misses an optimisation.
+ */
+export function isCaseInsensitiveFileSystem() {
+    const platform = typeof process !== 'undefined' ? process.platform : undefined;
+    return platform === 'win32' || platform === 'darwin';
+}
+/**
+ * Register a process lifecycle handler (`'exit'`, `'unhandledRejection'`, …) if
+ * a Node `process` with `on` is present; a no-op in a browser worker (no
+ * `process`, no such events).
+ */
+export function onProcessEvent(event, handler) {
+    if (typeof process !== 'undefined' && typeof process.on === 'function') {
+        process.on(event, handler);
+    }
+}
+/**
+ * Write already-formatted text to the process's standard error, when a
+ * Node-like `process` exposes one. Returns `true` when the text was written and
+ * `false` in a browser, so a caller can fall back to `console.*`.
+ *
+ * Exists because **a server's stdout is a data channel, not a log channel**: an
+ * LSP or data-server head launched over stdio carries JSON-RPC frames on
+ * stdout, so a log line written there corrupts the protocol stream. `stderr` is
+ * the diagnostics channel by the same convention, and is the stream a parent
+ * process inherits when it spawns a head as a child.
+ */
+export function writeStderr(text) {
+    if (typeof process === 'undefined' || !process.stderr || typeof process.stderr.write !== 'function') {
+        return false;
+    }
+    process.stderr.write(text);
+    return true;
+}
+/**
+ * `process.memoryUsage()` guarded for non-Node hosts — `undefined` in a browser
+ * (where a partial `process` shim has no `memoryUsage`).
+ */
+export function currentMemoryUsage() {
+    if (typeof process === 'undefined' || typeof process.memoryUsage !== 'function') {
+        return undefined;
+    }
+    return process.memoryUsage();
+}
+//# sourceMappingURL=environment.js.map

package/lib/util/environment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.js","sourceRoot":"","sources":["../../src/util/environment.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,8EAA8E;AAC9E,2EAA2E;AAC3E,gFAAgF;AAChF,4EAA4E;AAC5E,EAAE;AACF,2EAA2E;AAC3E,gFAAgF;AAChF,gFAAgF;AAChF,6EAA6E;AAE7E,wEAAwE;AACxE,MAAM,UAAU,UAAU;IACvB,OAAO,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;AAClF,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,UAAU;IACvB,OAAO,OAAO,OAAO,KAAK,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;AACnE,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,2BAA2B;IACxC,MAAM,QAAQ,GAAG,OAAO,OAAO,KAAK,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/E,OAAO,QAAQ,KAAK,OAAO,IAAI,QAAQ,KAAK,QAAQ,CAAC;AACxD,CAAC;AAMD;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,KAAmB,EAAE,OAAqC;IACtF,IAAI,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,OAAO,CAAC,EAAE,KAAK,UAAU,EAAE,CAAC;QACtE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAC9B,CAAC;AACJ,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY;IACrC,IAAI,OAAO,OAAO,KAAK,WAAW,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;QACnG,OAAO,KAAK,CAAC;IAChB,CAAC;IACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC3B,OAAO,IAAI,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB;IAC/B,IAAI,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,OAAO,CAAC,WAAW,KAAK,UAAU,EAAE,CAAC;QAC/E,OAAO,SAAS,CAAC;IACpB,CAAC;IACD,OAAO,OAAO,CAAC,WAAW,EAAE,CAAC;AAChC,CAAC"}

package/lib/util/index.d.ts

@@ -0,0 +1,13 @@
+/********************************************************************************
+ * 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 './connection-liveness.js';
+export * from './environment.js';
+export * from './registry.js';
+import '@hydranium/langium';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/util/index.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,cAAc,0BAA0B,CAAC;AACzC,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAM9B,OAAO,oBAAoB,CAAC"}

package/lib/util/index.js

@@ -0,0 +1,18 @@
+/********************************************************************************
+ * 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 './connection-liveness.js';
+export * from './environment.js';
+export * from './registry.js';
+// Side-effect import: the `UriUtils` namespace augmentation
+// (`UriUtils.toUri` / `.isAncestorOrEqual`) lives in the langium chokepoint.
+// Pulling it in here keeps it loaded for any consumer importing from
+// `@hydranium/core/util`, and the chokepoint also loads it whenever any
+// `@hydranium/langium` symbol is imported.
+import '@hydranium/langium';
+//# sourceMappingURL=index.js.map

package/lib/util/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/util/index.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,cAAc,0BAA0B,CAAC;AACzC,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,4DAA4D;AAC5D,6EAA6E;AAC7E,qEAAqE;AACrE,wEAAwE;AACxE,2CAA2C;AAC3C,OAAO,oBAAoB,CAAC"}