@lukeashford/aurelius 2.12.0 → 2.14.0

package/dist/index.d.ts

@@ -594,6 +594,45 @@ interface StepperProps extends React$1.HTMLAttributes<HTMLDivElement> {
 }
 declare const Stepper: React$1.ForwardRefExoticComponent<StepperProps & React$1.RefAttributes<HTMLDivElement>>;
 
+declare function ChevronLeftIcon({ className, ...props }: IconProps): React$1.JSX.Element;
+
+declare function ChevronRightIcon({ className, ...props }: IconProps): React$1.JSX.Element;
+
+declare function CloseIcon({ className, ...props }: IconProps): React$1.JSX.Element;
+
+declare function ExpandIcon({ className, ...props }: IconProps): React$1.JSX.Element;
+
+declare function HistoryIcon({ className, ...props }: IconProps): React$1.JSX.Element;
+
+declare function LayersIcon({ className, ...props }: IconProps): React$1.JSX.Element;
+
+declare function PlusIcon({ className, ...props }: IconProps): React$1.JSX.Element;
+
+declare function CheckSquareIcon({ className, ...props }: IconProps): React$1.JSX.Element;
+
+declare function EmptySquareIcon({ className, ...props }: IconProps): React$1.JSX.Element;
+
+interface CrossSquareIconProps extends IconProps {
+    /**
+     * Visual variant for different states
+     * - 'cancelled': subtle ash coloring
+     * - 'failed': error red coloring
+     */
+    variant?: 'cancelled' | 'failed';
+}
+declare function CrossSquareIcon({ className, variant, ...props }: CrossSquareIconProps): React$1.JSX.Element;
+
+/**
+ * Square loading spinner with "snake" animation.
+ * A golden stroke travels around a square border.
+ */
+declare function SquareLoaderIcon({ className, ...props }: IconProps): React$1.JSX.Element;
+
+interface IconProps {
+    className?: string;
+    'aria-hidden'?: boolean;
+}
+
 type MessageVariant = 'user' | 'assistant';
 interface MessageBranchInfo {
     /**
@@ -777,9 +816,10 @@ interface ConversationSidebarProps extends React$1.HTMLAttributes<HTMLDivElement
      */
     onToggleCollapse?: () => void;
     /**
-     * Current width of the sidebar (when expanded)
+     * Current width of the sidebar (when expanded).
+     * Accepts CSS width value (e.g., "15vw", "256px").
      */
-    width?: number;
+    width?: string;
     /**
      * Callback to start resizing
      */
@@ -800,6 +840,52 @@ interface CollapsedSidebarToggleProps extends React$1.ButtonHTMLAttributes<HTMLB
 }
 declare const CollapsedSidebarToggle: React$1.ForwardRefExoticComponent<CollapsedSidebarToggleProps & React$1.RefAttributes<HTMLButtonElement>>;
 
