@xmachines/play-dom 1.0.0-beta.30 → 1.0.0-beta.32

package/README.md

@@ -12,38 +12,61 @@ npm install @xmachines/play-dom
 
 ## Key Exports
 
-- `connectRenderer({ actor, registry, container })` — connect actor view signal to DOM
-- `defineRegistry(catalog, { components, actions })` — build a catalog-typed `DomRegistry`
+- `connectRenderer({ actor, registry, container, handlers })` — connect actor view signal to DOM
+- `defineRegistry(catalog, { components, actions })` — build a catalog-typed `DomRegistry` with real async action handlers
+- `schema` — DOM schema for use with `defineCatalog` (mirrors `@json-render/react/schema` shape)
 - `PlayRenderer` — class-based renderer (connect/disconnect lifecycle)
 - `ComponentFn<C, K>` — catalog-typed DOM component function type
 - `ComponentContext<C, K>` — context passed to each `ComponentFn` (props, emit, on, children, bindings)
-- `renderSpec(spec, store, registry, send, actorActions)` — pure Spec → DOM renderer
+- `renderSpec(spec, store, registry, send, handlers)` — pure Spec → DOM renderer
 
 ## Usage
 
 ```ts
 import { definePlayer } from "@xmachines/play-xstate";
-import { connectRenderer, defineRegistry } from "@xmachines/play-dom";
-import { authMachine, authCatalog, type AuthCatalog } from "@xmachines/play-actor-shared";
+import { connectRenderer, defineRegistry, schema } from "@xmachines/play-dom";
+import { defineCatalog } from "@json-render/core";
+import { authCatalogDef, type AuthActor } from "@xmachines/play-actor-shared";
 import type { ComponentFn } from "@xmachines/play-dom";
 
+// 1. Build catalog with DOM schema
+const authCatalog = defineCatalog(schema, authCatalogDef);
+type AuthCatalog = typeof authCatalog;
+
+// 2. Implement catalog components
 const Home: ComponentFn<AuthCatalog, "Home"> = ({ props }) => {
 	const el = document.createElement("section");
 	el.textContent = props.title;
 	return el;
 };
 
-const { registry } = defineRegistry(authCatalog, {
+// 3. Build registry with real async action handlers
+const registryResult = defineRegistry(authCatalog, {
 	components: { Home /* ... */ },
-	actions: { login: "auth.login", logout: "auth.logout" },
+	actions: {
+		login: async (params) => {
+			if (!params) return;
+			actor.send({ type: "auth.login", username: params.username });
+		},
+		logout: async () => actor.send({ type: "auth.logout" }),
+	},
 });
 
-const createPlayer = definePlayer({ machine: authMachine });
-const actor = createPlayer();
+// 4. Resolve handlers and connect
+const actor = definePlayer({ machine: authMachine })();
 actor.start();
 
+const handlers = registryResult.handlers(
+	() => undefined,
+	() => ({}),
+);
 const container = document.getElementById("app")!;
-const disconnect = connectRenderer({ actor, registry, container });
+const disconnect = connectRenderer({
+	actor,
+	registry: registryResult.registry,
+	container,
+	handlers,
+});
 ```
 
 ## Learn More

package/dist/PlayRenderer.d.ts

@@ -17,14 +17,16 @@ import type { PlayDomOptions } from "./xm-types.js";
  *
  * Usage:
  * ```typescript
- * const renderer = new PlayRenderer(container, actor, registry, { actions: { ... } });
+ * const { registry, handlers } = defineRegistry(catalog, { components, actions });
+ * const resolvedHandlers = handlers(() => undefined, () => ({}));
+ * const renderer = new PlayRenderer(container, actor, registry, { handlers: resolvedHandlers });
  * renderer.connect();
  *
  * // Controlled mode — bring your own store:
  * import { createAtom } from "@xstate/store";
  * import { xstateStoreStateStore } from "@json-render/xstate";
  * const store = xstateStoreStateStore({ atom: createAtom({ username: "" }) });
- * const renderer = new PlayRenderer(container, actor, registry, { store, actions: { ... } });
+ * const renderer = new PlayRenderer(container, actor, registry, { store, handlers: resolvedHandlers });
  *
  * // Later:
  * renderer.disconnect();
@@ -41,7 +43,7 @@ export declare class PlayRenderer {
      * @param container - The `HTMLElement` to render into. Cleared and repopulated on every view transition.
      * @param actor - Actor instance providing the `currentView` signal (must implement `Viewable`).
      * @param registry - Map of component type names to `DomComponentRenderer` functions.
-     * @param options - Optional configuration: `actions` map (action name → XState event type) and
+     * @param options - Optional configuration: `handlers` map (action name → async handler) and
      *   optional external `store` (controlled mode — when omitted, a fresh `@xstate/store` atom is
      *   created per view transition seeded from `spec.state`).
      */

package/dist/PlayRenderer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PlayRenderer.d.ts","sourceRoot":"","sources":["../src/PlayRenderer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAgB,MAAM,uBAAuB,CAAC;AACnF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAE5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,YAAY;IAavB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAfzB,OAAO,CAAC,QAAQ,CAA6B;IAC7C,OAAO,CAAC,iBAAiB,CAA6B;IAEtD;;;;;;;OAOG;gBAEe,SAAS,EAAE,WAAW,EACtB,KAAK,EAAE,aAAa,CAAC,aAAa,CAAC,GAAG,QAAQ,EAC9C,QAAQ,EAAE,WAAW,EACrB,OAAO,GAAE,cAAmB;IAG9C;;;OAGG;IACH,OAAO,IAAI,IAAI;IAKf;;OAEG;IACH,UAAU,IAAI,IAAI;IAQlB,OAAO,CAAC,OAAO;CA2Bf"}
+{"version":3,"file":"PlayRenderer.d.ts","sourceRoot":"","sources":["../src/PlayRenderer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAgB,MAAM,uBAAuB,CAAC;AACnF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAE5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAoBpD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,YAAY;IAavB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAfzB,OAAO,CAAC,QAAQ,CAA6B;IAC7C,OAAO,CAAC,iBAAiB,CAA6B;IAEtD;;;;;;;OAOG;gBAEe,SAAS,EAAE,WAAW,EACtB,KAAK,EAAE,aAAa,CAAC,aAAa,CAAC,GAAG,QAAQ,EAC9C,QAAQ,EAAE,WAAW,EACrB,OAAO,GAAE,cAAmB;IAG9C;;;OAGG;IACH,OAAO,IAAI,IAAI;IAKf;;OAEG;IACH,UAAU,IAAI,IAAI;IAQlB,OAAO,CAAC,OAAO;CA8Bf"}

package/dist/PlayRenderer.js

@@ -12,19 +12,38 @@ import { watchSignal } from "@xmachines/play-signals";
 import { createAtom } from "@xstate/store";
 import { xstateStoreStateStore } from "@json-render/xstate";
 import { renderSpec } from "./json-render/renderer.js";
+/**
+ * Safely coerce a spec's `state` field to a plain object for `createAtom`.
+ *
+ * `spec.state` is typed as `unknown` in `ViewMetadata`. At runtime it can be
+ * `null`, `undefined`, a primitive, or a plain object depending on what the
+ * machine author put in the view spec. `createAtom` requires a plain object as
+ * its initial value — anything else produces a broken store at runtime.
+ *
+ * Returns the value unchanged when it is a non-null object; falls back to `{}`
+ * for all other cases (null, undefined, string, number, array, etc.).
+ */
+function toAtomState(state) {
+    if (state !== null && typeof state === "object" && !Array.isArray(state)) {
+        return state;
+    }
+    return {};
+}
 /**
  * PlayRenderer connects an actor's currentView signal to the DOM renderer.
  *
  * Usage:
  * ```typescript
- * const renderer = new PlayRenderer(container, actor, registry, { actions: { ... } });
+ * const { registry, handlers } = defineRegistry(catalog, { components, actions });
+ * const resolvedHandlers = handlers(() => undefined, () => ({}));
+ * const renderer = new PlayRenderer(container, actor, registry, { handlers: resolvedHandlers });
  * renderer.connect();
  *
  * // Controlled mode — bring your own store:
  * import { createAtom } from "@xstate/store";
  * import { xstateStoreStateStore } from "@json-render/xstate";
  * const store = xstateStoreStateStore({ atom: createAtom({ username: "" }) });
