@xmachines/play-xstate 3.0.0 → 5.0.0

package/dist/player-actor.js

@@ -1,10 +1,7 @@
 import { Actor, } from "xstate";
-import { AbstractActor, reuseComposedState, shallowEqualExcept, } from "@xmachines/play-actor";
 import { DISPOSE } from "@xmachines/play";
-import { Signal } from "@xmachines/play-signals";
+import { createWritableAtom } from "@xmachines/play-atom";
 import { ActorThrewNonErrorError, InvalidEventError, InvalidMachineError } from "./errors.js";
-import { deriveCurrentRoute, deriveInitialRoute } from "./routing/index.js";
-import { deriveCurrentView } from "./view/derive-current-view.js";
 /**
  * Tells you if a value is an `Error`, by its identity or by its brand: `instanceof`
  * misses an error from another realm, such as an iframe or `node:vm`. The function
@@ -25,13 +22,15 @@ const isRealError = (value) => {
 /**
  * Normalizes a failure of the actor for `onError`.
  *
+ * @internal
+ *
  * The function gives an `Error` to the handler without a change. The error of the
  * machine therefore keeps its identity: an `instanceof` test of a consumer still
  * works, and the path without an `onError` throws that same object again. Every
  * other value is ours to build, and it becomes a `PlayError` with a code. That
  * error carries the value from the throw as its `cause`.
  */
