@fynixorg/ui 1.0.4 → 1.0.6

package/dist/hooks/nixAsyncDebounce.js.map

@@ -2,6 +2,6 @@
   "version": 3,
   "sources": ["../../hooks/nixAsyncDebounce.js"],
   "sourcesContent": ["import { nixState } from \"./nixState\";\r\n\r\n/**\r\n * Debounced and cancellable async data fetcher with caching and deduping.\r\n *\r\n * @param {() => Promise<any>} promiseFactory - Async function that returns a promise.\r\n * @param {Object} [options={}] - Options for debounce, caching, and abort.\r\n * @param {number} [options.delay=300] - Debounce delay in ms.\r\n * @param {boolean} [options.leading=false] - Run on leading edge.\r\n * @param {boolean} [options.trailing=true] - Run on trailing edge.\r\n * @param {number} [options.maxWait] - Max wait time before forced invocation.\r\n * @param {boolean} [options.cache=true] - Enable caching of last result.\r\n * @param {AbortSignal} [options.signal] - Optional AbortSignal to cancel request.\r\n * @returns {Object} { data, error, loading, run, cancel }\r\n *\r\n * @example\r\n * const controller = new AbortController();\r\n * const { data, error, loading, run, cancel } = nixAsyncDebounce(\r\n *   () => fetch('/api/data').then(r => r.json()),\r\n *   { delay: 500, maxWait: 2000, leading: true, signal: controller.signal }\r\n * );\r\n */\r\nexport function nixAsyncDebounce(promiseFactory, options = {}) {\r\n  const data = nixState(null);\r\n  const error = nixState(null);\r\n  const loading = nixState(false);\r\n\r\n  const {\r\n    delay = 300,\r\n    leading = false,\r\n    trailing = true,\r\n    maxWait,\r\n    cache = true,\r\n    signal\r\n  } = options;\r\n\r\n  let lastResult = null;\r\n  let lastError = null;\r\n  let timerId = null;\r\n  let lastInvokeTime = 0;\r\n  let pendingPromise = null;\r\n\r\n  const invoke = async () => {\r\n    if (cache && lastResult !== null) {\r\n      data.value = lastResult;\r\n      error.value = lastError;\r\n      loading.value = false;\r\n      return lastResult;\r\n    }\r\n\r\n    loading.value = true;\r\n    error.value = null;\r\n\r\n    const abortController = new AbortController();\r\n    if (signal) {\r\n      signal.addEventListener(\"abort\", () => {\r\n        abortController.abort();\r\n        cancel();\r\n      });\r\n    }\r\n\r\n    pendingPromise = promiseFactory();\r\n\r\n    try {\r\n      const result = await pendingPromise;\r\n      lastResult = result;\r\n      data.value = result;\r\n      return result;\r\n    } catch (e) {\r\n      if (e.name !== \"AbortError\") {\r\n        lastError = e;\r\n        error.value = e;\r\n      }\r\n      throw e;\r\n    } finally {\r\n      loading.value = false;\r\n      pendingPromise = null;\r\n      lastInvokeTime = Date.now();\r\n    }\r\n  };\r\n\r\n  const run = () => {\r\n    const now = Date.now();\r\n    const timeSinceLastInvoke = now - lastInvokeTime;\r\n    const remainingTime = delay - timeSinceLastInvoke;\r\n\r\n    const shouldInvokeLeading = leading && !timerId;\r\n\r\n    if (maxWait !== undefined && timeSinceLastInvoke >= maxWait) {\r\n      if (timerId) clearTimeout(timerId);\r\n      timerId = null;\r\n      return invoke();\r\n    }\r\n\r\n    if (timerId) clearTimeout(timerId);\r\n\r\n    if (shouldInvokeLeading) return invoke();\r\n\r\n    if (trailing) {\r\n      timerId = setTimeout(() => {\r\n        timerId = null;\r\n        invoke();\r\n      }, remainingTime > 0 ? remainingTime : delay);\r\n    }\r\n  };\r\n\r\n  const cancel = () => {\r\n    if (timerId) clearTimeout(timerId);\r\n    timerId = pendingPromise = null;\r\n  };\r\n\r\n  return { data, error, loading, run, cancel };\r\n}\r\n"],
