@oakkles/llm-ui-react 0.1.1

package/dist/index.d.cts

@@ -0,0 +1,431 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode, CSSProperties, RefObject } from 'react';
+
+type LLMRole = 'user' | 'assistant' | 'system';
+type messageStatus = 'sending' | 'sent' | 'error';
+
+interface BubblePrimitiveProps {
+    /** 消息角色，决定气泡的语义与布局方向 */
+    role: LLMRole;
+    /** 文本内容；如果传入 children，则通常由 children 接管渲染 */
+    content?: string;
+    /** 头像插槽，可传入图片、图标或自定义节点 */
+    avatar?: ReactNode;
+    /** 时间戳，可传入格式化后的字符串或 Date 对象 */
+    timestamp?: Date | string;
+    /** 消息发送状态，用于渲染发送中、已发送、错误等语义状态 */
+    status?: messageStatus;
+    /** 是否处于加载中，常用于 assistant 消息的等待动画 */
+    loading?: boolean;
+    /** 自定义内容插槽，优先级高于 content */
+    children?: ReactNode;
+    /** 消息下方操作区插槽 */
+    actions?: ReactNode;
+    /** 最外层元素类名，供 Styled 层或使用者覆盖 */
+    className?: string;
+    /** 最外层元素内联样式 */
+    style?: CSSProperties;
+}
+declare function BubblePrimitive({ role, content, avatar, timestamp, status, loading, children, actions, className, style, }: BubblePrimitiveProps): react_jsx_runtime.JSX.Element;
+
+type BubbleProps = BubblePrimitiveProps;
+declare function Bubble({ className, ...props }: BubbleProps): react_jsx_runtime.JSX.Element;
+
+interface MarkPrimitiveProps {
+    content: string;
+    streaming?: boolean;
+    onComplete?: () => void;
+    className?: string;
+}
+declare function MarkPrimitive({ content, streaming, className, }: MarkPrimitiveProps): react_jsx_runtime.JSX.Element;
+
+type MarkProps = MarkPrimitiveProps;
+declare function Mark({ className, ...props }: MarkProps): react_jsx_runtime.JSX.Element;
+
+interface CodeHighlighterPrimitiveProps {
+    code: string;
+    copyable?: boolean;
+    language?: string;
+    showLineNumbers?: boolean;
+    startingLineNumber?: number;
+    className?: string;
+}
+declare function CodeHighlighterPrimitive({ code, copyable, language, showLineNumbers, startingLineNumber, className, }: CodeHighlighterPrimitiveProps): react_jsx_runtime.JSX.Element;
+
+type CodeHighlighterProps = CodeHighlighterPrimitiveProps;
+declare function CodeHighlighter({ className, ...props }: CodeHighlighterProps): react_jsx_runtime.JSX.Element;
+
+type SenderPrefixAction = 'upload' | 'image' | 'search' | 'reasoning';
+interface SenderModelOption {
+    value: string;
+    label: string;
+}
+interface SenderPrimitiveProps {
+    value?: string;
+    defaultValue?: string;
+    onChange?: (message: string) => void;
+    onSend?: (message: string) => void;
+    onCancel?: () => void;
+    onPrefixAction?: (action: SenderPrefixAction) => void;
+    onModelChange?: (model: string) => void;
+    onVoiceClick?: () => void;
+    loading?: boolean;
+    disabled?: boolean;
+    placeholder?: string;
+    model?: string;
+    modelOptions?: SenderModelOption[];
+    prefix?: ReactNode;
+    suffix?: ReactNode;
+    className?: string;
+}
+declare function SenderPrimitive({ value, defaultValue, onChange, onSend, onCancel, onPrefixAction, onModelChange, onVoiceClick, loading, disabled, placeholder, model, modelOptions, prefix, suffix, className, }: SenderPrimitiveProps): react_jsx_runtime.JSX.Element;
+
+type SenderProps = SenderPrimitiveProps;
+
+declare function Sender({ className, ...props }: SenderProps): react_jsx_runtime.JSX.Element;
+
+interface ThinkPrimitiveProps {
+    content?: string;
+    status?: 'thinking' | 'done';
+    label?: string;
+    defaultOpen?: boolean;
+    className?: string;
+    style?: CSSProperties;
+}
+declare function ThinkPrimitive({ content, status, label, defaultOpen, className, style, }: ThinkPrimitiveProps): react_jsx_runtime.JSX.Element;
+
+type ThinkProps = ThinkPrimitiveProps;
+declare function Think({ className, ...props }: ThinkProps): react_jsx_runtime.JSX.Element;
+
+type NotificationType = 'success' | 'error' | 'loading';
+interface NotificationPrimitiveProps {
+    type?: NotificationType;
+    title?: ReactNode;
+    description?: ReactNode;
+    duration?: number;
+    showProgress?: boolean;
+    closeable?: boolean;
+    icon?: ReactNode;
+    onClose?: () => void;
+    className?: string;
+    style?: CSSProperties;
+}
+declare function NotificationPrimitive({ type, title, description, duration, showProgress, closeable, icon, onClose, className, style, }: NotificationPrimitiveProps): react_jsx_runtime.JSX.Element;
+
+type NotificationProps = NotificationPrimitiveProps;
+interface NotificationItem extends NotificationProps {
+    id: string;
+}
+interface NotificationStackProps {
+    items: NotificationItem[];
+    onClose?: (id: string) => void;
+    className?: string;
+}
+declare function Notification({ className, ...props }: NotificationProps): react_jsx_runtime.JSX.Element;
+declare function NotificationStack({ items, onClose, className, }: NotificationStackProps): react_jsx_runtime.JSX.Element;
+
+type ActionVariant = 'default' | 'primary' | 'danger';
+interface ActionItem {
+    key: string;
+    label: string;
+    icon?: ReactNode;
+    disabled?: boolean;
+    variant?: ActionVariant;
+}
+interface ActionsPrimitiveProps {
+    items: ActionItem[];
+    onAction?: (key: string, item: ActionItem) => void;
+    copiedKey?: string;
+    copiedDuration?: number;
+    orientation?: 'horizontal' | 'vertical';
+    size?: 'sm' | 'md';
+    className?: string;
+    style?: CSSProperties;
+}
+declare function ActionsPrimitive({ items, onAction, copiedKey, copiedDuration, orientation, size, className, style, }: ActionsPrimitiveProps): react_jsx_runtime.JSX.Element;
+
+type ActionsProps = ActionsPrimitiveProps;
+
+declare function Actions({ className, ...props }: ActionsProps): react_jsx_runtime.JSX.Element;
+
+type ActionPresetKey = 'copy' | 'regenerate' | 'correct' | 'summary' | 'polish' | 'explain-code';
+declare const actionPresets: Record<ActionPresetKey, ActionItem>;
+declare function createPresetActions(keys: ActionPresetKey[]): ActionItem[];
+
+interface PromptItem {
+    key: string;
+    title: ReactNode;
+    prompt?: string;
+    description?: ReactNode;
+    category?: ReactNode;
+    icon?: ReactNode;
+    disabled?: boolean;
+}
+interface PromptsPrimitiveProps {
+    items: PromptItem[];
+    onPrompt?: (key: string, item: PromptItem) => void;
+    title?: ReactNode;
+    description?: ReactNode;
+    emptyText?: ReactNode;
+    columns?: 1 | 2 | 3;
+    className?: string;
+    style?: CSSProperties;
+}
+declare function PromptsPrimitive({ items, onPrompt, title, description, emptyText, columns, className, style, }: PromptsPrimitiveProps): react_jsx_runtime.JSX.Element;
+
+type PromptsProps = PromptsPrimitiveProps;
+
+declare function Prompts({ className, ...props }: PromptsProps): react_jsx_runtime.JSX.Element;
+
+interface ConversationRecord {
+    id: string;
+    title: string;
+    lastMessage?: string;
+    timestamp?: Date | string;
+    pinned?: boolean;
+    favorite?: boolean;
+}
+interface ConversationItemPrimitiveProps {
+    conversation: ConversationRecord;
+    active?: boolean;
+    onSelect?: (id: string) => void;
+    onDelete?: (id: string) => void;
+    onPin?: (id: string) => void;
+    onFavorite?: (id: string) => void;
+    className?: string;
+    style?: CSSProperties;
+}
+declare function ConversationItemPrimitive({ conversation, active, onSelect, onDelete, onPin, onFavorite, className, style, }: ConversationItemPrimitiveProps): react_jsx_runtime.JSX.Element;
+
+type ConversationItemProps = ConversationItemPrimitiveProps;
+
+declare function ConversationItem({ className, ...props }: ConversationItemProps): react_jsx_runtime.JSX.Element;
+
+interface ConversationListPrimitiveProps {
+    conversations: ConversationRecord[];
+    activeId?: string;
+    onSelect?: (id: string) => void;
+    onDelete?: (id: string) => void;
+    onPin?: (id: string) => void;
+    onFavorite?: (id: string) => void;
+    onCollapsedChange?: (collapsed: boolean) => void;
+    onNewConversation?: () => void;
+    collapsed?: boolean;
+    searchable?: boolean;
+    searchPlaceholder?: string;
+    title?: ReactNode;
+    emptyText?: ReactNode;
+    virtualized?: boolean;
+    itemHeight?: number;
+    overscan?: number;
+    className?: string;
+    style?: CSSProperties;
+}
+declare function ConversationListPrimitive({ conversations, activeId, onSelect, onDelete, onPin, onFavorite, onCollapsedChange, onNewConversation, collapsed, searchable, searchPlaceholder, title, emptyText, virtualized, itemHeight, overscan, className, style, }: ConversationListPrimitiveProps): react_jsx_runtime.JSX.Element;
+
+type ConversationListProps = ConversationListPrimitiveProps;
+declare function ConversationList({ className, ...props }: ConversationListProps): react_jsx_runtime.JSX.Element;
+
+interface MessageRecord {
+    id: string;
+    role: LLMRole;
+    content?: string;
+    avatar?: ReactNode;
+    timestamp?: Date | string;
+    status?: messageStatus;
+    loading?: boolean;
+    actions?: ReactNode;
+}
+interface MessageListPrimitiveProps {
+    messages: MessageRecord[];
+    virtualized?: boolean;
+    itemHeight?: number;
+    overscan?: number;
+    emptyText?: ReactNode;
+    renderMessage?: (message: MessageRecord, index: number) => ReactNode;
+    role?: 'log' | 'list';
+    ariaLabel?: string;
+    className?: string;
+    style?: CSSProperties;
+}
+declare function MessageListPrimitive({ messages, virtualized, itemHeight, overscan, emptyText, renderMessage, role, ariaLabel, className, style, }: MessageListPrimitiveProps): react_jsx_runtime.JSX.Element;
+
+type MessageListProps = MessageListPrimitiveProps;
+
+declare function MessageList({ className, ...props }: MessageListProps): react_jsx_runtime.JSX.Element;
+
+type ThoughtStatus = 'pending' | 'loading' | 'success' | 'error' | 'abort';
+interface ThoughtItem {
+    key: string;
+    title: ReactNode;
+    description?: ReactNode;
+    content?: ReactNode;
+    footer?: ReactNode;
+    status?: ThoughtStatus;
+    icon?: ReactNode | false;
+    collapsible?: boolean;
+    defaultOpen?: boolean;
+    children?: ThoughtItem[];
+}
+interface ThoughtPrimitiveProps {
+    items: ThoughtItem[];
+    title?: ReactNode;
+    description?: ReactNode;
+    defaultExpandedKeys?: string[];
+    expandedKeys?: string[];
+    onExpand?: (expandedKeys: string[], item: ThoughtItem) => void;
+    line?: boolean;
+    compact?: boolean;
+    emptyText?: ReactNode;
+    className?: string;
+    style?: CSSProperties;
+}
+declare function ThoughtPrimitive({ items, title, description, defaultExpandedKeys, expandedKeys, onExpand, line, compact, emptyText, className, style, }: ThoughtPrimitiveProps): react_jsx_runtime.JSX.Element;
+
+type ThoughtProps = ThoughtPrimitiveProps;
+
+declare function Thought({ className, ...props }: ThoughtProps): react_jsx_runtime.JSX.Element;
+
+interface CitationItem {
+    key: string;
+    title: ReactNode;
+    description?: ReactNode;
+    url?: string;
+    icon?: ReactNode;
+}
+interface CitationPrimitiveProps {
+    items: CitationItem[];
+    title?: ReactNode;
+    defaultExpanded?: boolean;
+    expanded?: boolean;
+    onExpand?: (expanded: boolean) => void;
+    onCitation?: (key: string, item: CitationItem) => void;
+    emptyText?: ReactNode;
+    className?: string;
+    style?: CSSProperties;
+}
+interface CitationInlinePrimitiveProps {
+    item: CitationItem;
+    index?: number;
+    active?: boolean;
+    onCitation?: (key: string, item: CitationItem) => void;
+    className?: string;
+    style?: CSSProperties;
+}
+declare function CitationInlinePrimitive({ item, index, active, onCitation, className, style, }: CitationInlinePrimitiveProps): react_jsx_runtime.JSX.Element;
+declare function CitationPrimitive({ items, title, defaultExpanded, expanded, onExpand, onCitation, emptyText, className, style, }: CitationPrimitiveProps): react_jsx_runtime.JSX.Element;
+
+type CitationProps = CitationPrimitiveProps;
+type CitationInlineProps = CitationInlinePrimitiveProps;
+
+declare function Citation({ className, ...props }: CitationProps): react_jsx_runtime.JSX.Element;
+declare namespace Citation {
+    var Inline: typeof CitationInline;
+}
+declare function CitationInline({ className, ...props }: CitationInlineProps): react_jsx_runtime.JSX.Element;
+
+interface Locale {
+    think: {
+        loading: string;
+        done: string;
+    };
+    sender: {
+        placeholder: string;
+        send: string;
+    };
+}
+
+type ComponentDefaultProps = Record<string, unknown>;
+interface ConfigProviderProps {
+    theme?: {
+        mode?: 'light' | 'dark' | 'system';
+        primaryColor?: string;
+    };
+    locale?: 'zh-CN' | 'en-US' | Locale;
+    components?: Record<string, ComponentDefaultProps>;
+    ai?: {
+        apiKey: string;
+        model: string;
+        baseURL?: string;
+    };
+    children: ReactNode;
+}
+interface ConfigContextValue {
+    theme: {
+        mode: 'light' | 'dark' | 'system';
+        primaryColor: string;
+    };
+    setTheme: (theme: {
+        mode?: 'light' | 'dark' | 'system';
+        primaryColor?: string;
+    }) => void;
+    locale: Locale;
+    components?: Record<string, ComponentDefaultProps>;
+    ai?: {
+        apiKey: string;
+        model: string;
+        baseURL?: string;
+    };
+}
+
+declare function ConfigProvider({ theme, locale, ai, children, components }: ConfigProviderProps): react_jsx_runtime.JSX.Element;
+
+declare function useConfig(): ConfigContextValue;
+
+declare function useLocale(): Locale;
+
+declare function useTheme(): {
+    mode: "system" | "dark" | "light";
+    isDark: boolean;
+    setMode: (mode: "light" | "dark" | "system") => void;
+    primaryColor: string;
+};
+
+type StreamState = 'idle' | 'streaming' | 'error' | 'complete';
+interface StreamStartOptions {
+    onComplete?: (content: string) => void;
+    onError?: () => void;
+    onToken?: (content: string, token: string) => void;
+}
+declare function useStream(): {
+    content: string;
+    state: StreamState;
+    start: (generator: AsyncGenerator<string>, options?: StreamStartOptions) => Promise<void>;
+    cancel: () => void;
+};
+
+type VirtualListKey = string | number;
+type VirtualListAlign = 'start' | 'center' | 'end';
+interface UseVirtualListOptions<T> {
+    items: T[];
+    itemHeight: number;
+    overscan?: number;
+    enabled?: boolean;
+    getItemKey?: (item: T, index: number) => VirtualListKey;
+}
+interface VirtualListItem<T> {
+    item: T;
+    index: number;
+    key: VirtualListKey;
+    start: number;
+    size: number;
+}
+interface UseVirtualListReturn<T> {
+    containerRef: RefObject<HTMLDivElement | null>;
+    virtualItems: VirtualListItem<T>[];
+    totalSize: number;
+    scrollToIndex: (index: number, align?: VirtualListAlign) => void;
+}
+declare function useVirtualList<T>({ items, itemHeight, overscan, enabled, getItemKey, }: UseVirtualListOptions<T>): UseVirtualListReturn<T>;
+
+declare function streamToGenerator(stream: ReadableStream<Uint8Array>, encoding?: string): AsyncGenerator<string>;
+declare function generatorToStream(gen: AsyncGenerator<string>): ReadableStream<Uint8Array>;
+declare function mockStream(text: string, delay?: number): AsyncGenerator<string>;
+
+declare function sanitizeMarkdown(content: string): string;
+
+declare const zhCN: Locale;
+
+declare const enUS: Locale;
+
+export { type ActionItem, type ActionPresetKey, type ActionVariant, Actions, ActionsPrimitive, type ActionsPrimitiveProps, type ActionsProps, Bubble, BubblePrimitive, type BubblePrimitiveProps, type BubbleProps, Citation, CitationInlinePrimitive, type CitationInlinePrimitiveProps, type CitationInlineProps, type CitationItem, CitationPrimitive, type CitationPrimitiveProps, type CitationProps, CodeHighlighter, CodeHighlighterPrimitive, type CodeHighlighterPrimitiveProps, type CodeHighlighterProps, type ComponentDefaultProps, type ConfigContextValue, ConfigProvider, type ConfigProviderProps, ConversationItem, ConversationItemPrimitive, type ConversationItemPrimitiveProps, type ConversationItemProps, ConversationList, ConversationListPrimitive, type ConversationListPrimitiveProps, type ConversationListProps, type ConversationRecord, type Locale, Mark, MarkPrimitive, type MarkPrimitiveProps, type MarkProps, MessageList, MessageListPrimitive, type MessageListPrimitiveProps, type MessageListProps, type MessageRecord, Notification, type NotificationItem, NotificationPrimitive, type NotificationPrimitiveProps, type NotificationProps, NotificationStack, type NotificationStackProps, type NotificationType, type PromptItem, Prompts, PromptsPrimitive, type PromptsPrimitiveProps, type PromptsProps, Sender, type SenderModelOption, type SenderPrefixAction, SenderPrimitive, type SenderPrimitiveProps, type SenderProps, Think, ThinkPrimitive, type ThinkPrimitiveProps, type ThinkProps, Thought, type ThoughtItem, ThoughtPrimitive, type ThoughtPrimitiveProps, type ThoughtProps, type ThoughtStatus, type UseVirtualListOptions, type UseVirtualListReturn, type VirtualListAlign, type VirtualListItem, type VirtualListKey, actionPresets, createPresetActions, enUS, generatorToStream, mockStream, sanitizeMarkdown, streamToGenerator, useConfig, useLocale, useStream, useTheme, useVirtualList, zhCN };