@xmachines/play-xstate 2.2.0 → 4.0.0

package/dist/routing/types.d.ts

@@ -1,8 +1,12 @@
-export interface RouteObject {
-    path: string;
-    [key: string]: unknown;
-}
-export type RouteMetadata = string | RouteObject;
+/**
+ * `RouteObject` and `RouteMetadata` have ONE definition, and it lives in
+ * `@xmachines/play-router`. That package owns the routing protocol, and this package
+ * consumes it. A second definition here would be a copy that drifts: a field added to
+ * one of them would leave the other behind, and nothing would fail.
+ *
+ * The re-export keeps the import path of every consumer of this package unchanged.
+ */
+export type { RouteObject, RouteMetadata, RouteData, RouteDataResolver, } from "@xmachines/play-router";
 /**
  * The context of the route construction, from the machine context.
  *

package/dist/routing/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/routing/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACvB;AAED,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,WAAW,CAAC;AAEjD;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,YAAY;IAC5B,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4FAA4F;IAC5F,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,2BAA2B;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,wBAAwB;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;CACd"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/routing/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,YAAY,EACX,WAAW,EACX,aAAa,EACb,SAAS,EACT,iBAAiB,GACjB,MAAM,wBAAwB,CAAC;AAEhC;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,YAAY;IAC5B,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4FAA4F;IAC5F,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,2BAA2B;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,wBAAwB;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;CACd"}

package/dist/state-meta.d.ts

@@ -0,0 +1,52 @@
+/**
+ * The read of the `meta` of the active states, which BOTH capabilities share.
+ *
+ * `deriveCurrentRoute` folds this record into a URL, and `deriveCurrentView` folds the
+ * same record into a view spec. The two therefore cannot move apart on the selection of
+ * the branch, and they cannot move apart on their tolerance of a degenerate snapshot.
+ *
+ * It lives in its own module, and no longer beside the route derivation, because it
+ * belongs to neither capability. `@xmachines/play-xstate/view` imported it from
+ * `routing/derive-current-route.ts`, and that module reads `deriveRoute`, which names
+ * `@xmachines/play-router`. A view-only application therefore loaded the whole route
+ * derivation, and the OPTIONAL peer of the routing reached the runtime graph of the view
+ * entry point.
+ */
+import type { AnyMachineSnapshot } from "xstate";
+/**
+ * Collects the `meta` object of the active state nodes of a SINGLE branch, from the
+ * root to a leaf. The key of each entry is the state id, and the order is the
+ * ancestors first. {@link deriveRoute} folds this shape.
+ *
+ * `snapshot.getMeta()` returns a FLAT record of the meta object of every active
+ * state. For a machine that is not parallel, that record is one chain of ancestors
+ * already. For a PARALLEL machine, it mixes the entries of every active region. A
+ * blind fold therefore joins a relative route of one region to an absolute route of
+ * a sibling region, and the URL belongs to the tree of neither region. The flat
+ * record also cannot go back into a hierarchy: when a state declares an explicit
+ * `id`, for example a child with `id: "dashboard-overview"` under `id: "dashboard"`,
+ * the meta keys are those ids, and they carry no information about the ancestry.
+ *
+ * Therefore this function walks `snapshot.value`, which holds the real hierarchy of
+ * the active states by the state key, against the node tree of the machine. It
+ * follows the FIRST active child at each level. This gives one deterministic branch,
+ * which matches the historical behavior of "the first that it finds" for a parallel
+ * machine. It also works with an explicit id, because each node carries its own `id`
+ * and its own `meta`.
+ *
+ * The function returns `null` when the snapshot exposes no machine and no value to
+ * walk. This is a defensive measure, because a real XState snapshot always exposes
+ * them. The caller then uses `getMeta()`, as before.
+ */
+export declare const firstActiveBranchMeta: (snapshot: AnyMachineSnapshot) => Record<string, unknown> | null;
+/**
+ * Resolves the meta record that the route derivation and the view derivation fold:
+ * the single active branch that {@link firstActiveBranchMeta} walks, which is
+ * correct for a parallel machine and for an explicit id, or the flat `getMeta()`
+ * record when the snapshot has no machine tree to walk. `deriveCurrentRoute` and
+ * `deriveCurrentView` share this function. Therefore the two sides cannot move apart
+ * on the selection of the branch, and they cannot move apart on their tolerance of a
+ * degenerate snapshot.
+ */
+export declare const activeStateMeta: (snapshot: AnyMachineSnapshot) => Record<string, unknown> | null;
+//# sourceMappingURL=state-meta.d.ts.map

