@w3ux/hooks 2.2.2 → 2.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@w3ux/hooks",
-  "version": "2.2.2",
+  "version": "2.3.0",
   "license": "GPL-3.0-only",
   "type": "module",
   "description": "A collection of general purpose React hooks",
@@ -23,19 +23,19 @@
   },
   "exports": {
     ".": {
-      "import": "./mjs/index.js",
-      "require": "./cjs/index.js"
+      "import": "./index.js",
+      "require": "./index.cjs"
     },
     "./util": {
-      "import": "./mjs/util.js",
-      "require": "./cjs/util.js"
+      "import": "./util.js",
+      "require": "./util.cjs"
     }
   },
   "dependencies": {
-    "@w3ux/utils": "^2.1.0",
+    "@w3ux/utils": "^2.2.0",
     "date-fns": "^4.1.0"
   },
   "peerDependencies": {
-    "react": "^19"
+    "react": "^19.1.0"
   }
 }

package/cjs/index.d.ts

@@ -1,6 +0,0 @@
-export * from './useEffectIgnoreInitial';
-export * from './useOnResize';
-export * from './useOutsideAlerter';
-export * from './useSafeContext';
-export * from './useSize';
-export * from './useTimeLeft';

package/cjs/index.js

@@ -1,26 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./useEffectIgnoreInitial"), exports);
-__exportStar(require("./useOnResize"), exports);
-__exportStar(require("./useOutsideAlerter"), exports);
-__exportStar(require("./useSafeContext"), exports);
-__exportStar(require("./useSize"), exports);
-__exportStar(require("./useTimeLeft"), exports);
-
-//# sourceMappingURL=index.js.map
-
-//# sourceMappingURL=index.js.map

package/cjs/index.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/index.tsx"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAGA,2DAAwC;AACxC,gDAA6B;AAC7B,sDAAmC;AACnC,mDAAgC;AAChC,4CAAyB;AACzB,gDAA6B","file":"index.js","sourcesContent":["/* @license Copyright 2024 w3ux authors & contributors\nSPDX-License-Identifier: GPL-3.0-only */\n\nexport * from './useEffectIgnoreInitial'\nexport * from './useOnResize'\nexport * from './useOutsideAlerter'\nexport * from './useSafeContext'\nexport * from './useSize'\nexport * from './useTimeLeft'\n"]}

package/cjs/useEffectIgnoreInitial.d.ts

@@ -1 +0,0 @@
-export declare const useEffectIgnoreInitial: <T, U>(fn: T, deps: U[]) => void;

package/cjs/useEffectIgnoreInitial.js

@@ -1,20 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.useEffectIgnoreInitial = void 0;
-const react_1 = require("react");
-const useEffectIgnoreInitial = (fn, deps) => {
-    const isInitial = (0, react_1.useRef)(true);
-    (0, react_1.useEffect)(() => {
-        if (!isInitial.current) {
-            if (typeof fn === 'function') {
-                fn();
-            }
-        }
-        isInitial.current = false;
-    }, deps ? [...deps] : undefined);
-};
-exports.useEffectIgnoreInitial = useEffectIgnoreInitial;
-
-//# sourceMappingURL=useEffectIgnoreInitial.js.map
-
-//# sourceMappingURL=useEffectIgnoreInitial.js.map

package/cjs/useEffectIgnoreInitial.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/useEffectIgnoreInitial.tsx"],"names":[],"mappings":";;;AAGA,iCAAyC;AAElC,MAAM,sBAAsB,GAAG,CAAO,EAAK,EAAE,IAAS,EAAE,EAAE;IAC/D,MAAM,SAAS,GAAG,IAAA,cAAM,EAAU,IAAI,CAAC,CAAA;IAEvC,IAAA,iBAAS,EACP,GAAG,EAAE;QACH,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;YACvB,IAAI,OAAO,EAAE,KAAK,UAAU,EAAE,CAAC;gBAC7B,EAAE,EAAE,CAAA;YACN,CAAC;QACH,CAAC;QACD,SAAS,CAAC,OAAO,GAAG,KAAK,CAAA;IAC3B,CAAC,EACD,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAC7B,CAAA;AACH,CAAC,CAAA;AAdY,QAAA,sBAAsB,0BAclC","file":"useEffectIgnoreInitial.js","sourcesContent":["/* @license Copyright 2024 w3ux authors & contributors\nSPDX-License-Identifier: GPL-3.0-only */\n\nimport { useEffect, useRef } from 'react'\n\nexport const useEffectIgnoreInitial = <T, U>(fn: T, deps: U[]) => {\n  const isInitial = useRef<boolean>(true)\n\n  useEffect(\n    () => {\n      if (!isInitial.current) {\n        if (typeof fn === 'function') {\n          fn()\n        }\n      }\n      isInitial.current = false\n    },\n    deps ? [...deps] : undefined\n  )\n}\n"]}

package/cjs/useOnResize.d.ts

@@ -1,7 +0,0 @@
-import type { RefObject } from 'react';
-interface UseOnResizeOptions {
-    outerElement?: RefObject<HTMLElement | null>;
-    throttle?: number;
-}
-export declare const useOnResize: (callback: () => void, options?: UseOnResizeOptions) => void;
-export {};

package/cjs/useOnResize.js

@@ -1,28 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.useOnResize = void 0;
-const react_1 = require("react");
-const useOnResize = (callback, options = {}) => {
-    const { outerElement, throttle: throttleDuration = 100 } = options;
-    const lastExecutedRef = (0, react_1.useRef)(0);
-    const handleResize = () => {
-        const now = Date.now();
-        if (now - lastExecutedRef.current < throttleDuration) {
-            return;
-        }
-        lastExecutedRef.current = now;
-        callback();
-    };
-    (0, react_1.useEffect)(() => {
-        const target = (outerElement === null || outerElement === void 0 ? void 0 : outerElement.current) || window;
-        target.addEventListener('resize', handleResize);
-        return () => {
-            target.removeEventListener('resize', handleResize);
-        };
-    }, [throttleDuration, callback]);
-};
-exports.useOnResize = useOnResize;
-
-//# sourceMappingURL=useOnResize.js.map
-
-//# sourceMappingURL=useOnResize.js.map

