@refrakt-md/runes 0.14.4 → 0.16.0

package/dist/snippet-pipeline.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Snippet pipeline hooks (SPEC-062).
+ *
+ * - **Preprocess** walks the parsed Markdoc AST, finds every `{% snippet %}`
+ *   tag, resolves + slices its source file, and replaces the tag with a
+ *   Markdoc `fence` node. The fence carries `content` and `language` (so
+ *   the existing code-block transform syntax-highlights it identically to
+ *   a triple-backtick fence) plus `data-snippet-source` / `data-snippet-lines`
+ *   attributes for downstream tooling and the wrap step.
+ *
+ * - **PostProcess** walks the rendered renderable tree, finds every `<pre>`
+ *   element carrying `data-snippet-source`, and — when not nested under a
+ *   fence-consuming container (`data-rune="code-group"`, `data-rune="diff"`)
+ *   — wraps it in `<figure class="rf-snippet">` so themes can style snippet
+ *   blocks distinctly from regular code blocks (and tooling can find
+ *   `data-source-path` on the figure).
+ *
+ * This separation is the SPEC-062 composition story: container runes see
+ * snippet output as a regular fence (because preprocess made it one) and
+ * consume it transparently; standalone snippets get the figure chrome via
+ * the wrap step. Captions / titles are intentionally not provided — wrap
+ * a snippet in `{% codegroup title="..." %}` if you want a labelled chrome.
+ */
+import type { Node } from '@markdoc/markdoc';
+import type { PreprocessContext, PreprocessPage, PipelineContext, TransformedPage, AggregatedData } from '@refrakt-md/types';
+/**
+ * Preprocess: replace every `{% snippet %}` tag in the AST with a `fence`
+ * node carrying the resolved file content. After this runs, no snippet
+ * tags remain in the AST — only fences (some "snippet-derived" identified
+ * by their `data-snippet-source` attribute).
+ */
+export declare function preprocessSnippets(ast: Node, page: PreprocessPage, ctx: PreprocessContext): Node | void;
+/**
+ * PostProcess: wrap standalone snippet-derived `<pre>` elements in the
+ * snippet figure chrome. Run as part of `corePipelineHooks.postProcess`.
+ *
+ * Container-nested snippets (inside `<div data-rune="code-group">` or
+ * `<div data-rune="diff">` outputs) are left alone — the container's chrome
+ * is already there and the figure would be duplicate.
+ */
+export declare function wrapStandaloneSnippets(page: TransformedPage, _aggregated: AggregatedData, _ctx: PipelineContext): TransformedPage;
+//# sourceMappingURL=snippet-pipeline.d.ts.map

package/dist/snippet-pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snippet-pipeline.d.ts","sourceRoot":"","sources":["../src/snippet-pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,eAAe,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAiC7H;;;;;GAKG;AACH,wBAAgB,kBAAkB,CACjC,GAAG,EAAE,IAAI,EACT,IAAI,EAAE,cAAc,EACpB,GAAG,EAAE,iBAAiB,GACpB,IAAI,GAAG,IAAI,CAYb;AAsGD;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACrC,IAAI,EAAE,eAAe,EACrB,WAAW,EAAE,cAAc,EAC3B,IAAI,EAAE,eAAe,GACnB,eAAe,CAIjB"}

package/dist/snippet-pipeline.js

