@huyooo/ai-chat-frontend-react 0.1.2

package/dist/index.d.ts

@@ -0,0 +1,401 @@
+import { FC, ReactNode } from 'react';
+
+/**
+ * AI Chat 前端类型定义
+ * 与 Vue 版本保持一致
+ */
+/** 搜索结果 */
+interface SearchResult {
+    title: string;
+    url: string;
+    snippet: string;
+}
+/** 工具调用 */
+interface ToolCall {
+    name: string;
+    args?: Record<string, unknown>;
+    result?: string;
+    status: 'running' | 'success' | 'error';
+}
+/** 模型提供商 */
+type ModelProvider = 'openrouter' | 'doubao' | 'deepseek' | 'qwen' | 'gemini' | 'ark';
+/** 模型配置 */
+interface ModelConfig {
+    provider: ModelProvider;
+    model: string;
+    displayName: string;
+    supportsTools: boolean;
+    supportsWebSearch: boolean;
+    supportedThinkingModes: ThinkingMode[];
+}
+/** 思考模式 */
+type ThinkingMode = 'enabled' | 'disabled';
+/** 聊天模式 */
+type ChatMode = 'agent' | 'ask';
+/** 聊天消息 */
+interface ChatMessage {
+    id: string;
+    role: 'user' | 'assistant';
+    content: string;
+    images?: string[];
+    thinking?: string;
+    thinkingComplete?: boolean;
+    searchResults?: SearchResult[];
+    searching?: boolean;
+    toolCalls?: ToolCall[];
+    copied?: boolean;
+    loading?: boolean;
+    timestamp?: Date;
+}
+/** 会话记录 */
+interface SessionRecord {
+    id: string;
+    title: string;
+    model: string;
+    mode: ChatMode;
+    createdAt: Date;
+    updatedAt: Date;
+}
+/** 消息记录 */
+interface MessageRecord {
+    id: string;
+    sessionId: string;
+    role: 'user' | 'assistant';
+    content: string;
+    thinking?: string;
+    toolCalls?: string;
+    searchResults?: string;
+    timestamp: Date;
+}
+/** 默认模型列表 */
+declare const DEFAULT_MODELS: ModelConfig[];
+/** @deprecated 使用 SessionRecord */
+interface ChatSession {
+    id: string;
+    title: string;
+    messages: ChatMessage[];
+    createdAt: Date;
+    updatedAt: Date;
+}
+/** 音视频操作类型 */
+interface MediaOperation {
+    id: string;
+    type: 'clip' | 'transcode' | 'merge' | 'extract_audio' | 'add_subtitle' | 'analyze';
+    description: string;
+    sourceFiles: string[];
+    targetFile?: string;
+    parameters?: Record<string, unknown>;
+    status?: 'pending' | 'applied' | 'rejected';
+    preview?: string;
+}
+/** @deprecated 使用字符串枚举 */
+type AiModel = 'gemini-3-pro-preview' | 'gemini-3-pro-image-preview';
+declare enum FileType {
+    FOLDER = "folder",
+    IMAGE = "image",
+    VIDEO = "video",
+    AUDIO = "audio",
+    TEXT = "text",
+    PDF = "pdf",
+    CODE = "code",
+    ARCHIVE = "archive",
+    OTHER = "other"
+}
+interface DiffStat {
+    file: string;
+    additions: number;
+    deletions: number;
+    type: 'modified' | 'added' | 'deleted';
+}
+
+/**
+ * Chat Adapter 接口定义
+ * 解耦前端组件与后端通信方式
+ *
+ * 与 Vue 版本保持一致
+ */
+
+/** 聊天进度类型 */
+type ChatProgressType = 'thinking' | 'search_start' | 'search_result' | 'tool_call' | 'tool_result' | 'text_delta' | 'text' | 'done' | 'error';
+/** 思考数据 */
+interface ThinkingData {
+    content: string;
+    isComplete: boolean;
+}
+/** 工具调用数据 */
+interface ToolCallData {
+    name: string;
+    args: Record<string, unknown>;
+}
+/** 工具结果数据 */
+interface ToolResultData {
+    name: string;
+    result: string;
+}
+/** 图片数据 */
+interface ImageData {
+    base64: string;
+    mimeType: string;
+}
+/** 聊天进度事件 */
+interface ChatProgress {
+    type: ChatProgressType;
+    data: string | ThinkingData | ToolCallData | ToolResultData | {
+        results: SearchResult[];
+    };
+}
+/** 发送消息选项 */
+interface SendMessageOptions {
+    mode: ChatMode;
+    model: string;
+    enableWebSearch: boolean;
+    thinkingMode: ThinkingMode;
+}
+/** 创建会话选项 */
+interface CreateSessionOptions {
+    title: string;
+    model: string;
+    mode: ChatMode;
+}
+/** 更新会话选项 */
+interface UpdateSessionOptions {
+    title?: string;
+    model?: string;
+    mode?: ChatMode;
+}
+/** 保存消息选项 */
+interface SaveMessageOptions {
+    sessionId: string;
+    role: 'user' | 'assistant';
+    content: string;
+    thinking?: string;
+    toolCalls?: string;
+    searchResults?: string;
+}
+/**
+ * Chat Adapter 接口
+ * 所有后端通信实现都需要实现此接口
+ */
+interface ChatAdapter {
+    /** 获取所有会话 */
+    getSessions(): Promise<SessionRecord[]>;
+    /** 创建新会话 */
+    createSession(options: CreateSessionOptions): Promise<SessionRecord>;
+    /** 更新会话 */
+    updateSession(sessionId: string, options: UpdateSessionOptions): Promise<void>;
+    /** 删除会话 */
+    deleteSession(sessionId: string): Promise<void>;
+    /** 获取会话消息 */
+    getMessages(sessionId: string): Promise<MessageRecord[]>;
+    /** 保存消息 */
+    saveMessage(options: SaveMessageOptions): Promise<MessageRecord>;
+    /** 发送消息并获取流式响应 */
+    sendMessage(content: string, options: SendMessageOptions, images?: string[]): AsyncGenerator<ChatProgress, void, unknown>;
+    /** 取消当前请求 */
+    cancel(): void;
+    /** 设置工作目录 */
+    setWorkingDir?(dir: string): void;
+}
+/**
+ * 创建空 Adapter（用于测试或无后端场景）
+ */
+declare function createNullAdapter(): ChatAdapter;
+
+/**
+ * useChat Hook
+ * 管理聊天状态和与后端的通信
+ * 使用 Adapter 模式解耦后端通信
+ *
+ * 与 Vue 版本 useChat composable 保持一致
+ */
+
+interface UseChatOptions {
+    /** Adapter 实例 */
+    adapter?: ChatAdapter;
+    /** 默认模型 */
+    defaultModel?: string;
+    /** 默认模式 */
+    defaultMode?: ChatMode;
+}
+/**
+ * 聊天状态管理 Hook
+ */
+declare function useChat(options?: UseChatOptions): {
+    sessions: SessionRecord[];
+    currentSessionId: string | null;
+    messages: ChatMessage[];
+    isLoading: boolean;
+    mode: ChatMode;
+    model: string;
+    webSearch: boolean;
+    thinking: boolean;
+    loadSessions: () => Promise<void>;
+    switchSession: (sessionId: string) => Promise<void>;
+    createNewSession: () => Promise<void>;
+    deleteSession: (sessionId: string) => Promise<void>;
+    deleteCurrentSession: () => Promise<void>;
+    sendMessage: (text: string, images?: string[]) => Promise<void>;
+    cancelRequest: () => void;
+    copyMessage: (messageId: string) => Promise<void>;
+    regenerateMessage: (messageIndex: number) => void;
+    setMode: (value: ChatMode) => void;
+    setModel: (value: string) => void;
+    setWebSearch: (value: boolean) => void;
+    setThinking: (value: boolean) => void;
+    setWorkingDirectory: (dir: string) => void;
+};
+
+/**
+ * ChatPanel Component
+ * 与 Vue 版本 ChatPanel.vue 保持一致
+ */
+
+interface ChatPanelProps {
+    /** Adapter 实例 */
+    adapter?: ChatAdapter;
+    /** 工作目录 */
+    workingDir?: string;
+    /** 默认模型 */
+    defaultModel?: string;
+    /** 默认模式 */
+    defaultMode?: ChatMode;
+    /** 可用模型列表 */
+    models?: ModelConfig[];
+    /** 隐藏标题栏 */
+    hideHeader?: boolean;
+    /** 关闭回调（有此属性时显示关闭按钮） */
+    onClose?: () => void;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义 Markdown 渲染器 */
+    renderMarkdown?: (content: string) => ReactNode;
+}
+declare const ChatPanel: FC<ChatPanelProps>;
+
+/**
+ * ChatInput Component
+ * 与 Vue 版本 ChatInput.vue 保持一致
+ */
+
+interface ChatInputProps {
+    /** 变体模式：input-底部输入框，message-历史消息 */
+    variant?: 'input' | 'message';
+    /** 受控值（用于历史消息编辑） */
+    value?: string;
+    selectedImages?: string[];
+    isLoading?: boolean;
+    mode?: ChatMode;
+    model?: string;
+    models?: ModelConfig[];
+    webSearchEnabled?: boolean;
+    thinkingEnabled?: boolean;
+    onSend?: (text: string) => void;
+    onRemoveImage?: (index: number) => void;
+    onCancel?: () => void;
+    onUploadImage?: () => void;
+    onAtContext?: () => void;
+    onModeChange?: (mode: ChatMode) => void;
+    onModelChange?: (model: string) => void;
+    onWebSearchChange?: (enabled: boolean) => void;
+    onThinkingChange?: (enabled: boolean) => void;
+}
+declare const ChatInput: FC<ChatInputProps>;
+
+/**
+ * ChatHeader Component
+ * 与 Vue 版本 ChatHeader.vue 保持一致
+ */
+
+interface ChatHeaderProps {
+    /** 当前会话列表 */
+    sessions: SessionRecord[];
+    /** 当前会话 ID */
+    currentSessionId?: string | null;
+    /** 是否显示关闭按钮 */
+    showClose?: boolean;
+    /** 创建新会话 */
+    onNewSession?: () => void;
+    /** 切换会话 */
+    onSwitchSession?: (sessionId: string) => void;
+    /** 删除会话 */
+    onDeleteSession?: (sessionId: string) => void;
+    /** 关闭面板 */
+    onClose?: () => void;
+    /** 清空所有对话 */
+    onClearAll?: () => void;
+    /** 关闭其他对话 */
+    onCloseOthers?: () => void;
+    /** 导出对话 */
+    onExport?: () => void;
+    /** 复制请求 ID */
+    onCopyId?: () => void;
+    /** 反馈 */
+    onFeedback?: () => void;
+    /** Agent 设置 */
+    onSettings?: () => void;
+}
+declare const ChatHeader: FC<ChatHeaderProps>;
+
+/**
+ * WelcomeMessage Component
+ * 与 Vue 版本 WelcomeMessage.vue 保持一致
+ */
+
+interface WelcomeMessageProps {
+    /** 快捷操作回调 */
+    onQuickAction: (text: string) => void;
+}
+declare const WelcomeMessage: FC<WelcomeMessageProps>;
+
+/**
+ * MessageBubble Component
+ * 与 Vue 版本 MessageBubble.vue 保持一致
+ */
+
+interface MessageBubbleProps {
+    role: 'user' | 'assistant';
+    content: string;
+    images?: string[];
+    thinking?: string;
+    thinkingComplete?: boolean;
+    thinkingDuration?: number;
+    searchResults?: SearchResult[];
+    searching?: boolean;
+    toolCalls?: ToolCall[];
+    copied?: boolean;
+    loading?: boolean;
+    onCopy?: () => void;
+    onRegenerate?: () => void;
+    /** 编辑用户消息后重新发送 */
+    onSend?: (text: string) => void;
+    /** 自定义 Markdown 渲染器 */
+    renderMarkdown?: (content: string) => ReactNode;
+}
+declare const MessageBubble: FC<MessageBubbleProps>;
+
+/**
+ * ExecutionSteps Component
+ * 与 Vue 版本 ExecutionSteps.vue 保持一致
+ */
+
+interface ExecutionStepsProps {
+    /** 是否正在加载 */
+    loading?: boolean;
+    /** 是否有消息内容 */
+    hasContent?: boolean;
+    /** 思考内容 */
+    thinking?: string;
+    /** 思考是否完成 */
+    thinkingComplete?: boolean;
+    /** 思考耗时 */
+    thinkingDuration?: number;
+    /** 是否正在搜索 */
+    searching?: boolean;
+    /** 搜索结果 */
+    searchResults?: SearchResult[];
+    /** 工具调用列表 */
+    toolCalls?: ToolCall[];
+}
+declare const ExecutionSteps: FC<ExecutionStepsProps>;
+
+export { type AiModel, type ChatAdapter, ChatHeader, ChatInput, type ChatMessage, type ChatMode, ChatPanel, type ChatProgress, type ChatProgressType, type ChatSession, type CreateSessionOptions, DEFAULT_MODELS, type DiffStat, ExecutionSteps, FileType, type ImageData, type MediaOperation, MessageBubble, type MessageRecord, type ModelConfig, type ModelProvider, type SaveMessageOptions, type SearchResult, type SendMessageOptions, type SessionRecord, type ThinkingData, type ThinkingMode, type ToolCall, type ToolCallData, type ToolResultData, type UpdateSessionOptions, type UseChatOptions, WelcomeMessage, createNullAdapter, useChat };