/**
 * 将主题变量应用到文档根节点
 * 仅在浏览器环境执行，SSR 安全
 */
import type { ThemeTokenOverrides } from './types';
/**
 * 将一组 CSS 变量应用到 :root (document.documentElement)
 * @param overrides 变量名 -> 值的映射，如 { '--color-gray-text-default': '#fff' }
 */
export declare function applyTheme(overrides: ThemeTokenOverrides): void;
/**
 * 移除此前通过 applyTheme 设置过的变量（用于切换回 light 时清理 dark 的覆盖）
 * @param keys 要移除的 CSS 变量名列表
 */
export declare function clearThemeOverrides(keys: string[]): void;
/**
 * 应用主题并返回本次写入的 key 列表，便于后续 clearThemeOverrides(keys)
 */
export declare function applyThemeAndReturnKeys(overrides: ThemeTokenOverrides): string[];