@kohaku-ui/renderer-wc 0.2.0 → 0.4.0

package/CHANGELOG.md

@@ -1,5 +1,134 @@
 # @kohaku-ui/renderer-wc
 
+## 0.4.0
+
+### Minor Changes
+
+- [#60](https://github.com/yosuque/kohaku/pull/60) [`5f1bbbd`](https://github.com/yosuque/kohaku/commit/5f1bbbd09fe1edb984a7b0f5a0c5212c3da628ea) Thanks [@yosuque](https://github.com/yosuque)! - Adds a Compliance Evidence Pack export (`@kohaku-ui/lineage`'s new `evidence` module; `kohaku evidence
+  keygen`/`export`/`verify`) and opt-in AI-generation disclosure for both renderers (design.md [#66](https://github.com/yosuque/kohaku/issues/66)/[#67](https://github.com/yosuque/kohaku/issues/67)).
+  
+  **Evidence Pack** (`@kohaku-ui/lineage`): `buildEvidencePack` assembles a normalized, Ed25519-signed
+  export of the lineage log (`events.jsonl`), a governance-decision index (`approvals.jsonl`:
+  `component.reviewed`/`published`/`withdrawn`, `intent.fixated`/`unfixated`), promotion/fixation
+  snapshots, and the referenced component HTML artifacts, plus `manifest.json` and a detached signature
+  (`manifest.sig`). `EvidenceManifestSchema` is new but deliberately not part of `spec/schemas` — it
+  describes an export format for auditors, not a wire type. Ed25519 signing uses `globalThis.crypto.subtle`
+  (no new runtime dependency for TS); an artifact whose recorded hash does not match its own content is
+  still exported, recorded as a non-fatal warning rather than aborting the export.
+  
+  **CLI** (`@kohaku-ui/cli`): `kohaku evidence keygen --out-dir <dir>` generates an Ed25519 keypair (private
+  key file mode 0600). `kohaku evidence export (--data-dir <dir> | --rest <baseUrl> [--header k:v])
+  [--tenant <id>] --since --until --private-key <pem> --out <dir> [--allow-incomplete]` builds and signs a
+  pack from a local `StoragePort` data directory or, over REST, from the existing `KohakuClient` surface
+  (`lineagePages`/`promotions.list`/`fixations.list`) — the REST source leaves `fixations.jsonl` empty with
+  a recorded warning, since `GET /fixations` does not expose enough fields to reconstruct a full
+  `FixationRecord`. `kohaku evidence verify <dir> --public-key <pem>` checks the manifest schema, the
+  signature, and every file's hash/size, and reports an independent artifact-hash cross-check as non-fatal
+  `mismatches`; exit code 0 valid / 1 invalid / 2 usage error. `@kohaku-ui/lineage` and
+  `@kohaku-ui/storage-memory` move from `cli`'s devDependencies to dependencies.
+  
+  **AI-generation disclosure** (`@kohaku-ui/renderer-core`, `@kohaku-ui/renderer-react`,
+  `@kohaku-ui/renderer-wc`): `deriveDisclosure(provenance)` (renderer-core) derives a disclosure level
+  (`"ai-generated"` for tier L1/L2, `"ai-assisted-reviewed"` for a fixated tier-L0 Spec, `"none"` otherwise
+  — never encoded on the wire) and the corresponding `data-kohaku-disclosure`/`data-kohaku-tier`/
+  `data-digital-source-type` (IPTC Digital Source Type) attributes. `SpecView` gains a `disclosure?: "off" |
+  "attributes" | "label"` prop (renderer-react; also exports `useDisclosure`/`KohakuDisclosureLabel`), and
+  `<kohaku-surface>` gains a matching `disclosure` attribute (renderer-wc, applied to the host element,
+  with the visible label — `"label"` mode only — inside the shadow root). Both default to `"off"`: existing
+  DOM output is unchanged unless a host opts in.
+  
+  See [docs/user-guide.md](../docs/user-guide.md)'s "Compliance Evidence Pack and AI-generation disclosure"
+  section for usage, EU AI Act Article 50 context (not legal advice), and a PII caution for exported Intent
+  `params`/request text.
+
+- [#62](https://github.com/yosuque/kohaku/pull/62) [`cc17b7b`](https://github.com/yosuque/kohaku/commit/cc17b7bc3c96e49b1b74197ac20cd7a3d8ee0b47) Thanks [@yosuque](https://github.com/yosuque)! - Add Governed Actions: Human-In-The-Loop tiers for `DomainPort` write operations (design.md [#62](https://github.com/yosuque/kohaku/issues/62)/[#63](https://github.com/yosuque/kohaku/issues/63)/[#64](https://github.com/yosuque/kohaku/issues/64);
+  SPEC §5's ACT-PRM-001/ACT-APR-001/ACT-CNF-001, LIN-ACT-001, §6.2's MCPAPP-ACT-001).
+  
+  An operation may declare `tier` (`"auto"` (default) / `"confirm"` / `"approve"`) and `paramsSchema`
+  (kohaku's own closed JSON Schema subset — `type`, `properties`, `required`,
+  `additionalProperties: false`, `enum`, `minimum`/`maximum`, `minLength`/`maxLength`, `items`, `maxItems`,
+  `x-message`; deliberately no `pattern`, to avoid both ReDoS and a JS/Python regex-dialect mismatch).
+  `spec-core`'s `validateActionParams`/`assertValidActionParamsSchema` (env-neutral, dependency-free, pinned
+  byte-for-byte against the Python port via the cross-language golden) enforces the schema before
+  `DomainPort.invoke` ever runs, on every write surface alike: REST's `POST /binding/action`, MCP's
+  `${prefix}_action`, and the client-side `preflightAction` check `renderer-core` runs before either.
+  
+  `"approve"`-tier actions are gated by a new stateless, short-lived HMAC-signed `ApprovalPort`
+  (`@kohaku-ui/authz-hmac`'s `createHmacApprovalPort`, `"kohaku-approval.v1."`-prefixed tokens, 300s default
+  TTL) bound to `(action, payloadHash, requesterId, tenant)`; self-approval is refused at issuance, and a
+  verification failure the host cannot classify is treated as a denial (fail-closed). An optional
+  `ApprovalStore` adds single-use enforcement. REST gains `POST /approvals` (mints a token as an authorized
+  approver, governance kind `action.approve`) and both the REST body and the MCP action tool's input gain
+  optional `confirmed`/`approval` fields; a gate failure is `422 ACTION_PARAMS_INVALID` / `403
+  APPROVAL_REQUIRED` on REST (with `error.issues`/`error.approval`) and the MCP structured-tool-error
+  equivalent.
+  
+  A compose response optionally carries an **Action manifest** (REST's `actions?` on
+  `/compose`/`/events`/`event: spec`; MCP's `_meta["kohaku/actions"]`) mapping each governed action name to
+  `{tier, paramsSchema?, confirmMessage?}` — placed outside the `UISpec` itself, next to the capability, so
+  it never affects `specHash` or the cache key. `renderer-core`'s `preflightAction` consults it client-side
+  before a write round-trip; `renderer-react`/`renderer-wc`/`mcp-renderer` thread `confirm`/`requestApproval`
+  hooks through (`renderer-react` ships a `globalThis.confirm`-backed default for the `"confirm"` tier; there
+  is no framework-neutral default for `"approve"`, so that tier stays gated until a product wires its own
+  hook). `@kohaku-ui/client`/`@kohaku-ui/data-binding` gain typed `ACTION_PARAMS_INVALID`/`APPROVAL_REQUIRED`
+  error codes and `confirmed`/`approval` request options. A host that records action outcomes to lineage does
+  so under a distinct `action.*` event family (`action.invoked`/`action.denied`/`action.approvalRequested`/
+  `action.approved`), carrying `payloadHash` but never the payload's own field values.
+  
+  The Python port (`python/kohaku`) mirrors the full surface (`kohaku.spec.action_params`,
+  `kohaku.host_core.action_gate`/`action_audit`, `POST /approvals`, the MCP action-tool gate), and
+  `apps/sample-api` / `python/examples/sales-api` demonstrate both tiers end to end (`annotate`: confirm,
+  `publish`: approve) — see the [user guide](../docs/user-guide.md)'s "Governed actions: tiers" section.
+  
+  **Behavior changes to check when upgrading.** (1) `POST /binding/action` and the MCP action tool now
+  reject, before `DomainPort.invoke` runs, any action that is not in the DomainPort's own
+  `listOperations()` — previously such an action was invoked ungated. It is rejected with the same response
+  as a missing write scope and recorded as `action.denied`. A product whose `listOperations()` omits an
+  operation it still expects to be invoked must declare it. (2) `validateActionParams` rejects a payload
+  property named `__proto__`, `constructor` or `prototype` at any depth (issue code `unsafeKey`), whatever
+  the schema's `additionalProperties` says.
+
+- [#54](https://github.com/yosuque/kohaku/pull/54) [`bd2d484`](https://github.com/yosuque/kohaku/commit/bd2d484826bec86c78dcb720502740494a672ea8) Thanks [@yosuque](https://github.com/yosuque)! - Adds a typed way to register a product-specific part, so its `{type, version, propsSchema}` can live in one
+  `ComponentDefinition` instead of being re-typed as string literals at the registration call site (design.md
+  [#68](https://github.com/yosuque/kohaku/issues/68)).
+  
+  `@kohaku-ui/renderer-react`: `implement(def, Component)` wraps a component whose props are inferred from
+  `def.propsSchema` (`z.infer`) — no `node.props["x"] as T` cast needed — and returns an entry consumed by the
+  new `ImplRegistry.use(entry)`. The existing `register(type, version, component)` / `ImplProps` keep working
+  unchanged for parts that have no static `ComponentDefinition` (e.g. a promoted part's per-artifact schema).
+  
+  `@kohaku-ui/renderer-wc`: `<kohaku-surface>` gains a public `registerPart(type, version, builder)` (it was
+  previously private with no way for a host to register anything beyond the core catalog), plus `getPartVersion`
+  for introspection, and `implementWc(def, builder)` is the typed counterpart of `implement` for a `PartBuilder`.
+  
+  Both `implement` and `implementWc` parse a node's props against the schema **unconditionally, in every
+  environment** (`propsSchema.safeParse` is also what materializes a `.default()`-ed prop the Spec omits, not
+  just a validation nicety, so it never skips in production) — on success the component receives the parsed
+  value, on failure it receives the raw (unvalidated) props instead (fail-open: a malformed prop degrades the
+  part's own display rather than the whole surface). Only the diagnostic — a `console.warn` on a mismatch — is
+  gated by environment: by default it fires outside a `NODE_ENV=production` build; pass `{ validate }` to force
+  the warning on or off regardless of environment.
+
+### Patch Changes
+
+- Updated dependencies [[`fcd4eb7`](https://github.com/yosuque/kohaku/commit/fcd4eb7c8c6608030d4f9045648a305fa2e5992f), [`5f1bbbd`](https://github.com/yosuque/kohaku/commit/5f1bbbd09fe1edb984a7b0f5a0c5212c3da628ea), [`cc17b7b`](https://github.com/yosuque/kohaku/commit/cc17b7bc3c96e49b1b74197ac20cd7a3d8ee0b47), [`730e625`](https://github.com/yosuque/kohaku/commit/730e62584b249056078792f6f646019cb225b049), [`730e625`](https://github.com/yosuque/kohaku/commit/730e62584b249056078792f6f646019cb225b049), [`730e625`](https://github.com/yosuque/kohaku/commit/730e62584b249056078792f6f646019cb225b049), [`5d167cb`](https://github.com/yosuque/kohaku/commit/5d167cb386cc1f91102644f8a99bd5b5c2949ce0)]:
+  - @kohaku-ui/registry@0.4.0
+  - @kohaku-ui/renderer-core@0.4.0
+  - @kohaku-ui/spec-core@0.4.0
+  - @kohaku-ui/data-binding@0.4.0
+  - @kohaku-ui/sandbox@0.4.0
+
+## 0.3.0
+
+### Patch Changes
+
+- Updated dependencies [[`a26f9be`](https://github.com/yosuque/kohaku/commit/a26f9be35f5702287e79f67f13bd3298bfb73bc5), [`ad51284`](https://github.com/yosuque/kohaku/commit/ad5128464169d389e0c462c59184d411ba359d8e), [`cffc1aa`](https://github.com/yosuque/kohaku/commit/cffc1aac259bfdc8f22c48ae57427a809853924e)]:
+  - @kohaku-ui/spec-core@0.3.0
+  - @kohaku-ui/data-binding@0.3.0
+  - @kohaku-ui/registry@0.3.0
+  - @kohaku-ui/renderer-core@0.3.0
+  - @kohaku-ui/sandbox@0.3.0
+
 ## 0.2.0
 
 ### Minor Changes

package/dist/implement.d.ts

@@ -0,0 +1,37 @@
+import type { ComponentDefinition } from "@kohaku-ui/registry";
+import type { ComponentNode, JsonObject } from "@kohaku-ui/spec-core";
+import type { z } from "zod";
+import type { PartBuilder, RenderRuntime, Teardown } from "./types.js";
+/**
+ * A part builder with typed props, taken from a `ComponentDefinition`'s `propsSchema` (design.md #68).
+ * Same shape as `PartBuilder`, with `props` added between `node` and `row`, so a product's builder never
+ * has to read `node.props["x"] as T` itself — the WC counterpart of renderer-react's typed `Component`.
+ */
+export type TypedPartBuilder<P> = (rt: RenderRuntime, parent: ParentNode, node: ComponentNode, props: P, row: JsonObject | null) => Teardown;
+/** Registration triple returned by `implementWc`, passed to `<kohaku-surface>.registerPart`. */
+export interface PartEntry {
+    type: string;
+    version: string;
+    builder: PartBuilder;
+}
+/**
+ * Wraps a typed `TypedPartBuilder` into a plain `PartBuilder` bound to `def`'s own type and version — the
+ * WC counterpart of renderer-react's `implement` (design.md #68). Usage:
+ * ```ts
+ * const entry = implementWc(myPartDef, (rt, parent, node, props, row) => { ... });
+ * surface.registerPart(entry.type, entry.version, entry.builder);
+ * ```
+ *
+ * `def.propsSchema.safeParse` always runs, in every environment — not just outside a `NODE_ENV=production`
+ * build — because it is also what materializes a `.default()`-ed prop (or any other Zod transform) the Spec
+ * omits; skipping it in production would silently make `builder` see `undefined` for a prop its type says
+ * is always present. On success, `builder` receives `parsed.data`; on failure it receives the raw
+ * (unvalidated) `node.props` instead, matching the renderer's general fail-open policy. Only the
+ * **diagnostic** — a `console.warn` on a mismatch — is gated by environment: by default it fires outside a
+ * `NODE_ENV=production` build (see `isDevEnvironment`); pass `{ validate }` to force it on or off
+ * regardless of environment.
+ */
+export declare function implementWc<P extends z.ZodObject>(def: ComponentDefinition<P>, builder: TypedPartBuilder<z.infer<P>>, options?: {
+    validate?: boolean;
+}): PartEntry;
+//# sourceMappingURL=implement.d.ts.map

package/dist/implement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"implement.d.ts","sourceRoot":"","sources":["../src/implement.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE/D,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACtE,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEvE;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAAI,CAChC,EAAE,EAAE,aAAa,EACjB,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,aAAa,EACnB,KAAK,EAAE,CAAC,EACR,GAAG,EAAE,UAAU,GAAG,IAAI,KACnB,QAAQ,CAAC;AAEd,gGAAgG;AAChG,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,WAAW,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS,EAC/C,GAAG,EAAE,mBAAmB,CAAC,CAAC,CAAC,EAC3B,OAAO,EAAE,gBAAgB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EACrC,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,GAC/B,SAAS,CAkBX"}

package/dist/implement.js

@@ -0,0 +1,37 @@
+import { isDevEnvironment } from "@kohaku-ui/renderer-core";
+/**
+ * Wraps a typed `TypedPartBuilder` into a plain `PartBuilder` bound to `def`'s own type and version — the
+ * WC counterpart of renderer-react's `implement` (design.md #68). Usage:
+ * ```ts
+ * const entry = implementWc(myPartDef, (rt, parent, node, props, row) => { ... });
+ * surface.registerPart(entry.type, entry.version, entry.builder);
+ * ```
+ *
+ * `def.propsSchema.safeParse` always runs, in every environment — not just outside a `NODE_ENV=production`
+ * build — because it is also what materializes a `.default()`-ed prop (or any other Zod transform) the Spec
+ * omits; skipping it in production would silently make `builder` see `undefined` for a prop its type says
+ * is always present. On success, `builder` receives `parsed.data`; on failure it receives the raw
+ * (unvalidated) `node.props` instead, matching the renderer's general fail-open policy. Only the
+ * **diagnostic** — a `console.warn` on a mismatch — is gated by environment: by default it fires outside a
+ * `NODE_ENV=production` build (see `isDevEnvironment`); pass `{ validate }` to force it on or off
+ * regardless of environment.
+ */
+export function implementWc(def, builder, options) {
+    const shouldWarn = options?.validate ?? isDevEnvironment();
+    const wrapped = (rt, parent, node, row) => {
+        const parsed = def.propsSchema.safeParse(node.props);
+        let props;
+        if (parsed.success) {
+            props = parsed.data;
+        }
+        else {
+            props = node.props;
+            if (shouldWarn) {
+                console.warn(`[kohaku] component "${def.type}" (node ${node.id}) received props that don't match its schema: ${parsed.error.message}`);
+            }
+        }
+        return builder(rt, parent, node, props, row);
+    };
+    return { type: def.type, version: def.version, builder: wrapped };
+}
+//# sourceMappingURL=implement.js.map

