@xmachines/play-xstate 1.0.0-beta.2 → 1.0.0-beta.21

package/dist/player-actor.js

@@ -1,9 +1,213 @@
-import { createActor } from "xstate";
-import { AbstractActor } from "@xmachines/play-actor";
+import { createActor, } from "xstate";
+import { AbstractActor, } from "@xmachines/play-actor";
 import { Signal } from "@xmachines/play-signals";
 import { StateSignalManager } from "./signals/state-signal.js";
+import { InvalidEventError, MissingRouteParamError } from "./errors.js";
 import { deriveRoute, buildRouteUrl } from "./routing/index.js";
-import { validateComponentBinding, validateViewProps, mergeViewProps } from "./catalog/index.js";
+const hasSnapshotStatus = (snapshot) => {
+    if (!snapshot || typeof snapshot !== "object") {
+        return false;
+    }
+    if (!("status" in snapshot)) {
+        return false;
+    }
+    return typeof snapshot.status === "string";
+};
+const isActiveSnapshot = (snapshot) => {
+    return hasSnapshotStatus(snapshot) && snapshot.status === "active";
+};
+/**
+ * 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`.
+ *
+ * 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.
+ */
+const deriveCurrentRoute = (snapshot) => {
+    if (!snapshot || typeof snapshot.getMeta !== "function") {
+        return null;
+    }
+    const meta = snapshot.getMeta();
+    if (!meta || typeof meta !== "object") {
+        return null;
+    }
+    const routeTemplate = deriveRoute(meta);
+    if (!routeTemplate) {
+        return null;
+    }
+    try {
+        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.
+        if (error instanceof MissingRouteParamError) {
+            return null;
+        }
+        throw error;
+    }
+};
+const resolveViewMeta = (meta) => {
+    for (const stateMeta of Object.values(meta)) {
+        const maybeView = stateMeta && typeof stateMeta === "object"
+            ? stateMeta.view
+            : undefined;
+        if (maybeView && typeof maybeView === "object") {
+            return maybeView;
+        }
+    }
+    return null;
+};
+/**
+ * Merge route parameters and an explicit allowlist of context fields into a single
+ * element's props.
+ *
+ * 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.
+ * 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 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
+ *   undefined slots.
+ *
+ * @example
+ * ```ts
+ * // spec:          { section: undefined, username: undefined, title: "Dashboard" }
+ * // routeParams:   { section: "profile" }            ← from URL /:section
+ * // contextValues: { username: "alice" }              ← from contextProps: ["username"]
+ * // result:        { section: "profile", username: "alice", title: "Dashboard" }
+ * ```
+ */
+function mergeRouteParamsIntoProps(routeParams, 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)) {
+        merged[k] = v;
+    }
+    // Layer 1 (highest priority): explicit non-undefined spec props always win
+    for (const [k, v] of Object.entries(existingProps)) {
+        if (v !== undefined)
+            merged[k] = v;
+    }
+    return merged;
+}
+/**
+ * Derive the actor's current view from state metadata.
+ *
+ * Always returns a **fresh** `ViewMetadata` object so `Signal.State.set()` always notifies
+ * watchers — including on self-transitions (`reenter: true`) where the component name and
+ * spec reference would otherwise be identical. Returning the same object reference would
+ * cause `Signal.State`'s `Object.is` equality check to suppress the notification.
+ *
+ * ### Prop enrichment
+ *
+ * Each spec element's `props` are enriched before the view is emitted using two sources:
+ *
+ * **1. URL route params** (`context.routeParams`, populated by `formatPlayRouteTransitions`):
+ * Makes `:section?` / `:username` URL path parameters automatically available as component
+ * props without manual wiring.
+ *
+ * **2. Context fields** (`spec.contextProps` allowlist):
+ * Exposes selected context fields as component props for states where no URL param covers
+ * the data (e.g. `context.username` on a `/dashboard` route). Only fields explicitly named
+ * in `spec.contextProps: string[]` are ever exposed — nothing leaks from context implicitly.
+ *
+ * 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.
+ * 3. Allowlisted context field (`contextProps`) — fills remaining `undefined` slots.
+ *
+ * @param snapshot - Current XState machine snapshot.
+ * @returns Enriched `ViewMetadata`, or `null` if the current state has no view metadata.
+ *
+ * @example
+ * ```ts
+ * // spec: { contextProps: ["username"], elements: { root: { props: { username: undefined } } } }
+ * // context.username = "alice", routeParams = {}
+ * // Derived props: { username: "alice" }
+ *
+ * // spec: { contextProps: ["username"], elements: { root: { props: { username: undefined } } } }
+ * // context.username = "alice", routeParams = { username: "demo" }
+ * // Derived props: { username: "demo" }  ← routeParams wins
+ * ```
+ */
+const deriveCurrentView = (snapshot) => {
+    if (!snapshot) {
+        return null;
+    }
+    const meta = snapshot.getMeta();
+    if (!meta || typeof meta !== "object") {
+        return null;
+    }
+    const viewMeta = resolveViewMeta(meta);
+    if (!viewMeta) {
+        return null;
+    }
+    // Extract routeParams 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
+        : {};
+    // Extract the allowlisted context fields declared in spec.contextProps.
+    // Only fields explicitly named in the allowlist are ever exposed to components.
+    const contextPropsAllowlist = viewMeta.spec?.contextProps ?? [];
+    const contextValues = {};
+    if (context !== null && contextPropsAllowlist.length > 0) {
+        for (const key of contextPropsAllowlist) {
+            if (key in context && context[key] !== null && context[key] !== undefined) {
+                contextValues[key] = context[key];
+            }
+        }
+    }
+    // Enrich element props when there is anything to merge.
+    if (viewMeta.spec?.elements) {
+        const enrichedElements = Object.fromEntries(Object.entries(viewMeta.spec.elements).map(([key, el]) => {
+            const element = el;
+            const existingProps = element.props ?? {};
+            return [
+                key,
+                {
+                    ...element,
+                    props: mergeRouteParamsIntoProps(routeParams, contextValues, existingProps),
+                },
+            ];
+        }));
+        return {
+            component: viewMeta.component,
+            spec: { ...viewMeta.spec, elements: enrichedElements },
+        };
+    }
+    return {
+        component: viewMeta.component,
+        spec: viewMeta.spec,
+    };
+};
 /**
  * Concrete XState actor implementing Play Architecture signal protocol
  *
@@ -64,7 +268,7 @@ import { validateComponentBinding, validateViewProps, mergeViewProps } from "./c
  * // Watcher notification scheduled via microtask
  * ```
  *
- * @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 definePlayer} for factory creation
  * @see {@link @xmachines/play-actor!AbstractActor} for signal protocol
  * @see {@link @xmachines/play-actor!Routable} for routing capability
@@ -83,30 +287,87 @@ export class PlayerActor extends AbstractActor {
     _xstateActor;
     _stateManager;
     _options;
-    _catalog;
     _viewSignal;
     // AbstractActor protocol requirements
     state;
+    /**
+     * A TC39 `Signal.Computed` that derives the current URL path from the active
+     * machine state's `meta.route` template and the actor's context.
+     *
+     * Returns `null` when the current state has no `meta.route`, or when the route
+     * template cannot be fully resolved (e.g. a required parameter is absent from
+     * context).
+     *
+     * @throws {MissingRouteParamError} When a required `:param` placeholder in the
+     *   route template has no matching value in the actor's context. Import the class
+     *   from `@xmachines/play-xstate/errors`.
+     *
+     * @example
+     * ```typescript
+     * // Returns "/profile/alice" when context.userId === "alice"
+     * const route = actor.currentRoute.get();
+     * ```
+     */
     currentRoute;
