@claude-code-kit/ui 0.1.1 → 0.2.0

package/dist/index.d.mts

@@ -4,6 +4,35 @@ import * as React from 'react';
 import React__default, { PropsWithChildren, Ref, ReactNode } from 'react';
 import { Tokens } from 'marked';
 import * as react_jsx_runtime from 'react/jsx-runtime';
+import { Agent, AuthRegistry, LLMProvider } from '@claude-code-kit/agent';
+
+type DiffLine = {
+    type: 'added' | 'removed' | 'context';
+    content: string;
+    oldLineNumber?: number;
+    newLineNumber?: number;
+};
+type DiffViewProps = {
+    filename: string;
+    lines: DiffLine[];
+    /** Raw unified diff string — parsed automatically if provided */
+    diff?: string;
+    /** Show line numbers (default: true) */
+    showLineNumbers?: boolean;
+    /** Max visible lines before showing a scroll hint */
+    maxHeight?: number;
+    color?: {
+        added?: string;
+        removed?: string;
+        context?: string;
+        header?: string;
+    };
+};
+declare function parseUnifiedDiff(diff: string): {
+    filename: string;
+    lines: DiffLine[];
+};
+declare function DiffView({ filename, lines: propLines, diff, showLineNumbers, maxHeight, color: colorOverrides, }: DiffViewProps): React__default.ReactNode;
 
 type DividerProps = {
     width?: number;
@@ -38,11 +67,14 @@ type StatusLineProps = {
     segments?: StatusLineSegment[];
     text?: string;
     paddingX?: number;
+    /** @deprecated Use separator instead. Gap between segments in columns. */
     gap?: number;
+    /** Separator string between segments (default: ' · ') */
+    separator?: string;
     borderStyle?: 'none' | 'single' | 'round';
     borderColor?: Color;
 };
-declare function StatusLine({ segments, text, paddingX, gap, borderStyle, borderColor, }: StatusLineProps): React__default.ReactNode;
+declare function StatusLine({ segments, text, paddingX, separator, borderStyle, borderColor, }: StatusLineProps): React__default.ReactNode;
 declare function useStatusLine(updater: () => StatusLineSegment[] | string, deps: unknown[], intervalMs?: number): StatusLineSegment[] | string;
 
 type CommandResult = {
@@ -213,8 +245,10 @@ type PromptInputProps = {
     commands?: Command[];
     onCommandSelect?: (name: string) => void;
     history?: string[];
+    vimMode?: boolean;
+    multiline?: boolean;
 };
-declare function PromptInput({ value, onChange, onSubmit, placeholder, prefix, prefixColor, disabled, commands, onCommandSelect, history, }: PromptInputProps): React__default.ReactNode;
+declare function PromptInput({ value, onChange, onSubmit, placeholder, prefix, prefixColor, disabled, commands, onCommandSelect, history, vimMode, multiline, }: PromptInputProps): React__default.ReactNode;
 
 type SpinnerProps = {
     label?: string;
@@ -286,10 +320,69 @@ type MultiSelectProps<T = string> = Omit<SelectProps<T>, 'onChange'> & {
 declare function Select<T = string>({ options, defaultValue, onChange, onCancel, title, maxVisible, }: SelectProps<T>): react_jsx_runtime.JSX.Element;
 declare function MultiSelect<T = string>({ options, selectedValues, onToggle, onConfirm, onCancel, title, maxVisible, }: MultiSelectProps<T>): react_jsx_runtime.JSX.Element;
 
+type PermissionAction = 'allow' | 'always_allow' | 'deny';
+type PermissionRequestProps = {
+    toolName: string;
+    description: string;
+    /** Optional details (command, file path, diff, etc.) */
+    details?: string;
+    /** Whether to show "Always Allow" option (default true) */
+    showAlwaysAllow?: boolean;
+    /** Callback when user makes a decision */
+    onDecision: (action: PermissionAction, feedback?: string) => void;
+    /** Optional custom content between description and buttons */
+    children?: React__default.ReactNode;
+    /** Optional: render a DiffView or code preview */
+    preview?: React__default.ReactNode;
+};
+declare function BashPermissionContent({ command }: {
+    command: string;
+}): React__default.ReactNode;
+declare function FileEditPermissionContent({ filename, diff, }: {
+    filename: string;
+    diff: string;
+}): React__default.ReactNode;
+declare function PermissionRequest({ toolName, description, details, showAlwaysAllow, onDecision, children, preview, }: PermissionRequestProps): React__default.ReactNode;
+
+type MessageContent = {
+    type: 'text';
+    text: string;
+} | {
+    type: 'tool_use';
+    toolName: string;
+    input: string;
+    result?: string;
+    status?: 'running' | 'success' | 'error';
+} | {
+    type: 'thinking';
+    text: string;
+    collapsed?: boolean;
+} | {
+    type: 'diff';
+    filename: string;
+    diff: string;
+} | {
+    type: 'code';
+    language?: string;
+    code: string;
+} | {
+    type: 'error';
+    message: string;
+    details?: string;
+};
+/**
+ * Display-oriented message type for rendering in the terminal UI.
+ *
+ * This type adds `id` and `timestamp` fields for UI purposes and supports
+ * rich `MessageContent[]` for rendering tool calls, diffs, code blocks, etc.
+ * It is distinct from the protocol-level `Message` type in
+ * `@claude-code-kit/agent`, which represents raw LLM conversation messages.
+ * The `useAgent` hook handles conversion between the two formats automatically.
+ */
 type Message = {
     id: string;
     role: 'user' | 'assistant' | 'system';
-    content: string;
+    content: string | MessageContent[];
     timestamp?: number;
 };
 type MessageListProps = {
@@ -308,18 +401,27 @@ type StreamingTextProps = {
 };
 declare function StreamingText({ text, speed, interval, onComplete, color, }: StreamingTextProps): React__default.ReactNode;
 
-type REPLCommand = {
+type REPLCommand$1 = {
     name: string;
     description: string;
     onExecute: (args: string) => void;
 };
+type PermissionRequestState = {
+    toolName: string;
+    description: string;
+    details?: string;
+    preview?: React__default.ReactNode;
+    onDecision: (action: PermissionAction) => void;
+};
 type REPLProps = {
     onSubmit: (message: string) => Promise<void> | void;
     onExit?: () => void;
     messages: Message[];
     isLoading?: boolean;
     streamingContent?: string | null;
-    commands?: REPLCommand[];
+    welcome?: React__default.ReactNode;
+    permissionRequest?: PermissionRequestState;
+    commands?: REPLCommand$1[];
     model?: string;
     statusSegments?: StatusLineSegment[];
     prefix?: string;
@@ -328,9 +430,9 @@ type REPLProps = {
     renderMessage?: (message: Message) => React__default.ReactNode;
     spinner?: React__default.ReactNode;
 };
-declare function REPL({ onSubmit, onExit, messages, isLoading, streamingContent, commands, model, statusSegments, prefix, placeholder, history: externalHistory, renderMessage, spinner, }: REPLProps): React__default.ReactNode;
+declare function REPL({ onSubmit, onExit, messages, isLoading, streamingContent, welcome, permissionRequest, commands, model, statusSegments, prefix, placeholder, history: externalHistory, renderMessage, spinner, }: REPLProps): React__default.ReactNode;
 
-type ThemeName = 'dark' | 'light';
+type ThemeName = 'dark' | 'light' | 'light-high-contrast' | 'dark-dimmed';
 type ThemeSetting = ThemeName | 'auto';
 type Theme = {
     text: string;
@@ -344,6 +446,28 @@ type Theme = {
     inactive: string;
     inverseText: string;
     permission: string;
+    diffAdded: string;
+    diffRemoved: string;
+    diffAddedWord: string;
+    diffRemovedWord: string;
+    diffHeader: string;
+    userMessage: string;
+    assistantMessage: string;
+    systemMessage: string;
+    toolUseMessage: string;
+    permissionAllow: string;
+    permissionDeny: string;
+    permissionAlways: string;
+    focus: string;
+    selection: string;
+    placeholder: string;
+    link: string;
+    code: string;
+    codeBackground: string;
+    blockquote: string;
+    info: string;
+    spinnerColor: string;
+    shimmer: string;
 };
 declare function getTheme(name: ThemeName): Theme;
 type Props$6 = {
@@ -669,4 +793,137 @@ declare function Byline({ children }: Props): React__default.ReactNode;
  */
 declare function color(c: keyof Theme | Color | undefined, theme: ThemeName, type?: ColorType): (text: string) => string;
 
-export { Byline, type Command$1 as Command, type CommandBase, type CommandOnDone, CommandRegistry, type CommandResult, DEFAULT_BINDINGS, Dialog, Divider, FuzzyPicker, type JSXCommand, KeybindingSetup, KeyboardShortcutHint, ListItem, LoadingState, type LocalCommand, Markdown, MarkdownTable, type Message, MessageList, type MessageListProps, MultiSelect, type MultiSelectProps, Pane, ProgressBar, PromptInput, REPL, type REPLProps, Ratchet, Select, type SelectOption, type SelectProps, Spinner, StatusIcon, StatusLine, type StatusLineProps, type StatusLineSegment, StreamingMarkdown, StreamingText, type StreamingTextProps, Tab, Tabs, type TerminalSize, TextHoverColorContext, type Theme, type ThemeName, ThemeProvider, type ThemeSetting, ThemedBox, type Props$5 as ThemedBoxProps, ThemedText, type Props$4 as ThemedTextProps, clearCommand, color, createCommandRegistry, defineCommand, defineJSXCommand, defineLocalCommand, exitCommand, getTheme, helpCommand, useDoublePress, useKeybinding, useKeybindings, usePreviewTheme, useStatusLine, useTabsWidth, useTerminalSize, useTheme, useThemeSetting };
+type VirtualScrollOptions = {
+    itemCount: number;
+    /** Lines per item (default: 3) */
+    estimatedItemHeight?: number;
+    /** Extra items rendered above/below the viewport (default: 20) */
+    overscan?: number;
+    /** Visible terminal rows */
+    viewportHeight: number;
+};
+type VirtualScrollResult = {
+    startIndex: number;
+    endIndex: number;
+    visibleItems: number;
+    totalHeight: number;
+    scrollOffset: number;
+    scrollTo: (index: number) => void;
+    scrollToEnd: () => void;
+    /** Adjust scroll by delta items (+1 = down, -1 = up) */
+    onScroll: (delta: number) => void;
+    isAtTop: boolean;
+    isAtEnd: boolean;
+};
+type VirtualListProps<T> = {
+    items: T[];
+    renderItem: (item: T, index: number) => ReactNode;
+    viewportHeight: number;
+    estimatedItemHeight?: number;
+    overscan?: number;
+};
+declare function useVirtualScroll(options: VirtualScrollOptions): VirtualScrollResult;
+declare function VirtualList<T>(props: VirtualListProps<T>): ReactNode;
+
+type SearchMatch = {
+    index: number;
+    offset: number;
+    length: number;
+};
+type SearchOverlayProps = {
+    isOpen: boolean;
+    onClose: () => void;
+    onSearch: (query: string) => SearchMatch[];
+    onNavigate: (match: SearchMatch) => void;
+    matchCount?: number;
+    currentMatch?: number;
+};
+type UseSearchResult = {
+    query: string;
+    matches: SearchMatch[];
+    currentIndex: number;
+    next: () => void;
+    previous: () => void;
+    setQuery: (q: string) => void;
+};
+type UseSearchOptions = {
+    content: string[];
+    isActive: boolean;
+};
+declare function useSearch({ content, isActive }: UseSearchOptions): UseSearchResult;
+declare function SearchOverlay({ isOpen, onClose, onSearch, onNavigate, }: SearchOverlayProps): React__default.ReactNode;
+
+type WelcomeScreenProps = {
+    appName: string;
+    subtitle?: string;
+    version?: string;
+    tips?: string[];
+    logo?: React__default.ReactNode;
+    model?: string;
+    color?: string;
+};
+declare function ClawdLogo({ color }: {
+    color?: string;
+}): React__default.ReactNode;
+declare function WelcomeScreen({ appName, subtitle, version, tips, logo, model, color, }: WelcomeScreenProps): React__default.ReactNode;
+
+type PermissionUIRequest = {
+    toolName: string;
+    description: string;
+    details?: string;
+    resolve: (decision: 'allow' | 'deny') => void;
+};
+type UseAgentOptions = {
+    agent: Agent;
+    onError?: (error: Error) => void;
+};
+type UseAgentResult = {
+    messages: Message[];
+    isLoading: boolean;
+    streamingContent: string | null;
+    permissionRequest: PermissionUIRequest | null;
+    submit: (input: string) => void;
+    cancel: () => void;
+    clearMessages: () => void;
+};
+declare function useAgent({ agent, onError }: UseAgentOptions): UseAgentResult;
+
+type AgentContextValue = UseAgentResult & {
+    agent: Agent;
+    model: string;
+};
+declare const AgentContext: React__default.Context<AgentContextValue | null>;
+type AgentProviderProps = {
+    agent: Agent;
+    model?: string;
+    onError?: (error: Error) => void;
+    children: React__default.ReactNode;
+};
+declare function AgentProvider({ agent, model, onError, children, }: AgentProviderProps): React__default.ReactNode;
+declare function useAgentContext(): AgentContextValue;
+
+type REPLCommand = {
+    name: string;
+    description: string;
+    onExecute: (args: string) => void;
+};
+type AgentREPLProps = {
+    agent: Agent;
+    model?: string;
+    commands?: REPLCommand[];
+    welcome?: React__default.ReactNode;
+    placeholder?: string;
+    onError?: (error: Error) => void;
+    onExit?: () => void;
+};
+declare function AgentREPL({ agent, model, commands, welcome, placeholder, onError, onExit, }: AgentREPLProps): React__default.ReactNode;
+
+type AuthFlowUIProps = {
+    auth: AuthRegistry;
+    onComplete: (provider: LLMProvider, providerName: string, model: string) => void;
+    onCancel?: () => void;
+    title?: string;
+};
+declare function AuthFlowUI({ auth, onComplete, onCancel, title, }: AuthFlowUIProps): React__default.ReactNode;
+
+export { AgentContext, type AgentContextValue, AgentProvider, type AgentProviderProps, AgentREPL, type AgentREPLProps, AuthFlowUI, type AuthFlowUIProps, BashPermissionContent, Byline, ClawdLogo, type Command$1 as Command, type CommandBase, type CommandOnDone, CommandRegistry, type CommandResult, DEFAULT_BINDINGS, Dialog, type DiffLine, DiffView, type DiffViewProps, Divider, FileEditPermissionContent, FuzzyPicker, type JSXCommand, KeybindingSetup, KeyboardShortcutHint, ListItem, LoadingState, type LocalCommand, Markdown, MarkdownTable, type Message, type MessageContent, MessageList, type MessageListProps, MultiSelect, type MultiSelectProps, Pane, type PermissionAction, PermissionRequest, type PermissionRequestProps, type PermissionUIRequest, ProgressBar, PromptInput, REPL, type REPLProps, Ratchet, type SearchMatch, SearchOverlay, type SearchOverlayProps, Select, type SelectOption, type SelectProps, Spinner, StatusIcon, StatusLine, type StatusLineProps, type StatusLineSegment, StreamingMarkdown, StreamingText, type StreamingTextProps, Tab, Tabs, type TerminalSize, TextHoverColorContext, type Theme, type ThemeName, ThemeProvider, type ThemeSetting, ThemedBox, type Props$5 as ThemedBoxProps, ThemedText, type Props$4 as ThemedTextProps, type UseAgentOptions, type UseAgentResult, type UseSearchResult, VirtualList, type VirtualListProps, type VirtualScrollOptions, type VirtualScrollResult, WelcomeScreen, type WelcomeScreenProps, clearCommand, color, createCommandRegistry, defineCommand, defineJSXCommand, defineLocalCommand, exitCommand, getTheme, helpCommand, parseUnifiedDiff, useAgent, useAgentContext, useDoublePress, useKeybinding, useKeybindings, usePreviewTheme, useSearch, useStatusLine, useTabsWidth, useTerminalSize, useTheme, useThemeSetting, useVirtualScroll };

package/dist/index.d.ts

@@ -4,6 +4,35 @@ import * as React from 'react';
 import React__default, { PropsWithChildren, Ref, ReactNode } from 'react';
 import { Tokens } from 'marked';
 import * as react_jsx_runtime from 'react/jsx-runtime';
+import { Agent, AuthRegistry, LLMProvider } from '@claude-code-kit/agent';
+
+type DiffLine = {
+    type: 'added' | 'removed' | 'context';
+    content: string;
+    oldLineNumber?: number;
+    newLineNumber?: number;
+};
+type DiffViewProps = {
+    filename: string;
+    lines: DiffLine[];
+    /** Raw unified diff string — parsed automatically if provided */
+    diff?: string;
+    /** Show line numbers (default: true) */
+    showLineNumbers?: boolean;
+    /** Max visible lines before showing a scroll hint */
+    maxHeight?: number;
+    color?: {
+        added?: string;
+        removed?: string;
+        context?: string;
+        header?: string;
+    };
+};
+declare function parseUnifiedDiff(diff: string): {
+    filename: string;
+    lines: DiffLine[];
+};
+declare function DiffView({ filename, lines: propLines, diff, showLineNumbers, maxHeight, color: colorOverrides, }: DiffViewProps): React__default.ReactNode;
 
 type DividerProps = {
     width?: number;
@@ -38,11 +67,14 @@ type StatusLineProps = {
     segments?: StatusLineSegment[];
     text?: string;
     paddingX?: number;
+    /** @deprecated Use separator instead. Gap between segments in columns. */
     gap?: number;
+    /** Separator string between segments (default: ' · ') */
+    separator?: string;
     borderStyle?: 'none' | 'single' | 'round';
     borderColor?: Color;
 };
-declare function StatusLine({ segments, text, paddingX, gap, borderStyle, borderColor, }: StatusLineProps): React__default.ReactNode;
+declare function StatusLine({ segments, text, paddingX, separator, borderStyle, borderColor, }: StatusLineProps): React__default.ReactNode;
 declare function useStatusLine(updater: () => StatusLineSegment[] | string, deps: unknown[], intervalMs?: number): StatusLineSegment[] | string;
 
 type CommandResult = {
@@ -213,8 +245,10 @@ type PromptInputProps = {
     commands?: Command[];
     onCommandSelect?: (name: string) => void;
     history?: string[];
+    vimMode?: boolean;
+    multiline?: boolean;
 };
-declare function PromptInput({ value, onChange, onSubmit, placeholder, prefix, prefixColor, disabled, commands, onCommandSelect, history, }: PromptInputProps): React__default.ReactNode;
+declare function PromptInput({ value, onChange, onSubmit, placeholder, prefix, prefixColor, disabled, commands, onCommandSelect, history, vimMode, multiline, }: PromptInputProps): React__default.ReactNode;
 
 type SpinnerProps = {
     label?: string;
@@ -286,10 +320,69 @@ type MultiSelectProps<T = string> = Omit<SelectProps<T>, 'onChange'> & {
 declare function Select<T = string>({ options, defaultValue, onChange, onCancel, title, maxVisible, }: SelectProps<T>): react_jsx_runtime.JSX.Element;
 declare function MultiSelect<T = string>({ options, selectedValues, onToggle, onConfirm, onCancel, title, maxVisible, }: MultiSelectProps<T>): react_jsx_runtime.JSX.Element;
 
+type PermissionAction = 'allow' | 'always_allow' | 'deny';
+type PermissionRequestProps = {
+    toolName: string;
+    description: string;
+    /** Optional details (command, file path, diff, etc.) */
+    details?: string;
+    /** Whether to show "Always Allow" option (default true) */
+    showAlwaysAllow?: boolean;
+    /** Callback when user makes a decision */
+    onDecision: (action: PermissionAction, feedback?: string) => void;
+    /** Optional custom content between description and buttons */
+    children?: React__default.ReactNode;
+    /** Optional: render a DiffView or code preview */
+    preview?: React__default.ReactNode;
+};
+declare function BashPermissionContent({ command }: {
+    command: string;
+}): React__default.ReactNode;
+declare function FileEditPermissionContent({ filename, diff, }: {
+    filename: string;
+    diff: string;
+}): React__default.ReactNode;
+declare function PermissionRequest({ toolName, description, details, showAlwaysAllow, onDecision, children, preview, }: PermissionRequestProps): React__default.ReactNode;
+
+type MessageContent = {
+    type: 'text';
+    text: string;
+} | {
+    type: 'tool_use';
+    toolName: string;
+    input: string;
+    result?: string;
+    status?: 'running' | 'success' | 'error';
+} | {
+    type: 'thinking';
+    text: string;
+    collapsed?: boolean;
+} | {
+    type: 'diff';
+    filename: string;
+    diff: string;
+} | {
+    type: 'code';
+    language?: string;
+    code: string;
+} | {
+    type: 'error';
+    message: string;
+    details?: string;
+};
+/**
+ * Display-oriented message type for rendering in the terminal UI.
+ *
+ * This type adds `id` and `timestamp` fields for UI purposes and supports
+ * rich `MessageContent[]` for rendering tool calls, diffs, code blocks, etc.
+ * It is distinct from the protocol-level `Message` type in
+ * `@claude-code-kit/agent`, which represents raw LLM conversation messages.
+ * The `useAgent` hook handles conversion between the two formats automatically.
+ */
 type Message = {
     id: string;
     role: 'user' | 'assistant' | 'system';
-    content: string;
+    content: string | MessageContent[];
     timestamp?: number;
 };
 type MessageListProps = {
@@ -308,18 +401,27 @@ type StreamingTextProps = {
 };
 declare function StreamingText({ text, speed, interval, onComplete, color, }: StreamingTextProps): React__default.ReactNode;
 
-type REPLCommand = {
+type REPLCommand$1 = {
     name: string;
     description: string;
     onExecute: (args: string) => void;
 };
+type PermissionRequestState = {
+    toolName: string;
+    description: string;
+    details?: string;
+    preview?: React__default.ReactNode;
+    onDecision: (action: PermissionAction) => void;
+};
 type REPLProps = {
     onSubmit: (message: string) => Promise<void> | void;
     onExit?: () => void;
     messages: Message[];
     isLoading?: boolean;
     streamingContent?: string | null;
-    commands?: REPLCommand[];
+    welcome?: React__default.ReactNode;
+    permissionRequest?: PermissionRequestState;
+    commands?: REPLCommand$1[];
     model?: string;
     statusSegments?: StatusLineSegment[];
     prefix?: string;
@@ -328,9 +430,9 @@ type REPLProps = {
     renderMessage?: (message: Message) => React__default.ReactNode;
     spinner?: React__default.ReactNode;
 };
-declare function REPL({ onSubmit, onExit, messages, isLoading, streamingContent, commands, model, statusSegments, prefix, placeholder, history: externalHistory, renderMessage, spinner, }: REPLProps): React__default.ReactNode;
+declare function REPL({ onSubmit, onExit, messages, isLoading, streamingContent, welcome, permissionRequest, commands, model, statusSegments, prefix, placeholder, history: externalHistory, renderMessage, spinner, }: REPLProps): React__default.ReactNode;
 
-type ThemeName = 'dark' | 'light';
+type ThemeName = 'dark' | 'light' | 'light-high-contrast' | 'dark-dimmed';
 type ThemeSetting = ThemeName | 'auto';
 type Theme = {
     text: string;
@@ -344,6 +446,28 @@ type Theme = {
     inactive: string;
     inverseText: string;
     permission: string;
+    diffAdded: string;
+    diffRemoved: string;
+    diffAddedWord: string;
+    diffRemovedWord: string;
+    diffHeader: string;
+    userMessage: string;
+    assistantMessage: string;
+    systemMessage: string;
+    toolUseMessage: string;
+    permissionAllow: string;
+    permissionDeny: string;
+    permissionAlways: string;
+    focus: string;
+    selection: string;
+    placeholder: string;
+    link: string;
+    code: string;
+    codeBackground: string;
+    blockquote: string;
+    info: string;
+    spinnerColor: string;
+    shimmer: string;
 };
 declare function getTheme(name: ThemeName): Theme;
 type Props$6 = {
@@ -669,4 +793,137 @@ declare function Byline({ children }: Props): React__default.ReactNode;
  */
 declare function color(c: keyof Theme | Color | undefined, theme: ThemeName, type?: ColorType): (text: string) => string;
 
-export { Byline, type Command$1 as Command, type CommandBase, type CommandOnDone, CommandRegistry, type CommandResult, DEFAULT_BINDINGS, Dialog, Divider, FuzzyPicker, type JSXCommand, KeybindingSetup, KeyboardShortcutHint, ListItem, LoadingState, type LocalCommand, Markdown, MarkdownTable, type Message, MessageList, type MessageListProps, MultiSelect, type MultiSelectProps, Pane, ProgressBar, PromptInput, REPL, type REPLProps, Ratchet, Select, type SelectOption, type SelectProps, Spinner, StatusIcon, StatusLine, type StatusLineProps, type StatusLineSegment, StreamingMarkdown, StreamingText, type StreamingTextProps, Tab, Tabs, type TerminalSize, TextHoverColorContext, type Theme, type ThemeName, ThemeProvider, type ThemeSetting, ThemedBox, type Props$5 as ThemedBoxProps, ThemedText, type Props$4 as ThemedTextProps, clearCommand, color, createCommandRegistry, defineCommand, defineJSXCommand, defineLocalCommand, exitCommand, getTheme, helpCommand, useDoublePress, useKeybinding, useKeybindings, usePreviewTheme, useStatusLine, useTabsWidth, useTerminalSize, useTheme, useThemeSetting };
+type VirtualScrollOptions = {
+    itemCount: number;
+    /** Lines per item (default: 3) */
+    estimatedItemHeight?: number;
+    /** Extra items rendered above/below the viewport (default: 20) */
+    overscan?: number;
+    /** Visible terminal rows */
+    viewportHeight: number;
+};
+type VirtualScrollResult = {
+    startIndex: number;
+    endIndex: number;
+    visibleItems: number;
+    totalHeight: number;
+    scrollOffset: number;
+    scrollTo: (index: number) => void;
+    scrollToEnd: () => void;
+    /** Adjust scroll by delta items (+1 = down, -1 = up) */
+    onScroll: (delta: number) => void;
+    isAtTop: boolean;
+    isAtEnd: boolean;
+};
+type VirtualListProps<T> = {
+    items: T[];
+    renderItem: (item: T, index: number) => ReactNode;
+    viewportHeight: number;
+    estimatedItemHeight?: number;
+    overscan?: number;
+};
+declare function useVirtualScroll(options: VirtualScrollOptions): VirtualScrollResult;
+declare function VirtualList<T>(props: VirtualListProps<T>): ReactNode;
+
+type SearchMatch = {
+    index: number;
+    offset: number;
+    length: number;
+};
+type SearchOverlayProps = {
+    isOpen: boolean;
+    onClose: () => void;
+    onSearch: (query: string) => SearchMatch[];
+    onNavigate: (match: SearchMatch) => void;
+    matchCount?: number;
+    currentMatch?: number;
+};
+type UseSearchResult = {
+    query: string;
+    matches: SearchMatch[];
+    currentIndex: number;
+    next: () => void;
+    previous: () => void;
+    setQuery: (q: string) => void;
+};
+type UseSearchOptions = {
+    content: string[];
+    isActive: boolean;
+};
+declare function useSearch({ content, isActive }: UseSearchOptions): UseSearchResult;
+declare function SearchOverlay({ isOpen, onClose, onSearch, onNavigate, }: SearchOverlayProps): React__default.ReactNode;
+
+type WelcomeScreenProps = {
+    appName: string;
+    subtitle?: string;
+    version?: string;
+    tips?: string[];
+    logo?: React__default.ReactNode;
+    model?: string;
+    color?: string;
+};
+declare function ClawdLogo({ color }: {
+    color?: string;
+}): React__default.ReactNode;
+declare function WelcomeScreen({ appName, subtitle, version, tips, logo, model, color, }: WelcomeScreenProps): React__default.ReactNode;
+
+type PermissionUIRequest = {
+    toolName: string;
+    description: string;
+    details?: string;
+    resolve: (decision: 'allow' | 'deny') => void;
+};
+type UseAgentOptions = {
+    agent: Agent;
+    onError?: (error: Error) => void;
+};
+type UseAgentResult = {
+    messages: Message[];
+    isLoading: boolean;
+    streamingContent: string | null;
+    permissionRequest: PermissionUIRequest | null;
+    submit: (input: string) => void;
+    cancel: () => void;
+    clearMessages: () => void;
+};
+declare function useAgent({ agent, onError }: UseAgentOptions): UseAgentResult;
+
+type AgentContextValue = UseAgentResult & {
+    agent: Agent;
+    model: string;
+};
+declare const AgentContext: React__default.Context<AgentContextValue | null>;
+type AgentProviderProps = {
+    agent: Agent;
+    model?: string;
+    onError?: (error: Error) => void;
+    children: React__default.ReactNode;
+};
+declare function AgentProvider({ agent, model, onError, children, }: AgentProviderProps): React__default.ReactNode;
+declare function useAgentContext(): AgentContextValue;
+
+type REPLCommand = {
+    name: string;
+    description: string;
+    onExecute: (args: string) => void;
+};
+type AgentREPLProps = {
+    agent: Agent;
+    model?: string;
+    commands?: REPLCommand[];
+    welcome?: React__default.ReactNode;
+    placeholder?: string;
+    onError?: (error: Error) => void;
+    onExit?: () => void;
+};
+declare function AgentREPL({ agent, model, commands, welcome, placeholder, onError, onExit, }: AgentREPLProps): React__default.ReactNode;
+
+type AuthFlowUIProps = {
+    auth: AuthRegistry;
+    onComplete: (provider: LLMProvider, providerName: string, model: string) => void;
+    onCancel?: () => void;
+    title?: string;
+};
+declare function AuthFlowUI({ auth, onComplete, onCancel, title, }: AuthFlowUIProps): React__default.ReactNode;
+
+export { AgentContext, type AgentContextValue, AgentProvider, type AgentProviderProps, AgentREPL, type AgentREPLProps, AuthFlowUI, type AuthFlowUIProps, BashPermissionContent, Byline, ClawdLogo, type Command$1 as Command, type CommandBase, type CommandOnDone, CommandRegistry, type CommandResult, DEFAULT_BINDINGS, Dialog, type DiffLine, DiffView, type DiffViewProps, Divider, FileEditPermissionContent, FuzzyPicker, type JSXCommand, KeybindingSetup, KeyboardShortcutHint, ListItem, LoadingState, type LocalCommand, Markdown, MarkdownTable, type Message, type MessageContent, MessageList, type MessageListProps, MultiSelect, type MultiSelectProps, Pane, type PermissionAction, PermissionRequest, type PermissionRequestProps, type PermissionUIRequest, ProgressBar, PromptInput, REPL, type REPLProps, Ratchet, type SearchMatch, SearchOverlay, type SearchOverlayProps, Select, type SelectOption, type SelectProps, Spinner, StatusIcon, StatusLine, type StatusLineProps, type StatusLineSegment, StreamingMarkdown, StreamingText, type StreamingTextProps, Tab, Tabs, type TerminalSize, TextHoverColorContext, type Theme, type ThemeName, ThemeProvider, type ThemeSetting, ThemedBox, type Props$5 as ThemedBoxProps, ThemedText, type Props$4 as ThemedTextProps, type UseAgentOptions, type UseAgentResult, type UseSearchResult, VirtualList, type VirtualListProps, type VirtualScrollOptions, type VirtualScrollResult, WelcomeScreen, type WelcomeScreenProps, clearCommand, color, createCommandRegistry, defineCommand, defineJSXCommand, defineLocalCommand, exitCommand, getTheme, helpCommand, parseUnifiedDiff, useAgent, useAgentContext, useDoublePress, useKeybinding, useKeybindings, usePreviewTheme, useSearch, useStatusLine, useTabsWidth, useTerminalSize, useTheme, useThemeSetting, useVirtualScroll };