@refrakt-md/cli 0.21.0 → 0.23.0

package/dist/lib/fixtures.js

@@ -1,135 +1,36 @@
 /**
- * Built-in Markdoc fixture strings for the inspect command.
+ * Fixture resolution for the inspect/gallery commands.
  *
- * Each fixture exercises the rune's full structure with realistic content.
- * The key is the primary rune tag name (as used in Markdoc).
+ * The example content itself is the unified, generated `RUNE_EXAMPLES` manifest
+ * from `@refrakt-md/runes` (source: `packages/runes/fixtures/*.md` — SPEC-102 /
+ * WORK-411). Plugin fixtures layer on top at the call site; this module just
+ * resolves a rune name to a source string and applies attribute overrides.
  */
-export const fixtures = {
-    hint: `{% hint type="note" %}
-The identity transform runs after the rune schema transform and before rendering. It applies BEM classes, injects structural elements, and resolves design tokens.
-{% /hint %}`,
-    accordion: `{% accordion %}
-## Getting Started
-Follow these steps to set up your development environment and build your first theme.
-
-## Configuration
-Theme configuration is defined in a TypeScript file that exports a ThemeConfig object.
-
-## Deployment
-Once your theme is ready, publish it to npm and register it in the theme marketplace.
-{% /accordion %}`,
-    details: `{% details %}
-## Implementation Notes
-This section contains additional technical details about how the transform pipeline processes rune content. The identity transform reads meta tags, applies BEM classes, and injects structural elements before the content reaches the renderer.
-{% /details %}`,
-    grid: `{% grid %}
-First column content with enough text to demonstrate layout behavior.
-
----
-
-Second column content showing how grid cells are separated by horizontal rules.
-
----
-
-Third column content completing the three-column grid layout example.
-{% /grid %}`,
-    figure: `{% figure size="large" align="center" %}
-![Mountain landscape](/images/mountain.jpg)
-
-A panoramic view of the Norwegian fjords at sunset, captured from the summit of Trolltunga.
-{% /figure %}`,
-    tabs: `{% tabs %}
-# JavaScript
-\`\`\`js
-const greeting = "Hello, world!";
-console.log(greeting);
-\`\`\`
-
-# TypeScript
-\`\`\`ts
-const greeting: string = "Hello, world!";
-console.log(greeting);
-\`\`\`
-
-# Python
-\`\`\`python
-greeting = "Hello, world!"
-print(greeting)
-\`\`\`
-{% /tabs %}`,
-    conversation: `{% conversation %}
-> **Alice** — Have you tried the new inspect command?
-
-> **Bob** — Yes! It shows exactly what HTML the identity transform produces. No more guessing which selectors to target.
-
-> **Alice** — The variant expansion is my favorite part. You can see every modifier value at once.
-{% /conversation %}`,
-    sidenote: `{% sidenote variant="sidenote" %}
-This is a margin note that appears alongside the main content, providing additional context without interrupting the reading flow.
-{% /sidenote %}`,
-    diff: `{% diff mode="unified" %}
-\`\`\`ts
-const config = {
-  prefix: 'rf',
-  runes: {}
-};
-\`\`\`
-
-\`\`\`ts
-const config = {
-  prefix: 'rf',
-  tokenPrefix: '--rf',
-  icons: {},
-  runes: {}
-};
-\`\`\`
-{% /diff %}`,
-    datatable: `{% datatable %}
-| Name | Role | Department | Status |
-|------|------|------------|--------|
-| Alice | Engineer | Platform | Active |
-| Bob | Designer | Product | Active |
-| Carol | Manager | Engineering | On Leave |
-{% /datatable %}`,
-    form: `{% form method="POST" variant="stacked" %}
-- Name
-- Email
-- Message (textarea)
-
-> How did you hear about us?
-- Search engine
-- Social media
-- Friend referral
-- Other
-
-**Submit**
-{% /form %}`,
-    nav: `{% nav %}
-- [Docs](/docs)
-- [Blog](/blog)
-
-## Product
-- pricing
-- features
-
-## Resources
-- about
-- changelog
-{% /nav %}`,
-    pagination: `{% pagination prev="install" next="configuration" /%}`,
-};
+import { RUNE_EXAMPLES } from '@refrakt-md/runes';
+/** Built-in fixture strings, keyed by rune name. Generated from fixtures/*.md. */
+export const fixtures = RUNE_EXAMPLES;
+/** Whether a rune has a real fixture (plugin fixture or the unified manifest),
+ *  i.e. `getFixture` would return authored content rather than the stub. */
+export function hasFixture(runeName, packageFixtures) {
+    return Boolean(packageFixtures?.[runeName] ?? fixtures[runeName]);
+}
 /** Get a fixture for a rune, with optional attribute overrides applied to the source */
 export function getFixture(runeName, attrOverrides) {
-    // Look up by primary name or try as-is
     const source = fixtures[runeName];
     if (!source) {
         // Generate a minimal fixture for unknown runes
         return `{% ${runeName} %}\nSample content for the ${runeName} rune.\n{% /${runeName} %}`;
     }
+    return applyFixtureOverrides(source, runeName, attrOverrides);
+}
+/** Apply attribute overrides to an arbitrary fixture source (e.g. a plugin
+ *  fixture). Returns the source unchanged when there are no overrides. Shared by
+ *  `getFixture` and the inspect/gallery variant matrices so plugin fixtures get
+ *  the same variant expansion as core ones. */
+export function applyFixtureOverrides(source, runeName, attrOverrides) {
     if (!attrOverrides || Object.keys(attrOverrides).length === 0) {
         return source;
     }
-    // Apply attribute overrides by modifying the opening tag
     return applyOverrides(source, runeName, attrOverrides);
 }
 /** Replace or add attributes in the opening tag of a fixture */

