@hydranium/core 1.0.0-next.10

package/lib/langium/workspace/index-manager.js

@@ -0,0 +1,245 @@
+/********************************************************************************
+ * 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 { DefaultIndexManager } from '@hydranium/langium';
+/**
+ * Default `IndexManager` for `@hydranium/core` consumers. Layers an
+ * additional **`elementsByName: name → descriptions`** index on top of
+ * Langium's {@link DefaultIndexManager} so consumers can look up
+ * descriptions by exact name in O(1) instead of streaming the whole
+ * index. Provides the resolution helpers built on that index:
+ *
+ * - {@link getElementsByName} — O(1) name lookup returning every match,
+ *   optionally narrowed by reference type and owning language.
+ * - {@link getElementByName} — the single-answer form, abstaining when the
+ *   name does not identify exactly one element.
+ * - {@link resolveElement} — turn an `AstNodeDescription` into the
+ *   actual `AstNode` via `LangiumDocuments` + `AstNodeLocator`.
+ * - {@link resolveElementByName} — composition of the two.
+ * - {@link resolveSemanticElement} — resolve a document's root node;
+ *   default returns the parse-result root, consumers with wrapper
+ *   grammars override to return the inner semantic root via
+ *   {@link findSemanticRoot}.
+ *
+ * The `elementsByName` index is maintained incrementally inside
+ * Langium's `updateContent` / `removeContent` lifecycle. Subclasses
+ * that add their own indexes (e.g. a reverse map from project to
+ * member URIs for project-tier queries) override `updateContent` /
+ * `removeContent` and chain `super`.
+ */
+export class HydraniumIndexManager extends DefaultIndexManager {
+    /** Maps `description.name` → list of descriptions with that name. Used for O(1) `getElementByName`. */
+    elementsByName = new Map();
+    sharedServices;
+    tracer;
+    constructor(services, options = {}) {
+        super(services);
+        this.sharedServices = services;
+        this.tracer = services.Tracer.for(options.logName ?? 'IndexManager').trace('instantiated');
+    }
+    /**
+     * Lazy access to {@link ProjectManager}. Reading it eagerly in the
+     * constructor caused a DI cycle in project-aware consumers
+     * (`DocumentBuilder → IndexManager → ProjectManager →
+     * DocumentBuilder`); deferring the read until first use breaks the
+     * cycle without splitting the bindings.
+     */
+    get projectManager() {
+        return this.sharedServices.workspace.ProjectManager;
+    }
+    // ============================================================
+    // Incremental index maintenance
+    // ============================================================
+    async updateContent(document, cancelToken) {
+        const uriStr = document.uri.toString();
+        this.removeFromElementsByName(uriStr);
+        await super.updateContent(document, cancelToken);
+        this.addToElementsByName(uriStr);
+    }
+    removeContent(uri) {
+        this.removeFromElementsByName(uri.toString());
+        super.removeContent(uri);
+    }
+    /**
+     * Drop all entries this URI contributed to {@link elementsByName}.
+     * Reads from `symbolIndex` which still holds the old descriptions at
+     * this point (we run *before* `super` clears them).
+     */
+    removeFromElementsByName(uriStr) {
+        const oldDescs = this.symbolIndex.get(uriStr);
+        if (!oldDescs) {
+            return;
+        }
+        for (const desc of oldDescs) {
+            const entries = this.elementsByName.get(desc.name);
+            if (!entries) {
+                continue;
+            }
+            const filtered = entries.filter(entry => entry.documentUri.toString() !== uriStr);
+            if (filtered.length === 0) {
+                this.elementsByName.delete(desc.name);
+            }
+            else {
+                this.elementsByName.set(desc.name, filtered);
+            }
+        }
+    }
+    /**
+     * Add this URI's fresh contributions to {@link elementsByName}. Reads
+     * from `symbolIndex` which now holds the new descriptions (we run
+     * *after* `super.updateContent` populated them).
+     */
+    addToElementsByName(uriStr) {
+        const newDescs = this.symbolIndex.get(uriStr);
+        if (!newDescs) {
+            return;
+        }
+        for (const desc of newDescs) {
+            const entries = this.elementsByName.get(desc.name);
+            if (entries) {
+                entries.push(desc);
+            }
+            else {
+                this.elementsByName.set(desc.name, [desc]);
+            }
+        }
+    }
+    // ============================================================
+    // Lookup + resolution helpers
+    // ============================================================
+    /**
+     * O(1) lookup by exact name, returning EVERY match — optionally
+     * narrowed by reference type (via Langium's `AstReflection.isSubtype`,
+     * so grammar subtype relations are honoured) and by the owning
+     * document's language.
+     *
+     * The name index spans every language in the workspace, so a name is
+     * only as unique as the adopter's naming scheme makes it. Callers that
+     * need one answer go through {@link getElementByName}, which abstains
+     * when the name does not identify a single element; callers that can
+     * disambiguate from context (or want to report the ambiguity) use this.
+     */
+    getElementsByName(name, type, languageId) {
+        const candidates = this.elementsByName.get(name);
+        if (!candidates || candidates.length === 0) {
+            return [];
+        }
+        const byType = type ? candidates.filter(candidate => this.astReflection.isSubtype(candidate.type, type)) : candidates;
+        if (languageId === undefined) {
+            return byType;
+        }
+        return byType.filter(candidate => this.languageIdOf(candidate.documentUri) === languageId);
+    }
+    /**
+     * O(1) lookup by exact name, returning the FIRST match — optionally
+     * narrowed by reference type and owning language.
+     *
+     * **First-match is deliberate here, and is not a routing answer.** A real
+     * workspace indexes one logical element under several descriptions: scope
+     * computation emits a symbol per visibility tier, and a wrapper grammar
+     * exports both its document root and its inner semantic root. So a
+     * multi-match is usually one element seen several ways, and abstaining on
+     * it would empty every reference dropdown that resolves a scope's source
+     * by name.
+     *
+     * What genuinely IS ambiguous — the same name in two different DOCUMENTS —
+     * cannot be told apart from that here, only by a caller that knows what it
+     * is asking. {@link getElementsByName} exposes the full set for callers that
+     * must distinguish; the useful test is whether the matches disagree on the
+     * document, which is the only distinction language routing needs.
+     */
+    getElementByName(name, type, languageId) {
+        return this.getElementsByName(name, type, languageId)[0];
+    }
+    /**
+     * The language id owning a document, or `undefined` when its URI
+     * matches no registered language. Non-throwing: an indexed document
+     * whose URI no longer routes must not break an unrelated lookup.
+     *
+     * One walk of the lookup ladder, via `getServicesFor`. The obvious
+     * `hasServices(uri) && getServices(uri)` pair costs two, because Langium
+     * implements `hasServices` as a try/catch around `getServices` — and this
+     * runs once per CANDIDATE inside {@link getElementsByName}'s language filter.
+     */
+    languageIdOf(documentUri) {
+        return this.sharedServices.ServiceRegistry.getServicesFor(documentUri)?.LanguageMetaData.languageId;
+    }
+    /** Turn an `AstNodeDescription` into the actual `AstNode` via the language-specific `AstNodeLocator`. */
+    resolveElement(description) {
+        if (!description) {
+            return undefined;
+        }
+        const langiumDocument = this.documents.getDocument(description.documentUri);
+        if (!langiumDocument) {
+            return undefined;
+        }
+        const languageServices = this.serviceRegistry.getServices(description.documentUri);
+        return languageServices.workspace.AstNodeLocator.getAstNode(langiumDocument.parseResult.value, description.path);
+    }
+    /** Compose {@link getElementByName} with {@link resolveElement}. */
+    resolveElementByName(name, type, languageId) {
+        return this.resolveElement(this.getElementByName(name, type, languageId));
+    }
+    /**
+     * Project-scoped element listing — all descriptions whose owning URI
+     * belongs to the given project. Equivalent to Langium's
+     * `allElements(type)` but filtered to one project's members.
+     *
+     * Returns direct members only — **no visibility transitivity is
+     * applied**. For "everything visible from project X", map
+     * {@link ProjectManager.getVisibleProjects} over this method and
+     * flatten the result.
+     *
+     * Returns an empty array if the project id is unknown.
+     */
+    getElementsInProject(projectId, type) {
+        const memberUris = this.projectManager.getProjectUris(projectId);
+        if (memberUris.length === 0) {
+            return [];
+        }
+        const memberUriSet = new Set();
+        for (const uri of memberUris) {
+            memberUriSet.add(uri.toString());
+        }
+        const result = [];
+        for (const bucket of this.elementsByName.values()) {
+            for (const description of bucket) {
+                if (!memberUriSet.has(description.documentUri.toString())) {
+                    continue;
+                }
+                if (type && !this.astReflection.isSubtype(description.type, type)) {
+                    continue;
+                }
+                result.push(description);
+            }
+        }
+        return result;
+    }
+    /**
+     * Resolve the "semantic root" of a document — the meaningful root
+     * element callers expect when treating the document as a unit.
+     * Default returns the parse-result root directly; consumers with a
+     * wrapper grammar (a generic envelope with a single inner element)
+     * override {@link findSemanticRoot} to return the inner element.
+     */
+    resolveSemanticElement(uri) {
+        const document = this.documents.getDocument(uri);
+        if (!document) {
+            return undefined;
+        }
+        return this.findSemanticRoot(document);
+    }
+    /**
+     * Default: the document's parse-result root. Override for wrapper
+     * grammars that store the meaningful root inside an envelope.
+     */
+    findSemanticRoot(document) {
+        return document.parseResult.value;
+    }
+}
+//# sourceMappingURL=index-manager.js.map

