@xmachines/play-xstate 1.0.0-beta.25 → 1.0.0-beta.27

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mikael Karon
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -38,8 +38,8 @@ const machine = setup({
 	types: {
 		context: {} as {
 			isAuthenticated: boolean;
-			routeParams: Record<string, string>;
-			queryParams: Record<string, string>;
+			params: Record<string, string>;
+			query: Record<string, string>;
 		},
 		events: {} as
 			| { type: "play.route"; to: string; params?: Record<string, string> }
@@ -50,7 +50,7 @@ const machine = setup({
 	formatPlayRouteTransitions({
 		id: "app",
 		initial: "login",
-		context: { isAuthenticated: false, routeParams: {}, queryParams: {} },
+		context: { isAuthenticated: false, params: {}, query: {} },
 		states: {
 			login: {
 				id: "login",
@@ -178,8 +178,8 @@ Concrete actor implementing Play signal protocol:
 **Signal Properties:**
 
 - `state: Signal.State<AnyMachineSnapshot>` — Reactive snapshot of current state
-- `currentRoute: Signal.Computed<string | null>` — Derived URL from the current state's `meta.route` and `context.routeParams`. Returns `null` when no route metadata is present or a required route parameter is missing from context.
-- `currentView: Signal.State<ViewMetadata | null>` — Current view spec (updated on every state transition). The spec is automatically enriched with `context.routeParams` (URL params) and any `contextProps`-allowlisted context fields before being emitted (see [Prop Enrichment from Routing and Context](#prop-enrichment-from-routing-and-context)).
+- `currentRoute: Signal.Computed<string | null>` — Derived URL from the current state's `meta.route` and `context.params`. Returns `null` when no route metadata is present or a required route parameter is missing from context.
+- `currentView: Signal.State<ViewMetadata | null>` — Current view spec (updated on every state transition). The spec is automatically enriched with `context.params` (URL params) and any `contextProps`-allowlisted context fields before being emitted (see [Prop Enrichment from Routing and Context](#prop-enrichment-from-routing-and-context)).
 
 **Lifecycle ordering:**
 
@@ -205,7 +205,7 @@ Concrete actor implementing Play signal protocol:
 **View derivation and route-param enrichment:**
 
 - `currentView` emits a fresh `ViewMetadata` object on every transition so TC39 Signal equality checks always detect changes (including re-entries to the same state with different params).
-- `context.routeParams` and `contextProps`-allowlisted context fields are merged into spec element props — see [Prop Enrichment from Routing and Context](#prop-enrichment-from-routing-and-context).
+- `context.params` and `contextProps`-allowlisted context fields are merged into spec element props — see [Prop Enrichment from Routing and Context](#prop-enrichment-from-routing-and-context).
 
 **Example:**
 
@@ -314,8 +314,8 @@ const machine = setup({
 	types: {
 		context: {} as {
 			isAuthenticated: boolean;
-			routeParams: Record<string, string>;
-			queryParams: Record<string, string>;
+			params: Record<string, string>;
+			query: Record<string, string>;
 		},
 		events: {} as
 			| { type: "play.route"; to: string; params?: Record<string, string> }
@@ -472,7 +472,7 @@ spec: {
 }
 // After play.route to /settings/profile:
 // Component receives: { section: "profile", username: "alice", theme: "dark" }
-//   section  → from routeParams (URL)
+//   section  → from context.params (URL)
 //   username → from contextProps (context)
 //   theme    → from spec (explicit value, untouched)
 ```
@@ -524,11 +524,11 @@ it to be filled in automatically.
 
 ### Merge priority (highest → lowest)
 
-| Source                                  | When it applies                  | Wins over                 |
-| --------------------------------------- | -------------------------------- | ------------------------- |
-| Explicit non-`undefined` spec prop      | Always                           | Everything                |
-| URL route param (`context.routeParams`) | State has a `:param` URL segment | `contextProps` values     |
-| `contextProps` field                    | Listed in `spec.contextProps`    | Nothing (lowest priority) |
+| Source                             | When it applies                  | Wins over                 |
+| ---------------------------------- | -------------------------------- | ------------------------- |
+| Explicit non-`undefined` spec prop | Always                           | Everything                |
+| URL route param (`context.params`) | State has a `:param` URL segment | `contextProps` values     |
+| `contextProps` field               | Listed in `spec.contextProps`    | Nothing (lowest priority) |
 
 ### URL route parameters
 
@@ -578,7 +578,7 @@ If both a route param and a `contextProps` field share the same key, the route p
 
 ```typescript
 // context.username = "alice" (logged-in user)
-// play.route to /profile/demo → routeParams.username = "demo"
+// play.route to /profile/demo → context.params.username = "demo"
 // contextProps: ["username"], props: { username: undefined }
 // Component receives: { username: "demo" }  ← route param wins
 ```

package/dist/define-player.d.ts

@@ -1,4 +1,4 @@
-import type { AnyStateMachine } from "xstate";
+import { type AnyStateMachine } from "xstate";
 import type { PlayerConfig, PlayerFactory } from "./types.js";
 /**
  * Create a player factory from an XState machine

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

@@ -1 +1 @@
-{"version":3,"file":"define-player.d.ts","sourceRoot":"","sources":["../src/define-player.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAa,MAAM,QAAQ,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAA8B,MAAM,YAAY,CAAC;AAG1F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuDG;AACH,eAAO,MAAM,YAAY,GAAI,QAAQ,SAAS,eAAe,EAC5D,QAAQ,YAAY,CAAC,QAAQ,CAAC,KAC5B,aAAa,CAAC,QAAQ,CAMxB,CAAC"}
+{"version":3,"file":"define-player.d.ts","sourceRoot":"","sources":["../src/define-player.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,eAAe,EAA2C,MAAM,QAAQ,CAAC;AACpG,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAA8B,MAAM,YAAY,CAAC;AAG1F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuDG;AACH,eAAO,MAAM,YAAY,GAAI,QAAQ,SAAS,eAAe,EAC5D,QAAQ,YAAY,CAAC,QAAQ,CAAC,KAC5B,aAAa,CAAC,QAAQ,CAsBxB,CAAC"}

package/dist/define-player.js

@@ -1,4 +1,5 @@
-import { PlayerActor } from "./player-actor.js";
+import { createActor } from "xstate";
+import { PlayerActor, deriveCurrentRoute } from "./player-actor.js";
 /**
  * Create a player factory from an XState machine
  *
@@ -57,8 +58,15 @@ import { PlayerActor } from "./player-actor.js";
  */
 export const definePlayer = (config) => {
     const { machine, options } = config;
+    // Pre-compute the initial route once per machine definition.
+    // initialRoute is determined by the machine's initial state node and meta.route
+    // template — both fixed at definition time, independent of input or snapshot.
+    // Passed to every PlayerActor constructed from this factory, eliminating a
+    // redundant createActor() call per actor construction.
+    // The actor is never started — getSnapshot() is synchronous and free.
+    const cachedInitialRoute = deriveCurrentRoute(createActor(machine).getSnapshot());
     return (input, restore) => {
-        return new PlayerActor(machine, options ?? {}, input, restore?.snapshot);
+        return new PlayerActor(machine, options ?? {}, input, restore?.snapshot, cachedInitialRoute);
     };
 };
 //# sourceMappingURL=define-player.js.map

package/dist/define-player.js.map

@@ -1 +1 @@
-{"version":3,"file":"define-player.js","sourceRoot":"","sources":["../src/define-player.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuDG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAC3B,MAA8B,EACJ,EAAE;IAC5B,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC;IAEpC,OAAO,CAAC,KAA2B,EAAE,OAA8C,EAAE,EAAE;QACtF,OAAO,IAAI,WAAW,CAAC,OAAO,EAAE,OAAO,IAAI,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC1E,CAAC,CAAC;AACH,CAAC,CAAC"}
+{"version":3,"file":"define-player.js","sourceRoot":"","sources":["../src/define-player.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAiE,MAAM,QAAQ,CAAC;AAEpG,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEpE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuDG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAC3B,MAA8B,EACJ,EAAE;IAC5B,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC;IAEpC,6DAA6D;IAC7D,gFAAgF;IAChF,8EAA8E;IAC9E,2EAA2E;IAC3E,uDAAuD;IACvD,sEAAsE;IACtE,MAAM,kBAAkB,GAAG,kBAAkB,CAC5C,WAAW,CAAC,OAAO,CAAC,CAAC,WAAW,EAAwB,CACxD,CAAC;IAEF,OAAO,CAAC,KAA2B,EAAE,OAA8C,EAAE,EAAE;QACtF,OAAO,IAAI,WAAW,CACrB,OAAO,EACP,OAAO,IAAI,EAAE,EACb,KAAK,EACL,OAAO,EAAE,QAAQ,EACjB,kBAAkB,CAClB,CAAC;IACH,CAAC,CAAC;AACH,CAAC,CAAC"}

package/dist/errors.d.ts

@@ -59,6 +59,78 @@ export declare class MissingRouteParamError extends PlayError {
  * }
  * ```
  */
+/**
+ * Thrown by `buildRouteUrl()` when the context has a `params` field (indicating a
+ * routing-aware machine context) but no `query` field.
+ *
+ * The `params` field signals the context was set up for routing (either manually or via
+ * `formatPlayRouteTransitions`). A routing-aware context without `query` will silently
+ * drop any query parameters carried by `play.route` events, producing incorrect URLs.
+ *
+ * **Fix:** Ensure the machine context type includes `query: Record<string, string>`
+ * and that the context initializer sets `query: {}` (or a populated value).
+ * If using `formatPlayRouteTransitions`, the field is assigned automatically on each
+ * `play.route` event — but the machine's initial context must still declare it.
+ *
+ * **Error code:** `PLAY_MISSING_QUERY_CONTEXT`
+ *
+ * @example
+ * ```typescript
+ * import { MissingQueryContextError } from "@xmachines/play-xstate/errors";
+ *
+ * try {
+ *   // params present but no query field — throws
+ *   buildRouteUrl("/profile/:userId", { params: { userId: "42" } });
+ * } catch (err) {
+ *   if (err instanceof MissingQueryContextError) {
+ *     console.error("Machine context missing query field");
+ *   }
+ * }
+ *
+ * // Correct — both params and query declared
+ * buildRouteUrl("/profile/:userId", { params: { userId: "42" }, query: {} });
+ * ```
+ */
+export declare class MissingQueryContextError extends PlayError {
+    constructor();
+}
+/**
+ * Thrown by `formatPlayRouteTransitions()` when a state node declares `meta.route`
+ * but omits an explicit `id`.
+ *
+ * Without `id`, the function cannot generate a `play.route` guard that targets the
+ * state — the guard compares `event.to` against `#<id>`, so a missing `id` means
+ * the state is silently unreachable via routing. This error surfaces the
+ * misconfiguration at machine-definition time rather than silently skipping the state.
+ *
+ * **Error code:** `PLAY_MISSING_STATE_ID`
+ *
+ * @example
+ * ```typescript
+ * // Bad — meta.route without id:
+ * states: {
+ *   profile: {
+ *     meta: { route: "/profile/:username" },
+ *     // ← missing id: "profile"
+ *   }
+ * }
+ *
+ * // Good:
+ * states: {
+ *   profile: {
+ *     id: "profile",
+ *     meta: { route: "/profile/:username" },
+ *   }
+ * }
+ * ```
+ */
+export declare class MissingStateIdError extends PlayError {
+    /** The state key (position in the states tree) that is missing an explicit `id`. */
+    readonly stateKey: string;
+    /** The route template declared on the state (e.g. `"/profile/:username"`). */
+    readonly route: string;
+    constructor(stateKey: string, route: string);
+}
 export declare class InvalidEventError extends PlayError {
     readonly detail: unknown;
     constructor(detail: unknown);

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,sBAAuB,SAAQ,SAAS;IACpD,0EAA0E;IAC1E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,0FAA0F;IAC1F,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAEd,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;CAU3C;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,iBAAkB,SAAQ,SAAS;IAC/C,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;gBAEb,MAAM,EAAE,OAAO;CAU3B"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,sBAAuB,SAAQ,SAAS;IACpD,0EAA0E;IAC1E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,0FAA0F;IAC1F,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAEd,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;CAU3C;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,qBAAa,wBAAyB,SAAQ,SAAS;;CAWtD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,qBAAa,mBAAoB,SAAQ,SAAS;IACjD,oFAAoF;IACpF,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,8EAA8E;IAC9E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;gBAEX,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;CAW3C;AAED,qBAAa,iBAAkB,SAAQ,SAAS;IAC/C,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;gBAEb,MAAM,EAAE,OAAO;CAU3B"}

package/dist/errors.js

@@ -64,6 +64,89 @@ export class MissingRouteParamError extends PlayError {
  * }
  * ```
  */
+/**
+ * Thrown by `buildRouteUrl()` when the context has a `params` field (indicating a
+ * routing-aware machine context) but no `query` field.
+ *
+ * The `params` field signals the context was set up for routing (either manually or via
+ * `formatPlayRouteTransitions`). A routing-aware context without `query` will silently
+ * drop any query parameters carried by `play.route` events, producing incorrect URLs.
+ *
+ * **Fix:** Ensure the machine context type includes `query: Record<string, string>`
+ * and that the context initializer sets `query: {}` (or a populated value).
+ * If using `formatPlayRouteTransitions`, the field is assigned automatically on each
+ * `play.route` event — but the machine's initial context must still declare it.
+ *
+ * **Error code:** `PLAY_MISSING_QUERY_CONTEXT`
+ *
+ * @example
+ * ```typescript
+ * import { MissingQueryContextError } from "@xmachines/play-xstate/errors";
+ *
+ * try {
+ *   // params present but no query field — throws
+ *   buildRouteUrl("/profile/:userId", { params: { userId: "42" } });
+ * } catch (err) {
+ *   if (err instanceof MissingQueryContextError) {
+ *     console.error("Machine context missing query field");
+ *   }
+ * }
+ *
+ * // Correct — both params and query declared
+ * buildRouteUrl("/profile/:userId", { params: { userId: "42" }, query: {} });
+ * ```
+ */
+export class MissingQueryContextError extends PlayError {
+    constructor() {
+        super("buildRouteUrl", "PLAY_MISSING_QUERY_CONTEXT", "buildRouteUrl() received a context without a 'query' field. " +
+            "Declare 'query: Record<string, string>' in the machine context type and " +
+            "initialise it to {} so query parameters from play.route events are not silently dropped.");
+        this.name = "MissingQueryContextError";
+    }
+}
+/**
+ * Thrown by `formatPlayRouteTransitions()` when a state node declares `meta.route`
+ * but omits an explicit `id`.
+ *
+ * Without `id`, the function cannot generate a `play.route` guard that targets the
+ * state — the guard compares `event.to` against `#<id>`, so a missing `id` means
+ * the state is silently unreachable via routing. This error surfaces the
+ * misconfiguration at machine-definition time rather than silently skipping the state.
+ *
+ * **Error code:** `PLAY_MISSING_STATE_ID`
+ *
+ * @example
+ * ```typescript
+ * // Bad — meta.route without id:
+ * states: {
+ *   profile: {
+ *     meta: { route: "/profile/:username" },
+ *     // ← missing id: "profile"
+ *   }
+ * }
+ *
+ * // Good:
+ * states: {
+ *   profile: {
+ *     id: "profile",
+ *     meta: { route: "/profile/:username" },
+ *   }
+ * }
+ * ```
+ */
+export class MissingStateIdError extends PlayError {
+    /** The state key (position in the states tree) that is missing an explicit `id`. */
+    stateKey;
+    /** The route template declared on the state (e.g. `"/profile/:username"`). */
+    route;
+    constructor(stateKey, route) {
+        super("formatPlayRouteTransitions", "PLAY_MISSING_STATE_ID", `State "${stateKey}" declares meta.route "${route}" but has no explicit id. ` +
+            `Add id: "${stateKey}" to the state config so play.route events can target it.`);
+        this.name = "MissingStateIdError";
+        this.stateKey = stateKey;
+        this.route = route;
+    }
+}
 export class InvalidEventError extends PlayError {
     detail;
     constructor(detail) {

package/dist/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,OAAO,sBAAuB,SAAQ,SAAS;IACpD,0EAA0E;IACjE,KAAK,CAAS;IAEvB,0FAA0F;IACjF,QAAQ,CAAS;IAE1B,YAAY,KAAa,EAAE,QAAgB;QAC1C,KAAK,CACJ,eAAe,EACf,0BAA0B,EAC1B,oBAAoB,KAAK,8BAA8B,QAAQ,iCAAiC,CAChG,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;QACrC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC1B,CAAC;CACD;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,OAAO,iBAAkB,SAAQ,SAAS;IACtC,MAAM,CAAU;IAEzB,YAAY,MAAe;QAC1B,KAAK,CACJ,aAAa,EACb,oBAAoB,EACpB,iDAAiD,CACjD,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;QAChC,6EAA6E;QAC7E,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5E,CAAC;CACD"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,OAAO,sBAAuB,SAAQ,SAAS;IACpD,0EAA0E;IACjE,KAAK,CAAS;IAEvB,0FAA0F;IACjF,QAAQ,CAAS;IAE1B,YAAY,KAAa,EAAE,QAAgB;QAC1C,KAAK,CACJ,eAAe,EACf,0BAA0B,EAC1B,oBAAoB,KAAK,8BAA8B,QAAQ,iCAAiC,CAChG,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;QACrC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC1B,CAAC;CACD;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,OAAO,wBAAyB,SAAQ,SAAS;IACtD;QACC,KAAK,CACJ,eAAe,EACf,4BAA4B,EAC5B,8DAA8D;YAC7D,0EAA0E;YAC1E,0FAA0F,CAC3F,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;IACxC,CAAC;CACD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,OAAO,mBAAoB,SAAQ,SAAS;IACjD,oFAAoF;IAC3E,QAAQ,CAAS;IAC1B,8EAA8E;IACrE,KAAK,CAAS;IAEvB,YAAY,QAAgB,EAAE,KAAa;QAC1C,KAAK,CACJ,4BAA4B,EAC5B,uBAAuB,EACvB,UAAU,QAAQ,0BAA0B,KAAK,4BAA4B;YAC5E,YAAY,QAAQ,2DAA2D,CAChF,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAClC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACpB,CAAC;CACD;AAED,MAAM,OAAO,iBAAkB,SAAQ,SAAS;IACtC,MAAM,CAAU;IAEzB,YAAY,MAAe;QAC1B,KAAK,CACJ,aAAa,EACb,oBAAoB,EACpB,iDAAiD,CACjD,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;QAChC,6EAA6E;QAC7E,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5E,CAAC;CACD"}

package/dist/player-actor.d.ts

@@ -2,6 +2,27 @@ import { type AnyStateMachine, type Actor, type AnyActorLogic, type AnyMachineSn
 import { AbstractActor, type Routable, type Viewable, type ViewMetadata } from "@xmachines/play-actor";
 import { Signal } from "@xmachines/play-signals";
 import type { PlayerOptions } from "./types.js";
+/**
+ * Derive the actor's current URL from state metadata and context.
+ *
+ * Resolves the route template from the current state's `meta.route` and substitutes
+ * any `:param` placeholders from `context.params` (preferred) or flat `context`.
+ *
+ * Returns `null` — rather than throwing — when:
+ * - The snapshot has no route metadata (non-routable state)
+ * - A required route parameter is absent from context (`MissingRouteParamError`)
+ *
+ * The `null` return on missing params is intentional: it keeps the computed signal
+ * stable during transient states (e.g. mid-transition before context is fully updated,
+ * or after logout when `context.username` is `null` but the router bridge has not yet
+ * synced to the new state). The router bridge and URL bar are updated on the next
+ * stable snapshot once context is complete.
+ *
+ * @param snapshot - Current XState machine snapshot.
+ * @returns Resolved URL string, or `null` if the route cannot be resolved.
+ */
+/** @internal — exported for `definePlayer` pre-computation only. */
+export declare const deriveCurrentRoute: (snapshot: AnyMachineSnapshot) => string | null;
 /**
  * Concrete XState actor implementing Play Architecture signal protocol
  *
@@ -110,8 +131,15 @@ export declare class PlayerActor<TMachine extends AnyStateMachine> extends Abstr
      * (non-initial URL → router wins) from a restore (initial URL + actor at a
      * different restored route → actor wins).
      *
-     * This value is intentionally derived from a fresh, non-restored machine snapshot,
-     * never from the runtime actor snapshot passed via `restore?.snapshot`.
+     * Determined by the machine's initial state node and its `meta.route` template —
+     * both are fixed at machine definition time. `definePlayer` pre-computes this value
+     * once from the machine definition and passes it to every actor it constructs, so no
+     * extra `createActor()` call is needed per construction.
+     *
+     * When `PlayerActor` is constructed directly (without `definePlayer`), the value is
+     * derived from `xstateActor.getSnapshot()` (normal path) or a transient
+     * `createActor(machine, { input })` call (restore path, to avoid using the
+     * snapshot's state instead of the machine's default).
      */
     readonly initialRoute: string | null;
     /**
@@ -123,7 +151,7 @@ export declare class PlayerActor<TMachine extends AnyStateMachine> extends Abstr
      * detect changes.
      *
      * The emitted `ViewMetadata` has its spec element `props` enriched with
-     * `context.routeParams` before emission — URL path parameters (e.g. `:section?`)
+     * `context.params` before emission — URL path parameters (e.g. `:section?`)
      * flow into component props automatically. See `mergeRouteParamsIntoProps` for the
      * merge priority rules.
      *
@@ -139,7 +167,17 @@ export declare class PlayerActor<TMachine extends AnyStateMachine> extends Abstr
      * ```
      */
     currentView: Signal.State<ViewMetadata | null>;
-    constructor(machine: TMachine, options: PlayerOptions<TMachine>, input?: InputFrom<TMachine>, snapshot?: SnapshotFrom<TMachine>);
+    constructor(machine: TMachine, options: PlayerOptions<TMachine>, input?: InputFrom<TMachine>, snapshot?: SnapshotFrom<TMachine>, 
+    /**
+     * Pre-computed initial route from `definePlayer`.
+     * `initialRoute` is determined by the machine's initial state node and its
+     * `meta.route` template — both fixed at machine definition time regardless
+     * of `input` or `snapshot`. When provided, used directly on every construction,
+     * eliminating a redundant `createActor()` call per actor instance.
+     *
+     * @internal — set by `definePlayer`; callers should not pass this directly.
+     */
+    _cachedInitialRoute?: string | null);
     /**
      * Start the actor
      *

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

@@ -1 +1 @@
-{"version":3,"file":"player-actor.d.ts","sourceRoot":"","sources":["../src/player-actor.ts"],"names":[],"mappings":"AAAA,OAAO,EAEN,KAAK,eAAe,EACpB,KAAK,KAAK,EACV,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,SAAS,EAEd,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,MAAM,QAAQ,CAAC;AAChB,OAAO,EACN,aAAa,EACb,KAAK,QAAQ,EACb,KAAK,QAAQ,EACb,KAAK,YAAY,EACjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAIjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AA2OhD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0EG;AACH,qBAAa,WAAW,CAAC,QAAQ,SAAS,eAAe,CACxD,SAAQ,aAAa,CAAC,aAAa,EAAE,cAAc,CAAC,QAAQ,CAAC,CAC7D,YAAW,QAAQ,EAAE,QAAQ;IAE7B,OAAO,CAAC,YAAY,CAAkB;IACtC,OAAO,CAAC,aAAa,CAAyC;IAC9D,OAAO,CAAC,QAAQ,CAA0B;IAC1C,OAAO,CAAC,WAAW,CAAoC;IAGhD,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;IAE/C;;;;;;;;;;;;;;;;;OAiBG;IACI,YAAY,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAEpD;;;;;;;;;;OAUG;IACH,SAAgB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAE5C;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACI,WAAW,EAAE,MAAM,CAAC,KAAK,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;gBAGrD,OAAO,EAAE,QAAQ,EACjB,OAAO,EAAE,aAAa,CAAC,QAAQ,CAAC,EAChC,KAAK,CAAC,EAAE,SAAS,CAAC,QAAQ,CAAC,EAC3B,QAAQ,CAAC,EAAE,YAAY,CAAC,QAAQ,CAAC;IAyElC;;;;OAIG;IACM,KAAK,IAAI,IAAI;IAWtB;;OAEG;IACM,IAAI,IAAI,IAAI;IAYrB;;;;;;;;;;;;;;;;;;;OAmBG;IACM,IAAI,CAAC,KAAK,EAAE,cAAc,CAAC,QAAQ,CAAC,GAAG,IAAI;IAoBpD;;OAEG;IACM,WAAW,IAAI,UAAU,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,aAAa,CAAC,CAAC;IAIlE;;;;;;;OAOG;IACH,OAAO,CAAC,qBAAqB;IAc7B;;;;OAIG;IACH,OAAO,IAAI,IAAI;CAGf"}
+{"version":3,"file":"player-actor.d.ts","sourceRoot":"","sources":["../src/player-actor.ts"],"names":[],"mappings":"AAAA,OAAO,EAEN,KAAK,eAAe,EACpB,KAAK,KAAK,EACV,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,SAAS,EAEd,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,MAAM,QAAQ,CAAC;AAChB,OAAO,EACN,aAAa,EACb,KAAK,QAAQ,EACb,KAAK,QAAQ,EACb,KAAK,YAAY,EACjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAIjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAoBhD;;;;;;;;;;;;;;;;;;GAkBG;AACH,oEAAoE;AACpE,eAAO,MAAM,kBAAkB,GAAI,UAAU,kBAAkB,KAAG,MAAM,GAAG,IAyC1E,CAAC;AA0KF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0EG;AACH,qBAAa,WAAW,CAAC,QAAQ,SAAS,eAAe,CACxD,SAAQ,aAAa,CAAC,aAAa,EAAE,cAAc,CAAC,QAAQ,CAAC,CAC7D,YAAW,QAAQ,EAAE,QAAQ;IAE7B,OAAO,CAAC,YAAY,CAAkB;IACtC,OAAO,CAAC,aAAa,CAAyC;IAC9D,OAAO,CAAC,QAAQ,CAA0B;IAC1C,OAAO,CAAC,WAAW,CAAoC;IAGhD,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;IAE/C;;;;;;;;;;;;;;;;;OAiBG;IACI,YAAY,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAEpD;;;;;;;;;;;;;;;;;OAiBG;IACH,SAAgB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAE5C;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACI,WAAW,EAAE,MAAM,CAAC,KAAK,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;gBAGrD,OAAO,EAAE,QAAQ,EACjB,OAAO,EAAE,aAAa,CAAC,QAAQ,CAAC,EAChC,KAAK,CAAC,EAAE,SAAS,CAAC,QAAQ,CAAC,EAC3B,QAAQ,CAAC,EAAE,YAAY,CAAC,QAAQ,CAAC;IACjC;;;;;;;;OAQG;IACH,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI;IA6FpC;;;;OAIG;IACM,KAAK,IAAI,IAAI;IAWtB;;OAEG;IACM,IAAI,IAAI,IAAI;IAYrB;;;;;;;;;;;;;;;;;;;OAmBG;IACM,IAAI,CAAC,KAAK,EAAE,cAAc,CAAC,QAAQ,CAAC,GAAG,IAAI;IAoBpD;;OAEG;IACM,WAAW,IAAI,UAAU,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,aAAa,CAAC,CAAC;IAIlE;;;;;;;OAOG;IACH,OAAO,CAAC,qBAAqB;IAc7B;;;;OAIG;IACH,OAAO,IAAI,IAAI;CAGf"}

package/dist/player-actor.js

@@ -20,7 +20,7 @@ const isActiveSnapshot = (snapshot) => {
  * Derive the actor's current URL from state metadata and context.
  *
  * Resolves the route template from the current state's `meta.route` and substitutes
- * any `:param` placeholders from `context.routeParams` (preferred) or flat `context`.
+ * any `:param` placeholders from `context.params` (preferred) or flat `context`.
  *
  * Returns `null` — rather than throwing — when:
  * - The snapshot has no route metadata (non-routable state)
@@ -35,7 +35,8 @@ const isActiveSnapshot = (snapshot) => {
  * @param snapshot - Current XState machine snapshot.
  * @returns Resolved URL string, or `null` if the route cannot be resolved.
  */
-const deriveCurrentRoute = (snapshot) => {
+/** @internal — exported for `definePlayer` pre-computation only. */
+export const deriveCurrentRoute = (snapshot) => {
     if (!snapshot || typeof snapshot.getMeta !== "function") {
         return null;
     }
@@ -48,16 +49,30 @@ const deriveCurrentRoute = (snapshot) => {
         return null;
     }
     try {
-        return buildRouteUrl(routeTemplate, snapshot.context ?? {});
+        return buildRouteUrl(routeTemplate, (snapshot.context ?? {}));
     }
     catch (error) {
-        // A required route parameter is absent from context — this can happen transiently
-        // when the machine is mid-transition (e.g. actor in profile state but username not
-        // yet assigned, or after logout before the router bridge has redirected).
-        // Return null and let the signal recompute on the next stable snapshot.
+        // MissingRouteParamError: transient and self-resolving — a required `:param` is absent
+        // from context during a mid-transition state (e.g. actor in profile state before the
+        // first play.route event populates context.params, or after logout before the bridge
+        // redirects). Returning null is correct:
+        //   - Router bridges handle null by skipping navigation (syncRouterFromActor line 242)
+        //   - The signal recomputes automatically on the next snapshot when params are populated
+        //   - Throwing would propagate into signal watchers as an unhandled exception for a
+        //     state that resolves itself — worse than a one-tick null.
+        // Do NOT convert this to a throw. See MissingQueryContextError for the structural-error
+        // case where throwing is appropriate (non-self-resolving programmer error).
         if (error instanceof MissingRouteParamError) {
             return null;
         }
+        // MissingQueryContextError: structural programmer error — the machine context
+        // declares `params` but no `query` field. This cannot self-resolve on the next
+        // snapshot; re-throw so it surfaces immediately. Frameworks with error boundaries
+        // (React, Svelte, SvelteKit) will catch it; signal watchers will see it as an
+        // unhandled exception. Fix: add `query: Record<string, string>` to the machine's
+        // context type and initializer.
+        //
+        // All other unexpected errors also re-throw unchanged.
         throw error;
     }
 };
@@ -78,14 +93,14 @@ const resolveViewMeta = (meta) => {
  *
  * Priority rule (highest → lowest):
  * 1. Explicit non-`undefined` spec prop — always wins (static values are authoritative).
- * 2. URL route params (`context.routeParams`) — fills `undefined` slots from the URL path.
+ * 2. URL route params (`context.params`) — fills `undefined` slots from the URL path.
  * 3. Allowlisted context fields (`contextProps`) — fills remaining `undefined` slots from
  *    the machine context (e.g. `context.username` on a state with no URL username param).
  *
  * The `contextProps` allowlist is the key safety mechanism: only fields the machine
  * explicitly opts in to are ever exposed to components.
  *
- * @param routeParams - Extracted URL path parameters from `context.routeParams`.
+ * @param urlParams - Extracted URL path parameters from `context.params`.
  * @param contextValues - Object containing only the allowlisted context fields.
  * @param existingProps - The element's props as declared in the machine spec.
  * @returns Merged props object with URL params and allowlisted context values filling
@@ -94,16 +109,16 @@ const resolveViewMeta = (meta) => {
  * @example
  * ```ts
  * // spec:          { section: undefined, username: undefined, title: "Dashboard" }
- * // routeParams:   { section: "profile" }            ← from URL /:section
+ * // urlParams:     { section: "profile" }            ← from URL /:section
  * // contextValues: { username: "alice" }              ← from contextProps: ["username"]
  * // result:        { section: "profile", username: "alice", title: "Dashboard" }
  * ```
  */
-function mergeRouteParamsIntoProps(routeParams, contextValues, existingProps) {
+function mergeRouteParamsIntoProps(urlParams, contextValues, existingProps) {
     // Layer 3 (lowest priority): allowlisted context values
     const merged = { ...contextValues };
-    // Layer 2: route params override context values for the same key
-    for (const [k, v] of Object.entries(routeParams)) {
+    // Layer 2: URL params override context values for the same key
+    for (const [k, v] of Object.entries(urlParams)) {
         merged[k] = v;
     }
     // Layer 1 (highest priority): explicit non-undefined spec props always win
@@ -125,7 +140,7 @@ function mergeRouteParamsIntoProps(routeParams, contextValues, existingProps) {
  *
  * Each spec element's `props` are enriched before the view is emitted using two sources:
  *
- * **1. URL route params** (`context.routeParams`, populated by `formatPlayRouteTransitions`):
+ * **1. URL route params** (`context.params`, populated by `formatPlayRouteTransitions`):
  * Makes `:section?` / `:username` URL path parameters automatically available as component
  * props without manual wiring.
  *
@@ -136,7 +151,7 @@ function mergeRouteParamsIntoProps(routeParams, contextValues, existingProps) {
  *
  * Merge priority (see `mergeRouteParamsIntoProps`):
  * 1. Explicit non-`undefined` spec prop — always wins (authoritative static value).
- * 2. URL route param (`context.routeParams`) — fills `undefined` slots from the URL path.
+ * 2. URL route param (`context.params`) — fills `undefined` slots from the URL path.
  * 3. Allowlisted context field (`contextProps`) — fills remaining `undefined` slots.
  *
  * @param snapshot - Current XState machine snapshot.
@@ -145,12 +160,12 @@ function mergeRouteParamsIntoProps(routeParams, contextValues, existingProps) {
  * @example
  * ```ts
  * // spec: { contextProps: ["username"], elements: { root: { props: { username: undefined } } } }
- * // context.username = "alice", routeParams = {}
+ * // context.username = "alice", context.params = {}
  * // Derived props: { username: "alice" }
  *
  * // spec: { contextProps: ["username"], elements: { root: { props: { username: undefined } } } }
- * // context.username = "alice", routeParams = { username: "demo" }
- * // Derived props: { username: "demo" }  ← routeParams wins
+ * // context.username = "alice", context.params = { username: "demo" }
+ * // Derived props: { username: "demo" }  ← URL param wins
  * ```
  */
 const deriveCurrentView = (snapshot) => {
@@ -165,14 +180,14 @@ const deriveCurrentView = (snapshot) => {
     if (!viewMeta) {
         return null;
     }
-    // Extract routeParams from context (set by formatPlayRouteTransitions on play.route events)
+    // Extract params from context (set by formatPlayRouteTransitions on play.route events)
     const context = snapshot.context !== null &&
         snapshot.context !== undefined &&
         typeof snapshot.context === "object"
         ? snapshot.context
         : null;
-    const routeParams = context !== null && typeof context.routeParams === "object" && context.routeParams !== null
-        ? context.routeParams
+    const urlParams = context !== null && typeof context.params === "object" && context.params !== null
+        ? context.params
         : {};
     // Extract the allowlisted context fields declared in spec.contextProps.
     // Only fields explicitly named in the allowlist are ever exposed to components.
@@ -194,7 +209,7 @@ const deriveCurrentView = (snapshot) => {
                 key,
                 {
                     ...element,
-                    props: mergeRouteParamsIntoProps(routeParams, contextValues, existingProps),
+                    props: mergeRouteParamsIntoProps(urlParams, contextValues, existingProps),
                 },
             ];
         }));
@@ -317,8 +332,15 @@ export class PlayerActor extends AbstractActor {
      * (non-initial URL → router wins) from a restore (initial URL + actor at a
      * different restored route → actor wins).
      *
-     * This value is intentionally derived from a fresh, non-restored machine snapshot,
-     * never from the runtime actor snapshot passed via `restore?.snapshot`.
+     * Determined by the machine's initial state node and its `meta.route` template —
+     * both are fixed at machine definition time. `definePlayer` pre-computes this value
+     * once from the machine definition and passes it to every actor it constructs, so no
+     * extra `createActor()` call is needed per construction.
+     *
+     * When `PlayerActor` is constructed directly (without `definePlayer`), the value is
+     * derived from `xstateActor.getSnapshot()` (normal path) or a transient
+     * `createActor(machine, { input })` call (restore path, to avoid using the
+     * snapshot's state instead of the machine's default).
      */
     initialRoute;
     /**
@@ -330,7 +352,7 @@ export class PlayerActor extends AbstractActor {
      * detect changes.
      *
      * The emitted `ViewMetadata` has its spec element `props` enriched with
-     * `context.routeParams` before emission — URL path parameters (e.g. `:section?`)
+     * `context.params` before emission — URL path parameters (e.g. `:section?`)
      * flow into component props automatically. See `mergeRouteParamsIntoProps` for the
      * merge priority rules.
      *
@@ -346,7 +368,17 @@ export class PlayerActor extends AbstractActor {
      * ```
      */
     currentView;
-    constructor(machine, options, input, snapshot) {
+    constructor(machine, options, input, snapshot, 
+    /**
+     * Pre-computed initial route from `definePlayer`.
+     * `initialRoute` is determined by the machine's initial state node and its
+     * `meta.route` template — both fixed at machine definition time regardless
+     * of `input` or `snapshot`. When provided, used directly on every construction,
+     * eliminating a redundant `createActor()` call per actor instance.
+     *
+     * @internal — set by `definePlayer`; callers should not pass this directly.
+     */
+    _cachedInitialRoute) {
         // Defensive check: Validate machine before passing to createActor
         if (!machine || typeof machine !== "object") {
             throw new Error("PlayerActor requires a valid XState machine");
@@ -360,15 +392,38 @@ export class PlayerActor extends AbstractActor {
         // Track XState typing improvements: https://github.com/statelyai/xstate/issues
         // eslint-disable-next-line @typescript-eslint/no-explicit-any
         const xstateActor = createActor(machine, { input, snapshot });
-        // Defensive check: Validate actor was created successfully
-        if (!xstateActor) {
-            throw new Error("Failed to create XState actor - machine may be null or invalid");
-        }
         // Call AbstractActor constructor with actor logic
         super(xstateActor.logic);
-        // Derive the machine's initial route from a fresh (non-restored) snapshot.
-        // createActor(machine) without options is cheap and synchronous — never started.
-        this.initialRoute = deriveCurrentRoute(createActor(machine).getSnapshot());
+        // Derive the machine's initial route for restore-vs-deeplink detection.
+        //
+        // Fast path: when `definePlayer` pre-computed the no-input initial route and no
+        // per-call `input` was provided, use the cached value directly — zero extra
+        // createActor() calls per construction.
+        //
+        // Slow path A (no cache / input provided): read from xstateActor.getSnapshot()
+        // before start() — already constructed with caller's input, free.
+        //
+        // Slow path B (restore + input): spin a minimal actor with only input (no
+        // snapshot) to get the machine's default initial state rather than the restored
+        // one, so bridges can distinguish deep-link from restore.
+        if (_cachedInitialRoute !== undefined) {
+            // Fast path — pre-computed by definePlayer from machine's initial state.
+            // initialRoute is determined solely by the machine's initial state node and
+            // its meta.route template, which are fixed at machine definition time.
+            // input/snapshot do not affect which state is initial.
+            this.initialRoute = _cachedInitialRoute;
+        }
+        else if (snapshot) {
+            // Restore path without cache — spin a minimal actor to get the default initial
+            // state (not the snapshot state) so bridges can distinguish deeplink from restore.
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const initialActor = createActor(machine, { input });
+            this.initialRoute = deriveCurrentRoute(initialActor.getSnapshot());
+        }
+        else {
+            // Normal path without cache — xstateActor snapshot is already the initial state.
+            this.initialRoute = deriveCurrentRoute(xstateActor.getSnapshot());
+        }
         this._xstateActor = xstateActor;
         this._options = options || {};
         // Initialize state signal manager

package/dist/player-actor.js.map

@@ -1 +1 @@
-{"version":3,"file":"player-actor.js","sourceRoot":"","sources":["../src/player-actor.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,WAAW,GASX,MAAM,QAAQ,CAAC;AAChB,OAAO,EACN,aAAa,GAIb,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAEjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAExE,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEhE,MAAM,iBAAiB,GAAG,CAAC,QAAiB,EAAkC,EAAE;IAC/E,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC/C,OAAO,KAAK,CAAC;IACd,CAAC;IAED,IAAI,CAAC,CAAC,QAAQ,IAAI,QAAQ,CAAC,EAAE,CAAC;QAC7B,OAAO,KAAK,CAAC;IACd,CAAC;IAED,OAAO,OAAQ,QAAgC,CAAC,MAAM,KAAK,QAAQ,CAAC;AACrE,CAAC,CAAC;AAEF,MAAM,gBAAgB,GAAG,CAAC,QAAiB,EAAW,EAAE;IACvD,OAAO,iBAAiB,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,MAAM,KAAK,QAAQ,CAAC;AACpE,CAAC,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,kBAAkB,GAAG,CAAC,QAA4B,EAAiB,EAAE;IAC1E,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;QACzD,OAAO,IAAI,CAAC;IACb,CAAC;IAED,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,EAAE,CAAC;IAChC,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QACvC,OAAO,IAAI,CAAC;IACb,CAAC;IAED,MAAM,aAAa,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IACxC,IAAI,CAAC,aAAa,EAAE,CAAC;QACpB,OAAO,IAAI,CAAC;IACb,CAAC;IAED,IAAI,CAAC;QACJ,OAAO,aAAa,CAAC,aAAa,EAAE,QAAQ,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;IAC7D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,kFAAkF;QAClF,mFAAmF;QACnF,0EAA0E;QAC1E,wEAAwE;QACxE,IAAI,KAAK,YAAY,sBAAsB,EAAE,CAAC;YAC7C,OAAO,IAAI,CAAC;QACb,CAAC;QACD,MAAM,KAAK,CAAC;IACb,CAAC;AACF,CAAC,CAAC;AAEF,MAAM,eAAe,GAAG,CAAC,IAA6B,EAAuB,EAAE;IAC9E,KAAK,MAAM,SAAS,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7C,MAAM,SAAS,GACd,SAAS,IAAI,OAAO,SAAS,KAAK,QAAQ;YACzC,CAAC,CAAE,SAAgC,CAAC,IAAI;YACxC,CAAC,CAAC,SAAS,CAAC;QAEd,IAAI,SAAS,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;YAChD,OAAO,SAAyB,CAAC;QAClC,CAAC;IACF,CAAC;IAED,OAAO,IAAI,CAAC;AACb,CAAC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,SAAS,yBAAyB,CACjC,WAAmC,EACnC,aAAsC,EACtC,aAAsC;IAEtC,wDAAwD;IACxD,MAAM,MAAM,GAA4B,EAAE,GAAG,aAAa,EAAE,CAAC;IAC7D,iEAAiE;IACjE,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;QAClD,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACf,CAAC;IACD,2EAA2E;IAC3E,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC;QACpD,IAAI,CAAC,KAAK,SAAS;YAAE,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACpC,CAAC;IACD,OAAO,MAAM,CAAC;AACf,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,MAAM,iBAAiB,GAAG,CAAC,QAA4B,EAAuB,EAAE;IAC/E,IAAI,CAAC,QAAQ,EAAE,CAAC;QACf,OAAO,IAAI,CAAC;IACb,CAAC;IAED,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,EAAE,CAAC;IAChC,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QACvC,OAAO,IAAI,CAAC;IACb,CAAC;IAED,MAAM,QAAQ,GAAG,eAAe,CAAC,IAA+B,CAAC,CAAC;IAClE,IAAI,CAAC,QAAQ,EAAE,CAAC;QACf,OAAO,IAAI,CAAC;IACb,CAAC;IAED,4FAA4F;IAC5F,MAAM,OAAO,GACZ,QAAQ,CAAC,OAAO,KAAK,IAAI;QACzB,QAAQ,CAAC,OAAO,KAAK,SAAS;QAC9B,OAAO,QAAQ,CAAC,OAAO,KAAK,QAAQ;QACnC,CAAC,CAAE,QAAQ,CAAC,OAAmC;QAC/C,CAAC,CAAC,IAAI,CAAC;IAET,MAAM,WAAW,GAChB,OAAO,KAAK,IAAI,IAAI,OAAO,OAAO,CAAC,WAAW,KAAK,QAAQ,IAAI,OAAO,CAAC,WAAW,KAAK,IAAI;QAC1F,CAAC,CAAE,OAAO,CAAC,WAAsC;QACjD,CAAC,CAAC,EAAE,CAAC;IAEP,wEAAwE;IACxE,gFAAgF;IAChF,MAAM,qBAAqB,GAAG,QAAQ,CAAC,IAAI,EAAE,YAAY,IAAI,EAAE,CAAC;IAChE,MAAM,aAAa,GAA4B,EAAE,CAAC;IAClD,IAAI,OAAO,KAAK,IAAI,IAAI,qBAAqB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1D,KAAK,MAAM,GAAG,IAAI,qBAAqB,EAAE,CAAC;YACzC,IAAI,GAAG,IAAI,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,SAAS,EAAE,CAAC;gBAC3E,aAAa,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;YACnC,CAAC;QACF,CAAC;IACF,CAAC;IAED,wDAAwD;IACxD,IAAI,QAAQ,CAAC,IAAI,EAAE,QAAQ,EAAE,CAAC;QAC7B,MAAM,gBAAgB,GAAG,MAAM,CAAC,WAAW,CAC1C,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAmC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE;YACnF,MAAM,OAAO,GAAG,EAA6B,CAAC;YAC9C,MAAM,aAAa,GAAI,OAAO,CAAC,KAAiC,IAAI,EAAE,CAAC;YACvE,OAAO;gBACN,GAAG;gBACH;oBACC,GAAG,OAAO;oBACV,KAAK,EAAE,yBAAyB,CAAC,WAAW,EAAE,aAAa,EAAE,aAAa,CAAC;iBAC3E;aACD,CAAC;QACH,CAAC,CAAC,CAC+B,CAAC;QAEnC,OAAO;YACN,SAAS,EAAE,QAAQ,CAAC,SAAS;YAC7B,IAAI,EAAE,EAAE,GAAG,QAAQ,CAAC,IAAI,EAAE,QAAQ,EAAE,gBAAgB,EAAE;SACtD,CAAC;IACH,CAAC;IAED,OAAO;QACN,SAAS,EAAE,QAAQ,CAAC,SAAS;QAC7B,IAAI,EAAE,QAAQ,CAAC,IAAI;KACnB,CAAC;AACH,CAAC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0EG;AACH,MAAM,OAAO,WACZ,SAAQ,aAAsD;IAGtD,YAAY,CAAkB;IAC9B,aAAa,CAAyC;IACtD,QAAQ,CAA0B;IAClC,WAAW,CAAoC;IAEvD,sCAAsC;IAC/B,KAAK,CAAmC;IAE/C;;;;;;;;;;;;;;;;;OAiBG;IACI,YAAY,CAAiC;IAEpD;;;;;;;;;;OAUG;IACa,YAAY,CAAgB;IAE5C;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACI,WAAW,CAAoC;IAEtD,YACC,OAAiB,EACjB,OAAgC,EAChC,KAA2B,EAC3B,QAAiC;QAEjC,kEAAkE;QAClE,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;YAC7C,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;QAChE,CAAC;QAED,sBAAsB;QACtB,yFAAyF;QACzF,2EAA2E;QAC3E,sFAAsF;QACtF,uFAAuF;QACvF,8EAA8E;QAC9E,+EAA+E;QAC/E,8DAA8D;QAC9D,MAAM,WAAW,GAAG,WAAW,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,QAAQ,EAA4B,CAAC,CAAC;QAExF,2DAA2D;QAC3D,IAAI,CAAC,WAAW,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,gEAAgE,CAAC,CAAC;QACnF,CAAC;QAED,kDAAkD;QAClD,KAAK,CAAC,WAAW,CAAC,KAAsB,CAAC,CAAC;QAE1C,2EAA2E;QAC3E,iFAAiF;QACjF,IAAI,CAAC,YAAY,GAAG,kBAAkB,CACrC,WAAW,CAAC,OAAO,CAAC,CAAC,WAAW,EAAwB,CACxD,CAAC;QAEF,IAAI,CAAC,YAAY,GAAG,WAAW,CAAC;QAChC,IAAI,CAAC,QAAQ,GAAG,OAAO,IAAI,EAAE,CAAC;QAE9B,kCAAkC;QAClC,IAAI,CAAC,aAAa,GAAG,IAAI,kBAAkB,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC,CAAC;QACvE,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC;QAEvC,yBAAyB;QACzB,IAAI,CAAC,WAAW,GAAG,IAAI,MAAM,CAAC,KAAK,CAAsB,IAAI,CAAC,CAAC;QAE/D,0CAA0C;QAC1C,IAAI,CAAC,YAAY,GAAG,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE;YAC5C,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;YAClC,OAAO,kBAAkB,CAAC,QAAQ,CAAC,CAAC;QACrC,CAAC,CAAC,CAAC;QAEH,6DAA6D;QAC7D,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;QAEpC,wCAAwC;QACxC,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,QAAQ,EAAE,EAAE;YACxC,qDAAqD;YACrD,IAAI,gBAAgB,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAChC,mFAAmF;gBACnF,IAAI,CAAC,aAAa,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;gBAE5C,kFAAkF;gBAClF,gCAAgC;gBAChC,gCAAgC;gBAChC,wBAAwB;gBACxB,wBAAwB;gBACxB,sCAAsC;gBACtC,IAAI,CAAC,qBAAqB,CAAC,QAAQ,CAAC,CAAC;gBAErC,0BAA0B;gBAC1B,IAAI,IAAI,CAAC,QAAQ,CAAC,aAAa,EAAE,CAAC;oBACjC,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;gBAC7C,CAAC;YACF,CAAC;QACF,CAAC,CAAC,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACM,KAAK;QACb,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;QAE1B,oBAAoB;QACpB,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;YAC3B,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC7B,CAAC;QAED,OAAO,IAAI,CAAC;IACb,CAAC;IAED;;OAEG;IACM,IAAI;QACZ,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;QACzB,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,CAAC;QAE7B,mBAAmB;QACnB,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;YAC1B,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC5B,CAAC;QAED,OAAO,IAAI,CAAC;IACb,CAAC;IAED;;;;;;;;;;;;;;;;;;;OAmBG;IACM,IAAI,CAAC,KAA+B;QAC5C,wDAAwD;QACxD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YACzC,MAAM,IAAI,iBAAiB,CAAC,KAAK,CAAC,CAAC;QACpC,CAAC;QAED,6CAA6C;QAC7C,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC;QAErD,uBAAuB;QACvB,uFAAuF;QACvF,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAE9B,yBAAyB;QACzB,IAAI,IAAI,CAAC,QAAQ,CAAC,YAAY,EAAE,CAAC;YAChC,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC;YACrD,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,EAAE,YAAY,EAAE,YAAY,CAAC,CAAC;QAC9D,CAAC;IACF,CAAC;IAED;;OAEG;IACM,WAAW;QACnB,OAAO,IAAI,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC;IACxC,CAAC;IAED;;;;;;;OAOG;IACK,qBAAqB,CAAC,QAA4B;QACzD,IAAI,CAAC;YACJ,MAAM,IAAI,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;YAEzC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC5B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;gBAC3B,MAAM,GAAG,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;gBACtE,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;YAClC,CAAC;YACD,mDAAmD;QACpD,CAAC;IACF,CAAC;IAED;;;;OAIG;IACH,OAAO;QACN,IAAI,CAAC,IAAI,EAAE,CAAC;IACb,CAAC;CACD"}
+{"version":3,"file":"player-actor.js","sourceRoot":"","sources":["../src/player-actor.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,WAAW,GASX,MAAM,QAAQ,CAAC;AAChB,OAAO,EACN,aAAa,GAIb,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAEjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAExE,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGhE,MAAM,iBAAiB,GAAG,CAAC,QAAiB,EAAkC,EAAE;IAC/E,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC/C,OAAO,KAAK,CAAC;IACd,CAAC;IAED,IAAI,CAAC,CAAC,QAAQ,IAAI,QAAQ,CAAC,EAAE,CAAC;QAC7B,OAAO,KAAK,CAAC;IACd,CAAC;IAED,OAAO,OAAQ,QAAgC,CAAC,MAAM,KAAK,QAAQ,CAAC;AACrE,CAAC,CAAC;AAEF,MAAM,gBAAgB,GAAG,CAAC,QAAiB,EAAW,EAAE;IACvD,OAAO,iBAAiB,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,MAAM,KAAK,QAAQ,CAAC;AACpE,CAAC,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,oEAAoE;AACpE,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,QAA4B,EAAiB,EAAE;IACjF,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;QACzD,OAAO,IAAI,CAAC;IACb,CAAC;IAED,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,EAAE,CAAC;IAChC,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QACvC,OAAO,IAAI,CAAC;IACb,CAAC;IAED,MAAM,aAAa,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IACxC,IAAI,CAAC,aAAa,EAAE,CAAC;QACpB,OAAO,IAAI,CAAC;IACb,CAAC;IAED,IAAI,CAAC;QACJ,OAAO,aAAa,CAAC,aAAa,EAAE,CAAC,QAAQ,CAAC,OAAO,IAAI,EAAE,CAAiB,CAAC,CAAC;IAC/E,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,uFAAuF;QACvF,qFAAqF;QACrF,qFAAqF;QACrF,yCAAyC;QACzC,uFAAuF;QACvF,yFAAyF;QACzF,oFAAoF;QACpF,+DAA+D;QAC/D,wFAAwF;QACxF,4EAA4E;QAC5E,IAAI,KAAK,YAAY,sBAAsB,EAAE,CAAC;YAC7C,OAAO,IAAI,CAAC;QACb,CAAC;QACD,8EAA8E;QAC9E,+EAA+E;QAC/E,kFAAkF;QAClF,8EAA8E;QAC9E,iFAAiF;QACjF,gCAAgC;QAChC,EAAE;QACF,uDAAuD;QACvD,MAAM,KAAK,CAAC;IACb,CAAC;AACF,CAAC,CAAC;AAEF,MAAM,eAAe,GAAG,CAAC,IAA6B,EAAuB,EAAE;IAC9E,KAAK,MAAM,SAAS,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7C,MAAM,SAAS,GACd,SAAS,IAAI,OAAO,SAAS,KAAK,QAAQ;YACzC,CAAC,CAAE,SAAgC,CAAC,IAAI;YACxC,CAAC,CAAC,SAAS,CAAC;QAEd,IAAI,SAAS,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;YAChD,OAAO,SAAyB,CAAC;QAClC,CAAC;IACF,CAAC;IAED,OAAO,IAAI,CAAC;AACb,CAAC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,SAAS,yBAAyB,CACjC,SAAiC,EACjC,aAAsC,EACtC,aAAsC;IAEtC,wDAAwD;IACxD,MAAM,MAAM,GAA4B,EAAE,GAAG,aAAa,EAAE,CAAC;IAC7D,+DAA+D;IAC/D,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QAChD,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACf,CAAC;IACD,2EAA2E;IAC3E,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC;QACpD,IAAI,CAAC,KAAK,SAAS;YAAE,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACpC,CAAC;IACD,OAAO,MAAM,CAAC;AACf,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,MAAM,iBAAiB,GAAG,CAAC,QAA4B,EAAuB,EAAE;IAC/E,IAAI,CAAC,QAAQ,EAAE,CAAC;QACf,OAAO,IAAI,CAAC;IACb,CAAC;IAED,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,EAAE,CAAC;IAChC,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QACvC,OAAO,IAAI,CAAC;IACb,CAAC;IAED,MAAM,QAAQ,GAAG,eAAe,CAAC,IAA+B,CAAC,CAAC;IAClE,IAAI,CAAC,QAAQ,EAAE,CAAC;QACf,OAAO,IAAI,CAAC;IACb,CAAC;IAED,uFAAuF;IACvF,MAAM,OAAO,GACZ,QAAQ,CAAC,OAAO,KAAK,IAAI;QACzB,QAAQ,CAAC,OAAO,KAAK,SAAS;QAC9B,OAAO,QAAQ,CAAC,OAAO,KAAK,QAAQ;QACnC,CAAC,CAAE,QAAQ,CAAC,OAAmC;QAC/C,CAAC,CAAC,IAAI,CAAC;IAET,MAAM,SAAS,GACd,OAAO,KAAK,IAAI,IAAI,OAAO,OAAO,CAAC,MAAM,KAAK,QAAQ,IAAI,OAAO,CAAC,MAAM,KAAK,IAAI;QAChF,CAAC,CAAE,OAAO,CAAC,MAAiC;QAC5C,CAAC,CAAC,EAAE,CAAC;IAEP,wEAAwE;IACxE,gFAAgF;IAChF,MAAM,qBAAqB,GAAG,QAAQ,CAAC,IAAI,EAAE,YAAY,IAAI,EAAE,CAAC;IAChE,MAAM,aAAa,GAA4B,EAAE,CAAC;IAClD,IAAI,OAAO,KAAK,IAAI,IAAI,qBAAqB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1D,KAAK,MAAM,GAAG,IAAI,qBAAqB,EAAE,CAAC;YACzC,IAAI,GAAG,IAAI,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,SAAS,EAAE,CAAC;gBAC3E,aAAa,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;YACnC,CAAC;QACF,CAAC;IACF,CAAC;IAED,wDAAwD;IACxD,IAAI,QAAQ,CAAC,IAAI,EAAE,QAAQ,EAAE,CAAC;QAC7B,MAAM,gBAAgB,GAAG,MAAM,CAAC,WAAW,CAC1C,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAmC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE;YACnF,MAAM,OAAO,GAAG,EAA6B,CAAC;YAC9C,MAAM,aAAa,GAAI,OAAO,CAAC,KAAiC,IAAI,EAAE,CAAC;YACvE,OAAO;gBACN,GAAG;gBACH;oBACC,GAAG,OAAO;oBACV,KAAK,EAAE,yBAAyB,CAAC,SAAS,EAAE,aAAa,EAAE,aAAa,CAAC;iBACzE;aACD,CAAC;QACH,CAAC,CAAC,CAC+B,CAAC;QAEnC,OAAO;YACN,SAAS,EAAE,QAAQ,CAAC,SAAS;YAC7B,IAAI,EAAE,EAAE,GAAG,QAAQ,CAAC,IAAI,EAAE,QAAQ,EAAE,gBAAgB,EAAE;SACtD,CAAC;IACH,CAAC;IAED,OAAO;QACN,SAAS,EAAE,QAAQ,CAAC,SAAS;QAC7B,IAAI,EAAE,QAAQ,CAAC,IAAI;KACnB,CAAC;AACH,CAAC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0EG;AACH,MAAM,OAAO,WACZ,SAAQ,aAAsD;IAGtD,YAAY,CAAkB;IAC9B,aAAa,CAAyC;IACtD,QAAQ,CAA0B;IAClC,WAAW,CAAoC;IAEvD,sCAAsC;IAC/B,KAAK,CAAmC;IAE/C;;;;;;;;;;;;;;;;;OAiBG;IACI,YAAY,CAAiC;IAEpD;;;;;;;;;;;;;;;;;OAiBG;IACa,YAAY,CAAgB;IAE5C;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACI,WAAW,CAAoC;IAEtD,YACC,OAAiB,EACjB,OAAgC,EAChC,KAA2B,EAC3B,QAAiC;IACjC;;;;;;;;OAQG;IACH,mBAAmC;QAEnC,kEAAkE;QAClE,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;YAC7C,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;QAChE,CAAC;QAED,sBAAsB;QACtB,yFAAyF;QACzF,2EAA2E;QAC3E,sFAAsF;QACtF,uFAAuF;QACvF,8EAA8E;QAC9E,+EAA+E;QAC/E,8DAA8D;QAC9D,MAAM,WAAW,GAAG,WAAW,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,QAAQ,EAA4B,CAAC,CAAC;QAExF,kDAAkD;QAClD,KAAK,CAAC,WAAW,CAAC,KAAsB,CAAC,CAAC;QAE1C,wEAAwE;QACxE,EAAE;QACF,gFAAgF;QAChF,4EAA4E;QAC5E,wCAAwC;QACxC,EAAE;QACF,+EAA+E;QAC/E,kEAAkE;QAClE,EAAE;QACF,0EAA0E;QAC1E,gFAAgF;QAChF,0DAA0D;QAC1D,IAAI,mBAAmB,KAAK,SAAS,EAAE,CAAC;YACvC,yEAAyE;YACzE,4EAA4E;YAC5E,uEAAuE;YACvE,uDAAuD;YACvD,IAAI,CAAC,YAAY,GAAG,mBAAmB,CAAC;QACzC,CAAC;aAAM,IAAI,QAAQ,EAAE,CAAC;YACrB,+EAA+E;YAC/E,mFAAmF;YACnF,8DAA8D;YAC9D,MAAM,YAAY,GAAG,WAAW,CAAC,OAAO,EAAE,EAAE,KAAK,EAA4B,CAAC,CAAC;YAC/E,IAAI,CAAC,YAAY,GAAG,kBAAkB,CACrC,YAAY,CAAC,WAAW,EAAwB,CAChD,CAAC;QACH,CAAC;aAAM,CAAC;YACP,iFAAiF;YACjF,IAAI,CAAC,YAAY,GAAG,kBAAkB,CAAC,WAAW,CAAC,WAAW,EAAwB,CAAC,CAAC;QACzF,CAAC;QAED,IAAI,CAAC,YAAY,GAAG,WAAW,CAAC;QAChC,IAAI,CAAC,QAAQ,GAAG,OAAO,IAAI,EAAE,CAAC;QAE9B,kCAAkC;QAClC,IAAI,CAAC,aAAa,GAAG,IAAI,kBAAkB,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC,CAAC;QACvE,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC;QAEvC,yBAAyB;QACzB,IAAI,CAAC,WAAW,GAAG,IAAI,MAAM,CAAC,KAAK,CAAsB,IAAI,CAAC,CAAC;QAE/D,0CAA0C;QAC1C,IAAI,CAAC,YAAY,GAAG,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE;YAC5C,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;YAClC,OAAO,kBAAkB,CAAC,QAAQ,CAAC,CAAC;QACrC,CAAC,CAAC,CAAC;QAEH,6DAA6D;QAC7D,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;QAEpC,wCAAwC;QACxC,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,QAAQ,EAAE,EAAE;YACxC,qDAAqD;YACrD,IAAI,gBAAgB,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAChC,mFAAmF;gBACnF,IAAI,CAAC,aAAa,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;gBAE5C,kFAAkF;gBAClF,gCAAgC;gBAChC,gCAAgC;gBAChC,wBAAwB;gBACxB,wBAAwB;gBACxB,sCAAsC;gBACtC,IAAI,CAAC,qBAAqB,CAAC,QAAQ,CAAC,CAAC;gBAErC,0BAA0B;gBAC1B,IAAI,IAAI,CAAC,QAAQ,CAAC,aAAa,EAAE,CAAC;oBACjC,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;gBAC7C,CAAC;YACF,CAAC;QACF,CAAC,CAAC,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACM,KAAK;QACb,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;QAE1B,oBAAoB;QACpB,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;YAC3B,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC7B,CAAC;QAED,OAAO,IAAI,CAAC;IACb,CAAC;IAED;;OAEG;IACM,IAAI;QACZ,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;QACzB,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,CAAC;QAE7B,mBAAmB;QACnB,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;YAC1B,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC5B,CAAC;QAED,OAAO,IAAI,CAAC;IACb,CAAC;IAED;;;;;;;;;;;;;;;;;;;OAmBG;IACM,IAAI,CAAC,KAA+B;QAC5C,wDAAwD;QACxD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YACzC,MAAM,IAAI,iBAAiB,CAAC,KAAK,CAAC,CAAC;QACpC,CAAC;QAED,6CAA6C;QAC7C,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC;QAErD,uBAAuB;QACvB,uFAAuF;QACvF,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAE9B,yBAAyB;QACzB,IAAI,IAAI,CAAC,QAAQ,CAAC,YAAY,EAAE,CAAC;YAChC,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC;YACrD,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,EAAE,YAAY,EAAE,YAAY,CAAC,CAAC;QAC9D,CAAC;IACF,CAAC;IAED;;OAEG;IACM,WAAW;QACnB,OAAO,IAAI,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC;IACxC,CAAC;IAED;;;;;;;OAOG;IACK,qBAAqB,CAAC,QAA4B;QACzD,IAAI,CAAC;YACJ,MAAM,IAAI,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;YAEzC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC5B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;gBAC3B,MAAM,GAAG,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;gBACtE,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;YAClC,CAAC;YACD,mDAAmD;QACpD,CAAC;IACF,CAAC;IAED;;;;OAIG;IACH,OAAO;QACN,IAAI,CAAC,IAAI,EAAE,CAAC;IACb,CAAC;CACD"}

package/dist/routing/build-url.d.ts

@@ -2,31 +2,36 @@ import type { RouteContext } from "./types.js";
 /**
  * Build a full URL from a route template and the actor's context.
  *
- * Substitutes `:param` and `:param?` placeholders from `context.routeParams`
- * or flat `context` values, then appends query params and hash fragments.
+ * Substitutes `:param` and `:param?` placeholders from `context.params`,
+ * then appends query params and hash fragments.
  *
- * Parameter lookup order for each placeholder:
- * 1. `context.routeParams[param]` — preferred when the state machine stores
- *    route parameters in a dedicated sub-object
- * 2. `context[param]` — flat context fallback
+ * All parameter values must be in `context.params`. Flat context fields are not
+ * inspected — this is intentional so misspelled placeholders produce a compile-time
+ * error rather than silently resolving to `undefined`.
  *
  * @param routeTemplate - Route path template, e.g. `"/profile/:userId"` or
  *   `"/settings/:section?"`.
- * @param context - Actor context object containing parameter values, optional
- *   `query` record, optional `hash` string, and optional `basePath` prefix.
+ * @param context - Actor context object. Route parameters must be in `context.params`;
+ *   flat context fields are not inspected. **Must include a `query` field** (use `query: {}`
+ *   when no query parameters are needed). Omitting `query` when `params` is present throws
+ *   `MissingQueryContextError` to prevent silent query-string loss.
  * @returns The fully resolved URL string.
  *
  * @throws {MissingRouteParamError} When a **required** `:param` placeholder has no
  *   matching value in context. Optional parameters (`:param?`) are silently omitted
  *   when missing. Import the class from `@xmachines/play-xstate/errors`.
+ * @throws {MissingQueryContextError} When the context has a `params` field but no
+ *   `query` field. This indicates a routing-aware machine context that was not set up
+ *   to receive query parameters, which would silently drop query params from
+ *   `play.route` events. Import the class from `@xmachines/play-xstate/errors`.
  *
  * @example
  * ```typescript
- * buildRouteUrl("/user/:id", { id: "123", query: { tab: "profile" }, hash: "top" });
+ * buildRouteUrl("/user/:id", { params: { id: "123" }, query: { tab: "profile" }, hash: "top" });
  * // → "/user/123?tab=profile#top"
  *
- * buildRouteUrl("/settings/:section?", {});
- * // → "/settings"  (optional param omitted)
+ * buildRouteUrl("/settings/:section?", { params: {}, query: {} });
+ * // → "/settings"  (optional param omitted, no query string)
  * ```
  */
 export declare const buildRouteUrl: (routeTemplate: string, context?: RouteContext) => string;

package/dist/routing/build-url.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build-url.d.ts","sourceRoot":"","sources":["../../src/routing/build-url.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAI/C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,eAAO,MAAM,aAAa,GAAI,eAAe,MAAM,EAAE,UAAS,YAAiB,KAAG,MA6BjF,CAAC"}
+{"version":3,"file":"build-url.d.ts","sourceRoot":"","sources":["../../src/routing/build-url.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAI/C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,eAAO,MAAM,aAAa,GACzB,eAAe,MAAM,EACrB,UAAS,YAA4B,KACnC,MAsCF,CAAC"}

package/dist/routing/build-url.js

@@ -1,36 +1,49 @@
 import { isAbsoluteRoute } from "./derive-route.js";
-import { MissingRouteParamError } from "../errors.js";
+import { MissingRouteParamError, MissingQueryContextError } from "../errors.js";
 /**
  * Build a full URL from a route template and the actor's context.
  *
- * Substitutes `:param` and `:param?` placeholders from `context.routeParams`
- * or flat `context` values, then appends query params and hash fragments.
+ * Substitutes `:param` and `:param?` placeholders from `context.params`,
+ * then appends query params and hash fragments.
  *
- * Parameter lookup order for each placeholder:
- * 1. `context.routeParams[param]` — preferred when the state machine stores
- *    route parameters in a dedicated sub-object
- * 2. `context[param]` — flat context fallback
+ * All parameter values must be in `context.params`. Flat context fields are not
+ * inspected — this is intentional so misspelled placeholders produce a compile-time
+ * error rather than silently resolving to `undefined`.
  *
  * @param routeTemplate - Route path template, e.g. `"/profile/:userId"` or
  *   `"/settings/:section?"`.
- * @param context - Actor context object containing parameter values, optional
- *   `query` record, optional `hash` string, and optional `basePath` prefix.
+ * @param context - Actor context object. Route parameters must be in `context.params`;
+ *   flat context fields are not inspected. **Must include a `query` field** (use `query: {}`
+ *   when no query parameters are needed). Omitting `query` when `params` is present throws
+ *   `MissingQueryContextError` to prevent silent query-string loss.
  * @returns The fully resolved URL string.
  *
  * @throws {MissingRouteParamError} When a **required** `:param` placeholder has no
  *   matching value in context. Optional parameters (`:param?`) are silently omitted
  *   when missing. Import the class from `@xmachines/play-xstate/errors`.
+ * @throws {MissingQueryContextError} When the context has a `params` field but no
+ *   `query` field. This indicates a routing-aware machine context that was not set up
+ *   to receive query parameters, which would silently drop query params from
+ *   `play.route` events. Import the class from `@xmachines/play-xstate/errors`.
  *
  * @example
  * ```typescript
- * buildRouteUrl("/user/:id", { id: "123", query: { tab: "profile" }, hash: "top" });
+ * buildRouteUrl("/user/:id", { params: { id: "123" }, query: { tab: "profile" }, hash: "top" });
  * // → "/user/123?tab=profile#top"
  *
- * buildRouteUrl("/settings/:section?", {});
- * // → "/settings"  (optional param omitted)
+ * buildRouteUrl("/settings/:section?", { params: {}, query: {} });
+ * // → "/settings"  (optional param omitted, no query string)
  * ```
  */
-export const buildRouteUrl = (routeTemplate, context = {}) => {
+export const buildRouteUrl = (routeTemplate, context = { query: {} }) => {
+    // Guard: when the context has a `params` field (indicating a routing-aware machine
+    // context set up via formatPlayRouteTransitions or manually), it must also declare
+    // a `query` field. Without `query`, any query parameters from play.route events are
+    // silently dropped. Using "query" in context distinguishes an absent field from
+    // query: undefined.
+    if ("params" in context && !("query" in context)) {
+        throw new MissingQueryContextError();
+    }
     // Handle relative vs absolute paths
     const basePath = context.basePath || "";
     const isAbsolute = isAbsoluteRoute(routeTemplate);
@@ -63,11 +76,10 @@ export const buildRouteUrl = (routeTemplate, context = {}) => {
  * - Required parameters without values log warnings
  *
  * Parameter lookup:
- * - First checks context.routeParams[param] (common pattern in state machines)
- * - Falls back to context[param] (flat context)
+ * - Reads from context.params[param] exclusively. Flat context fields are not inspected.
  *
  * @param template - URL template with :param or :param? syntax
- * @param context - Context with parameter values (may have routeParams field)
+ * @param context - Context with parameter values (may have params field)
  * @returns URL with parameters substituted and double slashes cleaned
  * @throws {MissingRouteParamError} When a required route parameter is missing
  */
@@ -75,8 +87,7 @@ const substituteParams = (template, context) => {
     // Replace parameters, handling optional syntax
     let hasOptionalRemoval = false;
     const result = template.replace(/:(\w+)(\?)?/g, (_match, param, optional) => {
-        // Check routeParams first (common pattern), then flat context
-        const value = context.routeParams?.[param] ?? context[param];
+        const value = context.params?.[param];
         // Parameter has a non-empty value - substitute it
         // For optional params, treat empty string as "no value"
         if (value !== undefined && value !== null && value !== "") {

package/dist/routing/build-url.js.map

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

package/dist/routing/format-play-route-transitions.d.ts

@@ -59,7 +59,7 @@ export type RouteMachineConfig = {
  * This automatically generates play.route handlers at the root level that:
  * - Match event.to against state IDs (e.g., event.to === "#home")
  * - Target the appropriate state
- * - Assign routeParams and queryParams from the event to context
+ * - Assign params and query from the event to context
  *
  * @param machineConfig - XState machine config (before createMachine). Must extend `RouteMachineConfig`.
  * @returns The same machine config with auto-generated `play.route` handlers merged in, preserving the original type `T`.

package/dist/routing/format-play-route-transitions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"format-play-route-transitions.d.ts","sourceRoot":"","sources":["../../src/routing/format-play-route-transitions.ts"],"names":[],"mappings":"AAYA;;;;;;;GAOG;AACH,MAAM,MAAM,cAAc,GAAG;IAC5B,iHAAiH;IACjH,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,iEAAiE;IACjE,IAAI,CAAC,EAAE;QACN,gFAAgF;QAChF,KAAK,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;IACF,kFAAkF;IAClF,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACxC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACvB,CAAC;AASF;;;;;;;;;;GAUG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAChC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IAC7C,EAAE,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IACzC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACvB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,0BAA0B,CAAC,CAAC,SAAS,kBAAkB,EAAE,aAAa,EAAE,CAAC,GAAG,CAAC,CAiD5F"}
+{"version":3,"file":"format-play-route-transitions.d.ts","sourceRoot":"","sources":["../../src/routing/format-play-route-transitions.ts"],"names":[],"mappings":"AAIA;;;;;;;GAOG;AACH,MAAM,MAAM,cAAc,GAAG;IAC5B,iHAAiH;IACjH,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,iEAAiE;IACjE,IAAI,CAAC,EAAE;QACN,gFAAgF;QAChF,KAAK,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;IACF,kFAAkF;IAClF,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACxC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACvB,CAAC;AAaF;;;;;;;;;;GAUG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAChC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IAC7C,EAAE,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IACzC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACvB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,0BAA0B,CAAC,CAAC,SAAS,kBAAkB,EAAE,aAAa,EAAE,CAAC,GAAG,CAAC,CAqD5F"}

package/dist/routing/format-play-route-transitions.js

@@ -1,4 +1,5 @@
 import { assign } from "xstate";
+import { MissingStateIdError } from "../errors.js";
 /**
  * Formats play.route transitions from declarative route configs
  *
@@ -23,7 +24,7 @@ import { assign } from "xstate";
  * This automatically generates play.route handlers at the root level that:
  * - Match event.to against state IDs (e.g., event.to === "#home")
  * - Target the appropriate state
- * - Assign routeParams and queryParams from the event to context
+ * - Assign params and query from the event to context
  *
  * @param machineConfig - XState machine config (before createMachine). Must extend `RouteMachineConfig`.
  * @returns The same machine config with auto-generated `play.route` handlers merged in, preserving the original type `T`.
@@ -36,14 +37,17 @@ export function formatPlayRouteTransitions(machineConfig) {
             // Build the full key-based path from the root for the transition target
             // (XState targets use the state key hierarchy, not explicit IDs)
             const statePath = parentPath ? `${parentPath}.${key}` : key;
+            if (node.meta?.route && !node.id) {
+                throw new MissingStateIdError(key, node.meta.route);
+            }
             if (node.meta?.route && node.id) {
                 const transition = {
                     target: `.${statePath}`,
                     guard: ({ event }) => event.to === `#${node.id}`,
                     reenter: true,
                     actions: assign({
-                        routeParams: ({ event }) => event.params || {},
-                        queryParams: ({ event }) => event.query || {},
+                        params: ({ event }) => event.params || {},
+                        query: ({ event }) => event.query || {},
                     }),
                 };
                 routeTransitions.push(transition);

package/dist/routing/format-play-route-transitions.js.map

@@ -1 +1 @@
-{"version":3,"file":"format-play-route-transitions.js","sourceRoot":"","sources":["../../src/routing/format-play-route-transitions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AA0DhC;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,UAAU,0BAA0B,CAA+B,aAAgB;IACxF,MAAM,gBAAgB,GAAsB,EAAE,CAAC;IAE/C,MAAM,aAAa,GAAG,CAAC,MAA+B,EAAE,UAAU,GAAG,EAAE,EAAE,EAAE;QAC1E,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,WAAW,CAAC,EAAE,EAAE;YACrD,MAAM,IAAI,GAAG,WAA6B,CAAC;YAC3C,wEAAwE;YACxE,iEAAiE;YACjE,MAAM,SAAS,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,UAAU,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;YAE5D,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;gBACjC,MAAM,UAAU,GAAoB;oBACnC,MAAM,EAAE,IAAI,SAAS,EAAE;oBACvB,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,IAAI,IAAI,CAAC,EAAE,EAAE;oBAChD,OAAO,EAAE,IAAI;oBACb,OAAO,EAAE,MAAM,CAAC;wBACf,WAAW,EAAE,CAAC,EAAE,KAAK,EAAkB,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,IAAI,EAAE;wBAC9D,WAAW,EAAE,CAAC,EAAE,KAAK,EAAkB,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE;qBAC7D,CAAC;iBACF,CAAC;gBAEF,gBAAgB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACnC,CAAC;YAED,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBACjB,aAAa,CAAC,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;YACvC,CAAC;QACF,CAAC,CAAC,CAAC;IACJ,CAAC,CAAC;IAEF,MAAM,aAAa,GAAG,aAAa,CAAC,MAAM,CAAC;IAC3C,IAAI,aAAa,EAAE,CAAC;QACnB,aAAa,CAAC,aAAa,CAAC,CAAC;IAC9B,CAAC;IAED,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACjC,MAAM,UAAU,GAAG,aAAa,CAAC,EAAE,IAAI,EAAE,CAAC;QAC1C,MAAM,SAAS,GAAG;YACjB,GAAG,UAAU;YACb,YAAY,EAAE,gBAAgB;SAC9B,CAAC;QAEF,OAAO;YACN,GAAG,aAAa;YAChB,EAAE,EAAE,SAAS;SACR,CAAC;IACR,CAAC;IAED,OAAO,aAAa,CAAC;AACtB,CAAC"}
+{"version":3,"file":"format-play-route-transitions.js","sourceRoot":"","sources":["../../src/routing/format-play-route-transitions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAoDnD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,UAAU,0BAA0B,CAA+B,aAAgB;IACxF,MAAM,gBAAgB,GAAsB,EAAE,CAAC;IAE/C,MAAM,aAAa,GAAG,CAAC,MAA+B,EAAE,UAAU,GAAG,EAAE,EAAE,EAAE;QAC1E,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,WAAW,CAAC,EAAE,EAAE;YACrD,MAAM,IAAI,GAAG,WAA6B,CAAC;YAC3C,wEAAwE;YACxE,iEAAiE;YACjE,MAAM,SAAS,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,UAAU,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;YAE5D,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;gBAClC,MAAM,IAAI,mBAAmB,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,KAAe,CAAC,CAAC;YAC/D,CAAC;YAED,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;gBACjC,MAAM,UAAU,GAAoB;oBACnC,MAAM,EAAE,IAAI,SAAS,EAAE;oBACvB,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,IAAI,IAAI,CAAC,EAAE,EAAE;oBAChD,OAAO,EAAE,IAAI;oBACb,OAAO,EAAE,MAAM,CAAC;wBACf,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,IAAI,EAAE;wBACzC,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE;qBACvC,CAAC;iBACF,CAAC;gBAEF,gBAAgB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACnC,CAAC;YAED,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBACjB,aAAa,CAAC,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;YACvC,CAAC;QACF,CAAC,CAAC,CAAC;IACJ,CAAC,CAAC;IAEF,MAAM,aAAa,GAAG,aAAa,CAAC,MAAM,CAAC;IAC3C,IAAI,aAAa,EAAE,CAAC;QACnB,aAAa,CAAC,aAAa,CAAC,CAAC;IAC9B,CAAC;IAED,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACjC,MAAM,UAAU,GAAG,aAAa,CAAC,EAAE,IAAI,EAAE,CAAC;QAC1C,MAAM,SAAS,GAAG;YACjB,GAAG,UAAU;YACb,YAAY,EAAE,gBAAgB;SAC9B,CAAC;QAEF,OAAO;YACN,GAAG,aAAa;YAChB,EAAE,EAAE,SAAS;SACR,CAAC;IACR,CAAC;IAED,OAAO,aAAa,CAAC;AACtB,CAAC"}

package/dist/routing/types.d.ts

@@ -4,17 +4,24 @@ export interface RouteObject {
 }
 export type RouteMetadata = string | RouteObject;
 /**
- * Route build context from machine context
+ * Route build context from machine context.
+ *
+ * All URL parameter substitution must go through `params` — flat context fields are not
+ * inspected. This is intentional: the index signature was removed to enable compile-time
+ * validation of context shapes and IDE autocomplete on context fields.
+ *
+ * Machines using `formatPlayRouteTransitions` have `params` and `query` assigned
+ * automatically from each `play.route` event. Machines that call `buildRouteUrl` directly
+ * must populate `params` explicitly.
  */
 export interface RouteContext {
     /** Base path for relative routes */
     basePath?: string;
-    /** Route parameters to substitute */
-    routeParams?: Record<string, unknown>;
+    /** Path-only route parameters to substitute (e.g., `:userId` from `/profile/:userId`) */
+    params?: Record<string, unknown>;
     /** Query parameters */
     query?: Record<string, unknown>;
     /** Hash fragment */
     hash?: string;
-    [key: string]: unknown;
 }
 //# sourceMappingURL=types.d.ts.map

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;;GAEG;AACH,MAAM,WAAW,YAAY;IAC5B,oCAAoC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qCAAqC;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,uBAAuB;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,oBAAoB;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACvB"}
+{"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;;;;;;;;;;GAUG;AACH,MAAM,WAAW,YAAY;IAC5B,oCAAoC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yFAAyF;IACzF,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,uBAAuB;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,oBAAoB;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;CACd"}

package/dist/signals/state-signal.d.ts

@@ -26,7 +26,9 @@ export declare class StateSignalManager<TSnapshot = unknown> {
      */
     scheduleUpdate(snapshot: TSnapshot): void;
     /**
-     * Cleanup (no-op since we're synchronous now)
+     * Cleanup — currently a no-op because `StateSignalManager` holds no
+     * timers, subscriptions, or external resources. If state requiring cleanup
+     * is added in the future, implement it here before calling `stop()`.
      */
     dispose(): void;
 }

package/dist/signals/state-signal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"state-signal.d.ts","sourceRoot":"","sources":["../../src/signals/state-signal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAEjD;;;;;;;;;GASG;AACH,qBAAa,kBAAkB,CAAC,SAAS,GAAG,OAAO;IAClD,OAAO,CAAC,OAAO,CAA0B;gBAE7B,eAAe,EAAE,SAAS;IAItC;;OAEG;IACH,IAAI,MAAM,IAAI,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAEpC;IAED;;;;;;;OAOG;IACH,cAAc,CAAC,QAAQ,EAAE,SAAS,GAAG,IAAI;IAIzC;;OAEG;IACH,OAAO,IAAI,IAAI;CAGf"}
+{"version":3,"file":"state-signal.d.ts","sourceRoot":"","sources":["../../src/signals/state-signal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAEjD;;;;;;;;;GASG;AACH,qBAAa,kBAAkB,CAAC,SAAS,GAAG,OAAO;IAClD,OAAO,CAAC,OAAO,CAA0B;gBAE7B,eAAe,EAAE,SAAS;IAItC;;OAEG;IACH,IAAI,MAAM,IAAI,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAEpC;IAED;;;;;;;OAOG;IACH,cAAc,CAAC,QAAQ,EAAE,SAAS,GAAG,IAAI;IAIzC;;;;OAIG;IACH,OAAO,IAAI,IAAI;CAIf"}

package/dist/signals/state-signal.js

@@ -32,10 +32,13 @@ export class StateSignalManager {
         this._signal.set(snapshot);
     }
     /**
-     * Cleanup (no-op since we're synchronous now)
+     * Cleanup — currently a no-op because `StateSignalManager` holds no
+     * timers, subscriptions, or external resources. If state requiring cleanup
+     * is added in the future, implement it here before calling `stop()`.
      */
     dispose() {
-        // No cleanup needed for synchronous updates
+        // Intentional no-op: Signal.State has no teardown. Add cleanup here
+        // if StateSignalManager gains subscriptions or timers.
     }
 }
 //# sourceMappingURL=state-signal.js.map

package/dist/signals/state-signal.js.map

@@ -1 +1 @@
-{"version":3,"file":"state-signal.js","sourceRoot":"","sources":["../../src/signals/state-signal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAEjD;;;;;;;;;GASG;AACH,MAAM,OAAO,kBAAkB;IACtB,OAAO,CAA0B;IAEzC,YAAY,eAA0B;QACrC,IAAI,CAAC,OAAO,GAAG,IAAI,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;IAClD,CAAC;IAED;;OAEG;IACH,IAAI,MAAM;QACT,OAAO,IAAI,CAAC,OAAO,CAAC;IACrB,CAAC;IAED;;;;;;;OAOG;IACH,cAAc,CAAC,QAAmB;QACjC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,OAAO;QACN,4CAA4C;IAC7C,CAAC;CACD"}
+{"version":3,"file":"state-signal.js","sourceRoot":"","sources":["../../src/signals/state-signal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAEjD;;;;;;;;;GASG;AACH,MAAM,OAAO,kBAAkB;IACtB,OAAO,CAA0B;IAEzC,YAAY,eAA0B;QACrC,IAAI,CAAC,OAAO,GAAG,IAAI,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;IAClD,CAAC;IAED;;OAEG;IACH,IAAI,MAAM;QACT,OAAO,IAAI,CAAC,OAAO,CAAC;IACrB,CAAC;IAED;;;;;;;OAOG;IACH,cAAc,CAAC,QAAmB;QACjC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC5B,CAAC;IAED;;;;OAIG;IACH,OAAO;QACN,oEAAoE;QACpE,uDAAuD;IACxD,CAAC;CACD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xmachines/play-xstate",
-  "version": "1.0.0-beta.25",
+  "version": "1.0.0-beta.27",
   "description": "XState v5 adapter for Play Architecture",
   "keywords": [
     "actor-model",
@@ -43,12 +43,12 @@
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "@xmachines/play": "1.0.0-beta.25",
-    "@xmachines/play-actor": "1.0.0-beta.25",
-    "@xmachines/play-signals": "1.0.0-beta.25"
+    "@xmachines/play": "1.0.0-beta.27",
+    "@xmachines/play-actor": "1.0.0-beta.27",
+    "@xmachines/play-signals": "1.0.0-beta.27"
   },
   "devDependencies": {
-    "@xmachines/shared": "1.0.0-beta.25",
+    "@xmachines/shared": "1.0.0-beta.27",
     "oxfmt": "^0.43.0",
     "oxlint": "^1.57.0",
     "typescript": "^5.9.3 || ^6.0.2",

package/dist/signals/debounce.d.ts

@@ -1,18 +0,0 @@
-/**
- * Microtask debouncing for glitch-free signal updates
- *
- * Per CONTEXT.md: "Microtask batching for glitch-free guarantee"
- * Per RESEARCH.md Pattern 5: Updates batch in microtask queue
- *
- * Leverages TC39 Signal primitives for proper batching.
- */
-/**
- * Schedule callback in microtask queue
- *
- * Multiple calls in same tick coalesce into single execution.
- *
- * @param callback - Function to execute in microtask
- * @returns Function to cancel scheduled execution
- */
-export declare const scheduleMicrotask: (callback: () => void) => (() => void);
-//# sourceMappingURL=debounce.d.ts.map

package/dist/signals/debounce.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"debounce.d.ts","sourceRoot":"","sources":["../../src/signals/debounce.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB,GAAI,UAAU,MAAM,IAAI,KAAG,CAAC,MAAM,IAAI,CAoBnE,CAAC"}

package/dist/signals/debounce.js

@@ -1,35 +0,0 @@
-/**
- * Microtask debouncing for glitch-free signal updates
- *
- * Per CONTEXT.md: "Microtask batching for glitch-free guarantee"
- * Per RESEARCH.md Pattern 5: Updates batch in microtask queue
- *
- * Leverages TC39 Signal primitives for proper batching.
- */
-/**
- * Schedule callback in microtask queue
- *
- * Multiple calls in same tick coalesce into single execution.
- *
- * @param callback - Function to execute in microtask
- * @returns Function to cancel scheduled execution
- */
-export const scheduleMicrotask = (callback) => {
-    let scheduled = false;
-    let cancelled = false;
-    const execute = () => {
-        if (!cancelled) {
-            callback();
-        }
-        scheduled = false;
-    };
-    if (!scheduled) {
-        scheduled = true;
-        queueMicrotask(execute);
-    }
-    // Return cancel function
-    return () => {
-        cancelled = true;
-    };
-};
-//# sourceMappingURL=debounce.js.map

package/dist/signals/debounce.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"debounce.js","sourceRoot":"","sources":["../../src/signals/debounce.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,QAAoB,EAAgB,EAAE;IACvE,IAAI,SAAS,GAAG,KAAK,CAAC;IACtB,IAAI,SAAS,GAAG,KAAK,CAAC;IAEtB,MAAM,OAAO,GAAG,GAAG,EAAE;QACpB,IAAI,CAAC,SAAS,EAAE,CAAC;YAChB,QAAQ,EAAE,CAAC;QACZ,CAAC;QACD,SAAS,GAAG,KAAK,CAAC;IACnB,CAAC,CAAC;IAEF,IAAI,CAAC,SAAS,EAAE,CAAC;QAChB,SAAS,GAAG,IAAI,CAAC;QACjB,cAAc,CAAC,OAAO,CAAC,CAAC;IACzB,CAAC;IAED,yBAAyB;IACzB,OAAO,GAAG,EAAE;QACX,SAAS,GAAG,IAAI,CAAC;IAClB,CAAC,CAAC;AACH,CAAC,CAAC"}