@flytedan/flytebot-design-system 0.44.0 → 0.46.0

package/dist/index.d.cts

@@ -317,13 +317,10 @@ interface CollapsibleProps {
 declare function Collapsible({ title, subtitle, badge, icon, defaultOpen, open, onToggle, children, className, ...rest }: CollapsibleProps): React.JSX.Element;
 
 /** A right-side panel for detail and editing without losing the list behind it.
- *  MP-248: always modal (declares `aria-modal="true"`), so it traps Tab/Shift+Tab inside
- *  itself and returns focus to its trigger on close, via the design system's shared
- *  `useFocusTrap` (the same hook Modal uses) — one focus-trap implementation, reused
- *  rather than hand-rolled a second time. Its own `TrapScope` (see useFocusTrap.ts) lets an
- *  overlay portaled from inside it (a Menu, a Select) register as still "inside" the trap,
- *  and it shares Popover's open-order Escape stack so Escape closes only the innermost live
- *  overlay, never this Drawer out from under one nested inside it. */
+ *  MP-248: always modal (declares `aria-modal="true"`), so it is a trapping layer in the
+ *  shared layer stack (kits/layerStack.tsx): Tab/Shift+Tab stay inside it and whatever is
+ *  opened from inside it, focus returns to its trigger on close, and Escape closes it only
+ *  when nothing opened from inside it is still open. */
 interface DrawerProps {
     open?: boolean;
     title?: React.ReactNode;
@@ -336,13 +333,11 @@ interface DrawerProps {
 declare function Drawer({ open, title, onClose, footer, children, className, ...rest }: DrawerProps): React.ReactPortal | null;
 
 /** A focused decision on a scrim. Max 560px, 760 with `wide` for data. Escape closes.
- *  MP-212: traps Tab/Shift+Tab inside the dialog box and returns focus to the opener on
- *  close, via the design system's shared `useFocusTrap` (the same hook `useResponsiveRail`
- *  uses) — one focus-trap implementation, reused rather than hand-rolled a second time.
- *  MP-248: its own `TrapScope` lets an overlay portaled from inside it (a Select's listbox)
- *  register as still "inside" the trap, and it shares Popover's open-order Escape stack so
- *  Escape closes only the innermost live overlay, never this Modal out from under one
- *  nested inside it. */
+ *  MP-212/MP-248: a trapping layer in the shared layer stack (kits/layerStack.tsx):
+ *  Tab/Shift+Tab stay inside the dialog box and whatever is opened from inside it, focus
+ *  returns to the opener on close, and Escape closes it only when nothing opened from inside
+ *  it is still open. Opened from inside a Drawer (or another Modal), it is that layer's child,
+ *  so it is the one that traps Tab while it is open. */
 interface ModalProps {
     open?: boolean;
     title?: React.ReactNode;
@@ -568,8 +563,9 @@ declare function Topbar({ crumbs, actions, overflowActions, overflowBreakpoint,
  * instead through `banner` and `trailingPanel`, or rendered around AppShell entirely.
  *
  * `useResponsiveRail` itself (overlay-vs-docked detection, Escape, focus trap/return,
- * body scroll lock) is unchanged and still exported on its own — AppShell only owns
- * wiring it to a real SidebarNav/Topbar/scrim so no app has to re-wire it by hand.
+ * body scroll lock) is still exported on its own — AppShell only owns wiring it to a real
+ * SidebarNav/Topbar/scrim so no app has to re-wire it by hand, including providing the
+ * rail's layer around SidebarNav so a menu opened in the rail is inside its focus scope.
  */
 interface AppShellProps {
     /** Rendered in SidebarNav's fixed-height brand row (e.g. FlytedeskBrand/FlytedeskMark,
@@ -3497,13 +3493,21 @@ interface ImportanceTagProps {
     showLabel?: boolean;
     size?: "sm" | "md";
     className?: string;
+    /** Paint the tag with the kit's own disabled tokens — the same trio `.fd-btn[disabled]`
+     *  uses (`--surface-3`/`--border`/`--text-disabled`) — instead of this level's own
+     *  fill/edge/text, and set `aria-disabled` and the `not-allowed` cursor. Never `opacity`,
+     *  per the kit's 0.41 rule: a disabled control keeps full-strength, AA-safe colour rather
+     *  than fading out. A consumer wrapping the tag in a disabled trigger (e.g. a raw
+     *  `<button disabled>`) should pass this through instead of hand-overriding the level's
+     *  `--imp-{rank}-*` tokens itself. */
+    disabled?: boolean;
 }
 /**
  * The level itself, as a small tinted tag — glyph plus name in that level's own fill,
  * edge and text tokens. Never colour alone: the name and the icon both carry the level,
  * so the five steps are still distinguishable without colour vision.
  */
-declare function ImportanceTag({ level, showLabel, size, className }: ImportanceTagProps): React.JSX.Element;
+declare function ImportanceTag({ level, showLabel, size, className, disabled }: ImportanceTagProps): React.JSX.Element;
 
 interface PreferenceCriterion {
     id: string;
@@ -4714,6 +4718,40 @@ interface VersionStore<TState, TDiff = unknown> {
 }
 declare function createVersionStore<TState, TDiff = unknown>(initialState: TState, options?: CreateVersionStoreOptions<TState, TDiff>): VersionStore<TState, TDiff>;
 
+interface StackedLayerOptions {
+    /** Whether the layer is open. It joins the stack while true. */
+    active: boolean;
+    /** The layer's own root element: what counts as inside it for focus. */
+    containerRef: React.RefObject<HTMLElement | null>;
+    /** A modal layer: while it is the innermost trapping layer, Tab and Shift+Tab stay inside
+     *  it and the layers opened from it, and focus moves into it when it opens. */
+    trap?: boolean;
+    /** Called when Escape is pressed while this is the innermost layer. A layer without one
+     *  still takes the press, so it never reaches a layer beneath. */
+    onEscape?: () => void;
+    /** When the layer closes while holding focus (or loses focus with its DOM), focus goes back
+     *  to the element that held it when the layer opened. Default true. */
+    returnFocus?: boolean;
+}
+/** A layer in the stack. Pass it to `StackedLayerProvider` around what the layer renders, so
+ *  anything opened from inside belongs to it. */
+interface StackedLayer {
+    readonly parent: StackedLayer | null;
+}
+/** Joins the stack while `active`. Returns the layer, for `StackedLayerProvider`. */
+declare function useStackedLayer(options: StackedLayerOptions): StackedLayer;
+/** Makes `layer` the owner of every layer opened from inside `children`, across portals. */
+declare function StackedLayerProvider({ layer, children }: {
+    layer: StackedLayer;
+    children: React.ReactNode;
+}): React.ReactElement;
+/** MP-248: whether `node` lies within `layer`'s own DOM, or the DOM of anything opened from
+ *  inside it — any layer it owns, portaled or not. For outside-click dismissal, which must
+ *  not fire for a click that landed inside a further layer this one opened (a Modal opened
+ *  from a Popover's own content) — the stack's real ownership, not a component's own class
+ *  name, which only ever recognised its own kind of layer. */
+declare function isWithinLayerTree(layer: StackedLayer, node: Node | null): boolean;
+
 /**
  * MP-214: the responsive-rail behaviour every app-level shell was hand-rolling (and, in
  * sms-app's case, already diverging on — see the SMS-5 architecture-gate review). Owns:
@@ -4723,12 +4761,11 @@ declare function createVersionStore<TState, TDiff = unknown>(initialState: TStat
  *   on the same number, since neither reads it from the other);
  * - the rail's open/closed state, forced closed on entry to overlay and forced open on
  *   return to docked (matching the desktop-collapse behaviour PlannerShell already had);
- * - Escape-to-close while the overlay is open;
+ * - Escape-to-close while the overlay is open, and a trapping layer in the shared layer stack
+ *   (layerStack.tsx) — Tab/Shift+Tab wrap inside the rail and whatever is opened from inside
+ *   it, and focus returns to whatever was focused before the overlay opened;
  * - a body scroll lock while the overlay is open, so the page behind a full-height
- *   off-canvas rail can't scroll;
- * - a focus trap (Tab/Shift+Tab wrap inside the rail) plus focus return to whatever was
- *   focused before the overlay opened — none of which any prior copy of this behaviour
- *   implemented.
+ *   off-canvas rail can't scroll.
  *
  * `initialOpen`/`onPersist` are the seam for a desktop-only persisted preference (e.g. a
  * `usePref`-backed value) — this hook never persists anything itself, and never reads or
@@ -4755,6 +4792,9 @@ interface UseResponsiveRailResult {
     /** Attach to the rail's root DOM node (e.g. `SidebarNav`'s forwarded ref) — required for
      *  the focus trap and initial-focus behaviour while the overlay is open. */
     navRef: React.RefObject<HTMLElement>;
+    /** The rail's layer. Wrap the rail's content in `StackedLayerProvider` with it, so a menu
+     *  opened from inside the rail belongs to the rail's focus scope. */
+    layer: StackedLayer;
     /** Flips `open`. Wire directly to `Topbar`'s `onMenu` — works at every width the rail is
      *  shown at, docked or overlay, never a no-op. */
     toggle: () => void;
@@ -4767,49 +4807,6 @@ interface UseResponsiveRailResult {
 }
 declare function useResponsiveRail(options?: UseResponsiveRailOptions): UseResponsiveRailResult;
 
-/**
- * MP-248: a trapped container's own DOM subtree is not the only place focus may legitimately
- * be while the trap is active. Every Popover-based overlay (Menu, MenuButton, Select,
- * AppearanceMenu, AccountMenu — anything rendered through `portal()` in Popover.tsx) renders
- * into `document.body`, a DOM SIBLING of a Drawer's `<aside>` or a Modal's box, never a
- * descendant — so `container.contains(activeElement)` can never see it, and the trap's Tab
- * handler used to yank focus back out of it on every Tab press.
- *
- * React context still threads through a portal boundary (only the DOM tree changes, not the
- * component tree), so a `TrapScope` created by whichever Drawer/Modal owns the active trap is
- * threaded down via `TrapScopeProvider`, and anything portaled from inside that subtree —
- * however deep, since nothing re-provides a new scope further down — registers its own
- * rendered root against it. The trap then treats focus inside any registered node as still
- * "inside", exactly like a real DOM descendant would be, without a second trap
- * implementation or a class-name/DOM-attribute sniff.
- */
-interface TrapScope {
-    /** Registers `node` as belonging to this scope for as long as the caller keeps it
-     *  registered; call the returned function to unregister (mirrors an effect cleanup). */
-    registerEscapedNode(node: HTMLElement): () => void;
-    /** Whether `node` is, or is contained by, any node currently registered in this scope. */
-    ownsNode(node: Node): boolean;
-}
-/** Creates one trap's scope. Called once by whatever owns a trapped container (Drawer,
- *  Modal) and passed both to `useFocusTrap` and to `TrapScopeProvider` wrapping its own
- *  rendered content, so anything portaled from inside that content can join it. */
-declare function useTrapScope(): TrapScope;
-/** Threads `scope` to any descendant that calls `useEscapeTrapRegistration` — including
- *  across a `createPortal` boundary, since context follows the component tree, not the DOM
- *  tree. Nothing re-provides a scope further down (Popover does not wrap its own content in
- *  a new provider), so a Popover opened from inside another Popover opened from inside a
- *  Drawer still registers against that same Drawer's scope, however many levels deep. */
-declare function TrapScopeProvider({ scope, children }: {
-    scope: TrapScope;
-    children: React.ReactNode;
-}): React.ReactElement;
-/** Called by a portaled overlay (Popover) to register its own rendered root as belonging to
- *  the nearest enclosing `TrapScope`, while `active`. A no-op when there is no enclosing
- *  scope — i.e. the overlay wasn't opened from inside a trapped Drawer/Modal at all, so there
- *  is nothing for its focus to escape from in the first place. */
-declare function useEscapeTrapRegistration(nodeRef: React.RefObject<HTMLElement | null>, active: boolean): void;
-declare function useFocusTrap(containerRef: React.RefObject<HTMLElement | null>, active: boolean, scope?: TrapScope): void;
-
 /**
  * MP-221: the "<route> · <app> · Flytedesk" title convention every flytedesk app shell
  * hand-typed per route (sms-app's CampaignAnalytics.tsx, QueryTool.tsx, NotFound.tsx,
@@ -4828,4 +4825,4 @@ declare function formatDocumentTitle(routeTitle: string | undefined | null, appN
  */
 declare function useDocumentTitle(routeTitle: string | undefined | null, appName: string): void;
 
-export { AccountMenu, type AccountMenuLink, type AccountMenuProps, AgentChatPanel, type AgentChatPanelProps, AnchoredPopover, type AnchoredPopoverProps, AnimNum, type AnimNumProps, ApiSpecBrowser, type ApiSpecBrowserProps, type AppEntry, AppShell, type AppShellProps, AppSwitcher, type AppSwitcherProps, AppearanceMenu, type AppearanceMenuProps, type AppearancePrefs, type AppearanceStore, type AppearanceStoreOptions, type Attachment, Avatar, type AvatarProps, AvatarStack, type AvatarStackProps, Badge, type BadgeProps, Banner, type BannerProps, type BannerTone, BarList, type BarListProps, type BarListRow, BudgetReallocator, type BudgetReallocatorProps, Button, type ButtonProps, CHANNELS, CHANNEL_WEIGHTS, CHAT_UNAVAILABLE, Calendar, type CalendarProps, Card, type CardProps, CardRow, type CardRowProps, ChannelContribution, type ChannelContributionChannel, type ChannelContributionProps, ChannelMeta, type ChannelMetaRecord, ChannelTag, type ChannelTagProps, ChannelWeightOf, type ChatAdapter, ChatComposer, type ChatComposerProps, type ChatEngine, type ChatEngineOptions, ChatKit, type ChatMessage, type ChatRenderContext, ChatSessionBar, type ChatSessionBarProps, ChatTranscript, type ChatTranscriptProps, ChatTurn, type ChatTurnProps, Checkbox, type CheckboxProps, type Citation, Citations, type CitationsProps, Clamp, type ClampProps, ClockFace, type ClockFaceProps, CodeBlock, type CodeBlockProps, Collapsible, type CollapsibleProps, ComingSoon, type ComingSoonProps, type ContextUsage, type CreateVersionStoreOptions, CsiBadge, type CsiBadgeProps, CsiHero, type CsiHeroProps, CsiMeter, type CsiMeterProps, DEFAULT_PREFS, DEFAULT_STORAGE_KEY, DataTable, type DataTableColumn, type DataTableProps, DatePicker, type DatePickerProps, type DemoSessionControls, DemoSessionProvider, type DeviceSession, DiffBlock, type DiffBlockProps, DonutChart, type DonutChartProps, type DonutSegment, Drawer, type DrawerProps, Dropzone, DropzoneKit, type DropzoneProps, ENTITY_ROW_METRIC_WIDTH, type EditorTrigger, EmptyState, type EmptyStateProps, type EndpointSpec, EntityRow, type EntityRowAction, type EntityRowContent, type EntityRowMetric, EntityRowMetrics, type EntityRowMetricsProps, type EntityRowProps, FILE_VIEWER_CSV_ROW_LIMIT, FILE_VIEWER_TEXT_LIMIT, FeatureGate, type FeatureGateProps, type FeatureStatus, FileBrowser, type FileBrowserFile, type FileBrowserFolder, type FileBrowserPermissions, type FileBrowserProps, FileChip, type FileChipProps, FileGrid, type FileGridProps, FileKit, FilePickButton, type FilePickButtonProps, type FileRejection, FileStrip, type FileStripProps, FileTile, type FileTileProps, type FileUploadHandler, FileViewer, type FileViewerProps, FilterBar, type FilterBarProps, type 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 ListEnvelope, LoadingRegion, type LoadingRegionProps, Markdown, MarkdownEditor, type MarkdownEditorHandle, type MarkdownEditorProps, MarkdownInline, type MarkdownProps, type MentionSource, Menu, MenuButton, type MenuButtonProps, type MenuItem, type MenuProps, MessageBody, type MessageBodyProps, type MessageGroup, Meter, type MeterProps, type MeterSegment, type MeterSegmentInput, MixGap, type MixGapProps, type MixGapRow, MockJobKit, type MockJobStatus, Modal, type ModalProps, ModeSwitch, type ModeSwitchProps, type Model, ModelControls, type ModelControlsProps, NumberInput, type NumberInputProps, POPOVER_BODY_MIN, type Packet, PacketCard, type PacketCardProps, type PacketSchema, type Pager, Pagination, type PaginationProps, PermissionDenied, type PermissionDeniedProps, type PermissionGroup, PermissionHint, type PermissionItem, type Phase, type PhaseStatus, PhasedProgress, type PhasedProgressProps, type Placement, type PollOptions, Popover, type PopoverProps, type PreferenceCriterion, PreferenceMeter, type PreferenceMeterProps, type ProfileFieldDef, type ProfileFieldType, type ProfileNotificationDef, ProfilePage, type ProfilePageProps, ProgressBar, type ProgressBarProps, QueryKit, type QueuedTurn, QuotaRow, type QuotaRowProps, Radio, type RadioProps, RangeSlider, type RangeSliderProps, RelativeTime, type RelativeTimeProps, type RoadmapItem, type RoadmapResult, RoadmapTimeline, type RoadmapTimelineProps, type Role, RunActions, type RunActionsProps, type RunConfig, RuntimeKit, type RuntimeSummary, SaturationDistribution, type SaturationDistributionCampus, type SaturationDistributionProps, ScoreMeter, type ScoreMeterProps, ScreenHead, type ScreenHeadProps, SearchField, type SearchFieldProps, SegmentedControl, type SegmentedControlProps, SegmentedMeter, type SegmentedMeterProps, Select, type SelectOption, type SelectProps, type SendMessageResult, type ServerTable, type Session, type SessionContextValue, type Flag as SessionFlag, SessionKit, SessionProvider, type SessionProviderProps, type SessionRole, type SessionStats, type SessionUser, SidebarNav, type SidebarNavItem, type SidebarNavProps, type SignInContinueAs, SignInPage, type SignInPageProps, Skeleton, type SkeletonProps, SkeletonText, type SkeletonTextProps, type SlashCommand, Slider, type SliderProps, SortMenu, type SortMenuField, type SortMenuProps, type SpecModule, Spinner, type SpinnerProps, StatTile, type StatTileProps, type Step, StepList, type StepListProps, type StreamHandlers, type Suggestion, SurroundSound, type SurroundSoundProps, Switch, type SwitchProps, type TableQuery, Tabs, type TabsProps, Tag, type TagProps, TestModeBar, type TestModeBarProps, type TextScale, Textarea, type TextareaProps, type ThemeMode, ThinkingBlock, type ThinkingBlockProps, type ThreadSummary, TimePicker, type TimePickerProps, Toast, type ToastProps, Tooltip, type TooltipProps, Topbar, type TopbarProps, TranscriptKit, TransferList, type TransferListProps, type TransferListSide, type TransferListSideProps, type TrapScope, TrapScopeProvider, TrendChart, type TrendChartProps, type TrendSeries, type UsageLimit, UseFeatureStatus, type UseResponsiveRailOptions, type UseResponsiveRailResult, UseRuntimeMode, type UseServerTableOptions, type User, VIRTUAL_LIST_BUFFER_ROWS, VIRTUAL_LIST_ROW_GAP, type VersionRecord, type VersionStore, VirtualList, type VirtualListProps, type VirtualLoadedBand, type VirtualWindow, type VoiceHandler, acceptMatches, anyOfFilter, applyPrefs, channelWeightOf, computeNeedMore, computeVirtualWindow, createLocalStorageAppearanceStore, createVersionStore, eqFilter, extensionOf, extractClipboardFiles, filterFiles, formatAbsolute, formatBytes, formatClock, formatDocumentTitle, formatDuration, formatEta, formatRelative, groupMessages, hasModifier, iconForMime, importanceLevel, importanceTokens, installFlytedeskFavicon, isImage, isSystemMessage, jobBucket, languageLabel, loadPrefs, markdownToText, meterFormats, modifierLabel, parseDelimited, pastedTextName, pluralizeUnit, preferenceScore, preferenceSegments, rangeFilter, resolveTheme, revokeAttachment, savePrefs, toAttachment, tokenize, useAppearancePrefs, useChatEngine, useDocumentTitle, useEscapeTrapRegistration, useFeatureStatus, useFocusTrap, usePopoverPosition, useResponsiveRail, useRuntimeMode, useServerTable, useSessionContext, useStagedFiles, useTrapScope, validateFilterValue, visibleMessages };
+export { AccountMenu, type AccountMenuLink, type AccountMenuProps, AgentChatPanel, type AgentChatPanelProps, AnchoredPopover, type AnchoredPopoverProps, AnimNum, type AnimNumProps, ApiSpecBrowser, type ApiSpecBrowserProps, type AppEntry, AppShell, type AppShellProps, AppSwitcher, type AppSwitcherProps, AppearanceMenu, type AppearanceMenuProps, type AppearancePrefs, type AppearanceStore, type AppearanceStoreOptions, type Attachment, Avatar, type AvatarProps, AvatarStack, type AvatarStackProps, Badge, type BadgeProps, Banner, type BannerProps, type BannerTone, BarList, type BarListProps, type BarListRow, BudgetReallocator, type BudgetReallocatorProps, Button, type ButtonProps, CHANNELS, CHANNEL_WEIGHTS, CHAT_UNAVAILABLE, Calendar, type CalendarProps, Card, type CardProps, CardRow, type CardRowProps, ChannelContribution, type ChannelContributionChannel, type ChannelContributionProps, ChannelMeta, type ChannelMetaRecord, ChannelTag, type ChannelTagProps, ChannelWeightOf, type ChatAdapter, ChatComposer, type ChatComposerProps, type ChatEngine, type ChatEngineOptions, ChatKit, type ChatMessage, type ChatRenderContext, ChatSessionBar, type ChatSessionBarProps, ChatTranscript, type ChatTranscriptProps, ChatTurn, type ChatTurnProps, Checkbox, type CheckboxProps, type Citation, Citations, type CitationsProps, Clamp, type ClampProps, ClockFace, type ClockFaceProps, CodeBlock, type CodeBlockProps, Collapsible, type CollapsibleProps, ComingSoon, type ComingSoonProps, type ContextUsage, type CreateVersionStoreOptions, CsiBadge, type CsiBadgeProps, CsiHero, type CsiHeroProps, CsiMeter, type CsiMeterProps, DEFAULT_PREFS, DEFAULT_STORAGE_KEY, DataTable, type DataTableColumn, type DataTableProps, DatePicker, type DatePickerProps, type DemoSessionControls, DemoSessionProvider, type DeviceSession, DiffBlock, type DiffBlockProps, DonutChart, type DonutChartProps, type DonutSegment, Drawer, type DrawerProps, Dropzone, DropzoneKit, type DropzoneProps, ENTITY_ROW_METRIC_WIDTH, type EditorTrigger, EmptyState, type EmptyStateProps, type EndpointSpec, EntityRow, type EntityRowAction, type EntityRowContent, type EntityRowMetric, EntityRowMetrics, type EntityRowMetricsProps, type EntityRowProps, FILE_VIEWER_CSV_ROW_LIMIT, FILE_VIEWER_TEXT_LIMIT, FeatureGate, type FeatureGateProps, type FeatureStatus, FileBrowser, type FileBrowserFile, type FileBrowserFolder, type FileBrowserPermissions, type FileBrowserProps, FileChip, type FileChipProps, FileGrid, type FileGridProps, FileKit, FilePickButton, type FilePickButtonProps, type FileRejection, FileStrip, type FileStripProps, FileTile, type FileTileProps, type FileUploadHandler, FileViewer, type FileViewerProps, FilterBar, type FilterBarProps, type FilterDateValue, type FilterField, type FilterFieldDate, type FilterFieldMultiSelect, type FilterFieldOption, type FilterFieldRange, type FilterFieldSelect, type FilterFieldText, type FilterMultiSelectValue, type FilterOperator, type FilterRangeValue, type FilterResolveMatch, type FilterResolveResult, type 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 ListEnvelope, LoadingRegion, type LoadingRegionProps, Markdown, MarkdownEditor, type MarkdownEditorHandle, type MarkdownEditorProps, MarkdownInline, type MarkdownProps, type MentionSource, Menu, MenuButton, type MenuButtonProps, type MenuItem, type MenuProps, MessageBody, type MessageBodyProps, type MessageGroup, Meter, type MeterProps, type MeterSegment, type MeterSegmentInput, MixGap, type MixGapProps, type MixGapRow, MockJobKit, type MockJobStatus, Modal, type ModalProps, ModeSwitch, type ModeSwitchProps, type Model, ModelControls, type ModelControlsProps, NumberInput, type NumberInputProps, POPOVER_BODY_MIN, type Packet, PacketCard, type PacketCardProps, type PacketSchema, type Pager, Pagination, type PaginationProps, PermissionDenied, type PermissionDeniedProps, type PermissionGroup, PermissionHint, type PermissionItem, type Phase, type PhaseStatus, PhasedProgress, type PhasedProgressProps, type Placement, type PollOptions, Popover, type PopoverProps, type PreferenceCriterion, PreferenceMeter, type PreferenceMeterProps, type ProfileFieldDef, type ProfileFieldType, type ProfileNotificationDef, ProfilePage, type ProfilePageProps, ProgressBar, type ProgressBarProps, QueryKit, type QueuedTurn, QuotaRow, type QuotaRowProps, Radio, type RadioProps, RangeSlider, type RangeSliderProps, RelativeTime, type RelativeTimeProps, type RoadmapItem, type RoadmapResult, RoadmapTimeline, type RoadmapTimelineProps, type Role, RunActions, type RunActionsProps, type RunConfig, RuntimeKit, type RuntimeSummary, SaturationDistribution, type SaturationDistributionCampus, type SaturationDistributionProps, ScoreMeter, type ScoreMeterProps, ScreenHead, type ScreenHeadProps, SearchField, type SearchFieldProps, SegmentedControl, type SegmentedControlProps, SegmentedMeter, type SegmentedMeterProps, Select, type SelectOption, type SelectProps, type SendMessageResult, type ServerTable, type Session, type SessionContextValue, type Flag as SessionFlag, SessionKit, SessionProvider, type SessionProviderProps, type SessionRole, type SessionStats, type SessionUser, SidebarNav, type SidebarNavItem, type SidebarNavProps, type SignInContinueAs, SignInPage, type SignInPageProps, Skeleton, type SkeletonProps, SkeletonText, type SkeletonTextProps, type SlashCommand, Slider, type SliderProps, SortMenu, type SortMenuField, type SortMenuProps, type SpecModule, Spinner, type SpinnerProps, type StackedLayer, type StackedLayerOptions, StackedLayerProvider, StatTile, type StatTileProps, type Step, StepList, type StepListProps, type StreamHandlers, type Suggestion, SurroundSound, type SurroundSoundProps, Switch, type SwitchProps, type TableQuery, Tabs, type TabsProps, Tag, type TagProps, TestModeBar, type TestModeBarProps, type TextScale, Textarea, type TextareaProps, type ThemeMode, ThinkingBlock, type ThinkingBlockProps, type ThreadSummary, TimePicker, type TimePickerProps, Toast, type ToastProps, Tooltip, type TooltipProps, Topbar, type TopbarProps, TranscriptKit, TransferList, type TransferListProps, type TransferListSide, type TransferListSideProps, TrendChart, type TrendChartProps, type TrendSeries, type UsageLimit, UseFeatureStatus, type UseResponsiveRailOptions, type UseResponsiveRailResult, UseRuntimeMode, type UseServerTableOptions, type User, VIRTUAL_LIST_BUFFER_ROWS, VIRTUAL_LIST_ROW_GAP, type VersionRecord, type VersionStore, VirtualList, type VirtualListProps, type VirtualLoadedBand, type VirtualWindow, type VoiceHandler, acceptMatches, anyOfFilter, applyPrefs, channelWeightOf, computeNeedMore, computeVirtualWindow, createLocalStorageAppearanceStore, createVersionStore, eqFilter, extensionOf, extractClipboardFiles, filterFiles, formatAbsolute, formatBytes, formatClock, formatDocumentTitle, formatDuration, formatEta, formatRelative, groupMessages, hasModifier, iconForMime, importanceLevel, importanceTokens, installFlytedeskFavicon, isImage, isSystemMessage, isWithinLayerTree, jobBucket, languageLabel, loadPrefs, markdownToText, meterFormats, modifierLabel, parseDelimited, pastedTextName, pluralizeUnit, preferenceScore, preferenceSegments, rangeFilter, resolveTheme, revokeAttachment, savePrefs, toAttachment, tokenize, useAppearancePrefs, useChatEngine, useDocumentTitle, useFeatureStatus, usePopoverPosition, useResponsiveRail, useRuntimeMode, useServerTable, useSessionContext, useStackedLayer, useStagedFiles, validateFilterValue, visibleMessages };

package/dist/index.d.ts

@@ -317,13 +317,10 @@ interface CollapsibleProps {
 declare function Collapsible({ title, subtitle, badge, icon, defaultOpen, open, onToggle, children, className, ...rest }: CollapsibleProps): React.JSX.Element;
 
 /** A right-side panel for detail and editing without losing the list behind it.
- *  MP-248: always modal (declares `aria-modal="true"`), so it traps Tab/Shift+Tab inside
- *  itself and returns focus to its trigger on close, via the design system's shared
- *  `useFocusTrap` (the same hook Modal uses) — one focus-trap implementation, reused
- *  rather than hand-rolled a second time. Its own `TrapScope` (see useFocusTrap.ts) lets an
- *  overlay portaled from inside it (a Menu, a Select) register as still "inside" the trap,
- *  and it shares Popover's open-order Escape stack so Escape closes only the innermost live
- *  overlay, never this Drawer out from under one nested inside it. */
+ *  MP-248: always modal (declares `aria-modal="true"`), so it is a trapping layer in the
+ *  shared layer stack (kits/layerStack.tsx): Tab/Shift+Tab stay inside it and whatever is
+ *  opened from inside it, focus returns to its trigger on close, and Escape closes it only
+ *  when nothing opened from inside it is still open. */
 interface DrawerProps {
     open?: boolean;
     title?: React.ReactNode;
@@ -336,13 +333,11 @@ interface DrawerProps {
 declare function Drawer({ open, title, onClose, footer, children, className, ...rest }: DrawerProps): React.ReactPortal | null;
 
 /** A focused decision on a scrim. Max 560px, 760 with `wide` for data. Escape closes.
- *  MP-212: traps Tab/Shift+Tab inside the dialog box and returns focus to the opener on
- *  close, via the design system's shared `useFocusTrap` (the same hook `useResponsiveRail`
- *  uses) — one focus-trap implementation, reused rather than hand-rolled a second time.
- *  MP-248: its own `TrapScope` lets an overlay portaled from inside it (a Select's listbox)
- *  register as still "inside" the trap, and it shares Popover's open-order Escape stack so
- *  Escape closes only the innermost live overlay, never this Modal out from under one
- *  nested inside it. */
+ *  MP-212/MP-248: a trapping layer in the shared layer stack (kits/layerStack.tsx):
+ *  Tab/Shift+Tab stay inside the dialog box and whatever is opened from inside it, focus
+ *  returns to the opener on close, and Escape closes it only when nothing opened from inside
+ *  it is still open. Opened from inside a Drawer (or another Modal), it is that layer's child,
+ *  so it is the one that traps Tab while it is open. */
 interface ModalProps {
     open?: boolean;
     title?: React.ReactNode;
@@ -568,8 +563,9 @@ declare function Topbar({ crumbs, actions, overflowActions, overflowBreakpoint,
  * instead through `banner` and `trailingPanel`, or rendered around AppShell entirely.
  *
  * `useResponsiveRail` itself (overlay-vs-docked detection, Escape, focus trap/return,
- * body scroll lock) is unchanged and still exported on its own — AppShell only owns
- * wiring it to a real SidebarNav/Topbar/scrim so no app has to re-wire it by hand.
+ * body scroll lock) is still exported on its own — AppShell only owns wiring it to a real
+ * SidebarNav/Topbar/scrim so no app has to re-wire it by hand, including providing the
+ * rail's layer around SidebarNav so a menu opened in the rail is inside its focus scope.
  */
 interface AppShellProps {
     /** Rendered in SidebarNav's fixed-height brand row (e.g. FlytedeskBrand/FlytedeskMark,
@@ -3497,13 +3493,21 @@ interface ImportanceTagProps {
     showLabel?: boolean;
     size?: "sm" | "md";
     className?: string;
+    /** Paint the tag with the kit's own disabled tokens — the same trio `.fd-btn[disabled]`
+     *  uses (`--surface-3`/`--border`/`--text-disabled`) — instead of this level's own
+     *  fill/edge/text, and set `aria-disabled` and the `not-allowed` cursor. Never `opacity`,
+     *  per the kit's 0.41 rule: a disabled control keeps full-strength, AA-safe colour rather
+     *  than fading out. A consumer wrapping the tag in a disabled trigger (e.g. a raw
+     *  `<button disabled>`) should pass this through instead of hand-overriding the level's
+     *  `--imp-{rank}-*` tokens itself. */
+    disabled?: boolean;
 }
 /**
  * The level itself, as a small tinted tag — glyph plus name in that level's own fill,
  * edge and text tokens. Never colour alone: the name and the icon both carry the level,
  * so the five steps are still distinguishable without colour vision.
  */
-declare function ImportanceTag({ level, showLabel, size, className }: ImportanceTagProps): React.JSX.Element;
+declare function ImportanceTag({ level, showLabel, size, className, disabled }: ImportanceTagProps): React.JSX.Element;
 
 interface PreferenceCriterion {
     id: string;
@@ -4714,6 +4718,40 @@ interface VersionStore<TState, TDiff = unknown> {
 }
 declare function createVersionStore<TState, TDiff = unknown>(initialState: TState, options?: CreateVersionStoreOptions<TState, TDiff>): VersionStore<TState, TDiff>;
 
+interface StackedLayerOptions {
+    /** Whether the layer is open. It joins the stack while true. */
+    active: boolean;
+    /** The layer's own root element: what counts as inside it for focus. */
+    containerRef: React.RefObject<HTMLElement | null>;
+    /** A modal layer: while it is the innermost trapping layer, Tab and Shift+Tab stay inside
+     *  it and the layers opened from it, and focus moves into it when it opens. */
+    trap?: boolean;
+    /** Called when Escape is pressed while this is the innermost layer. A layer without one
+     *  still takes the press, so it never reaches a layer beneath. */
+    onEscape?: () => void;
+    /** When the layer closes while holding focus (or loses focus with its DOM), focus goes back
+     *  to the element that held it when the layer opened. Default true. */
+    returnFocus?: boolean;
+}
+/** A layer in the stack. Pass it to `StackedLayerProvider` around what the layer renders, so
+ *  anything opened from inside belongs to it. */
+interface StackedLayer {
+    readonly parent: StackedLayer | null;
+}
+/** Joins the stack while `active`. Returns the layer, for `StackedLayerProvider`. */
+declare function useStackedLayer(options: StackedLayerOptions): StackedLayer;
+/** Makes `layer` the owner of every layer opened from inside `children`, across portals. */
+declare function StackedLayerProvider({ layer, children }: {
+    layer: StackedLayer;
+    children: React.ReactNode;
+}): React.ReactElement;
+/** MP-248: whether `node` lies within `layer`'s own DOM, or the DOM of anything opened from
+ *  inside it — any layer it owns, portaled or not. For outside-click dismissal, which must
+ *  not fire for a click that landed inside a further layer this one opened (a Modal opened
+ *  from a Popover's own content) — the stack's real ownership, not a component's own class
+ *  name, which only ever recognised its own kind of layer. */
+declare function isWithinLayerTree(layer: StackedLayer, node: Node | null): boolean;
+
 /**
  * MP-214: the responsive-rail behaviour every app-level shell was hand-rolling (and, in
  * sms-app's case, already diverging on — see the SMS-5 architecture-gate review). Owns:
@@ -4723,12 +4761,11 @@ declare function createVersionStore<TState, TDiff = unknown>(initialState: TStat
  *   on the same number, since neither reads it from the other);
  * - the rail's open/closed state, forced closed on entry to overlay and forced open on
  *   return to docked (matching the desktop-collapse behaviour PlannerShell already had);
- * - Escape-to-close while the overlay is open;
+ * - Escape-to-close while the overlay is open, and a trapping layer in the shared layer stack
+ *   (layerStack.tsx) — Tab/Shift+Tab wrap inside the rail and whatever is opened from inside
+ *   it, and focus returns to whatever was focused before the overlay opened;
  * - a body scroll lock while the overlay is open, so the page behind a full-height
- *   off-canvas rail can't scroll;
- * - a focus trap (Tab/Shift+Tab wrap inside the rail) plus focus return to whatever was
- *   focused before the overlay opened — none of which any prior copy of this behaviour
- *   implemented.
+ *   off-canvas rail can't scroll.
  *
  * `initialOpen`/`onPersist` are the seam for a desktop-only persisted preference (e.g. a
  * `usePref`-backed value) — this hook never persists anything itself, and never reads or
@@ -4755,6 +4792,9 @@ interface UseResponsiveRailResult {
     /** Attach to the rail's root DOM node (e.g. `SidebarNav`'s forwarded ref) — required for
      *  the focus trap and initial-focus behaviour while the overlay is open. */
     navRef: React.RefObject<HTMLElement>;
+    /** The rail's layer. Wrap the rail's content in `StackedLayerProvider` with it, so a menu
+     *  opened from inside the rail belongs to the rail's focus scope. */
+    layer: StackedLayer;
     /** Flips `open`. Wire directly to `Topbar`'s `onMenu` — works at every width the rail is
      *  shown at, docked or overlay, never a no-op. */
     toggle: () => void;
@@ -4767,49 +4807,6 @@ interface UseResponsiveRailResult {
 }
 declare function useResponsiveRail(options?: UseResponsiveRailOptions): UseResponsiveRailResult;
 
-/**
- * MP-248: a trapped container's own DOM subtree is not the only place focus may legitimately
- * be while the trap is active. Every Popover-based overlay (Menu, MenuButton, Select,
- * AppearanceMenu, AccountMenu — anything rendered through `portal()` in Popover.tsx) renders
- * into `document.body`, a DOM SIBLING of a Drawer's `<aside>` or a Modal's box, never a
- * descendant — so `container.contains(activeElement)` can never see it, and the trap's Tab
- * handler used to yank focus back out of it on every Tab press.
- *
- * React context still threads through a portal boundary (only the DOM tree changes, not the
- * component tree), so a `TrapScope` created by whichever Drawer/Modal owns the active trap is
- * threaded down via `TrapScopeProvider`, and anything portaled from inside that subtree —
- * however deep, since nothing re-provides a new scope further down — registers its own
- * rendered root against it. The trap then treats focus inside any registered node as still
- * "inside", exactly like a real DOM descendant would be, without a second trap
- * implementation or a class-name/DOM-attribute sniff.
- */
-interface TrapScope {
-    /** Registers `node` as belonging to this scope for as long as the caller keeps it
-     *  registered; call the returned function to unregister (mirrors an effect cleanup). */
-    registerEscapedNode(node: HTMLElement): () => void;
-    /** Whether `node` is, or is contained by, any node currently registered in this scope. */
-    ownsNode(node: Node): boolean;
-}
-/** Creates one trap's scope. Called once by whatever owns a trapped container (Drawer,
- *  Modal) and passed both to `useFocusTrap` and to `TrapScopeProvider` wrapping its own
- *  rendered content, so anything portaled from inside that content can join it. */
-declare function useTrapScope(): TrapScope;
-/** Threads `scope` to any descendant that calls `useEscapeTrapRegistration` — including
- *  across a `createPortal` boundary, since context follows the component tree, not the DOM
- *  tree. Nothing re-provides a scope further down (Popover does not wrap its own content in
- *  a new provider), so a Popover opened from inside another Popover opened from inside a
- *  Drawer still registers against that same Drawer's scope, however many levels deep. */
-declare function TrapScopeProvider({ scope, children }: {
-    scope: TrapScope;
-    children: React.ReactNode;
-}): React.ReactElement;
-/** Called by a portaled overlay (Popover) to register its own rendered root as belonging to
- *  the nearest enclosing `TrapScope`, while `active`. A no-op when there is no enclosing
- *  scope — i.e. the overlay wasn't opened from inside a trapped Drawer/Modal at all, so there
- *  is nothing for its focus to escape from in the first place. */
-declare function useEscapeTrapRegistration(nodeRef: React.RefObject<HTMLElement | null>, active: boolean): void;
-declare function useFocusTrap(containerRef: React.RefObject<HTMLElement | null>, active: boolean, scope?: TrapScope): void;
-
 /**
  * MP-221: the "<route> · <app> · Flytedesk" title convention every flytedesk app shell
  * hand-typed per route (sms-app's CampaignAnalytics.tsx, QueryTool.tsx, NotFound.tsx,
@@ -4828,4 +4825,4 @@ declare function formatDocumentTitle(routeTitle: string | undefined | null, appN
  */
 declare function useDocumentTitle(routeTitle: string | undefined | null, appName: string): void;
 
-export { AccountMenu, type AccountMenuLink, type AccountMenuProps, AgentChatPanel, type AgentChatPanelProps, AnchoredPopover, type AnchoredPopoverProps, AnimNum, type AnimNumProps, ApiSpecBrowser, type ApiSpecBrowserProps, type AppEntry, AppShell, type AppShellProps, AppSwitcher, type AppSwitcherProps, AppearanceMenu, type AppearanceMenuProps, type AppearancePrefs, type AppearanceStore, type AppearanceStoreOptions, type Attachment, Avatar, type AvatarProps, AvatarStack, type AvatarStackProps, Badge, type BadgeProps, Banner, type BannerProps, type BannerTone, BarList, type BarListProps, type BarListRow, BudgetReallocator, type BudgetReallocatorProps, Button, type ButtonProps, CHANNELS, CHANNEL_WEIGHTS, CHAT_UNAVAILABLE, Calendar, type CalendarProps, Card, type CardProps, CardRow, type CardRowProps, ChannelContribution, type ChannelContributionChannel, type ChannelContributionProps, ChannelMeta, type ChannelMetaRecord, ChannelTag, type ChannelTagProps, ChannelWeightOf, type ChatAdapter, ChatComposer, type ChatComposerProps, type ChatEngine, type ChatEngineOptions, ChatKit, type ChatMessage, type ChatRenderContext, ChatSessionBar, type ChatSessionBarProps, ChatTranscript, type ChatTranscriptProps, ChatTurn, type ChatTurnProps, Checkbox, type CheckboxProps, type Citation, Citations, type CitationsProps, Clamp, type ClampProps, ClockFace, type ClockFaceProps, CodeBlock, type CodeBlockProps, Collapsible, type CollapsibleProps, ComingSoon, type ComingSoonProps, type ContextUsage, type CreateVersionStoreOptions, CsiBadge, type CsiBadgeProps, CsiHero, type CsiHeroProps, CsiMeter, type CsiMeterProps, DEFAULT_PREFS, DEFAULT_STORAGE_KEY, DataTable, type DataTableColumn, type DataTableProps, DatePicker, type DatePickerProps, type DemoSessionControls, DemoSessionProvider, type DeviceSession, DiffBlock, type DiffBlockProps, DonutChart, type DonutChartProps, type DonutSegment, Drawer, type DrawerProps, Dropzone, DropzoneKit, type DropzoneProps, ENTITY_ROW_METRIC_WIDTH, type EditorTrigger, EmptyState, type EmptyStateProps, type EndpointSpec, EntityRow, type EntityRowAction, type EntityRowContent, type EntityRowMetric, EntityRowMetrics, type EntityRowMetricsProps, type EntityRowProps, FILE_VIEWER_CSV_ROW_LIMIT, FILE_VIEWER_TEXT_LIMIT, FeatureGate, type FeatureGateProps, type FeatureStatus, FileBrowser, type FileBrowserFile, type FileBrowserFolder, type FileBrowserPermissions, type FileBrowserProps, FileChip, type FileChipProps, FileGrid, type FileGridProps, FileKit, FilePickButton, type FilePickButtonProps, type FileRejection, FileStrip, type FileStripProps, FileTile, type FileTileProps, type FileUploadHandler, FileViewer, type FileViewerProps, FilterBar, type FilterBarProps, type 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 ListEnvelope, LoadingRegion, type LoadingRegionProps, Markdown, MarkdownEditor, type MarkdownEditorHandle, type MarkdownEditorProps, MarkdownInline, type MarkdownProps, type MentionSource, Menu, MenuButton, type MenuButtonProps, type MenuItem, type MenuProps, MessageBody, type MessageBodyProps, type MessageGroup, Meter, type MeterProps, type MeterSegment, type MeterSegmentInput, MixGap, type MixGapProps, type MixGapRow, MockJobKit, type MockJobStatus, Modal, type ModalProps, ModeSwitch, type ModeSwitchProps, type Model, ModelControls, type ModelControlsProps, NumberInput, type NumberInputProps, POPOVER_BODY_MIN, type Packet, PacketCard, type PacketCardProps, type PacketSchema, type Pager, Pagination, type PaginationProps, PermissionDenied, type PermissionDeniedProps, type PermissionGroup, PermissionHint, type PermissionItem, type Phase, type PhaseStatus, PhasedProgress, type PhasedProgressProps, type Placement, type PollOptions, Popover, type PopoverProps, type PreferenceCriterion, PreferenceMeter, type PreferenceMeterProps, type ProfileFieldDef, type ProfileFieldType, type ProfileNotificationDef, ProfilePage, type ProfilePageProps, ProgressBar, type ProgressBarProps, QueryKit, type QueuedTurn, QuotaRow, type QuotaRowProps, Radio, type RadioProps, RangeSlider, type RangeSliderProps, RelativeTime, type RelativeTimeProps, type RoadmapItem, type RoadmapResult, RoadmapTimeline, type RoadmapTimelineProps, type Role, RunActions, type RunActionsProps, type RunConfig, RuntimeKit, type RuntimeSummary, SaturationDistribution, type SaturationDistributionCampus, type SaturationDistributionProps, ScoreMeter, type ScoreMeterProps, ScreenHead, type ScreenHeadProps, SearchField, type SearchFieldProps, SegmentedControl, type SegmentedControlProps, SegmentedMeter, type SegmentedMeterProps, Select, type SelectOption, type SelectProps, type SendMessageResult, type ServerTable, type Session, type SessionContextValue, type Flag as SessionFlag, SessionKit, SessionProvider, type SessionProviderProps, type SessionRole, type SessionStats, type SessionUser, SidebarNav, type SidebarNavItem, type SidebarNavProps, type SignInContinueAs, SignInPage, type SignInPageProps, Skeleton, type SkeletonProps, SkeletonText, type SkeletonTextProps, type SlashCommand, Slider, type SliderProps, SortMenu, type SortMenuField, type SortMenuProps, type SpecModule, Spinner, type SpinnerProps, StatTile, type StatTileProps, type Step, StepList, type StepListProps, type StreamHandlers, type Suggestion, SurroundSound, type SurroundSoundProps, Switch, type SwitchProps, type TableQuery, Tabs, type TabsProps, Tag, type TagProps, TestModeBar, type TestModeBarProps, type TextScale, Textarea, type TextareaProps, type ThemeMode, ThinkingBlock, type ThinkingBlockProps, type ThreadSummary, TimePicker, type TimePickerProps, Toast, type ToastProps, Tooltip, type TooltipProps, Topbar, type TopbarProps, TranscriptKit, TransferList, type TransferListProps, type TransferListSide, type TransferListSideProps, type TrapScope, TrapScopeProvider, TrendChart, type TrendChartProps, type TrendSeries, type UsageLimit, UseFeatureStatus, type UseResponsiveRailOptions, type UseResponsiveRailResult, UseRuntimeMode, type UseServerTableOptions, type User, VIRTUAL_LIST_BUFFER_ROWS, VIRTUAL_LIST_ROW_GAP, type VersionRecord, type VersionStore, VirtualList, type VirtualListProps, type VirtualLoadedBand, type VirtualWindow, type VoiceHandler, acceptMatches, anyOfFilter, applyPrefs, channelWeightOf, computeNeedMore, computeVirtualWindow, createLocalStorageAppearanceStore, createVersionStore, eqFilter, extensionOf, extractClipboardFiles, filterFiles, formatAbsolute, formatBytes, formatClock, formatDocumentTitle, formatDuration, formatEta, formatRelative, groupMessages, hasModifier, iconForMime, importanceLevel, importanceTokens, installFlytedeskFavicon, isImage, isSystemMessage, jobBucket, languageLabel, loadPrefs, markdownToText, meterFormats, modifierLabel, parseDelimited, pastedTextName, pluralizeUnit, preferenceScore, preferenceSegments, rangeFilter, resolveTheme, revokeAttachment, savePrefs, toAttachment, tokenize, useAppearancePrefs, useChatEngine, useDocumentTitle, useEscapeTrapRegistration, useFeatureStatus, useFocusTrap, usePopoverPosition, useResponsiveRail, useRuntimeMode, useServerTable, useSessionContext, useStagedFiles, useTrapScope, validateFilterValue, visibleMessages };
+export { AccountMenu, type AccountMenuLink, type AccountMenuProps, AgentChatPanel, type AgentChatPanelProps, AnchoredPopover, type AnchoredPopoverProps, AnimNum, type AnimNumProps, ApiSpecBrowser, type ApiSpecBrowserProps, type AppEntry, AppShell, type AppShellProps, AppSwitcher, type AppSwitcherProps, AppearanceMenu, type AppearanceMenuProps, type AppearancePrefs, type AppearanceStore, type AppearanceStoreOptions, type Attachment, Avatar, type AvatarProps, AvatarStack, type AvatarStackProps, Badge, type BadgeProps, Banner, type BannerProps, type BannerTone, BarList, type BarListProps, type BarListRow, BudgetReallocator, type BudgetReallocatorProps, Button, type ButtonProps, CHANNELS, CHANNEL_WEIGHTS, CHAT_UNAVAILABLE, Calendar, type CalendarProps, Card, type CardProps, CardRow, type CardRowProps, ChannelContribution, type ChannelContributionChannel, type ChannelContributionProps, ChannelMeta, type ChannelMetaRecord, ChannelTag, type ChannelTagProps, ChannelWeightOf, type ChatAdapter, ChatComposer, type ChatComposerProps, type ChatEngine, type ChatEngineOptions, ChatKit, type ChatMessage, type ChatRenderContext, ChatSessionBar, type ChatSessionBarProps, ChatTranscript, type ChatTranscriptProps, ChatTurn, type ChatTurnProps, Checkbox, type CheckboxProps, type Citation, Citations, type CitationsProps, Clamp, type ClampProps, ClockFace, type ClockFaceProps, CodeBlock, type CodeBlockProps, Collapsible, type CollapsibleProps, ComingSoon, type ComingSoonProps, type ContextUsage, type CreateVersionStoreOptions, CsiBadge, type CsiBadgeProps, CsiHero, type CsiHeroProps, CsiMeter, type CsiMeterProps, DEFAULT_PREFS, DEFAULT_STORAGE_KEY, DataTable, type DataTableColumn, type DataTableProps, DatePicker, type DatePickerProps, type DemoSessionControls, DemoSessionProvider, type DeviceSession, DiffBlock, type DiffBlockProps, DonutChart, type DonutChartProps, type DonutSegment, Drawer, type DrawerProps, Dropzone, DropzoneKit, type DropzoneProps, ENTITY_ROW_METRIC_WIDTH, type EditorTrigger, EmptyState, type EmptyStateProps, type EndpointSpec, EntityRow, type EntityRowAction, type EntityRowContent, type EntityRowMetric, EntityRowMetrics, type EntityRowMetricsProps, type EntityRowProps, FILE_VIEWER_CSV_ROW_LIMIT, FILE_VIEWER_TEXT_LIMIT, FeatureGate, type FeatureGateProps, type FeatureStatus, FileBrowser, type FileBrowserFile, type FileBrowserFolder, type FileBrowserPermissions, type FileBrowserProps, FileChip, type FileChipProps, FileGrid, type FileGridProps, FileKit, FilePickButton, type FilePickButtonProps, type FileRejection, FileStrip, type FileStripProps, FileTile, type FileTileProps, type FileUploadHandler, FileViewer, type FileViewerProps, FilterBar, type FilterBarProps, type FilterDateValue, type FilterField, type FilterFieldDate, type FilterFieldMultiSelect, type FilterFieldOption, type FilterFieldRange, type FilterFieldSelect, type FilterFieldText, type FilterMultiSelectValue, type FilterOperator, type FilterRangeValue, type FilterResolveMatch, type FilterResolveResult, type 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 ListEnvelope, LoadingRegion, type LoadingRegionProps, Markdown, MarkdownEditor, type MarkdownEditorHandle, type MarkdownEditorProps, MarkdownInline, type MarkdownProps, type MentionSource, Menu, MenuButton, type MenuButtonProps, type MenuItem, type MenuProps, MessageBody, type MessageBodyProps, type MessageGroup, Meter, type MeterProps, type MeterSegment, type MeterSegmentInput, MixGap, type MixGapProps, type MixGapRow, MockJobKit, type MockJobStatus, Modal, type ModalProps, ModeSwitch, type ModeSwitchProps, type Model, ModelControls, type ModelControlsProps, NumberInput, type NumberInputProps, POPOVER_BODY_MIN, type Packet, PacketCard, type PacketCardProps, type PacketSchema, type Pager, Pagination, type PaginationProps, PermissionDenied, type PermissionDeniedProps, type PermissionGroup, PermissionHint, type PermissionItem, type Phase, type PhaseStatus, PhasedProgress, type PhasedProgressProps, type Placement, type PollOptions, Popover, type PopoverProps, type PreferenceCriterion, PreferenceMeter, type PreferenceMeterProps, type ProfileFieldDef, type ProfileFieldType, type ProfileNotificationDef, ProfilePage, type ProfilePageProps, ProgressBar, type ProgressBarProps, QueryKit, type QueuedTurn, QuotaRow, type QuotaRowProps, Radio, type RadioProps, RangeSlider, type RangeSliderProps, RelativeTime, type RelativeTimeProps, type RoadmapItem, type RoadmapResult, RoadmapTimeline, type RoadmapTimelineProps, type Role, RunActions, type RunActionsProps, type RunConfig, RuntimeKit, type RuntimeSummary, SaturationDistribution, type SaturationDistributionCampus, type SaturationDistributionProps, ScoreMeter, type ScoreMeterProps, ScreenHead, type ScreenHeadProps, SearchField, type SearchFieldProps, SegmentedControl, type SegmentedControlProps, SegmentedMeter, type SegmentedMeterProps, Select, type SelectOption, type SelectProps, type SendMessageResult, type ServerTable, type Session, type SessionContextValue, type Flag as SessionFlag, SessionKit, SessionProvider, type SessionProviderProps, type SessionRole, type SessionStats, type SessionUser, SidebarNav, type SidebarNavItem, type SidebarNavProps, type SignInContinueAs, SignInPage, type SignInPageProps, Skeleton, type SkeletonProps, SkeletonText, type SkeletonTextProps, type SlashCommand, Slider, type SliderProps, SortMenu, type SortMenuField, type SortMenuProps, type SpecModule, Spinner, type SpinnerProps, type StackedLayer, type StackedLayerOptions, StackedLayerProvider, StatTile, type StatTileProps, type Step, StepList, type StepListProps, type StreamHandlers, type Suggestion, SurroundSound, type SurroundSoundProps, Switch, type SwitchProps, type TableQuery, Tabs, type TabsProps, Tag, type TagProps, TestModeBar, type TestModeBarProps, type TextScale, Textarea, type TextareaProps, type ThemeMode, ThinkingBlock, type ThinkingBlockProps, type ThreadSummary, TimePicker, type TimePickerProps, Toast, type ToastProps, Tooltip, type TooltipProps, Topbar, type TopbarProps, TranscriptKit, TransferList, type TransferListProps, type TransferListSide, type TransferListSideProps, TrendChart, type TrendChartProps, type TrendSeries, type UsageLimit, UseFeatureStatus, type UseResponsiveRailOptions, type UseResponsiveRailResult, UseRuntimeMode, type UseServerTableOptions, type User, VIRTUAL_LIST_BUFFER_ROWS, VIRTUAL_LIST_ROW_GAP, type VersionRecord, type VersionStore, VirtualList, type VirtualListProps, type VirtualLoadedBand, type VirtualWindow, type VoiceHandler, acceptMatches, anyOfFilter, applyPrefs, channelWeightOf, computeNeedMore, computeVirtualWindow, createLocalStorageAppearanceStore, createVersionStore, eqFilter, extensionOf, extractClipboardFiles, filterFiles, formatAbsolute, formatBytes, formatClock, formatDocumentTitle, formatDuration, formatEta, formatRelative, groupMessages, hasModifier, iconForMime, importanceLevel, importanceTokens, installFlytedeskFavicon, isImage, isSystemMessage, isWithinLayerTree, jobBucket, languageLabel, loadPrefs, markdownToText, meterFormats, modifierLabel, parseDelimited, pastedTextName, pluralizeUnit, preferenceScore, preferenceSegments, rangeFilter, resolveTheme, revokeAttachment, savePrefs, toAttachment, tokenize, useAppearancePrefs, useChatEngine, useDocumentTitle, useFeatureStatus, usePopoverPosition, useResponsiveRail, useRuntimeMode, useServerTable, useSessionContext, useStackedLayer, useStagedFiles, validateFilterValue, visibleMessages };