@ufoui/core 0.0.12 → 0.0.58

package/types/theme.d.ts

@@ -1,211 +1,6 @@
-/**
- * Defines all color roles used in a single theme color scheme (e.g. light or dark).
- *
- * Based on the Material Design 3 palette structure with custom extensions
- * for semantic and system colors (e.g. info, success, warning).
- *
- * @remarks
- * Provides the canonical source for all `--uui-color-*` tokens in both light and dark modes.
- *
- * @category Theme
- */
-export interface ThemeScheme {
-    /** Primary brand color used for main UI elements. */
-    primary: string;
-    /** Foreground color displayed on primary. */
-    onPrimary: string;
-    /** Container background for primary content. */
-    primaryContainer: string;
-    /** Foreground color on primary container. */
-    onPrimaryContainer: string;
-    /** Fixed version of primary for consistent tone. */
-    primaryFixed: string;
-    /** Foreground color on primaryFixed. */
-    onPrimaryFixed: string;
-    /** Dimmed tone of primaryFixed. */
-    primaryFixedDim: string;
-    /** Variant tone for content on primaryFixedDim. */
-    onPrimaryFixedVariant: string;
-    /** Secondary color for less prominent accents. */
-    secondary: string;
-    /** Foreground color on secondary. */
-    onSecondary: string;
-    /** Background container using secondary tone. */
-    secondaryContainer: string;
-    /** Foreground color on secondary container. */
-    onSecondaryContainer: string;
-    /** Fixed version of secondary tone. */
-    secondaryFixed: string;
-    /** Foreground color on secondaryFixed. */
-    onSecondaryFixed: string;
-    /** Dimmed version of secondaryFixed. */
-    secondaryFixedDim: string;
-    /** Variant tone for content on secondaryFixedDim. */
-    onSecondaryFixedVariant: string;
-    /** Tertiary color for decorative or alternative accents. */
-    tertiary: string;
-    /** Foreground color on tertiary. */
-    onTertiary: string;
-    /** Background container using tertiary tone. */
-    tertiaryContainer: string;
-    /** Foreground color on tertiary container. */
-    onTertiaryContainer: string;
-    /** Fixed version of tertiary tone. */
-    tertiaryFixed: string;
-    /** Foreground color on tertiaryFixed. */
-    onTertiaryFixed: string;
-    /** Dimmed version of tertiaryFixed. */
-    tertiaryFixedDim: string;
-    /** Variant tone for content on tertiaryFixedDim. */
-    onTertiaryFixedVariant: string;
-    /** Warning tone for alerts or cautions. */
-    warning: string;
-    /** Foreground color on warning. */
-    onWarning: string;
-    /** Container color for warning messages. */
-    warningContainer: string;
-    /** Foreground color on warning container. */
-    onWarningContainer: string;
-    /** Fixed warning tone. */
-    warningFixed: string;
-    /** Foreground color on warningFixed. */
-    onWarningFixed: string;
-    /** Dimmed warningFixed variant. */
-    warningFixedDim: string;
-    /** Variant foreground color for dimmed warning. */
-    onWarningFixedVariant: string;
-    /** Informational tone for neutral messages. */
-    info: string;
-    /** Foreground color on info. */
-    onInfo: string;
-    /** Container background for info tone. */
-    infoContainer: string;
-    /** Foreground color on info container. */
-    onInfoContainer: string;
-    /** Fixed tone for info. */
-    infoFixed: string;
-    /** Foreground color on infoFixed. */
-    onInfoFixed: string;
-    /** Dimmed infoFixed variant. */
-    infoFixedDim: string;
-    /** Variant foreground color for dimmed info. */
-    onInfoFixedVariant: string;
-    /** Success tone for positive feedback. */
-    success: string;
-    /** Foreground color on success. */
-    onSuccess: string;
-    /** Container background for success tone. */
-    successContainer: string;
-    /** Foreground color on success container. */
-    onSuccessContainer: string;
-    /** Fixed success tone. */
-    successFixed: string;
-    /** Foreground color on successFixed. */
-    onSuccessFixed: string;
-    /** Dimmed successFixed variant. */
-    successFixedDim: string;
-    /** Variant foreground color for dimmed success. */
-    onSuccessFixedVariant: string;
-    /** Error tone for destructive actions or validation. */
-    error: string;
-    /** Foreground color on error. */
-    onError: string;
-    /** Container background for error tone. */
-    errorContainer: string;
-    /** Foreground color on error container. */
-    onErrorContainer: string;
-    /** Fixed error tone. */
-    errorFixed: string;
-    /** Foreground color on errorFixed. */
-    onErrorFixed: string;
-    /** Dimmed errorFixed variant. */
-    errorFixedDim: string;
-    /** Variant foreground color for dimmed error. */
-    onErrorFixedVariant: string;
-    /** Border and divider color. */
-    outline: string;
-    /** Secondary outline tone. */
-    outlineVariant: string;
-    /** Default surface background color. */
-    surface: string;
-    /** Foreground color on surface. */
-    onSurface: string;
-    /** Variant background tone for surfaces. */
-    surfaceVariant: string;
-    /** Foreground color on surfaceVariant. */
-    onSurfaceVariant: string;
-    /** UI background color. */
-    background: string;
-    /** Foreground color on background. */
-    onBackground: string;
-    /** Inverse surface tone (e.g. for bottom navs). */
-    inverseSurface: string;
-    /** Foreground color on inverse surface. */
-    inverseOnSurface: string;
-    /** Primary accent used on inverse surfaces. */
-    inversePrimary: string;
-    /** Color used for shadows and elevation. */
-    shadow: string;
-    /** Tint overlay for elevated components. */
-    surfaceTint: string;
-    /** Overlay color for modals, drawers, etc. */
-    scrim: string;
-    /** Surface tone for highest-level containers. */
-    surfaceContainerHighest: string;
-    /** Surface tone for high elevation containers. */
-    surfaceContainerHigh: string;
-    /** Base tone for standard surface containers. */
-    surfaceContainer: string;
-    /** Surface tone for low elevation containers. */
-    surfaceContainerLow: string;
-    /** Surface tone for lowest elevation containers. */
-    surfaceContainerLowest: string;
-    /** Brightest surface tone variant. */
-    surfaceBright: string;
-    /** Dimmed surface tone variant. */
-    surfaceDim: string;
-    /** Pure black color used for contrast or background. */
-    black: string;
-    /** Foreground color displayed on black (typically white). */
-    onBlack: string;
-    /** Pure white color used for contrast or foreground. */
-    white: string;
-    /** Foreground color displayed on white (typically black). */
-    onWhite: string;
-    /** Allows for additional custom tokens. */
-    [key: string]: string;
-}
-/**
- * A partial version of {@link ThemeScheme}, used for theme overrides
- * or gradual, progressive theming updates.
- *
- * @remarks
- * Useful when defining incomplete color sets (e.g. custom brand palettes).
- *
- * @category Theme
- */
-export type PartialThemeScheme = Partial<ThemeScheme>;
-/**
- * Collection of named color schemes (e.g. light, dark, high-contrast).
- * Used to organize multiple theme modes within a design system.
- *
- * @category Theme
- */
-export interface ThemeSchemes {
-    /** Light mode color scheme. */
-    light: PartialThemeScheme;
-    /** Dark mode color scheme. */
-    dark: PartialThemeScheme;
-    /** Additional custom schemes such as high-contrast or sepia. */
-    [key: string]: PartialThemeScheme;
-}
-/**
- * Partial variant of {@link ThemeSchemes}, allowing selective definition
- * of available color modes.
- *
- * @category Theme
- */
-export type PartialThemeSchemes = Partial<ThemeSchemes>;
+import { ThemeBreakpoints } from './breakpoints';
+import { ThemeFonts } from './fonts';
+import { ThemeColorSchemes } from './color';
 /**
  * Defines the overall theme configuration, including
  * the active mode and all available color schemes.
@@ -216,31 +11,9 @@ export interface Theme {
     /** Indicates whether dark mode is currently active. */
     darkMode: boolean;
     /** Collection of all available color schemes. */
