@agi-fans/dsh-tui 0.20.0 → 0.22.0

package/lib/views/prompt-selector.d.ts

@@ -25,6 +25,8 @@ export interface PromptSelectorState {
     feedback?: boolean;
     /** Editing or Take time paused this local countdown. */
     waitHeld?: boolean;
+    /** Timestamp before which keyboard confirmation is ignored. */
+    armedUntil?: number;
 }
 export interface PromptSelectorFrame {
     image?: import('../chrome/terminal-images.ts').ImagePlacement;
@@ -60,13 +62,41 @@ export declare function renderPromptTreePage(state: PromptSelectorState, theme:
 export declare function movePromptTree(state: PromptSelectorState, direction: 'left' | 'right', query: string): PromptSelectorState;
 /** Start on a matching node instead of a context-only ancestor. */
 export declare function searchPromptSelection(state: PromptSelectorState, query: string): PromptSelectorState;
-/** Visible option window centered around the selected row. */
 export declare function promptSelectorVisibleRange(count: number, selected: number, maxVisible?: number): {
     start: number;
     end: number;
 };
-/** Render an OMP-style full-height searchable selector with one outer frame. */
-export declare function renderPromptSelectorPage(state: PromptSelectorState, theme: Theme, width: number, height: number, input: string, inputCursor: number, appName: string): PromptSelectorFrame;
+/**
+ * Case-insensitive find over rows the reader can already see.
+ *
+ * A rendered page has no source model to search, so the rows are the document.
+ * Offsets are display cells, not string indexes, so CJK and emoji highlights land
+ * on the glyphs the reader pointed at rather than shearing them.
+ */
+export declare function findInRows(rows: readonly string[], query: string): TextMatch[];
+/** One occurrence of a find query in a rendered document row. */
+export interface TextMatch {
+    row: number;
+    /** First cell of the hit, and how many cells it covers. */
+    start: number;
+    width: number;
+}
+/** Invert the matched cells of one styled row. */
+export declare function highlightMatches(line: string, spans: readonly {
+    start: number;
+    width: number;
+}[], theme: Theme): string;
+/** The rows a rendered document shows, shared with the find that searches them. */
+export declare function documentRows(request: TuiPrompt, theme: Theme, width: number): string[];
+/**
+ * Does this prompt need the whole screen?
+ *
+ * Only a tree does. Length is not the question — a long list is still a list, and
+ * the card windows its rows, filters by typing, and draws the selected row's
+ * preview — so counting rows was the wrong variable. Choosing is a different act
+ * from reading, and a choice belongs beside the conversation it interrupted.
+ */
+export declare function promptNeedsPage(request: TuiPrompt): boolean;
 /** Reserve a bordered, padded rectangle; graphics never become display-row content. */
 export declare function renderImagePreviewPage(state: PromptSelectorState, theme: Theme, width: number, height: number, appName: string, protocol?: ImageProtocol, cell?: {
     width: number;
@@ -78,7 +108,7 @@ export declare function renderPromptSelector(state: PromptSelectorState, theme:
 /** Keep a selected option index within the available prompt options. */
 export declare function movePromptSelection(state: PromptSelectorState, next: number, count?: number): PromptSelectorState;
 /** Toggle the active row for a multi-select prompt. */
-export declare function togglePromptSelection(state: PromptSelectorState): PromptSelectorState;
+export declare function togglePromptSelection(state: PromptSelectorState, query?: string): PromptSelectorState;
 /** Resolve the selected labels in stable option order. */
 export declare function selectedPromptAnswer(state: PromptSelectorState): string | null;
 /** Resolve the selected answer after applying a full-screen selector query. */