@linxiraos/pi-tui 1.0.9 → 1.1.0

package/src/components/composer/claude.ts

@@ -0,0 +1,39 @@
+/**
+ * Claude Code-like composer: full-width horizontal rules above and below a
+ * borderless `❯ ` prompt. The right status group rides the top rule as a
+ * bg chip near the right edge (`─────── hi ─`); the left group renders as a
+ * plain standalone bottom bar that yields its row to the autocomplete menu.
+ */
+
+import { renderTopRule } from "./rule";
+import type { ComposerChromeContext, ComposerRowContext, ComposerStyle } from "./types";
+
+export const claudeComposerStyle: ComposerStyle = {
+	id: "claude",
+	sideBorders: false,
+	verticalChrome: 2,
+	statusAttachment: "top-rule-chip",
+	bottomBar: "left",
+	bottomBarGap: false,
+	defaultPromptGutter: "❯ ",
+
+	defaultPaddingX(): number {
+		return 0;
+	},
+
+	sideChromeWidth(paddingX: number): number {
+		return paddingX;
+	},
+
+	renderTop(ctx: ComposerChromeContext): string {
+		return renderTopRule(ctx);
+	},
+
+	renderRow(ctx: ComposerRowContext): string[] {
+		return [ctx.gutter + ctx.text + ctx.pad];
+	},
+
+	renderBottom(ctx: ComposerChromeContext): string {
+		return ctx.borderColor(ctx.box.horizontal.repeat(ctx.width));
+	},
+};

package/src/components/composer/field.ts

@@ -0,0 +1,47 @@
+/**
+ * Compact filled composer: every input row is a one-line field with accent end
+ * caps and a subtle surface fill. The complete status line remains below it.
+ */
+import { padding } from "../../utils";
+import type { ComposerRowContext, ComposerStyle } from "./types";
+
+const LEFT_CAP = "▐";
+const RIGHT_CAP = "▌";
+
+/** One-row filled field with accent caps. */
+export const fieldComposerStyle: ComposerStyle = {
+	id: "field",
+	sideBorders: true,
+	verticalChrome: 0,
+	statusAttachment: "none",
+	bottomBar: "full",
+	bottomBarGap: true,
+	defaultPromptGutter: undefined,
+
+	defaultPaddingX(): number {
+		return 1;
+	},
+
+	sideChromeWidth(paddingX: number): number {
+		return paddingX + 1;
+	},
+
+	renderTop(): undefined {
+		return undefined;
+	},
+
+	renderRow(ctx: ComposerRowContext): string[] {
+		const left = ctx.accentColor(LEFT_CAP);
+		const leftFill = padding(ctx.paddingX) + ctx.gutter + ctx.text;
+		if (ctx.imeSafeCursorTail) return [left + ctx.surfaceColor(leftFill)];
+
+		const rightChromeCells = Math.max(1, ctx.paddingX + 1 - ctx.cursorOverflow);
+		const interior = leftFill + ctx.pad + padding(rightChromeCells - 1);
+		const rightGlyph = ctx.scrollbarThumb ? "█" : RIGHT_CAP;
+		return [left + ctx.surfaceColor(interior) + ctx.accentColor(rightGlyph)];
+	},
+
+	renderBottom(): undefined {
+		return undefined;
+	},
+};

package/src/components/composer/index.ts

@@ -0,0 +1,9 @@
+export * from "./borderless";
+export * from "./box";
+export * from "./claude";
+export * from "./field";
+export * from "./pi";
+export * from "./rail";
+export * from "./registry";
+export * from "./rule";
+export * from "./types";

package/src/components/composer/pi.ts

