@ciridae/ui 0.7.0 → 0.7.1

package/dist/components/ui/color-theme.js

@@ -1,6 +1,7 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import * as React from "react";
 import { PALETTE_TOKEN_NAMES, canonicalPaletteSelection, derivePaletteTokens, paletteSelectionKey, resolvePaletteSelection, } from "../../lib/palette";
+import { readStoredValue, removeStoredValue, writeStoredValue } from "../../lib/browser-storage";
 import { ThemeContext, } from "./color-theme-context";
 const defaultStorageKey = "ciridae-ui-theme";
 const defaultPaletteStorageKey = "ciridae-ui-palette";
@@ -41,18 +42,18 @@ function ThemeProvider({ children, defaultMode = "system", defaultPalette, stora
     }, []);
     const setMode = React.useCallback((nextMode) => {
         setModeState(nextMode);
-        localStorage.setItem(storageKey, nextMode);
+        writeStoredValue(storageKey, nextMode);
     }, [storageKey]);
     const toggleTheme = React.useCallback(() => {
         setMode(resolvedTheme === "dark" ? "light" : "dark");
     }, [resolvedTheme, setMode]);
     const setPalette = React.useCallback((nextPalette) => {
         setStoredPalette(nextPalette);
-        localStorage.setItem(paletteStorageKey, JSON.stringify(nextPalette));
+        writeStoredValue(paletteStorageKey, JSON.stringify(nextPalette));
     }, [paletteStorageKey]);
     const resetPalette = React.useCallback(() => {
         setStoredPalette(null);
-        localStorage.removeItem(paletteStorageKey);
+        removeStoredValue(paletteStorageKey);
     }, [paletteStorageKey]);
     const contextValue = React.useMemo(() => ({
         mode,
@@ -104,9 +105,7 @@ function usePaletteTokens(palette, mode) {
     }, [palette, mode]);
 }
 function readStoredMode(storageKey, defaultMode) {
-    if (typeof window === "undefined")
-        return defaultMode;
-    const storedMode = localStorage.getItem(storageKey);
+    const storedMode = readStoredValue(storageKey);
     if (storedMode === "light" || storedMode === "dark" || storedMode === "system") {
         return storedMode;
     }
@@ -117,9 +116,7 @@ function readStoredMode(storageKey, defaultMode) {
  * deploys, so it outlives renamed presets and older shapes of the type.
  */
 function readStoredPalette(storageKey) {
-    if (typeof window === "undefined")
-        return null;
-    const raw = localStorage.getItem(storageKey);
+    const raw = readStoredValue(storageKey);
     if (!raw)
         return null;
     try {

package/dist/lib/browser-storage.d.ts

@@ -0,0 +1,13 @@
+/**
+ * localStorage that cannot throw at its callers.
+ *
+ * Every access can raise: the API is absent during SSR, `getItem` throws when
+ * storage is disabled by policy or by Safari's private mode, and `setItem`
+ * throws on quota. A preference is worth remembering and never worth failing
+ * over, so each call degrades to "no stored value" and the caller keeps its
+ * in-memory state.
+ */
+declare function readStoredValue(key: string): string | null;
+declare function writeStoredValue(key: string, value: string): void;
+declare function removeStoredValue(key: string): void;
+export { readStoredValue, removeStoredValue, writeStoredValue };

package/dist/lib/browser-storage.js

@@ -0,0 +1,43 @@
+/**
+ * localStorage that cannot throw at its callers.
+ *
+ * Every access can raise: the API is absent during SSR, `getItem` throws when
+ * storage is disabled by policy or by Safari's private mode, and `setItem`
+ * throws on quota. A preference is worth remembering and never worth failing
+ * over, so each call degrades to "no stored value" and the caller keeps its
+ * in-memory state.
+ */
+function storage() {
+    try {
+        return typeof window === "undefined" ? null : window.localStorage;
+    }
+    catch {
+        // Accessing the property itself throws when storage is blocked by policy.
+        return null;
+    }
+}
+function readStoredValue(key) {
+    try {
+        return storage()?.getItem(key) ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+function writeStoredValue(key, value) {
+    try {
+        storage()?.setItem(key, value);
+    }
+    catch {
+        // Disabled or over quota: the preference lives for this session only.
+    }
+}
+function removeStoredValue(key) {
+    try {
+        storage()?.removeItem(key);
+    }
+    catch {
+        // Nothing to recover from -- the value either was not written or stays.
+    }
+}
+export { readStoredValue, removeStoredValue, writeStoredValue };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@ciridae/ui",
-	"version": "0.7.0",
+	"version": "0.7.1",
 	"type": "module",
 	"private": false,
 	"engines": {