@bestagentkits/render 0.1.0

package/dist/diagnostics.js

@@ -0,0 +1,57 @@
+/**
+ * Diagnostics: how the compiler reports everything it found wrong.
+ *
+ * A diagnostic always carries a JSON path into the author-facing spec, and a
+ * node ID when the failure belongs to a node that already has one. Callers
+ * branch on `code`; `message` is for humans and may be reworded between
+ * releases.
+ */
+/** Ordered, de-duplicating collector for diagnostics. */
+export class DiagnosticBag {
+    items = [];
+    seen = new Set();
+    add(input) {
+        const key = `${input.code}|${input.path}|${input.message}`;
+        if (this.seen.has(key))
+            return;
+        this.seen.add(key);
+        const diagnostic = {
+            code: input.code,
+            severity: input.severity ?? 'error',
+            message: input.message,
+            path: input.path,
+        };
+        if (input.nodeId !== undefined)
+            diagnostic.nodeId = input.nodeId;
+        if (input.details !== undefined)
+            diagnostic.details = input.details;
+        this.items.push(diagnostic);
+    }
+    get size() {
+        return this.items.length;
+    }
+    get errorCount() {
+        return this.items.filter((item) => item.severity === 'error').length;
+    }
+    get hasErrors() {
+        return this.errorCount > 0;
+    }
+    list() {
+        return [...this.items];
+    }
+    errors() {
+        return this.items.filter((item) => item.severity === 'error');
+    }
+    warnings() {
+        return this.items.filter((item) => item.severity === 'warning');
+    }
+}
+/** Append an index or key to a JSON path. */
+export function pathKey(base, key) {
+    return base === '' ? key : `${base}.${key}`;
+}
+/** Append an array index to a JSON path. */
+export function pathIndex(base, index) {
+    return `${base}[${index}]`;
+}
+//# sourceMappingURL=diagnostics.js.map

package/dist/diagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.js","sourceRoot":"","sources":["../src/diagnostics.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA0BH,yDAAyD;AACzD,MAAM,OAAO,aAAa;IACP,KAAK,GAAiB,EAAE,CAAC;IACzB,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAE1C,GAAG,CAAC,KAAsB;QACxB,MAAM,GAAG,GAAG,GAAG,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QAC3D,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,OAAO;QAC/B,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACnB,MAAM,UAAU,GAAe;YAC7B,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,OAAO;YACnC,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,IAAI,EAAE,KAAK,CAAC,IAAI;SACjB,CAAC;QACF,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS;YAAE,UAAU,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;QACjE,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS;YAAE,UAAU,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;QACpE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC9B,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;IAC3B,CAAC;IAED,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,MAAM,CAAC;IACvE,CAAC;IAED,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC;IAC7B,CAAC;IAED,IAAI;QACF,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC;IAED,MAAM;QACJ,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC;IAChE,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC;IAClE,CAAC;CACF;AAED,6CAA6C;AAC7C,MAAM,UAAU,OAAO,CAAC,IAAY,EAAE,GAAW;IAC/C,OAAO,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,GAAG,EAAE,CAAC;AAC9C,CAAC;AAED,4CAA4C;AAC5C,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,KAAa;IACnD,OAAO,GAAG,IAAI,IAAI,KAAK,GAAG,CAAC;AAC7B,CAAC"}

package/dist/diagram/adapter.d.ts