-  "mappings": "AAAA,SAAS,gBAAgB;AAsBlB,SAAS,iBAAiB,gBAAgB,UAAU,CAAC,GAAG;AAC7D,QAAM,OAAO,SAAS,IAAI;AAC1B,QAAM,QAAQ,SAAS,IAAI;AAC3B,QAAM,UAAU,SAAS,KAAK;AAE9B,QAAM;AAAA,IACJ,QAAQ;AAAA,IACR,UAAU;AAAA,IACV,WAAW;AAAA,IACX;AAAA,IACA,QAAQ;AAAA,IACR;AAAA,EACF,IAAI;AAEJ,MAAI,aAAa;AACjB,MAAI,YAAY;AAChB,MAAI,UAAU;AACd,MAAI,iBAAiB;AACrB,MAAI,iBAAiB;AAErB,QAAM,SAAS,YAAY;AACzB,QAAI,SAAS,eAAe,MAAM;AAChC,WAAK,QAAQ;AACb,YAAM,QAAQ;AACd,cAAQ,QAAQ;AAChB,aAAO;AAAA,IACT;AAEA,YAAQ,QAAQ;AAChB,UAAM,QAAQ;AAEd,UAAM,kBAAkB,IAAI,gBAAgB;AAC5C,QAAI,QAAQ;AACV,aAAO,iBAAiB,SAAS,MAAM;AACrC,wBAAgB,MAAM;AACtB,eAAO;AAAA,MACT,CAAC;AAAA,IACH;AAEA,qBAAiB,eAAe;AAEhC,QAAI;AACF,YAAM,SAAS,MAAM;AACrB,mBAAa;AACb,WAAK,QAAQ;AACb,aAAO;AAAA,IACT,SAAS,GAAG;AACV,UAAI,EAAE,SAAS,cAAc;AAC3B,oBAAY;AACZ,cAAM,QAAQ;AAAA,MAChB;AACA,YAAM;AAAA,IACR,UAAE;AACA,cAAQ,QAAQ;AAChB,uBAAiB;AACjB,uBAAiB,KAAK,IAAI;AAAA,IAC5B;AAAA,EACF;AAEA,QAAM,MAAM,MAAM;AAChB,UAAM,MAAM,KAAK,IAAI;AACrB,UAAM,sBAAsB,MAAM;AAClC,UAAM,gBAAgB,QAAQ;AAE9B,UAAM,sBAAsB,WAAW,CAAC;AAExC,QAAI,YAAY,UAAa,uBAAuB,SAAS;AAC3D,UAAI;AAAS,qBAAa,OAAO;AACjC,gBAAU;AACV,aAAO,OAAO;AAAA,IAChB;AAEA,QAAI;AAAS,mBAAa,OAAO;AAEjC,QAAI;AAAqB,aAAO,OAAO;AAEvC,QAAI,UAAU;AACZ,gBAAU,WAAW,MAAM;AACzB,kBAAU;AACV,eAAO;AAAA,MACT,GAAG,gBAAgB,IAAI,gBAAgB,KAAK;AAAA,IAC9C;AAAA,EACF;AAEA,QAAM,SAAS,MAAM;AACnB,QAAI;AAAS,mBAAa,OAAO;AACjC,cAAU,iBAAiB;AAAA,EAC7B;AAEA,SAAO,EAAE,MAAM,OAAO,SAAS,KAAK,OAAO;AAC7C;",
+  "mappings": ";;AAAA,SAAS,gBAAgB;AAsBlB,SAAS,iBAAiB,gBAAgB,UAAU,CAAC,GAAG;AAC7D,QAAM,OAAO,SAAS,IAAI;AAC1B,QAAM,QAAQ,SAAS,IAAI;AAC3B,QAAM,UAAU,SAAS,KAAK;AAE9B,QAAM;AAAA,IACJ,QAAQ;AAAA,IACR,UAAU;AAAA,IACV,WAAW;AAAA,IACX;AAAA,IACA,QAAQ;AAAA,IACR;AAAA,EACF,IAAI;AAEJ,MAAI,aAAa;AACjB,MAAI,YAAY;AAChB,MAAI,UAAU;AACd,MAAI,iBAAiB;AACrB,MAAI,iBAAiB;AAErB,QAAM,SAAS,mCAAY;AACzB,QAAI,SAAS,eAAe,MAAM;AAChC,WAAK,QAAQ;AACb,YAAM,QAAQ;AACd,cAAQ,QAAQ;AAChB,aAAO;AAAA,IACT;AAEA,YAAQ,QAAQ;AAChB,UAAM,QAAQ;AAEd,UAAM,kBAAkB,IAAI,gBAAgB;AAC5C,QAAI,QAAQ;AACV,aAAO,iBAAiB,SAAS,MAAM;AACrC,wBAAgB,MAAM;AACtB,eAAO;AAAA,MACT,CAAC;AAAA,IACH;AAEA,qBAAiB,eAAe;AAEhC,QAAI;AACF,YAAM,SAAS,MAAM;AACrB,mBAAa;AACb,WAAK,QAAQ;AACb,aAAO;AAAA,IACT,SAAS,GAAG;AACV,UAAI,EAAE,SAAS,cAAc;AAC3B,oBAAY;AACZ,cAAM,QAAQ;AAAA,MAChB;AACA,YAAM;AAAA,IACR,UAAE;AACA,cAAQ,QAAQ;AAChB,uBAAiB;AACjB,uBAAiB,KAAK,IAAI;AAAA,IAC5B;AAAA,EACF,GArCe;AAuCf,QAAM,MAAM,6BAAM;AAChB,UAAM,MAAM,KAAK,IAAI;AACrB,UAAM,sBAAsB,MAAM;AAClC,UAAM,gBAAgB,QAAQ;AAE9B,UAAM,sBAAsB,WAAW,CAAC;AAExC,QAAI,YAAY,UAAa,uBAAuB,SAAS;AAC3D,UAAI;AAAS,qBAAa,OAAO;AACjC,gBAAU;AACV,aAAO,OAAO;AAAA,IAChB;AAEA,QAAI;AAAS,mBAAa,OAAO;AAEjC,QAAI;AAAqB,aAAO,OAAO;AAEvC,QAAI,UAAU;AACZ,gBAAU,WAAW,MAAM;AACzB,kBAAU;AACV,eAAO;AAAA,MACT,GAAG,gBAAgB,IAAI,gBAAgB,KAAK;AAAA,IAC9C;AAAA,EACF,GAvBY;AAyBZ,QAAM,SAAS,6BAAM;AACnB,QAAI;AAAS,mBAAa,OAAO;AACjC,cAAU,iBAAiB;AAAA,EAC7B,GAHe;AAKf,SAAO,EAAE,MAAM,OAAO,SAAS,KAAK,OAAO;AAC7C;AA1FgB;",
   "names": []
 }

package/dist/hooks/nixAsyncQuery.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Unified async query helper with:
+ * - AbortController cancellation
+ * - Request deduping
+ * - Shared caching
+ *
+ * @template T
+ * @param {string} key
+ * Unique cache key representing the request
+ *
+ * @param {(signal: AbortSignal) => Promise<T>} queryFn
+ * Function that performs the async operation
+ *
+ * @param {{
+ *   ttl?: number
+ * }} [options]
+ *
+ * @returns {{
+ *   data: { value: T | null },
+ *   error: { value: Error | null },
+ *   loading: { value: boolean },
+ *   run: () => Promise<void>,
+ *   cancel: () => void
+ * }}
+ */
+export function nixAsyncQuery<T>(key: string, queryFn: (signal: AbortSignal) => Promise<T>, options?: {
+    ttl?: number;
+}): {
+    data: {
+        value: T | null;
+    };
+    error: {
+        value: Error | null;
+    };
+    loading: {
+        value: boolean;
+    };
+    run: () => Promise<void>;
+    cancel: () => void;
+};

package/dist/hooks/nixAsyncQuery.js

