@xmachines/docs 1.0.0-beta.10

package/api/@xmachines/play-react/interfaces/PlayErrorBoundaryState.md

@@ -0,0 +1,14 @@
+[Documentation](../../../README.md) / [@xmachines/play-react](../README.md) / PlayErrorBoundaryState
+
+# Interface: PlayErrorBoundaryState
+
+Defined in: [packages/play-react/src/PlayErrorBoundary.tsx:28](https://gitlab.com/xmachin-es/xmachines-js/-/blob/00a28432ed57807112288436d1ae4387d9f06919/packages/play-react/src/PlayErrorBoundary.tsx#L28)
+
+Internal state shape for PlayErrorBoundary
+
+## Properties
+
+| Property                                  | Type              | Defined in                                                                                                                                                                                       |
+| ----------------------------------------- | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| <a id="property-error"></a> `error`       | `Error` \| `null` | [packages/play-react/src/PlayErrorBoundary.tsx:30](https://gitlab.com/xmachin-es/xmachines-js/-/blob/00a28432ed57807112288436d1ae4387d9f06919/packages/play-react/src/PlayErrorBoundary.tsx#L30) |
+| <a id="property-haserror"></a> `hasError` | `boolean`         | [packages/play-react/src/PlayErrorBoundary.tsx:29](https://gitlab.com/xmachin-es/xmachines-js/-/blob/00a28432ed57807112288436d1ae4387d9f06919/packages/play-react/src/PlayErrorBoundary.tsx#L29) |

package/api/@xmachines/play-react/interfaces/PlayRendererProps.md

@@ -0,0 +1,15 @@
+[Documentation](../../../README.md) / [@xmachines/play-react](../README.md) / PlayRendererProps
+
+# Interface: PlayRendererProps
+
+Defined in: [packages/play-react/src/types.ts:18](https://gitlab.com/xmachin-es/xmachines-js/-/blob/00a28432ed57807112288436d1ae4387d9f06919/packages/play-react/src/types.ts#L18)
+
+Props for PlayRenderer component
+
+## Properties
+
+| Property                                      | Type                                                                                                                                    | Description                                                           | Defined in                                                                                                                                                             |
+| --------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| <a id="property-actor"></a> `actor`           | [`AbstractActor`](../../play-actor/classes/AbstractActor.md)\<`AnyActorLogic`\> & [`Viewable`](../../play-actor/interfaces/Viewable.md) | Actor instance with currentView signal (requires Viewable capability) | [packages/play-react/src/types.ts:20](https://gitlab.com/xmachin-es/xmachines-js/-/blob/00a28432ed57807112288436d1ae4387d9f06919/packages/play-react/src/types.ts#L20) |
+| <a id="property-components"></a> `components` | `Record`\<`string`, `React.ElementType`\>                                                                                               | Map of component names to React components                            | [packages/play-react/src/types.ts:23](https://gitlab.com/xmachin-es/xmachines-js/-/blob/00a28432ed57807112288436d1ae4387d9f06919/packages/play-react/src/types.ts#L23) |
+| <a id="property-fallback"></a> `fallback?`    | `ReactNode`                                                                                                                             | Optional component shown when currentView is null                     | [packages/play-react/src/types.ts:26](https://gitlab.com/xmachin-es/xmachines-js/-/blob/00a28432ed57807112288436d1ae4387d9f06919/packages/play-react/src/types.ts#L26) |

package/api/@xmachines/play-react/variables/PlayRenderer.md

@@ -0,0 +1,64 @@
+[Documentation](../../../README.md) / [@xmachines/play-react](../README.md) / PlayRenderer
+
+# Variable: PlayRenderer
+
+```ts
+const PlayRenderer: React.FC<PlayRendererProps>;
+```
+
+Defined in: [packages/play-react/src/PlayRenderer.tsx:61](https://gitlab.com/xmachin-es/xmachines-js/-/blob/00a28432ed57807112288436d1ae4387d9f06919/packages/play-react/src/PlayRenderer.tsx#L61)
+
+Main renderer component that subscribes to actor signals and renders UI
+
+Architecture (per RESEARCH.md Pattern 1):
+
+- Subscribes to actor.currentView signal via useSignalEffect
+- Dynamically renders catalog components based on view.component string
+- Forwards user events to actor via actor.send()
+- React state only for triggering renders, NOT business logic
+
+Invariant: Actor Authority - Actor decides all state transitions via guards.
+Invariant: Passive Infrastructure - Component observes signals and sends events.
+Invariant: Signal-Only Reactivity - Business logic state lives in actor signals.
+
+## Example
+
+```typescript
+import { PlayRenderer } from "@xmachines/play-react";
+import { definePlayer } from "@xmachines/play-xstate";
+
+const actor = definePlayer({ machine, catalog })();
+actor.start();
+
+const components = {
+  Dashboard: ({ userId, send }) => <div>User: {userId}</div>,
+  LoginForm: ({ error, send }) => <form onSubmit={(e) => {
+    e.preventDefault();
+    send({ type: "intent", name: "login.submit", payload: {...} });
+  }}>...</form>
+};
+
+<PlayRenderer actor={actor} components={components} />
+```
+
+## Param
+
+Component props
+
+## Returns
+
+React element rendering current view from actor
+
+## Remarks
+
+**Component lookup:** Dynamically looks up component from `components` map
+using `view.component` string from actor.currentView signal.
+
+**Event forwarding:** Injects `send` function as prop to components. Components
+call `send(event)` to forward intents to actor. Actor guards decide validity.
+
+**Error handling:** If component not found in catalog, logs error and shows
+fallback. This indicates missing component registration, not runtime error.
+
+**CRITICAL:** Never call actor.send() during render - only in event handlers.
+Calling send during render causes infinite render loops.

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

@@ -0,0 +1,198 @@
+[Documentation](../../README.md) / @xmachines/play-react-router
+
+# @xmachines/play-react-router
+
+**React Router v7 adapter for XMachines Play using RouterBridgeBase.**
+
+## Overview
+
+`@xmachines/play-react-router` connects `react-router` v7 data routers to Play actors.
+
+The package provides:
+
+- `ReactRouterBridge` for direct adapter control
+- `PlayRouterProvider` for React lifecycle wiring
+- `RouteMap` utilities for state ID <-> URL path resolution
+
+Internally, `ReactRouterBridge` extends `RouterBridgeBase` from `@xmachines/play-router`, so behavior matches other bridge adapters in the monorepo.
+
+## Installation
+
+```bash
+npm install react react-router
+npm install @xmachines/play-react-router @xmachines/play-router @xmachines/play-react
+```
+
+## Current Exports
+
+- `ReactRouterBridge`
+- `PlayRouterProvider` + `PlayRouterProviderProps`
+- `RouteMap`
+- `createRouteMapFromTree`
+- type re-exports: `RouterBridge`, `PlayRouteEvent`
+
+Peer dependencies:
+
+- `react` `^18 || ^19`
+- `react-router` `^7.0.0`
+
+Use `@xmachines/play-react` for framework-native rendering (`PlayRenderer`).
+
+## Quick Start
+
+```tsx
+import { createBrowserRouter } from "react-router";
+import { definePlayer } from "@xmachines/play-xstate";
+import { extractMachineRoutes } from "@xmachines/play-router";
+import { ReactRouterBridge, createRouteMapFromTree } from "@xmachines/play-react-router";
+
+const router = createBrowserRouter(routes);
+const actor = definePlayer({ machine, catalog })();
+actor.start();
+
+const routeTree = extractMachineRoutes(machine);
+const routeMap = createRouteMapFromTree(routeTree);
+
+const bridge = new ReactRouterBridge(router, actor, routeMap);
+bridge.connect();
+
+// later
+bridge.disconnect();
+```
+
+`ReactRouterBridge` requires the data-router API (`createBrowserRouter`).
+`BrowserRouter` is not supported because it does not expose subscribe/navigate APIs needed by the bridge.
+
+## API
+
+### `ReactRouterBridge`
+
+```ts
+class ReactRouterBridge extends RouterBridgeBase {
+	constructor(
+		router: ReturnType<typeof createBrowserRouter>,
+		actor: AbstractActor<AnyActorLogic> & Routable,
+		routeMap: RouteMap,
+	);
+	connect(): void;
+	disconnect(): void;
+}
+```
+
+Responsibilities:
+
+- Watch React Router location updates and sync actor via `play.route`
+- Observe actor route changes and navigate router when state changes
+- Handle initial URL sync on cold load/deep links
+
+### `PlayRouterProvider`
+
+React wrapper that creates/connects/disconnects `ReactRouterBridge` in `useEffect`:
+
+```ts
+interface PlayRouterProviderProps {
+	actor: AbstractActor<AnyActorLogic> & Routable & Viewable;
+	router: ReturnType<typeof createBrowserRouter>;
+	routeMap: RouteMap;
+	renderer: (
+		actor: AbstractActor<AnyActorLogic> & Routable & Viewable,
+		router: ReturnType<typeof createBrowserRouter>,
+	) => ReactNode;
+}
+```
+
+### `RouteMap` and `createRouteMapFromTree`
+
+`RouteMap` extends `BaseRouteMap` from `@xmachines/play-router`, inheriting bucket-indexed
+bidirectional route matching. No routing logic lives in the adapter itself.
+
+```ts
+// RouteMap is a thin subclass of BaseRouteMap — no extra methods
+class RouteMap extends BaseRouteMap {}
+
+// Inherited API:
+routeMap.getStateIdByPath(path: string): string | null
+routeMap.getPathByStateId(stateId: string): string | null
+
+// Factory from a machine route tree:
+function createRouteMapFromTree(routeTree: RouteTree): RouteMap
+```
+
+`getStateIdByPath` returns `null` (not `undefined`) for unmatched paths.
+
+Construct directly when you have static mappings:
+
+```ts
+import { RouteMap } from "@xmachines/play-react-router";
+
+const routeMap = new RouteMap([
+	{ stateId: "home", path: "/" },
+	{ stateId: "profile", path: "/profile/:userId" },
+	{ stateId: "settings", path: "/settings/:section?" },
+]);
+
+routeMap.getStateIdByPath("/profile/123"); // "profile"
+routeMap.getPathByStateId("home"); // "/"
+routeMap.getStateIdByPath("/unknown"); // null
+```
+
+Or build from a machine's route tree:
+
+```ts
+import { extractMachineRoutes } from "@xmachines/play-router";
+import { createRouteMapFromTree } from "@xmachines/play-react-router";
+
+const routeMap = createRouteMapFromTree(extractMachineRoutes(machine));
+```
+
+## Examples
+
+- Routing patterns guide: `docs/examples/routing-patterns.md`
+- Multi-router integration guide: `docs/examples/multi-router-integration.md`
+
+## Architecture
+
+Bridge-first adapter flow:
+
+1. Build route map from `extractMachineRoutes(machine)`.
+2. Connect `ReactRouterBridge` (or `PlayRouterProvider`).
+3. Router navigation emits path updates to actor via `play.route` events.
+4. Actor transitions (and guards) determine valid state.
+5. Actor route signal updates router URL when accepted.
+
+This keeps infrastructure passive and preserves Actor Authority.
+
+## Related Packages
+
+- [@xmachines/play-router](../play-router/README.md)
+- [@xmachines/play-xstate](../play-xstate/README.md)
+- [@xmachines/play-react](../play-react/README.md)
+
+## License
+
+Copyright (c) 2016 [Mikael Karon](mailto:mikael@karon.se). All rights reserved.
+
+This work is licensed under the terms of the MIT license.  
+For a copy, see <https://opensource.org/licenses/MIT>.
+
+@xmachines/play-react-router
+
+React Router v7 adapter for XMachines Play architecture.
+Synchronizes browser URL with actor state using createBrowserRouter data API.
+
+## Classes
+
+- [ReactRouterBridge](classes/ReactRouterBridge.md)
+- [RouteMap](classes/RouteMap.md)
+
+## Interfaces
+
+- [PlayRouteEvent](interfaces/PlayRouteEvent.md)
+- [PlayRouterProviderProps](interfaces/PlayRouterProviderProps.md)
+- [RouteMapping](interfaces/RouteMapping.md)
+- [RouterBridge](interfaces/RouterBridge.md)
+
+## Functions
+
+- [createRouteMapFromTree](functions/createRouteMapFromTree.md)
+- [PlayRouterProvider](functions/PlayRouterProvider.md)

package/api/@xmachines/play-react-router/classes/ReactRouterBridge.md

@@ -0,0 +1,321 @@
+[Documentation](../../../README.md) / [@xmachines/play-react-router](../README.md) / ReactRouterBridge
+
+# Class: ReactRouterBridge
+
+Defined in: [play-react-router/src/react-router-bridge.ts:28](https://gitlab.com/xmachin-es/xmachines-js/-/blob/00a28432ed57807112288436d1ae4387d9f06919/packages/play-react-router/src/react-router-bridge.ts#L28)
+
+Abstract base class for all `@xmachines` router adapter bridges.
+
+Implements RouterBridge protocol and contains all common bridge logic.
+Subclasses only need to implement the 3 abstract methods that differ
+between frameworks.
+
+## Extends
+
+- [`RouterBridgeBase`](../../play-router/classes/RouterBridgeBase.md)
+
+## Constructors
+
+### Constructor
+
+```ts
+new ReactRouterBridge(
+   router,
+   actor,
+   routeMap): ReactRouterBridge;
+```
+
+Defined in: [play-react-router/src/react-router-bridge.ts:31](https://gitlab.com/xmachin-es/xmachines-js/-/blob/00a28432ed57807112288436d1ae4387d9f06919/packages/play-react-router/src/react-router-bridge.ts#L31)
+
+#### Parameters
+
+| Parameter  | Type                                                                                                                                    |
+| ---------- | --------------------------------------------------------------------------------------------------------------------------------------- |
+| `router`   | `Router$1`                                                                                                                              |
+| `actor`    | [`AbstractActor`](../../play-actor/classes/AbstractActor.md)\<`AnyActorLogic`\> & [`Routable`](../../play-actor/interfaces/Routable.md) |
+| `routeMap` | [`RouteMap`](RouteMap.md)                                                                                                               |
+
+#### Returns
+
+`ReactRouterBridge`
+
+#### Overrides
+
+[`RouterBridgeBase`](../../play-router/classes/RouterBridgeBase.md).[`constructor`](../../play-router/classes/RouterBridgeBase.md#constructor)
+
+## Properties
+
+| Property                                                              | Modifier    | Type                                                                                                                                    | Description                                           | Inherited from                                                                                                                                                                | Defined in                                  |
+| --------------------------------------------------------------------- | ----------- | --------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------- |
+| <a id="property-actor"></a> `actor`                                   | `readonly`  | [`AbstractActor`](../../play-actor/classes/AbstractActor.md)\<`AnyActorLogic`\> & [`Routable`](../../play-actor/interfaces/Routable.md) | Actor with currentRoute signal and send method        | [`RouterBridgeBase`](../../play-router/classes/RouterBridgeBase.md).[`actor`](../../play-router/classes/RouterBridgeBase.md#property-actor)                                   | play-router/dist/router-bridge-base.d.ts:55 |
+| <a id="property-hasconnectedonce"></a> `hasConnectedOnce`             | `protected` | `boolean`                                                                                                                               | -                                                     | [`RouterBridgeBase`](../../play-router/classes/RouterBridgeBase.md).[`hasConnectedOnce`](../../play-router/classes/RouterBridgeBase.md#property-hasconnectedonce)             | play-router/dist/router-bridge-base.d.ts:61 |
+| <a id="property-isconnected"></a> `isConnected`                       | `protected` | `boolean`                                                                                                                               | -                                                     | [`RouterBridgeBase`](../../play-router/classes/RouterBridgeBase.md).[`isConnected`](../../play-router/classes/RouterBridgeBase.md#property-isconnected)                       | play-router/dist/router-bridge-base.d.ts:60 |
+| <a id="property-isprocessingnavigation"></a> `isProcessingNavigation` | `protected` | `boolean`                                                                                                                               | -                                                     | [`RouterBridgeBase`](../../play-router/classes/RouterBridgeBase.md).[`isProcessingNavigation`](../../play-router/classes/RouterBridgeBase.md#property-isprocessingnavigation) | play-router/dist/router-bridge-base.d.ts:63 |
+| <a id="property-lastsyncedpath"></a> `lastSyncedPath`                 | `protected` | `string`                                                                                                                                | -                                                     | [`RouterBridgeBase`](../../play-router/classes/RouterBridgeBase.md).[`lastSyncedPath`](../../play-router/classes/RouterBridgeBase.md#property-lastsyncedpath)                 | play-router/dist/router-bridge-base.d.ts:62 |
+| <a id="property-routemap"></a> `routeMap`                             | `readonly`  | `object`                                                                                                                                | Bidirectional route map for stateId ↔ path resolution | [`RouterBridgeBase`](../../play-router/classes/RouterBridgeBase.md).[`routeMap`](../../play-router/classes/RouterBridgeBase.md#property-routemap)                             | play-router/dist/router-bridge-base.d.ts:56 |
+| `routeMap.getPathByStateId`                                           | `public`    | `string` \| `null` \| `undefined`                                                                                                       | -                                                     | -                                                                                                                                                                             | play-router/dist/router-bridge-base.d.ts:58 |
+| `routeMap.getStateIdByPath`                                           | `public`    | `string` \| `null` \| `undefined`                                                                                                       | -                                                     | -                                                                                                                                                                             | play-router/dist/router-bridge-base.d.ts:57 |
+| <a id="property-routewatcher"></a> `routeWatcher`                     | `protected` | \| [`Watcher`](../../play-signals/namespaces/Signal/namespaces/subtle/classes/Watcher.md) \| `null`                                     | -                                                     | [`RouterBridgeBase`](../../play-router/classes/RouterBridgeBase.md).[`routeWatcher`](../../play-router/classes/RouterBridgeBase.md#property-routewatcher)                     | play-router/dist/router-bridge-base.d.ts:64 |
+
+## Methods
+
+### connect()
+
+```ts
+connect(): void;
+```
+
+Defined in: play-router/dist/router-bridge-base.d.ts:81
+
+Connect the router bridge to the Actor.
+
+Sets up the TC39 Signal watcher for actor → router direction and
+starts watching router changes (framework-specific).
+
+#### Returns
+
+`void`
+
+#### Inherited from
+
+[`RouterBridgeBase`](../../play-router/classes/RouterBridgeBase.md).[`connect`](../../play-router/classes/RouterBridgeBase.md#connect)
+
+---
+
+### disconnect()
+
+```ts
+disconnect(): void;
+```
+
+Defined in: play-router/dist/router-bridge-base.d.ts:87
+
+Disconnect the router bridge from the Actor.
+
+Stops signal watching and unregisters framework-specific router listener.
+
+#### Returns
+
+`void`
+
+#### Inherited from
+
+[`RouterBridgeBase`](../../play-router/classes/RouterBridgeBase.md).[`disconnect`](../../play-router/classes/RouterBridgeBase.md#disconnect)
+
+---
+
+### extractParams()
+
+```ts
+protected extractParams(pathname, stateId): Record<string, string>;
+```
+
+Defined in: play-router/dist/router-bridge-base.d.ts:134
+
+Extract path parameters from URL using the URLPattern API.
+
+Accesses `globalThis.URLPattern` at runtime — no polyfill is imported by this
+library. If `URLPattern` is unavailable (Node.js < 24, older browsers without a
+polyfill), this method returns `{}` silently (graceful degradation — routing still
+works, params will be empty).
+
+#### Parameters
+
+| Parameter  | Type     | Description                                       |
+| ---------- | -------- | ------------------------------------------------- |
+| `pathname` | `string` | The actual URL path (e.g., '/profile/john')       |
+| `stateId`  | `string` | The matched state ID for looking up route pattern |
+
+#### Returns
+
+`Record`\<`string`, `string`\>
+
+Extracted path parameters, or empty object if URLPattern is unavailable or no match
+
+#### Inherited from
+
+[`RouterBridgeBase`](../../play-router/classes/RouterBridgeBase.md).[`extractParams`](../../play-router/classes/RouterBridgeBase.md#extractparams)
+
+---
+
+### extractQuery()
+
+```ts
+protected extractQuery(search): Record<string, string>;
+```
+
+Defined in: play-router/dist/router-bridge-base.d.ts:141
+
+Extract query parameters from URL search string.
+
+#### Parameters
+
+| Parameter | Type     | Description                                      |
+| --------- | -------- | ------------------------------------------------ |
+| `search`  | `string` | URL search string (e.g., '?tab=security&page=1') |
+
+#### Returns
+
+`Record`\<`string`, `string`\>
+
+Extracted query parameters or empty object
+
+#### Inherited from
+
+[`RouterBridgeBase`](../../play-router/classes/RouterBridgeBase.md).[`extractQuery`](../../play-router/classes/RouterBridgeBase.md#extractquery)
+
+---
+
+### getInitialRouterPath()
+
+```ts
+protected getInitialRouterPath(): string | null;
+```
+
+Defined in: [play-react-router/src/react-router-bridge.ts:49](https://gitlab.com/xmachin-es/xmachines-js/-/blob/00a28432ed57807112288436d1ae4387d9f06919/packages/play-react-router/src/react-router-bridge.ts#L49)
+
+Return the router's current pathname so connect() can sync the actor to
+the URL on initial load. router.subscribe() only fires on future navigations
+— it does not replay the already-loaded location — so without this, loading
+the page on /about would leave the actor in its default "home" state.
+
+#### Returns
+
+`string` \| `null`
+
+#### Overrides
+
+[`RouterBridgeBase`](../../play-router/classes/RouterBridgeBase.md).[`getInitialRouterPath`](../../play-router/classes/RouterBridgeBase.md#getinitialrouterpath)
+
+---
+
+### navigateRouter()
+
+```ts
+protected navigateRouter(path): void;
+```
+
+Defined in: [play-react-router/src/react-router-bridge.ts:39](https://gitlab.com/xmachin-es/xmachines-js/-/blob/00a28432ed57807112288436d1ae4387d9f06919/packages/play-react-router/src/react-router-bridge.ts#L39)
+
+Navigate the framework router to the given path.
+
+Called when actor's currentRoute signal changes to a new path.
+Must trigger the framework router's navigation (e.g., router.navigate(path)).
+
+#### Parameters
+
+| Parameter | Type     |
+| --------- | -------- |
+| `path`    | `string` |
+
+#### Returns
+
+`void`
+
+#### Overrides
+
+[`RouterBridgeBase`](../../play-router/classes/RouterBridgeBase.md).[`navigateRouter`](../../play-router/classes/RouterBridgeBase.md#navigaterouter)
+
+---
+
+### syncActorFromRouter()
+
+```ts
+protected syncActorFromRouter(pathname, search?): void;
+```
+
+Defined in: play-router/dist/router-bridge-base.d.ts:101
+
+Sync actor state when router location changes.
+
+Sends play.route event to actor with resolved stateId, params, and query.
+Prevents circular updates via isProcessingNavigation flag.
+
+#### Parameters
+
+| Parameter  | Type     |
+| ---------- | -------- |
+| `pathname` | `string` |
+| `search?`  | `string` |
+
+#### Returns
+
+`void`
+
+#### Inherited from
+
+[`RouterBridgeBase`](../../play-router/classes/RouterBridgeBase.md).[`syncActorFromRouter`](../../play-router/classes/RouterBridgeBase.md#syncactorfromrouter)
+
+---
+
+### syncRouterFromActor()
+
+```ts
+protected syncRouterFromActor(route): void;
+```
+
+Defined in: play-router/dist/router-bridge-base.d.ts:94
+
+Sync router location when actor route signal changes.
+
+Calls navigateRouter() for framework-specific navigation.
+Prevents circular updates via isProcessingNavigation flag.
+
+#### Parameters
+
+| Parameter | Type      |
+| --------- | --------- |
+| `route`   | `unknown` |
+
+#### Returns
+
+`void`
+
+#### Inherited from
+
+[`RouterBridgeBase`](../../play-router/classes/RouterBridgeBase.md).[`syncRouterFromActor`](../../play-router/classes/RouterBridgeBase.md#syncrouterfromactor)
+
+---
+
+### unwatchRouterChanges()
+
+```ts
+protected unwatchRouterChanges(): void;
+```
+
+Defined in: [play-react-router/src/react-router-bridge.ts:59](https://gitlab.com/xmachin-es/xmachines-js/-/blob/00a28432ed57807112288436d1ae4387d9f06919/packages/play-react-router/src/react-router-bridge.ts#L59)
+
+Stop watching for router location changes.
+
+Called by disconnect(). Should clean up the framework-specific subscription.
+
+#### Returns
+
+`void`
+
+#### Overrides
+
+[`RouterBridgeBase`](../../play-router/classes/RouterBridgeBase.md).[`unwatchRouterChanges`](../../play-router/classes/RouterBridgeBase.md#unwatchrouterchanges)
+
+---
+
+### watchRouterChanges()
+
+```ts
+protected watchRouterChanges(): void;
+```
+
+Defined in: [play-react-router/src/react-router-bridge.ts:53](https://gitlab.com/xmachin-es/xmachines-js/-/blob/00a28432ed57807112288436d1ae4387d9f06919/packages/play-react-router/src/react-router-bridge.ts#L53)
+
+Start watching for router location changes.
+
+Called by connect(). Should set up the framework-specific subscription
+for location changes and call syncActorFromRouter() on each change.
+
+#### Returns
+
+`void`
+
+#### Overrides
+
+[`RouterBridgeBase`](../../play-router/classes/RouterBridgeBase.md).[`watchRouterChanges`](../../play-router/classes/RouterBridgeBase.md#watchrouterchanges)