fractostate 3.0.0 → 3.1.2

package/README.md

@@ -1,12 +1,12 @@
-# FractoState: Think Fractal. Code Simple.
+# FractoState | Decentralized State Management for React
 
 <p align="center">
   <img src="https://dll.nehonix.com/assets/FractoState/logo.png" alt="FractoState Logo" width="600" />
 </p>
 
-FractoState is a high-performance, decentralized state management library for React. It is engineered to provide surgical state updates with zero boilerplate, absolute type safety, and an architecture that exists independently of the React component tree.
+FractoState is a high-performance, decentralized state management engine for React applications. It provides surgical state updates through an atomic proxy architecture, ensuring absolute type safety and zero boilerplate.
 
-## See it in Action
+## Technical Demonstration
 
 <p align="center">
   <video
@@ -18,59 +18,55 @@ FractoState is a high-performance, decentralized state management library for Re
   ></video>
 </p>
 
-> ⚠️ **GitHub Limitation**  
-> Autoplay is disabled on GitHub. Click the link below to view the demo video.
+> [!NOTE]
+> Autoplay is disabled on GitHub. Please click below to view the demonstration video.
 
 <p align="center">
   <a href="https://dll.nehonix.com/assets/FractoState/fracto_demo.mp4">
-    ▶️ <strong>Watch the FractoState Demo (MP4)</strong>
+    <strong>View FractoState Demonstration (MP4)</strong>
   </a>
 </p>
 
-## The Problem
+## Architectural Objectives
 
-Traditional state management solutions often suffer from specific architectural bottlenecks:
+Traditional state management patterns often encounter significant performance and maintainability limitations:
 
-1.  **Prop-Drilling & Context Overhead**: Managing shared state requires wrapping the application in multiple providers, often leading to unnecessary re-renders of the entire sub-tree when a small value changes.
-2.  **Boilerplate Complexity**: Redux and similar libraries introduce a heavy cognitive load with actions, reducers, and selectors for even the simplest state transitions.
-3.  **Performance Degit**: JavaScript's standard object handling for deep state often forces developers into expensive deep-cloning patterns for every modification.
-4.  **Uncontrolled Access**: Application state is often dangerously exposed in the global scope, leading to accidental mutations and difficult-to-trace bugs.
+1.  **Context Overhead**: Dependency on high-level providers often results in unnecessary re-renders across the component tree.
+2.  **Boilerplate Rigidity**: Redux-like architectures introduce significant cognitive overhead for routine state transitions.
+3.  **Memory Latency**: Standard immutable patterns in JavaScript frequently require expensive deep-cloning operations.
+4.  **Namespace Pollution**: Global state exposure increases the risk of side effects and non-deterministic mutations.
 
-## The Solution
+## Core Engineered Solutions
 
-FractoState transforms state management into a "Side-Car" service through three core innovations:
+FractoState redefines state management via three architectural pillars:
 
-- **Isolated Memory Vault**: State is held within a private closure rather than the global scope. This strict isolation prevents accidental external mutations and ensures all state changes occur through the defined React hooks.
-- **Surgical Proxy Mutations**: Instead of manually handling immutability, FractoState uses recursive Proxies. You interact with state as if it were a direct object, while the engine performs atomic, immuable updates under the hood.
-- **Provider-less Decoupling**: Components subscribe directly to the Vault. This eliminates the need for context providers and ensures that state updates only trigger re-renders in the exact components that consume the modified data.
+- **Isolated Memory Vault**: State is encapsulated within private closures, preventing unauthorized external mutations and ensuring data integrity.
+- **Atomic Proxy Engine**: Utilizes recursive Proxies to provide a direct mutation API while maintaining strict immutability and surgical update resolution under the hood.
+- **Direct Subscription Model**: Components subscribe directly to specific Vault keys, bypassing the React Context tree to ensure minimal O(1) render targeting.
 
 ## Installation
 
 ```bash
-# xfpm
+# xfpm (recommended)
 xfpm install fractostate
 
-# npm
+# standard package managers
 npm install fractostate
-
-# yarn
 yarn add fractostate
-
-# pnpm
 pnpm add fractostate
 ```
 
-## Quick Example
+## Quick Implementation
 
-Setting up a shared ecommerce cart state:
+Example of a decentralized cart state:
 
 ```tsx
 import { defineFlow, useFlow } from "fractostate";
 
-// 1. Define the business logic flow
+// ◈ Define the flow definition
 const CartFlow = defineFlow("cart", { items: [], total: 0 });
 
-// 2. Consume and modify in any component
+// ◈ Interaction in any component
 function AddToCartButton({ product }) {
   const [, { ops }] = useFlow(CartFlow);
 
@@ -79,78 +75,67 @@ function AddToCartButton({ product }) {
   );
 }
 
-// 3. React to updates elsewhere
+// ◈ Focused reactivity
 function CartIcon() {
   const [cart] = useFlow(CartFlow);
-  return <span>{cart.items.length} items</span>;
+  return <span>{cart.items.length} units</span>;
 }
 ```
 
