@proteos/ui 0.42.1 → 0.42.3

package/dist/index.d.cts

@@ -7,8 +7,8 @@ import { HTMLAttributes, ReactNode, AnchorHTMLAttributes, Ref, MouseEvent, Keybo
 import * as react_aria_components from 'react-aria-components';
 import { Key, BreadcrumbsProps as BreadcrumbsProps$1, ButtonProps as ButtonProps$1, CheckboxProps as CheckboxProps$1, CheckboxGroupProps as CheckboxGroupProps$1, ComboBoxProps, DateValue, DatePickerProps as DatePickerProps$1, TextFieldProps, InputProps as InputProps$1, MenuProps as MenuProps$1, MenuItemProps as MenuItemProps$1, PopoverProps, MenuTrigger as MenuTrigger$1, DialogTriggerProps, ModalOverlayProps, DialogProps, HeadingProps, DisclosureProps, ProgressBarProps as ProgressBarProps$1, RadioProps as RadioProps$1, RadioGroupProps as RadioGroupProps$1, SelectProps as SelectProps$1, SeparatorProps as SeparatorProps$1, SwitchProps as SwitchProps$1, TabsProps, TabListProps, TabProps, TabPanelProps, TextAreaProps, TimeValue, TimeFieldProps as TimeFieldProps$1, TooltipProps as TooltipProps$1, TooltipTriggerComponentProps } from 'react-aria-components';
 import { ColumnDef, SortingState, OnChangeFn, Row } from '@tanstack/react-table';
-import { Message, Conversation, UpdateDraftRequest, ContactAddress, ConversationClient, SendRecipient } from '@proteos/sdk';
 import * as tailwind_merge from 'tailwind-merge';
+import { Message, Conversation, UpdateDraftRequest, ContactAddress, ConversationClient, SendRecipient } from '@proteos/sdk';
 import { ClassValue } from 'clsx';
 
 declare const attachmentChipStyles: tailwind_variants.TVReturnType<{
@@ -486,6 +486,18 @@ declare function CardTitle({ className, ...props }: HTMLAttributes<HTMLHeadingEl
 declare function CardFeatureTitle({ className, ...props }: HTMLAttributes<HTMLHeadingElement>): react_jsx_runtime.JSX.Element;
 declare function CardBody({ className, ...props }: HTMLAttributes<HTMLDivElement>): react_jsx_runtime.JSX.Element;
 
+/** The channel's glyph component. Unknown channels get the generic one. */
+declare function channelIcon(channel: string): LucideIcon;
+interface ChannelIconProps {
+    channel: string;
+    className?: string;
+    /** Accessible name. Omitted (the default) renders the glyph aria-hidden —
+     *  correct whenever the channel is already named in adjacent text. */
+    label?: string;
+}
+/** Thin wrapper over {@link channelIcon} for the common inline case. */
+declare function ChannelIcon({ channel, className, label }: ChannelIconProps): react_jsx_runtime.JSX.Element;
+
 type CheckboxProps = Omit<CheckboxProps$1, 'children'> & {
     children?: ReactNode;
 };
@@ -1189,6 +1201,25 @@ interface DraftMessageComposerProps {
 }
 declare function DraftMessageComposer({ messageId, client, onSent, onRejected, onFailed, showActions, className, bodyClassName, }: DraftMessageComposerProps): react_jsx_runtime.JSX.Element;
 
+/** What a reviewed draft ended up as. The wire shape of the
+ *  `present_message_draft` client tool's outcome, and of the value a
+ *  host-rendered review modal closes with. */
+type DraftReviewOutcome = 'sent' | 'rejected' | 'failed';
+/** Terminal states a draft id can be in, plus the "never was a draft" case. */
+type TerminalKind = DraftReviewOutcome | 'not-draft';
+/** Terminal state of the message, or null while it is still reviewable. */
+declare function terminalKindFor(status: Message['status']): TerminalKind | null;
+/**
+ * The review-surface narrowing: the outcome a card should settle on, or null
+ * while the draft is still reviewable. A status that was never a draft
+ * (`received`, …) is not an outcome — it leaves the card pending rather than
+ * inventing a decision the human never made.
+ */
+declare function draftOutcomeFor(status: Message['status']): DraftReviewOutcome | null;
+/** Narrows the `unknown` a host modal resolves with (a dismissed modal
+ *  resolves `undefined`). */
+declare function isDraftReviewOutcome(value: unknown): value is DraftReviewOutcome;
+
 declare function publishDraftMessageOutcome(messageId: string, outcome: DraftMessageOutcome): void;
 declare function subscribeDraftMessageOutcome(messageId: string, listener: () => void): () => void;
 /**
@@ -1200,6 +1231,125 @@ declare function useDraftMessageOutcome(messageId: string): DraftMessageOutcome
 /** Test-only escape hatch — clears every stored outcome and listener. */
 declare function __resetDraftMessageOutcomes(): void;
 
+declare const draftMessageCardStyles: tailwind_variants.TVReturnType<{
+    [key: string]: {
+        [key: string]: tailwind_merge.ClassNameValue | {
+            body?: tailwind_merge.ClassNameValue;
+            title?: tailwind_merge.ClassNameValue;
+            icon?: tailwind_merge.ClassNameValue;
+            action?: tailwind_merge.ClassNameValue;
+            outcome?: tailwind_merge.ClassNameValue;
+            root?: tailwind_merge.ClassNameValue;
+            eyebrow?: tailwind_merge.ClassNameValue;
+            recipients?: tailwind_merge.ClassNameValue;
+        };
+    };
+} | {
+    [x: string]: {
+        [x: string]: tailwind_merge.ClassNameValue | {
+            body?: tailwind_merge.ClassNameValue;
+            title?: tailwind_merge.ClassNameValue;
+            icon?: tailwind_merge.ClassNameValue;
+            action?: tailwind_merge.ClassNameValue;
+            outcome?: tailwind_merge.ClassNameValue;
+            root?: tailwind_merge.ClassNameValue;
+            eyebrow?: tailwind_merge.ClassNameValue;
+            recipients?: tailwind_merge.ClassNameValue;
+        };
+    };
+} | {}, {
+    root: string[];
+    icon: string[];
+    body: string;
+    eyebrow: string;
+    title: string;
+    recipients: string;
+    action: string[];
+    outcome: string;
+}, undefined, {
+    [key: string]: {
+        [key: string]: tailwind_merge.ClassNameValue | {
+            body?: tailwind_merge.ClassNameValue;
+            title?: tailwind_merge.ClassNameValue;
+            icon?: tailwind_merge.ClassNameValue;
+            action?: tailwind_merge.ClassNameValue;
+            outcome?: tailwind_merge.ClassNameValue;
+            root?: tailwind_merge.ClassNameValue;
+            eyebrow?: tailwind_merge.ClassNameValue;
+            recipients?: tailwind_merge.ClassNameValue;
+        };
+    };
+} | {}, {
+    root: string[];
+    icon: string[];
+    body: string;
+    eyebrow: string;
+    title: string;
+    recipients: string;
+    action: string[];
+    outcome: string;
+}, tailwind_variants.TVReturnType<unknown, {
+    root: string[];
+    icon: string[];
+    body: string;
+    eyebrow: string;
+    title: string;
+    recipients: string;
+    action: string[];
+    outcome: string;
+}, undefined, unknown, unknown, undefined>>;
+/** Terminal-state wording. `failed` is deliberately explicit: the human DID
+ *  approve the send, and hiding that behind a bare "Failed" reads as though
+ *  the review itself failed. */
+declare const DRAFT_OUTCOME_LABEL: Record<DraftReviewOutcome, string>;
+interface DraftMessageCardProps {
+    /** Channel slug driving the glyph — see channelIcon. */
+    channel: string;
+    /** Headline: the conversation subject, or the draft's first body line. */
+    title: string;
+    /** Rendered as "To a, b". Empty or omitted hides the row. */
+    recipients?: string[];
+    /** Default 'Draft — awaiting review'. */
+    eyebrow?: ReactNode;
+    /** Default 'Review'. */
+    previewLabel?: string;
+    /** Terminal outcome. Set ⇒ the action is replaced by its status label. */
+    outcome?: DraftReviewOutcome | null;
+    onPreview?: () => void;
+    isPreviewDisabled?: boolean;
+    className?: string;
+}
+declare function DraftMessageCard({ channel, title, recipients, eyebrow, previewLabel, outcome, onPreview, isPreviewDisabled, className, }: DraftMessageCardProps): react_jsx_runtime.JSX.Element;
+
+interface DraftMessageReviewProps {
+    /** The status=draft message to review. */
+    messageId: string;
+    /** Injected fetch surface — see createDraftMessageClient. */
+    client: DraftMessageClient;
+    /**
+     * FULL REPLACEMENT for the preview action's default (open the built-in
+     * modal). When supplied the built-in modal is never rendered. Resolve with
+     * the outcome so the card settles, or with null when the reviewer dismissed
+     * without deciding (the card stays reviewable).
+     */
+    onPreview?: (messageId: string) => Promise<DraftReviewOutcome | null>;
+    /** Fires at most once, when the draft reaches a terminal state — whether it
+     *  was decided here, by `onPreview`, or before this card ever mounted. */
+    onOutcome?: (outcome: DraftReviewOutcome, message?: Message) => void;
+    /** The draft could not be loaded. The card renders nothing in that case. */
+    onLoadError?: (error: Error) => void;
+    /** Built-in modal heading. Default 'Review draft'. */
+    modalTitle?: string;
+    /** Built-in modal panel width. Default 'max-w-3xl'. */
+    modalClassName?: string;
+    /** Built-in modal overlay classes — this is where a host raises the z tier
+     *  above the surface that launched it. */
+    overlayClassName?: string;
+    previewLabel?: string;
+    className?: string;
+}
+declare function DraftMessageReview({ messageId, client, onPreview, onOutcome, onLoadError, modalTitle, modalClassName, overlayClassName, previewLabel, className, }: DraftMessageReviewProps): react_jsx_runtime.JSX.Element | null;
+
 declare const emptyStateStyles: tailwind_variants.TVReturnType<{
     size: {
         sm: {
@@ -2410,4 +2560,4 @@ declare function Tooltip({ className, offset, ...props }: TooltipProps): react_j
 
 declare function cn(...inputs: ClassValue[]): string;
 
-export { ATTRIBUTE_TYPES, ATTRIBUTE_TYPE_ICONS, type ActionsColumnOptions, AttachmentChip, type AttachmentChipProps, type AttachmentChipVariants, AttributePicker, type AttributePickerProps, AttributeType, AttributeTypeIcon, type AttributeTypeIconProps, Avatar, AvatarGroup, type AvatarGroupItem, type AvatarGroupProps, type AvatarGroupVariants, type AvatarProps, type AvatarVariants, Badge, BadgeMultiSelect, type BadgeMultiSelectOption, type BadgeMultiSelectProps, type BadgeProps, type BadgeVariants, BooleanCell, type BooleanCellProps, type BreadcrumbItem, Breadcrumbs, type BreadcrumbsProps, Button, type ButtonProps, type ButtonVariants, COLUMN_DRAG_KIND, Card, CardBody, CardContent, CardEyebrow, CardFeatureTitle, CardFooter, CardHeader, type CardProps, CardTitle, type CardVariants, Checkbox, CheckboxGroup, type CheckboxGroupProps, type CheckboxProps, ChipValue, type ChipValueItemRenderer, type ChipValueProps, type ColumnDragData, Combobox, type ComboboxOption, type ComboboxProps, Command, CommandHint, type CommandHintProps, type CommandHintTone, type CommandProps, type ComparisonOperator, type ComposerAttachment, type ComposerConnectionPicker, type ComposerSendInput, type ComposerValue, CurrencyInput, type CurrencyInputOption, type CurrencyInputProps, type CurrencyInputValue, DataTable, DataTableEmpty, type DataTableEmptyProps, DataTableError, type DataTableErrorProps, type DataTableProps, DataTableSkeleton, type DataTableSkeletonProps, DateCell, type DateCellProps, DatePicker, type DatePickerProps, DateTimeCell, type DateTimeCellProps, DateTimePicker, type DateTimePickerProps, type DraftMessageActions, type DraftMessageClient, DraftMessageComposer, type DraftMessageComposerProps, type DraftMessageOutcome, EmptyState, type EmptyStateProps, type EmptyStateVariants, ErrorAnimation, type ErrorAnimationProps, type FieldAppearance, FieldCaret, type FieldControlVariants, type FieldSize, FileField, type FileFieldProps, type FileFieldValue, FileViewer, FileViewerFallbackCard, type FileViewerFallbackCardProps, type FileViewerFallbackCardVariants, type FileViewerKind, type FileViewerProps, type FileViewerVariants, type FilterElement, type FilterField, type FilterFieldOption, type FilterFieldRelation, type FilterFieldType, type FilterGroup, FilterRow, type FilterRowProps, type FilterValue, FilterValueInput, type FilterValueInputProps, type FilterValueInputRenderer, ImageAttachment, type ImageAttachmentProps, type ImageAttachmentVariants, ImageLightbox, type ImageLightboxProps, type ImageLightboxVariants, type InfiniteQueryLike, Input, type InputProps, Kbd, type KbdProps, type KeyCombo, LinkCell, type LinkCellProps, type LogicalOperator, MAX_COMPOSER_ATTACHMENT_BYTES, Menu, MenuItem, type MenuItemProps, MenuPopover, type MenuPopoverProps, type MenuProps, MenuTrigger, MessageComposer, type MessageComposerProps, Modal, ModalBody, ModalContent, type ModalContentProps, ModalDescription, ModalFooter, ModalHeader, ModalTitle, MultiSelect, type MultiSelectOption, type MultiSelectProps, NavGroup, type NavGroupProps, NavItem, type NavItemProps, type NavItemVariants, NavSection, type NavSectionProps, OPERATORS, type OperatorArity, type OperatorDescriptor, OperatorPicker, type OperatorPickerProps, PROTECTED_COMBOS, Popover, PopoverContent, type PopoverContentProps, PopoverPanelBody, PopoverPanelFooter, PopoverPanelHeader, PressableCard, type PressableCardProps, ProgressBar, type ProgressBarProps, type ProgressBarVariants, Radio, RadioGroup, type RadioGroupProps, type RadioProps, RecipientSelect, type RecipientSelectProps, RecordFilterBuilderPanel, type RecordFilterBuilderPanelProps, RecordFilterButton, type RecordFilterButtonProps, RecordFilterChips, type RecordFilterChipsProps, RecordFilterEditor, type RecordFilterEditorProps, RenderChipItemProvider, RenderValueInputProvider, type SearchRecipients, SegmentedControl, type SegmentedControlOption, type SegmentedControlProps, type SegmentedControlVariants, Select, type SelectOption, type SelectProps, Separator, type SeparatorProps, Skeleton, type SkeletonProps, type SkeletonVariants, type SortDirection, SubmenuTrigger, SuccessAnimation, type SuccessAnimationProps, Switch, type SwitchProps, Table, TableBody, type TableBodyProps, TableCell, type TableCellProps, TableHeader, TableHeaderCell, type TableHeaderCellProps, type TableHeaderProps, TableHeaderSpacer, type TableProps, TableRow, type TableRowProps, TableScroller, type TableVariants, Tabs, type TabsListProps, type TabsPanelProps, type TabsRootProps, type TabsTriggerProps, type TabsVariants, TagInput, type TagInputProps, Textarea, type TextareaProps, TimeField, type TimeFieldProps, Tooltip, type TooltipProps, TooltipTrigger, TruncateCell, type TruncateCellProps, type UseCommandOptions, type UseEscapeKeyOptions, type UseInfiniteScrollSentinelOptions, __resetDraftMessageActions, __resetDraftMessageOutcomes, addLeaf as addFilterLeaf, addPendingLeaf, addSubgroup, arityOf, attachmentChipStyles, avatarGroupStyles, avatarStyles, badgeStyles, buttonStyles, cardStyles, cn, countLeaves, createDraftMessageClient, defaultValueFor, draftMessageComposerStyles, emptyStateStyles, fieldControlStyles, fieldErrorStyles, fieldHintStyles, fieldLabelStyles, fileViewerFallbackCardStyles, fileViewerStyles, formatFileSize, formatValue, iconForContentType, imageAttachmentStyles, imageLightboxStyles, isColumnDragData, isEditableTarget, isPreviewableImageName, makeActionsColumn, messageComposerStyles, navItemStyles, operatorById, operatorsForType, parseCombo, progressBarStyles, publishDraftMessageOutcome, rebaseRowOnFieldChange, rebaseRowOnOperatorChange, registerDraftMessageActions, removeLeaf, removeSubgroup, replaceLeaf, segmentedControlStyles, setJoiner, skeletonStyles, subscribeDraftMessageOutcome, tableCellStyles, tableHeaderCellStyles, tabsStyles, updateLeaf, updateSubgroup, useAttributeTypeIcon, useCommand, useDiscoveryActive, useDraftMessageActions, useDraftMessageOutcome, useEscapeKey, useInfiniteScrollSentinel, useRenderChipItem, useRenderValueInput, useShowDetails, viewerKindForContentType, wrapLeafInGroup };
+export { ATTRIBUTE_TYPES, ATTRIBUTE_TYPE_ICONS, type ActionsColumnOptions, AttachmentChip, type AttachmentChipProps, type AttachmentChipVariants, AttributePicker, type AttributePickerProps, AttributeType, AttributeTypeIcon, type AttributeTypeIconProps, Avatar, AvatarGroup, type AvatarGroupItem, type AvatarGroupProps, type AvatarGroupVariants, type AvatarProps, type AvatarVariants, Badge, BadgeMultiSelect, type BadgeMultiSelectOption, type BadgeMultiSelectProps, type BadgeProps, type BadgeVariants, BooleanCell, type BooleanCellProps, type BreadcrumbItem, Breadcrumbs, type BreadcrumbsProps, Button, type ButtonProps, type ButtonVariants, COLUMN_DRAG_KIND, Card, CardBody, CardContent, CardEyebrow, CardFeatureTitle, CardFooter, CardHeader, type CardProps, CardTitle, type CardVariants, ChannelIcon, type ChannelIconProps, Checkbox, CheckboxGroup, type CheckboxGroupProps, type CheckboxProps, ChipValue, type ChipValueItemRenderer, type ChipValueProps, type ColumnDragData, Combobox, type ComboboxOption, type ComboboxProps, Command, CommandHint, type CommandHintProps, type CommandHintTone, type CommandProps, type ComparisonOperator, type ComposerAttachment, type ComposerConnectionPicker, type ComposerSendInput, type ComposerValue, CurrencyInput, type CurrencyInputOption, type CurrencyInputProps, type CurrencyInputValue, DRAFT_OUTCOME_LABEL, DataTable, DataTableEmpty, type DataTableEmptyProps, DataTableError, type DataTableErrorProps, type DataTableProps, DataTableSkeleton, type DataTableSkeletonProps, DateCell, type DateCellProps, DatePicker, type DatePickerProps, DateTimeCell, type DateTimeCellProps, DateTimePicker, type DateTimePickerProps, type DraftMessageActions, DraftMessageCard, type DraftMessageCardProps, type DraftMessageClient, DraftMessageComposer, type DraftMessageComposerProps, type DraftMessageOutcome, DraftMessageReview, type DraftMessageReviewProps, type DraftReviewOutcome, EmptyState, type EmptyStateProps, type EmptyStateVariants, ErrorAnimation, type ErrorAnimationProps, type FieldAppearance, FieldCaret, type FieldControlVariants, type FieldSize, FileField, type FileFieldProps, type FileFieldValue, FileViewer, FileViewerFallbackCard, type FileViewerFallbackCardProps, type FileViewerFallbackCardVariants, type FileViewerKind, type FileViewerProps, type FileViewerVariants, type FilterElement, type FilterField, type FilterFieldOption, type FilterFieldRelation, type FilterFieldType, type FilterGroup, FilterRow, type FilterRowProps, type FilterValue, FilterValueInput, type FilterValueInputProps, type FilterValueInputRenderer, ImageAttachment, type ImageAttachmentProps, type ImageAttachmentVariants, ImageLightbox, type ImageLightboxProps, type ImageLightboxVariants, type InfiniteQueryLike, Input, type InputProps, Kbd, type KbdProps, type KeyCombo, LinkCell, type LinkCellProps, type LogicalOperator, MAX_COMPOSER_ATTACHMENT_BYTES, Menu, MenuItem, type MenuItemProps, MenuPopover, type MenuPopoverProps, type MenuProps, MenuTrigger, MessageComposer, type MessageComposerProps, Modal, ModalBody, ModalContent, type ModalContentProps, ModalDescription, ModalFooter, ModalHeader, ModalTitle, MultiSelect, type MultiSelectOption, type MultiSelectProps, NavGroup, type NavGroupProps, NavItem, type NavItemProps, type NavItemVariants, NavSection, type NavSectionProps, OPERATORS, type OperatorArity, type OperatorDescriptor, OperatorPicker, type OperatorPickerProps, PROTECTED_COMBOS, Popover, PopoverContent, type PopoverContentProps, PopoverPanelBody, PopoverPanelFooter, PopoverPanelHeader, PressableCard, type PressableCardProps, ProgressBar, type ProgressBarProps, type ProgressBarVariants, Radio, RadioGroup, type RadioGroupProps, type RadioProps, RecipientSelect, type RecipientSelectProps, RecordFilterBuilderPanel, type RecordFilterBuilderPanelProps, RecordFilterButton, type RecordFilterButtonProps, RecordFilterChips, type RecordFilterChipsProps, RecordFilterEditor, type RecordFilterEditorProps, RenderChipItemProvider, RenderValueInputProvider, type SearchRecipients, SegmentedControl, type SegmentedControlOption, type SegmentedControlProps, type SegmentedControlVariants, Select, type SelectOption, type SelectProps, Separator, type SeparatorProps, Skeleton, type SkeletonProps, type SkeletonVariants, type SortDirection, SubmenuTrigger, SuccessAnimation, type SuccessAnimationProps, Switch, type SwitchProps, Table, TableBody, type TableBodyProps, TableCell, type TableCellProps, TableHeader, TableHeaderCell, type TableHeaderCellProps, type TableHeaderProps, TableHeaderSpacer, type TableProps, TableRow, type TableRowProps, TableScroller, type TableVariants, Tabs, type TabsListProps, type TabsPanelProps, type TabsRootProps, type TabsTriggerProps, type TabsVariants, TagInput, type TagInputProps, type TerminalKind, Textarea, type TextareaProps, TimeField, type TimeFieldProps, Tooltip, type TooltipProps, TooltipTrigger, TruncateCell, type TruncateCellProps, type UseCommandOptions, type UseEscapeKeyOptions, type UseInfiniteScrollSentinelOptions, __resetDraftMessageActions, __resetDraftMessageOutcomes, addLeaf as addFilterLeaf, addPendingLeaf, addSubgroup, arityOf, attachmentChipStyles, avatarGroupStyles, avatarStyles, badgeStyles, buttonStyles, cardStyles, channelIcon, cn, countLeaves, createDraftMessageClient, defaultValueFor, draftMessageCardStyles, draftMessageComposerStyles, draftOutcomeFor, emptyStateStyles, fieldControlStyles, fieldErrorStyles, fieldHintStyles, fieldLabelStyles, fileViewerFallbackCardStyles, fileViewerStyles, formatFileSize, formatValue, iconForContentType, imageAttachmentStyles, imageLightboxStyles, isColumnDragData, isDraftReviewOutcome, isEditableTarget, isPreviewableImageName, makeActionsColumn, messageComposerStyles, navItemStyles, operatorById, operatorsForType, parseCombo, progressBarStyles, publishDraftMessageOutcome, rebaseRowOnFieldChange, rebaseRowOnOperatorChange, registerDraftMessageActions, removeLeaf, removeSubgroup, replaceLeaf, segmentedControlStyles, setJoiner, skeletonStyles, subscribeDraftMessageOutcome, tableCellStyles, tableHeaderCellStyles, tabsStyles, terminalKindFor, updateLeaf, updateSubgroup, useAttributeTypeIcon, useCommand, useDiscoveryActive, useDraftMessageActions, useDraftMessageOutcome, useEscapeKey, useInfiniteScrollSentinel, useRenderChipItem, useRenderValueInput, useShowDetails, viewerKindForContentType, wrapLeafInGroup };

package/dist/index.d.ts

@@ -7,8 +7,8 @@ import { HTMLAttributes, ReactNode, AnchorHTMLAttributes, Ref, MouseEvent, Keybo
 import * as react_aria_components from 'react-aria-components';
 import { Key, BreadcrumbsProps as BreadcrumbsProps$1, ButtonProps as ButtonProps$1, CheckboxProps as CheckboxProps$1, CheckboxGroupProps as CheckboxGroupProps$1, ComboBoxProps, DateValue, DatePickerProps as DatePickerProps$1, TextFieldProps, InputProps as InputProps$1, MenuProps as MenuProps$1, MenuItemProps as MenuItemProps$1, PopoverProps, MenuTrigger as MenuTrigger$1, DialogTriggerProps, ModalOverlayProps, DialogProps, HeadingProps, DisclosureProps, ProgressBarProps as ProgressBarProps$1, RadioProps as RadioProps$1, RadioGroupProps as RadioGroupProps$1, SelectProps as SelectProps$1, SeparatorProps as SeparatorProps$1, SwitchProps as SwitchProps$1, TabsProps, TabListProps, TabProps, TabPanelProps, TextAreaProps, TimeValue, TimeFieldProps as TimeFieldProps$1, TooltipProps as TooltipProps$1, TooltipTriggerComponentProps } from 'react-aria-components';
 import { ColumnDef, SortingState, OnChangeFn, Row } from '@tanstack/react-table';
-import { Message, Conversation, UpdateDraftRequest, ContactAddress, ConversationClient, SendRecipient } from '@proteos/sdk';
 import * as tailwind_merge from 'tailwind-merge';
+import { Message, Conversation, UpdateDraftRequest, ContactAddress, ConversationClient, SendRecipient } from '@proteos/sdk';
 import { ClassValue } from 'clsx';
 
 declare const attachmentChipStyles: tailwind_variants.TVReturnType<{
@@ -486,6 +486,18 @@ declare function CardTitle({ className, ...props }: HTMLAttributes<HTMLHeadingEl
 declare function CardFeatureTitle({ className, ...props }: HTMLAttributes<HTMLHeadingElement>): react_jsx_runtime.JSX.Element;
 declare function CardBody({ className, ...props }: HTMLAttributes<HTMLDivElement>): react_jsx_runtime.JSX.Element;
 
+/** The channel's glyph component. Unknown channels get the generic one. */
+declare function channelIcon(channel: string): LucideIcon;
+interface ChannelIconProps {
+    channel: string;
+    className?: string;
+    /** Accessible name. Omitted (the default) renders the glyph aria-hidden —
+     *  correct whenever the channel is already named in adjacent text. */
+    label?: string;
+}
+/** Thin wrapper over {@link channelIcon} for the common inline case. */
+declare function ChannelIcon({ channel, className, label }: ChannelIconProps): react_jsx_runtime.JSX.Element;
+
 type CheckboxProps = Omit<CheckboxProps$1, 'children'> & {
     children?: ReactNode;
 };
@@ -1189,6 +1201,25 @@ interface DraftMessageComposerProps {
 }
 declare function DraftMessageComposer({ messageId, client, onSent, onRejected, onFailed, showActions, className, bodyClassName, }: DraftMessageComposerProps): react_jsx_runtime.JSX.Element;
 
+/** What a reviewed draft ended up as. The wire shape of the
+ *  `present_message_draft` client tool's outcome, and of the value a
+ *  host-rendered review modal closes with. */
+type DraftReviewOutcome = 'sent' | 'rejected' | 'failed';
+/** Terminal states a draft id can be in, plus the "never was a draft" case. */
+type TerminalKind = DraftReviewOutcome | 'not-draft';
+/** Terminal state of the message, or null while it is still reviewable. */
+declare function terminalKindFor(status: Message['status']): TerminalKind | null;
+/**
+ * The review-surface narrowing: the outcome a card should settle on, or null
+ * while the draft is still reviewable. A status that was never a draft
+ * (`received`, …) is not an outcome — it leaves the card pending rather than
+ * inventing a decision the human never made.
+ */
+declare function draftOutcomeFor(status: Message['status']): DraftReviewOutcome | null;
+/** Narrows the `unknown` a host modal resolves with (a dismissed modal
+ *  resolves `undefined`). */
+declare function isDraftReviewOutcome(value: unknown): value is DraftReviewOutcome;
+
 declare function publishDraftMessageOutcome(messageId: string, outcome: DraftMessageOutcome): void;
 declare function subscribeDraftMessageOutcome(messageId: string, listener: () => void): () => void;
 /**
@@ -1200,6 +1231,125 @@ declare function useDraftMessageOutcome(messageId: string): DraftMessageOutcome
 /** Test-only escape hatch — clears every stored outcome and listener. */
 declare function __resetDraftMessageOutcomes(): void;
 
+declare const draftMessageCardStyles: tailwind_variants.TVReturnType<{
+    [key: string]: {
+        [key: string]: tailwind_merge.ClassNameValue | {
+            body?: tailwind_merge.ClassNameValue;
+            title?: tailwind_merge.ClassNameValue;
+            icon?: tailwind_merge.ClassNameValue;
+            action?: tailwind_merge.ClassNameValue;
+            outcome?: tailwind_merge.ClassNameValue;
+            root?: tailwind_merge.ClassNameValue;
+            eyebrow?: tailwind_merge.ClassNameValue;
+            recipients?: tailwind_merge.ClassNameValue;
+        };
+    };
+} | {
+    [x: string]: {
+        [x: string]: tailwind_merge.ClassNameValue | {
+            body?: tailwind_merge.ClassNameValue;
+            title?: tailwind_merge.ClassNameValue;
+            icon?: tailwind_merge.ClassNameValue;
+            action?: tailwind_merge.ClassNameValue;
+            outcome?: tailwind_merge.ClassNameValue;
+            root?: tailwind_merge.ClassNameValue;
+            eyebrow?: tailwind_merge.ClassNameValue;
+            recipients?: tailwind_merge.ClassNameValue;
+        };
+    };
+} | {}, {
+    root: string[];
+    icon: string[];
+    body: string;
+    eyebrow: string;
+    title: string;
+    recipients: string;
+    action: string[];
+    outcome: string;
+}, undefined, {
+    [key: string]: {
+        [key: string]: tailwind_merge.ClassNameValue | {
+            body?: tailwind_merge.ClassNameValue;
+            title?: tailwind_merge.ClassNameValue;
+            icon?: tailwind_merge.ClassNameValue;
+            action?: tailwind_merge.ClassNameValue;
+            outcome?: tailwind_merge.ClassNameValue;
+            root?: tailwind_merge.ClassNameValue;
+            eyebrow?: tailwind_merge.ClassNameValue;
+            recipients?: tailwind_merge.ClassNameValue;
+        };
+    };
+} | {}, {
+    root: string[];
+    icon: string[];
+    body: string;
+    eyebrow: string;
+    title: string;
+    recipients: string;
+    action: string[];
+    outcome: string;
+}, tailwind_variants.TVReturnType<unknown, {
+    root: string[];
+    icon: string[];
+    body: string;
+    eyebrow: string;
+    title: string;
+    recipients: string;
+    action: string[];
+    outcome: string;
+}, undefined, unknown, unknown, undefined>>;
+/** Terminal-state wording. `failed` is deliberately explicit: the human DID
+ *  approve the send, and hiding that behind a bare "Failed" reads as though
+ *  the review itself failed. */
+declare const DRAFT_OUTCOME_LABEL: Record<DraftReviewOutcome, string>;
+interface DraftMessageCardProps {
+    /** Channel slug driving the glyph — see channelIcon. */
+    channel: string;
+    /** Headline: the conversation subject, or the draft's first body line. */
+    title: string;
+    /** Rendered as "To a, b". Empty or omitted hides the row. */
+    recipients?: string[];
+    /** Default 'Draft — awaiting review'. */
+    eyebrow?: ReactNode;
+    /** Default 'Review'. */
+    previewLabel?: string;
+    /** Terminal outcome. Set ⇒ the action is replaced by its status label. */
+    outcome?: DraftReviewOutcome | null;
+    onPreview?: () => void;
+    isPreviewDisabled?: boolean;
+    className?: string;
+}
+declare function DraftMessageCard({ channel, title, recipients, eyebrow, previewLabel, outcome, onPreview, isPreviewDisabled, className, }: DraftMessageCardProps): react_jsx_runtime.JSX.Element;
+
+interface DraftMessageReviewProps {
+    /** The status=draft message to review. */
+    messageId: string;
+    /** Injected fetch surface — see createDraftMessageClient. */
+    client: DraftMessageClient;
+    /**
+     * FULL REPLACEMENT for the preview action's default (open the built-in
+     * modal). When supplied the built-in modal is never rendered. Resolve with
+     * the outcome so the card settles, or with null when the reviewer dismissed
+     * without deciding (the card stays reviewable).
+     */
+    onPreview?: (messageId: string) => Promise<DraftReviewOutcome | null>;
+    /** Fires at most once, when the draft reaches a terminal state — whether it
+     *  was decided here, by `onPreview`, or before this card ever mounted. */
+    onOutcome?: (outcome: DraftReviewOutcome, message?: Message) => void;
+    /** The draft could not be loaded. The card renders nothing in that case. */
+    onLoadError?: (error: Error) => void;
+    /** Built-in modal heading. Default 'Review draft'. */
+    modalTitle?: string;
+    /** Built-in modal panel width. Default 'max-w-3xl'. */
+    modalClassName?: string;
+    /** Built-in modal overlay classes — this is where a host raises the z tier
+     *  above the surface that launched it. */
+    overlayClassName?: string;
+    previewLabel?: string;
+    className?: string;
+}
+declare function DraftMessageReview({ messageId, client, onPreview, onOutcome, onLoadError, modalTitle, modalClassName, overlayClassName, previewLabel, className, }: DraftMessageReviewProps): react_jsx_runtime.JSX.Element | null;
+
 declare const emptyStateStyles: tailwind_variants.TVReturnType<{
     size: {
         sm: {
@@ -2410,4 +2560,4 @@ declare function Tooltip({ className, offset, ...props }: TooltipProps): react_j
 
 declare function cn(...inputs: ClassValue[]): string;
 
-export { ATTRIBUTE_TYPES, ATTRIBUTE_TYPE_ICONS, type ActionsColumnOptions, AttachmentChip, type AttachmentChipProps, type AttachmentChipVariants, AttributePicker, type AttributePickerProps, AttributeType, AttributeTypeIcon, type AttributeTypeIconProps, Avatar, AvatarGroup, type AvatarGroupItem, type AvatarGroupProps, type AvatarGroupVariants, type AvatarProps, type AvatarVariants, Badge, BadgeMultiSelect, type BadgeMultiSelectOption, type BadgeMultiSelectProps, type BadgeProps, type BadgeVariants, BooleanCell, type BooleanCellProps, type BreadcrumbItem, Breadcrumbs, type BreadcrumbsProps, Button, type ButtonProps, type ButtonVariants, COLUMN_DRAG_KIND, Card, CardBody, CardContent, CardEyebrow, CardFeatureTitle, CardFooter, CardHeader, type CardProps, CardTitle, type CardVariants, Checkbox, CheckboxGroup, type CheckboxGroupProps, type CheckboxProps, ChipValue, type ChipValueItemRenderer, type ChipValueProps, type ColumnDragData, Combobox, type ComboboxOption, type ComboboxProps, Command, CommandHint, type CommandHintProps, type CommandHintTone, type CommandProps, type ComparisonOperator, type ComposerAttachment, type ComposerConnectionPicker, type ComposerSendInput, type ComposerValue, CurrencyInput, type CurrencyInputOption, type CurrencyInputProps, type CurrencyInputValue, DataTable, DataTableEmpty, type DataTableEmptyProps, DataTableError, type DataTableErrorProps, type DataTableProps, DataTableSkeleton, type DataTableSkeletonProps, DateCell, type DateCellProps, DatePicker, type DatePickerProps, DateTimeCell, type DateTimeCellProps, DateTimePicker, type DateTimePickerProps, type DraftMessageActions, type DraftMessageClient, DraftMessageComposer, type DraftMessageComposerProps, type DraftMessageOutcome, EmptyState, type EmptyStateProps, type EmptyStateVariants, ErrorAnimation, type ErrorAnimationProps, type FieldAppearance, FieldCaret, type FieldControlVariants, type FieldSize, FileField, type FileFieldProps, type FileFieldValue, FileViewer, FileViewerFallbackCard, type FileViewerFallbackCardProps, type FileViewerFallbackCardVariants, type FileViewerKind, type FileViewerProps, type FileViewerVariants, type FilterElement, type FilterField, type FilterFieldOption, type FilterFieldRelation, type FilterFieldType, type FilterGroup, FilterRow, type FilterRowProps, type FilterValue, FilterValueInput, type FilterValueInputProps, type FilterValueInputRenderer, ImageAttachment, type ImageAttachmentProps, type ImageAttachmentVariants, ImageLightbox, type ImageLightboxProps, type ImageLightboxVariants, type InfiniteQueryLike, Input, type InputProps, Kbd, type KbdProps, type KeyCombo, LinkCell, type LinkCellProps, type LogicalOperator, MAX_COMPOSER_ATTACHMENT_BYTES, Menu, MenuItem, type MenuItemProps, MenuPopover, type MenuPopoverProps, type MenuProps, MenuTrigger, MessageComposer, type MessageComposerProps, Modal, ModalBody, ModalContent, type ModalContentProps, ModalDescription, ModalFooter, ModalHeader, ModalTitle, MultiSelect, type MultiSelectOption, type MultiSelectProps, NavGroup, type NavGroupProps, NavItem, type NavItemProps, type NavItemVariants, NavSection, type NavSectionProps, OPERATORS, type OperatorArity, type OperatorDescriptor, OperatorPicker, type OperatorPickerProps, PROTECTED_COMBOS, Popover, PopoverContent, type PopoverContentProps, PopoverPanelBody, PopoverPanelFooter, PopoverPanelHeader, PressableCard, type PressableCardProps, ProgressBar, type ProgressBarProps, type ProgressBarVariants, Radio, RadioGroup, type RadioGroupProps, type RadioProps, RecipientSelect, type RecipientSelectProps, RecordFilterBuilderPanel, type RecordFilterBuilderPanelProps, RecordFilterButton, type RecordFilterButtonProps, RecordFilterChips, type RecordFilterChipsProps, RecordFilterEditor, type RecordFilterEditorProps, RenderChipItemProvider, RenderValueInputProvider, type SearchRecipients, SegmentedControl, type SegmentedControlOption, type SegmentedControlProps, type SegmentedControlVariants, Select, type SelectOption, type SelectProps, Separator, type SeparatorProps, Skeleton, type SkeletonProps, type SkeletonVariants, type SortDirection, SubmenuTrigger, SuccessAnimation, type SuccessAnimationProps, Switch, type SwitchProps, Table, TableBody, type TableBodyProps, TableCell, type TableCellProps, TableHeader, TableHeaderCell, type TableHeaderCellProps, type TableHeaderProps, TableHeaderSpacer, type TableProps, TableRow, type TableRowProps, TableScroller, type TableVariants, Tabs, type TabsListProps, type TabsPanelProps, type TabsRootProps, type TabsTriggerProps, type TabsVariants, TagInput, type TagInputProps, Textarea, type TextareaProps, TimeField, type TimeFieldProps, Tooltip, type TooltipProps, TooltipTrigger, TruncateCell, type TruncateCellProps, type UseCommandOptions, type UseEscapeKeyOptions, type UseInfiniteScrollSentinelOptions, __resetDraftMessageActions, __resetDraftMessageOutcomes, addLeaf as addFilterLeaf, addPendingLeaf, addSubgroup, arityOf, attachmentChipStyles, avatarGroupStyles, avatarStyles, badgeStyles, buttonStyles, cardStyles, cn, countLeaves, createDraftMessageClient, defaultValueFor, draftMessageComposerStyles, emptyStateStyles, fieldControlStyles, fieldErrorStyles, fieldHintStyles, fieldLabelStyles, fileViewerFallbackCardStyles, fileViewerStyles, formatFileSize, formatValue, iconForContentType, imageAttachmentStyles, imageLightboxStyles, isColumnDragData, isEditableTarget, isPreviewableImageName, makeActionsColumn, messageComposerStyles, navItemStyles, operatorById, operatorsForType, parseCombo, progressBarStyles, publishDraftMessageOutcome, rebaseRowOnFieldChange, rebaseRowOnOperatorChange, registerDraftMessageActions, removeLeaf, removeSubgroup, replaceLeaf, segmentedControlStyles, setJoiner, skeletonStyles, subscribeDraftMessageOutcome, tableCellStyles, tableHeaderCellStyles, tabsStyles, updateLeaf, updateSubgroup, useAttributeTypeIcon, useCommand, useDiscoveryActive, useDraftMessageActions, useDraftMessageOutcome, useEscapeKey, useInfiniteScrollSentinel, useRenderChipItem, useRenderValueInput, useShowDetails, viewerKindForContentType, wrapLeafInGroup };
+export { ATTRIBUTE_TYPES, ATTRIBUTE_TYPE_ICONS, type ActionsColumnOptions, AttachmentChip, type AttachmentChipProps, type AttachmentChipVariants, AttributePicker, type AttributePickerProps, AttributeType, AttributeTypeIcon, type AttributeTypeIconProps, Avatar, AvatarGroup, type AvatarGroupItem, type AvatarGroupProps, type AvatarGroupVariants, type AvatarProps, type AvatarVariants, Badge, BadgeMultiSelect, type BadgeMultiSelectOption, type BadgeMultiSelectProps, type BadgeProps, type BadgeVariants, BooleanCell, type BooleanCellProps, type BreadcrumbItem, Breadcrumbs, type BreadcrumbsProps, Button, type ButtonProps, type ButtonVariants, COLUMN_DRAG_KIND, Card, CardBody, CardContent, CardEyebrow, CardFeatureTitle, CardFooter, CardHeader, type CardProps, CardTitle, type CardVariants, ChannelIcon, type ChannelIconProps, Checkbox, CheckboxGroup, type CheckboxGroupProps, type CheckboxProps, ChipValue, type ChipValueItemRenderer, type ChipValueProps, type ColumnDragData, Combobox, type ComboboxOption, type ComboboxProps, Command, CommandHint, type CommandHintProps, type CommandHintTone, type CommandProps, type ComparisonOperator, type ComposerAttachment, type ComposerConnectionPicker, type ComposerSendInput, type ComposerValue, CurrencyInput, type CurrencyInputOption, type CurrencyInputProps, type CurrencyInputValue, DRAFT_OUTCOME_LABEL, DataTable, DataTableEmpty, type DataTableEmptyProps, DataTableError, type DataTableErrorProps, type DataTableProps, DataTableSkeleton, type DataTableSkeletonProps, DateCell, type DateCellProps, DatePicker, type DatePickerProps, DateTimeCell, type DateTimeCellProps, DateTimePicker, type DateTimePickerProps, type DraftMessageActions, DraftMessageCard, type DraftMessageCardProps, type DraftMessageClient, DraftMessageComposer, type DraftMessageComposerProps, type DraftMessageOutcome, DraftMessageReview, type DraftMessageReviewProps, type DraftReviewOutcome, EmptyState, type EmptyStateProps, type EmptyStateVariants, ErrorAnimation, type ErrorAnimationProps, type FieldAppearance, FieldCaret, type FieldControlVariants, type FieldSize, FileField, type FileFieldProps, type FileFieldValue, FileViewer, FileViewerFallbackCard, type FileViewerFallbackCardProps, type FileViewerFallbackCardVariants, type FileViewerKind, type FileViewerProps, type FileViewerVariants, type FilterElement, type FilterField, type FilterFieldOption, type FilterFieldRelation, type FilterFieldType, type FilterGroup, FilterRow, type FilterRowProps, type FilterValue, FilterValueInput, type FilterValueInputProps, type FilterValueInputRenderer, ImageAttachment, type ImageAttachmentProps, type ImageAttachmentVariants, ImageLightbox, type ImageLightboxProps, type ImageLightboxVariants, type InfiniteQueryLike, Input, type InputProps, Kbd, type KbdProps, type KeyCombo, LinkCell, type LinkCellProps, type LogicalOperator, MAX_COMPOSER_ATTACHMENT_BYTES, Menu, MenuItem, type MenuItemProps, MenuPopover, type MenuPopoverProps, type MenuProps, MenuTrigger, MessageComposer, type MessageComposerProps, Modal, ModalBody, ModalContent, type ModalContentProps, ModalDescription, ModalFooter, ModalHeader, ModalTitle, MultiSelect, type MultiSelectOption, type MultiSelectProps, NavGroup, type NavGroupProps, NavItem, type NavItemProps, type NavItemVariants, NavSection, type NavSectionProps, OPERATORS, type OperatorArity, type OperatorDescriptor, OperatorPicker, type OperatorPickerProps, PROTECTED_COMBOS, Popover, PopoverContent, type PopoverContentProps, PopoverPanelBody, PopoverPanelFooter, PopoverPanelHeader, PressableCard, type PressableCardProps, ProgressBar, type ProgressBarProps, type ProgressBarVariants, Radio, RadioGroup, type RadioGroupProps, type RadioProps, RecipientSelect, type RecipientSelectProps, RecordFilterBuilderPanel, type RecordFilterBuilderPanelProps, RecordFilterButton, type RecordFilterButtonProps, RecordFilterChips, type RecordFilterChipsProps, RecordFilterEditor, type RecordFilterEditorProps, RenderChipItemProvider, RenderValueInputProvider, type SearchRecipients, SegmentedControl, type SegmentedControlOption, type SegmentedControlProps, type SegmentedControlVariants, Select, type SelectOption, type SelectProps, Separator, type SeparatorProps, Skeleton, type SkeletonProps, type SkeletonVariants, type SortDirection, SubmenuTrigger, SuccessAnimation, type SuccessAnimationProps, Switch, type SwitchProps, Table, TableBody, type TableBodyProps, TableCell, type TableCellProps, TableHeader, TableHeaderCell, type TableHeaderCellProps, type TableHeaderProps, TableHeaderSpacer, type TableProps, TableRow, type TableRowProps, TableScroller, type TableVariants, Tabs, type TabsListProps, type TabsPanelProps, type TabsRootProps, type TabsTriggerProps, type TabsVariants, TagInput, type TagInputProps, type TerminalKind, Textarea, type TextareaProps, TimeField, type TimeFieldProps, Tooltip, type TooltipProps, TooltipTrigger, TruncateCell, type TruncateCellProps, type UseCommandOptions, type UseEscapeKeyOptions, type UseInfiniteScrollSentinelOptions, __resetDraftMessageActions, __resetDraftMessageOutcomes, addLeaf as addFilterLeaf, addPendingLeaf, addSubgroup, arityOf, attachmentChipStyles, avatarGroupStyles, avatarStyles, badgeStyles, buttonStyles, cardStyles, channelIcon, cn, countLeaves, createDraftMessageClient, defaultValueFor, draftMessageCardStyles, draftMessageComposerStyles, draftOutcomeFor, emptyStateStyles, fieldControlStyles, fieldErrorStyles, fieldHintStyles, fieldLabelStyles, fileViewerFallbackCardStyles, fileViewerStyles, formatFileSize, formatValue, iconForContentType, imageAttachmentStyles, imageLightboxStyles, isColumnDragData, isDraftReviewOutcome, isEditableTarget, isPreviewableImageName, makeActionsColumn, messageComposerStyles, navItemStyles, operatorById, operatorsForType, parseCombo, progressBarStyles, publishDraftMessageOutcome, rebaseRowOnFieldChange, rebaseRowOnOperatorChange, registerDraftMessageActions, removeLeaf, removeSubgroup, replaceLeaf, segmentedControlStyles, setJoiner, skeletonStyles, subscribeDraftMessageOutcome, tableCellStyles, tableHeaderCellStyles, tabsStyles, terminalKindFor, updateLeaf, updateSubgroup, useAttributeTypeIcon, useCommand, useDiscoveryActive, useDraftMessageActions, useDraftMessageOutcome, useEscapeKey, useInfiniteScrollSentinel, useRenderChipItem, useRenderValueInput, useShowDetails, viewerKindForContentType, wrapLeafInGroup };