@luan.sh/pi-libtui 0.3.8

package/src/host/transcript-bridge.ts

@@ -0,0 +1,236 @@
+import { AssistantMessageComponent } from "@earendil-works/pi-coding-agent";
+import { type Component, type TUI, stripTerminalSequences } from "@earendil-works/pi-tui";
+import { sanitizeTuiFieldPreview } from "../content/terminal-text.ts";
+
+export type TranscriptEntry =
+	| { kind: "content"; key: object; component: Component }
+	| { kind: "thinking"; key: object; component: Component; summary: string; running: boolean; failed: boolean }
+	| { kind: "tool"; key: object; component: Component; summary: string; running: boolean; failed: boolean };
+
+export interface TranscriptProjection extends Component {
+	dispose(): void;
+}
+
+type AssistantMessage = Parameters<AssistantMessageComponent["updateContent"]>[0];
+type AssistantOptions = ConstructorParameters<typeof AssistantMessageComponent>;
+interface NativeAssistant extends Component {
+	contentContainer: NativeContainer;
+	lastMessage: AssistantMessage;
+	isStreaming: boolean;
+	markdownTheme: AssistantOptions[2];
+	outputPad: number;
+	markdownTransformers: NonNullable<AssistantOptions[5]>;
+	updateContent: AssistantMessageComponent["updateContent"];
+}
+interface NativeTool extends Component {
+	toolCallId: string;
+	toolName: string;
+	args: object;
+	isPartial: boolean;
+	executionStarted: boolean;
+	result?: { isError: boolean };
+	resultRendererComponent?: Component;
+}
+interface NativeContainer extends Component {
+	children: Component[];
+}
+
+// type-boundary: Pi 0.84–0.85 private transcript fields; the shape guards below narrow each native node before projection.
+type NativeValue = unknown;
+const INSTALLATION = Symbol.for("pi-libtui/transcript-projection/v1");
+
+function record(value: NativeValue): value is Record<string, NativeValue> {
+	return value !== null && typeof value === "object";
+}
+function component(value: NativeValue): value is Component {
+	return record(value) && typeof value.render === "function" && typeof value.invalidate === "function";
+}
+function container(value: NativeValue): value is NativeContainer {
+	return component(value) && "children" in value && Array.isArray(value.children) && value.children.every(component);
+}
+function assistant(value: Component): value is NativeAssistant {
+	const node: NativeValue = value;
+	if (!record(node) || typeof node.updateContent !== "function" || !record(node.lastMessage)) return false;
+	const message = node.lastMessage;
+	return (
+		message.role === "assistant" &&
+		Array.isArray(message.content) &&
+		message.content.every(
+			(part: NativeValue) =>
+				record(part) &&
+				((part.type === "text" && typeof part.text === "string") ||
+					(part.type === "thinking" && typeof part.thinking === "string") ||
+					(part.type === "toolCall" && typeof part.name === "string")),
+		) &&
+		container(node.contentContainer) &&
+		typeof node.isStreaming === "boolean" &&
+		typeof node.outputPad === "number" &&
+		record(node.markdownTheme) &&
+		Array.isArray(node.markdownTransformers)
+	);
+}
+function tool(value: Component): value is NativeTool {
+	const node: NativeValue = value;
+	return (
+		record(node) &&
+		typeof node.toolCallId === "string" &&
+		typeof node.toolName === "string" &&
+		record(node.args) &&
+		typeof node.isPartial === "boolean" &&
+		typeof node.executionStarted === "boolean" &&
+		(node.result === undefined || (record(node.result) && typeof node.result.isError === "boolean")) &&
+		(node.resultRendererComponent === undefined || component(node.resultRendererComponent))
+	);
+}
+
+/** Read the latest nested semantic action without rendering its output. */
+function activityLabel(node: Component, visited = new Set<Component>()): string | undefined {
+	if (visited.has(node)) return undefined;
+	visited.add(node);
+	const getter: NativeValue = Reflect.get(node, "getActivityLabel");
+	if (typeof getter === "function") {
+		try {
+			const label: NativeValue = Reflect.apply(getter, node, []);
+			if (typeof label === "string" && label.trim()) return label;
+		} catch {
+			// A feature's optional summary must not break the enclosing transcript.
+		}
+	}
+	if (container(node)) {
+		for (let index = node.children.length - 1; index >= 0; index--) {
+			const label = activityLabel(node.children[index]!, visited);
+			if (label) return label;
+		}
+	}
+	return undefined;
+}
+
+function toolLabel(node: NativeTool): string {
+	const rendered = node.resultRendererComponent && activityLabel(node.resultRendererComponent);
+	if (rendered) return sanitizeTuiFieldPreview(stripTerminalSequences(rendered), 240);
+	for (const key of ["cmd", "command", "path", "query", "pattern"]) {
+		const value: NativeValue = Reflect.get(node.args, key);
+		if (typeof value === "string" && value.trim()) return sanitizeTuiFieldPreview(`${node.toolName}: ${value}`, 240);
+	}
+	return node.toolName;
+}
+
+class NativeEntries {
+	private readonly assistants = new WeakMap<
+		Component,
+		{
+			children: Component[];
+			streaming: boolean;
+			entries: TranscriptEntry[];
+		}
+	>();
+	private readonly tools = new WeakMap<
+		Component,
+		{
+			result: NativeTool["result"];
+			args: object;
+			partial: boolean;
+			entry: TranscriptEntry;
+		}
+	>();
+
+	read(node: Component): readonly TranscriptEntry[] {
+		if (assistant(node)) return this.readAssistant(node);
+		if (!tool(node)) return [{ kind: "content", key: node, component: node }];
+		const previous = this.tools.get(node);
+		if (
+			previous &&
+			previous.result === node.result &&
+			previous.args === node.args &&
+			previous.partial === node.isPartial
+		)
+			return [previous.entry];
+		const entry: TranscriptEntry = {
+			kind: "tool",
+			key: node,
+			component: node,
+			summary: toolLabel(node),
+			running: !node.result || node.isPartial,
+			failed: node.result?.isError ?? false,
+		};
+		this.tools.set(node, { result: node.result, args: node.args, partial: node.isPartial, entry });
+		return [entry];
+	}
+
+	private readAssistant(node: NativeAssistant): readonly TranscriptEntry[] {
+		const message = node.lastMessage;
+		// Keep native error/truncation notices visible, rather than hiding them in a thought fold.
+		if (["error", "aborted", "length"].includes(message.stopReason))
+			return [{ kind: "content", key: node, component: node }];
+		const previous = this.assistants.get(node);
+		if (previous?.children === node.contentContainer.children && previous.streaming === node.isStreaming)
+			return previous.entries;
+		const entries: TranscriptEntry[] = [];
+		for (const [index, part] of message.content.entries()) {
+			if (part.type === "toolCall") continue;
+			const text = part.type === "thinking" ? part.thinking : part.text;
+			if (!text.trim()) continue;
+			const old = previous?.entries[entries.length];
+			const view =
+				old?.component instanceof AssistantMessageComponent
+					? old.component
+					: new AssistantMessageComponent(
+							undefined,
+							false,
+							node.markdownTheme,
+							undefined,
+							node.outputPad,
+							node.markdownTransformers,
+						);
+			view.updateContent({ ...message, content: [part], stopReason: "toolUse" }, node.isStreaming);
+			entries.push(
+				part.type === "thinking"
+					? {
+							kind: "thinking",
+							key: view,
+							component: view,
+							summary: text,
+							running: node.isStreaming && index === message.content.length - 1,
+							failed: false,
+						}
+					: { kind: "content", key: view, component: view },
+			);
+		}
+		this.assistants.set(node, { children: node.contentContainer.children, streaming: node.isStreaming, entries });
+		return entries;
+	}
+}
+
+/**
+ * Project Pi's chat container without changing messages or its mutation targets.
+ * Pi 0.84–0.85 mounts [header, resources, chat] as the first document child in
+ * both modes. Fail open on another shape; replace this bridge when Pi exposes a transcript API.
+ */
+export function mountTranscriptProjection(
+	tui: TUI,
+	create: (entries: () => readonly TranscriptEntry[]) => TranscriptProjection,
+): (() => void) | undefined {
+	const roots: NativeValue = Reflect.get(tui, "children");
+	if (!Array.isArray(roots)) return undefined;
+	const document: NativeValue = roots[0];
+	if (!container(document) || document.children.length !== 3 || !document.children.every(container)) return undefined;
+	if (Reflect.get(document, INSTALLATION)) return undefined;
+	const source = document.children[2]!;
+	if (!container(source)) return undefined;
+	const reader = new NativeEntries();
+	const projection = create(() =>
+		source.children.flatMap((child): readonly TranscriptEntry[] =>
+			tui.mode === "fullscreen" ? reader.read(child) : [{ kind: "content", key: child, component: child }],
+		),
+	);
+	const children: Component[] = document.children;
+	children[2] = projection;
+	Reflect.set(document, INSTALLATION, projection);
+	tui.requestRender();
+	return () => {
+		if (document.children[2] === projection) document.children[2] = source;
+		if (Reflect.get(document, INSTALLATION) === projection) Reflect.deleteProperty(document, INSTALLATION);
+		projection.dispose();
+		tui.requestRender();
+	};
+}

