@fuf-stack/pixels 1.8.0 → 1.10.0

package/dist/hooks/useDebounce/index.d.cts

@@ -1,9 +1,2 @@
-/**
- * Hook that debounces a value
- * @param value - The value to debounce
- * @param delay - Delay in milliseconds
- * @returns The debounced value
- */
-declare const useDebounce: <Value>(value: Value, delay: number) => Value;
-
-export { useDebounce };
+import { useDebounce } from "./useDebounce.cjs";
+export { useDebounce };

package/dist/hooks/useDebounce/index.d.ts

@@ -1,9 +1,2 @@
-/**
- * Hook that debounces a value
- * @param value - The value to debounce
- * @param delay - Delay in milliseconds
- * @returns The debounced value
- */
-declare const useDebounce: <Value>(value: Value, delay: number) => Value;
-
-export { useDebounce };
+import { useDebounce } from "./useDebounce.js";
+export { useDebounce };

package/dist/hooks/useDebounce/index.js

@@ -1,8 +1,2 @@
-import {
-  useDebounce
-} from "../../chunk-FLDEDIE2.js";
-import "../../chunk-OAIRL2FN.js";
-export {
-  useDebounce
-};
-//# sourceMappingURL=index.js.map
+import { useDebounce } from "./useDebounce.js";
+export { useDebounce };

package/dist/hooks/useDebounce/useDebounce.cjs

@@ -0,0 +1,37 @@
+require("../../_virtual/_rolldown/runtime.cjs");
+let _fuf_stack_pixel_utils = require("@fuf-stack/pixel-utils");
+let react = require("react");
+//#region src/hooks/useDebounce/useDebounce.ts
+/**
+* Hook that debounces a value
+* @param value - The value to debounce
+* @param delay - Delay in milliseconds
+* @returns The debounced value
+*/
+const useDebounce = (value, delay) => {
+	const [debouncedValue, setDebouncedValue] = (0, react.useState)(value);
+	const isMountedRef = (0, react.useRef)(true);
+	(0, react.useEffect)(() => {
+		isMountedRef.current = true;
+		return () => {
+			isMountedRef.current = false;
+		};
+	}, []);
+	(0, react.useEffect)(() => {
+		if ((0, _fuf_stack_pixel_utils.isTestEnvironment)()) {
+			setDebouncedValue(value);
+			return;
+		}
+		const handler = setTimeout(() => {
+			if (isMountedRef.current) setDebouncedValue(value);
+		}, delay);
+		return () => {
+			clearTimeout(handler);
+		};
+	}, [value, delay]);
+	return debouncedValue;
+};
+//#endregion
+exports.useDebounce = useDebounce;
+
+//# sourceMappingURL=useDebounce.cjs.map

