@refrakt-md/runes 0.15.0 → 0.16.1

package/dist/collection-resolve.js

@@ -0,0 +1,209 @@
+/**
+ * collection postProcess resolver (SPEC-070).
+ *
+ * Walks the serialized renderable, finds `collection` sentinels, queries the
+ * registry (filter / sort / group / limit via the shared field-match grammar),
+ * and renders either a per-entity body template (deferBody) or a built-in
+ * layout (list / cards / grid / table with `fields` projection).
+ */
+import Markdoc from '@markdoc/markdoc';
+import { parseFieldMatch, matchesFieldMatch } from './field-match.js';
+import { transformDeferredTemplate } from './deferred-body.js';
+import { humanize } from './functions.js';
+import { fieldValue, titleLink as titleLinkFor, sortEntities, groupEntities, projectItem, buildOrdering, splitBodyZones, renderItemTemplate, renderGroupAccordion, } from './collection-helpers.js';
+import { COLLECTION_SENTINEL } from './tags/collection.js';
+const { Tag, Ast } = Markdoc;
+function titleLink(e) {
+    return titleLinkFor(e, 'rf-collection');
+}
+function isTag(node) {
+    return Tag.isTag(node);
+}
+function metaContent(tag, field) {
+    for (const child of tag.children ?? []) {
+        if (isTag(child) && child.name === 'meta' && child.attributes['data-field'] === field) {
+            return String(child.attributes.content ?? '');
+        }
+    }
+    return '';
+}
+function hasSentinel(tag) {
+    return (tag.children ?? []).some((c) => isTag(c) && c.name === 'meta' && c.attributes['data-field'] === COLLECTION_SENTINEL);
+}
+function readQuery(tag) {
+    const limitRaw = metaContent(tag, 'collection-limit');
+    const limitNum = Number(limitRaw);
+    return {
+        types: metaContent(tag, 'collection-type').split(',').map((s) => s.trim()).filter(Boolean),
+        filter: metaContent(tag, 'collection-filter'),
+        sort: metaContent(tag, 'collection-sort'),
+        group: metaContent(tag, 'collection-group'),
+        groupDisplay: metaContent(tag, 'collection-group-display') || 'headings',
+        limit: limitRaw && Number.isFinite(limitNum) && limitNum > 0 ? Math.floor(limitNum) : undefined,
+        fields: metaContent(tag, 'collection-fields').split(',').map((s) => s.trim()).filter(Boolean),
+        layout: metaContent(tag, 'collection-layout') || 'list',
+        bodySource: metaContent(tag, 'collection-body'),
+        empty: metaContent(tag, 'collection-empty'),
+    };
+}
+function renderBuiltInItem(e, q) {
+    const fieldSpans = q.fields.map((f) => new Tag('span', { class: 'rf-collection__field', 'data-field': f }, [fieldValue(e, f)]));
+    if (q.layout === 'list') {
+        return new Tag('div', { class: 'rf-collection__item', 'data-entity-id': e.id }, [titleLink(e)]);
+    }
+    // cards / grid
+    return new Tag('article', { class: 'rf-collection__card', 'data-entity-id': e.id }, [titleLink(e), ...fieldSpans]);
+}
+/** Split a captured body source into table columns by heading (SPEC-070 / WORK-264). */
+function splitColumns(bodySource, ctx, pageUrl) {
+    const ast = Markdoc.parse(bodySource);
+    const columns = [];
+    let current = null;
+    for (const node of ast.children) {
+        if (node.type === 'heading') {
+            const label = Markdoc.format(node).replace(/^#+\s*/, '').trim();
+            if (label.includes('$item')) {
+                ctx.warn(`collection: $item in a table column heading ("${label}") is not per-row; use a static label`, pageUrl);
+            }
+            current = { label, cellNodes: [] };
+            columns.push({ label, cellSource: '' });
+        }
+        else if (current) {
+            current.cellNodes.push(node);
+            columns[columns.length - 1].cellSource = Markdoc.format(new Ast.Node('document', {}, current.cellNodes));
+        }
+    }
+    return columns;
+}
+function renderHeadingTable(entities, bodySource, embedConfig, ctx, pageUrl) {
+    const columns = splitColumns(bodySource, ctx, pageUrl);
+    if (!embedConfig) {
+        ctx.error('collection — table column templates present but no embedConfig threaded through the pipeline', pageUrl);
+        return new Tag('table', { class: 'rf-collection__table' }, []);
+    }
+    const thead = new Tag('thead', {}, [new Tag('tr', {}, columns.map((c) => new Tag('th', {}, [c.label])))]);
+    const rows = entities.map((e) => {
+        const item = projectItem(e);
+        const cells = columns.map((c) => {
+            const out = transformDeferredTemplate(c.cellSource, embedConfig, { item });
+            const kids = Array.isArray(out) ? out : [out];
+            return new Tag('td', {}, kids);
+        });
+        return new Tag('tr', { 'data-entity-id': e.id }, cells);
+    });
+    return new Tag('table', { class: 'rf-collection__table' }, [thead, new Tag('tbody', {}, rows)]);
+}
+function renderTable(entities, q) {
+    const headCells = [new Tag('th', {}, ['Title']), ...q.fields.map((f) => new Tag('th', {}, [humanize(f)]))];
+    const thead = new Tag('thead', {}, [new Tag('tr', {}, headCells)]);
+    const rows = entities.map((e) => {
+        const cells = [
+            new Tag('td', {}, [titleLink(e)]),
+            ...q.fields.map((f) => new Tag('td', { 'data-field': f }, [fieldValue(e, f)])),
+        ];
+        return new Tag('tr', { 'data-entity-id': e.id }, cells);
+    });
+    return new Tag('table', { class: 'rf-collection__table' }, [thead, new Tag('tbody', {}, rows)]);
+}
+function renderBody(entities, bodySource, embedConfig, ctx, pageUrl) {
+    if (!embedConfig) {
+        ctx.error('collection — body template present but no embedConfig threaded through the pipeline', pageUrl);
+        return [];
+    }
+    return entities.map((e) => {
+        const item = projectItem(e);
+        const out = transformDeferredTemplate(bodySource, embedConfig, { item });
+        const children = Array.isArray(out) ? out : [out];
+        return new Tag('div', { class: 'rf-collection__item', 'data-entity-id': e.id, 'data-block': '' }, children);
+    });
+}
+function renderGroupOrFlat(entities, q, ordering, renderItems) {
+    if (!q.group)
+        return renderItems(entities);
+    const groups = groupEntities(entities, q.group, ordering);
+    if (q.groupDisplay === 'accordion') {
+        return renderGroupAccordion([...groups].map(([name, es]) => ({ key: name, label: name, count: es.length, nodes: renderItems(es) })));
+    }
+    const out = [];
+    for (const [name, es] of groups) {
+        out.push(new Tag('div', { class: 'rf-collection__group', 'data-group': name }, [
+            new Tag('h3', { class: 'rf-collection__group-title' }, [name]),
+            ...renderItems(es),
+        ]));
+    }
+    return out;
+}
+function resolveOne(tag, registry, embedConfig, ordering, ctx, pageUrl) {
+    const q = readQuery(tag);
+    // Query
+    let entities = [];
+    for (const type of q.types)
+        entities.push(...registry.getAll(type));
+    if (q.filter) {
+        const parsed = parseFieldMatch(q.filter);
+        for (const w of parsed.warnings)
+            ctx.warn(`collection filter: ${w}`, pageUrl);
+        entities = entities.filter((e) => matchesFieldMatch(e, parsed));
+    }
+    entities = sortEntities(entities, q.sort, ordering);
+    // `$count` = total matched (pre-limit); `$shown` = rendered (post-limit).
+    const matched = entities.length;
+    if (q.limit !== undefined && entities.length > q.limit)
+        entities = entities.slice(0, q.limit);
+    const counts = { count: matched, shown: entities.length };
+    const zones = splitBodyZones(q.bodySource);
+    const tmpl = zones.template;
+    const attrs = { ...tag.attributes, 'data-type': q.types.join(','), 'data-layout': q.layout };
+    // Empty state (SPEC-072 Cap 5): fallback zone, else the `empty` attribute,
+    // else nothing. No preamble when empty.
+    if (entities.length === 0) {
+        const out = [];
+        if (zones.fallback && embedConfig) {
+            out.push(new Tag('div', { 'data-name': 'empty', class: 'rf-collection__empty' }, renderItemTemplate(zones.fallback, embedConfig, counts)));
+        }
+        else if (q.empty) {
+            out.push(new Tag('div', { 'data-name': 'empty', class: 'rf-collection__empty' }, [q.empty]));
+        }
+        return new Tag(tag.name, attrs, out);
+    }
+    // Render items from the template zone (or the built-in when it's empty).
+    let children;
+    if (q.layout === 'table' && tmpl) {
+        // Heading-delimited column templates (WORK-264).
+        children = renderGroupOrFlat(entities, q, ordering, (es) => [renderHeadingTable(es, tmpl, embedConfig, ctx, pageUrl)]);
+    }
+    else if (tmpl) {
+        children = renderGroupOrFlat(entities, q, ordering, (es) => renderBody(es, tmpl, embedConfig, ctx, pageUrl));
+    }
+    else if (q.layout === 'table') {
+        children = renderGroupOrFlat(entities, q, ordering, (es) => [renderTable(es, q)]);
+    }
+    else {
+        children = renderGroupOrFlat(entities, q, ordering, (es) => es.map((e) => renderBuiltInItem(e, q)));
+    }
+    const itemsDiv = new Tag('div', { 'data-name': 'items', class: 'rf-collection__items' }, children);
+    // Preamble renders once, above items, only when non-empty.
+    const head = [];
+    if (zones.preamble && embedConfig) {
+        head.push(new Tag('div', { 'data-name': 'preamble', class: 'rf-collection__preamble' }, renderItemTemplate(zones.preamble, embedConfig, counts)));
+    }
+    return new Tag(tag.name, attrs, [...head, itemsDiv]);
+}
+export function resolveCollections(renderable, pageUrl, registry, embedConfig, ctx) {
+    const ordering = buildOrdering(embedConfig);
+    const walk = (node) => {
+        if (Array.isArray(node))
+            return node.map(walk);
+        if (!isTag(node))
+            return node;
+        const tag = node;
+        if (tag.attributes?.['data-rune'] === 'collection' && hasSentinel(tag)) {
+            return resolveOne(tag, registry, embedConfig, ordering, ctx, pageUrl);
+        }
+        if (!tag.children || tag.children.length === 0)
+            return tag;
+        return new Tag(tag.name, tag.attributes, tag.children.map(walk));
+    };
+    return walk(renderable);
+}
+//# sourceMappingURL=collection-resolve.js.map

package/dist/collection-resolve.js.map

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

package/dist/config.d.ts

@@ -57,6 +57,13 @@ export interface CorePipelineHooksOptions {
      *  through `aggregate` into the postProcess `coreData` shape so the xref
      *  resolver can use them as a URL-resolution fallback. */
     xrefPatterns?: CompiledXrefPattern[];
+    /** Canonical GitHub (or compatible) repository URL — `SiteConfig.repoUrl`
+     *  threaded through to the file-ref resolver (SPEC-078) so it can build
+     *  deep-link source URLs of the form `{repoUrl}/blob/{ref}/{path}#L{...}`. */
+    repoUrl?: string;
+    /** Git ref appended to GitHub source URLs (branch / tag / commit SHA).
+     *  Defaults to `"main"` when omitted. */
+    repoBranch?: string;
     /** Merged Markdoc transform config (tags + nodes from core + every
      *  loaded plugin) plus the project root. Threaded through `aggregate`
      *  so the expand postProcess (SPEC-066) can re-transform embedded
@@ -65,6 +72,12 @@ export interface CorePipelineHooksOptions {
     embedConfig?: {
         tags: Record<string, unknown>;
         nodes: Record<string, unknown>;
+        functions?: Record<string, unknown>;
+        /** Parsed partials from the content tree's `_partials/` and any
+         *  registered file-root namespaces. Threaded through so partial
+         *  references inside deferred-body templates (collection, expand)
+         *  resolve the same way they do in top-level page transforms. */
+        partials?: Record<string, unknown>;
         projectRoot?: string;
     };
 }

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAA+B,MAAM,uBAAuB,CAAC;AAEtF,OAAO,KAAK,EAAE,mBAAmB,EAAmB,cAAc,EAAkB,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAS/H,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AA6E9D;gFACgF;AAChF,eAAO,MAAM,UAAU,EAAE,WAwuBxB,CAAC;AAEF,sGAAsG;AACtG,eAAO,MAAM,UAAU,aAAa,CAAC;AAIrC,gEAAgE;AAChE,MAAM,WAAW,YAAY;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,YAAY,EAAE,CAAC;CACzB;AA0vCD,UAAU,YAAY;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,OAAO,CAAC;IACf,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAiLD;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CACnC,UAAU,EAAE,OAAO,EACnB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE;IACT,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACvC,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChI,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,QAAQ,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC;IACnC;;;uBAGmB;IACnB,YAAY,CAAC,EAAE,mBAAmB,EAAE,CAAC;CACrC,EACD,GAAG,EAAE,eAAe;AACpB;;yEAEyE;AACzE,cAAc,CAAC,EAAE,OAAO,EAAE,GACxB,OAAO,CAqBT;AAED,2DAA2D;AAC3D,MAAM,WAAW,wBAAwB;IACxC;;8DAE0D;IAC1D,YAAY,CAAC,EAAE,mBAAmB,EAAE,CAAC;IACrC;;;;2EAIuE;IACvE,WAAW,CAAC,EAAE;QACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC9B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;CACF;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,GAAE,wBAA6B,GAAG,mBAAmB,CAoNhG;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,iBAAiB,EAAE,mBAA+C,CAAC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAA+B,MAAM,uBAAuB,CAAC;AAEtF,OAAO,KAAK,EAAE,mBAAmB,EAAmB,cAAc,EAAkB,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAS/H,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAkF9D;gFACgF;AAChF,eAAO,MAAM,UAAU,EAAE,WA6wBxB,CAAC;AAEF,sGAAsG;AACtG,eAAO,MAAM,UAAU,aAAa,CAAC;AAIrC,gEAAgE;AAChE,MAAM,WAAW,YAAY;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,YAAY,EAAE,CAAC;CACzB;AA0vCD,UAAU,YAAY;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,OAAO,CAAC;IACf,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAiLD;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CACnC,UAAU,EAAE,OAAO,EACnB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE;IACT,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACvC,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChI,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,QAAQ,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC;IACnC;;;uBAGmB;IACnB,YAAY,CAAC,EAAE,mBAAmB,EAAE,CAAC;CACrC,EACD,GAAG,EAAE,eAAe;AACpB;;yEAEyE;AACzE,cAAc,CAAC,EAAE,OAAO,EAAE,GACxB,OAAO,CAqBT;AAED,2DAA2D;AAC3D,MAAM,WAAW,wBAAwB;IACxC;;8DAE0D;IAC1D,YAAY,CAAC,EAAE,mBAAmB,EAAE,CAAC;IACrC;;kFAE8E;IAC9E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;6CACyC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;2EAIuE;IACvE,WAAW,CAAC,EAAE;QACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC9B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC/B,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACpC;;;yEAGiE;QACjE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACnC,WAAW,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;CACF;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,GAAE,wBAA6B,GAAG,mBAAmB,CA0ShG;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,iBAAiB,EAAE,mBAA+C,CAAC"}