-## 🚀 What's New in v2
+## Engineering Highlights (v3.1)
 
-FractoState v2 introduces powerful architectural primitives to handle complex state requirements with zero boilerplate.
+FractoState v3 introduces advanced primitives designed for enterprise-scale requirements.
 
-### [Computed Flows](./docs/computed-flows.md)
+### Computed Flows
 
-Create reactive, read-only state derived from other flows. No selectors, no `useMemo`.
+Reactive, read-only state nodes derived from source flows.
 
-```typescript
-const TotalPrice = defineDerived(CartFlow, (state) =>
-  state.items.reduce((acc, item) => acc + item.price, 0),
-);
-```
+- [Documentation: Computed Flows](./docs/computed-flows.md)
 
-### [Native Async Actions](./docs/native-async-actions.md)
+### Native Async Actions
 
-Handle business logic and side effects directly within your flow definitions. Built-in access to surgical state operations.
+Encapsulated business logic with direct access to surgical operation proxies.
 
-```typescript
-actions: {
-  login: (creds) => async (ops) => {
-    ops.self.loading._set(true);
-    await api.login(creds);
-    ops.self.loading._set(false);
-  };
-}
-```
+- [Documentation: Async Actions](./docs/native-async-actions.md)
 
-### [Modular Plugin System](./docs/plugins-and-devtools.md)
+### Extensible Plugin Interface
 
-Opt-in capabilities for persistence, logging, and more.
+Unified API for state persistence, telemetry, and debugging.
 
-```typescript
-plugins: [persist(), logger()];
-```
+- [Documentation: Plugins](./docs/plugins-and-devtools.md)
 
-### [Ghost Inspector](./docs/plugins-and-devtools.md#ghost-inspector-devtools)
+### Surgical DevTools
 
-A zero-config visual overlay to debug your flows in real-time.
+Real-time state inspector with zero-configuration overhead.
 