package/cjs/useOnResize.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/useOnResize.tsx"],"names":[],"mappings":";;;AAIA,iCAAyC;AAiBlC,MAAM,WAAW,GAAG,CACzB,QAAoB,EACpB,UAA8B,EAAE,EAChC,EAAE;IACF,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,gBAAgB,GAAG,GAAG,EAAE,GAAG,OAAO,CAAA;IAClE,MAAM,eAAe,GAAG,IAAA,cAAM,EAAS,CAAC,CAAC,CAAA;IAGzC,MAAM,YAAY,GAAG,GAAG,EAAE;QACxB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QAGtB,IAAI,GAAG,GAAG,eAAe,CAAC,OAAO,GAAG,gBAAgB,EAAE,CAAC;YACrD,OAAM;QACR,CAAC;QAED,eAAe,CAAC,OAAO,GAAG,GAAG,CAAA;QAC7B,QAAQ,EAAE,CAAA;IACZ,CAAC,CAAA;IAED,IAAA,iBAAS,EAAC,GAAG,EAAE;QAEb,MAAM,MAAM,GAAG,CAAA,YAAY,aAAZ,YAAY,uBAAZ,YAAY,CAAE,OAAO,KAAI,MAAM,CAAA;QAG9C,MAAM,CAAC,gBAAgB,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAA;QAG/C,OAAO,GAAG,EAAE;YACV,MAAM,CAAC,mBAAmB,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAA;QACpD,CAAC,CAAA;IACH,CAAC,EAAE,CAAC,gBAAgB,EAAE,QAAQ,CAAC,CAAC,CAAA;AAClC,CAAC,CAAA;AAhCY,QAAA,WAAW,eAgCvB","file":"useOnResize.js","sourcesContent":["/* @license Copyright 2024 w3ux authors & contributors\nSPDX-License-Identifier: GPL-3.0-only */\n\nimport type { RefObject } from 'react'\nimport { useEffect, useRef } from 'react'\n\ninterface UseOnResizeOptions {\n  outerElement?: RefObject<HTMLElement | null>\n  throttle?: number\n}\n\n/**\n * Custom hook that triggers a callback function when the specified element\n * or the window is resized.\n *\n * @param callback - The function to be executed on resize.\n * @param options - Optional parameters to customize the behavior:\n *   - outerElement: A ref to an HTMLElement to listen for resize events.\n *   - throttle: Optional duration in milliseconds to throttle the callback execution.\n *               Default is 100 milliseconds.\n */\nexport const useOnResize = (\n  callback: () => void,\n  options: UseOnResizeOptions = {}\n) => {\n  const { outerElement, throttle: throttleDuration = 100 } = options\n  const lastExecutedRef = useRef<number>(0)\n\n  // Throttled resize handler to limit the frequency of callback execution.\n  const handleResize = () => {\n    const now = Date.now()\n\n    // Check if the callback can be executed based on the throttle duration.\n    if (now - lastExecutedRef.current < throttleDuration) {\n      return\n    }\n\n    lastExecutedRef.current = now\n    callback()\n  }\n\n  useEffect(() => {\n    // Determine the target for the resize event listener.\n    const target = outerElement?.current || window\n\n    // Add the resize event listener when the component mounts.\n    target.addEventListener('resize', handleResize)\n\n    // Clean up the event listener when the component unmounts.\n    return () => {\n      target.removeEventListener('resize', handleResize)\n    }\n  }, [throttleDuration, callback])\n}\n"]}

package/cjs/useOutsideAlerter.d.ts

@@ -1,2 +0,0 @@
-import { type RefObject } from 'react';
-export declare const useOutsideAlerter: (ref: RefObject<HTMLElement | null>, callback: () => void, ignore?: string[]) => void;

package/cjs/useOutsideAlerter.js

@@ -1,29 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.useOutsideAlerter = void 0;
-const react_1 = require("react");
-const useOutsideAlerter = (ref, callback, ignore = []) => {
-    (0, react_1.useEffect)(() => {
-        const handleClickOutside = (ev) => {
-            if (ev) {
-                if (ref.current && !ref.current.contains(ev.target)) {
-                    const target = ev.target;
-                    const tagName = target.tagName.toLowerCase();
-                    const ignored = ignore.some((i) => i.toLowerCase() === tagName || target.closest(`.${i}`) !== null);
-                    if (!ignored) {
-                        callback();
-                    }
-                }
-            }
-        };
-        document.addEventListener('mousedown', handleClickOutside);
-        return () => {
-            document.removeEventListener('mousedown', handleClickOutside);
-        };
-    }, [ref]);
-};
-exports.useOutsideAlerter = useOutsideAlerter;
-
-//# sourceMappingURL=useOutsideAlerter.js.map
-
-//# sourceMappingURL=useOutsideAlerter.js.map

package/cjs/useOutsideAlerter.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/useOutsideAlerter.tsx"],"names":[],"mappings":";;;AAGA,iCAAiD;AAG1C,MAAM,iBAAiB,GAAG,CAC/B,GAAkC,EAClC,QAAoB,EACpB,SAAmB,EAAE,EACrB,EAAE;IACF,IAAA,iBAAS,EAAC,GAAG,EAAE;QACb,MAAM,kBAAkB,GAAG,CAAC,EAAc,EAAE,EAAE;YAC5C,IAAI,EAAE,EAAE,CAAC;gBACP,IAAI,GAAG,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,MAAc,CAAC,EAAE,CAAC;oBAC5D,MAAM,MAAM,GAAG,EAAE,CAAC,MAAqB,CAAA;oBAGvC,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,WAAW,EAAE,CAAA;oBAC5C,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CACzB,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,WAAW,EAAE,KAAK,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,IAAI,CAClE,CAAA;oBAED,IAAI,CAAC,OAAO,EAAE,CAAC;wBACb,QAAQ,EAAE,CAAA;oBACZ,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC,CAAA;QACD,QAAQ,CAAC,gBAAgB,CAAC,WAAW,EAAE,kBAAkB,CAAC,CAAA;QAC1D,OAAO,GAAG,EAAE;YACV,QAAQ,CAAC,mBAAmB,CAAC,WAAW,EAAE,kBAAkB,CAAC,CAAA;QAC/D,CAAC,CAAA;IACH,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAA;AACX,CAAC,CAAA;AA7BY,QAAA,iBAAiB,qBA6B7B","file":"useOutsideAlerter.js","sourcesContent":["/* @license Copyright 2024 w3ux authors & contributors\nSPDX-License-Identifier: GPL-3.0-only */\n\nimport { useEffect, type RefObject } from 'react'\n\n// A hook that alerts clicks outside of the passed ref.\nexport const useOutsideAlerter = (\n  ref: RefObject<HTMLElement | null>,\n  callback: () => void,\n  ignore: string[] = []\n) => {\n  useEffect(() => {\n    const handleClickOutside = (ev: MouseEvent) => {\n      if (ev) {\n        if (ref.current && !ref.current.contains(ev.target as Node)) {\n          const target = ev.target as HTMLElement\n          // Ignore tags with a name of `ignore`, or if there is a class of `ignore` in the parent\n          // tree.\n          const tagName = target.tagName.toLowerCase()\n          const ignored = ignore.some(\n            (i) =>\n              i.toLowerCase() === tagName || target.closest(`.${i}`) !== null\n          )\n\n          if (!ignored) {\n            callback()\n          }\n        }\n      }\n    }\n    document.addEventListener('mousedown', handleClickOutside)\n    return () => {\n      document.removeEventListener('mousedown', handleClickOutside)\n    }\n  }, [ref])\n}\n"]}

package/cjs/useSafeContext.d.ts

@@ -1,3 +0,0 @@
-import type { Context } from 'react';
-export declare const useSafeContext: <T>(ctx: T | null | undefined) => T;
-export declare const createSafeContext: <T>() => [Context<T | null>, () => T];

package/cjs/useSafeContext.js

@@ -1,21 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createSafeContext = exports.useSafeContext = void 0;
-const react_1 = require("react");
-const useSafeContext = (ctx) => {
-    if (ctx === null || ctx === undefined) {
-        throw new Error('Context value is null or undefined. Please ensure the context Provider is used correctly.');
-    }
-    return ctx;
-};
-exports.useSafeContext = useSafeContext;
-const createSafeContext = () => {
-    const Context = (0, react_1.createContext)(null);
-    const useHook = () => (0, exports.useSafeContext)((0, react_1.useContext)(Context));
-    return [Context, useHook];
-};
-exports.createSafeContext = createSafeContext;
-
-//# sourceMappingURL=useSafeContext.js.map
-
-//# sourceMappingURL=useSafeContext.js.map

package/cjs/useSafeContext.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/useSafeContext.tsx"],"names":[],"mappings":";;;AAIA,iCAAiD;AAE1C,MAAM,cAAc,GAAG,CAAK,GAAyB,EAAK,EAAE;IACjE,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CACb,2FAA2F,CAC5F,CAAA;IACH,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC,CAAA;AAPY,QAAA,cAAc,kBAO1B;AAEM,MAAM,iBAAiB,GAAG,GAAqC,EAAE;IACtE,MAAM,OAAO,GAAG,IAAA,qBAAa,EAAW,IAAI,CAAC,CAAA;IAC7C,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,IAAA,sBAAc,EAAI,IAAA,kBAAU,EAAC,OAAO,CAAC,CAAC,CAAA;IAC5D,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;AAC3B,CAAC,CAAA;AAJY,QAAA,iBAAiB,qBAI7B","file":"useSafeContext.js","sourcesContent":["/* @license Copyright 2024 w3ux authors & contributors\nSPDX-License-Identifier: GPL-3.0-only */\n\nimport type { Context } from 'react'\nimport { createContext, useContext } from 'react'\n\nexport const useSafeContext = <T,>(ctx: T | null | undefined): T => {\n  if (ctx === null || ctx === undefined) {\n    throw new Error(\n      'Context value is null or undefined. Please ensure the context Provider is used correctly.'\n    )\n  }\n  return ctx\n}\n\nexport const createSafeContext = <T,>(): [Context<T | null>, () => T] => {\n  const Context = createContext<T | null>(null)\n  const useHook = () => useSafeContext<T>(useContext(Context))\n  return [Context, useHook]\n}\n"]}

package/cjs/useSize.d.ts

@@ -1,10 +0,0 @@
-import type { RefObject } from 'react';
-interface UseSizeOptions {
-    outerElement?: RefObject<HTMLElement | null>;
-    throttle?: number;
-}
-export declare const useSize: (element: RefObject<HTMLElement | null>, options?: UseSizeOptions) => {
-    width: number;
-    height: number;
-};
-export {};

package/cjs/useSize.js

@@ -1,35 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.useSize = void 0;
-const react_1 = require("react");
-const useSize = (element, options = {}) => {
-    const { outerElement, throttle: throttleDuration = 100 } = options;
-    const getSize = (el = null) => {
-        const width = (el === null || el === void 0 ? void 0 : el.offsetWidth) || 0;
-        const height = (el === null || el === void 0 ? void 0 : el.offsetHeight) || 0;
-        return { width, height };
-    };
-    const lastExecutedRef = (0, react_1.useRef)(0);
-    const [size, setSize] = (0, react_1.useState)(getSize(element === null || element === void 0 ? void 0 : element.current));
-    const handleResize = () => {
-        const now = Date.now();
-        if (now - lastExecutedRef.current < throttleDuration) {
-            return;
-        }
-        lastExecutedRef.current = now;
-        setSize(getSize(element === null || element === void 0 ? void 0 : element.current));
-    };
-    (0, react_1.useEffect)(() => {
-        const listenFor = (outerElement === null || outerElement === void 0 ? void 0 : outerElement.current) || window;
-        listenFor.addEventListener('resize', handleResize);
-        return () => {
-            listenFor.removeEventListener('resize', handleResize);
-        };
-    }, [outerElement === null || outerElement === void 0 ? void 0 : outerElement.current]);
-    return size;
-};
-exports.useSize = useSize;
-
-//# sourceMappingURL=useSize.js.map
-
-//# sourceMappingURL=useSize.js.map

package/cjs/useSize.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/useSize.tsx"],"names":[],"mappings":";;;AAIA,iCAAmD;AAU5C,MAAM,OAAO,GAAG,CACrB,OAAsC,EACtC,UAA0B,EAAE,EAC5B,EAAE;IACF,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,gBAAgB,GAAG,GAAG,EAAE,GAAG,OAAO,CAAA;IAIlE,MAAM,OAAO,GAAG,CAAC,KAAyB,IAAI,EAAE,EAAE;QAChD,MAAM,KAAK,GAAG,CAAA,EAAE,aAAF,EAAE,uBAAF,EAAE,CAAE,WAAW,KAAI,CAAC,CAAA;QAClC,MAAM,MAAM,GAAG,CAAA,EAAE,aAAF,EAAE,uBAAF,EAAE,CAAE,YAAY,KAAI,CAAC,CAAA;QACpC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAA;IAC1B,CAAC,CAAA;IAGD,MAAM,eAAe,GAAG,IAAA,cAAM,EAAS,CAAC,CAAC,CAAA;IAGzC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,IAAA,gBAAQ,EAC9B,OAAO,CAAC,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,OAAO,CAAC,CAC1B,CAAA;IAGD,MAAM,YAAY,GAAG,GAAG,EAAE;QACxB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QACtB,IAAI,GAAG,GAAG,eAAe,CAAC,OAAO,GAAG,gBAAgB,EAAE,CAAC;YACrD,OAAM;QACR,CAAC;QAED,eAAe,CAAC,OAAO,GAAG,GAAG,CAAA;QAE7B,OAAO,CAAC,OAAO,CAAC,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,OAAO,CAAC,CAAC,CAAA;IACpC,CAAC,CAAA;IAGD,IAAA,iBAAS,EAAC,GAAG,EAAE;QAGb,MAAM,SAAS,GAAG,CAAA,YAAY,aAAZ,YAAY,uBAAZ,YAAY,CAAE,OAAO,KAAI,MAAM,CAAA;QAEjD,SAAS,CAAC,gBAAgB,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAA;QAGlD,OAAO,GAAG,EAAE;YACV,SAAS,CAAC,mBAAmB,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAA;QACvD,CAAC,CAAA;IACH,CAAC,EAAE,CAAC,YAAY,aAAZ,YAAY,uBAAZ,YAAY,CAAE,OAAO,CAAC,CAAC,CAAA;IAG3B,OAAO,IAAI,CAAA;AACb,CAAC,CAAA;AAlDY,QAAA,OAAO,WAkDnB","file":"useSize.js","sourcesContent":["/* @license Copyright 2024 w3ux authors & contributors\nSPDX-License-Identifier: GPL-3.0-only */\n\nimport type { RefObject } from 'react'\nimport { useEffect, useRef, useState } from 'react'\n\n// Define the type for the options parameter.\ninterface UseSizeOptions {\n  outerElement?: RefObject<HTMLElement | null>\n  throttle?: number\n}\n\n// Custom hook to get the width and height of a specified element. Updates the `size` state when the\n// specified \"outer element\" (or the window by default) resizes.\nexport const useSize = (\n  element: RefObject<HTMLElement | null>,\n  options: UseSizeOptions = {}\n) => {\n  const { outerElement, throttle: throttleDuration = 100 } = options\n\n  // Helper function to retrieve the width and height of an element\n  // If no element is found, default dimensions are set to 0.\n  const getSize = (el: HTMLElement | null = null) => {\n    const width = el?.offsetWidth || 0\n    const height = el?.offsetHeight || 0\n    return { width, height }\n  }\n\n  // Ref to store the last execution time of the `resizeThrottle` handler.\n  const lastExecutedRef = useRef<number>(0)\n\n  // State to store the current width and height of the specified element.\n  const [size, setSize] = useState<{ width: number; height: number }>(\n    getSize(element?.current)\n  )\n\n  // Throttle the resize event handler to limit how often size updates occur.\n  const handleResize = () => {\n    const now = Date.now()\n    if (now - lastExecutedRef.current < throttleDuration) {\n      return\n    } // Exit if `throttleDuration` has not passed.\n\n    lastExecutedRef.current = now // Update last execution time.\n\n    setSize(getSize(element?.current))\n  }\n\n  // Set up the resize event listener on mount and clean it up on unmount.\n  useEffect(() => {\n    // Determine the target for the resize event listener.\n    // If `outerElement` is provided, listen to its resize events; otherwise, listen to the window's.\n    const listenFor = outerElement?.current || window\n\n    listenFor.addEventListener('resize', handleResize)\n\n    // Clean up event listener when the component unmounts to avoid memory leaks.\n    return () => {\n      listenFor.removeEventListener('resize', handleResize)\n    }\n  }, [outerElement?.current])\n\n  // Return the current size of the element.\n  return size\n}\n"]}

package/cjs/useTimeLeft/defaults.d.ts

@@ -1,3 +0,0 @@
-import type { TimeleftDuration } from '@w3ux/types';
-export declare const defaultDuration: TimeleftDuration;
-export declare const defaultRefreshInterval = 60;

package/cjs/useTimeLeft/defaults.js

@@ -1,15 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.defaultRefreshInterval = exports.defaultDuration = void 0;
-exports.defaultDuration = {
-    days: 0,
-    hours: 0,
-    minutes: 0,
-    seconds: 0,
-    lastMinute: false,
-};
-exports.defaultRefreshInterval = 60;
-
-//# sourceMappingURL=defaults.js.map
-
-//# sourceMappingURL=defaults.js.map

package/cjs/useTimeLeft/defaults.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/useTimeLeft/defaults.ts"],"names":[],"mappings":";;;AAKa,QAAA,eAAe,GAAqB;IAC/C,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;IACR,OAAO,EAAE,CAAC;IACV,OAAO,EAAE,CAAC;IACV,UAAU,EAAE,KAAK;CAClB,CAAA;AAEY,QAAA,sBAAsB,GAAG,EAAE,CAAA","file":"defaults.js","sourcesContent":["/* @license Copyright 2024 w3ux authors & contributors\nSPDX-License-Identifier: GPL-3.0-only */\n\nimport type { TimeleftDuration } from '@w3ux/types'\n\nexport const defaultDuration: TimeleftDuration = {\n  days: 0,\n  hours: 0,\n  minutes: 0,\n  seconds: 0,\n  lastMinute: false,\n}\n\nexport const defaultRefreshInterval = 60\n"]}

package/cjs/useTimeLeft/index.d.ts

@@ -1,5 +0,0 @@
-import type { TimeLeftAll, UseTimeleftProps } from '@w3ux/types';
-export declare const useTimeLeft: (props?: UseTimeleftProps) => {
-    setFromNow: (dateFrom: Date, dateTo: Date) => void;
-    timeleft: TimeLeftAll;
-};

package/cjs/useTimeLeft/index.js

@@ -1,87 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.useTimeLeft = void 0;
-const utils_1 = require("@w3ux/utils");
-const react_1 = require("react");
-const util_1 = require("../util");
-const useTimeLeft = (props) => {
-    const depsTimeleft = (props === null || props === void 0 ? void 0 : props.depsTimeleft) || [];
-    const depsFormat = (props === null || props === void 0 ? void 0 : props.depsFormat) || [];
-    const inLastHour = () => {
-        const { days, hours } = (0, util_1.getDuration)(toRef.current);
-        return !days && !hours;
-    };
-    const lastMinuteCountdown = () => {
-        const { seconds } = (0, util_1.getDuration)(toRef.current);
-        if (!inLastHour()) {
-            return 60;
-        }
-        return seconds;
-    };
-    const getTimeleft = (c) => {
-        const { days, hours, minutes, seconds } = c || (0, util_1.getDuration)(toRef.current);
-        const raw = {
-            days,
-            hours,
-            minutes,
-        };
-        if (!days && !hours) {
-            raw.seconds = seconds;
-        }
-        return {
-            raw,
-        };
-    };
-    const [to, setTo] = (0, react_1.useState)(null);
-    const toRef = (0, react_1.useRef)(to);
-    const [timeleft, setTimeleft] = (0, react_1.useState)(getTimeleft());
-    const [minInterval, setMinInterval] = (0, react_1.useState)(undefined);
-    const minIntervalRef = (0, react_1.useRef)(minInterval);
-    const [secInterval, setSecInterval] = (0, react_1.useState)(undefined);
-    const secIntervalRef = (0, react_1.useRef)(secInterval);
-    (0, react_1.useEffect)(() => {
-        setTimeleft(getTimeleft());
-        if (inLastHour()) {
-            if (!secIntervalRef.current) {
-                const interval = setInterval(() => {
-                    if (!inLastHour()) {
-                        clearInterval(secIntervalRef.current);
-                        (0, utils_1.setStateWithRef)(undefined, setSecInterval, secIntervalRef);
-                    }
-                    setTimeleft(getTimeleft());
-                }, 1000);
-                (0, utils_1.setStateWithRef)(interval, setSecInterval, secIntervalRef);
-            }
-        }
-        else if (!minIntervalRef.current) {
-            const interval = setInterval(() => {
-                if (inLastHour()) {
-                    clearInterval(minIntervalRef.current);
-                    (0, utils_1.setStateWithRef)(undefined, setMinInterval, minIntervalRef);
-                }
-                setTimeleft(getTimeleft());
-            }, 60000);
-            (0, utils_1.setStateWithRef)(interval, setMinInterval, minIntervalRef);
-        }
-    }, [to, inLastHour(), lastMinuteCountdown(), ...depsTimeleft]);
-    (0, react_1.useEffect)(() => {
-        setTimeleft(getTimeleft());
-    }, [...depsFormat]);
-    (0, react_1.useEffect)(() => () => {
-        clearInterval(minInterval);
-        clearInterval(secInterval);
-    }, []);
-    const setFromNow = (dateFrom, dateTo) => {
-        setTimeleft(getTimeleft((0, util_1.getDuration)(dateFrom)));
-        (0, utils_1.setStateWithRef)(dateTo, setTo, toRef);
-    };
-    return {
-        setFromNow,
-        timeleft,
-    };
-};
-exports.useTimeLeft = useTimeLeft;
-
-//# sourceMappingURL=index.js.map
-
-//# sourceMappingURL=index.js.map

package/cjs/useTimeLeft/index.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/useTimeLeft/index.tsx"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/* @license Copyright 2024 w3ux authors & contributors\nSPDX-License-Identifier: GPL-3.0-only */\n\nimport type {\n  TimeLeftAll,\n  TimeLeftRaw,\n  TimeleftDuration,\n  UseTimeleftProps,\n} from '@w3ux/types'\nimport { setStateWithRef } from '@w3ux/utils'\nimport { useEffect, useRef, useState } from 'react'\nimport { getDuration } from '../util'\n\nexport const useTimeLeft = (props?: UseTimeleftProps) => {\n  const depsTimeleft = props?.depsTimeleft || []\n  const depsFormat = props?.depsFormat || []\n\n  // check whether timeleft is within a minute of finishing.\n  const inLastHour = () => {\n    const { days, hours } = getDuration(toRef.current)\n    return !days && !hours\n  }\n\n  // get the amount of seconds left if timeleft is in the last minute.\n  const lastMinuteCountdown = () => {\n    const { seconds } = getDuration(toRef.current)\n    if (!inLastHour()) {\n      return 60\n    }\n    return seconds\n  }\n\n  // calculate resulting timeleft object from latest duration.\n  const getTimeleft = (c?: TimeleftDuration): TimeLeftAll => {\n    const { days, hours, minutes, seconds } = c || getDuration(toRef.current)\n    const raw: TimeLeftRaw = {\n      days,\n      hours,\n      minutes,\n    }\n    if (!days && !hours) {\n      raw.seconds = seconds\n    }\n    return {\n      raw,\n    }\n  }\n\n  // the end time as a date.\n  const [to, setTo] = useState<Date | null>(null)\n  const toRef = useRef(to)\n\n  // resulting timeleft object to be returned.\n  const [timeleft, setTimeleft] = useState<TimeLeftAll>(getTimeleft())\n\n  // timeleft refresh intervals.\n  const [minInterval, setMinInterval] = useState<\n    ReturnType<typeof setInterval> | undefined\n  >(undefined)\n  const minIntervalRef = useRef(minInterval)\n\n  const [secInterval, setSecInterval] = useState<\n    ReturnType<typeof setInterval> | undefined\n  >(undefined)\n  const secIntervalRef = useRef(secInterval)\n\n  // refresh effects.\n  useEffect(() => {\n    setTimeleft(getTimeleft())\n    if (inLastHour()) {\n      // refresh timeleft every second.\n      if (!secIntervalRef.current) {\n        const interval = setInterval(() => {\n          if (!inLastHour()) {\n            clearInterval(secIntervalRef.current)\n            setStateWithRef(undefined, setSecInterval, secIntervalRef)\n          }\n          setTimeleft(getTimeleft())\n        }, 1000)\n\n        setStateWithRef(interval, setSecInterval, secIntervalRef)\n      }\n    }\n    // refresh timeleft every minute.\n    else if (!minIntervalRef.current) {\n      const interval = setInterval(() => {\n        if (inLastHour()) {\n          clearInterval(minIntervalRef.current)\n          setStateWithRef(undefined, setMinInterval, minIntervalRef)\n        }\n        setTimeleft(getTimeleft())\n      }, 60000)\n      setStateWithRef(interval, setMinInterval, minIntervalRef)\n    }\n  }, [to, inLastHour(), lastMinuteCountdown(), ...depsTimeleft])\n\n  // re-render the timeleft upon formatting changes.\n  useEffect(() => {\n    setTimeleft(getTimeleft())\n  }, [...depsFormat])\n\n  // clear intervals on unmount\n  useEffect(\n    () => () => {\n      clearInterval(minInterval)\n      clearInterval(secInterval)\n    },\n    []\n  )\n\n  // Set the end time and calculate timeleft.\n  const setFromNow = (dateFrom: Date, dateTo: Date) => {\n    setTimeleft(getTimeleft(getDuration(dateFrom)))\n    setStateWithRef(dateTo, setTo, toRef)\n  }\n\n  return {\n    setFromNow,\n    timeleft,\n  }\n}\n"]}

