@xynogen/pix-pretty 1.14.0 → 1.16.0

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@xynogen/pix-pretty",
-	"version": "1.14.0",
+	"version": "1.16.0",
 	"description": "Enhanced tool output rendering with syntax highlighting, file icons, tree views, diff rendering, and FFF search",
 	"type": "module",
 	"main": "src/index.ts",
@@ -60,7 +60,7 @@
 	},
 	"dependencies": {
 		"@xynogen/pix-data": "^0.4.3",
-		"@xynogen/pix-runtime": "^0.5.3",
+		"@xynogen/pix-runtime": "^0.6.0",
 		"chalk": "^4.1.2",
 		"cli-highlight": "^2.1.11",
 		"@ff-labs/fff-node": "^0.5.2",

package/src/icon-catalog.test.ts

@@ -31,6 +31,12 @@ describe("icon-catalog", () => {
 		expect(getIconMode()).toBe("nerd"); // unchanged
 	});
 
+	it("provides AFK keyboard fallbacks for every icon mode", () => {
+		expect(iconFor("afk", "nerd")).toBe("\u{F0310}");
+		expect(iconFor("afk", "unicode")).toBe("\u2328\uFE0E");
+		expect(iconFor("afk", "ascii")).toBe("kbd");
+	});
+
 	it("every catalog key has a non-empty glyph in every mode", () => {
 		for (const mode of ICON_MODES) {
 			for (const key of ICON_KEYS) {

package/src/icon-catalog.ts

@@ -44,6 +44,7 @@ const CATALOG = {
 	mcp: { nerd: "\u{F048D}", unicode: `\u25D0${VS}`, ascii: "MCP" },
 	cwd: { nerd: "\u{F024B}", unicode: `\u2302${VS}`, ascii: "~" },
 	folder: { nerd: "\u{F024B}", unicode: `\u2302${VS}`, ascii: "/" },
+	afk: { nerd: "\u{F0310}", unicode: `\u2328${VS}`, ascii: "kbd" },
 
 	// ── footer indicators (git status, score) ─────────────────────────────
 	"git.unstaged": { nerd: "\u2717", unicode: "\u2717", ascii: "x" },

package/src/types.ts

@@ -42,9 +42,11 @@ export type ToolContent = TextContent | ImageContent;
 
 export type ToolResultLike<TDetails = unknown> = AgentToolResult<TDetails | undefined>;
 
-type TextComponentLike = {
+export type TextComponentLike = {
 	setText(value: string): void;
 	getText?: () => string;
+	render?: (width: number) => string[];
+	invalidate?: () => void;
 };
 
 export type TextComponentCtor = new (text?: string, x?: number, y?: number) => TextComponentLike;

package/src/utils.test.ts

@@ -4,6 +4,7 @@ import { MAX_PREVIEW_LINES } from "./config.js";
 import type { FgTheme } from "./types.js";
 import {
 	dotJoin,
+	fillToolBackground,
 	formatCollapsedToolRow,
 	formatJson,
 	hideCollapsedToolCall,
@@ -13,8 +14,33 @@ import {
 	renderDimPreview,
 	ruleFrame,
 	setResultDetails,
+	viewportText,
 } from "./utils.js";
 
+class MockTextComponent {
+	private text = "";
+
+	setText(value: string): void {
+		this.text = value;
+	}
+
+	render(): string[] {
+		return this.text.split("\n");
+	}
+
+	invalidate(): void {}
+}
+
+describe("viewportText", () => {
+	it("trims a pre-filled row to Pi's narrower fullscreen viewport", () => {
+		const text = viewportText(MockTextComponent);
+		text.setText(fillToolBackground("tool", "", 10));
+
+		expect(plain(text.render(9)[0]!)).toBe("tool".padEnd(9));
+		expect(plain(text.render(10)[0]!)).toBe("tool".padEnd(10));
+	});
+});
+
 // Strip ANSI escapes so assertions test content, not color codes.
 const ANSI = /\x1b\[[0-9;]*m/g;
 function plain(text: string): string {

package/src/utils.ts

@@ -14,6 +14,8 @@ import {
 import { MAX_PREVIEW_LINES } from "./config.js";
 import type {
 	FgTheme,
+	TextComponentCtor,
+	TextComponentLike,
 	ToolContent,
 	ToolImageContent,
 	ToolResultLike,
@@ -48,6 +50,53 @@ export function fillToolBackground(text: string, bg = BG_BASE, width?: number):
 		.join("\n");
 }
 
+export function viewportTextConstructor(TextComponent: TextComponentCtor): TextComponentCtor {
+	return function ViewportTextComponent(text = "") {
+		const component = viewportText(TextComponent);
+		component.setText(text);
+		return component;
+	} as unknown as TextComponentCtor;
+}
+
+export function viewportText(
+	TextComponent: TextComponentCtor,
+): TextComponentLike & ViewportComponent {
+	return new ViewportText(new TextComponent("", 0, 0));
+}
+
+type ViewportComponent = {
+	render(width: number): string[];
+	invalidate(): void;
+};
+
+class ViewportText implements TextComponentLike, ViewportComponent {
+	private text = "";
+
+	constructor(private readonly component: TextComponentLike) {}
+
+	setText(value: string): void {
+		this.text = value;
+		this.component.setText(value);
+	}
+
+	getText(): string {
+		return this.text;
+	}
+
+	render(width: number): string[] {
+		const fitted = this.text
+			.split("\n")
+			.map((line) => truncateToWidth(line, width, ""))
+			.join("\n");
+		this.component.setText(fitted);
+		return this.component.render?.(width) ?? fitted.split("\n");
+	}
+
+	invalidate(): void {
+		this.component.invalidate?.();
+	}
+}
+
 export function pluralize(count: number, noun: string, plural?: string): string {
 	return `${count} ${count === 1 ? noun : (plural ?? `${noun}s`)}`;
 }