import type { Appearance, ColorScheme } from "#appearance";
/**
 * Detects the OS color scheme preference.
 *
 * Uses `matchMedia()` to query the `prefers-color-scheme` media feature.
 * Returns {@link DEFAULT_COLOR_SCHEME} during SSR since `window` is unavailable.
 *
 * @returns 'light' or 'dark' based on OS preference
 *
 * @since 0.3.16-canary.0
 */
export declare function getSystemColorScheme(): ColorScheme;
/**
 * Resolves an appearance preference to the color scheme to apply.
 *
 * - 'light' → 'light'
 * - 'dark' → 'dark'
 * - 'automatic' → on the client, result of {@link getSystemColorScheme};
 *   on the server, {@link DEFAULT_COLOR_SCHEME}
 *
 * @since 0.3.16-canary.0
 */
export declare function resolveColorScheme(appearance: Appearance): ColorScheme;