@freedom-code-compliance/fcc-redesign 0.1.50 → 0.1.52

package/index.d.ts

@@ -0,0 +1,554 @@
+import type { CSSProperties, ReactNode } from 'react'
+import type { ComponentPropsWithoutRef, ComponentType, JSX } from 'react'
+
+type FCCAnyComponent = ComponentType<Record<string, unknown>>
+
+export type FCCChatTab = 'hubs' | 'tickets' | 'dms'
+export type FCCChatViewport = 'mobile' | 'smallDesktop' | 'bigDesktop'
+
+export interface FCCChatSelection<Item = FCCChatHubItem | FCCChatTicketItem | FCCChatDMItem> {
+  tab: FCCChatTab
+  kind: FCCChatTab
+  id: string
+  item: Item
+}
+
+export interface FCCChatAvatarGroupItem {
+  id?: string
+  name?: string
+  avatarUrl?: string
+  avatarText?: string
+  presenceStatus?: 'available' | 'plan_review' | 'unavailable' | 'offline_insp' | 'offline'
+}
+
+export interface FCCChatBaseItem {
+  id: string
+  title: ReactNode
+  name?: ReactNode
+  subtitle?: ReactNode
+  description?: ReactNode
+  meta?: ReactNode
+  time?: ReactNode
+  countLabel?: ReactNode
+  messageCount?: number
+  replyCount?: number
+  subscribed?: boolean
+  unread?: boolean
+  group?: 'open' | 'resolved' | string
+  isClosed?: boolean
+  isResolved?: boolean
+  dotColor?: string
+  statusLabel?: ReactNode
+  badge?: ReactNode
+  avatar?: ReactNode
+  avatarUrl?: string
+  avatarGroup?: FCCChatAvatarGroupItem[]
+  avatarText?: string
+  avatarStyle?: CSSProperties
+  presenceStatus?: 'available' | 'plan_review' | 'unavailable' | 'offline_insp' | 'offline'
+}
+
+export interface FCCChatHubItem extends FCCChatBaseItem {}
+export interface FCCChatTicketItem extends FCCChatBaseItem {}
+export interface FCCChatDMItem extends FCCChatBaseItem {}
+
+export interface FCCChatFilterState {
+  search?: string
+  mode?: 'subscribed' | 'all'
+  sortBy?: 'last_activity' | 'created_at' | 'title'
+  ticketSortBy?: 'last_activity' | 'created_at' | 'title'
+  status?: '' | 'open' | 'resolved'
+  ticketStatus?: '' | 'open' | 'resolved'
+  searchByTab?: Partial<Record<FCCChatTab, string>>
+  modeByTab?: Partial<Record<FCCChatTab, 'subscribed' | 'all'>>
+}
+
+export interface FCCChatAttachment {
+  id?: string
+  name?: string
+  url?: string
+  thumbnailUrl?: string
+  alt?: string
+  [key: string]: unknown
+}
+
+export interface FCCChatReaction {
+  emoji?: ReactNode
+  label?: ReactNode
+  count?: ReactNode
+}
+
+export interface FCCChatAuthor {
+  id?: string
+  name?: string
+  avatar?: ReactNode
+  avatarUrl?: string
+  avatarText?: string
+  avatarStyle?: CSSProperties
+  presenceStatus?: 'available' | 'plan_review' | 'unavailable' | 'offline_insp' | 'offline'
+}
+
+export interface FCCChatMessage {
+  id?: string
+  type?: 'message' | 'divider'
+  label?: ReactNode
+  from?: string
+  isOwn?: boolean
+  author?: FCCChatAuthor
+  authorName?: ReactNode
+  time?: ReactNode
+  body?: ReactNode
+  text?: ReactNode
+  attachments?: FCCChatAttachment[]
+  attachmentLayout?: 'default' | 'ticket' | 'hub'
+  reactions?: FCCChatReaction[]
+  hideReplyAction?: boolean
+  hideQuoteReplyAction?: boolean
+  onReaction?: (message: FCCChatMessage) => void
+  onReply?: (message: FCCChatMessage) => void
+  onQuoteReply?: (message: FCCChatMessage) => void
+  onMoreActions?: (message: FCCChatMessage) => void
+  onCopy?: (message: FCCChatMessage) => void
+  [key: string]: unknown
+}
+
+export interface FCCChatHubUpdate extends FCCChatMessage {
+  author?: FCCChatAuthor
+}
+
+export interface FCCChatDetailModel {
+  id: string
+  kind: FCCChatTab
+  title?: ReactNode
+  subtitle?: ReactNode
+  projectId?: string
+  participantCount?: number
+  tags?: Array<string | { label: ReactNode }>
+  actions?: ReactNode
+  status?: string
+  statusSteps?: string[]
+  messages?: FCCChatMessage[]
+  updates?: FCCChatHubUpdate[]
+  hubAction?: ReactNode
+  onOpenProject?: (projectId?: string) => void
+  onSelectUpdate?: (update: FCCChatHubUpdate) => void
+  onMessageReaction?: (message: FCCChatMessage) => void
+  onMessageReply?: (message: FCCChatMessage) => void
+  onMessageQuoteReply?: (message: FCCChatMessage) => void
+  onMessageMoreActions?: (message: FCCChatMessage) => void
+  onMessageCopy?: (message: FCCChatMessage) => void
+  composerPlaceholder?: string
+  onSubmit?: (value: string) => void
+  [key: string]: unknown
+}
+
+export interface FCCChatDetailSlotProps {
+  detail: FCCChatDetailModel
+  onCloseDetail?: () => void
+}
+
+export type FCCChatHubDetailSlotProps = FCCChatDetailSlotProps
+export type FCCChatTicketDetailSlotProps = FCCChatDetailSlotProps
+export type FCCChatDMDetailSlotProps = FCCChatDetailSlotProps
+
+export interface FCCChatComposerSlotProps {
+  detail: FCCChatDetailModel
+}
+
+export interface FCCChatSidebarSlots {
+  headerActions?: ReactNode
+  hubsToolbarActions?: ReactNode
+  ticketsToolbarActions?: ReactNode
+  dmsToolbarActions?: ReactNode
+  renderHubDetail?: (hub: FCCChatHubDetailSlotProps) => ReactNode
+  renderTicketDetail?: (ticket: FCCChatTicketDetailSlotProps) => ReactNode
+  renderDMDetail?: (dm: FCCChatDMDetailSlotProps) => ReactNode
+  renderComposer?: (props: FCCChatComposerSlotProps) => ReactNode
+  renderMessageAttachment?: (attachment: FCCChatAttachment) => ReactNode
+  renderInlineReply?: (message: FCCChatMessage) => ReactNode
+  footerAction?: ReactNode
+}
+
+export interface FCCChatSidebarProps extends Omit<ComponentPropsWithoutRef<'section'>, 'title' | 'onSelect'> {
+  open: boolean
+  activeTab: FCCChatTab
+  onTabChange: (tab: FCCChatTab) => void
+  onClose: () => void
+  title?: ReactNode
+  scopedTitle?: ReactNode
+  hubs: FCCChatHubItem[]
+  tickets: FCCChatTicketItem[]
+  dms: FCCChatDMItem[]
+  selectedId?: string | null
+  detailOpen: boolean
+  onSelectItem: (item: FCCChatSelection) => void
+  onCloseDetail: () => void
+  loading?: Partial<Record<FCCChatTab | 'detail', boolean>>
+  error?: Partial<Record<FCCChatTab | 'detail', ReactNode>>
+  filters?: FCCChatFilterState
+  onFiltersChange?: (filters: FCCChatFilterState) => void
+  detail: FCCChatDetailModel | null
+  slots?: FCCChatSidebarSlots
+  mobilePortalTargetSelector?: string | null
+}
+
+export interface FCCChatMessageListProps {
+  messages?: FCCChatMessage[]
+  renderMessageAttachment?: (attachment: FCCChatAttachment) => ReactNode
+  renderInlineReply?: (message: FCCChatMessage) => ReactNode
+  emptyLabel?: ReactNode
+  attachmentLayout?: 'default' | 'ticket' | 'hub'
+  onMessageReaction?: (message: FCCChatMessage) => void
+  onMessageReply?: (message: FCCChatMessage) => void
+  onMessageQuoteReply?: (message: FCCChatMessage) => void
+  onMessageMoreActions?: (message: FCCChatMessage) => void
+  onMessageCopy?: (message: FCCChatMessage) => void
+}
+
+export interface FCCChatComposerFrameProps {
+  placeholder?: string
+  value?: string
+  onChange?: (value: string) => void
+  onSubmit?: (value: string) => void
+  disabled?: boolean
+  leadingAction?: ReactNode
+  sendLabel?: string
+  children?: ReactNode
+}
+
+export interface FCCChatHubFeedProps {
+  updates?: FCCChatHubUpdate[]
+  onSelectUpdate?: (update: FCCChatHubUpdate) => void
+  action?: ReactNode
+  renderMessageAttachment?: (attachment: FCCChatAttachment) => ReactNode
+  renderInlineReply?: (message: FCCChatMessage) => ReactNode
+}
+
+export interface FCCChatTicketStatusTrackerProps {
+  steps?: string[]
+  current?: string
+}
+
+export function FCCChatSidebar(props: FCCChatSidebarProps): JSX.Element
+export function FCCChatMessageList(props: FCCChatMessageListProps): JSX.Element
+export function FCCChatComposerFrame(props: FCCChatComposerFrameProps): JSX.Element
+export function FCCChatHubFeed(props: FCCChatHubFeedProps): JSX.Element
+export function FCCChatTicketStatusTracker(props: FCCChatTicketStatusTrackerProps): JSX.Element
+
+export const FCC_CHAT_TABS: Array<{ id: FCCChatTab; label: string }>
+export const FCC_CHAT_WIDTHS: {
+  rail: number
+  detail: number
+  small: number
+  mobile: '100%'
+}
+export const FCC_CHAT_BREAKPOINTS: {
+  mobile: number
+  smallDesktop: number
+}
+
+export type FCCCallsSidePanelTab = 'dial' | 'calls' | 'voicemail'
+
+export interface FCCCallsDepartmentOption {
+  value: string
+  label: ReactNode
+}
+
+export interface FCCCallsPerson {
+  name?: string
+  number?: string
+  avatarUrl?: string
+  [key: string]: unknown
+}
+
+export interface FCCCallsTicket {
+  number?: string
+  department?: string
+  [key: string]: unknown
+}
+
+export interface FCCCallsHistoryItem {
+  id: string
+  caller?: FCCCallsPerson
+  direction?: 'inbound' | 'outbound' | string
+  outcome?: 'completed' | 'voicemail' | 'missed' | 'transferred' | 'callback' | string
+  startedAt?: string
+  durationSec?: number
+  department?: string
+  phoneNumber?: string
+  number?: string
+  ticket?: FCCCallsTicket | null
+  [key: string]: unknown
+}
+
+export interface FCCCallsQueueItem {
+  id: string
+  caller?: FCCCallsPerson
+  status?: 'open' | 'resolved' | 'called_back' | string
+  assignedTo?: { userId?: string; [key: string]: unknown } | null
+  department?: string
+  ticket?: FCCCallsTicket | null
+  [key: string]: unknown
+}
+
+export interface FCCCallsVoicemailItem extends FCCCallsQueueItem {
+  transcript?: ReactNode
+  receivedAt?: string
+  durationSec?: number
+}
+
+export interface FCCCallsCallbackItem extends FCCCallsQueueItem {
+  reason?: ReactNode
+  createdAt?: string
+  slaDeadlineAt?: string
+}
+
+export interface FCCCallsSidePanelProps {
+  activeTab?: FCCCallsSidePanelTab
+  callbacks?: FCCCallsCallbackItem[]
+  className?: string
+  currentUserId?: string | null
+  defaultDepartment?: string
+  defaultDialValue?: string
+  defaultTab?: FCCCallsSidePanelTab
+  departments?: FCCCallsDepartmentOption[]
+  departmentValue?: string
+  dialDisabled?: boolean
+  dialValue?: string
+  headerActions?: ReactNode
+  history?: FCCCallsHistoryItem[]
+  isDialing?: boolean
+  newCount?: number
+  onClaimCallback?: (callback: FCCCallsCallbackItem) => void
+  onClaimVoicemail?: (voicemail: FCCCallsVoicemailItem) => void
+  onClose?: () => void
+  onCompleteCallback?: (callback: FCCCallsCallbackItem) => void
+  onDepartmentChange?: (department: string) => void
+  onDial?: (number: string) => void
+  onDialValueChange?: (number: string) => void
+  onExpand?: () => void
+  onMore?: () => void
+  onOpenTicket?: (item: FCCCallsHistoryItem | FCCCallsVoicemailItem | FCCCallsCallbackItem) => void
+  onRedial?: (call: FCCCallsHistoryItem) => void
+  onResolveVoicemail?: (voicemail: FCCCallsVoicemailItem) => void
+  onReviewVoicemail?: (voicemail: FCCCallsVoicemailItem) => void
+  onSelectCall?: (call: FCCCallsHistoryItem) => void
+  onTabChange?: (tab: FCCCallsSidePanelTab) => void
+  recentLimit?: number
+  showMoreAction?: boolean
+  title?: ReactNode
+  voicemails?: FCCCallsVoicemailItem[]
+}
+
+export function FCCCallsSidePanel(props: FCCCallsSidePanelProps): JSX.Element
+
+export const FCCDesignProvider: FCCAnyComponent
+export const ThemeProvider: FCCAnyComponent
+export function useTheme(): unknown
+export const FCCAppShell: FCCAnyComponent
+export const FCCAppShellContext: unknown
+export function useFCCAppShell(): unknown
+export const FCCSidebar: FCCAnyComponent
+export const FCCMainWindow: FCCAnyComponent
+export const FCCWorkspaceHeader: FCCAnyComponent
+export const FCCBreadcrumbs: FCCAnyComponent
+export const FCCHeaderStatus: FCCAnyComponent
+export const FCCBrandLogo: FCCAnyComponent
+export const FCCThemeToggle: FCCAnyComponent
+export const FCCSidePanel: FCCAnyComponent
+export const FCCSidePanelHeader: FCCAnyComponent
+export const FCCSidePanelBody: FCCAnyComponent
+export const FCCSidePanelTabs: FCCAnyComponent
+export const FCCSidePanelSearch: FCCAnyComponent
+export const FCCSidePanelGroupLabel: FCCAnyComponent
+export const FCCSidePanelItem: FCCAnyComponent
+export const FCCSidePanelCard: FCCAnyComponent
+export const FCCSidePanelContact: FCCAnyComponent
+export const FCCSidePanelAction: FCCAnyComponent
+export const FCCSidePanelChatWrap: FCCAnyComponent
+export const FCCSidePanelConversation: FCCAnyComponent
+export const FCCSidePanelMessage: FCCAnyComponent
+export const FCCDetailsPanel: FCCAnyComponent
+export const FCCFullPagePanel: FCCAnyComponent
+export const FCCFullPagePanelHeader: FCCAnyComponent
+export const FCCFullPagePanelHeaderRevealZone: FCCAnyComponent
+export const FCCFullPagePanelSubHeader: FCCAnyComponent
+export const FCCFullPagePanelToolbar: FCCAnyComponent
+export const FCCFullPagePanelBody: FCCAnyComponent
+export const FCCFullPagePanelMain: FCCAnyComponent
+export const FCCFullPagePanelSidebar: FCCAnyComponent
+export const FCCFullPagePanelResizableSidebar: FCCAnyComponent
+export const FCCFullPagePanelBottomControls: FCCAnyComponent
+export const FCCFullPagePanelFooter: FCCAnyComponent
+export const FCCFullPagePanelSidebarFooter: FCCAnyComponent
+export const Accordion: FCCAnyComponent
+export const AccordionItem: FCCAnyComponent
+export const AppLoader: FCCAnyComponent
+export const Spinner: FCCAnyComponent
+export const FCCLoader: FCCAnyComponent
+export const Avatar: FCCAnyComponent
+export const Badge: FCCAnyComponent
+export const Button: FCCAnyComponent
+export const Card: FCCAnyComponent
+export const CardHeader: FCCAnyComponent
+export const CardTitle: FCCAnyComponent
+export const CardDescription: FCCAnyComponent
+export const CardContent: FCCAnyComponent
+export const CardFooter: FCCAnyComponent
+export const CardLayer: FCCAnyComponent
+export const CardHoverActions: FCCAnyComponent
+export const CardHoverAction: FCCAnyComponent
+export const Dialog: FCCAnyComponent
+export const DialogHeader: FCCAnyComponent
+export const DialogTitle: FCCAnyComponent
+export const DialogDescription: FCCAnyComponent
+export const DialogBody: FCCAnyComponent
+export const DialogFooter: FCCAnyComponent
+export const Input: FCCAnyComponent
+export const DropdownMenu: FCCAnyComponent
+export const DropdownMenuItem: FCCAnyComponent
+export const DropdownMenuCheckboxItem: FCCAnyComponent
+export const DropdownMenuLabel: FCCAnyComponent
+export const DropdownMenuSeparator: FCCAnyComponent
+export const SearchableSelect: FCCAnyComponent
+export const Sheet: FCCAnyComponent
+export const SheetFooter: FCCAnyComponent
+export const StatusMetric: FCCAnyComponent
+export const Switch: FCCAnyComponent
+export const Tabs: FCCAnyComponent
+export const TabsList: FCCAnyComponent
+export const TabsTrigger: FCCAnyComponent
+export const TabsContent: FCCAnyComponent
+export const Textarea: FCCAnyComponent
+export const ToastProvider: FCCAnyComponent
+export function useToast(): unknown
+export const Tooltip: FCCAnyComponent
+export const ViewModeToggle: FCCAnyComponent
+export const DEFAULT_VIEW_MODE_OPTIONS: unknown
+export const DEFAULT_ICON_BY_VALUE: unknown
+export const WorkspaceTabs: FCCAnyComponent
+export const Callbar: FCCAnyComponent
+export const CallCard: FCCAnyComponent
+export const CallControlsBar: FCCAnyComponent
+export const PresenceDot: FCCAnyComponent
+export const PresenceAvatar: FCCAnyComponent
+export const TicketLinkChip: FCCAnyComponent
+export const QueueItem: FCCAnyComponent
+export const ActivityFeed: FCCAnyComponent
+export const CommandBar: FCCAnyComponent
+export const DataTable: FCCAnyComponent
+export const FilterBar: FCCAnyComponent
+export const KanbanBoard: FCCAnyComponent
+export const KanbanColumn: FCCAnyComponent
+export const KanbanCard: FCCAnyComponent
+export const TableBoard: FCCAnyComponent
+export const TableBoardGroup: FCCAnyComponent
+export const TableBoardRow: FCCAnyComponent
+export const KPICard: FCCAnyComponent
+export const StatCard: FCCAnyComponent
+export const NotificationsPanel: FCCAnyComponent
+
+export type FCCIconName =
+  | 'inbox'
+  | 'issues'
+  | 'reviews'
+  | 'pulse'
+  | 'initiatives'
+  | 'projects'
+  | 'more'
+  | 'search'
+  | 'edit'
+  | 'chevronDown'
+  | 'chevronUp'
+  | 'chevron-down'
+  | 'chevron-up'
+  | 'star'
+  | 'statusInProgress'
+  | 'statusDone'
+  | 'statusTodo'
+  | 'statusBacklog'
+  | 'statusCancelled'
+  | 'status-in-progress'
+  | 'status-done'
+  | 'status-todo'
+  | 'status-backlog'
+  | 'status-cancelled'
+  | 'priorityUrgent'
+  | 'priorityHigh'
+  | 'priorityMedium'
+  | 'priorityLow'
+  | 'priority-urgent'
+  | 'priority-high'
+  | 'priority-medium'
+  | 'priority-low'
+  | 'link'
+  | 'trash'
+  | 'settings'
+  | 'close'
+  | 'check'
+  | 'copy'
+  | 'bell'
+  | 'calendar'
+  | 'filter'
+  | 'user'
+  | 'label'
+
+export interface FCCIconProps extends ComponentPropsWithoutRef<'svg'> {
+  size?: number | string
+  title?: string
+}
+
+export interface FCCIconWrapperProps extends FCCIconProps {
+  name?: FCCIconName | string
+  icon?: ComponentType<FCCIconProps & Record<string, unknown>>
+  color?: string
+}
+
+export interface FCCHeaderIconButtonProps extends ComponentPropsWithoutRef<'button'> {
+  icon?: ReactNode | ComponentType<FCCIconProps & Record<string, unknown>>
+  iconName?: FCCIconName | string
+  iconSize?: number | string
+  label: string
+  active?: boolean
+  badge?: ReactNode
+  badgeLabel?: string
+  badgeClassName?: string
+}
+
+export const FCC_ICON_MAP: Readonly<Record<string, ComponentType<FCCIconProps>>>
+export const FCC_ICON_ALIASES: Readonly<Record<string, string>>
+export function resolveFCCIconComponent(name?: FCCIconName | string): ComponentType<FCCIconProps> | null
+export function FCCIcon(props?: FCCIconWrapperProps): JSX.Element | null
+export const FCCHeaderIconButton: ComponentType<FCCHeaderIconButtonProps>
+export function InboxIcon(props?: FCCIconProps): JSX.Element
+export function IssuesIcon(props?: FCCIconProps): JSX.Element
+export function ReviewsIcon(props?: FCCIconProps): JSX.Element
+export function PulseIcon(props?: FCCIconProps): JSX.Element
+export function InitiativesIcon(props?: FCCIconProps): JSX.Element
+export function ProjectsIcon(props?: FCCIconProps): JSX.Element
+export function MoreIcon(props?: FCCIconProps): JSX.Element
+export function SearchIcon(props?: FCCIconProps): JSX.Element
+export function EditIcon(props?: FCCIconProps): JSX.Element
+export function ChevronDown(props?: FCCIconProps): JSX.Element
+export function ChevronUp(props?: FCCIconProps): JSX.Element
+export function StarIcon(props?: FCCIconProps): JSX.Element
+export function StatusInProgress(props?: FCCIconProps): JSX.Element
+export function StatusDone(props?: FCCIconProps): JSX.Element
+export function StatusTodo(props?: FCCIconProps): JSX.Element
+export function StatusBacklog(props?: FCCIconProps): JSX.Element
+export function StatusCancelled(props?: FCCIconProps): JSX.Element
+export function PriorityUrgent(props?: FCCIconProps): JSX.Element
+export function PriorityHigh(props?: FCCIconProps): JSX.Element
+export function PriorityMedium(props?: FCCIconProps): JSX.Element
+export function PriorityLow(props?: FCCIconProps): JSX.Element
+export function LinkIcon(props?: FCCIconProps): JSX.Element
+export function TrashIcon(props?: FCCIconProps): JSX.Element
+export function SettingsIcon(props?: FCCIconProps): JSX.Element
+export function CloseIcon(props?: FCCIconProps): JSX.Element
+export function CheckIcon(props?: FCCIconProps): JSX.Element
+export function CopyIcon(props?: FCCIconProps): JSX.Element
+export function BellIcon(props?: FCCIconProps): JSX.Element
+export function CalendarIcon(props?: FCCIconProps): JSX.Element
+export function FilterIcon(props?: FCCIconProps): JSX.Element
+export function UserIcon(props?: FCCIconProps): JSX.Element
+export function LabelIcon(props?: FCCIconProps): JSX.Element

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@freedom-code-compliance/fcc-redesign",
   "private": false,
-  "version": "0.1.50",
+  "version": "0.1.52",
   "description": "Reusable FCC design system components and theme for fccPRO and fccOPS.",
   "type": "module",
   "repository": {
@@ -14,8 +14,10 @@
   },
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
+  "types": "./index.d.ts",
   "exports": {
     ".": {
+      "types": "./index.d.ts",
       "import": "./dist/index.js",
       "require": "./dist/index.cjs"
     },
@@ -27,6 +29,7 @@
   },
   "files": [
     "dist",
+    "index.d.ts",
     "README.md"
   ],
   "sideEffects": [