/**
 * Calculates the contrast ratio of two different hex colors.
 */
export declare function calculateContrastRatio(hexColor: string, secondHexColor: string): number;

/**
 * Calculates the luminance of a given Hex color.
 */
export declare function calculateLuminance(hexColor: string): number;

/**
 * Calculates a corresponding rgb color (EX: rgb(0, 0, 0, 0.5)) based on the given canvas color and transparency value.
 */
export declare function calculateShadow(foregroundColor: string, opacity: number): string;

/**
 * Calculates a corresponding hex color (EX: #fffff) based on the given background color and transparency value.
 */
export declare function calculateTransparentColor(foregroundColor: string, backgroundColor: string, opacity: number): string;

/**
 * Converts a given hex color (EX: #fffff) to RGB (EX: rgb(255,255,255))
 */
export declare function colorHexToRGB(hexColor: string): {
    r: number;
    g: number;
    b: number;
} | undefined;

/**
 * Converts a given RGB color (EX: rgb(255,255,255)) to its corresponding Hex value (EX: #fffff).
 */
export declare function colorRGBToHex(red: number, green: number, blue: number): string | undefined;

/**
 * The subset collection of semantic colors and their different states.
 * Example: brand, brandPressed, brandHover, ...
 */
export declare type ColorSet<T extends string | number> = {
    [key in ColorSetKey<T> | 'elevate' | 'hoverShadow']: string;
};

declare type ColorSetKey<T extends string | number> = T | `${T}Hover` | `${T}Pressed` | `${T}Disabled` | `${T}ForegroundHover` | `${T}ForegroundPressed` | `${T}Background` | `${T}BackgroundDisabled`;

/**
 * Generates a set of semantic color values that correspond with the given colors.
 */
export declare const createSemanticColor: <T extends string | number>(semanticColors: SemanticColors<T>, canvasColor: string) => ColorSet<T>;

/**
 * Formats a given hex value
 */
export declare function formatHex(value: string): string;

/**
 * Inverts the given hex color.
 * Example: #ffffff becomes #000000
 */
export declare function invertColor(hexColor: string): string;

declare type SemanticColorKey<T extends string | number> = T;

/**
 * The collection of SemanticColors (brand, secondary, success, ...).
 */
export declare type SemanticColors<T extends string | number> = {
    [key in SemanticColorKey<T>]: string;
};

export declare function themeGenerator<T extends string | number>(props: ThemeGeneratorProps<T>): {
    textColor: string;
    canvasColor: string;
} & ColorSet<T>;

export declare type ThemeGeneratorProps<T extends string | number> = {
    /**
     * The color of your site's canvas.
     */
    canvasColor: string;
    /**
     * The set of semantic colors to generate various states for.
     *
     * - Example: brand: '#2060CF'
     * - Returns: brand: '#2060CF', brandHover: '...', brandPressed: '...', ...
     */
    semanticColors: SemanticColors<T>;
};

/**
 * Generates a set of Tokens (A map of CSS variable names) based on the provided Theme object.
 */
export declare function tokenGenerator<TTheme>(theme: TTheme): Record<keyof TTheme, string>;

export { }