@omnitron-dev/prism 0.1.1

package/dist/theme/index.d.ts

@@ -0,0 +1,1049 @@
+import * as locales from '@mui/material/locale';
+import { ThemeOptions, PaletteOptions, Shadows, Theme, CSSObject, Components } from '@mui/material/styles';
+import { f as ColorGroup, b as ThemePreset, a as ThemeMode, c as ThemeDirection, C as ComponentDensity, l as CssVariablesConfig, k as ComponentsConfig, o as PrismTheme, g as ColorScale, e as ChartPalette, m as PaletteColorWithChannels, V as VibrantPalette, r as ThemePalette, P as PaletteColor, h as ColorScaleWithChannels, s as ThemeTypography, d as ThemePresetDefinition } from '../theme-CrXLfP1c.js';
+export { B as BackgroundPalette, i as ColorShadeKey } from '../theme-CrXLfP1c.js';
+import { Components as Components$1, Theme as Theme$1 } from '@mui/material';
+
+/**
+ * Theme Factory
+ *
+ * Creates MUI themes with full Prism integration.
+ * Uses MUI's native colorSchemes for automatic light/dark mode.
+ *
+ * Key Features:
+ * - Native MUI colorSchemes integration (automatic dark/light switching)
+ * - CSS variables with configurable prefix and `theme.vars.palette.*` access
+ * - Density-based component sizing (compact/standard/comfortable)
+ * - Runtime primary color override system
+ * - Full TypeScript inference
+ * - Tree-shakeable component overrides
+ *
+ * @module @omnitron-dev/prism/theme/create-theme
+ */
+
+type SupportedLocale = keyof typeof locales;
+/**
+ * Options for creating a Prism theme.
+ *
+ * @example
+ * ```tsx
+ * // Minimal configuration
+ * const theme = createPrismTheme();
+ *
+ * // Full configuration
+ * const theme = createPrismTheme({
+ *   preset: 'luxury',
+ *   mode: 'dark',
+ *   primaryColor: '#FF5630',
+ *   density: 'compact',
+ *   locale: 'ruRU',
+ *   direction: 'ltr',
+ *   cssVarPrefix: 'myapp',
+ *   borderRadius: 12,
+ *   responsiveFonts: true,
+ * });
+ * ```
+ */
+interface CreatePrismThemeOptions {
+    /** Theme preset (default: 'default-light') */
+    preset?: ThemePreset;
+    /** Light/dark/system mode (default: 'light') */
+    mode?: ThemeMode;
+    /** Text direction (default: 'ltr') */
+    direction?: ThemeDirection;
+    /** MUI locale for i18n (default: 'enUS') */
+    locale?: SupportedLocale;
+    /** Custom primary color override (hex, e.g., '#FF5630') */
+    primaryColor?: string | null;
+    /** CSS variable prefix (default: 'prism') */
+    cssVarPrefix?: string;
+    /** Component density (default: 'standard') */
+    density?: ComponentDensity;
+    /** Border radius in pixels (default: 8) */
+    borderRadius?: number;
+    /** Enable responsive font sizes (default: true) */
+    responsiveFonts?: boolean;
+    /** Custom MUI theme overrides */
+    overrides?: Partial<ThemeOptions>;
+    /** Typography configuration (optional override) */
+    typography?: Partial<ThemeOptions['typography']>;
+    /** CSS variables configuration (optional override) */
+    cssVariables?: Partial<CssVariablesConfig>;
+    /** Components configuration (optional override) */
+    components?: Partial<ComponentsConfig>;
+    /** Contrast mode: 'default' or 'high' (default: 'default') */
+    contrast?: 'default' | 'high';
+    /** Override primary font family */
+    fontFamily?: string | null;
+    /** Override base font size in px (12-20, default: 16) */
+    fontSize?: number;
+}
+/**
+ * Available color groups for primary color override.
+ * When primaryColor matches a group's main color, we use that group's full palette
+ * for proper shade generation in both light and dark modes.
+ */
+declare const COLOR_GROUPS: ColorGroup[];
+/**
+ * Create a Prism theme.
+ *
+ * This is the main entry point for creating themes. It uses MUI's native
+ * colorSchemes for automatic light/dark mode switching, CSS variables
+ * for dynamic theming, and includes all Prism extensions.
+ *
+ * @example
+ * ```tsx
+ * // Basic usage
+ * const theme = createPrismTheme({ preset: 'luxury', mode: 'dark' });
+ *
+ * // With custom primary color
+ * const theme = createPrismTheme({
+ *   preset: 'default-light',
+ *   primaryColor: '#FF5630',
+ *   density: 'compact',
+ * });
+ *
+ * // Use with MUI ThemeProvider
+ * <ThemeProvider theme={theme}>
+ *   <App />
+ * </ThemeProvider>
+ * ```
+ *
+ * @param options - Theme creation options
+ * @returns MUI theme with Prism extensions
+ */
+declare function createPrismTheme(options?: CreatePrismThemeOptions): PrismTheme;
+/**
+ * Available preset names.
+ */
+declare const PRESET_NAMES: readonly ThemePreset[];
+/**
+ * Preset display names for UI.
+ */
+declare const PRESET_DISPLAY_NAMES: Record<ThemePreset, string>;
+/**
+ * Inherent mode for each preset.
+ * Non-default presets are inherently light or dark — selecting them forces the mode.
+ * Default presets respect the user's light/dark/system toggle.
+ */
+declare const PRESET_INHERENT_MODE: Record<ThemePreset, 'light' | 'dark'>;
+/**
+ * Get preset display name.
+ */
+declare function getPresetDisplayName(preset: ThemePreset): string;
+
+/**
+ * Palette Builder
+ *
+ * Creates MUI-native palette structures with full channel support.
+ * Designed for maximum integration with MUI's colorSchemes and CSS variables.
+ *
+ * Key MUI Integration Points:
+ * - Uses MUI's PaletteOptions structure directly
+ * - Generates channel values for use with `theme.vars.palette.*.mainChannel`
+ * - Supports MUI's `applyStyles` for dark mode variants
+ * - Works seamlessly with MUI's CSS variable system
+ *
+ * @module @omnitron-dev/prism/theme/palette/builder
+ */
+
+/**
+ * Build palette color from color scale.
+ *
+ * @param scale - 11-shade color scale
+ * @param mode - Light or dark mode
+ * @returns Palette color with channels
+ */
+declare function buildPaletteColor(scale: ColorScale, mode?: 'light' | 'dark'): PaletteColorWithChannels;
+interface BackgroundColors {
+    default: string;
+    paper: string;
+    neutral: string;
+    elevation1: string;
+    elevation2: string;
+    elevation3: string;
+    elevation4: string;
+    menu: string;
+    menuElevation1: string;
+    menuElevation2: string;
+}
+/**
+ * Build background palette from grey scale.
+ *
+ * @param grey - Grey color scale
+ * @param mode - Light or dark mode
+ * @returns Background colors
+ */
+declare function buildBackground(grey: ColorScale, mode?: 'light' | 'dark'): BackgroundColors;
+interface TextColors {
+    primary: string;
+    secondary: string;
+    disabled: string;
+    primaryChannel: string;
+    secondaryChannel: string;
+    disabledChannel: string;
+}
+/**
+ * Build text colors from grey scale.
+ *
+ * @param grey - Grey color scale
+ * @param mode - Light or dark mode
+ * @returns Text colors with channels
+ */
+declare function buildText(grey: ColorScale, mode?: 'light' | 'dark'): TextColors;
+interface ActionColors {
+    active: string;
+    hover: string;
+    selected: string;
+    disabled: string;
+    disabledBackground: string;
+    focus: string;
+}
+/**
+ * Build action colors from grey scale.
+ *
+ * @param grey - Grey color scale
+ * @param mode - Light or dark mode
+ * @returns Action colors
+ */
+declare function buildAction(grey: ColorScale, mode?: 'light' | 'dark'): ActionColors;
+/**
+ * Build vibrant colors for overlays and glass effects.
+ *
+ * @param commonWhiteChannel - White color channel
+ * @param textPrimary - Primary text color
+ * @param mode - Light or dark mode
+ * @returns Vibrant palette
+ */
+declare function buildVibrant(commonWhiteChannel: string, textPrimary: string, mode?: 'light' | 'dark'): VibrantPalette;
+/**
+ * Build chart color palette.
+ *
+ * @param options - Color scales for charts
+ * @returns Chart palette
+ */
+declare function buildChartColors(options: {
+    grey: ColorScale;
+    red: ColorScale;
+    blue: ColorScale;
+    green: ColorScale;
+    orange: ColorScale;
+    lightBlue: ColorScale;
+    purple: ColorScale;
+}): ChartPalette;
+interface BuildPaletteOptions {
+    /** Primary color scale */
+    primary: ColorScale;
+    /** Secondary color scale */
+    secondary: ColorScale;
+    /** Info color scale */
+    info: ColorScale;
+    /** Success color scale */
+    success: ColorScale;
+    /** Warning color scale */
+    warning: ColorScale;
+    /** Error color scale */
+    error: ColorScale;
+    /** Neutral/grey color scale */
+    grey: ColorScale;
+    /** Light or dark mode */
+    mode: 'light' | 'dark';
+    /** Custom background default color */
+    backgroundDefault?: string;
+    /** Custom paper color */
+    paperColor?: string;
+}
+/**
+ * Build complete MUI-compatible palette.
+ *
+ * @param options - Palette build options
+ * @returns Complete MUI palette options
+ */
+declare function buildPalette(options: BuildPaletteOptions): PaletteOptions;
+/**
+ * Default light palette.
+ */
+declare const defaultLightPalette: PaletteOptions;
+/**
+ * Default dark palette.
+ */
+declare const defaultDarkPalette: PaletteOptions;
+
+/**
+ * Palette Utilities
+ *
+ * Utilities for palette manipulation and CSS channel generation.
+ * All color math uses HSL for perceptually correct results.
+ *
+ * @module @omnitron-dev/prism/theme/palette
+ */
+
+/**
+ * Generate RGB channel string from hex color.
+ *
+ * @param hex - Hex color value
+ * @returns RGB channel string (e.g., "255 255 255")
+ */
+declare function generatePaletteChannel(hex: string): string;
+/**
+ * Apply primary color override to a palette.
+ *
+ * @param palette - Base palette
+ * @param primaryColor - New primary color
+ * @param mode - Theme mode (light/dark)
+ * @returns Updated palette with new primary color
+ */
+declare function applyPrimaryOverride(palette: ThemePalette, primaryColor: string, mode?: 'light' | 'dark'): ThemePalette;
+
+/**
+ * Color Utilities
+ *
+ * Functions for color manipulation, channel generation, and palette creation.
+ * Uses HSL-based color math for perceptually correct results.
+ * Combines Aurora's sophisticated color system with Prism's extensibility.
+ *
+ * @module @omnitron-dev/prism/theme/utils/color
+ */
+
+/**
+ * Convert hex color to RGB values.
+ *
+ * @param hex - Hex color string (e.g., '#FF5630' or 'FF5630')
+ * @returns RGB tuple [r, g, b]
+ */
+declare function hexToRgb(hex: string): [number, number, number];
+/**
+ * Convert hex color to RGB channel string.
+ *
+ * @param hex - Hex color string
+ * @returns RGB channel string (e.g., '255 86 48')
+ */
+declare function hexToRgbChannel(hex: string): string;
+/**
+ * Convert RGB values to hex color.
+ *
+ * @param r - Red (0-255)
+ * @param g - Green (0-255)
+ * @param b - Blue (0-255)
+ * @returns Hex color string (e.g., '#FF5630')
+ */
+declare function rgbToHex(r: number, g: number, b: number): string;
+/**
+ * Convert hex to HSL values.
+ *
+ * @param hex - Hex color string
+ * @returns HSL values { h: 0-360, s: 0-100, l: 0-100 }
+ */
+declare function hexToHsl(hex: string): {
+    h: number;
+    s: number;
+    l: number;
+};
+/**
+ * Convert HSL values to hex color.
+ *
+ * @param h - Hue (0-360)
+ * @param s - Saturation (0-100)
+ * @param l - Lightness (0-100)
+ * @returns Hex color string
+ */
+declare function hslToHex(h: number, s: number, l: number): string;
+/**
+ * Create CSS rgba() from hex color.
+ *
+ * @param color - Hex color string
+ * @param alpha - Alpha value (0-1)
+ * @returns CSS rgba string
+ */
+declare function rgba(color: string, alpha: number): string;
+/**
+ * Create CSS rgba() from RGB channel string.
+ * Useful for CSS variable references.
+ *
+ * @param channel - RGB channel string (e.g., '255 86 48')
+ * @param alpha - Alpha value (0-1)
+ * @returns CSS rgba string using modern syntax
+ */
+declare function cssVarRgba(channel: string, alpha: number): string;
+/**
+ * Generate palette color with channel values.
+ *
+ * @param color - Palette color object
+ * @returns Palette color with channel values
+ */
+declare function generatePaletteColorWithChannels(color: PaletteColor): PaletteColorWithChannels;
+/**
+ * Generate color scale with channel values.
+ *
+ * @param scale - Color scale object
+ * @returns Color scale with channel values
+ */
+declare function generateColorScaleWithChannels(scale: ColorScale): ColorScaleWithChannels;
+/**
+ * Generate 11-shade color scale from a base color.
+ * Uses HSL manipulation to create consistent, accessible shades.
+ *
+ * @param baseColor - Base hex color (typically the 500 shade)
+ * @returns Full 11-shade color scale
+ */
+declare function generateColorScale(baseColor: string): ColorScale;
+/**
+ * Create semantic palette color from a color scale.
+ * Maps 11-shade scale to 5-shade semantic naming.
+ *
+ * @param scale - Full color scale
+ * @param mode - Light or dark mode
+ * @returns Semantic palette color
+ */
+declare function createPaletteColorFromScale(scale: ColorScale, mode?: 'light' | 'dark'): PaletteColor;
+/**
+ * Create inverted color scale for dark mode.
+ * Swaps light and dark shades for proper dark mode contrast.
+ *
+ * @param scale - Original color scale
+ * @returns Inverted color scale
+ */
+declare function invertColorScale(scale: ColorScale): ColorScale;
+/**
+ * Calculate relative luminance of a color.
+ *
+ * @param hex - Hex color string
+ * @returns Relative luminance (0-1)
+ */
+declare function getLuminance(hex: string): number;
+/**
+ * Calculate contrast ratio between two colors.
+ *
+ * @param color1 - First hex color
+ * @param color2 - Second hex color
+ * @returns Contrast ratio (1-21)
+ */
+declare function getContrastRatio(color1: string, color2: string): number;
+/**
+ * Determine if a color is light or dark.
+ *
+ * @param hex - Hex color string
+ * @returns True if color is light
+ */
+declare function isLightColor(hex: string): boolean;
+/**
+ * Get optimal contrast text color for a background.
+ *
+ * @param background - Background hex color
+ * @param lightText - Light text color (default: white)
+ * @param darkText - Dark text color (default: black)
+ * @returns Best contrast text color
+ */
+declare function getContrastText(background: string, lightText?: string, darkText?: string): string;
+/**
+ * Lighten a color using HSL.
+ * Preserves hue and saturation while increasing lightness.
+ *
+ * @param hex - Hex color string
+ * @param amount - Amount to lighten (0-100 percentage points)
+ * @returns Lightened hex color
+ */
+declare function lighten(hex: string, amount: number): string;
+/**
+ * Darken a color using HSL.
+ * Preserves hue and saturation while decreasing lightness.
+ *
+ * @param hex - Hex color string
+ * @param amount - Amount to darken (0-100 percentage points)
+ * @returns Darkened hex color
+ */
+declare function darken(hex: string, amount: number): string;
+/**
+ * Mix two colors together.
+ *
+ * @param color1 - First hex color
+ * @param color2 - Second hex color
+ * @param weight - Weight of first color (0-1, default: 0.5)
+ * @returns Mixed hex color
+ */
+declare function mix(color1: string, color2: string, weight?: number): string;
+/**
+ * Create CSS rgba() using a CSS variable channel.
+ * Essential for dynamic alpha with CSS custom properties.
+ *
+ * Supports:
+ * - RGB channel strings: "200 250 214"
+ * - CSS variables: "var(--palette-primary-mainChannel)"
+ * - currentColor (via color-mix)
+ *
+ * Does NOT support (will throw):
+ * - Hex colors: "#00B8D9"
+ * - RGB: "rgb(0, 184, 217)"
+ * - RGBA: "rgba(0, 184, 217, 1)"
+ *
+ * @example
+ * ```tsx
+ * // With CSS variable channel
+ * varAlpha('var(--palette-primary-mainChannel)', 0.5)
+ * // Returns: "rgba(var(--palette-primary-mainChannel) / 50%)"
+ *
+ * // With RGB channel string
+ * varAlpha('200 250 214', 0.8)
+ * // Returns: "rgba(200 250 214 / 80%)"
+ *
+ * // With percentage opacity
+ * varAlpha('var(--palette-primary-mainChannel)', '50%')
+ * // Returns: "rgba(var(--palette-primary-mainChannel) / 50%)"
+ *
+ * // With CSS variable opacity
+ * varAlpha('var(--palette-primary-mainChannel)', 'var(--opacity)')
+ * // Returns: "rgba(var(--palette-primary-mainChannel) / calc(var(--opacity) * 100%))"
+ *
+ * // With currentColor
+ * varAlpha('currentColor', 0.5)
+ * // Returns: "color-mix(in srgb, currentColor 50%, transparent)"
+ * ```
+ *
+ * @param color - CSS variable reference for the RGB channel, RGB channel string, or 'currentColor'
+ * @param opacity - Alpha value (0-1 number, percentage string, or CSS variable)
+ * @returns CSS rgba/color-mix string
+ * @throws Error if color format is unsupported or opacity is invalid
+ */
+declare function varAlpha(color: string, opacity?: string | number): string;
+
+/**
+ * Base Color Scales
+ *
+ * Foundation colors used across all presets.
+ * 11-shade scales (50-950) for maximum flexibility.
+ *
+ * @module @omnitron-dev/prism/theme/colors/base
+ */
+
+/**
+ * Grey scale - neutral foundation.
+ */
+declare const grey: ColorScale;
+/**
+ * Blue - default primary.
+ */
+declare const blue: ColorScale;
+/**
+ * Green - success/teal variant.
+ */
+declare const green: ColorScale;
+/**
+ * Purple - secondary.
+ */
+declare const purple: ColorScale;
+/**
+ * Red - error/destructive.
+ */
+declare const red: ColorScale;
+/**
+ * Orange - warning.
+ */
+declare const orange: ColorScale;
+/**
+ * Light Blue - info.
+ */
+declare const lightBlue: ColorScale;
+/**
+ * Basic black and white.
+ */
+declare const basic: {
+    readonly white: "#FFFFFF";
+    readonly black: "#000000";
+};
+/**
+ * All base color scales.
+ */
+declare const baseColors: {
+    readonly grey: ColorScale;
+    readonly blue: ColorScale;
+    readonly green: ColorScale;
+    readonly purple: ColorScale;
+    readonly red: ColorScale;
+    readonly orange: ColorScale;
+    readonly lightBlue: ColorScale;
+    readonly basic: {
+        readonly white: "#FFFFFF";
+        readonly black: "#000000";
+    };
+};
+
+/**
+ * Luxury Preset Colors
+ *
+ * Rich, elegant color scales with gold/amber tones.
+ *
+ * @module @omnitron-dev/prism/theme/colors/luxury
+ */
+
+/**
+ * Luxury Primary - Rich Gold/Amber.
+ */
+declare const luxuryPrimary: ColorScale;
+/**
+ * Luxury Secondary - Deep Purple.
+ */
+declare const luxurySecondary: ColorScale;
+/**
+ * Luxury Neutral - Warm Grey.
+ */
+declare const luxuryNeutral: ColorScale;
+/**
+ * Luxury Error - Muted Red.
+ */
+declare const luxuryError: ColorScale;
+/**
+ * Luxury Warning - Rich Amber.
+ */
+declare const luxuryWarning: ColorScale;
+/**
+ * Luxury Success - Forest Green.
+ */
+declare const luxurySuccess: ColorScale;
+/**
+ * Luxury Info - Steel Blue.
+ */
+declare const luxuryInfo: ColorScale;
+/**
+ * All luxury colors.
+ */
+declare const luxuryColors: {
+    readonly primary: ColorScale;
+    readonly secondary: ColorScale;
+    readonly neutral: ColorScale;
+    readonly error: ColorScale;
+    readonly warning: ColorScale;
+    readonly success: ColorScale;
+    readonly info: ColorScale;
+};
+
+/**
+ * Typography System
+ *
+ * Typography configuration for Prism themes.
+ *
+ * @module @omnitron-dev/prism/theme/typography
+ */
+
+/** MUI Typography options type */
+type TypographyOptions = NonNullable<ThemeOptions['typography']>;
+/**
+ * Default typography configuration.
+ */
+declare const typography: ThemeTypography;
+/**
+ * Create MUI typography options from Prism typography config.
+ *
+ * @param config - Typography configuration
+ * @returns MUI typography options
+ */
+declare function createTypography(config: ThemeTypography): TypographyOptions;
+
+/**
+ * Shadow System
+ *
+ * Shadow configuration for Prism themes.
+ *
+ * @module @omnitron-dev/prism/theme/shadows
+ */
+
+/**
+ * Default shadows array (MUI expects 25 shadows).
+ */
+declare const shadows: Shadows;
+/**
+ * Create shadows with optional opacity multiplier for dark mode.
+ *
+ * @param primaryColor - Primary color for tinted shadows (reserved for future)
+ * @param opacityMultiplier - Multiplier for shadow opacity (default: 1, use 0.4-0.6 for dark mode)
+ * @returns Shadows array with adjusted opacity
+ */
+declare function createShadows(primaryColor?: string, opacityMultiplier?: number): Shadows;
+/**
+ * Dark mode shadow - subtle shadow for dark backgrounds.
+ */
+declare const darkShadow = "0px 0px 0px 1px rgba(255, 255, 255, 0.1)";
+
+/**
+ * Theme Mixins
+ *
+ * Reusable style utilities for component overrides.
+ * Based on Minimals template patterns.
+ *
+ * @module @omnitron-dev/prism/theme/mixins
+ */
+
+/**
+ * Color key types for style variants.
+ */
+type PaletteColorKey = 'primary' | 'secondary' | 'info' | 'success' | 'warning' | 'error';
+type CommonColorsKeys = 'black' | 'white';
+type ColorKey = CommonColorsKeys | PaletteColorKey | 'default' | 'inherit';
+/**
+ * Options for style variants.
+ */
+interface StyleOptions {
+    hover?: boolean | CSSObject;
+}
+/**
+ * Options for paper styles.
+ */
+interface PaperStyleOptions {
+    blur?: number;
+    color?: string;
+    dropdown?: boolean;
+}
+/**
+ * Background gradient options.
+ */
+interface BgGradientOptions {
+    images?: string[];
+    sizes?: string[];
+    positions?: string[];
+    colors?: string[];
+    direction?: string;
+}
+
+/**
+ * Generate filled style variant for components.
+ *
+ * @example
+ * ```tsx
+ * // In component styleOverrides
+ * ...filledStyles(theme, 'primary', { hover: true })
+ * ...filledStyles(theme, 'inherit', { hover: { boxShadow: theme.vars.customShadows.z8 } })
+ * ```
+ */
+declare function filledStyles(theme: Theme, colorKey: ColorKey, options?: StyleOptions): CSSObject;
+/**
+ * Generate soft style variant for components.
+ *
+ * @example
+ * ```tsx
+ * // In component styleOverrides
+ * ...softStyles(theme, 'primary')
+ * ...softStyles(theme, 'inherit', { hover: true })
+ * ```
+ */
+declare function softStyles(theme: Theme, colorKey: ColorKey, options?: StyleOptions): CSSObject;
+/**
+ * Generate background gradient styles.
+ *
+ * @example
+ * ```tsx
+ * ...bgGradient({
+ *   colors: ['rgba(0,0,0,0.5)', 'rgba(0,0,0,0.8)'],
+ *   direction: 'to bottom'
+ * })
+ * ```
+ */
+declare function bgGradient(options: BgGradientOptions): CSSObject;
+/**
+ * Generate blur background styles.
+ *
+ * @example
+ * ```tsx
+ * ...bgBlur({ blur: 20, color: 'rgba(255,255,255,0.8)' })
+ * ```
+ */
+declare function bgBlur(options: {
+    blur?: number;
+    color?: string;
+}): CSSObject;
+/**
+ * Generate paper styles with glass effect.
+ *
+ * @example
+ * ```tsx
+ * ...paperStyles(theme, { dropdown: true })
+ * ```
+ */
+declare function paperStyles(theme: Theme, options?: PaperStyleOptions): CSSObject;
+/**
+ * Generate menu item styles.
+ *
+ * @example
+ * ```tsx
+ * ...menuItemStyles(theme)
+ * ```
+ */
+declare function menuItemStyles(theme: Theme): CSSObject;
+/**
+ * Generate max lines text truncation.
+ *
+ * @example
+ * ```tsx
+ * ...maxLine({ lines: 2 })
+ * ```
+ */
+declare function maxLine(options: {
+    lines: number;
+    lineHeight?: number;
+}): CSSObject;
+/**
+ * Generate text gradient effect.
+ *
+ * @example
+ * ```tsx
+ * ...textGradient('to right', '#FF5630', '#00AB55')
+ * ```
+ */
+declare function textGradient(direction: string, ...colors: string[]): CSSObject;
+/**
+ * Generate border gradient effect using background-clip trick.
+ *
+ * @example
+ * ```tsx
+ * ...borderGradient({ color: 'linear-gradient(135deg, #FF5630, #00AB55)', borderWidth: 2 })
+ * ```
+ */
+declare function borderGradient(options: {
+    color?: string;
+    borderWidth?: number;
+    borderRadius?: number;
+}): CSSObject;
+/**
+ * Generate theme-aware scrollbar styles.
+ * Uses CSS variables for proper dark mode support.
+ *
+ * @example
+ * ```tsx
+ * ...scrollbarStyles(theme)
+ * ```
+ */
+declare function scrollbarStyles(theme: Theme): CSSObject;
+/**
+ * MUI mixins configuration.
+ */
+declare const mixins: {
+    toolbar: {
+        minHeight: number;
+        '@media (min-width:0px)': {
+            '@media (orientation: landscape)': {
+                minHeight: number;
+            };
+        };
+        '@media (min-width:600px)': {
+            minHeight: number;
+        };
+    };
+    hideScrollX: {
+        msOverflowStyle: "none";
+        scrollbarWidth: "none";
+        overflowX: "auto";
+        '&::-webkit-scrollbar': {
+            display: string;
+        };
+    };
+    hideScrollY: {
+        msOverflowStyle: "none";
+        scrollbarWidth: "none";
+        overflowY: "auto";
+        '&::-webkit-scrollbar': {
+            display: string;
+        };
+    };
+    bgBlur: typeof bgBlur;
+    bgGradient: typeof bgGradient;
+    maxLine: typeof maxLine;
+    softStyles: typeof softStyles;
+    filledStyles: typeof filledStyles;
+    paperStyles: typeof paperStyles;
+    menuItemStyles: typeof menuItemStyles;
+    varAlpha: typeof varAlpha;
+    textGradient: typeof textGradient;
+    borderGradient: typeof borderGradient;
+    scrollbarStyles: typeof scrollbarStyles;
+};
+/**
+ * Hide scrollbar mixin.
+ */
+declare const hideScrollbarMixin: {
+    scrollbarWidth: "none";
+    msOverflowStyle: "none";
+    '&::-webkit-scrollbar': {
+        display: string;
+    };
+};
+/**
+ * Custom scrollbar mixin.
+ */
+declare function customScrollbarMixin(theme: Theme): CSSObject;
+/**
+ * Text overflow ellipsis mixin.
+ */
+declare const textEllipsisMixin: {
+    overflow: string;
+    textOverflow: string;
+    whiteSpace: "nowrap";
+};
+/**
+ * Multi-line text overflow mixin.
+ */
+declare function multiLineEllipsisMixin(lines: number): {
+    overflow: string;
+    display: string;
+    WebkitBoxOrient: "vertical";
+    WebkitLineClamp: number;
+};
+/**
+ * Focus visible ring mixin.
+ */
+declare const focusRingMixin: {
+    '&:focus-visible': {
+        outline: string;
+        boxShadow: string;
+    };
+};
+/**
+ * Glass/blur background mixin.
+ */
+declare const glassMixin: {
+    backdropFilter: string;
+    backgroundColor: string;
+};
+
+/**
+ * Component Overrides
+ *
+ * MUI component customizations for Prism themes.
+ * Combines best practices from Minimals and Aurora templates.
+ *
+ * Key Features:
+ * - Density-based spacing (compact/standard/comfortable)
+ * - Custom variants (soft, dashed, shapes)
+ * - Refined input styling with proper typography
+ * - Custom checkbox/radio/switch icons
+ * - Full CSS variable integration
+ *
+ * @module @omnitron-dev/prism/theme/components
+ */
+
+/**
+ * Generate MUI component overrides based on configuration.
+ * Combines best practices from Minimals (refined inputs, custom shadows)
+ * and Aurora (compact dimensions, shape variants).
+ *
+ * @param config - Components configuration
+ * @returns MUI components overrides
+ */
+declare function componentOverrides(config: ComponentsConfig): Components<Theme> & Record<string, unknown>;
+
+/**
+ * Button Component Overrides
+ *
+ * MUI Button customization with custom variants: soft, dashed, shapes.
+ *
+ * @module @omnitron-dev/prism/theme/components/Button
+ */
+
+declare module '@mui/material/Button' {
+    interface ButtonPropsVariantOverrides {
+        /** Soft variant - subtle background with colored text */
+        soft: true;
+        /** Dashed variant - dashed border */
+        dashed: true;
+    }
+    interface ButtonPropsColorOverrides {
+        /** Neutral color option */
+        neutral: true;
+    }
+    interface ButtonPropsSizeOverrides {
+        /** Extra-large size */
+        xLarge: true;
+    }
+    interface ButtonOwnProps {
+        /** Shape variant for icon buttons */
+        shape?: 'square' | 'circle';
+    }
+}
+declare function createButtonOverrides(config: ComponentsConfig): Components$1<Theme$1>['MuiButton'];
+declare function createButtonBaseOverrides(): Components$1<Theme$1>['MuiButtonBase'];
+declare function createButtonGroupOverrides(config: ComponentsConfig): Components$1<Theme$1>['MuiButtonGroup'];
+
+/**
+ * Default Theme Preset
+ *
+ * A neutral, modern theme suitable for most applications.
+ *
+ * @module @omnitron-dev/prism/theme/presets/default
+ */
+
+/**
+ * Default theme preset.
+ */
+declare const defaultPreset: ThemePresetDefinition;
+
+/**
+ * Luxury Theme Preset
+ *
+ * A rich, elegant theme with deep colors and premium feel.
+ *
+ * @module @omnitron-dev/prism/theme/presets/luxury
+ */
+
+/**
+ * Luxury theme preset.
+ */
+declare const luxuryPreset: ThemePresetDefinition;
+
+/**
+ * Arctic Theme Preset
+ *
+ * A cool, crisp blue theme inspired by northern landscapes.
+ *
+ * @module @omnitron-dev/prism/theme/presets/arctic
+ */
+
+/**
+ * Arctic theme preset.
+ */
+declare const arcticPreset: ThemePresetDefinition;
+
+/**
+ * Theme Presets Index
+ *
+ * @module @omnitron-dev/prism/theme/presets
+ */
+
+/**
+ * All available preset names.
+ */
+declare const presetNames: ThemePreset[];
+/**
+ * Get a theme preset by name.
+ *
+ * @param name - Preset name
+ * @returns Theme preset definition
+ * @throws If preset is not found
+ */
+declare function getPreset(name: ThemePreset): ThemePresetDefinition;
+
+/**
+ * CSS Variables System
+ *
+ * Utilities for generating and managing CSS variables.
+ *
+ * @module @omnitron-dev/prism/theme/css-variables
+ */
+
+/**
+ * CSS variable definitions.
+ * Uses an index signature since keys are dynamically generated based on prefix.
+ */
+interface CssVariables {
+    [key: string]: string;
+}
+/**
+ * Default CSS variable values.
+ */
+declare const cssVariables: CssVariables;
+/**
+ * Generate CSS variables from a Prism theme.
+ *
+ * @param theme - Prism theme
+ * @param config - CSS variables configuration
+ * @returns CSS variables object
+ */
+declare function generateCssVariables(theme: PrismTheme, config: CssVariablesConfig): CssVariables;
+
+export { type ActionColors, type BackgroundColors, type BuildPaletteOptions, COLOR_GROUPS, ChartPalette, ColorGroup, ColorScale, ColorScaleWithChannels, ComponentDensity, ComponentsConfig, type CreatePrismThemeOptions, CssVariablesConfig, PRESET_DISPLAY_NAMES, PRESET_INHERENT_MODE, PRESET_NAMES, PaletteColor, PaletteColorWithChannels, PrismTheme, type SupportedLocale, type TextColors, ThemeDirection, ThemeMode, ThemePreset, VibrantPalette, applyPrimaryOverride, arcticPreset, baseColors, basic, blue, buildAction, buildBackground, buildChartColors, buildPalette, buildPaletteColor, buildText, buildVibrant, componentOverrides, createButtonBaseOverrides, createButtonGroupOverrides, createButtonOverrides, createPaletteColorFromScale, createPrismTheme, createShadows, createTypography, cssVarRgba, cssVariables, customScrollbarMixin, darkShadow, darken, defaultDarkPalette, defaultLightPalette, defaultPreset, focusRingMixin, generateColorScale, generateColorScaleWithChannels, generateCssVariables, generatePaletteChannel, generatePaletteColorWithChannels, getContrastRatio, getContrastText, getLuminance, getPreset, getPresetDisplayName, glassMixin, green, grey, hexToHsl, hexToRgb, hexToRgbChannel, hideScrollbarMixin, hslToHex, invertColorScale, isLightColor, lightBlue, lighten, luxuryColors, luxuryError, luxuryInfo, luxuryNeutral, luxuryPreset, luxuryPrimary, luxurySecondary, luxurySuccess, luxuryWarning, mix, mixins, multiLineEllipsisMixin, orange, presetNames, purple, red, rgbToHex, rgba, shadows, textEllipsisMixin, typography };