Repository Public
1"use client";2// UI preferences only (theme, density, table view, period). Never session material, tokens or server data.3import { useSyncExternalStore } from "react";45const PREFIX = "mcc.ui.";67export type PrefKey = "density" | "nodes.view" | "period" | "maintenance.view" | "chart.table" | "overview.compact" | "services.view" | "alerts.tab";89export function readPref(key: PrefKey): string | null {10 try {11 return window.localStorage.getItem(PREFIX + key);12 } catch {13 return null;14 }15}1617const listeners = new Set<() => void>();18const memory = new Map<string, string | null>(); // fallback when storage is disabled1920export function writePref(key: PrefKey, value: string | null): void {21 memory.set(key, value);22 try {23 if (value === null) window.localStorage.removeItem(PREFIX + key);24 else window.localStorage.setItem(PREFIX + key, value);25 } catch {26 /* storage disabled: preference lasts for the page only */27 }28 listeners.forEach((fn) => fn());29}3031function subscribe(fn: () => void): () => void {32 listeners.add(fn);33 window.addEventListener("storage", fn);34 return () => {35 listeners.delete(fn);36 window.removeEventListener("storage", fn);37 };38}3940/**41 * Reactive preference: `const [view, setView] = usePref("nodes.view", "table")`. The server render and the first42 * client render use `fallback`; the stored value applies right after hydration (no mismatch, no effect needed).43 */44export function usePref<T extends string>(key: PrefKey, fallback: T): [T, (value: T) => void] {45 const value = useSyncExternalStore(subscribe, () => (memory.has(key) ? memory.get(key) : readPref(key)) ?? fallback, () => fallback);46 return [value as T, (v: T) => writePref(key, v)];47}4849/** Non-sensitive cookie read by the server render to avoid a theme/locale flash before hydration. */50export function writeUiCookie(name: "mcc_theme" | "mcc_locale", value: string): void {51 document.cookie = `${name}=${encodeURIComponent(value)}; Path=/; Max-Age=31536000; SameSite=Lax`;52}53