@bestagentkits/render 0.1.1-next.1 → 0.3.0

package/dist/render/derived-variables.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Derived custom properties, computed from theme tokens.
+ *
+ * `:root` declares them once, and the night band redeclares them because an
+ * inherited custom property carries the root's computed result, not its
+ * formula. Both read these constants, so the band and dark mode cannot drift.
+ * The scroll-edge shades below are written per scroller instead, so their
+ * colours resolve where they are used.
+ */
+/** Hover wash: a little accent mixed into the surface. */
+export declare const TINT = "--ak-tint:color-mix(in srgb,var(--ak-color-accent) 7%,var(--ak-color-surface))";
+/** Focus halo for inputs and controls. */
+export declare const RING = "--ak-ring:0 0 0 3px color-mix(in srgb,var(--ak-color-accent) 24%,transparent)";
+/**
+ * Surface background in dark schemes: a faint top-lit sheen, because the fixed
+ * elevation shadows are invisible against a dark page.
+ */
+export declare const DARK_FILL = "--ak-fill:linear-gradient(180deg,color-mix(in srgb,var(--ak-color-text) 4%,transparent),transparent 160px),var(--ak-color-surface)";
+/**
+ * Edge shades that show a sideways scroller holds more than it shows.
+ *
+ * A soft shade sits on each edge of a box whose `background` is `var(--ak-fill)`
+ * (the night band and dark mode recolour it from tokens). A scroll timeline
+ * sizes each shade from the scroll position: the start edge stays clear until
+ * the content moves, and the end edge clears once the end is reached. A box
+ * that does not overflow has an inactive timeline and so no shades, and an
+ * engine without scroll timelines keeps the plain fill. The shades follow
+ * position, not time, so like the reading-progress rail they are not motion and
+ * are not gated on reduced motion. `SCROLL_EDGE_KEYFRAMES` must be on the page.
+ */
+export declare function scrollEdges(selector: string): string;
+/**
+ * Shade sizes along the scroll: start clear, both shaded in between, end clear.
+ * The third size covers the dark fill's sheen layer and is ignored in light.
+ */
+export declare const SCROLL_EDGE_KEYFRAMES = "@keyframes ak-scroll-edges{0%{background-size:0 100%,14px 100%,auto}6%,94%{background-size:14px 100%,14px 100%,auto}100%{background-size:14px 100%,0 100%,auto}}";
+//# sourceMappingURL=derived-variables.d.ts.map

package/dist/render/derived-variables.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"derived-variables.d.ts","sourceRoot":"","sources":["../../src/render/derived-variables.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,0DAA0D;AAC1D,eAAO,MAAM,IAAI,mFACiE,CAAC;AAEnF,0CAA0C;AAC1C,eAAO,MAAM,IAAI,kFAAkF,CAAC;AAEpG;;;GAGG;AACH,eAAO,MAAM,SAAS,uIACgH,CAAC;AAIvI;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED;;;GAGG;AACH,eAAO,MAAM,qBAAqB,qKACkI,CAAC"}

package/dist/render/derived-variables.js

