@hydranium/langium 1.0.0-next.10

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 CrossBreeze, EclipseSource and others.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,87 @@
+# `@hydranium/langium`
+
+The pinned [Langium](https://langium.org/) re-export for the
+[Hydranium](https://github.com/eclipse-emfcloud/hydranium) framework — the single chokepoint every
+`@hydranium/*` package, and every adopter of them, imports Langium through.
+
+You do not install this for its own API: it is almost entirely passthrough. You install it because a
+framework package will resolve it anyway, and because importing Langium through it is how your
+project stays in lockstep with the version the framework was built against.
+
+## Why this package exists
+
+Langium is pinned to **one exact version** here, to guarantee a **single physical copy** across the
+workspace. Re-export is transparent — given one physical install, importing `AstNode` or `URI` from
+`@hydranium/langium` and from `langium` yields the same class object and the same declaration. That
+transparency is exactly what a split install destroys: two copies of Langium mean two `AstNode`
+declarations and two `URI` classes, so `instanceof` and every nominal identity check across them
+silently start returning `false`. Without the pin, single-copy is only a semver-dedup coincidence,
+one minor bump away from breaking.
+
+For an **adopter**, the reason to route imports here is not runtime identity (that already holds) —
+it is **version coupling**. Langium sits in an atomic chain with `vscode-languageserver`,
+`vscode-languageserver-protocol` and `vscode-jsonrpc`, with no independently movable link. An
+adopter importing `langium` directly owns that pin itself and can drift out of lockstep with the
+framework it composes; importing it from here means the framework owns it.
+
+The chokepoint is **lint-enforced**, not merely conventional: an ESLint
+`no-restricted-imports` rule over `packages/**` and `examples/**` rejects direct imports of
+`langium`, `langium/lsp`, `langium/node`, `langium/test` and `vscode-uri` (whose `URI` Langium
+re-exports and owns the version of). This package itself is exempt, as is any `generated` directory —
+`langium-cli` emits direct imports there and rewrites them on every build, which is also why
+`langium` stays a declared dependency of an adopter's own package.
+
+## What it gives you
+
+- Langium's full API surface, re-exported: `AstNode`, `AstUtils`, `URI`, `UriUtils`, the service
+  types, the DI helpers — everything, unfiltered.
+- A subpath per upstream subpath, so `langium/lsp`, `langium/node` and `langium/test` each have a
+  chokepoint mirror.
+- One ambient type augmentation: `AstNode.$synthetic`, a marker for a node that was programmatically
+  constructed rather than parsed. Type-level only — the behaviour that reads it lives in
+  `@hydranium/core`.
+- Two additions to the `UriUtils` namespace, so framework URI helpers sit beside Langium's own:
+  `UriUtils.toUri` (normalise a `URI | string`) and `UriUtils.isAncestorOrEqual` (a scheme- and
+  authority-aware containment check, unlike `UriUtils.contains`).
+
+## Install
+
+```bash
+npm install @hydranium/langium
+```
+
+No peer dependencies: `langium` is a direct, exact dependency of this package.
+
+## Subpaths
+
+| Subpath  | Re-exports     | Contents                                  |
+| -------- | -------------- | ----------------------------------------- |
+| `.`      | `langium`      | Core API + the framework's augmentations. |
+| `./lsp`  | `langium/lsp`  | LSP service defaults.                     |
+| `./node` | `langium/node` | `NodeFileSystem`.                         |
+| `./test` | `langium/test` | Parsing / validation test helpers.        |
+
+Each named subpath also resolves as `@hydranium/langium/lib/<name>`, so a consumer on classic
+`moduleResolution: "Node"` can reach it.
+
+## Usage
+
+Replace `langium` with `@hydranium/langium` in your import specifiers; nothing else changes, because
+the symbols are the same objects.
+
+The one thing to know is that the root entry is **side-effecting**: importing anything from
+`@hydranium/langium` loads the `UriUtils` augmentation, which mutates the runtime `UriUtils` object.
+That is why the added helpers are visible process-wide once any framework package has loaded — and
+why code that imports `UriUtils` from `langium` without ever loading the framework correctly sees
+only the stock surface.
+
+## Status
+
+Alpha — pre-v0, not yet published. The API is Langium's and is stable to the extent Langium's is;
+what is not yet settled is the augmentation set and the pinned version. See the
+[repository README](../../README.md) for the current status and known limitations.
+
+## License
+
+`MIT` — see this package's [`LICENSE`](./LICENSE), and the repository
+[`NOTICE.md`](../../NOTICE.md) for third-party notices.

package/lib/augmentations/synthetic.d.ts

@@ -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
+ ********************************************************************************/
+/**
+ * Augments Langium's {@link AstNode} with a `$synthetic` marker —
+ * `true` when the node was programmatically constructed rather than
+ * parsed from source.
+ *
+ * This is a pure, ambient type-level merge: it widens the canonical
+ * `langium` `AstNode` interface so the marker is visible on every
+ * AST-derived type (generated subtypes, `$container` hops, `AstUtils`
+ * return types) regardless of import path. It carries no runtime code.
+ * The behaviour-bearing side of the synthetic concept — `markSynthetic`
+ * / `markSyntheticTree` / `isSyntheticNode` and the validation-skip
+ * default that reads them — lives in `@hydranium/core`; this package
+ * owns only the type widening.
+ *
+ * Adopters may further narrow this on grammar-specific AST types to give
+ * synthetic mirrors a literal-type compile-time hint at construction
+ * sites.
+ */
+declare module 'langium' {
+    interface AstNode {
+        /**
+         * Marks the node as synthetic — programmatically constructed, not
+         * parsed from source. Synthetic nodes are skipped during validation
+         * by default, via `HydraniumDocumentValidator.shouldSkipValidation`.
+         */
+        readonly $synthetic?: boolean;
+    }
+}
+export {};
+//# sourceMappingURL=synthetic.d.ts.map

package/lib/augmentations/synthetic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"synthetic.d.ts","sourceRoot":"","sources":["../../src/augmentations/synthetic.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,QAAQ,SAAS,CAAC;IACtB,UAAU,OAAO;QACd;;;;WAIG;QACH,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;KAChC;CACH"}

package/lib/augmentations/synthetic.js

@@ -0,0 +1,10 @@
+/********************************************************************************
+ * Copyright (c) 2026 CrossBreeze, EclipseSource and others.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the MIT License which is available in the project root.
+ *
+ * SPDX-License-Identifier: MIT
+ ********************************************************************************/
+export {};
+//# sourceMappingURL=synthetic.js.map

package/lib/augmentations/synthetic.js.map

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

package/lib/augmentations/uri-utils.d.ts

@@ -0,0 +1,51 @@
+/********************************************************************************
+ * 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 'langium';
+/**
+ * Namespace augmentation: extend Langium's `UriUtils` with framework
+ * helpers, so the framework's URI utilities sit on the same namespace as
+ * Langium's own rather than on a second surface adopters have to discover
+ * separately.
+ *
+ * **Side-effect import.** This module mutates the runtime `UriUtils`
+ * object. It is loaded by this package's entry point (`index.ts`), so
+ * importing anything from `@hydranium/langium` — which every framework
+ * package does — makes the augmented members visible process-wide. Code
+ * that imports `UriUtils` from `langium` without ever loading the
+ * framework sees only the stock surface, which is correct.
+ *
+ * **Rejected: plain exported `toUri` / `isAncestorOrEqual` functions.**
+ * They would avoid the side-effect import, which can break under
+ * tree-shaking or CJS interop, at the cost of the single-namespace
+ * discovery above. Neither hazard reaches a framework consumer: Langium is
+ * a non-optional dependency, so the chokepoint is always loaded in a real
+ * composition, and type-only imports are erased.
+ */
+declare module 'langium' {
+    namespace UriUtils {
+        /**
+         * Normalise a `URI | string` argument to a `URI`, so a public API
+         * accepting both forms does not have to inline the coercion.
+         */
+        function toUri(value: URI | string): URI;
+        /**
+         * `true` when `ancestor` is the same file or a parent folder of
+         * `descendant`. Both URIs must share scheme and authority for the
+         * comparison to be meaningful — different schemes always return `false`.
+         *
+         * **vs. `UriUtils.contains`**: `contains(parent, child)` does the
+         * same path-prefix check but **ignores scheme and authority** — a
+         * `file:` URI can "contain" an `untitled:` URI. Use this stricter
+         * variant when scheme correctness matters, and `contains` where
+         * scheme equality is already implied by context.
+         */
+        function isAncestorOrEqual(ancestor: URI, descendant: URI): boolean;
+    }
+}
+//# sourceMappingURL=uri-utils.d.ts.map

package/lib/augmentations/uri-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uri-utils.d.ts","sourceRoot":"","sources":["../../src/augmentations/uri-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EAAE,GAAG,EAAY,MAAM,SAAS,CAAC;AAExC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,QAAQ,SAAS,CAAC;IACtB,UAAU,QAAQ,CAAC;QAChB;;;WAGG;QACH,SAAS,KAAK,CAAC,KAAK,EAAE,GAAG,GAAG,MAAM,GAAG,GAAG,CAAC;QAEzC;;;;;;;;;;WAUG;QACH,SAAS,iBAAiB,CAAC,QAAQ,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,GAAG,OAAO,CAAC;KACtE;CACH"}

package/lib/augmentations/uri-utils.js

@@ -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 { URI, UriUtils } from 'langium';
+function toUri(value) {
+    return typeof value === 'string' ? URI.parse(value) : value;
+}
+function isAncestorOrEqual(ancestor, descendant) {
+    if (ancestor.scheme !== descendant.scheme || ancestor.authority !== descendant.authority) {
+        return false;
+    }
+    const ancestorPath = ancestor.fsPath;
+    const descendantPath = descendant.fsPath;
+    if (descendantPath === ancestorPath) {
+        return true;
+    }
+    const trailing = ancestorPath.endsWith('/') || ancestorPath.endsWith('\\');
+    const prefix = trailing ? ancestorPath : ancestorPath + '/';
+    return descendantPath.startsWith(prefix) || descendantPath.startsWith(ancestorPath + '\\');
+}
+// Runtime attachment. `UriUtils` is a namespace, so at runtime it is a plain
+// object that accepts added properties; the cast only strips its declared
+// shape, and the augmentation block above supplies the type-level merge.
+UriUtils.toUri = toUri;
+UriUtils.isAncestorOrEqual = isAncestorOrEqual;
+//# sourceMappingURL=uri-utils.js.map

package/lib/augmentations/uri-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uri-utils.js","sourceRoot":"","sources":["../../src/augmentations/uri-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AA6CxC,SAAS,KAAK,CAAC,KAAmB;IAC/B,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;AAC/D,CAAC;AAED,SAAS,iBAAiB,CAAC,QAAa,EAAE,UAAe;IACtD,IAAI,QAAQ,CAAC,MAAM,KAAK,UAAU,CAAC,MAAM,IAAI,QAAQ,CAAC,SAAS,KAAK,UAAU,CAAC,SAAS,EAAE,CAAC;QACxF,OAAO,KAAK,CAAC;IAChB,CAAC;IACD,MAAM,YAAY,GAAG,QAAQ,CAAC,MAAM,CAAC;IACrC,MAAM,cAAc,GAAG,UAAU,CAAC,MAAM,CAAC;IACzC,IAAI,cAAc,KAAK,YAAY,EAAE,CAAC;QACnC,OAAO,IAAI,CAAC;IACf,CAAC;IACD,MAAM,QAAQ,GAAG,YAAY,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC3E,MAAM,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,YAAY,GAAG,GAAG,CAAC;IAC5D,OAAO,cAAc,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,cAAc,CAAC,UAAU,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;AAC9F,CAAC;AAED,6EAA6E;AAC7E,0EAA0E;AAC1E,yEAAyE;AACxE,QAAiF,CAAC,KAAK,GAAG,KAAK,CAAC;AAChG,QAAiF,CAAC,iBAAiB,GAAG,iBAAiB,CAAC"}

package/lib/index.d.ts

@@ -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
+ ********************************************************************************/
+/**
+ * `@hydranium/langium` — augmented re-export of the Langium API.
+ *
+ * This is the single chokepoint where the hydranium framework consumes
+ * Langium: it pins the Langium version (one physical copy, guaranteed by
+ * the root `overrides`/`resolutions`) and layers the framework's
+ * type/namespace augmentations. Framework packages AND adopters import
+ * Langium from here, not from `langium` directly — lint-enforced across
+ * the `packages` and `examples` trees alike, with any `generated`
+ * directory exempt because `langium-cli` emits direct imports there and
+ * regenerates them on every build.
+ *
+ * **Why adopters too, and it is not runtime identity.** Re-export is
+ * transparent: given one physical `langium`, importing a symbol from here
+ * and from `langium` yields the same object and the same declaration. The
+ * reason is VERSION COUPLING: `langium` sits in an atomic chain with
+ * `vscode-languageserver` / `-protocol` / `-jsonrpc` (see the `//langium`
+ * note in the root `package.json`), so an adopter importing it directly
+ * owns that pin itself and can drift out of lockstep with the framework it
+ * composes. Here, the framework owns it. This is also the place a Langium
+ * rename would be defensively patched, which a direct importer does not
+ * benefit from.
+ *
+ * The only curation is the ambient `$synthetic` `AstNode` widening and the
+ * `UriUtils` helper namespace; everything else is passthrough.
+ */
+import './augmentations/synthetic.js';
+import './augmentations/uri-utils.js';
+export * from 'langium';
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAGH,OAAO,8BAA8B,CAAC;AAEtC,OAAO,8BAA8B,CAAC;AAEtC,cAAc,SAAS,CAAC"}

package/lib/index.js

@@ -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
+ ********************************************************************************/
+/**
+ * `@hydranium/langium` — augmented re-export of the Langium API.
+ *
+ * This is the single chokepoint where the hydranium framework consumes
+ * Langium: it pins the Langium version (one physical copy, guaranteed by
+ * the root `overrides`/`resolutions`) and layers the framework's
+ * type/namespace augmentations. Framework packages AND adopters import
+ * Langium from here, not from `langium` directly — lint-enforced across
+ * the `packages` and `examples` trees alike, with any `generated`
+ * directory exempt because `langium-cli` emits direct imports there and
+ * regenerates them on every build.
+ *
+ * **Why adopters too, and it is not runtime identity.** Re-export is
+ * transparent: given one physical `langium`, importing a symbol from here
+ * and from `langium` yields the same object and the same declaration. The
+ * reason is VERSION COUPLING: `langium` sits in an atomic chain with
+ * `vscode-languageserver` / `-protocol` / `-jsonrpc` (see the `//langium`
+ * note in the root `package.json`), so an adopter importing it directly
+ * owns that pin itself and can drift out of lockstep with the framework it
+ * composes. Here, the framework owns it. This is also the place a Langium
+ * rename would be defensively patched, which a direct importer does not
+ * benefit from.
+ *
+ * The only curation is the ambient `$synthetic` `AstNode` widening and the
+ * `UriUtils` helper namespace; everything else is passthrough.
+ */
+// Ambient type-level augmentation of `AstNode` ($synthetic marker).
+import './augmentations/synthetic.js';
+// Side-effecting runtime augmentation of the `UriUtils` namespace.
+import './augmentations/uri-utils.js';
+export * from 'langium';
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,oEAAoE;AACpE,OAAO,8BAA8B,CAAC;AACtC,mEAAmE;AACnE,OAAO,8BAA8B,CAAC;AAEtC,cAAc,SAAS,CAAC"}

package/lib/lsp.d.ts

@@ -0,0 +1,16 @@
+/********************************************************************************
+ * 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
+ ********************************************************************************/
+/**
+ * Chokepoint mirror of Langium's `langium/lsp` subpath — the LSP service
+ * defaults (`DefaultCompletionProvider`, etc.). Pure passthrough; it exists
+ * so framework packages and adopters reach every Langium subpath through
+ * this package and inherit its version pin instead of owning one themselves.
+ */
+export * from 'langium/lsp';
+//# sourceMappingURL=lsp.d.ts.map

package/lib/lsp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lsp.d.ts","sourceRoot":"","sources":["../src/lsp.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF;;;;;GAKG;AACH,cAAc,aAAa,CAAC"}

package/lib/lsp.js

@@ -0,0 +1,16 @@
+/********************************************************************************
+ * 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
+ ********************************************************************************/
+/**
+ * Chokepoint mirror of Langium's `langium/lsp` subpath — the LSP service
+ * defaults (`DefaultCompletionProvider`, etc.). Pure passthrough; it exists
+ * so framework packages and adopters reach every Langium subpath through
+ * this package and inherit its version pin instead of owning one themselves.
+ */
+export * from 'langium/lsp';
+//# sourceMappingURL=lsp.js.map

package/lib/lsp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lsp.js","sourceRoot":"","sources":["../src/lsp.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF;;;;;GAKG;AACH,cAAc,aAAa,CAAC"}

package/lib/node.d.ts

@@ -0,0 +1,16 @@
+/********************************************************************************
+ * 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
+ ********************************************************************************/
+/**
+ * Chokepoint mirror of Langium's `langium/node` subpath — the Node.js
+ * filesystem provider (`NodeFileSystem`). Pure passthrough; it exists so
+ * framework packages and adopters reach every Langium subpath through this
+ * package and inherit its version pin instead of owning one themselves.
+ */
+export * from 'langium/node';
+//# sourceMappingURL=node.d.ts.map

package/lib/node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF;;;;;GAKG;AACH,cAAc,cAAc,CAAC"}

package/lib/node.js

@@ -0,0 +1,16 @@
+/********************************************************************************
+ * 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
+ ********************************************************************************/
+/**
+ * Chokepoint mirror of Langium's `langium/node` subpath — the Node.js
+ * filesystem provider (`NodeFileSystem`). Pure passthrough; it exists so
+ * framework packages and adopters reach every Langium subpath through this
+ * package and inherit its version pin instead of owning one themselves.
+ */
+export * from 'langium/node';
+//# sourceMappingURL=node.js.map

package/lib/node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.js","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF;;;;;GAKG;AACH,cAAc,cAAc,CAAC"}

package/lib/test.d.ts

@@ -0,0 +1,16 @@
+/********************************************************************************
+ * 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
+ ********************************************************************************/
+/**
+ * Chokepoint mirror of Langium's `langium/test` subpath — parsing and
+ * validation test helpers. Pure passthrough; it exists so framework packages
+ * and adopters reach every Langium subpath through this package and inherit
+ * its version pin instead of owning one themselves.
+ */
+export * from 'langium/test';
+//# sourceMappingURL=test.d.ts.map

package/lib/test.d.ts.map

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

package/lib/test.js

@@ -0,0 +1,16 @@
+/********************************************************************************
+ * 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
+ ********************************************************************************/
+/**
+ * Chokepoint mirror of Langium's `langium/test` subpath — parsing and
+ * validation test helpers. Pure passthrough; it exists so framework packages
+ * and adopters reach every Langium subpath through this package and inherit
+ * its version pin instead of owning one themselves.
+ */
+export * from 'langium/test';
+//# sourceMappingURL=test.js.map

package/lib/test.js.map

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

package/package.json

@@ -0,0 +1,90 @@
+{
+  "name": "@hydranium/langium",
+  "version": "1.0.0-next.10",
+  "description": "Augmented re-export of the Langium API for the hydranium framework: the single chokepoint where hydranium pins the Langium version and layers its type/namespace augmentations. ~99% passthrough today.",
+  "keywords": [
+    "hydranium",
+    "langium",
+    "language-server",
+    "lsp"
+  ],
+  "homepage": "https://github.com/eclipse-emfcloud/hydranium/tree/main/packages/langium",
+  "bugs": {
+    "url": "https://github.com/eclipse-emfcloud/hydranium/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/eclipse-emfcloud/hydranium.git",
+    "directory": "packages/langium"
+  },
+  "license": "MIT",
+  "author": {
+    "name": "Hydranium Team"
+  },
+  "sideEffects": [
+    "./lib/index.js",
+    "./lib/augmentations/*.js"
+  ],
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./lsp": {
+      "types": "./lib/lsp.d.ts",
+      "default": "./lib/lsp.js"
+    },
+    "./lib/lsp": {
+      "types": "./lib/lsp.d.ts",
+      "default": "./lib/lsp.js"
+    },
+    "./node": {
+      "types": "./lib/node.d.ts",
+      "default": "./lib/node.js"
+    },
+    "./lib/node": {
+      "types": "./lib/node.d.ts",
+      "default": "./lib/node.js"
+    },
+    "./test": {
+      "types": "./lib/test.d.ts",
+      "default": "./lib/test.js"
+    },
+    "./lib/test": {
+      "types": "./lib/test.d.ts",
+      "default": "./lib/test.js"
+    }
+  },
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "files": [
+    "lib",
+    "src",
+    "!lib/**/*.tsbuildinfo"
+  ],
+  "scripts": {
+    "build": "tsc -b",
+    "clean": "rimraf lib tsconfig.tsbuildinfo",
+    "lint": "eslint src --max-warnings 0",
+    "prepack": "node -e \"const m=require('./package.json'),fs=require('node:fs');const missing=[m.main,...Object.values(m.bin||{})].filter(entry=>entry&&!fs.existsSync(entry));if(missing.length){console.error('prepack '+m.name+': not built ('+missing.join(', ')+' missing). Run the build before packing: a files entry that matches nothing is skipped silently, so the tarball would ship src only.');process.exit(1);}\"",
+    "test": "npm run typecheck:test && vitest run",
+    "typecheck:test": "tsc --noEmit -p tsconfig.test.json",
+    "watch": "tsc -b -w --preserveWatchOutput"
+  },
+  "dependencies": {
+    "langium": "4.3.1"
+  },
+  "devDependencies": {
+    "rimraf": "^5.0.0",
+    "typescript": "^5.8.0"
+  },
+  "engines": {
+    "node": ">=22.13"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "//prepack": "The publish guard, and it deliberately is NOT a `prepare`: npm runs a workspace `prepare` BEFORE the root `postinstall` that applies patches/vscode-jsonrpc+9.0.1.patch, so building there fails on a cold clone and npm rolls the entire install back. `prepack` runs only when a tarball is made (`npm pack`, `npm publish`) and never on install, so it cannot break the install it has no business touching. It FAILS rather than rebuilds, because the rebuild is exactly the part that ordering defeats. What it defends against: `files` lists `lib`, `lib` is gitignored, and a `files` entry matching nothing is skipped SILENTLY — so `npm publish` from an unbuilt tree emits a tarball of `src` and nothing else, with no error.",
+  "//sideEffects": "NOT `false`, and the two entries are load-bearing. `augmentations/uri-utils.js` mutates the runtime `UriUtils` object it imports from `langium`, and `index.js` is the only module that loads it — everything else there is `export * from 'langium'`. Declared side-effect-free, a bundler rewrites an import of any symbol from this package straight through to `langium` and skips `index.js` entirely, so `UriUtils.toUri` / `.isAncestorOrEqual` are simply absent at runtime. Nothing fails at build time: the augmentation is a type-level `declare module` merge, so the call still typechecks. `./lsp` and `./node` are pure passthroughs of the upstream subpaths and deliberately not listed."
+}

package/src/augmentations/synthetic.ts

@@ -0,0 +1,37 @@
+/********************************************************************************
+ * Copyright (c) 2026 CrossBreeze, EclipseSource and others.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the MIT License which is available in the project root.
+ *
+ * SPDX-License-Identifier: MIT
+ ********************************************************************************/
+
+/**
+ * Augments Langium's {@link AstNode} with a `$synthetic` marker —
+ * `true` when the node was programmatically constructed rather than
+ * parsed from source.
+ *
+ * This is a pure, ambient type-level merge: it widens the canonical
+ * `langium` `AstNode` interface so the marker is visible on every
+ * AST-derived type (generated subtypes, `$container` hops, `AstUtils`
+ * return types) regardless of import path. It carries no runtime code.
+ * The behaviour-bearing side of the synthetic concept — `markSynthetic`
+ * / `markSyntheticTree` / `isSyntheticNode` and the validation-skip
+ * default that reads them — lives in `@hydranium/core`; this package
+ * owns only the type widening.
+ *
+ * Adopters may further narrow this on grammar-specific AST types to give
+ * synthetic mirrors a literal-type compile-time hint at construction
+ * sites.
+ */
+declare module 'langium' {
+   interface AstNode {
+      /**
+       * Marks the node as synthetic — programmatically constructed, not
+       * parsed from source. Synthetic nodes are skipped during validation
+       * by default, via `HydraniumDocumentValidator.shouldSkipValidation`.
+       */
+      readonly $synthetic?: boolean;
+   }
+}

package/src/augmentations/uri-utils.ts

@@ -0,0 +1,77 @@
+/********************************************************************************
+ * 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, UriUtils } from 'langium';
+
+/**
+ * Namespace augmentation: extend Langium's `UriUtils` with framework
+ * helpers, so the framework's URI utilities sit on the same namespace as
+ * Langium's own rather than on a second surface adopters have to discover
+ * separately.
+ *
+ * **Side-effect import.** This module mutates the runtime `UriUtils`
+ * object. It is loaded by this package's entry point (`index.ts`), so
+ * importing anything from `@hydranium/langium` — which every framework
+ * package does — makes the augmented members visible process-wide. Code
+ * that imports `UriUtils` from `langium` without ever loading the
+ * framework sees only the stock surface, which is correct.
+ *
+ * **Rejected: plain exported `toUri` / `isAncestorOrEqual` functions.**
+ * They would avoid the side-effect import, which can break under
+ * tree-shaking or CJS interop, at the cost of the single-namespace
+ * discovery above. Neither hazard reaches a framework consumer: Langium is
+ * a non-optional dependency, so the chokepoint is always loaded in a real
+ * composition, and type-only imports are erased.
+ */
+declare module 'langium' {
+   namespace UriUtils {
+      /**
+       * Normalise a `URI | string` argument to a `URI`, so a public API
+       * accepting both forms does not have to inline the coercion.
+       */
+      function toUri(value: URI | string): URI;
+
+      /**
+       * `true` when `ancestor` is the same file or a parent folder of
+       * `descendant`. Both URIs must share scheme and authority for the
+       * comparison to be meaningful — different schemes always return `false`.
+       *
+       * **vs. `UriUtils.contains`**: `contains(parent, child)` does the
+       * same path-prefix check but **ignores scheme and authority** — a
+       * `file:` URI can "contain" an `untitled:` URI. Use this stricter
+       * variant when scheme correctness matters, and `contains` where
+       * scheme equality is already implied by context.
+       */
+      function isAncestorOrEqual(ancestor: URI, descendant: URI): boolean;
+   }
+}
+
+function toUri(value: URI | string): URI {
+   return typeof value === 'string' ? URI.parse(value) : value;
+}
+
+function isAncestorOrEqual(ancestor: URI, descendant: URI): boolean {
+   if (ancestor.scheme !== descendant.scheme || ancestor.authority !== descendant.authority) {
+      return false;
+   }
+   const ancestorPath = ancestor.fsPath;
+   const descendantPath = descendant.fsPath;
+   if (descendantPath === ancestorPath) {
+      return true;
+   }
+   const trailing = ancestorPath.endsWith('/') || ancestorPath.endsWith('\\');
+   const prefix = trailing ? ancestorPath : ancestorPath + '/';
+   return descendantPath.startsWith(prefix) || descendantPath.startsWith(ancestorPath + '\\');
+}
+
+// Runtime attachment. `UriUtils` is a namespace, so at runtime it is a plain
+// object that accepts added properties; the cast only strips its declared
+// shape, and the augmentation block above supplies the type-level merge.
+(UriUtils as { toUri: typeof toUri; isAncestorOrEqual: typeof isAncestorOrEqual }).toUri = toUri;
+(UriUtils as { toUri: typeof toUri; isAncestorOrEqual: typeof isAncestorOrEqual }).isAncestorOrEqual = isAncestorOrEqual;

package/src/index.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
+ ********************************************************************************/
+
+/**
+ * `@hydranium/langium` — augmented re-export of the Langium API.
+ *
+ * This is the single chokepoint where the hydranium framework consumes
+ * Langium: it pins the Langium version (one physical copy, guaranteed by
+ * the root `overrides`/`resolutions`) and layers the framework's
+ * type/namespace augmentations. Framework packages AND adopters import
+ * Langium from here, not from `langium` directly — lint-enforced across
+ * the `packages` and `examples` trees alike, with any `generated`
+ * directory exempt because `langium-cli` emits direct imports there and
+ * regenerates them on every build.
+ *
+ * **Why adopters too, and it is not runtime identity.** Re-export is
+ * transparent: given one physical `langium`, importing a symbol from here
+ * and from `langium` yields the same object and the same declaration. The
+ * reason is VERSION COUPLING: `langium` sits in an atomic chain with
+ * `vscode-languageserver` / `-protocol` / `-jsonrpc` (see the `//langium`
+ * note in the root `package.json`), so an adopter importing it directly
+ * owns that pin itself and can drift out of lockstep with the framework it
+ * composes. Here, the framework owns it. This is also the place a Langium
+ * rename would be defensively patched, which a direct importer does not
+ * benefit from.
+ *
+ * The only curation is the ambient `$synthetic` `AstNode` widening and the
+ * `UriUtils` helper namespace; everything else is passthrough.
+ */
+
+// Ambient type-level augmentation of `AstNode` ($synthetic marker).
+import './augmentations/synthetic.js';
+// Side-effecting runtime augmentation of the `UriUtils` namespace.
+import './augmentations/uri-utils.js';
+
+export * from 'langium';

package/src/lsp.ts

@@ -0,0 +1,16 @@
+/********************************************************************************
+ * 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
+ ********************************************************************************/
+
+/**
+ * Chokepoint mirror of Langium's `langium/lsp` subpath — the LSP service
+ * defaults (`DefaultCompletionProvider`, etc.). Pure passthrough; it exists
+ * so framework packages and adopters reach every Langium subpath through
+ * this package and inherit its version pin instead of owning one themselves.
+ */
+export * from 'langium/lsp';

package/src/node.ts

@@ -0,0 +1,16 @@
+/********************************************************************************
+ * 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
+ ********************************************************************************/
+
+/**
+ * Chokepoint mirror of Langium's `langium/node` subpath — the Node.js
+ * filesystem provider (`NodeFileSystem`). Pure passthrough; it exists so
+ * framework packages and adopters reach every Langium subpath through this
+ * package and inherit its version pin instead of owning one themselves.
+ */
+export * from 'langium/node';

package/src/test.ts

@@ -0,0 +1,16 @@
+/********************************************************************************
+ * 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
+ ********************************************************************************/
+
+/**
+ * Chokepoint mirror of Langium's `langium/test` subpath — parsing and
+ * validation test helpers. Pure passthrough; it exists so framework packages
+ * and adopters reach every Langium subpath through this package and inherit
+ * its version pin instead of owning one themselves.
+ */
+export * from 'langium/test';