package/lib/langium/workspace/index-manager.js.map

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

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

@@ -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 * from './document-uri-policy.js';
+export * from './file-system-provider.js';
+export * from './in-memory-file-system-provider.js';
+export * from './persistent-file-system-provider.js';
+export * from './index-manager.js';
+export * from './initialize-workspace.js';
+export * from './langium-documents.js';
+export * from './hydranium-workspace-manager.js';
+export * from './hydranium-workspace-lock.js';
+export * from './write-lock-scope.js';
+export * from './hydranium-langium-document-factory.js';
+export * from './additional-document-contribution.js';
+export * from './synthetic.js';
+export * from './virtual-document.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/langium/workspace/index.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,cAAc,0BAA0B,CAAC;AACzC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qCAAqC,CAAC;AACpD,cAAc,sCAAsC,CAAC;AACrD,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC;AACvC,cAAc,kCAAkC,CAAC;AACjD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,uBAAuB,CAAC;AACtC,cAAc,yCAAyC,CAAC;AACxD,cAAc,uCAAuC,CAAC;AACtD,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC"}

package/lib/langium/workspace/index.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 * from './document-uri-policy.js';
+export * from './file-system-provider.js';
+export * from './in-memory-file-system-provider.js';
+export * from './persistent-file-system-provider.js';
+export * from './index-manager.js';
+export * from './initialize-workspace.js';
+export * from './langium-documents.js';
+export * from './hydranium-workspace-manager.js';
+export * from './hydranium-workspace-lock.js';
+export * from './write-lock-scope.js';
+export * from './hydranium-langium-document-factory.js';
+export * from './additional-document-contribution.js';
+export * from './synthetic.js';
+export * from './virtual-document.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/langium/workspace/index.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,cAAc,0BAA0B,CAAC;AACzC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qCAAqC,CAAC;AACpD,cAAc,sCAAsC,CAAC;AACrD,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC;AACvC,cAAc,kCAAkC,CAAC;AACjD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,uBAAuB,CAAC;AACtC,cAAc,yCAAyC,CAAC;AACxD,cAAc,uCAAuC,CAAC;AACtD,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC"}