package/dist/implement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"implement.js","sourceRoot":"","sources":["../src/implement.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAyB5D;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,WAAW,CACzB,GAA2B,EAC3B,OAAqC,EACrC,OAAgC;IAEhC,MAAM,UAAU,GAAG,OAAO,EAAE,QAAQ,IAAI,gBAAgB,EAAE,CAAC;IAC3D,MAAM,OAAO,GAAgB,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;QACrD,MAAM,MAAM,GAAG,GAAG,CAAC,WAAW,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrD,IAAI,KAAiB,CAAC;QACtB,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,KAAK,GAAG,MAAM,CAAC,IAAkB,CAAC;QACpC,CAAC;aAAM,CAAC;YACN,KAAK,GAAG,IAAI,CAAC,KAAmB,CAAC;YACjC,IAAI,UAAU,EAAE,CAAC;gBACf,OAAO,CAAC,IAAI,CACV,uBAAuB,GAAG,CAAC,IAAI,WAAW,IAAI,CAAC,EAAE,iDAAiD,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CACzH,CAAC;YACJ,CAAC;QACH,CAAC;QACD,OAAO,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;IAC/C,CAAC,CAAC;IACF,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AACpE,CAAC"}

package/dist/index.d.ts

@@ -1,4 +1,5 @@
-export { DEFAULT_MESSAGES, type RendererMessages } from "@kohaku-ui/renderer-core";
+export { type ActionManifest, type ActionManifestEntry, DEFAULT_MESSAGES, type PreflightActionResult, preflightAction, type RendererMessages, summarizeActionForModel, } from "@kohaku-ui/renderer-core";
+export { implementWc, type PartEntry, type TypedPartBuilder } from "./implement.js";
 export { defineKohakuSurface, KOHAKU_EVENT, KohakuSurface } from "./kohaku-surface.js";
 export { createCoreRenderRegistry } from "./registry.js";
 export type { ActionPhase, PartBuilder, RenderRuntime, SurfaceContext, SurfaceEvent, Teardown, } from "./types.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,gBAAgB,EAAE,KAAK,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACnF,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACvF,OAAO,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AACzD,YAAY,EACV,WAAW,EACX,WAAW,EACX,aAAa,EACb,cAAc,EACd,YAAY,EACZ,QAAQ,GACT,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,gBAAgB,EAChB,KAAK,qBAAqB,EAC1B,eAAe,EACf,KAAK,gBAAgB,EACrB,uBAAuB,GACxB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,WAAW,EAAE,KAAK,SAAS,EAAE,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACpF,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACvF,OAAO,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AACzD,YAAY,EACV,WAAW,EACX,WAAW,EACX,aAAa,EACb,cAAc,EACd,YAAY,EACZ,QAAQ,GACT,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -2,7 +2,10 @@
 // A single <kohaku-surface> builds the entire UI Spec tree into one shadow root. The shared core is renderer-core.
 // Dependency direction: spec-core → {registry, data-binding} → renderer-core → renderer-wc (sandbox is imported directly).
 // UI message type and defaults (the single source of truth is renderer-core). Used to override context.messages.
