@fynixorg/ui 1.0.4 → 1.0.6

package/dist/build.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/context/context.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Set the active component context.
+ * Called internally by the runtime when entering/exiting component rendering.
+ *
+ * @param {ComponentContext|null} ctx - The component context to set as active, or null to clear
+ * @returns {void}
+ *
+ * @example
+ * // Internal usage in runtime
+ * setActiveContext(componentContext);
+ * const result = Component(props);
+ * setActiveContext(null);
+ */
+export function setActiveContext(ctx: ComponentContext | null): void;
+/**
+ * @fileoverview Component context management for Fynix framework.
+ * Tracks the currently rendering component to enable hooks to access component state.
+ */
+/**
+ * @typedef {Object} ComponentContext
+ * @property {Array<any>} hooks - Array of hook states
+ * @property {number} hookIndex - Current hook index during render
+ * @property {Array<Function>} effects - Array of effect cleanup functions
+ * @property {Array<Function>} cleanups - Array of cleanup functions
+ * @property {Array<Function>} [stateCleanups] - Array of state cleanup functions
+ * @property {Object} _vnode - Associated virtual node
+ * @property {Set<any>} _accessedStates - Set of states accessed during render
+ * @property {Set<any>} _subscriptions - Set of active subscriptions
+ * @property {Array<Function>} _subscriptionCleanups - Array of subscription cleanup functions
+ * @property {number} version - Component version for tracking updates
+ * @property {Function|null} rerender - Function to trigger component re-render
+ * @property {Function} Component - Component function
+ * @property {boolean} _isMounted - Whether component is mounted
+ * @property {boolean} _isRerendering - Whether component is currently re-rendering
+ */
+/**
+ * The currently active component context.
+ * This is set during component rendering to allow hooks to access the component's state.
+ * @type {ComponentContext|null}
+ */
+export let activeContext: ComponentContext | null;
+export type ComponentContext = {
+    /**
+     * - Array of hook states
+     */
+    hooks: Array<any>;
+    /**
+     * - Current hook index during render
+     */
+    hookIndex: number;
+    /**
+     * - Array of effect cleanup functions
+     */
+    effects: Array<Function>;
+    /**
+     * - Array of cleanup functions
+     */
+    cleanups: Array<Function>;
+    /**
+     * - Array of state cleanup functions
+     */
+    stateCleanups?: Array<Function>;
+    /**
+     * - Associated virtual node
+     */
+    _vnode: any;
+    /**
+     * - Set of states accessed during render
+     */
+    _accessedStates: Set<any>;
+    /**
+     * - Set of active subscriptions
+     */
+    _subscriptions: Set<any>;
+    /**
+     * - Array of subscription cleanup functions
+     */
+    _subscriptionCleanups: Array<Function>;
+    /**
+     * - Component version for tracking updates
+     */
+    version: number;
+    /**
+     * - Function to trigger component re-render
+     */
+    rerender: Function | null;
+    /**
+     * - Component function
+     */
+    Component: Function;
+    /**
+     * - Whether component is mounted
+     */
+    _isMounted: boolean;
+    /**
+     * - Whether component is currently re-rendering
+     */
+    _isRerendering: boolean;
+};

package/dist/context/context.js

@@ -1,7 +1,10 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 let activeContext = null;
 function setActiveContext(ctx) {
   activeContext = ctx;
 }
+__name(setActiveContext, "setActiveContext");
 export {
   activeContext,
   setActiveContext

package/dist/context/context.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../context/context.js"],
-  "sourcesContent": ["// runtime/context.js\r\nexport let activeContext = null;\r\n\r\nexport function setActiveContext(ctx) {\r\n  activeContext = ctx;\r\n}\r\n"],
-  "mappings": "AACO,IAAI,gBAAgB;AAEpB,SAAS,iBAAiB,KAAK;AACpC,kBAAgB;AAClB;",
+  "sourcesContent": ["/**\r\n * @fileoverview Component context management for Fynix framework.\r\n * Tracks the currently rendering component to enable hooks to access component state.\r\n */\r\n\r\n/**\r\n * @typedef {Object} ComponentContext\r\n * @property {Array<any>} hooks - Array of hook states\r\n * @property {number} hookIndex - Current hook index during render\r\n * @property {Array<Function>} effects - Array of effect cleanup functions\r\n * @property {Array<Function>} cleanups - Array of cleanup functions\r\n * @property {Array<Function>} [stateCleanups] - Array of state cleanup functions\r\n * @property {Object} _vnode - Associated virtual node\r\n * @property {Set<any>} _accessedStates - Set of states accessed during render\r\n * @property {Set<any>} _subscriptions - Set of active subscriptions\r\n * @property {Array<Function>} _subscriptionCleanups - Array of subscription cleanup functions\r\n * @property {number} version - Component version for tracking updates\r\n * @property {Function|null} rerender - Function to trigger component re-render\r\n * @property {Function} Component - Component function\r\n * @property {boolean} _isMounted - Whether component is mounted\r\n * @property {boolean} _isRerendering - Whether component is currently re-rendering\r\n */\r\n\r\n/**\r\n * The currently active component context.\r\n * This is set during component rendering to allow hooks to access the component's state.\r\n * @type {ComponentContext|null}\r\n */\r\nexport let activeContext = null;\r\n\r\n/**\r\n * Set the active component context.\r\n * Called internally by the runtime when entering/exiting component rendering.\r\n * \r\n * @param {ComponentContext|null} ctx - The component context to set as active, or null to clear\r\n * @returns {void}\r\n * \r\n * @example\r\n * // Internal usage in runtime\r\n * setActiveContext(componentContext);\r\n * const result = Component(props);\r\n * setActiveContext(null);\r\n */\r\nexport function setActiveContext(ctx) {\r\n  activeContext = ctx;\r\n}\r\n"],
+  "mappings": ";;AA4BO,IAAI,gBAAgB;AAepB,SAAS,iBAAiB,KAAK;AACpC,kBAAgB;AAClB;AAFgB;",
   "names": []
 }

package/dist/custom/button.d.ts

@@ -0,0 +1,62 @@
+/**
+ * @typedef {Object} ButtonProps
+ * @property {string} [value=""] - Button text content
+ * @property {string} [type="button"] - Button type (button, submit, reset)
+ * @property {boolean} [disabled=false] - Whether button is disabled
+ * @property {string} [rc] - Reactive class attribute (Fynix-specific)
+ * @property {string} [class] - CSS class names
+ * @property {(this: HTMLElement, event: MouseEvent) => void} [r-click] - Click event handler
+ */
+/**
+ * Button component for Fynix applications.
+ * Renders a native HTML button element with Fynix event handling.
+ *
+ * @param {ButtonProps & Record<string, any>} props - Component props
+ * @returns {VNode} Button element virtual node
+ *
+ * @example
+ * // Basic button
+ * <Button value="Click Me" />
+ *
+ * @example
+ * // With click handler
+ * <Button
+ *   value="Submit"
+ *   r-click={() => console.log('Clicked!')}
+ * />
+ *
+ * @example
+ * // Submit button with styling
+ * <Button
+ *   value="Save"
+ *   type="submit"
+ *   rc="px-4 py-2 bg-blue-500 text-white rounded"
+ * />
+ */
+export function Button({ value, ...props }: ButtonProps & Record<string, any>): VNode;
+export type ButtonProps = {
+    /**
+     * - Button text content
+     */
+    value?: string;
+    /**
+     * - Button type (button, submit, reset)
+     */
+    type?: string;
+    /**
+     * - Whether button is disabled
+     */
+    disabled?: boolean;
+    /**
+     * - Reactive class attribute (Fynix-specific)
+     */
+    rc?: string;
+    /**
+     * - CSS class names
+     */
+    class?: string;
+    /**
+     * - Click event handler
+     */
+    "r-click"?: (this: HTMLElement, event: MouseEvent) => void;
+};