@@ -0,0 +1,37 @@
+/**
+ * Upstream-pi composer: full-width horizontal rules above and below plain
+ * padded text — no side borders, no prompt gutter. The status bar renders as
+ * a plain standalone bottom bar with both segment groups.
+ */
+import { padding } from "../../utils";
+import type { ComposerChromeContext, ComposerRowContext, ComposerStyle } from "./types";
+
+export const piComposerStyle: ComposerStyle = {
+	id: "pi",
+	sideBorders: false,
+	verticalChrome: 2,
+	statusAttachment: "none",
+	bottomBar: "full",
+	bottomBarGap: false,
+	defaultPromptGutter: undefined,
+
+	defaultPaddingX(): number {
+		return 1;
+	},
+
+	sideChromeWidth(paddingX: number): number {
+		return paddingX;
+	},
+
+	renderTop(ctx: ComposerChromeContext): string {
+		return ctx.borderColor(ctx.box.horizontal.repeat(ctx.width));
+	},
+
+	renderRow(ctx: ComposerRowContext): string[] {
+		return [padding(this.sideChromeWidth(ctx.paddingX)) + ctx.gutter + ctx.text + ctx.pad];
+	},
+
+	renderBottom(ctx: ComposerChromeContext): string {
+		return ctx.borderColor(ctx.box.horizontal.repeat(ctx.width));
+	},
+};

package/src/components/composer/rail.ts

@@ -0,0 +1,48 @@
+/**
+ * Filled composer with one strong accent rail on the left. The asymmetric
+ * silhouette separates input from transcript without enclosing it in a box.
+ */
+import { padding } from "../../utils";
+import type { ComposerRowContext, ComposerStyle } from "./types";
+
+const ACCENT_RAIL = "▎";
+
+/** Filled composer surface anchored by a single left accent rail. */
+export const railComposerStyle: ComposerStyle = {
+	id: "rail",
+	sideBorders: true,
+	verticalChrome: 0,
+	statusAttachment: "none",
+	bottomBar: "full",
+	bottomBarGap: true,
+	defaultPromptGutter: undefined,
+
+	defaultPaddingX(): number {
+		return 1;
+	},
+
+	sideChromeWidth(paddingX: number): number {
+		return paddingX + 1;
+	},
+
+	renderTop(): undefined {
+		return undefined;
+	},
+
+	renderRow(ctx: ComposerRowContext): string[] {
+		const rail = ctx.accentColor(ACCENT_RAIL);
+		const leftFill = padding(ctx.paddingX) + ctx.gutter + ctx.text;
+		if (ctx.imeSafeCursorTail) return [rail + ctx.surfaceColor(leftFill)];
+
+		const rightFillCells = Math.max(0, ctx.paddingX + 1 - ctx.cursorOverflow);
+		if (ctx.scrollbarThumb && rightFillCells > 0) {
+			const interior = leftFill + ctx.pad + padding(rightFillCells - 1);
+			return [rail + ctx.surfaceColor(interior) + ctx.accentColor("█")];
+		}
+		return [rail + ctx.surfaceColor(leftFill + ctx.pad + padding(rightFillCells))];
+	},
+
+	renderBottom(): undefined {
+		return undefined;
+	},
+};

package/src/components/composer/registry.ts

@@ -0,0 +1,46 @@
+import { borderlessComposerStyle } from "./borderless";
+import { boxComposerStyle } from "./box";
+import { claudeComposerStyle } from "./claude";
+import { fieldComposerStyle } from "./field";
+import { piComposerStyle } from "./pi";
+import { railComposerStyle } from "./rail";
+import { ruleComposerStyle } from "./rule";
+import type { ComposerStyle, EditorBorderStyle } from "./types";
+
+const BUILTIN_COMPOSER_STYLES: Readonly<Record<string, ComposerStyle>> = {
+	box: boxComposerStyle,
+	claude: claudeComposerStyle,
+	pi: piComposerStyle,
+	borderless: borderlessComposerStyle,
+	rule: ruleComposerStyle,
+	field: fieldComposerStyle,
+	rail: railComposerStyle,
+};
+const extensionComposerStyles = new Map<string, ComposerStyle>();
+
+/** Whether an id names a composer style shipped by pi-tui. */
+export function isBuiltinComposerStyle(id: string): boolean {
+	return Object.hasOwn(BUILTIN_COMPOSER_STYLES, id);
+}
+
+/**
+ * Register one extension-owned composer style for this process.
+ *
+ * Built-in ids and duplicate extension ids are rejected. The returned disposer
+ * removes only this registration.
+ */
+export function registerComposerStyle(style: ComposerStyle): () => void {
+	const id = style.id.trim();
+	if (id.length === 0 || id !== style.id) throw new TypeError("Composer style id must be a non-empty trimmed string");
+	if (isBuiltinComposerStyle(id)) throw new Error(`Cannot replace built-in composer style "${id}"`);
+	if (extensionComposerStyles.has(id)) throw new Error(`Composer style "${id}" is already registered`);
+	extensionComposerStyles.set(id, style);
+	return () => {
+		if (extensionComposerStyles.get(id) === style) extensionComposerStyles.delete(id);
+	};
+}
+
+/** Style object for a composer shape; unknown ids fall back to `box`. */
+export function getComposerStyle(id: EditorBorderStyle): ComposerStyle {
+	return extensionComposerStyles.get(id) ?? BUILTIN_COMPOSER_STYLES[id] ?? boxComposerStyle;
+}

