@omnitron-dev/prism 0.1.3 → 0.3.0

package/dist/theme/presets/ember.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Ember Theme Preset
+ *
+ * A warm, fiery theme with deep oranges and reds.
+ * Optimized for dark mode with glowing ember accents.
+ *
+ * @module theme/presets/ember
+ */
+import type { ThemePresetDefinition, ColorScale } from '../../types/theme.js';
+/**
+ * Ember primary color scale - warm orange-red.
+ */
+export declare const emberPrimary: ColorScale;
+/**
+ * Ember secondary color scale - deep red.
+ */
+export declare const emberSecondary: ColorScale;
+/**
+ * Ember theme preset.
+ * Optimized for dark mode with warm fire tones.
+ */
+export declare const emberPreset: ThemePresetDefinition;
+//# sourceMappingURL=ember.d.ts.map

package/dist/theme/presets/ember.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ember.d.ts","sourceRoot":"","sources":["../../../src/theme/presets/ember.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAE9E;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,UAY1B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,UAY5B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,WAAW,EAAE,qBAwBzB,CAAC"}

package/dist/theme/presets/index.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Theme Presets Index
+ *
+ * @module theme/presets
+ */
+import type { ThemePreset, ThemePresetDefinition } from '../../types/theme.js';
+/**
+ * All available preset names.
+ */
+export declare const presetNames: ThemePreset[];
+/**
+ * Get a theme preset by name.
+ *
+ * @param name - Preset name
+ * @returns Theme preset definition
+ * @throws If preset is not found
+ */
+export declare function getPreset(name: ThemePreset): ThemePresetDefinition;
+/**
+ * Register a custom preset.
+ *
+ * @param name - Preset name
+ * @param preset - Preset definition
+ */
+export declare function registerPreset(name: string, preset: ThemePresetDefinition): void;
+/**
+ * Get all registered presets.
+ */
+export declare function getAllPresets(): Record<string, ThemePresetDefinition>;
+export { defaultPreset } from './default.js';
+export { luxuryPreset } from './luxury.js';
+export { arcticPreset } from './arctic.js';
+export { naturePreset } from './nature.js';
+export { emberPreset } from './ember.js';
+export { draculaPreset } from './dracula.js';
+export { midnightPreset } from './midnight.js';
+export { retroPreset } from './retro.js';
+export { minimalPreset } from './minimal.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/theme/presets/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/theme/presets/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAW/E;;GAEG;AACH,eAAO,MAAM,WAAW,EAAE,WAAW,EAWpC,CAAC;AAkBF;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,WAAW,GAAG,qBAAqB,CASlE;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,qBAAqB,GAAG,IAAI,CAEhF;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAErE;AAGD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC"}

package/dist/theme/presets/luxury.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Luxury Theme Preset
+ *
+ * A rich, elegant theme with deep colors and premium feel.
+ *
+ * @module theme/presets/luxury
+ */
+import type { ThemePresetDefinition } from '../../types/theme.js';
+/**
+ * Luxury theme preset.
+ */
+export declare const luxuryPreset: ThemePresetDefinition;
+//# sourceMappingURL=luxury.d.ts.map

package/dist/theme/presets/luxury.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"luxury.d.ts","sourceRoot":"","sources":["../../../src/theme/presets/luxury.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAiB,MAAM,sBAAsB,CAAC;AAkKjF;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,qBAyB1B,CAAC"}

package/dist/theme/presets/midnight.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Midnight Theme Preset
+ *
+ * A deep blue-black theme for late night coding sessions.
+ * Features indigo primary with soft blue accents.
+ *
+ * @module theme/presets/midnight
+ */
+import type { ThemePresetDefinition, ColorScale } from '../../types/theme.js';
+/**
+ * Midnight indigo primary.
+ */
+export declare const midnightIndigo: ColorScale;
+/**
+ * Midnight blue-grey background scale.
+ */
+export declare const midnightBackground: ColorScale;
+/**
+ * Midnight theme preset.
+ * Deep blue-black theme optimized for dark mode.
+ */
+export declare const midnightPreset: ThemePresetDefinition;
+//# sourceMappingURL=midnight.d.ts.map

package/dist/theme/presets/midnight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"midnight.d.ts","sourceRoot":"","sources":["../../../src/theme/presets/midnight.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAE9E;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,UAY5B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,UAYhC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,qBAwB5B,CAAC"}

