@limaformat/lima 0.2.0 → 0.3.1

package/CHANGELOG.md

@@ -12,6 +12,24 @@ are both frozen regardless of what this file shows.
 
 ## [Unreleased]
 
+## [0.3.1] — 2026-08-12
+
+### Fixed
+
+- References 2.0 document references now resolve correctly when the source
+  and target share a top-level mapping, including sibling fields and separate
+  nested branches. Genuine self-references and dependency cycles remain
+  unresolved.
+
+## [0.3.0] — 2026-08-12
+
+### Changed
+
+- **Breaking:** References 2.0 document references now use `${key}`, while
+  partial references use `$(key)`. The briefly published `$(key)` document
+  syntax is therefore reinterpreted as a partial reference; `$(:key)` is
+  literal text.
+
 ## [0.2.0] — 2026-08-11
 
 ### Changed

package/README.md

@@ -39,7 +39,7 @@ Three functions are exported:
 
 - `parseCore(input, options?)` — the base format only.
 - `parse(input, options?)` — the primary References 2.0 parser; adds
-  `$(key)` document references and `$(:key)` external partials.
+  `${key}` document references and `$(key)` external partials.
 - `parseReferences(input, options?)` — deprecated compatibility alias for
   `parse` with the same References 2.0 semantics.
 

package/dist/reference-tokens2.js

@@ -2,11 +2,11 @@ const SEGMENT = '[a-zA-Z0-9_][a-zA-Z0-9_:-]*';
 const DOC_PATH = `${SEGMENT}(?:\\.${SEGMENT})*`;
 const PARTIAL_NAME = '[a-zA-Z0-9_][a-zA-Z0-9_:/-]*';
 const PARTIAL_PATH = `${PARTIAL_NAME}(?:\\.${SEGMENT})*`;
-export const PURE_REFERENCE_2 = new RegExp(`^\\$\\((?:(${DOC_PATH})|:(${PARTIAL_PATH}))\\)$`);
-const REFERENCE_2 = new RegExp(`\\$\\((?:(${DOC_PATH})|:(${PARTIAL_PATH}))\\)`, 'g');
+export const PURE_REFERENCE_2 = new RegExp(`^(?:\\$\\{(${DOC_PATH})\\}|\\$\\((${PARTIAL_PATH})\\))$`);
+const REFERENCE_2 = new RegExp(`\\$\\{(${DOC_PATH})\\}|\\$\\((${PARTIAL_PATH})\\)`, 'g');
 const NO_TOKENS = [];
 export const scanReferenceTokens2 = (value, firstLine, sourceSpans) => {
-    if (!value.includes('$('))
+    if (!value.includes('${') && !value.includes('$('))
         return NO_TOKENS;
     REFERENCE_2.lastIndex = 0;
     const result = [];

package/dist/references2.js

@@ -23,8 +23,18 @@ const lookupPath = (root, segments) => {
 };
 const documentTarget = (root, path) => {
     const segments = path.split('.');
-    const value = root.get(segments[0]);
-    return value === undefined ? undefined : { root: value, tail: segments.slice(1) };
+    let value = root.get(segments[0]);
+    if (value === undefined)
+        return undefined;
+    let index = 1;
+    while (index < segments.length && value.kind === 'mapping') {
+        const child = value.entries.get(segments[index]);
+        if (child === undefined)
+            return undefined;
+        value = child;
+        index++;
+    }
+    return { root: value, tail: segments.slice(index) };
 };
 const lookupPartial = (partials, path) => {
     const dot = path.indexOf('.');
@@ -246,7 +256,7 @@ export const parse = (frontMatter, options) => {
         return parseCore(frontMatter, options);
     }
     const partials = validatePartials(options?.partials ?? {});
-    if (!frontMatter.includes('$(')) {
+    if (!frontMatter.includes('${') && !frontMatter.includes('$(')) {
         return parseCore(frontMatter, options);
     }
     const document = parseCoreWithPositions(frontMatter, { strict: options?.strict ?? false, onWarning: options?.onWarning });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@limaformat/lima",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "description": "Lima frontmatter parser — LIMA Is Metadata Annotation",
   "keywords": ["frontmatter", "parser", "yaml", "markdown", "metadata"],
   "homepage": "https://limaformat.dev",
@@ -20,25 +20,27 @@
     }
   },
   "files": ["dist", "README.md", "LICENSE", "CHANGELOG.md"],
-  "engines": { "node": ">=18" },
-  "scripts": {
-    "build": "tsc -p tsconfig.build.json",
-    "pretest": "bun run build",
-    "test": "bun test",
-    "typecheck": "tsc --noEmit",
-    "prepublishOnly": "bun run typecheck && bun test",
-    "bench": "bun run bench/index.ts",
-    "bench:vs-yaml": "bun run bench/vs-yaml.ts",
-    "bench:vs-yaml:node": "node bench/vs-yaml-node.mjs",
-    "bench:cross-language": "bun run bench/cross-language.ts",
-    "bench:differential": "bun run bench/differential.ts",
-    "wordcount": "bun run scripts/wordcount.ts"
-  },
-  "devDependencies": {
-    "@types/bun": "^1.3.14",
-    "@types/js-yaml": "^4.0.9",
-    "js-yaml": "^5.2.3",
-    "typescript": "^7.0.2",
-    "typescript-classic": "npm:typescript@^5.9.3"
-  }
+  "engines": {
+  "node": ">=18"
+},
+"scripts": {
+  "build": "tsc -p tsconfig.build.json",
+  "pretest": "bun run build",
+  "test": "bun test",
+  "typecheck": "tsc --noEmit",
+  "prepublishOnly": "bun run typecheck && bun test",
+  "bench": "bun run bench/index.ts",
+  "bench:vs-yaml": "bun run bench/vs-yaml.ts",
+  "bench:vs-yaml:node": "node bench/vs-yaml-node.mjs",
+  "bench:cross-language": "bun run bench/cross-language.ts",
+  "bench:differential": "bun run bench/differential.ts",
+  "wordcount": "bun run scripts/wordcount.ts"
+},
+"devDependencies": {
+  "@types/bun": "^1.3.14",
+  "@types/js-yaml": "^4.0.9",
+  "js-yaml": "^5.2.3",
+  "typescript": "^7.0.2",
+  "typescript-classic": "npm:typescript@^5.9.3"
+}
 }