sia-reactor 0.0.22 → 0.0.24

package/README.md

@@ -102,7 +102,7 @@ import { setAny, getAny, mergeObjs } from "sia-reactor/utils";
 
 ```javascript
 import { reactive, Reactor } from "sia-reactor";
-import "sia-reactor/utils"; // deep object helpers (setAny/getAny/deleteAny/inAny/parseAnyObj/fanout/mergeObjs/deepClone/nuke...)
+import "sia-reactor/utils"; // deep object helpers (setAny/getAny/deleteAny/inAny/parseAnyObj/fanout/mergeObjs/deepClone/nuke...) take note of `fanout`!
 import "sia-reactor/modules"; // built-in modules + storage adapters
 import "sia-reactor/adapters/vanilla"; // Autotracker + effect API + TimeTravelOverlay class
 import "sia-reactor/adapters/react"; // useReactor/useSelector/usePath hooks
@@ -245,7 +245,7 @@ const persist = new PersistModule({ // Plug it in. State is now automatically hy
   key: "APP_PREFS",
   paths: ["theme", "settings.brightness"],
   throttle: 5000, 
-  fanout: true, // async hydration should use leaf writes incase UI listeners already initialized.
+  fanout: true, // async hydration should use leaf writes to sync already initialized listeners.
   adapter: new IndexedDBAdapter({ dbName: "Session", version: 1, onversionchange: () => location.reload(), useSnapshot: true }) // or `LocalStorageAdapter` (instance or signature)
 };
 state.use(persist, getReactor(state)));  // Put `Reactor` as second constructor arg if you want type inference, e.g. for the paths in the array.
@@ -346,7 +346,7 @@ player.on("intent.playing", (e) => {
 ### Troubleshooting
 
 - Listener timing feels late: `on(path, ...)` is microtask-batched by design; use `watch(path, ...)` only for strict immediate engine sync on leaf paths preferably.
-- Listeners don't react to changes: use `fanout(state, path, object, { depth: n })` instead of direct object sets to keep immutable semantics.
+- Listeners don't react to changes: use `fanout(target, object, { depth: n })` instead of direct object sets to keep immutable semantics.
 - `reject()` appears ignored: call it in capture phase and ensure branch is wrapped in `intent(...)`, also remember it's the listener's choice to comply.
 - Snapshot behavior feels stale: enable `referenceTracking: true` with `smartCloning: true`, also use these when persisting to environments that don't take proxies, e.g. IndexedDB.
 - Cross-frame data is skipped: enable `crossRealms: true` for iframe/other realm objects.
@@ -475,7 +475,7 @@ rtr.on("todos", ({ type, target: { path, key } }) => {
   if (type === "update") console.log(path, key);
 }, { depth: 1 });
 // Better: narrow first, then destructure inside
-rtr.on("todos", (e: REvent<user, "todos", 1>) => {
+rtr.on("todos", (e: REvent<User, "todos", 1>) => {
   if (e.type === "update") {
     const { path, key } = e.target;
     console.log(path, key); // or e.target.path, e.target.key

package/dist/{TimeTravelOverlay-eWjAy0yr.d.ts → TimeTravelOverlay-BdJMMcX9.d.ts}

@@ -1,5 +1,5 @@
-import { d as Reactive } from './index-BgbbNXTW.js';
-import { m as TimeTravelModule } from './timeTravel-YUxRHRgh.js';
+import { d as Reactive } from './index-CDRimfvj.js';
+import { m as TimeTravelModule } from './timeTravel-Cb8MHdYz.js';
 
 /** Reactive options for the TimeTravel overlay instance. */
 interface TimeTravelConfig {

package/dist/{TimeTravelOverlay-DiXUgbUU.d.cts → TimeTravelOverlay-XwZju4iS.d.cts}

@@ -1,5 +1,5 @@
-import { d as Reactive } from './index-BgbbNXTW.cjs';
-import { m as TimeTravelModule } from './timeTravel-CraHdbXZ.cjs';
+import { d as Reactive } from './index-CDRimfvj.cjs';
+import { m as TimeTravelModule } from './timeTravel-CVgE6N0I.cjs';
 
 /** Reactive options for the TimeTravel overlay instance. */
 interface TimeTravelConfig {

package/dist/adapters/react.cjs

@@ -63,7 +63,7 @@ var NOOP = () => {
 };
 
 // src/ts/utils/obj.ts
-var arrRx = /^([^\[\]]+)\[(\d+)\]$/;
+var arrRegex = /^([^\[\]]+)\[(\d+)\]$/;
 function isObj(obj, arraycheck = true) {
   return "object" === typeof obj && obj !== null && (arraycheck ? !Array.isArray(obj) : true);
 }
@@ -71,9 +71,9 @@ function isPOJO(obj, config = NIL, typecheck = true) {
   return (typecheck ? isObj(obj, false) : true) && (config.crossRealms ? Object.prototype.toString.call(obj) === "[object Object]" : obj.constructor === Object);
 }
 function canHandle(obj, config = NIL, typecheck = true) {
-  if (typecheck && !isObj(obj, false)) return false;
+  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) {
@@ -82,7 +82,7 @@ function getAny(source, key, separator = ".", keyFunc) {
   const keys2 = key.split(separator);
   let currObj = source;
   for (let i = 0, len = keys2.length; i < len; i++) {
-    const key2 = keyFunc ? keyFunc(keys2[i]) : keys2[i], match = key2.includes("[") && key2.match(arrRx);
+    const key2 = keyFunc ? keyFunc(keys2[i]) : keys2[i], match = key2.includes("[") && key2.match(arrRegex);
     if (match) {
       const [, key3, iStr] = match;
       if (!Array.isArray(currObj[key3]) || !(key3 in currObj)) return void 0;
@@ -99,7 +99,7 @@ function setAny(target, key, value, separator = ".", keyFunc) {
   if (!key.includes(separator)) return void (target[keyFunc ? keyFunc(key) : key] = value);
   const keys2 = key.split(separator);
   for (let currObj = target, i = 0, len = keys2.length; i < len; i++) {
-    const key2 = keyFunc ? keyFunc(keys2[i]) : keys2[i], match = key2.includes("[") && key2.match(arrRx);
+    const key2 = keyFunc ? keyFunc(keys2[i]) : keys2[i], match = key2.includes("[") && key2.match(arrRegex);
     if (match) {
       const [, key3, iStr] = match;
       if (!Array.isArray(currObj[key3])) currObj[key3] = [];
@@ -120,7 +120,7 @@ function deleteAny(target, key, separator = ".", keyFunc) {
   if (!key.includes(separator)) return void delete target[keyFunc ? keyFunc(key) : key];
   const keys2 = key.split(separator);
   for (let currObj = target, i = 0, len = keys2.length; i < len; i++) {
-    const key2 = keyFunc ? keyFunc(keys2[i]) : keys2[i], match = key2.includes("[") && key2.match(arrRx);
+    const key2 = keyFunc ? keyFunc(keys2[i]) : keys2[i], match = key2.includes("[") && key2.match(arrRegex);
     if (match) {
       const [, key3, iStr] = match;
       if (!Array.isArray(currObj[key3]) || !(key3 in currObj)) return;
@@ -138,7 +138,7 @@ function inAny(source, key, separator = ".", keyFunc) {
   if (!key.includes(separator)) return key in source;
   const keys2 = key.split(separator);
   for (let currObj = source, i = 0, len = keys2.length; i < len; i++) {
-    const key2 = keyFunc ? keyFunc(keys2[i]) : keys2[i], match = key2.includes("[") && key2.match(arrRx);
+    const key2 = keyFunc ? keyFunc(keys2[i]) : keys2[i], match = key2.includes("[") && key2.match(arrRegex);
     if (match) {
       const [, key3, iStr] = match;
       if (!Array.isArray(currObj[key3]) || !(key3 in currObj)) return false;
@@ -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);
   }
@@ -339,7 +343,7 @@ var Reactor = class {
     if (this.config.referenceTracking && parent && key && !this.link(target, parent, key, false)) return target;
     const cached = this.proxyCache.get(target);
     if (cached) return cached;
-    if (target[INERTIA] || !canHandle(target, this.config, false)) return target;
+    if (!canHandle(target, this.config, false)) return target;
     rejectable ||= target[REJECTABLE];
     indiffable ||= target[INDIFFABLE];
     const proxy = new Proxy(target, {
@@ -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,24 +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);
-      } catch {
+        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)) };
@@ -647,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;
   }
   /**
@@ -765,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))) {
@@ -800,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) {
@@ -872,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, r as ReactorBuild, W as WildPaths, t as PathValue } from '../index-BgbbNXTW.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-CDRimfvj.cjs';
 import { useLayoutEffect } from 'react';
-import { m as TimeTravelModule } from '../timeTravel-CraHdbXZ.cjs';
-import { T as TimeTravelConfig } from '../TimeTravelOverlay-DiXUgbUU.cjs';
+import { m as TimeTravelModule } from '../timeTravel-CVgE6N0I.cjs';
+import { T as TimeTravelConfig } from '../TimeTravelOverlay-XwZju4iS.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.

package/dist/adapters/react.d.ts

@@ -1,7 +1,7 @@
-import { E as EffectOptions, R as Reactor, d as Reactive, r as ReactorBuild, W as WildPaths, t as PathValue } from '../index-BgbbNXTW.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-CDRimfvj.js';
 import { useLayoutEffect } from 'react';
-import { m as TimeTravelModule } from '../timeTravel-YUxRHRgh.js';
-import { T as TimeTravelConfig } from '../TimeTravelOverlay-eWjAy0yr.js';
+import { m as TimeTravelModule } from '../timeTravel-Cb8MHdYz.js';
+import { T as TimeTravelConfig } from '../TimeTravelOverlay-BdJMMcX9.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.

package/dist/adapters/react.js

@@ -2,10 +2,10 @@ import {
   Autotracker,
   TimeTravelOverlay,
   withTracker
-} from "../chunk-CS3FOV6J.js";
+} from "../chunk-6V5NR37Q.js";
 import {
   getReactor
-} from "../chunk-3SKLWTEA.js";
+} from "../chunk-4FES5IIH.js";
 import "../chunk-5A44QFT6.js";
 import "../chunk-P37ADJMM.js";
 import {
@@ -13,7 +13,7 @@ import {
   NIL,
   NOOP,
   getAny
-} from "../chunk-BTA6MIQ6.js";
+} from "../chunk-EZ4VRGYI.js";
 
 // src/ts/adapters/react/hooks/useReactor.ts
 import { useRef, useCallback, useSyncExternalStore, useMemo } from "react";