@handled-ai/design-system 0.4.2 → 0.5.0

package/dist/index.d.ts

@@ -529,6 +529,24 @@ declare function InboxGroupHeader({ title, count }: {
     count: number;
 }): React$1.JSX.Element;
 
+interface FilterDefinition {
+    id: string;
+    label: string;
+    options: string[];
+    defaultValue?: string;
+    icon?: "calendar" | React$1.ComponentType<{
+        className?: string;
+    }>;
+}
+interface InsightsFilterBarProps {
+    filters: FilterDefinition[];
+    values: Record<string, string>;
+    onChange: (filterId: string, value: string) => void;
+    onClearAll?: () => void;
+    className?: string;
+}
+declare function InsightsFilterBar({ filters, values, onChange, onClearAll, className, }: InsightsFilterBarProps): React$1.JSX.Element;
+
 type AssigneeFilter = "me" | "team" | "all";
 interface InboxFilterCategory {
     id: string;
@@ -722,10 +740,31 @@ interface PipelineOverviewProps {
         value: number;
     }[];
     totalReceived?: number;
+    /** Dollar amounts to display on terminal node labels: { "Retained": "$18.2M" } */
+    nodeAmounts?: Record<string, string>;
+    /** Unit noun for standard node/link tooltips (e.g. "signals", "accounts"). */
+    unitLabel?: string;
+    /** Unit noun for terminal/drop-off node tooltips (e.g. "opportunities"). Defaults to unitLabel. */
+    terminalUnitLabel?: string;
+    /** Node IDs that should use terminalUnitLabel. Defaults to keys of dropOffDistribution. */
+    terminalNodeIds?: string[];
+    /** Sankey chart margins, merged with defaults { top: 20, right: 120, bottom: 20, left: 140 }. */
+    sankeyMargin?: {
+        top?: number;
+        right?: number;
+        bottom?: number;
+        left?: number;
+    };
+    /** Gap between Sankey node bar and its outside label. */
+    sankeyLabelPadding?: number;
+    /** When true, conversion badges use `flex`; when false, `hidden xl:flex`. */
+    alwaysShowConversionBadges?: boolean;
+    /** Color for dynamically generated drop-off nodes. */
+    dropOffNodeColor?: string;
     onViewInWorkQueue?: (stageId: string) => void;
     className?: string;
 }
