import type { DesktopWindow } from "@oh-my-pi/pi-natives";
/**
 * What `computer.apps.open` does for an app with no listed window: on macOS it also shows a window of a running app
 * that has none and returns it; elsewhere it only launches. A read-only run still gets the hint, since the next call
 * can open the app.
 */
export type AppOpenRoute = "shows-window" | "launches";
/** Matches a lowercased app-name substring or PID membership for a resolved application identity. */
export declare function matchesWindowApp(window: DesktopWindow, app: string, pids?: ReadonlySet<number>): boolean;
/** Lists the open windows by app, apps matching `app` first, for a selector that matched nothing. */
export declare function describeWindowMiss(windows: readonly DesktopWindow[], app: string | undefined, route: AppOpenRoute, pids?: ReadonlySet<number>): string;