package/dist/state-meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-meta.d.ts","sourceRoot":"","sources":["../src/state-meta.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAC;AAEjD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,qBAAqB,GACjC,UAAU,kBAAkB,KAC1B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAqC5B,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,eAAe,GAAI,UAAU,kBAAkB,KAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAMxF,CAAC"}

package/dist/state-meta.js

@@ -0,0 +1,77 @@
+/**
+ * Collects the `meta` object of the active state nodes of a SINGLE branch, from the
+ * root to a leaf. The key of each entry is the state id, and the order is the
+ * ancestors first. {@link deriveRoute} folds this shape.
+ *
+ * `snapshot.getMeta()` returns a FLAT record of the meta object of every active
+ * state. For a machine that is not parallel, that record is one chain of ancestors
+ * already. For a PARALLEL machine, it mixes the entries of every active region. A
+ * blind fold therefore joins a relative route of one region to an absolute route of
+ * a sibling region, and the URL belongs to the tree of neither region. The flat
+ * record also cannot go back into a hierarchy: when a state declares an explicit
+ * `id`, for example a child with `id: "dashboard-overview"` under `id: "dashboard"`,
+ * the meta keys are those ids, and they carry no information about the ancestry.
+ *
+ * Therefore this function walks `snapshot.value`, which holds the real hierarchy of
+ * the active states by the state key, against the node tree of the machine. It
+ * follows the FIRST active child at each level. This gives one deterministic branch,
+ * which matches the historical behavior of "the first that it finds" for a parallel
+ * machine. It also works with an explicit id, because each node carries its own `id`
+ * and its own `meta`.
+ *
+ * The function returns `null` when the snapshot exposes no machine and no value to
+ * walk. This is a defensive measure, because a real XState snapshot always exposes
+ * them. The caller then uses `getMeta()`, as before.
+ */
+export const firstActiveBranchMeta = (snapshot) => {
+    const root = snapshot.machine?.root;
+    if (!root)
+        return null;
+    const ordered = {};
+    let node = root;
+    let value = snapshot.value;
+    while (node) {
+        if (node.meta && typeof node.meta === "object") {
+            ordered[node.id] = node.meta; // nosemgrep: gitlab.eslint.detect-object-injection
+        }
+        // Find the key of the active child at this level. A string value is the name of an
+        // atomic active leaf. An object value is a compound node, with one key, or a
+        // parallel node, with many keys: take the first key, for one deterministic
+        // branch.
+        let key;
+        if (typeof value === "string") {
+            key = value;
+        }
+        else if (value && typeof value === "object") {
+            key = Object.keys(value)[0];
+        }
+        if (key === undefined)
+            break;
+        const child = node.states?.[key]; // nosemgrep: gitlab.eslint.detect-object-injection
+        if (!child)
+            break;
+        value =
+            typeof value === "object" && value !== null
+                ? value[key] // nosemgrep: gitlab.eslint.detect-object-injection
+                : {};
+        node = child;
+    }
+    return ordered;
+};
+/**
+ * Resolves the meta record that the route derivation and the view derivation fold:
+ * the single active branch that {@link firstActiveBranchMeta} walks, which is
+ * correct for a parallel machine and for an explicit id, or the flat `getMeta()`
+ * record when the snapshot has no machine tree to walk. `deriveCurrentRoute` and
+ * `deriveCurrentView` share this function. Therefore the two sides cannot move apart
+ * on the selection of the branch, and they cannot move apart on their tolerance of a
+ * degenerate snapshot.
+ */
+export const activeStateMeta = (snapshot) => {
+    if (!snapshot || typeof snapshot.getMeta !== "function") {
+        return null;
+    }
+    const meta = firstActiveBranchMeta(snapshot) ?? snapshot.getMeta();
+    return meta && typeof meta === "object" ? meta : null;
+};
+//# sourceMappingURL=state-meta.js.map

