import type { Ref } from '@stacksjs/stx';
/**
 * Reactive color mode (dark / light / custom) with auto-detection and persistence.
 */
export declare function useColorMode(options?: UseColorModeOptions): UseColorModeReturn;
export declare interface UseColorModeOptions {
  attribute?: string
  initialValue?: ColorMode
  modes?: Record<string, string>
  storageKey?: string
  selector?: string
}
export declare interface UseColorModeReturn {
  mode: Ref<ColorMode>
  system: Ref<'dark' | 'light'>
  store: Ref<ColorMode>
}
export type ColorMode = 'dark' | 'light' | 'auto' | (string & {});