@hydranium/langium 1.0.0-next.23 → 1.0.0-next.230

package/README.md

@@ -11,20 +11,22 @@ 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.
+workspace. Re-export is transparent — given one physical install, importing `AstUtils` or
+`OperationCancelled` from `@hydranium/langium` and from `langium` yields the same object and the
+same declaration. That transparency is exactly what a split install destroys: two copies of Langium
+mean two sets of declarations, which TypeScript refuses to mix, and two sets of module-level values,
+so one that Langium compares by identity, such as its cancellation signal, is not recognised by the
+other copy. The framework refuses to start a server whose AST reflection is built on a copy other
+than its own. 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
+it is **version coupling**. Langium sits in a chain with `vscode-languageserver`,
+`vscode-languageserver-protocol` and `vscode-jsonrpc`, whose links move together. 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
+The chokepoint is **lint-enforced**, not merely conventional: an oxlint
 `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 —
@@ -61,8 +63,8 @@ No peer dependencies: `langium` is a direct, exact dependency of this package.
 | `./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.
+Resolve the subpaths with [a resolver that reads `exports`](../../docs/adopting/requirements.md#a-resolver-that-reads-exports);
+`"Node"` (node10) reaches none of them.
 
 ## Usage
 
@@ -77,9 +79,10 @@ 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.
+Alpha — pre-v0, published as a `1.0.0-next` prerelease on every merge to `main`. 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
 

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.23",
+  "version": "1.0.0-next.230",
   "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';