@lukeashford/aurelius 4.8.0 → 4.10.0

package/dist/index.d.mts

@@ -1535,9 +1535,13 @@ interface Deliverable {
     clientName?: string | null;
     /** Optional accent hex color (e.g. "#fecb6b"). Falls back to design-system gold. */
     accentColor?: string | null;
+    /** Optional theme preset. Defaults to `cinematic` when omitted. */
+    theme?: DeliverableTheme | null;
     /** Ordered sections. Render in array order. */
     sections: DeliverableSection[];
 }
+/** Document-level visual identity preset. */
+type DeliverableTheme = 'cinematic' | 'editorial' | 'minimal' | 'playful';
 /**
  * Discriminated union of section types. Each variant has a matching renderer
  * in aurelius — the agent fills the spec, never raw layout instructions.
@@ -1554,14 +1558,39 @@ interface ArtifactImageGridSection$1 {
     heading?: string | null;
     /** 1, 2 or 3. */
     columns: number;
+    /**
+     * Aspect ratio applied to every image in the grid. Defaults to `landscape`
+     * when omitted.
+     */
+    aspectRatio?: ImageGridAspectRatio | null;
     items: DeliverableImageItem[];
 }
+/**
+ * Allowed values for {@link ArtifactImageGridSection.aspectRatio}. Each
+ * controls a single CSS `aspect-ratio` applied uniformly across the grid:
+ * `landscape` → 4:3, `portrait` → 3:4, `square` → 1:1, `wide` → 16:9.
+ */
+type ImageGridAspectRatio = 'landscape' | 'portrait' | 'square' | 'wide';
 interface ArtifactSpotlightSection$1 {
     type: 'ARTIFACT_SPOTLIGHT';
     heading?: string | null;
     artifact: DeliverableArtifactRef;
     body?: string | null;
+    /**
+     * Layout variant. Defaults to `framed` when omitted.
+     */
+    variant?: SpotlightVariant | null;
 }
