@flytedan/flytebot-design-system 0.60.0 → 0.61.0

package/dist/index.d.cts

@@ -4713,6 +4713,32 @@ declare function DemoSessionProvider({ children }: {
     children?: React.ReactNode;
 }): React.FunctionComponentElement<SessionProviderProps>;
 
+/** Where the params live. The default is the browser's address; an app with a router
+ *  passes an adapter over the router's search params so the router stays in step. */
+interface QueryUrlAdapter {
+    read(): URLSearchParams;
+    /** Replaces the current history entry's params: a refinement of one list is not a place to go Back to. */
+    write(next: URLSearchParams): void;
+    /** Calls `onChange` with the params as they now are whenever they change (Back, Forward, or a
+     *  `write`), and returns the unsubscribe. The params are passed, never re-read through the adapter,
+     *  because an adapter built per render answers `read()` with the params of the render that built it
+     *  and may notify before React renders again. A notification of the list's own `write` carries the
+     *  params it wrote, which the hook recognises as no change. `read` is called once, when the list mounts. */
+    subscribe(onChange: (params: URLSearchParams) => void): () => void;
+}
+interface QueryUrlOptions {
+    /** Prefix for this list's params, for a screen with more than one list. */
+    scope?: string;
+    /** Defaults to the browser's address (`historyUrlAdapter`). */
+    adapter?: QueryUrlAdapter;
+}
+type QueryPaging = "page" | "keyset";
+declare const historyUrlAdapter: QueryUrlAdapter;
+/** The query the address describes: `base` (the options' defaults) for whatever it does not name. */
+declare function readQueryFromUrl(params: URLSearchParams, scope: string | undefined, base: TableQuery, paging: QueryPaging): TableQuery;
+/** A copy of `params` whose own keys describe `query`: a value equal to `base` is removed, not written. */
+declare function writeQueryToUrl(params: URLSearchParams, scope: string | undefined, query: TableQuery, base: TableQuery, paging: QueryPaging): URLSearchParams;
+
 interface TableQuery {
     /** 1-indexed. */
     page: number;
@@ -4748,6 +4774,19 @@ interface ListEnvelope<Row = unknown> {
     };
     aggregate?: Record<string, unknown>;
 }
+/** The envelope a keyset-paged list endpoint returns (`paging: "keyset"`): one page of rows and the
+ *  cursor of the next, which is how a list that cannot cheaply count its rows (a BigQuery read) pages. */
+interface KeysetEnvelope<Row = unknown> {
+    rows: Row[];
+    /** Opaque; null on the last page. Sent back as `after` to read the page that follows. */
+    next: string | null;
+    /** Every row of the match, when the endpoint can say. */
+    total?: number;
+    filter?: {
+        facets: Record<string, Record<string, number>>;
+    };
+    aggregate?: Record<string, unknown>;
+}
 interface RunConfig<Row = unknown> {
     searchKeys?: string[];
     filters?: Record<string, (row: Row, value: any) => boolean>;
@@ -4761,15 +4800,10 @@ interface RunConfig<Row = unknown> {
     };
     defaultPageSize?: number;
 }