package/lib/langium/workspace/initialize-workspace.d.ts

@@ -0,0 +1,63 @@
+/********************************************************************************
+ * 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 { URI } from '@hydranium/langium';
+import type { ServerSharedServicesMinimal } from '../shared-services.js';
+/** A workspace folder root accepted by the headless init seams: a filesystem path or a {@link URI}. */
+export type WorkspaceFolderInput = string | URI;
+/**
+ * Initialize a hydranium workspace **without an LSP `initialize` request** —
+ * the headless counterpart to the editor entry. Drives the workspace manager's
+ * own lifecycle methods: sets the workspace folders, then runs the
+ * lock-protected discovery + standard init build.
+ *
+ * Leaves the workspace exactly as an LSP `initialize`/`initialized` pair would:
+ * `ProjectManager.discoverProjects` has run, the project registry is populated,
+ * and the init build has covered every document in the workspace folders —
+ * including the project descriptors, which `HydraniumWorkspaceManager.performStartup`
+ * back-fills because Langium's traversal drops URIs discovery already created a
+ * document for. Documents outside the folders (a contributed library document
+ * seeded elsewhere, a URI a client opens later) still build on demand; use
+ * {@link buildWorkspaceProgrammatically} to force every registered document
+ * built regardless of where it came from. The eager build pipeline (integrity,
+ * AST extensions) is wired at bootstrap (`DEFAULT_EAGER_SERVICES`), not here, so
+ * it is already active.
+ *
+ * Client-only LSP-init steps (configuration fetch, server-capability
+ * negotiation, `onInitialize`/`onInitialized` events) are intentionally not
+ * reproduced — a headless server has no client and they degrade gracefully.
+ *
+ * Invoke once during headless startup; this is not a re-initialization API.
+ * Errors from discovery/build propagate to the caller.
+ *
+ * @param services the shared services tree the workspace manager lives on
+ * @param folders one or more workspace roots (filesystem paths or URIs)
+ */
+export declare function initializeWorkspaceProgrammatically(services: ServerSharedServicesMinimal, folders: WorkspaceFolderInput | ReadonlyArray<WorkspaceFolderInput>): Promise<void>;
+/**
+ * {@link initializeWorkspaceProgrammatically} **and then build every registered
+ * document to `Validated`** — the "fully-built workspace" convenience for
+ * headless consumers (test harnesses, eager batch tools) that want every
+ * registered document linked + validated, not only the ones inside a workspace
+ * folder.
+ *
+ * The trailing `DocumentBuilder.build(..., { validation: true })` over
+ * `LangiumDocuments.all` picks up anything the init build did not reach —
+ * documents registered from outside the folders. For a workspace whose content
+ * the init build already covered it is effectively idempotent, since the builder
+ * skips documents already at the target state.
+ *
+ * Use {@link initializeWorkspaceProgrammatically} instead when you only need the
+ * project registry populated (e.g. listing projects) and want documents to build
+ * on demand, as an editor session does.
+ *
+ * @param services the shared services tree the workspace manager lives on
+ * @param folders one or more workspace roots (filesystem paths or URIs)
+ */
+export declare function buildWorkspaceProgrammatically(services: ServerSharedServicesMinimal, folders: WorkspaceFolderInput | ReadonlyArray<WorkspaceFolderInput>): Promise<void>;
+//# sourceMappingURL=initialize-workspace.d.ts.map

