@lukeashford/aurelius 4.4.0 → 4.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.mts CHANGED
@@ -742,6 +742,20 @@ interface MessageProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>, 'con
742
742
  * artifact-card modal in the host app.
743
743
  */
744
744
  onAttachmentOpen?: (artifactId: string) => void;
745
+ /**
746
+ * Click handler for the bubble — when provided, the message becomes a
747
+ * navigational anchor (mirrors Checkpoint's `onJumpHere`): clicking the
748
+ * bubble moves the active leaf to this node. Suppressed when `isActive`
749
+ * is true (already here) or when the user is selecting text or clicking
750
+ * a markdown link inside the bubble.
751
+ */
752
+ onJumpHere?: () => void;
753
+ /**
754
+ * When true, this message is the active leaf — `onJumpHere` is suppressed
755
+ * (no point jumping to where you already are) and the affordance hover
756
+ * styling is skipped.
757
+ */
758
+ isActive?: boolean;
745
759
  }
746
760
  declare const Message: React$1.ForwardRefExoticComponent<MessageProps & React$1.RefAttributes<HTMLDivElement>>;
747
761
 
@@ -1417,12 +1431,12 @@ interface ChatInterfaceProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>
1417
1431
  */
1418
1432
  onRetryMessage?: (messageId: string) => void;
1419
1433
  /**
1420
- * Called when the user clicks a non-active checkpoint to rewind. Receives
1421
- * the checkpoint id; the consumer should move the active leaf there
1422
- * (without forking) so the artifacts panel and chat re-anchor.
1423
- * In tree mode only.
1434
+ * Called when the user clicks a non-active node — checkpoint or message
1435
+ * to move the active leaf there. Receives the node id; the consumer should
1436
+ * move the active leaf without forking so the artifacts panel and chat
1437
+ * re-anchor. Mirrors the per-component `onJumpHere`. In tree mode only.
1424
1438
  */
1425
- onJumpToCheckpoint?: (checkpointId: string) => void;
1439
+ onJumpHere?: (nodeId: string) => void;
1426
1440
  /**
1427
1441
  * Called when the user clicks "Jump to latest" on the greyed-future divider
1428
1442
  * or otherwise asks to return to the deepest leaf they had reached.
@@ -1682,6 +1696,18 @@ interface ChatViewMessageItem extends Omit<MessageProps, 'variant' | 'children'>
1682
1696
  actions?: MessageActionsConfig;
1683
1697
  /** When true, this row is rendered in the greyed-future region. */
1684
1698
  muted?: boolean;
1699
+ /**
1700
+ * When true, this message is the active leaf — Message will suppress its
1701
+ * `onJumpHere` click target. Mirrors `ChatViewCheckpointItem.isActive`.
1702
+ */
1703
+ isActive?: boolean;
1704
+ /**
1705
+ * Click handler for the bubble. When provided, the bubble becomes a
1706
+ * navigational anchor that moves the active leaf to this node. Aurelius
1707
+ * suppresses the click for `isActive` rows, link / button targets inside
1708
+ * the bubble, and active text selections.
1709
+ */
1710
+ onJumpHere?: () => void;
1685
1711
  }