@@ -1,3 +1,5 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 import { nixState } from "./nixState";
 const asyncCache = /* @__PURE__ */ new Map();
 function nixAsyncQuery(key, queryFn, options = {}) {
@@ -7,7 +9,7 @@ function nixAsyncQuery(key, queryFn, options = {}) {
   const ttl = options.ttl ?? 0;
   let active = true;
   let callId = 0;
-  const run = async () => {
+  const run = /* @__PURE__ */ __name(async () => {
     const id = ++callId;
     loading.value = true;
     error.value = null;
@@ -62,16 +64,17 @@ function nixAsyncQuery(key, queryFn, options = {}) {
       if (active && id === callId)
         loading.value = false;
     }
-  };
-  const cancel = () => {
+  }, "run");
+  const cancel = /* @__PURE__ */ __name(() => {
     active = false;
     const cached = asyncCache.get(key);
     if (cached?.controller) {
       cached.controller.abort();
     }
-  };
+  }, "cancel");
   return { data, error, loading, run, cancel };
 }
+__name(nixAsyncQuery, "nixAsyncQuery");
 export {
   nixAsyncQuery
 };

package/dist/hooks/nixAsyncQuery.js.map

@@ -2,6 +2,6 @@
   "version": 3,
   "sources": ["../../hooks/nixAsyncQuery.js"],
   "sourcesContent": ["import { nixState } from \"./nixState\";\r\n\r\n/**\r\n * Global async cache.\r\n * key -> {\r\n *   data?: any,\r\n *   error?: Error,\r\n *   promise?: Promise<any>,\r\n *   controller?: AbortController,\r\n *   timestamp?: number\r\n * }\r\n */\r\nconst asyncCache = new Map();\r\n\r\n/**\r\n * Unified async query helper with:\r\n * - AbortController cancellation\r\n * - Request deduping\r\n * - Shared caching\r\n *\r\n * @template T\r\n * @param {string} key\r\n * Unique cache key representing the request\r\n *\r\n * @param {(signal: AbortSignal) => Promise<T>} queryFn\r\n * Function that performs the async operation\r\n *\r\n * @param {{\r\n *   ttl?: number\r\n * }} [options]\r\n *\r\n * @returns {{\r\n *   data: { value: T | null },\r\n *   error: { value: Error | null },\r\n *   loading: { value: boolean },\r\n *   run: () => Promise<void>,\r\n *   cancel: () => void\r\n * }}\r\n */\r\nexport function nixAsyncQuery(key, queryFn, options = {}) {\r\n  const data = nixState(null);\r\n  const error = nixState(null);\r\n  const loading = nixState(false);\r\n\r\n  const ttl = options.ttl ?? 0;\r\n  let active = true;\r\n  let callId = 0;\r\n\r\n  const run = async () => {\r\n    const id = ++callId;\r\n    loading.value = true;\r\n    error.value = null;\r\n\r\n    const now = Date.now();\r\n    const cached = asyncCache.get(key);\r\n\r\n    // Serve fresh cached data\r\n    if (\r\n      cached?.data &&\r\n      (!ttl || now - cached.timestamp < ttl)\r\n    ) {\r\n      data.value = cached.data;\r\n      loading.value = false;\r\n      return;\r\n    }\r\n\r\n    //  Deduping: reuse in-flight request\r\n    if (cached?.promise) {\r\n      try {\r\n        const result = await cached.promise;\r\n        if (!active || id !== callId) return;\r\n        data.value = result;\r\n      } catch (e) {\r\n        if (!active || id !== callId) return;\r\n        error.value = e;\r\n      } finally {\r\n        if (active && id === callId) loading.value = false;\r\n      }\r\n      return;\r\n    }\r\n\r\n    // New request\r\n    const controller = new AbortController();\r\n    const promise = (async () => {\r\n      try {\r\n        const result = await queryFn(controller.signal);\r\n        asyncCache.set(key, {\r\n          data: result,\r\n          timestamp: Date.now()\r\n        });\r\n        return result;\r\n      } catch (e) {\r\n        asyncCache.delete(key);\r\n        throw e instanceof Error ? e : new Error(String(e));\r\n      }\r\n    })();\r\n\r\n    asyncCache.set(key, { promise, controller });\r\n\r\n    try {\r\n      const result = await promise;\r\n      if (!active || id !== callId) return;\r\n      data.value = result;\r\n    } catch (e) {\r\n      if (!active || id !== callId) return;\r\n      error.value = e;\r\n    } finally {\r\n      if (active && id === callId) loading.value = false;\r\n    }\r\n  };\r\n\r\n  /**\r\n   * Cancels in-flight request and prevents state updates.\r\n   */\r\n  const cancel = () => {\r\n    active = false;\r\n    const cached = asyncCache.get(key);\r\n    if (cached?.controller) {\r\n      cached.controller.abort();\r\n    }\r\n  };\r\n\r\n  return { data, error, loading, run, cancel };\r\n}\r\n"],
-  "mappings": "AAAA,SAAS,gBAAgB;AAYzB,MAAM,aAAa,oBAAI,IAAI;AA2BpB,SAAS,cAAc,KAAK,SAAS,UAAU,CAAC,GAAG;AACxD,QAAM,OAAO,SAAS,IAAI;AAC1B,QAAM,QAAQ,SAAS,IAAI;AAC3B,QAAM,UAAU,SAAS,KAAK;AAE9B,QAAM,MAAM,QAAQ,OAAO;AAC3B,MAAI,SAAS;AACb,MAAI,SAAS;AAEb,QAAM,MAAM,YAAY;AACtB,UAAM,KAAK,EAAE;AACb,YAAQ,QAAQ;AAChB,UAAM,QAAQ;AAEd,UAAM,MAAM,KAAK,IAAI;AACrB,UAAM,SAAS,WAAW,IAAI,GAAG;AAGjC,QACE,QAAQ,SACP,CAAC,OAAO,MAAM,OAAO,YAAY,MAClC;AACA,WAAK,QAAQ,OAAO;AACpB,cAAQ,QAAQ;AAChB;AAAA,IACF;AAGA,QAAI,QAAQ,SAAS;AACnB,UAAI;AACF,cAAM,SAAS,MAAM,OAAO;AAC5B,YAAI,CAAC,UAAU,OAAO;AAAQ;AAC9B,aAAK,QAAQ;AAAA,MACf,SAAS,GAAG;AACV,YAAI,CAAC,UAAU,OAAO;AAAQ;AAC9B,cAAM,QAAQ;AAAA,MAChB,UAAE;AACA,YAAI,UAAU,OAAO;AAAQ,kBAAQ,QAAQ;AAAA,MAC/C;AACA;AAAA,IACF;AAGA,UAAM,aAAa,IAAI,gBAAgB;AACvC,UAAM,WAAW,YAAY;AAC3B,UAAI;AACF,cAAM,SAAS,MAAM,QAAQ,WAAW,MAAM;AAC9C,mBAAW,IAAI,KAAK;AAAA,UAClB,MAAM;AAAA,UACN,WAAW,KAAK,IAAI;AAAA,QACtB,CAAC;AACD,eAAO;AAAA,MACT,SAAS,GAAG;AACV,mBAAW,OAAO,GAAG;AACrB,cAAM,aAAa,QAAQ,IAAI,IAAI,MAAM,OAAO,CAAC,CAAC;AAAA,MACpD;AAAA,IACF,GAAG;AAEH,eAAW,IAAI,KAAK,EAAE,SAAS,WAAW,CAAC;AAE3C,QAAI;AACF,YAAM,SAAS,MAAM;AACrB,UAAI,CAAC,UAAU,OAAO;AAAQ;AAC9B,WAAK,QAAQ;AAAA,IACf,SAAS,GAAG;AACV,UAAI,CAAC,UAAU,OAAO;AAAQ;AAC9B,YAAM,QAAQ;AAAA,IAChB,UAAE;AACA,UAAI,UAAU,OAAO;AAAQ,gBAAQ,QAAQ;AAAA,IAC/C;AAAA,EACF;AAKA,QAAM,SAAS,MAAM;AACnB,aAAS;AACT,UAAM,SAAS,WAAW,IAAI,GAAG;AACjC,QAAI,QAAQ,YAAY;AACtB,aAAO,WAAW,MAAM;AAAA,IAC1B;AAAA,EACF;AAEA,SAAO,EAAE,MAAM,OAAO,SAAS,KAAK,OAAO;AAC7C;",
+  "mappings": ";;AAAA,SAAS,gBAAgB;AAYzB,MAAM,aAAa,oBAAI,IAAI;AA2BpB,SAAS,cAAc,KAAK,SAAS,UAAU,CAAC,GAAG;AACxD,QAAM,OAAO,SAAS,IAAI;AAC1B,QAAM,QAAQ,SAAS,IAAI;AAC3B,QAAM,UAAU,SAAS,KAAK;AAE9B,QAAM,MAAM,QAAQ,OAAO;AAC3B,MAAI,SAAS;AACb,MAAI,SAAS;AAEb,QAAM,MAAM,mCAAY;AACtB,UAAM,KAAK,EAAE;AACb,YAAQ,QAAQ;AAChB,UAAM,QAAQ;AAEd,UAAM,MAAM,KAAK,IAAI;AACrB,UAAM,SAAS,WAAW,IAAI,GAAG;AAGjC,QACE,QAAQ,SACP,CAAC,OAAO,MAAM,OAAO,YAAY,MAClC;AACA,WAAK,QAAQ,OAAO;AACpB,cAAQ,QAAQ;AAChB;AAAA,IACF;AAGA,QAAI,QAAQ,SAAS;AACnB,UAAI;AACF,cAAM,SAAS,MAAM,OAAO;AAC5B,YAAI,CAAC,UAAU,OAAO;AAAQ;AAC9B,aAAK,QAAQ;AAAA,MACf,SAAS,GAAG;AACV,YAAI,CAAC,UAAU,OAAO;AAAQ;AAC9B,cAAM,QAAQ;AAAA,MAChB,UAAE;AACA,YAAI,UAAU,OAAO;AAAQ,kBAAQ,QAAQ;AAAA,MAC/C;AACA;AAAA,IACF;AAGA,UAAM,aAAa,IAAI,gBAAgB;AACvC,UAAM,WAAW,YAAY;AAC3B,UAAI;AACF,cAAM,SAAS,MAAM,QAAQ,WAAW,MAAM;AAC9C,mBAAW,IAAI,KAAK;AAAA,UAClB,MAAM;AAAA,UACN,WAAW,KAAK,IAAI;AAAA,QACtB,CAAC;AACD,eAAO;AAAA,MACT,SAAS,GAAG;AACV,mBAAW,OAAO,GAAG;AACrB,cAAM,aAAa,QAAQ,IAAI,IAAI,MAAM,OAAO,CAAC,CAAC;AAAA,MACpD;AAAA,IACF,GAAG;AAEH,eAAW,IAAI,KAAK,EAAE,SAAS,WAAW,CAAC;AAE3C,QAAI;AACF,YAAM,SAAS,MAAM;AACrB,UAAI,CAAC,UAAU,OAAO;AAAQ;AAC9B,WAAK,QAAQ;AAAA,IACf,SAAS,GAAG;AACV,UAAI,CAAC,UAAU,OAAO;AAAQ;AAC9B,YAAM,QAAQ;AAAA,IAChB,UAAE;AACA,UAAI,UAAU,OAAO;AAAQ,gBAAQ,QAAQ;AAAA,IAC/C;AAAA,EACF,GA7DY;AAkEZ,QAAM,SAAS,6BAAM;AACnB,aAAS;AACT,UAAM,SAAS,WAAW,IAAI,GAAG;AACjC,QAAI,QAAQ,YAAY;AACtB,aAAO,WAAW,MAAM;AAAA,IAC1B;AAAA,EACF,GANe;AAQf,SAAO,EAAE,MAAM,OAAO,SAAS,KAAK,OAAO;AAC7C;AApFgB;",
   "names": []
 }