@@ -0,0 +1,40 @@
+/**
+ * Derived custom properties, computed from theme tokens.
+ *
+ * `:root` declares them once, and the night band redeclares them because an
+ * inherited custom property carries the root's computed result, not its
+ * formula. Both read these constants, so the band and dark mode cannot drift.
+ * The scroll-edge shades below are written per scroller instead, so their
+ * colours resolve where they are used.
+ */
+/** Hover wash: a little accent mixed into the surface. */
+export const TINT = '--ak-tint:color-mix(in srgb,var(--ak-color-accent) 7%,var(--ak-color-surface))';
+/** Focus halo for inputs and controls. */
+export const RING = '--ak-ring:0 0 0 3px color-mix(in srgb,var(--ak-color-accent) 24%,transparent)';
+/**
+ * Surface background in dark schemes: a faint top-lit sheen, because the fixed
+ * elevation shadows are invisible against a dark page.
+ */
+export const DARK_FILL = '--ak-fill:linear-gradient(180deg,color-mix(in srgb,var(--ak-color-text) 4%,transparent),transparent 160px),var(--ak-color-surface)';
+const EDGE_SHADE = 'color-mix(in srgb,var(--ak-color-text) 18%,transparent)';
+/**
+ * Edge shades that show a sideways scroller holds more than it shows.
+ *
+ * A soft shade sits on each edge of a box whose `background` is `var(--ak-fill)`
+ * (the night band and dark mode recolour it from tokens). A scroll timeline
+ * sizes each shade from the scroll position: the start edge stays clear until
+ * the content moves, and the end edge clears once the end is reached. A box
+ * that does not overflow has an inactive timeline and so no shades, and an
+ * engine without scroll timelines keeps the plain fill. The shades follow
+ * position, not time, so like the reading-progress rail they are not motion and
+ * are not gated on reduced motion. `SCROLL_EDGE_KEYFRAMES` must be on the page.
+ */
+export function scrollEdges(selector) {
+    return `@supports (animation-timeline:scroll()){${selector}{background:radial-gradient(farthest-side at 0 50%,${EDGE_SHADE},transparent) left center/0 100% no-repeat,radial-gradient(farthest-side at 100% 50%,${EDGE_SHADE},transparent) right center/0 100% no-repeat,var(--ak-fill);animation:ak-scroll-edges linear both;animation-timeline:scroll(self inline)}}`;
+}
+/**
+ * Shade sizes along the scroll: start clear, both shaded in between, end clear.
+ * The third size covers the dark fill's sheen layer and is ignored in light.
+ */
+export const SCROLL_EDGE_KEYFRAMES = '@keyframes ak-scroll-edges{0%{background-size:0 100%,14px 100%,auto}6%,94%{background-size:14px 100%,14px 100%,auto}100%{background-size:14px 100%,0 100%,auto}}';
+//# sourceMappingURL=derived-variables.js.map

package/dist/render/derived-variables.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"derived-variables.js","sourceRoot":"","sources":["../../src/render/derived-variables.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,0DAA0D;AAC1D,MAAM,CAAC,MAAM,IAAI,GACf,gFAAgF,CAAC;AAEnF,0CAA0C;AAC1C,MAAM,CAAC,MAAM,IAAI,GAAG,+EAA+E,CAAC;AAEpG;;;GAGG;AACH,MAAM,CAAC,MAAM,SAAS,GACpB,oIAAoI,CAAC;AAEvI,MAAM,UAAU,GAAG,yDAAyD,CAAC;AAE7E;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,WAAW,CAAC,QAAgB;IAC1C,OAAO,2CAA2C,QAAQ,sDAAsD,UAAU,wFAAwF,UAAU,2IAA2I,CAAC;AAC1W,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAChC,kKAAkK,CAAC"}

package/dist/render/diagram-fallback.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Structured diagram fallback.
+ *
+ * Without an adapter a diagram still has to read as a diagram. When the
+ * connections form one simple chain (every node has at most one way in and one
+ * way out, and the chain visits every node), the nodes are drawn as a flow with
+ * labelled connectors. Any other graph is shown as a set of nodes plus an
+ * explicit connection list, because drawing arrows between nodes that are not
+ * connected would state something the spec does not.
+ */
+import type { JsonValue } from '../json.js';
+export interface DiagramNode {
+    id: string;
+    label: string;
+}
+export interface DiagramEdge {
+    from: string;
+    to: string;
+    label: string;
+}
+/** Order nodes along the single chain the edges describe, or return undefined when they do not form one. */
+export declare function chainOrder(nodes: DiagramNode[], edges: DiagramEdge[]): DiagramNode[] | undefined;
+/** Render the fallback body for the described nodes and connections. */
+export declare function renderDiagramFallback(described: Record<string, JsonValue>[], connections: Record<string, JsonValue>[]): string;
+//# sourceMappingURL=diagram-fallback.d.ts.map

package/dist/render/diagram-fallback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagram-fallback.d.ts","sourceRoot":"","sources":["../../src/render/diagram-fallback.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAG5C,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;CACf;AAED,4GAA4G;AAC5G,wBAAgB,UAAU,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,WAAW,EAAE,GAAG,SAAS,CAwBhG;AA+CD,wEAAwE;AACxE,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,EACtC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,GACvC,MAAM,CASR"}

package/dist/render/diagram-fallback.js

