@hydranium/langium 1.0.0-next.224 → 1.0.0-next.226

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +13 -10
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -11,12 +11,14 @@ project stays in lockstep with the version the framework was built against.
11
11
  ## Why this package exists
12
12
 
13
13
  Langium is pinned to **one exact version** here, to guarantee a **single physical copy** across the
14
- workspace. Re-export is transparent — given one physical install, importing `AstNode` or `URI` from
15
- `@hydranium/langium` and from `langium` yields the same class object and the same declaration. That
16
- transparency is exactly what a split install destroys: two copies of Langium mean two `AstNode`
17
- declarations and two `URI` classes, so `instanceof` and every nominal identity check across them
18
- silently start returning `false`. Without the pin, single-copy is only a semver-dedup coincidence,
19
- one minor bump away from breaking.
14
+ workspace. Re-export is transparent — given one physical install, importing `AstUtils` or
15
+ `OperationCancelled` from `@hydranium/langium` and from `langium` yields the same object and the
16
+ same declaration. That transparency is exactly what a split install destroys: two copies of Langium
17
+ mean two sets of declarations, which TypeScript refuses to mix, and two sets of module-level values,
18
+ so one that Langium compares by identity, such as its cancellation signal, is not recognised by the
19
+ other copy. The framework refuses to start a server whose AST reflection is built on a copy other
20
+ than its own. Without the pin, single-copy is only a semver-dedup coincidence, one minor bump away
21
+ from breaking.
20
22
 
21
23
  For an **adopter**, the reason to route imports here is not runtime identity (that already holds) —
22
24
  it is **version coupling**. Langium sits in a chain with `vscode-languageserver`,
@@ -24,7 +26,7 @@ it is **version coupling**. Langium sits in a chain with `vscode-languageserver`
24
26
  adopter importing `langium` directly owns that pin itself and can drift out of lockstep with the
25
27
  framework it composes; importing it from here means the framework owns it.
26
28
 
27
- The chokepoint is **lint-enforced**, not merely conventional: an ESLint
29
+ The chokepoint is **lint-enforced**, not merely conventional: an oxlint
28
30
  `no-restricted-imports` rule over `packages/**` and `examples/**` rejects direct imports of
29
31
  `langium`, `langium/lsp`, `langium/node`, `langium/test` and `vscode-uri` (whose `URI` Langium
30
32
  re-exports and owns the version of). This package itself is exempt, as is any `generated` directory —
@@ -77,9 +79,10 @@ only the stock surface.
77
79
 
78
80
  ## Status
79
81
 
80
- Alpha — pre-v0, published nightly as `1.0.0-next` prereleases. The API is Langium's and is stable
81
- to the extent Langium's is; what is not yet settled is the augmentation set and the pinned version.
82
- See the [repository README](../../README.md) for the current status and known limitations.
82
+ Alpha — pre-v0, published as a `1.0.0-next` prerelease on every merge to `main`. The API is
83
+ Langium's and is stable to the extent Langium's is; what is not yet settled is the augmentation set
84
+ and the pinned version. See the [repository README](../../README.md) for the current status and
85
+ known limitations.
83
86
 
84
87
  ## License
85
88
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@hydranium/langium",
3
- "version": "1.0.0-next.224",
3
+ "version": "1.0.0-next.226",
4
4
  "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.",
5
5
  "keywords": [
6
6
  "hydranium",