fractostate 1.0.1 → 1.0.2

package/dist/esm/src/store.js

@@ -0,0 +1,371 @@
+/**
+ * Fast & Secure Memory Vault
+ * Ultra-performant in-memory store with deep cloning and batching
+ * NO PERSISTENCE - Pure memory for maximum safety and speed
+ */
+class SecureVault {
+    constructor() {
+        Object.defineProperty(this, "vault", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Map()
+        });
+        Object.defineProperty(this, "initialValues", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Map()
+        });
+        Object.defineProperty(this, "listeners", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Map()
+        });
+        Object.defineProperty(this, "histories", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Map()
+        });
+        Object.defineProperty(this, "redoStacks", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Map()
+        });
+        Object.defineProperty(this, "debounceTimers", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Map()
+        });
+        Object.defineProperty(this, "batchQueue", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Set()
+        });
+        Object.defineProperty(this, "batchScheduled", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: false
+        });
+        this.setupSecureAccess();
+        this.setupAutoCleanup();
+    }
+    /**
+     * Protects the vault instance from global window inspection.
+     */
+    setupSecureAccess() {
+        if (typeof window !== "undefined") {
+            Object.defineProperty(window, "__FRACTO_VAULT__", {
+                get: () => "🔒 Access Denied: Secure Memory Instance",
+                configurable: false,
+            });
+        }
+    }
+    /**
+     * Periodically cleans up orphaned listeners.
+     */
+    setupAutoCleanup() {
+        if (typeof setInterval !== "undefined") {
+            setInterval(() => {
+                this.listeners.forEach((set, key) => {
+                    if (set.size === 0 && !this.vault.has(key)) {
+                        this.listeners.delete(key);
+                    }
+                });
+            }, 300000); // 5 min
+        }
+    }
+    /**
+     * Lightweight but ultra-fast obfuscation for memory protection.
+     */
+    obfuscate(data) {
+        if (data === undefined)
+            return undefined;
+        try {
+            const str = JSON.stringify(data);
+            // Simple scrambling to prevent plain-text memory inspection
+            return { _: btoa(encodeURIComponent(str)), t: Date.now() };
+        }
+        catch {
+            return data;
+        }
+    }
+    /**
+     * Reverts obfuscation to retrieve original data structure.
+     */
+    deobfuscate(vaultItem) {
+        if (!vaultItem || typeof vaultItem !== "object" || !vaultItem._)
+            return vaultItem;
+        try {
+            const decoded = decodeURIComponent(atob(vaultItem._));
+            return JSON.parse(decoded);
+        }
+        catch {
+            return undefined;
+        }
+    }
+    /**
+     * Retrieves state from the vault. Initializes if a value is provided and the key is missing.
+     */
+    get(key, initialValue) {
+        if (!this.vault.has(key)) {
+            if (initialValue === undefined)
+                return undefined;
+            const cloned = deepClone(initialValue);
+            this.vault.set(key, this.obfuscate(cloned));
+            this.initialValues.set(key, deepClone(cloned));
+            this.histories.set(key, new CircularBuffer(100, [cloned]));
+            this.redoStacks.set(key, []);
+        }
+        const val = this.deobfuscate(this.vault.get(key));
+        return val === undefined ? initialValue : val;
+    }
+    /**
+     * Updates state in the vault with optional debouncing and middleware support.
+     */
+    set(key, newValue, options = {}) {
+        const prevState = this.deobfuscate(this.vault.get(key));
+        let stateToSet = deepClone(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)
+        if (deepEqual(prevState, stateToSet))
+            return;
+        if (options.debounce) {
+            this.debouncedSet(key, stateToSet, options);
+            return;
+        }
+        this.applySet(key, stateToSet, options);
+    }
+    /**
+     * Executes a debounced state update.
+     */
+    debouncedSet(key, value, options) {
+        const existing = this.debounceTimers.get(key);
+        if (existing)
+            clearTimeout(existing);
+        const timer = setTimeout(() => {
+            this.applySet(key, value, options);
+            this.debounceTimers.delete(key);
+        }, options.debounce);
+        this.debounceTimers.set(key, timer);
+    }
+    /**
+     * Core logic for applying a state update and managing history.
+     */
+    applySet(key, stateToSet, options) {
+        this.vault.set(key, this.obfuscate(stateToSet));
+        if (options.timeTravel) {
+            const history = this.histories.get(key);
+            if (history)
+                history.push(deepClone(stateToSet));
+            const redo = this.redoStacks.get(key);
+            if (redo)
+                redo.length = 0;
+        }
+        this.scheduleBatchNotify(key);
+    }
+    /**
+     * Schedules a microtask to batch notifications and optimize React renders.
+     */
+    scheduleBatchNotify(key) {
+        this.batchQueue.add(key);
+        if (this.batchScheduled)
+            return;
+        this.batchScheduled = true;
+        queueMicrotask(() => this.flushBatchNotify());
+    }
+    /**
+     * Flushes and notifies all queued listeners.
+     */
+    flushBatchNotify() {
+        const keys = Array.from(this.batchQueue);
+        this.batchQueue.clear();
+        this.batchScheduled = false;
+        keys.forEach((key) => this.notify(key));
+    }
+    /**
+     * Connects a listener to a specific flow key.
+     */
+    subscribe(key, listener) {
+        if (!this.listeners.has(key))
+            this.listeners.set(key, new Set());
+        this.listeners.get(key).add(listener);
+        return () => {
+            this.listeners.get(key)?.delete(listener);
+        };
+    }
+    /**
+     * Directly notifies all listeners of a specific key.
+     */
+    notify(key) {
+        this.listeners.get(key)?.forEach((l) => l());
+    }
+    /**
+     * Reverts the state to the previous version in history.
+     */
+    undo(key) {
+        const history = this.histories.get(key);
+        const redo = this.redoStacks.get(key);
+        if (history && history.length() > 1) {
+            const current = history.pop();
+            if (current)
+                redo?.push(current);
+            const prev = history.peek();
+            this.vault.set(key, this.obfuscate(prev));
+            this.notify(key);
+        }
+    }
+    /**
+     * Restores the state to the next version in the redo stack.
+     */
+    redo(key) {
+        const history = this.histories.get(key);
+        const redo = this.redoStacks.get(key);
+        if (redo && redo.length > 0) {
+            const next = redo.pop();
+            history?.push(next);
+            this.vault.set(key, this.obfuscate(next));
+            this.notify(key);
+        }
+    }
+    /**
+     * Resets a flow to its initial value.
+     */
+    reset(key) {
+        const initial = this.initialValues.get(key);
+        if (initial !== undefined)
+            this.set(key, initial);
+    }
+    getHistory(key) {
+        return this.histories.get(key)?.toArray() || [];
+    }
+    getRedoStack(key) {
+        return this.redoStacks.get(key) || [];
+    }
+    /**
+     * Clears the entire store and all timers.
+     */
+    clearAll() {
+        this.debounceTimers.forEach((t) => clearTimeout(t));
+        this.vault.clear();
+        this.initialValues.clear();
+        this.listeners.clear();
+        this.histories.clear();
+        this.redoStacks.clear();
+    }
+}
+/**
+ * Circular Buffer implementation for high-performance memory-efficient history.
+ */
+class CircularBuffer {
+    constructor(maxSize, initial = []) {
+        Object.defineProperty(this, "buffer", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "head", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: 0
+        });
+        Object.defineProperty(this, "size", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: 0
+        });
+        Object.defineProperty(this, "maxSize", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.maxSize = maxSize;
+        this.buffer = new Array(maxSize);
+        initial.forEach((i) => this.push(i));
+    }
+    push(item) {
+        this.buffer[this.head] = item;
+        this.head = (this.head + 1) % this.maxSize;
+        if (this.size < this.maxSize)
+            this.size++;
+    }
+    pop() {
+        if (this.size <= 0)
+            return undefined;
+        this.head = (this.head - 1 + this.maxSize) % this.maxSize;
+        this.size--;
+        return this.buffer[this.head];
+    }
+    peek() {
+        return this.size > 0
+            ? this.buffer[(this.head - 1 + this.maxSize) % this.maxSize]
+            : undefined;
+    }
+    length() {
+        return this.size;
+    }
+    toArray() {
+        const res = [];
+        for (let i = 0; i < this.size; i++) {
+            res.push(this.buffer[(this.head - this.size + i + this.maxSize) % this.maxSize]);
+        }
+        return res;
+    }
+}
+/**
+ * High-performance deep cloning utility.
+ */
+function deepClone(obj) {
+    if (obj === null || typeof obj !== "object")
+        return obj;
+    if (Array.isArray(obj))
+        return obj.map(deepClone);
+    const cloned = {};
+    for (const key in obj) {
+        if (Object.prototype.hasOwnProperty.call(obj, key))
+            cloned[key] = deepClone(obj[key]);
+    }
+    return cloned;
+}
+/**
+ * High-performance deep equality utility.
+ */
+function deepEqual(a, b) {
+    if (a === b)
+        return true;
+    if (typeof a !== typeof b || a === null || b === null)
+        return false;
+    if (typeof a === "object") {
+        const keysA = Object.keys(a);
+        const keysB = Object.keys(b);
+        if (keysA.length !== keysB.length)
+            return false;
+        for (const key of keysA) {
+            if (!Object.prototype.hasOwnProperty.call(b, key))
+                return false;
+            if (!deepEqual(a[key], b[key]))
+                return false;
+        }
+        return true;
+    }
+    return false;
+}
+const store = new SecureVault();
+
+export { store };
+//# sourceMappingURL=store.js.map

