/**
 * terminal-images — inline image rendering for iTerm2/WezTerm/mintty/Kitty.
 *
 * Uses the iTerm2 inline image protocol:
 *   \x1b]1337;File=<params>:<base64>\x07
 *
 * Terminals that don't support this protocol will ignore the escape.
 * Falls back to showing [Image: path] for unsupported terminals.
 */
export interface InlineImageOptions {
    /** Width in cells or "auto". */
    width?: number | 'auto';
    /** Height in cells or "auto". */
    height?: number | 'auto';
    /** Whether to preserve aspect ratio (default: true). */
    preserveAspectRatio?: boolean;
}
/**
 * Render an image inline using the iTerm2 image protocol.
 *
 * Returns the escape sequence string that, when written to stdout,
 * displays the image inline in supported terminals.
 *
 * Falls back to `[Image: filename]` if the file cannot be read.
 */
export declare function inlineImage(filePath: string, opts?: InlineImageOptions): string;
/**
 * Check if the current terminal supports inline images.
 */
export declare function supportsInlineImages(): boolean;
/**
 * Check if a file path points to an image based on extension.
 */
export declare function isImageFile(filePath: string): boolean;