+    /**
+     * The route derived from the machine's initial state — fixed at construction,
+     * never changes even when the actor is restored from a snapshot.
+     *
+     * Router bridges compare this against the browser URL to distinguish a deep-link
+     * (non-initial URL → router wins) from a restore (initial URL + actor at a
+     * different restored route → actor wins).
+     */
+    initialRoute;
+    /**
+     * Reactive signal containing the current view spec derived from the active state's
+     * `meta.view` metadata.
+     *
+     * Always emits a **fresh object reference** on every state transition (including
+     * self-transitions with `reenter: true`) so TC39 Signal equality checks reliably
+     * detect changes.
+     *
+     * The emitted `ViewMetadata` has its spec element `props` enriched with
+     * `context.routeParams` before emission — URL path parameters (e.g. `:section?`)
+     * flow into component props automatically. See `mergeRouteParamsIntoProps` for the
+     * merge priority rules.
+     *
+     * Returns `null` when the current state has no `meta.view` metadata.
+     *
+     * @example
+     * ```typescript
+     * const view = actor.currentView.get();
+     * if (view) {
+     *   console.log(view.component); // e.g. "Dashboard"
+     *   console.log(view.spec);      // @json-render/core Spec object
+     * }
+     * ```
+     */
     currentView;
-    catalog;
-    constructor(machine, catalog, options, input) {
+    constructor(machine, options, input, snapshot) {
         // Defensive check: Validate machine before passing to createActor
         if (!machine || typeof machine !== "object") {
             throw new Error("PlayerActor requires a valid XState machine");
         }
         // Create XState actor
-        const xstateActor = createActor(machine, { input });
+        // XState 5.28.0: createActor() options has a conditional type constraint on `input` that
+        // TypeScript cannot resolve against an unbound generic TMachine parameter.
+        // Option B: Cast to ActorOptions<TMachine> — narrower than `as any` because we remain
+        // within the XState type system. The `input` parameter is typed as InputFrom<TMachine>
+        // at the constructor call site, so consumers receive compile-time validation.
+        // 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());
         this._xstateActor = xstateActor;
         this._options = options || {};
-        this._catalog = catalog || {};
-        this.catalog = this._catalog;
         // Initialize state signal manager
         this._stateManager = new StateSignalManager(xstateActor.getSnapshot());
         this.state = this._stateManager.signal;
@@ -115,30 +376,14 @@ export class PlayerActor extends AbstractActor {
         // Initialize currentRoute computed signal
         this.currentRoute = new Signal.Computed(() => {
             const snapshot = this.state.get();
-            // Defensive check: Validate snapshot and getMeta exists
-            if (!snapshot || typeof snapshot.getMeta !== "function") {
-                return null;
-            }
-            const meta = snapshot.getMeta();
-            // Defensive check: Validate meta is an object
-            if (!meta || typeof meta !== "object") {
-                return null;
-            }
-            // Derive route from meta.route per Plan 04
-            const routeTemplate = deriveRoute(meta);
-            if (!routeTemplate) {
-                return null;
-            }
-            // Build full URL with params, query, hash
-            // Per CONTEXT.md: "Full URL generation including query params, hash, base path from context"
-            return buildRouteUrl(routeTemplate, snapshot.context);
+            return deriveCurrentRoute(snapshot);
         });
         // Expose view signal directly for proper watcher propagation
         this.currentView = this._viewSignal;
         // Subscribe to XState actor transitions
         this._xstateActor.subscribe((snapshot) => {
             // Only update on stable/active states per CONTEXT.md
-            if (snapshot.status === "active") {
+            if (isActiveSnapshot(snapshot)) {
                 // Update state signal with microtask batching
                 this._stateManager.scheduleUpdate(snapshot);
                 // Validate view at state entry per CONTEXT.md: "Prop validation: At state entry"
@@ -177,33 +422,34 @@ export class PlayerActor extends AbstractActor {
         return this;
     }
     /**
-     * Send event to actor
+     * Send an event to the underlying XState actor.
+     *
+     * The actor's state machine guards decide whether the event causes a transition.
+     * Pass any event from the machine's event union — domain events, routing events, etc.
      *
-     * Forwards events to the underlying XState actor. The actor's state machine
-     * guards determine whether each event is valid from the current state.
+     * @param event - An event from the machine's `EventFromLogic<TMachine>` union.
      *
-     * @param event - Any event object with a type property
+     * @throws {InvalidEventError} When `event` is not a plain object (`null`, `undefined`,
+     *   a string, number, etc.). Import the class from `@xmachines/play-xstate/errors`.
      *
      * @example
      * ```typescript
-     * // Domain event
-     * actor.send({ type: 'auth.login', userId: '123' });
+     * // Domain event (typed to machine's event union)
+     * actor.send({ type: "auth.login", userId: "123" });
      *
      * // Routing event
-     * actor.send({ type: 'play.route', to: '#home' });
+     * actor.send({ type: "play.route", to: "#home" });
      * ```
      */
     send(event) {
         // Defensive check: Validate event is not null/undefined
         if (!event || typeof event !== "object") {
-            console.warn("PlayerActor.send() called with invalid event:", event);
-            return;
+            throw new InvalidEventError(event);
         }
         // Store previous state for onTransition hook
         const prevSnapshot = this._xstateActor.getSnapshot();
         // Send to XState actor
-        // Note: TypeScript cast needed because XState's generic event type is narrower
-        // than our generic PlayEvent. At runtime, both are { type: string, ...fields }.
+        // EventFromLogic<TMachine> is exactly what _xstateActor.send expects — no cast needed.
         this._xstateActor.send(event);
         // Call onTransition hook
         if (this._options.onTransition) {
@@ -226,61 +472,17 @@ export class PlayerActor extends AbstractActor {
      * @param snapshot - Current XState snapshot
      */
     _validateAndCacheView(snapshot) {
-        // Defensive check: Validate snapshot and getMeta exists
-        if (!snapshot || typeof snapshot.getMeta !== "function") {
-            this._viewSignal.set(null);
-            return;
-        }
-        const meta = snapshot.getMeta();
-        // Defensive check: Validate meta is an object
-        if (!meta || typeof meta !== "object") {
-            this._viewSignal.set(null);
-            return;
-        }
-        // Find meta.view in active state nodes
-        let viewMeta = null;
-        for (const [_stateId, stateMeta] of Object.entries(meta)) {
-            if (stateMeta && stateMeta.view) {
-                viewMeta = stateMeta.view;
-                break;
-            }
-        }
-        if (!viewMeta) {
-            this._viewSignal.set(null);
-            return;
-        }
-        // Validate component binding
         try {
-            validateComponentBinding(viewMeta, this._catalog);
+            const view = deriveCurrentView(snapshot);
+            this._viewSignal.set(view);
         }
         catch (error) {
-            // Call onError hook if validation fails
             if (this._options.onError) {
-                this._options.onError(this, error);
+                const err = error instanceof Error ? error : new Error(String(error));
+                this._options.onError(this, err);
             }
-            console.error("Catalog binding validation failed:", error);
-            this._viewSignal.set(null);
-            return;
+            // On error: keep the last valid view (don't clear)
         }
-        // Merge meta.view with context for props
-        const props = mergeViewProps(viewMeta, snapshot.context);
-        // Validate props against Zod schema
-        const validation = validateViewProps(viewMeta.component, props, this._catalog);
-        if (!validation.success) {
-            // Call onError hook if prop validation fails
-            if (this._options.onError) {
-                this._options.onError(this, new Error(`Invalid props for component "${viewMeta.component}": ${validation.error?.message || "Unknown error"}`));
-            }
-            console.error("View props validation failed:", validation.error);
-            // Store view structure even if validation fails (allow app to handle gracefully)
-            // Per RESEARCH.md open question: prefer error events over throwing in production
-        }
-        // Cache validated view structure (validated once at state entry)
-        const newView = {
-            component: viewMeta.component,
-            props: validation.success ? validation.data : props,
-        };
-        this._viewSignal.set(newView);
     }
     /**
      * Convenience dispose method for cleanup

package/dist/player-actor.js.map

@@ -1 +1 @@
-{"version":3,"file":"player-actor.js","sourceRoot":"","sources":["../src/player-actor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAwD,MAAM,QAAQ,CAAC;AAC3F,OAAO,EAAE,aAAa,EAAgC,MAAM,uBAAuB,CAAC;AACpF,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAEjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAE/D,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGjG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0EG;AACH,MAAM,OAAO,WACZ,SAAQ,aAA4B;IAG5B,YAAY,CAAkB;IAC9B,aAAa,CAA0B;IACvC,QAAQ,CAAgB;IACxB,QAAQ,CAAM;IACd,WAAW,CAAyD;IAE5E,sCAAsC;IAC/B,KAAK,CAAoB;IACzB,YAAY,CAAiC;IAC7C,WAAW,CAAyD;IACpE,OAAO,CAAM;IAEpB,YAAY,OAAiB,EAAE,OAAY,EAAE,OAAsB,EAAE,KAAW;QAC/E,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,MAAM,WAAW,GAAG,WAAW,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAEpD,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,IAAI,CAAC,YAAY,GAAG,WAAW,CAAC;QAChC,IAAI,CAAC,QAAQ,GAAG,OAAO,IAAI,EAAE,CAAC;QAC9B,IAAI,CAAC,QAAQ,GAAG,OAAO,IAAI,EAAE,CAAC;QAC9B,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC;QAE7B,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,CAA2C,IAAI,CAAC,CAAC;QAEpF,0CAA0C;QAC1C,IAAI,CAAC,YAAY,GAAG,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE;YAC5C,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;YAElC,wDAAwD;YACxD,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;gBACzD,OAAO,IAAI,CAAC;YACb,CAAC;YAED,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,EAAE,CAAC;YAEhC,8CAA8C;YAC9C,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACvC,OAAO,IAAI,CAAC;YACb,CAAC;YAED,2CAA2C;YAC3C,MAAM,aAAa,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;YAExC,IAAI,CAAC,aAAa,EAAE,CAAC;gBACpB,OAAO,IAAI,CAAC;YACb,CAAC;YAED,0CAA0C;YAC1C,6FAA6F;YAC7F,OAAO,aAAa,CAAC,aAAa,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;QACvD,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,IAAK,QAAgB,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;gBAC3C,8CAA8C;gBAC9C,IAAI,CAAC,aAAa,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;gBAE5C,iFAAiF;gBACjF,0DAA0D;gBAC1D,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;;;;;;;;;;;;;;;;OAgBG;IACM,IAAI,CAAC,KAAgB;QAC7B,wDAAwD;QACxD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YACzC,OAAO,CAAC,IAAI,CAAC,+CAA+C,EAAE,KAAK,CAAC,CAAC;YACrE,OAAO;QACR,CAAC;QAED,6CAA6C;QAC7C,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC;QAErD,uBAAuB;QACvB,+EAA+E;QAC/E,gFAAgF;QAChF,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,KAAY,CAAC,CAAC;QAErC,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,QAAa;QAC1C,wDAAwD;QACxD,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;YACzD,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAC3B,OAAO;QACR,CAAC;QAED,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,EAAE,CAAC;QAEhC,8CAA8C;QAC9C,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YACvC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAC3B,OAAO;QACR,CAAC;QAED,uCAAuC;QACvC,IAAI,QAAQ,GAAwB,IAAI,CAAC;QAEzC,KAAK,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1D,IAAI,SAAS,IAAK,SAAiB,CAAC,IAAI,EAAE,CAAC;gBAC1C,QAAQ,GAAI,SAAiB,CAAC,IAAoB,CAAC;gBACnD,MAAM;YACP,CAAC;QACF,CAAC;QAED,IAAI,CAAC,QAAQ,EAAE,CAAC;YACf,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAC3B,OAAO;QACR,CAAC;QAED,6BAA6B;QAC7B,IAAI,CAAC;YACJ,wBAAwB,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QACnD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,wCAAwC;YACxC,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;gBAC3B,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,KAAc,CAAC,CAAC;YAC7C,CAAC;YACD,OAAO,CAAC,KAAK,CAAC,oCAAoC,EAAE,KAAK,CAAC,CAAC;YAC3D,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAC3B,OAAO;QACR,CAAC;QAED,yCAAyC;QACzC,MAAM,KAAK,GAAG,cAAc,CAAC,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;QAEzD,oCAAoC;QACpC,MAAM,UAAU,GAAG,iBAAiB,CAAC,QAAQ,CAAC,SAAS,EAAE,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QAE/E,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;YACzB,6CAA6C;YAC7C,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;gBAC3B,IAAI,CAAC,QAAQ,CAAC,OAAO,CACpB,IAAI,EACJ,IAAI,KAAK,CACR,gCAAgC,QAAQ,CAAC,SAAS,MAAM,UAAU,CAAC,KAAK,EAAE,OAAO,IAAI,eAAe,EAAE,CACtG,CACD,CAAC;YACH,CAAC;YACD,OAAO,CAAC,KAAK,CAAC,+BAA+B,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC;YACjE,iFAAiF;YACjF,iFAAiF;QAClF,CAAC;QAED,iEAAiE;QACjE,MAAM,OAAO,GAAG;YACf,SAAS,EAAE,QAAQ,CAAC,SAAS;YAC7B,KAAK,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK;SACnD,CAAC;QACF,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC/B,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":"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"}

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=player-actor.typecheck.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"player-actor.typecheck.d.ts","sourceRoot":"","sources":["../src/player-actor.typecheck.ts"],"names":[],"mappings":""}

package/dist/player-actor.typecheck.js

@@ -0,0 +1,27 @@
+import { setup } from "xstate";
+import { definePlayer } from "./define-player.js";
+const machine = setup({
+    types: {
+        context: {},
+        input: {},
+        events: {},
+    },
+}).createMachine({
+    context: ({ input }) => ({ value: input.value }),
+    initial: "idle",
+    states: {
+        idle: {},
+    },
+});
+const createPlayer = definePlayer({ machine });
+const actor = createPlayer({ value: 1 });
+const restoredActor = createPlayer({ value: 1 }, { snapshot: actor.getSnapshot() });
+// Verify actor instances are created successfully
+void actor;
+void restoredActor;
+// CONS-16: [key: string]: unknown index signature removed.
+// Accessing unknown properties on PlayerActor is now a type error (correct behavior).
+// @ts-expect-error — unknown fields no longer accessible via index signature
+const unknownField = actor["custom-extension-field"];
+void unknownField;
+//# sourceMappingURL=player-actor.typecheck.js.map

package/dist/player-actor.typecheck.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"player-actor.typecheck.js","sourceRoot":"","sources":["../src/player-actor.typecheck.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAC/B,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,MAAM,OAAO,GAAG,KAAK,CAAC;IACrB,KAAK,EAAE;QACN,OAAO,EAAE,EAAuB;QAChC,KAAK,EAAE,EAAuB;QAC9B,MAAM,EAAE,EAAsB;KAC9B;CACD,CAAC,CAAC,aAAa,CAAC;IAChB,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC;IAChD,OAAO,EAAE,MAAM;IACf,MAAM,EAAE;QACP,IAAI,EAAE,EAAE;KACR;CACD,CAAC,CAAC;AAEH,MAAM,YAAY,GAAG,YAAY,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;AAC/C,MAAM,KAAK,GAAG,YAAY,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;AACzC,MAAM,aAAa,GAAG,YAAY,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;AAEpF,kDAAkD;AAClD,KAAK,KAAK,CAAC;AACX,KAAK,aAAa,CAAC;AAEnB,2DAA2D;AAC3D,sFAAsF;AACtF,6EAA6E;AAC7E,MAAM,YAAY,GAAG,KAAK,CAAC,wBAAwB,CAAC,CAAC;AACrD,KAAK,YAAY,CAAC"}

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

@@ -1,27 +1,33 @@
 import type { RouteContext } from "./types.js";
 /**
- * Build full URL from route template and context
+ * Build a full URL from a route template and the actor's context.
  *
- * Per CONTEXT.md:
- * - "currentRoute derivation: Full URL generation including query params, hash, base path"
- * - "Parameters: String template syntax — /user/:id"
- * - "Inheritance: relative paths inherit parent route"
+ * Substitutes `:param` and `:param?` placeholders from `context.routeParams`
+ * or flat `context` values, then appends query params and hash fragments.
  *
- * Per RESEARCH.md Pattern 3: Replace :param with context values
+ * 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
+ *
+ * @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.
+ * @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`.
  *
  * @example
  * ```typescript
- * const url = buildRouteUrl('/user/:id', {
- *   id: '123',
- *   query: { tab: 'profile' },
- *   hash: 'section-1'
- * });
- * // Result: '/user/123?tab=profile#section-1'
- * ```
+ * buildRouteUrl("/user/:id", { id: "123", query: { tab: "profile" }, hash: "top" });
+ * // → "/user/123?tab=profile#top"
  *
- * @param routeTemplate - Route path with :param placeholders
- * @param context - Route context with parameters, query, hash
- * @returns Full URL string
+ * buildRouteUrl("/settings/:section?", {});
+ * // → "/settings"  (optional param omitted)
+ * ```
  */
 export declare const buildRouteUrl: (routeTemplate: string, context?: RouteContext) => string;
 //# sourceMappingURL=build-url.d.ts.map

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;AAG/C;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,aAAa,GAAI,eAAe,MAAM,EAAE,UAAS,YAAiB,KAAG,MA0BjF,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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,eAAO,MAAM,aAAa,GAAI,eAAe,MAAM,EAAE,UAAS,YAAiB,KAAG,MA6BjF,CAAC"}