@refrakt-md/runes 0.14.4 → 0.16.0

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

@@ -1,5 +1,6 @@
 import type { ThemeConfig } from '@refrakt-md/transform';
 import type { PluginPipelineHooks, EntityRegistry, PipelineContext } from '@refrakt-md/types';
+import type { CompiledXrefPattern } from './xref-patterns.js';
 /** Core theme configuration — universal rune-to-BEM-block mappings shared by all themes.
  *  Icons are empty; themes provide their own icon SVGs via mergeThemeConfig. */
 export declare const coreConfig: ThemeConfig;
@@ -40,16 +41,57 @@ export declare function resolveCoreSentinels(renderable: unknown, pageUrl: strin
     }>;
     allPosts: BlogPostData[];
     registry: Readonly<EntityRegistry>;
+    /** Compiled xref patterns from `refrakt.config.json#/xrefs`. Empty
+     *  array when no patterns are configured (the resolver's
+     *  "patterns step" then matches nothing and falls through to
+     *  unresolved). */
+    xrefPatterns?: CompiledXrefPattern[];
 }, ctx: PipelineContext, 
 /** Extra trees (e.g. layout regions + page content) to scan when looking
  *  for nav sequences during auto-pagination. Required when calling against
  *  a layout region where the sidebar nav lives in a different region. */
 navSearchScope?: unknown[]): unknown;
+/** Options accepted by {@link createCorePipelineHooks}. */
+export interface CorePipelineHooksOptions {
+    /** Compiled xref patterns from `refrakt.config.json#/xrefs`. Threaded
+     *  through `aggregate` into the postProcess `coreData` shape so the xref
+     *  resolver can use them as a URL-resolution fallback. */
+    xrefPatterns?: CompiledXrefPattern[];
+    /** 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
+     *  AST subtrees using the same rune schemas the host page used,
+     *  and read source files with the same sandbox boundary as snippet. */
+    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;
+    };
+}
 /**
- * Core cross-page pipeline hooks.
- * Run for every site, before any plugin hooks.
- * Registers page and heading entities, aggregates the page tree and breadcrumb paths,
- * and resolves blog post listings.
+ * Build core cross-page pipeline hooks parameterized by build-time options.
+ *
+ * Most callers (existing adapters, tests) use the {@link corePipelineHooks}
+ * default below — equivalent to `createCorePipelineHooks()` with no patterns
+ * configured. The content-loader bootstrap passes compiled
+ * {@link CompiledXrefPattern}s when `refrakt.config.json#/xrefs` is set.
+ */
+export declare function createCorePipelineHooks(opts?: CorePipelineHooksOptions): PluginPipelineHooks;
+/**
+ * Core cross-page pipeline hooks (no xref patterns configured).
+ *
+ * Equivalent to `createCorePipelineHooks()`. The content loader bootstrap
+ * uses {@link createCorePipelineHooks} directly when
+ * `refrakt.config.json#/xrefs` is configured so the resolver can use the
+ * compiled patterns as a URL-resolution fallback. Run for every site,
+ * before any plugin hooks. Registers page and heading entities, aggregates
+ * the page tree and breadcrumb paths, and resolves blog post listings.
  */
 export declare const corePipelineHooks: PluginPipelineHooks;
 export {};

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;AAiF/H;gFACgF;AAChF,eAAO,MAAM,UAAU,EAAE,WAitBxB,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;CACnC,EACD,GAAG,EAAE,eAAe;AACpB;;yEAEyE;AACzE,cAAc,CAAC,EAAE,OAAO,EAAE,GACxB,OAAO,CAqBT;AAED;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,EAAE,mBAgK/B,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;AAgF9D;gFACgF;AAChF,eAAO,MAAM,UAAU,EAAE,WAswBxB,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,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,CAiQhG;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,iBAAiB,EAAE,mBAA+C,CAAC"}