import type { AppearanceContextValue } from "#appearance";
/**
 * Hook to access appearance context.
 *
 * Uses React 19's `use()` API for context consumption, enabling:
 * - Conditional context reading
 * - Better Suspense boundary integration
 *
 * @returns Appearance context with `appearance`, `colorScheme`, `setAppearance`, and `isPending`
 * @throws Error if called outside of AppearanceProvider
 *
 * @example
 * ```tsx
 * function AppearanceToggle() {
 *   const { appearance, setAppearance, isPending } = useAppearance();
 *
 *   return (
 *     <button
 *       onClick={() => setAppearance(appearance === 'dark' ? 'light' : 'dark')}
 *       disabled={isPending}
 *     >
 *       {appearance}
 *     </button>
 *   );
 * }
 * ```
 *
 * @since 0.5.0-canary.2
 */
export declare function useAppearance(): AppearanceContextValue;