package/dist/esm/src/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sources":["../../../src/store.ts"],"sourcesContent":["import type { FlowOptions } from \"./types\";\n\n/**\n * Fast & Secure Memory Vault\n * Ultra-performant in-memory store with deep cloning and batching\n * NO PERSISTENCE - Pure memory for maximum safety and speed\n */\nclass SecureVault {\n  private vault = new Map<string, any>();\n  private initialValues = new Map<string, any>();\n  private listeners = new Map<string, Set<() => void>>();\n  private histories = new Map<string, CircularBuffer<any>>();\n  private redoStacks = new Map<string, any[]>();\n  private debounceTimers = new Map<string, number>();\n  private batchQueue = new Set<string>();\n  private batchScheduled = false;\n\n  constructor() {\n    this.setupSecureAccess();\n    this.setupAutoCleanup();\n  }\n\n  /**\n   * Protects the vault instance from global window inspection.\n   */\n  private setupSecureAccess() {\n    if (typeof window !== \"undefined\") {\n      Object.defineProperty(window, \"__FRACTO_VAULT__\", {\n        get: () => \"🔒 Access Denied: Secure Memory Instance\",\n        configurable: false,\n      });\n    }\n  }\n\n  /**\n   * Periodically cleans up orphaned listeners.\n   */\n  private setupAutoCleanup() {\n    if (typeof setInterval !== \"undefined\") {\n      setInterval(() => {\n        this.listeners.forEach((set, key) => {\n          if (set.size === 0 && !this.vault.has(key)) {\n            this.listeners.delete(key);\n          }\n        });\n      }, 300000); // 5 min\n    }\n  }\n\n  /**\n   * Lightweight but ultra-fast obfuscation for memory protection.\n   */\n  private obfuscate(data: any): any {\n    if (data === undefined) return undefined;\n    try {\n      const str = JSON.stringify(data);\n      // Simple scrambling to prevent plain-text memory inspection\n      return { _: btoa(encodeURIComponent(str)), t: Date.now() };\n    } catch {\n      return data;\n    }\n  }\n\n  /**\n   * Reverts obfuscation to retrieve original data structure.\n   */\n  private deobfuscate(vaultItem: any): any {\n    if (!vaultItem || typeof vaultItem !== \"object\" || !vaultItem._)\n      return vaultItem;\n    try {\n      const decoded = decodeURIComponent(atob(vaultItem._));\n      return JSON.parse(decoded);\n    } catch {\n      return undefined;\n    }\n  }\n\n  /**\n   * Retrieves state from the vault. Initializes if a value is provided and the key is missing.\n   */\n  get(key: string, initialValue?: any) {\n    if (!this.vault.has(key)) {\n      if (initialValue === undefined) return undefined;\n\n      const cloned = deepClone(initialValue);\n      this.vault.set(key, this.obfuscate(cloned));\n      this.initialValues.set(key, deepClone(cloned));\n      this.histories.set(key, new CircularBuffer(100, [cloned]));\n      this.redoStacks.set(key, []);\n    }\n\n    const val = this.deobfuscate(this.vault.get(key));\n    return val === undefined ? initialValue : val;\n  }\n\n  /**\n   * Updates state in the vault with optional debouncing and middleware support.\n   */\n  set(key: string, newValue: any, options: FlowOptions = {}) {\n    const prevState = this.deobfuscate(this.vault.get(key));\n    let stateToSet = deepClone(newValue);\n\n    // Apply synchronous middleware\n    if (options.middleware) {\n      for (const fn of options.middleware) {\n        stateToSet = fn(stateToSet);\n      }\n    }\n\n    // Skip update if state has not changed (Deep equality check)\n    if (deepEqual(prevState, stateToSet)) return;\n\n    if (options.debounce) {\n      this.debouncedSet(key, stateToSet, options);\n      return;\n    }\n\n    this.applySet(key, stateToSet, options);\n  }\n\n  /**\n   * Executes a debounced state update.\n   */\n  private debouncedSet(key: string, value: any, options: FlowOptions) {\n    const existing = this.debounceTimers.get(key);\n    if (existing) clearTimeout(existing);\n\n    const timer = setTimeout(() => {\n      this.applySet(key, value, options);\n      this.debounceTimers.delete(key);\n    }, options.debounce);\n\n    this.debounceTimers.set(key, timer as any);\n  }\n\n  /**\n   * Core logic for applying a state update and managing history.\n   */\n  private applySet(key: string, stateToSet: any, options: FlowOptions) {\n    this.vault.set(key, this.obfuscate(stateToSet));\n\n    if (options.timeTravel) {\n      const history = this.histories.get(key);\n      if (history) history.push(deepClone(stateToSet));\n      const redo = this.redoStacks.get(key);\n      if (redo) redo.length = 0;\n    }\n\n    this.scheduleBatchNotify(key);\n  }\n\n  /**\n   * Schedules a microtask to batch notifications and optimize React renders.\n   */\n  private scheduleBatchNotify(key: string) {\n    this.batchQueue.add(key);\n    if (this.batchScheduled) return;\n    this.batchScheduled = true;\n    queueMicrotask(() => this.flushBatchNotify());\n  }\n\n  /**\n   * Flushes and notifies all queued listeners.\n   */\n  private flushBatchNotify() {\n    const keys = Array.from(this.batchQueue);\n    this.batchQueue.clear();\n    this.batchScheduled = false;\n    keys.forEach((key) => this.notify(key));\n  }\n\n  /**\n   * Connects a listener to a specific flow key.\n   */\n  subscribe(key: string, listener: () => void) {\n    if (!this.listeners.has(key)) this.listeners.set(key, new Set());\n    this.listeners.get(key)!.add(listener);\n    return () => {\n      this.listeners.get(key)?.delete(listener);\n    };\n  }\n\n  /**\n   * Directly notifies all listeners of a specific key.\n   */\n  private notify(key: string) {\n    this.listeners.get(key)?.forEach((l) => l());\n  }\n\n  /**\n   * Reverts the state to the previous version in history.\n   */\n  undo(key: string) {\n    const history = this.histories.get(key);\n    const redo = this.redoStacks.get(key);\n    if (history && history.length() > 1) {\n      const current = history.pop();\n      if (current) redo?.push(current);\n      const prev = history.peek();\n      this.vault.set(key, this.obfuscate(prev));\n      this.notify(key);\n    }\n  }\n\n  /**\n   * Restores the state to the next version in the redo stack.\n   */\n  redo(key: string) {\n    const history = this.histories.get(key);\n    const redo = this.redoStacks.get(key);\n    if (redo && redo.length > 0) {\n      const next = redo.pop();\n      history?.push(next);\n      this.vault.set(key, this.obfuscate(next));\n      this.notify(key);\n    }\n  }\n\n  /**\n   * Resets a flow to its initial value.\n   */\n  reset(key: string) {\n    const initial = this.initialValues.get(key);\n    if (initial !== undefined) this.set(key, initial);\n  }\n\n  getHistory(key: string) {\n    return this.histories.get(key)?.toArray() || [];\n  }\n  getRedoStack(key: string) {\n    return this.redoStacks.get(key) || [];\n  }\n\n  /**\n   * Clears the entire store and all timers.\n   */\n  clearAll() {\n    this.debounceTimers.forEach((t) => clearTimeout(t));\n    this.vault.clear();\n    this.initialValues.clear();\n    this.listeners.clear();\n    this.histories.clear();\n    this.redoStacks.clear();\n  }\n}\n\n/**\n * Circular Buffer implementation for high-performance memory-efficient history.\n */\nclass CircularBuffer<T> {\n  private buffer: T[];\n  private head = 0;\n  private size = 0;\n  private maxSize: number;\n\n  constructor(maxSize: number, initial: T[] = []) {\n    this.maxSize = maxSize;\n    this.buffer = new Array(maxSize);\n    initial.forEach((i) => this.push(i));\n  }\n  push(item: T) {\n    this.buffer[this.head] = item;\n    this.head = (this.head + 1) % this.maxSize;\n    if (this.size < this.maxSize) this.size++;\n  }\n  pop(): T | undefined {\n    if (this.size <= 0) return undefined;\n    this.head = (this.head - 1 + this.maxSize) % this.maxSize;\n    this.size--;\n    return this.buffer[this.head];\n  }\n  peek(): T | undefined {\n    return this.size > 0\n      ? this.buffer[(this.head - 1 + this.maxSize) % this.maxSize]\n      : undefined;\n  }\n  length() {\n    return this.size;\n  }\n  toArray(): T[] {\n    const res = [];\n    for (let i = 0; i < this.size; i++) {\n      res.push(\n        this.buffer[(this.head - this.size + i + this.maxSize) % this.maxSize],\n      );\n    }\n    return res;\n  }\n}\n\n/**\n * High-performance deep cloning utility.\n */\nfunction deepClone<T>(obj: T): T {\n  if (obj === null || typeof obj !== \"object\") return obj;\n  if (Array.isArray(obj)) return obj.map(deepClone) as any;\n  const cloned: any = {};\n  for (const key in obj) {\n    if (Object.prototype.hasOwnProperty.call(obj, key))\n      cloned[key] = deepClone(obj[key]);\n  }\n  return cloned;\n}\n\n/**\n * High-performance deep equality utility.\n */\nfunction deepEqual(a: any, b: any): boolean {\n  if (a === b) return true;\n  if (typeof a !== typeof b || a === null || b === null) return false;\n  if (typeof a === \"object\") {\n    const keysA = Object.keys(a);\n    const keysB = Object.keys(b);\n    if (keysA.length !== keysB.length) return false;\n    for (const key of keysA) {\n      if (!Object.prototype.hasOwnProperty.call(b, key)) return false;\n      if (!deepEqual(a[key], b[key])) return false;\n    }\n    return true;\n  }\n  return false;\n}\n\nexport const store = new SecureVault();\n"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,124 @@
+interface FlowOptions<T = any> {
+    /** Enable history tracking for undo/redo functionality */
+    timeTravel?: boolean;
+    /** Maximum number of states to keep in history (default: 100) */
+    maxHistory?: number;
+    /** Debounce state updates in milliseconds */
+    debounce?: number;
+    /** Array of functions to transform state before it is saved */
+    middleware?: Array<(state: T) => T>;
+}
+type BaseOps<T> = {
+    /** Replaces the entire value at this path */
+    set: (value: T) => void;
+};
+type NumberOps = BaseOps<number> & {
+    /** Adds 1 (or amount) to the number */
+    increment: (amount?: number) => void;
+    /** Subtracts 1 (or amount) from the number */
+    decrement: (amount?: number) => void;
+    /** Adds the given amount */
+    add: (amount: number) => void;
+    /** Subtracts the given amount */
+    subtract: (amount: number) => void;
+    /** Multiplies by the given amount */
+    multiply: (amount: number) => void;
+    /** Divides by the given amount */
+    divide: (amount: number) => void;
+};
+type StringOps = BaseOps<string> & {
+    /** Appends a string to the end */
+    append: (str: string) => void;
+    /** Prepends a string to the beginning */
+    prepend: (str: string) => void;
+    /** Converts to uppercase */
+    uppercase: () => void;
+    /** Converts to lowercase */
+    lowercase: () => void;
+    /** Removes whitespace from both ends */
+    trim: () => void;
+    /** Replaces a substring or regex match */
+    replace: (search: string | RegExp, replace: string) => void;
+};
+type ArrayOps<T> = BaseOps<T[]> & {
+    /** Appends an item to the end */
+    push: (item: T) => void;
+    /** Removes the last item */
+    pop: () => void;
+    /** Removes the first item */
+    shift: () => void;
+    /** Adds an item to the beginning */
+    unshift: (item: T) => void;
+    /** Filters the array based on a predicate */
+    filter: (predicate: (item: T, index: number) => boolean) => void;
+    /** Transforms each item in the array */
+    map: (fn: (item: T, index: number) => T) => void;
+    /** Adds/removes items at a specific index */
+    splice: (start: number, deleteCount?: number, ...items: T[]) => void;
+    /** Removes the item at the specified index */
+    removeAt: (index: number) => void;
+    /** Inserts an item at the specified index */
+    insertAt: (index: number, item: T) => void;
+};
+type ObjectOps<T> = BaseOps<T> & {
+    /** Merges the given object into the current one */
+    merge: (partial: Partial<T>) => void;
+    /** Deletes a property from the object */
+    delete: (key: keyof T) => void;
+} & {
+    [K in keyof T]-?: TypeAwareOps<T[K]>;
+};
+type BooleanOps = BaseOps<boolean> & {
+    /** Inverts the current boolean value */
+    toggle: () => void;
+};
+type TypeAwareOps<T> = T extends number ? NumberOps : T extends string ? StringOps : T extends boolean ? BooleanOps : T extends Array<infer U> ? ArrayOps<U> : T extends object ? ObjectOps<T> : BaseOps<T>;
+interface FlowDefinition<T> {
+    key: string;
+    initial: T;
+    options?: FlowOptions<T>;
+}
+interface FlowOperations<T> {
+    ops: {
+        /**
+         * Recursive, type-aware proxy that provides surgical atomic operations
+         * tailored to the shape of your state. It allows direct-like manipulation
+         * that is internally processed as immutable updates.
+         */
+        self: TypeAwareOps<T>;
+    };
+    /** Reverts to the previous state in history */
+    undo: () => void;
+    /** Restores the previously undone state */
+    redo: () => void;
+    /** Array of past states (requires timeTravel: true) */
+    history: T[];
+    /** Whether there is a previous state to undo */
+    canUndo: boolean;
+    /** Whether there is a next state to redo */
+    canRedo: boolean;
+    /** Manually sets the entire state or applies a transformation function */
+    set: (val: T | ((prev: T) => T)) => void;
+    /** Restores the state to its initial value */
+    reset: () => void;
+    /** Current flow configuration options */
+    cf: FlowOptions<T>;
+}
+
+/**
+ * Defines a flow in a centralized manner.
+ * Allows defining the key, initial state, and options in a single reusable object.
+ */
+declare function defineFlow<T>(key: string, initial: T, options?: FlowOptions<T>): FlowDefinition<T>;
+/**
+ * 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, ... }
+ */
+declare function useFlow<T>(keyOrDef: string | FlowDefinition<T>, maybeInitialValue?: T, options?: FlowOptions<T>): [T, FlowOperations<T>];
+
+export { defineFlow, useFlow };
+export type { ArrayOps, BaseOps, BooleanOps, FlowDefinition, FlowOperations, FlowOptions, NumberOps, ObjectOps, StringOps, TypeAwareOps };

