@refrakt-md/runes 0.14.4 → 0.16.0

package/dist/tags/snippet.js

@@ -0,0 +1,49 @@
+import { createContentModelSchema } from '../lib/index.js';
+/**
+ * The `snippet` rune — embed a file's contents as a syntax-highlighted code
+ * block (SPEC-062).
+ *
+ * Implementation note: snippet is implemented as an **AST preprocessor**
+ * rather than a transform-time rune. Every `{% snippet %}` tag is replaced
+ * by a Markdoc `fence` node before the schema-driven transform runs (see
+ * `corePipelineHooks.preprocess` in `../config.ts`). By the time the transform
+ * reaches the AST, no snippet tags exist — only fences. So this schema's
+ * `transform` function is **unreachable in normal operation**.
+ *
+ * The schema still exists for tooling: `refrakt inspect snippet`, the
+ * contracts generator, attribute validation, and the rune-catalog docs all
+ * read from it. If the transform ever does execute (e.g., the core preprocess
+ * hook isn't registered for some reason), it throws a clear error pointing
+ * the user at the registration site.
+ */
+export const snippet = createContentModelSchema({
+    attributes: {
+        path: {
+            type: String,
+            required: true,
+            description: 'Path to the source file, relative to the project root. Rejected if it escapes the root.',
+        },
+        lines: {
+            type: String,
+            required: false,
+            description: 'Line range. Formats: "10-25", "10-" (to EOF), "-20" (from start), "10" (single line). 1-indexed, inclusive.',
+        },
+        lang: {
+            type: String,
+            required: false,
+            description: 'Syntax-highlighting language hint. Overrides the extension-based inference.',
+        },
+    },
+    contentModel: { type: 'sequence', fields: [] },
+    transform(_resolved, _attrs) {
+        // Unreachable in normal operation — corePipelineHooks.preprocess
+        // replaces snippet tags with fence nodes before the transform runs.
+        // If you see this error, ensure your content pipeline runs the
+        // preprocess phase (call sites: packages/content/src/site.ts and the
+        // hook set assembled via createCorePipelineHooks).
+        throw new Error('snippet rune reached the transform phase — its preprocess hook was not wired through. ' +
+            'Ensure the content pipeline runs registered `preprocess` hooks before `Markdoc.transform` ' +
+            '(snippet pre-resolves to a Markdoc `fence` node; see SPEC-062 § Composition).');
+    },
+});
+//# sourceMappingURL=snippet.js.map

package/dist/tags/snippet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snippet.js","sourceRoot":"","sources":["../../src/tags/snippet.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAE3D;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,wBAAwB,CAAC;IAC/C,UAAU,EAAE;QACX,IAAI,EAAE;YACL,IAAI,EAAE,MAAM;YACZ,QAAQ,EAAE,IAAI;YACd,WAAW,EAAE,yFAAyF;SACtG;QACD,KAAK,EAAE;YACN,IAAI,EAAE,MAAM;YACZ,QAAQ,EAAE,KAAK;YACf,WAAW,EAAE,6GAA6G;SAC1H;QACD,IAAI,EAAE;YACL,IAAI,EAAE,MAAM;YACZ,QAAQ,EAAE,KAAK;YACf,WAAW,EAAE,6EAA6E;SAC1F;KACD;IACD,YAAY,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE;IAC9C,SAAS,CAAC,SAAS,EAAE,MAAM;QAC1B,iEAAiE;QACjE,oEAAoE;QACpE,+DAA+D;QAC/D,qEAAqE;QACrE,mDAAmD;QACnD,MAAM,IAAI,KAAK,CACd,wFAAwF;YACxF,4FAA4F;YAC5F,+EAA+E,CAC/E,CAAC;IACH,CAAC;CACD,CAAC,CAAC"}

package/dist/util.d.ts

