@refrakt-md/runes 0.14.3 → 0.15.0

package/dist/xref-patterns.js

@@ -0,0 +1,140 @@
+/**
+ * Cross-reference pattern compilation.
+ *
+ * Compiles user-authored `XrefPattern` config entries from `refrakt.config.json`
+ * into validated, ready-to-use `CompiledXrefPattern` objects. The runtime
+ * resolver (in `xref-resolve.ts`) consumes the compiled forms to turn
+ * unresolved xref IDs into URLs.
+ *
+ * Validation rules (per SPEC-065):
+ * - `match` must compile as a JavaScript regex; anchored to whole-string match
+ *   by default (`^` and `$` auto-applied unless explicit anchors are present
+ *   at the start/end of the pattern).
+ * - `template` placeholders must each be `id` or a named group of the regex.
+ * - `type` defaults to `"external"`. The value `"unresolved"` is reserved.
+ * - `label` defaults to `"{id}"` and uses the same placeholder syntax as
+ *   `template`.
+ * - Duplicate `match` strings across entries are flagged as a warning (not an
+ *   error; first-wins ordering still produces deterministic behaviour).
+ */
+/** Reserved `type` values that cannot be used in pattern entries. */
+const RESERVED_TYPES = new Set(['unresolved']);
+/** Match `(?<name>` declarations in a regex source. Used to enumerate named
+ *  groups statically (JS `RegExp` instances don't expose group names without
+ *  a successful match). */
+const NAMED_GROUP_RE = /\(\?<([a-zA-Z_$][a-zA-Z0-9_$]*)>/g;
+/** Match `{name}` placeholders in template / label strings. */
+const PLACEHOLDER_RE = /\{([a-zA-Z_$][a-zA-Z0-9_$]*)\}/g;
+/** Apply whole-string anchoring to the pattern source. If the author already
+ *  added `^` and `$` (at the very start and end), the source is used as-is.
+ *  Otherwise the source is wrapped in `^(?:...)$`. Stripping any partial
+ *  anchors first avoids double-anchoring like `^^...$$`. */
+function anchorPatternSource(source) {
+    if (source.startsWith('^') && source.endsWith('$'))
+        return source;
+    let inner = source;
+    if (inner.startsWith('^'))
+        inner = inner.slice(1);
+    if (inner.endsWith('$'))
+        inner = inner.slice(0, -1);
+    return `^(?:${inner})$`;
+}
+/** Extract named-group names from a regex source, in declaration order. */
+function extractGroupNames(source) {
+    const names = [];
+    NAMED_GROUP_RE.lastIndex = 0;
+    let match;
+    while ((match = NAMED_GROUP_RE.exec(source)) !== null) {
+        names.push(match[1]);
+    }
+    return names;
+}
+/** Find placeholder names used in a template/label string, deduplicated. */
+function extractPlaceholders(template) {
+    const seen = new Set();
+    PLACEHOLDER_RE.lastIndex = 0;
+    let match;
+    while ((match = PLACEHOLDER_RE.exec(template)) !== null) {
+        seen.add(match[1]);
+    }
+    return [...seen];
+}
+/**
+ * Compile a list of authored xref patterns into runtime-ready form.
+ *
+ * Returns the compiled patterns alongside errors and warnings — callers
+ * (typically the content-loader bootstrap) decide whether errors should
+ * throw, log, or be passed back to the user.
+ */
+export function compileXrefPatterns(patterns) {
+    const result = {
+        patterns: [],
+        errors: [],
+        warnings: [],
+    };
+    if (!patterns || patterns.length === 0)
+        return result;
+    const seenMatches = new Set();
+    patterns.forEach((entry, idx) => {
+        const ref = `xrefs[${idx}]`;
+        // Validate required fields up front.
+        if (typeof entry?.match !== 'string' || entry.match.length === 0) {
+            result.errors.push(`${ref}: \`match\` is required and must be a non-empty string`);
+            return;
+        }
+        if (typeof entry.template !== 'string' || entry.template.length === 0) {
+            result.errors.push(`${ref}: \`template\` is required and must be a non-empty string`);
+            return;
+        }
+        // Reserved type rejection.
+        const type = entry.type ?? 'external';
+        if (RESERVED_TYPES.has(type)) {
+            result.errors.push(`${ref}: \`type\` value "${type}" is reserved`);
+            return;
+        }
+        // Duplicate match warning (doesn't fail; first-wins ordering is stable).
+        if (seenMatches.has(entry.match)) {
+            result.warnings.push(`${ref}: duplicate \`match\` "${entry.match}" — earlier entry wins`);
+        }
+        else {
+            seenMatches.add(entry.match);
+        }
+        // Compile the regex with whole-string anchoring.
+        const sourceAnchored = anchorPatternSource(entry.match);
+        let regex;
+        try {
+            regex = new RegExp(sourceAnchored);
+        }
+        catch (e) {
+            result.errors.push(`${ref}: invalid regex (${e.message})`);
+            return;
+        }
+        // Enumerate named groups so the resolver can validate matches.
+        const groupNames = extractGroupNames(entry.match);
+        // Validate template + label placeholders against the available names
+        // (`id` is implicit; everything else must be a captured group).
+        const allowed = new Set(['id', ...groupNames]);
+        const label = entry.label ?? '{id}';
+        const templatePlaceholders = extractPlaceholders(entry.template);
+        const labelPlaceholders = extractPlaceholders(label);
+        const unknown = [];
+        for (const name of [...templatePlaceholders, ...labelPlaceholders]) {
+            if (!allowed.has(name))
+                unknown.push(name);
+        }
+        if (unknown.length > 0) {
+            const dedup = [...new Set(unknown)];
+            result.errors.push(`${ref}: unknown placeholder${dedup.length === 1 ? '' : 's'} ${dedup.map(n => `{${n}}`).join(', ')} (must be \`{id}\` or a named group of the regex)`);
+            return;
+        }
+        result.patterns.push({
+            match: regex,
+            template: entry.template,
+            type,
+            label,
+            groupNames,
+        });
+    });
+    return result;
+}
+//# sourceMappingURL=xref-patterns.js.map

package/dist/xref-patterns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"xref-patterns.js","sourceRoot":"","sources":["../src/xref-patterns.ts"],"names":[],"mappings":"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"}