@@ -0,0 +1,219 @@
+/**
+ * Snippet pipeline hooks (SPEC-062).
+ *
+ * - **Preprocess** walks the parsed Markdoc AST, finds every `{% snippet %}`
+ *   tag, resolves + slices its source file, and replaces the tag with a
+ *   Markdoc `fence` node. The fence carries `content` and `language` (so
+ *   the existing code-block transform syntax-highlights it identically to
+ *   a triple-backtick fence) plus `data-snippet-source` / `data-snippet-lines`
+ *   attributes for downstream tooling and the wrap step.
+ *
+ * - **PostProcess** walks the rendered renderable tree, finds every `<pre>`
+ *   element carrying `data-snippet-source`, and — when not nested under a
+ *   fence-consuming container (`data-rune="code-group"`, `data-rune="diff"`)
+ *   — wraps it in `<figure class="rf-snippet">` so themes can style snippet
+ *   blocks distinctly from regular code blocks (and tooling can find
+ *   `data-source-path` on the figure).
+ *
+ * This separation is the SPEC-062 composition story: container runes see
+ * snippet output as a regular fence (because preprocess made it one) and
+ * consume it transparently; standalone snippets get the figure chrome via
+ * the wrap step. Captions / titles are intentionally not provided — wrap
+ * a snippet in `{% codegroup title="..." %}` if you want a labelled chrome.
+ */
+import Markdoc from '@markdoc/markdoc';
+import { readSnippetFile, SnippetSandboxError } from './lib/read-file.js';
+import { inferLanguage } from './lang-map.js';
+const { Ast, Tag } = Markdoc;
+/** Resolve a Markdoc attribute value to a string. Handles literal strings
+ *  and Markdoc `Variable` AST nodes (e.g. `path=$file.path` parses as a
+ *  Variable, not a string). Unresolvable references (variable missing from
+ *  the context, or attribute is some other AST shape) return an empty
+ *  string — matching transform-time variable-evaluation behaviour. */
+function resolveAttributeValue(value, variables) {
+    if (value === undefined || value === null)
+        return '';
+    if (typeof value === 'string')
+        return value;
+    if (typeof value === 'number' || typeof value === 'boolean')
+        return String(value);
+    if (typeof value === 'object' && '$$mdtype' in value) {
+        const node = value;
+        if (node.$$mdtype === 'Variable' && Array.isArray(node.path)) {
+            let current = variables;
+            for (const segment of node.path) {
+                if (current === null || current === undefined)
+                    return '';
+                current = current[segment];
+            }
+            return current === null || current === undefined ? '' : String(current);
+        }
+    }
+    return '';
+}
+/** Containers whose output consumes their fence children — wrapping a
+ *  snippet-derived `<pre>` inside them would be duplicate chrome. */
+const FENCE_CONSUMING_CONTAINERS = new Set(['code-group', 'diff']);
+/**
+ * Preprocess: replace every `{% snippet %}` tag in the AST with a `fence`
+ * node carrying the resolved file content. After this runs, no snippet
+ * tags remain in the AST — only fences (some "snippet-derived" identified
+ * by their `data-snippet-source` attribute).
+ */
+export function preprocessSnippets(ast, page, ctx) {
+    if (!ctx.projectRoot) {
+        // No project root configured — silently no-op. Snippet refs will fall
+        // through to the schema's transform, which throws a clear error.
+        return;
+    }
+    let mutated = false;
+    walkAndReplaceSnippets(ast, page, ctx, ctx.projectRoot, (didReplace) => {
+        if (didReplace)
+            mutated = true;
+    });
+    return mutated ? ast : undefined;
+}
+function walkAndReplaceSnippets(node, page, ctx, projectRoot, onReplaced) {
+    if (!node.children)
+        return;
+    for (let i = 0; i < node.children.length; i++) {
+        const child = node.children[i];
+        if (child.type === 'tag' && child.tag === 'snippet') {
+            // Always produce a fence — successful resolution returns the
+            // real fence; sandbox / missing-file / variable-resolution errors
+            // produce an error fence so the snippet tag never reaches the
+            // schema's transform (which throws). The build keeps going and
+            // the failure is visible on the rendered page.
+            node.children[i] = resolveSnippetToFence(child, page, ctx, projectRoot);
+            onReplaced(true);
+            // Don't recurse — replaced.
+            continue;
+        }
+        walkAndReplaceSnippets(child, page, ctx, projectRoot, onReplaced);
+    }
+}
+/** Build a `fence` AST node that renders a clear error message in place of
+ *  the snippet. Used when resolution fails (sandbox, missing file, malformed
+ *  lines, unresolvable variable reference). The fence carries the original
+ *  attempted path in `data-snippet-source` so tooling can still detect
+ *  snippet provenance. */
+function makeErrorFence(pathAttr, message) {
+    return new Ast.Node('fence', {
+        content: `snippet error: ${message}\n`,
+        language: 'text',
+        'data-snippet-source': pathAttr || '(unresolved)',
+        'data-snippet-error': message,
+    });
+}
+function resolveSnippetToFence(tag, page, ctx, projectRoot) {
+    const pathAttr = resolveAttributeValue(tag.attributes.path, ctx.variables);
+    const lines = tag.attributes.lines !== undefined
+        ? resolveAttributeValue(tag.attributes.lines, ctx.variables)
+        : undefined;
+    const langAttr = tag.attributes.lang !== undefined
+        ? resolveAttributeValue(tag.attributes.lang, ctx.variables)
+        : undefined;
+    if (!pathAttr) {
+        const msg = 'snippet `path` attribute is required (and an unresolvable variable reference resolves to empty)';
+        ctx.error(msg, page.url);
+        return makeErrorFence('', msg);
+    }
+    let result;
+    try {
+        result = readSnippetFile({
+            pathAttr,
+            projectRoot,
+            lines: lines || undefined,
+            referencingPage: page.relativePath,
+        });
+    }
+    catch (err) {
+        if (err instanceof SnippetSandboxError) {
+            ctx.error(err.message, page.url);
+            return makeErrorFence(pathAttr, err.message);
+        }
+        // Unexpected error type — still produce an error fence so the build
+        // doesn't crash on a single page.
+        const msg = err.message ?? String(err);
+        ctx.error(`snippet "${pathAttr}" failed unexpectedly: ${msg}`, page.url);
+        return makeErrorFence(pathAttr, msg);
+    }
+    for (const warning of result.warnings) {
+        ctx.warn(warning, page.url);
+    }
+    const language = (langAttr && langAttr.length > 0) ? langAttr : inferLanguage(result.relativePath);
+    const fenceAttrs = {
+        content: result.content,
+        language,
+        'data-snippet-source': result.relativePath,
+    };
+    if (lines)
+        fenceAttrs['data-snippet-lines'] = lines;
+    // Construct a fence Ast.Node. Markdoc parses ``` blocks as
+    // new Ast.Node('fence', { content, language }) — same shape here.
+    return new Ast.Node('fence', fenceAttrs);
+}
+/**
+ * PostProcess: wrap standalone snippet-derived `<pre>` elements in the
+ * snippet figure chrome. Run as part of `corePipelineHooks.postProcess`.
+ *
+ * Container-nested snippets (inside `<div data-rune="code-group">` or
+ * `<div data-rune="diff">` outputs) are left alone — the container's chrome
+ * is already there and the figure would be duplicate.
+ */
+export function wrapStandaloneSnippets(page, _aggregated, _ctx) {
+    const wrapped = walkAndWrap(page.renderable, /* containerAncestors */ false);
+    if (wrapped === page.renderable)
+        return page;
+    return { ...page, renderable: wrapped };
+}
+function walkAndWrap(node, insideFenceContainer) {
+    if (Array.isArray(node)) {
+        let mutated = false;
+        const next = node.map((c) => {
+            const w = walkAndWrap(c, insideFenceContainer);
+            if (w !== c)
+                mutated = true;
+            return w;
+        });
+        return mutated ? next : node;
+    }
+    if (!Tag.isTag(node))
+        return node;
+    const tag = node;
+    const dataRune = tag.attributes?.['data-rune'];
+    const enteredFenceContainer = typeof dataRune === 'string' && FENCE_CONSUMING_CONTAINERS.has(dataRune);
+    const childAncestor = insideFenceContainer || enteredFenceContainer;
+    // Wrap matching <pre> elements that aren't inside a fence-consuming container.
+    if (tag.name === 'pre' &&
+        tag.attributes?.['data-snippet-source'] !== undefined &&
+        !insideFenceContainer) {
+        return wrapPreInFigure(tag);
+    }
+    if (!tag.children || tag.children.length === 0)
+        return tag;
+    let mutated = false;
+    const newChildren = tag.children.map((c) => {
+        const w = walkAndWrap(c, childAncestor);
+        if (w !== c)
+            mutated = true;
+        return w;
+    });
+    if (!mutated)
+        return tag;
+    return new Tag(tag.name, tag.attributes, newChildren);
+}
+function wrapPreInFigure(preTag) {
+    const attrs = preTag.attributes;
+    const source = String(attrs['data-snippet-source'] ?? '');
+    const linesAttr = attrs['data-snippet-lines'] !== undefined ? String(attrs['data-snippet-lines']) : undefined;
+    const figureAttrs = {
+        class: 'rf-snippet',
+        'data-rune': 'snippet',
+        'data-source-path': source,
+    };
+    if (linesAttr)
+        figureAttrs['data-lines'] = linesAttr;
+    return new Tag('figure', figureAttrs, [preTag]);
+}
+//# sourceMappingURL=snippet-pipeline.js.map

