@refrakt-md/runes 0.38.0 → 0.39.0

package/dist/tags/snippet.js

@@ -1,20 +1,222 @@
+import Markdoc from '@markdoc/markdoc';
 import { createContentModelSchema } from '../lib/index.js';
+import { formatHighlight, highlightMatchLines, parseHighlightMatch, reindent, shouldReindent, } from '../lib/present.js';
+import { readSnippetFile, SnippetSandboxError } from '../lib/read-file.js';
+import { compareMarker, parseMarker } from '../lib/review-marker.js';
+import { inferLanguage } from '../lang-map.js';
+const { Ast } = 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 '';
+}
+/** 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 `source` so tooling can still detect snippet
+ *  provenance, plus a `data-snippet-error` raw data-attr that's
+ *  forwarded through the fence transform for the error styling hook. */
+function makeErrorFence(pathAttr, message) {
+    return new Ast.Node('fence', {
+        content: `snippet error: ${message}\n`,
+        language: 'text',
+        source: pathAttr || '(unresolved)',
+        'data-snippet-error': message,
+    });
+}
+function resolveSnippetToFence(tag, page, ctx, files) {
+    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;
+    // WORK-304 — propagate author-set fence-level annotations from the
+    // snippet rune through to the fence node. The fence schema renders
+    // them as `data-linenumbers` / `data-highlight-lines`. `linenumbers`
+    // arrives as a Boolean from the rune schema; `highlight` as a String.
+    const linenumbers = tag.attributes.linenumbers === true;
+    const highlight = tag.attributes.highlight !== undefined
+        ? resolveAttributeValue(tag.attributes.highlight, ctx.variables)
+        : undefined;
+    // SPEC-131 — anchor attributes. Resolution lands in the shared reader, so
+    // `file-ref` gains the same capability from the same change.
+    const str = (name) => tag.attributes[name] !== undefined
+        ? resolveAttributeValue(tag.attributes[name], ctx.variables)
+        : undefined;
+    const anchor = {
+        symbol: str('symbol'),
+        match: str('match'),
+        occurrence: tag.attributes.occurrence !== undefined ? Number(tag.attributes.occurrence) : undefined,
+        extent: str('extent'),
+        until: str('until'),
+        through: str('through'),
+        doc: tag.attributes.doc === undefined ? undefined : tag.attributes.doc === true,
+    };
+    const reindentAttr = tag.attributes.reindent === undefined ? undefined : tag.attributes.reindent === true;
+    const highlightMatch = str('highlight-match');
+    const reviewedAttr = str('reviewed');
+    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({
+            files,
+            pathAttr,
+            lines: lines || undefined,
+            anchor,
+            lang: langAttr || 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);
+    }
+    // SPEC-134 — the review marker. Evaluated only after the anchor resolved,
+    // because D9 layers the two features: SPEC-131 answers *can I find the
+    // region* and refuses if not, so a refusal never reaches here at all.
+    //
+    // A finding is a `PipelineWarning` beside the page and **nothing is
+    // rendered into it** (D6). This is deliberately different from SPEC-131's
+    // error fence, and the difference is principled: there, the content could
+    // not be produced, so the fence takes its place. Here the content was
+    // produced perfectly — real, current, correctly located. What is uncertain
+    // is the prose beside it, which the resolver cannot see. Replacing a
+    // correct code block with an error because a paragraph *might* be stale is
+    // a straightforward regression for every reader.
+    if (reviewedAttr && reviewedAttr.length > 0) {
+        const stored = parseMarker(reviewedAttr);
+        const comparison = compareMarker(stored.strict, result.content, stored.loose);
+        if (comparison.verdict === 'stale') {
+            // Deliberately no diff here: at transform time the only record of
+            // the reviewed version is its hash, and a hash cannot be turned
+            // back into content. `refrakt snippet review --update` recovers the
+            // old slice from git and shows the diff — which is why D5's "show
+            // content, never hashes" is the CLI's job rather than this one's.
+            ctx.warn(`snippet \`${pathAttr}\` has changed since it was last reviewed. Re-read the prose ` +
+                'around it, then run `refrakt snippet review --update` to see the diff and re-stamp.', page.url);
+        }
+    }
+    const language = langAttr && langAttr.length > 0 ? langAttr : inferLanguage(result.relativePath);
+    // WORK-589 — presentation runs strictly **after** the resolved range is
+    // fixed, so `reindent` can never shift the coordinates `linenumbers` and a
+    // numeric `highlight` read (D13). `highlight-match` is computed against the
+    // pre-reindent text because reindent changes columns, not lines.
+    const highlightMatchLinesFound = highlightMatch
+        ? highlightMatchLines(result.content, parseHighlightMatch(highlightMatch))
+        : [];
+    const content = shouldReindent(result.anchored, reindentAttr)
+        ? reindent(result.content)
+        : result.content;
+    // WORK-304 — write unprefixed `source` / `lines` directly. The fence
+    // schema renders them as `data-source` / `data-lines`. `linenumbers` /
+    // `highlight` are propagated from the rune attributes (file-coordinate
+    // semantics — see WORK-304 acceptance criteria).
+    const fenceAttrs = {
+        content,
+        language,
+        source: result.relativePath,
+    };
+    // The coordinate frame survives anchoring (D13): an anchored slice reports
+    // the range it actually resolved to, so `linenumbers` still starts at the
+    // real file line and the displayed numbers stay a pointer back into it.
+    if (lines)
+        fenceAttrs.lines = lines;
+    else if (result.anchored && result.start !== undefined && result.end !== undefined) {
+        fenceAttrs.lines = `${result.start}-${result.end}`;
+    }
+    if (linenumbers)
+        fenceAttrs.linenumbers = true;
+    if (highlightMatchLinesFound.length > 0) {
+        // Slice offsets converted into the file frame the fence expects.
+        const base = result.start ?? 1;
+        fenceAttrs.highlight = formatHighlight(highlightMatchLinesFound.map((n) => n + base - 1));
+    }
+    else if (highlight && highlight.length > 0) {
+        fenceAttrs.highlight = highlight;
+    }
+    // Construct a fence Ast.Node. Markdoc parses ``` blocks as
+    // new Ast.Node('fence', { content, language }) — same shape here.
+    return new Ast.Node('fence', fenceAttrs);
+}
+/**
+ * Preprocess (SPEC-062, WORK-304): resolve + slice the source file and replace
+ * the tag with a Markdoc `fence` node. The fence carries `content` + `language`
+ * (so the code-block transform syntax-highlights it identically to a
+ * triple-backtick fence) plus `source` / `lines` and the author-set
+ * `linenumbers` / `highlight` annotations, which the fence schema renders as
+ * `data-source` / `data-lines` / `data-linenumbers` / `data-highlight-lines` on
+ * the output `<pre>` + `<code>`.
+ *
+ * That is the whole rune: there is no postProcess step (SPEC-141 D5). A
+ * standalone snippet renders as the `<pre data-source>` the fence produces —
+ * `pre[data-source]` is the selector for snippet-derived code — and container
+ * runes (`codegroup`, `diff`) see it as a regular fence and consume it
+ * transparently. Captions / titles are intentionally not provided — wrap a
+ * snippet in `{% codegroup title="..." %}` if you want a labelled chrome.
+ *
+ * Always produces a fence: sandbox / missing-file / variable-resolution errors
+ * produce an error fence, so the tag never reaches the throwing `transform`.
+ * The build keeps going and the failure is visible on the rendered page.
+ *
+ * No-op without a file provider (e.g. a tree-mode build that hasn't wired one
+ * yet) — the tag then falls through to the transform, which names the wiring.
+ */
+function preprocessSnippet(tag, page, ctx) {
+    if (!ctx.sandbox)
+        return;
+    return resolveSnippetToFence(tag, page, ctx, ctx.sandbox);
+}
 /**
  * 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**.
+ * Snippet is an **AST preprocessor** rather than a transform-time rune: its
+ * `preprocess` hook (above) replaces every `{% snippet %}` tag with a Markdoc
+ * `fence` node before the schema-driven transform runs (SPEC-141). 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.
+ * read from it. If the transform ever does execute, it throws a clear error
+ * naming the likely cause (SPEC-141 D7).
  */
 export const snippet = createContentModelSchema({
     attributes: {
@@ -96,8 +298,9 @@ export const snippet = createContentModelSchema({
         },
     },
     contentModel: { type: 'sequence', fields: [] },
+    preprocess: preprocessSnippet,
     transform(_resolved, _attrs) {
-        // Unreachable in normal operation — corePipelineHooks.preprocess
+        // Unreachable in normal operation — the `preprocess` hook above
         // replaces snippet tags with fence nodes before the transform runs.
         //
         // The reachable case is a content author's, not a framework author's:

package/dist/tags/snippet.js.map

@@ -1 +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,EACV,yFAAyF;SAC1F;QACD,KAAK,EAAE;YACN,IAAI,EAAE,MAAM;YACZ,QAAQ,EAAE,KAAK;YACf,WAAW,EACV,sQAAsQ;SACvQ;QACD,MAAM,EAAE;YACP,IAAI,EAAE,MAAM;YACZ,QAAQ,EAAE,KAAK;YACf,WAAW,EACV,oSAAoS;SACrS;QACD,KAAK,EAAE;YACN,IAAI,EAAE,MAAM;YACZ,QAAQ,EAAE,KAAK;YACf,WAAW,EACV,mMAAmM;SACpM;QACD,UAAU,EAAE;YACX,IAAI,EAAE,MAAM;YACZ,QAAQ,EAAE,KAAK;YACf,WAAW,EACV,sSAAsS;SACvS;QACD,MAAM,EAAE;YACP,IAAI,EAAE,MAAM;YACZ,QAAQ,EAAE,KAAK;YACf,OAAO,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC;YAChD,WAAW,EACV,4UAA4U;SAC7U;QACD,KAAK,EAAE;YACN,IAAI,EAAE,MAAM;YACZ,QAAQ,EAAE,KAAK;YACf,WAAW,EACV,mJAAmJ;SACpJ;QACD,OAAO,EAAE;YACR,IAAI,EAAE,MAAM;YACZ,QAAQ,EAAE,KAAK;YACf,WAAW,EACV,yOAAyO;SAC1O;QACD,GAAG,EAAE;YACJ,IAAI,EAAE,OAAO;YACb,QAAQ,EAAE,KAAK;YACf,WAAW,EACV,iOAAiO;SAClO;QACD,QAAQ,EAAE;YACT,IAAI,EAAE,OAAO;YACb,QAAQ,EAAE,KAAK;YACf,WAAW,EACV,2SAA2S;SAC5S;QACD,QAAQ,EAAE;YACT,IAAI,EAAE,MAAM;YACZ,QAAQ,EAAE,KAAK;YACf,WAAW,EACV,mUAAmU;SACpU;QACD,iBAAiB,EAAE;YAClB,IAAI,EAAE,MAAM;YACZ,QAAQ,EAAE,KAAK;YACf,WAAW,EACV,iNAAiN;SAClN;QACD,IAAI,EAAE;YACL,IAAI,EAAE,MAAM;YACZ,QAAQ,EAAE,KAAK;YACf,WAAW,EAAE,6EAA6E;SAC1F;QACD,WAAW,EAAE;YACZ,IAAI,EAAE,OAAO;YACb,QAAQ,EAAE,KAAK;YACf,WAAW,EACV,wLAAwL;SACzL;QACD,SAAS,EAAE;YACV,IAAI,EAAE,MAAM;YACZ,QAAQ,EAAE,KAAK;YACf,WAAW,EACV,4ZAA4Z;SAC7Z;KACD;IACD,YAAY,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE;IAC9C,SAAS,CAAC,SAAS,EAAE,MAAM;QAC1B,iEAAiE;QACjE,oEAAoE;QACpE,EAAE;QACF,sEAAsE;QACtE,wEAAwE;QACxE,0EAA0E;QAC1E,MAAM,IAAI,KAAK,CACd,2DAA2D;YAC1D,2EAA2E;YAC3E,+EAA+E;YAC/E,iFAAiF;YACjF,kFAAkF;YAClF,gFAAgF;YAChF,oDAAoD;YACpD,gFAAgF;YAChF,8EAA8E;YAC9E,8BAA8B,CAC/B,CAAC;IACH,CAAC;CACD,CAAC,CAAC"}
+{"version":3,"file":"snippet.js","sourceRoot":"","sources":["../../src/tags/snippet.ts"],"names":[],"mappings":"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"}

package/dist/universal-attributes.d.ts

@@ -61,7 +61,7 @@ export type UniversalAttributePosture = 'auto' | 'inline' | 'configurator' | 'no
 /** The prose behind a non-`auto` posture, for tooling that explains itself.
  *  Re-exported from the transform registry rather than restated, so the schema
  *  layer and the structure contract give the same reason. */
-export declare const POSTURE_REASONS: Readonly<Record<"inline" | "configurator" | "none", string>>;
+export declare const POSTURE_REASONS: Readonly<Record<"inline" | "none" | "configurator", string>>;
 export interface UniversalAttributeInput {
     /** Defaults to `auto`. */
     posture?: UniversalAttributePosture;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@refrakt-md/runes",
   "description": "Semantic Markdoc runes for refrakt.md",
-  "version": "0.38.0",
+  "version": "0.39.0",
   "type": "module",
   "license": "MIT",
   "repository": {
@@ -32,8 +32,8 @@
     "generate-translations": "node scripts/generate-translations.mjs"
   },
   "dependencies": {
-    "@refrakt-md/types": "0.38.0",
-    "@refrakt-md/transform": "0.38.0",
+    "@refrakt-md/types": "0.39.0",
+    "@refrakt-md/transform": "0.39.0",
     "@markdoc/markdoc": "0.4.0",
     "reflect-metadata": "^0.2.0",
     "fast-xml-parser": "4.5.1",

package/dist/include-pipeline.d.ts

@@ -1,52 +0,0 @@
-/**
- * Include pipeline hook (SPEC-129).
- *
- * The first preprocess step: walk the parsed AST and replace every
- * `{% include %}` tag with the referenced partial's AST, cloned and with the
- * tag's `variables` substituted. It runs **before** `preprocessSnippets` and
- * `preprocessData` so a `data` or `snippet` inside the pasted file is in the
- * tree when those hooks walk it — the case `{% partial %}` cannot serve,
- * because Markdoc expands partials during the transform.
- *
- * Three properties are load-bearing:
- *
- * - **Splice, never wrap.** One include produces N nodes and they land as
- *   direct siblings. A container to keep the replacement 1:1 breaks
- *   composition invisibly: measured in SPEC-127, `{% section %}` and
- *   `{% grid %}` consume their children, so wrapped content vanishes with no
- *   error. Same constraint, same reason, as the `data` per-row body.
- *
- * - **Always clone.** The partial ASTs are parsed once per build and shared by
- *   every page that references them. The later preprocessors mutate the tree in
- *   place, so pasting the shared nodes would let one page's `data` resolution
- *   leak into the next page's copy.
- *
- * - **Substitute, don't scope.** `partial` binds variables into a
- *   transform-time scope, which is precisely what a preprocessor attribute
- *   cannot read. `include` rewrites `Variable` nodes in the cloned AST at paste
- *   time — the same thing `bindRow` does for `$row` — so a binding reaches
- *   `{% data where=$q %}`. Variables the include does not bind are left alone
- *   and resolve at transform against the page's own variables.
- *
- * Failures render a visible error callout and record a build error rather than
- * throwing, matching `data`: one bad include does not take out the build, and
- * the failure is on the page where the author will see it.
- */
-import type { Node } from '@markdoc/markdoc';
-import type { PreprocessContext, PreprocessPage } from '@refrakt-md/types';
-/**
- * How deep includes may nest.
- *
- * A cycle is caught by name before this ever fires — the stack check below is
- * the real guard. This bounds the other shape: a chain of distinct files deep
- * enough that it is a mistake rather than a structure anyone meant to author.
- */
-export declare const MAX_INCLUDE_DEPTH = 16;
-/**
- * Preprocess: splice every `{% include %}` tag away. No-op when no partials are
- * available (a tree-mode build with none wired), matching how snippet and data
- * no-op without a sandbox — the tag then falls through to its schema transform,
- * which names the wiring.
- */
-export declare function preprocessIncludes(ast: Node, page: PreprocessPage, ctx: PreprocessContext): Node | void;
-//# sourceMappingURL=include-pipeline.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"include-pipeline.d.ts","sourceRoot":"","sources":["../src/include-pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAK3E;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAEpC;;;;;GAKG;AACH,wBAAgB,kBAAkB,CACjC,GAAG,EAAE,IAAI,EACT,IAAI,EAAE,cAAc,EACpB,GAAG,EAAE,iBAAiB,GACpB,IAAI,GAAG,IAAI,CAeb"}

package/dist/include-pipeline.js

@@ -1,206 +0,0 @@
-/**
- * Include pipeline hook (SPEC-129).
- *
- * The first preprocess step: walk the parsed AST and replace every
- * `{% include %}` tag with the referenced partial's AST, cloned and with the
- * tag's `variables` substituted. It runs **before** `preprocessSnippets` and
- * `preprocessData` so a `data` or `snippet` inside the pasted file is in the
- * tree when those hooks walk it — the case `{% partial %}` cannot serve,
- * because Markdoc expands partials during the transform.
- *
- * Three properties are load-bearing:
- *
- * - **Splice, never wrap.** One include produces N nodes and they land as
- *   direct siblings. A container to keep the replacement 1:1 breaks
- *   composition invisibly: measured in SPEC-127, `{% section %}` and
- *   `{% grid %}` consume their children, so wrapped content vanishes with no
- *   error. Same constraint, same reason, as the `data` per-row body.
- *
- * - **Always clone.** The partial ASTs are parsed once per build and shared by
- *   every page that references them. The later preprocessors mutate the tree in
- *   place, so pasting the shared nodes would let one page's `data` resolution
- *   leak into the next page's copy.
- *
- * - **Substitute, don't scope.** `partial` binds variables into a
- *   transform-time scope, which is precisely what a preprocessor attribute
- *   cannot read. `include` rewrites `Variable` nodes in the cloned AST at paste
- *   time — the same thing `bindRow` does for `$row` — so a binding reaches
- *   `{% data where=$q %}`. Variables the include does not bind are left alone
- *   and resolve at transform against the page's own variables.
- *
- * Failures render a visible error callout and record a build error rather than
- * throwing, matching `data`: one bad include does not take out the build, and
- * the failure is on the page where the author will see it.
- */
-import Markdoc from '@markdoc/markdoc';
-import { emitErrorNode } from './data-emit.js';
-const { Ast } = Markdoc;
-/**
- * How deep includes may nest.
- *
- * A cycle is caught by name before this ever fires — the stack check below is
- * the real guard. This bounds the other shape: a chain of distinct files deep
- * enough that it is a mistake rather than a structure anyone meant to author.
- */
-export const MAX_INCLUDE_DEPTH = 16;
-/**
- * Preprocess: splice every `{% include %}` tag away. No-op when no partials are
- * available (a tree-mode build with none wired), matching how snippet and data
- * no-op without a sandbox — the tag then falls through to its schema transform,
- * which names the wiring.
- */
-export function preprocessIncludes(ast, page, ctx) {
-    const partials = ctx.partials;
-    if (!partials)
-        return;
-    let mutated = false;
-    walkAndReplaceIncludes(ast, page, ctx, partials, () => {
-        mutated = true;
-    }, []);
-    return mutated ? ast : undefined;
-}
-function walkAndReplaceIncludes(node, page, ctx, partials, onReplaced, stack) {
-    if (!node.children)
-        return;
-    for (let i = 0; i < node.children.length; i++) {
-        const child = node.children[i];
-        if (child.type === 'tag' && child.tag === 'include') {
-            const replacement = resolveInclude(child, page, ctx, partials, stack);
-            node.children.splice(i, 1, ...replacement);
-            // Skip the pasted nodes: nested includes inside them were already
-            // expanded by `resolveInclude`, under the cycle stack that names the
-            // chain. Re-walking here would expand them a second time with an empty
-            // stack, which is exactly how a cycle becomes an infinite paste.
-            i += replacement.length - 1;
-            onReplaced();
-            continue;
-        }
-        walkAndReplaceIncludes(child, page, ctx, partials, onReplaced, stack);
-    }
-}
-function fail(ctx, page, message) {
-    ctx.error(`include: ${message}`, page.url);
-    return [emitErrorNode(`include error: ${message}`)];
-}
-function resolveInclude(tag, page, ctx, partials, stack) {
-    const file = resolveValue(tag.attributes?.file, ctx.variables);
-    if (typeof file !== 'string' || file.length === 0) {
-        return fail(ctx, page, 'the `file` attribute is required (an unresolvable variable reference resolves to empty)');
-    }
-    if (stack.includes(file)) {
-        return fail(ctx, page, `cycle — ${[...stack, file].join(' → ')}`);
-    }
-    if (stack.length >= MAX_INCLUDE_DEPTH) {
-        return fail(ctx, page, `nested more than ${MAX_INCLUDE_DEPTH} deep — ${[...stack, file].join(' → ')}`);
-    }
-    const source = partials[file];
-    if (!source || typeof source !== 'object') {
-        const known = Object.keys(partials).sort();
-        const available = known.length > 0
-            ? ` Available: ${known.join(', ')}.`
-            : ' No partials are registered for this site.';
-        return fail(ctx, page, `"${file}" was not found in \`_partials/\` or any registered file root.${available}`);
-    }
-    const bindings = resolveVariables(tag.attributes?.variables, ctx.variables);
-    const pasted = source.children ?? [];
-    const children = pasted.map((child) => cloneWithBindings(child, bindings));
-    // Expand nested includes inside what was just pasted, under a stack carrying
-    // this file — so a cycle is reported by name instead of overflowing.
-    if (children.length > 0) {
-        const container = new Ast.Node('document', {}, children);
-        walkAndReplaceIncludes(container, page, ctx, partials, () => { }, [...stack, file]);
-        return container.children;
-    }
-    return children;
-}
-/**
- * Clone a node, substituting bound variables.
- *
- * `$q` reaches the AST as a `Variable` in a node's *attributes* — on a tag
- * (`where=$q`) and equally on a `text` node, where `{% $q %}` becomes
- * `content: Variable(['q'])`. One rule covers both, exactly as `bindRow` does.
- */
-function cloneWithBindings(node, bindings) {
-    const attributes = {};
-    for (const [key, value] of Object.entries(node.attributes ?? {})) {
-        attributes[key] = substitute(value, bindings);
-    }
-    const children = (node.children ?? []).map((child) => cloneWithBindings(child, bindings));
-    const copy = new Ast.Node(node.type, attributes, children, node.tag);
-    // The constructor takes four fields; everything else Markdoc's parser sets
-    // has to be carried across by hand. `inline` decides whether a node renders
-    // inline, and `annotations` carries `{% .class #id %}` shorthand — dropping
-    // either changes the output silently.
-    if (node.lines)
-        copy.lines = node.lines;
-    if (node.location)
-        copy.location = node.location;
-    copy.inline = node.inline;
-    if (node.annotations?.length)
-        copy.annotations = node.annotations;
-    if (node.slots && Object.keys(node.slots).length > 0) {
-        copy.slots = Object.fromEntries(Object.entries(node.slots).map(([k, v]) => [k, cloneWithBindings(v, bindings)]));
-    }
-    return copy;
-}
-/**
- * Replace a `Variable` node whose root segment the include binds.
- *
- * Unbound variables pass through untouched rather than resolving to empty: the
- * pasted AST is page content now, so `$page.slug` and friends still resolve at
- * transform against the page's own variables. That is a capability `partial`
- * does not have — its scope *replaces* the variable surface.
- */
-function substitute(value, bindings) {
-    if (!value || typeof value !== 'object')
-        return value;
-    const node = value;
-    if (node.$$mdtype === 'Variable' && Array.isArray(node.path) && node.path.length > 0) {
-        const [root, ...rest] = node.path;
-        if (!(root in bindings))
-            return value;
-        let current = bindings[root];
-        for (const segment of rest) {
-            if (current === null || current === undefined)
-                return '';
-            current = current[segment];
-        }
-        return current === null || current === undefined ? '' : current;
-    }
-    return value;
-}
-/** The include's own `variables={...}`, with any page-variable references in
- *  its values resolved before they are substituted into the pasted AST. */
-function resolveVariables(raw, pageVariables) {
-    if (!raw || typeof raw !== 'object' || Array.isArray(raw))
-        return {};
-    const out = {};
-    for (const [key, value] of Object.entries(raw)) {
-        out[key] = resolveValue(value, pageVariables);
-    }
-    return out;
-}
-/** Resolve an attribute value against the page's variables — literals pass
- *  through, `Variable` nodes are looked up. Mirrors snippet's and data's
- *  resolvers; anything else (a `Function` node) resolves to empty — the same
- *  silent-empty behaviour BUG-010 tracks for `data`'s `where`. */
-function resolveValue(value, variables) {
-    if (value === undefined || value === null)
-        return '';
-    if (typeof value !== 'object')
-        return 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 ? '' : current;
-    }
-    if (node.$$mdtype === undefined)
-        return value;
-    return '';
-}
-//# sourceMappingURL=include-pipeline.js.map

package/dist/include-pipeline.js.map

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

package/dist/snippet-pipeline.d.ts

@@ -1,44 +0,0 @@
-/**
- * Snippet pipeline hooks (SPEC-062, WORK-304).
- *
- * - **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` + `language` (so
- *   the existing code-block transform syntax-highlights it identically to
- *   a triple-backtick fence) plus `source` / `lines` + author-set
- *   `linenumbers` / `highlight` annotations (WORK-304). The fence schema
- *   renders them as `data-source` / `data-lines` / `data-linenumbers` /
- *   `data-highlight-lines` on the output `<pre>` + `<code>`.
- *
- * - **PostProcess** walks the rendered renderable tree, finds every `<pre>`
- *   element carrying `data-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

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