@fynixorg/ui 1.0.11 → 1.0.13

package/dist/hooks/nixComputed.js

@@ -1,204 +1,172 @@
-var __defProp = Object.defineProperty;
-var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 import { activeContext, setActiveContext } from "../context/context";
-function nixComputed(computeFn) {
-  const ctx = activeContext;
-  if (!ctx)
-    throw new Error("nixComputed() called outside component");
-  if (typeof computeFn !== "function") {
-    throw new TypeError("[nixComputed] First argument must be a function");
-  }
-  const idx = ctx.hookIndex++;
-  if (!ctx.hooks[idx]) {
-    let compute = function() {
-      if (isDestroyed)
-        return cachedValue;
-      if (isComputing) {
-        console.error("[nixComputed] Circular dependency detected");
-        return cachedValue;
-      }
-      isComputing = true;
-      const trackingContext = {
-        _accessedStates: /* @__PURE__ */ new Set(),
-        hookIndex: 0,
-        hooks: [],
-        _subscriptions: /* @__PURE__ */ new Set(),
-        _subscriptionCleanups: []
-      };
-      const prevContext = activeContext;
-      try {
-        setActiveContext(trackingContext);
-        cachedValue = computeFn();
-        const oldDeps = Array.from(dependencies);
-        oldDeps.forEach((dep) => {
-          if (!trackingContext._accessedStates.has(dep)) {
-            if (unsubscribers.has(dep)) {
-              try {
-                unsubscribers.get(dep)();
-              } catch (e) {
-                console.error("[nixComputed] Error unsubscribing from old dependency:", e);
-              }
-              unsubscribers.delete(dep);
+export function nixComputed(computeFn) {
+    const ctx = activeContext;
+    if (!ctx)
+        throw new Error("nixComputed() called outside component");
+    if (typeof computeFn !== "function") {
+        throw new TypeError("[nixComputed] First argument must be a function");
+    }
+    const idx = ctx.hookIndex++;
+    if (!ctx.hooks[idx]) {
+        const subscribers = new Set();
+        const dependencies = new Set();
+        const unsubscribers = new Map();
+        let cachedValue;
+        let isStale = true;
+        let isDestroyed = false;
+        let isComputing = false;
+        function compute() {
+            if (isDestroyed)
+                return cachedValue;
+            if (isComputing) {
+                console.error("[nixComputed] Circular dependency detected");
+                return cachedValue;
             }
-            dependencies.delete(dep);
-          }
-        });
-        trackingContext._accessedStates.forEach((state) => {
-          if (!dependencies.has(state)) {
-            const unsub = state.subscribe(() => {
-              isStale = true;
-              const subsArray = Array.from(subscribers);
-              subsArray.forEach((fn) => {
-                try {
-                  fn(s.value);
-                } catch (e) {
-                  console.error("[nixComputed] Subscriber error:", e);
-                  subscribers.delete(fn);
-                }
-              });
-            });
-            unsubscribers.set(state, unsub);
-            dependencies.add(state);
-          }
-        });
-        isStale = false;
-      } catch (err) {
-        console.error("[nixComputed] Compute error:", err);
-        isStale = false;
-      } finally {
-        setActiveContext(prevContext);
-        isComputing = false;
-      }
-      return cachedValue;
-    };
-    __name(compute, "compute");
-    const subscribers = /* @__PURE__ */ new Set();
-    const dependencies = /* @__PURE__ */ new Set();
-    const unsubscribers = /* @__PURE__ */ new Map();
-    let cachedValue;
-    let isStale = true;
-    let isDestroyed = false;
-    let isComputing = false;
-    const s = {
-      /**
-       * Get the computed value (read-only).
-       * Automatically recomputes if dependencies have changed.
-       * @returns {any} The computed value
-       */
-      get value() {
-        if (isDestroyed) {
-          console.warn("[nixComputed] Accessing destroyed computed state");
-          return cachedValue;
-        }
-        if (isStale) {
-          compute();
-        }
-        if (activeContext && activeContext._accessedStates) {
-          activeContext._accessedStates.add(s);
-        }
-        return cachedValue;
-      },
-      /**
-       * Subscribe to computed value changes.
-       * @param {(value: T) => void} fn - Callback function
-       * @returns {() => void} Unsubscribe function
-       */
-      subscribe(fn) {
-        if (typeof fn !== "function") {
-          console.error("[nixComputed] subscribe() requires a function");
-          return () => {
-          };
-        }
-        if (isDestroyed) {
-          console.warn("[nixComputed] Cannot subscribe to destroyed computed state");
-          return () => {
-          };
-        }
-        const MAX_SUBSCRIBERS = 1e3;
-        if (subscribers.size >= MAX_SUBSCRIBERS) {
-          console.error("[nixComputed] Maximum subscriber limit reached");
-          return () => {
-          };
+            isComputing = true;
+            const trackingContext = {
+                _accessedStates: new Set(),
+                hookIndex: 0,
+                hooks: [],
+                _subscriptions: new Set(),
+                _subscriptionCleanups: [],
+                effects: [],
+                cleanups: [],
+                _vnode: null,
+                version: 0,
+                props: {},
+                stateCleanups: [],
+                parent: null,
+                context: {},
+                rerender: () => { },
+                Component: null,
+                _isMounted: false,
+                _isRerendering: false,
+            };
+            const prevContext = activeContext;
+            try {
+                setActiveContext(trackingContext);
+                cachedValue = computeFn();
+                const oldDeps = Array.from(dependencies);
+                oldDeps.forEach((dep) => {
+                    if (!trackingContext._accessedStates.has(dep)) {
+                        if (unsubscribers.has(dep)) {
+                            try {
+                                unsubscribers.get(dep)();
+                            }
+                            catch (e) {
+                                console.error("[nixComputed] Error unsubscribing from old dependency:", e);
+                            }
+                            unsubscribers.delete(dep);
+                        }
+                        dependencies.delete(dep);
+                    }
+                });
+                trackingContext._accessedStates.forEach((state) => {
+                    if (!dependencies.has(state)) {
+                        const unsub = state.subscribe(() => {
+                            isStale = true;
+                            const subsArray = Array.from(subscribers);
+                            subsArray.forEach((fn) => {
+                                try {
+                                    fn(s.value);
+                                }
+                                catch (e) {
+                                    console.error("[nixComputed] Subscriber error:", e);
+                                    subscribers.delete(fn);
+                                }
+                            });
+                        });
+                        unsubscribers.set(state, unsub);
+                        dependencies.add(state);
+                    }
+                });
+                isStale = false;
+            }
+            catch (err) {
+                console.error("[nixComputed] Compute error:", err);
+                isStale = false;
+            }
+            finally {
+                setActiveContext(prevContext);
+                isComputing = false;
+            }
+            return cachedValue;
         }
-        subscribers.add(fn);
-        return () => {
-          subscribers.delete(fn);
+        const s = {
+            get value() {
+                if (isDestroyed) {
+                    console.warn("[nixComputed] Accessing destroyed computed state");
+                    return cachedValue;
+                }
+                if (isStale) {
+                    compute();
+                }
+                if (activeContext && activeContext._accessedStates) {
+                    activeContext._accessedStates.add(s);
+                }
+                return cachedValue;
+            },
+            subscribe(fn) {
+                if (typeof fn !== "function") {
+                    console.error("[nixComputed] subscribe() requires a function");
+                    return () => { };
+                }
+                if (isDestroyed) {
+                    console.warn("[nixComputed] Cannot subscribe to destroyed computed state");
+                    return () => { };
+                }
+                const MAX_SUBSCRIBERS = 1000;
+                if (subscribers.size >= MAX_SUBSCRIBERS) {
+                    console.error("[nixComputed] Maximum subscriber limit reached");
+                    return () => { };
+                }
+                subscribers.add(fn);
+                return () => {
+                    subscribers.delete(fn);
+                };
+            },
+            cleanup() {
+                if (isDestroyed)
+                    return;
+                isDestroyed = true;
+                unsubscribers.forEach((unsub) => {
+                    try {
+                        unsub();
+                    }
+                    catch (e) {
+                        console.error("[nixComputed] Cleanup error:", e);
+                    }
+                });
+                unsubscribers.clear();
+                dependencies.clear();
+                subscribers.clear();
+                cachedValue = null;
+                console.log("[nixComputed] Computed state cleaned up");
+            },
+            getSubscriberCount() {
+                return subscribers.size;
+            },
+            getDependencyCount() {
+                return dependencies.size;
+            },
+            isDestroyed() {
+                return isDestroyed;
+            },
+            getDependencyInfo() {
+                return Array.from(dependencies).map((state) => ({
+                    state,
+                    hasCleanup: unsubscribers.has(state),
+                    isComputed: !!state._isComputed,
+                }));
+            },
+            _isNixState: true,
+            _isComputed: true,
         };
-      },
-      /**
-       * Cleanup all subscriptions and dependencies.
-       * Call this when component unmounts to prevent memory leaks.
-       * 
-       * @example
-       * nixEffect(() => {
-       *   return () => myComputed.cleanup();
-       * }, []);
-       */
-      cleanup() {
-        if (isDestroyed)
-          return;
-        isDestroyed = true;
-        unsubscribers.forEach((unsub, dep) => {
-          try {
-            unsub();
-          } catch (e) {
-            console.error("[nixComputed] Cleanup error:", e);
-          }
-        });
-        unsubscribers.clear();
-        dependencies.clear();
-        subscribers.clear();
-        cachedValue = null;
-        console.log("[nixComputed] Computed state cleaned up");
-      },
-      /**
-       * Get the number of active subscribers (useful for debugging)
-       * @returns {number} Number of active subscribers
-       */
-      getSubscriberCount() {
-        return subscribers.size;
-      },
-      /**
-       * Get the number of tracked dependencies (useful for debugging)
-       * @returns {number} Number of dependencies
-       */
-      getDependencyCount() {
-        return dependencies.size;
-      },
-      /**
-       * Check if computed state has been destroyed
-       * @returns {boolean} True if state is destroyed
-       */
-      isDestroyed() {
-        return isDestroyed;
-      },
-      /**
-       * Get information about current dependencies (debugging)
-       * @returns {Array<{state: Object, hasCleanup: boolean}>} Dependency info
-       */
-      getDependencyInfo() {
-        return Array.from(dependencies).map((dep) => ({
-          state: dep,
-          hasCleanup: unsubscribers.has(dep),
-          isComputed: !!dep._isComputed
-        }));
-      },
-      // Internal flags
-      _isNixState: true,
-      // Computed states behave like states
-      _isComputed: true
-      // Flag to identify computed states
-    };
-    compute();
-    ctx.hooks[idx] = s;
-    if (ctx.stateCleanups) {
-      ctx.stateCleanups.push(() => s.cleanup());
+        compute();
+        ctx.hooks[idx] = s;
+        if (ctx.stateCleanups) {
+            ctx.stateCleanups.push(() => s.cleanup());
+        }
     }
-  }
-  return ctx.hooks[idx];
+    return ctx.hooks[idx];
 }
-__name(nixComputed, "nixComputed");
-export {
-  nixComputed
-};
-//# sourceMappingURL=nixComputed.js.map

package/dist/hooks/nixComputed.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
-  "sources": ["../../hooks/nixComputed.js"],
-  "sourcesContent": ["/* ----------------------\r\n    nixComputed - Computed/Derived State\r\n    Memory Leaks & Security Issues Resolved\r\n---------------------- */\r\nimport { activeContext, setActiveContext } from \"../context/context\";\r\n\r\n/**\r\n * @template T\r\n * @typedef {Object} ComputedState\r\n * @property {T} value - Get the computed value (read-only)\r\n * @property {(fn: (value: T) => void) => (() => void)} subscribe - Subscribe to computed value changes\r\n * @property {() => void} cleanup - Cleanup all subscriptions and dependencies\r\n * @property {() => number} getSubscriberCount - Get number of active subscribers (debugging)\r\n * @property {() => number} getDependencyCount - Get number of tracked dependencies (debugging)\r\n * @property {() => boolean} isDestroyed - Check if computed state has been destroyed\r\n * @property {boolean} _isNixState - Internal flag (computed states behave like states)\r\n * @property {boolean} _isComputed - Internal flag to identify computed states\r\n */\r\n\r\n/**\r\n * Create a derived/computed state from other states.\r\n * Automatically tracks dependencies and updates when any dependency changes.\r\n * \r\n * @template T\r\n * @param {() => T} computeFn - Function that computes the derived value\r\n * @returns {ComputedState<T>} A reactive state object with the computed value\r\n * \r\n * @example\r\n * const count = nixState(5);\r\n * const doubled = nixComputed(() => count.value * 2);\r\n * console.log(doubled.value); // 10\r\n * count.value = 10;\r\n * console.log(doubled.value); // 20\r\n * \r\n * @example\r\n * // Multiple dependencies\r\n * const a = nixState(5);\r\n * const b = nixState(10);\r\n * const sum = nixComputed(() => a.value + b.value);\r\n * console.log(sum.value); // 15\r\n * \r\n * @example\r\n * // Conditional dependencies\r\n * const flag = nixState(true);\r\n * const x = nixState(1);\r\n * const y = nixState(2);\r\n * const result = nixComputed(() => flag.value ? x.value : y.value);\r\n * \r\n * @example\r\n * // With cleanup\r\n * const MyComponent = () => {\r\n *   const count = nixState(0);\r\n *   const doubled = nixComputed(() => count.value * 2);\r\n *   \r\n *   nixEffect(() => {\r\n *     return () => {\r\n *       doubled.cleanup();\r\n *       count.cleanup();\r\n *     };\r\n *   }, []);\r\n * };\r\n * \r\n * @throws {Error} If called outside a component context\r\n * @throws {TypeError} If computeFn is not a function\r\n */\r\nexport function nixComputed(computeFn) {\r\n  const ctx = activeContext;\r\n  if (!ctx) throw new Error(\"nixComputed() called outside component\");\r\n\r\n  // Security: Validate compute function\r\n  if (typeof computeFn !== 'function') {\r\n    throw new TypeError('[nixComputed] First argument must be a function');\r\n  }\r\n\r\n  const idx = ctx.hookIndex++;\r\n  if (!ctx.hooks[idx]) {\r\n    const subscribers = new Set();\r\n    const dependencies = new Set();\r\n    const unsubscribers = new Map(); // Map<dependency, unsubscribe function>\r\n    let cachedValue;\r\n    let isStale = true;\r\n    let isDestroyed = false;\r\n    let isComputing = false; // Prevent infinite loops\r\n\r\n    /**\r\n     * Compute the value and track dependencies\r\n     */\r\n    function compute() {\r\n      if (isDestroyed) return cachedValue;\r\n\r\n      // Prevent infinite computation loops\r\n      if (isComputing) {\r\n        console.error('[nixComputed] Circular dependency detected');\r\n        return cachedValue;\r\n      }\r\n\r\n      isComputing = true;\r\n\r\n      // Create a mock context for dependency tracking\r\n      const trackingContext = {\r\n        _accessedStates: new Set(),\r\n        hookIndex: 0,\r\n        hooks: [],\r\n        _subscriptions: new Set(),\r\n        _subscriptionCleanups: [],\r\n      };\r\n\r\n      // Save the previous context\r\n      const prevContext = activeContext;\r\n\r\n      try {\r\n        // Temporarily set the tracking context\r\n        // @ts-ignore - Internal tracking context doesn't need full ComponentContext properties\r\n        setActiveContext(trackingContext);\r\n\r\n        // Compute the value - this will trigger state.value getters\r\n        // which will add themselves to trackingContext._accessedStates\r\n        cachedValue = computeFn();\r\n\r\n        // Find dependencies that are no longer needed\r\n        const oldDeps = Array.from(dependencies);\r\n        oldDeps.forEach(dep => {\r\n          if (!trackingContext._accessedStates.has(dep)) {\r\n            // This dependency is no longer accessed - unsubscribe\r\n            if (unsubscribers.has(dep)) {\r\n              try {\r\n                unsubscribers.get(dep)();\r\n              } catch (e) {\r\n                console.error('[nixComputed] Error unsubscribing from old dependency:', e);\r\n              }\r\n              unsubscribers.delete(dep);\r\n            }\r\n            dependencies.delete(dep);\r\n          }\r\n        });\r\n\r\n        // Subscribe to new dependencies\r\n        trackingContext._accessedStates.forEach(state => {\r\n          if (!dependencies.has(state)) {\r\n            // New dependency found - subscribe to it\r\n            const unsub = state.subscribe(() => {\r\n              // Mark computed value as stale when dependency changes\r\n              isStale = true;\r\n\r\n              // Notify computed subscribers\r\n              const subsArray = Array.from(subscribers);\r\n              subsArray.forEach(fn => {\r\n                try {\r\n                  fn(s.value);\r\n                } catch (e) {\r\n                  console.error('[nixComputed] Subscriber error:', e);\r\n                  subscribers.delete(fn);\r\n                }\r\n              });\r\n            });\r\n\r\n            // Store unsubscribe function\r\n            unsubscribers.set(state, unsub);\r\n            dependencies.add(state);\r\n          }\r\n        });\r\n\r\n        isStale = false;\r\n      } catch (err) {\r\n        console.error('[nixComputed] Compute error:', err);\r\n        isStale = false; // Don't retry immediately\r\n      } finally {\r\n        // Restore the previous context\r\n        setActiveContext(prevContext);\r\n        isComputing = false;\r\n      }\r\n\r\n      return cachedValue;\r\n    }\r\n\r\n    const s = {\r\n      /**\r\n       * Get the computed value (read-only).\r\n       * Automatically recomputes if dependencies have changed.\r\n       * @returns {any} The computed value\r\n       */\r\n      get value() {\r\n        if (isDestroyed) {\r\n          console.warn('[nixComputed] Accessing destroyed computed state');\r\n          return cachedValue;\r\n        }\r\n\r\n        // Recompute if stale\r\n        if (isStale) {\r\n          compute();\r\n        }\r\n\r\n        // Track this computed state as a dependency if accessed in another computed\r\n        if (activeContext && activeContext._accessedStates) {\r\n          activeContext._accessedStates.add(s);\r\n        }\r\n\r\n        return cachedValue;\r\n      },\r\n\r\n      /**\r\n       * Subscribe to computed value changes.\r\n       * @param {(value: T) => void} fn - Callback function\r\n       * @returns {() => void} Unsubscribe function\r\n       */\r\n      subscribe(fn) {\r\n        // Security: Validate subscriber function\r\n        if (typeof fn !== 'function') {\r\n          console.error('[nixComputed] subscribe() requires a function');\r\n          return () => { };\r\n        }\r\n\r\n        // Memory Leak Fix: Don't add subscribers to destroyed state\r\n        if (isDestroyed) {\r\n          console.warn('[nixComputed] Cannot subscribe to destroyed computed state');\r\n          return () => { };\r\n        }\r\n\r\n        // Security: Limit number of subscribers to prevent DOS\r\n        const MAX_SUBSCRIBERS = 1000;\r\n        if (subscribers.size >= MAX_SUBSCRIBERS) {\r\n          console.error('[nixComputed] Maximum subscriber limit reached');\r\n          return () => { };\r\n        }\r\n\r\n        subscribers.add(fn);\r\n\r\n        // Return unsubscribe function\r\n        return () => {\r\n          subscribers.delete(fn);\r\n        };\r\n      },\r\n\r\n      /**\r\n       * Cleanup all subscriptions and dependencies.\r\n       * Call this when component unmounts to prevent memory leaks.\r\n       * \r\n       * @example\r\n       * nixEffect(() => {\r\n       *   return () => myComputed.cleanup();\r\n       * }, []);\r\n       */\r\n      cleanup() {\r\n        if (isDestroyed) return;\r\n\r\n        // Mark as destroyed to prevent further operations\r\n        isDestroyed = true;\r\n\r\n        // Unsubscribe from all dependencies\r\n        unsubscribers.forEach((unsub, dep) => {\r\n          try {\r\n            unsub();\r\n          } catch (e) {\r\n            console.error('[nixComputed] Cleanup error:', e);\r\n          }\r\n        });\r\n\r\n        // Clear all collections\r\n        unsubscribers.clear();\r\n        dependencies.clear();\r\n        subscribers.clear();\r\n\r\n        // Clear cached value to help garbage collection\r\n        cachedValue = null;\r\n\r\n        console.log('[nixComputed] Computed state cleaned up');\r\n      },\r\n\r\n      /**\r\n       * Get the number of active subscribers (useful for debugging)\r\n       * @returns {number} Number of active subscribers\r\n       */\r\n      getSubscriberCount() {\r\n        return subscribers.size;\r\n      },\r\n\r\n      /**\r\n       * Get the number of tracked dependencies (useful for debugging)\r\n       * @returns {number} Number of dependencies\r\n       */\r\n      getDependencyCount() {\r\n        return dependencies.size;\r\n      },\r\n\r\n      /**\r\n       * Check if computed state has been destroyed\r\n       * @returns {boolean} True if state is destroyed\r\n       */\r\n      isDestroyed() {\r\n        return isDestroyed;\r\n      },\r\n\r\n      /**\r\n       * Get information about current dependencies (debugging)\r\n       * @returns {Array<{state: Object, hasCleanup: boolean}>} Dependency info\r\n       */\r\n      getDependencyInfo() {\r\n        return Array.from(dependencies).map(dep => ({\r\n          state: dep,\r\n          hasCleanup: unsubscribers.has(dep),\r\n          isComputed: !!dep._isComputed,\r\n        }));\r\n      },\r\n\r\n      // Internal flags\r\n      _isNixState: true,  // Computed states behave like states\r\n      _isComputed: true,  // Flag to identify computed states\r\n    };\r\n\r\n    // Initial computation\r\n    compute();\r\n\r\n    // Store in hooks\r\n    ctx.hooks[idx] = s;\r\n\r\n    // Memory Leak Fix: Track for cleanup\r\n    if (ctx.stateCleanups) {\r\n      ctx.stateCleanups.push(() => s.cleanup());\r\n    }\r\n  }\r\n\r\n  return ctx.hooks[idx];\r\n}"],
-  "mappings": "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",
-  "names": []
+  "sources": ["../../hooks/nixComputed.ts"],
+  "sourcesContent": ["/* MIT License\r\n\r\n* Copyright (c) 2026 Resty Gonzales\r\n\r\nPermission is hereby granted, free of charge, to any person obtaining a copy\r\nof this software and associated documentation files (the \"Software\"), to deal\r\nin the Software without restriction, including without limitation the rights\r\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\r\ncopies of the Software, and to permit persons to whom the Software is\r\nfurnished to do so, subject to the following conditions:\r\n\r\nThe above copyright notice and this permission notice shall be included in all\r\ncopies or substantial portions of the Software.\r\n\r\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\r\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\r\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\r\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\r\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\r\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\r\n* SOFTWARE.\r\n */\r\n/* ----------------------\r\n    nixComputed - Computed/Derived State\r\n    Memory Leaks & Security Issues Resolved\r\n---------------------- */\r\nimport { activeContext, setActiveContext } from \"../context/context\";\r\n\r\n/**\r\n * @template T\r\n * @typedef {Object} ComputedState\r\n * @property {T} value - Get the computed value (read-only)\r\n * @property {(fn: (value: T) => void) => (() => void)} subscribe - Subscribe to computed value changes\r\n * @property {() => void} cleanup - Cleanup all subscriptions and dependencies\r\n * @property {() => number} getSubscriberCount - Get number of active subscribers (debugging)\r\n * @property {() => number} getDependencyCount - Get number of tracked dependencies (debugging)\r\n * @property {() => boolean} isDestroyed - Check if computed state has been destroyed\r\n * @property {boolean} _isNixState - Internal flag (computed states behave like states)\r\n * @property {boolean} _isComputed - Internal flag to identify computed states\r\n */\r\n\r\n/**\r\n * Create a derived/computed state from other states.\r\n * Automatically tracks dependencies and updates when any dependency changes.\r\n *\r\n * @template T\r\n * @param {() => T} computeFn - Function that computes the derived value\r\n * @returns {ComputedState<T>} A reactive state object with the computed value\r\n *\r\n * @example\r\n * const count = nixState(5);\r\n * const doubled = nixComputed(() => count.value * 2);\r\n * console.log(doubled.value); // 10\r\n * count.value = 10;\r\n * console.log(doubled.value); // 20\r\n *\r\n * @example\r\n * // Multiple dependencies\r\n * const a = nixState(5);\r\n * const b = nixState(10);\r\n * const sum = nixComputed(() => a.value + b.value);\r\n * console.log(sum.value); // 15\r\n *\r\n * @example\r\n * // Conditional dependencies\r\n * const flag = nixState(true);\r\n * const x = nixState(1);\r\n * const y = nixState(2);\r\n * const result = nixComputed(() => flag.value ? x.value : y.value);\r\n *\r\n * @example\r\n * // With cleanup\r\n * const MyComponent = () => {\r\n *   const count = nixState(0);\r\n *   const doubled = nixComputed(() => count.value * 2);\r\n *\r\n *   nixEffect(() => {\r\n *     return () => {\r\n *       doubled.cleanup();\r\n *       count.cleanup();\r\n *     };\r\n *   }, []);\r\n * };\r\n *\r\n * @throws {Error} If called outside a component context\r\n * @throws {TypeError} If computeFn is not a function\r\n */\r\nexport function nixComputed<T>(computeFn: () => T): {\r\n  value: T;\r\n  subscribe: (fn: (value: T) => void) => () => void;\r\n  cleanup: () => void;\r\n  getSubscriberCount: () => number;\r\n  getDependencyCount: () => number;\r\n  isDestroyed: () => boolean;\r\n  getDependencyInfo: () => Array<{\r\n    state: any;\r\n    hasCleanup: boolean;\r\n    isComputed: boolean;\r\n  }>;\r\n  _isNixState: true;\r\n  _isComputed: true;\r\n} {\r\n  const ctx = activeContext as\r\n    | (typeof activeContext & {\r\n        hookIndex: number;\r\n        hooks: Array<any>;\r\n        stateCleanups?: Array<() => void>;\r\n      })\r\n    | undefined;\r\n  if (!ctx) throw new Error(\"nixComputed() called outside component\");\r\n\r\n  if (typeof computeFn !== \"function\") {\r\n    throw new TypeError(\"[nixComputed] First argument must be a function\");\r\n  }\r\n\r\n  const idx = ctx.hookIndex++;\r\n  if (!ctx.hooks[idx]) {\r\n    const subscribers: Set<(value: T) => void> = new Set();\r\n    const dependencies: Set<any> = new Set();\r\n    const unsubscribers: Map<any, () => void> = new Map();\r\n    let cachedValue: T;\r\n    let isStale = true;\r\n    let isDestroyed = false;\r\n    let isComputing = false;\r\n\r\n    function compute(): T {\r\n      if (isDestroyed) return cachedValue;\r\n      if (isComputing) {\r\n        console.error(\"[nixComputed] Circular dependency detected\");\r\n        return cachedValue;\r\n      }\r\n      isComputing = true;\r\n      // Provide all required properties for ComponentContext type\r\n      // Use type assertion for safety and future-proofing\r\n      const trackingContext = {\r\n        _accessedStates: new Set(),\r\n        hookIndex: 0,\r\n        hooks: [],\r\n        _subscriptions: new Set(),\r\n        _subscriptionCleanups: [],\r\n        effects: [],\r\n        cleanups: [],\r\n        _vnode: null,\r\n        version: 0,\r\n        props: {},\r\n        stateCleanups: [],\r\n        parent: null,\r\n        context: {},\r\n        rerender: () => {},\r\n        Component: null,\r\n        _isMounted: false,\r\n        _isRerendering: false,\r\n      } as any; // Use 'as any' to satisfy ComponentContext type\r\n      const prevContext = activeContext;\r\n      try {\r\n        setActiveContext(trackingContext);\r\n        cachedValue = computeFn();\r\n        const oldDeps = Array.from(dependencies);\r\n        oldDeps.forEach((dep) => {\r\n          if (!trackingContext._accessedStates.has(dep)) {\r\n            if (unsubscribers.has(dep)) {\r\n              try {\r\n                unsubscribers.get(dep)!();\r\n              } catch (e) {\r\n                console.error(\r\n                  \"[nixComputed] Error unsubscribing from old dependency:\",\r\n                  e\r\n                );\r\n              }\r\n              unsubscribers.delete(dep);\r\n            }\r\n            dependencies.delete(dep);\r\n          }\r\n        });\r\n        trackingContext._accessedStates.forEach((state: any) => {\r\n          if (!dependencies.has(state)) {\r\n            const unsub = state.subscribe(() => {\r\n              isStale = true;\r\n              const subsArray = Array.from(subscribers);\r\n              subsArray.forEach((fn) => {\r\n                try {\r\n                  fn(s.value);\r\n                } catch (e) {\r\n                  console.error(\"[nixComputed] Subscriber error:\", e);\r\n                  subscribers.delete(fn);\r\n                }\r\n              });\r\n            });\r\n            unsubscribers.set(state, unsub);\r\n            dependencies.add(state);\r\n          }\r\n        });\r\n        isStale = false;\r\n      } catch (err) {\r\n        console.error(\"[nixComputed] Compute error:\", err);\r\n        isStale = false;\r\n      } finally {\r\n        setActiveContext(prevContext);\r\n        isComputing = false;\r\n      }\r\n      return cachedValue;\r\n    }\r\n\r\n    const s = {\r\n      get value(): T {\r\n        if (isDestroyed) {\r\n          console.warn(\"[nixComputed] Accessing destroyed computed state\");\r\n          return cachedValue;\r\n        }\r\n        if (isStale) {\r\n          compute();\r\n        }\r\n        if (activeContext && activeContext._accessedStates) {\r\n          activeContext._accessedStates.add(s);\r\n        }\r\n        return cachedValue;\r\n      },\r\n      subscribe(fn: (value: T) => void): () => void {\r\n        if (typeof fn !== \"function\") {\r\n          console.error(\"[nixComputed] subscribe() requires a function\");\r\n          return () => {};\r\n        }\r\n        if (isDestroyed) {\r\n          console.warn(\r\n            \"[nixComputed] Cannot subscribe to destroyed computed state\"\r\n          );\r\n          return () => {};\r\n        }\r\n        const MAX_SUBSCRIBERS = 1000;\r\n        if (subscribers.size >= MAX_SUBSCRIBERS) {\r\n          console.error(\"[nixComputed] Maximum subscriber limit reached\");\r\n          return () => {};\r\n        }\r\n        subscribers.add(fn);\r\n        return () => {\r\n          subscribers.delete(fn);\r\n        };\r\n      },\r\n      cleanup(): void {\r\n        if (isDestroyed) return;\r\n        isDestroyed = true;\r\n        unsubscribers.forEach((unsub) => {\r\n          try {\r\n            unsub();\r\n          } catch (e) {\r\n            console.error(\"[nixComputed] Cleanup error:\", e);\r\n          }\r\n        });\r\n        unsubscribers.clear();\r\n        dependencies.clear();\r\n        subscribers.clear();\r\n        cachedValue = null as any as T;\r\n        console.log(\"[nixComputed] Computed state cleaned up\");\r\n      },\r\n      getSubscriberCount(): number {\r\n        return subscribers.size;\r\n      },\r\n      getDependencyCount(): number {\r\n        return dependencies.size;\r\n      },\r\n      isDestroyed(): boolean {\r\n        return isDestroyed;\r\n      },\r\n      getDependencyInfo(): Array<{\r\n        state: any;\r\n        hasCleanup: boolean;\r\n        isComputed: boolean;\r\n      }> {\r\n        return Array.from(dependencies).map((state) => ({\r\n          state,\r\n          hasCleanup: unsubscribers.has(state),\r\n          isComputed: !!state._isComputed,\r\n        }));\r\n      },\r\n      _isNixState: true as const,\r\n      _isComputed: true as const,\r\n    };\r\n\r\n    compute();\r\n    ctx.hooks[idx] = s;\r\n    if (ctx.stateCleanups) {\r\n      ctx.stateCleanups.push(() => s.cleanup());\r\n    }\r\n  }\r\n  return ctx.hooks[idx] as ReturnType<typeof nixComputed<T>>;\r\n}\r\n"],
+  "mappings": "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",
+  "names": ["compute"]
 }

package/dist/hooks/nixDebounce.d.ts

@@ -0,0 +1,11 @@
+export interface NixDebounceOptions {
+    leading?: boolean;
+    trailing?: boolean;
+    maxWait?: number;
+    signal?: AbortSignal;
+}
+export type DebouncedFunction<T extends (...args: any[]) => any> = ((...args: Parameters<T>) => void) & {
+    cancel: () => void;
+};
+export declare function nixDebounce<T extends (...args: any[]) => any>(fn: T, delay?: number, options?: NixDebounceOptions): DebouncedFunction<T>;
+//# sourceMappingURL=nixDebounce.d.ts.map

package/dist/hooks/nixDebounce.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nixDebounce.d.ts","sourceRoot":"","sources":["../../hooks/nixDebounce.ts"],"names":[],"mappings":"AAiDA,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,MAAM,iBAAiB,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,IAAI,CAAC,CAClE,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KACnB,IAAI,CAAC,GAAG;IACX,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB,CAAC;AAEF,wBAAgB,WAAW,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAC3D,EAAE,EAAE,CAAC,EACL,KAAK,GAAE,MAAY,EACnB,OAAO,GAAE,kBAAuB,GAC/B,iBAAiB,CAAC,CAAC,CAAC,CA8DtB"}

package/dist/hooks/nixDebounce.js

@@ -1,60 +1,55 @@
-var __defProp = Object.defineProperty;
-var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
-function nixDebounce(fn, delay = 300, options = {}) {
-  let timerId = null;
-  let lastInvokeTime = 0;
-  let lastArgs;
-  let lastThis;
-  const { leading = false, trailing = true, maxWait, signal } = options;
-  if (signal) {
-    signal.addEventListener("abort", () => {
-      if (timerId) {
-        clearTimeout(timerId);
-        timerId = null;
-      }
-      lastArgs = null;
-      lastThis = null;
-    });
-  }
-  const invoke = /* @__PURE__ */ __name(() => {
-    lastInvokeTime = Date.now();
-    if (lastArgs) {
-      fn.apply(lastThis, lastArgs);
-      lastArgs = lastThis = null;
-    }
-  }, "invoke");
-  const debounced = /* @__PURE__ */ __name(function(...args) {
-    const now = Date.now();
-    lastArgs = args;
-    lastThis = this;
-    const shouldInvokeLeading = leading && !timerId;
-    const timeSinceLastInvoke = now - lastInvokeTime;
-    const remainingTime = delay - timeSinceLastInvoke;
-    if (maxWait !== void 0 && timeSinceLastInvoke >= maxWait) {
-      if (timerId)
-        clearTimeout(timerId);
-      timerId = null;
-      invoke();
-      return;
-    }
-    if (timerId)
-      clearTimeout(timerId);
-    if (shouldInvokeLeading) {
-      invoke();
+export function nixDebounce(fn, delay = 300, options = {}) {
+    let timerId = null;
+    let lastInvokeTime = 0;
+    let lastArgs = null;
+    let lastThis = null;
+    const { leading = false, trailing = true, maxWait, signal } = options;
+    if (signal) {
+        signal.addEventListener("abort", () => {
+            if (timerId) {
+                clearTimeout(timerId);
+                timerId = null;
+            }
+            lastArgs = null;
+            lastThis = null;
+        });
     }
-    if (trailing) {
-      timerId = setTimeout(invoke, remainingTime > 0 ? remainingTime : delay);
-    }
-  }, "debounced");
-  debounced.cancel = () => {
-    if (timerId)
-      clearTimeout(timerId);
-    timerId = lastArgs = lastThis = null;
-  };
-  return debounced;
+    const invoke = () => {
+        lastInvokeTime = Date.now();
+        if (lastArgs) {
+            fn.apply(lastThis, lastArgs);
+            lastArgs = lastThis = null;
+        }
+    };
+    const debounced = function (...args) {
+        const now = Date.now();
+        lastArgs = args;
+        lastThis = this;
+        const shouldInvokeLeading = leading && !timerId;
+        const timeSinceLastInvoke = now - lastInvokeTime;
+        const remainingTime = delay - timeSinceLastInvoke;
+        if (maxWait !== undefined && timeSinceLastInvoke >= maxWait) {
+            if (timerId)
+                clearTimeout(timerId);
+            timerId = null;
+            invoke();
+            return;
+        }
+        if (timerId)
+            clearTimeout(timerId);
+        if (shouldInvokeLeading) {
+            invoke();
+        }
+        if (trailing) {
+            timerId = setTimeout(invoke, remainingTime > 0 ? remainingTime : delay);
+        }
+    };
+    debounced.cancel = () => {
+        if (timerId)
+            clearTimeout(timerId);
+        timerId = null;
+        lastArgs = null;
+        lastThis = null;
+    };
+    return debounced;
 }
-__name(nixDebounce, "nixDebounce");
-export {
-  nixDebounce
-};
-//# sourceMappingURL=nixDebounce.js.map

package/dist/hooks/nixDebounce.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
-  "sources": ["../../hooks/nixDebounce.js"],
-  "sourcesContent": ["/**\r\n * @fileoverview Debounce utility function with advanced options.\r\n * Supports leading/trailing edge invocation, maxWait, and AbortController.\r\n */\r\n\r\n/**\r\n * Debounce a function with options for leading, trailing, maxWait, and AbortController support.\r\n *\r\n * @param {Function} fn - The function to debounce\r\n * @param {number} [delay=300] - Delay in milliseconds\r\n * @param {Object} [options={}] - Debounce options\r\n * @param {boolean} [options.leading=false] - Invoke on the leading edge\r\n * @param {boolean} [options.trailing=true] - Invoke on the trailing edge\r\n * @param {number} [options.maxWait] - Maximum wait time before forced invocation\r\n * @param {AbortSignal} [options.signal] - Optional AbortSignal to cancel pending calls\r\n * @returns {Function} Debounced function with `.cancel()` method\r\n *\r\n * @example\r\n * const controller = new AbortController();\r\n * const debounced = nixDebounce(() => console.log('Hello'), 500, {\r\n *   leading: true,\r\n *   maxWait: 2000,\r\n *   signal: controller.signal\r\n * });\r\n * debounced();\r\n * controller.abort(); // Cancel pending invocation\r\n */\r\nexport function nixDebounce(fn, delay = 300, options = {}) {\r\n  let timerId = null;\r\n  let lastInvokeTime = 0;\r\n  let lastArgs;\r\n  let lastThis;\r\n\r\n  const { leading = false, trailing = true, maxWait, signal } = options;\r\n\r\n  if (signal) {\r\n    signal.addEventListener(\"abort\", () => {\r\n      if (timerId) {\r\n        clearTimeout(timerId);\r\n        timerId = null;\r\n      }\r\n      lastArgs = null;\r\n      lastThis = null;\r\n    });\r\n  }\r\n\r\n  const invoke = () => {\r\n    lastInvokeTime = Date.now();\r\n    if (lastArgs) {\r\n      fn.apply(lastThis, lastArgs);\r\n      lastArgs = lastThis = null;\r\n    }\r\n  };\r\n\r\n  const debounced = function (...args) {\r\n    const now = Date.now();\r\n    lastArgs = args;\r\n    lastThis = this;\r\n\r\n    const shouldInvokeLeading = leading && !timerId;\r\n    const timeSinceLastInvoke = now - lastInvokeTime;\r\n    const remainingTime = delay - timeSinceLastInvoke;\r\n\r\n    if (maxWait !== undefined && timeSinceLastInvoke >= maxWait) {\r\n      if (timerId) clearTimeout(timerId);\r\n      timerId = null;\r\n      invoke();\r\n      return;\r\n    }\r\n\r\n    if (timerId) clearTimeout(timerId);\r\n\r\n    if (shouldInvokeLeading) {\r\n      invoke();\r\n    }\r\n\r\n    if (trailing) {\r\n      timerId = setTimeout(invoke, remainingTime > 0 ? remainingTime : delay);\r\n    }\r\n  };\r\n\r\n  debounced.cancel = () => {\r\n    if (timerId) clearTimeout(timerId);\r\n    timerId = lastArgs = lastThis = null;\r\n  };\r\n\r\n  return debounced;\r\n}\r\n"],
-  "mappings": ";;AA2BO,SAAS,YAAY,IAAI,QAAQ,KAAK,UAAU,CAAC,GAAG;AACzD,MAAI,UAAU;AACd,MAAI,iBAAiB;AACrB,MAAI;AACJ,MAAI;AAEJ,QAAM,EAAE,UAAU,OAAO,WAAW,MAAM,SAAS,OAAO,IAAI;AAE9D,MAAI,QAAQ;AACV,WAAO,iBAAiB,SAAS,MAAM;AACrC,UAAI,SAAS;AACX,qBAAa,OAAO;AACpB,kBAAU;AAAA,MACZ;AACA,iBAAW;AACX,iBAAW;AAAA,IACb,CAAC;AAAA,EACH;AAEA,QAAM,SAAS,6BAAM;AACnB,qBAAiB,KAAK,IAAI;AAC1B,QAAI,UAAU;AACZ,SAAG,MAAM,UAAU,QAAQ;AAC3B,iBAAW,WAAW;AAAA,IACxB;AAAA,EACF,GANe;AAQf,QAAM,YAAY,mCAAa,MAAM;AACnC,UAAM,MAAM,KAAK,IAAI;AACrB,eAAW;AACX,eAAW;AAEX,UAAM,sBAAsB,WAAW,CAAC;AACxC,UAAM,sBAAsB,MAAM;AAClC,UAAM,gBAAgB,QAAQ;AAE9B,QAAI,YAAY,UAAa,uBAAuB,SAAS;AAC3D,UAAI;AAAS,qBAAa,OAAO;AACjC,gBAAU;AACV,aAAO;AACP;AAAA,IACF;AAEA,QAAI;AAAS,mBAAa,OAAO;AAEjC,QAAI,qBAAqB;AACvB,aAAO;AAAA,IACT;AAEA,QAAI,UAAU;AACZ,gBAAU,WAAW,QAAQ,gBAAgB,IAAI,gBAAgB,KAAK;AAAA,IACxE;AAAA,EACF,GAzBkB;AA2BlB,YAAU,SAAS,MAAM;AACvB,QAAI;AAAS,mBAAa,OAAO;AACjC,cAAU,WAAW,WAAW;AAAA,EAClC;AAEA,SAAO;AACT;AA5DgB;",
+  "sources": ["../../hooks/nixDebounce.ts"],
+  "sourcesContent": ["/* MIT License\r\n\r\n* Copyright (c) 2026 Resty Gonzales\r\n\r\nPermission is hereby granted, free of charge, to any person obtaining a copy\r\nof this software and associated documentation files (the \"Software\"), to deal\r\nin the Software without restriction, including without limitation the rights\r\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\r\ncopies of the Software, and to permit persons to whom the Software is\r\nfurnished to do so, subject to the following conditions:\r\n\r\nThe above copyright notice and this permission notice shall be included in all\r\ncopies or substantial portions of the Software.\r\n\r\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\r\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\r\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\r\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\r\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\r\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\r\n* SOFTWARE.\r\n */\r\n/**\r\n * @fileoverview Debounce utility function with advanced options.\r\n * Supports leading/trailing edge invocation, maxWait, and AbortController.\r\n */\r\n\r\n/**\r\n * Debounce a function with options for leading, trailing, maxWait, and AbortController support.\r\n *\r\n * @param {Function} fn - The function to debounce\r\n * @param {number} [delay=300] - Delay in milliseconds\r\n * @param {Object} [options={}] - Debounce options\r\n * @param {boolean} [options.leading=false] - Invoke on the leading edge\r\n * @param {boolean} [options.trailing=true] - Invoke on the trailing edge\r\n * @param {number} [options.maxWait] - Maximum wait time before forced invocation\r\n * @param {AbortSignal} [options.signal] - Optional AbortSignal to cancel pending calls\r\n * @returns {Function} Debounced function with `.cancel()` method\r\n *\r\n * @example\r\n * const controller = new AbortController();\r\n * const debounced = nixDebounce(() => console.log('Hello'), 500, {\r\n *   leading: true,\r\n *   maxWait: 2000,\r\n *   signal: controller.signal\r\n * });\r\n * debounced();\r\n * controller.abort(); // Cancel pending invocation\r\n */\r\nexport interface NixDebounceOptions {\r\n  leading?: boolean;\r\n  trailing?: boolean;\r\n  maxWait?: number;\r\n  signal?: AbortSignal;\r\n}\r\n\r\nexport type DebouncedFunction<T extends (...args: any[]) => any> = ((\r\n  ...args: Parameters<T>\r\n) => void) & {\r\n  cancel: () => void;\r\n};\r\n\r\nexport function nixDebounce<T extends (...args: any[]) => any>(\r\n  fn: T,\r\n  delay: number = 300,\r\n  options: NixDebounceOptions = {}\r\n): DebouncedFunction<T> {\r\n  let timerId: ReturnType<typeof setTimeout> | null = null;\r\n  let lastInvokeTime = 0;\r\n  let lastArgs: Parameters<T> | null = null;\r\n  let lastThis: any = null;\r\n\r\n  const { leading = false, trailing = true, maxWait, signal } = options;\r\n\r\n  if (signal) {\r\n    signal.addEventListener(\"abort\", () => {\r\n      if (timerId) {\r\n        clearTimeout(timerId);\r\n        timerId = null;\r\n      }\r\n      lastArgs = null;\r\n      lastThis = null;\r\n    });\r\n  }\r\n\r\n  const invoke = () => {\r\n    lastInvokeTime = Date.now();\r\n    if (lastArgs) {\r\n      fn.apply(lastThis, lastArgs);\r\n      lastArgs = lastThis = null;\r\n    }\r\n  };\r\n\r\n  const debounced = function (this: unknown, ...args: Parameters<T>) {\r\n    const now = Date.now();\r\n    lastArgs = args;\r\n    lastThis = this;\r\n\r\n    const shouldInvokeLeading = leading && !timerId;\r\n    const timeSinceLastInvoke = now - lastInvokeTime;\r\n    const remainingTime = delay - timeSinceLastInvoke;\r\n\r\n    if (maxWait !== undefined && timeSinceLastInvoke >= maxWait) {\r\n      if (timerId) clearTimeout(timerId);\r\n      timerId = null;\r\n      invoke();\r\n      return;\r\n    }\r\n\r\n    if (timerId) clearTimeout(timerId);\r\n\r\n    if (shouldInvokeLeading) {\r\n      invoke();\r\n    }\r\n\r\n    if (trailing) {\r\n      timerId = setTimeout(invoke, remainingTime > 0 ? remainingTime : delay);\r\n    }\r\n  } as DebouncedFunction<T>;\r\n\r\n  debounced.cancel = () => {\r\n    if (timerId) clearTimeout(timerId);\r\n    timerId = null;\r\n    lastArgs = null;\r\n    lastThis = null;\r\n  };\r\n\r\n  return debounced;\r\n}\r\n"],
+  "mappings": ";;AA8DO,SAAS,YACd,IACA,QAAgB,KAChB,UAA8B,CAAC,GACT;AACtB,MAAI,UAAgD;AACpD,MAAI,iBAAiB;AACrB,MAAI,WAAiC;AACrC,MAAI,WAAgB;AAEpB,QAAM,EAAE,UAAU,OAAO,WAAW,MAAM,SAAS,OAAO,IAAI;AAE9D,MAAI,QAAQ;AACV,WAAO,iBAAiB,SAAS,MAAM;AACrC,UAAI,SAAS;AACX,qBAAa,OAAO;AACpB,kBAAU;AAAA,MACZ;AACA,iBAAW;AACX,iBAAW;AAAA,IACb,CAAC;AAAA,EACH;AAEA,QAAM,SAAS,6BAAM;AACnB,qBAAiB,KAAK,IAAI;AAC1B,QAAI,UAAU;AACZ,SAAG,MAAM,UAAU,QAAQ;AAC3B,iBAAW,WAAW;AAAA,IACxB;AAAA,EACF,GANe;AAQf,QAAM,YAAY,mCAA4B,MAAqB;AACjE,UAAM,MAAM,KAAK,IAAI;AACrB,eAAW;AACX,eAAW;AAEX,UAAM,sBAAsB,WAAW,CAAC;AACxC,UAAM,sBAAsB,MAAM;AAClC,UAAM,gBAAgB,QAAQ;AAE9B,QAAI,YAAY,UAAa,uBAAuB,SAAS;AAC3D,UAAI,QAAS,cAAa,OAAO;AACjC,gBAAU;AACV,aAAO;AACP;AAAA,IACF;AAEA,QAAI,QAAS,cAAa,OAAO;AAEjC,QAAI,qBAAqB;AACvB,aAAO;AAAA,IACT;AAEA,QAAI,UAAU;AACZ,gBAAU,WAAW,QAAQ,gBAAgB,IAAI,gBAAgB,KAAK;AAAA,IACxE;AAAA,EACF,GAzBkB;AA2BlB,YAAU,SAAS,MAAM;AACvB,QAAI,QAAS,cAAa,OAAO;AACjC,cAAU;AACV,eAAW;AACX,eAAW;AAAA,EACb;AAEA,SAAO;AACT;AAlEgB;",
   "names": []
 }

package/dist/hooks/nixEffect.d.ts

@@ -0,0 +1,4 @@
+export declare function nixEffect(effect: () => void | (() => void), deps?: any[]): void;
+export declare function nixEffectOnce(effect: () => void | (() => void)): void;
+export declare function nixEffectAlways(effect: () => void | (() => void)): void;
+//# sourceMappingURL=nixEffect.d.ts.map

package/dist/hooks/nixEffect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nixEffect.d.ts","sourceRoot":"","sources":["../../hooks/nixEffect.ts"],"names":[],"mappings":"AAkEA,wBAAgB,SAAS,CACvB,MAAM,EAAE,MAAM,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,EACjC,IAAI,GAAE,GAAG,EAAO,GACf,IAAI,CAyDN;AAgCD,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAErE;AAaD,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAUvE"}