/**
 * Clipboard Utility — modern & legacy clipboard access.
 *
 * Supports text, rich text (HTML), and files/images.
 * Automatically falls back to `document.execCommand` when
 * the Clipboard API is unavailable.
 *
 * @example
 * await copyToClipboard('Hello, world!');
 * const text = await readFromClipboard();
 * await copyRichText('<b>Bold</b>', 'Bold');
 */
export interface ClipboardResult {
    success: boolean;
    error?: string;
}
/**
 * Copy plain text to the clipboard.
 * Returns `{ success: true }` on success or `{ success: false, error }` on failure.
 */
export declare function copyTextToClipboard(text: string): Promise<ClipboardResult>;
/**
 * Copy both a plain-text and an HTML version of content to the clipboard.
 * The receiving application will use whichever type it prefers.
 */
export declare function copyRichText(html: string, plainText: string): Promise<ClipboardResult>;
/**
 * Copy an image (Blob or File) to the clipboard.
 * Requires Clipboard API with write support.
 */
export declare function copyImage(blob: Blob): Promise<ClipboardResult>;
/**
 * Read plain text from the clipboard.
 * Returns null if the clipboard is empty or permission is denied.
 */
export declare function readFromClipboard(): Promise<string | null>;
/**
 * Read clipboard items (may include HTML, images, etc.).
 * Returns null if the API is unavailable.
 */
export declare function readClipboardItems(): Promise<ClipboardItem[] | null>;
/**
 * Check if the Clipboard API (both read & write) is available.
 */
export declare function isClipboardSupported(): boolean;
/**
 * Request clipboard read permission.
 * Returns `'granted' | 'denied' | 'prompt' | 'unsupported'`.
 */
export declare function requestClipboardPermission(mode?: 'read' | 'write'): Promise<PermissionState | 'unsupported'>;
//# sourceMappingURL=clipboard.d.ts.map