package/dist/theme/presets/minimal.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Minimal Theme Preset
+ *
+ * A clean, minimalist theme with subtle grays and muted accents.
+ * Focuses on content over chrome with maximum readability.
+ *
+ * @module theme/presets/minimal
+ */
+import type { ThemePresetDefinition, ColorScale } from '../../types/theme.js';
+/**
+ * Minimal neutral scale - refined grays.
+ */
+export declare const minimalNeutral: ColorScale;
+/**
+ * Minimal accent scale - subtle blue-grey.
+ */
+export declare const minimalAccent: ColorScale;
+/**
+ * Minimal theme preset.
+ * Clean, content-focused theme that works in both light and dark modes.
+ */
+export declare const minimalPreset: ThemePresetDefinition;
+//# sourceMappingURL=minimal.d.ts.map

package/dist/theme/presets/minimal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"minimal.d.ts","sourceRoot":"","sources":["../../../src/theme/presets/minimal.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAE9E;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,UAY5B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,UAY3B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,qBAwB3B,CAAC"}

package/dist/theme/presets/nature.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Nature Theme Preset
+ *
+ * An earthy, organic theme with warm greens and natural tones.
+ *
+ * @module theme/presets/nature
+ */
+import type { ThemePresetDefinition } from '../../types/theme.js';
+/**
+ * Nature theme preset.
+ * Optimized for light mode with earthy green tones.
+ */
+export declare const naturePreset: ThemePresetDefinition;
+//# sourceMappingURL=nature.d.ts.map

package/dist/theme/presets/nature.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nature.d.ts","sourceRoot":"","sources":["../../../src/theme/presets/nature.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAGlE;;;GAGG;AACH,eAAO,MAAM,YAAY,EAAE,qBAwB1B,CAAC"}

package/dist/theme/presets/retro.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Retro Theme Preset
+ *
+ * A nostalgic theme with vintage computer aesthetics.
+ * Features amber/gold primary with classic terminal vibes.
+ *
+ * @module theme/presets/retro
+ */
+import type { ThemePresetDefinition, ColorScale } from '../../types/theme.js';
+/**
+ * Retro amber primary - classic terminal gold.
+ */
+export declare const retroAmber: ColorScale;
+/**
+ * Retro teal secondary - vintage accent.
+ */
+export declare const retroTeal: ColorScale;
+/**
+ * Retro theme preset.
+ * Nostalgic vintage computer aesthetic optimized for light mode.
+ */
+export declare const retroPreset: ThemePresetDefinition;
+//# sourceMappingURL=retro.d.ts.map

package/dist/theme/presets/retro.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retro.d.ts","sourceRoot":"","sources":["../../../src/theme/presets/retro.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAE9E;;GAEG;AACH,eAAO,MAAM,UAAU,EAAE,UAYxB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,SAAS,EAAE,UAYvB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,WAAW,EAAE,qBAwBzB,CAAC"}

package/dist/theme/shadows.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Shadow System
+ *
+ * Shadow configuration for Prism themes.
+ *
+ * @module theme/shadows
+ */
+import type { Shadows } from '@mui/material/styles';
+/**
+ * Default shadows array (MUI expects 25 shadows).
+ */
+export 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
+ */
+export declare function createShadows(primaryColor?: string, opacityMultiplier?: number): Shadows;
+/**
+ * Named shadow presets for easier usage.
+ */
+export declare const shadowPresets: {
+    /** No shadow */
+    readonly none: "none";
+    /** Extra small shadow */
+    readonly xs: string;
+    /** Small shadow */
+    readonly sm: string;
+    /** Medium shadow */
+    readonly md: string;
+    /** Large shadow */
+    readonly lg: string;
+    /** Extra large shadow */
+    readonly xl: string;
+    /** 2x extra large shadow */
+    readonly '2xl': string;
+    /** Card shadow */
+    readonly card: string;
+    /** Dropdown shadow */
+    readonly dropdown: string;
+    /** Modal shadow */
+    readonly modal: string;
+    /** Dialog shadow */
+    readonly dialog: string;
+    /** Focus ring (primary) */
+    readonly focusPrimary: string;
+    /** Focus ring (success) */
+    readonly focusSuccess: string;
+    /** Focus ring (error) */
+    readonly focusError: string;
+    /** Inset shadow */
+    readonly inset: string;
+};
+export type ShadowPreset = keyof typeof shadowPresets;
+/**
+ * Dark mode shadow - subtle shadow for dark backgrounds.
+ */
+export declare const darkShadow = "0px 0px 0px 1px rgba(255, 255, 255, 0.1)";
+//# sourceMappingURL=shadows.d.ts.map