package/lib/langium/workspace/initialize-workspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"initialize-workspace.d.ts","sourceRoot":"","sources":["../../../src/langium/workspace/initialize-workspace.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EAAY,GAAG,EAAE,MAAM,oBAAoB,CAAC;AAMnD,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,uBAAuB,CAAC;AAEzE,uGAAuG;AACvG,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,GAAG,CAAC;AAehD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAsB,mCAAmC,CACtD,QAAQ,EAAE,2BAA2B,EACrC,OAAO,EAAE,oBAAoB,GAAG,aAAa,CAAC,oBAAoB,CAAC,GACnE,OAAO,CAAC,IAAI,CAAC,CAQf;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,8BAA8B,CACjD,QAAQ,EAAE,2BAA2B,EACrC,OAAO,EAAE,oBAAoB,GAAG,aAAa,CAAC,oBAAoB,CAAC,GACnE,OAAO,CAAC,IAAI,CAAC,CAIf"}

package/lib/langium/workspace/initialize-workspace.js

@@ -0,0 +1,88 @@
+/********************************************************************************
+ * 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 { UriUtils, URI } from '@hydranium/langium';
+// Bare `'path'` (not `node:path`) so a browser bundle can alias it to a POSIX
+// shim — this is the only filesystem-path use left on the portable `.` entry,
+// and it's the headless/CLI string-input convenience of `toWorkspaceFolders`.
+import * as path from 'path';
+/**
+ * Normalize the seam's flexible folder argument to LSP {@link WorkspaceFolder}s.
+ * A `string` is resolved to an absolute filesystem path and wrapped as a
+ * `file:` URI; a {@link URI} is taken as-is. `name` is the URI's basename.
+ */
+function toWorkspaceFolders(folders) {
+    const list = Array.isArray(folders) ? folders : [folders];
+    return list.map(entry => {
+        const uri = typeof entry === 'string' ? URI.file(path.resolve(entry)) : entry;
+        return { uri: uri.toString(), name: UriUtils.basename(uri) };
+    });
+}
+/**
+ * Initialize a hydranium workspace **without an LSP `initialize` request** —
+ * the headless counterpart to the editor entry. Drives the workspace manager's
+ * own lifecycle methods: sets the workspace folders, then runs the
+ * lock-protected discovery + standard init build.
+ *
+ * Leaves the workspace exactly as an LSP `initialize`/`initialized` pair would:
+ * `ProjectManager.discoverProjects` has run, the project registry is populated,
+ * and the init build has covered every document in the workspace folders —
+ * including the project descriptors, which `HydraniumWorkspaceManager.performStartup`
+ * back-fills because Langium's traversal drops URIs discovery already created a
+ * document for. Documents outside the folders (a contributed library document
+ * seeded elsewhere, a URI a client opens later) still build on demand; use
+ * {@link buildWorkspaceProgrammatically} to force every registered document
+ * built regardless of where it came from. The eager build pipeline (integrity,
+ * AST extensions) is wired at bootstrap (`DEFAULT_EAGER_SERVICES`), not here, so
+ * it is already active.
+ *
+ * Client-only LSP-init steps (configuration fetch, server-capability
+ * negotiation, `onInitialize`/`onInitialized` events) are intentionally not
+ * reproduced — a headless server has no client and they degrade gracefully.
+ *
+ * Invoke once during headless startup; this is not a re-initialization API.
+ * Errors from discovery/build propagate to the caller.
+ *
+ * @param services the shared services tree the workspace manager lives on
+ * @param folders one or more workspace roots (filesystem paths or URIs)
+ */
+export async function initializeWorkspaceProgrammatically(services, folders) {
+    const workspaceFolders = toWorkspaceFolders(folders);
+    const manager = services.workspace.WorkspaceManager;
+    // `initialize` records the folders (DefaultWorkspaceManager reads only this
+    // field); `initialized` runs `mutex.write(initializeWorkspace)` and resolves
+    // once discovery + the init build settle, so awaiting it is the ready gate.
+    manager.initialize({ workspaceFolders });
+    await manager.initialized({});
+}
+/**
+ * {@link initializeWorkspaceProgrammatically} **and then build every registered
+ * document to `Validated`** — the "fully-built workspace" convenience for
+ * headless consumers (test harnesses, eager batch tools) that want every
+ * registered document linked + validated, not only the ones inside a workspace
+ * folder.
+ *
+ * The trailing `DocumentBuilder.build(..., { validation: true })` over
+ * `LangiumDocuments.all` picks up anything the init build did not reach —
+ * documents registered from outside the folders. For a workspace whose content
+ * the init build already covered it is effectively idempotent, since the builder
+ * skips documents already at the target state.
+ *
+ * Use {@link initializeWorkspaceProgrammatically} instead when you only need the
+ * project registry populated (e.g. listing projects) and want documents to build
+ * on demand, as an editor session does.
+ *
+ * @param services the shared services tree the workspace manager lives on
+ * @param folders one or more workspace roots (filesystem paths or URIs)
+ */
+export async function buildWorkspaceProgrammatically(services, folders) {
+    await initializeWorkspaceProgrammatically(services, folders);
+    const documents = services.workspace.LangiumDocuments.all.toArray();
+    await services.workspace.DocumentBuilder.build(documents, { validation: true });
+}
+//# sourceMappingURL=initialize-workspace.js.map

