/**
 * Palette Generator Utility
 *
 * Converts a hex color to an 11-step OKLCH palette using
 * Tailwind-matched lightness/chroma curves. The hue is extracted
 * from the input color and applied across all steps.
 */
export interface PaletteStep {
    /** Tailwind step number: 50, 100, 200 ... 950 */
    step: number;
    /** OKLCH CSS string, e.g. "oklch(0.9778 0.0108 270)" */
    oklch: string;
    /** Approximate sRGB hex for preview swatches */
    hex: string;
}
export interface GeneratedPalette {
    /** Semantic name, e.g. "primary" */
    name: string;
    /** Extracted OKLCH hue (degrees) */
    hue: number;
    /** 11 palette steps from 50 to 950 */
    steps: PaletteStep[];
    /** Auto-calculated contrast color (hex) for text on the base step */
    contrast: 'light' | 'dark';
}
export interface GeneratePaletteOptions {
    /** Scales chroma up/down. Default 1.0 */
    vibrancy?: number;
}
/**
 * Generate an 11-step OKLCH palette from a single hex color.
 * Extracts the hue from the input and applies Tailwind-matched
 * lightness and chroma curves.
 */
export declare function generatePalette(hex: string, name?: string, options?: GeneratePaletteOptions): GeneratedPalette | null;
/**
 * Generate a complete CSS variable block for all semantic colors.
 *
 * @param palettes - Map of semantic name → hex color
 * @param options - Generation options (vibrancy)
 * @returns Object with `theme` (for @theme block) and `root` (for :root block) CSS strings
 */
export declare function generateThemeCSS(palettes: Record<string, string>, options?: GeneratePaletteOptions): {
    theme: string;
    root: string;
} | null;