+/**
+ * Allowed values for {@link ArtifactSpotlightSection.variant}.
+ * `framed`       → image above body (default).
+ * `full-bleed`   → image claims a full edge-to-edge page in print; the
+ *                  heading and body are suppressed in print so the image
+ *                  alone carries the page. Use sparingly — once or twice
+ *                  per deck — for the marquee moment.
+ * `side-by-side` → image left, body right on the same page.
+ */
+type SpotlightVariant = 'framed' | 'full-bleed' | 'side-by-side';
 interface TextBlockSection$1 {
     type: 'TEXT_BLOCK';
     heading?: string | null;
@@ -1648,7 +1677,8 @@ interface ArtifactSpotlightSectionProps {
 }
 /**
  * A single hero artifact image with optional prose alongside. Reads at full
- * page width on screen and prints to a single page.
+ * page width on screen and prints to a single page (or a full-bleed page for
+ * the `full-bleed` variant).
  */
 declare function ArtifactSpotlightSection({ data }: ArtifactSpotlightSectionProps): React$1.JSX.Element;
 
@@ -1882,6 +1912,24 @@ interface Conversation {
      */
     isActive?: boolean;
 }
+/**
+ * Imperative API exposed by `ChatInterface` via its forwarded ref. Use this from
+ * call sites that need to drive the chat from outside React state — typically
+ * to surface an artifact when the user clicks a `MentionChip` or other
+ * cross-surface pointer. Attach with
+ * `useRef<ChatInterfaceHandle>(null)` and read `ref.current?.openArtifact(name)`.
+ */
+interface ChatInterfaceHandle {
+    /**
+     * Open the artifact lightbox for the given artifact name. Ensures the
+     * artifacts panel is open (overriding any prior dismissal) before
+     * surfacing the lightbox, since the lightbox renders inside the panel.
+     * If the name is not present in the current artifact tree, the call is a
+     * no-op — the chip's leading icon already signals unknown / stale
+     * references via `HelpCircle`.
+     */
+    openArtifact(name: string): void;
+}
 interface ChatInterfaceProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>, 'onSubmit'> {
     /**
      * Array of messages in the conversation (flat mode)
@@ -2109,7 +2157,7 @@ interface ChatInterfaceProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>
  * Artifacts are supplied as a tree of ArtifactNode objects via the
  * artifactNodes prop.
  */
-declare const ChatInterface: React$1.ForwardRefExoticComponent<ChatInterfaceProps & React$1.RefAttributes<HTMLDivElement>>;
+declare const ChatInterface: React$1.ForwardRefExoticComponent<ChatInterfaceProps & React$1.RefAttributes<ChatInterfaceHandle>>;
 
 /**
  * What kind of project mutation produced this checkpoint. Drives the icon and
@@ -2831,4 +2879,4 @@ declare function getTextareaCaretCoords(textarea: HTMLTextAreaElement): Textarea
 
 declare const version = "2.0.0";
 
-export { ARTIFACT_TYPES, Accordion, AccordionContent, type AccordionContentProps, AccordionItem, type AccordionItemProps, type AccordionProps, AccordionTrigger, type AccordionTriggerProps, type AddNodeOptions, Alert, AlertDialog, type AlertDialogProps, type AlertProps, type AlertVariant, type Artifact, ArtifactCard, type ArtifactCardProps, ArtifactGroup, type ArtifactGroupProps, ArtifactImageGridSection, type ArtifactImageGridSectionProps, type ArtifactNode, ArtifactSpotlightSection, type ArtifactSpotlightSectionProps, 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, type ChatNode, ChatView, type ChatViewCheckpointItem, type ChatViewDividerItem, type ChatViewItem, type ChatViewMessageItem, type ChatViewProps, CheckSquareIcon, Checkbox, type CheckboxProps, Checkpoint, type CheckpointBranchInfo, type CheckpointExecutionKind, type CheckpointNode, type CheckpointProps, type CheckpointStatus, ChevronLeftIcon, ChevronRightIcon, CloseIcon, Col, type ColOffset, type ColOrder, type ColProps, type ColSpan, ColorPaletteSection, type ColorPaletteSectionProps, ColorSwatch, type ColorSwatchProps, Combobox, type ComboboxNav, type ComboboxProps, ConfirmDialog, type ConfirmDialogProps, Container, type ContainerProps, type ContainerSize, type Conversation, type ConversationTree, CoverSection, type CoverSectionProps, CrossSquareIcon, type Deliverable, type DeliverableArtifactRef, DeliverableCard, type DeliverableCardProps, type DeliverableImageItem, DeliverableRenderer, type DeliverableRendererProps, type DeliverableSection, type DeliverableSwatch, Divider, type DividerProps, Drawer, type DrawerPosition, type DrawerProps, EmptySquareIcon, ExpandIcon, type ExternalToolDefinition, FileChip, type FileChipProps, type FileChipStatus, GreyedDivider, type GreyedDividerProps, 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, Lightbox, type LightboxProps, List, ListItem, type ListItemProps, ListItemText, type ListItemTextProps, type ListProps, ListSubheader, type ListSubheaderProps, MarkdownContent, type MarkdownContentProps, MediaIcon, MentionChip, type MentionChipProps, 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 NodeTopology, type NodeType, Pagination, type PaginationProps, PdfCard, type PdfCardProps, PlusIcon, Popover, type PopoverAlign, type PopoverPosition, type PopoverProps, Progress, type ProgressProps, PromptDialog, type PromptDialogProps, QuoteBlockSection, type QuoteBlockSectionProps, 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, TextBlockSection, type TextBlockSectionProps, TextCard, type TextCardProps, Textarea, type TextareaCaretCoords, 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 TreeNode, type UseArtifactTreeNavigationReturn, type UseComboboxNavOptions, type UseScrollAnchorOptions, type UseScrollAnchorReturn, type VideoAspectRatio, type VideoAspectRatioPreset, VideoCard, type VideoCardProps, addNodeToTree, areAllTasksSettled, createEmptyTree, createPreviewUrl, findAncestor, generateId, getActivePath, getGreyedFuture, getSiblingInfo, getTextareaCaretCoords, isBranchPoint, isImageFile, messagesToTree, revokePreviewUrl, setActiveLeaf, switchBranch, updateMessageContent, useArtifactTreeNavigation, useComboboxNav, useResizable, useScrollAnchor, useToast, version };
+export { ARTIFACT_TYPES, Accordion, AccordionContent, type AccordionContentProps, AccordionItem, type AccordionItemProps, type AccordionProps, AccordionTrigger, type AccordionTriggerProps, type AddNodeOptions, Alert, AlertDialog, type AlertDialogProps, type AlertProps, type AlertVariant, type Artifact, ArtifactCard, type ArtifactCardProps, ArtifactGroup, type ArtifactGroupProps, ArtifactImageGridSection, type ArtifactImageGridSectionProps, type ArtifactNode, ArtifactSpotlightSection, type ArtifactSpotlightSectionProps, 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 ChatInterfaceHandle, type ChatInterfaceProps, type ChatNode, ChatView, type ChatViewCheckpointItem, type ChatViewDividerItem, type ChatViewItem, type ChatViewMessageItem, type ChatViewProps, CheckSquareIcon, Checkbox, type CheckboxProps, Checkpoint, type CheckpointBranchInfo, type CheckpointExecutionKind, type CheckpointNode, type CheckpointProps, type CheckpointStatus, ChevronLeftIcon, ChevronRightIcon, CloseIcon, Col, type ColOffset, type ColOrder, type ColProps, type ColSpan, ColorPaletteSection, type ColorPaletteSectionProps, ColorSwatch, type ColorSwatchProps, Combobox, type ComboboxNav, type ComboboxProps, ConfirmDialog, type ConfirmDialogProps, Container, type ContainerProps, type ContainerSize, type Conversation, type ConversationTree, CoverSection, type CoverSectionProps, CrossSquareIcon, type Deliverable, type DeliverableArtifactRef, DeliverableCard, type DeliverableCardProps, type DeliverableImageItem, DeliverableRenderer, type DeliverableRendererProps, type DeliverableSection, type DeliverableSwatch, type DeliverableTheme, Divider, type DividerProps, Drawer, type DrawerPosition, type DrawerProps, EmptySquareIcon, ExpandIcon, type ExternalToolDefinition, FileChip, type FileChipProps, type FileChipStatus, GreyedDivider, type GreyedDividerProps, HelperText, type HelperTextProps, HistoryIcon, HistoryPanel, type HistoryPanelProps, type IconProps, ImageCard, type ImageCardProps, type ImageGridAspectRatio, Input, type InputAddonProps, type InputElementProps, InputGroup, type InputGroupProps, InputLeftAddon, InputLeftElement, type InputProps, InputRightAddon, InputRightElement, InputWrapper, type InputWrapperProps, Label, type LabelProps, LayersIcon, Lightbox, type LightboxProps, List, ListItem, type ListItemProps, ListItemText, type ListItemTextProps, type ListProps, ListSubheader, type ListSubheaderProps, MarkdownContent, type MarkdownContentProps, MediaIcon, MentionChip, type MentionChipProps, 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 NodeTopology, type NodeType, Pagination, type PaginationProps, PdfCard, type PdfCardProps, PlusIcon, Popover, type PopoverAlign, type PopoverPosition, type PopoverProps, Progress, type ProgressProps, PromptDialog, type PromptDialogProps, QuoteBlockSection, type QuoteBlockSectionProps, 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, type SpotlightVariant, 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, TextBlockSection, type TextBlockSectionProps, TextCard, type TextCardProps, Textarea, type TextareaCaretCoords, 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 TreeNode, type UseArtifactTreeNavigationReturn, type UseComboboxNavOptions, type UseScrollAnchorOptions, type UseScrollAnchorReturn, type VideoAspectRatio, type VideoAspectRatioPreset, VideoCard, type VideoCardProps, addNodeToTree, areAllTasksSettled, createEmptyTree, createPreviewUrl, findAncestor, generateId, getActivePath, getGreyedFuture, getSiblingInfo, getTextareaCaretCoords, isBranchPoint, isImageFile, messagesToTree, revokePreviewUrl, setActiveLeaf, switchBranch, updateMessageContent, useArtifactTreeNavigation, useComboboxNav, useResizable, useScrollAnchor, useToast, version };

package/dist/index.d.ts

@@ -1535,9 +1535,13 @@ interface Deliverable {
     clientName?: string | null;
     /** Optional accent hex color (e.g. "#fecb6b"). Falls back to design-system gold. */
     accentColor?: string | null;
+    /** Optional theme preset. Defaults to `cinematic` when omitted. */
+    theme?: DeliverableTheme | null;
     /** Ordered sections. Render in array order. */
     sections: DeliverableSection[];
 }
+/** Document-level visual identity preset. */
+type DeliverableTheme = 'cinematic' | 'editorial' | 'minimal' | 'playful';
 /**
  * Discriminated union of section types. Each variant has a matching renderer
  * in aurelius — the agent fills the spec, never raw layout instructions.
@@ -1554,14 +1558,39 @@ interface ArtifactImageGridSection$1 {
     heading?: string | null;
     /** 1, 2 or 3. */
     columns: number;
+    /**
+     * Aspect ratio applied to every image in the grid. Defaults to `landscape`
+     * when omitted.
+     */
+    aspectRatio?: ImageGridAspectRatio | null;
     items: DeliverableImageItem[];
 }