package/dist/state-meta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-meta.js","sourceRoot":"","sources":["../src/state-meta.ts"],"names":[],"mappings":"AAgBA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CACpC,QAA4B,EACK,EAAE;IACnC,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,EAAE,IAEnB,CAAC;IACb,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IAEvB,MAAM,OAAO,GAA4B,EAAE,CAAC;IAC5C,IAAI,IAAI,GAA4B,IAAI,CAAC;IACzC,IAAI,KAAK,GAAY,QAAQ,CAAC,KAAK,CAAC;IAEpC,OAAO,IAAI,EAAE,CAAC;QACb,IAAI,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAChD,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,mDAAmD;QAClF,CAAC;QAED,mFAAmF;QACnF,6EAA6E;QAC7E,2EAA2E;QAC3E,UAAU;QACV,IAAI,GAAuB,CAAC;QAC5B,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC/B,GAAG,GAAG,KAAK,CAAC;QACb,CAAC;aAAM,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC/C,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7B,CAAC;QACD,IAAI,GAAG,KAAK,SAAS;YAAE,MAAM;QAE7B,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,GAAG,CAA4B,CAAC,CAAC,mDAAmD;QAChH,IAAI,CAAC,KAAK;YAAE,MAAM;QAClB,KAAK;YACJ,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;gBAC1C,CAAC,CAAE,KAAiC,CAAC,GAAG,CAAC,CAAC,mDAAmD;gBAC7F,CAAC,CAAC,EAAE,CAAC;QACP,IAAI,GAAG,KAAK,CAAC;IACd,CAAC;IAED,OAAO,OAAO,CAAC;AAChB,CAAC,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,QAA4B,EAAkC,EAAE;IAC/F,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;QACzD,OAAO,IAAI,CAAC;IACb,CAAC;IACD,MAAM,IAAI,GAAG,qBAAqB,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;IACnE,OAAO,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAE,IAAgC,CAAC,CAAC,CAAC,IAAI,CAAC;AACpF,CAAC,CAAC"}

package/dist/types.d.ts

@@ -1,13 +1,28 @@
 import type { ActorOptions, AnyStateMachine, InputFrom, SnapshotFrom } from "xstate";
 import type { PlayerActor as PlayerActorClass } from "./player-actor.js";
+import type { PlayerConstructor } from "./capabilities.js";
 /**
  * The configuration of definePlayer()
  */
