pi-usereq 0.49.0 → 0.51.0

package/pi.dev-src/pi-mono/tui/test/virtual-terminal.ts

@@ -1,218 +0,0 @@
-import type { Terminal as XtermTerminalType } from "@xterm/headless";
-import xterm from "@xterm/headless";
-import type { Terminal } from "../src/terminal.js";
-
-// Extract Terminal class from the module
-const XtermTerminal = xterm.Terminal;
-
-/**
- * Virtual terminal for testing using xterm.js for accurate terminal emulation
- */
-export class VirtualTerminal implements Terminal {
-	private xterm: XtermTerminalType;
-	private inputHandler?: (data: string) => void;
-	private resizeHandler?: () => void;
-	private _columns: number;
-	private _rows: number;
-
-	constructor(columns = 80, rows = 24) {
-		this._columns = columns;
-		this._rows = rows;
-
-		// Create xterm instance with specified dimensions
-		this.xterm = new XtermTerminal({
-			cols: columns,
-			rows: rows,
-			// Disable all interactive features for testing
-			disableStdin: true,
-			allowProposedApi: true,
-		});
-	}
-
-	start(onInput: (data: string) => void, onResize: () => void): void {
-		this.inputHandler = onInput;
-		this.resizeHandler = onResize;
-		// Enable bracketed paste mode for consistency with ProcessTerminal
-		this.xterm.write("\x1b[?2004h");
-	}
-
-	async drainInput(_maxMs?: number, _idleMs?: number): Promise<void> {
-		// No-op for virtual terminal - no stdin to drain
-	}
-
-	stop(): void {
-		// Disable bracketed paste mode
-		this.xterm.write("\x1b[?2004l");
-		this.inputHandler = undefined;
-		this.resizeHandler = undefined;
-	}
-
-	write(data: string): void {
-		this.xterm.write(data);
-	}
-
-	get columns(): number {
-		return this._columns;
-	}
-
-	get rows(): number {
-		return this._rows;
-	}
-
-	get kittyProtocolActive(): boolean {
-		// Virtual terminal always reports Kitty protocol as active for testing
-		return true;
-	}
-
-	moveBy(lines: number): void {
-		if (lines > 0) {
-			// Move down
-			this.xterm.write(`\x1b[${lines}B`);
-		} else if (lines < 0) {
-			// Move up
-			this.xterm.write(`\x1b[${-lines}A`);
-		}
-		// lines === 0: no movement
-	}
-
-	hideCursor(): void {
-		this.xterm.write("\x1b[?25l");
-	}
-
-	showCursor(): void {
-		this.xterm.write("\x1b[?25h");
-	}
-
-	clearLine(): void {
-		this.xterm.write("\x1b[K");
-	}
-
-	clearFromCursor(): void {
-		this.xterm.write("\x1b[J");
-	}
-
-	clearScreen(): void {
-		this.xterm.write("\x1b[2J\x1b[H"); // Clear screen and move to home (1,1)
-	}
-
-	setTitle(title: string): void {
-		// OSC 0;title BEL - set terminal window title
-		this.xterm.write(`\x1b]0;${title}\x07`);
-	}
-
-	setProgress(_active: boolean): void {}
-
-	// Test-specific methods not in Terminal interface
-
-	/**
-	 * Simulate keyboard input
-	 */
-	sendInput(data: string): void {
-		if (this.inputHandler) {
-			this.inputHandler(data);
-		}
-	}
-
-	/**
-	 * Resize the terminal
-	 */
-	resize(columns: number, rows: number): void {
-		this._columns = columns;
-		this._rows = rows;
-		this.xterm.resize(columns, rows);
-		if (this.resizeHandler) {
-			this.resizeHandler();
-		}
-	}
-
-	/**
-	 * Wait for all pending writes to complete. Viewport and scroll buffer will be updated.
-	 */
-	async flush(): Promise<void> {
-		// Write an empty string to ensure all previous writes are flushed
-		return new Promise<void>((resolve) => {
-			this.xterm.write("", () => resolve());
-		});
-	}
-
-	/**
-	 * Flush and get viewport - convenience method for tests
-	 */
-	async flushAndGetViewport(): Promise<string[]> {
-		await this.flush();
-		return this.getViewport();
-	}
-
-	/**
-	 * Get the visible viewport (what's currently on screen)
-	 * Note: You should use getViewportAfterWrite() for testing after writing data
-	 */
-	getViewport(): string[] {
-		const lines: string[] = [];
-		const buffer = this.xterm.buffer.active;
-
-		// Get only the visible lines (viewport)
-		for (let i = 0; i < this.xterm.rows; i++) {
-			const line = buffer.getLine(buffer.viewportY + i);
-			if (line) {
-				lines.push(line.translateToString(true));
-			} else {
-				lines.push("");
-			}
-		}
-
-		return lines;
-	}
-
-	/**
-	 * Get the entire scroll buffer
-	 */
-	getScrollBuffer(): string[] {
-		const lines: string[] = [];
-		const buffer = this.xterm.buffer.active;
-
-		// Get all lines in the buffer (including scrollback)
-		for (let i = 0; i < buffer.length; i++) {
-			const line = buffer.getLine(i);
-			if (line) {
-				lines.push(line.translateToString(true));
-			} else {
-				lines.push("");
-			}
-		}
-
-		return lines;
-	}
-
-	/**
-	 * Clear the terminal viewport
-	 */
-	clear(): void {
-		this.xterm.clear();
-	}
-
-	/**
-	 * Reset the terminal completely
-	 */
-	reset(): void {
-		this.xterm.reset();
-	}
-
-	/**
-	 * Get cursor position
-	 */
-	getCursorPosition(): { x: number; y: number } {
-		const buffer = this.xterm.buffer.active;
-		return {
-			x: buffer.cursorX,
-			y: buffer.cursorY,
-		};
-	}
-
-	/** Wait for TUI's throttled render pipeline to settle. */
-	async waitForRender(): Promise<void> {
-		await new Promise<void>((resolve) => process.nextTick(resolve));
-		await new Promise<void>((resolve) => setTimeout(resolve, 20));
-		await this.flush();
-	}
-}

