@xmachines/play-dom 2.0.0 → 2.1.0

package/dist/PlayRenderer.js

@@ -1,12 +1,14 @@
 /**
- * PlayRenderer.ts — XMachines wrapper around @xmachines/json-render-dom.
+ * PlayRenderer.ts — the XMachines wrapper of @xmachines/json-render-dom.
  *
- * Bridges actor.currentView (TC39 Signal) to the inner DOM renderer using watchSignal.
- * Exposes connect() / disconnect() methods following the same pattern as
- * play-react, play-vue, and play-solid PlayRenderer classes.
+ * It connects actor.currentView, a TC39 Signal, to the DOM renderer below it, with
+ * watchSignal. It gives you the connect() method and the disconnect() method, in
+ * the same pattern as the PlayRenderer class of play-react, of play-vue, and of
+ * play-solid.
  *
- * State store: uses external `store` option if provided (controlled mode); otherwise
- * creates a fresh @xstate/store atom per view transition seeded from spec.state.
+ * The state store: the renderer uses the external `store` option when the caller
+ * gives one, and this is the controlled mode. Without that option, it makes a new
+ * @xstate/store atom for each view transition, with the values of spec.state.
  */
 import { watchSignal } from "@xmachines/play-signals";
 import { createAtom } from "@xstate/store";