package/dist/hooks/useDebounce/useDebounce.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDebounce.cjs","names":[],"sources":["../../../src/hooks/useDebounce/useDebounce.ts"],"sourcesContent":["/* eslint-disable import-x/prefer-default-export */\n\nimport { useEffect, useRef, useState } from 'react';\n\nimport { isTestEnvironment } from '@fuf-stack/pixel-utils';\n\n/**\n * Hook that debounces a value\n * @param value - The value to debounce\n * @param delay - Delay in milliseconds\n * @returns The debounced value\n */\nexport const useDebounce = <Value>(value: Value, delay: number) => {\n  // State and setters for debounced value\n  const [debouncedValue, setDebouncedValue] = useState(value);\n  // Track if component is mounted to prevent setState on unmounted component\n  const isMountedRef = useRef(true);\n\n  useEffect(() => {\n    // Mark as mounted\n    isMountedRef.current = true;\n    return () => {\n      // Mark as unmounted on cleanup\n      isMountedRef.current = false;\n    };\n  }, []);\n\n  useEffect(\n    () => {\n      // In test environments, skip debouncing for immediate snapshots\n      if (isTestEnvironment()) {\n        setDebouncedValue(value);\n        return;\n      }\n\n      // Update debounced value after delay\n      const handler = setTimeout(() => {\n        // Only update state if component is still mounted\n        if (isMountedRef.current) {\n          setDebouncedValue(value);\n        }\n      }, delay);\n\n      // Cancel the timeout if value changes (also on delay change or unmount)\n      // This is how we prevent debounced value from updating if value is changed ...\n      // .. within the delay period. Timeout gets cleared and restarted.\n      // eslint-disable-next-line consistent-return\n      return () => {\n        clearTimeout(handler);\n      };\n    },\n    [value, delay], // Only re-call effect if value or delay changes\n  );\n\n  return debouncedValue;\n};\n"],"mappings":";;;;;;;;;;AAYA,MAAa,eAAsB,OAAc,UAAkB;CAEjE,MAAM,CAAC,gBAAgB,sBAAA,GAAA,MAAA,UAA8B,KAAK;CAE1D,MAAM,gBAAA,GAAA,MAAA,QAAsB,IAAI;CAEhC,CAAA,GAAA,MAAA,iBAAgB;EAEd,aAAa,UAAU;EACvB,aAAa;GAEX,aAAa,UAAU;EACzB;CACF,GAAG,CAAC,CAAC;CAEL,CAAA,GAAA,MAAA,iBACQ;EAEJ,KAAA,GAAA,uBAAA,mBAAsB,GAAG;GACvB,kBAAkB,KAAK;GACvB;EACF;EAGA,MAAM,UAAU,iBAAiB;GAE/B,IAAI,aAAa,SACf,kBAAkB,KAAK;EAE3B,GAAG,KAAK;EAMR,aAAa;GACX,aAAa,OAAO;EACtB;CACF,GACA,CAAC,OAAO,KAAK,CACf;CAEA,OAAO;AACT"}

package/dist/hooks/useDebounce/useDebounce.d.cts

@@ -0,0 +1,11 @@
+//#region src/hooks/useDebounce/useDebounce.d.ts
+/**
+ * Hook that debounces a value
+ * @param value - The value to debounce
+ * @param delay - Delay in milliseconds
+ * @returns The debounced value
+ */
+declare const useDebounce: <Value>(value: Value, delay: number) => Value;
+//#endregion
+export { useDebounce };
+//# sourceMappingURL=useDebounce.d.cts.map

package/dist/hooks/useDebounce/useDebounce.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDebounce.d.cts","names":[],"sources":["../../../src/hooks/useDebounce/useDebounce.ts"],"mappings":";;AAYA;;;;;cAAa,WAAA,UAAsB,KAAA,EAAO,KAAA,EAAO,KAAA,aAAa,KA2C7D"}

package/dist/hooks/useDebounce/useDebounce.d.ts

@@ -0,0 +1,11 @@
+//#region src/hooks/useDebounce/useDebounce.d.ts
+/**
+ * Hook that debounces a value
+ * @param value - The value to debounce
+ * @param delay - Delay in milliseconds
+ * @returns The debounced value
+ */
+declare const useDebounce: <Value>(value: Value, delay: number) => Value;
+//#endregion
+export { useDebounce };
+//# sourceMappingURL=useDebounce.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useDebounce.d.ts","names":[],"sources":["../../../src/hooks/useDebounce/useDebounce.ts"],"mappings":";;AAYA;;;;;cAAa,WAAA,UAAsB,KAAA,EAAO,KAAA,EAAO,KAAA,aAAa,KA2C7D"}

package/dist/hooks/useDebounce/useDebounce.js

@@ -0,0 +1,36 @@
+import { isTestEnvironment } from "@fuf-stack/pixel-utils";
+import { useEffect, useRef, useState } from "react";
+//#region src/hooks/useDebounce/useDebounce.ts
+/**
+* Hook that debounces a value
+* @param value - The value to debounce
+* @param delay - Delay in milliseconds
+* @returns The debounced value
+*/
+const useDebounce = (value, delay) => {
+	const [debouncedValue, setDebouncedValue] = useState(value);
+	const isMountedRef = useRef(true);
+	useEffect(() => {
+		isMountedRef.current = true;
+		return () => {
+			isMountedRef.current = false;
+		};
+	}, []);
+	useEffect(() => {
+		if (isTestEnvironment()) {
+			setDebouncedValue(value);
+			return;
+		}
+		const handler = setTimeout(() => {
+			if (isMountedRef.current) setDebouncedValue(value);
+		}, delay);
+		return () => {
+			clearTimeout(handler);
+		};
+	}, [value, delay]);
+	return debouncedValue;
+};
+//#endregion
+export { useDebounce };
+
+//# sourceMappingURL=useDebounce.js.map

package/dist/hooks/useDebounce/useDebounce.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDebounce.js","names":[],"sources":["../../../src/hooks/useDebounce/useDebounce.ts"],"sourcesContent":["/* eslint-disable import-x/prefer-default-export */\n\nimport { useEffect, useRef, useState } from 'react';\n\nimport { isTestEnvironment } from '@fuf-stack/pixel-utils';\n\n/**\n * Hook that debounces a value\n * @param value - The value to debounce\n * @param delay - Delay in milliseconds\n * @returns The debounced value\n */\nexport const useDebounce = <Value>(value: Value, delay: number) => {\n  // State and setters for debounced value\n  const [debouncedValue, setDebouncedValue] = useState(value);\n  // Track if component is mounted to prevent setState on unmounted component\n  const isMountedRef = useRef(true);\n\n  useEffect(() => {\n    // Mark as mounted\n    isMountedRef.current = true;\n    return () => {\n      // Mark as unmounted on cleanup\n      isMountedRef.current = false;\n    };\n  }, []);\n\n  useEffect(\n    () => {\n      // In test environments, skip debouncing for immediate snapshots\n      if (isTestEnvironment()) {\n        setDebouncedValue(value);\n        return;\n      }\n\n      // Update debounced value after delay\n      const handler = setTimeout(() => {\n        // Only update state if component is still mounted\n        if (isMountedRef.current) {\n          setDebouncedValue(value);\n        }\n      }, delay);\n\n      // Cancel the timeout if value changes (also on delay change or unmount)\n      // This is how we prevent debounced value from updating if value is changed ...\n      // .. within the delay period. Timeout gets cleared and restarted.\n      // eslint-disable-next-line consistent-return\n      return () => {\n        clearTimeout(handler);\n      };\n    },\n    [value, delay], // Only re-call effect if value or delay changes\n  );\n\n  return debouncedValue;\n};\n"],"mappings":";;;;;;;;;AAYA,MAAa,eAAsB,OAAc,UAAkB;CAEjE,MAAM,CAAC,gBAAgB,qBAAqB,SAAS,KAAK;CAE1D,MAAM,eAAe,OAAO,IAAI;CAEhC,gBAAgB;EAEd,aAAa,UAAU;EACvB,aAAa;GAEX,aAAa,UAAU;EACzB;CACF,GAAG,CAAC,CAAC;CAEL,gBACQ;EAEJ,IAAI,kBAAkB,GAAG;GACvB,kBAAkB,KAAK;GACvB;EACF;EAGA,MAAM,UAAU,iBAAiB;GAE/B,IAAI,aAAa,SACf,kBAAkB,KAAK;EAE3B,GAAG,KAAK;EAMR,aAAa;GACX,aAAa,OAAO;EACtB;CACF,GACA,CAAC,OAAO,KAAK,CACf;CAEA,OAAO;AACT"}

package/dist/hooks/useIsInitialRenderCycle/index.cjs

@@ -1,8 +1,3 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});
-
-var _chunkON3PVFZYcjs = require('../../chunk-ON3PVFZY.cjs');
-require('../../chunk-AHEA4IJV.cjs');
-
-
-exports.useIsInitialRenderCycle = _chunkON3PVFZYcjs.useIsInitialRenderCycle;
-//# sourceMappingURL=index.cjs.map
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_useIsInitialRenderCycle = require("./useIsInitialRenderCycle.cjs");
+exports.useIsInitialRenderCycle = require_useIsInitialRenderCycle.useIsInitialRenderCycle;

