@xmachines/play-actor 2.0.0 → 2.1.0

package/dist/context-projection.d.ts

@@ -1,109 +1,116 @@
 /**
- * Context projection — machine context as a read-only `/context` subtree of the
- * view state store.
+ * The context projection — the machine context as the read-only `/context`
+ * subtree of the view state store.
  *
- * `deriveCurrentView` composes each emitted view's `state` as
- * `{ ...meta.view.state, context: <slice> }`, so the spec is self-consistent:
- * its `state` honestly describes the store contents, and `repeat.statePath`,
- * `visible.$state`, `$state` props and validators can all read machine context
- * through the ordinary `{ $state: "/context/…" }` grammar.
+ * `deriveCurrentView` composes the `state` field of each emitted view as
+ * `{ ...meta.view.state, context: <slice> }`. The spec is therefore consistent with
+ * itself: its `state` field describes the contents of the store correctly, and
+ * `repeat.statePath`, `visible.$state`, a `$state` prop, and a validator all read
+ * the machine context through the ordinary `{ $state: "/context/…" }` grammar.
  *
- * The subtree is read-only **to the spec, not to the machinery**: providers
- * hand bindings and action handlers a store wrapped with
- * {@link guardContextWrites}, while refreshing the projection through the
- * unguarded store underneath. Context changes flow exclusively through machine
- * events — a write under `/context` is always a spec bug, and the guard says so.
+ * The subtree is read-only **to the spec, and not to the machinery**: a provider
+ * gives the bindings and the action handlers a store with the wrapper of
+ * {@link guardContextWrites}, and it refreshes the projection through the store
+ * below that wrapper, which has no guard. The context changes through a machine
+ * event only. Therefore a write under `/context` is always a fault of the spec, and
+ * the guard says so.
  *
  * @packageDocumentation
  */
 import type { StateStore } from "@xmachines/json-render-core";
 import type { PlaySpec } from "./abstract-actor.js";
 /**
- * The reserved top-level state key the projection materializes under.
+ * The reserved top-level state key of the projection.
  *
- * A view's authored `spec.state` must not declare this key — when it does, the
- * projection is skipped for that view (the authored state wins) and a dev
- * warning is emitted. See {@link composePlayState}.
+ * The `spec.state` object of a view must not declare this key. When it does, the
+ * derivation skips the projection for that view, the authored state wins, and the
+ * code writes a warning in development. See {@link composePlayState}.
  */
 export declare const CONTEXT_STATE_KEY = "context";
 /**
- * Own-key shallow equality with `Object.is`, optionally ignoring one key on
+ * The shallow equality of the own keys, with `Object.is`. It can ignore one key on
  * both sides.
  *
- * The single comparison rule behind every emission-dedup decision: slice
- * equality and the player's emit gate alike (spec-field comparison in
- * `viewSpecsEquivalent`, composed-state reuse in {@link reuseComposedState}).
+ * This is the one comparison rule behind every decision of the emission dedup: the
+ * equality of a slice, and also the emit gate of the player, which compares the
+ * spec fields in `viewSpecsEquivalent` and reuses the composed state in
+ * {@link reuseComposedState}.
  */
 export declare function shallowEqualExcept(a: object, b: object, except?: string): boolean;
 /**
- * Reuse the previous emission's composed `state` — or the whole previous spec
- * — when the projection is value-unchanged.
+ * Reuses the composed `state` of the previous emission, or the complete previous
+ * spec, when the value of the projection did not change.
  *
- * `deriveCurrentView` composes `state: { ...meta.view.state, context: slice }`
- * fresh per call, and XState's `assign` produces a fresh context object on
- * every event — so without reuse, every event would present a new `state`
- * reference and the emit gate's per-field `Object.is` would re-emit (and
- * remount) constantly. Slices are compared per field ({@link shallowEqualExcept} —
- * XState's `assign` produces a fresh context object per event, so whole-object
- * identity would report a change every time); the authored fields are spread
- * from the static `meta.view.state`, so for an unchanged `viewKey` their
- * references are stable and plain `Object.is` holds.
+ * `deriveCurrentView` composes `state: { ...meta.view.state, context: slice }` new
+ * on each call, and the XState function `assign` makes a new context object on
+ * every event. Without this reuse, every event therefore presents a new `state`
+ * reference, and the `Object.is` test of each field in the emit gate emits the view
+ * again and remounts it, without an end. The function compares the slices field by
+ * field ({@link shallowEqualExcept}), because the XState function `assign` makes a
+ * new context object for each event, and a test of the identity of the whole object
+ * therefore reports a change every time. The authored fields come from the static
+ * `meta.view.state` through a spread. Therefore their references are stable for an
+ * unchanged `viewKey`, and a plain `Object.is` test is correct for them.
  *
- * Returns, in order of preference:
- * - `prev` itself when nothing observable changed — the emit gate then
- *   short-circuits on reference identity with no element walk;
- * - `{ ...next, state: prev.state }` when the state is value-unchanged but
- *   some other top-level field differs;
- * - `next` when something actually changed.
+ * The function returns one of three values, in this order of preference:
+ * - `prev` itself, when nothing observable changed. The emit gate then stops at the
+ *   identity of the reference, and it walks no element;
+ * - `{ ...next, state: prev.state }`, when the value of the state did not change
+ *   but another top-level field is different;
+ * - `next`, when something changed.
  */
 export declare function reuseComposedState(prev: PlaySpec | null, next: PlaySpec | null): PlaySpec | null;
 /**
- * Wrap a StateStore so writes under `/context` are rejected.
+ * Wraps a StateStore, and the wrapper refuses each write under `/context`.
  *
- * Applied by providers to the store they hand to bindings and action handlers
- * (`$bindState`, `setState`, chained `set`). The provider keeps the unwrapped
- * store and refreshes the projection through it — read-only to the spec, not
- * to the machinery.
+ * A provider applies it to the store that it gives to the bindings and to the
+ * action handlers (`$bindState`, `setState`, and a chained `set`). The provider
+ * keeps the store without the wrapper, and it refreshes the projection through that
+ * store. The subtree is therefore read-only to the spec, and not to the machinery.
  *
- * A write whose value is **identical** to the current one passes silently:
- * `setState`-style handlers read the full snapshot, transform it, and write
- * the whole object back — the untouched `context` key flowing through that
- * round-trip is not a mutation attempt. Only a write that would actually
- * change the subtree throws.
+ * A write with a value that is **identical** to the current value passes in
+ * silence. A handler in the style of `setState` reads the complete snapshot,
+ * changes it, and writes the whole object back. The `context` key that goes through
+ * that round trip without a change is no attempt of a mutation. Only a write that
+ * changes the subtree throws.
  *
- * Reads pass through untouched, and every member is delegated explicitly
- * rather than spread: a consumer-supplied store may be a class instance, whose
- * methods live on the prototype and would not survive `{ ...store }` — the
- * first render would die on `store.getSnapshot is not a function`. The wrapper
- * is built once per resolved store, so the delegating `getSnapshot`/`subscribe`
- * identities stay stable for `useSyncExternalStore`-style consumers.
+ * Each read passes through without a change. The wrapper delegates every member
+ * explicitly, and it does not use a spread: a store from a consumer can be an
+ * instance of a class, and the methods of that instance are on the prototype. Those
+ * methods do not survive `{ ...store }`, and the first render then fails with
+ * `store.getSnapshot is not a function`. The code builds the wrapper one time for
+ * each resolved store. Therefore the identity of the delegating `getSnapshot` and
+ * of the delegating `subscribe` stays stable for a consumer in the style of
+ * `useSyncExternalStore`.
  *
- * @param store - The underlying store.
- * @returns A store with guarded `set`/`update`.
+ * @param store - The store below the wrapper.
+ * @returns A store with a guard on `set` and on `update`.
  */
 export declare function guardContextWrites(store: StateStore): StateStore;
 /**
- * Refresh a live store's `/context` subtree from a derived view's composed
- * state. A same-`viewKey` emission means only the projection changed — the
- * subtree is replaced wholesale (never merged per-field: `update` cannot
- * delete keys) and every ephemeral root-level value is left untouched.
- * No-op when the view carries no slice or the store already holds it.
+ * Refreshes the `/context` subtree of a live store from the composed state of a
+ * derived view. An emission with the same `viewKey` means that only the projection
+ * changed. The function therefore replaces the complete subtree, and it never
+ * merges it field by field, because `update` cannot delete a key. Every ephemeral
+ * value at the root level stays. The function does nothing when the view carries no
+ * slice, or when the store holds the slice already.
  *
- * @param store - The UNGUARDED store (providers refresh through it).
- * @param view - The derived view whose `state.context` carries the slice.
+ * @param store - The store WITHOUT the guard. A provider refreshes through it.
+ * @param view - The derived view. Its `state.context` field carries the slice.
  */
 export declare function refreshContextSubtree(store: StateStore, view: {
     state?: unknown;
 }): void;
 /**
- * Compose a view's effective state: the authored `spec.state` plus the
+ * Composes the effective state of a view: the authored `spec.state` and the
  * `/context` slice.
  *
- * When the authored state already declares the reserved key, the projection is
- * skipped (authored state wins) with a dev warning — no existing spec breaks.
+ * When the authored state declares the reserved key already, the function skips the
+ * projection, the authored state wins, and the code writes a warning in
+ * development. No spec that exists now therefore fails.
  *
- * @param authoredState - The raw `meta.view.state` (may be anything; sanitized by the caller/toAtomState).
- * @param slice - The machine's context, projected wholesale.
+ * @param authoredState - The raw `meta.view.state` value. It can be anything, and the caller or toAtomState cleans it.
+ * @param slice - The context of the machine, as one complete value.
  */
 export declare function composePlayState(authoredState: Record<string, unknown> | undefined, slice: Record<string, unknown> | undefined): Record<string, unknown> | undefined;
 //# sourceMappingURL=context-projection.d.ts.map