package/dist/hooks/nixCallback.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Memoizes a callback function based on a dependency array.
+ * Similar to React's useCallback.
+ *
+ * @param {Function} fn
+ * Function to memoize. Should be pure and not mutate external state.
+ *
+ * @param {Array<any>} [deps=[]]
+ * Dependency array. Callback identity changes only when deps change.
+ *
+ * @returns {Function}
+ * Memoized callback function.
+ *
+ * @throws {Error}
+ * If called outside of a component context.
+ *
+ * @example
+ * const onClick = nixCallback(() => {
+ *   console.log(count.value);
+ * }, [count.value]);
+ *
+ * @security
+ * - Avoids JSON.stringify to prevent crashes on circular references
+ * - Limits dependency array size to prevent performance abuse
+ *
+ * @memory
+ * - Does not allocate large temporary strings
+ * - Reuses function reference when deps are unchanged
+ */
+export function nixCallback(fn: Function, deps?: Array<any>): Function;

package/dist/hooks/nixCallback.js

@@ -1,3 +1,5 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 import { activeContext } from "../context/context";
 function nixCallback(fn, deps = []) {
   const ctx = activeContext;
@@ -25,6 +27,7 @@ function nixCallback(fn, deps = []) {
   }
   return ctx.hooks[idx].value;
 }
+__name(nixCallback, "nixCallback");
 function shallowArrayEqual(a, b) {
   if (a.length !== b.length)
     return false;
@@ -34,6 +37,7 @@ function shallowArrayEqual(a, b) {
   }
   return true;
 }
+__name(shallowArrayEqual, "shallowArrayEqual");
 export {
   nixCallback
 };

package/dist/hooks/nixCallback.js.map

@@ -2,6 +2,6 @@
   "version": 3,
   "sources": ["../../hooks/nixCallback.js"],
   "sourcesContent": ["import { activeContext } from \"../context/context\";\r\n\r\n/**\r\n * Memoizes a callback function based on a dependency array.\r\n * Similar to React's useCallback.\r\n *\r\n * @param {Function} fn\r\n * Function to memoize. Should be pure and not mutate external state.\r\n *\r\n * @param {Array<any>} [deps=[]]\r\n * Dependency array. Callback identity changes only when deps change.\r\n *\r\n * @returns {Function}\r\n * Memoized callback function.\r\n *\r\n * @throws {Error}\r\n * If called outside of a component context.\r\n *\r\n * @example\r\n * const onClick = nixCallback(() => {\r\n *   console.log(count.value);\r\n * }, [count.value]);\r\n *\r\n * @security\r\n * - Avoids JSON.stringify to prevent crashes on circular references\r\n * - Limits dependency array size to prevent performance abuse\r\n *\r\n * @memory\r\n * - Does not allocate large temporary strings\r\n * - Reuses function reference when deps are unchanged\r\n */\r\nexport function nixCallback(fn, deps = []) {\r\n  const ctx = activeContext;\r\n  if (!ctx) throw new Error(\"nixCallback() called outside component\");\r\n\r\n  if (typeof fn !== \"function\") {\r\n    console.error(\"[nixCallback] First argument must be a function\");\r\n    return fn;\r\n  }\r\n\r\n  if (!Array.isArray(deps)) {\r\n    console.error(\"[nixCallback] Second argument must be an array\");\r\n    deps = [];\r\n  }\r\n\r\n  const MAX_DEPS = 100;\r\n  if (deps.length > MAX_DEPS) {\r\n    console.warn(\r\n      `[nixCallback] Dependency array too large (${deps.length}). Limited to ${MAX_DEPS}.`\r\n    );\r\n    deps = deps.slice(0, MAX_DEPS);\r\n  }\r\n\r\n  const idx = ctx.hookIndex++;\r\n  const prev = ctx.hooks[idx];\r\n\r\n  if (!prev || !shallowArrayEqual(prev.deps, deps)) {\r\n    ctx.hooks[idx] = { value: fn, deps };\r\n  }\r\n\r\n  return ctx.hooks[idx].value;\r\n}\r\n\r\n/**\r\n * Shallow comparison for dependency arrays.\r\n *\r\n * @param {Array<any>} a\r\n * @param {Array<any>} b\r\n * @returns {boolean}\r\n */\r\nfunction shallowArrayEqual(a, b) {\r\n  if (a.length !== b.length) return false;\r\n  for (let i = 0; i < a.length; i++) {\r\n    if (!Object.is(a[i], b[i])) return false;\r\n  }\r\n  return true;\r\n}\r\n"],