package/dist/hooks/useIsInitialRenderCycle/index.d.cts

@@ -1,8 +1,2 @@
-/**
- * A hook that returns true on initial render and false afterward.
- *
- * @returns {boolean} - True on initial render, false afterward
- */
-declare const useIsInitialRenderCycle: () => boolean;
-
-export { useIsInitialRenderCycle };
+import { useIsInitialRenderCycle } from "./useIsInitialRenderCycle.cjs";
+export { useIsInitialRenderCycle };

package/dist/hooks/useIsInitialRenderCycle/index.d.ts

@@ -1,8 +1,2 @@
-/**
- * A hook that returns true on initial render and false afterward.
- *
- * @returns {boolean} - True on initial render, false afterward
- */
-declare const useIsInitialRenderCycle: () => boolean;
-
-export { useIsInitialRenderCycle };
+import { useIsInitialRenderCycle } from "./useIsInitialRenderCycle.js";
+export { useIsInitialRenderCycle };

package/dist/hooks/useIsInitialRenderCycle/index.js

@@ -1,8 +1,2 @@
-import {
-  useIsInitialRenderCycle
-} from "../../chunk-GKYJUGD4.js";
-import "../../chunk-OAIRL2FN.js";
-export {
-  useIsInitialRenderCycle
-};
-//# sourceMappingURL=index.js.map
+import { useIsInitialRenderCycle } from "./useIsInitialRenderCycle.js";
+export { useIsInitialRenderCycle };

package/dist/hooks/useIsInitialRenderCycle/useIsInitialRenderCycle.cjs

@@ -0,0 +1,19 @@
+require("../../_virtual/_rolldown/runtime.cjs");
+let react = require("react");
+//#region src/hooks/useIsInitialRenderCycle/useIsInitialRenderCycle.ts
+/**
+* A hook that returns true on initial render and false afterward.
+*
+* @returns {boolean} - True on initial render, false afterward
+*/
+const useIsInitialRenderCycle = () => {
+	const isInitialRender = (0, react.useRef)(true);
+	(0, react.useEffect)(() => {
+		isInitialRender.current = false;
+	}, []);
+	return isInitialRender.current;
+};
+//#endregion
+exports.useIsInitialRenderCycle = useIsInitialRenderCycle;
+
+//# sourceMappingURL=useIsInitialRenderCycle.cjs.map

