export type TokenValue = string;
export type TokenGroup = {
    [key: string]: TokenValue | TokenGroup;
};
export interface ColorTokens extends Record<string, any> {
    primary: string;
    bg: {
        primary: string;
        secondary: string;
    } & Record<string, string>;
    text: {
        base: string;
        primary?: string;
    } & Record<string, string>;
    border: {
        base: string;
        primary?: string;
    } & Record<string, string>;
    status: {
        info: string;
        danger: string;
        warning: string;
        success: string;
    } & Record<string, string>;
}
export interface SpacingTokens extends Record<string, string> {
    xs: string;
    sm: string;
    md: string;
    lg: string;
    xl: string;
    '2xl': string;
}
export interface RadiusTokens extends Record<string, string> {
    none: string;
    sm: string;
    md: string;
    lg: string;
    xl: string;
    full: string;
}
export interface TypographyTokens extends Record<string, string> {
    xs: string;
    sm: string;
    md: string;
    lg: string;
    xl: string;
    '2xl': string;
}
export interface SizeTokens extends Record<string, string> {
    xs: string;
    sm: string;
    md: string;
    lg: string;
    xl: string;
}
export interface DesignTokens {
    colors: ColorTokens;
    spacing: SpacingTokens;
    radius: RadiusTokens;
    fontSize: TypographyTokens;
    componentSize: SizeTokens;
}
/** Flatten a nested token object into flat key-value pairs.
 *  e.g. { bg: { primary: '#fff' } } → { 'bg-primary': '#fff' }
 */
export declare function flattenTokens(tokens: TokenGroup | Record<string, string>, prefix?: string): Record<string, string>;
/** Generate darken / lighten / fade variants for each flat color entry.
 *  IMPORTANT: this function is THE SINGLE SOURCE OF TRUTH for color math.
 *  Both UnoCSS (build-time) and ConfigProvider (runtime) must use this.
 */
export declare function deriveColorVariants(flatColors: Record<string, string>): Record<string, string>;
/** Convert flat CSS-var–based colors into the shape UnoCSS theme.colors expects.
 *  e.g. 'bg-primary' → { 'bg.primary': 'var(--sh-bg-primary)' }
 */
export declare function buildUnoColorMap(flatColors: Record<string, string>, cssVarPrefix?: string): Record<string, string>;
/** Generate a CSS string of `:root { --sh-*: value; }` declarations.
 *  Used for static baseline stylesheet (SSR-safe).
 */
export declare function generateCssVarBlock(flatTokens: Record<string, string>, prefix?: string): string;