@fynixorg/ui 1.0.10 → 1.0.12

package/dist/hooks/nixEffect.js

@@ -1,85 +1,75 @@
-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;
-  if (!ctx)
-    throw new Error("nixEffect() called outside component");
-  if (typeof effect !== "function") {
-    console.error("[nixEffect] First argument must be a function");
-    return;
-  }
-  if (!Array.isArray(deps)) {
-    console.error("[nixEffect] Second argument must be an array");
-    deps = [];
-  }
-  const MAX_DEPS = 100;
-  if (deps.length > MAX_DEPS) {
-    console.warn(`[nixEffect] Dependency array too large (${deps.length}). Limited to ${MAX_DEPS}.`);
-    deps = deps.slice(0, MAX_DEPS);
-  }
-  const idx = ctx.hookIndex++;
-  const prev = ctx.hooks[idx];
-  const hasChanged = !prev || !shallowArrayEqual(prev.deps, deps);
-  if (hasChanged) {
-    if (prev?.cleanup) {
-      try {
-        if (typeof prev.cleanup === "function") {
-          prev.cleanup();
-        }
-      } catch (err) {
-        console.error("[nixEffect] Cleanup error:", err);
-      }
+export function nixEffect(effect, deps = []) {
+    const ctx = activeContext;
+    if (!ctx)
+        throw new Error("nixEffect() called outside component");
+    if (typeof effect !== "function") {
+        console.error("[nixEffect] First argument must be a function");
+        return;
+    }
+    if (!Array.isArray(deps)) {
+        console.error("[nixEffect] Second argument must be an array");
+        deps = [];
     }
-    let cleanup;
-    try {
-      cleanup = effect();
-      if (cleanup !== void 0 && typeof cleanup !== "function") {
-        console.warn("[nixEffect] Effect should return undefined or a cleanup function");
-        cleanup = void 0;
-      }
-    } catch (err) {
-      console.error("[nixEffect] Effect error:", err);
-      cleanup = void 0;
+    const MAX_DEPS = 100;
+    if (deps.length > MAX_DEPS) {
+        console.warn(`[nixEffect] Dependency array too large (${deps.length}). Limited to ${MAX_DEPS}.`);
+        deps = deps.slice(0, MAX_DEPS);
     }
-    ctx.hooks[idx] = { deps, cleanup };
-    if (cleanup && typeof cleanup === "function") {
-      if (!ctx.cleanups)
-        ctx.cleanups = [];
-      ctx.cleanups.push(cleanup);
+    const idx = ctx.hookIndex++;
+    const prev = ctx.hooks[idx];
+    const hasChanged = !prev || !shallowArrayEqual(prev.deps, deps);
+    if (hasChanged) {
+        if (prev?.cleanup) {
+            try {
+                if (typeof prev.cleanup === "function") {
+                    prev.cleanup();
+                }
+            }
+            catch (err) {
+                console.error("[nixEffect] Cleanup error:", err);
+            }
+        }
+        let cleanup;
+        try {
+            cleanup = effect();
+            if (cleanup !== undefined && typeof cleanup !== "function") {
+                console.warn("[nixEffect] Effect should return undefined or a cleanup function");
+                cleanup = undefined;
+            }
+        }
+        catch (err) {
+            console.error("[nixEffect] Effect error:", err);
+            cleanup = undefined;
+        }
+        ctx.hooks[idx] = { deps, cleanup };
+        if (cleanup && typeof cleanup === "function") {
+            if (!ctx.cleanups)
+                ctx.cleanups = [];
+            ctx.cleanups.push(cleanup);
+        }
     }
-  }
 }
-__name(nixEffect, "nixEffect");
 function shallowArrayEqual(arr1, arr2) {
-  if (arr1.length !== arr2.length)
-    return false;
-  for (let i = 0; i < arr1.length; i++) {
-    if (!Object.is(arr1[i], arr2[i])) {
-      return false;
+    if (arr1.length !== arr2.length)
+        return false;
+    for (let i = 0; i < arr1.length; i++) {
+        if (!Object.is(arr1[i], arr2[i])) {
+            return false;
+        }
     }
-  }
-  return true;
+    return true;
 }
-__name(shallowArrayEqual, "shallowArrayEqual");
-function nixEffectOnce(effect) {
-  return nixEffect(effect, []);
+export function nixEffectOnce(effect) {
+    return nixEffect(effect, []);
 }
-__name(nixEffectOnce, "nixEffectOnce");
-function nixEffectAlways(effect) {
-  const ctx = activeContext;
-  if (!ctx)
-    throw new Error("nixEffectAlways() called outside component");
-  if (typeof effect !== "function") {
-    console.error("[nixEffectAlways] Argument must be a function");
-    return;
-  }
-  return nixEffect(effect, [ctx.version]);
+export function nixEffectAlways(effect) {
+    const ctx = activeContext;
+    if (!ctx)
+        throw new Error("nixEffectAlways() called outside component");
+    if (typeof effect !== "function") {
+        console.error("[nixEffectAlways] Argument must be a function");
+        return;
+    }
+    return nixEffect(effect, [ctx.version]);
 }
-__name(nixEffectAlways, "nixEffectAlways");
-export {
-  nixEffect,
-  nixEffectAlways,
-  nixEffectOnce
-};
-//# sourceMappingURL=nixEffect.js.map

package/dist/hooks/nixEffect.js.map

@@ -1,7 +1,7 @@
 {
   "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;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;",
+  "sources": ["../../hooks/nixEffect.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    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(\r\n  effect: () => void | (() => void),\r\n  deps: any[] = []\r\n): void {\r\n  const ctx = activeContext as\r\n    | (typeof activeContext & {\r\n        hookIndex: number;\r\n        hooks: Array<any>;\r\n        cleanups?: Array<() => void>;\r\n      })\r\n    | undefined;\r\n  if (!ctx) throw new Error(\"nixEffect() called outside component\");\r\n\r\n  if (typeof effect !== \"function\") {\r\n    console.error(\"[nixEffect] First argument must be a function\");\r\n    return;\r\n  }\r\n  if (!Array.isArray(deps)) {\r\n    console.error(\"[nixEffect] Second argument must be an array\");\r\n    deps = [];\r\n  }\r\n  const MAX_DEPS = 100;\r\n  if (deps.length > MAX_DEPS) {\r\n    console.warn(\r\n      `[nixEffect] Dependency array too large (${deps.length}). Limited to ${MAX_DEPS}.`\r\n    );\r\n    deps = deps.slice(0, MAX_DEPS);\r\n  }\r\n  const idx = ctx.hookIndex++;\r\n  const prev = ctx.hooks[idx];\r\n  const hasChanged = !prev || !shallowArrayEqual(prev.deps, deps);\r\n  if (hasChanged) {\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    let cleanup: void | (() => void);\r\n    try {\r\n      cleanup = effect();\r\n      if (cleanup !== undefined && typeof cleanup !== \"function\") {\r\n        console.warn(\r\n          \"[nixEffect] Effect should return undefined or a cleanup function\"\r\n        );\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    ctx.hooks[idx] = { deps, cleanup };\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: any[], arr2: any[]): boolean {\r\n  if (arr1.length !== arr2.length) return false;\r\n  for (let i = 0; i < arr1.length; i++) {\r\n    if (!Object.is(arr1[i], arr2[i])) {\r\n      return false;\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: () => void | (() => void)): void {\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: () => void | (() => void)): void {\r\n  const ctx = activeContext as\r\n    | (typeof activeContext & { version: any })\r\n    | undefined;\r\n  if (!ctx) throw new Error(\"nixEffectAlways() called outside component\");\r\n  if (typeof effect !== \"function\") {\r\n    console.error(\"[nixEffectAlways] Argument must be a function\");\r\n    return;\r\n  }\r\n  return nixEffect(effect, [ctx.version]);\r\n}\r\n"],
+  "mappings": ";;AA0BA,SAAS,qBAAqB;AAwCvB,SAAS,UACd,QACA,OAAc,CAAC,GACT;AACN,QAAM,MAAM;AAOZ,MAAI,CAAC,IAAK,OAAM,IAAI,MAAM,sCAAsC;AAEhE,MAAI,OAAO,WAAW,YAAY;AAChC,YAAQ,MAAM,+CAA+C;AAC7D;AAAA,EACF;AACA,MAAI,CAAC,MAAM,QAAQ,IAAI,GAAG;AACxB,YAAQ,MAAM,8CAA8C;AAC5D,WAAO,CAAC;AAAA,EACV;AACA,QAAM,WAAW;AACjB,MAAI,KAAK,SAAS,UAAU;AAC1B,YAAQ;AAAA,MACN,2CAA2C,KAAK,MAAM,iBAAiB,QAAQ;AAAA,IACjF;AACA,WAAO,KAAK,MAAM,GAAG,QAAQ;AAAA,EAC/B;AACA,QAAM,MAAM,IAAI;AAChB,QAAM,OAAO,IAAI,MAAM,GAAG;AAC1B,QAAM,aAAa,CAAC,QAAQ,CAAC,kBAAkB,KAAK,MAAM,IAAI;AAC9D,MAAI,YAAY;AACd,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;AACA,QAAI;AACJ,QAAI;AACF,gBAAU,OAAO;AACjB,UAAI,YAAY,UAAa,OAAO,YAAY,YAAY;AAC1D,gBAAQ;AAAA,UACN;AAAA,QACF;AACA,kBAAU;AAAA,MACZ;AAAA,IACF,SAAS,KAAK;AACZ,cAAQ,MAAM,6BAA6B,GAAG;AAC9C,gBAAU;AAAA,IACZ;AACA,QAAI,MAAM,GAAG,IAAI,EAAE,MAAM,QAAQ;AACjC,QAAI,WAAW,OAAO,YAAY,YAAY;AAC5C,UAAI,CAAC,IAAI,SAAU,KAAI,WAAW,CAAC;AACnC,UAAI,SAAS,KAAK,OAAO;AAAA,IAC3B;AAAA,EACF;AACF;AA5DgB;AAsEhB,SAAS,kBAAkB,MAAa,MAAsB;AAC5D,MAAI,KAAK,WAAW,KAAK,OAAQ,QAAO;AACxC,WAAS,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK;AACpC,QAAI,CAAC,OAAO,GAAG,KAAK,CAAC,GAAG,KAAK,CAAC,CAAC,GAAG;AAChC,aAAO;AAAA,IACT;AAAA,EACF;AACA,SAAO;AACT;AARS;AAsBF,SAAS,cAAc,QAAyC;AACrE,SAAO,UAAU,QAAQ,CAAC,CAAC;AAC7B;AAFgB;AAeT,SAAS,gBAAgB,QAAyC;AACvE,QAAM,MAAM;AAGZ,MAAI,CAAC,IAAK,OAAM,IAAI,MAAM,4CAA4C;AACtE,MAAI,OAAO,WAAW,YAAY;AAChC,YAAQ,MAAM,+CAA+C;AAC7D;AAAA,EACF;AACA,SAAO,UAAU,QAAQ,CAAC,IAAI,OAAO,CAAC;AACxC;AAVgB;",
   "names": []
 }

package/dist/hooks/nixForm.d.ts

@@ -0,0 +1,33 @@
+import { nixComputed } from "./nixComputed.js";
+import { nixState } from "./nixState.js";
+type ValidationRule<T> = {
+    required?: boolean;
+    minLength?: number;
+    maxLength?: number;
+    pattern?: RegExp;
+    custom?: (value: any, values: T) => boolean;
+    message?: string;
+};
+type ValidationRules<T> = {
+    [K in keyof T]?: ValidationRule<T>;
+};
+type FormState<T> = {
+    values: ReturnType<typeof nixState<T>>;
+    errors: ReturnType<typeof nixState<Partial<Record<keyof T, string>>>>;
+    touched: ReturnType<typeof nixState<Partial<Record<keyof T, boolean>>>>;
+    isSubmitting: ReturnType<typeof nixState<boolean>>;
+    isValid: ReturnType<typeof nixComputed<boolean>>;
+    handleChange: (fieldName: keyof T, value: any) => void;
+    handleBlur: (fieldName: keyof T) => void;
+    handleSubmit: (onSubmit: (values: T, signal: AbortSignal) => Promise<void>) => Promise<void>;
+    cancelSubmit: () => void;
+    reset: () => void;
+    getFieldProps: (fieldName: keyof T) => {
+        value: any;
+        "r-input": (e: any) => void;
+        "r-blur": () => void;
+    };
+};
+export declare function nixForm<T extends Record<string, any> = Record<string, any>>(initialValues?: T, validationRules?: ValidationRules<T>): FormState<T>;
+export {};
+//# sourceMappingURL=nixForm.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"nixForm.d.ts","sourceRoot":"","sources":["../../hooks/nixForm.ts"],"names":[],"mappings":"AAuBA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,KAAK,cAAc,CAAC,CAAC,IAAI;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,KAAK,OAAO,CAAC;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,KAAK,eAAe,CAAC,CAAC,IAAI;KACvB,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC;CACnC,CAAC;AAEF,KAAK,SAAS,CAAC,CAAC,IAAI;IAClB,MAAM,EAAE,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IACvC,MAAM,EAAE,UAAU,CAAC,OAAO,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IACtE,OAAO,EAAE,UAAU,CAAC,OAAO,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IACxE,YAAY,EAAE,UAAU,CAAC,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;IACnD,OAAO,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC;IACjD,YAAY,EAAE,CAAC,SAAS,EAAE,MAAM,CAAC,EAAE,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC;IACvD,UAAU,EAAE,CAAC,SAAS,EAAE,MAAM,CAAC,KAAK,IAAI,CAAC;IACzC,YAAY,EAAE,CACZ,QAAQ,EAAE,CAAC,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,KACxD,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,YAAY,EAAE,MAAM,IAAI,CAAC;IACzB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,aAAa,EAAE,CAAC,SAAS,EAAE,MAAM,CAAC,KAAK;QACrC,KAAK,EAAE,GAAG,CAAC;QACX,SAAS,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,IAAI,CAAC;QAC5B,QAAQ,EAAE,MAAM,IAAI,CAAC;KACtB,CAAC;CACH,CAAC;AAgBF,wBAAgB,OAAO,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACzE,aAAa,GAAE,CAAW,EAC1B,eAAe,GAAE,eAAe,CAAC,CAAC,CAA4B,GAC7D,SAAS,CAAC,CAAC,CAAC,CA2Id"}

package/dist/hooks/nixForm.js

@@ -1,133 +1,123 @@
-var __defProp = Object.defineProperty;
-var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
-import { nixState } from "./nixState.js";
 import { nixComputed } from "./nixComputed.js";
-function nixForm(initialValues = {}, validationRules = {}) {
-  const values = nixState({ ...initialValues });
-  const errors = nixState({});
-  const touched = nixState({});
-  const isSubmitting = nixState(false);
-  const isValid = nixComputed(() => Object.keys(errors.value).length === 0);
-  let abortController = null;
-  function validate(fieldName, value) {
-    const rules = validationRules[fieldName];
-    if (!rules)
-      return null;
-    if (rules.required && !value) {
-      return rules.message || `${fieldName} is required`;
-    }
-    if (rules.minLength && value.length < rules.minLength) {
-      return rules.message || `${fieldName} must be at least ${rules.minLength} characters`;
-    }
-    if (rules.maxLength && value.length > rules.maxLength) {
-      return rules.message || `${fieldName} must be at most ${rules.maxLength} characters`;
+import { nixState } from "./nixState.js";
+export function nixForm(initialValues = {}, validationRules = {}) {
+    const values = nixState({ ...initialValues });
+    const errors = nixState({});
+    const touched = nixState({});
+    const isSubmitting = nixState(false);
+    const isValid = nixComputed(() => Object.keys(errors.value).length === 0);
+    let abortController = null;
+    function validate(fieldName, value) {
+        const rules = validationRules[fieldName];
+        if (!rules)
+            return null;
+        if (rules.required && !value) {
+            return rules.message || `${String(fieldName)} is required`;
+        }
+        if (rules.minLength && value.length < rules.minLength) {
+            return (rules.message ||
+                `${String(fieldName)} must be at least ${rules.minLength} characters`);
+        }
+        if (rules.maxLength && value.length > rules.maxLength) {
+            return (rules.message ||
+                `${String(fieldName)} must be at most ${rules.maxLength} characters`);
+        }
+        if (rules.pattern && !rules.pattern.test(value)) {
+            return rules.message || `${String(fieldName)} is invalid`;
+        }
+        if (rules.custom && !rules.custom(value, values.value)) {
+            return rules.message || `${String(fieldName)} is invalid`;
+        }
+        return null;
     }
-    if (rules.pattern && !rules.pattern.test(value)) {
-      return rules.message || `${fieldName} is invalid`;
+    function handleChange(fieldName, value) {
+        values.value = { ...values.value, [fieldName]: value };
+        if (touched.value[fieldName]) {
+            const error = validate(fieldName, value);
+            if (error) {
+                errors.value = { ...errors.value, [fieldName]: error };
+            }
+            else {
+                const newErrors = { ...errors.value };
+                delete newErrors[fieldName];
+                errors.value = newErrors;
+            }
+        }
     }
-    if (rules.custom && !rules.custom(value, values.value)) {
-      return rules.message || `${fieldName} is invalid`;
+    function handleBlur(fieldName) {
+        touched.value = { ...touched.value, [fieldName]: true };
+        const error = validate(fieldName, values.value[fieldName]);
+        if (error) {
+            errors.value = { ...errors.value, [fieldName]: error };
+        }
     }
-    return null;
-  }
-  __name(validate, "validate");
-  function handleChange(fieldName, value) {
-    values.value = { ...values.value, [fieldName]: value };
-    if (touched.value[fieldName]) {
-      const error = validate(fieldName, value);
-      if (error) {
-        errors.value = { ...errors.value, [fieldName]: error };
-      } else {
-        const newErrors = { ...errors.value };
-        delete newErrors[fieldName];
+    function validateAll() {
+        const newErrors = {};
+        Object.keys(validationRules).forEach((fieldName) => {
+            const error = validate(fieldName, values.value[fieldName]);
+            if (error)
+                newErrors[fieldName] = error;
+        });
         errors.value = newErrors;
-      }
+        return Object.keys(newErrors).length === 0;
+    }
+    async function handleSubmit(onSubmit) {
+        const allTouched = Object.keys(validationRules).reduce((acc, key) => {
+            acc[key] = true;
+            return acc;
+        }, {});
+        touched.value = allTouched;
+        if (!validateAll())
+            return;
+        if (abortController)
+            abortController.abort();
+        abortController = new AbortController();
+        const signal = abortController.signal;
+        isSubmitting.value = true;
+        try {
+            await onSubmit(values.value, signal);
+        }
+        catch (err) {
+            if (err.name !== "AbortError") {
+                console.error("[nixForm] Submission error:", err);
+            }
+        }
+        finally {
+            if (!signal.aborted)
+                isSubmitting.value = false;
+        }
     }
-  }
-  __name(handleChange, "handleChange");
-  function handleBlur(fieldName) {
-    touched.value = { ...touched.value, [fieldName]: true };
-    const error = validate(fieldName, values.value[fieldName]);
-    if (error) {
-      errors.value = { ...errors.value, [fieldName]: error };
+    function cancelSubmit() {
+        if (abortController) {
+            abortController.abort();
+            abortController = null;
+        }
     }
-  }
-  __name(handleBlur, "handleBlur");
-  function validateAll() {
-    const newErrors = {};
-    Object.keys(validationRules).forEach((fieldName) => {
-      const error = validate(fieldName, values.value[fieldName]);
-      if (error)
-        newErrors[fieldName] = error;
-    });
-    errors.value = newErrors;
-    return Object.keys(newErrors).length === 0;
-  }
-  __name(validateAll, "validateAll");
-  async function handleSubmit(onSubmit) {
-    const allTouched = Object.keys(validationRules).reduce((acc, key) => {
-      acc[key] = true;
-      return acc;
-    }, {});
-    touched.value = allTouched;
-    if (!validateAll())
-      return;
-    if (abortController)
-      abortController.abort();
-    abortController = new AbortController();
-    const signal = abortController.signal;
-    isSubmitting.value = true;
-    try {
-      await onSubmit(values.value, signal);
-    } catch (err) {
-      if (err.name !== "AbortError") {
-        console.error("[nixForm] Submission error:", err);
-      }
-    } finally {
-      if (!signal.aborted)
+    function reset() {
+        values.value = { ...initialValues };
+        errors.value = {};
+        touched.value = {};
         isSubmitting.value = false;
+        cancelSubmit();
     }
-  }
-  __name(handleSubmit, "handleSubmit");
-  function cancelSubmit() {
-    if (abortController) {
-      abortController.abort();
-      abortController = null;
+    function getFieldProps(fieldName) {
+        return {
+            value: values.value[fieldName] || "",
+            "r-input": (e) => handleChange(fieldName, e.target.value),
+            "r-blur": () => handleBlur(fieldName),
+        };
     }
-  }
-  __name(cancelSubmit, "cancelSubmit");
-  function reset() {
-    values.value = { ...initialValues };
-    errors.value = {};
-    touched.value = {};
-    isSubmitting.value = false;
-    cancelSubmit();
-  }
-  __name(reset, "reset");
-  function getFieldProps(fieldName) {
     return {
-      value: values.value[fieldName] || "",
-      "r-input": (e) => handleChange(fieldName, e.target.value),
-      "r-blur": () => handleBlur(fieldName)
+        values,
+        errors,
+        touched,
+        isSubmitting,
+        isValid,
+        handleChange,
+        handleBlur,
+        handleSubmit,
+        cancelSubmit,
+        reset,
+        getFieldProps,
     };
-  }
-  __name(getFieldProps, "getFieldProps");
-  return {
-    values,
-    errors,
-    touched,
-    isSubmitting,
-    isValid,
-    handleChange,
-    handleBlur,
-    handleSubmit,
-    cancelSubmit,
-    reset,
-    getFieldProps
-  };
 }
-__name(nixForm, "nixForm");
-export {
-  nixForm
-};
-//# sourceMappingURL=nixForm.js.map

package/dist/hooks/nixForm.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
-  "sources": ["../../hooks/nixForm.js"],
-  "sourcesContent": ["// core/hooks/nixForm.js - Form handling utilities with memory-safe async support\r\nimport { nixState } from \"./nixState.js\";\r\nimport { nixComputed } from \"./nixComputed.js\";\r\n\r\n/**\r\n * Reactive form handler with validation, reactive state, and safe async submit.\r\n *\r\n * @param {Object} [initialValues={}] - Initial values for form fields.\r\n * @param {Object} [validationRules={}] - Validation rules for fields.\r\n * @returns {Object} Form utilities: values, errors, touched, isSubmitting, isValid,\r\n *   handleChange, handleBlur, handleSubmit, reset, getFieldProps, cancelSubmit\r\n *\r\n * @example\r\n * const form = nixForm({ email: \"\" }, {\r\n *   email: { required: true, pattern: /^\\S+@\\S+$/, message: \"Invalid email\" }\r\n * });\r\n * form.handleSubmit(async (values) => { await api.submit(values); });\r\n */\r\nexport function nixForm(initialValues = {}, validationRules = {}) {\r\n  const values = nixState({ ...initialValues });\r\n  const errors = nixState({});\r\n  const touched = nixState({});\r\n  const isSubmitting = nixState(false);\r\n\r\n  const isValid = nixComputed(() => Object.keys(errors.value).length === 0);\r\n\r\n  let abortController = null;\r\n\r\n  function validate(fieldName, value) {\r\n    const rules = validationRules[fieldName];\r\n    if (!rules) return null;\r\n\r\n    if (rules.required && !value) {\r\n      return rules.message || `${fieldName} is required`;\r\n    }\r\n    if (rules.minLength && value.length < rules.minLength) {\r\n      return rules.message || `${fieldName} must be at least ${rules.minLength} characters`;\r\n    }\r\n    if (rules.maxLength && value.length > rules.maxLength) {\r\n      return rules.message || `${fieldName} must be at most ${rules.maxLength} characters`;\r\n    }\r\n    if (rules.pattern && !rules.pattern.test(value)) {\r\n      return rules.message || `${fieldName} is invalid`;\r\n    }\r\n    if (rules.custom && !rules.custom(value, values.value)) {\r\n      return rules.message || `${fieldName} is invalid`;\r\n    }\r\n    return null;\r\n  }\r\n\r\n  function handleChange(fieldName, value) {\r\n    values.value = { ...values.value, [fieldName]: value };\r\n\r\n    if (touched.value[fieldName]) {\r\n      const error = validate(fieldName, value);\r\n      if (error) {\r\n        errors.value = { ...errors.value, [fieldName]: error };\r\n      } else {\r\n        const newErrors = { ...errors.value };\r\n        delete newErrors[fieldName];\r\n        errors.value = newErrors;\r\n      }\r\n    }\r\n  }\r\n\r\n  function handleBlur(fieldName) {\r\n    touched.value = { ...touched.value, [fieldName]: true };\r\n    const error = validate(fieldName, values.value[fieldName]);\r\n    if (error) {\r\n      errors.value = { ...errors.value, [fieldName]: error };\r\n    }\r\n  }\r\n\r\n  function validateAll() {\r\n    const newErrors = {};\r\n    Object.keys(validationRules).forEach((fieldName) => {\r\n      const error = validate(fieldName, values.value[fieldName]);\r\n      if (error) newErrors[fieldName] = error;\r\n    });\r\n    errors.value = newErrors;\r\n    return Object.keys(newErrors).length === 0;\r\n  }\r\n\r\n  /**\r\n   * Submits the form safely with optional async support.\r\n   * Cancels previous submission if running.\r\n   *\r\n   * @param {(values: Object, signal: AbortSignal) => Promise<void>} onSubmit - Async submit callback.\r\n   */\r\n  async function handleSubmit(onSubmit) {\r\n    // Mark all fields as touched\r\n    const allTouched = Object.keys(validationRules).reduce((acc, key) => {\r\n      acc[key] = true;\r\n      return acc;\r\n    }, {});\r\n    touched.value = allTouched;\r\n\r\n    if (!validateAll()) return;\r\n\r\n    // Cancel any ongoing submit\r\n    if (abortController) abortController.abort();\r\n    abortController = new AbortController();\r\n    const signal = abortController.signal;\r\n\r\n    isSubmitting.value = true;\r\n    try {\r\n      await onSubmit(values.value, signal);\r\n    } catch (err) {\r\n      if (err.name !== \"AbortError\") {\r\n        console.error(\"[nixForm] Submission error:\", err);\r\n      }\r\n    } finally {\r\n      if (!signal.aborted) isSubmitting.value = false;\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Cancels any ongoing async submission.\r\n   */\r\n  function cancelSubmit() {\r\n    if (abortController) {\r\n      abortController.abort();\r\n      abortController = null;\r\n    }\r\n  }\r\n\r\n  function reset() {\r\n    values.value = { ...initialValues };\r\n    errors.value = {};\r\n    touched.value = {};\r\n    isSubmitting.value = false;\r\n    cancelSubmit();\r\n  }\r\n\r\n  function getFieldProps(fieldName) {\r\n    return {\r\n      value: values.value[fieldName] || \"\",\r\n      \"r-input\": (e) => handleChange(fieldName, e.target.value),\r\n      \"r-blur\": () => handleBlur(fieldName),\r\n    };\r\n  }\r\n\r\n  return {\r\n    values,\r\n    errors,\r\n    touched,\r\n    isSubmitting,\r\n    isValid,\r\n    handleChange,\r\n    handleBlur,\r\n    handleSubmit,\r\n    cancelSubmit,\r\n    reset,\r\n    getFieldProps,\r\n  };\r\n}\r\n"],
-  "mappings": ";;AACA,SAAS,gBAAgB;AACzB,SAAS,mBAAmB;AAgBrB,SAAS,QAAQ,gBAAgB,CAAC,GAAG,kBAAkB,CAAC,GAAG;AAChE,QAAM,SAAS,SAAS,EAAE,GAAG,cAAc,CAAC;AAC5C,QAAM,SAAS,SAAS,CAAC,CAAC;AAC1B,QAAM,UAAU,SAAS,CAAC,CAAC;AAC3B,QAAM,eAAe,SAAS,KAAK;AAEnC,QAAM,UAAU,YAAY,MAAM,OAAO,KAAK,OAAO,KAAK,EAAE,WAAW,CAAC;AAExE,MAAI,kBAAkB;AAEtB,WAAS,SAAS,WAAW,OAAO;AAClC,UAAM,QAAQ,gBAAgB,SAAS;AACvC,QAAI,CAAC;AAAO,aAAO;AAEnB,QAAI,MAAM,YAAY,CAAC,OAAO;AAC5B,aAAO,MAAM,WAAW,GAAG,SAAS;AAAA,IACtC;AACA,QAAI,MAAM,aAAa,MAAM,SAAS,MAAM,WAAW;AACrD,aAAO,MAAM,WAAW,GAAG,SAAS,qBAAqB,MAAM,SAAS;AAAA,IAC1E;AACA,QAAI,MAAM,aAAa,MAAM,SAAS,MAAM,WAAW;AACrD,aAAO,MAAM,WAAW,GAAG,SAAS,oBAAoB,MAAM,SAAS;AAAA,IACzE;AACA,QAAI,MAAM,WAAW,CAAC,MAAM,QAAQ,KAAK,KAAK,GAAG;AAC/C,aAAO,MAAM,WAAW,GAAG,SAAS;AAAA,IACtC;AACA,QAAI,MAAM,UAAU,CAAC,MAAM,OAAO,OAAO,OAAO,KAAK,GAAG;AACtD,aAAO,MAAM,WAAW,GAAG,SAAS;AAAA,IACtC;AACA,WAAO;AAAA,EACT;AApBS;AAsBT,WAAS,aAAa,WAAW,OAAO;AACtC,WAAO,QAAQ,EAAE,GAAG,OAAO,OAAO,CAAC,SAAS,GAAG,MAAM;AAErD,QAAI,QAAQ,MAAM,SAAS,GAAG;AAC5B,YAAM,QAAQ,SAAS,WAAW,KAAK;AACvC,UAAI,OAAO;AACT,eAAO,QAAQ,EAAE,GAAG,OAAO,OAAO,CAAC,SAAS,GAAG,MAAM;AAAA,MACvD,OAAO;AACL,cAAM,YAAY,EAAE,GAAG,OAAO,MAAM;AACpC,eAAO,UAAU,SAAS;AAC1B,eAAO,QAAQ;AAAA,MACjB;AAAA,IACF;AAAA,EACF;AAbS;AAeT,WAAS,WAAW,WAAW;AAC7B,YAAQ,QAAQ,EAAE,GAAG,QAAQ,OAAO,CAAC,SAAS,GAAG,KAAK;AACtD,UAAM,QAAQ,SAAS,WAAW,OAAO,MAAM,SAAS,CAAC;AACzD,QAAI,OAAO;AACT,aAAO,QAAQ,EAAE,GAAG,OAAO,OAAO,CAAC,SAAS,GAAG,MAAM;AAAA,IACvD;AAAA,EACF;AANS;AAQT,WAAS,cAAc;AACrB,UAAM,YAAY,CAAC;AACnB,WAAO,KAAK,eAAe,EAAE,QAAQ,CAAC,cAAc;AAClD,YAAM,QAAQ,SAAS,WAAW,OAAO,MAAM,SAAS,CAAC;AACzD,UAAI;AAAO,kBAAU,SAAS,IAAI;AAAA,IACpC,CAAC;AACD,WAAO,QAAQ;AACf,WAAO,OAAO,KAAK,SAAS,EAAE,WAAW;AAAA,EAC3C;AARS;AAgBT,iBAAe,aAAa,UAAU;AAEpC,UAAM,aAAa,OAAO,KAAK,eAAe,EAAE,OAAO,CAAC,KAAK,QAAQ;AACnE,UAAI,GAAG,IAAI;AACX,aAAO;AAAA,IACT,GAAG,CAAC,CAAC;AACL,YAAQ,QAAQ;AAEhB,QAAI,CAAC,YAAY;AAAG;AAGpB,QAAI;AAAiB,sBAAgB,MAAM;AAC3C,sBAAkB,IAAI,gBAAgB;AACtC,UAAM,SAAS,gBAAgB;AAE/B,iBAAa,QAAQ;AACrB,QAAI;AACF,YAAM,SAAS,OAAO,OAAO,MAAM;AAAA,IACrC,SAAS,KAAK;AACZ,UAAI,IAAI,SAAS,cAAc;AAC7B,gBAAQ,MAAM,+BAA+B,GAAG;AAAA,MAClD;AAAA,IACF,UAAE;AACA,UAAI,CAAC,OAAO;AAAS,qBAAa,QAAQ;AAAA,IAC5C;AAAA,EACF;AAzBe;AA8Bf,WAAS,eAAe;AACtB,QAAI,iBAAiB;AACnB,sBAAgB,MAAM;AACtB,wBAAkB;AAAA,IACpB;AAAA,EACF;AALS;AAOT,WAAS,QAAQ;AACf,WAAO,QAAQ,EAAE,GAAG,cAAc;AAClC,WAAO,QAAQ,CAAC;AAChB,YAAQ,QAAQ,CAAC;AACjB,iBAAa,QAAQ;AACrB,iBAAa;AAAA,EACf;AANS;AAQT,WAAS,cAAc,WAAW;AAChC,WAAO;AAAA,MACL,OAAO,OAAO,MAAM,SAAS,KAAK;AAAA,MAClC,WAAW,CAAC,MAAM,aAAa,WAAW,EAAE,OAAO,KAAK;AAAA,MACxD,UAAU,MAAM,WAAW,SAAS;AAAA,IACtC;AAAA,EACF;AANS;AAQT,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;AAzIgB;",
+  "sources": ["../../hooks/nixForm.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// core/hooks/nixForm.js - Form handling utilities with memory-safe async support\r\nimport { nixComputed } from \"./nixComputed.js\";\r\nimport { nixState } from \"./nixState.js\";\r\n\r\ntype ValidationRule<T> = {\r\n  required?: boolean;\r\n  minLength?: number;\r\n  maxLength?: number;\r\n  pattern?: RegExp;\r\n  custom?: (value: any, values: T) => boolean;\r\n  message?: string;\r\n};\r\n\r\ntype ValidationRules<T> = {\r\n  [K in keyof T]?: ValidationRule<T>;\r\n};\r\n\r\ntype FormState<T> = {\r\n  values: ReturnType<typeof nixState<T>>;\r\n  errors: ReturnType<typeof nixState<Partial<Record<keyof T, string>>>>;\r\n  touched: ReturnType<typeof nixState<Partial<Record<keyof T, boolean>>>>;\r\n  isSubmitting: ReturnType<typeof nixState<boolean>>;\r\n  isValid: ReturnType<typeof nixComputed<boolean>>;\r\n  handleChange: (fieldName: keyof T, value: any) => void;\r\n  handleBlur: (fieldName: keyof T) => void;\r\n  handleSubmit: (\r\n    onSubmit: (values: T, signal: AbortSignal) => Promise<void>\r\n  ) => Promise<void>;\r\n  cancelSubmit: () => void;\r\n  reset: () => void;\r\n  getFieldProps: (fieldName: keyof T) => {\r\n    value: any;\r\n    \"r-input\": (e: any) => void;\r\n    \"r-blur\": () => void;\r\n  };\r\n};\r\n\r\n/**\r\n * Reactive form handler with validation, reactive state, and safe async submit.\r\n *\r\n * @param {Object} [initialValues={}] - Initial values for form fields.\r\n * @param {Object} [validationRules={}] - Validation rules for fields.\r\n * @returns {Object} Form utilities: values, errors, touched, isSubmitting, isValid,\r\n *   handleChange, handleBlur, handleSubmit, reset, getFieldProps, cancelSubmit\r\n *\r\n * @example\r\n * const form = nixForm({ email: \"\" }, {\r\n *   email: { required: true, pattern: /^\\S+@\\S+$/, message: \"Invalid email\" }\r\n * });\r\n * form.handleSubmit(async (values) => { await api.submit(values); });\r\n */\r\nexport function nixForm<T extends Record<string, any> = Record<string, any>>(\r\n  initialValues: T = {} as T,\r\n  validationRules: ValidationRules<T> = {} as ValidationRules<T>\r\n): FormState<T> {\r\n  const values = nixState<T>({ ...initialValues });\r\n  const errors = nixState<Partial<Record<keyof T, string>>>({});\r\n  const touched = nixState<Partial<Record<keyof T, boolean>>>({});\r\n  const isSubmitting = nixState<boolean>(false);\r\n\r\n  const isValid = nixComputed<boolean>(\r\n    () => Object.keys(errors.value).length === 0\r\n  );\r\n\r\n  let abortController: AbortController | null = null;\r\n\r\n  function validate(fieldName: keyof T, value: any): string | null {\r\n    const rules = validationRules[fieldName];\r\n    if (!rules) return null;\r\n\r\n    if (rules.required && !value) {\r\n      return rules.message || `${String(fieldName)} is required`;\r\n    }\r\n    if (rules.minLength && value.length < rules.minLength) {\r\n      return (\r\n        rules.message ||\r\n        `${String(fieldName)} must be at least ${rules.minLength} characters`\r\n      );\r\n    }\r\n    if (rules.maxLength && value.length > rules.maxLength) {\r\n      return (\r\n        rules.message ||\r\n        `${String(fieldName)} must be at most ${rules.maxLength} characters`\r\n      );\r\n    }\r\n    if (rules.pattern && !rules.pattern.test(value)) {\r\n      return rules.message || `${String(fieldName)} is invalid`;\r\n    }\r\n    if (rules.custom && !rules.custom(value, values.value)) {\r\n      return rules.message || `${String(fieldName)} is invalid`;\r\n    }\r\n    return null;\r\n  }\r\n\r\n  function handleChange(fieldName: keyof T, value: any): void {\r\n    values.value = { ...values.value, [fieldName]: value };\r\n\r\n    if (touched.value[fieldName]) {\r\n      const error = validate(fieldName, value);\r\n      if (error) {\r\n        errors.value = { ...errors.value, [fieldName]: error };\r\n      } else {\r\n        const newErrors = { ...errors.value };\r\n        delete newErrors[fieldName];\r\n        errors.value = newErrors;\r\n      }\r\n    }\r\n  }\r\n\r\n  function handleBlur(fieldName: keyof T): void {\r\n    touched.value = { ...touched.value, [fieldName]: true };\r\n    const error = validate(fieldName, values.value[fieldName]);\r\n    if (error) {\r\n      errors.value = { ...errors.value, [fieldName]: error };\r\n    }\r\n  }\r\n\r\n  function validateAll(): boolean {\r\n    const newErrors: Partial<Record<keyof T, string>> = {};\r\n    (Object.keys(validationRules) as Array<keyof T>).forEach((fieldName) => {\r\n      const error = validate(fieldName, values.value[fieldName]);\r\n      if (error) newErrors[fieldName] = error;\r\n    });\r\n    errors.value = newErrors;\r\n    return Object.keys(newErrors).length === 0;\r\n  }\r\n\r\n  async function handleSubmit(\r\n    onSubmit: (values: T, signal: AbortSignal) => Promise<void>\r\n  ): Promise<void> {\r\n    const allTouched = (Object.keys(validationRules) as Array<keyof T>).reduce(\r\n      (acc, key) => {\r\n        acc[key] = true;\r\n        return acc;\r\n      },\r\n      {} as Partial<Record<keyof T, boolean>>\r\n    );\r\n    touched.value = allTouched;\r\n\r\n    if (!validateAll()) return;\r\n\r\n    if (abortController) abortController.abort();\r\n    abortController = new AbortController();\r\n    const signal = abortController.signal;\r\n\r\n    isSubmitting.value = true;\r\n    try {\r\n      await onSubmit(values.value, signal);\r\n    } catch (err: any) {\r\n      if (err.name !== \"AbortError\") {\r\n        console.error(\"[nixForm] Submission error:\", err);\r\n      }\r\n    } finally {\r\n      if (!signal.aborted) isSubmitting.value = false;\r\n    }\r\n  }\r\n\r\n  function cancelSubmit(): void {\r\n    if (abortController) {\r\n      abortController.abort();\r\n      abortController = null;\r\n    }\r\n  }\r\n\r\n  function reset(): void {\r\n    values.value = { ...initialValues };\r\n    errors.value = {};\r\n    touched.value = {};\r\n    isSubmitting.value = false;\r\n    cancelSubmit();\r\n  }\r\n\r\n  function getFieldProps(fieldName: keyof T) {\r\n    return {\r\n      value: values.value[fieldName] || \"\",\r\n      \"r-input\": (e: any) => handleChange(fieldName, e.target.value),\r\n      \"r-blur\": () => handleBlur(fieldName),\r\n    };\r\n  }\r\n\r\n  return {\r\n    values,\r\n    errors,\r\n    touched,\r\n    isSubmitting,\r\n    isValid,\r\n    handleChange,\r\n    handleBlur,\r\n    handleSubmit,\r\n    cancelSubmit,\r\n    reset,\r\n    getFieldProps,\r\n  };\r\n}\r\n"],
+  "mappings": ";;AAuBA,SAAS,mBAAmB;AAC5B,SAAS,gBAAgB;AAiDlB,SAAS,QACd,gBAAmB,CAAC,GACpB,kBAAsC,CAAC,GACzB;AACd,QAAM,SAAS,SAAY,EAAE,GAAG,cAAc,CAAC;AAC/C,QAAM,SAAS,SAA2C,CAAC,CAAC;AAC5D,QAAM,UAAU,SAA4C,CAAC,CAAC;AAC9D,QAAM,eAAe,SAAkB,KAAK;AAE5C,QAAM,UAAU;AAAA,IACd,MAAM,OAAO,KAAK,OAAO,KAAK,EAAE,WAAW;AAAA,EAC7C;AAEA,MAAI,kBAA0C;AAE9C,WAAS,SAAS,WAAoB,OAA2B;AAC/D,UAAM,QAAQ,gBAAgB,SAAS;AACvC,QAAI,CAAC,MAAO,QAAO;AAEnB,QAAI,MAAM,YAAY,CAAC,OAAO;AAC5B,aAAO,MAAM,WAAW,GAAG,OAAO,SAAS,CAAC;AAAA,IAC9C;AACA,QAAI,MAAM,aAAa,MAAM,SAAS,MAAM,WAAW;AACrD,aACE,MAAM,WACN,GAAG,OAAO,SAAS,CAAC,qBAAqB,MAAM,SAAS;AAAA,IAE5D;AACA,QAAI,MAAM,aAAa,MAAM,SAAS,MAAM,WAAW;AACrD,aACE,MAAM,WACN,GAAG,OAAO,SAAS,CAAC,oBAAoB,MAAM,SAAS;AAAA,IAE3D;AACA,QAAI,MAAM,WAAW,CAAC,MAAM,QAAQ,KAAK,KAAK,GAAG;AAC/C,aAAO,MAAM,WAAW,GAAG,OAAO,SAAS,CAAC;AAAA,IAC9C;AACA,QAAI,MAAM,UAAU,CAAC,MAAM,OAAO,OAAO,OAAO,KAAK,GAAG;AACtD,aAAO,MAAM,WAAW,GAAG,OAAO,SAAS,CAAC;AAAA,IAC9C;AACA,WAAO;AAAA,EACT;AA1BS;AA4BT,WAAS,aAAa,WAAoB,OAAkB;AAC1D,WAAO,QAAQ,EAAE,GAAG,OAAO,OAAO,CAAC,SAAS,GAAG,MAAM;AAErD,QAAI,QAAQ,MAAM,SAAS,GAAG;AAC5B,YAAM,QAAQ,SAAS,WAAW,KAAK;AACvC,UAAI,OAAO;AACT,eAAO,QAAQ,EAAE,GAAG,OAAO,OAAO,CAAC,SAAS,GAAG,MAAM;AAAA,MACvD,OAAO;AACL,cAAM,YAAY,EAAE,GAAG,OAAO,MAAM;AACpC,eAAO,UAAU,SAAS;AAC1B,eAAO,QAAQ;AAAA,MACjB;AAAA,IACF;AAAA,EACF;AAbS;AAeT,WAAS,WAAW,WAA0B;AAC5C,YAAQ,QAAQ,EAAE,GAAG,QAAQ,OAAO,CAAC,SAAS,GAAG,KAAK;AACtD,UAAM,QAAQ,SAAS,WAAW,OAAO,MAAM,SAAS,CAAC;AACzD,QAAI,OAAO;AACT,aAAO,QAAQ,EAAE,GAAG,OAAO,OAAO,CAAC,SAAS,GAAG,MAAM;AAAA,IACvD;AAAA,EACF;AANS;AAQT,WAAS,cAAuB;AAC9B,UAAM,YAA8C,CAAC;AACrD,IAAC,OAAO,KAAK,eAAe,EAAqB,QAAQ,CAAC,cAAc;AACtE,YAAM,QAAQ,SAAS,WAAW,OAAO,MAAM,SAAS,CAAC;AACzD,UAAI,MAAO,WAAU,SAAS,IAAI;AAAA,IACpC,CAAC;AACD,WAAO,QAAQ;AACf,WAAO,OAAO,KAAK,SAAS,EAAE,WAAW;AAAA,EAC3C;AARS;AAUT,iBAAe,aACb,UACe;AACf,UAAM,aAAc,OAAO,KAAK,eAAe,EAAqB;AAAA,MAClE,CAAC,KAAK,QAAQ;AACZ,YAAI,GAAG,IAAI;AACX,eAAO;AAAA,MACT;AAAA,MACA,CAAC;AAAA,IACH;AACA,YAAQ,QAAQ;AAEhB,QAAI,CAAC,YAAY,EAAG;AAEpB,QAAI,gBAAiB,iBAAgB,MAAM;AAC3C,sBAAkB,IAAI,gBAAgB;AACtC,UAAM,SAAS,gBAAgB;AAE/B,iBAAa,QAAQ;AACrB,QAAI;AACF,YAAM,SAAS,OAAO,OAAO,MAAM;AAAA,IACrC,SAAS,KAAU;AACjB,UAAI,IAAI,SAAS,cAAc;AAC7B,gBAAQ,MAAM,+BAA+B,GAAG;AAAA,MAClD;AAAA,IACF,UAAE;AACA,UAAI,CAAC,OAAO,QAAS,cAAa,QAAQ;AAAA,IAC5C;AAAA,EACF;AA5Be;AA8Bf,WAAS,eAAqB;AAC5B,QAAI,iBAAiB;AACnB,sBAAgB,MAAM;AACtB,wBAAkB;AAAA,IACpB;AAAA,EACF;AALS;AAOT,WAAS,QAAc;AACrB,WAAO,QAAQ,EAAE,GAAG,cAAc;AAClC,WAAO,QAAQ,CAAC;AAChB,YAAQ,QAAQ,CAAC;AACjB,iBAAa,QAAQ;AACrB,iBAAa;AAAA,EACf;AANS;AAQT,WAAS,cAAc,WAAoB;AACzC,WAAO;AAAA,MACL,OAAO,OAAO,MAAM,SAAS,KAAK;AAAA,MAClC,WAAW,wBAAC,MAAW,aAAa,WAAW,EAAE,OAAO,KAAK,GAAlD;AAAA,MACX,UAAU,6BAAM,WAAW,SAAS,GAA1B;AAAA,IACZ;AAAA,EACF;AANS;AAQT,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;AA9IgB;",
   "names": []
 }

package/dist/hooks/nixFormAsync.d.ts

@@ -0,0 +1,42 @@
+import { nixComputed } from "./nixComputed.js";
+import { nixState } from "./nixState.js";
+type ValidationRule<T> = {
+    required?: boolean;
+    minLength?: number;
+    maxLength?: number;
+    pattern?: RegExp;
+    custom?: (value: any, values: T) => boolean;
+    message?: string;
+};
+type ValidationRules<T> = {
+    [K in keyof T]?: ValidationRule<T>;
+};
+type FormAsyncState<T, D = any, E = any> = {
+    values: ReturnType<typeof nixState<T>>;
+    errors: ReturnType<typeof nixState<Partial<Record<keyof T, string>>>>;
+    touched: ReturnType<typeof nixState<Partial<Record<keyof T, boolean>>>>;
+    isSubmitting: ReturnType<typeof nixState<boolean>>;
+    isValid: ReturnType<typeof nixComputed<boolean>>;
+    data: ReturnType<typeof nixState<D | null>>;
+    error: ReturnType<typeof nixState<E | null>>;
+    loading: ReturnType<typeof nixState<boolean>>;
+    handleChange: (fieldName: keyof T, value: any) => void;
+    handleBlur: (fieldName: keyof T) => void;
+    handleSubmit: (onSubmit: (values: T, signal: AbortSignal) => Promise<D>) => void;
+    cancelSubmit: () => void;
+    reset: () => void;
+    getFieldProps: (fieldName: keyof T) => {
+        value: any;
+        "r-input": (e: any) => void;
+        "r-blur": () => void;
+    };
+};
+export declare function nixFormAsync<T extends Record<string, any> = Record<string, any>, D = any, E = any>(initialValues?: T, validationRules?: ValidationRules<T>, options?: {
+    delay?: number;
+    leading?: boolean;
+    trailing?: boolean;
+    maxWait?: number;
+    cache?: boolean;
+}): FormAsyncState<T, D, E>;
+export {};
+//# sourceMappingURL=nixFormAsync.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"nixFormAsync.d.ts","sourceRoot":"","sources":["../../hooks/nixFormAsync.ts"],"names":[],"mappings":"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"}