@react-md/core 1.0.0-next.2 → 1.0.0-next.20

package/dist/theme/isColorScheme.d.ts

@@ -0,0 +1,16 @@
+import { type ColorScheme, type LightDarkColorScheme } from "./types.js";
+/**
+ * A type assertion helper to check if a value is a valid {@link LightDarkColorScheme}
+ * when it is pulled from unknown sources (like local storage).
+ *
+ * @since 6.0.0
+ */
+export declare function isLightDarkColorScheme(value: unknown): value is LightDarkColorScheme;
+/**
+ * A type assertion helper to check if a value is a valid
+ * {@link ColorScheme} when it is pulled from unknown sources (like local
+ * storage).
+ *
+ * @since 6.0.0
+ */
+export declare function isColorScheme(value: unknown): value is ColorScheme;

package/dist/theme/isColorScheme.js

@@ -0,0 +1,19 @@
+/**
+ * A type assertion helper to check if a value is a valid {@link LightDarkColorScheme}
+ * when it is pulled from unknown sources (like local storage).
+ *
+ * @since 6.0.0
+ */ export function isLightDarkColorScheme(value) {
+    return value === "light" || value === "dark";
+}
+/**
+ * A type assertion helper to check if a value is a valid
+ * {@link ColorScheme} when it is pulled from unknown sources (like local
+ * storage).
+ *
+ * @since 6.0.0
+ */ export function isColorScheme(value) {
+    return isLightDarkColorScheme(value) || value === "system";
+}
+
+//# sourceMappingURL=isColorScheme.js.map

package/dist/theme/isColorScheme.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/theme/isColorScheme.ts"],"sourcesContent":["import { type ColorScheme, type LightDarkColorScheme } from \"./types.js\";\n\n/**\n * A type assertion helper to check if a value is a valid {@link LightDarkColorScheme}\n * when it is pulled from unknown sources (like local storage).\n *\n * @since 6.0.0\n */\nexport function isLightDarkColorScheme(\n  value: unknown\n): value is LightDarkColorScheme {\n  return value === \"light\" || value === \"dark\";\n}\n\n/**\n * A type assertion helper to check if a value is a valid\n * {@link ColorScheme} when it is pulled from unknown sources (like local\n * storage).\n *\n * @since 6.0.0\n */\nexport function isColorScheme(value: unknown): value is ColorScheme {\n  return isLightDarkColorScheme(value) || value === \"system\";\n}\n"],"names":["isLightDarkColorScheme","value","isColorScheme"],"mappings":"AAEA;;;;;CAKC,GACD,OAAO,SAASA,uBACdC,KAAc;IAEd,OAAOA,UAAU,WAAWA,UAAU;AACxC;AAEA;;;;;;CAMC,GACD,OAAO,SAASC,cAAcD,KAAc;IAC1C,OAAOD,uBAAuBC,UAAUA,UAAU;AACpD"}

package/dist/theme/types.d.ts

@@ -1,11 +1,12 @@
-import type { CSSProperties } from "react";
+import { type CSSProperties } from "react";
+import { type UseStateSetter } from "../types.js";
 /**
- * @remarks \@since 6.0.0
+ * @since 6.0.0
  */
 export type CSSVariableName = `--${string}`;
 /**
  * @internal
- * @remarks \@since 6.0.0
+ * @since 6.0.0
  */
 export type DefinedCustomProperty<Property = keyof CSSProperties> = Property extends CSSVariableName ? Property : never;
 /**
@@ -29,6 +30,45 @@ export type DefinedCustomProperty<Property = keyof CSSProperties> = Property ext
  * // defined react-md custom properties
  * ```
  *
- * @remarks \@since 6.0.0
+ * @since 6.0.0
  */
 export type DefinedCSSVariableName = DefinedCustomProperty;
+/**
+ * @since 6.0.0
+ */
+export interface CSSVariable<Name extends CSSVariableName = DefinedCSSVariableName> {
+    name: Name;
+    value: string | number;
+}
+/**
+ * @since 6.0.0
+ */
+export type CSSVariablesProperties<Name extends CSSVariableName = DefinedCSSVariableName> = {
+    [key in Name]?: string | number;
+};
+/**
+ * @since 6.0.0
+ */
+export type ReadonlyCSSVariableList<Name extends CSSVariableName = DefinedCSSVariableName> = readonly Readonly<CSSVariable<Name>>[];
+/** @since 6.0.0 */
+export type LightDarkColorScheme = "light" | "dark";
+/** @since 6.0.0 */
+export type ColorScheme = LightDarkColorScheme | "system";
+/**
+ * @since 6.0.0
+ */
+export interface ColorSchemeState {
+    /**
+     * The defined color scheme for the app that should match the `$color-scheme`
+     * SCSS variable.
+     */
+    colorScheme: ColorScheme;
+    setColorScheme: UseStateSetter<ColorScheme>;
+}
+/** @since 6.0.0 */
+export interface ColorSchemeContext extends ColorSchemeState {
+    /**
+     * When the {@link colorScheme} is set to `"system"`, this will reflect
+     */
+    currentColor: LightDarkColorScheme;
+}

package/dist/theme/types.js

@@ -1,25 +1,3 @@
-/**
- * This is a utility type that can be used to auto-complete and type-check css
- * variables that are defined through module augmentation.
- *
- * ```ts
- * declare module "react" {
- *   interface CSSProperties {
- *     "--custom-property"?: number | string;
- *   }
- * }
- *
- * // will no longer throw a type error. also the `--custom-property` will
- * // appear as an auto-complete item
- * const style: CSSProperties = {
- *   "--custom-property": "red",
- * };
- *
- * // `DefinedCSSVariableName` will also include `--custom-property` with all
- * // defined react-md custom properties
- * ```
- *
- * @remarks \@since 6.0.0
- */ export { };
+/** @since 6.0.0 */ export { };
 
 //# sourceMappingURL=types.js.map

