@lukeashford/aurelius 2.21.0 → 3.0.0

package/dist/index.d.mts

@@ -921,48 +921,6 @@ declare const TodosList: React$1.ForwardRefExoticComponent<TodosListProps & Reac
  */
 declare function areAllTasksSettled(tasks: Task[]): boolean;
 
-interface UseScrollAnchorOptions {
-    /**
-     * Behavior for scrolling. Defaults to 'smooth'.
-     */
-    behavior?: ScrollBehavior;
-    /**
-     * Block alignment for scrollIntoView. Defaults to 'start'.
-     */
-    block?: ScrollLogicalPosition;
-}
-interface UseScrollAnchorReturn {
-    /**
-     * Ref to attach to the scrollable container
-     */
-    containerRef: React.RefObject<HTMLDivElement | null>;
-    /**
-     * Ref to attach to the anchor element (latest user message)
-     */
-    anchorRef: React.RefObject<HTMLDivElement | null>;
-    /**
-     * Scroll the anchor element into view. Call this on user message submission.
-     */
-    scrollToAnchor: () => void;
-    /**
-     * Scroll to the bottom of the container.
-     */
-    scrollToBottom: () => void;
-    /**
-     * Check if user has scrolled away from the bottom.
-     */
-    isScrolledToBottom: () => boolean;
-}
-/**
- * Hook for smart scroll behavior in chat interfaces.
- *
- * Key behaviors:
- * - Anchors user messages to the top of the viewport when they send a message
- * - Does NOT auto-scroll during streaming to respect user's reading position
- * - Allows manual scroll detection
- */
-declare function useScrollAnchor(options?: UseScrollAnchorOptions): UseScrollAnchorReturn;
-
 /**
  * Script element types following standard screenplay format
  */