package/cjs/util.d.ts

@@ -1,4 +0,0 @@
-import type { TimeleftDuration } from '@w3ux/types';
-export declare const getDuration: (toDate: Date | null) => TimeleftDuration;
-export declare const secondsFromNow: (seconds: number) => Date;
-export declare const getDurationFromNow: (toDate: Date | null) => TimeleftDuration;

package/cjs/util.js

@@ -1,69 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getDurationFromNow = exports.secondsFromNow = exports.getDuration = void 0;
-const date_fns_1 = require("date-fns");
-const defaults_js_1 = require("./useTimeLeft/defaults.js");
-const getDuration = (toDate) => {
-    if (!toDate) {
-        return defaults_js_1.defaultDuration;
-    }
-    if ((0, date_fns_1.getUnixTime)(toDate) <= (0, date_fns_1.getUnixTime)(new Date())) {
-        return defaults_js_1.defaultDuration;
-    }
-    toDate.setSeconds(toDate.getSeconds());
-    const d = (0, date_fns_1.intervalToDuration)({
-        start: Date.now(),
-        end: toDate,
-    });
-    const days = (0, date_fns_1.differenceInDays)(toDate, Date.now());
-    const hours = (d === null || d === void 0 ? void 0 : d.hours) || 0;
-    const minutes = (d === null || d === void 0 ? void 0 : d.minutes) || 0;
-    const seconds = (d === null || d === void 0 ? void 0 : d.seconds) || 0;
-    const lastHour = days === 0 && hours === 0;
-    const lastMinute = lastHour && minutes === 0;
-    return {
-        days,
-        hours,
-        minutes,
-        seconds,
-        lastMinute,
-    };
-};
-exports.getDuration = getDuration;
-const secondsFromNow = (seconds) => {
-    const end = new Date();
-    end.setSeconds(end.getSeconds() + seconds);
-    return end;
-};
-exports.secondsFromNow = secondsFromNow;
-const getDurationFromNow = (toDate) => {
-    if (!toDate) {
-        return defaults_js_1.defaultDuration;
-    }
-    if ((0, date_fns_1.getUnixTime)(toDate) <= (0, date_fns_1.getUnixTime)(new Date())) {
-        return defaults_js_1.defaultDuration;
-    }
-    toDate.setSeconds(toDate.getSeconds());
-    const d = (0, date_fns_1.intervalToDuration)({
-        start: Date.now(),
-        end: toDate,
-    });
-    const days = (0, date_fns_1.differenceInDays)(toDate, Date.now());
-    const hours = (d === null || d === void 0 ? void 0 : d.hours) || 0;
-    const minutes = (d === null || d === void 0 ? void 0 : d.minutes) || 0;
-    const seconds = (d === null || d === void 0 ? void 0 : d.seconds) || 0;
-    const lastHour = days === 0 && hours === 0;
-    const lastMinute = lastHour && minutes === 0;
-    return {
-        days,
-        hours,
-        minutes,
-        seconds,
-        lastMinute,
-    };
-};
-exports.getDurationFromNow = getDurationFromNow;
-
-//# sourceMappingURL=util.js.map
-
-//# sourceMappingURL=util.js.map

