@xmachines/docs 1.0.0-beta.43 → 1.0.0-beta.45

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

@@ -1,4 +1,4 @@
-[Documentation](../../README.md) / @xmachines/play-vue
+[API](../../README.md) / @xmachines/play-vue
 
 # @xmachines/play-vue
 
@@ -15,7 +15,7 @@ Bridges TC39 Signal-driven actors to Vue's reactivity. Business logic stays in t
 - Routes action names from spec elements to `actor.send()` via the `actions` prop
 - Manages per-view UI state in an `@xstate/store` atom (automatic or caller-supplied)
 
-Per [Play RFC](../docs/rfc/play.md):
+Per [Play RFC](../../../rfc/play.md):
 
 - **Actor Authority (INV-01):** Guards in the machine decide all state transitions
 - **Passive Infrastructure (INV-04):** Vue observes signals and dispatches events — never decides
@@ -214,7 +214,7 @@ Batteries-included composite provider. Wraps `ActorProvider` + `JSONUIProvider`.
 
 **`actor`** — A `PlayerActor` (or any `AbstractActor & Viewable`). Provides the `currentView` signal.
 
-**`registryResult`** — The full `DefineRegistryResult` returned by `defineRegistry(catalog, { components, actions })` from `@xmachines/play-vue`. Pass `.vue` SFCs directly — they are auto-wrapped via `h(SFC, ctx)` so `useBoundProp` and other composables work inside `<script setup>`.
+**`registryResult`** — The full `DefineRegistryResult` returned by `defineRegistry(catalog, { components, actions })` from.
 
 **`store`** (optional) — Controls per-view UI state (`$state` bindings, form values):
 
@@ -308,7 +308,7 @@ const registryResult = defineRegistry(catalog, {
 });
 ```
 
-`onRenderError` is typed as `RenderErrorHandler` and exported from `@xmachines/play-vue`.
+`onRenderError` is typed as `RenderErrorHandler` and exported from.
 
 ---
 
@@ -347,8 +347,13 @@ Priority: **route param fills `undefined` slots; explicit non-`undefined` spec p
 - Vue reactivity is only used to trigger re-renders — not for business logic
 - `actor.currentView` (TC39 Signal) is bridged to Vue's reactive system inside `PlayRenderer`
 - Per-view UI state lives in an `@xstate/store` atom, not in Vue reactive state
-- `@json-render/vue` drives rendering; `PlayRenderer` is the signal bridge — import `defineRegistry`, `ComponentFn`, `ComponentContext`, and `useBoundProp` from `@xmachines/play-vue`
-- Vue views should be `.vue` SFCs using `ComponentContext<MyCatalog, "X">` — `defineRegistry` from `@xmachines/play-vue` auto-wraps them via `h(SFC, ctx)`, giving each SFC its own `setup()` context where `useBoundProp` and Vue composables work correctly
+- `@json-render/vue` drives rendering; `PlayRenderer` is the signal bridge — import `defineRegistry`, `ComponentFn`, `ComponentContext`, and `useBoundProp` from
+- Vue views should be `.vue` SFCs using `ComponentContext<MyCatalog, "X">` — `defineRegistry` from and Vue composables work correctly
+
+## Learn More
+
+- [Demo](../../../examples/@xmachines/play-vue-demo/README.md)
+- [Vue Router adapter](../play-vue-router/README.md)
 
 @xmachines/play-vue - Vue 3 renderer for XMachines Play architecture
 
@@ -373,6 +378,7 @@ so consumers import everything from `@xmachines/play-vue` rather than
 - [StateProviderProps](interfaces/StateProviderProps.md)
 - [ValidationProviderProps](interfaces/ValidationProviderProps.md)
 - [ViewContextValue](interfaces/ViewContextValue.md)
+- [VisibilityProviderProps](interfaces/VisibilityProviderProps.md)
 
 ## Type Aliases
 

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

@@ -1,4 +1,4 @@
-[Documentation](../../../README.md) / [@xmachines/play-vue](../README.md) / defineRegistry
+[API](../../../README.md) / [@xmachines/play-vue](../README.md) / defineRegistry
 
 # Function: defineRegistry()
 
@@ -6,7 +6,7 @@
 function defineRegistry<C>(catalog, options): DefineRegistryResult;
 ```
 