package/dist/custom/button.js

@@ -1,7 +1,10 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 import { Fynix } from "../runtime.js";
 function Button({ value = "", ...props }) {
   return Fynix("button", props, value);
 }
+__name(Button, "Button");
 export {
   Button
 };

package/dist/custom/button.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../custom/button.js"],
-  "sourcesContent": ["import { Fynix } from \"../runtime.js\";\r\n\r\n/**\r\n * @typedef {Object} ButtonProps\r\n * @property {string} [value] - Inner text of the button (default: \"\")\r\n * @property {Record<string, any>} [props] - Other attributes\r\n */\r\n\r\n/**\r\n * @param {ButtonProps} props\r\n */\r\nexport function Button({ value = \"\", ...props }) {\r\n  return Fynix(\"button\", props, value);\r\n}\r\n"],
-  "mappings": "AAAA,SAAS,aAAa;AAWf,SAAS,OAAO,EAAE,QAAQ,IAAI,GAAG,MAAM,GAAG;AAC/C,SAAO,MAAM,UAAU,OAAO,KAAK;AACrC;",
+  "sourcesContent": ["/**\r\n * @fileoverview Button component for Fynix applications.\r\n * Simple wrapper around native button element with Fynix integration.\r\n */\r\n\r\nimport { Fynix } from \"../runtime.js\";\r\n\r\n/**\r\n * @typedef {Object} ButtonProps\r\n * @property {string} [value=\"\"] - Button text content\r\n * @property {string} [type=\"button\"] - Button type (button, submit, reset)\r\n * @property {boolean} [disabled=false] - Whether button is disabled\r\n * @property {string} [rc] - Reactive class attribute (Fynix-specific)\r\n * @property {string} [class] - CSS class names\r\n * @property {(this: HTMLElement, event: MouseEvent) => void} [r-click] - Click event handler\r\n */\r\n\r\n/**\r\n * Button component for Fynix applications.\r\n * Renders a native HTML button element with Fynix event handling.\r\n * \r\n * @param {ButtonProps & Record<string, any>} props - Component props\r\n * @returns {VNode} Button element virtual node\r\n * \r\n * @example\r\n * // Basic button\r\n * <Button value=\"Click Me\" />\r\n * \r\n * @example\r\n * // With click handler\r\n * <Button \r\n *   value=\"Submit\"\r\n *   r-click={() => console.log('Clicked!')}\r\n * />\r\n * \r\n * @example\r\n * // Submit button with styling\r\n * <Button\r\n *   value=\"Save\"\r\n *   type=\"submit\"\r\n *   rc=\"px-4 py-2 bg-blue-500 text-white rounded\"\r\n * />\r\n */\r\nexport function Button({ value = \"\", ...props }) {\r\n  return Fynix(\"button\", props, value);\r\n}\r\n"],
+  "mappings": ";;AAKA,SAAS,aAAa;AAsCf,SAAS,OAAO,EAAE,QAAQ,IAAI,GAAG,MAAM,GAAG;AAC/C,SAAO,MAAM,UAAU,OAAO,KAAK;AACrC;AAFgB;",
   "names": []
 }

package/dist/custom/index.d.ts

@@ -0,0 +1,2 @@
+export { Button } from "./button";
+export { Path } from "./path";

package/dist/custom/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../custom/index.js"],
-  "sourcesContent": ["// core/custom/index.js\r\nexport { Button } from \"./button\";\r\nexport { Path } from \"./path\";\r\n"],
-  "mappings": "AACA,SAAS,cAAc;AACvB,SAAS,YAAY;",
+  "sourcesContent": ["/**\r\n * @fileoverview Custom Fynix components export module.\r\n * Re-exports Button and Path components for convenient importing.\r\n * \r\n * @example\r\n * import { Button, Path } from '@fynixorg/ui/custom';\r\n */\r\n\r\nexport { Button } from \"./button\";\r\nexport { Path } from \"./path\";\r\n"],
+  "mappings": "AAQA,SAAS,cAAc;AACvB,SAAS,YAAY;",
   "names": []
 }

package/dist/custom/path.d.ts

@@ -0,0 +1,71 @@
+/**
+ * SPA navigation link component for Fynix router.
+ * Automatically handles client-side navigation and prop passing between routes.
+ *
+ * @param {PathProps & Record<string, any>} options - Component props
+ * @returns {VNode} Anchor element virtual node
+ *
+ * @example
+ * // Basic navigation
+ * <Path to="/about" value="About Us" />
+ *
+ * @example
+ * // Navigate with props
+ * <Path
+ *   to="/user/123"
+ *   value="View Profile"
+ *   props={{ userId: 123, fromSearch: true }}
+ * />
+ *
+ * @example
+ * // External link
+ * <Path
+ *   to="https://github.com"
+ *   value="GitHub"
+ *   target="_blank"
+ *   rel="noopener noreferrer"
+ * />
+ *
+ * @example
+ * // With styling
+ * <Path
+ *   to="/dashboard"
+ *   value="Dashboard"
+ *   rc="px-4 py-2 bg-blue-500 text-white rounded"
+ * />
+ */
+export function Path({ to, value, props: routeProps, ...attrs }: PathProps & Record<string, any>): VNode;
+export type PathProps = {
+    /**
+     * - URL to navigate to (relative or absolute)
+     */
+    to?: string;
+    /**
+     * - Link text content
+     */
+    value?: string;
+    /**
+     * - Props to pass to the destination route component
+     */
+    props?: Record<string, any>;
+    /**
+     * - Link target (_blank, _self, etc.)
+     */
+    target?: string;
+    /**
+     * - Link relationship (noopener, noreferrer, etc.)
+     */
+    rel?: string;
+    /**
+     * - Reactive class attribute (Fynix-specific)
+     */
+    rc?: string;
+    /**
+     * - CSS class names
+     */
+    class?: string;
+    /**
+     * - Element ID
+     */
+    id?: string;
+};

package/dist/custom/path.js