package/cjs/util.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/util.ts"],"names":[],"mappings":";;;AAIA,uCAA4E;AAC5E,2DAA2D;AAGpD,MAAM,WAAW,GAAG,CAAC,MAAmB,EAAoB,EAAE;IACnE,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,6BAAe,CAAA;IACxB,CAAC;IACD,IAAI,IAAA,sBAAW,EAAC,MAAM,CAAC,IAAI,IAAA,sBAAW,EAAC,IAAI,IAAI,EAAE,CAAC,EAAE,CAAC;QACnD,OAAO,6BAAe,CAAA;IACxB,CAAC;IAED,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,CAAA;IACtC,MAAM,CAAC,GAAG,IAAA,6BAAkB,EAAC;QAC3B,KAAK,EAAE,IAAI,CAAC,GAAG,EAAE;QACjB,GAAG,EAAE,MAAM;KACZ,CAAC,CAAA;IAEF,MAAM,IAAI,GAAG,IAAA,2BAAgB,EAAC,MAAM,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAA;IACjD,MAAM,KAAK,GAAG,CAAA,CAAC,aAAD,CAAC,uBAAD,CAAC,CAAE,KAAK,KAAI,CAAC,CAAA;IAC3B,MAAM,OAAO,GAAG,CAAA,CAAC,aAAD,CAAC,uBAAD,CAAC,CAAE,OAAO,KAAI,CAAC,CAAA;IAC/B,MAAM,OAAO,GAAG,CAAA,CAAC,aAAD,CAAC,uBAAD,CAAC,CAAE,OAAO,KAAI,CAAC,CAAA;IAC/B,MAAM,QAAQ,GAAG,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,CAAA;IAC1C,MAAM,UAAU,GAAG,QAAQ,IAAI,OAAO,KAAK,CAAC,CAAA;IAE5C,OAAO;QACL,IAAI;QACJ,KAAK;QACL,OAAO;QACP,OAAO;QACP,UAAU;KACX,CAAA;AACH,CAAC,CAAA;AA5BY,QAAA,WAAW,eA4BvB;AAGM,MAAM,cAAc,GAAG,CAAC,OAAe,EAAQ,EAAE;IACtD,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAA;IACtB,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,OAAO,CAAC,CAAA;IAC1C,OAAO,GAAG,CAAA;AACZ,CAAC,CAAA;AAJY,QAAA,cAAc,kBAI1B;AAGM,MAAM,kBAAkB,GAAG,CAAC,MAAmB,EAAoB,EAAE;IAC1E,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,6BAAe,CAAA;IACxB,CAAC;IACD,IAAI,IAAA,sBAAW,EAAC,MAAM,CAAC,IAAI,IAAA,sBAAW,EAAC,IAAI,IAAI,EAAE,CAAC,EAAE,CAAC;QACnD,OAAO,6BAAe,CAAA;IACxB,CAAC;IAED,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,CAAA;IACtC,MAAM,CAAC,GAAG,IAAA,6BAAkB,EAAC;QAC3B,KAAK,EAAE,IAAI,CAAC,GAAG,EAAE;QACjB,GAAG,EAAE,MAAM;KACZ,CAAC,CAAA;IAEF,MAAM,IAAI,GAAG,IAAA,2BAAgB,EAAC,MAAM,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAA;IACjD,MAAM,KAAK,GAAG,CAAA,CAAC,aAAD,CAAC,uBAAD,CAAC,CAAE,KAAK,KAAI,CAAC,CAAA;IAC3B,MAAM,OAAO,GAAG,CAAA,CAAC,aAAD,CAAC,uBAAD,CAAC,CAAE,OAAO,KAAI,CAAC,CAAA;IAC/B,MAAM,OAAO,GAAG,CAAA,CAAC,aAAD,CAAC,uBAAD,CAAC,CAAE,OAAO,KAAI,CAAC,CAAA;IAC/B,MAAM,QAAQ,GAAG,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,CAAA;IAC1C,MAAM,UAAU,GAAG,QAAQ,IAAI,OAAO,KAAK,CAAC,CAAA;IAE5C,OAAO;QACL,IAAI;QACJ,KAAK;QACL,OAAO;QACP,OAAO;QACP,UAAU;KACX,CAAA;AACH,CAAC,CAAA;AA5BY,QAAA,kBAAkB,sBA4B9B","file":"util.js","sourcesContent":["/* @license Copyright 2024 w3ux authors & contributors\nSPDX-License-Identifier: GPL-3.0-only */\n\nimport type { TimeleftDuration } from '@w3ux/types'\nimport { differenceInDays, getUnixTime, intervalToDuration } from 'date-fns'\nimport { defaultDuration } from './useTimeLeft/defaults.js'\n\n// calculates the current timeleft duration.\nexport const getDuration = (toDate: Date | null): TimeleftDuration => {\n  if (!toDate) {\n    return defaultDuration\n  }\n  if (getUnixTime(toDate) <= getUnixTime(new Date())) {\n    return defaultDuration\n  }\n\n  toDate.setSeconds(toDate.getSeconds())\n  const d = intervalToDuration({\n    start: Date.now(),\n    end: toDate,\n  })\n\n  const days = differenceInDays(toDate, Date.now())\n  const hours = d?.hours || 0\n  const minutes = d?.minutes || 0\n  const seconds = d?.seconds || 0\n  const lastHour = days === 0 && hours === 0\n  const lastMinute = lastHour && minutes === 0\n\n  return {\n    days,\n    hours,\n    minutes,\n    seconds,\n    lastMinute,\n  }\n}\n\n// Helper: Adds `seconds` to the current time and returns the resulting date.\nexport const secondsFromNow = (seconds: number): Date => {\n  const end = new Date()\n  end.setSeconds(end.getSeconds() + seconds)\n  return end\n}\n\n// Helper: Calculates the duration between the current time and the provided date.\nexport const getDurationFromNow = (toDate: Date | null): TimeleftDuration => {\n  if (!toDate) {\n    return defaultDuration\n  }\n  if (getUnixTime(toDate) <= getUnixTime(new Date())) {\n    return defaultDuration\n  }\n\n  toDate.setSeconds(toDate.getSeconds())\n  const d = intervalToDuration({\n    start: Date.now(),\n    end: toDate,\n  })\n\n  const days = differenceInDays(toDate, Date.now())\n  const hours = d?.hours || 0\n  const minutes = d?.minutes || 0\n  const seconds = d?.seconds || 0\n  const lastHour = days === 0 && hours === 0\n  const lastMinute = lastHour && minutes === 0\n\n  return {\n    days,\n    hours,\n    minutes,\n    seconds,\n    lastMinute,\n  }\n}\n"]}