+/**
+ * Allowed values for {@link ArtifactImageGridSection.aspectRatio}. Each
+ * controls a single CSS `aspect-ratio` applied uniformly across the grid:
+ * `landscape` → 4:3, `portrait` → 3:4, `square` → 1:1, `wide` → 16:9.
+ */
+type ImageGridAspectRatio = 'landscape' | 'portrait' | 'square' | 'wide';
 interface ArtifactSpotlightSection$1 {
     type: 'ARTIFACT_SPOTLIGHT';
     heading?: string | null;
     artifact: DeliverableArtifactRef;
     body?: string | null;
+    /**
+     * Layout variant. Defaults to `framed` when omitted.
+     */
+    variant?: SpotlightVariant | null;
 }
+/**
+ * Allowed values for {@link ArtifactSpotlightSection.variant}.
+ * `framed`       → image above body (default).
+ * `full-bleed`   → image claims a full edge-to-edge page in print; the
+ *                  heading and body are suppressed in print so the image
+ *                  alone carries the page. Use sparingly — once or twice
+ *                  per deck — for the marquee moment.
+ * `side-by-side` → image left, body right on the same page.
+ */
+type SpotlightVariant = 'framed' | 'full-bleed' | 'side-by-side';
 interface TextBlockSection$1 {
     type: 'TEXT_BLOCK';
     heading?: string | null;
@@ -1648,7 +1677,8 @@ interface ArtifactSpotlightSectionProps {
 }
 /**
  * A single hero artifact image with optional prose alongside. Reads at full
- * page width on screen and prints to a single page.
+ * page width on screen and prints to a single page (or a full-bleed page for
+ * the `full-bleed` variant).
  */
 declare function ArtifactSpotlightSection({ data }: ArtifactSpotlightSectionProps): React$1.JSX.Element;
 
@@ -1882,6 +1912,24 @@ interface Conversation {
      */
     isActive?: boolean;
 }
+/**
+ * Imperative API exposed by `ChatInterface` via its forwarded ref. Use this from
+ * call sites that need to drive the chat from outside React state — typically
+ * to surface an artifact when the user clicks a `MentionChip` or other
+ * cross-surface pointer. Attach with
+ * `useRef<ChatInterfaceHandle>(null)` and read `ref.current?.openArtifact(name)`.
+ */
+interface ChatInterfaceHandle {
+    /**
+     * Open the artifact lightbox for the given artifact name. Ensures the
+     * artifacts panel is open (overriding any prior dismissal) before
+     * surfacing the lightbox, since the lightbox renders inside the panel.
+     * If the name is not present in the current artifact tree, the call is a
+     * no-op — the chip's leading icon already signals unknown / stale
+     * references via `HelpCircle`.
+     */
+    openArtifact(name: string): void;
+}
 interface ChatInterfaceProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>, 'onSubmit'> {
     /**
      * Array of messages in the conversation (flat mode)
@@ -2109,7 +2157,7 @@ interface ChatInterfaceProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>
  * Artifacts are supplied as a tree of ArtifactNode objects via the
  * artifactNodes prop.
  */
-declare const ChatInterface: React$1.ForwardRefExoticComponent<ChatInterfaceProps & React$1.RefAttributes<HTMLDivElement>>;
+declare const ChatInterface: React$1.ForwardRefExoticComponent<ChatInterfaceProps & React$1.RefAttributes<ChatInterfaceHandle>>;
 
 /**
  * What kind of project mutation produced this checkpoint. Drives the icon and
@@ -2831,4 +2879,4 @@ declare function getTextareaCaretCoords(textarea: HTMLTextAreaElement): Textarea
 
 declare const version = "2.0.0";
 
-export { ARTIFACT_TYPES, Accordion, AccordionContent, type AccordionContentProps, AccordionItem, type AccordionItemProps, type AccordionProps, AccordionTrigger, type AccordionTriggerProps, type AddNodeOptions, Alert, AlertDialog, type AlertDialogProps, type AlertProps, type AlertVariant, type Artifact, ArtifactCard, type ArtifactCardProps, ArtifactGroup, type ArtifactGroupProps, ArtifactImageGridSection, type ArtifactImageGridSectionProps, type ArtifactNode, ArtifactSpotlightSection, type ArtifactSpotlightSectionProps, 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, type ChatNode, ChatView, type ChatViewCheckpointItem, type ChatViewDividerItem, type ChatViewItem, type ChatViewMessageItem, type ChatViewProps, CheckSquareIcon, Checkbox, type CheckboxProps, Checkpoint, type CheckpointBranchInfo, type CheckpointExecutionKind, type CheckpointNode, type CheckpointProps, type CheckpointStatus, ChevronLeftIcon, ChevronRightIcon, CloseIcon, Col, type ColOffset, type ColOrder, type ColProps, type ColSpan, ColorPaletteSection, type ColorPaletteSectionProps, ColorSwatch, type ColorSwatchProps, Combobox, type ComboboxNav, type ComboboxProps, ConfirmDialog, type ConfirmDialogProps, Container, type ContainerProps, type ContainerSize, type Conversation, type ConversationTree, CoverSection, type CoverSectionProps, CrossSquareIcon, type Deliverable, type DeliverableArtifactRef, DeliverableCard, type DeliverableCardProps, type DeliverableImageItem, DeliverableRenderer, type DeliverableRendererProps, type DeliverableSection, type DeliverableSwatch, Divider, type DividerProps, Drawer, type DrawerPosition, type DrawerProps, EmptySquareIcon, ExpandIcon, type ExternalToolDefinition, FileChip, type FileChipProps, type FileChipStatus, GreyedDivider, type GreyedDividerProps, 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, Lightbox, type LightboxProps, List, ListItem, type ListItemProps, ListItemText, type ListItemTextProps, type ListProps, ListSubheader, type ListSubheaderProps, MarkdownContent, type MarkdownContentProps, MediaIcon, MentionChip, type MentionChipProps, 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 NodeTopology, type NodeType, Pagination, type PaginationProps, PdfCard, type PdfCardProps, PlusIcon, Popover, type PopoverAlign, type PopoverPosition, type PopoverProps, Progress, type ProgressProps, PromptDialog, type PromptDialogProps, QuoteBlockSection, type QuoteBlockSectionProps, 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, TextBlockSection, type TextBlockSectionProps, TextCard, type TextCardProps, Textarea, type TextareaCaretCoords, 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 TreeNode, type UseArtifactTreeNavigationReturn, type UseComboboxNavOptions, type UseScrollAnchorOptions, type UseScrollAnchorReturn, type VideoAspectRatio, type VideoAspectRatioPreset, VideoCard, type VideoCardProps, addNodeToTree, areAllTasksSettled, createEmptyTree, createPreviewUrl, findAncestor, generateId, getActivePath, getGreyedFuture, getSiblingInfo, getTextareaCaretCoords, isBranchPoint, isImageFile, messagesToTree, revokePreviewUrl, setActiveLeaf, switchBranch, updateMessageContent, useArtifactTreeNavigation, useComboboxNav, useResizable, useScrollAnchor, useToast, version };
+export { ARTIFACT_TYPES, Accordion, AccordionContent, type AccordionContentProps, AccordionItem, type AccordionItemProps, type AccordionProps, AccordionTrigger, type AccordionTriggerProps, type AddNodeOptions, Alert, AlertDialog, type AlertDialogProps, type AlertProps, type AlertVariant, type Artifact, ArtifactCard, type ArtifactCardProps, ArtifactGroup, type ArtifactGroupProps, ArtifactImageGridSection, type ArtifactImageGridSectionProps, type ArtifactNode, ArtifactSpotlightSection, type ArtifactSpotlightSectionProps, 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 ChatInterfaceHandle, type ChatInterfaceProps, type ChatNode, ChatView, type ChatViewCheckpointItem, type ChatViewDividerItem, type ChatViewItem, type ChatViewMessageItem, type ChatViewProps, CheckSquareIcon, Checkbox, type CheckboxProps, Checkpoint, type CheckpointBranchInfo, type CheckpointExecutionKind, type CheckpointNode, type CheckpointProps, type CheckpointStatus, ChevronLeftIcon, ChevronRightIcon, CloseIcon, Col, type ColOffset, type ColOrder, type ColProps, type ColSpan, ColorPaletteSection, type ColorPaletteSectionProps, ColorSwatch, type ColorSwatchProps, Combobox, type ComboboxNav, type ComboboxProps, ConfirmDialog, type ConfirmDialogProps, Container, type ContainerProps, type ContainerSize, type Conversation, type ConversationTree, CoverSection, type CoverSectionProps, CrossSquareIcon, type Deliverable, type DeliverableArtifactRef, DeliverableCard, type DeliverableCardProps, type DeliverableImageItem, DeliverableRenderer, type DeliverableRendererProps, type DeliverableSection, type DeliverableSwatch, type DeliverableTheme, Divider, type DividerProps, Drawer, type DrawerPosition, type DrawerProps, EmptySquareIcon, ExpandIcon, type ExternalToolDefinition, FileChip, type FileChipProps, type FileChipStatus, GreyedDivider, type GreyedDividerProps, HelperText, type HelperTextProps, HistoryIcon, HistoryPanel, type HistoryPanelProps, type IconProps, ImageCard, type ImageCardProps, type ImageGridAspectRatio, Input, type InputAddonProps, type InputElementProps, InputGroup, type InputGroupProps, InputLeftAddon, InputLeftElement, type InputProps, InputRightAddon, InputRightElement, InputWrapper, type InputWrapperProps, Label, type LabelProps, LayersIcon, Lightbox, type LightboxProps, List, ListItem, type ListItemProps, ListItemText, type ListItemTextProps, type ListProps, ListSubheader, type ListSubheaderProps, MarkdownContent, type MarkdownContentProps, MediaIcon, MentionChip, type MentionChipProps, 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 NodeTopology, type NodeType, Pagination, type PaginationProps, PdfCard, type PdfCardProps, PlusIcon, Popover, type PopoverAlign, type PopoverPosition, type PopoverProps, Progress, type ProgressProps, PromptDialog, type PromptDialogProps, QuoteBlockSection, type QuoteBlockSectionProps, 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, type SpotlightVariant, 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, TextBlockSection, type TextBlockSectionProps, TextCard, type TextCardProps, Textarea, type TextareaCaretCoords, 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 TreeNode, type UseArtifactTreeNavigationReturn, type UseComboboxNavOptions, type UseScrollAnchorOptions, type UseScrollAnchorReturn, type VideoAspectRatio, type VideoAspectRatioPreset, VideoCard, type VideoCardProps, addNodeToTree, areAllTasksSettled, createEmptyTree, createPreviewUrl, findAncestor, generateId, getActivePath, getGreyedFuture, getSiblingInfo, getTextareaCaretCoords, isBranchPoint, isImageFile, messagesToTree, revokePreviewUrl, setActiveLeaf, switchBranch, updateMessageContent, useArtifactTreeNavigation, useComboboxNav, useResizable, useScrollAnchor, useToast, version };

package/dist/index.js

@@ -6121,7 +6121,7 @@ var import_react84 = __toESM(require("react"));
 // src/components/deliverable/CoverSection.tsx
 var import_react78 = __toESM(require("react"));
 function CoverSection({ data, clientName }) {
-  return /* @__PURE__ */ import_react78.default.createElement("section", { className: "deliverable-cover deliverable-page" }, /* @__PURE__ */ import_react78.default.createElement("div", { className: "deliverable-cover-inner" }, data.eyebrow && /* @__PURE__ */ import_react78.default.createElement("p", { className: "deliverable-cover-eyebrow" }, data.eyebrow), /* @__PURE__ */ import_react78.default.createElement("h1", { className: "deliverable-cover-title" }, data.title), data.subtitle && /* @__PURE__ */ import_react78.default.createElement("p", { className: "deliverable-cover-subtitle" }, data.subtitle), clientName && /* @__PURE__ */ import_react78.default.createElement("p", { className: "deliverable-cover-client" }, "Prepared for", " ", /* @__PURE__ */ import_react78.default.createElement("span", { className: "deliverable-cover-client-name" }, clientName))));
+  return /* @__PURE__ */ import_react78.default.createElement("section", { className: "deliverable-cover deliverable-page" }, /* @__PURE__ */ import_react78.default.createElement("div", { className: "deliverable-cover-inner" }, data.eyebrow && /* @__PURE__ */ import_react78.default.createElement(import_react78.default.Fragment, null, /* @__PURE__ */ import_react78.default.createElement("p", { className: "deliverable-cover-eyebrow" }, data.eyebrow), /* @__PURE__ */ import_react78.default.createElement("div", { className: "deliverable-cover-rule", "aria-hidden": "true" })), /* @__PURE__ */ import_react78.default.createElement("h1", { className: "deliverable-cover-title" }, data.title), data.subtitle && /* @__PURE__ */ import_react78.default.createElement("p", { className: "deliverable-cover-subtitle" }, data.subtitle), clientName && /* @__PURE__ */ import_react78.default.createElement("p", { className: "deliverable-cover-client" }, "Prepared for", " ", /* @__PURE__ */ import_react78.default.createElement("span", { className: "deliverable-cover-client-name" }, clientName))));
 }
 
 // src/components/deliverable/ArtifactImageGridSection.tsx
@@ -6131,16 +6131,33 @@ var COLUMN_CLASSES = {
   2: "deliverable-image-grid-cols-2",
   3: "deliverable-image-grid-cols-3"
 };
+var ASPECT_CLASSES = {
+  landscape: "deliverable-image-grid-aspect-landscape",
+  portrait: "deliverable-image-grid-aspect-portrait",
+  square: "deliverable-image-grid-aspect-square",
+  wide: "deliverable-image-grid-aspect-wide"
+};
 function ArtifactImageGridSection({ data }) {
   const columns = clampColumns(data.columns);
-  return /* @__PURE__ */ import_react79.default.createElement("section", { className: "deliverable-page" }, data.heading && /* @__PURE__ */ import_react79.default.createElement("h2", { className: "deliverable-heading" }, data.heading), /* @__PURE__ */ import_react79.default.createElement("div", { className: cx("deliverable-image-grid", COLUMN_CLASSES[columns]) }, data.items.map((item, idx) => /* @__PURE__ */ import_react79.default.createElement("figure", { key: idx, className: "deliverable-image-item" }, item.artifact.url ? /* @__PURE__ */ import_react79.default.createElement(
-    "img",
+  const aspect = data.aspectRatio ?? "landscape";
+  return /* @__PURE__ */ import_react79.default.createElement("section", { className: "deliverable-page" }, data.heading && /* @__PURE__ */ import_react79.default.createElement("h2", { className: "deliverable-heading" }, data.heading), /* @__PURE__ */ import_react79.default.createElement(
+    "div",
     {
-      src: item.artifact.url,
-      alt: item.artifact.title ?? "",
-      className: "deliverable-image-img"
-    }
-  ) : /* @__PURE__ */ import_react79.default.createElement("div", { className: "deliverable-image-missing" }, "Missing image"), item.caption && /* @__PURE__ */ import_react79.default.createElement("figcaption", { className: "deliverable-image-caption" }, item.caption)))));
+      className: cx(
+        "deliverable-image-grid",
+        COLUMN_CLASSES[columns],
+        ASPECT_CLASSES[aspect]
+      )
+    },
+    data.items.map((item, idx) => /* @__PURE__ */ import_react79.default.createElement("figure", { key: idx, className: "deliverable-image-item" }, item.artifact.url ? /* @__PURE__ */ import_react79.default.createElement(
+      "img",
+      {
+        src: item.artifact.url,
+        alt: item.artifact.title ?? "",
+        className: "deliverable-image-img"
+      }
+    ) : /* @__PURE__ */ import_react79.default.createElement("div", { className: "deliverable-image-missing" }, "Missing image"), item.caption && /* @__PURE__ */ import_react79.default.createElement("figcaption", { className: "deliverable-image-caption" }, item.caption)))
+  ));
 }
 function clampColumns(n) {
   if (n <= 1) return 1;
@@ -6150,8 +6167,14 @@ function clampColumns(n) {
 
 // src/components/deliverable/ArtifactSpotlightSection.tsx
 var import_react80 = __toESM(require("react"));
+var VARIANT_CLASSES = {
+  framed: null,
+  "full-bleed": "deliverable-spotlight-variant-full-bleed",
+  "side-by-side": "deliverable-spotlight-variant-side-by-side"
+};
 function ArtifactSpotlightSection({ data }) {
-  return /* @__PURE__ */ import_react80.default.createElement("section", { className: "deliverable-page" }, data.heading && /* @__PURE__ */ import_react80.default.createElement("h2", { className: "deliverable-heading" }, data.heading), /* @__PURE__ */ import_react80.default.createElement("div", { className: "deliverable-spotlight-media" }, data.artifact.url ? /* @__PURE__ */ import_react80.default.createElement(
+  const variant = data.variant ?? "framed";
+  return /* @__PURE__ */ import_react80.default.createElement("section", { className: cx("deliverable-page", VARIANT_CLASSES[variant]) }, data.heading && /* @__PURE__ */ import_react80.default.createElement("h2", { className: "deliverable-heading" }, data.heading), /* @__PURE__ */ import_react80.default.createElement("div", { className: "deliverable-spotlight-media" }, data.artifact.url ? /* @__PURE__ */ import_react80.default.createElement(
     "img",
     {
       src: data.artifact.url,
@@ -6199,6 +6222,12 @@ function QuoteBlockSection({ data }) {
 }
 
 // src/components/deliverable/DeliverableRenderer.tsx
+var THEME_CLASSES = {
+  cinematic: null,
+  editorial: "deliverable-theme-editorial",
+  minimal: "deliverable-theme-minimal",
+  playful: "deliverable-theme-playful"
+};
 function DeliverableRenderer({
   deliverable,
   onDownloadPdf,
@@ -6208,6 +6237,8 @@ function DeliverableRenderer({
   const [isDownloading, setIsDownloading] = (0, import_react84.useState)(false);
   const accent = deliverable.accentColor?.trim();
   const style = accent ? { "--deliverable-accent": accent } : void 0;
+  const theme = deliverable.theme ?? "cinematic";
+  const themeClass = THEME_CLASSES[theme];
   const handleDownload = async () => {
     if (!onDownloadPdf || isDownloading) return;
     setIsDownloading(true);
@@ -6220,7 +6251,7 @@ function DeliverableRenderer({
   return /* @__PURE__ */ import_react84.default.createElement(
     "div",
     {
-      className: cx("deliverable", className),
+      className: cx("deliverable", themeClass, className),
       style
     },
     deliverable.sections.map((section, idx) => renderSection(section, idx, deliverable)),
@@ -7509,13 +7540,6 @@ var ChatInterface = import_react93.default.forwardRef(
     const prevArtifactNodesRef = (0, import_react93.useRef)([]);
     const prevTasksRef = (0, import_react93.useRef)([]);
     const [panelOpenArtifactId, setPanelOpenArtifactId] = (0, import_react93.useState)(null);
-    const handleAttachmentOpen = (0, import_react93.useCallback)((artifactId) => {
-      setPanelOpenArtifactId(artifactId);
-      onAttachmentOpen?.(artifactId);
-    }, [onAttachmentOpen]);
-    const handleArtifactPanelClosed = (0, import_react93.useCallback)(() => {
-      setPanelOpenArtifactId(null);
-    }, []);
     const [internalTools, setInternalTools] = (0, import_react93.useState)({
       "top-left": "history",
       "bottom-left": null,
@@ -7523,6 +7547,23 @@ var ChatInterface = import_react93.default.forwardRef(
       "bottom-right": null
     });
     const dismissedToolsRef = (0, import_react93.useRef)(/* @__PURE__ */ new Set());
+    const openArtifact = (0, import_react93.useCallback)((artifactId) => {
+      dismissedToolsRef.current.delete("artifacts");
+      if (isArtifactsPanelOpen === void 0) {
+        setInternalTools((prev) => prev["top-right"] === "artifacts" ? prev : { ...prev, "top-right": "artifacts" });
+      } else if (!isArtifactsPanelOpen) {
+        onArtifactsPanelOpenChange?.(true);
+      }
+      setPanelOpenArtifactId(artifactId);
+    }, [isArtifactsPanelOpen, onArtifactsPanelOpenChange]);
+    const handleAttachmentOpen = (0, import_react93.useCallback)((artifactId) => {
+      openArtifact(artifactId);
+      onAttachmentOpen?.(artifactId);
+    }, [openArtifact, onAttachmentOpen]);
+    const handleArtifactPanelClosed = (0, import_react93.useCallback)(() => {
+      setPanelOpenArtifactId(null);
+    }, []);
+    (0, import_react93.useImperativeHandle)(ref, () => ({ openArtifact }), [openArtifact]);
     const isPanelControlled = isArtifactsPanelOpen !== void 0;
     const activeTools = (0, import_react93.useMemo)(() => {
       if (isPanelControlled) {
@@ -7819,7 +7860,6 @@ var ChatInterface = import_react93.default.forwardRef(
     return /* @__PURE__ */ import_react93.default.createElement(
       "div",
       {
-        ref,
         className: cx("flex h-full w-full bg-obsidian overflow-hidden", className),
         ...rest
       },