@kohaku-ui/renderer-wc 0.1.0

package/dist/parts/text.js

@@ -0,0 +1,72 @@
+import { parseMarkdownBlocks } from "@kohaku-ui/renderer-core";
+import { el, text } from "../dom.js";
+import { tokenStr } from "./kit.js";
+/** text.heading — a heading (same markup as renderer-react's TextHeading). */
+export const textHeading = (rt, parent, node) => {
+    const level = Math.min(6, Math.max(1, node.props["level"] ?? 2));
+    const color = tokenStr(rt, "color.text");
+    const heading = el(`h${level}`, { "data-kohaku": node.id }, { margin: 0, color, fontWeight: 650, lineHeight: 1.3 });
+    heading.appendChild(text(String(node.props["text"] ?? "")));
+    parent.appendChild(heading);
+    return () => heading.remove();
+};
+/**
+ * presentMarkdown — zero-dependency rendering of a Markdown subset (same as renderer-react's PresentMarkdown).
+ * The AST is shared via renderer-core's parseMarkdownBlocks / parseMarkdownInline (empty text segments are also preserved).
+ */
+export const presentMarkdown = (rt, parent, node) => {
+    const markdown = String(node.props["markdown"] ?? "");
+    const color = tokenStr(rt, "color.text");
+    const muted = tokenStr(rt, "color.muted");
+    const surface = tokenStr(rt, "color.surface");
+    const container = el("div", { "data-kohaku": node.id }, { color, fontSize: 14, lineHeight: 1.7 });
+    for (const block of parseMarkdownBlocks(markdown)) {
+        if (block.type === "code") {
+            const pre = el("pre", {}, { background: surface, borderRadius: 6, padding: "10px 12px", overflowX: "auto", fontSize: 12.5 });
+            const code = el("code");
+            code.appendChild(text(block.code));
+            pre.appendChild(code);
+            container.appendChild(pre);
+        }
+        else if (block.type === "heading") {
+            const h = el(`h${block.level}`, {}, { margin: "8px 0 4px", fontWeight: 650 });
+            appendInline(h, block.inline, surface);
+            container.appendChild(h);
+        }
+        else if (block.type === "list") {
+            const ul = el("ul", {}, { margin: "4px 0", paddingLeft: 20 });
+            for (const item of block.items) {
+                const li = el("li");
+                appendInline(li, item, surface);
+                ul.appendChild(li);
+            }
+            container.appendChild(ul);
+        }
+        else {
+            const p = el("p", {}, { margin: "4px 0", ...(block.muted ? { color: muted } : {}) });
+            appendInline(p, block.inline, surface);
+            container.appendChild(p);
+        }
+    }
+    parent.appendChild(container);
+    return () => container.remove();
+};
+/** Flows the inline AST into an element (emits a node even for empty text to keep textContent matching). */
+function appendInline(host, inline, surface) {
+    for (const part of inline) {
+        if (part.type === "code") {
+            const code = el("code", {}, { background: surface, borderRadius: 4, padding: "1px 5px", fontSize: 12.5 });
+            code.appendChild(text(part.text));
+            host.appendChild(code);
+        }
+        else if (part.type === "strong") {
+            const strong = el("strong");
+            strong.appendChild(text(part.text));
+            host.appendChild(strong);
+        }
+        else {
+            host.appendChild(text(part.text));
+        }
+    }
+}
+//# sourceMappingURL=text.js.map

package/dist/parts/text.js.map

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

package/dist/registry.d.ts

@@ -0,0 +1,8 @@
+import type { PartBuilder } from "./types.js";
+/**
+ * DOM builder table for core-catalog parts (the counterpart to renderer-react's createCoreRegistry).
+ * type → PartBuilder. <kohaku-surface> uses this table to detect unknown types and emits a placeholder if absent.
+ * sandbox.html is handled not by the registry but directly by tree.ts via rt.mountSandbox (equivalent to renderSandbox).
+ */
+export declare function createCoreRenderRegistry(): Map<string, PartBuilder>;
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;;;GAIG;AACH,wBAAgB,wBAAwB,IAAI,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAmBnE"}

package/dist/registry.js