package/dist/hooks/useIsInitialRenderCycle/useIsInitialRenderCycle.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useIsInitialRenderCycle.cjs","names":[],"sources":["../../../src/hooks/useIsInitialRenderCycle/useIsInitialRenderCycle.ts"],"sourcesContent":["/* eslint-disable import-x/prefer-default-export */\n\nimport { useEffect, useRef } from 'react';\n\n/**\n * A hook that returns true on initial render and false afterward.\n *\n * @returns {boolean} - True on initial render, false afterward\n */\nexport const useIsInitialRenderCycle = (): boolean => {\n  // Use ref to avoid re-renders\n  const isInitialRender = useRef(true);\n\n  // Update ref after first render\n  useEffect(() => {\n    // Set to false after component mounts\n    isInitialRender.current = false;\n\n    // No cleanup needed for this effect\n  }, []);\n\n  return isInitialRender.current;\n};\n"],"mappings":";;;;;;;;AASA,MAAa,gCAAyC;CAEpD,MAAM,mBAAA,GAAA,MAAA,QAAyB,IAAI;CAGnC,CAAA,GAAA,MAAA,iBAAgB;EAEd,gBAAgB,UAAU;CAG5B,GAAG,CAAC,CAAC;CAEL,OAAO,gBAAgB;AACzB"}

package/dist/hooks/useIsInitialRenderCycle/useIsInitialRenderCycle.d.cts

@@ -0,0 +1,10 @@
+//#region src/hooks/useIsInitialRenderCycle/useIsInitialRenderCycle.d.ts
+/**
+ * A hook that returns true on initial render and false afterward.
+ *
+ * @returns {boolean} - True on initial render, false afterward
+ */
+declare const useIsInitialRenderCycle: () => boolean;
+//#endregion
+export { useIsInitialRenderCycle };
+//# sourceMappingURL=useIsInitialRenderCycle.d.cts.map

package/dist/hooks/useIsInitialRenderCycle/useIsInitialRenderCycle.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useIsInitialRenderCycle.d.cts","names":[],"sources":["../../../src/hooks/useIsInitialRenderCycle/useIsInitialRenderCycle.ts"],"mappings":";;AASA;;;;cAAa,uBAAA"}

package/dist/hooks/useIsInitialRenderCycle/useIsInitialRenderCycle.d.ts

@@ -0,0 +1,10 @@
+//#region src/hooks/useIsInitialRenderCycle/useIsInitialRenderCycle.d.ts
+/**
+ * A hook that returns true on initial render and false afterward.
+ *
+ * @returns {boolean} - True on initial render, false afterward
+ */
+declare const useIsInitialRenderCycle: () => boolean;
+//#endregion
+export { useIsInitialRenderCycle };
+//# sourceMappingURL=useIsInitialRenderCycle.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useIsInitialRenderCycle.d.ts","names":[],"sources":["../../../src/hooks/useIsInitialRenderCycle/useIsInitialRenderCycle.ts"],"mappings":";;AASA;;;;cAAa,uBAAA"}

package/dist/hooks/useIsInitialRenderCycle/useIsInitialRenderCycle.js

@@ -0,0 +1,18 @@
+import { useEffect, useRef } from "react";
+//#region src/hooks/useIsInitialRenderCycle/useIsInitialRenderCycle.ts
+/**
+* A hook that returns true on initial render and false afterward.
+*
+* @returns {boolean} - True on initial render, false afterward
+*/
+const useIsInitialRenderCycle = () => {
+	const isInitialRender = useRef(true);
+	useEffect(() => {
+		isInitialRender.current = false;
+	}, []);
+	return isInitialRender.current;
+};
+//#endregion
+export { useIsInitialRenderCycle };
+
+//# sourceMappingURL=useIsInitialRenderCycle.js.map

package/dist/hooks/useIsInitialRenderCycle/useIsInitialRenderCycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useIsInitialRenderCycle.js","names":[],"sources":["../../../src/hooks/useIsInitialRenderCycle/useIsInitialRenderCycle.ts"],"sourcesContent":["/* eslint-disable import-x/prefer-default-export */\n\nimport { useEffect, useRef } from 'react';\n\n/**\n * A hook that returns true on initial render and false afterward.\n *\n * @returns {boolean} - True on initial render, false afterward\n */\nexport const useIsInitialRenderCycle = (): boolean => {\n  // Use ref to avoid re-renders\n  const isInitialRender = useRef(true);\n\n  // Update ref after first render\n  useEffect(() => {\n    // Set to false after component mounts\n    isInitialRender.current = false;\n\n    // No cleanup needed for this effect\n  }, []);\n\n  return isInitialRender.current;\n};\n"],"mappings":";;;;;;;AASA,MAAa,gCAAyC;CAEpD,MAAM,kBAAkB,OAAO,IAAI;CAGnC,gBAAgB;EAEd,gBAAgB,UAAU;CAG5B,GAAG,CAAC,CAAC;CAEL,OAAO,gBAAgB;AACzB"}

package/dist/hooks/useLocalStorage/index.cjs

@@ -1,8 +1,3 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});
-
-var _chunkIXBNFKOScjs = require('../../chunk-IXBNFKOS.cjs');
-require('../../chunk-AHEA4IJV.cjs');
-
-
-exports.useLocalStorage = _chunkIXBNFKOScjs.useLocalStorage;
-//# sourceMappingURL=index.cjs.map
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_useLocalStorage = require("./useLocalStorage.cjs");
+exports.useLocalStorage = require_useLocalStorage.useLocalStorage;

