@handled-ai/design-system 0.8.0 → 0.9.1

package/src/prototype/prototype-config.ts

@@ -0,0 +1,243 @@
+import * as React from "react"
+import type { SidebarNavSection } from "../components/quick-action-sidebar-nav"
+import type { ScoreFactor } from "../components/score-breakdown"
+import type { SuggestedAction, SuggestedContact } from "../components/suggested-actions"
+import type { SourceDef } from "../components/detail-view"
+import type { InboxFilterCategory } from "../components/inbox-toolbar"
+import type { DataTableFilterCategory } from "../components/data-table-filter"
+import type { DataRow } from "../components/data-table"
+import type { MetricCardProps } from "../components/metric-card"
+import type {
+  PipelineStage,
+  PipelineStageMetrics,
+  PipelineStageTiming,
+} from "../charts/pipeline-overview"
+import type { TimelineEvent } from "../components/timeline-activity"
+import type { LucideIcon } from "lucide-react"
+
+// ---------------------------------------------------------------------------
+// Shared
+// ---------------------------------------------------------------------------
+
+export interface PrototypeBrandConfig {
+  name: string
+  logo?: string
+  assistantName?: string
+}
+
+export interface QueueItem {
+  id: string
+  title: string
+  details: string
+  statusColor: string
+  time: string
+  company: string
+  tag1: string
+}
+
+export interface SignalScoreData {
+  score: number
+  factors: ScoreFactor[]
+  whyNow: string
+  evidence: string[]
+  confidence: number
+  onFactorFeedback?: (factorKey: string, type: "up" | "down" | null, detail?: string) => void
+  onApproveFeedback?: (reasons: string[], detail: string) => void
+  onDismissFeedback?: (reasons: string[], detail: string) => void
+}
+
+// ---------------------------------------------------------------------------
+// Inbox
+// ---------------------------------------------------------------------------
+
+export interface InboxDetailSections {
+  signalBrief?: boolean
+  suggestedActions?: boolean
+  timeline?: boolean
+}
+
+export interface InboxViewConfig {
+  items: QueueItem[]
+  filterCategories?: InboxFilterCategory[]
+  detailSections?: InboxDetailSections
+  accountContacts?: SuggestedContact[]
+  buildAccountContacts?: (item: QueueItem) => SuggestedContact[]
+  emailSignature?: string | React.ReactNode
+  buildSuggestedActions?: (item: QueueItem) => SuggestedAction[]
+  buildSourceItems?: (item: QueueItem) => SourceDef[]
+  getSignalScore?: (company: string) => SignalScoreData
+  getTimelineEvents?: (item: QueueItem) => TimelineEvent[]
+  iconMap?: Record<string, string>
+  hideToolbarActions?: boolean
+  hideHoverActions?: boolean
+  onSuggestedActionFeedback?: (actionId: number | string, feedback: string, actionTitle?: string) => void
+  buildEntityChips?: (item: QueueItem) => Array<{ id: string; label: string; avatarLetter: string; onClick?: () => void }>
+  quickFilterTabs?: Array<{ id: string; label: string; matchValue?: string; count?: number }>
+  hideAccountsButton?: boolean
+  accountDetailsLabel?: string
+  signalLabels?: {
+    approveButton?: string
+    dismissButton?: string
+    approvedStatus?: string
+    dismissedStatus?: string
+  }
+}
+
+// ---------------------------------------------------------------------------
+// Insights
+// ---------------------------------------------------------------------------
+
+export interface InsightsCustomTab {
+  id: string
+  label: string
+  icon?: React.ComponentType<{ className?: string }>
+  content: React.ReactNode
+}
+
+export interface InsightsViewConfig {
+  customTabs?: InsightsCustomTab[]
+  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
+    }
+  }
+}
+
+// ---------------------------------------------------------------------------
+// Accounts
+// ---------------------------------------------------------------------------
+
+export interface AccountFilterTab {
+  label: string
+  count?: number
+  variant?: "default" | "attention" | "ghost"
+}
+
+export interface AccountsViewConfig {
+  filterTabs?: AccountFilterTab[]
+  rows?: DataRow[]
+  filterCategories?: DataTableFilterCategory[]
+  quickViews?: string[]
+  moreQuickViews?: string[]
+  quickViewFilters?: Record<string, (row: DataRow) => boolean>
+  iconMap?: { salesforce?: string }
+  entityUrlBuilder?: (row: DataRow) => string
+  onScoreFactorFeedback?: (account: string, scoreType: string, factorKey: string, type: "up" | "down" | null, detail?: string) => void
+  onScoreApproveFeedback?: (account: string, scoreType: string, reasons: string[], detail: string) => void
+  onScoreDismissFeedback?: (account: string, scoreType: string, reasons: string[], detail: string) => void
+}
+
+// ---------------------------------------------------------------------------
+// Work Queue
+// ---------------------------------------------------------------------------
+
+export interface WorkQueueViewConfig {
+  // Extensible – ItemList manages its own data internally for now.
+  [key: string]: unknown
+}
+
+// ---------------------------------------------------------------------------
+// Admin
+// ---------------------------------------------------------------------------
+
+export interface AdminTab {
+  id: string
+  label: string
+  icon?: React.ComponentType<{ className?: string }>
+  content: React.ReactNode
+}
+
+export interface AdminViewConfig {
+  /** View title displayed in the header. Defaults to "Admin". */
+  title?: string
+  /** Icon displayed next to the title. */
+  icon?: React.ComponentType<{ className?: string }>
+  tabs: AdminTab[]
+  /** Which tab is active initially. Defaults to first tab's id. */
+  defaultTab?: string
+}
+
+// ---------------------------------------------------------------------------
+// Entity Panel
+// ---------------------------------------------------------------------------
+
+export interface EntityPanelSection {
+  type: "details" | "contacts" | "recentActivity" | "connectedApps" | "systemActivity"
+  props?: Record<string, unknown>
+}
+
+export interface EntityPanelConfig {
+  sections?: EntityPanelSection[]
+  icons?: Record<string, string>
+}
+
+// ---------------------------------------------------------------------------
+// Top-level config
+// ---------------------------------------------------------------------------
+
+export interface PrototypeConfig {
+  brand?: PrototypeBrandConfig
+  sidebar: SidebarNavSection[]
+  views: {
+    inbox?: InboxViewConfig
+    insights?: InsightsViewConfig
+    accounts?: AccountsViewConfig
+    workQueue?: WorkQueueViewConfig
+    admin?: AdminViewConfig
+  }
+  defaultView: string
+  entityPanel?: EntityPanelConfig
+  /** Sidebar item IDs that trigger view navigation. Defaults to keys of `views`. */
+  navigableViews?: string[]
+}