@oh-my-pi/pi-tui 13.3.7 → 13.3.8

package/CHANGELOG.md

@@ -2,6 +2,17 @@
 
 ## [Unreleased]
 
+## [13.3.8] - 2026-02-28
+### Breaking Changes
+
+- Changed mermaid hash type from string to bigint in `getMermaidImage` callback and `extractMermaidBlocks` return type
+- Removed `mime-types` and `@types/mime-types` from dependencies
+- Removed `@xterm/xterm` from dependencies
+
+### Changed
+
+- Updated mermaid hash computation to use `Bun.hash.xxHash64()` instead of `Bun.hash().toString(16)`
+
 ## [12.19.0] - 2026-02-22
 
 ### Added

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@oh-my-pi/pi-tui",
-	"version": "13.3.7",
+	"version": "13.3.8",
 	"description": "Terminal User Interface library with differential rendering for efficient text-based applications",
 	"homepage": "https://github.com/can1357/oh-my-pi",
 	"author": "Can Boluk",
@@ -33,16 +33,13 @@
 		"test": "bun test test/*.test.ts"
 	},
 	"dependencies": {
-		"@oh-my-pi/pi-natives": "13.3.7",
-		"@oh-my-pi/pi-utils": "13.3.7",
-		"@types/mime-types": "^3.0",
-		"chalk": "^5.6",
-		"marked": "^17.0",
-		"mime-types": "^3.0"
+		"@oh-my-pi/pi-natives": "13.3.8",
+		"@oh-my-pi/pi-utils": "13.3.8",
+		"marked": "^17.0"
 	},
 	"devDependencies": {
-		"@xterm/headless": "^6.0",
-		"@xterm/xterm": "^6.0"
+		"chalk": "^5.6",
+		"@xterm/headless": "^6.0"
 	},
 	"engines": {
 		"bun": ">=1.3.7"

package/src/components/markdown.ts

@@ -46,10 +46,10 @@ export interface MarkdownTheme {
 	highlightCode?: (code: string, lang?: string) => string[];
 	/**
 	 * Lookup a pre-rendered mermaid image by source hash.
-	 * Hash is computed as `Bun.hash(source.trim()).toString(16)`.
+	 * Hash is computed as `Bun.hash.xxHash64(source.trim())`.
 	 * Return null to fall back to text rendering.
 	 */
-	getMermaidImage?: (sourceHash: string) => MermaidImage | null;
+	getMermaidImage?: (sourceHash: bigint) => MermaidImage | null;
 	symbols: SymbolTheme;
 }
 
@@ -322,7 +322,7 @@ export class Markdown implements Component {
 			case "code": {
 				// Handle mermaid diagrams with image rendering when available
 				if (token.lang === "mermaid" && this.#theme.getMermaidImage) {
-					const hash = Bun.hash(token.text.trim()).toString(16);
+					const hash = Bun.hash.xxHash64(token.text.trim());
 					const image = this.#theme.getMermaidImage(hash);
 
 					if (image && TERMINAL.imageProtocol) {

package/src/index.ts

@@ -57,7 +57,7 @@ export {
 export { StdinBuffer, type StdinBufferEventMap, type StdinBufferOptions } from "./stdin-buffer";
 export type { BoxSymbols, SymbolTheme } from "./symbols";
 // Terminal interface and implementations
-export { emergencyTerminalRestore, ProcessTerminal, type Terminal } from "./terminal";
+export { emergencyTerminalRestore, ProcessTerminal, type Terminal, type TerminalAppearance } from "./terminal";
 // Terminal image support
 export * from "./terminal-capabilities";
 // TTY ID

package/src/mermaid.ts

@@ -99,13 +99,13 @@ function parsePngDimensions(buffer: Uint8Array): { width: number; height: number
  * Extract mermaid code blocks from markdown text.
  * Returns array of { source, startIndex, endIndex } for each block.
  */
-export function extractMermaidBlocks(markdown: string): { source: string; hash: string }[] {
-	const blocks: { source: string; hash: string }[] = [];
+export function extractMermaidBlocks(markdown: string): { source: string; hash: bigint }[] {
+	const blocks: { source: string; hash: bigint }[] = [];
 	const regex = /```mermaid\s*\n([\s\S]*?)```/g;
 
 	for (let match = regex.exec(markdown); match !== null; match = regex.exec(markdown)) {
 		const source = match[1].trim();
-		const hash = Bun.hash(source).toString(16);
+		const hash = Bun.hash.xxHash64(source);
 		blocks.push({ source, hash });
 	}
 
@@ -119,9 +119,9 @@ export function extractMermaidBlocks(markdown: string): { source: string; hash:
 export async function prerenderMermaidBlocks(
 	markdown: string,
 	options: MermaidRenderOptions = {},
-): Promise<Map<string, MermaidImage>> {
+): Promise<Map<bigint, MermaidImage>> {
 	const blocks = extractMermaidBlocks(markdown);
-	const cache = new Map<string, MermaidImage>();
+	const cache = new Map<bigint, MermaidImage>();
 
 	const results = await Promise.all(
 		blocks.map(async ({ source, hash }) => {

package/src/terminal.ts

@@ -30,6 +30,7 @@ export function emergencyTerminalRestore(): void {
 			// This avoids writing escape sequences for non-TUI commands (grep, commit, etc.)
 			process.stdout.write(
 				"\x1b[?2004l" + // Disable bracketed paste
+					"\x1b[?2031l" + // Disable Mode 2031 appearance notifications
 					"\x1b[<u" + // Pop kitty keyboard protocol
 					"\x1b[?25h", // Show cursor
 			);
@@ -41,6 +42,8 @@ export function emergencyTerminalRestore(): void {
 		// Terminal may already be dead during crash cleanup - ignore errors
 	}
 }
+/** Terminal-reported appearance (dark/light mode). */
+export type TerminalAppearance = "dark" | "light";
 export interface Terminal {
 	// Start the terminal with input and resize handlers
 	start(onInput: (data: string) => void, onResize: () => void): void;
@@ -80,6 +83,16 @@ export interface Terminal {
 
 	// Title operations
 	setTitle(title: string): void; // Set terminal window title
+
+	/**
+	 * Register a callback for Mode 2031 dark/light appearance change notifications.
+	 * Supported by Ghostty, Kitty, Contour, VTE (GNOME Terminal), and tmux 3.6+.
+	 * The callback fires when the terminal reports a change; it does NOT fire for the initial query.
+	 */
+	onAppearanceChange(callback: (appearance: TerminalAppearance) => void): void;
+
+	/** The last appearance reported by the terminal, or undefined if not yet known. */
+	get appearance(): TerminalAppearance | undefined;
 }
 
 /**
@@ -95,11 +108,21 @@ export class ProcessTerminal implements Terminal {
 	#dead = false;
 	#writeLogPath = $env.PI_TUI_WRITE_LOG || "";
 	#windowsVTInputRestore?: () => void;
+	#appearanceCallbacks: Array<(appearance: TerminalAppearance) => void> = [];
+	#appearance: TerminalAppearance | undefined;
 
 	get kittyProtocolActive(): boolean {
 		return this.#kittyProtocolActive;
 	}
 
+	get appearance(): TerminalAppearance | undefined {
+		return this.#appearance;
+	}
+
+	onAppearanceChange(callback: (appearance: TerminalAppearance) => void): void {
+		this.#appearanceCallbacks.push(callback);
+	}
+
 	start(onInput: (data: string) => void, onResize: () => void): void {
 		this.#inputHandler = onInput;
 		this.#resizeHandler = onResize;
@@ -137,6 +160,13 @@ export class ProcessTerminal implements Terminal {
 		// The query handler intercepts input temporarily, then installs the user's handler
 		// See: https://sw.kovidgoyal.net/kitty/keyboard-protocol/
 		this.#queryAndEnableKittyProtocol();
+
+		// Enable Mode 2031: terminal will send DSR notifications on dark/light appearance changes.
+		// Query current mode with CSI ? 996 n, then subscribe with CSI ? 2031 h.
+		// Supported by Ghostty, Kitty, Contour, VTE/GNOME Terminal, tmux 3.6+.
+		// Unsupported terminals silently ignore these sequences.
+		this.#safeWrite("\x1b[?996n"); // Query current appearance
+		this.#safeWrite("\x1b[?2031h"); // Subscribe to appearance changes
 	}
 
 	/**
@@ -203,6 +233,9 @@ export class ProcessTerminal implements Terminal {
 		// Kitty protocol response pattern: \x1b[?<flags>u
 		const kittyResponsePattern = /^\x1b\[\?(\d+)u$/;
 
+		// Mode 2031 DSR response pattern: \x1b[?997;{1=dark,2=light}n
+		const appearanceDsrPattern = /^\x1b\[\?997;([12])n$/;
+
 		// Forward individual sequences to the input handler
 		this.#stdinBuffer.on("data", (sequence: string) => {
 			// Check for Kitty protocol response (only if not already enabled)
@@ -221,6 +254,23 @@ export class ProcessTerminal implements Terminal {
 				}
 			}
 
+			// Check for Mode 2031 appearance DSR response: CSI ? 997 ; {1,2} n
+			const appearanceMatch = sequence.match(appearanceDsrPattern);
+			if (appearanceMatch) {
+				const mode: TerminalAppearance = appearanceMatch[1] === "1" ? "dark" : "light";
+				const changed = mode !== this.#appearance;
+				this.#appearance = mode;
+				if (changed) {
+					for (const cb of this.#appearanceCallbacks) {
+						try {
+							cb(mode);
+						} catch {
+							/* ignore callback errors */
+						}
+					}
+				}
+				return; // Don't forward DSR to TUI
+			}
 			if (this.#inputHandler) {
 				this.#inputHandler(sequence);
 			}
@@ -297,6 +347,10 @@ export class ProcessTerminal implements Terminal {
 		// Disable bracketed paste mode
 		this.#safeWrite("\x1b[?2004l");
 
+		// Disable Mode 2031 appearance change notifications
+		this.#safeWrite("\x1b[?2031l");
+		this.#appearanceCallbacks = [];
+
 		// Disable Kitty keyboard protocol if not already done by drainInput()
 		if (this.#kittyProtocolActive) {
 			this.#safeWrite("\x1b[<u");
@@ -317,6 +371,7 @@ export class ProcessTerminal implements Terminal {
 			this.#stdinDataHandler = undefined;
 		}
 		this.#inputHandler = undefined;
+		this.#appearance = undefined;
 		if (this.#resizeHandler) {
 			process.stdout.removeListener("resize", this.#resizeHandler);
 			this.#resizeHandler = undefined;
@@ -391,7 +446,7 @@ export class ProcessTerminal implements Terminal {
 	}
 
 	clearScreen(): void {
-		this.#safeWrite("\x1b[2J\x1b[H"); // Clear screen and move to home (1,1)
+		this.#safeWrite("\x1b[H\x1b[0J"); // Move to home (1,1) and clear from cursor to end
 	}
 
 	setTitle(title: string): void {

package/src/tui.ts

@@ -886,7 +886,7 @@ export class TUI extends Container {
 		const fullRender = (clear: boolean): void => {
 			this.#fullRedrawCount += 1;
 			let buffer = "\x1b[?2026h"; // Begin synchronized output
-			if (clear) buffer += this.#clearScrollbackOnNextFullRender ? "\x1b[3J\x1b[2J\x1b[H" : "\x1b[2J\x1b[H"; // Clear viewport (and optionally scrollback), then home
+			if (clear) buffer += this.#clearScrollbackOnNextFullRender ? "\x1b[3J\x1b[H\x1b[0J" : "\x1b[H\x1b[0J"; // Home + clear from cursor (and optionally scrollback)
 			for (let i = 0; i < newLines.length; i++) {
 				if (i > 0) buffer += "\r\n";
 				buffer += newLines[i];