@@ -0,0 +1,38 @@
+import { actionButton } from "./parts/action-button.js";
+import { presentChart } from "./parts/chart.js";
+import { controlSelect } from "./parts/control-select.js";
+import { presentForm } from "./parts/form.js";
+import { layoutGrid, layoutStack } from "./parts/layout.js";
+import { presentList } from "./parts/list.js";
+import { uiLoading } from "./parts/loading.js";
+import { presentMetric } from "./parts/metric.js";
+import { overlayDialog, overlayToast } from "./parts/overlay.js";
+import { presentSpreadsheet } from "./parts/spreadsheet.js";
+import { layoutTab, layoutTabs } from "./parts/tabs.js";
+import { presentMarkdown, textHeading } from "./parts/text.js";
+/**
+ * DOM builder table for core-catalog parts (the counterpart to renderer-react's createCoreRegistry).
+ * type → PartBuilder. <kohaku-surface> uses this table to detect unknown types and emits a placeholder if absent.
+ * sandbox.html is handled not by the registry but directly by tree.ts via rt.mountSandbox (equivalent to renderSandbox).
+ */
+export function createCoreRenderRegistry() {
+    return new Map([
+        ["layout.stack", layoutStack],
+        ["layout.grid", layoutGrid],
+        ["layout.tabs", layoutTabs],
+        ["layout.tab", layoutTab],
+        ["text.heading", textHeading],
+        ["presentMarkdown", presentMarkdown],
+        ["presentChart", presentChart],
+        ["presentMetric", presentMetric],
+        ["presentSpreadsheet", presentSpreadsheet],
+        ["presentList", presentList],
+        ["presentForm", presentForm],
+        ["action.button", actionButton],
+        ["control.select", controlSelect],
+        ["ui.loading", uiLoading],
+        ["overlay.dialog", overlayDialog],
+        ["overlay.toast", overlayToast],
+    ]);
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAG/D;;;;GAIG;AACH,MAAM,UAAU,wBAAwB;IACtC,OAAO,IAAI,GAAG,CAAsB;QAClC,CAAC,cAAc,EAAE,WAAW,CAAC;QAC7B,CAAC,aAAa,EAAE,UAAU,CAAC;QAC3B,CAAC,aAAa,EAAE,UAAU,CAAC;QAC3B,CAAC,YAAY,EAAE,SAAS,CAAC;QACzB,CAAC,cAAc,EAAE,WAAW,CAAC;QAC7B,CAAC,iBAAiB,EAAE,eAAe,CAAC;QACpC,CAAC,cAAc,EAAE,YAAY,CAAC;QAC9B,CAAC,eAAe,EAAE,aAAa,CAAC;QAChC,CAAC,oBAAoB,EAAE,kBAAkB,CAAC;QAC1C,CAAC,aAAa,EAAE,WAAW,CAAC;QAC5B,CAAC,aAAa,EAAE,WAAW,CAAC;QAC5B,CAAC,eAAe,EAAE,YAAY,CAAC;QAC/B,CAAC,gBAAgB,EAAE,aAAa,CAAC;QACjC,CAAC,YAAY,EAAE,SAAS,CAAC;QACzB,CAAC,gBAAgB,EAAE,aAAa,CAAC;QACjC,CAAC,eAAe,EAAE,YAAY,CAAC;KAChC,CAAC,CAAC;AACL,CAAC"}

package/dist/sandbox-mount.d.ts

@@ -0,0 +1,10 @@
+import type { ComponentNode } from "@kohaku-ui/spec-core";
+import type { RenderRuntime, Teardown } from "./types.js";
+/**
+ * WC wrapper for the sandbox.html node (equivalent to renderer-react's SandboxFrame; a ~30-line bridge).
+ * mountSandbox is already raw-DOM and framework-free, so it is called directly against the container inside the shadow root.
+ * The capability token stays with the parent of ctx.sandbox.bridge and never enters the iframe (reusing the sandbox design unmodified).
+ * Bridges the invalidation-bus subscription to SandboxHandle.invalidate, conveying the write loop's data invalidation to the guest.
+ */
+export declare function mountSandboxNode(rt: RenderRuntime, parent: ParentNode, node: ComponentNode): Teardown;
+//# sourceMappingURL=sandbox-mount.d.ts.map

package/dist/sandbox-mount.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox-mount.d.ts","sourceRoot":"","sources":["../src/sandbox-mount.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE1D;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,aAAa,GAAG,QAAQ,CAiErG"}

package/dist/sandbox-mount.js

@@ -0,0 +1,73 @@
+import { sandboxArtifactMissingText, sandboxBadgeDescriptionStyle, sandboxBadgeDescriptionText, sandboxBadgePillStyle, sandboxBadgeRowStyle, sandboxBadgeText, sandboxBridgeMissingText, sandboxErrorNoticeText, sandboxLoadingNoticeText, sandboxNoticeBaseStyle, sandboxNoticeToneStyle, } from "@kohaku-ui/renderer-core";
+import { mountSandbox } from "@kohaku-ui/sandbox";
+import { el, noop, text } from "./dom.js";
+/**
+ * WC wrapper for the sandbox.html node (equivalent to renderer-react's SandboxFrame; a ~30-line bridge).
+ * mountSandbox is already raw-DOM and framework-free, so it is called directly against the container inside the shadow root.
+ * The capability token stays with the parent of ctx.sandbox.bridge and never enters the iframe (reusing the sandbox design unmodified).
+ * Bridges the invalidation-bus subscription to SandboxHandle.invalidate, conveying the write loop's data invalidation to the guest.
+ */
+export function mountSandboxNode(rt, parent, node) {
+    const wrapper = el("div", { "data-kohaku": node.id }, { width: "100%" });
+    parent.appendChild(wrapper);
+    const messages = rt.messages;
+    const artifact = node.artifact;
+    if (artifact?.inline == null) {
+        wrapper.appendChild(notice("error", sandboxArtifactMissingText(messages)));
+        return noop;
+    }
+    if (rt.sandbox == null) {
+        wrapper.appendChild(notice("error", sandboxBridgeMissingText(node.type, messages)));
+        return noop;
+    }
+    // L2 badge (makes it explicit that isolated execution is in progress). Same wording as renderer-react
+    // (both consume renderer-core's sandbox-chrome presenter, the single source of truth).
+    const badgeRow = el("div", {}, sandboxBadgeRowStyle);
+    const badge = el("span", {}, sandboxBadgePillStyle);
+    badge.appendChild(text(sandboxBadgeText(messages)));
+    const badgeNote = el("span", {}, sandboxBadgeDescriptionStyle);
+    badgeNote.appendChild(text(sandboxBadgeDescriptionText(messages)));
+    badgeRow.append(badge, badgeNote);
+    const statusHolder = el("div", {}, { width: "100%" });
+    const container = el("div", {}, { width: "100%" });
+    wrapper.append(badgeRow, statusHolder, container);
+    const allowedEvents = rt.spec.events
+        .filter((e) => e.on.startsWith(`${node.id}.`))
+        .map((e) => e.on.slice(node.id.length + 1));
+    const handle = mountSandbox({
+        container,
+        componentId: node.id,
+        artifact: { inline: artifact.inline, sha256: artifact.sha256 },
+        ...(node.data?.$ref != null ? { allowedRef: node.data.$ref } : {}),
+        allowedEvents,
+        initialProps: node.props,
+        bridge: rt.sandbox.bridge,
+        ...(rt.sandbox.policy != null ? { policy: rt.sandbox.policy } : {}),
+        // Inject theme tokens into the srcdoc (the same handoff as SandboxFrame). A theme change rides on the surface's
+        // full re-render (rt rebuild → teardown / mount), so no subscription is needed here.
+        theme: rt.theme,
+    });
+    // Keep the loading / error display in sync with state transitions (cleared on ready).
+    const renderStatus = (state, detail) => {
+        statusHolder.replaceChildren();
+        if (state === "loading")
+            statusHolder.appendChild(notice("info", sandboxLoadingNoticeText(messages)));
+        else if (state === "error") {
+            statusHolder.appendChild(notice("error", sandboxErrorNoticeText(detail, messages)));
+        }
+    };
+    handle.onStateChange(renderStatus);
+    // Bridge the write loop's data invalidation to the guest's in-place refetch (the capability stays with the parent).
+    const ref = node.data?.$ref;
+    const unsub = ref != null ? rt.bus.subscribe(ref, () => handle.invalidate(ref)) : noop;
+    return () => {
+        unsub();
+        handle.destroy();
+    };
+}
+function notice(tone, message) {
+    const node = el("div", {}, { ...sandboxNoticeBaseStyle, ...sandboxNoticeToneStyle(tone) });
+    node.appendChild(text(message));
+    return node;
+}
+//# sourceMappingURL=sandbox-mount.js.map

package/dist/sandbox-mount.js.map

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

package/dist/tree.d.ts

@@ -0,0 +1,24 @@
+import { type DataInvalidationBus, type RendererMessages, type SpecStateStore, type SurfaceEvent } from "@kohaku-ui/renderer-core";
+import { type ThemeTokens, type UISpec } from "@kohaku-ui/spec-core";
+import type { PartBuilder, RenderRuntime, SurfaceContext, Teardown } from "./types.js";
+export interface RuntimeDeps {
+    spec: UISpec;
+    store: SpecStateStore;
+    bus: DataInvalidationBus;
+    theme: ThemeTokens;
+    locale: string;
+    messages: RendererMessages;
+    ctx: SurfaceContext;
+    registry: Map<string, PartBuilder>;
+    /** Upstream notification of a forward event (CustomEvent dispatch; the onEvent call is done by the glue inside this). */
+    dispatchForward(event: SurfaceEvent): void;
+}
+/**
+ * Assembles a RenderRuntime scoped to a single Spec render. mountNode/mountChildren, etc. are closures
+ * that reference rt, so the part builders (parts/*) can recurse via rt without importing tree.ts
+ * (avoiding an import cycle).
+ */
+export declare function createRuntime(deps: RuntimeDeps): RenderRuntime;
+/** Builds the entire tree into parent via DFS from the root. The return value can tear down the whole tree. */
+export declare function mountTree(rt: RenderRuntime, parent: ParentNode, rootId: string): Teardown;
+//# sourceMappingURL=tree.d.ts.map

package/dist/tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree.d.ts","sourceRoot":"","sources":["../src/tree.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EAMrB,KAAK,cAAc,EACnB,KAAK,YAAY,EAClB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAKL,KAAK,WAAW,EAChB,KAAK,MAAM,EACZ,MAAM,sBAAsB,CAAC;AAG9B,OAAO,KAAK,EAAe,WAAW,EAAE,aAAa,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEpG,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,cAAc,CAAC;IACtB,GAAG,EAAE,mBAAmB,CAAC;IACzB,KAAK,EAAE,WAAW,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,GAAG,EAAE,cAAc,CAAC;IACpB,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACnC,yHAAyH;IACzH,eAAe,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;CAC5C;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,WAAW,GAAG,aAAa,CAkC9D;AAED,+GAA+G;AAC/G,wBAAgB,SAAS,CAAC,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,QAAQ,CAEzF"}

package/dist/tree.js

@@ -0,0 +1,156 @@
+import { createBoundDataController, resolveEmit, resolveInvokeTarget, resolveRowProps, resolveToken, runInvokeTarget, } from "@kohaku-ui/renderer-core";
+import { evaluateVisibleWhen, SANDBOX_HTML_TYPE, } from "@kohaku-ui/spec-core";
+import { nodeNotice, noop } from "./dom.js";
+import { mountSandboxNode } from "./sandbox-mount.js";
+/**
+ * Assembles a RenderRuntime scoped to a single Spec render. mountNode/mountChildren, etc. are closures
+ * that reference rt, so the part builders (parts/*) can recurse via rt without importing tree.ts
+ * (avoiding an import cycle).
+ */
+export function createRuntime(deps) {
+    const byId = new Map(deps.spec.components.map((c) => [c.id, c]));
+    const controller = createBoundDataController({
+        binding: deps.ctx.binding,
+        bus: deps.bus,
+        state: deps.store,
+        messages: deps.messages,
+    });
+    const rt = {
+        spec: deps.spec,
+        byId,
+        store: deps.store,
+        bus: deps.bus,
+        controller,
+        binding: deps.ctx.binding,
+        theme: deps.theme,
+        locale: deps.locale,
+        messages: deps.messages,
+        onNodeError: deps.ctx.onNodeError,
+        onActionResult: deps.ctx.onActionResult,
+        sandbox: deps.ctx.sandbox,
+        registry: deps.registry,
+        dispatchForward: deps.dispatchForward,
+        mountNode: (parent, id, row) => mountNode(rt, parent, id, row),
+        mountChildren: (parent, childIds, row) => mountChildren(rt, parent, childIds, row),
+        mountSandbox: (parent, node) => mountSandboxNode(rt, parent, node),
+        emit: (node, eventName, runtime, row) => emitEvent(rt, node, eventName, runtime, row),
+        invoke: (node, eventName, runtime, row, onPhase) => invokeAction(rt, node, eventName, runtime, row, onPhase),
+    };
+    return rt;
+}
+/** Builds the entire tree into parent via DFS from the root. The return value can tear down the whole tree. */
+export function mountTree(rt, parent, rootId) {
+    return mountNode(rt, parent, rootId, null);
+}
+function mountChildren(rt, parent, childIds, row) {
+    if (childIds == null || childIds.length === 0)
+        return noop;
+    const teardowns = childIds.map((id) => mountNode(rt, parent, id, row));
+    return () => {
+        for (const t of teardowns)
+            t();
+    };
+}
+function mountNode(rt, parent, id, row) {
+    const rawNode = rt.byId.get(id);
+    if (rawNode == null)
+        return noop;
+    if (rawNode.visibleWhen != null)
+        return mountReactiveVisible(rt, parent, rawNode, row);
+    return mountVisibleNode(rt, parent, rawNode, row);
+}
+/**
+ * Reactive slot for nodes that have visibleWhen. Places an anchor comment and, on every $state change, re-evaluates
+ * the condition to mount / unmount the subtree (same semantics as renderer-react's NodeView conditional display = subtree unmount).
+ */
+function mountReactiveVisible(rt, parent, rawNode, row) {
+    const anchor = document.createComment(`kohaku:vw:${rawNode.id}`);
+    parent.appendChild(anchor);
+    let inner = null;
+    const evalVisible = () => {
+        const visible = evaluateVisibleWhen(rawNode.visibleWhen, rt.store.values);
+        if (visible && inner == null) {
+            // Build in a detached container first, then move it right after the anchor (preserves sibling order).
+            const holder = document.createElement("div");
+            const teardown = mountVisibleNode(rt, holder, rawNode, row);
+            const inserted = [...holder.childNodes];
+            let ref = anchor;
+            for (const n of inserted) {
+                ref.after(n);
+                ref = n;
+            }
+            inner = () => {
+                teardown();
+                for (const n of inserted)
+                    n.remove();
+            };
+        }
+        else if (!visible && inner != null) {
+            inner();
+            inner = null;
+        }
+    };
+    evalVisible();
+    const unsub = rt.store.subscribe(evalVisible);
+    return () => {
+        unsub();
+        inner?.();
+        anchor.remove();
+    };
+}
+/** Builds a single display-confirmed node (row-template substitution + per-node try/catch → fallback notice). */
+function mountVisibleNode(rt, parent, rawNode, row) {
+    // Row-template mechanism (presentList): if there is a row context, substitute props' "$row.<column>" with that row's value.
+    const node = row != null ? resolveRowProps(rawNode, row) : rawNode;
+    try {
+        if (node.type === SANDBOX_HTML_TYPE) {
+            return rt.mountSandbox(parent, node);
+        }
+        const builder = rt.registry.get(node.type);
+        if (builder == null) {
+            parent.appendChild(nodeNotice(`Unimplemented component type: ${node.type}`, String(resolveToken(rt.theme, "color.negative.text"))));
+            return noop;
+        }
+        return builder(rt, parent, node, row);
+    }
+    catch (error) {
+        // Isolate a single node's render exception and keep siblings / the whole surface alive (equivalent to NodeErrorBoundary).
+        rt.onNodeError?.({ componentId: node.id, componentType: node.type, error });
+        parent.appendChild(nodeNotice(rt.messages.nodeRenderFailed(node.type, node.id), String(resolveToken(rt.theme, "color.negative.text"))));
+        return noop;
+    }
+}
+/**
+ * Applies event-emission governance (the glue for resolveEmit). Sink presence is not decided in resolveEmit;
+ * here (the glue) dispatchForward handles both the CustomEvent and onEvent.
+ */
+function emitEvent(rt, node, eventName, runtime, row) {
+    const res = resolveEmit(rt.spec, node, eventName, runtime, row);
+    if (res.kind === "state.set") {
+        rt.store.set(res.key, res.value);
+    }
+    else if (res.kind === "forward") {
+        rt.dispatchForward(res.event);
+    }
+    // drop: undeclared events are discarded (SPEC-EVT-002).
+}
+/**
+ * Applies the write path (the glue for resolveInvokeTarget). Whether binding exists is passed as a boolean.
+ * For invoke, delegates the pending/invokeAction/phase/publish/onActionResult sequence to renderer-core's
+ * runInvokeTarget (shared with renderer-react); otherwise delegates to emit.
+ */
+async function invokeAction(rt, node, eventName, runtime, row, onPhase) {
+    const target = resolveInvokeTarget(rt.spec, node, eventName, runtime, {
+        hasBinding: rt.binding != null,
+        row,
+    });
+    if (target.kind === "forward") {
+        emitEvent(rt, node, eventName, runtime, row);
+        return;
+    }
+    const binding = rt.binding;
+    // The pending → invokeAction → succeeded/failed phase → bus.publish → onActionResult sequence has
+    // renderer-core's runInvokeTarget as the single source of truth (shared with renderer-react).
+    await runInvokeTarget(target, { binding, bus: rt.bus, onActionResult: rt.onActionResult }, node.id, onPhase);
+}
+//# sourceMappingURL=tree.js.map

package/dist/tree.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,87 @@
+import type { BindingClient } from "@kohaku-ui/data-binding";
+import type { ActionPhase, BoundDataController, DataInvalidationBus, RendererMessages, SpecStateStore, SurfaceEvent } from "@kohaku-ui/renderer-core";
+import type { SandboxBridge, SandboxPolicy } from "@kohaku-ui/sandbox";
+import type { ComponentNode, JsonObject, ThemeTokens, UISpec } from "@kohaku-ui/spec-core";
+export type { ActionPhase, SurfaceEvent } from "@kohaku-ui/renderer-core";
+/** Teardown function (unsubscribe / controller detach / sandbox destroy, etc.). */
+export type Teardown = () => void;
+/**
+ * Context passed to <kohaku-surface> as properties. Corresponds to React's RendererContextValue.
+ * binding / theme / messages / onEvent, etc. are received as properties (objects/functions).
+ */
+export interface SurfaceContext {
+    /** Reference-resolution client. If unset, parts that carry data become a bindingMissing error. */
+    binding?: BindingClient;
+    /** Theme tokens. Inline expansion for pixel-match; :host CSS variables as the external override point. */
+    theme?: ThemeTokens;
+    /** Display language tag (default "en-US", see renderer-core's DEFAULT_LOCALE). Used for number formatting and sort collation. */
+    locale?: string;
+    /** Partial override of the default messages (DEFAULT_MESSAGES). */
+    messages?: Partial<RendererMessages>;
+    /** Only events declared in the Spec's events are delivered (state.set is not delivered). */
+    onEvent?: (event: SurfaceEvent) => void;
+    /** Notification of exceptions thrown during node rendering (invoked by the per-node try/catch when it catches). */
+    onNodeError?: (args: {
+        componentId: string;
+        componentType: string;
+        error: unknown;
+    }) => void;
+    /** Completion notification for writes (action.invoke). */
+    onActionResult?: (args: {
+        componentId: string;
+        action: string;
+        phase: "succeeded" | "failed";
+        result?: unknown;
+        message?: string;
+    }) => void;
+    /** Bridge required to run L2 (sandbox.html) parts. If unset, L2 becomes an injection-request placeholder. */
+    sandbox?: {
+        bridge: SandboxBridge;
+        policy?: SandboxPolicy;
+    };
+}
+/**
+ * Execution context scoped to a single Spec render. <kohaku-surface> rebuilds it on every Spec swap.
+ * The store is retained by intent.hash, and the bus stays the same for the lifetime of the surface.
+ */
+export interface RenderRuntime {
+    spec: UISpec;
+    byId: Map<string, ComponentNode>;
+    store: SpecStateStore;
+    bus: DataInvalidationBus;
+    controller: BoundDataController;
+    binding: BindingClient | undefined;
+    theme: ThemeTokens;
+    locale: string;
+    messages: RendererMessages;
+    onNodeError: SurfaceContext["onNodeError"];
+    onActionResult: SurfaceContext["onActionResult"];
+    sandbox: SurfaceContext["sandbox"];
+    /** Table of type → part builder (createCoreRenderRegistry). */
+    registry: Map<string, PartBuilder>;
+    /** Flows a forward event upstream via CustomEvent + onEvent (regardless of whether a sink is present). */
+    dispatchForward(event: SurfaceEvent): void;
+    /** Builds node id directly under parent (encapsulates visibleWhen / row template / per-node try-catch). */
+    mountNode(parent: ParentNode, id: string, row: JsonObject | null): Teardown;
+    /** Builds a group of child ids in order directly under parent. */
+    mountChildren(parent: ParentNode, childIds: string[] | undefined, row: JsonObject | null): Teardown;
+    /** Builds a sandbox.html node (the WC wrapper around mountSandbox). */
+    mountSandbox(parent: ParentNode, node: ComponentNode): Teardown;
+    /**
+     * Applies event-emission governance (the glue for resolveEmit). state.set updates the store, forward calls
+     * dispatchForward, and drop discards. row is the current row within a presentList template.
+     */
+    emit(node: ComponentNode, eventName: string, runtime: JsonObject, row: JsonObject | null): void;
+    /**
+     * Applies the write path (the glue for resolveInvokeTarget). For invoke, runs binding.invokeAction directly
+     * and publishes invalidates to the bus; otherwise falls back to emit. Reports progress state via onPhase.
+     */
+    invoke(node: ComponentNode, eventName: string, runtime: JsonObject, row: JsonObject | null, onPhase: (phase: ActionPhase) => void): Promise<void>;
+}
+/**
+ * A part's DOM builder. Appends its own element to parent and returns a teardown function.
+ * (Making append the builder's responsibility lets a bound part safely perform an asynchronous
+ * state-swapping replaceWith against an already-appended element.)
+ */
+export type PartBuilder = (rt: RenderRuntime, parent: ParentNode, node: ComponentNode, row: JsonObject | null) => Teardown;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@kohaku-ui/renderer-wc",
+  "version": "0.1.0",
+  "description": "Web Components renderer for kohaku UI Specs: a single <kohaku-surface> custom element with Shadow DOM.",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "dependencies": {
+    "@kohaku-ui/spec-core": "^0.1.0",
+    "@kohaku-ui/data-binding": "^0.1.0",
+    "@kohaku-ui/sandbox": "^0.1.0",
+    "@kohaku-ui/renderer-core": "^0.1.0",
+    "@kohaku-ui/registry": "^0.1.0"
+  },
+  "devDependencies": {
+    "@testing-library/react": "^16.3.3",
+    "axe-core": "^4.13.0",
+    "@types/react": "^19.3.0",
+    "@types/react-dom": "^19.3.0",
+    "jsdom": "^30.0.1",
+    "react": "19.3.0",
+    "react-dom": "19.3.0",
+    "recharts": "^3.10.1",
+    "typescript": "7.0.2",
+    "vitest": "^4.1.11",
+    "@kohaku-ui/renderer-react": "^0.1.0"
+  },
+  "license": "Apache-2.0",
+  "homepage": "https://github.com/yosuque/kohaku/tree/main/packages/renderer-wc#readme",
+  "bugs": {
+    "url": "https://github.com/yosuque/kohaku/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/yosuque/kohaku.git",
+    "directory": "packages/renderer-wc"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "build": "rm -rf dist && tsc -p tsconfig.build.json"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts"
+}