@oh-my-pi/pi-tui 17.0.7 → 17.0.8

package/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 ## [Unreleased]
 
+## [17.0.8] - 2026-07-22
+
+### Fixed
+
+- Fixed an issue where OSC 8 hyperlinks with inline markup corrupted Markdown table column widths.
+- Prevented duplicate autocomplete suggestions for slash commands and their matching aliases.
+- Fixed terminal background color detection during screen refreshes (Ctrl+L) inside tmux when passthrough is enabled.
+
 ## [17.0.6] - 2026-07-20
 
 ### Fixed

package/dist/types/terminal.d.ts

@@ -105,11 +105,11 @@ export declare class ProcessTerminal implements Terminal {
     onAppearanceChange(callback: (appearance: TerminalAppearance) => void): void;
     /**
      * Re-query the terminal background via a single OSC 11 probe. Reuses the
-     * startup query path — same DA1-sentinel FIFO, pending/queued gating, parsing,
-     * dedup, and appearance callbacks — so a light/dark switch is picked up
-     * without a restart on terminals lacking end-to-end Mode 2031 notifications.
-     * Bounded to one probe per call; no timers are armed. Suppressed while headless
-     * or after the terminal is torn down.
+     * startup DA1-sentinel FIFO, pending/queued gating, parsing, dedup, and
+     * appearance callbacks. Inside tmux, only this explicit path wraps the query
+     * and sentinel together for passthrough to the outer terminal; startup and
+     * Mode 2031 probes remain direct. Bounded to one probe per call; no timers are
+     * armed. Suppressed while headless or after the terminal is torn down.
      */
     refreshAppearance(): void;
     onPrivateModeReport(callback: (mode: number, supported: boolean, confirmed?: boolean) => void): void;

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@oh-my-pi/pi-tui",
-	"version": "17.0.7",
+	"version": "17.0.8",
 	"description": "Terminal User Interface library with differential rendering for efficient text-based applications",
 	"homepage": "https://omp.sh",
 	"author": "Can Boluk",
@@ -37,8 +37,8 @@
 		"fmt": "biome format --write ."
 	},
 	"dependencies": {
-		"@oh-my-pi/pi-natives": "17.0.7",
-		"@oh-my-pi/pi-utils": "17.0.7",
+		"@oh-my-pi/pi-natives": "17.0.8",
+		"@oh-my-pi/pi-utils": "17.0.8",
 		"lru-cache": "11.5.2",
 		"marked": "^18.0.6"
 	},

package/src/autocomplete.ts

@@ -307,7 +307,7 @@ function buildSlashCommandCompletions(commands: CommandEntry[], lowerPrefix: str
 				}
 				return fullDescMemo;
 			};
-			const candidates: Array<AutocompleteItem & { score: number }> = [];
+			let best: (AutocompleteItem & { score: number }) | undefined;
 
 			const isSkillCommand = name.startsWith("skill:");
 			const nameScore =
@@ -318,30 +318,30 @@ function buildSlashCommandCompletions(commands: CommandEntry[], lowerPrefix: str
 			const primaryScore = Math.max(nameScore, descScore);
 			if (primaryScore > 0) {
 				const fullDesc = resolveFullDesc();
-				candidates.push({
+				best = {
 					value: name,
 					label: "name" in cmd ? cmd.name : cmd.label,
 					score: primaryScore,
 					...(fullDesc && { description: fullDesc }),
-				});
+				};
 			}
 
 			if (lowerPrefix.length > 0) {
 				for (const alias of getCommandAliases(cmd)) {
 					if (alias === name) continue;
 					const aliasScore = scoreCommandTextMatch(lowerPrefix, alias.toLowerCase());
-					if (aliasScore === 0) continue;
+					if (aliasScore === 0 || (best && aliasScore <= best.score)) continue;
 					const fullDesc = resolveFullDesc();
-					candidates.push({
+					best = {
 						value: alias,
 						label: alias,
 						score: aliasScore,
 						...(fullDesc && { description: fullDesc }),
-					});
+					};
 				}
 			}
 
-			return candidates;
+			return best ? [best] : [];
 		})
 		.sort((a, b) => b.score - a.score)
 		.map(({ score: _, ...rest }) => rest);