@@ -1,3 +1,5 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 import { Fynix, nixState } from "../runtime.js";
 let propsCounter = 0;
 function Path({
@@ -28,6 +30,7 @@ function Path({
   );
   return el;
 }
+__name(Path, "Path");
 export {
   Path
 };

package/dist/custom/path.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../custom/path.js"],
-  "sourcesContent": ["import { Fynix, nixState } from \"../runtime.js\";\r\n\r\n/**\r\n * @typedef {Object} PathProps\r\n * @property {string} [to] - URL to navigate to\r\n * @property {string} [value] - Link text\r\n * @property {Object} [props] - Props to pass to the next route\r\n */\r\n\r\n/** Unique counter for props keys */\r\nlet propsCounter = 0;\r\n\r\n/**\r\n * SPA navigation link for Fynix router\r\n * @param {PathProps & Record<string, any>} options\r\n * @returns {HTMLElement} anchor element\r\n */\r\nexport function Path({\r\n  to = \"#\",\r\n  value = \"\",\r\n  props: routeProps = {},\r\n  ...attrs\r\n}) {\r\n  ///console.log(\"[Path Component] Received routeProps:\", routeProps);\r\n\r\n  // Wrap plain props in nixState if not already\r\n  const wrappedProps = {};\r\n  for (const [k, v] of Object.entries(routeProps)) {\r\n    wrappedProps[k] = v && v._isNixState ? v : nixState(v);\r\n  }\r\n\r\n  // Generate a unique key for this props object\r\n  // FIX: Do not use __ prefix as router blocks it for security\r\n  const propsKey = `fynixProp_${Date.now()}_${propsCounter++}`;\r\n  \r\n  // FIX: Store props in the namespace expected by the router\r\n  if (!window.__fynixLinkProps__) {\r\n    window.__fynixLinkProps__ = {};\r\n  }\r\n  \r\n  // Debug log\r\n // console.log(\"[Path] Storage props:\", propsKey, wrappedProps);\r\n  \r\n  window.__fynixLinkProps__[propsKey] = wrappedProps;\r\n\r\n  // Create the anchor element\r\n  const el = Fynix(\r\n    \"a\",\r\n    {\r\n      href: to,\r\n      \"data-fynix-link\": true, // SPA link detection\r\n      \"data-props-key\": propsKey,\r\n      ...attrs,\r\n    },\r\n    value\r\n  );\r\n\r\n  return el;\r\n}\r\n"],
-  "mappings": "AAAA,SAAS,OAAO,gBAAgB;AAUhC,IAAI,eAAe;AAOZ,SAAS,KAAK;AAAA,EACnB,KAAK;AAAA,EACL,QAAQ;AAAA,EACR,OAAO,aAAa,CAAC;AAAA,EACrB,GAAG;AACL,GAAG;AAID,QAAM,eAAe,CAAC;AACtB,aAAW,CAAC,GAAG,CAAC,KAAK,OAAO,QAAQ,UAAU,GAAG;AAC/C,iBAAa,CAAC,IAAI,KAAK,EAAE,cAAc,IAAI,SAAS,CAAC;AAAA,EACvD;AAIA,QAAM,WAAW,aAAa,KAAK,IAAI,CAAC,IAAI,cAAc;AAG1D,MAAI,CAAC,OAAO,oBAAoB;AAC9B,WAAO,qBAAqB,CAAC;AAAA,EAC/B;AAKA,SAAO,mBAAmB,QAAQ,IAAI;AAGtC,QAAM,KAAK;AAAA,IACT;AAAA,IACA;AAAA,MACE,MAAM;AAAA,MACN,mBAAmB;AAAA;AAAA,MACnB,kBAAkB;AAAA,MAClB,GAAG;AAAA,IACL;AAAA,IACA;AAAA,EACF;AAEA,SAAO;AACT;",
+  "sourcesContent": ["/**\r\n * @fileoverview Path component for SPA navigation in Fynix applications.\r\n * Provides client-side routing with prop passing between routes.\r\n */\r\n\r\nimport { Fynix, nixState } from \"../runtime.js\";\r\n\r\n/**\r\n * @typedef {Object} PathProps\r\n * @property {string} [to=\"#\"] - URL to navigate to (relative or absolute)\r\n * @property {string} [value=\"\"] - Link text content\r\n * @property {Record<string, any>} [props={}] - Props to pass to the destination route component\r\n * @property {string} [target] - Link target (_blank, _self, etc.)\r\n * @property {string} [rel] - Link relationship (noopener, noreferrer, etc.)\r\n * @property {string} [rc] - Reactive class attribute (Fynix-specific)\r\n * @property {string} [class] - CSS class names\r\n * @property {string} [id] - Element ID\r\n */\r\n\r\n/** Unique counter for props keys */\r\nlet propsCounter = 0;\r\n\r\n/**\r\n * SPA navigation link component for Fynix router.\r\n * Automatically handles client-side navigation and prop passing between routes.\r\n * \r\n * @param {PathProps & Record<string, any>} options - Component props\r\n * @returns {VNode} Anchor element virtual node\r\n * \r\n * @example\r\n * // Basic navigation\r\n * <Path to=\"/about\" value=\"About Us\" />\r\n * \r\n * @example\r\n * // Navigate with props\r\n * <Path \r\n *   to=\"/user/123\" \r\n *   value=\"View Profile\"\r\n *   props={{ userId: 123, fromSearch: true }}\r\n * />\r\n * \r\n * @example\r\n * // External link\r\n * <Path\r\n *   to=\"https://github.com\"\r\n *   value=\"GitHub\"\r\n *   target=\"_blank\"\r\n *   rel=\"noopener noreferrer\"\r\n * />\r\n * \r\n * @example\r\n * // With styling\r\n * <Path\r\n *   to=\"/dashboard\"\r\n *   value=\"Dashboard\"\r\n *   rc=\"px-4 py-2 bg-blue-500 text-white rounded\"\r\n * />\r\n */\r\nexport function Path({\r\n  to = \"#\",\r\n  value = \"\",\r\n  props: routeProps = {},\r\n  ...attrs\r\n}) {\r\n  ///console.log(\"[Path Component] Received routeProps:\", routeProps);\r\n\r\n  // Wrap plain props in nixState if not already\r\n  const wrappedProps = {};\r\n  for (const [k, v] of Object.entries(routeProps)) {\r\n    wrappedProps[k] = v && v._isNixState ? v : nixState(v);\r\n  }\r\n\r\n  // Generate a unique key for this props object\r\n  // FIX: Do not use __ prefix as router blocks it for security\r\n  const propsKey = `fynixProp_${Date.now()}_${propsCounter++}`;\r\n\r\n  // FIX: Store props in the namespace expected by the router\r\n  if (!window.__fynixLinkProps__) {\r\n    window.__fynixLinkProps__ = {};\r\n  }\r\n\r\n  // Debug log\r\n  // console.log(\"[Path] Storage props:\", propsKey, wrappedProps);\r\n\r\n  window.__fynixLinkProps__[propsKey] = wrappedProps;\r\n\r\n  // Create the anchor element\r\n  const el = Fynix(\r\n    \"a\",\r\n    {\r\n      href: to,\r\n      \"data-fynix-link\": true, // SPA link detection\r\n      \"data-props-key\": propsKey,\r\n      ...attrs,\r\n    },\r\n    value\r\n  );\r\n\r\n  return el;\r\n}\r\n"],
+  "mappings": ";;AAKA,SAAS,OAAO,gBAAgB;AAehC,IAAI,eAAe;AAsCZ,SAAS,KAAK;AAAA,EACnB,KAAK;AAAA,EACL,QAAQ;AAAA,EACR,OAAO,aAAa,CAAC;AAAA,EACrB,GAAG;AACL,GAAG;AAID,QAAM,eAAe,CAAC;AACtB,aAAW,CAAC,GAAG,CAAC,KAAK,OAAO,QAAQ,UAAU,GAAG;AAC/C,iBAAa,CAAC,IAAI,KAAK,EAAE,cAAc,IAAI,SAAS,CAAC;AAAA,EACvD;AAIA,QAAM,WAAW,aAAa,KAAK,IAAI,CAAC,IAAI,cAAc;AAG1D,MAAI,CAAC,OAAO,oBAAoB;AAC9B,WAAO,qBAAqB,CAAC;AAAA,EAC/B;AAKA,SAAO,mBAAmB,QAAQ,IAAI;AAGtC,QAAM,KAAK;AAAA,IACT;AAAA,IACA;AAAA,MACE,MAAM;AAAA,MACN,mBAAmB;AAAA;AAAA,MACnB,kBAAkB;AAAA,MAClB,GAAG;AAAA,IACL;AAAA,IACA;AAAA,EACF;AAEA,SAAO;AACT;AAzCgB;",
   "names": []
 }

package/dist/error/errorOverlay.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @fileoverview Development error overlay for Fynix applications.
+ * Displays runtime errors in a user-friendly overlay during development.
+ */
+/**
+ * Display an error overlay with error details.
+ * Shows error message, stack trace, and a close button.
+ *
+ * @param {Error} error - The error object to display
+ * @returns {void}
+ *
+ * @example
+ * try {
+ *   // some code
+ * } catch (err) {
+ *   showErrorOverlay(err);
+ * }
+ */
+export function showErrorOverlay(error: Error): void;
+/**
+ * Remove the error overlay from the DOM.
+ * Fades out the overlay before removing it.
+ *
+ * @returns {void}
+ */
+export function removeErrorOverlay(): void;

package/dist/error/errorOverlay.js

@@ -1,3 +1,5 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 function showErrorOverlay(error) {
   removeErrorOverlay();
   const overlay = document.createElement("div");
@@ -75,6 +77,7 @@ function showErrorOverlay(error) {
   });
   console.error("FynixJS Runtime Error]", error);
 }