-  "mappings": "AAAA,SAAS,qBAAqB;AA+BvB,SAAS,YAAY,IAAI,OAAO,CAAC,GAAG;AACzC,QAAM,MAAM;AACZ,MAAI,CAAC;AAAK,UAAM,IAAI,MAAM,wCAAwC;AAElE,MAAI,OAAO,OAAO,YAAY;AAC5B,YAAQ,MAAM,iDAAiD;AAC/D,WAAO;AAAA,EACT;AAEA,MAAI,CAAC,MAAM,QAAQ,IAAI,GAAG;AACxB,YAAQ,MAAM,gDAAgD;AAC9D,WAAO,CAAC;AAAA,EACV;AAEA,QAAM,WAAW;AACjB,MAAI,KAAK,SAAS,UAAU;AAC1B,YAAQ;AAAA,MACN,6CAA6C,KAAK,MAAM,iBAAiB,QAAQ;AAAA,IACnF;AACA,WAAO,KAAK,MAAM,GAAG,QAAQ;AAAA,EAC/B;AAEA,QAAM,MAAM,IAAI;AAChB,QAAM,OAAO,IAAI,MAAM,GAAG;AAE1B,MAAI,CAAC,QAAQ,CAAC,kBAAkB,KAAK,MAAM,IAAI,GAAG;AAChD,QAAI,MAAM,GAAG,IAAI,EAAE,OAAO,IAAI,KAAK;AAAA,EACrC;AAEA,SAAO,IAAI,MAAM,GAAG,EAAE;AACxB;AASA,SAAS,kBAAkB,GAAG,GAAG;AAC/B,MAAI,EAAE,WAAW,EAAE;AAAQ,WAAO;AAClC,WAAS,IAAI,GAAG,IAAI,EAAE,QAAQ,KAAK;AACjC,QAAI,CAAC,OAAO,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC;AAAG,aAAO;AAAA,EACrC;AACA,SAAO;AACT;",
+  "mappings": ";;AAAA,SAAS,qBAAqB;AA+BvB,SAAS,YAAY,IAAI,OAAO,CAAC,GAAG;AACzC,QAAM,MAAM;AACZ,MAAI,CAAC;AAAK,UAAM,IAAI,MAAM,wCAAwC;AAElE,MAAI,OAAO,OAAO,YAAY;AAC5B,YAAQ,MAAM,iDAAiD;AAC/D,WAAO;AAAA,EACT;AAEA,MAAI,CAAC,MAAM,QAAQ,IAAI,GAAG;AACxB,YAAQ,MAAM,gDAAgD;AAC9D,WAAO,CAAC;AAAA,EACV;AAEA,QAAM,WAAW;AACjB,MAAI,KAAK,SAAS,UAAU;AAC1B,YAAQ;AAAA,MACN,6CAA6C,KAAK,MAAM,iBAAiB,QAAQ;AAAA,IACnF;AACA,WAAO,KAAK,MAAM,GAAG,QAAQ;AAAA,EAC/B;AAEA,QAAM,MAAM,IAAI;AAChB,QAAM,OAAO,IAAI,MAAM,GAAG;AAE1B,MAAI,CAAC,QAAQ,CAAC,kBAAkB,KAAK,MAAM,IAAI,GAAG;AAChD,QAAI,MAAM,GAAG,IAAI,EAAE,OAAO,IAAI,KAAK;AAAA,EACrC;AAEA,SAAO,IAAI,MAAM,GAAG,EAAE;AACxB;AA9BgB;AAuChB,SAAS,kBAAkB,GAAG,GAAG;AAC/B,MAAI,EAAE,WAAW,EAAE;AAAQ,WAAO;AAClC,WAAS,IAAI,GAAG,IAAI,EAAE,QAAQ,KAAK;AACjC,QAAI,CAAC,OAAO,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC;AAAG,aAAO;AAAA,EACrC;AACA,SAAO;AACT;AANS;",
   "names": []
 }

package/dist/hooks/nixComputed.d.ts

@@ -0,0 +1,93 @@
+/**
+ * @template T
+ * @typedef {Object} ComputedState
+ * @property {T} value - Get the computed value (read-only)
+ * @property {(fn: (value: T) => void) => (() => void)} subscribe - Subscribe to computed value changes
+ * @property {() => void} cleanup - Cleanup all subscriptions and dependencies
+ * @property {() => number} getSubscriberCount - Get number of active subscribers (debugging)
+ * @property {() => number} getDependencyCount - Get number of tracked dependencies (debugging)
+ * @property {() => boolean} isDestroyed - Check if computed state has been destroyed
+ * @property {boolean} _isNixState - Internal flag (computed states behave like states)
+ * @property {boolean} _isComputed - Internal flag to identify computed states
+ */
+/**
+ * Create a derived/computed state from other states.
+ * Automatically tracks dependencies and updates when any dependency changes.
+ *
+ * @template T
+ * @param {() => T} computeFn - Function that computes the derived value
+ * @returns {ComputedState<T>} A reactive state object with the computed value
+ *
+ * @example
+ * const count = nixState(5);
+ * const doubled = nixComputed(() => count.value * 2);
+ * console.log(doubled.value); // 10
+ * count.value = 10;
+ * console.log(doubled.value); // 20
+ *
+ * @example
+ * // Multiple dependencies
+ * const a = nixState(5);
+ * const b = nixState(10);
+ * const sum = nixComputed(() => a.value + b.value);
+ * console.log(sum.value); // 15
+ *
+ * @example
+ * // Conditional dependencies
+ * const flag = nixState(true);
+ * const x = nixState(1);
+ * const y = nixState(2);
+ * const result = nixComputed(() => flag.value ? x.value : y.value);
+ *
+ * @example
+ * // With cleanup
+ * const MyComponent = () => {
+ *   const count = nixState(0);
+ *   const doubled = nixComputed(() => count.value * 2);
+ *
+ *   nixEffect(() => {
+ *     return () => {
+ *       doubled.cleanup();
+ *       count.cleanup();
+ *     };
+ *   }, []);
+ * };
+ *
+ * @throws {Error} If called outside a component context
+ * @throws {TypeError} If computeFn is not a function
+ */
+export function nixComputed<T>(computeFn: () => T): ComputedState<T>;
+export type ComputedState<T> = {
+    /**
+     * - Get the computed value (read-only)
+     */
+    value: T;
+    /**
+     * - Subscribe to computed value changes
+     */
+    subscribe: (fn: (value: T) => void) => (() => void);
+    /**
+     * - Cleanup all subscriptions and dependencies
+     */
+    cleanup: () => void;
+    /**
+     * - Get number of active subscribers (debugging)
+     */
+    getSubscriberCount: () => number;
+    /**
+     * - Get number of tracked dependencies (debugging)
+     */
+    getDependencyCount: () => number;
+    /**
+     * - Check if computed state has been destroyed
+     */
+    isDestroyed: () => boolean;
+    /**
+     * - Internal flag (computed states behave like states)
+     */
+    _isNixState: boolean;
+    /**
+     * - Internal flag to identify computed states
+     */
+    _isComputed: boolean;
+};

package/dist/hooks/nixComputed.js

@@ -1,3 +1,5 @@
+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;
@@ -69,6 +71,7 @@ function nixComputed(computeFn) {
       }
       return cachedValue;
     };
+    __name(compute, "compute");
     const subscribers = /* @__PURE__ */ new Set();
     const dependencies = /* @__PURE__ */ new Set();
     const unsubscribers = /* @__PURE__ */ new Map();
@@ -194,6 +197,7 @@ function nixComputed(computeFn) {
   }
   return ctx.hooks[idx];
 }
