fractostate 1.0.0 → 1.0.2

package/dist/cjs/index.js

@@ -0,0 +1,2 @@
+// CommonJS re-export from src directory
+module.exports = require('./src/index.js');

package/dist/cjs/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "commonjs"
+}

package/dist/cjs/src/index.js

@@ -0,0 +1,66 @@
+'use strict';
+
+var react = require('react');
+var store = require('./store.js');
+var proxy = require('./proxy.js');
+
+/**
+ * Defines a flow in a centralized manner.
+ * Allows defining the key, initial state, and options in a single reusable object.
+ */
+function defineFlow(key, initial, options) {
+    return { key, initial, options };
+}
+/**
+ * Unique "All-in-One" hook to create or consume a FractoState flow.
+ * - If called with a FlowDefinition or an initial value: initializes the flow if it doesn't exist.
+ * - If called with just a key: connects to the existing flow.
+ *
+ * Returns a 2-element array: [state, toolbox]
+ * where toolbox contains { ops, set, undo, redo, history, ... }
+ */
+function useFlow(keyOrDef, maybeInitialValue, options = {}) {
+    // Argument analysis to unify initialization and consumption
+    const isDef = typeof keyOrDef !== "string";
+    const key = isDef ? keyOrDef.key : keyOrDef;
+    // Initial data comes either from the definition or the direct argument
+    const initialValue = isDef ? keyOrDef.initial : maybeInitialValue;
+    // Merge options
+    const opt = isDef ? { ...keyOrDef.options, ...options } : options;
+    // Store access: store.get handles initialization if initialValue is present
+    const [state, setState] = react.useState(() => store.store.get(key, initialValue));
+    react.useEffect(() => {
+        // Subscribe to store changes
+        const unsub = store.store.subscribe(key, () => {
+            setState(store.store.get(key, initialValue));
+        });
+        return unsub;
+    }, [key, initialValue]);
+    const setManual = react.useCallback((val) => {
+        const current = store.store.get(key, initialValue);
+        const next = typeof val === "function" ? val(current) : val;
+        store.store.set(key, next, opt);
+    }, [key, initialValue, opt]);
+    const toolbox = react.useMemo(() => {
+        return {
+            ops: {
+                get self() {
+                    return proxy.createDeepProxy(key, [], store.store.get(key, initialValue), opt);
+                },
+            },
+            set: setManual,
+            undo: () => store.store.undo(key),
+            redo: () => store.store.redo(key),
+            history: store.store.getHistory(key),
+            canUndo: store.store.getHistory(key).length > 1,
+            canRedo: store.store.getRedoStack(key).length > 0,
+            reset: () => store.store.reset(key),
+            cf: opt,
+        };
+    }, [key, opt, state, initialValue, setManual]);
+    return [state, toolbox];
+}
+
+exports.defineFlow = defineFlow;
+exports.useFlow = useFlow;
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../../../src/index.ts"],"sourcesContent":["import { useState, useEffect, useCallback, useMemo } from \"react\";\nimport type { FlowOptions, FlowOperations, FlowDefinition } from \"./types\";\nimport { store } from \"./store\";\nimport { createDeepProxy } from \"./proxy\";\n\nexport * from \"./types\";\n\n/**\n * Defines a flow in a centralized manner.\n * Allows defining the key, initial state, and options in a single reusable object.\n */\nexport function defineFlow<T>(\n  key: string,\n  initial: T,\n  options?: FlowOptions<T>,\n): FlowDefinition<T> {\n  return { key, initial, options };\n}\n\n/**\n * Unique \"All-in-One\" hook to create or consume a FractoState flow.\n * - If called with a FlowDefinition or an initial value: initializes the flow if it doesn't exist.\n * - If called with just a key: connects to the existing flow.\n *\n * Returns a 2-element array: [state, toolbox]\n * where toolbox contains { ops, set, undo, redo, history, ... }\n */\nexport function useFlow<T>(\n  keyOrDef: string | FlowDefinition<T>,\n  maybeInitialValue?: T,\n  options: FlowOptions<T> = {},\n): [T, FlowOperations<T>] {\n  // Argument analysis to unify initialization and consumption\n  const isDef = typeof keyOrDef !== \"string\";\n  const key = isDef ? keyOrDef.key : keyOrDef;\n\n  // Initial data comes either from the definition or the direct argument\n  const initialValue = isDef ? keyOrDef.initial : maybeInitialValue;\n\n  // Merge options\n  const opt = isDef ? { ...keyOrDef.options, ...options } : options;\n\n  // Store access: store.get handles initialization if initialValue is present\n  const [state, setState] = useState(() => store.get(key, initialValue));\n\n  useEffect(() => {\n    // Subscribe to store changes\n    const unsub = store.subscribe(key, () => {\n      setState(store.get(key, initialValue));\n    });\n    return unsub;\n  }, [key, initialValue]);\n\n  const setManual = useCallback(\n    (val: T | ((prev: T) => T)) => {\n      const current = store.get(key, initialValue);\n      const next = typeof val === \"function\" ? (val as any)(current) : val;\n      store.set(key, next, opt);\n    },\n    [key, initialValue, opt],\n  );\n\n  const toolbox = useMemo((): FlowOperations<T> => {\n    return {\n      ops: {\n        get self() {\n          return createDeepProxy<T>(key, [], store.get(key, initialValue), opt);\n        },\n      },\n      set: setManual,\n      undo: () => store.undo(key),\n      redo: () => store.redo(key),\n      history: store.getHistory(key),\n      canUndo: store.getHistory(key).length > 1,\n      canRedo: store.getRedoStack(key).length > 0,\n      reset: () => store.reset(key),\n      cf: opt,\n    };\n  }, [key, opt, state, initialValue, setManual]);\n\n  return [state, toolbox];\n}\n"],"names":["useState","store","useEffect","useCallback","useMemo","createDeepProxy"],"mappings":";;;;;;AAOA;;;AAGG;SACa,UAAU,CACxB,GAAW,EACX,OAAU,EACV,OAAwB,EAAA;AAExB,IAAA,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE;AAClC;AAEA;;;;;;;AAOG;AACG,SAAU,OAAO,CACrB,QAAoC,EACpC,iBAAqB,EACrB,UAA0B,EAAE,EAAA;;AAG5B,IAAA,MAAM,KAAK,GAAG,OAAO,QAAQ,KAAK,QAAQ;AAC1C,IAAA,MAAM,GAAG,GAAG,KAAK,GAAG,QAAQ,CAAC,GAAG,GAAG,QAAQ;;AAG3C,IAAA,MAAM,YAAY,GAAG,KAAK,GAAG,QAAQ,CAAC,OAAO,GAAG,iBAAiB;;AAGjE,IAAA,MAAM,GAAG,GAAG,KAAK,GAAG,EAAE,GAAG,QAAQ,CAAC,OAAO,EAAE,GAAG,OAAO,EAAE,GAAG,OAAO;;IAGjE,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAGA,cAAQ,CAAC,MAAMC,WAAK,CAAC,GAAG,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;IAEtEC,eAAS,CAAC,MAAK;;QAEb,MAAM,KAAK,GAAGD,WAAK,CAAC,SAAS,CAAC,GAAG,EAAE,MAAK;YACtC,QAAQ,CAACA,WAAK,CAAC,GAAG,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;AACxC,QAAA,CAAC,CAAC;AACF,QAAA,OAAO,KAAK;AACd,IAAA,CAAC,EAAE,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;AAEvB,IAAA,MAAM,SAAS,GAAGE,iBAAW,CAC3B,CAAC,GAAyB,KAAI;QAC5B,MAAM,OAAO,GAAGF,WAAK,CAAC,GAAG,CAAC,GAAG,EAAE,YAAY,CAAC;AAC5C,QAAA,MAAM,IAAI,GAAG,OAAO,GAAG,KAAK,UAAU,GAAI,GAAW,CAAC,OAAO,CAAC,GAAG,GAAG;QACpEA,WAAK,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,CAAC;IAC3B,CAAC,EACD,CAAC,GAAG,EAAE,YAAY,EAAE,GAAG,CAAC,CACzB;AAED,IAAA,MAAM,OAAO,GAAGG,aAAO,CAAC,MAAwB;QAC9C,OAAO;AACL,YAAA,GAAG,EAAE;AACH,gBAAA,IAAI,IAAI,GAAA;AACN,oBAAA,OAAOC,qBAAe,CAAI,GAAG,EAAE,EAAE,EAAEJ,WAAK,CAAC,GAAG,CAAC,GAAG,EAAE,YAAY,CAAC,EAAE,GAAG,CAAC;gBACvE,CAAC;AACF,aAAA;AACD,YAAA,GAAG,EAAE,SAAS;YACd,IAAI,EAAE,MAAMA,WAAK,CAAC,IAAI,CAAC,GAAG,CAAC;YAC3B,IAAI,EAAE,MAAMA,WAAK,CAAC,IAAI,CAAC,GAAG,CAAC;AAC3B,YAAA,OAAO,EAAEA,WAAK,CAAC,UAAU,CAAC,GAAG,CAAC;YAC9B,OAAO,EAAEA,WAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC;YACzC,OAAO,EAAEA,WAAK,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC;YAC3C,KAAK,EAAE,MAAMA,WAAK,CAAC,KAAK,CAAC,GAAG,CAAC;AAC7B,YAAA,EAAE,EAAE,GAAG;SACR;AACH,IAAA,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,YAAY,EAAE,SAAS,CAAC,CAAC;AAE9C,IAAA,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC;AACzB;;;;;"}

