@flytedan/flytebot-design-system 0.85.0 → 0.87.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.cts CHANGED
@@ -96,6 +96,11 @@ interface PopoverProps {
96
96
  returnFocus?: boolean;
97
97
  className?: string;
98
98
  style?: React.CSSProperties;
99
+ /** DS-51: the standard header — this title and a Close button (labelled "Close", calls
100
+ * `onClose`), with the header's own padding. A `header` given as well renders beneath
101
+ * the title row inside the same pinned region. The title also names the surface when no
102
+ * `label` is given. */
103
+ title?: string;
99
104
  /** Pinned above the body and never scrolled away: a back link, a title, a segmented
100
105
  * toggle, a search field. */
101
106
  header?: React.ReactNode;
@@ -104,6 +109,13 @@ interface PopoverProps {
104
109
  footer?: React.ReactNode;
105
110
  /** The body — the one region of the surface that scrolls. */
106
111
  children?: React.ReactNode;
112
+ /** DOM id of the surface, so a trigger can point at it with aria-controls. */
113
+ id?: string;
114
+ /** Pointer and focus events on the surface itself, for a popover opened by hover or focus
115
+ * (see useHoverPopover). */
116
+ onPointerEnter?: React.PointerEventHandler<HTMLElement>;
117
+ onPointerLeave?: React.PointerEventHandler<HTMLElement>;
118
+ onBlur?: React.FocusEventHandler<HTMLElement>;
107
119
  }
108
120
  interface PopoverPosition {
109
121
  left: number;
@@ -187,7 +199,7 @@ declare function usePopoverPosition(open: boolean, anchorRef: React.RefObject<HT
187
199
  * to shrink into the body rather than overflow it — see `.fd-pop-body` in
188
200
  * components.css — so there is only ever one scrollbar.
189
201
  */
190
- declare function Popover({ open, anchorRef, triggerRef, onClose, placement, offset, matchWidth, width, minWidth, maxHeight, padded, role, label, closeOnOutside, closeOnEscape, returnFocus, className, style, header, footer, children, }: PopoverProps): React.ReactElement<any, string | React.JSXElementConstructor<any>> | null;
202
+ declare function Popover({ open, anchorRef, triggerRef, onClose, placement, offset, matchWidth, width, minWidth, maxHeight, padded, role, label, closeOnOutside, closeOnEscape, returnFocus, className, style, title, header, footer, children, id, onPointerEnter, onPointerLeave, onBlur, }: PopoverProps): React.ReactElement<any, string | React.JSXElementConstructor<any>> | null;
191
203
  interface MenuItem {
192
204
  id?: string;
193
205
  label?: React.ReactNode;
@@ -288,6 +300,39 @@ interface CopyButtonProps extends Omit<IconButtonProps, "icon" | "label" | "onCl
288
300
  */
289
301
  declare function CopyButton({ text, label, ...rest }: CopyButtonProps): React.JSX.Element;
290
302
 
303
+ /** Mouse rest time before the panel opens: a pointer sweeping across the page does not
304
+ * flash panels, a pointer resting on the trigger opens one. */
305
+ declare const HOVER_POPOVER_OPEN_DELAY_MS = 150;
306
+ interface UseHoverPopoverOptions {
307
+ /** Mouse rest time before hover opens the panel. */
308
+ openDelayMs?: number;
309
+ }
310
+ interface HoverPopoverApi {
311
+ /** Spread on the trigger, with `triggerRef` as its ref. Adds the hover, focus and tap
312
+ * handlers plus aria-expanded / aria-controls / aria-haspopup. */
313
+ triggerProps: React.HTMLAttributes<HTMLElement> & {
314
+ "aria-expanded": boolean;
315
+ "aria-controls": string;
316
+ "aria-haspopup": "dialog";
317
+ };
318
+ triggerRef: React.RefObject<any>;
319
+ /** Spread on `<Popover>` (give it a `label`): open state, anchor, close, id and the
320
+ * pointer / focus handlers that keep it open while the pointer or focus is on it. */
321
+ popoverProps: Pick<PopoverProps, "open" | "anchorRef" | "onClose" | "id" | "returnFocus" | "onPointerEnter" | "onPointerLeave" | "onBlur">;
322
+ open: boolean;
323
+ }
324
+ /**
325
+ * useHoverPopover: opens a `Popover` on mouse hover and keyboard focus as well as on tap, for
326
+ * explanations too big for a Tooltip.
327
+ *
328
+ * It is `useHoverIntent` (the logic behind `useTooltip`: mouse-only hover, `:focus-visible`
329
+ * focus, tap toggle, a close grace delay so the pointer can cross onto the panel) plus the
330
+ * Popover wiring: Escape and outside press come from Popover itself, and hover or focus
331
+ * opening never moves focus (`returnFocus` is off, so Escape leaves focus on the trigger).
332
+ * Blur to anything outside the trigger and the panel closes it.
333
+ */
334
+ declare function useHoverPopover({ openDelayMs }?: UseHoverPopoverOptions): HoverPopoverApi;
335
+
291
336
  interface AnchoredPopoverProps {
292
337
  rect: DOMRect | null;
293
338
  width?: number;
@@ -439,6 +484,20 @@ interface EditableTitleProps {
439
484
  }
440
485
  declare function EditableTitle({ value, onChange, label, placeholder, maxLength, readOnly, readOnlyReason, }: EditableTitleProps): React.JSX.Element;
441
486
 
487
+ interface PanelRowProps extends React.HTMLAttributes<HTMLDivElement> {
488
+ /** Exactly two panels. */
489
+ children: [React.ReactNode, React.ReactNode];
490
+ }
491
+ /**
492
+ * DS-54 — two equal panels side by side that stack to one column when the row's OWN container is
493
+ * narrower than 560px (two 272px panels and a 16px gap), following the container, not the viewport.
494
+ * The root is the size container and the panels sit in a grid inside it, like `StatGrid`.
495
+ * `CardGrid` does not fit: its `auto-fill` tracks leave empty columns in a wide container, so two
496
+ * panels would not be equal halves. `StatGrid` does not fit: it is for StatTiles and steps at the
497
+ * tile floor. `className` and native div attributes go on the root.
498
+ */
499
+ declare function PanelRow({ className, children, ...rest }: PanelRowProps): React.JSX.Element;
500
+
442
501
  /**
443
502
  * MP-271 — a responsive grid for a dashboard's worth of `Card`s (SMS-12's saved-audiences
444
503
  * page is the first consumer; media-planner's own dashboards are the reason this lives here
@@ -964,6 +1023,32 @@ declare function modifierLabel(): string;
964
1023
  /** True when the event carries the platform's primary modifier. */
965
1024
  declare function hasModifier(e: KeyboardEvent | React.KeyboardEvent): boolean;
966
1025
 
1026
+ /** A small status chip for a screen header that explains itself in a titled panel. */
1027
+ interface StatusIndicatorProps {
1028
+ /** The painted text, e.g. "5 rules" or "Do-not-call". */
1029
+ label: string;
1030
+ /** What the status is right now, e.g. "screened". With it the accessible name is
1031
+ * "<label>: <status>"; without it the name is the label alone. */
1032
+ status?: string;
1033
+ /** Phosphor icon name, leading. */
1034
+ icon?: string;
1035
+ /** Colours the chip. Never a pressed state. */
1036
+ tone?: "neutral" | "success" | "warning" | "danger";
1037
+ /** Shows a spinner in the icon slot and marks the chip busy. The chip keeps its size. */
1038
+ loading?: boolean;
1039
+ /** The panel's title (Popover `title`: the title plus a Close button). */
1040
+ panelTitle: string;
1041
+ /** The panel body: what the status means. */
1042
+ children?: React.ReactNode;
1043
+ className?: string;
1044
+ }
1045
+ /**
1046
+ * StatusIndicator (DS-51): a status chip that is not a toggle. It opens a Popover on hover,
1047
+ * keyboard focus or tap (useHoverPopover, DS-50) and exposes aria-haspopup="dialog" and
1048
+ * aria-expanded; it never sets aria-pressed.
1049
+ */
1050
+ declare function StatusIndicator({ label, status, icon, tone, loading, panelTitle, children, className, }: StatusIndicatorProps): React.JSX.Element;
1051
+
967
1052
  /** A clickable chip — filters, selected campuses, applied channels. */
968
1053
  interface TagProps {
969
1054
  children?: React.ReactNode;
@@ -1023,20 +1108,21 @@ declare function ToastProvider({ children }: {
1023
1108
  /** The app's toast host (see `ToastProvider`). Throws outside one. */
1024
1109
  declare function useToast(): ToastApi;
1025
1110
 
1026
- type TooltipPlacement = "top" | "bottom";
1027
- interface UseTooltipOptions {
1028
- placement?: TooltipPlacement;
1029
- /** Extra class names on the bubble. */
1030
- className?: string;
1031
- }
1032
- /** The handlers that make an element a tooltip target. Spread them on any element, an SVG
1033
- * `<path>` included: they read the element from the event, so no wrapper is needed. */
1111
+ /** The handlers that make an element a hover / focus / tap target. Spread them on any element,
1112
+ * an SVG `<path>` included: they read the element from the event, so no wrapper is needed. */
1034
1113
  interface TooltipBinding {
1035
1114
  onPointerEnter: (e: React.PointerEvent<Element>) => void;
1036
1115
  onPointerLeave: (e: React.PointerEvent<Element>) => void;
1037
1116
  onPointerUp: (e: React.PointerEvent<Element>) => void;
1038
1117
  onFocus: (e: React.FocusEvent<Element>) => void;
1039
- onBlur: () => void;
1118
+ onBlur: (e: React.FocusEvent<Element>) => void;
1119
+ }
1120
+
1121
+ type TooltipPlacement = "top" | "bottom";
1122
+ interface UseTooltipOptions {
1123
+ placement?: TooltipPlacement;
1124
+ /** Extra class names on the bubble. */
1125
+ className?: string;
1040
1126
  }
1041
1127
  interface TooltipApi {
1042
1128
  /** Props for one target. `id` names it for as long as it exists: one per target, stable across renders.
@@ -1154,6 +1240,9 @@ interface DonutSegment {
1154
1240
  value: number;
1155
1241
  /** Defaults to the categorical ramp in order. */
1156
1242
  color?: string;
1243
+ /** "quiet" draws the slice in the system's quiet colour (as SegmentedMeter's `variant: "quiet"`), so a
1244
+ * remainder such as "No year" reads as background. An explicit `color` wins. */
1245
+ variant?: "quiet";
1157
1246
  }
1158
1247
  interface DonutChartProps {
1159
1248
  segments: DonutSegment[];
@@ -1398,6 +1487,13 @@ interface FilterFieldBase {
1398
1487
  * its kind at a glance. It names the kind for a sighted reader, so a chip with an icon and a
1399
1488
  * value paints that value alone; its accessible name and tooltip stay the full "Label: value". */
1400
1489
  icon?: string;
1490
+ /** DS-55: gives the field's chip a small help button beside it. `summary` is one line saying what
1491
+ * the help explains; it shows in a Tooltip on hover and focus and is the button's description.
1492
+ * Pressing the button calls FilterBar's `onFieldHelp(key)`; FilterBar draws no help content. */
1493
+ help?: FilterFieldHelp;
1494
+ }
1495
+ interface FilterFieldHelp {
1496
+ summary: string;
1401
1497
  }
1402
1498
  interface FilterFieldText extends FilterFieldBase {
1403
1499
  type: "text";
@@ -1531,6 +1627,9 @@ type FilterValue<F extends FilterField> = F extends FilterFieldText ? string : F
1531
1627
  interface FilterBarProps extends Omit<React.HTMLAttributes<HTMLSpanElement>, "onChange"> {
1532
1628
  /** Every filter a consumer can add. Order here is the order in the "add filter" list. */
1533
1629
  fields: FilterField[];
1630
+ /** DS-55: fires with the field's key when the help button on a selected chip whose field has `help`
1631
+ * is pressed. The app opens its own help for that filter; the press does nothing else. */
1632
+ onFieldHelp?: (key: string) => void;
1534
1633
  /** The applied filters, and the single source of truth for them: FilterBar keeps no
1535
1634
  * copy. Straight off useServerTable — a value of undefined/""/false reads as "not set",
1536
1635
  * same convention that hook already uses for activeFilterCount. multiSelect/range/
@@ -1606,11 +1705,24 @@ type FilterValidation = {
1606
1705
  * min/max, and a whole number when `field.integer` is set; min ≤ max when both are set.
1607
1706
  */
1608
1707
  declare function validateFilterValue(field: FilterField, value: unknown): FilterValidation;
1609
- declare function FilterBar({ fields, filters, onFilterChange, onFilterRemove, align, actions, onClearAll, showActiveCount, loading, loadingLabel, className, ...rest }: FilterBarProps): React.JSX.Element;
1708
+ declare function FilterBar({ fields, filters, onFilterChange, onFilterRemove, onFieldHelp, align, actions, onClearAll, showActiveCount, loading, loadingLabel, className, ...rest }: FilterBarProps): React.JSX.Element;
1709
+
1710
+ interface InfoButtonProps {
1711
+ /** What the explanation is about. The button's accessible name is "About <label>". */
1712
+ label: string;
1713
+ /** The explanation, shown in a Tooltip on hover or focus. */
1714
+ info: React.ReactNode;
1715
+ }
1716
+ /**
1717
+ * DS-54 — the small info button StatTile draws after its label, exported so a panel heading can
1718
+ * carry the same one (a ghost, small `IconButton` with the info icon, wrapped in a `Tooltip`).
1719
+ * StatTile renders this component, so there is one copy.
1720
+ */
1721
+ declare function InfoButton({ label, info }: InfoButtonProps): React.JSX.Element;
1610
1722
 
1611
1723
  /**
1612
1724
  * MP-310 — a set of `StatTile`s that wraps only into even rows. `columns` is how many tiles the
1613
- * set holds on a full row; as the grid's OWN container narrows it drops 4 → 2 → 1 (or 2 → 1),
1725
+ * set holds on a full row; as the grid's OWN container narrows it drops 4 → 2 → 1 (3 → 1, or 2 → 1),
1614
1726
  * never leaving one tile alone on a line, which is what the plain `fd-grid-stats` (an `auto-fit`
1615
1727
  * that fits as many tiles as the width allows) does with four tiles at a width that fits three.
1616
1728
  * Callers that want that fit-as-many behaviour keep using `fd-grid-stats`; it is unchanged.
@@ -1621,8 +1733,8 @@ declare function FilterBar({ fields, filters, onFilterChange, onFilterRemove, al
1621
1733
  * `className` and every native div attribute go on the root.
1622
1734
  */
1623
1735
  interface StatGridProps extends React.HTMLAttributes<HTMLDivElement> {
1624
- /** Tiles per full row. 4 wraps 4 → 2 → 1; 2 wraps 2 → 1. */
1625
- columns: 2 | 4;
1736
+ /** Tiles per full row. 4 wraps 4 → 2 → 1; 3 wraps 3 → 1 (never 2 + 1); 2 wraps 2 → 1. */
1737
+ columns: 2 | 3 | 4;
1626
1738
  }
1627
1739
  declare function StatGrid({ columns, className, children, ...rest }: StatGridProps): React.JSX.Element;
1628
1740
 
@@ -1648,6 +1760,9 @@ interface StatTileBaseProps {
1648
1760
  /** Thin one-line variant for stat rows above tables. */
1649
1761
  compact?: boolean;
1650
1762
  className?: string;
1763
+ /** Explains the figure. An info button sits right after the label; hovering or focusing it
1764
+ * shows this in a Tooltip. The tile's own accessible name stays the label. */
1765
+ info?: React.ReactNode;
1651
1766
  }
1652
1767
  /** Display mode: a `div`, exactly as before. `pressed` and `disabled` mean nothing without `onPress`. */
1653
1768
  interface StatTileDisplayProps extends StatTileBaseProps, React.HTMLAttributes<HTMLDivElement> {
@@ -5954,4 +6069,4 @@ interface ExportTrayProps {
5954
6069
  * nothing: an empty card would hold the corner for no reason. */
5955
6070
  declare function ExportTray({ exports, onDownload, onDismiss }: ExportTrayProps): React.JSX.Element;
5956
6071
 
5957
- export { AccountMenu, type AccountMenuLink, type AccountMenuProps, type AdaptableSession, AgentChatPanel, type AgentChatPanelProps, AnchoredPopover, type AnchoredPopoverProps, AnimNum, type AnimNumProps, ApiSpecBrowser, type ApiSpecBrowserProps, type AppEntry, AppShell, type AppShellProps, type AppShellSidePanel, 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_CALL_DEADLINE_MS, CHAT_UNAVAILABLE, CHAT_UNAVAILABLE_MESSAGE, COPIED_FEEDBACK_MS, CORNER_STACK_INSET_PROPERTY, CORNER_STACK_OFFSET_PROPERTY, CSV_FAILED_FALLBACK, CSV_KEPT_NOTE, Calendar, type CalendarProps, CallDeadlineError, Card, CardGrid, type CardGridProps, type CardProps, CardRow, type CardRowProps, ChannelContribution, type ChannelContributionChannel, type ChannelContributionProps, ChannelMeta, type ChannelMetaRecord, ChannelTag, type ChannelTagProps, ChannelWeightOf, type ChatAdapter, type ChatAdapterOptions, ChatComposer, type ChatComposerProps, type ChatEngine, type ChatEngineOptions, ChatKit, type ChatMessage, type ChatRenderContext, ChatSessionBar, type ChatSessionBarProps, type ChatThreadContext, type ChatThreadRef, type ChatThreads, ChatTranscript, type ChatTranscriptProps, type ChatTransport, ChatTurn, type ChatTurnProps, ChatUnreachableError, 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, CopyButton, type CopyButtonProps, CornerStackPortal, type CornerStackSlot, type CreateVersionStoreOptions, CsiBadge, type CsiBadgeProps, CsiHero, type CsiHeroProps, CsiMeter, type CsiMeterProps, CsvCard, type CsvCardProps, DEFAULT_PREFS, DEFAULT_STORAGE_KEY, DEFAULT_TOAST_DURATION_MS, DataTable, type DataTableColumn, type DataTableColumnLabel, type DataTablePhoneRole, type DataTableProps, type DataTableRowAction, 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, EXPORT_FAILED_FALLBACK, EXPORT_IDLE_POLL_INTERVAL_MS, EXPORT_KEPT_NOTE, EXPORT_POLL_INTERVAL_MS, EditableTitle, type EditableTitleProps, type EditorTrigger, EmptyState, type EmptyStateProps, type EndpointSpec, EntityRow, type EntityRowAction, type EntityRowContent, type EntityRowMetric, EntityRowMetrics, type EntityRowMetricsProps, type EntityRowProps, type ExportDownloaderOptions, type ExportJob, type ExportJobStatus, type ExportState, ExportTray, type ExportTrayProps, FILE_VIEWER_CSV_ROW_LIMIT, FILE_VIEWER_TEXT_LIMIT, type Fact, FactList, type FactListProps, FeatureGate, type FeatureGateProps, type FeatureStatus, Fieldset, type FieldsetProps, 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 FilterFieldFixed, 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, type KeysetEnvelope, type KeysetServerTable, LAYER_STEP, type ListEnvelope, LoadingRegion, type LoadingRegionProps, Markdown, MarkdownEditor, type MarkdownEditorHandle, type MarkdownEditorProps, MarkdownInline, type MarkdownProps, type MarkdownSize, type MarkdownTone, 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, NEW_THREAD_FAILED, NumberInput, type NumberInputProps, OVERLAY_BREAKPOINT, OVERLAY_CEILING, POPOVER_BODY_MIN, type Packet, PacketCard, type PacketCardProps, type PacketDecision, type PacketDecisionAction, type PacketDecisionState, type PacketDecisionTone, 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, type PollingTurns, Popover, type PopoverProps, type PreferenceCriterion, PreferenceMeter, type PreferenceMeterProps, type ProfileFieldDef, type ProfileFieldType, type ProfileNotificationDef, ProfilePage, type ProfilePageProps, ProgressBar, type ProgressBarProps, QUERY_EMPTY_MESSAGE, QueryKit, type QueryPaging, QueryResultCard, type QueryResultCardProps, type QueryResultStatus, type QueryUrlAdapter, type QueryUrlOptions, type QueuedTurn, QuotaRow, type QuotaRowProps, ROOT_STEP, Radio, RadioGroup, type RadioGroupOption, type RadioGroupProps, type RadioProps, RangeSlider, type RangeSliderProps, type ReferenceEntry, ReferenceList, type ReferenceListProps, type ReferenceSection, RelativeTime, type RelativeTimeProps, ReservedSkeleton, type ReservedSkeletonProps, type RoadmapItem, type RoadmapResult, RoadmapTimeline, type RoadmapTimelineProps, type Role, RunActions, type RunActionsProps, type RunConfig, RuntimeKit, type RuntimeSummary, SHEET_OPEN_ATTRIBUTE, 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 ServerTableBase, type Session, type SessionAdapterUser, type SessionAppFeedEntry, 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, StatGrid, type StatGridProps, StatTile, type StatTileProps, type Step, StepList, type StepListProps, type StreamHandlers, type StreamingTurns, type Suggestion, SurroundSound, type SurroundSoundProps, Switch, type SwitchProps, THREADS_LOAD_FAILED, 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 TooltipApi, type TooltipBinding, type TooltipPlacement, type TooltipProps, Topbar, type TopbarProps, TranscriptKit, TransferList, type TransferListProps, type TransferListSide, type TransferListSideProps, TrendChart, type TrendChartProps, type TrendSeries, USChoropleth, type USChoroplethProps, type StateFigure as USChoroplethState, type ChoroplethValue as USChoroplethValue, US_STATE_CODES, type UsageLimit, type UseChatThreadsOptions, type UseExportJobsOptions, type UseExportJobsResult, UseFeatureStatus, type UseKeysetTableOptions, type UseResponsiveRailOptions, type UseResponsiveRailResult, UseRuntimeMode, type UseServerTableOptions, type UseTooltipOptions, 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, createChatAdapter, createExportDownloader, createLocalStorageAppearanceStore, createVersionStore, eqFilter, exportStateOf, exportToJob, extensionOf, extractClipboardFiles, filterFiles, formatAbsolute, formatBytes, formatClock, formatDocumentTitle, formatDuration, formatEta, formatRelative, formatShare, groupMessages, hasModifier, historyUrlAdapter, iconForMime, importanceLevel, importanceTokens, installFlytedeskFavicon, isExpiredExport, isImage, isLiveExport, isSystemMessage, isUsStateCode, isWithinLayerTree, jobBucket, languageLabel, loadPrefs, meterFormats, modifierLabel, parseDelimited, pastedTextName, pluralizeUnit, preferenceScore, preferenceSegments, rangeFilter, readQueryFromUrl, resolveTheme, revokeAttachment, savePrefs, toAttachment, toSwitcherEntries, tokenize, useAppearancePrefs, useAppearanceStore, useChatEngine, useChatThreads, useCopyToClipboard, useCornerStackSlot, useDocumentTitle, useExpiryClock, useExportJobs, useFeatureStatus, useLayerZIndex, useOverlayLayout, usePopoverPosition, usePublishCornerStackOffset, useResponsiveRail, useRuntimeMode, useServerTable, useSessionContext, useSessionContextValue, useSheetOpenMark, useShownExport, useStackedLayer, useStagedFiles, useToast, useTooltip, validateFilterValue, visibleMessages, watchAppearance, withDeadline, writeQueryToUrl };
6072
+ export { AccountMenu, type AccountMenuLink, type AccountMenuProps, type AdaptableSession, AgentChatPanel, type AgentChatPanelProps, AnchoredPopover, type AnchoredPopoverProps, AnimNum, type AnimNumProps, ApiSpecBrowser, type ApiSpecBrowserProps, type AppEntry, AppShell, type AppShellProps, type AppShellSidePanel, 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_CALL_DEADLINE_MS, CHAT_UNAVAILABLE, CHAT_UNAVAILABLE_MESSAGE, COPIED_FEEDBACK_MS, CORNER_STACK_INSET_PROPERTY, CORNER_STACK_OFFSET_PROPERTY, CSV_FAILED_FALLBACK, CSV_KEPT_NOTE, Calendar, type CalendarProps, CallDeadlineError, Card, CardGrid, type CardGridProps, type CardProps, CardRow, type CardRowProps, ChannelContribution, type ChannelContributionChannel, type ChannelContributionProps, ChannelMeta, type ChannelMetaRecord, ChannelTag, type ChannelTagProps, ChannelWeightOf, type ChatAdapter, type ChatAdapterOptions, ChatComposer, type ChatComposerProps, type ChatEngine, type ChatEngineOptions, ChatKit, type ChatMessage, type ChatRenderContext, ChatSessionBar, type ChatSessionBarProps, type ChatThreadContext, type ChatThreadRef, type ChatThreads, ChatTranscript, type ChatTranscriptProps, type ChatTransport, ChatTurn, type ChatTurnProps, ChatUnreachableError, 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, CopyButton, type CopyButtonProps, CornerStackPortal, type CornerStackSlot, type CreateVersionStoreOptions, CsiBadge, type CsiBadgeProps, CsiHero, type CsiHeroProps, CsiMeter, type CsiMeterProps, CsvCard, type CsvCardProps, DEFAULT_PREFS, DEFAULT_STORAGE_KEY, DEFAULT_TOAST_DURATION_MS, DataTable, type DataTableColumn, type DataTableColumnLabel, type DataTablePhoneRole, type DataTableProps, type DataTableRowAction, 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, EXPORT_FAILED_FALLBACK, EXPORT_IDLE_POLL_INTERVAL_MS, EXPORT_KEPT_NOTE, EXPORT_POLL_INTERVAL_MS, EditableTitle, type EditableTitleProps, type EditorTrigger, EmptyState, type EmptyStateProps, type EndpointSpec, EntityRow, type EntityRowAction, type EntityRowContent, type EntityRowMetric, EntityRowMetrics, type EntityRowMetricsProps, type EntityRowProps, type ExportDownloaderOptions, type ExportJob, type ExportJobStatus, type ExportState, ExportTray, type ExportTrayProps, FILE_VIEWER_CSV_ROW_LIMIT, FILE_VIEWER_TEXT_LIMIT, type Fact, FactList, type FactListProps, FeatureGate, type FeatureGateProps, type FeatureStatus, Fieldset, type FieldsetProps, 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 FilterFieldFixed, type FilterFieldHelp, 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, HOVER_POPOVER_OPEN_DELAY_MS, type HoverPopoverApi, IMPORTANCE_LEVELS, IconButton, type IconButtonProps, type ImportanceLevel, type ImportanceLevelId, ImportanceTag, type ImportanceTagProps, type ImportanceTokens, InfoButton, type InfoButtonProps, Input, type InputProps, type Job, type JobAction, type JobCardStatus, type JobStatus, JobTray, type JobTrayProps, Json, KeyHint, type KeyHintProps, type KeysetEnvelope, type KeysetServerTable, LAYER_STEP, type ListEnvelope, LoadingRegion, type LoadingRegionProps, Markdown, MarkdownEditor, type MarkdownEditorHandle, type MarkdownEditorProps, MarkdownInline, type MarkdownProps, type MarkdownSize, type MarkdownTone, 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, NEW_THREAD_FAILED, NumberInput, type NumberInputProps, OVERLAY_BREAKPOINT, OVERLAY_CEILING, POPOVER_BODY_MIN, type Packet, PacketCard, type PacketCardProps, type PacketDecision, type PacketDecisionAction, type PacketDecisionState, type PacketDecisionTone, type PacketSchema, type Pager, Pagination, type PaginationProps, PanelRow, type PanelRowProps, PermissionDenied, type PermissionDeniedProps, type PermissionGroup, PermissionHint, type PermissionItem, type Phase, type PhaseStatus, PhasedProgress, type PhasedProgressProps, type Placement, type PollOptions, type PollingTurns, Popover, type PopoverProps, type PreferenceCriterion, PreferenceMeter, type PreferenceMeterProps, type ProfileFieldDef, type ProfileFieldType, type ProfileNotificationDef, ProfilePage, type ProfilePageProps, ProgressBar, type ProgressBarProps, QUERY_EMPTY_MESSAGE, QueryKit, type QueryPaging, QueryResultCard, type QueryResultCardProps, type QueryResultStatus, type QueryUrlAdapter, type QueryUrlOptions, type QueuedTurn, QuotaRow, type QuotaRowProps, ROOT_STEP, Radio, RadioGroup, type RadioGroupOption, type RadioGroupProps, type RadioProps, RangeSlider, type RangeSliderProps, type ReferenceEntry, ReferenceList, type ReferenceListProps, type ReferenceSection, RelativeTime, type RelativeTimeProps, ReservedSkeleton, type ReservedSkeletonProps, type RoadmapItem, type RoadmapResult, RoadmapTimeline, type RoadmapTimelineProps, type Role, RunActions, type RunActionsProps, type RunConfig, RuntimeKit, type RuntimeSummary, SHEET_OPEN_ATTRIBUTE, 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 ServerTableBase, type Session, type SessionAdapterUser, type SessionAppFeedEntry, 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, StatGrid, type StatGridProps, StatTile, type StatTileProps, StatusIndicator, type StatusIndicatorProps, type Step, StepList, type StepListProps, type StreamHandlers, type StreamingTurns, type Suggestion, SurroundSound, type SurroundSoundProps, Switch, type SwitchProps, THREADS_LOAD_FAILED, 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 TooltipApi, type TooltipBinding, type TooltipPlacement, type TooltipProps, Topbar, type TopbarProps, TranscriptKit, TransferList, type TransferListProps, type TransferListSide, type TransferListSideProps, TrendChart, type TrendChartProps, type TrendSeries, USChoropleth, type USChoroplethProps, type StateFigure as USChoroplethState, type ChoroplethValue as USChoroplethValue, US_STATE_CODES, type UsageLimit, type UseChatThreadsOptions, type UseExportJobsOptions, type UseExportJobsResult, UseFeatureStatus, type UseHoverPopoverOptions, type UseKeysetTableOptions, type UseResponsiveRailOptions, type UseResponsiveRailResult, UseRuntimeMode, type UseServerTableOptions, type UseTooltipOptions, 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, createChatAdapter, createExportDownloader, createLocalStorageAppearanceStore, createVersionStore, eqFilter, exportStateOf, exportToJob, extensionOf, extractClipboardFiles, filterFiles, formatAbsolute, formatBytes, formatClock, formatDocumentTitle, formatDuration, formatEta, formatRelative, formatShare, groupMessages, hasModifier, historyUrlAdapter, iconForMime, importanceLevel, importanceTokens, installFlytedeskFavicon, isExpiredExport, isImage, isLiveExport, isSystemMessage, isUsStateCode, isWithinLayerTree, jobBucket, languageLabel, loadPrefs, meterFormats, modifierLabel, parseDelimited, pastedTextName, pluralizeUnit, preferenceScore, preferenceSegments, rangeFilter, readQueryFromUrl, resolveTheme, revokeAttachment, savePrefs, toAttachment, toSwitcherEntries, tokenize, useAppearancePrefs, useAppearanceStore, useChatEngine, useChatThreads, useCopyToClipboard, useCornerStackSlot, useDocumentTitle, useExpiryClock, useExportJobs, useFeatureStatus, useHoverPopover, useLayerZIndex, useOverlayLayout, usePopoverPosition, usePublishCornerStackOffset, useResponsiveRail, useRuntimeMode, useServerTable, useSessionContext, useSessionContextValue, useSheetOpenMark, useShownExport, useStackedLayer, useStagedFiles, useToast, useTooltip, validateFilterValue, visibleMessages, watchAppearance, withDeadline, writeQueryToUrl };
package/dist/index.d.ts CHANGED
@@ -96,6 +96,11 @@ interface PopoverProps {
96
96
  returnFocus?: boolean;
97
97
  className?: string;
98
98
  style?: React.CSSProperties;
99
+ /** DS-51: the standard header — this title and a Close button (labelled "Close", calls
100
+ * `onClose`), with the header's own padding. A `header` given as well renders beneath
101
+ * the title row inside the same pinned region. The title also names the surface when no
102
+ * `label` is given. */
103
+ title?: string;
99
104
  /** Pinned above the body and never scrolled away: a back link, a title, a segmented
100
105
  * toggle, a search field. */
101
106
  header?: React.ReactNode;
@@ -104,6 +109,13 @@ interface PopoverProps {
104
109
  footer?: React.ReactNode;
105
110
  /** The body — the one region of the surface that scrolls. */
106
111
  children?: React.ReactNode;
112
+ /** DOM id of the surface, so a trigger can point at it with aria-controls. */
113
+ id?: string;
114
+ /** Pointer and focus events on the surface itself, for a popover opened by hover or focus
115
+ * (see useHoverPopover). */
116
+ onPointerEnter?: React.PointerEventHandler<HTMLElement>;
117
+ onPointerLeave?: React.PointerEventHandler<HTMLElement>;
118
+ onBlur?: React.FocusEventHandler<HTMLElement>;
107
119
  }
108
120
  interface PopoverPosition {
109
121
  left: number;
@@ -187,7 +199,7 @@ declare function usePopoverPosition(open: boolean, anchorRef: React.RefObject<HT
187
199
  * to shrink into the body rather than overflow it — see `.fd-pop-body` in
188
200
  * components.css — so there is only ever one scrollbar.
189
201
  */
190
- declare function Popover({ open, anchorRef, triggerRef, onClose, placement, offset, matchWidth, width, minWidth, maxHeight, padded, role, label, closeOnOutside, closeOnEscape, returnFocus, className, style, header, footer, children, }: PopoverProps): React.ReactElement<any, string | React.JSXElementConstructor<any>> | null;
202
+ declare function Popover({ open, anchorRef, triggerRef, onClose, placement, offset, matchWidth, width, minWidth, maxHeight, padded, role, label, closeOnOutside, closeOnEscape, returnFocus, className, style, title, header, footer, children, id, onPointerEnter, onPointerLeave, onBlur, }: PopoverProps): React.ReactElement<any, string | React.JSXElementConstructor<any>> | null;
191
203
  interface MenuItem {
192
204
  id?: string;
193
205
  label?: React.ReactNode;
@@ -288,6 +300,39 @@ interface CopyButtonProps extends Omit<IconButtonProps, "icon" | "label" | "onCl
288
300
  */
289
301
  declare function CopyButton({ text, label, ...rest }: CopyButtonProps): React.JSX.Element;
290
302
 
303
+ /** Mouse rest time before the panel opens: a pointer sweeping across the page does not
304
+ * flash panels, a pointer resting on the trigger opens one. */
305
+ declare const HOVER_POPOVER_OPEN_DELAY_MS = 150;
306
+ interface UseHoverPopoverOptions {
307
+ /** Mouse rest time before hover opens the panel. */
308
+ openDelayMs?: number;
309
+ }
310
+ interface HoverPopoverApi {
311
+ /** Spread on the trigger, with `triggerRef` as its ref. Adds the hover, focus and tap
312
+ * handlers plus aria-expanded / aria-controls / aria-haspopup. */
313
+ triggerProps: React.HTMLAttributes<HTMLElement> & {
314
+ "aria-expanded": boolean;
315
+ "aria-controls": string;
316
+ "aria-haspopup": "dialog";
317
+ };
318
+ triggerRef: React.RefObject<any>;
319
+ /** Spread on `<Popover>` (give it a `label`): open state, anchor, close, id and the
320
+ * pointer / focus handlers that keep it open while the pointer or focus is on it. */
321
+ popoverProps: Pick<PopoverProps, "open" | "anchorRef" | "onClose" | "id" | "returnFocus" | "onPointerEnter" | "onPointerLeave" | "onBlur">;
322
+ open: boolean;
323
+ }
324
+ /**
325
+ * useHoverPopover: opens a `Popover` on mouse hover and keyboard focus as well as on tap, for
326
+ * explanations too big for a Tooltip.
327
+ *
328
+ * It is `useHoverIntent` (the logic behind `useTooltip`: mouse-only hover, `:focus-visible`
329
+ * focus, tap toggle, a close grace delay so the pointer can cross onto the panel) plus the
330
+ * Popover wiring: Escape and outside press come from Popover itself, and hover or focus
331
+ * opening never moves focus (`returnFocus` is off, so Escape leaves focus on the trigger).
332
+ * Blur to anything outside the trigger and the panel closes it.
333
+ */
334
+ declare function useHoverPopover({ openDelayMs }?: UseHoverPopoverOptions): HoverPopoverApi;
335
+
291
336
  interface AnchoredPopoverProps {
292
337
  rect: DOMRect | null;
293
338
  width?: number;
@@ -439,6 +484,20 @@ interface EditableTitleProps {
439
484
  }
440
485
  declare function EditableTitle({ value, onChange, label, placeholder, maxLength, readOnly, readOnlyReason, }: EditableTitleProps): React.JSX.Element;
441
486
 
487
+ interface PanelRowProps extends React.HTMLAttributes<HTMLDivElement> {
488
+ /** Exactly two panels. */
489
+ children: [React.ReactNode, React.ReactNode];
490
+ }
491
+ /**
492
+ * DS-54 — two equal panels side by side that stack to one column when the row's OWN container is
493
+ * narrower than 560px (two 272px panels and a 16px gap), following the container, not the viewport.
494
+ * The root is the size container and the panels sit in a grid inside it, like `StatGrid`.
495
+ * `CardGrid` does not fit: its `auto-fill` tracks leave empty columns in a wide container, so two
496
+ * panels would not be equal halves. `StatGrid` does not fit: it is for StatTiles and steps at the
497
+ * tile floor. `className` and native div attributes go on the root.
498
+ */
499
+ declare function PanelRow({ className, children, ...rest }: PanelRowProps): React.JSX.Element;
500
+
442
501
  /**
443
502
  * MP-271 — a responsive grid for a dashboard's worth of `Card`s (SMS-12's saved-audiences
444
503
  * page is the first consumer; media-planner's own dashboards are the reason this lives here
@@ -964,6 +1023,32 @@ declare function modifierLabel(): string;
964
1023
  /** True when the event carries the platform's primary modifier. */
965
1024
  declare function hasModifier(e: KeyboardEvent | React.KeyboardEvent): boolean;
966
1025
 
1026
+ /** A small status chip for a screen header that explains itself in a titled panel. */
1027
+ interface StatusIndicatorProps {
1028
+ /** The painted text, e.g. "5 rules" or "Do-not-call". */
1029
+ label: string;
1030
+ /** What the status is right now, e.g. "screened". With it the accessible name is
1031
+ * "<label>: <status>"; without it the name is the label alone. */
1032
+ status?: string;
1033
+ /** Phosphor icon name, leading. */
1034
+ icon?: string;
1035
+ /** Colours the chip. Never a pressed state. */
1036
+ tone?: "neutral" | "success" | "warning" | "danger";
1037
+ /** Shows a spinner in the icon slot and marks the chip busy. The chip keeps its size. */
1038
+ loading?: boolean;
1039
+ /** The panel's title (Popover `title`: the title plus a Close button). */
1040
+ panelTitle: string;
1041
+ /** The panel body: what the status means. */
1042
+ children?: React.ReactNode;
1043
+ className?: string;
1044
+ }
1045
+ /**
1046
+ * StatusIndicator (DS-51): a status chip that is not a toggle. It opens a Popover on hover,
1047
+ * keyboard focus or tap (useHoverPopover, DS-50) and exposes aria-haspopup="dialog" and
1048
+ * aria-expanded; it never sets aria-pressed.
1049
+ */
1050
+ declare function StatusIndicator({ label, status, icon, tone, loading, panelTitle, children, className, }: StatusIndicatorProps): React.JSX.Element;
1051
+
967
1052
  /** A clickable chip — filters, selected campuses, applied channels. */
968
1053
  interface TagProps {
969
1054
  children?: React.ReactNode;
@@ -1023,20 +1108,21 @@ declare function ToastProvider({ children }: {
1023
1108
  /** The app's toast host (see `ToastProvider`). Throws outside one. */
1024
1109
  declare function useToast(): ToastApi;
1025
1110
 
1026
- type TooltipPlacement = "top" | "bottom";
1027
- interface UseTooltipOptions {
1028
- placement?: TooltipPlacement;
1029
- /** Extra class names on the bubble. */
1030
- className?: string;
1031
- }
1032
- /** The handlers that make an element a tooltip target. Spread them on any element, an SVG
1033
- * `<path>` included: they read the element from the event, so no wrapper is needed. */
1111
+ /** The handlers that make an element a hover / focus / tap target. Spread them on any element,
1112
+ * an SVG `<path>` included: they read the element from the event, so no wrapper is needed. */
1034
1113
  interface TooltipBinding {
1035
1114
  onPointerEnter: (e: React.PointerEvent<Element>) => void;
1036
1115
  onPointerLeave: (e: React.PointerEvent<Element>) => void;
1037
1116
  onPointerUp: (e: React.PointerEvent<Element>) => void;
1038
1117
  onFocus: (e: React.FocusEvent<Element>) => void;
1039
- onBlur: () => void;
1118
+ onBlur: (e: React.FocusEvent<Element>) => void;
1119
+ }
1120
+
1121
+ type TooltipPlacement = "top" | "bottom";
1122
+ interface UseTooltipOptions {
1123
+ placement?: TooltipPlacement;
1124
+ /** Extra class names on the bubble. */
1125
+ className?: string;
1040
1126
  }
1041
1127
  interface TooltipApi {
1042
1128
  /** Props for one target. `id` names it for as long as it exists: one per target, stable across renders.
@@ -1154,6 +1240,9 @@ interface DonutSegment {
1154
1240
  value: number;
1155
1241
  /** Defaults to the categorical ramp in order. */
1156
1242
  color?: string;
1243
+ /** "quiet" draws the slice in the system's quiet colour (as SegmentedMeter's `variant: "quiet"`), so a
1244
+ * remainder such as "No year" reads as background. An explicit `color` wins. */
1245
+ variant?: "quiet";
1157
1246
  }
1158
1247
  interface DonutChartProps {
1159
1248
  segments: DonutSegment[];
@@ -1398,6 +1487,13 @@ interface FilterFieldBase {
1398
1487
  * its kind at a glance. It names the kind for a sighted reader, so a chip with an icon and a
1399
1488
  * value paints that value alone; its accessible name and tooltip stay the full "Label: value". */
1400
1489
  icon?: string;
1490
+ /** DS-55: gives the field's chip a small help button beside it. `summary` is one line saying what
1491
+ * the help explains; it shows in a Tooltip on hover and focus and is the button's description.
1492
+ * Pressing the button calls FilterBar's `onFieldHelp(key)`; FilterBar draws no help content. */
1493
+ help?: FilterFieldHelp;
1494
+ }
1495
+ interface FilterFieldHelp {
1496
+ summary: string;
1401
1497
  }
1402
1498
  interface FilterFieldText extends FilterFieldBase {
1403
1499
  type: "text";
@@ -1531,6 +1627,9 @@ type FilterValue<F extends FilterField> = F extends FilterFieldText ? string : F
1531
1627
  interface FilterBarProps extends Omit<React.HTMLAttributes<HTMLSpanElement>, "onChange"> {
1532
1628
  /** Every filter a consumer can add. Order here is the order in the "add filter" list. */
1533
1629
  fields: FilterField[];
1630
+ /** DS-55: fires with the field's key when the help button on a selected chip whose field has `help`
1631
+ * is pressed. The app opens its own help for that filter; the press does nothing else. */
1632
+ onFieldHelp?: (key: string) => void;
1534
1633
  /** The applied filters, and the single source of truth for them: FilterBar keeps no
1535
1634
  * copy. Straight off useServerTable — a value of undefined/""/false reads as "not set",
1536
1635
  * same convention that hook already uses for activeFilterCount. multiSelect/range/
@@ -1606,11 +1705,24 @@ type FilterValidation = {
1606
1705
  * min/max, and a whole number when `field.integer` is set; min ≤ max when both are set.
1607
1706
  */
1608
1707
  declare function validateFilterValue(field: FilterField, value: unknown): FilterValidation;
1609
- declare function FilterBar({ fields, filters, onFilterChange, onFilterRemove, align, actions, onClearAll, showActiveCount, loading, loadingLabel, className, ...rest }: FilterBarProps): React.JSX.Element;
1708
+ declare function FilterBar({ fields, filters, onFilterChange, onFilterRemove, onFieldHelp, align, actions, onClearAll, showActiveCount, loading, loadingLabel, className, ...rest }: FilterBarProps): React.JSX.Element;
1709
+
1710
+ interface InfoButtonProps {
1711
+ /** What the explanation is about. The button's accessible name is "About <label>". */
1712
+ label: string;
1713
+ /** The explanation, shown in a Tooltip on hover or focus. */
1714
+ info: React.ReactNode;
1715
+ }
1716
+ /**
1717
+ * DS-54 — the small info button StatTile draws after its label, exported so a panel heading can
1718
+ * carry the same one (a ghost, small `IconButton` with the info icon, wrapped in a `Tooltip`).
1719
+ * StatTile renders this component, so there is one copy.
1720
+ */
1721
+ declare function InfoButton({ label, info }: InfoButtonProps): React.JSX.Element;
1610
1722
 
1611
1723
  /**
1612
1724
  * MP-310 — a set of `StatTile`s that wraps only into even rows. `columns` is how many tiles the
1613
- * set holds on a full row; as the grid's OWN container narrows it drops 4 → 2 → 1 (or 2 → 1),
1725
+ * set holds on a full row; as the grid's OWN container narrows it drops 4 → 2 → 1 (3 → 1, or 2 → 1),
1614
1726
  * never leaving one tile alone on a line, which is what the plain `fd-grid-stats` (an `auto-fit`
1615
1727
  * that fits as many tiles as the width allows) does with four tiles at a width that fits three.
1616
1728
  * Callers that want that fit-as-many behaviour keep using `fd-grid-stats`; it is unchanged.
@@ -1621,8 +1733,8 @@ declare function FilterBar({ fields, filters, onFilterChange, onFilterRemove, al
1621
1733
  * `className` and every native div attribute go on the root.
1622
1734
  */
1623
1735
  interface StatGridProps extends React.HTMLAttributes<HTMLDivElement> {
1624
- /** Tiles per full row. 4 wraps 4 → 2 → 1; 2 wraps 2 → 1. */
1625
- columns: 2 | 4;
1736
+ /** Tiles per full row. 4 wraps 4 → 2 → 1; 3 wraps 3 → 1 (never 2 + 1); 2 wraps 2 → 1. */
1737
+ columns: 2 | 3 | 4;
1626
1738
  }
1627
1739
  declare function StatGrid({ columns, className, children, ...rest }: StatGridProps): React.JSX.Element;
1628
1740
 
@@ -1648,6 +1760,9 @@ interface StatTileBaseProps {
1648
1760
  /** Thin one-line variant for stat rows above tables. */
1649
1761
  compact?: boolean;
1650
1762
  className?: string;
1763
+ /** Explains the figure. An info button sits right after the label; hovering or focusing it
1764
+ * shows this in a Tooltip. The tile's own accessible name stays the label. */
1765
+ info?: React.ReactNode;
1651
1766
  }
1652
1767
  /** Display mode: a `div`, exactly as before. `pressed` and `disabled` mean nothing without `onPress`. */
1653
1768
  interface StatTileDisplayProps extends StatTileBaseProps, React.HTMLAttributes<HTMLDivElement> {
@@ -5954,4 +6069,4 @@ interface ExportTrayProps {
5954
6069
  * nothing: an empty card would hold the corner for no reason. */
5955
6070
  declare function ExportTray({ exports, onDownload, onDismiss }: ExportTrayProps): React.JSX.Element;
5956
6071
 
5957
- export { AccountMenu, type AccountMenuLink, type AccountMenuProps, type AdaptableSession, AgentChatPanel, type AgentChatPanelProps, AnchoredPopover, type AnchoredPopoverProps, AnimNum, type AnimNumProps, ApiSpecBrowser, type ApiSpecBrowserProps, type AppEntry, AppShell, type AppShellProps, type AppShellSidePanel, 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_CALL_DEADLINE_MS, CHAT_UNAVAILABLE, CHAT_UNAVAILABLE_MESSAGE, COPIED_FEEDBACK_MS, CORNER_STACK_INSET_PROPERTY, CORNER_STACK_OFFSET_PROPERTY, CSV_FAILED_FALLBACK, CSV_KEPT_NOTE, Calendar, type CalendarProps, CallDeadlineError, Card, CardGrid, type CardGridProps, type CardProps, CardRow, type CardRowProps, ChannelContribution, type ChannelContributionChannel, type ChannelContributionProps, ChannelMeta, type ChannelMetaRecord, ChannelTag, type ChannelTagProps, ChannelWeightOf, type ChatAdapter, type ChatAdapterOptions, ChatComposer, type ChatComposerProps, type ChatEngine, type ChatEngineOptions, ChatKit, type ChatMessage, type ChatRenderContext, ChatSessionBar, type ChatSessionBarProps, type ChatThreadContext, type ChatThreadRef, type ChatThreads, ChatTranscript, type ChatTranscriptProps, type ChatTransport, ChatTurn, type ChatTurnProps, ChatUnreachableError, 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, CopyButton, type CopyButtonProps, CornerStackPortal, type CornerStackSlot, type CreateVersionStoreOptions, CsiBadge, type CsiBadgeProps, CsiHero, type CsiHeroProps, CsiMeter, type CsiMeterProps, CsvCard, type CsvCardProps, DEFAULT_PREFS, DEFAULT_STORAGE_KEY, DEFAULT_TOAST_DURATION_MS, DataTable, type DataTableColumn, type DataTableColumnLabel, type DataTablePhoneRole, type DataTableProps, type DataTableRowAction, 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, EXPORT_FAILED_FALLBACK, EXPORT_IDLE_POLL_INTERVAL_MS, EXPORT_KEPT_NOTE, EXPORT_POLL_INTERVAL_MS, EditableTitle, type EditableTitleProps, type EditorTrigger, EmptyState, type EmptyStateProps, type EndpointSpec, EntityRow, type EntityRowAction, type EntityRowContent, type EntityRowMetric, EntityRowMetrics, type EntityRowMetricsProps, type EntityRowProps, type ExportDownloaderOptions, type ExportJob, type ExportJobStatus, type ExportState, ExportTray, type ExportTrayProps, FILE_VIEWER_CSV_ROW_LIMIT, FILE_VIEWER_TEXT_LIMIT, type Fact, FactList, type FactListProps, FeatureGate, type FeatureGateProps, type FeatureStatus, Fieldset, type FieldsetProps, 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 FilterFieldFixed, 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, type KeysetEnvelope, type KeysetServerTable, LAYER_STEP, type ListEnvelope, LoadingRegion, type LoadingRegionProps, Markdown, MarkdownEditor, type MarkdownEditorHandle, type MarkdownEditorProps, MarkdownInline, type MarkdownProps, type MarkdownSize, type MarkdownTone, 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, NEW_THREAD_FAILED, NumberInput, type NumberInputProps, OVERLAY_BREAKPOINT, OVERLAY_CEILING, POPOVER_BODY_MIN, type Packet, PacketCard, type PacketCardProps, type PacketDecision, type PacketDecisionAction, type PacketDecisionState, type PacketDecisionTone, 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, type PollingTurns, Popover, type PopoverProps, type PreferenceCriterion, PreferenceMeter, type PreferenceMeterProps, type ProfileFieldDef, type ProfileFieldType, type ProfileNotificationDef, ProfilePage, type ProfilePageProps, ProgressBar, type ProgressBarProps, QUERY_EMPTY_MESSAGE, QueryKit, type QueryPaging, QueryResultCard, type QueryResultCardProps, type QueryResultStatus, type QueryUrlAdapter, type QueryUrlOptions, type QueuedTurn, QuotaRow, type QuotaRowProps, ROOT_STEP, Radio, RadioGroup, type RadioGroupOption, type RadioGroupProps, type RadioProps, RangeSlider, type RangeSliderProps, type ReferenceEntry, ReferenceList, type ReferenceListProps, type ReferenceSection, RelativeTime, type RelativeTimeProps, ReservedSkeleton, type ReservedSkeletonProps, type RoadmapItem, type RoadmapResult, RoadmapTimeline, type RoadmapTimelineProps, type Role, RunActions, type RunActionsProps, type RunConfig, RuntimeKit, type RuntimeSummary, SHEET_OPEN_ATTRIBUTE, 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 ServerTableBase, type Session, type SessionAdapterUser, type SessionAppFeedEntry, 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, StatGrid, type StatGridProps, StatTile, type StatTileProps, type Step, StepList, type StepListProps, type StreamHandlers, type StreamingTurns, type Suggestion, SurroundSound, type SurroundSoundProps, Switch, type SwitchProps, THREADS_LOAD_FAILED, 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 TooltipApi, type TooltipBinding, type TooltipPlacement, type TooltipProps, Topbar, type TopbarProps, TranscriptKit, TransferList, type TransferListProps, type TransferListSide, type TransferListSideProps, TrendChart, type TrendChartProps, type TrendSeries, USChoropleth, type USChoroplethProps, type StateFigure as USChoroplethState, type ChoroplethValue as USChoroplethValue, US_STATE_CODES, type UsageLimit, type UseChatThreadsOptions, type UseExportJobsOptions, type UseExportJobsResult, UseFeatureStatus, type UseKeysetTableOptions, type UseResponsiveRailOptions, type UseResponsiveRailResult, UseRuntimeMode, type UseServerTableOptions, type UseTooltipOptions, 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, createChatAdapter, createExportDownloader, createLocalStorageAppearanceStore, createVersionStore, eqFilter, exportStateOf, exportToJob, extensionOf, extractClipboardFiles, filterFiles, formatAbsolute, formatBytes, formatClock, formatDocumentTitle, formatDuration, formatEta, formatRelative, formatShare, groupMessages, hasModifier, historyUrlAdapter, iconForMime, importanceLevel, importanceTokens, installFlytedeskFavicon, isExpiredExport, isImage, isLiveExport, isSystemMessage, isUsStateCode, isWithinLayerTree, jobBucket, languageLabel, loadPrefs, meterFormats, modifierLabel, parseDelimited, pastedTextName, pluralizeUnit, preferenceScore, preferenceSegments, rangeFilter, readQueryFromUrl, resolveTheme, revokeAttachment, savePrefs, toAttachment, toSwitcherEntries, tokenize, useAppearancePrefs, useAppearanceStore, useChatEngine, useChatThreads, useCopyToClipboard, useCornerStackSlot, useDocumentTitle, useExpiryClock, useExportJobs, useFeatureStatus, useLayerZIndex, useOverlayLayout, usePopoverPosition, usePublishCornerStackOffset, useResponsiveRail, useRuntimeMode, useServerTable, useSessionContext, useSessionContextValue, useSheetOpenMark, useShownExport, useStackedLayer, useStagedFiles, useToast, useTooltip, validateFilterValue, visibleMessages, watchAppearance, withDeadline, writeQueryToUrl };
6072
+ export { AccountMenu, type AccountMenuLink, type AccountMenuProps, type AdaptableSession, AgentChatPanel, type AgentChatPanelProps, AnchoredPopover, type AnchoredPopoverProps, AnimNum, type AnimNumProps, ApiSpecBrowser, type ApiSpecBrowserProps, type AppEntry, AppShell, type AppShellProps, type AppShellSidePanel, 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_CALL_DEADLINE_MS, CHAT_UNAVAILABLE, CHAT_UNAVAILABLE_MESSAGE, COPIED_FEEDBACK_MS, CORNER_STACK_INSET_PROPERTY, CORNER_STACK_OFFSET_PROPERTY, CSV_FAILED_FALLBACK, CSV_KEPT_NOTE, Calendar, type CalendarProps, CallDeadlineError, Card, CardGrid, type CardGridProps, type CardProps, CardRow, type CardRowProps, ChannelContribution, type ChannelContributionChannel, type ChannelContributionProps, ChannelMeta, type ChannelMetaRecord, ChannelTag, type ChannelTagProps, ChannelWeightOf, type ChatAdapter, type ChatAdapterOptions, ChatComposer, type ChatComposerProps, type ChatEngine, type ChatEngineOptions, ChatKit, type ChatMessage, type ChatRenderContext, ChatSessionBar, type ChatSessionBarProps, type ChatThreadContext, type ChatThreadRef, type ChatThreads, ChatTranscript, type ChatTranscriptProps, type ChatTransport, ChatTurn, type ChatTurnProps, ChatUnreachableError, 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, CopyButton, type CopyButtonProps, CornerStackPortal, type CornerStackSlot, type CreateVersionStoreOptions, CsiBadge, type CsiBadgeProps, CsiHero, type CsiHeroProps, CsiMeter, type CsiMeterProps, CsvCard, type CsvCardProps, DEFAULT_PREFS, DEFAULT_STORAGE_KEY, DEFAULT_TOAST_DURATION_MS, DataTable, type DataTableColumn, type DataTableColumnLabel, type DataTablePhoneRole, type DataTableProps, type DataTableRowAction, 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, EXPORT_FAILED_FALLBACK, EXPORT_IDLE_POLL_INTERVAL_MS, EXPORT_KEPT_NOTE, EXPORT_POLL_INTERVAL_MS, EditableTitle, type EditableTitleProps, type EditorTrigger, EmptyState, type EmptyStateProps, type EndpointSpec, EntityRow, type EntityRowAction, type EntityRowContent, type EntityRowMetric, EntityRowMetrics, type EntityRowMetricsProps, type EntityRowProps, type ExportDownloaderOptions, type ExportJob, type ExportJobStatus, type ExportState, ExportTray, type ExportTrayProps, FILE_VIEWER_CSV_ROW_LIMIT, FILE_VIEWER_TEXT_LIMIT, type Fact, FactList, type FactListProps, FeatureGate, type FeatureGateProps, type FeatureStatus, Fieldset, type FieldsetProps, 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 FilterFieldFixed, type FilterFieldHelp, 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, HOVER_POPOVER_OPEN_DELAY_MS, type HoverPopoverApi, IMPORTANCE_LEVELS, IconButton, type IconButtonProps, type ImportanceLevel, type ImportanceLevelId, ImportanceTag, type ImportanceTagProps, type ImportanceTokens, InfoButton, type InfoButtonProps, Input, type InputProps, type Job, type JobAction, type JobCardStatus, type JobStatus, JobTray, type JobTrayProps, Json, KeyHint, type KeyHintProps, type KeysetEnvelope, type KeysetServerTable, LAYER_STEP, type ListEnvelope, LoadingRegion, type LoadingRegionProps, Markdown, MarkdownEditor, type MarkdownEditorHandle, type MarkdownEditorProps, MarkdownInline, type MarkdownProps, type MarkdownSize, type MarkdownTone, 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, NEW_THREAD_FAILED, NumberInput, type NumberInputProps, OVERLAY_BREAKPOINT, OVERLAY_CEILING, POPOVER_BODY_MIN, type Packet, PacketCard, type PacketCardProps, type PacketDecision, type PacketDecisionAction, type PacketDecisionState, type PacketDecisionTone, type PacketSchema, type Pager, Pagination, type PaginationProps, PanelRow, type PanelRowProps, PermissionDenied, type PermissionDeniedProps, type PermissionGroup, PermissionHint, type PermissionItem, type Phase, type PhaseStatus, PhasedProgress, type PhasedProgressProps, type Placement, type PollOptions, type PollingTurns, Popover, type PopoverProps, type PreferenceCriterion, PreferenceMeter, type PreferenceMeterProps, type ProfileFieldDef, type ProfileFieldType, type ProfileNotificationDef, ProfilePage, type ProfilePageProps, ProgressBar, type ProgressBarProps, QUERY_EMPTY_MESSAGE, QueryKit, type QueryPaging, QueryResultCard, type QueryResultCardProps, type QueryResultStatus, type QueryUrlAdapter, type QueryUrlOptions, type QueuedTurn, QuotaRow, type QuotaRowProps, ROOT_STEP, Radio, RadioGroup, type RadioGroupOption, type RadioGroupProps, type RadioProps, RangeSlider, type RangeSliderProps, type ReferenceEntry, ReferenceList, type ReferenceListProps, type ReferenceSection, RelativeTime, type RelativeTimeProps, ReservedSkeleton, type ReservedSkeletonProps, type RoadmapItem, type RoadmapResult, RoadmapTimeline, type RoadmapTimelineProps, type Role, RunActions, type RunActionsProps, type RunConfig, RuntimeKit, type RuntimeSummary, SHEET_OPEN_ATTRIBUTE, 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 ServerTableBase, type Session, type SessionAdapterUser, type SessionAppFeedEntry, 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, StatGrid, type StatGridProps, StatTile, type StatTileProps, StatusIndicator, type StatusIndicatorProps, type Step, StepList, type StepListProps, type StreamHandlers, type StreamingTurns, type Suggestion, SurroundSound, type SurroundSoundProps, Switch, type SwitchProps, THREADS_LOAD_FAILED, 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 TooltipApi, type TooltipBinding, type TooltipPlacement, type TooltipProps, Topbar, type TopbarProps, TranscriptKit, TransferList, type TransferListProps, type TransferListSide, type TransferListSideProps, TrendChart, type TrendChartProps, type TrendSeries, USChoropleth, type USChoroplethProps, type StateFigure as USChoroplethState, type ChoroplethValue as USChoroplethValue, US_STATE_CODES, type UsageLimit, type UseChatThreadsOptions, type UseExportJobsOptions, type UseExportJobsResult, UseFeatureStatus, type UseHoverPopoverOptions, type UseKeysetTableOptions, type UseResponsiveRailOptions, type UseResponsiveRailResult, UseRuntimeMode, type UseServerTableOptions, type UseTooltipOptions, 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, createChatAdapter, createExportDownloader, createLocalStorageAppearanceStore, createVersionStore, eqFilter, exportStateOf, exportToJob, extensionOf, extractClipboardFiles, filterFiles, formatAbsolute, formatBytes, formatClock, formatDocumentTitle, formatDuration, formatEta, formatRelative, formatShare, groupMessages, hasModifier, historyUrlAdapter, iconForMime, importanceLevel, importanceTokens, installFlytedeskFavicon, isExpiredExport, isImage, isLiveExport, isSystemMessage, isUsStateCode, isWithinLayerTree, jobBucket, languageLabel, loadPrefs, meterFormats, modifierLabel, parseDelimited, pastedTextName, pluralizeUnit, preferenceScore, preferenceSegments, rangeFilter, readQueryFromUrl, resolveTheme, revokeAttachment, savePrefs, toAttachment, toSwitcherEntries, tokenize, useAppearancePrefs, useAppearanceStore, useChatEngine, useChatThreads, useCopyToClipboard, useCornerStackSlot, useDocumentTitle, useExpiryClock, useExportJobs, useFeatureStatus, useHoverPopover, useLayerZIndex, useOverlayLayout, usePopoverPosition, usePublishCornerStackOffset, useResponsiveRail, useRuntimeMode, useServerTable, useSessionContext, useSessionContextValue, useSheetOpenMark, useShownExport, useStackedLayer, useStagedFiles, useToast, useTooltip, validateFilterValue, visibleMessages, watchAppearance, withDeadline, writeQueryToUrl };