@@ -0,0 +1,71 @@
+/**
+ * The diagram adapter boundary.
+ *
+ * AK Render does not implement diagram layout. A host that owns a typed diagram
+ * compiler — AgentKit's Engineer installs provide `ak:diagram` — registers an
+ * adapter, and the compiler embeds that adapter's output inside the
+ * `diagram-panel` block. Everything else keeps the structured semantic fallback.
+ *
+ * The boundary is deliberately narrow:
+ *
+ * - The adapter receives the bounded, structurally-opaque diagram spec from the
+ *   Page Spec plus its title. It never receives the page, the theme, or the
+ *   surrounding markup, so it cannot influence anything outside its own figure.
+ * - Whatever the adapter returns is re-checked here. Output that could execute,
+ *   navigate, or frame is rejected and the semantic fallback is emitted instead,
+ *   with a diagnostic. An adapter is trusted code, but "trusted" still means
+ *   "verified before it reaches the artifact".
+ * - The fallback text is always emitted, so the diagram's content is available
+ *   to assistive technology and to a reader whose adapter is not installed.
+ */
+import type { JsonValue } from '../json.js';
+export interface DiagramRenderRequest {
+    /** The diagram spec exactly as authored, bounded by the Page Spec limits. */
+    readonly spec: JsonValue;
+    /** Title from the diagram spec meta or the block, when either declares one. */
+    readonly title: string;
+    /** Stable node id of the owning block, usable for adapter-side cache keys. */
+    readonly nodeId: string;
+    /** Version of the adapter contract this request was built against. */
+    readonly contractVersion: 1;
+}
+export interface DiagramAdapter {
+    /** Stable adapter name, reported in diagnostics. */
+    readonly name: string;
+    /** Adapter version, reported in diagnostics. */
+    readonly version: string;
+    /**
+     * Return trusted markup (an SVG fragment) for the request, or `undefined` to
+     * fall back. Throwing is treated exactly like returning `undefined`: a broken
+     * adapter degrades the page instead of failing the compile.
+     */
+    render(request: DiagramRenderRequest): string | undefined;
+}
+export interface DiagramAdapterResult {
+    readonly markup: string;
+    readonly adapter: string;
+    /** Set when the adapter produced output that the trust boundary rejected. */
+    readonly rejected?: string;
+}
+export declare const DIAGRAM_ADAPTER_CONTRACT_VERSION: 1;
+/** Bound on adapter output, so a runaway adapter cannot inflate the artifact. */
+export declare const MAX_DIAGRAM_MARKUP_BYTES: number;
+export interface AdapterMarkupCheck {
+    readonly ok: boolean;
+    readonly reason?: string;
+}
+/**
+ * Verify adapter output before it is embedded.
+ *
+ * Exported so a host can assert the same contract in its own adapter tests, and
+ * so the check has one implementation rather than one per call site.
+ */
+export declare function checkAdapterMarkup(markup: string): AdapterMarkupCheck;
+/**
+ * Run an adapter and return markup that has passed the trust boundary.
+ *
+ * A `rejected` reason means the adapter answered but its answer was refused; the
+ * caller emits the semantic fallback and records a warning either way.
+ */
+export declare function runDiagramAdapter(adapter: DiagramAdapter | undefined, request: Omit<DiagramRenderRequest, 'contractVersion'>): DiagramAdapterResult | undefined;
+//# sourceMappingURL=adapter.d.ts.map

package/dist/diagram/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../src/diagram/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,MAAM,WAAW,oBAAoB;IACnC,6EAA6E;IAC7E,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,+EAA+E;IAC/E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,8EAA8E;IAC9E,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,sEAAsE;IACtE,QAAQ,CAAC,eAAe,EAAE,CAAC,CAAC;CAC7B;AAED,MAAM,WAAW,cAAc;IAC7B,oDAAoD;IACpD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,gDAAgD;IAChD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB;;;;OAIG;IACH,MAAM,CAAC,OAAO,EAAE,oBAAoB,GAAG,MAAM,GAAG,SAAS,CAAC;CAC3D;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,6EAA6E;IAC7E,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,eAAO,MAAM,gCAAgC,EAAG,CAAU,CAAC;AAE3D,iFAAiF;AACjF,eAAO,MAAM,wBAAwB,QAAa,CAAC;AAuBnD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,kBAAkB,CAWrE;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,cAAc,GAAG,SAAS,EACnC,OAAO,EAAE,IAAI,CAAC,oBAAoB,EAAE,iBAAiB,CAAC,GACrD,oBAAoB,GAAG,SAAS,CAclC"}

package/dist/diagram/adapter.js