package/dist/cjs/src/proxy.js

@@ -0,0 +1,289 @@
+'use strict';
+
+var store = require('./store.js');
+
+/**
+ * Creates a deep proxy that provides type-specific atomic operations for a flow.
+ * The proxy tracks its path within the state tree and maps access to specific update logic.
+ */
+function createDeepProxy(key, path, currentVal, options) {
+    return new Proxy(() => { }, {
+        get(_target, prop) {
+            if (typeof prop === "symbol")
+                return undefined;
+            const newPath = [...path, prop];
+            // --- Meta-Operations ---
+            // Generic property replacement
+            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);
+                    }
+                    catch (error) {
+                        console.error(`[FlowProxy] Error setting value at path ${path.join(".")}:`, error);
+                        throw error;
+                    }
+                };
+            }
+            // --- 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);
+                    };
+                if (prop === "decrement")
+                    return (amount = 1) => {
+                        if (typeof amount !== "number" || !isFinite(amount)) {
+                            console.warn(`[FlowProxy] Invalid decrement amount: ${amount}`);
+                            return;
+                        }
+                        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);
+                    };
+                if (prop === "subtract")
+                    return (amount) => {
+                        if (typeof amount !== "number" || !isFinite(amount)) {
+                            console.warn(`[FlowProxy] Invalid subtract amount: ${amount}`);
+                            return;
+                        }
+                        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);
+                    };
+                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;
+                        }
+                        update(currentVal / amount);
+                    };
+            }
+            // Array Operations
+            if (Array.isArray(currentVal)) {
+                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));
+                    };
+                if (prop === "shift")
+                    return () => {
+                        if (currentVal.length === 0) {
+                            console.warn(`[FlowProxy] Cannot shift from empty array`);
+                            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);
+                        }
+                    };
+                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);
+                        }
+                    };
+                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));
+                    };
+                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);
+                    };
+            }
+            // 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);
+                    };
+                if (prop === "prepend")
+                    return (str) => {
+                        if (typeof str !== "string") {
+                            console.warn(`[FlowProxy] Prepend requires a string`);
+                            return;
+                        }
+                        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 });
+                    };
+                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;
+            return createDeepProxy(key, newPath, nextVal, options);
+        },
+    });
+}
+/**
+ * Immutable update utility that sets a value at a specific path within an object/array.
+ */
+function setInPath(obj, path, value) {
+    if (path.length === 0)
+        return value;
+    const [head, ...tail] = path;
+    if (Array.isArray(obj)) {
+        const index = parseInt(head, 10);
+        if (isNaN(index) || index < 0) {
+            throw new Error(`[FlowProxy] Invalid array index: ${head}`);
+        }
+        const newArr = [...obj];
+        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,
+        [head]: setInPath(currentObj[head], tail, value),
+    };
+}
+
+exports.createDeepProxy = createDeepProxy;
+exports.setInPath = setInPath;
+//# sourceMappingURL=proxy.js.map

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

@@ -0,0 +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      // Generic property replacement\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);\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      // --- 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\") return () => update(currentVal.toUpperCase());\n        if (prop === \"lowercase\") 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  }) 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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"}