@douglasneuroinformatics/libui 3.1.5 → 3.2.0

package/dist/{chunk-K2YKS4A5.js → chunk-AFNJZUOE.js}

@@ -150,10 +150,11 @@ function useOnClickOutside(ref, handler, mouseEvent = "mousedown") {
   });
 }
 
-// src/hooks/useSessionStorage/useSessionStorage.ts
+// src/hooks/useStorage/useStorage.ts
 import { useCallback as useCallback2, useEffect as useEffect6, useState as useState3 } from "react";
-function useSessionStorage(key, initialValue, options = {}) {
+function useStorage(key, initialValue, storageName, options = {}) {
   const { initializeWithValue = true } = options;
+  const storage = window[storageName];
   const serializer = useCallback2(
     (value) => {
       if (options.serializer) {
@@ -167,8 +168,7 @@ function useSessionStorage(key, initialValue, options = {}) {
     (value) => {
       if (options.deserializer) {
         return options.deserializer(value);
-      }
-      if (value === "undefined") {
+      } else if (value === "undefined") {
         return void 0;
       }
       const defaultValue = initialValue instanceof Function ? initialValue() : initialValue;
@@ -188,7 +188,7 @@ function useSessionStorage(key, initialValue, options = {}) {
     if (!isBrowser()) {
       return initialValueToUse;
     }
-    const raw = window.sessionStorage.getItem(key);
+    const raw = storage.getItem(key);
     return raw ? deserializer(raw) : initialValueToUse;
   }, [initialValue, key, deserializer]);
   const [storedValue, setStoredValue] = useState3(() => {
@@ -199,15 +199,15 @@ function useSessionStorage(key, initialValue, options = {}) {
   });
   const setValue = useEventCallback((value) => {
     if (!isBrowser()) {
-      console.warn(`Tried setting sessionStorage key \u201C${key}\u201D even though environment is not a client`);
+      console.warn(`Tried setting storage key \u201C${key}\u201D even though environment is not a client`);
     }
     try {
       const newValue = value instanceof Function ? value(readValue()) : value;
-      window.sessionStorage.setItem(key, serializer(newValue));
+      storage.setItem(key, serializer(newValue));
       setStoredValue(newValue);
-      window.dispatchEvent(new StorageEvent("session-storage", { key }));
+      window.dispatchEvent(new StorageEvent(storageName, { key }));
     } catch (error) {
-      console.warn(`Error setting sessionStorage key \u201C${key}\u201D:`, error);
+      console.warn(`Error setting storage key \u201C${key}\u201D:`, error);
     }
   });
   useEffect6(() => {
@@ -223,10 +223,20 @@ function useSessionStorage(key, initialValue, options = {}) {
     [key, readValue]
   );
   useEventListener("storage", handleStorageChange);
-  useEventListener("session-storage", handleStorageChange);
+  useEventListener(storageName, handleStorageChange);
   return [storedValue, setValue];
 }
 
+// src/hooks/useStorage/useLocalStorage.ts
+function useLocalStorage(key, initialValue, options = {}) {
+  return useStorage(key, initialValue, "localStorage", options);
+}
+
+// src/hooks/useStorage/useSessionStorage.ts
+function useSessionStorage(key, initialValue, options = {}) {
+  return useStorage(key, initialValue, "sessionStorage", options);
+}
+
 // src/hooks/useTheme/useTheme.ts
 import { useEffect as useEffect7, useState as useState4 } from "react";
 var DEFAULT_THEME = "light";
@@ -324,6 +334,8 @@ export {
   useInterval,
   useMediaQuery,
   useOnClickOutside,
+  useStorage,
+  useLocalStorage,
   useSessionStorage,
   DEFAULT_THEME,
   THEME_ATTRIBUTE,
@@ -333,4 +345,4 @@ export {
   useTranslation,
   useWindowSize
 };
-//# sourceMappingURL=chunk-K2YKS4A5.js.map
+//# sourceMappingURL=chunk-AFNJZUOE.js.map

package/dist/chunk-AFNJZUOE.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/hooks/useDownload/useDownload.ts","../src/hooks/useNotificationsStore/useNotificationsStore.ts","../src/hooks/useEventCallback/useEventCallback.ts","../src/hooks/useIsomorphicLayoutEffect/useIsomorphicLayoutEffect.ts","../src/hooks/useEventListener/useEventListener.ts","../src/hooks/useInterval/useInterval.ts","../src/hooks/useMediaQuery/useMediaQuery.ts","../src/hooks/useOnClickOutside/useOnClickOutside.ts","../src/hooks/useStorage/useStorage.ts","../src/hooks/useStorage/useLocalStorage.ts","../src/hooks/useStorage/useSessionStorage.ts","../src/hooks/useTheme/useTheme.ts","../src/hooks/useTranslation/useTranslation.ts","../src/hooks/useWindowSize/useWindowSize.ts"],"sourcesContent":["import { useEffect, useState } from 'react';\n\nimport type { Promisable } from 'type-fest';\n\nimport { useNotificationsStore } from '../useNotificationsStore';\n\ntype DownloadTextOptions = {\n  blobType: 'text/csv' | 'text/plain';\n};\n\ntype DownloadBlobOptions = {\n  blobType: 'application/zip' | 'image/jpeg' | 'image/png' | 'image/webp';\n};\n\n// eslint-disable-next-line @typescript-eslint/consistent-type-definitions\ninterface DownloadFunction {\n  (filename: string, data: Blob, options: DownloadBlobOptions): Promise<void>;\n  (filename: string, data: () => Promisable<Blob>, options: DownloadBlobOptions): Promise<void>;\n  (filename: string, data: string, options?: DownloadTextOptions): Promise<void>;\n  (filename: string, data: () => Promisable<string>, options?: DownloadTextOptions): Promise<void>;\n}\n\n/**\n * Used to trigger downloads of arbitrary data to the client\n * @returns A function to invoke the download\n */\nexport function useDownload(): DownloadFunction {\n  const notifications = useNotificationsStore();\n  const [state, setState] = useState<{\n    blobType: string;\n    data: Blob | string;\n    filename: string;\n  } | null>(null);\n\n  useEffect(() => {\n    if (state) {\n      const { blobType, data, filename } = state;\n      const anchor = document.createElement('a');\n      document.body.appendChild(anchor);\n\n      const blob = new Blob([data], { type: blobType });\n\n      const url = URL.createObjectURL(blob);\n      anchor.href = url;\n      anchor.download = filename;\n      anchor.click();\n      URL.revokeObjectURL(url);\n      anchor.remove();\n      setState(null);\n    }\n  }, [state]);\n\n  return async (filename, _data, options) => {\n    try {\n      const data = typeof _data === 'function' ? await _data() : _data;\n      if (typeof data !== 'string' && !options?.blobType) {\n        throw new Error(\"argument 'blobType' must be defined when download is called with a Blob object\");\n      }\n      setState({ blobType: options?.blobType ?? 'text/plain', data, filename });\n    } catch (error) {\n      const message = error instanceof Error ? error.message : 'An unknown error occurred';\n      notifications.addNotification({\n        message,\n        title: 'Error',\n        type: 'error'\n      });\n    }\n  };\n}\n","import { create } from 'zustand';\n\nexport type NotificationInterface = {\n  id: number;\n  message?: string;\n  title?: string;\n  type: 'error' | 'info' | 'success' | 'warning';\n  variant?: 'critical' | 'standard';\n};\n\nexport type NotificationsStore = {\n  addNotification: (notification: Omit<NotificationInterface, 'id'>) => void;\n  dismissNotification: (id: number) => void;\n  notifications: NotificationInterface[];\n};\n\nexport const useNotificationsStore = create<NotificationsStore>((set) => ({\n  addNotification: (notification) => {\n    set((state) => ({\n      notifications: [...state.notifications, { id: Date.now(), ...notification }]\n    }));\n  },\n  dismissNotification: (id) => {\n    set((state) => ({\n      notifications: state.notifications.filter((notification) => notification.id !== id)\n    }));\n  },\n  notifications: []\n}));\n","import { useCallback, useRef } from 'react';\n\nimport { useIsomorphicLayoutEffect } from '../useIsomorphicLayoutEffect';\n\nexport function useEventCallback<Args extends unknown[], R>(fn: (...args: Args) => R) {\n  const ref = useRef<typeof fn>(() => {\n    throw new Error('Cannot call an event handler while rendering.');\n  });\n\n  useIsomorphicLayoutEffect(() => {\n    ref.current = fn;\n  }, [fn]);\n\n  return useCallback((...args: Args) => ref.current(...args), [ref]);\n}\n","import { useEffect, useLayoutEffect } from 'react';\n\nimport { isBrowser } from '@/utils';\n\nexport const useIsomorphicLayoutEffect = isBrowser() ? useLayoutEffect : useEffect;\n","import { type RefObject, useEffect, useRef } from 'react';\n\nimport { useIsomorphicLayoutEffect } from '../useIsomorphicLayoutEffect';\n\n// MediaQueryList Event based useEventListener interface\nfunction useEventListener<K extends keyof MediaQueryListEventMap>(\n  eventName: K,\n  handler: (event: MediaQueryListEventMap[K]) => void,\n  element: RefObject<MediaQueryList>,\n  options?: AddEventListenerOptions | boolean\n): void;\n\n// Window Event based useEventListener interface\nfunction useEventListener<K extends keyof WindowEventMap>(\n  eventName: K,\n  handler: (event: WindowEventMap[K]) => void,\n  element?: undefined,\n  options?: AddEventListenerOptions | boolean\n): void;\n\n// Element Event based useEventListener interface\nfunction useEventListener<K extends keyof HTMLElementEventMap, T extends HTMLElement = HTMLDivElement>(\n  eventName: K,\n  handler: (event: HTMLElementEventMap[K]) => void,\n  element: RefObject<T>,\n  options?: AddEventListenerOptions | boolean\n): void;\n\n// Document Event based useEventListener interface\nfunction useEventListener<K extends keyof DocumentEventMap>(\n  eventName: K,\n  handler: (event: DocumentEventMap[K]) => void,\n  element: RefObject<Document>,\n  options?: AddEventListenerOptions | boolean\n): void;\n\nfunction useEventListener<\n  KW extends keyof WindowEventMap,\n  KH extends keyof HTMLElementEventMap,\n  KM extends keyof MediaQueryListEventMap,\n  T extends HTMLElement | MediaQueryList | void = void\n>(\n  eventName: KH | KM | KW,\n  handler: (event: Event | HTMLElementEventMap[KH] | MediaQueryListEventMap[KM] | WindowEventMap[KW]) => void,\n  element?: RefObject<T>,\n  options?: AddEventListenerOptions | boolean\n) {\n  // Create a ref that stores handler\n  const savedHandler = useRef(handler);\n\n  useIsomorphicLayoutEffect(() => {\n    savedHandler.current = handler;\n  }, [handler]);\n\n  useEffect(() => {\n    // Define the listening target\n    const targetElement: T | Window = element?.current ?? window;\n\n    if (!(targetElement && targetElement.addEventListener)) return;\n\n    // Create event listener that calls handler function stored in ref\n    const listener: typeof handler = (event) => savedHandler.current(event);\n\n    targetElement.addEventListener(eventName, listener, options);\n\n    // Remove event listener on cleanup\n    return () => {\n      targetElement.removeEventListener(eventName, listener, options);\n    };\n  }, [eventName, element, options]);\n}\n\nexport { useEventListener };\n","import { useEffect, useRef } from 'react';\n\nimport { useIsomorphicLayoutEffect } from '../useIsomorphicLayoutEffect';\n\nexport function useInterval(callback: () => void, delay: null | number) {\n  const savedCallback = useRef(callback);\n\n  // Remember the latest callback if it changes.\n  useIsomorphicLayoutEffect(() => {\n    savedCallback.current = callback;\n  }, [callback]);\n\n  // Set up the interval.\n  useEffect(() => {\n    // Don't schedule if no delay is specified.\n    // Note: 0 is a valid value for delay.\n    if (!delay && delay !== 0) {\n      return;\n    }\n\n    const id = setInterval(() => savedCallback.current(), delay);\n\n    return () => clearInterval(id);\n  }, [delay]);\n}\n","import { useEffect, useState } from 'react';\n\nimport { isBrowser } from '@/utils';\n\n/**\n * Get the result of an arbitrary CSS media query\n *\n * @param query - the CSS media query\n * @returns a boolean indicating the result of the query\n * @example\n * // true if the viewport is at least 768px wide\n * const matches = useMediaQuery('(min-width: 768px)')\n */\nexport function useMediaQuery(query: string): boolean {\n  const getMatches = (query: string): boolean => {\n    // Prevents SSR issues\n    if (isBrowser()) {\n      return window.matchMedia(query).matches;\n    }\n    return false;\n  };\n\n  const [matches, setMatches] = useState<boolean>(getMatches(query));\n\n  function handleChange() {\n    setMatches(getMatches(query));\n  }\n\n  useEffect(() => {\n    const matchMedia = window.matchMedia(query);\n\n    // Triggered at the first client-side load and if query changes\n    handleChange();\n\n    matchMedia.addEventListener('change', handleChange);\n\n    return () => {\n      matchMedia.removeEventListener('change', handleChange);\n    };\n  }, [query]);\n\n  return matches;\n}\n","import { type RefObject } from 'react';\n\nimport { useEventListener } from '../useEventListener';\n\ntype Handler = (event: MouseEvent) => void;\n\nexport function useOnClickOutside<T extends HTMLElement = HTMLElement>(\n  ref: RefObject<T>,\n  handler: Handler,\n  mouseEvent: 'mousedown' | 'mouseup' = 'mousedown'\n): void {\n  useEventListener(mouseEvent, (event) => {\n    const el = ref.current;\n\n    // Do nothing if clicking ref's element or descendent elements\n    if (!el || el.contains(event.target as Node)) {\n      return;\n    }\n\n    handler(event);\n  });\n}\n","import { useCallback, useEffect, useState } from 'react';\nimport type { Dispatch, SetStateAction } from 'react';\n\nimport { isBrowser } from '@/utils';\n\nimport { useEventCallback } from '../useEventCallback';\nimport { useEventListener } from '../useEventListener';\n\ntype StorageName = 'localStorage' | 'sessionStorage';\n\ntype StorageEventMap = {\n  [K in StorageName]: CustomEvent;\n};\n\ndeclare global {\n  // eslint-disable-next-line @typescript-eslint/consistent-type-definitions, @typescript-eslint/no-empty-object-type\n  interface WindowEventMap extends StorageEventMap {}\n}\n\n/**\n * Represents the options for customizing the behavior of serialization and deserialization.\n * @template T - The type of the state to be stored in storage.\n */\ntype UseStorageOptions<T> = {\n  /** A function to deserialize the stored value. */\n  deserializer?: (value: string) => T;\n  /**\n   * If `true` (default), the hook will initialize reading the storage. In SSR, you should set it to `false`, returning the initial value initially.\n   * @default true\n   */\n  initializeWithValue?: boolean;\n  /** A function to serialize the value before storing it. */\n  serializer?: (value: T) => string;\n};\n\n/**\n * Custom hook that uses local or session storage to persist state across page reloads.\n * @template T - The type of the state to be stored in storage.\n * @param key - The key under which the value will be stored in  storage.\n * @param initialValue - The initial value of the state or a function that returns the initial value.\n * @param options - Options for customizing the behavior of serialization and deserialization (optional).\n * @returns A tuple containing the stored value and a function to set the value.\n * @public\n * @example\n * ```tsx\n * const [count, setCount] = useStorage('count', 0);\n * // Access the `count` value and the `setCount` function to update it.\n * ```\n */\nexport function useStorage<T>(\n  key: string,\n  initialValue: (() => T) | T,\n  storageName: StorageName,\n  options: UseStorageOptions<T> = {}\n): [T, Dispatch<SetStateAction<T>>] {\n  const { initializeWithValue = true } = options;\n  const storage = window[storageName];\n\n  const serializer = useCallback<(value: T) => string>(\n    (value) => {\n      if (options.serializer) {\n        return options.serializer(value);\n      }\n      return JSON.stringify(value);\n    },\n    [options]\n  );\n\n  const deserializer = useCallback<(value: string) => T>(\n    (value) => {\n      if (options.deserializer) {\n        return options.deserializer(value);\n      } else if (value === 'undefined') {\n        return undefined as unknown as T;\n      }\n      const defaultValue = initialValue instanceof Function ? initialValue() : initialValue;\n      let parsed: unknown;\n      try {\n        parsed = JSON.parse(value);\n      } catch (err) {\n        console.error(`Error parsing JSON: ${(err as Error).message}`);\n        return defaultValue;\n      }\n      return parsed as T;\n    },\n    [options, initialValue]\n  );\n\n  const readValue = useCallback((): T => {\n    const initialValueToUse = initialValue instanceof Function ? initialValue() : initialValue;\n    if (!isBrowser()) {\n      return initialValueToUse;\n    }\n    const raw = storage.getItem(key);\n    return raw ? deserializer(raw) : initialValueToUse;\n  }, [initialValue, key, deserializer]);\n\n  const [storedValue, setStoredValue] = useState(() => {\n    if (initializeWithValue) {\n      return readValue();\n    }\n    return initialValue instanceof Function ? initialValue() : initialValue;\n  });\n\n  const setValue: Dispatch<SetStateAction<T>> = useEventCallback((value) => {\n    if (!isBrowser()) {\n      console.warn(`Tried setting storage key “${key}” even though environment is not a client`);\n    }\n    try {\n      const newValue = value instanceof Function ? value(readValue()) : value;\n      storage.setItem(key, serializer(newValue));\n      setStoredValue(newValue);\n      window.dispatchEvent(new StorageEvent(storageName, { key }));\n    } catch (error) {\n      console.warn(`Error setting storage key “${key}”:`, error);\n    }\n  });\n\n  useEffect(() => {\n    setStoredValue(readValue());\n  }, [key]);\n\n  const handleStorageChange = useCallback(\n    (event: CustomEvent | StorageEvent) => {\n      if ((event as StorageEvent).key && (event as StorageEvent).key !== key) {\n        return;\n      }\n      setStoredValue(readValue());\n    },\n    [key, readValue]\n  );\n\n  // this only works for other documents, not the current one\n  useEventListener('storage', handleStorageChange);\n\n  useEventListener(storageName, handleStorageChange);\n\n  return [storedValue, setValue];\n}\n\nexport type { StorageName, UseStorageOptions };\n","import type { Dispatch, SetStateAction } from 'react';\n\nimport { useStorage, type UseStorageOptions } from './useStorage';\n\n/** Custom hook that uses local storage to persist state across page reloads */\nexport function useLocalStorage<T>(\n  key: string,\n  initialValue: (() => T) | T,\n  options: UseStorageOptions<T> = {}\n): [T, Dispatch<SetStateAction<T>>] {\n  return useStorage(key, initialValue, 'localStorage', options);\n}\n","import type { Dispatch, SetStateAction } from 'react';\n\nimport { useStorage, type UseStorageOptions } from './useStorage';\n\n/** Custom hook that uses session storage to persist state across page reloads */\nexport function useSessionStorage<T>(\n  key: string,\n  initialValue: (() => T) | T,\n  options: UseStorageOptions<T> = {}\n): [T, Dispatch<SetStateAction<T>>] {\n  return useStorage(key, initialValue, 'sessionStorage', options);\n}\n","import { useEffect, useState } from 'react';\n\n// this is required since our storybook manager plugin cannot use vite aliases\nimport { isBrowser } from '../../utils';\n\ntype Theme = 'dark' | 'light';\n\ntype UpdateTheme = (theme: Theme) => void;\n\n/** @private */\nconst DEFAULT_THEME: Theme = 'light';\n\n/** @private */\nconst THEME_ATTRIBUTE = 'data-mode';\n\n/** @private */\nconst THEME_KEY = 'theme';\n\n/** @private */\nconst SYS_DARK_MEDIA_QUERY = '(prefers-color-scheme: dark)';\n\n/**\n * Returns the current theme and a function to update the current theme\n *\n * The reason the implementation of this hook is rather convoluted is for\n * cases where the theme is updated outside this hook\n */\nfunction useTheme(): readonly [Theme, UpdateTheme] {\n  // Initial theme value is based on the value saved in local storage or the system theme\n  const [theme, setTheme] = useState<Theme>(() => {\n    if (!isBrowser()) {\n      return DEFAULT_THEME;\n    }\n    const savedTheme = window.localStorage.getItem(THEME_KEY);\n    let initialTheme: Theme;\n    if (savedTheme === 'dark' || savedTheme === 'light') {\n      initialTheme = savedTheme;\n    } else {\n      initialTheme = window.matchMedia(SYS_DARK_MEDIA_QUERY).matches ? 'dark' : 'light';\n    }\n    document.documentElement.setAttribute(THEME_ATTRIBUTE, initialTheme);\n    return initialTheme;\n  });\n\n  useEffect(() => {\n    const observer = new MutationObserver((mutations) => {\n      mutations.forEach((mutation) => {\n        if (mutation.attributeName === THEME_ATTRIBUTE) {\n          const updatedTheme = (mutation.target as HTMLHtmlElement).getAttribute(THEME_ATTRIBUTE);\n          if (updatedTheme === 'light' || updatedTheme === 'dark') {\n            window.localStorage.setItem(THEME_KEY, updatedTheme);\n            setTheme(updatedTheme);\n          } else {\n            console.error(`Unexpected value for 'data-mode' attribute: ${updatedTheme}`);\n          }\n        }\n      });\n    });\n    observer.observe(document.documentElement, {\n      attributes: true\n    });\n    return () => observer.disconnect();\n  }, []);\n\n  // When the user wants to change the theme\n  const updateTheme = (theme: Theme) => {\n    document.documentElement.setAttribute(THEME_ATTRIBUTE, theme);\n  };\n\n  return [theme, updateTheme] as const;\n}\n\nexport { DEFAULT_THEME, SYS_DARK_MEDIA_QUERY, type Theme, THEME_ATTRIBUTE, THEME_KEY, useTheme };\n","import { useCallback } from 'react';\n\nimport { useStore } from 'zustand';\n\nimport { translationStore } from '@/i18n';\nimport type { TranslateFunction, TranslationNamespace } from '@/i18n';\nimport { getTranslation } from '@/i18n/internal';\n\nexport function useTranslation<TNamespace extends TranslationNamespace | undefined = undefined>(\n  namespace?: TNamespace\n) {\n  const changeLanguage = useStore(translationStore, (store) => store.changeLanguage);\n  const fallbackLanguage = useStore(translationStore, (store) => store.fallbackLanguage);\n  const resolvedLanguage = useStore(translationStore, (store) => store.resolvedLanguage);\n  const translations = useStore(translationStore, (store) => {\n    if (namespace) {\n      return store.translations[namespace];\n    }\n    return store.translations;\n  });\n\n  const t: TranslateFunction<TNamespace> = useCallback(\n    (target, ...args) => {\n      return getTranslation(target, { fallbackLanguage, resolvedLanguage, translations }, ...args);\n    },\n    [fallbackLanguage, resolvedLanguage, translations]\n  );\n\n  return { changeLanguage, resolvedLanguage, t };\n}\n","import { useState } from 'react';\n\nimport { useEventListener } from '../useEventListener';\nimport { useIsomorphicLayoutEffect } from '../useIsomorphicLayoutEffect';\n\nexport type WindowSize = {\n  height: number;\n  width: number;\n};\n\nexport function useWindowSize(): WindowSize {\n  const [windowSize, setWindowSize] = useState<WindowSize>({\n    height: 0,\n    width: 0\n  });\n\n  const handleSize = () => {\n    setWindowSize({\n      height: window.innerHeight,\n      width: window.innerWidth\n    });\n  };\n\n  useEventListener('resize', handleSize);\n\n  // Set size at the first client-side load\n  useIsomorphicLayoutEffect(() => {\n    handleSize();\n  }, []);\n\n  return windowSize;\n}\n"],"mappings":"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","names":["useEffect","useEffect","useEffect","useRef","useRef","useEffect","useEffect","useRef","useRef","useEffect","useEffect","useState","query","useState","useEffect","useCallback","useEffect","useState","useCallback","useState","useEffect","useEffect","useState","useState","useEffect","theme","useCallback","useCallback","useState","useState"]}

package/dist/components.js

@@ -2,7 +2,7 @@ import {
   useNotificationsStore,
   useTheme,
   useTranslation
-} from "./chunk-K2YKS4A5.js";
+} from "./chunk-AFNJZUOE.js";
 import "./chunk-53GZFQK3.js";
 import {
   cn

package/dist/hooks.d.ts

@@ -60,20 +60,23 @@ declare const useNotificationsStore: zustand.UseBoundStore<zustand.StoreApi<Noti
 type Handler = (event: MouseEvent) => void;
 declare function useOnClickOutside<T extends HTMLElement = HTMLElement>(ref: RefObject<T>, handler: Handler, mouseEvent?: 'mousedown' | 'mouseup'): void;
 
+type StorageName = 'localStorage' | 'sessionStorage';
+type StorageEventMap = {
+    [K in StorageName]: CustomEvent;
+};
 declare global {
-    interface WindowEventMap {
-        'session-storage': CustomEvent;
+    interface WindowEventMap extends StorageEventMap {
     }
 }
 /**
  * Represents the options for customizing the behavior of serialization and deserialization.
- * @template T - The type of the state to be stored in session storage.
+ * @template T - The type of the state to be stored in storage.
  */
-type UseSessionStorageOptions<T> = {
+type UseStorageOptions<T> = {
     /** A function to deserialize the stored value. */
     deserializer?: (value: string) => T;
     /**
-     * If `true` (default), the hook will initialize reading the session storage. In SSR, you should set it to `false`, returning the initial value initially.
+     * If `true` (default), the hook will initialize reading the storage. In SSR, you should set it to `false`, returning the initial value initially.
      * @default true
      */
     initializeWithValue?: boolean;
@@ -81,20 +84,26 @@ type UseSessionStorageOptions<T> = {
     serializer?: (value: T) => string;
 };
 /**
- * Custom hook that uses session storage to persist state across page reloads.
- * @template T - The type of the state to be stored in session storage.
- * @param {string} key - The key under which the value will be stored in session storage.
- * @param {T | (() => T)} initialValue - The initial value of the state or a function that returns the initial value.
- * @param {?UseSessionStorageOptions<T>} [options] - Options for customizing the behavior of serialization and deserialization (optional).
- * @returns {[T, Dispatch<SetStateAction<T>>]} A tuple containing the stored value and a function to set the value.
+ * Custom hook that uses local or session storage to persist state across page reloads.
+ * @template T - The type of the state to be stored in storage.
+ * @param key - The key under which the value will be stored in  storage.
+ * @param initialValue - The initial value of the state or a function that returns the initial value.
+ * @param options - Options for customizing the behavior of serialization and deserialization (optional).
+ * @returns A tuple containing the stored value and a function to set the value.
  * @public
  * @example
  * ```tsx
- * const [count, setCount] = useSessionStorage('count', 0);
+ * const [count, setCount] = useStorage('count', 0);
  * // Access the `count` value and the `setCount` function to update it.
  * ```
  */
-declare function useSessionStorage<T>(key: string, initialValue: (() => T) | T, options?: UseSessionStorageOptions<T>): [T, Dispatch<SetStateAction<T>>];
+declare function useStorage<T>(key: string, initialValue: (() => T) | T, storageName: StorageName, options?: UseStorageOptions<T>): [T, Dispatch<SetStateAction<T>>];
+
+/** Custom hook that uses local storage to persist state across page reloads */
+declare function useLocalStorage<T>(key: string, initialValue: (() => T) | T, options?: UseStorageOptions<T>): [T, Dispatch<SetStateAction<T>>];
+
+/** Custom hook that uses session storage to persist state across page reloads */
+declare function useSessionStorage<T>(key: string, initialValue: (() => T) | T, options?: UseStorageOptions<T>): [T, Dispatch<SetStateAction<T>>];
 
 type Theme = 'dark' | 'light';
 type UpdateTheme = (theme: Theme) => void;
@@ -126,4 +135,4 @@ type WindowSize = {
 };
 declare function useWindowSize(): WindowSize;
 
-export { DEFAULT_THEME, type NotificationInterface, type NotificationsStore, SYS_DARK_MEDIA_QUERY, THEME_ATTRIBUTE, THEME_KEY, type Theme, type WindowSize, useDownload, useEventCallback, useEventListener, useInterval, useIsomorphicLayoutEffect, useMediaQuery, useNotificationsStore, useOnClickOutside, useSessionStorage, useTheme, useTranslation, useWindowSize };
+export { DEFAULT_THEME, type NotificationInterface, type NotificationsStore, SYS_DARK_MEDIA_QUERY, type StorageName, THEME_ATTRIBUTE, THEME_KEY, type Theme, type UseStorageOptions, type WindowSize, useDownload, useEventCallback, useEventListener, useInterval, useIsomorphicLayoutEffect, useLocalStorage, useMediaQuery, useNotificationsStore, useOnClickOutside, useSessionStorage, useStorage, useTheme, useTranslation, useWindowSize };

package/dist/hooks.js

@@ -8,14 +8,16 @@ import {
   useEventListener,
   useInterval,
   useIsomorphicLayoutEffect,
+  useLocalStorage,
   useMediaQuery,
   useNotificationsStore,
   useOnClickOutside,
   useSessionStorage,
+  useStorage,
   useTheme,
   useTranslation,
   useWindowSize
-} from "./chunk-K2YKS4A5.js";
+} from "./chunk-AFNJZUOE.js";
 import "./chunk-53GZFQK3.js";
 import "./chunk-IX6RFIQL.js";
 export {
@@ -28,10 +30,12 @@ export {
   useEventListener,
   useInterval,
   useIsomorphicLayoutEffect,
+  useLocalStorage,
   useMediaQuery,
   useNotificationsStore,
   useOnClickOutside,
   useSessionStorage,
+  useStorage,
   useTheme,
   useTranslation,
   useWindowSize

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@douglasneuroinformatics/libui",
   "type": "module",
-  "version": "3.1.5",
+  "version": "3.2.0",
   "packageManager": "pnpm@9.3.0",
   "description": "Generic UI components for DNP projects, built using React and Tailwind CSS",
   "author": "Joshua Unrau",

package/src/hooks/index.ts

@@ -6,7 +6,7 @@ export * from './useIsomorphicLayoutEffect';
 export * from './useMediaQuery';
 export * from './useNotificationsStore';
 export * from './useOnClickOutside';
-export * from './useSessionStorage';
+export * from './useStorage';
 export * from './useTheme';
 export * from './useTranslation';
 export * from './useWindowSize';

package/src/hooks/useStorage/index.ts

@@ -0,0 +1,3 @@
+export * from './useLocalStorage.ts';
+export * from './useSessionStorage.ts';
+export * from './useStorage.ts';

package/src/hooks/useStorage/useLocalStorage.test.ts

@@ -0,0 +1,16 @@
+import { renderHook } from '@testing-library/react';
+import { describe, it, vi } from 'vitest';
+
+import { mockStorage } from '@/testing/mocks';
+
+import { useLocalStorage } from './useLocalStorage';
+
+mockStorage('localStorage');
+
+vi.mock('@/utils', () => ({ isBrowser: vi.fn(() => true) }));
+
+describe('useLocalStorage()', () => {
+  it('should render', () => {
+    renderHook(() => useLocalStorage('key', 'value'));
+  });
+});

package/src/hooks/useStorage/useLocalStorage.ts

@@ -0,0 +1,12 @@
+import type { Dispatch, SetStateAction } from 'react';
+
+import { useStorage, type UseStorageOptions } from './useStorage';
+
+/** Custom hook that uses local storage to persist state across page reloads */
+export function useLocalStorage<T>(
+  key: string,
+  initialValue: (() => T) | T,
+  options: UseStorageOptions<T> = {}
+): [T, Dispatch<SetStateAction<T>>] {
+  return useStorage(key, initialValue, 'localStorage', options);
+}

package/src/hooks/useStorage/useSessionStorage.test.ts

@@ -0,0 +1,16 @@
+import { renderHook } from '@testing-library/react';
+import { describe, it, vi } from 'vitest';
+
+import { mockStorage } from '@/testing/mocks';
+
+import { useSessionStorage } from './useSessionStorage';
+
+mockStorage('sessionStorage');
+
+vi.mock('@/utils', () => ({ isBrowser: vi.fn(() => true) }));
+
+describe('useSessionStorage()', () => {
+  it('should render', () => {
+    renderHook(() => useSessionStorage('key', 'value'));
+  });
+});

package/src/hooks/useStorage/useSessionStorage.ts

@@ -0,0 +1,12 @@
+import type { Dispatch, SetStateAction } from 'react';
+
+import { useStorage, type UseStorageOptions } from './useStorage';
+
+/** Custom hook that uses session storage to persist state across page reloads */
+export function useSessionStorage<T>(
+  key: string,
+  initialValue: (() => T) | T,
+  options: UseStorageOptions<T> = {}
+): [T, Dispatch<SetStateAction<T>>] {
+  return useStorage(key, initialValue, 'sessionStorage', options);
+}

package/src/hooks/useStorage/useStorage.test.ts

@@ -0,0 +1,193 @@
+import { act, renderHook } from '@testing-library/react';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+
+import { mockStorage } from '@/testing/mocks';
+import { isBrowser } from '@/utils';
+
+import { useStorage } from './useStorage';
+
+import type { StorageName } from './useStorage';
+
+const storages: StorageName[] = ['localStorage', 'sessionStorage'];
+storages.forEach(mockStorage);
+
+vi.mock('@/utils', () => ({ isBrowser: vi.fn(() => true) }));
+
+describe('useStorage()', () => {
+  storages.forEach((storageName) => {
+    const storage = window[storageName];
+
+    beforeEach(() => {
+      window[storageName].clear();
+    });
+
+    afterEach(() => {
+      vi.restoreAllMocks();
+    });
+    it('should return the initial state if running on the server', () => {
+      vi.mocked(isBrowser).mockReturnValue(false);
+      const { result } = renderHook(() => useStorage('key', 'value', storageName));
+      expect(result.current[0]).toBe('value');
+    });
+
+    it('should return the initial state if using a string', () => {
+      const { result } = renderHook(() => useStorage('key', 'value', storageName));
+      expect(result.current[0]).toBe('value');
+    });
+
+    it('return the initial state return if using a callback function', () => {
+      const { result } = renderHook(() => useStorage('key', () => 'value', storageName));
+      expect(result.current[0]).toBe('value');
+    });
+
+    it('return the initial state if using a string', () => {
+      const { result } = renderHook(() => useStorage('digits', [1, 2], storageName));
+      expect(result.current[0]).toEqual([1, 2]);
+    });
+
+    it('return the initial state if it is a map', () => {
+      const { result } = renderHook(() => useStorage('map', new Map([['a', 1]]), storageName));
+      expect(result.current[0]).toEqual(new Map([['a', 1]]));
+    });
+
+    it('return the initial state if it is a set', () => {
+      const { result } = renderHook(() => useStorage('set', new Set([1, 2]), storageName));
+      expect(result.current[0]).toEqual(new Set([1, 2]));
+    });
+
+    it('return the initial state if it is a date', () => {
+      const { result } = renderHook(() => useStorage('date', new Date(2020, 1, 1), storageName));
+      expect(result.current[0]).toEqual(new Date(2020, 1, 1));
+    });
+
+    it('should update the state and write to session storage', () => {
+      const { result } = renderHook(() => useStorage('key', 'value', storageName));
+      act(() => {
+        const setState = result.current[1];
+        setState('edited');
+      });
+      expect(result.current[0]).toBe('edited');
+      expect(storage.getItem('key')).toBe(JSON.stringify('edited'));
+    });
+
+    it('should update the state with undefined', () => {
+      const { result } = renderHook(() => useStorage<string | undefined>('keytest', 'value', storageName));
+      act(() => {
+        const setState = result.current[1];
+        setState(undefined);
+      });
+      expect(result.current[0]).toBeUndefined();
+    });
+
+    it('should update the state with a callback function', () => {
+      const { result } = renderHook(() => useStorage('count', 2, storageName));
+      act(() => {
+        const setState = result.current[1];
+        setState((prev) => prev + 1);
+      });
+      expect(result.current[0]).toBe(3);
+      expect(storage.getItem('count')).toEqual('3');
+    });
+
+    it('should update the state with a callback function multiple times per render', () => {
+      const { result } = renderHook(() => useStorage('count', 2, storageName));
+      act(() => {
+        const setState = result.current[1];
+        setState((prev) => prev + 1);
+        setState((prev) => prev + 1);
+        setState((prev) => prev + 1);
+      });
+      expect(result.current[0]).toBe(5);
+      expect(storage.getItem('count')).toEqual('5');
+    });
+
+    it('should update if another hook updates the same key', () => {
+      const initialValues: [string, unknown] = ['key', 'initial'];
+      const { result: A } = renderHook(() => useStorage(...initialValues, storageName));
+      const { result: B } = renderHook(() => useStorage(...initialValues, storageName));
+      const { result: C } = renderHook(() => useStorage('other-key', 'initial', storageName));
+
+      act(() => {
+        const setState = A.current[1];
+        setState('edited');
+      });
+
+      expect(B.current[0]).toBe('edited');
+      expect(C.current[0]).toBe('initial');
+    });
+
+    it('should not update if another hook updates a different key', () => {
+      let renderCount = 0;
+      const { result: A } = renderHook(() => {
+        renderCount++;
+        return useStorage('key1', {}, storageName);
+      });
+      const { result: B } = renderHook(() => useStorage('key2', 'initial', storageName));
+      expect(renderCount).toBe(1);
+      act(() => {
+        const setStateA = A.current[1];
+        setStateA({ a: 1 });
+      });
+      expect(renderCount).toBe(2);
+      act(() => {
+        const setStateB = B.current[1];
+        setStateB('edited');
+      });
+      expect(renderCount).toBe(2);
+    });
+
+    it('should return a referentially stable setter', () => {
+      const { result } = renderHook(() => useStorage('count', 1, storageName));
+      const originalCallback = result.current[1];
+      act(() => {
+        const setState = result.current[1];
+        setState((prev) => prev + 1);
+      });
+      expect(result.current[1] === originalCallback).toBe(true);
+    });
+
+    it('should use the default JSON.stringify and JSON.parse when serializer/deserializer are not provided', () => {
+      const { result } = renderHook(() => useStorage('key', 'initialValue', storageName));
+      act(() => {
+        result.current[1]('newValue');
+      });
+      expect(storage.getItem('key')).toBe(JSON.stringify('newValue'));
+    });
+
+    it('should write to stderr and set the store to the initial value if the stored value in not serializable', () => {
+      vi.spyOn(console, 'error');
+      storage.setItem('key', '{{ x: foo }}');
+      renderHook(() => useStorage('key', 'initialValue', storageName));
+      expect(console.error).toHaveBeenLastCalledWith(expect.stringContaining('Error parsing JSON'));
+    });
+
+    it('should use a custom serializer and deserializer when provided', () => {
+      const serializer = (value: string) => value.toUpperCase();
+      const deserializer = (value: string) => value.toLowerCase();
+      const { result } = renderHook(() => useStorage('key', 'initialValue', storageName, { deserializer, serializer }));
+      act(() => {
+        result.current[1]('NewValue');
+      });
+      expect(storage.getItem('key')).toBe('NEWVALUE');
+    });
+
+    it('should handle undefined values with custom deserializer', () => {
+      const serializer = (value: number | undefined) => String(value);
+      const deserializer = (value: string) => (value === 'undefined' ? undefined : Number(value));
+      const { result } = renderHook(() =>
+        useStorage<number | undefined>('key', 0, storageName, {
+          deserializer,
+          serializer
+        })
+      );
+      act(() => {
+        result.current[1](undefined);
+      });
+      expect(storage.getItem('key')).toBe('undefined');
+      act(() => {
+        result.current[1](42);
+      });
+      expect(storage.getItem('key')).toBe('42');
+    });
+  });
+});

package/src/hooks/{useSessionStorage/useSessionStorage.ts → useStorage/useStorage.ts}

@@ -6,22 +6,26 @@ import { isBrowser } from '@/utils';
 import { useEventCallback } from '../useEventCallback';
 import { useEventListener } from '../useEventListener';
 
+type StorageName = 'localStorage' | 'sessionStorage';
+
+type StorageEventMap = {
+  [K in StorageName]: CustomEvent;
+};
+
 declare global {
-  // eslint-disable-next-line @typescript-eslint/consistent-type-definitions
-  interface WindowEventMap {
-    'session-storage': CustomEvent;
-  }
+  // eslint-disable-next-line @typescript-eslint/consistent-type-definitions, @typescript-eslint/no-empty-object-type
+  interface WindowEventMap extends StorageEventMap {}
 }
 
 /**
  * Represents the options for customizing the behavior of serialization and deserialization.
- * @template T - The type of the state to be stored in session storage.
+ * @template T - The type of the state to be stored in storage.
  */
-type UseSessionStorageOptions<T> = {
+type UseStorageOptions<T> = {
   /** A function to deserialize the stored value. */
   deserializer?: (value: string) => T;
   /**
-   * If `true` (default), the hook will initialize reading the session storage. In SSR, you should set it to `false`, returning the initial value initially.
+   * If `true` (default), the hook will initialize reading the storage. In SSR, you should set it to `false`, returning the initial value initially.
    * @default true
    */
   initializeWithValue?: boolean;
@@ -30,25 +34,27 @@ type UseSessionStorageOptions<T> = {
 };
 
 /**
- * Custom hook that uses session storage to persist state across page reloads.
- * @template T - The type of the state to be stored in session storage.
- * @param {string} key - The key under which the value will be stored in session storage.
- * @param {T | (() => T)} initialValue - The initial value of the state or a function that returns the initial value.
- * @param {?UseSessionStorageOptions<T>} [options] - Options for customizing the behavior of serialization and deserialization (optional).
- * @returns {[T, Dispatch<SetStateAction<T>>]} A tuple containing the stored value and a function to set the value.
+ * Custom hook that uses local or session storage to persist state across page reloads.
+ * @template T - The type of the state to be stored in storage.
+ * @param key - The key under which the value will be stored in  storage.
+ * @param initialValue - The initial value of the state or a function that returns the initial value.
+ * @param options - Options for customizing the behavior of serialization and deserialization (optional).
+ * @returns A tuple containing the stored value and a function to set the value.
  * @public
  * @example
  * ```tsx
- * const [count, setCount] = useSessionStorage('count', 0);
+ * const [count, setCount] = useStorage('count', 0);
  * // Access the `count` value and the `setCount` function to update it.
  * ```
  */
-export function useSessionStorage<T>(
+export function useStorage<T>(
   key: string,
   initialValue: (() => T) | T,
-  options: UseSessionStorageOptions<T> = {}
+  storageName: StorageName,
+  options: UseStorageOptions<T> = {}
 ): [T, Dispatch<SetStateAction<T>>] {
   const { initializeWithValue = true } = options;
+  const storage = window[storageName];
 
   const serializer = useCallback<(value: T) => string>(
     (value) => {
@@ -64,14 +70,10 @@ export function useSessionStorage<T>(
     (value) => {
       if (options.deserializer) {
         return options.deserializer(value);
-      }
-      // Support 'undefined' as a value
-      if (value === 'undefined') {
+      } else if (value === 'undefined') {
         return undefined as unknown as T;
       }
-
       const defaultValue = initialValue instanceof Function ? initialValue() : initialValue;
-
       let parsed: unknown;
       try {
         parsed = JSON.parse(value);
@@ -79,22 +81,17 @@ export function useSessionStorage<T>(
         console.error(`Error parsing JSON: ${(err as Error).message}`);
         return defaultValue;
       }
-
       return parsed as T;
     },
     [options, initialValue]
   );
 
-  // Get from session storage then
-  // parse stored json or return initialValue
   const readValue = useCallback((): T => {
     const initialValueToUse = initialValue instanceof Function ? initialValue() : initialValue;
-
-    // Prevent build error "window is undefined" but keep keep working
     if (!isBrowser()) {
       return initialValueToUse;
     }
-    const raw = window.sessionStorage.getItem(key);
+    const raw = storage.getItem(key);
     return raw ? deserializer(raw) : initialValueToUse;
   }, [initialValue, key, deserializer]);
 
@@ -102,32 +99,20 @@ export function useSessionStorage<T>(
     if (initializeWithValue) {
       return readValue();
     }
-
     return initialValue instanceof Function ? initialValue() : initialValue;
   });
 
-  // Return a wrapped version of useState's setter function that ...
-  // ... persists the new value to sessionStorage.
   const setValue: Dispatch<SetStateAction<T>> = useEventCallback((value) => {
-    // Prevent build error "window is undefined" but keeps working
     if (!isBrowser()) {
-      console.warn(`Tried setting sessionStorage key “${key}” even though environment is not a client`);
+      console.warn(`Tried setting storage key “${key}” even though environment is not a client`);
     }
-
     try {
-      // Allow value to be a function so we have the same API as useState
       const newValue = value instanceof Function ? value(readValue()) : value;
-
-      // Save to session storage
-      window.sessionStorage.setItem(key, serializer(newValue));
-
-      // Save state
+      storage.setItem(key, serializer(newValue));
       setStoredValue(newValue);
-
-      // We dispatch a custom event so every similar useSessionStorage hook is notified
-      window.dispatchEvent(new StorageEvent('session-storage', { key }));
+      window.dispatchEvent(new StorageEvent(storageName, { key }));
     } catch (error) {
-      console.warn(`Error setting sessionStorage key “${key}”:`, error);
+      console.warn(`Error setting storage key “${key}”:`, error);
     }
   });
 
@@ -148,9 +133,9 @@ export function useSessionStorage<T>(
   // this only works for other documents, not the current one
   useEventListener('storage', handleStorageChange);
 
-  // this is a custom event, triggered in writeValueToSessionStorage
-  // See: useSessionStorage()
-  useEventListener('session-storage', handleStorageChange);
+  useEventListener(storageName, handleStorageChange);
 
   return [storedValue, setValue];
 }
+
+export type { StorageName, UseStorageOptions };

package/src/testing/mocks.ts

@@ -1,6 +1,8 @@
 import { faker } from '@faker-js/faker';
 import { vi } from 'vitest';
 
+import type { StorageName } from '@/hooks';
+
 /**
  * Mocks the matchMedia API
  * @param {boolean} matches - whether the media query matches
@@ -22,12 +24,9 @@ export const mockMatchMedia = (matches: ((query: string) => boolean) | boolean):
 
 /**
  * Mocks the Storage API
- * @param {'localStorage' | 'sessionStorage'} name - The name of the storage to mock
- * @example
- * mockStorage('localStorage')
- * // Then use window.localStorage as usual (it will be mocked)
+ * @param name - The name of the storage to mock
  */
-export const mockStorage = (name: 'localStorage' | 'sessionStorage'): void => {
+export const mockStorage = (name: StorageName): void => {
   class StorageMock implements Omit<Storage, 'key' | 'length'> {
     store: { [key: string]: string } = {};
 

package/dist/chunk-K2YKS4A5.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/hooks/useDownload/useDownload.ts","../src/hooks/useNotificationsStore/useNotificationsStore.ts","../src/hooks/useEventCallback/useEventCallback.ts","../src/hooks/useIsomorphicLayoutEffect/useIsomorphicLayoutEffect.ts","../src/hooks/useEventListener/useEventListener.ts","../src/hooks/useInterval/useInterval.ts","../src/hooks/useMediaQuery/useMediaQuery.ts","../src/hooks/useOnClickOutside/useOnClickOutside.ts","../src/hooks/useSessionStorage/useSessionStorage.ts","../src/hooks/useTheme/useTheme.ts","../src/hooks/useTranslation/useTranslation.ts","../src/hooks/useWindowSize/useWindowSize.ts"],"sourcesContent":["import { useEffect, useState } from 'react';\n\nimport type { Promisable } from 'type-fest';\n\nimport { useNotificationsStore } from '../useNotificationsStore';\n\ntype DownloadTextOptions = {\n  blobType: 'text/csv' | 'text/plain';\n};\n\ntype DownloadBlobOptions = {\n  blobType: 'application/zip' | 'image/jpeg' | 'image/png' | 'image/webp';\n};\n\n// eslint-disable-next-line @typescript-eslint/consistent-type-definitions\ninterface DownloadFunction {\n  (filename: string, data: Blob, options: DownloadBlobOptions): Promise<void>;\n  (filename: string, data: () => Promisable<Blob>, options: DownloadBlobOptions): Promise<void>;\n  (filename: string, data: string, options?: DownloadTextOptions): Promise<void>;\n  (filename: string, data: () => Promisable<string>, options?: DownloadTextOptions): Promise<void>;\n}\n\n/**\n * Used to trigger downloads of arbitrary data to the client\n * @returns A function to invoke the download\n */\nexport function useDownload(): DownloadFunction {\n  const notifications = useNotificationsStore();\n  const [state, setState] = useState<{\n    blobType: string;\n    data: Blob | string;\n    filename: string;\n  } | null>(null);\n\n  useEffect(() => {\n    if (state) {\n      const { blobType, data, filename } = state;\n      const anchor = document.createElement('a');\n      document.body.appendChild(anchor);\n\n      const blob = new Blob([data], { type: blobType });\n\n      const url = URL.createObjectURL(blob);\n      anchor.href = url;\n      anchor.download = filename;\n      anchor.click();\n      URL.revokeObjectURL(url);\n      anchor.remove();\n      setState(null);\n    }\n  }, [state]);\n\n  return async (filename, _data, options) => {\n    try {\n      const data = typeof _data === 'function' ? await _data() : _data;\n      if (typeof data !== 'string' && !options?.blobType) {\n        throw new Error(\"argument 'blobType' must be defined when download is called with a Blob object\");\n      }\n      setState({ blobType: options?.blobType ?? 'text/plain', data, filename });\n    } catch (error) {\n      const message = error instanceof Error ? error.message : 'An unknown error occurred';\n      notifications.addNotification({\n        message,\n        title: 'Error',\n        type: 'error'\n      });\n    }\n  };\n}\n","import { create } from 'zustand';\n\nexport type NotificationInterface = {\n  id: number;\n  message?: string;\n  title?: string;\n  type: 'error' | 'info' | 'success' | 'warning';\n  variant?: 'critical' | 'standard';\n};\n\nexport type NotificationsStore = {\n  addNotification: (notification: Omit<NotificationInterface, 'id'>) => void;\n  dismissNotification: (id: number) => void;\n  notifications: NotificationInterface[];\n};\n\nexport const useNotificationsStore = create<NotificationsStore>((set) => ({\n  addNotification: (notification) => {\n    set((state) => ({\n      notifications: [...state.notifications, { id: Date.now(), ...notification }]\n    }));\n  },\n  dismissNotification: (id) => {\n    set((state) => ({\n      notifications: state.notifications.filter((notification) => notification.id !== id)\n    }));\n  },\n  notifications: []\n}));\n","import { useCallback, useRef } from 'react';\n\nimport { useIsomorphicLayoutEffect } from '../useIsomorphicLayoutEffect';\n\nexport function useEventCallback<Args extends unknown[], R>(fn: (...args: Args) => R) {\n  const ref = useRef<typeof fn>(() => {\n    throw new Error('Cannot call an event handler while rendering.');\n  });\n\n  useIsomorphicLayoutEffect(() => {\n    ref.current = fn;\n  }, [fn]);\n\n  return useCallback((...args: Args) => ref.current(...args), [ref]);\n}\n","import { useEffect, useLayoutEffect } from 'react';\n\nimport { isBrowser } from '@/utils';\n\nexport const useIsomorphicLayoutEffect = isBrowser() ? useLayoutEffect : useEffect;\n","import { type RefObject, useEffect, useRef } from 'react';\n\nimport { useIsomorphicLayoutEffect } from '../useIsomorphicLayoutEffect';\n\n// MediaQueryList Event based useEventListener interface\nfunction useEventListener<K extends keyof MediaQueryListEventMap>(\n  eventName: K,\n  handler: (event: MediaQueryListEventMap[K]) => void,\n  element: RefObject<MediaQueryList>,\n  options?: AddEventListenerOptions | boolean\n): void;\n\n// Window Event based useEventListener interface\nfunction useEventListener<K extends keyof WindowEventMap>(\n  eventName: K,\n  handler: (event: WindowEventMap[K]) => void,\n  element?: undefined,\n  options?: AddEventListenerOptions | boolean\n): void;\n\n// Element Event based useEventListener interface\nfunction useEventListener<K extends keyof HTMLElementEventMap, T extends HTMLElement = HTMLDivElement>(\n  eventName: K,\n  handler: (event: HTMLElementEventMap[K]) => void,\n  element: RefObject<T>,\n  options?: AddEventListenerOptions | boolean\n): void;\n\n// Document Event based useEventListener interface\nfunction useEventListener<K extends keyof DocumentEventMap>(\n  eventName: K,\n  handler: (event: DocumentEventMap[K]) => void,\n  element: RefObject<Document>,\n  options?: AddEventListenerOptions | boolean\n): void;\n\nfunction useEventListener<\n  KW extends keyof WindowEventMap,\n  KH extends keyof HTMLElementEventMap,\n  KM extends keyof MediaQueryListEventMap,\n  T extends HTMLElement | MediaQueryList | void = void\n>(\n  eventName: KH | KM | KW,\n  handler: (event: Event | HTMLElementEventMap[KH] | MediaQueryListEventMap[KM] | WindowEventMap[KW]) => void,\n  element?: RefObject<T>,\n  options?: AddEventListenerOptions | boolean\n) {\n  // Create a ref that stores handler\n  const savedHandler = useRef(handler);\n\n  useIsomorphicLayoutEffect(() => {\n    savedHandler.current = handler;\n  }, [handler]);\n\n  useEffect(() => {\n    // Define the listening target\n    const targetElement: T | Window = element?.current ?? window;\n\n    if (!(targetElement && targetElement.addEventListener)) return;\n\n    // Create event listener that calls handler function stored in ref\n    const listener: typeof handler = (event) => savedHandler.current(event);\n\n    targetElement.addEventListener(eventName, listener, options);\n\n    // Remove event listener on cleanup\n    return () => {\n      targetElement.removeEventListener(eventName, listener, options);\n    };\n  }, [eventName, element, options]);\n}\n\nexport { useEventListener };\n","import { useEffect, useRef } from 'react';\n\nimport { useIsomorphicLayoutEffect } from '../useIsomorphicLayoutEffect';\n\nexport function useInterval(callback: () => void, delay: null | number) {\n  const savedCallback = useRef(callback);\n\n  // Remember the latest callback if it changes.\n  useIsomorphicLayoutEffect(() => {\n    savedCallback.current = callback;\n  }, [callback]);\n\n  // Set up the interval.\n  useEffect(() => {\n    // Don't schedule if no delay is specified.\n    // Note: 0 is a valid value for delay.\n    if (!delay && delay !== 0) {\n      return;\n    }\n\n    const id = setInterval(() => savedCallback.current(), delay);\n\n    return () => clearInterval(id);\n  }, [delay]);\n}\n","import { useEffect, useState } from 'react';\n\nimport { isBrowser } from '@/utils';\n\n/**\n * Get the result of an arbitrary CSS media query\n *\n * @param query - the CSS media query\n * @returns a boolean indicating the result of the query\n * @example\n * // true if the viewport is at least 768px wide\n * const matches = useMediaQuery('(min-width: 768px)')\n */\nexport function useMediaQuery(query: string): boolean {\n  const getMatches = (query: string): boolean => {\n    // Prevents SSR issues\n    if (isBrowser()) {\n      return window.matchMedia(query).matches;\n    }\n    return false;\n  };\n\n  const [matches, setMatches] = useState<boolean>(getMatches(query));\n\n  function handleChange() {\n    setMatches(getMatches(query));\n  }\n\n  useEffect(() => {\n    const matchMedia = window.matchMedia(query);\n\n    // Triggered at the first client-side load and if query changes\n    handleChange();\n\n    matchMedia.addEventListener('change', handleChange);\n\n    return () => {\n      matchMedia.removeEventListener('change', handleChange);\n    };\n  }, [query]);\n\n  return matches;\n}\n","import { type RefObject } from 'react';\n\nimport { useEventListener } from '../useEventListener';\n\ntype Handler = (event: MouseEvent) => void;\n\nexport function useOnClickOutside<T extends HTMLElement = HTMLElement>(\n  ref: RefObject<T>,\n  handler: Handler,\n  mouseEvent: 'mousedown' | 'mouseup' = 'mousedown'\n): void {\n  useEventListener(mouseEvent, (event) => {\n    const el = ref.current;\n\n    // Do nothing if clicking ref's element or descendent elements\n    if (!el || el.contains(event.target as Node)) {\n      return;\n    }\n\n    handler(event);\n  });\n}\n","import { useCallback, useEffect, useState } from 'react';\nimport type { Dispatch, SetStateAction } from 'react';\n\nimport { isBrowser } from '@/utils';\n\nimport { useEventCallback } from '../useEventCallback';\nimport { useEventListener } from '../useEventListener';\n\ndeclare global {\n  // eslint-disable-next-line @typescript-eslint/consistent-type-definitions\n  interface WindowEventMap {\n    'session-storage': CustomEvent;\n  }\n}\n\n/**\n * Represents the options for customizing the behavior of serialization and deserialization.\n * @template T - The type of the state to be stored in session storage.\n */\ntype UseSessionStorageOptions<T> = {\n  /** A function to deserialize the stored value. */\n  deserializer?: (value: string) => T;\n  /**\n   * If `true` (default), the hook will initialize reading the session storage. In SSR, you should set it to `false`, returning the initial value initially.\n   * @default true\n   */\n  initializeWithValue?: boolean;\n  /** A function to serialize the value before storing it. */\n  serializer?: (value: T) => string;\n};\n\n/**\n * Custom hook that uses session storage to persist state across page reloads.\n * @template T - The type of the state to be stored in session storage.\n * @param {string} key - The key under which the value will be stored in session storage.\n * @param {T | (() => T)} initialValue - The initial value of the state or a function that returns the initial value.\n * @param {?UseSessionStorageOptions<T>} [options] - Options for customizing the behavior of serialization and deserialization (optional).\n * @returns {[T, Dispatch<SetStateAction<T>>]} A tuple containing the stored value and a function to set the value.\n * @public\n * @example\n * ```tsx\n * const [count, setCount] = useSessionStorage('count', 0);\n * // Access the `count` value and the `setCount` function to update it.\n * ```\n */\nexport function useSessionStorage<T>(\n  key: string,\n  initialValue: (() => T) | T,\n  options: UseSessionStorageOptions<T> = {}\n): [T, Dispatch<SetStateAction<T>>] {\n  const { initializeWithValue = true } = options;\n\n  const serializer = useCallback<(value: T) => string>(\n    (value) => {\n      if (options.serializer) {\n        return options.serializer(value);\n      }\n      return JSON.stringify(value);\n    },\n    [options]\n  );\n\n  const deserializer = useCallback<(value: string) => T>(\n    (value) => {\n      if (options.deserializer) {\n        return options.deserializer(value);\n      }\n      // Support 'undefined' as a value\n      if (value === 'undefined') {\n        return undefined as unknown as T;\n      }\n\n      const defaultValue = initialValue instanceof Function ? initialValue() : initialValue;\n\n      let parsed: unknown;\n      try {\n        parsed = JSON.parse(value);\n      } catch (err) {\n        console.error(`Error parsing JSON: ${(err as Error).message}`);\n        return defaultValue;\n      }\n\n      return parsed as T;\n    },\n    [options, initialValue]\n  );\n\n  // Get from session storage then\n  // parse stored json or return initialValue\n  const readValue = useCallback((): T => {\n    const initialValueToUse = initialValue instanceof Function ? initialValue() : initialValue;\n\n    // Prevent build error \"window is undefined\" but keep keep working\n    if (!isBrowser()) {\n      return initialValueToUse;\n    }\n    const raw = window.sessionStorage.getItem(key);\n    return raw ? deserializer(raw) : initialValueToUse;\n  }, [initialValue, key, deserializer]);\n\n  const [storedValue, setStoredValue] = useState(() => {\n    if (initializeWithValue) {\n      return readValue();\n    }\n\n    return initialValue instanceof Function ? initialValue() : initialValue;\n  });\n\n  // Return a wrapped version of useState's setter function that ...\n  // ... persists the new value to sessionStorage.\n  const setValue: Dispatch<SetStateAction<T>> = useEventCallback((value) => {\n    // Prevent build error \"window is undefined\" but keeps working\n    if (!isBrowser()) {\n      console.warn(`Tried setting sessionStorage key “${key}” even though environment is not a client`);\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(readValue()) : value;\n\n      // Save to session storage\n      window.sessionStorage.setItem(key, serializer(newValue));\n\n      // Save state\n      setStoredValue(newValue);\n\n      // We dispatch a custom event so every similar useSessionStorage hook is notified\n      window.dispatchEvent(new StorageEvent('session-storage', { key }));\n    } catch (error) {\n      console.warn(`Error setting sessionStorage key “${key}”:`, error);\n    }\n  });\n\n  useEffect(() => {\n    setStoredValue(readValue());\n  }, [key]);\n\n  const handleStorageChange = useCallback(\n    (event: CustomEvent | StorageEvent) => {\n      if ((event as StorageEvent).key && (event as StorageEvent).key !== key) {\n        return;\n      }\n      setStoredValue(readValue());\n    },\n    [key, readValue]\n  );\n\n  // this only works for other documents, not the current one\n  useEventListener('storage', handleStorageChange);\n\n  // this is a custom event, triggered in writeValueToSessionStorage\n  // See: useSessionStorage()\n  useEventListener('session-storage', handleStorageChange);\n\n  return [storedValue, setValue];\n}\n","import { useEffect, useState } from 'react';\n\n// this is required since our storybook manager plugin cannot use vite aliases\nimport { isBrowser } from '../../utils';\n\ntype Theme = 'dark' | 'light';\n\ntype UpdateTheme = (theme: Theme) => void;\n\n/** @private */\nconst DEFAULT_THEME: Theme = 'light';\n\n/** @private */\nconst THEME_ATTRIBUTE = 'data-mode';\n\n/** @private */\nconst THEME_KEY = 'theme';\n\n/** @private */\nconst SYS_DARK_MEDIA_QUERY = '(prefers-color-scheme: dark)';\n\n/**\n * Returns the current theme and a function to update the current theme\n *\n * The reason the implementation of this hook is rather convoluted is for\n * cases where the theme is updated outside this hook\n */\nfunction useTheme(): readonly [Theme, UpdateTheme] {\n  // Initial theme value is based on the value saved in local storage or the system theme\n  const [theme, setTheme] = useState<Theme>(() => {\n    if (!isBrowser()) {\n      return DEFAULT_THEME;\n    }\n    const savedTheme = window.localStorage.getItem(THEME_KEY);\n    let initialTheme: Theme;\n    if (savedTheme === 'dark' || savedTheme === 'light') {\n      initialTheme = savedTheme;\n    } else {\n      initialTheme = window.matchMedia(SYS_DARK_MEDIA_QUERY).matches ? 'dark' : 'light';\n    }\n    document.documentElement.setAttribute(THEME_ATTRIBUTE, initialTheme);\n    return initialTheme;\n  });\n\n  useEffect(() => {\n    const observer = new MutationObserver((mutations) => {\n      mutations.forEach((mutation) => {\n        if (mutation.attributeName === THEME_ATTRIBUTE) {\n          const updatedTheme = (mutation.target as HTMLHtmlElement).getAttribute(THEME_ATTRIBUTE);\n          if (updatedTheme === 'light' || updatedTheme === 'dark') {\n            window.localStorage.setItem(THEME_KEY, updatedTheme);\n            setTheme(updatedTheme);\n          } else {\n            console.error(`Unexpected value for 'data-mode' attribute: ${updatedTheme}`);\n          }\n        }\n      });\n    });\n    observer.observe(document.documentElement, {\n      attributes: true\n    });\n    return () => observer.disconnect();\n  }, []);\n\n  // When the user wants to change the theme\n  const updateTheme = (theme: Theme) => {\n    document.documentElement.setAttribute(THEME_ATTRIBUTE, theme);\n  };\n\n  return [theme, updateTheme] as const;\n}\n\nexport { DEFAULT_THEME, SYS_DARK_MEDIA_QUERY, type Theme, THEME_ATTRIBUTE, THEME_KEY, useTheme };\n","import { useCallback } from 'react';\n\nimport { useStore } from 'zustand';\n\nimport { translationStore } from '@/i18n';\nimport type { TranslateFunction, TranslationNamespace } from '@/i18n';\nimport { getTranslation } from '@/i18n/internal';\n\nexport function useTranslation<TNamespace extends TranslationNamespace | undefined = undefined>(\n  namespace?: TNamespace\n) {\n  const changeLanguage = useStore(translationStore, (store) => store.changeLanguage);\n  const fallbackLanguage = useStore(translationStore, (store) => store.fallbackLanguage);\n  const resolvedLanguage = useStore(translationStore, (store) => store.resolvedLanguage);\n  const translations = useStore(translationStore, (store) => {\n    if (namespace) {\n      return store.translations[namespace];\n    }\n    return store.translations;\n  });\n\n  const t: TranslateFunction<TNamespace> = useCallback(\n    (target, ...args) => {\n      return getTranslation(target, { fallbackLanguage, resolvedLanguage, translations }, ...args);\n    },\n    [fallbackLanguage, resolvedLanguage, translations]\n  );\n\n  return { changeLanguage, resolvedLanguage, t };\n}\n","import { useState } from 'react';\n\nimport { useEventListener } from '../useEventListener';\nimport { useIsomorphicLayoutEffect } from '../useIsomorphicLayoutEffect';\n\nexport type WindowSize = {\n  height: number;\n  width: number;\n};\n\nexport function useWindowSize(): WindowSize {\n  const [windowSize, setWindowSize] = useState<WindowSize>({\n    height: 0,\n    width: 0\n  });\n\n  const handleSize = () => {\n    setWindowSize({\n      height: window.innerHeight,\n      width: window.innerWidth\n    });\n  };\n\n  useEventListener('resize', handleSize);\n\n  // Set size at the first client-side load\n  useIsomorphicLayoutEffect(() => {\n    handleSize();\n  }, []);\n\n  return windowSize;\n}\n"],"mappings":"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","names":["useEffect","useEffect","useEffect","useRef","useRef","useEffect","useEffect","useRef","useRef","useEffect","useEffect","useState","query","useState","useEffect","useCallback","useEffect","useState","useCallback","useState","useEffect","useEffect","useState","useState","useEffect","theme","useCallback","useCallback","useState","useState"]}

package/src/hooks/useSessionStorage/index.ts

@@ -1 +0,0 @@
-export * from './useSessionStorage';

package/src/hooks/useSessionStorage/useSessionStorage.test.ts

@@ -1,187 +0,0 @@
-import { act, renderHook } from '@testing-library/react';
-import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
-
-import { mockStorage } from '@/testing/mocks';
-import { isBrowser } from '@/utils';
-
-import { useSessionStorage } from './useSessionStorage';
-
-mockStorage('sessionStorage');
-
-vi.mock('@/utils', () => ({ isBrowser: vi.fn(() => true) }));
-
-describe('useSessionStorage()', () => {
-  beforeEach(() => {
-    window.sessionStorage.clear();
-  });
-
-  afterEach(() => {
-    vi.restoreAllMocks();
-  });
-
-  it('should return the initial state if running on the server', () => {
-    vi.mocked(isBrowser).mockReturnValue(false);
-    const { result } = renderHook(() => useSessionStorage('key', 'value'));
-    expect(result.current[0]).toBe('value');
-  });
-
-  it('should return the initial state if using a string', () => {
-    const { result } = renderHook(() => useSessionStorage('key', 'value'));
-    expect(result.current[0]).toBe('value');
-  });
-
-  it('return the initial state return if using a callback function', () => {
-    const { result } = renderHook(() => useSessionStorage('key', () => 'value'));
-    expect(result.current[0]).toBe('value');
-  });
-
-  it('return the initial state if using a string', () => {
-    const { result } = renderHook(() => useSessionStorage('digits', [1, 2]));
-    expect(result.current[0]).toEqual([1, 2]);
-  });
-
-  it('return the initial state if it is a map', () => {
-    const { result } = renderHook(() => useSessionStorage('map', new Map([['a', 1]])));
-    expect(result.current[0]).toEqual(new Map([['a', 1]]));
-  });
-
-  it('return the initial state if it is a set', () => {
-    const { result } = renderHook(() => useSessionStorage('set', new Set([1, 2])));
-    expect(result.current[0]).toEqual(new Set([1, 2]));
-  });
-
-  it('return the initial state if it is a date', () => {
-    const { result } = renderHook(() => useSessionStorage('date', new Date(2020, 1, 1)));
-    expect(result.current[0]).toEqual(new Date(2020, 1, 1));
-  });
-
-  it('should update the state and write to session storage', () => {
-    const { result } = renderHook(() => useSessionStorage('key', 'value'));
-    act(() => {
-      const setState = result.current[1];
-      setState('edited');
-    });
-    expect(result.current[0]).toBe('edited');
-    expect(window.sessionStorage.getItem('key')).toBe(JSON.stringify('edited'));
-  });
-
-  it('should update the state with undefined', () => {
-    const { result } = renderHook(() => useSessionStorage<string | undefined>('keytest', 'value'));
-    act(() => {
-      const setState = result.current[1];
-      setState(undefined);
-    });
-    expect(result.current[0]).toBeUndefined();
-  });
-
-  it('should update the state with a callback function', () => {
-    const { result } = renderHook(() => useSessionStorage('count', 2));
-    act(() => {
-      const setState = result.current[1];
-      setState((prev) => prev + 1);
-    });
-    expect(result.current[0]).toBe(3);
-    expect(window.sessionStorage.getItem('count')).toEqual('3');
-  });
-
-  it('should update the state with a callback function multiple times per render', () => {
-    const { result } = renderHook(() => useSessionStorage('count', 2));
-    act(() => {
-      const setState = result.current[1];
-      setState((prev) => prev + 1);
-      setState((prev) => prev + 1);
-      setState((prev) => prev + 1);
-    });
-    expect(result.current[0]).toBe(5);
-    expect(window.sessionStorage.getItem('count')).toEqual('5');
-  });
-
-  it('should update if another hook updates the same key', () => {
-    const initialValues: [string, unknown] = ['key', 'initial'];
-    const { result: A } = renderHook(() => useSessionStorage(...initialValues));
-    const { result: B } = renderHook(() => useSessionStorage(...initialValues));
-    const { result: C } = renderHook(() => useSessionStorage('other-key', 'initial'));
-
-    act(() => {
-      const setState = A.current[1];
-      setState('edited');
-    });
-
-    expect(B.current[0]).toBe('edited');
-    expect(C.current[0]).toBe('initial');
-  });
-
-  it('should not update if another hook updates a different key', () => {
-    let renderCount = 0;
-    const { result: A } = renderHook(() => {
-      renderCount++;
-      return useSessionStorage('key1', {});
-    });
-    const { result: B } = renderHook(() => useSessionStorage('key2', 'initial'));
-    expect(renderCount).toBe(1);
-    act(() => {
-      const setStateA = A.current[1];
-      setStateA({ a: 1 });
-    });
-    expect(renderCount).toBe(2);
-    act(() => {
-      const setStateB = B.current[1];
-      setStateB('edited');
-    });
-    expect(renderCount).toBe(2);
-  });
-
-  it('should return a referentially stable setter', () => {
-    const { result } = renderHook(() => useSessionStorage('count', 1));
-    const originalCallback = result.current[1];
-    act(() => {
-      const setState = result.current[1];
-      setState((prev) => prev + 1);
-    });
-    expect(result.current[1] === originalCallback).toBe(true);
-  });
-
-  it('should use the default JSON.stringify and JSON.parse when serializer/deserializer are not provided', () => {
-    const { result } = renderHook(() => useSessionStorage('key', 'initialValue'));
-    act(() => {
-      result.current[1]('newValue');
-    });
-    expect(sessionStorage.getItem('key')).toBe(JSON.stringify('newValue'));
-  });
-
-  it('should write to stderr and set the store to the initial value if the stored value in not serializable', () => {
-    vi.spyOn(console, 'error');
-    window.sessionStorage.setItem('key', '{{ x: foo }}');
-    renderHook(() => useSessionStorage('key', 'initialValue'));
-    expect(console.error).toHaveBeenLastCalledWith(expect.stringContaining('Error parsing JSON'));
-  });
-
-  it('should use a custom serializer and deserializer when provided', () => {
-    const serializer = (value: string) => value.toUpperCase();
-    const deserializer = (value: string) => value.toLowerCase();
-    const { result } = renderHook(() => useSessionStorage('key', 'initialValue', { deserializer, serializer }));
-    act(() => {
-      result.current[1]('NewValue');
-    });
-    expect(sessionStorage.getItem('key')).toBe('NEWVALUE');
-  });
-
-  it('should handle undefined values with custom deserializer', () => {
-    const serializer = (value: number | undefined) => String(value);
-    const deserializer = (value: string) => (value === 'undefined' ? undefined : Number(value));
-    const { result } = renderHook(() =>
-      useSessionStorage<number | undefined>('key', 0, {
-        deserializer,
-        serializer
-      })
-    );
-    act(() => {
-      result.current[1](undefined);
-    });
-    expect(sessionStorage.getItem('key')).toBe('undefined');
-    act(() => {
-      result.current[1](42);
-    });
-    expect(sessionStorage.getItem('key')).toBe('42');
-  });
-});