package/dist/snippet-pipeline.js.map

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

package/dist/tags/aggregate.d.ts

@@ -0,0 +1,19 @@
+import Markdoc from '@markdoc/markdoc';
+export declare const AGGREGATE_SENTINEL = "__aggregate-sentinel";
+/**
+ * `aggregate` (SPEC-076) — the third post-process-resolved query rune, beside
+ * `collection` and `relationships`. Where they project entities and edges, this
+ * one projects **numbers** — counts over the same field-match query, optionally
+ * broken down by group. Two modes from the same rune:
+ *
+ *   - **No-body**: emits a single inline integer (the count). Replaces the
+ *     standalone `count` rune proposal.
+ *   - **Body-zoned**: source splits on top-level `hr` into preamble / template /
+ *     fallback. `$item` is bound differently per zone — preamble gets totals,
+ *     template gets the per-group projection, fallback gets zeros.
+ *
+ * The body is captured via `deferBody` and reparsed per group in the resolver
+ * (the same path collection's per-item template uses).
+ */
+export declare const aggregate: Markdoc.Schema;
+//# sourceMappingURL=aggregate.d.ts.map

package/dist/tags/aggregate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregate.d.ts","sourceRoot":"","sources":["../../src/tags/aggregate.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,kBAAkB,CAAC;AAKvC,eAAO,MAAM,kBAAkB,yBAAyB,CAAC;AAEzD;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,SAAS,gBAsCpB,CAAC"}

