@ufoui/core 0.0.12 → 0.0.40

package/internal/icon/icon.d.ts

@@ -0,0 +1,28 @@
+import { ReactNode } from 'react';
+import { SurfaceColor } from '../../utils';
+/**
+ * Props for the {@link Icon} wrapper.
+ *
+ * @category Internal components
+ */
+export interface IconProps {
+    /** Icon graphic or element rendered inside the wrapper. */
+    icon: ReactNode;
+    /** Additional class names merged with the base `uui-icon` token. */
+    className?: string;
+    /** Theme surface token as CSS `color` (for `currentColor` SVG). */
+    color?: SurfaceColor;
+}
+/**
+ * Renders icon content with the shared `uui-icon` layout class.
+ *
+ *
+ * @function
+ * @param props Component properties.
+ *
+ * @category Internal components
+ */
+export declare const Icon: {
+    ({ icon, className, color }: IconProps): import("react/jsx-runtime").JSX.Element | null;
+    displayName: string;
+};

package/internal/index.d.ts

@@ -4,3 +4,4 @@ export * from './stateLayer/stateLayer';
 export * from './controlGrid/controlGrid';
 export * from './controlLabel/controlLabel';
 export * from './description/description';
+export * from './icon/icon';

package/internal/inlineTooltip/inlineTooltipManager.d.ts

@@ -1,12 +1,12 @@
 import { default as React, HTMLProps, ReactElement } from 'react';
-import { ElementAlign } from '../../utils';
+import { ElementPlacement } from '../../utils';
 interface InlineTooltipManagerProps extends HTMLProps<HTMLSpanElement> {
     triggerRef: React.RefObject<HTMLElement>;
     tooltip: ReactElement;
-    align: ElementAlign;
+    align: ElementPlacement;
 }
 export declare const InlineTooltipManager: {
-    ({ tooltip, align, triggerRef }: InlineTooltipManagerProps): React.ReactPortal;
+    ({ tooltip, align, triggerRef }: InlineTooltipManagerProps): React.ReactPortal | null;
     displayName: string;
 };
 export {};

package/internal/slots/slot.d.ts

