@handled-ai/design-system 0.2.1 → 0.3.1

package/dist/index.d.ts

@@ -6,6 +6,7 @@ import { VariantProps } from 'class-variance-authority';
 import * as RechartsPrimitive from 'recharts';
 import { SortingState } from '@tanstack/react-table';
 import * as LabelPrimitive from '@radix-ui/react-label';
+import { LucideIcon } from 'lucide-react';
 
 declare function cn(...inputs: ClassValue[]): string;
 
@@ -811,11 +812,13 @@ interface UserMenuItem {
     }>;
     destructive?: boolean;
 }
+type ActiveVariant = "default" | "gradient";
 interface QuickActionSidebarNavProps extends React$1.ComponentProps<"aside"> {
     brandLabel?: string;
     brandSubtitle?: string;
     navSections?: SidebarNavSection[];
     activeItemId?: string;
+    activeVariant?: ActiveVariant;
     onNavigate?: (itemId: string) => void;
     user?: SidebarUserProfile;
     userMenuItems?: UserMenuItem[];
@@ -823,7 +826,7 @@ interface QuickActionSidebarNavProps extends React$1.ComponentProps<"aside"> {
     onCreateTask?: (draft: QuickActionTaskDraft) => void;
     defaultCollapsed?: boolean;
 }
-declare function QuickActionSidebarNav({ className, brandLabel, brandSubtitle, navSections, activeItemId, onNavigate, user, userMenuItems, onUserMenuAction, onCreateTask, defaultCollapsed, ...props }: QuickActionSidebarNavProps): React$1.JSX.Element;
+declare function QuickActionSidebarNav({ className, brandLabel, brandSubtitle, navSections, activeItemId, activeVariant, onNavigate, user, userMenuItems, onUserMenuAction, onCreateTask, defaultCollapsed, ...props }: QuickActionSidebarNavProps): React$1.JSX.Element;
 
 interface RecommendedAction {
     id: string;
@@ -1328,4 +1331,198 @@ interface VolumeAnalysisChartProps {
 }
 declare function VolumeAnalysisChart({ data, dataKeys, height, xAxisKey, stacked, title, subtitle, className, }: VolumeAnalysisChartProps): React$1.JSX.Element;
 
-export { ActivityDetail, type ActivityDetailData, type ActivityDetailProps, type ActivityItem, ActivityLog, type ActivityLogItem, type ActivityLogProps, type ActivityParticipant, ActivityRow, type ActivityThreadMessage, 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 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, EntityPanelHeader, EntityPanelTabs, EntitySection, type GroupedListGroup, GroupedListView, type GroupedListViewProps, type InboxFilterCategory, InboxGroupHeader, InboxRow, type InboxRowProps, InboxToolbar, type InboxToolbarProps, Input, ItemList, ItemListDisplay, type ItemListDisplayState, ItemListFilter, type ItemListFilterCategory, type ItemListGrouping, type ItemListQuickView, ItemListToolbar, type ItemListViewMode, Label, 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, 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, SimpleChartTooltip, type SimpleChartTooltipProps, Skeleton, type SourceDef, SourceList, 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, badgeVariants, buttonVariants, cn, getScoreColor, tabsListVariants, useIsMobile, useScoreFeedback, useSidebar, useSignalApproval };
+interface PrototypeBrandConfig {
+    name: string;
+    logo?: string;
+    assistantName?: string;
+}
+interface QueueItem {
+    id: string;
+    title: string;
+    details: string;
+    statusColor: string;
+    time: string;
+    company: string;
+    tag1: string;
+}
+interface SignalScoreData {
+    score: number;
+    factors: ScoreFactor[];
+    whyNow: string;
+    evidence: string[];
+    confidence: number;
+}
+interface InboxDetailSections {
+    signalBrief?: boolean;
+    suggestedActions?: boolean;
+    timeline?: boolean;
+}
+interface InboxViewConfig {
+    items: QueueItem[];
+    filterCategories?: InboxFilterCategory[];
+    detailSections?: InboxDetailSections;
+    accountContacts?: SuggestedContact[];
+    emailSignature?: string;
+    buildSuggestedActions?: (item: QueueItem) => SuggestedAction[];
+    buildSourceItems?: (item: QueueItem) => SourceDef[];
+    getSignalScore?: (company: string) => SignalScoreData;
+    getTimelineEvents?: (item: QueueItem) => TimelineEvent[];
+    iconMap?: Record<string, string>;
+}
+interface InsightsViewConfig {
+    tabs?: {
+        overview?: boolean;
+        analytics?: boolean;
+    };
+    coaching?: {
+        enabled?: boolean;
+        message?: string;
+    };
+    metrics?: MetricCardProps[];
+    expandedMetrics?: MetricCardProps[];
+    dashboardCards?: {
+        topTasks?: boolean;
+        upcomingMeetings?: boolean;
+        recentlyCompleted?: boolean;
+        checkIns?: boolean;
+    };
+    analytics?: {
+        pipeline?: {
+            stages: PipelineStage[];
+            stageMetrics: Record<string, PipelineStageMetrics>;
+            stageTimings: (PipelineStageTiming | null)[];
+            filterBreakdowns?: Record<string, Record<string, Record<string, number>>>;
+        };
+        volumeChart?: {
+            data: Record<string, unknown>[];
+            dataKeys: Array<{
+                key: string;
+                color: string;
+            }>;
+            filterOptions?: Array<{
+                label: string;
+                value: string;
+            }>;
+        };
+        donutChart?: {
+            data: Array<{
+                name: string;
+                value: number;
+                color: string;
+            }>;
+            centerLabel?: number;
+        };
+        trendChart?: {
+            data: Record<string, unknown>[];
+            series: Array<{
+                dataKey: string;
+                color: string;
+            }>;
+            xAxisKey?: string;
+            height?: number;
+            toggleOptions?: string[];
+        };
+        barChart?: {
+            data: Record<string, unknown>[];
+            bars: Array<{
+                dataKey: string;
+                color: string;
+                name: string;
+                icon?: LucideIcon;
+            }>;
+        };
+        barList?: {
+            data: Array<{
+                name: string;
+                value: number;
+            }>;
+            valueFormatter?: (v: number) => string;
+        };
+    };
+}
+interface AccountFilterTab {
+    label: string;
+    count?: number;
+    variant?: "default" | "attention" | "ghost";
+}
+interface AccountsViewConfig {
+    filterTabs?: AccountFilterTab[];
+}
+interface WorkQueueViewConfig {
+    [key: string]: unknown;
+}
+interface EntityPanelSection {
+    type: "details" | "contacts" | "recentActivity" | "connectedApps" | "systemActivity";
+    props?: Record<string, unknown>;
+}
+interface EntityPanelConfig {
+    sections?: EntityPanelSection[];
+    icons?: Record<string, string>;
+}
+interface PrototypeConfig {
+    brand?: PrototypeBrandConfig;
+    sidebar: SidebarNavSection[];
+    views: {
+        inbox?: InboxViewConfig;
+        insights?: InsightsViewConfig;
+        accounts?: AccountsViewConfig;
+        workQueue?: WorkQueueViewConfig;
+    };
+    defaultView: string;
+    entityPanel?: EntityPanelConfig;
+    /** Sidebar item IDs that trigger view navigation. Defaults to keys of `views`. */
+    navigableViews?: string[];
+}
+
+interface PrototypeShellProps {
+    config: PrototypeConfig;
+    /**
+     * Optional ReactNode rendered in the header area of each view.
+     * Useful for adding an "Exit Preview" button in the design system showcase.
+     */
+    headerActions?: React$1.ReactNode;
+    /**
+     * Custom content to render inside the EntityPanel.
+     * When provided, overrides the default section-based rendering.
+     * Receives `onClose` so children can close the panel.
+     */
+    entityPanelChildren?: React$1.ReactNode | ((ctx: {
+        onClose: () => void;
+    }) => React$1.ReactNode);
+    /**
+     * Fired on every sidebar navigation click (both navigable and non-navigable views).
+     * Useful for intercepting clicks on product-specific views like "settings"
+     * that live outside the shell.
+     */
+    onNavigate?: (viewId: string) => void;
+}
+declare function PrototypeShell({ config, headerActions, entityPanelChildren, onNavigate, }: PrototypeShellProps): React$1.JSX.Element;
+
+interface PrototypeInboxViewProps extends InboxViewConfig {
+    /** Extra ReactNode rendered at the end of the header bar (e.g. exit button). */
+    headerActions?: React$1.ReactNode;
+    onOpenEntityPanel?: () => void;
+    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;
+
+interface PrototypeInsightsViewProps extends InsightsViewConfig {
+    assistantName?: string;
+    headerActions?: React$1.ReactNode;
+    onNavigateToInbox?: () => void;
+}
+declare function PrototypeInsightsView({ tabs, coaching, metrics, expandedMetrics, dashboardCards, analytics, assistantName, headerActions, onNavigateToInbox, }: PrototypeInsightsViewProps): React$1.JSX.Element;
+
+interface PrototypeAccountsViewProps extends AccountsViewConfig {
+    headerActions?: React$1.ReactNode;
+    onRowClick?: () => void;
+}
+declare function PrototypeAccountsView({ filterTabs, headerActions, onRowClick, }: PrototypeAccountsViewProps): React$1.JSX.Element;
+
+interface PrototypeWorkQueueViewProps {
+    headerActions?: React$1.ReactNode;
+}
+declare function PrototypeWorkQueueView({ headerActions, }: PrototypeWorkQueueViewProps): 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, 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 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, 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, Skeleton, type SourceDef, SourceList, 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, useIsMobile, useScoreFeedback, useSidebar, useSignalApproval };