@@ -1108,83 +1066,6 @@ interface ArtifactCardProps extends React$1.HTMLAttributes<HTMLDivElement> {
  */
 declare const ArtifactCard: React$1.ForwardRefExoticComponent<ArtifactCardProps & React$1.RefAttributes<HTMLDivElement>>;
 
-interface UseArtifactsReturn {
-    /**
-     * Current list of artifacts
-     */
-    artifacts: Artifact[];
-    /**
-     * Schedule a new artifact (adds to list with isPending=true, shows skeleton).
-     */
-    scheduleArtifact: (artifact: Omit<Artifact, 'isPending'>) => void;
-    /**
-     * Show an artifact (updates existing or adds new with isPending=false).
-     */
-    showArtifact: (artifactId: string, artifact: Omit<Artifact, 'id' | 'isPending'>) => void;
-    /**
-     * Remove an artifact from the list.
-     */
-    removeArtifact: (artifactId: string) => void;
-    /**
-     * Clear all artifacts
-     */
-    clearArtifacts: () => void;
-}
-/**
- * Hook for managing artifacts in the ChatInterface.
- *
- * Provides methods to control the artifacts panel programmatically,
- * designed for event-driven architectures like SSE streams.
- *
- * @example
- * ```tsx
- * const { artifacts, scheduleArtifact, showArtifact, removeArtifact } = useArtifacts()
- *
- * // When SSE operator.started event arrives
- * scheduleArtifact({ id: operatorId, type: 'IMAGE' })
- *
- * // When SSE artifact.created event arrives
- * showArtifact(artifactId, {
- *   type: 'IMAGE',
- *   url: 'https://example.com/image.png',
- *   title: 'Generated Image',
- * })
- *
- * // When SSE operator.failed event arrives
- * removeArtifact(operatorId)
- * ```
- */
-declare function useArtifacts(): UseArtifactsReturn;
-
-interface UseResizableProps {
-    /**
-     * 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';
-}
-/**
- * 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;
-};
-
 /**
  * Node types in the artifact tree
  */
@@ -1225,39 +1106,6 @@ interface ArtifactNode {
     children: ArtifactNode[];
 }
 
-/**
- * A breadcrumb entry representing one level of navigation depth.
- */
-interface BreadcrumbEntry {
-    /** Display label for this level */
-    label: string;
-    /** The group node at this level (null for root) */
-    node: ArtifactNode | null;
-}
-/**
- * Return type for the useArtifactTreeNavigation hook.
- */
-interface UseArtifactTreeNavigationReturn {
-    /** Nodes to display at the current navigation level */
-    currentNodes: ArtifactNode[];
-    /** Breadcrumb trail from root to current level */
-    breadcrumbs: BreadcrumbEntry[];
-    /** Whether the user is at the root level */
-    isAtRoot: boolean;
-    /** Navigate into a group node, pushing it onto the stack */
-    navigateInto: (node: ArtifactNode) => void;
-    /** Navigate to a specific breadcrumb level by index */
-    navigateTo: (index: number) => void;
-    /** Navigate back one level */
-    navigateBack: () => void;
-}
-/**
- * Manages navigation state for an artifact tree panel.
- * Maintains a stack of group nodes the user has navigated into,
- * deriving children from the node references themselves.
- */
-declare function useArtifactTreeNavigation(rootNodes: ArtifactNode[]): UseArtifactTreeNavigationReturn;
-
 /**
  * Conversation Tree Types
  *
@@ -1487,13 +1335,7 @@ interface ChatInterfaceProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>
      */
     onAttachmentsChange?: (attachments: Attachment[]) => void;
     /**
-     * Artifacts to display in the side panel.
-     * Best managed via the useArtifacts hook and passed here.
-     */
-    artifacts?: Artifact[];
-    /**
-     * Top-level artifact tree nodes for tree-aware navigation.
-     * When provided, the panel renders a navigable tree instead of a flat list.
+     * Top-level artifact tree nodes for the artifacts panel.
      */
     artifactNodes?: ArtifactNode[];
     /**
@@ -1532,10 +1374,8 @@ interface ChatInterfaceProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>
  * - Message Actions — copy, edit, retry
  * - Thinking Indicator — shown between user message and response
  *
- * Artifacts are controlled externally via the useArtifacts hook:
- * - scheduleArtifact() — adds artifact with loading skeleton
- * - showArtifact() — reveals artifact content
- * - removeArtifact() — removes artifact on failure
+ * Artifacts are supplied as a tree of ArtifactNode objects via the
+ * artifactNodes prop.
  */
 declare const ChatInterface: React$1.ForwardRefExoticComponent<ChatInterfaceProps & React$1.RefAttributes<HTMLDivElement>>;
 
@@ -1586,15 +1426,9 @@ declare const ChatView: React$1.ForwardRefExoticComponent<ChatViewProps & React$
 
 interface ArtifactsPanelProps extends React$1.HTMLAttributes<HTMLDivElement> {
     /**
-     * Top-level tree nodes to display. When provided, the panel renders
-     * a navigable artifact tree instead of a flat list.
+     * Top-level tree nodes to display in the navigable artifact tree.
      */
     nodes?: ArtifactNode[];
-    /**
-     * Array of flat artifacts to display (legacy/simple mode).
-     * Ignored when `nodes` is provided.
-     */
-    artifacts?: Artifact[];
     /**
      * Whether artifacts are still loading (show skeletons)
      */
@@ -1607,16 +1441,13 @@ interface ArtifactsPanelProps extends React$1.HTMLAttributes<HTMLDivElement> {
  * placed in. Opening/closing and resizing are handled by the parent
  * ToolPanelContainer and ToolSidebar.
  *
- * When provided with `nodes`, it renders a tree-aware, navigable panel
- * where groups can be entered (breadcrumb navigation) and artifacts
+ * Groups can be entered (breadcrumb navigation) and artifact nodes
  * can be expanded to a full-screen modal.
  *
- * When provided with flat `artifacts`, it renders them in a simple grid.
- *
- * Supports zoom controls (0.25x–1x) in tree mode. Zoom uses CSS
- * `transform: scale()` on the content wrapper so the entire layout scales
- * uniformly — cards, images, gaps, and text all shrink as if the viewer
- * is physically moving back from the content.
+ * Supports zoom controls (0.25x–1x). Zoom uses CSS `transform: scale()`
+ * on the content wrapper so the entire layout scales uniformly — cards,
+ * images, gaps, and text all shrink as if the viewer is physically
+ * moving back from the content.
  */
 declare const ArtifactsPanel: React$1.ForwardRefExoticComponent<ArtifactsPanelProps & React$1.RefAttributes<HTMLDivElement>>;
 /**
@@ -1800,6 +1631,110 @@ interface BranchNavigatorProps extends React$1.HTMLAttributes<HTMLDivElement> {
  */
 declare const BranchNavigator: React$1.ForwardRefExoticComponent<BranchNavigatorProps & React$1.RefAttributes<HTMLDivElement>>;
 
+interface UseScrollAnchorOptions {
+    /**
+     * Behavior for scrolling. Defaults to 'smooth'.
+     */
+    behavior?: ScrollBehavior;
+    /**
+     * Block alignment for scrollIntoView. Defaults to 'start'.
+     */
+    block?: ScrollLogicalPosition;
+}
+interface UseScrollAnchorReturn {
+    /**
+     * Ref to attach to the scrollable container
+     */
+    containerRef: React.RefObject<HTMLDivElement | null>;
+    /**
+     * Ref to attach to the anchor element (latest user message)
+     */
+    anchorRef: React.RefObject<HTMLDivElement | null>;
+    /**
+     * Scroll the anchor element into view. Call this on user message submission.
+     */
+    scrollToAnchor: () => void;
+    /**
+     * Scroll to the bottom of the container.
+     */
+    scrollToBottom: () => void;
+    /**
+     * Check if user has scrolled away from the bottom.
+     */
+    isScrolledToBottom: () => boolean;
+}
+/**
+ * Hook for smart scroll behavior in chat interfaces.
+ *
+ * Key behaviors:
+ * - Anchors user messages to the top of the viewport when they send a message
+ * - Does NOT auto-scroll during streaming to respect user's reading position
+ * - Allows manual scroll detection
+ */
+declare function useScrollAnchor(options?: UseScrollAnchorOptions): UseScrollAnchorReturn;
+
+interface UseResizableProps {
+    /**
+     * 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';
+}
+/**
+ * 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;
+};
+
+/**
+ * A breadcrumb entry representing one level of navigation depth.
+ */
+interface BreadcrumbEntry {
+    /** Display label for this level */
+    label: string;
+    /** The group node at this level (null for root) */
+    node: ArtifactNode | null;
+}
+/**
+ * Return type for the useArtifactTreeNavigation hook.
+ */
+interface UseArtifactTreeNavigationReturn {
+    /** Nodes to display at the current navigation level */
+    currentNodes: ArtifactNode[];
+    /** Breadcrumb trail from root to current level */
+    breadcrumbs: BreadcrumbEntry[];
+    /** Whether the user is at the root level */
+    isAtRoot: boolean;
+    /** Navigate into a group node, pushing it onto the stack */
+    navigateInto: (node: ArtifactNode) => void;
+    /** Navigate to a specific breadcrumb level by index */
+    navigateTo: (index: number) => void;
+    /** Navigate back one level */
+    navigateBack: () => void;
+}
+/**
+ * Manages navigation state for an artifact tree panel.
+ * Maintains a stack of group nodes the user has navigated into,
+ * deriving children from the node references themselves.
+ */
+declare function useArtifactTreeNavigation(rootNodes: ArtifactNode[]): UseArtifactTreeNavigationReturn;
+
 type BrandIconSize = 'sm' | 'md' | 'lg';
 type BrandIconVariant = 'solid' | 'outline';
 interface BrandIconProps extends React$1.HTMLAttributes<HTMLDivElement> {
@@ -1991,4 +1926,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, 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, 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, ToolPanelContainer, type ToolPanelContainerProps, type ToolPanelState, ToolSidebar, type ToolSidebarProps, Tooltip, type TooltipProps, type UseArtifactTreeNavigationReturn, type UseArtifactsReturn, 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, useArtifacts, 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, 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, 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, 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 };