-Defined in: [packages/play-vue/src/define-registry.ts:122](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.43/packages/play-vue/src/define-registry.ts#L122)
+Defined in: [packages/play-vue/src/define-registry.ts:131](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.45/packages/play-vue/src/define-registry.ts#L131)
 
 Create a component registry, automatically wrapping `.vue` SFCs so they work
 correctly with `@json-render/vue`'s rendering pipeline.

package/api/@xmachines/play-vue/functions/getPlayViewContext.md

@@ -1,4 +1,4 @@
-[Documentation](../../../README.md) / [@xmachines/play-vue](../README.md) / getPlayViewContext
+[API](../../../README.md) / [@xmachines/play-vue](../README.md) / getPlayViewContext
 
 # Function: getPlayViewContext()
 
@@ -6,7 +6,7 @@
 function getPlayViewContext(): ViewContextValue;
 ```
 
-Defined in: [packages/play-vue/src/actor-provider-context.ts:44](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.43/packages/play-vue/src/actor-provider-context.ts#L44)
+Defined in: [packages/play-vue/src/actor-provider-context.ts:44](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.45/packages/play-vue/src/actor-provider-context.ts#L44)
 
 Access the current ViewContextValue from inside an ActorProvider tree.
 

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

@@ -1,4 +1,4 @@
-[Documentation](../../../README.md) / [@xmachines/play-vue](../README.md) / useActor
+[API](../../../README.md) / [@xmachines/play-vue](../README.md) / useActor
 
 # Function: useActor()
 
@@ -6,7 +6,7 @@
 function useActor(): PlayActor;
 ```
 
-Defined in: [packages/play-vue/src/useActor.ts:43](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.43/packages/play-vue/src/useActor.ts#L43)
+Defined in: [packages/play-vue/src/useActor.ts:43](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.45/packages/play-vue/src/useActor.ts#L43)
 
 ## Returns
 

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

@@ -1,4 +1,4 @@
-[Documentation](../../../README.md) / [@xmachines/play-vue](../README.md) / useBoundProp
+[API](../../../README.md) / [@xmachines/play-vue](../README.md) / useBoundProp
 
 # Function: useBoundProp()
 

package/api/@xmachines/play-vue/interfaces/ActionProviderProps.md

@@ -1,4 +1,4 @@
-[Documentation](../../../README.md) / [@xmachines/play-vue](../README.md) / ActionProviderProps
+[API](../../../README.md) / [@xmachines/play-vue](../README.md) / ActionProviderProps
 
 # Interface: ActionProviderProps
 

package/api/@xmachines/play-vue/interfaces/ActorProviderProps.md

@@ -1,8 +1,8 @@
-[Documentation](../../../README.md) / [@xmachines/play-vue](../README.md) / ActorProviderProps
+[API](../../../README.md) / [@xmachines/play-vue](../README.md) / ActorProviderProps
 
 # Interface: ActorProviderProps
 
-Defined in: [packages/play-vue/src/types.ts:14](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.43/packages/play-vue/src/types.ts#L14)
+Defined in: [packages/play-vue/src/types.ts:14](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.45/packages/play-vue/src/types.ts#L14)
 
 Props for the ActorProvider component.
 Extracted to types.ts so TypeScript can re-export without the vue-shim limitation.
@@ -19,7 +19,7 @@ Extracted to types.ts so TypeScript can re-export without the vue-shim limitatio
 
 | Property                                              | Type                                                                                                                                                                                                                                                             | Description                                                                                                                                                                                                                 | Inherited from                                                                                                                                                                      | Defined in                                                                                                                                                       |
 | ----------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| <a id="property-actor"></a> `actor`                   | [`AbstractActor`](../../play-actor/classes/AbstractActor.md)\<[`AnyActorLogic`](https://www.jsdocs.io/package/xstate#AnyActorLogic), [`EventObject`](https://www.jsdocs.io/package/xstate#EventObject)\> & [`Viewable`](../../play-actor/interfaces/Viewable.md) | Actor instance with currentView signal (requires Viewable capability).                                                                                                                                                      | [`BaseActorProviderProps`](../../play-actor/interfaces/BaseActorProviderProps.md).[`actor`](../../play-actor/interfaces/BaseActorProviderProps.md#property-actor)                   | [packages/play-actor/src/abstract-actor.ts:154](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.43/packages/play-actor/src/abstract-actor.ts#L154) |
-| <a id="property-onrendererror"></a> `onRenderError?`  | [`RenderErrorHandler`](../type-aliases/RenderErrorHandler.md)                                                                                                                                                                                                    | Called when an individual catalog component throws during render. Takes precedence over any onRenderError set via defineRegistry.                                                                                           | [`BaseActorProviderProps`](../../play-actor/interfaces/BaseActorProviderProps.md).[`onRenderError`](../../play-actor/interfaces/BaseActorProviderProps.md#property-onrendererror)   | [packages/play-actor/src/abstract-actor.ts:167](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.43/packages/play-actor/src/abstract-actor.ts#L167) |
-| <a id="property-registryresult"></a> `registryResult` | [`DefineRegistryResult`](DefineRegistryResult.md)                                                                                                                                                                                                                | Full result from defineRegistry() — contains the component registry and action handlers factory.                                                                                                                            | [`BaseActorProviderProps`](../../play-actor/interfaces/BaseActorProviderProps.md).[`registryResult`](../../play-actor/interfaces/BaseActorProviderProps.md#property-registryresult) | [packages/play-actor/src/abstract-actor.ts:156](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.43/packages/play-actor/src/abstract-actor.ts#L156) |
-| <a id="property-store"></a> `store?`                  | `StateStore`                                                                                                                                                                                                                                                     | Optional external StateStore (controlled mode). When provided, spec.state is ignored and this store is the single source of truth. When omitted, a fresh @xstate/store atom is created per view transition from spec.state. | [`BaseActorProviderProps`](../../play-actor/interfaces/BaseActorProviderProps.md).[`store`](../../play-actor/interfaces/BaseActorProviderProps.md#property-store)                   | [packages/play-actor/src/abstract-actor.ts:162](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.43/packages/play-actor/src/abstract-actor.ts#L162) |
+| <a id="property-actor"></a> `actor`                   | [`AbstractActor`](../../play-actor/classes/AbstractActor.md)\<[`AnyActorLogic`](https://www.jsdocs.io/package/xstate#AnyActorLogic), [`EventObject`](https://www.jsdocs.io/package/xstate#EventObject)\> & [`Viewable`](../../play-actor/interfaces/Viewable.md) | Actor instance with currentView signal (requires Viewable capability).                                                                                                                                                      | [`BaseActorProviderProps`](../../play-actor/interfaces/BaseActorProviderProps.md).[`actor`](../../play-actor/interfaces/BaseActorProviderProps.md#property-actor)                   | [packages/play-actor/src/abstract-actor.ts:154](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.45/packages/play-actor/src/abstract-actor.ts#L154) |
+| <a id="property-onrendererror"></a> `onRenderError?`  | [`RenderErrorHandler`](../type-aliases/RenderErrorHandler.md)                                                                                                                                                                                                    | Called when an individual catalog component throws during render. Takes precedence over any onRenderError set via defineRegistry.                                                                                           | [`BaseActorProviderProps`](../../play-actor/interfaces/BaseActorProviderProps.md).[`onRenderError`](../../play-actor/interfaces/BaseActorProviderProps.md#property-onrendererror)   | [packages/play-actor/src/abstract-actor.ts:167](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.45/packages/play-actor/src/abstract-actor.ts#L167) |
+| <a id="property-registryresult"></a> `registryResult` | [`DefineRegistryResult`](DefineRegistryResult.md)                                                                                                                                                                                                                | Full result from defineRegistry() — contains the component registry and action handlers factory.                                                                                                                            | [`BaseActorProviderProps`](../../play-actor/interfaces/BaseActorProviderProps.md).[`registryResult`](../../play-actor/interfaces/BaseActorProviderProps.md#property-registryresult) | [packages/play-actor/src/abstract-actor.ts:156](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.45/packages/play-actor/src/abstract-actor.ts#L156) |
+| <a id="property-store"></a> `store?`                  | `StateStore`                                                                                                                                                                                                                                                     | Optional external StateStore (controlled mode). When provided, spec.state is ignored and this store is the single source of truth. When omitted, a fresh @xstate/store atom is created per view transition from spec.state. | [`BaseActorProviderProps`](../../play-actor/interfaces/BaseActorProviderProps.md).[`store`](../../play-actor/interfaces/BaseActorProviderProps.md#property-store)                   | [packages/play-actor/src/abstract-actor.ts:162](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.45/packages/play-actor/src/abstract-actor.ts#L162) |

package/api/@xmachines/play-vue/interfaces/ComponentContext.md

@@ -1,4 +1,4 @@
-[Documentation](../../../README.md) / [@xmachines/play-vue](../README.md) / ComponentContext
+[API](../../../README.md) / [@xmachines/play-vue](../README.md) / ComponentContext
 
 # Interface: ComponentContext\<C, K\>
 

package/api/@xmachines/play-vue/interfaces/DefineRegistryResult.md

@@ -1,4 +1,4 @@
-[Documentation](../../../README.md) / [@xmachines/play-vue](../README.md) / DefineRegistryResult
+[API](../../../README.md) / [@xmachines/play-vue](../README.md) / DefineRegistryResult
 
 # Interface: DefineRegistryResult
 

package/api/@xmachines/play-vue/interfaces/JSONUIProviderProps.md

@@ -1,4 +1,4 @@
-[Documentation](../../../README.md) / [@xmachines/play-vue](../README.md) / JSONUIProviderProps
+[API](../../../README.md) / [@xmachines/play-vue](../README.md) / JSONUIProviderProps
 
 # Interface: JSONUIProviderProps
 

package/api/@xmachines/play-vue/interfaces/PlayUIProviderProps.md

@@ -1,8 +1,8 @@
-[Documentation](../../../README.md) / [@xmachines/play-vue](../README.md) / PlayUIProviderProps
+[API](../../../README.md) / [@xmachines/play-vue](../README.md) / PlayUIProviderProps
 
 # Interface: PlayUIProviderProps
 
-Defined in: [packages/play-vue/src/types.ts:21](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.43/packages/play-vue/src/types.ts#L21)
+Defined in: [packages/play-vue/src/types.ts:25](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.45/packages/play-vue/src/types.ts#L25)
 
 Props for the ActorProvider component.
 Extracted to types.ts so TypeScript can re-export without the vue-shim limitation.
@@ -15,10 +15,10 @@ Extracted to types.ts so TypeScript can re-export without the vue-shim limitatio
 
 | Property                                                         | Type                                                                                                                                                                                                                                                             | Description                                                                                                                                                                                                                 | Inherited from                                                                                                  | Defined in                                                                                                                                                       |
 | ---------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| <a id="property-actor"></a> `actor`                              | [`AbstractActor`](../../play-actor/classes/AbstractActor.md)\<[`AnyActorLogic`](https://www.jsdocs.io/package/xstate#AnyActorLogic), [`EventObject`](https://www.jsdocs.io/package/xstate#EventObject)\> & [`Viewable`](../../play-actor/interfaces/Viewable.md) | Actor instance with currentView signal (requires Viewable capability).                                                                                                                                                      | [`ActorProviderProps`](ActorProviderProps.md).[`actor`](ActorProviderProps.md#property-actor)                   | [packages/play-actor/src/abstract-actor.ts:154](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.43/packages/play-actor/src/abstract-actor.ts#L154) |
-| <a id="property-functions"></a> `functions?`                     | `Record`\<`string`, (`args?`, `state?`) => `unknown`\>                                                                                                                                                                                                           | Named functions for $computed expressions in props                                                                                                                                                                          | -                                                                                                               | [packages/play-vue/src/types.ts:30](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.43/packages/play-vue/src/types.ts#L30)                         |
-| <a id="property-navigate"></a> `navigate?`                       | (`path`) => `void`                                                                                                                                                                                                                                               | Navigate function forwarded to JSONUIProvider for link resolution                                                                                                                                                           | -                                                                                                               | [packages/play-vue/src/types.ts:23](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.43/packages/play-vue/src/types.ts#L23)                         |
-| <a id="property-onrendererror"></a> `onRenderError?`             | [`RenderErrorHandler`](../type-aliases/RenderErrorHandler.md)                                                                                                                                                                                                    | Called when an individual catalog component throws during render. Takes precedence over any onRenderError set via defineRegistry.                                                                                           | [`ActorProviderProps`](ActorProviderProps.md).[`onRenderError`](ActorProviderProps.md#property-onrendererror)   | [packages/play-actor/src/abstract-actor.ts:167](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.43/packages/play-actor/src/abstract-actor.ts#L167) |
-| <a id="property-registryresult"></a> `registryResult`            | [`DefineRegistryResult`](DefineRegistryResult.md)                                                                                                                                                                                                                | Full result from defineRegistry() — contains the component registry and action handlers factory.                                                                                                                            | [`ActorProviderProps`](ActorProviderProps.md).[`registryResult`](ActorProviderProps.md#property-registryresult) | [packages/play-actor/src/abstract-actor.ts:156](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.43/packages/play-actor/src/abstract-actor.ts#L156) |
-| <a id="property-store"></a> `store?`                             | `StateStore`                                                                                                                                                                                                                                                     | Optional external StateStore (controlled mode). When provided, spec.state is ignored and this store is the single source of truth. When omitted, a fresh @xstate/store atom is created per view transition from spec.state. | [`ActorProviderProps`](ActorProviderProps.md).[`store`](ActorProviderProps.md#property-store)                   | [packages/play-actor/src/abstract-actor.ts:162](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.43/packages/play-actor/src/abstract-actor.ts#L162) |
-| <a id="property-validationfunctions"></a> `validationFunctions?` | `Record`\<`string`, (`value`, `args?`) => `boolean`\>                                                                                                                                                                                                            | Validation functions forwarded to JSONUIProvider                                                                                                                                                                            | -                                                                                                               | [packages/play-vue/src/types.ts:25](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.43/packages/play-vue/src/types.ts#L25)                         |
+| <a id="property-actor"></a> `actor`                              | [`AbstractActor`](../../play-actor/classes/AbstractActor.md)\<[`AnyActorLogic`](https://www.jsdocs.io/package/xstate#AnyActorLogic), [`EventObject`](https://www.jsdocs.io/package/xstate#EventObject)\> & [`Viewable`](../../play-actor/interfaces/Viewable.md) | Actor instance with currentView signal (requires Viewable capability).                                                                                                                                                      | [`ActorProviderProps`](ActorProviderProps.md).[`actor`](ActorProviderProps.md#property-actor)                   | [packages/play-actor/src/abstract-actor.ts:154](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.45/packages/play-actor/src/abstract-actor.ts#L154) |
+| <a id="property-functions"></a> `functions?`                     | `Record`\<`string`, (`args?`, `state?`) => `unknown`\>                                                                                                                                                                                                           | Named functions for $computed expressions in props                                                                                                                                                                          | -                                                                                                               | [packages/play-vue/src/types.ts:34](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.45/packages/play-vue/src/types.ts#L34)                         |
+| <a id="property-navigate"></a> `navigate?`                       | (`path`) => `void`                                                                                                                                                                                                                                               | Navigate function forwarded to JSONUIProvider for link resolution                                                                                                                                                           | -                                                                                                               | [packages/play-vue/src/types.ts:27](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.45/packages/play-vue/src/types.ts#L27)                         |
+| <a id="property-onrendererror"></a> `onRenderError?`             | [`RenderErrorHandler`](../type-aliases/RenderErrorHandler.md)                                                                                                                                                                                                    | Called when an individual catalog component throws during render. Takes precedence over any onRenderError set via defineRegistry.                                                                                           | [`ActorProviderProps`](ActorProviderProps.md).[`onRenderError`](ActorProviderProps.md#property-onrendererror)   | [packages/play-actor/src/abstract-actor.ts:167](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.45/packages/play-actor/src/abstract-actor.ts#L167) |
+| <a id="property-registryresult"></a> `registryResult`            | [`DefineRegistryResult`](DefineRegistryResult.md)                                                                                                                                                                                                                | Full result from defineRegistry() — contains the component registry and action handlers factory.                                                                                                                            | [`ActorProviderProps`](ActorProviderProps.md).[`registryResult`](ActorProviderProps.md#property-registryresult) | [packages/play-actor/src/abstract-actor.ts:156](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.45/packages/play-actor/src/abstract-actor.ts#L156) |
+| <a id="property-store"></a> `store?`                             | `StateStore`                                                                                                                                                                                                                                                     | Optional external StateStore (controlled mode). When provided, spec.state is ignored and this store is the single source of truth. When omitted, a fresh @xstate/store atom is created per view transition from spec.state. | [`ActorProviderProps`](ActorProviderProps.md).[`store`](ActorProviderProps.md#property-store)                   | [packages/play-actor/src/abstract-actor.ts:162](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.45/packages/play-actor/src/abstract-actor.ts#L162) |
+| <a id="property-validationfunctions"></a> `validationFunctions?` | `Record`\<`string`, (`value`, `args?`) => `boolean`\>                                                                                                                                                                                                            | Validation functions forwarded to JSONUIProvider                                                                                                                                                                            | -                                                                                                               | [packages/play-vue/src/types.ts:29](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.45/packages/play-vue/src/types.ts#L29)                         |

package/api/@xmachines/play-vue/interfaces/RendererProps.md

@@ -1,4 +1,4 @@
-[Documentation](../../../README.md) / [@xmachines/play-vue](../README.md) / RendererProps
+[API](../../../README.md) / [@xmachines/play-vue](../README.md) / RendererProps
 
 # Interface: RendererProps
 

package/api/@xmachines/play-vue/interfaces/StateProviderProps.md

@@ -1,4 +1,4 @@
-[Documentation](../../../README.md) / [@xmachines/play-vue](../README.md) / StateProviderProps
+[API](../../../README.md) / [@xmachines/play-vue](../README.md) / StateProviderProps
 
 # Interface: StateProviderProps
 

package/api/@xmachines/play-vue/interfaces/ValidationProviderProps.md

@@ -1,4 +1,4 @@
-[Documentation](../../../README.md) / [@xmachines/play-vue](../README.md) / ValidationProviderProps
+[API](../../../README.md) / [@xmachines/play-vue](../README.md) / ValidationProviderProps
 
 # Interface: ValidationProviderProps
 

package/api/@xmachines/play-vue/interfaces/ViewContextValue.md

@@ -1,8 +1,8 @@
-[Documentation](../../../README.md) / [@xmachines/play-vue](../README.md) / ViewContextValue
+[API](../../../README.md) / [@xmachines/play-vue](../README.md) / ViewContextValue
 
 # Interface: ViewContextValue
 
-Defined in: [packages/play-vue/src/actor-provider-context.ts:21](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.43/packages/play-vue/src/actor-provider-context.ts#L21)
+Defined in: [packages/play-vue/src/actor-provider-context.ts:21](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.45/packages/play-vue/src/actor-provider-context.ts#L21)
 
 Context value provided by ActorProvider and consumed by PlayRenderer (zero-prop leaf).
 Accessible via getPlayViewContext() inside any ActorProvider/PlayUIProvider tree.
@@ -15,7 +15,7 @@ Accessible via getPlayViewContext() inside any ActorProvider/PlayUIProvider tree
 
 | Property                                  | Type                                                  | Description                                                                                               | Inherited from                                                                                                                                                    | Defined in                                                                                                                                                       |
 | ----------------------------------------- | ----------------------------------------------------- | --------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| <a id="property-handlers"></a> `handlers` | `Record`\<`string`, `ActionHandler`\>                 | Action handlers resolved against the live StateStore.                                                     | [`BaseViewContextValue`](../../play-actor/interfaces/BaseViewContextValue.md).[`handlers`](../../play-actor/interfaces/BaseViewContextValue.md#property-handlers) | [packages/play-actor/src/abstract-actor.ts:122](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.43/packages/play-actor/src/abstract-actor.ts#L122) |
-| <a id="property-registry"></a> `registry` | `ComponentRegistry`                                   | Component registry from registryResult.registry.                                                          | [`BaseViewContextValue`](../../play-actor/interfaces/BaseViewContextValue.md).[`registry`](../../play-actor/interfaces/BaseViewContextValue.md#property-registry) | [packages/play-actor/src/abstract-actor.ts:124](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.43/packages/play-actor/src/abstract-actor.ts#L124) |
-| <a id="property-spec"></a> `spec`         | [`PlaySpec`](../../play-actor/interfaces/PlaySpec.md) | The current PlaySpec to render.                                                                           | [`BaseViewContextValue`](../../play-actor/interfaces/BaseViewContextValue.md).[`spec`](../../play-actor/interfaces/BaseViewContextValue.md#property-spec)         | [packages/play-actor/src/abstract-actor.ts:120](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.43/packages/play-actor/src/abstract-actor.ts#L120) |
-| <a id="property-store"></a> `store`       | `StateStore`                                          | The active StateStore — pass to JSONUIProvider/JsonUIProvider as `store` to share state across providers. | [`BaseViewContextValue`](../../play-actor/interfaces/BaseViewContextValue.md).[`store`](../../play-actor/interfaces/BaseViewContextValue.md#property-store)       | [packages/play-actor/src/abstract-actor.ts:126](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.43/packages/play-actor/src/abstract-actor.ts#L126) |
+| <a id="property-handlers"></a> `handlers` | `Record`\<`string`, `ActionHandler`\>                 | Action handlers resolved against the live StateStore.                                                     | [`BaseViewContextValue`](../../play-actor/interfaces/BaseViewContextValue.md).[`handlers`](../../play-actor/interfaces/BaseViewContextValue.md#property-handlers) | [packages/play-actor/src/abstract-actor.ts:122](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.45/packages/play-actor/src/abstract-actor.ts#L122) |
+| <a id="property-registry"></a> `registry` | `ComponentRegistry`                                   | Component registry from registryResult.registry.                                                          | [`BaseViewContextValue`](../../play-actor/interfaces/BaseViewContextValue.md).[`registry`](../../play-actor/interfaces/BaseViewContextValue.md#property-registry) | [packages/play-actor/src/abstract-actor.ts:124](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.45/packages/play-actor/src/abstract-actor.ts#L124) |
+| <a id="property-spec"></a> `spec`         | [`PlaySpec`](../../play-actor/interfaces/PlaySpec.md) | The current PlaySpec to render.                                                                           | [`BaseViewContextValue`](../../play-actor/interfaces/BaseViewContextValue.md).[`spec`](../../play-actor/interfaces/BaseViewContextValue.md#property-spec)         | [packages/play-actor/src/abstract-actor.ts:120](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.45/packages/play-actor/src/abstract-actor.ts#L120) |
+| <a id="property-store"></a> `store`       | `StateStore`                                          | The active StateStore — pass to JSONUIProvider/JsonUIProvider as `store` to share state across providers. | [`BaseViewContextValue`](../../play-actor/interfaces/BaseViewContextValue.md).[`store`](../../play-actor/interfaces/BaseViewContextValue.md#property-store)       | [packages/play-actor/src/abstract-actor.ts:126](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.45/packages/play-actor/src/abstract-actor.ts#L126) |

package/api/@xmachines/play-vue/interfaces/VisibilityProviderProps.md

@@ -0,0 +1,5 @@
+[API](../../../README.md) / [@xmachines/play-vue](../README.md) / VisibilityProviderProps
+
+# Interface: VisibilityProviderProps
+
+Defined in: [packages/play-vue/src/types.ts:23](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.45/packages/play-vue/src/types.ts#L23)

package/api/@xmachines/play-vue/type-aliases/ComponentEntry.md

@@ -1,4 +1,4 @@
-[Documentation](../../../README.md) / [@xmachines/play-vue](../README.md) / ComponentEntry
+[API](../../../README.md) / [@xmachines/play-vue](../README.md) / ComponentEntry
 
 # Type Alias: ComponentEntry\<C, K\>
 
@@ -6,7 +6,7 @@
 type ComponentEntry<C, K> = ComponentFn<C, K> | Component;
 ```
 
-Defined in: [packages/play-vue/src/define-registry.ts:96](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.43/packages/play-vue/src/define-registry.ts#L96)
+Defined in: [packages/play-vue/src/define-registry.ts:105](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.45/packages/play-vue/src/define-registry.ts#L105)
 
 ## Type Parameters
 

package/api/@xmachines/play-vue/type-aliases/ComponentFn.md

@@ -1,4 +1,4 @@
-[Documentation](../../../README.md) / [@xmachines/play-vue](../README.md) / ComponentFn
+[API](../../../README.md) / [@xmachines/play-vue](../README.md) / ComponentFn
 
 # Type Alias: ComponentFn\<C, K\>
 

package/api/@xmachines/play-vue/type-aliases/ComponentsMap.md

@@ -1,4 +1,4 @@
-[Documentation](../../../README.md) / [@xmachines/play-vue](../README.md) / ComponentsMap
+[API](../../../README.md) / [@xmachines/play-vue](../README.md) / ComponentsMap
 
 # Type Alias: ComponentsMap\<C\>
 
@@ -6,7 +6,7 @@
 type ComponentsMap<C> = { [K in keyof InferCatalogComponents<C>]?: ComponentEntry<C, K> };
 ```
 
-Defined in: [packages/play-vue/src/define-registry.ts:100](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.43/packages/play-vue/src/define-registry.ts#L100)
+Defined in: [packages/play-vue/src/define-registry.ts:109](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.45/packages/play-vue/src/define-registry.ts#L109)
 
 ## Type Parameters
 

package/api/@xmachines/play-vue/type-aliases/DefineRegistryOptions.md

@@ -1,4 +1,4 @@
-[Documentation](../../../README.md) / [@xmachines/play-vue](../README.md) / DefineRegistryOptions
+[API](../../../README.md) / [@xmachines/play-vue](../README.md) / DefineRegistryOptions
 
 # Type Alias: DefineRegistryOptions\<C\>
 
@@ -7,13 +7,13 @@ type DefineRegistryOptions<C> = Omit<Parameters<typeof defineRegistryBase>[1], "
 	object;
 ```
 
-Defined in: [packages/play-vue/src/define-registry.ts:104](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.43/packages/play-vue/src/define-registry.ts#L104)
+Defined in: [packages/play-vue/src/define-registry.ts:113](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.45/packages/play-vue/src/define-registry.ts#L113)
 
 ## Type Declaration
 
 | Name          | Type                                       | Defined in                                                                                                                                                     |
 | ------------- | ------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `components?` | [`ComponentsMap`](ComponentsMap.md)\<`C`\> | [packages/play-vue/src/define-registry.ts:108](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.43/packages/play-vue/src/define-registry.ts#L108) |
+| `components?` | [`ComponentsMap`](ComponentsMap.md)\<`C`\> | [packages/play-vue/src/define-registry.ts:117](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.45/packages/play-vue/src/define-registry.ts#L117) |
 
 ## Type Parameters
 

package/api/@xmachines/play-vue/type-aliases/PlayActor.md

@@ -1,4 +1,4 @@
-[Documentation](../../../README.md) / [@xmachines/play-vue](../README.md) / PlayActor
+[API](../../../README.md) / [@xmachines/play-vue](../README.md) / PlayActor
 
 # Type Alias: PlayActor
 
@@ -6,4 +6,4 @@
 type PlayActor = AbstractActor<AnyActorLogic>;
 ```
 
-Defined in: [packages/play-vue/src/useActor.ts:26](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.43/packages/play-vue/src/useActor.ts#L26)
+Defined in: [packages/play-vue/src/useActor.ts:26](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.45/packages/play-vue/src/useActor.ts#L26)

package/api/@xmachines/play-vue/type-aliases/RenderErrorHandler.md

@@ -1,4 +1,4 @@
-[Documentation](../../../README.md) / [@xmachines/play-vue](../README.md) / RenderErrorHandler
+[API](../../../README.md) / [@xmachines/play-vue](../README.md) / RenderErrorHandler
 
 # Type Alias: RenderErrorHandler
 

package/api/@xmachines/play-vue/variables/ActionProvider.md

@@ -1,4 +1,4 @@
-[Documentation](../../../README.md) / [@xmachines/play-vue](../README.md) / ActionProvider
+[API](../../../README.md) / [@xmachines/play-vue](../README.md) / ActionProvider
 
 # Variable: ActionProvider
 

package/api/@xmachines/play-vue/variables/JSONUIProvider.md

@@ -1,4 +1,4 @@
-[Documentation](../../../README.md) / [@xmachines/play-vue](../README.md) / JSONUIProvider
+[API](../../../README.md) / [@xmachines/play-vue](../README.md) / JSONUIProvider
 
 # Variable: JSONUIProvider
 

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

@@ -1,4 +1,4 @@
-[Documentation](../../../README.md) / [@xmachines/play-vue](../README.md) / PlayRenderer
+[API](../../../README.md) / [@xmachines/play-vue](../README.md) / PlayRenderer
 
 # Variable: PlayRenderer
 
@@ -6,4 +6,4 @@
 const PlayRenderer: DefineComponent<{}, {}, unknown>;
 ```
 
-Defined in: [packages/play-vue/src/vue-shim.d.ts:3](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.43/packages/play-vue/src/vue-shim.d.ts#L3)
+Defined in: [packages/play-vue/src/vue-shim.d.ts:3](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.45/packages/play-vue/src/vue-shim.d.ts#L3)

package/api/@xmachines/play-vue/variables/Renderer.md

@@ -1,4 +1,4 @@
-[Documentation](../../../README.md) / [@xmachines/play-vue](../README.md) / Renderer
+[API](../../../README.md) / [@xmachines/play-vue](../README.md) / Renderer
 
 # Variable: Renderer
 

package/api/@xmachines/play-vue/variables/StateProvider.md

@@ -1,4 +1,4 @@
-[Documentation](../../../README.md) / [@xmachines/play-vue](../README.md) / StateProvider
+[API](../../../README.md) / [@xmachines/play-vue](../README.md) / StateProvider
 
 # Variable: StateProvider
 

package/api/@xmachines/play-vue/variables/ValidationProvider.md

@@ -1,4 +1,4 @@
-[Documentation](../../../README.md) / [@xmachines/play-vue](../README.md) / ValidationProvider
+[API](../../../README.md) / [@xmachines/play-vue](../README.md) / ValidationProvider
 
 # Variable: ValidationProvider
 

package/api/@xmachines/play-vue/variables/VisibilityProvider.md

@@ -1,4 +1,4 @@
-[Documentation](../../../README.md) / [@xmachines/play-vue](../README.md) / VisibilityProvider
+[API](../../../README.md) / [@xmachines/play-vue](../README.md) / VisibilityProvider
 
 # Variable: VisibilityProvider
 

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

@@ -1,4 +1,4 @@
-[Documentation](../../README.md) / @xmachines/play-vue-router
+[API](../../README.md) / @xmachines/play-vue-router
 
 # @xmachines/play-vue-router
 
@@ -10,7 +10,7 @@ Bidirectional sync between Vue Router and XMachines state machines with Composit
 
 `@xmachines/play-vue-router` enables Vue.js applications to use XMachines state machines as the source of truth for routing logic. Your state machine controls navigation through Vue Router's reactive primitives.
 
-Per [Play RFC](../docs/rfc/play.md), this package implements:
+Per [Play RFC](../../../rfc/play.md), this package implements:
 
 - **Actor Authority (INV-01):** State machine validates navigation, router reflects decisions
 - **Passive Infrastructure (INV-04):** Router observes `actor.currentRoute` signal
@@ -40,10 +40,10 @@ npm install vue-router@^4.0.0 vue@^3.5.0 @xmachines/play-vue-router @xmachines/p
 
 - `vue-router` ^4.0.0 || ^5.0.0 — Vue Router library
 - `vue` ^3.5.0 — Vue runtime
-- `@xmachines/play-vue` — Vue renderer (`PlayRenderer`)
-- `@xmachines/play-actor` — Actor base
-- `@xmachines/play-router` — Route extraction
-- `@xmachines/play-signals` — TC39 Signals primitives
+  -)
+- — Actor base
+- — Route extraction
+- — TC39 Signals primitives
 
 ## Quick Start
 
@@ -476,7 +476,7 @@ onUnmounted(() => {
 
 ## Error Handling
 
-All runtime errors thrown by this package extend `PlayError` from `@xmachines/play` and
+All runtime errors thrown by this package extend `PlayError` from and
 are exported from the `./errors` subpath:
 
 ```typescript
@@ -552,13 +552,12 @@ private syncActorFromRouter(to: RouteLocation): void {
 
 **Package Dependencies:**
 
-- `@xmachines/play` - Protocol interfaces (`PlayRouteEvent`, `RouterBridge`)
-- `@xmachines/play-actor` - Actor base class with signal protocol
-- `@xmachines/play-router` - Route extraction and tree building
-- `@xmachines/play-signals` - TC39 Signals polyfill for reactivity
-- `@xmachines/play-xstate` - XState integration via `definePlayer()`
+-)
 
-**Architecture Layers:**
+-   - Actor base class with signal protocol
+-   - Route extraction and tree building
+-   - TC39 Signals polyfill for reactivity
+- **Architecture Layers:**
 
 ```
 ┌─────────────────────────────────────┐
@@ -618,6 +617,11 @@ router.afterEach((to) => {
 
 **Why it happens:** Vue Router's global `route` object updates asynchronously during navigation. The `to` parameter in `afterEach` is the destination route with correct params.
 
+## Learn More
+
+- [Demo](../../../examples/@xmachines/play-vue-router-demo/README.md)
+- [Vue renderer](../play-vue/README.md)
+
 ## License
 
 Copyright (c) 2016 [Mikael Karon](mailto:mikael@karon.se). All rights reserved.
@@ -633,6 +637,7 @@ For a copy, see <https://opensource.org/licenses/MIT>.
 ## Interfaces
 
 - [PlayRouteEvent](interfaces/PlayRouteEvent.md)
+- [RouteMapOptions](interfaces/RouteMapOptions.md)
 - [RouteMapping](interfaces/RouteMapping.md)
 - [RouterBridge](interfaces/RouterBridge.md)
 

package/api/@xmachines/play-vue-router/classes/RouteMap.md

@@ -1,8 +1,8 @@
-[Documentation](../../../README.md) / [@xmachines/play-vue-router](../README.md) / RouteMap
+[API](../../../README.md) / [@xmachines/play-vue-router](../README.md) / RouteMap
 
 # Class: RouteMap
 
-Defined in: [play-router/src/base-route-map.ts:100](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.43/packages/play-router/src/base-route-map.ts#L100)
+Defined in: [play-router/src/base-route-map.ts:100](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.45/packages/play-router/src/base-route-map.ts#L100)
 
 Shared bidirectional route map base class.
 
@@ -50,7 +50,7 @@ map.getPathByStateId("missing"); // null
 new RouteMap(mappings, options?): RouteMap;
 ```
 
-Defined in: [play-router/src/base-route-map.ts:125](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.43/packages/play-router/src/base-route-map.ts#L125)
+Defined in: [play-router/src/base-route-map.ts:125](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.45/packages/play-router/src/base-route-map.ts#L125)
 
 Build a route map from an array of state ID ↔ path mappings.
 
@@ -78,7 +78,7 @@ buckets for efficient candidate selection.
 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.43/packages/play-router/src/base-route-map.ts#L209)
+Defined in: [play-router/src/base-route-map.ts:209](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.45/packages/play-router/src/base-route-map.ts#L209)
 
 Look up the path pattern registered for a state ID.
 
@@ -109,7 +109,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.43/packages/play-router/src/base-route-map.ts#L174)
+Defined in: [play-router/src/base-route-map.ts:174](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.45/packages/play-router/src/base-route-map.ts#L174)
 
 Resolve a URL path to its mapped state ID.