@flytedan/flytebot-design-system 0.71.7 → 0.73.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/index.cjs +214 -147
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +64 -15
- package/dist/index.d.ts +64 -15
- package/dist/index.js +212 -147
- package/dist/index.js.map +1 -1
- package/package.json +3 -3
- package/styles/components.css +10 -5
package/dist/index.d.cts
CHANGED
|
@@ -363,10 +363,18 @@ interface DrawerProps {
|
|
|
363
363
|
onClose?: () => void;
|
|
364
364
|
/** Plain content, or a render function receiving `close` — call it to trigger the closing animation before onClose fires. */
|
|
365
365
|
footer?: React.ReactNode | ((close: () => void) => React.ReactNode);
|
|
366
|
-
|
|
366
|
+
/** The drawer's content owns the whole panel: no header bar and no body padding, and the panel is the
|
|
367
|
+
* full viewport height. For content that already has its own header and close control (a chat panel).
|
|
368
|
+
* `title` is then only the dialog's accessible name; Escape, scrim click and focus handling are unchanged. */
|
|
369
|
+
bare?: boolean;
|
|
370
|
+
/** The dialog's accessible name. A bare Drawer has no header to name it, so it takes `label`, else `title` when that is
|
|
371
|
+
* a string; a bare Drawer with neither (a node `title`, no `label`) is an unnamed dialog and warns in development. */
|
|
372
|
+
label?: string;
|
|
373
|
+
/** Plain content, or (like `footer`) a render function receiving `close`. */
|
|
374
|
+
children?: React.ReactNode | ((close: () => void) => React.ReactNode);
|
|
367
375
|
className?: string;
|
|
368
376
|
}
|
|
369
|
-
declare function Drawer({ open, title, onClose, footer, children, className, ...rest }: DrawerProps): React.ReactPortal | null;
|
|
377
|
+
declare function Drawer({ open, title, label, onClose, footer, bare, children, className, ...rest }: DrawerProps): React.ReactPortal | null;
|
|
370
378
|
|
|
371
379
|
/** A focused decision on a scrim. Max 560px, 760 with `wide` for data. Escape closes.
|
|
372
380
|
* MP-212/MP-248: a trapping layer in the shared layer stack (kits/layerStack.tsx):
|
|
@@ -712,7 +720,7 @@ interface AppShellProps {
|
|
|
712
720
|
* into persisting `initialNavOpen`. Never called for a transient overlay open/close. */
|
|
713
721
|
onNavOpenChange?: (open: boolean) => void;
|
|
714
722
|
/** Max-width (px) at which the rail becomes a scrimmed overlay instead of a docked
|
|
715
|
-
* column. Must match the design system's own `.fd-side` breakpoint (default
|
|
723
|
+
* column. Must match the design system's own `.fd-side` breakpoint (default `OVERLAY_BREAKPOINT`)
|
|
716
724
|
* unless an app's own CSS overrides that breakpoint too. */
|
|
717
725
|
railBreakpoint?: number;
|
|
718
726
|
/** Topbar's breadcrumbs. */
|
|
@@ -2017,12 +2025,18 @@ interface StepListProps {
|
|
|
2017
2025
|
showDurations?: boolean;
|
|
2018
2026
|
dense?: boolean;
|
|
2019
2027
|
className?: string;
|
|
2028
|
+
/**
|
|
2029
|
+
* The work these steps belong to is not finished (a turn still waiting on background work). The head then
|
|
2030
|
+
* reads as a neutral "Steps so far" disclosure, never the green "Worked for …" completion check, so a
|
|
2031
|
+
* person never sees finished and working at once. A running step still shows its own spinner.
|
|
2032
|
+
*/
|
|
2033
|
+
active?: boolean;
|
|
2020
2034
|
}
|
|
2021
2035
|
/**
|
|
2022
2036
|
* A flat, collapsible list of work steps — one row per step, never one card per
|
|
2023
2037
|
* call. A long run stays readable: it is a list, not a stack.
|
|
2024
2038
|
*/
|
|
2025
|
-
declare function StepList({ steps, label, defaultOpen, open: openProp, onToggle, showDurations, dense, className, }: StepListProps): React.JSX.Element | null;
|
|
2039
|
+
declare function StepList({ steps, label, defaultOpen, open: openProp, onToggle, showDurations, dense, className, active, }: StepListProps): React.JSX.Element | null;
|
|
2026
2040
|
|
|
2027
2041
|
/** Number of rows kept mounted above and below the visible band. Two buffers this size
|
|
2028
2042
|
* (one per edge) plus the visible band itself is what keeps the mounted node count
|
|
@@ -4077,6 +4091,12 @@ interface PreferenceMeterProps {
|
|
|
4077
4091
|
*/
|
|
4078
4092
|
declare function PreferenceMeter({ criteria, score, label, width, height, showScore, placement, breakdownTitle, className, }: PreferenceMeterProps): React.JSX.Element;
|
|
4079
4093
|
|
|
4094
|
+
type ChatStore = {
|
|
4095
|
+
get(k: string): string | null;
|
|
4096
|
+
set(k: string, v: string): void;
|
|
4097
|
+
del(k: string): void;
|
|
4098
|
+
};
|
|
4099
|
+
|
|
4080
4100
|
/**
|
|
4081
4101
|
* Chat state machine. Framework-shaped as a React hook, but the rules it encodes
|
|
4082
4102
|
* are the portable part: thread resolution, serial sending, escalation polling,
|
|
@@ -4143,6 +4163,18 @@ interface ChatMessage {
|
|
|
4143
4163
|
model?: string;
|
|
4144
4164
|
usage?: unknown;
|
|
4145
4165
|
resumed?: boolean;
|
|
4166
|
+
/**
|
|
4167
|
+
* This message is a background task that is still in progress (a queued or running query's card). Set by the
|
|
4168
|
+
* adapter. `working` keeps meaning only "the turn is in flight"; a pending message shows no working row of
|
|
4169
|
+
* its own. A task-pending message is what a working turn waits on (see `waitingFor`).
|
|
4170
|
+
*/
|
|
4171
|
+
taskPending?: boolean;
|
|
4172
|
+
/**
|
|
4173
|
+
* What a still-working turn is waiting on, in words ("Running 2 queries"): set by the engine, never the
|
|
4174
|
+
* adapter, on the working turn whenever messages of the thread are `taskPending`. The working indicator then
|
|
4175
|
+
* shows this in place of "Working" as the turn's one state. Never an id.
|
|
4176
|
+
*/
|
|
4177
|
+
waitingFor?: string;
|
|
4146
4178
|
metadata?: {
|
|
4147
4179
|
type?: string;
|
|
4148
4180
|
[k: string]: unknown;
|
|
@@ -4200,11 +4232,13 @@ interface ChatEngineOptions {
|
|
|
4200
4232
|
* is always authoritative: a terminal status seen at any time wins over this.
|
|
4201
4233
|
*/
|
|
4202
4234
|
pendingTimeoutMs?: number;
|
|
4203
|
-
|
|
4204
|
-
|
|
4205
|
-
|
|
4206
|
-
|
|
4207
|
-
|
|
4235
|
+
/**
|
|
4236
|
+
* Words for the background work a working turn is waiting on: called with the thread's `taskPending` messages
|
|
4237
|
+
* (a running query's card), whenever there is at least one. Default "Waiting on N background
|
|
4238
|
+
* task(s)". Return the app's own phrasing, e.g. "Running 2 queries".
|
|
4239
|
+
*/
|
|
4240
|
+
describeWaiting?: (pending: ChatMessage[]) => string;
|
|
4241
|
+
store?: ChatStore;
|
|
4208
4242
|
onPacket?: (p: Packet) => void;
|
|
4209
4243
|
onThreadReady?: (id: string) => void;
|
|
4210
4244
|
onError?: (e: unknown) => void;
|
|
@@ -4326,6 +4360,10 @@ type VoiceHandler = (controls: {
|
|
|
4326
4360
|
interface AgentChatPanelProps {
|
|
4327
4361
|
contextType: string;
|
|
4328
4362
|
contextId: string;
|
|
4363
|
+
/** Whose draft this is: the signed-in user's id. The composer's unsent text is kept in the tab's session storage
|
|
4364
|
+
* under this owner, so it survives the panel being remounted but is never shown to a different owner. `null` =
|
|
4365
|
+
* no owner to scope to, so the draft is not stored at all. */
|
|
4366
|
+
draftOwner: string | null;
|
|
4329
4367
|
apiAdapter: ChatAdapter | null;
|
|
4330
4368
|
/** Show this exact thread instead of resolving one from context. Set it from
|
|
4331
4369
|
* onNewThread / onSelectThread to make history switching work. */
|
|
@@ -4358,6 +4396,8 @@ interface AgentChatPanelProps {
|
|
|
4358
4396
|
onApplyPacket?: (p: Packet) => void;
|
|
4359
4397
|
/** Give-up time for a queued/running turn, in ms. Default 180000. The server's terminal job status always wins. */
|
|
4360
4398
|
pendingTimeoutMs?: number;
|
|
4399
|
+
/** Words for the background work a live turn waits on, given the still-working cards ("Running 2 queries"). */
|
|
4400
|
+
describeWaiting?: (pending: ChatMessage[]) => string;
|
|
4361
4401
|
onOpenAttachment?: (a: Attachment) => void;
|
|
4362
4402
|
/** Map a backend error code to human copy. */
|
|
4363
4403
|
errorCopy?: (code: string) => React.ReactNode;
|
|
@@ -4418,7 +4458,7 @@ interface AgentChatPanelProps {
|
|
|
4418
4458
|
* renders only when its input is supplied. A panel with no telemetry shows no
|
|
4419
4459
|
* telemetry, not zeroes.
|
|
4420
4460
|
*/
|
|
4421
|
-
declare function AgentChatPanel({ contextType, contextId, apiAdapter, threadId, title, subtitle, showHeader, headerActions, onClose, assistantName, userName, assistantAvatar, userAvatar, assistantIcon, showAvatars, markdown, maxVisibleChars, messageActions, showSteps, showThinking, emptyTitle, emptyDescription, emptyIcon, suggestions, renderEmpty, packetSchemas, packetRenderers, onApplyPacket, pendingTimeoutMs, onOpenAttachment, errorCopy, placeholder, maxLength, hint, fileUploadHandler, acceptFiles, maxFileSize, largePasteThreshold, slashCommands, mentionSources, voiceHandler, initialMessage, contextUsage, sessionStats, usageLimits, models, model, onModelChange, effortLevels, effort, onEffortChange, fastMode, onFastModeChange, moreModels, threads, onSelectThread, onNewThread, onDeleteThread, surface, width, minWidth, maxWidth, resizable, height, className, style, onPacket, onThreadReady, onError, onSend, onClear, onFeedback, onEditMessage, }: AgentChatPanelProps): React.JSX.Element;
|
|
4461
|
+
declare function AgentChatPanel({ contextType, contextId, draftOwner, apiAdapter, threadId, title, subtitle, showHeader, headerActions, onClose, assistantName, userName, assistantAvatar, userAvatar, assistantIcon, showAvatars, markdown, maxVisibleChars, messageActions, showSteps, showThinking, emptyTitle, emptyDescription, emptyIcon, suggestions, renderEmpty, packetSchemas, packetRenderers, onApplyPacket, pendingTimeoutMs, describeWaiting, onOpenAttachment, errorCopy, placeholder, maxLength, hint, fileUploadHandler, acceptFiles, maxFileSize, largePasteThreshold, slashCommands, mentionSources, voiceHandler, initialMessage, contextUsage, sessionStats, usageLimits, models, model, onModelChange, effortLevels, effort, onEffortChange, fastMode, onFastModeChange, moreModels, threads, onSelectThread, onNewThread, onDeleteThread, surface, width, minWidth, maxWidth, resizable, height, className, style, onPacket, onThreadReady, onError, onSend, onClear, onFeedback, onEditMessage, }: AgentChatPanelProps): React.JSX.Element;
|
|
4422
4462
|
|
|
4423
4463
|
/**
|
|
4424
4464
|
* Staged files, the queue strip, the markdown editor, slash/mention triggers, send + stop.
|
|
@@ -5379,9 +5419,8 @@ declare function isWithinLayerTree(layer: StackedLayer, node: Node | null): bool
|
|
|
5379
5419
|
* MP-214: the responsive-rail behaviour every app-level shell was hand-rolling (and, in
|
|
5380
5420
|
* sms-app's case, already diverging on — see the SMS-5 architecture-gate review). Owns:
|
|
5381
5421
|
*
|
|
5382
|
-
* - overlay-vs-docked detection at `breakpoint` (default
|
|
5383
|
-
* components.css's `.fd-side` media query
|
|
5384
|
-
* on the same number, since neither reads it from the other);
|
|
5422
|
+
* - overlay-vs-docked detection at `breakpoint` (default `OVERLAY_BREAKPOINT`, matching the CSS in
|
|
5423
|
+
* components.css's `.fd-side` media query, pinned equal by overlayLayout.test.tsx);
|
|
5385
5424
|
* - the rail's open/closed state, forced closed on entry to overlay and forced open on
|
|
5386
5425
|
* return to docked (matching the desktop-collapse behaviour PlannerShell already had);
|
|
5387
5426
|
* - Escape-to-close while the overlay is open, and a trapping layer in the shared layer stack
|
|
@@ -5396,7 +5435,7 @@ declare function isWithinLayerTree(layer: StackedLayer, node: Node | null): bool
|
|
|
5396
5435
|
*/
|
|
5397
5436
|
interface UseResponsiveRailOptions {
|
|
5398
5437
|
/** Max-width (px) at which the rail becomes an overlay. Must match the CSS breakpoint
|
|
5399
|
-
* the consumer's `SidebarNav` styling uses — default
|
|
5438
|
+
* the consumer's `SidebarNav` styling uses — default `OVERLAY_BREAKPOINT`. */
|
|
5400
5439
|
breakpoint?: number;
|
|
5401
5440
|
/** The rail's open state on first render while docked (desktop). Ignored while the
|
|
5402
5441
|
* initial viewport is already in overlay range — an overlay always starts closed. */
|
|
@@ -5430,6 +5469,16 @@ interface UseResponsiveRailResult {
|
|
|
5430
5469
|
}
|
|
5431
5470
|
declare function useResponsiveRail(options?: UseResponsiveRailOptions): UseResponsiveRailResult;
|
|
5432
5471
|
|
|
5472
|
+
/** Max-width (px) at and below which the app shell's side rail is an overlay instead of a
|
|
5473
|
+
* docked column. The one definition: `useResponsiveRail`, `AppShell` and `useOverlayLayout`
|
|
5474
|
+
* read it, and an app that changes layout at the same width imports it instead of copying
|
|
5475
|
+
* the number. `.fd-side`'s media query in styles/components.css is the CSS twin of this
|
|
5476
|
+
* value (CSS cannot read it), pinned equal by overlayLayout.test.tsx. */
|
|
5477
|
+
declare const OVERLAY_BREAKPOINT = 1024;
|
|
5478
|
+
/** True while the layout is in overlay mode (the viewport is at or under
|
|
5479
|
+
* `OVERLAY_BREAKPOINT`). Read synchronously on first render, so there is no flash. */
|
|
5480
|
+
declare function useOverlayLayout(): boolean;
|
|
5481
|
+
|
|
5433
5482
|
/**
|
|
5434
5483
|
* MP-221: the "<route> · <app> · Flytedesk" title convention every flytedesk app shell
|
|
5435
5484
|
* hand-typed per route (sms-app's CampaignAnalytics.tsx, QueryTool.tsx, NotFound.tsx,
|
|
@@ -5489,4 +5538,4 @@ declare function CornerStackPortal({ slot, children }: {
|
|
|
5489
5538
|
children?: React.ReactNode;
|
|
5490
5539
|
}): React.ReactPortal | null;
|
|
5491
5540
|
|
|
5492
|
-
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 DataTableColumnLabel, type DataTablePhoneRole, type DataTableProps, type DataTableRowAction, DatePicker, type DatePickerProps, type DemoSessionControls, DemoSessionProvider, type DeviceSession, DiffBlock, type DiffBlockProps, DonutChart, type DonutChartProps, type DonutSegment, Drawer, type DrawerProps, Dropzone, DropzoneKit, type DropzoneProps, ENTITY_ROW_METRIC_WIDTH, 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, Fieldset, type FieldsetProps, FileBrowser, type FileBrowserFile, type FileBrowserFolder, type FileBrowserPermissions, type FileBrowserProps, FileChip, type FileChipProps, FileGrid, type FileGridProps, FileKit, FilePickButton, type FilePickButtonProps, type FileRejection, FileStrip, type FileStripProps, FileTile, type FileTileProps, type FileUploadHandler, FileViewer, type FileViewerProps, FilterBar, type FilterBarProps, type FilterDateValue, type FilterField, type FilterFieldDate, type FilterFieldFixed, type FilterFieldMultiSelect, type FilterFieldOption, type FilterFieldRange, type FilterFieldSelect, type FilterFieldText, type FilterMultiSelectValue, type FilterOperator, type FilterRangeValue, type FilterResolveMatch, type FilterResolveResult, type FilterValidation, type FilterValue, Flag$1 as Flag, type FlagExplanation, type FlagProps, FlytedeskBrand, type FlytedeskBrandProps, FlytedeskMark, type FlytedeskMarkProps, FormatEta, FunnelChart, type FunnelChartProps, type FunnelStep, Gate, GatePending, type GatePendingProps, type GateProps, IMPORTANCE_LEVELS, IconButton, type IconButtonProps, type ImportanceLevel, type ImportanceLevelId, ImportanceTag, type ImportanceTagProps, type ImportanceTokens, Input, type InputProps, type Job, type JobAction, type JobCardStatus, type JobStatus, JobTray, type JobTrayProps, Json, KeyHint, type KeyHintProps, type KeysetEnvelope, type KeysetServerTable, LAYER_STEP, type ListEnvelope, LoadingRegion, type LoadingRegionProps, Markdown, MarkdownEditor, type MarkdownEditorHandle, type MarkdownEditorProps, MarkdownInline, type MarkdownProps, type MarkdownSize, type MarkdownTone, type MentionSource, Menu, MenuButton, type MenuButtonProps, type MenuItem, type MenuProps, MessageBody, type MessageBodyProps, type MessageGroup, Meter, type MeterProps, type MeterSegment, type MeterSegmentInput, MixGap, type MixGapProps, type MixGapRow, MockJobKit, type MockJobStatus, Modal, type ModalProps, ModeSwitch, type ModeSwitchProps, type Model, ModelControls, type ModelControlsProps, 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, RadioGroup, type RadioGroupOption, type RadioGroupProps, type RadioProps, RangeSlider, type RangeSliderProps, RelativeTime, type RelativeTimeProps, ReservedSkeleton, type ReservedSkeletonProps, 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, StatGrid, type StatGridProps, StatTile, type StatTileProps, type Step, StepList, type StepListProps, type StreamHandlers, type Suggestion, SurroundSound, type SurroundSoundProps, Switch, type SwitchProps, type TabItem, type TableQuery, Tabs, type TabsProps, Tag, type TagProps, TestModeBar, type TestModeBarProps, type TextScale, Textarea, type TextareaProps, type ThemeMode, ThinkingBlock, type ThinkingBlockProps, type ThreadSummary, TimePicker, type TimePickerProps, Toast, type ToastApi, type ToastOptions, type ToastProps, ToastProvider, Tooltip, type TooltipApi, type TooltipBinding, type TooltipPlacement, type TooltipProps, Topbar, type TopbarProps, TranscriptKit, TransferList, type TransferListProps, type TransferListSide, type TransferListSideProps, TrendChart, type TrendChartProps, type TrendSeries, USChoropleth, type USChoroplethProps, type StateFigure as USChoroplethState, type ChoroplethValue as USChoroplethValue, US_STATE_CODES, type UsageLimit, UseFeatureStatus, type UseKeysetTableOptions, type UseResponsiveRailOptions, type UseResponsiveRailResult, UseRuntimeMode, type UseServerTableOptions, type UseTooltipOptions, type User, VIRTUAL_LIST_BUFFER_ROWS, VIRTUAL_LIST_ROW_GAP, type VersionRecord, type VersionStore, VirtualList, type VirtualListProps, type VirtualLoadedBand, type VirtualWindow, type VoiceHandler, __resetLayerStackForTests, acceptMatches, anyOfFilter, applyAppearance, applyPrefs, channelWeightOf, computeNeedMore, computeVirtualWindow, copyToClipboard, createLocalStorageAppearanceStore, createVersionStore, eqFilter, extensionOf, extractClipboardFiles, filterFiles, formatAbsolute, formatBytes, formatClock, formatDocumentTitle, formatDuration, formatEta, formatRelative, formatShare, groupMessages, hasModifier, historyUrlAdapter, iconForMime, importanceLevel, importanceTokens, installFlytedeskFavicon, isImage, isSystemMessage, isUsStateCode, isWithinLayerTree, jobBucket, languageLabel, loadPrefs, meterFormats, modifierLabel, parseDelimited, pastedTextName, pluralizeUnit, preferenceScore, preferenceSegments, rangeFilter, readQueryFromUrl, resolveTheme, revokeAttachment, savePrefs, toAttachment, tokenize, useAppearancePrefs, useAppearanceStore, useChatEngine, useCopyToClipboard, useCornerStackSlot, useDocumentTitle, useFeatureStatus, useLayerZIndex, usePopoverPosition, useResponsiveRail, useRuntimeMode, useServerTable, useSessionContext, useStackedLayer, useStagedFiles, useToast, useTooltip, validateFilterValue, visibleMessages, watchAppearance, writeQueryToUrl };
|
|
5541
|
+
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 DataTableColumnLabel, type DataTablePhoneRole, type DataTableProps, type DataTableRowAction, DatePicker, type DatePickerProps, type DemoSessionControls, DemoSessionProvider, type DeviceSession, DiffBlock, type DiffBlockProps, DonutChart, type DonutChartProps, type DonutSegment, Drawer, type DrawerProps, Dropzone, DropzoneKit, type DropzoneProps, ENTITY_ROW_METRIC_WIDTH, 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, Fieldset, type FieldsetProps, FileBrowser, type FileBrowserFile, type FileBrowserFolder, type FileBrowserPermissions, type FileBrowserProps, FileChip, type FileChipProps, FileGrid, type FileGridProps, FileKit, FilePickButton, type FilePickButtonProps, type FileRejection, FileStrip, type FileStripProps, FileTile, type FileTileProps, type FileUploadHandler, FileViewer, type FileViewerProps, FilterBar, type FilterBarProps, type FilterDateValue, type FilterField, type FilterFieldDate, type FilterFieldFixed, type FilterFieldMultiSelect, type FilterFieldOption, type FilterFieldRange, type FilterFieldSelect, type FilterFieldText, type FilterMultiSelectValue, type FilterOperator, type FilterRangeValue, type FilterResolveMatch, type FilterResolveResult, type FilterValidation, type FilterValue, Flag$1 as Flag, type FlagExplanation, type FlagProps, FlytedeskBrand, type FlytedeskBrandProps, FlytedeskMark, type FlytedeskMarkProps, FormatEta, FunnelChart, type FunnelChartProps, type FunnelStep, Gate, GatePending, type GatePendingProps, type GateProps, IMPORTANCE_LEVELS, IconButton, type IconButtonProps, type ImportanceLevel, type ImportanceLevelId, ImportanceTag, type ImportanceTagProps, type ImportanceTokens, Input, type InputProps, type Job, type JobAction, type JobCardStatus, type JobStatus, JobTray, type JobTrayProps, Json, KeyHint, type KeyHintProps, type KeysetEnvelope, type KeysetServerTable, LAYER_STEP, type ListEnvelope, LoadingRegion, type LoadingRegionProps, Markdown, MarkdownEditor, type MarkdownEditorHandle, type MarkdownEditorProps, MarkdownInline, type MarkdownProps, type MarkdownSize, type MarkdownTone, type MentionSource, Menu, MenuButton, type MenuButtonProps, type MenuItem, type MenuProps, MessageBody, type MessageBodyProps, type MessageGroup, Meter, type MeterProps, type MeterSegment, type MeterSegmentInput, MixGap, type MixGapProps, type MixGapRow, MockJobKit, type MockJobStatus, Modal, type ModalProps, ModeSwitch, type ModeSwitchProps, type Model, ModelControls, type ModelControlsProps, NumberInput, type NumberInputProps, OVERLAY_BREAKPOINT, 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, RadioGroup, type RadioGroupOption, type RadioGroupProps, type RadioProps, RangeSlider, type RangeSliderProps, RelativeTime, type RelativeTimeProps, ReservedSkeleton, type ReservedSkeletonProps, 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, StatGrid, type StatGridProps, StatTile, type StatTileProps, type Step, StepList, type StepListProps, type StreamHandlers, type Suggestion, SurroundSound, type SurroundSoundProps, Switch, type SwitchProps, type TabItem, type TableQuery, Tabs, type TabsProps, Tag, type TagProps, TestModeBar, type TestModeBarProps, type TextScale, Textarea, type TextareaProps, type ThemeMode, ThinkingBlock, type ThinkingBlockProps, type ThreadSummary, TimePicker, type TimePickerProps, Toast, type ToastApi, type ToastOptions, type ToastProps, ToastProvider, Tooltip, type TooltipApi, type TooltipBinding, type TooltipPlacement, type TooltipProps, Topbar, type TopbarProps, TranscriptKit, TransferList, type TransferListProps, type TransferListSide, type TransferListSideProps, TrendChart, type TrendChartProps, type TrendSeries, USChoropleth, type USChoroplethProps, type StateFigure as USChoroplethState, type ChoroplethValue as USChoroplethValue, US_STATE_CODES, type UsageLimit, UseFeatureStatus, type UseKeysetTableOptions, type UseResponsiveRailOptions, type UseResponsiveRailResult, UseRuntimeMode, type UseServerTableOptions, type UseTooltipOptions, type User, VIRTUAL_LIST_BUFFER_ROWS, VIRTUAL_LIST_ROW_GAP, type VersionRecord, type VersionStore, VirtualList, type VirtualListProps, type VirtualLoadedBand, type VirtualWindow, type VoiceHandler, __resetLayerStackForTests, acceptMatches, anyOfFilter, applyAppearance, applyPrefs, channelWeightOf, computeNeedMore, computeVirtualWindow, copyToClipboard, createLocalStorageAppearanceStore, createVersionStore, eqFilter, extensionOf, extractClipboardFiles, filterFiles, formatAbsolute, formatBytes, formatClock, formatDocumentTitle, formatDuration, formatEta, formatRelative, formatShare, groupMessages, hasModifier, historyUrlAdapter, iconForMime, importanceLevel, importanceTokens, installFlytedeskFavicon, isImage, isSystemMessage, isUsStateCode, isWithinLayerTree, jobBucket, languageLabel, loadPrefs, meterFormats, modifierLabel, parseDelimited, pastedTextName, pluralizeUnit, preferenceScore, preferenceSegments, rangeFilter, readQueryFromUrl, resolveTheme, revokeAttachment, savePrefs, toAttachment, tokenize, useAppearancePrefs, useAppearanceStore, useChatEngine, useCopyToClipboard, useCornerStackSlot, useDocumentTitle, useFeatureStatus, useLayerZIndex, useOverlayLayout, usePopoverPosition, useResponsiveRail, useRuntimeMode, useServerTable, useSessionContext, useStackedLayer, useStagedFiles, useToast, useTooltip, validateFilterValue, visibleMessages, watchAppearance, writeQueryToUrl };
|
package/dist/index.d.ts
CHANGED
|
@@ -363,10 +363,18 @@ interface DrawerProps {
|
|
|
363
363
|
onClose?: () => void;
|
|
364
364
|
/** Plain content, or a render function receiving `close` — call it to trigger the closing animation before onClose fires. */
|
|
365
365
|
footer?: React.ReactNode | ((close: () => void) => React.ReactNode);
|
|
366
|
-
|
|
366
|
+
/** The drawer's content owns the whole panel: no header bar and no body padding, and the panel is the
|
|
367
|
+
* full viewport height. For content that already has its own header and close control (a chat panel).
|
|
368
|
+
* `title` is then only the dialog's accessible name; Escape, scrim click and focus handling are unchanged. */
|
|
369
|
+
bare?: boolean;
|
|
370
|
+
/** The dialog's accessible name. A bare Drawer has no header to name it, so it takes `label`, else `title` when that is
|
|
371
|
+
* a string; a bare Drawer with neither (a node `title`, no `label`) is an unnamed dialog and warns in development. */
|
|
372
|
+
label?: string;
|
|
373
|
+
/** Plain content, or (like `footer`) a render function receiving `close`. */
|
|
374
|
+
children?: React.ReactNode | ((close: () => void) => React.ReactNode);
|
|
367
375
|
className?: string;
|
|
368
376
|
}
|
|
369
|
-
declare function Drawer({ open, title, onClose, footer, children, className, ...rest }: DrawerProps): React.ReactPortal | null;
|
|
377
|
+
declare function Drawer({ open, title, label, onClose, footer, bare, children, className, ...rest }: DrawerProps): React.ReactPortal | null;
|
|
370
378
|
|
|
371
379
|
/** A focused decision on a scrim. Max 560px, 760 with `wide` for data. Escape closes.
|
|
372
380
|
* MP-212/MP-248: a trapping layer in the shared layer stack (kits/layerStack.tsx):
|
|
@@ -712,7 +720,7 @@ interface AppShellProps {
|
|
|
712
720
|
* into persisting `initialNavOpen`. Never called for a transient overlay open/close. */
|
|
713
721
|
onNavOpenChange?: (open: boolean) => void;
|
|
714
722
|
/** Max-width (px) at which the rail becomes a scrimmed overlay instead of a docked
|
|
715
|
-
* column. Must match the design system's own `.fd-side` breakpoint (default
|
|
723
|
+
* column. Must match the design system's own `.fd-side` breakpoint (default `OVERLAY_BREAKPOINT`)
|
|
716
724
|
* unless an app's own CSS overrides that breakpoint too. */
|
|
717
725
|
railBreakpoint?: number;
|
|
718
726
|
/** Topbar's breadcrumbs. */
|
|
@@ -2017,12 +2025,18 @@ interface StepListProps {
|
|
|
2017
2025
|
showDurations?: boolean;
|
|
2018
2026
|
dense?: boolean;
|
|
2019
2027
|
className?: string;
|
|
2028
|
+
/**
|
|
2029
|
+
* The work these steps belong to is not finished (a turn still waiting on background work). The head then
|
|
2030
|
+
* reads as a neutral "Steps so far" disclosure, never the green "Worked for …" completion check, so a
|
|
2031
|
+
* person never sees finished and working at once. A running step still shows its own spinner.
|
|
2032
|
+
*/
|
|
2033
|
+
active?: boolean;
|
|
2020
2034
|
}
|
|
2021
2035
|
/**
|
|
2022
2036
|
* A flat, collapsible list of work steps — one row per step, never one card per
|
|
2023
2037
|
* call. A long run stays readable: it is a list, not a stack.
|
|
2024
2038
|
*/
|
|
2025
|
-
declare function StepList({ steps, label, defaultOpen, open: openProp, onToggle, showDurations, dense, className, }: StepListProps): React.JSX.Element | null;
|
|
2039
|
+
declare function StepList({ steps, label, defaultOpen, open: openProp, onToggle, showDurations, dense, className, active, }: StepListProps): React.JSX.Element | null;
|
|
2026
2040
|
|
|
2027
2041
|
/** Number of rows kept mounted above and below the visible band. Two buffers this size
|
|
2028
2042
|
* (one per edge) plus the visible band itself is what keeps the mounted node count
|
|
@@ -4077,6 +4091,12 @@ interface PreferenceMeterProps {
|
|
|
4077
4091
|
*/
|
|
4078
4092
|
declare function PreferenceMeter({ criteria, score, label, width, height, showScore, placement, breakdownTitle, className, }: PreferenceMeterProps): React.JSX.Element;
|
|
4079
4093
|
|
|
4094
|
+
type ChatStore = {
|
|
4095
|
+
get(k: string): string | null;
|
|
4096
|
+
set(k: string, v: string): void;
|
|
4097
|
+
del(k: string): void;
|
|
4098
|
+
};
|
|
4099
|
+
|
|
4080
4100
|
/**
|
|
4081
4101
|
* Chat state machine. Framework-shaped as a React hook, but the rules it encodes
|
|
4082
4102
|
* are the portable part: thread resolution, serial sending, escalation polling,
|
|
@@ -4143,6 +4163,18 @@ interface ChatMessage {
|
|
|
4143
4163
|
model?: string;
|
|
4144
4164
|
usage?: unknown;
|
|
4145
4165
|
resumed?: boolean;
|
|
4166
|
+
/**
|
|
4167
|
+
* This message is a background task that is still in progress (a queued or running query's card). Set by the
|
|
4168
|
+
* adapter. `working` keeps meaning only "the turn is in flight"; a pending message shows no working row of
|
|
4169
|
+
* its own. A task-pending message is what a working turn waits on (see `waitingFor`).
|
|
4170
|
+
*/
|
|
4171
|
+
taskPending?: boolean;
|
|
4172
|
+
/**
|
|
4173
|
+
* What a still-working turn is waiting on, in words ("Running 2 queries"): set by the engine, never the
|
|
4174
|
+
* adapter, on the working turn whenever messages of the thread are `taskPending`. The working indicator then
|
|
4175
|
+
* shows this in place of "Working" as the turn's one state. Never an id.
|
|
4176
|
+
*/
|
|
4177
|
+
waitingFor?: string;
|
|
4146
4178
|
metadata?: {
|
|
4147
4179
|
type?: string;
|
|
4148
4180
|
[k: string]: unknown;
|
|
@@ -4200,11 +4232,13 @@ interface ChatEngineOptions {
|
|
|
4200
4232
|
* is always authoritative: a terminal status seen at any time wins over this.
|
|
4201
4233
|
*/
|
|
4202
4234
|
pendingTimeoutMs?: number;
|
|
4203
|
-
|
|
4204
|
-
|
|
4205
|
-
|
|
4206
|
-
|
|
4207
|
-
|
|
4235
|
+
/**
|
|
4236
|
+
* Words for the background work a working turn is waiting on: called with the thread's `taskPending` messages
|
|
4237
|
+
* (a running query's card), whenever there is at least one. Default "Waiting on N background
|
|
4238
|
+
* task(s)". Return the app's own phrasing, e.g. "Running 2 queries".
|
|
4239
|
+
*/
|
|
4240
|
+
describeWaiting?: (pending: ChatMessage[]) => string;
|
|
4241
|
+
store?: ChatStore;
|
|
4208
4242
|
onPacket?: (p: Packet) => void;
|
|
4209
4243
|
onThreadReady?: (id: string) => void;
|
|
4210
4244
|
onError?: (e: unknown) => void;
|
|
@@ -4326,6 +4360,10 @@ type VoiceHandler = (controls: {
|
|
|
4326
4360
|
interface AgentChatPanelProps {
|
|
4327
4361
|
contextType: string;
|
|
4328
4362
|
contextId: string;
|
|
4363
|
+
/** Whose draft this is: the signed-in user's id. The composer's unsent text is kept in the tab's session storage
|
|
4364
|
+
* under this owner, so it survives the panel being remounted but is never shown to a different owner. `null` =
|
|
4365
|
+
* no owner to scope to, so the draft is not stored at all. */
|
|
4366
|
+
draftOwner: string | null;
|
|
4329
4367
|
apiAdapter: ChatAdapter | null;
|
|
4330
4368
|
/** Show this exact thread instead of resolving one from context. Set it from
|
|
4331
4369
|
* onNewThread / onSelectThread to make history switching work. */
|
|
@@ -4358,6 +4396,8 @@ interface AgentChatPanelProps {
|
|
|
4358
4396
|
onApplyPacket?: (p: Packet) => void;
|
|
4359
4397
|
/** Give-up time for a queued/running turn, in ms. Default 180000. The server's terminal job status always wins. */
|
|
4360
4398
|
pendingTimeoutMs?: number;
|
|
4399
|
+
/** Words for the background work a live turn waits on, given the still-working cards ("Running 2 queries"). */
|
|
4400
|
+
describeWaiting?: (pending: ChatMessage[]) => string;
|
|
4361
4401
|
onOpenAttachment?: (a: Attachment) => void;
|
|
4362
4402
|
/** Map a backend error code to human copy. */
|
|
4363
4403
|
errorCopy?: (code: string) => React.ReactNode;
|
|
@@ -4418,7 +4458,7 @@ interface AgentChatPanelProps {
|
|
|
4418
4458
|
* renders only when its input is supplied. A panel with no telemetry shows no
|
|
4419
4459
|
* telemetry, not zeroes.
|
|
4420
4460
|
*/
|
|
4421
|
-
declare function AgentChatPanel({ contextType, contextId, apiAdapter, threadId, title, subtitle, showHeader, headerActions, onClose, assistantName, userName, assistantAvatar, userAvatar, assistantIcon, showAvatars, markdown, maxVisibleChars, messageActions, showSteps, showThinking, emptyTitle, emptyDescription, emptyIcon, suggestions, renderEmpty, packetSchemas, packetRenderers, onApplyPacket, pendingTimeoutMs, onOpenAttachment, errorCopy, placeholder, maxLength, hint, fileUploadHandler, acceptFiles, maxFileSize, largePasteThreshold, slashCommands, mentionSources, voiceHandler, initialMessage, contextUsage, sessionStats, usageLimits, models, model, onModelChange, effortLevels, effort, onEffortChange, fastMode, onFastModeChange, moreModels, threads, onSelectThread, onNewThread, onDeleteThread, surface, width, minWidth, maxWidth, resizable, height, className, style, onPacket, onThreadReady, onError, onSend, onClear, onFeedback, onEditMessage, }: AgentChatPanelProps): React.JSX.Element;
|
|
4461
|
+
declare function AgentChatPanel({ contextType, contextId, draftOwner, apiAdapter, threadId, title, subtitle, showHeader, headerActions, onClose, assistantName, userName, assistantAvatar, userAvatar, assistantIcon, showAvatars, markdown, maxVisibleChars, messageActions, showSteps, showThinking, emptyTitle, emptyDescription, emptyIcon, suggestions, renderEmpty, packetSchemas, packetRenderers, onApplyPacket, pendingTimeoutMs, describeWaiting, onOpenAttachment, errorCopy, placeholder, maxLength, hint, fileUploadHandler, acceptFiles, maxFileSize, largePasteThreshold, slashCommands, mentionSources, voiceHandler, initialMessage, contextUsage, sessionStats, usageLimits, models, model, onModelChange, effortLevels, effort, onEffortChange, fastMode, onFastModeChange, moreModels, threads, onSelectThread, onNewThread, onDeleteThread, surface, width, minWidth, maxWidth, resizable, height, className, style, onPacket, onThreadReady, onError, onSend, onClear, onFeedback, onEditMessage, }: AgentChatPanelProps): React.JSX.Element;
|
|
4422
4462
|
|
|
4423
4463
|
/**
|
|
4424
4464
|
* Staged files, the queue strip, the markdown editor, slash/mention triggers, send + stop.
|
|
@@ -5379,9 +5419,8 @@ declare function isWithinLayerTree(layer: StackedLayer, node: Node | null): bool
|
|
|
5379
5419
|
* MP-214: the responsive-rail behaviour every app-level shell was hand-rolling (and, in
|
|
5380
5420
|
* sms-app's case, already diverging on — see the SMS-5 architecture-gate review). Owns:
|
|
5381
5421
|
*
|
|
5382
|
-
* - overlay-vs-docked detection at `breakpoint` (default
|
|
5383
|
-
* components.css's `.fd-side` media query
|
|
5384
|
-
* on the same number, since neither reads it from the other);
|
|
5422
|
+
* - overlay-vs-docked detection at `breakpoint` (default `OVERLAY_BREAKPOINT`, matching the CSS in
|
|
5423
|
+
* components.css's `.fd-side` media query, pinned equal by overlayLayout.test.tsx);
|
|
5385
5424
|
* - the rail's open/closed state, forced closed on entry to overlay and forced open on
|
|
5386
5425
|
* return to docked (matching the desktop-collapse behaviour PlannerShell already had);
|
|
5387
5426
|
* - Escape-to-close while the overlay is open, and a trapping layer in the shared layer stack
|
|
@@ -5396,7 +5435,7 @@ declare function isWithinLayerTree(layer: StackedLayer, node: Node | null): bool
|
|
|
5396
5435
|
*/
|
|
5397
5436
|
interface UseResponsiveRailOptions {
|
|
5398
5437
|
/** Max-width (px) at which the rail becomes an overlay. Must match the CSS breakpoint
|
|
5399
|
-
* the consumer's `SidebarNav` styling uses — default
|
|
5438
|
+
* the consumer's `SidebarNav` styling uses — default `OVERLAY_BREAKPOINT`. */
|
|
5400
5439
|
breakpoint?: number;
|
|
5401
5440
|
/** The rail's open state on first render while docked (desktop). Ignored while the
|
|
5402
5441
|
* initial viewport is already in overlay range — an overlay always starts closed. */
|
|
@@ -5430,6 +5469,16 @@ interface UseResponsiveRailResult {
|
|
|
5430
5469
|
}
|
|
5431
5470
|
declare function useResponsiveRail(options?: UseResponsiveRailOptions): UseResponsiveRailResult;
|
|
5432
5471
|
|
|
5472
|
+
/** Max-width (px) at and below which the app shell's side rail is an overlay instead of a
|
|
5473
|
+
* docked column. The one definition: `useResponsiveRail`, `AppShell` and `useOverlayLayout`
|
|
5474
|
+
* read it, and an app that changes layout at the same width imports it instead of copying
|
|
5475
|
+
* the number. `.fd-side`'s media query in styles/components.css is the CSS twin of this
|
|
5476
|
+
* value (CSS cannot read it), pinned equal by overlayLayout.test.tsx. */
|
|
5477
|
+
declare const OVERLAY_BREAKPOINT = 1024;
|
|
5478
|
+
/** True while the layout is in overlay mode (the viewport is at or under
|
|
5479
|
+
* `OVERLAY_BREAKPOINT`). Read synchronously on first render, so there is no flash. */
|
|
5480
|
+
declare function useOverlayLayout(): boolean;
|
|
5481
|
+
|
|
5433
5482
|
/**
|
|
5434
5483
|
* MP-221: the "<route> · <app> · Flytedesk" title convention every flytedesk app shell
|
|
5435
5484
|
* hand-typed per route (sms-app's CampaignAnalytics.tsx, QueryTool.tsx, NotFound.tsx,
|
|
@@ -5489,4 +5538,4 @@ declare function CornerStackPortal({ slot, children }: {
|
|
|
5489
5538
|
children?: React.ReactNode;
|
|
5490
5539
|
}): React.ReactPortal | null;
|
|
5491
5540
|
|
|
5492
|
-
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 DataTableColumnLabel, type DataTablePhoneRole, type DataTableProps, type DataTableRowAction, DatePicker, type DatePickerProps, type DemoSessionControls, DemoSessionProvider, type DeviceSession, DiffBlock, type DiffBlockProps, DonutChart, type DonutChartProps, type DonutSegment, Drawer, type DrawerProps, Dropzone, DropzoneKit, type DropzoneProps, ENTITY_ROW_METRIC_WIDTH, 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, Fieldset, type FieldsetProps, FileBrowser, type FileBrowserFile, type FileBrowserFolder, type FileBrowserPermissions, type FileBrowserProps, FileChip, type FileChipProps, FileGrid, type FileGridProps, FileKit, FilePickButton, type FilePickButtonProps, type FileRejection, FileStrip, type FileStripProps, FileTile, type FileTileProps, type FileUploadHandler, FileViewer, type FileViewerProps, FilterBar, type FilterBarProps, type FilterDateValue, type FilterField, type FilterFieldDate, type FilterFieldFixed, type FilterFieldMultiSelect, type FilterFieldOption, type FilterFieldRange, type FilterFieldSelect, type FilterFieldText, type FilterMultiSelectValue, type FilterOperator, type FilterRangeValue, type FilterResolveMatch, type FilterResolveResult, type FilterValidation, type FilterValue, Flag$1 as Flag, type FlagExplanation, type FlagProps, FlytedeskBrand, type FlytedeskBrandProps, FlytedeskMark, type FlytedeskMarkProps, FormatEta, FunnelChart, type FunnelChartProps, type FunnelStep, Gate, GatePending, type GatePendingProps, type GateProps, IMPORTANCE_LEVELS, IconButton, type IconButtonProps, type ImportanceLevel, type ImportanceLevelId, ImportanceTag, type ImportanceTagProps, type ImportanceTokens, Input, type InputProps, type Job, type JobAction, type JobCardStatus, type JobStatus, JobTray, type JobTrayProps, Json, KeyHint, type KeyHintProps, type KeysetEnvelope, type KeysetServerTable, LAYER_STEP, type ListEnvelope, LoadingRegion, type LoadingRegionProps, Markdown, MarkdownEditor, type MarkdownEditorHandle, type MarkdownEditorProps, MarkdownInline, type MarkdownProps, type MarkdownSize, type MarkdownTone, type MentionSource, Menu, MenuButton, type MenuButtonProps, type MenuItem, type MenuProps, MessageBody, type MessageBodyProps, type MessageGroup, Meter, type MeterProps, type MeterSegment, type MeterSegmentInput, MixGap, type MixGapProps, type MixGapRow, MockJobKit, type MockJobStatus, Modal, type ModalProps, ModeSwitch, type ModeSwitchProps, type Model, ModelControls, type ModelControlsProps, 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, RadioGroup, type RadioGroupOption, type RadioGroupProps, type RadioProps, RangeSlider, type RangeSliderProps, RelativeTime, type RelativeTimeProps, ReservedSkeleton, type ReservedSkeletonProps, 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, StatGrid, type StatGridProps, StatTile, type StatTileProps, type Step, StepList, type StepListProps, type StreamHandlers, type Suggestion, SurroundSound, type SurroundSoundProps, Switch, type SwitchProps, type TabItem, type TableQuery, Tabs, type TabsProps, Tag, type TagProps, TestModeBar, type TestModeBarProps, type TextScale, Textarea, type TextareaProps, type ThemeMode, ThinkingBlock, type ThinkingBlockProps, type ThreadSummary, TimePicker, type TimePickerProps, Toast, type ToastApi, type ToastOptions, type ToastProps, ToastProvider, Tooltip, type TooltipApi, type TooltipBinding, type TooltipPlacement, type TooltipProps, Topbar, type TopbarProps, TranscriptKit, TransferList, type TransferListProps, type TransferListSide, type TransferListSideProps, TrendChart, type TrendChartProps, type TrendSeries, USChoropleth, type USChoroplethProps, type StateFigure as USChoroplethState, type ChoroplethValue as USChoroplethValue, US_STATE_CODES, type UsageLimit, UseFeatureStatus, type UseKeysetTableOptions, type UseResponsiveRailOptions, type UseResponsiveRailResult, UseRuntimeMode, type UseServerTableOptions, type UseTooltipOptions, type User, VIRTUAL_LIST_BUFFER_ROWS, VIRTUAL_LIST_ROW_GAP, type VersionRecord, type VersionStore, VirtualList, type VirtualListProps, type VirtualLoadedBand, type VirtualWindow, type VoiceHandler, __resetLayerStackForTests, acceptMatches, anyOfFilter, applyAppearance, applyPrefs, channelWeightOf, computeNeedMore, computeVirtualWindow, copyToClipboard, createLocalStorageAppearanceStore, createVersionStore, eqFilter, extensionOf, extractClipboardFiles, filterFiles, formatAbsolute, formatBytes, formatClock, formatDocumentTitle, formatDuration, formatEta, formatRelative, formatShare, groupMessages, hasModifier, historyUrlAdapter, iconForMime, importanceLevel, importanceTokens, installFlytedeskFavicon, isImage, isSystemMessage, isUsStateCode, isWithinLayerTree, jobBucket, languageLabel, loadPrefs, meterFormats, modifierLabel, parseDelimited, pastedTextName, pluralizeUnit, preferenceScore, preferenceSegments, rangeFilter, readQueryFromUrl, resolveTheme, revokeAttachment, savePrefs, toAttachment, tokenize, useAppearancePrefs, useAppearanceStore, useChatEngine, useCopyToClipboard, useCornerStackSlot, useDocumentTitle, useFeatureStatus, useLayerZIndex, usePopoverPosition, useResponsiveRail, useRuntimeMode, useServerTable, useSessionContext, useStackedLayer, useStagedFiles, useToast, useTooltip, validateFilterValue, visibleMessages, watchAppearance, writeQueryToUrl };
|
|
5541
|
+
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 DataTableColumnLabel, type DataTablePhoneRole, type DataTableProps, type DataTableRowAction, DatePicker, type DatePickerProps, type DemoSessionControls, DemoSessionProvider, type DeviceSession, DiffBlock, type DiffBlockProps, DonutChart, type DonutChartProps, type DonutSegment, Drawer, type DrawerProps, Dropzone, DropzoneKit, type DropzoneProps, ENTITY_ROW_METRIC_WIDTH, 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, Fieldset, type FieldsetProps, FileBrowser, type FileBrowserFile, type FileBrowserFolder, type FileBrowserPermissions, type FileBrowserProps, FileChip, type FileChipProps, FileGrid, type FileGridProps, FileKit, FilePickButton, type FilePickButtonProps, type FileRejection, FileStrip, type FileStripProps, FileTile, type FileTileProps, type FileUploadHandler, FileViewer, type FileViewerProps, FilterBar, type FilterBarProps, type FilterDateValue, type FilterField, type FilterFieldDate, type FilterFieldFixed, type FilterFieldMultiSelect, type FilterFieldOption, type FilterFieldRange, type FilterFieldSelect, type FilterFieldText, type FilterMultiSelectValue, type FilterOperator, type FilterRangeValue, type FilterResolveMatch, type FilterResolveResult, type FilterValidation, type FilterValue, Flag$1 as Flag, type FlagExplanation, type FlagProps, FlytedeskBrand, type FlytedeskBrandProps, FlytedeskMark, type FlytedeskMarkProps, FormatEta, FunnelChart, type FunnelChartProps, type FunnelStep, Gate, GatePending, type GatePendingProps, type GateProps, IMPORTANCE_LEVELS, IconButton, type IconButtonProps, type ImportanceLevel, type ImportanceLevelId, ImportanceTag, type ImportanceTagProps, type ImportanceTokens, Input, type InputProps, type Job, type JobAction, type JobCardStatus, type JobStatus, JobTray, type JobTrayProps, Json, KeyHint, type KeyHintProps, type KeysetEnvelope, type KeysetServerTable, LAYER_STEP, type ListEnvelope, LoadingRegion, type LoadingRegionProps, Markdown, MarkdownEditor, type MarkdownEditorHandle, type MarkdownEditorProps, MarkdownInline, type MarkdownProps, type MarkdownSize, type MarkdownTone, type MentionSource, Menu, MenuButton, type MenuButtonProps, type MenuItem, type MenuProps, MessageBody, type MessageBodyProps, type MessageGroup, Meter, type MeterProps, type MeterSegment, type MeterSegmentInput, MixGap, type MixGapProps, type MixGapRow, MockJobKit, type MockJobStatus, Modal, type ModalProps, ModeSwitch, type ModeSwitchProps, type Model, ModelControls, type ModelControlsProps, NumberInput, type NumberInputProps, OVERLAY_BREAKPOINT, 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, RadioGroup, type RadioGroupOption, type RadioGroupProps, type RadioProps, RangeSlider, type RangeSliderProps, RelativeTime, type RelativeTimeProps, ReservedSkeleton, type ReservedSkeletonProps, 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, StatGrid, type StatGridProps, StatTile, type StatTileProps, type Step, StepList, type StepListProps, type StreamHandlers, type Suggestion, SurroundSound, type SurroundSoundProps, Switch, type SwitchProps, type TabItem, type TableQuery, Tabs, type TabsProps, Tag, type TagProps, TestModeBar, type TestModeBarProps, type TextScale, Textarea, type TextareaProps, type ThemeMode, ThinkingBlock, type ThinkingBlockProps, type ThreadSummary, TimePicker, type TimePickerProps, Toast, type ToastApi, type ToastOptions, type ToastProps, ToastProvider, Tooltip, type TooltipApi, type TooltipBinding, type TooltipPlacement, type TooltipProps, Topbar, type TopbarProps, TranscriptKit, TransferList, type TransferListProps, type TransferListSide, type TransferListSideProps, TrendChart, type TrendChartProps, type TrendSeries, USChoropleth, type USChoroplethProps, type StateFigure as USChoroplethState, type ChoroplethValue as USChoroplethValue, US_STATE_CODES, type UsageLimit, UseFeatureStatus, type UseKeysetTableOptions, type UseResponsiveRailOptions, type UseResponsiveRailResult, UseRuntimeMode, type UseServerTableOptions, type UseTooltipOptions, type User, VIRTUAL_LIST_BUFFER_ROWS, VIRTUAL_LIST_ROW_GAP, type VersionRecord, type VersionStore, VirtualList, type VirtualListProps, type VirtualLoadedBand, type VirtualWindow, type VoiceHandler, __resetLayerStackForTests, acceptMatches, anyOfFilter, applyAppearance, applyPrefs, channelWeightOf, computeNeedMore, computeVirtualWindow, copyToClipboard, createLocalStorageAppearanceStore, createVersionStore, eqFilter, extensionOf, extractClipboardFiles, filterFiles, formatAbsolute, formatBytes, formatClock, formatDocumentTitle, formatDuration, formatEta, formatRelative, formatShare, groupMessages, hasModifier, historyUrlAdapter, iconForMime, importanceLevel, importanceTokens, installFlytedeskFavicon, isImage, isSystemMessage, isUsStateCode, isWithinLayerTree, jobBucket, languageLabel, loadPrefs, meterFormats, modifierLabel, parseDelimited, pastedTextName, pluralizeUnit, preferenceScore, preferenceSegments, rangeFilter, readQueryFromUrl, resolveTheme, revokeAttachment, savePrefs, toAttachment, tokenize, useAppearancePrefs, useAppearanceStore, useChatEngine, useCopyToClipboard, useCornerStackSlot, useDocumentTitle, useFeatureStatus, useLayerZIndex, useOverlayLayout, usePopoverPosition, useResponsiveRail, useRuntimeMode, useServerTable, useSessionContext, useStackedLayer, useStagedFiles, useToast, useTooltip, validateFilterValue, visibleMessages, watchAppearance, writeQueryToUrl };
|