package/dist/tags/aggregate.js

@@ -0,0 +1,59 @@
+import Markdoc from '@markdoc/markdoc';
+const { Tag } = Markdoc;
+import { createContentModelSchema, createComponentRenderable } from '../lib/index.js';
+import { readDeferredBody } from '../deferred-body.js';
+export const AGGREGATE_SENTINEL = '__aggregate-sentinel';
+/**
+ * `aggregate` (SPEC-076) — the third post-process-resolved query rune, beside
+ * `collection` and `relationships`. Where they project entities and edges, this
+ * one projects **numbers** — counts over the same field-match query, optionally
+ * broken down by group. Two modes from the same rune:
+ *
+ *   - **No-body**: emits a single inline integer (the count). Replaces the
+ *     standalone `count` rune proposal.
+ *   - **Body-zoned**: source splits on top-level `hr` into preamble / template /
+ *     fallback. `$item` is bound differently per zone — preamble gets totals,
+ *     template gets the per-group projection, fallback gets zeros.
+ *
+ * The body is captured via `deferBody` and reparsed per group in the resolver
+ * (the same path collection's per-item template uses).
+ */
+export const aggregate = createContentModelSchema({
+    attributes: {
+        type: { type: String, required: false, default: '', description: 'Entity type(s), comma-separated.' },
+        filter: { type: String, required: false, default: '', description: 'field:value clauses defining the primary set being measured (SPEC-070 grammar).' },
+        value: { type: String, required: false, default: '', description: 'Optional secondary field:value clause defining the achieved subset within `filter` (e.g. value="status:done"). When set, $item.value is the count matching both; $item.percent is the ratio. Without it, the rune is a pure count + breakdown — no progress-bar semantics.' },
+        group: { type: String, required: false, default: '', description: 'Group-by field; omit to render the body once with totals.' },
+        sort: { type: String, required: false, default: '', description: 'Sort groups by `key`, `count`, `value`, or `percent` (prefix `-` for descending). Honors SPEC-072 domain-aware ordering when the group field has one.' },
+        limit: { type: String, required: false, default: '', description: 'Cap the number of groups (after sort).' },
+        empty: { type: String, required: false, default: '', description: 'Fallback text shown when the query matches no entities (self-closing form; body form uses a fallback zone). Absent → render nothing.' },
+    },
+    deferBody: true,
+    contentModel: { type: 'sequence', fields: [] },
+    transform(_resolved, attrs) {
+        const meta = (field, content) => new Tag('meta', { 'data-field': field, content });
+        const bodySource = readDeferredBody(attrs) ?? '';
+        const hasBody = bodySource.length > 0;
+        const metas = [
+            meta('aggregate-type', String(attrs.type ?? '')),
+            meta('aggregate-filter', String(attrs.filter ?? '')),
+            meta('aggregate-value', String(attrs.value ?? '')),
+            meta('aggregate-group', String(attrs.group ?? '')),
+            meta('aggregate-sort', String(attrs.sort ?? '')),
+            meta('aggregate-limit', String(attrs.limit ?? '')),
+            meta('aggregate-empty', String(attrs.empty ?? '')),
+            meta(AGGREGATE_SENTINEL, 'true'),
+        ];
+        if (bodySource)
+            metas.push(meta('aggregate-body', bodySource));
+        // Self-closing form must be inline-safe (no <section> mid-prose), so the
+        // outer tag is a span when there's no body. Body form is a <section>.
+        return createComponentRenderable({
+            rune: 'aggregate',
+            tag: hasBody ? 'section' : 'span',
+            properties: {},
+            children: metas,
+        });
+    },
+});
+//# sourceMappingURL=aggregate.js.map