-declare function PipelineOverview({ title, stages, stageMetrics, stageTimings, filterOptions, filterBreakdowns, countingModes, countingModeTooltip, flowNodes, dropOffDistribution, flowLinks, totalReceived, onViewInWorkQueue, className, }: PipelineOverviewProps): React$1.JSX.Element;
+declare function PipelineOverview({ title, stages, stageMetrics, stageTimings, filterOptions, filterBreakdowns, countingModes, countingModeTooltip, flowNodes, dropOffDistribution, flowLinks, totalReceived, nodeAmounts, unitLabel, terminalUnitLabel, terminalNodeIds, sankeyMargin, sankeyLabelPadding, alwaysShowConversionBadges, dropOffNodeColor, onViewInWorkQueue, className, }: PipelineOverviewProps): React$1.JSX.Element;
 
 declare function PreviewList({ children, className, ...props }: React$1.HTMLAttributes<HTMLDivElement>): React$1.JSX.Element;
 interface PreviewListItemProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>, 'title'> {
@@ -1363,6 +1402,7 @@ interface InboxViewConfig {
     filterCategories?: InboxFilterCategory[];
     detailSections?: InboxDetailSections;
     accountContacts?: SuggestedContact[];
+    buildAccountContacts?: (item: QueueItem) => SuggestedContact[];
     emailSignature?: string;
     buildSuggestedActions?: (item: QueueItem) => SuggestedAction[];
     buildSourceItems?: (item: QueueItem) => SourceDef[];
@@ -1452,6 +1492,25 @@ interface AccountsViewConfig {
 interface WorkQueueViewConfig {
     [key: string]: unknown;
 }
+interface AdminTab {
+    id: string;
+    label: string;
+    icon?: React$1.ComponentType<{
+        className?: string;
+    }>;
+    content: React$1.ReactNode;
+}
+interface AdminViewConfig {
+    /** View title displayed in the header. Defaults to "Admin". */
+    title?: string;
+    /** Icon displayed next to the title. */
+    icon?: React$1.ComponentType<{
+        className?: string;
+    }>;
+    tabs: AdminTab[];
+    /** Which tab is active initially. Defaults to first tab's id. */
+    defaultTab?: string;
+}
 interface EntityPanelSection {
     type: "details" | "contacts" | "recentActivity" | "connectedApps" | "systemActivity";
     props?: Record<string, unknown>;
@@ -1468,6 +1527,7 @@ interface PrototypeConfig {
         insights?: InsightsViewConfig;
         accounts?: AccountsViewConfig;
         workQueue?: WorkQueueViewConfig;
+        admin?: AdminViewConfig;
     };
     defaultView: string;
     entityPanel?: EntityPanelConfig;
@@ -1506,7 +1566,7 @@ interface PrototypeInboxViewProps extends InboxViewConfig {
     onOpenRecentActivity?: () => void;
     onNavigateToInbox?: () => void;
 }
-declare function PrototypeInboxView({ items, filterCategories, detailSections, accountContacts, emailSignature, buildSuggestedActions: buildSuggestedActionsProp, buildSourceItems: buildSourceItemsProp, getSignalScore: getSignalScoreProp, getTimelineEvents, iconMap, headerActions, onOpenEntityPanel, onOpenRecentActivity, }: PrototypeInboxViewProps): React$1.JSX.Element;
+declare function PrototypeInboxView({ items, filterCategories, detailSections, accountContacts, buildAccountContacts, emailSignature, buildSuggestedActions: buildSuggestedActionsProp, buildSourceItems: buildSourceItemsProp, getSignalScore: getSignalScoreProp, getTimelineEvents, iconMap, headerActions, onOpenEntityPanel, onOpenRecentActivity, }: PrototypeInboxViewProps): React$1.JSX.Element;
 
 interface PrototypeInsightsViewProps extends InsightsViewConfig {
     assistantName?: string;
@@ -1521,6 +1581,11 @@ interface PrototypeAccountsViewProps extends AccountsViewConfig {
 }
 declare function PrototypeAccountsView({ filterTabs, headerActions, onRowClick, }: PrototypeAccountsViewProps): React$1.JSX.Element;
 
+interface PrototypeAdminViewProps extends AdminViewConfig {
+    headerActions?: React$1.ReactNode;
+}
+declare function PrototypeAdminView({ title, icon: Icon, tabs, defaultTab, headerActions, }: PrototypeAdminViewProps): React$1.JSX.Element | null;
+
 interface PrototypeWorkQueueViewProps {
     headerActions?: React$1.ReactNode;
 }
@@ -1683,4 +1748,4 @@ interface AgentPopoverChatProps {
 }
 declare function AgentPopoverChat({ messages, onSendMessage, onEndSession, inputMode, visualSlot, assistantAvatarSlot, status, mode, className, }: AgentPopoverChatProps): React$1.JSX.Element;
 
-export { type AccountFilterTab, type AccountsViewConfig, type ActiveVariant, ActivityDetail, type ActivityDetailData, type ActivityDetailProps, type ActivityItem, ActivityLog, type ActivityLogItem, type ActivityLogProps, type ActivityParticipant, ActivityRow, type ActivityThreadMessage, AgentOrb, AgentOrbCanvas, type AgentOrbProps, type AgentOrbState, AgentPopover, AgentPopoverBranding, type AgentPopoverBrandingProps, AgentPopoverChat, type AgentPopoverChatProps, type AgentPopoverContextValue, AgentPopoverForm, type AgentPopoverFormField, type AgentPopoverFormProps, AgentPopoverOverview, type AgentPopoverOverviewProps, type AgentPopoverProps, type AgentPopoverStep, AgentPopoverStepContent, type AgentPopoverStepContentProps, AgentWidget, type AgentWidgetMessage, type AgentWidgetMode, type AgentWidgetProps, type AgentWidgetStatus, type AssigneeFilter, Avatar, AvatarBadge, AvatarFallback, AvatarGroup, AvatarGroupCount, AvatarImage, Badge, BarChartComponent, type BarChartComponentProps, type BarSeries, Button, CHART_CURSOR_STYLE, CHART_TOOLTIP_STYLE, Card, CardAction, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, type ChartConfig, ChartContainer, ChartLegend, ChartLegendContent, ChartStyle, ChartTooltip, ChartTooltipContent, type ChartTooltipEntry, CheckInsCard, Citation, ConnectedApps, type ConnectionStatus, type ContactChannel, type ContactItem, ContactList, type ContactListProps, DataTable, DataTableDisplay, type DataTableDisplayColumn, DataTableFilter, type DataTableFilterCategory, type DataTableQuickViewValue, DataTableQuickViews, DataTableToolbar, DetailViewHeader, DetailViewSummary, DetailViewThread, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, DonutChart, type DonutChartProps, type DonutSegment, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, EntityActivityItem, EntityDetails, type EntityMetadataField, EntityMetadataGrid, EntityPanel, type EntityPanelBrandIcons, type EntityPanelConfig, EntityPanelHeader, type EntityPanelSection, EntityPanelTabs, EntitySection, type GroupedListGroup, GroupedListView, type GroupedListViewProps, type InboxDetailSections, type InboxFilterCategory, InboxGroupHeader, InboxRow, type InboxRowProps, InboxToolbar, type InboxToolbarProps, type InboxViewConfig, Input, type InsightsViewConfig, ItemList, ItemListDisplay, type ItemListDisplayState, ItemListFilter, type ItemListFilterCategory, type ItemListGrouping, type ItemListQuickView, ItemListToolbar, type ItemListViewMode, Label, Message, MessageAvatar, type MessageAvatarProps, MessageContent, type MessageContentProps, type MessageProps, MetricCard, type MetricCardData, type MetricCardProps, type MetricDataPoint, PerformanceMetricsTable, type PerformanceMetricsTableRow, type PerformanceMetricsTableSortOption, type PipelineFilterBreakdown, PipelineOverview, type PipelineOverviewProps, type PipelineStage, type PipelineStageMetrics, type PipelineStageTiming, PotentialContacts, PreviewList, PreviewListItem, type PreviewListItemProps, Progress, PrototypeAccountsView, type PrototypeAccountsViewProps, type PrototypeBrandConfig, type PrototypeConfig, PrototypeInboxView, type PrototypeInboxViewProps, PrototypeInsightsView, type PrototypeInsightsViewProps, PrototypeShell, type PrototypeShellProps, PrototypeWorkQueueView, type PrototypeWorkQueueViewProps, type QueueItem, QuickActionChatArea, QuickActionModal, type QuickActionPriority$1 as QuickActionPriority, QuickActionSidebarNav, type QuickActionSubmitPayload, type QuickActionTaskDraft, type QuickActionTemplate, RecentActivity, RecentlyCompletedCard, type RecommendedAction, RecommendedActionsSection, ReportCard, type ReportCardProps, SankeyChart, type SankeyData, type SankeyDropOff, type SankeyHoverCardData, type SankeyLink, type SankeyNode, type SankeyStageMetrics, ScoreAnalysisModal, type ScoreAnalysisModalProps, ScoreAnalysisPanel, ScoreBreakdown, type ScoreBreakdownProps, type ScoreFactor, ScoreFeedback, ScoreRing, type ScoreRingProps, ScrollArea, ScrollBar, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, Separator, Sheet, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetTitle, SheetTrigger, Sidebar, SidebarContent, SidebarFooter, SidebarGroup, SidebarGroupAction, SidebarGroupContent, SidebarGroupLabel, SidebarHeader, SidebarInput, SidebarInset, SidebarMenu, SidebarMenuAction, SidebarMenuBadge, SidebarMenuButton, SidebarMenuItem, SidebarMenuSkeleton, SidebarMenuSub, SidebarMenuSubButton, SidebarMenuSubItem, type SidebarNavItem, type SidebarNavSection, SidebarProvider, SidebarRail, SidebarSeparator, SidebarTrigger, type SidebarUserProfile, SignalApproval, Actions as SignalApprovalActions, Gate as SignalApprovalGate, Root as SignalApprovalRoot, type SignalScoreData, SimpleChartTooltip, type SimpleChartTooltipProps, SimpleDataTable, type SimpleDataTableProps, Skeleton, type SourceDef, SourceList, StatusBadge, type StatusBadgeProps, type StatusType, type StyledBarItem, StyledBarList, type StyledBarListProps, type SuggestedAction, type SuggestedActionCallMeta, type SuggestedActionEmailMeta, type SuggestedActionFollowUp, type SuggestedActionReplyTo, type SuggestedActionThreadMessage, type SuggestedActionTicket, SuggestedActions, type SuggestedActionsIconMap, type SuggestedActionsProps, type SuggestedContact, SystemActivity, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableRow, Tabs, TabsContent, TabsList, TabsTrigger, Textarea, ThreadMessage, TimelineActivity, type TimelineActivityProps, type TimelineEvent, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, TopLineMetrics, type TopLineMetricsProps, TopTasksCard, TrendAreaChart, type TrendAreaChartProps, type TrendSeries, UpcomingMeetingsCard, type UserMenuItem, type ViewMode, ViewModeToggle, type ViewModeToggleProps, VolumeAnalysisChart, type VolumeAnalysisChartProps, type VolumeDataKey, type WorkQueueViewConfig, badgeVariants, buttonVariants, cn, getScoreColor, tabsListVariants, useAgentPopover, useIsMobile, useScoreFeedback, useSidebar, useSignalApproval };
+export { type AccountFilterTab, type AccountsViewConfig, type ActiveVariant, ActivityDetail, type ActivityDetailData, type ActivityDetailProps, type ActivityItem, ActivityLog, type ActivityLogItem, type ActivityLogProps, type ActivityParticipant, ActivityRow, type ActivityThreadMessage, type AdminTab, type AdminViewConfig, AgentOrb, AgentOrbCanvas, type AgentOrbProps, type AgentOrbState, AgentPopover, AgentPopoverBranding, type AgentPopoverBrandingProps, AgentPopoverChat, type AgentPopoverChatProps, type AgentPopoverContextValue, AgentPopoverForm, type AgentPopoverFormField, type AgentPopoverFormProps, AgentPopoverOverview, type AgentPopoverOverviewProps, type AgentPopoverProps, type AgentPopoverStep, AgentPopoverStepContent, type AgentPopoverStepContentProps, AgentWidget, type AgentWidgetMessage, type AgentWidgetMode, type AgentWidgetProps, type AgentWidgetStatus, type AssigneeFilter, Avatar, AvatarBadge, AvatarFallback, AvatarGroup, AvatarGroupCount, AvatarImage, Badge, BarChartComponent, type BarChartComponentProps, type BarSeries, Button, CHART_CURSOR_STYLE, CHART_TOOLTIP_STYLE, Card, CardAction, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, type ChartConfig, ChartContainer, ChartLegend, ChartLegendContent, ChartStyle, ChartTooltip, ChartTooltipContent, type ChartTooltipEntry, CheckInsCard, Citation, ConnectedApps, type ConnectionStatus, type ContactChannel, type ContactItem, ContactList, type ContactListProps, DataTable, DataTableDisplay, type DataTableDisplayColumn, DataTableFilter, type DataTableFilterCategory, type DataTableQuickViewValue, DataTableQuickViews, DataTableToolbar, DetailViewHeader, DetailViewSummary, DetailViewThread, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, DonutChart, type DonutChartProps, type DonutSegment, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, EntityActivityItem, EntityDetails, type EntityMetadataField, EntityMetadataGrid, EntityPanel, type EntityPanelBrandIcons, type EntityPanelConfig, EntityPanelHeader, type EntityPanelSection, EntityPanelTabs, EntitySection, type FilterDefinition, type GroupedListGroup, GroupedListView, type GroupedListViewProps, type InboxDetailSections, type InboxFilterCategory, InboxGroupHeader, InboxRow, type InboxRowProps, InboxToolbar, type InboxToolbarProps, type InboxViewConfig, Input, InsightsFilterBar, type InsightsFilterBarProps, type InsightsViewConfig, ItemList, ItemListDisplay, type ItemListDisplayState, ItemListFilter, type ItemListFilterCategory, type ItemListGrouping, type ItemListQuickView, ItemListToolbar, type ItemListViewMode, Label, Message, MessageAvatar, type MessageAvatarProps, MessageContent, type MessageContentProps, type MessageProps, MetricCard, type MetricCardData, type MetricCardProps, type MetricDataPoint, PerformanceMetricsTable, type PerformanceMetricsTableRow, type PerformanceMetricsTableSortOption, type PipelineFilterBreakdown, PipelineOverview, type PipelineOverviewProps, type PipelineStage, type PipelineStageMetrics, type PipelineStageTiming, PotentialContacts, PreviewList, PreviewListItem, type PreviewListItemProps, Progress, PrototypeAccountsView, type PrototypeAccountsViewProps, PrototypeAdminView, type PrototypeAdminViewProps, type PrototypeBrandConfig, type PrototypeConfig, PrototypeInboxView, type PrototypeInboxViewProps, PrototypeInsightsView, type PrototypeInsightsViewProps, PrototypeShell, type PrototypeShellProps, PrototypeWorkQueueView, type PrototypeWorkQueueViewProps, type QueueItem, QuickActionChatArea, QuickActionModal, type QuickActionPriority$1 as QuickActionPriority, QuickActionSidebarNav, type QuickActionSubmitPayload, type QuickActionTaskDraft, type QuickActionTemplate, RecentActivity, RecentlyCompletedCard, type RecommendedAction, RecommendedActionsSection, ReportCard, type ReportCardProps, SankeyChart, type SankeyData, type SankeyDropOff, type SankeyHoverCardData, type SankeyLink, type SankeyNode, type SankeyStageMetrics, ScoreAnalysisModal, type ScoreAnalysisModalProps, ScoreAnalysisPanel, ScoreBreakdown, type ScoreBreakdownProps, type ScoreFactor, ScoreFeedback, ScoreRing, type ScoreRingProps, ScrollArea, ScrollBar, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, Separator, Sheet, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetTitle, SheetTrigger, Sidebar, SidebarContent, SidebarFooter, SidebarGroup, SidebarGroupAction, SidebarGroupContent, SidebarGroupLabel, SidebarHeader, SidebarInput, SidebarInset, SidebarMenu, SidebarMenuAction, SidebarMenuBadge, SidebarMenuButton, SidebarMenuItem, SidebarMenuSkeleton, SidebarMenuSub, SidebarMenuSubButton, SidebarMenuSubItem, type SidebarNavItem, type SidebarNavSection, SidebarProvider, SidebarRail, SidebarSeparator, SidebarTrigger, type SidebarUserProfile, SignalApproval, Actions as SignalApprovalActions, Gate as SignalApprovalGate, Root as SignalApprovalRoot, type SignalScoreData, SimpleChartTooltip, type SimpleChartTooltipProps, SimpleDataTable, type SimpleDataTableProps, Skeleton, type SourceDef, SourceList, StatusBadge, type StatusBadgeProps, type StatusType, type StyledBarItem, StyledBarList, type StyledBarListProps, type SuggestedAction, type SuggestedActionCallMeta, type SuggestedActionEmailMeta, type SuggestedActionFollowUp, type SuggestedActionReplyTo, type SuggestedActionThreadMessage, type SuggestedActionTicket, SuggestedActions, type SuggestedActionsIconMap, type SuggestedActionsProps, type SuggestedContact, SystemActivity, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableRow, Tabs, TabsContent, TabsList, TabsTrigger, Textarea, ThreadMessage, TimelineActivity, type TimelineActivityProps, type TimelineEvent, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, TopLineMetrics, type TopLineMetricsProps, TopTasksCard, TrendAreaChart, type TrendAreaChartProps, type TrendSeries, UpcomingMeetingsCard, type UserMenuItem, type ViewMode, ViewModeToggle, type ViewModeToggleProps, VolumeAnalysisChart, type VolumeAnalysisChartProps, type VolumeDataKey, type WorkQueueViewConfig, badgeVariants, buttonVariants, cn, getScoreColor, tabsListVariants, useAgentPopover, useIsMobile, useScoreFeedback, useSidebar, useSignalApproval };