package/mjs/index.d.ts

@@ -1,6 +0,0 @@
-export * from './useEffectIgnoreInitial';
-export * from './useOnResize';
-export * from './useOutsideAlerter';
-export * from './useSafeContext';
-export * from './useSize';
-export * from './useTimeLeft';

package/mjs/index.js

@@ -1,10 +0,0 @@
-export * from './useEffectIgnoreInitial';
-export * from './useOnResize';
-export * from './useOutsideAlerter';
-export * from './useSafeContext';
-export * from './useSize';
-export * from './useTimeLeft';
-
-//# sourceMappingURL=index.js.map
-
-//# sourceMappingURL=index.js.map

package/mjs/index.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/index.tsx"],"names":[],"mappings":"AAGA,cAAc,0BAA0B,CAAA;AACxC,cAAc,eAAe,CAAA;AAC7B,cAAc,qBAAqB,CAAA;AACnC,cAAc,kBAAkB,CAAA;AAChC,cAAc,WAAW,CAAA;AACzB,cAAc,eAAe,CAAA","file":"index.js","sourcesContent":["/* @license Copyright 2024 w3ux authors & contributors\nSPDX-License-Identifier: GPL-3.0-only */\n\nexport * from './useEffectIgnoreInitial'\nexport * from './useOnResize'\nexport * from './useOutsideAlerter'\nexport * from './useSafeContext'\nexport * from './useSize'\nexport * from './useTimeLeft'\n"]}