- * const renderer = new PlayRenderer(container, actor, registry, { store, actions: { ... } });
+ * const renderer = new PlayRenderer(container, actor, registry, { store, handlers: resolvedHandlers });
  *
  * // Later:
  * renderer.disconnect();
@@ -41,7 +60,7 @@ export class PlayRenderer {
      * @param container - The `HTMLElement` to render into. Cleared and repopulated on every view transition.
      * @param actor - Actor instance providing the `currentView` signal (must implement `Viewable`).
      * @param registry - Map of component type names to `DomComponentRenderer` functions.
-     * @param options - Optional configuration: `actions` map (action name → XState event type) and
+     * @param options - Optional configuration: `handlers` map (action name → async handler) and
      *   optional external `store` (controlled mode — when omitted, a fresh `@xstate/store` atom is
      *   created per view transition seeded from `spec.state`).
      */
@@ -76,17 +95,20 @@ export class PlayRenderer {
         this.container.replaceChildren();
         if (!view)
             return;
-        // Resolve the store: external (controlled) or fresh per-view atom
+        // Resolve the store: external (controlled) or fresh per-view atom.
+        // `spec.state` carries the machine's initial state for this view.
+        // Guard that it is a plain object before seeding createAtom — a non-object
+        // value (null, string, number) would silently produce a broken store.
         const store = this.options.store
             ? this.options.store
             : xstateStoreStateStore({
-                atom: createAtom(view.spec.state ?? {}),
+                atom: createAtom(toAtomState(view.spec.state)),
             });
         const send = this.actor.send.bind(this.actor);
-        const actorActions = this.options.actions ?? {};
+        const handlers = this.options.handlers ?? {};
         const rerender = () => {
             this.container.replaceChildren();
-            const node = renderSpec(view.spec, store, this.registry, send, actorActions);
+            const node = renderSpec(view.spec, store, this.registry, send, handlers);
             if (node)
                 this.container.appendChild(node);
         };

package/dist/PlayRenderer.js.map

@@ -1 +1 @@
-{"version":3,"file":"PlayRenderer.js","sourceRoot":"","sources":["../src/PlayRenderer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAEtD,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAG5D,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAIvD;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,OAAO,YAAY;IAaN;IACA;IACA;IACA;IAfV,QAAQ,GAAwB,IAAI,CAAC;IACrC,iBAAiB,GAAwB,IAAI,CAAC;IAEtD;;;;;;;OAOG;IACH,YACkB,SAAsB,EACtB,KAA8C,EAC9C,QAAqB,EACrB,UAA0B,EAAE;QAH5B,cAAS,GAAT,SAAS,CAAa;QACtB,UAAK,GAAL,KAAK,CAAyC;QAC9C,aAAQ,GAAR,QAAQ,CAAa;QACrB,YAAO,GAAP,OAAO,CAAqB;IAC3C,CAAC;IAEJ;;;OAGG;IACH,OAAO;QACN,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC,CAAC;QAC3C,IAAI,CAAC,QAAQ,GAAG,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IACnF,CAAC;IAED;;OAEG;IACH,UAAU;QACT,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC;QAClB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,IAAI,CAAC,iBAAiB,EAAE,EAAE,CAAC;QAC3B,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC;QAC9B,IAAI,CAAC,SAAS,CAAC,eAAe,EAAE,CAAC;IAClC,CAAC;IAEO,OAAO,CAAC,IAAyB;QACxC,2DAA2D;QAC3D,IAAI,CAAC,iBAAiB,EAAE,EAAE,CAAC;QAC3B,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC;QAE9B,IAAI,CAAC,SAAS,CAAC,eAAe,EAAE,CAAC;QACjC,IAAI,CAAC,IAAI;YAAE,OAAO;QAElB,kEAAkE;QAClE,MAAM,KAAK,GAAe,IAAI,CAAC,OAAO,CAAC,KAAK;YAC3C,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK;YACpB,CAAC,CAAC,qBAAqB,CAAC;gBACtB,IAAI,EAAE,UAAU,CAAE,IAAI,CAAC,IAAI,CAAC,KAAiC,IAAI,EAAE,CAAC;aACpE,CAAC,CAAC;QAEL,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC9C,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC;QAEhD,MAAM,QAAQ,GAAG,GAAS,EAAE;YAC3B,IAAI,CAAC,SAAS,CAAC,eAAe,EAAE,CAAC;YACjC,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,YAAY,CAAC,CAAC;YAC7E,IAAI,IAAI;gBAAE,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QAC5C,CAAC,CAAC;QAEF,IAAI,CAAC,iBAAiB,GAAG,KAAK,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QACnD,QAAQ,EAAE,CAAC;IACZ,CAAC;CACD"}
+{"version":3,"file":"PlayRenderer.js","sourceRoot":"","sources":["../src/PlayRenderer.ts"],"names":[],"mappings":"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"}

package/dist/connect-renderer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"connect-renderer.d.ts","sourceRoot":"","sources":["../src/connect-renderer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAE5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,MAAM,IAAI,CAiB3E"}
+{"version":3,"file":"connect-renderer.d.ts","sourceRoot":"","sources":["../src/connect-renderer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,sBAAsB,EAAkB,MAAM,eAAe,CAAC;AAE5E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,MAAM,IAAI,CA0B3E"}

package/dist/connect-renderer.js

@@ -41,13 +41,24 @@ import { PlayRenderer } from "./PlayRenderer.js";
  * ```
  */
 export function connectRenderer(options) {
-    const playDomOptions = options.actions ? { actions: options.actions } : {};
+    const playDomOptions = {};
+    if (options.handlers)
+        playDomOptions.handlers = options.handlers;
+    if (options.store)
+        playDomOptions.store = options.store;
     const renderer = new PlayRenderer(options.container, options.actor, options.registry, playDomOptions);
     renderer.connect();
-    // Handle fallback for null view (backward compat)
-    // If container is empty after initial render, append fallback
-    if (options.fallback && options.container.children.length === 0) {
-        options.container.appendChild(options.fallback);
+    // Handle fallback for null view (backward compat).
+    // Defer to next microtask: PlayRenderer's signal-driven initial render fires
+    // asynchronously via watchSignal, so the container is always empty at this
+    // synchronous point. Checking after one microtask gives the renderer a chance
+    // to populate the container before we decide to append the fallback.
+    if (options.fallback) {
+        queueMicrotask(() => {
+            if (options.container.children.length === 0) {
+                options.container.appendChild(options.fallback);
+            }
+        });
     }
     return () => renderer.disconnect();
 }

package/dist/connect-renderer.js.map

@@ -1 +1 @@
-{"version":3,"file":"connect-renderer.js","sourceRoot":"","sources":["../src/connect-renderer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGjD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAM,UAAU,eAAe,CAAC,OAA+B;IAC9D,MAAM,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3E,MAAM,QAAQ,GAAG,IAAI,YAAY,CAChC,OAAO,CAAC,SAAS,EACjB,OAAO,CAAC,KAAK,EACb,OAAO,CAAC,QAAQ,EAChB,cAAc,CACd,CAAC;IACF,QAAQ,CAAC,OAAO,EAAE,CAAC;IAEnB,kDAAkD;IAClD,8DAA8D;IAC9D,IAAI,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjE,OAAO,CAAC,SAAS,CAAC,WAAW,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACjD,CAAC;IAED,OAAO,GAAG,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;AACpC,CAAC"}
+{"version":3,"file":"connect-renderer.js","sourceRoot":"","sources":["../src/connect-renderer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGjD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAM,UAAU,eAAe,CAAC,OAA+B;IAC9D,MAAM,cAAc,GAAmB,EAAE,CAAC;IAC1C,IAAI,OAAO,CAAC,QAAQ;QAAE,cAAc,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IACjE,IAAI,OAAO,CAAC,KAAK;QAAE,cAAc,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;IACxD,MAAM,QAAQ,GAAG,IAAI,YAAY,CAChC,OAAO,CAAC,SAAS,EACjB,OAAO,CAAC,KAAK,EACb,OAAO,CAAC,QAAQ,EAChB,cAAc,CACd,CAAC;IACF,QAAQ,CAAC,OAAO,EAAE,CAAC;IAEnB,mDAAmD;IACnD,6EAA6E;IAC7E,2EAA2E;IAC3E,8EAA8E;IAC9E,qEAAqE;IACrE,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QACtB,cAAc,CAAC,GAAG,EAAE;YACnB,IAAI,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC7C,OAAO,CAAC,SAAS,CAAC,WAAW,CAAC,OAAO,CAAC,QAAS,CAAC,CAAC;YAClD,CAAC;QACF,CAAC,CAAC,CAAC;IACJ,CAAC;IAED,OAAO,GAAG,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;AACpC,CAAC"}

package/dist/index.d.ts

@@ -24,6 +24,6 @@
 export { connectRenderer } from "./connect-renderer.js";
 export { PlayRenderer } from "./PlayRenderer.js";
 export type { ConnectRendererOptions, PlayDomOptions } from "./xm-types.js";
-export { defineRegistry, renderSpec } from "./json-render/index.js";
-export type { EventHandle, DomRenderContext, DomComponentRenderer, ComponentContext, ComponentFn, ComponentRegistry, DefineRegistryOptions, DefineRegistryResult, DomRegistry, } from "./json-render/index.js";
+export { defineRegistry, renderSpec, schema } from "./json-render/index.js";
+export type { EventHandle, DomRenderContext, DomComponentRenderer, ComponentContext, ComponentFn, ComponentRegistry, Actions, ActionFn, DefineRegistryOptions, DefineRegistryResult, DomRegistry, DomSchema, } from "./json-render/index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGjD,YAAY,EAAE,sBAAsB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAG5E,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpE,YAAY,EACX,WAAW,EACX,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,EAChB,WAAW,EACX,iBAAiB,EACjB,qBAAqB,EACrB,oBAAoB,EACpB,WAAW,GACX,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGjD,YAAY,EAAE,sBAAsB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAG5E,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAC5E,YAAY,EACX,WAAW,EACX,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,EAChB,WAAW,EACX,iBAAiB,EACjB,OAAO,EACP,QAAQ,EACR,qBAAqB,EACrB,oBAAoB,EACpB,WAAW,EACX,SAAS,GACT,MAAM,wBAAwB,CAAC"}

package/dist/index.js

@@ -25,5 +25,5 @@
 export { connectRenderer } from "./connect-renderer.js";
 export { PlayRenderer } from "./PlayRenderer.js";
 // json-render/dom layer (re-exported for consumer convenience)
-export { defineRegistry, renderSpec } from "./json-render/index.js";
+export { defineRegistry, renderSpec, schema } from "./json-render/index.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;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,8BAA8B;AAC9B,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAKjD,+DAA+D;AAC/D,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,8BAA8B;AAC9B,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAKjD,+DAA+D;AAC/D,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/json-render/index.d.ts

@@ -13,5 +13,7 @@
  */
 export { renderSpec } from "./renderer.js";
 export { defineRegistry } from "./types.js";
-export type { EventHandle, DomRenderContext, DomComponentRenderer, ComponentContext, ComponentFn, ComponentRegistry, DefineRegistryOptions, DefineRegistryResult, DomRegistry, } from "./types.js";
+export { schema } from "./schema.js";
+export type { DomSchema } from "./schema.js";
+export type { EventHandle, DomRenderContext, DomComponentRenderer, ComponentContext, ComponentFn, ComponentRegistry, Actions, ActionFn, DefineRegistryOptions, DefineRegistryResult, DomRegistry, } from "./types.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/json-render/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/json-render/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,YAAY,EACX,WAAW,EACX,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,EAChB,WAAW,EACX,iBAAiB,EACjB,qBAAqB,EACrB,oBAAoB,EACpB,WAAW,GACX,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/json-render/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,YAAY,EACX,WAAW,EACX,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,EAChB,WAAW,EACX,iBAAiB,EACjB,OAAO,EACP,QAAQ,EACR,qBAAqB,EACrB,oBAAoB,EACpB,WAAW,GACX,MAAM,YAAY,CAAC"}

package/dist/json-render/index.js

@@ -13,4 +13,5 @@
  */
 export { renderSpec } from "./renderer.js";
 export { defineRegistry } from "./types.js";
+export { schema } from "./schema.js";
 //# sourceMappingURL=index.js.map

package/dist/json-render/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/json-render/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/json-render/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC"}

package/dist/json-render/renderer.d.ts

@@ -35,18 +35,17 @@ import type { DomRegistry, DomRenderContext } from "./types.js";
  * @param store        - Live `StateStore` bound to `spec.state`.
  * @param registry     - Map of element type names → `DomComponentRenderer`.
  * @param send         - Dispatcher for interaction events (e.g. actor.send).
- * @param actorActions - Map of catalog action names → event type strings.
+ * @param handlers - Map of catalog action names → async ActionHandler functions.
  * @returns            The root DOM `Node`, or `null` if the root is invisible
  *                     or has no registered renderer.
  *
  * @example
  * ```ts
- * const node = renderSpec(spec, store, registry, actor.send.bind(actor), {
- *   login: "auth.login",
- *   logout: "auth.logout",
- * });
+ * const { registry, handlers } = defineRegistry(catalog, { components, actions });
+ * const resolvedHandlers = handlers(() => undefined, () => ({}));
+ * const node = renderSpec(spec, store, registry, actor.send.bind(actor), resolvedHandlers);
  * if (node) container.appendChild(node);
  * ```
  */
-export declare function renderSpec(spec: Spec, store: StateStore, registry: DomRegistry, send: DomRenderContext["send"], actorActions: Record<string, string>): Node | null;
+export declare function renderSpec(spec: Spec, store: StateStore, registry: DomRegistry, send: DomRenderContext["send"], handlers: Record<string, import("@json-render/core").ActionHandler>): Node | null;
 //# sourceMappingURL=renderer.d.ts.map

package/dist/json-render/renderer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../../src/json-render/renderer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAa,MAAM,mBAAmB,CAAC;AACrE,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEhE;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,UAAU,CACzB,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,UAAU,EACjB,QAAQ,EAAE,WAAW,EACrB,IAAI,EAAE,gBAAgB,CAAC,MAAM,CAAC,EAC9B,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAClC,IAAI,GAAG,IAAI,CAyDb"}
+{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../../src/json-render/renderer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAa,MAAM,mBAAmB,CAAC;AACrE,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEhE;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,UAAU,CACzB,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,UAAU,EACjB,QAAQ,EAAE,WAAW,EACrB,IAAI,EAAE,gBAAgB,CAAC,MAAM,CAAC,EAC9B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,mBAAmB,EAAE,aAAa,CAAC,GACjE,IAAI,GAAG,IAAI,CAyDb"}

package/dist/json-render/renderer.js

@@ -34,20 +34,19 @@ import { evaluateVisibility, resolveBindings, resolveElementProps } from "@json-
  * @param store        - Live `StateStore` bound to `spec.state`.
  * @param registry     - Map of element type names → `DomComponentRenderer`.
  * @param send         - Dispatcher for interaction events (e.g. actor.send).
- * @param actorActions - Map of catalog action names → event type strings.
+ * @param handlers - Map of catalog action names → async ActionHandler functions.
  * @returns            The root DOM `Node`, or `null` if the root is invisible
  *                     or has no registered renderer.
  *
  * @example
  * ```ts
- * const node = renderSpec(spec, store, registry, actor.send.bind(actor), {
- *   login: "auth.login",
- *   logout: "auth.logout",
- * });
+ * const { registry, handlers } = defineRegistry(catalog, { components, actions });
+ * const resolvedHandlers = handlers(() => undefined, () => ({}));
+ * const node = renderSpec(spec, store, registry, actor.send.bind(actor), resolvedHandlers);
  * if (node) container.appendChild(node);
  * ```
  */
-export function renderSpec(spec, store, registry, send, actorActions) {
+export function renderSpec(spec, store, registry, send, handlers) {
     function renderElement(key) {
         const element = spec.elements[key];
         if (!element)
@@ -78,7 +77,7 @@ export function renderSpec(spec, store, registry, send, actorActions) {
             spec,
             store,
             send,
-            actorActions,
+            handlers,
             elementBindings,
             renderChildren: (keys) => keys.flatMap((k) => {
                 const n = renderElement(k);

package/dist/json-render/renderer.js.map

@@ -1 +1 @@
-{"version":3,"file":"renderer.js","sourceRoot":"","sources":["../../src/json-render/renderer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAI7F;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,UAAU,UAAU,CACzB,IAAU,EACV,KAAiB,EACjB,QAAqB,EACrB,IAA8B,EAC9B,YAAoC;IAEpC,SAAS,aAAa,CAAC,GAAW;QACjC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,CAAC,OAAO;YAAE,OAAO,IAAI,CAAC;QAE1B,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;QAEvC,yEAAyE;QACzE,mEAAmE;QACnE,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YACnC,MAAM,OAAO,GAAG,kBAAkB,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;YACpE,IAAI,CAAC,OAAO;gBAAE,OAAO,IAAI,CAAC;QAC3B,CAAC;QAED,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC;QAErC,wEAAwE;QACxE,wEAAwE;QACxE,sEAAsE;QACtE,MAAM,eAAe,GAAG,eAAe,CAAC,QAAQ,EAAE,EAAE,UAAU,EAAE,CAAC,IAAI,SAAS,CAAC;QAE/E,yEAAyE;QACzE,oEAAoE;QACpE,kEAAkE;QAClE,uDAAuD;QACvD,yEAAyE;QACzE,MAAM,aAAa,GAAG,mBAAmB,CAAC,QAAQ,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;QAEpE,yEAAyE;QACzE,8DAA8D;QAC9D,iEAAiE;QACjE,MAAM,GAAG,GAAqB;YAC7B,IAAI;YACJ,KAAK;YACL,IAAI;YACJ,YAAY;YACZ,eAAe;YACf,cAAc,EAAE,CAAC,IAAc,EAAE,EAAE,CAClC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE;gBAClB,MAAM,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;gBAC3B,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACrB,CAAC,CAAC;SACH,CAAC;QAEF,yEAAyE;QACzE,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,CAAC,QAAQ;YAAE,OAAO,IAAI,CAAC,CAAC,mDAAmD;QAE/E,yEAAyE;QACzE,2EAA2E;QAC3E,uEAAuE;QACvE,uEAAuE;QACvE,MAAM,eAAe,GAAc,EAAE,GAAG,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC;QACxE,OAAO,QAAQ,CAAC,eAAe,EAAE,GAAG,CAAC,CAAC;IACvC,CAAC;IAED,OAAO,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACjC,CAAC"}
+{"version":3,"file":"renderer.js","sourceRoot":"","sources":["../../src/json-render/renderer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAI7F;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,UAAU,CACzB,IAAU,EACV,KAAiB,EACjB,QAAqB,EACrB,IAA8B,EAC9B,QAAmE;IAEnE,SAAS,aAAa,CAAC,GAAW;QACjC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,CAAC,OAAO;YAAE,OAAO,IAAI,CAAC;QAE1B,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;QAEvC,yEAAyE;QACzE,mEAAmE;QACnE,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YACnC,MAAM,OAAO,GAAG,kBAAkB,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;YACpE,IAAI,CAAC,OAAO;gBAAE,OAAO,IAAI,CAAC;QAC3B,CAAC;QAED,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC;QAErC,wEAAwE;QACxE,wEAAwE;QACxE,sEAAsE;QACtE,MAAM,eAAe,GAAG,eAAe,CAAC,QAAQ,EAAE,EAAE,UAAU,EAAE,CAAC,IAAI,SAAS,CAAC;QAE/E,yEAAyE;QACzE,oEAAoE;QACpE,kEAAkE;QAClE,uDAAuD;QACvD,yEAAyE;QACzE,MAAM,aAAa,GAAG,mBAAmB,CAAC,QAAQ,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;QAEpE,yEAAyE;QACzE,8DAA8D;QAC9D,iEAAiE;QACjE,MAAM,GAAG,GAAqB;YAC7B,IAAI;YACJ,KAAK;YACL,IAAI;YACJ,QAAQ;YACR,eAAe;YACf,cAAc,EAAE,CAAC,IAAc,EAAE,EAAE,CAClC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE;gBAClB,MAAM,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;gBAC3B,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACrB,CAAC,CAAC;SACH,CAAC;QAEF,yEAAyE;QACzE,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,CAAC,QAAQ;YAAE,OAAO,IAAI,CAAC,CAAC,mDAAmD;QAE/E,yEAAyE;QACzE,2EAA2E;QAC3E,uEAAuE;QACvE,uEAAuE;QACvE,MAAM,eAAe,GAAc,EAAE,GAAG,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC;QACxE,OAAO,QAAQ,CAAC,eAAe,EAAE,GAAG,CAAC,CAAC;IACvC,CAAC;IAED,OAAO,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACjC,CAAC"}

package/dist/json-render/schema.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Schema for @json-render/dom (vanilla DOM renderer).
+ *
+ * Defines the spec and catalog shapes used by defineRegistry() and defineCatalog().
+ * Mirrors the structure of @json-render/react/schema — same flat element tree spec,
+ * same catalog definition — adapted for the vanilla DOM rendering target.
+ *
+ * @packageDocumentation
+ */
+/**
+ * The schema for @xmachines/play-dom
+ *
+ * Defines:
+ * - Spec: A flat tree of elements with keys, types, props, children, and on-bindings
+ * - Catalog: Components with props schemas, and optional actions with param schemas
+ */
+export declare const schema: import("@json-render/core").Schema<{
+    spec: import("@json-render/core").SchemaType<"object", {
+        /** Root element key */
+        root: import("@json-render/core").SchemaType<"string", unknown>;
+        /** Flat map of elements by key */
+        elements: import("@json-render/core").SchemaType<"record", import("@json-render/core").SchemaType<"object", {
+            /** Component type from catalog */
+            type: import("@json-render/core").SchemaType<"ref", string>;
+            /** Component props — resolved from catalog prop schema */
+            props: import("@json-render/core").SchemaType<"propsOf", string>;
+            /** Child element keys */
+            children: import("@json-render/core").SchemaType<"array", import("@json-render/core").SchemaType<"string", unknown>>;
+            /** Visibility condition */
+            visible: import("@json-render/core").SchemaType<"any", unknown>;
+        }>>;
+    }>;
+    catalog: import("@json-render/core").SchemaType<"object", {
+        /** Component definitions */
+        components: import("@json-render/core").SchemaType<"map", {
+            /** Zod schema for component props */
+            props: import("@json-render/core").SchemaType<"zod", unknown>;
+            /** Slots for this component */
+            slots: import("@json-render/core").SchemaType<"array", import("@json-render/core").SchemaType<"string", unknown>>;
+            /** Description for AI generation hints */
+            description: import("@json-render/core").SchemaType<"string", unknown>;
+            /** Example prop values */
+            example: import("@json-render/core").SchemaType<"any", unknown>;
+        }>;
+        /** Action definitions (optional) */
+        actions: import("@json-render/core").SchemaType<"map", {
+            /** Zod schema for action params */
+            params: import("@json-render/core").SchemaType<"zod", unknown>;
+            /** Description for AI generation hints */
+            description: import("@json-render/core").SchemaType<"string", unknown>;
+        }>;
+    }>;
+}>;
+export type DomSchema = typeof schema;
+//# sourceMappingURL=schema.d.ts.map

package/dist/json-render/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/json-render/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH;;;;;;GAMG;AACH,eAAO,MAAM,MAAM;;QAEjB,uBAAuB;;QAEvB,kCAAkC;;YAGhC,kCAAkC;;YAElC,0DAA0D;;YAE1D,yBAAyB;;YAEzB,2BAA2B;;;;;QAM7B,4BAA4B;;YAE3B,qCAAqC;;YAErC,+BAA+B;;YAE/B,0CAA0C;;YAE1C,0BAA0B;;;QAG3B,oCAAoC;;YAEnC,mCAAmC;;YAEnC,0CAA0C;;;;EAI1C,CAAC;AAEJ,MAAM,MAAM,SAAS,GAAG,OAAO,MAAM,CAAC"}

package/dist/json-render/schema.js

@@ -0,0 +1,55 @@
+/**
+ * Schema for @json-render/dom (vanilla DOM renderer).
+ *
+ * Defines the spec and catalog shapes used by defineRegistry() and defineCatalog().
+ * Mirrors the structure of @json-render/react/schema — same flat element tree spec,
+ * same catalog definition — adapted for the vanilla DOM rendering target.
+ *
+ * @packageDocumentation
+ */
+import { defineSchema } from "@json-render/core";
+/**
+ * The schema for @xmachines/play-dom
+ *
+ * Defines:
+ * - Spec: A flat tree of elements with keys, types, props, children, and on-bindings
+ * - Catalog: Components with props schemas, and optional actions with param schemas
+ */
+export const schema = defineSchema((s) => ({
+    spec: s.object({
+        /** Root element key */
+        root: s.string(),
+        /** Flat map of elements by key */
+        elements: s.record(s.object({
+            /** Component type from catalog */
+            type: s.ref("catalog.components"),
+            /** Component props — resolved from catalog prop schema */
+            props: s.propsOf("catalog.components"),
+            /** Child element keys */
+            children: s.array(s.string()),
+            /** Visibility condition */
+            visible: s.any(),
+        })),
+    }),
+    catalog: s.object({
+        /** Component definitions */
+        components: s.map({
+            /** Zod schema for component props */
+            props: s.zod(),
+            /** Slots for this component */
+            slots: s.array(s.string()),
+            /** Description for AI generation hints */
+            description: s.string(),
+            /** Example prop values */
+            example: s.any(),
+        }),
+        /** Action definitions (optional) */
+        actions: s.map({
+            /** Zod schema for action params */
+            params: s.zod(),
+            /** Description for AI generation hints */
+            description: s.string(),
+        }),
+    }),
+}));
+//# sourceMappingURL=schema.js.map

package/dist/json-render/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/json-render/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC1C,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,uBAAuB;QACvB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;QAChB,kCAAkC;QAClC,QAAQ,EAAE,CAAC,CAAC,MAAM,CACjB,CAAC,CAAC,MAAM,CAAC;YACR,kCAAkC;YAClC,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,oBAAoB,CAAC;YACjC,0DAA0D;YAC1D,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,oBAAoB,CAAC;YACtC,yBAAyB;YACzB,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;YAC7B,2BAA2B;YAC3B,OAAO,EAAE,CAAC,CAAC,GAAG,EAAE;SAChB,CAAC,CACF;KACD,CAAC;IACF,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC;QACjB,4BAA4B;QAC5B,UAAU,EAAE,CAAC,CAAC,GAAG,CAAC;YACjB,qCAAqC;YACrC,KAAK,EAAE,CAAC,CAAC,GAAG,EAAE;YACd,+BAA+B;YAC/B,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;YAC1B,0CAA0C;YAC1C,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;YACvB,0BAA0B;YAC1B,OAAO,EAAE,CAAC,CAAC,GAAG,EAAE;SAChB,CAAC;QACF,oCAAoC;QACpC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC;YACd,mCAAmC;YACnC,MAAM,EAAE,CAAC,CAAC,GAAG,EAAE;YACf,0CAA0C;YAC1C,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;SACvB,CAAC;KACF,CAAC;CACF,CAAC,CAAC,CAAC"}

package/dist/json-render/types.d.ts

@@ -9,35 +9,19 @@
  * - `defineRegistry(catalog, options)` — build a catalog-typed DomRegistry
  *
  * Key difference from framework renderers: `ComponentFn` returns
- * `HTMLElement | Text | null` instead of a framework node, and
- * `actions` is a `Record<string, string>` event-type map instead of
- * async handler functions (because DOM dispatches directly via `send`).
+ * `HTMLElement | Text | null` instead of a framework node.
  *
  * @packageDocumentation
  */
-import type { Catalog, InferCatalogActions, InferCatalogComponents, InferComponentProps, Spec, StateStore, UIElement } from "@json-render/core";
+import type { ActionHandler, Catalog, InferActionParams, InferCatalogActions, InferCatalogComponents, InferComponentProps, StateModel, Spec, StateStore, UIElement } from "@json-render/core";
 /**
  * Handle returned by `ComponentContext.on(eventName)`.
- *
- * Matches the `EventHandle` interface from @json-render/react, /solid, /svelte, /vue.
- *
- * @example
- * ```ts
- * const handle = on("submit");
- * if (handle.bound) {
- *   btn.addEventListener("click", (e) => {
- *     if (handle.shouldPreventDefault) e.preventDefault();
- *     handle.emit();
- *   });
- * }
- * ```
  */
 export interface EventHandle {
     /** Fire the bound action, resolving params from the current state store. */
     emit: () => void;
     /**
      * Whether any binding for this event has `preventDefault: true`.
-     * Use to call `e.preventDefault()` on the triggering DOM event.
      */
     shouldPreventDefault: boolean;
     /** `true` if an `on` binding exists for this event name; `false` otherwise. */
@@ -45,9 +29,6 @@ export interface EventHandle {
 }
 /**
  * Low-level render context passed to each `DomComponentRenderer`.
- *
- * This is the raw renderer-level interface. Most component authors should use
- * the higher-level `ComponentContext<C, K>` provided by `defineRegistry`.
  */
 export interface DomRenderContext {
     /** Full spec tree for this render pass. */
@@ -58,207 +39,92 @@ export interface DomRenderContext {
     send: (event: {
         type: string;
     } & Record<string, unknown>) => void;
-    /** Map of json-render catalog action names → dispatch event type strings. */
-    actorActions: Record<string, string>;
+    /** Map of json-render catalog action names → async ActionHandler functions. */
+    handlers: Record<string, ActionHandler>;
     /** Render a list of child element keys into DOM nodes. */
     renderChildren: (keys: string[]) => Node[];
     /**
      * Pre-computed two-way binding paths for this element's props.
-     * Resolved from raw props before `resolveElementProps` runs — the resolved
-     * props no longer contain `$bindState`/`$bindItem` expressions.
-     * `undefined` when no binding expressions were found.
      */
     elementBindings?: Record<string, string> | undefined;
 }
-/**
- * Raw DOM component renderer function.
- *
- * Receives a resolved `UIElement` and a `DomRenderContext`, and returns a DOM
- * node or `null`. Prefer using `ComponentFn<C, K>` via `defineRegistry` for
- * catalog-typed, framework-consistent components.
- *
- * @example
- * ```ts
- * const myRenderer: DomComponentRenderer = (element, ctx) => {
- *   const el = document.createElement("div");
- *   el.textContent = String(element.props.title ?? "");
- *   return el;
- * };
- * ```
- */
 export type DomComponentRenderer = (element: UIElement, ctx: DomRenderContext) => HTMLElement | Text | null;
-/**
- * Catalog-typed context passed to each DOM component function.
- *
- * Mirrors the `ComponentContext<C, K>` shape from @json-render/react, /solid,
- * /svelte, /vue with three DOM-specific adaptations:
- *
- * - `children` is `Node[]` instead of a framework node/snippet/slot
- * - `bindings` is `Record<string, string> | undefined` (path strings for DOM
- *   consumers that implement their own two-way binding, e.g. input value ↔ store)
- * - `ctx` (low-level `DomRenderContext`) is exposed for advanced use cases
- *   (framework renderers do not expose this)
- *
- * @example
- * ```ts
- * const Login: ComponentFn<AuthCatalog, "Login"> = ({ props, emit, on, bindings }) => {
- *   const section = document.createElement("section");
- *
- *   const input = document.createElement("input");
- *   input.value = props.username ?? "";
- *
- *   // Two-way binding: write back to state store when input changes
- *   if (bindings?.username) {
- *     input.addEventListener("input", () => {
- *       // bindings.username contains the store path e.g. "/username"
- *     });
- *   }
- *
- *   const btn = document.createElement("button");
- *   const handle = on("submit");
- *   btn.addEventListener("click", (e) => {
- *     if (handle.shouldPreventDefault) e.preventDefault();
- *     handle.emit();
- *   });
- *
- *   section.append(input, btn);
- *   return section;
- * };
- * ```
- */
 export interface ComponentContext<C extends Catalog, K extends keyof InferCatalogComponents<C>> {
     /** Catalog-typed, store-resolved props for this component. */
     props: InferComponentProps<C, K>;
     /**
      * Rendered child nodes from the spec's `children` list.
-     * Append these into the returned element where children should appear.
      */
     children: Node[];
     /**
      * Two-way binding paths resolved from `$bindState` / `$bindItem` prop expressions.
-     *
-     * Keys match prop names that had `$bindState`/`$bindItem` expressions in the spec;
-     * values are the absolute state-store paths to write back to on user input.
-     *
-     * `undefined` when no bindings were found for this element.
      */
     bindings: Record<string, string> | undefined;
     /**
      * Dispatch a named event defined in the spec's `on` map.
-     *
-     * Resolves the catalog action binding, applies param expressions against the
-     * current state store, and calls `send()` with the mapped XState event type.
-     *
-     * @example
-     * ```ts
-     * btn.addEventListener("click", () => emit("submit"));
-     * ```
      */
     emit: (event: string) => void;
     /**
      * Get an `EventHandle` for a named event from the spec's `on` map.
-     *
-     * Use when you need `shouldPreventDefault` or want to check whether an `on`
-     * binding exists before attaching a listener.
-     *
-     * @example
-     * ```ts
-     * const handle = on("submit");
-     * if (handle.bound) {
-     *   form.addEventListener("submit", (e) => {
-     *     if (handle.shouldPreventDefault) e.preventDefault();
-     *     handle.emit();
-     *   });
-     * }
-     * ```
      */
     on: (event: string) => EventHandle;
     /**
      * Low-level render context.
-     *
-     * Exposes `send`, `store`, `actorActions`, and `renderChildren` for advanced
-     * use cases. Framework renderers do not expose this field — prefer `emit`/`on`
-     * for event dispatch and `children` for child rendering.
      */
     ctx: DomRenderContext;
 }
-/**
- * Catalog-typed DOM component function.
- *
- * The DOM equivalent of `ComponentFn<C, K>` from @json-render/react, /solid,
- * /svelte, /vue. The only structural difference is the return type:
- * `HTMLElement | Text | null` instead of a framework node.
- *
- * Pass implementations to `defineRegistry` — do not call directly.
- *
- * @example
- * ```ts
- * import type { ComponentFn } from "@xmachines/play-dom";
- * import type { AuthCatalog } from "@xmachines/play-actor-shared";
- *
- * export const Home: ComponentFn<AuthCatalog, "Home"> = ({ props, children }) => {
- *   const section = document.createElement("section");
- *   section.setAttribute("data-page", "home");
- *
- *   const h2 = document.createElement("h2");
- *   h2.textContent = props.title;
- *   section.appendChild(h2);
- *
- *   children.forEach((child) => section.appendChild(child));
- *   return section;
- * };
- * ```
- */
 export type ComponentFn<C extends Catalog, K extends keyof InferCatalogComponents<C>> = (ctx: ComponentContext<C, K>) => HTMLElement | Text | null;
-/**
- * Catalog-keyed map of `ComponentFn` implementations.
- *
- * Used as the `components` field in `DefineRegistryOptions`.
- * TypeScript enforces that every component key declared in the catalog has
- * a matching implementation.
- */
 export type ComponentRegistry<C extends Catalog> = {
     [K in keyof InferCatalogComponents<C>]: ComponentFn<C, K>;
 };
+export type DomRegistry = Record<string, DomComponentRenderer>;
 /**
- * Raw registry of `DomComponentRenderer` functions keyed by element type.
- *
- * Passed to `connectRenderer` or `PlayRenderer`. Build with `defineRegistry`
- * to get catalog-typed component functions automatically wrapped.
+ * Catalog-typed action function — mirrors `ActionFn<C, K>` from @json-render/react, /solid, /vue.
+ * `params` is typed to the exact param schema defined in the catalog, or `undefined` if no spec
+ * provided params. The handler must guard against undefined before accessing params.
  */
-export type DomRegistry = Record<string, DomComponentRenderer>;
+export type ActionFn<C extends Catalog, K extends keyof InferCatalogActions<C>> = (params: InferActionParams<C, K> | undefined) => Promise<void>;
+/**
+ * Map of catalog-typed action handler functions.
+ * Each key is a catalog action name; each value is an `ActionFn<C, K>` for that action.
+ */
+export type Actions<C extends Catalog> = {
+    [K in keyof InferCatalogActions<C>]: ActionFn<C, K>;
+};
 /**
  * Options for `defineRegistry`.
  *
- * Mirrors `DefineRegistryOptions<C>` from @json-render/react, /solid, /svelte, /vue
- * with one intentional difference: `actions` is a `Record<string, string>` event-type
- * map rather than async handler functions, because the DOM renderer dispatches events
- * directly via `send()` to an XState actor instead of calling framework action handlers.
+ * Mirrors `DefineRegistryOptions<C>` from @json-render/react, /solid, /svelte, /vue.
+ * `actions` accepts catalog-typed async handler functions — params are fully typed.
  */
 export interface DefineRegistryOptions<C extends Catalog> {
     /**
      * Catalog-typed component implementations.
-     * Each key must match a component declared in the catalog.
      */
     components?: ComponentRegistry<C>;
     /**
-     * Map of catalog action name → XState event type string.
+     * Map of catalog action name → catalog-typed async handler function.
      *
-     * When a spec element fires `emit("login")`, the DOM renderer looks up
-     * `actions.login` (e.g. `"auth.login"`) and calls `send({ type: "auth.login", ...params })`.
+     * Each handler receives params typed to the action's schema (or `undefined`).
+     * Guard against undefined before accessing params:
      *
-     * In the framework renderers this field holds async handler functions. In the DOM
-     * renderer it is a simpler string map because routing to the actor is handled by
-     * the XMachines play-dom layer rather than inside the json-render action system.
+     * @example
+     * ```ts
+     * actions: {
+     *   login: async (params) => {
+     *     if (!params) return;
+     *     actor.send({ type: 'auth.login', username: params.username });
+     *   },
+     * }
+     * ```
      */
-    actions?: InferCatalogActions<C> extends Record<string, never> ? Record<string, string> : Record<keyof InferCatalogActions<C>, string>;
+    actions?: Actions<C>;
 }
 /**
  * Result returned by `defineRegistry`.
  *
- * Mirrors the `{ registry }` field from @json-render/react, /solid, /svelte, /vue.
- * The DOM result also exposes `actorActions` — the resolved event-type map — so
- * callers can pass it directly to `connectRenderer` or `PlayRenderer`.
+ * Matches `DefineRegistryResult` from @json-render/react, /solid, /svelte, /vue —
+ * returns `{ registry, handlers }` instead of the old `{ registry, actorActions }`.
  */
 export interface DefineRegistryResult {
     /**
@@ -266,45 +132,33 @@ export interface DefineRegistryResult {
      */
     registry: DomRegistry;
     /**
-     * Resolved map of catalog action name → XState event type string.
-     *
-     * Pass to `connectRenderer({ ..., actions: actorActions })` or
-     * `new PlayRenderer(container, actor, registry, { actions: actorActions })`.
+     * Create ActionProvider-compatible handlers.
+     * Accepts getter functions so handlers always read the latest state.
+     * For DOM rendering, pass `() => undefined, () => ({})` since DOM actions
+     * dispatch directly to actor without needing setState.
      */
-    actorActions: Record<string, string>;
+    handlers: (getSetState: () => unknown, getState: () => StateModel) => Record<string, ActionHandler>;
 }
 /**
  * Build a `DomRegistry` from a catalog and component/action options.
  *
- * Mirrors the `defineRegistry(catalog, options)` API from @json-render/react,
- * /solid, /svelte, /vue. The catalog parameter is used for TypeScript inference
- * only (the same as in the framework renderers — it is not used at runtime).
- *
- * Each component in `options.components` is wrapped in a `DomComponentRenderer`
- * adapter that:
- * - Resolves props and two-way binding paths via `@json-render/core`
- * - Builds `emit(event)` and `on(event)` closures over the element's `on` map
- * - Renders child elements via `ctx.renderChildren`
- * - Passes the assembled `ComponentContext` to your `ComponentFn`
- *
- * The `actions` map is passed through as `actorActions` so the caller does not
- * need to manage it separately.
- *
  * @example
  * ```ts
  * import { defineRegistry } from "@xmachines/play-dom";
  * import { authCatalog } from "@xmachines/play-actor-shared";
- * import { Home, Login, Dashboard } from "./components/index.js";
  *
- * const { registry, actorActions } = defineRegistry(authCatalog, {
+ * const registryResult = defineRegistry(authCatalog, {
  *   components: { Home, Login, Dashboard, ... },
  *   actions: {
- *     login: "auth.login",
- *     logout: "auth.logout",
+ *     login: async ({ username }) => actor.send({ type: 'auth.login', username }),
+ *     logout: async () => actor.send({ type: 'auth.logout' }),
+ *     route: async ({ to, params }) => actor.send({ type: 'play.route', to, params }),
  *   },
  * });
  *
- * connectRenderer({ actor, registry, container, actions: actorActions });
+ * const { registry, handlers } = registryResult;
+ * const resolvedHandlers = handlers(() => undefined, () => ({}));
+ * connectRenderer({ actor, registry, container, handlers: resolvedHandlers });
  * ```
  */
 export declare function defineRegistry<C extends Catalog>(_catalog: C, options: DefineRegistryOptions<C>): DefineRegistryResult;

package/dist/json-render/types.d.ts.map

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

package/dist/json-render/types.js

@@ -9,9 +9,7 @@
  * - `defineRegistry(catalog, options)` — build a catalog-typed DomRegistry
  *
  * Key difference from framework renderers: `ComponentFn` returns
- * `HTMLElement | Text | null` instead of a framework node, and
- * `actions` is a `Record<string, string>` event-type map instead of
- * async handler functions (because DOM dispatches directly via `send`).
+ * `HTMLElement | Text | null` instead of a framework node.
  *
  * @packageDocumentation
  */
@@ -19,61 +17,53 @@ import { resolveActionParam } from "@json-render/core";
 /**
  * Build a `DomRegistry` from a catalog and component/action options.
  *
- * Mirrors the `defineRegistry(catalog, options)` API from @json-render/react,
- * /solid, /svelte, /vue. The catalog parameter is used for TypeScript inference
- * only (the same as in the framework renderers — it is not used at runtime).
- *
- * Each component in `options.components` is wrapped in a `DomComponentRenderer`
- * adapter that:
- * - Resolves props and two-way binding paths via `@json-render/core`
- * - Builds `emit(event)` and `on(event)` closures over the element's `on` map
- * - Renders child elements via `ctx.renderChildren`
- * - Passes the assembled `ComponentContext` to your `ComponentFn`
- *
- * The `actions` map is passed through as `actorActions` so the caller does not
- * need to manage it separately.
- *
  * @example
  * ```ts
  * import { defineRegistry } from "@xmachines/play-dom";
  * import { authCatalog } from "@xmachines/play-actor-shared";
- * import { Home, Login, Dashboard } from "./components/index.js";
  *
- * const { registry, actorActions } = defineRegistry(authCatalog, {
+ * const registryResult = defineRegistry(authCatalog, {
  *   components: { Home, Login, Dashboard, ... },
  *   actions: {
- *     login: "auth.login",
- *     logout: "auth.logout",
+ *     login: async ({ username }) => actor.send({ type: 'auth.login', username }),
+ *     logout: async () => actor.send({ type: 'auth.logout' }),
+ *     route: async ({ to, params }) => actor.send({ type: 'play.route', to, params }),
  *   },
  * });
  *
- * connectRenderer({ actor, registry, container, actions: actorActions });
+ * const { registry, handlers } = registryResult;
+ * const resolvedHandlers = handlers(() => undefined, () => ({}));
+ * connectRenderer({ actor, registry, container, handlers: resolvedHandlers });
  * ```
  */
 export function defineRegistry(_catalog, options) {
     const components = (options.components ?? {});
-    const actorActions = (options.actions ?? {});
+    const actionDefs = (options.actions ?? {});
     const registry = {};
     for (const key of Object.keys(components)) {
         const fn = components[key];
         registry[key] = (element, ctx) => {
             const onBindings = element.on ?? {};
-            const stateModel = ctx.store.getSnapshot();
             // ── emit ──────────────────────────────────────────────────────────
             const emit = (eventName) => {
                 const binding = onBindings[eventName];
                 if (!binding)
                     return;
+                // Read stateModel fresh on each emit so $state params resolve
+                // the latest store value (e.g. after the user has typed in an input).
+                const stateModel = ctx.store.getSnapshot();
                 const bindings = Array.isArray(binding) ? binding : [binding];
                 for (const b of bindings) {
-                    const xstateType = ctx.actorActions[b.action] ?? b.action;
-                    const params = {};
-                    if (b.params) {
-                        for (const [k, v] of Object.entries(b.params)) {
-                            params[k] = resolveActionParam(v, { stateModel });
+                    const handler = ctx.handlers[b.action];
+                    if (handler) {
+                        const params = {};
+                        if (b.params) {
+                            for (const [k, v] of Object.entries(b.params)) {
+                                params[k] = resolveActionParam(v, { stateModel });
+                            }
                         }
+                        void handler(params);
                     }
-                    ctx.send({ type: xstateType, ...params });
                 }
             };
             // ── on ────────────────────────────────────────────────────────────
@@ -85,20 +75,11 @@ export function defineRegistry(_catalog, options) {
                 const bindings = Array.isArray(binding) ? binding : [binding];
                 return {
                     emit: () => emit(eventName),
-                    // truthy check — matches @json-render/react and /solid
                     shouldPreventDefault: bindings.some((b) => b.preventDefault),
                     bound: true,
                 };
             };
-            // ── bindings ──────────────────────────────────────────────────────
-            // Pre-computed by renderSpec on the raw (unresolved) props before
-            // resolveElementProps ran — $bindState/$bindItem expressions are
-            // no longer present in element.props at this point.
             const bindings = ctx.elementBindings;
-            // ── children ──────────────────────────────────────────────────────
-            // Render children here (inside the wrapper) and pass them to the
-            // component. The outer renderSpec does NOT append children again —
-            // child rendering is solely the component's responsibility.
             const children = ctx.renderChildren(element.children ?? []);
             const componentCtx = {
                 props: element.props,
@@ -111,6 +92,10 @@ export function defineRegistry(_catalog, options) {
             return fn(componentCtx);
         };
     }
-    return { registry, actorActions };
+    // handlers factory — same pattern as framework renderers
+    const handlers = (_getSetState, _getState) => {
+        return { ...actionDefs };
+    };
+    return { registry, handlers };
 }
 //# sourceMappingURL=types.js.map

package/dist/json-render/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/json-render/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AA0SvD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAM,UAAU,cAAc,CAC7B,QAAW,EACX,OAAiC;IAEjC,MAAM,UAAU,GAAG,CAAC,OAAO,CAAC,UAAU,IAAI,EAAE,CAAyB,CAAC;IACtE,MAAM,YAAY,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAA2B,CAAC;IACvE,MAAM,QAAQ,GAAgB,EAAE,CAAC;IAEjC,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAwC,EAAE,CAAC;QAClF,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;QAE3B,QAAQ,CAAC,GAAa,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,EAAE,EAAE;YAC1C,MAAM,UAAU,GAAG,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC;YACpC,MAAM,UAAU,GAAG,GAAG,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;YAE3C,qEAAqE;YACrE,MAAM,IAAI,GAAG,CAAC,SAAiB,EAAQ,EAAE;gBACxC,MAAM,OAAO,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC;gBACtC,IAAI,CAAC,OAAO;oBAAE,OAAO;gBACrB,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;gBAC9D,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;oBAC1B,MAAM,UAAU,GAAG,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;oBAC1D,MAAM,MAAM,GAA4B,EAAE,CAAC;oBAC3C,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC;wBACd,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;4BAC/C,MAAM,CAAC,CAAC,CAAC,GAAG,kBAAkB,CAAC,CAAC,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;wBACnD,CAAC;oBACF,CAAC;oBACD,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;gBAC3C,CAAC;YACF,CAAC,CAAC;YAEF,qEAAqE;YACrE,MAAM,EAAE,GAAG,CAAC,SAAiB,EAAe,EAAE;gBAC7C,MAAM,OAAO,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC;gBACtC,IAAI,CAAC,OAAO,EAAE,CAAC;oBACd,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,oBAAoB,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;gBACtE,CAAC;gBACD,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;gBAC9D,OAAO;oBACN,IAAI,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC;oBAC3B,uDAAuD;oBACvD,oBAAoB,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC;oBAC5D,KAAK,EAAE,IAAI;iBACX,CAAC;YACH,CAAC,CAAC;YAEF,qEAAqE;YACrE,kEAAkE;YAClE,iEAAiE;YACjE,oDAAoD;YACpD,MAAM,QAAQ,GAAG,GAAG,CAAC,eAAe,CAAC;YAErC,qEAAqE;YACrE,iEAAiE;YACjE,mEAAmE;YACnE,4DAA4D;YAC5D,MAAM,QAAQ,GAAG,GAAG,CAAC,cAAc,CAAC,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;YAE5D,MAAM,YAAY,GAAoC;gBACrD,KAAK,EAAE,OAAO,CAAC,KAA2C;gBAC1D,QAAQ;gBACR,QAAQ;gBACR,IAAI;gBACJ,EAAE;gBACF,GAAG;aACH,CAAC;YAEF,OAAO,EAAE,CAAC,YAAY,CAAC,CAAC;QACzB,CAAC,CAAC;IACH,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC;AACnC,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/json-render/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AA8KvD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,cAAc,CAC7B,QAAW,EACX,OAAiC;IAEjC,MAAM,UAAU,GAAG,CAAC,OAAO,CAAC,UAAU,IAAI,EAAE,CAAyB,CAAC;IACtE,MAAM,UAAU,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAA6C,CAAC;IACvF,MAAM,QAAQ,GAAgB,EAAE,CAAC;IAEjC,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAwC,EAAE,CAAC;QAClF,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;QAE3B,QAAQ,CAAC,GAAa,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,EAAE,EAAE;YAC1C,MAAM,UAAU,GAAG,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC;YAEpC,qEAAqE;YACrE,MAAM,IAAI,GAAG,CAAC,SAAiB,EAAQ,EAAE;gBACxC,MAAM,OAAO,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC;gBACtC,IAAI,CAAC,OAAO;oBAAE,OAAO;gBACrB,8DAA8D;gBAC9D,sEAAsE;gBACtE,MAAM,UAAU,GAAG,GAAG,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;gBAC3C,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;gBAC9D,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;oBAC1B,MAAM,OAAO,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;oBACvC,IAAI,OAAO,EAAE,CAAC;wBACb,MAAM,MAAM,GAA4B,EAAE,CAAC;wBAC3C,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC;4BACd,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;gCAC/C,MAAM,CAAC,CAAC,CAAC,GAAG,kBAAkB,CAAC,CAAC,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;4BACnD,CAAC;wBACF,CAAC;wBACD,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;oBACtB,CAAC;gBACF,CAAC;YACF,CAAC,CAAC;YAEF,qEAAqE;YACrE,MAAM,EAAE,GAAG,CAAC,SAAiB,EAAe,EAAE;gBAC7C,MAAM,OAAO,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC;gBACtC,IAAI,CAAC,OAAO,EAAE,CAAC;oBACd,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,oBAAoB,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;gBACtE,CAAC;gBACD,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;gBAC9D,OAAO;oBACN,IAAI,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC;oBAC3B,oBAAoB,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC;oBAC5D,KAAK,EAAE,IAAI;iBACX,CAAC;YACH,CAAC,CAAC;YAEF,MAAM,QAAQ,GAAG,GAAG,CAAC,eAAe,CAAC;YACrC,MAAM,QAAQ,GAAG,GAAG,CAAC,cAAc,CAAC,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;YAE5D,MAAM,YAAY,GAAoC;gBACrD,KAAK,EAAE,OAAO,CAAC,KAA2C;gBAC1D,QAAQ;gBACR,QAAQ;gBACR,IAAI;gBACJ,EAAE;gBACF,GAAG;aACH,CAAC;YAEF,OAAO,EAAE,CAAC,YAAY,CAAC,CAAC;QACzB,CAAC,CAAC;IACH,CAAC;IAED,yDAAyD;IACzD,MAAM,QAAQ,GAAG,CAChB,YAA2B,EAC3B,SAA2B,EACK,EAAE;QAClC,OAAO,EAAE,GAAG,UAAU,EAAE,CAAC;IAC1B,CAAC,CAAC;IAEF,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;AAC/B,CAAC"}

package/dist/xm-types.d.ts

@@ -8,14 +8,17 @@
  */
 import type { AbstractActor, Viewable } from "@xmachines/play-actor";
 import type { AnyActorLogic } from "xstate";
-import type { StateStore } from "@json-render/core";
+import type { ActionHandler, StateStore } from "@json-render/core";
 import type { DomRegistry } from "./json-render/types.js";
 /**
  * Options for PlayRenderer.
  */
 export interface PlayDomOptions {
-    /** Map of json-render actionName → XState event type */
-    actions?: Record<string, string>;
+    /**
+     * Map of catalog action name → async ActionHandler function.
+     * Replaces the old `actions: Record<string, string>` string-map approach.
+     */
+    handlers?: Record<string, ActionHandler>;
     /**
      * Optional external StateStore (e.g. from `xstateStoreStateStore` in @json-render/xstate).
      * When provided, PlayRenderer operates in controlled mode — spec.state is ignored and
@@ -37,8 +40,11 @@ export interface ConnectRendererOptions {
     container: HTMLElement;
     /** Optional element shown when currentView is null (defaults to nothing — clears container) */
     fallback?: HTMLElement | null;
-    /** Map of json-render actionName → XState event type */
-    actions?: Record<string, string>;
+    /**
+     * Map of catalog action name → async ActionHandler function.
+     * Replaces the old `actions: Record<string, string>` string-map approach.
+     */
+    handlers?: Record<string, ActionHandler>;
     /**
      * Optional external StateStore (e.g. from `xstateStoreStateStore` in @json-render/xstate).
      * When provided, PlayRenderer operates in controlled mode — spec.state is ignored.

package/dist/xm-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"xm-types.d.ts","sourceRoot":"","sources":["../src/xm-types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAC5C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,cAAc;IAC9B,wDAAwD;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEjC;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,UAAU,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACtC,4EAA4E;IAC5E,KAAK,EAAE,aAAa,CAAC,aAAa,CAAC,GAAG,QAAQ,CAAC;IAE/C,sEAAsE;IACtE,QAAQ,EAAE,WAAW,CAAC;IAEtB,uCAAuC;IACvC,SAAS,EAAE,WAAW,CAAC;IAEvB,+FAA+F;IAC/F,QAAQ,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;IAE9B,wDAAwD;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEjC;;;;OAIG;IACH,KAAK,CAAC,EAAE,UAAU,CAAC;CACnB"}
+{"version":3,"file":"xm-types.d.ts","sourceRoot":"","sources":["../src/xm-types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAC5C,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACnE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,cAAc;IAC9B;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAEzC;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,UAAU,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACtC,4EAA4E;IAC5E,KAAK,EAAE,aAAa,CAAC,aAAa,CAAC,GAAG,QAAQ,CAAC;IAE/C,sEAAsE;IACtE,QAAQ,EAAE,WAAW,CAAC;IAEtB,uCAAuC;IACvC,SAAS,EAAE,WAAW,CAAC;IAEvB,+FAA+F;IAC/F,QAAQ,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;IAE9B;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAEzC;;;;OAIG;IACH,KAAK,CAAC,EAAE,UAAU,CAAC;CACnB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xmachines/play-dom",
-  "version": "1.0.0-beta.30",
+  "version": "1.0.0-beta.32",
   "description": "Vanilla DOM renderer for XMachines Play architecture with signal-driven rendering",
   "keywords": [
     "actor",
@@ -36,33 +36,33 @@
   },
   "scripts": {
     "build": "tsc --build",
-    "clean": "rm -rf dist *.tsbuildinfo coverage .vitest-attachments test/browser/__screenshots__ node_modules/.vite*",
+    "clean": "rm -rf dist *.tsbuildinfo coverage .vitest-attachments test/browser/__screenshots__",
     "lint": "oxlint .",
     "format": "oxfmt .",
     "test": "vitest",
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "@xmachines/play": "1.0.0-beta.30",
-    "@xmachines/play-actor": "1.0.0-beta.30",
-    "@xmachines/play-signals": "1.0.0-beta.30"
+    "@xmachines/play": "1.0.0-beta.32",
+    "@xmachines/play-actor": "1.0.0-beta.32",
+    "@xmachines/play-signals": "1.0.0-beta.32"
   },
   "devDependencies": {
-    "@json-render/core": "^0.16.0",
-    "@json-render/xstate": "^0.16.0",
-    "@types/node": "^25.5.0",
-    "@xmachines/shared": "1.0.0-beta.30",
-    "@xstate/store": ">=3.17.0",
-    "oxfmt": "^0.43.0",
-    "oxlint": "^1.57.0",
-    "typescript": "^5.9.3 || ^6.0.2",
-    "vitest": "^4.1.2",
+    "@json-render/core": "^0.18.0",
+    "@json-render/xstate": "^0.18.0",
+    "@types/node": "^25.6.0",
+    "@xmachines/shared": "1.0.0-beta.32",
+    "@xstate/store": "^3.17.0",
+    "oxfmt": "^0.45.0",
+    "oxlint": "^1.60.0",
+    "typescript": "^5.9.3 || ^6.0.3",
+    "vitest": "^4.1.4",
     "xstate": "^5.30.0"
   },
   "peerDependencies": {
-    "@json-render/core": "^0.16.0",
-    "@json-render/xstate": "^0.16.0",
-    "@xstate/store": ">=3.17.0",
+    "@json-render/core": "^0.18.0",
+    "@json-render/xstate": "^0.18.0",
+    "@xstate/store": "^3.17.0",
     "xstate": "^5.30.0"
   }
 }