+__name(nixComputed, "nixComputed");
 export {
   nixComputed
 };

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 * Create a derived/computed state from other states.\r\n * Automatically tracks dependencies and updates when any dependency changes.\r\n * \r\n * @param {() => any} computeFn - Function that computes the derived value\r\n * @returns {ComputedState} A reactive state object with the computed value\r\n * \r\n * @typedef {Object} ComputedState\r\n * @property {any} value - Get the computed value (read-only)\r\n * @property {(fn: Function) => Function} 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 * @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        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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",
+  "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": []
 }

package/dist/hooks/nixDebounce.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @fileoverview Debounce utility function with advanced options.
+ * Supports leading/trailing edge invocation, maxWait, and AbortController.
+ */
+/**
+ * Debounce a function with options for leading, trailing, maxWait, and AbortController support.
+ *
+ * @param {Function} fn - The function to debounce
+ * @param {number} [delay=300] - Delay in milliseconds
+ * @param {Object} [options={}] - Debounce options
+ * @param {boolean} [options.leading=false] - Invoke on the leading edge
+ * @param {boolean} [options.trailing=true] - Invoke on the trailing edge
+ * @param {number} [options.maxWait] - Maximum wait time before forced invocation
+ * @param {AbortSignal} [options.signal] - Optional AbortSignal to cancel pending calls
+ * @returns {Function} Debounced function with `.cancel()` method
+ *
+ * @example
+ * const controller = new AbortController();
+ * const debounced = nixDebounce(() => console.log('Hello'), 500, {
+ *   leading: true,
+ *   maxWait: 2000,
+ *   signal: controller.signal
+ * });
+ * debounced();
+ * controller.abort(); // Cancel pending invocation
+ */
+export function nixDebounce(fn: Function, delay?: number, options?: {
+    leading?: boolean;
+    trailing?: boolean;
+    maxWait?: number;
+    signal?: AbortSignal;
+}): Function;

package/dist/hooks/nixDebounce.js

@@ -1,3 +1,5 @@
+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;
@@ -14,14 +16,14 @@ function nixDebounce(fn, delay = 300, options = {}) {
       lastThis = null;
     });
   }
-  const invoke = () => {
+  const invoke = /* @__PURE__ */ __name(() => {
     lastInvokeTime = Date.now();
     if (lastArgs) {
       fn.apply(lastThis, lastArgs);
       lastArgs = lastThis = null;
     }
-  };
-  const debounced = function(...args) {
+  }, "invoke");
+  const debounced = /* @__PURE__ */ __name(function(...args) {
     const now = Date.now();
     lastArgs = args;
     lastThis = this;
@@ -43,7 +45,7 @@ function nixDebounce(fn, delay = 300, options = {}) {
     if (trailing) {
       timerId = setTimeout(invoke, remainingTime > 0 ? remainingTime : delay);
     }
-  };
+  }, "debounced");
   debounced.cancel = () => {
     if (timerId)
       clearTimeout(timerId);
@@ -51,6 +53,7 @@ function nixDebounce(fn, delay = 300, options = {}) {
   };
   return debounced;
 }
+__name(nixDebounce, "nixDebounce");
 export {
   nixDebounce
 };

package/dist/hooks/nixDebounce.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../hooks/nixDebounce.js"],
-  "sourcesContent": ["/**\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": "AAsBO,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,MAAM;AACnB,qBAAiB,KAAK,IAAI;AAC1B,QAAI,UAAU;AACZ,SAAG,MAAM,UAAU,QAAQ;AAC3B,iBAAW,WAAW;AAAA,IACxB;AAAA,EACF;AAEA,QAAM,YAAY,YAAa,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;AAEA,YAAU,SAAS,MAAM;AACvB,QAAI;AAAS,mBAAa,OAAO;AACjC,cAAU,WAAW,WAAW;AAAA,EAClC;AAEA,SAAO;AACT;",
+  "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;",
   "names": []
 }

package/dist/hooks/nixEffect.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Execute side effects in a component with automatic cleanup.
+ * Similar to React's useEffect.
+ *
+ * @param {() => (void | (() => void))} effect - Effect function, optionally returns cleanup function
+ * @param {Array<any>} [deps=[]] - Dependency array. Effect re-runs when dependencies change.
+ *
+ * @example
+ * // Run once on mount
+ * nixEffect(() => {
+ *   console.log('Component mounted');
+ *   return () => console.log('Component unmounted');
+ * }, []);
+ *
+ * @example
+ * // Run when count changes
+ * const count = nixState(0);
+ * nixEffect(() => {
+ *   console.log('Count is:', count.value);
+ * }, [count.value]);
+ *
+ * @example
+ * // Timer with cleanup
+ * nixEffect(() => {
+ *   const timer = setInterval(() => console.log('tick'), 1000);
+ *   return () => clearInterval(timer);
+ * }, []);
+ *
+ * @example
+ * // Event listener with cleanup
+ * nixEffect(() => {
+ *   const handler = (e) => console.log('clicked', e);
+ *   document.addEventListener('click', handler);
+ *   return () => document.removeEventListener('click', handler);
+ * }, []);
+ *
+ * @throws {Error} If called outside a component context
+ */
+export function nixEffect(effect: () => (void | (() => void)), deps?: Array<any>): void;
+/**
+ * Run an effect only once on component mount.
+ * Convenience wrapper around nixEffect.
+ *
+ * @param {() => (void | (() => void))} effect - Effect function
+ *
+ * @example
+ * nixEffectOnce(() => {
+ *   console.log('Mounted');
+ *   return () => console.log('Unmounted');
+ * });
+ */
+export function nixEffectOnce(effect: () => (void | (() => void))): void;
+/**
+ * Run an effect every time the component renders.
+ * Use with caution - can cause performance issues.
+ *
+ * @param {() => (void | (() => void))} effect - Effect function
+ *
+ * @example
+ * nixEffectAlways(() => {
+ *   console.log('Component rendered');
+ * });
+ */
+export function nixEffectAlways(effect: () => (void | (() => void))): void;

package/dist/hooks/nixEffect.js

@@ -1,3 +1,5 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 import { activeContext } from "../context/context";
 function nixEffect(effect, deps = []) {
   const ctx = activeContext;
@@ -48,6 +50,7 @@ function nixEffect(effect, deps = []) {
     }
   }
 }
+__name(nixEffect, "nixEffect");
 function shallowArrayEqual(arr1, arr2) {
   if (arr1.length !== arr2.length)
     return false;
@@ -58,9 +61,11 @@ function shallowArrayEqual(arr1, arr2) {
   }
   return true;
 }
+__name(shallowArrayEqual, "shallowArrayEqual");
 function nixEffectOnce(effect) {
   return nixEffect(effect, []);
 }
+__name(nixEffectOnce, "nixEffectOnce");
 function nixEffectAlways(effect) {
   const ctx = activeContext;
   if (!ctx)
@@ -71,6 +76,7 @@ function nixEffectAlways(effect) {
   }
   return nixEffect(effect, [ctx.version]);
 }