package/src/components/composer/rule.ts

@@ -0,0 +1,55 @@
+/**
+ * Single-rule composer: a borderless prompt docked below one top rule. The
+ * right status group rides the rule while the left group remains below the
+ * editor, preserving the compact status split without a closing rule.
+ */
+import { truncateToWidth, visibleWidth } from "../../utils";
+import type { ComposerChromeContext, ComposerRowContext, ComposerStyle } from "./types";
+
+/** Draw a full-width rule with status content docked at its right edge.
+ * Over-wide content is truncated (keeping one rule cell on each side) rather
+ * than dropped, so the chip survives narrow terminals and previews. */
+export function renderTopRule(ctx: ComposerChromeContext): string {
+	const { box, width, borderColor, topBorder } = ctx;
+	if (topBorder && topBorder.width > 0 && width > 2) {
+		let { content, width: chipWidth } = topBorder;
+		if (chipWidth > width - 2) {
+			content = truncateToWidth(content, width - 2);
+			chipWidth = visibleWidth(content);
+		}
+		const leftFill = Math.max(0, width - chipWidth - 1);
+		return borderColor(box.horizontal.repeat(leftFill)) + content + borderColor(box.horizontal);
+	}
+	return borderColor(box.horizontal.repeat(width));
+}
+
+/** Composer style with one status-bearing top rule and no bottom chrome. */
+export const ruleComposerStyle: ComposerStyle = {
+	id: "rule",
+	sideBorders: false,
+	verticalChrome: 1,
+	statusAttachment: "top-rule-chip",
+	bottomBar: "left",
+	bottomBarGap: true,
+	defaultPromptGutter: "❯ ",
+
+	defaultPaddingX(): number {
+		return 0;
+	},
+
+	sideChromeWidth(paddingX: number): number {
+		return paddingX;
+	},
+
+	renderTop(ctx: ComposerChromeContext): string {
+		return renderTopRule(ctx);
+	},
+
+	renderRow(ctx: ComposerRowContext): string[] {
+		return [ctx.gutter + ctx.text + ctx.pad];
+	},
+
+	renderBottom(): undefined {
+		return undefined;
+	},
+};

package/src/components/composer/types.ts