package/dist/tags/aggregate.js.map

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

package/dist/tags/card.d.ts

@@ -0,0 +1,25 @@
+import Markdoc from '@markdoc/markdoc';
+/**
+ * `card` (SPEC-070) — a generic, self-contained content card.
+ *
+ * The body is divided by `---` (hr) into up to three zones:
+ *
+ *   [media] --- body [--- footer]
+ *
+ * - **media** (optional leading zone): any content — an image, a `{% codegroup %}`,
+ *   a `{% sandbox %}`, etc. Reuses the shared split layout (`SplitLayoutModel`):
+ *   side-by-side with the body on wide screens, a full-bleed header on mobile
+ *   (`data-media-position="top"`).
+ * - **body**: the main content.
+ * - **footer** (optional trailing zone): a muted meta row (date · tags · …).
+ *
+ * Zone roles are positional by count: 1 → body; 2 → media + body; 3 → media +
+ * body + footer. A leading empty zone (`--- body --- footer`) means "no media".
+ *
+ * `href` makes the whole card a link (a stretched link overlay, so real links
+ * inside body/footer stay clickable). The card carries no `$item`/registry
+ * knowledge — it's plain and composable, standalone or fed by a collection
+ * body template.
+ */
+export declare const card: Markdoc.Schema;
+//# sourceMappingURL=card.d.ts.map

