@polpo-ai/chat 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,198 @@
+import * as react from 'react';
+import { ReactNode, ComponentType, HTMLAttributes } from 'react';
+import { ChatMessage as ChatMessage$1, ContentPart, ToolCallEvent } from '@polpo-ai/sdk';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { UseChatReturn } from '@polpo-ai/react';
+export { useDocumentDrag, useSubmitHandler } from './hooks/index.js';
+export { ToolCallChip, ToolCallShell } from './tools/index.js';
+import 'lucide-react';
+
+interface ChatMessagesHandle {
+    /** Scroll the list to the bottom. */
+    scrollToBottom: (behavior?: "smooth" | "auto") => void;
+}
+interface ChatMessagesProps {
+    /**
+     * Custom renderer for each message.
+     * Receives the message, its index, whether it is the last item, and
+     * whether the assistant is currently streaming.
+     */
+    renderItem?: (msg: ChatMessage$1, index: number, isLast: boolean, isStreaming: boolean) => ReactNode;
+    /** Extra classes applied to the Virtuoso container. */
+    className?: string;
+    /** Number of skeleton pairs to show during the initial load. */
+    skeletonCount?: number;
+}
+declare const ChatMessages: react.ForwardRefExoticComponent<ChatMessagesProps & react.RefAttributes<ChatMessagesHandle>>;
+
+/** Components override accepted by Streamdown — use Record for flexibility. */
+type StreamdownComponentsProp = Record<string, unknown>;
+interface ChatMessageItemData {
+    id?: string;
+    role: "user" | "assistant";
+    content: string | ContentPart[];
+    ts?: string;
+    toolCalls?: ToolCallEvent[];
+}
+interface ChatMessageProps {
+    msg: ChatMessageItemData;
+    isLast?: boolean;
+    isStreaming?: boolean;
+    avatar?: ReactNode;
+    agentName?: string;
+    streamdownComponents?: StreamdownComponentsProp;
+}
+declare const ChatUserMessage: react.MemoExoticComponent<({ msg, isLast, isStreaming, }: {
+    msg: ChatMessageItemData;
+    isLast?: boolean;
+    isStreaming?: boolean;
+}) => react_jsx_runtime.JSX.Element>;
+declare const ChatAssistantMessage: react.MemoExoticComponent<({ msg, isLast, isStreaming, avatar, agentName, streamdownComponents: components, }: {
+    msg: ChatMessageItemData;
+    isLast?: boolean;
+    isStreaming?: boolean;
+    avatar?: ReactNode;
+    agentName?: string;
+    streamdownComponents?: StreamdownComponentsProp;
+}) => react_jsx_runtime.JSX.Element>;
+declare const ChatMessage: react.MemoExoticComponent<({ msg, isLast, isStreaming, avatar, agentName, streamdownComponents, }: ChatMessageProps) => react_jsx_runtime.JSX.Element>;
+
+interface ChatProps {
+    /** Session ID — omit for new chats */
+    sessionId?: string;
+    /** Agent name for completions */
+    agent?: string;
+    /** Called when a new session is created */
+    onSessionCreated?: (sessionId: string) => void;
+    /** Called on each stream update (useful for external scroll control) */
+    onUpdate?: () => void;
+    /** Custom message renderer — if omitted, uses ChatMessage with defaults */
+    renderMessage?: (msg: ChatMessageProps["msg"], index: number, isLast: boolean, isStreaming: boolean) => ReactNode;
+    /** Avatar ReactNode shown on assistant messages */
+    avatar?: ReactNode;
+    /** Agent display name shown on assistant messages */
+    agentName?: string;
+    /** Streamdown components override for code blocks etc. */
+    streamdownComponents?: Record<string, unknown>;
+    /** Number of skeleton items while loading */
+    skeletonCount?: number;
+    /** Placeholder text for the default input */
+    inputPlaceholder?: string;
+    /** Hint text below the default input */
+    inputHint?: string;
+    /** Whether file attachments are enabled on the default input (default: true) */
+    allowAttachments?: boolean;
+    /** Children rendered after the message list — replaces the default ChatInput */
+    children?: ReactNode;
+    /** Additional className on the outer container */
+    className?: string;
+}
+declare const Chat: react.ForwardRefExoticComponent<ChatProps & react.RefAttributes<ChatMessagesHandle>>;
+
+interface ChatInputProps {
+    /** Placeholder text for the textarea */
+    placeholder?: string;
+    /** Hint text below the input */
+    hint?: string;
+    /** Whether file attachments are enabled (default: true) */
+    allowAttachments?: boolean;
+    /** Additional className on the outer wrapper */
+    className?: string;
+    /** Custom submit button renderer */
+    renderSubmit?: (props: {
+        isStreaming: boolean;
+        onStop: () => void;
+    }) => ReactNode;
+}
+declare function ChatInput({ placeholder, hint, allowAttachments, className, renderSubmit, }: ChatInputProps): react_jsx_runtime.JSX.Element;
+
+interface ChatProviderProps {
+    /** Resume an existing session by ID. */
+    sessionId?: string;
+    /** Target a specific agent for direct conversation. */
+    agent?: string;
+    /** Called when a new session is created (first message). */
+    onSessionCreated?: (id: string) => void;
+    /** Called after each stream update (e.g. scroll-to-bottom). */
+    onUpdate?: () => void;
+    children: ReactNode;
+}
+interface ChatContextValue extends UseChatReturn {
+    /** Upload a file attachment (delegates to useFiles). */
+    uploadFile: (destPath: string, file: File | Blob, filename: string) => Promise<{
+        uploaded: {
+            name: string;
+            size: number;
+        }[];
+        count: number;
+    }>;
+    /** Whether a file upload is in progress. */
+    isUploading: boolean;
+}
+declare function ChatProvider({ sessionId, agent, onSessionCreated, onUpdate, children, }: ChatProviderProps): react_jsx_runtime.JSX.Element;
+declare function useChatContext(): ChatContextValue;
+
+declare function ChatTyping({ className }: {
+    className?: string;
+}): react_jsx_runtime.JSX.Element;
+
+/**
+ * Skeleton loaders for chat UI — mirrors the exact layout of ChatMessageItem
+ * so the loading state feels native, not jarring.
+ */
+/** Skeleton for an AI message: avatar + name + text lines */
+declare function MessageSkeleton({ lines }: {
+    lines?: number;
+}): react_jsx_runtime.JSX.Element;
+/** Skeleton for a user message: right-aligned bubble */
+declare function UserMessageSkeleton(): react_jsx_runtime.JSX.Element;
+/** Full conversation skeleton — alternating user/AI messages */
+declare function ChatSkeleton({ count }: {
+    count?: number;
+}): react_jsx_runtime.JSX.Element;
+
+interface ChatScrollButtonProps {
+    isAtBottom: boolean;
+    showNewMessage?: boolean;
+    onClick: () => void;
+    className?: string;
+}
+declare function ChatScrollButton({ isAtBottom, showNewMessage, onClick, className, }: ChatScrollButtonProps): react_jsx_runtime.JSX.Element | null;
+
+/** Props that any code-block component must accept. */
+interface CodeBlockComponentProps {
+    code: string;
+    language: string;
+    children?: React.ReactNode;
+}
+/** The shape returned by createStreamdownComponents / the default export. */
+interface StreamdownComponents {
+    code: (props: HTMLAttributes<HTMLElement> & {
+        node?: unknown;
+        "data-block"?: string;
+    }) => React.ReactNode;
+}
+/**
+ * Create a `streamdownComponents` override object for Streamdown.
+ *
+ * Pass your own `CodeBlock` component to get syntax-highlighted fenced
+ * code blocks. If omitted, a plain `<pre><code>` fallback is used.
+ *
+ * @example
+ * ```tsx
+ * import { CodeBlock } from "@/components/ai-elements/code-block";
+ * import { createStreamdownComponents } from "@polpo-ai/chat";
+ *
+ * const streamdownComponents = createStreamdownComponents(CodeBlock);
+ * ```
+ */
+declare function createStreamdownComponents(CodeBlockComponent?: ComponentType<CodeBlockComponentProps>): StreamdownComponents;
+declare const streamdownComponents: StreamdownComponents;
+
+/** Format an ISO timestamp as a human-readable relative time string. */
+declare function relativeTime(iso: string): string;
+
+/** Extract the concatenated text from a message content value (string or ContentPart[]). */
+declare function getTextContent(content: string | ContentPart[]): string;
+
+export { Chat, ChatAssistantMessage, ChatInput, type ChatInputProps, ChatMessage, type ChatMessageItemData, type ChatMessageProps, ChatMessages, type ChatMessagesHandle, type ChatMessagesProps, type ChatProps, ChatProvider, ChatScrollButton, ChatSkeleton, ChatTyping, ChatUserMessage, MessageSkeleton, UserMessageSkeleton, createStreamdownComponents, getTextContent, relativeTime, streamdownComponents, useChatContext };