import { type ClipboardImage } from "@oh-my-pi/pi-natives/clipboard";
/**
 * True when the clipboard this process reads is the one the user's terminal copies into.
 * Over SSH every backend reads a clipboard of the remote host (macOS `pbpaste`, the Windows host
 * behind WSL, Termux, a host-side X11/Wayland desktop). Even an X11-forwarded `DISPLAY` cannot be
 * trusted: a tmux session on the host keeps a stale `localhost:10.0` whose port a later SSH
 * session (possibly another user's) can own, so SSH never reads the system clipboard.
 */
export declare function isClipboardTerminalLocal(env?: NodeJS.ProcessEnv): boolean;
/**
 * Read file paths from the macOS pasteboard's `public.file-url` representation.
 *
 * Used to reach the Finder `Cmd+C` pasteboard (which exposes only file URLs,
 * no plain text or raw image bytes) so an image-file clipboard can be attached
 * via {@link handleImagePathPaste} instead of falling through to "Clipboard is
 * empty". Returns an empty array on non-darwin platforms, when AppleScript is
 * unavailable, or when the pasteboard holds no file URLs.
 */
export declare function readMacFileUrlsFromClipboard(): Promise<string[]>;
/**
 * Copy text to the system clipboard.
 *
 * Emits OSC 52 first when running in a real terminal (works over SSH/mosh),
 * then attempts native clipboard copy as best-effort for local sessions.
 * On Termux, tries `termux-clipboard-set` before native.
 *
 * The OSC 52 goes through `writeTerminalSequence`, so it cannot tear a TUI
 * frame; from a worker thread it is skipped and only the native copy runs.
 *
 * @param text - UTF-8 text to place on the clipboard.
 */
export declare function copyToClipboard(text: string): Promise<void>;
/**
 * Read an image from the system clipboard.
 *
 * Returns null on Termux (no image clipboard support) or when no display
 * server is available (headless/SSH without forwarding). Native Windows trusts
 * the native reader's "no image" answer — it returns null only when no bitmap
 * format is on the clipboard, and throws when one is present but undecodable —
 * so `powershell.exe` starts only after a throw and a text-only clipboard never
 * waits on a cold PowerShell start. WSL reaches the host clipboard through
 * `powershell.exe`.
 *
 * @returns A supported image payload or null when no image is available.
 */
export declare function readImageFromClipboard(): Promise<ClipboardImage | null>;
/**
 * Read plain text from the system clipboard.
 *
 * Native Windows reads through the native addon and only falls back to
 * `powershell.exe` when that read throws.
 */
export declare function readTextFromClipboard(): Promise<string>;