@bastani/atomic 0.9.16-alpha.2 → 0.9.16-alpha.4

package/dist/builtin/workflows/src/tui/stage-chat-view-footer-status.ts

@@ -1,219 +0,0 @@
-import type { AgentSession } from "@bastani/atomic";
-import { Box, Text } from "@earendil-works/pi-tui";
-import type { StageSnapshot } from "../shared/store-types.js";
-import { hexToAnsi, RESET } from "./color-utils.js";
-import { wrapIdentifierLines } from "./run-identity-rows.js";
-import {
-	bgFn,
-	blendBg,
-	paint,
-	paintOnFill,
-	stripAnsi,
-	trailingWidgetBorderChar,
-	widgetHintTargetLineIndex,
-} from "./stage-chat-view-render-helpers.js";
-import type { StageChatViewContext } from "./stage-chat-view-types.js";
-import { truncateToWidth, visibleWidth } from "./text-helpers.js";
-
-export function renderHeader(ctx: StageChatViewContext, width: number, stage: StageSnapshot | undefined): string[] {
-	const t = ctx.theme;
-	const stageName = stage?.name ?? "stage";
-	const sid = ctx.handle?.sessionId ?? stage?.sessionId;
-	const prefixWidth = visibleWidth("   STAGE  ");
-	const separatorWidth = visibleWidth(" / ");
-	const meta = sid ? `session ${sid}` : "";
-	const rightWidth = meta ? visibleWidth(meta) + 1 : 0;
-	const singleRowNameBudget = width - prefixWidth - separatorWidth - rightWidth - (meta ? 1 : 0);
-
-	const fullNameWidth = visibleWidth(ctx.workflowName) + visibleWidth(stageName);
-	if (!sid || singleRowNameBudget >= fullNameWidth) {
-		const names = fitHeaderNames(ctx.workflowName, stageName, Math.max(2, singleRowNameBudget));
-		const left = renderHeaderLeft(ctx, names.workflow, names.stage);
-		const right = meta ? `${paint(meta, t.dim)} ` : "";
-		const gap = Math.max(0, width - visibleWidth(left) - visibleWidth(right));
-		return [left + " ".repeat(gap) + right];
-	}
-
-	const names = fitHeaderNames(ctx.workflowName, stageName, Math.max(2, width - prefixWidth - separatorWidth));
-	const left = renderHeaderLeft(ctx, names.workflow, names.stage);
-	const lines = [left + " ".repeat(Math.max(0, width - visibleWidth(left)))];
-	if (visibleWidth(meta) + 1 <= width) {
-		lines.push(`${" ".repeat(Math.max(0, width - visibleWidth(meta) - 1))}${paint(meta, t.dim)} `);
-		return lines;
-	}
-	for (const row of wrapIdentifierLines(sid, width, "   ", "   ")) {
-		const value = `${row.prefix}${paint(row.chunk, t.dim)}`;
-		lines.push(value + " ".repeat(Math.max(0, width - visibleWidth(value))));
-	}
-	return lines;
-}
-
-function renderHeaderLeft(ctx: StageChatViewContext, workflowName: string, stageName: string): string {
-	const t = ctx.theme;
-	return (
-		paint("   ", t.mauve, { bold: true }) +
-		paint("STAGE", t.textMuted, { bold: true }) +
-		"  " +
-		paint(workflowName, t.textMuted) +
-		paint(" / ", t.dim) +
-		paint(stageName, t.text, { bold: true })
-	);
-}
-
-function fitHeaderNames(workflowName: string, stageName: string, budget: number): { workflow: string; stage: string } {
-	const available = Math.max(2, budget);
-	const workflowWidth = visibleWidth(workflowName);
-	const stageWidth = visibleWidth(stageName);
-	let workflowBudget = Math.min(workflowWidth, Math.max(1, Math.ceil(available / 2)));
-	let stageBudget = Math.min(stageWidth, Math.max(1, available - workflowBudget));
-	let remaining = available - workflowBudget - stageBudget;
-	const workflowExtra = Math.min(remaining, Math.max(0, workflowWidth - workflowBudget));
-	workflowBudget += workflowExtra;
-	remaining -= workflowExtra;
-	stageBudget += Math.min(remaining, Math.max(0, stageWidth - stageBudget));
-	return {
-		workflow: truncateToWidth(workflowName, workflowBudget, "…"),
-		stage: truncateToWidth(stageName, stageBudget, "…"),
-	};
-}
-
-export function sepRule(ctx: StageChatViewContext, width: number): string {
-	return hexToAnsi(ctx.theme.borderDim) + "─".repeat(width) + RESET;
-}
-
-export function renderFooterWithOrchestratorReturnHint(
-	ctx: StageChatViewContext,
-	width: number,
-	footerLines: readonly string[],
-): string[] {
-	if (footerLines.length === 0) {
-		return [mergeOrchestratorReturnHintIntoLine(ctx, "", width)];
-	}
-	const lines = [...footerLines];
-	const lastIndex = lines.length - 1;
-	lines[lastIndex] = mergeOrchestratorReturnHintIntoLine(ctx, lines[lastIndex] ?? "", width);
-	return lines;
-}
-export function renderReadOnlyArchiveFooter(ctx: StageChatViewContext, width: number): string[] {
-	const closeHint = paint("esc", ctx.theme.text, { bold: true }) + paint(" to close", ctx.theme.textMuted);
-	return [
-		mergeOrchestratorReturnHintIntoLine(ctx, closeHint, width, {
-			minimumPrefixWidth: visibleWidth(closeHint) + 1,
-		}),
-	];
-}
-
-export function embedOrchestratorReturnHintInWidget(
-	ctx: StageChatViewContext,
-	widgetLines: readonly string[],
-	width: number,
-): string[] {
-	if (widgetLines.length === 0) {
-		return [mergeOrchestratorReturnHintIntoLine(ctx, "", width)];
-	}
-	const lines = [...widgetLines];
-	const targetIndex = widgetHintTargetLineIndex(lines);
-	const targetLine = lines[targetIndex] ?? "";
-	const trailingBorder = trailingWidgetBorderChar(targetLine);
-	const plainPrefix = stripAnsi(targetLine)
-		.slice(0, trailingBorder.length > 0 ? -trailingBorder.length : undefined)
-		.trimEnd();
-	lines[targetIndex] = mergeOrchestratorReturnHintIntoLine(ctx, targetLine, width, {
-		preserveTrailingBorder: true,
-		rightMargin: 2,
-		minimumPrefixWidth: visibleWidth(plainPrefix) + 1,
-	});
-	return lines;
-}
-
-function mergeOrchestratorReturnHintIntoLine(
-	ctx: StageChatViewContext,
-	line: string,
-	width: number,
-	options: {
-		preserveTrailingBorder?: boolean;
-		rightMargin?: number;
-		minimumPrefixWidth?: number;
-	} = {},
-): string {
-	const fullHint = {
-		plain: "ctrl+x return to graph",
-		styled: paint("ctrl+x", ctx.theme.text, { bold: true }) + paint(" return to graph", ctx.theme.textMuted),
-	};
-	const compactHint = {
-		plain: "ctrl+x graph",
-		styled: paint("ctrl+x", ctx.theme.text, { bold: true }) + paint(" graph", ctx.theme.textMuted),
-	};
-	const trailingBorder = options.preserveTrailingBorder === true ? trailingWidgetBorderChar(line) : "";
-	const suffixWidth = visibleWidth(trailingBorder);
-	const requestedRightMargin = Math.max(0, Math.floor(options.rightMargin ?? 0));
-	const minimumPrefixWidth = Math.max(0, Math.floor(options.minimumPrefixWidth ?? 0));
-	const fullRequiredWidth = suffixWidth + requestedRightMargin + minimumPrefixWidth + visibleWidth(fullHint.plain);
-	const hint = fullRequiredWidth <= width ? fullHint : compactHint;
-	const hintWidth = visibleWidth(hint.plain);
-	const rightMargin = Math.min(requestedRightMargin, Math.max(0, width - suffixWidth - hintWidth));
-	const hintStart = Math.max(0, width - suffixWidth - rightMargin - hintWidth);
-	const prefixWidth = Math.max(0, hintStart - 1);
-	const prefix = truncateToWidth(line, prefixWidth, "", true);
-	const gap = Math.max(0, hintStart - visibleWidth(prefix));
-	return prefix + " ".repeat(gap) + hint.styled + " ".repeat(rightMargin) + trailingBorder;
-}
-
-export function banner(
-	ctx: StageChatViewContext,
-	kind: "warning" | "success" | "error" | "info",
-	glyph: string,
-	label: string,
-	meta: string,
-): Box {
-	const t = ctx.theme;
-	const fg = kind === "warning" ? t.warning : kind === "success" ? t.success : kind === "info" ? t.info : t.error;
-	const bg = blendBg(t.bg, fg, 0.1);
-	const head =
-		paintOnFill(glyph, fg, { bold: true }) +
-		"  " +
-		paintOnFill(label, fg, { bold: true }) +
-		"  " +
-		paintOnFill(stripAnsi(meta), t.dim);
-	const box = new Box(2, 0, bgFn(bg));
-	box.addChild(new Text(head, 0, 0));
-	return box;
-}
-
-export function bannerLines(
-	ctx: StageChatViewContext,
-	width: number,
-	kind: "warning" | "success" | "error" | "info",
-	glyph: string,
-	label: string,
-	meta: string,
-): string[] {
-	return banner(ctx, kind, glyph, label, meta).render(width);
-}
-
-export function editorRuleColor(
-	ctx: StageChatViewContext,
-	disabled: boolean,
-	agentSession: AgentSession | undefined,
-	state?: { isBashMode: boolean },
-): string {
-	if (disabled) return ctx.theme.borderDim;
-	if (state?.isBashMode) return ctx.theme.warning;
-	const level = agentSession?.state.thinkingLevel ?? "off";
-	switch (level) {
-		case "minimal":
-			return ctx.theme.borderDim;
-		case "low":
-			return ctx.theme.info;
-		case "medium":
-			return ctx.theme.accent;
-		case "high":
-			return ctx.theme.mauve;
-		case "xhigh":
-			return ctx.theme.error;
-		case "max":
-			return ctx.theme.error;
-		default:
-			return ctx.theme.border;
-	}
-}

