@bubblebrain-ai/bubble 0.0.63 → 0.0.65

package/dist/tui/components/transcript.d.ts

@@ -0,0 +1,103 @@
+import { DisplayToolCall, DisplayMessage } from "../model/display-history.js";
+import { type Theme } from "../model/theme.js";
+import type { TraceInteractionState, TraceRowTarget } from "../model/trace-interaction.js";
+import type { DisplayImageAttachment } from "../model/image-attachment.js";
+export interface TranscriptRenderOptions {
+    columns: number;
+    showReasoning?: boolean;
+    verboseTrace?: boolean;
+    theme?: TranscriptTheme;
+    /** Optional markdown pipeline for assistant content (app injects pi-tui's
+     *  Markdown component; the default is plain wrapped text). */
+    markdownRenderer?: (text: string, width: number) => string[];
+    /** Shared UI-only selection/fold state for interactive tool groups. */
+    traceInteraction?: TraceInteractionState;
+    /** Keep a final transcript spacer; fullscreen disables it once no live tail follows. */
+    trailingSpacer?: boolean;
+    /** Preview a destructive rewrite by dimming this message and everything after it. */
+    dimFromMessageIndex?: number;
+}
+export interface TranscriptProjection {
+    rows: string[];
+    /** Row-aligned pointer targets; undefined rows remain ordinary selectable text. */
+    traceTargets: Array<TraceRowTarget | undefined>;
+    /** Semantic padding survives hover painting, so joins never add/remove rows. */
+    leadingSpacer?: boolean;
+    trailingSpacer?: boolean;
+}
+export declare function joinTranscriptProjections(blocks: readonly TranscriptProjection[]): TranscriptProjection;
+export interface TranscriptTheme {
+    userBg: (text: string) => string;
+    userText: (text: string) => string;
+    accent: (text: string) => string;
+    dim: (text: string) => string;
+    error: (text: string) => string;
+    success: (text: string) => string;
+    /** Dim chrome used by Grok-style pointer hover around tool entries. */
+    hoverBorder?: (text: string) => string;
+    /** Brighter chrome used by Grok for the selected scrollback entry. */
+    selectionBorder?: (text: string) => string;
+    /** Full-width neutral surface painted inside a hovered tool entry. */
+    hoverBackground?: (text: string) => string;
+    /** Persistent surface painted while the tool entry is selected. */
+    selectionBackground?: (text: string) => string;
+    imageChip?: (text: string, active: boolean) => string;
+}
+export declare function createTranscriptTheme(getTheme: () => Theme): TranscriptTheme;
+export declare const defaultTranscriptTheme: TranscriptTheme;
+/**
+ * Width of the shared left rail. Column 0..2 belong to surface chrome
+ * (user `›`, hovered tool `│`, reasoning `┃`); the body starts at column 3.
+ * Changing this moves every transcript surface together.
+ */
+export declare const TRANSCRIPT_RAIL_COLUMNS = 3;
+export declare function renderUserCard(content: string, options: TranscriptRenderOptions, images?: readonly DisplayImageAttachment[], messageKey?: string): string[];
+export declare function wrapPlain(text: string, columns: number): string[];
+/**
+ * Project assistant prose without transcript spacing. Live streaming and
+ * settled history both call this function, so completing a turn cannot change
+ * the answer gutter or wrapping width. Prose carries an empty rail: its body
+ * sits in the same column as user text and tool entries.
+ */
+export declare function projectAssistantRows(content: string, options: TranscriptRenderOptions): string[];
+export declare function renderAssistant(content: string, options: TranscriptRenderOptions): string[];
+/**
+ * Join reasoning, tool, and prose surfaces with one semantic separator.
+ * Individual projectors own only their visible rows; this composition layer
+ * owns vertical rhythm, so live and settled timelines cannot drift apart.
+ */
+export declare function joinTranscriptBlocks(blocks: readonly (readonly string[])[]): string[];
+export interface ReasoningProjectionOptions {
+    /** In-flight reasoning uses the only stateful visual difference Grok keeps. */
+    running?: boolean;
+    /** Maximum number of physical reasoning body rows. */
+    maxBodyRows?: number;
+    /** Minimal reasoning keeps the newest rows in both live and settled states. */
+    fromEnd?: boolean;
+}
+/** Grok minimal mode keeps the same rolling reasoning surface live/settled. */
+export declare const MINIMAL_REASONING_BODY_ROWS = 5;
+/**
+ * Grok-style reasoning surface. Reasoning paints a `┃` in the shared rail so
+ * its body lines up with prose and tool entries. The same projection is used
+ * by the live row pool and committed transcript.
+ */
+export declare function projectReasoningRows(content: string, options: TranscriptRenderOptions, projection?: ReasoningProjectionOptions): string[];
+export declare function renderReasoning(content: string, options: TranscriptRenderOptions): string[];
+export declare function renderToolTrace(tool: DisplayToolCall, options: TranscriptRenderOptions): string;
+export interface TraceGroupRenderOptions {
+    /** Live Ink parity: identify the last group that is actually still active. */
+    showActivity?: boolean;
+}
+/**
+ * Render the same semantic trace groups used by the Ink TUI. This is shared
+ * by the live row pool and settled transcript so tool_start/tool_update/
+ * tool_end cannot change from a rich trace into an unrelated one-line row at
+ * the commit boundary.
+ */
+export declare function renderToolTraceGroups(toolCalls: readonly DisplayToolCall[], options: TranscriptRenderOptions, renderOptions?: TraceGroupRenderOptions): string[];
+export declare function projectToolTraceGroups(toolCalls: readonly DisplayToolCall[], options: TranscriptRenderOptions, renderOptions?: TraceGroupRenderOptions): TranscriptProjection;
+export declare function renderMessage(message: DisplayMessage, options: TranscriptRenderOptions): string[];
+export declare function projectMessage(message: DisplayMessage, options: TranscriptRenderOptions): TranscriptProjection;
+export declare function renderTranscript(messages: readonly DisplayMessage[], options: TranscriptRenderOptions): string[];
+export declare function projectTranscript(messages: readonly DisplayMessage[], options: TranscriptRenderOptions): TranscriptProjection;