/**
 * Text shadow design tokens for BeatUI.
 *
 * Defines a scale of CSS `text-shadow` values for enhancing text readability
 * and visual depth. Includes both primitive size-based shadows and semantic
 * roles for button text styles.
 *
 * @module
 */
/**
 * Text shadow scale definitions mapping size names to CSS `text-shadow` values.
 * Shadows increase in intensity from `2xs` (subtle) to `lg` (dramatic).
 */
export declare const textShadows: {
    readonly none: "none";
    readonly '2xs': "0px 1px 0px rgb(0 0 0 / 0.15)";
    readonly xs: "0px 1px 1px rgb(0 0 0 / 0.2)";
    readonly sm: "0px 1px 0px rgb(0 0 0 / 0.075), 0px 1px 1px rgb(0 0 0 / 0.075), 0px 2px 2px rgb(0 0 0 / 0.075)";
    readonly md: "0px 1px 1px rgb(0 0 0 / 0.1), 0px 1px 2px rgb(0 0 0 / 0.1), 0px 2px 4px rgb(0 0 0 / 0.1)";
    readonly lg: "0px 1px 2px rgb(0 0 0 / 0.1), 0px 3px 2px rgb(0 0 0 / 0.1), 0px 4px 8px rgb(0 0 0 / 0.1)";
};
/**
 * Union type of all available text shadow size names.
 */
export type TextShadowSize = keyof typeof textShadows;
/**
 * Tuple of all semantic text shadow role names.
 */
export declare const semanticTextShadowNames: readonly ["button-filled", "button-light", "button-default"];
/**
 * Union type of all semantic text shadow role names.
 */
export type SemanticTextShadowName = (typeof semanticTextShadowNames)[number];
/**
 * Partial record for overriding default semantic text shadow assignments.
 */
export type SemanticTextShadowOverrides = Partial<Record<SemanticTextShadowName, string>>;
/**
 * Returns the CSS custom property name for a text shadow size.
 *
 * @param size - The text shadow size name
 * @returns The CSS variable name (e.g., `'--text-shadow-sm'`)
 *
 * @example
 * ```ts
 * getTextShadowVarName('sm') // '--text-shadow-sm'
 * ```
 */
export declare function getTextShadowVarName(size: TextShadowSize): string;
/**
 * Returns a CSS `var()` expression referencing the text shadow custom property.
 *
 * @param size - The text shadow size name
 * @returns A CSS `var()` string (e.g., `'var(--text-shadow-sm)'`)
 *
 * @example
 * ```ts
 * getTextShadowVar('sm') // 'var(--text-shadow-sm)'
 * ```
 */
export declare function getTextShadowVar(size: TextShadowSize): string;
/**
 * Generates CSS custom property declarations for all text shadow tokens.
 *
 * @returns A record mapping CSS variable names to their text shadow values
 *
 * @example
 * ```ts
 * const vars = generateTextShadowVariables()
 * // vars['--text-shadow-sm'] === '0px 1px 0px rgb(0 0 0 / 0.075), ...'
 * ```
 */
export declare function generateTextShadowVariables(): Record<string, string>;
/**
 * Returns the CSS custom property name for a semantic text shadow role.
 *
 * @param name - The semantic text shadow name
 * @returns The CSS variable name (e.g., `'--text-shadow-button-filled'`)
 *
 * @example
 * ```ts
 * getSemanticTextShadowVarName('button-filled') // '--text-shadow-button-filled'
 * ```
 */
export declare function getSemanticTextShadowVarName(name: SemanticTextShadowName): string;
/**
 * Generates CSS custom property declarations for semantic text shadow tokens,
 * merging defaults with any provided overrides.
 *
 * @param overrides - Optional overrides for semantic text shadow values
 * @returns A record mapping CSS variable names to their values
 *
 * @example
 * ```ts
 * const vars = generateSemanticTextShadowVariables({ 'button-filled': 'var(--text-shadow-lg)' })
 * // vars['--text-shadow-button-filled'] === 'var(--text-shadow-lg)'
 * ```
 */
export declare function generateSemanticTextShadowVariables(overrides?: SemanticTextShadowOverrides): Record<string, string>;