package/dist/builtin/workflows/src/tui/stage-chat-view-input.ts

@@ -1,216 +0,0 @@
-import { TRANSCRIPT_JUMP_TO_END_URL } from "@bastani/atomic";
-
-import { APP_ACTION, isKeybindingsLike, matchesAction, TUI_ACTION } from "./keybindings-adapter.js";
-import { parseTerminalMouseInput, terminalMouseWheelDirection } from "./mouse-input.js";
-import { defaultResponseFor, handlePromptCardInput, isPromptEscapeInput } from "./prompt-card.js";
-import { releaseMountedCustomUi } from "./stage-chat-view-custom-ui.js";
-import { setComponentFocused, setEditorFocused } from "./stage-chat-view-render-helpers.js";
-import {
-	canSubmitPrompt,
-	currentStage,
-	isAbortableStreamingSession,
-	isBlocked,
-	isReadOnlyArchive,
-	promptPageSize,
-	recordCurrentPromptDraft,
-	resolvePromptResponse,
-	syncPromptState,
-} from "./stage-chat-view-state.js";
-import { PROMPT_SCROLL_STEP_ROWS, type StageChatViewContext } from "./stage-chat-view-types.js";
-import { Key, matchesKey } from "./text-helpers.js";
-
-export function handleStageChatInput(ctx: StageChatViewContext, data: string): boolean {
-	if (data === TRANSCRIPT_JUMP_TO_END_URL) return handleStageChatJumpToBottom(ctx, data);
-	const keybindings = isKeybindingsLike(ctx.piKeybindings) ? ctx.piKeybindings : undefined;
-	// Only the default physical Ctrl+T belongs to the host thinking action. A
-	// user remap may reuse an editor key, so let that key reach the composer.
-	if (matchesKey(data, Key.ctrl("t")) && matchesAction(keybindings, data, APP_ACTION.thinkingToggle)) {
-		return false;
-	}
-	if (matchesKey(data, Key.ctrl("x"))) {
-		if (ctx.mountedCustomUi) releaseMountedCustomUi(ctx);
-		else {
-			const stage = currentStage(ctx);
-			syncPromptState(ctx, stage?.pendingPrompt);
-			recordCurrentPromptDraft(ctx);
-		}
-		ctx.onDetach();
-		return true;
-	}
-	if (ctx.mountedCustomUi) {
-		return handleMountedCustomUiInput(ctx, data);
-	}
-	const stage = currentStage(ctx);
-	syncPromptState(ctx, stage?.pendingPrompt);
-	const readOnlyArchive = isReadOnlyArchive(ctx, stage);
-	const readOnlyPromptArchive = readOnlyArchive && stage?.promptFootprint !== undefined;
-
-	if (ctx.promptState) {
-		if (handlePromptScrollInput(ctx, data, ctx.promptEditor === null)) return true;
-		handlePromptInput(ctx, data);
-		return true;
-	}
-	if (handleToolsExpandInput(ctx, data)) return true;
-	if (readOnlyPromptArchive && handlePromptScrollInput(ctx, data, true)) {
-		return true;
-	}
-	if (handleStageChatJumpToBottom(ctx, data)) return true;
-	if (ctx.chatHost.handleScrollInput(data)) return true;
-	if (matchesKey(data, Key.escape)) {
-		if (ctx.chatHost.isCompacting() || ctx.chatHost.isBashRunning() || ctx.chatHost.isEditingBashCommand()) {
-			return ctx.chatHost.handleInput(data);
-		}
-		if (isAbortableStreamingSession(ctx)) {
-			void ctx.chatHost.interrupt({ restoreQueuedMessages: true });
-			return true;
-		}
-		ctx.onClose();
-		return true;
-	}
-	if (matchesKey(data, Key.ctrl("c"))) {
-		ctx.onClose();
-		return true;
-	}
-	if (readOnlyArchive) return true;
-	const blocked = isBlocked(ctx);
-	if (matchesKey(data, Key.ctrl("f"))) {
-		if (blocked) return true;
-		// The mode travels with this submission and reaches the stage-chat prompt
-		// command, so an idle-looking Ctrl+F stays a follow-up.
-		void ctx.chatHost.submit("followUp");
-		return true;
-	}
-	if (blocked) return true;
-	return ctx.chatHost.handleInput(data);
-}
-
-function handleStageChatJumpToBottom(ctx: StageChatViewContext, data: string): boolean {
-	const keybindings = isKeybindingsLike(ctx.piKeybindings) ? ctx.piKeybindings : undefined;
-	if (data !== TRANSCRIPT_JUMP_TO_END_URL && !matchesAction(keybindings, data, TUI_ACTION.altScreenBottom))
-		return false;
-	ctx.chatHost.scrollToBottom();
-	return true;
-}
-function handleToolsExpandInput(ctx: StageChatViewContext, data: string): boolean {
-	const keybindings = isKeybindingsLike(ctx.piKeybindings) ? ctx.piKeybindings : undefined;
-	if (!matchesAction(keybindings, data, APP_ACTION.toolsExpand)) return false;
-	const expanded = ctx.getToolsExpanded?.() === true;
-	ctx.setToolsExpanded?.(!expanded);
-	ctx.chatHost.invalidate();
-	ctx.requestRender?.();
-	return true;
-}
-
-function handleMountedCustomUiInput(ctx: StageChatViewContext, data: string): boolean {
-	const mounted = ctx.mountedCustomUi;
-	if (!mounted) return false;
-	if (!canSubmitPrompt(ctx, mounted.request.id)) {
-		ctx.requestRender?.();
-		return true;
-	}
-
-	if (matchesKey(data, Key.ctrl("c"))) {
-		// Close hides the overlay; the background run — and its pending human-input
-		// request — keep living. Release the local display only.
-		releaseMountedCustomUi(ctx);
-		ctx.onClose();
-		return true;
-	}
-	// Let scroll input reach the transcript so history stays scrollable while the
-	// question is shown, matching the standalone ask_user_question tool.
-	if (handleStageChatJumpToBottom(ctx, data)) {
-		ctx.requestRender?.();
-		return true;
-	}
-	if (ctx.chatHost.handleScrollInput(data)) {
-		ctx.requestRender?.();
-		return true;
-	}
-
-	const component = mounted.component;
-	setComponentFocused(component, ctx.focused);
-	const handled = component.handleInput?.(data) === true;
-	ctx.requestRender?.();
-	return handled;
-}
-
-function handlePromptInput(ctx: StageChatViewContext, data: string): void {
-	const state = ctx.promptState;
-	if (!state) return;
-	if (ctx.promptEditor && ctx.promptEditorPromptId === state.prompt.id) {
-		if (matchesKey(data, Key.ctrl("c"))) {
-			resolvePromptResponse(ctx, state.prompt.id, defaultResponseFor(state.prompt), {
-				suppressNextGraphSubmit: false,
-			});
-			return;
-		}
-		if (isPromptEscapeInput(data)) {
-			ctx.requestRender?.();
-			return;
-		}
-		setEditorFocused(ctx.promptEditor, ctx.focused);
-		ctx.promptEditorSubmitFromEnter = matchesKey(data, Key.enter);
-		try {
-			ctx.promptEditor.handleInput(data);
-		} finally {
-			ctx.promptEditorSubmitFromEnter = false;
-		}
-		ctx.requestRender?.();
-		return;
-	}
-	const keybindings = isKeybindingsLike(ctx.piKeybindings) ? ctx.piKeybindings : undefined;
-	const action = handlePromptCardInput(data, state, keybindings);
-	const prompt = state.prompt;
-	if (prompt.kind === "input" || prompt.kind === "editor") {
-		ctx.store.recordStagePromptDraft(ctx.runId, ctx.stageId, prompt.id, state.rawText);
-	}
-	if (action.kind === "noop") {
-		ctx.requestRender?.();
-		return;
-	}
-	const response = action.kind === "submit" ? action.response : defaultResponseFor(prompt);
-	resolvePromptResponse(ctx, prompt.id, response, {
-		suppressNextGraphSubmit: action.kind === "submit" && matchesKey(data, Key.enter),
-	});
-}
-
-function handlePromptScrollInput(ctx: StageChatViewContext, data: string, includeKeyboard = true): boolean {
-	const mouse = parseTerminalMouseInput(data);
-	const wheelDirection = mouse ? terminalMouseWheelDirection(mouse) : null;
-	const wheelStep = promptScrollStep(ctx, PROMPT_SCROLL_STEP_ROWS);
-	const wheelDeltaRows = wheelDirection === "up" ? -wheelStep : wheelDirection === "down" ? wheelStep : 0;
-	if (wheelDeltaRows !== 0) {
-		scrollPromptBy(ctx, wheelDeltaRows);
-		return true;
-	}
-	if (mouse) return true;
-	if (!includeKeyboard) return false;
-	if (matchesKey(data, "pageUp")) {
-		scrollPromptBy(ctx, -promptScrollStep(ctx, promptPageSize(ctx)));
-		return true;
-	}
-	if (matchesKey(data, "pageDown")) {
-		scrollPromptBy(ctx, promptScrollStep(ctx, promptPageSize(ctx)));
-		return true;
-	}
-	if (!ctx.promptEditor && matchesKey(data, "home")) {
-		ctx.promptScrollOffset = 0;
-		ctx.requestRender?.();
-		return true;
-	}
-	if (!ctx.promptEditor && matchesKey(data, "end")) {
-		ctx.promptScrollOffset = ctx.promptMaxScroll;
-		ctx.requestRender?.();
-		return true;
-	}
-	return false;
-}
-
-function promptScrollStep(ctx: StageChatViewContext, requestedRows: number): number {
-	return Math.max(1, Math.min(requestedRows, Math.max(1, ctx.promptVisibleRows)));
-}
-
-function scrollPromptBy(ctx: StageChatViewContext, deltaRows: number): void {
-	ctx.promptScrollOffset = Math.max(0, Math.min(ctx.promptMaxScroll, ctx.promptScrollOffset + deltaRows));
-	ctx.requestRender?.();
-}

