@lukeashford/aurelius 3.8.1 → 4.0.0

package/dist/index.d.mts

@@ -1,5 +1,6 @@
 import React$1, { ReactNode } from 'react';
 import { Config } from 'dompurify';
+import ReactPlayer from 'react-player';
 
 type ButtonVariant = 'primary' | 'important' | 'elevated' | 'outlined' | 'featured' | 'ghost' | 'danger';
 type ButtonSize = 'sm' | 'md' | 'lg' | 'xl';
@@ -737,6 +738,146 @@ interface MarkdownContentProps extends React$1.HTMLAttributes<HTMLDivElement> {
 }
 declare const MarkdownContent: React$1.ForwardRefExoticComponent<MarkdownContentProps & React$1.RefAttributes<HTMLDivElement>>;
 
+/**
+ * Conversation Tree Types
+ *
+ * These types support branching conversations where users can:
+ * - Edit their messages (creating a new branch)
+ * - Retry assistant responses (creating a new branch)
+ * - Navigate between different conversation branches
+ */
+
+/**
+ * A node in the conversation tree
+ */
+interface MessageNode {
+    /**
+     * Unique identifier for this message
+     */
+    id: string;
+    /**
+     * The role of the message author
+     */
+    role: 'user' | 'assistant';
+    /**
+     * The message content (may include HTML/markdown or React components)
+     */
+    content: ReactNode;
+    /**
+     * ID of the parent message (null for root messages)
+     */
+    parentId: string | null;
+    /**
+     * IDs of child messages (branches/continuations)
+     */
+    children: string[];
+    /**
+     * Which sibling branch this message is (0, 1, 2...)
+     * Used for UI display like "1/3"
+     */
+    branchIndex?: number;
+    /**
+     * Whether this message is currently being streamed
+     */
+    isStreaming?: boolean;
+    /**
+     * Timestamp when the message was created
+     */
+    createdAt?: number;
+}
+/**
+ * The full conversation tree structure
+ */
+interface ConversationTree {
+    /**
+     * All nodes indexed by their ID
+     */
+    nodes: Record<string, MessageNode>;
+    /**
+     * IDs of root-level messages (messages with no parent)
+     */
+    rootIds: string[];
+    /**
+     * The current "head" of the viewed branch
+     * This is the leaf node that determines which path we're viewing
+     */
+    activeLeafId: string | null;
+}
+/**
+ * Attachment types for file uploads
+ */
+type AttachmentStatus = 'pending' | 'uploading' | 'complete' | 'error';
+interface Attachment {
+    /**
+     * Unique identifier for the attachment
+     */
+    id: string;
+    /**
+     * The File object
+     */
+    file: File;
+    /**
+     * Blob URL for image previews
+     */
+    previewUrl?: string;
+    /**
+     * Current upload status
+     */
+    status: AttachmentStatus;
+    /**
+     * Error message if status is 'error'
+     */
+    error?: string;
+    /**
+     * Upload progress (0-100)
+     */
+    progress?: number;
+}
+/**
+ * Generate a unique ID
+ */
+declare function generateId(): string;
+/**
+ * Create an empty conversation tree
+ */
+declare function createEmptyTree(): ConversationTree;
+/**
+ * Add a message to the tree
+ */
+declare function addMessageToTree(tree: ConversationTree, message: Omit<MessageNode, 'children' | 'branchIndex'>, parentId?: string | null): ConversationTree;
+/**
+ * Get the linear path from root to the active leaf
+ */
+declare function getActivePathMessages(tree: ConversationTree): MessageNode[];
+/**
+ * Get sibling count and current index for a node
+ */
+declare function getSiblingInfo(tree: ConversationTree, nodeId: string): {
+    total: number;
+    current: number;
+};
+/**
+ * Switch to a different branch at a given node
+ */
+declare function switchBranch(tree: ConversationTree, nodeId: string, direction: 'prev' | 'next'): ConversationTree;
+/**
+ * Update a node's content (e.g., during streaming)
+ */
+declare function updateNodeContent(tree: ConversationTree, nodeId: string, content: ReactNode, isStreaming?: boolean): ConversationTree;
+/**
+ * Convert a flat message array to a conversation tree
+ */
+declare function messagesToTree(messages: Array<{
+    id: string;
+    role: 'user' | 'assistant';
+    content: ReactNode;
+    isStreaming?: boolean;
+}>): ConversationTree;
+/**
+ * Check if a node has multiple children (is a branch point)
+ */
+declare function isBranchPoint(tree: ConversationTree, nodeId: string): boolean;
+
 interface ChatInputNotice {
     /**
      * Visual severity: 'warning' shows a dismissible amber notice, 'error' shows a persistent red
@@ -757,15 +898,6 @@ interface ChatInputNotice {
     onDismiss?: () => void;
 }
 type ChatInputPosition = 'centered' | 'bottom';
-type AttachmentStatus = 'pending' | 'uploading' | 'complete' | 'error';
-interface Attachment {
-    id: string;
-    file: File;
-    previewUrl?: string;
-    status: AttachmentStatus;
-    error?: string;
-    progress?: number;
-}
 interface ChatInputProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>, 'onSubmit'> {
     /**
      * Position of the input: 'centered' for empty state, 'bottom' for conversation mode
@@ -807,6 +939,10 @@ interface ChatInputProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>, 'o
      * Called when attachments change (controlled mode)
      */
     onAttachmentsChange?: (attachments: Attachment[]) => void;
+    /**
+     * Called when an attachment is removed by the user (clicking the "x")
+     */
+    onAttachmentRemove?: (attachment: Attachment) => void;
     /**
      * Whether to show the attachment button
      */
@@ -928,26 +1064,9 @@ interface ToolDefinition {
 }
 /**
  * Consumer-provided tool definition passed via ChatInterface's `tools` prop.
- * Defines a custom tool with its sidebar icon and the panel content to
- * render when the tool is opened.
+ * Adds the panel content to render when the tool is opened.
  */
-interface ExternalToolDefinition {
-    /**
-     * Unique identifier for this tool
-     */
-    id: string;
-    /**
-     * Icon element shown in the sidebar button
-     */
-    icon: React$1.ReactNode;
-    /**
-     * Accessible label for the button
-     */
-    label: string;
-    /**
-     * Which group the tool belongs to
-     */
-    group: ToolGroup;
+interface ExternalToolDefinition extends ToolDefinition {
     /**
      * Content to render when the tool is open
      */
@@ -1177,128 +1296,6 @@ interface ArtifactNode {
     children: ArtifactNode[];
 }
 
-/**
- * Conversation Tree Types
- *
- * These types support branching conversations where users can:
- * - Edit their messages (creating a new branch)
- * - Retry assistant responses (creating a new branch)
- * - Navigate between different conversation branches
- */
-
-/**
- * A node in the conversation tree
- */
-interface MessageNode {
-    /**
-     * Unique identifier for this message
-     */
-    id: string;
-    /**
-     * The role of the message author
-     */
-    role: 'user' | 'assistant';
-    /**
-     * The message content (may include HTML/markdown or React components)
-     */
-    content: ReactNode;
-    /**
-     * ID of the parent message (null for root messages)
-     */
-    parentId: string | null;
-    /**
-     * IDs of child messages (branches/continuations)
-     */
-    children: string[];
-    /**
-     * Which sibling branch this message is (0, 1, 2...)
-     * Used for UI display like "1/3"
-     */
-    branchIndex?: number;
-    /**
-     * Whether this message is currently being streamed
-     */
-    isStreaming?: boolean;
-    /**
-     * Timestamp when the message was created
-     */
-    createdAt?: number;
-}
-/**
- * The full conversation tree structure
- */
-interface ConversationTree {
-    /**
-     * All nodes indexed by their ID
-     */
-    nodes: Record<string, MessageNode>;
-    /**
-     * IDs of root-level messages (messages with no parent)
-     */
-    rootIds: string[];
-    /**
-     * The current "head" of the viewed branch
-     * This is the leaf node that determines which path we're viewing
-     */
-    activeLeafId: string | null;
-}
-/**
- * Helper to check if a file is an image
- */
-declare function isImageFile(file: File): boolean;
-/**
- * Helper to create a preview URL for an image file
- */
-declare function createPreviewUrl(file: File): string | undefined;
-/**
- * Helper to revoke a preview URL when no longer needed
- */
-declare function revokePreviewUrl(url: string | undefined): void;
-/**
- * Generate a unique ID
- */
-declare function generateId(): string;
-/**
- * Create an empty conversation tree
- */
-declare function createEmptyTree(): ConversationTree;
-/**
- * Add a message to the tree
- */
-declare function addMessageToTree(tree: ConversationTree, message: Omit<MessageNode, 'children' | 'branchIndex'>, parentId?: string | null): ConversationTree;
-/**
- * Get the linear path from root to the active leaf
- */
-declare function getActivePathMessages(tree: ConversationTree): MessageNode[];
-/**
- * Get sibling count and current index for a node
- */
-declare function getSiblingInfo(tree: ConversationTree, nodeId: string): {
-    total: number;
-    current: number;
-};
-/**
- * Switch to a different branch at a given node
- */
-declare function switchBranch(tree: ConversationTree, nodeId: string, direction: 'prev' | 'next'): ConversationTree;
-/**
- * Update a node's content (e.g., during streaming)
- */
-declare function updateNodeContent(tree: ConversationTree, nodeId: string, content: ReactNode, isStreaming?: boolean): ConversationTree;
-/**
- * Convert a flat message array to a conversation tree
- */
-declare function messagesToTree(messages: Array<{
-    id: string;
-    role: 'user' | 'assistant';
-    content: ReactNode;
-    isStreaming?: boolean;
-}>): ConversationTree;
-/**
- * Check if a node has multiple children (is a branch point)
- */
-declare function isBranchPoint(tree: ConversationTree, nodeId: string): boolean;
-
 interface Conversation {
     /**
      * Unique identifier for the conversation
@@ -1413,6 +1410,10 @@ interface ChatInterfaceProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>
      * Called when attachments are added or removed in the chat input.
      */
     onAttachmentsChange?: (attachments: Attachment[]) => void;
+    /**
+     * Called when an attachment is removed by the user (clicking the "x")
+     */
+    onAttachmentRemove?: (attachment: Attachment) => void;
     /**
      * Top-level artifact tree nodes for the artifacts panel.
      */
@@ -1642,12 +1643,15 @@ interface ToolPanelContainerProps extends React$1.HTMLAttributes<HTMLDivElement>
  */
 declare const ToolPanelContainer: React$1.ForwardRefExoticComponent<ToolPanelContainerProps & React$1.RefAttributes<HTMLDivElement>>;
 
-type MessageActionsVariant = 'user' | 'assistant';
+/**
+ * @deprecated Use MessageVariant. Kept as an alias for backwards compatibility.
+ */
+type MessageActionsVariant = MessageVariant;
 interface MessageActionsProps extends React$1.HTMLAttributes<HTMLDivElement> {
     /**
      * Whether this is for a user or assistant message
      */
-    variant: MessageActionsVariant;
+    variant: MessageVariant;
     /**
      * The message content for copy functionality
      */
@@ -1864,6 +1868,7 @@ interface ImageCardProps extends Omit<CardProps, 'title'> {
 }
 declare const ImageCard: React$1.ForwardRefExoticComponent<ImageCardProps & React$1.RefAttributes<HTMLDivElement>>;
 
+type ReactPlayerProps$1 = React$1.ComponentProps<typeof ReactPlayer>;
 type VideoAspectRatioPreset = 'video' | 'cinema' | 'square';
 type VideoAspectRatio = VideoAspectRatioPreset | `${number}/${number}`;
 interface VideoCardProps extends Omit<CardProps, 'title'> {
@@ -1879,11 +1884,13 @@ interface VideoCardProps extends Omit<CardProps, 'title'> {
     loop?: boolean;
     mediaClassName?: string;
     contentClassName?: string;
-    playerProps?: any;
+    /** Forwarded to the underlying ReactPlayer. */
+    playerProps?: Partial<ReactPlayerProps$1>;
     loading?: CardSlotLoading;
 }
 declare const VideoCard: React$1.ForwardRefExoticComponent<VideoCardProps & React$1.RefAttributes<HTMLDivElement>>;
 
+type ReactPlayerProps = React$1.ComponentProps<typeof ReactPlayer>;
 interface AudioCardProps extends Omit<CardProps, 'title'> {
     src?: string;
     title?: React$1.ReactNode;
@@ -1895,7 +1902,8 @@ interface AudioCardProps extends Omit<CardProps, 'title'> {
     loop?: boolean;
     mediaClassName?: string;
     contentClassName?: string;
-    playerProps?: any;
+    /** Forwarded to the underlying ReactPlayer. */
+    playerProps?: Partial<ReactPlayerProps>;
     height?: string | number;
     loading?: CardSlotLoading;
 }
@@ -2025,4 +2033,4 @@ declare const ArtifactVariantStack: React$1.ForwardRefExoticComponent<ArtifactVa
 
 declare const version = "2.0.0";
 
-export { ARTIFACT_TYPES, Accordion, AccordionContent, type AccordionContentProps, AccordionItem, type AccordionItemProps, type AccordionProps, AccordionTrigger, type AccordionTriggerProps, Alert, AlertDialog, type AlertDialogProps, type AlertProps, type AlertVariant, type Artifact, ArtifactCard, type ArtifactCardProps, ArtifactGroup, type ArtifactGroupProps, type ArtifactNode, type ArtifactType, ArtifactVariantStack, type ArtifactVariantStackProps, ArtifactsPanel, type ArtifactsPanelProps, ArtifactsPanelToggle, type ArtifactsPanelToggleProps, type AspectRatio, type AspectRatioPreset, type Attachment, type AttachmentItem, AttachmentPreview, type AttachmentPreviewProps, type AttachmentStatus, AudioCard, type AudioCardProps, Avatar, type AvatarProps, type AvatarSize, Badge, type BadgeProps, type BadgeVariant, BranchNavigator, type BranchNavigatorProps, BrandIcon, type BrandIconProps, type BrandIconSize, type BrandIconVariant, Breadcrumb, type BreadcrumbEntry, BreadcrumbItem, type BreadcrumbItemProps, BreadcrumbLink, type BreadcrumbLinkProps, type BreadcrumbProps, Button, type ButtonProps, type ButtonSize, type ButtonVariant, Card, type CardBodyProps, type CardFooterProps, type CardHeaderProps, type CardMediaProps, type CardProps, type CardVariant, ChatBubbleIcon, ChatInput, type ChatInputNotice, type ChatInputPosition, type ChatInputProps, ChatInterface, type ChatInterfaceProps, ChatView, type ChatViewItem, type ChatViewProps, CheckSquareIcon, Checkbox, type CheckboxProps, ChevronLeftIcon, ChevronRightIcon, CloseIcon, Col, type ColOffset, type ColOrder, type ColProps, type ColSpan, ColorSwatch, type ColorSwatchProps, ConfirmDialog, type ConfirmDialogProps, Container, type ContainerProps, type ContainerSize, type Conversation, type ConversationTree, CrossSquareIcon, Divider, type DividerProps, Drawer, type DrawerPosition, type DrawerProps, EmptySquareIcon, ExpandIcon, type ExternalToolDefinition, FileChip, type FileChipProps, type FileChipStatus, HelperText, type HelperTextProps, HistoryIcon, HistoryPanel, type HistoryPanelProps, type IconProps, ImageCard, type ImageCardProps, Input, type InputAddonProps, type InputElementProps, InputGroup, type InputGroupProps, InputLeftAddon, InputLeftElement, type InputProps, InputRightAddon, InputRightElement, InputWrapper, type InputWrapperProps, Label, type LabelProps, LayersIcon, List, ListItem, type ListItemProps, ListItemText, type ListItemTextProps, type ListProps, ListSubheader, type ListSubheaderProps, MarkdownContent, type MarkdownContentProps, MediaIcon, Menu, MenuContent, type MenuContentProps, MenuItem, type MenuItemProps, MenuLabel, type MenuProps, MenuSeparator, MenuTrigger, type MenuTriggerProps, Message, MessageActions, type MessageActionsConfig, type MessageActionsProps, type MessageActionsVariant, type MessageBranchInfo, type MessageNode, type MessageProps, type MessageVariant, Modal, type ModalProps, NODE_TYPES, Navbar, NavbarBrand, type NavbarBrandProps, NavbarContent, type NavbarContentProps, NavbarDivider, NavbarItem, type NavbarItemProps, NavbarLink, type NavbarLinkProps, type NavbarProps, type NodeType, Pagination, type PaginationProps, PdfCard, type PdfCardProps, PlusIcon, Popover, type PopoverAlign, type PopoverPosition, type PopoverProps, Progress, type ProgressProps, PromptDialog, type PromptDialogProps, Radio, type RadioProps, Row, type RowAlign, type RowGutter, type RowJustify, type RowProps, SCRIPT_ELEMENT_TYPES, ScriptCard, type ScriptCardProps, type ScriptElement, type ScriptElementType, SectionHeading, type SectionHeadingLevel, type SectionHeadingProps, Select, type SelectOption, type SelectProps, Skeleton, type SkeletonProps, Slider, type SliderProps, Spinner, type SpinnerProps, SquareLoaderIcon, Stack, type StackDirection, type StackGap, type StackProps, type Step, type StepStatus, Stepper, type StepperProps, StreamingCursor, type StreamingCursorProps, Switch, type SwitchProps, TASK_STATUSES, Tab, TabList, type TabListProps, TabPanel, type TabPanelProps, type TabProps, Table, TableBody, type TableBodyProps, TableCaption, type TableCaptionProps, TableCell, type TableCellProps, TableFooter, type TableFooterProps, TableHead, type TableHeadProps, TableHeader, type TableHeaderProps, type TableProps, TableRow, type TableRowProps, Tabs, type TabsProps, type Task, type TaskStatus, TextCard, type TextCardProps, Textarea, type TextareaProps, ThinkingIndicator, type ThinkingIndicatorProps, type ToastData, type ToastPosition, ToastProvider, type ToastProviderProps, type ToastVariant, TodosList, type TodosListProps, type ToolDefinition, type ToolGroup, ToolPanelContainer, type ToolPanelContainerProps, type ToolPanelState, ToolSidebar, type ToolSidebarProps, Tooltip, type TooltipProps, type UseArtifactTreeNavigationReturn, type UseScrollAnchorOptions, type UseScrollAnchorReturn, type VideoAspectRatio, type VideoAspectRatioPreset, VideoCard, type VideoCardProps, addMessageToTree, areAllTasksSettled, createEmptyTree, createPreviewUrl, generateId, getActivePathMessages, getSiblingInfo, isBranchPoint, isImageFile, messagesToTree, revokePreviewUrl, switchBranch, updateNodeContent, useArtifactTreeNavigation, useResizable, useScrollAnchor, useToast, version };
+export { ARTIFACT_TYPES, Accordion, AccordionContent, type AccordionContentProps, AccordionItem, type AccordionItemProps, type AccordionProps, AccordionTrigger, type AccordionTriggerProps, Alert, AlertDialog, type AlertDialogProps, type AlertProps, type AlertVariant, type Artifact, ArtifactCard, type ArtifactCardProps, ArtifactGroup, type ArtifactGroupProps, type ArtifactNode, type ArtifactType, ArtifactVariantStack, type ArtifactVariantStackProps, ArtifactsPanel, type ArtifactsPanelProps, ArtifactsPanelToggle, type ArtifactsPanelToggleProps, type AspectRatio, type AspectRatioPreset, type Attachment, type AttachmentItem, AttachmentPreview, type AttachmentPreviewProps, type AttachmentStatus, AudioCard, type AudioCardProps, Avatar, type AvatarProps, type AvatarSize, Badge, type BadgeProps, type BadgeVariant, BranchNavigator, type BranchNavigatorProps, BrandIcon, type BrandIconProps, type BrandIconSize, type BrandIconVariant, Breadcrumb, type BreadcrumbEntry, BreadcrumbItem, type BreadcrumbItemProps, BreadcrumbLink, type BreadcrumbLinkProps, type BreadcrumbProps, Button, type ButtonProps, type ButtonSize, type ButtonVariant, Card, type CardBodyProps, type CardFooterProps, type CardHeaderProps, type CardMediaProps, type CardProps, type CardVariant, ChatBubbleIcon, ChatInput, type ChatInputNotice, type ChatInputPosition, type ChatInputProps, ChatInterface, type ChatInterfaceProps, ChatView, type ChatViewItem, type ChatViewProps, CheckSquareIcon, Checkbox, type CheckboxProps, ChevronLeftIcon, ChevronRightIcon, CloseIcon, Col, type ColOffset, type ColOrder, type ColProps, type ColSpan, ColorSwatch, type ColorSwatchProps, ConfirmDialog, type ConfirmDialogProps, Container, type ContainerProps, type ContainerSize, type Conversation, type ConversationTree, CrossSquareIcon, Divider, type DividerProps, Drawer, type DrawerPosition, type DrawerProps, EmptySquareIcon, ExpandIcon, type ExternalToolDefinition, FileChip, type FileChipProps, type FileChipStatus, HelperText, type HelperTextProps, HistoryIcon, HistoryPanel, type HistoryPanelProps, type IconProps, ImageCard, type ImageCardProps, Input, type InputAddonProps, type InputElementProps, InputGroup, type InputGroupProps, InputLeftAddon, InputLeftElement, type InputProps, InputRightAddon, InputRightElement, InputWrapper, type InputWrapperProps, Label, type LabelProps, LayersIcon, List, ListItem, type ListItemProps, ListItemText, type ListItemTextProps, type ListProps, ListSubheader, type ListSubheaderProps, MarkdownContent, type MarkdownContentProps, MediaIcon, Menu, MenuContent, type MenuContentProps, MenuItem, type MenuItemProps, MenuLabel, type MenuProps, MenuSeparator, MenuTrigger, type MenuTriggerProps, Message, MessageActions, type MessageActionsConfig, type MessageActionsProps, type MessageActionsVariant, type MessageBranchInfo, type MessageNode, type MessageProps, type MessageVariant, Modal, type ModalProps, NODE_TYPES, Navbar, NavbarBrand, type NavbarBrandProps, NavbarContent, type NavbarContentProps, NavbarDivider, NavbarItem, type NavbarItemProps, NavbarLink, type NavbarLinkProps, type NavbarProps, type NodeType, Pagination, type PaginationProps, PdfCard, type PdfCardProps, PlusIcon, Popover, type PopoverAlign, type PopoverPosition, type PopoverProps, Progress, type ProgressProps, PromptDialog, type PromptDialogProps, Radio, type RadioProps, Row, type RowAlign, type RowGutter, type RowJustify, type RowProps, SCRIPT_ELEMENT_TYPES, ScriptCard, type ScriptCardProps, type ScriptElement, type ScriptElementType, SectionHeading, type SectionHeadingLevel, type SectionHeadingProps, Select, type SelectOption, type SelectProps, Skeleton, type SkeletonProps, Slider, type SliderProps, Spinner, type SpinnerProps, SquareLoaderIcon, Stack, type StackDirection, type StackGap, type StackProps, type Step, type StepStatus, Stepper, type StepperProps, StreamingCursor, type StreamingCursorProps, Switch, type SwitchProps, TASK_STATUSES, Tab, TabList, type TabListProps, TabPanel, type TabPanelProps, type TabProps, Table, TableBody, type TableBodyProps, TableCaption, type TableCaptionProps, TableCell, type TableCellProps, TableFooter, type TableFooterProps, TableHead, type TableHeadProps, TableHeader, type TableHeaderProps, type TableProps, TableRow, type TableRowProps, Tabs, type TabsProps, type Task, type TaskStatus, TextCard, type TextCardProps, Textarea, type TextareaProps, ThinkingIndicator, type ThinkingIndicatorProps, type ToastData, type ToastPosition, ToastProvider, type ToastProviderProps, type ToastVariant, TodosList, type TodosListProps, type ToolDefinition, type ToolGroup, ToolPanelContainer, type ToolPanelContainerProps, type ToolPanelState, ToolSidebar, type ToolSidebarProps, Tooltip, type TooltipProps, type UseArtifactTreeNavigationReturn, type UseScrollAnchorOptions, type UseScrollAnchorReturn, type VideoAspectRatio, type VideoAspectRatioPreset, VideoCard, type VideoCardProps, addMessageToTree, areAllTasksSettled, createEmptyTree, generateId, getActivePathMessages, getSiblingInfo, isBranchPoint, messagesToTree, switchBranch, updateNodeContent, useArtifactTreeNavigation, useResizable, useScrollAnchor, useToast, version };