@montra-interactive/deepstate 0.3.0 → 0.3.1

package/README.md

@@ -9,7 +9,7 @@ Proxy-based reactive state management powered by RxJS. Each property is its own
 - **Type-safe**: Full TypeScript support with inferred types
 - **RxJS native**: Every node is an Observable - use `pipe()`, `combineLatest`, etc.
 - **Batched updates**: Group multiple changes into a single emission
-- **Immutable reads**: Values are deeply frozen to prevent accidental mutations
+- **Mutable snapshots**: Reads return plain values; use `.set()` to update state
 - **Nullable objects**: First-class support for `T | null` properties with deep subscription
 - **Debug mode**: Optional logging for development
 
@@ -301,14 +301,13 @@ store.selectedId.get();   // string | null
 ### Type Exports
 
 ```ts
-import type { RxState, Draft, DeepReadonly } from "@montra-interactive/deepstate";
+import type { RxState, Draft } from "@montra-interactive/deepstate";
 ```
 
 | Type | Description |
 |------|-------------|
 | `RxState<T>` | The reactive state type returned by `state()` |
 | `Draft<T>` | Type alias for values in update callbacks |
-| `DeepReadonly<T>` | Deep readonly type for returned values |
 
 ## Architecture
 

package/dist/deepstate.d.ts

@@ -21,12 +21,9 @@ type IsNullish<T> = HasNull<T> extends true ? true : HasUndefined<T>;
 type NonNullPartIsObject<T> = NonNullablePart<T> extends object ? NonNullablePart<T> extends Array<unknown> ? false : true : false;
 type IsNullableObject<T> = IsNullish<T> extends true ? NonNullPartIsObject<T> : false;
 /**
- * Deep readonly type - makes all nested properties readonly.
- * Used for return types of get() and subscribe() to prevent accidental mutations.
+ * Type alias for values returned by get() and subscribe().
  */
-export type DeepReadonly<T> = [T] extends [Primitive] ? T : [T] extends [Array<infer U>] ? ReadonlyArray<DeepReadonly<U>> : [T] extends [object] ? {
-    readonly [K in keyof T]: DeepReadonly<T[K]>;
-} : T;
+export type DeepReadonly<T> = T;
 /**
  * A mutable draft of state T for use in update callbacks.
  */
@@ -38,20 +35,20 @@ interface NodeCore<T> {
     subscribeOnce?(callback: (value: T) => void): Subscription;
 }
 declare const NODE: unique symbol;
