@accelint/design-toolkit 9.3.0 → 9.4.0

package/dist/providers/theme-provider.d.ts

@@ -12,11 +12,12 @@
 
 import "client-only";
 import { PropsWithChildren } from "react";
-import * as react_jsx_runtime0 from "react/jsx-runtime";
+import * as react_jsx_runtime2 from "react/jsx-runtime";
 import { PartialDeep } from "type-fest";
 import { SemanticColorTokens, StaticColorTokens, ThemeTokens } from "@accelint/design-foundation/tokens/types";
 
 //#region src/providers/theme-provider.d.ts
+/** Theme mode for light or dark appearance */
 type ThemeMode = 'dark' | 'light';
 type ContextColorTokens = SemanticColorTokens & StaticColorTokens;
 type ThemeContextValue = {
@@ -30,12 +31,27 @@ type ThemeProviderProps = PropsWithChildren & {
   /** override existing values in the theme */
   overrides?: PartialDeep<ThemeTokens>;
 };
+/**
+ * Provides theme context with mode toggling and token overrides
+ *
+ * @param props - {@link ThemeProviderProps}
+ * @param props.children - Content to render within the theme context.
+ * @param props.defaultMode - Initial theme mode (defaults to 'dark').
+ * @param props.onChange - Callback when theme mode changes.
+ * @param props.overrides - Partial overrides for theme tokens.
+ * @returns The theme provider wrapping children.
+ */
 declare function ThemeProvider({
   children,
   defaultMode,
   onChange,
   overrides
-}: ThemeProviderProps): react_jsx_runtime0.JSX.Element;
+}: ThemeProviderProps): react_jsx_runtime2.JSX.Element;
+/**
+ * Access the current theme context
+ *
+ * @returns Theme context with mode, tokens, and toggleMode function.
+ */
 declare function useTheme(): ThemeContextValue;
 //#endregion
 export { ThemeMode, ThemeProvider, useTheme };

package/dist/providers/theme-provider.js

@@ -28,6 +28,16 @@ const ThemeContext = createContext({
 	},
 	toggleMode: (_mode) => {}
 });