-```tsx
-<FractoDevTools />
-```
+- [Documentation: DevTools](./docs/plugins-and-devtools.md#ghost-inspector-devtools)
 
-### [Advanced State Control](./docs/advanced-features.md)
+## Performance Benchmarks
 
-FractoState v2.1 introduces surgical methods and raw access patterns:
+FractoState is engineered for high-throughput environments. Current benchmarks demonstrate performance parity with minimalist libraries while significantly outperforming traditional Redux patterns.
 
-- **Underscore Convention**: All built-ins are now prefixed (e.g., `_set`, `_merge`, `_push`) to prevent collisions with your data.
-- **Force vs Patch**: Use `_set` to force history recording, or `_patch` for optimized smart-updates.
-- **Direct Access**: Use `ops.state` for raw immutable reads and `._val` to unwrap proxies.
+| Scenario                   | Objective        | FractoState   | Industry Standard          |
+| :------------------------- | :--------------- | :------------ | :------------------------- |
+| **Big Data (1M nodes)**    | Mutation Latency | **2.1s**      | 3.1s (Redux Toolkit)       |
+| **Deep Update (1k nodes)** | Throughput       | **887 ops/s** | 430 ops/s (Standard React) |
+| **Store Initialization**   | Setup Latency    | **2.2ms**     | 6.5ms (Redux Toolkit)      |
 
-## Documentation
+### Scalability Analysis
 
-- [Getting Started](./docs/getting-started.md)
-- [API Reference](./docs/api-reference.md)
-- [Architecture](./docs/architecture.md)
-- [Computed Flows](./docs/computed-flows.md)
-- [Native Async Actions](./docs/native-async-actions.md)
-- [Plugins & DevTools](./docs/plugins-and-devtools.md)
-- [Advanced Features (v2.1)](./docs/advanced-features.md)
-- [Surgical Updates: \_set vs \_patch](./docs/set-vs-patch.md)
+While libraries like Zustand require manual immutable spreading for deep updates, FractoState achieves similar throughput with a declarative API: `ops.registry[id].child._set(data)`. This eliminates developer error in complex state transitions without sacrificing performance.
 
-## Installation
+Detailed technical analysis available in: [Performance Specifications](./docs/benchmarks.md).
+
+## Documentation Reference
+
+- [◈ Getting Started](./docs/getting-started.md)
+- [◈ Computed Flows](./docs/computed-flows.md)
+- [◈ Native Async Actions](./docs/native-async-actions.md)
+- [◈ Plugin Architecture](./docs/plugins-and-devtools.md)
+- [◈ Advanced State Control](./docs/advanced-features.md)
+- [◈ Surgical Update Logic](./docs/set-vs-patch.md)
+- [◈ Benchmark Analysis](./docs/benchmarks.md)
 
 ---
 
-FractoState - Engineered for Performance. Created for Developers.
+FractoState | Engineered for Precision. Optimized for Performance.

package/dist/cjs/src/proxy.js

@@ -12,91 +12,55 @@ function createDeepProxy(key, path, currentVal, options) {
             if (typeof prop === "symbol")
                 return undefined;
             const newPath = [...path, prop];
+            /**
+             * CORE COMMITTER
+             * Always resolves the freshest state from the store before applying the path update.
+             * This prevents "stale state" issues during mass sequential updates.
+             */
+            const commit = (val, forceful, skipEquality = false) => {
+                try {
+                    const currentState = store.store.get(key, undefined);
+                    const newState = setInPath(currentState, path, val);
+                    store.store.set(key, newState, {
+                        ...options,
+                        force: forceful,
+                        skipEquality,
+                    });
+                }
+                catch (error) {
+                    console.error(`[FlowProxy] Commit error at path ${path.join(".")}:`, error);
+                    throw error;
+                }
+            };
             // --- Meta-Operations ---
             // Read current value
             if (prop === "_val")
                 return currentVal;
             // Generic property replacement (Forceful)
-            if (prop === "_set") {
-                return (val) => {
-                    try {
-                        const currentState = store.store.get(key, undefined);
-                        const newState = setInPath(currentState, path, val);
-                        store.store.set(key, newState, { ...options, force: true });
-                    }
-                    catch (error) {
-                        console.error(`[FlowProxy] Error setting value at path ${path.join(".")}:`, error);
-                        throw error;
-                    }
-                };
-            }
+            if (prop === "_set")
+                return (val) => commit(val, true);
             // Smart property replacement (Skip if equal)
-            if (prop === "_patch") {
-                return (val) => {
-                    try {
-                        const currentState = store.store.get(key, undefined);
-                        const newState = setInPath(currentState, path, val);
-                        store.store.set(key, newState, { ...options, force: false });
-                    }
-                    catch (error) {
-                        console.error(`[FlowProxy] Error patching value at path ${path.join(".")}:`, error);
-                        throw error;
-                    }
-                };
-            }
+            if (prop === "_patch")
+                return (val) => commit(val, false);
+            // Helper for type-specific operators
+            const update = (val) => commit(val, false, true);
             // --- Type-Specific Atomic Operations ---
             // Number Operations
             if (typeof currentVal === "number") {
                 if (prop === "_increment")
-                    return (amount = 1) => {
-                        if (typeof amount !== "number" || !isFinite(amount)) {
-                            console.warn(`[FlowProxy] Invalid increment amount: ${amount}`);
-                            return;
-                        }
-                        update(currentVal + amount);
-                    };
+                    return (amount = 1) => update(currentVal + amount);
                 if (prop === "_decrement")
-                    return (amount = 1) => {
-                        if (typeof amount !== "number" || !isFinite(amount)) {
-                            console.warn(`[FlowProxy] Invalid decrement amount: ${amount}`);
-                            return;
-                        }
-                        update(currentVal - amount);
-                    };
+                    return (amount = 1) => update(currentVal - amount);
                 if (prop === "_add")
-                    return (amount) => {
-                        if (typeof amount !== "number" || !isFinite(amount)) {
-                            console.warn(`[FlowProxy] Invalid add amount: ${amount}`);
-                            return;
-                        }
-                        update(currentVal + amount);
-                    };
+                    return (amount) => update(currentVal + amount);
                 if (prop === "_subtract")
-                    return (amount) => {
-                        if (typeof amount !== "number" || !isFinite(amount)) {
-                            console.warn(`[FlowProxy] Invalid subtract amount: ${amount}`);
-                            return;
-                        }
-                        update(currentVal - amount);
-                    };
+                    return (amount) => update(currentVal - amount);
                 if (prop === "_multiply")
-                    return (amount) => {
-                        if (typeof amount !== "number" || !isFinite(amount)) {
-                            console.warn(`[FlowProxy] Invalid multiply amount: ${amount}`);
-                            return;
-                        }
-                        update(currentVal * amount);
-                    };
+                    return (amount) => update(currentVal * amount);
                 if (prop === "_divide")
                     return (amount) => {
-                        if (typeof amount !== "number" || !isFinite(amount)) {
-                            console.warn(`[FlowProxy] Invalid divide amount: ${amount}`);
-                            return;
-                        }
-                        if (amount === 0) {
-                            console.error(`[FlowProxy] Cannot divide by zero`);
-                            return;
-                        }
+                        if (amount === 0)
+                            throw new Error("[FlowProxy] Division by zero");
                         update(currentVal / amount);
                     };
             }
@@ -105,85 +69,19 @@ function createDeepProxy(key, path, currentVal, options) {
                 if (prop === "_push")
                     return (item) => update([...currentVal, item]);
                 if (prop === "_pop")
-                    return () => {
-                        if (currentVal.length === 0) {
-                            console.warn(`[FlowProxy] Cannot pop from empty array`);
-                            return;
-                        }
-                        update(currentVal.slice(0, -1));
-                    };
+                    return () => update(currentVal.slice(0, -1));
                 if (prop === "_shift")
-                    return () => {
-                        if (currentVal.length === 0) {
-                            console.warn(`[FlowProxy] Cannot shift from empty array`);
-                            return;
-                        }
-                        update(currentVal.slice(1));
-                    };
+                    return () => update(currentVal.slice(1));
                 if (prop === "_unshift")
                     return (item) => update([item, ...currentVal]);
                 if (prop === "_filter")
-                    return (fn) => {
-                        if (typeof fn !== "function") {
-                            console.error(`[FlowProxy] Filter requires a function`);
-                            return;
-                        }
-                        try {
-                            update(currentVal.filter(fn));
-                        }
-                        catch (error) {
-                            console.error(`[FlowProxy] Filter function threw error:`, error);
-                        }
-                    };
+                    return (fn) => update(currentVal.filter(fn));
                 if (prop === "_map")
-                    return (fn) => {
-                        if (typeof fn !== "function") {
-                            console.error(`[FlowProxy] Map requires a function`);
-                            return;
-                        }
-                        try {
-                            update(currentVal.map(fn));
-                        }
-                        catch (error) {
-                            console.error(`[FlowProxy] Map function threw error:`, error);
-                        }
-                    };
-                if (prop === "_splice")
-                    return (...args) => {
-                        try {
-                            const next = [...currentVal];
-                            const start = args[0] ?? 0;
-                            const deleteCount = args[1] ?? 0;
-                            if (typeof start !== "number" ||
-                                typeof deleteCount !== "number") {
-                                console.error(`[FlowProxy] Splice requires numeric arguments`);
-                                return;
-                            }
-                            next.splice(start, deleteCount, ...args.slice(2));
-                            update(next);
-                        }
-                        catch (error) {
-                            console.error(`[FlowProxy] Splice error:`, error);
-                        }
-                    };
+                    return (fn) => update(currentVal.map(fn));
                 if (prop === "_removeAt")
-                    return (index) => {
-                        if (typeof index !== "number" ||
-                            index < 0 ||
-                            index >= currentVal.length) {
-                            console.warn(`[FlowProxy] Invalid index: ${index}`);
-                            return;
-                        }
-                        update(currentVal.filter((_, i) => i !== index));
-                    };
+                    return (index) => update(currentVal.filter((_, i) => i !== index));
                 if (prop === "_insertAt")
                     return (index, item) => {
-                        if (typeof index !== "number" ||
-                            index < 0 ||
-                            index > currentVal.length) {
-                            console.warn(`[FlowProxy] Invalid index: ${index}`);
-                            return;
-                        }
                         const next = [...currentVal];
                         next.splice(index, 0, item);
                         update(next);
@@ -192,84 +90,33 @@ function createDeepProxy(key, path, currentVal, options) {
             // String Operations
             if (typeof currentVal === "string") {
                 if (prop === "_append")
-                    return (str) => {
-                        if (typeof str !== "string") {
-                            console.warn(`[FlowProxy] Append requires a string`);
-                            return;
-                        }
-                        update(currentVal + str);
-                    };
+                    return (str) => update(currentVal + str);
                 if (prop === "_prepend")
-                    return (str) => {
-                        if (typeof str !== "string") {
-                            console.warn(`[FlowProxy] Prepend requires a string`);
-                            return;
-                        }
-                        update(str + currentVal);
-                    };
+                    return (str) => update(str + currentVal);
                 if (prop === "_uppercase")
                     return () => update(currentVal.toUpperCase());
                 if (prop === "_lowercase")
                     return () => update(currentVal.toLowerCase());
                 if (prop === "_trim")
                     return () => update(currentVal.trim());
-                if (prop === "_replace")
-                    return (search, replace) => {
-                        if (typeof replace !== "string") {
-                            console.warn(`[FlowProxy] Replace requires a string replacement`);
-                            return;
-                        }
-                        try {
-                            update(currentVal.replace(search, replace));
-                        }
-                        catch (error) {
-                            console.error(`[FlowProxy] Replace error:`, error);
-                        }
-                    };
             }
             // Object Operations
             if (currentVal !== null &&
                 typeof currentVal === "object" &&
                 !Array.isArray(currentVal)) {
                 if (prop === "_merge")
-                    return (obj) => {
-                        if (typeof obj !== "object" || obj === null || Array.isArray(obj)) {
-                            console.warn(`[FlowProxy] Merge requires an object`);
-                            return;
-                        }
-                        update({ ...currentVal, ...obj });
-                    };
+                    return (obj) => update({ ...currentVal, ...obj });
                 if (prop === "_delete")
                     return (keyToDel) => {
-                        if (typeof keyToDel !== "string") {
-                            console.warn(`[FlowProxy] Delete requires a string key`);
-                            return;
-                        }
-                        if (!(keyToDel in currentVal)) {
-                            console.warn(`[FlowProxy] Key "${keyToDel}" does not exist`);
-                            return;
-                        }
                         const next = { ...currentVal };
                         delete next[keyToDel];
                         update(next);
                     };
             }
-            /**
-             * Internal helper to commit a value update to the store.
-             */
-            function update(val) {
-                try {
-                    const currentState = store.store.get(key, undefined);
-                    const newState = setInPath(currentState, path, val);
-                    store.store.set(key, newState, options);
-                }
-                catch (error) {
-                    console.error(`[FlowProxy] Error updating value at path ${path.join(".")}:`, error);
-                    throw error;
-                }
-            }
             // Recursive step: create a new proxy for the child property
-            const nextVal = currentVal ? currentVal[prop] : undefined;
+            const nextVal = currentVal !== null && currentVal !== undefined
+                ? currentVal[prop]
+                : undefined;
             return createDeepProxy(key, newPath, nextVal, options);
         },
         apply(_target, _thisArg, args) {
@@ -289,17 +136,14 @@ function setInPath(obj, path, value) {
     const [head, ...tail] = path;
     if (Array.isArray(obj)) {
         const index = parseInt(head, 10);
-        if (isNaN(index) || index < 0) {
+        if (isNaN(index) || index < 0)
             throw new Error(`[FlowProxy] Invalid array index: ${head}`);
-        }
         const newArr = [...obj];
-        if (index >= newArr.length) {
+        if (index >= newArr.length)
             newArr.length = index + 1;
-        }
         newArr[index] = setInPath(newArr[index], tail, value);
         return newArr;
     }
-    // Handle nested objects (including null/undefined recovery)
     const currentObj = obj ?? {};
     return {
         ...currentObj,

package/dist/cjs/src/proxy.js.map

@@ -1 +1 @@
-{"version":3,"file":"proxy.js","sources":["../../../src/proxy.ts"],"sourcesContent":["import type { FlowOptions, TypeAwareOps } from \"./types\";\nimport { store } from \"./store\";\n\n/**\n * Creates a deep proxy that provides type-specific atomic operations for a flow.\n * The proxy tracks its path within the state tree and maps access to specific update logic.\n */\nexport function createDeepProxy<T = any>(\n  key: string,\n  path: string[],\n  currentVal: any,\n  options: FlowOptions<any>,\n): TypeAwareOps<T> {\n  return new Proxy(() => {}, {\n    get(_target: any, prop: any) {\n      if (typeof prop === \"symbol\") return undefined;\n\n      const newPath = [...path, prop];\n\n      // --- Meta-Operations ---\n\n      // Read current value\n      if (prop === \"_val\") return currentVal;\n\n      // Generic property replacement (Forceful)\n      if (prop === \"_set\") {\n        return (val: any) => {\n          try {\n            const currentState = store.get(key, undefined);\n            const newState = setInPath(currentState, path, val);\n            store.set(key, newState, { ...options, force: true });\n          } catch (error) {\n            console.error(\n              `[FlowProxy] Error setting value at path ${path.join(\".\")}:`,\n              error,\n            );\n            throw error;\n          }\n        };\n      }\n\n      // Smart property replacement (Skip if equal)\n      if (prop === \"_patch\") {\n        return (val: any) => {\n          try {\n            const currentState = store.get(key, undefined);\n            const newState = setInPath(currentState, path, val);\n            store.set(key, newState, { ...options, force: false });\n          } catch (error) {\n            console.error(\n              `[FlowProxy] Error patching value at path ${path.join(\".\")}:`,\n              error,\n            );\n            throw error;\n          }\n        };\n      }\n\n      // --- Type-Specific Atomic Operations ---\n\n      // Number Operations\n      if (typeof currentVal === \"number\") {\n        if (prop === \"_increment\")\n          return (amount = 1) => {\n            if (typeof amount !== \"number\" || !isFinite(amount)) {\n              console.warn(`[FlowProxy] Invalid increment amount: ${amount}`);\n              return;\n            }\n            update(currentVal + amount);\n          };\n        if (prop === \"_decrement\")\n          return (amount = 1) => {\n            if (typeof amount !== \"number\" || !isFinite(amount)) {\n              console.warn(`[FlowProxy] Invalid decrement amount: ${amount}`);\n              return;\n            }\n            update(currentVal - amount);\n          };\n        if (prop === \"_add\")\n          return (amount: number) => {\n            if (typeof amount !== \"number\" || !isFinite(amount)) {\n              console.warn(`[FlowProxy] Invalid add amount: ${amount}`);\n              return;\n            }\n            update(currentVal + amount);\n          };\n        if (prop === \"_subtract\")\n          return (amount: number) => {\n            if (typeof amount !== \"number\" || !isFinite(amount)) {\n              console.warn(`[FlowProxy] Invalid subtract amount: ${amount}`);\n              return;\n            }\n            update(currentVal - amount);\n          };\n        if (prop === \"_multiply\")\n          return (amount: number) => {\n            if (typeof amount !== \"number\" || !isFinite(amount)) {\n              console.warn(`[FlowProxy] Invalid multiply amount: ${amount}`);\n              return;\n            }\n            update(currentVal * amount);\n          };\n        if (prop === \"_divide\")\n          return (amount: number) => {\n            if (typeof amount !== \"number\" || !isFinite(amount)) {\n              console.warn(`[FlowProxy] Invalid divide amount: ${amount}`);\n              return;\n            }\n            if (amount === 0) {\n              console.error(`[FlowProxy] Cannot divide by zero`);\n              return;\n            }\n            update(currentVal / amount);\n          };\n      }\n\n      // Array Operations\n      if (Array.isArray(currentVal)) {\n        if (prop === \"_push\")\n          return (item: any) => update([...currentVal, item]);\n        if (prop === \"_pop\")\n          return () => {\n            if (currentVal.length === 0) {\n              console.warn(`[FlowProxy] Cannot pop from empty array`);\n              return;\n            }\n            update(currentVal.slice(0, -1));\n          };\n        if (prop === \"_shift\")\n          return () => {\n            if (currentVal.length === 0) {\n              console.warn(`[FlowProxy] Cannot shift from empty array`);\n              return;\n            }\n            update(currentVal.slice(1));\n          };\n        if (prop === \"_unshift\")\n          return (item: any) => update([item, ...currentVal]);\n        if (prop === \"_filter\")\n          return (fn: any) => {\n            if (typeof fn !== \"function\") {\n              console.error(`[FlowProxy] Filter requires a function`);\n              return;\n            }\n            try {\n              update(currentVal.filter(fn));\n            } catch (error) {\n              console.error(`[FlowProxy] Filter function threw error:`, error);\n            }\n          };\n        if (prop === \"_map\")\n          return (fn: any) => {\n            if (typeof fn !== \"function\") {\n              console.error(`[FlowProxy] Map requires a function`);\n              return;\n            }\n            try {\n              update(currentVal.map(fn));\n            } catch (error) {\n              console.error(`[FlowProxy] Map function threw error:`, error);\n            }\n          };\n        if (prop === \"_splice\")\n          return (...args: any[]) => {\n            try {\n              const next = [...currentVal];\n              const start = args[0] ?? 0;\n              const deleteCount = args[1] ?? 0;\n\n              if (\n                typeof start !== \"number\" ||\n                typeof deleteCount !== \"number\"\n              ) {\n                console.error(`[FlowProxy] Splice requires numeric arguments`);\n                return;\n              }\n\n              next.splice(start, deleteCount, ...args.slice(2));\n              update(next);\n            } catch (error) {\n              console.error(`[FlowProxy] Splice error:`, error);\n            }\n          };\n        if (prop === \"_removeAt\")\n          return (index: number) => {\n            if (\n              typeof index !== \"number\" ||\n              index < 0 ||\n              index >= currentVal.length\n            ) {\n              console.warn(`[FlowProxy] Invalid index: ${index}`);\n              return;\n            }\n            update(currentVal.filter((_, i) => i !== index));\n          };\n        if (prop === \"_insertAt\")\n          return (index: number, item: any) => {\n            if (\n              typeof index !== \"number\" ||\n              index < 0 ||\n              index > currentVal.length\n            ) {\n              console.warn(`[FlowProxy] Invalid index: ${index}`);\n              return;\n            }\n            const next = [...currentVal];\n            next.splice(index, 0, item);\n            update(next);\n          };\n      }\n\n      // String Operations\n      if (typeof currentVal === \"string\") {\n        if (prop === \"_append\")\n          return (str: string) => {\n            if (typeof str !== \"string\") {\n              console.warn(`[FlowProxy] Append requires a string`);\n              return;\n            }\n            update(currentVal + str);\n          };\n        if (prop === \"_prepend\")\n          return (str: string) => {\n            if (typeof str !== \"string\") {\n              console.warn(`[FlowProxy] Prepend requires a string`);\n              return;\n            }\n            update(str + currentVal);\n          };\n        if (prop === \"_uppercase\")\n          return () => update(currentVal.toUpperCase());\n        if (prop === \"_lowercase\")\n          return () => update(currentVal.toLowerCase());\n        if (prop === \"_trim\") return () => update(currentVal.trim());\n        if (prop === \"_replace\")\n          return (search: string | RegExp, replace: string) => {\n            if (typeof replace !== \"string\") {\n              console.warn(`[FlowProxy] Replace requires a string replacement`);\n              return;\n            }\n            try {\n              update(currentVal.replace(search, replace));\n            } catch (error) {\n              console.error(`[FlowProxy] Replace error:`, error);\n            }\n          };\n      }\n\n      // Object Operations\n      if (\n        currentVal !== null &&\n        typeof currentVal === \"object\" &&\n        !Array.isArray(currentVal)\n      ) {\n        if (prop === \"_merge\")\n          return (obj: any) => {\n            if (typeof obj !== \"object\" || obj === null || Array.isArray(obj)) {\n              console.warn(`[FlowProxy] Merge requires an object`);\n              return;\n            }\n            update({ ...currentVal, ...obj });\n          };\n        if (prop === \"_delete\")\n          return (keyToDel: string) => {\n            if (typeof keyToDel !== \"string\") {\n              console.warn(`[FlowProxy] Delete requires a string key`);\n              return;\n            }\n            if (!(keyToDel in currentVal)) {\n              console.warn(`[FlowProxy] Key \"${keyToDel}\" does not exist`);\n              return;\n            }\n            const next = { ...currentVal };\n            delete next[keyToDel];\n            update(next);\n          };\n      }\n\n      /**\n       * Internal helper to commit a value update to the store.\n       */\n      function update(val: any) {\n        try {\n          const currentState = store.get(key, undefined);\n          const newState = setInPath(currentState, path, val);\n          store.set(key, newState, options);\n        } catch (error) {\n          console.error(\n            `[FlowProxy] Error updating value at path ${path.join(\".\")}:`,\n            error,\n          );\n          throw error;\n        }\n      }\n\n      // Recursive step: create a new proxy for the child property\n      const nextVal = currentVal ? currentVal[prop] : undefined;\n      return createDeepProxy(key, newPath, nextVal, options);\n    },\n    apply(_target, _thisArg, args) {\n      if (typeof currentVal === \"function\") {\n        return currentVal(...args);\n      }\n      console.warn(\n        `[FlowProxy] Attempted to call a non-function value at path: ${path.join(\".\")}`,\n      );\n    },\n  }) as unknown as TypeAwareOps<T>;\n}\n\n/**\n * Immutable update utility that sets a value at a specific path within an object/array.\n */\nexport function setInPath(obj: any, path: string[], value: any): any {\n  if (path.length === 0) return value;\n\n  const [head, ...tail] = path;\n\n  if (Array.isArray(obj)) {\n    const index = parseInt(head, 10);\n\n    if (isNaN(index) || index < 0) {\n      throw new Error(`[FlowProxy] Invalid array index: ${head}`);\n    }\n\n    const newArr = [...obj];\n\n    if (index >= newArr.length) {\n      newArr.length = index + 1;\n    }\n\n    newArr[index] = setInPath(newArr[index], tail, value);\n    return newArr;\n  }\n\n  // Handle nested objects (including null/undefined recovery)\n  const currentObj = obj ?? {};\n\n  return {\n    ...currentObj,\n    [head]: setInPath(currentObj[head], tail, value),\n  };\n}\n"],"names":["store"],"mappings":"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"}
+{"version":3,"file":"proxy.js","sources":["../../../src/proxy.ts"],"sourcesContent":["import type { FlowOptions, TypeAwareOps } from \"./types\";\nimport { store } from \"./store\";\n\n/**\n * Creates a deep proxy that provides type-specific atomic operations for a flow.\n * The proxy tracks its path within the state tree and maps access to specific update logic.\n */\nexport function createDeepProxy<T = any>(\n  key: string,\n  path: string[],\n  currentVal: any,\n  options: FlowOptions<any>,\n): TypeAwareOps<T> {\n  return new Proxy(() => {}, {\n    get(_target: any, prop: any) {\n      if (typeof prop === \"symbol\") return undefined;\n\n      const newPath = [...path, prop];\n\n      /**\n       * CORE COMMITTER\n       * Always resolves the freshest state from the store before applying the path update.\n       * This prevents \"stale state\" issues during mass sequential updates.\n       */\n      const commit = (val: any, forceful: boolean, skipEquality = false) => {\n        try {\n          const currentState = store.get(key, undefined);\n          const newState = setInPath(currentState, path, val);\n          store.set(key, newState, {\n            ...options,\n            force: forceful,\n            skipEquality,\n          });\n        } catch (error) {\n          console.error(\n            `[FlowProxy] Commit error at path ${path.join(\".\")}:`,\n            error,\n          );\n          throw error;\n        }\n      };\n\n      // --- Meta-Operations ---\n\n      // Read current value\n      if (prop === \"_val\") return currentVal;\n\n      // Generic property replacement (Forceful)\n      if (prop === \"_set\") return (val: any) => commit(val, true);\n\n      // Smart property replacement (Skip if equal)\n      if (prop === \"_patch\") return (val: any) => commit(val, false);\n\n      // Helper for type-specific operators\n      const update = (val: any) => commit(val, false, true);\n\n      // --- Type-Specific Atomic Operations ---\n\n      // Number Operations\n      if (typeof currentVal === \"number\") {\n        if (prop === \"_increment\")\n          return (amount = 1) => update(currentVal + amount);\n        if (prop === \"_decrement\")\n          return (amount = 1) => update(currentVal - amount);\n        if (prop === \"_add\")\n          return (amount: number) => update(currentVal + amount);\n        if (prop === \"_subtract\")\n          return (amount: number) => update(currentVal - amount);\n        if (prop === \"_multiply\")\n          return (amount: number) => update(currentVal * amount);\n        if (prop === \"_divide\")\n          return (amount: number) => {\n            if (amount === 0) throw new Error(\"[FlowProxy] Division by zero\");\n            update(currentVal / amount);\n          };\n      }\n\n      // Array Operations\n      if (Array.isArray(currentVal)) {\n        if (prop === \"_push\")\n          return (item: any) => update([...currentVal, item]);\n        if (prop === \"_pop\") return () => update(currentVal.slice(0, -1));\n        if (prop === \"_shift\") return () => update(currentVal.slice(1));\n        if (prop === \"_unshift\")\n          return (item: any) => update([item, ...currentVal]);\n        if (prop === \"_filter\")\n          return (fn: any) => update(currentVal.filter(fn));\n        if (prop === \"_map\") return (fn: any) => update(currentVal.map(fn));\n        if (prop === \"_removeAt\")\n          return (index: number) =>\n            update(currentVal.filter((_, i) => i !== index));\n        if (prop === \"_insertAt\")\n          return (index: number, item: any) => {\n            const next = [...currentVal];\n            next.splice(index, 0, item);\n            update(next);\n          };\n      }\n\n      // String Operations\n      if (typeof currentVal === \"string\") {\n        if (prop === \"_append\")\n          return (str: string) => update(currentVal + str);\n        if (prop === \"_prepend\")\n          return (str: string) => update(str + currentVal);\n        if (prop === \"_uppercase\")\n          return () => update(currentVal.toUpperCase());\n        if (prop === \"_lowercase\")\n          return () => update(currentVal.toLowerCase());\n        if (prop === \"_trim\") return () => update(currentVal.trim());\n      }\n\n      // Object Operations\n      if (\n        currentVal !== null &&\n        typeof currentVal === \"object\" &&\n        !Array.isArray(currentVal)\n      ) {\n        if (prop === \"_merge\")\n          return (obj: any) => update({ ...currentVal, ...obj });\n        if (prop === \"_delete\")\n          return (keyToDel: string) => {\n            const next = { ...currentVal };\n            delete next[keyToDel];\n            update(next);\n          };\n      }\n\n      // Recursive step: create a new proxy for the child property\n      const nextVal =\n        currentVal !== null && currentVal !== undefined\n          ? currentVal[prop]\n          : undefined;\n      return createDeepProxy(key, newPath, nextVal, options);\n    },\n    apply(_target, _thisArg, args) {\n      if (typeof currentVal === \"function\") {\n        return currentVal(...args);\n      }\n      console.warn(\n        `[FlowProxy] Attempted to call a non-function value at path: ${path.join(\".\")}`,\n      );\n    },\n  }) as unknown as TypeAwareOps<T>;\n}\n\n/**\n * Immutable update utility that sets a value at a specific path within an object/array.\n */\nexport function setInPath(obj: any, path: string[], value: any): any {\n  if (path.length === 0) return value;\n\n  const [head, ...tail] = path;\n\n  if (Array.isArray(obj)) {\n    const index = parseInt(head, 10);\n    if (isNaN(index) || index < 0)\n      throw new Error(`[FlowProxy] Invalid array index: ${head}`);\n    const newArr = [...obj];\n    if (index >= newArr.length) newArr.length = index + 1;\n    newArr[index] = setInPath(newArr[index], tail, value);\n    return newArr;\n  }\n\n  const currentObj = obj ?? {};\n  return {\n    ...currentObj,\n    [head]: setInPath(currentObj[head], tail, value),\n  };\n}\n"],"names":["store"],"mappings":"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"}

package/dist/cjs/src/store.js

@@ -144,15 +144,17 @@ class MemoryVault {
      */
     set(key, newValue, options = {}) {
         const prevState = this.vault.get(key);
-        let stateToSet = deepClone(newValue);
+        let stateToSet = newValue;
         // Apply synchronous middleware
         if (options.middleware) {
             for (const fn of options.middleware) {
                 stateToSet = fn(stateToSet);
             }
         }
-        // Skip update if state has not changed (Deep equality check) unless 'force' is true
-        if (!options.force && deepEqual(prevState, stateToSet))
+        // Skip update if state has not changed (Deep equality check) unless 'force' or 'skipEquality' is true
+        if (!options.force &&
+            !options.skipEquality &&
+            deepEqual(prevState, stateToSet))
             return;
         if (options.debounce) {
             this.debouncedSet(key, stateToSet, options);