sia-reactor 0.0.23 → 0.0.25

package/README.md

@@ -156,21 +156,20 @@ reactor.core.player.volume = 100; // re-assign core if desired
 All methods are available on `Reactor` instances or objects wrapped in `reactive()`.
 
 #### **Mediators (Synchronous Gatekeepers)**
-- **`set(path, callback, options)`**: Intercept memory writes. Return a value to modify it, or return `TERMINATOR` to block the write entirely.
-- **`get(path, callback, options)`**: Intercept and format data during retrieval.
-- **`delete(path, callback, options)`**: Intercept property deletion.
+- **`set(path, callback, options)` <-> `noset(path, callback)`**: Intercept memory writes. Return a value to modify it, or return `TERMINATOR` to block the write entirely.
+- **`get(path, callback, options)` <-> `noget(path, callback)`**: Intercept and format data during retrieval.
+- **`delete(path, callback, options)` <-> `nodelete(path, callback)`**: Intercept property deletion.
 
 #### **Watchers (Synchronous Observers)**
-- **`watch(path, callback, options)`**: Fires instantly after a mutation. Use strictly for critical internal engine syncing on leaf paths preferably, sees only direct operations.
+- **`watch(path, callback, options)` <-> `nowatch(path, callback)`**: Fires instantly after a mutation. Use strictly for critical internal engine syncing on leaf paths preferably, sees only direct operations.
 
 #### **Listeners (Asynchronous/Batched UI Observers)**
-- **`on(path, callback, options)`**: Attach DOM-style event listeners that respect `depth`. Supports `{ capture: true, depth: 1, once: true, immediate: true }`.
-- **`once(path, callback, options)`**: Fires once and self-destructs.
-- **`off(path, callback, options)`**: Removes a listener.
+- **`on(path, callback, options)` <-> `off(path, callback, options)`**: Attach DOM-style event listeners that respect `depth`. Supports `{ capture: true, depth: 1, once: true, immediate: true }`.
+- **`once(path, callback, options)`**: Fires once and self-destructs, others have too: `sonce(...)`, `gonce(...)`, `donce(...)`, `wonce(...)`.
 
 #### **Lifecycle & Utilities**
 - **`tick(path)`**: Forces a synchronous flush of the batch queue for a specific path.
-- **`stall(task)` / `nostall(task)`**: Manually stall the queue to wait for calculations before rendering.
+- **`stall(task)` <-> `nostall(task)`**: Manually stall the queue to wait for calculations before rendering.
 - **`snapshot(raw)`**: Generates a strict, structurally-shared, un-proxied clone of the current state tree.
 - **`use(new ReactorModule(config), id)`**: Allows extended behaviour with external logic.
 - **`reset()`**: Clears all records bringing everything back to a clean slate.
