/**
 * Hook for managing color mode (light/dark theme) state.
 *
 * @experimental This hook is experimental and may change in future versions.
 *
 * This hook provides access to the current color mode and functions to change it.
 * It integrates with the next-themes library to handle theme persistence and system preference detection.
 *
 * @returns An object containing:
 *   - `colorMode`: The current resolved theme ('light' | 'dark' | 'system' | undefined)
 *   - `setColorMode`: Function to set a specific color mode
 *   - `toggleColorMode`: Function to toggle between light and dark modes
 *
 * @example
 * ```tsx
 * function ThemeToggle() {
 *   const { colorMode, toggleColorMode } = useColorMode();
 *
 *   return (
 *     <button onClick={toggleColorMode}>
 *       Current mode: {colorMode}
 *     </button>
 *   );
 * }
 * ```
 */
export declare function useColorMode(): {
    colorMode: string | undefined;
    setColorMode: import('react').Dispatch<import('react').SetStateAction<string>>;
    toggleColorMode: () => void;
};