-interface ServerTable<Row = unknown> {
+/** What a table has whichever way its endpoint pages. */
+interface ServerTableBase<Row = unknown> {
     rows: Row[];
-    pager: Pager;
-    total: number;
-    page: number;
     pageSize: number;
-    totalPages: number;
-    from: number;
-    to: number;
     facets: Record<string, Record<string, number>>;
     aggregate: Record<string, unknown>;
     query: TableQuery;
@@ -4785,23 +4819,55 @@ interface ServerTable<Row = unknown> {
     /** True while re-querying with previous rows still on screen. Pass straight to
      *  DataTable's `refreshing`, or to LoadingRegion as state="refreshing". */
     refreshing: boolean;
+    /** Why the last request failed; null while there is nothing to show. A first load that fails
+     *  leaves `rows` empty; a refresh or a `loadMore` that fails keeps the rows already on screen.
+     *  Cleared by the next request, whether `retry`, `refresh` or a change of query. */
+    error: Error | null;
+    /** Runs again what failed: the query, or the page `loadMore` was reading. */
+    retry(): void;
     activeFilterCount: number;
-    setPage(p: number): void;
     setPageSize(n: number): void;
     setQ(q: string): void;
     toggleSort(key: string): void;
     setSortKey(key: string, dir?: "asc" | "desc"): void;
-    /** Same query, unpaged — for CSV export and select-all-matching. */
-    fetchAll(): Promise<Row[]>;
     /** value may be an updater fn — REQUIRED for toggles, or two fast clicks read the same
      *  stale array and the first is lost. */
     setFilter(id: string, value: unknown | ((prev: unknown) => unknown)): void;
     clearFilter(id: string): void;
     setFilters(filters: Record<string, unknown>): void;
     clearFilters(): void;
+    /** Re-queries now, even when the query has not changed. */
     refresh(): void;
+    /** Changes the rows on screen in place, without reading again: a saved decision updating its
+     *  row. The next answer (a new query, `refresh`, `retry`) replaces them. */
+    patchRows(change: (rows: Row[]) => Row[]): void;
     queryString: string;
 }
+/** A table over a page-numbered endpoint (`ListEnvelope`): the default. */
+interface ServerTable<Row = unknown> extends ServerTableBase<Row> {
+    pager: Pager;
+    total: number;
+    page: number;
+    totalPages: number;
+    from: number;
+    to: number;
+    setPage(p: number): void;
+    /** Same query, unpaged — for CSV export and select-all-matching. */
+    fetchAll(): Promise<Row[]>;
+}
+/** A table over a cursor-paged endpoint (`KeysetEnvelope`): `paging: "keyset"`. It has no pages, so no
+ *  pager, `setPage` or `fetchAll`; it has the cursor's `loadMore`. */
+interface KeysetServerTable<Row = unknown> extends ServerTableBase<Row> {
+    /** Every row of the match, when the endpoint said; null when it cannot count them. */
+    total: number | null;
+    /** Another page follows the last one loaded. */
+    hasMore: boolean;
+    /** The next page is being read (the rows stay as they are, so this is not `refreshing`). */
+    loadingMore: boolean;
+    /** Reads the page after the last one loaded and appends it. A no-op while a read is in flight, the
+     *  first page is loading, or at the end. */
+    loadMore(): void;
+}
 interface UseServerTableOptions {
     endpoint: string;
     params?: Record<string, unknown>;
@@ -4811,12 +4877,27 @@ interface UseServerTableOptions {
     /** Opts into durable rows-per-page and default sort. Page/search/filters are deliberately
      *  NOT persisted — they describe one task, and restoring them hides rows the user expects. */
     prefsKey?: string;
+    /** The request carries `page` and `pageSize`; the envelope is a `ListEnvelope`. */
+    paging?: "page";
+    /** Keeps the query in the address (`?q=ohio&sort=crp&page=2`), so a link reproduces the list and
+     *  Back returns to it. The address wins over `defaults`; it is written when the request is sent,
+     *  after the search debounce. Pass `{}` for the browser's own address, or `{ adapter }` over a
+     *  router's search params; `scope` prefixes the params of one list among several. */
+    url?: QueryUrlOptions;
+}
+/** For an endpoint that pages by cursor and cannot cheaply count its rows. The request carries `limit`
+ *  (the page size) and, after the first page, `after` (the cursor); the envelope is a `KeysetEnvelope`.
+ *  Any change of search, filter or sort starts again from the first page. */
+interface UseKeysetTableOptions extends Omit<UseServerTableOptions, "paging"> {
+    paging: "keyset";
 }
 declare function eqFilter<Row>(get: (row: Row) => unknown): (row: Row, value: unknown) => boolean;
 declare function anyOfFilter<Row>(get: (row: Row) => string[]): (row: Row, value: unknown) => boolean;
 declare function rangeFilter<Row>(get: (row: Row) => number): (row: Row, value: unknown) => boolean;
 type Api = {
-    request(id: string, params?: unknown): Promise<unknown>;
+    request(id: string, params?: unknown, options?: {
+        signal: AbortSignal;
+    }): Promise<unknown>;
 };
 type PrefsStore = {
     getTable(key: string): any;
@@ -4827,8 +4908,10 @@ declare global {
         PlannerPrefs?: PrefsStore;
     }
 }
-/** React hook — the only way a screen should talk to a list endpoint. */
-declare function useServerTable<Row = unknown>({ endpoint, params, defaults, deps, prefsKey }: UseServerTableOptions): ServerTable<Row>;
+/** React hook — the only way a screen should talk to a list endpoint. Page-numbered by default;
+ *  `paging: "keyset"` returns the cursor-paged table (`KeysetServerTable`). */
+declare function useServerTable<Row = unknown>(options: UseServerTableOptions): ServerTable<Row>;
+declare function useServerTable<Row = unknown>(options: UseKeysetTableOptions): KeysetServerTable<Row>;
 declare const QueryKit: {
     DEFAULTS: TableQuery;
     /** Register the app's simulated (or real) transport: an object with .request(id, params). */
@@ -5151,4 +5234,4 @@ declare function CornerStackPortal({ slot, children }: {
     children?: React.ReactNode;
 }): React.ReactPortal | null;
 
-export { AccountMenu, type AccountMenuLink, type AccountMenuProps, AgentChatPanel, type AgentChatPanelProps, AnchoredPopover, type AnchoredPopoverProps, AnimNum, type AnimNumProps, ApiSpecBrowser, type ApiSpecBrowserProps, type AppEntry, AppShell, type AppShellProps, AppSwitcher, type AppSwitcherProps, AppearanceMenu, type AppearanceMenuProps, type AppearancePrefs, AppearanceProvider, type AppearanceProviderProps, type AppearanceStore, type AppearanceStoreOptions, type Attachment, Avatar, type AvatarProps, AvatarStack, type AvatarStackProps, Badge, type BadgeProps, Banner, type BannerProps, type BannerTone, BarList, type BarListProps, type BarListRow, BudgetReallocator, type BudgetReallocatorProps, Button, type ButtonProps, CHANNELS, CHANNEL_WEIGHTS, CHAT_UNAVAILABLE, COPIED_FEEDBACK_MS, CORNER_STACK_INSET_PROPERTY, Calendar, type CalendarProps, Card, CardGrid, type CardGridProps, type CardProps, CardRow, type CardRowProps, ChannelContribution, type ChannelContributionChannel, type ChannelContributionProps, ChannelMeta, type ChannelMetaRecord, ChannelTag, type ChannelTagProps, ChannelWeightOf, type ChatAdapter, ChatComposer, type ChatComposerProps, type ChatEngine, type ChatEngineOptions, ChatKit, type ChatMessage, type ChatRenderContext, ChatSessionBar, type ChatSessionBarProps, ChatTranscript, type ChatTranscriptProps, ChatTurn, type ChatTurnProps, Checkbox, type CheckboxProps, type Citation, Citations, type CitationsProps, Clamp, type ClampProps, ClockFace, type ClockFaceProps, CodeBlock, type CodeBlockProps, CodeEditor, type CodeEditorDiagnostic, type CodeEditorProps, Collapsible, type CollapsibleProps, ComingSoon, type ComingSoonProps, type ContextUsage, CornerStackPortal, type CornerStackSlot, type CreateVersionStoreOptions, CsiBadge, type CsiBadgeProps, CsiHero, type CsiHeroProps, CsiMeter, type CsiMeterProps, DEFAULT_PREFS, DEFAULT_STORAGE_KEY, DEFAULT_TOAST_DURATION_MS, DataTable, type DataTableColumn, type DataTablePhoneRole, type DataTableProps, DatePicker, type DatePickerProps, type DemoSessionControls, DemoSessionProvider, type DeviceSession, DiffBlock, type DiffBlockProps, DonutChart, type DonutChartProps, type DonutSegment, Drawer, type DrawerProps, Dropzone, DropzoneKit, type DropzoneProps, ENTITY_ROW_METRIC_WIDTH, type EditorTrigger, EmptyState, type EmptyStateProps, type EndpointSpec, EntityRow, type EntityRowAction, type EntityRowContent, type EntityRowMetric, EntityRowMetrics, type EntityRowMetricsProps, type EntityRowProps, FILE_VIEWER_CSV_ROW_LIMIT, FILE_VIEWER_TEXT_LIMIT, type Fact, FactList, type FactListProps, FeatureGate, type FeatureGateProps, type FeatureStatus, FileBrowser, type FileBrowserFile, type FileBrowserFolder, type FileBrowserPermissions, type FileBrowserProps, FileChip, type FileChipProps, FileGrid, type FileGridProps, FileKit, FilePickButton, type FilePickButtonProps, type FileRejection, FileStrip, type FileStripProps, FileTile, type FileTileProps, type FileUploadHandler, FileViewer, type FileViewerProps, FilterBar, type FilterBarProps, type FilterDateValue, type FilterField, type FilterFieldDate, type FilterFieldMultiSelect, type FilterFieldOption, type FilterFieldRange, type FilterFieldSelect, type FilterFieldText, type FilterMultiSelectValue, type FilterOperator, type FilterRangeValue, type FilterResolveMatch, type FilterResolveResult, type FilterValidation, type FilterValue, Flag$1 as Flag, type FlagExplanation, type FlagProps, FlytedeskBrand, type FlytedeskBrandProps, FlytedeskMark, type FlytedeskMarkProps, FormatEta, FunnelChart, type FunnelChartProps, type FunnelStep, Gate, GatePending, type GatePendingProps, type GateProps, IMPORTANCE_LEVELS, IconButton, type IconButtonProps, type ImportanceLevel, type ImportanceLevelId, ImportanceTag, type ImportanceTagProps, type ImportanceTokens, Input, type InputProps, type Job, type JobAction, type JobCardStatus, type JobStatus, JobTray, type JobTrayProps, Json, KeyHint, type KeyHintProps, LAYER_STEP, type ListEnvelope, LoadingRegion, type LoadingRegionProps, Markdown, MarkdownEditor, type MarkdownEditorHandle, type MarkdownEditorProps, MarkdownInline, type MarkdownProps, type MentionSource, Menu, MenuButton, type MenuButtonProps, type MenuItem, type MenuProps, MessageBody, type MessageBodyProps, type MessageGroup, Meter, type MeterProps, type MeterSegment, type MeterSegmentInput, MixGap, type MixGapProps, type MixGapRow, MockJobKit, type MockJobStatus, Modal, type ModalProps, ModeSwitch, type ModeSwitchProps, type Model, ModelControls, type ModelControlsProps, NumberInput, type NumberInputProps, OVERLAY_CEILING, POPOVER_BODY_MIN, type Packet, PacketCard, type PacketCardProps, type PacketSchema, type Pager, Pagination, type PaginationProps, PermissionDenied, type PermissionDeniedProps, type PermissionGroup, PermissionHint, type PermissionItem, type Phase, type PhaseStatus, PhasedProgress, type PhasedProgressProps, type Placement, type PollOptions, Popover, type PopoverProps, type PreferenceCriterion, PreferenceMeter, type PreferenceMeterProps, type ProfileFieldDef, type ProfileFieldType, type ProfileNotificationDef, ProfilePage, type ProfilePageProps, ProgressBar, type ProgressBarProps, QueryKit, type QueuedTurn, QuotaRow, type QuotaRowProps, ROOT_STEP, Radio, type RadioProps, RangeSlider, type RangeSliderProps, RelativeTime, type RelativeTimeProps, type RoadmapItem, type RoadmapResult, RoadmapTimeline, type RoadmapTimelineProps, type Role, RunActions, type RunActionsProps, type RunConfig, RuntimeKit, type RuntimeSummary, SaturationDistribution, type SaturationDistributionCampus, type SaturationDistributionProps, ScoreMeter, type ScoreMeterProps, ScreenHead, type ScreenHeadProps, SearchField, type SearchFieldProps, SegmentedControl, type SegmentedControlProps, SegmentedMeter, type SegmentedMeterProps, Select, type SelectOption, type SelectProps, type SendMessageResult, type ServerTable, type Session, type SessionContextValue, type Flag as SessionFlag, SessionKit, SessionProvider, type SessionProviderProps, type SessionRole, SessionScreen, type SessionScreenKind, type SessionScreenProps, type SessionStats, type SessionUser, SidebarNav, type SidebarNavItem, type SidebarNavProps, Skeleton, type SkeletonProps, SkeletonText, type SkeletonTextProps, type SlashCommand, Slider, type SliderProps, type SortDirection, type SortEntry, SortMenu, type SortMenuField, type SortMenuProps, type SpecModule, Spinner, type SpinnerProps, type StackedLayer, type StackedLayerOptions, StackedLayerProvider, StatTile, type StatTileProps, type Step, StepList, type StepListProps, type StreamHandlers, type Suggestion, SurroundSound, type SurroundSoundProps, Switch, type SwitchProps, type TabItem, type TableQuery, Tabs, type TabsProps, Tag, type TagProps, TestModeBar, type TestModeBarProps, type TextScale, Textarea, type TextareaProps, type ThemeMode, ThinkingBlock, type ThinkingBlockProps, type ThreadSummary, TimePicker, type TimePickerProps, Toast, type ToastApi, type ToastOptions, type ToastProps, ToastProvider, Tooltip, type TooltipProps, Topbar, type TopbarProps, TranscriptKit, TransferList, type TransferListProps, type TransferListSide, type TransferListSideProps, TrendChart, type TrendChartProps, type TrendSeries, type UsageLimit, UseFeatureStatus, type UseResponsiveRailOptions, type UseResponsiveRailResult, UseRuntimeMode, type UseServerTableOptions, type User, VIRTUAL_LIST_BUFFER_ROWS, VIRTUAL_LIST_ROW_GAP, type VersionRecord, type VersionStore, VirtualList, type VirtualListProps, type VirtualLoadedBand, type VirtualWindow, type VoiceHandler, __resetLayerStackForTests, acceptMatches, anyOfFilter, applyAppearance, applyPrefs, channelWeightOf, computeNeedMore, computeVirtualWindow, copyToClipboard, createLocalStorageAppearanceStore, createVersionStore, eqFilter, extensionOf, extractClipboardFiles, filterFiles, formatAbsolute, formatBytes, formatClock, formatDocumentTitle, formatDuration, formatEta, formatRelative, groupMessages, hasModifier, iconForMime, importanceLevel, importanceTokens, installFlytedeskFavicon, isImage, isSystemMessage, isWithinLayerTree, jobBucket, languageLabel, loadPrefs, markdownToText, meterFormats, modifierLabel, parseDelimited, pastedTextName, pluralizeUnit, preferenceScore, preferenceSegments, rangeFilter, resolveTheme, revokeAttachment, savePrefs, toAttachment, tokenize, useAppearancePrefs, useAppearanceStore, useChatEngine, useCopyToClipboard, useCornerStackSlot, useDocumentTitle, useFeatureStatus, useLayerZIndex, usePopoverPosition, useResponsiveRail, useRuntimeMode, useServerTable, useSessionContext, useStackedLayer, useStagedFiles, useToast, validateFilterValue, visibleMessages, watchAppearance };
+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 };

package/dist/index.d.ts

@@ -4713,6 +4713,32 @@ declare function DemoSessionProvider({ children }: {
     children?: React.ReactNode;
 }): React.FunctionComponentElement<SessionProviderProps>;
 
+/** Where the params live. The default is the browser's address; an app with a router
+ *  passes an adapter over the router's search params so the router stays in step. */
+interface QueryUrlAdapter {
+    read(): URLSearchParams;
+    /** Replaces the current history entry's params: a refinement of one list is not a place to go Back to. */
+    write(next: URLSearchParams): void;
+    /** Calls `onChange` with the params as they now are whenever they change (Back, Forward, or a
+     *  `write`), and returns the unsubscribe. The params are passed, never re-read through the adapter,
+     *  because an adapter built per render answers `read()` with the params of the render that built it
+     *  and may notify before React renders again. A notification of the list's own `write` carries the
+     *  params it wrote, which the hook recognises as no change. `read` is called once, when the list mounts. */
+    subscribe(onChange: (params: URLSearchParams) => void): () => void;
+}
+interface QueryUrlOptions {
+    /** Prefix for this list's params, for a screen with more than one list. */
+    scope?: string;
+    /** Defaults to the browser's address (`historyUrlAdapter`). */
+    adapter?: QueryUrlAdapter;
+}
+type QueryPaging = "page" | "keyset";
+declare const historyUrlAdapter: QueryUrlAdapter;
+/** The query the address describes: `base` (the options' defaults) for whatever it does not name. */
+declare function readQueryFromUrl(params: URLSearchParams, scope: string | undefined, base: TableQuery, paging: QueryPaging): TableQuery;
+/** A copy of `params` whose own keys describe `query`: a value equal to `base` is removed, not written. */
+declare function writeQueryToUrl(params: URLSearchParams, scope: string | undefined, query: TableQuery, base: TableQuery, paging: QueryPaging): URLSearchParams;
+
 interface TableQuery {
     /** 1-indexed. */
     page: number;
@@ -4748,6 +4774,19 @@ interface ListEnvelope<Row = unknown> {
     };
     aggregate?: Record<string, unknown>;
 }
+/** The envelope a keyset-paged list endpoint returns (`paging: "keyset"`): one page of rows and the
+ *  cursor of the next, which is how a list that cannot cheaply count its rows (a BigQuery read) pages. */
+interface KeysetEnvelope<Row = unknown> {
+    rows: Row[];
+    /** Opaque; null on the last page. Sent back as `after` to read the page that follows. */
+    next: string | null;
+    /** Every row of the match, when the endpoint can say. */
+    total?: number;
+    filter?: {
+        facets: Record<string, Record<string, number>>;
+    };
+    aggregate?: Record<string, unknown>;
+}
 interface RunConfig<Row = unknown> {
     searchKeys?: string[];
     filters?: Record<string, (row: Row, value: any) => boolean>;
@@ -4761,15 +4800,10 @@ interface RunConfig<Row = unknown> {
     };
     defaultPageSize?: number;
 }
-interface ServerTable<Row = unknown> {
+/** What a table has whichever way its endpoint pages. */
+interface ServerTableBase<Row = unknown> {
     rows: Row[];
-    pager: Pager;
-    total: number;
-    page: number;
     pageSize: number;
-    totalPages: number;
-    from: number;
-    to: number;
     facets: Record<string, Record<string, number>>;
     aggregate: Record<string, unknown>;
     query: TableQuery;
@@ -4785,23 +4819,55 @@ interface ServerTable<Row = unknown> {
     /** True while re-querying with previous rows still on screen. Pass straight to
      *  DataTable's `refreshing`, or to LoadingRegion as state="refreshing". */
     refreshing: boolean;
+    /** Why the last request failed; null while there is nothing to show. A first load that fails
+     *  leaves `rows` empty; a refresh or a `loadMore` that fails keeps the rows already on screen.
+     *  Cleared by the next request, whether `retry`, `refresh` or a change of query. */
+    error: Error | null;
+    /** Runs again what failed: the query, or the page `loadMore` was reading. */
+    retry(): void;
     activeFilterCount: number;
-    setPage(p: number): void;
     setPageSize(n: number): void;
     setQ(q: string): void;
     toggleSort(key: string): void;
     setSortKey(key: string, dir?: "asc" | "desc"): void;
-    /** Same query, unpaged — for CSV export and select-all-matching. */
-    fetchAll(): Promise<Row[]>;
     /** value may be an updater fn — REQUIRED for toggles, or two fast clicks read the same
      *  stale array and the first is lost. */
     setFilter(id: string, value: unknown | ((prev: unknown) => unknown)): void;
     clearFilter(id: string): void;
     setFilters(filters: Record<string, unknown>): void;
     clearFilters(): void;
+    /** Re-queries now, even when the query has not changed. */
     refresh(): void;
+    /** Changes the rows on screen in place, without reading again: a saved decision updating its
+     *  row. The next answer (a new query, `refresh`, `retry`) replaces them. */
+    patchRows(change: (rows: Row[]) => Row[]): void;
     queryString: string;
 }
+/** A table over a page-numbered endpoint (`ListEnvelope`): the default. */
+interface ServerTable<Row = unknown> extends ServerTableBase<Row> {
+    pager: Pager;
+    total: number;
+    page: number;
+    totalPages: number;
+    from: number;
+    to: number;
+    setPage(p: number): void;
+    /** Same query, unpaged — for CSV export and select-all-matching. */
+    fetchAll(): Promise<Row[]>;
+}
+/** A table over a cursor-paged endpoint (`KeysetEnvelope`): `paging: "keyset"`. It has no pages, so no
+ *  pager, `setPage` or `fetchAll`; it has the cursor's `loadMore`. */
+interface KeysetServerTable<Row = unknown> extends ServerTableBase<Row> {
+    /** Every row of the match, when the endpoint said; null when it cannot count them. */
+    total: number | null;
+    /** Another page follows the last one loaded. */
+    hasMore: boolean;
+    /** The next page is being read (the rows stay as they are, so this is not `refreshing`). */
+    loadingMore: boolean;
+    /** Reads the page after the last one loaded and appends it. A no-op while a read is in flight, the
+     *  first page is loading, or at the end. */
+    loadMore(): void;
+}
 interface UseServerTableOptions {
     endpoint: string;
     params?: Record<string, unknown>;
@@ -4811,12 +4877,27 @@ interface UseServerTableOptions {
     /** Opts into durable rows-per-page and default sort. Page/search/filters are deliberately
      *  NOT persisted — they describe one task, and restoring them hides rows the user expects. */
     prefsKey?: string;
+    /** The request carries `page` and `pageSize`; the envelope is a `ListEnvelope`. */
+    paging?: "page";
+    /** Keeps the query in the address (`?q=ohio&sort=crp&page=2`), so a link reproduces the list and
+     *  Back returns to it. The address wins over `defaults`; it is written when the request is sent,
+     *  after the search debounce. Pass `{}` for the browser's own address, or `{ adapter }` over a
+     *  router's search params; `scope` prefixes the params of one list among several. */
+    url?: QueryUrlOptions;
+}
+/** For an endpoint that pages by cursor and cannot cheaply count its rows. The request carries `limit`
+ *  (the page size) and, after the first page, `after` (the cursor); the envelope is a `KeysetEnvelope`.
+ *  Any change of search, filter or sort starts again from the first page. */
+interface UseKeysetTableOptions extends Omit<UseServerTableOptions, "paging"> {
+    paging: "keyset";
 }
 declare function eqFilter<Row>(get: (row: Row) => unknown): (row: Row, value: unknown) => boolean;
 declare function anyOfFilter<Row>(get: (row: Row) => string[]): (row: Row, value: unknown) => boolean;
 declare function rangeFilter<Row>(get: (row: Row) => number): (row: Row, value: unknown) => boolean;
 type Api = {
-    request(id: string, params?: unknown): Promise<unknown>;
+    request(id: string, params?: unknown, options?: {
+        signal: AbortSignal;
+    }): Promise<unknown>;
 };
 type PrefsStore = {
     getTable(key: string): any;
@@ -4827,8 +4908,10 @@ declare global {
         PlannerPrefs?: PrefsStore;
     }
 }
-/** React hook — the only way a screen should talk to a list endpoint. */
-declare function useServerTable<Row = unknown>({ endpoint, params, defaults, deps, prefsKey }: UseServerTableOptions): ServerTable<Row>;
+/** React hook — the only way a screen should talk to a list endpoint. Page-numbered by default;
+ *  `paging: "keyset"` returns the cursor-paged table (`KeysetServerTable`). */
+declare function useServerTable<Row = unknown>(options: UseServerTableOptions): ServerTable<Row>;
+declare function useServerTable<Row = unknown>(options: UseKeysetTableOptions): KeysetServerTable<Row>;
 declare const QueryKit: {
     DEFAULTS: TableQuery;
     /** Register the app's simulated (or real) transport: an object with .request(id, params). */
@@ -5151,4 +5234,4 @@ declare function CornerStackPortal({ slot, children }: {
     children?: React.ReactNode;
 }): React.ReactPortal | null;
 
-export { AccountMenu, type AccountMenuLink, type AccountMenuProps, AgentChatPanel, type AgentChatPanelProps, AnchoredPopover, type AnchoredPopoverProps, AnimNum, type AnimNumProps, ApiSpecBrowser, type ApiSpecBrowserProps, type AppEntry, AppShell, type AppShellProps, AppSwitcher, type AppSwitcherProps, AppearanceMenu, type AppearanceMenuProps, type AppearancePrefs, AppearanceProvider, type AppearanceProviderProps, type AppearanceStore, type AppearanceStoreOptions, type Attachment, Avatar, type AvatarProps, AvatarStack, type AvatarStackProps, Badge, type BadgeProps, Banner, type BannerProps, type BannerTone, BarList, type BarListProps, type BarListRow, BudgetReallocator, type BudgetReallocatorProps, Button, type ButtonProps, CHANNELS, CHANNEL_WEIGHTS, CHAT_UNAVAILABLE, COPIED_FEEDBACK_MS, CORNER_STACK_INSET_PROPERTY, Calendar, type CalendarProps, Card, CardGrid, type CardGridProps, type CardProps, CardRow, type CardRowProps, ChannelContribution, type ChannelContributionChannel, type ChannelContributionProps, ChannelMeta, type ChannelMetaRecord, ChannelTag, type ChannelTagProps, ChannelWeightOf, type ChatAdapter, ChatComposer, type ChatComposerProps, type ChatEngine, type ChatEngineOptions, ChatKit, type ChatMessage, type ChatRenderContext, ChatSessionBar, type ChatSessionBarProps, ChatTranscript, type ChatTranscriptProps, ChatTurn, type ChatTurnProps, Checkbox, type CheckboxProps, type Citation, Citations, type CitationsProps, Clamp, type ClampProps, ClockFace, type ClockFaceProps, CodeBlock, type CodeBlockProps, CodeEditor, type CodeEditorDiagnostic, type CodeEditorProps, Collapsible, type CollapsibleProps, ComingSoon, type ComingSoonProps, type ContextUsage, CornerStackPortal, type CornerStackSlot, type CreateVersionStoreOptions, CsiBadge, type CsiBadgeProps, CsiHero, type CsiHeroProps, CsiMeter, type CsiMeterProps, DEFAULT_PREFS, DEFAULT_STORAGE_KEY, DEFAULT_TOAST_DURATION_MS, DataTable, type DataTableColumn, type DataTablePhoneRole, type DataTableProps, DatePicker, type DatePickerProps, type DemoSessionControls, DemoSessionProvider, type DeviceSession, DiffBlock, type DiffBlockProps, DonutChart, type DonutChartProps, type DonutSegment, Drawer, type DrawerProps, Dropzone, DropzoneKit, type DropzoneProps, ENTITY_ROW_METRIC_WIDTH, type EditorTrigger, EmptyState, type EmptyStateProps, type EndpointSpec, EntityRow, type EntityRowAction, type EntityRowContent, type EntityRowMetric, EntityRowMetrics, type EntityRowMetricsProps, type EntityRowProps, FILE_VIEWER_CSV_ROW_LIMIT, FILE_VIEWER_TEXT_LIMIT, type Fact, FactList, type FactListProps, FeatureGate, type FeatureGateProps, type FeatureStatus, FileBrowser, type FileBrowserFile, type FileBrowserFolder, type FileBrowserPermissions, type FileBrowserProps, FileChip, type FileChipProps, FileGrid, type FileGridProps, FileKit, FilePickButton, type FilePickButtonProps, type FileRejection, FileStrip, type FileStripProps, FileTile, type FileTileProps, type FileUploadHandler, FileViewer, type FileViewerProps, FilterBar, type FilterBarProps, type FilterDateValue, type FilterField, type FilterFieldDate, type FilterFieldMultiSelect, type FilterFieldOption, type FilterFieldRange, type FilterFieldSelect, type FilterFieldText, type FilterMultiSelectValue, type FilterOperator, type FilterRangeValue, type FilterResolveMatch, type FilterResolveResult, type FilterValidation, type FilterValue, Flag$1 as Flag, type FlagExplanation, type FlagProps, FlytedeskBrand, type FlytedeskBrandProps, FlytedeskMark, type FlytedeskMarkProps, FormatEta, FunnelChart, type FunnelChartProps, type FunnelStep, Gate, GatePending, type GatePendingProps, type GateProps, IMPORTANCE_LEVELS, IconButton, type IconButtonProps, type ImportanceLevel, type ImportanceLevelId, ImportanceTag, type ImportanceTagProps, type ImportanceTokens, Input, type InputProps, type Job, type JobAction, type JobCardStatus, type JobStatus, JobTray, type JobTrayProps, Json, KeyHint, type KeyHintProps, LAYER_STEP, type ListEnvelope, LoadingRegion, type LoadingRegionProps, Markdown, MarkdownEditor, type MarkdownEditorHandle, type MarkdownEditorProps, MarkdownInline, type MarkdownProps, type MentionSource, Menu, MenuButton, type MenuButtonProps, type MenuItem, type MenuProps, MessageBody, type MessageBodyProps, type MessageGroup, Meter, type MeterProps, type MeterSegment, type MeterSegmentInput, MixGap, type MixGapProps, type MixGapRow, MockJobKit, type MockJobStatus, Modal, type ModalProps, ModeSwitch, type ModeSwitchProps, type Model, ModelControls, type ModelControlsProps, NumberInput, type NumberInputProps, OVERLAY_CEILING, POPOVER_BODY_MIN, type Packet, PacketCard, type PacketCardProps, type PacketSchema, type Pager, Pagination, type PaginationProps, PermissionDenied, type PermissionDeniedProps, type PermissionGroup, PermissionHint, type PermissionItem, type Phase, type PhaseStatus, PhasedProgress, type PhasedProgressProps, type Placement, type PollOptions, Popover, type PopoverProps, type PreferenceCriterion, PreferenceMeter, type PreferenceMeterProps, type ProfileFieldDef, type ProfileFieldType, type ProfileNotificationDef, ProfilePage, type ProfilePageProps, ProgressBar, type ProgressBarProps, QueryKit, type QueuedTurn, QuotaRow, type QuotaRowProps, ROOT_STEP, Radio, type RadioProps, RangeSlider, type RangeSliderProps, RelativeTime, type RelativeTimeProps, type RoadmapItem, type RoadmapResult, RoadmapTimeline, type RoadmapTimelineProps, type Role, RunActions, type RunActionsProps, type RunConfig, RuntimeKit, type RuntimeSummary, SaturationDistribution, type SaturationDistributionCampus, type SaturationDistributionProps, ScoreMeter, type ScoreMeterProps, ScreenHead, type ScreenHeadProps, SearchField, type SearchFieldProps, SegmentedControl, type SegmentedControlProps, SegmentedMeter, type SegmentedMeterProps, Select, type SelectOption, type SelectProps, type SendMessageResult, type ServerTable, type Session, type SessionContextValue, type Flag as SessionFlag, SessionKit, SessionProvider, type SessionProviderProps, type SessionRole, SessionScreen, type SessionScreenKind, type SessionScreenProps, type SessionStats, type SessionUser, SidebarNav, type SidebarNavItem, type SidebarNavProps, Skeleton, type SkeletonProps, SkeletonText, type SkeletonTextProps, type SlashCommand, Slider, type SliderProps, type SortDirection, type SortEntry, SortMenu, type SortMenuField, type SortMenuProps, type SpecModule, Spinner, type SpinnerProps, type StackedLayer, type StackedLayerOptions, StackedLayerProvider, StatTile, type StatTileProps, type Step, StepList, type StepListProps, type StreamHandlers, type Suggestion, SurroundSound, type SurroundSoundProps, Switch, type SwitchProps, type TabItem, type TableQuery, Tabs, type TabsProps, Tag, type TagProps, TestModeBar, type TestModeBarProps, type TextScale, Textarea, type TextareaProps, type ThemeMode, ThinkingBlock, type ThinkingBlockProps, type ThreadSummary, TimePicker, type TimePickerProps, Toast, type ToastApi, type ToastOptions, type ToastProps, ToastProvider, Tooltip, type TooltipProps, Topbar, type TopbarProps, TranscriptKit, TransferList, type TransferListProps, type TransferListSide, type TransferListSideProps, TrendChart, type TrendChartProps, type TrendSeries, type UsageLimit, UseFeatureStatus, type UseResponsiveRailOptions, type UseResponsiveRailResult, UseRuntimeMode, type UseServerTableOptions, type User, VIRTUAL_LIST_BUFFER_ROWS, VIRTUAL_LIST_ROW_GAP, type VersionRecord, type VersionStore, VirtualList, type VirtualListProps, type VirtualLoadedBand, type VirtualWindow, type VoiceHandler, __resetLayerStackForTests, acceptMatches, anyOfFilter, applyAppearance, applyPrefs, channelWeightOf, computeNeedMore, computeVirtualWindow, copyToClipboard, createLocalStorageAppearanceStore, createVersionStore, eqFilter, extensionOf, extractClipboardFiles, filterFiles, formatAbsolute, formatBytes, formatClock, formatDocumentTitle, formatDuration, formatEta, formatRelative, groupMessages, hasModifier, iconForMime, importanceLevel, importanceTokens, installFlytedeskFavicon, isImage, isSystemMessage, isWithinLayerTree, jobBucket, languageLabel, loadPrefs, markdownToText, meterFormats, modifierLabel, parseDelimited, pastedTextName, pluralizeUnit, preferenceScore, preferenceSegments, rangeFilter, resolveTheme, revokeAttachment, savePrefs, toAttachment, tokenize, useAppearancePrefs, useAppearanceStore, useChatEngine, useCopyToClipboard, useCornerStackSlot, useDocumentTitle, useFeatureStatus, useLayerZIndex, usePopoverPosition, useResponsiveRail, useRuntimeMode, useServerTable, useSessionContext, useStackedLayer, useStagedFiles, useToast, validateFilterValue, visibleMessages, watchAppearance };
+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 };