@f5-sales-demo/pi-tui 20.2.4 → 20.2.7

package/CHANGELOG.md

@@ -41,6 +41,7 @@
 - Autocomplete fuzzy discovery now accepts optional SearchDb instance for faster searches
 
 ## [13.16.0] - 2026-03-27
+
 ### Changed
 
 - Updated tab replacement in editor text sanitization to respect configured tab width setting
@@ -56,6 +57,7 @@
 - Fixed editor consuming user-rebound copy keys, preventing custom keybindings from working in the editor
 
 ## [13.14.1] - 2026-03-21
+
 ### Added
 
 - Added Ctrl+_ as an additional default shortcut for undo
@@ -76,17 +78,20 @@
 - Fixed paste marker expansion to handle special regex replacement tokens ($1, $2, $&, $$, $`, $') literally in pasted content
 
 ## [13.11.0] - 2026-03-12
+
 ### Fixed
 
 - Fixed OSC 11 background color detection to correctly handle partial escape sequences that arrive mid-buffer, preventing user input from being swallowed
 - Fixed race condition where overlapping OSC 11 queries would be incorrectly cancelled by DA1 sentinels from previous queries
 
 ## [13.7.5] - 2026-03-04
+
 ### Changed
 
 - Extracted word navigation logic into reusable `moveWordLeft` and `moveWordRight` utility functions for consistent cursor movement across components
 
 ## [13.6.2] - 2026-03-03
+
 ### Fixed
 
 - Fixed cursor positioning when content shrinks to empty without clearOnShrink enabled
@@ -96,6 +101,7 @@
 ### Fixed
 
 - Fixed viewport repaint scrollback accounting during resize oscillation to avoid double-scrolling on height shrink and added exact-row scrollback assertions in overlay regression coverage ([#228](https://github.com/can1357/oh-my-pi/issues/228), [#234](https://github.com/can1357/oh-my-pi/issues/234))
+
 ## [13.5.3] - 2026-03-01
 
 ### Fixed
@@ -105,6 +111,7 @@
 - Fixed cursor positioning instability when appending content under external cursor relocation by using absolute screen addressing instead of relative cursor movement
 
 ## [13.5.2] - 2026-03-01
+
 ### Breaking Changes
 
 - Removed `getMermaidImage` callback from MarkdownTheme; replaced with `getMermaidAscii` that accepts ASCII string instead of image data
@@ -115,6 +122,7 @@
 - Mermaid diagrams now render as ASCII text instead of terminal graphics protocol images
 
 ## [13.5.1] - 2026-03-01
+
 ### Fixed
 
 - Fixed viewport shift handling to prevent stale content when mixed updates remap screen rows
@@ -142,6 +150,7 @@
 
 - Fixed stale/duplicated terminal cursor dedup state by synchronizing `#lastCursorSequence` in all render write paths (hard reset, viewport repaint, deleted-lines clear path, append fast path, and differential path).
 - Fixed scroll overshoot on `stop()` when content fills the viewport by clamping target row movement to valid screen rows.
+
 ## [13.4.0] - 2026-03-01
 
 ### Added
@@ -163,6 +172,7 @@
 - Restored terminal image protocol override and fallback detection for image rendering, including `PI_FORCE_IMAGE_PROTOCOL` support and Kitty fallback for screen/tmux/ghostty-style TERM environments.
 
 ## [13.3.8] - 2026-02-28
+
 ### Breaking Changes
 
 - Changed mermaid hash type from string to bigint in `getMermaidImage` callback and `extractMermaidBlocks` return type
@@ -184,6 +194,7 @@
 - Fixed stale viewport rows appearing when terminal height increases by triggering full re-render on height changes
 
 ## [12.18.0] - 2026-02-21
+
 ### Fixed
 
 - Fixed viewport synchronization issue by clearing scrollback when terminal state becomes desynced during full re-renders
@@ -212,18 +223,21 @@
 - Fixed incremental stale-row clearing to use erase-below semantics in synchronized output, reducing leftover-line artifacts after shrink operations.
 
 ## [12.9.0] - 2026-02-17
+
 ### Added
 
 - Exported `getTerminalId()` function to get a stable identifier for the current terminal, with support for TTY device paths and terminal multiplexers
 - Exported `getTtyPath()` function to resolve the TTY device path for stdin via POSIX `ttyname(3)`
 
 ## [12.5.0] - 2026-02-15
+
 ### Added
 
 - Added `cursorOverride` and `cursorOverrideWidth` properties to customize the end-of-text cursor glyph with ANSI-styled strings
 - Added `getUseTerminalCursor()` method to query the terminal cursor mode setting
 
 ## [11.10.0] - 2026-02-10
+
 ### Added
 
 - Added `hint` property to autocomplete items to display dim ghost text after cursor when item is selected
@@ -236,6 +250,7 @@
 - Updated editor to render inline hint text as dim ghost text after cursor when autocomplete suggestions are active or provider supplies hints
 
 ## [11.8.0] - 2026-02-10
+
 ### Added
 
 - Added Alt+Y keybinding to cycle through kill ring entries (yank-pop)
@@ -252,6 +267,7 @@
 - Changed undo coalescing in Input component to group consecutive word typing into single undo units
 
 ## [11.4.1] - 2026-02-06
+
 ### Fixed
 
 - Fixed terminal scrolling when displaying overlays after rendering large content, preventing hundreds of blank lines from being output
@@ -344,6 +360,7 @@
 - Fixed handling of private use Unicode codepoints (U+E000 to U+F8FF) in Kitty key decoding to prevent invalid character interpretation
 
 ## [9.7.0] - 2026-02-01
+
 ### Breaking Changes
 
 - Removed `Key` helper object from public API; use string literals like `"ctrl+c"` instead of `Key.ctrl("c")`
@@ -355,6 +372,7 @@
 - Simplified `isKeyRelease()` and `isKeyRepeat()` to use regex pattern matching instead of string inclusion checks
 
 ## [9.6.2] - 2026-02-01
+
 ### Changed
 
 - Renamed `EllipsisKind` enum to `Ellipsis` for clearer API naming
@@ -368,6 +386,7 @@
 - Removed `extractAnsiCode` function from public API
 
 ## [9.6.1] - 2026-02-01
+
 ### Changed
 
 - Improved performance of key ID parsing with optimized cache lookup strategy
@@ -378,12 +397,14 @@
 - Removed `visibleWidth` benchmark file in favor of Kitty sequence benchmarking
 
 ## [9.5.0] - 2026-02-01
+
 ### Changed
 
 - Improved fuzzy file search performance by using native implementation instead of spawning external process
 - Replaced external `fd` binary with native fuzzy path search for `@`-prefixed autocomplete
 
 ## [9.4.0] - 2026-01-31
+
 ### Added
 
 - Exported `padding` utility function for creating space-padded strings efficiently
@@ -395,59 +416,74 @@
 ## [9.2.2] - 2026-01-31
 
 ### Added
+
 - Added setAutocompleteMaxVisible() configuration (3-20 items)
 - Added image detection to terminal capabilities (containsImage method)
 - Added stdin monitoring to detect stalled input events and log warnings
 
 ### Changed
+
 - Improved blockquote rendering with text wrapping in Markdown component
 - Restructured terminal capabilities from interface-based to class-based model
 - Improved table column width calculation with word-aware wrapping
 - Refactored text utilities to use native WASM implementations for strings >256 chars with JS fast path
 
 ### Fixed
+
 - Simplified terminal write error handling to mark terminal as dead on any write failure
 - Fixed multi-line strings in renderOutputBlock causing width overflow
 - Fixed slash command autocomplete applying stale completion when typing quickly
 
 ### Removed
+
 - Removed TUI layout engine exports from public API (BoxNode, ColumnNode, LayoutNode, etc.)
 
 ## [8.12.7] - 2026-01-29
 
 ### Fixed
+
 - Fixed slash command autocomplete applying stale completion when typing quickly
 
 ## [8.4.1] - 2026-01-25
 
 ### Added
+
 - Added fuzzy match function for autocomplete suggestions
+
 ## [8.4.0] - 2026-01-25
 
 ### Changed
+
 - Added Ctrl+Backspace as a delete-word-backward keybinding and improved modified backspace matching
 
 ### Fixed
+
 - Terminal gracefully handles write failures by marking dead instead of exiting the process
 - Reserved cursor space for zero padding and corrected end-of-line cursor rendering to prevent wrap glitches
 - Corrected editor end-of-line cursor rendering assertion to use includes() instead of endsWith()
+
 ## [8.2.0] - 2026-01-24
 
 ### Added
+
 - Added mermaid diagram rendering engine (renderMermaidToPng) with mmdc CLI integration
 - Added terminal graphics encoding (iTerm2/Kitty) for mermaid diagrams with automatic width scaling
 - Added mermaid block extraction and deduplication utilities (extractMermaidBlocks)
 
 ### Changed
+
 - Updated TypeScript configuration for better publish-time configuration handling with tsconfig.publish.json
 - Migrated file system operations from synchronous to asynchronous APIs in autocomplete provider for non-blocking I/O
 - Migrated node module imports from named to namespace imports across all packages for consistency with project guidelines
 
 ### Fixed
+
 - Fixed crash when terminal becomes unavailable (EIO errors) by exiting gracefully instead of throwing
 - Fixed potential errors during emergency terminal restore when terminal is already dead
 - Fixed autocomplete race condition by tracking request ID to prevent stale suggestion results
+
 ## [6.8.3] - 2026-01-21
+
 ### Added
 
 - Added undo support in the editor via `Ctrl+-`
@@ -503,6 +539,7 @@
 - Fixed Alt+letter key combinations for better recognition
 
 ## [5.3.1] - 2026-01-15
+
 ### Fixed
 
 - Fixed rendering issues on Windows by preventing re-entrant renders
@@ -532,27 +569,32 @@
 ## [4.7.0] - 2026-01-12
 
 ### Fixed
+
 - Remove trailing space padding from Text, Markdown, and TruncatedText components when no background color is set (fixes copied text including unwanted whitespace)
 
 ## [4.6.0] - 2026-01-12
 
 ### Added
+
 - Add fuzzy matching module (`fuzzyMatch`, `fuzzyFilter`) for command autocomplete
 - Add `getExpandedText()` to editor for expanding paste markers
 - Add backslash+enter newline fallback for terminals without Kitty protocol
 
 ### Fixed
+
 - Remove Kitty protocol query timeout that caused shift+enter delays
 - Add bracketed paste check to prevent false key release/repeat detection
 - Rendering optimizations: only re-render changed lines
 - Refactor input component to use keybindings manager
 
 ## [4.4.4] - 2026-01-11
+
 ### Fixed
 
 - Fixed Ctrl+Enter sequences to insert new lines in the editor
 
 ## [4.2.1] - 2026-01-11
+
 ### Changed
 
 - Improved file autocomplete to show directory listing when typing `@` with no query, and fall back to prefix matching when fuzzy search returns no results
@@ -563,11 +605,13 @@
 - Fixed `fd` tool detection to automatically find `fd` or `fdfind` in PATH when not explicitly configured
 
 ## [4.1.0] - 2026-01-10
+
 ### Added
 
 - Added persistent prompt history storage support via `setHistoryStorage()` method, allowing history to be saved and restored across sessions
 
 ## [4.0.0] - 2026-01-10
+
 ### Added
 
 - `EditorComponent` interface for custom editor implementations
@@ -598,6 +642,7 @@
 - Fixed text wrapping allowing long whitespace tokens to exceed line width
 
 ## [3.20.0] - 2026-01-06
+
 ### Added
 
 - Added `isCapsLock` helper function for detecting Caps Lock key press via Kitty protocol
@@ -629,6 +674,7 @@
 - Added support for custom spinner frames in the Loader component
 
 ## [3.9.1337] - 2026-01-04
+
 ### Added
 
 - Added `setTopBorder()` method to Editor component for displaying custom status content in the top border
@@ -641,6 +687,7 @@
 - Changed cursor style from block to thin blinking bar (▏) at end of line
 
 ## [1.500.0] - 2026-01-03
+
 ### Added
 
 - Added `getText()` method to Text component for retrieving current text content

package/README.md

@@ -29,8 +29,8 @@ tui.addChild(new Text("Welcome to my app!"));
 
 const editor = new Editor(editorTheme);
 editor.onSubmit = (text) => {
-	console.log("Submitted:", text);
-	tui.addChild(new Text(`You said: ${text}`));
+ console.log("Submitted:", text);
+ tui.addChild(new Text(`You said: ${text}`));
 };
 tui.addChild(editor);
 
@@ -62,9 +62,9 @@ All components implement:
 
 ```typescript
 interface Component {
-	render(width: number): string[];
-	handleInput?(data: string): void;
-	invalidate?(): void;
+ render(width: number): string[];
+ handleInput?(data: string): void;
+ invalidate?(): void;
 }
 ```
 
@@ -92,9 +92,9 @@ Container that applies padding and background color to all children.
 
 ```typescript
 const box = new Box(
-	1, // paddingX (default: 1)
-	1, // paddingY (default: 1)
-	(text) => chalk.bgGray(text), // optional background function
+ 1, // paddingX (default: 1)
+ 1, // paddingY (default: 1)
+ (text) => chalk.bgGray(text), // optional background function
 );
 box.addChild(new Text("Content"));
 box.setBgFn((text) => chalk.bgBlue(text)); // Change background dynamically
@@ -106,10 +106,10 @@ Displays multi-line text with word wrapping and padding.
 
 ```typescript
 const text = new Text(
-	"Hello World", // text content
-	1, // paddingX (default: 1)
-	1, // paddingY (default: 1)
-	(text) => chalk.bgGray(text), // optional background function
+ "Hello World", // text content
+ 1, // paddingX (default: 1)
+ 1, // paddingY (default: 1)
+ (text) => chalk.bgGray(text), // optional background function
 );
 text.setText("Updated text");
 text.setCustomBgFn((text) => chalk.bgBlue(text));
@@ -121,9 +121,9 @@ Single-line text that truncates to fit viewport width. Useful for status lines a
 
 ```typescript
 const truncated = new TruncatedText(
-	"This is a very long line that will be truncated...",
-	0, // paddingX (default: 0)
-	0, // paddingY (default: 0)
+ "This is a very long line that will be truncated...",
+ 0, // paddingX (default: 0)
+ 0, // paddingY (default: 0)
 );
 ```
 
@@ -155,51 +155,51 @@ Multi-line text editor with autocomplete, file completion, and paste handling.
 
 ```typescript
 interface SymbolTheme {
-	cursor: string;
-	ellipsis: string;
-	boxRound: {
-		topLeft: string;
-		topRight: string;
-		bottomLeft: string;
-		bottomRight: string;
-		horizontal: string;
-		vertical: string;
-	};
-	boxSharp: {
-		topLeft: string;
-		topRight: string;
-		bottomLeft: string;
-		bottomRight: string;
-		horizontal: string;
-		vertical: string;
-		teeDown: string;
-		teeUp: string;
-		teeLeft: string;
-		teeRight: string;
-		cross: string;
-	};
-	table: {
-		topLeft: string;
-		topRight: string;
-		bottomLeft: string;
-		bottomRight: string;
-		horizontal: string;
-		vertical: string;
-		teeDown: string;
-		teeUp: string;
-		teeLeft: string;
-		teeRight: string;
-		cross: string;
-	};
-	quoteBorder: string;
-	hrChar: string;
-	spinnerFrames: string[];
+ cursor: string;
+ ellipsis: string;
+ boxRound: {
+  topLeft: string;
+  topRight: string;
+  bottomLeft: string;
+  bottomRight: string;
+  horizontal: string;
+  vertical: string;
+ };
+ boxSharp: {
+  topLeft: string;
+  topRight: string;
+  bottomLeft: string;
+  bottomRight: string;
+  horizontal: string;
+  vertical: string;
+  teeDown: string;
+  teeUp: string;
+  teeLeft: string;
+  teeRight: string;
+  cross: string;
+ };
+ table: {
+  topLeft: string;
+  topRight: string;
+  bottomLeft: string;
+  bottomRight: string;
+  horizontal: string;
+  vertical: string;
+  teeDown: string;
+  teeUp: string;
+  teeLeft: string;
+  teeRight: string;
+  cross: string;
+ };
+ quoteBorder: string;
+ hrChar: string;
+ spinnerFrames: string[];
 }
 
 interface EditorTheme {
-	borderColor: (str: string) => string;
-	selectList: SelectListTheme;
-	symbols: SymbolTheme;
+ borderColor: (str: string) => string;
+ selectList: SelectListTheme;
+ symbols: SymbolTheme;
 }
 
 const editor = new Editor(theme);
@@ -236,40 +236,40 @@ Renders markdown with syntax highlighting and theming support.
 
 ```typescript
 interface MarkdownTheme {
-	heading: (text: string) => string;
-	link: (text: string) => string;
-	linkUrl: (text: string) => string;
-	code: (text: string) => string;
-	codeBlock: (text: string) => string;
-	codeBlockBorder: (text: string) => string;
-	quote: (text: string) => string;
-	quoteBorder: (text: string) => string;
-	hr: (text: string) => string;
-	listBullet: (text: string) => string;
-	bold: (text: string) => string;
-	italic: (text: string) => string;
-	strikethrough: (text: string) => string;
-	underline: (text: string) => string;
-	highlightCode?: (code: string, lang?: string) => string[];
-	symbols: SymbolTheme;
+ heading: (text: string) => string;
+ link: (text: string) => string;
+ linkUrl: (text: string) => string;
+ code: (text: string) => string;
+ codeBlock: (text: string) => string;
+ codeBlockBorder: (text: string) => string;
+ quote: (text: string) => string;
+ quoteBorder: (text: string) => string;
+ hr: (text: string) => string;
+ listBullet: (text: string) => string;
+ bold: (text: string) => string;
+ italic: (text: string) => string;
+ strikethrough: (text: string) => string;
+ underline: (text: string) => string;
+ highlightCode?: (code: string, lang?: string) => string[];
+ symbols: SymbolTheme;
 }
 
 interface DefaultTextStyle {
-	color?: (text: string) => string;
-	bgColor?: (text: string) => string;
-	bold?: boolean;
-	italic?: boolean;
-	strikethrough?: boolean;
-	underline?: boolean;
+ color?: (text: string) => string;
+ bgColor?: (text: string) => string;
+ bold?: boolean;
+ italic?: boolean;
+ strikethrough?: boolean;
+ underline?: boolean;
 }
 
 const md = new Markdown(
-	"# Hello\n\nSome **bold** text",
-	1, // paddingX
-	1, // paddingY
-	theme, // MarkdownTheme
-	defaultStyle, // optional DefaultTextStyle
-	2, // optional code block indent (spaces)
+ "# Hello\n\nSome **bold** text",
+ 1, // paddingX
+ 1, // paddingY
+ theme, // MarkdownTheme
+ defaultStyle, // optional DefaultTextStyle
+ 2, // optional code block indent (spaces)
 );
 md.setText("Updated markdown");
 ```
@@ -288,10 +288,10 @@ Animated loading spinner.
 
 ```typescript
 const loader = new Loader(
-	tui, // TUI instance for render updates
-	(s) => chalk.cyan(s), // spinner color function
-	(s) => chalk.gray(s), // message color function
-	"Loading...", // message (default: "Loading...")
+ tui, // TUI instance for render updates
+ (s) => chalk.cyan(s), // spinner color function
+ (s) => chalk.gray(s), // message color function
+ "Loading...", // message (default: "Loading...")
 );
 loader.start();
 loader.setMessage("Still loading...");
@@ -304,10 +304,10 @@ Extends Loader with Escape key handling and an AbortSignal for cancelling async
 
 ```typescript
 const loader = new CancellableLoader(
-	tui, // TUI instance for render updates
-	(s) => chalk.cyan(s), // spinner color function
-	(s) => chalk.gray(s), // message color function
-	"Working...", // message
+ tui, // TUI instance for render updates
+ (s) => chalk.cyan(s), // spinner color function
+ (s) => chalk.gray(s), // message color function
+ "Working...", // message
 );
 loader.onAbort = () => done(null); // Called when user presses Escape
 doAsyncWork(loader.signal).then(done);
@@ -325,27 +325,27 @@ Interactive selection list with keyboard navigation.
 
 ```typescript
 interface SelectItem {
-	value: string;
-	label: string;
-	description?: string;
+ value: string;
+ label: string;
+ description?: string;
 }
 
 interface SelectListTheme {
-	selectedPrefix: (text: string) => string;
-	selectedText: (text: string) => string;
-	description: (text: string) => string;
-	scrollInfo: (text: string) => string;
-	noMatch: (text: string) => string;
-	symbols: SymbolTheme;
+ selectedPrefix: (text: string) => string;
+ selectedText: (text: string) => string;
+ description: (text: string) => string;
+ scrollInfo: (text: string) => string;
+ noMatch: (text: string) => string;
+ symbols: SymbolTheme;
 }
 
 const list = new SelectList(
-	[
-		{ value: "opt1", label: "Option 1", description: "First option" },
-		{ value: "opt2", label: "Option 2", description: "Second option" },
-	],
-	5, // maxVisible
-	theme, // SelectListTheme
+ [
+  { value: "opt1", label: "Option 1", description: "First option" },
+  { value: "opt2", label: "Option 2", description: "Second option" },
+ ],
+ 5, // maxVisible
+ theme, // SelectListTheme
 );
 
 list.onSelect = (item) => console.log("Selected:", item);
@@ -366,31 +366,31 @@ Settings panel with value cycling and submenus.
 
 ```typescript
 interface SettingItem {
-	id: string;
-	label: string;
-	description?: string;
-	currentValue: string;
-	values?: string[]; // If provided, Enter/Space cycles through these
-	submenu?: (currentValue: string, done: (selectedValue?: string) => void) => Component;
+ id: string;
+ label: string;
+ description?: string;
+ currentValue: string;
+ values?: string[]; // If provided, Enter/Space cycles through these
+ submenu?: (currentValue: string, done: (selectedValue?: string) => void) => Component;
 }
 
 interface SettingsListTheme {
-	label: (text: string, selected: boolean) => string;
-	value: (text: string, selected: boolean) => string;
-	description: (text: string) => string;
-	cursor: string;
-	hint: (text: string) => string;
+ label: (text: string, selected: boolean) => string;
+ value: (text: string, selected: boolean) => string;
+ description: (text: string) => string;
+ cursor: string;
+ hint: (text: string) => string;
 }
 
 const settings = new SettingsList(
-	[
-		{ id: "theme", label: "Theme", currentValue: "dark", values: ["dark", "light"] },
-		{ id: "model", label: "Model", currentValue: "gpt-4", submenu: (val, done) => modelSelector },
-	],
-	10, // maxVisible
-	theme, // SettingsListTheme
-	(id, newValue) => console.log(`${id} changed to ${newValue}`),
-	() => console.log("Cancelled"),
+ [
+  { id: "theme", label: "Theme", currentValue: "dark", values: ["dark", "light"] },
+  { id: "model", label: "Model", currentValue: "gpt-4", submenu: (val, done) => modelSelector },
+ ],
+ 10, // maxVisible
+ theme, // SettingsListTheme
+ (id, newValue) => console.log(`${id} changed to ${newValue}`),
+ () => console.log("Cancelled"),
 );
 settings.updateValue("theme", "light");
 ```
@@ -415,20 +415,20 @@ Renders images inline for terminals that support the Kitty graphics protocol (Ki
 
 ```typescript
 interface ImageTheme {
-	fallbackColor: (str: string) => string;
+ fallbackColor: (str: string) => string;
 }
 
 interface ImageOptions {
-	maxWidthCells?: number;
-	maxHeightCells?: number;
-	filename?: string;
+ maxWidthCells?: number;
+ maxHeightCells?: number;
+ filename?: string;
 }
 
 const image = new Image(
-	base64Data, // base64-encoded image data
-	"image/png", // MIME type
-	theme, // ImageTheme
-	options, // optional ImageOptions
+ base64Data, // base64-encoded image data
+ "image/png", // MIME type
+ theme, // ImageTheme
+ options, // optional ImageOptions
 );
 tui.addChild(image);
 ```
@@ -446,12 +446,12 @@ import { CombinedAutocompleteProvider } from "@f5-sales-demo/pi-tui";
 import { getProjectDir } from "@f5-sales-demo/pi-utils";
 
 const provider = new CombinedAutocompleteProvider(
-	[
-		{ name: "help", description: "Show help" },
-		{ name: "clear", description: "Clear screen" },
-		{ name: "delete", description: "Delete last message" },
-	],
-	getProjectDir(), // base path for file completion
+ [
+  { name: "help", description: "Show help" },
+  { name: "clear", description: "Clear screen" },
+  { name: "delete", description: "Delete last message" },
+ ],
+ getProjectDir(), // base path for file completion
 );
 
 editor.setAutocompleteProvider(provider);
@@ -470,38 +470,38 @@ Helper functions for detecting keyboard input (supports Kitty keyboard protocol)
 
 ```typescript
 import {
-	isEnter,
-	isEscape,
-	isTab,
-	isShiftTab,
-	isArrowUp,
-	isArrowDown,
-	isArrowLeft,
-	isArrowRight,
-	isCtrlA,
-	isCtrlC,
-	isCtrlE,
-	isCtrlK,
-	isCtrlO,
-	isCtrlP,
-	isCtrlLeft,
-	isCtrlRight,
-	isAltLeft,
-	isAltRight,
-	isShiftEnter,
-	isAltEnter,
-	isShiftCtrlO,
-	isShiftCtrlD,
-	isShiftCtrlP,
-	isBackspace,
-	isDelete,
-	isHome,
-	isEnd,
-	// ... and more
+ isEnter,
+ isEscape,
+ isTab,
+ isShiftTab,
+ isArrowUp,
+ isArrowDown,
+ isArrowLeft,
+ isArrowRight,
+ isCtrlA,
+ isCtrlC,
+ isCtrlE,
+ isCtrlK,
+ isCtrlO,
+ isCtrlP,
+ isCtrlLeft,
+ isCtrlRight,
+ isAltLeft,
+ isAltRight,
+ isShiftEnter,
+ isAltEnter,
+ isShiftCtrlO,
+ isShiftCtrlD,
+ isShiftCtrlP,
+ isBackspace,
+ isDelete,
+ isHome,
+ isEnd,
+ // ... and more
 } from "@f5-sales-demo/pi-tui";
 
 if (isCtrlC(data)) {
-	process.exit(0);
+ process.exit(0);
 }
 ```
 
@@ -521,17 +521,17 @@ The TUI works with any object implementing the `Terminal` interface:
 
 ```typescript
 interface Terminal {
-	start(onInput: (data: string) => void, onResize: () => void): void;
-	stop(): void;
-	write(data: string): void;
-	get columns(): number;
-	get rows(): number;
-	moveBy(lines: number): void;
-	hideCursor(): void;
-	showCursor(): void;
-	clearLine(): void;
-	clearFromCursor(): void;
-	clearScreen(): void;
+ start(onInput: (data: string) => void, onResize: () => void): void;
+ stop(): void;
+ write(data: string): void;
+ get columns(): number;
+ get rows(): number;
+ moveBy(lines: number): void;
+ hideCursor(): void;
+ showCursor(): void;
+ clearLine(): void;
+ clearFromCursor(): void;
+ clearScreen(): void;
 }
 ```
 
@@ -572,30 +572,30 @@ import { isEnter, isEscape, isArrowUp, isArrowDown, isCtrlC, isTab, isBackspace
 import type { Component } from "@f5-sales-demo/pi-tui";
 
 class MyInteractiveComponent implements Component {
-	private selectedIndex = 0;
-	private items = ["Option 1", "Option 2", "Option 3"];
-
-	onSelect?: (index: number) => void;
-	onCancel?: () => void;
-
-	handleInput(data: string): void {
-		if (isArrowUp(data)) {
-			this.selectedIndex = Math.max(0, this.selectedIndex - 1);
-		} else if (isArrowDown(data)) {
-			this.selectedIndex = Math.min(this.items.length - 1, this.selectedIndex + 1);
-		} else if (isEnter(data)) {
-			this.onSelect?.(this.selectedIndex);
-		} else if (isEscape(data) || isCtrlC(data)) {
-			this.onCancel?.();
-		}
-	}
-
-	render(width: number): string[] {
-		return this.items.map((item, i) => {
-			const prefix = i === this.selectedIndex ? "> " : "  ";
-			return truncateToWidth(prefix + item, width);
-		});
-	}
+ private selectedIndex = 0;
+ private items = ["Option 1", "Option 2", "Option 3"];
+
+ onSelect?: (index: number) => void;
+ onCancel?: () => void;
+
+ handleInput(data: string): void {
+  if (isArrowUp(data)) {
+   this.selectedIndex = Math.max(0, this.selectedIndex - 1);
+  } else if (isArrowDown(data)) {
+   this.selectedIndex = Math.min(this.items.length - 1, this.selectedIndex + 1);
+  } else if (isEnter(data)) {
+   this.onSelect?.(this.selectedIndex);
+  } else if (isEscape(data) || isCtrlC(data)) {
+   this.onCancel?.();
+  }
+ }
+
+ render(width: number): string[] {
+  return this.items.map((item, i) => {
+   const prefix = i === this.selectedIndex ? "> " : "  ";
+   return truncateToWidth(prefix + item, width);
+  });
+ }
 }
 ```
 
@@ -608,25 +608,25 @@ import { visibleWidth, truncateToWidth } from "@f5-sales-demo/pi-tui";
 import type { Component } from "@f5-sales-demo/pi-tui";
 
 class MyComponent implements Component {
-	private text: string;
-
-	constructor(text: string) {
-		this.text = text;
-	}
-
-	render(width: number): string[] {
-		// Option 1: Truncate long lines
-		return [truncateToWidth(this.text, width)];
-
-		// Option 2: Check and pad to exact width
-		const line = this.text;
-		const visible = visibleWidth(line);
-		if (visible > width) {
-			return [truncateToWidth(line, width)];
-		}
-		// Pad to exact width (optional, for backgrounds)
-		return [line + " ".repeat(width - visible)];
-	}
+ private text: string;
+
+ constructor(text: string) {
+  this.text = text;
+ }
+
+ render(width: number): string[] {
+  // Option 1: Truncate long lines
+  return [truncateToWidth(this.text, width)];
+
+  // Option 2: Check and pad to exact width
+  const line = this.text;
+  const visible = visibleWidth(line);
+  if (visible > width) {
+   return [truncateToWidth(line, width)];
+  }
+  // Pad to exact width (optional, for backgrounds)
+  return [line + " ".repeat(width - visible)];
+ }
 }
 ```
 
@@ -652,26 +652,26 @@ For performance, components should cache their rendered output and only re-rende
 
 ```typescript
 class CachedComponent implements Component {
-	private text: string;
-	private cachedWidth?: number;
-	private cachedLines?: string[];
-
-	render(width: number): string[] {
-		if (this.cachedLines && this.cachedWidth === width) {
-			return this.cachedLines;
-		}
-
-		const lines = [truncateToWidth(this.text, width)];
-
-		this.cachedWidth = width;
-		this.cachedLines = lines;
-		return lines;
-	}
-
-	invalidate(): void {
-		this.cachedWidth = undefined;
-		this.cachedLines = undefined;
-	}
+ private text: string;
+ private cachedWidth?: number;
+ private cachedLines?: string[];
+
+ render(width: number): string[] {
+  if (this.cachedLines && this.cachedWidth === width) {
+   return this.cachedLines;
+  }
+
+  const lines = [truncateToWidth(this.text, width)];
+
+  this.cachedWidth = width;
+  this.cachedLines = lines;
+  return lines;
+ }
+
+ invalidate(): void {
+  this.cachedWidth = undefined;
+  this.cachedLines = undefined;
+ }
 }
 ```
 

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@f5-sales-demo/pi-tui",
-	"version": "20.2.4",
+	"version": "20.2.7",
 	"description": "Terminal User Interface library with differential rendering for efficient text-based applications",
 	"homepage": "https://github.com/f5-sales-demo/xcsh",
 	"author": "Can Boluk",
@@ -37,8 +37,8 @@
 		"fmt": "biome format --write ."
 	},
 	"dependencies": {
-		"@f5-sales-demo/pi-natives": "20.2.4",
-		"@f5-sales-demo/pi-utils": "20.2.4",
+		"@f5-sales-demo/pi-natives": "20.2.7",
+		"@f5-sales-demo/pi-utils": "20.2.7",
 		"marked": "^18.0"
 	},
 	"devDependencies": {