-export { DEFAULT_MESSAGES } from "@kohaku-ui/renderer-core";
+// Governed actions (design.md #62/#63/#64): re-exported from renderer-core (the framework-free source of
+// truth) so a consumer does not need to reach into @kohaku-ui/renderer-core directly for these.
+export { DEFAULT_MESSAGES, preflightAction, summarizeActionForModel, } from "@kohaku-ui/renderer-core";
+export { implementWc } from "./implement.js";
 export { defineKohakuSurface, KOHAKU_EVENT, KohakuSurface } from "./kohaku-surface.js";
 export { createCoreRenderRegistry } from "./registry.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAC/F,mHAAmH;AACnH,2HAA2H;AAE3H,iHAAiH;AACjH,OAAO,EAAE,gBAAgB,EAAyB,MAAM,0BAA0B,CAAC;AACnF,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACvF,OAAO,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAC/F,mHAAmH;AACnH,2HAA2H;AAE3H,iHAAiH;AACjH,yGAAyG;AACzG,gGAAgG;AAChG,OAAO,EAGL,gBAAgB,EAEhB,eAAe,EAEf,uBAAuB,GACxB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,WAAW,EAAyC,MAAM,gBAAgB,CAAC;AACpF,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACvF,OAAO,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC"}

package/dist/kohaku-surface.d.ts

