@cerberus-design/react 0.9.2 → 0.10.0

package/build/legacy/hooks/useTheme.cjs

@@ -21,56 +21,63 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/hooks/useTheme.ts
 var useTheme_exports = {};
 __export(useTheme_exports, {
+  MODE_KEY: () => MODE_KEY,
+  THEME_KEY: () => THEME_KEY,
   useTheme: () => useTheme
 });
 module.exports = __toCommonJS(useTheme_exports);
-var import_react2 = require("react");
-
-// src/context/theme.tsx
 var import_react = require("react");
-var import_jsx_runtime = require("react/jsx-runtime");
 var THEME_KEY = "cerberus-theme";
 var MODE_KEY = "cerberus-mode";
-var ThemeContext = (0, import_react.createContext)(
-  null
-);
-
-// src/hooks/useTheme.ts
-function useTheme(defaultTheme = "cerberus", defaultColorMode = "light") {
-  const [theme, setTheme] = (0, import_react2.useState)(defaultTheme);
-  const [colorMode, setColorMode] = (0, import_react2.useState)(defaultColorMode);
-  const handleThemeChange = (0, import_react2.useCallback)((newTheme) => {
-    setTheme(newTheme);
-    localStorage.setItem(THEME_KEY, newTheme);
-  }, []);
-  const handleColorModeChange = (0, import_react2.useCallback)(() => {
-    setColorMode((prev) => {
-      const newMode = prev === "light" ? "dark" : "light";
-      localStorage.setItem(MODE_KEY, newMode);
-      return newMode;
-    });
-  }, []);
-  (0, import_react2.useLayoutEffect)(() => {
+function useTheme(defaultTheme = "cerberus", defaultColorMode = "light", options = {}) {
+  const { updateMode, updateTheme, cache } = options;
+  const [theme, setTheme] = (0, import_react.useState)(defaultTheme);
+  const [colorMode, setColorMode] = (0, import_react.useState)(defaultColorMode);
+  const handleThemeChange = (0, import_react.useCallback)(
+    (newTheme) => {
+      setTheme(newTheme);
+      updateTheme == null ? void 0 : updateTheme(newTheme);
+    },
+    [updateTheme]
+  );
+  const handleColorModeChange = (0, import_react.useCallback)(
+    (newMode) => {
+      setColorMode(newMode);
+      updateMode == null ? void 0 : updateMode(newMode);
+    },
+    [updateMode]
+  );
+  (0, import_react.useLayoutEffect)(() => {
     const theme2 = localStorage.getItem(THEME_KEY);
     if (theme2) {
       setTheme(theme2);
     }
   }, []);
-  (0, import_react2.useLayoutEffect)(() => {
+  (0, import_react.useLayoutEffect)(() => {
     const mode = localStorage.getItem(MODE_KEY);
     if (mode) {
       setColorMode(mode);
     }
   }, []);
-  (0, import_react2.useEffect)(() => {
+  (0, import_react.useEffect)(() => {
     const root = document.documentElement;
-    root.dataset.theme = theme;
-  }, [theme]);
-  (0, import_react2.useEffect)(() => {
+    root.dataset.pandaTheme = theme;
+    if (cache) {
+      localStorage.setItem(THEME_KEY, theme);
+    }
+  }, [theme, cache]);
+  (0, import_react.useEffect)(() => {
     const root = document.documentElement;
-    root.dataset.colorMode = colorMode;
-  }, [colorMode]);
-  return (0, import_react2.useMemo)(
+    if (colorMode === "system") {
+      root.dataset.colorMode = window.matchMedia("(prefers-color-scheme: dark)").matches ? "dark" : "light";
+    } else {
+      root.dataset.colorMode = colorMode;
+    }
+    if (cache) {
+      localStorage.setItem(MODE_KEY, colorMode);
+    }
+  }, [colorMode, cache]);
+  return (0, import_react.useMemo)(
     () => ({
       theme,
       mode: colorMode,
@@ -82,6 +89,8 @@ function useTheme(defaultTheme = "cerberus", defaultColorMode = "light") {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  MODE_KEY,
+  THEME_KEY,
   useTheme
 });
 //# sourceMappingURL=useTheme.cjs.map

package/build/legacy/hooks/useTheme.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/hooks/useTheme.ts","../../../src/context/theme.tsx"],"sourcesContent":["'use client'\n\nimport {\n  useCallback,\n  useEffect,\n  useLayoutEffect,\n  useMemo,\n  useState,\n} from 'react'\nimport {\n  MODE_KEY,\n  THEME_KEY,\n  type ColorModes,\n  type CustomThemes,\n  type DefaultThemes,\n  type ThemeContextValue,\n} from '../context/theme'\n\nexport function useTheme<C extends string = DefaultThemes>(\n  defaultTheme: CustomThemes<C> = 'cerberus',\n  defaultColorMode: ColorModes = 'light',\n): ThemeContextValue<C> {\n  const [theme, setTheme] = useState<CustomThemes<C>>(defaultTheme)\n  const [colorMode, setColorMode] = useState<ColorModes>(defaultColorMode)\n\n  const handleThemeChange = useCallback((newTheme: CustomThemes<C>) => {\n    setTheme(newTheme)\n    localStorage.setItem(THEME_KEY, newTheme)\n  }, [])\n\n  const handleColorModeChange = useCallback(() => {\n    setColorMode((prev) => {\n      const newMode = prev === 'light' ? 'dark' : 'light'\n      localStorage.setItem(MODE_KEY, newMode)\n      return newMode\n    })\n  }, [])\n\n  useLayoutEffect(() => {\n    const theme = localStorage.getItem(THEME_KEY)\n    if (theme) {\n      setTheme(theme as CustomThemes<C>)\n    }\n  }, [])\n\n  useLayoutEffect(() => {\n    const mode = localStorage.getItem(MODE_KEY)\n    if (mode) {\n      setColorMode(mode as ColorModes)\n    }\n  }, [])\n\n  useEffect(() => {\n    const root = document.documentElement\n    root.dataset.theme = theme\n  }, [theme])\n\n  useEffect(() => {\n    const root = document.documentElement\n    root.dataset.colorMode = colorMode\n  }, [colorMode])\n\n  return useMemo(\n    () => ({\n      theme,\n      mode: colorMode,\n      updateTheme: handleThemeChange,\n      updateMode: handleColorModeChange,\n    }),\n    [theme, colorMode, handleThemeChange, handleColorModeChange],\n  )\n}\n","'use client'\n\nimport { createContext, useContext, type PropsWithChildren } from 'react'\nimport { useTheme } from '../hooks/useTheme'\n\nexport type DefaultThemes = 'cerberus'\nexport type CustomThemes<K extends string = DefaultThemes> = 'cerberus' | K\nexport type ColorModes = 'light' | 'dark'\n\nexport interface ThemeContextValue<T extends string = DefaultThemes> {\n  theme: CustomThemes<T>\n  mode: ColorModes\n  updateTheme: (theme: T) => void\n  updateMode: () => void\n}\n\nexport const THEME_KEY = 'cerberus-theme'\nexport const MODE_KEY = 'cerberus-mode'\n\nconst ThemeContext = createContext<ThemeContextValue<DefaultThemes> | null>(\n  null,\n)\n\n/**\n * A context provider that allows the user to set the theme and mode of the application.\n * @example\n * ```tsx\n * <ThemeProvider>\n *  <App />\n * </ThemeProvider>\n * ```\n */\nexport function ThemeProvider(props: PropsWithChildren<unknown>): JSX.Element {\n  const state = useTheme()\n  return (\n    <ThemeContext.Provider value={state}>\n      {props.children}\n    </ThemeContext.Provider>\n  )\n}\n\nexport function useThemeContext(): ThemeContextValue<DefaultThemes> {\n  const context = useContext(ThemeContext)\n  if (!context) {\n    throw new Error('useThemeContext must be used within a ThemeProvider')\n  }\n  return context\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAEA,IAAAA,gBAMO;;;ACNP,mBAAkE;AAiC9D;AAnBG,IAAM,YAAY;AAClB,IAAM,WAAW;AAExB,IAAM,mBAAe;AAAA,EACnB;AACF;;;ADHO,SAAS,SACd,eAAgC,YAChC,mBAA+B,SACT;AACtB,QAAM,CAAC,OAAO,QAAQ,QAAI,wBAA0B,YAAY;AAChE,QAAM,CAAC,WAAW,YAAY,QAAI,wBAAqB,gBAAgB;AAEvE,QAAM,wBAAoB,2BAAY,CAAC,aAA8B;AACnE,aAAS,QAAQ;AACjB,iBAAa,QAAQ,WAAW,QAAQ;AAAA,EAC1C,GAAG,CAAC,CAAC;AAEL,QAAM,4BAAwB,2BAAY,MAAM;AAC9C,iBAAa,CAAC,SAAS;AACrB,YAAM,UAAU,SAAS,UAAU,SAAS;AAC5C,mBAAa,QAAQ,UAAU,OAAO;AACtC,aAAO;AAAA,IACT,CAAC;AAAA,EACH,GAAG,CAAC,CAAC;AAEL,qCAAgB,MAAM;AACpB,UAAMC,SAAQ,aAAa,QAAQ,SAAS;AAC5C,QAAIA,QAAO;AACT,eAASA,MAAwB;AAAA,IACnC;AAAA,EACF,GAAG,CAAC,CAAC;AAEL,qCAAgB,MAAM;AACpB,UAAM,OAAO,aAAa,QAAQ,QAAQ;AAC1C,QAAI,MAAM;AACR,mBAAa,IAAkB;AAAA,IACjC;AAAA,EACF,GAAG,CAAC,CAAC;AAEL,+BAAU,MAAM;AACd,UAAM,OAAO,SAAS;AACtB,SAAK,QAAQ,QAAQ;AAAA,EACvB,GAAG,CAAC,KAAK,CAAC;AAEV,+BAAU,MAAM;AACd,UAAM,OAAO,SAAS;AACtB,SAAK,QAAQ,YAAY;AAAA,EAC3B,GAAG,CAAC,SAAS,CAAC;AAEd,aAAO;AAAA,IACL,OAAO;AAAA,MACL;AAAA,MACA,MAAM;AAAA,MACN,aAAa;AAAA,MACb,YAAY;AAAA,IACd;AAAA,IACA,CAAC,OAAO,WAAW,mBAAmB,qBAAqB;AAAA,EAC7D;AACF;","names":["import_react","theme"]}
+{"version":3,"sources":["../../../src/hooks/useTheme.ts"],"sourcesContent":["'use client'\n\nimport {\n  useCallback,\n  useEffect,\n  useLayoutEffect,\n  useMemo,\n  useState,\n} from 'react'\nimport {\n  type ColorModes,\n  type CustomThemes,\n  type DefaultThemes,\n  type ThemeContextValue,\n} from '../context/theme'\n\n/**\n * This module provides a hook for using the theme.\n * @module\n */\n\nexport const THEME_KEY = 'cerberus-theme'\nexport const MODE_KEY = 'cerberus-mode'\n\nexport interface UseThemeOptions<T extends string = DefaultThemes> {\n  /**\n   * Whether to cache the theme in local storage.\n   */\n  cache?: boolean\n  /**\n   * Called when the theme is updated.\n   */\n  updateTheme?: (theme: T) => void\n  /**\n   * Called when the color mode is updated.\n   */\n  updateMode?: (mode: ColorModes) => void\n}\n\n/**\n * Provides a hook for using the theme for a single instance of the application.\n * @see https://cerberus.digitalu.design/react/use-theme\n * @param defaultTheme The default theme.\n * @param defaultColorMode The default color mode.\n * @param options Additional options.\n */\nexport function useTheme<C extends string = DefaultThemes>(\n  defaultTheme: CustomThemes<C> = 'cerberus',\n  defaultColorMode: ColorModes = 'light',\n  options: UseThemeOptions<C> = {},\n): ThemeContextValue<C> {\n  const { updateMode, updateTheme, cache } = options\n  const [theme, setTheme] = useState<CustomThemes<C>>(defaultTheme)\n  const [colorMode, setColorMode] = useState<ColorModes>(defaultColorMode)\n\n  const handleThemeChange = useCallback(\n    (newTheme: C) => {\n      setTheme(newTheme)\n      updateTheme?.(newTheme)\n    },\n    [updateTheme],\n  )\n\n  const handleColorModeChange = useCallback(\n    (newMode: ColorModes) => {\n      setColorMode(newMode)\n      updateMode?.(newMode)\n    },\n    [updateMode],\n  )\n\n  useLayoutEffect(() => {\n    const theme = localStorage.getItem(THEME_KEY)\n    if (theme) {\n      setTheme(theme as CustomThemes<C>)\n    }\n  }, [])\n\n  useLayoutEffect(() => {\n    const mode = localStorage.getItem(MODE_KEY)\n    if (mode) {\n      setColorMode(mode as ColorModes)\n    }\n  }, [])\n\n  useEffect(() => {\n    const root = document.documentElement\n    root.dataset.pandaTheme = theme\n\n    if (cache) {\n      localStorage.setItem(THEME_KEY, theme)\n    }\n  }, [theme, cache])\n\n  useEffect(() => {\n    const root = document.documentElement\n\n    if (colorMode === 'system') {\n      root.dataset.colorMode = window.matchMedia('(prefers-color-scheme: dark)')\n        .matches\n        ? 'dark'\n        : 'light'\n    } else {\n      root.dataset.colorMode = colorMode\n    }\n\n    if (cache) {\n      localStorage.setItem(MODE_KEY, colorMode)\n    }\n  }, [colorMode, cache])\n\n  return useMemo(\n    () => ({\n      theme,\n      mode: colorMode,\n      updateTheme: handleThemeChange,\n      updateMode: handleColorModeChange,\n    }),\n    [theme, colorMode, handleThemeChange, handleColorModeChange],\n  )\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAEA,mBAMO;AAaA,IAAM,YAAY;AAClB,IAAM,WAAW;AAwBjB,SAAS,SACd,eAAgC,YAChC,mBAA+B,SAC/B,UAA8B,CAAC,GACT;AACtB,QAAM,EAAE,YAAY,aAAa,MAAM,IAAI;AAC3C,QAAM,CAAC,OAAO,QAAQ,QAAI,uBAA0B,YAAY;AAChE,QAAM,CAAC,WAAW,YAAY,QAAI,uBAAqB,gBAAgB;AAEvE,QAAM,wBAAoB;AAAA,IACxB,CAAC,aAAgB;AACf,eAAS,QAAQ;AACjB,iDAAc;AAAA,IAChB;AAAA,IACA,CAAC,WAAW;AAAA,EACd;AAEA,QAAM,4BAAwB;AAAA,IAC5B,CAAC,YAAwB;AACvB,mBAAa,OAAO;AACpB,+CAAa;AAAA,IACf;AAAA,IACA,CAAC,UAAU;AAAA,EACb;AAEA,oCAAgB,MAAM;AACpB,UAAMA,SAAQ,aAAa,QAAQ,SAAS;AAC5C,QAAIA,QAAO;AACT,eAASA,MAAwB;AAAA,IACnC;AAAA,EACF,GAAG,CAAC,CAAC;AAEL,oCAAgB,MAAM;AACpB,UAAM,OAAO,aAAa,QAAQ,QAAQ;AAC1C,QAAI,MAAM;AACR,mBAAa,IAAkB;AAAA,IACjC;AAAA,EACF,GAAG,CAAC,CAAC;AAEL,8BAAU,MAAM;AACd,UAAM,OAAO,SAAS;AACtB,SAAK,QAAQ,aAAa;AAE1B,QAAI,OAAO;AACT,mBAAa,QAAQ,WAAW,KAAK;AAAA,IACvC;AAAA,EACF,GAAG,CAAC,OAAO,KAAK,CAAC;AAEjB,8BAAU,MAAM;AACd,UAAM,OAAO,SAAS;AAEtB,QAAI,cAAc,UAAU;AAC1B,WAAK,QAAQ,YAAY,OAAO,WAAW,8BAA8B,EACtE,UACC,SACA;AAAA,IACN,OAAO;AACL,WAAK,QAAQ,YAAY;AAAA,IAC3B;AAEA,QAAI,OAAO;AACT,mBAAa,QAAQ,UAAU,SAAS;AAAA,IAC1C;AAAA,EACF,GAAG,CAAC,WAAW,KAAK,CAAC;AAErB,aAAO;AAAA,IACL,OAAO;AAAA,MACL;AAAA,MACA,MAAM;AAAA,MACN,aAAa;AAAA,MACb,YAAY;AAAA,IACd;AAAA,IACA,CAAC,OAAO,WAAW,mBAAmB,qBAAqB;AAAA,EAC7D;AACF;","names":["theme"]}

package/build/legacy/hooks/useToggle.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/hooks/useToggle.ts"],"sourcesContent":["'use client'\n\nimport { useCallback, useMemo, useState, type ChangeEvent } from 'react'\n\nexport interface UseToggleOptions {\n  checked?: string\n  onChange?: (e: ChangeEvent<HTMLInputElement>) => void\n}\nexport interface ToggleHookReturn {\n  checked: string\n  handleChange: (e: ChangeEvent<HTMLInputElement>) => void\n}\n\nexport function useToggle(options?: UseToggleOptions): ToggleHookReturn {\n  const [checked, setChecked] = useState<string>(options?.checked ?? '')\n  const onChange = options?.onChange\n\n  const handleChange = useCallback(\n    (e: ChangeEvent<HTMLInputElement>) => {\n      const target = e.currentTarget as HTMLInputElement\n      setChecked((prev) => {\n        return prev === target.value ? '' : target.value\n      })\n      onChange?.(e)\n    },\n    [onChange],\n  )\n\n  return useMemo(() => ({ checked, handleChange }), [checked, handleChange])\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAEA,mBAAiE;AAW1D,SAAS,UAAU,SAA8C;AACtE,QAAM,CAAC,SAAS,UAAU,QAAI,wBAAiB,mCAAS,YAAW,EAAE;AACrE,QAAM,WAAW,mCAAS;AAE1B,QAAM,mBAAe;AAAA,IACnB,CAAC,MAAqC;AACpC,YAAM,SAAS,EAAE;AACjB,iBAAW,CAAC,SAAS;AACnB,eAAO,SAAS,OAAO,QAAQ,KAAK,OAAO;AAAA,MAC7C,CAAC;AACD,2CAAW;AAAA,IACb;AAAA,IACA,CAAC,QAAQ;AAAA,EACX;AAEA,aAAO,sBAAQ,OAAO,EAAE,SAAS,aAAa,IAAI,CAAC,SAAS,YAAY,CAAC;AAC3E;","names":[]}
+{"version":3,"sources":["../../../src/hooks/useToggle.ts"],"sourcesContent":["'use client'\n\nimport { useCallback, useMemo, useState, type ChangeEvent } from 'react'\n\n/**\n * This module provides a hook for using a toggle.\n * @module useToggle\n */\n\nexport interface UseToggleOptions {\n  /**\n   * The initial checked state.\n   */\n  checked?: string\n  /**\n   * Called when the checked state changes.\n   */\n  onChange?: (e: ChangeEvent<HTMLInputElement>) => void\n}\nexport interface ToggleHookReturn {\n  /**\n   * The checked state.\n   */\n  checked: string\n  /**\n   * A custom handler to be called when the checked state changes.\n   */\n  handleChange: (e: ChangeEvent<HTMLInputElement>) => void\n}\n\n/**\n * Provides a hook for using a toggle.\n * @see https://cerberus.digitalu.design/react/use-toggle\n * @memberof module:Toggle\n */\nexport function useToggle(options?: UseToggleOptions): ToggleHookReturn {\n  const [checked, setChecked] = useState<string>(options?.checked ?? '')\n  const onChange = options?.onChange\n\n  const handleChange = useCallback(\n    (e: ChangeEvent<HTMLInputElement>) => {\n      const target = e.currentTarget as HTMLInputElement\n      setChecked((prev) => {\n        return prev === target.value ? '' : target.value\n      })\n      onChange?.(e)\n    },\n    [onChange],\n  )\n\n  return useMemo(() => ({ checked, handleChange }), [checked, handleChange])\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAEA,mBAAiE;AAiC1D,SAAS,UAAU,SAA8C;AACtE,QAAM,CAAC,SAAS,UAAU,QAAI,wBAAiB,mCAAS,YAAW,EAAE;AACrE,QAAM,WAAW,mCAAS;AAE1B,QAAM,mBAAe;AAAA,IACnB,CAAC,MAAqC;AACpC,YAAM,SAAS,EAAE;AACjB,iBAAW,CAAC,SAAS;AACnB,eAAO,SAAS,OAAO,QAAQ,KAAK,OAAO;AAAA,MAC7C,CAAC;AACD,2CAAW;AAAA,IACb;AAAA,IACA,CAAC,QAAQ;AAAA,EACX;AAEA,aAAO,sBAAQ,OAAO,EAAE,SAAS,aAAa,IAAI,CAAC,SAAS,YAAY,CAAC;AAC3E;","names":[]}