@@ -14,26 +16,27 @@ import { xstateStoreStateStore } from "@xmachines/json-render-xstate";
 import { createViewStoreLifecycle, refreshContextSubtree } from "@xmachines/play-actor";
 import { createIncrementalRenderer } from "@xmachines/json-render-dom";
 /**
- * PlayRenderer connects an actor's `currentView` signal to the DOM renderer.
+ * PlayRenderer connects the `currentView` signal of an actor to the DOM renderer.
  *
- * Watches `actor.currentView` via TC39 Signals and renders `DomComponentRenderer`
- * functions into `container` on every view transition. Cleared on `disconnect()`.
+ * It watches `actor.currentView` through the TC39 Signals. It renders each
+ * `DomComponentRenderer` function into `container` on every view transition.
+ * `disconnect()` clears the container.
  *
- * Options from `PlayDomOptions` (which extends `UIProviderOptions`) are all forwarded
- * into `DomRenderContext` on every render pass:
- * - `functions` — named compute functions for `{ $computed: "name" }` prop expressions
- * - `directives` — custom `$`-prefixed dynamic values (from `defineDirective`), resolved during prop resolution
- * - `validationFunctions` — custom validation functions, available at `ctx.ctx.validationFunctions`
- * - `navigate` — navigation callback, invoked on `onSuccess: { navigate: "..." }` action bindings
- * - `onRenderError` — called with `(error, name)` for component render errors and action handler rejections
+ * Every option of `PlayDomOptions`, which extends `UIProviderOptions`, goes into
+ * `DomRenderContext` on each render pass:
+ * - `functions` — the named compute functions of a `{ $computed: "name" }` prop expression
+ * - `directives` — your own dynamic values with a `$` prefix, from `defineDirective`. The renderer resolves them with the props
+ * - `validationFunctions` — your own check functions. They are available at `ctx.ctx.validationFunctions`
+ * - `navigate` — the navigation callback. The renderer calls it for an `onSuccess: { navigate: "..." }` action binding
+ * - `onRenderError` — the renderer calls it with `(error, name)` for a component render error and for an action handler rejection
  *
- * **Preferred usage — via `registryResult`:**
+ * **The preferred use, with `registryResult`:**
  * ```typescript
  * import { PlayRenderer, defineRegistry } from "@xmachines/play-dom";
  *
  * const registryResult = defineRegistry(catalog, { components, actions });
  * const renderer = new PlayRenderer(container, actor, registryResult.registry, {
- *   registryResult, // wires setState/getState from xstate store automatically
+ *   registryResult, // it connects setState and getState of the xstate store for you
  *   navigate: (path) => myRouter.push(path),
  *   functions: { fullName: (args) => `${args.first} ${args.last}` },
  * });
@@ -42,7 +45,7 @@ import { createIncrementalRenderer } from "@xmachines/json-render-dom";
  * renderer.disconnect();
  * ```
  *
- * **Controlled store mode** — bring your own `StateStore`:
+ * **The controlled store mode** — you give your own `StateStore`:
  * ```typescript
  * import { createAtom } from "@xstate/store";
  * import { xstateStoreStateStore } from "@xmachines/json-render-xstate";
@@ -53,8 +56,9 @@ import { createIncrementalRenderer } from "@xmachines/json-render-dom";
  * renderer.connect();
  * ```
  *
- * Double `connect()` is safe — calling `connect()` while already connected
- * automatically disconnects first, preventing double-render subscriptions.
+ * A second `connect()` is safe. A `connect()` call on a connected renderer
+ * disconnects it first. Therefore the renderer holds no second render
+ * subscription.
  */
 export class PlayRenderer {
     container;
@@ -64,56 +68,56 @@ export class PlayRenderer {
     unwatch = null;
     storeUnsubscribe = null;
     /**
-     * Live watch-subscription cleanups. A `Set` (not an array) so that each
-     * registered cleanup can delete ITSELF on invocation: the incremental
-     * renderer releases a watcher when its element unmounts, and the registered
-     * wrapper is what it invokes — so the Set shrinks in lock-step with live
-     * subscriptions instead of accumulating one spent closure per historical
-     * mount over a long-lived view.
+     * The cleanup functions of the live watch subscriptions. This field is a `Set`,
+     * and not an array, so that each registered cleanup function can delete ITSELF on
+     * its call: the incremental renderer releases a watcher when its element unmounts,
+     * and it calls the registered wrapper. The Set therefore shrinks with the live
+     * subscriptions. It does not collect one spent closure for each historical mount of
+     * a view with a long life.
      */
     watchCleanups = new Set();
     /**
-     * viewKey of the currently rendered view and the (unguarded) store backing
-     * it. A same-key emission means only the /context projection moved: the
-     * slice-only fast path in render() refreshes the store in place instead of
-     * tearing the tree down, so ephemeral view state (drafts, toggles) survives.
-     * A null emission (a state with no meta.view) is a GAP, not a new view:
-     * the DOM tears down but the identity and store are kept, so returning to
-     * the same view rebuilds around the surviving ephemeral state — matching
-     * the framework providers. Reset in disconnect() — a kept-alive store must
-     * not outlive the connection.
+     * The viewKey of the view on the screen now, and the store behind it, without the
+     * guard. An emission with the same key means that only the /context projection
+     * moved: the fast path for a slice in render() refreshes the store in place, and it
+     * does not remove the tree. The ephemeral view state, such as a draft or a toggle,
+     * therefore stays. A null emission, from a state with no meta.view, is a GAP, and
+     * not a new view: the DOM goes away, but the identity and the store stay. A return
+     * to the same view therefore builds again around the ephemeral state that survived,
+     * in the same way as the framework providers. `disconnect()` resets both fields,
+     * because a store that stays alive must not outlive the connection.
      */
     lastViewKey = undefined;
     currentStore = null;
     /**
-     * Store lifecycle (reseed on viewKey change, refresh /context in place
-     * otherwise, guard identity cache) — the shared coordinator from
-     * @xmachines/play-actor. lastViewKey/currentStore above remain DOM-side
-     * bookkeeping for the slice-only fast path, which is about the live TREE
-     * (spec + subscription), not the store.
+     * The shared coordinator of the store lifecycle, from @xmachines/play-actor. It
+     * seeds the store again on a change of the viewKey, it refreshes /context in place
+     * in every other case, and it guards the identity cache. The two fields above,
+     * lastViewKey and currentStore, stay as the DOM-side record for the fast path of a
+     * slice. That path is about the live TREE, which is the spec and the subscription,
+     * and not about the store.
      */
     storeLifecycle = createViewStoreLifecycle((seed) => xstateStoreStateStore({ atom: createAtom(seed) }));
     /**
-     * Set to `false` in `disconnect()` before calling `storeUnsub()`.
-     * The `rerender` closure checks this flag at entry so that any synchronous
-     * callback fired by the `StateStore` implementation within its own
-     * `unsubscribe()` call (an edge-case but valid contract) does not mutate a
-     * detached DOM tree.
+     * `disconnect()` sets this field to `false` before it calls `storeUnsub()`.
+     * The `rerender` closure reads the flag at its start. Therefore a synchronous
+     * callback from the `StateStore` implementation inside its own `unsubscribe()`
+     * call, which is rare but correct, changes no detached DOM tree.
      */
     alive = true;
     /**
-     * @param container - `HTMLElement` to render into. Cleared and repopulated on every view transition.
-     * @param actor     - Actor providing the `currentView` signal (must implement `Viewable`).
-     * @param registry  - Component renderer map — typically `registryResult.registry` from `defineRegistry`.
-     * @param options   - Configuration (see {@link PlayDomOptions}):
-     *   - `registryResult`      — auto-wires `setState`/`state` from the xstate store.
-     *   - `store`               — external `StateStore` (controlled mode; overrides `spec.state` seeding).
-     *   - `loading`             — streaming mode flag; suppresses missing-child warnings.
-     *   - `functions`           — named compute functions for `$computed` prop expressions.
-     *   - `directives`          — custom `$`-prefixed dynamic values resolved during prop resolution.
-     *   - `validationFunctions` — custom validation functions; available at `ctx.ctx.validationFunctions`.
-     *   - `navigate`            — navigation callback; invoked on `onSuccess: { navigate: "..." }`.
-     *   - `onRenderError`       — `(error, name)` handler for component render errors and action handler rejections; suppresses `console.error` fallback.
+     * @param container - The `HTMLElement` to render into. Each view transition clears it and fills it again.
+     * @param actor     - The actor with the `currentView` signal. It must implement `Viewable`.
+     * @param registry  - The map of the component renderers, usually `registryResult.registry` from `defineRegistry`.
+     * @param options   - The configuration. See {@link PlayDomOptions}:
+     *   - `registryResult`      — it connects `setState` and `state` of the xstate store for you.
+     *   - `store`               — an external `StateStore`, which is the controlled mode. It replaces the values of `spec.state`.
+     *   - `loading`             — the flag of the streaming mode. It stops each warning about an absent child.
+     *   - `functions`           — the named compute functions of a `$computed` prop expression.
+     *   - `directives`          — your own dynamic values with a `$` prefix. The renderer resolves them with the props.
+     *   - `validationFunctions` — your own check functions. They are available at `ctx.ctx.validationFunctions`.
+     *   - `navigate`            — the navigation callback. The renderer calls it for `onSuccess: { navigate: "..." }`.
+     *   - `onRenderError`       — the `(error, name)` handler of a component render error and of an action handler rejection. It stops the `console.error` fallback.
      */
     constructor(container, actor, registry, options = {}) {
         this.container = container;
@@ -122,13 +126,13 @@ export class PlayRenderer {
         this.options = options;
     }
     /**
-     * Start watching actor.currentView and render to container.
-     * Renders the initial view synchronously, then subscribes to signal changes.
+     * Starts the watch of actor.currentView, and renders into the container.
+     * It renders the first view synchronously, then it subscribes to the signal changes.
      *
-     * Calling `connect()` on an already-connected renderer (where a previous
-     * `connect()` was never followed by `disconnect()`) would silently install a
-     * second `watchSignal` subscription, causing double-renders on every view
-     * change. Guard against this by auto-disconnecting first.
+     * A `connect()` call on a connected renderer, where a `disconnect()` call did not
+     * follow the previous `connect()`, installs a second `watchSignal` subscription.
+     * Each view change then renders two times. Therefore this method disconnects the
+     * renderer first.
      */
     connect() {
         if (this.unwatch !== null)
@@ -137,53 +141,55 @@ export class PlayRenderer {
         this.unwatch = watchSignal(this.actor.currentView, (view) => this.render(view));
     }
     /**
-     * Stop watching and clear the container.
+     * Stops the watch and clears the container.
      */
     disconnect() {
         this.unwatch?.();
         this.unwatch = null;
-        // Null the refs first so any in-flight rerender callback sees null and skips.
-        // Capture the arrays/functions before clearing so we call the correct cleanups
-        // even if unsubscribing the store triggers a synchronous rerender that would
-        // otherwise overwrite watchCleanups before we iterate them.
+        // Set the refs to null first. A rerender callback that is still in flight therefore
+        // sees null, and it stops.
+        // Capture each array and each function before the code clears them. Therefore the
+        // code calls the correct cleanup functions, also when the cancellation of the store
+        // subscription starts a synchronous rerender. Without the capture, that rerender
+        // overwrites watchCleanups before the loop over them.
         const storeUnsub = this.storeUnsubscribe;
         const watchCleanups = [...this.watchCleanups];
         this.storeUnsubscribe = null;
         this.watchCleanups = new Set();
-        // Set alive = false before calling storeUnsub() so that any synchronous
-        // rerender callback triggered within unsubscribe() exits immediately.
+        // Set alive = false before the storeUnsub() call. A synchronous rerender callback
+        // from inside unsubscribe() therefore returns at once.
         this.alive = false;
         storeUnsub?.();
         for (const cleanup of watchCleanups)
             cleanup();
         this.container.replaceChildren();
-        // Lifetime rule: the kept-alive store dies with the connection.
+        // The rule of the lifetime: the store that stays alive dies with the connection.
         this.lastViewKey = undefined;
         this.currentStore = null;
         this.storeLifecycle.reset();
     }
     /**
-     * Number of live watch-subscription cleanups currently retained.
+     * The number of live watch-subscription cleanup functions now.
      *
-     * @internal Test-only accessor for asserting that the watch-cleanup
-     * collection tracks live registrations (no per-mount leak). Not part of the
-     * public API and may change without notice.
+     * @internal This accessor is for a test only. A test asserts with it that the
+     * collection of the watch cleanups holds the live registrations, and that no mount
+     * leaks. It is not part of the public API, and it can change without a notice.
      */
     get watchCleanupCount() {
         return this.watchCleanups.size;
     }
     render(view) {
-        // ── Slice-only fast path ────────────────────────────────────────────
-        // Same viewKey as the live tree → only the /context projection changed
-        // (deriveCurrentView keys emissions to the selected meta entry, and the
-        // authored spec is static per state). Refresh the store subtree in place
-        // — the store subscription below already drives incremental.update(),
-        // which diffs snapshots and patches only affected elements — and skip
-        // the teardown entirely so ephemeral view state survives.
-        // createIncrementalRenderer binds the SPEC at construction, so this
-        // path is only safe because the spec is unchanged; a real view change
-        // (different viewKey, or no viewKey to compare) still rebuilds below,
-        // per the incremental renderer's discard-on-view-transition contract.
+        // ── The fast path of a slice ────────────────────────────────────────────
+        // The viewKey of the live tree is the same → only the /context projection changed.
+        // deriveCurrentView uses the selected meta entry as the key of each emission, and the
+        // authored spec of a state is static. Refresh the subtree of the store in place: the
+        // store subscription below calls incremental.update() already, and that function
+        // compares the snapshots and patches the elements of the change only. Skip the
+        // teardown completely, so that the ephemeral view state stays.
+        // createIncrementalRenderer binds the SPEC at its construction. Therefore this path
+        // is safe only because the spec is the same. A real view change, which means a
+        // different viewKey or no viewKey for a comparison, still rebuilds the tree below, as
+        // the discard-on-view-transition contract of the incremental renderer says.
         if (view !== null &&
             view.viewKey !== undefined &&
             this.lastViewKey === view.viewKey &&
@@ -193,37 +199,40 @@ export class PlayRenderer {
             return;
         }
         this.alive = true;
-        // Capture and clear before calling — prevents the synchronous callback fired
-        // by some store implementations during unsubscribe from seeing a live
-        // storeUnsubscribe and re-entering the rerender path with stale view/store.
-        // Mirrors the capture-then-clear pattern used in disconnect().
+        // Capture the values and clear them before the call. Some store implementations
+        // fire a synchronous callback during their unsubscribe(). Without this order, that
+        // callback sees a live storeUnsubscribe, and it enters the rerender path again with
+        // an old view and an old store.
+        // disconnect() uses the same capture-then-clear pattern.
         const oldUnsub = this.storeUnsubscribe;
         this.storeUnsubscribe = null;
         oldUnsub?.();
-        // Release watch cleanups from the previous view's initial render.
-        // Without this, watch subscriptions from the prior view remain active
-        // between a view transition and the first store update in the new view,
-        // holding references to stale DOM elements and preventing GC.
+        // Release the watch cleanups of the first render of the previous view.
+        // Without this step, the watch subscriptions of the previous view stay active between
+        // a view transition and the first store update of the new view. They then hold a
+        // reference to a DOM element that is gone, and the garbage collector cannot take
+        // it.
         const prevWatchCleanups = [...this.watchCleanups];
         this.watchCleanups = new Set();
         for (const cleanup of prevWatchCleanups)
             cleanup();
         this.container.replaceChildren();
-        // A null emission is a gap between views, not a new view: keep
-        // lastViewKey and currentStore so a return to the same identity reuses
-        // the store below. disconnect() remains the lifetime boundary.
+        // A null emission is a gap between two views, and not a new view: keep lastViewKey
+        // and currentStore. A return to the same identity therefore uses the store below
+        // again. disconnect() stays the boundary of the lifetime.
         if (!view)
             return;
-        // Resolve the store through the shared lifecycle: external (controlled,
-        // /context refreshed — machinery-owned in both modes), the kept store
-        // when this emission returns to the live identity (view → null → same
-        // view — the fast path could not take it because the DOM is gone; the
-        // coordinator refreshes /context in place, context may have moved
-        // during the gap), or a fresh per-view store seeded from the composed
+        // Resolve the store through the shared lifecycle. There are three results: the
+        // external store, which is the controlled mode, and the coordinator refreshes its
+        // /context, because the machinery owns /context in both modes; the store that the
+        // coordinator kept, when this emission returns to the live identity (a view, then
+        // null, then the same view — the fast path could not take this case, because the DOM
+        // is gone, and the coordinator refreshes /context in place, because the context can
+        // move during the gap); or a new store of this view, with the values of the composed
         // state.
         const resolution = this.storeLifecycle.resolve(this.actor, view, this.options.store);
         this.lastViewKey = view.viewKey;
-        // Kept unguarded for the slice-only fast path's refresh.
+        // The code keeps the store without a guard, for the refresh of the fast path of a slice.
         this.currentStore = resolution.store;
         try {
             this.renderView(view, resolution.guardedStore);
@@ -234,10 +243,10 @@ export class PlayRenderer {
         }
     }
     /**
-     * A failed rebuild must not leave the fast-path guard armed on a dead tree
-     * (the container was already cleared): reset the view identity so the next
-     * emission — same viewKey included — retries a full render instead of
-     * patching a store nothing displays.
+     * A rebuild that fails must not leave the guard of the fast path armed on a dead
+     * tree, because the container is empty already. Therefore this code resets the view
+     * identity. The next emission, also one with the same viewKey, then makes a
+     * complete render again. It does not patch a store that nothing shows.
      */
     resetFailedRebuild() {
         const failedUnsub = this.storeUnsubscribe;
@@ -248,30 +257,32 @@ export class PlayRenderer {
         this.storeLifecycle.reset();
     }
     /**
-     * The throw-capable tail of a full rebuild — see render()'s catch.
+     * The tail of a complete rebuild, which can throw. See the catch block of render().
      *
-     * @param guardedStore - Everything the spec can write through ($bindState,
-     *   setState, chained set) gets the GUARDED store: /context is read-only to
-     *   the spec — machine context changes only through events.
+     * @param guardedStore - Everything that the spec can write through, which includes
+     *   $bindState, setState, and a chained set, receives the GUARDED store: /context is
+     *   read-only to the spec, because the machine context changes through an event
+     *   only.
      */
     renderView(view, guardedStore) {
         const send = this.actor.send.bind(this.actor);
-        // Build a SetState function backed by the xstate store.
-        // Called lazily at action-invocation time (not at handlers() call time)
-        // so actions always see the latest store state.
+        // Build a SetState function on the xstate store.
+        // The code calls it late, at the moment of an action, and not at the moment of the
+        // handlers() call. Therefore each action sees the newest state of the store.
         const setState = (updater) => {
             const prev = guardedStore.getSnapshot();
             const next = updater(prev);
-            // store.update() is called with a full state snapshot (not a patch map).
-            // This is compatible with createStoreAdapter/createStateStore where update()
-            // performs a shallow merge of the provided top-level keys, effectively
-            // replacing the entire state model. Do not change this to a path-keyed
-            // patch unless the StateStore contract is updated to match.
-            // The guarded store lets the untouched context key of this read-modify-
-            // write round-trip pass as a no-op; a genuine /context mutation throws.
+            // The code calls store.update() with a complete snapshot of the state, and not with
+            // a map of a patch. This works with createStoreAdapter and with createStateStore,
+            // where update() merges the given top-level keys in a shallow way, and therefore
+            // replaces the complete model of the state. Change this call to a patch with a path
+            // as its key only after a change of the StateStore contract.
+            // The store with the guard lets the context key of this read-modify-write round trip
+            // pass, because the code touches that key not. A real mutation of /context
+            // throws.
             guardedStore.update(next);
         };
-        // Resolve handlers from registryResult (wires setState/getState from store).
+        // Resolve the handlers from registryResult. This connects setState and getState of the store.
         const handlers = this.options.registryResult
             ? this.options.registryResult.handlers(() => setState, () => guardedStore.getSnapshot())
             : {};
@@ -282,28 +293,29 @@ export class PlayRenderer {
         const navigate = this.options.navigate;
         const onConfirm = this.options.onConfirm;
         const onRenderError = this.options.onRenderError;
-        // ── Watch lifecycle ─────────────────────────────────────────────────
-        // Watch subscriptions follow element MOUNTS, managed by the incremental
-        // renderer's per-instance registry: elements mounted on the initial
-        // render register then, and elements that only appear later (visibility
-        // flipping on, repeat items being appended) register at that moment with
-        // the same skip-on-mount baseline semantics. Subscriptions are released
-        // when their element unmounts (visibility off, repeat item removed), on
-        // view change (top of this method), or on disconnect().
+        // ── The lifecycle of a watch ─────────────────────────────────────────────
+        // A watch subscription follows the MOUNT of an element, and the registry of each
+        // instance in the incremental renderer manages it: an element of the first render
+        // registers then, and an element that appears later, from a visibility that becomes
+        // true or from a repeat item that the code appends, registers at that moment, with
+        // the same skip-on-mount baseline. The renderer releases a subscription when its
+        // element unmounts, from a visibility that becomes false or from a repeat item that
+        // the code removes. It also releases each subscription on a view change, at the top of
+        // this method, and on a disconnect().
         //
-        // Stable elements are NOT rewired per-rerender: the update subscription
-        // below is registered with the store before renderSpec's watch
-        // subscriptions, and @xstate/store notifies in insertion order. If
-        // in-place re-renders tore watchers down and recreated them, the old
-        // watchers would die queued-but-unfired and the new ones would baseline
-        // against the already-updated snapshot — watch actions would never
-        // fire. The registry therefore preserves the ORIGINAL subscription
-        // (baseline and notification position intact) whenever an instance is
-        // merely re-rendered, and only registers genuinely new mounts.
+        // A stable element does NOT receive a new watch on each rerender. The code registers
+        // the update subscription below with the store before the watch subscriptions of
+        // renderSpec, and @xstate/store notifies in the order of the insertion. If a render
+        // in place removed the watchers and made them again, each old watcher would die in
+        // the queue, before it fires, and each new watcher would take the snapshot after the
+        // update as its baseline. A watch action would then fire never. Therefore the registry
+        // keeps the ORIGINAL subscription, with its baseline and its position in the
+        // notification, whenever the code only renders an instance again. It registers a
+        // real new mount only.
         //
-        // Every registered cleanup is idempotent and also collected in
-        // watchCleanups, so calling it again here after the incremental
-        // renderer already released it is safe.
+        // Each registered cleanup is idempotent, and the Set watchCleanups also holds it.
+        // Therefore a second call here, after the incremental renderer released it already, is
+        // safe.
         const renderOptions = {
             send,
             handlers,
@@ -312,11 +324,11 @@ export class PlayRenderer {
             ...(directives !== undefined ? { directives } : {}),
             ...(loading !== undefined ? { loading } : {}),
             onWatchSetup: (cleanup) => {
-                // Wrap so that invoking the cleanup — from disconnect()/view change
-                // here, OR from the incremental renderer when the owning element
-                // unmounts — also drops it from the Set. Returned so the incremental
-                // renderer registers THIS wrapper and calls it on release, keeping
-                // the Set in step with live subscriptions.
+                // Wrap each cleanup. A call of the wrapper, from the disconnect() here or from the
+                // view change here, OR from the incremental renderer when the element of the cleanup
+                // unmounts, also removes the cleanup from the Set. The code returns the wrapper.
+                // Therefore the incremental renderer registers THIS wrapper and calls it on a
+                // release, and the Set stays in step with the live subscriptions.
                 const entry = () => {
                     this.watchCleanups.delete(entry);
                     cleanup();
@@ -328,20 +340,20 @@ export class PlayRenderer {
             ...(navigate !== undefined ? { navigate } : {}),
             ...(onConfirm !== undefined ? { onConfirm } : {}),
         };
-        // ── Incremental updates ─────────────────────────────────────────────
-        // Store updates no longer rebuild the whole tree: the incremental
-        // renderer diffs the previous vs next snapshot on each element's
-        // tracked $state paths and re-renders only the affected elements in
-        // place. Elements without state bindings keep their DOM node identity
-        // (focus, selection, scroll survive unrelated updates). View
-        // transitions still perform a full rebuild — this method runs anew.
+        // ── The incremental updates ─────────────────────────────────────────────
+        // A store update rebuilds the complete tree no longer: the incremental renderer
+        // compares the previous snapshot and the next snapshot on the tracked $state paths of
+        // each element, and it renders the elements of the change again, in place. An element
+        // without a state binding keeps the identity of its DOM node. Therefore the focus, the
+        // selection, and the scroll position survive an update of another element. A view
+        // transition still rebuilds everything, because this method runs again.
         const incremental = createIncrementalRenderer(view, guardedStore, this.registry, this.container, renderOptions);
-        // subscribe passes through the guard untouched (identical function
-        // reference) — only set/update are wrapped.
+        // subscribe passes through the guard without a change, and it keeps the same function
+        // reference. The guard wraps set and update only.
         this.storeUnsubscribe = guardedStore.subscribe(() => {
-            // Guard: skip if PlayRenderer has been disconnected.
-            // Handles the edge case where a StateStore implementation fires its
-            // subscribed callbacks synchronously within its own unsubscribe() call.
+            // The guard: stop when a caller disconnected the PlayRenderer.
+            // This handles the case of a StateStore implementation that fires its subscribed
+            // callbacks synchronously inside its own unsubscribe() call.
             if (!this.alive)
                 return;
             incremental.update();

package/dist/PlayRenderer.js.map

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