/**
 * Full-featured color-mode manager.
 *
 * @example
 * ```ts
 * const { mode, isDark, toggle, set } = useColorMode()
 * toggle()           // switch light↔dark
 * set('auto')        // follow system preference
 * ```
 */
export declare function useColorMode(options?: ColorModeOptions): ColorModeRef;
/**
 * Convenience wrapper — just isDark, toggle, set.
 *
 * @example
 * ```ts
 * const { isDark, toggle } = useDark()
 * toggle()
 * ```
 */
export declare function useDark(options?: ColorModeOptions): DarkRef;
export declare interface ColorModeOptions {
  storageKey?: string
  initialMode?: ColorMode
  darkClass?: string
  attribute?: string
  disableTransitions?: boolean
}
export declare interface ColorModeRef {
  readonly mode: 'light' | 'dark'
  readonly preference: ColorMode
  readonly isDark: boolean
  set: (mode: ColorMode) => void
  toggle: () => void
  subscribe: (fn: (mode: 'light' | 'dark', preference: ColorMode) => void) => () => void
}
export declare interface DarkRef {
  readonly isDark: boolean
  toggle: () => void
  set: (dark: boolean) => void
  subscribe: (fn: (isDark: boolean) => void) => () => void
}
/**
 * useColorMode / useDark — Theme management composables
 *
 * Detect system preference, persist user choice, toggle dark/light mode,
 * and sync across tabs — all with auto-cleanup.
 */
// =============================================================================
// Types
// =============================================================================
export type ColorMode = 'light' | 'dark' | 'auto';
