Skip to content

Lima 0.2.0 — References 2.0

Choose a tag to compare

@mkorun mkorun released this 11 Aug 19:23
· 60 commits to main since this release

Lima References 2.0 is final and is now the public References implementation in @limaformat/lima.

Install

npm install @limaformat/lima@0.2.0

Highlights

  • New document-reference syntax: $(path)
  • New partial-reference syntax: $(:partial.path)
  • Partial namespaces with / and mapping traversal with .
  • Bounded transitive resolution with at most three reference edges
  • parse() is the primary References 2.0 API
  • parseReferences() remains as a deprecated exact alias with identical 2.0 behavior and diagnostics
  • parse(input, { mode: "core" }) selects the same reference-unaware path as parseCore()
  • The complete TypeScript implementation passes all 117 References 2.0 conformance cases

Breaking changes

References 1.0 tokens such as ($key) and (%key) are literal text in the public 2.0 API; they are not deprecated syntax aliases. Existing documents must migrate to $(key) and $(:key).

See the References 1.0 → 2.0 migration guide and the final References 2.0 specification.

Rust and Go currently continue to implement Lima References 1.0. Lima Core 1.0 is unchanged across all bindings.

For the complete change list, see the 0.2.0 changelog.