+__name(nixEffectAlways, "nixEffectAlways");
 export {
   nixEffect,
   nixEffectAlways,

package/dist/hooks/nixEffect.js.map

@@ -2,6 +2,6 @@
   "version": 3,
   "sources": ["../../hooks/nixEffect.js"],
   "sourcesContent": ["/* ----------------------\r\n    nixEffect - Side Effects Hook\r\n    Memory Leaks & Security Issues Resolved\r\n---------------------- */\r\nimport { activeContext } from \"../context/context\";\r\n\r\n/**\r\n * Execute side effects in a component with automatic cleanup.\r\n * Similar to React's useEffect.\r\n * \r\n * @param {() => (void | (() => void))} effect - Effect function, optionally returns cleanup function\r\n * @param {Array<any>} [deps=[]] - Dependency array. Effect re-runs when dependencies change.\r\n * \r\n * @example\r\n * // Run once on mount\r\n * nixEffect(() => {\r\n *   console.log('Component mounted');\r\n *   return () => console.log('Component unmounted');\r\n * }, []);\r\n * \r\n * @example\r\n * // Run when count changes\r\n * const count = nixState(0);\r\n * nixEffect(() => {\r\n *   console.log('Count is:', count.value);\r\n * }, [count.value]);\r\n * \r\n * @example\r\n * // Timer with cleanup\r\n * nixEffect(() => {\r\n *   const timer = setInterval(() => console.log('tick'), 1000);\r\n *   return () => clearInterval(timer);\r\n * }, []);\r\n * \r\n * @example\r\n * // Event listener with cleanup\r\n * nixEffect(() => {\r\n *   const handler = (e) => console.log('clicked', e);\r\n *   document.addEventListener('click', handler);\r\n *   return () => document.removeEventListener('click', handler);\r\n * }, []);\r\n * \r\n * @throws {Error} If called outside a component context\r\n */\r\nexport function nixEffect(effect, deps = []) {\r\n  const ctx = activeContext;\r\n  if (!ctx) throw new Error(\"nixEffect() called outside component\");\r\n\r\n  // Security: Validate effect function\r\n  if (typeof effect !== 'function') {\r\n    console.error('[nixEffect] First argument must be a function');\r\n    return;\r\n  }\r\n\r\n  // Security: Validate deps array\r\n  if (!Array.isArray(deps)) {\r\n    console.error('[nixEffect] Second argument must be an array');\r\n    deps = [];\r\n  }\r\n\r\n  // Security: Limit dependency array size to prevent DOS\r\n  const MAX_DEPS = 100;\r\n  if (deps.length > MAX_DEPS) {\r\n    console.warn(`[nixEffect] Dependency array too large (${deps.length}). Limited to ${MAX_DEPS}.`);\r\n    deps = deps.slice(0, MAX_DEPS);\r\n  }\r\n\r\n  const idx = ctx.hookIndex++;\r\n  const prev = ctx.hooks[idx];\r\n\r\n  // Performance & Security: Deep comparison instead of JSON.stringify\r\n  // JSON.stringify issues:\r\n  // 1. Can throw on circular references\r\n  // 2. Fails on undefined, functions, symbols\r\n  // 3. Performance issue with large objects\r\n  // 4. Security: Can expose internal object structure\r\n  const hasChanged = !prev || !shallowArrayEqual(prev.deps, deps);\r\n\r\n  if (hasChanged) {\r\n    // Memory Leak Fix: Clean up previous effect\r\n    if (prev?.cleanup) {\r\n      try {\r\n        if (typeof prev.cleanup === 'function') {\r\n          prev.cleanup();\r\n        }\r\n      } catch (err) {\r\n        console.error('[nixEffect] Cleanup error:', err);\r\n      }\r\n    }\r\n\r\n    // Run the new effect\r\n    let cleanup;\r\n    try {\r\n      cleanup = effect();\r\n      \r\n      // Validate cleanup return value\r\n      if (cleanup !== undefined && typeof cleanup !== 'function') {\r\n        console.warn('[nixEffect] Effect should return undefined or a cleanup function');\r\n        cleanup = undefined;\r\n      }\r\n    } catch (err) {\r\n      console.error('[nixEffect] Effect error:', err);\r\n      cleanup = undefined;\r\n    }\r\n\r\n    // Store effect data\r\n    ctx.hooks[idx] = { deps, cleanup };\r\n\r\n    // Memory Leak Fix: Track cleanup for component unmount\r\n    if (cleanup && typeof cleanup === 'function') {\r\n      if (!ctx.cleanups) ctx.cleanups = [];\r\n      ctx.cleanups.push(cleanup);\r\n    }\r\n  }\r\n}\r\n\r\n/**\r\n * Shallow comparison of two arrays for dependency checking.\r\n * More reliable and secure than JSON.stringify.\r\n * \r\n * @param {Array<any>} arr1 - First array\r\n * @param {Array<any>} arr2 - Second array\r\n * @returns {boolean} True if arrays are shallowly equal\r\n */\r\nfunction shallowArrayEqual(arr1, arr2) {\r\n  if (arr1.length !== arr2.length) return false;\r\n  \r\n  for (let i = 0; i < arr1.length; i++) {\r\n    // Use Object.is for proper comparison (handles NaN, -0, +0)\r\n    if (!Object.is(arr1[i], arr2[i])) {\r\n      return false;\r\n    }\r\n  }\r\n  \r\n  return true;\r\n}\r\n\r\n/**\r\n * Run an effect only once on component mount.\r\n * Convenience wrapper around nixEffect.\r\n * \r\n * @param {() => (void | (() => void))} effect - Effect function\r\n * \r\n * @example\r\n * nixEffectOnce(() => {\r\n *   console.log('Mounted');\r\n *   return () => console.log('Unmounted');\r\n * });\r\n */\r\nexport function nixEffectOnce(effect) {\r\n  return nixEffect(effect, []);\r\n}\r\n\r\n/**\r\n * Run an effect every time the component renders.\r\n * Use with caution - can cause performance issues.\r\n * \r\n * @param {() => (void | (() => void))} effect - Effect function\r\n * \r\n * @example\r\n * nixEffectAlways(() => {\r\n *   console.log('Component rendered');\r\n * });\r\n */\r\nexport function nixEffectAlways(effect) {\r\n  const ctx = activeContext;\r\n  if (!ctx) throw new Error(\"nixEffectAlways() called outside component\");\r\n  \r\n  if (typeof effect !== 'function') {\r\n    console.error('[nixEffectAlways] Argument must be a function');\r\n    return;\r\n  }\r\n\r\n  // Always run by using a unique dependency each time\r\n  return nixEffect(effect, [ctx.version]);\r\n}"],
-  "mappings": "AAIA,SAAS,qBAAqB;AAwCvB,SAAS,UAAU,QAAQ,OAAO,CAAC,GAAG;AAC3C,QAAM,MAAM;AACZ,MAAI,CAAC;AAAK,UAAM,IAAI,MAAM,sCAAsC;AAGhE,MAAI,OAAO,WAAW,YAAY;AAChC,YAAQ,MAAM,+CAA+C;AAC7D;AAAA,EACF;AAGA,MAAI,CAAC,MAAM,QAAQ,IAAI,GAAG;AACxB,YAAQ,MAAM,8CAA8C;AAC5D,WAAO,CAAC;AAAA,EACV;AAGA,QAAM,WAAW;AACjB,MAAI,KAAK,SAAS,UAAU;AAC1B,YAAQ,KAAK,2CAA2C,KAAK,MAAM,iBAAiB,QAAQ,GAAG;AAC/F,WAAO,KAAK,MAAM,GAAG,QAAQ;AAAA,EAC/B;AAEA,QAAM,MAAM,IAAI;AAChB,QAAM,OAAO,IAAI,MAAM,GAAG;AAQ1B,QAAM,aAAa,CAAC,QAAQ,CAAC,kBAAkB,KAAK,MAAM,IAAI;AAE9D,MAAI,YAAY;AAEd,QAAI,MAAM,SAAS;AACjB,UAAI;AACF,YAAI,OAAO,KAAK,YAAY,YAAY;AACtC,eAAK,QAAQ;AAAA,QACf;AAAA,MACF,SAAS,KAAK;AACZ,gBAAQ,MAAM,8BAA8B,GAAG;AAAA,MACjD;AAAA,IACF;AAGA,QAAI;AACJ,QAAI;AACF,gBAAU,OAAO;AAGjB,UAAI,YAAY,UAAa,OAAO,YAAY,YAAY;AAC1D,gBAAQ,KAAK,kEAAkE;AAC/E,kBAAU;AAAA,MACZ;AAAA,IACF,SAAS,KAAK;AACZ,cAAQ,MAAM,6BAA6B,GAAG;AAC9C,gBAAU;AAAA,IACZ;AAGA,QAAI,MAAM,GAAG,IAAI,EAAE,MAAM,QAAQ;AAGjC,QAAI,WAAW,OAAO,YAAY,YAAY;AAC5C,UAAI,CAAC,IAAI;AAAU,YAAI,WAAW,CAAC;AACnC,UAAI,SAAS,KAAK,OAAO;AAAA,IAC3B;AAAA,EACF;AACF;AAUA,SAAS,kBAAkB,MAAM,MAAM;AACrC,MAAI,KAAK,WAAW,KAAK;AAAQ,WAAO;AAExC,WAAS,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK;AAEpC,QAAI,CAAC,OAAO,GAAG,KAAK,CAAC,GAAG,KAAK,CAAC,CAAC,GAAG;AAChC,aAAO;AAAA,IACT;AAAA,EACF;AAEA,SAAO;AACT;AAcO,SAAS,cAAc,QAAQ;AACpC,SAAO,UAAU,QAAQ,CAAC,CAAC;AAC7B;AAaO,SAAS,gBAAgB,QAAQ;AACtC,QAAM,MAAM;AACZ,MAAI,CAAC;AAAK,UAAM,IAAI,MAAM,4CAA4C;AAEtE,MAAI,OAAO,WAAW,YAAY;AAChC,YAAQ,MAAM,+CAA+C;AAC7D;AAAA,EACF;AAGA,SAAO,UAAU,QAAQ,CAAC,IAAI,OAAO,CAAC;AACxC;",
+  "mappings": ";;AAIA,SAAS,qBAAqB;AAwCvB,SAAS,UAAU,QAAQ,OAAO,CAAC,GAAG;AAC3C,QAAM,MAAM;AACZ,MAAI,CAAC;AAAK,UAAM,IAAI,MAAM,sCAAsC;AAGhE,MAAI,OAAO,WAAW,YAAY;AAChC,YAAQ,MAAM,+CAA+C;AAC7D;AAAA,EACF;AAGA,MAAI,CAAC,MAAM,QAAQ,IAAI,GAAG;AACxB,YAAQ,MAAM,8CAA8C;AAC5D,WAAO,CAAC;AAAA,EACV;AAGA,QAAM,WAAW;AACjB,MAAI,KAAK,SAAS,UAAU;AAC1B,YAAQ,KAAK,2CAA2C,KAAK,MAAM,iBAAiB,QAAQ,GAAG;AAC/F,WAAO,KAAK,MAAM,GAAG,QAAQ;AAAA,EAC/B;AAEA,QAAM,MAAM,IAAI;AAChB,QAAM,OAAO,IAAI,MAAM,GAAG;AAQ1B,QAAM,aAAa,CAAC,QAAQ,CAAC,kBAAkB,KAAK,MAAM,IAAI;AAE9D,MAAI,YAAY;AAEd,QAAI,MAAM,SAAS;AACjB,UAAI;AACF,YAAI,OAAO,KAAK,YAAY,YAAY;AACtC,eAAK,QAAQ;AAAA,QACf;AAAA,MACF,SAAS,KAAK;AACZ,gBAAQ,MAAM,8BAA8B,GAAG;AAAA,MACjD;AAAA,IACF;AAGA,QAAI;AACJ,QAAI;AACF,gBAAU,OAAO;AAGjB,UAAI,YAAY,UAAa,OAAO,YAAY,YAAY;AAC1D,gBAAQ,KAAK,kEAAkE;AAC/E,kBAAU;AAAA,MACZ;AAAA,IACF,SAAS,KAAK;AACZ,cAAQ,MAAM,6BAA6B,GAAG;AAC9C,gBAAU;AAAA,IACZ;AAGA,QAAI,MAAM,GAAG,IAAI,EAAE,MAAM,QAAQ;AAGjC,QAAI,WAAW,OAAO,YAAY,YAAY;AAC5C,UAAI,CAAC,IAAI;AAAU,YAAI,WAAW,CAAC;AACnC,UAAI,SAAS,KAAK,OAAO;AAAA,IAC3B;AAAA,EACF;AACF;AAtEgB;AAgFhB,SAAS,kBAAkB,MAAM,MAAM;AACrC,MAAI,KAAK,WAAW,KAAK;AAAQ,WAAO;AAExC,WAAS,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK;AAEpC,QAAI,CAAC,OAAO,GAAG,KAAK,CAAC,GAAG,KAAK,CAAC,CAAC,GAAG;AAChC,aAAO;AAAA,IACT;AAAA,EACF;AAEA,SAAO;AACT;AAXS;AAyBF,SAAS,cAAc,QAAQ;AACpC,SAAO,UAAU,QAAQ,CAAC,CAAC;AAC7B;AAFgB;AAeT,SAAS,gBAAgB,QAAQ;AACtC,QAAM,MAAM;AACZ,MAAI,CAAC;AAAK,UAAM,IAAI,MAAM,4CAA4C;AAEtE,MAAI,OAAO,WAAW,YAAY;AAChC,YAAQ,MAAM,+CAA+C;AAC7D;AAAA,EACF;AAGA,SAAO,UAAU,QAAQ,CAAC,IAAI,OAAO,CAAC;AACxC;AAXgB;",
   "names": []
 }

package/dist/hooks/nixForm.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Reactive form handler with validation, reactive state, and safe async submit.
+ *
+ * @param {Object} [initialValues={}] - Initial values for form fields.
+ * @param {Object} [validationRules={}] - Validation rules for fields.
+ * @returns {Object} Form utilities: values, errors, touched, isSubmitting, isValid,
+ *   handleChange, handleBlur, handleSubmit, reset, getFieldProps, cancelSubmit
+ *
+ * @example
+ * const form = nixForm({ email: "" }, {
+ *   email: { required: true, pattern: /^\S+@\S+$/, message: "Invalid email" }
+ * });
+ * form.handleSubmit(async (values) => { await api.submit(values); });
+ */
+export function nixForm(initialValues?: any, validationRules?: any): any;