/**
 * @license
 * Copyright 2025 Vybestack LLC
 * SPDX-License-Identifier: Apache-2.0
 */
/**
 * Result of a clipboard copy operation.
 * Issue #885: Provides feedback on copy success/failure for better error handling.
 */
export interface CopyResult {
    /** Whether the copy was successful */
    success: boolean;
    /** The text that was copied (or attempted to be copied) */
    text: string;
    /** Error message if the copy failed */
    error?: string;
}
export declare function buildOsc52(text: string): string;
export declare function writeOsc52ToTerminal(text: string, stdout?: NodeJS.WriteStream): void;
/**
 * Copy text to the system clipboard.
 * Issue #885: Returns a result object indicating success/failure for better error handling.
 *
 * @param text - The text to copy
 * @param stdout - The stdout stream to use for OSC52 (default: process.stdout)
 * @returns CopyResult indicating success/failure
 */
export declare function copyTextToClipboard(text: string, stdout?: NodeJS.WriteStream): Promise<CopyResult>;