package/dist/tags/card.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"card.d.ts","sourceRoot":"","sources":["../../src/tags/card.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,kBAAkB,CAAC;AAOvC;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,IAAI,gBAwHf,CAAC"}

package/dist/tags/card.js

@@ -0,0 +1,138 @@
+import Markdoc from '@markdoc/markdoc';
+const { Tag } = Markdoc;
+import { createContentModelSchema, createComponentRenderable, asNodes } from '../lib/index.js';
+import { RenderableNodeCursor } from '../lib/renderable.js';
+import { SplitLayoutModel, buildLayoutMetas, extractMediaImage } from './common.js';
+/**
+ * `card` (SPEC-070) — a generic, self-contained content card.
+ *
+ * The body is divided by `---` (hr) into up to three zones:
+ *
+ *   [media] --- body [--- footer]
+ *
+ * - **media** (optional leading zone): any content — an image, a `{% codegroup %}`,
+ *   a `{% sandbox %}`, etc. Reuses the shared split layout (`SplitLayoutModel`):
+ *   side-by-side with the body on wide screens, a full-bleed header on mobile
+ *   (`data-media-position="top"`).
+ * - **body**: the main content.
+ * - **footer** (optional trailing zone): a muted meta row (date · tags · …).
+ *
+ * Zone roles are positional by count: 1 → body; 2 → media + body; 3 → media +
+ * body + footer. A leading empty zone (`--- body --- footer`) means "no media".
+ *
+ * `href` makes the whole card a link (a stretched link overlay, so real links
+ * inside body/footer stay clickable). The card carries no `$item`/registry
+ * knowledge — it's plain and composable, standalone or fed by a collection
+ * body template.
+ */
+export const card = createContentModelSchema({
+    base: SplitLayoutModel,
+    attributes: {
+        href: { type: String, required: false, default: '', description: 'Optional link target; makes the whole card clickable.' },
+    },
+    contentModel: {
+        type: 'sequence',
+        fields: [{ name: 'body', match: 'any', optional: true, greedy: true }],
+    },
+    transform(resolved, attrs, config) {
+        // Split the body nodes on `hr` (`---`) into zones.
+        const nodes = asNodes(resolved.body);
+        const zones = [[]];
+        for (const n of nodes) {
+            if (n.type === 'hr')
+                zones.push([]);
+            else
+                zones[zones.length - 1].push(n);
+        }
+        let mediaNodes = [];
+        let bodyNodes = [];
+        let footerNodes = [];
+        if (zones.length === 1) {
+            bodyNodes = zones[0];
+        }
+        else if (zones.length === 2) {
+            mediaNodes = zones[0];
+            bodyNodes = zones[1];
+        }
+        else {
+            mediaNodes = zones[0];
+            footerNodes = zones[zones.length - 1];
+            bodyNodes = zones.slice(1, -1).flat();
+        }
+        const { metas: layoutMetas, children: layoutChildren } = buildLayoutMetas(attrs);
+        const children = [...layoutChildren];
+        // Media zone — unwrap a bare image; otherwise render arbitrary content.
+        if (mediaNodes.length > 0) {
+            const mediaCursor = new RenderableNodeCursor(Markdoc.transform(mediaNodes, config));
+            const img = extractMediaImage(mediaCursor);
+            const inner = img ? [img] : mediaCursor.toArray();
+            children.push(new Tag('div', { 'data-section': 'media', 'data-name': 'media' }, inner));
+        }
+        // Eyebrow: a leading paragraph immediately followed by a heading becomes a
+        // kicker (the page-section / recipe pattern). The rest stays freeform body.
+        let eyebrowNode;
+        let mainBodyNodes = bodyNodes;
+        if (bodyNodes.length >= 2 &&
+            bodyNodes[0].type === 'paragraph' &&
+            bodyNodes[1].type === 'heading') {
+            eyebrowNode = bodyNodes[0];
+            mainBodyNodes = bodyNodes.slice(1);
+        }
+        // Content zone (body + optional footer) — one grid child so the split
+        // layout puts media | content; footer sits at the bottom of content.
+        const bodyInner = [];
+        let eyebrowTag;
+        if (eyebrowNode) {
+            const eyebrowCursor = new RenderableNodeCursor(Markdoc.transform([eyebrowNode], config));
+            const first = eyebrowCursor.toArray()[0];
+            if (Markdoc.Tag.isTag(first)) {
+                eyebrowTag = first;
+                bodyInner.push(eyebrowTag);
+            }
+        }
+        const bodyCursor = new RenderableNodeCursor(Markdoc.transform(mainBodyNodes, config));
+        const bodyRendered = bodyCursor.toArray();
+        // The body's leading heading is the card title — give it a hook so it can
+        // sit tight under an eyebrow instead of carrying default prose top margin.
+        let titleTag;
+        const firstBody = bodyRendered[0];
+        if (Markdoc.Tag.isTag(firstBody) && /^h[1-6]$/.test(firstBody.name)) {
+            titleTag = firstBody;
+        }
+        bodyInner.push(...bodyRendered);
+        const bodyDiv = new Tag('div', { 'data-name': 'body' }, bodyInner);
+        const contentChildren = [bodyDiv];
+        let footerTag;
+        if (footerNodes.length > 0) {
+            const footerCursor = new RenderableNodeCursor(Markdoc.transform(footerNodes, config));
+            footerTag = new Tag('footer', { 'data-name': 'footer' }, footerCursor.toArray());
+            contentChildren.push(footerTag);
+        }
+        const contentDiv = new Tag('div', { 'data-name': 'content' }, contentChildren);
+        children.push(contentDiv);
+        // Whole-card link as a stretched overlay (keeps nested links valid).
+        let linkTag;
+        const href = String(attrs.href ?? '');
+        if (href) {
+            linkTag = new Tag('a', { 'data-name': 'link', href, 'aria-hidden': 'true', tabindex: '-1' }, []);
+            children.push(linkTag);
+        }
+        const refs = { content: contentDiv, body: bodyDiv };
+        if (titleTag)
+            refs.title = titleTag;
+        if (eyebrowTag)
+            refs.eyebrow = eyebrowTag;
+        if (footerTag)
+            refs.footer = footerTag;
+        if (linkTag)
+            refs.link = linkTag;
+        return createComponentRenderable({
+            rune: 'card',
+            tag: 'div',
+            properties: { layout: layoutMetas.layout },
+            refs,
+            children,
+        });
+    },
+});
+//# sourceMappingURL=card.js.map

