@oh-my-pi/pi-tui 13.3.9 → 13.3.12

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 ## [Unreleased]
 
+## [13.3.11] - 2026-02-28
+
+### Fixed
+
+- 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
 

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@oh-my-pi/pi-tui",
-	"version": "13.3.9",
+	"version": "13.3.12",
 	"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,8 +33,8 @@
 		"test": "bun test test/*.test.ts"
 	},
 	"dependencies": {
-		"@oh-my-pi/pi-natives": "13.3.9",
-		"@oh-my-pi/pi-utils": "13.3.9",
+		"@oh-my-pi/pi-natives": "13.3.12",
+		"@oh-my-pi/pi-utils": "13.3.12",
 		"marked": "^17.0"
 	},
 	"devDependencies": {

package/src/terminal-capabilities.ts

@@ -47,6 +47,24 @@ export function isNotificationSuppressed(): boolean {
 	return value === "off" || value === "0" || value === "false";
 }
 
+function getForcedImageProtocol(): ImageProtocol | null | undefined {
+	const raw = $env.PI_FORCE_IMAGE_PROTOCOL?.trim().toLowerCase();
+	if (!raw) return undefined;
+	if (raw === "kitty") return ImageProtocol.Kitty;
+	if (raw === "iterm2" || raw === "iterm") return ImageProtocol.Iterm2;
+	if (raw === "off" || raw === "none" || raw === "0" || raw === "false") return null;
+	return null;
+}
+
+function getFallbackImageProtocol(terminalId: TerminalId): ImageProtocol | null {
+	if (!process.stdout.isTTY) return null;
+	if (terminalId === "vscode" || terminalId === "alacritty") return null;
+	const term = Bun.env.TERM?.toLowerCase() ?? "";
+	if (term.includes("screen") || term.includes("tmux") || term.includes("ghostty")) {
+		return ImageProtocol.Kitty;
+	}
+	return null;
+}
 const KNOWN_TERMINALS = Object.freeze({
 	// Fallback terminals
 	base: new TerminalInfo("base", null, false, true, NotifyProtocol.Bell),
@@ -101,7 +119,32 @@ export const TERMINAL_ID: TerminalId = (() => {
 	return "base";
 })();
 
-export const TERMINAL = getTerminalInfo(TERMINAL_ID);
+export const TERMINAL = (() => {
+	const terminal = getTerminalInfo(TERMINAL_ID);
+	const forcedImageProtocol = getForcedImageProtocol();
+	if (forcedImageProtocol !== undefined) {
+		return new TerminalInfo(
+			terminal.id,
+			forcedImageProtocol,
+			terminal.trueColor,
+			terminal.hyperlinks,
+			terminal.notifyProtocol,
+		);
+	}
+	if (!terminal.imageProtocol) {
+		const fallbackImageProtocol = getFallbackImageProtocol(terminal.id);
+		if (fallbackImageProtocol) {
+			return new TerminalInfo(
+				terminal.id,
+				fallbackImageProtocol,
+				terminal.trueColor,
+				terminal.hyperlinks,
+				terminal.notifyProtocol,
+			);
+		}
+	}
+	return terminal;
+})();
 
 export function getTerminalInfo(terminalId: TerminalId): TerminalInfo {
 	return KNOWN_TERMINALS[terminalId];