@xmachines/docs 1.0.0-beta.53 → 1.0.0-beta.55

package/api/@xmachines/play-dom-router/interfaces/RoutableActor.md

@@ -2,7 +2,7 @@
 
 # Interface: RoutableActor
 
-Defined in: [play-router/src/types.ts:259](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.53/packages/play-router/src/types.ts#L259)
+Defined in: [play-router/src/types.ts:259](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/packages/play-router/src/types.ts#L259)
 
 Minimal actor interface required by `RouterBridgeBase` and all framework router
 adapters.
@@ -42,8 +42,8 @@ class MyBridge extends RouterBridgeBase {
 
 | Property                                          | Modifier   | Type                                                                                         | Description                                                                                                                                                                                                   | Defined in                                                                                                                              |
 | ------------------------------------------------- | ---------- | -------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
-| <a id="property-currentroute"></a> `currentRoute` | `readonly` | [`Computed`](../../play-signals/namespaces/Signal/classes/Computed.md)\<`string` \| `null`\> | TC39 Signal exposing the actor's current URL path (or state ID).                                                                                                                                              | [play-router/src/types.ts:261](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.53/packages/play-router/src/types.ts#L261) |
-| <a id="property-initialroute"></a> `initialRoute` | `readonly` | `string` \| `null`                                                                           | The route derived from the machine's initial state — fixed at construction. Router bridges compare this against the browser URL to distinguish a deep-link (router wins) from a session restore (actor wins). | [play-router/src/types.ts:267](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.53/packages/play-router/src/types.ts#L267) |
+| <a id="property-currentroute"></a> `currentRoute` | `readonly` | [`Computed`](../../play-signals/namespaces/Signal/classes/Computed.md)\<`string` \| `null`\> | TC39 Signal exposing the actor's current URL path (or state ID).                                                                                                                                              | [play-router/src/types.ts:261](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/packages/play-router/src/types.ts#L261) |
+| <a id="property-initialroute"></a> `initialRoute` | `readonly` | `string` \| `null`                                                                           | The route derived from the machine's initial state — fixed at construction. Router bridges compare this against the browser URL to distinguish a deep-link (router wins) from a session restore (actor wins). | [play-router/src/types.ts:267](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/packages/play-router/src/types.ts#L267) |
 
 ## Methods
 
@@ -53,7 +53,7 @@ class MyBridge extends RouterBridgeBase {
 send(event): void;
 ```
 
-Defined in: [play-router/src/types.ts:269](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.53/packages/play-router/src/types.ts#L269)
+Defined in: [play-router/src/types.ts:269](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/packages/play-router/src/types.ts#L269)
 
 Send a route navigation event to the actor.
 

package/api/@xmachines/play-dom-router/interfaces/RouteLookupContract.md

@@ -2,13 +2,17 @@
 
 # Interface: RouteLookupContract
 
-Defined in: [play-dom-router/src/connect-router.ts:11](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.53/packages/play-dom-router/src/connect-router.ts#L11)
+Defined in: [play-dom-router/src/connect-router.ts:15](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/packages/play-dom-router/src/connect-router.ts#L15)
 
 Structural route lookup interface accepted by [connectRouter](../functions/connectRouter.md).
 
 Any object with these two methods satisfies the constraint — including
 `RouteMap` instances, subclasses, and plain test objects.
 
+`getPathByStateId` may receive the stateId in either `"#stateId"` or bare
+`"stateId"` form — the bridge tries both forms automatically, so
+implementations keyed on a single form still resolve.
+
 ## Methods
 
 ### getPathByStateId()
@@ -17,7 +21,7 @@ Any object with these two methods satisfies the constraint — including
 getPathByStateId(id): string | null | undefined;
 ```
 
-Defined in: [play-dom-router/src/connect-router.ts:13](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.53/packages/play-dom-router/src/connect-router.ts#L13)
+Defined in: [play-dom-router/src/connect-router.ts:17](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/packages/play-dom-router/src/connect-router.ts#L17)
 
 #### Parameters
 
@@ -37,7 +41,7 @@ Defined in: [play-dom-router/src/connect-router.ts:13](https://gitlab.com/xmachi
 getStateIdByPath(path): string | null | undefined;
 ```
 
-Defined in: [play-dom-router/src/connect-router.ts:12](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.53/packages/play-dom-router/src/connect-router.ts#L12)
+Defined in: [play-dom-router/src/connect-router.ts:16](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/packages/play-dom-router/src/connect-router.ts#L16)
 
 #### Parameters
 

package/api/@xmachines/play-dom-router/interfaces/RouteMap.md

@@ -2,7 +2,7 @@
 
 # Interface: RouteMap
 
-Defined in: [play-router/src/base-route-map.ts:100](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.53/packages/play-router/src/base-route-map.ts#L100)
+Defined in: [play-router/src/base-route-map.ts:101](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/packages/play-router/src/base-route-map.ts#L101)
 
 Shared bidirectional route map base class.
 
@@ -17,10 +17,17 @@ own and inherit the full public API from here.
 - Results are cached after the first match in an LRU cache (default 500 entries,
   configurable via the `cacheSize` constructor option)
 
-**Pattern syntax** (`:param` / `:param?`):
+**Pattern syntax** (`:param` / `:param?` / `*`):
 
 - `:param` — required segment, matches exactly one non-`/` segment
 - `:param?` — optional segment, matches zero or one non-`/` segment
+- `*` — wildcard, matches any number of segments (URLPattern semantics)
+
+**StateId forms:** stateIds may be registered and looked up in either
+`"#stateId"` or `"stateId"` form — `RouteMap` canonicalizes internally.
+`getStateIdByPath` returns the stateId exactly as registered;
+`getPathByStateId` accepts both forms. Registering the same stateId in both
+forms refers to one entry (the later registration wins for reverse lookup).
 
 ## Example
 
@@ -50,10 +57,14 @@ map.getPathByStateId("missing"); // null
 getPathByStateId(stateId): string | null;
 ```
 
-Defined in: [play-router/src/base-route-map.ts:209](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.53/packages/play-router/src/base-route-map.ts#L209)
+Defined in: [play-router/src/base-route-map.ts:218](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/packages/play-router/src/base-route-map.ts#L218)
 
 Look up the path pattern registered for a state ID.
 
+Accepts the stateId in either `"#stateId"` or `"stateId"` form regardless of
+which form was used at registration — lookups are canonicalized internally,
+so consumers never need to try both forms.
+
 #### Parameters
 
 | Parameter | Type     | Description                                               |
@@ -70,6 +81,7 @@ The registered path pattern, or `null` if the state ID is unknown
 
 ```typescript
 map.getPathByStateId("profile"); // "/profile/:userId"
+map.getPathByStateId("#profile"); // "/profile/:userId" (same entry)
 map.getPathByStateId("missing"); // null
 ```
 
@@ -81,7 +93,7 @@ map.getPathByStateId("missing"); // null
 getStateIdByPath(path): string | null;
 ```
 
-Defined in: [play-router/src/base-route-map.ts:174](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.53/packages/play-router/src/base-route-map.ts#L174)
+Defined in: [play-router/src/base-route-map.ts:178](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/packages/play-router/src/base-route-map.ts#L178)
 
 Resolve a URL path to its mapped state ID.
 

package/api/@xmachines/play-dom-router/interfaces/RouteMapOptions.md

@@ -2,7 +2,7 @@
 
 # Interface: RouteMapOptions
 
-Defined in: [play-router/src/create-route-map.ts:9](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.53/packages/play-router/src/create-route-map.ts#L9)
+Defined in: [play-router/src/create-route-map.ts:9](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/packages/play-router/src/create-route-map.ts#L9)
 
 Options for `createRouteMap` and `createRouteMapFromTree`.
 
@@ -10,4 +10,4 @@ Options for `createRouteMap` and `createRouteMapFromTree`.
 
 | Property                                     | Type     | Description                                                                                                                                                                                                                                                                                                                                                                                | Defined in                                                                                                                                                  |
 | -------------------------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| <a id="property-cachesize"></a> `cacheSize?` | `number` | Maximum number of resolved parameterized path lookups to cache. `RouteMap.getStateIdByPath()` resolves parameterized patterns (e.g. `/profile/:userId`) via URLPattern on every call. Frequently visited paths are cached in an LRU so subsequent lookups are O(1). Increase this value for applications with large parameterized route sets or high navigation frequency. Default: `500`. | [play-router/src/create-route-map.ts:20](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.53/packages/play-router/src/create-route-map.ts#L20) |
+| <a id="property-cachesize"></a> `cacheSize?` | `number` | Maximum number of resolved parameterized path lookups to cache. `RouteMap.getStateIdByPath()` resolves parameterized patterns (e.g. `/profile/:userId`) via URLPattern on every call. Frequently visited paths are cached in an LRU so subsequent lookups are O(1). Increase this value for applications with large parameterized route sets or high navigation frequency. Default: `500`. | [play-router/src/create-route-map.ts:20](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/packages/play-router/src/create-route-map.ts#L20) |

package/api/@xmachines/play-dom-router/interfaces/RouteMapping.md

@@ -2,7 +2,7 @@
 
 # Interface: RouteMapping
 
-Defined in: [play-router/src/base-route-map.ts:57](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.53/packages/play-router/src/base-route-map.ts#L57)
+Defined in: [play-router/src/base-route-map.ts:51](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/packages/play-router/src/base-route-map.ts#L51)
 
 A single state ID ↔ path mapping entry.
 
@@ -23,5 +23,5 @@ const optionalMapping: RouteMapping = { stateId: "settings", path: "/settings/:s
 
 | Property                                | Modifier   | Type     | Description                                                                   | Defined in                                                                                                                                              |
 | --------------------------------------- | ---------- | -------- | ----------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| <a id="property-path"></a> `path`       | `readonly` | `string` | URL path pattern (e.g., `"/"`, `"/profile/:userId"`, `"/settings/:section?"`) | [play-router/src/base-route-map.ts:61](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.53/packages/play-router/src/base-route-map.ts#L61) |
-| <a id="property-stateid"></a> `stateId` | `readonly` | `string` | State machine state ID (e.g., `"home"`, `"#profile"`)                         | [play-router/src/base-route-map.ts:59](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.53/packages/play-router/src/base-route-map.ts#L59) |
+| <a id="property-path"></a> `path`       | `readonly` | `string` | URL path pattern (e.g., `"/"`, `"/profile/:userId"`, `"/settings/:section?"`) | [play-router/src/base-route-map.ts:55](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/packages/play-router/src/base-route-map.ts#L55) |
+| <a id="property-stateid"></a> `stateId` | `readonly` | `string` | State machine state ID (e.g., `"home"`, `"#profile"`)                         | [play-router/src/base-route-map.ts:53](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/packages/play-router/src/base-route-map.ts#L53) |

package/api/@xmachines/play-dom-router/interfaces/RouterBridge.md

@@ -2,11 +2,11 @@
 
 # Interface: RouterBridge
 
-Defined in: [play-router/src/types.ts:341](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.53/packages/play-router/src/types.ts#L341)
+Defined in: [play-router/src/types.ts:341](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/packages/play-router/src/types.ts#L341)
 
 RouterBridge interface for runtime infrastructure adapters
 
-Defines the lifecycle connection between Infrastructure (e.g., TanStack Router) and
+Defines the lifecycle connection between Infrastructure (e.g., a framework router) and
 the Actor. Infrastructure "bridges" to the Actor by observing its signals and
 managing its own lifecycle accordingly.
 
@@ -16,13 +16,13 @@ a unidirectional observation pattern. Infrastructure connects to observe Actor s
 
 ## Example
 
-TanStack Router bridge implementation
+Framework router bridge implementation
 
 ```typescript
 import type { RouterBridge } from "@xmachines/play-router";
 import { Signal } from "@xmachines/play-signals";
 
-class TanStackRouterBridge implements RouterBridge {
+class MyRouterBridge implements RouterBridge {
 	private watcher: Signal.Watcher | null = null;
 
 	async connect(): Promise<void> {
@@ -54,7 +54,7 @@ class TanStackRouterBridge implements RouterBridge {
 connect(): void | Promise<void>;
 ```
 
-Defined in: [play-router/src/types.ts:357](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.53/packages/play-router/src/types.ts#L357)
+Defined in: [play-router/src/types.ts:357](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/packages/play-router/src/types.ts#L357)
 
 Connect the router bridge to the Actor
 
@@ -83,7 +83,7 @@ await bridge.connect();
 disconnect(): void | Promise<void>;
 ```
 
-Defined in: [play-router/src/types.ts:373](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.53/packages/play-router/src/types.ts#L373)
+Defined in: [play-router/src/types.ts:373](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/packages/play-router/src/types.ts#L373)
 
 Disconnect the router bridge from the Actor
 

package/api/@xmachines/play-dom-router/interfaces/VanillaRouter.md

@@ -2,14 +2,14 @@
 
 # Interface: VanillaRouter
 
-Defined in: [play-dom-router/src/create-router.ts:4](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.53/packages/play-dom-router/src/create-router.ts#L4)
+Defined in: [play-dom-router/src/create-router.ts:4](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/packages/play-dom-router/src/create-router.ts#L4)
 
 ## Properties
 
 | Property                                    | Modifier   | Type                                                     | Description                          | Defined in                                                                                                                                                    |
 | ------------------------------------------- | ---------- | -------------------------------------------------------- | ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| <a id="property-history"></a> `history`     | `readonly` | [`BrowserHistory`](BrowserHistory.md)                    | History instance                     | [play-dom-router/src/create-router.ts:8](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.53/packages/play-dom-router/src/create-router.ts#L8)   |
-| <a id="property-routetree"></a> `routeTree` | `readonly` | [`RouteTree`](../../play-router/interfaces/RouteTree.md) | Route tree (for structure reference) | [play-dom-router/src/create-router.ts:13](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.53/packages/play-dom-router/src/create-router.ts#L13) |
+| <a id="property-history"></a> `history`     | `readonly` | [`BrowserHistory`](BrowserHistory.md)                    | History instance                     | [play-dom-router/src/create-router.ts:8](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/packages/play-dom-router/src/create-router.ts#L8)   |
+| <a id="property-routetree"></a> `routeTree` | `readonly` | [`RouteTree`](../../play-router/interfaces/RouteTree.md) | Route tree (for structure reference) | [play-dom-router/src/create-router.ts:13](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/packages/play-dom-router/src/create-router.ts#L13) |
 
 ## Methods
 
@@ -19,7 +19,7 @@ Defined in: [play-dom-router/src/create-router.ts:4](https://gitlab.com/xmachin-
 destroy(): void;
 ```
 
-Defined in: [play-dom-router/src/create-router.ts:18](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.53/packages/play-dom-router/src/create-router.ts#L18)
+Defined in: [play-dom-router/src/create-router.ts:18](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/packages/play-dom-router/src/create-router.ts#L18)
 
 Cleanup
 

package/api/@xmachines/play-react/README.md

@@ -110,7 +110,7 @@ function MyComponent({ actor }) {
 
 	useSignalEffect(() => {
 		setView(actor.currentView.get());
-	});
+	}, [actor]); // deps: re-subscribe when the actor prop swaps
 
 	return <div>{view?.component}</div>;
 }
@@ -129,11 +129,11 @@ function MyComponent({ actor }) {
 
 ### Hooks
 
-| Export                      | Description                                                                                                                                             |
-| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `useSignalEffect(callback)` | Subscribes to TC39 signal changes; re-runs the callback and forces a React re-render when any accessed signal changes. Cleanup is automatic on unmount. |
-| `useActor()`                | Returns the raw actor instance. Must be called inside an `ActorProvider`/`PlayUIProvider` tree.                                                         |
-| `usePlayView()`             | Returns `{ spec, handlers, registry, store }` for the current view. Must be called inside an `ActorProvider`/`PlayUIProvider` tree.                     |
+| Export                             | Description                                                                                                                                                                                                                          |
+| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `useSignalEffect(callback, deps?)` | Subscribes to TC39 signal changes; re-runs the callback when any accessed signal changes (re-render via the callback's own setState). Optional `deps` recreates the subscription, like `useEffect`. Cleanup is automatic on unmount. |
+| `useActor()`                       | Returns the raw actor instance. Must be called inside an `ActorProvider`/`PlayUIProvider` tree.                                                                                                                                      |
+| `usePlayView()`                    | Returns `{ spec, handlers, registry, store }` for the current view. Must be called inside an `ActorProvider`/`PlayUIProvider` tree.                                                                                                  |
 
 ### Types
 

package/api/@xmachines/play-react/classes/PlayErrorBoundary.md

@@ -2,7 +2,7 @@
 
 # Class: PlayErrorBoundary
 
-Defined in: [packages/play-react/src/PlayErrorBoundary.tsx:53](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.53/packages/play-react/src/PlayErrorBoundary.tsx#L53)
+Defined in: [packages/play-react/src/PlayErrorBoundary.tsx:53](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/packages/play-react/src/PlayErrorBoundary.tsx#L53)
 
 React class component error boundary for catching catalog component render errors.
 
@@ -36,7 +36,7 @@ Per CONS-14: Class component pattern works with all React versions (18 and 19).
 new PlayErrorBoundary(props): PlayErrorBoundary;
 ```
 
-Defined in: [packages/play-react/src/PlayErrorBoundary.tsx:57](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.53/packages/play-react/src/PlayErrorBoundary.tsx#L57)
+Defined in: [packages/play-react/src/PlayErrorBoundary.tsx:57](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/packages/play-react/src/PlayErrorBoundary.tsx#L57)
 
 #### Parameters
 
@@ -75,7 +75,7 @@ React.Component<
 componentDidCatch(error, info): void;
 ```
 
-Defined in: [packages/play-react/src/PlayErrorBoundary.tsx:66](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.53/packages/play-react/src/PlayErrorBoundary.tsx#L66)
+Defined in: [packages/play-react/src/PlayErrorBoundary.tsx:66](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/packages/play-react/src/PlayErrorBoundary.tsx#L66)
 
 Catches exceptions generated in descendant components. Unhandled exceptions will cause
 the entire component tree to unmount.
@@ -105,7 +105,7 @@ React.Component.componentDidCatch;
 optional componentDidMount(): void;
 ```
 
-Defined in: `@types/react`
+Defined in: `.pnpm`
 
 Called immediately after a component is mounted. Setting state here will trigger re-rendering.
 
@@ -130,7 +130,7 @@ optional componentDidUpdate(
    snapshot?): void;
 ```
 
-Defined in: `@types/react`
+Defined in: `.pnpm`
 
 Called immediately after updating occurs. Not called for the initial render.
 
@@ -162,7 +162,7 @@ React.Component.componentDidUpdate;
 optional componentWillMount(): void;
 ```
 
-Defined in: `@types/react`
+Defined in: `.pnpm`
 
 Called immediately before mounting occurs, and before [Component.render](https://www.jsdocs.io/package/@types/react#Component.render).
 Avoid introducing any side-effects or subscriptions in this method.
@@ -198,7 +198,7 @@ React.Component.componentWillMount;
 optional componentWillReceiveProps(nextProps, nextContext): void;
 ```
 
-Defined in: `@types/react`
+Defined in: `.pnpm`
 
 Called when the component may be receiving new props.
 React may call this even if props have not changed, so be sure to compare new and existing
@@ -244,7 +244,7 @@ React.Component.componentWillReceiveProps;
 optional componentWillUnmount(): void;
 ```
 
-Defined in: `@types/react`
+Defined in: `.pnpm`
 
 Called immediately before a component is destroyed. Perform any necessary cleanup in this method, such as
 cancelled network requests, or cleaning up any DOM elements created in `componentDidMount`.
@@ -270,7 +270,7 @@ optional componentWillUpdate(
    nextContext): void;
 ```
 
-Defined in: `@types/react`
+Defined in: `.pnpm`
 
 Called immediately before rendering when new props or state is received. Not called for the initial render.
 
@@ -315,7 +315,7 @@ React.Component.componentWillUpdate;
 forceUpdate(callback?): void;
 ```
 
-Defined in: `@types/react`
+Defined in: `.pnpm`
 
 #### Parameters
 
@@ -341,7 +341,7 @@ React.Component.forceUpdate;
 optional getSnapshotBeforeUpdate(prevProps, prevState): any;
 ```
 
-Defined in: `@types/react`
+Defined in: `.pnpm`
 
 Runs before React applies the result of [render](https://www.jsdocs.io/package/@types/react#Component.render) to the document, and
 returns an object to be given to [componentDidUpdate](#componentdidupdate). Useful for saving
@@ -375,7 +375,7 @@ React.Component.getSnapshotBeforeUpdate;
 render(): ReactNode;
 ```
 
-Defined in: [packages/play-react/src/PlayErrorBoundary.tsx:70](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.53/packages/play-react/src/PlayErrorBoundary.tsx#L70)
+Defined in: [packages/play-react/src/PlayErrorBoundary.tsx:70](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/packages/play-react/src/PlayErrorBoundary.tsx#L70)
 
 #### Returns
 
@@ -395,7 +395,7 @@ React.Component.render;
 setState<K>(state, callback?): void;
 ```
 
-Defined in: `@types/react`
+Defined in: `.pnpm`
 
 #### Type Parameters
 
@@ -431,7 +431,7 @@ optional shouldComponentUpdate(
    nextContext): boolean;
 ```
 
-Defined in: `@types/react`
+Defined in: `.pnpm`
 
 Called to determine whether the change in props and state should trigger a re-render.
 
@@ -468,7 +468,7 @@ React.Component.shouldComponentUpdate;
 optional UNSAFE_componentWillMount(): void;
 ```
 
-Defined in: `@types/react`
+Defined in: `.pnpm`
 
 Called immediately before mounting occurs, and before [Component.render](https://www.jsdocs.io/package/@types/react#Component.render).
 Avoid introducing any side-effects or subscriptions in this method.
@@ -506,7 +506,7 @@ React.Component.UNSAFE_componentWillMount;
 optional UNSAFE_componentWillReceiveProps(nextProps, nextContext): void;
 ```
 
-Defined in: `@types/react`
+Defined in: `.pnpm`
 
 Called when the component may be receiving new props.
 React may call this even if props have not changed, so be sure to compare new and existing
@@ -557,7 +557,7 @@ optional UNSAFE_componentWillUpdate(
    nextContext): void;
 ```
 
-Defined in: `@types/react`
+Defined in: `.pnpm`
 
 Called immediately before rendering when new props or state is received. Not called for the initial render.
 
@@ -604,7 +604,7 @@ React.Component.UNSAFE_componentWillUpdate;
 static getDerivedStateFromError(error): PlayErrorBoundaryState;
 ```
 
-Defined in: [packages/play-react/src/PlayErrorBoundary.tsx:62](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.53/packages/play-react/src/PlayErrorBoundary.tsx#L62)
+Defined in: [packages/play-react/src/PlayErrorBoundary.tsx:62](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/packages/play-react/src/PlayErrorBoundary.tsx#L62)
 
 #### Parameters
 

package/api/@xmachines/play-react/functions/ActionProvider.md

@@ -6,7 +6,7 @@
 function ActionProvider(__namedParameters): Element;
 ```
 
-Defined in: `@json-render/react`
+Defined in: `.pnpm`
 
 Provider for action execution
 

package/api/@xmachines/play-react/functions/JSONUIProvider.md

@@ -6,7 +6,7 @@
 function JSONUIProvider(__namedParameters): Element;
 ```
 
-Defined in: `@json-render/react`
+Defined in: `.pnpm`
 
 Combined provider for all JSONUI contexts
 

package/api/@xmachines/play-react/functions/Renderer.md

@@ -6,7 +6,7 @@
 function Renderer(__namedParameters): Element | null;
 ```
 
-Defined in: `@json-render/react`
+Defined in: `.pnpm`
 
 Main renderer component
 

package/api/@xmachines/play-react/functions/StateProvider.md

@@ -6,7 +6,7 @@
 function StateProvider(__namedParameters): Element;
 ```
 
-Defined in: `@json-render/react`
+Defined in: `.pnpm`
 
 Provider for state model context.
 

package/api/@xmachines/play-react/functions/ValidationProvider.md

@@ -6,7 +6,7 @@
 function ValidationProvider(__namedParameters): Element;
 ```
 
-Defined in: `@json-render/react`
+Defined in: `.pnpm`
 
 Provider for validation
 

package/api/@xmachines/play-react/functions/VisibilityProvider.md

@@ -6,7 +6,7 @@
 function VisibilityProvider(__namedParameters): Element;
 ```
 
-Defined in: `@json-render/react`
+Defined in: `.pnpm`
 
 Provider for visibility evaluation
 

package/api/@xmachines/play-react/functions/defineRegistry.md

@@ -6,7 +6,7 @@
 function defineRegistry<C>(_catalog, options): DefineRegistryResult;
 ```
 
-Defined in: `@json-render/react`
+Defined in: `.pnpm`
 
 Create a registry from a catalog with components and/or actions.
 

package/api/@xmachines/play-react/functions/useActor.md

@@ -6,7 +6,7 @@
 function useActor(): AnyPlayActor;
 ```
 
-Defined in: [packages/play-react/src/useActor.ts:32](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.53/packages/play-react/src/useActor.ts#L32)
+Defined in: [packages/play-react/src/useActor.ts:32](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/packages/play-react/src/useActor.ts#L32)
 
 ## Returns
 

package/api/@xmachines/play-react/functions/useBoundProp.md

@@ -6,7 +6,7 @@
 function useBoundProp<T>(propValue, bindingPath): [T | undefined, (value) => void];
 ```
 
-Defined in: `@json-render/react`
+Defined in: `.pnpm`
 
 Hook for two-way bound props. Returns `[value, setValue]` where:
 

package/api/@xmachines/play-react/functions/usePlayView.md

@@ -6,7 +6,7 @@
 function usePlayView(): ViewContextValue;
 ```
 
-Defined in: [packages/play-react/src/ActorProvider.tsx:72](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.53/packages/play-react/src/ActorProvider.tsx#L72)
+Defined in: [packages/play-react/src/ActorProvider.tsx:78](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/packages/play-react/src/ActorProvider.tsx#L78)
 
 Hook to access the current view spec, handlers, and registry.
 

package/api/@xmachines/play-react/functions/useSignalEffect.md

@@ -3,23 +3,25 @@
 # Function: useSignalEffect()
 
 ```ts
-function useSignalEffect(callback): void;
+function useSignalEffect(callback, deps?): void;
 ```
 
-Defined in: [packages/play-react/src/useSignalEffect.ts:71](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.53/packages/play-react/src/useSignalEffect.ts#L71)
+Defined in: [packages/play-react/src/useSignalEffect.ts:80](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/packages/play-react/src/useSignalEffect.ts#L80)
 
 React hook that subscribes to signal changes and runs effect callback
 
-Wraps Signal.subtle.Watcher to automatically track signal dependencies
-accessed in the callback. When any tracked signal changes, the callback
-re-runs and React component re-renders.
+Wraps the callback in a Signal.Computed to automatically track signal
+dependencies accessed inside it, then delegates the watcher lifecycle
+(microtask batching, re-arming, disposal) to `watchSignal` from
+`@xmachines/play-signals` — the single canonical implementation shared
+across framework renderers.
 
-Architecture (per RESEARCH.md Pattern 3):
+Architecture:
 
 - Uses Signal.Computed to wrap callback for automatic dependency tracking
-- Signal.subtle.Watcher monitors the Computed for changes
+- watchSignal owns the Signal.subtle.Watcher lifecycle (Phase 29 memory safety)
 - Microtask batching coalesces rapid signal updates
-- Forces React re-render via useReducer when signals change
+- Re-rendering is driven by the callback's own setState (see remarks)
 - Handles cleanup on unmount to prevent memory leaks
 
 Invariant: Signal-Only Reactivity - Signals accessed in callback are watched.
@@ -27,9 +29,10 @@ Invariant: Passive Infrastructure - React observes signals and does not control
 
 ## Parameters
 
-| Parameter  | Type                           | Description                                                         |
-| ---------- | ------------------------------ | ------------------------------------------------------------------- |
-| `callback` | () => `void` \| (() => `void`) | Effect function that accesses signals. Can return cleanup function. |
+| Parameter  | Type                           | Default value | Description                                                                                                                                                                                                                                                                                                                                                                                                            |
+| ---------- | ------------------------------ | ------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `callback` | () => `void` \| (() => `void`) | `undefined`   | Effect function that accesses signals. Can return cleanup function.                                                                                                                                                                                                                                                                                                                                                    |
+| `deps`     | `DependencyList`               | `[]`          | Optional dependency list (like useEffect). When any dependency changes, the watcher and Computed are torn down and recreated, re-tracking signals from scratch. Defaults to `[]` (subscribe once per mount). Pass this when the identity of the object whose signals you read can change over the component's lifetime (e.g. an `actor` prop) — otherwise the watcher keeps tracking the OLD object's signals forever. |
 
 ## Returns
 
@@ -41,11 +44,11 @@ Invariant: Passive Infrastructure - React observes signals and does not control
 const MyComponent = ({ actor }) => {
   const [view, setView] = useState(null);
 
-  // Subscribe to actor.currentView signal
+  // Subscribe to actor.currentView signal; re-subscribe if the actor swaps
   useSignalEffect(() => {
     const currentView = actor.currentView.get();
     setView(currentView);
-  });
+  }, [actor]);
 
   return <div>{view?.component}</div>;
 };
@@ -56,20 +59,19 @@ const MyComponent = ({ actor }) => {
 **CRITICAL:** Signals must be accessed unconditionally (no if statements).
 Conditional signal access breaks automatic dependency tracking.
 
-**Performance:** Microtask batching (queueMicrotask) prevents React thrashing
-when multiple signals update rapidly. Per signal-polyfill README pattern.
+**Performance:** Microtask batching (queueMicrotask, inside watchSignal)
+prevents React thrashing when multiple signals update rapidly.
 
-**Why forceUpdate:** React needs useState/useReducer to trigger re-render cycle.
-Signal changes won't automatically re-render React components without forcing
-update via state change.
+**Re-rendering:** the hook itself does NOT force a React render on signal
+change — the callback drives re-rendering by calling setState with the new
+signal value (as in the example above). This lets React's setState bailout
+skip renders when the derived value is unchanged; an unconditional
+force-update here previously caused a wasted render per notification even
+when the callback's setState bailed. If you need to re-render on every
+notification while reading signals during render, mirror the signal value
+into React state inside the callback.
 
 **Implementation note:** We wrap the callback in Signal.Computed because
 Signal.subtle.Watcher cannot automatically track arbitrary function calls.
-The Computed handles dependency tracking, and the Watcher monitors it.
-
-**Memory safety (Phase 29):**
-
-- `disposed` flag prevents post-cleanup callback execution: if cleanup is
-  called before a pending microtask fires, the microtask returns early.
-- `needsEnqueue` guard dedups rapid synchronous signal changes: only one
-  microtask is ever queued per batch of synchronous mutations.
+The Computed handles dependency tracking; watchSignal evaluates it (which
+runs the callback) whenever any tracked signal changes.