@rio-cloud/rio-uikit 2.5.0 → 3.0.0-beta.1

package/hooks/useSorting.js

@@ -1,30 +1,39 @@
-import { useState as f, useMemo as l } from "react";
-import { SortDirection as t, naturalSortByProperty as m } from "../utils/SortUtils.js";
-const K = (c, I, d = t.ASCENDING, D = !0, N = !1) => {
-  const [o, g] = f(I), [e, a] = f(d);
-  return { sortedItems: l(() => {
-    const s = (n, i) => D ? m(n, i, e, N) : n.sort((p, y) => {
-      const r = p[i], u = y[i];
-      return r < u ? e === t.ASCENDING ? -1 : 1 : r > u ? e === t.ASCENDING ? 1 : -1 : 0;
-    });
-    if (Array.isArray(o)) {
-      const [n, i] = o, y = s(c, n).reduce(
-        (r, u) => {
-          const S = String(u[n]);
-          return r[S] || (r[S] = []), r[S].push(u), r;
-        },
-        {}
-      );
-      return Object.values(y).flatMap((r) => s(r, i));
-    }
-    return s(c, o);
-  }, [c, o, e, D, N]), sortKey: o, sortDirection: e, setSortKey: g, setSortDirection: a, toggleDirection: () => {
-    a(
-      (s) => s === t.ASCENDING ? t.DESCENDING : t.ASCENDING
-    );
-  } };
+import { SortDirection as e, naturalSortByProperty as t } from "../utils/SortUtils.js";
+import { useMemo as n, useState as r } from "react";
+//#region src/hooks/useSorting.ts
+var i = (i, a, o = e.ASCENDING, s = !0, c = !1) => {
+	let [l, u] = r(a), [d, f] = r(o);
+	return {
+		sortedItems: n(() => {
+			let n = (n, r) => s ? t(n, r, d, c) : n.sort((t, n) => {
+				let i = t[r], a = n[r];
+				return i < a ? d === e.ASCENDING ? -1 : 1 : i > a ? d === e.ASCENDING ? 1 : -1 : 0;
+			});
+			if (Array.isArray(l)) {
+				let [e, t] = l, r = n(i, e).reduce((t, n) => {
+					let r = String(n[e]);
+					return t[r] || (t[r] = []), t[r].push(n), t;
+				}, {});
+				return Object.values(r).flatMap((e) => n(e, t));
+			}
+			return n(i, l);
+		}, [
+			i,
+			l,
+			d,
+			s,
+			c
+		]),
+		sortKey: l,
+		sortDirection: d,
+		setSortKey: u,
+		setSortDirection: f,
+		toggleDirection: () => {
+			f((t) => t === e.ASCENDING ? e.DESCENDING : e.ASCENDING);
+		}
+	};
 };
-export {
-  K as default
-};
-//# sourceMappingURL=useSorting.js.map
+//#endregion
+export { i as default };
+
+//# sourceMappingURL=useSorting.js.map

package/hooks/useSorting.js.map

@@ -1 +1 @@
-{"version":3,"file":"useSorting.js","sources":["../../src/hooks/useSorting.ts"],"sourcesContent":["import { useState, useMemo } from 'react';\n\nimport { naturalSortByProperty, SortDirection, type SortDirectionType } from '../utils/SortUtils';\n\ntype SortKey<T> = keyof T | [keyof T, keyof T];\n\ntype UseSortingResult<T> = {\n    /**\n     * The sorted data\n     */\n    sortedItems: T[];\n\n    /**\n     * The key(s) to sort the data for\n     */\n    sortKey: SortKey<T>;\n\n    /**\n     * The current direction that the data is sorted\n     */\n    sortDirection: SortDirectionType;\n\n    /**\n     * Function to change the sorting key(s) afterwards\n     * @param newKey the new sorting key(s)\n     * @returns\n     */\n    setSortKey: (newKey: SortKey<T>) => void;\n\n    /**\n     * Function to change the sorting order afterwards\n     * @param newKey the new sorting key(s)\n     * @returns\n     */\n    setSortDirection: (newSortDirection: SortDirectionType) => void;\n\n    /**\n     * Function to toggle the sorting between ascending and descending order\n     * @returns\n     */\n    toggleDirection: () => void;\n};\n\nconst useSorting = <T>(\n    items: T[],\n    initialKey: SortKey<T>,\n    initialDirection: SortDirectionType = SortDirection.ASCENDING,\n    enableNaturalSort = true,\n    isCaseSensitive = false\n): UseSortingResult<T> => {\n    const [sortKey, setSortKey] = useState<SortKey<T>>(initialKey);\n    const [sortDirection, setSortDirection] = useState<SortDirectionType>(initialDirection);\n\n    const sortedItems = useMemo(() => {\n        const sortByKey = (arr: T[], key: keyof T) =>\n            enableNaturalSort\n                ? naturalSortByProperty(arr, key, sortDirection, isCaseSensitive)\n                : arr.sort((a, b) => {\n                      const aVal = a[key];\n                      const bVal = b[key];\n                      if (aVal < bVal) {\n                          return sortDirection === SortDirection.ASCENDING ? -1 : 1;\n                      }\n                      if (aVal > bVal) {\n                          return sortDirection === SortDirection.ASCENDING ? 1 : -1;\n                      }\n                      return 0;\n                  });\n\n        if (Array.isArray(sortKey)) {\n            const [primaryKey, secondaryKey] = sortKey;\n            const primarySorted = sortByKey(items, primaryKey);\n\n            // Group items with the same primary key value\n            const groups = primarySorted.reduce(\n                (acc, item) => {\n                    const key = String(item[primaryKey]);\n                    if (!acc[key]) {\n                        acc[key] = [];\n                    }\n                    acc[key].push(item);\n                    return acc;\n                },\n                {} as Record<string, T[]>\n            );\n\n            // Sort each group by the secondary key and flatten the result\n            return Object.values(groups).flatMap(group => sortByKey(group, secondaryKey));\n        }\n        return sortByKey(items, sortKey);\n    }, [items, sortKey, sortDirection, enableNaturalSort, isCaseSensitive]);\n\n    const toggleDirection = () => {\n        setSortDirection(prev =>\n            prev === SortDirection.ASCENDING ? SortDirection.DESCENDING : SortDirection.ASCENDING\n        );\n    };\n\n    return { sortedItems, sortKey, sortDirection, setSortKey, setSortDirection, toggleDirection };\n};\n\nexport default useSorting;\n"],"names":["useSorting","items","initialKey","initialDirection","SortDirection","enableNaturalSort","isCaseSensitive","sortKey","setSortKey","useState","sortDirection","setSortDirection","useMemo","sortByKey","arr","key","naturalSortByProperty","a","b","aVal","bVal","primaryKey","secondaryKey","groups","acc","item","group","prev"],"mappings":";;AA2CA,MAAMA,IAAa,CACfC,GACAC,GACAC,IAAsCC,EAAc,WACpDC,IAAoB,IACpBC,IAAkB,OACI;AACtB,QAAM,CAACC,GAASC,CAAU,IAAIC,EAAqBP,CAAU,GACvD,CAACQ,GAAeC,CAAgB,IAAIF,EAA4BN,CAAgB;AA+CtF,SAAO,EAAE,aA7CWS,EAAQ,MAAM;AAC9B,UAAMC,IAAY,CAACC,GAAUC,MACzBV,IACMW,EAAsBF,GAAKC,GAAKL,GAAeJ,CAAe,IAC9DQ,EAAI,KAAK,CAACG,GAAGC,MAAM;AACf,YAAMC,IAAOF,EAAEF,CAAG,GACZK,IAAOF,EAAEH,CAAG;AAClB,aAAII,IAAOC,IACAV,MAAkBN,EAAc,YAAY,KAAK,IAExDe,IAAOC,IACAV,MAAkBN,EAAc,YAAY,IAAI,KAEpD;AAAA,IACX,CAAC;AAEX,QAAI,MAAM,QAAQG,CAAO,GAAG;AACxB,YAAM,CAACc,GAAYC,CAAY,IAAIf,GAI7BgB,IAHgBV,EAAUZ,GAAOoB,CAAU,EAGpB;AAAA,QACzB,CAACG,GAAKC,MAAS;AACX,gBAAMV,IAAM,OAAOU,EAAKJ,CAAU,CAAC;AACnC,iBAAKG,EAAIT,CAAG,MACRS,EAAIT,CAAG,IAAI,CAAA,IAEfS,EAAIT,CAAG,EAAE,KAAKU,CAAI,GACXD;AAAA,QACX;AAAA,QACA,CAAA;AAAA,MAAC;AAIL,aAAO,OAAO,OAAOD,CAAM,EAAE,QAAQ,CAAAG,MAASb,EAAUa,GAAOJ,CAAY,CAAC;AAAA,IAChF;AACA,WAAOT,EAAUZ,GAAOM,CAAO;AAAA,EACnC,GAAG,CAACN,GAAOM,GAASG,GAAeL,GAAmBC,CAAe,CAAC,GAQhD,SAAAC,GAAS,eAAAG,GAAe,YAAAF,GAAY,kBAAAG,GAAkB,iBANpD,MAAM;AAC1B,IAAAA;AAAA,MAAiB,OACbgB,MAASvB,EAAc,YAAYA,EAAc,aAAaA,EAAc;AAAA,IAAA;AAAA,EAEpF,EAE4E;AAChF;"}
+{"version":3,"file":"useSorting.js","names":[],"sources":["../../src/hooks/useSorting.ts"],"sourcesContent":["import { useState, useMemo } from 'react';\n\nimport { naturalSortByProperty, SortDirection, type SortDirectionType } from '../utils/SortUtils';\n\ntype SortKey<T> = keyof T | [keyof T, keyof T];\n\ntype UseSortingResult<T> = {\n    /**\n     * The sorted data\n     */\n    sortedItems: T[];\n\n    /**\n     * The key(s) to sort the data for\n     */\n    sortKey: SortKey<T>;\n\n    /**\n     * The current direction that the data is sorted\n     */\n    sortDirection: SortDirectionType;\n\n    /**\n     * Function to change the sorting key(s) afterwards\n     * @param newKey the new sorting key(s)\n     * @returns\n     */\n    setSortKey: (newKey: SortKey<T>) => void;\n\n    /**\n     * Function to change the sorting order afterwards\n     * @param newKey the new sorting key(s)\n     * @returns\n     */\n    setSortDirection: (newSortDirection: SortDirectionType) => void;\n\n    /**\n     * Function to toggle the sorting between ascending and descending order\n     * @returns\n     */\n    toggleDirection: () => void;\n};\n\nconst useSorting = <T>(\n    items: T[],\n    initialKey: SortKey<T>,\n    initialDirection: SortDirectionType = SortDirection.ASCENDING,\n    enableNaturalSort = true,\n    isCaseSensitive = false\n): UseSortingResult<T> => {\n    const [sortKey, setSortKey] = useState<SortKey<T>>(initialKey);\n    const [sortDirection, setSortDirection] = useState<SortDirectionType>(initialDirection);\n\n    const sortedItems = useMemo(() => {\n        const sortByKey = (arr: T[], key: keyof T) =>\n            enableNaturalSort\n                ? naturalSortByProperty(arr, key, sortDirection, isCaseSensitive)\n                : arr.sort((a, b) => {\n                      const aVal = a[key];\n                      const bVal = b[key];\n                      if (aVal < bVal) {\n                          return sortDirection === SortDirection.ASCENDING ? -1 : 1;\n                      }\n                      if (aVal > bVal) {\n                          return sortDirection === SortDirection.ASCENDING ? 1 : -1;\n                      }\n                      return 0;\n                  });\n\n        if (Array.isArray(sortKey)) {\n            const [primaryKey, secondaryKey] = sortKey;\n            const primarySorted = sortByKey(items, primaryKey);\n\n            // Group items with the same primary key value\n            const groups = primarySorted.reduce(\n                (acc, item) => {\n                    const key = String(item[primaryKey]);\n                    if (!acc[key]) {\n                        acc[key] = [];\n                    }\n                    acc[key].push(item);\n                    return acc;\n                },\n                {} as Record<string, T[]>\n            );\n\n            // Sort each group by the secondary key and flatten the result\n            return Object.values(groups).flatMap(group => sortByKey(group, secondaryKey));\n        }\n        return sortByKey(items, sortKey);\n    }, [items, sortKey, sortDirection, enableNaturalSort, isCaseSensitive]);\n\n    const toggleDirection = () => {\n        setSortDirection(prev =>\n            prev === SortDirection.ASCENDING ? SortDirection.DESCENDING : SortDirection.ASCENDING\n        );\n    };\n\n    return { sortedItems, sortKey, sortDirection, setSortKey, setSortDirection, toggleDirection };\n};\n\nexport default useSorting;\n"],"mappings":";;;AA2CA,IAAM,KACF,GACA,GACA,IAAsC,EAAc,WACpD,IAAoB,IACpB,IAAkB,OACI;CACtB,IAAM,CAAC,GAAS,KAAc,EAAqB,CAAU,GACvD,CAAC,GAAe,KAAoB,EAA4B,CAAgB;CA+CtF,OAAO;EAAE,aA7CW,QAAc;GAC9B,IAAM,KAAa,GAAU,MACzB,IACM,EAAsB,GAAK,GAAK,GAAe,CAAe,IAC9D,EAAI,MAAM,GAAG,MAAM;IACf,IAAM,IAAO,EAAE,IACT,IAAO,EAAE;IAOf,OANI,IAAO,IACA,MAAkB,EAAc,YAAY,KAAK,IAExD,IAAO,IACA,MAAkB,EAAc,YAAY,IAAI,KAEpD;GACX,CAAC;GAEX,IAAI,MAAM,QAAQ,CAAO,GAAG;IACxB,IAAM,CAAC,GAAY,KAAgB,GAI7B,IAHgB,EAAU,GAAO,CAGxB,CAAA,CAAc,QACxB,GAAK,MAAS;KACX,IAAM,IAAM,OAAO,EAAK,EAAW;KAKnC,OAJK,EAAI,OACL,EAAI,KAAO,CAAC,IAEhB,EAAI,EAAI,CAAC,KAAK,CAAI,GACX;IACX,GACA,CAAC,CACL;IAGA,OAAO,OAAO,OAAO,CAAM,CAAC,CAAC,SAAQ,MAAS,EAAU,GAAO,CAAY,CAAC;GAChF;GACA,OAAO,EAAU,GAAO,CAAO;EACnC,GAAG;GAAC;GAAO;GAAS;GAAe;GAAmB;EAAe,CAQ5D;EAAa;EAAS;EAAe;EAAY;EAAkB,uBAN9C;GAC1B,GAAiB,MACb,MAAS,EAAc,YAAY,EAAc,aAAa,EAAc,SAChF;EACJ;CAE4F;AAChG"}

package/hooks/useStateWithValidation.js

@@ -1,15 +1,17 @@
-import { useState as a, useCallback as f } from "react";
-const p = (s, c) => {
-  const [t, u] = a(c), [l, n] = a(() => s(t)), r = f(
-    (e) => {
-      const o = typeof e == "function" ? e(t) : e;
-      u(o), n(s(o));
-    },
-    [s, t]
-  );
-  return [t, r, l];
+import { useCallback as e, useState as t } from "react";
+//#region src/hooks/useStateWithValidation.ts
+var n = (n, r) => {
+	let [i, a] = t(r), [o, s] = t(() => n(i));
+	return [
+		i,
+		e((e) => {
+			let t = typeof e == "function" ? e(i) : e;
+			a(t), s(n(t));
+		}, [n, i]),
+		o
+	];
 };
-export {
-  p as default
-};
-//# sourceMappingURL=useStateWithValidation.js.map
+//#endregion
+export { n as default };
+
+//# sourceMappingURL=useStateWithValidation.js.map

package/hooks/useStateWithValidation.js.map

@@ -1 +1 @@
-{"version":3,"file":"useStateWithValidation.js","sources":["../../src/hooks/useStateWithValidation.ts"],"sourcesContent":["import { useCallback, useState } from 'react';\n\nexport type ValidationFunction<T> = (value: T) => boolean;\n\n/**\n * A custom hook that provides a state with validation.\n *\n * @param validationFn The function used to validate the state value.\n * @param initialValue The initial value of the state.\n *\n * @returns A tuple containing the state value, a function to update the state\n *          with validation, and a boolean indicating whether the current state value is valid.\n */\nconst useStateWithValidation = <T>(validationFn: ValidationFunction<T>, initialValue: T) => {\n    const [state, setState] = useState<T>(initialValue);\n    const [isValid, setIsValid] = useState<boolean>(() => validationFn(state));\n\n    // Callback function to update the state with validation\n    const onChange = useCallback(\n        (nextState: T | ((prevState: T) => T)) => {\n            // Get the next value based on the provided nextState argument\n            const value = typeof nextState === 'function' ? (nextState as (prevState: T) => T)(state) : nextState;\n\n            // Update the state with the next value\n            setState(value);\n\n            // Update the isValid state based on the validation function\n            setIsValid(validationFn(value));\n        },\n        [validationFn, state]\n    );\n\n    return [state, onChange, isValid] as const;\n};\n\nexport default useStateWithValidation;\n"],"names":["useStateWithValidation","validationFn","initialValue","state","setState","useState","isValid","setIsValid","onChange","useCallback","nextState","value"],"mappings":";AAaA,MAAMA,IAAyB,CAAIC,GAAqCC,MAAoB;AACxF,QAAM,CAACC,GAAOC,CAAQ,IAAIC,EAAYH,CAAY,GAC5C,CAACI,GAASC,CAAU,IAAIF,EAAkB,MAAMJ,EAAaE,CAAK,CAAC,GAGnEK,IAAWC;AAAA,IACb,CAACC,MAAyC;AAEtC,YAAMC,IAAQ,OAAOD,KAAc,aAAcA,EAAkCP,CAAK,IAAIO;AAG5F,MAAAN,EAASO,CAAK,GAGdJ,EAAWN,EAAaU,CAAK,CAAC;AAAA,IAClC;AAAA,IACA,CAACV,GAAcE,CAAK;AAAA,EAAA;AAGxB,SAAO,CAACA,GAAOK,GAAUF,CAAO;AACpC;"}
+{"version":3,"file":"useStateWithValidation.js","names":[],"sources":["../../src/hooks/useStateWithValidation.ts"],"sourcesContent":["import { useCallback, useState } from 'react';\n\nexport type ValidationFunction<T> = (value: T) => boolean;\n\n/**\n * A custom hook that provides a state with validation.\n *\n * @param validationFn The function used to validate the state value.\n * @param initialValue The initial value of the state.\n *\n * @returns A tuple containing the state value, a function to update the state\n *          with validation, and a boolean indicating whether the current state value is valid.\n */\nconst useStateWithValidation = <T>(validationFn: ValidationFunction<T>, initialValue: T) => {\n    const [state, setState] = useState<T>(initialValue);\n    const [isValid, setIsValid] = useState<boolean>(() => validationFn(state));\n\n    // Callback function to update the state with validation\n    const onChange = useCallback(\n        (nextState: T | ((prevState: T) => T)) => {\n            // Get the next value based on the provided nextState argument\n            const value = typeof nextState === 'function' ? (nextState as (prevState: T) => T)(state) : nextState;\n\n            // Update the state with the next value\n            setState(value);\n\n            // Update the isValid state based on the validation function\n            setIsValid(validationFn(value));\n        },\n        [validationFn, state]\n    );\n\n    return [state, onChange, isValid] as const;\n};\n\nexport default useStateWithValidation;\n"],"mappings":";;AAaA,IAAM,KAA6B,GAAqC,MAAoB;CACxF,IAAM,CAAC,GAAO,KAAY,EAAY,CAAY,GAC5C,CAAC,GAAS,KAAc,QAAwB,EAAa,CAAK,CAAC;CAiBzE,OAAO;EAAC;EAdS,GACZ,MAAyC;GAEtC,IAAM,IAAQ,OAAO,KAAc,aAAc,EAAkC,CAAK,IAAI;GAM5F,AAHA,EAAS,CAAK,GAGd,EAAW,EAAa,CAAK,CAAC;EAClC,GACA,CAAC,GAAc,CAAK,CAGT;EAAU;CAAO;AACpC"}

package/hooks/useStorage.js

@@ -1,19 +1,25 @@
-import { useState as S, useEffect as g, useCallback as u } from "react";
-const a = (e, o, c) => {
-  const t = c === "localStorage" ? window.localStorage : window.sessionStorage, [s, r] = S(() => {
-    const n = t.getItem(e);
-    return n ? JSON.parse(n) : typeof o == "function" ? o() : o;
-  });
-  g(() => {
-    s ? t.setItem(e, JSON.stringify(s)) : t.removeItem(e);
-  }, [e, s, t]);
-  const i = u(() => {
-    r(void 0);
-  }, []);
-  return [s, r, i];
-}, f = (e, o) => a(e, o, "localStorage"), m = (e, o) => a(e, o, "sessionStorage");
-export {
-  f as useLocalStorage,
-  m as useSessionStorage
-};
-//# sourceMappingURL=useStorage.js.map
+import { useCallback as e, useEffect as t, useState as n } from "react";
+//#region src/hooks/useStorage.ts
+var r = (r, i, a) => {
+	let o = a === "localStorage" ? window.localStorage : window.sessionStorage, [s, c] = n(() => {
+		let e = o.getItem(r);
+		return e ? JSON.parse(e) : typeof i == "function" ? i() : i;
+	});
+	return t(() => {
+		s ? o.setItem(r, JSON.stringify(s)) : o.removeItem(r);
+	}, [
+		r,
+		s,
+		o
+	]), [
+		s,
+		c,
+		e(() => {
+			c(void 0);
+		}, [])
+	];
+}, i = (e, t) => r(e, t, "localStorage"), a = (e, t) => r(e, t, "sessionStorage");
+//#endregion
+export { i as useLocalStorage, a as useSessionStorage };
+
+//# sourceMappingURL=useStorage.js.map

package/hooks/useStorage.js.map

@@ -1 +1 @@
-{"version":3,"file":"useStorage.js","sources":["../../src/hooks/useStorage.ts"],"sourcesContent":["// Inspired by https://github.com/WebDevSimplified/useful-custom-react-hooks/blob/main/src/8-useStorage/useStorage.js\nimport { useCallback, useState, useEffect } from 'react';\n\nexport type StorageType = 'localStorage' | 'sessionStorage';\n\n/**\n * A custom hook for managing state stored in localStorage or sessionStorage.\n *\n * @param key The key under which the state will be stored.\n * @param defaultValue The initial value for the state, or a function that returns the initial value.\n * @param storageType The type of storage to use: localStorage or sessionStorage.\n *\n * @returns A tuple containing the state value, a function to update the state, and a function\n *          to remove the value from storage.\n */\nconst useStorage = <T>(\n    key: string,\n    defaultValue: T | (() => T),\n    storageType: StorageType\n): [T | undefined, React.Dispatch<React.SetStateAction<T | undefined>>, () => void] => {\n    // Determine the storage object based on the specified storage type\n    const storageObject = storageType === 'localStorage' ? window.localStorage : window.sessionStorage;\n\n    // Initialize state with the value from storage, or the default value\n    const [value, setValue] = useState<T | undefined>(() => {\n        const jsonValue = storageObject.getItem(key);\n\n        if (jsonValue) {\n            return JSON.parse(jsonValue);\n        }\n\n        if (typeof defaultValue === 'function') {\n            return (defaultValue as Function)();\n        }\n\n        return defaultValue;\n    });\n\n    // Update storage whenever the value changes\n    useEffect(() => {\n        if (!value) {\n            storageObject.removeItem(key);\n        } else {\n            storageObject.setItem(key, JSON.stringify(value));\n        }\n    }, [key, value, storageObject]);\n\n    // Callback to remove the value from storage\n    const remove = useCallback(() => {\n        setValue(undefined);\n    }, []);\n\n    return [value, setValue, remove];\n};\n\n/**\n * A custom hook for managing state stored in localStorage.\n *\n * @param key The key under which the state will be stored in localStorage.\n * @param defaultValue The initial value for the state, or a function that returns the initial value.\n *\n * @returns A tuple containing the state value, a function to update the state, and a function\n *          to remove the value from localStorage.\n */\nexport const useLocalStorage = <T>(\n    key: string,\n    defaultValue: T | (() => T)\n): [T | undefined, React.Dispatch<React.SetStateAction<T | undefined>>, () => void] =>\n    useStorage<T>(key, defaultValue, 'localStorage');\n\n/**\n * A custom hook for managing state stored in sessionStorage.\n *\n * @param key The key under which the state will be stored in sessionStorage.\n * @param defaultValue The initial value for the state, or a function that returns the initial value.\n *\n * @returns A tuple containing the state value, a function to update the state,\n *          and a function to remove the value from sessionStorage.\n */\nexport const useSessionStorage = <T>(\n    key: string,\n    defaultValue: T | (() => T)\n): [T | undefined, React.Dispatch<React.SetStateAction<T | undefined>>, () => void] =>\n    useStorage<T>(key, defaultValue, 'sessionStorage');\n"],"names":["useStorage","key","defaultValue","storageType","storageObject","value","setValue","useState","jsonValue","useEffect","remove","useCallback","useLocalStorage","useSessionStorage"],"mappings":";AAeA,MAAMA,IAAa,CACfC,GACAC,GACAC,MACmF;AAEnF,QAAMC,IAAgBD,MAAgB,iBAAiB,OAAO,eAAe,OAAO,gBAG9E,CAACE,GAAOC,CAAQ,IAAIC,EAAwB,MAAM;AACpD,UAAMC,IAAYJ,EAAc,QAAQH,CAAG;AAE3C,WAAIO,IACO,KAAK,MAAMA,CAAS,IAG3B,OAAON,KAAiB,aAChBA,EAAA,IAGLA;AAAA,EACX,CAAC;AAGD,EAAAO,EAAU,MAAM;AACZ,IAAKJ,IAGDD,EAAc,QAAQH,GAAK,KAAK,UAAUI,CAAK,CAAC,IAFhDD,EAAc,WAAWH,CAAG;AAAA,EAIpC,GAAG,CAACA,GAAKI,GAAOD,CAAa,CAAC;AAG9B,QAAMM,IAASC,EAAY,MAAM;AAC7B,IAAAL,EAAS,MAAS;AAAA,EACtB,GAAG,CAAA,CAAE;AAEL,SAAO,CAACD,GAAOC,GAAUI,CAAM;AACnC,GAWaE,IAAkB,CAC3BX,GACAC,MAEAF,EAAcC,GAAKC,GAAc,cAAc,GAWtCW,IAAoB,CAC7BZ,GACAC,MAEAF,EAAcC,GAAKC,GAAc,gBAAgB;"}
+{"version":3,"file":"useStorage.js","names":[],"sources":["../../src/hooks/useStorage.ts"],"sourcesContent":["// Inspired by https://github.com/WebDevSimplified/useful-custom-react-hooks/blob/main/src/8-useStorage/useStorage.js\nimport { useCallback, useState, useEffect } from 'react';\n\nexport type StorageType = 'localStorage' | 'sessionStorage';\n\n/**\n * A custom hook for managing state stored in localStorage or sessionStorage.\n *\n * @param key The key under which the state will be stored.\n * @param defaultValue The initial value for the state, or a function that returns the initial value.\n * @param storageType The type of storage to use: localStorage or sessionStorage.\n *\n * @returns A tuple containing the state value, a function to update the state, and a function\n *          to remove the value from storage.\n */\nconst useStorage = <T>(\n    key: string,\n    defaultValue: T | (() => T),\n    storageType: StorageType\n): [T | undefined, React.Dispatch<React.SetStateAction<T | undefined>>, () => void] => {\n    // Determine the storage object based on the specified storage type\n    const storageObject = storageType === 'localStorage' ? window.localStorage : window.sessionStorage;\n\n    // Initialize state with the value from storage, or the default value\n    const [value, setValue] = useState<T | undefined>(() => {\n        const jsonValue = storageObject.getItem(key);\n\n        if (jsonValue) {\n            return JSON.parse(jsonValue);\n        }\n\n        if (typeof defaultValue === 'function') {\n            return (defaultValue as Function)();\n        }\n\n        return defaultValue;\n    });\n\n    // Update storage whenever the value changes\n    useEffect(() => {\n        if (!value) {\n            storageObject.removeItem(key);\n        } else {\n            storageObject.setItem(key, JSON.stringify(value));\n        }\n    }, [key, value, storageObject]);\n\n    // Callback to remove the value from storage\n    const remove = useCallback(() => {\n        setValue(undefined);\n    }, []);\n\n    return [value, setValue, remove];\n};\n\n/**\n * A custom hook for managing state stored in localStorage.\n *\n * @param key The key under which the state will be stored in localStorage.\n * @param defaultValue The initial value for the state, or a function that returns the initial value.\n *\n * @returns A tuple containing the state value, a function to update the state, and a function\n *          to remove the value from localStorage.\n */\nexport const useLocalStorage = <T>(\n    key: string,\n    defaultValue: T | (() => T)\n): [T | undefined, React.Dispatch<React.SetStateAction<T | undefined>>, () => void] =>\n    useStorage<T>(key, defaultValue, 'localStorage');\n\n/**\n * A custom hook for managing state stored in sessionStorage.\n *\n * @param key The key under which the state will be stored in sessionStorage.\n * @param defaultValue The initial value for the state, or a function that returns the initial value.\n *\n * @returns A tuple containing the state value, a function to update the state,\n *          and a function to remove the value from sessionStorage.\n */\nexport const useSessionStorage = <T>(\n    key: string,\n    defaultValue: T | (() => T)\n): [T | undefined, React.Dispatch<React.SetStateAction<T | undefined>>, () => void] =>\n    useStorage<T>(key, defaultValue, 'sessionStorage');\n"],"mappings":";;AAeA,IAAM,KACF,GACA,GACA,MACmF;CAEnF,IAAM,IAAgB,MAAgB,iBAAiB,OAAO,eAAe,OAAO,gBAG9E,CAAC,GAAO,KAAY,QAA8B;EACpD,IAAM,IAAY,EAAc,QAAQ,CAAG;EAU3C,OARI,IACO,KAAK,MAAM,CAAS,IAG3B,OAAO,KAAiB,aAChB,EAA0B,IAG/B;CACX,CAAC;CAgBD,OAbA,QAAgB;EACZ,AAAK,IAGD,EAAc,QAAQ,GAAK,KAAK,UAAU,CAAK,CAAC,IAFhD,EAAc,WAAW,CAAG;CAIpC,GAAG;EAAC;EAAK;EAAO;CAAa,CAAC,GAOvB;EAAC;EAAO;EAJA,QAAkB;GAC7B,EAAS,KAAA,CAAS;EACtB,GAAG,CAAC,CAEqB;CAAM;AACnC,GAWa,KACT,GACA,MAEA,EAAc,GAAK,GAAc,cAAc,GAWtC,KACT,GACA,MAEA,EAAc,GAAK,GAAc,gBAAgB"}

package/hooks/useSum.js

@@ -1,16 +1,15 @@
+import { getValueByPath as e, parseNumberFromValue as t } from "../utils/formatUtils.js";
 import { useMemo as n } from "react";
-import { getValueByPath as c, parseNumberFromValue as l } from "../utils/formatUtils.js";
-const B = (e, r, u = {}) => {
-  const { locale: o = "en-GB" } = u;
-  return n(
-    () => e.reduce((t, s) => {
-      const m = c(s, r), a = l(m, o);
-      return t + a;
-    }, 0),
-    [e, r, o]
-  );
+//#region src/hooks/useSum.ts
+var r = (r, i, a = {}) => {
+	let { locale: o = "en-GB" } = a;
+	return n(() => r.reduce((n, r) => n + t(e(r, i), o), 0), [
+		r,
+		i,
+		o
+	]);
 };
-export {
-  B as default
-};
-//# sourceMappingURL=useSum.js.map
+//#endregion
+export { r as default };
+
+//# sourceMappingURL=useSum.js.map

package/hooks/useSum.js.map

@@ -1 +1 @@
-{"version":3,"file":"useSum.js","sources":["../../src/hooks/useSum.ts"],"sourcesContent":["import { useMemo } from 'react';\n\nimport { parseNumberFromValue, getValueByPath } from '../utils/formatUtils';\n\nexport type UseSumOptions = {\n    /**\n     * The locale used to parse localized number formats (e.g. \"de-DE\", \"en-GB\").\n     * @default \"en-GB\".\n     */\n    locale?: string;\n};\n\n/**\n * Calculates the sum of numeric values from a list of objects, using a defined property path.\n * Supports localized number strings (e.g. \"1.234,56 €\", \"1,000.75\").\n *\n * @param items - The list of objects to sum values from.\n * @param path - The dot-separated path to the target value in each object.\n * @param options - Optional configuration such as locale for parsing.\n * @returns The total sum of all valid parsed values as a number.\n */\nconst useSum = (items: unknown[], path: string, options: UseSumOptions = {}): number => {\n    const { locale = 'en-GB' } = options;\n\n    const sum = useMemo(\n        () =>\n            items.reduce((total: number, item: unknown) => {\n                const raw = getValueByPath(item, path);\n                const value = parseNumberFromValue(raw, locale);\n\n                return total + value;\n            }, 0),\n        [items, path, locale]\n    );\n\n    return sum;\n};\n\nexport default useSum;\n"],"names":["useSum","items","path","options","locale","useMemo","total","item","raw","getValueByPath","value","parseNumberFromValue"],"mappings":";;AAqBA,MAAMA,IAAS,CAACC,GAAkBC,GAAcC,IAAyB,CAAA,MAAe;AACpF,QAAM,EAAE,QAAAC,IAAS,QAAA,IAAYD;AAa7B,SAXYE;AAAA,IACR,MACIJ,EAAM,OAAO,CAACK,GAAeC,MAAkB;AAC3C,YAAMC,IAAMC,EAAeF,GAAML,CAAI,GAC/BQ,IAAQC,EAAqBH,GAAKJ,CAAM;AAE9C,aAAOE,IAAQI;AAAA,IACnB,GAAG,CAAC;AAAA,IACR,CAACT,GAAOC,GAAME,CAAM;AAAA,EAAA;AAI5B;"}
+{"version":3,"file":"useSum.js","names":[],"sources":["../../src/hooks/useSum.ts"],"sourcesContent":["import { useMemo } from 'react';\n\nimport { parseNumberFromValue, getValueByPath } from '../utils/formatUtils';\n\nexport type UseSumOptions = {\n    /**\n     * The locale used to parse localized number formats (e.g. \"de-DE\", \"en-GB\").\n     * @default \"en-GB\".\n     */\n    locale?: string;\n};\n\n/**\n * Calculates the sum of numeric values from a list of objects, using a defined property path.\n * Supports localized number strings (e.g. \"1.234,56 €\", \"1,000.75\").\n *\n * @param items - The list of objects to sum values from.\n * @param path - The dot-separated path to the target value in each object.\n * @param options - Optional configuration such as locale for parsing.\n * @returns The total sum of all valid parsed values as a number.\n */\nconst useSum = (items: unknown[], path: string, options: UseSumOptions = {}): number => {\n    const { locale = 'en-GB' } = options;\n\n    const sum = useMemo(\n        () =>\n            items.reduce((total: number, item: unknown) => {\n                const raw = getValueByPath(item, path);\n                const value = parseNumberFromValue(raw, locale);\n\n                return total + value;\n            }, 0),\n        [items, path, locale]\n    );\n\n    return sum;\n};\n\nexport default useSum;\n"],"mappings":";;;AAqBA,IAAM,KAAU,GAAkB,GAAc,IAAyB,CAAC,MAAc;CACpF,IAAM,EAAE,YAAS,YAAY;CAa7B,OAXY,QAEJ,EAAM,QAAQ,GAAe,MAIlB,IAFO,EADF,EAAe,GAAM,CACE,GAAK,CAEzB,GAChB,CAAC,GACR;EAAC;EAAO;EAAM;CAAM,CAGjB;AACX"}

package/hooks/useTableExport.js

@@ -1,26 +1,19 @@
-import { useCallback as a } from "react";
-const b = (u, n, l, o = ",") => {
-  if (!u.length)
-    return "";
-  const s = (e) => {
-    if (e == null)
-      return "";
-    const t = String(e), i = t.includes(o) || t.includes('"') || t.includes(`
-`), r = t.replace(/"/g, '""');
-    return i ? `"${r}"` : r;
-  }, p = n.map((e) => s(l?.[e] ?? String(e))).join(o), d = u.map((e) => n.map((t) => s(e[t])).join(o));
-  return [p, ...d].join(`
-`);
-}, f = () => ({ exportToCSV: a(
-  ({ data: n, fileName: l = "export.csv", columns: o, headers: s, delimiter: p = ",", withBom: d = !0 }) => {
-    if (!n.length)
-      return;
-    const e = o ?? Object.keys(n[0]), t = b(n, e, s, p), i = d ? "\uFEFF" : "", r = new Blob([i + t], { type: "text/csv;charset=utf-8;" }), c = document.createElement("a");
-    c.href = URL.createObjectURL(r), c.setAttribute("download", l), document.body.appendChild(c), c.click(), document.body.removeChild(c);
-  },
-  []
-) });
-export {
-  f as default
-};
-//# sourceMappingURL=useTableExport.js.map
+import { useCallback as e } from "react";
+//#region src/hooks/useTableExport.ts
+var t = (e, t, n, r = ",") => {
+	if (!e.length) return "";
+	let i = (e) => {
+		if (e == null) return "";
+		let t = String(e), n = t.includes(r) || t.includes("\"") || t.includes("\n"), i = t.replace(/"/g, "\"\"");
+		return n ? `"${i}"` : i;
+	};
+	return [t.map((e) => i(n?.[e] ?? String(e))).join(r), ...e.map((e) => t.map((t) => i(e[t])).join(r))].join("\n");
+}, n = () => ({ exportToCSV: e(({ data: e, fileName: n = "export.csv", columns: r, headers: i, delimiter: a = ",", withBom: o = !0 }) => {
+	if (!e.length) return;
+	let s = t(e, r ?? Object.keys(e[0]), i, a), c = new Blob([(o ? "" : "") + s], { type: "text/csv;charset=utf-8;" }), l = document.createElement("a");
+	l.href = URL.createObjectURL(c), l.setAttribute("download", n), document.body.appendChild(l), l.click(), document.body.removeChild(l);
+}, []) });
+//#endregion
+export { n as default };
+
+//# sourceMappingURL=useTableExport.js.map

package/hooks/useTableExport.js.map

@@ -1 +1 @@
-{"version":3,"file":"useTableExport.js","sources":["../../src/hooks/useTableExport.ts"],"sourcesContent":["import { useCallback } from 'react';\n\n/**\n * Options for exporting tabular data to CSV.\n */\nexport type ExportOptions<T extends object> = {\n    /**\n     * Array of data objects to export. Each object represents one row in the table.\n     */\n    data: T[];\n\n    /**\n     * Optional name for the exported file.\n     * @default \"export.csv\"\n     */\n    fileName?: string;\n\n    /**\n     * Optional list of object keys to export as columns.\n     * If omitted, all keys from the first row will be used.\n     */\n    columns?: (keyof T)[];\n\n    /**\n     * Optional map of column keys to custom header labels.\n     * @example { firstName: 'First Name' }\n     */\n    headers?: Partial<Record<keyof T, string>>;\n\n    /**\n     * Optional delimiter to use between values in the CSV.\n     * You can use `\";\"` or `\"\\t\"` for other formats.\n     * @default \",\"\n     */\n    delimiter?: string;\n\n    /**\n     * Whether to include UTF-8 BOM (useful for Excel).\n     * @default true\n     */\n    withBom?: boolean;\n};\n\n/**\n * Converts a dataset into CSV format as a string.\n *\n * @template T Type of each row object.\n * @param data The data array to convert.\n * @param columns Optional keys to include as columns.\n * @param headers Optional key-to-label mapping for header row.\n * @param delimiter Delimiter to separate columns. Defaults to `\",\"`.\n * @returns A string representing the CSV data.\n */\nconst convertToCSV = <T extends object>(\n    data: T[],\n    columns: (keyof T)[],\n    headers?: Partial<Record<keyof T, string>>,\n    delimiter = ','\n): string => {\n    if (!data.length) {\n        return '';\n    }\n\n    // biome-ignore lint/suspicious/noExplicitAny: whatever type, it will be converted to string anyways\n    const escapeFn = (val: any) => {\n        if (val === null || val === undefined) {\n            return '';\n        }\n\n        const str = String(val);\n        const needsQuotes = str.includes(delimiter) || str.includes('\"') || str.includes('\\n');\n        const escaped = str.replace(/\"/g, '\"\"');\n        return needsQuotes ? `\"${escaped}\"` : escaped;\n    };\n\n    const headerRow = columns.map(key => escapeFn(headers?.[key] ?? String(key))).join(delimiter);\n\n    const dataRows = data.map(row => columns.map(key => escapeFn(row[key])).join(delimiter));\n\n    return [headerRow, ...dataRows].join('\\n');\n};\n\n/**\n * React hook for exporting tabular data to a downloadable CSV file.\n *\n * @template T Type of each data row object.\n * @returns An object with a `exportToCSV` function to trigger the export.\n *\n * @example\n * const { exportToCSV } = useTableExport<User>();\n * exportToCSV({ data: users, fileName: 'users.csv', delimiter: ';' });\n */\nconst useTableExport = <T extends object>() => {\n    const exportToCSV = useCallback(\n        ({ data, fileName = 'export.csv', columns, headers, delimiter = ',', withBom = true }: ExportOptions<T>) => {\n            if (!data.length) {\n                return;\n            }\n\n            const cols = columns ?? (Object.keys(data[0]) as (keyof T)[]);\n            const csv = convertToCSV(data, cols, headers, delimiter);\n\n            const bom = withBom ? '\\uFEFF' : '';\n            const blob = new Blob([bom + csv], { type: 'text/csv;charset=utf-8;' });\n\n            const link = document.createElement('a');\n            link.href = URL.createObjectURL(blob);\n            link.setAttribute('download', fileName);\n\n            document.body.appendChild(link);\n            link.click();\n\n            document.body.removeChild(link);\n        },\n        []\n    );\n\n    return { exportToCSV };\n};\n\nexport default useTableExport;\n"],"names":["convertToCSV","data","columns","headers","delimiter","escapeFn","val","str","needsQuotes","escaped","headerRow","key","dataRows","row","useTableExport","useCallback","fileName","withBom","cols","csv","bom","blob","link"],"mappings":";AAqDA,MAAMA,IAAe,CACjBC,GACAC,GACAC,GACAC,IAAY,QACH;AACT,MAAI,CAACH,EAAK;AACN,WAAO;AAIX,QAAMI,IAAW,CAACC,MAAa;AAC3B,QAAIA,KAAQ;AACR,aAAO;AAGX,UAAMC,IAAM,OAAOD,CAAG,GAChBE,IAAcD,EAAI,SAASH,CAAS,KAAKG,EAAI,SAAS,GAAG,KAAKA,EAAI,SAAS;AAAA,CAAI,GAC/EE,IAAUF,EAAI,QAAQ,MAAM,IAAI;AACtC,WAAOC,IAAc,IAAIC,CAAO,MAAMA;AAAA,EAC1C,GAEMC,IAAYR,EAAQ,IAAI,CAAAS,MAAON,EAASF,IAAUQ,CAAG,KAAK,OAAOA,CAAG,CAAC,CAAC,EAAE,KAAKP,CAAS,GAEtFQ,IAAWX,EAAK,IAAI,CAAAY,MAAOX,EAAQ,IAAI,CAAAS,MAAON,EAASQ,EAAIF,CAAG,CAAC,CAAC,EAAE,KAAKP,CAAS,CAAC;AAEvF,SAAO,CAACM,GAAW,GAAGE,CAAQ,EAAE,KAAK;AAAA,CAAI;AAC7C,GAYME,IAAiB,OAyBZ,EAAE,aAxBWC;AAAA,EAChB,CAAC,EAAE,MAAAd,GAAM,UAAAe,IAAW,cAAc,SAAAd,GAAS,SAAAC,GAAS,WAAAC,IAAY,KAAK,SAAAa,IAAU,SAA6B;AACxG,QAAI,CAAChB,EAAK;AACN;AAGJ,UAAMiB,IAAOhB,KAAY,OAAO,KAAKD,EAAK,CAAC,CAAC,GACtCkB,IAAMnB,EAAaC,GAAMiB,GAAMf,GAASC,CAAS,GAEjDgB,IAAMH,IAAU,WAAW,IAC3BI,IAAO,IAAI,KAAK,CAACD,IAAMD,CAAG,GAAG,EAAE,MAAM,2BAA2B,GAEhEG,IAAO,SAAS,cAAc,GAAG;AACvC,IAAAA,EAAK,OAAO,IAAI,gBAAgBD,CAAI,GACpCC,EAAK,aAAa,YAAYN,CAAQ,GAEtC,SAAS,KAAK,YAAYM,CAAI,GAC9BA,EAAK,MAAA,GAEL,SAAS,KAAK,YAAYA,CAAI;AAAA,EAClC;AAAA,EACA,CAAA;AAAC,EAGI;"}
+{"version":3,"file":"useTableExport.js","names":[],"sources":["../../src/hooks/useTableExport.ts"],"sourcesContent":["import { useCallback } from 'react';\n\n/**\n * Options for exporting tabular data to CSV.\n */\nexport type ExportOptions<T extends object> = {\n    /**\n     * Array of data objects to export. Each object represents one row in the table.\n     */\n    data: T[];\n\n    /**\n     * Optional name for the exported file.\n     * @default \"export.csv\"\n     */\n    fileName?: string;\n\n    /**\n     * Optional list of object keys to export as columns.\n     * If omitted, all keys from the first row will be used.\n     */\n    columns?: (keyof T)[];\n\n    /**\n     * Optional map of column keys to custom header labels.\n     * @example { firstName: 'First Name' }\n     */\n    headers?: Partial<Record<keyof T, string>>;\n\n    /**\n     * Optional delimiter to use between values in the CSV.\n     * You can use `\";\"` or `\"\\t\"` for other formats.\n     * @default \",\"\n     */\n    delimiter?: string;\n\n    /**\n     * Whether to include UTF-8 BOM (useful for Excel).\n     * @default true\n     */\n    withBom?: boolean;\n};\n\n/**\n * Converts a dataset into CSV format as a string.\n *\n * @template T Type of each row object.\n * @param data The data array to convert.\n * @param columns Optional keys to include as columns.\n * @param headers Optional key-to-label mapping for header row.\n * @param delimiter Delimiter to separate columns. Defaults to `\",\"`.\n * @returns A string representing the CSV data.\n */\nconst convertToCSV = <T extends object>(\n    data: T[],\n    columns: (keyof T)[],\n    headers?: Partial<Record<keyof T, string>>,\n    delimiter = ','\n): string => {\n    if (!data.length) {\n        return '';\n    }\n\n    // biome-ignore lint/suspicious/noExplicitAny: whatever type, it will be converted to string anyways\n    const escapeFn = (val: any) => {\n        if (val === null || val === undefined) {\n            return '';\n        }\n\n        const str = String(val);\n        const needsQuotes = str.includes(delimiter) || str.includes('\"') || str.includes('\\n');\n        const escaped = str.replace(/\"/g, '\"\"');\n        return needsQuotes ? `\"${escaped}\"` : escaped;\n    };\n\n    const headerRow = columns.map(key => escapeFn(headers?.[key] ?? String(key))).join(delimiter);\n\n    const dataRows = data.map(row => columns.map(key => escapeFn(row[key])).join(delimiter));\n\n    return [headerRow, ...dataRows].join('\\n');\n};\n\n/**\n * React hook for exporting tabular data to a downloadable CSV file.\n *\n * @template T Type of each data row object.\n * @returns An object with a `exportToCSV` function to trigger the export.\n *\n * @example\n * const { exportToCSV } = useTableExport<User>();\n * exportToCSV({ data: users, fileName: 'users.csv', delimiter: ';' });\n */\nconst useTableExport = <T extends object>() => {\n    const exportToCSV = useCallback(\n        ({ data, fileName = 'export.csv', columns, headers, delimiter = ',', withBom = true }: ExportOptions<T>) => {\n            if (!data.length) {\n                return;\n            }\n\n            const cols = columns ?? (Object.keys(data[0]) as (keyof T)[]);\n            const csv = convertToCSV(data, cols, headers, delimiter);\n\n            const bom = withBom ? '\\uFEFF' : '';\n            const blob = new Blob([bom + csv], { type: 'text/csv;charset=utf-8;' });\n\n            const link = document.createElement('a');\n            link.href = URL.createObjectURL(blob);\n            link.setAttribute('download', fileName);\n\n            document.body.appendChild(link);\n            link.click();\n\n            document.body.removeChild(link);\n        },\n        []\n    );\n\n    return { exportToCSV };\n};\n\nexport default useTableExport;\n"],"mappings":";;AAqDA,IAAM,KACF,GACA,GACA,GACA,IAAY,QACH;CACT,IAAI,CAAC,EAAK,QACN,OAAO;CAIX,IAAM,KAAY,MAAa;EAC3B,IAAI,KAAQ,MACR,OAAO;EAGX,IAAM,IAAM,OAAO,CAAG,GAChB,IAAc,EAAI,SAAS,CAAS,KAAK,EAAI,SAAS,IAAG,KAAK,EAAI,SAAS,IAAI,GAC/E,IAAU,EAAI,QAAQ,MAAM,MAAI;EACtC,OAAO,IAAc,IAAI,EAAQ,KAAK;CAC1C;CAMA,OAAO,CAJW,EAAQ,KAAI,MAAO,EAAS,IAAU,MAAQ,OAAO,CAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAI3E,GAAW,GAFF,EAAK,KAAI,MAAO,EAAQ,KAAI,MAAO,EAAS,EAAI,EAAI,CAAC,CAAC,CAAC,KAAK,CAAS,CAEhE,CAAQ,CAAC,CAAC,KAAK,IAAI;AAC7C,GAYM,WAyBK,EAAE,aAxBW,GACf,EAAE,SAAM,cAAW,cAAc,YAAS,YAAS,eAAY,KAAK,aAAU,SAA6B;CACxG,IAAI,CAAC,EAAK,QACN;CAIJ,IAAM,IAAM,EAAa,GADZ,KAAY,OAAO,KAAK,EAAK,EAAE,GACP,GAAS,CAAS,GAGjD,IAAO,IAAI,KAAK,EADV,IAAU,MAAW,MACJ,CAAG,GAAG,EAAE,MAAM,0BAA0B,CAAC,GAEhE,IAAO,SAAS,cAAc,GAAG;CAOvC,AANA,EAAK,OAAO,IAAI,gBAAgB,CAAI,GACpC,EAAK,aAAa,YAAY,CAAQ,GAEtC,SAAS,KAAK,YAAY,CAAI,GAC9B,EAAK,MAAM,GAEX,SAAS,KAAK,YAAY,CAAI;AAClC,GACA,CAAC,CAGI,EAAY"}

package/hooks/useTableSelection.d.ts

@@ -43,7 +43,7 @@ export type UseTableSelectionOptions<TData extends Record<string, any>> = {
      * Optional external ref for the table element. If not provided, the hook creates its own.
      * Useful if the parent component needs direct access to the table DOM element for other purposes.
      */
-    ref?: React.RefObject<HTMLTableElement>;
+    ref?: React.RefObject<HTMLTableElement | null>;
 };
 /**
  * Return value of the `useTableSelection` hook.
@@ -53,7 +53,7 @@ export type UseTableSelectionReturn = {
      * React ref attached to the `<table>` HTML element.
      * Ensure this ref is assigned to your table element to enable DOM manipulations.
      */
-    tableRef: React.RefObject<HTMLTableElement>;
+    tableRef: React.RefObject<HTMLTableElement | null>;
     /**
      * An array of strings, where each string is the ID of a currently selected row.
      */

package/hooks/useTableSelection.js

@@ -1,103 +1,81 @@
-import { useState as h, useRef as H, useEffect as K, useCallback as b } from "react";
-const k = "active", N = "data-id", O = ".table-checkbox", P = ".table-action", j = (o) => {
-  const {
-    tableData: e,
-    idKey: n,
-    initialSelectedRowIds: r = [],
-    initialActiveRowId: A = "",
-    checkboxQuerySelector: w = '.table-checkbox input[type="checkbox"]',
-    dataAttributeName: l = N,
-    ref: _
-  } = o, [d, u] = h(r), [R, p] = h(A), [f, x] = h(A), D = H(null), a = _ ?? D;
-  K(() => {
-    E();
-  }, [R, f, d]);
-  const E = () => {
-    if (!a.current)
-      return;
-    const t = [...a.current.rows];
-    f !== R && (q(t, f, l), $(t, R, l)), d.forEach((s) => {
-      V(t, s, l, w);
-    });
-  }, v = b((t) => {
-    t.preventDefault(), t.stopPropagation();
-    const c = t.currentTarget.getAttribute(l) ?? "", i = t.target, g = i.closest(O), U = i.closest(P);
-    g || U || S(c);
-  }, []), S = (t = "") => {
-    p((s) => {
-      const c = s === t ? "" : t;
-      return x(s), c;
-    });
-  }, y = b((t) => {
-    t.preventDefault(), t.stopPropagation();
-    const c = t.target.closest(`tr[${l}]`)?.getAttribute(l);
-    if (!c) {
-      console.warn("Could not find row ID for selection event.");
-      return;
-    }
-    u((i) => i.includes(c) ? (T([c]), i.filter((g) => g !== c)) : [...i, c]);
-  }, []), B = b(
-    (t) => {
-      const s = e.map((c) => `${c[n]}`);
-      if (u(t ? s : []), t)
-        u(s);
-      else {
-        u([]), T(s);
-        for (const c in s) {
-          const i = a.current ? [...a.current.rows] : [];
-          L([...i], c, l, w);
-        }
-      }
-    },
-    [e]
-  ), T = (t) => {
-    const s = a.current ? [...a.current.rows] : [];
-    t.forEach((c) => {
-      L(s, c, l, w);
-    });
-  }, I = d.length > 0, F = I && d.length === e.length && e.length > 0;
-  return {
-    tableRef: a,
-    selectedRowIds: d,
-    activeRowId: R,
-    onSelection: y,
-    onActiveRowChange: v,
-    onToggleAll: B,
-    updateRowSelection: E,
-    setSelectedRowIds: (t) => u(t),
-    setActiveRowId: (t) => S(t),
-    hasSelection: I,
-    isAllSelected: F
-  };
-}, C = (o, e, n) => {
-  if (e)
-    return o.find((r) => r.getAttribute(n) === e);
-}, $ = (o, e, n) => {
-  C(o, e, n)?.classList.add(k);
-}, q = (o, e, n) => {
-  C(o, e, n)?.classList.remove(k);
-}, Q = (o, e) => o.querySelector(e), m = (o, e, n, r, A) => {
-  const w = C(o, e, n);
-  if (w) {
-    const l = Q(w, r);
-    l && (l.checked = A);
-  }
-}, V = (o, e, n, r) => {
-  m(o, e, n, r, !0);
-}, L = (o, e, n, r) => {
-  m(o, e, n, r, !1);
+import { useCallback as e, useEffect as t, useRef as n, useState as r } from "react";
+//#region src/hooks/useTableSelection.ts
+var i = "active", a = "data-id", o = ".table-checkbox", s = ".table-action", c = (i) => {
+	let { tableData: c, idKey: l, initialSelectedRowIds: f = [], initialActiveRowId: p = "", checkboxQuerySelector: g = ".table-checkbox input[type=\"checkbox\"]", dataAttributeName: _ = a, ref: v } = i, [y, b] = r(f), [x, S] = r(p), [C, w] = r(p), T = n(null), E = v ?? T;
+	t(() => {
+		D();
+	}, [
+		x,
+		C,
+		y
+	]);
+	let D = () => {
+		if (!E.current) return;
+		let e = [...E.current.rows];
+		C !== x && (d(e, C, _), u(e, x, _)), y.forEach((t) => {
+			m(e, t, _, g);
+		});
+	}, O = e((e) => {
+		e.preventDefault(), e.stopPropagation();
+		let t = e.currentTarget.getAttribute(_) ?? "", n = e.target, r = n.closest(o), i = n.closest(s);
+		r || i || k(t);
+	}, []), k = (e = "") => {
+		S((t) => {
+			let n = t === e ? "" : e;
+			return w(t), n;
+		});
+	}, A = e((e) => {
+		e.preventDefault(), e.stopPropagation();
+		let t = e.target.closest(`tr[${_}]`)?.getAttribute(_);
+		if (!t) {
+			console.warn("Could not find row ID for selection event.");
+			return;
+		}
+		b((e) => e.includes(t) ? (M([t]), e.filter((e) => e !== t)) : [...e, t]);
+	}, []), j = e((e) => {
+		let t = c.map((e) => `${e[l]}`);
+		if (b(e ? t : []), e) b(t);
+		else {
+			b([]), M(t);
+			for (let e in t) h([...E.current ? [...E.current.rows] : []], e, _, g);
+		}
+	}, [c]), M = (e) => {
+		let t = E.current ? [...E.current.rows] : [];
+		e.forEach((e) => {
+			h(t, e, _, g);
+		});
+	}, N = y.length > 0;
+	return {
+		tableRef: E,
+		selectedRowIds: y,
+		activeRowId: x,
+		onSelection: A,
+		onActiveRowChange: O,
+		onToggleAll: j,
+		updateRowSelection: D,
+		setSelectedRowIds: (e) => b(e),
+		setActiveRowId: (e) => k(e),
+		hasSelection: N,
+		isAllSelected: N && y.length === c.length && c.length > 0
+	};
+}, l = (e, t, n) => {
+	if (t) return e.find((e) => e.getAttribute(n) === t);
+}, u = (e, t, n) => {
+	l(e, t, n)?.classList.add(i);
+}, d = (e, t, n) => {
+	l(e, t, n)?.classList.remove(i);
+}, f = (e, t) => e.querySelector(t), p = (e, t, n, r, i) => {
+	let a = l(e, t, n);
+	if (a) {
+		let e = f(a, r);
+		e && (e.checked = i);
+	}
+}, m = (e, t, n, r) => {
+	p(e, t, n, r, !0);
+}, h = (e, t, n, r) => {
+	p(e, t, n, r, !1);
 };
-export {
-  k as ACTIVE_CLASS,
-  N as DEFAULT_DATA_ATTRIBUTE,
-  P as DEFAULT_TABLE_ACTION_CELL_CLASS,
-  O as DEFAULT_TABLE_CHECKBOX_CELL_CLASS,
-  j as default,
-  L as deselectRow,
-  C as getRowByDataAttribute,
-  $ as highlightRow,
-  q as removeHighlightFromRow,
-  V as selectRow,
-  m as setRowCheckboxState
-};
-//# sourceMappingURL=useTableSelection.js.map
+//#endregion
+export { i as ACTIVE_CLASS, a as DEFAULT_DATA_ATTRIBUTE, s as DEFAULT_TABLE_ACTION_CELL_CLASS, o as DEFAULT_TABLE_CHECKBOX_CELL_CLASS, c as default, h as deselectRow, l as getRowByDataAttribute, u as highlightRow, d as removeHighlightFromRow, m as selectRow, p as setRowCheckboxState };
+
+//# sourceMappingURL=useTableSelection.js.map