@scenemesh/entity-engine-aimodule 1.0.0

package/dist/ui-index.d.mts

@@ -0,0 +1,627 @@
+import * as _ai_sdk_react from '@ai-sdk/react';
+import { useChat as useChat$1, useCompletion as useCompletion$1 } from '@ai-sdk/react';
+export { UseChatOptions as ChatOptions, UseChatHelpers as ChatReturn, UseCompletionOptions as CompletionOptions, UseCompletionHelpers as CompletionReturn, Experimental_UseObjectOptions as ObjectOptions, Experimental_UseObjectHelpers as ObjectReturn } from '@ai-sdk/react';
+import * as _ai_sdk_provider_utils from '@ai-sdk/provider-utils';
+import * as ai from 'ai';
+import { UIMessage, DataUIPart, FileUIPart } from 'ai';
+export { DataUIPart, DefaultChatTransport, FileUIPart, TextStreamChatTransport, TextUIPart, ToolResultPart, UIMessage, UIMessagePart, convertToModelMessages, createUIMessageStream, createUIMessageStreamResponse, lastAssistantMessageIsCompleteWithToolCalls, readUIMessageStream } from 'ai';
+import * as zod from 'zod';
+import { z } from 'zod';
+import * as zod_v4_core from 'zod/v4/core';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import React$1 from 'react';
+
+/**
+ * Entity Engine AI - useChat Hook
+ *
+ * Official AI SDK useChat Hook implementation
+ * Fully compatible with AI SDK API
+ */
+
+declare const useChat: typeof useChat$1;
+
+/**
+ * Entity Engine AI - useObject Hook
+ *
+ * Official AI SDK experimental_useObject Hook implementation
+ * Strict compliance with official specifications
+ */
+/**
+ * useObject Hook
+ * Based on official AI SDK experimental_useObject
+ */
+declare const useObject: <SCHEMA extends zod_v4_core.$ZodType | zod.ZodType | ai.Schema, RESULT = _ai_sdk_provider_utils.InferSchema<SCHEMA>, INPUT = any>({ api, id, schema, initialValue, fetch, onError, onFinish, headers, credentials, }: _ai_sdk_react.Experimental_UseObjectOptions<SCHEMA, RESULT>) => _ai_sdk_react.Experimental_UseObjectHelpers<RESULT, INPUT>;
+
+/**
+ * Entity Engine AI - useCompletion Hook
+ *
+ * Official AI SDK useCompletion Hook implementation
+ * Strict compliance with official specifications
+ */
+
+/**
+ * useCompletion Hook
+ * Based on official AI SDK useCompletion implementation
+ */
+declare const useCompletion: typeof useCompletion$1;
+
+/**
+ * Entity Engine AI - Complete Type Definitions
+ *
+ * Complete type system for AI integration
+ * 确保所有功能的类型安全性
+ */
+
+/**
+ * Standard UI message types
+ * 不添加任何非标准字段，确保完全兼容
+ */
+type StandardUIMessage = UIMessage;
+/**
+ * 消息角色类型
+ */
+type MessageRole = 'system' | 'user' | 'assistant';
+/**
+ * 消息状态类型
+ */
+type MessageStatus = 'submitted' | 'streaming' | 'ready' | 'error';
+/**
+ * Tool call status types
+ * 支持流式工具调用的完整状态，包括input-streaming
+ */
+type ToolCallState = 'input-streaming' | 'input-available' | 'output-available' | 'output-error';
+/**
+ * 工具类型定义
+ */
+interface ToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: z.ZodSchema;
+    type: 'server-side' | 'client-side' | 'user-interaction';
+}
+/**
+ * 工具执行结果
+ */
+interface ToolExecutionResult {
+    toolCallId: string;
+    toolName: string;
+    result: any;
+    error?: string;
+    executionTime?: number;
+}
+/**
+ * 用户交互工具选项
+ */
+interface UserInteractionToolOptions {
+    title: string;
+    description?: string;
+    actions: Array<{
+        label: string;
+        value: any;
+        variant?: 'default' | 'destructive' | 'outline' | 'secondary';
+    }>;
+}
+/**
+ * Chat configuration options
+ */
+interface ChatOptions<TMessage extends StandardUIMessage = StandardUIMessage> {
+    /** 聊天ID */
+    id?: string;
+    /** 初始消息 */
+    initialMessages?: TMessage[];
+    /** Transport configuration */
+    transport?: any;
+    /** API端点 - 向后兼容 */
+    api?: string;
+    /** 请求头 - 向后兼容 */
+    headers?: Record<string, string> | (() => Record<string, string>);
+    /** 请求体 - 向后兼容 */
+    body?: Record<string, any> | (() => Record<string, any>);
+    /** 凭据模式 - 向后兼容 */
+    credentials?: RequestCredentials;
+    /** 工具调用回调 */
+    onToolCall?: (options: {
+        toolCall: any;
+    }) => void | Promise<void>;
+    /** 自动发送条件 */
+    sendAutomaticallyWhen?: (options: {
+        messages: TMessage[];
+    }) => boolean | PromiseLike<boolean>;
+    /** 完成回调 */
+    onFinish?: (options: {
+        message: TMessage;
+        messages: TMessage[];
+        isAbort: boolean;
+        isDisconnect: boolean;
+        isError: boolean;
+    }) => void;
+    /** 错误回调 */
+    onError?: (error: Error) => void;
+    /** 数据回调 */
+    onData?: (dataPart: DataUIPart<any>) => void;
+    /** UI更新节流 */
+    experimental_throttle?: number;
+    /** 是否恢复流 */
+    resume?: boolean;
+    /** 视图控制器实例 - 支持客户端工具调用 */
+    viewController?: any;
+}
+/**
+ * 聊天对话框属性 - 扩展支持更多UI功能
+ */
+interface ChatDialogProps {
+    /** 聊天选项 */
+    chatOptions?: ChatOptions;
+    /** 对话框标题 */
+    title?: string;
+    /** 对话框描述 */
+    description?: string;
+    /** 是否打开 */
+    open?: boolean;
+    /** 打开状态变化回调 */
+    onOpenChange?: (open: boolean) => void;
+    /** 输入框占位符 */
+    placeholder?: string;
+    /** 自定义样式类 */
+    className?: string;
+    /** 是否显示头部 */
+    showHeader?: boolean;
+    /** 是否允许文件上传 */
+    allowFileUpload?: boolean;
+    /** 接受的文件类型 */
+    acceptedFileTypes?: string[];
+    /** 最大文件大小 */
+    maxFileSize?: number;
+    /** 工具渲染器 */
+    toolRenderers?: Record<string, React.ComponentType<any>>;
+    /** 消息渲染器 */
+    messageRenderer?: React.ComponentType<any>;
+    /** 主题配置 */
+    theme?: ThemeConfig | string;
+    /** 启用推理显示 */
+    enableReasoning?: boolean;
+    /** 启用生成式UI */
+    enableGenerativeUI?: boolean;
+    /** 默认显示推理 */
+    showReasoningByDefault?: boolean;
+    /** 页面上下文信息 */
+    pageContext?: any;
+}
+/**
+ * 消息气泡属性 - 扩展支持更多显示选项
+ */
+interface MessageBubbleProps {
+    /** 消息对象 */
+    message: UIMessage;
+    /** 是否显示头像 */
+    showAvatar?: boolean;
+    /** 是否显示时间戳 */
+    showTimestamp?: boolean;
+    /** 工具结果回调 */
+    onToolResult?: (result: any) => void;
+    /** 启用推理显示 */
+    enableReasoning?: boolean;
+    /** 启用生成式UI */
+    enableGenerativeUI?: boolean;
+    /** 默认显示推理 */
+    showReasoningByDefault?: boolean;
+}
+/**
+ * 文件查看器属性
+ */
+interface FileViewerProps {
+    /** 文件对象 */
+    file: FileUIPart;
+    /** 是否显示下载按钮 */
+    showDownload?: boolean;
+    /** 是否显示删除按钮 */
+    showRemove?: boolean;
+    /** 删除回调 */
+    onRemove?: (file: FileUIPart) => void;
+    /** 自定义样式类 */
+    className?: string;
+}
+/**
+ * 自定义Transport配置
+ */
+interface CustomTransportOptions {
+    /** API端点 */
+    api?: string;
+    /** 请求头 */
+    headers?: Record<string, string> | (() => Record<string, string>);
+    /** 请求体 */
+    body?: Record<string, any> | (() => Record<string, any>);
+    /** 凭据模式 */
+    credentials?: RequestCredentials | (() => RequestCredentials);
+    /** 请求准备函数 */
+    prepareSendMessagesRequest?: (options: any) => any;
+    /** 重连请求准备函数 */
+    prepareReconnectToStreamRequest?: (options: any) => any;
+}
+/**
+ * 自定义数据部分类型
+ */
+interface CustomDataParts {
+    /** 天气数据 */
+    weather: {
+        city: string;
+        weather?: string;
+        temperature?: number;
+        status: 'loading' | 'success' | 'error';
+    };
+    /** 通知数据 */
+    notification: {
+        message: string;
+        level: 'info' | 'warning' | 'error' | 'success';
+        duration?: number;
+    };
+    /** 进度数据 */
+    progress: {
+        current: number;
+        total: number;
+        label?: string;
+    };
+    /** 状态数据 */
+    status: {
+        type: 'processing' | 'complete' | 'error' | 'cancelled';
+        message: string;
+        details?: any;
+    };
+}
+/**
+ * 扩展的UI消息类型，包含自定义数据部分
+ */
+type CustomUIMessage = UIMessage;
+/**
+ * 扩展的UI消息类型 - 向后兼容
+ */
+type ExtendedUIMessage = UIMessage;
+/**
+ * 主题配置
+ */
+interface ThemeConfig {
+    /** 主题模式 */
+    mode: 'light' | 'dark' | 'system';
+    /** 主色调 */
+    primaryColor?: string;
+    /** 圆角大小 */
+    borderRadius?: 'none' | 'sm' | 'md' | 'lg' | 'xl';
+    /** 字体族 */
+    fontFamily?: string;
+    /** 动画持续时间 */
+    animationDuration?: 'fast' | 'normal' | 'slow';
+}
+/**
+ * 样式变体
+ */
+interface StyleVariants {
+    /** 消息气泡变体 */
+    messageBubble?: 'default' | 'minimal' | 'rounded' | 'bordered';
+    /** 输入框变体 */
+    inputField?: 'default' | 'filled' | 'outlined' | 'underlined';
+    /** 按钮变体 */
+    button?: 'default' | 'ghost' | 'outline' | 'solid';
+}
+/**
+ * 聊天事件类型
+ */
+interface ChatEvents {
+    /** 消息发送 */
+    'message:sent': {
+        message: UIMessage;
+    };
+    /** 消息接收 */
+    'message:received': {
+        message: UIMessage;
+    };
+    /** 工具调用 */
+    'tool:called': {
+        toolName: string;
+        input: any;
+    };
+    /** 工具结果 */
+    'tool:result': {
+        toolName: string;
+        output: any;
+    };
+    /** 错误发生 */
+    'error:occurred': {
+        error: Error;
+    };
+    /** 流开始 */
+    'stream:started': {
+        timestamp: number;
+    };
+    /** 流结束 */
+    'stream:ended': {
+        timestamp: number;
+        duration: number;
+    };
+}
+
+/**
+ * Main chat dialog component
+ */
+declare function ChatDialog({ chatOptions, title, description, open, onOpenChange, placeholder, className, showHeader, allowFileUpload, acceptedFileTypes, maxFileSize, // 10MB
+messageRenderer, theme, enableReasoning, enableGenerativeUI, showReasoningByDefault, }: ChatDialogProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * 文件查看器组件
+ */
+declare function FileViewer({ file, showDownload, showRemove, onRemove, className, }: FileViewerProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Message bubble component with hybrid architecture implementation
+ *
+ * Supports two rendering modes:
+ * 1. 静态工具模式：tool-${toolName} → 使用GenerativeUI组件
+ * 2. 动态工具模式：dynamic-tool → 使用DynamicUI组件
+ *
+ * Standard state handling and naming conventions
+ */
+declare function MessageBubble({ message, showAvatar, // 不再使用头像
+showTimestamp, onToolResult, enableReasoning, enableGenerativeUI, showReasoningByDefault }: MessageBubbleProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * 🎨 预置生成式UI组件
+ *
+ * Pure component definitions without registration system
+ * Reference: Generative User Interfaces documentation
+ * 实现原理：直接导入使用，不再使用动态注册系统
+ */
+
+interface WeatherProps {
+    temperature?: number;
+    weather?: string;
+    location?: string;
+    humidity?: number;
+    windSpeed?: number;
+}
+declare const WeatherComponent: React$1.FC<WeatherProps>;
+interface LocationProps {
+    city?: string;
+    country?: string;
+    province?: string;
+    coordinates?: {
+        lat: number;
+        lng: number;
+    };
+    timezone?: string;
+    population?: number;
+    area?: number;
+}
+declare const LocationComponent: React$1.FC<LocationProps>;
+interface CodeExecutionProps {
+    code?: string;
+    language?: string;
+    output?: string;
+    status?: 'success' | 'error' | 'running';
+}
+declare const CodeExecutionComponent: React$1.FC<CodeExecutionProps>;
+
+interface DynamicToolPartProps {
+    toolName: string;
+    input: any;
+    output: any;
+    state: 'input-streaming' | 'input-available' | 'output-available' | 'output-error';
+}
+declare function DynamicToolRenderer({ toolName, input, output, state }: DynamicToolPartProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Entity Engine Integrated Dynamic Components
+ *
+ * Uses Entity Engine standard components for dynamic rendering
+ * 专注于grid和form视图的集成，无冗余逻辑
+ */
+
+interface DynamicEntityComponentProps {
+    toolName: string;
+    modelName?: string;
+    displayMode?: string;
+    data?: any[];
+    totalCount?: number;
+    pagination?: {
+        pageSize: number;
+        pageIndex: number;
+        totalPages: number;
+        hasNextPage: boolean;
+        hasPreviousPage: boolean;
+    };
+    query?: {
+        sortBy?: Record<string, 'asc' | 'desc'>;
+        filters?: Record<string, any>;
+    };
+    executedAt?: string;
+    toolCallId?: string;
+    _renderHint?: {
+        componentType: string;
+        preferredLayout?: string;
+        features?: string[];
+        dataSchema?: string[];
+        capabilities?: string[];
+    };
+}
+interface DynamicEntityGridProps extends DynamicEntityComponentProps {
+    displayMode?: 'table' | 'grid';
+}
+declare const DynamicEntityGridComponent: React$1.FC<DynamicEntityGridProps>;
+interface DynamicEntityFormProps extends DynamicEntityComponentProps {
+    baseObjectId?: string;
+    mode?: 'display' | 'edit';
+    toCreating?: boolean;
+}
+interface DynamicEntityKanbanProps extends DynamicEntityComponentProps {
+    displayMode?: 'kanban';
+}
+interface DynamicEntityDashboardProps extends DynamicEntityComponentProps {
+    displayMode?: 'dashboard';
+}
+interface DynamicEntityMastailProps extends DynamicEntityComponentProps {
+    displayMode?: 'mastail';
+    baseObjectId?: string;
+}
+declare const DynamicEntityFormComponent: React$1.FC<DynamicEntityFormProps>;
+declare const DynamicEntityKanbanComponent: React$1.FC<DynamicEntityKanbanProps>;
+declare const DynamicEntityDashboardComponent: React$1.FC<DynamicEntityDashboardProps>;
+declare const DynamicEntityMastailComponent: React$1.FC<DynamicEntityMastailProps>;
+interface DynamicErrorDisplayProps extends DynamicEntityComponentProps {
+    error: string;
+    errorDetails?: string;
+    errorType?: string;
+}
+declare const ENTITY_DYNAMIC_COMPONENTS: {
+    readonly DynamicDataTable: React$1.FC<DynamicEntityGridProps>;
+    readonly DynamicDataGrid: React$1.FC<DynamicEntityGridProps>;
+    readonly DynamicDataList: React$1.FC<DynamicEntityGridProps>;
+    readonly DynamicEntityForm: React$1.FC<DynamicEntityFormProps>;
+    readonly DynamicEntityKanban: React$1.FC<DynamicEntityKanbanProps>;
+    readonly DynamicEntityDashboard: React$1.FC<DynamicEntityDashboardProps>;
+    readonly DynamicEntityMastail: React$1.FC<DynamicEntityMastailProps>;
+    readonly DynamicErrorDisplay: React$1.FC<DynamicErrorDisplayProps>;
+};
+
+/**
+ * Entity Engine AI - Utility Functions
+ *
+ * Collection of utility functions for common operations
+ */
+
+/**
+ * Extract text content from message
+ */
+declare function extractMessageText(message: ExtendedUIMessage): string;
+/**
+ * Check if message contains tool calls
+ */
+declare function hasToolCalls(message: ExtendedUIMessage): boolean;
+/**
+ * Get tool calls list from message
+ */
+declare function getToolCalls(message: ExtendedUIMessage): Array<{
+    toolName: string;
+    state: string;
+    input?: any;
+    output?: any;
+}>;
+/**
+ * Check if message contains file attachments
+ */
+declare function hasFileAttachments(message: ExtendedUIMessage): boolean;
+/**
+ * Get file attachments list from message
+ */
+declare function getFileAttachments(message: ExtendedUIMessage): any[];
+/**
+ * Format timestamp
+ */
+declare function formatTimestamp(timestamp?: number, options?: {
+    format?: 'short' | 'long' | 'relative';
+    includeDate?: boolean;
+}): string;
+/**
+ * Format relative time
+ */
+declare function formatRelativeTime(timestamp: number): string;
+/**
+ * Format file size
+ */
+declare function formatFileSize(bytes: number): string;
+/**
+ * Get file extension
+ */
+declare function getFileExtension(filename: string): string;
+/**
+ * Check if file type is accepted
+ */
+declare function isFileTypeAccepted(file: File, acceptedTypes: string[]): boolean;
+/**
+ * Create file URL
+ */
+declare function createFileUrl(file: File): string;
+/**
+ * Revoke file URL
+ */
+declare function revokeFileUrl(url: string): void;
+/**
+ * Truncate text
+ */
+declare function truncateText(text: string, maxLength: number): string;
+/**
+ * Highlight search terms
+ */
+declare function highlightSearchTerms(text: string, searchTerms: string[]): string;
+/**
+ * Convert camelCase to space-separated
+ */
+declare function camelToSpaced(str: string): string;
+/**
+ * Check if string is valid URL
+ */
+declare function isValidUrl(string: string): boolean;
+/**
+ * Check if string is valid JSON
+ */
+declare function isValidJson(string: string): boolean;
+/**
+ * Safe JSON parse
+ */
+declare function safeJsonParse<T>(string: string, fallback: T): T;
+/**
+ * Combine CSS class names (simplified clsx)
+ */
+declare function cn(...classes: (string | undefined | null | false)[]): string;
+/**
+ * Safely execute async function
+ */
+declare function safeAsync<T>(fn: () => Promise<T>, fallback?: T): Promise<{
+    data?: T;
+    error?: Error;
+}>;
+/**
+ * Create error message
+ */
+declare function createErrorMessage(error: unknown): string;
+/**
+ * Debounce function
+ */
+declare function debounce<T extends (...args: any[]) => any>(func: T, delay: number): (...args: Parameters<T>) => void;
+/**
+ * Throttle function
+ */
+declare function throttle<T extends (...args: any[]) => any>(func: T, delay: number): (...args: Parameters<T>) => void;
+/**
+ * Safe localStorage operations
+ */
+declare const storage: {
+    get<T>(key: string, fallback?: T): T | null;
+    set<T>(key: string, value: T): boolean;
+    remove(key: string): boolean;
+    clear(): boolean;
+};
+
+/**
+ * 🎯 Entity Engine AIUI - Main Export
+ *
+ * Complete AI SDK UI implementation with dialog-style interface
+ * 基于AI SDK官方规范的完整前端UI包主入口
+ */
+
+declare const version = "1.0.0";
+declare const packageName = "entity-engine-aiui";
+
+/**
+ * Default export containing all main functionality
+ * Components are loaded dynamically to avoid server-side React imports
+ */
+declare const EntityEngineAIUI: {
+    readonly useChat: any;
+    readonly useCompletion: any;
+    readonly useObject: any;
+    readonly ChatDialog: any;
+    readonly MessageBubble: any;
+    readonly FileViewer: any;
+    version: string;
+    packageName: string;
+};
+
+export { ChatDialog, type ChatDialogProps, type ChatEvents, CodeExecutionComponent, type CustomDataParts, type CustomTransportOptions, type CustomUIMessage, DynamicEntityDashboardComponent, DynamicEntityFormComponent, DynamicEntityGridComponent, DynamicEntityKanbanComponent, DynamicEntityMastailComponent, DynamicToolRenderer, ENTITY_DYNAMIC_COMPONENTS, type ExtendedUIMessage, FileViewer, type FileViewerProps, LocationComponent, MessageBubble, type MessageBubbleProps, type MessageRole, type MessageStatus, type StyleVariants, type ThemeConfig, type ToolCallState, type ToolDefinition, type ToolExecutionResult, type UserInteractionToolOptions, WeatherComponent, camelToSpaced, cn, createErrorMessage, createFileUrl, debounce, EntityEngineAIUI as default, extractMessageText, formatFileSize, formatRelativeTime, formatTimestamp, getFileAttachments, getFileExtension, getToolCalls, hasFileAttachments, hasToolCalls, highlightSearchTerms, isFileTypeAccepted, isValidJson, isValidUrl, packageName, revokeFileUrl, safeAsync, safeJsonParse, storage, throttle, truncateText, useChat, useCompletion, useObject, version };