package/pi.dev-src/pi-mono/tui/test/wrap-ansi.test.ts

@@ -1,207 +0,0 @@
-import assert from "node:assert";
-import { describe, it } from "node:test";
-import { visibleWidth, wrapTextWithAnsi } from "../src/utils.js";
-
-describe("wrapTextWithAnsi", () => {
-	describe("underline styling", () => {
-		it("should not apply underline style before the styled text", () => {
-			const underlineOn = "\x1b[4m";
-			const underlineOff = "\x1b[24m";
-			const url = "https://example.com/very/long/path/that/will/wrap";
-			const text = `read this thread ${underlineOn}${url}${underlineOff}`;
-
-			const wrapped = wrapTextWithAnsi(text, 40);
-
-			// First line should NOT contain underline code - it's just "read this thread"
-			assert.strictEqual(wrapped[0], "read this thread");
-
-			// Second line should start with underline, have URL content
-			assert.strictEqual(wrapped[1].startsWith(underlineOn), true);
-			assert.ok(wrapped[1].includes("https://"));
-		});
-
-		it("should not have whitespace before underline reset code", () => {
-			const underlineOn = "\x1b[4m";
-			const underlineOff = "\x1b[24m";
-			const textWithUnderlinedTrailingSpace = `${underlineOn}underlined text here ${underlineOff}more`;
-
-			const wrapped = wrapTextWithAnsi(textWithUnderlinedTrailingSpace, 18);
-
-			assert.ok(!wrapped[0].includes(` ${underlineOff}`));
-		});
-
-		it("should not bleed underline to padding - each line should end with reset for underline only", () => {
-			const underlineOn = "\x1b[4m";
-			const underlineOff = "\x1b[24m";
-			const url = "https://example.com/very/long/path/that/will/definitely/wrap";
-			const text = `prefix ${underlineOn}${url}${underlineOff} suffix`;
-
-			const wrapped = wrapTextWithAnsi(text, 30);
-
-			// Middle lines (with underlined content) should end with underline-off, not full reset
-			// Line 1 and 2 contain underlined URL parts
-			for (let i = 1; i < wrapped.length - 1; i++) {
-				const line = wrapped[i];
-				if (line.includes(underlineOn)) {
-					// Should end with underline off, NOT full reset
-					assert.strictEqual(line.endsWith(underlineOff), true);
-					assert.strictEqual(line.endsWith("\x1b[0m"), false);
-				}
-			}
-		});
-	});
-
-	describe("background color preservation", () => {
-		it("should preserve background color across wrapped lines without full reset", () => {
-			const bgBlue = "\x1b[44m";
-			const reset = "\x1b[0m";
-			const text = `${bgBlue}hello world this is blue background text${reset}`;
-
-			const wrapped = wrapTextWithAnsi(text, 15);
-
-			// Each line should have background color
-			for (const line of wrapped) {
-				assert.ok(line.includes(bgBlue));
-			}
-
-			// Middle lines should NOT end with full reset (kills background for padding)
-			for (let i = 0; i < wrapped.length - 1; i++) {
-				assert.strictEqual(wrapped[i].endsWith("\x1b[0m"), false);
-			}
-		});
-
-		it("should reset underline but preserve background when wrapping underlined text inside background", () => {
-			const underlineOn = "\x1b[4m";
-			const underlineOff = "\x1b[24m";
-			const reset = "\x1b[0m";
-
-			const text = `\x1b[41mprefix ${underlineOn}UNDERLINED_CONTENT_THAT_WRAPS${underlineOff} suffix${reset}`;
-
-			const wrapped = wrapTextWithAnsi(text, 20);
-
-			// All lines should have background color 41 (either as \x1b[41m or combined like \x1b[4;41m)
-			for (const line of wrapped) {
-				const hasBgColor = line.includes("[41m") || line.includes(";41m") || line.includes("[41;");
-				assert.ok(hasBgColor);
-			}
-
-			// Lines with underlined content should use underline-off at end, not full reset
-			for (let i = 0; i < wrapped.length - 1; i++) {
-				const line = wrapped[i];
-				// If this line has underline on, it should end with underline off (not full reset)
-				if (
-					(line.includes("[4m") || line.includes("[4;") || line.includes(";4m")) &&
-					!line.includes(underlineOff)
-				) {
-					assert.strictEqual(line.endsWith(underlineOff), true);
-					assert.strictEqual(line.endsWith("\x1b[0m"), false);
-				}
-			}
-		});
-	});
-
-	describe("basic wrapping", () => {
-		it("should wrap plain text correctly", () => {
-			const text = "hello world this is a test";
-			const wrapped = wrapTextWithAnsi(text, 10);
-
-			assert.ok(wrapped.length > 1);
-			for (const line of wrapped) {
-				assert.ok(visibleWidth(line) <= 10);
-			}
-		});
-
-		it("should ignore OSC 133 semantic markers in visible width", () => {
-			const text = "\x1b]133;A\x07hello\x1b]133;B\x07";
-			assert.strictEqual(visibleWidth(text), 5);
-		});
-
-		it("should ignore OSC sequences terminated with ST in visible width", () => {
-			const text = "\x1b]133;A\x1b\\hello\x1b]133;B\x1b\\";
-			assert.strictEqual(visibleWidth(text), 5);
-		});
-
-		it("should treat isolated regional indicators as width 2", () => {
-			assert.strictEqual(visibleWidth("🇨"), 2);
-			assert.strictEqual(visibleWidth("🇨🇳"), 2);
-		});
-
-		it("should truncate trailing whitespace that exceeds width", () => {
-			const twoSpacesWrappedToWidth1 = wrapTextWithAnsi("  ", 1);
-			assert.ok(visibleWidth(twoSpacesWrappedToWidth1[0]) <= 1);
-		});
-
-		it("should preserve color codes across wraps", () => {
-			const red = "\x1b[31m";
-			const reset = "\x1b[0m";
-			const text = `${red}hello world this is red${reset}`;
-
-			const wrapped = wrapTextWithAnsi(text, 10);
-
-			// Each continuation line should start with red code
-			for (let i = 1; i < wrapped.length; i++) {
-				assert.strictEqual(wrapped[i].startsWith(red), true);
-			}
-
-			// Middle lines should not end with full reset
-			for (let i = 0; i < wrapped.length - 1; i++) {
-				assert.strictEqual(wrapped[i].endsWith("\x1b[0m"), false);
-			}
-		});
-	});
-});
-
-describe("wrapTextWithAnsi with OSC 8 hyperlinks", () => {
-	it("re-emits OSC 8 open at the start of continuation lines", () => {
-		// A hyperlink whose text is long enough to wrap
-		const url = "https://example.com";
-		// OSC 8 open + text that is 10 visible chars + OSC 8 close
-		const input = `\x1b]8;;${url}\x1b\\0123456789\x1b]8;;\x1b\\`;
-		const lines = wrapTextWithAnsi(input, 6);
-
-		// Every line that contains visible text from inside the hyperlink
-		// should start with the OSC 8 open sequence (or be preceded by it).
-		for (const line of lines) {
-			// If the line has visible content it must begin with the OSC 8 re-open
-			// OR it is the line where the close appeared with no following content.
-			const stripped = line.replace(/\x1b\]8;;[^\x1b\x07]*\x1b\\/g, "").replace(/\x1b\[[0-9;]*m/g, "");
-			if (stripped.trim().length > 0) {
-				assert.ok(
-					line.startsWith(`\x1b]8;;${url}\x1b\\`) || line.includes(`\x1b]8;;${url}\x1b\\`),
-					`Line "${line}" has visible text but no OSC 8 re-open`,
-				);
-			}
-		}
-	});
-
-	it("closes OSC 8 before each line break", () => {
-		const url = "https://example.com";
-		const input = `\x1b]8;;${url}\x1b\\0123456789\x1b]8;;\x1b\\`;
-		const lines = wrapTextWithAnsi(input, 6);
-
-		for (let i = 0; i < lines.length - 1; i++) {
-			const line = lines[i];
-			// Every non-final line that is inside a hyperlink should end with the close
-			if (line.includes(`\x1b]8;;${url}\x1b\\`)) {
-				assert.ok(
-					line.endsWith("\x1b]8;;\x1b\\"),
-					`Non-final line "${line}" is inside a hyperlink but does not close it`,
-				);
-			}
-		}
-	});
-
-	it("does not emit OSC 8 sequences on lines that are outside the hyperlink", () => {
-		const url = "https://example.com";
-		const input = `before \x1b]8;;${url}\x1b\\link\x1b]8;;\x1b\\ after`;
-		const lines = wrapTextWithAnsi(input, 80);
-
-		// With width 80 everything fits on one line; there should be exactly one
-		// OSC 8 open and one OSC 8 close.
-		assert.strictEqual(lines.length, 1);
-		const openCount = (lines[0].match(/\x1b\]8;;https:[^\x1b]+\x1b\\/g) ?? []).length;
-		const closeCount = (lines[0].match(/\x1b\]8;;\x1b\\/g) ?? []).length;
-		assert.strictEqual(openCount, 1);
-		assert.strictEqual(closeCount, 1);
-	});
-});