package/dist/theme/shadows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shadows.d.ts","sourceRoot":"","sources":["../../src/theme/shadows.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAEpD;;GAEG;AACH,eAAO,MAAM,OAAO,EAAE,OA+BrB,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,iBAAiB,SAAI,GAAG,OAAO,CAenF;AAED;;GAEG;AACH,eAAO,MAAM,aAAa;IACxB,gBAAgB;aAChB,IAAI;IACJ,yBAAyB;aACzB,EAAE;IACF,mBAAmB;aACnB,EAAE;IACF,oBAAoB;aACpB,EAAE;IACF,mBAAmB;aACnB,EAAE;IACF,yBAAyB;aACzB,EAAE;IACF,4BAA4B;aAC5B,KAAK;IACL,kBAAkB;aAClB,IAAI;IACJ,sBAAsB;aACtB,QAAQ;IACR,mBAAmB;aACnB,KAAK;IACL,oBAAoB;aACpB,MAAM;IACN,2BAA2B;aAC3B,YAAY;IACZ,2BAA2B;aAC3B,YAAY;IACZ,yBAAyB;aACzB,UAAU;IACV,mBAAmB;aACnB,KAAK;CACG,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,MAAM,OAAO,aAAa,CAAC;AAEtD;;GAEG;AACH,eAAO,MAAM,UAAU,6CAA6C,CAAC"}

package/dist/theme/typography.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Typography System
+ *
+ * Typography configuration for Prism themes.
+ *
+ * @module theme/typography
+ */
+import type { ThemeOptions } from '@mui/material/styles';
+import type { ThemeTypography } from '../types/theme.js';
+/** MUI Typography options type */
+type TypographyOptions = NonNullable<ThemeOptions['typography']>;
+/**
+ * Default typography configuration.
+ */
+export declare const typography: ThemeTypography;
+/**
+ * Create MUI typography options from Prism typography config.
+ *
+ * @param config - Typography configuration
+ * @returns MUI typography options
+ */
+export declare function createTypography(config: ThemeTypography): TypographyOptions;
+export {};
+//# sourceMappingURL=typography.d.ts.map

package/dist/theme/typography.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typography.d.ts","sourceRoot":"","sources":["../../src/theme/typography.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD,kCAAkC;AAClC,KAAK,iBAAiB,GAAG,WAAW,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC,CAAC;AAEjE;;GAEG;AACH,eAAO,MAAM,UAAU,EAAE,eAaxB,CAAC;AA6BF;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,eAAe,GAAG,iBAAiB,CA+F3E"}

package/dist/theme/utils/color.d.ts