@@ -1,8 +1,10 @@
 import { type RendererMessages } from "@kohaku-ui/renderer-core";
 import { type ThemeTokens, type UISpec } from "@kohaku-ui/spec-core";
-import type { SurfaceContext } from "./types.js";
+import type { PartBuilder, SurfaceContext } from "./types.js";
 /** Name of the forward event dispatched by <kohaku-surface> (detail is a SurfaceEvent). */
 export declare const KOHAKU_EVENT = "kohaku-event";
+/** `disclosure` attribute values (design.md #66); anything else (including absence) behaves as `"off"`. */
+type DisclosureMode = "off" | "attributes" | "label";
 /**
  * The single host element <kohaku-surface> (Shadow DOM). It builds the entire UI Spec tree into one shadow root
  * (rather than a Custom Element per part type — a single-element surface). Spec / context are received as properties.
@@ -15,8 +17,13 @@ export declare const KOHAKU_EVENT = "kohaku-event";
  */
 export declare class KohakuSurface extends HTMLElement {
     #private;
+    static get observedAttributes(): string[];
     constructor();
     connectedCallback(): void;
+    attributeChangedCallback(name: string, oldValue: string | null, newValue: string | null): void;
+    /** `"off"` (default) | `"attributes"` | `"label"` (design.md #66). Reflects the `disclosure` attribute. */
+    get disclosure(): DisclosureMode;
+    set disclosure(v: DisclosureMode);
     disconnectedCallback(): void;
     /** UI Spec. Setting it triggers resetForIntent → rebuild the tree + reattach the controller. */
     get spec(): UISpec | null;
@@ -35,8 +42,38 @@ export declare class KohakuSurface extends HTMLElement {
     set onEvent(v: SurfaceContext["onEvent"]);
     set onNodeError(v: SurfaceContext["onNodeError"]);
     set onActionResult(v: SurfaceContext["onActionResult"]);
+    set actionManifest(v: SurfaceContext["actionManifest"]);
+    set confirm(v: SurfaceContext["confirm"]);
+    set requestApproval(v: SurfaceContext["requestApproval"]);
     set sandbox(v: SurfaceContext["sandbox"]);
+    /**
+     * Public registration API for product-specific parts (design.md #68). Previously `#registry` was private
+     * with no way for a host to add its own component types — a product could not register anything beyond
+     * the core catalog on the WC surface at all. Pair with `implementWc` for typed props:
+     * ```ts
+     * const entry = implementWc(myPartDef, builder);
+     * surface.registerPart(entry.type, entry.version, entry.builder);
+     * ```
+     * `version` is recorded for parity with renderer-react's `ImplRegistry.register`; unlike that registry,
+     * this surface does not (yet) feed a `SurfaceCapabilities` table into `@kohaku-ui/registry`'s
+     * `negotiate()` — no host wires WC capability negotiation today (AGENTS.md's renderer-wc section) — so
+     * `version` is not itself consulted by any negotiation path yet. Call before assigning `spec` when
+     * possible; if a Spec is already mounted, this rebuilds it so the newly registered part renders
+     * immediately instead of only taking effect on the next Spec swap.
+     *
+     * `#registry` starts seeded with the 16 core-catalog parts (`createCoreRenderRegistry`), so registering
+     * an already-taken `type` — most easily a core one, by typo or intentional override — silently replaces
+     * it. That is sometimes exactly what a product wants (replacing a core part with its own), but silent
+     * shadowing of a core part is also an easy way to lose one by accident, so replacing any existing entry
+     * warns via `console.warn` unless the caller opts in explicitly with `{ override: true }`.
+     */
+    registerPart(type: string, version: string, builder: PartBuilder, options?: {
+        override?: boolean;
+    }): void;
+    /** The version last passed to `registerPart` for `type`, if any (introspection only — see its doc comment). */
+    getPartVersion(type: string): string | undefined;
 }
 /** Registers <kohaku-surface> as a custom element (idempotent). */
 export declare function defineKohakuSurface(tagName?: string): void;
+export {};
 //# sourceMappingURL=kohaku-surface.d.ts.map

package/dist/kohaku-surface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"kohaku-surface.d.ts","sourceRoot":"","sources":["../src/kohaku-surface.ts"],"names":[],"mappings":"AAAA,OAAO,EAOL,KAAK,gBAAgB,EAItB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAqB,KAAK,WAAW,EAAE,KAAK,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAIxF,OAAO,KAAK,EAAe,cAAc,EAAY,MAAM,YAAY,CAAC;AAExE,2FAA2F;AAC3F,eAAO,MAAM,YAAY,iBAAiB,CAAC;AA0B3C;;;;;;;;;GASG;AACH,qBAAa,aAAc,SAAQ,WAAW;;IAW5C,cAYC;IAED,iBAAiB,IAAI,IAAI,CAUxB;IAED,oBAAoB,IAAI,IAAI,CAG3B;IAUD,gGAAgG;IAChG,IAAI,IAAI,IAAI,MAAM,GAAG,IAAI,CAExB;IACD,IAAI,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,EAK3B;IAED;;;OAGG;IACH,IAAI,OAAO,IAAI,cAAc,CAE5B;IACD,IAAI,OAAO,CAAC,IAAI,EAAE,cAAc,EAG/B;IAED,4EAA4E;IAC5E,IAAI,OAAO,CAAC,CAAC,EAAE,cAAc,CAAC,SAAS,CAAC,EAEvC;IACD,IAAI,KAAK,CAAC,CAAC,EAAE,WAAW,GAAG,SAAS,EAEnC;IACD,IAAI,MAAM,CAAC,CAAC,EAAE,MAAM,GAAG,SAAS,EAE/B;IACD,IAAI,QAAQ,CAAC,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,SAAS,EAEpD;IACD,IAAI,OAAO,CAAC,CAAC,EAAE,cAAc,CAAC,SAAS,CAAC,EAEvC;IACD,IAAI,WAAW,CAAC,CAAC,EAAE,cAAc,CAAC,aAAa,CAAC,EAE/C;IACD,IAAI,cAAc,CAAC,CAAC,EAAE,cAAc,CAAC,gBAAgB,CAAC,EAErD;IACD,IAAI,OAAO,CAAC,CAAC,EAAE,cAAc,CAAC,SAAS,CAAC,EAEvC;CA2EF;AAED,mEAAmE;AACnE,wBAAgB,mBAAmB,CAAC,OAAO,SAAmB,GAAG,IAAI,CAIpE"}
+{"version":3,"file":"kohaku-surface.d.ts","sourceRoot":"","sources":["../src/kohaku-surface.ts"],"names":[],"mappings":"AAAA,OAAO,EASL,KAAK,gBAAgB,EAItB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAqB,KAAK,WAAW,EAAE,KAAK,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAIxF,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAY,MAAM,YAAY,CAAC;AAExE,2FAA2F;AAC3F,eAAO,MAAM,YAAY,iBAAiB,CAAC;AAuC3C,2GAA2G;AAC3G,KAAK,cAAc,GAAG,KAAK,GAAG,YAAY,GAAG,OAAO,CAAC;AAErD;;;;;;;;;GASG;AACH,qBAAa,aAAc,SAAQ,WAAW;;IAqB5C,MAAM,KAAK,kBAAkB,IAAI,MAAM,EAAE,CAExC;IAED,cAYC;IAED,iBAAiB,IAAI,IAAI,CAWxB;IAED,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAE7F;IAED,2GAA2G;IAC3G,IAAI,UAAU,IAAI,cAAc,CAG/B;IACD,IAAI,UAAU,CAAC,CAAC,EAAE,cAAc,EAG/B;IAED,oBAAoB,IAAI,IAAI,CAG3B;IAUD,gGAAgG;IAChG,IAAI,IAAI,IAAI,MAAM,GAAG,IAAI,CAExB;IACD,IAAI,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,EAK3B;IAED;;;OAGG;IACH,IAAI,OAAO,IAAI,cAAc,CAE5B;IACD,IAAI,OAAO,CAAC,IAAI,EAAE,cAAc,EAG/B;IAED,4EAA4E;IAC5E,IAAI,OAAO,CAAC,CAAC,EAAE,cAAc,CAAC,SAAS,CAAC,EAEvC;IACD,IAAI,KAAK,CAAC,CAAC,EAAE,WAAW,GAAG,SAAS,EAEnC;IACD,IAAI,MAAM,CAAC,CAAC,EAAE,MAAM,GAAG,SAAS,EAE/B;IACD,IAAI,QAAQ,CAAC,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,SAAS,EAEpD;IACD,IAAI,OAAO,CAAC,CAAC,EAAE,cAAc,CAAC,SAAS,CAAC,EAEvC;IACD,IAAI,WAAW,CAAC,CAAC,EAAE,cAAc,CAAC,aAAa,CAAC,EAE/C;IACD,IAAI,cAAc,CAAC,CAAC,EAAE,cAAc,CAAC,gBAAgB,CAAC,EAErD;IACD,IAAI,cAAc,CAAC,CAAC,EAAE,cAAc,CAAC,gBAAgB,CAAC,EAErD;IACD,IAAI,OAAO,CAAC,CAAC,EAAE,cAAc,CAAC,SAAS,CAAC,EAEvC;IACD,IAAI,eAAe,CAAC,CAAC,EAAE,cAAc,CAAC,iBAAiB,CAAC,EAEvD;IACD,IAAI,OAAO,CAAC,CAAC,EAAE,cAAc,CAAC,SAAS,CAAC,EAEvC;IAoBD;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAUxG;IAED,+GAA+G;IAC/G,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE/C;CA8GF;AAED,mEAAmE;AACnE,wBAAgB,mBAAmB,CAAC,OAAO,SAAmB,GAAG,IAAI,CAIpE"}