1686
1712
  interface ChatViewCheckpointItem extends CheckpointProps {
1687
1713
  kind: 'checkpoint';
@@ -2303,6 +2329,172 @@ interface ArtifactVariantStackProps extends React$1.HTMLAttributes<HTMLDivElemen
2303
2329
  */
2304
2330
  declare const ArtifactVariantStack: React$1.ForwardRefExoticComponent<ArtifactVariantStackProps & React$1.RefAttributes<HTMLDivElement>>;
2305
2331
 
2332
+ /**
2333
+ * Wire format for a presentable deliverable. The document is composed once by
2334
+ * the backend (or hand-authored) and rendered here — the renderer never reads
2335
+ * raw HTML from data, it dispatches on `type` to a typed component per section.
2336
+ *
2337
+ * The shape mirrors hypocaust's `ResolvedDeliverableDto`. When the OpenAPI
2338
+ * client is regenerated downstream of a hypocaust schema change, the types
2339
+ * here should be kept aligned.
2340
+ */
2341
+ /**
2342
+ * Top-level deliverable. Holds metadata used on the cover and an ordered list
2343
+ * of sections to render.
2344
+ */
2345
+ interface Deliverable {
2346
+ /** Schema version. 1 today. */
2347
+ version: number;
2348
+ /** Document title — also used as the default cover title. */
2349
+ title: string;
2350
+ /** Optional one-line subtitle / tagline. */
2351
+ subtitle?: string | null;
2352
+ /** Optional client name shown as "Prepared for {clientName}" on the cover. */
2353
+ clientName?: string | null;
2354
+ /** Optional accent hex color (e.g. "#fecb6b"). Falls back to design-system gold. */
2355
+ accentColor?: string | null;
2356
+ /** Ordered sections. Render in array order. */
2357
+ sections: DeliverableSection[];
2358
+ }
2359
+ /**
2360
+ * Discriminated union of section types. Each variant has a matching renderer
2361
+ * in aurelius — the agent fills the spec, never raw layout instructions.
2362
+ */
2363
+ type DeliverableSection = CoverSection$1 | ArtifactImageGridSection$1 | ArtifactSpotlightSection$1 | TextBlockSection$1 | ColorPaletteSection$1 | QuoteBlockSection$1;
2364
+ interface CoverSection$1 {
2365
+ type: 'COVER';
2366
+ eyebrow?: string | null;
2367
+ title: string;
2368
+ subtitle?: string | null;
2369
+ }
2370
+ interface ArtifactImageGridSection$1 {
2371
+ type: 'ARTIFACT_IMAGE_GRID';
2372
+ heading?: string | null;
2373
+ /** 1, 2 or 3. */
2374
+ columns: number;
2375
+ items: DeliverableImageItem[];
2376
+ }
2377
+ interface ArtifactSpotlightSection$1 {
2378
+ type: 'ARTIFACT_SPOTLIGHT';
2379
+ heading?: string | null;
2380
+ artifact: DeliverableArtifactRef;
2381
+ body?: string | null;
2382
+ }
2383
+ interface TextBlockSection$1 {
2384
+ type: 'TEXT_BLOCK';
2385
+ heading?: string | null;
2386
+ body: string;
2387
+ }
2388
+ interface ColorPaletteSection$1 {
2389
+ type: 'COLOR_PALETTE';
2390
+ heading?: string | null;
2391
+ swatches: DeliverableSwatch[];
2392
+ }
2393
+ interface QuoteBlockSection$1 {
2394
+ type: 'QUOTE_BLOCK';
2395
+ quote: string;
2396
+ attribution?: string | null;
2397
+ }
2398
+ interface DeliverableImageItem {
2399
+ artifact: DeliverableArtifactRef;
2400
+ caption?: string | null;
2401
+ }
2402
+ interface DeliverableSwatch {
2403
+ color: string;
2404
+ label: string;
2405
+ }
2406
+ /**
2407
+ * Minimal subset of the hypocaust ArtifactDto shape consumed by the renderer.
2408
+ * Only the fields needed to render a deliverable's referenced artifacts.
2409
+ */
2410
+ interface DeliverableArtifactRef {
2411
+ url?: string | null;
2412
+ title?: string | null;
2413
+ description?: string | null;
2414
+ }
2415
+
2416
+ interface DeliverableRendererProps {
2417
+ /** Resolved deliverable spec — every artifact reference already inflated. */
2418
+ deliverable: Deliverable;
2419
+ /**
2420
+ * Called when the viewer requests a PDF download. The host application is
2421
+ * responsible for fetching and triggering the file save (the URL knows
2422
+ * about share tokens and credentials we don't). When omitted, the download
2423
+ * affordance is hidden.
2424
+ */
2425
+ onDownloadPdf?: () => void | Promise<void>;
2426
+ /** Hide the floating action bar entirely. Used when rendering for print. */
2427
+ hideActions?: boolean;
2428
+ className?: string;
2429
+ }
2430
+ /**
2431
+ * Render a presentable deliverable (moodboard, pitch deck) from a structured
2432
+ * spec. The same component drives the on-screen view and the print/PDF
2433
+ * version — `@media print` styles in `aurelius/styles/base.css` keep them in
2434
+ * sync. To produce a PDF, drive the page with headless Chromium and let the
2435
+ * print stylesheet do the work.
2436
+ *
2437
+ * The renderer is purely presentational: it takes a fully resolved spec
2438
+ * (artifact URLs already inflated by the caller) and dispatches each section
2439
+ * to its typed sub-renderer. Unknown section types are skipped silently
2440
+ * forward-compat for new section variants added by the backend.
2441
+ */
2442
+ declare function DeliverableRenderer({ deliverable, onDownloadPdf, hideActions, className, }: DeliverableRendererProps): React$1.JSX.Element;
2443
+
2444
+ interface CoverSectionProps {
2445
+ data: CoverSection$1;
2446
+ /** Document-level client name from {@link Deliverable.clientName}, shown as "Prepared for {name}". */
2447
+ clientName?: string | null;
2448
+ }
2449
+ /**
2450
+ * Title page for a deliverable. Always rendered as the first section.
2451
+ */
2452
+ declare function CoverSection({ data, clientName }: CoverSectionProps): React$1.JSX.Element;
2453
+
2454
+ interface ArtifactImageGridSectionProps {
2455
+ data: ArtifactImageGridSection$1;
2456
+ }
2457
+ /**
2458
+ * Grid of project artifact images with optional captions. The number of
2459
+ * columns is fixed by the spec (1–3); the renderer enforces a sensible aspect
2460
+ * ratio per item and lets the browser flow rows.
2461
+ */
2462
+ declare function ArtifactImageGridSection({ data }: ArtifactImageGridSectionProps): React$1.JSX.Element;
2463
+
2464
+ interface ArtifactSpotlightSectionProps {
2465
+ data: ArtifactSpotlightSection$1;
2466
+ }
2467
+ /**
2468
+ * A single hero artifact image with optional prose alongside. Reads at full
2469
+ * page width on screen and prints to a single page.
2470
+ */
2471
+ declare function ArtifactSpotlightSection({ data }: ArtifactSpotlightSectionProps): React$1.JSX.Element;
2472
+
2473
+ interface TextBlockSectionProps {
2474
+ data: TextBlockSection$1;
2475
+ }
2476
+ /**
2477
+ * Prose section. Body is rendered as Markdown.
2478
+ */
2479
+ declare function TextBlockSection({ data }: TextBlockSectionProps): React$1.JSX.Element;
2480
+
2481
+ interface ColorPaletteSectionProps {
2482
+ data: ColorPaletteSection$1;
2483
+ }
2484
+ /**
2485
+ * Color palette presented as labelled swatches with hex values.
2486
+ */
2487
+ declare function ColorPaletteSection({ data }: ColorPaletteSectionProps): React$1.JSX.Element;
2488
+
2489
+ interface QuoteBlockSectionProps {
2490
+ data: QuoteBlockSection$1;
2491
+ }
2492
+ /**
2493
+ * Pulled quote with optional attribution. The renderer adds the surrounding
2494
+ * quotation marks.
2495
+ */
2496
+ declare function QuoteBlockSection({ data }: QuoteBlockSectionProps): React$1.JSX.Element;
2497
+
2306
2498
  /**
2307
2499
  * Aurelius Design System
2308
2500
  *
@@ -2315,4 +2507,4 @@ declare const ArtifactVariantStack: React$1.ForwardRefExoticComponent<ArtifactVa
2315
2507
 
2316
2508
  declare const version = "2.0.0";
2317
2509
 
2318
- 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, 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, 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, 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, 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 NodeTopology, 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 TreeNode, type UseArtifactTreeNavigationReturn, type UseScrollAnchorOptions, type UseScrollAnchorReturn, type VideoAspectRatio, type VideoAspectRatioPreset, VideoCard, type VideoCardProps, addNodeToTree, areAllTasksSettled, createEmptyTree, createPreviewUrl, findAncestor, generateId, getActivePath, getGreyedFuture, getSiblingInfo, isBranchPoint, isImageFile, messagesToTree, revokePreviewUrl, setActiveLeaf, switchBranch, updateMessageContent, useArtifactTreeNavigation, useResizable, useScrollAnchor, useToast, version };
2510
+ 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, 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, ConfirmDialog, type ConfirmDialogProps, Container, type ContainerProps, type ContainerSize, type Conversation, type ConversationTree, CoverSection, type CoverSectionProps, CrossSquareIcon, type Deliverable, type DeliverableArtifactRef, 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, 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 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 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 UseScrollAnchorOptions, type UseScrollAnchorReturn, type VideoAspectRatio, type VideoAspectRatioPreset, VideoCard, type VideoCardProps, addNodeToTree, areAllTasksSettled, createEmptyTree, createPreviewUrl, findAncestor, generateId, getActivePath, getGreyedFuture, getSiblingInfo, isBranchPoint, isImageFile, messagesToTree, revokePreviewUrl, setActiveLeaf, switchBranch, updateMessageContent, useArtifactTreeNavigation, useResizable, useScrollAnchor, useToast, version };
package/dist/index.d.ts CHANGED
@@ -742,6 +742,20 @@ interface MessageProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>, 'con
742
742
  * artifact-card modal in the host app.
743
743
  */
744
744
  onAttachmentOpen?: (artifactId: string) => void;
745
+ /**
746
+ * Click handler for the bubble — when provided, the message becomes a
747
+ * navigational anchor (mirrors Checkpoint's `onJumpHere`): clicking the
748
+ * bubble moves the active leaf to this node. Suppressed when `isActive`
749
+ * is true (already here) or when the user is selecting text or clicking
750
+ * a markdown link inside the bubble.
751
+ */
752
+ onJumpHere?: () => void;
753
+ /**
754
+ * When true, this message is the active leaf — `onJumpHere` is suppressed
755
+ * (no point jumping to where you already are) and the affordance hover
756
+ * styling is skipped.
757
+ */
758
+ isActive?: boolean;
745
759
  }
