@flytedan/flytebot-design-system 0.27.1 → 0.29.0

package/dist/index.d.cts

@@ -692,8 +692,13 @@ interface BannerProps {
     title: React.ReactNode;
     detail?: React.ReactNode;
     actions?: React.ReactNode;
+    /** MP-243 Q3: a Banner reporting a failure (danger) or something invalid the user must
+     *  fix (warn) is a live-region announcement, not decoration — `role="alert"` for those
+     *  interrupts and announces immediately, `role="status"` for info/ok announces politely
+     *  once idle. Defaults by tone; a caller can still override either way. */
+    role?: "alert" | "status";
 }
-declare function Banner({ tone, title, detail, actions }: BannerProps): React.JSX.Element;
+declare function Banner({ tone, title, detail, actions, role }: BannerProps): React.JSX.Element;
 
 /**
  * A pill of state. Badges never carry actions — if it is clickable it is a Tag.
@@ -1075,17 +1080,105 @@ interface FilterFieldSelect extends FilterFieldBase {
     type: "select";
     options: FilterFieldOption[];
 }
-/** A declared filter field. Add a variant here (and a branch below) for a new value picker. */
-type FilterField = FilterFieldText | FilterFieldSelect;
+/** MP-243: include/exclude, shared by every field whose value is a set of options. */
+type FilterOperator = "in" | "notIn";
+interface FilterMultiSelectValue {
+    operator: FilterOperator;
+    values: FilterFieldOption[];
+}
+interface FilterResolveMatch {
+    token: string;
+    value: string;
+    label: string;
+}
+interface FilterResolveResult {
+    matched: FilterResolveMatch[];
+    unmatched: string[];
+}
+interface FilterFieldMultiSelect extends FilterFieldBase {
+    type: "multiSelect";
+    /** Sync option list — filtered client-side by the typed query. Omit when `loadOptions`
+     *  is given; the two are mutually exclusive (async wins if both are somehow set). */
+    options?: FilterFieldOption[];
+    /** Async option source for long lists (schools, imports, …), called ~300ms after the
+     *  last keystroke with the current query (possibly "") and an AbortSignal that fires
+     *  once a newer query has superseded this call (MP-243 A6) — pass it straight to
+     *  `fetch`/whatever transport does the lookup so a superseded request is actually
+     *  cancelled, not just ignored on arrival. A rejection (that isn't the abort itself)
+     *  renders as a visible error with a Retry action; it is never folded into "no
+     *  matches", since a search that FAILED is a different thing to tell the user than a
+     *  search that found nothing. */
+    loadOptions?: (query: string, signal: AbortSignal) => Promise<FilterFieldOption[]>;
+    /** MP-243 A1: paste-a-list as a second input mode for THIS SAME field — search and
+     *  paste both build one FilterMultiSelectValue for one dimension, so a school found by
+     *  typing and a school found by pasting a list land as two entries in the same set
+     *  instead of two separate filters that would AND together. Presence of `resolve` is
+     *  what turns on the Search/Paste mode switch; omit it for a search-only field. Never
+     *  called with an empty token list, and tokens are de-duplicated before the call. */
+    resolve?: (tokens: string[]) => Promise<FilterResolveResult>;
+    placeholder?: string;
+    /** Placeholder for the paste textarea, when `resolve` is given. Falls back to `placeholder`. */
+    pastePlaceholder?: string;
+    /** MP-243 A2: restrict which operators this field's toggle offers, e.g. `["in"]` for a
+     *  dimension that only ever means "is any of" and never "is none of" — a single-operator
+     *  list hides the toggle entirely and that operator applies unconditionally, so an app
+     *  can express an "any"/"is"-only dimension exactly rather than showing a switch with
+     *  nothing to switch to. Defaults to both `["in", "notIn"]`. */
+    operators?: FilterOperator[];
+}
+interface FilterRangeValue {
+    min?: number;
+    max?: number;
+}
+interface FilterFieldRange extends FilterFieldBase {
+    type: "range";
+    /** Bounds enforced on each stepper/typed value — NOT the same as the filter's own
+     *  min/max VALUE (FilterRangeValue), which is what the user is narrowing to. */
+    min?: number;
+    max?: number;
+    step?: number;
+    minLabel?: string;
+    maxLabel?: string;
+    minPlaceholder?: string;
+    maxPlaceholder?: string;
+}
+type FilterDateValue = {
+    kind: "withinDays";
+    days: number;
+} | {
+    kind: "between";
+    from: string;
+    to: string;
+};
+interface FilterFieldDate extends FilterFieldBase {
+    type: "date";
+    /** Default days shown the first time "within the last N days" is picked — shown, not
+     *  written: nothing is set until the user changes it or confirms it (MP-243 A4). */
+    defaultDays?: number;
+}
+/** A declared filter field. Add a variant here (and a branch below) for a new value
+ *  picker. text/select keep their original bare-string value shape unchanged, so an
+ *  existing consumer needs no migration; every other variant's value is a small typed
+ *  object of its own (see FilterValue). */
+type FilterField = FilterFieldText | FilterFieldSelect | FilterFieldMultiSelect | FilterFieldRange | FilterFieldDate;
+/** MP-243 A7: the value shape a given declared field reads/writes, so a consumer can type
+ *  its own `filters` record precisely instead of `Record<string, unknown>` — e.g.
+ *  `Record<"schools", FilterValue<typeof schoolsField>>`. */
+type FilterValue<F extends FilterField> = F extends FilterFieldText ? string : F extends FilterFieldSelect ? string : F extends FilterFieldMultiSelect ? FilterMultiSelectValue : F extends FilterFieldRange ? FilterRangeValue : F extends FilterFieldDate ? FilterDateValue : never;
 interface FilterBarProps extends Omit<React.HTMLAttributes<HTMLSpanElement>, "onChange"> {
     /** Every filter a consumer can add. Order here is the order in the "add filter" list. */
     fields: FilterField[];
     /** Straight off useServerTable — a value of undefined/""/false reads as "not set",
-     *  same convention that hook already uses for activeFilterCount. */
+     *  same convention that hook already uses for activeFilterCount. multiSelect/range/
+     *  date values are objects instead (see isFieldSet). */
     filters: Record<string, unknown>;
-    /** Fires on every value edit. Maps 1:1 onto useServerTable's setFilter(id, value). */
+    /** Fires on every value edit. Maps 1:1 onto useServerTable's setFilter(id, value).
+     *  FilterBar only ever calls this with a COMPLETE, valid value for the field — an
+     *  emptied selection, a one-sided date range, an invalid numeric range or a cleared
+     *  bound go through onFilterRemove (or nothing) instead (MP-243 A3). */
     onFilterChange: (key: string, value: unknown) => void;
-    /** Fires when a chip's × is clicked. Maps 1:1 onto useServerTable's clearFilter(id). */
+    /** Fires when a chip's × is clicked, or when an edit leaves a field with no valid
+     *  value. Maps 1:1 onto useServerTable's clearFilter(id). */
     onFilterRemove: (key: string) => void;
     /** Which edge the "add filter" popover aligns to. Default "left" — the trigger sits
      *  at the end of a left-to-right chip row, so its menu opens under its left edge. */
@@ -1095,18 +1188,26 @@ interface FilterBarProps extends Omit<React.HTMLAttributes<HTMLSpanElement>, "on
 /**
  * FilterBar — the declarative filter system for a server-driven list.
  *
- * A consumer declares fields once (`{ key, label, type: "text" | "select", ... }`) and
- * hands this a live `filters` record plus onFilterChange/onFilterRemove — the same three
- * things useServerTable already exposes, so wiring one up is copy-paste, not glue code.
- * Every active filter renders as a Tag chip; this component holds no shadow copy of
- * filter values, only the transient "which field's popover/input is open right now" UI
- * state (`panel`), the same way SortMenu holds `open` but never sort state itself.
+ * A consumer declares fields once (`{ key, label, type, ... }`) and hands this a live
+ * `filters` record plus onFilterChange/onFilterRemove — the same three things
+ * useServerTable already exposes, so wiring one up is copy-paste, not glue code. Every
+ * active filter renders as a Tag chip; this component holds no shadow copy of filter
+ * values, only the transient "which field's popover/input is open right now" UI state
+ * (`panel`), the same way SortMenu holds `open` but never sort state itself.
+ *
+ * Every floating surface — a field's edit panel and the "add filter" menu — is a real
+ * Popover (or Menu-in-a-Popover) from this kit's own actions module (MP-243 A5): viewport
+ * clamping, nested-layer handling, Escape, and focus-return-to-the-chip all come from
+ * there, so FilterBar itself runs no document-level dismissal listener of its own. Only
+ * the text field's inline input manages its own dismissal (blur/Enter/Escape), since it
+ * isn't a floating panel at all.
  *
- * Visual/interaction language is deliberately identical to SortMenu: a secondary Button
- * trigger, a `fd-view-enter` panel positioned with `top: calc(100% + 6px)`, the same
- * click-outside/Escape wiring, and the same `fd-stack`/`fd-row`/`fd-overline`/`fd-muted`/
- * `fd-body-sm` utility classes — so this reads as built by the same hand, not a new
- * import from elsewhere.
+ * MP-243 adds three variants on top of the original text/select, for audiences too big or
+ * too shaped for a single free-text box or a short dropdown: multiSelect (searchable, sync
+ * or async, with an optional paste-a-list mode for the same value), range (numeric
+ * min/max), and date ("within the last N days" or "between two dates"). text/select are
+ * unchanged and keep their bare-string value shape, so an existing consumer needs no
+ * migration.
  */
 declare function FilterBar({ fields, filters, onFilterChange, onFilterRemove, align, className, ...rest }: FilterBarProps): React.JSX.Element;
 
@@ -2112,7 +2213,10 @@ interface NumberInputProps {
     /** Thousands-format the display when not editing. Default true. */
     format?: boolean;
     value?: number | string;
-    /** Called with {target:{value}} where value is a number. */
+    /** Called with {target:{value}} where value is a number — or `undefined` once the
+     *  field is cleared to empty. A cleared field is "no value", never `0`: the caller
+     *  (e.g. FilterBar's range/date panels) tells an unset bound apart from a typed
+     *  zero by this, not by testing for `0` itself. */
     onChange?: (e: any) => void;
     placeholder?: string;
     style?: any;
@@ -4540,4 +4644,4 @@ declare function formatDocumentTitle(routeTitle: string | undefined | null, appN
  */
 declare function useDocumentTitle(routeTitle: string | undefined | null, appName: string): void;
 
-export { AccountMenu, type AccountMenuLink, type AccountMenuProps, AgentChatPanel, type AgentChatPanelProps, AnchoredPopover, type AnchoredPopoverProps, AnimNum, type AnimNumProps, ApiSpecBrowser, type ApiSpecBrowserProps, type AppEntry, AppShell, type AppShellProps, AppSwitcher, type AppSwitcherProps, AppearanceMenu, type AppearanceMenuProps, type AppearancePrefs, type AppearanceStore, type AppearanceStoreOptions, type Attachment, Avatar, type AvatarProps, AvatarStack, type AvatarStackProps, Badge, type BadgeProps, Banner, type BannerProps, type BannerTone, BarList, type BarListProps, type BarListRow, BudgetReallocator, type BudgetReallocatorProps, Button, type ButtonProps, CHANNELS, CHANNEL_WEIGHTS, CHAT_UNAVAILABLE, Calendar, type CalendarProps, Card, 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, Collapsible, type CollapsibleProps, ComingSoon, type ComingSoonProps, type ContextUsage, type CreateVersionStoreOptions, CsiBadge, type CsiBadgeProps, CsiHero, type CsiHeroProps, CsiMeter, type CsiMeterProps, DEFAULT_PREFS, DEFAULT_STORAGE_KEY, DataTable, type DataTableColumn, type DataTableProps, DatePicker, type DatePickerProps, type DemoSessionControls, DemoSessionProvider, type DeviceSession, DiffBlock, type DiffBlockProps, DonutChart, type DonutChartProps, type DonutSegment, Drawer, type DrawerProps, Dropzone, DropzoneKit, type DropzoneProps, ENTITY_ROW_METRIC_WIDTH, type EditorTrigger, EmptyState, type EmptyStateProps, type EndpointSpec, EntityRow, type EntityRowAction, type EntityRowContent, type EntityRowMetric, EntityRowMetrics, type EntityRowMetricsProps, type EntityRowProps, FILE_VIEWER_CSV_ROW_LIMIT, FILE_VIEWER_TEXT_LIMIT, FeatureGate, type FeatureGateProps, type FeatureStatus, FileBrowser, type FileBrowserFile, type FileBrowserFolder, type FileBrowserPermissions, type FileBrowserProps, FileChip, type FileChipProps, FileGrid, type FileGridProps, FileKit, FilePickButton, type FilePickButtonProps, type FileRejection, FileStrip, type FileStripProps, FileTile, type FileTileProps, type FileUploadHandler, FileViewer, type FileViewerProps, FilterBar, type FilterBarProps, type FilterField, type FilterFieldOption, type FilterFieldSelect, type FilterFieldText, Flag$1 as Flag, type FlagExplanation, type FlagProps, FlytedeskBrand, type FlytedeskBrandProps, FlytedeskMark, type FlytedeskMarkProps, FormatEta, FunnelChart, type FunnelChartProps, type FunnelStep, Gate, 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 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, POPOVER_BODY_MIN, type Packet, PacketCard, type PacketCardProps, type PacketSchema, type Pager, Pagination, type PaginationProps, PermissionDenied, type PermissionDeniedProps, type PermissionGroup, PermissionHint, type PermissionItem, type Phase, type PhaseStatus, PhasedProgress, type PhasedProgressProps, type Placement, type PollOptions, Popover, type PopoverProps, type PreferenceCriterion, PreferenceMeter, type PreferenceMeterProps, type ProfileFieldDef, type ProfileFieldType, type ProfileNotificationDef, ProfilePage, type ProfilePageProps, ProgressBar, type ProgressBarProps, QueryKit, type QueuedTurn, QuotaRow, type QuotaRowProps, Radio, type RadioProps, RangeSlider, type RangeSliderProps, RelativeTime, type RelativeTimeProps, type RoadmapItem, type RoadmapResult, RoadmapTimeline, type RoadmapTimelineProps, type Role, RunActions, type RunActionsProps, type RunConfig, RuntimeKit, type RuntimeSummary, SaturationDistribution, type SaturationDistributionCampus, type SaturationDistributionProps, ScoreMeter, type ScoreMeterProps, ScreenHead, type ScreenHeadProps, SearchField, type SearchFieldProps, SegmentedControl, type SegmentedControlProps, SegmentedMeter, type SegmentedMeterProps, Select, type SelectOption, type SelectProps, type SendMessageResult, type ServerTable, type Session, type SessionContextValue, type Flag as SessionFlag, SessionKit, SessionProvider, type SessionProviderProps, type SessionRole, type SessionStats, type SessionUser, SidebarNav, type SidebarNavItem, type SidebarNavProps, type SignInContinueAs, SignInPage, type SignInPageProps, Skeleton, type SkeletonProps, SkeletonText, type SkeletonTextProps, type SlashCommand, Slider, type SliderProps, SortMenu, type SortMenuField, type SortMenuProps, type SpecModule, Spinner, type SpinnerProps, StatTile, type StatTileProps, type Step, StepList, type StepListProps, type StreamHandlers, type Suggestion, SurroundSound, type SurroundSoundProps, Switch, type SwitchProps, type TableQuery, Tabs, type TabsProps, Tag, type TagProps, TestModeBar, type TestModeBarProps, type TextScale, Textarea, type TextareaProps, type ThemeMode, ThinkingBlock, type ThinkingBlockProps, type ThreadSummary, TimePicker, type TimePickerProps, Toast, type ToastProps, Tooltip, type TooltipProps, Topbar, type TopbarProps, TranscriptKit, TransferList, type TransferListProps, type TransferListSide, type TransferListSideProps, TrendChart, type TrendChartProps, type TrendSeries, type UsageLimit, UseFeatureStatus, type UseResponsiveRailOptions, type UseResponsiveRailResult, UseRuntimeMode, type UseServerTableOptions, type User, VIRTUAL_LIST_BUFFER_ROWS, VIRTUAL_LIST_ROW_GAP, type VersionRecord, type VersionStore, VirtualList, type VirtualListProps, type VirtualLoadedBand, type VirtualWindow, type VoiceHandler, acceptMatches, anyOfFilter, applyPrefs, channelWeightOf, computeNeedMore, computeVirtualWindow, createLocalStorageAppearanceStore, createVersionStore, eqFilter, extensionOf, extractClipboardFiles, filterFiles, formatAbsolute, formatBytes, formatClock, formatDocumentTitle, formatDuration, formatEta, formatRelative, groupMessages, hasModifier, iconForMime, importanceLevel, importanceTokens, installFlytedeskFavicon, isImage, isSystemMessage, jobBucket, languageLabel, loadPrefs, markdownToText, meterFormats, modifierLabel, parseDelimited, pastedTextName, pluralizeUnit, preferenceScore, preferenceSegments, rangeFilter, resolveTheme, revokeAttachment, savePrefs, toAttachment, tokenize, useAppearancePrefs, useChatEngine, useDocumentTitle, useFeatureStatus, useFocusTrap, usePopoverPosition, useResponsiveRail, useRuntimeMode, useServerTable, useSessionContext, useStagedFiles, visibleMessages };
+export { AccountMenu, type AccountMenuLink, type AccountMenuProps, AgentChatPanel, type AgentChatPanelProps, AnchoredPopover, type AnchoredPopoverProps, AnimNum, type AnimNumProps, ApiSpecBrowser, type ApiSpecBrowserProps, type AppEntry, AppShell, type AppShellProps, AppSwitcher, type AppSwitcherProps, AppearanceMenu, type AppearanceMenuProps, type AppearancePrefs, 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, Calendar, type CalendarProps, Card, 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, Collapsible, type CollapsibleProps, ComingSoon, type ComingSoonProps, type ContextUsage, type CreateVersionStoreOptions, CsiBadge, type CsiBadgeProps, CsiHero, type CsiHeroProps, CsiMeter, type CsiMeterProps, DEFAULT_PREFS, DEFAULT_STORAGE_KEY, DataTable, type DataTableColumn, type DataTableProps, DatePicker, type DatePickerProps, type DemoSessionControls, DemoSessionProvider, type DeviceSession, DiffBlock, type DiffBlockProps, DonutChart, type DonutChartProps, type DonutSegment, Drawer, type DrawerProps, Dropzone, DropzoneKit, type DropzoneProps, ENTITY_ROW_METRIC_WIDTH, type EditorTrigger, EmptyState, type EmptyStateProps, type EndpointSpec, EntityRow, type EntityRowAction, type EntityRowContent, type EntityRowMetric, EntityRowMetrics, type EntityRowMetricsProps, type EntityRowProps, FILE_VIEWER_CSV_ROW_LIMIT, FILE_VIEWER_TEXT_LIMIT, FeatureGate, type FeatureGateProps, type FeatureStatus, FileBrowser, type FileBrowserFile, type FileBrowserFolder, type FileBrowserPermissions, type FileBrowserProps, FileChip, type FileChipProps, FileGrid, type FileGridProps, FileKit, FilePickButton, type FilePickButtonProps, type FileRejection, FileStrip, type FileStripProps, FileTile, type FileTileProps, type FileUploadHandler, FileViewer, type FileViewerProps, FilterBar, type FilterBarProps, type FilterDateValue, type FilterField, type FilterFieldDate, type FilterFieldMultiSelect, type FilterFieldOption, type FilterFieldRange, type FilterFieldSelect, type FilterFieldText, type FilterMultiSelectValue, type FilterOperator, type FilterRangeValue, type FilterResolveMatch, type FilterResolveResult, type FilterValue, Flag$1 as Flag, type FlagExplanation, type FlagProps, FlytedeskBrand, type FlytedeskBrandProps, FlytedeskMark, type FlytedeskMarkProps, FormatEta, FunnelChart, type FunnelChartProps, type FunnelStep, Gate, 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 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, POPOVER_BODY_MIN, type Packet, PacketCard, type PacketCardProps, type PacketSchema, type Pager, Pagination, type PaginationProps, PermissionDenied, type PermissionDeniedProps, type PermissionGroup, PermissionHint, type PermissionItem, type Phase, type PhaseStatus, PhasedProgress, type PhasedProgressProps, type Placement, type PollOptions, Popover, type PopoverProps, type PreferenceCriterion, PreferenceMeter, type PreferenceMeterProps, type ProfileFieldDef, type ProfileFieldType, type ProfileNotificationDef, ProfilePage, type ProfilePageProps, ProgressBar, type ProgressBarProps, QueryKit, type QueuedTurn, QuotaRow, type QuotaRowProps, Radio, type RadioProps, RangeSlider, type RangeSliderProps, RelativeTime, type RelativeTimeProps, type RoadmapItem, type RoadmapResult, RoadmapTimeline, type RoadmapTimelineProps, type Role, RunActions, type RunActionsProps, type RunConfig, RuntimeKit, type RuntimeSummary, SaturationDistribution, type SaturationDistributionCampus, type SaturationDistributionProps, ScoreMeter, type ScoreMeterProps, ScreenHead, type ScreenHeadProps, SearchField, type SearchFieldProps, SegmentedControl, type SegmentedControlProps, SegmentedMeter, type SegmentedMeterProps, Select, type SelectOption, type SelectProps, type SendMessageResult, type ServerTable, type Session, type SessionContextValue, type Flag as SessionFlag, SessionKit, SessionProvider, type SessionProviderProps, type SessionRole, type SessionStats, type SessionUser, SidebarNav, type SidebarNavItem, type SidebarNavProps, type SignInContinueAs, SignInPage, type SignInPageProps, Skeleton, type SkeletonProps, SkeletonText, type SkeletonTextProps, type SlashCommand, Slider, type SliderProps, SortMenu, type SortMenuField, type SortMenuProps, type SpecModule, Spinner, type SpinnerProps, StatTile, type StatTileProps, type Step, StepList, type StepListProps, type StreamHandlers, type Suggestion, SurroundSound, type SurroundSoundProps, Switch, type SwitchProps, type TableQuery, Tabs, type TabsProps, Tag, type TagProps, TestModeBar, type TestModeBarProps, type TextScale, Textarea, type TextareaProps, type ThemeMode, ThinkingBlock, type ThinkingBlockProps, type ThreadSummary, TimePicker, type TimePickerProps, Toast, type ToastProps, Tooltip, type TooltipProps, Topbar, type TopbarProps, TranscriptKit, TransferList, type TransferListProps, type TransferListSide, type TransferListSideProps, TrendChart, type TrendChartProps, type TrendSeries, type UsageLimit, UseFeatureStatus, type UseResponsiveRailOptions, type UseResponsiveRailResult, UseRuntimeMode, type UseServerTableOptions, type User, VIRTUAL_LIST_BUFFER_ROWS, VIRTUAL_LIST_ROW_GAP, type VersionRecord, type VersionStore, VirtualList, type VirtualListProps, type VirtualLoadedBand, type VirtualWindow, type VoiceHandler, acceptMatches, anyOfFilter, applyPrefs, channelWeightOf, computeNeedMore, computeVirtualWindow, createLocalStorageAppearanceStore, createVersionStore, eqFilter, extensionOf, extractClipboardFiles, filterFiles, formatAbsolute, formatBytes, formatClock, formatDocumentTitle, formatDuration, formatEta, formatRelative, groupMessages, hasModifier, iconForMime, importanceLevel, importanceTokens, installFlytedeskFavicon, isImage, isSystemMessage, jobBucket, languageLabel, loadPrefs, markdownToText, meterFormats, modifierLabel, parseDelimited, pastedTextName, pluralizeUnit, preferenceScore, preferenceSegments, rangeFilter, resolveTheme, revokeAttachment, savePrefs, toAttachment, tokenize, useAppearancePrefs, useChatEngine, useDocumentTitle, useFeatureStatus, useFocusTrap, usePopoverPosition, useResponsiveRail, useRuntimeMode, useServerTable, useSessionContext, useStagedFiles, visibleMessages };

package/dist/index.d.ts

@@ -692,8 +692,13 @@ interface BannerProps {
     title: React.ReactNode;
     detail?: React.ReactNode;
     actions?: React.ReactNode;
+    /** MP-243 Q3: a Banner reporting a failure (danger) or something invalid the user must
+     *  fix (warn) is a live-region announcement, not decoration — `role="alert"` for those
+     *  interrupts and announces immediately, `role="status"` for info/ok announces politely
+     *  once idle. Defaults by tone; a caller can still override either way. */
+    role?: "alert" | "status";
 }
-declare function Banner({ tone, title, detail, actions }: BannerProps): React.JSX.Element;
+declare function Banner({ tone, title, detail, actions, role }: BannerProps): React.JSX.Element;
 
 /**
  * A pill of state. Badges never carry actions — if it is clickable it is a Tag.
@@ -1075,17 +1080,105 @@ interface FilterFieldSelect extends FilterFieldBase {
     type: "select";
     options: FilterFieldOption[];
 }
-/** A declared filter field. Add a variant here (and a branch below) for a new value picker. */
-type FilterField = FilterFieldText | FilterFieldSelect;
+/** MP-243: include/exclude, shared by every field whose value is a set of options. */
+type FilterOperator = "in" | "notIn";
+interface FilterMultiSelectValue {
+    operator: FilterOperator;
+    values: FilterFieldOption[];
+}
+interface FilterResolveMatch {
+    token: string;
+    value: string;
+    label: string;
+}
+interface FilterResolveResult {
+    matched: FilterResolveMatch[];
+    unmatched: string[];
+}
+interface FilterFieldMultiSelect extends FilterFieldBase {
+    type: "multiSelect";
+    /** Sync option list — filtered client-side by the typed query. Omit when `loadOptions`
+     *  is given; the two are mutually exclusive (async wins if both are somehow set). */
+    options?: FilterFieldOption[];
+    /** Async option source for long lists (schools, imports, …), called ~300ms after the
+     *  last keystroke with the current query (possibly "") and an AbortSignal that fires
+     *  once a newer query has superseded this call (MP-243 A6) — pass it straight to
+     *  `fetch`/whatever transport does the lookup so a superseded request is actually
+     *  cancelled, not just ignored on arrival. A rejection (that isn't the abort itself)
+     *  renders as a visible error with a Retry action; it is never folded into "no
+     *  matches", since a search that FAILED is a different thing to tell the user than a
+     *  search that found nothing. */
+    loadOptions?: (query: string, signal: AbortSignal) => Promise<FilterFieldOption[]>;
+    /** MP-243 A1: paste-a-list as a second input mode for THIS SAME field — search and
+     *  paste both build one FilterMultiSelectValue for one dimension, so a school found by
+     *  typing and a school found by pasting a list land as two entries in the same set
+     *  instead of two separate filters that would AND together. Presence of `resolve` is
+     *  what turns on the Search/Paste mode switch; omit it for a search-only field. Never
+     *  called with an empty token list, and tokens are de-duplicated before the call. */
+    resolve?: (tokens: string[]) => Promise<FilterResolveResult>;
+    placeholder?: string;
+    /** Placeholder for the paste textarea, when `resolve` is given. Falls back to `placeholder`. */
+    pastePlaceholder?: string;
+    /** MP-243 A2: restrict which operators this field's toggle offers, e.g. `["in"]` for a
+     *  dimension that only ever means "is any of" and never "is none of" — a single-operator
+     *  list hides the toggle entirely and that operator applies unconditionally, so an app
+     *  can express an "any"/"is"-only dimension exactly rather than showing a switch with
+     *  nothing to switch to. Defaults to both `["in", "notIn"]`. */
+    operators?: FilterOperator[];
+}
+interface FilterRangeValue {
+    min?: number;
+    max?: number;
+}
+interface FilterFieldRange extends FilterFieldBase {
+    type: "range";
+    /** Bounds enforced on each stepper/typed value — NOT the same as the filter's own
+     *  min/max VALUE (FilterRangeValue), which is what the user is narrowing to. */
+    min?: number;
+    max?: number;
+    step?: number;
+    minLabel?: string;
+    maxLabel?: string;
+    minPlaceholder?: string;
+    maxPlaceholder?: string;
+}
+type FilterDateValue = {
+    kind: "withinDays";
+    days: number;
+} | {
+    kind: "between";
+    from: string;
+    to: string;
+};
+interface FilterFieldDate extends FilterFieldBase {
+    type: "date";
+    /** Default days shown the first time "within the last N days" is picked — shown, not
+     *  written: nothing is set until the user changes it or confirms it (MP-243 A4). */
+    defaultDays?: number;
+}
+/** A declared filter field. Add a variant here (and a branch below) for a new value
+ *  picker. text/select keep their original bare-string value shape unchanged, so an
+ *  existing consumer needs no migration; every other variant's value is a small typed
+ *  object of its own (see FilterValue). */
+type FilterField = FilterFieldText | FilterFieldSelect | FilterFieldMultiSelect | FilterFieldRange | FilterFieldDate;
+/** MP-243 A7: the value shape a given declared field reads/writes, so a consumer can type
+ *  its own `filters` record precisely instead of `Record<string, unknown>` — e.g.
+ *  `Record<"schools", FilterValue<typeof schoolsField>>`. */
+type FilterValue<F extends FilterField> = F extends FilterFieldText ? string : F extends FilterFieldSelect ? string : F extends FilterFieldMultiSelect ? FilterMultiSelectValue : F extends FilterFieldRange ? FilterRangeValue : F extends FilterFieldDate ? FilterDateValue : never;
 interface FilterBarProps extends Omit<React.HTMLAttributes<HTMLSpanElement>, "onChange"> {
     /** Every filter a consumer can add. Order here is the order in the "add filter" list. */
     fields: FilterField[];
     /** Straight off useServerTable — a value of undefined/""/false reads as "not set",
-     *  same convention that hook already uses for activeFilterCount. */
+     *  same convention that hook already uses for activeFilterCount. multiSelect/range/
+     *  date values are objects instead (see isFieldSet). */
     filters: Record<string, unknown>;
-    /** Fires on every value edit. Maps 1:1 onto useServerTable's setFilter(id, value). */
+    /** Fires on every value edit. Maps 1:1 onto useServerTable's setFilter(id, value).
+     *  FilterBar only ever calls this with a COMPLETE, valid value for the field — an
+     *  emptied selection, a one-sided date range, an invalid numeric range or a cleared
+     *  bound go through onFilterRemove (or nothing) instead (MP-243 A3). */
     onFilterChange: (key: string, value: unknown) => void;
-    /** Fires when a chip's × is clicked. Maps 1:1 onto useServerTable's clearFilter(id). */
+    /** Fires when a chip's × is clicked, or when an edit leaves a field with no valid
+     *  value. Maps 1:1 onto useServerTable's clearFilter(id). */
     onFilterRemove: (key: string) => void;
     /** Which edge the "add filter" popover aligns to. Default "left" — the trigger sits
      *  at the end of a left-to-right chip row, so its menu opens under its left edge. */
@@ -1095,18 +1188,26 @@ interface FilterBarProps extends Omit<React.HTMLAttributes<HTMLSpanElement>, "on
 /**
  * FilterBar — the declarative filter system for a server-driven list.
  *
- * A consumer declares fields once (`{ key, label, type: "text" | "select", ... }`) and
- * hands this a live `filters` record plus onFilterChange/onFilterRemove — the same three
- * things useServerTable already exposes, so wiring one up is copy-paste, not glue code.
- * Every active filter renders as a Tag chip; this component holds no shadow copy of
- * filter values, only the transient "which field's popover/input is open right now" UI
- * state (`panel`), the same way SortMenu holds `open` but never sort state itself.
+ * A consumer declares fields once (`{ key, label, type, ... }`) and hands this a live
+ * `filters` record plus onFilterChange/onFilterRemove — the same three things
+ * useServerTable already exposes, so wiring one up is copy-paste, not glue code. Every
+ * active filter renders as a Tag chip; this component holds no shadow copy of filter
+ * values, only the transient "which field's popover/input is open right now" UI state
+ * (`panel`), the same way SortMenu holds `open` but never sort state itself.
+ *
+ * Every floating surface — a field's edit panel and the "add filter" menu — is a real
+ * Popover (or Menu-in-a-Popover) from this kit's own actions module (MP-243 A5): viewport
+ * clamping, nested-layer handling, Escape, and focus-return-to-the-chip all come from
+ * there, so FilterBar itself runs no document-level dismissal listener of its own. Only
+ * the text field's inline input manages its own dismissal (blur/Enter/Escape), since it
+ * isn't a floating panel at all.
  *
- * Visual/interaction language is deliberately identical to SortMenu: a secondary Button
- * trigger, a `fd-view-enter` panel positioned with `top: calc(100% + 6px)`, the same
- * click-outside/Escape wiring, and the same `fd-stack`/`fd-row`/`fd-overline`/`fd-muted`/
- * `fd-body-sm` utility classes — so this reads as built by the same hand, not a new
- * import from elsewhere.
+ * MP-243 adds three variants on top of the original text/select, for audiences too big or
+ * too shaped for a single free-text box or a short dropdown: multiSelect (searchable, sync
+ * or async, with an optional paste-a-list mode for the same value), range (numeric
+ * min/max), and date ("within the last N days" or "between two dates"). text/select are
+ * unchanged and keep their bare-string value shape, so an existing consumer needs no
+ * migration.
  */
 declare function FilterBar({ fields, filters, onFilterChange, onFilterRemove, align, className, ...rest }: FilterBarProps): React.JSX.Element;
 
@@ -2112,7 +2213,10 @@ interface NumberInputProps {
     /** Thousands-format the display when not editing. Default true. */
     format?: boolean;
     value?: number | string;
-    /** Called with {target:{value}} where value is a number. */
+    /** Called with {target:{value}} where value is a number — or `undefined` once the
+     *  field is cleared to empty. A cleared field is "no value", never `0`: the caller
+     *  (e.g. FilterBar's range/date panels) tells an unset bound apart from a typed
+     *  zero by this, not by testing for `0` itself. */
     onChange?: (e: any) => void;
     placeholder?: string;
     style?: any;
@@ -4540,4 +4644,4 @@ declare function formatDocumentTitle(routeTitle: string | undefined | null, appN
  */
 declare function useDocumentTitle(routeTitle: string | undefined | null, appName: string): void;
 
-export { AccountMenu, type AccountMenuLink, type AccountMenuProps, AgentChatPanel, type AgentChatPanelProps, AnchoredPopover, type AnchoredPopoverProps, AnimNum, type AnimNumProps, ApiSpecBrowser, type ApiSpecBrowserProps, type AppEntry, AppShell, type AppShellProps, AppSwitcher, type AppSwitcherProps, AppearanceMenu, type AppearanceMenuProps, type AppearancePrefs, type AppearanceStore, type AppearanceStoreOptions, type Attachment, Avatar, type AvatarProps, AvatarStack, type AvatarStackProps, Badge, type BadgeProps, Banner, type BannerProps, type BannerTone, BarList, type BarListProps, type BarListRow, BudgetReallocator, type BudgetReallocatorProps, Button, type ButtonProps, CHANNELS, CHANNEL_WEIGHTS, CHAT_UNAVAILABLE, Calendar, type CalendarProps, Card, 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, Collapsible, type CollapsibleProps, ComingSoon, type ComingSoonProps, type ContextUsage, type CreateVersionStoreOptions, CsiBadge, type CsiBadgeProps, CsiHero, type CsiHeroProps, CsiMeter, type CsiMeterProps, DEFAULT_PREFS, DEFAULT_STORAGE_KEY, DataTable, type DataTableColumn, type DataTableProps, DatePicker, type DatePickerProps, type DemoSessionControls, DemoSessionProvider, type DeviceSession, DiffBlock, type DiffBlockProps, DonutChart, type DonutChartProps, type DonutSegment, Drawer, type DrawerProps, Dropzone, DropzoneKit, type DropzoneProps, ENTITY_ROW_METRIC_WIDTH, type EditorTrigger, EmptyState, type EmptyStateProps, type EndpointSpec, EntityRow, type EntityRowAction, type EntityRowContent, type EntityRowMetric, EntityRowMetrics, type EntityRowMetricsProps, type EntityRowProps, FILE_VIEWER_CSV_ROW_LIMIT, FILE_VIEWER_TEXT_LIMIT, FeatureGate, type FeatureGateProps, type FeatureStatus, FileBrowser, type FileBrowserFile, type FileBrowserFolder, type FileBrowserPermissions, type FileBrowserProps, FileChip, type FileChipProps, FileGrid, type FileGridProps, FileKit, FilePickButton, type FilePickButtonProps, type FileRejection, FileStrip, type FileStripProps, FileTile, type FileTileProps, type FileUploadHandler, FileViewer, type FileViewerProps, FilterBar, type FilterBarProps, type FilterField, type FilterFieldOption, type FilterFieldSelect, type FilterFieldText, Flag$1 as Flag, type FlagExplanation, type FlagProps, FlytedeskBrand, type FlytedeskBrandProps, FlytedeskMark, type FlytedeskMarkProps, FormatEta, FunnelChart, type FunnelChartProps, type FunnelStep, Gate, 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 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, POPOVER_BODY_MIN, type Packet, PacketCard, type PacketCardProps, type PacketSchema, type Pager, Pagination, type PaginationProps, PermissionDenied, type PermissionDeniedProps, type PermissionGroup, PermissionHint, type PermissionItem, type Phase, type PhaseStatus, PhasedProgress, type PhasedProgressProps, type Placement, type PollOptions, Popover, type PopoverProps, type PreferenceCriterion, PreferenceMeter, type PreferenceMeterProps, type ProfileFieldDef, type ProfileFieldType, type ProfileNotificationDef, ProfilePage, type ProfilePageProps, ProgressBar, type ProgressBarProps, QueryKit, type QueuedTurn, QuotaRow, type QuotaRowProps, Radio, type RadioProps, RangeSlider, type RangeSliderProps, RelativeTime, type RelativeTimeProps, type RoadmapItem, type RoadmapResult, RoadmapTimeline, type RoadmapTimelineProps, type Role, RunActions, type RunActionsProps, type RunConfig, RuntimeKit, type RuntimeSummary, SaturationDistribution, type SaturationDistributionCampus, type SaturationDistributionProps, ScoreMeter, type ScoreMeterProps, ScreenHead, type ScreenHeadProps, SearchField, type SearchFieldProps, SegmentedControl, type SegmentedControlProps, SegmentedMeter, type SegmentedMeterProps, Select, type SelectOption, type SelectProps, type SendMessageResult, type ServerTable, type Session, type SessionContextValue, type Flag as SessionFlag, SessionKit, SessionProvider, type SessionProviderProps, type SessionRole, type SessionStats, type SessionUser, SidebarNav, type SidebarNavItem, type SidebarNavProps, type SignInContinueAs, SignInPage, type SignInPageProps, Skeleton, type SkeletonProps, SkeletonText, type SkeletonTextProps, type SlashCommand, Slider, type SliderProps, SortMenu, type SortMenuField, type SortMenuProps, type SpecModule, Spinner, type SpinnerProps, StatTile, type StatTileProps, type Step, StepList, type StepListProps, type StreamHandlers, type Suggestion, SurroundSound, type SurroundSoundProps, Switch, type SwitchProps, type TableQuery, Tabs, type TabsProps, Tag, type TagProps, TestModeBar, type TestModeBarProps, type TextScale, Textarea, type TextareaProps, type ThemeMode, ThinkingBlock, type ThinkingBlockProps, type ThreadSummary, TimePicker, type TimePickerProps, Toast, type ToastProps, Tooltip, type TooltipProps, Topbar, type TopbarProps, TranscriptKit, TransferList, type TransferListProps, type TransferListSide, type TransferListSideProps, TrendChart, type TrendChartProps, type TrendSeries, type UsageLimit, UseFeatureStatus, type UseResponsiveRailOptions, type UseResponsiveRailResult, UseRuntimeMode, type UseServerTableOptions, type User, VIRTUAL_LIST_BUFFER_ROWS, VIRTUAL_LIST_ROW_GAP, type VersionRecord, type VersionStore, VirtualList, type VirtualListProps, type VirtualLoadedBand, type VirtualWindow, type VoiceHandler, acceptMatches, anyOfFilter, applyPrefs, channelWeightOf, computeNeedMore, computeVirtualWindow, createLocalStorageAppearanceStore, createVersionStore, eqFilter, extensionOf, extractClipboardFiles, filterFiles, formatAbsolute, formatBytes, formatClock, formatDocumentTitle, formatDuration, formatEta, formatRelative, groupMessages, hasModifier, iconForMime, importanceLevel, importanceTokens, installFlytedeskFavicon, isImage, isSystemMessage, jobBucket, languageLabel, loadPrefs, markdownToText, meterFormats, modifierLabel, parseDelimited, pastedTextName, pluralizeUnit, preferenceScore, preferenceSegments, rangeFilter, resolveTheme, revokeAttachment, savePrefs, toAttachment, tokenize, useAppearancePrefs, useChatEngine, useDocumentTitle, useFeatureStatus, useFocusTrap, usePopoverPosition, useResponsiveRail, useRuntimeMode, useServerTable, useSessionContext, useStagedFiles, visibleMessages };
+export { AccountMenu, type AccountMenuLink, type AccountMenuProps, AgentChatPanel, type AgentChatPanelProps, AnchoredPopover, type AnchoredPopoverProps, AnimNum, type AnimNumProps, ApiSpecBrowser, type ApiSpecBrowserProps, type AppEntry, AppShell, type AppShellProps, AppSwitcher, type AppSwitcherProps, AppearanceMenu, type AppearanceMenuProps, type AppearancePrefs, 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, Calendar, type CalendarProps, Card, 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, Collapsible, type CollapsibleProps, ComingSoon, type ComingSoonProps, type ContextUsage, type CreateVersionStoreOptions, CsiBadge, type CsiBadgeProps, CsiHero, type CsiHeroProps, CsiMeter, type CsiMeterProps, DEFAULT_PREFS, DEFAULT_STORAGE_KEY, DataTable, type DataTableColumn, type DataTableProps, DatePicker, type DatePickerProps, type DemoSessionControls, DemoSessionProvider, type DeviceSession, DiffBlock, type DiffBlockProps, DonutChart, type DonutChartProps, type DonutSegment, Drawer, type DrawerProps, Dropzone, DropzoneKit, type DropzoneProps, ENTITY_ROW_METRIC_WIDTH, type EditorTrigger, EmptyState, type EmptyStateProps, type EndpointSpec, EntityRow, type EntityRowAction, type EntityRowContent, type EntityRowMetric, EntityRowMetrics, type EntityRowMetricsProps, type EntityRowProps, FILE_VIEWER_CSV_ROW_LIMIT, FILE_VIEWER_TEXT_LIMIT, FeatureGate, type FeatureGateProps, type FeatureStatus, FileBrowser, type FileBrowserFile, type FileBrowserFolder, type FileBrowserPermissions, type FileBrowserProps, FileChip, type FileChipProps, FileGrid, type FileGridProps, FileKit, FilePickButton, type FilePickButtonProps, type FileRejection, FileStrip, type FileStripProps, FileTile, type FileTileProps, type FileUploadHandler, FileViewer, type FileViewerProps, FilterBar, type FilterBarProps, type FilterDateValue, type FilterField, type FilterFieldDate, type FilterFieldMultiSelect, type FilterFieldOption, type FilterFieldRange, type FilterFieldSelect, type FilterFieldText, type FilterMultiSelectValue, type FilterOperator, type FilterRangeValue, type FilterResolveMatch, type FilterResolveResult, type FilterValue, Flag$1 as Flag, type FlagExplanation, type FlagProps, FlytedeskBrand, type FlytedeskBrandProps, FlytedeskMark, type FlytedeskMarkProps, FormatEta, FunnelChart, type FunnelChartProps, type FunnelStep, Gate, 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 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, POPOVER_BODY_MIN, type Packet, PacketCard, type PacketCardProps, type PacketSchema, type Pager, Pagination, type PaginationProps, PermissionDenied, type PermissionDeniedProps, type PermissionGroup, PermissionHint, type PermissionItem, type Phase, type PhaseStatus, PhasedProgress, type PhasedProgressProps, type Placement, type PollOptions, Popover, type PopoverProps, type PreferenceCriterion, PreferenceMeter, type PreferenceMeterProps, type ProfileFieldDef, type ProfileFieldType, type ProfileNotificationDef, ProfilePage, type ProfilePageProps, ProgressBar, type ProgressBarProps, QueryKit, type QueuedTurn, QuotaRow, type QuotaRowProps, Radio, type RadioProps, RangeSlider, type RangeSliderProps, RelativeTime, type RelativeTimeProps, type RoadmapItem, type RoadmapResult, RoadmapTimeline, type RoadmapTimelineProps, type Role, RunActions, type RunActionsProps, type RunConfig, RuntimeKit, type RuntimeSummary, SaturationDistribution, type SaturationDistributionCampus, type SaturationDistributionProps, ScoreMeter, type ScoreMeterProps, ScreenHead, type ScreenHeadProps, SearchField, type SearchFieldProps, SegmentedControl, type SegmentedControlProps, SegmentedMeter, type SegmentedMeterProps, Select, type SelectOption, type SelectProps, type SendMessageResult, type ServerTable, type Session, type SessionContextValue, type Flag as SessionFlag, SessionKit, SessionProvider, type SessionProviderProps, type SessionRole, type SessionStats, type SessionUser, SidebarNav, type SidebarNavItem, type SidebarNavProps, type SignInContinueAs, SignInPage, type SignInPageProps, Skeleton, type SkeletonProps, SkeletonText, type SkeletonTextProps, type SlashCommand, Slider, type SliderProps, SortMenu, type SortMenuField, type SortMenuProps, type SpecModule, Spinner, type SpinnerProps, StatTile, type StatTileProps, type Step, StepList, type StepListProps, type StreamHandlers, type Suggestion, SurroundSound, type SurroundSoundProps, Switch, type SwitchProps, type TableQuery, Tabs, type TabsProps, Tag, type TagProps, TestModeBar, type TestModeBarProps, type TextScale, Textarea, type TextareaProps, type ThemeMode, ThinkingBlock, type ThinkingBlockProps, type ThreadSummary, TimePicker, type TimePickerProps, Toast, type ToastProps, Tooltip, type TooltipProps, Topbar, type TopbarProps, TranscriptKit, TransferList, type TransferListProps, type TransferListSide, type TransferListSideProps, TrendChart, type TrendChartProps, type TrendSeries, type UsageLimit, UseFeatureStatus, type UseResponsiveRailOptions, type UseResponsiveRailResult, UseRuntimeMode, type UseServerTableOptions, type User, VIRTUAL_LIST_BUFFER_ROWS, VIRTUAL_LIST_ROW_GAP, type VersionRecord, type VersionStore, VirtualList, type VirtualListProps, type VirtualLoadedBand, type VirtualWindow, type VoiceHandler, acceptMatches, anyOfFilter, applyPrefs, channelWeightOf, computeNeedMore, computeVirtualWindow, createLocalStorageAppearanceStore, createVersionStore, eqFilter, extensionOf, extractClipboardFiles, filterFiles, formatAbsolute, formatBytes, formatClock, formatDocumentTitle, formatDuration, formatEta, formatRelative, groupMessages, hasModifier, iconForMime, importanceLevel, importanceTokens, installFlytedeskFavicon, isImage, isSystemMessage, jobBucket, languageLabel, loadPrefs, markdownToText, meterFormats, modifierLabel, parseDelimited, pastedTextName, pluralizeUnit, preferenceScore, preferenceSegments, rangeFilter, resolveTheme, revokeAttachment, savePrefs, toAttachment, tokenize, useAppearancePrefs, useChatEngine, useDocumentTitle, useFeatureStatus, useFocusTrap, usePopoverPosition, useResponsiveRail, useRuntimeMode, useServerTable, useSessionContext, useStagedFiles, visibleMessages };