@oh-my-pi/pi-tui 14.0.3 → 14.0.5

package/CHANGELOG.md

@@ -2,6 +2,16 @@
 
 ## [Unreleased]
 
+## [14.0.5] - 2026-04-11
+
+### Changed
+
+- Updated hash computation to use `Bun.hash()` instead of `Bun.hash.xxHash64()`, which may return `number` in addition to `bigint`
+- Simplified cache key computation in Box component by removing intermediate hash updates and consolidating hash operations
+- Wrapped native text utility functions (`sliceWithWidth`, `truncateToWidth`, `wrapTextWithAnsi`, `extractSegments`) to automatically pass the current default tab width, simplifying the API for consumers
+- Added `getIndentationNoescape` wrapper that uses `process.cwd()` as the project root for relative file paths
+- Re-export `getDefaultTabWidth`, `getIndentation`, and `setDefaultTabWidth` from `@oh-my-pi/pi-utils`; native text helpers still receive tab width via wrappers that read the JS default
+
 ## [13.16.1] - 2026-03-27
 
 ### Added

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@oh-my-pi/pi-tui",
-	"version": "14.0.3",
+	"version": "14.0.5",
 	"description": "Terminal User Interface library with differential rendering for efficient text-based applications",
 	"homepage": "https://github.com/can1357/oh-my-pi",
 	"author": "Can Boluk",
@@ -37,8 +37,8 @@
 		"fmt": "biome format --write ."
 	},
 	"dependencies": {
-		"@oh-my-pi/pi-natives": "14.0.3",
-		"@oh-my-pi/pi-utils": "14.0.3",
+		"@oh-my-pi/pi-natives": "14.0.5",
+		"@oh-my-pi/pi-utils": "14.0.5",
 		"marked": "^17.0"
 	},
 	"devDependencies": {

package/src/components/box.ts

@@ -2,7 +2,7 @@ import type { Component } from "../tui";
 import { applyBackgroundToLine, padding, visibleWidth } from "../utils";
 
 type Cache = {
-	key: bigint;
+	key: bigint | number;
 	result: string[];
 };
 
@@ -52,20 +52,20 @@ export class Box implements Component {
 	}
 
 	static #tmp = new Uint32Array(2);
-	#computeCacheKey(width: number, childLines: string[], bgSample: string | undefined): bigint {
+	#computeCacheKey(width: number, childLines: string[], bgSample: string | undefined): bigint | number {
 		Box.#tmp[0] = width;
 		Box.#tmp[1] = childLines.length;
-		let h = Bun.hash.xxHash64(Box.#tmp);
+		let h = Bun.hash(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(line, h);
+		}
+		if (bgSample) {
+			h = Bun.hash(bgSample, h);
 		}
-		h = Bun.hash.xxHash64(bgSample ?? "", h);
 		return h;
 	}
 
-	#matchCache(cacheKey: bigint): boolean {
+	#matchCache(cacheKey: bigint | number): boolean {
 		return this.#cached?.key === cacheKey;
 	}
 

package/src/components/markdown.ts

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

package/src/tui.ts

@@ -3,7 +3,7 @@
  */
 import * as fs from "node:fs";
 import * as path from "node:path";
-import { getCrashLogPath, getDebugLogPath } from "@oh-my-pi/pi-utils";
+import { $flag, getCrashLogPath, getDebugLogPath } from "@oh-my-pi/pi-utils";
 import { isKeyRelease, matchesKey } from "./keys";
 import type { Terminal } from "./terminal";
 import { ImageProtocol, setCellDimensions, setTerminalImageProtocol, TERMINAL } from "./terminal-capabilities";
