@xynogen/pix-pretty 1.0.0

package/src/icons.ts

@@ -0,0 +1,120 @@
+import { basename, extname } from "node:path";
+
+import { FG_BLUE, FG_DIM, RST } from "./ansi.js";
+
+const ICONS_MODE = (process.env.PRETTY_ICONS ?? "nerd").toLowerCase();
+
+const USE_ICONS = ICONS_MODE !== "none" && ICONS_MODE !== "off";
+
+// Nerd Font codepoints + ANSI color per file type
+const NF_DIR = `${FG_BLUE}\ue5ff${RST}`; // folder
+
+const NF_DEFAULT = `${FG_DIM}\uf15b${RST}`; // generic file
+
+const EXT_ICON: Record<string, string> = {
+	// TypeScript / JavaScript
+	ts: `\x1b[38;2;49;120;198m\ue628${RST}`, // blue
+	tsx: `\x1b[38;2;49;120;198m\ue7ba${RST}`, // react blue
+	js: `\x1b[38;2;241;224;90m\ue74e${RST}`, // yellow
+	jsx: `\x1b[38;2;97;218;251m\ue7ba${RST}`, // react cyan
+	mjs: `\x1b[38;2;241;224;90m\ue74e${RST}`,
+	cjs: `\x1b[38;2;241;224;90m\ue74e${RST}`,
+
+	// Systems / Backend
+	py: `\x1b[38;2;55;118;171m\ue73c${RST}`, // python blue
+	rs: `\x1b[38;2;222;165;132m\ue7a8${RST}`, // rust orange
+	go: `\x1b[38;2;0;173;216m\ue724${RST}`, // go cyan
+	java: `\x1b[38;2;204;62;68m\ue738${RST}`, // java red
+	swift: `\x1b[38;2;255;172;77m\ue755${RST}`, // swift orange
+	rb: `\x1b[38;2;204;52;45m\ue739${RST}`, // ruby red
+	kt: `\x1b[38;2;126;103;200m\ue634${RST}`, // kotlin purple
+	c: `\x1b[38;2;85;154;211m\ue61e${RST}`, // c blue
+	cpp: `\x1b[38;2;85;154;211m\ue61d${RST}`, // cpp blue
+	h: `\x1b[38;2;140;160;185m\ue61e${RST}`, // header muted
+	hpp: `\x1b[38;2;140;160;185m\ue61d${RST}`,
+	cs: `\x1b[38;2;104;33;122m\ue648${RST}`, // c# purple
+
+	// Web
+	html: `\x1b[38;2;228;77;38m\ue736${RST}`, // html orange
+	css: `\x1b[38;2;66;165;245m\ue749${RST}`, // css blue
+	scss: `\x1b[38;2;207;100;154m\ue749${RST}`, // scss pink
+	less: `\x1b[38;2;66;165;245m\ue749${RST}`,
+	vue: `\x1b[38;2;65;184;131m\ue6a0${RST}`, // vue green
+	svelte: `\x1b[38;2;255;62;0m\ue697${RST}`, // svelte red-orange
+
+	// Config / Data
+	json: `\x1b[38;2;241;224;90m\ue60b${RST}`, // json yellow
+	jsonc: `\x1b[38;2;241;224;90m\ue60b${RST}`,
+	yaml: `\x1b[38;2;160;116;196m\ue6a8${RST}`, // yaml purple
+	yml: `\x1b[38;2;160;116;196m\ue6a8${RST}`,
+	toml: `\x1b[38;2;160;116;196m\ue6b2${RST}`, // toml purple
+	xml: `\x1b[38;2;228;77;38m\ue619${RST}`, // xml orange
+	sql: `\x1b[38;2;218;218;218m\ue706${RST}`, // sql gray
+
+	// Markdown / Docs
+	md: `\x1b[38;2;66;165;245m\ue73e${RST}`, // markdown blue
+	mdx: `\x1b[38;2;66;165;245m\ue73e${RST}`,
+
+	// Shell / Scripts
+	sh: `\x1b[38;2;137;180;130m\ue795${RST}`, // shell green
+	bash: `\x1b[38;2;137;180;130m\ue795${RST}`,
+	zsh: `\x1b[38;2;137;180;130m\ue795${RST}`,
+	fish: `\x1b[38;2;137;180;130m\ue795${RST}`,
+	lua: `\x1b[38;2;81;160;207m\ue620${RST}`, // lua blue
+	php: `\x1b[38;2;137;147;186m\ue73d${RST}`, // php purple
+	dart: `\x1b[38;2;87;182;240m\ue798${RST}`, // dart blue
+
+	// Images
+	png: `\x1b[38;2;160;116;196m\uf1c5${RST}`,
+	jpg: `\x1b[38;2;160;116;196m\uf1c5${RST}`,
+	jpeg: `\x1b[38;2;160;116;196m\uf1c5${RST}`,
+	gif: `\x1b[38;2;160;116;196m\uf1c5${RST}`,
+	svg: `\x1b[38;2;255;180;50m\uf1c5${RST}`,
+	webp: `\x1b[38;2;160;116;196m\uf1c5${RST}`,
+	ico: `\x1b[38;2;160;116;196m\uf1c5${RST}`,
+
+	// Misc
+	lock: `\x1b[38;2;130;130;130m\uf023${RST}`, // lock gray
+	env: `\x1b[38;2;241;224;90m\ue615${RST}`, // env yellow
+	graphql: `\x1b[38;2;224;51;144m\ue662${RST}`, // graphql pink
+	dockerfile: `\x1b[38;2;56;152;236m\ue7b0${RST}`,
+};
+
+const NAME_ICON: Record<string, string> = {
+	"package.json": `\x1b[38;2;137;180;130m\ue71e${RST}`, // npm green
+	"package-lock.json": `\x1b[38;2;130;130;130m\ue71e${RST}`, // npm gray
+	"tsconfig.json": `\x1b[38;2;49;120;198m\ue628${RST}`, // ts blue
+	"biome.json": `\x1b[38;2;96;165;250m\ue615${RST}`, // config blue
+	".gitignore": `\x1b[38;2;222;165;132m\ue702${RST}`, // git orange
+	".git": `\x1b[38;2;222;165;132m\ue702${RST}`,
+	".env": `\x1b[38;2;241;224;90m\ue615${RST}`, // env yellow
+	".envrc": `\x1b[38;2;241;224;90m\ue615${RST}`,
+	dockerfile: `\x1b[38;2;56;152;236m\ue7b0${RST}`, // docker blue
+	makefile: `\x1b[38;2;130;130;130m\ue615${RST}`, // make gray
+	gnumakefile: `\x1b[38;2;130;130;130m\ue615${RST}`,
+	"readme.md": `\x1b[38;2;66;165;245m\ue73e${RST}`, // readme blue
+	license: `\x1b[38;2;218;218;218m\ue60a${RST}`, // license white
+	"cargo.toml": `\x1b[38;2;222;165;132m\ue7a8${RST}`, // rust
+	"go.mod": `\x1b[38;2;0;173;216m\ue724${RST}`, // go
+	"pyproject.toml": `\x1b[38;2;55;118;171m\ue73c${RST}`, // python
+};
+
+export function fileIcon(fp: string): string {
+	if (!USE_ICONS) return "";
+	const base = basename(fp).toLowerCase();
+	if (NAME_ICON[base]) return `${NAME_ICON[base]} `;
+	const ext = extname(fp).slice(1).toLowerCase();
+	return EXT_ICON[ext] ? `${EXT_ICON[ext]} ` : `${NF_DEFAULT} `;
+}
+
+export function dirIcon(): string {
+	return USE_ICONS ? `${NF_DIR} ` : "";
+}
+
+// ---------------------------------------------------------------------------
+// cli-highlight ANSI cache
+//
+// highlight.js uses different language ids than shiki for a few entries
+// (no tsx/jsx grammar, jsonc, mdx, make, etc.). Map the shiki-style ids the
+// EXT_LANG table produces onto highlight.js-supported ids.
+// ---------------------------------------------------------------------------