package/dist/hooks/useLocalStorage/index.d.cts

@@ -1,5 +1,2 @@
-import { Dispatch, SetStateAction } from 'react';
-
-declare const useLocalStorage: <T>(key: string, initialValue: T | (() => T)) => [T, Dispatch<SetStateAction<T>>];
-
-export { useLocalStorage };
+import { useLocalStorage } from "./useLocalStorage.cjs";
+export { useLocalStorage };

package/dist/hooks/useLocalStorage/index.d.ts

@@ -1,5 +1,2 @@
-import { Dispatch, SetStateAction } from 'react';
-
-declare const useLocalStorage: <T>(key: string, initialValue: T | (() => T)) => [T, Dispatch<SetStateAction<T>>];
-
-export { useLocalStorage };
+import { useLocalStorage } from "./useLocalStorage.js";
+export { useLocalStorage };

package/dist/hooks/useLocalStorage/index.js

@@ -1,8 +1,2 @@
-import {
-  useLocalStorage
-} from "../../chunk-M3Y2DZZE.js";
-import "../../chunk-OAIRL2FN.js";
-export {
-  useLocalStorage
-};
-//# sourceMappingURL=index.js.map
+import { useLocalStorage } from "./useLocalStorage.js";
+export { useLocalStorage };

package/dist/hooks/useLocalStorage/useLocalStorage.cjs

@@ -0,0 +1,54 @@
+require("../../_virtual/_rolldown/runtime.cjs");
+let react = require("react");
+//#region src/hooks/useLocalStorage/useLocalStorage.ts
+const useLocalStorage = (key, initialValue) => {
+	const readValue = () => {
+		const resolveInitialValue = () => {
+			return typeof initialValue === "function" ? initialValue() : initialValue;
+		};
+		if (typeof window === "undefined") return resolveInitialValue();
+		try {
+			const item = window.localStorage.getItem(key);
+			if (item) return JSON.parse(item);
+			return resolveInitialValue();
+		} catch (error) {
+			console.warn(`Error reading localStorage key "${key}":`, error);
+			return resolveInitialValue();
+		}
+	};
+	const [storedValue, setStoredValue] = (0, react.useState)(readValue);
+	const setValue = (value) => {
+		if (typeof window === "undefined") {
+			console.warn(`Tried setting localStorage key "${key}" even though environment is not a client`);
+			return;
+		}
+		try {
+			const newValue = value instanceof Function ? value(storedValue) : value;
+			window.localStorage.setItem(key, JSON.stringify(newValue));
+			setStoredValue(newValue);
+			window.dispatchEvent(new Event("local-storage"));
+		} catch (error) {
+			console.warn(`Error setting localStorage key "${key}":`, error);
+		}
+	};
+	(0, react.useEffect)(() => {
+		setStoredValue(readValue());
+	}, []);
+	(0, react.useEffect)(() => {
+		if (typeof window === "undefined") return;
+		const handleStorageChange = () => {
+			setStoredValue(readValue());
+		};
+		window.addEventListener("storage", handleStorageChange);
+		window.addEventListener("local-storage", handleStorageChange);
+		return () => {
+			window.removeEventListener("storage", handleStorageChange);
+			window.removeEventListener("local-storage", handleStorageChange);
+		};
+	}, []);
+	return [storedValue, setValue];
+};
+//#endregion
+exports.useLocalStorage = useLocalStorage;
+
+//# sourceMappingURL=useLocalStorage.cjs.map