746
760
  declare const Message: React$1.ForwardRefExoticComponent<MessageProps & React$1.RefAttributes<HTMLDivElement>>;
747
761
 
@@ -1417,12 +1431,12 @@ interface ChatInterfaceProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>
1417
1431
  */
1418
1432
  onRetryMessage?: (messageId: string) => void;
1419
1433
  /**
1420
- * Called when the user clicks a non-active checkpoint to rewind. Receives
1421
- * the checkpoint id; the consumer should move the active leaf there
1422
- * (without forking) so the artifacts panel and chat re-anchor.
1423
- * In tree mode only.
1434
+ * Called when the user clicks a non-active node — checkpoint or message
1435
+ * to move the active leaf there. Receives the node id; the consumer should
1436
+ * move the active leaf without forking so the artifacts panel and chat
1437
+ * re-anchor. Mirrors the per-component `onJumpHere`. In tree mode only.
1424
1438
  */
1425
- onJumpToCheckpoint?: (checkpointId: string) => void;
1439
+ onJumpHere?: (nodeId: string) => void;
1426
1440
  /**
1427
1441
  * Called when the user clicks "Jump to latest" on the greyed-future divider
1428
1442
  * or otherwise asks to return to the deepest leaf they had reached.
@@ -1682,6 +1696,18 @@ interface ChatViewMessageItem extends Omit<MessageProps, 'variant' | 'children'>
1682
1696
  actions?: MessageActionsConfig;
1683
1697
  /** When true, this row is rendered in the greyed-future region. */