package/package.json

@@ -1,5 +1,9 @@
 {
-  "author": "Nehonix-Team",
+  "author": {
+    "name": "Nehonix",
+    "url": "https://nehonix.com",
+    "email": "support@team.nehonix.com"
+  },
   "dependencies": {
     "vite": "^7.3.1"
   },
@@ -8,9 +12,21 @@
     "@types/react": "^19.2.9",
     "react": "^18.0.0",
     "tsup": "^8.0.0",
-    "typescript": "^5.0.0",
-    "vitest": "^1.0.0"
+    "typescript": "^5.9.3",
+    "vitest": "^1.0.0",
+    "@rollup/plugin-commonjs": "^29.0.0",
+    "@rollup/plugin-json": "^6.1.0",
+    "@rollup/plugin-node-resolve": "^16.0.3",
+    "@rollup/plugin-typescript": "^12.3.0",
+    "rollup-plugin-dts": "^6.3.0",
+    "tsc": "^2.0.4",
+    "tslib": "^2.8.1"
   },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
   "keywords": [
     "react",
     "state",
@@ -20,18 +36,42 @@
     "hooks"
   ],
   "license": "NOSL v1.0",
-  "main": "dist/index.js",
-  "module": "dist/index.mjs",
+  "main": "dist/cjs/index.js",
+  "module": "dist/esm/index.js",
   "name": "fractostate",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/esm/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/cjs/index.js"