+/**
+* Provides theme context with mode toggling and token overrides
+*
+* @param props - {@link ThemeProviderProps}
+* @param props.children - Content to render within the theme context.
+* @param props.defaultMode - Initial theme mode (defaults to 'dark').
+* @param props.onChange - Callback when theme mode changes.
+* @param props.overrides - Partial overrides for theme tokens.
+* @returns The theme provider wrapping children.
+*/
 function ThemeProvider({ children, defaultMode, onChange, overrides }) {
 	const [mode, setMode] = useState(defaultMode ?? "dark");
 	useEffect(() => {
@@ -56,6 +66,11 @@ function ThemeProvider({ children, defaultMode, onChange, overrides }) {
 		children
 	});
 }
+/**
+* Access the current theme context
+*
+* @returns Theme context with mode, tokens, and toggleMode function.
+*/
 function useTheme() {
 	return useContext(ThemeContext);
 }

package/dist/providers/theme-provider.js.map

@@ -1 +1 @@
-{"version":3,"file":"theme-provider.js","names":["tokens: ContextColorTokens","mode"],"sources":["../../src/providers/theme-provider.tsx"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\n'use client';\n\nimport 'client-only';\nimport { designTokens } from '@accelint/design-foundation/tokens';\nimport { assign } from 'radashi';\nimport {\n  createContext,\n  type PropsWithChildren,\n  useContext,\n  useEffect,\n  useMemo,\n  useState,\n} from 'react';\nimport type {\n  SemanticColorTokens,\n  StaticColorTokens,\n  ThemeTokens,\n} from '@accelint/design-foundation/tokens/types';\nimport type { PartialDeep } from 'type-fest';\n\nexport type ThemeMode = 'dark' | 'light';\ntype ContextColorTokens = SemanticColorTokens & StaticColorTokens;\n\ntype ThemeContextValue = {\n  mode: ThemeMode;\n  tokens: ContextColorTokens;\n  toggleMode: (mode: ThemeMode) => void;\n};\n/** provide default context value to avoid optional chaining and null checks on the client */\nconst defaultContextValue: ThemeContextValue = {\n  mode: 'dark',\n  tokens: { ...designTokens.dark, ...designTokens.static },\n  toggleMode: (_mode) => {\n    // no-op\n  },\n};\nconst ThemeContext = createContext<ThemeContextValue>(defaultContextValue);\n\ntype ThemeProviderProps = PropsWithChildren & {\n  defaultMode?: ThemeMode;\n  onChange?: (mode: ThemeMode) => void;\n  /** override existing values in the theme */\n  overrides?: PartialDeep<ThemeTokens>;\n};\n\nexport function ThemeProvider({\n  children,\n  defaultMode,\n  onChange,\n  overrides,\n}: ThemeProviderProps) {\n  const [mode, setMode] = useState<ThemeMode>(defaultMode ?? 'dark');\n\n  useEffect(() => {\n    if (document) {\n      const { documentElement } = document;\n      documentElement.classList.remove('dark', 'light');\n      documentElement.classList.add(mode);\n    }\n  }, [mode]);\n\n  const tokens: ContextColorTokens = useMemo(() => {\n    const tokensWithOverrides = assign(designTokens, overrides as ThemeTokens);\n    return {\n      ...tokensWithOverrides[mode],\n      ...tokensWithOverrides.static,\n    };\n  }, [mode, overrides]);\n\n  return (\n    <ThemeContext.Provider\n      value={{\n        mode,\n        tokens,\n        toggleMode: (mode: ThemeMode) => {\n          setMode(mode);\n          onChange?.(mode);\n        },\n      }}\n    >\n      {children}\n    </ThemeContext.Provider>\n  );\n}\n\nexport function useTheme() {\n  return useContext(ThemeContext);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAgDA,MAAM,eAAe,cAP0B;CAC7C,MAAM;CACN,QAAQ;EAAE,GAAG,aAAa;EAAM,GAAG,aAAa;EAAQ;CACxD,aAAa,UAAU;CAGxB,CACyE;AAS1E,SAAgB,cAAc,EAC5B,UACA,aACA,UACA,aACqB;CACrB,MAAM,CAAC,MAAM,WAAW,SAAoB,eAAe,OAAO;AAElE,iBAAgB;AACd,MAAI,UAAU;GACZ,MAAM,EAAE,oBAAoB;AAC5B,mBAAgB,UAAU,OAAO,QAAQ,QAAQ;AACjD,mBAAgB,UAAU,IAAI,KAAK;;IAEpC,CAAC,KAAK,CAAC;CAEV,MAAMA,SAA6B,cAAc;EAC/C,MAAM,sBAAsB,OAAO,cAAc,UAAyB;AAC1E,SAAO;GACL,GAAG,oBAAoB;GACvB,GAAG,oBAAoB;GACxB;IACA,CAAC,MAAM,UAAU,CAAC;AAErB,QACE,oBAAC,aAAa;EACZ,OAAO;GACL;GACA;GACA,aAAa,WAAoB;AAC/B,YAAQC,OAAK;AACb,eAAWA,OAAK;;GAEnB;EAEA;GACqB;;AAI5B,SAAgB,WAAW;AACzB,QAAO,WAAW,aAAa"}
+{"version":3,"file":"theme-provider.js","names":["tokens: ContextColorTokens","mode"],"sources":["../../src/providers/theme-provider.tsx"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\n'use client';\n\nimport 'client-only';\nimport { designTokens } from '@accelint/design-foundation/tokens';\nimport { assign } from 'radashi';\nimport {\n  createContext,\n  type PropsWithChildren,\n  useContext,\n  useEffect,\n  useMemo,\n  useState,\n} from 'react';\nimport type {\n  SemanticColorTokens,\n  StaticColorTokens,\n  ThemeTokens,\n} from '@accelint/design-foundation/tokens/types';\nimport type { PartialDeep } from 'type-fest';\n\n/** Theme mode for light or dark appearance */\nexport type ThemeMode = 'dark' | 'light';\ntype ContextColorTokens = SemanticColorTokens & StaticColorTokens;\n\ntype ThemeContextValue = {\n  mode: ThemeMode;\n  tokens: ContextColorTokens;\n  toggleMode: (mode: ThemeMode) => void;\n};\n/** provide default context value to avoid optional chaining and null checks on the client */\nconst defaultContextValue: ThemeContextValue = {\n  mode: 'dark',\n  tokens: { ...designTokens.dark, ...designTokens.static },\n  toggleMode: (_mode) => {\n    // no-op\n  },\n};\nconst ThemeContext = createContext<ThemeContextValue>(defaultContextValue);\n\ntype ThemeProviderProps = PropsWithChildren & {\n  defaultMode?: ThemeMode;\n  onChange?: (mode: ThemeMode) => void;\n  /** override existing values in the theme */\n  overrides?: PartialDeep<ThemeTokens>;\n};\n\n/**\n * Provides theme context with mode toggling and token overrides\n *\n * @param props - {@link ThemeProviderProps}\n * @param props.children - Content to render within the theme context.\n * @param props.defaultMode - Initial theme mode (defaults to 'dark').\n * @param props.onChange - Callback when theme mode changes.\n * @param props.overrides - Partial overrides for theme tokens.\n * @returns The theme provider wrapping children.\n */\nexport function ThemeProvider({\n  children,\n  defaultMode,\n  onChange,\n  overrides,\n}: ThemeProviderProps) {\n  const [mode, setMode] = useState<ThemeMode>(defaultMode ?? 'dark');\n\n  useEffect(() => {\n    if (document) {\n      const { documentElement } = document;\n      documentElement.classList.remove('dark', 'light');\n      documentElement.classList.add(mode);\n    }\n  }, [mode]);\n\n  const tokens: ContextColorTokens = useMemo(() => {\n    const tokensWithOverrides = assign(designTokens, overrides as ThemeTokens);\n    return {\n      ...tokensWithOverrides[mode],\n      ...tokensWithOverrides.static,\n    };\n  }, [mode, overrides]);\n\n  return (\n    <ThemeContext.Provider\n      value={{\n        mode,\n        tokens,\n        toggleMode: (mode: ThemeMode) => {\n          setMode(mode);\n          onChange?.(mode);\n        },\n      }}\n    >\n      {children}\n    </ThemeContext.Provider>\n  );\n}\n\n/**\n * Access the current theme context\n *\n * @returns Theme context with mode, tokens, and toggleMode function.\n */\nexport function useTheme() {\n  return useContext(ThemeContext);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAiDA,MAAM,eAAe,cAP0B;CAC7C,MAAM;CACN,QAAQ;EAAE,GAAG,aAAa;EAAM,GAAG,aAAa;EAAQ;CACxD,aAAa,UAAU;CAGxB,CACyE;;;;;;;;;;;AAmB1E,SAAgB,cAAc,EAC5B,UACA,aACA,UACA,aACqB;CACrB,MAAM,CAAC,MAAM,WAAW,SAAoB,eAAe,OAAO;AAElE,iBAAgB;AACd,MAAI,UAAU;GACZ,MAAM,EAAE,oBAAoB;AAC5B,mBAAgB,UAAU,OAAO,QAAQ,QAAQ;AACjD,mBAAgB,UAAU,IAAI,KAAK;;IAEpC,CAAC,KAAK,CAAC;CAEV,MAAMA,SAA6B,cAAc;EAC/C,MAAM,sBAAsB,OAAO,cAAc,UAAyB;AAC1E,SAAO;GACL,GAAG,oBAAoB;GACvB,GAAG,oBAAoB;GACxB;IACA,CAAC,MAAM,UAAU,CAAC;AAErB,QACE,oBAAC,aAAa;EACZ,OAAO;GACL;GACA;GACA,aAAa,WAAoB;AAC/B,YAAQC,OAAK;AACb,eAAWA,OAAK;;GAEnB;EAEA;GACqB;;;;;;;AAS5B,SAAgB,WAAW;AACzB,QAAO,WAAW,aAAa"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@accelint/design-toolkit",
   "description": "An open-source component library to serve as part of the entire ecosystem of UX for Accelint.",
-  "version": "9.3.0",
+  "version": "9.4.0",
   "author": "https://hypergiant.com",
   "$schema": "https://json.schemastore.org/package",
   "devDependencies": {
@@ -428,8 +428,8 @@
     "format:biome": "pnpm biome format . --write --verbose",
     "format:biome:check": "pnpm biome format . --verbose",
     "format:check": "pnpm format:biome:check && pnpm format:prettier:check",
-    "format:prettier": "pnpm prettier --write './**/*.css'",
-    "format:prettier:check": "pnpm prettier --check './**/*.css'",
+    "format:prettier": "pnpm prettier --write ./**/*.css",
+    "format:prettier:check": "pnpm prettier --check ./**/*.css",
     "index": "pnpm zx ../../scripts/indexer.mjs packages/design-toolkit",
     "license": "pnpm zx ../../scripts/license.mjs",
     "lint": "pnpm biome lint . --verbose",