import type { RGB, RawImage } from './types.js';
import type { AsciiFrame } from './frame.js';
export interface CompositeOptions {
    /** mono only; default white. */
    foreground?: RGB;
    /** mono default black; 'foreground' mode default null (transparent backdrop). */
    background?: RGB | null;
}
/**
 * Reference CPU compositor: blends the profile atlas with per-cell colors into
 * RGBA pixels at native atlas cell size. Pure function — no DOM. Pass `reuse`
 * (a previous result) to avoid reallocating the pixel buffer every frame.
 */
export declare function compositeFrame(frame: AsciiFrame, options?: CompositeOptions, reuse?: RawImage): RawImage;