import type { ScreenName } from "../screens/screen.js";
import type { Element } from "../../tui/elements.js";
import type { KeyEvent } from "../../tui/input/types.js";
import type { RowMarks } from "../marks.js";
import type { TreeNode } from "../types.js";
export type Viewport = {
    rows: number;
    cols: number;
};
export type ViewAction = {
    kind: "openScreen";
    screen: ScreenName;
    focusId?: string;
} | {
    kind: "selectTrace";
    traceId: string;
    query?: string;
} | {
    kind: "openOccurrences";
    groupKey: string;
} | {
    kind: "openDetail";
    rowId: string;
} | {
    kind: "back";
} | {
    kind: "promptLine";
    label: string;
    onResult: (text: string) => void;
} | {
    kind: "copy";
    text: string;
} | {
    kind: "extractTrace";
    traceId: string;
}
/** Copy every statelog line of one trace as JSONL. The shell owns the
 *  events, so the view can only name the trace. */
 | {
    kind: "copyTrace";
    traceId: string;
} | {
    kind: "none";
};
export type View = {
    viewName: "tracePicker" | "occurrences" | "detail";
    /** Synchronous. Viewport is a parameter so views own their paging keys
     *  (Ctrl-F/B/D/U are viewport arithmetic — the old shell kept them out
     *  of the reducer for exactly that reason). */
    handleKey(ev: KeyEvent, viewport: Viewport): ViewAction;
    render(viewport: Viewport, sharedHints?: string): Element;
    /** Follow mode: a fresh forest. UI state (cursor, drill, zoom) survives
     *  by id / absolute time; ids that no longer resolve fall back. */
    setData(roots: TreeNode[]): void;
    /** Content of the shell's `?` overlay while this view is active. */
    helpLines(): string[];
    /** Shell feedback (copy result, stale-view notes) → the view's message bar. */
    notify(message: string): void;
    /** Follow mode is shell-owned; views only display it (status bar / header). */
    setFollowIndicator(on: boolean): void;
    escape?(): boolean;
    capturesText?(): boolean;
    /** Comment marks, as data: which rows carry a comment and what it says.
     *  Optional; a view that draws none ignores them. */
    setMarks?(marks: RowMarks): void;
};
export type ViewStack = {
    active(): View | undefined;
    all(): View[];
    push(view: View): void;
    /** `open` semantics: pop back to an existing instance of `name` if one
     *  is on the stack (true), else report absent (false) so the shell
     *  constructs and pushes one. */
    popTo(name: View["viewName"]): boolean;
    /** Remove the top overlay, if present. */
    pop(): void;
};
export declare function makeViewStack(): ViewStack;