@oh-my-pi/pi-tui 12.8.1 → 12.9.0

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@oh-my-pi/pi-tui",
-	"version": "12.8.1",
+	"version": "12.9.0",
 	"description": "Terminal User Interface library with differential rendering for efficient text-based applications",
 	"type": "module",
 	"main": "./src/index.ts",
@@ -52,8 +52,8 @@
 	"bun": ">=1.3.7"
 },
 "dependencies": {
-	"@oh-my-pi/pi-natives": "12.8.1",
-	"@oh-my-pi/pi-utils": "12.8.1",
+	"@oh-my-pi/pi-natives": "12.9.0",
+	"@oh-my-pi/pi-utils": "12.9.0",
 	"@types/mime-types": "^3.0.1",
 	"chalk": "^5.6.2",
 	"marked": "^17.0.2",

package/src/index.ts

@@ -60,6 +60,8 @@ export type { BoxSymbols, SymbolTheme } from "./symbols";
 export { emergencyTerminalRestore, ProcessTerminal, type Terminal } from "./terminal";
 // Terminal image support
 export * from "./terminal-capabilities";
+// TTY ID
+export { getTerminalId, getTtyPath } from "./ttyid";
 export { type Component, Container, type OverlayHandle, type SizeValue, TUI } from "./tui";
 // Utilities
 export { Ellipsis, padding, replaceTabs, truncateToWidth, visibleWidth, wrapTextWithAnsi } from "./utils";

package/src/ttyid.ts

@@ -0,0 +1,66 @@
+import { CString, dlopen, FFIType } from "bun:ffi";
+import * as fs from "node:fs";
+import * as os from "node:os";
+
+/** Resolve the TTY device path for stdin (fd 0) via POSIX `ttyname(3)`. */
+export function getTtyPath(): string | null {
+	if (os.platform() === "linux") {
+		// Linux: /proc/self/fd/0 is a symlink to /dev/pts/N
+		try {
+			const ttyPath = fs.readlinkSync("/proc/self/fd/0");
+			if (ttyPath.startsWith("/dev/")) {
+				return ttyPath;
+			}
+		} catch {
+			return null;
+		}
+	} else if (os.platform() !== "win32") {
+		try {
+			const libName = os.platform() === "darwin" ? "libSystem.B.dylib" : "libc.so.6";
+			const lib = dlopen(libName, {
+				ttyname: { args: [FFIType.i32], returns: FFIType.ptr },
+			});
+			try {
+				const result = lib.symbols.ttyname(0);
+				return result ? new CString(result).toString() : null;
+			} finally {
+				lib.close();
+			}
+		} catch {
+			return null;
+		}
+	}
+	return null;
+}
+/**
+ * Get a stable identifier for the current terminal.
+ * Uses the TTY device path (e.g., /dev/pts/3), falling back to environment
+ * variables for terminal multiplexers or terminal emulators.
+ * Returns null if no terminal can be identified (e.g., piped input).
+ */
+export function getTerminalId(): string | null {
+	// TTY device path — most reliable, unique per terminal tab
+	if (process.stdin.isTTY) {
+		try {
+			const ttyPath = getTtyPath();
+			if (ttyPath?.startsWith("/dev/")) {
+				return ttyPath.slice(5).replace(/\//g, "-"); // /dev/pts/3 -> pts-3
+			}
+		} catch {}
+	}
+
+	// Fallback to terminal-specific env vars
+	const kittyId = process.env.KITTY_WINDOW_ID;
+	if (kittyId) return `kitty-${kittyId}`;
+
+	const tmuxPane = process.env.TMUX_PANE;
+	if (tmuxPane) return `tmux-${tmuxPane}`;
+
+	const terminalSessionId = process.env.TERM_SESSION_ID; // macOS Terminal.app
+	if (terminalSessionId) return `apple-${terminalSessionId}`;
+
+	const wtSession = process.env.WT_SESSION; // Windows Terminal
+	if (wtSession) return `wt-${wtSession}`;
+
+	return null;
+}