@f5xc-salesdemos/pi-tui 14.0.2

package/src/bracketed-paste.ts

@@ -0,0 +1,47 @@
+const PASTE_START = "\x1b[200~";
+const PASTE_END = "\x1b[201~";
+
+export type PasteResult = { handled: false } | { handled: true; pasteContent?: string; remaining: string };
+
+/**
+ * Handles bracketed paste mode buffering for terminal input components.
+ *
+ * Bracketed paste mode wraps pasted content between start (\x1b[200~) and
+ * end (\x1b[201~) markers, which may arrive split across multiple chunks.
+ * This class buffers incoming data and assembles complete paste payloads.
+ */
+export class BracketedPasteHandler {
+	#buffer = "";
+	#active = false;
+
+	/**
+	 * Process incoming terminal data for bracketed paste sequences.
+	 *
+	 * @returns `{ handled: false }` if the data contains no paste sequence and
+	 *          should be processed normally. `{ handled: true }` if the data was
+	 *          consumed by paste buffering — `pasteContent` is set when a complete
+	 *          paste has been assembled; omitted when still buffering.
+	 */
+	process(data: string): PasteResult {
+		if (data.includes(PASTE_START)) {
+			this.#active = true;
+			this.#buffer = "";
+			data = data.replace(PASTE_START, "");
+		}
+
+		if (!this.#active) return { handled: false };
+
+		this.#buffer += data;
+
+		const endIndex = this.#buffer.indexOf(PASTE_END);
+		if (endIndex === -1) return { handled: true, remaining: "" };
+
+		const pasteContent = this.#buffer.substring(0, endIndex);
+		const remaining = this.#buffer.substring(endIndex + PASTE_END.length);
+
+		this.#buffer = "";
+		this.#active = false;
+
+		return { handled: true, pasteContent, remaining };
+	}
+}

package/src/components/box.ts

@@ -0,0 +1,144 @@
+import type { Component } from "../tui";
+import { applyBackgroundToLine, padding, visibleWidth } from "../utils";
+
+type Cache = {
+	key: bigint;
+	result: string[];
+};
+
+/**
+ * Box component - a container that applies padding and background to all children
+ */
+export class Box implements Component {
+	children: Component[] = [];
+	#paddingX: number;
+	#paddingY: number;
+	#bgFn?: (text: string) => string;
+
+	// Cache for rendered output
+	#cached?: Cache;
+
+	constructor(paddingX = 1, paddingY = 1, bgFn?: (text: string) => string) {
+		this.#paddingX = paddingX;
+		this.#paddingY = paddingY;
+		this.#bgFn = bgFn;
+	}
+
+	addChild(component: Component): void {
+		this.children.push(component);
+		this.#invalidateCache();
+	}
+
+	removeChild(component: Component): void {
+		const index = this.children.indexOf(component);
+		if (index !== -1) {
+			this.children.splice(index, 1);
+			this.#invalidateCache();
+		}
+	}
+
+	clear(): void {
+		this.children = [];
+		this.#invalidateCache();
+	}
+
+	setBgFn(bgFn?: (text: string) => string): void {
+		this.#bgFn = bgFn;
+		// Don't invalidate here - we'll detect bgFn changes by sampling output
+	}
+
+	#invalidateCache(): void {
+		this.#cached = undefined;
+	}
+
+	static #tmp = new Uint32Array(2);
+	#computeCacheKey(width: number, childLines: string[], bgSample: string | undefined): bigint {
+		Box.#tmp[0] = width;
+		Box.#tmp[1] = childLines.length;
+		let h = Bun.hash.xxHash64(Box.#tmp);
+		for (const line of childLines) {
+			Box.#tmp[0] = line.length;
+			h = Bun.hash.xxHash64(Box.#tmp, h);
+			h = Bun.hash.xxHash64(line, h);
+		}
+		h = Bun.hash.xxHash64(bgSample ?? "", h);
+		return h;
+	}
+
+	#matchCache(cacheKey: bigint): boolean {
+		return this.#cached?.key === cacheKey;
+	}
+
+	invalidate(): void {
+		this.#invalidateCache();
+		for (const child of this.children) {
+			child.invalidate?.();
+		}
+	}
+
+	render(width: number): string[] {
+		if (this.children.length === 0) {
+			return [];
+		}
+
+		const contentWidth = Math.max(1, width - this.#paddingX * 2);
+		const leftPad = padding(this.#paddingX);
+
+		// Render all children
+		const childLines: string[] = [];
+		for (const child of this.children) {
+			const lines = child.render(contentWidth);
+			for (const line of lines) {
+				childLines.push(leftPad + line);
+			}
+		}
+
+		if (childLines.length === 0) {
+			return [];
+		}
+
+		// Check if bgFn output changed by sampling
+		const bgSample = this.#bgFn ? this.#bgFn("test") : undefined;
+
+		const cacheKey = this.#computeCacheKey(width, childLines, bgSample);
+
+		// Check cache validity
+		if (this.#matchCache(cacheKey)) {
+			return this.#cached!.result;
+		}
+
+		// Apply background and padding
+		const result: string[] = [];
+
+		// Top padding
+		for (let i = 0; i < this.#paddingY; i++) {
+			result.push(this.#applyBg("", width));
+		}
+
+		// Content
+		for (const line of childLines) {
+			result.push(this.#applyBg(line, width));
+		}
+
+		// Bottom padding
+		for (let i = 0; i < this.#paddingY; i++) {
+			result.push(this.#applyBg("", width));
+		}
+
+		// Update cache
+		this.#cached = { key: cacheKey, result };
+
+		return result;
+	}
+
+	#applyBg(line: string, width: number): string {
+		const visLen = visibleWidth(line);
+		const padNeeded = Math.max(0, width - visLen);
+		const padded = line + padding(padNeeded);
+
+		if (this.#bgFn) {
+			return applyBackgroundToLine(padded, width, this.#bgFn);
+		}
+		return padded;
+	}
+}

package/src/components/cancellable-loader.ts

@@ -0,0 +1,40 @@
+import { getKeybindings } from "../keybindings";
+import { Loader } from "./loader";
+
+/**
+ * Loader that can be cancelled with Escape.
+ * Extends Loader with an AbortSignal for cancelling async operations.
+ *
+ * @example
+ * const loader = new CancellableLoader(tui, cyan, dim, "Working...");
+ * loader.onAbort = () => done(null);
+ * doWork(loader.signal).then(done);
+ */
+export class CancellableLoader extends Loader {
+	#abortController = new AbortController();
+
+	/** Called when user presses Escape */
+	onAbort?: () => void;
+
+	/** AbortSignal that is aborted when user presses Escape */
+	get signal(): AbortSignal {
+		return this.#abortController.signal;
+	}
+
+	/** Whether the loader was aborted */
+	get aborted(): boolean {
+		return this.#abortController.signal.aborted;
+	}
+
+	handleInput(data: string): void {
+		const kb = getKeybindings();
+		if (kb.matches(data, "tui.select.cancel")) {
+			this.#abortController.abort();
+			this.onAbort?.();
+		}
+	}
+
+	dispose(): void {
+		this.stop();
+	}
+}