@@ -0,0 +1,86 @@
+/**
+ * Structured diagram fallback.
+ *
+ * Without an adapter a diagram still has to read as a diagram. When the
+ * connections form one simple chain (every node has at most one way in and one
+ * way out, and the chain visits every node), the nodes are drawn as a flow with
+ * labelled connectors. Any other graph is shown as a set of nodes plus an
+ * explicit connection list, because drawing arrows between nodes that are not
+ * connected would state something the spec does not.
+ */
+import { escapeText } from './escape.js';
+/** Order nodes along the single chain the edges describe, or return undefined when they do not form one. */
+export function chainOrder(nodes, edges) {
+    if (nodes.length < 2 || edges.length !== nodes.length - 1)
+        return undefined;
+    const byId = new Map(nodes.map((node) => [node.id, node]));
+    if (byId.size !== nodes.length)
+        return undefined;
+    const next = new Map();
+    const incoming = new Set();
+    for (const edge of edges) {
+        if (!byId.has(edge.from) || !byId.has(edge.to))
+            return undefined;
+        if (next.has(edge.from) || incoming.has(edge.to))
+            return undefined;
+        next.set(edge.from, edge.to);
+        incoming.add(edge.to);
+    }
+    const start = nodes.find((node) => !incoming.has(node.id));
+    if (start === undefined)
+        return undefined;
+    const ordered = [];
+    const seen = new Set();
+    let cursor = start.id;
+    while (cursor !== undefined && !seen.has(cursor)) {
+        seen.add(cursor);
+        const node = byId.get(cursor);
+        if (node !== undefined)
+            ordered.push(node);
+        cursor = next.get(cursor);
+    }
+    return ordered.length === nodes.length ? ordered : undefined;
+}
+function nodeMarkup(node) {
+    const label = node.label === '' ? node.id : node.label;
+    return `<span class="ak-flow-node"><span class="ak-flow-name">${escapeText(label)}</span><code>${escapeText(node.id)}</code></span>`;
+}
+function flowMarkup(ordered, edges) {
+    const edgeFrom = new Map(edges.map((edge) => [edge.from, edge]));
+    const items = ordered.map((node, index) => {
+        const edge = index < ordered.length - 1 ? edgeFrom.get(node.id) : undefined;
+        const connector = edge === undefined
+            ? ''
+            : `<span class="ak-flow-edge"><span class="ak-sr">then to ${escapeText(edge.to)}</span>${edge.label === ''
+                ? ''
+                : `<span class="ak-flow-edge-label">${escapeText(edge.label)}</span>`}</span>`;
+        return `<li>${nodeMarkup(node)}${connector}</li>`;
+    });
+    return `<ol class="ak-flow">${items.join('')}</ol>`;
+}
+function graphMarkup(nodes, edges) {
+    const nodeList = nodes.length === 0
+        ? ''
+        : `<ul class="ak-flow-nodes">${nodes.map((node) => `<li>${nodeMarkup(node)}</li>`).join('')}</ul>`;
+    const edgeList = edges.length === 0
+        ? ''
+        : `<ul class="ak-flow-links">${edges
+            .map((edge) => `<li><code>${escapeText(edge.from)}</code><span class="ak-flow-arrow" aria-hidden="true">\u2192</span><span class="ak-sr">to</span><code>${escapeText(edge.to)}</code>${edge.label === '' ? '' : `<span class="ak-flow-link-label">${escapeText(edge.label)}</span>`}</li>`)
+            .join('')}</ul>`;
+    return `${nodeList}${edgeList}`;
+}
+function text(value) {
+    return typeof value === 'string' ? value : '';
+}
+/** Render the fallback body for the described nodes and connections. */
+export function renderDiagramFallback(described, connections) {
+    const nodes = described.map((item) => ({ id: text(item.id), label: text(item.label) }));
+    const edges = connections.map((item) => ({
+        from: text(item.from),
+        to: text(item.to),
+        label: text(item.label),
+    }));
+    const ordered = chainOrder(nodes, edges);
+    return ordered === undefined ? graphMarkup(nodes, edges) : flowMarkup(ordered, edges);
+}
+//# sourceMappingURL=diagram-fallback.js.map

package/dist/render/diagram-fallback.js.map

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

package/dist/render/document.d.ts