-type RxLeaf<T> = Observable<DeepReadonly<T>> & {
+type RxLeaf<T> = Observable<T> & {
     /** Get current value synchronously */
-    get(): DeepReadonly<T>;
+    get(): T;
     /** Set value */
     set(value: T): void;
     /** Subscribe to a single emission, then automatically unsubscribe */
-    subscribeOnce(callback: (value: DeepReadonly<T>) => void): Subscription;
+    subscribeOnce(callback: (value: T) => void): Subscription;
     [NODE]: NodeCore<T>;
 };
 type RxObject<T extends object> = {
     [K in keyof T]: RxNodeFor<T[K]>;
-} & Observable<DeepReadonly<T>> & {
+} & Observable<T> & {
     /** Get current value synchronously */
-    get(): DeepReadonly<T>;
+    get(): T;
     /** Set value */
     set(value: T): void;
     /**
@@ -64,14 +61,14 @@ type RxObject<T extends object> = {
      *   draft.age.set(31);
      * });
      */
-    update(callback: (draft: RxObject<T>) => void): DeepReadonly<T>;
+    update(callback: (draft: RxObject<T>) => void): T;
     /** Subscribe to a single emission, then automatically unsubscribe */
-    subscribeOnce(callback: (value: DeepReadonly<T>) => void): Subscription;
+    subscribeOnce(callback: (value: T) => void): Subscription;
     [NODE]: NodeCore<T>;
 };
-type RxArray<T> = Observable<DeepReadonly<T[]>> & {
+type RxArray<T> = Observable<T[]> & {
     /** Get current value synchronously */
-    get(): DeepReadonly<T[]>;
+    get(): T[];
     /** Set value */
     set(value: T[]): void;
     /**
@@ -84,9 +81,9 @@ type RxArray<T> = Observable<DeepReadonly<T[]>> & {
      *   draft.push({ id: 2, name: "New" });
      * });
      */
-    update(callback: (draft: RxArray<T>) => void): DeepReadonly<T[]>;
+    update(callback: (draft: RxArray<T>) => void): T[];
     /** Subscribe to a single emission, then automatically unsubscribe */
-    subscribeOnce(callback: (value: DeepReadonly<T[]>) => void): Subscription;
+    subscribeOnce(callback: (value: T[]) => void): Subscription;
     /** Get reactive node for array element at index */
     at(index: number): RxNodeFor<T> | undefined;
     /** Get current length (also observable) */
@@ -96,11 +93,11 @@ type RxArray<T> = Observable<DeepReadonly<T[]>> & {
     /** Push items and return new length */
     push(...items: T[]): number;
     /** Pop last item */
-    pop(): DeepReadonly<T> | undefined;
+    pop(): T | undefined;
     /** Map over current values (non-reactive, use .subscribe for reactive) */
-    map<U>(fn: (item: DeepReadonly<T>, index: number) => U): U[];
+    map<U>(fn: (item: T, index: number) => U): U[];
     /** Filter current values */
-    filter(fn: (item: DeepReadonly<T>, index: number) => boolean): DeepReadonly<T>[];
+    filter(fn: (item: T, index: number) => boolean): T[];
     [NODE]: NodeCore<T[]>;
 };
 /**
@@ -124,13 +121,13 @@ type RxArray<T> = Observable<DeepReadonly<T[]>> & {
  * store.user.name.get();               // "Alice"
  * store.user.name.set("Bob");          // Works!
  */
-type RxNullable<T, TNonNull extends object = NonNullablePart<T> & object> = Observable<DeepReadonly<T>> & {
+type RxNullable<T, TNonNull extends object = NonNullablePart<T> & object> = Observable<T> & {
     /** Get current value (may be null/undefined) */
-    get(): DeepReadonly<T>;
+    get(): T;
     /** Set value (can be null/undefined or the full object) */
     set(value: T): void;
     /** Subscribe to a single emission, then automatically unsubscribe */
-    subscribeOnce(callback: (value: DeepReadonly<T>) => void): Subscription;
+    subscribeOnce(callback: (value: T) => void): Subscription;
     /**
      * Update multiple properties in a single emission.
      * @example
@@ -139,7 +136,7 @@ type RxNullable<T, TNonNull extends object = NonNullablePart<T> & object> = Obse
      *   user.age.set(31);
      * });
      */
-    update(callback: (draft: RxObject<TNonNull>) => void): DeepReadonly<T>;
+    update(callback: (draft: RxObject<TNonNull>) => void): T;
     [NODE]: NodeCore<T>;
 } & {
     [K in keyof TNonNull]: RxNullableChild<TNonNull[K]>;
@@ -156,21 +153,16 @@ type RxNullableChild<T> = IsNullableObject<T> extends true ? RxNullable<T> : [T]
  * The object itself might be undefined (if parent is null), but if present
  * it has all the normal object methods and children.
  */
-type RxNullableChildObject<T extends object> = Observable<DeepReadonly<T> | undefined> & {
-    get(): DeepReadonly<T> | undefined;
+type RxNullableChildObject<T extends object> = Observable<T | undefined> & {
+    get(): T | undefined;
     set(value: T): void;
-    subscribeOnce(callback: (value: DeepReadonly<T> | undefined) => void): Subscription;
+    subscribeOnce(callback: (value: T | undefined) => void): Subscription;
     [NODE]: NodeCore<T | undefined>;
 } & {
     [K in keyof T]: RxNullableChild<T[K]>;
 };
 type RxNodeFor<T> = IsNullableObject<T> extends true ? RxNullable<T> : [T] extends [Primitive] ? RxLeaf<T> : [T] extends [Array<infer U>] ? RxArray<U> : [T] extends [object] ? RxObject<T> : RxLeaf<T>;
-export type RxState<T extends object> = RxObject<T> & {
-    /** Reset the store to its initial state */
-    reset(): void;
-    /** Get the initial state (frozen copy) */
-    getInitialState(): DeepReadonly<T>;
-};
+export type RxState<T extends object> = RxObject<T>;
 export interface StateOptions {
     /** Enable debug logging for this store */
     debug?: boolean;

package/dist/deepstate.d.ts.map

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

package/dist/helpers.d.ts

@@ -56,6 +56,6 @@ export declare function select<T extends Record<string, Observable<unknown>>>(ob
  * @param selector - A function that extracts/derives a value from each item
  * @returns An Observable that emits an array of selected values
  */
-export declare function selectFromEach<T, U>(arrayNode: Observable<ReadonlyArray<T>>, selector: (item: T, index: number) => U): Observable<U[]>;
+export declare function selectFromEach<T, U>(arrayNode: Observable<T[]>, selector: (item: T, index: number) => U): Observable<U[]>;
 export {};
 //# sourceMappingURL=helpers.d.ts.map

package/dist/helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAiB,MAAM,MAAM,CAAC;AAoCjD,KAAK,eAAe,CAAC,CAAC,IAAI,CAAC,SAAS,UAAU,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;AAGpE,KAAK,gBAAgB,CAAC,CAAC,SAAS,UAAU,CAAC,OAAO,CAAC,EAAE,IAAI;KACtD,CAAC,IAAI,MAAM,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CACtC,CAAC;AAGF,KAAK,sBAAsB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC,IAAI;KAC1E,CAAC,IAAI,MAAM,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CACtC,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,MAAM,CAAC,CAAC,SAAS,UAAU,CAAC,OAAO,CAAC,EAAE,EACpD,GAAG,WAAW,EAAE,CAAC,GAChB,UAAU,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC;AACnC,wBAAgB,MAAM,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC,EAClE,WAAW,EAAE,CAAC,GACb,UAAU,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC,CAAC;AAyBzC;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,CAAC,EACjC,SAAS,EAAE,UAAU,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,EACvC,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,CAAC,GACtC,UAAU,CAAC,CAAC,EAAE,CAAC,CAOjB"}
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAiB,MAAM,MAAM,CAAC;AA+CjD,KAAK,eAAe,CAAC,CAAC,IAAI,CAAC,SAAS,UAAU,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;AAGpE,KAAK,gBAAgB,CAAC,CAAC,SAAS,UAAU,CAAC,OAAO,CAAC,EAAE,IAAI;KACtD,CAAC,IAAI,MAAM,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CACtC,CAAC;AAGF,KAAK,sBAAsB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC,IAAI;KAC1E,CAAC,IAAI,MAAM,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CACtC,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,MAAM,CAAC,CAAC,SAAS,UAAU,CAAC,OAAO,CAAC,EAAE,EACpD,GAAG,WAAW,EAAE,CAAC,GAChB,UAAU,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC;AACnC,wBAAgB,MAAM,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC,EAClE,WAAW,EAAE,CAAC,GACb,UAAU,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC,CAAC;AAyBzC;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,CAAC,EACjC,SAAS,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC,EAC1B,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,CAAC,GACtC,UAAU,CAAC,CAAC,EAAE,CAAC,CAOjB"}

package/dist/helpers.js

@@ -1,17 +1,24 @@
 // src/helpers.ts
 import { combineLatest } from "rxjs";
 import { distinctUntilChanged, map } from "rxjs/operators";
-function deepEqual(a, b) {
+function deepEqual(a, b, seen = new WeakMap) {
   if (a === b)
     return true;
   if (a === null || b === null)
     return false;
   if (typeof a !== "object" || typeof b !== "object")
     return false;
+  const seenWithA = seen.get(a);
+  if (seenWithA?.has(b))
+    return true;
+  if (!seen.has(a)) {
+    seen.set(a, new WeakSet);
+  }
+  seen.get(a).add(b);
   if (Array.isArray(a) && Array.isArray(b)) {
     if (a.length !== b.length)
       return false;
-    return a.every((item, i) => deepEqual(item, b[i]));
+    return a.every((item, i) => deepEqual(item, b[i], seen));
   }
   if (Array.isArray(a) !== Array.isArray(b))
     return false;
@@ -19,7 +26,7 @@ function deepEqual(a, b) {
   const keysB = Object.keys(b);
   if (keysA.length !== keysB.length)
     return false;
-  return keysA.every((key) => deepEqual(a[key], b[key]));
+  return keysA.every((key) => deepEqual(a[key], b[key], seen));
 }
 function isObservable(obj) {
   return obj !== null && typeof obj === "object" && "subscribe" in obj && typeof obj.subscribe === "function";

package/dist/index.js

@@ -1,17 +1,24 @@
 // src/helpers.ts
 import { combineLatest } from "rxjs";
 import { distinctUntilChanged, map } from "rxjs/operators";
-function deepEqual(a, b) {
+function deepEqual(a, b, seen = new WeakMap) {
   if (a === b)
     return true;
   if (a === null || b === null)
     return false;
   if (typeof a !== "object" || typeof b !== "object")
     return false;
+  const seenWithA = seen.get(a);
+  if (seenWithA?.has(b))
+    return true;
+  if (!seen.has(a)) {
+    seen.set(a, new WeakSet);
+  }
+  seen.get(a).add(b);
   if (Array.isArray(a) && Array.isArray(b)) {
     if (a.length !== b.length)
       return false;
-    return a.every((item, i) => deepEqual(item, b[i]));
+    return a.every((item, i) => deepEqual(item, b[i], seen));
   }
   if (Array.isArray(a) !== Array.isArray(b))
     return false;
@@ -19,7 +26,7 @@ function deepEqual(a, b) {
   const keysB = Object.keys(b);
   if (keysA.length !== keysB.length)
     return false;
-  return keysA.every((key) => deepEqual(a[key], b[key]));
+  return keysA.every((key) => deepEqual(a[key], b[key], seen));
 }
 function isObservable(obj) {
   return obj !== null && typeof obj === "object" && "subscribe" in obj && typeof obj.subscribe === "function";
@@ -84,21 +91,6 @@ function countedDistinctUntilChanged(compareFn) {
     return a === b;
   });
 }
-function deepFreeze(obj) {
-  if (obj === null || typeof obj !== "object")
-    return obj;
-  if (Object.isFrozen(obj))
-    return obj;
-  Object.freeze(obj);
-  if (Array.isArray(obj)) {
-    obj.forEach((item) => deepFreeze(item));
-  } else {
-    Object.keys(obj).forEach((key) => {
-      deepFreeze(obj[key]);
-    });
-  }
-  return obj;
-}
 var NODE = Symbol("node");
 function createLeafNode(value) {
   const subject$ = new BehaviorSubject(value);
@@ -147,25 +139,19 @@ function createObjectNode(value) {
     return result;
   }), shareReplay(1));
   $.subscribe();
-  const frozen$ = $.pipe(map2(deepFreeze));
   return {
-    $: frozen$,
+    $,
     children,
-    get: () => deepFreeze(getCurrentValue()),
+    get: () => getCurrentValue(),
     set: (v) => {
-      lock$.next(false);
-      try {
-        for (const [key, child] of children) {
-          child.set(v[key]);
-        }
-      } finally {
-        lock$.next(true);
+      for (const [key, child] of children) {
+        child.set(v[key]);
       }
     },
     lock: () => lock$.next(false),
     unlock: () => lock$.next(true),
     subscribeOnce: (callback) => {
-      return frozen$.pipe(take(1)).subscribe(callback);
+      return $.pipe(take(1)).subscribe(callback);
     }
   };
 }
@@ -194,7 +180,7 @@ function createArrayNode(value, comparator) {
   };
   const lock$ = new BehaviorSubject(true);
   const baseLocked$ = combineLatest2([subject$, lock$]).pipe(filter(([_, unlocked]) => unlocked), map2(([arr, _]) => arr));
-  const locked$ = (comparator ? baseLocked$.pipe(distinctUntilChanged2(comparator)) : baseLocked$).pipe(map2(deepFreeze), shareReplay(1));
+  const locked$ = (comparator ? baseLocked$.pipe(distinctUntilChanged2(comparator)) : baseLocked$).pipe(map2((arr) => [...arr]), shareReplay(1));
   locked$.subscribe();
   const length$ = locked$.pipe(map2((arr) => arr.length), distinctUntilChanged2(), shareReplay(1));
   length$.subscribe();
@@ -204,8 +190,11 @@ function createArrayNode(value, comparator) {
   return {
     $: locked$,
     childCache,
-    get: () => deepFreeze([...subject$.getValue()]),
+    get: () => [...subject$.getValue()],
     set: (v) => {
+      if (hasCircularReference(v)) {
+        throw new Error("Circular reference detected in array value. " + "Deepstate does not support circular references. " + "Please flatten your data structure or remove the circular reference.");
+      }
       childCache.clear();
       subject$.next([...v]);
     },
@@ -235,13 +224,13 @@ function createArrayNode(value, comparator) {
       const last = current[current.length - 1];
       childCache.delete(current.length - 1);
       subject$.next(current.slice(0, -1));
-      return deepFreeze(last);
+      return last;
     },
     mapItems: (fn) => {
-      return subject$.getValue().map((item, i) => fn(deepFreeze(item), i));
+      return subject$.getValue().map((item, i) => fn(item, i));
     },
     filterItems: (fn) => {
-      return deepFreeze(subject$.getValue().filter((item, i) => fn(deepFreeze(item), i)));
+      return subject$.getValue().filter((item, i) => fn(item, i));
     },
     lock: () => lock$.next(false),
     unlock: () => lock$.next(true)
@@ -289,7 +278,7 @@ function createNullableObjectNode(initialValue) {
     if (b === null || b === undefined)
       return false;
     return JSON.stringify(a) === JSON.stringify(b);
-  }), map2(deepFreeze), shareReplay(1));
+  }), shareReplay(1));
   $.subscribe();
   const nodeState = { children };
   const updateChildrenRef = () => {
@@ -318,7 +307,7 @@ function createNullableObjectNode(initialValue) {
     get children() {
       return nodeState.children;
     },
-    get: () => deepFreeze(getCurrentValue()),
+    get: () => getCurrentValue(),
     set: (value) => {
       if (value === null || value === undefined) {
         subject$.next(value);
@@ -553,6 +542,17 @@ function createNestedArrayProjection(parentArray$, index, key, initialValue) {
     }
   };
 }
+function hasCircularReference(obj, seen = new WeakSet) {
+  if (obj === null || typeof obj !== "object")
+    return false;
+  if (seen.has(obj))
+    return true;
+  seen.add(obj);
+  if (Array.isArray(obj)) {
+    return obj.some((item) => hasCircularReference(item, seen));
+  }
+  return Object.values(obj).some((value) => hasCircularReference(value, seen));
+}
 function createNodeForValue(value, maybeNullable = false) {
   if (isNullableMarked(value)) {
     delete value[NULLABLE_MARKER];
@@ -567,6 +567,9 @@ function createNodeForValue(value, maybeNullable = false) {
   if (typeof value !== "object") {
     return createLeafNode(value);
   }
+  if (hasCircularReference(value)) {
+    throw new Error("Circular reference detected in state value. " + "Deepstate does not support circular references because each property becomes a reactive node. " + "Please flatten your data structure or remove the circular reference.");
+  }
   if (Array.isArray(value)) {
     if (isArrayMarked(value)) {
       const options = value[ARRAY_MARKER];
@@ -658,7 +661,7 @@ function wrapNullableWithProxy(node, path = "", debugLog) {
   });
   return proxy;
 }
-function wrapWithProxy(node, path = "", debugLog, rootMethods) {
+function wrapWithProxy(node, path = "", debugLog) {
   if (isNullableNode(node)) {
     return wrapNullableWithProxy(node, path, debugLog);
   }
@@ -731,12 +734,6 @@ function wrapWithProxy(node, path = "", debugLog, rootMethods) {
         return node.subscribeOnce;
       if (prop === NODE)
         return node;
-      if (rootMethods) {
-        if (prop === "reset")
-          return rootMethods.reset;
-        if (prop === "getInitialState")
-          return rootMethods.getInitialState;
-      }
       if (prop === Symbol.observable || prop === "@@observable") {
         return () => node.$;
       }
@@ -787,21 +784,8 @@ function wrapWithProxy(node, path = "", debugLog, rootMethods) {
 }
 function state(initialState, options) {
   const debugLog = options?.debug ? createDebugLog({ enabled: true, storeName: options.name }) : undefined;
-  const frozenInitialState = deepFreeze(structuredClone(initialState));
   const node = createObjectNode(initialState);
-  const rootMethods = {
-    reset: () => {
-      debugLog?.("root", "reset", node.get(), frozenInitialState);
-      node.lock();
-      try {
-        node.set(structuredClone(frozenInitialState));
-      } finally {
-        node.unlock();
-      }
-    },
-    getInitialState: () => frozenInitialState
-  };
-  return wrapWithProxy(node, "", debugLog, rootMethods);
+  return wrapWithProxy(node, "", debugLog);
 }
 var NULLABLE_MARKER = Symbol("nullable");
 function nullable(value) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@montra-interactive/deepstate",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Proxy-based reactive state management with RxJS. Deep nested state observation with full TypeScript support.",
   "keywords": [
     "state",
@@ -19,7 +19,7 @@
   "homepage": "https://github.com/Montra-Interactive/deepstate/tree/main/packages/core",
   "repository": {
     "type": "git",
-    "url": "https://github.com/Montra-Interactive/deepstate",
+    "url": "git+https://github.com/Montra-Interactive/deepstate.git",
     "directory": "packages/core"
   },
   "module": "dist/index.js",

package/src/deepstate.ts

@@ -75,27 +75,6 @@ function countedDistinctUntilChanged<T>(compareFn?: (a: T, b: T) => boolean) {
   });
 }
 
-// =============================================================================
-// Deep Freeze
-// =============================================================================
-
-function deepFreeze<T>(obj: T): T {
-  if (obj === null || typeof obj !== "object") return obj;
-  if (Object.isFrozen(obj)) return obj;
-
-  Object.freeze(obj);
-
-  if (Array.isArray(obj)) {
-    obj.forEach((item) => deepFreeze(item));
-  } else {
-    Object.keys(obj).forEach((key) => {
-      deepFreeze((obj as Record<string, unknown>)[key]);
-    });
-  }
-
-  return obj;
-}
-
 // =============================================================================
 // Types
 // =============================================================================
@@ -123,16 +102,9 @@ type IsNullableObject<T> = IsNullish<T> extends true
   : false;
 
 /**
- * Deep readonly type - makes all nested properties readonly.
- * Used for return types of get() and subscribe() to prevent accidental mutations.
+ * Type alias for values returned by get() and subscribe().
  */
-export type DeepReadonly<T> = [T] extends [Primitive]
-  ? T
-  : [T] extends [Array<infer U>]
-    ? ReadonlyArray<DeepReadonly<U>>
-    : [T] extends [object]
-      ? { readonly [K in keyof T]: DeepReadonly<T[K]> }
-      : T;
+export type DeepReadonly<T> = T;
 
 /**
  * A mutable draft of state T for use in update callbacks.
@@ -151,21 +123,21 @@ interface NodeCore<T> {
 const NODE = Symbol("node");
 
 // External API types
-type RxLeaf<T> = Observable<DeepReadonly<T>> & {
+type RxLeaf<T> = Observable<T> & {
   /** Get current value synchronously */
-  get(): DeepReadonly<T>;
+  get(): T;
   /** Set value */
   set(value: T): void;
   /** Subscribe to a single emission, then automatically unsubscribe */
-  subscribeOnce(callback: (value: DeepReadonly<T>) => void): Subscription;
+  subscribeOnce(callback: (value: T) => void): Subscription;
   [NODE]: NodeCore<T>;
 };
 
 type RxObject<T extends object> = {
   [K in keyof T]: RxNodeFor<T[K]>;
-} & Observable<DeepReadonly<T>> & {
+} & Observable<T> & {
   /** Get current value synchronously */
-  get(): DeepReadonly<T>;
+  get(): T;
   /** Set value */
   set(value: T): void;
   /** 
@@ -178,15 +150,15 @@ type RxObject<T extends object> = {
    *   draft.age.set(31);
    * });
    */
-  update(callback: (draft: RxObject<T>) => void): DeepReadonly<T>;
+  update(callback: (draft: RxObject<T>) => void): T;
   /** Subscribe to a single emission, then automatically unsubscribe */
-  subscribeOnce(callback: (value: DeepReadonly<T>) => void): Subscription;
+  subscribeOnce(callback: (value: T) => void): Subscription;
   [NODE]: NodeCore<T>;
 };
 
-type RxArray<T> = Observable<DeepReadonly<T[]>> & {
+type RxArray<T> = Observable<T[]> & {
   /** Get current value synchronously */
-  get(): DeepReadonly<T[]>;
+  get(): T[];
   /** Set value */
   set(value: T[]): void;
   /** 
@@ -199,9 +171,9 @@ type RxArray<T> = Observable<DeepReadonly<T[]>> & {
    *   draft.push({ id: 2, name: "New" });
    * });
    */
-  update(callback: (draft: RxArray<T>) => void): DeepReadonly<T[]>;
+  update(callback: (draft: RxArray<T>) => void): T[];
   /** Subscribe to a single emission, then automatically unsubscribe */
-  subscribeOnce(callback: (value: DeepReadonly<T[]>) => void): Subscription;
+  subscribeOnce(callback: (value: T[]) => void): Subscription;
   /** Get reactive node for array element at index */
   at(index: number): RxNodeFor<T> | undefined;
   /** Get current length (also observable) */
@@ -209,11 +181,11 @@ type RxArray<T> = Observable<DeepReadonly<T[]>> & {
   /** Push items and return new length */
   push(...items: T[]): number;
   /** Pop last item */
-  pop(): DeepReadonly<T> | undefined;
+  pop(): T | undefined;
   /** Map over current values (non-reactive, use .subscribe for reactive) */
-  map<U>(fn: (item: DeepReadonly<T>, index: number) => U): U[];
+  map<U>(fn: (item: T, index: number) => U): U[];
   /** Filter current values */
-  filter(fn: (item: DeepReadonly<T>, index: number) => boolean): DeepReadonly<T>[];
+  filter(fn: (item: T, index: number) => boolean): T[];
   [NODE]: NodeCore<T[]>;
 };
 
@@ -238,13 +210,13 @@ type RxArray<T> = Observable<DeepReadonly<T[]>> & {
  * store.user.name.get();               // "Alice"
  * store.user.name.set("Bob");          // Works!
  */
-type RxNullable<T, TNonNull extends object = NonNullablePart<T> & object> = Observable<DeepReadonly<T>> & {
+type RxNullable<T, TNonNull extends object = NonNullablePart<T> & object> = Observable<T> & {
   /** Get current value (may be null/undefined) */
-  get(): DeepReadonly<T>;
+  get(): T;
   /** Set value (can be null/undefined or the full object) */
   set(value: T): void;
   /** Subscribe to a single emission, then automatically unsubscribe */
-  subscribeOnce(callback: (value: DeepReadonly<T>) => void): Subscription;
+  subscribeOnce(callback: (value: T) => void): Subscription;
   /**
    * Update multiple properties in a single emission.
    * @example
@@ -253,7 +225,7 @@ type RxNullable<T, TNonNull extends object = NonNullablePart<T> & object> = Obse
    *   user.age.set(31);
    * });
    */
-  update(callback: (draft: RxObject<TNonNull>) => void): DeepReadonly<T>;
+  update(callback: (draft: RxObject<TNonNull>) => void): T;
   [NODE]: NodeCore<T>;
 } & {
   /** 
@@ -291,10 +263,10 @@ type RxNullableChild<T> =
  * The object itself might be undefined (if parent is null), but if present
  * it has all the normal object methods and children.
  */
-type RxNullableChildObject<T extends object> = Observable<DeepReadonly<T> | undefined> & {
-  get(): DeepReadonly<T> | undefined;
+type RxNullableChildObject<T extends object> = Observable<T | undefined> & {
+  get(): T | undefined;
   set(value: T): void;
-  subscribeOnce(callback: (value: DeepReadonly<T> | undefined) => void): Subscription;
+  subscribeOnce(callback: (value: T | undefined) => void): Subscription;
   [NODE]: NodeCore<T | undefined>;
 } & {
   [K in keyof T]: RxNullableChild<T[K]>;
@@ -316,12 +288,7 @@ type RxNodeFor<T> =
   // Fallback
   : RxLeaf<T>;
 
-export type RxState<T extends object> = RxObject<T> & {
-  /** Reset the store to its initial state */
-  reset(): void;
-  /** Get the initial state (frozen copy) */
-  getInitialState(): DeepReadonly<T>;
-};
+export type RxState<T extends object> = RxObject<T>;
 
 // =============================================================================
 // Node Creation
@@ -408,29 +375,20 @@ function createObjectNode<T extends object>(value: T): NodeCore<T> & {
   // Force subscription to make it hot (so emissions work even before external subscribers)
   $.subscribe();
 
-  // Create a version that freezes on emission
-  const frozen$ = $.pipe(map(deepFreeze));
-
   return {
-    $: frozen$,
+    $,
     children: children as Map<string, NodeCore<unknown>>,
-    get: () => deepFreeze(getCurrentValue()),
+    get: () => getCurrentValue(),
     set: (v: T) => {
-      // Lock to batch all child updates into single emission
-      lock$.next(false);
-      try {
-        for (const [key, child] of children) {
-          child.set(v[key]);
-        }
-      } finally {
-        lock$.next(true);
+      for (const [key, child] of children) {
+        child.set(v[key]);
       }
     },
     lock: () => lock$.next(false),
     unlock: () => lock$.next(true),
     // Note: update() is implemented in wrapWithProxy since it needs the proxy reference
     subscribeOnce: (callback: (value: T) => void): Subscription => {
-      return frozen$.pipe(take(1)).subscribe(callback);
+      return $.pipe(take(1)).subscribe(callback);
     },
   };
 }
@@ -499,11 +457,11 @@ function createArrayNode<T>(
   );
   
   // Apply distinct comparison if provided
-  const locked$ = (comparator 
+  const locked$ = (comparator
     ? baseLocked$.pipe(distinctUntilChanged(comparator))
     : baseLocked$
   ).pipe(
-    map(deepFreeze),
+    map((arr) => [...arr]),
     shareReplay(1)
   );
   locked$.subscribe(); // Keep hot
@@ -523,8 +481,16 @@ function createArrayNode<T>(
   return {
     $: locked$ as Observable<T[]>,
     childCache,
-    get: () => deepFreeze([...subject$.getValue()]) as T[],
+    get: () => [...subject$.getValue()] as T[],
     set: (v: T[]) => {
+      // Check for circular references in array items
+      if (hasCircularReference(v)) {
+        throw new Error(
+          'Circular reference detected in array value. ' +
+          'Deepstate does not support circular references. ' +
+          'Please flatten your data structure or remove the circular reference.'
+        );
+      }
       // Clear child cache when array is replaced
       childCache.clear();
       subject$.next([...v]);
@@ -555,13 +521,13 @@ function createArrayNode<T>(
       // Clear cached node for popped index
       childCache.delete(current.length - 1);
       subject$.next(current.slice(0, -1));
-      return deepFreeze(last) as T;
+      return last as T;
     },
     mapItems: <U>(fn: (item: T, index: number) => U): U[] => {
-      return subject$.getValue().map((item, i) => fn(deepFreeze(item) as T, i));
+      return subject$.getValue().map((item, i) => fn(item as T, i));
     },
     filterItems: (fn: (item: T, index: number) => boolean): T[] => {
-      return deepFreeze(subject$.getValue().filter((item, i) => fn(deepFreeze(item) as T, i))) as T[];
+      return subject$.getValue().filter((item, i) => fn(item as T, i)) as T[];
     },
     lock: () => lock$.next(false),
     unlock: () => lock$.next(true),
@@ -663,7 +629,6 @@ function createNullableObjectNode<T>(
       if (b === null || b === undefined) return false;
       return JSON.stringify(a) === JSON.stringify(b);
     }),
-    map(deepFreeze),
     shareReplay(1)
   );
   $.subscribe(); // Keep hot
@@ -706,7 +671,7 @@ function createNullableObjectNode<T>(
     $,
     get children() { return nodeState.children; },
     
-    get: () => deepFreeze(getCurrentValue()),
+    get: () => getCurrentValue(),
     
     set: (value: T) => {
       if (value === null || value === undefined) {
@@ -1078,6 +1043,19 @@ function createNestedArrayProjection<T>(
   };
 }
 
+// Helper to detect circular references in an object
+function hasCircularReference(obj: unknown, seen = new WeakSet<object>()): boolean {
+  if (obj === null || typeof obj !== 'object') return false;
+  if (seen.has(obj as object)) return true;
+  seen.add(obj as object);
+  
+  if (Array.isArray(obj)) {
+    return obj.some(item => hasCircularReference(item, seen));
+  }
+  
+  return Object.values(obj).some(value => hasCircularReference(value, seen));
+}
+
 // Factory to create the right node type
 // When maybeNullable is true and value is null/undefined, creates a NullableNodeCore
 // that can later be upgraded to an object with children
@@ -1099,6 +1077,16 @@ function createNodeForValue<T>(value: T, maybeNullable: boolean = false): NodeCo
   if (typeof value !== "object") {
     return createLeafNode(value as Primitive) as NodeCore<T>;
   }
+  
+  // Check for circular references before creating nodes
+  if (hasCircularReference(value)) {
+    throw new Error(
+      'Circular reference detected in state value. ' +
+      'Deepstate does not support circular references because each property becomes a reactive node. ' +
+      'Please flatten your data structure or remove the circular reference.'
+    );
+  }
+  
   if (Array.isArray(value)) {
     // Check if array was marked with options via array() helper
     if (isArrayMarked(value)) {
@@ -1217,12 +1205,7 @@ function wrapNullableWithProxy<T>(node: NullableNodeCore<T>, path: string = '',
   return proxy as unknown as RxNullable<T>;
 }
 
-interface RootMethods<T> {
-  reset: () => void;
-  getInitialState: () => DeepReadonly<T>;
-}
-
-function wrapWithProxy<T>(node: NodeCore<T>, path: string = '', debugLog?: DebugLogFn, rootMethods?: RootMethods<T>): RxNodeFor<T> {
+function wrapWithProxy<T>(node: NodeCore<T>, path: string = '', debugLog?: DebugLogFn): RxNodeFor<T> {
   // Check for nullable node first (before checking value, since value might be null)
   if (isNullableNode(node)) {
     return wrapNullableWithProxy(node, path, debugLog) as RxNodeFor<T>;
@@ -1319,12 +1302,6 @@ function wrapWithProxy<T>(node: NodeCore<T>, path: string = '', debugLog?: Debug
       if (prop === "update") return updateFn;
       if (prop === "subscribeOnce") return node.subscribeOnce;
       if (prop === NODE) return node;
-      
-      // Root store methods (reset, getInitialState)
-      if (rootMethods) {
-        if (prop === "reset") return rootMethods.reset;
-        if (prop === "getInitialState") return rootMethods.getInitialState;
-      }
 
       // Symbol.observable for RxJS interop
       if (prop === Symbol.observable || prop === "@@observable") {
@@ -1404,28 +1381,8 @@ export function state<T extends object>(initialState: T, options?: StateOptions)
     ? createDebugLog({ enabled: true, storeName: options.name })
     : undefined;
   
-  // Deep clone and freeze the initial state for later reset
-  const frozenInitialState = deepFreeze(structuredClone(initialState));
-  
   const node = createObjectNode(initialState);
-  
-  // Create reset functions to pass to wrapWithProxy
-  const rootMethods = {
-    reset: () => {
-      debugLog?.('root', 'reset', node.get(), frozenInitialState);
-      // Batch the reset so only one emission occurs
-      node.lock();
-      try {
-        // Deep clone so we don't pass frozen objects to set()
-        node.set(structuredClone(frozenInitialState) as T);
-      } finally {
-        node.unlock();
-      }
-    },
-    getInitialState: () => frozenInitialState as DeepReadonly<T>,
-  };
-  
-  return wrapWithProxy(node as NodeCore<T>, '', debugLog, rootMethods) as unknown as RxState<T>;
+  return wrapWithProxy(node as NodeCore<T>, '', debugLog) as RxState<T>;
 }
 
 // Symbol to mark a value as nullable

package/src/helpers.ts

@@ -8,15 +8,26 @@
 import { Observable, combineLatest } from "rxjs";
 import { distinctUntilChanged, map } from "rxjs/operators";
 
-// Deep equality check (duplicated to keep helpers independent)
-function deepEqual(a: unknown, b: unknown): boolean {
+// Deep equality check with circular reference protection
+function deepEqual(a: unknown, b: unknown, seen = new WeakMap<object, WeakSet<object>>()): boolean {
   if (a === b) return true;
   if (a === null || b === null) return false;
   if (typeof a !== "object" || typeof b !== "object") return false;
 
+  // Circular reference protection: if we've already compared these two objects, return true
+  // (they're equal as far as we've seen, and going deeper would be infinite)
+  const seenWithA = seen.get(a as object);
+  if (seenWithA?.has(b as object)) return true;
+  
+  // Track this comparison
+  if (!seen.has(a as object)) {
+    seen.set(a as object, new WeakSet());
+  }
+  seen.get(a as object)!.add(b as object);
+
   if (Array.isArray(a) && Array.isArray(b)) {
     if (a.length !== b.length) return false;
-    return a.every((item, i) => deepEqual(item, b[i]));
+    return a.every((item, i) => deepEqual(item, b[i], seen));
   }
 
   if (Array.isArray(a) !== Array.isArray(b)) return false;
@@ -26,7 +37,7 @@ function deepEqual(a: unknown, b: unknown): boolean {
   if (keysA.length !== keysB.length) return false;
 
   return keysA.every((key) =>
-    deepEqual((a as Record<string, unknown>)[key], (b as Record<string, unknown>)[key])
+    deepEqual((a as Record<string, unknown>)[key], (b as Record<string, unknown>)[key], seen)
   );
 }
 
@@ -126,7 +137,7 @@ export function select(
  * @returns An Observable that emits an array of selected values
  */
 export function selectFromEach<T, U>(
-  arrayNode: Observable<ReadonlyArray<T>>,
+  arrayNode: Observable<T[]>,
   selector: (item: T, index: number) => U
 ): Observable<U[]> {
   return arrayNode.pipe(