@dsh-cc/pi-tui 0.5.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/PORTING.md +18 -0
- package/README.md +7 -0
- package/lib/alt-screen-search.d.ts +26 -0
- package/lib/alt-screen-search.d.ts.map +1 -0
- package/lib/alt-screen-search.js +122 -0
- package/lib/alt-screen-search.js.map +1 -0
- package/lib/autocomplete.d.ts +56 -0
- package/lib/autocomplete.d.ts.map +1 -0
- package/lib/autocomplete.js +632 -0
- package/lib/autocomplete.js.map +1 -0
- package/lib/components/alt-screen-flash.d.ts +13 -0
- package/lib/components/alt-screen-flash.d.ts.map +1 -0
- package/lib/components/alt-screen-flash.js +37 -0
- package/lib/components/alt-screen-flash.js.map +1 -0
- package/lib/components/box.d.ts +22 -0
- package/lib/components/box.d.ts.map +1 -0
- package/lib/components/box.js +104 -0
- package/lib/components/box.js.map +1 -0
- package/lib/components/cancellable-loader.d.ts +22 -0
- package/lib/components/cancellable-loader.d.ts.map +1 -0
- package/lib/components/cancellable-loader.js +35 -0
- package/lib/components/cancellable-loader.js.map +1 -0
- package/lib/components/editor.d.ts +255 -0
- package/lib/components/editor.d.ts.map +1 -0
- package/lib/components/editor.js +1961 -0
- package/lib/components/editor.js.map +1 -0
- package/lib/components/h-stack.d.ts +7 -0
- package/lib/components/h-stack.d.ts.map +1 -0
- package/lib/components/h-stack.js +43 -0
- package/lib/components/h-stack.js.map +1 -0
- package/lib/components/image.d.ts +28 -0
- package/lib/components/image.d.ts.map +1 -0
- package/lib/components/image.js +90 -0
- package/lib/components/image.js.map +1 -0
- package/lib/components/input.d.ts +37 -0
- package/lib/components/input.d.ts.map +1 -0
- package/lib/components/input.js +378 -0
- package/lib/components/input.js.map +1 -0
- package/lib/components/loader.d.ts +31 -0
- package/lib/components/loader.d.ts.map +1 -0
- package/lib/components/loader.js +69 -0
- package/lib/components/loader.js.map +1 -0
- package/lib/components/markdown.d.ts +103 -0
- package/lib/components/markdown.d.ts.map +1 -0
- package/lib/components/markdown.js +811 -0
- package/lib/components/markdown.js.map +1 -0
- package/lib/components/scroll-view.d.ts +56 -0
- package/lib/components/scroll-view.d.ts.map +1 -0
- package/lib/components/scroll-view.js +189 -0
- package/lib/components/scroll-view.js.map +1 -0
- package/lib/components/select-list.d.ts +50 -0
- package/lib/components/select-list.d.ts.map +1 -0
- package/lib/components/select-list.js +159 -0
- package/lib/components/select-list.js.map +1 -0
- package/lib/components/settings-list.d.ts +56 -0
- package/lib/components/settings-list.d.ts.map +1 -0
- package/lib/components/settings-list.js +202 -0
- package/lib/components/settings-list.js.map +1 -0
- package/lib/components/spacer.d.ts +12 -0
- package/lib/components/spacer.d.ts.map +1 -0
- package/lib/components/spacer.js +23 -0
- package/lib/components/spacer.js.map +1 -0
- package/lib/components/stack.d.ts +32 -0
- package/lib/components/stack.d.ts.map +1 -0
- package/lib/components/stack.js +111 -0
- package/lib/components/stack.js.map +1 -0
- package/lib/components/text.d.ts +19 -0
- package/lib/components/text.d.ts.map +1 -0
- package/lib/components/text.js +90 -0
- package/lib/components/text.js.map +1 -0
- package/lib/components/truncated-text.d.ts +13 -0
- package/lib/components/truncated-text.d.ts.map +1 -0
- package/lib/components/truncated-text.js +51 -0
- package/lib/components/truncated-text.js.map +1 -0
- package/lib/components/v-stack.d.ts +8 -0
- package/lib/components/v-stack.d.ts.map +1 -0
- package/lib/components/v-stack.js +26 -0
- package/lib/components/v-stack.js.map +1 -0
- package/lib/editor-component.d.ts +39 -0
- package/lib/editor-component.d.ts.map +1 -0
- package/lib/editor-component.js +2 -0
- package/lib/editor-component.js.map +1 -0
- package/lib/fuzzy.d.ts +16 -0
- package/lib/fuzzy.d.ts.map +1 -0
- package/lib/fuzzy.js +110 -0
- package/lib/fuzzy.js.map +1 -0
- package/lib/index.d.ts +31 -0
- package/lib/index.d.ts.map +1 -0
- package/lib/index.js +42 -0
- package/lib/index.js.map +1 -0
- package/lib/keybindings.d.ts +273 -0
- package/lib/keybindings.d.ts.map +1 -0
- package/lib/keybindings.js +233 -0
- package/lib/keybindings.js.map +1 -0
- package/lib/keys.d.ts +184 -0
- package/lib/keys.d.ts.map +1 -0
- package/lib/keys.js +1174 -0
- package/lib/keys.js.map +1 -0
- package/lib/kill-ring.d.ts +28 -0
- package/lib/kill-ring.d.ts.map +1 -0
- package/lib/kill-ring.js +44 -0
- package/lib/kill-ring.js.map +1 -0
- package/lib/latex.d.ts +10 -0
- package/lib/latex.d.ts.map +1 -0
- package/lib/latex.js +1271 -0
- package/lib/latex.js.map +1 -0
- package/lib/layout-node.d.ts +40 -0
- package/lib/layout-node.d.ts.map +1 -0
- package/lib/layout-node.js +6 -0
- package/lib/layout-node.js.map +1 -0
- package/lib/layout.d.ts +40 -0
- package/lib/layout.d.ts.map +1 -0
- package/lib/layout.js +321 -0
- package/lib/layout.js.map +1 -0
- package/lib/native-modifiers.d.ts +3 -0
- package/lib/native-modifiers.d.ts.map +1 -0
- package/lib/native-modifiers.js +54 -0
- package/lib/native-modifiers.js.map +1 -0
- package/lib/native-module-path.d.ts +7 -0
- package/lib/native-module-path.d.ts.map +1 -0
- package/lib/native-module-path.js +19 -0
- package/lib/native-module-path.js.map +1 -0
- package/lib/stdin-buffer.d.ts +56 -0
- package/lib/stdin-buffer.d.ts.map +1 -0
- package/lib/stdin-buffer.js +366 -0
- package/lib/stdin-buffer.js.map +1 -0
- package/lib/terminal-colors.d.ts +10 -0
- package/lib/terminal-colors.d.ts.map +1 -0
- package/lib/terminal-colors.js +59 -0
- package/lib/terminal-colors.js.map +1 -0
- package/lib/terminal-image.d.ts +116 -0
- package/lib/terminal-image.d.ts.map +1 -0
- package/lib/terminal-image.js +518 -0
- package/lib/terminal-image.js.map +1 -0
- package/lib/terminal.d.ts +117 -0
- package/lib/terminal.d.ts.map +1 -0
- package/lib/terminal.js +447 -0
- package/lib/terminal.js.map +1 -0
- package/lib/tui-alt-screen.d.ts +118 -0
- package/lib/tui-alt-screen.d.ts.map +1 -0
- package/lib/tui-alt-screen.js +1148 -0
- package/lib/tui-alt-screen.js.map +1 -0
- package/lib/tui-main-screen.d.ts +39 -0
- package/lib/tui-main-screen.d.ts.map +1 -0
- package/lib/tui-main-screen.js +533 -0
- package/lib/tui-main-screen.js.map +1 -0
- package/lib/tui.d.ts +308 -0
- package/lib/tui.d.ts.map +1 -0
- package/lib/tui.js +941 -0
- package/lib/tui.js.map +1 -0
- package/lib/undo-stack.d.ts +17 -0
- package/lib/undo-stack.d.ts.map +1 -0
- package/lib/undo-stack.js +25 -0
- package/lib/undo-stack.js.map +1 -0
- package/lib/utils.d.ts +96 -0
- package/lib/utils.d.ts.map +1 -0
- package/lib/utils.js +1191 -0
- package/lib/utils.js.map +1 -0
- package/lib/word-navigation.d.ts +25 -0
- package/lib/word-navigation.d.ts.map +1 -0
- package/lib/word-navigation.js +96 -0
- package/lib/word-navigation.js.map +1 -0
- package/package.json +42 -0
package/lib/tui.d.ts
ADDED
|
@@ -0,0 +1,308 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Minimal TUI implementation with differential rendering
|
|
3
|
+
*/
|
|
4
|
+
import type { Terminal } from "./terminal.ts";
|
|
5
|
+
import { type RgbColor, type TerminalColorScheme } from "./terminal-colors.ts";
|
|
6
|
+
import { visibleWidth } from "./utils.ts";
|
|
7
|
+
/**
|
|
8
|
+
* Component interface - all components must implement this
|
|
9
|
+
*/
|
|
10
|
+
export interface Component {
|
|
11
|
+
/**
|
|
12
|
+
* Render the component to lines for the given viewport width
|
|
13
|
+
* @param width - Current viewport width
|
|
14
|
+
* @returns Array of strings, each representing a line
|
|
15
|
+
*/
|
|
16
|
+
render(width: number): string[];
|
|
17
|
+
/**
|
|
18
|
+
* Optional handler for keyboard input when component has focus
|
|
19
|
+
*/
|
|
20
|
+
handleInput?(data: string): void;
|
|
21
|
+
/**
|
|
22
|
+
* If true, component receives key release events (Kitty protocol).
|
|
23
|
+
* Default is false - release events are filtered out.
|
|
24
|
+
*/
|
|
25
|
+
wantsKeyRelease?: boolean;
|
|
26
|
+
/**
|
|
27
|
+
* Invalidate any cached rendering state.
|
|
28
|
+
* Called when theme changes or when component needs to re-render from scratch.
|
|
29
|
+
*/
|
|
30
|
+
invalidate(): void;
|
|
31
|
+
}
|
|
32
|
+
export type TuiInputListenerResult = {
|
|
33
|
+
consume?: boolean;
|
|
34
|
+
data?: string;
|
|
35
|
+
} | undefined;
|
|
36
|
+
export type TuiInputListener = (data: string) => TuiInputListenerResult;
|
|
37
|
+
/**
|
|
38
|
+
* Interface for components that can receive focus and display a hardware cursor.
|
|
39
|
+
* When focused, the component should emit CURSOR_MARKER at the cursor position
|
|
40
|
+
* in its render output. TUI will find this marker and position the hardware
|
|
41
|
+
* cursor there for proper IME candidate window positioning.
|
|
42
|
+
*/
|
|
43
|
+
export interface Focusable {
|
|
44
|
+
/** Set by TUI when focus changes. Component should emit CURSOR_MARKER when true. */
|
|
45
|
+
focused: boolean;
|
|
46
|
+
}
|
|
47
|
+
/** Type guard to check if a component implements Focusable */
|
|
48
|
+
export declare function isFocusable(component: Component | null): component is Component & Focusable;
|
|
49
|
+
/**
|
|
50
|
+
* Cursor position marker - APC (Application Program Command) sequence.
|
|
51
|
+
* This is a zero-width escape sequence that terminals ignore.
|
|
52
|
+
* Components emit this at the cursor position when focused.
|
|
53
|
+
* TUI finds and strips this marker, then positions the hardware cursor there.
|
|
54
|
+
*/
|
|
55
|
+
export declare const CURSOR_MARKER = "\u001B_pi:c\u0007";
|
|
56
|
+
export { visibleWidth };
|
|
57
|
+
/**
|
|
58
|
+
* Anchor position for overlays
|
|
59
|
+
*/
|
|
60
|
+
export type OverlayAnchor = "center" | "top-left" | "top-right" | "bottom-left" | "bottom-right" | "top-center" | "bottom-center" | "left-center" | "right-center";
|
|
61
|
+
/**
|
|
62
|
+
* Margin configuration for overlays
|
|
63
|
+
*/
|
|
64
|
+
export interface OverlayMargin {
|
|
65
|
+
top?: number;
|
|
66
|
+
right?: number;
|
|
67
|
+
bottom?: number;
|
|
68
|
+
left?: number;
|
|
69
|
+
}
|
|
70
|
+
/** Value that can be absolute (number) or percentage (string like "50%") */
|
|
71
|
+
export type SizeValue = number | `${number}%`;
|
|
72
|
+
/**
|
|
73
|
+
* Options for overlay positioning and sizing.
|
|
74
|
+
* Values can be absolute numbers or percentage strings (e.g., "50%").
|
|
75
|
+
*/
|
|
76
|
+
export interface OverlayOptions {
|
|
77
|
+
/** Width in columns, or percentage of terminal width (e.g., "50%") */
|
|
78
|
+
width?: SizeValue;
|
|
79
|
+
/** Minimum width in columns */
|
|
80
|
+
minWidth?: number;
|
|
81
|
+
/** Maximum height in rows, or percentage of terminal height (e.g., "50%") */
|
|
82
|
+
maxHeight?: SizeValue;
|
|
83
|
+
/** Anchor point for positioning (default: 'center') */
|
|
84
|
+
anchor?: OverlayAnchor;
|
|
85
|
+
/** Horizontal offset from anchor position (positive = right) */
|
|
86
|
+
offsetX?: number;
|
|
87
|
+
/** Vertical offset from anchor position (positive = down) */
|
|
88
|
+
offsetY?: number;
|
|
89
|
+
/** Row position: absolute number, or percentage (e.g., "25%" = 25% from top) */
|
|
90
|
+
row?: SizeValue;
|
|
91
|
+
/** Column position: absolute number, or percentage (e.g., "50%" = centered horizontally) */
|
|
92
|
+
col?: SizeValue;
|
|
93
|
+
/** Margin from terminal edges. Number applies to all sides. */
|
|
94
|
+
margin?: OverlayMargin | number;
|
|
95
|
+
/**
|
|
96
|
+
* Control overlay visibility based on terminal dimensions.
|
|
97
|
+
* If provided, overlay is only rendered when this returns true.
|
|
98
|
+
* Called each render cycle with current terminal dimensions.
|
|
99
|
+
*/
|
|
100
|
+
visible?: (termWidth: number, termHeight: number) => boolean;
|
|
101
|
+
/** If true, don't capture keyboard focus when shown */
|
|
102
|
+
nonCapturing?: boolean;
|
|
103
|
+
}
|
|
104
|
+
/** Options for {@link OverlayHandle.unfocus}. */
|
|
105
|
+
export interface OverlayUnfocusOptions {
|
|
106
|
+
/** Explicit target to focus after releasing this overlay. */
|
|
107
|
+
target: Component | null;
|
|
108
|
+
}
|
|
109
|
+
/**
|
|
110
|
+
* Handle returned by showOverlay for controlling the overlay
|
|
111
|
+
*/
|
|
112
|
+
export interface OverlayHandle {
|
|
113
|
+
/** Permanently remove the overlay (cannot be shown again) */
|
|
114
|
+
hide(): void;
|
|
115
|
+
/** Temporarily hide or show the overlay */
|
|
116
|
+
setHidden(hidden: boolean): void;
|
|
117
|
+
/** Check if overlay is temporarily hidden */
|
|
118
|
+
isHidden(): boolean;
|
|
119
|
+
/** Focus this overlay and bring it to the visual front */
|
|
120
|
+
focus(): void;
|
|
121
|
+
/** Release focus to the next visible capturing overlay or previous target, or to an explicit target when provided */
|
|
122
|
+
unfocus(options?: OverlayUnfocusOptions): void;
|
|
123
|
+
/** Check if this overlay currently has focus */
|
|
124
|
+
isFocused(): boolean;
|
|
125
|
+
}
|
|
126
|
+
/**
|
|
127
|
+
* Container - a component that contains other components
|
|
128
|
+
*/
|
|
129
|
+
export declare class Container implements Component {
|
|
130
|
+
children: Component[];
|
|
131
|
+
addChild(component: Component): void;
|
|
132
|
+
removeChild(component: Component): void;
|
|
133
|
+
clear(): void;
|
|
134
|
+
invalidate(): void;
|
|
135
|
+
render(width: number): string[];
|
|
136
|
+
}
|
|
137
|
+
/** Composite overlay content into a terminal line at a fixed column. */
|
|
138
|
+
export declare function compositeTuiLine(baseLine: string, overlayLine: string, startCol: number, overlayWidth: number, totalWidth: number): string;
|
|
139
|
+
export type TuiMode = "regular" | "fullscreen";
|
|
140
|
+
export interface TuiStopOptions {
|
|
141
|
+
/** Leave renderer output in place for another TUI taking over the same terminal. */
|
|
142
|
+
preserveScreen?: boolean;
|
|
143
|
+
}
|
|
144
|
+
export interface TUI extends Component {
|
|
145
|
+
readonly mode: TuiMode;
|
|
146
|
+
children: Component[];
|
|
147
|
+
terminal: Terminal;
|
|
148
|
+
onDebug?: () => void;
|
|
149
|
+
readonly fullRedraws: number;
|
|
150
|
+
addChild(component: Component): void;
|
|
151
|
+
removeChild(component: Component): void;
|
|
152
|
+
clear(): void;
|
|
153
|
+
getShowHardwareCursor(): boolean;
|
|
154
|
+
setShowHardwareCursor(enabled: boolean): void;
|
|
155
|
+
getClearOnShrink(): boolean;
|
|
156
|
+
setClearOnShrink(enabled: boolean): void;
|
|
157
|
+
setFocus(component: Component | null): void;
|
|
158
|
+
showOverlay(component: Component, options?: OverlayOptions): OverlayHandle;
|
|
159
|
+
hideOverlay(): void;
|
|
160
|
+
hasOverlay(): boolean;
|
|
161
|
+
start(): void;
|
|
162
|
+
stop(options?: TuiStopOptions): void;
|
|
163
|
+
renderNow(force?: boolean): void;
|
|
164
|
+
requestRender(force?: boolean): void;
|
|
165
|
+
addInputListener(listener: TuiInputListener): () => void;
|
|
166
|
+
removeInputListener(listener: TuiInputListener): void;
|
|
167
|
+
onTerminalColorSchemeChange(listener: (scheme: TerminalColorScheme) => void): () => void;
|
|
168
|
+
setTerminalColorSchemeNotifications(enabled: boolean): void;
|
|
169
|
+
queryTerminalBackgroundColor(options: {
|
|
170
|
+
timeoutMs: number;
|
|
171
|
+
}): Promise<RgbColor | undefined>;
|
|
172
|
+
queryTerminalColorScheme(options: {
|
|
173
|
+
timeoutMs: number;
|
|
174
|
+
}): Promise<TerminalColorScheme | undefined>;
|
|
175
|
+
}
|
|
176
|
+
export declare const VIEWPORT_TUI: unique symbol;
|
|
177
|
+
export interface ViewportTUI extends TUI {
|
|
178
|
+
readonly [VIEWPORT_TUI]: true;
|
|
179
|
+
setLayoutRoot(component: Component | undefined): void;
|
|
180
|
+
}
|
|
181
|
+
export declare function isViewportTUI(tui: TUI): tui is ViewportTUI;
|
|
182
|
+
export declare abstract class TuiBase extends Container implements TUI {
|
|
183
|
+
abstract readonly mode: TuiMode;
|
|
184
|
+
terminal: Terminal;
|
|
185
|
+
private focusedComponent;
|
|
186
|
+
private inputListeners;
|
|
187
|
+
/** Global callback for debug key (Shift+Ctrl+D). Called before input is forwarded to focused component. */
|
|
188
|
+
onDebug?: () => void;
|
|
189
|
+
private renderRequested;
|
|
190
|
+
private immediateRenderScheduled;
|
|
191
|
+
private renderTimer;
|
|
192
|
+
private lastRenderAt;
|
|
193
|
+
private static readonly MIN_RENDER_INTERVAL_MS;
|
|
194
|
+
private showHardwareCursor;
|
|
195
|
+
private clearOnShrink;
|
|
196
|
+
protected fullRedrawCount: number;
|
|
197
|
+
protected stopped: boolean;
|
|
198
|
+
private pendingOsc11BackgroundReplies;
|
|
199
|
+
private pendingOsc11BackgroundQueries;
|
|
200
|
+
private terminalColorSchemeListeners;
|
|
201
|
+
private terminalColorSchemeNotificationsEnabled;
|
|
202
|
+
protected readonly logDirectory: string;
|
|
203
|
+
private focusOrderCounter;
|
|
204
|
+
private overlayStack;
|
|
205
|
+
get hasOverlayEntries(): boolean;
|
|
206
|
+
private overlayFocusRestore;
|
|
207
|
+
constructor(terminal: Terminal, showHardwareCursor?: boolean, logDirectory?: string);
|
|
208
|
+
protected abstract doRender(): void;
|
|
209
|
+
protected resetRenderState(): void;
|
|
210
|
+
protected beforeTerminalStart(): void;
|
|
211
|
+
protected afterTerminalStart(): void;
|
|
212
|
+
protected beforeTerminalStop(_options: TuiStopOptions): void;
|
|
213
|
+
protected afterTerminalStop(_options: TuiStopOptions): void;
|
|
214
|
+
get fullRedraws(): number;
|
|
215
|
+
getShowHardwareCursor(): boolean;
|
|
216
|
+
setShowHardwareCursor(enabled: boolean): void;
|
|
217
|
+
getClearOnShrink(): boolean;
|
|
218
|
+
/**
|
|
219
|
+
* Set whether to trigger full re-render when content shrinks.
|
|
220
|
+
* When true (default), empty rows are cleared when content shrinks.
|
|
221
|
+
* When false, empty rows remain (reduces redraws on slower terminals).
|
|
222
|
+
*/
|
|
223
|
+
setClearOnShrink(enabled: boolean): void;
|
|
224
|
+
getFocusedComponent(): Component | null;
|
|
225
|
+
setFocus(component: Component | null): void;
|
|
226
|
+
private setFocusInternal;
|
|
227
|
+
private clearOverlayFocusRestore;
|
|
228
|
+
private clearOverlayFocusRestoreFor;
|
|
229
|
+
private resolveBlockedOverlayFocusResume;
|
|
230
|
+
private getVisibleOverlayFocusRestore;
|
|
231
|
+
private isOverlayFocusAncestor;
|
|
232
|
+
private retargetOverlayPreFocus;
|
|
233
|
+
protected getMountedRoots(): readonly Component[];
|
|
234
|
+
private isComponentMounted;
|
|
235
|
+
private containsComponent;
|
|
236
|
+
/**
|
|
237
|
+
* Show an overlay component with configurable positioning and sizing.
|
|
238
|
+
* Returns a handle to control the overlay's visibility.
|
|
239
|
+
*/
|
|
240
|
+
showOverlay(component: Component, options?: OverlayOptions): OverlayHandle;
|
|
241
|
+
/** Hide the topmost overlay and restore previous focus. */
|
|
242
|
+
hideOverlay(): void;
|
|
243
|
+
/** Check if there are any visible overlays */
|
|
244
|
+
hasOverlay(): boolean;
|
|
245
|
+
/** Check if the focused component is a visible overlay */
|
|
246
|
+
protected isOverlayFocused(): boolean;
|
|
247
|
+
/** Check if an overlay entry is currently visible */
|
|
248
|
+
private isOverlayVisible;
|
|
249
|
+
/** Find the visual-frontmost visible capturing overlay, if any */
|
|
250
|
+
private getTopmostVisibleOverlay;
|
|
251
|
+
invalidate(): void;
|
|
252
|
+
start(): void;
|
|
253
|
+
addInputListener(listener: TuiInputListener): () => void;
|
|
254
|
+
removeInputListener(listener: TuiInputListener): void;
|
|
255
|
+
onTerminalColorSchemeChange(listener: (scheme: TerminalColorScheme) => void): () => void;
|
|
256
|
+
setTerminalColorSchemeNotifications(enabled: boolean): void;
|
|
257
|
+
private queryCellSize;
|
|
258
|
+
stop(options?: TuiStopOptions): void;
|
|
259
|
+
renderNow(force?: boolean): void;
|
|
260
|
+
requestRender(force?: boolean): void;
|
|
261
|
+
private requestImmediateRender;
|
|
262
|
+
private cancelRenderTimer;
|
|
263
|
+
private scheduleRender;
|
|
264
|
+
private handleTerminalInput;
|
|
265
|
+
private consumeOsc11BackgroundResponse;
|
|
266
|
+
private consumeTerminalColorSchemeReport;
|
|
267
|
+
private consumeCellSizeResponse;
|
|
268
|
+
/**
|
|
269
|
+
* Resolve overlay layout from options.
|
|
270
|
+
* Returns { width, row, col, maxHeight } for rendering.
|
|
271
|
+
*/
|
|
272
|
+
private resolveOverlayLayout;
|
|
273
|
+
private resolveAnchorRow;
|
|
274
|
+
private resolveAnchorCol;
|
|
275
|
+
/** Composite all overlays into content lines (sorted by focusOrder, higher = on top). */
|
|
276
|
+
protected compositeOverlays(lines: string[], termWidth: number, termHeight: number): string[];
|
|
277
|
+
protected applyLineResets(lines: string[]): string[];
|
|
278
|
+
private compositeLineAt;
|
|
279
|
+
/**
|
|
280
|
+
* Find and extract cursor position from rendered lines.
|
|
281
|
+
* Searches for CURSOR_MARKER, calculates its position, and strips it from the output.
|
|
282
|
+
* Only scans the bottom terminal height lines (visible viewport).
|
|
283
|
+
* @param lines - Rendered lines to search
|
|
284
|
+
* @param height - Terminal height (visible viewport size)
|
|
285
|
+
* @returns Cursor position { row, col } or null if no marker found
|
|
286
|
+
*/
|
|
287
|
+
protected extractCursorPosition(lines: string[], height: number): {
|
|
288
|
+
row: number;
|
|
289
|
+
col: number;
|
|
290
|
+
} | null;
|
|
291
|
+
/**
|
|
292
|
+
* Query the terminal's default background color with OSC 11 (`ESC ] 11 ; ? BEL`).
|
|
293
|
+
* @param timeoutMs Query timeout in milliseconds.
|
|
294
|
+
* @returns Promise containing the parsed RGB color, or undefined if it times out or fails to parse.
|
|
295
|
+
*/
|
|
296
|
+
queryTerminalBackgroundColor({ timeoutMs }: {
|
|
297
|
+
timeoutMs: number;
|
|
298
|
+
}): Promise<RgbColor | undefined>;
|
|
299
|
+
/**
|
|
300
|
+
* Query the terminal's color-scheme preference with DSR (`CSI ? 996 n`).
|
|
301
|
+
* Terminals that support the color palette notification protocol reply with
|
|
302
|
+
* `CSI ? 997 ; 1 n` for dark or `CSI ? 997 ; 2 n` for light.
|
|
303
|
+
*/
|
|
304
|
+
queryTerminalColorScheme({ timeoutMs }: {
|
|
305
|
+
timeoutMs: number;
|
|
306
|
+
}): Promise<TerminalColorScheme | undefined>;
|
|
307
|
+
}
|
|
308
|
+
//# sourceMappingURL=tui.d.ts.map
|
package/lib/tui.d.ts.map
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"tui.d.ts","sourceRoot":"","sources":["../src/tui.ts"],"names":[],"mappings":"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"}
|