@@ -178,18 +177,18 @@ All methods are available on `Reactor` instances or objects wrapped in `reactive
 
 ### Memory & Granular Control Flags
 
-You can wrap properties in special flags *before* initializing the reactor to dictate exactly how the Proxy treats them.
+You can wrap properties in special flags *before* initializing the reactor to dictate exactly how the Proxy treats them. e.g. `reactive(volatile(intent({ behavior: "auto" })))`, e.t.c.
 
-- **`inert(obj)` / `live(obj)`**: Tells the proxy to completely ignore an object. It will not be deeply tracked.
-- **`intent(obj)` / `state(obj)`**: Marks an object as rejectable. Allows listeners to call `e.reject()` during the Capture phase.
-- **`volatile(obj)` / `stable(obj)`**: Forces the reactor to fire event waves even if the new value is identical to the old value (bypassing the Proxy's unchanged performance check).
+- **`intent(obj)` <-> `state(obj)`**: Marks an object as rejectable. Allows listeners to call `e.reject()` during the Capture phase.
+- **`inert(obj)` <-> `live(obj)`**: Tells the proxy to completely ignore an object. It will not be deeply tracked.
+- **`volatile(obj)` <-> `stable(obj)`**: Forces the reactor to fire event waves even if the new value is identical to the old value (bypassing the Proxy's unchanged performance check).
 
 ```javascript
 import { reactive, intent, volatile, inert } from "sia-reactor";
 
 const data = reactive({
   apiResponse: inert({ heavy: "data" }), // Proxy won't traverse this
-  userWish: intent({ flying: false }),  // Can be rejected by a Higher Power
+  userWish: intent({ flying: false }),  // Can be rejected by a Handler or a Higher Power
   trigger: volatile({ clickCount: 0 })  // Fires events even if set to 0 again
 });
 ```

package/dist/{TimeTravelOverlay-OjklzuCD.d.cts → TimeTravelOverlay-Bz2v9hov.d.cts}

@@ -1,8 +1,8 @@
-import { d as Reactive } from './index-m0aAWxhX.cjs';
-import { m as TimeTravelModule } from './timeTravel-DctvcHVt.cjs';
+import { d as Reactive } from './index-CB-IiZIB.cjs';
+import { m as TimeTravelModule } from './timeTravel-CEc3grUE.cjs';
 
 /** Reactive options for the TimeTravel overlay instance. */
-interface TimeTravelConfig {
+interface TimeTravelOverlayConfig {
     /** Header text shown at the top of the overlay panel. */
     title: string;
     /** Accent color used to derive panel theme variables. */
@@ -22,7 +22,7 @@ interface TimeTravelConfig {
 declare class TimeTravelOverlay {
     static count: number;
     index: number;
-    config: TimeTravelConfig;
+    config: TimeTravelOverlayConfig;
     readonly state: Reactive<{
         open: boolean;
         import: string;
@@ -35,8 +35,8 @@ declare class TimeTravelOverlay {
      * @param time TimeTravel module instance that owns timeline operations.
      * @param build Optional initial overlay config overrides.
      */
-    constructor(time: TimeTravelModule, build?: Partial<TimeTravelConfig>);
+    constructor(time: TimeTravelModule, build?: Partial<TimeTravelOverlayConfig>);
     destroy(): void;
 }
 
-export { type TimeTravelConfig as T, TimeTravelOverlay as a };
+export { TimeTravelOverlay as T, type TimeTravelOverlayConfig as a };

package/dist/{TimeTravelOverlay-Dglcwpg-.d.ts → TimeTravelOverlay-CvTDJWpP.d.ts}

@@ -1,8 +1,8 @@
-import { d as Reactive } from './index-m0aAWxhX.js';
-import { m as TimeTravelModule } from './timeTravel-DExvNb04.js';
+import { d as Reactive } from './index-CB-IiZIB.js';
+import { m as TimeTravelModule } from './timeTravel-D7NiYqdD.js';
 
 /** Reactive options for the TimeTravel overlay instance. */
-interface TimeTravelConfig {
+interface TimeTravelOverlayConfig {
     /** Header text shown at the top of the overlay panel. */
     title: string;
     /** Accent color used to derive panel theme variables. */
@@ -22,7 +22,7 @@ interface TimeTravelConfig {
 declare class TimeTravelOverlay {
     static count: number;
     index: number;
-    config: TimeTravelConfig;
+    config: TimeTravelOverlayConfig;
     readonly state: Reactive<{
         open: boolean;
         import: string;
@@ -35,8 +35,8 @@ declare class TimeTravelOverlay {
      * @param time TimeTravel module instance that owns timeline operations.
      * @param build Optional initial overlay config overrides.
      */
-    constructor(time: TimeTravelModule, build?: Partial<TimeTravelConfig>);
+    constructor(time: TimeTravelModule, build?: Partial<TimeTravelOverlayConfig>);
     destroy(): void;
 }
 
-export { type TimeTravelConfig as T, TimeTravelOverlay as a };
+export { TimeTravelOverlay as T, type TimeTravelOverlayConfig as a };

package/dist/adapters/react.cjs

@@ -73,7 +73,7 @@ function isPOJO(obj, config = NIL, typecheck = true) {
 function canHandle(obj, config = NIL, typecheck = true) {
   if (typecheck && !isObj(obj, false) || obj[INERTIA]) return false;
   if (Array.isArray(obj) || !config.preserveContext && isPOJO(obj, config, false)) return true;
-  if (config.preserveContext) return !(obj instanceof Map) && !(obj instanceof Set) && !(obj instanceof WeakMap) && !(obj instanceof WeakSet) && !(obj instanceof Error) && !(obj instanceof Number) && !(obj instanceof Date) && !(obj instanceof String) && !(obj instanceof RegExp) && !(obj instanceof ArrayBuffer) && !(obj instanceof Promise);
+  if (config.preserveContext) return !(obj instanceof String) && !(obj instanceof Number) && !(obj instanceof Function) && !(obj instanceof Date) && !(obj instanceof Error) && !(obj instanceof RegExp) && !(obj instanceof Promise) && !(obj instanceof Map) && !(obj instanceof WeakMap) && !(obj instanceof Set) && !(obj instanceof WeakSet) && !(obj instanceof EventTarget);
   return false;
 }
 function getAny(source, key, separator = ".", keyFunc) {
@@ -157,7 +157,10 @@ function parseEvtOpts(options, opts, boolOpt = opts[0], result = {}) {
 }
 function getTrailRecords(obj, path, reverse = false) {
   const parts = path.split("."), chain = [["*", obj, obj]];
-  for (let acc = "", currObj = obj, i = 0, len = parts.length; i < len; i++) chain.push([acc += (i ? "." : "") + parts[i], currObj, currObj = currObj?.[parts[i]]]);
+  for (let acc = "", currObj = obj, i = 0, len = parts.length; i < len; i++) {
+    const part = parts[i];
+    chain.push([acc += (i ? "." : "") + part, currObj, currObj = currObj?.[part]]);
+  }
   return reverse ? chain.reverse() : chain;
 }
 function nuke(target) {
@@ -165,10 +168,11 @@ function nuke(target) {
   while (proto && proto !== Object.prototype) {
     const keys2 = Object.getOwnPropertyNames(proto);
     for (let i = 0, len = keys2.length; i < len; i++) {
-      if (keys2[i] === "constructor") continue;
+      const key = keys2[i];
+      if (key === "constructor") continue;
       const desc = Object.getOwnPropertyDescriptor(proto, keys2[i]);
       if (desc && ("function" === typeof desc.value || desc.get || desc.set)) continue;
-      proto[keys2[i]] = null;
+      proto[key] = null;
     }
     proto = Object.getPrototypeOf(proto);
   }
@@ -463,7 +467,10 @@ var Reactor = class {
     seen.add(target);
     const es = (this.lineage ??= /* @__PURE__ */ new WeakMap()).get(target);
     if (!es) return paths;
-    for (let i = 0, len = es.length; i < len; i += 2) this.trace(es[i], es[i + 1] ? es[i + 1] + "." + path : path, paths, seen);
+    for (let i = 0, len = es.length; i < len; i += 2) {
+      const prev = es[i + 1];
+      this.trace(es[i], prev ? prev + "." + path : path, paths, seen);
+    }
     return paths;
   }
   // won't be called without `.config.referenceTracking` so internal guard avoided
@@ -493,9 +500,9 @@ var Reactor = class {
     let terminated = false, value = payload.target.value;
     const isGet = type === "get", isSet = type === "set", mediators = isGet ? this.getters : isSet ? this.setters : this.deleters;
     for (let i = !isGet ? 0 : cords.length - 1, len = !isGet ? cords.length : -1; i !== len; i += !isGet ? 1 : -1) {
-      const response = isGet ? cords[i].cb(value, payload) : isSet ? cords[i].cb(value, terminated, payload) : cords[i].cb(terminated, payload);
+      const cord = cords[i], response = isGet ? cord.cb(value, payload) : isSet ? cord.cb(value, terminated, payload) : cord.cb(terminated, payload);
       if (isGet || !(terminated ||= payload.terminated = response === TERMINATOR)) value = response;
-      if (cords[i].once) cords.splice((len--, i--), 1), !cords.length && mediators.delete(path);
+      if (cord.once) cords.splice((len--, i--), 1), !cords.length && mediators.delete(path);
     }
     return value;
   }
@@ -504,13 +511,15 @@ var Reactor = class {
       const wildcords = this.watchers.get("*"), cords = this.watchers.get(path);
       if (cords)
         for (let i = 0, len = cords.length; i < len; i++) {
-          cords[i].cb(payload.target.value, payload);
-          if (cords[i].once) cords.splice((len--, i--), 1), !cords.length && this.watchers.delete(path);
+          const cord = cords[i];
+          cord.cb(payload.target.value, payload);
+          if (cord.once) cords.splice((len--, i--), 1), !cords.length && this.watchers.delete(path);
         }
       if (wildcords)
         for (let i = 0, len = wildcords.length; i < len; i++) {
-          wildcords[i].cb(payload.target.value, payload);
-          if (wildcords[i].once) wildcords.splice((len--, i--), 1), !wildcords.length && this.watchers.delete("*");
+          const wildcord = wildcords[i];
+          wildcord.cb(payload.target.value, payload);
+          if (wildcord.once) wildcords.splice((len--, i--), 1), !wildcords.length && this.watchers.delete("*");
         }
     }
     this.listeners && this.schedule(path, payload);
@@ -549,14 +558,15 @@ var Reactor = class {
     e.type = path !== e.target.path ? "update" : e.staticType;
     e.currentTarget = { path, value, oldValue: e.type !== "update" ? e.target.oldValue : void 0, key: e.type !== "update" ? path : path.slice(path.lastIndexOf(".") + 1) || "", hadKey: e.type !== "update" ? e.target.hadKey : true, object };
     for (let i = 0, len = cords.length, tDepth; i < len; i++) {
+      const cord = cords[i];
       if (e.immediatePropagationStopped) break;
-      if (cords[i].capture !== isCapture) continue;
-      if (cords[i].depth !== void 0) {
+      if (cord.capture !== isCapture) continue;
+      if (cord.depth !== void 0) {
         tDepth ??= this.getDepth(e.target.path);
-        if (tDepth > cords[i].lDepth + cords[i].depth) continue;
+        if (tDepth > cord.lDepth + cord.depth) continue;
       }
-      cords[i].cb(e);
-      if (cords[i].once) cords.splice((len--, i--), 1), !cords.length && this.listeners.delete(path);
+      cord.cb(e);
+      if (cord.once) cords.splice((len--, i--), 1), !cords.length && this.listeners.delete(path);
     }
   }
   /**
@@ -618,25 +628,28 @@ var Reactor = class {
     const clone = !raw ? this.config.preserveContext ? Object.create(Object.getPrototypeOf(obj)) : Array.isArray(obj) ? [] : {} : obj;
     seen.set(obj, clone);
     const keys2 = this.config.preserveContext ? Reflect.ownKeys(obj) : Object.keys(obj);
-    for (let i = 0, len = keys2.length; i < len; i++)
+    for (let i = 0, len = keys2.length; i < len; i++) {
+      const key = keys2[i];
       try {
-        clone[keys2[i]] = this.cloned(obj[keys2[i]], raw, seen);
+        clone[key] = this.cloned(obj[key], raw, seen);
       } catch (e) {
         if (e instanceof RangeError) throw e;
       }
+    }
     if (!raw && this.config.smartCloning) this.snapCache.set(obj, clone), obj[SSVERSION] = version;
     return clone;
   }
   syncAdd(key, path, cb, opts, onImmediate = NOOP) {
     const { lazy = false, once = false, signal, immediate = false } = parseEvtOpts(opts, EVT_OPTS.MEDIATOR), store = this[`${key}${key.endsWith("t") ? "t" : ""}ers`] ??= /* @__PURE__ */ new Map();
     let cords = store.get(path), cord;
-    if (cords) {
-      for (let i = 0, len = cords.length; i < len; i++)
-        if (Object.is(cords[i].cb, cb)) {
-          cord = cords[i];
+    if (cords)
+      for (let i = 0, len = cords.length; i < len; i++) {
+        const excord = cords[i];
+        if (Object.is(excord.cb, cb)) {
+          cord = excord;
           break;
         }
-    }
+      }
     if (cord) return cord.clup;
     let task;
     cord = { cb, once, clup: () => (lazy && this.nostall(task), this[`no${key}`](path, cb)) };
@@ -648,7 +661,10 @@ var Reactor = class {
   syncDrop(store, path, cb) {
     const cords = store?.get(path);
     if (!cords) return void 0;
-    for (let i = 0, len = cords.length; i < len; i++) if (Object.is(cords[i].cb, cb)) return cords[i].sclup(), cords.splice((len--, i--), 1), !cords.length && store.delete(path), true;
+    for (let i = 0, len = cords.length; i < len; i++) {
+      const cord = cords[i];
+      if (Object.is(cord.cb, cb)) return cord.sclup(), cords.splice((len--, i--), 1), !cords.length && store.delete(path), true;
+    }
     return false;
   }
   /**
@@ -766,13 +782,14 @@ var Reactor = class {
     this.listeners ??= /* @__PURE__ */ new Map();
     const { capture = false, once = false, signal, immediate = false, depth } = parseEvtOpts(options, EVT_OPTS.LISTENER);
     let cords = this.listeners.get(path), cord;
-    if (cords) {
-      for (let i = 0, len = cords.length; i < len; i++)
-        if (Object.is(cords[i].cb, callback) && capture === cords[i].capture) {
-          cord = cords[i];
+    if (cords)
+      for (let i = 0, len = cords.length; i < len; i++) {
+        const excord = cords[i];
+        if (Object.is(excord.cb, callback) && capture === excord.capture) {
+          cord = excord;
           break;
         }
-    }
+      }
     if (cord) return cord.clup;
     cord = { cb: callback, capture, depth, once, clup: () => this.off(path, callback, options), lDepth: depth !== void 0 ? this.getDepth(path) : depth };
     if (immediate && (immediate !== "auto" || inAny(this.core, path))) {
@@ -801,7 +818,10 @@ var Reactor = class {
     const cords = this.listeners?.get(path);
     if (!cords) return void 0;
     const { capture } = parseEvtOpts(options, EVT_OPTS.LISTENER);
-    for (let i = 0, len = cords.length; i < len; i++) if (Object.is(cords[i].cb, callback) && cords[i].capture === capture) return cords[i].sclup(), cords.splice((len--, i--), 1), !cords.length && this.listeners.delete(path), true;
+    for (let i = 0, len = cords.length; i < len; i++) {
+      const cord = cords[i];
+      if (Object.is(cord.cb, callback) && cord.capture === capture) return cord.sclup(), cords.splice((len--, i--), 1), !cords.length && this.listeners.delete(path), true;
+    }
     return false;
   }
   snapshot(raw = !this.config.smartCloning, branch) {
@@ -873,19 +893,19 @@ var Autotracker = class {
     this.autortr = this.rtr = rtr;
   }
   /**
-   * Starts a new tracking pass and returns a tracking proxy for `target` if `this` was instantiated with a `Reactor`.
+   * Starts a new tracking pass and returns a readonly tracking proxy for `target` if `this` was instantiated with a `Reactor`.
    * @param target Snapshot (or state branch) to track reads from.
-   * @returns Read-tracking proxy.
+   * @returns Read-tracking readonly proxy.
    * @example
    * const atrkr = new Autotracker(rtr);
    * const state = atrkr.tracked(rtr.snapshot());
    * const name = state.user.profile.name;
    */
   tracked(target) {
-    return this.unblock(), this.rtr ? this.proxy = this.proxied(target, "") : target;
+    return this.unblock(), this.proxy = this.proxied(target, "");
   }
   proxied(obj, path) {
-    if (!obj || "object" !== typeof obj) return obj;
+    if (!this.rtr || !obj || "object" !== typeof obj) return obj;
     const cached = this.proxyCache.get(obj);
     if (cached) return cached;
     if (!canHandle(obj, this.rtr.config, false)) return obj;

package/dist/adapters/react.d.cts

@@ -1,7 +1,7 @@
-import { E as EffectOptions, R as Reactor, d as Reactive, u as ReactorBuild, W as WildPaths, v as PathValue } from '../index-m0aAWxhX.cjs';
+import { E as EffectOptions, R as Reactor, d as Reactive, v as ReactorBuild, D as DeepReadonly, W as WildPaths, e as PathValue } from '../index-CB-IiZIB.cjs';
 import { useLayoutEffect } from 'react';
-import { m as TimeTravelModule } from '../timeTravel-DctvcHVt.cjs';
-import { T as TimeTravelConfig } from '../TimeTravelOverlay-OjklzuCD.cjs';
+import { m as TimeTravelModule } from '../timeTravel-CEc3grUE.cjs';
+import { a as TimeTravelOverlayConfig } from '../TimeTravelOverlay-Bz2v9hov.cjs';
 
 /**
  * Subscribes a component to desired Reactor state and returns it.
@@ -30,7 +30,7 @@ declare function useReactor<T extends object>(target: T | Reactor<T> | Reactive<
  */
 declare function useAnyReactor(options?: EffectOptions): void;
 /**
- * Subscribes a component to Reactor state and returns a tracked snapshot.
+ * Subscribes a component to Reactor state and returns a readonly tracked snapshot.
  * Rule of thumb: read from snapshots, mutate the source.
  * The hook uses access tracking so re-renders occur only when accessed fields change.
  * @typeParam T Root state object type.
@@ -47,7 +47,7 @@ declare function useAnyReactor(options?: EffectOptions): void;
  * const rtr = new Reactor({ user: { name: "Kosi" } });
  * const c = useReactorSnapshot(rtr);
  */
-declare function useReactorSnapshot<T extends object>(target: T | Reactor<T> | Reactive<T>, options?: EffectOptions, build?: ReactorBuild<T>): T;
+declare function useReactorSnapshot<T extends object>(target: T | Reactor<T> | Reactive<T>, options?: EffectOptions, build?: ReactorBuild<T>): DeepReadonly<T>;
 
 /**
  * Subscribes to a derived slice of Reactor state.
@@ -84,7 +84,7 @@ declare function useSelector<T extends object, R>(target: T | Reactor<T> | React
 declare function useAnySelector<R>(sel: () => R, eq?: (value1: any, value2: any) => boolean, options?: EffectOptions): R;
 /**
  * Subscribes to a derived slice of Reactor state.
- * The selector runs against a tracked snapshot and uses the provided equality function
+ * The selector runs against a readonly tracked snapshot and uses the provided equality function
  * to suppress unchanged results.
  * @typeParam T Root state object type.
  * @typeParam R Selector return type.
@@ -103,7 +103,7 @@ declare function useAnySelector<R>(sel: () => R, eq?: (value1: any, value2: any)
  * const rtr = new Reactor({ user: { name: "Kosi" } });
  * const c = useSelectorSnapshot(rtr, (s) => s.user.name);
  */
-declare function useSelectorSnapshot<T extends object, R>(target: T | Reactor<T> | Reactive<T>, sel: (state: T) => R, eq?: (value1: any, value2: any) => boolean, options?: EffectOptions, build?: ReactorBuild<T>): R;
+declare function useSelectorSnapshot<T extends object, R>(target: T | Reactor<T> | Reactive<T>, sel: (state: DeepReadonly<T>) => R, eq?: (value1: any, value2: any) => boolean, options?: EffectOptions, build?: ReactorBuild<T>): R;
 
 /**
  * Subscribes to a single path in Reactor state.
@@ -132,7 +132,7 @@ declare function usePath<T extends object, P extends WildPaths<T>>(target: T | R
 declare const useISOLayoutEffect: typeof useLayoutEffect;
 
 /** React props for controlling the vanilla TimeTravel overlay. */
-interface TimeTravelOverlayProps extends Partial<TimeTravelConfig> {
+interface TimeTravelOverlayProps extends Partial<TimeTravelOverlayConfig> {
     /** Module instance controlled by this overlay bridge. */
     time: TimeTravelModule;
 }

package/dist/adapters/react.d.ts

@@ -1,7 +1,7 @@
-import { E as EffectOptions, R as Reactor, d as Reactive, u as ReactorBuild, W as WildPaths, v as PathValue } from '../index-m0aAWxhX.js';
+import { E as EffectOptions, R as Reactor, d as Reactive, v as ReactorBuild, D as DeepReadonly, W as WildPaths, e as PathValue } from '../index-CB-IiZIB.js';
 import { useLayoutEffect } from 'react';
-import { m as TimeTravelModule } from '../timeTravel-DExvNb04.js';
-import { T as TimeTravelConfig } from '../TimeTravelOverlay-Dglcwpg-.js';
+import { m as TimeTravelModule } from '../timeTravel-D7NiYqdD.js';
+import { a as TimeTravelOverlayConfig } from '../TimeTravelOverlay-CvTDJWpP.js';
 
 /**
  * Subscribes a component to desired Reactor state and returns it.
@@ -30,7 +30,7 @@ declare function useReactor<T extends object>(target: T | Reactor<T> | Reactive<
  */
 declare function useAnyReactor(options?: EffectOptions): void;
 /**
- * Subscribes a component to Reactor state and returns a tracked snapshot.
+ * Subscribes a component to Reactor state and returns a readonly tracked snapshot.
  * Rule of thumb: read from snapshots, mutate the source.
  * The hook uses access tracking so re-renders occur only when accessed fields change.
  * @typeParam T Root state object type.
@@ -47,7 +47,7 @@ declare function useAnyReactor(options?: EffectOptions): void;
  * const rtr = new Reactor({ user: { name: "Kosi" } });
  * const c = useReactorSnapshot(rtr);
  */
-declare function useReactorSnapshot<T extends object>(target: T | Reactor<T> | Reactive<T>, options?: EffectOptions, build?: ReactorBuild<T>): T;
+declare function useReactorSnapshot<T extends object>(target: T | Reactor<T> | Reactive<T>, options?: EffectOptions, build?: ReactorBuild<T>): DeepReadonly<T>;
 
 /**
  * Subscribes to a derived slice of Reactor state.
@@ -84,7 +84,7 @@ declare function useSelector<T extends object, R>(target: T | Reactor<T> | React
 declare function useAnySelector<R>(sel: () => R, eq?: (value1: any, value2: any) => boolean, options?: EffectOptions): R;
 /**
  * Subscribes to a derived slice of Reactor state.
- * The selector runs against a tracked snapshot and uses the provided equality function
+ * The selector runs against a readonly tracked snapshot and uses the provided equality function
  * to suppress unchanged results.
  * @typeParam T Root state object type.
  * @typeParam R Selector return type.
@@ -103,7 +103,7 @@ declare function useAnySelector<R>(sel: () => R, eq?: (value1: any, value2: any)
  * const rtr = new Reactor({ user: { name: "Kosi" } });
  * const c = useSelectorSnapshot(rtr, (s) => s.user.name);
  */
-declare function useSelectorSnapshot<T extends object, R>(target: T | Reactor<T> | Reactive<T>, sel: (state: T) => R, eq?: (value1: any, value2: any) => boolean, options?: EffectOptions, build?: ReactorBuild<T>): R;
+declare function useSelectorSnapshot<T extends object, R>(target: T | Reactor<T> | Reactive<T>, sel: (state: DeepReadonly<T>) => R, eq?: (value1: any, value2: any) => boolean, options?: EffectOptions, build?: ReactorBuild<T>): R;
 
 /**
  * Subscribes to a single path in Reactor state.
@@ -132,7 +132,7 @@ declare function usePath<T extends object, P extends WildPaths<T>>(target: T | R
 declare const useISOLayoutEffect: typeof useLayoutEffect;
 
 /** React props for controlling the vanilla TimeTravel overlay. */
-interface TimeTravelOverlayProps extends Partial<TimeTravelConfig> {
+interface TimeTravelOverlayProps extends Partial<TimeTravelOverlayConfig> {
     /** Module instance controlled by this overlay bridge. */
     time: TimeTravelModule;
 }

package/dist/adapters/react.js

@@ -2,10 +2,10 @@ import {
   Autotracker,
   TimeTravelOverlay,
   withTracker
-} from "../chunk-5JNWC7Z4.js";
+} from "../chunk-MWC3R7QL.js";
 import {
   getReactor
-} from "../chunk-MSTHQVNK.js";
+} from "../chunk-3UHI7CNE.js";
 import "../chunk-5A44QFT6.js";
 import "../chunk-P37ADJMM.js";
 import {
@@ -13,7 +13,7 @@ import {
   NIL,
   NOOP,
   getAny
-} from "../chunk-MKL3JUPO.js";
+} from "../chunk-EZ4VRGYI.js";
 
 // src/ts/adapters/react/hooks/useReactor.ts
 import { useRef, useCallback, useSyncExternalStore, useMemo } from "react";