+      },
+      "node": {
+        "import": "./dist/esm/index.js",
+        "require": "./dist/cjs/index.js"
+      },
+      "default": "./dist/cjs/index.js"
+    },
+    "./package.json": "./package.json"
+  },
   "peerDependencies": {
     "react": ">=16.8.0"
   },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Nehonix-Team/FractoState.git"
+  },
+  "type": "module",
   "scripts": {
-    "build": "tsup src/index.ts --dts --format esm,cjs",
+    "build": "rollup -c",
     "dev": "tsup src/index.ts --watch --dts --format esm,cjs",
     "lint": "eslint src",
     "test": "vitest"
   },
-  "types": "dist/index.d.ts",
-  "version": "1.0.1"
+  "version": "1.0.2"
 }

package/docs/api-reference.md

@@ -1,46 +0,0 @@
-# API Reference
-
-A detailed breakdown of the FractoState interface.
-
-## defineFlow<T>(key, initialValue, options?)
-
-Creates a reusable definition for a state flow.
-
-- **key**: A unique string identifying the flow in the global vault.
-- **initialValue**: The default state structure.
-- **options**: Configuration object (timeTravel, debounce, middleware).
-
-Returns a `FlowDefinition<T>`.
-
-## useFlow<T>(identifier, initialValue?, options?)
-
-The primary hook to interact with the state vault.
-
-- **identifier**: Either a string `key` or a `FlowDefinition`.
-- **initialValue**: Required only if identifier is a string and the flow hasn't been initialized.
-- **options**: Overrides for the flow configuration.
-
-Returns `[state, toolbox]`.
-
-### The Toolbox Object
-
-The second element returned by `useFlow` provides powerful control:
-
-- **ops.self**: A recursive proxy providing type-aware methods:
-  - **Numbers**: `increment()`, `decrement()`, `add()`, `multiply()`, `divide()`, `set()`.
-  - **Strings**: `append()`, `prepend()`, `uppercase()`, `replace()`, `set()`.
-  - **Arrays**: `push()`, `pop()`, `filter()`, `map()`, `insertAt()`, `removeAt()`, `set()`.
-  - **Objects**: `merge()`, `delete()`, `set()`.
-- **set(value | fn)**: Manually sets the entire state or applies a transformation function.
-- **undo()**: Reverts to the previous state.
-- **redo()**: Restores the previously undone state.
-- **history**: The full history buffer of the flow.
-- **canUndo / canRedo**: Boolean flags for UI control.
-- **reset()**: Restores the state to its defined initial value.
-
-## FlowOptions
-
-- **timeTravel**: Enable undo/redo functionality (default: false).
-- **maxHistory**: Maximum number of states maintained in the circular buffer (default: 100).
-- **debounce**: Delay in milliseconds before state updates are applied.
-- **middleware**: Array of functions `(state) => state` to intercept and transform values during updates.