@hydranium/langium 1.0.0-next.31 → 1.0.0-next.313

package/README.md

@@ -1,48 +1,20 @@
 # `@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.
+[Langium](https://langium.org/), re-exported for the
+[Hydranium](https://github.com/eclipse-emfcloud/hydranium) framework. Import
+Langium through this package so your install has one copy of it and the
+framework owns the Langium version chain. `@hydranium/core` takes it as a peer,
+so you install it alongside.
 
 ## 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`).
+- Langium's full API, unfiltered. Replace `langium` with `@hydranium/langium` in
+  your imports; nothing else changes, because the symbols are the same objects.
+- A mirror of each Langium subpath, so `langium/lsp`, `langium/node` and
+  `langium/test` go through the same pin.
+- Langium and its `vscode-languageserver`, `vscode-languageserver-protocol` and
+  `vscode-jsonrpc` chain move together, at the versions the framework was built
+  against, instead of a pin you maintain yourself.
 
 ## Install
 
@@ -52,36 +24,31 @@ 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.
+Still declare `langium` in your own package, at the version this package pins:
+the code `langium-cli` generates imports `langium` directly. If your install
+resolves a second copy, the framework refuses to start your language server.
 
-## Usage
+## Entry points
 
-Replace `langium` with `@hydranium/langium` in your import specifiers; nothing else changes, because
-the symbols are the same objects.
+| Subpath  | Use it for                    | Runs in         |
+| -------- | ----------------------------- | --------------- |
+| `.`      | instead of `langium`          | browser-neutral |
+| `./lsp`  | instead of `langium/lsp`      | browser-neutral |
+| `./node` | instead of `langium/node`     | Node-only       |
+| `./test` | instead of `langium/test`     | Node-only       |
 
-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.
+The subpaths need a TypeScript `moduleResolution` that reads `exports`
+(`NodeNext` or `Bundler`); see *Requirements* in
+[Adopting Hydranium](https://github.com/eclipse-emfcloud/hydranium/blob/main/docs/ADOPTING.md).
 
 ## 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.
+Alpha: every release is a prerelease that may break the API, so pin an exact
+version. Guides and known limitations:
+[Adopting Hydranium](https://github.com/eclipse-emfcloud/hydranium/blob/main/docs/ADOPTING.md).
 
 ## License
 
 `MIT` — see this package's [`LICENSE`](./LICENSE), and the repository
-[`NOTICE.md`](../../NOTICE.md) for third-party notices.
+[`NOTICE.md`](https://github.com/eclipse-emfcloud/hydranium/blob/main/NOTICE.md)
+for third-party notices.

package/lib/index.d.ts.map

@@ -1 +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"}
+{"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;AAGtC,cAAc,SAAS,CAAC"}

package/lib/index.js

@@ -36,5 +36,6 @@
 import './augmentations/synthetic.js';
 // Side-effecting runtime augmentation of the `UriUtils` namespace.
 import './augmentations/uri-utils.js';
+// oxlint-disable-next-line import/export -- misreads export * from an npm package: https://github.com/oxc-project/oxc/pull/26872
 export * from 'langium';
 //# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -1 +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"}
+{"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,iIAAiI;AACjI,cAAc,SAAS,CAAC"}

package/lib/lsp.d.ts.map

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

package/lib/lsp.js

@@ -12,5 +12,6 @@
  * so framework packages and adopters reach every Langium subpath through
  * this package and inherit its version pin instead of owning one themselves.
  */
+// oxlint-disable-next-line import/export -- misreads export * from an npm package: https://github.com/oxc-project/oxc/pull/26872
 export * from 'langium/lsp';
 //# sourceMappingURL=lsp.js.map

package/lib/lsp.js.map

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

package/lib/node.d.ts.map

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

package/lib/node.js

@@ -12,5 +12,6 @@
  * framework packages and adopters reach every Langium subpath through this
  * package and inherit its version pin instead of owning one themselves.
  */
+// oxlint-disable-next-line import/export -- misreads export * from an npm package: https://github.com/oxc-project/oxc/pull/26872
 export * from 'langium/node';
 //# sourceMappingURL=node.js.map

package/lib/node.js.map

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

package/lib/test.d.ts.map

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

package/lib/test.js

@@ -12,5 +12,6 @@
  * and adopters reach every Langium subpath through this package and inherit
  * its version pin instead of owning one themselves.
  */
+// oxlint-disable-next-line import/export -- misreads export * from an npm package: https://github.com/oxc-project/oxc/pull/26872
 export * from 'langium/test';
 //# sourceMappingURL=test.js.map

package/lib/test.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hydranium/langium",
-  "version": "1.0.0-next.31",
+  "version": "1.0.0-next.313",
   "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",
@@ -12,20 +12,27 @@
   "bugs": {
     "url": "https://github.com/eclipse-emfcloud/hydranium/issues"
   },
+  "license": "MIT",
+  "author": {
+    "name": "Hydranium Team"
+  },
   "repository": {
     "type": "git",
     "url": "https://github.com/eclipse-emfcloud/hydranium.git",
     "directory": "packages/langium"
   },
-  "license": "MIT",
-  "author": {
-    "name": "Hydranium Team"
-  },
+  "files": [
+    "lib",
+    "src",
+    "!lib/**/*.tsbuildinfo"
+  ],
+  "type": "module",
   "sideEffects": [
     "./lib/index.js",
     "./lib/augmentations/*.js"
   ],
-  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
   "exports": {
     ".": {
       "types": "./lib/index.d.ts",
@@ -35,38 +42,22 @@
       "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"
-  ],
+  "publishConfig": {
+    "access": "public"
+  },
   "scripts": {
     "build": "tsc -b",
     "clean": "rimraf lib tsconfig.tsbuildinfo",
-    "lint": "eslint src --max-warnings 0",
+    "lint": "oxlint --format stylish --config ../../oxlint.config.cjs 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",
@@ -77,14 +68,11 @@
   },
   "devDependencies": {
     "rimraf": "^5.0.0",
-    "typescript": "^5.8.0"
+    "typescript": "^7.0.2"
   },
   "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.",
+  "//prepack": "The publish guard, a `prepack` rather than a `prepare`: `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. 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/index.ts

@@ -39,4 +39,5 @@ import './augmentations/synthetic.js';
 // Side-effecting runtime augmentation of the `UriUtils` namespace.
 import './augmentations/uri-utils.js';
 
+// oxlint-disable-next-line import/export -- misreads export * from an npm package: https://github.com/oxc-project/oxc/pull/26872
 export * from 'langium';

package/src/lsp.ts

@@ -13,4 +13,5 @@
  * so framework packages and adopters reach every Langium subpath through
  * this package and inherit its version pin instead of owning one themselves.
  */
+// oxlint-disable-next-line import/export -- misreads export * from an npm package: https://github.com/oxc-project/oxc/pull/26872
 export * from 'langium/lsp';

package/src/node.ts

@@ -13,4 +13,5 @@
  * framework packages and adopters reach every Langium subpath through this
  * package and inherit its version pin instead of owning one themselves.
  */
+// oxlint-disable-next-line import/export -- misreads export * from an npm package: https://github.com/oxc-project/oxc/pull/26872
 export * from 'langium/node';

package/src/test.ts

@@ -13,4 +13,5 @@
  * and adopters reach every Langium subpath through this package and inherit
  * its version pin instead of owning one themselves.
  */
+// oxlint-disable-next-line import/export -- misreads export * from an npm package: https://github.com/oxc-project/oxc/pull/26872
 export * from 'langium/test';