package/pi.dev-src/pi-mono/tui/vitest.config.ts

@@ -1,7 +0,0 @@
-import { defineConfig } from "vitest/config";
-
-export default defineConfig({
-	test: {
-		include: ["test/wrap-ansi.test.ts"],
-	},
-});

package/pi.dev-src/pi-mono/web-ui/example/index.html

@@ -1,13 +0,0 @@
-<!doctype html>
-<html lang="en">
-	<head>
-		<meta charset="UTF-8" />
-		<meta name="viewport" content="width=device-width, initial-scale=1.0" />
-		<title>Pi Web UI - Example</title>
-		<meta name="description" content="Example usage of @mariozechner/pi-web-ui - Reusable AI chat interface" />
-	</head>
-	<body class="bg-background">
-		<div id="app"></div>
-		<script type="module" src="/src/main.ts"></script>
-	</body>
-</html>

package/pi.dev-src/pi-mono/web-ui/example/src/app.css

@@ -1 +0,0 @@
-@import "../../dist/app.css";

package/pi.dev-src/pi-mono/web-ui/example/src/custom-messages.ts

@@ -1,99 +0,0 @@
-import { Alert } from "@mariozechner/mini-lit/dist/Alert.js";
-import type { Message } from "@mariozechner/pi-ai";
-import type { AgentMessage, MessageRenderer } from "@mariozechner/pi-web-ui";
-import { defaultConvertToLlm, registerMessageRenderer } from "@mariozechner/pi-web-ui";
-import { html } from "lit";
-
-// ============================================================================
-// 1. EXTEND AppMessage TYPE VIA DECLARATION MERGING
-// ============================================================================
-
-// Define custom message types
-export interface SystemNotificationMessage {
-	role: "system-notification";
-	message: string;
-	variant: "default" | "destructive";
-	timestamp: string;
-}
-
-// Extend CustomAgentMessages interface via declaration merging
-// This must target pi-agent-core where CustomAgentMessages is defined
-declare module "@mariozechner/pi-agent-core" {
-	interface CustomAgentMessages {
-		"system-notification": SystemNotificationMessage;
-	}
-}
-
-// ============================================================================
-// 2. CREATE CUSTOM RENDERER (TYPED TO SystemNotificationMessage)
-// ============================================================================
-
-const systemNotificationRenderer: MessageRenderer<SystemNotificationMessage> = {
-	render: (notification) => {
-		// notification is fully typed as SystemNotificationMessage!
-		return html`
-			<div class="px-4">
-				${Alert({
-					variant: notification.variant,
-					children: html`
-						<div class="flex flex-col gap-1">
-							<div>${notification.message}</div>
-							<div class="text-xs opacity-70">${new Date(notification.timestamp).toLocaleTimeString()}</div>
-						</div>
-					`,
-				})}
-			</div>
-		`;
-	},
-};
-
-// ============================================================================
-// 3. REGISTER RENDERER
-// ============================================================================
-
-export function registerCustomMessageRenderers() {
-	registerMessageRenderer("system-notification", systemNotificationRenderer);
-}
-
-// ============================================================================
-// 4. HELPER TO CREATE CUSTOM MESSAGES
-// ============================================================================
-
-export function createSystemNotification(
-	message: string,
-	variant: "default" | "destructive" = "default",
-): SystemNotificationMessage {
-	return {
-		role: "system-notification",
-		message,
-		variant,
-		timestamp: new Date().toISOString(),
-	};
-}
-
-// ============================================================================
-// 5. CUSTOM MESSAGE TRANSFORMER
-// ============================================================================
-
-/**
- * Custom message transformer that extends defaultConvertToLlm.
- * Handles system-notification messages by converting them to user messages.
- */
-export function customConvertToLlm(messages: AgentMessage[]): Message[] {
-	// First, handle our custom system-notification type
-	const processed = messages.map((m): AgentMessage => {
-		if (m.role === "system-notification") {
-			const notification = m as SystemNotificationMessage;
-			// Convert to user message with <system> tags
-			return {
-				role: "user",
-				content: `<system>${notification.message}</system>`,
-				timestamp: Date.now(),
-			};
-		}
-		return m;
-	});
-
-	// Then use defaultConvertToLlm for standard handling
-	return defaultConvertToLlm(processed);
-}