@xmachines/play-react 1.0.0-beta.30 → 1.0.0-beta.31

package/README.md

@@ -38,7 +38,7 @@ without muting console output.
 - `useSignalEffect` — React hook for subscribing to TC39 Signals
 - `PlayErrorBoundary` — error boundary wrapping renderer output
 - `defineRegistry` — re-exported from `@json-render/react`
-- `useStateBinding` — re-exported from `@json-render/react`
+- `useBoundProp` — re-exported from `@json-render/react`
 - `ComponentFn` (type) — re-exported from `@json-render/react`
 - `ComponentContext` (type) — re-exported from `@json-render/react`
 - `PlayRendererProps` (type)
@@ -80,10 +80,18 @@ const Dashboard: ComponentFn<typeof catalog, "Dashboard"> = ({ props }) => (
 	<div>Welcome, {props.username}!</div>
 );
 
-// 3. Build registry — wires components to catalog and declares no-op action stubs
-const { registry } = defineRegistry(catalog, {
+// 3. Build registry — wires components to catalog and declares action handlers
+const registryResult = defineRegistry(catalog, {
 	components: { Login, Dashboard },
-	actions: { login: async () => {}, logout: async () => {} },
+	actions: {
+		login: async (params) => {
+			if (!params) return;
+			actor.send({ type: "auth.login", username: params.username });
+		},
+		logout: async () => {
+			actor.send({ type: "auth.logout" });
+		},
+	},
 });
 
 // 4. Define machine with view metadata
@@ -161,13 +169,7 @@ const actor = createPlayer();
 actor.start();
 
 function App() {
-	return (
-		<PlayRenderer
-			actor={actor}
-			registry={registry}
-			actions={{ login: "auth.login", logout: "auth.logout" }}
-		/>
-	);
+	return <PlayRenderer actor={actor} registryResult={registryResult} />;
 }
 ```
 
@@ -180,8 +182,7 @@ Main component. Subscribes to `actor.currentView` and renders the spec.
 ```tsx
 <PlayRenderer
 	actor={actor} // required
-	registry={registry} // required
-	actions={{ login: "auth.login" }} // optional
+	registryResult={registryResult} // required
 	store={myStore} // optional — controlled mode
 	fallback={<p>Loading…</p>} // optional
 />
@@ -189,22 +190,11 @@ Main component. Subscribes to `actor.currentView` and renders the spec.
 
 **`actor`** — A `PlayerActor` (or any `AbstractActor & Viewable`). Provides the `currentView` signal.
 
-**`registry`** — Built with `defineRegistry(catalog, { components, actions })` from `@xmachines/play-react`.
+**`registryResult`** — Full result from `defineRegistry(catalog, { components, actions })`. Pass the entire return value — contains both the component registry and action handlers. Action handlers are real async functions dispatching to the actor, not string event-type maps.
 
 `defineRegistry` also accepts `onRenderError(error, elementType)`, which receives errors
 caught by `@json-render/react`'s inner element boundary before the default logger is used.
 
-**`actions`** — Maps json-render action names (from spec `on` bindings) to XState event type strings. Values are type-checked against `EventFromLogic<TLogic>["type"]` when `TLogic` is specified:
-
-```tsx
-// Typed: "bad.event" causes a compile error if it is not in the machine's event union
-<PlayRenderer<typeof machine>
-	actor={actor}
-	registry={registry}
-	actions={{ login: "auth.login", logout: "auth.logout" }}
-/>
-```
-
 **`store`** (optional) — Controls per-view UI state (form values, `$state` bindings):
 
 - **Omitted (uncontrolled, default):** A fresh `@xstate/store` atom is created per view transition, seeded from `view.spec.state`. The atom resets automatically on each state transition.
@@ -217,16 +207,24 @@ import type { StateStore } from "@json-render/core";
 
 const store: StateStore = xstateStoreStateStore({ atom: createAtom({ username: "alice" }) });
 
-<PlayRenderer actor={actor} registry={registry} store={store} actions={{ login: "auth.login" }} />;
+<PlayRenderer actor={actor} registryResult={registryResult} store={store} />;
 ```
 
 **Inner render errors** — You can intercept catalog component render failures without
 overriding the outer `PlayErrorBoundary`:
 
 ```tsx
-const { registry } = defineRegistry(catalog, {
+const registryResult = defineRegistry(catalog, {
 	components: { Login, Dashboard },
-	actions: { login: async () => {}, logout: async () => {} },
+	actions: {
+		login: async (params) => {
+			if (!params) return;
+			actor.send({ type: "auth.login", username: params.username });
+		},
+		logout: async () => {
+			actor.send({ type: "auth.logout" });
+		},
+	},
 	onRenderError(error, elementType) {
 		reportExpectedRenderError(error, elementType);
 	},
@@ -289,7 +287,7 @@ import { PlayErrorBoundary } from "@xmachines/play-react";
 	fallback={<p>Something went wrong.</p>}
 	onError={(err, info) => Sentry.captureException(err, { extra: info })}
 >
-	<PlayRenderer actor={actor} registry={registry} />
+	<PlayRenderer actor={actor} registryResult={registryResult} />
 </PlayErrorBoundary>;
 ```
 
@@ -323,4 +321,4 @@ Priority: **route param fills `undefined` slots; explicit non-`undefined` spec p
 - React `useState` is **only** used to trigger re-renders — never for business logic
 - `actor.currentView` (TC39 Signal) is the sole render trigger; `PlayRenderer` is a passive observer
 - Per-view UI state lives in an `@xstate/store` atom, not in React state
-- `@json-render/react` drives rendering; `PlayRenderer` is the signal bridge — import `defineRegistry`, `ComponentFn`, `ComponentContext`, and `useStateBinding` from `@xmachines/play-react`
+- `@json-render/react` drives rendering; `PlayRenderer` is the signal bridge — import `defineRegistry`, `ComponentFn`, `ComponentContext`, and `useBoundProp` from `@xmachines/play-react`

package/dist/PlayRenderer.d.ts

@@ -14,7 +14,7 @@ import type { PlayRendererProps } from "./types.js";
  * Architecture:
  * - Subscribes to actor.currentView signal via useSignalEffect
  * - Renders view.spec via StateProvider → ActionProvider → VisibilityProvider → Renderer
- * - Routes action names to actor.send() via the `actions` prop mapping
+ * - Routes actions via registryResult.handlers() — real async functions dispatching to actor.
  * - State store: uses external `store` prop if provided (controlled mode); otherwise
  *   creates a fresh @xstate/store atom per view transition seeded from spec.state.
  *   The atom resets automatically when the actor transitions to a new view, mirroring
@@ -29,16 +29,23 @@ import type { PlayRendererProps } from "./types.js";
  * import { PlayRenderer } from "@xmachines/play-react";
  * import { defineRegistry } from "@json-render/react";
  *
- * const { registry } = defineRegistry(catalog, { components: { ... } });
+ * const registryResult = defineRegistry(catalog, {
+ *   components: { Login, Dashboard },
+ *   actions: {
+ *     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 }),
+ *   },
+ * });
  *
  * // Uncontrolled — fresh atom created per view, seeded from spec.state:
- * <PlayRenderer actor={actor} registry={registry} actions={{ login: "auth.login" }} />
+ * <PlayRenderer actor={actor} registryResult={registryResult} />
  *
  * // Controlled — caller provides and owns the store:
  * import { createAtom } from "@xstate/store";
  * import { xstateStoreStateStore } from "@json-render/xstate";
  * const store = xstateStoreStateStore({ atom: createAtom({ username: "" }) });
- * <PlayRenderer actor={actor} registry={registry} store={store} actions={{ login: "auth.login" }} />
+ * <PlayRenderer actor={actor} registryResult={registryResult} store={store} />
  * ```
  *
  * @param props - Component props

package/dist/PlayRenderer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PlayRenderer.d.ts","sourceRoot":"","sources":["../src/PlayRenderer.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAA2B,MAAM,OAAO,CAAC;AAOhD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAYpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,eAAO,MAAM,YAAY,EAAE,KAAK,CAAC,EAAE,CAAC,iBAAiB,CAqEpD,CAAC"}
+{"version":3,"file":"PlayRenderer.d.ts","sourceRoot":"","sources":["../src/PlayRenderer.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAA2B,MAAM,OAAO,CAAC;AAchD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAiDpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,eAAO,MAAM,YAAY,EAAE,KAAK,CAAC,EAAE,CAAC,iBAAiB,CAuDpD,CAAC"}

package/dist/PlayRenderer.js

@@ -1,4 +1,4 @@
-import { Fragment as _Fragment, jsx as _jsx } from "react/jsx-runtime";
+import { jsx as _jsx, Fragment as _Fragment } from "react/jsx-runtime";
 /**
  * PlayRenderer - Main React renderer component for XMachines Play architecture
  *
@@ -7,7 +7,7 @@ import { Fragment as _Fragment, jsx as _jsx } from "react/jsx-runtime";
  * @packageDocumentation
  */
 import React, { useState, useRef } from "react";
-import { Renderer, StateProvider, ActionProvider, VisibilityProvider } from "@json-render/react";
+import { Renderer, StateProvider, ActionProvider, VisibilityProvider, useStateStore, } from "@json-render/react";
 import { createAtom } from "@xstate/store";
 import { xstateStoreStateStore } from "@json-render/xstate";
 import { useSignalEffect } from "./useSignalEffect.js";
@@ -20,6 +20,23 @@ import { ActorContext } from "./useActor.js";
 function createViewStore(initialState) {
     return xstateStoreStateStore({ atom: createAtom(initialState) });
 }
+/**
+ * Inner component that runs inside StateProvider so it can access StateStore context
+ * via useStateStore(). Resolves action handlers from registryResult.handlers() using
+ * the live StateProvider set/getSnapshot functions, then renders ActionProvider.
+ */
+function PlayRendererInner({ registryResult, spec, }) {
+    const stateCtx = useStateStore();
+    // Build a SetState adapter: the handlers factory expects an updater-function pattern
+    // ((prev) => next), while stateCtx provides path-based set/update. This adapter
+    // bridges the two so action functions can use setState if needed.
+    const setStateAdapter = (updater) => {
+        const prev = stateCtx.getSnapshot();
+        stateCtx.update(updater(prev));
+    };
+    const handlers = registryResult.handlers(() => setStateAdapter, () => stateCtx.getSnapshot());
+    return (_jsx(ActionProvider, { handlers: handlers, children: _jsx(VisibilityProvider, { children: _jsx(Renderer, { spec: spec, registry: registryResult.registry }) }) }));
+}
 /**
  * Main renderer component that subscribes to actor signals and renders UI
  * via @json-render/react Renderer.
@@ -27,7 +44,7 @@ function createViewStore(initialState) {
  * Architecture:
  * - Subscribes to actor.currentView signal via useSignalEffect
  * - Renders view.spec via StateProvider → ActionProvider → VisibilityProvider → Renderer
- * - Routes action names to actor.send() via the `actions` prop mapping
+ * - Routes actions via registryResult.handlers() — real async functions dispatching to actor.
  * - State store: uses external `store` prop if provided (controlled mode); otherwise
  *   creates a fresh @xstate/store atom per view transition seeded from spec.state.
  *   The atom resets automatically when the actor transitions to a new view, mirroring
@@ -42,22 +59,29 @@ function createViewStore(initialState) {
  * import { PlayRenderer } from "@xmachines/play-react";
  * import { defineRegistry } from "@json-render/react";
  *
- * const { registry } = defineRegistry(catalog, { components: { ... } });
+ * const registryResult = defineRegistry(catalog, {
+ *   components: { Login, Dashboard },
+ *   actions: {
+ *     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 }),
+ *   },
+ * });
  *
  * // Uncontrolled — fresh atom created per view, seeded from spec.state:
- * <PlayRenderer actor={actor} registry={registry} actions={{ login: "auth.login" }} />
+ * <PlayRenderer actor={actor} registryResult={registryResult} />
  *
  * // Controlled — caller provides and owns the store:
  * import { createAtom } from "@xstate/store";
  * import { xstateStoreStateStore } from "@json-render/xstate";
  * const store = xstateStoreStateStore({ atom: createAtom({ username: "" }) });
- * <PlayRenderer actor={actor} registry={registry} store={store} actions={{ login: "auth.login" }} />
+ * <PlayRenderer actor={actor} registryResult={registryResult} store={store} />
  * ```
  *
  * @param props - Component props
  * @returns React element rendering current view from actor
  */
-export const PlayRenderer = ({ actor, registry, store: externalStore, fallback = null, onError, actions = {}, }) => {
+export const PlayRenderer = ({ actor, registryResult, store: externalStore, fallback = null, onError, }) => {
     // React state for triggering re-renders (NOT business logic state)
     // Signal is source of truth, useState is just React's render trigger
     const [view, setView] = useState(() => actor.currentView.get());
@@ -92,12 +116,6 @@ export const PlayRenderer = ({ actor, registry, store: externalStore, fallback =
         }
         store = internalStoreRef.current;
     }
-    // Build ActionProvider handlers from actions mapping
-    // Each handler calls actor.send() with the configured event type + params
-    const handlers = Object.fromEntries(Object.entries(actions).map(([actionName, eventType]) => [
-        actionName,
-        async (params = {}) => actor.send({ type: eventType, ...params }),
-    ]));
-    return (_jsx(ActorContext.Provider, { value: actor, children: _jsx(PlayErrorBoundary, { fallback: fallback, ...(onError && { onError }), children: _jsx(StateProvider, { store: store, children: _jsx(ActionProvider, { handlers: handlers, children: _jsx(VisibilityProvider, { children: _jsx(Renderer, { spec: view.spec ?? null, registry: registry }) }) }) }) }) }));
+    return (_jsx(ActorContext.Provider, { value: actor, children: _jsx(PlayErrorBoundary, { fallback: fallback, ...(onError && { onError }), children: _jsx(StateProvider, { store: store, children: _jsx(PlayRendererInner, { registryResult: registryResult, spec: view.spec ?? null }) }) }) }));
 };
 //# sourceMappingURL=PlayRenderer.js.map

package/dist/PlayRenderer.js.map

@@ -1 +1 @@
-{"version":3,"file":"PlayRenderer.js","sourceRoot":"","sources":["../src/PlayRenderer.tsx"],"names":[],"mappings":";AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAEjG,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAG3D,OAAO,EAAE,YAAY,EAAkB,MAAM,eAAe,CAAC;AAE7D;;;GAGG;AACH,SAAS,eAAe,CAAC,YAAqC;IAC7D,OAAO,qBAAqB,CAAC,EAAE,IAAI,EAAE,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;AAClE,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,MAAM,CAAC,MAAM,YAAY,GAAgC,CAAC,EACzD,KAAK,EACL,QAAQ,EACR,KAAK,EAAE,aAAa,EACpB,QAAQ,GAAG,IAAI,EACf,OAAO,EACP,OAAO,GAAG,EAAE,GACZ,EAAE,EAAE;IACJ,mEAAmE;IACnE,qEAAqE;IACrE,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAsB,GAAG,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC,CAAC;IAErF,+DAA+D;IAC/D,qFAAqF;IACrF,0CAA0C;IAC1C,MAAM,gBAAgB,GAAG,MAAM,CAAoB,IAAI,CAAC,CAAC;IACzD,MAAM,WAAW,GAAG,MAAM,CAAsB,IAAI,CAAC,CAAC;IAEtD,8BAA8B;IAC9B,eAAe,CAAC,GAAG,EAAE;QACpB,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC;QAC5C,OAAO,CAAC,WAAW,CAAC,CAAC;IACtB,CAAC,CAAC,CAAC;IAEH,6CAA6C;IAC7C,IAAI,CAAC,IAAI,EAAE,CAAC;QACX,OAAO,4BAAG,QAAQ,GAAI,CAAC;IACxB,CAAC;IAED,8CAA8C;IAC9C,+DAA+D;IAC/D,0EAA0E;IAC1E,IAAI,KAAiB,CAAC;IACtB,IAAI,aAAa,EAAE,CAAC;QACnB,KAAK,GAAG,aAAa,CAAC;IACvB,CAAC;SAAM,CAAC;QACP,6DAA6D;QAC7D,mEAAmE;QACnE,IAAI,gBAAgB,CAAC,OAAO,KAAK,IAAI,IAAI,WAAW,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;YACvE,MAAM,YAAY,GAAI,IAAI,CAAC,IAAI,EAAE,KAAiC,IAAI,EAAE,CAAC;YACzE,gBAAgB,CAAC,OAAO,GAAG,eAAe,CAAC,YAAY,CAAC,CAAC;YACzD,WAAW,CAAC,OAAO,GAAG,IAAI,CAAC;QAC5B,CAAC;QACD,KAAK,GAAG,gBAAgB,CAAC,OAAO,CAAC;IAClC,CAAC;IAED,qDAAqD;IACrD,0EAA0E;IAC1E,MAAM,QAAQ,GAAkC,MAAM,CAAC,WAAW,CACjE,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,EAAE,SAAS,CAAC,EAAE,EAAE,CAAC;QACxD,UAAU;QACV,KAAK,EAAE,SAAkC,EAAE,EAAE,EAAE,CAC9C,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,MAAM,EAAE,CAAC;KAC3C,CAAC,CACF,CAAC;IAEF,OAAO,CACN,KAAC,YAAY,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAkB,YAC/C,KAAC,iBAAiB,IAAC,QAAQ,EAAE,QAAQ,KAAM,CAAC,OAAO,IAAI,EAAE,OAAO,EAAE,CAAC,YAClE,KAAC,aAAa,IAAC,KAAK,EAAE,KAAK,YAC1B,KAAC,cAAc,IAAC,QAAQ,EAAE,QAAQ,YACjC,KAAC,kBAAkB,cAClB,KAAC,QAAQ,IAAC,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,IAAI,EAAE,QAAQ,EAAE,QAAQ,GAAI,GACrC,GACL,GACF,GACG,GACG,CACxB,CAAC;AACH,CAAC,CAAC"}
+{"version":3,"file":"PlayRenderer.js","sourceRoot":"","sources":["../src/PlayRenderer.tsx"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -9,7 +9,7 @@
  * **Key principle:** React state is NEVER used for business logic—only for
  * triggering React's render cycle. Signals are the source of truth.
  *
- * Re-exports `defineRegistry`, `useStateBinding`, `ComponentFn`, and
+ * Re-exports `defineRegistry`, `useBoundProp`, `ComponentFn`, and
  * `ComponentContext` from `@json-render/react` so consumers import everything
  * from `@xmachines/play-react` rather than `@json-render/react` directly.
  *
@@ -20,7 +20,7 @@ export { PlayRenderer } from "./PlayRenderer.js";
 export { useSignalEffect } from "./useSignalEffect.js";
 export { PlayErrorBoundary } from "./PlayErrorBoundary.js";
 export { useActor } from "./useActor.js";
-export { defineRegistry, useStateBinding, useBoundProp } from "@json-render/react";
+export { defineRegistry, useBoundProp } from "@json-render/react";
 export type { ComponentFn, ComponentContext } from "@json-render/react";
 export type { PlayRendererProps } from "./types.js";
 export type { PlayErrorBoundaryProps, PlayErrorBoundaryState } from "./PlayErrorBoundary.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAGzC,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACnF,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAGxE,YAAY,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACpD,YAAY,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAC7F,YAAY,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAGzC,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClE,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAGxE,YAAY,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACpD,YAAY,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAC7F,YAAY,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -9,7 +9,7 @@
  * **Key principle:** React state is NEVER used for business logic—only for
  * triggering React's render cycle. Signals are the source of truth.
  *
- * Re-exports `defineRegistry`, `useStateBinding`, `ComponentFn`, and
+ * Re-exports `defineRegistry`, `useBoundProp`, `ComponentFn`, and
  * `ComponentContext` from `@json-render/react` so consumers import everything
  * from `@xmachines/play-react` rather than `@json-render/react` directly.
  *
@@ -23,5 +23,5 @@ export { PlayErrorBoundary } from "./PlayErrorBoundary.js";
 export { useActor } from "./useActor.js";
 // Re-export from @json-render/react so consumers import everything from @xmachines/play-react.
 // React's useContext works anywhere in the call tree — no wrapper needed.
-export { defineRegistry, useStateBinding, useBoundProp } from "@json-render/react";
+export { defineRegistry, useBoundProp } from "@json-render/react";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,eAAe;AACf,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,+FAA+F;AAC/F,0EAA0E;AAC1E,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,eAAe;AACf,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,+FAA+F;AAC/F,0EAA0E;AAC1E,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/types.d.ts

@@ -3,43 +3,52 @@
  *
  * @packageDocumentation
  */
-import type { ComponentRegistry } from "@json-render/react";
+import type { DefineRegistryResult } from "@json-render/react";
 import type { StateStore } from "@json-render/core";
 import type { AbstractActor, Viewable } from "@xmachines/play-actor";
 import type React from "react";
-import type { AnyActorLogic, EventFromLogic } from "xstate";
+import type { AnyActorLogic } from "xstate";
 /**
  * Props for PlayRenderer component
  *
  * @typeParam TLogic - The XState actor logic type. Defaults to `AnyActorLogic` for
- *   non-generic usage. When a specific machine type is provided, the `actions` values
- *   are constrained to the event type strings that the machine actually accepts.
+ *   non-generic usage.
  *
  * @property actor - Actor instance with currentView signal (requires Viewable capability)
- * @property registry - ComponentRegistry from defineRegistry() in @json-render/react
- * @property store - Optional external StateStore (e.g. from @json-render/xstate). When
- *   provided, PlayRenderer operates in controlled mode — spec.state is ignored and the
- *   store is the single source of truth for UI state. When omitted, a fresh
- *   @xstate/store atom is created internally per view transition, seeded from spec.state.
+ * @property registryResult - Full result from defineRegistry() in @json-render/react.
+ *   Contains both the component registry and the action handlers factory. Action handlers
+ *   are real async functions dispatching to the actor (not string-mapped event types).
+ * @property store - Optional external StateStore (controlled mode).
  * @property fallback - Optional component shown when currentView is null
  * @property onError - Optional callback invoked when a catalog component throws during render.
- *   Receives the error and React ErrorInfo — use to forward to Sentry, Datadog, etc.
- * @property actions - Maps json-render action names to XState event type strings.
- *   Values are constrained to `EventFromLogic<TLogic>["type"]` — passing a non-existent
- *   event type string is a compile error when TLogic is specified.
  */
 export interface PlayRendererProps<TLogic extends AnyActorLogic = AnyActorLogic> {
     /** Actor instance with currentView signal (requires Viewable capability) */
     actor: AbstractActor<TLogic> & Viewable;
-    /** ComponentRegistry from defineRegistry() in @json-render/react */
-    registry: ComponentRegistry;
+    /**
+     * Full result from defineRegistry() — contains component registry and action handlers.
+     * Action handlers are async functions that dispatch to the actor (not string-mapped
+     * event type stubs). Replaces the old `registry` + `actions` prop pair.
+     *
+     * @example
+     * ```tsx
+     * const registryResult = defineRegistry(catalog, {
+     *   components: { Login, Dashboard },
+     *   actions: {
+     *     login: async ({ username }) => actor.send({ type: 'auth.login', username }),
+     *     logout: async () => actor.send({ type: 'auth.logout' }),
+     *   },
+     * });
+     * <PlayRenderer actor={actor} registryResult={registryResult} />
+     * ```
+     */
+    registryResult: DefineRegistryResult;
     /**
      * Optional external StateStore (e.g. from `xstateStoreStateStore` in @json-render/xstate).
      * When provided, PlayRenderer operates in controlled mode — spec.state is ignored and
      * this store is the single source of truth for UI state (form values, etc.).
      * When omitted, a fresh @xstate/store atom is created internally per view transition,
-     * seeded from spec.state. The atom resets automatically when the actor transitions to a
-     * new view, mirroring the actor's currentView lifecycle.
+     * seeded from spec.state.
      */
     store?: StateStore;
     /** Optional component shown when currentView is null or a catalog component throws */
@@ -51,17 +60,9 @@ export interface PlayRendererProps<TLogic extends AnyActorLogic = AnyActorLogic>
      *
      * @example
      * ```tsx
-     * <PlayRenderer actor={actor} registry={registry} onError={Sentry.captureException} />
+     * <PlayRenderer actor={actor} registryResult={registryResult} onError={Sentry.captureException} />
      * ```
      */
     onError?: (error: Error, info: React.ErrorInfo) => void;
-    /**
-     * Maps json-render action names to XState event type strings.
-     * Values are constrained to valid event types for TLogic — wrong event type strings
-     * are caught at compile time when TLogic is specified.
-     */
-    actions?: {
-        [actionName: string]: EventFromLogic<TLogic>["type"];
-    };
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAE5D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,iBAAiB,CAAC,MAAM,SAAS,aAAa,GAAG,aAAa;IAC9E,4EAA4E;IAC5E,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,QAAQ,CAAC;IAExC,oEAAoE;IACpE,QAAQ,EAAE,iBAAiB,CAAC;IAE5B;;;;;;;OAOG;IACH,KAAK,CAAC,EAAE,UAAU,CAAC;IAEnB,sFAAsF;IACtF,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAE3B;;;;;;;;;OASG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,SAAS,KAAK,IAAI,CAAC;IAExD;;;;OAIG;IACH,OAAO,CAAC,EAAE;QAAE,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAA;KAAE,CAAC;CACnE"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAE5C;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,iBAAiB,CAAC,MAAM,SAAS,aAAa,GAAG,aAAa;IAC9E,4EAA4E;IAC5E,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,QAAQ,CAAC;IAExC;;;;;;;;;;;;;;;;OAgBG;IACH,cAAc,EAAE,oBAAoB,CAAC;IAErC;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,UAAU,CAAC;IAEnB,sFAAsF;IACtF,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAE3B;;;;;;;;;OASG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,SAAS,KAAK,IAAI,CAAC;CACxD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xmachines/play-react",
-  "version": "1.0.0-beta.30",
+  "version": "1.0.0-beta.31",
   "description": "React renderer for XMachines Play architecture with signal-driven rendering",
   "keywords": [
     "actor",
@@ -45,9 +45,9 @@
     "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.31",
+    "@xmachines/play-actor": "1.0.0-beta.31",
+    "@xmachines/play-signals": "1.0.0-beta.31"
   },
   "devDependencies": {
     "@json-render/core": "^0.16.0",
@@ -58,7 +58,7 @@
     "@types/node": "^25.5.0",
     "@types/react": "^19.2.14",
     "@types/react-dom": "^19.2.3",
-    "@xmachines/shared": "1.0.0-beta.30",
+    "@xmachines/shared": "1.0.0-beta.31",
     "@xstate/store": ">=3.17.0",
     "jsdom": "^29.0.1",
     "oxfmt": "^0.43.0",