package/dist/context-projection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context-projection.d.ts","sourceRoot":"","sources":["../src/context-projection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAE9D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEpD;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,YAAY,CAAC;AAiB3C;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAUjF;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,EAAE,IAAI,EAAE,QAAQ,GAAG,IAAI,GAAG,QAAQ,GAAG,IAAI,CAiBhG;AAgBD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,CA6ChE;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAKxF;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC/B,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAClD,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GACxC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAcrC"}
+{"version":3,"file":"context-projection.d.ts","sourceRoot":"","sources":["../src/context-projection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAE9D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEpD;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,YAAY,CAAC;AAiB3C;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAUjF;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,EAAE,IAAI,EAAE,QAAQ,GAAG,IAAI,GAAG,QAAQ,GAAG,IAAI,CAiBhG;AAgBD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,CA8ChE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAKxF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAC/B,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAClD,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GACxC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAcrC"}

package/dist/context-projection.js

@@ -1,36 +1,37 @@
 /**
- * Context projection — machine context as a read-only `/context` subtree of the
- * view state store.
+ * The context projection — the machine context as the read-only `/context`
+ * subtree of the view state store.
  *
- * `deriveCurrentView` composes each emitted view's `state` as
- * `{ ...meta.view.state, context: <slice> }`, so the spec is self-consistent:
- * its `state` honestly describes the store contents, and `repeat.statePath`,
- * `visible.$state`, `$state` props and validators can all read machine context
- * through the ordinary `{ $state: "/context/…" }` grammar.
+ * `deriveCurrentView` composes the `state` field of each emitted view as
+ * `{ ...meta.view.state, context: <slice> }`. The spec is therefore consistent with
+ * itself: its `state` field describes the contents of the store correctly, and
+ * `repeat.statePath`, `visible.$state`, a `$state` prop, and a validator all read
+ * the machine context through the ordinary `{ $state: "/context/…" }` grammar.
  *
- * The subtree is read-only **to the spec, not to the machinery**: providers
- * hand bindings and action handlers a store wrapped with
- * {@link guardContextWrites}, while refreshing the projection through the
- * unguarded store underneath. Context changes flow exclusively through machine
- * events — a write under `/context` is always a spec bug, and the guard says so.
+ * The subtree is read-only **to the spec, and not to the machinery**: a provider
+ * gives the bindings and the action handlers a store with the wrapper of
+ * {@link guardContextWrites}, and it refreshes the projection through the store
+ * below that wrapper, which has no guard. The context changes through a machine
+ * event only. Therefore a write under `/context` is always a fault of the spec, and
+ * the guard says so.
  *
  * @packageDocumentation
  */
 /**
- * The reserved top-level state key the projection materializes under.
+ * The reserved top-level state key of the projection.
  *
- * A view's authored `spec.state` must not declare this key — when it does, the
- * projection is skipped for that view (the authored state wins) and a dev
- * warning is emitted. See {@link composePlayState}.
+ * The `spec.state` object of a view must not declare this key. When it does, the
+ * derivation skips the projection for that view, the authored state wins, and the
+ * code writes a warning in development. See {@link composePlayState}.
  */
 export const CONTEXT_STATE_KEY = "context";
 /**
- * Once-per-spec diagnostic dedup. The condition reported here is a static
- * property of the authored meta.view (its `state` object never changes
- * between events), but `deriveCurrentView` runs on every machine snapshot —
- * reporting per derivation would flood the console at event rate. Keyed by
- * the static object's identity, so each spec reports exactly once and tests
- * with fresh literals stay isolated.
+ * The record that reports each diagnostic one time for each spec. The condition
+ * here is a static property of the authored meta.view, because its `state` object
+ * never changes between two events. `deriveCurrentView` runs on every machine
+ * snapshot, and a report for each derivation therefore floods the console at the
+ * rate of the events. The key is the identity of the static object. Each spec
+ * therefore reports one time, and a test with a new literal stays separate.
  */
 const reportedDiagnostics = new WeakSet();
 function warnOnce(anchor, message) {
@@ -40,12 +41,13 @@ function warnOnce(anchor, message) {
     console.warn(message);
 }
 /**
- * Own-key shallow equality with `Object.is`, optionally ignoring one key on
+ * The shallow equality of the own keys, with `Object.is`. It can ignore one key on
  * both sides.
  *
- * The single comparison rule behind every emission-dedup decision: slice
- * equality and the player's emit gate alike (spec-field comparison in
- * `viewSpecsEquivalent`, composed-state reuse in {@link reuseComposedState}).
+ * This is the one comparison rule behind every decision of the emission dedup: the
+ * equality of a slice, and also the emit gate of the player, which compares the
+ * spec fields in `viewSpecsEquivalent` and reuses the composed state in
+ * {@link reuseComposedState}.
  */
 export function shallowEqualExcept(a, b, except) {
     const aEntries = Object.entries(a).filter(([key]) => key !== except);
@@ -61,25 +63,26 @@ export function shallowEqualExcept(a, b, except) {
     return true;
 }
 /**
- * Reuse the previous emission's composed `state` — or the whole previous spec
- * — when the projection is value-unchanged.
+ * Reuses the composed `state` of the previous emission, or the complete previous
+ * spec, when the value of the projection did not change.
  *
- * `deriveCurrentView` composes `state: { ...meta.view.state, context: slice }`
- * fresh per call, and XState's `assign` produces a fresh context object on
- * every event — so without reuse, every event would present a new `state`
- * reference and the emit gate's per-field `Object.is` would re-emit (and
- * remount) constantly. Slices are compared per field ({@link shallowEqualExcept} —
- * XState's `assign` produces a fresh context object per event, so whole-object
- * identity would report a change every time); the authored fields are spread
- * from the static `meta.view.state`, so for an unchanged `viewKey` their
- * references are stable and plain `Object.is` holds.
+ * `deriveCurrentView` composes `state: { ...meta.view.state, context: slice }` new
+ * on each call, and the XState function `assign` makes a new context object on
+ * every event. Without this reuse, every event therefore presents a new `state`
+ * reference, and the `Object.is` test of each field in the emit gate emits the view
+ * again and remounts it, without an end. The function compares the slices field by
+ * field ({@link shallowEqualExcept}), because the XState function `assign` makes a
+ * new context object for each event, and a test of the identity of the whole object
+ * therefore reports a change every time. The authored fields come from the static
+ * `meta.view.state` through a spread. Therefore their references are stable for an
+ * unchanged `viewKey`, and a plain `Object.is` test is correct for them.
  *
- * Returns, in order of preference:
- * - `prev` itself when nothing observable changed — the emit gate then
- *   short-circuits on reference identity with no element walk;
- * - `{ ...next, state: prev.state }` when the state is value-unchanged but
- *   some other top-level field differs;
- * - `next` when something actually changed.
+ * The function returns one of three values, in this order of preference:
+ * - `prev` itself, when nothing observable changed. The emit gate then stops at the
+ *   identity of the reference, and it walks no element;
+ * - `{ ...next, state: prev.state }`, when the value of the state did not change
+ *   but another top-level field is different;
+ * - `next`, when something changed.
  */
 export function reuseComposedState(prev, next) {
     if (!prev || !next || prev.viewKey !== next.viewKey)
@@ -106,40 +109,42 @@ export function reuseComposedState(prev, next) {
     return shallowEqualExcept(prev, next, "state") ? prev : next;
 }
 /**
- * Paths that address the reserved subtree: "/context" itself or below it.
- * Store update maps may carry bare top-level keys ("context") as well as
- * JSON Pointers ("/context/…") — both forms address the same subtree.
+ * The paths of the reserved subtree: `"/context"` itself, and every path below it.
+ * An update map of the store can hold a bare top-level key ("context") and also a
+ * JSON Pointer ("/context/…"). Both forms address the same subtree.
  */
 function toPointer(path) {
     return path.startsWith("/") ? path : `/${path}`;
 }
-/** Expects a NORMALIZED pointer from {@link toPointer}. */
+/** This function expects a NORMALIZED pointer from {@link toPointer}. */
 function isContextPointer(pointer) {
     return pointer === `/${CONTEXT_STATE_KEY}` || pointer.startsWith(`/${CONTEXT_STATE_KEY}/`);
 }
 /**
- * Wrap a StateStore so writes under `/context` are rejected.
+ * Wraps a StateStore, and the wrapper refuses each write under `/context`.
  *
- * Applied by providers to the store they hand to bindings and action handlers
- * (`$bindState`, `setState`, chained `set`). The provider keeps the unwrapped
- * store and refreshes the projection through it — read-only to the spec, not
- * to the machinery.
+ * A provider applies it to the store that it gives to the bindings and to the
+ * action handlers (`$bindState`, `setState`, and a chained `set`). The provider
+ * keeps the store without the wrapper, and it refreshes the projection through that
+ * store. The subtree is therefore read-only to the spec, and not to the machinery.
  *
- * A write whose value is **identical** to the current one passes silently:
- * `setState`-style handlers read the full snapshot, transform it, and write
- * the whole object back — the untouched `context` key flowing through that
- * round-trip is not a mutation attempt. Only a write that would actually
- * change the subtree throws.
+ * A write with a value that is **identical** to the current value passes in
+ * silence. A handler in the style of `setState` reads the complete snapshot,
+ * changes it, and writes the whole object back. The `context` key that goes through
+ * that round trip without a change is no attempt of a mutation. Only a write that
+ * changes the subtree throws.
  *
- * Reads pass through untouched, and every member is delegated explicitly
- * rather than spread: a consumer-supplied store may be a class instance, whose
- * methods live on the prototype and would not survive `{ ...store }` — the
- * first render would die on `store.getSnapshot is not a function`. The wrapper
- * is built once per resolved store, so the delegating `getSnapshot`/`subscribe`
- * identities stay stable for `useSyncExternalStore`-style consumers.
+ * Each read passes through without a change. The wrapper delegates every member
+ * explicitly, and it does not use a spread: a store from a consumer can be an
+ * instance of a class, and the methods of that instance are on the prototype. Those
+ * methods do not survive `{ ...store }`, and the first render then fails with
+ * `store.getSnapshot is not a function`. The code builds the wrapper one time for
+ * each resolved store. Therefore the identity of the delegating `getSnapshot` and
+ * of the delegating `subscribe` stays stable for a consumer in the style of
+ * `useSyncExternalStore`.
  *
- * @param store - The underlying store.
- * @returns A store with guarded `set`/`update`.
+ * @param store - The store below the wrapper.
+ * @returns A store with a guard on `set` and on `update`.
  */
 export function guardContextWrites(store) {
     const reject = (path) => {
@@ -150,8 +155,9 @@ export function guardContextWrites(store) {
         const pointer = toPointer(path);
         if (!isContextPointer(pointer))
             return true;
-        // Unchanged round-trip (read-modify-write of the whole snapshot) is a
-        // no-op for this subtree, not a mutation — drop the key silently.
+        // A round trip without a change, which is a read-modify-write of the complete
+        // snapshot, does nothing to this subtree, and it is no mutation. Drop the key in
+        // silence.
         if (Object.is(store.get(pointer), value))
             return false;
         return reject(path);
@@ -178,9 +184,9 @@ export function guardContextWrites(store) {
             store.update(dropped ? allowed : updates);
         },
     };
-    // Optional in the contract, and its absence is meaningful: json-render-core
-    // falls back to `getSnapshot` when the key is missing, so the wrapper must
-    // not manufacture one that returns `undefined`.
+    // The contract makes this member optional, and its absence has a meaning:
+    // json-render-core uses `getSnapshot` when the key is absent. Therefore the wrapper
+    // must build no member that returns `undefined`.
     const { getServerSnapshot } = store;
     if (getServerSnapshot) {
         guarded.getServerSnapshot = () => getServerSnapshot.call(store);
@@ -188,14 +194,15 @@ export function guardContextWrites(store) {
     return guarded;
 }
 /**
- * Refresh a live store's `/context` subtree from a derived view's composed
- * state. A same-`viewKey` emission means only the projection changed — the
- * subtree is replaced wholesale (never merged per-field: `update` cannot
- * delete keys) and every ephemeral root-level value is left untouched.
- * No-op when the view carries no slice or the store already holds it.
+ * Refreshes the `/context` subtree of a live store from the composed state of a
+ * derived view. An emission with the same `viewKey` means that only the projection
+ * changed. The function therefore replaces the complete subtree, and it never
+ * merges it field by field, because `update` cannot delete a key. Every ephemeral
+ * value at the root level stays. The function does nothing when the view carries no
+ * slice, or when the store holds the slice already.
  *
- * @param store - The UNGUARDED store (providers refresh through it).
- * @param view - The derived view whose `state.context` carries the slice.
+ * @param store - The store WITHOUT the guard. A provider refreshes through it.
+ * @param view - The derived view. Its `state.context` field carries the slice.
  */
 export function refreshContextSubtree(store, view) {
     const slice = view.state?.[CONTEXT_STATE_KEY];
@@ -204,14 +211,15 @@ export function refreshContextSubtree(store, view) {
     }
 }
 /**
- * Compose a view's effective state: the authored `spec.state` plus the
+ * Composes the effective state of a view: the authored `spec.state` and the
  * `/context` slice.
  *
- * When the authored state already declares the reserved key, the projection is
- * skipped (authored state wins) with a dev warning — no existing spec breaks.
+ * When the authored state declares the reserved key already, the function skips the
+ * projection, the authored state wins, and the code writes a warning in
+ * development. No spec that exists now therefore fails.
  *
- * @param authoredState - The raw `meta.view.state` (may be anything; sanitized by the caller/toAtomState).
- * @param slice - The machine's context, projected wholesale.
+ * @param authoredState - The raw `meta.view.state` value. It can be anything, and the caller or toAtomState cleans it.
+ * @param slice - The context of the machine, as one complete value.
  */
 export function composePlayState(authoredState, slice) {
     if (authoredState !== undefined && Object.hasOwn(authoredState, CONTEXT_STATE_KEY)) {

package/dist/context-projection.js.map

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

package/dist/index.d.ts

@@ -1,16 +1,18 @@
 /**
- * @xmachines/play-actor - Abstract Actor base class for Play Architecture
+ * @xmachines/play-actor - the abstract Actor base class of the Play Architecture
  *
- * This package provides AbstractActor, a minimal base class that extends XState Actor
- * while enforcing the Play Architecture's signal protocol (RFC section 5.3).
+ * This package gives you AbstractActor, a minimal base class. It extends the XState
+ * Actor class, and it enforces the signal protocol of the Play Architecture (RFC
+ * section 5.3).
  *
- * The core protocol is minimal (state + send). Optional capabilities are provided
- * via interfaces:
- * - Routable: For actors that support routing
- * - Viewable: For actors that support view rendering
+ * The core protocol is minimal: state and send. Two interfaces give the optional
+ * capabilities:
+ * - Routable: for an actor with a routing support
+ * - Viewable: for an actor with a view rendering
  *
- * Maintains XState ecosystem compatibility (inspection, devtools) while exposing
- * reactive signals for Infrastructure layer communication.
+ * The class keeps the compatibility with the XState ecosystem, such as the
+ * inspection and the devtools. It also exposes the reactive signals of the
+ * communication with the infrastructure layer.
  *
  * @packageDocumentation
  * @see [Play RFC](../../docs/rfc/play.md)

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EACN,aAAa,EACb,SAAS,EACT,KAAK,QAAQ,EACb,KAAK,QAAQ,EACb,KAAK,QAAQ,EACb,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,GACzB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,WAAW,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAE7E,OAAO,EACN,iBAAiB,EACjB,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,GAClB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AACrE,YAAY,EACX,kBAAkB,EAClB,mBAAmB,EACnB,uBAAuB,GACvB,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EACN,aAAa,EACb,SAAS,EACT,KAAK,QAAQ,EACb,KAAK,QAAQ,EACb,KAAK,QAAQ,EACb,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,GACzB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,WAAW,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAE7E,OAAO,EACN,iBAAiB,EACjB,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,GAClB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AACrE,YAAY,EACX,kBAAkB,EAClB,mBAAmB,EACnB,uBAAuB,GACvB,MAAM,2BAA2B,CAAC"}

package/dist/index.js

@@ -1,16 +1,18 @@
 /**
- * @xmachines/play-actor - Abstract Actor base class for Play Architecture
+ * @xmachines/play-actor - the abstract Actor base class of the Play Architecture
  *
- * This package provides AbstractActor, a minimal base class that extends XState Actor
- * while enforcing the Play Architecture's signal protocol (RFC section 5.3).
+ * This package gives you AbstractActor, a minimal base class. It extends the XState
+ * Actor class, and it enforces the signal protocol of the Play Architecture (RFC
+ * section 5.3).
  *
- * The core protocol is minimal (state + send). Optional capabilities are provided
- * via interfaces:
- * - Routable: For actors that support routing
- * - Viewable: For actors that support view rendering
+ * The core protocol is minimal: state and send. Two interfaces give the optional
+ * capabilities:
+ * - Routable: for an actor with a routing support
+ * - Viewable: for an actor with a view rendering
  *
- * Maintains XState ecosystem compatibility (inspection, devtools) while exposing
- * reactive signals for Infrastructure layer communication.
+ * The class keeps the compatibility with the XState ecosystem, such as the
+ * inspection and the devtools. It also exposes the reactive signals of the
+ * communication with the infrastructure layer.
  *
  * @packageDocumentation
  * @see [Play RFC](../../docs/rfc/play.md)

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EACN,aAAa,EACb,SAAS,GAMT,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,WAAW,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAE7E,OAAO,EACN,iBAAiB,EACjB,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,GAClB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EACN,aAAa,EACb,SAAS,GAMT,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,WAAW,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAE7E,OAAO,EACN,iBAAiB,EACjB,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,GAClB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC"}