+__name(showErrorOverlay, "showErrorOverlay");
 function removeErrorOverlay() {
   const existing = document.getElementById("dev-error-overlay");
   if (existing) {
@@ -82,6 +85,7 @@ function removeErrorOverlay() {
     setTimeout(() => existing.remove(), 200);
   }
 }
+__name(removeErrorOverlay, "removeErrorOverlay");
 export {
   removeErrorOverlay,
   showErrorOverlay

package/dist/error/errorOverlay.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../error/errorOverlay.js"],
-  "sourcesContent": ["// errorOverlay.js\r\nexport function showErrorOverlay(error) {\r\n  removeErrorOverlay();\r\n\r\n  const overlay = document.createElement(\"div\");\r\n  overlay.id = \"dev-error-overlay\";\r\n  Object.assign(overlay.style, {\r\n    position: \"fixed\",\r\n    inset: 0,\r\n    width: \"100%\",\r\n    height: \"100%\",\r\n    backgroundColor: \"rgba(0, 0, 0, 0.9)\",\r\n    color: \"#fff\",\r\n    fontFamily: \"Consolas, monospace\",\r\n    padding: \"30px\",\r\n    zIndex: 99999,\r\n    overflowY: \"auto\",\r\n    transition: \"opacity 0.25s ease\",\r\n    opacity: \"0\",\r\n  });\r\n\r\n  const container = document.createElement(\"div\");\r\n  container.style.position = \"relative\"; // important for absolute button\r\n  container.style.maxWidth = \"900px\";\r\n  container.style.margin = \"50px auto\";\r\n  container.style.background = \"rgba(255, 255, 255, 0.05)\";\r\n  container.style.borderRadius = \"8px\";\r\n  container.style.padding = \"20px 30px\";\r\n  container.style.boxShadow = \"0 0 10px rgba(255, 0, 0, 0.3)\";\r\n\r\n  // Close Button\r\n  const closeBtn = document.createElement(\"button\");\r\n  closeBtn.textContent = \"\u00D7 Close\";\r\n  Object.assign(closeBtn.style, {\r\n    position: \"absolute\",\r\n    top: \"10px\",\r\n    right: \"10px\",\r\n    background: \"#ff5555\",\r\n    color: \"#fff\",\r\n    border: \"none\",\r\n    padding: \"6px 12px\",\r\n    fontSize: \"16px\",\r\n    borderRadius: \"4px\",\r\n    cursor: \"pointer\",\r\n    zIndex: 10,\r\n  });\r\n  closeBtn.addEventListener(\"click\", () => removeErrorOverlay());\r\n  container.appendChild(closeBtn);\r\n\r\n  // Title\r\n  const title = document.createElement(\"h1\");\r\n  title.textContent = \"Runtime Error\";\r\n  Object.assign(title.style, {\r\n    color: \"#ff5555\",\r\n    fontSize: \"24px\",\r\n    marginBottom: \"10px\",\r\n  });\r\n\r\n  // Message\r\n  const message = document.createElement(\"pre\");\r\n  message.textContent = error?.message || \"Unknown error\";\r\n  Object.assign(message.style, {\r\n    whiteSpace: \"pre-wrap\",\r\n    background: \"rgba(255, 255, 255, 0.1)\",\r\n    padding: \"10px\",\r\n    borderRadius: \"6px\",\r\n    marginTop: \"10px\",\r\n    color: \"#ffaaaa\",\r\n  });\r\n\r\n  // Stack trace\r\n  const stack = document.createElement(\"pre\");\r\n  stack.textContent = error?.stack || \"\";\r\n  Object.assign(stack.style, {\r\n    whiteSpace: \"pre-wrap\",\r\n    marginTop: \"15px\",\r\n    color: \"#ccc\",\r\n  });\r\n\r\n  container.appendChild(title);\r\n  container.appendChild(message);\r\n  container.appendChild(stack);\r\n  overlay.appendChild(container);\r\n  document.body.appendChild(overlay);\r\n\r\n  // Smooth fade-in\r\n  requestAnimationFrame(() => {\r\n    overlay.style.opacity = \"1\";\r\n  });\r\n\r\n  // Console log\r\n  console.error(\"FynixJS Runtime Error]\", error);\r\n}\r\n\r\nexport function removeErrorOverlay() {\r\n  const existing = document.getElementById(\"dev-error-overlay\");\r\n  if (existing) {\r\n    existing.style.opacity = \"0\";\r\n    setTimeout(() => existing.remove(), 200);\r\n  }\r\n}\r\n"],
-  "mappings": "AACO,SAAS,iBAAiB,OAAO;AACtC,qBAAmB;AAEnB,QAAM,UAAU,SAAS,cAAc,KAAK;AAC5C,UAAQ,KAAK;AACb,SAAO,OAAO,QAAQ,OAAO;AAAA,IAC3B,UAAU;AAAA,IACV,OAAO;AAAA,IACP,OAAO;AAAA,IACP,QAAQ;AAAA,IACR,iBAAiB;AAAA,IACjB,OAAO;AAAA,IACP,YAAY;AAAA,IACZ,SAAS;AAAA,IACT,QAAQ;AAAA,IACR,WAAW;AAAA,IACX,YAAY;AAAA,IACZ,SAAS;AAAA,EACX,CAAC;AAED,QAAM,YAAY,SAAS,cAAc,KAAK;AAC9C,YAAU,MAAM,WAAW;AAC3B,YAAU,MAAM,WAAW;AAC3B,YAAU,MAAM,SAAS;AACzB,YAAU,MAAM,aAAa;AAC7B,YAAU,MAAM,eAAe;AAC/B,YAAU,MAAM,UAAU;AAC1B,YAAU,MAAM,YAAY;AAG5B,QAAM,WAAW,SAAS,cAAc,QAAQ;AAChD,WAAS,cAAc;AACvB,SAAO,OAAO,SAAS,OAAO;AAAA,IAC5B,UAAU;AAAA,IACV,KAAK;AAAA,IACL,OAAO;AAAA,IACP,YAAY;AAAA,IACZ,OAAO;AAAA,IACP,QAAQ;AAAA,IACR,SAAS;AAAA,IACT,UAAU;AAAA,IACV,cAAc;AAAA,IACd,QAAQ;AAAA,IACR,QAAQ;AAAA,EACV,CAAC;AACD,WAAS,iBAAiB,SAAS,MAAM,mBAAmB,CAAC;AAC7D,YAAU,YAAY,QAAQ;AAG9B,QAAM,QAAQ,SAAS,cAAc,IAAI;AACzC,QAAM,cAAc;AACpB,SAAO,OAAO,MAAM,OAAO;AAAA,IACzB,OAAO;AAAA,IACP,UAAU;AAAA,IACV,cAAc;AAAA,EAChB,CAAC;AAGD,QAAM,UAAU,SAAS,cAAc,KAAK;AAC5C,UAAQ,cAAc,OAAO,WAAW;AACxC,SAAO,OAAO,QAAQ,OAAO;AAAA,IAC3B,YAAY;AAAA,IACZ,YAAY;AAAA,IACZ,SAAS;AAAA,IACT,cAAc;AAAA,IACd,WAAW;AAAA,IACX,OAAO;AAAA,EACT,CAAC;AAGD,QAAM,QAAQ,SAAS,cAAc,KAAK;AAC1C,QAAM,cAAc,OAAO,SAAS;AACpC,SAAO,OAAO,MAAM,OAAO;AAAA,IACzB,YAAY;AAAA,IACZ,WAAW;AAAA,IACX,OAAO;AAAA,EACT,CAAC;AAED,YAAU,YAAY,KAAK;AAC3B,YAAU,YAAY,OAAO;AAC7B,YAAU,YAAY,KAAK;AAC3B,UAAQ,YAAY,SAAS;AAC7B,WAAS,KAAK,YAAY,OAAO;AAGjC,wBAAsB,MAAM;AAC1B,YAAQ,MAAM,UAAU;AAAA,EAC1B,CAAC;AAGD,UAAQ,MAAM,0BAA0B,KAAK;AAC/C;AAEO,SAAS,qBAAqB;AACnC,QAAM,WAAW,SAAS,eAAe,mBAAmB;AAC5D,MAAI,UAAU;AACZ,aAAS,MAAM,UAAU;AACzB,eAAW,MAAM,SAAS,OAAO,GAAG,GAAG;AAAA,EACzC;AACF;",
+  "sourcesContent": ["/**\r\n * @fileoverview Development error overlay for Fynix applications.\r\n * Displays runtime errors in a user-friendly overlay during development.\r\n */\r\n\r\n/**\r\n * Display an error overlay with error details.\r\n * Shows error message, stack trace, and a close button.\r\n * \r\n * @param {Error} error - The error object to display\r\n * @returns {void}\r\n * \r\n * @example\r\n * try {\r\n *   // some code\r\n * } catch (err) {\r\n *   showErrorOverlay(err);\r\n * }\r\n */\r\nexport function showErrorOverlay(error) {\r\n  removeErrorOverlay();\r\n\r\n  const overlay = document.createElement(\"div\");\r\n  overlay.id = \"dev-error-overlay\";\r\n  Object.assign(overlay.style, {\r\n    position: \"fixed\",\r\n    inset: 0,\r\n    width: \"100%\",\r\n    height: \"100%\",\r\n    backgroundColor: \"rgba(0, 0, 0, 0.9)\",\r\n    color: \"#fff\",\r\n    fontFamily: \"Consolas, monospace\",\r\n    padding: \"30px\",\r\n    zIndex: 99999,\r\n    overflowY: \"auto\",\r\n    transition: \"opacity 0.25s ease\",\r\n    opacity: \"0\",\r\n  });\r\n\r\n  const container = document.createElement(\"div\");\r\n  container.style.position = \"relative\"; // important for absolute button\r\n  container.style.maxWidth = \"900px\";\r\n  container.style.margin = \"50px auto\";\r\n  container.style.background = \"rgba(255, 255, 255, 0.05)\";\r\n  container.style.borderRadius = \"8px\";\r\n  container.style.padding = \"20px 30px\";\r\n  container.style.boxShadow = \"0 0 10px rgba(255, 0, 0, 0.3)\";\r\n\r\n  // Close Button\r\n  const closeBtn = document.createElement(\"button\");\r\n  closeBtn.textContent = \"\u00D7 Close\";\r\n  Object.assign(closeBtn.style, {\r\n    position: \"absolute\",\r\n    top: \"10px\",\r\n    right: \"10px\",\r\n    background: \"#ff5555\",\r\n    color: \"#fff\",\r\n    border: \"none\",\r\n    padding: \"6px 12px\",\r\n    fontSize: \"16px\",\r\n    borderRadius: \"4px\",\r\n    cursor: \"pointer\",\r\n    zIndex: 10,\r\n  });\r\n  closeBtn.addEventListener(\"click\", () => removeErrorOverlay());\r\n  container.appendChild(closeBtn);\r\n\r\n  // Title\r\n  const title = document.createElement(\"h1\");\r\n  title.textContent = \"Runtime Error\";\r\n  Object.assign(title.style, {\r\n    color: \"#ff5555\",\r\n    fontSize: \"24px\",\r\n    marginBottom: \"10px\",\r\n  });\r\n\r\n  // Message\r\n  const message = document.createElement(\"pre\");\r\n  message.textContent = error?.message || \"Unknown error\";\r\n  Object.assign(message.style, {\r\n    whiteSpace: \"pre-wrap\",\r\n    background: \"rgba(255, 255, 255, 0.1)\",\r\n    padding: \"10px\",\r\n    borderRadius: \"6px\",\r\n    marginTop: \"10px\",\r\n    color: \"#ffaaaa\",\r\n  });\r\n\r\n  // Stack trace\r\n  const stack = document.createElement(\"pre\");\r\n  stack.textContent = error?.stack || \"\";\r\n  Object.assign(stack.style, {\r\n    whiteSpace: \"pre-wrap\",\r\n    marginTop: \"15px\",\r\n    color: \"#ccc\",\r\n  });\r\n\r\n  container.appendChild(title);\r\n  container.appendChild(message);\r\n  container.appendChild(stack);\r\n  overlay.appendChild(container);\r\n  document.body.appendChild(overlay);\r\n\r\n  // Smooth fade-in\r\n  requestAnimationFrame(() => {\r\n    overlay.style.opacity = \"1\";\r\n  });\r\n\r\n  // Console log\r\n  console.error(\"FynixJS Runtime Error]\", error);\r\n}\r\n\r\n/**\r\n * Remove the error overlay from the DOM.\r\n * Fades out the overlay before removing it.\r\n * \r\n * @returns {void}\r\n */\r\nexport function removeErrorOverlay() {\r\n  const existing = document.getElementById(\"dev-error-overlay\");\r\n  if (existing) {\r\n    existing.style.opacity = \"0\";\r\n    setTimeout(() => existing.remove(), 200);\r\n  }\r\n}\r\n"],
+  "mappings": ";;AAmBO,SAAS,iBAAiB,OAAO;AACtC,qBAAmB;AAEnB,QAAM,UAAU,SAAS,cAAc,KAAK;AAC5C,UAAQ,KAAK;AACb,SAAO,OAAO,QAAQ,OAAO;AAAA,IAC3B,UAAU;AAAA,IACV,OAAO;AAAA,IACP,OAAO;AAAA,IACP,QAAQ;AAAA,IACR,iBAAiB;AAAA,IACjB,OAAO;AAAA,IACP,YAAY;AAAA,IACZ,SAAS;AAAA,IACT,QAAQ;AAAA,IACR,WAAW;AAAA,IACX,YAAY;AAAA,IACZ,SAAS;AAAA,EACX,CAAC;AAED,QAAM,YAAY,SAAS,cAAc,KAAK;AAC9C,YAAU,MAAM,WAAW;AAC3B,YAAU,MAAM,WAAW;AAC3B,YAAU,MAAM,SAAS;AACzB,YAAU,MAAM,aAAa;AAC7B,YAAU,MAAM,eAAe;AAC/B,YAAU,MAAM,UAAU;AAC1B,YAAU,MAAM,YAAY;AAG5B,QAAM,WAAW,SAAS,cAAc,QAAQ;AAChD,WAAS,cAAc;AACvB,SAAO,OAAO,SAAS,OAAO;AAAA,IAC5B,UAAU;AAAA,IACV,KAAK;AAAA,IACL,OAAO;AAAA,IACP,YAAY;AAAA,IACZ,OAAO;AAAA,IACP,QAAQ;AAAA,IACR,SAAS;AAAA,IACT,UAAU;AAAA,IACV,cAAc;AAAA,IACd,QAAQ;AAAA,IACR,QAAQ;AAAA,EACV,CAAC;AACD,WAAS,iBAAiB,SAAS,MAAM,mBAAmB,CAAC;AAC7D,YAAU,YAAY,QAAQ;AAG9B,QAAM,QAAQ,SAAS,cAAc,IAAI;AACzC,QAAM,cAAc;AACpB,SAAO,OAAO,MAAM,OAAO;AAAA,IACzB,OAAO;AAAA,IACP,UAAU;AAAA,IACV,cAAc;AAAA,EAChB,CAAC;AAGD,QAAM,UAAU,SAAS,cAAc,KAAK;AAC5C,UAAQ,cAAc,OAAO,WAAW;AACxC,SAAO,OAAO,QAAQ,OAAO;AAAA,IAC3B,YAAY;AAAA,IACZ,YAAY;AAAA,IACZ,SAAS;AAAA,IACT,cAAc;AAAA,IACd,WAAW;AAAA,IACX,OAAO;AAAA,EACT,CAAC;AAGD,QAAM,QAAQ,SAAS,cAAc,KAAK;AAC1C,QAAM,cAAc,OAAO,SAAS;AACpC,SAAO,OAAO,MAAM,OAAO;AAAA,IACzB,YAAY;AAAA,IACZ,WAAW;AAAA,IACX,OAAO;AAAA,EACT,CAAC;AAED,YAAU,YAAY,KAAK;AAC3B,YAAU,YAAY,OAAO;AAC7B,YAAU,YAAY,KAAK;AAC3B,UAAQ,YAAY,SAAS;AAC7B,WAAS,KAAK,YAAY,OAAO;AAGjC,wBAAsB,MAAM;AAC1B,YAAQ,MAAM,UAAU;AAAA,EAC1B,CAAC;AAGD,UAAQ,MAAM,0BAA0B,KAAK;AAC/C;AA3FgB;AAmGT,SAAS,qBAAqB;AACnC,QAAM,WAAW,SAAS,eAAe,mBAAmB;AAC5D,MAAI,UAAU;AACZ,aAAS,MAAM,UAAU;AACzB,eAAW,MAAM,SAAS,OAAO,GAAG,GAAG;AAAA,EACzC;AACF;AANgB;",
   "names": []
 }

package/dist/fynix/index.d.ts

@@ -0,0 +1,4 @@
+export * from "../runtime.js";
+export * from "../router/router.js";
+export { Fynix } from "../runtime.js";
+export { default as createFynix } from "../router/router.js";

package/dist/hooks/nixAsync.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Async state helper with AbortController support.
+ *
+ * @template T
+ * @param {(signal: AbortSignal) => Promise<T>} promiseFactory
+ */
+export function nixAsync<T>(promiseFactory: (signal: AbortSignal) => Promise<T>): {
+    data: import("./nixState").NixState;
+    error: import("./nixState").NixState;
+    loading: import("./nixState").NixState;
+    run: () => Promise<void>;
+    cancel: () => void;
+};

package/dist/hooks/nixAsync.js

@@ -1,3 +1,5 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 import { nixState } from "./nixState";
 function nixAsync(promiseFactory) {
   const data = nixState(null);
@@ -6,7 +8,7 @@ function nixAsync(promiseFactory) {
   let active = true;
   let controller = null;
   let callId = 0;
-  const run = async () => {
+  const run = /* @__PURE__ */ __name(async () => {
     if (controller)
       controller.abort();
     controller = new AbortController();
@@ -28,14 +30,15 @@ function nixAsync(promiseFactory) {
         loading.value = false;
       }
     }
-  };
-  const cancel = () => {
+  }, "run");
+  const cancel = /* @__PURE__ */ __name(() => {
     active = false;
     if (controller)
       controller.abort();
-  };
+  }, "cancel");
   return { data, error, loading, run, cancel };
 }
+__name(nixAsync, "nixAsync");
 export {
   nixAsync
 };

package/dist/hooks/nixAsync.js.map

@@ -2,6 +2,6 @@
   "version": 3,
   "sources": ["../../hooks/nixAsync.js"],
   "sourcesContent": ["import { nixState } from \"./nixState\";\r\n\r\n/**\r\n * Async state helper with AbortController support.\r\n *\r\n * @template T\r\n * @param {(signal: AbortSignal) => Promise<T>} promiseFactory\r\n */\r\nexport function nixAsync(promiseFactory) {\r\n  const data = nixState(null);\r\n  const error = nixState(null);\r\n  const loading = nixState(false);\r\n\r\n  let active = true;\r\n  let controller = null;\r\n  let callId = 0;\r\n\r\n  const run = async () => {\r\n    // Cancel previous request\r\n    if (controller) controller.abort();\r\n\r\n    controller = new AbortController();\r\n    const signal = controller.signal;\r\n    const id = ++callId;\r\n\r\n    loading.value = true;\r\n    error.value = null;\r\n\r\n    try {\r\n      const result = await promiseFactory(signal);\r\n      if (!active || id !== callId || signal.aborted) return;\r\n      data.value = result;\r\n    } catch (e) {\r\n      if (!active || id !== callId || signal.aborted) return;\r\n      error.value = e instanceof Error ? e : new Error(String(e));\r\n    } finally {\r\n      if (active && id === callId && !signal.aborted) {\r\n        loading.value = false;\r\n      }\r\n    }\r\n  };\r\n\r\n  const cancel = () => {\r\n    active = false;\r\n    if (controller) controller.abort();\r\n  };\r\n\r\n  return { data, error, loading, run, cancel };\r\n}\r\n"],
-  "mappings": "AAAA,SAAS,gBAAgB;AAQlB,SAAS,SAAS,gBAAgB;AACvC,QAAM,OAAO,SAAS,IAAI;AAC1B,QAAM,QAAQ,SAAS,IAAI;AAC3B,QAAM,UAAU,SAAS,KAAK;AAE9B,MAAI,SAAS;AACb,MAAI,aAAa;AACjB,MAAI,SAAS;AAEb,QAAM,MAAM,YAAY;AAEtB,QAAI;AAAY,iBAAW,MAAM;AAEjC,iBAAa,IAAI,gBAAgB;AACjC,UAAM,SAAS,WAAW;AAC1B,UAAM,KAAK,EAAE;AAEb,YAAQ,QAAQ;AAChB,UAAM,QAAQ;AAEd,QAAI;AACF,YAAM,SAAS,MAAM,eAAe,MAAM;AAC1C,UAAI,CAAC,UAAU,OAAO,UAAU,OAAO;AAAS;AAChD,WAAK,QAAQ;AAAA,IACf,SAAS,GAAG;AACV,UAAI,CAAC,UAAU,OAAO,UAAU,OAAO;AAAS;AAChD,YAAM,QAAQ,aAAa,QAAQ,IAAI,IAAI,MAAM,OAAO,CAAC,CAAC;AAAA,IAC5D,UAAE;AACA,UAAI,UAAU,OAAO,UAAU,CAAC,OAAO,SAAS;AAC9C,gBAAQ,QAAQ;AAAA,MAClB;AAAA,IACF;AAAA,EACF;AAEA,QAAM,SAAS,MAAM;AACnB,aAAS;AACT,QAAI;AAAY,iBAAW,MAAM;AAAA,EACnC;AAEA,SAAO,EAAE,MAAM,OAAO,SAAS,KAAK,OAAO;AAC7C;",
+  "mappings": ";;AAAA,SAAS,gBAAgB;AAQlB,SAAS,SAAS,gBAAgB;AACvC,QAAM,OAAO,SAAS,IAAI;AAC1B,QAAM,QAAQ,SAAS,IAAI;AAC3B,QAAM,UAAU,SAAS,KAAK;AAE9B,MAAI,SAAS;AACb,MAAI,aAAa;AACjB,MAAI,SAAS;AAEb,QAAM,MAAM,mCAAY;AAEtB,QAAI;AAAY,iBAAW,MAAM;AAEjC,iBAAa,IAAI,gBAAgB;AACjC,UAAM,SAAS,WAAW;AAC1B,UAAM,KAAK,EAAE;AAEb,YAAQ,QAAQ;AAChB,UAAM,QAAQ;AAEd,QAAI;AACF,YAAM,SAAS,MAAM,eAAe,MAAM;AAC1C,UAAI,CAAC,UAAU,OAAO,UAAU,OAAO;AAAS;AAChD,WAAK,QAAQ;AAAA,IACf,SAAS,GAAG;AACV,UAAI,CAAC,UAAU,OAAO,UAAU,OAAO;AAAS;AAChD,YAAM,QAAQ,aAAa,QAAQ,IAAI,IAAI,MAAM,OAAO,CAAC,CAAC;AAAA,IAC5D,UAAE;AACA,UAAI,UAAU,OAAO,UAAU,CAAC,OAAO,SAAS;AAC9C,gBAAQ,QAAQ;AAAA,MAClB;AAAA,IACF;AAAA,EACF,GAvBY;AAyBZ,QAAM,SAAS,6BAAM;AACnB,aAAS;AACT,QAAI;AAAY,iBAAW,MAAM;AAAA,EACnC,GAHe;AAKf,SAAO,EAAE,MAAM,OAAO,SAAS,KAAK,OAAO;AAC7C;AAxCgB;",
   "names": []
 }