package/dist/xref-resolve.d.ts

@@ -2,14 +2,31 @@
  * Xref (cross-reference) resolution utilities.
  *
  * Walks a Markdoc renderable tree and converts xref placeholder spans
- * (produced by the xref/ref tag transform) into resolved `<a>` links
- * using the entity registry.
+ * (produced by the xref/ref tag transform) into resolved `<a>` links.
+ *
+ * Resolution model (SPEC-065):
+ *
+ * 1. **Entity lookup** — find the entity in the registry (exact ID, then
+ *    case-insensitive name/title). Captures metadata (label, type) for use
+ *    in rendering even if the URL ends up coming from a pattern.
+ * 2. **URL resolution** — if the matched entity has a usable `sourceUrl`,
+ *    that's the href (`data-xref-source="registry"`). Otherwise iterate
+ *    configured patterns (compiled via `compileXrefPatterns`); first regex
+ *    that matches the ID provides the URL (`data-xref-source="pattern"`).
+ * 3. **Unresolved fallback** — if neither the entity nor any pattern produces
+ *    a URL, render `rf-xref--unresolved` with a build warning.
+ *
+ * The separation lets entity-lookup and URL-resolution succeed independently.
+ * SPEC-064 plan content registered without a `sourceUrl` (because it isn't
+ * published to any site) still resolves correctly: the registry provides
+ * label and type; user-configured patterns provide the URL.
  */
 import type { EntityRegistry, PipelineContext } from '@refrakt-md/types';
+import type { CompiledXrefPattern } from './xref-patterns.js';
 /**
  * Walk a Markdoc renderable tree, resolving any xref placeholders into
- * clickable links using the entity registry. Unresolved xrefs become
- * styled spans with an `rf-xref--unresolved` class.
+ * clickable links using the entity registry and configured patterns.
+ * Unresolved xrefs become styled spans with an `rf-xref--unresolved` class.
  */
-export declare function resolveXrefs(renderable: unknown, pageUrl: string, registry: Readonly<EntityRegistry>, ctx: PipelineContext): unknown;
+export declare function resolveXrefs(renderable: unknown, pageUrl: string, registry: Readonly<EntityRegistry>, patterns: CompiledXrefPattern[], ctx: PipelineContext): unknown;
 //# sourceMappingURL=xref-resolve.d.ts.map