package/src/image.ts

@@ -0,0 +1,166 @@
+import * as childProcess from "node:child_process";
+
+import type { ImageProtocol } from "./types.js";
+
+let _tmuxClientTermCache: string | null | undefined;
+
+let _tmuxAllowPassthroughCache: boolean | null | undefined;
+
+let _tmuxClientTermOverrideForTests: string | null | undefined;
+
+let _tmuxAllowPassthroughOverrideForTests: boolean | null | undefined;
+
+function isTmuxSession(): boolean {
+	return !!process.env.TMUX || /^(tmux|screen)/.test(process.env.TERM ?? "");
+}
+
+function normalizeTerminalName(term: string): string {
+	const t = term.toLowerCase();
+	if (t.includes("kitty")) return "kitty";
+	if (t.includes("ghostty")) return "ghostty";
+	if (t.includes("wezterm")) return "WezTerm";
+	if (t.includes("iterm")) return "iTerm.app";
+	if (t.includes("mintty")) return "mintty";
+	return term;
+}
+
+function readTmuxClientTerm(): string | null {
+	if (_tmuxClientTermOverrideForTests !== undefined) {
+		return _tmuxClientTermOverrideForTests
+			? normalizeTerminalName(_tmuxClientTermOverrideForTests)
+			: null;
+	}
+	if (!isTmuxSession()) return null;
+	if (_tmuxClientTermCache !== undefined) return _tmuxClientTermCache;
+	try {
+		const term = childProcess
+			.execFileSync("tmux", ["display-message", "-p", "#{client_termname}"], {
+				encoding: "utf8",
+				stdio: ["ignore", "pipe", "ignore"],
+				timeout: 200,
+			})
+			.trim();
+		_tmuxClientTermCache = term ? normalizeTerminalName(term) : null;
+	} catch {
+		_tmuxClientTermCache = null;
+	}
+	return _tmuxClientTermCache;
+}
+
+/**
+ * Detect the outer terminal when running inside tmux.
+ * tmux sets TERM_PROGRAM=tmux, but the real terminal is often in
+ * the environment of the tmux server or can be inferred.
+
+ */
+function getOuterTerminal(): string {
+	// Environment hints that often survive inside tmux
+	if (process.env.LC_TERMINAL === "iTerm2") return "iTerm.app";
+	if (process.env.GHOSTTY_RESOURCES_DIR) return "ghostty";
+	if (process.env.KITTY_WINDOW_ID || process.env.KITTY_PID) return "kitty";
+	if (
+		process.env.WEZTERM_EXECUTABLE ||
+		process.env.WEZTERM_CONFIG_DIR ||
+		process.env.WEZTERM_CONFIG_FILE
+	) {
+		return "WezTerm";
+	}
+
+	const termProgram = process.env.TERM_PROGRAM ?? "";
+	if (termProgram && termProgram !== "tmux" && termProgram !== "screen") {
+		return normalizeTerminalName(termProgram);
+	}
+
+	const tmuxClientTerm = readTmuxClientTerm();
+	if (tmuxClientTerm) return tmuxClientTerm;
+
+	const term = process.env.TERM ?? "";
+	if (term) return normalizeTerminalName(term);
+	if (
+		process.env.COLORTERM === "truecolor" ||
+		process.env.COLORTERM === "24bit"
+	)
+		return "unknown-modern";
+	return termProgram;
+}
+
+function detectImageProtocol(): ImageProtocol {
+	const forced = (process.env.PRETTY_IMAGE_PROTOCOL ?? "").toLowerCase();
+	if (forced === "kitty" || forced === "iterm2" || forced === "none") {
+		return forced;
+	}
+
+	const term = getOuterTerminal();
+	// Ghostty and Kitty use the Kitty graphics protocol
+	if (term === "ghostty" || term === "kitty") return "kitty";
+	// iTerm2, WezTerm, Mintty support the iTerm2 protocol
+	if (["iTerm.app", "WezTerm", "mintty"].includes(term)) return "iterm2";
+	if (process.env.LC_TERMINAL === "iTerm2") return "iterm2";
+	return "none";
+}
+
+function tmuxAllowsPassthrough(): boolean | null {
+	if (_tmuxAllowPassthroughOverrideForTests !== undefined)
+		return _tmuxAllowPassthroughOverrideForTests;
+	if (!isTmuxSession()) return null;
+	if (_tmuxAllowPassthroughCache !== undefined)
+		return _tmuxAllowPassthroughCache;
+	try {
+		const value = childProcess
+			.execFileSync("tmux", ["show-options", "-gv", "allow-passthrough"], {
+				encoding: "utf8",
+				stdio: ["ignore", "pipe", "ignore"],
+				timeout: 200,
+			})
+			.trim()
+			.toLowerCase();
+		_tmuxAllowPassthroughCache = value === "on" || value === "all";
+	} catch {
+		_tmuxAllowPassthroughCache = null;
+	}
+	return _tmuxAllowPassthroughCache;
+}
+
+function getTmuxPassthroughWarning(protocol: ImageProtocol): string | null {
+	if (!isTmuxSession() || protocol === "none") return null;
+	if (tmuxAllowsPassthrough() === false) {
+		return "tmux allow-passthrough is off. Run: tmux set -g allow-passthrough on";
+	}
+	return null;
+}
+
+/**
+ * Wrap escape sequence for tmux passthrough.
+ * tmux requires: ESC Ptmux; <escaped-sequence> ESC \
+ * Inner ESC chars must be doubled.
+
+ */
+function tmuxWrap(seq: string): string {
+	if (!isTmuxSession()) return seq;
+	// Double all ESC chars inside the sequence
+	const escaped = seq.split("\x1b").join("\x1b\x1b");
+	return `\x1bPtmux;${escaped}\x1b\\`;
+}
+
+export const __imageInternals = {
+	isTmuxSession,
+	getOuterTerminal,
+	detectImageProtocol,
+	tmuxWrap,
+	tmuxAllowsPassthrough,
+	getTmuxPassthroughWarning,
+	setTmuxClientTermOverrideForTests: (value: string | null | undefined) => {
+		_tmuxClientTermOverrideForTests = value;
+	},
+	setTmuxAllowPassthroughOverrideForTests: (
+		value: boolean | null | undefined,
+	) => {
+		_tmuxAllowPassthroughOverrideForTests = value;
+	},
+	resetCachesForTests: () => {
+		_tmuxClientTermCache = undefined;
+		_tmuxAllowPassthroughCache = undefined;
+		_tmuxClientTermOverrideForTests = undefined;
+		_tmuxAllowPassthroughOverrideForTests = undefined;
+	},
+};

package/src/index.test.ts

@@ -0,0 +1,33 @@
+/**
+ * Basic smoke tests for pix-pretty extensions
+ */
+
+import { describe, it, expect } from "bun:test";
+
+describe("pix-pretty", () => {
+	it("exports are valid TypeScript modules", () => {
+		// Smoke test - just verify the files can be imported
+		expect(true).toBe(true);
+	});
+
+	describe("tool rendering extension", () => {
+		it("main extension exports a function", async () => {
+			const mainModule = await import("./index");
+			expect(mainModule.default).toBeFunction();
+		});
+	});
+
+	describe("paste-chips extension", () => {
+		it("paste-chips extension exports a function", async () => {
+			const pasteChipsModule = await import("./paste-chips");
+			expect(pasteChipsModule.default).toBeFunction();
+		});
+	});
+
+	describe("thinking extension", () => {
+		it("thinking extension exports a function", async () => {
+			const thinkingModule = await import("./thinking");
+			expect(thinkingModule.default).toBeFunction();
+		});
+	});
+});