@@ -19,5 +19,16 @@ export interface HeadingInfo {
  * IDs using the same algorithm as nodes.ts heading transform.
  */
 export declare function extractHeadings(node: Node): HeadingInfo[];
+/**
+ * Find the text content of the first H1 heading in an AST.
+ *
+ * Walks depth-first, descending into both regular nodes and tag (rune)
+ * children. The first `heading` node with `level: 1` wins. Used by the
+ * content pipeline to derive `$page.title` when frontmatter doesn't set
+ * one — matches the author mental model of "the page's title is the H1
+ * the reader sees," including the common case where an H1 is wrapped in
+ * a layout rune (hero etc.).
+ */
+export declare function firstH1(node: Node): string | undefined;
 export declare function headingsToList(options?: HeadingsToListOptions): (nodes: Node[]) => Markdoc.Node[];
 //# sourceMappingURL=util.d.ts.map

package/dist/util.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,kBAAkB,CAAC;AACvC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAE9E,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAG7C,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,QAoB7D;AAED,wBAAiB,OAAO,CAAC,GAAG,EAAE,GAAG,GAAG,SAAS,CAAC,kBAAkB,CAAC,CAShE;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,OAAO,CAAC,EAAE,UAAU,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,2EAA2E;IAC3E,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,GAAG,WAAW,EAAE,CA+BzD;AAED,wBAAgB,cAAc,CAAC,OAAO,CAAC,EAAE,qBAAqB,IAIpD,OAAO,IAAI,EAAE,oBAkCtB"}
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,kBAAkB,CAAC;AACvC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAE9E,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAG7C,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,QAoB7D;AAED,wBAAiB,OAAO,CAAC,GAAG,EAAE,GAAG,GAAG,SAAS,CAAC,kBAAkB,CAAC,CAShE;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,OAAO,CAAC,EAAE,UAAU,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,2EAA2E;IAC3E,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,GAAG,WAAW,EAAE,CA+BzD;AAED;;;;;;;;;GASG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,SAAS,CAyBtD;AAED,wBAAgB,cAAc,CAAC,OAAO,CAAC,EAAE,qBAAqB,IAIpD,OAAO,IAAI,EAAE,oBAkCtB"}

package/dist/util.js

@@ -62,6 +62,41 @@ export function extractHeadings(node) {
     walk(node);
     return headings;
 }
+/**
+ * Find the text content of the first H1 heading in an AST.
+ *
+ * Walks depth-first, descending into both regular nodes and tag (rune)
+ * children. The first `heading` node with `level: 1` wins. Used by the
+ * content pipeline to derive `$page.title` when frontmatter doesn't set
+ * one — matches the author mental model of "the page's title is the H1
+ * the reader sees," including the common case where an H1 is wrapped in
+ * a layout rune (hero etc.).
+ */
+export function firstH1(node) {
+    let found;
+    function walk(n) {
+        if (n.type === 'heading' && n.attributes.level === 1) {
+            const textParts = [];
+            for (const child of n.walk()) {
+                if (child.type === 'text' && child.attributes.content) {
+                    textParts.push(child.attributes.content);
+                }
+            }
+            // Text nodes already carry their own surrounding whitespace, so joining
+            // with `''` (rather than `' '`) avoids doubling spaces when a heading
+            // contains inline formatting like `# Hello **strong** world`.
+            found = textParts.join('');
+            return true;
+        }
+        for (const child of n.children) {
+            if (walk(child))
+                return true;
+        }
+        return false;
+    }
+    walk(node);
+    return found;
+}
 export function headingsToList(options) {
     const explicitLevel = options?.level;
     const include = options?.include;

package/dist/util.js.map

@@ -1 +1 @@
-{"version":3,"file":"util.js","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,kBAAkB,CAAC;AAEvC,MAAM,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC;AAExB,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEjD,MAAM,UAAU,mBAAmB,CAAC,IAAU,EAAE,MAAc;IAC5D,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,YAAY,EAAE,CAAC;QACnC,MAAM,CAAC,SAAiC,CAAC,YAAY,GAAG,IAAI,GAAG,EAAU,CAAC;IAC7E,CAAC;IACD,MAAM,YAAY,GAAG,MAAM,CAAC,SAAS,EAAE,YAA2B,CAAC;IAEnE,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,EAAE,CAAC;QACxB,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QAE1D,IAAI,IAAI,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;YACxB,IAAI,KAAK,GAAG,CAAC,CAAC;YAEd,OAAO,YAAY,CAAC,GAAG,CAAC,GAAG,MAAM,IAAI,KAAK,EAAE,CAAC,EAAE,CAAC;gBAC9C,KAAK,EAAE,CAAC;YACV,CAAC;YACD,MAAM,EAAE,GAAG,GAAG,MAAM,IAAI,KAAK,EAAE,CAAC;YAChC,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACrB,IAAI,CAAC,UAAU,CAAC,EAAE,GAAG,EAAE,CAAC;QAC1B,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,SAAU,CAAC,CAAA,OAAO,CAAC,GAAQ;IAC/B,MAAM,GAAG,CAAC;IACV,KAAK,MAAM,KAAK,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC;QACjC,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;YAC7B,KAAK,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACxB,CAAC;aAAM,CAAC;YACN,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;AACH,CAAC;AAgBD;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,IAAU;IACxC,MAAM,QAAQ,GAAkB,EAAE,CAAC;IAEnC,SAAS,IAAI,CAAC,CAAO;QACnB,IAAI,CAAC,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YACzB,MAAM,SAAS,GAAa,EAAE,CAAC;YAC/B,KAAK,MAAM,KAAK,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;gBAC7B,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,KAAK,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;oBACtD,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;gBAC3C,CAAC;YACH,CAAC;YACD,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACjC,MAAM,EAAE,GAAG,CAAC,CAAC,UAAU,CAAC,EAAE,IAAI,IAAI;iBAC/B,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;iBACnB,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;iBACpB,WAAW,EAAE,CAAC;YAEjB,QAAQ,CAAC,IAAI,CAAC;gBACZ,KAAK,EAAE,CAAC,CAAC,UAAU,CAAC,KAAK;gBACzB,IAAI;gBACJ,EAAE;aACH,CAAC,CAAC;QACL,CAAC;QAED,KAAK,MAAM,KAAK,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;YAC/B,IAAI,CAAC,KAAK,CAAC,CAAC;QACd,CAAC;IACH,CAAC;IAED,IAAI,CAAC,IAAI,CAAC,CAAC;IACX,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAA+B;IAC5D,MAAM,aAAa,GAAG,OAAO,EAAE,KAAK,CAAC;IACrC,MAAM,OAAO,GAAG,OAAO,EAAE,OAAO,CAAC;IAEjC,OAAO,CAAC,KAAa,EAAE,EAAE;QACvB,wDAAwD;QACxD,MAAM,KAAK,GAAG,aAAa,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,EAAE,UAAU,CAAC,KAAK,CAAC;QACvF,IAAI,CAAC,KAAK;YAAE,OAAO,KAAK,CAAC;QACzB,IAAI,KAAyB,CAAC;QAC9B,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAClC,MAAM,IAAI,GAAW,EAAE,CAAC;QACxB,IAAI,IAAI,GAAW,EAAE,CAAC;QAEtB,KAAK,IAAI,CAAC,GAAC,CAAC,EAAE,CAAC,GAAC,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAClC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YAEtB,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,KAAK,KAAK,EAAE,CAAC;gBAC/D,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBACrD,KAAK,GAAG,CAAC,CAAC;YACZ,CAAC;iBAAM,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBAC/B,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAClB,CAAC;iBAAM,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC;gBAC9E,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;gBACtC,IAAI,QAAQ,EAAE,CAAC;oBACb,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC/B,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;gBACtB,MAAM;YACR,CAAC;QACH,CAAC;QAED,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/B,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO,CAAC,GAAG,IAAI,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,CAAC;IAClC,CAAC,CAAA;AACH,CAAC"}
+{"version":3,"file":"util.js","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":"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"}

package/dist/xref-patterns.d.ts

@@ -0,0 +1,57 @@
+/**
+ * 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).
+ */
+import type { XrefPattern } from '@refrakt-md/types';
+/** A pattern entry compiled and ready to be matched against an xref ID at
+ *  resolve time. Authored {@link XrefPattern}s in `refrakt.config.json` are
+ *  turned into this shape once per build via {@link compileXrefPatterns}. */
+export interface CompiledXrefPattern {
+    /** The compiled regex (already wrapped in whole-string anchors if needed). */
+    match: RegExp;
+    /** URL template — same string the author wrote, ready for placeholder
+     *  substitution by the resolver. */
+    template: string;
+    /** CSS modifier class value. Defaulted to `"external"` if the author
+     *  omitted it. */
+    type: string;
+    /** Link-text template. Defaulted to `"{id}"` if the author omitted it. */
+    label: string;
+    /** Named groups declared in the regex, in declaration order. The resolver
+     *  uses these (plus the implicit `{id}`) to validate template placeholders
+     *  at match time. */
+    groupNames: string[];
+}
+/** Diagnostics produced by {@link compileXrefPatterns}. Compilation never
+ *  throws — fatal cases (invalid regex, unknown placeholder, reserved type)
+ *  are surfaced via `errors`; soft diagnostics (duplicate `match`) via
+ *  `warnings`. Adapters decide how to render them. */
+export interface CompiledXrefPatternsResult {
+    patterns: CompiledXrefPattern[];
+    errors: string[];
+    warnings: string[];
+}
+/**
+ * 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 declare function compileXrefPatterns(patterns: XrefPattern[] | undefined): CompiledXrefPatternsResult;
+//# sourceMappingURL=xref-patterns.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"xref-patterns.d.ts","sourceRoot":"","sources":["../src/xref-patterns.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD;;6EAE6E;AAC7E,MAAM,WAAW,mBAAmB;IACnC,8EAA8E;IAC9E,KAAK,EAAE,MAAM,CAAC;IACd;wCACoC;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB;sBACkB;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,0EAA0E;IAC1E,KAAK,EAAE,MAAM,CAAC;IACd;;yBAEqB;IACrB,UAAU,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;;sDAGsD;AACtD,MAAM,WAAW,0BAA0B;IAC1C,QAAQ,EAAE,mBAAmB,EAAE,CAAC;IAChC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACnB;AA+CD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAClC,QAAQ,EAAE,WAAW,EAAE,GAAG,SAAS,GACjC,0BAA0B,CA8E5B"}

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"}