/**
 * Color utilities for CLI output.
 *
 * Uses picocolors for terminal coloring, with automatic detection
 * of when colors should be disabled (NO_COLOR, --no-color, non-TTY, etc).
 *
 * @example
 * ```ts
 * import { colors } from "./utils/colors.js";
 * console.log(colors.red("Error!"));
 * console.log(colors.bold(colors.green("Success")));
 * ```
 */
type ColorFunction = (text: string | number) => string;
interface Colors {
    reset: ColorFunction;
    bold: ColorFunction;
    dim: ColorFunction;
    italic: ColorFunction;
    underline: ColorFunction;
    inverse: ColorFunction;
    hidden: ColorFunction;
    strikethrough: ColorFunction;
    black: ColorFunction;
    red: ColorFunction;
    green: ColorFunction;
    yellow: ColorFunction;
    blue: ColorFunction;
    magenta: ColorFunction;
    cyan: ColorFunction;
    white: ColorFunction;
    gray: ColorFunction;
    bgBlack: ColorFunction;
    bgRed: ColorFunction;
    bgGreen: ColorFunction;
    bgYellow: ColorFunction;
    bgBlue: ColorFunction;
    bgMagenta: ColorFunction;
    bgCyan: ColorFunction;
    bgWhite: ColorFunction;
}
/**
 * Get the colors object, respecting NO_COLOR, --no-color, and TTY detection.
 *
 * Note: This checks shouldUseColor() on each call, so the --no-color flag
 * can be set after import and will still be respected.
 */
export declare function getColors(): Colors;
/**
 * Convenience export for direct usage.
 * Use getColors() if you need dynamic color detection after flag parsing.
 *
 * @example
 * ```ts
 * import { colors } from "./utils/colors.js";
 * console.log(colors.red("Error"));
 * ```
 */
export declare const colors: Colors;
export {};
//# sourceMappingURL=colors.d.ts.map