+type TaskStatus = 'pending' | 'in_progress' | 'done' | 'cancelled' | 'failed';
+interface Task {
+    /**
+     * Unique identifier for the task
+     */
+    id: string;
+    /**
+     * Task description text
+     */
+    label: string;
+    /**
+     * Current status of the task
+     */
+    status: TaskStatus;
+    /**
+     * Optional subtasks (shown when parent is in_progress or done)
+     */
+    subtasks?: Task[];
+}
+interface TodosListProps extends React$1.HTMLAttributes<HTMLDivElement> {
+    /**
+     * Array of tasks to display
+     */
+    tasks: Task[];
+    /**
+     * Title for the todos list
+     * @default "Tasks"
+     */
+    title?: string;
+}
+/**
+ * TodosList displays a structured list of tasks with status indicators.
+ *
+ * Features:
+ * - Nested tasks with indentation
+ * - Status indicators: done (checkmark), in_progress (snake animation), pending (empty), cancelled, failed
+ * - Done tasks are crossed out with golden checkmark
+ * - Cancelled/failed tasks are crossed out with subtle styling and sorted to bottom of their local group
+ * - Max 1/4 screen height with scroll
+ * - Subtasks appear when parent task is in_progress or done
+ *
+ * The component automatically sorts cancelled/failed tasks to the bottom of their local group
+ * (not globally), so just changing a task's status will reorder it appropriately.
+ */
+declare const TodosList: React$1.ForwardRefExoticComponent<TodosListProps & React$1.RefAttributes<HTMLDivElement>>;
+
 interface UseScrollAnchorOptions {
     /**
      * Behavior for scrolling. Defaults to 'smooth'.
@@ -842,7 +928,48 @@ interface UseScrollAnchorReturn {
  */
 declare function useScrollAnchor(options?: UseScrollAnchorOptions): UseScrollAnchorReturn;
 
-type ArtifactType = 'text' | 'image' | 'video';
+/**
+ * Script element types following standard screenplay format
+ */
+type ScriptElementType = 'scene-heading' | 'action' | 'character' | 'dialogue' | 'parenthetical' | 'transition' | 'title' | 'subtitle';
+/**
+ * A single element in the script
+ */
+interface ScriptElement {
+    type: ScriptElementType;
+    content: string;
+}
+interface ScriptCardProps extends React$1.HTMLAttributes<HTMLDivElement> {
+    /**
+     * Title of the script (shown at top)
+     */
+    title?: string;
+    /**
+     * Subtitle/metadata (e.g., "30-second spot • Directed by AI Creative")
+     */
+    subtitle?: string;
+    /**
+     * Array of script elements in order
+     */
+    elements: ScriptElement[];
+    /**
+     * Maximum height before scrolling (default: 16rem / 256px)
+     */
+    maxHeight?: string;
+}
+/**
+ * ScriptCard displays a formatted movie/video script.
+ *
+ * Follows standard screenplay formatting conventions:
+ * - Scene headings: uppercase, gold, left-aligned
+ * - Action: silver, full width
+ * - Character names: uppercase, centered-left
+ * - Dialogue: indented from both sides
+ * - Transitions: uppercase, right-aligned
+ */
+declare const ScriptCard: React$1.ForwardRefExoticComponent<ScriptCardProps & React$1.RefAttributes<HTMLDivElement>>;
+
+type ArtifactType = 'text' | 'image' | 'video' | 'audio' | 'html';
 interface Artifact {
     id: string;
     type: ArtifactType;
@@ -870,6 +997,14 @@ interface Artifact {
      * Whether this artifact is still loading (shows skeleton)
      */
     isPending?: boolean;
+    /**
+     * Whether the artifact should span full width in the grid
+     */
+    fullWidth?: boolean;
+    /**
+     * For html artifacts - structured script elements (used by ScriptCard)
+     */
+    scriptElements?: ScriptElement[];
 }
 interface UseArtifactsReturn {
     /**
@@ -920,13 +1055,30 @@ interface UseArtifactsReturn {
 declare function useArtifacts(): UseArtifactsReturn;
 
 interface UseResizableProps {
-    initialWidth: number;
-    minWidth: number;
-    maxWidth: number;
+    /**
+     * Initial width as percentage of viewport (0-100)
+     */
+    initialWidthPercent: number;
+    /**
+     * Minimum width as percentage of viewport (0-100)
+     */
+    minWidthPercent: number;
+    /**
+     * Maximum width as percentage of viewport (0-100)
+     */
+    maxWidthPercent: number;
+    /**
+     * Direction to resize from
+     */
     direction: 'left' | 'right';
 }
-declare function useResizable({ initialWidth, minWidth, maxWidth, direction, }: UseResizableProps): {
-    width: number;
+/**
+ * Hook for resizable panels with percentage-based widths.
+ * Returns width as a CSS percentage string (e.g., "50%").
+ */
+declare function useResizable({ initialWidthPercent, minWidthPercent, maxWidthPercent, direction, }: UseResizableProps): {
+    width: string;
+    widthPercent: number;
     isResizing: boolean;
     startResizing: (e: React.MouseEvent) => void;
 };
@@ -1172,6 +1324,16 @@ interface ChatInterfaceProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>
      * Called when the artifacts panel is opened or closed (controlled).
      */
     onArtifactsPanelOpenChange?: (open: boolean) => void;
+    /**
+     * Tasks to display in the todos list below the artifacts panel.
+     * Shows a list of tasks with status indicators.
+     */
+    tasks?: Task[];
+    /**
+     * Title for the todos list
+     * @default "Tasks"
+     */
+    tasksTitle?: string;
 }
 /**
  * ChatInterface is the main orchestrator for a full-featured chat experience.
@@ -1255,9 +1417,13 @@ interface ArtifactsPanelProps extends React$1.HTMLAttributes<HTMLDivElement> {
      */
     isLoading?: boolean;
     /**
-     * Current width of the panel (when expanded)
+     * Current width of the panel as CSS value (e.g., "50vw", "400px").
+     */
+    width?: string;
+    /**
+     * Width as percentage of viewport (0-100) for column calculations.
      */
-    width?: number;
+    widthPercent?: number;
     /**
      * Callback to start resizing
      */
@@ -1268,6 +1434,9 @@ interface ArtifactsPanelProps extends React$1.HTMLAttributes<HTMLDivElement> {
  *
  * When collapsed, shows a thin strip with layers icon at top.
  * When expanded, shows chevron at top-right to collapse.
+ * Click on artifacts to expand them to full screen modal.
+ *
+ * Supports fullWidth artifacts that span all columns in the grid.
  */
 declare const ArtifactsPanel: React$1.ForwardRefExoticComponent<ArtifactsPanelProps & React$1.RefAttributes<HTMLDivElement>>;
 /**
@@ -1415,6 +1584,21 @@ interface VideoCardProps extends Omit<CardProps, 'title'> {
 }
 declare const VideoCard: React$1.ForwardRefExoticComponent<VideoCardProps & React$1.RefAttributes<HTMLDivElement>>;
 
+interface AudioCardProps extends Omit<CardProps, 'title'> {
+    src: string;
+    title?: React$1.ReactNode;
+    subtitle?: React$1.ReactNode;
+    playing?: boolean;
+    controls?: boolean;
+    volume?: number;
+    muted?: boolean;
+    loop?: boolean;
+    mediaClassName?: string;
+    contentClassName?: string;
+    playerProps?: any;
+}
+declare const AudioCard: React$1.ForwardRefExoticComponent<AudioCardProps & React$1.RefAttributes<HTMLDivElement>>;
+
 type SectionHeadingLevel = 'h2' | 'h3';
 interface SectionHeadingProps extends React$1.HTMLAttributes<HTMLHeadingElement> {
     level?: SectionHeadingLevel;
@@ -1433,4 +1617,4 @@ declare const SectionHeading: React$1.ForwardRefExoticComponent<SectionHeadingPr
 
 declare const version = "2.0.0";
 
-export { Accordion, AccordionContent, type AccordionContentProps, AccordionItem, type AccordionItemProps, type AccordionProps, AccordionTrigger, type AccordionTriggerProps, Alert, AlertDialog, type AlertDialogProps, type AlertProps, type AlertVariant, type Artifact, type ArtifactType, ArtifactsPanel, type ArtifactsPanelProps, ArtifactsPanelToggle, type ArtifactsPanelToggleProps, type AspectRatio, type AspectRatioPreset, type Attachment, type AttachmentItem, AttachmentPreview, type AttachmentPreviewProps, type AttachmentStatus, Avatar, type AvatarProps, type AvatarSize, Badge, type BadgeProps, type BadgeVariant, BranchNavigator, type BranchNavigatorProps, BrandIcon, type BrandIconProps, type BrandIconSize, type BrandIconVariant, Breadcrumb, 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, ChatInput, type ChatInputPosition, type ChatInputProps, ChatInterface, type ChatInterfaceProps, type ChatMessage, ChatView, type ChatViewItem, type ChatViewProps, Checkbox, type CheckboxProps, Col, type ColOffset, type ColOrder, type ColProps, type ColSpan, CollapsedSidebarToggle, type CollapsedSidebarToggleProps, ColorSwatch, type ColorSwatchProps, ConfirmDialog, type ConfirmDialogProps, Container, type ContainerProps, type ContainerSize, type Conversation, ConversationSidebar, type ConversationSidebarProps, type ConversationTree, Divider, type DividerProps, Drawer, type DrawerPosition, type DrawerProps, FileChip, type FileChipProps, type FileChipStatus, HelperText, type HelperTextProps, ImageCard, type ImageCardProps, Input, type InputAddonProps, type InputElementProps, InputGroup, type InputGroupProps, InputLeftAddon, InputLeftElement, type InputProps, InputRightAddon, InputRightElement, InputWrapper, type InputWrapperProps, Label, type LabelProps, List, ListItem, type ListItemProps, ListItemText, type ListItemTextProps, type ListProps, ListSubheader, type ListSubheaderProps, MarkdownContent, type MarkdownContentProps, 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, Navbar, NavbarBrand, type NavbarBrandProps, NavbarContent, type NavbarContentProps, NavbarDivider, NavbarItem, type NavbarItemProps, NavbarLink, type NavbarLinkProps, type NavbarProps, Pagination, type PaginationProps, 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, SectionHeading, type SectionHeadingLevel, type SectionHeadingProps, Select, type SelectOption, type SelectProps, Skeleton, type SkeletonProps, Slider, type SliderProps, Spinner, type SpinnerProps, Stack, type StackDirection, type StackGap, type StackProps, type Step, type StepStatus, Stepper, type StepperProps, StreamingCursor, type StreamingCursorProps, Switch, type SwitchProps, 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, Textarea, type TextareaProps, ThinkingIndicator, type ThinkingIndicatorProps, type ToastData, type ToastPosition, ToastProvider, type ToastProviderProps, type ToastVariant, Tooltip, type TooltipProps, type UseArtifactsReturn, type UseScrollAnchorOptions, type UseScrollAnchorReturn, type VideoAspectRatio, type VideoAspectRatioPreset, VideoCard, type VideoCardProps, addMessageToTree, createEmptyTree, createPreviewUrl, generateId, getActivePathMessages, getSiblingInfo, isBranchPoint, isImageFile, messagesToTree, revokePreviewUrl, switchBranch, updateNodeContent, useArtifacts, useResizable, useScrollAnchor, useToast, version };
+export { Accordion, AccordionContent, type AccordionContentProps, AccordionItem, type AccordionItemProps, type AccordionProps, AccordionTrigger, type AccordionTriggerProps, Alert, AlertDialog, type AlertDialogProps, type AlertProps, type AlertVariant, type Artifact, type ArtifactType, 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, 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, ChatInput, type ChatInputPosition, type ChatInputProps, ChatInterface, type ChatInterfaceProps, type ChatMessage, ChatView, type ChatViewItem, type ChatViewProps, CheckSquareIcon, Checkbox, type CheckboxProps, ChevronLeftIcon, ChevronRightIcon, CloseIcon, Col, type ColOffset, type ColOrder, type ColProps, type ColSpan, CollapsedSidebarToggle, type CollapsedSidebarToggleProps, ColorSwatch, type ColorSwatchProps, ConfirmDialog, type ConfirmDialogProps, Container, type ContainerProps, type ContainerSize, type Conversation, ConversationSidebar, type ConversationSidebarProps, type ConversationTree, CrossSquareIcon, Divider, type DividerProps, Drawer, type DrawerPosition, type DrawerProps, EmptySquareIcon, ExpandIcon, FileChip, type FileChipProps, type FileChipStatus, HelperText, type HelperTextProps, HistoryIcon, 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, 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, Navbar, NavbarBrand, type NavbarBrandProps, NavbarContent, type NavbarContentProps, NavbarDivider, NavbarItem, type NavbarItemProps, NavbarLink, type NavbarLinkProps, type NavbarProps, Pagination, type PaginationProps, 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, 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, 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, Textarea, type TextareaProps, ThinkingIndicator, type ThinkingIndicatorProps, type ToastData, type ToastPosition, ToastProvider, type ToastProviderProps, type ToastVariant, TodosList, type TodosListProps, Tooltip, type TooltipProps, type UseArtifactsReturn, type UseScrollAnchorOptions, type UseScrollAnchorReturn, type VideoAspectRatio, type VideoAspectRatioPreset, VideoCard, type VideoCardProps, addMessageToTree, createEmptyTree, createPreviewUrl, generateId, getActivePathMessages, getSiblingInfo, isBranchPoint, isImageFile, messagesToTree, revokePreviewUrl, switchBranch, updateNodeContent, useArtifacts, useResizable, useScrollAnchor, useToast, version };