kitzo 2.5.3 → 2.5.4

package/dist/index.d.ts

@@ -161,7 +161,12 @@ export declare function useDebouncedCallback<Args extends unknown[]>(callback: (
 
 /**
  * A custom hook that manages a stateful value in `localStorage`,
- * ensuring synchronization across multiple tabs and components.
+ * with full SSR safety and cross-tab synchronization.
+ *
+ * The hook uses a two-phase approach: the server and first client render
+ * always use `initialValue` (preventing hydration mismatches), and the
+ * real localStorage value is synced in after mount.
+ *
  * @example
  * const [theme, setTheme] = useLocalStorage<'light' | 'dark'>('ui-theme', 'light');
  * // Supports functional updates:

package/dist/react/hooks/useLocalStorage.js

@@ -1,34 +1,33 @@
-import { useCallback as c, useState as w, useEffect as i } from "react";
-function u(t, r) {
-  const n = c(() => {
-    if (typeof window > "u")
-      return r;
+import n from "react";
+function w(t, r) {
+  const [a, s] = n.useState(r), c = n.useCallback(() => {
     try {
       const e = window.localStorage.getItem(t);
       return e ? JSON.parse(e) : r;
     } catch (e) {
-      return console.warn(`Error reading localStorage key “${t}”:`, e), r;
+      return console.warn(`Error reading localStorage key "${t}":`, e), r;
     }
-  }, [t, r]), [a, s] = w(n), d = c(
+  }, [t, r]), d = n.useCallback(
     (e) => {
       try {
         const o = e instanceof Function ? e(a) : e;
         s(o), typeof window < "u" && (window.localStorage.setItem(t, JSON.stringify(o)), window.dispatchEvent(new Event("local-storage-update")));
       } catch (o) {
-        console.warn(`Error setting localStorage key “${t}”:`, o);
+        console.warn(`Error setting localStorage key "${t}":`, o);
       }
     },
     [t, a]
   );
-  return i(() => {
+  return n.useEffect(() => {
+    s(c());
     const e = (o) => {
-      o.key && o.key !== t || s(n());
+      o.key && o.key !== t || s(c());
     };
     return window.addEventListener("storage", e), window.addEventListener("local-storage-update", e), () => {
       window.removeEventListener("storage", e), window.removeEventListener("local-storage-update", e);
     };
-  }, [t, n]), [a, d];
+  }, [t, c]), [a, d];
 }
 export {
-  u as useLocalStorage
+  w as useLocalStorage
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kitzo",
-  "version": "2.5.3",
+  "version": "2.5.4",
   "description": "A lightweight React micro-utility.",
   "type": "module",
   "files": [