/** Why an attempted clipboard write failed. */
export type LyraCopyErrorReason='unsupported'|'denied'|'failed';
/** A clipboard write that reached the owning browsing context and fulfilled. */
export interface LyraClipboardWriteSuccess{readonly ok:true;readonly text:string;}
/** A clipboard write that could not be completed. */
export interface LyraClipboardWriteFailure{readonly ok:false;readonly text:string;readonly reason:LyraCopyErrorReason;readonly error:unknown;}
/** The settled, immutable outcome of one clipboard write. */
export type LyraClipboardWriteOutcome=LyraClipboardWriteSuccess|LyraClipboardWriteFailure;
/** Classifies a platform clipboard failure without relying on an ambient-realm constructor. */
export declare function clipboardFailureReason(error:unknown):LyraCopyErrorReason;
/**
* Writes through the exact window that owns a component and returns one settled outcome instead
* of mixing activation intent with clipboard success. Missing APIs, synchronous throws, and
* rejected promises all take the same failure path; no ambient global is consulted.
*/
export declare function writeClipboardText(owner:Window|null|undefined,text:string):Promise<LyraClipboardWriteOutcome>;