@xmachines/play-xstate 2.0.0-alpha.1 → 2.1.0

package/dist/player-actor.d.ts

@@ -1,28 +1,33 @@
-import { type AnyStateMachine, type Actor, type AnyActorLogic, type EmittedFrom, type InputFrom, type Observer, type Snapshot, type SnapshotFrom, type Subscription, type EventFromLogic } from "xstate";
+import { Actor, type AnyStateMachine, type AnyActorLogic, type EmittedFrom, type InputFrom, type ActorOptions, type Observer, type Snapshot, type SnapshotFrom, type Subscription, type EventFromLogic } from "xstate";
 import { AbstractActor, type Routable, type Viewable, type PlaySpec } from "@xmachines/play-actor";
 import { Signal } from "@xmachines/play-signals";
 import type { PlayerOptions } from "./types.js";
 /**
- * Concrete XState actor implementing Play Architecture signal protocol
+ * The concrete XState actor. It implements the signal protocol of the Play Architecture
  *
- * Extends {@link @xmachines/play-actor!AbstractActor} to provide XState v6 integration
- * while maintaining ecosystem compatibility (XState inspection, devtools). This actor
- * wraps an internal XState actor and exposes TC39 Signal-based reactive state for
- * Infrastructure observation.
+ * The class extends {@link @xmachines/play-actor!AbstractActor}, and therefore the
+ * `Actor` class of XState. It gives you the XState v5 integration, and it keeps the
+ * compatibility with the ecosystem, such as the XState inspection and the devtools.
+ * The constructor of the base class receives the machine. Therefore a `PlayerActor`
+ * **is** the XState actor, and it is no wrapper around one: every member of the
+ * XState `Actor` class works on the state of this instance, and this class adds the
+ * reactive state on the TC39 Signals for the observation by the infrastructure.
  *
- * **Capabilities:** Implements both {@link @xmachines/play-actor!Routable} and
- * {@link @xmachines/play-actor!Viewable} interfaces, providing routing and view
- * rendering support.
+ * **Capabilities:** the class implements both the
+ * {@link @xmachines/play-actor!Routable} interface and the
+ * {@link @xmachines/play-actor!Viewable} interface. It therefore supports the
+ * routing and the view rendering.
  *
- * **Architectural Context:** Implements **Actor Authority (INV-01)** by ensuring the
- * XState machine's guards control all navigation decisions. Infrastructure observes
- * the actor's signals (`state`, `currentRoute`, `currentView`) but cannot directly
- * manipulate state—all mutations flow through the state machine's event handlers.
+ * **Architectural context:** the class implements **Actor Authority (INV-01)**,
+ * because the guards of the XState machine control every decision of the
+ * navigation. The infrastructure observes the signals of the actor (`state`,
+ * `currentRoute`, and `currentView`), but it changes no state directly: every
+ * change goes through the event handlers of the state machine.
  *
- * @typeParam TMachine - XState v6 state machine type
+ * @typeParam TMachine - The type of the XState v5 state machine
  *
  * @example
- * Basic actor creation and lifecycle
+ * The creation of an actor, and its lifecycle
  * ```typescript
  * import { setup } from "xstate";
  * import { definePlayer } from "@xmachines/play-xstate";
@@ -31,7 +36,14 @@ import type { PlayerOptions } from "./types.js";
  *   initial: 'idle',
  *   states: {
  *     idle: {
- *       meta: { route: '/', view: { component: 'HomePage' } }
+ *       meta: {
+ *         route: '/',
+ *         // A view spec needs `root` and `elements`. Every other shape derives null.
+ *         view: {
+ *           root: 'home',
+ *           elements: { home: { type: 'HomePage', props: {}, children: [] } },
+ *         },
+ *       },
  *     }
  *   }
  * });
@@ -40,13 +52,13 @@ import type { PlayerOptions } from "./types.js";
  * const actor = createPlayer();
  * actor.start();
  *
- * // Observe signals
- * console.log(actor.currentRoute.get()); // '/'
- * console.log(actor.currentView.get());  // { component: 'HomePage' }
+ * // Observe the signals
+ * console.log(actor.currentRoute.get());          // '/'
+ * console.log(actor.currentView.get()?.root);     // 'home'
  * ```
  *
  * @example
- * Signal lifecycle with watchers
+ * The signal lifecycle with a watcher
  * ```typescript
  * import { Signal } from "@xmachines/play-signals";
  *
@@ -59,36 +71,86 @@ import type { PlayerOptions } from "./types.js";
  *
  * watcher.watch(actor.state);
  * actor.send({ type: 'play.route', to: '#about' });
- * // Watcher notification scheduled via microtask by the watcher itself
+ * // The watcher schedules its own notification in a microtask
  * ```
  *
  * @see [Play RFC](../../docs/rfc/play.md)
- * @see {@link definePlayer} for factory creation
- * @see {@link @xmachines/play-actor!AbstractActor} for signal protocol
- * @see {@link @xmachines/play-actor!Routable} for routing capability
- * @see {@link @xmachines/play-actor!Viewable} for view rendering capability
+ * @see {@link definePlayer} for the creation through a factory
+ * @see {@link @xmachines/play-actor!AbstractActor} for the signal protocol
+ * @see {@link @xmachines/play-actor!Routable} for the routing capability
+ * @see {@link @xmachines/play-actor!Viewable} for the view rendering capability
  *
  * @remarks
- * **Routing:** This actor supports both XState's `route: {}` config pattern
- * and `play.route` events with parameters. The `deriveRoute()` function checks
- * `meta.route` (Stately pattern) for URL templates with parameter substitution support.
+ * **The routing:** this actor supports the `route: {}` config pattern of XState and
+ * also a `play.route` event with parameters. The `deriveRoute()` function reads
+ * `meta.route`, which is the Stately pattern, for a URL template, and it substitutes
+ * each parameter.
  *
- * **View Signal Pattern:** The `currentView` signal is a direct `Signal.State` (not
- * `Signal.Computed`) to ensure proper watcher propagation in PlayRenderer. Views are
- * cached and updated at state entry, not computed on every read.
+ * **The pattern of the view signal:** the `currentView` signal is a direct
+ * `Signal.State`, and not a `Signal.Computed`. The propagation to a watcher in
+ * PlayRenderer is therefore correct. The class derives each view at the entry of a
+ * state and keeps it, and it computes no view on a read.
  */
 export declare class PlayerActor<TMachine extends AnyStateMachine> extends AbstractActor<AnyActorLogic, EventFromLogic<TMachine>> implements Routable, Viewable {
-    private xstateActor;
-    private playerOptions;
-    private viewSignal;
-    /** Last spec emitted on the view signal — used to skip no-change re-emissions. */
-    private lastEmittedView;
-    state: Signal.State<SnapshotFrom<TMachine>>;
+    private playerOptions?;
     /**
-     * Returns whether the actor's current state can accept the given event.
+     * Tells you if this constructor returned already.
      *
-     * Typed to the machine's event union — passing an unknown event type is a
-     * compile error. Delegates to the underlying XState actor's snapshot.
+     * XState gives the actor to a context factory as `self`, and to an `inspect`
+     * observer as `actorRef`, from inside its own constructor. No field of this class
+     * exists at that moment, and XState itself refuses to read the snapshot there:
+     * "Snapshot can't be read while the actor initializes itself". Therefore each thing
+     * that the code can reach from that window must test this field first.
+     */
+    private constructed?;
+    /**
+     * The live options object of the caller, or an empty object during the construction.
+     *
+     * XState gives this actor to a context factory as `self`, and to an `inspect`
+     * observer as `actorRef`, from inside its own constructor, before the code assigns
+     * any field here. A read of a hook through this accessor therefore does not throw
+     * in that window. A throw goes to the initialization of XState, which parks it as
+     * an error snapshot. The accessor also keeps the behavior that the documentation of
+     * the object promises: a read at the moment of the delivery.
+     *
+     * The fields below that this window touches have a `declare` modifier for the same
+     * reason. This target compiles a class field into `Object.defineProperty`, which
+     * runs after `super()` returns. A plain declaration, with an initializer or without
+     * one, therefore resets each value of the window to `undefined`. A `declare`
+     * modifier emits nothing, and those values survive.
+     */
+    private get hooks();
+    /**
+     * The record of the real lifecycle transitions, so that onStart and onStop each
+     * fire one time. The status of XState is internal, and a machine snapshot reads
+     * "active" before start() already. Therefore neither of them can separate an actor
+     * that did not start yet from an actor that runs.
+     */
+    private lifecycle?;
+    /**
+     * The subscriptions of the user code without an error listener. The dispatch of
+     * XState throws an actor error again, globally, for them. It does this one time for
+     * each delivery, with a shared flag. Therefore the loud default of the internal
+     * error listener, which also throws again, must stand down while such a
+     * subscription is active. Without this rule, the code reports the same error two
+     * times.
+     */
+    private nextOnlySubscriptions?;
+    /**
+     * The last snapshot of the view pipeline. XState notifies each observer on EVERY
+     * event that it processes, and an event that it ignores delivers the identical
+     * snapshot again. deriveCurrentView is pure in the snapshot. Therefore an identical
+     * reference can change no result. The first value is undefined, and never a
+     * snapshot: the snapshot of the construction has the same reference as the snapshot
+     * that start() replays, and that value therefore stops the first view.
+     */
+    private lastViewSnapshot;
+    state: Signal.State<ReturnType<TMachine["transition"]>>;
+    /**
+     * Tells you if the current state of the actor accepts the given event.
+     *
+     * The type is the event union of the machine. An unknown event type is therefore a
+     * compile error. The method evaluates the event against the snapshot signal.
      *
      * @example
      * ```typescript
@@ -97,152 +159,174 @@ export declare class PlayerActor<TMachine extends AnyStateMachine> extends Abstr
      */
     can(event: EventFromLogic<TMachine>): boolean;
     /**
-     * A TC39 `Signal.Computed` that derives the current URL path from the active
-     * machine state's `meta.route` template and the actor's context.
+     * A TC39 `Signal.Computed`. It derives the current URL path from the `meta.route`
+     * template of the active machine state and from the context of the actor.
      *
-     * Returns `null` when the current state has no `meta.route`, or when the route
-     * template cannot be fully resolved (e.g. a required parameter is absent from
-     * context).
-     *
-     * @throws {MissingRouteParamError} When a required `:param` placeholder in the
-     *   route template has no matching value in the actor's context. Import the class
-     *   from `@xmachines/play-xstate/errors`.
+     * It returns `null` when the current state has no `meta.route` field, and also when
+     * it cannot resolve the complete route template. A necessary `:param` that the
+     * context does not hold is caught inside the signal, and a
+     * `MissingRouteParamError` therefore never leaves `get()`: that condition is
+     * temporary during a transition, and the signal computes the value again on the next
+     * snapshot.
      *
      * @example
      * ```typescript
-     * // Returns "/profile/alice" when context.userId === "alice"
+     * // It returns "/profile/alice" when context.params.userId === "alice",
+     * // and null while the param is still absent.
      * const route = actor.currentRoute.get();
      * ```
      */
     currentRoute: Signal.Computed<string | null>;
     /**
-     * The route derived from the machine's initial state — fixed at construction,
-     * never changes even when the actor is restored from a snapshot.
+     * The route of the initial state of the machine. The constructor fixes it, and it
+     * never changes, also when the code restores the actor from a snapshot.
      *
-     * Router bridges compare this against the browser URL to distinguish a deep-link
-     * (non-initial URL → router wins) from a restore (initial URL + actor at a
-     * different restored route → actor wins).
+     * A router bridge compares it with the browser URL, and it therefore separates a
+     * deep link (a URL that is not the initial one → the router wins) from a restore
+     * (the initial URL, and the actor at a different route from the restore → the actor
+     * wins).
      *
-     * Derived statically from the machine definition via `deriveInitialRoute`
-     * (XState's pure `initialTransition` helper): the initial state chain and its
-     * `meta.route` templates are fixed at machine definition time, while `:param`
-     * substitution uses the machine's real initial context for this actor's `input`.
-     * No extra actor is ever created, and a restored snapshot never influences the
-     * value — it is always the machine's **default** initial route.
+     * `deriveInitialRoute` derives the value statically from the machine definition,
+     * with the pure `initialTransition` helper of XState: the chain of the initial states
+     * and their `meta.route` templates are fixed at the moment of the machine
+     * definition, and the substitution of a `:param` uses the real initial context of
+     * the machine for the `input` of this actor. The code makes no second actor, and a
+     * snapshot of a restore changes the value never: it is always the **default**
+     * initial route of the machine.
      */
     readonly initialRoute: string | null;
     /**
-     * Reactive signal containing the current view spec derived from the active state's
-     * `meta.view` metadata.
+     * The reactive signal of the current view spec. The signal derives the spec from
+     * the `meta.view` metadata of the active state.
+     *
+     * It emits a **new object reference** on each real change of the view on the
+     * screen: the view of a different state, or a change of a param or of the context
+     * that changes the resolved spec. A re-entry with `reenter: true` and new params
+     * also changes the spec. A snapshot that changes no view on the screen, such as an
+     * assign of the context alone, keeps the previous reference. A provider below the
+     * signal therefore mounts the UI again not on every event.
      *
-     * Emits a **fresh object reference** whenever the rendered view actually changes —
-     * a different state's view, or a param/context change that alters the resolved
-     * spec (including `reenter: true` re-entries with new params). Snapshots that do
-     * not change the rendered view (e.g. context-only assigns) keep the previous
-     * reference so downstream providers do not remount the UI on every event.
+     * The `PlaySpec` of the emission carries the context of the machine in its composed
+     * `state` field, under the read-only `/context` subtree. A spec therefore reads the
+     * context, and also each URL param, through the ordinary state grammar
+     * (`{ $state: "/context/params/section" }`). The context-projection module of
+     * `@xmachines/play-actor` holds the complete contract.
      *
-     * The emitted `PlaySpec` has its element `props` enriched with `context.params`
-     * before emission — URL path parameters (e.g. `:section?`) flow into component props
-     * automatically. See `mergeRouteParamsIntoProps` for the merge priority rules.
+     * The signal returns `null` when the current state has no `meta.view` metadata.
      *
-     * Returns `null` when the current state has no `meta.view` metadata.
+     * Two states can declare two separate `meta.view` literals with an identical
+     * structure. A transition between those two states then emits two different
+     * references, and a provider mounts the UI again. Move the shared literal into one
+     * `typedSpec` constant, and the identity then removes the duplicate.
      *
      * @example
      * ```typescript
      * const view = actor.currentView.get();
      * if (view) {
-     *   console.log(view.root);     // e.g. "root"
-     *   console.log(view.elements); // @xmachines/json-render-core Spec elements
+     *   console.log(view.root);     // for example "root"
+     *   console.log(view.elements); // the Spec elements of @xmachines/json-render-core
      * }
      * ```
      */
-    currentView: Signal.State<PlaySpec | null>;
-    constructor(machine: TMachine, options: PlayerOptions<TMachine>, input?: InputFrom<TMachine>, restoredSnapshot?: SnapshotFrom<TMachine>);
+    readonly currentView: Signal.State<PlaySpec | null>;
+    constructor(machine: TMachine, options: PlayerOptions<TMachine>, input?: InputFrom<TMachine>, restoredSnapshot?: ActorOptions<TMachine>["snapshot"]);
     /**
-     * Start the actor
+     * Starts the actor.
      *
-     * Per RESEARCH.md Pitfall 1: Always call start() after creation
+     * The method fires `onStart` on each real start, which is every transition from
+     * "not running" to "running". A start after a stop is such a transition, and XState
+     * permits it: its own `start()` stops only while the actor RUNS already. A second
+     * call while the actor runs fires no hook. Therefore a defensive double mount runs
+     * the side effects of `onStart` one time for one real start.
      */
     start(): this;
     /**
-     * Stop the actor and cleanup
+     * Stops the actor and cleans up.
+     *
+     * The method fires `onStop` only when the actor ran. This matches XState, where a
+     * stop of an actor that never started, or of an actor that stopped already, does
+     * nothing and tears nothing down. Therefore the paired cleanup runs never two
+     * times, and it runs never against a resource that `onStart` did not take. A stop
+     * does not close the actor for ever: a later `start()` is a new lifecycle, and it
+     * fires `onStart` again.
      */
     stop(): this;
     /**
-     * Send an event to the underlying XState actor.
+     * Sends an event to this actor.
      *
-     * The actor's state machine guards decide whether the event causes a transition.
-     * Pass any event from the machine's event union — domain events, routing events, etc.
+     * The guards of the state machine of the actor decide if the event causes a
+     * transition. Give any event of the event union of the machine: a domain event, a
+     * routing event, and so on.
      *
-     * @param event - An event from the machine's `EventFromLogic<TMachine>` union.
+     * @param event - An event of the `EventFromLogic<TMachine>` union of the machine.
      *
-     * @throws {InvalidEventError} When `event` is not a plain object (`null`, `undefined`,
-     *   a string, number, etc.). Import the class from `@xmachines/play-xstate/errors`.
+     * @throws {InvalidEventError} When `event` is not a plain object, for example
+     *   `null`, `undefined`, a string, or a number. Import the class from
+     *   `@xmachines/play-xstate/errors`.
      *
      * @example
      * ```typescript
-     * // Domain event (typed to machine's event union)
+     * // A domain event, with the type of the event union of the machine
      * actor.send({ type: "auth.login", userId: "123" });
      *
-     * // Routing event
+     * // A routing event
      * actor.send({ type: "play.route", to: "#home" });
      * ```
      */
     send(event: EventFromLogic<TMachine>): void;
     /**
-     * Get current snapshot
+     * Returns the current snapshot
      */
     getSnapshot(): ReturnType<Actor<TMachine>["getSnapshot"]>;
     /**
-     * Subscribe to snapshot updates from the wrapped XState actor.
+     * Subscribes to the snapshot updates of this actor.
      *
-     * Accepts an observer object, exactly like XState's `Actor.subscribe`.
+     * The method accepts an observer object, exactly like `Actor.subscribe` of XState.
      *
-     * @param observer - Observer with `next`/`error`/`complete` handlers.
-     * @returns Subscription with an `unsubscribe()` method.
+     * @param observer - The observer, with a `next`, an `error`, and a `complete` handler.
+     * @returns The subscription, with an `unsubscribe()` method.
      */
     subscribe(observer: Observer<SnapshotFrom<TMachine>>): Subscription;
     /**
-     * Subscribe to snapshot updates from the wrapped XState actor.
+     * Subscribes to the snapshot updates of this actor.
      *
-     * Accepts listener functions, exactly like XState's `Actor.subscribe`.
+     * The method accepts listener functions, exactly like `Actor.subscribe` of XState.
      *
-     * @param nextListener - Snapshot listener function.
-     * @param errorListener - Called when the actor errors.
-     * @param completeListener - Called when the actor completes (reaches a final state).
-     * @returns Subscription with an `unsubscribe()` method.
+     * @param nextListener - The listener function of each snapshot.
+     * @param errorListener - The actor calls it on an error.
+     * @param completeListener - The actor calls it when it completes, which means that it reaches a final state.
+     * @returns The subscription, with an `unsubscribe()` method.
      */
     subscribe(nextListener?: (snapshot: SnapshotFrom<TMachine>) => void, errorListener?: (error: unknown) => void, completeListener?: () => void): Subscription;
     /**
-     * Listen for events emitted by the wrapped XState actor via the `emit` action.
+     * Listens for the events that this actor emits with the `emit` action.
      *
-     * @param type - Emitted event type to listen for, or `"*"` for all.
-     * @param handler - Called with each matching emitted event.
-     * @returns Subscription with an `unsubscribe()` method.
+     * @param type - The type of the emitted event to listen for, or `"*"` for every event.
+     * @param handler - The actor calls it with each emitted event that matches.
+     * @returns The subscription, with an `unsubscribe()` method.
      */
     on<TType extends EmittedFrom<TMachine>["type"] | "*">(type: TType, handler: (emitted: EmittedFrom<TMachine> & (TType extends "*" ? unknown : {
         type: TType;
     })) => void): Subscription;
     /**
-     * Get the persisted snapshot of the wrapped XState actor.
+     * Returns the persisted snapshot of this actor.
      *
-     * Suitable for serialization and later restoration via the factory's
-     * `restore.snapshot` option.
+     * Use it to serialize the state, and to restore it later with the
+     * `restore.snapshot` option of the factory.
      */
-    getPersistedSnapshot(): Snapshot<unknown>;
+    getPersistedSnapshot(options?: unknown): Snapshot<unknown>;
     /**
-     * Validate view at state entry and cache result
-     *
-     * Per CONTEXT.md: "Prop validation: At state entry (when state becomes active)"
-     * Validates once per transition and stores result in signal.
+     * Derives the view at the entry of a state, and keeps it. This happens one time for
+     * each transition. The signal holds the view, and the code computes it not on each
+     * read.
      *
-     * @param snapshot - Current XState snapshot
+     * @param snapshot - The current XState snapshot
      */
     private validateAndCacheView;
     /**
-     * Convenience dispose method for cleanup
+     * The dispose method, for the cleanup. It is the alias of {@link stop}.
      *
-     * Per CONTEXT.md: "Both .dispose() convenience method and manual machine.stop()"
+     * @deprecated Use {@link stop}. Will be removed in the next major.
      */
     dispose(): void;
 }

package/dist/player-actor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"player-actor.d.ts","sourceRoot":"","sources":["../src/player-actor.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"player-actor.d.ts","sourceRoot":"","sources":["../src/player-actor.ts"],"names":[],"mappings":"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"}