package/lib/langium/workspace/initialize-workspace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"initialize-workspace.js","sourceRoot":"","sources":["../../../src/langium/workspace/initialize-workspace.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AACnD,8EAA8E;AAC9E,8EAA8E;AAC9E,8EAA8E;AAC9E,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAO7B;;;;GAIG;AACH,SAAS,kBAAkB,CAAC,OAAmE;IAC5F,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAA+B,CAAC,CAAC;IAClF,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE;QACrB,MAAM,GAAG,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QAC9E,OAAO,EAAE,GAAG,EAAE,GAAG,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;IAChE,CAAC,CAAC,CAAC;AACN,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,CAAC,KAAK,UAAU,mCAAmC,CACtD,QAAqC,EACrC,OAAmE;IAEnE,MAAM,gBAAgB,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;IACrD,MAAM,OAAO,GAAG,QAAQ,CAAC,SAAS,CAAC,gBAAgB,CAAC;IACpD,4EAA4E;IAC5E,6EAA6E;IAC7E,4EAA4E;IAC5E,OAAO,CAAC,UAAU,CAAC,EAAE,gBAAgB,EAAsB,CAAC,CAAC;IAC7D,MAAM,OAAO,CAAC,WAAW,CAAC,EAAuB,CAAC,CAAC;AACtD,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,KAAK,UAAU,8BAA8B,CACjD,QAAqC,EACrC,OAAmE;IAEnE,MAAM,mCAAmC,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC7D,MAAM,SAAS,GAAG,QAAQ,CAAC,SAAS,CAAC,gBAAgB,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;IACpE,MAAM,QAAQ,CAAC,SAAS,CAAC,eAAe,CAAC,KAAK,CAAC,SAAS,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;AACnF,CAAC"}