package/dist/builtin/workflows/src/tui/stage-chat-view-live-events.ts

@@ -1,65 +0,0 @@
-import type { AgentSessionEvent } from "@bastani/atomic";
-import {
-	hasActiveStageChatDelivery,
-	reconcileStageChatDeliveryLifecycle,
-} from "./stage-chat-view-delivery-activity.js";
-import { isTerminalStageChatState } from "./stage-chat-view-status.js";
-import type { StageChatViewContext } from "./stage-chat-view-types.js";
-
-export function applyStageChatLiveHandleEvent(ctx: StageChatViewContext, event: AgentSessionEvent): void {
-	const staleTerminalStart = isStaleTerminalLifecycleStart(ctx, event);
-	ctx.chatHost.applyAgentEvent(event);
-	if (staleTerminalStart) {
-		retainTerminalCleanup(ctx);
-		return;
-	}
-	if (isCompactionEndEvent(event)) reconcileStageChatDeliveryLifecycle(ctx);
-	if (!shouldCleanupAfterLiveEvent(ctx, event)) return;
-	retainTerminalCleanup(ctx);
-}
-
-function retainTerminalCleanup(ctx: StageChatViewContext): void {
-	const hadAnimationTick = ctx.chatHost.hasAnimationTick();
-	ctx.chatHost.clearBusyForTerminalWorkflowStage();
-	if (hadAnimationTick !== ctx.chatHost.hasAnimationTick()) ctx.requestRender?.();
-}
-
-/**
- * A turn start queued before the stage finished must not repaint Working on a
- * settled stage.
- *
- * The fence is armed only when this chat actually observed a terminal
- * transition and cleaned up in-flight work. Work admitted after that carries
- * its own authorization and is left alone: a live workflow delivery lease
- * (including one replayed at attach time), or a prompt this chat submitted
- * itself, which is already busy by the time its `agent_start` arrives.
- * `turn_start` is guarded too, otherwise it would restart the lifecycle a
- * suppressed `agent_start` just stopped.
- */
-function isStaleTerminalLifecycleStart(ctx: StageChatViewContext, event: AgentSessionEvent): boolean {
-	if (!ctx.terminalLifecycleFenced) return false;
-	const type = String((event as { type?: unknown }).type ?? "");
-	if (type !== "agent_start" && type !== "turn_start") return false;
-	if (hasActiveStageChatDelivery(ctx)) return false;
-	if (ctx.chatHost.isStreaming()) return false;
-	return isCurrentRunOrStageTerminal(ctx);
-}
-
-function isCompactionEndEvent(event: AgentSessionEvent): boolean {
-	return String((event as { type?: unknown }).type ?? "") === "compaction_end";
-}
-
-function shouldCleanupAfterLiveEvent(ctx: StageChatViewContext, event: AgentSessionEvent): boolean {
-	if (!isToolExecutionLiveEvent(event)) return false;
-	if (ctx.chatHost.isStreaming()) return false;
-	return isCurrentRunOrStageTerminal(ctx);
-}
-
-function isCurrentRunOrStageTerminal(ctx: StageChatViewContext): boolean {
-	return isTerminalStageChatState(ctx.lastObservedRunStatus) || isTerminalStageChatState(ctx.lastObservedStageStatus);
-}
-
-function isToolExecutionLiveEvent(event: AgentSessionEvent): boolean {
-	const type = String((event as { type?: unknown }).type ?? "");
-	return type === "tool_execution_start" || type === "tool_execution_update";
-}