@@ -24,6 +24,21 @@ export interface DocumentInput {
     themeToggle: boolean;
     /** Resolved theme density, emitted as a document-level attribute. */
     density: string;
+    /** The theme turned motion off; the runtime reads this from the root element. */
+    motionDisabled?: boolean;
+    /**
+     * Resolved component recipes. Each non-default choice becomes a
+     * `data-r-<surface>` attribute that scopes its recipe sheet; defaults emit
+     * nothing, so a page without recipes keeps its bytes.
+     */
+    recipes?: Readonly<Record<string, string>>;
+    /** Rendered page outline; omitted or empty when the page has none. */
+    outline?: string;
+    /**
+     * Emit the live region. Omitted: derived from the core features the page's
+     * blocks declare; the compiler passes it so registry features count too.
+     */
+    liveRegion?: boolean;
 }
 export interface AssembledDocument {
     html: string;

package/dist/render/document.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"document.d.ts","sourceRoot":"","sources":["../../src/render/document.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAiB,MAAM,UAAU,CAAC;AAI1D,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,UAAU,CAAC;IACf,eAAe,EAAE,MAAM,CAAC;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,8EAA8E;IAC9E,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,WAAW,EAAE,OAAO,CAAC;IACrB,qEAAqE;IACrE,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB;AA8BD,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,aAAa,GAAG;IAChE,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB,CAQA;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,aAAa,GAAG,iBAAiB,CA6CxE"}
+{"version":3,"file":"document.d.ts","sourceRoot":"","sources":["../../src/render/document.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAiB,MAAM,UAAU,CAAC;AAK1D,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,UAAU,CAAC;IACf,eAAe,EAAE,MAAM,CAAC;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,8EAA8E;IAC9E,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,WAAW,EAAE,OAAO,CAAC;IACrB,qEAAqE;IACrE,OAAO,EAAE,MAAM,CAAC;IAChB,iFAAiF;IACjF,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;;OAIG;IACH,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC3C,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB;AAkCD,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,aAAa,GAAG;IAChE,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB,CAQA;AAiBD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,aAAa,GAAG,iBAAiB,CAyExE"}

package/dist/render/document.js

@@ -12,13 +12,18 @@
  * would break byte-determinism, and a nonce does not need to be unpredictable
  * to be useful here (it only has to distinguish the compiler's own elements).
  */
+import { ADAPTER_STYLE_MARKER } from '../diagram/adapter.js';
 import { stableHash } from '../hash.js';
+import { nonDefaultRecipes } from '../theme/recipes.js';
 import { escapeAttribute, escapeText } from './escape.js';
 import { needsLiveRegion } from './runtime.js';
 function directives(policy, input, styleNonce, scriptNonce) {
     const origins = [...new Set(input.allowedOrigins)].sort();
-    const imageSources = ['data:', 'file:', ...origins];
-    const mediaSources = ['file:', ...origins];
+    // `'self'` lets the page's own relative assets load when the file is served
+    // over HTTP(S) instead of opened from disk. It adds no fetch path: remote URLs
+    // in the spec are still gated by the network policy before they reach markup.
+    const imageSources = ['data:', 'file:', "'self'", ...origins];
+    const mediaSources = ['file:', "'self'", ...origins];
     const parts = [
         "default-src 'none'",
         "base-uri 'none'",
@@ -26,7 +31,8 @@ function directives(policy, input, styleNonce, scriptNonce) {
         "frame-src 'none'",
         "object-src 'none'",
         "connect-src 'none'",
-        "font-src 'none'",
+        // Only embedded `data:` faces are ever allowed; a page without one keeps fonts closed.
+        input.css.includes('@font-face') ? 'font-src data:' : "font-src 'none'",
         `img-src ${imageSources.join(' ')}`,
         `media-src ${mediaSources.join(' ')}`,
         `style-src 'nonce-${styleNonce}'`,
@@ -46,21 +52,56 @@ export function buildContentSecurityPolicy(input) {
         scriptNonce,
     };
 }
+/**
+ * Give accepted diagram adapter `<style>` elements the page style nonce.
+ *
+ * Adapter markup passed the trust check before it reached the body, and the
+ * renderer marked each of its style elements. Spec text cannot forge the
+ * marker, because every `<` in spec text is escaped. The policy stays
+ * nonce-only: no `'unsafe-inline'`, and inline `style` attributes stay refused.
+ */
+function nonceAdapterStyles(body, styleNonce) {
+    return body.replaceAll(`<style ${ADAPTER_STYLE_MARKER}`, `<style nonce="${escapeAttribute(styleNonce)}" ${ADAPTER_STYLE_MARKER}`);
+}
 export function assembleDocument(input) {
     const { csp, styleNonce, scriptNonce } = buildContentSecurityPolicy(input);
     const { meta } = input.ir;
-    const liveRegion = needsLiveRegion(new Set(input.ir.nodes.flatMap((node) => node.runtimeFeatures)))
+    const liveRegion = (input.liveRegion ??
+        needsLiveRegion(new Set(input.ir.nodes.flatMap((node) => node.runtimeFeatures))))
         ? `<div class="ak-sr" data-ak-live role="status" aria-live="polite"></div>`
         : '';
     const themeToggle = input.themeToggle
         ? `<div class="ak-page-bar"><button type="button" class="ak-btn ak-theme-toggle" data-ak-theme-toggle aria-pressed="false" aria-label="Toggle dark theme">Dark</button></div>`
         : '';
+    // Share metadata comes only from the spec's own meta, so it stays
+    // deterministic and never invents a URL the artifact does not have.
     const description = meta.description === undefined
         ? ''
-        : `<meta name="description" content="${escapeAttribute(meta.description)}" />`;
+        : [
+            `<meta name="description" content="${escapeAttribute(meta.description)}" />`,
+            `<meta property="og:description" content="${escapeAttribute(meta.description)}" />`,
+        ].join('\n');
+    const share = [
+        `<meta property="og:title" content="${escapeAttribute(meta.title)}" />`,
+        '<meta property="og:type" content="article" />',
+        '<meta name="twitter:card" content="summary" />',
+    ].join('\n');
+    // The colophon names the generator and offers a way back to the top; it holds
+    // no dates or paths, so the artifact stays byte-deterministic.
+    const colophon = [
+        '<footer class="ak-colophon">',
+        `<p><span class="ak-colophon-title">${escapeText(meta.title)}</span>`,
+        `<span>Generated by @bestagentkits/render ${escapeText(input.compilerVersion)}</span></p>`,
+        '<a href="#ak-main-content">Back to top</a>',
+        '</footer>',
+    ].join('');
+    const outline = input.outline ?? '';
+    const recipeAttributes = nonDefaultRecipes(input.recipes)
+        .map(([surface, choice]) => ` data-r-${surface}="${escapeAttribute(choice)}"`)
+        .join('');
     const html = [
         '<!DOCTYPE html>',
-        `<html lang="${escapeAttribute(meta.locale)}" data-density="${escapeAttribute(input.density)}">`,
+        `<html lang="${escapeAttribute(meta.locale)}" data-density="${escapeAttribute(input.density)}"${input.motionDisabled === true ? ' data-motion="none"' : ''}${recipeAttributes}>`,
         '<head>',
         '<meta charset="utf-8" />',
         '<meta name="viewport" content="width=device-width, initial-scale=1" />',
@@ -69,13 +110,17 @@ export function assembleDocument(input) {
         `<meta http-equiv="Content-Security-Policy" content="${escapeAttribute(csp)}" />`,
         `<title>${escapeText(meta.title)}</title>`,
         description,
+        share,
         `<style nonce="${escapeAttribute(styleNonce)}">${input.css}</style>`,
         '</head>',
         '<body>',
         '<a class="ak-skip" href="#ak-main-content">Skip to main content</a>',
-        '<div class="ak-shell">',
+        '<div class="ak-progress-rail" aria-hidden="true"></div>',
+        `<div class="ak-shell${outline === '' ? '' : ' ak-shell--outline'}">`,
         themeToggle,
-        input.body,
+        nonceAdapterStyles(input.body, styleNonce),
+        outline,
+        colophon,
         '</div>',
         liveRegion,
         input.js === '' ? '' : `<script nonce="${escapeAttribute(scriptNonce)}">${input.js}</script>`,

package/dist/render/document.js.map

@@ -1 +1 @@
-{"version":3,"file":"document.js","sourceRoot":"","sources":["../../src/render/document.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAsB/C,SAAS,UAAU,CACjB,MAAqB,EACrB,KAAoB,EACpB,UAAkB,EAClB,WAAmB;IAEnB,MAAM,OAAO,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC1D,MAAM,YAAY,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,CAAC;IACpD,MAAM,YAAY,GAAG,CAAC,OAAO,EAAE,GAAG,OAAO,CAAC,CAAC;IAC3C,MAAM,KAAK,GAAG;QACZ,oBAAoB;QACpB,iBAAiB;QACjB,oBAAoB;QACpB,kBAAkB;QAClB,mBAAmB;QACnB,oBAAoB;QACpB,iBAAiB;QACjB,WAAW,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE;QACnC,aAAa,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE;QACrC,oBAAoB,UAAU,GAAG;KAClC,CAAC;IACF,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,qBAAqB,WAAW,GAAG,CAAC,CAAC;IACxF,IAAI,MAAM,KAAK,MAAM,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACjD,KAAK,CAAC,IAAI,CAAC,4BAA4B,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACvE,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,KAAoB;IAK7D,MAAM,UAAU,GAAG,KAAK,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;IAC7D,MAAM,WAAW,GAAG,KAAK,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;IAC7D,OAAO;QACL,GAAG,EAAE,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,WAAW,CAAC;QACxE,UAAU;QACV,WAAW;KACZ,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAoB;IACnD,MAAM,EAAE,GAAG,EAAE,UAAU,EAAE,WAAW,EAAE,GAAG,0BAA0B,CAAC,KAAK,CAAC,CAAC;IAC3E,MAAM,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC,EAAE,CAAC;IAC1B,MAAM,UAAU,GAAG,eAAe,CAChC,IAAI,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,CAChE;QACC,CAAC,CAAC,yEAAyE;QAC3E,CAAC,CAAC,EAAE,CAAC;IACP,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW;QACnC,CAAC,CAAC,4KAA4K;QAC9K,CAAC,CAAC,EAAE,CAAC;IACP,MAAM,WAAW,GACf,IAAI,CAAC,WAAW,KAAK,SAAS;QAC5B,CAAC,CAAC,EAAE;QACJ,CAAC,CAAC,qCAAqC,eAAe,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC;IAEnF,MAAM,IAAI,GAAG;QACX,iBAAiB;QACjB,eAAe,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,mBAAmB,eAAe,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI;QAChG,QAAQ;QACR,0BAA0B;QAC1B,wEAAwE;QACxE,mDAAmD;QACnD,yDAAyD,eAAe,CAAC,KAAK,CAAC,eAAe,CAAC,MAAM;QACrG,uDAAuD,eAAe,CAAC,GAAG,CAAC,MAAM;QACjF,UAAU,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU;QAC1C,WAAW;QACX,iBAAiB,eAAe,CAAC,UAAU,CAAC,KAAK,KAAK,CAAC,GAAG,UAAU;QACpE,SAAS;QACT,QAAQ;QACR,qEAAqE;QACrE,wBAAwB;QACxB,WAAW;QACX,KAAK,CAAC,IAAI;QACV,QAAQ;QACR,UAAU;QACV,KAAK,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,kBAAkB,eAAe,CAAC,WAAW,CAAC,KAAK,KAAK,CAAC,EAAE,WAAW;QAC7F,SAAS;QACT,SAAS;QACT,EAAE;KACH;SACE,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC;SAC7B,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC;AAChD,CAAC"}
+{"version":3,"file":"document.js","sourceRoot":"","sources":["../../src/render/document.ts"],"names":[],"mappings":"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"}

package/dist/render/effects-styles.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Effects layer of the emitted stylesheet.
+ *
+ * Atmosphere and feedback shared by every page: a theme-tinted aurora behind the
+ * hero, a word-by-word title reveal, a film-grain page texture, a pointer
+ * spotlight on cards, and a shine on primary buttons. It also carries the window dots, which the terminal and the
+ * frame feature share. Block styles belong in feature sheets, never here.
+ *
+ * Rules: no selector may contain a feature marker (see `verify.ts`); motion is
+ * gated on `prefers-reduced-motion: no-preference`; nothing starts hidden unless
+ * it is already on screen; print drops all of it.
+ */
+export declare const EFFECTS_CSS: string;
+//# sourceMappingURL=effects-styles.d.ts.map

package/dist/render/effects-styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"effects-styles.d.ts","sourceRoot":"","sources":["../../src/render/effects-styles.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAcH,eAAO,MAAM,WAAW,QAoB2E,CAAC"}

package/dist/render/effects-styles.js

@@ -0,0 +1,39 @@
+/**
+ * Effects layer of the emitted stylesheet.
+ *
+ * Atmosphere and feedback shared by every page: a theme-tinted aurora behind the
+ * hero, a word-by-word title reveal, a film-grain page texture, a pointer
+ * spotlight on cards, and a shine on primary buttons. It also carries the window dots, which the terminal and the
+ * frame feature share. Block styles belong in feature sheets, never here.
+ *
+ * Rules: no selector may contain a feature marker (see `verify.ts`); motion is
+ * gated on `prefers-reduced-motion: no-preference`; nothing starts hidden unless
+ * it is already on screen; print drops all of it.
+ */
+const EASE_OUT = 'cubic-bezier(.16,1,.3,1)';
+/** A 160px fractal-noise tile, inlined so the page stays offline and CSP-clean. */
+const GRAIN = `url("data:image/svg+xml,%3Csvg xmlns='http%3A//www.w3.org/2000/svg' width='160' height='160'%3E%3Cfilter id='g'%3E%3CfeTurbulence type='fractalNoise' baseFrequency='.85' numOctaves='3' stitchTiles='stitch'/%3E%3CfeColorMatrix values='0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 .6 0'/%3E%3C/filter%3E%3Crect width='100%25' height='100%25' filter='url(%23g)'/%3E%3C/svg%3E")`;
+/** Title words rise one after another; words past the last step share its delay. */
+const WORD_STEPS = Array.from({ length: 14 }, (_, index) => `.ak-word:nth-child(${index + 1}) > span{animation-delay:${(0.08 + index * 0.055).toFixed(3)}s}`).join('');
+export const EFFECTS_CSS = `::selection{background:color-mix(in srgb,var(--ak-color-accent) 26%,transparent)}
+body{position:relative}
+body::before{content:"";position:absolute;inset:0;z-index:-1;pointer-events:none;background-image:${GRAIN};background-size:160px;opacity:.05}
+.ak-hero{position:relative;isolation:isolate}
+.ak-hero::before{content:"";position:absolute;z-index:-1;top:-40%;right:0;width:min(820px,78%);aspect-ratio:1.3;pointer-events:none;background:radial-gradient(closest-side at 36% 48%,color-mix(in srgb,var(--ak-color-accent) 34%,transparent),transparent),radial-gradient(closest-side at 70% 34%,color-mix(in srgb,var(--ak-color-info) 24%,transparent),transparent),radial-gradient(closest-side at 58% 72%,color-mix(in srgb,var(--ak-color-success) 16%,transparent),transparent);filter:blur(28px);opacity:.8}
+.ak-word{display:inline-block;overflow:hidden;vertical-align:top;padding-bottom:.12em;margin-bottom:-.12em}
+.ak-word > span{display:inline-block}
+@keyframes ak-aurora{50%{transform:translate(-5%,7%) rotate(-5deg) scale(1.07)}}
+@keyframes ak-rise{from{transform:translateY(108%)}to{transform:none}}
+@media (prefers-reduced-motion:no-preference){.ak-hero::before{animation:ak-aurora 18s ease-in-out infinite}.ak-hero > h1:has(.ak-word){animation:none}.ak-word > span{animation:ak-rise calc(var(--ak-motion-duration) * 5.5) ${EASE_OUT} both}${WORD_STEPS}}
+.ak-card,.ak-tile{position:relative;isolation:isolate}
+.ak-card::after,.ak-tile::after{content:"";position:absolute;inset:0;z-index:-1;border-radius:inherit;pointer-events:none;background:radial-gradient(380px circle at var(--ak-mx,50%) var(--ak-my,-60%),color-mix(in srgb,var(--ak-color-accent) 13%,transparent),transparent 70%);opacity:0;transition:opacity calc(var(--ak-motion-duration) * 2) var(--ak-motion-easing)}
+.ak-card:hover::after,.ak-tile:hover::after{opacity:1}
+.ak-btn[data-variant="primary"]{position:relative;isolation:isolate;overflow:hidden}
+.ak-btn[data-variant="primary"]::after{content:"";position:absolute;inset:0;z-index:-1;pointer-events:none;background:linear-gradient(105deg,transparent 30%,color-mix(in srgb,var(--ak-color-accent-contrast) 34%,transparent) 50%,transparent 70%);translate:-110% 0}
+@media (prefers-reduced-motion:no-preference){.ak-btn[data-variant="primary"]::after{transition:translate .9s ${EASE_OUT}}.ak-btn[data-variant="primary"]:hover::after{translate:110% 0}}
+.ak-hero[data-align="center"]{align-items:center;text-align:center}
+.ak-hero[data-align="center"]::before{right:auto;left:50%;translate:-50% 0}
+.ak-window-dots{display:inline-flex;flex:none;gap:6px}
+.ak-window-dots > span{width:10px;height:10px;border-radius:50%;background:currentColor;opacity:.32}
+@media print{body::before,.ak-hero::before{display:none}.ak-word > span{animation:none!important}}`;
+//# sourceMappingURL=effects-styles.js.map

package/dist/render/effects-styles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"effects-styles.js","sourceRoot":"","sources":["../../src/render/effects-styles.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,QAAQ,GAAG,0BAA0B,CAAC;AAE5C,mFAAmF;AACnF,MAAM,KAAK,GAAG,+WAA+W,CAAC;AAE9X,oFAAoF;AACpF,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAC3B,EAAE,MAAM,EAAE,EAAE,EAAE,EACd,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CACX,sBAAsB,KAAK,GAAG,CAAC,4BAA4B,CAAC,IAAI,GAAG,KAAK,GAAG,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CACnG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAEX,MAAM,CAAC,MAAM,WAAW,GAAG;;oGAEyE,KAAK;;;;;;;iOAOwH,QAAQ,SAAS,UAAU;;;;;;gHAM5I,QAAQ;;;;;mGAKrB,CAAC"}

package/dist/render/embedded-fonts.generated.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Generated by scripts/generate-embedded-fonts.mjs from assets/fonts. Do not edit.
+ *
+ * Variable WOFF2 subsets of SIL Open Font License 1.1 fonts, unmodified from
+ * their Fontsource packages. The licence texts ship in assets/fonts/<family>/OFL.txt.
+ */
+export interface EmbeddedFont {
+    /** Namespaced family name a theme font stack refers to. */
+    family: string;
+    /** Upstream family name, for the licence notice. */
+    name: string;
+    /** Variable weight range. */
+    weight: string;
+    copyright: string;
+    /** Base64 WOFF2 data per subset. */
+    latin: string;
+    vietnamese: string;
+}
+export declare const LATIN_RANGE = "U+0000-00FF,U+0131,U+0152-0153,U+02BB-02BC,U+02C6,U+02DA,U+02DC,U+0304,U+0308,U+0329,U+2000-206F,U+20AC,U+2122,U+2191,U+2193,U+2212,U+2215,U+FEFF,U+FFFD";
+export declare const VIETNAMESE_RANGE = "U+0102-0103,U+0110-0111,U+0128-0129,U+0168-0169,U+01A0-01A1,U+01AF-01B0,U+0300-0301,U+0303-0304,U+0308-0309,U+0323,U+0329,U+1EA0-1EF9,U+20AB";
+export declare const EMBEDDED_FONTS: readonly EmbeddedFont[];
+//# sourceMappingURL=embedded-fonts.generated.d.ts.map

package/dist/render/embedded-fonts.generated.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedded-fonts.generated.d.ts","sourceRoot":"","sources":["../../src/render/embedded-fonts.generated.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,YAAY;IAC3B,2DAA2D;IAC3D,MAAM,EAAE,MAAM,CAAC;IACf,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,6BAA6B;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,oCAAoC;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,WAAW,6JAA6J,CAAC;AACtL,eAAO,MAAM,gBAAgB,iJAAiJ,CAAC;AAE/K,eAAO,MAAM,cAAc,EAAE,SAAS,YAAY,EAiDjD,CAAC"}