@@ -0,0 +1,87 @@
+/**
+ * The diagram adapter boundary.
+ *
+ * AK Render does not implement diagram layout. A host that owns a typed diagram
+ * compiler — AgentKit's Engineer installs provide `ak:diagram` — registers an
+ * adapter, and the compiler embeds that adapter's output inside the
+ * `diagram-panel` block. Everything else keeps the structured semantic fallback.
+ *
+ * The boundary is deliberately narrow:
+ *
+ * - The adapter receives the bounded, structurally-opaque diagram spec from the
+ *   Page Spec plus its title. It never receives the page, the theme, or the
+ *   surrounding markup, so it cannot influence anything outside its own figure.
+ * - Whatever the adapter returns is re-checked here. Output that could execute,
+ *   navigate, or frame is rejected and the semantic fallback is emitted instead,
+ *   with a diagnostic. An adapter is trusted code, but "trusted" still means
+ *   "verified before it reaches the artifact".
+ * - The fallback text is always emitted, so the diagram's content is available
+ *   to assistive technology and to a reader whose adapter is not installed.
+ */
+export const DIAGRAM_ADAPTER_CONTRACT_VERSION = 1;
+/** Bound on adapter output, so a runaway adapter cannot inflate the artifact. */
+export const MAX_DIAGRAM_MARKUP_BYTES = 256 * 1024;
+/**
+ * Vectors that must never appear in adapter output.
+ *
+ * This is the same posture the page itself takes: no script, no frame, no
+ * plugin, no inline handler, no navigable scheme, and no SVG escape hatch back
+ * into HTML.
+ */
+const FORBIDDEN_ADAPTER_PATTERNS = [
+    { pattern: /<script/iu, reason: 'script element' },
+    { pattern: /<iframe/iu, reason: 'iframe element' },
+    { pattern: /<object/iu, reason: 'object element' },
+    { pattern: /<embed/iu, reason: 'embed element' },
+    { pattern: /<foreignObject/iu, reason: 'foreignObject element' },
+    { pattern: /<base/iu, reason: 'base element' },
+    { pattern: /<form/iu, reason: 'form element' },
+    { pattern: /\bsrcdoc\s*=/iu, reason: 'srcdoc attribute' },
+    { pattern: /\son[a-z]+\s*=/iu, reason: 'inline event handler' },
+    { pattern: /javascript\s*:/iu, reason: 'javascript: URL' },
+    { pattern: /\bdata\s*:\s*text\/html/iu, reason: 'data: text/html URL' },
+];
+/**
+ * Verify adapter output before it is embedded.
+ *
+ * Exported so a host can assert the same contract in its own adapter tests, and
+ * so the check has one implementation rather than one per call site.
+ */
+export function checkAdapterMarkup(markup) {
+    if (typeof markup !== 'string' || markup.trim() === '') {
+        return { ok: false, reason: 'empty output' };
+    }
+    if (markup.length > MAX_DIAGRAM_MARKUP_BYTES) {
+        return { ok: false, reason: `output exceeds ${MAX_DIAGRAM_MARKUP_BYTES} bytes` };
+    }
+    for (const { pattern, reason } of FORBIDDEN_ADAPTER_PATTERNS) {
+        if (pattern.test(markup))
+            return { ok: false, reason };
+    }
+    return { ok: true };
+}
+/**
+ * Run an adapter and return markup that has passed the trust boundary.
+ *
+ * A `rejected` reason means the adapter answered but its answer was refused; the
+ * caller emits the semantic fallback and records a warning either way.
+ */
+export function runDiagramAdapter(adapter, request) {
+    if (adapter === undefined)
+        return undefined;
+    let markup;
+    try {
+        markup = adapter.render({ ...request, contractVersion: DIAGRAM_ADAPTER_CONTRACT_VERSION });
+    }
+    catch {
+        return { markup: '', adapter: adapter.name, rejected: 'adapter threw' };
+    }
+    if (markup === undefined)
+        return undefined;
+    const check = checkAdapterMarkup(markup);
+    if (!check.ok) {
+        return { markup: '', adapter: adapter.name, rejected: check.reason ?? 'rejected' };
+    }
+    return { markup, adapter: adapter.name };
+}
+//# sourceMappingURL=adapter.js.map