-export interface PlayerConfig<TMachine extends AnyStateMachine> {
+export interface PlayerConfig<TMachine extends AnyStateMachine, TCapabilities extends object = object> {
     /** The XState v5 state machine */
     machine: TMachine;
     /** The lifecycle hooks and the configuration */
     options?: PlayerOptions<TMachine>;
+    /**
+     * The actor class to build, which decides which CAPABILITIES the actor carries.
+     *
+     * `PlayerActor` is the default, and it holds `state` and `send` alone. Compose a class
+     * to add a capability, and the factory then answers an actor with it:
+     *
+     * ```typescript
+     * definePlayer({ machine, actor: compose(PlayerActor, withRouting, withView) });
+     * ```
+     *
+     * An application that declares no route, and renders no view, passes nothing and loads
+     * neither body of code.
+     */
+    actor?: PlayerConstructor<TMachine, TCapabilities>;
 }
 /**
  * The lifecycle hooks of the player — the observability surface around the actor.
@@ -21,7 +36,7 @@ export interface PlayerOptions<TMachine extends AnyStateMachine> {
     onStart?: (actor: PlayerActorClass<TMachine>) => void;
     /**
      * The actor calls it on each real stop, which means only after it tore a running
-     * actor down. A second `stop()` call, a second `dispose()` call, and a stop of an
+     * actor down. A second `stop()` call, and a stop of an
      * actor that never started fire the hook not.
      */
     onStop?: (actor: PlayerActorClass<TMachine>) => void;
@@ -118,5 +133,5 @@ export interface PlayerFactoryResumeOptions<TMachine extends AnyStateMachine> {
  * An absent input is then a compile error, and not an actor that starts in an error
  * status with a `null` initial route.
  */
-export type PlayerFactory<TMachine extends AnyStateMachine> = undefined extends InputFrom<TMachine> ? (input?: InputFrom<TMachine>, options?: PlayerFactoryResumeOptions<TMachine>) => PlayerActorClass<TMachine> : (input: InputFrom<TMachine>, options?: PlayerFactoryResumeOptions<TMachine>) => PlayerActorClass<TMachine>;
+export type PlayerFactory<TMachine extends AnyStateMachine, TCapabilities extends object = object> = undefined extends InputFrom<TMachine> ? (input?: InputFrom<TMachine>, options?: PlayerFactoryResumeOptions<TMachine>) => PlayerActorClass<TMachine> & TCapabilities : (input: InputFrom<TMachine>, options?: PlayerFactoryResumeOptions<TMachine>) => PlayerActorClass<TMachine> & TCapabilities;
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACrF,OAAO,KAAK,EAAE,WAAW,IAAI,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAEzE;;GAEG;AACH,MAAM,WAAW,YAAY,CAAC,QAAQ,SAAS,eAAe;IAC7D,kCAAkC;IAClC,OAAO,EAAE,QAAQ,CAAC;IAElB,gDAAgD;IAChD,OAAO,CAAC,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa,CAAC,QAAQ,SAAS,eAAe;IAC9D;;;;OAIG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC;IAEtD;;;;OAIG;IACH,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC;IAErD;;;;;OAKG;IACH,YAAY,CAAC,EAAE,CACd,KAAK,EAAE,gBAAgB,CAAC,QAAQ,CAAC,EACjC,SAAS,EAAE,YAAY,CAAC,QAAQ,CAAC,EACjC,SAAS,EAAE,YAAY,CAAC,QAAQ,CAAC,KAC7B,IAAI,CAAC;IAEV,uDAAuD;IACvD,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,YAAY,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC;IAE3F;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAEpE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAgCG;IACH,OAAO,CAAC,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,CAAC;CAC5C;AAED;;;;;GAKG;AACH,MAAM,WAAW,0BAA0B,CAAC,QAAQ,SAAS,eAAe;IAC3E;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAC,UAAU,CAAC,CAAC;CAC9C;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,aAAa,CAAC,QAAQ,SAAS,eAAe,IACzD,SAAS,SAAS,SAAS,CAAC,QAAQ,CAAC,GAClC,CACA,KAAK,CAAC,EAAE,SAAS,CAAC,QAAQ,CAAC,EAC3B,OAAO,CAAC,EAAE,0BAA0B,CAAC,QAAQ,CAAC,KAC1C,gBAAgB,CAAC,QAAQ,CAAC,GAC9B,CACA,KAAK,EAAE,SAAS,CAAC,QAAQ,CAAC,EAC1B,OAAO,CAAC,EAAE,0BAA0B,CAAC,QAAQ,CAAC,KAC1C,gBAAgB,CAAC,QAAQ,CAAC,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACrF,OAAO,KAAK,EAAE,WAAW,IAAI,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE3D;;GAEG;AACH,MAAM,WAAW,YAAY,CAC5B,QAAQ,SAAS,eAAe,EAChC,aAAa,SAAS,MAAM,GAAG,MAAM;IAErC,kCAAkC;IAClC,OAAO,EAAE,QAAQ,CAAC;IAElB,gDAAgD;IAChD,OAAO,CAAC,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;IAElC;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,EAAE,iBAAiB,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;CACnD;AAED;;GAEG;AACH,MAAM,WAAW,aAAa,CAAC,QAAQ,SAAS,eAAe;IAC9D;;;;OAIG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC;IAEtD;;;;OAIG;IACH,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC;IAErD;;;;;OAKG;IACH,YAAY,CAAC,EAAE,CACd,KAAK,EAAE,gBAAgB,CAAC,QAAQ,CAAC,EACjC,SAAS,EAAE,YAAY,CAAC,QAAQ,CAAC,EACjC,SAAS,EAAE,YAAY,CAAC,QAAQ,CAAC,KAC7B,IAAI,CAAC;IAEV,uDAAuD;IACvD,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,YAAY,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC;IAE3F;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAEpE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAgCG;IACH,OAAO,CAAC,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,CAAC;CAC5C;AAED;;;;;GAKG;AACH,MAAM,WAAW,0BAA0B,CAAC,QAAQ,SAAS,eAAe;IAC3E;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAC,UAAU,CAAC,CAAC;CAC9C;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,aAAa,CAAC,QAAQ,SAAS,eAAe,EAAE,aAAa,SAAS,MAAM,GAAG,MAAM,IAChG,SAAS,SAAS,SAAS,CAAC,QAAQ,CAAC,GAClC,CACA,KAAK,CAAC,EAAE,SAAS,CAAC,QAAQ,CAAC,EAC3B,OAAO,CAAC,EAAE,0BAA0B,CAAC,QAAQ,CAAC,KAC1C,gBAAgB,CAAC,QAAQ,CAAC,GAAG,aAAa,GAC9C,CACA,KAAK,EAAE,SAAS,CAAC,QAAQ,CAAC,EAC1B,OAAO,CAAC,EAAE,0BAA0B,CAAC,QAAQ,CAAC,KAC1C,gBAAgB,CAAC,QAAQ,CAAC,GAAG,aAAa,CAAC"}

package/dist/view/derive-current-view.d.ts

@@ -7,7 +7,7 @@
  * machine always belongs to the region of its URL.
  */
 import type { AnyMachineSnapshot } from "xstate";
-import { type PlaySpec } from "@xmachines/play-actor";
+import { type PlaySpec } from "@xmachines/play-view";
 /**
  * Derives the current view of the actor from the state metadata.
  *

package/dist/view/derive-current-view.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"derive-current-view.d.ts","sourceRoot":"","sources":["../../src/view/derive-current-view.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAC;AACjD,OAAO,EAAiC,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAwDrF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,eAAO,MAAM,iBAAiB,GAAI,UAAU,kBAAkB,KAAG,QAAQ,GAAG,IA4C3E,CAAC"}
+{"version":3,"file":"derive-current-view.d.ts","sourceRoot":"","sources":["../../src/view/derive-current-view.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAC;AACjD,OAAO,EAAiC,KAAK,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAyEpF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,eAAO,MAAM,iBAAiB,GAAI,UAAU,kBAAkB,KAAG,QAAQ,GAAG,IA4C3E,CAAC"}

package/dist/view/derive-current-view.js

@@ -1,5 +1,5 @@
-import { composePlayState, toAtomState } from "@xmachines/play-actor";
-import { activeStateMeta } from "../routing/index.js";
+import { composePlayState, toAtomState } from "@xmachines/play-view";
+import { activeStateMeta } from "../state-meta.js";
 /**
  * The migration warning of the `contextProps` field, which 1.x removed. The code
  * writes it one time for each spec. A meta.view object from a person passes around
@@ -17,22 +17,40 @@ const warnRemovedContextProps = (viewMeta) => {
     console.warn("[play-xstate] meta.view.contextProps has been removed: the whole machine context " +
         "is always projected under /context. Delete the field — it no longer filters anything.");
 };
+/** Reads the `view` of one meta entry, when the entry holds a whole PlaySpec. */
+const viewOfEntry = (stateMeta) => {
+    const maybeView = stateMeta && typeof stateMeta === "object"
+        ? stateMeta.view
+        : undefined;
+    return maybeView &&
+        typeof maybeView === "object" &&
+        "root" in maybeView &&
+        "elements" in maybeView
+        ? maybeView
+        : null;
+};
 const resolveViewMeta = (meta) => {
-    // Walk from the last entry to the first: snapshot.getMeta() puts the keys of the
-    // ancestors first. A scan from the end therefore lets the meta.view of the deepest
-    // active state win, and an ancestor hides it not.
-    const entries = Object.entries(meta);
-    for (let i = entries.length - 1; i >= 0; i--) {
-        // The array index has the bound of the loop. No user controls this property access.
-        const [key, stateMeta] = entries[i]; // nosemgrep: gitlab.eslint.detect-object-injection
-        const maybeView = stateMeta && typeof stateMeta === "object"
-            ? stateMeta.view
-            : undefined;
-        if (maybeView &&
-            typeof maybeView === "object" &&
-            "root" in maybeView &&
-            "elements" in maybeView) {
-            return { key, view: maybeView };
+    // Take the LAST entry that holds a view, and not the first: snapshot.getMeta() puts
+    // the keys of the ancestors first, so the last match is the meta.view of the deepest
+    // active state. An ancestor hides it not.
+    //
+    // A walk from the end, and not a findLast or a mapped copy: this runs for each
+    // snapshot. The walk stops at the first match, and `viewOfEntry` runs one time for
+    // each entry that it visits — a `findLast` would run it a second time on the entry
+    // that its own predicate had already resolved, and a `map()` would visit every entry
+    // and allocate one object for each match before the search began.
+    //
+    // `toReversed()`, which copies, and not `reverse()`, which mutates: one spelling for
+    // one operation, beside the `toSorted()` that `unicorn/no-array-sort` asks for.
+    //
+    // The copy costs about 10 ns for the handful of entries that a state path holds, and
+    // `Object.entries` above it costs twenty times that. Measured, after a review called
+    // this line a cost of a hot path: it is not one, at any rate of snapshots that an
+    // actor produces.
+    for (const [key, stateMeta] of Object.entries(meta).toReversed()) {
+        const view = viewOfEntry(stateMeta);
+        if (view) {
+            return { key, view };
         }
     }
     return null;

package/dist/view/derive-current-view.js.map

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

package/dist/with-routing.d.ts

@@ -0,0 +1,45 @@
+/**
+ * The routing capability of an XState actor, as a mixin.
+ *
+ * `PlayerActor` holds `state` and `send`, and nothing about a route. This module adds
+ * `currentRoute` and `initialRoute`, which is what `Routable` of `@xmachines/play-router`
+ * asks for and what every router bridge reads.
+ *
+ * It is a SEPARATE entry point, `@xmachines/play-xstate/routing`, and the core imports it
+ * never. `@xmachines/play-router` is an OPTIONAL peer of this package for the same reason:
+ * an application that declares no route installs neither that package nor the route map
+ * and the bridge that it carries.
+ *
+ * @example
+ * ```typescript
+ * import { definePlayer, PlayerActor, compose } from "@xmachines/play-xstate";
+ * import { withRouting } from "@xmachines/play-xstate/routing";
+ *
+ * const createPlayer = definePlayer({ machine, actor: compose(PlayerActor, withRouting) });
+ * const actor = createPlayer();
+ * actor.currentRoute.get(); // "/profile/alice"
+ * ```
+ *
+ * @packageDocumentation
+ */
+import type { AnyStateMachine } from "xstate";
+import type { Routable } from "@xmachines/play-router";
+import type { PlayerConstructor } from "./capabilities.js";
+/**
+ * Adds the routing capability to an actor class.
+ *
+ * The result satisfies `Routable`, so a router bridge accepts it. A class without this
+ * mixin exposes no `currentRoute`, and a bridge therefore refuses it when it compiles,
+ * rather than at the first navigation.
+ *
+ * The mixin declares NO constructor, and that is deliberate: TypeScript demands the
+ * signature `...args: any[]` from a mixin over a generic base (TS2545), and this
+ * workspace writes no `any`. A field initializer of a subclass runs after `super()`
+ * instead, and it reads the inputs that `PlayerActor` keeps for a capability.
+ *
+ * @param Base - The actor class to extend, normally `PlayerActor`.
+ */
+export declare function withRouting<TMachine extends AnyStateMachine>(Base: PlayerConstructor<TMachine>): PlayerConstructor<TMachine, Routable>;
+export { deriveRoute, isAbsoluteRoute, buildRouteUrl, formatPlayRouteTransitions, } from "./routing/index.js";
+export type { RouteMachineConfig, RouteStateNode, RouteContext, RouteObject, RouteMetadata, RouteData, RouteDataResolver, } from "./routing/index.js";
+//# sourceMappingURL=with-routing.d.ts.map

package/dist/with-routing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-routing.d.ts","sourceRoot":"","sources":["../src/with-routing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAEvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAG3D;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,CAAC,QAAQ,SAAS,eAAe,EAC3D,IAAI,EAAE,iBAAiB,CAAC,QAAQ,CAAC,GAC/B,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAoDvC;AAcD,OAAO,EACN,WAAW,EACX,eAAe,EACf,aAAa,EACb,0BAA0B,GAC1B,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACX,kBAAkB,EAClB,cAAc,EACd,YAAY,EACZ,WAAW,EACX,aAAa,EACb,SAAS,EACT,iBAAiB,GACjB,MAAM,oBAAoB,CAAC"}

package/dist/with-routing.js

@@ -0,0 +1,78 @@
+import { Signal } from "@xmachines/play-signals";
+import { deriveCurrentRoute, deriveInitialRoute } from "./routing/index.js";
+/**
+ * Adds the routing capability to an actor class.
+ *
+ * The result satisfies `Routable`, so a router bridge accepts it. A class without this
+ * mixin exposes no `currentRoute`, and a bridge therefore refuses it when it compiles,
+ * rather than at the first navigation.
+ *
+ * The mixin declares NO constructor, and that is deliberate: TypeScript demands the
+ * signature `...args: any[]` from a mixin over a generic base (TS2545), and this
+ * workspace writes no `any`. A field initializer of a subclass runs after `super()`
+ * instead, and it reads the inputs that `PlayerActor` keeps for a capability.
+ *
+ * @param Base - The actor class to extend, normally `PlayerActor`.
+ */
+export function withRouting(Base) {
+    class RoutableActor extends Base {
+        /**
+         * 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.
+         *
+         * It returns `null` when the current state has no `meta.route` field, and also when
+         * a necessary `:param` has no value in the context. The second case is normally
+         * temporary during a transition, and the signal computes the value again on the next
+         * snapshot.
+         *
+         * @example
+         * ```typescript
+         * // It returns "/profile/alice" when context.params.userId === "alice",
+         * // and null while the param is still absent.
+         * const route = actor.currentRoute.get();
+         * ```
+         */
+        currentRoute = new Signal.Computed(() => deriveCurrentRoute(this.state.get()));
+        /**
+         * The route of the initial state of the machine. The construction fixes it, and it
+         * never changes, also when the code restores the actor from a snapshot.
+         *
+         * 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).
+         *
+         * `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.
+         *
+         * Without a snapshot of a restore, the pre-start snapshot of this actor IS that
+         * default initial state, so the code derives the route from it directly. A restore
+         * alone needs `initialTransition`, whose inert actor scope runs the initial
+         * transition two more times, one of them with an undefined `input`. That is a quirk
+         * of XState, and it costs too much for every other case.
+         */
+        initialRoute = this.playerRestoredSnapshot === undefined
+            ? deriveCurrentRoute(this.getSnapshot())
+            : deriveInitialRoute(this.playerMachine, this.playerInput);
+    }
+    return RoutableActor;
+}
+// The utilities of the route derivation and of the URL construction.
+//
+// They belong HERE, and no longer on the main entry. Each one names
+// `@xmachines/play-router` in its own `.d.ts` — `PlayRouteEvent`, `RouteData`,
+// `RouteObject` and `RouteMetadata` all have their single definition there. That
+// package is an OPTIONAL peer, so a main entry that reached them gave every consumer
+// of `definePlayer` a type graph that names a package their node_modules does not
+// hold. `skipLibCheck` hides the fault and does not remove it: the types resolve to
+// nothing.
+//
+// The view half exposes nothing on the main entry, for the same reason. The two
+// capabilities hold one shape.
+export { deriveRoute, isAbsoluteRoute, buildRouteUrl, formatPlayRouteTransitions, } from "./routing/index.js";
+//# sourceMappingURL=with-routing.js.map

package/dist/with-routing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-routing.js","sourceRoot":"","sources":["../src/with-routing.ts"],"names":[],"mappings":"AAyBA,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAIjD,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAE5E;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,WAAW,CAC1B,IAAiC;IAEjC,MAAM,aAAc,SAAQ,IAAI;QAC/B;;;;;;;;;;;;;;;WAeG;QACa,YAAY,GAAmC,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,CACvF,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CACpC,CAAC;QAEF;;;;;;;;;;;;;;;;;;;;;;WAsBG;QACa,YAAY,GAC3B,IAAI,CAAC,sBAAsB,KAAK,SAAS;YACxC,CAAC,CAAC,kBAAkB,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACxC,CAAC,CAAC,kBAAkB,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;KAC7D;IAED,OAAO,aAAa,CAAC;AACtB,CAAC;AAED,qEAAqE;AACrE,EAAE;AACF,oEAAoE;AACpE,+EAA+E;AAC/E,iFAAiF;AACjF,qFAAqF;AACrF,kFAAkF;AAClF,oFAAoF;AACpF,WAAW;AACX,EAAE;AACF,gFAAgF;AAChF,+BAA+B;AAC/B,OAAO,EACN,WAAW,EACX,eAAe,EACf,aAAa,EACb,0BAA0B,GAC1B,MAAM,oBAAoB,CAAC"}

package/dist/with-view.d.ts

@@ -0,0 +1,42 @@
+/**
+ * The view capability of an XState actor, as a mixin.
+ *
+ * `PlayerActor` holds `state` and `send`, and nothing about a view. This module adds
+ * `currentView`, which is what `Viewable` of `@xmachines/play-view` asks for and what
+ * every renderer reads.
+ *
+ * It is a SEPARATE entry point, `@xmachines/play-xstate/view`, and the core imports it
+ * never. `@xmachines/play-view` is an OPTIONAL peer of this package for the same reason:
+ * an application that renders no view installs neither that package nor the json-render
+ * types that it names.
+ *
+ * @example
+ * ```typescript
+ * import { definePlayer, PlayerActor, compose } from "@xmachines/play-xstate";
+ * import { withRouting } from "@xmachines/play-xstate/routing";
+ * import { withView } from "@xmachines/play-xstate/view";
+ *
+ * const createPlayer = definePlayer({
+ *   machine,
+ *   actor: compose(PlayerActor, withRouting, withView),
+ * });
+ * ```
+ *
+ * @packageDocumentation
+ */
+import type { AnyStateMachine } from "xstate";
+import { type Viewable } from "@xmachines/play-view";
+import type { PlayerConstructor } from "./capabilities.js";
+/**
+ * Adds the view capability to an actor class.
+ *
+ * Compose it AFTER the routing capability. An override calls `super.onSnapshot()` first,
+ * so `compose(PlayerActor, withRouting, withView)` gives the route its new value before
+ * the view derives from the same transition. A router bridge therefore sees a guard
+ * redirect before a renderer sees the view of the state that the guard refused.
+ *
+ * @param Base - The actor class to extend, normally `PlayerActor` or the result of
+ *   another capability.
+ */
+export declare function withView<TMachine extends AnyStateMachine>(Base: PlayerConstructor<TMachine>): PlayerConstructor<TMachine, Viewable>;
+//# sourceMappingURL=with-view.d.ts.map

package/dist/with-view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-view.d.ts","sourceRoot":"","sources":["../src/with-view.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,OAAO,KAAK,EAAsB,eAAe,EAAE,MAAM,QAAQ,CAAC;AAGlE,OAAO,EAAqC,KAAK,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAGxF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAsD3D;;;;;;;;;;GAUG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,SAAS,eAAe,EACxD,IAAI,EAAE,iBAAiB,CAAC,QAAQ,CAAC,GAC/B,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAgFvC"}