@oh-my-pi/pi-tui 10.6.2 → 11.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@oh-my-pi/pi-tui",
-	"version": "10.6.2",
+	"version": "11.0.0",
 	"description": "Terminal User Interface library with differential rendering for efficient text-based applications",
 	"type": "module",
 	"main": "./src/index.ts",
@@ -47,7 +47,8 @@
 		"bun": ">=1.3.7"
 	},
 	"dependencies": {
-		"@oh-my-pi/pi-natives": "10.6.2",
+		"@oh-my-pi/pi-natives": "11.0.0",
+		"@oh-my-pi/pi-utils": "11.0.0",
 		"@types/mime-types": "^3.0.1",
 		"chalk": "^5.6.2",
 		"marked": "^17.0.1",

package/src/components/image.ts

@@ -1,4 +1,10 @@
-import { getImageDimensions, type ImageDimensions, imageFallback, renderImage, TERMINAL_INFO } from "../terminal-image";
+import {
+	getImageDimensions,
+	type ImageDimensions,
+	imageFallback,
+	renderImage,
+	TERMINAL,
+} from "../terminal-capabilities";
 import type { Component } from "../tui";
 
 export interface ImageTheme {
@@ -49,7 +55,7 @@ export class Image implements Component {
 
 		let lines: string[];
 
-		if (TERMINAL_INFO.imageProtocol) {
+		if (TERMINAL.imageProtocol) {
 			const result = renderImage(this.base64Data, this.dimensions, { maxWidthCells: maxWidth });
 
 			if (result) {

package/src/components/markdown.ts

@@ -1,7 +1,7 @@
 import { marked, type Token } from "marked";
 import type { MermaidImage } from "../mermaid";
 import type { SymbolTheme } from "../symbols";
-import { encodeITerm2, encodeKitty, getCellDimensions, ImageProtocol, TERMINAL_INFO } from "../terminal-image";
+import { encodeITerm2, encodeKitty, getCellDimensions, ImageProtocol, TERMINAL } from "../terminal-capabilities";
 import type { Component } from "../tui";
 import { applyBackgroundToLine, padding, visibleWidth, wrapTextWithAnsi } from "../utils";
 
@@ -143,7 +143,7 @@ export class Markdown implements Component {
 		const wrappedLines: string[] = [];
 		for (const line of renderedLines) {
 			// Skip wrapping for image protocol lines (would corrupt escape sequences)
-			if (TERMINAL_INFO.isImageLine(line)) {
+			if (TERMINAL.isImageLine(line)) {
 				wrappedLines.push(line);
 			} else {
 				wrappedLines.push(...wrapTextWithAnsi(line, contentWidth));
@@ -158,7 +158,7 @@ export class Markdown implements Component {
 
 		for (const line of wrappedLines) {
 			// Image lines must be output raw - no margins or background
-			if (TERMINAL_INFO.isImageLine(line)) {
+			if (TERMINAL.isImageLine(line)) {
 				contentLines.push(line);
 				continue;
 			}
@@ -314,7 +314,7 @@ export class Markdown implements Component {
 					const hash = Bun.hash(token.text.trim()).toString(16);
 					const image = this.theme.getMermaidImage(hash);
 
-					if (image && TERMINAL_INFO.imageProtocol) {
+					if (image && TERMINAL.imageProtocol) {
 						const imageLines = this.renderMermaidImage(image, width);
 						if (imageLines) {
 							lines.push(...imageLines);
@@ -809,7 +809,7 @@ export class Markdown implements Component {
 	 * Returns array of lines (image placeholder rows) or null if rendering fails.
 	 */
 	private renderMermaidImage(image: MermaidImage, availableWidth: number): string[] | null {
-		if (!TERMINAL_INFO.imageProtocol) return null;
+		if (!TERMINAL.imageProtocol) return null;
 
 		const cellDims = getCellDimensions();
 		const scale = 0.5; // Render at 50% of natural size
@@ -833,7 +833,7 @@ export class Markdown implements Component {
 		}
 
 		let sequence: string;
-		switch (TERMINAL_INFO.imageProtocol) {
+		switch (TERMINAL.imageProtocol) {
 			case ImageProtocol.Kitty:
 				sequence = encodeKitty(image.base64, { columns, rows });
 				break;

package/src/index.ts

@@ -59,28 +59,7 @@ export type { BoxSymbols, SymbolTheme } from "./symbols";
 // Terminal interface and implementations
 export { emergencyTerminalRestore, ProcessTerminal, type Terminal } from "./terminal";
 // Terminal image support
-export {
-	type CellDimensions,
-	calculateImageRows,
-	encodeITerm2,
-	encodeKitty,
-	getCellDimensions,
-	getGifDimensions,
-	getImageDimensions,
-	getJpegDimensions,
-	getPngDimensions,
-	getTerminalInfo,
-	getWebpDimensions,
-	type ImageDimensions,
-	type ImageRenderOptions,
-	imageFallback,
-	renderImage,
-	setCellDimensions,
-	TERMINAL_ID,
-	TERMINAL_INFO,
-	type TerminalId,
-	type TerminalInfo,
-} from "./terminal-image";
+export * from "./terminal-capabilities";
 export { type Component, Container, type OverlayHandle, type SizeValue, TUI } from "./tui";
 // Utilities
 export { Ellipsis, padding, truncateToWidth, visibleWidth, wrapTextWithAnsi } from "./utils";

package/src/{terminal-image.ts → terminal-capabilities.ts}

@@ -1,35 +1,63 @@
+import { $env } from "@oh-my-pi/pi-utils";
+
 export enum ImageProtocol {
 	Kitty = "\x1b_G",
 	Iterm2 = "\x1b]1337;File=",
 }
 
+export enum NotifyProtocol {
+	Bell = "\x07",
+	Osc99 = "\x1b]99;;",
+	Osc9 = "\x1b]9;",
+}
+
 export type TerminalId = "kitty" | "ghostty" | "wezterm" | "iterm2" | "vscode" | "alacritty" | "base" | "trueColor";
 
+/** Terminal capability details used for rendering and protocol selection. */
 export class TerminalInfo {
 	constructor(
 		public readonly id: TerminalId,
 		public readonly imageProtocol: ImageProtocol | null,
 		public readonly trueColor: boolean,
 		public readonly hyperlinks: boolean,
+		public readonly notifyProtocol: NotifyProtocol = NotifyProtocol.Bell,
 	) {}
 
 	isImageLine(line: string): boolean {
 		if (!this.imageProtocol) return false;
 		return line.slice(0, 64).includes(this.imageProtocol);
 	}
+
+	formatNotification(message: string): string {
+		if (this.notifyProtocol === NotifyProtocol.Bell) {
+			return NotifyProtocol.Bell;
+		}
+		return `${this.notifyProtocol}${message}\x1b\\`;
+	}
+
+	sendNotification(message: string): void {
+		if (isNotificationSuppressed()) return;
+		process.stdout.write(this.formatNotification(message));
+	}
+}
+
+export function isNotificationSuppressed(): boolean {
+	const value = $env.PI_NOTIFICATIONS;
+	if (!value) return false;
+	return value === "off" || value === "0" || value === "false";
 }
 
 const KNOWN_TERMINALS = Object.freeze({
 	// Fallback terminals
-	base: new TerminalInfo("base", null, false, true),
-	trueColor: new TerminalInfo("trueColor", null, true, true),
+	base: new TerminalInfo("base", null, false, true, NotifyProtocol.Bell),
+	trueColor: new TerminalInfo("trueColor", null, true, true, NotifyProtocol.Bell),
 	// Recognized terminals
-	kitty: new TerminalInfo("kitty", ImageProtocol.Kitty, true, true),
-	ghostty: new TerminalInfo("ghostty", ImageProtocol.Kitty, true, true),
-	wezterm: new TerminalInfo("wezterm", ImageProtocol.Kitty, true, true),
-	iterm2: new TerminalInfo("iterm2", ImageProtocol.Iterm2, true, true),
-	vscode: new TerminalInfo("vscode", null, true, true),
-	alacritty: new TerminalInfo("alacritty", null, true, true),
+	kitty: new TerminalInfo("kitty", ImageProtocol.Kitty, true, true, NotifyProtocol.Osc99),
+	ghostty: new TerminalInfo("ghostty", ImageProtocol.Kitty, true, true, NotifyProtocol.Osc9),
+	wezterm: new TerminalInfo("wezterm", ImageProtocol.Kitty, true, true, NotifyProtocol.Osc9),
+	iterm2: new TerminalInfo("iterm2", ImageProtocol.Iterm2, true, true, NotifyProtocol.Osc9),
+	vscode: new TerminalInfo("vscode", null, true, true, NotifyProtocol.Bell),
+	alacritty: new TerminalInfo("alacritty", null, true, true, NotifyProtocol.Bell),
 });
 
 export const TERMINAL_ID: TerminalId = (() => {
@@ -73,7 +101,7 @@ export const TERMINAL_ID: TerminalId = (() => {
 	return "base";
 })();
 
-export const TERMINAL_INFO = getTerminalInfo(TERMINAL_ID);
+export const TERMINAL = getTerminalInfo(TERMINAL_ID);
 
 export function getTerminalInfo(terminalId: TerminalId): TerminalInfo {
 	return KNOWN_TERMINALS[terminalId];
@@ -332,19 +360,19 @@ export function renderImage(
 	imageDimensions: ImageDimensions,
 	options: ImageRenderOptions = {},
 ): { sequence: string; rows: number } | null {
-	if (!TERMINAL_INFO.imageProtocol) {
+	if (!TERMINAL.imageProtocol) {
 		return null;
 	}
 
 	const maxWidth = options.maxWidthCells ?? 80;
 	const rows = calculateImageRows(imageDimensions, maxWidth, getCellDimensions());
 
-	if (TERMINAL_INFO.imageProtocol === ImageProtocol.Kitty) {
+	if (TERMINAL.imageProtocol === ImageProtocol.Kitty) {
 		const sequence = encodeKitty(base64Data, { columns: maxWidth, rows });
 		return { sequence, rows };
 	}
 
-	if (TERMINAL_INFO.imageProtocol === ImageProtocol.Iterm2) {
+	if (TERMINAL.imageProtocol === ImageProtocol.Iterm2) {
 		const sequence = encodeITerm2(base64Data, {
 			width: maxWidth,
 			height: "auto",

package/src/terminal.ts

@@ -1,5 +1,5 @@
 import * as fs from "node:fs";
-import { logger } from "@oh-my-pi/pi-utils";
+import { $env, logger } from "@oh-my-pi/pi-utils";
 import { setKittyProtocolActive } from "./keys";
 import { StdinBuffer } from "./stdin-buffer";
 
@@ -82,7 +82,7 @@ export class ProcessTerminal implements Terminal {
 	private stdinBuffer?: StdinBuffer;
 	private stdinDataHandler?: (data: string) => void;
 	private dead = false;
-	private writeLogPath = process.env.OMP_TUI_WRITE_LOG || "";
+	private writeLogPath = $env.PI_TUI_WRITE_LOG || "";
 
 	get kittyProtocolActive(): boolean {
 		return this._kittyProtocolActive;

package/src/tui.ts

@@ -4,9 +4,10 @@
 import * as fs from "node:fs";
 import * as os from "node:os";
 import * as path from "node:path";
+import { $env } from "@oh-my-pi/pi-utils";
 import { isKeyRelease, matchesKey } from "./keys";
 import type { Terminal } from "./terminal";
-import { setCellDimensions, TERMINAL_INFO } from "./terminal-image";
+import { setCellDimensions, TERMINAL } from "./terminal-capabilities";
 import { extractSegments, padding, sliceByColumn, sliceWithWidth, visibleWidth } from "./utils";
 
 /**
@@ -227,7 +228,7 @@ export class TUI extends Container {
 	private hardwareCursorRow = 0; // Actual terminal cursor row (may differ due to IME positioning)
 	private inputBuffer = ""; // Buffer for parsing terminal responses
 	private cellSizeQueryPending = false;
-	private showHardwareCursor = process.env.OMP_HARDWARE_CURSOR === "1";
+	private showHardwareCursor = $env.PI_HARDWARE_CURSOR === "1";
 	private maxLinesRendered = 0; // Track terminal's working area (max lines ever rendered)
 	private previousViewportTop = 0; // Track previous viewport top for resize-aware cursor moves
 	private fullRedrawCount = 0;
@@ -384,7 +385,7 @@ export class TUI extends Container {
 
 	private queryCellSize(): void {
 		// Only query if terminal supports images (cell size is only used for image rendering)
-		if (!TERMINAL_INFO.imageProtocol) {
+		if (!TERMINAL.imageProtocol) {
 			return;
 		}
 		// Query terminal for cell size in pixels: CSI 16 t
@@ -767,7 +768,7 @@ export class TUI extends Container {
 		const reset = TUI.SEGMENT_RESET;
 		for (let i = 0; i < lines.length; i++) {
 			const line = lines[i];
-			if (!TERMINAL_INFO.isImageLine(line)) {
+			if (!TERMINAL.isImageLine(line)) {
 				lines[i] = line + reset;
 			}
 		}
@@ -846,7 +847,7 @@ export class TUI extends Container {
 		overlayWidth: number,
 		totalWidth: number,
 	): string {
-		if (TERMINAL_INFO.isImageLine(baseLine)) return baseLine;
+		if (TERMINAL.isImageLine(baseLine)) return baseLine;
 
 		// Single pass through baseLine extracts both before and after segments
 		const afterStart = startCol + overlayWidth;
@@ -1081,7 +1082,7 @@ export class TUI extends Container {
 			if (i > firstChanged) buffer += "\r\n";
 			buffer += "\x1b[2K"; // Clear current line
 			let line = newLines[i];
-			const isImageLine = TERMINAL_INFO.isImageLine(line);
+			const isImageLine = TERMINAL.isImageLine(line);
 			if (!isImageLine && visibleWidth(line) > width) {
 				if (process.platform === "win32") {
 					line = sliceByColumn(line, 0, width, true);