@@ -0,0 +1,295 @@
+/**
+ * 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 theme/utils/color
+ */
+import type { ColorScale, ColorScaleWithChannels, PaletteColor, PaletteColorWithChannels } from '../../types/theme.js';
+/**
+ * Convert hex color to RGB values.
+ *
+ * @param hex - Hex color string (e.g., '#FF5630' or 'FF5630')
+ * @returns RGB tuple [r, g, b]
+ */
+export 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')
+ */
+export 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')
+ */
+export 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 }
+ */
+export 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
+ */
+export 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
+ */
+export 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
+ */
+export 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
+ */
+export declare function generatePaletteColorWithChannels(color: PaletteColor): PaletteColorWithChannels;
+/**
+ * Generate color scale with channel values.
+ *
+ * @param scale - Color scale object
+ * @returns Color scale with channel values
+ */
+export 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
+ */
+export declare function generateColorScale(baseColor: string): ColorScale;
+/**
+ * Generate primary color shades from a base color.
+ * Alias for generateColorScale for compatibility with Aurora's naming.
+ */
+export declare const generatePrimaryShades: typeof generateColorScale;
+/**
+ * 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
+ */
+export 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
+ */
+export declare function invertColorScale(scale: ColorScale): ColorScale;
+/**
+ * Calculate relative luminance of a color.
+ *
+ * @param hex - Hex color string
+ * @returns Relative luminance (0-1)
+ */
+export 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)
+ */
+export 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
+ */
+export declare function isLightColor(hex: string): boolean;
+/**
+ * Get optimal contrast text color for a background.
+ *
+ * Picks whichever of the two candidates actually contrasts more, rather than
+ * switching on a luminance threshold. The threshold version returned white
+ * for every colour below 0.5 luminance, which includes the mid-tone brand
+ * colours a theme is most likely to use: `#FF5630` scored 3.17 against white
+ * and 6.63 against black, and `#00A76F` 3.11 against white and 6.76 against
+ * black. Both were handed the worse of the two and both fall below WCAG AA
+ * for body text.
+ *
+ * The measurement is already in this file — `getContrastRatio` sat next to
+ * the threshold and went unused.
+ *
+ * @param background - Background hex color
+ * @param lightText - Light text color (default: white)
+ * @param darkText - Dark text color (default: black)
+ * @returns Whichever candidate contrasts more with `background`
+ */
+export 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
+ */
+export 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
+ */
+export declare function darken(hex: string, amount: number): string;
+/**
+ * Saturate a color using HSL.
+ *
+ * @param hex - Hex color string
+ * @param amount - Amount to increase saturation (0-100 percentage points)
+ * @returns Saturated hex color
+ */
+export declare function saturate(hex: string, amount: number): string;
+/**
+ * Desaturate a color using HSL.
+ *
+ * @param hex - Hex color string
+ * @param amount - Amount to decrease saturation (0-100 percentage points)
+ * @returns Desaturated hex color
+ */
+export declare function desaturate(hex: string, amount: number): string;
+/**
+ * Adjust hue of a color.
+ *
+ * @param hex - Hex color string
+ * @param degrees - Degrees to rotate hue (-360 to 360)
+ * @returns Color with adjusted hue
+ */
+export declare function adjustHue(hex: string, degrees: 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
+ */
+export 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
+ */
+export declare function varAlpha(color: string, opacity?: string | number): string;
+/**
+ * Create palette channel CSS variables object.
+ * Maps semantic color keys to CSS variable references.
+ *
+ * @param prefix - CSS variable prefix (e.g., '--palette-primary')
+ * @returns Object with channel variable references
+ */
+export declare function createPaletteChannelVars(prefix: string): Record<string, string>;
+/**
+ * Parse CSS variable name from a var() expression.
+ *
+ * @param cssVar - CSS var() expression (e.g., 'var(--prism-primary-main)' or '--prism-primary-main')
+ * @returns Variable name without -- prefix, or null if invalid
+ *
+ * @example
+ * ```ts
+ * parseCssVar('var(--prism-primary-main)') // 'prism-primary-main'
+ * parseCssVar('var(--color, #fff)')        // 'color'
+ * parseCssVar('--my-variable')             // 'my-variable'
+ * parseCssVar('invalid')                   // null
+ * ```
+ */
+export declare function parseCssVar(cssVar: string): string | null;
+/**
+ * Check if a value is a CSS variable expression.
+ *
+ * @param value - Value to check
+ * @returns True if value is a var() expression or --variable
+ */
+export declare function isCssVar(value: string): boolean;
+/**
+ * Extract all CSS variables from a theme.vars object path.
+ *
+ * @param varsPath - Dot-separated path to CSS variables (e.g., 'palette.primary')
+ * @param vars - Theme vars object (from theme.vars)
+ * @returns Object with variable names as keys and CSS var expressions as values
+ *
+ * @example
+ * ```ts
+ * const vars = extractCssVars('palette.primary', theme.vars);
+ * // { main: 'var(--prism-palette-primary-main)', light: '...', dark: '...' }
+ * ```
+ */
+export declare function extractCssVars(varsPath: string, vars: Record<string, unknown>): Record<string, string>;
+//# sourceMappingURL=color.d.ts.map

package/dist/theme/utils/color.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"color.d.ts","sourceRoot":"","sources":["../../../src/theme/utils/color.ts"],"names":[],"mappings":"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"}

package/dist/theme/utils/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Theme Utilities
+ *
+ * @module theme/utils
+ */
+export * from './color.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/theme/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/theme/utils/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,YAAY,CAAC"}