package/src/components/markdown.ts

@@ -20,6 +20,16 @@ import {
 
 const STRICT_STRIKETHROUGH_REGEX = /^(~~)(?=[^\s~])((?:\\.|[^\\])*?(?:\\.|[^\s~\\]))\1(?=[^~]|$)/;
 
+// Marked treats the backslash in an ST-terminated OSC 8 sequence (`ESC \\`) as
+// Markdown punctuation when it is immediately followed by markup such as a
+// codespan backtick. Normalize well-formed OSC 8 prefixes to the equivalent BEL
+// terminator before lexing so the control sequence stays opaque to Markdown.
+const OSC8_ST_PREFIX_REGEX = /(\x1b\]8;[^\x07\x1b]*)\x1b\\/g;
+
+function normalizeOsc8Terminators(text: string): string {
+	return text.replace(OSC8_ST_PREFIX_REGEX, "$1\x07");
+}
+
 // OSC 66 (Kitty text-sizing) heading spans are emitted as a single indivisible
 // unit by the H1 render path. Like image-protocol lines, they must bypass
 // ANSI wrapping and width padding: re-wrapping splits/normalizes the sized span
@@ -1097,7 +1107,7 @@ export class Markdown implements Component, NativeScrollbackCommittedRows, Nativ
 		defaultTextStyle?: DefaultTextStyle,
 		codeBlockIndent: number = 2,
 	) {
-		this.#text = text;
+		this.#text = normalizeOsc8Terminators(text);
 		this.#paddingX = paddingX;
 		this.#paddingY = paddingY;
 		this.#theme = theme;
@@ -1106,6 +1116,7 @@ export class Markdown implements Component, NativeScrollbackCommittedRows, Nativ
 	}
 
 	setText(text: string): boolean {
+		text = normalizeOsc8Terminators(text);
 		// Equality guard: streaming re-emits identical text on ticks that carried
 		// no delta (throttled provider frames, reconciled tool-execution updates).
 		// Without this, the caller-side `#cachedLines` gets thrown away and the
@@ -2611,7 +2622,7 @@ export class Markdown implements Component, NativeScrollbackCommittedRows, Nativ
 export function renderInlineMarkdown(text: string, mdTheme: MarkdownTheme, baseColor?: (t: string) => string): string {
 	// Guard against undefined/null during streaming — partial JSON can leave fields unpopulated.
 	if (typeof text !== "string") return (baseColor ?? (t => t))(text != null ? String(text) : "");
-	const tokens = markdownParser.lexer(text);
+	const tokens = markdownParser.lexer(normalizeOsc8Terminators(text));
 	const applyText = baseColor ?? ((t: string) => t);
 	let result = "";
 	for (const token of tokens) {

package/src/terminal.ts

@@ -18,6 +18,7 @@ import {
 	setOsc99Supported,
 	TERMINAL,
 } from "./terminal-capabilities";
+import { isInsideTmux, wrapTmuxPassthrough } from "./tmux";
 import { type HangulCompatibilityJamoWidth, setHangulCompatibilityJamoWidth } from "./utils";
 
 const TERMINAL_PROGRESS_KEEPALIVE_MS = 1000;
@@ -456,6 +457,7 @@ function parseOsc99KeyValues(section: string): Map<string, string> {
 	return values;
 }
 const XTERM_SCROLL_TO_BOTTOM_MODES = [1010, 1011] as const;
+type Osc11QueryRoute = "direct" | "tmux";
 
 function isXtermScrollToBottomMode(mode: number): boolean {
 	return mode === 1010 || mode === 1011;
@@ -509,7 +511,7 @@ export class ProcessTerminal implements Terminal {
 	#appearanceCallbacks: Array<(appearance: TerminalAppearance) => void> = [];
 	#appearance: TerminalAppearance | undefined;
 	#osc11Pending = false;
-	#osc11QueryQueued = false;
+	#osc11QueuedRoute?: Osc11QueryRoute;
 	#osc11ResponseBuffer = "";
 	#osc99PendingId: string | undefined;
 	#osc99ResponseBuffer = "";
@@ -572,15 +574,15 @@ export class ProcessTerminal implements Terminal {
 
 	/**
 	 * Re-query the terminal background via a single OSC 11 probe. Reuses the
-	 * startup query path — same DA1-sentinel FIFO, pending/queued gating, parsing,
-	 * dedup, and appearance callbacks — so a light/dark switch is picked up
-	 * without a restart on terminals lacking end-to-end Mode 2031 notifications.
-	 * Bounded to one probe per call; no timers are armed. Suppressed while headless
-	 * or after the terminal is torn down.
+	 * startup DA1-sentinel FIFO, pending/queued gating, parsing, dedup, and
+	 * appearance callbacks. Inside tmux, only this explicit path wraps the query
+	 * and sentinel together for passthrough to the outer terminal; startup and
+	 * Mode 2031 probes remain direct. Bounded to one probe per call; no timers are
+	 * armed. Suppressed while headless or after the terminal is torn down.
 	 */
 	refreshAppearance(): void {
 		if (this.#headless || this.#dead) return;
-		this.#queryBackgroundColor();
+		this.#queryBackgroundColor(isInsideTmux() ? "tmux" : "direct");
 	}
 
 	onPrivateModeReport(callback: (mode: number, supported: boolean, confirmed?: boolean) => void): void {
@@ -917,13 +919,14 @@ export class ProcessTerminal implements Terminal {
 						}
 						// Start a queued OSC 11 query once the prior cycle is fully drained.
 						if (
-							this.#osc11QueryQueued &&
+							this.#osc11QueuedRoute !== undefined &&
 							!this.#osc11Pending &&
 							!this.#da1SentinelOwners.some(o => o.kind === "osc11") &&
 							!this.#dead
 						) {
-							this.#osc11QueryQueued = false;
-							this.#startOsc11Query();
+							const route = this.#osc11QueuedRoute;
+							this.#osc11QueuedRoute = undefined;
+							this.#startOsc11Query(route);
 						}
 						break;
 					}
@@ -1058,23 +1061,28 @@ export class ProcessTerminal implements Terminal {
 	 * DA1 avoids indefinite hangs: if DA1 response arrives before OSC 11,
 	 * the terminal does not support OSC 11.
 	 */
-	#queryBackgroundColor(): void {
+	#queryBackgroundColor(route: Osc11QueryRoute = "direct"): void {
 		if (this.#dead) return;
 		// Queue if an OSC 11 query is in flight or its DA1 sentinel hasn't been
 		// consumed yet. Starting a new query while a DA1 is outstanding would
 		// increment the sentinel counter, and the old DA1 arrival would then
-		// prematurely clear the new query's pending state.
+		// prematurely clear the new query's pending state. Preserve a requested
+		// tmux passthrough route when coalescing direct and explicit queries.
 		if (this.#osc11Pending || this.#da1SentinelOwners.some(o => o.kind === "osc11")) {
-			this.#osc11QueryQueued = true;
+			if (this.#osc11QueuedRoute !== "tmux") this.#osc11QueuedRoute = route;
 			return;
 		}
-		this.#startOsc11Query();
+		this.#startOsc11Query(route);
 	}
 
-	#startOsc11Query(): void {
+	#startOsc11Query(route: Osc11QueryRoute): void {
 		this.#osc11Pending = true;
 		this.#osc11ResponseBuffer = "";
 		this.#da1SentinelOwners.push({ kind: "osc11" });
+		if (route === "tmux") {
+			this.#safeWrite(wrapTmuxPassthrough("\x1b]11;?\x07\x1b[c"));
+			return;
+		}
 		this.#safeWrite("\x1b]11;?\x07"); // OSC 11 query (BEL terminated)
 		this.#safeWrite("\x1b[c"); // DA1 sentinel
 	}
@@ -1397,7 +1405,7 @@ export class ProcessTerminal implements Terminal {
 		this.#appearanceCallbacks = [];
 		this.#osc11Pending = false;
 		this.#clearWindowsTerminalAppearancePoll();
-		this.#osc11QueryQueued = false;
+		this.#osc11QueuedRoute = undefined;
 		this.#osc11ResponseBuffer = "";
 		this.#osc99PendingId = undefined;
 		this.#osc99ResponseBuffer = "";