package/dist/config.js

@@ -7,9 +7,14 @@ import { NAV_AUTO_SENTINEL, NAV_COLLAPSED_AUTO } from './tags/nav.js';
 import { PAGINATION_AUTO_SENTINEL } from './tags/pagination.js';
 import { resolveXrefs } from './xref-resolve.js';
 import { preprocessSnippets, wrapStandaloneSnippets } from './snippet-pipeline.js';
-import { registerDrawers, resolveAutoDrawerTitleLevels } from './drawer-pipeline.js';
-import { applyOutlineScopeWalkers } from './outline-scope.js';
+import { registerDrawers, resolveAutoDrawerTitleLevels, hoistPreviewDrawers } from './drawer-pipeline.js';
+import { resolveFileRefs } from './file-ref-resolve.js';
+import { resolveXrefPreviews } from './xref-preview-resolve.js';
+import { applyOutlineScopeWalkers, harvestHeadingsFromRenderable } from './outline-scope.js';
 import { resolveExpands } from './expand-pipeline.js';
+import { resolveCollections } from './collection-resolve.js';
+import { resolveRelationships } from './relationships-resolve.js';
+import { resolveAggregates } from './aggregate-resolve.js';
 // ─── Budget postTransform helpers ───
 const BUDGET_CURRENCY_SYMBOLS = {
     USD: '$', EUR: '€', GBP: '£', JPY: '¥', CNY: '¥',
@@ -150,6 +155,43 @@ export const coreConfig = {
          * class="rf-expand" data-rune="expand">`. Engine config provides the
          * block name for CSS tree-shaking. */
         Expand: { block: 'expand' },
+        /* Badge emits a complete `<span class="rf-badge" data-rune="badge">`
+         * directly from its schema and needs no engine post-processing, but
+         * still needs an entry in the theme config so `computeUsedCssBlocks`
+         * includes `badge.css` in CSS tree-shaking when a badge is rendered. */
+        Badge: { block: 'badge' },
+        /* Collection emits a sentinel during transform; the postProcess hook
+         * (`resolveCollections`) fills it with queried entities. Engine config
+         * provides the block name for CSS tree-shaking. */
+        Collection: { block: 'collection' },
+        Relationships: { block: 'relationships' },
+        /* file-ref emits a sentinel during transform; resolveFileRefs in
+         * the postProcess chain binds it to a GitHub URL anchor (and to
+         * a hoist sentinel for the drawer pipeline when preview="drawer").
+         * Engine config entry exists so the BEM block / data-rune are
+         * registered and CSS tree-shaking includes file-ref.css when
+         * authors use the rune. */
+        FileRef: { block: 'file-ref' },
+        /* Aggregate emits a sentinel during transform; the postProcess hook
+         * (`resolveAggregates`) fills it with either a single integer (no-body
+         * form) or a body-zoned breakdown. Engine config provides the block
+         * name for CSS tree-shaking. */
+        Aggregate: { block: 'aggregate' },
+        Progress: {
+            block: 'progress',
+            modifiers: { sentiment: { source: 'meta' } },
+        },
+        /* card — generic content card. The `layout` meta drives the shared
+         * split layout (split.css, data-attribute-keyed); data-media-position
+         * hoists the media to a full-bleed header on mobile. Named parts
+         * (media/content/body/footer/link) get rf-card__* from data-name. */
+        Card: {
+            block: 'card',
+            rootAttributes: { 'data-media-position': 'top' },
+            modifiers: {
+                layout: { source: 'meta', default: 'stacked' },
+            },
+        },
         Embed: {
             block: 'embed',
             defaultDensity: 'compact',
@@ -331,8 +373,8 @@ export const coreConfig = {
                 size: { source: 'meta', default: 'md' },
                 shortcut: { source: 'meta', noBemClass: true },
             },
-            sections: { header: 'header', body: 'body' },
-            editHints: { title: 'inline', body: 'none', close: 'none' },
+            sections: { header: 'header', body: 'body', footer: 'footer' },
+            editHints: { title: 'inline', body: 'none', close: 'none', footer: 'none' },
         },
         Figure: {
             block: 'figure',
@@ -2047,6 +2089,8 @@ navSearchScope) {
 export function createCorePipelineHooks(opts = {}) {
     const xrefPatterns = opts.xrefPatterns ?? [];
     const embedConfig = opts.embedConfig;
+    const repoUrl = opts.repoUrl;
+    const repoBranch = opts.repoBranch;
     return {
         preprocess: preprocessSnippets,
         register(pages, registry, ctx) {
@@ -2117,7 +2161,7 @@ export function createCorePipelineHooks(opts = {}) {
                 draft: e.data.draft || false,
                 frontmatter: e.data,
             }));
-            return { pageTree, breadcrumbPaths, pagesByUrl, headingIndex, allPosts, registry, xrefPatterns, embedConfig };
+            return { pageTree, breadcrumbPaths, pagesByUrl, headingIndex, allPosts, registry, xrefPatterns, embedConfig, repoUrl, repoBranch };
         },
         postProcess(page, aggregated, ctx) {
             const coreData = aggregated['__core__'];
@@ -2138,10 +2182,38 @@ export function createCorePipelineHooks(opts = {}) {
             // resolution so the rewritten title doesn't carry the sentinel
             // attribute into the rendered HTML.
             renderable = resolveAutoDrawerTitleLevels(renderable);
+            // SPEC-078 — bind file-ref sentinels to their GitHub URLs and emit
+            // the hoist sentinel when `preview="drawer"`. Must run before
+            // `hoistPreviewDrawers` (which consumes the hoist sentinel) and
+            // before xref resolution (so the file-ref's inline `<a>` carries
+            // its final href into the rendered tree).
+            renderable = resolveFileRefs(renderable, page.url, coreData.repoUrl, coreData.repoBranch, ctx);
+            // SPEC-078 — rewrite xref placeholders carrying `data-xref-preview=
+            // "drawer"` into an inline `<a href="#drawer-{id}">` + hoist
+            // sentinel. Non-preview xref placeholders pass through to
+            // resolveXrefs later in the chain.
+            renderable = resolveXrefPreviews(renderable, page.url, coreData.registry, ctx);
+            // SPEC-078 hoist mechanism — collect `preview="drawer"` sentinels
+            // from file-ref / xref / future reference runes and emit hoisted
+            // `<section class="rf-drawer">` at the page root. Runs before
+            // expand resolution so an xref-preview drawer's body (which uses
+            // the expand resolver internally) is resolved by the same pass.
+            renderable = hoistPreviewDrawers(renderable, page.url, coreData.registry, coreData.embedConfig?.projectRoot, ctx);
             // SPEC-066 expand resolution — substitutes embedded entity content
             // before xref runs so refs inside substituted content are resolved
             // by the same pass as host-page refs.
             renderable = resolveExpands(renderable, page.url, coreData.registry, coreData.xrefPatterns ?? [], coreData.embedConfig, ctx);
+            // SPEC-070 collection resolution — runs after expand and before xref so
+            // item-template `{% ref %}`s are resolved by the same xref pass.
+            renderable = resolveCollections(renderable, page.url, coreData.registry, coreData.embedConfig, ctx);
+            // SPEC-072 relationships resolution — same placement rationale as
+            // collection: after expand, before xref (so item-template `{% ref %}`s
+            // resolve in the same xref pass).
+            renderable = resolveRelationships(renderable, page.url, coreData.registry, coreData.embedConfig, ctx);
+            // SPEC-076 aggregate resolution — same placement as collection /
+            // relationships: after expand, before xref (so any `{% ref %}` inside
+            // the body template resolves in the same xref pass).
+            renderable = resolveAggregates(renderable, page.url, coreData.registry, coreData.embedConfig, ctx);
             renderable = resolveXrefs(renderable, page.url, coreData.registry, coreData.xrefPatterns ?? [], ctx);
             // SPEC-062 standalone snippet wrap: turn `<pre data-snippet-source>`
             // into `<figure class="rf-snippet">` when not inside a fence-consuming
@@ -2154,6 +2226,16 @@ export function createCorePipelineHooks(opts = {}) {
             // see the final tree (including expand-substituted content once
             // that lands in v0.15.0).
             applyOutlineScopeWalkers(wrappedPage.renderable);
+            // Refresh `page.headings` from the final renderable. Parse-time
+            // `extractHeadings` only saw the raw AST — anything inlined by
+            // postProcess (expand `level=N`, collection bodies) wouldn't make
+            // it into the parse-time list, leaving the page TOC blind to those
+            // headings. Skips `data-outline-scope` subtrees so peer-document
+            // embeds stay isolated, matching the TOC walker.
+            const harvested = harvestHeadingsFromRenderable(wrappedPage.renderable);
+            if (harvested.length > 0 || wrappedPage.headings.length > 0) {
+                return { ...wrappedPage, headings: harvested };
+            }
             return wrappedPage;
         },
     };