package/dist/xref-resolve.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"xref-resolve.d.ts","sourceRoot":"","sources":["../src/xref-resolve.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAsB,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAsD7F;;;;GAIG;AACH,wBAAgB,YAAY,CAC3B,UAAU,EAAE,OAAO,EACnB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,QAAQ,CAAC,cAAc,CAAC,EAClC,GAAG,EAAE,eAAe,GAClB,OAAO,CAqGT"}
+{"version":3,"file":"xref-resolve.d.ts","sourceRoot":"","sources":["../src/xref-resolve.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAsB,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAE7F,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AA+Q9D;;;;GAIG;AACH,wBAAgB,YAAY,CAC3B,UAAU,EAAE,OAAO,EACnB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,QAAQ,CAAC,cAAc,CAAC,EAClC,QAAQ,EAAE,mBAAmB,EAAE,EAC/B,GAAG,EAAE,eAAe,GAClB,OAAO,CAGT"}

package/dist/xref-resolve.js

@@ -2,29 +2,41 @@
  * Xref (cross-reference) resolution utilities.
  *
  * Walks a Markdoc renderable tree and converts xref placeholder spans
- * (produced by the xref/ref tag transform) into resolved `<a>` links
- * using the entity registry.
+ * (produced by the xref/ref tag transform) into resolved `<a>` links.
+ *
+ * Resolution model (SPEC-065):
+ *
+ * 1. **Entity lookup** — find the entity in the registry (exact ID, then
+ *    case-insensitive name/title). Captures metadata (label, type) for use
+ *    in rendering even if the URL ends up coming from a pattern.
+ * 2. **URL resolution** — if the matched entity has a usable `sourceUrl`,
+ *    that's the href (`data-xref-source="registry"`). Otherwise iterate
+ *    configured patterns (compiled via `compileXrefPatterns`); first regex
+ *    that matches the ID provides the URL (`data-xref-source="pattern"`).
+ * 3. **Unresolved fallback** — if neither the entity nor any pattern produces
+ *    a URL, render `rf-xref--unresolved` with a build warning.
+ *
+ * The separation lets entity-lookup and URL-resolution succeed independently.
+ * SPEC-064 plan content registered without a `sourceUrl` (because it isn't
+ * published to any site) still resolves correctly: the registry provides
+ * label and type; user-configured patterns provide the URL.
  */
 import Markdoc from '@markdoc/markdoc';
 const { Tag } = Markdoc;
 import { XREF_RUNE_MARKER } from './tags/xref.js';
-/**
- * Find an entity by exact ID across all types in the registry.
- * If typeHint is provided, only search that type.
- */
-function findEntityById(registry, id, typeHint) {
+/** Find an entity by exact ID across all types in the registry. `pageUrl`
+ *  scopes the search so page-scoped entries from the resolving page take
+ *  precedence over site-scoped entries of the same id (SPEC-060). */
+function findEntityById(registry, id, pageUrl, typeHint) {
     const types = typeHint ? [typeHint] : registry.getTypes();
     for (const type of types) {
-        const entity = registry.getById(type, id);
+        const entity = registry.getById(type, id, pageUrl);
         if (entity)
-            return { entity, ambiguous: false };
+            return entity;
     }
     return undefined;
 }
-/**
- * Find entities by name/title match (case-insensitive) across all types.
- * If typeHint is provided, only search that type.
- */
+/** Find entities by case-insensitive name/title match. */
 function findEntitiesByName(registry, name, typeHint) {
     const nameLower = name.toLowerCase();
     const types = typeHint ? [typeHint] : registry.getTypes();
@@ -40,31 +52,197 @@ function findEntitiesByName(registry, name, typeHint) {
     }
     return matches;
 }
-/** Resolve an entity's URL for use as an href */
+/** Compute the canonical URL for a registry-matched entity, honoring
+ *  per-entity `data.url` overrides and `data.headingId` fragment hints. */
 function resolveEntityHref(entity) {
     const baseUrl = entity.data.url || entity.sourceUrl;
+    if (!baseUrl)
+        return undefined;
     const headingId = entity.data.headingId;
-    if (headingId)
-        return `${baseUrl}#${headingId}`;
-    return baseUrl;
+    return headingId ? `${baseUrl}#${headingId}` : baseUrl;
+}
+/** Choose the rendered label for a resolved xref. Priority: explicit `label=`
+ *  attribute > entity `data.title` / `data.name` / `data.text` > the raw ID. */
+function deriveEntityLabel(id, authoredLabel, entity) {
+    if (authoredLabel)
+        return authoredLabel;
+    if (entity) {
+        const title = entity.data.title;
+        const name = entity.data.name;
+        const text = entity.data.text;
+        return title || name || text || id;
+    }
+    return id;
+}
+/** Match `{name}` placeholders in template / label strings. */
+const PLACEHOLDER_RE = /\{([a-zA-Z_$][a-zA-Z0-9_$]*)\}/g;
+/** URL-encode per segment: split on `/`, encode each segment with
+ *  `encodeURIComponent`, rejoin with `/`. Single-segment values are
+ *  unaffected (the split is a no-op); multi-segment paths preserve their
+ *  slash structure. This is what the SPEC-065 "per-segment encoding"
+ *  contract delivers. */
+function encodePerSegment(value) {
+    return value.split('/').map(encodeURIComponent).join('/');
+}
+/** Substitute `{id}` and `{name}` placeholders in a template, with each
+ *  substituted value encoded per URL segment. */
+function applyTemplate(template, id, groups) {
+    return template.replace(PLACEHOLDER_RE, (_match, name) => {
+        const value = name === 'id' ? id : (groups[name] ?? '');
+        return encodePerSegment(value);
+    });
+}
+/** Apply a label template without URL encoding — labels are human-readable
+ *  text, not URL components. Missing named groups render as empty strings. */
+function applyLabelTemplate(template, id, groups) {
+    return template.replace(PLACEHOLDER_RE, (_match, name) => {
+        if (name === 'id')
+            return id;
+        return groups[name] ?? '';
+    });
+}
+/** Try each pattern in order; first match wins. Returns the resolved URL
+ *  along with the pattern's `type` and computed `label`. */
+function tryPatternMatch(id, patterns) {
+    for (const p of patterns) {
+        const m = p.match.exec(id);
+        if (!m)
+            continue;
+        const groups = (m.groups ?? {});
+        return {
+            url: applyTemplate(p.template, id, groups),
+            label: applyLabelTemplate(p.label, id, groups),
+            type: p.type,
+        };
+    }
+    return undefined;
+}
+/** Reduce an absolute href that points at the current page + fragment down
+ *  to the fragment alone. Handles both URL shapes seen in practice — page
+ *  URLs that end with a trailing slash and ones that don't. Returns the
+ *  original href when it doesn't target the current page. */
+function compactSamePageHref(href, pageUrl) {
+    const hashIdx = href.indexOf('#');
+    if (hashIdx < 0)
+        return href;
+    const hrefPath = href.slice(0, hashIdx);
+    const fragment = href.slice(hashIdx);
+    // Normalise trailing slashes for the comparison so `/x/` and `/x` are
+    // treated as the same page (different adapters normalise differently).
+    const stripTrail = (s) => s.endsWith('/') ? s.slice(0, -1) : s;
+    if (stripTrail(hrefPath) === stripTrail(pageUrl))
+        return fragment;
+    return href;
+}
+/** Resolve a single xref placeholder. Drives the SPEC-065 chain:
+ *  entity lookup → URL resolution → unresolved fallback. */
+function resolvePlaceholder(id, authoredLabel, typeHint, rc) {
+    // Step 1: entity lookup (capture metadata, may or may not yield a URL).
+    let entity = findEntityById(rc.registry, id, rc.pageUrl, typeHint);
+    if (!entity) {
+        const nameMatches = findEntitiesByName(rc.registry, id, typeHint);
+        if (nameMatches.length === 1) {
+            entity = nameMatches[0];
+        }
+        else if (nameMatches.length > 1) {
+            const matchList = nameMatches
+                .map(e => `${e.type} "${e.data.title || e.data.name || e.id}" on ${e.sourceUrl ?? '(no URL)'}`)
+                .join(', ');
+            rc.ctx.warn(`xref "${id}" on ${rc.pageUrl} — matches ${nameMatches.length} entities (${matchList}). Add type hint to disambiguate.`, rc.pageUrl);
+            entity = nameMatches[0];
+        }
+    }
+    const entityHref = entity ? resolveEntityHref(entity) : undefined;
+    // Step 2a: URL from the entity, if any.
+    let resolved;
+    if (entity && entityHref) {
+        resolved = {
+            href: entityHref,
+            label: deriveEntityLabel(id, authoredLabel, entity),
+            type: entity.type,
+            source: 'registry',
+            targetType: entity.type,
+            entityId: entity.id,
+        };
+    }
+    else {
+        // Step 2b: URL from a pattern. Entity metadata still wins for label/type
+        // when present; the pattern only contributes the URL in that case.
+        const patternHit = tryPatternMatch(id, rc.patterns);
+        if (patternHit) {
+            resolved = {
+                href: patternHit.url,
+                label: deriveEntityLabel(id, authoredLabel, entity) || patternHit.label,
+                type: entity?.type ?? patternHit.type,
+                source: 'pattern',
+                targetType: entity?.type,
+                entityId: entity?.id,
+            };
+            // When no entity is matched, the label has to come from the
+            // pattern (or the authored label); `deriveEntityLabel` falls back
+            // to the raw ID which is rarely what the author wanted from a
+            // pattern. Use the pattern label in that case.
+            if (!entity && !authoredLabel) {
+                resolved.label = patternHit.label;
+            }
+        }
+    }
+    // Step 3: unresolved.
+    if (!resolved) {
+        rc.ctx.warn(`xref "${id}" on ${rc.pageUrl} — entity not found`, rc.pageUrl);
+        return {
+            tag: new Tag('span', {
+                class: 'rf-xref rf-xref--unresolved',
+                'data-xref-id': id,
+            }, [authoredLabel || id]),
+        };
+    }
+    // Self-reference detection on the resolved href (covers both registry and
+    // pattern cases — a pattern that produces a same-page URL is still a
+    // self-reference).
+    if (resolved.href === rc.pageUrl) {
+        rc.ctx.info(`xref "${id}" on ${rc.pageUrl} — references itself`, rc.pageUrl);
+    }
+    // Same-page anchor compaction: when the entity's resolved href is the
+    // current page plus a fragment, drop the page URL portion so the link
+    // renders as a fragment-only anchor (`#drawer-x`) — matches the SPEC-060
+    // drawer-trigger contract and is how authors normally write same-page
+    // anchors. Behaves identically to the absolute form for the browser; the
+    // progressive-enhancement layer (drawer behaviors) reads the fragment
+    // directly without needing to compare against location.pathname.
+    const renderedHref = compactSamePageHref(resolved.href, rc.pageUrl);
+    const attributes = {
+        class: `rf-xref rf-xref--${resolved.type}`,
+        href: renderedHref,
+        'data-xref-id': resolved.entityId ?? id,
+        'data-xref-source': resolved.source,
+    };
+    if (resolved.targetType) {
+        attributes['data-target-type'] = resolved.targetType;
+    }
+    return { tag: new Tag('a', attributes, [resolved.label]) };
 }
 /**
  * Walk a Markdoc renderable tree, resolving any xref placeholders into
- * clickable links using the entity registry. Unresolved xrefs become
- * styled spans with an `rf-xref--unresolved` class.
+ * clickable links using the entity registry and configured patterns.
+ * Unresolved xrefs become styled spans with an `rf-xref--unresolved` class.
  */
-export function resolveXrefs(renderable, pageUrl, registry, ctx) {
+export function resolveXrefs(renderable, pageUrl, registry, patterns, ctx) {
+    const rc = { pageUrl, registry, patterns, ctx };
+    return walk(renderable, rc);
+}
+function walk(renderable, rc) {
     if (!Tag.isTag(renderable)) {
         if (Array.isArray(renderable)) {
-            const newChildren = renderable.map(c => resolveXrefs(c, pageUrl, registry, ctx));
-            if (newChildren.every((c, i) => c === renderable[i]))
+            const arr = renderable;
+            const newChildren = arr.map(c => walk(c, rc));
+            if (newChildren.every((c, i) => c === arr[i]))
                 return renderable;
             return newChildren;
         }
         return renderable;
     }
     const tag = renderable;
-    // Check if this is an xref placeholder
     if (tag.attributes?.['data-rune'] === XREF_RUNE_MARKER) {
         const id = tag.attributes['data-xref-id'];
         const label = tag.attributes['data-xref-label'];
@@ -74,63 +252,9 @@ export function resolveXrefs(renderable, pageUrl, registry, ctx) {
                 class: 'rf-xref rf-xref--unresolved',
             }, [label || '?']);
         }
-        // Try exact ID match first
-        const idMatch = findEntityById(registry, id, typeHint);
-        if (idMatch) {
-            const entity = idMatch.entity;
-            const href = resolveEntityHref(entity);
-            const text = label || entity.data.title || entity.data.name || entity.data.text || id;
-            if (entity.sourceUrl === pageUrl) {
-                ctx.info(`xref "${id}" on ${pageUrl} — references itself`, pageUrl);
-            }
-            return new Tag('a', {
-                class: `rf-xref rf-xref--${entity.type}`,
-                href,
-                'data-entity-type': entity.type,
-                'data-entity-id': entity.id,
-            }, [text]);
-        }
-        // Try name/title match
-        const nameMatches = findEntitiesByName(registry, id, typeHint);
-        if (nameMatches.length === 1) {
-            const entity = nameMatches[0];
-            const href = resolveEntityHref(entity);
-            const text = label || entity.data.title || entity.data.name || entity.data.text || id;
-            if (entity.sourceUrl === pageUrl) {
-                ctx.info(`xref "${id}" on ${pageUrl} — references itself`, pageUrl);
-            }
-            return new Tag('a', {
-                class: `rf-xref rf-xref--${entity.type}`,
-                href,
-                'data-entity-type': entity.type,
-                'data-entity-id': entity.id,
-            }, [text]);
-        }
-        if (nameMatches.length > 1) {
-            const matchList = nameMatches
-                .map(e => `${e.type} "${e.data.title || e.data.name || e.id}" on ${e.sourceUrl}`)
-                .join(', ');
-            ctx.warn(`xref "${id}" on ${pageUrl} — matches ${nameMatches.length} entities (${matchList}). Add type hint to disambiguate.`, pageUrl);
-            // Use first match
-            const entity = nameMatches[0];
-            const href = resolveEntityHref(entity);
-            const text = label || entity.data.title || entity.data.name || entity.data.text || id;
-            return new Tag('a', {
-                class: `rf-xref rf-xref--${entity.type}`,
-                href,
-                'data-entity-type': entity.type,
-                'data-entity-id': entity.id,
-            }, [text]);
-        }
-        // No match — unresolved
-        ctx.warn(`xref "${id}" on ${pageUrl} — entity not found`, pageUrl);
-        return new Tag('span', {
-            class: 'rf-xref rf-xref--unresolved',
-            'data-entity-id': id,
-        }, [label || id]);
+        return resolvePlaceholder(id, label, typeHint, rc).tag;
     }
-    // Recurse into children
-    const newChildren = (tag.children ?? []).map((c) => resolveXrefs(c, pageUrl, registry, ctx));
+    const newChildren = (tag.children ?? []).map((c) => walk(c, rc));
     if (newChildren.every((c, i) => c === tag.children[i]))
         return tag;
     return { ...tag, children: newChildren };

package/dist/xref-resolve.js.map

@@ -1 +1 @@
-{"version":3,"file":"xref-resolve.js","sourceRoot":"","sources":["../src/xref-resolve.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"xref-resolve.js","sourceRoot":"","sources":["../src/xref-resolve.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@refrakt-md/runes",
   "description": "Semantic Markdoc runes for refrakt.md",
-  "version": "0.14.3",
+  "version": "0.15.0",
   "type": "module",
   "license": "MIT",
   "repository": {
@@ -29,8 +29,8 @@
     "build": "tsc"
   },
   "dependencies": {
-    "@refrakt-md/types": "0.14.3",
-    "@refrakt-md/transform": "0.14.3",
+    "@refrakt-md/types": "0.15.0",
+    "@refrakt-md/transform": "0.15.0",
     "@markdoc/markdoc": "0.4.0",
     "reflect-metadata": "^0.2.0",
     "fast-xml-parser": "4.5.1",