@flytedan/flytebot-design-system 0.61.0 → 0.62.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
@@ -934,15 +934,60 @@ declare function ToastProvider({ children }: {
934
934
  /** The app's toast host (see `ToastProvider`). Throws outside one. */
935
935
  declare function useToast(): ToastApi;
936
936
 
937
+ type TooltipPlacement = "top" | "bottom";
938
+ interface UseTooltipOptions {
939
+ placement?: TooltipPlacement;
940
+ /** Extra class names on the bubble. */
941
+ className?: string;
942
+ }
943
+ /** The handlers that make an element a tooltip target. Spread them on any element, an SVG
944
+ * `<path>` included: they read the element from the event, so no wrapper is needed. */
945
+ interface TooltipBinding {
946
+ onPointerEnter: (e: React.PointerEvent<Element>) => void;
947
+ onPointerLeave: (e: React.PointerEvent<Element>) => void;
948
+ onPointerUp: (e: React.PointerEvent<Element>) => void;
949
+ onFocus: (e: React.FocusEvent<Element>) => void;
950
+ onBlur: () => void;
951
+ }
952
+ interface TooltipApi {
953
+ /** Props for one target. `id` names it for as long as it exists: one per target, stable across renders.
954
+ * Call it in the same render as `useTooltip`, for every target: the bubble says what the labels bound in
955
+ * THAT render say, so a target bound later (in an effect, a callback or a child) shows an empty tip. */
956
+ bind: (id: string, label: React.ReactNode) => TooltipBinding;
957
+ /** The bubble, or null while nothing is open. Render it once, beside the targets, never inside an `<svg>`. */
958
+ bubble: React.ReactNode;
959
+ /** The `id` of the target the tip is on, or null. */
960
+ activeId: string | null;
961
+ }
962
+ /**
963
+ * useTooltip: the kit's tooltip behaviour for any element, an SVG shape included.
964
+ *
965
+ * `Tooltip` wraps its trigger in a `<span>`, which cannot sit between an `<svg>` and a
966
+ * `<path>`. This hook is the same behaviour without the wrapper: spread `bind(id, label)` on
967
+ * each target and render `bubble` once beside them. One tip is open at a time and moves from
968
+ * target to target, so fifty states share one bubble rather than mounting fifty.
969
+ *
970
+ * Three ways in, because a tooltip reachable only by a mouse hides its text from everyone
971
+ * else: hover (mouse only), keyboard focus (`:focus-visible`, so a mouse click that happens
972
+ * to focus a target does not pin a tip open) and tap (touch or pen, which have no hover; a
973
+ * second tap closes it). Escape and a press anywhere else dismiss it, and the pointer can
974
+ * move from the target onto the tip without it closing.
975
+ *
976
+ * It does not describe its target (`aria-describedby`): `Tooltip` adds that for its one
977
+ * trigger, while a shape's label is its own accessible name, so the caller names the target
978
+ * and the tip only repeats it.
979
+ */
980
+ declare function useTooltip({ placement, className }?: UseTooltipOptions): TooltipApi;
981
+
937
982
  /** A short clarification on hover, focus or tap. Never the only place information lives. */
938
983
  interface TooltipProps {
939
984
  label: React.ReactNode;
940
- placement?: "top" | "bottom";
985
+ placement?: TooltipPlacement;
941
986
  children?: React.ReactNode;
942
987
  className?: string;
943
988
  }
944
989
  /**
945
- * Tooltip — the kit's one tooltip, for any trigger.
990
+ * Tooltip — the kit's one tooltip, for any trigger that can sit inside a `<span>`.
946
991
  *
947
992
  * Three ways in, because a tooltip reachable only by a mouse hides its text from
948
993
  * everyone else: hover (mouse only), keyboard focus (`:focus-visible`, so a mouse click
@@ -956,10 +1001,11 @@ interface TooltipProps {
956
1001
  * instant. The trigger is the single child element when there is one (it receives the
957
1002
  * attribute); otherwise the wrapper does.
958
1003
  *
959
- * The bubble is portaled to document.body and positioned with the same anchored-layer
960
- * geometry as Popover (flip, clamp, follow a moving anchor), because a tooltip drawn
961
- * inside its trigger's box is clipped by the first `overflow: hidden` ancestor — which in
962
- * a fixed-width table cell or a list row is all of them.
1004
+ * The behaviour itself is `useTooltip`, which also anchors a tip to an element that cannot
1005
+ * be wrapped (an SVG shape). The bubble is portaled to document.body and positioned with the
1006
+ * same anchored-layer geometry as Popover (flip, clamp, follow a moving anchor), because a
1007
+ * tooltip drawn inside its trigger's box is clipped by the first `overflow: hidden` ancestor —
1008
+ * which in a fixed-width table cell or a list row is all of them.
963
1009
  */
964
1010
  declare function Tooltip({ label, placement, children, className }: TooltipProps): React.JSX.Element;
965
1011
 
@@ -2353,6 +2399,72 @@ interface FactListProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "chil
2353
2399
  */
2354
2400
  declare function FactList({ facts, className, ...rest }: FactListProps): React.JSX.Element;
2355
2401
 
2402
+ /** A state (or DC) with the FIPS code the US map geometry (us-atlas) identifies it by. `code` is its
2403
+ * USPS postal abbreviation, the key a caller names it by. */
2404
+ interface UsState {
2405
+ fips: string;
2406
+ code: string;
2407
+ name: string;
2408
+ }
2409
+ /** Every code a map value can name: the 50 states and DC, in state-name order (the order the map's arrow
2410
+ * keys and its table walk them). */
2411
+ declare const US_STATE_CODES: readonly string[];
2412
+ /** Whether `code` is one of `US_STATE_CODES`. A consumer whose data also carries territories or blanks
2413
+ * filters with this before passing values, rather than keeping its own copy of the list. */
2414
+ declare function isUsStateCode(code: string | null | undefined): code is string;
2415
+
2416
+ interface ChoroplethValue {
2417
+ /** USPS postal code: "CA", "DC". */
2418
+ state: string;
2419
+ /** A whole, non-negative count. 0 reads as no value. */
2420
+ value: number;
2421
+ }
2422
+ interface StateFigure extends UsState {
2423
+ value: number;
2424
+ /** Fraction (0 to 1) of every value given. */
2425
+ share: number;
2426
+ }
2427
+
2428
+ interface USChoroplethProps {
2429
+ /** One entry per state that has a value: USPS code and a whole count. A state not listed, or 0,
2430
+ * is drawn empty. A code that is not a state, a state twice or a value that is not a whole
2431
+ * count throws. */
2432
+ values: readonly ChoroplethValue[];
2433
+ /** Accessible name of the map, e.g. "Students by state". */
2434
+ label: string;
2435
+ /** What the value counts, plural: the heading of the table's value column ("Students"). */
2436
+ valueLabel: string;
2437
+ /** A value as the legend, the ranking and the table print it. */
2438
+ formatValue: (value: number) => string;
2439
+ /** What one state reads as everywhere it is named: its shape's accessible name, the tooltip and
2440
+ * the table. A state with no value arrives with `value` 0. */
2441
+ formatReadout: (state: StateFigure) => string;
2442
+ /** Show a ranking of this many states beside the map (below it when the component is narrow).
2443
+ * Leave unset for no ranking. */
2444
+ topN?: number;
2445
+ className?: string;
2446
+ }
2447
+ /**
2448
+ * USChoropleth: a US map with each state shaded by a count, on the kit's sequential ramp
2449
+ * (`--seq-1..5`), with the legend that names what each shade means.
2450
+ *
2451
+ * The scale is equal steps in the square root of the count, so the many small states are told
2452
+ * apart and the few huge ones do not take every dark shade. A state with no value is drawn empty,
2453
+ * not as the lightest shade. Alaska and Hawaii are inset below the lower 48 (the geometry is
2454
+ * us-atlas's Albers USA projection, already laid out that way, so no projection runs in the
2455
+ * browser). Every state is a focusable shape named with its readout (the map is one tab stop and the arrow keys walk the states in name order, so a keyboard reader is not asked for 51 Tabs), shown as a tooltip on hover,
2456
+ * keyboard focus or tap (`useTooltip`: a shape cannot be wrapped in `Tooltip`'s span).
2457
+ *
2458
+ * `topN` adds a ranking, a `BarList`, beside the map when the component is wide enough and below
2459
+ * it when it is not: the component's own width decides (a container query), not the window's, since
2460
+ * the same card sits in different page widths. Every figure is also in the table behind "Show as a
2461
+ * table" (`Collapsible` and `DataTable`), which is the text alternative to the map.
2462
+ *
2463
+ * The outlines and the geo libraries (d3-geo, topojson-client, us-atlas) are one separate chunk,
2464
+ * fetched when the map first renders; the legend, ranking and table show at once.
2465
+ */
2466
+ declare function USChoropleth({ values, label, valueLabel, formatValue, formatReadout, topN, className }: USChoroplethProps): React.JSX.Element;
2467
+
2356
2468
  /**
2357
2469
  * Multi-select control with a 44px comfortable hit area.
2358
2470
  */
@@ -5234,4 +5346,4 @@ declare function CornerStackPortal({ slot, children }: {
5234
5346
  children?: React.ReactNode;
5235
5347
  }): React.ReactPortal | null;
5236
5348
 
5237
- 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, type KeysetEnvelope, type KeysetServerTable, 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 QueryPaging, type QueryUrlAdapter, type QueryUrlOptions, 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 ServerTableBase, 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 UseKeysetTableOptions, 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, historyUrlAdapter, iconForMime, importanceLevel, importanceTokens, installFlytedeskFavicon, isImage, isSystemMessage, isWithinLayerTree, jobBucket, languageLabel, loadPrefs, markdownToText, meterFormats, modifierLabel, parseDelimited, pastedTextName, pluralizeUnit, preferenceScore, preferenceSegments, rangeFilter, readQueryFromUrl, resolveTheme, revokeAttachment, savePrefs, toAttachment, tokenize, useAppearancePrefs, useAppearanceStore, useChatEngine, useCopyToClipboard, useCornerStackSlot, useDocumentTitle, useFeatureStatus, useLayerZIndex, usePopoverPosition, useResponsiveRail, useRuntimeMode, useServerTable, useSessionContext, useStackedLayer, useStagedFiles, useToast, validateFilterValue, visibleMessages, watchAppearance, writeQueryToUrl };
5349
+ 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, type KeysetEnvelope, type KeysetServerTable, 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 QueryPaging, type QueryUrlAdapter, type QueryUrlOptions, 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 ServerTableBase, 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 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, 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, createLocalStorageAppearanceStore, createVersionStore, eqFilter, extensionOf, extractClipboardFiles, filterFiles, formatAbsolute, formatBytes, formatClock, formatDocumentTitle, formatDuration, formatEta, formatRelative, groupMessages, hasModifier, historyUrlAdapter, iconForMime, importanceLevel, importanceTokens, installFlytedeskFavicon, isImage, isSystemMessage, isUsStateCode, isWithinLayerTree, jobBucket, languageLabel, loadPrefs, markdownToText, meterFormats, modifierLabel, parseDelimited, pastedTextName, pluralizeUnit, preferenceScore, preferenceSegments, rangeFilter, readQueryFromUrl, resolveTheme, revokeAttachment, savePrefs, toAttachment, tokenize, useAppearancePrefs, useAppearanceStore, useChatEngine, useCopyToClipboard, useCornerStackSlot, useDocumentTitle, useFeatureStatus, useLayerZIndex, usePopoverPosition, useResponsiveRail, useRuntimeMode, useServerTable, useSessionContext, useStackedLayer, useStagedFiles, useToast, useTooltip, validateFilterValue, visibleMessages, watchAppearance, writeQueryToUrl };
package/dist/index.d.ts CHANGED
@@ -934,15 +934,60 @@ declare function ToastProvider({ children }: {
934
934
  /** The app's toast host (see `ToastProvider`). Throws outside one. */
935
935
  declare function useToast(): ToastApi;
936
936
 
937
+ type TooltipPlacement = "top" | "bottom";
938
+ interface UseTooltipOptions {
939
+ placement?: TooltipPlacement;
940
+ /** Extra class names on the bubble. */
941
+ className?: string;
942
+ }
943
+ /** The handlers that make an element a tooltip target. Spread them on any element, an SVG
944
+ * `<path>` included: they read the element from the event, so no wrapper is needed. */
945
+ interface TooltipBinding {
946
+ onPointerEnter: (e: React.PointerEvent<Element>) => void;
947
+ onPointerLeave: (e: React.PointerEvent<Element>) => void;
948
+ onPointerUp: (e: React.PointerEvent<Element>) => void;
949
+ onFocus: (e: React.FocusEvent<Element>) => void;
950
+ onBlur: () => void;
951
+ }
952
+ interface TooltipApi {
953
+ /** Props for one target. `id` names it for as long as it exists: one per target, stable across renders.
954
+ * Call it in the same render as `useTooltip`, for every target: the bubble says what the labels bound in
955
+ * THAT render say, so a target bound later (in an effect, a callback or a child) shows an empty tip. */
956
+ bind: (id: string, label: React.ReactNode) => TooltipBinding;
957
+ /** The bubble, or null while nothing is open. Render it once, beside the targets, never inside an `<svg>`. */
958
+ bubble: React.ReactNode;
959
+ /** The `id` of the target the tip is on, or null. */
960
+ activeId: string | null;
961
+ }
962
+ /**
963
+ * useTooltip: the kit's tooltip behaviour for any element, an SVG shape included.
964
+ *
965
+ * `Tooltip` wraps its trigger in a `<span>`, which cannot sit between an `<svg>` and a
966
+ * `<path>`. This hook is the same behaviour without the wrapper: spread `bind(id, label)` on
967
+ * each target and render `bubble` once beside them. One tip is open at a time and moves from
968
+ * target to target, so fifty states share one bubble rather than mounting fifty.
969
+ *
970
+ * Three ways in, because a tooltip reachable only by a mouse hides its text from everyone
971
+ * else: hover (mouse only), keyboard focus (`:focus-visible`, so a mouse click that happens
972
+ * to focus a target does not pin a tip open) and tap (touch or pen, which have no hover; a
973
+ * second tap closes it). Escape and a press anywhere else dismiss it, and the pointer can
974
+ * move from the target onto the tip without it closing.
975
+ *
976
+ * It does not describe its target (`aria-describedby`): `Tooltip` adds that for its one
977
+ * trigger, while a shape's label is its own accessible name, so the caller names the target
978
+ * and the tip only repeats it.
979
+ */
980
+ declare function useTooltip({ placement, className }?: UseTooltipOptions): TooltipApi;
981
+
937
982
  /** A short clarification on hover, focus or tap. Never the only place information lives. */
938
983
  interface TooltipProps {
939
984
  label: React.ReactNode;
940
- placement?: "top" | "bottom";
985
+ placement?: TooltipPlacement;
941
986
  children?: React.ReactNode;
942
987
  className?: string;
943
988
  }
944
989
  /**
945
- * Tooltip — the kit's one tooltip, for any trigger.
990
+ * Tooltip — the kit's one tooltip, for any trigger that can sit inside a `<span>`.
946
991
  *
947
992
  * Three ways in, because a tooltip reachable only by a mouse hides its text from
948
993
  * everyone else: hover (mouse only), keyboard focus (`:focus-visible`, so a mouse click
@@ -956,10 +1001,11 @@ interface TooltipProps {
956
1001
  * instant. The trigger is the single child element when there is one (it receives the
957
1002
  * attribute); otherwise the wrapper does.
958
1003
  *
959
- * The bubble is portaled to document.body and positioned with the same anchored-layer
960
- * geometry as Popover (flip, clamp, follow a moving anchor), because a tooltip drawn
961
- * inside its trigger's box is clipped by the first `overflow: hidden` ancestor — which in
962
- * a fixed-width table cell or a list row is all of them.
1004
+ * The behaviour itself is `useTooltip`, which also anchors a tip to an element that cannot
1005
+ * be wrapped (an SVG shape). The bubble is portaled to document.body and positioned with the
1006
+ * same anchored-layer geometry as Popover (flip, clamp, follow a moving anchor), because a
1007
+ * tooltip drawn inside its trigger's box is clipped by the first `overflow: hidden` ancestor —
1008
+ * which in a fixed-width table cell or a list row is all of them.
963
1009
  */
964
1010
  declare function Tooltip({ label, placement, children, className }: TooltipProps): React.JSX.Element;
965
1011
 
@@ -2353,6 +2399,72 @@ interface FactListProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "chil
2353
2399
  */
2354
2400
  declare function FactList({ facts, className, ...rest }: FactListProps): React.JSX.Element;
2355
2401
 
2402
+ /** A state (or DC) with the FIPS code the US map geometry (us-atlas) identifies it by. `code` is its
2403
+ * USPS postal abbreviation, the key a caller names it by. */
2404
+ interface UsState {
2405
+ fips: string;
2406
+ code: string;
2407
+ name: string;
2408
+ }
2409
+ /** Every code a map value can name: the 50 states and DC, in state-name order (the order the map's arrow
2410
+ * keys and its table walk them). */
2411
+ declare const US_STATE_CODES: readonly string[];
2412
+ /** Whether `code` is one of `US_STATE_CODES`. A consumer whose data also carries territories or blanks
2413
+ * filters with this before passing values, rather than keeping its own copy of the list. */
2414
+ declare function isUsStateCode(code: string | null | undefined): code is string;
2415
+
2416
+ interface ChoroplethValue {
2417
+ /** USPS postal code: "CA", "DC". */
2418
+ state: string;
2419
+ /** A whole, non-negative count. 0 reads as no value. */
2420
+ value: number;
2421
+ }
2422
+ interface StateFigure extends UsState {
2423
+ value: number;
2424
+ /** Fraction (0 to 1) of every value given. */
2425
+ share: number;
2426
+ }
2427
+
2428
+ interface USChoroplethProps {
2429
+ /** One entry per state that has a value: USPS code and a whole count. A state not listed, or 0,
2430
+ * is drawn empty. A code that is not a state, a state twice or a value that is not a whole
2431
+ * count throws. */
2432
+ values: readonly ChoroplethValue[];
2433
+ /** Accessible name of the map, e.g. "Students by state". */
2434
+ label: string;
2435
+ /** What the value counts, plural: the heading of the table's value column ("Students"). */
2436
+ valueLabel: string;
2437
+ /** A value as the legend, the ranking and the table print it. */
2438
+ formatValue: (value: number) => string;
2439
+ /** What one state reads as everywhere it is named: its shape's accessible name, the tooltip and
2440
+ * the table. A state with no value arrives with `value` 0. */
2441
+ formatReadout: (state: StateFigure) => string;
2442
+ /** Show a ranking of this many states beside the map (below it when the component is narrow).
2443
+ * Leave unset for no ranking. */
2444
+ topN?: number;
2445
+ className?: string;
2446
+ }
2447
+ /**
2448
+ * USChoropleth: a US map with each state shaded by a count, on the kit's sequential ramp
2449
+ * (`--seq-1..5`), with the legend that names what each shade means.
2450
+ *
2451
+ * The scale is equal steps in the square root of the count, so the many small states are told
2452
+ * apart and the few huge ones do not take every dark shade. A state with no value is drawn empty,
2453
+ * not as the lightest shade. Alaska and Hawaii are inset below the lower 48 (the geometry is
2454
+ * us-atlas's Albers USA projection, already laid out that way, so no projection runs in the
2455
+ * browser). Every state is a focusable shape named with its readout (the map is one tab stop and the arrow keys walk the states in name order, so a keyboard reader is not asked for 51 Tabs), shown as a tooltip on hover,
2456
+ * keyboard focus or tap (`useTooltip`: a shape cannot be wrapped in `Tooltip`'s span).
2457
+ *
2458
+ * `topN` adds a ranking, a `BarList`, beside the map when the component is wide enough and below
2459
+ * it when it is not: the component's own width decides (a container query), not the window's, since
2460
+ * the same card sits in different page widths. Every figure is also in the table behind "Show as a
2461
+ * table" (`Collapsible` and `DataTable`), which is the text alternative to the map.
2462
+ *
2463
+ * The outlines and the geo libraries (d3-geo, topojson-client, us-atlas) are one separate chunk,
2464
+ * fetched when the map first renders; the legend, ranking and table show at once.
2465
+ */
2466
+ declare function USChoropleth({ values, label, valueLabel, formatValue, formatReadout, topN, className }: USChoroplethProps): React.JSX.Element;
2467
+
2356
2468
  /**
2357
2469
  * Multi-select control with a 44px comfortable hit area.
2358
2470
  */
@@ -5234,4 +5346,4 @@ declare function CornerStackPortal({ slot, children }: {
5234
5346
  children?: React.ReactNode;
5235
5347
  }): React.ReactPortal | null;
5236
5348
 
5237
- 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, type KeysetEnvelope, type KeysetServerTable, 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 QueryPaging, type QueryUrlAdapter, type QueryUrlOptions, 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 ServerTableBase, 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 UseKeysetTableOptions, 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, historyUrlAdapter, iconForMime, importanceLevel, importanceTokens, installFlytedeskFavicon, isImage, isSystemMessage, isWithinLayerTree, jobBucket, languageLabel, loadPrefs, markdownToText, meterFormats, modifierLabel, parseDelimited, pastedTextName, pluralizeUnit, preferenceScore, preferenceSegments, rangeFilter, readQueryFromUrl, resolveTheme, revokeAttachment, savePrefs, toAttachment, tokenize, useAppearancePrefs, useAppearanceStore, useChatEngine, useCopyToClipboard, useCornerStackSlot, useDocumentTitle, useFeatureStatus, useLayerZIndex, usePopoverPosition, useResponsiveRail, useRuntimeMode, useServerTable, useSessionContext, useStackedLayer, useStagedFiles, useToast, validateFilterValue, visibleMessages, watchAppearance, writeQueryToUrl };
5349
+ 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, type KeysetEnvelope, type KeysetServerTable, 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 QueryPaging, type QueryUrlAdapter, type QueryUrlOptions, 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 ServerTableBase, 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 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, 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, createLocalStorageAppearanceStore, createVersionStore, eqFilter, extensionOf, extractClipboardFiles, filterFiles, formatAbsolute, formatBytes, formatClock, formatDocumentTitle, formatDuration, formatEta, formatRelative, groupMessages, hasModifier, historyUrlAdapter, iconForMime, importanceLevel, importanceTokens, installFlytedeskFavicon, isImage, isSystemMessage, isUsStateCode, isWithinLayerTree, jobBucket, languageLabel, loadPrefs, markdownToText, meterFormats, modifierLabel, parseDelimited, pastedTextName, pluralizeUnit, preferenceScore, preferenceSegments, rangeFilter, readQueryFromUrl, resolveTheme, revokeAttachment, savePrefs, toAttachment, tokenize, useAppearancePrefs, useAppearanceStore, useChatEngine, useCopyToClipboard, useCornerStackSlot, useDocumentTitle, useFeatureStatus, useLayerZIndex, usePopoverPosition, useResponsiveRail, useRuntimeMode, useServerTable, useSessionContext, useStackedLayer, useStagedFiles, useToast, useTooltip, validateFilterValue, visibleMessages, watchAppearance, writeQueryToUrl };