package/dist/diagram/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../src/diagram/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAmCH,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAU,CAAC;AAE3D,iFAAiF;AACjF,MAAM,CAAC,MAAM,wBAAwB,GAAG,GAAG,GAAG,IAAI,CAAC;AAEnD;;;;;;GAMG;AACH,MAAM,0BAA0B,GAAmD;IACjF,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,gBAAgB,EAAE;IAClD,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,gBAAgB,EAAE;IAClD,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,gBAAgB,EAAE;IAClD,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,eAAe,EAAE;IAChD,EAAE,OAAO,EAAE,kBAAkB,EAAE,MAAM,EAAE,uBAAuB,EAAE;IAChE,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE;IAC9C,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE;IAC9C,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,EAAE,kBAAkB,EAAE;IACzD,EAAE,OAAO,EAAE,kBAAkB,EAAE,MAAM,EAAE,sBAAsB,EAAE;IAC/D,EAAE,OAAO,EAAE,kBAAkB,EAAE,MAAM,EAAE,iBAAiB,EAAE;IAC1D,EAAE,OAAO,EAAE,2BAA2B,EAAE,MAAM,EAAE,qBAAqB,EAAE;CACxE,CAAC;AAOF;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAc;IAC/C,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACvD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC;IAC/C,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,GAAG,wBAAwB,EAAE,CAAC;QAC7C,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,kBAAkB,wBAAwB,QAAQ,EAAE,CAAC;IACnF,CAAC;IACD,KAAK,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,0BAA0B,EAAE,CAAC;QAC7D,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC;YAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IACzD,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;AACtB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAC/B,OAAmC,EACnC,OAAsD;IAEtD,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC5C,IAAI,MAA0B,CAAC;IAC/B,IAAI,CAAC;QACH,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,EAAE,GAAG,OAAO,EAAE,eAAe,EAAE,gCAAgC,EAAE,CAAC,CAAC;IAC7F,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC1E,CAAC;IACD,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC3C,MAAM,KAAK,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;IACzC,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;QACd,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,CAAC,MAAM,IAAI,UAAU,EAAE,CAAC;IACrF,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC;AAC3C,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Stable error surface for the compiler.
+ *
+ * Every failure an author can trigger is reported as a `RenderError` with a
+ * machine-readable `code` and, where the failure belongs to a spec location,
+ * a JSON path and normalized node ID. Callers (CLI, worker, skills) branch on
+ * `code`; they must not parse message text.
+ */
+export type RenderErrorCode = 'SPEC_PARSE_ERROR' | 'SPEC_VALIDATION_ERROR' | 'SPEC_BOUNDS_ERROR' | 'SPEC_UNKNOWN_BLOCK' | 'POLICY_VIOLATION' | 'INTERNAL_ERROR';
+export interface RenderErrorOptions {
+    /** JSON path of the offending value, e.g. `blocks[2].items[0].url`. */
+    path?: string | undefined;
+    /** Normalized node ID when the failure is attached to a node. */
+    nodeId?: string | undefined;
+    /** Non-sensitive structured detail for logs and JSON output. */
+    details?: Record<string, unknown> | undefined;
+    cause?: unknown;
+}
+export declare class RenderError extends Error {
+    readonly code: RenderErrorCode;
+    readonly path: string | undefined;
+    readonly nodeId: string | undefined;
+    readonly details: Record<string, unknown> | undefined;
+    constructor(code: RenderErrorCode, message: string, options?: RenderErrorOptions);
+    /** JSON-safe representation used by `--json` CLI output and the cloud API. */
+    toJSON(): {
+        name: string;
+        code: RenderErrorCode;
+        message: string;
+        path?: string;
+        nodeId?: string;
+        details?: Record<string, unknown>;
+    };
+}
+/** Narrow an unknown thrown value to a `RenderError`. */
+export declare function isRenderError(value: unknown): value is RenderError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,MAAM,eAAe,GACvB,kBAAkB,GAClB,uBAAuB,GACvB,mBAAmB,GACnB,oBAAoB,GACpB,kBAAkB,GAClB,gBAAgB,CAAC;AAErB,MAAM,WAAW,kBAAkB;IACjC,uEAAuE;IACvE,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,iEAAiE;IACjE,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IAC9C,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,qBAAa,WAAY,SAAQ,KAAK;IACpC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;gBAE1C,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB;IASpF,8EAA8E;IAC9E,MAAM,IAAI;QACR,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,eAAe,CAAC;QACtB,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACnC;CAWF;AAED,yDAAyD;AACzD,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAElE"}

package/dist/errors.js