package/dist/kohaku-surface.js

@@ -1,4 +1,4 @@
-import { createDataInvalidationBus, createSpecStateStore, DEFAULT_LOCALE, DEFAULT_MESSAGES, PARTS_STATE_CSS, themeTokensToCssVars, } from "@kohaku-ui/renderer-core";
+import { createDataInvalidationBus, createSpecStateStore, DEFAULT_LOCALE, DEFAULT_MESSAGES, deriveDisclosure, disclosureDomAttributes, PARTS_STATE_CSS, themeTokensToCssVars, } from "@kohaku-ui/renderer-core";
 import { ROOT_COMPONENT_ID } from "@kohaku-ui/spec-core";
 import { noop } from "./dom.js";
 import { createCoreRenderRegistry } from "./registry.js";
@@ -13,7 +13,16 @@ export const KOHAKU_EVENT = "kohaku-event";
  * this set: they are read live from `#context` at call time (see `#dispatchForward` and the wrapper
  * closures built in `#render`), so reassigning one of them mid-lifecycle must not force a full rebuild.
  */
-const REBUILD_KEYS = new Set(["binding", "theme", "locale", "messages", "sandbox"]);
+const REBUILD_KEYS = new Set([
+    "binding",
+    "theme",
+    "locale",
+    "messages",
+    "sandbox",
+    "actionManifest",
+    "confirm",
+    "requestApproval",
+]);
 /** Every property <kohaku-surface> exposes as a plain instance accessor (used by #upgradeProperty). */
 const UPGRADE_PROPS = [
     "spec",
@@ -25,7 +34,11 @@ const UPGRADE_PROPS = [
     "onEvent",
     "onNodeError",
     "onActionResult",
+    "actionManifest",
+    "confirm",
+    "requestApproval",
     "sandbox",
+    "disclosure",
 ];
 /**
  * The single host element <kohaku-surface> (Shadow DOM). It builds the entire UI Spec tree into one shadow root
@@ -42,10 +55,22 @@ export class KohakuSurface extends HTMLElement {
     #spec = null;
     #context = {};
     #registry = createCoreRenderRegistry();
+    // version is not read by #render (RenderRuntime.registry only needs the builder); it is recorded purely
+    // for parity with renderer-react's ImplRegistry.register (see registerPart's doc comment).
+    #partVersions = new Map();
     // The store is retained by intent.hash; the bus stays the same for the surface's lifetime (equivalent to renderer-react's Provider useRef bus).
     #store = null;
     #bus = createDataInvalidationBus();
     #teardown = noop;
+    // AI-generation disclosure (design.md #66). Unlike the properties above, `disclosure` is attribute-backed
+    // (`static observedAttributes` + `attributeChangedCallback`) rather than a plain instance accessor: it is
+    // a simple serializable enum, well suited to `<kohaku-surface disclosure="label">` markup, unlike
+    // spec/context/binding/theme which need real object identity. #disclosureLabelEl is the shadow-root
+    // element `#applyDisclosure` creates on demand for `disclosure="label"`; null in every other mode.
+    #disclosureLabelEl = null;
+    static get observedAttributes() {
+        return ["disclosure"];
+    }
     constructor() {
         super();
         const shadow = this.attachShadow({ mode: "open" });
@@ -66,12 +91,28 @@ export class KohakuSurface extends HTMLElement {
         // forever, so its setter logic (patchContext / re-render) would never fire again once the element is
         // upgraded. Re-apply each such value through its accessor exactly once, here, at upgrade time
         // (connectedCallback always fires after the class is defined). A no-op for an element created after
-        // define() (no own-property was ever set).
+        // define() (no own-property was ever set). "disclosure" is listed last so, if it was pre-assigned
+        // alongside "spec", #render() (triggered by spec's own upgrade) already sees the right value.
         for (const prop of UPGRADE_PROPS)
             this.#upgradeProperty(prop);
         if (this.#spec != null)
             this.#render();
     }
+    attributeChangedCallback(name, oldValue, newValue) {
+        if (name === "disclosure" && oldValue !== newValue)
+            this.#applyDisclosure();
+    }
+    /** `"off"` (default) | `"attributes"` | `"label"` (design.md #66). Reflects the `disclosure` attribute. */
+    get disclosure() {
+        const v = this.getAttribute("disclosure");
+        return v === "attributes" || v === "label" ? v : "off";
+    }
+    set disclosure(v) {
+        if (v === "off")
+            this.removeAttribute("disclosure");
+        else
+            this.setAttribute("disclosure", v);
+    }
     disconnectedCallback() {
         this.#teardown();
         this.#teardown = noop;
@@ -129,6 +170,15 @@ export class KohakuSurface extends HTMLElement {
     set onActionResult(v) {
         this.#patchContext({ onActionResult: v });
     }
+    set actionManifest(v) {
+        this.#patchContext({ actionManifest: v });
+    }
+    set confirm(v) {
+        this.#patchContext({ confirm: v });
+    }
+    set requestApproval(v) {
+        this.#patchContext({ requestApproval: v });
+    }
     set sandbox(v) {
         this.#patchContext({ sandbox: v });
     }
@@ -152,14 +202,51 @@ export class KohakuSurface extends HTMLElement {
         if (needsRebuild && this.#spec != null)
             this.#render();
     }
+    /**
+     * Public registration API for product-specific parts (design.md #68). Previously `#registry` was private
+     * with no way for a host to add its own component types — a product could not register anything beyond
+     * the core catalog on the WC surface at all. Pair with `implementWc` for typed props:
+     * ```ts
+     * const entry = implementWc(myPartDef, builder);
+     * surface.registerPart(entry.type, entry.version, entry.builder);
+     * ```
+     * `version` is recorded for parity with renderer-react's `ImplRegistry.register`; unlike that registry,
+     * this surface does not (yet) feed a `SurfaceCapabilities` table into `@kohaku-ui/registry`'s
+     * `negotiate()` — no host wires WC capability negotiation today (AGENTS.md's renderer-wc section) — so
+     * `version` is not itself consulted by any negotiation path yet. Call before assigning `spec` when
+     * possible; if a Spec is already mounted, this rebuilds it so the newly registered part renders
+     * immediately instead of only taking effect on the next Spec swap.
+     *
+     * `#registry` starts seeded with the 16 core-catalog parts (`createCoreRenderRegistry`), so registering
+     * an already-taken `type` — most easily a core one, by typo or intentional override — silently replaces
+     * it. That is sometimes exactly what a product wants (replacing a core part with its own), but silent
+     * shadowing of a core part is also an easy way to lose one by accident, so replacing any existing entry
+     * warns via `console.warn` unless the caller opts in explicitly with `{ override: true }`.
+     */
+    registerPart(type, version, builder, options) {
+        if (this.#registry.has(type) && options?.override !== true) {
+            console.warn(`[kohaku] registerPart("${type}", ...) replaces an existing part. ` +
+                "Pass { override: true } if that is intentional.");
+        }
+        this.#registry.set(type, builder);
+        this.#partVersions.set(type, version);
+        if (this.#spec != null)
+            this.#render();
+    }
+    /** The version last passed to `registerPart` for `type`, if any (introspection only — see its doc comment). */
+    getPartVersion(type) {
+        return this.#partVersions.get(type);
+    }
     #render() {
         // Tear down the previous tree (controller detach / unsubscribe / sandbox destroy / anchor removal).
         this.#teardown();
         this.#teardown = noop;
         this.#root.replaceChildren();
         const spec = this.#spec;
-        if (spec == null)
+        if (spec == null) {
+            this.#applyDisclosure();
             return;
+        }
         const theme = this.#context.theme ?? {};
         const messages = { ...DEFAULT_MESSAGES, ...(this.#context.messages ?? {}) };
         const locale = this.#context.locale ?? DEFAULT_LOCALE;
@@ -187,6 +274,9 @@ export class KohakuSurface extends HTMLElement {
             // just one of these callbacks does not go through #render again, so RenderRuntime's own onNodeError/
             // onActionResult fields (baked in once here) must forward through a stable indirection instead of
             // holding a stale reference to whatever callback existed when the tree was last built.
+            // actionManifest / confirm / requestApproval are *not* wrapped: all three are in REBUILD_KEYS, so any
+            // change already goes through a fresh #render, matching binding/theme/sandbox's own treatment as
+            // tree-scoped data rather than a live-read callback.
             ctx: {
                 ...this.#context,
                 onNodeError: (args) => this.#context.onNodeError?.(args),
@@ -196,12 +286,57 @@ export class KohakuSurface extends HTMLElement {
             dispatchForward: (event) => this.#dispatchForward(event),
         });
         this.#teardown = mountTree(rt, this.#root, ROOT_COMPONENT_ID);
+        this.#applyDisclosure();
     }
     #dispatchForward(event) {
         // composed so it crosses the shadow boundary and reaches the host page. Flows to both paths regardless of whether a sink exists.
         this.dispatchEvent(new CustomEvent(KOHAKU_EVENT, { detail: event, bubbles: true, composed: true }));
         this.#context.onEvent?.(event);
     }
+    /**
+     * Applies (or clears) AI-generation disclosure (design.md #66): the `data-kohaku-disclosure` /
+     * `data-kohaku-tier` / `data-digital-source-type` attributes go on the *host* element itself (`this`),
+     * not inside the shadow root -- unlike renderer-react's SpecView, which has no host element of its own
+     * to mark and so wraps the tree in an internal `<div>` instead. The visible label (`disclosure="label"`
+     * only) is a shadow-root element, since that is what is actually displayed. Called from `#render()`
+     * (spec/context changes) and from `attributeChangedCallback` (the `disclosure` attribute changing on
+     * its own, with no other change to re-render for).
+     */
+    #applyDisclosure() {
+        const mode = this.disclosure;
+        if (mode === "off" || this.#spec == null) {
+            this.removeAttribute("data-kohaku-disclosure");
+            this.removeAttribute("data-kohaku-tier");
+            this.removeAttribute("data-digital-source-type");
+            this.#disclosureLabelEl?.remove();
+            this.#disclosureLabelEl = null;
+            return;
+        }
+        const disclosure = deriveDisclosure(this.#spec.provenance);
+        const attrs = disclosureDomAttributes(disclosure);
+        this.setAttribute("data-kohaku-disclosure", attrs["data-kohaku-disclosure"]);
+        this.setAttribute("data-kohaku-tier", attrs["data-kohaku-tier"]);
+        if (attrs["data-digital-source-type"] != null) {
+            this.setAttribute("data-digital-source-type", attrs["data-digital-source-type"]);
+        }
+        else {
+            this.removeAttribute("data-digital-source-type");
+        }
+        if (mode === "label" && disclosure.level !== "none") {
+            const messages = { ...DEFAULT_MESSAGES, ...(this.#context.messages ?? {}) };
+            const text = disclosure.level === "ai-generated" ? messages.disclosureAiGenerated : messages.disclosureAiReviewed;
+            if (this.#disclosureLabelEl == null) {
+                this.#disclosureLabelEl = document.createElement("div");
+                this.#disclosureLabelEl.setAttribute("data-kohaku-disclosure-label", "");
+                this.shadowRoot.insertBefore(this.#disclosureLabelEl, this.#root);
+            }
+            this.#disclosureLabelEl.textContent = text;
+        }
+        else {
+            this.#disclosureLabelEl?.remove();
+            this.#disclosureLabelEl = null;
+        }
+    }
 }
 /** Registers <kohaku-surface> as a custom element (idempotent). */
 export function defineKohakuSurface(tagName = "kohaku-surface") {

package/dist/kohaku-surface.js.map

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

package/dist/tree.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tree.d.ts","sourceRoot":"","sources":["../src/tree.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EAOrB,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,CAmC9D;AAED,+GAA+G;AAC/G,wBAAgB,SAAS,CAAC,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,QAAQ,CAEzF"}
+{"version":3,"file":"tree.d.ts","sourceRoot":"","sources":["../src/tree.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EAOrB,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,CAsC9D;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

@@ -28,6 +28,9 @@ export function createRuntime(deps) {
         messages: deps.messages,
         onNodeError: deps.ctx.onNodeError,
         onActionResult: deps.ctx.onActionResult,
+        actionManifest: deps.ctx.actionManifest,
+        confirm: deps.ctx.confirm,
+        requestApproval: deps.ctx.requestApproval,
         sandbox: deps.ctx.sandbox,
         registry: deps.registry,
         dispatchForward: deps.dispatchForward,
@@ -135,10 +138,22 @@ function emitEvent(rt, node, eventName, runtime, row) {
     }
     // drop: undeclared events are discarded (SPEC-EVT-002).
 }
+/**
+ * The default "confirm"-tier hook (design.md #62/#63) used when the host does not supply its own via
+ * `SurfaceContext.confirm`: `globalThis.confirm` (the native browser dialog). Declines (returns `false`)
+ * when `confirm` is unavailable in this environment (e.g. SSR) rather than throwing — the same fail-safe
+ * posture as an explicitly declining host hook.
+ */
+function defaultConfirmHook(messages, args) {
+    if (typeof globalThis.confirm !== "function")
+        return false;
+    return globalThis.confirm(args.message ?? messages.actionConfirmDefault(args.action));
+}
 /**
  * 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.
+ * For invoke, delegates the preflightAction/confirm/requestApproval/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, {
@@ -150,8 +165,17 @@ async function invokeAction(rt, node, eventName, runtime, row, onPhase) {
         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);
+    // The pending → invokeAction → succeeded/failed/invalid/awaitingApproval phase → bus.publish →
+    // onActionResult sequence has renderer-core's runInvokeTarget as the single source of truth (shared
+    // with renderer-react). `confirm` defaults to `globalThis.confirm` (defaultConfirmHook) when the host
+    // does not supply its own; `requestApproval` has no default (design.md #63).
+    await runInvokeTarget(target, {
+        binding,
+        bus: rt.bus,
+        onActionResult: rt.onActionResult,
+        actionManifest: rt.actionManifest,
+        confirm: rt.confirm ?? ((args) => defaultConfirmHook(rt.messages, args)),
+        requestApproval: rt.requestApproval,
+    }, node.id, onPhase);
 }
 //# sourceMappingURL=tree.js.map

package/dist/tree.js.map

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

package/dist/types.d.ts

@@ -1,5 +1,5 @@
 import type { BindingClient } from "@kohaku-ui/data-binding";
-import type { ActionPhase, BoundDataController, DataInvalidationBus, RendererMessages, SizingTokens, SpecStateStore, SurfaceEvent } from "@kohaku-ui/renderer-core";
+import type { ActionManifest, ActionPhase, BoundDataController, DataInvalidationBus, RendererMessages, SizingTokens, SpecStateStore, SurfaceEvent } from "@kohaku-ui/renderer-core";
 import type { DesignKitStylesheet, 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";
@@ -74,6 +74,29 @@ export interface SurfaceContext {
         result?: unknown;
         message?: string;
     }) => void;
+    /**
+     * The compose-issued Action manifest (design.md #62/#64), threaded through to `runInvokeTarget` for a
+     * client-side `preflightAction` check before the round trip. Absent -> no local check; the server
+     * remains authoritative.
+     */
+    actionManifest?: ActionManifest;
+    /**
+     * Confirmation hook for a "confirm"-tier action (design.md #62/#63). When unset, defaults to
+     * `globalThis.confirm` (declining when unavailable in this environment, e.g. SSR).
+     */
+    confirm?: (args: {
+        action: string;
+        message?: string;
+    }) => boolean | Promise<boolean>;
+    /**
+     * Approval-token hook for an "approve"-tier action (design.md #63). No default is provided (an approval
+     * token is obtained out of band — there is no generic browser-native equivalent of `globalThis.confirm`
+     * for it).
+     */
+    requestApproval?: (args: {
+        action: string;
+        payload: JsonObject;
+    }) => string | undefined | Promise<string | undefined>;
     /** Bridge / policy / kit / badge visibility for running L2 (sandbox.html) parts. See {@link SandboxSurfaceContext}. */
     sandbox?: SandboxSurfaceContext;
 }
@@ -95,6 +118,9 @@ export interface RenderRuntime {
     messages: RendererMessages;
     onNodeError: SurfaceContext["onNodeError"];
     onActionResult: SurfaceContext["onActionResult"];
+    actionManifest: SurfaceContext["actionManifest"];
+    confirm: SurfaceContext["confirm"];
+    requestApproval: SurfaceContext["requestApproval"];
     sandbox: SurfaceContext["sandbox"];
     /** Table of type → part builder (createCoreRenderRegistry). */
     registry: Map<string, PartBuilder>;

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EACV,cAAc,EACd,WAAW,EACX,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,YAAY,EACb,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,mBAAmB,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAC5F,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAE3F,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE1E,mFAAmF;AACnF,MAAM,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC;AAElC;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,sDAAsD;IACtD,MAAM,EAAE,aAAa,CAAC;IACtB,2FAA2F;IAC3F,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB;;;;;;;;;;;;;;OAcG;IACH,GAAG,CAAC,EACA,mBAAmB,GACnB,MAAM,GACN,CAAC,CAAC,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,KAAK,mBAAmB,GAAG,MAAM,GAAG,SAAS,CAAC,CAAC;IACtF;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC;CAC9B;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,kGAAkG;IAClG,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,0GAA0G;IAC1G,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,iIAAiI;IACjI,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mEAAmE;IACnE,QAAQ,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACrC,4FAA4F;IAC5F,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;IACxC,mHAAmH;IACnH,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;IAC7F,0DAA0D;IAC1D,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE;QACtB,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,WAAW,GAAG,QAAQ,CAAC;QAC9B,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,KAAK,IAAI,CAAC;IACX;;;;OAIG;IACH,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC;;;OAGG;IACH,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACrF;;;;OAIG;IACH,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE;QACvB,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,UAAU,CAAC;KACrB,KAAK,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACvD,uHAAuH;IACvH,OAAO,CAAC,EAAE,qBAAqB,CAAC;CACjC;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACjC,KAAK,EAAE,cAAc,CAAC;IACtB,GAAG,EAAE,mBAAmB,CAAC;IACzB,UAAU,EAAE,mBAAmB,CAAC;IAChC,OAAO,EAAE,aAAa,GAAG,SAAS,CAAC;IACnC,KAAK,EAAE,WAAW,CAAC;IACnB,oHAAoH;IACpH,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,WAAW,EAAE,cAAc,CAAC,aAAa,CAAC,CAAC;IAC3C,cAAc,EAAE,cAAc,CAAC,gBAAgB,CAAC,CAAC;IACjD,cAAc,EAAE,cAAc,CAAC,gBAAgB,CAAC,CAAC;IACjD,OAAO,EAAE,cAAc,CAAC,SAAS,CAAC,CAAC;IACnC,eAAe,EAAE,cAAc,CAAC,iBAAiB,CAAC,CAAC;IACnD,OAAO,EAAE,cAAc,CAAC,SAAS,CAAC,CAAC;IACnC,+DAA+D;IAC/D,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAEnC,0GAA0G;IAC1G,eAAe,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;IAE3C,2GAA2G;IAC3G,SAAS,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,UAAU,GAAG,IAAI,GAAG,QAAQ,CAAC;IAC5E,kEAAkE;IAClE,aAAa,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,SAAS,EAAE,GAAG,EAAE,UAAU,GAAG,IAAI,GAAG,QAAQ,CAAC;IACpG,uEAAuE;IACvE,YAAY,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,aAAa,GAAG,QAAQ,CAAC;IAEhE;;;OAGG;IACH,IAAI,CAAC,IAAI,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,UAAU,GAAG,IAAI,GAAG,IAAI,CAAC;IAChG;;;OAGG;IACH,MAAM,CACJ,IAAI,EAAE,aAAa,EACnB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,UAAU,EACnB,GAAG,EAAE,UAAU,GAAG,IAAI,EACtB,OAAO,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,GACpC,OAAO,CAAC,IAAI,CAAC,CAAC;CAClB;AAED;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG,CACxB,EAAE,EAAE,aAAa,EACjB,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,aAAa,EACnB,GAAG,EAAE,UAAU,GAAG,IAAI,KACnB,QAAQ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kohaku-ui/renderer-wc",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "Web Components renderer for kohaku UI Specs: a single <kohaku-surface> custom element with Shadow DOM.",
   "type": "module",
   "exports": {
@@ -11,24 +11,28 @@
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "@kohaku-ui/spec-core": "^0.2.0",
-    "@kohaku-ui/data-binding": "^0.2.0",
-    "@kohaku-ui/renderer-core": "^0.2.0",
-    "@kohaku-ui/registry": "^0.2.0",
-    "@kohaku-ui/sandbox": "^0.2.0"
+    "@kohaku-ui/spec-core": "^0.4.0",
+    "@kohaku-ui/data-binding": "^0.4.0",
+    "@kohaku-ui/renderer-core": "^0.4.0",
+    "@kohaku-ui/registry": "^0.4.0",
+    "@kohaku-ui/sandbox": "^0.4.0"
+  },
+  "peerDependencies": {
+    "zod": "^4.6.5"
   },
   "devDependencies": {
-    "@kohaku-ui/renderer-react": "^0.2.0",
+    "@kohaku-ui/renderer-react": "^0.4.0",
     "@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",
+    "jsdom": "^30.1.1",
     "react": "19.3.0",
     "react-dom": "19.3.0",
     "recharts": "^3.10.1",
     "typescript": "7.0.2",
-    "vitest": "^5.0.1"
+    "vitest": "^5.0.1",
+    "zod": "^4.6.5"
   },
   "license": "Apache-2.0",
   "homepage": "https://github.com/yosuque/kohaku/tree/main/packages/renderer-wc#readme",