package/lib/langium/workspace/langium-documents.d.ts

@@ -0,0 +1,47 @@
+/********************************************************************************
+ * 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 Tracer } from '@hydranium/protocol';
+import { type AstNode, DefaultLangiumDocuments, type LangiumDocument, type URI } from '@hydranium/langium';
+import { type ServerSharedServicesMinimal } from '../shared-services.js';
+import { type DocumentUriPolicy } from './document-uri-policy.js';
+/**
+ * Default `LangiumDocuments` for `@hydranium/core` consumers. Layers two
+ * extensions on top of Langium's {@link DefaultLangiumDocuments}:
+ *
+ * 1. **Identity via the {@link DocumentUriPolicy} seam.**
+ *    `getOrCreateDocument` resolves the requested URI through the seam — the
+ *    same identity the text store and the AST-document event filters use — so
+ *    an adopter that strengthens document identity (e.g. resolving symlinks to
+ *    a real path) does so by binding the policy *once*, with no
+ *    `LangiumDocuments` override. The default resolves to the URI unchanged
+ *    (`DefaultDocumentUriPolicy`), matching Langium's own keying.
+ *
+ * 2. **`createEmptyDocument(uri)` — synchronous** factory for a transient
+ *    document with no loadable on-disk content. `getOrCreateDocument` falls
+ *    back to it when the seam reports no loadable URI, or when `super` cannot
+ *    load it, so callers always receive a document. Abstract because the
+ *    parse-result root is grammar-specific (each grammar returns its own
+ *    root node type). The fallback document is deliberately
+ *    **not** registered: a transient placeholder must not mask the real
+ *    document once it appears.
+ */
+export declare abstract class AbstractHydraniumLangiumDocuments extends DefaultLangiumDocuments {
+    protected readonly services: ServerSharedServicesMinimal;
+    /** Document-identity seam, shared with the text store, event filters, and builder. */
+    protected readonly uriPolicy: DocumentUriPolicy;
+    protected readonly tracer: Tracer;
+    constructor(services: ServerSharedServicesMinimal);
+    /**
+     * Build a transient empty document for `uri`. Implemented by consumers
+     * because the parse-result root is grammar-specific.
+     */
+    abstract createEmptyDocument(uri: URI): LangiumDocument<AstNode>;
+    getOrCreateDocument(uri: URI): Promise<LangiumDocument<AstNode>>;
+}
+//# sourceMappingURL=langium-documents.d.ts.map