package/dist/builtin/workflows/src/tui/stage-chat-view-pending-tools.ts

@@ -1,7 +0,0 @@
-import type { AgentSessionEvent } from "@bastani/atomic";
-import type { StageChatViewContext } from "./stage-chat-view-types.js";
-
-export function replayPendingToolExecutions(ctx: StageChatViewContext): void {
-	const events = ctx.handle?.isDisposed === true ? [] : (ctx.handle?.pendingToolExecutionEvents?.() ?? []);
-	for (const event of events) ctx.chatHost.applyAgentEvent(event as AgentSessionEvent);
-}

package/dist/builtin/workflows/src/tui/stage-chat-view-render-helpers.ts

@@ -1,149 +0,0 @@
-import type { Component, EditorComponent, EditorTheme, Focusable } from "@earendil-works/pi-tui";
-import type { PendingPrompt } from "../shared/store-types.js";
-import { BOLD, hexBg, hexToAnsi, lerpColor, RESET } from "./color-utils.js";
-import type { GraphTheme } from "./graph-theme.js";
-import type { PaintOpts } from "./stage-chat-view-types.js";
-
-const ITALIC = "\x1b[3m";
-const FG_RESET = "\x1b[39m";
-const WEIGHT_RESET = "\x1b[22m";
-const ITALIC_RESET = "\x1b[23m";
-
-export function blankLine(width: number): string {
-	return " ".repeat(width);
-}
-
-export function cursorBlock(): string {
-	return "\x1b[7m \x1b[0m";
-}
-
-export function setComponentFocused(component: Component, focused: boolean): void {
-	const candidate = component as Component & Partial<Focusable>;
-	if ("focused" in candidate) candidate.focused = focused;
-}
-
-export function setEditorFocused(editor: EditorComponent, focused: boolean): void {
-	setComponentFocused(editor, focused);
-}
-
-export function setEditorPlaceholder(editor: EditorComponent, placeholder: string | undefined): void {
-	const candidate = editor as EditorComponent & {
-		setPlaceholder?: (value: string | undefined) => void;
-	};
-	candidate.setPlaceholder?.(placeholder);
-}
-
-export function setEditorBorderColor(editor: EditorComponent, borderColor: (text: string) => string): void {
-	const candidate = editor as EditorComponent & {
-		borderColor?: (text: string) => string;
-	};
-	if ("borderColor" in candidate) candidate.borderColor = borderColor;
-}
-
-export function bgFn(hex: string): (text: string) => string {
-	const open = hexBg(hex);
-	return (text: string) => open + text + RESET;
-}
-
-export function editorThemeFromGraphTheme(t: GraphTheme): EditorTheme {
-	const selected = (text: string): string => hexBg(t.backgroundPanel) + hexToAnsi(t.text) + text + RESET;
-	const normal = (text: string): string => hexToAnsi(t.text) + text + RESET;
-	return {
-		borderColor: (text: string) => hexToAnsi(t.border) + text + RESET,
-		selectList: {
-			selectedPrefix: selected,
-			selectedText: selected,
-			description: (text: string) => hexToAnsi(t.dim) + text + RESET,
-			scrollInfo: (text: string) => hexToAnsi(t.dim) + text + RESET,
-			noMatch: (text: string) => hexToAnsi(t.warning) + text + RESET,
-			normal,
-		},
-	} as EditorTheme;
-}
-
-export function takeRows(lines: readonly string[], rows: number): string[] {
-	return lines.slice(0, rows);
-}
-
-export function widgetHintTargetLineIndex(lines: readonly string[]): number {
-	for (let index = lines.length - 1; index >= 0; index -= 1) {
-		if (!isWidgetBottomBorderLine(lines[index] ?? "")) return index;
-	}
-	return Math.max(0, lines.length - 1);
-}
-
-function isWidgetBottomBorderLine(line: string): boolean {
-	const plain = stripAnsi(line).trim();
-	const chars = Array.from(plain);
-	if (chars.length < 2) return false;
-	const first = chars[0] ?? "";
-	const last = chars.at(-1) ?? "";
-	if (!"╰└+".includes(first) || !"╯┘+".includes(last)) return false;
-	return chars.slice(1, -1).every((char) => "─═- ".includes(char));
-}
-
-export function trailingWidgetBorderChar(line: string): string {
-	const plain = stripAnsi(line).trimEnd();
-	const last = Array.from(plain).at(-1) ?? "";
-	return "╯┘┤┴│|+".includes(last) ? last : "";
-}
-
-export function paint(text: string, fg: string, opts: PaintOpts = {}): string {
-	if (!text) return "";
-	let out = hexToAnsi(fg);
-	if (opts.bold) out += BOLD;
-	if (opts.italic) out += ITALIC;
-	if (opts.bg) out = hexBg(opts.bg) + out;
-	return out + text + RESET;
-}
-
-/**
- * Foreground styling for text that will be wrapped by a `Box` background.
- * A normal `RESET` would also clear the parent background, so close only the
- * inline foreground/weight/italic state and let `bgFn()` reset the row at end.
- */
-export function paintOnFill(text: string, fg: string, opts: PaintOpts = {}): string {
-	if (!text) return "";
-	let out = hexToAnsi(fg);
-	if (opts.bold) out += BOLD;
-	if (opts.italic) out += ITALIC;
-	let close = FG_RESET;
-	if (opts.bold) close += WEIGHT_RESET;
-	if (opts.italic) close += ITALIC_RESET;
-	return out + text + close;
-}
-
-export function stripAnsi(s: string): string {
-	return s.replace(/\x1B\[[0-?]*[ -/]*[@-~]/g, "");
-}
-
-/**
- * Approximate a tinted background by mixing the base canvas with a saturated
- * hue at low alpha. Used for status pills and tool-bar tints. Returns a hex
- * colour the renderer can feed to `hexBg`.
- */
-export function blendBg(baseHex: string, tintHex: string, alpha: number): string {
-	return lerpColor(baseHex, tintHex, Math.max(0, Math.min(1, alpha)));
-}
-
-export function workingIndicatorPalette(theme: GraphTheme) {
-	const { selection: dark, accent, text: peak } = theme;
-	return {
-		dark,
-		lift: lerpColor(dark, accent, 0.25),
-		muted: lerpColor(dark, accent, 0.6),
-		accent,
-		bright: lerpColor(accent, peak, 0.55),
-		peak,
-	};
-}
-
-export function renderHintsForPrompt(kind: PendingPrompt["kind"], theme: GraphTheme): string {
-	if (kind === "input" || kind === "editor") {
-		return `${paint("enter", theme.textMuted, { bold: true })} Submit · ${paint("ctrl+c", theme.textMuted, { bold: true })} Skip`;
-	}
-	if (kind === "custom") {
-		return `${paint("ctrl+x", theme.textMuted, { bold: true })} Return to graph · ${paint("ctrl+c", theme.textMuted, { bold: true })} Close`;
-	}
-	return `${paint("enter", theme.textMuted, { bold: true })} Select · ${paint("ctrl+c", theme.textMuted, { bold: true })} Skip`;
-}