@xmachines/docs 1.0.0-beta.27 → 1.0.0-beta.28

package/api/@xmachines/play/classes/PlayError.md

@@ -2,7 +2,7 @@
 
 # Class: PlayError
 
-Defined in: [packages/play/src/errors.ts:63](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.27/packages/play/src/errors.ts#L63)
+Defined in: [packages/play/src/errors.ts:63](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play/src/errors.ts#L63)
 
 Base class for all typed runtime errors thrown by `@xmachines/*` packages.
 
@@ -82,7 +82,7 @@ new PlayError(
    options?): PlayError;
 ```
 
-Defined in: [packages/play/src/errors.ts:82](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.27/packages/play/src/errors.ts#L82)
+Defined in: [packages/play/src/errors.ts:82](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play/src/errors.ts#L82)
 
 #### Parameters
 
@@ -108,10 +108,10 @@ Error.constructor;
 | Property                                                | Modifier   | Type      | Description                                                                                                                                                                                                                                                                                                                                                                                                                                       | Inherited from          | Defined in                                                                                                                         |
 | ------------------------------------------------------- | ---------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
 | <a id="property-cause"></a> `cause?`                    | `public`   | `unknown` | -                                                                                                                                                                                                                                                                                                                                                                                                                                                 | `Error.cause`           | -                                                                                                                                  |
-| <a id="property-code"></a> `code`                       | `readonly` | `string`  | A stable, machine-readable error identifier. Error codes follow the `PLAY_<PACKAGE>_<DESCRIPTION>` naming convention and are guaranteed stable across patch and minor releases within a major version. Never match on `.message` — always match on `.code` or the subclass.                                                                                                                                                                       | -                       | [packages/play/src/errors.ts:74](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.27/packages/play/src/errors.ts#L74) |
+| <a id="property-code"></a> `code`                       | `readonly` | `string`  | A stable, machine-readable error identifier. Error codes follow the `PLAY_<PACKAGE>_<DESCRIPTION>` naming convention and are guaranteed stable across patch and minor releases within a major version. Never match on `.message` — always match on `.code` or the subclass.                                                                                                                                                                       | -                       | [packages/play/src/errors.ts:74](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play/src/errors.ts#L74) |
 | <a id="property-message"></a> `message`                 | `public`   | `string`  | -                                                                                                                                                                                                                                                                                                                                                                                                                                                 | `Error.message`         | -                                                                                                                                  |
 | <a id="property-name"></a> `name`                       | `public`   | `string`  | -                                                                                                                                                                                                                                                                                                                                                                                                                                                 | `Error.name`            | -                                                                                                                                  |
-| <a id="property-scope"></a> `scope`                     | `readonly` | `string`  | The class or module that threw this error (e.g. `"RouterBridgeBase"`).                                                                                                                                                                                                                                                                                                                                                                            | -                       | [packages/play/src/errors.ts:65](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.27/packages/play/src/errors.ts#L65) |
+| <a id="property-scope"></a> `scope`                     | `readonly` | `string`  | The class or module that threw this error (e.g. `"RouterBridgeBase"`).                                                                                                                                                                                                                                                                                                                                                                            | -                       | [packages/play/src/errors.ts:65](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play/src/errors.ts#L65) |
 | <a id="property-stack"></a> `stack?`                    | `public`   | `string`  | -                                                                                                                                                                                                                                                                                                                                                                                                                                                 | `Error.stack`           | -                                                                                                                                  |
 | <a id="property-stacktracelimit"></a> `stackTraceLimit` | `static`   | `number`  | The `Error.stackTraceLimit` property specifies the number of stack frames collected by a stack trace (whether generated by `new Error().stack` or `Error.captureStackTrace(obj)`). The default value is `10` but may be set to any valid JavaScript number. Changes will affect any stack trace captured _after_ the value has been changed. If set to a non-number value, or set to a negative number, stack traces will not capture any frames. | `Error.stackTraceLimit` | -                                                                                                                                  |
 
@@ -123,8 +123,6 @@ Error.constructor;
 static captureStackTrace(targetObject, constructorOpt?): void;
 ```
 
-Defined in: `@types/node`
-
 Creates a `.stack` property on `targetObject`, which when accessed returns
 a string representing the location in the code at which
 `Error.captureStackTrace()` was called.
@@ -194,8 +192,6 @@ Error.captureStackTrace;
 static isError(error): error is Error;
 ```
 
-Defined in: `typescript`
-
 Indicates whether the argument provided is a built-in Error instance or not.
 
 #### Parameters
@@ -222,8 +218,6 @@ Error.isError;
 static prepareStackTrace(err, stackTraces): any;
 ```
 
-Defined in: `@types/node`
-
 #### Parameters
 
 | Parameter     | Type         |

package/api/@xmachines/play/type-aliases/PlayEvent.md

@@ -6,7 +6,7 @@
 type PlayEvent<TPayload> = object & TPayload;
 ```
 
-Defined in: [packages/play/src/types.ts:69](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.27/packages/play/src/types.ts#L69)
+Defined in: [packages/play/src/types.ts:69](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play/src/types.ts#L69)
 
 Generic event type for Play Architecture
 
@@ -34,7 +34,7 @@ Robot, and other state machine libraries.
 
 | Name   | Type     | Defined in                                                                                                                       |
 | ------ | -------- | -------------------------------------------------------------------------------------------------------------------------------- |
-| `type` | `string` | [packages/play/src/types.ts:70](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.27/packages/play/src/types.ts#L70) |
+| `type` | `string` | [packages/play/src/types.ts:70](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play/src/types.ts#L70) |
 
 ## Type Parameters
 

package/api/@xmachines/play-actor/classes/AbstractActor.md

@@ -2,7 +2,7 @@
 
 # Abstract Class: AbstractActor\<TLogic, TEvent\>
 
-Defined in: [packages/play-actor/src/abstract-actor.ts:141](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.27/packages/play-actor/src/abstract-actor.ts#L141)
+Defined in: [packages/play-actor/src/abstract-actor.ts:141](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play-actor/src/abstract-actor.ts#L141)
 
 Abstract base class for Play Architecture actors.
 
@@ -33,8 +33,6 @@ Infrastructure layer communication.
 new AbstractActor<TLogic, TEvent>(logic, options?): AbstractActor<TLogic, TEvent>;
 ```
 
-Defined in: `xstate`
-
 Creates a new actor instance for the given logic with the provided options,
 if any.
 
@@ -67,7 +65,7 @@ Actor<TLogic>.constructor
 | <a id="property-ref"></a> `ref`             | `public`   | [`ActorRef`](https://www.jsdocs.io/package/xstate#ActorRef)\<[`SnapshotFrom`](https://www.jsdocs.io/package/xstate#SnapshotFrom)\<`TLogic`\>, [`EventFromLogic`](https://www.jsdocs.io/package/xstate#EventFromLogic)\<`TLogic`\>, [`EmittedFrom`](https://www.jsdocs.io/package/xstate#EmittedFrom)\<`TLogic`\>\> | -                                                                                                                                                                                       | `Actor.ref`       | -                                                                                                                                                                |
 | <a id="property-sessionid"></a> `sessionId` | `public`   | `string`                                                                                                                                                                                                                                                                                                           | The globally unique process ID for this invocation.                                                                                                                                     | `Actor.sessionId` | -                                                                                                                                                                |
 | <a id="property-src"></a> `src`             | `public`   | \| `string` \| [`AnyActorLogic`](https://www.jsdocs.io/package/xstate#AnyActorLogic)                                                                                                                                                                                                                               | -                                                                                                                                                                                       | `Actor.src`       | -                                                                                                                                                                |
-| <a id="property-state"></a> `state`         | `abstract` | [`State`](../../play-signals/namespaces/Signal/classes/State.md)\<`unknown`\>                                                                                                                                                                                                                                      | Reactive snapshot of current actor state. Infrastructure observes this signal to react to state changes without directly coupling to the actor's internal state machine implementation. | -                 | [packages/play-actor/src/abstract-actor.ts:151](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.27/packages/play-actor/src/abstract-actor.ts#L151) |
+| <a id="property-state"></a> `state`         | `abstract` | [`State`](../../play-signals/namespaces/Signal/classes/State.md)\<`unknown`\>                                                                                                                                                                                                                                      | Reactive snapshot of current actor state. Infrastructure observes this signal to react to state changes without directly coupling to the actor's internal state machine implementation. | -                 | [packages/play-actor/src/abstract-actor.ts:151](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play-actor/src/abstract-actor.ts#L151) |
 | <a id="property-system"></a> `system`       | `public`   | [`AnyActorSystem`](https://www.jsdocs.io/package/xstate#AnyActorSystem)                                                                                                                                                                                                                                            | The system to which this actor belongs.                                                                                                                                                 | `Actor.system`    | -                                                                                                                                                                |
 | <a id="property-systemid"></a> `systemId`   | `public`   | `string` \| `undefined`                                                                                                                                                                                                                                                                                            | -                                                                                                                                                                                       | `Actor.systemId`  | -                                                                                                                                                                |
 
@@ -79,8 +77,6 @@ Actor<TLogic>.constructor
 observable: InteropSubscribable<SnapshotFrom<TLogic>>;
 ```
 
-Defined in: `xstate`
-
 #### Returns
 
 [`InteropSubscribable`](https://www.jsdocs.io/package/xstate#InteropSubscribable)\<[`SnapshotFrom`](https://www.jsdocs.io/package/xstate#SnapshotFrom)\<`TLogic`\>\>
@@ -99,8 +95,6 @@ Actor.[observable]
 getPersistedSnapshot(): Snapshot<unknown>;
 ```
 
-Defined in: `xstate`
-
 Obtain the internal state of the actor, which can be persisted.
 
 #### Returns
@@ -135,8 +129,6 @@ Actor.getPersistedSnapshot;
 getSnapshot(): SnapshotFrom<TLogic>;
 ```
 
-Defined in: `xstate`
-
 Read an actor’s snapshot synchronously.
 
 #### Returns
@@ -172,8 +164,6 @@ Actor.getSnapshot;
 on<TType>(type, handler): Subscription;
 ```
 
-Defined in: `xstate`
-
 #### Type Parameters
 
 | Type Parameter          |
@@ -205,8 +195,6 @@ Actor.on;
 select<TSelected>(selector, equalityFn?): Readable<TSelected>;
 ```
 
-Defined in: `xstate`
-
 #### Type Parameters
 
 | Type Parameter |
@@ -238,7 +226,7 @@ Actor.select;
 abstract send(event): void;
 ```
 
-Defined in: [packages/play-actor/src/abstract-actor.ts:158](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.27/packages/play-actor/src/abstract-actor.ts#L158)
+Defined in: [packages/play-actor/src/abstract-actor.ts:158](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play-actor/src/abstract-actor.ts#L158)
 
 Send event to Actor.
 
@@ -268,8 +256,6 @@ Actor.send;
 start(): this;
 ```
 
-Defined in: `xstate`
-
 Starts the Actor from the initial state
 
 #### Returns
@@ -290,8 +276,6 @@ Actor.start;
 stop(): this;
 ```
 
-Defined in: `xstate`
-
 Stops the Actor and unsubscribe all listeners.
 
 #### Returns
@@ -314,8 +298,6 @@ Actor.stop;
 subscribe(observer): Subscription;
 ```
 
-Defined in: `xstate`
-
 Subscribe an observer to an actor’s snapshot values.
 
 ##### Parameters
@@ -392,8 +374,6 @@ subscribe(
    completeListener?): Subscription;
 ```
 
-Defined in: `xstate`
-
 Subscribe an observer to an actor’s snapshot values.
 
 ##### Parameters
@@ -471,8 +451,6 @@ Actor.subscribe;
 toJSON(): object;
 ```
 
-Defined in: `xstate`
-
 #### Returns
 
 `object`

package/api/@xmachines/play-actor/functions/typedSpec.md

@@ -6,7 +6,7 @@
 function typedSpec<TContext>(spec): PlaySpec;
 ```
 
-Defined in: [packages/play-actor/src/abstract-actor.ts:86](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.27/packages/play-actor/src/abstract-actor.ts#L86)
+Defined in: [packages/play-actor/src/abstract-actor.ts:86](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play-actor/src/abstract-actor.ts#L86)
 
 Identity helper that constrains a `PlaySpec` object's `contextProps` to keys
 of a specific machine context type, giving compile-time validation and IDE

package/api/@xmachines/play-actor/interfaces/PlaySpec.md

@@ -2,7 +2,7 @@
 
 # Interface: PlaySpec
 
-Defined in: [packages/play-actor/src/abstract-actor.ts:43](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.27/packages/play-actor/src/abstract-actor.ts#L43)
+Defined in: [packages/play-actor/src/abstract-actor.ts:43](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play-actor/src/abstract-actor.ts#L43)
 
 XMachines extension of `@json-render/core` `Spec`.
 
@@ -22,7 +22,7 @@ entries against your machine's context type at compile time.
 
 | Property                                           | Modifier   | Type                              | Description                                                                                                                                                                                                                                                                                             | Inherited from  | Defined in                                                                                                                                                     |
 | -------------------------------------------------- | ---------- | --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| <a id="property-contextprops"></a> `contextProps?` | `readonly` | readonly `string`[]               | Explicit allowlist of machine context field names to expose as prop slots. Each named field is merged into every spec element's `props` at view derivation time, filling any slot whose current value is `undefined`. Use `typedSpec<TContext>(...)` to constrain entries to `keyof TContext & string`. | -               | [packages/play-actor/src/abstract-actor.ts:51](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.27/packages/play-actor/src/abstract-actor.ts#L51) |
+| <a id="property-contextprops"></a> `contextProps?` | `readonly` | readonly `string`[]               | Explicit allowlist of machine context field names to expose as prop slots. Each named field is merged into every spec element's `props` at view derivation time, filling any slot whose current value is `undefined`. Use `typedSpec<TContext>(...)` to constrain entries to `keyof TContext & string`. | -               | [packages/play-actor/src/abstract-actor.ts:51](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play-actor/src/abstract-actor.ts#L51) |
 | <a id="property-elements"></a> `elements`          | `public`   | `Record`\<`string`, `UIElement`\> | Flat map of elements by key                                                                                                                                                                                                                                                                             | `Spec.elements` | -                                                                                                                                                              |
 | <a id="property-root"></a> `root`                  | `public`   | `string`                          | Root element key                                                                                                                                                                                                                                                                                        | `Spec.root`     | -                                                                                                                                                              |
 | <a id="property-state"></a> `state?`               | `public`   | `Record`\<`string`, `unknown`\>   | Optional initial state to seed the state model. Components using statePath will read from / write to this state.                                                                                                                                                                                        | `Spec.state`    | -                                                                                                                                                              |

package/api/@xmachines/play-actor/interfaces/Routable.md

@@ -2,7 +2,7 @@
 
 # Interface: Routable
 
-Defined in: [packages/play-actor/src/abstract-actor.ts:27](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.27/packages/play-actor/src/abstract-actor.ts#L27)
+Defined in: [packages/play-actor/src/abstract-actor.ts:27](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play-actor/src/abstract-actor.ts#L27)
 
 Optional capability: Routing support
 
@@ -10,5 +10,5 @@ Optional capability: Routing support
 
 | Property                                          | Modifier   | Type                                                                                         | Defined in                                                                                                                                                     |
 | ------------------------------------------------- | ---------- | -------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| <a id="property-currentroute"></a> `currentRoute` | `readonly` | [`Computed`](../../play-signals/namespaces/Signal/classes/Computed.md)\<`string` \| `null`\> | [packages/play-actor/src/abstract-actor.ts:28](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.27/packages/play-actor/src/abstract-actor.ts#L28) |
-| <a id="property-initialroute"></a> `initialRoute` | `readonly` | `string` \| `null`                                                                           | [packages/play-actor/src/abstract-actor.ts:29](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.27/packages/play-actor/src/abstract-actor.ts#L29) |
+| <a id="property-currentroute"></a> `currentRoute` | `readonly` | [`Computed`](../../play-signals/namespaces/Signal/classes/Computed.md)\<`string` \| `null`\> | [packages/play-actor/src/abstract-actor.ts:28](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play-actor/src/abstract-actor.ts#L28) |
+| <a id="property-initialroute"></a> `initialRoute` | `readonly` | `string` \| `null`                                                                           | [packages/play-actor/src/abstract-actor.ts:29](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play-actor/src/abstract-actor.ts#L29) |

package/api/@xmachines/play-actor/interfaces/ViewMetadata.md

@@ -2,7 +2,7 @@
 
 # Interface: ViewMetadata
 
-Defined in: [packages/play-actor/src/abstract-actor.ts:100](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.27/packages/play-actor/src/abstract-actor.ts#L100)
+Defined in: [packages/play-actor/src/abstract-actor.ts:100](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play-actor/src/abstract-actor.ts#L100)
 
 View metadata for rendering.
 
@@ -13,5 +13,5 @@ Used by PlayRenderer to dynamically render UI based on actor state.
 
 | Property                                    | Type                      | Description                                                                                                                                                                                                                                | Defined in                                                                                                                                                       |
 | ------------------------------------------- | ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| <a id="property-component"></a> `component` | `string`                  | Root element type name (for diagnostics and component resolution)                                                                                                                                                                          | [packages/play-actor/src/abstract-actor.ts:102](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.27/packages/play-actor/src/abstract-actor.ts#L102) |
-| <a id="property-spec"></a> `spec`           | [`PlaySpec`](PlaySpec.md) | XMachines view spec — extends `@json-render/core` Spec with `contextProps` for explicit context field exposure. Use `typedSpec<TContext>(...)` at the definition site to validate `contextProps` entries against the machine context type. | [packages/play-actor/src/abstract-actor.ts:110](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.27/packages/play-actor/src/abstract-actor.ts#L110) |
+| <a id="property-component"></a> `component` | `string`                  | Root element type name (for diagnostics and component resolution)                                                                                                                                                                          | [packages/play-actor/src/abstract-actor.ts:102](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play-actor/src/abstract-actor.ts#L102) |
+| <a id="property-spec"></a> `spec`           | [`PlaySpec`](PlaySpec.md) | XMachines view spec — extends `@json-render/core` Spec with `contextProps` for explicit context field exposure. Use `typedSpec<TContext>(...)` at the definition site to validate `contextProps` entries against the machine context type. | [packages/play-actor/src/abstract-actor.ts:110](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play-actor/src/abstract-actor.ts#L110) |

package/api/@xmachines/play-actor/interfaces/Viewable.md

@@ -2,7 +2,7 @@
 
 # Interface: Viewable
 
-Defined in: [packages/play-actor/src/abstract-actor.ts:121](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.27/packages/play-actor/src/abstract-actor.ts#L121)
+Defined in: [packages/play-actor/src/abstract-actor.ts:121](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play-actor/src/abstract-actor.ts#L121)
 
 Actor capability for exposing renderable view state.
 
@@ -15,4 +15,4 @@ framework adapter.
 
 | Property                                        | Modifier   | Type                                                                                                            | Description                                                                                                                                        | Defined in                                                                                                                                                       |
 | ----------------------------------------------- | ---------- | --------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| <a id="property-currentview"></a> `currentView` | `readonly` | [`State`](../../play-signals/namespaces/Signal/classes/State.md)\<[`ViewMetadata`](ViewMetadata.md) \| `null`\> | Current view signal. State signal containing view.component and view.spec from meta.view. Infrastructure renders view — Logic-Driven UI invariant. | [packages/play-actor/src/abstract-actor.ts:128](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.27/packages/play-actor/src/abstract-actor.ts#L128) |
+| <a id="property-currentview"></a> `currentView` | `readonly` | [`State`](../../play-signals/namespaces/Signal/classes/State.md)\<[`ViewMetadata`](ViewMetadata.md) \| `null`\> | Current view signal. State signal containing view.component and view.spec from meta.view. Infrastructure renders view — Logic-Driven UI invariant. | [packages/play-actor/src/abstract-actor.ts:128](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play-actor/src/abstract-actor.ts#L128) |

package/api/@xmachines/play-actor-shared/README.md

@@ -0,0 +1,155 @@
+[Documentation](../../README.md) / @xmachines/play-actor-shared
+
+# play-actor Shared Demo Package
+
+Shared auth machine, catalog, and browser test fixtures consumed by all `@xmachines` renderer and router adapter demos.
+
+## What This Demonstrates
+
+- A single `authMachine` reused across every framework demo without modification
+- Framework-agnostic `authCatalog` defining typed component prop shapes and action param schemas
+- Shared browser test suite (`renderer-demo-browser-suite.ts`) importable by any renderer demo
+- State machine invariants: public routes, protected routes with auth guards, and nested sub-states
+
+## Running the Demo
+
+This is a shared fixture package — it has no standalone dev server. Run its tests from the repository root:
+
+```bash
+npm install
+npm run test -w @xmachines/play-actor-shared
+```
+
+## Step-by-Step Code Flow
+
+Use this order to understand the package structure:
+
+1. `src/auth-machine.ts` defines the `authMachine` using XState `setup()` with `formatPlayRouteTransitions` — all states include `meta.route` and `meta.view` for router and renderer integration.
+2. `src/catalog.ts` defines `authCatalog` using `defineCatalog` from `@json-render/core` — typed component prop schemas (via Zod) and action param schemas for `login`, `logout`, and all `route*` actions.
+3. `src/index.ts` re-exports `authMachine`, `authCatalog`, and all associated TypeScript types (`AuthActor`, `AuthContext`, `AuthEvents`, `AuthSnapshot`, `AuthCatalog`).
+4. `test/shared-package.test.ts` verifies machine invariants: starts at home, unauthenticated; `auth.login` transitions to `dashboard.overview`; `auth.logout` returns to `home`.
+5. `test/renderer-demo-browser-suite.ts` exports `defineNoRouterDemoBrowserSuite` — a portable browser test helper used by renderer demos that mount `<App />` and assert DOM state.
+
+```ts
+// src/auth-machine.ts (shape)
+export const authMachine = authSetup.createMachine(
+	formatPlayRouteTransitions({
+		id: "auth",
+		initial: "home",
+		on: {
+			"auth.login": { target: ".dashboard", guard: ({ context }) => !context.isAuthenticated },
+			"auth.logout": { target: ".home", guard: ({ context }) => context.isAuthenticated },
+		},
+		states: {
+			home: { meta: { route: "/", view: { component: "Home", spec: { ... } } } },
+			login: { meta: { route: "/login", view: { component: "Login", spec: { ... } } } },
+			dashboard: {
+				meta: { route: "/dashboard" },
+				initial: "overview",
+				always: { guard: ({ context }) => !context.isAuthenticated, target: "login" },
+				states: {
+					overview: { meta: { route: "overview", view: { component: "Overview", spec: { ... } } } },
+					stats: { meta: { route: "stats", view: { component: "Stats", spec: { ... } } } },
+				},
+			},
+			profile: { meta: { route: "/profile/:username", view: { component: "Profile", spec: { ... } } } },
+			settings: { meta: { route: "/settings/:section?", view: { component: "Settings", spec: { ... } } } },
+		},
+	}),
+);
+```
+
+```ts
+// src/catalog.ts (shape)
+export const authCatalog = defineCatalog(schema, {
+	components: {
+		Home: { props: z.object({ title: z.string() }) },
+		Login: { props: z.object({ title: z.string() }) },
+		Dashboard: { props: z.object({ welcome: z.boolean(), username: z.string() }) },
+		Profile: { props: z.object({ username: z.string() }) },
+		// ... more components
+	},
+	actions: {
+		login: { params: z.object({ username: z.string() }), description: "Login with username" },
+		logout: { description: "Logout and return to home" },
+		// ... more actions
+	},
+});
+```
+
+## Key Files
+
+- `src/auth-machine.ts` - XState auth machine with route metadata, guards, and nested dashboard states
+- `src/catalog.ts` - `authCatalog` with typed component and action schemas
+- `src/index.ts` - public re-exports: `authMachine`, `authCatalog`, all types
+- `src/index.css` - shared demo stylesheet imported by all renderer demos
+- `test/shared-package.test.ts` - machine invariant tests (start state, login, logout)
+- `test/renderer-demo-browser-suite.ts` - portable browser test helper for renderer demos
+
+## State Machine & Architecture Details
+
+The auth machine embodies XMachines architectural invariants:
+
+1. **Actor Authority:** All navigation uses `play.route` events — the machine evaluates each route transition against its current state and guard conditions. Framework adapters never bypass this.
+2. **Passive Infrastructure:** `meta.route` on each state is metadata for the router adapter to read, not a command. The actor drives the URL, not the other way around.
+3. **Signal-Only Reactivity:** The machine exposes `actor.currentView` and `actor.currentRoute` as TC39 Signals. Framework renderers and router adapters observe these signals — they never poll or subscribe to snapshots directly.
+
+## Watcher Lifecycle and Cleanup Contract
+
+The shared machine itself does not manage watchers — that responsibility belongs to each framework adapter. However, the machine's signal-based architecture requires adapters to follow the canonical lifecycle:
+
+1. `notify`
+2. `queueMicrotask`
+3. `getPending()`
+4. Read actor signals and project framework-local state
+5. Re-arm with `watch()`/`watch(...signals)`
+
+The `test/renderer-demo-browser-suite.ts` exports `defineNoRouterDemoBrowserSuite`, which each renderer demo uses to assert startup rendering and debug panel state without coupling to framework internals.
+
+## Adapter Boundaries
+
+This package is pure shared infrastructure: no framework imports, no DOM dependencies. It defines the contract (machine + catalog) that all framework adapters implement against. The `AuthActor` type exported here is the preferred import for components across all framework demos — it decouples component implementations from the concrete machine type.
+
+## Available Scripts
+
+These commands are defined in `package.json`:
+
+| Command                                                | Description                      |
+| ------------------------------------------------------ | -------------------------------- |
+| `npm run test -w @xmachines/play-actor-shared`         | Run Vitest test suite            |
+| `npm run test:browser -w @xmachines/play-actor-shared` | Run browser-focused Vitest suite |
+| `npm run build -w @xmachines/play-actor-shared`        | Build TypeScript declarations    |
+
+## Verification
+
+Use these checks to validate the shared package invariants:
+
+```bash
+npm run test -w @xmachines/play-actor-shared
+```
+
+Expected result: machine exports, start state, login, and logout invariants all pass.
+
+## Learn More
+
+- [play-actor package README](../play-actor/README.md)
+
+## Interfaces
+
+- [AuthContext](interfaces/AuthContext.md)
+
+## Type Aliases
+
+- [AuthActor](type-aliases/AuthActor.md)
+- [AuthCatalog](type-aliases/AuthCatalog.md)
+- [AuthEvents](type-aliases/AuthEvents.md)
+- [AuthInput](type-aliases/AuthInput.md)
+- [AuthSnapshot](type-aliases/AuthSnapshot.md)
+- [CatalogProps](type-aliases/CatalogProps.md)
+- [InferProps](type-aliases/InferProps.md)
+
+## Variables
+
+- [authCatalog](variables/authCatalog.md)
+- [authMachine](variables/authMachine.md)
+- [authSetup](variables/authSetup.md)

package/api/@xmachines/play-actor-shared/interfaces/AuthContext.md

@@ -0,0 +1,14 @@
+[Documentation](../../../README.md) / [@xmachines/play-actor-shared](../README.md) / AuthContext
+
+# Interface: AuthContext
+
+Defined in: [packages/play-actor/examples/shared/src/auth-machine.ts:27](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play-actor/examples/shared/src/auth-machine.ts#L27)
+
+## Properties
+
+| Property                                                | Type                           | Defined in                                                                                                                                                                                 |
+| ------------------------------------------------------- | ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| <a id="property-isauthenticated"></a> `isAuthenticated` | `boolean`                      | [packages/play-actor/examples/shared/src/auth-machine.ts:28](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play-actor/examples/shared/src/auth-machine.ts#L28) |
+| <a id="property-params"></a> `params`                   | `Record`\<`string`, `string`\> | [packages/play-actor/examples/shared/src/auth-machine.ts:30](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play-actor/examples/shared/src/auth-machine.ts#L30) |
+| <a id="property-query"></a> `query`                     | `Record`\<`string`, `string`\> | [packages/play-actor/examples/shared/src/auth-machine.ts:31](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play-actor/examples/shared/src/auth-machine.ts#L31) |
+| <a id="property-username"></a> `username`               | `string` \| `null`             | [packages/play-actor/examples/shared/src/auth-machine.ts:29](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play-actor/examples/shared/src/auth-machine.ts#L29) |

package/api/@xmachines/play-actor-shared/type-aliases/AuthActor.md

@@ -0,0 +1,27 @@
+[Documentation](../../../README.md) / [@xmachines/play-actor-shared](../README.md) / AuthActor
+
+# Type Alias: AuthActor
+
+```ts
+type AuthActor = PlayerActor<typeof authMachine>;
+```
+
+Defined in: [packages/play-actor/examples/shared/src/auth-machine.ts:293](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play-actor/examples/shared/src/auth-machine.ts#L293)
+
+The actor type for the auth machine.
+
+Import this in components and router adapters instead of `typeof authMachine`.
+Components declare their dependency on the capability contract (AuthContext +
+AuthEvents + routing/view signals) without coupling to the concrete machine
+implementation.
+
+## Example
+
+```ts
+import type { AuthActor } from "@xmachines/play-actor-shared";
+
+function HeaderNav({ actor }: { actor: AuthActor }) {
+	const snap = actor.getSnapshot();
+	snap.context.username; // typed as string | null — no cast needed
+}
+```

package/api/@xmachines/play-actor-shared/type-aliases/AuthCatalog.md

@@ -0,0 +1,16 @@
+[Documentation](../../../README.md) / [@xmachines/play-actor-shared](../README.md) / AuthCatalog
+
+# Type Alias: AuthCatalog
+
+```ts
+type AuthCatalog = typeof authCatalog;
+```
+
+Defined in: [packages/play-actor/examples/shared/src/catalog.ts:69](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play-actor/examples/shared/src/catalog.ts#L69)
+
+The type of the auth catalog — use as the `C` type param in `ComponentFn<AuthCatalog, "X">`,
+`ComponentContext<AuthCatalog, "X">`, and `defineRegistry(authCatalog, ...)`.
+
+Prefer this over `typeof authCatalog` at every call site: it's more readable,
+follows the PascalCase convention for types, and insulates components from
+the catalog's runtime representation.

package/api/@xmachines/play-actor-shared/type-aliases/AuthEvents.md

@@ -0,0 +1,17 @@
+[Documentation](../../../README.md) / [@xmachines/play-actor-shared](../README.md) / AuthEvents
+
+# Type Alias: AuthEvents
+
+```ts
+type AuthEvents =
+	| PlayRouteEvent
+	| {
+			type: "auth.login";
+			username: string;
+	  }
+	| {
+			type: "auth.logout";
+	  };
+```
+
+Defined in: [packages/play-actor/examples/shared/src/auth-machine.ts:36](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play-actor/examples/shared/src/auth-machine.ts#L36)

package/api/@xmachines/play-actor-shared/type-aliases/AuthInput.md

@@ -0,0 +1,9 @@
+[Documentation](../../../README.md) / [@xmachines/play-actor-shared](../README.md) / AuthInput
+
+# Type Alias: AuthInput
+
+```ts
+type AuthInput = Partial<AuthContext> | undefined;
+```
+
+Defined in: [packages/play-actor/examples/shared/src/auth-machine.ts:34](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play-actor/examples/shared/src/auth-machine.ts#L34)

package/api/@xmachines/play-actor-shared/type-aliases/AuthSnapshot.md

@@ -0,0 +1,11 @@
+[Documentation](../../../README.md) / [@xmachines/play-actor-shared](../README.md) / AuthSnapshot
+
+# Type Alias: AuthSnapshot
+
+```ts
+type AuthSnapshot = SnapshotFrom<typeof authMachine>;
+```
+
+Defined in: [packages/play-actor/examples/shared/src/auth-machine.ts:273](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play-actor/examples/shared/src/auth-machine.ts#L273)
+
+Snapshot type for the auth machine — use for typed `matches()` calls.