@f5-sales-demo/pi-tui 23.10.1 → 23.10.3

package/README.md

@@ -416,7 +416,7 @@ const spacer = new Spacer(2); // 2 empty lines (default: 1)
 
 ### Image
 
-Renders images inline for terminals that support the Kitty graphics protocol (Kitty, Ghostty, WezTerm) or iTerm2 inline images. Falls back to a text placeholder on unsupported terminals.
+Renders images inline for terminals that support the Kitty graphics protocol (Kitty, Ghostty, WezTerm) or iTerm2 inline images. Falls back to a text placeholder on unsupported terminals. Inside Herdr, images require the server-provided `HERDR_KITTY_GRAPHICS=1` capability. Disabling graphics in Herdr selects the text fallback even when the outer terminal supports images.
 
 ```typescript
 interface ImageTheme {

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@f5-sales-demo/pi-tui",
-	"version": "23.10.1",
+	"version": "23.10.3",
 	"description": "Terminal User Interface library with differential rendering for efficient text-based applications",
 	"homepage": "https://github.com/f5-sales-demo/xcsh",
 	"author": "Can Boluk",
@@ -37,8 +37,8 @@
 		"fmt": "biome format --write ."
 	},
 	"dependencies": {
-		"@f5-sales-demo/pi-natives": "23.10.1",
-		"@f5-sales-demo/pi-utils": "23.10.1",
+		"@f5-sales-demo/pi-natives": "23.10.3",
+		"@f5-sales-demo/pi-utils": "23.10.3",
 		"marked": "18.0.11"
 	},
 	"devDependencies": {

package/src/terminal-capabilities.ts

@@ -231,7 +231,12 @@ export function resolveTerminalId(env: NodeJS.ProcessEnv): TerminalId {
 export function resolveTerminalInfo(env: NodeJS.ProcessEnv, stdoutIsTTY: boolean): TerminalInfo {
 	const terminal = getTerminalInfo(resolveTerminalId(env));
 	const hyperlinks = shouldEnableTerminalHyperlinks(env, stdoutIsTTY, terminal.id);
-	const forcedImageProtocol = getForcedImageProtocol(env);
+	let forcedImageProtocol = getForcedImageProtocol(env);
+	if (isInsideHerdr(env)) {
+		// Herdr owns graphics delivery. Inherited host hints cannot override its opt-out.
+		if (!stdoutIsTTY || !hasHerdrKittyGraphics(env)) forcedImageProtocol = null;
+		else if (forcedImageProtocol === undefined) forcedImageProtocol = ImageProtocol.Kitty;
+	}
 	if (forcedImageProtocol !== undefined) {
 		return new TerminalInfo(
 			terminal.id,

package/src/tui.ts

@@ -8,7 +8,7 @@ import { isKeyRelease, matchesKey } from "./keys";
 import { type MouseRoutable, routeSgrMouseInput } from "./mouse";
 import { setAlternateScreenActive, type Terminal } from "./terminal";
 import { ImageProtocol, setCellDimensions, setTerminalImageProtocol, TERMINAL } from "./terminal-capabilities";
-import { isInsideTerminalMultiplexer } from "./terminal-multiplexer";
+import { isInsideHerdr, isInsideTerminalMultiplexer } from "./terminal-multiplexer";
 import { extractSegments, getSegmenter, sliceByColumn, sliceWithWidth, visibleWidth } from "./utils";
 
 const SEGMENT_RESET = "\x1b[0m";
@@ -608,6 +608,8 @@ export class TUI extends Container {
 	}
 
 	#querySixelSupport(): void {
+		// Herdr negotiates Kitty delivery through its child capability, not host SIXEL probes.
+		if (isInsideHerdr()) return;
 		if (TERMINAL.imageProtocol) return;
 		if (process.platform !== "win32") return;
 		if (!Bun.env.WT_SESSION) return;