-    schemes: ThemeSchemes;
+    schemes: ThemeColorSchemes;
+    /** Responsive breakpoint tokens. */
+    breakpoints: ThemeBreakpoints;
+    /** Font class map keyed by theme font token name. */
+    fonts: ThemeFonts;
 }
-/**
- * Core subset of theme colors representing primary semantic intents
- * (e.g., primary, error, success).
- * Commonly referenced across UI components.
- *
- * Serves as the base for {@link SemanticColor} and {@link ThemeSchemeKeys}.
- *
- * @category Theme
- */
-export declare const ThemeSemanticColorKeys: readonly ["primary", "secondary", "tertiary", "warning", "info", "success", "error"];
-/**
- * Extended set of semantic theme colors.
- * @category Theme
- */
-export declare const ThemeExtendedColorKeys: readonly ["primary", "secondary", "tertiary", "warning", "info", "success", "error", "primaryContainer", "primaryFixed", "primaryFixedDim", "secondaryContainer", "secondaryFixed", "secondaryFixedDim", "tertiaryContainer", "tertiaryFixed", "tertiaryFixedDim", "warningContainer", "warningFixed", "warningFixedDim", "infoContainer", "infoFixed", "infoFixedDim", "successContainer", "successFixed", "successFixedDim", "errorContainer", "errorFixed", "errorFixedDim", "black", "white"];
-/**
- * Surface-level theme colors including extended and neutral tones.
- * @category Theme
- */
-export declare const ThemeSurfaceColorKeys: readonly ["primary", "secondary", "tertiary", "warning", "info", "success", "error", "primaryContainer", "primaryFixed", "primaryFixedDim", "secondaryContainer", "secondaryFixed", "secondaryFixedDim", "tertiaryContainer", "tertiaryFixed", "tertiaryFixedDim", "warningContainer", "warningFixed", "warningFixedDim", "infoContainer", "infoFixed", "infoFixedDim", "successContainer", "successFixed", "successFixedDim", "errorContainer", "errorFixed", "errorFixedDim", "black", "white", "outline", "outlineVariant", "surface", "surfaceVariant", "background", "inverseSurface", "inversePrimary", "surfaceContainerHighest", "surfaceContainerHigh", "surfaceContainer", "surfaceContainerLow", "surfaceContainerLowest", "surfaceBright", "surfaceDim"];
-/**
- * Complete set of color tokens defined in {@link ThemeScheme}.
- * Combines all semantic, extended, and surface color roles for full theme coverage.
- * @category Theme
- */
-export declare const ThemeSchemeKeys: readonly ["primary", "secondary", "tertiary", "warning", "info", "success", "error", "primaryContainer", "primaryFixed", "primaryFixedDim", "secondaryContainer", "secondaryFixed", "secondaryFixedDim", "tertiaryContainer", "tertiaryFixed", "tertiaryFixedDim", "warningContainer", "warningFixed", "warningFixedDim", "infoContainer", "infoFixed", "infoFixedDim", "successContainer", "successFixed", "successFixedDim", "errorContainer", "errorFixed", "errorFixedDim", "black", "white", "outline", "outlineVariant", "surface", "surfaceVariant", "background", "inverseSurface", "inversePrimary", "surfaceContainerHighest", "surfaceContainerHigh", "surfaceContainer", "surfaceContainerLow", "surfaceContainerLowest", "surfaceBright", "surfaceDim", "onPrimary", "onPrimaryContainer", "onPrimaryFixed", "onPrimaryFixedVariant", "onSecondary", "onSecondaryContainer", "onSecondaryFixed", "onSecondaryFixedVariant", "onTertiary", "onTertiaryContainer", "onTertiaryFixed", "onTertiaryFixedVariant", "onWarning", "onWarningContainer", "onWarningFixed", "onWarningFixedVariant", "onInfo", "onInfoContainer", "onInfoFixed", "onInfoFixedVariant", "onSuccess", "onSuccessContainer", "onSuccessFixed", "onSuccessFixedVariant", "onError", "onErrorContainer", "onErrorFixed", "onErrorFixedVariant", "onSurface", "onSurfaceVariant", "onBackground", "inverseOnSurface", "inversePrimary", "shadow", "surfaceTint", "scrim"];