@@ -22,7 +22,7 @@ interface SlotProps {
  *
  * @category Slot
  */
-export declare const Slot: ({ start, end, content, className }: SlotProps) => import("react/jsx-runtime").JSX.Element;
+export declare const Slot: ({ start, end, content, className }: SlotProps) => import("react/jsx-runtime").JSX.Element | null;
 /**
  * Slot wrapper for leading content.
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ufoui/core",
-  "version": "0.0.12",
+  "version": "0.0.40",
   "description": "Lightweight Material Design 3 UI components for React",
   "type": "module",
   "main": "./index.mjs",

package/types/dialog.d.ts

@@ -0,0 +1,37 @@
+import { MotionAnimation } from './motion';
+/**
+ * Layout mode for the DialogBase component.
+ *
+ * @remarks
+ * Determines dialog placement and sizing:
+ * - `'basic'` - centered dialog
+ * - `'fullscreen'` - full viewport
+ * - `'dockLeft'` / `'dockRight'` / `'dockTop'` / `'dockBottom'` -  edge-docked panels
+ *
+ * @category Dialog
+ */
+export type DialogType = 'basic' | 'fullscreen' | 'dockRight' | 'dockLeft' | 'dockTop' | 'dockBottom';
+/**
+ * Animation preset for open and close transitions.
+ *
+ * @remarks
+ * Use `'none'` to disable motion. Otherwise uses a {@link MotionAnimation} value.
+ * When omitted, a default animation is chosen for the current layout mode.
+ *
+ * @category Dialog
+ */
+export type DialogAnimation = 'none' | MotionAnimation;
+/**
+ * Icon slot within dialog layout.
+ *
+ * Defines where the icon is rendered inside the dialog structure.
+ *
+ * Slots:
+ * - **leading** – inline with the title
+ * - **top** – placed above the title in the header
+ * - **contentLeft** – placed on the left side of the content area
+ * - **contentRight** – placed on the right side of the content area
+ *
+ * @category Dialog
+ */
+export type DialogIconSlot = 'leading' | 'top' | 'contentLeft' | 'contentRight';

package/types/index.d.ts

@@ -1,2 +1,3 @@
 export * from './theme';
 export * from './motion';
+export * from './dialog';

package/types/motion.d.ts

@@ -2,9 +2,9 @@ export type MotionAnimation = 'fade' | 'fadeBlur' | 'scale' | 'scaleBlur' | 'pop
 export declare const motionClassMap: Record<MotionAnimation, string>;
 /**
  * Returns CSS class name for given motion animation.
- * Returns empty string when animation is not defined.
+ * Returns empty string when animation is not defined or set to 'none'.
  */
-export declare function getAnimationClass(animation?: MotionAnimation): string;
+export declare function getAnimationClass(animation?: MotionAnimation | 'none'): string;
 /**
  * Returns list of available motion animation names.
  */

package/types/theme.d.ts

@@ -166,12 +166,8 @@ export interface ThemeScheme {
     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;
 }
@@ -218,29 +214,3 @@ export interface Theme {
     /** Collection of all available color schemes. */
     schemes: ThemeSchemes;
 }
-/**
- * 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/applyThemeTokens.d.ts

@@ -0,0 +1,10 @@
+import { ThemeSchemes } 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 applyThemeTokens(schemes: ThemeSchemes): ThemeSchemes;

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,105 @@
-import { ThemeExtendedColorKeys, ThemeSchemeKeys, ThemeSemanticColorKeys, ThemeSurfaceColorKeys } from '../types';
 /**
- * Represents a high-level semantic color token (e.g. `primary`, `error`, `success`).
- * Derived from {@link ThemeSemanticColorKeys}.
+ * Built-in semantic color names available in every theme.
+ *
  * @category Color
  */
-export type SemanticColor = (typeof ThemeSemanticColorKeys)[number];
+export type CoreSemanticColor = 'primary' | 'secondary' | 'tertiary' | 'warning' | 'info' | 'success' | 'error';
 /**
- * Represents tokens extending the {@link SemanticColor} set
- * with additional container and fixed variants.
- * Derived from {@link ThemeExtendedColorKeys}.
+ * Built-in surface color names intended for backgrounds, layers, and outlines.
+ *
  * @category Color
  */
-export type ExtendedColor = (typeof ThemeExtendedColorKeys)[number];
+export type CoreSurfaceColor = 'surface' | 'surfaceVariant' | 'background' | 'inverseSurface' | 'outline' | 'outlineVariant' | 'surfaceContainerLowest' | 'surfaceContainerLow' | 'surfaceContainer' | 'surfaceContainerHigh' | 'surfaceContainerHighest' | 'surfaceBright' | 'surfaceDim';
 /**
- * Represents surface-related color tokens extending {@link ExtendedColor},
- * including background, outline, and container surface roles.
- * Derived from {@link ThemeSurfaceColorKeys}.
+ * Built-in technical color names not intended for direct usage.
+ *
  * @category Color
  */
-export type SurfaceColor = (typeof ThemeSurfaceColorKeys)[number];
+export type CoreThemeColor = 'onSurface' | 'onSurfaceVariant' | 'onBackground' | 'inverseOnSurface' | 'inversePrimary' | 'surfaceTint' | 'scrim' | 'shadow' | 'black' | 'white';
+/** * Empty custom-color map used as the default generic parameter. * * @category Color */
+export type EmptyColors = Record<never, never>;
 /**
- * Represents any valid color token defined in the theme,
- * including semantic, extended, and surface roles.
- * Derived from {@link ThemeSchemeKeys}.
+ * Augmentation point for custom semantic colors.
+ *
+ * @example
+ * declare module '@ufoui/core' {
+ *   interface CustomColors {
+ *     myBlue: true;
+ *   }
+ * }
+ *
  * @category Color
  */
-export type ThemeColor = (typeof ThemeSchemeKeys)[number];
+export interface CustomColors {
+}
 /**
- * Generates utility class names (`uui-*`) for a given **semantic color** and its variants.
+ * Base semantic color (core + augmented).
  *
- * @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.
+ * @category Color
+ */
+export type SemanticBaseColor = CoreSemanticColor | keyof CustomColors;
+/**
+ * Builds `on*` color name.
  *
- * All class names follow the pattern `uui-{type}-{kebab-case-color}`.
+ * @category Color
+ */
+export type OnColor<T extends string> = `on${Capitalize<T>}`;
+/**
+ * Semantic color used in component APIs.
  *
- * @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.
+ * @category Color
+ */
+export type SemanticColor = SemanticBaseColor;
+/**
+ * Extended semantic colors.
  *
- * @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;
-};
+export type ExtendedColor = `${SemanticBaseColor}Container` | `${SemanticBaseColor}Fixed` | `${SemanticBaseColor}FixedDim`;
 /**
- * Bidirectional mapping between theme colors and their “on” counterparts.
+ * `on*` counterparts for extended colors.
  *
- * @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";
-};
+ * @category Color
+ */
+export type OnExtendedColor = OnColor<`${SemanticBaseColor}Container`> | OnColor<`${SemanticBaseColor}Fixed`> | OnColor<`${SemanticBaseColor}FixedVariant`>;
+/**
+ * Surface colors.
+ *
+ * @category Color
+ */
+export type SurfaceColor = CoreSurfaceColor | ExtendedColor;
 /**
- * Represents the available border color options.
+ * Colors allowed in component props.
  *
  * @category Color
  */
-export type BorderColor = SurfaceColor;
+export type BaseColor = SemanticColor | SurfaceColor;
+/**
+ * Full theme color set.
+ *
+ * @category Color
+ */
+export type ThemeColor = BaseColor | OnColor<SemanticBaseColor> | OnExtendedColor | CoreThemeColor;
+/**
+ * Border color.
+ *
+ * @category Color
+ */
+export type BorderColor = BaseColor;
+export declare function getOnColorName(colorName: ThemeColor): ThemeColor | undefined;
+/**
+ * Returns all color names from the global registry for the selected type.
+ *
+ * @param type - Color type to filter by.
+ * @returns List of color names matching the requested type.
+ * @category Theme
+ */
+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 +118,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,44 @@
+/**
+ * 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;
+/**
+ * Resolves the paired contrast color from the global color registry.
+ *
+ * @param colorName - Base color name from the registry.
+ * @returns Linked `onColor` value if present.
+ * @category Theme
+ */

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;

package/utils/flatChildren.d.ts

@@ -0,0 +1,17 @@
+import { ReactNode } from 'react';
+/**
+ * Flattens a React node tree by one level, unwrapping Fragments.
+ *
+ * Accepts a single element, a Fragment, or an array and returns a flat array
+ * of `ReactNode` items. Useful in components that need to identify or count
+ * specific child types via type guards.
+ *
+ * @param node - React node to flatten.
+ * @returns Flat array of React nodes with top-level Fragments unwrapped.
+ *
+ * @example
+ * const items = flatChildren(actions).filter(isDialogAction);
+ *
+ * @category Utils
+ */
+export declare const flatChildren: (node: ReactNode) => ReactNode[];

package/utils/generateMaterialColors.d.ts

@@ -1,5 +1,5 @@
 import { PartialThemeSchemes, ThemeSchemes } from '../types';
-export type ExtraColorOverrides = Partial<Record<'info' | 'warning' | 'success', string>>;
+export type UserColors = Record<string, string>;
 /**
  * Generates a full ThemeSchemes object (light and dark modes) based on a seed color,
  * optional token overrides, and custom semantic colors (info, warning, success).
@@ -12,20 +12,20 @@ export type ExtraColorOverrides = Partial<Record<'info' | 'warning' | 'success',
  *
  * @param seedColor - Optional seed color in hex (e.g. "#6200ee"). Used as the base for the primary palette.
  *                    Defaults to `#6750A4` if not provided.
- * @param customSchemes - Optional overrides for light and dark color values.
- *                        Partial values will be merged with generated ones.
- * @param extraColors - Optional custom base colors for `info`, `warning`, and `success`.
- *                      These will override the default values (`#03a9f4`, `#ffd600`, `#689f38`).
+ * @param colors - Optional map of custom base colors. Defaults include `info`, `warning`, and `success`.
+ *                 Any key can be provided (e.g. `brand`, `neutralStrong`, `secondary`).
+ * @param customSchemes - Optional skin overrides for schemes (e.g. light/dark/high-contrast).
+ *                        Applied as the final merge step.
  *
  * @returns A fully resolved ThemeSchemes object with all required color roles populated for light and dark modes.
+ *          Also updates the global color registry via `setColorRegistry()`.
  *
  * @example
  * ```ts
  * const schemes = generateMaterialColors('#6200ee', { info: '#2196f3' }, {});
  * const primary = schemes.light.primary;
- * const infoContainer = schemes.dark.infoContainer;
  * ```
  *
  * @category Theme
  */
-export declare function generateMaterialColors(seedColor?: string, extraColors?: ExtraColorOverrides, customSchemes?: PartialThemeSchemes): ThemeSchemes;
+export declare function generateMaterialColors(seedColor?: string, colors?: UserColors, customSchemes?: PartialThemeSchemes): ThemeSchemes;

package/utils/index.d.ts

@@ -3,8 +3,11 @@ export * from './utils';
 export * from './calculateFloatingPosition';
 export * from './interactionMode';
 export * from './generateMaterialColors';
-export * from './generateSchemes';
+export * from './applyThemeTokens';
 export * from './toasts';
 export * from './uniqueID';
 export * from './controlStyle';
 export * from './getWrapperStyle';
+export * from './flatChildren';
+export * from './renderPortal';
+export * from './colorRegistry';