package/dist/theme/types.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/theme/types.ts"],"sourcesContent":["import type { CSSProperties } from \"react\";\n\n/**\n * @remarks \\@since 6.0.0\n */\nexport type CSSVariableName = `--${string}`;\n\n/**\n * @internal\n * @remarks \\@since 6.0.0\n */\nexport type DefinedCustomProperty<Property = keyof CSSProperties> =\n  Property extends CSSVariableName ? Property : never;\n\n/**\n * This is a utility type that can be used to auto-complete and type-check css\n * variables that are defined through module augmentation.\n *\n * ```ts\n * declare module \"react\" {\n *   interface CSSProperties {\n *     \"--custom-property\"?: number | string;\n *   }\n * }\n *\n * // will no longer throw a type error. also the `--custom-property` will\n * // appear as an auto-complete item\n * const style: CSSProperties = {\n *   \"--custom-property\": \"red\",\n * };\n *\n * // `DefinedCSSVariableName` will also include `--custom-property` with all\n * // defined react-md custom properties\n * ```\n *\n * @remarks \\@since 6.0.0\n */\nexport type DefinedCSSVariableName = DefinedCustomProperty;\n"],"names":[],"mappings":"AAcA;;;;;;;;;;;;;;;;;;;;;;CAsBC,GACD,WAA2D"}
+{"version":3,"sources":["../../src/theme/types.ts"],"sourcesContent":["import { type CSSProperties } from \"react\";\n\nimport { type UseStateSetter } from \"../types.js\";\n\n/**\n * @since 6.0.0\n */\nexport type CSSVariableName = `--${string}`;\n\n/**\n * @internal\n * @since 6.0.0\n */\nexport type DefinedCustomProperty<Property = keyof CSSProperties> =\n  Property extends CSSVariableName ? Property : never;\n\n/**\n * This is a utility type that can be used to auto-complete and type-check css\n * variables that are defined through module augmentation.\n *\n * ```ts\n * declare module \"react\" {\n *   interface CSSProperties {\n *     \"--custom-property\"?: number | string;\n *   }\n * }\n *\n * // will no longer throw a type error. also the `--custom-property` will\n * // appear as an auto-complete item\n * const style: CSSProperties = {\n *   \"--custom-property\": \"red\",\n * };\n *\n * // `DefinedCSSVariableName` will also include `--custom-property` with all\n * // defined react-md custom properties\n * ```\n *\n * @since 6.0.0\n */\nexport type DefinedCSSVariableName = DefinedCustomProperty;\n\n/**\n * @since 6.0.0\n */\nexport interface CSSVariable<\n  Name extends CSSVariableName = DefinedCSSVariableName,\n> {\n  name: Name;\n  value: string | number;\n}\n\n/**\n * @since 6.0.0\n */\nexport type CSSVariablesProperties<\n  Name extends CSSVariableName = DefinedCSSVariableName,\n> = {\n  [key in Name]?: string | number;\n};\n\n/**\n * @since 6.0.0\n */\nexport type ReadonlyCSSVariableList<\n  Name extends CSSVariableName = DefinedCSSVariableName,\n> = readonly Readonly<CSSVariable<Name>>[];\n\n/** @since 6.0.0 */\nexport type LightDarkColorScheme = \"light\" | \"dark\";\n\n/** @since 6.0.0 */\nexport type ColorScheme = LightDarkColorScheme | \"system\";\n\n/**\n * @since 6.0.0\n */\nexport interface ColorSchemeState {\n  /**\n   * The defined color scheme for the app that should match the `$color-scheme`\n   * SCSS variable.\n   */\n  colorScheme: ColorScheme;\n  setColorScheme: UseStateSetter<ColorScheme>;\n}\n\n/** @since 6.0.0 */\nexport interface ColorSchemeContext extends ColorSchemeState {\n  /**\n   * When the {@link colorScheme} is set to `\"system\"`, this will reflect\n   */\n  currentColor: LightDarkColorScheme;\n}\n"],"names":[],"mappings":"AAqFA,iBAAiB,GACjB,WAKC"}

package/dist/theme/useCSSVariables.d.ts

@@ -1,32 +1,11 @@
-import type { RefObject } from "react";
-import type { CSSVariableName, DefinedCSSVariableName } from "./types.js";
+import { type RefObject } from "react";
+import { type CSSVariableName, type CSSVariablesProperties, type ReadonlyCSSVariableList } from "./types.js";
 /**
- * @remarks \@since 6.0.0
- */
-export interface CSSVariable<Name extends CSSVariableName = DefinedCSSVariableName> {
-    name: Name;
-    value: string | number;
-}
-/**
- * @remarks \@since 6.0.0
- */
-export type CSSVariablesProperties<Name extends CSSVariableName = DefinedCSSVariableName> = {
-    [key in Name]?: string | number;
-};
-/**
- * @remarks \@since 6.0.0
- */
-export type ReadonlyCSSVariableList<Name extends CSSVariableName = DefinedCSSVariableName> = readonly Readonly<CSSVariable<Name>>[];
-/**
- * @example
- * Applying Variables the root html element
+ * @example Applying Variables the root html element
  * ```ts
- * import {
- *   contrastColor,
- *   pinkAccent200,
- *   purple500,
- *   useCSSVariables,
- *  } from "@react-md/core";
+ * import { purple500 } from "@react-md/core/theme/colors";
+ * import { useCSSVariables } from "@react-md/core/theme/useCSSVariables";
+ * import { contrastColor } from "@react-md/core/theme/utils";
  * import { useMemo } from "react";
  *
  * function Example(): null {
@@ -49,22 +28,17 @@ export type ReadonlyCSSVariableList<Name extends CSSVariableName = DefinedCSSVar
  * }
  * ```
  *
- * @remarks \@since 6.0.0
+ * @since 6.0.0
  */
 export declare function useCSSVariables<Name extends CSSVariableName>(variables: ReadonlyCSSVariableList<Name>, rootNode?: RefObject<HTMLElement> | HTMLElement): void;
 /**
- * @example
- * Applying variables through inline styles
+ * @example Applying variables through inline styles
  * ```tsx
- * import {
- *   contrastColor,
- *   ReadonlyCSSVariableList,
- *   pinkAccent200,
- *   purple500,
- *   useCSSVariables,
- *  } from "@react-md/core";
- * import { useMemo } from "react";
- * import type { ReactElement, ReactNode } from "react";
+ * import { purple500 } from "@react-md/core/theme/colors";
+ * import { type ReadonlyCSSVariableList } from "@react-md/core/theme/types";
+ * import { useCSSVariables } from "@react-md/core/theme/useCSSVariables";
+ * import { contrastColor } from "@react-md/core/theme/utils";
+ * import { type ReactElement, type ReactNode, useMemo } from "react";
  *
  * function Example({ children }: { children: ReactNode }): ReactElement {
  *   const customVariables = useMemo<ReadonlyCSSVariableList>(() => {
@@ -85,6 +59,6 @@ export declare function useCSSVariables<Name extends CSSVariableName>(variables:
  * }
  * ```
  *
- * @remarks \@since 6.0.0
+ * @since 6.0.0
  */
 export declare function useCSSVariables<Name extends CSSVariableName>(variables: ReadonlyCSSVariableList<Name>, inlineStyle: true): CSSVariablesProperties<Name>;

package/dist/theme/useCSSVariables.js

