fractostate 4.8.0 → 4.8.1

package/dist/cjs/index.js

@@ -63,7 +63,7 @@ function defineFlow(key, initial, options) {
  */
 function getFlow(def) {
     const { key, initial, options: flowOptions } = def;
-    const state = store.store.get(key, initial, flowOptions);
+    store.store.get(key, initial, flowOptions);
     const boundActions = {};
     const defaultOps = {
         get self() {
@@ -132,7 +132,8 @@ function getFlow(def) {
         cf: flowOptions || {},
         isHydrating: !!store.store.__hydrating__?.has(key),
     };
-    return [state, toolbox];
+    const latestState = store.store.get(key, initial);
+    return [latestState, toolbox];
 }
 function useFlow(keyOrDef, initial, options) {
     const isDerived = typeof keyOrDef === "object" && "selector" in keyOrDef;
@@ -152,7 +153,7 @@ function useFlow(keyOrDef, initial, options) {
         : isDerived
             ? keyOrDef.source.options
             : options;
-    const [state, setState] = React.useState(() => {
+    const [snapshot, setSnapshot] = React.useState(() => {
         const raw = store.store.get(key, initialVal, flowOptions);
         return isDerived ? keyOrDef.selector(raw) : raw;
     });
@@ -160,7 +161,7 @@ function useFlow(keyOrDef, initial, options) {
         const label = flowOptions?.name || flowOptions?.actor || `useFlow(${key})`;
         return store.store.subscribe(key, () => {
             const raw = store.store.get(key, initialVal);
-            setState(isDerived ? keyOrDef.selector(raw) : raw);
+            setSnapshot(isDerived ? keyOrDef.selector(raw) : raw);
         }, { label });
     }, [key, isDerived, flowOptions?.name, flowOptions?.actor]);
     const toolbox = React.useMemo(() => {
@@ -234,7 +235,10 @@ function useFlow(keyOrDef, initial, options) {
             cf: flowOptions || {},
             isHydrating: !!store.store.__hydrating__?.has(key),
         };
-    }, [key, isDerived, state, flowOptions]);
+    }, [key, isDerived, snapshot, flowOptions]);
+    const state = isDerived
+        ? keyOrDef.selector(store.store.get(key, initialVal))
+        : store.store.get(key, initialVal);
     return [state, toolbox];
 }
 

package/dist/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../src/index.ts"],"sourcesContent":["/* *****************************************************************************\n * FractoSate\n *\n * ACCESS RESTRICTIONS:\n * - This software is exclusively for use by Authorized Personnel of NEHONIX\n * - Intended for Internal Use only within NEHONIX operations\n * - No rights granted to unauthorized individuals or entities\n * - All modifications are works made for hire assigned to NEHONIX\n *\n * PROHIBITED ACTIVITIES:\n * - Copying, distributing, or sublicensing without written permission\n * - Reverse engineering, decompiling, or disassembling\n * - Creating derivative works without explicit authorization\n * - External use or commercial distribution outside NEHONIX\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n *\n * For questions or permissions, contact:\n * NEHONIX Legal Department\n * Email: legal@nehonix.com\n * Website: www.nehonix.com\n ***************************************************************************** */\n\nimport { useState, useEffect, useMemo } from \"react\";\nimport type {\n  FlowOperations,\n  FlowDefinition,\n  DerivedFlowDefinition,\n  FlowOptions,\n  UseFlowOptions,\n  FlowOpsObject,\n  ActionOpsObject,\n  ContextGetterOps,\n} from \"./types\";\nimport { store } from \"./store\";\nimport { createDeepProxy } from \"./proxy\";\n\n// Connect proxy creator to store for internal effects\nstore.setProxyCreator(createDeepProxy);\n\nexport * from \"./types\";\n\n/**\n * Manually initializes a flow to ensure its effects run immediately.\n * This is useful for flows that need to start working before any component subscribes to them.\n */\nexport function initFlow<T, A, C>(flow: FlowDefinition<T, A, C>) {\n  store.get(flow.key, flow.initial, flow.options);\n}\n\n/**\n * Defines a derived flow that reacts to changes in a source flow.\n * Use this for computed values that shouldn't be manually modified.\n */\nexport function defineDerived<T, R>(\n  source: FlowDefinition<T, any>,\n  selector: (state: T) => R,\n  derivedKey?: string,\n): DerivedFlowDefinition<T, R> {\n  const key = derivedKey || `${source.key}_derived_${Date.now()}`;\n  store.setParent(key, source.key);\n  return {\n    key,\n    source,\n    selector,\n  };\n}\n\nexport function defineFlow<\n  T,\n  A extends Record<string, any>,\n  C = A extends { __ctx__: (ops: ContextGetterOps<T, any>) => infer R }\n    ? R\n    : undefined,\n>(\n  key: string,\n  initial: T,\n  options: FlowOptions<NoInfer<T>, any> & {\n    actions: {\n      __ctx__?: (c: ContextGetterOps<T, Record<string, any>>) => C;\n    } & {\n      [K in keyof A as K extends \"__ctx__\" ? never : K]: (\n        ...args: any[]\n      ) => (ops: ActionOpsObject<T, Record<string, any>, C>) => any;\n    } & A;\n  },\n): FlowDefinition<T, A, C>;\nexport function defineFlow<T>(\n  key: string,\n  initial: T,\n  options?: FlowOptions<NoInfer<T>, {}>,\n): FlowDefinition<T, {}>;\nexport function defineFlow<T, A, C = undefined>(\n  key: string,\n  initial: T,\n  options?: FlowOptions<T, A> & { actions?: A },\n): FlowDefinition<T, A, C> {\n  return { key, initial, options: options as any };\n}\n\n/**\n * Non-hook version of useFlow.\n * Useful for accessing and interacting with flows outside React components (e.g., axios interceptors).\n */\nexport function getFlow<T, A, C>(\n  def: FlowDefinition<T, A, C>,\n): [T, FlowOperations<T, A>] {\n  const { key, initial, options: flowOptions } = def;\n  const state = store.get(key, initial, flowOptions);\n\n  const boundActions = {} as any;\n  const defaultOps: FlowOpsObject<T, A> = {\n    get self() {\n      return createDeepProxy<T, A>(key, [], store.get(key, initial), {\n        ...flowOptions,\n        actions: boundActions,\n        actor: flowOptions?.actor,\n      });\n    },\n    get state() {\n      return store.get(key, initial);\n    },\n  };\n\n  const actions = (def as any)?.options?.actions || flowOptions?.actions;\n\n  const actionOps: ActionOpsObject<T, A, any> = {\n    get self() {\n      return defaultOps.self;\n    },\n    get state() {\n      return defaultOps.state;\n    },\n    get ctx() {\n      const ctxGen = (actions as any)?.__ctx__;\n      if (!ctxGen) return undefined;\n      return ctxGen({\n        state: store.get(key, initial),\n        initialState: store.getInitial(key) ?? initial,\n        actions: boundActions,\n        ops: defaultOps,\n      });\n    },\n  };\n\n  if (actions) {\n    for (const [name, fn] of Object.entries(actions)) {\n      if (name === \"__ctx__\") continue;\n      boundActions[name] = (...args: any[]) =>\n        (fn as Function)(...args)(actionOps);\n    }\n  }\n\n  const toolbox: FlowOperations<T, A> = {\n    ops: defaultOps,\n    actions: boundActions,\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    _set: (val: any) => {\n      const next = typeof val === \"function\" ? val(store.get(key)) : val;\n      store.set(key, next, {\n        ...flowOptions,\n        force: true,\n        actor: flowOptions?.actor,\n      });\n    },\n    _patch: (val: any) => {\n      const next = typeof val === \"function\" ? val(store.get(key)) : val;\n      store.set(key, next, {\n        ...flowOptions,\n        force: false,\n        actor: flowOptions?.actor,\n      });\n    },\n    _reset: () => store.reset(key),\n    cf: flowOptions || {},\n    isHydrating: !!store.__hydrating__?.has(key),\n  };\n\n  return [state, toolbox];\n}\n\n/**\n * Main hook to consume and interact with a FractoState flow.\n * Returns a tuple containing the current [State, Toolbox].\n */\nexport function useFlow<K extends string, T = any>(\n  key: K,\n  initial?: T,\n  options?: UseFlowOptions<T>,\n): [T, FlowOperations<T, {}>];\n\nexport function useFlow<T, A, C>(\n  def: FlowDefinition<T, A, C>,\n  options?: UseFlowOptions<T>,\n): [T, FlowOperations<T, A>];\n\nexport function useFlow<T, R>(def: DerivedFlowDefinition<T, R>): [R, {}];\n\nexport function useFlow(\n  keyOrDef: any,\n  initial?: any,\n  options?: any,\n): [any, any] {\n  const isDerived = typeof keyOrDef === \"object\" && \"selector\" in keyOrDef;\n  const isDef = typeof keyOrDef === \"object\" && \"key\" in keyOrDef && !isDerived;\n\n  const key = isDef\n    ? (keyOrDef as any).key\n    : isDerived\n      ? (keyOrDef as any).source.key\n      : (keyOrDef as string);\n  const initialVal = isDef\n    ? (keyOrDef as any).initial\n    : isDerived\n      ? (keyOrDef as any).source.initial\n      : initial;\n  const flowOptions = isDef\n    ? { ...((keyOrDef as any).options || {}), ...(initial || {}) }\n    : isDerived\n      ? (keyOrDef as any).source.options\n      : options;\n\n  const [state, setState] = useState(() => {\n    const raw = store.get(key, initialVal, flowOptions);\n    return isDerived ? (keyOrDef as any).selector(raw) : raw;\n  });\n\n  useEffect(() => {\n    const label = flowOptions?.name || flowOptions?.actor || `useFlow(${key})`;\n    return store.subscribe(\n      key,\n      () => {\n        const raw = store.get(key, initialVal);\n        setState(isDerived ? (keyOrDef as any).selector(raw) : raw);\n      },\n      { label },\n    );\n  }, [key, isDerived, flowOptions?.name, flowOptions?.actor]);\n\n  const toolbox = useMemo(() => {\n    if (isDerived) return {};\n\n    const boundActions = {} as any;\n    const defaultOps: FlowOpsObject<any, any> = {\n      get self() {\n        return createDeepProxy<any, any>(key, [], store.get(key, initialVal), {\n          ...flowOptions,\n          actions: boundActions,\n          actor: flowOptions?.name || flowOptions?.actor,\n        });\n      },\n      get state() {\n        return store.get(key, initialVal);\n      },\n    };\n\n    const actions = (keyOrDef as any)?.options?.actions || flowOptions?.actions;\n\n    const actionOps: ActionOpsObject<any, any, any> = {\n      get self() {\n        return defaultOps.self;\n      },\n      get state() {\n        return defaultOps.state;\n      },\n      get ctx() {\n        const ctxGen = (actions as any)?.__ctx__;\n        if (!ctxGen) return undefined;\n        return ctxGen({\n          state: store.get(key, initialVal),\n          initialState: store.getInitial(key) ?? initialVal,\n          actions: boundActions,\n          ops: defaultOps,\n        });\n      },\n    };\n\n    if (actions) {\n      for (const [name, fn] of Object.entries(actions)) {\n        if (name === \"__ctx__\") continue;\n        boundActions[name] = (...args: any[]) =>\n          (fn as Function)(...args)(actionOps);\n      }\n    }\n\n    return {\n      ops: defaultOps,\n      actions: boundActions,\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      _set: (val: any) => {\n        const next = typeof val === \"function\" ? val(store.get(key)) : val;\n        store.set(key, next, {\n          ...flowOptions,\n          force: true,\n          actor: flowOptions?.name || flowOptions?.actor,\n        });\n      },\n      _patch: (val: any) => {\n        const next = typeof val === \"function\" ? val(store.get(key)) : val;\n        store.set(key, next, {\n          ...flowOptions,\n          force: false,\n          actor: flowOptions?.name || flowOptions?.actor,\n        });\n      },\n      _reset: () => store.reset(key),\n      cf: flowOptions || {},\n      isHydrating: !!store.__hydrating__?.has(key),\n    };\n  }, [key, isDerived, state, flowOptions]);\n\n  return [state, toolbox] as any;\n}\n"],"names":["store","createDeepProxy","useState","useEffect","useMemo"],"mappings":"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"}
+{"version":3,"file":"index.js","sources":["../../src/index.ts"],"sourcesContent":["/* *****************************************************************************\n * FractoSate\n *\n * ACCESS RESTRICTIONS:\n * - This software is exclusively for use by Authorized Personnel of NEHONIX\n * - Intended for Internal Use only within NEHONIX operations\n * - No rights granted to unauthorized individuals or entities\n * - All modifications are works made for hire assigned to NEHONIX\n *\n * PROHIBITED ACTIVITIES:\n * - Copying, distributing, or sublicensing without written permission\n * - Reverse engineering, decompiling, or disassembling\n * - Creating derivative works without explicit authorization\n * - External use or commercial distribution outside NEHONIX\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n *\n * For questions or permissions, contact:\n * NEHONIX Legal Department\n * Email: legal@nehonix.com\n * Website: www.nehonix.com\n ***************************************************************************** */\n\nimport { useState, useEffect, useMemo } from \"react\";\nimport type {\n  FlowOperations,\n  FlowDefinition,\n  DerivedFlowDefinition,\n  FlowOptions,\n  UseFlowOptions,\n  FlowOpsObject,\n  ActionOpsObject,\n  ContextGetterOps,\n} from \"./types\";\nimport { store } from \"./store\";\nimport { createDeepProxy } from \"./proxy\";\n\n// Connect proxy creator to store for internal effects\nstore.setProxyCreator(createDeepProxy);\n\nexport * from \"./types\";\n\n/**\n * Manually initializes a flow to ensure its effects run immediately.\n * This is useful for flows that need to start working before any component subscribes to them.\n */\nexport function initFlow<T, A, C>(flow: FlowDefinition<T, A, C>) {\n  store.get(flow.key, flow.initial, flow.options);\n}\n\n/**\n * Defines a derived flow that reacts to changes in a source flow.\n * Use this for computed values that shouldn't be manually modified.\n */\nexport function defineDerived<T, R>(\n  source: FlowDefinition<T, any>,\n  selector: (state: T) => R,\n  derivedKey?: string,\n): DerivedFlowDefinition<T, R> {\n  const key = derivedKey || `${source.key}_derived_${Date.now()}`;\n  store.setParent(key, source.key);\n  return {\n    key,\n    source,\n    selector,\n  };\n}\n\nexport function defineFlow<\n  T,\n  A extends Record<string, any>,\n  C = A extends { __ctx__: (ops: ContextGetterOps<T, any>) => infer R }\n    ? R\n    : undefined,\n>(\n  key: string,\n  initial: T,\n  options: FlowOptions<NoInfer<T>, any> & {\n    actions: {\n      __ctx__?: (c: ContextGetterOps<T, Record<string, any>>) => C;\n    } & {\n      [K in keyof A as K extends \"__ctx__\" ? never : K]: (\n        ...args: any[]\n      ) => (ops: ActionOpsObject<T, Record<string, any>, C>) => any;\n    } & A;\n  },\n): FlowDefinition<T, A, C>;\nexport function defineFlow<T>(\n  key: string,\n  initial: T,\n  options?: FlowOptions<NoInfer<T>, {}>,\n): FlowDefinition<T, {}>;\nexport function defineFlow<T, A, C = undefined>(\n  key: string,\n  initial: T,\n  options?: FlowOptions<T, A> & { actions?: A },\n): FlowDefinition<T, A, C> {\n  return { key, initial, options: options as any };\n}\n\n/**\n * Non-hook version of useFlow.\n * Useful for accessing and interacting with flows outside React components (e.g., axios interceptors).\n */\nexport function getFlow<T, A, C>(\n  def: FlowDefinition<T, A, C>,\n): [T, FlowOperations<T, A>] {\n  const { key, initial, options: flowOptions } = def;\n  store.get(key, initial, flowOptions);\n\n  const boundActions = {} as any;\n  const defaultOps: FlowOpsObject<T, A> = {\n    get self() {\n      return createDeepProxy<T, A>(key, [], store.get(key, initial), {\n        ...flowOptions,\n        actions: boundActions,\n        actor: flowOptions?.actor,\n      });\n    },\n    get state() {\n      return store.get(key, initial);\n    },\n  };\n\n  const actions = (def as any)?.options?.actions || flowOptions?.actions;\n\n  const actionOps: ActionOpsObject<T, A, any> = {\n    get self() {\n      return defaultOps.self;\n    },\n    get state() {\n      return defaultOps.state;\n    },\n    get ctx() {\n      const ctxGen = (actions as any)?.__ctx__;\n      if (!ctxGen) return undefined;\n      return ctxGen({\n        state: store.get(key, initial),\n        initialState: store.getInitial(key) ?? initial,\n        actions: boundActions,\n        ops: defaultOps,\n      });\n    },\n  };\n\n  if (actions) {\n    for (const [name, fn] of Object.entries(actions)) {\n      if (name === \"__ctx__\") continue;\n      boundActions[name] = (...args: any[]) =>\n        (fn as Function)(...args)(actionOps);\n    }\n  }\n\n  const toolbox: FlowOperations<T, A> = {\n    ops: defaultOps,\n    actions: boundActions,\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    _set: (val: any) => {\n      const next = typeof val === \"function\" ? val(store.get(key)) : val;\n      store.set(key, next, {\n        ...flowOptions,\n        force: true,\n        actor: flowOptions?.actor,\n      });\n    },\n    _patch: (val: any) => {\n      const next = typeof val === \"function\" ? val(store.get(key)) : val;\n      store.set(key, next, {\n        ...flowOptions,\n        force: false,\n        actor: flowOptions?.actor,\n      });\n    },\n    _reset: () => store.reset(key),\n    cf: flowOptions || {},\n    isHydrating: !!store.__hydrating__?.has(key),\n  };\n\n  const latestState = store.get(key, initial);\n  return [latestState, toolbox];\n}\n\n/**\n * Main hook to consume and interact with a FractoState flow.\n * Returns a tuple containing the current [State, Toolbox].\n */\nexport function useFlow<K extends string, T = any>(\n  key: K,\n  initial?: T,\n  options?: UseFlowOptions<T>,\n): [T, FlowOperations<T, {}>];\n\nexport function useFlow<T, A, C>(\n  def: FlowDefinition<T, A, C>,\n  options?: UseFlowOptions<T>,\n): [T, FlowOperations<T, A>];\n\nexport function useFlow<T, R>(def: DerivedFlowDefinition<T, R>): [R, {}];\n\nexport function useFlow(\n  keyOrDef: any,\n  initial?: any,\n  options?: any,\n): [any, any] {\n  const isDerived = typeof keyOrDef === \"object\" && \"selector\" in keyOrDef;\n  const isDef = typeof keyOrDef === \"object\" && \"key\" in keyOrDef && !isDerived;\n\n  const key = isDef\n    ? (keyOrDef as any).key\n    : isDerived\n      ? (keyOrDef as any).source.key\n      : (keyOrDef as string);\n  const initialVal = isDef\n    ? (keyOrDef as any).initial\n    : isDerived\n      ? (keyOrDef as any).source.initial\n      : initial;\n  const flowOptions = isDef\n    ? { ...((keyOrDef as any).options || {}), ...(initial || {}) }\n    : isDerived\n      ? (keyOrDef as any).source.options\n      : options;\n\n  const [snapshot, setSnapshot] = useState(() => {\n    const raw = store.get(key, initialVal, flowOptions);\n    return isDerived ? (keyOrDef as any).selector(raw) : raw;\n  });\n\n  useEffect(() => {\n    const label = flowOptions?.name || flowOptions?.actor || `useFlow(${key})`;\n    return store.subscribe(\n      key,\n      () => {\n        const raw = store.get(key, initialVal);\n        setSnapshot(isDerived ? (keyOrDef as any).selector(raw) : raw);\n      },\n      { label },\n    );\n  }, [key, isDerived, flowOptions?.name, flowOptions?.actor]);\n\n  const toolbox = useMemo(() => {\n    if (isDerived) return {};\n\n    const boundActions = {} as any;\n    const defaultOps: FlowOpsObject<any, any> = {\n      get self() {\n        return createDeepProxy<any, any>(key, [], store.get(key, initialVal), {\n          ...flowOptions,\n          actions: boundActions,\n          actor: flowOptions?.name || flowOptions?.actor,\n        });\n      },\n      get state() {\n        return store.get(key, initialVal);\n      },\n    };\n\n    const actions = (keyOrDef as any)?.options?.actions || flowOptions?.actions;\n\n    const actionOps: ActionOpsObject<any, any, any> = {\n      get self() {\n        return defaultOps.self;\n      },\n      get state() {\n        return defaultOps.state;\n      },\n      get ctx() {\n        const ctxGen = (actions as any)?.__ctx__;\n        if (!ctxGen) return undefined;\n        return ctxGen({\n          state: store.get(key, initialVal),\n          initialState: store.getInitial(key) ?? initialVal,\n          actions: boundActions,\n          ops: defaultOps,\n        });\n      },\n    };\n\n    if (actions) {\n      for (const [name, fn] of Object.entries(actions)) {\n        if (name === \"__ctx__\") continue;\n        boundActions[name] = (...args: any[]) =>\n          (fn as Function)(...args)(actionOps);\n      }\n    }\n\n    return {\n      ops: defaultOps,\n      actions: boundActions,\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      _set: (val: any) => {\n        const next = typeof val === \"function\" ? val(store.get(key)) : val;\n        store.set(key, next, {\n          ...flowOptions,\n          force: true,\n          actor: flowOptions?.name || flowOptions?.actor,\n        });\n      },\n      _patch: (val: any) => {\n        const next = typeof val === \"function\" ? val(store.get(key)) : val;\n        store.set(key, next, {\n          ...flowOptions,\n          force: false,\n          actor: flowOptions?.name || flowOptions?.actor,\n        });\n      },\n      _reset: () => store.reset(key),\n      cf: flowOptions || {},\n      isHydrating: !!store.__hydrating__?.has(key),\n    };\n  }, [key, isDerived, snapshot, flowOptions]);\n\n  const state = isDerived\n    ? (keyOrDef as any).selector(store.get(key, initialVal))\n    : store.get(key, initialVal);\n\n  return [state, toolbox] as any;\n}\n"],"names":["store","createDeepProxy","useState","useEffect","useMemo"],"mappings":"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"}

package/dist/esm/index.js

@@ -61,7 +61,7 @@ function defineFlow(key, initial, options) {
  */
 function getFlow(def) {
     const { key, initial, options: flowOptions } = def;
-    const state = store.get(key, initial, flowOptions);
+    store.get(key, initial, flowOptions);
     const boundActions = {};
     const defaultOps = {
         get self() {
@@ -130,7 +130,8 @@ function getFlow(def) {
         cf: flowOptions || {},
         isHydrating: !!store.__hydrating__?.has(key),
     };
-    return [state, toolbox];
+    const latestState = store.get(key, initial);
+    return [latestState, toolbox];
 }
 function useFlow(keyOrDef, initial, options) {
     const isDerived = typeof keyOrDef === "object" && "selector" in keyOrDef;
@@ -150,7 +151,7 @@ function useFlow(keyOrDef, initial, options) {
         : isDerived
             ? keyOrDef.source.options
             : options;
-    const [state, setState] = useState(() => {
+    const [snapshot, setSnapshot] = useState(() => {
         const raw = store.get(key, initialVal, flowOptions);
         return isDerived ? keyOrDef.selector(raw) : raw;
     });
@@ -158,7 +159,7 @@ function useFlow(keyOrDef, initial, options) {
         const label = flowOptions?.name || flowOptions?.actor || `useFlow(${key})`;
         return store.subscribe(key, () => {
             const raw = store.get(key, initialVal);
-            setState(isDerived ? keyOrDef.selector(raw) : raw);
+            setSnapshot(isDerived ? keyOrDef.selector(raw) : raw);
         }, { label });
     }, [key, isDerived, flowOptions?.name, flowOptions?.actor]);
     const toolbox = useMemo(() => {
@@ -232,7 +233,10 @@ function useFlow(keyOrDef, initial, options) {
             cf: flowOptions || {},
             isHydrating: !!store.__hydrating__?.has(key),
         };
-    }, [key, isDerived, state, flowOptions]);
+    }, [key, isDerived, snapshot, flowOptions]);
+    const state = isDerived
+        ? keyOrDef.selector(store.get(key, initialVal))
+        : store.get(key, initialVal);
     return [state, toolbox];
 }
 

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../src/index.ts"],"sourcesContent":["/* *****************************************************************************\n * FractoSate\n *\n * ACCESS RESTRICTIONS:\n * - This software is exclusively for use by Authorized Personnel of NEHONIX\n * - Intended for Internal Use only within NEHONIX operations\n * - No rights granted to unauthorized individuals or entities\n * - All modifications are works made for hire assigned to NEHONIX\n *\n * PROHIBITED ACTIVITIES:\n * - Copying, distributing, or sublicensing without written permission\n * - Reverse engineering, decompiling, or disassembling\n * - Creating derivative works without explicit authorization\n * - External use or commercial distribution outside NEHONIX\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n *\n * For questions or permissions, contact:\n * NEHONIX Legal Department\n * Email: legal@nehonix.com\n * Website: www.nehonix.com\n ***************************************************************************** */\n\nimport { useState, useEffect, useMemo } from \"react\";\nimport type {\n  FlowOperations,\n  FlowDefinition,\n  DerivedFlowDefinition,\n  FlowOptions,\n  UseFlowOptions,\n  FlowOpsObject,\n  ActionOpsObject,\n  ContextGetterOps,\n} from \"./types\";\nimport { store } from \"./store\";\nimport { createDeepProxy } from \"./proxy\";\n\n// Connect proxy creator to store for internal effects\nstore.setProxyCreator(createDeepProxy);\n\nexport * from \"./types\";\n\n/**\n * Manually initializes a flow to ensure its effects run immediately.\n * This is useful for flows that need to start working before any component subscribes to them.\n */\nexport function initFlow<T, A, C>(flow: FlowDefinition<T, A, C>) {\n  store.get(flow.key, flow.initial, flow.options);\n}\n\n/**\n * Defines a derived flow that reacts to changes in a source flow.\n * Use this for computed values that shouldn't be manually modified.\n */\nexport function defineDerived<T, R>(\n  source: FlowDefinition<T, any>,\n  selector: (state: T) => R,\n  derivedKey?: string,\n): DerivedFlowDefinition<T, R> {\n  const key = derivedKey || `${source.key}_derived_${Date.now()}`;\n  store.setParent(key, source.key);\n  return {\n    key,\n    source,\n    selector,\n  };\n}\n\nexport function defineFlow<\n  T,\n  A extends Record<string, any>,\n  C = A extends { __ctx__: (ops: ContextGetterOps<T, any>) => infer R }\n    ? R\n    : undefined,\n>(\n  key: string,\n  initial: T,\n  options: FlowOptions<NoInfer<T>, any> & {\n    actions: {\n      __ctx__?: (c: ContextGetterOps<T, Record<string, any>>) => C;\n    } & {\n      [K in keyof A as K extends \"__ctx__\" ? never : K]: (\n        ...args: any[]\n      ) => (ops: ActionOpsObject<T, Record<string, any>, C>) => any;\n    } & A;\n  },\n): FlowDefinition<T, A, C>;\nexport function defineFlow<T>(\n  key: string,\n  initial: T,\n  options?: FlowOptions<NoInfer<T>, {}>,\n): FlowDefinition<T, {}>;\nexport function defineFlow<T, A, C = undefined>(\n  key: string,\n  initial: T,\n  options?: FlowOptions<T, A> & { actions?: A },\n): FlowDefinition<T, A, C> {\n  return { key, initial, options: options as any };\n}\n\n/**\n * Non-hook version of useFlow.\n * Useful for accessing and interacting with flows outside React components (e.g., axios interceptors).\n */\nexport function getFlow<T, A, C>(\n  def: FlowDefinition<T, A, C>,\n): [T, FlowOperations<T, A>] {\n  const { key, initial, options: flowOptions } = def;\n  const state = store.get(key, initial, flowOptions);\n\n  const boundActions = {} as any;\n  const defaultOps: FlowOpsObject<T, A> = {\n    get self() {\n      return createDeepProxy<T, A>(key, [], store.get(key, initial), {\n        ...flowOptions,\n        actions: boundActions,\n        actor: flowOptions?.actor,\n      });\n    },\n    get state() {\n      return store.get(key, initial);\n    },\n  };\n\n  const actions = (def as any)?.options?.actions || flowOptions?.actions;\n\n  const actionOps: ActionOpsObject<T, A, any> = {\n    get self() {\n      return defaultOps.self;\n    },\n    get state() {\n      return defaultOps.state;\n    },\n    get ctx() {\n      const ctxGen = (actions as any)?.__ctx__;\n      if (!ctxGen) return undefined;\n      return ctxGen({\n        state: store.get(key, initial),\n        initialState: store.getInitial(key) ?? initial,\n        actions: boundActions,\n        ops: defaultOps,\n      });\n    },\n  };\n\n  if (actions) {\n    for (const [name, fn] of Object.entries(actions)) {\n      if (name === \"__ctx__\") continue;\n      boundActions[name] = (...args: any[]) =>\n        (fn as Function)(...args)(actionOps);\n    }\n  }\n\n  const toolbox: FlowOperations<T, A> = {\n    ops: defaultOps,\n    actions: boundActions,\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    _set: (val: any) => {\n      const next = typeof val === \"function\" ? val(store.get(key)) : val;\n      store.set(key, next, {\n        ...flowOptions,\n        force: true,\n        actor: flowOptions?.actor,\n      });\n    },\n    _patch: (val: any) => {\n      const next = typeof val === \"function\" ? val(store.get(key)) : val;\n      store.set(key, next, {\n        ...flowOptions,\n        force: false,\n        actor: flowOptions?.actor,\n      });\n    },\n    _reset: () => store.reset(key),\n    cf: flowOptions || {},\n    isHydrating: !!store.__hydrating__?.has(key),\n  };\n\n  return [state, toolbox];\n}\n\n/**\n * Main hook to consume and interact with a FractoState flow.\n * Returns a tuple containing the current [State, Toolbox].\n */\nexport function useFlow<K extends string, T = any>(\n  key: K,\n  initial?: T,\n  options?: UseFlowOptions<T>,\n): [T, FlowOperations<T, {}>];\n\nexport function useFlow<T, A, C>(\n  def: FlowDefinition<T, A, C>,\n  options?: UseFlowOptions<T>,\n): [T, FlowOperations<T, A>];\n\nexport function useFlow<T, R>(def: DerivedFlowDefinition<T, R>): [R, {}];\n\nexport function useFlow(\n  keyOrDef: any,\n  initial?: any,\n  options?: any,\n): [any, any] {\n  const isDerived = typeof keyOrDef === \"object\" && \"selector\" in keyOrDef;\n  const isDef = typeof keyOrDef === \"object\" && \"key\" in keyOrDef && !isDerived;\n\n  const key = isDef\n    ? (keyOrDef as any).key\n    : isDerived\n      ? (keyOrDef as any).source.key\n      : (keyOrDef as string);\n  const initialVal = isDef\n    ? (keyOrDef as any).initial\n    : isDerived\n      ? (keyOrDef as any).source.initial\n      : initial;\n  const flowOptions = isDef\n    ? { ...((keyOrDef as any).options || {}), ...(initial || {}) }\n    : isDerived\n      ? (keyOrDef as any).source.options\n      : options;\n\n  const [state, setState] = useState(() => {\n    const raw = store.get(key, initialVal, flowOptions);\n    return isDerived ? (keyOrDef as any).selector(raw) : raw;\n  });\n\n  useEffect(() => {\n    const label = flowOptions?.name || flowOptions?.actor || `useFlow(${key})`;\n    return store.subscribe(\n      key,\n      () => {\n        const raw = store.get(key, initialVal);\n        setState(isDerived ? (keyOrDef as any).selector(raw) : raw);\n      },\n      { label },\n    );\n  }, [key, isDerived, flowOptions?.name, flowOptions?.actor]);\n\n  const toolbox = useMemo(() => {\n    if (isDerived) return {};\n\n    const boundActions = {} as any;\n    const defaultOps: FlowOpsObject<any, any> = {\n      get self() {\n        return createDeepProxy<any, any>(key, [], store.get(key, initialVal), {\n          ...flowOptions,\n          actions: boundActions,\n          actor: flowOptions?.name || flowOptions?.actor,\n        });\n      },\n      get state() {\n        return store.get(key, initialVal);\n      },\n    };\n\n    const actions = (keyOrDef as any)?.options?.actions || flowOptions?.actions;\n\n    const actionOps: ActionOpsObject<any, any, any> = {\n      get self() {\n        return defaultOps.self;\n      },\n      get state() {\n        return defaultOps.state;\n      },\n      get ctx() {\n        const ctxGen = (actions as any)?.__ctx__;\n        if (!ctxGen) return undefined;\n        return ctxGen({\n          state: store.get(key, initialVal),\n          initialState: store.getInitial(key) ?? initialVal,\n          actions: boundActions,\n          ops: defaultOps,\n        });\n      },\n    };\n\n    if (actions) {\n      for (const [name, fn] of Object.entries(actions)) {\n        if (name === \"__ctx__\") continue;\n        boundActions[name] = (...args: any[]) =>\n          (fn as Function)(...args)(actionOps);\n      }\n    }\n\n    return {\n      ops: defaultOps,\n      actions: boundActions,\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      _set: (val: any) => {\n        const next = typeof val === \"function\" ? val(store.get(key)) : val;\n        store.set(key, next, {\n          ...flowOptions,\n          force: true,\n          actor: flowOptions?.name || flowOptions?.actor,\n        });\n      },\n      _patch: (val: any) => {\n        const next = typeof val === \"function\" ? val(store.get(key)) : val;\n        store.set(key, next, {\n          ...flowOptions,\n          force: false,\n          actor: flowOptions?.name || flowOptions?.actor,\n        });\n      },\n      _reset: () => store.reset(key),\n      cf: flowOptions || {},\n      isHydrating: !!store.__hydrating__?.has(key),\n    };\n  }, [key, isDerived, state, flowOptions]);\n\n  return [state, toolbox] as any;\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sources":["../../src/index.ts"],"sourcesContent":["/* *****************************************************************************\n * FractoSate\n *\n * ACCESS RESTRICTIONS:\n * - This software is exclusively for use by Authorized Personnel of NEHONIX\n * - Intended for Internal Use only within NEHONIX operations\n * - No rights granted to unauthorized individuals or entities\n * - All modifications are works made for hire assigned to NEHONIX\n *\n * PROHIBITED ACTIVITIES:\n * - Copying, distributing, or sublicensing without written permission\n * - Reverse engineering, decompiling, or disassembling\n * - Creating derivative works without explicit authorization\n * - External use or commercial distribution outside NEHONIX\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n *\n * For questions or permissions, contact:\n * NEHONIX Legal Department\n * Email: legal@nehonix.com\n * Website: www.nehonix.com\n ***************************************************************************** */\n\nimport { useState, useEffect, useMemo } from \"react\";\nimport type {\n  FlowOperations,\n  FlowDefinition,\n  DerivedFlowDefinition,\n  FlowOptions,\n  UseFlowOptions,\n  FlowOpsObject,\n  ActionOpsObject,\n  ContextGetterOps,\n} from \"./types\";\nimport { store } from \"./store\";\nimport { createDeepProxy } from \"./proxy\";\n\n// Connect proxy creator to store for internal effects\nstore.setProxyCreator(createDeepProxy);\n\nexport * from \"./types\";\n\n/**\n * Manually initializes a flow to ensure its effects run immediately.\n * This is useful for flows that need to start working before any component subscribes to them.\n */\nexport function initFlow<T, A, C>(flow: FlowDefinition<T, A, C>) {\n  store.get(flow.key, flow.initial, flow.options);\n}\n\n/**\n * Defines a derived flow that reacts to changes in a source flow.\n * Use this for computed values that shouldn't be manually modified.\n */\nexport function defineDerived<T, R>(\n  source: FlowDefinition<T, any>,\n  selector: (state: T) => R,\n  derivedKey?: string,\n): DerivedFlowDefinition<T, R> {\n  const key = derivedKey || `${source.key}_derived_${Date.now()}`;\n  store.setParent(key, source.key);\n  return {\n    key,\n    source,\n    selector,\n  };\n}\n\nexport function defineFlow<\n  T,\n  A extends Record<string, any>,\n  C = A extends { __ctx__: (ops: ContextGetterOps<T, any>) => infer R }\n    ? R\n    : undefined,\n>(\n  key: string,\n  initial: T,\n  options: FlowOptions<NoInfer<T>, any> & {\n    actions: {\n      __ctx__?: (c: ContextGetterOps<T, Record<string, any>>) => C;\n    } & {\n      [K in keyof A as K extends \"__ctx__\" ? never : K]: (\n        ...args: any[]\n      ) => (ops: ActionOpsObject<T, Record<string, any>, C>) => any;\n    } & A;\n  },\n): FlowDefinition<T, A, C>;\nexport function defineFlow<T>(\n  key: string,\n  initial: T,\n  options?: FlowOptions<NoInfer<T>, {}>,\n): FlowDefinition<T, {}>;\nexport function defineFlow<T, A, C = undefined>(\n  key: string,\n  initial: T,\n  options?: FlowOptions<T, A> & { actions?: A },\n): FlowDefinition<T, A, C> {\n  return { key, initial, options: options as any };\n}\n\n/**\n * Non-hook version of useFlow.\n * Useful for accessing and interacting with flows outside React components (e.g., axios interceptors).\n */\nexport function getFlow<T, A, C>(\n  def: FlowDefinition<T, A, C>,\n): [T, FlowOperations<T, A>] {\n  const { key, initial, options: flowOptions } = def;\n  store.get(key, initial, flowOptions);\n\n  const boundActions = {} as any;\n  const defaultOps: FlowOpsObject<T, A> = {\n    get self() {\n      return createDeepProxy<T, A>(key, [], store.get(key, initial), {\n        ...flowOptions,\n        actions: boundActions,\n        actor: flowOptions?.actor,\n      });\n    },\n    get state() {\n      return store.get(key, initial);\n    },\n  };\n\n  const actions = (def as any)?.options?.actions || flowOptions?.actions;\n\n  const actionOps: ActionOpsObject<T, A, any> = {\n    get self() {\n      return defaultOps.self;\n    },\n    get state() {\n      return defaultOps.state;\n    },\n    get ctx() {\n      const ctxGen = (actions as any)?.__ctx__;\n      if (!ctxGen) return undefined;\n      return ctxGen({\n        state: store.get(key, initial),\n        initialState: store.getInitial(key) ?? initial,\n        actions: boundActions,\n        ops: defaultOps,\n      });\n    },\n  };\n\n  if (actions) {\n    for (const [name, fn] of Object.entries(actions)) {\n      if (name === \"__ctx__\") continue;\n      boundActions[name] = (...args: any[]) =>\n        (fn as Function)(...args)(actionOps);\n    }\n  }\n\n  const toolbox: FlowOperations<T, A> = {\n    ops: defaultOps,\n    actions: boundActions,\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    _set: (val: any) => {\n      const next = typeof val === \"function\" ? val(store.get(key)) : val;\n      store.set(key, next, {\n        ...flowOptions,\n        force: true,\n        actor: flowOptions?.actor,\n      });\n    },\n    _patch: (val: any) => {\n      const next = typeof val === \"function\" ? val(store.get(key)) : val;\n      store.set(key, next, {\n        ...flowOptions,\n        force: false,\n        actor: flowOptions?.actor,\n      });\n    },\n    _reset: () => store.reset(key),\n    cf: flowOptions || {},\n    isHydrating: !!store.__hydrating__?.has(key),\n  };\n\n  const latestState = store.get(key, initial);\n  return [latestState, toolbox];\n}\n\n/**\n * Main hook to consume and interact with a FractoState flow.\n * Returns a tuple containing the current [State, Toolbox].\n */\nexport function useFlow<K extends string, T = any>(\n  key: K,\n  initial?: T,\n  options?: UseFlowOptions<T>,\n): [T, FlowOperations<T, {}>];\n\nexport function useFlow<T, A, C>(\n  def: FlowDefinition<T, A, C>,\n  options?: UseFlowOptions<T>,\n): [T, FlowOperations<T, A>];\n\nexport function useFlow<T, R>(def: DerivedFlowDefinition<T, R>): [R, {}];\n\nexport function useFlow(\n  keyOrDef: any,\n  initial?: any,\n  options?: any,\n): [any, any] {\n  const isDerived = typeof keyOrDef === \"object\" && \"selector\" in keyOrDef;\n  const isDef = typeof keyOrDef === \"object\" && \"key\" in keyOrDef && !isDerived;\n\n  const key = isDef\n    ? (keyOrDef as any).key\n    : isDerived\n      ? (keyOrDef as any).source.key\n      : (keyOrDef as string);\n  const initialVal = isDef\n    ? (keyOrDef as any).initial\n    : isDerived\n      ? (keyOrDef as any).source.initial\n      : initial;\n  const flowOptions = isDef\n    ? { ...((keyOrDef as any).options || {}), ...(initial || {}) }\n    : isDerived\n      ? (keyOrDef as any).source.options\n      : options;\n\n  const [snapshot, setSnapshot] = useState(() => {\n    const raw = store.get(key, initialVal, flowOptions);\n    return isDerived ? (keyOrDef as any).selector(raw) : raw;\n  });\n\n  useEffect(() => {\n    const label = flowOptions?.name || flowOptions?.actor || `useFlow(${key})`;\n    return store.subscribe(\n      key,\n      () => {\n        const raw = store.get(key, initialVal);\n        setSnapshot(isDerived ? (keyOrDef as any).selector(raw) : raw);\n      },\n      { label },\n    );\n  }, [key, isDerived, flowOptions?.name, flowOptions?.actor]);\n\n  const toolbox = useMemo(() => {\n    if (isDerived) return {};\n\n    const boundActions = {} as any;\n    const defaultOps: FlowOpsObject<any, any> = {\n      get self() {\n        return createDeepProxy<any, any>(key, [], store.get(key, initialVal), {\n          ...flowOptions,\n          actions: boundActions,\n          actor: flowOptions?.name || flowOptions?.actor,\n        });\n      },\n      get state() {\n        return store.get(key, initialVal);\n      },\n    };\n\n    const actions = (keyOrDef as any)?.options?.actions || flowOptions?.actions;\n\n    const actionOps: ActionOpsObject<any, any, any> = {\n      get self() {\n        return defaultOps.self;\n      },\n      get state() {\n        return defaultOps.state;\n      },\n      get ctx() {\n        const ctxGen = (actions as any)?.__ctx__;\n        if (!ctxGen) return undefined;\n        return ctxGen({\n          state: store.get(key, initialVal),\n          initialState: store.getInitial(key) ?? initialVal,\n          actions: boundActions,\n          ops: defaultOps,\n        });\n      },\n    };\n\n    if (actions) {\n      for (const [name, fn] of Object.entries(actions)) {\n        if (name === \"__ctx__\") continue;\n        boundActions[name] = (...args: any[]) =>\n          (fn as Function)(...args)(actionOps);\n      }\n    }\n\n    return {\n      ops: defaultOps,\n      actions: boundActions,\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      _set: (val: any) => {\n        const next = typeof val === \"function\" ? val(store.get(key)) : val;\n        store.set(key, next, {\n          ...flowOptions,\n          force: true,\n          actor: flowOptions?.name || flowOptions?.actor,\n        });\n      },\n      _patch: (val: any) => {\n        const next = typeof val === \"function\" ? val(store.get(key)) : val;\n        store.set(key, next, {\n          ...flowOptions,\n          force: false,\n          actor: flowOptions?.name || flowOptions?.actor,\n        });\n      },\n      _reset: () => store.reset(key),\n      cf: flowOptions || {},\n      isHydrating: !!store.__hydrating__?.has(key),\n    };\n  }, [key, isDerived, snapshot, flowOptions]);\n\n  const state = isDerived\n    ? (keyOrDef as any).selector(store.get(key, initialVal))\n    : store.get(key, initialVal);\n\n  return [state, toolbox] as any;\n}\n"],"names":[],"mappings":"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"}

package/package.json

@@ -112,5 +112,5 @@
   },
   "type": "module",
   "types": "dist/index.d.ts",
-  "version": "4.8.0"
+  "version": "4.8.1"
 }

package/dist/types-4LME7oGG.d.ts

@@ -1,200 +0,0 @@
-/**
- * Core types for FractoState
- */
-type TypeAwareOps<T, A = any> = [T] extends [null | undefined] ? BaseOps<T, A> : [T] extends [any[]] ? ArrayOps<T[number], A> : [T] extends [number] ? NumberOps<A> : [T] extends [string] ? StringOps<A> : [T] extends [boolean] ? BooleanOps<A> : [NonNullable<T>] extends [object] ? ObjectOps<T, A> : BaseOps<T, A>;
-type FlowOpsObject<T, A = any> = {
-    readonly self: TypeAwareOps<T, A>;
-    readonly state: T;
-};
-/**
- * Enhanced operations for actions that include the context
- */
-type ActionOpsObject<T, A = any, C = undefined> = FlowOpsObject<T, A> & {
-    readonly ctx: C;
-};
-/**
- * Action structure: (...args) => (ops) => Result
- */
-type FlowAction<T, A = any, C = undefined> = (...args: any[]) => (ops: ActionOpsObject<T, A, C>) => any;
-/**
- * Transform actions for the component toolbox.
- * Excludes internal __ctx__ property.
- */
-type BoundActions<A> = {
-    [K in keyof A as K extends "__ctx__" ? never : K]: A[K] extends (...args: infer P) => (...inner: any[]) => infer R ? (...args: P) => R : never;
-};
-interface FlowPlugin<T = any> {
-    name: string;
-    onInit?: (ctx: {
-        key: string;
-        initial: T;
-        store: any;
-    }) => void;
-    onUpdate?: (ctx: {
-        key: string;
-        prev: T;
-        next: T;
-        store: any;
-    }) => void;
-    onHydrate?: (ctx: {
-        key: string;
-        store: any;
-    }) => T | Promise<T> | undefined;
-    /** Return methods that will be exposed under ops.self._[pluginName] */
-    getOps?: (ctx: {
-        key: string;
-        store: any;
-    }) => Record<string, Function>;
-}
-interface FlowEffect<T, A = any> {
-    /** Function to run on init and when deps change */
-    run: (ops: FlowOpsObject<T, A>) => void | Promise<void>;
-    /** Optional dependencies selector. If omitted, runs only on init */
-    deps?: (state: T) => any[];
-}
-interface FlowOptions<T = any, A = any> {
-    timeTravel?: boolean;
-    maxHistory?: number;
-    debounce?: number;
-    middleware?: Array<(state: T) => T>;
-    plugins?: FlowPlugin<T>[];
-    effects?: FlowEffect<T, A>[];
-    force?: boolean;
-    skipEquality?: boolean;
-    isUndoRedo?: boolean;
-    bypassClone?: boolean;
-    /** The name of the component or module performing the update */
-    actor?: string;
-    /** Raw actions dictionary for internal binding */
-    actions?: A;
-}
-interface ContextGetterOps<T, A> {
-    state: T;
-    initialState: T;
-    actions: BoundActions<A>;
-    ops: FlowOpsObject<T, A>;
-}
-interface UseFlowOptions<T> extends FlowOptions<T> {
-    name?: string;
-}
-interface FlowDefinition<T, A = {}, C = undefined> {
-    key: string;
-    initial: T;
-    options?: FlowOptions<T, A> & {
-        actions?: A;
-    };
-}
-interface DerivedFlowDefinition<T, R> {
-    key: string;
-    source: FlowDefinition<T, any>;
-    selector: (state: T) => R;
-}
-interface FlowOperations<T, A = {}> {
-    /** The operation object for recursive state manipulation via proxies */
-    ops: FlowOpsObject<T, A>;
-    /** The actions defined in defineFlow, bound to this specific state instance */
-    actions: BoundActions<A>;
-    /** Reverts to the previous state in history (if timeTravel is enabled) */
-    _undo: () => void;
-    /** Reapplies a previously undone state (if timeTravel is enabled) */
-    _redo: () => void;
-    /** Returns the full history stack for this flow */
-    history: T[];
-    /** Boolean indicating if an undo operation is currently possible */
-    _canUndo: boolean;
-    /** Boolean indicating if a redo operation is currently possible */
-    _canRedo: boolean;
-    /** Forcefully updates the state and records history even if values are identical. Useful for triggering effects or manual snapshots. */
-    _set: (val: T | ((prev: T) => T)) => void;
-    /** Optimized update: only commits the change if the new value differs from the current one. Saves history space and render cycles. */
-    _patch: (val: T | ((prev: T) => T)) => void;
-    /** Resets the state back to its initial defined configuration */
-    _reset: () => void;
-    /** Returns the current flow configuration options */
-    cf: FlowOptions<T>;
-    /** Boolean indicating if the flow is currently loading data from a hydration plugin (e.g., localStorage) */
-    isHydrating: boolean;
-}
-/**
- * Common operations available on every state node.
- * Prefixed with underscores to avoid collisions with your nested data properties.
- */
-type BaseOps<T, A = any> = {
-    /** Forcefully replace the value at this path, ignoring equality checks. Records history. */
-    _set: (value: T) => void;
-    /** Smart update: only commits the change if the value is different. */
-    _patch: (value: T) => void;
-    /** Unwraps the proxy and returns the raw value at this specific tree path. */
-    _val: T;
-    /** Access all actions defined in this flow */
-    __actions__: BoundActions<A>;
-    /** Persistence control (provided by persist plugin) */
-    _persist?: {
-        clear: () => void;
-        update: () => void;
-        refresh: () => Promise<void>;
-    };
-};
-/** Operations specific to numeric values */
-type NumberOps<A = any> = BaseOps<number, A> & {
-    /** Increment by n (default 1) */
-    _increment: (n?: number) => void;
-    /** Decrement by n (default 1) */
-    _decrement: (n?: number) => void;
-    /** Add n to the value */
-    _add: (n: number) => void;
-    /** Subtract n from the value */
-    _subtract: (n: number) => void;
-    /** Multiply the value by n */
-    _multiply: (n: number) => void;
-    /** Divide the value by n */
-    _divide: (n: number) => void;
-};
-/** Operations specific to string values */
-type StringOps<A = any> = BaseOps<string, A> & {
-    /** Append a string at the end */
-    _append: (s: string) => void;
-    /** Prepend a string at the beginning */
-    _prepend: (s: string) => void;
-    /** Convert value to uppercase */
-    _uppercase: () => void;
-    /** Convert value to lowercase */
-    _lowercase: () => void;
-    /** Trim whitespace from both ends */
-    _trim: () => void;
-    /** Replace occurrences matching pattern */
-    _replace: (pattern: string | RegExp, replacement: string) => void;
-};
-/** Operations specific to array values */
-type ArrayOps<T, A = any> = BaseOps<T[], A> & {
-    /** Add an item to the end of the array */
-    _push: (v: T) => void;
-    /** Remove and return the last item */
-    _pop: () => void;
-    /** Remove and return the first item */
-    _shift: () => void;
-    /** Add an item to the beginning of the array */
-    _unshift: (v: T) => void;
-    /** Keep only items matching the condition */
-    _filter: (fn: (v: T, i: number) => boolean) => void;
-    /** Transform every item in the array */
-    _map: (fn: (v: T, i: number) => T) => void;
-    /** Remove item at a specific index */
-    _removeAt: (i: number) => void;
-    /** Insert an item at a specific index */
-    _insertAt: (i: number, v: T) => void;
-};
-/** Operations specific to object values */
-type ObjectOps<T, A = any> = BaseOps<T, A> & {
-    /** Shallow merge the provided object into the current state */
-    _merge: (p: Partial<NonNullable<T>>) => void;
-    /** Remove a specific key from the object */
-    _delete: (k: keyof NonNullable<T>) => void;
-} & {
-    [K in keyof NonNullable<T>]-?: TypeAwareOps<NonNullable<T>[K], A>;
-};
-type BooleanOps<A = any> = BaseOps<boolean, A> & {
-    _toggle: () => void;
-};
-
-export type { ActionOpsObject as A, BaseOps as B, ContextGetterOps as C, DerivedFlowDefinition as D, FlowDefinition as F, NumberOps as N, ObjectOps as O, StringOps as S, TypeAwareOps as T, UseFlowOptions as U, FlowOptions as a, FlowOperations as b, ArrayOps as c, BooleanOps as d, BoundActions as e, FlowAction as f, FlowEffect as g, FlowOpsObject as h, FlowPlugin as i };