@w3ux/hooks 2.4.2 → 2.4.4

package/index.cjs

@@ -21,6 +21,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   createSafeContext: () => createSafeContext,
+  useAutoFitText: () => useAutoFitText,
   useEffectIgnoreInitial: () => useEffectIgnoreInitial,
   useOnResize: () => useOnResize,
   useOutsideAlerter: () => useOutsideAlerter,
@@ -30,11 +31,74 @@ __export(index_exports, {
 });
 module.exports = __toCommonJS(index_exports);
 
-// src/useEffectIgnoreInitial.tsx
+// src/useAutoFitText.tsx
 var import_react = require("react");
+var useAutoFitText = ({
+  minFontSize = 0.625,
+  maxFontSize = 1.08,
+  unit = "rem"
+} = {}) => {
+  const containerRef = (0, import_react.useRef)(null);
+  const [fontSize, setFontSize] = (0, import_react.useState)(`${maxFontSize}${unit}`);
+  const calculateOptimalFontSize = (0, import_react.useCallback)(
+    (container) => {
+      const containerWidth = container.offsetWidth;
+      if (containerWidth === 0) return;
+      const originalFontSize = container.style.fontSize;
+      let low = minFontSize;
+      let high = maxFontSize;
+      let bestSize = minFontSize;
+      const precision = 1e-3;
+      while (high - low > precision) {
+        const mid = (low + high) / 2;
+        container.style.fontSize = `${mid}${unit}`;
+        const scrollWidth = container.scrollWidth;
+        if (scrollWidth <= containerWidth) {
+          bestSize = mid;
+          low = mid;
+        } else {
+          high = mid;
+        }
+      }
+      container.style.fontSize = originalFontSize;
+      const newFontSize = `${bestSize}${unit}`;
+      setFontSize((prev) => prev === newFontSize ? prev : newFontSize);
+    },
+    [minFontSize, maxFontSize, unit]
+  );
+  (0, import_react.useEffect)(() => {
+    const container = containerRef.current;
+    if (!container) return;
+    let debounceTimer = null;
+    const debouncedCalculate = () => {
+      if (debounceTimer) clearTimeout(debounceTimer);
+      debounceTimer = setTimeout(() => {
+        calculateOptimalFontSize(container);
+      }, 5);
+    };
+    const resizeObserver = new ResizeObserver(debouncedCalculate);
+    const mutationObserver = new MutationObserver(debouncedCalculate);
+    resizeObserver.observe(container);
+    mutationObserver.observe(container, {
+      childList: true,
+      subtree: true,
+      characterData: true
+    });
+    calculateOptimalFontSize(container);
+    return () => {
+      if (debounceTimer) clearTimeout(debounceTimer);
+      resizeObserver.disconnect();
+      mutationObserver.disconnect();
+    };
+  }, [calculateOptimalFontSize]);
+  return { containerRef, fontSize };
+};
+
+// src/useEffectIgnoreInitial.tsx
+var import_react2 = require("react");
 var useEffectIgnoreInitial = (fn, deps) => {
-  const isInitial = (0, import_react.useRef)(true);
-  (0, import_react.useEffect)(
+  const isInitial = (0, import_react2.useRef)(true);
+  (0, import_react2.useEffect)(
     () => {
       if (!isInitial.current) {
         if (typeof fn === "function") {
@@ -48,10 +112,10 @@ var useEffectIgnoreInitial = (fn, deps) => {
 };
 
 // src/useOnResize.tsx
-var import_react2 = require("react");
+var import_react3 = require("react");
 var useOnResize = (callback, options = {}) => {
   const { outerElement, throttle: throttleDuration = 100 } = options;
-  const lastExecutedRef = (0, import_react2.useRef)(0);
+  const lastExecutedRef = (0, import_react3.useRef)(0);
   const handleResize = () => {
     const now = Date.now();
     if (now - lastExecutedRef.current < throttleDuration) {
@@ -60,7 +124,7 @@ var useOnResize = (callback, options = {}) => {
     lastExecutedRef.current = now;
     callback();
   };
-  (0, import_react2.useEffect)(() => {
+  (0, import_react3.useEffect)(() => {
     const target = outerElement?.current || window;
     target.addEventListener("resize", handleResize);
     return () => {
@@ -70,9 +134,9 @@ var useOnResize = (callback, options = {}) => {
 };
 
 // src/useOutsideAlerter.tsx
-var import_react3 = require("react");
+var import_react4 = require("react");
 var useOutsideAlerter = (ref, callback, ignore = []) => {
-  (0, import_react3.useEffect)(() => {
+  (0, import_react4.useEffect)(() => {
     const handleClickOutside = (ev) => {
       if (ev) {
         if (ref.current && !ref.current.contains(ev.target)) {
@@ -95,7 +159,7 @@ var useOutsideAlerter = (ref, callback, ignore = []) => {
 };
 
 // src/useSafeContext.tsx
-var import_react4 = require("react");
+var import_react5 = require("react");
 var useSafeContext = (ctx) => {
   if (ctx === null || ctx === void 0) {
     throw new Error(
@@ -105,13 +169,13 @@ var useSafeContext = (ctx) => {
   return ctx;
 };
 var createSafeContext = () => {
-  const Context = (0, import_react4.createContext)(null);
-  const useHook = () => useSafeContext((0, import_react4.useContext)(Context));
+  const Context = (0, import_react5.createContext)(null);
+  const useHook = () => useSafeContext((0, import_react5.useContext)(Context));
   return [Context, useHook];
 };
 
 // src/useSize.tsx
-var import_react5 = require("react");
+var import_react6 = require("react");
 var useSize = (element, options = {}) => {
   const { outerElement, throttle: throttleDuration = 100 } = options;
   const getSize = (el = null) => {
@@ -119,8 +183,8 @@ var useSize = (element, options = {}) => {
     const height = el?.offsetHeight || 0;
     return { width, height };
   };
-  const lastExecutedRef = (0, import_react5.useRef)(0);
-  const [size, setSize] = (0, import_react5.useState)(
+  const lastExecutedRef = (0, import_react6.useRef)(0);
+  const [size, setSize] = (0, import_react6.useState)(
     getSize(element?.current)
   );
   const handleResize = () => {
@@ -131,7 +195,7 @@ var useSize = (element, options = {}) => {
     lastExecutedRef.current = now;
     setSize(getSize(element?.current));
   };
-  (0, import_react5.useEffect)(() => {
+  (0, import_react6.useEffect)(() => {
     const listenFor = outerElement?.current || window;
     listenFor.addEventListener("resize", handleResize);
     return () => {
@@ -143,7 +207,7 @@ var useSize = (element, options = {}) => {
 
 // src/useTimeLeft/index.tsx
 var import_utils = require("@w3ux/utils");
-var import_react6 = require("react");
+var import_react7 = require("react");
 
 // src/util.ts
 var import_date_fns = require("date-fns");
@@ -214,14 +278,14 @@ var useTimeLeft = (props) => {
       raw
     };
   };
-  const [to, setTo] = (0, import_react6.useState)(null);
-  const toRef = (0, import_react6.useRef)(to);
-  const [timeleft, setTimeleft] = (0, import_react6.useState)(getTimeleft());
-  const [minInterval, setMinInterval] = (0, import_react6.useState)(void 0);
-  const minIntervalRef = (0, import_react6.useRef)(minInterval);
-  const [secInterval, setSecInterval] = (0, import_react6.useState)(void 0);
-  const secIntervalRef = (0, import_react6.useRef)(secInterval);
-  (0, import_react6.useEffect)(() => {
+  const [to, setTo] = (0, import_react7.useState)(null);
+  const toRef = (0, import_react7.useRef)(to);
+  const [timeleft, setTimeleft] = (0, import_react7.useState)(getTimeleft());
+  const [minInterval, setMinInterval] = (0, import_react7.useState)(void 0);
+  const minIntervalRef = (0, import_react7.useRef)(minInterval);
+  const [secInterval, setSecInterval] = (0, import_react7.useState)(void 0);
+  const secIntervalRef = (0, import_react7.useRef)(secInterval);
+  (0, import_react7.useEffect)(() => {
     setTimeleft(getTimeleft());
     if (inLastHour()) {
       if (!secIntervalRef.current) {
@@ -245,10 +309,10 @@ var useTimeLeft = (props) => {
       (0, import_utils.setStateWithRef)(interval, setMinInterval, minIntervalRef);
     }
   }, [to, inLastHour(), lastMinuteCountdown(), ...depsTimeleft]);
-  (0, import_react6.useEffect)(() => {
+  (0, import_react7.useEffect)(() => {
     setTimeleft(getTimeleft());
   }, [...depsFormat]);
-  (0, import_react6.useEffect)(
+  (0, import_react7.useEffect)(
     () => () => {
       clearInterval(minInterval);
       clearInterval(secInterval);
@@ -267,6 +331,7 @@ var useTimeLeft = (props) => {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   createSafeContext,
+  useAutoFitText,
   useEffectIgnoreInitial,
   useOnResize,
   useOutsideAlerter,

package/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.tsx","../src/useEffectIgnoreInitial.tsx","../src/useOnResize.tsx","../src/useOutsideAlerter.tsx","../src/useSafeContext.tsx","../src/useSize.tsx","../src/useTimeLeft/index.tsx","../src/util.ts","../src/useTimeLeft/defaults.ts"],"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","/* @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\tconst isInitial = useRef<boolean>(true)\n\n\tuseEffect(\n\t\t() => {\n\t\t\tif (!isInitial.current) {\n\t\t\t\tif (typeof fn === 'function') {\n\t\t\t\t\tfn()\n\t\t\t\t}\n\t\t\t}\n\t\t\tisInitial.current = false\n\t\t},\n\t\tdeps ? [...deps] : undefined,\n\t)\n}\n","/* @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\touterElement?: RefObject<HTMLElement | null>\n\tthrottle?: 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\tcallback: () => void,\n\toptions: UseOnResizeOptions = {},\n) => {\n\tconst { outerElement, throttle: throttleDuration = 100 } = options\n\tconst lastExecutedRef = useRef<number>(0)\n\n\t// Throttled resize handler to limit the frequency of callback execution.\n\tconst handleResize = () => {\n\t\tconst now = Date.now()\n\n\t\t// Check if the callback can be executed based on the throttle duration.\n\t\tif (now - lastExecutedRef.current < throttleDuration) {\n\t\t\treturn\n\t\t}\n\n\t\tlastExecutedRef.current = now\n\t\tcallback()\n\t}\n\n\tuseEffect(() => {\n\t\t// Determine the target for the resize event listener.\n\t\tconst target = outerElement?.current || window\n\n\t\t// Add the resize event listener when the component mounts.\n\t\ttarget.addEventListener('resize', handleResize)\n\n\t\t// Clean up the event listener when the component unmounts.\n\t\treturn () => {\n\t\t\ttarget.removeEventListener('resize', handleResize)\n\t\t}\n\t}, [throttleDuration, callback])\n}\n","/* @license Copyright 2024 w3ux authors & contributors\nSPDX-License-Identifier: GPL-3.0-only */\n\nimport { type RefObject, useEffect } from 'react'\n\n// A hook that alerts clicks outside of the passed ref.\nexport const useOutsideAlerter = (\n\tref: RefObject<HTMLElement | null>,\n\tcallback: () => void,\n\tignore: string[] = [],\n) => {\n\tuseEffect(() => {\n\t\tconst handleClickOutside = (ev: MouseEvent) => {\n\t\t\tif (ev) {\n\t\t\t\tif (ref.current && !ref.current.contains(ev.target as Node)) {\n\t\t\t\t\tconst target = ev.target as HTMLElement\n\t\t\t\t\t// Ignore tags with a name of `ignore`, or if there is a class of `ignore` in the parent\n\t\t\t\t\t// tree.\n\t\t\t\t\tconst tagName = target.tagName.toLowerCase()\n\t\t\t\t\tconst ignored = ignore.some(\n\t\t\t\t\t\t(i) =>\n\t\t\t\t\t\t\ti.toLowerCase() === tagName || target.closest(`.${i}`) !== null,\n\t\t\t\t\t)\n\n\t\t\t\t\tif (!ignored) {\n\t\t\t\t\t\tcallback()\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t\tdocument.addEventListener('mousedown', handleClickOutside)\n\t\treturn () => {\n\t\t\tdocument.removeEventListener('mousedown', handleClickOutside)\n\t\t}\n\t}, [ref])\n}\n","/* @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\tif (ctx === null || ctx === undefined) {\n\t\tthrow new Error(\n\t\t\t'Context value is null or undefined. Please ensure the context Provider is used correctly.',\n\t\t)\n\t}\n\treturn ctx\n}\n\nexport const createSafeContext = <T,>(): [Context<T | null>, () => T] => {\n\tconst Context = createContext<T | null>(null)\n\tconst useHook = () => useSafeContext<T>(useContext(Context))\n\treturn [Context, useHook]\n}\n","/* @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\touterElement?: RefObject<HTMLElement | null>\n\tthrottle?: 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\telement: RefObject<HTMLElement | null>,\n\toptions: UseSizeOptions = {},\n) => {\n\tconst { outerElement, throttle: throttleDuration = 100 } = options\n\n\t// Helper function to retrieve the width and height of an element\n\t// If no element is found, default dimensions are set to 0.\n\tconst getSize = (el: HTMLElement | null = null) => {\n\t\tconst width = el?.offsetWidth || 0\n\t\tconst height = el?.offsetHeight || 0\n\t\treturn { width, height }\n\t}\n\n\t// Ref to store the last execution time of the `resizeThrottle` handler.\n\tconst lastExecutedRef = useRef<number>(0)\n\n\t// State to store the current width and height of the specified element.\n\tconst [size, setSize] = useState<{ width: number; height: number }>(\n\t\tgetSize(element?.current),\n\t)\n\n\t// Throttle the resize event handler to limit how often size updates occur.\n\tconst handleResize = () => {\n\t\tconst now = Date.now()\n\t\tif (now - lastExecutedRef.current < throttleDuration) {\n\t\t\treturn\n\t\t} // Exit if `throttleDuration` has not passed.\n\n\t\tlastExecutedRef.current = now // Update last execution time.\n\n\t\tsetSize(getSize(element?.current))\n\t}\n\n\t// Set up the resize event listener on mount and clean it up on unmount.\n\tuseEffect(() => {\n\t\t// Determine the target for the resize event listener.\n\t\t// If `outerElement` is provided, listen to its resize events; otherwise, listen to the window's.\n\t\tconst listenFor = outerElement?.current || window\n\n\t\tlistenFor.addEventListener('resize', handleResize)\n\n\t\t// Clean up event listener when the component unmounts to avoid memory leaks.\n\t\treturn () => {\n\t\t\tlistenFor.removeEventListener('resize', handleResize)\n\t\t}\n\t}, [outerElement?.current])\n\n\t// Return the current size of the element.\n\treturn size\n}\n","/* @license Copyright 2024 w3ux authors & contributors\nSPDX-License-Identifier: GPL-3.0-only */\n\nimport type {\n\tTimeLeftAll,\n\tTimeLeftRaw,\n\tTimeleftDuration,\n\tUseTimeleftProps,\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\tconst depsTimeleft = props?.depsTimeleft || []\n\tconst depsFormat = props?.depsFormat || []\n\n\t// check whether timeleft is within a minute of finishing.\n\tconst inLastHour = () => {\n\t\tconst { days, hours } = getDuration(toRef.current)\n\t\treturn !days && !hours\n\t}\n\n\t// get the amount of seconds left if timeleft is in the last minute.\n\tconst lastMinuteCountdown = () => {\n\t\tconst { seconds } = getDuration(toRef.current)\n\t\tif (!inLastHour()) {\n\t\t\treturn 60\n\t\t}\n\t\treturn seconds\n\t}\n\n\t// calculate resulting timeleft object from latest duration.\n\tconst getTimeleft = (c?: TimeleftDuration): TimeLeftAll => {\n\t\tconst { days, hours, minutes, seconds } = c || getDuration(toRef.current)\n\t\tconst raw: TimeLeftRaw = {\n\t\t\tdays,\n\t\t\thours,\n\t\t\tminutes,\n\t\t}\n\t\tif (!days && !hours) {\n\t\t\traw.seconds = seconds\n\t\t}\n\t\treturn {\n\t\t\traw,\n\t\t}\n\t}\n\n\t// the end time as a date.\n\tconst [to, setTo] = useState<Date | null>(null)\n\tconst toRef = useRef(to)\n\n\t// resulting timeleft object to be returned.\n\tconst [timeleft, setTimeleft] = useState<TimeLeftAll>(getTimeleft())\n\n\t// timeleft refresh intervals.\n\tconst [minInterval, setMinInterval] = useState<\n\t\tReturnType<typeof setInterval> | undefined\n\t>(undefined)\n\tconst minIntervalRef = useRef(minInterval)\n\n\tconst [secInterval, setSecInterval] = useState<\n\t\tReturnType<typeof setInterval> | undefined\n\t>(undefined)\n\tconst secIntervalRef = useRef(secInterval)\n\n\t// refresh effects.\n\tuseEffect(() => {\n\t\tsetTimeleft(getTimeleft())\n\t\tif (inLastHour()) {\n\t\t\t// refresh timeleft every second.\n\t\t\tif (!secIntervalRef.current) {\n\t\t\t\tconst interval = setInterval(() => {\n\t\t\t\t\tif (!inLastHour()) {\n\t\t\t\t\t\tclearInterval(secIntervalRef.current)\n\t\t\t\t\t\tsetStateWithRef(undefined, setSecInterval, secIntervalRef)\n\t\t\t\t\t}\n\t\t\t\t\tsetTimeleft(getTimeleft())\n\t\t\t\t}, 1000)\n\n\t\t\t\tsetStateWithRef(interval, setSecInterval, secIntervalRef)\n\t\t\t}\n\t\t}\n\t\t// refresh timeleft every minute.\n\t\telse if (!minIntervalRef.current) {\n\t\t\tconst interval = setInterval(() => {\n\t\t\t\tif (inLastHour()) {\n\t\t\t\t\tclearInterval(minIntervalRef.current)\n\t\t\t\t\tsetStateWithRef(undefined, setMinInterval, minIntervalRef)\n\t\t\t\t}\n\t\t\t\tsetTimeleft(getTimeleft())\n\t\t\t}, 60000)\n\t\t\tsetStateWithRef(interval, setMinInterval, minIntervalRef)\n\t\t}\n\t}, [to, inLastHour(), lastMinuteCountdown(), ...depsTimeleft])\n\n\t// re-render the timeleft upon formatting changes.\n\tuseEffect(() => {\n\t\tsetTimeleft(getTimeleft())\n\t}, [...depsFormat])\n\n\t// clear intervals on unmount\n\tuseEffect(\n\t\t() => () => {\n\t\t\tclearInterval(minInterval)\n\t\t\tclearInterval(secInterval)\n\t\t},\n\t\t[],\n\t)\n\n\t// Set the end time and calculate timeleft.\n\tconst setFromNow = (dateFrom: Date, dateTo: Date) => {\n\t\tsetTimeleft(getTimeleft(getDuration(dateFrom)))\n\t\tsetStateWithRef(dateTo, setTo, toRef)\n\t}\n\n\treturn {\n\t\tsetFromNow,\n\t\ttimeleft,\n\t}\n}\n","/* @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\tif (!toDate) {\n\t\treturn defaultDuration\n\t}\n\tif (getUnixTime(toDate) <= getUnixTime(new Date())) {\n\t\treturn defaultDuration\n\t}\n\n\ttoDate.setSeconds(toDate.getSeconds())\n\tconst d = intervalToDuration({\n\t\tstart: Date.now(),\n\t\tend: toDate,\n\t})\n\n\tconst days = differenceInDays(toDate, Date.now())\n\tconst hours = d?.hours || 0\n\tconst minutes = d?.minutes || 0\n\tconst seconds = d?.seconds || 0\n\tconst lastHour = days === 0 && hours === 0\n\tconst lastMinute = lastHour && minutes === 0\n\n\treturn {\n\t\tdays,\n\t\thours,\n\t\tminutes,\n\t\tseconds,\n\t\tlastMinute,\n\t}\n}\n\n// Helper: Adds `seconds` to the current time and returns the resulting date.\nexport const secondsFromNow = (seconds: number): Date => {\n\tconst end = new Date()\n\tend.setSeconds(end.getSeconds() + seconds)\n\treturn end\n}\n\n// Helper: Calculates the duration between the current time and the provided date.\nexport const getDurationFromNow = (toDate: Date | null): TimeleftDuration => {\n\tif (!toDate) {\n\t\treturn defaultDuration\n\t}\n\tif (getUnixTime(toDate) <= getUnixTime(new Date())) {\n\t\treturn defaultDuration\n\t}\n\n\ttoDate.setSeconds(toDate.getSeconds())\n\tconst d = intervalToDuration({\n\t\tstart: Date.now(),\n\t\tend: toDate,\n\t})\n\n\tconst days = differenceInDays(toDate, Date.now())\n\tconst hours = d?.hours || 0\n\tconst minutes = d?.minutes || 0\n\tconst seconds = d?.seconds || 0\n\tconst lastHour = days === 0 && hours === 0\n\tconst lastMinute = lastHour && minutes === 0\n\n\treturn {\n\t\tdays,\n\t\thours,\n\t\tminutes,\n\t\tseconds,\n\t\tlastMinute,\n\t}\n}\n","/* @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\tdays: 0,\n\thours: 0,\n\tminutes: 0,\n\tseconds: 0,\n\tlastMinute: false,\n}\n\nexport const defaultRefreshInterval = 60\n"],"mappings":"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","names":["import_react","import_react","import_react","import_react","import_react"]}
+{"version":3,"sources":["../src/index.tsx","../src/useAutoFitText.tsx","../src/useEffectIgnoreInitial.tsx","../src/useOnResize.tsx","../src/useOutsideAlerter.tsx","../src/useSafeContext.tsx","../src/useSize.tsx","../src/useTimeLeft/index.tsx","../src/util.ts","../src/useTimeLeft/defaults.ts"],"sourcesContent":["/* @license Copyright 2024 w3ux authors & contributors\nSPDX-License-Identifier: GPL-3.0-only */\n\nexport * from './useAutoFitText'\nexport * from './useEffectIgnoreInitial'\nexport * from './useOnResize'\nexport * from './useOutsideAlerter'\nexport * from './useSafeContext'\nexport * from './useSize'\nexport * from './useTimeLeft'\n","/* @license Copyright 2024 w3ux authors & contributors\nSPDX-License-Identifier: GPL-3.0-only */\n\nimport { useCallback, useEffect, useRef, useState } from 'react'\n\nexport interface UseAutoFitTextOptions {\n\tminFontSize?: number\n\tmaxFontSize?: number\n\tunit?: string\n}\n\nexport const useAutoFitText = ({\n\tminFontSize = 0.625,\n\tmaxFontSize = 1.08,\n\tunit = 'rem',\n}: UseAutoFitTextOptions = {}) => {\n\tconst containerRef = useRef<HTMLElement>(null)\n\tconst [fontSize, setFontSize] = useState(`${maxFontSize}${unit}`)\n\n\tconst calculateOptimalFontSize = useCallback(\n\t\t(container: HTMLElement) => {\n\t\t\tconst containerWidth = container.offsetWidth\n\n\t\t\tif (containerWidth === 0) return\n\n\t\t\t// Store original font size to restore after measurement\n\t\t\tconst originalFontSize = container.style.fontSize\n\n\t\t\t// Binary search for the optimal font size\n\t\t\t// scrollWidth gives us the actual width needed for the text content at each font size\n\t\t\tlet low = minFontSize\n\t\t\tlet high = maxFontSize\n\t\t\tlet bestSize = minFontSize\n\n\t\t\t// Use a precision of 0.001 for decimal units like rem\n\t\t\tconst precision = 0.001\n\n\t\t\twhile (high - low > precision) {\n\t\t\t\tconst mid = (low + high) / 2\n\t\t\t\tcontainer.style.fontSize = `${mid}${unit}`\n\n\t\t\t\t// scrollWidth measures the text content width at this font size\n\t\t\t\tconst scrollWidth = container.scrollWidth\n\n\t\t\t\tif (scrollWidth <= containerWidth) {\n\t\t\t\t\tbestSize = mid\n\t\t\t\t\tlow = mid\n\t\t\t\t} else {\n\t\t\t\t\thigh = mid\n\t\t\t\t}\n\t\t\t}\n\n\t\t\t// Restore original font size before updating state\n\t\t\tcontainer.style.fontSize = originalFontSize\n\n\t\t\t// Only update state if the value actually changed\n\t\t\tconst newFontSize = `${bestSize}${unit}`\n\t\t\tsetFontSize((prev) => (prev === newFontSize ? prev : newFontSize))\n\t\t},\n\t\t[minFontSize, maxFontSize, unit],\n\t)\n\n\tuseEffect(() => {\n\t\tconst container = containerRef.current\n\t\tif (!container) return\n\n\t\t// Debounce timer to prevent excessive recalculations\n\t\tlet debounceTimer: ReturnType<typeof setTimeout> | null = null\n\n\t\tconst debouncedCalculate = () => {\n\t\t\tif (debounceTimer) clearTimeout(debounceTimer)\n\t\t\tdebounceTimer = setTimeout(() => {\n\t\t\t\tcalculateOptimalFontSize(container)\n\t\t\t}, 5)\n\t\t}\n\n\t\t// ResizeObserver handles container size changes (including window resize)\n\t\tconst resizeObserver = new ResizeObserver(debouncedCalculate)\n\n\t\t// Watch for text content changes (e.g., language switches)\n\t\tconst mutationObserver = new MutationObserver(debouncedCalculate)\n\n\t\t// Initial calculation\n\t\tresizeObserver.observe(container)\n\t\tmutationObserver.observe(container, {\n\t\t\tchildList: true,\n\t\t\tsubtree: true,\n\t\t\tcharacterData: true,\n\t\t})\n\n\t\t// Trigger initial calculation after mount\n\t\tcalculateOptimalFontSize(container)\n\n\t\treturn () => {\n\t\t\tif (debounceTimer) clearTimeout(debounceTimer)\n\t\t\tresizeObserver.disconnect()\n\t\t\tmutationObserver.disconnect()\n\t\t}\n\t}, [calculateOptimalFontSize])\n\n\treturn { containerRef, fontSize }\n}\n","/* @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\tconst isInitial = useRef<boolean>(true)\n\n\tuseEffect(\n\t\t() => {\n\t\t\tif (!isInitial.current) {\n\t\t\t\tif (typeof fn === 'function') {\n\t\t\t\t\tfn()\n\t\t\t\t}\n\t\t\t}\n\t\t\tisInitial.current = false\n\t\t},\n\t\tdeps ? [...deps] : undefined,\n\t)\n}\n","/* @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\touterElement?: RefObject<HTMLElement | null>\n\tthrottle?: 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\tcallback: () => void,\n\toptions: UseOnResizeOptions = {},\n) => {\n\tconst { outerElement, throttle: throttleDuration = 100 } = options\n\tconst lastExecutedRef = useRef<number>(0)\n\n\t// Throttled resize handler to limit the frequency of callback execution.\n\tconst handleResize = () => {\n\t\tconst now = Date.now()\n\n\t\t// Check if the callback can be executed based on the throttle duration.\n\t\tif (now - lastExecutedRef.current < throttleDuration) {\n\t\t\treturn\n\t\t}\n\n\t\tlastExecutedRef.current = now\n\t\tcallback()\n\t}\n\n\tuseEffect(() => {\n\t\t// Determine the target for the resize event listener.\n\t\tconst target = outerElement?.current || window\n\n\t\t// Add the resize event listener when the component mounts.\n\t\ttarget.addEventListener('resize', handleResize)\n\n\t\t// Clean up the event listener when the component unmounts.\n\t\treturn () => {\n\t\t\ttarget.removeEventListener('resize', handleResize)\n\t\t}\n\t}, [throttleDuration, callback])\n}\n","/* @license Copyright 2024 w3ux authors & contributors\nSPDX-License-Identifier: GPL-3.0-only */\n\nimport { type RefObject, useEffect } from 'react'\n\n// A hook that alerts clicks outside of the passed ref.\nexport const useOutsideAlerter = (\n\tref: RefObject<HTMLElement | null>,\n\tcallback: () => void,\n\tignore: string[] = [],\n) => {\n\tuseEffect(() => {\n\t\tconst handleClickOutside = (ev: MouseEvent) => {\n\t\t\tif (ev) {\n\t\t\t\tif (ref.current && !ref.current.contains(ev.target as Node)) {\n\t\t\t\t\tconst target = ev.target as HTMLElement\n\t\t\t\t\t// Ignore tags with a name of `ignore`, or if there is a class of `ignore` in the parent\n\t\t\t\t\t// tree.\n\t\t\t\t\tconst tagName = target.tagName.toLowerCase()\n\t\t\t\t\tconst ignored = ignore.some(\n\t\t\t\t\t\t(i) =>\n\t\t\t\t\t\t\ti.toLowerCase() === tagName || target.closest(`.${i}`) !== null,\n\t\t\t\t\t)\n\n\t\t\t\t\tif (!ignored) {\n\t\t\t\t\t\tcallback()\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t\tdocument.addEventListener('mousedown', handleClickOutside)\n\t\treturn () => {\n\t\t\tdocument.removeEventListener('mousedown', handleClickOutside)\n\t\t}\n\t}, [ref])\n}\n","/* @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\tif (ctx === null || ctx === undefined) {\n\t\tthrow new Error(\n\t\t\t'Context value is null or undefined. Please ensure the context Provider is used correctly.',\n\t\t)\n\t}\n\treturn ctx\n}\n\nexport const createSafeContext = <T,>(): [Context<T | null>, () => T] => {\n\tconst Context = createContext<T | null>(null)\n\tconst useHook = () => useSafeContext<T>(useContext(Context))\n\treturn [Context, useHook]\n}\n","/* @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\touterElement?: RefObject<HTMLElement | null>\n\tthrottle?: 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\telement: RefObject<HTMLElement | null>,\n\toptions: UseSizeOptions = {},\n) => {\n\tconst { outerElement, throttle: throttleDuration = 100 } = options\n\n\t// Helper function to retrieve the width and height of an element\n\t// If no element is found, default dimensions are set to 0.\n\tconst getSize = (el: HTMLElement | null = null) => {\n\t\tconst width = el?.offsetWidth || 0\n\t\tconst height = el?.offsetHeight || 0\n\t\treturn { width, height }\n\t}\n\n\t// Ref to store the last execution time of the `resizeThrottle` handler.\n\tconst lastExecutedRef = useRef<number>(0)\n\n\t// State to store the current width and height of the specified element.\n\tconst [size, setSize] = useState<{ width: number; height: number }>(\n\t\tgetSize(element?.current),\n\t)\n\n\t// Throttle the resize event handler to limit how often size updates occur.\n\tconst handleResize = () => {\n\t\tconst now = Date.now()\n\t\tif (now - lastExecutedRef.current < throttleDuration) {\n\t\t\treturn\n\t\t} // Exit if `throttleDuration` has not passed.\n\n\t\tlastExecutedRef.current = now // Update last execution time.\n\n\t\tsetSize(getSize(element?.current))\n\t}\n\n\t// Set up the resize event listener on mount and clean it up on unmount.\n\tuseEffect(() => {\n\t\t// Determine the target for the resize event listener.\n\t\t// If `outerElement` is provided, listen to its resize events; otherwise, listen to the window's.\n\t\tconst listenFor = outerElement?.current || window\n\n\t\tlistenFor.addEventListener('resize', handleResize)\n\n\t\t// Clean up event listener when the component unmounts to avoid memory leaks.\n\t\treturn () => {\n\t\t\tlistenFor.removeEventListener('resize', handleResize)\n\t\t}\n\t}, [outerElement?.current])\n\n\t// Return the current size of the element.\n\treturn size\n}\n","/* @license Copyright 2024 w3ux authors & contributors\nSPDX-License-Identifier: GPL-3.0-only */\n\nimport type {\n\tTimeLeftAll,\n\tTimeLeftRaw,\n\tTimeleftDuration,\n\tUseTimeleftProps,\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\tconst depsTimeleft = props?.depsTimeleft || []\n\tconst depsFormat = props?.depsFormat || []\n\n\t// check whether timeleft is within a minute of finishing.\n\tconst inLastHour = () => {\n\t\tconst { days, hours } = getDuration(toRef.current)\n\t\treturn !days && !hours\n\t}\n\n\t// get the amount of seconds left if timeleft is in the last minute.\n\tconst lastMinuteCountdown = () => {\n\t\tconst { seconds } = getDuration(toRef.current)\n\t\tif (!inLastHour()) {\n\t\t\treturn 60\n\t\t}\n\t\treturn seconds\n\t}\n\n\t// calculate resulting timeleft object from latest duration.\n\tconst getTimeleft = (c?: TimeleftDuration): TimeLeftAll => {\n\t\tconst { days, hours, minutes, seconds } = c || getDuration(toRef.current)\n\t\tconst raw: TimeLeftRaw = {\n\t\t\tdays,\n\t\t\thours,\n\t\t\tminutes,\n\t\t}\n\t\tif (!days && !hours) {\n\t\t\traw.seconds = seconds\n\t\t}\n\t\treturn {\n\t\t\traw,\n\t\t}\n\t}\n\n\t// the end time as a date.\n\tconst [to, setTo] = useState<Date | null>(null)\n\tconst toRef = useRef(to)\n\n\t// resulting timeleft object to be returned.\n\tconst [timeleft, setTimeleft] = useState<TimeLeftAll>(getTimeleft())\n\n\t// timeleft refresh intervals.\n\tconst [minInterval, setMinInterval] = useState<\n\t\tReturnType<typeof setInterval> | undefined\n\t>(undefined)\n\tconst minIntervalRef = useRef(minInterval)\n\n\tconst [secInterval, setSecInterval] = useState<\n\t\tReturnType<typeof setInterval> | undefined\n\t>(undefined)\n\tconst secIntervalRef = useRef(secInterval)\n\n\t// refresh effects.\n\tuseEffect(() => {\n\t\tsetTimeleft(getTimeleft())\n\t\tif (inLastHour()) {\n\t\t\t// refresh timeleft every second.\n\t\t\tif (!secIntervalRef.current) {\n\t\t\t\tconst interval = setInterval(() => {\n\t\t\t\t\tif (!inLastHour()) {\n\t\t\t\t\t\tclearInterval(secIntervalRef.current)\n\t\t\t\t\t\tsetStateWithRef(undefined, setSecInterval, secIntervalRef)\n\t\t\t\t\t}\n\t\t\t\t\tsetTimeleft(getTimeleft())\n\t\t\t\t}, 1000)\n\n\t\t\t\tsetStateWithRef(interval, setSecInterval, secIntervalRef)\n\t\t\t}\n\t\t}\n\t\t// refresh timeleft every minute.\n\t\telse if (!minIntervalRef.current) {\n\t\t\tconst interval = setInterval(() => {\n\t\t\t\tif (inLastHour()) {\n\t\t\t\t\tclearInterval(minIntervalRef.current)\n\t\t\t\t\tsetStateWithRef(undefined, setMinInterval, minIntervalRef)\n\t\t\t\t}\n\t\t\t\tsetTimeleft(getTimeleft())\n\t\t\t}, 60000)\n\t\t\tsetStateWithRef(interval, setMinInterval, minIntervalRef)\n\t\t}\n\t}, [to, inLastHour(), lastMinuteCountdown(), ...depsTimeleft])\n\n\t// re-render the timeleft upon formatting changes.\n\tuseEffect(() => {\n\t\tsetTimeleft(getTimeleft())\n\t}, [...depsFormat])\n\n\t// clear intervals on unmount\n\tuseEffect(\n\t\t() => () => {\n\t\t\tclearInterval(minInterval)\n\t\t\tclearInterval(secInterval)\n\t\t},\n\t\t[],\n\t)\n\n\t// Set the end time and calculate timeleft.\n\tconst setFromNow = (dateFrom: Date, dateTo: Date) => {\n\t\tsetTimeleft(getTimeleft(getDuration(dateFrom)))\n\t\tsetStateWithRef(dateTo, setTo, toRef)\n\t}\n\n\treturn {\n\t\tsetFromNow,\n\t\ttimeleft,\n\t}\n}\n","/* @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\tif (!toDate) {\n\t\treturn defaultDuration\n\t}\n\tif (getUnixTime(toDate) <= getUnixTime(new Date())) {\n\t\treturn defaultDuration\n\t}\n\n\ttoDate.setSeconds(toDate.getSeconds())\n\tconst d = intervalToDuration({\n\t\tstart: Date.now(),\n\t\tend: toDate,\n\t})\n\n\tconst days = differenceInDays(toDate, Date.now())\n\tconst hours = d?.hours || 0\n\tconst minutes = d?.minutes || 0\n\tconst seconds = d?.seconds || 0\n\tconst lastHour = days === 0 && hours === 0\n\tconst lastMinute = lastHour && minutes === 0\n\n\treturn {\n\t\tdays,\n\t\thours,\n\t\tminutes,\n\t\tseconds,\n\t\tlastMinute,\n\t}\n}\n\n// Helper: Adds `seconds` to the current time and returns the resulting date.\nexport const secondsFromNow = (seconds: number): Date => {\n\tconst end = new Date()\n\tend.setSeconds(end.getSeconds() + seconds)\n\treturn end\n}\n\n// Helper: Calculates the duration between the current time and the provided date.\nexport const getDurationFromNow = (toDate: Date | null): TimeleftDuration => {\n\tif (!toDate) {\n\t\treturn defaultDuration\n\t}\n\tif (getUnixTime(toDate) <= getUnixTime(new Date())) {\n\t\treturn defaultDuration\n\t}\n\n\ttoDate.setSeconds(toDate.getSeconds())\n\tconst d = intervalToDuration({\n\t\tstart: Date.now(),\n\t\tend: toDate,\n\t})\n\n\tconst days = differenceInDays(toDate, Date.now())\n\tconst hours = d?.hours || 0\n\tconst minutes = d?.minutes || 0\n\tconst seconds = d?.seconds || 0\n\tconst lastHour = days === 0 && hours === 0\n\tconst lastMinute = lastHour && minutes === 0\n\n\treturn {\n\t\tdays,\n\t\thours,\n\t\tminutes,\n\t\tseconds,\n\t\tlastMinute,\n\t}\n}\n","/* @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\tdays: 0,\n\thours: 0,\n\tminutes: 0,\n\tseconds: 0,\n\tlastMinute: false,\n}\n\nexport const defaultRefreshInterval = 60\n"],"mappings":"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","names":["import_react","import_react","import_react","import_react","import_react","import_react"]}

package/index.d.cts

@@ -1,6 +1,17 @@
+import * as react from 'react';
 import { RefObject, Context } from 'react';
 import { UseTimeleftProps, TimeLeftAll } from '@w3ux/types';
 
+interface UseAutoFitTextOptions {
+    minFontSize?: number;
+    maxFontSize?: number;
+    unit?: string;
+}
+declare const useAutoFitText: ({ minFontSize, maxFontSize, unit, }?: UseAutoFitTextOptions) => {
+    containerRef: react.RefObject<HTMLElement | null>;
+    fontSize: string;
+};
+
 declare const useEffectIgnoreInitial: <T, U>(fn: T, deps: U[]) => void;
 
 interface UseOnResizeOptions {
@@ -38,4 +49,4 @@ declare const useTimeLeft: (props?: UseTimeleftProps) => {
     timeleft: TimeLeftAll;
 };
 
-export { createSafeContext, useEffectIgnoreInitial, useOnResize, useOutsideAlerter, useSafeContext, useSize, useTimeLeft };
+export { type UseAutoFitTextOptions, createSafeContext, useAutoFitText, useEffectIgnoreInitial, useOnResize, useOutsideAlerter, useSafeContext, useSize, useTimeLeft };

package/index.d.ts

@@ -1,6 +1,17 @@
+import * as react from 'react';
 import { RefObject, Context } from 'react';
 import { UseTimeleftProps, TimeLeftAll } from '@w3ux/types';
 
+interface UseAutoFitTextOptions {
+    minFontSize?: number;
+    maxFontSize?: number;
+    unit?: string;
+}
+declare const useAutoFitText: ({ minFontSize, maxFontSize, unit, }?: UseAutoFitTextOptions) => {
+    containerRef: react.RefObject<HTMLElement | null>;
+    fontSize: string;
+};
+
 declare const useEffectIgnoreInitial: <T, U>(fn: T, deps: U[]) => void;
 
 interface UseOnResizeOptions {
@@ -38,4 +49,4 @@ declare const useTimeLeft: (props?: UseTimeleftProps) => {
     timeleft: TimeLeftAll;
 };
 
-export { createSafeContext, useEffectIgnoreInitial, useOnResize, useOutsideAlerter, useSafeContext, useSize, useTimeLeft };
+export { type UseAutoFitTextOptions, createSafeContext, useAutoFitText, useEffectIgnoreInitial, useOnResize, useOutsideAlerter, useSafeContext, useSize, useTimeLeft };

package/index.js

@@ -2,11 +2,74 @@ import {
   getDuration
 } from "./chunk-I2A6YRXU.js";
 
+// src/useAutoFitText.tsx
+import { useCallback, useEffect, useRef, useState } from "react";
+var useAutoFitText = ({
+  minFontSize = 0.625,
+  maxFontSize = 1.08,
+  unit = "rem"
+} = {}) => {
+  const containerRef = useRef(null);
+  const [fontSize, setFontSize] = useState(`${maxFontSize}${unit}`);
+  const calculateOptimalFontSize = useCallback(
+    (container) => {
+      const containerWidth = container.offsetWidth;
+      if (containerWidth === 0) return;
+      const originalFontSize = container.style.fontSize;
+      let low = minFontSize;
+      let high = maxFontSize;
+      let bestSize = minFontSize;
+      const precision = 1e-3;
+      while (high - low > precision) {
+        const mid = (low + high) / 2;
+        container.style.fontSize = `${mid}${unit}`;
+        const scrollWidth = container.scrollWidth;
+        if (scrollWidth <= containerWidth) {
+          bestSize = mid;
+          low = mid;
+        } else {
+          high = mid;
+        }
+      }
+      container.style.fontSize = originalFontSize;
+      const newFontSize = `${bestSize}${unit}`;
+      setFontSize((prev) => prev === newFontSize ? prev : newFontSize);
+    },
+    [minFontSize, maxFontSize, unit]
+  );
+  useEffect(() => {
+    const container = containerRef.current;
+    if (!container) return;
+    let debounceTimer = null;
+    const debouncedCalculate = () => {
+      if (debounceTimer) clearTimeout(debounceTimer);
+      debounceTimer = setTimeout(() => {
+        calculateOptimalFontSize(container);
+      }, 5);
+    };
+    const resizeObserver = new ResizeObserver(debouncedCalculate);
+    const mutationObserver = new MutationObserver(debouncedCalculate);
+    resizeObserver.observe(container);
+    mutationObserver.observe(container, {
+      childList: true,
+      subtree: true,
+      characterData: true
+    });
+    calculateOptimalFontSize(container);
+    return () => {
+      if (debounceTimer) clearTimeout(debounceTimer);
+      resizeObserver.disconnect();
+      mutationObserver.disconnect();
+    };
+  }, [calculateOptimalFontSize]);
+  return { containerRef, fontSize };
+};
+
 // src/useEffectIgnoreInitial.tsx
-import { useEffect, useRef } from "react";
+import { useEffect as useEffect2, useRef as useRef2 } from "react";
 var useEffectIgnoreInitial = (fn, deps) => {
-  const isInitial = useRef(true);
-  useEffect(
+  const isInitial = useRef2(true);
+  useEffect2(
     () => {
       if (!isInitial.current) {
         if (typeof fn === "function") {
@@ -20,10 +83,10 @@ var useEffectIgnoreInitial = (fn, deps) => {
 };
 
 // src/useOnResize.tsx
-import { useEffect as useEffect2, useRef as useRef2 } from "react";
+import { useEffect as useEffect3, useRef as useRef3 } from "react";
 var useOnResize = (callback, options = {}) => {
   const { outerElement, throttle: throttleDuration = 100 } = options;
-  const lastExecutedRef = useRef2(0);
+  const lastExecutedRef = useRef3(0);
   const handleResize = () => {
     const now = Date.now();
     if (now - lastExecutedRef.current < throttleDuration) {
@@ -32,7 +95,7 @@ var useOnResize = (callback, options = {}) => {
     lastExecutedRef.current = now;
     callback();
   };
-  useEffect2(() => {
+  useEffect3(() => {
     const target = outerElement?.current || window;
     target.addEventListener("resize", handleResize);
     return () => {
@@ -42,9 +105,9 @@ var useOnResize = (callback, options = {}) => {
 };
 
 // src/useOutsideAlerter.tsx
-import { useEffect as useEffect3 } from "react";
+import { useEffect as useEffect4 } from "react";
 var useOutsideAlerter = (ref, callback, ignore = []) => {
-  useEffect3(() => {
+  useEffect4(() => {
     const handleClickOutside = (ev) => {
       if (ev) {
         if (ref.current && !ref.current.contains(ev.target)) {
@@ -83,7 +146,7 @@ var createSafeContext = () => {
 };
 
 // src/useSize.tsx
-import { useEffect as useEffect4, useRef as useRef3, useState } from "react";
+import { useEffect as useEffect5, useRef as useRef4, useState as useState2 } from "react";
 var useSize = (element, options = {}) => {
   const { outerElement, throttle: throttleDuration = 100 } = options;
   const getSize = (el = null) => {
@@ -91,8 +154,8 @@ var useSize = (element, options = {}) => {
     const height = el?.offsetHeight || 0;
     return { width, height };
   };
-  const lastExecutedRef = useRef3(0);
-  const [size, setSize] = useState(
+  const lastExecutedRef = useRef4(0);
+  const [size, setSize] = useState2(
     getSize(element?.current)
   );
   const handleResize = () => {
@@ -103,7 +166,7 @@ var useSize = (element, options = {}) => {
     lastExecutedRef.current = now;
     setSize(getSize(element?.current));
   };
-  useEffect4(() => {
+  useEffect5(() => {
     const listenFor = outerElement?.current || window;
     listenFor.addEventListener("resize", handleResize);
     return () => {
@@ -115,7 +178,7 @@ var useSize = (element, options = {}) => {
 
 // src/useTimeLeft/index.tsx
 import { setStateWithRef } from "@w3ux/utils";
-import { useEffect as useEffect5, useRef as useRef4, useState as useState2 } from "react";
+import { useEffect as useEffect6, useRef as useRef5, useState as useState3 } from "react";
 var useTimeLeft = (props) => {
   const depsTimeleft = props?.depsTimeleft || [];
   const depsFormat = props?.depsFormat || [];
@@ -144,14 +207,14 @@ var useTimeLeft = (props) => {
       raw
     };
   };
-  const [to, setTo] = useState2(null);
-  const toRef = useRef4(to);
-  const [timeleft, setTimeleft] = useState2(getTimeleft());
-  const [minInterval, setMinInterval] = useState2(void 0);
-  const minIntervalRef = useRef4(minInterval);
-  const [secInterval, setSecInterval] = useState2(void 0);
-  const secIntervalRef = useRef4(secInterval);
-  useEffect5(() => {
+  const [to, setTo] = useState3(null);
+  const toRef = useRef5(to);
+  const [timeleft, setTimeleft] = useState3(getTimeleft());
+  const [minInterval, setMinInterval] = useState3(void 0);
+  const minIntervalRef = useRef5(minInterval);
+  const [secInterval, setSecInterval] = useState3(void 0);
+  const secIntervalRef = useRef5(secInterval);
+  useEffect6(() => {
     setTimeleft(getTimeleft());
     if (inLastHour()) {
       if (!secIntervalRef.current) {
@@ -175,10 +238,10 @@ var useTimeLeft = (props) => {
       setStateWithRef(interval, setMinInterval, minIntervalRef);
     }
   }, [to, inLastHour(), lastMinuteCountdown(), ...depsTimeleft]);
-  useEffect5(() => {
+  useEffect6(() => {
     setTimeleft(getTimeleft());
   }, [...depsFormat]);
-  useEffect5(
+  useEffect6(
     () => () => {
       clearInterval(minInterval);
       clearInterval(secInterval);
@@ -196,6 +259,7 @@ var useTimeLeft = (props) => {
 };
 export {
   createSafeContext,
+  useAutoFitText,
   useEffectIgnoreInitial,
   useOnResize,
   useOutsideAlerter,

package/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/useEffectIgnoreInitial.tsx","../src/useOnResize.tsx","../src/useOutsideAlerter.tsx","../src/useSafeContext.tsx","../src/useSize.tsx","../src/useTimeLeft/index.tsx"],"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\tconst isInitial = useRef<boolean>(true)\n\n\tuseEffect(\n\t\t() => {\n\t\t\tif (!isInitial.current) {\n\t\t\t\tif (typeof fn === 'function') {\n\t\t\t\t\tfn()\n\t\t\t\t}\n\t\t\t}\n\t\t\tisInitial.current = false\n\t\t},\n\t\tdeps ? [...deps] : undefined,\n\t)\n}\n","/* @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\touterElement?: RefObject<HTMLElement | null>\n\tthrottle?: 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\tcallback: () => void,\n\toptions: UseOnResizeOptions = {},\n) => {\n\tconst { outerElement, throttle: throttleDuration = 100 } = options\n\tconst lastExecutedRef = useRef<number>(0)\n\n\t// Throttled resize handler to limit the frequency of callback execution.\n\tconst handleResize = () => {\n\t\tconst now = Date.now()\n\n\t\t// Check if the callback can be executed based on the throttle duration.\n\t\tif (now - lastExecutedRef.current < throttleDuration) {\n\t\t\treturn\n\t\t}\n\n\t\tlastExecutedRef.current = now\n\t\tcallback()\n\t}\n\n\tuseEffect(() => {\n\t\t// Determine the target for the resize event listener.\n\t\tconst target = outerElement?.current || window\n\n\t\t// Add the resize event listener when the component mounts.\n\t\ttarget.addEventListener('resize', handleResize)\n\n\t\t// Clean up the event listener when the component unmounts.\n\t\treturn () => {\n\t\t\ttarget.removeEventListener('resize', handleResize)\n\t\t}\n\t}, [throttleDuration, callback])\n}\n","/* @license Copyright 2024 w3ux authors & contributors\nSPDX-License-Identifier: GPL-3.0-only */\n\nimport { type RefObject, useEffect } from 'react'\n\n// A hook that alerts clicks outside of the passed ref.\nexport const useOutsideAlerter = (\n\tref: RefObject<HTMLElement | null>,\n\tcallback: () => void,\n\tignore: string[] = [],\n) => {\n\tuseEffect(() => {\n\t\tconst handleClickOutside = (ev: MouseEvent) => {\n\t\t\tif (ev) {\n\t\t\t\tif (ref.current && !ref.current.contains(ev.target as Node)) {\n\t\t\t\t\tconst target = ev.target as HTMLElement\n\t\t\t\t\t// Ignore tags with a name of `ignore`, or if there is a class of `ignore` in the parent\n\t\t\t\t\t// tree.\n\t\t\t\t\tconst tagName = target.tagName.toLowerCase()\n\t\t\t\t\tconst ignored = ignore.some(\n\t\t\t\t\t\t(i) =>\n\t\t\t\t\t\t\ti.toLowerCase() === tagName || target.closest(`.${i}`) !== null,\n\t\t\t\t\t)\n\n\t\t\t\t\tif (!ignored) {\n\t\t\t\t\t\tcallback()\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t\tdocument.addEventListener('mousedown', handleClickOutside)\n\t\treturn () => {\n\t\t\tdocument.removeEventListener('mousedown', handleClickOutside)\n\t\t}\n\t}, [ref])\n}\n","/* @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\tif (ctx === null || ctx === undefined) {\n\t\tthrow new Error(\n\t\t\t'Context value is null or undefined. Please ensure the context Provider is used correctly.',\n\t\t)\n\t}\n\treturn ctx\n}\n\nexport const createSafeContext = <T,>(): [Context<T | null>, () => T] => {\n\tconst Context = createContext<T | null>(null)\n\tconst useHook = () => useSafeContext<T>(useContext(Context))\n\treturn [Context, useHook]\n}\n","/* @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\touterElement?: RefObject<HTMLElement | null>\n\tthrottle?: 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\telement: RefObject<HTMLElement | null>,\n\toptions: UseSizeOptions = {},\n) => {\n\tconst { outerElement, throttle: throttleDuration = 100 } = options\n\n\t// Helper function to retrieve the width and height of an element\n\t// If no element is found, default dimensions are set to 0.\n\tconst getSize = (el: HTMLElement | null = null) => {\n\t\tconst width = el?.offsetWidth || 0\n\t\tconst height = el?.offsetHeight || 0\n\t\treturn { width, height }\n\t}\n\n\t// Ref to store the last execution time of the `resizeThrottle` handler.\n\tconst lastExecutedRef = useRef<number>(0)\n\n\t// State to store the current width and height of the specified element.\n\tconst [size, setSize] = useState<{ width: number; height: number }>(\n\t\tgetSize(element?.current),\n\t)\n\n\t// Throttle the resize event handler to limit how often size updates occur.\n\tconst handleResize = () => {\n\t\tconst now = Date.now()\n\t\tif (now - lastExecutedRef.current < throttleDuration) {\n\t\t\treturn\n\t\t} // Exit if `throttleDuration` has not passed.\n\n\t\tlastExecutedRef.current = now // Update last execution time.\n\n\t\tsetSize(getSize(element?.current))\n\t}\n\n\t// Set up the resize event listener on mount and clean it up on unmount.\n\tuseEffect(() => {\n\t\t// Determine the target for the resize event listener.\n\t\t// If `outerElement` is provided, listen to its resize events; otherwise, listen to the window's.\n\t\tconst listenFor = outerElement?.current || window\n\n\t\tlistenFor.addEventListener('resize', handleResize)\n\n\t\t// Clean up event listener when the component unmounts to avoid memory leaks.\n\t\treturn () => {\n\t\t\tlistenFor.removeEventListener('resize', handleResize)\n\t\t}\n\t}, [outerElement?.current])\n\n\t// Return the current size of the element.\n\treturn size\n}\n","/* @license Copyright 2024 w3ux authors & contributors\nSPDX-License-Identifier: GPL-3.0-only */\n\nimport type {\n\tTimeLeftAll,\n\tTimeLeftRaw,\n\tTimeleftDuration,\n\tUseTimeleftProps,\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\tconst depsTimeleft = props?.depsTimeleft || []\n\tconst depsFormat = props?.depsFormat || []\n\n\t// check whether timeleft is within a minute of finishing.\n\tconst inLastHour = () => {\n\t\tconst { days, hours } = getDuration(toRef.current)\n\t\treturn !days && !hours\n\t}\n\n\t// get the amount of seconds left if timeleft is in the last minute.\n\tconst lastMinuteCountdown = () => {\n\t\tconst { seconds } = getDuration(toRef.current)\n\t\tif (!inLastHour()) {\n\t\t\treturn 60\n\t\t}\n\t\treturn seconds\n\t}\n\n\t// calculate resulting timeleft object from latest duration.\n\tconst getTimeleft = (c?: TimeleftDuration): TimeLeftAll => {\n\t\tconst { days, hours, minutes, seconds } = c || getDuration(toRef.current)\n\t\tconst raw: TimeLeftRaw = {\n\t\t\tdays,\n\t\t\thours,\n\t\t\tminutes,\n\t\t}\n\t\tif (!days && !hours) {\n\t\t\traw.seconds = seconds\n\t\t}\n\t\treturn {\n\t\t\traw,\n\t\t}\n\t}\n\n\t// the end time as a date.\n\tconst [to, setTo] = useState<Date | null>(null)\n\tconst toRef = useRef(to)\n\n\t// resulting timeleft object to be returned.\n\tconst [timeleft, setTimeleft] = useState<TimeLeftAll>(getTimeleft())\n\n\t// timeleft refresh intervals.\n\tconst [minInterval, setMinInterval] = useState<\n\t\tReturnType<typeof setInterval> | undefined\n\t>(undefined)\n\tconst minIntervalRef = useRef(minInterval)\n\n\tconst [secInterval, setSecInterval] = useState<\n\t\tReturnType<typeof setInterval> | undefined\n\t>(undefined)\n\tconst secIntervalRef = useRef(secInterval)\n\n\t// refresh effects.\n\tuseEffect(() => {\n\t\tsetTimeleft(getTimeleft())\n\t\tif (inLastHour()) {\n\t\t\t// refresh timeleft every second.\n\t\t\tif (!secIntervalRef.current) {\n\t\t\t\tconst interval = setInterval(() => {\n\t\t\t\t\tif (!inLastHour()) {\n\t\t\t\t\t\tclearInterval(secIntervalRef.current)\n\t\t\t\t\t\tsetStateWithRef(undefined, setSecInterval, secIntervalRef)\n\t\t\t\t\t}\n\t\t\t\t\tsetTimeleft(getTimeleft())\n\t\t\t\t}, 1000)\n\n\t\t\t\tsetStateWithRef(interval, setSecInterval, secIntervalRef)\n\t\t\t}\n\t\t}\n\t\t// refresh timeleft every minute.\n\t\telse if (!minIntervalRef.current) {\n\t\t\tconst interval = setInterval(() => {\n\t\t\t\tif (inLastHour()) {\n\t\t\t\t\tclearInterval(minIntervalRef.current)\n\t\t\t\t\tsetStateWithRef(undefined, setMinInterval, minIntervalRef)\n\t\t\t\t}\n\t\t\t\tsetTimeleft(getTimeleft())\n\t\t\t}, 60000)\n\t\t\tsetStateWithRef(interval, setMinInterval, minIntervalRef)\n\t\t}\n\t}, [to, inLastHour(), lastMinuteCountdown(), ...depsTimeleft])\n\n\t// re-render the timeleft upon formatting changes.\n\tuseEffect(() => {\n\t\tsetTimeleft(getTimeleft())\n\t}, [...depsFormat])\n\n\t// clear intervals on unmount\n\tuseEffect(\n\t\t() => () => {\n\t\t\tclearInterval(minInterval)\n\t\t\tclearInterval(secInterval)\n\t\t},\n\t\t[],\n\t)\n\n\t// Set the end time and calculate timeleft.\n\tconst setFromNow = (dateFrom: Date, dateTo: Date) => {\n\t\tsetTimeleft(getTimeleft(getDuration(dateFrom)))\n\t\tsetStateWithRef(dateTo, setTo, toRef)\n\t}\n\n\treturn {\n\t\tsetFromNow,\n\t\ttimeleft,\n\t}\n}\n"],"mappings":"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","names":["useEffect","useRef","useEffect","useEffect","useRef","useEffect","useRef","useState","useState","useRef","useEffect"]}
+{"version":3,"sources":["../src/useAutoFitText.tsx","../src/useEffectIgnoreInitial.tsx","../src/useOnResize.tsx","../src/useOutsideAlerter.tsx","../src/useSafeContext.tsx","../src/useSize.tsx","../src/useTimeLeft/index.tsx"],"sourcesContent":["/* @license Copyright 2024 w3ux authors & contributors\nSPDX-License-Identifier: GPL-3.0-only */\n\nimport { useCallback, useEffect, useRef, useState } from 'react'\n\nexport interface UseAutoFitTextOptions {\n\tminFontSize?: number\n\tmaxFontSize?: number\n\tunit?: string\n}\n\nexport const useAutoFitText = ({\n\tminFontSize = 0.625,\n\tmaxFontSize = 1.08,\n\tunit = 'rem',\n}: UseAutoFitTextOptions = {}) => {\n\tconst containerRef = useRef<HTMLElement>(null)\n\tconst [fontSize, setFontSize] = useState(`${maxFontSize}${unit}`)\n\n\tconst calculateOptimalFontSize = useCallback(\n\t\t(container: HTMLElement) => {\n\t\t\tconst containerWidth = container.offsetWidth\n\n\t\t\tif (containerWidth === 0) return\n\n\t\t\t// Store original font size to restore after measurement\n\t\t\tconst originalFontSize = container.style.fontSize\n\n\t\t\t// Binary search for the optimal font size\n\t\t\t// scrollWidth gives us the actual width needed for the text content at each font size\n\t\t\tlet low = minFontSize\n\t\t\tlet high = maxFontSize\n\t\t\tlet bestSize = minFontSize\n\n\t\t\t// Use a precision of 0.001 for decimal units like rem\n\t\t\tconst precision = 0.001\n\n\t\t\twhile (high - low > precision) {\n\t\t\t\tconst mid = (low + high) / 2\n\t\t\t\tcontainer.style.fontSize = `${mid}${unit}`\n\n\t\t\t\t// scrollWidth measures the text content width at this font size\n\t\t\t\tconst scrollWidth = container.scrollWidth\n\n\t\t\t\tif (scrollWidth <= containerWidth) {\n\t\t\t\t\tbestSize = mid\n\t\t\t\t\tlow = mid\n\t\t\t\t} else {\n\t\t\t\t\thigh = mid\n\t\t\t\t}\n\t\t\t}\n\n\t\t\t// Restore original font size before updating state\n\t\t\tcontainer.style.fontSize = originalFontSize\n\n\t\t\t// Only update state if the value actually changed\n\t\t\tconst newFontSize = `${bestSize}${unit}`\n\t\t\tsetFontSize((prev) => (prev === newFontSize ? prev : newFontSize))\n\t\t},\n\t\t[minFontSize, maxFontSize, unit],\n\t)\n\n\tuseEffect(() => {\n\t\tconst container = containerRef.current\n\t\tif (!container) return\n\n\t\t// Debounce timer to prevent excessive recalculations\n\t\tlet debounceTimer: ReturnType<typeof setTimeout> | null = null\n\n\t\tconst debouncedCalculate = () => {\n\t\t\tif (debounceTimer) clearTimeout(debounceTimer)\n\t\t\tdebounceTimer = setTimeout(() => {\n\t\t\t\tcalculateOptimalFontSize(container)\n\t\t\t}, 5)\n\t\t}\n\n\t\t// ResizeObserver handles container size changes (including window resize)\n\t\tconst resizeObserver = new ResizeObserver(debouncedCalculate)\n\n\t\t// Watch for text content changes (e.g., language switches)\n\t\tconst mutationObserver = new MutationObserver(debouncedCalculate)\n\n\t\t// Initial calculation\n\t\tresizeObserver.observe(container)\n\t\tmutationObserver.observe(container, {\n\t\t\tchildList: true,\n\t\t\tsubtree: true,\n\t\t\tcharacterData: true,\n\t\t})\n\n\t\t// Trigger initial calculation after mount\n\t\tcalculateOptimalFontSize(container)\n\n\t\treturn () => {\n\t\t\tif (debounceTimer) clearTimeout(debounceTimer)\n\t\t\tresizeObserver.disconnect()\n\t\t\tmutationObserver.disconnect()\n\t\t}\n\t}, [calculateOptimalFontSize])\n\n\treturn { containerRef, fontSize }\n}\n","/* @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\tconst isInitial = useRef<boolean>(true)\n\n\tuseEffect(\n\t\t() => {\n\t\t\tif (!isInitial.current) {\n\t\t\t\tif (typeof fn === 'function') {\n\t\t\t\t\tfn()\n\t\t\t\t}\n\t\t\t}\n\t\t\tisInitial.current = false\n\t\t},\n\t\tdeps ? [...deps] : undefined,\n\t)\n}\n","/* @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\touterElement?: RefObject<HTMLElement | null>\n\tthrottle?: 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\tcallback: () => void,\n\toptions: UseOnResizeOptions = {},\n) => {\n\tconst { outerElement, throttle: throttleDuration = 100 } = options\n\tconst lastExecutedRef = useRef<number>(0)\n\n\t// Throttled resize handler to limit the frequency of callback execution.\n\tconst handleResize = () => {\n\t\tconst now = Date.now()\n\n\t\t// Check if the callback can be executed based on the throttle duration.\n\t\tif (now - lastExecutedRef.current < throttleDuration) {\n\t\t\treturn\n\t\t}\n\n\t\tlastExecutedRef.current = now\n\t\tcallback()\n\t}\n\n\tuseEffect(() => {\n\t\t// Determine the target for the resize event listener.\n\t\tconst target = outerElement?.current || window\n\n\t\t// Add the resize event listener when the component mounts.\n\t\ttarget.addEventListener('resize', handleResize)\n\n\t\t// Clean up the event listener when the component unmounts.\n\t\treturn () => {\n\t\t\ttarget.removeEventListener('resize', handleResize)\n\t\t}\n\t}, [throttleDuration, callback])\n}\n","/* @license Copyright 2024 w3ux authors & contributors\nSPDX-License-Identifier: GPL-3.0-only */\n\nimport { type RefObject, useEffect } from 'react'\n\n// A hook that alerts clicks outside of the passed ref.\nexport const useOutsideAlerter = (\n\tref: RefObject<HTMLElement | null>,\n\tcallback: () => void,\n\tignore: string[] = [],\n) => {\n\tuseEffect(() => {\n\t\tconst handleClickOutside = (ev: MouseEvent) => {\n\t\t\tif (ev) {\n\t\t\t\tif (ref.current && !ref.current.contains(ev.target as Node)) {\n\t\t\t\t\tconst target = ev.target as HTMLElement\n\t\t\t\t\t// Ignore tags with a name of `ignore`, or if there is a class of `ignore` in the parent\n\t\t\t\t\t// tree.\n\t\t\t\t\tconst tagName = target.tagName.toLowerCase()\n\t\t\t\t\tconst ignored = ignore.some(\n\t\t\t\t\t\t(i) =>\n\t\t\t\t\t\t\ti.toLowerCase() === tagName || target.closest(`.${i}`) !== null,\n\t\t\t\t\t)\n\n\t\t\t\t\tif (!ignored) {\n\t\t\t\t\t\tcallback()\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t\tdocument.addEventListener('mousedown', handleClickOutside)\n\t\treturn () => {\n\t\t\tdocument.removeEventListener('mousedown', handleClickOutside)\n\t\t}\n\t}, [ref])\n}\n","/* @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\tif (ctx === null || ctx === undefined) {\n\t\tthrow new Error(\n\t\t\t'Context value is null or undefined. Please ensure the context Provider is used correctly.',\n\t\t)\n\t}\n\treturn ctx\n}\n\nexport const createSafeContext = <T,>(): [Context<T | null>, () => T] => {\n\tconst Context = createContext<T | null>(null)\n\tconst useHook = () => useSafeContext<T>(useContext(Context))\n\treturn [Context, useHook]\n}\n","/* @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\touterElement?: RefObject<HTMLElement | null>\n\tthrottle?: 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\telement: RefObject<HTMLElement | null>,\n\toptions: UseSizeOptions = {},\n) => {\n\tconst { outerElement, throttle: throttleDuration = 100 } = options\n\n\t// Helper function to retrieve the width and height of an element\n\t// If no element is found, default dimensions are set to 0.\n\tconst getSize = (el: HTMLElement | null = null) => {\n\t\tconst width = el?.offsetWidth || 0\n\t\tconst height = el?.offsetHeight || 0\n\t\treturn { width, height }\n\t}\n\n\t// Ref to store the last execution time of the `resizeThrottle` handler.\n\tconst lastExecutedRef = useRef<number>(0)\n\n\t// State to store the current width and height of the specified element.\n\tconst [size, setSize] = useState<{ width: number; height: number }>(\n\t\tgetSize(element?.current),\n\t)\n\n\t// Throttle the resize event handler to limit how often size updates occur.\n\tconst handleResize = () => {\n\t\tconst now = Date.now()\n\t\tif (now - lastExecutedRef.current < throttleDuration) {\n\t\t\treturn\n\t\t} // Exit if `throttleDuration` has not passed.\n\n\t\tlastExecutedRef.current = now // Update last execution time.\n\n\t\tsetSize(getSize(element?.current))\n\t}\n\n\t// Set up the resize event listener on mount and clean it up on unmount.\n\tuseEffect(() => {\n\t\t// Determine the target for the resize event listener.\n\t\t// If `outerElement` is provided, listen to its resize events; otherwise, listen to the window's.\n\t\tconst listenFor = outerElement?.current || window\n\n\t\tlistenFor.addEventListener('resize', handleResize)\n\n\t\t// Clean up event listener when the component unmounts to avoid memory leaks.\n\t\treturn () => {\n\t\t\tlistenFor.removeEventListener('resize', handleResize)\n\t\t}\n\t}, [outerElement?.current])\n\n\t// Return the current size of the element.\n\treturn size\n}\n","/* @license Copyright 2024 w3ux authors & contributors\nSPDX-License-Identifier: GPL-3.0-only */\n\nimport type {\n\tTimeLeftAll,\n\tTimeLeftRaw,\n\tTimeleftDuration,\n\tUseTimeleftProps,\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\tconst depsTimeleft = props?.depsTimeleft || []\n\tconst depsFormat = props?.depsFormat || []\n\n\t// check whether timeleft is within a minute of finishing.\n\tconst inLastHour = () => {\n\t\tconst { days, hours } = getDuration(toRef.current)\n\t\treturn !days && !hours\n\t}\n\n\t// get the amount of seconds left if timeleft is in the last minute.\n\tconst lastMinuteCountdown = () => {\n\t\tconst { seconds } = getDuration(toRef.current)\n\t\tif (!inLastHour()) {\n\t\t\treturn 60\n\t\t}\n\t\treturn seconds\n\t}\n\n\t// calculate resulting timeleft object from latest duration.\n\tconst getTimeleft = (c?: TimeleftDuration): TimeLeftAll => {\n\t\tconst { days, hours, minutes, seconds } = c || getDuration(toRef.current)\n\t\tconst raw: TimeLeftRaw = {\n\t\t\tdays,\n\t\t\thours,\n\t\t\tminutes,\n\t\t}\n\t\tif (!days && !hours) {\n\t\t\traw.seconds = seconds\n\t\t}\n\t\treturn {\n\t\t\traw,\n\t\t}\n\t}\n\n\t// the end time as a date.\n\tconst [to, setTo] = useState<Date | null>(null)\n\tconst toRef = useRef(to)\n\n\t// resulting timeleft object to be returned.\n\tconst [timeleft, setTimeleft] = useState<TimeLeftAll>(getTimeleft())\n\n\t// timeleft refresh intervals.\n\tconst [minInterval, setMinInterval] = useState<\n\t\tReturnType<typeof setInterval> | undefined\n\t>(undefined)\n\tconst minIntervalRef = useRef(minInterval)\n\n\tconst [secInterval, setSecInterval] = useState<\n\t\tReturnType<typeof setInterval> | undefined\n\t>(undefined)\n\tconst secIntervalRef = useRef(secInterval)\n\n\t// refresh effects.\n\tuseEffect(() => {\n\t\tsetTimeleft(getTimeleft())\n\t\tif (inLastHour()) {\n\t\t\t// refresh timeleft every second.\n\t\t\tif (!secIntervalRef.current) {\n\t\t\t\tconst interval = setInterval(() => {\n\t\t\t\t\tif (!inLastHour()) {\n\t\t\t\t\t\tclearInterval(secIntervalRef.current)\n\t\t\t\t\t\tsetStateWithRef(undefined, setSecInterval, secIntervalRef)\n\t\t\t\t\t}\n\t\t\t\t\tsetTimeleft(getTimeleft())\n\t\t\t\t}, 1000)\n\n\t\t\t\tsetStateWithRef(interval, setSecInterval, secIntervalRef)\n\t\t\t}\n\t\t}\n\t\t// refresh timeleft every minute.\n\t\telse if (!minIntervalRef.current) {\n\t\t\tconst interval = setInterval(() => {\n\t\t\t\tif (inLastHour()) {\n\t\t\t\t\tclearInterval(minIntervalRef.current)\n\t\t\t\t\tsetStateWithRef(undefined, setMinInterval, minIntervalRef)\n\t\t\t\t}\n\t\t\t\tsetTimeleft(getTimeleft())\n\t\t\t}, 60000)\n\t\t\tsetStateWithRef(interval, setMinInterval, minIntervalRef)\n\t\t}\n\t}, [to, inLastHour(), lastMinuteCountdown(), ...depsTimeleft])\n\n\t// re-render the timeleft upon formatting changes.\n\tuseEffect(() => {\n\t\tsetTimeleft(getTimeleft())\n\t}, [...depsFormat])\n\n\t// clear intervals on unmount\n\tuseEffect(\n\t\t() => () => {\n\t\t\tclearInterval(minInterval)\n\t\t\tclearInterval(secInterval)\n\t\t},\n\t\t[],\n\t)\n\n\t// Set the end time and calculate timeleft.\n\tconst setFromNow = (dateFrom: Date, dateTo: Date) => {\n\t\tsetTimeleft(getTimeleft(getDuration(dateFrom)))\n\t\tsetStateWithRef(dateTo, setTo, toRef)\n\t}\n\n\treturn {\n\t\tsetFromNow,\n\t\ttimeleft,\n\t}\n}\n"],"mappings":";;;;;AAGA,SAAS,aAAa,WAAW,QAAQ,gBAAgB;AAQlD,IAAM,iBAAiB,CAAC;AAAA,EAC9B,cAAc;AAAA,EACd,cAAc;AAAA,EACd,OAAO;AACR,IAA2B,CAAC,MAAM;AACjC,QAAM,eAAe,OAAoB,IAAI;AAC7C,QAAM,CAAC,UAAU,WAAW,IAAI,SAAS,GAAG,WAAW,GAAG,IAAI,EAAE;AAEhE,QAAM,2BAA2B;AAAA,IAChC,CAAC,cAA2B;AAC3B,YAAM,iBAAiB,UAAU;AAEjC,UAAI,mBAAmB,EAAG;AAG1B,YAAM,mBAAmB,UAAU,MAAM;AAIzC,UAAI,MAAM;AACV,UAAI,OAAO;AACX,UAAI,WAAW;AAGf,YAAM,YAAY;AAElB,aAAO,OAAO,MAAM,WAAW;AAC9B,cAAM,OAAO,MAAM,QAAQ;AAC3B,kBAAU,MAAM,WAAW,GAAG,GAAG,GAAG,IAAI;AAGxC,cAAM,cAAc,UAAU;AAE9B,YAAI,eAAe,gBAAgB;AAClC,qBAAW;AACX,gBAAM;AAAA,QACP,OAAO;AACN,iBAAO;AAAA,QACR;AAAA,MACD;AAGA,gBAAU,MAAM,WAAW;AAG3B,YAAM,cAAc,GAAG,QAAQ,GAAG,IAAI;AACtC,kBAAY,CAAC,SAAU,SAAS,cAAc,OAAO,WAAY;AAAA,IAClE;AAAA,IACA,CAAC,aAAa,aAAa,IAAI;AAAA,EAChC;AAEA,YAAU,MAAM;AACf,UAAM,YAAY,aAAa;AAC/B,QAAI,CAAC,UAAW;AAGhB,QAAI,gBAAsD;AAE1D,UAAM,qBAAqB,MAAM;AAChC,UAAI,cAAe,cAAa,aAAa;AAC7C,sBAAgB,WAAW,MAAM;AAChC,iCAAyB,SAAS;AAAA,MACnC,GAAG,CAAC;AAAA,IACL;AAGA,UAAM,iBAAiB,IAAI,eAAe,kBAAkB;AAG5D,UAAM,mBAAmB,IAAI,iBAAiB,kBAAkB;AAGhE,mBAAe,QAAQ,SAAS;AAChC,qBAAiB,QAAQ,WAAW;AAAA,MACnC,WAAW;AAAA,MACX,SAAS;AAAA,MACT,eAAe;AAAA,IAChB,CAAC;AAGD,6BAAyB,SAAS;AAElC,WAAO,MAAM;AACZ,UAAI,cAAe,cAAa,aAAa;AAC7C,qBAAe,WAAW;AAC1B,uBAAiB,WAAW;AAAA,IAC7B;AAAA,EACD,GAAG,CAAC,wBAAwB,CAAC;AAE7B,SAAO,EAAE,cAAc,SAAS;AACjC;;;AClGA,SAAS,aAAAA,YAAW,UAAAC,eAAc;AAE3B,IAAM,yBAAyB,CAAO,IAAO,SAAc;AACjE,QAAM,YAAYA,QAAgB,IAAI;AAEtC,EAAAD;AAAA,IACC,MAAM;AACL,UAAI,CAAC,UAAU,SAAS;AACvB,YAAI,OAAO,OAAO,YAAY;AAC7B,aAAG;AAAA,QACJ;AAAA,MACD;AACA,gBAAU,UAAU;AAAA,IACrB;AAAA,IACA,OAAO,CAAC,GAAG,IAAI,IAAI;AAAA,EACpB;AACD;;;ACfA,SAAS,aAAAE,YAAW,UAAAC,eAAc;AAiB3B,IAAM,cAAc,CAC1B,UACA,UAA8B,CAAC,MAC3B;AACJ,QAAM,EAAE,cAAc,UAAU,mBAAmB,IAAI,IAAI;AAC3D,QAAM,kBAAkBA,QAAe,CAAC;AAGxC,QAAM,eAAe,MAAM;AAC1B,UAAM,MAAM,KAAK,IAAI;AAGrB,QAAI,MAAM,gBAAgB,UAAU,kBAAkB;AACrD;AAAA,IACD;AAEA,oBAAgB,UAAU;AAC1B,aAAS;AAAA,EACV;AAEA,EAAAD,WAAU,MAAM;AAEf,UAAM,SAAS,cAAc,WAAW;AAGxC,WAAO,iBAAiB,UAAU,YAAY;AAG9C,WAAO,MAAM;AACZ,aAAO,oBAAoB,UAAU,YAAY;AAAA,IAClD;AAAA,EACD,GAAG,CAAC,kBAAkB,QAAQ,CAAC;AAChC;;;AClDA,SAAyB,aAAAE,kBAAiB;AAGnC,IAAM,oBAAoB,CAChC,KACA,UACA,SAAmB,CAAC,MAChB;AACJ,EAAAA,WAAU,MAAM;AACf,UAAM,qBAAqB,CAAC,OAAmB;AAC9C,UAAI,IAAI;AACP,YAAI,IAAI,WAAW,CAAC,IAAI,QAAQ,SAAS,GAAG,MAAc,GAAG;AAC5D,gBAAM,SAAS,GAAG;AAGlB,gBAAM,UAAU,OAAO,QAAQ,YAAY;AAC3C,gBAAM,UAAU,OAAO;AAAA,YACtB,CAAC,MACA,EAAE,YAAY,MAAM,WAAW,OAAO,QAAQ,IAAI,CAAC,EAAE,MAAM;AAAA,UAC7D;AAEA,cAAI,CAAC,SAAS;AACb,qBAAS;AAAA,UACV;AAAA,QACD;AAAA,MACD;AAAA,IACD;AACA,aAAS,iBAAiB,aAAa,kBAAkB;AACzD,WAAO,MAAM;AACZ,eAAS,oBAAoB,aAAa,kBAAkB;AAAA,IAC7D;AAAA,EACD,GAAG,CAAC,GAAG,CAAC;AACT;;;AC/BA,SAAS,eAAe,kBAAkB;AAEnC,IAAM,iBAAiB,CAAK,QAAiC;AACnE,MAAI,QAAQ,QAAQ,QAAQ,QAAW;AACtC,UAAM,IAAI;AAAA,MACT;AAAA,IACD;AAAA,EACD;AACA,SAAO;AACR;AAEO,IAAM,oBAAoB,MAAwC;AACxE,QAAM,UAAU,cAAwB,IAAI;AAC5C,QAAM,UAAU,MAAM,eAAkB,WAAW,OAAO,CAAC;AAC3D,SAAO,CAAC,SAAS,OAAO;AACzB;;;ACfA,SAAS,aAAAC,YAAW,UAAAC,SAAQ,YAAAC,iBAAgB;AAUrC,IAAM,UAAU,CACtB,SACA,UAA0B,CAAC,MACvB;AACJ,QAAM,EAAE,cAAc,UAAU,mBAAmB,IAAI,IAAI;AAI3D,QAAM,UAAU,CAAC,KAAyB,SAAS;AAClD,UAAM,QAAQ,IAAI,eAAe;AACjC,UAAM,SAAS,IAAI,gBAAgB;AACnC,WAAO,EAAE,OAAO,OAAO;AAAA,EACxB;AAGA,QAAM,kBAAkBD,QAAe,CAAC;AAGxC,QAAM,CAAC,MAAM,OAAO,IAAIC;AAAA,IACvB,QAAQ,SAAS,OAAO;AAAA,EACzB;AAGA,QAAM,eAAe,MAAM;AAC1B,UAAM,MAAM,KAAK,IAAI;AACrB,QAAI,MAAM,gBAAgB,UAAU,kBAAkB;AACrD;AAAA,IACD;AAEA,oBAAgB,UAAU;AAE1B,YAAQ,QAAQ,SAAS,OAAO,CAAC;AAAA,EAClC;AAGA,EAAAF,WAAU,MAAM;AAGf,UAAM,YAAY,cAAc,WAAW;AAE3C,cAAU,iBAAiB,UAAU,YAAY;AAGjD,WAAO,MAAM;AACZ,gBAAU,oBAAoB,UAAU,YAAY;AAAA,IACrD;AAAA,EACD,GAAG,CAAC,cAAc,OAAO,CAAC;AAG1B,SAAO;AACR;;;ACvDA,SAAS,uBAAuB;AAChC,SAAS,aAAAG,YAAW,UAAAC,SAAQ,YAAAC,iBAAgB;AAGrC,IAAM,cAAc,CAAC,UAA6B;AACxD,QAAM,eAAe,OAAO,gBAAgB,CAAC;AAC7C,QAAM,aAAa,OAAO,cAAc,CAAC;AAGzC,QAAM,aAAa,MAAM;AACxB,UAAM,EAAE,MAAM,MAAM,IAAI,YAAY,MAAM,OAAO;AACjD,WAAO,CAAC,QAAQ,CAAC;AAAA,EAClB;AAGA,QAAM,sBAAsB,MAAM;AACjC,UAAM,EAAE,QAAQ,IAAI,YAAY,MAAM,OAAO;AAC7C,QAAI,CAAC,WAAW,GAAG;AAClB,aAAO;AAAA,IACR;AACA,WAAO;AAAA,EACR;AAGA,QAAM,cAAc,CAAC,MAAsC;AAC1D,UAAM,EAAE,MAAM,OAAO,SAAS,QAAQ,IAAI,KAAK,YAAY,MAAM,OAAO;AACxE,UAAM,MAAmB;AAAA,MACxB;AAAA,MACA;AAAA,MACA;AAAA,IACD;AACA,QAAI,CAAC,QAAQ,CAAC,OAAO;AACpB,UAAI,UAAU;AAAA,IACf;AACA,WAAO;AAAA,MACN;AAAA,IACD;AAAA,EACD;AAGA,QAAM,CAAC,IAAI,KAAK,IAAIC,UAAsB,IAAI;AAC9C,QAAM,QAAQC,QAAO,EAAE;AAGvB,QAAM,CAAC,UAAU,WAAW,IAAID,UAAsB,YAAY,CAAC;AAGnE,QAAM,CAAC,aAAa,cAAc,IAAIA,UAEpC,MAAS;AACX,QAAM,iBAAiBC,QAAO,WAAW;AAEzC,QAAM,CAAC,aAAa,cAAc,IAAID,UAEpC,MAAS;AACX,QAAM,iBAAiBC,QAAO,WAAW;AAGzC,EAAAC,WAAU,MAAM;AACf,gBAAY,YAAY,CAAC;AACzB,QAAI,WAAW,GAAG;AAEjB,UAAI,CAAC,eAAe,SAAS;AAC5B,cAAM,WAAW,YAAY,MAAM;AAClC,cAAI,CAAC,WAAW,GAAG;AAClB,0BAAc,eAAe,OAAO;AACpC,4BAAgB,QAAW,gBAAgB,cAAc;AAAA,UAC1D;AACA,sBAAY,YAAY,CAAC;AAAA,QAC1B,GAAG,GAAI;AAEP,wBAAgB,UAAU,gBAAgB,cAAc;AAAA,MACzD;AAAA,IACD,WAES,CAAC,eAAe,SAAS;AACjC,YAAM,WAAW,YAAY,MAAM;AAClC,YAAI,WAAW,GAAG;AACjB,wBAAc,eAAe,OAAO;AACpC,0BAAgB,QAAW,gBAAgB,cAAc;AAAA,QAC1D;AACA,oBAAY,YAAY,CAAC;AAAA,MAC1B,GAAG,GAAK;AACR,sBAAgB,UAAU,gBAAgB,cAAc;AAAA,IACzD;AAAA,EACD,GAAG,CAAC,IAAI,WAAW,GAAG,oBAAoB,GAAG,GAAG,YAAY,CAAC;AAG7D,EAAAA,WAAU,MAAM;AACf,gBAAY,YAAY,CAAC;AAAA,EAC1B,GAAG,CAAC,GAAG,UAAU,CAAC;AAGlB,EAAAA;AAAA,IACC,MAAM,MAAM;AACX,oBAAc,WAAW;AACzB,oBAAc,WAAW;AAAA,IAC1B;AAAA,IACA,CAAC;AAAA,EACF;AAGA,QAAM,aAAa,CAAC,UAAgB,WAAiB;AACpD,gBAAY,YAAY,YAAY,QAAQ,CAAC,CAAC;AAC9C,oBAAgB,QAAQ,OAAO,KAAK;AAAA,EACrC;AAEA,SAAO;AAAA,IACN;AAAA,IACA;AAAA,EACD;AACD;","names":["useEffect","useRef","useEffect","useRef","useEffect","useEffect","useRef","useState","useEffect","useRef","useState","useState","useRef","useEffect"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@w3ux/hooks",
-  "version": "2.4.2",
+  "version": "2.4.4",
   "license": "GPL-3.0-only",
   "type": "module",
   "description": "A collection of general purpose React hooks",
@@ -32,7 +32,7 @@
     }
   },
   "dependencies": {
-    "@w3ux/utils": "^3.1.0",
+    "@w3ux/utils": "^3.1.1",
     "date-fns": "^4.1.0"
   },
   "peerDependencies": {