@@ -1,7 +1,7 @@
 "use client";
 import { useEffect, useMemo } from "react";
 /**
- * @remarks \@since 6.0.0
+ * @since 6.0.0
  */ export function useCSSVariables(variables, rootNodeOrInlineStyle) {
     useEffect(()=>{
         if (rootNodeOrInlineStyle === true || !variables.length) {

package/dist/theme/useCSSVariables.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/theme/useCSSVariables.ts"],"sourcesContent":["\"use client\";\nimport type { RefObject } from \"react\";\nimport { useEffect, useMemo } from \"react\";\nimport type { CSSVariableName, DefinedCSSVariableName } from \"./types.js\";\n\n/**\n * @remarks \\@since 6.0.0\n */\nexport interface CSSVariable<\n  Name extends CSSVariableName = DefinedCSSVariableName,\n> {\n  name: Name;\n  value: string | number;\n}\n\n/**\n * @remarks \\@since 6.0.0\n */\nexport type CSSVariablesProperties<\n  Name extends CSSVariableName = DefinedCSSVariableName,\n> = {\n  [key in Name]?: string | number;\n};\n\n/**\n * @remarks \\@since 6.0.0\n */\nexport type ReadonlyCSSVariableList<\n  Name extends CSSVariableName = DefinedCSSVariableName,\n> = readonly Readonly<CSSVariable<Name>>[];\n\n/**\n * @example\n * Applying Variables the root html element\n * ```ts\n * import {\n *   contrastColor,\n *   pinkAccent200,\n *   purple500,\n *   useCSSVariables,\n *  } from \"@react-md/core\";\n * import { useMemo } from \"react\";\n *\n * function Example(): null {\n *   // Note: You should use `useMemo` so that the custom variables are not\n *   // added and removed during each render.\n *   useCSSVariables(useMemo(() => {\n *     return [\n *       {\n *         name: \"--rmd-primary-color\",\n *         value: purple500,\n *       },\n *       {\n *         name: \"--rmd-on-primary-color\",\n *         value: contrastColor(purple500),\n *       },\n *     ];\n *   }, []));\n *\n *   return null;\n * }\n * ```\n *\n * @remarks \\@since 6.0.0\n */\nexport function useCSSVariables<Name extends CSSVariableName>(\n  variables: ReadonlyCSSVariableList<Name>,\n  rootNode?: RefObject<HTMLElement> | HTMLElement\n): void;\n/**\n * @example\n * Applying variables through inline styles\n * ```tsx\n * import {\n *   contrastColor,\n *   ReadonlyCSSVariableList,\n *   pinkAccent200,\n *   purple500,\n *   useCSSVariables,\n *  } from \"@react-md/core\";\n * import { useMemo } from \"react\";\n * import type { ReactElement, ReactNode } from \"react\";\n *\n * function Example({ children }: { children: ReactNode }): ReactElement {\n *   const customVariables = useMemo<ReadonlyCSSVariableList>(() => {\n *     return [\n *       {\n *         name: \"--rmd-primary-color\",\n *         value: purple500,\n *       },\n *       {\n *         name: \"--rmd-on-primary-color\",\n *         value: contrastColor(purple500),\n *       },\n *     ];\n *   }, []);\n *   const style = useCSSVariables(customVariables, true);\n *\n *   return <div style={style}>{children}</div>;\n * }\n * ```\n *\n * @remarks \\@since 6.0.0\n */\nexport function useCSSVariables<Name extends CSSVariableName>(\n  variables: ReadonlyCSSVariableList<Name>,\n  inlineStyle: true\n): CSSVariablesProperties<Name>;\n/**\n * @remarks \\@since 6.0.0\n */\nexport function useCSSVariables<Name extends CSSVariableName>(\n  variables: ReadonlyCSSVariableList<Name>,\n  rootNodeOrInlineStyle?: RefObject<HTMLElement> | HTMLElement | boolean\n): CSSVariablesProperties<Name> | void {\n  useEffect(() => {\n    if (rootNodeOrInlineStyle === true || !variables.length) {\n      return;\n    }\n\n    // use an iife so that hoisting doesn't cause a possible \"null\" issue for\n    // the root\n    const root = (() => {\n      if (!rootNodeOrInlineStyle) {\n        return document.documentElement;\n      }\n\n      if (\"current\" in rootNodeOrInlineStyle) {\n        return rootNodeOrInlineStyle.current;\n      }\n\n      return rootNodeOrInlineStyle;\n    })();\n\n    if (!root) {\n      return;\n    }\n\n    // const root = document.documentElement;\n    variables.forEach(({ name, value }) => {\n      if (\n        process.env.NODE_ENV !== \"production\" &&\n        root.style.getPropertyValue(name)\n      ) {\n        const currentValue = root.style.getPropertyValue(name);\n        const overwritten =\n          currentValue !== value\n            ? ` and will be overwritten to \"${value}\"`\n            : \"\";\n        // eslint-disable-next-line no-console\n        console.warn(\n          `The \"${name}\" css variable has already been set to \"${currentValue}\" ` +\n            `on the root element${overwritten}. There might be conflicting overrides.`\n        );\n      }\n\n      root.style.setProperty(name, `${value}`);\n    });\n    return () => {\n      variables.forEach(({ name }) => {\n        root.style.removeProperty(name);\n      });\n    };\n  }, [variables, rootNodeOrInlineStyle]);\n\n  return useMemo(() => {\n    if (rootNodeOrInlineStyle !== true) {\n      return;\n    }\n\n    return variables.reduce<CSSVariablesProperties<Name>>(\n      (style, { name, value }) => {\n        style[name] = value;\n        return style;\n      },\n      {}\n    );\n  }, [rootNodeOrInlineStyle, variables]);\n}\n"],"names":["useEffect","useMemo","useCSSVariables","variables","rootNodeOrInlineStyle","length","root","document","documentElement","current","forEach","name","value","process","env","NODE_ENV","style","getPropertyValue","currentValue","overwritten","console","warn","setProperty","removeProperty","reduce"],"mappings":"AAAA;AAEA,SAASA,SAAS,EAAEC,OAAO,QAAQ,QAAQ;AA0G3C;;CAEC,GACD,OAAO,SAASC,gBACdC,SAAwC,EACxCC,qBAAsE;IAEtEJ,UAAU;QACR,IAAII,0BAA0B,QAAQ,CAACD,UAAUE,MAAM,EAAE;YACvD;QACF;QAEA,yEAAyE;QACzE,WAAW;QACX,MAAMC,OAAO,AAAC,CAAA;YACZ,IAAI,CAACF,uBAAuB;gBAC1B,OAAOG,SAASC,eAAe;YACjC;YAEA,IAAI,aAAaJ,uBAAuB;gBACtC,OAAOA,sBAAsBK,OAAO;YACtC;YAEA,OAAOL;QACT,CAAA;QAEA,IAAI,CAACE,MAAM;YACT;QACF;QAEA,yCAAyC;QACzCH,UAAUO,OAAO,CAAC,CAAC,EAAEC,IAAI,EAAEC,KAAK,EAAE;YAChC,IACEC,QAAQC,GAAG,CAACC,QAAQ,KAAK,gBACzBT,KAAKU,KAAK,CAACC,gBAAgB,CAACN,OAC5B;gBACA,MAAMO,eAAeZ,KAAKU,KAAK,CAACC,gBAAgB,CAACN;gBACjD,MAAMQ,cACJD,iBAAiBN,QACb,CAAC,6BAA6B,EAAEA,MAAM,CAAC,CAAC,GACxC;gBACN,sCAAsC;gBACtCQ,QAAQC,IAAI,CACV,CAAC,KAAK,EAAEV,KAAK,wCAAwC,EAAEO,aAAa,EAAE,CAAC,GACrE,CAAC,mBAAmB,EAAEC,YAAY,uCAAuC,CAAC;YAEhF;YAEAb,KAAKU,KAAK,CAACM,WAAW,CAACX,MAAM,CAAC,EAAEC,MAAM,CAAC;QACzC;QACA,OAAO;YACLT,UAAUO,OAAO,CAAC,CAAC,EAAEC,IAAI,EAAE;gBACzBL,KAAKU,KAAK,CAACO,cAAc,CAACZ;YAC5B;QACF;IACF,GAAG;QAACR;QAAWC;KAAsB;IAErC,OAAOH,QAAQ;QACb,IAAIG,0BAA0B,MAAM;YAClC;QACF;QAEA,OAAOD,UAAUqB,MAAM,CACrB,CAACR,OAAO,EAAEL,IAAI,EAAEC,KAAK,EAAE;YACrBI,KAAK,CAACL,KAAK,GAAGC;YACd,OAAOI;QACT,GACA,CAAC;IAEL,GAAG;QAACZ;QAAuBD;KAAU;AACvC"}
+{"version":3,"sources":["../../src/theme/useCSSVariables.ts"],"sourcesContent":["\"use client\";\n\nimport { type RefObject, useEffect, useMemo } from \"react\";\n\nimport {\n  type CSSVariableName,\n  type CSSVariablesProperties,\n  type ReadonlyCSSVariableList,\n} from \"./types.js\";\n\n/**\n * @example Applying Variables the root html element\n * ```ts\n * import { purple500 } from \"@react-md/core/theme/colors\";\n * import { useCSSVariables } from \"@react-md/core/theme/useCSSVariables\";\n * import { contrastColor } from \"@react-md/core/theme/utils\";\n * import { useMemo } from \"react\";\n *\n * function Example(): null {\n *   // Note: You should use `useMemo` so that the custom variables are not\n *   // added and removed during each render.\n *   useCSSVariables(useMemo(() => {\n *     return [\n *       {\n *         name: \"--rmd-primary-color\",\n *         value: purple500,\n *       },\n *       {\n *         name: \"--rmd-on-primary-color\",\n *         value: contrastColor(purple500),\n *       },\n *     ];\n *   }, []));\n *\n *   return null;\n * }\n * ```\n *\n * @since 6.0.0\n */\nexport function useCSSVariables<Name extends CSSVariableName>(\n  variables: ReadonlyCSSVariableList<Name>,\n  rootNode?: RefObject<HTMLElement> | HTMLElement\n): void;\n/**\n * @example Applying variables through inline styles\n * ```tsx\n * import { purple500 } from \"@react-md/core/theme/colors\";\n * import { type ReadonlyCSSVariableList } from \"@react-md/core/theme/types\";\n * import { useCSSVariables } from \"@react-md/core/theme/useCSSVariables\";\n * import { contrastColor } from \"@react-md/core/theme/utils\";\n * import { type ReactElement, type ReactNode, useMemo } from \"react\";\n *\n * function Example({ children }: { children: ReactNode }): ReactElement {\n *   const customVariables = useMemo<ReadonlyCSSVariableList>(() => {\n *     return [\n *       {\n *         name: \"--rmd-primary-color\",\n *         value: purple500,\n *       },\n *       {\n *         name: \"--rmd-on-primary-color\",\n *         value: contrastColor(purple500),\n *       },\n *     ];\n *   }, []);\n *   const style = useCSSVariables(customVariables, true);\n *\n *   return <div style={style}>{children}</div>;\n * }\n * ```\n *\n * @since 6.0.0\n */\nexport function useCSSVariables<Name extends CSSVariableName>(\n  variables: ReadonlyCSSVariableList<Name>,\n  inlineStyle: true\n): CSSVariablesProperties<Name>;\n/**\n * @since 6.0.0\n */\nexport function useCSSVariables<Name extends CSSVariableName>(\n  variables: ReadonlyCSSVariableList<Name>,\n  rootNodeOrInlineStyle?: RefObject<HTMLElement> | HTMLElement | boolean\n): CSSVariablesProperties<Name> | undefined {\n  useEffect(() => {\n    if (rootNodeOrInlineStyle === true || !variables.length) {\n      return;\n    }\n\n    // use an iife so that hoisting doesn't cause a possible \"null\" issue for\n    // the root\n    const root = (() => {\n      if (!rootNodeOrInlineStyle) {\n        return document.documentElement;\n      }\n\n      if (\"current\" in rootNodeOrInlineStyle) {\n        return rootNodeOrInlineStyle.current;\n      }\n\n      return rootNodeOrInlineStyle;\n    })();\n\n    if (!root) {\n      return;\n    }\n\n    // const root = document.documentElement;\n    variables.forEach(({ name, value }) => {\n      if (\n        process.env.NODE_ENV !== \"production\" &&\n        root.style.getPropertyValue(name)\n      ) {\n        const currentValue = root.style.getPropertyValue(name);\n        const overwritten =\n          currentValue !== value\n            ? ` and will be overwritten to \"${value}\"`\n            : \"\";\n        // eslint-disable-next-line no-console\n        console.warn(\n          `The \"${name}\" css variable has already been set to \"${currentValue}\" ` +\n            `on the root element${overwritten}. There might be conflicting overrides.`\n        );\n      }\n\n      root.style.setProperty(name, `${value}`);\n    });\n    return () => {\n      variables.forEach(({ name }) => {\n        root.style.removeProperty(name);\n      });\n    };\n  }, [variables, rootNodeOrInlineStyle]);\n\n  return useMemo(() => {\n    if (rootNodeOrInlineStyle !== true) {\n      return;\n    }\n\n    return variables.reduce<CSSVariablesProperties<Name>>(\n      (style, { name, value }) => {\n        style[name] = value;\n        return style;\n      },\n      {}\n    );\n  }, [rootNodeOrInlineStyle, variables]);\n}\n"],"names":["useEffect","useMemo","useCSSVariables","variables","rootNodeOrInlineStyle","length","root","document","documentElement","current","forEach","name","value","process","env","NODE_ENV","style","getPropertyValue","currentValue","overwritten","console","warn","setProperty","removeProperty","reduce"],"mappings":"AAAA;AAEA,SAAyBA,SAAS,EAAEC,OAAO,QAAQ,QAAQ;AA4E3D;;CAEC,GACD,OAAO,SAASC,gBACdC,SAAwC,EACxCC,qBAAsE;IAEtEJ,UAAU;QACR,IAAII,0BAA0B,QAAQ,CAACD,UAAUE,MAAM,EAAE;YACvD;QACF;QAEA,yEAAyE;QACzE,WAAW;QACX,MAAMC,OAAO,AAAC,CAAA;YACZ,IAAI,CAACF,uBAAuB;gBAC1B,OAAOG,SAASC,eAAe;YACjC;YAEA,IAAI,aAAaJ,uBAAuB;gBACtC,OAAOA,sBAAsBK,OAAO;YACtC;YAEA,OAAOL;QACT,CAAA;QAEA,IAAI,CAACE,MAAM;YACT;QACF;QAEA,yCAAyC;QACzCH,UAAUO,OAAO,CAAC,CAAC,EAAEC,IAAI,EAAEC,KAAK,EAAE;YAChC,IACEC,QAAQC,GAAG,CAACC,QAAQ,KAAK,gBACzBT,KAAKU,KAAK,CAACC,gBAAgB,CAACN,OAC5B;gBACA,MAAMO,eAAeZ,KAAKU,KAAK,CAACC,gBAAgB,CAACN;gBACjD,MAAMQ,cACJD,iBAAiBN,QACb,CAAC,6BAA6B,EAAEA,MAAM,CAAC,CAAC,GACxC;gBACN,sCAAsC;gBACtCQ,QAAQC,IAAI,CACV,CAAC,KAAK,EAAEV,KAAK,wCAAwC,EAAEO,aAAa,EAAE,CAAC,GACrE,CAAC,mBAAmB,EAAEC,YAAY,uCAAuC,CAAC;YAEhF;YAEAb,KAAKU,KAAK,CAACM,WAAW,CAACX,MAAM,GAAGC,OAAO;QACzC;QACA,OAAO;YACLT,UAAUO,OAAO,CAAC,CAAC,EAAEC,IAAI,EAAE;gBACzBL,KAAKU,KAAK,CAACO,cAAc,CAACZ;YAC5B;QACF;IACF,GAAG;QAACR;QAAWC;KAAsB;IAErC,OAAOH,QAAQ;QACb,IAAIG,0BAA0B,MAAM;YAClC;QACF;QAEA,OAAOD,UAAUqB,MAAM,CACrB,CAACR,OAAO,EAAEL,IAAI,EAAEC,KAAK,EAAE;YACrBI,KAAK,CAACL,KAAK,GAAGC;YACd,OAAOI;QACT,GACA,CAAC;IAEL,GAAG;QAACZ;QAAuBD;KAAU;AACvC"}

package/dist/theme/useColorScheme.d.ts

@@ -1,83 +1,49 @@
-/// <reference types="react" />
-import type { UseStateSetter } from "../types.js";
-/** @remarks \@since 6.0.0 */
-export type ColorScheme = "light" | "dark";
-/** @remarks \@since 6.0.0 */
-export type ColorSchemeMode = ColorScheme | "system";
-/**
- * @remarks \@since 6.0.0
- */
-export interface ColorSchemeModeBehavior {
-    /**
-     * The current color scheme mode that is being used by your app that should
-     * default to the `$color-scheme` SCSS variable. If the
-     * {@link setColorSchemeMode} is called, this will update to that new value.
-     *
-     * TODO: Figure out how to document this
-     *
-     * - `colorScheme` - only `light` or `dark` -- only useful when the `colorSchemeMode` is set to `system`
-     * - `colorSchemeMode` - current **user** defined color scheme behavior? should default to `$color-scheme`, but will change based on `setColorSchemeMode`
-     */
-    colorSchemeMode: ColorSchemeMode;
-    /**
-     * A function to update the color scheme.
-     *
-     * @see {@link useColorScheme} for an example usage
-     */
-    setColorSchemeMode: UseStateSetter<ColorSchemeMode>;
-}
-/** @remarks \@since 6.0.0 */
-export interface ColorSchemeContext extends ColorSchemeModeBehavior {
-    /**
-     * The current color scheme that is being used. This is only useful when the
-     * {@link colorSchemeMode} is set to `"system"`.
-     */
-    colorScheme: ColorScheme;
-}
+import { type ColorSchemeContext } from "./types.js";
 export declare const ColorSchemeProvider: import("react").Provider<ColorSchemeContext>;
 /**
- * @example
- * Lazy Load Configurable Themes
+ * @example Lazy Load Configurable Themes
  * ```tsx
- * import type { ChangeEvent, ReactElement } from "react";
- * import { lazy } from "react";
- * import { createRoot } from "react-doc/client";
- * import { Checkbox, ColorSchemeProvider, useColorScheme } from "@react-md/core";
+ * import { Checkbox } from "@react-md/core/form/Checkbox";
+ * import { ColorSchemeProvider, useColorScheme } from "@react-md/core/theme/useColorScheme";
+ * import { type ChangeEvent, lazy, type ReactElement } from "react";
+ * import { createRoot } from "react-dom/client";
  *
- * const DarkTheme = lazy(() => import("./DarkTheme"));
- * const SystemTheme = lazy(() => import("./SystemTheme"));
+ * const DarkTheme = lazy(() => import("./DarkTheme.jsx"));
+ * const SystemTheme = lazy(() => import("./SystemTheme.jsx"));
  *
  * function App(): ReactElement {
- *   const { colorScheme, colorSchemeMode, setColorSchemeMode } =
+ *   const { currentColor, colorScheme, setColorScheme } =
  *     useColorScheme();
  *
  *   const onChange = (event: ChangeEvent<HTMLInputElement>): void => {
  *     const { value } = event.currentTarget;
  *     if (value === "light" || value === "dark" || value === "system") {
- *       setColorSchemeMode(value);
+ *       setColorScheme(value);
  *     }
  *   };
  *
  *   return (
  *     <>
- *       {colorSchemeMode === "dark" && <DarkTheme />}
- *       {colorSchemeMode === "system" && <SystemTheme />}
+ *       <NullSuspense>
+ *         {colorScheme === "dark" && <DarkTheme />}
+ *         {colorScheme === "system" && <SystemTheme />}
+ *       </NullSuspense>
  *       <Checkbox
  *         label="Light"
  *         value="light"
- *         checked={colorSchemeMode === "light"}
+ *         checked={colorScheme === "light"}
  *         onChange={onChange}
  *       />
  *       <Checkbox
  *         label="Dark"
  *         value="dark"
- *         checked={colorSchemeMode === "dark"}
+ *         checked={colorScheme === "dark"}
  *         onChange={onChange}
  *       />
  *       <Checkbox
  *         label="System"
  *         value="system"
- *         checked={colorSchemeMode === "system"}
+ *         checked={colorScheme === "system"}
  *         onChange={onChange}
  *       />
  *     </>
@@ -110,6 +76,6 @@ export declare const ColorSchemeProvider: import("react").Provider<ColorSchemeCo
  * }
  * ```
  *
- * @remarks \@since 6.0.0
+ * @since 6.0.0
  */
 export declare function useColorScheme(): Readonly<ColorSchemeContext>;

package/dist/theme/useColorScheme.js

@@ -1,9 +1,9 @@
 "use client";
 import { createContext, useContext } from "react";
 const context = createContext({
+    currentColor: "light",
     colorScheme: "light",
-    colorSchemeMode: "light",
-    setColorSchemeMode () {
+    setColorScheme () {
         if (process.env.NODE_ENV !== "production") {
             throw new Error("The `ColorSchemeProvider` has not been initialized.");
         }
@@ -12,48 +12,49 @@ const context = createContext({
 context.displayName = "ColorScheme";
 export const { Provider: ColorSchemeProvider } = context;
 /**
- * @example
- * Lazy Load Configurable Themes
+ * @example Lazy Load Configurable Themes
  * ```tsx
- * import type { ChangeEvent, ReactElement } from "react";
- * import { lazy } from "react";
- * import { createRoot } from "react-doc/client";
- * import { Checkbox, ColorSchemeProvider, useColorScheme } from "@react-md/core";
+ * import { Checkbox } from "@react-md/core/form/Checkbox";
+ * import { ColorSchemeProvider, useColorScheme } from "@react-md/core/theme/useColorScheme";
+ * import { type ChangeEvent, lazy, type ReactElement } from "react";
+ * import { createRoot } from "react-dom/client";
  *
- * const DarkTheme = lazy(() => import("./DarkTheme"));
- * const SystemTheme = lazy(() => import("./SystemTheme"));
+ * const DarkTheme = lazy(() => import("./DarkTheme.jsx"));
+ * const SystemTheme = lazy(() => import("./SystemTheme.jsx"));
  *
  * function App(): ReactElement {
- *   const { colorScheme, colorSchemeMode, setColorSchemeMode } =
+ *   const { currentColor, colorScheme, setColorScheme } =
  *     useColorScheme();
  *
  *   const onChange = (event: ChangeEvent<HTMLInputElement>): void => {
  *     const { value } = event.currentTarget;
  *     if (value === "light" || value === "dark" || value === "system") {
- *       setColorSchemeMode(value);
+ *       setColorScheme(value);
  *     }
  *   };
  *
  *   return (
  *     <>
- *       {colorSchemeMode === "dark" && <DarkTheme />}
- *       {colorSchemeMode === "system" && <SystemTheme />}
+ *       <NullSuspense>
+ *         {colorScheme === "dark" && <DarkTheme />}
+ *         {colorScheme === "system" && <SystemTheme />}
+ *       </NullSuspense>
  *       <Checkbox
  *         label="Light"
  *         value="light"
- *         checked={colorSchemeMode === "light"}
+ *         checked={colorScheme === "light"}
  *         onChange={onChange}
  *       />
  *       <Checkbox
  *         label="Dark"
  *         value="dark"
- *         checked={colorSchemeMode === "dark"}
+ *         checked={colorScheme === "dark"}
  *         onChange={onChange}
  *       />
  *       <Checkbox
  *         label="System"
  *         value="system"
- *         checked={colorSchemeMode === "system"}
+ *         checked={colorScheme === "system"}
  *         onChange={onChange}
  *       />
  *     </>
@@ -86,7 +87,7 @@ export const { Provider: ColorSchemeProvider } = context;
  * }
  * ```
  *
- * @remarks \@since 6.0.0
+ * @since 6.0.0
  */ export function useColorScheme() {
     return useContext(context);
 }

package/dist/theme/useColorScheme.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/theme/useColorScheme.ts"],"sourcesContent":["\"use client\";\nimport { createContext, useContext } from \"react\";\nimport type { UseStateSetter } from \"../types.js\";\n\n/** @remarks \\@since 6.0.0 */\nexport type ColorScheme = \"light\" | \"dark\";\n\n/** @remarks \\@since 6.0.0 */\nexport type ColorSchemeMode = ColorScheme | \"system\";\n\n/**\n * @remarks \\@since 6.0.0\n */\nexport interface ColorSchemeModeBehavior {\n  /**\n   * The current color scheme mode that is being used by your app that should\n   * default to the `$color-scheme` SCSS variable. If the\n   * {@link setColorSchemeMode} is called, this will update to that new value.\n   *\n   * TODO: Figure out how to document this\n   *\n   * - `colorScheme` - only `light` or `dark` -- only useful when the `colorSchemeMode` is set to `system`\n   * - `colorSchemeMode` - current **user** defined color scheme behavior? should default to `$color-scheme`, but will change based on `setColorSchemeMode`\n   */\n  colorSchemeMode: ColorSchemeMode;\n\n  /**\n   * A function to update the color scheme.\n   *\n   * @see {@link useColorScheme} for an example usage\n   */\n  setColorSchemeMode: UseStateSetter<ColorSchemeMode>;\n}\n\n/** @remarks \\@since 6.0.0 */\nexport interface ColorSchemeContext extends ColorSchemeModeBehavior {\n  /**\n   * The current color scheme that is being used. This is only useful when the\n   * {@link colorSchemeMode} is set to `\"system\"`.\n   */\n  colorScheme: ColorScheme;\n}\n\nconst context = createContext<ColorSchemeContext>({\n  colorScheme: \"light\",\n  colorSchemeMode: \"light\",\n  setColorSchemeMode() {\n    if (process.env.NODE_ENV !== \"production\") {\n      throw new Error(\"The `ColorSchemeProvider` has not been initialized.\");\n    }\n  },\n});\ncontext.displayName = \"ColorScheme\";\nexport const { Provider: ColorSchemeProvider } = context;\n\n/**\n * @example\n * Lazy Load Configurable Themes\n * ```tsx\n * import type { ChangeEvent, ReactElement } from \"react\";\n * import { lazy } from \"react\";\n * import { createRoot } from \"react-doc/client\";\n * import { Checkbox, ColorSchemeProvider, useColorScheme } from \"@react-md/core\";\n *\n * const DarkTheme = lazy(() => import(\"./DarkTheme\"));\n * const SystemTheme = lazy(() => import(\"./SystemTheme\"));\n *\n * function App(): ReactElement {\n *   const { colorScheme, colorSchemeMode, setColorSchemeMode } =\n *     useColorScheme();\n *\n *   const onChange = (event: ChangeEvent<HTMLInputElement>): void => {\n *     const { value } = event.currentTarget;\n *     if (value === \"light\" || value === \"dark\" || value === \"system\") {\n *       setColorSchemeMode(value);\n *     }\n *   };\n *\n *   return (\n *     <>\n *       {colorSchemeMode === \"dark\" && <DarkTheme />}\n *       {colorSchemeMode === \"system\" && <SystemTheme />}\n *       <Checkbox\n *         label=\"Light\"\n *         value=\"light\"\n *         checked={colorSchemeMode === \"light\"}\n *         onChange={onChange}\n *       />\n *       <Checkbox\n *         label=\"Dark\"\n *         value=\"dark\"\n *         checked={colorSchemeMode === \"dark\"}\n *         onChange={onChange}\n *       />\n *       <Checkbox\n *         label=\"System\"\n *         value=\"system\"\n *         checked={colorSchemeMode === \"system\"}\n *         onChange={onChange}\n *       />\n *     </>\n *   );\n * }\n *\n *\n * const root = createRoot(document.getElementById(\"root\"));\n * root.render(\n *   <ColorSchemeProvider>\n *     <App />\n *   </ColorSchemeProvider>\n * );\n *\n * // DarkTheme.tsx\n * import { useHtmlClassName } from \"@react-md/core\";\n *\n * import styles from \"./DarkTheme.module.scss\";\n *\n * export default function DarkTheme(): null {\n *   useHtmlClassName(styles.theme);\n *   return null\n * }\n *\n * // DarkTheme.module.scss\n * @use \"@react-md/core\";\n *\n * .theme {\n *   @include core.use-dark-theme;\n * }\n * ```\n *\n * @remarks \\@since 6.0.0\n */\nexport function useColorScheme(): Readonly<ColorSchemeContext> {\n  return useContext(context);\n}\n"],"names":["createContext","useContext","context","colorScheme","colorSchemeMode","setColorSchemeMode","process","env","NODE_ENV","Error","displayName","Provider","ColorSchemeProvider","useColorScheme"],"mappings":"AAAA;AACA,SAASA,aAAa,EAAEC,UAAU,QAAQ,QAAQ;AA0ClD,MAAMC,UAAUF,cAAkC;IAChDG,aAAa;IACbC,iBAAiB;IACjBC;QACE,IAAIC,QAAQC,GAAG,CAACC,QAAQ,KAAK,cAAc;YACzC,MAAM,IAAIC,MAAM;QAClB;IACF;AACF;AACAP,QAAQQ,WAAW,GAAG;AACtB,OAAO,MAAM,EAAEC,UAAUC,mBAAmB,EAAE,GAAGV,QAAQ;AAEzD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4EC,GACD,OAAO,SAASW;IACd,OAAOZ,WAAWC;AACpB"}
+{"version":3,"sources":["../../src/theme/useColorScheme.ts"],"sourcesContent":["\"use client\";\n\nimport { createContext, useContext } from \"react\";\n\nimport { type ColorSchemeContext } from \"./types.js\";\n\nconst context = createContext<ColorSchemeContext>({\n  currentColor: \"light\",\n  colorScheme: \"light\",\n  setColorScheme() {\n    if (process.env.NODE_ENV !== \"production\") {\n      throw new Error(\"The `ColorSchemeProvider` has not been initialized.\");\n    }\n  },\n});\ncontext.displayName = \"ColorScheme\";\nexport const { Provider: ColorSchemeProvider } = context;\n\n/**\n * @example Lazy Load Configurable Themes\n * ```tsx\n * import { Checkbox } from \"@react-md/core/form/Checkbox\";\n * import { ColorSchemeProvider, useColorScheme } from \"@react-md/core/theme/useColorScheme\";\n * import { type ChangeEvent, lazy, type ReactElement } from \"react\";\n * import { createRoot } from \"react-dom/client\";\n *\n * const DarkTheme = lazy(() => import(\"./DarkTheme.jsx\"));\n * const SystemTheme = lazy(() => import(\"./SystemTheme.jsx\"));\n *\n * function App(): ReactElement {\n *   const { currentColor, colorScheme, setColorScheme } =\n *     useColorScheme();\n *\n *   const onChange = (event: ChangeEvent<HTMLInputElement>): void => {\n *     const { value } = event.currentTarget;\n *     if (value === \"light\" || value === \"dark\" || value === \"system\") {\n *       setColorScheme(value);\n *     }\n *   };\n *\n *   return (\n *     <>\n *       <NullSuspense>\n *         {colorScheme === \"dark\" && <DarkTheme />}\n *         {colorScheme === \"system\" && <SystemTheme />}\n *       </NullSuspense>\n *       <Checkbox\n *         label=\"Light\"\n *         value=\"light\"\n *         checked={colorScheme === \"light\"}\n *         onChange={onChange}\n *       />\n *       <Checkbox\n *         label=\"Dark\"\n *         value=\"dark\"\n *         checked={colorScheme === \"dark\"}\n *         onChange={onChange}\n *       />\n *       <Checkbox\n *         label=\"System\"\n *         value=\"system\"\n *         checked={colorScheme === \"system\"}\n *         onChange={onChange}\n *       />\n *     </>\n *   );\n * }\n *\n *\n * const root = createRoot(document.getElementById(\"root\"));\n * root.render(\n *   <ColorSchemeProvider>\n *     <App />\n *   </ColorSchemeProvider>\n * );\n *\n * // DarkTheme.tsx\n * import { useHtmlClassName } from \"@react-md/core\";\n *\n * import styles from \"./DarkTheme.module.scss\";\n *\n * export default function DarkTheme(): null {\n *   useHtmlClassName(styles.theme);\n *   return null\n * }\n *\n * // DarkTheme.module.scss\n * @use \"@react-md/core\";\n *\n * .theme {\n *   @include core.use-dark-theme;\n * }\n * ```\n *\n * @since 6.0.0\n */\nexport function useColorScheme(): Readonly<ColorSchemeContext> {\n  return useContext(context);\n}\n"],"names":["createContext","useContext","context","currentColor","colorScheme","setColorScheme","process","env","NODE_ENV","Error","displayName","Provider","ColorSchemeProvider","useColorScheme"],"mappings":"AAAA;AAEA,SAASA,aAAa,EAAEC,UAAU,QAAQ,QAAQ;AAIlD,MAAMC,UAAUF,cAAkC;IAChDG,cAAc;IACdC,aAAa;IACbC;QACE,IAAIC,QAAQC,GAAG,CAACC,QAAQ,KAAK,cAAc;YACzC,MAAM,IAAIC,MAAM;QAClB;IACF;AACF;AACAP,QAAQQ,WAAW,GAAG;AACtB,OAAO,MAAM,EAAEC,UAAUC,mBAAmB,EAAE,GAAGV,QAAQ;AAEzD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6EC,GACD,OAAO,SAASW;IACd,OAAOZ,WAAWC;AACpB"}

package/dist/theme/useColorSchemeMetaTag.d.ts

@@ -1,13 +1,13 @@
-import { type ColorScheme } from "./useColorScheme.js";
+import { type LightDarkColorScheme } from "./types.js";
 /**
- * @remarks \@since 6.0.0
+ * @since 6.0.0
  */
 export interface ColorSchemeMetaTagOptions {
     /**
      * @defaultValue `"false"`
      */
     disabled?: boolean;
-    colorScheme: ColorScheme;
+    colorScheme: LightDarkColorScheme;
 }
 /**
  * Adds a `<meta name="color-scheme" content="light">` or
@@ -15,6 +15,19 @@ export interface ColorSchemeMetaTagOptions {
  * should not be used if you are using the `useColorSchemeProvider` since it is
  * already built in.
  *
- * @remarks \@since 6.0.0
+ * @example
+ * ```tsx
+ * import { useColorScheme } from "@react-md/core/theme/useColorScheme";
+ * import { useColorSchemeMetaTag } from "@react-md/core/theme/useColorSchemeMetaTag";
+ *
+ * function Example() {
+ *   const { currentColor } = useColorScheme();
+ *   useColorSchemeMetaTag({ colorScheme: currentColor });
+ *
+ *   return null;
+ * }
+ * ```
+ *
+ * @since 6.0.0
  */
 export declare function useColorSchemeMetaTag(options: ColorSchemeMetaTagOptions): void;

package/dist/theme/useColorSchemeMetaTag.js

@@ -6,7 +6,20 @@ import { useEffect } from "react";
  * should not be used if you are using the `useColorSchemeProvider` since it is
  * already built in.
  *
- * @remarks \@since 6.0.0
+ * @example
+ * ```tsx
+ * import { useColorScheme } from "@react-md/core/theme/useColorScheme";
+ * import { useColorSchemeMetaTag } from "@react-md/core/theme/useColorSchemeMetaTag";
+ *
+ * function Example() {
+ *   const { currentColor } = useColorScheme();
+ *   useColorSchemeMetaTag({ colorScheme: currentColor });
+ *
+ *   return null;
+ * }
+ * ```
+ *
+ * @since 6.0.0
  */ export function useColorSchemeMetaTag(options) {
     const { disabled, colorScheme } = options;
     useEffect(()=>{

package/dist/theme/useColorSchemeMetaTag.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/theme/useColorSchemeMetaTag.ts"],"sourcesContent":["\"use client\";\nimport { useEffect } from \"react\";\nimport { type ColorScheme } from \"./useColorScheme.js\";\n\n/**\n * @remarks \\@since 6.0.0\n */\nexport interface ColorSchemeMetaTagOptions {\n  /**\n   * @defaultValue `\"false\"`\n   */\n  disabled?: boolean;\n  colorScheme: ColorScheme;\n}\n\n/**\n * Adds a `<meta name=\"color-scheme\" content=\"light\">` or\n * `<meta name=\"color-scheme\" content=\"dark\">` into the head element. This\n * should not be used if you are using the `useColorSchemeProvider` since it is\n * already built in.\n *\n * @remarks \\@since 6.0.0\n */\nexport function useColorSchemeMetaTag(\n  options: ColorSchemeMetaTagOptions\n): void {\n  const { disabled, colorScheme } = options;\n\n  useEffect(() => {\n    if (disabled || document.querySelector('meta[name=\"color-scheme\"]')) {\n      return;\n    }\n\n    // Adding the meta tag allows the default browser styles for form inputs to\n    // be updated as well.\n    //\n    // Chrome and Firefox:\n    // - the input type=\"number\"'s spinner color will update from grey to white\n    // - native `<select>` background color updates from grey/white to a dark color\n    //\n    // Chrome:\n    // - the date/time/datetime icons will change from black to white\n    // - the date/time/datetime pickers will use a darker theme instead of white\n    const meta = document.createElement(\"meta\");\n    meta.name = \"color-scheme\";\n    meta.content = colorScheme;\n    document.head.appendChild(meta);\n\n    return () => {\n      document.head.removeChild(meta);\n    };\n  }, [disabled, colorScheme]);\n}\n"],"names":["useEffect","useColorSchemeMetaTag","options","disabled","colorScheme","document","querySelector","meta","createElement","name","content","head","appendChild","removeChild"],"mappings":"AAAA;AACA,SAASA,SAAS,QAAQ,QAAQ;AAclC;;;;;;;CAOC,GACD,OAAO,SAASC,sBACdC,OAAkC;IAElC,MAAM,EAAEC,QAAQ,EAAEC,WAAW,EAAE,GAAGF;IAElCF,UAAU;QACR,IAAIG,YAAYE,SAASC,aAAa,CAAC,8BAA8B;YACnE;QACF;QAEA,2EAA2E;QAC3E,sBAAsB;QACtB,EAAE;QACF,sBAAsB;QACtB,2EAA2E;QAC3E,+EAA+E;QAC/E,EAAE;QACF,UAAU;QACV,iEAAiE;QACjE,4EAA4E;QAC5E,MAAMC,OAAOF,SAASG,aAAa,CAAC;QACpCD,KAAKE,IAAI,GAAG;QACZF,KAAKG,OAAO,GAAGN;QACfC,SAASM,IAAI,CAACC,WAAW,CAACL;QAE1B,OAAO;YACLF,SAASM,IAAI,CAACE,WAAW,CAACN;QAC5B;IACF,GAAG;QAACJ;QAAUC;KAAY;AAC5B"}
+{"version":3,"sources":["../../src/theme/useColorSchemeMetaTag.ts"],"sourcesContent":["\"use client\";\n\nimport { useEffect } from \"react\";\n\nimport { type LightDarkColorScheme } from \"./types.js\";\n\n/**\n * @since 6.0.0\n */\nexport interface ColorSchemeMetaTagOptions {\n  /**\n   * @defaultValue `\"false\"`\n   */\n  disabled?: boolean;\n  colorScheme: LightDarkColorScheme;\n}\n\n/**\n * Adds a `<meta name=\"color-scheme\" content=\"light\">` or\n * `<meta name=\"color-scheme\" content=\"dark\">` into the head element. This\n * should not be used if you are using the `useColorSchemeProvider` since it is\n * already built in.\n *\n * @example\n * ```tsx\n * import { useColorScheme } from \"@react-md/core/theme/useColorScheme\";\n * import { useColorSchemeMetaTag } from \"@react-md/core/theme/useColorSchemeMetaTag\";\n *\n * function Example() {\n *   const { currentColor } = useColorScheme();\n *   useColorSchemeMetaTag({ colorScheme: currentColor });\n *\n *   return null;\n * }\n * ```\n *\n * @since 6.0.0\n */\nexport function useColorSchemeMetaTag(\n  options: ColorSchemeMetaTagOptions\n): void {\n  const { disabled, colorScheme } = options;\n\n  useEffect(() => {\n    if (disabled || document.querySelector('meta[name=\"color-scheme\"]')) {\n      return;\n    }\n\n    // Adding the meta tag allows the default browser styles for form inputs to\n    // be updated as well.\n    //\n    // Chrome and Firefox:\n    // - the input type=\"number\"'s spinner color will update from grey to white\n    // - native `<select>` background color updates from grey/white to a dark color\n    //\n    // Chrome:\n    // - the date/time/datetime icons will change from black to white\n    // - the date/time/datetime pickers will use a darker theme instead of white\n    const meta = document.createElement(\"meta\");\n    meta.name = \"color-scheme\";\n    meta.content = colorScheme;\n    document.head.appendChild(meta);\n\n    return () => {\n      document.head.removeChild(meta);\n    };\n  }, [disabled, colorScheme]);\n}\n"],"names":["useEffect","useColorSchemeMetaTag","options","disabled","colorScheme","document","querySelector","meta","createElement","name","content","head","appendChild","removeChild"],"mappings":"AAAA;AAEA,SAASA,SAAS,QAAQ,QAAQ;AAelC;;;;;;;;;;;;;;;;;;;;CAoBC,GACD,OAAO,SAASC,sBACdC,OAAkC;IAElC,MAAM,EAAEC,QAAQ,EAAEC,WAAW,EAAE,GAAGF;IAElCF,UAAU;QACR,IAAIG,YAAYE,SAASC,aAAa,CAAC,8BAA8B;YACnE;QACF;QAEA,2EAA2E;QAC3E,sBAAsB;QACtB,EAAE;QACF,sBAAsB;QACtB,2EAA2E;QAC3E,+EAA+E;QAC/E,EAAE;QACF,UAAU;QACV,iEAAiE;QACjE,4EAA4E;QAC5E,MAAMC,OAAOF,SAASG,aAAa,CAAC;QACpCD,KAAKE,IAAI,GAAG;QACZF,KAAKG,OAAO,GAAGN;QACfC,SAASM,IAAI,CAACC,WAAW,CAACL;QAE1B,OAAO;YACLF,SAASM,IAAI,CAACE,WAAW,CAACN;QAC5B;IACF,GAAG;QAACJ;QAAUC;KAAY;AAC5B"}