package/mjs/useEffectIgnoreInitial.d.ts

@@ -1 +0,0 @@
-export declare const useEffectIgnoreInitial: <T, U>(fn: T, deps: U[]) => void;

package/mjs/useEffectIgnoreInitial.js

@@ -1,16 +0,0 @@
-import { useEffect, useRef } from 'react';
-export const useEffectIgnoreInitial = (fn, deps) => {
-    const isInitial = useRef(true);
-    useEffect(() => {
-        if (!isInitial.current) {
-            if (typeof fn === 'function') {
-                fn();
-            }
-        }
-        isInitial.current = false;
-    }, deps ? [...deps] : undefined);
-};
-
-//# sourceMappingURL=useEffectIgnoreInitial.js.map
-
-//# sourceMappingURL=useEffectIgnoreInitial.js.map

package/mjs/useEffectIgnoreInitial.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/useEffectIgnoreInitial.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAA;AAEzC,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAO,EAAK,EAAE,IAAS,EAAE,EAAE;IAC/D,MAAM,SAAS,GAAG,MAAM,CAAU,IAAI,CAAC,CAAA;IAEvC,SAAS,CACP,GAAG,EAAE;QACH,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;YACvB,IAAI,OAAO,EAAE,KAAK,UAAU,EAAE,CAAC;gBAC7B,EAAE,EAAE,CAAA;YACN,CAAC;QACH,CAAC;QACD,SAAS,CAAC,OAAO,GAAG,KAAK,CAAA;IAC3B,CAAC,EACD,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAC7B,CAAA;AACH,CAAC,CAAA","file":"useEffectIgnoreInitial.js","sourcesContent":["/* @license Copyright 2024 w3ux authors & contributors\nSPDX-License-Identifier: GPL-3.0-only */\n\nimport { useEffect, useRef } from 'react'\n\nexport const useEffectIgnoreInitial = <T, U>(fn: T, deps: U[]) => {\n  const isInitial = useRef<boolean>(true)\n\n  useEffect(\n    () => {\n      if (!isInitial.current) {\n        if (typeof fn === 'function') {\n          fn()\n        }\n      }\n      isInitial.current = false\n    },\n    deps ? [...deps] : undefined\n  )\n}\n"]}

