import type { TerminalColorLevel, TerminalColorMode } from "./colors.js";
export type TerminalColorCapability = Readonly<{
    mode: TerminalColorMode;
    level: TerminalColorLevel;
}>;
/**
 * Detect terminal output color capability.
 *
 * - `mode` is the best-effort actual output mode.
 * - `level` is the CLI theme tier (256/16/8). `truecolor` folds into `256`.
 * - Pass `platform` (e.g. `process.platform`) to improve Windows detection.
 *
 * Env overrides:
 * - `VUE_TUI_COLOR_MODE` / legacy `DIMCODE_COLOR_MODE`
 */
export declare function detectTerminalColorCapability(opts?: Readonly<{
    env?: Record<string, unknown>;
    isTTY?: boolean;
    platform?: string;
}>): TerminalColorCapability;