@@ -0,0 +1,98 @@
+/**
+ * Composer chrome contract. A {@link ComposerStyle} owns everything about how
+ * the input editor's frame looks — top/bottom chrome, per-row side chrome,
+ * default padding and prompt gutter — plus metadata telling the host where the
+ * status bar attaches. The editor, the /settings preview, and the setup-wizard
+ * preview all render through the same style object, so the three surfaces can
+ * never drift apart.
+ */
+import type { SymbolTheme } from "../../symbols";
+
+/** Box-drawing glyph set used for composer chrome (the theme's `boxRound`). */
+export type ComposerBox = SymbolTheme["boxRound"];
+
+/** Built-in composer shape identifiers shipped by pi-tui. */
+export const BUILTIN_EDITOR_BORDER_STYLES = ["box", "claude", "pi", "borderless", "rule", "field", "rail"] as const;
+
+/** Identifier for a built-in composer shape. */
+export type BuiltinEditorBorderStyle = (typeof BUILTIN_EDITOR_BORDER_STYLES)[number];
+
+/** Composer shape identifier; extensions may register additional strings. */
+export type EditorBorderStyle = string;
+
+/** Pre-rendered status content injected into the top chrome. */
+export interface EditorTopBorder {
+	/** The status content (already styled) */
+	content: string;
+	/** Visible width of the content */
+	width: number;
+	/** Optional logical revision that changes independently of available width. */
+	revision?: number;
+}
+
+/** Inputs shared by every chrome row. */
+export interface ComposerChromeContext {
+	/** Full terminal width available to the composer. */
+	width: number;
+	/** Horizontal padding inside the side chrome. */
+	paddingX: number;
+	borderColor: (str: string) => string;
+	/** Stable accent used by shape-defining chrome such as field caps and rails. */
+	accentColor: (str: string) => string;
+	/** Background fill for composer surfaces; preserves the fill across nested SGR resets. */
+	surfaceColor: (str: string) => string;
+	/** Box-drawing glyph set (theme's `boxRound`). */
+	box: ComposerBox;
+	/** Status content for the top chrome; box embeds it after the corner while
+	 * rule-based styles dock it against the right edge. */
+	topBorder?: EditorTopBorder;
+}
+
+/** Inputs for one content row. */
+export interface ComposerRowContext extends ComposerChromeContext {
+	/** Fully decorated row text (cursor glyph / IME marker included). */
+	text: string;
+	/** Spaces padding the text out to the content width. */
+	pad: string;
+	/** Prompt gutter cells for this row ("" when the style has none). */
+	gutter: string;
+	isLastRow: boolean;
+	/** Cells the end-of-line cursor overflowed into the right chrome (box). */
+	cursorOverflow: number;
+	/** Emit an empty right chrome after the cursor so terminal-local IME
+	 *  preedit cannot shift the frame (box last row). */
+	imeSafeCursorTail: boolean;
+	/** Row lies inside the right-border scrollbar thumb (box). */
+	scrollbarThumb: boolean;
+}
+
+export interface ComposerStyle {
+	readonly id: EditorBorderStyle;
+	/** Content rows carry left/right border glyphs; drives the cursor-reserve
+	 *  column, IME-safe layout, and the right-border scrollbar. */
+	readonly sideBorders: boolean;
+	/** Rows consumed by top+bottom chrome (drives maxHeight budgeting). */
+	readonly verticalChrome: 0 | 1 | 2;
+	/** Where the host should attach the status bar: embedded in the top border,
+	 * docked onto a top rule, or detached into a standalone bottom bar. */
+	readonly statusAttachment: "top-border" | "top-rule-chip" | "none";
+	/** Which segment groups the standalone bottom status bar shows. */
+	readonly bottomBar: "none" | "left" | "full";
+	/** Insert a blank spacer row between the editor and the standalone bottom
+	 * bar. Styles without bottom chrome need it so the bar doesn't sit flush
+	 * against the last input row. */
+	readonly bottomBarGap: boolean;
+	/** Default prompt gutter when the host sets none. */
+	readonly defaultPromptGutter: string | undefined;
+	/** Default horizontal padding; `themePaddingX` is the theme's request. */
+	defaultPaddingX(themePaddingX: number | undefined): number;
+	/** Cells consumed per side on content rows (border glyph + padding). */
+	sideChromeWidth(paddingX: number): number;
+	/** Top chrome row; `undefined` renders none. */
+	renderTop(ctx: ComposerChromeContext): string | undefined;
+	/** Chrome-wrapped content row; box's IME-safe last row emits two rows. */
+	renderRow(ctx: ComposerRowContext): string[];
+	/** Bottom chrome row; `undefined` renders none (box merges the bottom
+	 *  border into its last content row). */
+	renderBottom(ctx: ComposerChromeContext): string | undefined;
+}