@versini/ui-hooks 2.0.0 → 2.1.1

package/dist/hooks/useEventCallback.js

@@ -0,0 +1,12 @@
+import { useRef as t, useEffect as a, useCallback as c } from "react";
+function o(r) {
+  const e = t(() => {
+    throw new Error("Cannot call an event handler while rendering.");
+  });
+  return a(() => {
+    e.current = r;
+  }, [r]), c((...n) => e.current(...n), [e]);
+}
+export {
+  o as useEventCallback
+};

package/dist/hooks/useEventListener.js

@@ -0,0 +1,18 @@
+import { useRef as E, useEffect as i } from "react";
+function o(n, c, r, e) {
+  const s = E(c);
+  i(() => {
+    s.current = c;
+  }, [c]), i(() => {
+    const t = (r == null ? void 0 : r.current) ?? window;
+    if (!(t && t.addEventListener))
+      return;
+    const u = (f) => s.current(f);
+    return t.addEventListener(n, u, e), () => {
+      t.removeEventListener(n, u, e);
+    };
+  }, [n, r, e]);
+}
+export {
+  o as useEventListener
+};

package/dist/hooks/useLocalStorage.js

@@ -0,0 +1,59 @@
+import { useCallback as u, useState as m } from "react";
+import { useEventCallback as w } from "./useEventCallback.js";
+import { useEventListener as E } from "./useEventListener.js";
+const s = "av-local-storage", h = (t) => {
+  try {
+    return JSON.stringify(t);
+  } catch {
+    throw new Error(
+      "@versini/ui-hooks useLocalStorage: Failed to serialize the value"
+    );
+  }
+}, p = (t) => {
+  try {
+    return t && JSON.parse(t);
+  } catch {
+    return t;
+  }
+};
+function V({
+  key: t,
+  defaultValue: n,
+  deserialize: g = p,
+  serialize: c = (o) => h(o)
+}) {
+  const o = typeof n == "function" ? n() : n, a = u(() => {
+    let r;
+    try {
+      r = typeof window > "u" || !("localStorage" in window) || window.localStorage === null;
+    } catch {
+      r = !0;
+    }
+    if (r)
+      return window.localStorage.setItem(t, c(o)), o;
+    try {
+      const e = window.localStorage.getItem(t);
+      return e !== null ? g(e) : (window.localStorage.setItem(t, c(o)), o);
+    } catch (e) {
+      return console.warn(`Error reading localStorage key “${t}”:`, e), o;
+    }
+  }, [o, t]), [l, i] = m(a()), S = w((r) => {
+    try {
+      const e = r instanceof Function ? r(l) : r;
+      if (e === void 0)
+        return;
+      window.localStorage.setItem(t, c(e)), i(e), window.dispatchEvent(new Event(s));
+    } catch (e) {
+      console.warn(`Error setting localStorage key “${t}”:`, e);
+    }
+  }), d = w(() => (window.localStorage.removeItem(t), i(a()), window.dispatchEvent(new Event(s)), l)), f = u(
+    (r) => {
+      r != null && r.key && r.key !== t || i(a());
+    },
+    [t, a]
+  );
+  return E(s, f), [l, S, d];
+}
+export {
+  V as useLocalStorage
+};

package/dist/index.d.ts

@@ -1,3 +1,41 @@
+declare const CUSTOM_EVENT_NAME = "av-local-storage";
+declare global {
+    interface WindowEventMap {
+        [CUSTOM_EVENT_NAME]: CustomEvent;
+    }
+}
+interface StorageProperties<T> {
+    /**
+     * Storage key.
+     */
+    key: string;
+    /**
+     * Default value that will be set if value is not found in storage.
+     */
+    defaultValue?: T;
+    /**
+     * Function to serialize value into string to be saved in storage.
+     */
+    serialize?: (value: T) => string;
+    /**
+     * Function to deserialize string value from storage to value.
+     */
+    deserialize?: (value: string | undefined) => T;
+}
+/**
+ *
+ * @example
+ * import { useLocalStorage } from '@versini/ui-hooks';
+ * const [value, setValue] = useLocalStorage({
+ *   key: 'gpt-model',
+ *   defaultValue: 'gpt-3',
+ * });
+ *
+ * setValue('gpt-4');
+ * setValue((current) => (current === 'gpt-3' ? 'gpt-4' : 'gpt-3'));
+ */
+declare function useLocalStorage<T = string>({ key, defaultValue, deserialize, serialize, }: StorageProperties<T>): [T, (val: T | ((prevState: T) => T)) => void, () => void];
+
 /**
  * React utility to merge refs.
  *
@@ -91,4 +129,4 @@ type UseUniqueIdOptions = string | number | {
 };
 declare function useUniqueId(options?: UseUniqueIdOptions): string | undefined;
 
-export { useMergeRefs, useUncontrolled, useUniqueId };
+export { useLocalStorage, useMergeRefs, useUncontrolled, useUniqueId };

package/dist/index.js

@@ -1,13 +1,17 @@
-import { useMergeRefs as t } from "./hooks/useMergeRefs.js";
-import { useUncontrolled as m } from "./hooks/useUncontrolled.js";
-import { useUniqueId as s } from "./hooks/useUniqueId.js";
+import { useLocalStorage as p } from "./hooks/useLocalStorage.js";
+import { useMergeRefs as s } from "./hooks/useMergeRefs.js";
+import { useUncontrolled as i } from "./hooks/useUncontrolled.js";
+import { useUniqueId as l } from "./hooks/useUniqueId.js";
 import "react";
+import "./hooks/useEventCallback.js";
+import "./hooks/useEventListener.js";
 /*!
-  @versini/ui-hooks v2.0.0
+  @versini/ui-hooks v2.1.1
   © 2024 gizmette.com
 */
 export {
-  t as useMergeRefs,
-  m as useUncontrolled,
-  s as useUniqueId
+  p as useLocalStorage,
+  s as useMergeRefs,
+  i as useUncontrolled,
+  l as useUniqueId
 };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@versini/ui-hooks",
-	"version": "2.0.0",
+	"version": "2.1.1",
 	"license": "MIT",
 	"author": "Arno Versini",
 	"publishConfig": {
@@ -41,5 +41,5 @@
 		"react": "18.2.0",
 		"react-dom": "18.2.0"
 	},
-	"gitHead": "e52ecb0fd59ba92022e1253a3f0e902bb8baa8ac"
+	"gitHead": "36efe490aaadd28598f457a90c6876ed30ed927b"
 }