package/utils/applyThemeColors.d.ts

@@ -0,0 +1,10 @@
+import { ThemeColorSchemes } from '../types';
+/**
+ * Applies resolved theme tokens as CSS custom properties.
+ *
+ * @param schemes - Fully resolved theme schemes.
+ * @returns The same input object for convenient chaining.
+ *
+ * @category Theme
+ */
+export declare function applyThemeColors(schemes: ThemeColorSchemes): ThemeColorSchemes;

package/utils/breakpoints/breakpoint.d.ts

@@ -0,0 +1,59 @@
+import { ThemeBreakpoints } from '../../types';
+/**
+ * Viewport snapshot used by the breakpoint store.
+ *
+ * @category Breakpoints
+ */
+export type ViewportSnapshot = {
+    width: number;
+    isPrint: boolean;
+};
+type BreakpointEntry = {
+    key: string;
+    minWidth: number;
+};
+/**
+ * Converts a CSS length value to pixels.
+ *
+ * Supports `px`, `rem`, and unitless numeric strings.
+ *
+ * @function
+ * @param value CSS length value to convert.
+ *
+ * @category Breakpoints
+ */
+export declare const toPx: (value: string) => number;
+/**
+ * Returns the ordered list of theme breakpoints sorted by width.
+ *
+ * @function
+ * @param breakpoints Breakpoint map from the active theme.
+ *
+ * @category Breakpoints
+ */
+export declare const getOrderedBreakpoints: (breakpoints: ThemeBreakpoints) => BreakpointEntry[];
+/**
+ * Resolves the active breakpoint key for a viewport width.
+ *
+ * @function
+ * @param breakpoints Ordered breakpoint entries.
+ * @param width Current viewport width.
+ *
+ * @category Breakpoints
+ */
+export declare const resolveBreakpoint: (breakpoints: BreakpointEntry[], width: number) => string;
+/**
+ * Resolves a responsive value map against the current viewport state.
+ *
+ * @function
+ * @param values Responsive values keyed by breakpoint.
+ * @param breakpoints Ordered breakpoint entries.
+ * @param snapshot Current viewport snapshot.
+ *
+ * @category Breakpoints
+ */
+export declare const resolveResponsiveValue: <T>(values: {
+    base?: T;
+    print?: T;
+} & Record<string, T | undefined>, breakpoints: BreakpointEntry[], snapshot: ViewportSnapshot) => T | undefined;
+export {};