package/src/index.ts

@@ -0,0 +1,334 @@
+export {
+	type ActivityPresentationOptions,
+	activityPresentationCadenceMs,
+	activityPresentationFrame,
+} from "./activity-presentation.ts";
+export {
+	configureTuiAppearance,
+	DEFAULT_TUI_APPEARANCE,
+	getTuiAppearance,
+	isTuiActivityIndicatorStyle,
+	isTuiActivityMessageStyle,
+	isTuiAnimationSmoothness,
+	isTuiAnimationSpeed,
+	isTuiPulseEffectStyle,
+	isTuiStatusPresentationStyle,
+	isTuiTextEffectScope,
+	isTuiTextEffectStyle,
+	requestPhaseAnimation,
+	resolveActivityPresentation,
+	subscribeTuiAppearance,
+	TUI_ACTIVITY_INDICATOR_OPTIONS,
+	TUI_STATUS_PRESENTATION_OPTIONS,
+	type TuiActivityIndicatorStyle,
+	type TuiActivityMessageStyle,
+	type TuiActivityPresentation,
+	type TuiAnimationOverride,
+	type TuiAnimationSmoothness,
+	type TuiAnimationSpeed,
+	type TuiAppearanceSettings,
+	type TuiCursorStyle,
+	type TuiIconPack,
+	type TuiPulseEffectStyle,
+	type TuiRequestPhase,
+	type TuiStatusPresentationStyle,
+	type TuiTextEffectScope,
+	type TuiTextEffectStyle,
+} from "./appearance.ts";
+export {
+	BackgroundSurface,
+	type BackgroundSurfaceOptions,
+	type HalfBlockSurfaceEdge,
+	halfBlockSurfaceEdge,
+	TOOL_SURFACE_BACKGROUND,
+} from "./background-surface.ts";
+export {
+	createTuiThemeVariation,
+	type TuiBackgroundPaint,
+	type TuiBackgroundToken,
+	type TuiColor,
+	type TuiForegroundColor,
+	type TuiForegroundPaint,
+	type TuiForegroundToken,
+	type TuiHue,
+	type TuiShade,
+	type TuiSwatch,
+	type TuiTheme,
+	type TuiThemeAppearance,
+	type TuiThemeVariation,
+	tuiTheme,
+	tuiThemeAppearance,
+} from "./color/theme.ts";
+export {
+	ComponentStack,
+	type ComponentStackInputMode,
+	type ComponentStackOptions,
+	type ComponentStackSpan,
+} from "./component-stack.ts";
+export {
+	sanitizeTuiField,
+	sanitizeTuiFieldPreview,
+	sanitizeTuiText,
+	sanitizeTuiTextPreview,
+} from "./content/terminal-text.ts";
+export { markdownCodeRanges, type TextRange } from "./content/markdown-code.ts";
+export {
+	MarkdownText,
+	type MarkdownTextOptions,
+	semanticMarkdownTheme,
+} from "./content/text.ts";
+export {
+	ActionPanel,
+	type ActionPanelFooter,
+	type ActionPanelGeometry,
+	type ActionPanelMouseEvent,
+	type ActionPanelOption,
+	type ActionPanelOptions,
+	type ActionPanelRect,
+	type ActionPanelRowContext,
+	type ActionPanelRowGeometry,
+} from "./controls/action-panel.ts";
+export {
+	DialogButtonBar,
+	type DialogButtonBarGeometry,
+	type DialogButtonBarOptions,
+	type DialogButtonGeometry,
+	type DialogButtonSpec,
+} from "./controls/dialog-button-bar.ts";
+export { MultiSelect, type MultiSelectOptions } from "./controls/multi-select.ts";
+export {
+	type PickerOption,
+	PickerPanel,
+	type PickerPanelHost,
+	type PickerPanelOptions,
+	type PickerRowContext,
+} from "./controls/picker-panel.ts";
+export {
+	mountScreenIconActions,
+	type ScreenIconAction,
+	type ScreenIconActionsMount,
+	type ScreenIconActionsOptions,
+	screenIconActionsWidth,
+} from "./controls/screen-icon-actions.ts";
+export {
+	SearchableSelect,
+	type SearchableSelectOptions,
+	type SearchableSelectRowContext,
+	type SelectOption,
+} from "./controls/searchable-select.ts";
+export {
+	SelectBox,
+	type SelectBoxOptions,
+	type SelectBoxRowContext,
+} from "./controls/select-box.ts";
+export {
+	SelectableList,
+	type SelectableListGeometry,
+	type SelectableListItemGeometry,
+	type SelectableListOptions,
+	type SelectableListRenderContext,
+	type SelectableListRow,
+} from "./controls/selectable-list.ts";
+export {
+	mountSelectionActionBar,
+	placeSelectionActionBar,
+	SelectionActionBar,
+	type SelectionActionBarAction,
+	type SelectionActionBarGeometry,
+	type SelectionActionBarItemGeometry,
+	type SelectionActionBarMount,
+	type SelectionActionBarMountOptions,
+	type SelectionActionBarOptions,
+	type SelectionActionBarPlacementRequest,
+	type SelectionActionBarTarget,
+} from "./controls/selection-action-bar.ts";
+export { SemanticInput } from "./controls/semantic-input.ts";
+export { type Tab, TabBar } from "./controls/tab.ts";
+export {
+	type CursorRole,
+	cursorStyle,
+	isNativeCursorStyle,
+	type MarkEditorCursorOptions,
+	markEditorCursor,
+	markSemanticCursorPosition,
+	removeUnmarkedEditorCursor,
+	renderSemanticCursor,
+	renderVirtualCursor,
+	type SemanticCursorOptions,
+	stripCursorRoleMarkers,
+	type VirtualCursorOptions,
+} from "./cursor.ts";
+export {
+	type EditorTokenPillGeometry,
+	type EditorTokenPillRenderContext,
+	type EditorTokenPillResult,
+	type EditorTokenPresentation,
+	renderEditorPasteMarkerPills,
+	renderEditorTokenPills,
+} from "./decoration/editor-pills.ts";
+export {
+	icon,
+	keyHintGlyph,
+	type PillContent,
+	renderKeyHint,
+	renderPillText,
+	type TuiIconName,
+	type TuiKeyIconPack,
+} from "./decoration/glyphs.ts";
+export {
+	PointerInteractionController,
+	type PointerInteractionHandlers,
+	type PointerInteractionOptions,
+} from "./decoration/pointer-interaction.ts";
+export {
+	backgroundAnsiAtColumn,
+	contrastingPillBackground,
+	renderPill,
+} from "./decoration/powerline-pill.ts";
+export type {
+	ActivityIndicatorOptions,
+	ProgressBarOptions,
+	ProgressFrameOptions,
+	TuiTitle,
+	TuiTitleSource,
+	TuiTitleValue,
+} from "./decoration/status.ts";
+export {
+	ActivityIndicator,
+	ProgressBar,
+	progressFrame,
+} from "./decoration/status.ts";
+export {
+	placeTransientPill,
+	TransientPill,
+	type TransientPillMessage,
+	type TransientPillOptions,
+	type TransientPillPlacementRequest,
+} from "./decoration/transient-pill.ts";
+export type {
+	ActivityAnimationOverrides,
+	ActivityFrame,
+	MotionClock,
+	MotionMount,
+	MotionMountOptions,
+	MotionRenderTarget,
+	MotionTimerHandle,
+} from "./motion.ts";
+export {
+	activityAnimatesText,
+	activityFrame,
+	animationSmoothnessCadenceMs,
+	animationSpeedMultiplier,
+	configuredAnimationCadenceMs,
+	glyphFrame,
+	lightningShimmerFrame,
+	MotionScheduler,
+	mountConfiguredAnimation,
+	pulseFrame,
+	pulseGlyphFrame,
+	rainbowGlowShimmerFrame,
+	rainbowShimmerFrame,
+	sharedMotionScheduler,
+	shimmerFrame,
+	spinnerFrame,
+} from "./motion.ts";
+export {
+	type AnchoredOverlayPlacement,
+	type AnchoredOverlayRect,
+	type AnchoredOverlayRequest,
+	placeAnchoredOverlay,
+} from "./overlay/anchored.ts";
+export {
+	type DetailCardContent,
+	decorateDetailCard,
+	type HoverDetailCardMount,
+	type HoverDetailCardOptions,
+	type HoverDetailCardTarget,
+	mountHoverDetailCard,
+	overlayTotalWidth,
+	renderDetailCard,
+} from "./overlay/detail-card.ts";
+export {
+	type DialogHost,
+	DialogOverlay,
+	type DialogOverlayAnchor,
+	DialogOverlayHost,
+	type DialogOverlayOptions,
+	offsetDialogHost,
+} from "./overlay/dialog.ts";
+export { FloatingOverlay, type FloatingOverlayOptions } from "./overlay/floating.ts";
+export {
+	FramedEditorOverlay,
+	type FramedEditorOverlayGeometry,
+	type FramedEditorOverlayOptions,
+} from "./overlay/framed-editor.ts";
+export { FullscreenOverlay, fullscreenOverlayOptions } from "./overlay/fullscreen.ts";
+export {
+	compositeHoverTooltip,
+	findScreenTextRect,
+	type HoverTooltipMount,
+	type HoverTooltipMountOptions,
+	type HoverTooltipTarget,
+	mountHoverTooltip,
+} from "./overlay/hover-tooltip.ts";
+export {
+	type ModalOverlayComponent,
+	type ModalOverlayMountOptions,
+	type ModalOverlayMouseEvent,
+	type MountedModalOverlayComponent,
+	mountModalOverlay,
+} from "./overlay/modal-mount.ts";
+export { RenderedLinesCache } from "./render-cache.ts";
+export { applyScrollbar } from "./scrollbar.ts";
+export {
+	ensureSidePanelRegistry,
+	registerSidePanelProvider,
+	SIDE_PANEL_PROTOCOL,
+	SIDE_PANEL_REGISTRY_KEY,
+	type SidePanelContent,
+	type SidePanelEmptyAction,
+	type SidePanelHeaderAction,
+	type SidePanelProvider,
+	type SidePanelRegistry,
+	type SidePanelSession,
+	type SidePanelTab,
+} from "./panels.ts";
+export {
+	ensureSplitPaneRegistry,
+	type MountedSplitPane,
+	mountSplitPane,
+	SPLIT_PANE_PROTOCOL,
+	SPLIT_PANE_REGISTRY_KEY,
+	type SplitPaneComponent,
+	type SplitPaneComponentFactory,
+	type SplitPaneDefinition,
+	type SplitPaneHost,
+	type SplitPanePosition,
+	type SplitPaneRegistry,
+} from "./split-pane.ts";
+export { statusPresentationFrame } from "./status-presentation.ts";
+export {
+	highlightSyntaxBlock,
+	SyntaxText,
+	type SyntaxTextOptions,
+	whenSyntaxReady,
+} from "./syntax.ts";
+export {
+	type EnsureNativeBinaryHooks,
+	ensureNativeBinary,
+	locateNativeBinary,
+	type NativeBinary,
+	type NativeBinaryLocation,
+	type NativeBinaryOptions,
+	TERMINAL_BRIDGE,
+	terminalBridgeBinaryPath,
+} from "./native-binary.ts";
+export {
+	createTerminalBridgeClient,
+	parseTerminalBridgeReadResponse,
+	type TerminalBridgeClient,
+	type TerminalBridgeClientDependencies,
+	type TerminalBridgeReadResponse,
+} from "./terminal/bridge-client.ts";
+export { stripTopLevelZoneMarkers } from "./terminal/embedding.ts";
+export { PtyPane, type PtyPaneOptions, PtyProcess, type PtyProcessOptions } from "./terminal/pty-pane.ts";

package/src/line-layout.ts

@@ -0,0 +1,6 @@
+import { truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
+
+export function fitLine(line: string, width: number): string {
+	const clipped = truncateToWidth(line, width, "");
+	return clipped + " ".repeat(Math.max(0, width - visibleWidth(clipped)));
+}