package/lib/langium/workspace/langium-documents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"langium-documents.d.ts","sourceRoot":"","sources":["../../../src/langium/workspace/langium-documents.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,KAAK,OAAO,EAAE,uBAAuB,EAAE,KAAK,eAAe,EAAE,KAAK,GAAG,EAAE,MAAM,oBAAoB,CAAC;AAC3G,OAAO,EAAE,KAAK,2BAA2B,EAAE,MAAM,uBAAuB,CAAC;AACzE,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAElE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,8BAAsB,iCAAkC,SAAQ,uBAAuB;uBAK5C,QAAQ,EAAE,2BAA2B;IAJ7E,sFAAsF;IACtF,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAC;IAChD,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEM,QAAQ,EAAE,2BAA2B;IAM7E;;;OAGG;IACH,QAAQ,CAAC,mBAAmB,CAAC,GAAG,EAAE,GAAG,GAAG,eAAe,CAAC,OAAO,CAAC;IAEjD,mBAAmB,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;CAyCjF"}

package/lib/langium/workspace/langium-documents.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 { DefaultLangiumDocuments } from '@hydranium/langium';
+/**
+ * Default `LangiumDocuments` for `@hydranium/core` consumers. Layers two
+ * extensions on top of Langium's {@link DefaultLangiumDocuments}:
+ *
+ * 1. **Identity via the {@link DocumentUriPolicy} seam.**
+ *    `getOrCreateDocument` resolves the requested URI through the seam — the
+ *    same identity the text store and the AST-document event filters use — so
+ *    an adopter that strengthens document identity (e.g. resolving symlinks to
+ *    a real path) does so by binding the policy *once*, with no
+ *    `LangiumDocuments` override. The default resolves to the URI unchanged
+ *    (`DefaultDocumentUriPolicy`), matching Langium's own keying.
+ *
+ * 2. **`createEmptyDocument(uri)` — synchronous** factory for a transient
+ *    document with no loadable on-disk content. `getOrCreateDocument` falls
+ *    back to it when the seam reports no loadable URI, or when `super` cannot
+ *    load it, so callers always receive a document. Abstract because the
+ *    parse-result root is grammar-specific (each grammar returns its own
+ *    root node type). The fallback document is deliberately
+ *    **not** registered: a transient placeholder must not mask the real
+ *    document once it appears.
+ */
+export class AbstractHydraniumLangiumDocuments extends DefaultLangiumDocuments {
+    services;
+    /** Document-identity seam, shared with the text store, event filters, and builder. */
+    uriPolicy;
+    tracer;
+    constructor(services) {
+        super(services);
+        this.services = services;
+        this.uriPolicy = services.workspace.DocumentUriPolicy;
+        this.tracer = services.Tracer.for('LangiumDocuments');
+    }
+    async getOrCreateDocument(uri) {
+        const resolved = this.uriPolicy.loadUri(uri);
+        if (resolved) {
+            const existing = this.getDocument(resolved);
+            if (existing) {
+                // A registered document may have had its CST shed by a residency
+                // policy. CST→AST readers that fetch it here — e.g. the call/type
+                // hierarchy's `findDeclarationNodeAtOffset(root.$cstNode, …).astNode`
+                // offset-scan — run no build, so restore the CST on demand. No-op
+                // (and so behaviour-neutral) when the CST is resident.
+                this.services.workspace.CstResidencyService.rehydrate(existing);
+                return existing;
+            }
+            try {
+                // Real on-disk content → Langium loads it and registers it.
+                return await super.getOrCreateDocument(resolved);
+            }
+            catch (error) {
+                // Load lost a race with a concurrent create — return that document.
+                const reentrant = this.getDocument(resolved);
+                if (reentrant) {
+                    this.services.workspace.CstResidencyService.rehydrate(reentrant);
+                    return reentrant;
+                }
+                // No concurrent document, so the load genuinely failed. The fallback
+                // below still runs, because the file-not-found case is the ordinary
+                // one here and no provider-independent way to recognise it exists:
+                // Node's provider throws `ENOENT`, the in-memory one a bare `Error`,
+                // and the provider is a seam an adopter rebinds. Discriminating on
+                // message text across that seam would be a worse defect than the
+                // one it fixes. So the failure is TRACED rather than propagated —
+                // an unreadable-but-present file still degrades to an empty
+                // document, but it stops doing so silently.
+                this.tracer
+                    .with(resolved.toString())
+                    .debug(`Load failed, falling back to an empty document: ${error instanceof Error ? error.message : String(error)}`);
+            }
+        }
+        // No loadable content (missing / synthetic / not yet written): a transient
+        // empty placeholder keyed canonically — not registered (see the class doc).
+        return this.createEmptyDocument(resolved ?? uri);
+    }
+}
+//# sourceMappingURL=langium-documents.js.map