package/mjs/useOnResize.d.ts

@@ -1,7 +0,0 @@
-import type { RefObject } from 'react';
-interface UseOnResizeOptions {
-    outerElement?: RefObject<HTMLElement | null>;
-    throttle?: number;
-}
-export declare const useOnResize: (callback: () => void, options?: UseOnResizeOptions) => void;
-export {};

package/mjs/useOnResize.js

@@ -1,24 +0,0 @@
-import { useEffect, useRef } from 'react';
-export const useOnResize = (callback, options = {}) => {
-    const { outerElement, throttle: throttleDuration = 100 } = options;
-    const lastExecutedRef = useRef(0);
-    const handleResize = () => {
-        const now = Date.now();
-        if (now - lastExecutedRef.current < throttleDuration) {
-            return;
-        }
-        lastExecutedRef.current = now;
-        callback();
-    };
-    useEffect(() => {
-        const target = outerElement?.current || window;
-        target.addEventListener('resize', handleResize);
-        return () => {
-            target.removeEventListener('resize', handleResize);
-        };
-    }, [throttleDuration, callback]);
-};
-
-//# sourceMappingURL=useOnResize.js.map
-
-//# sourceMappingURL=useOnResize.js.map

package/mjs/useOnResize.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/useOnResize.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAA;AAiBzC,MAAM,CAAC,MAAM,WAAW,GAAG,CACzB,QAAoB,EACpB,UAA8B,EAAE,EAChC,EAAE;IACF,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,gBAAgB,GAAG,GAAG,EAAE,GAAG,OAAO,CAAA;IAClE,MAAM,eAAe,GAAG,MAAM,CAAS,CAAC,CAAC,CAAA;IAGzC,MAAM,YAAY,GAAG,GAAG,EAAE;QACxB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QAGtB,IAAI,GAAG,GAAG,eAAe,CAAC,OAAO,GAAG,gBAAgB,EAAE,CAAC;YACrD,OAAM;QACR,CAAC;QAED,eAAe,CAAC,OAAO,GAAG,GAAG,CAAA;QAC7B,QAAQ,EAAE,CAAA;IACZ,CAAC,CAAA;IAED,SAAS,CAAC,GAAG,EAAE;QAEb,MAAM,MAAM,GAAG,YAAY,EAAE,OAAO,IAAI,MAAM,CAAA;QAG9C,MAAM,CAAC,gBAAgB,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAA;QAG/C,OAAO,GAAG,EAAE;YACV,MAAM,CAAC,mBAAmB,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAA;QACpD,CAAC,CAAA;IACH,CAAC,EAAE,CAAC,gBAAgB,EAAE,QAAQ,CAAC,CAAC,CAAA;AAClC,CAAC,CAAA","file":"useOnResize.js","sourcesContent":["/* @license Copyright 2024 w3ux authors & contributors\nSPDX-License-Identifier: GPL-3.0-only */\n\nimport type { RefObject } from 'react'\nimport { useEffect, useRef } from 'react'\n\ninterface UseOnResizeOptions {\n  outerElement?: RefObject<HTMLElement | null>\n  throttle?: number\n}\n\n/**\n * Custom hook that triggers a callback function when the specified element\n * or the window is resized.\n *\n * @param callback - The function to be executed on resize.\n * @param options - Optional parameters to customize the behavior:\n *   - outerElement: A ref to an HTMLElement to listen for resize events.\n *   - throttle: Optional duration in milliseconds to throttle the callback execution.\n *               Default is 100 milliseconds.\n */\nexport const useOnResize = (\n  callback: () => void,\n  options: UseOnResizeOptions = {}\n) => {\n  const { outerElement, throttle: throttleDuration = 100 } = options\n  const lastExecutedRef = useRef<number>(0)\n\n  // Throttled resize handler to limit the frequency of callback execution.\n  const handleResize = () => {\n    const now = Date.now()\n\n    // Check if the callback can be executed based on the throttle duration.\n    if (now - lastExecutedRef.current < throttleDuration) {\n      return\n    }\n\n    lastExecutedRef.current = now\n    callback()\n  }\n\n  useEffect(() => {\n    // Determine the target for the resize event listener.\n    const target = outerElement?.current || window\n\n    // Add the resize event listener when the component mounts.\n    target.addEventListener('resize', handleResize)\n\n    // Clean up the event listener when the component unmounts.\n    return () => {\n      target.removeEventListener('resize', handleResize)\n    }\n  }, [throttleDuration, callback])\n}\n"]}

package/mjs/useOutsideAlerter.d.ts

@@ -1,2 +0,0 @@
-import { type RefObject } from 'react';
-export declare const useOutsideAlerter: (ref: RefObject<HTMLElement | null>, callback: () => void, ignore?: string[]) => void;

package/mjs/useOutsideAlerter.js

@@ -1,25 +0,0 @@
-import { useEffect } from 'react';
-export const useOutsideAlerter = (ref, callback, ignore = []) => {
-    useEffect(() => {
-        const handleClickOutside = (ev) => {
-            if (ev) {
-                if (ref.current && !ref.current.contains(ev.target)) {
-                    const target = ev.target;
-                    const tagName = target.tagName.toLowerCase();
-                    const ignored = ignore.some((i) => i.toLowerCase() === tagName || target.closest(`.${i}`) !== null);
-                    if (!ignored) {
-                        callback();
-                    }
-                }
-            }
-        };
-        document.addEventListener('mousedown', handleClickOutside);
-        return () => {
-            document.removeEventListener('mousedown', handleClickOutside);
-        };
-    }, [ref]);
-};
-
-//# sourceMappingURL=useOutsideAlerter.js.map
-
-//# sourceMappingURL=useOutsideAlerter.js.map