package/utils/breakpoints/breakpointStore.d.ts

@@ -0,0 +1,32 @@
+import { ViewportSnapshot } from './breakpoint';
+/**
+ * Subscriber function used by the breakpoint store.
+ *
+ * @category Hooks
+ */
+export type BreakpointStoreSubscriber = () => void;
+/**
+ * Shared viewport store used by responsive hooks.
+ *
+ * @category Hooks
+ */
+export declare const breakpointStore: {
+    /**
+     * Subscribes to viewport state updates.
+     *
+     * @function
+     */
+    subscribe(listener: BreakpointStoreSubscriber): () => void;
+    /**
+     * Returns the current viewport snapshot.
+     *
+     * @function
+     */
+    getSnapshot(): ViewportSnapshot;
+    /**
+     * Returns the server-side fallback snapshot.
+     *
+     * @function
+     */
+    getServerSnapshot(): ViewportSnapshot;
+};

package/utils/breakpoints/index.d.ts

@@ -0,0 +1,2 @@
+export * from './breakpoint';
+export * from './breakpointStore';

package/utils/calculateFloatingPosition.d.ts

@@ -1,5 +1,5 @@
 import { RefObject } from 'react';
-import { ElementAlign } from './utils';
+import { ElementPlacement } from './utils';
 /**
  * Floating behavior presets used by `calculateFloatingPosition()`.
  *
@@ -23,7 +23,7 @@ export type ElementFloatingMode = 'tooltip' | 'dropdown' | 'menu' | 'submenu';
  * @category Utils
  */
 export interface CalculateFloatingPositionOptions {
-    placement?: ElementAlign;
+    placement?: ElementPlacement;
     offset?: number;
     mode?: ElementFloatingMode;
 }