package/dist/hooks/nixAsyncCache.d.ts

@@ -0,0 +1,7 @@
+export function nixAsyncCached(key: any, promiseFactory: any): {
+    data: import("./nixState").NixState;
+    error: import("./nixState").NixState;
+    loading: import("./nixState").NixState;
+    run: () => Promise<void>;
+    cancel: () => void;
+};

package/dist/hooks/nixAsyncCache.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 nixAsyncCached(key, promiseFactory) {
@@ -5,7 +7,7 @@ function nixAsyncCached(key, promiseFactory) {
   const error = nixState(null);
   const loading = nixState(false);
   let active = true;
-  const run = async () => {
+  const run = /* @__PURE__ */ __name(async () => {
     loading.value = true;
     error.value = null;
     if (asyncCache.has(key)) {
@@ -46,12 +48,13 @@ function nixAsyncCached(key, promiseFactory) {
       if (active)
         loading.value = false;
     }
-  };
-  const cancel = () => {
+  }, "run");
+  const cancel = /* @__PURE__ */ __name(() => {
     active = false;
-  };
+  }, "cancel");
   return { data, error, loading, run, cancel };
 }
+__name(nixAsyncCached, "nixAsyncCached");
 export {
   nixAsyncCached
 };

package/dist/hooks/nixAsyncCache.js.map

@@ -2,6 +2,6 @@
   "version": 3,
   "sources": ["../../hooks/nixAsyncCache.js"],
   "sourcesContent": ["import { nixState } from \"./nixState\";\r\n\r\nconst asyncCache = new Map();\r\n\r\nexport function nixAsyncCached(key, promiseFactory) {\r\n  const data = nixState(null);\r\n  const error = nixState(null);\r\n  const loading = nixState(false);\r\n\r\n  let active = true;\r\n\r\n  const run = async () => {\r\n    loading.value = true;\r\n    error.value = null;\r\n\r\n    // Cache hit with resolved data\r\n    if (asyncCache.has(key)) {\r\n      const cached = asyncCache.get(key);\r\n\r\n      if (cached.data) {\r\n        data.value = cached.data;\r\n        loading.value = false;\r\n        return;\r\n      }\r\n\r\n      // Deduping: reuse in-flight promise\r\n      try {\r\n        const result = await cached.promise;\r\n        if (!active) return;\r\n        data.value = result;\r\n        loading.value = false;\r\n      } catch (e) {\r\n        if (!active) return;\r\n        error.value = e;\r\n        loading.value = false;\r\n      }\r\n      return;\r\n    }\r\n\r\n    // Cache miss\r\n    const promise = Promise.resolve().then(promiseFactory);\r\n    asyncCache.set(key, { promise });\r\n\r\n    try {\r\n      const result = await promise;\r\n      asyncCache.set(key, { data: result });\r\n      if (!active) return;\r\n      data.value = result;\r\n    } catch (e) {\r\n      asyncCache.delete(key);\r\n      if (!active) return;\r\n      error.value = e;\r\n    } finally {\r\n      if (active) loading.value = false;\r\n    }\r\n  };\r\n\r\n  const cancel = () => {\r\n    active = false;\r\n  };\r\n\r\n  return { data, error, loading, run, cancel };\r\n}\r\n"],
-  "mappings": "AAAA,SAAS,gBAAgB;AAEzB,MAAM,aAAa,oBAAI,IAAI;AAEpB,SAAS,eAAe,KAAK,gBAAgB;AAClD,QAAM,OAAO,SAAS,IAAI;AAC1B,QAAM,QAAQ,SAAS,IAAI;AAC3B,QAAM,UAAU,SAAS,KAAK;AAE9B,MAAI,SAAS;AAEb,QAAM,MAAM,YAAY;AACtB,YAAQ,QAAQ;AAChB,UAAM,QAAQ;AAGd,QAAI,WAAW,IAAI,GAAG,GAAG;AACvB,YAAM,SAAS,WAAW,IAAI,GAAG;AAEjC,UAAI,OAAO,MAAM;AACf,aAAK,QAAQ,OAAO;AACpB,gBAAQ,QAAQ;AAChB;AAAA,MACF;AAGA,UAAI;AACF,cAAM,SAAS,MAAM,OAAO;AAC5B,YAAI,CAAC;AAAQ;AACb,aAAK,QAAQ;AACb,gBAAQ,QAAQ;AAAA,MAClB,SAAS,GAAG;AACV,YAAI,CAAC;AAAQ;AACb,cAAM,QAAQ;AACd,gBAAQ,QAAQ;AAAA,MAClB;AACA;AAAA,IACF;AAGA,UAAM,UAAU,QAAQ,QAAQ,EAAE,KAAK,cAAc;AACrD,eAAW,IAAI,KAAK,EAAE,QAAQ,CAAC;AAE/B,QAAI;AACF,YAAM,SAAS,MAAM;AACrB,iBAAW,IAAI,KAAK,EAAE,MAAM,OAAO,CAAC;AACpC,UAAI,CAAC;AAAQ;AACb,WAAK,QAAQ;AAAA,IACf,SAAS,GAAG;AACV,iBAAW,OAAO,GAAG;AACrB,UAAI,CAAC;AAAQ;AACb,YAAM,QAAQ;AAAA,IAChB,UAAE;AACA,UAAI;AAAQ,gBAAQ,QAAQ;AAAA,IAC9B;AAAA,EACF;AAEA,QAAM,SAAS,MAAM;AACnB,aAAS;AAAA,EACX;AAEA,SAAO,EAAE,MAAM,OAAO,SAAS,KAAK,OAAO;AAC7C;",
+  "mappings": ";;AAAA,SAAS,gBAAgB;AAEzB,MAAM,aAAa,oBAAI,IAAI;AAEpB,SAAS,eAAe,KAAK,gBAAgB;AAClD,QAAM,OAAO,SAAS,IAAI;AAC1B,QAAM,QAAQ,SAAS,IAAI;AAC3B,QAAM,UAAU,SAAS,KAAK;AAE9B,MAAI,SAAS;AAEb,QAAM,MAAM,mCAAY;AACtB,YAAQ,QAAQ;AAChB,UAAM,QAAQ;AAGd,QAAI,WAAW,IAAI,GAAG,GAAG;AACvB,YAAM,SAAS,WAAW,IAAI,GAAG;AAEjC,UAAI,OAAO,MAAM;AACf,aAAK,QAAQ,OAAO;AACpB,gBAAQ,QAAQ;AAChB;AAAA,MACF;AAGA,UAAI;AACF,cAAM,SAAS,MAAM,OAAO;AAC5B,YAAI,CAAC;AAAQ;AACb,aAAK,QAAQ;AACb,gBAAQ,QAAQ;AAAA,MAClB,SAAS,GAAG;AACV,YAAI,CAAC;AAAQ;AACb,cAAM,QAAQ;AACd,gBAAQ,QAAQ;AAAA,MAClB;AACA;AAAA,IACF;AAGA,UAAM,UAAU,QAAQ,QAAQ,EAAE,KAAK,cAAc;AACrD,eAAW,IAAI,KAAK,EAAE,QAAQ,CAAC;AAE/B,QAAI;AACF,YAAM,SAAS,MAAM;AACrB,iBAAW,IAAI,KAAK,EAAE,MAAM,OAAO,CAAC;AACpC,UAAI,CAAC;AAAQ;AACb,WAAK,QAAQ;AAAA,IACf,SAAS,GAAG;AACV,iBAAW,OAAO,GAAG;AACrB,UAAI,CAAC;AAAQ;AACb,YAAM,QAAQ;AAAA,IAChB,UAAE;AACA,UAAI;AAAQ,gBAAQ,QAAQ;AAAA,IAC9B;AAAA,EACF,GA5CY;AA8CZ,QAAM,SAAS,6BAAM;AACnB,aAAS;AAAA,EACX,GAFe;AAIf,SAAO,EAAE,MAAM,OAAO,SAAS,KAAK,OAAO;AAC7C;AA1DgB;",
   "names": []
 }

package/dist/hooks/nixAsyncDebounce.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Debounced and cancellable async data fetcher with caching and deduping.
+ *
+ * @param {() => Promise<any>} promiseFactory - Async function that returns a promise.
+ * @param {Object} [options={}] - Options for debounce, caching, and abort.
+ * @param {number} [options.delay=300] - Debounce delay in ms.
+ * @param {boolean} [options.leading=false] - Run on leading edge.
+ * @param {boolean} [options.trailing=true] - Run on trailing edge.
+ * @param {number} [options.maxWait] - Max wait time before forced invocation.
+ * @param {boolean} [options.cache=true] - Enable caching of last result.
+ * @param {AbortSignal} [options.signal] - Optional AbortSignal to cancel request.
+ * @returns {Object} { data, error, loading, run, cancel }
+ *
+ * @example
+ * const controller = new AbortController();
+ * const { data, error, loading, run, cancel } = nixAsyncDebounce(
+ *   () => fetch('/api/data').then(r => r.json()),
+ *   { delay: 500, maxWait: 2000, leading: true, signal: controller.signal }
+ * );
+ */
+export function nixAsyncDebounce(promiseFactory: () => Promise<any>, options?: {
+    delay?: number;
+    leading?: boolean;
+    trailing?: boolean;
+    maxWait?: number;
+    cache?: boolean;
+    signal?: AbortSignal;
+}): any;

package/dist/hooks/nixAsyncDebounce.js

@@ -1,3 +1,5 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 import { nixState } from "./nixState";
 function nixAsyncDebounce(promiseFactory, options = {}) {
   const data = nixState(null);
@@ -16,7 +18,7 @@ function nixAsyncDebounce(promiseFactory, options = {}) {
   let timerId = null;
   let lastInvokeTime = 0;
   let pendingPromise = null;
-  const invoke = async () => {
+  const invoke = /* @__PURE__ */ __name(async () => {
     if (cache && lastResult !== null) {
       data.value = lastResult;
       error.value = lastError;
@@ -49,8 +51,8 @@ function nixAsyncDebounce(promiseFactory, options = {}) {
       pendingPromise = null;
       lastInvokeTime = Date.now();
     }
-  };
-  const run = () => {
+  }, "invoke");
+  const run = /* @__PURE__ */ __name(() => {
     const now = Date.now();
     const timeSinceLastInvoke = now - lastInvokeTime;
     const remainingTime = delay - timeSinceLastInvoke;
@@ -71,14 +73,15 @@ function nixAsyncDebounce(promiseFactory, options = {}) {
         invoke();
       }, remainingTime > 0 ? remainingTime : delay);
     }
-  };
-  const cancel = () => {
+  }, "run");
+  const cancel = /* @__PURE__ */ __name(() => {
     if (timerId)
       clearTimeout(timerId);
     timerId = pendingPromise = null;
-  };
+  }, "cancel");
   return { data, error, loading, run, cancel };
 }
+__name(nixAsyncDebounce, "nixAsyncDebounce");
 export {
   nixAsyncDebounce
 };