1684
1698
  muted?: boolean;
1699
+ /**
1700
+ * When true, this message is the active leaf — Message will suppress its
1701
+ * `onJumpHere` click target. Mirrors `ChatViewCheckpointItem.isActive`.
1702
+ */
1703
+ isActive?: boolean;
1704
+ /**
1705
+ * Click handler for the bubble. When provided, the bubble becomes a
1706
+ * navigational anchor that moves the active leaf to this node. Aurelius
1707
+ * suppresses the click for `isActive` rows, link / button targets inside
1708
+ * the bubble, and active text selections.
1709
+ */
1710
+ onJumpHere?: () => void;
1685
1711
  }
1686
1712
  interface ChatViewCheckpointItem extends CheckpointProps {
1687
1713
  kind: 'checkpoint';
@@ -2303,6 +2329,172 @@ interface ArtifactVariantStackProps extends React$1.HTMLAttributes<HTMLDivElemen
2303
2329
  */
2304
2330
  declare const ArtifactVariantStack: React$1.ForwardRefExoticComponent<ArtifactVariantStackProps & React$1.RefAttributes<HTMLDivElement>>;
2305
2331
 
2332
+ /**
2333
+ * Wire format for a presentable deliverable. The document is composed once by
2334
+ * the backend (or hand-authored) and rendered here — the renderer never reads
2335
+ * raw HTML from data, it dispatches on `type` to a typed component per section.
2336
+ *
2337
+ * The shape mirrors hypocaust's `ResolvedDeliverableDto`. When the OpenAPI
2338
+ * client is regenerated downstream of a hypocaust schema change, the types
2339
+ * here should be kept aligned.
2340
+ */
2341
+ /**
2342
+ * Top-level deliverable. Holds metadata used on the cover and an ordered list
2343
+ * of sections to render.
2344
+ */
2345
+ interface Deliverable {
2346
+ /** Schema version. 1 today. */
2347
+ version: number;
2348
+ /** Document title — also used as the default cover title. */
2349
+ title: string;
2350
+ /** Optional one-line subtitle / tagline. */
2351
+ subtitle?: string | null;
2352
+ /** Optional client name shown as "Prepared for {clientName}" on the cover. */
2353
+ clientName?: string | null;
2354
+ /** Optional accent hex color (e.g. "#fecb6b"). Falls back to design-system gold. */
2355
+ accentColor?: string | null;
2356
+ /** Ordered sections. Render in array order. */
2357
+ sections: DeliverableSection[];
2358
+ }
2359
+ /**
2360
+ * Discriminated union of section types. Each variant has a matching renderer
2361
+ * in aurelius — the agent fills the spec, never raw layout instructions.
2362
+ */
2363
+ type DeliverableSection = CoverSection$1 | ArtifactImageGridSection$1 | ArtifactSpotlightSection$1 | TextBlockSection$1 | ColorPaletteSection$1 | QuoteBlockSection$1;
2364
+ interface CoverSection$1 {
2365
+ type: 'COVER';
2366
+ eyebrow?: string | null;
2367
+ title: string;
2368
+ subtitle?: string | null;
2369
+ }
2370
+ interface ArtifactImageGridSection$1 {
2371
+ type: 'ARTIFACT_IMAGE_GRID';
2372
+ heading?: string | null;
2373
+ /** 1, 2 or 3. */
2374
+ columns: number;
2375
+ items: DeliverableImageItem[];
2376
+ }
2377
+ interface ArtifactSpotlightSection$1 {
2378
+ type: 'ARTIFACT_SPOTLIGHT';
2379
+ heading?: string | null;
2380
+ artifact: DeliverableArtifactRef;
2381
+ body?: string | null;
2382
+ }
2383
+ interface TextBlockSection$1 {
2384
+ type: 'TEXT_BLOCK';
2385
+ heading?: string | null;
2386
+ body: string;
2387
+ }
2388
+ interface ColorPaletteSection$1 {
2389
+ type: 'COLOR_PALETTE';
2390
+ heading?: string | null;
2391
+ swatches: DeliverableSwatch[];
2392
+ }
2393
+ interface QuoteBlockSection$1 {
2394
+ type: 'QUOTE_BLOCK';
2395
+ quote: string;
2396
+ attribution?: string | null;
2397
+ }
2398
+ interface DeliverableImageItem {
2399
+ artifact: DeliverableArtifactRef;
2400
+ caption?: string | null;
2401
+ }
2402
+ interface DeliverableSwatch {
2403
+ color: string;
2404
+ label: string;
2405
+ }
2406
+ /**
2407
+ * Minimal subset of the hypocaust ArtifactDto shape consumed by the renderer.
2408
+ * Only the fields needed to render a deliverable's referenced artifacts.
2409
+ */
2410
+ interface DeliverableArtifactRef {
2411
+ url?: string | null;
2412
+ title?: string | null;
2413
+ description?: string | null;
2414
+ }
2415
+
2416
+ interface DeliverableRendererProps {
2417
+ /** Resolved deliverable spec — every artifact reference already inflated. */
2418
+ deliverable: Deliverable;
2419
+ /**
2420
+ * Called when the viewer requests a PDF download. The host application is
2421
+ * responsible for fetching and triggering the file save (the URL knows
2422
+ * about share tokens and credentials we don't). When omitted, the download
2423
+ * affordance is hidden.
2424
+ */
2425
+ onDownloadPdf?: () => void | Promise<void>;
2426
+ /** Hide the floating action bar entirely. Used when rendering for print. */
2427
+ hideActions?: boolean;
2428
+ className?: string;
2429
+ }
2430
+ /**
2431
+ * Render a presentable deliverable (moodboard, pitch deck) from a structured
2432
+ * spec. The same component drives the on-screen view and the print/PDF
2433
+ * version — `@media print` styles in `aurelius/styles/base.css` keep them in
2434
+ * sync. To produce a PDF, drive the page with headless Chromium and let the
2435
+ * print stylesheet do the work.
2436
+ *
2437
+ * The renderer is purely presentational: it takes a fully resolved spec
2438
+ * (artifact URLs already inflated by the caller) and dispatches each section
2439
+ * to its typed sub-renderer. Unknown section types are skipped silently
2440
+ * forward-compat for new section variants added by the backend.
2441
+ */
2442
+ declare function DeliverableRenderer({ deliverable, onDownloadPdf, hideActions, className, }: DeliverableRendererProps): React$1.JSX.Element;
2443
+
2444
+ interface CoverSectionProps {
2445
+ data: CoverSection$1;
2446
+ /** Document-level client name from {@link Deliverable.clientName}, shown as "Prepared for {name}". */
2447
+ clientName?: string | null;
2448
+ }
2449
+ /**
2450
+ * Title page for a deliverable. Always rendered as the first section.
2451
+ */
2452
+ declare function CoverSection({ data, clientName }: CoverSectionProps): React$1.JSX.Element;
2453
+
2454
+ interface ArtifactImageGridSectionProps {
2455
+ data: ArtifactImageGridSection$1;
2456
+ }
2457
+ /**
2458
+ * Grid of project artifact images with optional captions. The number of
2459
+ * columns is fixed by the spec (1–3); the renderer enforces a sensible aspect
2460
+ * ratio per item and lets the browser flow rows.
2461
+ */
2462
+ declare function ArtifactImageGridSection({ data }: ArtifactImageGridSectionProps): React$1.JSX.Element;
2463
+
2464
+ interface ArtifactSpotlightSectionProps {
2465
+ data: ArtifactSpotlightSection$1;
2466
+ }
2467
+ /**
2468
+ * A single hero artifact image with optional prose alongside. Reads at full
2469
+ * page width on screen and prints to a single page.
2470
+ */
2471
+ declare function ArtifactSpotlightSection({ data }: ArtifactSpotlightSectionProps): React$1.JSX.Element;
2472
+
2473
+ interface TextBlockSectionProps {
2474
+ data: TextBlockSection$1;
2475
+ }
2476
+ /**
2477
+ * Prose section. Body is rendered as Markdown.
2478
+ */
2479
+ declare function TextBlockSection({ data }: TextBlockSectionProps): React$1.JSX.Element;
2480
+
2481
+ interface ColorPaletteSectionProps {
2482
+ data: ColorPaletteSection$1;
2483
+ }
2484
+ /**
2485
+ * Color palette presented as labelled swatches with hex values.
2486
+ */
2487
+ declare function ColorPaletteSection({ data }: ColorPaletteSectionProps): React$1.JSX.Element;
2488
+
2489
+ interface QuoteBlockSectionProps {
2490
+ data: QuoteBlockSection$1;
2491
+ }
2492
+ /**
2493
+ * Pulled quote with optional attribution. The renderer adds the surrounding
2494
+ * quotation marks.
2495
+ */
2496
+ declare function QuoteBlockSection({ data }: QuoteBlockSectionProps): React$1.JSX.Element;
2497
+
2306
2498
  /**
2307
2499
  * Aurelius Design System
2308
2500
  *
@@ -2315,4 +2507,4 @@ declare const ArtifactVariantStack: React$1.ForwardRefExoticComponent<ArtifactVa
2315
2507
 
2316
2508
  declare const version = "2.0.0";
2317
2509
 
2318
- 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, 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, 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, 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, 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 NodeTopology, 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 TreeNode, type UseArtifactTreeNavigationReturn, type UseScrollAnchorOptions, type UseScrollAnchorReturn, type VideoAspectRatio, type VideoAspectRatioPreset, VideoCard, type VideoCardProps, addNodeToTree, areAllTasksSettled, createEmptyTree, createPreviewUrl, findAncestor, generateId, getActivePath, getGreyedFuture, getSiblingInfo, isBranchPoint, isImageFile, messagesToTree, revokePreviewUrl, setActiveLeaf, switchBranch, updateMessageContent, useArtifactTreeNavigation, useResizable, useScrollAnchor, useToast, version };
2510
+ 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, 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, ConfirmDialog, type ConfirmDialogProps, Container, type ContainerProps, type ContainerSize, type Conversation, type ConversationTree, CoverSection, type CoverSectionProps, CrossSquareIcon, type Deliverable, type DeliverableArtifactRef, 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, 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 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 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 UseScrollAnchorOptions, type UseScrollAnchorReturn, type VideoAspectRatio, type VideoAspectRatioPreset, VideoCard, type VideoCardProps, addNodeToTree, areAllTasksSettled, createEmptyTree, createPreviewUrl, findAncestor, generateId, getActivePath, getGreyedFuture, getSiblingInfo, isBranchPoint, isImageFile, messagesToTree, revokePreviewUrl, setActiveLeaf, switchBranch, updateMessageContent, useArtifactTreeNavigation, useResizable, useScrollAnchor, useToast, version };