@flytedan/flytebot-design-system 0.58.0 → 0.60.0

package/dist/index.d.cts

@@ -759,15 +759,19 @@ declare function FlytedeskBrand({ appName, size, className, ...rest }: Flytedesk
  */
 declare function installFlytedeskFavicon(url: string): void;
 
+interface TabItem {
+    value: string;
+    label: string;
+    count?: number;
+    /** `attention` colours the count as work that is waiting. Without it the count is neutral. */
+    tone?: "attention";
+}
 /**
  * Places within one screen. Underline only — no pill tabs in the product.
+ * Tabs that do not fit scroll sideways, fading the edge that has more, with the active tab kept in view.
  */
 interface TabsProps {
-    tabs: Array<string | {
-        value: string;
-        label: string;
-        count?: number;
-    }>;
+    tabs: Array<string | TabItem>;
     value?: string;
     onChange?: (value: string) => void;
     className?: string;
@@ -1168,10 +1172,14 @@ interface CsiHeroProps {
 }
 declare function CsiHero({ band, crp, label, className }: CsiHeroProps): React.JSX.Element;
 
+/** What a column becomes when the table is narrow (640px or less), where each row is a compact card instead of a table row:
+ *  `primary` is on the card's title line, `secondary` in its muted meta line (labelled with the
+ *  column's label), `hidden` is left out. */
+type DataTablePhoneRole = "primary" | "secondary" | "hidden";
 /**
  * The product's dense read surface. Sticky overline header, hairline rows, no zebra,
  * numbers right-aligned and tabular. Renders its own skeleton rows so the table
- * never collapses while data is in flight.
+ * never collapses while data is in flight. At 640px wide or less (its own width, not the window's) each row becomes a compact card.
  */
 interface DataTableColumn {
     key: string;
@@ -1181,6 +1189,8 @@ interface DataTableColumn {
     /** Set widths explicitly; auto layout shifts as data arrives. */
     width?: string;
     sortable?: boolean;
+    /** The column's role in the stacked-card layout, at a table width of 640px or less. At least one column must be `primary`. */
+    phone: DataTablePhoneRole;
     render?: (row: any) => React.ReactNode;
 }
 interface DataTableProps {
@@ -2325,6 +2335,24 @@ interface TransferListProps<T> {
  */
 declare function TransferList<T>({ left, right, keyOf, renderRow, onMove, itemHeight, rowGap, listHeight, className, }: TransferListProps<T>): React.JSX.Element;
 
+interface Fact {
+    /** What the fact is. Also its identity, so labels are unique within a list. */
+    label: string;
+    /** Any node: text, a badge, a link. */
+    value: React.ReactNode;
+}
+interface FactListProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "children"> {
+    facts: Fact[];
+    className?: string;
+}
+/**
+ * Label/value pairs as a compact grid: 2 to 4 columns as the list's own width allows, one column
+ * when it is narrow (a phone). Where CardRow stacks one pair per line, a summary of a handful of
+ * facts reads at a glance instead of filling the screen. The columns follow the width of the
+ * container it is placed in, not the viewport, so it holds in a narrow card on a wide screen too.
+ */
+declare function FactList({ facts, className, ...rest }: FactListProps): React.JSX.Element;
+
 /**
  * Multi-select control with a 44px comfortable hit area.
  */
@@ -3032,6 +3060,24 @@ interface AppSwitcherProps {
  */
 declare function AppSwitcher({ apps: appsProp, onNavigate, className }: AppSwitcherProps): React.JSX.Element | null;
 
+interface AppearanceMenuProps {
+    className?: string;
+}
+/**
+ * The appearance popover every flytedesk app puts in its topbar: theme, text size, high
+ * contrast, and a reduced-motion override on top of the OS's own `prefers-reduced-
+ * motion`. Fits `Topbar`'s `actions`/`overflowActions` slot (see Topbar.tsx) the same
+ * way `AccountMenu` does — an `IconButton` trigger anchoring a `Popover`.
+ *
+ * It only reads and writes the nearest `AppearanceProvider`'s store (persistence is that
+ * store's concern, see kits/appearance.ts); applying the prefs to `document.documentElement`
+ * is the provider's job, so it holds at every width whether or not this menu is mounted.
+ * Every visual effect is a CSS rule in this package's own styles (tokens.css) driven by
+ * the `[data-theme]`/`[data-text-scale]`/`[data-contrast]`/`[data-motion]` attributes
+ * the provider sets — no inline styles, no app-side CSS.
+ */
+declare function AppearanceMenu({ className }: AppearanceMenuProps): React.JSX.Element;
+
 type ThemeMode = "light" | "dark" | "system";
 type TextScale = "sm" | "md" | "lg" | "xl";
 interface AppearancePrefs {
@@ -3098,35 +3144,56 @@ declare function createLocalStorageAppearanceStore(opts?: AppearanceStoreOptions
  *  `[data-motion="reduce"]` (same absent-is-off shape). No inline styles: every visual
  *  effect is a CSS rule in this package's own styles, driven by these attributes alone. */
 declare function applyPrefs(prefs: AppearancePrefs, root?: HTMLElement): void;
+/** Applies `store`'s current snapshot to `root` — one synchronous, idempotent call. Run it
+ *  once BEFORE the app's first React render (`main.tsx`) so a saved theme/text size/contrast
+ *  paints from the very first frame, with no flash of the defaults while the bundle boots and
+ *  the app mounts. It is the same application `watchAppearance` does on mount, so the two never
+ *  disagree. */
+declare function applyAppearance(store: AppearanceStore, root?: HTMLElement): void;
+/** Keeps `root`'s appearance attributes equal to `store`'s snapshot for as long as it runs:
+ *  applies the current value now, re-applies on every change the store reports (a menu write,
+ *  another tab's `storage` event, an app's async server hydration) and, while the theme is
+ *  "system", when the OS's own light/dark setting flips. Returns its stop function.
+ *
+ *  This is the ONE place appearance reaches the DOM, and it is independent of every piece of UI:
+ *  `AppearanceProvider` runs it for the app's lifetime, so a saved Appearance applies at every
+ *  width whether or not `AppearanceMenu` is mounted (Topbar collapses it into a "More actions"
+ *  menu on a phone, where it isn't mounted until opened — SMS-96). */
+declare function watchAppearance(store: AppearanceStore, root?: HTMLElement): () => void;
 /** [prefs, update] over an app-supplied `AppearanceStore`. Reads through
  *  `React.useSyncExternalStore`, so a snapshot that changes for ANY reason — this hook's
  *  own `update`, another tab, or an app's async server hydration landing after mount —
- *  re-renders with the new value and re-applies it to the DOM. Any number of independent
- *  instances may run at once as long as each is given its own store (or its own
- *  `storageKey`, for the default store) — nothing here is a module-level singleton. */
+ *  re-renders with the new value. It does NOT touch the DOM: applying appearance is the
+ *  app-wide `AppearanceProvider`'s job (`watchAppearance`), never a hook a menu happens to
+ *  mount. Nothing here is a module-level singleton. */
 declare function useAppearancePrefs(store: AppearanceStore): [AppearancePrefs, (patch: Partial<AppearancePrefs>) => void];
 
-interface AppearanceMenuProps extends AppearanceStoreOptions {
-    /** An app-supplied external store (read/write/subscribe) — e.g. an adapter over a
-     *  server-synced prefs cache, so a value that arrives after mount still reaches this
-     *  menu and the DOM. Omit to get the default localStorage-backed store, configured by
-     *  `storageKey`/`storage`/`defaults`. */
-    store?: AppearanceStore;
-    className?: string;
+interface AppearanceProviderProps {
+    /** The app's one `AppearanceStore` — `createLocalStorageAppearanceStore({ storageKey })`
+     *  for an app with no server-side prefs, or its own adapter over server-synced state. Create
+     *  it ONCE, outside React (a module constant): the provider, `AppearanceMenu` and the
+     *  pre-render `applyAppearance(store)` call in `main.tsx` all share this one instance. */
+    store: AppearanceStore;
+    children: React.ReactNode;
 }
 /**
- * The appearance popover every flytedesk app puts in its topbar: theme, text size, high
- * contrast, and a reduced-motion override on top of the OS's own `prefers-reduced-
- * motion`. Fits `Topbar`'s `actions`/`overflowActions` slot (see Topbar.tsx) the same
- * way `AccountMenu` does — an `IconButton` trigger anchoring a `Popover`.
+ * Owns applying the app's saved Appearance (theme, text size, contrast, reduced motion) to
+ * `document.documentElement` for the whole life of the app, and shares its store with
+ * `AppearanceMenu`. Mount it once, at the app root — above the session boundary, so the
+ * sign-in and loading screens carry the saved Appearance too.
  *
- * Persistence is caller-configurable (`storageKey`/`storage`, see kits/appearance.ts) —
- * pass a `storageKey` to namespace it per app; nothing here is a shared/global key.
- * Every visual effect is a CSS rule in this package's own styles (tokens.css) driven by
- * the `[data-theme]`/`[data-text-scale]`/`[data-contrast]`/`[data-motion]` attributes
- * this component sets on `document.documentElement` — no inline styles, no app-side CSS.
+ * Applying is deliberately NOT the menu's job: Topbar collapses the menu into a "More actions"
+ * overflow that isn't mounted until it's opened (640px and narrower by default), so a menu that
+ * applied prefs would leave a saved dark theme unapplied after a reload on a phone (SMS-96).
+ * Here a menu write, another tab's `storage` event and an app's async server hydration all
+ * re-apply at every width. The first application runs in a layout effect, before the browser's
+ * first paint of the app; call `applyAppearance(store)` before `createRoot(...).render(...)` to
+ * also cover the time before React mounts.
  */
-declare function AppearanceMenu({ className, store: storeProp, storageKey, storage, defaults }: AppearanceMenuProps): React.JSX.Element;
+declare function AppearanceProvider({ store, children }: AppearanceProviderProps): React.JSX.Element;
+/** The store of the nearest `AppearanceProvider`. Throws without one: an `AppearanceMenu`
+ *  mounted outside a provider would write prefs nothing ever applies. */
+declare function useAppearanceStore(): AppearanceStore;
 
 interface EndpointSpec {
     id: string;
@@ -5084,4 +5151,4 @@ declare function CornerStackPortal({ slot, children }: {
     children?: React.ReactNode;
 }): React.ReactPortal | null;
 
-export { AccountMenu, type AccountMenuLink, type AccountMenuProps, AgentChatPanel, type AgentChatPanelProps, AnchoredPopover, type AnchoredPopoverProps, AnimNum, type AnimNumProps, ApiSpecBrowser, type ApiSpecBrowserProps, type AppEntry, AppShell, type AppShellProps, AppSwitcher, type AppSwitcherProps, AppearanceMenu, type AppearanceMenuProps, type AppearancePrefs, type AppearanceStore, type AppearanceStoreOptions, type Attachment, Avatar, type AvatarProps, AvatarStack, type AvatarStackProps, Badge, type BadgeProps, Banner, type BannerProps, type BannerTone, BarList, type BarListProps, type BarListRow, BudgetReallocator, type BudgetReallocatorProps, Button, type ButtonProps, CHANNELS, CHANNEL_WEIGHTS, CHAT_UNAVAILABLE, COPIED_FEEDBACK_MS, CORNER_STACK_INSET_PROPERTY, Calendar, type CalendarProps, Card, CardGrid, type CardGridProps, type CardProps, CardRow, type CardRowProps, ChannelContribution, type ChannelContributionChannel, type ChannelContributionProps, ChannelMeta, type ChannelMetaRecord, ChannelTag, type ChannelTagProps, ChannelWeightOf, type ChatAdapter, ChatComposer, type ChatComposerProps, type ChatEngine, type ChatEngineOptions, ChatKit, type ChatMessage, type ChatRenderContext, ChatSessionBar, type ChatSessionBarProps, ChatTranscript, type ChatTranscriptProps, ChatTurn, type ChatTurnProps, Checkbox, type CheckboxProps, type Citation, Citations, type CitationsProps, Clamp, type ClampProps, ClockFace, type ClockFaceProps, CodeBlock, type CodeBlockProps, CodeEditor, type CodeEditorDiagnostic, type CodeEditorProps, Collapsible, type CollapsibleProps, ComingSoon, type ComingSoonProps, type ContextUsage, CornerStackPortal, type CornerStackSlot, type CreateVersionStoreOptions, CsiBadge, type CsiBadgeProps, CsiHero, type CsiHeroProps, CsiMeter, type CsiMeterProps, DEFAULT_PREFS, DEFAULT_STORAGE_KEY, DEFAULT_TOAST_DURATION_MS, DataTable, type DataTableColumn, type DataTableProps, DatePicker, type DatePickerProps, type DemoSessionControls, DemoSessionProvider, type DeviceSession, DiffBlock, type DiffBlockProps, DonutChart, type DonutChartProps, type DonutSegment, Drawer, type DrawerProps, Dropzone, DropzoneKit, type DropzoneProps, ENTITY_ROW_METRIC_WIDTH, type EditorTrigger, EmptyState, type EmptyStateProps, type EndpointSpec, EntityRow, type EntityRowAction, type EntityRowContent, type EntityRowMetric, EntityRowMetrics, type EntityRowMetricsProps, type EntityRowProps, FILE_VIEWER_CSV_ROW_LIMIT, FILE_VIEWER_TEXT_LIMIT, FeatureGate, type FeatureGateProps, type FeatureStatus, FileBrowser, type FileBrowserFile, type FileBrowserFolder, type FileBrowserPermissions, type FileBrowserProps, FileChip, type FileChipProps, FileGrid, type FileGridProps, FileKit, FilePickButton, type FilePickButtonProps, type FileRejection, FileStrip, type FileStripProps, FileTile, type FileTileProps, type FileUploadHandler, FileViewer, type FileViewerProps, FilterBar, type FilterBarProps, type FilterDateValue, type FilterField, type FilterFieldDate, type FilterFieldMultiSelect, type FilterFieldOption, type FilterFieldRange, type FilterFieldSelect, type FilterFieldText, type FilterMultiSelectValue, type FilterOperator, type FilterRangeValue, type FilterResolveMatch, type FilterResolveResult, type FilterValidation, type FilterValue, Flag$1 as Flag, type FlagExplanation, type FlagProps, FlytedeskBrand, type FlytedeskBrandProps, FlytedeskMark, type FlytedeskMarkProps, FormatEta, FunnelChart, type FunnelChartProps, type FunnelStep, Gate, GatePending, type GatePendingProps, type GateProps, IMPORTANCE_LEVELS, IconButton, type IconButtonProps, type ImportanceLevel, type ImportanceLevelId, ImportanceTag, type ImportanceTagProps, type ImportanceTokens, Input, type InputProps, type Job, type JobAction, type JobCardStatus, type JobStatus, JobTray, type JobTrayProps, Json, KeyHint, type KeyHintProps, LAYER_STEP, type ListEnvelope, LoadingRegion, type LoadingRegionProps, Markdown, MarkdownEditor, type MarkdownEditorHandle, type MarkdownEditorProps, MarkdownInline, type MarkdownProps, type MentionSource, Menu, MenuButton, type MenuButtonProps, type MenuItem, type MenuProps, MessageBody, type MessageBodyProps, type MessageGroup, Meter, type MeterProps, type MeterSegment, type MeterSegmentInput, MixGap, type MixGapProps, type MixGapRow, MockJobKit, type MockJobStatus, Modal, type ModalProps, ModeSwitch, type ModeSwitchProps, type Model, ModelControls, type ModelControlsProps, NumberInput, type NumberInputProps, OVERLAY_CEILING, POPOVER_BODY_MIN, type Packet, PacketCard, type PacketCardProps, type PacketSchema, type Pager, Pagination, type PaginationProps, PermissionDenied, type PermissionDeniedProps, type PermissionGroup, PermissionHint, type PermissionItem, type Phase, type PhaseStatus, PhasedProgress, type PhasedProgressProps, type Placement, type PollOptions, Popover, type PopoverProps, type PreferenceCriterion, PreferenceMeter, type PreferenceMeterProps, type ProfileFieldDef, type ProfileFieldType, type ProfileNotificationDef, ProfilePage, type ProfilePageProps, ProgressBar, type ProgressBarProps, QueryKit, type QueuedTurn, QuotaRow, type QuotaRowProps, ROOT_STEP, Radio, type RadioProps, RangeSlider, type RangeSliderProps, RelativeTime, type RelativeTimeProps, type RoadmapItem, type RoadmapResult, RoadmapTimeline, type RoadmapTimelineProps, type Role, RunActions, type RunActionsProps, type RunConfig, RuntimeKit, type RuntimeSummary, SaturationDistribution, type SaturationDistributionCampus, type SaturationDistributionProps, ScoreMeter, type ScoreMeterProps, ScreenHead, type ScreenHeadProps, SearchField, type SearchFieldProps, SegmentedControl, type SegmentedControlProps, SegmentedMeter, type SegmentedMeterProps, Select, type SelectOption, type SelectProps, type SendMessageResult, type ServerTable, type Session, type SessionContextValue, type Flag as SessionFlag, SessionKit, SessionProvider, type SessionProviderProps, type SessionRole, SessionScreen, type SessionScreenKind, type SessionScreenProps, type SessionStats, type SessionUser, SidebarNav, type SidebarNavItem, type SidebarNavProps, Skeleton, type SkeletonProps, SkeletonText, type SkeletonTextProps, type SlashCommand, Slider, type SliderProps, type SortDirection, type SortEntry, SortMenu, type SortMenuField, type SortMenuProps, type SpecModule, Spinner, type SpinnerProps, type StackedLayer, type StackedLayerOptions, StackedLayerProvider, StatTile, type StatTileProps, type Step, StepList, type StepListProps, type StreamHandlers, type Suggestion, SurroundSound, type SurroundSoundProps, Switch, type SwitchProps, type TableQuery, Tabs, type TabsProps, Tag, type TagProps, TestModeBar, type TestModeBarProps, type TextScale, Textarea, type TextareaProps, type ThemeMode, ThinkingBlock, type ThinkingBlockProps, type ThreadSummary, TimePicker, type TimePickerProps, Toast, type ToastApi, type ToastOptions, type ToastProps, ToastProvider, Tooltip, type TooltipProps, Topbar, type TopbarProps, TranscriptKit, TransferList, type TransferListProps, type TransferListSide, type TransferListSideProps, TrendChart, type TrendChartProps, type TrendSeries, type UsageLimit, UseFeatureStatus, type UseResponsiveRailOptions, type UseResponsiveRailResult, UseRuntimeMode, type UseServerTableOptions, type User, VIRTUAL_LIST_BUFFER_ROWS, VIRTUAL_LIST_ROW_GAP, type VersionRecord, type VersionStore, VirtualList, type VirtualListProps, type VirtualLoadedBand, type VirtualWindow, type VoiceHandler, __resetLayerStackForTests, acceptMatches, anyOfFilter, applyPrefs, channelWeightOf, computeNeedMore, computeVirtualWindow, copyToClipboard, createLocalStorageAppearanceStore, createVersionStore, eqFilter, extensionOf, extractClipboardFiles, filterFiles, formatAbsolute, formatBytes, formatClock, formatDocumentTitle, formatDuration, formatEta, formatRelative, groupMessages, hasModifier, iconForMime, importanceLevel, importanceTokens, installFlytedeskFavicon, isImage, isSystemMessage, isWithinLayerTree, jobBucket, languageLabel, loadPrefs, markdownToText, meterFormats, modifierLabel, parseDelimited, pastedTextName, pluralizeUnit, preferenceScore, preferenceSegments, rangeFilter, resolveTheme, revokeAttachment, savePrefs, toAttachment, tokenize, useAppearancePrefs, useChatEngine, useCopyToClipboard, useCornerStackSlot, useDocumentTitle, useFeatureStatus, useLayerZIndex, usePopoverPosition, useResponsiveRail, useRuntimeMode, useServerTable, useSessionContext, useStackedLayer, useStagedFiles, useToast, validateFilterValue, visibleMessages };
+export { AccountMenu, type AccountMenuLink, type AccountMenuProps, AgentChatPanel, type AgentChatPanelProps, AnchoredPopover, type AnchoredPopoverProps, AnimNum, type AnimNumProps, ApiSpecBrowser, type ApiSpecBrowserProps, type AppEntry, AppShell, type AppShellProps, AppSwitcher, type AppSwitcherProps, AppearanceMenu, type AppearanceMenuProps, type AppearancePrefs, AppearanceProvider, type AppearanceProviderProps, type AppearanceStore, type AppearanceStoreOptions, type Attachment, Avatar, type AvatarProps, AvatarStack, type AvatarStackProps, Badge, type BadgeProps, Banner, type BannerProps, type BannerTone, BarList, type BarListProps, type BarListRow, BudgetReallocator, type BudgetReallocatorProps, Button, type ButtonProps, CHANNELS, CHANNEL_WEIGHTS, CHAT_UNAVAILABLE, COPIED_FEEDBACK_MS, CORNER_STACK_INSET_PROPERTY, Calendar, type CalendarProps, Card, CardGrid, type CardGridProps, type CardProps, CardRow, type CardRowProps, ChannelContribution, type ChannelContributionChannel, type ChannelContributionProps, ChannelMeta, type ChannelMetaRecord, ChannelTag, type ChannelTagProps, ChannelWeightOf, type ChatAdapter, ChatComposer, type ChatComposerProps, type ChatEngine, type ChatEngineOptions, ChatKit, type ChatMessage, type ChatRenderContext, ChatSessionBar, type ChatSessionBarProps, ChatTranscript, type ChatTranscriptProps, ChatTurn, type ChatTurnProps, Checkbox, type CheckboxProps, type Citation, Citations, type CitationsProps, Clamp, type ClampProps, ClockFace, type ClockFaceProps, CodeBlock, type CodeBlockProps, CodeEditor, type CodeEditorDiagnostic, type CodeEditorProps, Collapsible, type CollapsibleProps, ComingSoon, type ComingSoonProps, type ContextUsage, CornerStackPortal, type CornerStackSlot, type CreateVersionStoreOptions, CsiBadge, type CsiBadgeProps, CsiHero, type CsiHeroProps, CsiMeter, type CsiMeterProps, DEFAULT_PREFS, DEFAULT_STORAGE_KEY, DEFAULT_TOAST_DURATION_MS, DataTable, type DataTableColumn, type DataTablePhoneRole, type DataTableProps, DatePicker, type DatePickerProps, type DemoSessionControls, DemoSessionProvider, type DeviceSession, DiffBlock, type DiffBlockProps, DonutChart, type DonutChartProps, type DonutSegment, Drawer, type DrawerProps, Dropzone, DropzoneKit, type DropzoneProps, ENTITY_ROW_METRIC_WIDTH, type EditorTrigger, EmptyState, type EmptyStateProps, type EndpointSpec, EntityRow, type EntityRowAction, type EntityRowContent, type EntityRowMetric, EntityRowMetrics, type EntityRowMetricsProps, type EntityRowProps, FILE_VIEWER_CSV_ROW_LIMIT, FILE_VIEWER_TEXT_LIMIT, type Fact, FactList, type FactListProps, FeatureGate, type FeatureGateProps, type FeatureStatus, FileBrowser, type FileBrowserFile, type FileBrowserFolder, type FileBrowserPermissions, type FileBrowserProps, FileChip, type FileChipProps, FileGrid, type FileGridProps, FileKit, FilePickButton, type FilePickButtonProps, type FileRejection, FileStrip, type FileStripProps, FileTile, type FileTileProps, type FileUploadHandler, FileViewer, type FileViewerProps, FilterBar, type FilterBarProps, type FilterDateValue, type FilterField, type FilterFieldDate, type FilterFieldMultiSelect, type FilterFieldOption, type FilterFieldRange, type FilterFieldSelect, type FilterFieldText, type FilterMultiSelectValue, type FilterOperator, type FilterRangeValue, type FilterResolveMatch, type FilterResolveResult, type FilterValidation, type FilterValue, Flag$1 as Flag, type FlagExplanation, type FlagProps, FlytedeskBrand, type FlytedeskBrandProps, FlytedeskMark, type FlytedeskMarkProps, FormatEta, FunnelChart, type FunnelChartProps, type FunnelStep, Gate, GatePending, type GatePendingProps, type GateProps, IMPORTANCE_LEVELS, IconButton, type IconButtonProps, type ImportanceLevel, type ImportanceLevelId, ImportanceTag, type ImportanceTagProps, type ImportanceTokens, Input, type InputProps, type Job, type JobAction, type JobCardStatus, type JobStatus, JobTray, type JobTrayProps, Json, KeyHint, type KeyHintProps, LAYER_STEP, type ListEnvelope, LoadingRegion, type LoadingRegionProps, Markdown, MarkdownEditor, type MarkdownEditorHandle, type MarkdownEditorProps, MarkdownInline, type MarkdownProps, type MentionSource, Menu, MenuButton, type MenuButtonProps, type MenuItem, type MenuProps, MessageBody, type MessageBodyProps, type MessageGroup, Meter, type MeterProps, type MeterSegment, type MeterSegmentInput, MixGap, type MixGapProps, type MixGapRow, MockJobKit, type MockJobStatus, Modal, type ModalProps, ModeSwitch, type ModeSwitchProps, type Model, ModelControls, type ModelControlsProps, NumberInput, type NumberInputProps, OVERLAY_CEILING, POPOVER_BODY_MIN, type Packet, PacketCard, type PacketCardProps, type PacketSchema, type Pager, Pagination, type PaginationProps, PermissionDenied, type PermissionDeniedProps, type PermissionGroup, PermissionHint, type PermissionItem, type Phase, type PhaseStatus, PhasedProgress, type PhasedProgressProps, type Placement, type PollOptions, Popover, type PopoverProps, type PreferenceCriterion, PreferenceMeter, type PreferenceMeterProps, type ProfileFieldDef, type ProfileFieldType, type ProfileNotificationDef, ProfilePage, type ProfilePageProps, ProgressBar, type ProgressBarProps, QueryKit, type QueuedTurn, QuotaRow, type QuotaRowProps, ROOT_STEP, Radio, type RadioProps, RangeSlider, type RangeSliderProps, RelativeTime, type RelativeTimeProps, type RoadmapItem, type RoadmapResult, RoadmapTimeline, type RoadmapTimelineProps, type Role, RunActions, type RunActionsProps, type RunConfig, RuntimeKit, type RuntimeSummary, SaturationDistribution, type SaturationDistributionCampus, type SaturationDistributionProps, ScoreMeter, type ScoreMeterProps, ScreenHead, type ScreenHeadProps, SearchField, type SearchFieldProps, SegmentedControl, type SegmentedControlProps, SegmentedMeter, type SegmentedMeterProps, Select, type SelectOption, type SelectProps, type SendMessageResult, type ServerTable, type Session, type SessionContextValue, type Flag as SessionFlag, SessionKit, SessionProvider, type SessionProviderProps, type SessionRole, SessionScreen, type SessionScreenKind, type SessionScreenProps, type SessionStats, type SessionUser, SidebarNav, type SidebarNavItem, type SidebarNavProps, Skeleton, type SkeletonProps, SkeletonText, type SkeletonTextProps, type SlashCommand, Slider, type SliderProps, type SortDirection, type SortEntry, SortMenu, type SortMenuField, type SortMenuProps, type SpecModule, Spinner, type SpinnerProps, type StackedLayer, type StackedLayerOptions, StackedLayerProvider, StatTile, type StatTileProps, type Step, StepList, type StepListProps, type StreamHandlers, type Suggestion, SurroundSound, type SurroundSoundProps, Switch, type SwitchProps, type TabItem, type TableQuery, Tabs, type TabsProps, Tag, type TagProps, TestModeBar, type TestModeBarProps, type TextScale, Textarea, type TextareaProps, type ThemeMode, ThinkingBlock, type ThinkingBlockProps, type ThreadSummary, TimePicker, type TimePickerProps, Toast, type ToastApi, type ToastOptions, type ToastProps, ToastProvider, Tooltip, type TooltipProps, Topbar, type TopbarProps, TranscriptKit, TransferList, type TransferListProps, type TransferListSide, type TransferListSideProps, TrendChart, type TrendChartProps, type TrendSeries, type UsageLimit, UseFeatureStatus, type UseResponsiveRailOptions, type UseResponsiveRailResult, UseRuntimeMode, type UseServerTableOptions, type User, VIRTUAL_LIST_BUFFER_ROWS, VIRTUAL_LIST_ROW_GAP, type VersionRecord, type VersionStore, VirtualList, type VirtualListProps, type VirtualLoadedBand, type VirtualWindow, type VoiceHandler, __resetLayerStackForTests, acceptMatches, anyOfFilter, applyAppearance, applyPrefs, channelWeightOf, computeNeedMore, computeVirtualWindow, copyToClipboard, createLocalStorageAppearanceStore, createVersionStore, eqFilter, extensionOf, extractClipboardFiles, filterFiles, formatAbsolute, formatBytes, formatClock, formatDocumentTitle, formatDuration, formatEta, formatRelative, groupMessages, hasModifier, iconForMime, importanceLevel, importanceTokens, installFlytedeskFavicon, isImage, isSystemMessage, isWithinLayerTree, jobBucket, languageLabel, loadPrefs, markdownToText, meterFormats, modifierLabel, parseDelimited, pastedTextName, pluralizeUnit, preferenceScore, preferenceSegments, rangeFilter, resolveTheme, revokeAttachment, savePrefs, toAttachment, tokenize, useAppearancePrefs, useAppearanceStore, useChatEngine, useCopyToClipboard, useCornerStackSlot, useDocumentTitle, useFeatureStatus, useLayerZIndex, usePopoverPosition, useResponsiveRail, useRuntimeMode, useServerTable, useSessionContext, useStackedLayer, useStagedFiles, useToast, validateFilterValue, visibleMessages, watchAppearance };

package/dist/index.d.ts

@@ -759,15 +759,19 @@ declare function FlytedeskBrand({ appName, size, className, ...rest }: Flytedesk
  */
 declare function installFlytedeskFavicon(url: string): void;
 
+interface TabItem {
+    value: string;
+    label: string;
+    count?: number;
+    /** `attention` colours the count as work that is waiting. Without it the count is neutral. */
+    tone?: "attention";
+}
 /**
  * Places within one screen. Underline only — no pill tabs in the product.
+ * Tabs that do not fit scroll sideways, fading the edge that has more, with the active tab kept in view.
  */
 interface TabsProps {
-    tabs: Array<string | {
-        value: string;
-        label: string;
-        count?: number;
-    }>;
+    tabs: Array<string | TabItem>;
     value?: string;
     onChange?: (value: string) => void;
     className?: string;
@@ -1168,10 +1172,14 @@ interface CsiHeroProps {
 }
 declare function CsiHero({ band, crp, label, className }: CsiHeroProps): React.JSX.Element;
 
+/** What a column becomes when the table is narrow (640px or less), where each row is a compact card instead of a table row:
+ *  `primary` is on the card's title line, `secondary` in its muted meta line (labelled with the
+ *  column's label), `hidden` is left out. */
+type DataTablePhoneRole = "primary" | "secondary" | "hidden";
 /**
  * The product's dense read surface. Sticky overline header, hairline rows, no zebra,
  * numbers right-aligned and tabular. Renders its own skeleton rows so the table
- * never collapses while data is in flight.
+ * never collapses while data is in flight. At 640px wide or less (its own width, not the window's) each row becomes a compact card.
  */
 interface DataTableColumn {
     key: string;
@@ -1181,6 +1189,8 @@ interface DataTableColumn {
     /** Set widths explicitly; auto layout shifts as data arrives. */
     width?: string;
     sortable?: boolean;
+    /** The column's role in the stacked-card layout, at a table width of 640px or less. At least one column must be `primary`. */
+    phone: DataTablePhoneRole;
     render?: (row: any) => React.ReactNode;
 }
 interface DataTableProps {
@@ -2325,6 +2335,24 @@ interface TransferListProps<T> {
  */
 declare function TransferList<T>({ left, right, keyOf, renderRow, onMove, itemHeight, rowGap, listHeight, className, }: TransferListProps<T>): React.JSX.Element;
 
+interface Fact {
+    /** What the fact is. Also its identity, so labels are unique within a list. */
+    label: string;
+    /** Any node: text, a badge, a link. */
+    value: React.ReactNode;
+}
+interface FactListProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "children"> {
+    facts: Fact[];
+    className?: string;
+}
+/**
+ * Label/value pairs as a compact grid: 2 to 4 columns as the list's own width allows, one column
+ * when it is narrow (a phone). Where CardRow stacks one pair per line, a summary of a handful of
+ * facts reads at a glance instead of filling the screen. The columns follow the width of the
+ * container it is placed in, not the viewport, so it holds in a narrow card on a wide screen too.
+ */
+declare function FactList({ facts, className, ...rest }: FactListProps): React.JSX.Element;
+
 /**
  * Multi-select control with a 44px comfortable hit area.
  */
@@ -3032,6 +3060,24 @@ interface AppSwitcherProps {
  */
 declare function AppSwitcher({ apps: appsProp, onNavigate, className }: AppSwitcherProps): React.JSX.Element | null;
 
+interface AppearanceMenuProps {
+    className?: string;
+}
+/**
+ * The appearance popover every flytedesk app puts in its topbar: theme, text size, high
+ * contrast, and a reduced-motion override on top of the OS's own `prefers-reduced-
+ * motion`. Fits `Topbar`'s `actions`/`overflowActions` slot (see Topbar.tsx) the same
+ * way `AccountMenu` does — an `IconButton` trigger anchoring a `Popover`.
+ *
+ * It only reads and writes the nearest `AppearanceProvider`'s store (persistence is that
+ * store's concern, see kits/appearance.ts); applying the prefs to `document.documentElement`
+ * is the provider's job, so it holds at every width whether or not this menu is mounted.
+ * Every visual effect is a CSS rule in this package's own styles (tokens.css) driven by
+ * the `[data-theme]`/`[data-text-scale]`/`[data-contrast]`/`[data-motion]` attributes
+ * the provider sets — no inline styles, no app-side CSS.
+ */
+declare function AppearanceMenu({ className }: AppearanceMenuProps): React.JSX.Element;
+
 type ThemeMode = "light" | "dark" | "system";
 type TextScale = "sm" | "md" | "lg" | "xl";
 interface AppearancePrefs {
@@ -3098,35 +3144,56 @@ declare function createLocalStorageAppearanceStore(opts?: AppearanceStoreOptions
  *  `[data-motion="reduce"]` (same absent-is-off shape). No inline styles: every visual
  *  effect is a CSS rule in this package's own styles, driven by these attributes alone. */
 declare function applyPrefs(prefs: AppearancePrefs, root?: HTMLElement): void;
+/** Applies `store`'s current snapshot to `root` — one synchronous, idempotent call. Run it
+ *  once BEFORE the app's first React render (`main.tsx`) so a saved theme/text size/contrast
+ *  paints from the very first frame, with no flash of the defaults while the bundle boots and
+ *  the app mounts. It is the same application `watchAppearance` does on mount, so the two never
+ *  disagree. */
+declare function applyAppearance(store: AppearanceStore, root?: HTMLElement): void;
+/** Keeps `root`'s appearance attributes equal to `store`'s snapshot for as long as it runs:
+ *  applies the current value now, re-applies on every change the store reports (a menu write,
+ *  another tab's `storage` event, an app's async server hydration) and, while the theme is
+ *  "system", when the OS's own light/dark setting flips. Returns its stop function.
+ *
+ *  This is the ONE place appearance reaches the DOM, and it is independent of every piece of UI:
+ *  `AppearanceProvider` runs it for the app's lifetime, so a saved Appearance applies at every
+ *  width whether or not `AppearanceMenu` is mounted (Topbar collapses it into a "More actions"
+ *  menu on a phone, where it isn't mounted until opened — SMS-96). */
+declare function watchAppearance(store: AppearanceStore, root?: HTMLElement): () => void;
 /** [prefs, update] over an app-supplied `AppearanceStore`. Reads through
  *  `React.useSyncExternalStore`, so a snapshot that changes for ANY reason — this hook's
  *  own `update`, another tab, or an app's async server hydration landing after mount —
- *  re-renders with the new value and re-applies it to the DOM. Any number of independent
- *  instances may run at once as long as each is given its own store (or its own
- *  `storageKey`, for the default store) — nothing here is a module-level singleton. */
+ *  re-renders with the new value. It does NOT touch the DOM: applying appearance is the
+ *  app-wide `AppearanceProvider`'s job (`watchAppearance`), never a hook a menu happens to
+ *  mount. Nothing here is a module-level singleton. */
 declare function useAppearancePrefs(store: AppearanceStore): [AppearancePrefs, (patch: Partial<AppearancePrefs>) => void];
 
-interface AppearanceMenuProps extends AppearanceStoreOptions {
-    /** An app-supplied external store (read/write/subscribe) — e.g. an adapter over a
-     *  server-synced prefs cache, so a value that arrives after mount still reaches this
-     *  menu and the DOM. Omit to get the default localStorage-backed store, configured by
-     *  `storageKey`/`storage`/`defaults`. */
-    store?: AppearanceStore;
-    className?: string;
+interface AppearanceProviderProps {
+    /** The app's one `AppearanceStore` — `createLocalStorageAppearanceStore({ storageKey })`
+     *  for an app with no server-side prefs, or its own adapter over server-synced state. Create
+     *  it ONCE, outside React (a module constant): the provider, `AppearanceMenu` and the
+     *  pre-render `applyAppearance(store)` call in `main.tsx` all share this one instance. */
+    store: AppearanceStore;
+    children: React.ReactNode;
 }
 /**
- * The appearance popover every flytedesk app puts in its topbar: theme, text size, high
- * contrast, and a reduced-motion override on top of the OS's own `prefers-reduced-
- * motion`. Fits `Topbar`'s `actions`/`overflowActions` slot (see Topbar.tsx) the same
- * way `AccountMenu` does — an `IconButton` trigger anchoring a `Popover`.
+ * Owns applying the app's saved Appearance (theme, text size, contrast, reduced motion) to
+ * `document.documentElement` for the whole life of the app, and shares its store with
+ * `AppearanceMenu`. Mount it once, at the app root — above the session boundary, so the
+ * sign-in and loading screens carry the saved Appearance too.
  *
- * Persistence is caller-configurable (`storageKey`/`storage`, see kits/appearance.ts) —
- * pass a `storageKey` to namespace it per app; nothing here is a shared/global key.
- * Every visual effect is a CSS rule in this package's own styles (tokens.css) driven by
- * the `[data-theme]`/`[data-text-scale]`/`[data-contrast]`/`[data-motion]` attributes
- * this component sets on `document.documentElement` — no inline styles, no app-side CSS.
+ * Applying is deliberately NOT the menu's job: Topbar collapses the menu into a "More actions"
+ * overflow that isn't mounted until it's opened (640px and narrower by default), so a menu that
+ * applied prefs would leave a saved dark theme unapplied after a reload on a phone (SMS-96).
+ * Here a menu write, another tab's `storage` event and an app's async server hydration all
+ * re-apply at every width. The first application runs in a layout effect, before the browser's
+ * first paint of the app; call `applyAppearance(store)` before `createRoot(...).render(...)` to
+ * also cover the time before React mounts.
  */
-declare function AppearanceMenu({ className, store: storeProp, storageKey, storage, defaults }: AppearanceMenuProps): React.JSX.Element;
+declare function AppearanceProvider({ store, children }: AppearanceProviderProps): React.JSX.Element;
+/** The store of the nearest `AppearanceProvider`. Throws without one: an `AppearanceMenu`
+ *  mounted outside a provider would write prefs nothing ever applies. */
+declare function useAppearanceStore(): AppearanceStore;
 
 interface EndpointSpec {
     id: string;
@@ -5084,4 +5151,4 @@ declare function CornerStackPortal({ slot, children }: {
     children?: React.ReactNode;
 }): React.ReactPortal | null;
 
-export { AccountMenu, type AccountMenuLink, type AccountMenuProps, AgentChatPanel, type AgentChatPanelProps, AnchoredPopover, type AnchoredPopoverProps, AnimNum, type AnimNumProps, ApiSpecBrowser, type ApiSpecBrowserProps, type AppEntry, AppShell, type AppShellProps, AppSwitcher, type AppSwitcherProps, AppearanceMenu, type AppearanceMenuProps, type AppearancePrefs, type AppearanceStore, type AppearanceStoreOptions, type Attachment, Avatar, type AvatarProps, AvatarStack, type AvatarStackProps, Badge, type BadgeProps, Banner, type BannerProps, type BannerTone, BarList, type BarListProps, type BarListRow, BudgetReallocator, type BudgetReallocatorProps, Button, type ButtonProps, CHANNELS, CHANNEL_WEIGHTS, CHAT_UNAVAILABLE, COPIED_FEEDBACK_MS, CORNER_STACK_INSET_PROPERTY, Calendar, type CalendarProps, Card, CardGrid, type CardGridProps, type CardProps, CardRow, type CardRowProps, ChannelContribution, type ChannelContributionChannel, type ChannelContributionProps, ChannelMeta, type ChannelMetaRecord, ChannelTag, type ChannelTagProps, ChannelWeightOf, type ChatAdapter, ChatComposer, type ChatComposerProps, type ChatEngine, type ChatEngineOptions, ChatKit, type ChatMessage, type ChatRenderContext, ChatSessionBar, type ChatSessionBarProps, ChatTranscript, type ChatTranscriptProps, ChatTurn, type ChatTurnProps, Checkbox, type CheckboxProps, type Citation, Citations, type CitationsProps, Clamp, type ClampProps, ClockFace, type ClockFaceProps, CodeBlock, type CodeBlockProps, CodeEditor, type CodeEditorDiagnostic, type CodeEditorProps, Collapsible, type CollapsibleProps, ComingSoon, type ComingSoonProps, type ContextUsage, CornerStackPortal, type CornerStackSlot, type CreateVersionStoreOptions, CsiBadge, type CsiBadgeProps, CsiHero, type CsiHeroProps, CsiMeter, type CsiMeterProps, DEFAULT_PREFS, DEFAULT_STORAGE_KEY, DEFAULT_TOAST_DURATION_MS, DataTable, type DataTableColumn, type DataTableProps, DatePicker, type DatePickerProps, type DemoSessionControls, DemoSessionProvider, type DeviceSession, DiffBlock, type DiffBlockProps, DonutChart, type DonutChartProps, type DonutSegment, Drawer, type DrawerProps, Dropzone, DropzoneKit, type DropzoneProps, ENTITY_ROW_METRIC_WIDTH, type EditorTrigger, EmptyState, type EmptyStateProps, type EndpointSpec, EntityRow, type EntityRowAction, type EntityRowContent, type EntityRowMetric, EntityRowMetrics, type EntityRowMetricsProps, type EntityRowProps, FILE_VIEWER_CSV_ROW_LIMIT, FILE_VIEWER_TEXT_LIMIT, FeatureGate, type FeatureGateProps, type FeatureStatus, FileBrowser, type FileBrowserFile, type FileBrowserFolder, type FileBrowserPermissions, type FileBrowserProps, FileChip, type FileChipProps, FileGrid, type FileGridProps, FileKit, FilePickButton, type FilePickButtonProps, type FileRejection, FileStrip, type FileStripProps, FileTile, type FileTileProps, type FileUploadHandler, FileViewer, type FileViewerProps, FilterBar, type FilterBarProps, type FilterDateValue, type FilterField, type FilterFieldDate, type FilterFieldMultiSelect, type FilterFieldOption, type FilterFieldRange, type FilterFieldSelect, type FilterFieldText, type FilterMultiSelectValue, type FilterOperator, type FilterRangeValue, type FilterResolveMatch, type FilterResolveResult, type FilterValidation, type FilterValue, Flag$1 as Flag, type FlagExplanation, type FlagProps, FlytedeskBrand, type FlytedeskBrandProps, FlytedeskMark, type FlytedeskMarkProps, FormatEta, FunnelChart, type FunnelChartProps, type FunnelStep, Gate, GatePending, type GatePendingProps, type GateProps, IMPORTANCE_LEVELS, IconButton, type IconButtonProps, type ImportanceLevel, type ImportanceLevelId, ImportanceTag, type ImportanceTagProps, type ImportanceTokens, Input, type InputProps, type Job, type JobAction, type JobCardStatus, type JobStatus, JobTray, type JobTrayProps, Json, KeyHint, type KeyHintProps, LAYER_STEP, type ListEnvelope, LoadingRegion, type LoadingRegionProps, Markdown, MarkdownEditor, type MarkdownEditorHandle, type MarkdownEditorProps, MarkdownInline, type MarkdownProps, type MentionSource, Menu, MenuButton, type MenuButtonProps, type MenuItem, type MenuProps, MessageBody, type MessageBodyProps, type MessageGroup, Meter, type MeterProps, type MeterSegment, type MeterSegmentInput, MixGap, type MixGapProps, type MixGapRow, MockJobKit, type MockJobStatus, Modal, type ModalProps, ModeSwitch, type ModeSwitchProps, type Model, ModelControls, type ModelControlsProps, NumberInput, type NumberInputProps, OVERLAY_CEILING, POPOVER_BODY_MIN, type Packet, PacketCard, type PacketCardProps, type PacketSchema, type Pager, Pagination, type PaginationProps, PermissionDenied, type PermissionDeniedProps, type PermissionGroup, PermissionHint, type PermissionItem, type Phase, type PhaseStatus, PhasedProgress, type PhasedProgressProps, type Placement, type PollOptions, Popover, type PopoverProps, type PreferenceCriterion, PreferenceMeter, type PreferenceMeterProps, type ProfileFieldDef, type ProfileFieldType, type ProfileNotificationDef, ProfilePage, type ProfilePageProps, ProgressBar, type ProgressBarProps, QueryKit, type QueuedTurn, QuotaRow, type QuotaRowProps, ROOT_STEP, Radio, type RadioProps, RangeSlider, type RangeSliderProps, RelativeTime, type RelativeTimeProps, type RoadmapItem, type RoadmapResult, RoadmapTimeline, type RoadmapTimelineProps, type Role, RunActions, type RunActionsProps, type RunConfig, RuntimeKit, type RuntimeSummary, SaturationDistribution, type SaturationDistributionCampus, type SaturationDistributionProps, ScoreMeter, type ScoreMeterProps, ScreenHead, type ScreenHeadProps, SearchField, type SearchFieldProps, SegmentedControl, type SegmentedControlProps, SegmentedMeter, type SegmentedMeterProps, Select, type SelectOption, type SelectProps, type SendMessageResult, type ServerTable, type Session, type SessionContextValue, type Flag as SessionFlag, SessionKit, SessionProvider, type SessionProviderProps, type SessionRole, SessionScreen, type SessionScreenKind, type SessionScreenProps, type SessionStats, type SessionUser, SidebarNav, type SidebarNavItem, type SidebarNavProps, Skeleton, type SkeletonProps, SkeletonText, type SkeletonTextProps, type SlashCommand, Slider, type SliderProps, type SortDirection, type SortEntry, SortMenu, type SortMenuField, type SortMenuProps, type SpecModule, Spinner, type SpinnerProps, type StackedLayer, type StackedLayerOptions, StackedLayerProvider, StatTile, type StatTileProps, type Step, StepList, type StepListProps, type StreamHandlers, type Suggestion, SurroundSound, type SurroundSoundProps, Switch, type SwitchProps, type TableQuery, Tabs, type TabsProps, Tag, type TagProps, TestModeBar, type TestModeBarProps, type TextScale, Textarea, type TextareaProps, type ThemeMode, ThinkingBlock, type ThinkingBlockProps, type ThreadSummary, TimePicker, type TimePickerProps, Toast, type ToastApi, type ToastOptions, type ToastProps, ToastProvider, Tooltip, type TooltipProps, Topbar, type TopbarProps, TranscriptKit, TransferList, type TransferListProps, type TransferListSide, type TransferListSideProps, TrendChart, type TrendChartProps, type TrendSeries, type UsageLimit, UseFeatureStatus, type UseResponsiveRailOptions, type UseResponsiveRailResult, UseRuntimeMode, type UseServerTableOptions, type User, VIRTUAL_LIST_BUFFER_ROWS, VIRTUAL_LIST_ROW_GAP, type VersionRecord, type VersionStore, VirtualList, type VirtualListProps, type VirtualLoadedBand, type VirtualWindow, type VoiceHandler, __resetLayerStackForTests, acceptMatches, anyOfFilter, applyPrefs, channelWeightOf, computeNeedMore, computeVirtualWindow, copyToClipboard, createLocalStorageAppearanceStore, createVersionStore, eqFilter, extensionOf, extractClipboardFiles, filterFiles, formatAbsolute, formatBytes, formatClock, formatDocumentTitle, formatDuration, formatEta, formatRelative, groupMessages, hasModifier, iconForMime, importanceLevel, importanceTokens, installFlytedeskFavicon, isImage, isSystemMessage, isWithinLayerTree, jobBucket, languageLabel, loadPrefs, markdownToText, meterFormats, modifierLabel, parseDelimited, pastedTextName, pluralizeUnit, preferenceScore, preferenceSegments, rangeFilter, resolveTheme, revokeAttachment, savePrefs, toAttachment, tokenize, useAppearancePrefs, useChatEngine, useCopyToClipboard, useCornerStackSlot, useDocumentTitle, useFeatureStatus, useLayerZIndex, usePopoverPosition, useResponsiveRail, useRuntimeMode, useServerTable, useSessionContext, useStackedLayer, useStagedFiles, useToast, validateFilterValue, visibleMessages };
+export { AccountMenu, type AccountMenuLink, type AccountMenuProps, AgentChatPanel, type AgentChatPanelProps, AnchoredPopover, type AnchoredPopoverProps, AnimNum, type AnimNumProps, ApiSpecBrowser, type ApiSpecBrowserProps, type AppEntry, AppShell, type AppShellProps, AppSwitcher, type AppSwitcherProps, AppearanceMenu, type AppearanceMenuProps, type AppearancePrefs, AppearanceProvider, type AppearanceProviderProps, type AppearanceStore, type AppearanceStoreOptions, type Attachment, Avatar, type AvatarProps, AvatarStack, type AvatarStackProps, Badge, type BadgeProps, Banner, type BannerProps, type BannerTone, BarList, type BarListProps, type BarListRow, BudgetReallocator, type BudgetReallocatorProps, Button, type ButtonProps, CHANNELS, CHANNEL_WEIGHTS, CHAT_UNAVAILABLE, COPIED_FEEDBACK_MS, CORNER_STACK_INSET_PROPERTY, Calendar, type CalendarProps, Card, CardGrid, type CardGridProps, type CardProps, CardRow, type CardRowProps, ChannelContribution, type ChannelContributionChannel, type ChannelContributionProps, ChannelMeta, type ChannelMetaRecord, ChannelTag, type ChannelTagProps, ChannelWeightOf, type ChatAdapter, ChatComposer, type ChatComposerProps, type ChatEngine, type ChatEngineOptions, ChatKit, type ChatMessage, type ChatRenderContext, ChatSessionBar, type ChatSessionBarProps, ChatTranscript, type ChatTranscriptProps, ChatTurn, type ChatTurnProps, Checkbox, type CheckboxProps, type Citation, Citations, type CitationsProps, Clamp, type ClampProps, ClockFace, type ClockFaceProps, CodeBlock, type CodeBlockProps, CodeEditor, type CodeEditorDiagnostic, type CodeEditorProps, Collapsible, type CollapsibleProps, ComingSoon, type ComingSoonProps, type ContextUsage, CornerStackPortal, type CornerStackSlot, type CreateVersionStoreOptions, CsiBadge, type CsiBadgeProps, CsiHero, type CsiHeroProps, CsiMeter, type CsiMeterProps, DEFAULT_PREFS, DEFAULT_STORAGE_KEY, DEFAULT_TOAST_DURATION_MS, DataTable, type DataTableColumn, type DataTablePhoneRole, type DataTableProps, DatePicker, type DatePickerProps, type DemoSessionControls, DemoSessionProvider, type DeviceSession, DiffBlock, type DiffBlockProps, DonutChart, type DonutChartProps, type DonutSegment, Drawer, type DrawerProps, Dropzone, DropzoneKit, type DropzoneProps, ENTITY_ROW_METRIC_WIDTH, type EditorTrigger, EmptyState, type EmptyStateProps, type EndpointSpec, EntityRow, type EntityRowAction, type EntityRowContent, type EntityRowMetric, EntityRowMetrics, type EntityRowMetricsProps, type EntityRowProps, FILE_VIEWER_CSV_ROW_LIMIT, FILE_VIEWER_TEXT_LIMIT, type Fact, FactList, type FactListProps, FeatureGate, type FeatureGateProps, type FeatureStatus, FileBrowser, type FileBrowserFile, type FileBrowserFolder, type FileBrowserPermissions, type FileBrowserProps, FileChip, type FileChipProps, FileGrid, type FileGridProps, FileKit, FilePickButton, type FilePickButtonProps, type FileRejection, FileStrip, type FileStripProps, FileTile, type FileTileProps, type FileUploadHandler, FileViewer, type FileViewerProps, FilterBar, type FilterBarProps, type FilterDateValue, type FilterField, type FilterFieldDate, type FilterFieldMultiSelect, type FilterFieldOption, type FilterFieldRange, type FilterFieldSelect, type FilterFieldText, type FilterMultiSelectValue, type FilterOperator, type FilterRangeValue, type FilterResolveMatch, type FilterResolveResult, type FilterValidation, type FilterValue, Flag$1 as Flag, type FlagExplanation, type FlagProps, FlytedeskBrand, type FlytedeskBrandProps, FlytedeskMark, type FlytedeskMarkProps, FormatEta, FunnelChart, type FunnelChartProps, type FunnelStep, Gate, GatePending, type GatePendingProps, type GateProps, IMPORTANCE_LEVELS, IconButton, type IconButtonProps, type ImportanceLevel, type ImportanceLevelId, ImportanceTag, type ImportanceTagProps, type ImportanceTokens, Input, type InputProps, type Job, type JobAction, type JobCardStatus, type JobStatus, JobTray, type JobTrayProps, Json, KeyHint, type KeyHintProps, LAYER_STEP, type ListEnvelope, LoadingRegion, type LoadingRegionProps, Markdown, MarkdownEditor, type MarkdownEditorHandle, type MarkdownEditorProps, MarkdownInline, type MarkdownProps, type MentionSource, Menu, MenuButton, type MenuButtonProps, type MenuItem, type MenuProps, MessageBody, type MessageBodyProps, type MessageGroup, Meter, type MeterProps, type MeterSegment, type MeterSegmentInput, MixGap, type MixGapProps, type MixGapRow, MockJobKit, type MockJobStatus, Modal, type ModalProps, ModeSwitch, type ModeSwitchProps, type Model, ModelControls, type ModelControlsProps, NumberInput, type NumberInputProps, OVERLAY_CEILING, POPOVER_BODY_MIN, type Packet, PacketCard, type PacketCardProps, type PacketSchema, type Pager, Pagination, type PaginationProps, PermissionDenied, type PermissionDeniedProps, type PermissionGroup, PermissionHint, type PermissionItem, type Phase, type PhaseStatus, PhasedProgress, type PhasedProgressProps, type Placement, type PollOptions, Popover, type PopoverProps, type PreferenceCriterion, PreferenceMeter, type PreferenceMeterProps, type ProfileFieldDef, type ProfileFieldType, type ProfileNotificationDef, ProfilePage, type ProfilePageProps, ProgressBar, type ProgressBarProps, QueryKit, type QueuedTurn, QuotaRow, type QuotaRowProps, ROOT_STEP, Radio, type RadioProps, RangeSlider, type RangeSliderProps, RelativeTime, type RelativeTimeProps, type RoadmapItem, type RoadmapResult, RoadmapTimeline, type RoadmapTimelineProps, type Role, RunActions, type RunActionsProps, type RunConfig, RuntimeKit, type RuntimeSummary, SaturationDistribution, type SaturationDistributionCampus, type SaturationDistributionProps, ScoreMeter, type ScoreMeterProps, ScreenHead, type ScreenHeadProps, SearchField, type SearchFieldProps, SegmentedControl, type SegmentedControlProps, SegmentedMeter, type SegmentedMeterProps, Select, type SelectOption, type SelectProps, type SendMessageResult, type ServerTable, type Session, type SessionContextValue, type Flag as SessionFlag, SessionKit, SessionProvider, type SessionProviderProps, type SessionRole, SessionScreen, type SessionScreenKind, type SessionScreenProps, type SessionStats, type SessionUser, SidebarNav, type SidebarNavItem, type SidebarNavProps, Skeleton, type SkeletonProps, SkeletonText, type SkeletonTextProps, type SlashCommand, Slider, type SliderProps, type SortDirection, type SortEntry, SortMenu, type SortMenuField, type SortMenuProps, type SpecModule, Spinner, type SpinnerProps, type StackedLayer, type StackedLayerOptions, StackedLayerProvider, StatTile, type StatTileProps, type Step, StepList, type StepListProps, type StreamHandlers, type Suggestion, SurroundSound, type SurroundSoundProps, Switch, type SwitchProps, type TabItem, type TableQuery, Tabs, type TabsProps, Tag, type TagProps, TestModeBar, type TestModeBarProps, type TextScale, Textarea, type TextareaProps, type ThemeMode, ThinkingBlock, type ThinkingBlockProps, type ThreadSummary, TimePicker, type TimePickerProps, Toast, type ToastApi, type ToastOptions, type ToastProps, ToastProvider, Tooltip, type TooltipProps, Topbar, type TopbarProps, TranscriptKit, TransferList, type TransferListProps, type TransferListSide, type TransferListSideProps, TrendChart, type TrendChartProps, type TrendSeries, type UsageLimit, UseFeatureStatus, type UseResponsiveRailOptions, type UseResponsiveRailResult, UseRuntimeMode, type UseServerTableOptions, type User, VIRTUAL_LIST_BUFFER_ROWS, VIRTUAL_LIST_ROW_GAP, type VersionRecord, type VersionStore, VirtualList, type VirtualListProps, type VirtualLoadedBand, type VirtualWindow, type VoiceHandler, __resetLayerStackForTests, acceptMatches, anyOfFilter, applyAppearance, applyPrefs, channelWeightOf, computeNeedMore, computeVirtualWindow, copyToClipboard, createLocalStorageAppearanceStore, createVersionStore, eqFilter, extensionOf, extractClipboardFiles, filterFiles, formatAbsolute, formatBytes, formatClock, formatDocumentTitle, formatDuration, formatEta, formatRelative, groupMessages, hasModifier, iconForMime, importanceLevel, importanceTokens, installFlytedeskFavicon, isImage, isSystemMessage, isWithinLayerTree, jobBucket, languageLabel, loadPrefs, markdownToText, meterFormats, modifierLabel, parseDelimited, pastedTextName, pluralizeUnit, preferenceScore, preferenceSegments, rangeFilter, resolveTheme, revokeAttachment, savePrefs, toAttachment, tokenize, useAppearancePrefs, useAppearanceStore, useChatEngine, useCopyToClipboard, useCornerStackSlot, useDocumentTitle, useFeatureStatus, useLayerZIndex, usePopoverPosition, useResponsiveRail, useRuntimeMode, useServerTable, useSessionContext, useStackedLayer, useStagedFiles, useToast, validateFilterValue, visibleMessages, watchAppearance };