@@ -228,8 +228,8 @@ export class TUI extends Container {
 	#sixelProbeBuffer = "";
 	#sixelProbeTimeout?: NodeJS.Timeout;
 	#sixelProbeUnsubscribe?: () => void;
-	#showHardwareCursor = process.env.PI_HARDWARE_CURSOR === "1";
-	#clearOnShrink = process.env.PI_CLEAR_ON_SHRINK === "1"; // Clear empty rows when content shrinks (default: off)
+	#showHardwareCursor = $flag("PI_HARDWARE_CURSOR");
+	#clearOnShrink = $flag("PI_CLEAR_ON_SHRINK"); // Clear empty rows when content shrinks (default: off)
 	#maxLinesRendered = 0; // High-water line count used for clear-on-shrink policy
 	#fullRedrawCount = 0;
 	#stopped = false;
@@ -1035,7 +1035,7 @@ export class TUI extends Container {
 			this.#previousHeight = height;
 		};
 
-		const debugRedraw = process.env.PI_DEBUG_REDRAW === "1";
+		const debugRedraw = $flag("PI_DEBUG_REDRAW");
 		const logRedraw = (reason: string): void => {
 			if (!debugRedraw) return;
 			const logPath = getDebugLogPath();
@@ -1246,7 +1246,7 @@ export class TUI extends Container {
 
 		buffer += "\x1b[?2026l"; // End synchronized output
 
-		if (process.env.PI_TUI_DEBUG === "1") {
+		if ($flag("PI_TUI_DEBUG")) {
 			const debugDir = "/tmp/tui";
 			fs.mkdirSync(debugDir, { recursive: true });
 			const debugPath = path.join(debugDir, `render-${Date.now()}-${Math.random().toString(36).slice(2)}.log`);

package/src/utils.ts

@@ -1,10 +1,53 @@
-import { getDefaultTabWidth, getIndentation, sliceWithWidth } from "@oh-my-pi/pi-natives";
+import type { Ellipsis, ExtractSegmentsResult, SliceResult } from "@oh-my-pi/pi-natives";
+import {
+	extractSegments as nativeExtractSegments,
+	sliceWithWidth as nativeSliceWithWidth,
+	truncateToWidth as nativeTruncateToWidth,
+	wrapTextWithAnsi as nativeWrapTextWithAnsi,
+} from "@oh-my-pi/pi-natives";
+import { getDefaultTabWidth, getIndentation } from "@oh-my-pi/pi-utils";
 
-export { Ellipsis, extractSegments, sliceWithWidth, truncateToWidth, wrapTextWithAnsi } from "@oh-my-pi/pi-natives";
+export { Ellipsis } from "@oh-my-pi/pi-natives";
+
+export { getDefaultTabWidth, getIndentation } from "@oh-my-pi/pi-utils";
+
+export function sliceWithWidth(line: string, startCol: number, length: number, strict?: boolean | null): SliceResult {
+	return nativeSliceWithWidth(line, startCol, length, strict, getDefaultTabWidth());
+}
+
+export function truncateToWidth(
+	text: string,
+	maxWidth: number,
+	ellipsisKind?: Ellipsis | null,
+	pad?: boolean | null,
+): string {
+	return nativeTruncateToWidth(text, maxWidth, ellipsisKind, pad, getDefaultTabWidth());
+}
+
+export function wrapTextWithAnsi(text: string, width: number): string[] {
+	return nativeWrapTextWithAnsi(text, width, getDefaultTabWidth());
+}
+
+export function extractSegments(
+	line: string,
+	beforeEnd: number,
+	afterStart: number,
+	afterLen: number,
+	strictAfter: boolean,
+): ExtractSegmentsResult {
+	return nativeExtractSegments(line, beforeEnd, afterStart, afterLen, strictAfter, getDefaultTabWidth());
+}
 
 // Pre-allocated space buffer for padding
 const SPACE_BUFFER = " ".repeat(512);
 
+/**
+ * Tab width in columns for `file`, using `process.cwd()` as the project root for relative paths.
+ */
+export function getIndentationNoescape(file?: string): number {
+	return getIndentation(file, process.cwd());
+}
+
 /*
  * Replace tabs with configured spacing for consistent rendering.
  */
@@ -31,19 +74,6 @@ export function getSegmenter(): Intl.Segmenter {
 	return segmenter;
 }
 
-/**
- * Calculate the visible width of a string in terminal columns.
- */
-function _isPrintableAscii(str: string): boolean {
-	for (let i = 0; i < str.length; i++) {
-		const code = str.charCodeAt(i);
-		if (code < 0x20 || code > 0x7e) {
-			return false;
-		}
-	}
-	return true;
-}
-
 export function visibleWidthRaw(str: string): number {
 	if (!str) {
 		return 0;