package/lib/langium/workspace/langium-documents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"langium-documents.js","sourceRoot":"","sources":["../../../src/langium/workspace/langium-documents.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAGlF,OAAO,EAAgB,uBAAuB,EAAkC,MAAM,oBAAoB,CAAC;AAI3G;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,OAAgB,iCAAkC,SAAQ,uBAAuB;IAK5C;IAJxC,sFAAsF;IACnE,SAAS,CAAoB;IAC7B,MAAM,CAAS;IAElC,YAAwC,QAAqC;QAC1E,KAAK,CAAC,QAAQ,CAAC,CAAC;QADqB,aAAQ,GAAR,QAAQ,CAA6B;QAE1E,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC,SAAS,CAAC,iBAAiB,CAAC;QACtD,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;IACzD,CAAC;IAQQ,KAAK,CAAC,mBAAmB,CAAC,GAAQ;QACxC,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC7C,IAAI,QAAQ,EAAE,CAAC;YACZ,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;YAC5C,IAAI,QAAQ,EAAE,CAAC;gBACZ,iEAAiE;gBACjE,kEAAkE;gBAClE,sEAAsE;gBACtE,kEAAkE;gBAClE,uDAAuD;gBACvD,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,mBAAmB,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;gBAChE,OAAO,QAAQ,CAAC;YACnB,CAAC;YACD,IAAI,CAAC;gBACF,4DAA4D;gBAC5D,OAAO,MAAM,KAAK,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC;YACpD,CAAC;YAAC,OAAO,KAAc,EAAE,CAAC;gBACvB,oEAAoE;gBACpE,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;gBAC7C,IAAI,SAAS,EAAE,CAAC;oBACb,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,mBAAmB,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;oBACjE,OAAO,SAAS,CAAC;gBACpB,CAAC;gBACD,qEAAqE;gBACrE,oEAAoE;gBACpE,mEAAmE;gBACnE,qEAAqE;gBACrE,mEAAmE;gBACnE,iEAAiE;gBACjE,kEAAkE;gBAClE,4DAA4D;gBAC5D,4CAA4C;gBAC5C,IAAI,CAAC,MAAM;qBACP,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;qBACzB,KAAK,CAAC,mDAAmD,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAC1H,CAAC;QACJ,CAAC;QACD,2EAA2E;QAC3E,4EAA4E;QAC5E,OAAO,IAAI,CAAC,mBAAmB,CAAC,QAAQ,IAAI,GAAG,CAAC,CAAC;IACpD,CAAC;CACH"}