@xmachines/play-xstate 1.0.0-beta.8 → 1.0.0

package/dist/routing/derive-route.js

@@ -1,3 +1,4 @@
+import { InvalidRouteMetadataError } from "../errors.js";
 /**
  * Derive route from XState state metadata
  *
@@ -72,7 +73,7 @@
  * console.log(route); // "/dashboard"
  * ```
  *
- * @see {@link https://gitlab.com/xmachin-es/rfc/-/blob/main/src/play-v1.md | RFC Play v1}
+ * @see [Play RFC](../../../docs/rfc/play.md)
  * @see {@link buildRouteUrl} for URL construction with parameter substitution
  * @see {@link isAbsoluteRoute} for checking path absoluteness
  *
@@ -86,16 +87,28 @@
  * not correspond to distinct URLs.
  */
 export const deriveRoute = (stateMeta) => {
-    // Iterate through active state nodes to find route information
-    for (const [_stateId, meta] of Object.entries(stateMeta)) {
+    // snapshot.getMeta() orders keys ancestors-first. Fold routed entries top-down
+    // so the deepest active state's meta.route wins over an ancestor's, while a
+    // RELATIVE route resolves against its nearest routed ancestors — mirroring
+    // play-router's tree resolution (child fullPath = parent fullPath + "/" + path).
+    let resolved = null;
+    for (const meta of Object.values(stateMeta)) {
         if (typeof meta !== "object" || meta === null)
             continue;
-        // Check meta.route for routable states
-        if ("route" in meta && meta.route) {
-            return normalizeRoute(meta.route);
+        if (!("route" in meta) || !meta.route)
+            continue;
+        const route = normalizeRoute(meta.route);
+        if (typeof route !== "string" || route === "")
+            continue;
+        if (isAbsoluteRoute(route)) {
+            resolved = route;
+        }
+        else {
+            const base = resolved === null || resolved === "/" ? "" : resolved;
+            resolved = `${base}/${route}`;
         }
     }
-    return null;
+    return resolved;
 };
 /**
  * Normalize route metadata to string path
@@ -104,10 +117,12 @@ export const deriveRoute = (stateMeta) => {
  * string output for URL construction.
  *
  * @param route - Route metadata (string or object with path property)
+ * @param source - `PlayError.scope` to report when the metadata is invalid
+ *   (defaults to `"deriveRoute"`)
  * @returns Normalized route path string
- * @throws {Error} If route format is invalid
+ * @throws {InvalidRouteMetadataError} If route format is invalid
  */
-const normalizeRoute = (route) => {
+export const normalizeRoute = (route, source = "deriveRoute") => {
     if (typeof route === "string") {
         return route;
     }
@@ -115,7 +130,7 @@ const normalizeRoute = (route) => {
     if (route && typeof route === "object" && "path" in route) {
         return route.path;
     }
-    throw new Error(`Invalid route metadata: ${JSON.stringify(route)}. Expected string or { path: string }`);
+    throw new InvalidRouteMetadataError(route, source);
 };
 /**
  * Check if route path is absolute

package/dist/routing/derive-route.js.map

@@ -1 +1 @@
-{"version":3,"file":"derive-route.js","sourceRoot":"","sources":["../../src/routing/derive-route.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsFG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,SAAkC,EAAiB,EAAE;IAChF,+DAA+D;IAC/D,KAAK,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QAC1D,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI;YAAE,SAAS;QAExD,uCAAuC;QACvC,IAAI,OAAO,IAAI,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACnC,OAAO,cAAc,CAAC,IAAI,CAAC,KAAsB,CAAC,CAAC;QACpD,CAAC;IACF,CAAC;IAED,OAAO,IAAI,CAAC;AACb,CAAC,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,cAAc,GAAG,CAAC,KAAoB,EAAU,EAAE;IACvD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC/B,OAAO,KAAK,CAAC;IACd,CAAC;IAED,kCAAkC;IAClC,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,IAAI,KAAK,EAAE,CAAC;QAC3D,OAAQ,KAAqB,CAAC,IAAI,CAAC;IACpC,CAAC;IAED,MAAM,IAAI,KAAK,CACd,2BAA2B,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,uCAAuC,CACvF,CAAC;AACH,CAAC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,IAAY,EAAW,EAAE;IACxD,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;AAC7B,CAAC,CAAC"}
+{"version":3,"file":"derive-route.js","sourceRoot":"","sources":["../../src/routing/derive-route.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAEzD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsFG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,SAAkC,EAAiB,EAAE;IAChF,+EAA+E;IAC/E,4EAA4E;IAC5E,2EAA2E;IAC3E,iFAAiF;IACjF,IAAI,QAAQ,GAAkB,IAAI,CAAC;IACnC,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;QAC7C,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI;YAAE,SAAS;QACxD,IAAI,CAAC,CAAC,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK;YAAE,SAAS;QAEhD,MAAM,KAAK,GAAG,cAAc,CAAC,IAAI,CAAC,KAAsB,CAAC,CAAC;QAC1D,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,EAAE;YAAE,SAAS;QACxD,IAAI,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;YAC5B,QAAQ,GAAG,KAAK,CAAC;QAClB,CAAC;aAAM,CAAC;YACP,MAAM,IAAI,GAAW,QAAQ,KAAK,IAAI,IAAI,QAAQ,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;YAC3E,QAAQ,GAAG,GAAG,IAAI,IAAI,KAAK,EAAE,CAAC;QAC/B,CAAC;IACF,CAAC;IAED,OAAO,QAAQ,CAAC;AACjB,CAAC,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAAoB,EAAE,MAAM,GAAG,aAAa,EAAU,EAAE;IACtF,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC/B,OAAO,KAAK,CAAC;IACd,CAAC;IAED,kCAAkC;IAClC,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,IAAI,KAAK,EAAE,CAAC;QAC3D,OAAQ,KAAqB,CAAC,IAAI,CAAC;IACpC,CAAC;IAED,MAAM,IAAI,yBAAyB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;AACpD,CAAC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,IAAY,EAAW,EAAE;IACxD,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;AAC7B,CAAC,CAAC"}

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

@@ -1,11 +1,38 @@
+import type { RouteMetadata } from "./types.js";
+/**
+ * Minimal structural shape of a single XState state node as read by
+ * `formatPlayRouteTransitions` when crawling the machine config.
+ *
+ * Only the fields the function actually inspects are typed here; all other
+ * state-node fields (e.g. `on`, `entry`, `after`) pass through unmodified via
+ * the index signature.
+ */
 export type RouteStateNode = {
+    /** Optional explicit state ID (e.g. `"home"`, `"settings"`). Used as the `#id` target in `play.route` events. */
     id?: string;
+    /** State metadata — `meta.route` marks the state as routable. */
     meta?: {
-        route?: string;
+        /**
+         * URL path template — string form (e.g. `"/profile/:username"`) or object
+         * form (`{ path, title }`), matching {@link RouteMetadata}.
+         */
+        route?: RouteMetadata;
     };
+    /** Nested child states, recursively crawled for additional route declarations. */
     states?: Record<string, RouteStateNode>;
     [key: string]: unknown;
 };
+/**
+ * Minimal structural constraint for machine configs accepted by
+ * `formatPlayRouteTransitions`.
+ *
+ * This is intentionally loose so the function accepts both the bare `createMachine`
+ * config object and the stricter `setup().createMachine` config without requiring
+ * any type casts at the call site. The generic `T extends RouteMachineConfig`
+ * parameter on `formatPlayRouteTransitions` preserves the original concrete type
+ * through the transform, so the return value remains directly usable by
+ * `setup().createMachine()`.
+ */
 export type RouteMachineConfig = {
     context?: unknown;
     states?: Record<string, unknown> | undefined;
@@ -36,7 +63,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,MAAM,MAAM,cAAc,GAAG;IAC5B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE;QACN,KAAK,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;IACF,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACxC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACvB,CAAC;AASF,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,CA+C5F"}
+{"version":3,"file":"format-play-route-transitions.d.ts","sourceRoot":"","sources":["../../src/routing/format-play-route-transitions.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;;;;;;GAOG;AACH,MAAM,MAAM,cAAc,GAAG;IAC5B,iHAAiH;IACjH,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,iEAAiE;IACjE,IAAI,CAAC,EAAE;QACN;;;WAGG;QACH,KAAK,CAAC,EAAE,aAAa,CAAC;KACtB,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,CA0E5F"}

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

@@ -1,4 +1,6 @@
 import { assign } from "xstate";
+import { MissingStateIdError } from "../errors.js";
+import { normalizeRoute } from "./derive-route.js";
 /**
  * Formats play.route transitions from declarative route configs
  *
@@ -23,7 +25,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`.
@@ -33,21 +35,33 @@ export function formatPlayRouteTransitions(machineConfig) {
     const collectRoutes = (states, parentPath = "") => {
         Object.entries(states).forEach(([key, stateConfig]) => {
             const node = stateConfig;
-            const stateId = node.id || (parentPath ? `${parentPath}.${key}` : key);
-            if (node.meta?.route && node.id) {
+            // 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;
+            // Validates the metadata (malformed object routes throw
+            // InvalidRouteMetadataError) and normalizes to the path string. Both
+            // the string form ("") and the object form ({ path: "" }) of an empty
+            // path mark the state non-routable.
+            const routePath = node.meta?.route === undefined
+                ? ""
+                : normalizeRoute(node.meta.route, "formatPlayRouteTransitions");
+            if (routePath && !node.id) {
+                throw new MissingStateIdError(key, routePath);
+            }
+            if (routePath && node.id) {
                 const transition = {
-                    target: `.${key}`,
+                    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);
             }
             if (node.states) {
-                collectRoutes(node.states, stateId);
+                collectRoutes(node.states, statePath);
             }
         });
     };
@@ -57,9 +71,19 @@ export function formatPlayRouteTransitions(machineConfig) {
     }
     if (routeTransitions.length > 0) {
         const existingOn = machineConfig.on || {};
+        // Preserve user-defined play.route transitions (e.g. a hand-written 404
+        // fallback) by appending them AFTER the generated ones: XState evaluates
+        // candidate transitions in order, so generated guards win when they match
+        // and the user's transitions act as fallbacks otherwise.
+        const userRouteTransitions = existingOn["play.route"];
+        const normalizedUserTransitions = userRouteTransitions === undefined
+            ? []
+            : Array.isArray(userRouteTransitions)
+                ? userRouteTransitions
+                : [userRouteTransitions];
         const updatedOn = {
             ...existingOn,
-            "play.route": routeTransitions,
+            "play.route": [...routeTransitions, ...normalizedUserTransitions],
         };
         return {
             ...machineConfig,

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;AAmChC;;;;;;;;;;;;;;;;;;;;;;;;;;;;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,MAAM,OAAO,GAAG,IAAI,CAAC,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,UAAU,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;YAEvE,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;gBACjC,MAAM,UAAU,GAAoB;oBACnC,MAAM,EAAE,IAAI,GAAG,EAAE;oBACjB,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,OAAO,CAAC,CAAC;YACrC,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;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAwDnD;;;;;;;;;;;;;;;;;;;;;;;;;;;;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;YAC5D,wDAAwD;YACxD,qEAAqE;YACrE,sEAAsE;YACtE,oCAAoC;YACpC,MAAM,SAAS,GACd,IAAI,CAAC,IAAI,EAAE,KAAK,KAAK,SAAS;gBAC7B,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,4BAA4B,CAAC,CAAC;YAElE,IAAI,SAAS,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;gBAC3B,MAAM,IAAI,mBAAmB,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;YAC/C,CAAC;YAED,IAAI,SAAS,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;gBAC1B,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;QAE1C,wEAAwE;QACxE,yEAAyE;QACzE,0EAA0E;QAC1E,yDAAyD;QACzD,MAAM,oBAAoB,GAAG,UAAU,CAAC,YAAY,CAAC,CAAC;QACtD,MAAM,yBAAyB,GAC9B,oBAAoB,KAAK,SAAS;YACjC,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,oBAAoB,CAAC;gBACpC,CAAC,CAAC,oBAAoB;gBACtB,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC;QAE5B,MAAM,SAAS,GAAG;YACjB,GAAG,UAAU;YACb,YAAY,EAAE,CAAC,GAAG,gBAAgB,EAAE,GAAG,yBAAyB,CAAC;SACjE,CAAC;QAEF,OAAO;YACN,GAAG,aAAa;YAChB,EAAE,EAAE,SAAS;SACR,CAAC;IACR,CAAC;IAED,OAAO,aAAa,CAAC;AACtB,CAAC"}

package/dist/routing/index.d.ts

@@ -7,8 +7,10 @@
  * @packageDocumentation
  */
 export { deriveRoute, isAbsoluteRoute } from "./derive-route.js";
+export { deriveCurrentRoute } from "./derive-current-route.js";
+export { deriveInitialRoute } from "./derive-initial-route.js";
 export { buildRouteUrl } from "./build-url.js";
 export { formatPlayRouteTransitions } from "./format-play-route-transitions.js";
 export type { RouteMachineConfig, RouteStateNode } from "./format-play-route-transitions.js";
-export type { RouteContext } from "./types.js";
+export type { RouteContext, RouteObject, RouteMetadata } from "./types.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/routing/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AAChF,YAAY,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAC7F,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/routing/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AAChF,YAAY,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAC7F,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/dist/routing/index.js

@@ -7,6 +7,8 @@
  * @packageDocumentation
  */
 export { deriveRoute, isAbsoluteRoute } from "./derive-route.js";
+export { deriveCurrentRoute } from "./derive-current-route.js";
+export { deriveInitialRoute } from "./derive-initial-route.js";
 export { buildRouteUrl } from "./build-url.js";
 export { formatPlayRouteTransitions } from "./format-play-route-transitions.js";
 //# sourceMappingURL=index.js.map

package/dist/routing/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/routing/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/routing/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,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/types.d.ts

@@ -2,14 +2,10 @@ import type { AnyStateMachine, InputFrom, SnapshotFrom } from "xstate";
 import type { PlayerActor as PlayerActorClass } from "./player-actor.js";
 /**
  * Configuration for definePlayer()
- *
- * Per CONTEXT.md: Single config object with machine, catalog, options
  */
-export interface PlayerConfig<TMachine extends AnyStateMachine, TCatalog = Record<string, unknown>> {
+export interface PlayerConfig<TMachine extends AnyStateMachine> {
     /** XState v5 state machine */
     machine: TMachine;
-    /** UI component catalog (optional - allows machines without UI) */
-    catalog?: TCatalog;
     /** Lifecycle hooks and configuration */
     options?: PlayerOptions<TMachine>;
 }
@@ -30,10 +26,20 @@ export interface PlayerOptions<TMachine extends AnyStateMachine> {
     /** Called on actor errors */
     onError?: (actor: PlayerActorClass<TMachine>, error: Error) => void;
 }
+/**
+ * Optional restore arguments for the player factory.
+ *
+ * Mirrors XState's createActor options bag while preserving the existing
+ * `createPlayer(input?)` calling convention for fresh actors.
+ */
+export interface PlayerFactoryResumeOptions<TMachine extends AnyStateMachine> {
+    /** Persisted XState snapshot used to restore actor state. */
+    snapshot?: SnapshotFrom<TMachine>;
+}
 /**
  * Factory function returned by definePlayer()
  *
  * Per CONTEXT.md: Factory supports creating multiple actor instances
  */
-export type PlayerFactory<TMachine extends AnyStateMachine> = (input?: InputFrom<TMachine>) => PlayerActorClass<TMachine>;
+export type PlayerFactory<TMachine extends AnyStateMachine> = (input?: InputFrom<TMachine>, options?: PlayerFactoryResumeOptions<TMachine>) => PlayerActorClass<TMachine>;
 //# 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,eAAe,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACvE,OAAO,KAAK,EAAE,WAAW,IAAI,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAEzE;;;;GAIG;AACH,MAAM,WAAW,YAAY,CAC5B,QAAQ,SAAS,eAAe,EAChC,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAElC,8BAA8B;IAC9B,OAAO,EAAE,QAAQ,CAAC;IAElB,mEAAmE;IACnE,OAAO,CAAC,EAAE,QAAQ,CAAC;IAEnB,wCAAwC;IACxC,OAAO,CAAC,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;CAClC;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa,CAAC,QAAQ,SAAS,eAAe;IAC9D,+BAA+B;IAC/B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC;IAEtD,8BAA8B;IAC9B,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC;IAErD,uCAAuC;IACvC,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,uCAAuC;IACvC,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,YAAY,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC;IAE3F,6BAA6B;IAC7B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACpE;AAED;;;;GAIG;AACH,MAAM,MAAM,aAAa,CAAC,QAAQ,SAAS,eAAe,IAAI,CAC7D,KAAK,CAAC,EAAE,SAAS,CAAC,QAAQ,CAAC,KACvB,gBAAgB,CAAC,QAAQ,CAAC,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACvE,OAAO,KAAK,EAAE,WAAW,IAAI,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAEzE;;GAEG;AACH,MAAM,WAAW,YAAY,CAAC,QAAQ,SAAS,eAAe;IAC7D,8BAA8B;IAC9B,OAAO,EAAE,QAAQ,CAAC;IAElB,wCAAwC;IACxC,OAAO,CAAC,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;CAClC;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa,CAAC,QAAQ,SAAS,eAAe;IAC9D,+BAA+B;IAC/B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC;IAEtD,8BAA8B;IAC9B,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC;IAErD,uCAAuC;IACvC,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,uCAAuC;IACvC,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,YAAY,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC;IAE3F,6BAA6B;IAC7B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACpE;AAED;;;;;GAKG;AACH,MAAM,WAAW,0BAA0B,CAAC,QAAQ,SAAS,eAAe;IAC3E,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAC;CAClC;AAED;;;;GAIG;AACH,MAAM,MAAM,aAAa,CAAC,QAAQ,SAAS,eAAe,IAAI,CAC7D,KAAK,CAAC,EAAE,SAAS,CAAC,QAAQ,CAAC,EAC3B,OAAO,CAAC,EAAE,0BAA0B,CAAC,QAAQ,CAAC,KAC1C,gBAAgB,CAAC,QAAQ,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xmachines/play-xstate",
-  "version": "1.0.0-beta.8",
+  "version": "1.0.0",
   "description": "XState v5 adapter for Play Architecture",
   "keywords": [
     "actor-model",
@@ -11,6 +11,11 @@
   ],
   "license": "MIT",
   "author": "",
+  "repository": {
+    "type": "git",
+    "url": "git+ssh://git@gitlab.com/xmachin-es/xmachines-js.git",
+    "directory": "packages/play-xstate"
+  },
   "files": [
     "dist",
     "README.md",
@@ -21,8 +26,14 @@
   "types": "./dist/index.d.ts",
   "exports": {
     ".": {
+      "source": "./src/index.ts",
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
+    },
+    "./errors": {
+      "source": "./src/errors.ts",
+      "types": "./dist/errors.d.ts",
+      "import": "./dist/errors.js"
     }
   },
   "publishConfig": {
@@ -30,22 +41,34 @@
   },
   "scripts": {
     "build": "tsc --build",
-    "clean": "rm -rf dist *.tsbuildinfo node_modules/.vite node_modules/.vite-temp",
-    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist *.tsbuildinfo coverage node_modules/.svelte2tsx-* node_modules/.vite*",
+    "lint": "oxlint .",
+    "format": "oxfmt .",
     "test": "vitest",
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "@xmachines/play": "1.0.0-beta.8",
-    "@xmachines/play-actor": "1.0.0-beta.8",
-    "@xmachines/play-catalog": "1.0.0-beta.8",
-    "@xmachines/play-signals": "1.0.0-beta.8",
-    "zod": "^4.3.6"
+    "@xmachines/play": "1.0.0",
+    "@xmachines/play-actor": "1.0.0",
+    "@xmachines/play-signals": "1.0.0",
+    "dequal": "^2.0.3"
   },
   "devDependencies": {
-    "@xmachines/shared": "1.0.0-beta.8"
+    "@testing-library/jest-dom": "^6.9.1",
+    "@types/node": "^26.1.1",
+    "@xmachines/play-router": "1.0.0",
+    "@xmachines/shared": "1.0.0",
+    "oxfmt": "^0.58.0",
+    "oxlint": "^1.73.0",
+    "typescript": "^5.9.3 || ^6.0.3",
+    "vitest": "^4.1.10",
+    "xstate": "^5.31.0"
   },
   "peerDependencies": {
-    "xstate": "^5.28.0"
-  }
+    "xstate": "^5.31.0"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "_devDependencies_note": "xstate appears in both peerDependencies and devDependencies intentionally. devDependencies provides workspace resolution for local builds, tests, and typechecking. peerDependencies declares the consumer version constraint. Both are pinned to ^5.30.0 to prevent drift."
 }

package/dist/catalog/index.d.ts

@@ -1,13 +0,0 @@
-/**
- * Catalog binding and validation utilities
- *
- * Provides functions for validating component references and props
- * using Zod schemas from the catalog.
- *
- * @packageDocumentation
- */
-export { validateComponentBinding } from "./validate-binding.js";
-export { validateViewProps, mergeViewProps, createMemoSignature } from "./validate-props.js";
-export type { ValidationResult, ViewMergeContext } from "./validate-props.js";
-export type { Catalog, CatalogEntry } from "./types.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/catalog/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/catalog/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC7F,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC9E,YAAY,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/dist/catalog/index.js

@@ -1,11 +0,0 @@
-/**
- * Catalog binding and validation utilities
- *
- * Provides functions for validating component references and props
- * using Zod schemas from the catalog.
- *
- * @packageDocumentation
- */
-export { validateComponentBinding } from "./validate-binding.js";
-export { validateViewProps, mergeViewProps, createMemoSignature } from "./validate-props.js";
-//# sourceMappingURL=index.js.map

package/dist/catalog/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/catalog/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/catalog/types.d.ts

@@ -1,27 +0,0 @@
-import type { z } from "zod";
-import type { Catalog as BaseCatalog } from "@xmachines/play-catalog";
-/**
- * UI component catalog entry with schema and component reference
- *
- * Per CONTEXT.md: String keys reference components, Zod schemas validate props
- */
-export interface CatalogEntry {
-    /** Zod schema for component props */
-    schema: z.ZodType<unknown>;
-    /** React component (or other framework component) */
-    component: unknown;
-}
-/**
- * Component catalog mapping
- *
- * Re-export from @xmachines/play-catalog for consistent API.
- *
- * Supports two formats:
- * - Direct Zod schemas: `Record<string, z.ZodType>` via defineCatalog()
- * - CatalogEntry objects: `Record<string, CatalogEntry>` with { schema, component }
- *
- * PlayerActor accepts either format - if entry has 'schema' property, uses CatalogEntry pattern,
- * otherwise treats as direct Zod schema.
- */
-export type Catalog = BaseCatalog | Record<string, CatalogEntry>;
-//# sourceMappingURL=types.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/catalog/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAEtE;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC5B,qCAAqC;IACrC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3B,qDAAqD;IACrD,SAAS,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,OAAO,GAAG,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC"}

package/dist/catalog/types.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=types.js.map

package/dist/catalog/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/catalog/types.ts"],"names":[],"mappings":""}

package/dist/catalog/validate-binding.d.ts

@@ -1,22 +0,0 @@
-import type { Catalog } from "./types.js";
-import type { ViewMetadata } from "@xmachines/play-actor";
-/**
- * Validate component binding against catalog
- *
- * Per CONTEXT.md:
- * - "Component references: String keys"
- * - "Mismatch detection: Both compile-time (TypeScript) and runtime validation"
- *
- * @example
- * ```typescript
- * const view = { component: 'Dashboard', userId: '123' };
- * validateComponentBinding(view, catalog);
- * // Throws if 'Dashboard' not in catalog
- * ```
- *
- * @param view - View metadata from meta.view
- * @param catalog - Component catalog
- * @throws Error if component not found in catalog
- */
-export declare const validateComponentBinding: (view: ViewMetadata, catalog: Catalog) => void;
-//# sourceMappingURL=validate-binding.d.ts.map

package/dist/catalog/validate-binding.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"validate-binding.d.ts","sourceRoot":"","sources":["../../src/catalog/validate-binding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1D;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,wBAAwB,GAAI,MAAM,YAAY,EAAE,SAAS,OAAO,KAAG,IAc/E,CAAC"}

package/dist/catalog/validate-binding.js

@@ -1,30 +0,0 @@
-/**
- * Validate component binding against catalog
- *
- * Per CONTEXT.md:
- * - "Component references: String keys"
- * - "Mismatch detection: Both compile-time (TypeScript) and runtime validation"
- *
- * @example
- * ```typescript
- * const view = { component: 'Dashboard', userId: '123' };
- * validateComponentBinding(view, catalog);
- * // Throws if 'Dashboard' not in catalog
- * ```
- *
- * @param view - View metadata from meta.view
- * @param catalog - Component catalog
- * @throws Error if component not found in catalog
- */
-export const validateComponentBinding = (view, catalog) => {
-    if (!view || !view.component) {
-        throw new Error("Invalid view metadata: missing 'component' property");
-    }
-    const { component } = view;
-    // Runtime validation
-    if (!(component in catalog)) {
-        const available = Object.keys(catalog).join(", ");
-        throw new Error(`Component "${component}" not found in catalog. Available components: ${available || "(none)"}`);
-    }
-};
-//# sourceMappingURL=validate-binding.js.map

package/dist/catalog/validate-binding.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"validate-binding.js","sourceRoot":"","sources":["../../src/catalog/validate-binding.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,IAAkB,EAAE,OAAgB,EAAQ,EAAE;IACtF,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACxE,CAAC;IAED,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;IAE3B,qBAAqB;IACrB,IAAI,CAAC,CAAC,SAAS,IAAI,OAAO,CAAC,EAAE,CAAC;QAC7B,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClD,MAAM,IAAI,KAAK,CACd,cAAc,SAAS,iDAAiD,SAAS,IAAI,QAAQ,EAAE,CAC/F,CAAC;IACH,CAAC;AACF,CAAC,CAAC"}

package/dist/catalog/validate-props.d.ts

@@ -1,51 +0,0 @@
-import type { z } from "zod";
-import type { Catalog } from "./types.js";
-import type { ViewMetadata } from "@xmachines/play-actor";
-export type ViewMergeContext = {
-    routeParams?: Record<string, unknown>;
-    queryParams?: Record<string, unknown>;
-    [key: string]: unknown;
-};
-export type ValidationResult = {
-    success: true;
-    data: Record<string, unknown>;
-} | {
-    success: false;
-    error: z.ZodError | Error;
-};
-/**
- * Validate view props against Zod schema
- *
- * Per CONTEXT.md:
- * - "Prop validation: At state entry"
- * - "currentView derivation: Merge meta.view with relevant context data"
- *
- * Per RESEARCH.md Pattern 4: Use safeParse() for validation
- *
- * @example
- * ```typescript
- * const props = { userId: '123', stats: { logins: 5 } };
- * const result = validateViewProps('Dashboard', props, catalog);
- * if (!result.success) {
- *   console.error(result.error);
- * }
- * ```
- *
- * @param componentName - Component name from catalog
- * @param props - Props to validate
- * @param catalog - Component catalog with schemas
- * @returns Zod parse result
- */
-export declare const validateViewProps: (componentName: string, props: unknown, catalog: Catalog) => ValidationResult;
-/**
- * Merge view metadata with context for props
- *
- * Per CONTEXT.md: "Merge meta.view with relevant context data for component props"
- *
- * @param view - View metadata from meta.view
- * @param context - Machine context
- * @returns Merged props object
- */
-export declare const mergeViewProps: (view: ViewMetadata, context: ViewMergeContext | null | undefined) => Record<string, unknown>;
-export declare const createMemoSignature: (value: unknown) => string;
-//# sourceMappingURL=validate-props.d.ts.map

package/dist/catalog/validate-props.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"validate-props.d.ts","sourceRoot":"","sources":["../../src/catalog/validate-props.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1D,MAAM,MAAM,gBAAgB,GAAG;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GACzB;IACA,OAAO,EAAE,IAAI,CAAC;IACd,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC7B,GACD;IACA,OAAO,EAAE,KAAK,CAAC;IACf,KAAK,EAAE,CAAC,CAAC,QAAQ,GAAG,KAAK,CAAC;CACzB,CAAC;AAEL;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,iBAAiB,GAC7B,eAAe,MAAM,EACrB,OAAO,OAAO,EACd,SAAS,OAAO,KACd,gBA2BF,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc,GAC1B,MAAM,YAAY,EAClB,SAAS,gBAAgB,GAAG,IAAI,GAAG,SAAS,KAC1C,MAAM,CAAC,MAAM,EAAE,OAAO,CAkDxB,CAAC;AAiEF,eAAO,MAAM,mBAAmB,GAAI,OAAO,OAAO,KAAG,MAEpD,CAAC"}