synstate 6.1.0 → 6.2.1

package/src/core/create/source.mts

@@ -1,6 +1,6 @@
 // Sumi bans classes, `this`, method syntax and writes to `this` outside a
-// `mut_` binding; an observable is a class (`ObservableBaseClass` says why),
-// so those rules are waived here (D-63).
+// `mut_` binding; an observable is a class (`ObservableBaseClass` says why), so
+// those rules are waived here (D-63).
 // @sumi-expect-error-file classes/no-class
 // @sumi-expect-error-file banned-syntax/no-this
 // @sumi-expect-error-file functions/prefer-arrow-function
@@ -79,9 +79,9 @@ class SourceObservableClass<A>
     });
   }
 
-  // Returns the value held after the call: `nextValue`, or, once completed,
-  // the value already there — `undefined` only on a source that never had
-  // one, whose `next` is typed `void`.
+  // Returns the value held after the call: `nextValue`, or, once completed, the
+  // value already there — `undefined` only on a source that never had one,
+  // whose `next` is typed `void`.
   next(nextValue: A): A | undefined {
     if (this.isCompleted) {
       return Optional.unwrap(this.getSnapshot());

package/src/core/create/timer.mts

@@ -1,6 +1,6 @@
 // Sumi bans classes, `this`, method syntax and writes to `this` outside a
-// `mut_` binding; an observable is a class (`ObservableBaseClass` says why),
-// so those rules are waived here (D-63).
+// `mut_` binding; an observable is a class (`ObservableBaseClass` says why), so
+// those rules are waived here (D-63).
 // @sumi-expect-error-file classes/no-class
 // @sumi-expect-error-file banned-syntax/no-this
 // @sumi-expect-error-file functions/prefer-arrow-function

package/src/core/operators/audit.mts

@@ -1,6 +1,6 @@
 // Sumi bans classes, `this`, method syntax and writes to `this` outside a
-// `mut_` binding; an observable is a class (`ObservableBaseClass` says why),
-// so those rules are waived here (D-63).
+// `mut_` binding; an observable is a class (`ObservableBaseClass` says why), so
+// those rules are waived here (D-63).
 // @sumi-expect-error-file classes/no-class
 // @sumi-expect-error-file banned-syntax/no-this
 // @sumi-expect-error-file functions/prefer-arrow-function

package/src/core/operators/debounce.mts

@@ -1,6 +1,6 @@
 // Sumi bans classes, `this`, method syntax and writes to `this` outside a
-// `mut_` binding; an observable is a class (`ObservableBaseClass` says why),
-// so those rules are waived here (D-63).
+// `mut_` binding; an observable is a class (`ObservableBaseClass` says why), so
+// those rules are waived here (D-63).
 // @sumi-expect-error-file classes/no-class
 // @sumi-expect-error-file banned-syntax/no-this
 // @sumi-expect-error-file functions/prefer-arrow-function

package/src/core/operators/filter.mts

@@ -1,6 +1,6 @@
 // Sumi bans classes, `this`, method syntax and writes to `this` outside a
-// `mut_` binding; an observable is a class (`ObservableBaseClass` says why),
-// so those rules are waived here (D-63).
+// `mut_` binding; an observable is a class (`ObservableBaseClass` says why), so
+// those rules are waived here (D-63).
 // @sumi-expect-error-file classes/no-class
 // @sumi-expect-error-file banned-syntax/no-this
 // @sumi-expect-error-file functions/prefer-arrow-function
@@ -175,8 +175,8 @@ if (import.meta.vitest !== undefined) {
 
     expectType<typeof _inferred, Observable<number>>('=');
 
-    // A generic guard is what a single signature with a union parameter
-    // loses (it infers `unknown`), and why this set stays overloaded.
+    // A generic guard is what a single signature with a union parameter loses
+    // (it infers `unknown`), and why this set stays overloaded.
     const _generic = s.pipe(filter(isNotUndefined));
 
     expectType<typeof _generic, Observable<number>>('=');

package/src/core/operators/keep-equal-parts.mts

@@ -1,6 +1,6 @@
 // Sumi bans classes, `this`, method syntax and writes to `this` outside a
-// `mut_` binding; an observable is a class (`ObservableBaseClass` says why),
-// so those rules are waived here (D-63).
+// `mut_` binding; an observable is a class (`ObservableBaseClass` says why), so
+// those rules are waived here (D-63).
 // @sumi-expect-error-file classes/no-class
 // @sumi-expect-error-file banned-syntax/no-this
 // @sumi-expect-error-file functions/prefer-arrow-function
@@ -20,19 +20,19 @@ import type {
 
 /**
  * Passes on each value with every part deeply equal to the same part of the
- * value passed on before replaced by that part, and skips a value deeply
- * equal to it altogether (structural sharing). A reader of a part that did
- * not change keeps the object it has, so `skipIfNoChange()` with `Object.is`
- * stops it. Superset of `skipIfNoChange(fastDeepEqual)`.
+ * value passed on before replaced by that part, and skips a value deeply equal
+ * to it altogether (structural sharing). A reader of a part that did not change
+ * keeps the object it has, so `skipIfNoChange()` with `Object.is` stops it.
+ * Superset of `skipIfNoChange(fastDeepEqual)`.
  *
  * **Prefer keeping references where the value is written** — compare before
- * `setState`, and skip it when nothing changed — so that nothing downstream
- * has anything to undo. The `keepEqualParts` option of `createState` and
- * `createReducer` does it for a state written whole, and `replaceEqualDeep`
- * of ts-data-forge does it for any other write. This operator lets every
- * update that changes nothing reach the source and everything up to it, and
- * walks the whole value again on each one; reach for it when the source is
- * not yours to change (a stream that arrives whole from outside).
+ * `setState`, and skip it when nothing changed — so that nothing downstream has
+ * anything to undo. The `keepEqualParts` option of `createState` and
+ * `createReducer` does it for a state written whole, and `replaceEqualDeep` of
+ * ts-data-forge does it for any other write. This operator lets every update
+ * that changes nothing reach the source and everything up to it, and walks the
+ * whole value again on each one; reach for it when the source is not yours to
+ * change (a stream that arrives whole from outside).
  *
  * Array items are matched by index; pass `{ key }` to match them by key, an
  * item for which `key` returns `undefined` being matched by index. Only plain
@@ -51,10 +51,9 @@ import type {
  *   cards: { id: number; text: string }[];
  * }>;
  *
- * // A stream that arrives whole from outside (a WebSocket, say), each
- * // message a new object even when nothing changed. A state you write
- * // yourself takes `createState(initial, { keepEqualParts: true })`
- * // instead.
+ * // A stream that arrives whole from outside (a WebSocket, say), each message
+ * // a new object even when nothing changed. A state you write yourself takes
+ * // `createState(initial, { keepEqualParts: true })` instead.
  * const message$ = source<Board>();
  *
  * const board$ = message$.pipe(keepEqualParts());

package/src/core/operators/map.mts

@@ -1,6 +1,6 @@
 // Sumi bans classes, `this`, method syntax and writes to `this` outside a
-// `mut_` binding; an observable is a class (`ObservableBaseClass` says why),
-// so those rules are waived here (D-63).
+// `mut_` binding; an observable is a class (`ObservableBaseClass` says why), so
+// those rules are waived here (D-63).
 // @sumi-expect-error-file classes/no-class
 // @sumi-expect-error-file banned-syntax/no-this
 // @sumi-expect-error-file functions/prefer-arrow-function

package/src/core/operators/merge-map.mts

@@ -1,6 +1,6 @@
 // Sumi bans classes, `this`, method syntax and writes to `this` outside a
-// `mut_` binding; an observable is a class (`ObservableBaseClass` says why),
-// so those rules are waived here (D-63).
+// `mut_` binding; an observable is a class (`ObservableBaseClass` says why), so
+// those rules are waived here (D-63).
 // @sumi-expect-error-file classes/no-class
 // @sumi-expect-error-file banned-syntax/no-this
 // @sumi-expect-error-file functions/prefer-arrow-function
@@ -22,9 +22,9 @@ import type {
  * Unlike `switchMap`, does not cancel previous inner observables.
  *
  * Each projection runs in a scope of its own (see `createScope`): what it
- * creates is disposed when `mergeMap` completes. An observable it only
- * returns — one created outside the projection and shared with others — is
- * unsubscribed and left running.
+ * creates is disposed when `mergeMap` completes. An observable it only returns
+ * — one created outside the projection and shared with others — is unsubscribed
+ * and left running.
  *
  * @template A - The type of values from the source
  * @template B - The type of values from the projected observable

package/src/core/operators/pairwise.mts

@@ -1,6 +1,6 @@
 // Sumi bans classes, `this`, method syntax and writes to `this` outside a
-// `mut_` binding; an observable is a class (`ObservableBaseClass` says why),
-// so those rules are waived here (D-63).
+// `mut_` binding; an observable is a class (`ObservableBaseClass` says why), so
+// those rules are waived here (D-63).
 // @sumi-expect-error-file classes/no-class
 // @sumi-expect-error-file banned-syntax/no-this
 // @sumi-expect-error-file functions/prefer-arrow-function
@@ -90,8 +90,8 @@ class PairwiseObservableClass<A>
       initialValue: Optional.none,
     });
 
-    // parentObservable.snapshot has value
-    // if parentObservable is InitializedObservable
+    // parentObservable.snapshot has value if parentObservable is
+    // InitializedObservable
     this.#mut_previousValue = parentObservable.getSnapshot();
 
     this.attach();

package/src/core/operators/scan.mts

@@ -1,6 +1,6 @@
 // Sumi bans classes, `this`, method syntax and writes to `this` outside a
-// `mut_` binding; an observable is a class (`ObservableBaseClass` says why),
-// so those rules are waived here (D-63).
+// `mut_` binding; an observable is a class (`ObservableBaseClass` says why), so
+// those rules are waived here (D-63).
 // @sumi-expect-error-file classes/no-class
 // @sumi-expect-error-file banned-syntax/no-this
 // @sumi-expect-error-file functions/prefer-arrow-function

package/src/core/operators/skip-if-no-change.mts

@@ -1,6 +1,6 @@
 // Sumi bans classes, `this`, method syntax and writes to `this` outside a
-// `mut_` binding; an observable is a class (`ObservableBaseClass` says why),
-// so those rules are waived here (D-63).
+// `mut_` binding; an observable is a class (`ObservableBaseClass` says why), so
+// those rules are waived here (D-63).
 // @sumi-expect-error-file classes/no-class
 // @sumi-expect-error-file banned-syntax/no-this
 // @sumi-expect-error-file functions/prefer-arrow-function
@@ -104,8 +104,8 @@ class SkipIfNoChangeObservableClass<A>
       initialValue: parentObservable.getSnapshot(),
     });
 
-    // parentObservable.snapshot has value
-    // if parentObservable is InitializedObservable
+    // parentObservable.snapshot has value if parentObservable is
+    // InitializedObservable
     this.#mut_previousValue = parentObservable.getSnapshot();
 
     this.#eq = eq;

package/src/core/operators/skip-until.mts

@@ -1,6 +1,6 @@
 // Sumi bans classes, `this`, method syntax and writes to `this` outside a
-// `mut_` binding; an observable is a class (`ObservableBaseClass` says why),
-// so those rules are waived here (D-63).
+// `mut_` binding; an observable is a class (`ObservableBaseClass` says why), so
+// those rules are waived here (D-63).
 // @sumi-expect-error-file classes/no-class
 // @sumi-expect-error-file banned-syntax/no-this
 // @sumi-expect-error-file functions/prefer-arrow-function
@@ -83,8 +83,8 @@ class SkipUntilObservableClass<A>
       initialValue: Optional.none,
     });
 
-    // A notifier that already holds a value, or has completed, would stop
-    // the skipping inside `subscribe`, before the subscription is stored.
+    // A notifier that already holds a value, or has completed, would stop the
+    // skipping inside `subscribe`, before the subscription is stored.
     this.#mut_isSkipping =
       Optional.isNone(notifier.getSnapshot()) && !notifier.isCompleted;
 

package/src/core/operators/skip-while.mts

@@ -1,6 +1,6 @@
 // Sumi bans classes, `this`, method syntax and writes to `this` outside a
-// `mut_` binding; an observable is a class (`ObservableBaseClass` says why),
-// so those rules are waived here (D-63).
+// `mut_` binding; an observable is a class (`ObservableBaseClass` says why), so
+// those rules are waived here (D-63).
 // @sumi-expect-error-file classes/no-class
 // @sumi-expect-error-file banned-syntax/no-this
 // @sumi-expect-error-file functions/prefer-arrow-function

package/src/core/operators/switch-map.mts

@@ -1,6 +1,6 @@
 // Sumi bans classes, `this`, method syntax and writes to `this` outside a
-// `mut_` binding; an observable is a class (`ObservableBaseClass` says why),
-// so those rules are waived here (D-63).
+// `mut_` binding; an observable is a class (`ObservableBaseClass` says why), so
+// those rules are waived here (D-63).
 // @sumi-expect-error-file classes/no-class
 // @sumi-expect-error-file banned-syntax/no-this
 // @sumi-expect-error-file functions/prefer-arrow-function
@@ -126,9 +126,9 @@ class SwitchMapObservableClass<A, B>
   readonly #mapToObservable: (curr: A) => Observable<B>;
 
   /**
-   * The scope the operator was created in, so that each inner scope is
-   * disposed with it; the projection itself runs during propagation, when the
-   * current scope is whatever happens to be running.
+   * The scope the operator was created in, so that each inner scope is disposed
+   * with it; the projection itself runs during propagation, when the current
+   * scope is whatever happens to be running.
    */
   readonly #ownerScope: Scope | undefined;
 

package/src/core/operators/take-until.mts

@@ -1,6 +1,6 @@
 // Sumi bans classes, `this`, method syntax and writes to `this` outside a
-// `mut_` binding; an observable is a class (`ObservableBaseClass` says why),
-// so those rules are waived here (D-63).
+// `mut_` binding; an observable is a class (`ObservableBaseClass` says why), so
+// those rules are waived here (D-63).
 // @sumi-expect-error-file classes/no-class
 // @sumi-expect-error-file banned-syntax/no-this
 // @sumi-expect-error-file functions/prefer-arrow-function

package/src/core/operators/take-while.mts

@@ -1,6 +1,6 @@
 // Sumi bans classes, `this`, method syntax and writes to `this` outside a
-// `mut_` binding; an observable is a class (`ObservableBaseClass` says why),
-// so those rules are waived here (D-63).
+// `mut_` binding; an observable is a class (`ObservableBaseClass` says why), so
+// those rules are waived here (D-63).
 // @sumi-expect-error-file classes/no-class
 // @sumi-expect-error-file banned-syntax/no-this
 // @sumi-expect-error-file functions/prefer-arrow-function

package/src/core/operators/take.mts

@@ -1,6 +1,6 @@
 // Sumi bans classes, `this`, method syntax and writes to `this` outside a
-// `mut_` binding; an observable is a class (`ObservableBaseClass` says why),
-// so those rules are waived here (D-63).
+// `mut_` binding; an observable is a class (`ObservableBaseClass` says why), so
+// those rules are waived here (D-63).
 // @sumi-expect-error-file classes/no-class
 // @sumi-expect-error-file banned-syntax/no-this
 // @sumi-expect-error-file functions/prefer-arrow-function

package/src/core/operators/throttle.mts

@@ -1,6 +1,6 @@
 // Sumi bans classes, `this`, method syntax and writes to `this` outside a
-// `mut_` binding; an observable is a class (`ObservableBaseClass` says why),
-// so those rules are waived here (D-63).
+// `mut_` binding; an observable is a class (`ObservableBaseClass` says why), so
+// those rules are waived here (D-63).
 // @sumi-expect-error-file classes/no-class
 // @sumi-expect-error-file banned-syntax/no-this
 // @sumi-expect-error-file functions/prefer-arrow-function

package/src/core/operators/with-buffered-from.mts

@@ -1,6 +1,6 @@
 // Sumi bans classes, `this`, method syntax and writes to `this` outside a
-// `mut_` binding; an observable is a class (`ObservableBaseClass` says why),
-// so those rules are waived here (D-63).
+// `mut_` binding; an observable is a class (`ObservableBaseClass` says why), so
+// those rules are waived here (D-63).
 // @sumi-expect-error-file classes/no-class
 // @sumi-expect-error-file banned-syntax/no-this
 // @sumi-expect-error-file functions/prefer-arrow-function

package/src/core/operators/with-current-value-from.mts

@@ -1,6 +1,6 @@
 // Sumi bans classes, `this`, method syntax and writes to `this` outside a
-// `mut_` binding; an observable is a class (`ObservableBaseClass` says why),
-// so those rules are waived here (D-63).
+// `mut_` binding; an observable is a class (`ObservableBaseClass` says why), so
+// those rules are waived here (D-63).
 // @sumi-expect-error-file classes/no-class
 // @sumi-expect-error-file banned-syntax/no-this
 // @sumi-expect-error-file functions/prefer-arrow-function

package/src/core/operators/with-initial-value.mts

@@ -1,6 +1,6 @@
 // Sumi bans classes, `this`, method syntax and writes to `this` outside a
-// `mut_` binding; an observable is a class (`ObservableBaseClass` says why),
-// so those rules are waived here (D-63).
+// `mut_` binding; an observable is a class (`ObservableBaseClass` says why), so
+// those rules are waived here (D-63).
 // @sumi-expect-error-file classes/no-class
 // @sumi-expect-error-file banned-syntax/no-this
 // @sumi-expect-error-file functions/prefer-arrow-function

package/src/core/predefined/operators/attach-index.mts

@@ -1,6 +1,6 @@
 // Sumi bans classes, `this`, method syntax and writes to `this` outside a
-// `mut_` binding; an observable is a class (`ObservableBaseClass` says why),
-// so those rules are waived here (D-63).
+// `mut_` binding; an observable is a class (`ObservableBaseClass` says why), so
+// those rules are waived here (D-63).
 // @sumi-expect-error-file classes/no-class
 // @sumi-expect-error-file banned-syntax/no-this
 // @sumi-expect-error-file functions/prefer-arrow-function

package/src/core/predefined/operators/map-to.mts

@@ -4,10 +4,9 @@ import type { KeepInitialValueOperator } from '../../types/index.mjs';
 /**
  * Maps all emitted values to a constant value, ignoring the source values.
  * Emits on every source value although the value never changes — where
- * `map(() => value)` would stop every result after the first as equal — so
- * it is the one for turning events into a value. The value's type is
- * inferred as written, as with `as const`: `mapTo('reset')` gives
- * `'reset'`, not `string`.
+ * `map(() => value)` would stop every result after the first as equal — so it
+ * is the one for turning events into a value. The value's type is inferred as
+ * written, as with `as const`: `mapTo('reset')` gives `'reset'`, not `string`.
  *
  * @template A - The type of values from the source
  * @template B - The type of the constant value

package/src/core/scope/scope.mts

@@ -23,8 +23,8 @@ import {
  * disposed gives a scope that is born disposed, with a warning.
  *
  * Intended for authors of libraries built on synstate rather than for
- * application code; state defined at module level belongs to no scope and
- * lives as long as the page.
+ * application code; state defined at module level belongs to no scope and lives
+ * as long as the page.
  *
  * `run` and `dispose` read the scope they are called on, so call them on it
  * (`scope.dispose()`) rather than taking them off it.
@@ -50,8 +50,8 @@ export const getCurrentScope = (): Scope | undefined =>
 
 /**
  * Registers `cleanup` to be called when the current scope is disposed. Cleanups
- * run after the child scopes are disposed and before the owned observables
- * are, newest first.
+ * run after the child scopes are disposed and before the owned observables are,
+ * newest first.
  *
  * Outside every scope it warns and registers nothing.
  *
@@ -85,8 +85,8 @@ export const untracked = <R,>(body: () => R): R =>
  * A scope is created for every row and branch of a UI, so creating one has to
  * be cheap. It used to be a set of closures with a `Set` of children, a `Set`
  * of owned observables and a record in a `WeakMap`; it is now one object whose
- * methods live on the prototype and whose lists are arrays made when the
- * first entry arrives.
+ * methods live on the prototype and whose lists are arrays made when the first
+ * entry arrives.
  *
  * Whatever leaves a list on its own (a child scope disposed by itself, an
  * observable that completed) is not looked up and spliced out: it only counts

package/src/core/types/id.mts

@@ -2,6 +2,7 @@ import type { Brand, UnknownRecord } from 'ts-type-forge';
 
 /**
  * Identifies one update. Opaque: an object issued per update, which is also
- * that update's queue.
+ * that update's queue — except for a write nothing observes, which opens no
+ * update and is issued a token with no queue behind it.
  */
 export type UpdateToken = Brand<UnknownRecord, 'update-token'>;

package/src/core/types/observable-family.mts

@@ -65,11 +65,10 @@ export type ScanOperatorObservable<A, B> = InitializedSyncChildObservable<
 
 // SyncChildObservable
 
-// The helpers stay in a namespace so their names do not crowd the module
-// scope. A namespace holding only types is erasable, so it passes
-// `erasableSyntaxOnly` (TS1294); the `expectType` assertions are call
-// statements, which is why they sit below it rather than beside the types
-// they check.
+// The helpers stay in a namespace so their names do not crowd the module scope.
+// A namespace holding only types is erasable, so it passes `erasableSyntaxOnly`
+// (TS1294); the `expectType` assertions are call statements, which is why they
+// sit below it rather than beside the types they check.
 namespace SynStateInternals {
   type Cast<A> = A extends NonEmptyUnknownList ? A : never;
 

package/src/core/types/observable.mts

@@ -32,8 +32,8 @@ type CreateObservableType<A, Kind extends ObservableKind> = Readonly<{
 
   /**
    * One more than the deepest observable this one is derived from; 0 for a
-   * root. An update reaches observables in ascending depth, so every parent
-   * has emitted before its child reads it.
+   * root. An update reaches observables in ascending depth, so every parent has
+   * emitted before its child reads it.
    */
   depth: Kind extends 'root' ? 0 : number;
 
@@ -44,7 +44,8 @@ type CreateObservableType<A, Kind extends ObservableKind> = Readonly<{
    * The token of the update in which this observable last emitted. A child's
    * `tryUpdate` receives the token of the update now propagating; a parent
    * whose token differs did not emit in it. The token is opaque: compare it,
-   * store it, or pass it on to `setNext`.
+   * store it, or pass the one `tryUpdate` received on to `setNext`. A write
+   * nothing observes opens no update, and its token has no queue behind it.
    */
   updateToken: UpdateToken;
 
@@ -172,9 +173,9 @@ export type Operator<A, B> =
   | KeepInitialValueOperator<A, B>;
 
 /**
- * Tells an observable made by synstate from any other value, by the brand
- * every observable carries. Checking for a `subscribe` method instead would
- * also accept plain values that happen to have one.
+ * Tells an observable made by synstate from any other value, by the brand every
+ * observable carries. Checking for a `subscribe` method instead would also
+ * accept plain values that happen to have one.
  *
  * @example
  *
@@ -222,8 +223,8 @@ export type WrapInitialized<A extends readonly unknown[]> = Readonly<{
 // type GetDestTypeOfOperator<Op extends Operator<unknown, unknown>> =
 //   Op extends Operator<unknown, infer B> ? B : never;
 
-// Only the members meant for users are public; the rest live on the
-// internal node types in `core/class` (#2117).
+// Only the members meant for users are public; the rest live on the internal
+// node types in `core/class` (#2117).
 expectType<
   keyof Observable<unknown>,
   | typeof observableBrand

package/src/core/utils/current-scope.mts

@@ -7,10 +7,10 @@ export type ScopeMember = Readonly<{
 }>;
 
 /**
- * The side of a scope the rest of the core talks to, on top of its public
- * face {@link Scope}. Kept out of the public API (`core/utils/**` is excluded
- * from index generation), so that only `createScope` and its siblings decide
- * what a scope owns.
+ * The side of a scope the rest of the core talks to, on top of its public face
+ * {@link Scope}. Kept out of the public API (`core/utils/**` is excluded from
+ * index generation), so that only `createScope` and its siblings decide what a
+ * scope owns.
  */
 export type ScopeInternals = Scope &
   Readonly<{
@@ -18,8 +18,8 @@ export type ScopeInternals = Scope &
     adopt: (node: ScopeMember) => void;
 
     /**
-     * Tells the scope that one of the nodes it adopted completed on its own,
-     * so that the scope can drop it and keep no reference to it. The node is
+     * Tells the scope that one of the nodes it adopted completed on its own, so
+     * that the scope can drop it and keep no reference to it. The node is
      * completed (`isCompleted`) by the time it calls this.
      */
     release: () => void;
@@ -28,8 +28,8 @@ export type ScopeInternals = Scope &
   }>;
 
 /**
- * The scope whose `run` is executing. A field rather than a module-level
- * `let`, so that the one place writing it is visibly this object.
+ * The scope whose `run` is executing. A field rather than a module-level `let`,
+ * so that the one place writing it is visibly this object.
  */
 const mut_slot: { current: ScopeInternals | undefined } = {
   current: undefined,

package/src/core/utils/id-maker.mts

@@ -8,3 +8,13 @@ import type { UpdateToken } from '../types/index.mjs';
 export const notUpdatedYet: UpdateToken =
   // @sumi-expect-error banned-syntax/no-unsafe-type-assertion
   Object.freeze({}) as UpdateToken;
+
+/**
+ * Issues the token of a write that opens no update, because nothing observes
+ * the observable written to (`setNextIfUnobserved`). Nothing is ever queued
+ * with it, so it is a token and not a queue, unlike the tokens `openUpdate`
+ * issues.
+ */
+export const issueUnqueuedToken = (): UpdateToken =>
+  // @sumi-expect-error banned-syntax/no-unsafe-type-assertion
+  ({}) as UpdateToken;

package/src/core/utils/observable-brand.mts

@@ -1,10 +1,10 @@
 /**
  * The key every observable carries, set to `true` by `assembleObservable`. It
- * lets `isObservable` tell an observable from any other value at run time —
- * a `subscribe` method is not enough, since plain values may have one — and,
- * as a type, makes the public observable types impossible to satisfy with an
- * object literal: an imitation passed to an operator would lack the internal
- * members propagation reads and fail at run time instead of at compile time.
+ * lets `isObservable` tell an observable from any other value at run time — a
+ * `subscribe` method is not enough, since plain values may have one — and, as a
+ * type, makes the public observable types impossible to satisfy with an object
+ * literal: an imitation passed to an operator would lack the internal members
+ * propagation reads and fail at run time instead of at compile time.
  *
  * `Symbol.for`, so that an observable made by another copy of synstate in the
  * same program is still recognized.

package/src/utils/create-boolean-state.mts

@@ -18,8 +18,8 @@ import { createState } from './create-state.mjs';
  * import { useObservableValue } from 'synstate-react-hooks';
  *
  * // Menu drawer open/close state.
- * // setTrue and setFalse can be passed directly as callbacks
- * // — no need to create wrapper functions like `() => setState(true)`.
+ * // setTrue and setFalse can be passed directly as callbacks — no need to
+ * // create wrapper functions like `() => setState(true)`.
  * const [menuOpen$, { setTrue: openMenu, setFalse: closeMenu }] =
  *   createBooleanState(false);
  *