export type ColorScheme = 'light' | 'dark' | 'auto';
export type ResolvedColorScheme = 'light' | 'dark';
/**
 * 处理颜色主题的 Hook
 *
 * 特性：
 * - 支持 'light' | 'dark' | 'auto' 三种模式
 * - 自动监听系统主题变化（auto 模式）
 * - 同步更新 document.documentElement.dataset.colorScheme
 * - 支持 SSR，服务端默认返回 'light'
 * - 使用 useLayoutEffect 确保主题在绘制前应用，避免闪烁
 *
 * @param colorScheme - 主题模式，默认为 'light'
 * @returns 当前实际应用的主题 'light' | 'dark'
 */
export declare function useColorScheme(colorScheme?: ColorScheme): ResolvedColorScheme;