package/dist/tags/card.js.map

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

package/dist/tags/collection.d.ts

@@ -0,0 +1,10 @@
+import Markdoc from '@markdoc/markdoc';
+export declare const COLLECTION_SENTINEL = "__collection-sentinel";
+/**
+ * `collection` (SPEC-070) — queries the entity registry for many entities and
+ * projects them into a layout. Emits a sentinel that the postProcess resolver
+ * (`resolveCollections`) fills with real entity data. The body, when present,
+ * is a per-entity template captured via the deferBody mechanism (WORK-262).
+ */
+export declare const collection: Markdoc.Schema;
+//# sourceMappingURL=collection.d.ts.map

package/dist/tags/collection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collection.d.ts","sourceRoot":"","sources":["../../src/tags/collection.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,kBAAkB,CAAC;AAKvC,eAAO,MAAM,mBAAmB,0BAA0B,CAAC;AAE3D;;;;;GAKG;AACH,eAAO,MAAM,UAAU,gBA2CrB,CAAC"}

package/dist/tags/collection.js

@@ -0,0 +1,54 @@
+import Markdoc from '@markdoc/markdoc';
+const { Tag } = Markdoc;
+import { createContentModelSchema, createComponentRenderable } from '../lib/index.js';
+import { readDeferredBody } from '../deferred-body.js';
+export const COLLECTION_SENTINEL = '__collection-sentinel';
+/**
+ * `collection` (SPEC-070) — queries the entity registry for many entities and
+ * projects them into a layout. Emits a sentinel that the postProcess resolver
+ * (`resolveCollections`) fills with real entity data. The body, when present,
+ * is a per-entity template captured via the deferBody mechanism (WORK-262).
+ */
+export const collection = createContentModelSchema({
+    attributes: {
+        type: { type: String, required: false, default: '', description: 'Entity type(s), comma-separated.' },
+        filter: { type: String, required: false, default: '', description: 'field:value clauses (SPEC-070 grammar).' },
+        sort: { type: String, required: false, default: '', description: 'Sort field (prefix - for descending).' },
+        group: { type: String, required: false, default: '', description: 'Group-by field.' },
+        limit: { type: String, required: false, default: '', description: 'Max items.' },
+        show: { type: String, required: false, default: '', description: 'Alias for type (entity types to include).' },
+        fields: { type: String, required: false, default: '', description: 'Comma-separated data fields to project.' },
+        layout: { type: String, required: false, default: 'list', description: 'Arrangement: list (stacked) | grid (multi-column) | table (aligned columns). Item chrome comes from the item — the no-body built-in, or a rune like {% card %} in the body template.' },
+        'group-display': { type: String, required: false, default: 'headings', matches: ['headings', 'accordion'], description: 'How groups are presented when `group` is set: headings (default) or accordion (collapsible native <details> panels, styled like the accordion rune, with a per-group count).' },
+        empty: { type: String, required: false, default: '', description: 'Fallback text shown when the query yields nothing (no-body form; body-template form uses a fallback zone). Absent → render nothing.' },
+    },
+    deferBody: true,
+    contentModel: { type: 'sequence', fields: [] },
+    transform(_resolved, attrs) {
+        const meta = (field, content) => new Tag('meta', { 'data-field': field, content });
+        const bodySource = readDeferredBody(attrs) ?? '';
+        const metas = [
+            meta('collection-type', String(attrs.type ?? attrs.show ?? '')),
+            meta('collection-filter', String(attrs.filter ?? '')),
+            meta('collection-sort', String(attrs.sort ?? '')),
+            meta('collection-group', String(attrs.group ?? '')),
+            meta('collection-limit', String(attrs.limit ?? '')),
+            meta('collection-fields', String(attrs.fields ?? '')),
+            meta('collection-layout', String(attrs.layout ?? 'list')),
+            meta('collection-group-display', String(attrs['group-display'] ?? 'headings')),
+            meta('collection-empty', String(attrs.empty ?? '')),
+            meta(COLLECTION_SENTINEL, 'true'),
+        ];
+        if (bodySource)
+            metas.push(meta('collection-body', bodySource));
+        const placeholder = new Tag('div', { 'data-name': 'items' }, []);
+        return createComponentRenderable({
+            rune: 'collection',
+            tag: 'section',
+            properties: {},
+            refs: { items: placeholder },
+            children: [...metas, placeholder],
+        });
+    },
+});
+//# sourceMappingURL=collection.js.map

package/dist/tags/collection.js.map

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

package/dist/tags/conversation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"conversation.d.ts","sourceRoot":"","sources":["../../src/tags/conversation.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,kBAAkB,CAAC;AAMvC,eAAO,MAAM,mBAAmB,gBA8B9B,CAAC;AAkDH,eAAO,MAAM,YAAY,gBA2BvB,CAAC"}
+{"version":3,"file":"conversation.d.ts","sourceRoot":"","sources":["../../src/tags/conversation.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,kBAAkB,CAAC;AAMvC,eAAO,MAAM,mBAAmB,gBA8B9B,CAAC;AAwEH,eAAO,MAAM,YAAY,gBA2BvB,CAAC"}