@@ -0,0 +1,42 @@
+/**
+ * Stable error surface for the compiler.
+ *
+ * Every failure an author can trigger is reported as a `RenderError` with a
+ * machine-readable `code` and, where the failure belongs to a spec location,
+ * a JSON path and normalized node ID. Callers (CLI, worker, skills) branch on
+ * `code`; they must not parse message text.
+ */
+export class RenderError extends Error {
+    code;
+    path;
+    nodeId;
+    details;
+    constructor(code, message, options = {}) {
+        super(message, options.cause === undefined ? undefined : { cause: options.cause });
+        this.name = 'RenderError';
+        this.code = code;
+        this.path = options.path;
+        this.nodeId = options.nodeId;
+        this.details = options.details;
+    }
+    /** JSON-safe representation used by `--json` CLI output and the cloud API. */
+    toJSON() {
+        const payload = {
+            name: this.name,
+            code: this.code,
+            message: this.message,
+        };
+        if (this.path !== undefined)
+            payload.path = this.path;
+        if (this.nodeId !== undefined)
+            payload.nodeId = this.nodeId;
+        if (this.details !== undefined)
+            payload.details = this.details;
+        return payload;
+    }
+}
+/** Narrow an unknown thrown value to a `RenderError`. */
+export function isRenderError(value) {
+    return value instanceof RenderError;
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAoBH,MAAM,OAAO,WAAY,SAAQ,KAAK;IAC3B,IAAI,CAAkB;IACtB,IAAI,CAAqB;IACzB,MAAM,CAAqB;IAC3B,OAAO,CAAsC;IAEtD,YAAY,IAAqB,EAAE,OAAe,EAAE,UAA8B,EAAE;QAClF,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;QACnF,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QACzB,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IACjC,CAAC;IAED,8EAA8E;IAC9E,MAAM;QAQJ,MAAM,OAAO,GAAsC;YACjD,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAC;QACF,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS;YAAE,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtD,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS;YAAE,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC5D,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS;YAAE,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAC/D,OAAO,OAAO,CAAC;IACjB,CAAC;CACF;AAED,yDAAyD;AACzD,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,OAAO,KAAK,YAAY,WAAW,CAAC;AACtC,CAAC"}

package/dist/hash.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Deterministic, platform-neutral content hashing.
+ *
+ * Used to derive stable node IDs. Deliberately not `node:crypto`: the same
+ * compiler code runs in a CLI, in a library caller, and inside a Cloudflare
+ * Worker, and node IDs only need to be stable and collision-resistant, not
+ * cryptographically secure. Output is identical on every platform because the
+ * arithmetic is 32-bit integer math.
+ */
+/** FNV-1a style 64-bit hash rendered as 14 base36 characters. */
+export declare function stableHash(input: string): string;
+/** A node ID derived from content identity. */
+export declare function derivedNodeId(type: string, path: string): string;
+//# sourceMappingURL=hash.d.ts.map

package/dist/hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../src/hash.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,iEAAiE;AACjE,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAWhD;AAED,+CAA+C;AAC/C,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhE"}

package/dist/hash.js

@@ -0,0 +1,27 @@
+/**
+ * Deterministic, platform-neutral content hashing.
+ *
+ * Used to derive stable node IDs. Deliberately not `node:crypto`: the same
+ * compiler code runs in a CLI, in a library caller, and inside a Cloudflare
+ * Worker, and node IDs only need to be stable and collision-resistant, not
+ * cryptographically secure. Output is identical on every platform because the
+ * arithmetic is 32-bit integer math.
+ */
+/** FNV-1a style 64-bit hash rendered as 14 base36 characters. */
+export function stableHash(input) {
+    let high = 0x811c9dc5;
+    let low = 0x01000193;
+    for (let index = 0; index < input.length; index += 1) {
+        const code = input.charCodeAt(index);
+        high ^= code;
+        high = Math.imul(high, 16777619) >>> 0;
+        low = (low + code) >>> 0;
+        low = Math.imul(low ^ (low >>> 13), 2246822519) >>> 0;
+    }
+    return `${high.toString(36).padStart(7, '0')}${low.toString(36).padStart(7, '0')}`;
+}
+/** A node ID derived from content identity. */
+export function derivedNodeId(type, path) {
+    return `n-${stableHash(`${type}|${path}`).slice(0, 10)}`;
+}
+//# sourceMappingURL=hash.js.map

package/dist/hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.js","sourceRoot":"","sources":["../src/hash.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,iEAAiE;AACjE,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,IAAI,IAAI,GAAG,UAAU,CAAC;IACtB,IAAI,GAAG,GAAG,UAAU,CAAC;IACrB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACrD,MAAM,IAAI,GAAG,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QACrC,IAAI,IAAI,IAAI,CAAC;QACb,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;QACvC,GAAG,GAAG,CAAC,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;QACzB,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC;IACxD,CAAC;IACD,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;AACrF,CAAC;AAED,+CAA+C;AAC/C,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,IAAY;IACtD,OAAO,KAAK,UAAU,CAAC,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;AAC3D,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,43 @@
+/**
+ * `@bestagentkits/render` public library surface.
+ *
+ * Additions here are additive and versioned; see `docs/release-policy.md` for
+ * what a minor and a major release promise. Functions that are not implemented
+ * yet are not exported — the package never advertises a scaffold.
+ */
+export type { Diagnostic, DiagnosticSeverity } from './diagnostics.js';
+export type { AdapterMarkupCheck, DiagramAdapter, DiagramAdapterResult, DiagramRenderRequest, } from './diagram/adapter.js';
+export { checkAdapterMarkup, DIAGRAM_ADAPTER_CONTRACT_VERSION, MAX_DIAGRAM_MARKUP_BYTES, runDiagramAdapter, } from './diagram/adapter.js';
+export type { RenderErrorCode, RenderErrorOptions } from './errors.js';
+export { isRenderError, RenderError } from './errors.js';
+export type { IrDocument, IrNode, IrTheme, NetworkPolicy } from './ir.js';
+export type { JsonValue } from './json.js';
+export type { ActionDefinition, ActionType } from './registry/actions.js';
+export { ACTION_DEFINITIONS, ALLOWED_EVENTS, listActionTypes } from './registry/actions.js';
+export type { Catalog, CatalogEntry } from './registry/registry.js';
+export { blockTypes, buildPageSpecJsonSchema, catalog, describe, getBlockDefinition, SPEC_SCHEMA_VERSION, } from './registry/registry.js';
+export type { BlockDefinition, SizingContract, SlotSpec } from './registry/roster.js';
+export { buildContentSecurityPolicy } from './render/document.js';
+export { escapeAttribute, escapeText, escapeUrl, serializeJsonForScript } from './render/escape.js';
+export type { CompileResult, RenderOptions } from './render/render.js';
+export { compile, render } from './render/render.js';
+export type { BoundsReport } from './spec/bounds.js';
+export { LIMITS } from './spec/bounds.js';
+export { CURRENT_SPEC_VERSION, supportedVersions } from './spec/migrate.js';
+export type { NormalizeResult } from './spec/normalize.js';
+export { normalize, normalizeSpec } from './spec/normalize.js';
+export type { ParseOptions } from './spec/parse.js';
+export { parseSpec } from './spec/parse.js';
+export type { EmbedProvider } from './spec/providers.js';
+export { EMBED_PROVIDER_NAMES, EMBED_PROVIDERS, hostMatchesAnyProvider, hostMatchesProvider, isEmbedProvider, } from './spec/providers.js';
+export type { ValidateResult, ValidateSummary } from './spec/validate.js';
+export { validate, validateOrThrow } from './spec/validate.js';
+export type { LoadThemeOptions, ResolvedTheme, ThemeInput } from './theme/load-theme.js';
+export { loadTheme, resolveTheme, themeDiagnostics, themePresetNames } from './theme/load-theme.js';
+export type { PresetEntry } from './theme/presets.js';
+export type { PresetSource, ThemeCatalog, ThemeCatalogOptions } from './theme/theme-catalog.js';
+export { buildThemeCatalog, builtinThemeCatalog, catalogPresetNames, loadPresetFile, parsePresetDocument, themeSearchDirectories, } from './theme/theme-catalog.js';
+export type { TokenSpec } from './theme/tokens.js';
+export { TOKEN_SPECS, tokenNames } from './theme/tokens.js';
+export { PACKAGE_NAME, VERSION } from './version.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,25 @@
+/**
+ * `@bestagentkits/render` public library surface.
+ *
+ * Additions here are additive and versioned; see `docs/release-policy.md` for
+ * what a minor and a major release promise. Functions that are not implemented
+ * yet are not exported — the package never advertises a scaffold.
+ */
+export { checkAdapterMarkup, DIAGRAM_ADAPTER_CONTRACT_VERSION, MAX_DIAGRAM_MARKUP_BYTES, runDiagramAdapter, } from './diagram/adapter.js';
+export { isRenderError, RenderError } from './errors.js';
+export { ACTION_DEFINITIONS, ALLOWED_EVENTS, listActionTypes } from './registry/actions.js';
+export { blockTypes, buildPageSpecJsonSchema, catalog, describe, getBlockDefinition, SPEC_SCHEMA_VERSION, } from './registry/registry.js';
+export { buildContentSecurityPolicy } from './render/document.js';
+export { escapeAttribute, escapeText, escapeUrl, serializeJsonForScript } from './render/escape.js';
+export { compile, render } from './render/render.js';
+export { LIMITS } from './spec/bounds.js';
+export { CURRENT_SPEC_VERSION, supportedVersions } from './spec/migrate.js';
+export { normalize, normalizeSpec } from './spec/normalize.js';
+export { parseSpec } from './spec/parse.js';
+export { EMBED_PROVIDER_NAMES, EMBED_PROVIDERS, hostMatchesAnyProvider, hostMatchesProvider, isEmbedProvider, } from './spec/providers.js';
+export { validate, validateOrThrow } from './spec/validate.js';
+export { loadTheme, resolveTheme, themeDiagnostics, themePresetNames } from './theme/load-theme.js';
+export { buildThemeCatalog, builtinThemeCatalog, catalogPresetNames, loadPresetFile, parsePresetDocument, themeSearchDirectories, } from './theme/theme-catalog.js';
+export { TOKEN_SPECS, tokenNames } from './theme/tokens.js';
+export { PACKAGE_NAME, VERSION } from './version.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AASH,OAAO,EACL,kBAAkB,EAClB,gCAAgC,EAChC,wBAAwB,EACxB,iBAAiB,GAClB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAIzD,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE5F,OAAO,EACL,UAAU,EACV,uBAAuB,EACvB,OAAO,EACP,QAAQ,EACR,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,SAAS,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAEpG,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE5E,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAE/D,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,EACL,oBAAoB,EACpB,eAAe,EACf,sBAAsB,EACtB,mBAAmB,EACnB,eAAe,GAChB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE/D,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAGpG,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,cAAc,EACd,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC"}

package/dist/internal/yaml-error.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Narrow typing for the `yaml` package's error shape.
+ * The package exposes line/column on a `YAMLParseError`; this keeps the
+ * dependency's error type out of the public surface.
+ */
+export interface YamlErrorLike {
+    message: string;
+    linePos: {
+        line: number;
+        col: number;
+    }[];
+}
+export declare function isNumberedError(value: unknown): value is YamlErrorLike;
+//# sourceMappingURL=yaml-error.d.ts.map

package/dist/internal/yaml-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml-error.d.ts","sourceRoot":"","sources":["../../src/internal/yaml-error.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC1C;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAItE"}

package/dist/internal/yaml-error.js

@@ -0,0 +1,12 @@
+/**
+ * Narrow typing for the `yaml` package's error shape.
+ * The package exposes line/column on a `YAMLParseError`; this keeps the
+ * dependency's error type out of the public surface.
+ */
+export function isNumberedError(value) {
+    if (!(value instanceof Error))
+        return false;
+    const candidate = value;
+    return Array.isArray(candidate.linePos);
+}
+//# sourceMappingURL=yaml-error.js.map

package/dist/internal/yaml-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml-error.js","sourceRoot":"","sources":["../../src/internal/yaml-error.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,IAAI,CAAC,CAAC,KAAK,YAAY,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC5C,MAAM,SAAS,GAAG,KAAyC,CAAC;IAC5D,OAAO,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;AAC1C,CAAC"}

package/dist/ir.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Internal IR.
+ *
+ * The IR is what the renderer consumes and what future diff/patch/editor
+ * tooling will operate on. It is compiler-versioned, not a public schema:
+ * the Page Spec is the compatibility boundary, and the IR may change without a
+ * spec migration.
+ */
+import type { Diagnostic } from './diagnostics.js';
+import type { JsonValue } from './json.js';
+import type { RuntimeFeature } from './registry/roster.js';
+import type { BindingMap } from './spec/bindings.js';
+export interface IrNode {
+    /** Stable node ID: author-provided when present, otherwise content-derived. */
+    id: string;
+    type: string;
+    typeVersion: number;
+    kind: 'semantic' | 'primitive';
+    /** JSON path of this block in the author-facing spec. */
+    path: string;
+    parentId: string | null;
+    depth: number;
+    /** Validated props with defaults applied, verbatim from the spec otherwise. */
+    props: Record<string, JsonValue>;
+    /** Normalized declarative action bindings, keyed by event. */
+    bindings: BindingMap;
+    /** Child node IDs, in authored order. */
+    children: string[];
+    /** Accessibility contract inherited from the block definition. */
+    a11y: string;
+    runtimeFeatures: RuntimeFeature[];
+    assets: string[];
+    network: 'none' | 'optional';
+}
+/**
+ * `deny` is the default. An allow list opts into named capabilities, and an
+ * optional provider list narrows remote media to that provider's own hosts.
+ */
+export type NetworkPolicy = 'deny' | {
+    allow: string[];
+    providers?: string[];
+};
+export interface IrMeta {
+    title: string;
+    description?: string;
+    locale: string;
+    slug?: string;
+}
+export interface IrTheme {
+    preset: string;
+    extends?: string;
+    tokens?: JsonValue;
+}
+export interface IrDocument {
+    /** Version of the IR shape itself. */
+    irVersion: 1;
+    /** Page Spec schema version the document was normalized from. */
+    specVersion: number;
+    /** Compiler version that produced this IR. */
+    compilerVersion: string;
+    meta: IrMeta;
+    theme: IrTheme;
+    policy: {
+        network: NetworkPolicy;
+    };
+    state: Record<string, JsonValue>;
+    rootId: string;
+    /** All nodes in deterministic depth-first pre-order, root first. */
+    nodes: IrNode[];
+    /** Non-fatal diagnostics (deprecations, skipped heading levels, and similar). */
+    warnings: Diagnostic[];
+}
+/** Index nodes by ID for O(1) lookup by the renderer. */
+export declare function indexNodes(ir: IrDocument): Map<string, IrNode>;
+/** Direct children of a node, in authored order. */
+export declare function childrenOf(ir: IrDocument, node: IrNode): IrNode[];
+//# sourceMappingURL=ir.d.ts.map

package/dist/ir.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ir.d.ts","sourceRoot":"","sources":["../src/ir.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,MAAM,WAAW,MAAM;IACrB,+EAA+E;IAC/E,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,UAAU,GAAG,WAAW,CAAC;IAC/B,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,+EAA+E;IAC/E,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACjC,8DAA8D;IAC9D,QAAQ,EAAE,UAAU,CAAC;IACrB,yCAAyC;IACzC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,kEAAkE;IAClE,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,EAAE,cAAc,EAAE,CAAC;IAClC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,EAAE,MAAM,GAAG,UAAU,CAAC;CAC9B;AAED;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAE/E,MAAM,WAAW,MAAM;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,OAAO;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,sCAAsC;IACtC,SAAS,EAAE,CAAC,CAAC;IACb,iEAAiE;IACjE,WAAW,EAAE,MAAM,CAAC;IACpB,8CAA8C;IAC9C,eAAe,EAAE,MAAM,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE;QAAE,OAAO,EAAE,aAAa,CAAA;KAAE,CAAC;IACnC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,oEAAoE;IACpE,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,iFAAiF;IACjF,QAAQ,EAAE,UAAU,EAAE,CAAC;CACxB;AAED,yDAAyD;AACzD,wBAAgB,UAAU,CAAC,EAAE,EAAE,UAAU,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAE9D;AAED,oDAAoD;AACpD,wBAAgB,UAAU,CAAC,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAKjE"}

package/dist/ir.js

@@ -0,0 +1,20 @@
+/**
+ * Internal IR.
+ *
+ * The IR is what the renderer consumes and what future diff/patch/editor
+ * tooling will operate on. It is compiler-versioned, not a public schema:
+ * the Page Spec is the compatibility boundary, and the IR may change without a
+ * spec migration.
+ */
+/** Index nodes by ID for O(1) lookup by the renderer. */
+export function indexNodes(ir) {
+    return new Map(ir.nodes.map((node) => [node.id, node]));
+}
+/** Direct children of a node, in authored order. */
+export function childrenOf(ir, node) {
+    const byId = indexNodes(ir);
+    return node.children
+        .map((id) => byId.get(id))
+        .filter((child) => child !== undefined);
+}
+//# sourceMappingURL=ir.js.map

package/dist/ir.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ir.js","sourceRoot":"","sources":["../src/ir.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAmEH,yDAAyD;AACzD,MAAM,UAAU,UAAU,CAAC,EAAc;IACvC,OAAO,IAAI,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;AAC1D,CAAC;AAED,oDAAoD;AACpD,MAAM,UAAU,UAAU,CAAC,EAAc,EAAE,IAAY;IACrD,MAAM,IAAI,GAAG,UAAU,CAAC,EAAE,CAAC,CAAC;IAC5B,OAAO,IAAI,CAAC,QAAQ;SACjB,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;SACzB,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC;AAC7D,CAAC"}

package/dist/json.d.ts

@@ -0,0 +1,23 @@
+/**
+ * JSON value model and canonical serialization.
+ *
+ * Canonical serialization is a determinism primitive: stable node IDs and
+ * determinism hashes are derived from it, so key order must not depend on how a
+ * document happened to be written.
+ */
+export type JsonPrimitive = string | number | boolean | null;
+export type JsonValue = JsonPrimitive | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+/** True for a plain object (not an array, not null). */
+export declare function isPlainObject(value: unknown): value is Record<string, unknown>;
+/** True for any JSON-serializable value. */
+export declare function isJsonValue(value: unknown): value is JsonValue;
+/**
+ * Serialize a JSON value with object keys sorted lexicographically.
+ *
+ * Used for content hashes, never for emitted HTML: emitted output uses the
+ * spec's own ordering where ordering is meaningful to a reader.
+ */
+export declare function canonicalStringify(value: JsonValue): string;
+//# sourceMappingURL=json.d.ts.map

package/dist/json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../src/json.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;AAC7D,MAAM,MAAM,SAAS,GAAG,aAAa,GAAG,SAAS,EAAE,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAEnF,wDAAwD;AACxD,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAE9E;AAED,4CAA4C;AAC5C,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,SAAS,CAQ9D;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAc3D"}