@@ -39,7 +39,7 @@ export interface CalculateFloatingPositionOptions {
 export interface ElementFloatingPosition {
     x: number;
     y: number;
-    placement: ElementAlign;
+    placement: ElementPlacement;
 }
 /**
  * Computes the optimal on-screen position for tooltips, dropdowns, menus and submenus.

package/utils/color.d.ts

@@ -1,158 +1,19 @@
-import { ThemeExtendedColorKeys, ThemeSchemeKeys, ThemeSemanticColorKeys, ThemeSurfaceColorKeys } from '../types';
+import { BaseColor, BorderColor, ExtendedColor, SemanticColor, SurfaceColor, ThemeColor } from '../types';
+export type { CoreSemanticColor, CoreSurfaceColor, CoreThemeColor, CustomColors, SemanticBaseColor, OnColor, SemanticColor, ExtendedColor, OnExtendedColor, SurfaceColor, BaseColor, ThemeColor, BorderColor, } from '../types';
+export declare function getOnColorName(colorName: ThemeColor): ThemeColor | undefined;
 /**
- * Represents a high-level semantic color token (e.g. `primary`, `error`, `success`).
- * Derived from {@link ThemeSemanticColorKeys}.
- * @category Color
- */
-export type SemanticColor = (typeof ThemeSemanticColorKeys)[number];
-/**
- * Represents tokens extending the {@link SemanticColor} set
- * with additional container and fixed variants.
- * Derived from {@link ThemeExtendedColorKeys}.
- * @category Color
- */
-export type ExtendedColor = (typeof ThemeExtendedColorKeys)[number];
-/**
- * Represents surface-related color tokens extending {@link ExtendedColor},
- * including background, outline, and container surface roles.
- * Derived from {@link ThemeSurfaceColorKeys}.
- * @category Color
- */
-export type SurfaceColor = (typeof ThemeSurfaceColorKeys)[number];
-/**
- * Represents any valid color token defined in the theme,
- * including semantic, extended, and surface roles.
- * Derived from {@link ThemeSchemeKeys}.
- * @category Color
- */
-export type ThemeColor = (typeof ThemeSchemeKeys)[number];
-/**
- * Generates utility class names (`uui-*`) for a given **semantic color** and its variants.
- *
- * @remarks
- * Produces `text`, `border`, and `background` class names for a semantic color and its
- * derived tokens (`on`, `container`, `fixed`, `fixedDim`, etc.).
- * If the provided key is invalid, `'primary'` is used as fallback.
- *
- * All class names follow the pattern `uui-{type}-{kebab-case-color}`.
+ * Returns all color names from the global registry for the selected type.
  *
- * @param color - Semantic color name (e.g. `'primary'`, `'error'`, `'success'`).
- * @returns Object with `uui-text-*`, `uui-border-*`, and `uui-bg-*` class names for all variants.
- *
- * @example
- * ```ts
- * getSemanticColorClasses('primary');
- * // → { textColor: 'uui-text-primary', bgOnColor: 'uui-bg-on-primary', ... }
- * ```
- * @category Color
- */
-export declare const getSemanticColorClasses: (color: SemanticColor) => {
-    textColor: string;
-    borderColor: string;
-    bgColor: string;
-    textOnColor: string;
-    borderOnColor: string;
-    bgOnColor: string;
-    textContainer: string;
-    borderContainer: string;
-    bgContainer: string;
-    textOnContainer: string;
-    borderOnContainer: string;
-    bgOnContainer: string;
-    textFixed: string;
-    borderFixed: string;
-    bgFixed: string;
-    textOnFixed: string;
-    borderOnFixed: string;
-    bgOnFixed: string;
-    textFixedDim: string;
-    borderFixedDim: string;
-    bgFixedDim: string;
-    textOnFixedVariant: string;
-    borderOnFixedVariant: string;
-    bgOnFixedVariant: string;
-};
-/**
- * Bidirectional mapping between theme colors and their “on” counterparts.
- *
- * @remarks
- * Provides both directions — e.g. `'surface' → 'onSurface'` and `'onSurface' → 'surface'` —
- * for all semantic, extended, and surface tokens defined in {@link ThemeColor}.
- * Enables consistent inverse lookups for text/background pairings.
- *
- *
- * @category Color
- */
-export declare const inverseColorMap: {
-    readonly surface: "onSurface";
-    readonly surfaceVariant: "onSurfaceVariant";
-    readonly surfaceContainerLowest: "onSurface";
-    readonly surfaceContainerLow: "onSurface";
-    readonly surfaceContainer: "onSurface";
-    readonly surfaceContainerHigh: "onSurface";
-    readonly surfaceContainerHighest: "onSurface";
-    readonly surfaceDim: "onSurface";
-    readonly surfaceBright: "onSurface";
-    readonly background: "onBackground";
-    readonly inverseSurface: "inverseOnSurface";
-    readonly primary: "onPrimary";
-    readonly secondary: "onSecondary";
-    readonly tertiary: "onTertiary";
-    readonly warning: "onWarning";
-    readonly info: "onInfo";
-    readonly success: "onSuccess";
-    readonly error: "onError";
-    readonly primaryContainer: "onPrimaryContainer";
-    readonly primaryFixed: "onPrimaryFixed";
-    readonly primaryFixedDim: "onPrimaryFixedVariant";
-    readonly secondaryContainer: "onSecondaryContainer";
-    readonly secondaryFixed: "onSecondaryFixed";
-    readonly secondaryFixedDim: "onSecondaryFixedVariant";
-    readonly tertiaryContainer: "onTertiaryContainer";
-    readonly tertiaryFixed: "onTertiaryFixed";
-    readonly tertiaryFixedDim: "onTertiaryFixedVariant";
-    readonly warningContainer: "onWarningContainer";
-    readonly warningFixed: "onWarningFixed";
-    readonly warningFixedDim: "onWarningFixedVariant";
-    readonly infoContainer: "onInfoContainer";
-    readonly infoFixed: "onInfoFixed";
-    readonly infoFixedDim: "onInfoFixedVariant";
-    readonly successContainer: "onSuccessContainer";
-    readonly successFixed: "onSuccessFixed";
-    readonly successFixedDim: "onSuccessFixedVariant";
-    readonly errorContainer: "onErrorContainer";
-    readonly errorFixed: "onErrorFixed";
-    readonly errorFixedDim: "onErrorFixedVariant";
-    readonly outline: "surface";
-    readonly outlineVariant: "inverseSurface";
-    readonly inversePrimary: "onPrimaryContainer";
-    readonly black: "white";
-    readonly white: "black";
-    readonly onSurface: "surface";
-    readonly onSurfaceVariant: "surfaceVariant";
-    readonly onBackground: "background";
-    readonly inverseOnSurface: "inverseSurface";
-    readonly onPrimary: "primary";
-    readonly onSecondary: "secondary";
-    readonly onTertiary: "tertiary";
-    readonly onWarning: "warning";
-    readonly onInfo: "info";
-    readonly onSuccess: "success";
-    readonly onError: "error";
-    readonly onPrimaryContainer: "primaryContainer";
-    readonly onSecondaryContainer: "secondaryContainer";
-    readonly onTertiaryContainer: "tertiaryContainer";
-    readonly onWarningContainer: "warningContainer";
-    readonly onInfoContainer: "infoContainer";
-    readonly onSuccessContainer: "successContainer";
-    readonly onErrorContainer: "errorContainer";
-};
-/**
- * Represents the available border color options.
- *
- * @category Color
+ * @param type - Color type to filter by.
+ * @returns List of color names matching the requested type.
+ * @category Theme
  */
-export type BorderColor = SurfaceColor;
+export declare function getColorNames(type: 'semantic'): SemanticColor[];
+export declare function getColorNames(type: 'extended'): ExtendedColor[];
+export declare function getColorNames(type: 'surface'): SurfaceColor[];
+export declare function getColorNames(type: 'theme'): ThemeColor[];
+export declare function getColorNames(type: 'base'): BaseColor[];
+export declare function getColorNames(type: 'border'): BorderColor[];
 /**
  * Returns basic CSS variable references for a **surface color**.
  *
@@ -171,7 +32,7 @@ export type BorderColor = SurfaceColor;
  * ```
  * @category Color
  */
-export declare const getSurfaceColorVar: (color: SurfaceColor) => {
+export declare const getSurfaceColorVar: (color: BaseColor) => {
     color: string;
     onColor: string;
 };

package/utils/colorRegistry.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Runtime color type used by the generated color registry.
+ *
+ * @category Theme
+ */
+export type ColorType = 'semantic' | 'surface' | 'extended' | 'base' | 'border' | 'theme';
+/**
+ * Metadata entry describing how a color name should be used.
+ *
+ * @category Theme
+ */
+export interface ColorRegistryEntry {
+    /** Usage type assigned to the color name. */
+    type: ColorType;
+    /** Paired contrast color name (e.g. `primary` -> `onPrimary`). */
+    onColor?: string;
+}
+/**
+ * Global color registry keyed by theme color names.
+ *
+ * @category Theme
+ */
+export type ColorRegistry = Record<string, ColorRegistryEntry | undefined>;
+/**
+ * Replaces the global color registry.
+ *
+ * @param registry - New registry produced by theme generation.
+ * @category Theme
+ */
+export declare function setColorRegistry(registry: ColorRegistry): void;
+/**
+ * Returns the current global color registry.
+ *
+ * @returns The last registry set by theme generation.
+ * @category Theme
+ */
+export declare function getColorRegistry(): ColorRegistry;

package/utils/controlStyle.d.ts

@@ -1,5 +1,5 @@
 import { default as React } from 'react';
-import { SemanticColor, SurfaceColor, ThemeColor } from './color';
+import { BaseColor, SemanticColor, ThemeColor } from './color';
 /**
  * Creates a strictly typed style builder for MD3 color tokens.
  *
@@ -9,49 +9,49 @@ type CSSPropertyKey = Extract<keyof React.CSSProperties, string>;
 type CSSVar = `--${string}`;
 export declare function ControlStyle(initial?: React.CSSProperties): {
     bg: ((color?: ThemeColor) => void) & {
-        on(color?: SurfaceColor): void;
+        on(color?: BaseColor): void;
         container(color?: SemanticColor): void;
         onContainer(color?: SemanticColor): void;
         fixed(color?: SemanticColor): void;
         fixedDim(color?: SemanticColor): void;
     };
     text: ((color?: ThemeColor) => void) & {
-        on(color?: SurfaceColor): void;
+        on(color?: BaseColor): void;
         container(color?: SemanticColor): void;
         onContainer(color?: SemanticColor): void;
         fixed(color?: SemanticColor): void;
         fixedDim(color?: SemanticColor): void;
     };
     border: ((color?: ThemeColor) => void) & {
-        on(color?: SurfaceColor): void;
+        on(color?: BaseColor): void;
         container(color?: SemanticColor): void;
         onContainer(color?: SemanticColor): void;
         fixed(color?: SemanticColor): void;
         fixedDim(color?: SemanticColor): void;
     };
     outline: ((color?: ThemeColor) => void) & {
-        on(color?: SurfaceColor): void;
+        on(color?: BaseColor): void;
         container(color?: SemanticColor): void;
         onContainer(color?: SemanticColor): void;
         fixed(color?: SemanticColor): void;
         fixedDim(color?: SemanticColor): void;
     };
     current: ((color?: ThemeColor) => void) & {
-        on(color?: SurfaceColor): void;
+        on(color?: BaseColor): void;
         container(color?: SemanticColor): void;
         onContainer(color?: SemanticColor): void;
         fixed(color?: SemanticColor): void;
         fixedDim(color?: SemanticColor): void;
     };
     stroke: ((color?: ThemeColor) => void) & {
-        on(color?: SurfaceColor): void;
+        on(color?: BaseColor): void;
         container(color?: SemanticColor): void;
         onContainer(color?: SemanticColor): void;
         fixed(color?: SemanticColor): void;
         fixedDim(color?: SemanticColor): void;
     };
     fill: ((color?: ThemeColor) => void) & {
-        on(color?: SurfaceColor): void;
+        on(color?: BaseColor): void;
         container(color?: SemanticColor): void;
         onContainer(color?: SemanticColor): void;
         fixed(color?: SemanticColor): void;