package/dist/lib/fixtures.js.map

@@ -1 +1 @@
-{"version":3,"file":"fixtures.js","sourceRoot":"","sources":["../../src/lib/fixtures.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,QAAQ,GAA2B;IAC/C,IAAI,EAAE;;YAEK;IAEX,SAAS,EAAE;;;;;;;;;iBASK;IAEhB,OAAO,EAAE;;;eAGK;IAEd,IAAI,EAAE;;;;;;;;;;YAUK;IAEX,MAAM,EAAE;;;;cAIK;IAEb,IAAI,EAAE;;;;;;;;;;;;;;;;;;YAkBK;IAEX,YAAY,EAAE;;;;;;oBAMK;IAEnB,QAAQ,EAAE;;gBAEK;IAEf,IAAI,EAAE;;;;;;;;;;;;;;;;YAgBK;IAEX,SAAS,EAAE;;;;;;iBAMK;IAEhB,IAAI,EAAE;;;;;;;;;;;;YAYK;IAEX,GAAG,EAAE;;;;;;;;;;;WAWK;IAEV,UAAU,EAAE,uDAAuD;CACnE,CAAC;AAEF,wFAAwF;AACxF,MAAM,UAAU,UAAU,CAAC,QAAgB,EAAE,aAAsC;IAClF,uCAAuC;IACvC,MAAM,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAClC,IAAI,CAAC,MAAM,EAAE,CAAC;QACb,+CAA+C;QAC/C,OAAO,MAAM,QAAQ,+BAA+B,QAAQ,eAAe,QAAQ,KAAK,CAAC;IAC1F,CAAC;IAED,IAAI,CAAC,aAAa,IAAI,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/D,OAAO,MAAM,CAAC;IACf,CAAC;IAED,yDAAyD;IACzD,OAAO,cAAc,CAAC,MAAM,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;AACxD,CAAC;AAED,gEAAgE;AAChE,SAAS,cAAc,CAAC,MAAc,EAAE,OAAe,EAAE,SAAiC;IACzF,iEAAiE;IACjE,MAAM,cAAc,GAAG,IAAI,MAAM,CAAC,YAAY,WAAW,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACvF,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;IAC3C,IAAI,CAAC,KAAK;QAAE,OAAO,MAAM,CAAC;IAE1B,qFAAqF;IACrF,IAAI,UAAU,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;IACpD,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IAEzB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QACtD,oCAAoC;QACpC,MAAM,WAAW,GAAG,IAAI,MAAM,CAAC,GAAG,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAC9D,IAAI,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YAClC,UAAU,GAAG,UAAU,CAAC,OAAO,CAAC,WAAW,EAAE,GAAG,GAAG,KAAK,KAAK,GAAG,CAAC,CAAC;QACnE,CAAC;aAAM,CAAC;YACP,oBAAoB;YACpB,UAAU,GAAG,UAAU,CAAC,OAAO,EAAE,GAAG,IAAI,GAAG,KAAK,KAAK,IAAI,CAAC;QAC3D,CAAC;IACF,CAAC;IAED,OAAO,MAAM,CAAC,OAAO,CAAC,cAAc,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,UAAU,GAAG,OAAO,EAAE,CAAC,CAAC;AAC7E,CAAC;AAED,SAAS,WAAW,CAAC,CAAS;IAC7B,OAAO,CAAC,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;AACjD,CAAC"}
+{"version":3,"file":"fixtures.js","sourceRoot":"","sources":["../../src/lib/fixtures.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,kFAAkF;AAClF,MAAM,CAAC,MAAM,QAAQ,GAA2B,aAAa,CAAC;AAE9D;4EAC4E;AAC5E,MAAM,UAAU,UAAU,CAAC,QAAgB,EAAE,eAAwC;IACpF,OAAO,OAAO,CAAC,eAAe,EAAE,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;AACnE,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,UAAU,CAAC,QAAgB,EAAE,aAAsC;IAClF,MAAM,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAClC,IAAI,CAAC,MAAM,EAAE,CAAC;QACb,+CAA+C;QAC/C,OAAO,MAAM,QAAQ,+BAA+B,QAAQ,eAAe,QAAQ,KAAK,CAAC;IAC1F,CAAC;IAED,OAAO,qBAAqB,CAAC,MAAM,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;AAC/D,CAAC;AAED;;;+CAG+C;AAC/C,MAAM,UAAU,qBAAqB,CAAC,MAAc,EAAE,QAAgB,EAAE,aAAsC;IAC7G,IAAI,CAAC,aAAa,IAAI,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/D,OAAO,MAAM,CAAC;IACf,CAAC;IACD,OAAO,cAAc,CAAC,MAAM,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;AACxD,CAAC;AAED,gEAAgE;AAChE,SAAS,cAAc,CAAC,MAAc,EAAE,OAAe,EAAE,SAAiC;IACzF,iEAAiE;IACjE,MAAM,cAAc,GAAG,IAAI,MAAM,CAAC,YAAY,WAAW,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACvF,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;IAC3C,IAAI,CAAC,KAAK;QAAE,OAAO,MAAM,CAAC;IAE1B,qFAAqF;IACrF,IAAI,UAAU,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;IACpD,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IAEzB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QACtD,oCAAoC;QACpC,MAAM,WAAW,GAAG,IAAI,MAAM,CAAC,GAAG,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAC9D,IAAI,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YAClC,UAAU,GAAG,UAAU,CAAC,OAAO,CAAC,WAAW,EAAE,GAAG,GAAG,KAAK,KAAK,GAAG,CAAC,CAAC;QACnE,CAAC;aAAM,CAAC;YACP,oBAAoB;YACpB,UAAU,GAAG,UAAU,CAAC,OAAO,EAAE,GAAG,IAAI,GAAG,KAAK,KAAK,IAAI,CAAC;QAC3D,CAAC;IACF,CAAC;IAED,OAAO,MAAM,CAAC,OAAO,CAAC,cAAc,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,UAAU,GAAG,OAAO,EAAE,CAAC,CAAC;AAC7E,CAAC;AAED,SAAS,WAAW,CAAC,CAAS;IAC7B,OAAO,CAAC,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;AACjD,CAAC"}

package/dist/lib/gallery.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Recursively inline `@import` statements into a single CSS string so the gallery
+ * is self-contained (no path/serving concerns, deterministic for screenshots).
+ *
+ * Handles three forms so the skeleton/skin split (SPEC-094 §3) renders faithfully:
+ *  - relative imports (`@import './x.css';`) — inlined from disk;
+ *  - bare package specifiers (`@import '@refrakt-md/skeleton';`) — resolved via
+ *    node (the package's CSS `.` export) and inlined, so the shared structural
+ *    layer is part of the gallery;
+ *  - layered imports (`@import './x.css' layer(skeleton);`) — inlined and wrapped
+ *    in `@layer <name> { … }` so the cascade-layer ordering survives flattening
+ *    (otherwise layered structure inlines as unlayered and would beat the skin).
+ *
+ * A `seen` set guards against import cycles; genuinely-remote imports (web fonts)
+ * are left untouched.
+ */
+export declare function flattenCssImports(entryPath: string, seen?: Set<string>): string;
+/** One rendered rune variant in the gallery. */
+export interface GalleryCell {
+    /** Rune name (e.g. `hint`). */
+    rune: string;
+    /** Variant key (e.g. `default`, `type-warning`). */
+    variant: string;
+    /** Rendered HTML for this variant. */
+    html: string;
+}
+export interface GalleryDocumentOptions {
+    mode: 'light' | 'dark';
+    /** Flattened, self-contained theme CSS. */
+    themeCss: string;
+    cells: GalleryCell[];
+    /** Optional override for the font `<link>` tags injected into `<head>`. */
+    fontLinks?: string;
+    /** Optional bundled behaviors IIFE, inlined before `</body>` so interactive /
+     *  lifecycle runes (tabs, diagram, chart, nav) enhance/render. */
+    behaviorScript?: string;
+}
+export interface LayoutDocumentOptions {
+    mode: 'light' | 'dark';
+    themeCss: string;
+    /** The layout's rendered HTML (from `layoutTransform` → `renderToHtml`). */
+    bodyHtml: string;
+    /** Layout name, for the document title. */
+    name: string;
+    fontLinks?: string;
+    behaviorScript?: string;
+}
+/**
+ * Render a standalone full-page document for a layout fixture — the layout's
+ * own chrome *is* the page (no gallery cell grid), so the harness can shoot it
+ * whole-page at multiple viewports.
+ */
+export declare function renderLayoutDocument(opts: LayoutDocumentOptions): string;
+/**
+ * Render the full self-contained gallery HTML document for one mode. Cells are
+ * grouped by rune; each carries a stable `data-gallery-cell="<rune>--<variant>"`
+ * anchor so the harness ({% WORK-409 %}) can clip per variant.
+ */
+export declare function renderGalleryDocument(opts: GalleryDocumentOptions): string;
+//# sourceMappingURL=gallery.d.ts.map

package/dist/lib/gallery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gallery.d.ts","sourceRoot":"","sources":["../../src/lib/gallery.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,GAAE,GAAG,CAAC,MAAM,CAAa,GAAG,MAAM,CAyB1F;AAED,gDAAgD;AAChD,MAAM,WAAW,WAAW;IAC3B,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,OAAO,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,sBAAsB;IACtC,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC;IACvB,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,2EAA2E;IAC3E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;sEACkE;IAClE,cAAc,CAAC,EAAE,MAAM,CAAC;CACxB;AAyED,MAAM,WAAW,qBAAqB;IACrC,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,4EAA4E;IAC5E,QAAQ,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,qBAAqB,GAAG,MAAM,CAsBxE;AAMD;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,sBAAsB,GAAG,MAAM,CA8C1E"}

package/dist/lib/gallery.js

@@ -0,0 +1,192 @@
+import { readFileSync } from 'node:fs';
+import { dirname, resolve } from 'node:path';
+import { createRequire } from 'node:module';
+const requireFrom = createRequire(import.meta.url);
+/**
+ * Recursively inline `@import` statements into a single CSS string so the gallery
+ * is self-contained (no path/serving concerns, deterministic for screenshots).
+ *
+ * Handles three forms so the skeleton/skin split (SPEC-094 §3) renders faithfully:
+ *  - relative imports (`@import './x.css';`) — inlined from disk;
+ *  - bare package specifiers (`@import '@refrakt-md/skeleton';`) — resolved via
+ *    node (the package's CSS `.` export) and inlined, so the shared structural
+ *    layer is part of the gallery;
+ *  - layered imports (`@import './x.css' layer(skeleton);`) — inlined and wrapped
+ *    in `@layer <name> { … }` so the cascade-layer ordering survives flattening
+ *    (otherwise layered structure inlines as unlayered and would beat the skin).
+ *
+ * A `seen` set guards against import cycles; genuinely-remote imports (web fonts)
+ * are left untouched.
+ */
+export function flattenCssImports(entryPath, seen = new Set()) {
+    const abs = resolve(entryPath);
+    if (seen.has(abs))
+        return '';
+    seen.add(abs);
+    const dir = dirname(abs);
+    const css = readFileSync(abs, 'utf-8');
+    return css.replace(/@import\s+(?:url\()?['"]([^'"]+)['"]\)?\s*(?:layer\(([^)]*)\))?\s*;/g, (match, importPath, layerName) => {
+        let resolved;
+        if (importPath.startsWith('.')) {
+            resolved = resolve(dir, importPath);
+        }
+        else {
+            try {
+                resolved = requireFrom.resolve(importPath);
+            }
+            catch {
+                return match; // leave unresolvable/remote imports as-is
+            }
+        }
+        const inlined = flattenCssImports(resolved, seen);
+        return layerName !== undefined ? `@layer ${layerName.trim()} {\n${inlined}\n}` : inlined;
+    });
+}
+/** Default web-font links — tactically Lumina's families (WORK-407 defers the
+ *  theme-owned-font system). The harness needs fonts actually loaded for stable
+ *  screenshots. */
+const DEFAULT_FONT_LINKS = [
+    '<link rel="preconnect" href="https://fonts.googleapis.com">',
+    '<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>',
+    '<link href="https://fonts.googleapis.com/css2?family=Inter:wght@300..700&family=JetBrains+Mono:wght@400;500;700&display=swap" rel="stylesheet">',
+].join('\n');
+/** Gallery chrome + determinism CSS. Kills animation/transition/caret so
+ *  screenshots are stable; lays out runes in labelled cells. */
+const GALLERY_CSS = `
+*, *::before, *::after {
+	animation-duration: 0s !important;
+	animation-delay: 0s !important;
+	transition-duration: 0s !important;
+	transition-delay: 0s !important;
+	caret-color: transparent !important;
+	scroll-behavior: auto !important;
+}
+body.rf-gallery {
+	background: var(--rf-color-bg);
+	color: var(--rf-color-text);
+	font-family: var(--rf-font-sans, sans-serif);
+	margin: 0;
+	padding: 2.5rem 1.5rem;
+}
+.rf-gallery__inner { max-width: 72rem; margin: 0 auto; }
+.rf-gallery__rune { margin: 0 0 3.5rem; }
+.rf-gallery__rune-title {
+	font-family: var(--rf-font-mono, monospace);
+	font-size: 0.75rem;
+	text-transform: uppercase;
+	letter-spacing: 0.08em;
+	color: var(--rf-color-muted, #888);
+	border-bottom: 1px solid var(--rf-color-border, #ddd);
+	padding-bottom: 0.5rem;
+	margin: 0 0 1.5rem;
+}
+.rf-gallery__cell { margin: 0 0 2rem; }
+.rf-gallery__gap {
+	font-family: var(--rf-font-mono, monospace);
+	font-size: 0.75rem;
+	color: var(--rf-color-muted, #999);
+	border: 1px dashed var(--rf-color-border, #ccc);
+	border-radius: var(--rf-radius-sm, 4px);
+	padding: 0.75rem 1rem;
+}
+.rf-gallery__cell-label {
+	display: block;
+	font-family: var(--rf-font-mono, monospace);
+	font-size: 0.6875rem;
+	color: var(--rf-color-muted, #999);
+	margin: 0 0 0.5rem;
+}
+`.trim();
+/** Determinism reset for layout fixtures (no gallery chrome — the layout *is*
+ *  the page). Kills animation/transition/caret so screenshots are stable. */
+const LAYOUT_RESET_CSS = `
+*, *::before, *::after {
+	animation-duration: 0s !important;
+	animation-delay: 0s !important;
+	transition-duration: 0s !important;
+	transition-delay: 0s !important;
+	caret-color: transparent !important;
+	scroll-behavior: auto !important;
+}
+body { margin: 0; background: var(--rf-color-bg); color: var(--rf-color-text); font-family: var(--rf-font-sans, sans-serif); }
+`.trim();
+/**
+ * Render a standalone full-page document for a layout fixture — the layout's
+ * own chrome *is* the page (no gallery cell grid), so the harness can shoot it
+ * whole-page at multiple viewports.
+ */
+export function renderLayoutDocument(opts) {
+    const { mode, themeCss, bodyHtml, name, fontLinks = DEFAULT_FONT_LINKS, behaviorScript } = opts;
+    const htmlAttr = mode === 'dark' ? ' data-theme="dark"' : '';
+    const tail = behaviorScript
+        ? `<script type="application/json" id="rf-context">{"pages":[],"currentUrl":"/"}</script>\n<script>${behaviorScript}</script>\n`
+        : '';
+    return `<!DOCTYPE html>
+<html lang="en"${htmlAttr}>
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<meta name="color-scheme" content="light dark">
+<title>refrakt layout — ${name} (${mode})</title>
+${fontLinks}
+<style>${themeCss}</style>
+<style>${LAYOUT_RESET_CSS}</style>
+</head>
+<body>
+${bodyHtml}
+${tail}</body>
+</html>
+`;
+}
+function escapeHtml(s) {
+    return s.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;');
+}
+/**
+ * Render the full self-contained gallery HTML document for one mode. Cells are
+ * grouped by rune; each carries a stable `data-gallery-cell="<rune>--<variant>"`
+ * anchor so the harness ({% WORK-409 %}) can clip per variant.
+ */
+export function renderGalleryDocument(opts) {
+    const { mode, themeCss, cells, fontLinks = DEFAULT_FONT_LINKS, behaviorScript } = opts;
+    // Group cells by rune, preserving insertion order.
+    const byRune = new Map();
+    for (const cell of cells) {
+        const list = byRune.get(cell.rune) ?? [];
+        list.push(cell);
+        byRune.set(cell.rune, list);
+    }
+    const sections = [];
+    for (const [rune, runeCells] of byRune) {
+        const cellHtml = runeCells.map(cell => {
+            const anchor = `${cell.rune}--${cell.variant}`;
+            return `      <div class="rf-gallery__cell" data-gallery-cell="${escapeHtml(anchor)}" data-rune="${escapeHtml(cell.rune)}" data-variant="${escapeHtml(cell.variant)}">
+        <span class="rf-gallery__cell-label">${escapeHtml(cell.variant)}</span>
+${cell.html}
+      </div>`;
+        }).join('\n');
+        sections.push(`    <section class="rf-gallery__rune" data-gallery-rune="${escapeHtml(rune)}">
+      <h2 class="rf-gallery__rune-title">${escapeHtml(rune)}</h2>
+${cellHtml}
+    </section>`);
+    }
+    const htmlAttr = mode === 'dark' ? ' data-theme="dark"' : '';
+    return `<!DOCTYPE html>
+<html lang="en"${htmlAttr}>
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<meta name="color-scheme" content="light dark">
+<title>refrakt gallery (${mode})</title>
+${fontLinks}
+<style>${themeCss}</style>
+<style>${GALLERY_CSS}</style>
+</head>
+<body class="rf-gallery">
+<div class="rf-gallery__inner">
+${sections.join('\n')}
+</div>
+${behaviorScript ? `<script type="application/json" id="rf-context">{"pages":[],"currentUrl":"/"}</script>\n<script>${behaviorScript}</script>\n` : ''}</body>
+</html>
+`;
+}
+//# sourceMappingURL=gallery.js.map

package/dist/lib/gallery.js.map

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@refrakt-md/cli",
   "description": "CLI tools for refrakt.md",
-  "version": "0.21.0",
+  "version": "0.23.0",
   "type": "module",
   "license": "MIT",
   "repository": {
@@ -36,10 +36,12 @@
   },
   "dependencies": {
     "@markdoc/markdoc": "0.4.0",
-    "@refrakt-md/ai": "0.21.0",
-    "@refrakt-md/editor": "0.21.0",
-    "@refrakt-md/runes": "0.21.0",
-    "@refrakt-md/transform": "0.21.0",
+    "@refrakt-md/ai": "0.23.0",
+    "@refrakt-md/editor": "0.23.0",
+    "@refrakt-md/html": "0.23.0",
+    "@refrakt-md/runes": "0.23.0",
+    "@refrakt-md/transform": "0.23.0",
+    "esbuild": "^0.27.5",
     "postcss": "^8.4.0"
   }
 }