-const toError = (value) => {
+export const toError = (value) => {
     try {
         if (isRealError(value)) {
             return value;
@@ -45,74 +44,32 @@ const toError = (value) => {
     return new ActorThrewNonErrorError(value);
 };
 /**
- * The structural equality of two derived view specs, with a limit on its depth.
- *
- * The function walks exactly the shape that `deriveCurrentView` builds: the spec
- * fields, then `elements`, then the `props` object of each element. It compares
- * each leaf with `Object.is`. It never enters the VALUE of a prop: a new reference
- * therefore emits the view again, also when the contents are equal. This design
- * keeps two things correct: a prop of a container (a Map, a Set, or an instance of a
- * class, which a structural comparison cannot see), and a cyclic value, which gives
- * a structural comparison a recursion without an end.
- */
-const viewSpecsEquivalent = (a, b) => {
-    if (a === b)
-        return true;
-    if (!a || !b)
-        return false;
-    if (!shallowEqualExcept(a, b, "elements"))
-        return false;
-    const aElements = a.elements ?? {};
-    const bElements = b.elements ?? {};
-    // A derived spec spreads the same static meta.view. Therefore the elements
-    // usually have the same reference, and the walk over each element is then not
-    // necessary.
-    if (aElements === bElements)
-        return true;
-    const elementKeys = Object.keys(aElements);
-    if (elementKeys.length !== Object.keys(bElements).length)
-        return false;
-    for (const key of elementKeys) {
-        const aElement = aElements[key]; // nosemgrep: gitlab.eslint.detect-object-injection
-        const bElement = bElements[key]; // nosemgrep: gitlab.eslint.detect-object-injection
-        if (aElement === bElement)
-            continue;
-        if (!aElement || !bElement)
-            return false;
-        if (!shallowEqualExcept(aElement, bElement, "props"))
-            return false;
-        if (!shallowEqualExcept(aElement.props ?? {}, bElement.props ?? {}))
-            return false;
-    }
-    return true;
-};
-/**
- * Tells you if a snapshot is worth a propagation to the signals: an active
+ * Tells you if a snapshot is worth a propagation to the atoms: an active
  * snapshot, or a "done" snapshot, which means that the machine reached a final state
  * at the top level. The code skips an error snapshot and a stopped snapshot.
- * Therefore the signals keep the last observable state, and they show no artifact of
+ * Therefore the atoms keep the last observable state, and they show no artifact of
  * a teardown or of an error.
  */
 const isObservableSnapshot = (snapshot) => snapshot.status === "active" || snapshot.status === "done";
 /**
- * The concrete XState actor. It implements the signal protocol of the Play Architecture
+ * The concrete XState actor. It implements the atom protocol of the Play Architecture
  *
- * The class extends {@link @xmachines/play-actor!AbstractActor}, and therefore the
- * `Actor` class of XState. It gives you the XState v5 integration, and it keeps the
+ * The class extends the `Actor` class of XState directly, and it implements
+ * {@link @xmachines/play-actor!PlayActor}. It gives you the XState v5 integration, and it keeps the
  * compatibility with the ecosystem, such as the XState inspection and the devtools.
  * The constructor of the base class receives the machine. Therefore a `PlayerActor`
  * **is** the XState actor, and it is no wrapper around one: every member of the
  * XState `Actor` class works on the state of this instance, and this class adds the
- * reactive state on the TC39 Signals for the observation by the infrastructure.
+ * reactive state on the atoms for the observation by the infrastructure.
  *
  * **Capabilities:** the class implements both the
- * {@link @xmachines/play-actor!Routable} interface and the
- * {@link @xmachines/play-actor!Viewable} interface. It therefore supports the
+ * {@link @xmachines/play-router!index.Routable} interface and the
+ * {@link @xmachines/play-view!index.Viewable} interface. It therefore supports the
  * routing and the view rendering.
  *
  * **Architectural context:** the class implements **Actor Authority (INV-01)**,
  * because the guards of the XState machine control every decision of the
- * navigation. The infrastructure observes the signals of the actor (`state`,
+ * navigation. The infrastructure observes the atoms of the actor (`state`,
  * `currentRoute`, and `currentView`), but it changes no state directly: every
  * change goes through the event handlers of the state machine.
  *
@@ -122,7 +79,7 @@ const isObservableSnapshot = (snapshot) => snapshot.status === "active" || snaps
  * The creation of an actor, and its lifecycle
  * ```typescript
  * import { setup } from "xstate";
- * import { definePlayer } from "@xmachines/play-xstate";
+ * import { definePlayer, compose, PlayerActor } from "@xmachines/play-xstate";
  *
  * const machine = setup({}).createMachine({
  *   initial: 'idle',
@@ -144,33 +101,31 @@ const isObservableSnapshot = (snapshot) => snapshot.status === "active" || snaps
  * const actor = createPlayer();
  * actor.start();
  *
- * // Observe the signals
+ * // Observe the atoms
  * console.log(actor.currentRoute.get());          // '/'
  * console.log(actor.currentView.get()?.root);     // 'home'
  * ```
  *
  * @example
- * The signal lifecycle with a watcher
+ * The atom lifecycle with a watch
  * ```typescript
- * import { Signal } from "@xmachines/play-signals";
+ * import { watchAtom } from "@xmachines/play-atom";
  *
- * const watcher = new Signal.subtle.Watcher(() => {
- *   queueMicrotask(() => {
- *     const pending = watcher.getPending();
- *     console.log('State changed:', actor.state.get());
- *   });
+ * const stop = watchAtom(actor.state, (snapshot) => {
+ *   console.log('State changed:', snapshot.value);
  * });
  *
- * watcher.watch(actor.state);
  * actor.send({ type: 'play.route', to: '#about' });
- * // The watcher schedules its own notification in a microtask
+ * // watchAtom delivers the new value from a microtask
+ *
+ * stop();
  * ```
  *
  * @see [Play RFC](../../docs/rfc/play.md)
  * @see {@link definePlayer} for the creation through a factory
- * @see {@link @xmachines/play-actor!AbstractActor} for the signal protocol
- * @see {@link @xmachines/play-actor!Routable} for the routing capability
- * @see {@link @xmachines/play-actor!Viewable} for the view rendering capability
+ * @see {@link @xmachines/play-actor!PlayActor} for the atom protocol
+ * @see {@link @xmachines/play-router!index.Routable} for the routing capability
+ * @see {@link @xmachines/play-view!index.Viewable} for the view rendering capability
  *
  * @remarks
  * **The routing:** this actor supports the `route: {}` config pattern of XState and
@@ -178,13 +133,27 @@ const isObservableSnapshot = (snapshot) => snapshot.status === "active" || snaps
  * `meta.route`, which is the Stately pattern, for a URL template, and it substitutes
  * each parameter.
  *
- * **The pattern of the view signal:** the `currentView` signal is a direct
- * `Signal.State`, and not a `Signal.Computed`. The propagation to a watcher in
- * PlayRenderer is therefore correct. The class derives each view at the entry of a
- * state and keeps it, and it computes no view on a read.
+ * **The pattern of the view atom:** `withView` of `@xmachines/play-xstate/view` adds
+ * `currentView`, and that atom is a COMPUTED atom over `state`. One write for each
+ * transition — `state.set(snapshot)` — therefore reaches the view and the route in one
+ * flush, and no subscriber reads the new state beside an old derivation. The atom
+ * memoizes the result, so a repeated read computes no view again.
  */
-export class PlayerActor extends AbstractActor {
+export class PlayerActor extends Actor {
     playerOptions;
+    /**
+     * The three inputs of the constructor that a CAPABILITY needs.
+     *
+     * A mixin over a generic base cannot declare a constructor: TypeScript then demands the
+     * signature `...args: any[]` (TS2545), which this workspace does not write. A field
+     * initializer of a subclass runs after `super()` instead, and it reads these. The
+     * routing capability derives `initialRoute` from all three.
+     */
+    playerMachine;
+    /** @see {@link playerMachine} */
+    playerInput;
+    /** @see {@link playerMachine} */
+    playerRestoredSnapshot;
     /**
      * The live options object of the caller, or an empty object during the construction.
      *
@@ -204,22 +173,13 @@ export class PlayerActor extends AbstractActor {
     get hooks() {
         return this.playerOptions ?? {};
     }
-    /**
-     * The last snapshot of the view pipeline. XState notifies each observer on EVERY
-     * event that it processes, and an event that it ignores delivers the identical
-     * snapshot again. deriveCurrentView is pure in the snapshot. Therefore an identical
-     * reference can change no result. The first value is undefined, and never a
-     * snapshot: the snapshot of the construction has the same reference as the snapshot
-     * that start() replays, and that value therefore stops the first view.
-     */
-    lastViewSnapshot = undefined;
-    // The requirements of the AbstractActor protocol
+    // The requirements of the PlayActor contract
     state;
     /**
      * Tells you if the current state of the actor accepts the given event.
      *
      * The type is the event union of the machine. An unknown event type is therefore a
-     * compile error. The method evaluates the event against the snapshot signal.
+     * compile error. The method evaluates the event against the snapshot atom.
      *
      * @example
      * ```typescript
@@ -227,85 +187,26 @@ export class PlayerActor extends AbstractActor {
      * ```
      */
     can(event) {
-        // A read of the signal keeps can() reactive: a Signal.Computed over the signal
-        // computes its value again on each transition. Two states have no answer: the
-        // construction window, where the code can read no snapshot, and an actor with a
-        // failed initialization, where XState parks an error snapshot. That snapshot is
-        // a truthy object, and it has no `can` method.
+        // A read of the atom keeps can() reactive: a computed atom over the atom
+        // computes its value again on each transition.
         const snapshot = this.state?.get();
-        return typeof snapshot?.can === "function" ? snapshot.can(event) : false;
+        // The STATUS decides first, and the presence of the method decides second.
+        //
+        // An actor answers an event only while it is active. XState 5.32 made that test
+        // unnecessary by accident — the error snapshot of a failed initialization carried no
+        // `can` method, so a test of the method alone answered `false` for it — and 5.33
+        // gives that snapshot a working `can`, which then answered `true` for an actor that
+        // processes an event never. The status is what the question is really about, and a
+        // `done` actor answers `false` for the same reason.
+        //
+        // A STOPPED actor is the exception, and it is deliberate: the subscription below
+        // updates this atom on a stable state alone, so the atom keeps the last ACTIVE
+        // snapshot after a teardown rather than freezing on an artifact of it. `can()`
+        // therefore answers for the last live state of a stopped actor.
+        if (snapshot?.status !== "active")
+            return false;
+        return typeof snapshot.can === "function" ? snapshot.can(event) : false;
     }
-    /**
-     * A TC39 `Signal.Computed`. It derives the current URL path from the `meta.route`
-     * template of the active machine state and from the context of the actor.
-     *
-     * It returns `null` when the current state has no `meta.route` field, and also when
-     * it cannot resolve the complete route template. A necessary `:param` that the
-     * context does not hold is caught inside the signal, and a
-     * `MissingRouteParamError` therefore never leaves `get()`: that condition is
-     * temporary during a transition, and the signal computes the value again on the next
-     * snapshot.
-     *
-     * @example
-     * ```typescript
-     * // It returns "/profile/alice" when context.params.userId === "alice",
-     * // and null while the param is still absent.
-     * const route = actor.currentRoute.get();
-     * ```
-     */
-    currentRoute;
-    /**
-     * The route of the initial state of the machine. The constructor fixes it, and it
-     * never changes, also when the code restores the actor from a snapshot.
-     *
-     * A router bridge compares it with the browser URL, and it therefore separates a
-     * deep link (a URL that is not the initial one → the router wins) from a restore
-     * (the initial URL, and the actor at a different route from the restore → the actor
-     * wins).
-     *
-     * `deriveInitialRoute` derives the value statically from the machine definition,
-     * with the pure `initialTransition` helper of XState: the chain of the initial states
-     * and their `meta.route` templates are fixed at the moment of the machine
-     * definition, and the substitution of a `:param` uses the real initial context of
-     * the machine for the `input` of this actor. The code makes no second actor, and a
-     * snapshot of a restore changes the value never: it is always the **default**
-     * initial route of the machine.
-     */
-    initialRoute;
-    /**
-     * The reactive signal of the current view spec. The signal derives the spec from
-     * the `meta.view` metadata of the active state.
-     *
-     * It emits a **new object reference** on each real change of the view on the
-     * screen: the view of a different state, or a change of a param or of the context
-     * that changes the resolved spec. A re-entry with `reenter: true` and new params
-     * also changes the spec. A snapshot that changes no view on the screen, such as an
-     * assign of the context alone, keeps the previous reference. A provider below the
-     * signal therefore mounts the UI again not on every event.
-     *
-     * The `PlaySpec` of the emission carries the context of the machine in its composed
-     * `state` field, under the read-only `/context` subtree. A spec therefore reads the
-     * context, and also each URL param, through the ordinary state grammar
-     * (`{ $state: "/context/params/section" }`). The context-projection module of
-     * `@xmachines/play-actor` holds the complete contract.
-     *
-     * The signal returns `null` when the current state has no `meta.view` metadata.
-     *
-     * Two states can declare two separate `meta.view` literals with an identical
-     * structure. A transition between those two states then emits two different
-     * references, and a provider mounts the UI again. Move the shared literal into one
-     * `typedSpec` constant, and the identity then removes the duplicate.
-     *
-     * @example
-     * ```typescript
-     * const view = actor.currentView.get();
-     * if (view) {
-     *   console.log(view.root);     // for example "root"
-     *   console.log(view.elements); // the Spec elements of @xmachines/json-render-core
-     * }
-     * ```
-     */
-    currentView = new Signal.State(null);
     constructor(machine, options, input, restoredSnapshot) {
         // A defensive check before super(): a machine that is not an object fails deep
         // inside the constructor of XState, with an opaque TypeError, and not with a coded
@@ -329,30 +230,19 @@ export class PlayerActor extends AbstractActor {
             snapshot: restoredSnapshot,
             inspect: options?.inspect,
         });
-        // Derive the initial route of the machine, for the detection of a restore or a
-        // deep link. The value is always the DEFAULT initial route of the machine, and
-        // never the route of the restored state. Without a snapshot of a restore, the
-        // pre-start snapshot of this actor IS that default initial state, and the code
-        // derives the route from it directly. A restore alone needs the pure
-        // `initialTransition` helper of XState. The inert actor scope of that helper runs
-        // the initial transition of the machine two more times, and one of them has an
-        // undefined `input`. This is a quirk of XState, and it costs too much for each
-        // other case.
-        this.initialRoute =
-            restoredSnapshot === undefined
-                ? deriveCurrentRoute(this.getSnapshot())
-                : deriveInitialRoute(machine, input);
+        this.playerMachine = machine;
+        this.playerInput = input;
+        this.playerRestoredSnapshot = restoredSnapshot;
         this.playerOptions = options || {};
-        // Initialize the state signal. Each update is synchronous, with no batching in a
+        // Initialize the state atom. Each update is synchronous, with no batching in a
         // microtask: XState groups the transitions of one send() call into one
         // subscription callback already, and a synchronous update shows each guard
         // redirect to a router bridge at once.
-        this.state = new Signal.State(this.getSnapshot());
-        // Initialize the currentRoute computed signal
-        this.currentRoute = new Signal.Computed(() => {
-            const snapshot = this.state.get();
-            return deriveCurrentRoute(snapshot);
-        });
+        // `createWritableAtom`, and not `createAtom`. The overload pair of `createAtom` reads
+        // a function argument as a computed atom, and `ReturnType<TMachine["transition"]>` is
+        // an unresolved conditional type here, so TypeScript cannot rule a function out. It
+        // picks the computed signature, which returns a `ReadonlyAtom` that carries no `set`.
+        this.state = createWritableAtom(this.getSnapshot());
         // Observe the transitions of this actor. The code uses `super`, and not `this`, so
         // that the bookkeeping of the next-only subscriptions in the subscribe override
         // stays about the subscriptions of the user code.
@@ -360,18 +250,25 @@ export class PlayerActor extends AbstractActor {
             next: (snapshot) => {
                 // Update on a stable state only: an active snapshot, and the "done" snapshot of a
                 // final state at the top level. The code skips an error snapshot and a stopped
-                // snapshot. Therefore a signal never freezes on an artifact of a teardown.
+                // snapshot. Therefore an atom never freezes on an artifact of a teardown.
                 if (isObservableSnapshot(snapshot)) {
                     // Each state update is synchronous. Therefore a router bridge sees a guard redirect at once.
                     this.state.set(snapshot);
-                    // Check the view and keep it after state and currentRoute hold their new values,
-                    // and before the hooks.
-                    // The order of the hooks is deliberate:
-                    // 1. state and currentRoute receive their new values
-                    // 2. currentView holds the new view
+                    // ONE write for each transition, and the line above is it. `currentRoute` and
+                    // `currentView` are computed atoms over `state`, so that write propagates to
+                    // both in ONE flush, in topological order. No observer therefore reads the new
+                    // state beside an old derivation, and the composition order of the capabilities
+                    // decides nothing.
+                    //
+                    // `onSnapshot` remains for a capability that must run an EFFECT on a
+                    // transition. A capability that publishes a value derives it instead.
+                    //
+                    // The whole order of one transition:
+                    // 1. state receives its new value, and every computed atom over it follows
+                    // 2. onSnapshot runs each capability, in the composition order
                     // 3. the onStateChange hook runs
                     // 4. send() then calls onTransition
-                    this.validateAndCacheView(snapshot);
+                    this.onSnapshot(snapshot);
                     // Call the onStateChange hook
                     const onStateChange = this.hooks.onStateChange;
                     if (onStateChange) {
@@ -443,7 +340,7 @@ export class PlayerActor extends AbstractActor {
         // A call that reaches in through the construction window, for example a context
         // factory that stops its own `self`, marks the actor as stopped before the code
         // registers its internal subscription. XState drops each observer of a stopped
-        // actor. The signals therefore move never again. There is nothing to tear down
+        // actor. The atoms therefore move never again. There is nothing to tear down
         // during the construction, and the code ignores such a call.
         if (!this.constructed) {
             return this;
@@ -496,7 +393,7 @@ export class PlayerActor extends AbstractActor {
         // must still run for it, with the correct snapshot from before the send.
         const prevSnapshot = this.getSnapshot();
         // Send the event to the XState actor.
-        // `AbstractActor` declares send() as abstract for one reason only, to narrow the
+        // The class declares send() to narrow the
         // event type, and TypeScript forbids a super call to an abstract member.
         // Therefore the code reaches the implementation of XState directly. `this` IS the
         // actor. This call is therefore exactly the call of `super.send(event)`: the relay
@@ -510,12 +407,6 @@ export class PlayerActor extends AbstractActor {
             onTransition(this, prevSnapshot, nextSnapshot);
         }
     }
-    /**
-     * Returns the current snapshot
-     */
-    getSnapshot() {
-        return super.getSnapshot();
-    }
     subscribe(nextListenerOrObserver, errorListener, completeListener) {
         // The subscribe() method of XState accepts a function and also an observer, and it
         // normalizes them internally. The cast joins the two overload signatures only.
@@ -542,16 +433,6 @@ export class PlayerActor extends AbstractActor {
             },
         };
     }
-    /**
-     * Listens for the events that this actor emits with the `emit` action.
-     *
-     * @param type - The type of the emitted event to listen for, or `"*"` for every event.
-     * @param handler - The actor calls it with each emitted event that matches.
-     * @returns The subscription, with an `unsubscribe()` method.
-     */
-    on(type, handler) {
-        return super.on(type, handler);
-    }
     /**
      * Returns the persisted snapshot of this actor.
      *
@@ -563,55 +444,28 @@ export class PlayerActor extends AbstractActor {
         return forward.call(this, options);
     }
     /**
-     * Derives the view at the entry of a state, and keeps it. This happens one time for
-     * each transition. The signal holds the view, and the code computes it not on each
-     * read.
+     * The point where a capability derives its own atoms from a new snapshot.
      *
-     * @param snapshot - The current XState snapshot
-     */
-    validateAndCacheView(snapshot) {
-        if (snapshot === this.lastViewSnapshot) {
-            return;
-        }
-        this.lastViewSnapshot = snapshot;
-        try {
-            const view = deriveCurrentView(snapshot);
-            // Emit only after a real change of the view on the screen: deriveCurrentView
-            // returns a fresh object on each call, and the identity of the reference therefore
-            // tells nothing. A new reference for a snapshot that changes the view not, for
-            // example a context-only assign, makes a provider below mount the UI again, and
-            // that removes the state of the view. A deep equality test is deliberately NOT
-            // here: it sees nothing inside a Map or a Set, and it therefore stops a real
-            // change, and it recurses without an end on a cyclic prop. The last spec of an
-            // emission IS the current value of the signal. Read it without a track, so that
-            // the gate registers currentView never as a dependency of a computation around
-            // it.
-            const lastEmittedView = Signal.subtle.untrack(() => this.currentView.get());
-            // Use the reference of the previous composed state again when the value of the
-            // /context projection did not change. A context-only assign that changes no
-            // projected value therefore changes the identity of the state not.
-            const nextView = reuseComposedState(lastEmittedView, view);
-            if (viewSpecsEquivalent(lastEmittedView, nextView)) {
-                return;
-            }
-            this.currentView.set(nextView);
-        }
-        catch (error) {
-            const onError = this.hooks.onError;
-            if (onError) {
-                onError(this, toError(error));
-            }
-            // On an error: keep the last valid view, and clear it not
-        }
-    }
-    /**
-     * The dispose method, for the cleanup. It is the alias of {@link stop}.
+     * The base derives nothing: `PlayActor` asks for `state` and `send`, and this class
+     * gives exactly those.
+     *
+     * A capability that PUBLISHES a value overrides this method NOT. It derives the value
+     * with a computed atom over `state`, as `withRouting` and `withView` both do, and the
+     * engine then evaluates every derivation from the one write of a transition, in
+     * topological order. The composition order therefore decides no value.
      *
-     * @deprecated Use {@link stop}, or a `using` declaration. Will be removed in the
-     *   next major.
+     * This method remains for a capability that must run an EFFECT on a transition. Such a
+     * mixin overrides it and calls `super.onSnapshot(snapshot)` FIRST, so that every
+     * capability composed before it runs its own effect first.
+     *
+     * The method runs after `state` holds the new snapshot and before the `onStateChange`
+     * hook of the options.
+     *
+     * @param snapshot - The stable snapshot of this transition.
      */
-    dispose() {
-        this.stop();
+    onSnapshot(snapshot) {
+        // The base class holds no capability. A mixin overrides this method.
+        void snapshot;
     }
     /**
      * Stops the actor when the scope of a `using` declaration ends.

package/dist/player-actor.js.map

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

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

@@ -1,3 +1,4 @@
+import type { ParseOptions } from "@xmachines/play-pattern";
 import type { RouteContext } from "./types.js";
 /**
  * Builds a complete URL from a route template and the context of the actor.
@@ -16,12 +17,18 @@ import type { RouteContext } from "./types.js";
  * @param context - The context object of the actor. Each route parameter must be in
  *   `context.params`, because the function reads no flat context field. An absent
  *   `query` field builds a URL without a query, exactly like `query: {}`.
+ * @param options - The caches to read, as {@link ParseOptions}. The default is the cache
+ *   that `@xmachines/play-pattern` shares with every caller of the process. A parse is
+ *   deterministic, so this changes how often the parser runs and it changes no answer.
  * @returns The complete URL string.
  *
  * @throws {MissingRouteParamError} When a **necessary** `:param` placeholder has no
  *   value in the context. The function omits an optional parameter (`:param?`) in
  *   silence when its value is absent. Import the class from
  *   `@xmachines/play-xstate/errors`.
+ * @throws {InvalidRouteParamError} When a `:param` placeholder carries a dot segment,
+ *   which a URL resolves away. The template matches the built URL back never, so the
+ *   actor and the address bar would stay out of step.
  *
  * @example
  * ```typescript
@@ -32,5 +39,5 @@ import type { RouteContext } from "./types.js";
  * // → "/settings"  (the optional param is absent, and there is no query string)
  * ```
  */
-export declare const buildRouteUrl: (routeTemplate: string, context?: RouteContext) => string;
+export declare const buildRouteUrl: (routeTemplate: string, context?: RouteContext, options?: ParseOptions) => 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;AAI/C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,eAAO,MAAM,aAAa,GACzB,eAAe,MAAM,EACrB,UAAS,YAA4B,KACnC,MAwCF,CAAC"}
+{"version":3,"file":"build-url.d.ts","sourceRoot":"","sources":["../../src/routing/build-url.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAI/C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,eAAO,MAAM,aAAa,GACzB,eAAe,MAAM,EACrB,UAAS,YAA4B,EACrC,UAAU,YAAY,KACpB,MAgEF,CAAC"}