package/dist/hooks/useLocalStorage/useLocalStorage.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLocalStorage.cjs","names":[],"sources":["../../../src/hooks/useLocalStorage/useLocalStorage.ts"],"sourcesContent":["/* eslint-disable import-x/prefer-default-export */\n\nimport type { Dispatch, SetStateAction } from 'react';\n\nimport { useEffect, useState } from 'react';\n\nexport const useLocalStorage = <T>(\n  key: string,\n  initialValue: T | (() => T),\n): [T, Dispatch<SetStateAction<T>>] => {\n  // Get from local storage then\n  // parse stored json or return initialValue\n  const readValue = (): T => {\n    // Helper to resolve initial value (handle function or direct value)\n    const resolveInitialValue = (): T => {\n      return typeof initialValue === 'function'\n        ? (initialValue as () => T)()\n        : initialValue;\n    };\n\n    // Prevent build error \"window is undefined\" but keep keep working\n    if (typeof window === 'undefined') {\n      return resolveInitialValue();\n    }\n\n    try {\n      // eslint-disable-next-line n/no-unsupported-features/node-builtins\n      const item = window.localStorage.getItem(key);\n      if (item) {\n        return JSON.parse(item) as T;\n      }\n      return resolveInitialValue();\n    } catch (error) {\n      console.warn(`Error reading localStorage key \"${key}\":`, error);\n      return resolveInitialValue();\n    }\n  };\n\n  // State to store our value\n  // Pass initial state function to useState so logic is only executed once\n  const [storedValue, setStoredValue] = useState<T>(readValue);\n\n  // Return a wrapped version of useState's setter function that ...\n  // ... persists the new value to localStorage.\n  const setValue: Dispatch<SetStateAction<T>> = (value) => {\n    // Prevent build error \"window is undefined\" but keeps working\n    if (typeof window === 'undefined') {\n      console.warn(\n        `Tried setting localStorage key \"${key}\" even though environment is not a client`,\n      );\n      return;\n    }\n\n    try {\n      // Allow value to be a function so we have the same API as useState\n      const newValue = value instanceof Function ? value(storedValue) : value;\n\n      // Save to local storage\n      // eslint-disable-next-line n/no-unsupported-features/node-builtins\n      window.localStorage.setItem(key, JSON.stringify(newValue));\n\n      // Save state\n      setStoredValue(newValue);\n\n      // We dispatch a custom event so every useLocalStorage hook are notified\n      window.dispatchEvent(new Event('local-storage'));\n    } catch (error) {\n      console.warn(`Error setting localStorage key \"${key}\":`, error);\n    }\n  };\n\n  useEffect(() => {\n    setStoredValue(readValue());\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, []);\n\n  useEffect(() => {\n    // Skip event listeners in SSR environment\n    if (typeof window === 'undefined') {\n      return undefined;\n    }\n\n    const handleStorageChange = () => {\n      setStoredValue(readValue());\n    };\n\n    // this only works for other documents, not the current one\n    window.addEventListener('storage', handleStorageChange);\n\n    // this is a custom event, triggered in writeValueToLocalStorage\n    window.addEventListener('local-storage', handleStorageChange);\n\n    return () => {\n      window.removeEventListener('storage', handleStorageChange);\n      window.removeEventListener('local-storage', handleStorageChange);\n    };\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, []);\n\n  return [storedValue, setValue];\n};\n"],"mappings":";;;AAMA,MAAa,mBACX,KACA,iBACqC;CAGrC,MAAM,kBAAqB;EAEzB,MAAM,4BAA+B;GACnC,OAAO,OAAO,iBAAiB,aAC1B,aAAyB,IAC1B;EACN;EAGA,IAAI,OAAO,WAAW,aACpB,OAAO,oBAAoB;EAG7B,IAAI;GAEF,MAAM,OAAO,OAAO,aAAa,QAAQ,GAAG;GAC5C,IAAI,MACF,OAAO,KAAK,MAAM,IAAI;GAExB,OAAO,oBAAoB;EAC7B,SAAS,OAAO;GACd,QAAQ,KAAK,mCAAmC,IAAI,KAAK,KAAK;GAC9D,OAAO,oBAAoB;EAC7B;CACF;CAIA,MAAM,CAAC,aAAa,mBAAA,GAAA,MAAA,UAA8B,SAAS;CAI3D,MAAM,YAAyC,UAAU;EAEvD,IAAI,OAAO,WAAW,aAAa;GACjC,QAAQ,KACN,mCAAmC,IAAI,0CACzC;GACA;EACF;EAEA,IAAI;GAEF,MAAM,WAAW,iBAAiB,WAAW,MAAM,WAAW,IAAI;GAIlE,OAAO,aAAa,QAAQ,KAAK,KAAK,UAAU,QAAQ,CAAC;GAGzD,eAAe,QAAQ;GAGvB,OAAO,cAAc,IAAI,MAAM,eAAe,CAAC;EACjD,SAAS,OAAO;GACd,QAAQ,KAAK,mCAAmC,IAAI,KAAK,KAAK;EAChE;CACF;CAEA,CAAA,GAAA,MAAA,iBAAgB;EACd,eAAe,UAAU,CAAC;CAE5B,GAAG,CAAC,CAAC;CAEL,CAAA,GAAA,MAAA,iBAAgB;EAEd,IAAI,OAAO,WAAW,aACpB;EAGF,MAAM,4BAA4B;GAChC,eAAe,UAAU,CAAC;EAC5B;EAGA,OAAO,iBAAiB,WAAW,mBAAmB;EAGtD,OAAO,iBAAiB,iBAAiB,mBAAmB;EAE5D,aAAa;GACX,OAAO,oBAAoB,WAAW,mBAAmB;GACzD,OAAO,oBAAoB,iBAAiB,mBAAmB;EACjE;CAEF,GAAG,CAAC,CAAC;CAEL,OAAO,CAAC,aAAa,QAAQ;AAC/B"}

package/dist/hooks/useLocalStorage/useLocalStorage.d.cts

@@ -0,0 +1,7 @@
+import { Dispatch, SetStateAction } from "react";
+
+//#region src/hooks/useLocalStorage/useLocalStorage.d.ts
+declare const useLocalStorage: <T>(key: string, initialValue: T | (() => T)) => [T, Dispatch<SetStateAction<T>>];
+//#endregion
+export { useLocalStorage };
+//# sourceMappingURL=useLocalStorage.d.cts.map

package/dist/hooks/useLocalStorage/useLocalStorage.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLocalStorage.d.cts","names":[],"sources":["../../../src/hooks/useLocalStorage/useLocalStorage.ts"],"mappings":";;;cAMa,eAAA,MACX,GAAA,UACA,YAAA,EAAc,CAAA,UAAW,CAAA,OACvB,CAAA,EAAG,QAAA,CAAS,cAAA,CAAe,CAAA"}

package/dist/hooks/useLocalStorage/useLocalStorage.d.ts

@@ -0,0 +1,7 @@
+import { Dispatch, SetStateAction } from "react";
+
+//#region src/hooks/useLocalStorage/useLocalStorage.d.ts
+declare const useLocalStorage: <T>(key: string, initialValue: T | (() => T)) => [T, Dispatch<SetStateAction<T>>];
+//#endregion
+export { useLocalStorage };
+//# sourceMappingURL=useLocalStorage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useLocalStorage.d.ts","names":[],"sources":["../../../src/hooks/useLocalStorage/useLocalStorage.ts"],"mappings":";;;cAMa,eAAA,MACX,GAAA,UACA,YAAA,EAAc,CAAA,UAAW,CAAA,OACvB,CAAA,EAAG,QAAA,CAAS,cAAA,CAAe,CAAA"}

package/dist/hooks/useLocalStorage/useLocalStorage.js

@@ -0,0 +1,53 @@
+import { useEffect, useState } from "react";
+//#region src/hooks/useLocalStorage/useLocalStorage.ts
+const useLocalStorage = (key, initialValue) => {
+	const readValue = () => {
+		const resolveInitialValue = () => {
+			return typeof initialValue === "function" ? initialValue() : initialValue;
+		};
+		if (typeof window === "undefined") return resolveInitialValue();
+		try {
+			const item = window.localStorage.getItem(key);
+			if (item) return JSON.parse(item);
+			return resolveInitialValue();
+		} catch (error) {
+			console.warn(`Error reading localStorage key "${key}":`, error);
+			return resolveInitialValue();
+		}
+	};
+	const [storedValue, setStoredValue] = useState(readValue);
+	const setValue = (value) => {
+		if (typeof window === "undefined") {
+			console.warn(`Tried setting localStorage key "${key}" even though environment is not a client`);
+			return;
+		}
+		try {
+			const newValue = value instanceof Function ? value(storedValue) : value;
+			window.localStorage.setItem(key, JSON.stringify(newValue));
+			setStoredValue(newValue);
+			window.dispatchEvent(new Event("local-storage"));
+		} catch (error) {
+			console.warn(`Error setting localStorage key "${key}":`, error);
+		}
+	};
+	useEffect(() => {
+		setStoredValue(readValue());
+	}, []);
+	useEffect(() => {
+		if (typeof window === "undefined") return;
+		const handleStorageChange = () => {
+			setStoredValue(readValue());
+		};
+		window.addEventListener("storage", handleStorageChange);
+		window.addEventListener("local-storage", handleStorageChange);
+		return () => {
+			window.removeEventListener("storage", handleStorageChange);
+			window.removeEventListener("local-storage", handleStorageChange);
+		};
+	}, []);
+	return [storedValue, setValue];
+};
+//#endregion
+export { useLocalStorage };
+
+//# sourceMappingURL=useLocalStorage.js.map

package/dist/hooks/useLocalStorage/useLocalStorage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLocalStorage.js","names":[],"sources":["../../../src/hooks/useLocalStorage/useLocalStorage.ts"],"sourcesContent":["/* eslint-disable import-x/prefer-default-export */\n\nimport type { Dispatch, SetStateAction } from 'react';\n\nimport { useEffect, useState } from 'react';\n\nexport const useLocalStorage = <T>(\n  key: string,\n  initialValue: T | (() => T),\n): [T, Dispatch<SetStateAction<T>>] => {\n  // Get from local storage then\n  // parse stored json or return initialValue\n  const readValue = (): T => {\n    // Helper to resolve initial value (handle function or direct value)\n    const resolveInitialValue = (): T => {\n      return typeof initialValue === 'function'\n        ? (initialValue as () => T)()\n        : initialValue;\n    };\n\n    // Prevent build error \"window is undefined\" but keep keep working\n    if (typeof window === 'undefined') {\n      return resolveInitialValue();\n    }\n\n    try {\n      // eslint-disable-next-line n/no-unsupported-features/node-builtins\n      const item = window.localStorage.getItem(key);\n      if (item) {\n        return JSON.parse(item) as T;\n      }\n      return resolveInitialValue();\n    } catch (error) {\n      console.warn(`Error reading localStorage key \"${key}\":`, error);\n      return resolveInitialValue();\n    }\n  };\n\n  // State to store our value\n  // Pass initial state function to useState so logic is only executed once\n  const [storedValue, setStoredValue] = useState<T>(readValue);\n\n  // Return a wrapped version of useState's setter function that ...\n  // ... persists the new value to localStorage.\n  const setValue: Dispatch<SetStateAction<T>> = (value) => {\n    // Prevent build error \"window is undefined\" but keeps working\n    if (typeof window === 'undefined') {\n      console.warn(\n        `Tried setting localStorage key \"${key}\" even though environment is not a client`,\n      );\n      return;\n    }\n\n    try {\n      // Allow value to be a function so we have the same API as useState\n      const newValue = value instanceof Function ? value(storedValue) : value;\n\n      // Save to local storage\n      // eslint-disable-next-line n/no-unsupported-features/node-builtins\n      window.localStorage.setItem(key, JSON.stringify(newValue));\n\n      // Save state\n      setStoredValue(newValue);\n\n      // We dispatch a custom event so every useLocalStorage hook are notified\n      window.dispatchEvent(new Event('local-storage'));\n    } catch (error) {\n      console.warn(`Error setting localStorage key \"${key}\":`, error);\n    }\n  };\n\n  useEffect(() => {\n    setStoredValue(readValue());\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, []);\n\n  useEffect(() => {\n    // Skip event listeners in SSR environment\n    if (typeof window === 'undefined') {\n      return undefined;\n    }\n\n    const handleStorageChange = () => {\n      setStoredValue(readValue());\n    };\n\n    // this only works for other documents, not the current one\n    window.addEventListener('storage', handleStorageChange);\n\n    // this is a custom event, triggered in writeValueToLocalStorage\n    window.addEventListener('local-storage', handleStorageChange);\n\n    return () => {\n      window.removeEventListener('storage', handleStorageChange);\n      window.removeEventListener('local-storage', handleStorageChange);\n    };\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, []);\n\n  return [storedValue, setValue];\n};\n"],"mappings":";;AAMA,MAAa,mBACX,KACA,iBACqC;CAGrC,MAAM,kBAAqB;EAEzB,MAAM,4BAA+B;GACnC,OAAO,OAAO,iBAAiB,aAC1B,aAAyB,IAC1B;EACN;EAGA,IAAI,OAAO,WAAW,aACpB,OAAO,oBAAoB;EAG7B,IAAI;GAEF,MAAM,OAAO,OAAO,aAAa,QAAQ,GAAG;GAC5C,IAAI,MACF,OAAO,KAAK,MAAM,IAAI;GAExB,OAAO,oBAAoB;EAC7B,SAAS,OAAO;GACd,QAAQ,KAAK,mCAAmC,IAAI,KAAK,KAAK;GAC9D,OAAO,oBAAoB;EAC7B;CACF;CAIA,MAAM,CAAC,aAAa,kBAAkB,SAAY,SAAS;CAI3D,MAAM,YAAyC,UAAU;EAEvD,IAAI,OAAO,WAAW,aAAa;GACjC,QAAQ,KACN,mCAAmC,IAAI,0CACzC;GACA;EACF;EAEA,IAAI;GAEF,MAAM,WAAW,iBAAiB,WAAW,MAAM,WAAW,IAAI;GAIlE,OAAO,aAAa,QAAQ,KAAK,KAAK,UAAU,QAAQ,CAAC;GAGzD,eAAe,QAAQ;GAGvB,OAAO,cAAc,IAAI,MAAM,eAAe,CAAC;EACjD,SAAS,OAAO;GACd,QAAQ,KAAK,mCAAmC,IAAI,KAAK,KAAK;EAChE;CACF;CAEA,gBAAgB;EACd,eAAe,UAAU,CAAC;CAE5B,GAAG,CAAC,CAAC;CAEL,gBAAgB;EAEd,IAAI,OAAO,WAAW,aACpB;EAGF,MAAM,4BAA4B;GAChC,eAAe,UAAU,CAAC;EAC5B;EAGA,OAAO,iBAAiB,WAAW,mBAAmB;EAGtD,OAAO,iBAAiB,iBAAiB,mBAAmB;EAE5D,aAAa;GACX,OAAO,oBAAoB,WAAW,mBAAmB;GACzD,OAAO,oBAAoB,iBAAiB,mBAAmB;EACjE;CAEF,GAAG,CAAC,CAAC;CAEL,OAAO,CAAC,aAAa,QAAQ;AAC/B"}