@flytedan/flytebot-design-system 0.49.0 → 0.49.1

package/dist/index.d.cts

@@ -158,6 +158,27 @@ declare function usePopoverPosition(open: boolean, anchorRef: React.RefObject<HT
     /** The rendered layer, so its real size replaces the estimates once it exists. */
     layerRef?: React.RefObject<HTMLElement>;
 }): PopoverPosition | null;
+/**
+ * MP-268: a portalled overlay's z-index is no longer decided here. It used to be a second,
+ * independently-timed mechanism (MP-142) — a value passed down through its own React context,
+ * separate from the layer stack's ownership context (`kits/layerStack.tsx`) that already
+ * decides Escape and Tab order. The two could disagree: a child overlay opened in the very
+ * same commit as its parent could read the parent's not-yet-registered placeholder z-index
+ * and mistake itself for a root overlay, racing its own parent for a root slot instead of
+ * always outranking it (the reported bug — a Modal opened in the same commit as its Drawer
+ * painted under it, though focus was correctly inside the Modal).
+ *
+ * Every overlay that escapes the DOM via `portal()` or `createPortal` directly — Popover
+ * (and everything built on it), Drawer, Modal, Tooltip — now reads its z-index from
+ * `useLayerZIndex(layer)` (`kits/layerStack.tsx`), passing the SAME `layer` object
+ * `useStackedLayer` gave it. That function derives the number purely from `layer.parent` —
+ * the same ownership fact already used for focus — so the two can never disagree again:
+ * one fact, one mechanism. See `useLayerZIndex`'s own comment for the exact rule (child
+ * always LAYER_STEP+ above its resolved parent; a root layer ranks by position among the
+ * other currently-open root layers). Import `useLayerZIndex`/`LAYER_STEP`/`ROOT_STEP`/
+ * `OVERLAY_CEILING`/`__resetLayerStackForTests` from `kits/layerStack` directly — this file
+ * no longer re-exports them; there is exactly one place they live now.
+ */
 /**
  * An anchored floating surface: menus, pickers, disclosure panels, meters.
  * Owns placement, dismissal, focus return — and its own layout, which is the one rule
@@ -4870,6 +4891,24 @@ interface StackedLayerOptions {
 interface StackedLayer {
     readonly parent: StackedLayer | null;
 }
+/** How far a layer's z-index sits above its parent's — also the spacing between two open
+ *  layers that share a parent (siblings stack by open order, oldest lowest). */
+declare const LAYER_STEP = 10;
+/** The z-index a root layer (no parent) claims: `(index + 1) * ROOT_STEP`, where `index` is
+ *  its position among the currently-open root layers, oldest first. Static, always-mounted
+ *  page chrome (a sticky header, the off-canvas rail's own resting z-index) must stay under
+ *  this, so no page z-index can ever outrank an overlay. */
+declare const ROOT_STEP = 100;
+/** Guaranteed to sit above any z-index this mechanism can ever compute — see Popover.tsx's
+ *  TransferList drag-ghost use. Not part of the layer tree; nothing derives from it. */
+declare const OVERLAY_CEILING = 10000;
+/** The z-index `layer` should render at right now — 0 while it is closed (nothing should be
+ *  positioning off it then). Re-renders whenever any layer anywhere opens or closes, since
+ *  a sibling or a parent opening/closing can change this layer's own slot. */
+declare function useLayerZIndex(layer: StackedLayer): number;
+/** Test-only escape hatch: forces every currently-open layer closed and the shared order
+ *  counter back to zero. Production code never needs this. */
+declare const __resetLayerStackForTests: () => void;
 /** 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. */
@@ -4957,4 +4996,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, 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, 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 };
+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, 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, 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, LAYER_STEP, type ListEnvelope, LoadingRegion, type LoadingRegionProps, Markdown, MarkdownEditor, type MarkdownEditorHandle, type MarkdownEditorProps, MarkdownInline, type MarkdownProps, type MentionSource, Menu, MenuButton, type MenuButtonProps, type MenuItem, type MenuProps, MessageBody, type MessageBodyProps, type MessageGroup, Meter, type MeterProps, type MeterSegment, type MeterSegmentInput, MixGap, type MixGapProps, type MixGapRow, MockJobKit, type MockJobStatus, Modal, type ModalProps, ModeSwitch, type ModeSwitchProps, type Model, ModelControls, type ModelControlsProps, NumberInput, type NumberInputProps, OVERLAY_CEILING, POPOVER_BODY_MIN, type Packet, PacketCard, type PacketCardProps, type PacketSchema, type Pager, Pagination, type PaginationProps, PermissionDenied, type PermissionDeniedProps, type PermissionGroup, PermissionHint, type PermissionItem, type Phase, type PhaseStatus, PhasedProgress, type PhasedProgressProps, type Placement, type PollOptions, Popover, type PopoverProps, type PreferenceCriterion, PreferenceMeter, type PreferenceMeterProps, type ProfileFieldDef, type ProfileFieldType, type ProfileNotificationDef, ProfilePage, type ProfilePageProps, ProgressBar, type ProgressBarProps, QueryKit, type QueuedTurn, QuotaRow, type QuotaRowProps, ROOT_STEP, Radio, type RadioProps, RangeSlider, type RangeSliderProps, RelativeTime, type RelativeTimeProps, type RoadmapItem, type RoadmapResult, RoadmapTimeline, type RoadmapTimelineProps, type Role, RunActions, type RunActionsProps, type RunConfig, RuntimeKit, type RuntimeSummary, SaturationDistribution, type SaturationDistributionCampus, type SaturationDistributionProps, ScoreMeter, type ScoreMeterProps, ScreenHead, type ScreenHeadProps, SearchField, type SearchFieldProps, SegmentedControl, type SegmentedControlProps, SegmentedMeter, type SegmentedMeterProps, Select, type SelectOption, type SelectProps, type SendMessageResult, type ServerTable, type Session, type SessionContextValue, type Flag as SessionFlag, SessionKit, SessionProvider, type SessionProviderProps, type SessionRole, 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, __resetLayerStackForTests, 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, useLayerZIndex, usePopoverPosition, useResponsiveRail, useRuntimeMode, useServerTable, useSessionContext, useStackedLayer, useStagedFiles, validateFilterValue, visibleMessages };

package/dist/index.d.ts

@@ -158,6 +158,27 @@ declare function usePopoverPosition(open: boolean, anchorRef: React.RefObject<HT
     /** The rendered layer, so its real size replaces the estimates once it exists. */
     layerRef?: React.RefObject<HTMLElement>;
 }): PopoverPosition | null;
+/**
+ * MP-268: a portalled overlay's z-index is no longer decided here. It used to be a second,
+ * independently-timed mechanism (MP-142) — a value passed down through its own React context,
+ * separate from the layer stack's ownership context (`kits/layerStack.tsx`) that already
+ * decides Escape and Tab order. The two could disagree: a child overlay opened in the very
+ * same commit as its parent could read the parent's not-yet-registered placeholder z-index
+ * and mistake itself for a root overlay, racing its own parent for a root slot instead of
+ * always outranking it (the reported bug — a Modal opened in the same commit as its Drawer
+ * painted under it, though focus was correctly inside the Modal).
+ *
+ * Every overlay that escapes the DOM via `portal()` or `createPortal` directly — Popover
+ * (and everything built on it), Drawer, Modal, Tooltip — now reads its z-index from
+ * `useLayerZIndex(layer)` (`kits/layerStack.tsx`), passing the SAME `layer` object
+ * `useStackedLayer` gave it. That function derives the number purely from `layer.parent` —
+ * the same ownership fact already used for focus — so the two can never disagree again:
+ * one fact, one mechanism. See `useLayerZIndex`'s own comment for the exact rule (child
+ * always LAYER_STEP+ above its resolved parent; a root layer ranks by position among the
+ * other currently-open root layers). Import `useLayerZIndex`/`LAYER_STEP`/`ROOT_STEP`/
+ * `OVERLAY_CEILING`/`__resetLayerStackForTests` from `kits/layerStack` directly — this file
+ * no longer re-exports them; there is exactly one place they live now.
+ */
 /**
  * An anchored floating surface: menus, pickers, disclosure panels, meters.
  * Owns placement, dismissal, focus return — and its own layout, which is the one rule
@@ -4870,6 +4891,24 @@ interface StackedLayerOptions {
 interface StackedLayer {
     readonly parent: StackedLayer | null;
 }
+/** How far a layer's z-index sits above its parent's — also the spacing between two open
+ *  layers that share a parent (siblings stack by open order, oldest lowest). */
+declare const LAYER_STEP = 10;
+/** The z-index a root layer (no parent) claims: `(index + 1) * ROOT_STEP`, where `index` is
+ *  its position among the currently-open root layers, oldest first. Static, always-mounted
+ *  page chrome (a sticky header, the off-canvas rail's own resting z-index) must stay under
+ *  this, so no page z-index can ever outrank an overlay. */
+declare const ROOT_STEP = 100;
+/** Guaranteed to sit above any z-index this mechanism can ever compute — see Popover.tsx's
+ *  TransferList drag-ghost use. Not part of the layer tree; nothing derives from it. */
+declare const OVERLAY_CEILING = 10000;
+/** The z-index `layer` should render at right now — 0 while it is closed (nothing should be
+ *  positioning off it then). Re-renders whenever any layer anywhere opens or closes, since
+ *  a sibling or a parent opening/closing can change this layer's own slot. */
+declare function useLayerZIndex(layer: StackedLayer): number;
+/** Test-only escape hatch: forces every currently-open layer closed and the shared order
+ *  counter back to zero. Production code never needs this. */
+declare const __resetLayerStackForTests: () => void;
 /** 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. */
@@ -4957,4 +4996,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, 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, 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 };
+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, 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, 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, LAYER_STEP, type ListEnvelope, LoadingRegion, type LoadingRegionProps, Markdown, MarkdownEditor, type MarkdownEditorHandle, type MarkdownEditorProps, MarkdownInline, type MarkdownProps, type MentionSource, Menu, MenuButton, type MenuButtonProps, type MenuItem, type MenuProps, MessageBody, type MessageBodyProps, type MessageGroup, Meter, type MeterProps, type MeterSegment, type MeterSegmentInput, MixGap, type MixGapProps, type MixGapRow, MockJobKit, type MockJobStatus, Modal, type ModalProps, ModeSwitch, type ModeSwitchProps, type Model, ModelControls, type ModelControlsProps, NumberInput, type NumberInputProps, OVERLAY_CEILING, POPOVER_BODY_MIN, type Packet, PacketCard, type PacketCardProps, type PacketSchema, type Pager, Pagination, type PaginationProps, PermissionDenied, type PermissionDeniedProps, type PermissionGroup, PermissionHint, type PermissionItem, type Phase, type PhaseStatus, PhasedProgress, type PhasedProgressProps, type Placement, type PollOptions, Popover, type PopoverProps, type PreferenceCriterion, PreferenceMeter, type PreferenceMeterProps, type ProfileFieldDef, type ProfileFieldType, type ProfileNotificationDef, ProfilePage, type ProfilePageProps, ProgressBar, type ProgressBarProps, QueryKit, type QueuedTurn, QuotaRow, type QuotaRowProps, ROOT_STEP, Radio, type RadioProps, RangeSlider, type RangeSliderProps, RelativeTime, type RelativeTimeProps, type RoadmapItem, type RoadmapResult, RoadmapTimeline, type RoadmapTimelineProps, type Role, RunActions, type RunActionsProps, type RunConfig, RuntimeKit, type RuntimeSummary, SaturationDistribution, type SaturationDistributionCampus, type SaturationDistributionProps, ScoreMeter, type ScoreMeterProps, ScreenHead, type ScreenHeadProps, SearchField, type SearchFieldProps, SegmentedControl, type SegmentedControlProps, SegmentedMeter, type SegmentedMeterProps, Select, type SelectOption, type SelectProps, type SendMessageResult, type ServerTable, type Session, type SessionContextValue, type Flag as SessionFlag, SessionKit, SessionProvider, type SessionProviderProps, type SessionRole, 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, __resetLayerStackForTests, 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, useLayerZIndex, usePopoverPosition, useResponsiveRail, useRuntimeMode, useServerTable, useSessionContext, useStackedLayer, useStagedFiles, validateFilterValue, visibleMessages };

package/dist/index.js

@@ -202,6 +202,8 @@ function open(layer) {
   layer.order = ++lastOrder;
   lastClosed = null;
   if (layer.options.trap && !contains(scopeOf(layer), document.activeElement)) focusInto(layer);
+  zIndexVersion++;
+  notifyZIndexListeners();
 }
 function close(layer) {
   openLayers.delete(layer);
@@ -212,7 +214,53 @@ function close(layer) {
     document.removeEventListener("keydown", onKeydown);
     pendingEscape = null;
   }
+  zIndexVersion++;
+  notifyZIndexListeners();
 }
+var LAYER_STEP = 10;
+var ROOT_STEP = 100;
+var OVERLAY_CEILING = 1e4;
+var zIndexListeners = /* @__PURE__ */ new Set();
+var notifyZIndexListeners = () => {
+  zIndexListeners.forEach((listener) => listener());
+};
+var subscribeZIndex = (listener) => {
+  zIndexListeners.add(listener);
+  return () => {
+    zIndexListeners.delete(listener);
+  };
+};
+var zIndexVersion = 0;
+var getZIndexVersion = () => zIndexVersion;
+function openSiblingsOf(layer) {
+  const siblings = [];
+  for (const l of openLayers) if (l.parent === layer.parent) siblings.push(l);
+  return siblings.sort((a, b) => a.order - b.order);
+}
+function computeZIndex(layer) {
+  const path = [];
+  for (let l = layer; l; l = l.parent) path.push(l);
+  path.reverse();
+  let z = 0;
+  for (const l of path) {
+    const siblings = openSiblingsOf(l);
+    const index = Math.max(0, siblings.indexOf(l));
+    z = l.parent === null ? (index + 1) * ROOT_STEP : z + LAYER_STEP + index;
+  }
+  return z;
+}
+function useLayerZIndex(layer) {
+  React2.useSyncExternalStore(subscribeZIndex, getZIndexVersion, getZIndexVersion);
+  const l = layer;
+  return l.order > 0 ? computeZIndex(l) : 0;
+}
+var __resetLayerStackForTests = () => {
+  openLayers.clear();
+  lastOrder = 0;
+  pendingEscape = null;
+  lastClosed = null;
+  notifyZIndexListeners();
+};
 function returnFocus(layer) {
   if (layer.options.returnFocus === false) return;
   const current2 = document.activeElement;
@@ -369,50 +417,6 @@ var portal = (node) => {
   if (typeof document !== "undefined") return createPortal(node, document.body);
   return node;
 };
-var ROOT_LAYER = 0;
-var LAYER_STEP = 10;
-var ROOT_STEP = 100;
-var OVERLAY_CEILING = 1e4;
-var LayerContext2 = React3.createContext(ROOT_LAYER);
-var openRootIds = [];
-var rootListeners = /* @__PURE__ */ new Set();
-var notifyRootListeners = () => {
-  rootListeners.forEach((listener) => listener());
-};
-var subscribeRootOverlays = (listener) => {
-  rootListeners.add(listener);
-  return () => {
-    rootListeners.delete(listener);
-  };
-};
-var getRootOverlaysSnapshot = () => openRootIds;
-var registerRootOverlay = (id) => {
-  if (openRootIds.includes(id)) return;
-  openRootIds = [...openRootIds, id];
-  notifyRootListeners();
-};
-var unregisterRootOverlay = (id) => {
-  if (!openRootIds.includes(id)) return;
-  openRootIds = openRootIds.filter((existing) => existing !== id);
-  notifyRootListeners();
-};
-var useLayer = () => React3.useContext(LayerContext2);
-var useOverlayLayer = (isOpen) => {
-  const parent = useLayer();
-  const isRoot = parent === ROOT_LAYER;
-  const id = React3.useId();
-  const openIds = React3.useSyncExternalStore(subscribeRootOverlays, getRootOverlaysSnapshot, getRootOverlaysSnapshot);
-  React3.useLayoutEffect(() => {
-    if (!isRoot || !isOpen) return;
-    registerRootOverlay(id);
-    return () => unregisterRootOverlay(id);
-  }, [isRoot, isOpen, id]);
-  if (!isRoot) return parent + LAYER_STEP;
-  if (!isOpen) return ROOT_LAYER;
-  const index = openIds.indexOf(id);
-  return index === -1 ? ROOT_LAYER : (index + 1) * ROOT_STEP;
-};
-var LayerProvider = ({ zIndex, children }) => /* @__PURE__ */ jsx4(LayerContext2.Provider, { value: zIndex, children });
 function Popover({
   open: open2,
   anchorRef,
@@ -448,8 +452,8 @@ function Popover({
     onDetach: onClose,
     layerRef: ref
   });
-  const zIndex = useOverlayLayer(!!open2);
   const layer = useStackedLayer({ active: !!open2, containerRef: ref, onEscape: closeOnEscape ? onClose : void 0, returnFocus: returnFocus2 });
+  const zIndex = useLayerZIndex(layer);
   React3.useEffect(() => {
     if (!open2) return;
     const away = (e) => {
@@ -465,7 +469,7 @@ function Popover({
   }, [open2, closeOnOutside, onClose, anchorRef, triggerRef, layer]);
   if (!open2 || !pos) return null;
   return portal(
-    /* @__PURE__ */ jsx4(LayerProvider, { zIndex, children: /* @__PURE__ */ jsx4(StackedLayerProvider, { layer, children: /* @__PURE__ */ jsxs3(
+    /* @__PURE__ */ jsx4(StackedLayerProvider, { layer, children: /* @__PURE__ */ jsxs3(
       "div",
       {
         ref,
@@ -508,7 +512,7 @@ function Popover({
           footer != null ? /* @__PURE__ */ jsx4("div", { className: "fd-pop-footer", children: footer }) : null
         ]
       }
-    ) }) })
+    ) })
   );
 }
 var isItem = (it) => !!it && it.kind !== "separator" && it.kind !== "section" && it.kind !== "custom" && !it.disabled;
@@ -760,6 +764,7 @@ import { jsx as jsx6 } from "react/jsx-runtime";
 function AnchoredPopover({ rect, width = 620, onClose, children }) {
   const ref = React4.useRef(null);
   const layer = useStackedLayer({ active: !!rect, containerRef: ref, onEscape: onClose });
+  const zIndex = useLayerZIndex(layer);
   const w = Math.min(width, window.innerWidth - 32);
   const [h, setH] = React4.useState(0);
   React4.useLayoutEffect(() => {
@@ -801,7 +806,7 @@ function AnchoredPopover({ rect, width = 620, onClose, children }) {
           left,
           top,
           width: w,
-          zIndex: 150,
+          zIndex,
           maxHeight: `calc(100vh - ${PAD * 2}px)`,
           overflowY: "auto",
           background: "var(--surface)",
@@ -924,7 +929,6 @@ import * as React6 from "react";
 import { createPortal as createPortal2 } from "react-dom";
 import { jsx as jsx9, jsxs as jsxs6 } from "react/jsx-runtime";
 function Drawer({ open: open2 = true, title, onClose, footer, children, className = "", ...rest }) {
-  const zIndex = useOverlayLayer(open2);
   const asideRef = React6.useRef(null);
   const [closing, setClosing] = React6.useState(false);
   const close2 = React6.useCallback(() => {
@@ -933,9 +937,10 @@ function Drawer({ open: open2 = true, title, onClose, footer, children, classNam
     setTimeout(onClose, 210);
   }, [onClose]);
   const layer = useStackedLayer({ active: !!open2, containerRef: asideRef, trap: true, onEscape: onClose ? close2 : void 0 });
+  const zIndex = useLayerZIndex(layer);
   if (!open2) return null;
   return createPortal2(
-    /* @__PURE__ */ jsx9(LayerProvider, { zIndex, children: /* @__PURE__ */ jsxs6(StackedLayerProvider, { layer, children: [
+    /* @__PURE__ */ jsxs6(StackedLayerProvider, { layer, children: [
       /* @__PURE__ */ jsx9("div", { className: "fd-scrim" + (closing ? " is-closing" : ""), style: { display: "block", zIndex: zIndex - LAYER_STEP }, onClick: close2 }),
       /* @__PURE__ */ jsxs6("aside", { ref: asideRef, className: ["fd-drawer", closing ? "is-closing" : "", className].filter(Boolean).join(" "), role: "dialog", "aria-modal": "true", ...rest, style: { zIndex }, children: [
         /* @__PURE__ */ jsxs6("div", { className: "fd-card-head", style: { flex: "none" }, children: [
@@ -945,7 +950,7 @@ function Drawer({ open: open2 = true, title, onClose, footer, children, classNam
         /* @__PURE__ */ jsx9("div", { style: { flex: "1 1 auto", minHeight: 0, overflow: "auto", padding: 20 }, children }),
         footer ? /* @__PURE__ */ jsx9("div", { className: "fd-card-foot", style: { flex: "none" }, children: typeof footer === "function" ? footer(close2) : footer }) : null
       ] })
-    ] }) }),
+    ] }),
     document.body
   );
 }
@@ -957,16 +962,16 @@ import { jsx as jsx10, jsxs as jsxs7 } from "react/jsx-runtime";
 function Modal({ open: open2 = true, title, description, onClose, footer, wide = false, children, className = "", ...rest }) {
   const [closing, setClosing] = React7.useState(false);
   const boxRef = React7.useRef(null);
-  const zIndex = useOverlayLayer(!!open2);
   const close2 = React7.useCallback(() => {
     if (!onClose) return;
     setClosing(true);
     setTimeout(onClose, 190);
   }, [onClose]);
   const layer = useStackedLayer({ active: !!open2, containerRef: boxRef, trap: true, onEscape: onClose ? close2 : void 0 });
+  const zIndex = useLayerZIndex(layer);
   if (!open2) return null;
   return createPortal3(
-    /* @__PURE__ */ jsx10(LayerProvider, { zIndex, children: /* @__PURE__ */ jsx10(StackedLayerProvider, { layer, children: /* @__PURE__ */ jsx10(
+    /* @__PURE__ */ jsx10(StackedLayerProvider, { layer, children: /* @__PURE__ */ jsx10(
       "div",
       {
         className: "fd-scrim" + (closing ? " is-closing" : ""),
@@ -997,7 +1002,7 @@ function Modal({ open: open2 = true, title, description, onClose, footer, wide =
           }
         )
       }
-    ) }) }),
+    ) }),
     document.body
   );
 }
@@ -1860,8 +1865,8 @@ function Tooltip({ label, placement = "top", children, className = "" }) {
     layerRef: bubbleRef,
     onDetach: hide
   });
-  const zIndex = useOverlayLayer(open2);
-  useStackedLayer({ active: open2, containerRef: bubbleRef, onEscape: hide, returnFocus: false });
+  const layer = useStackedLayer({ active: open2, containerRef: bubbleRef, onEscape: hide, returnFocus: false });
+  const zIndex = useLayerZIndex(layer);
   React14.useEffect(() => {
     if (!open2) return;
     const away = (e) => {
@@ -5184,9 +5189,9 @@ import * as React31 from "react";
 import { jsx as jsx54 } from "react/jsx-runtime";
 function useInlinePanel() {
   const [open2, setOpen] = React31.useState(false);
-  const zIndex = useOverlayLayer(open2);
   const ref = React31.useRef(null);
   const layer = useStackedLayer({ active: open2, containerRef: ref, onEscape: () => setOpen(false) });
+  const zIndex = useLayerZIndex(layer);
   React31.useEffect(() => {
     if (!open2) return;
     const away = (e) => {
@@ -5198,7 +5203,7 @@ function useInlinePanel() {
   return { open: open2, setOpen, ref, zIndex, layer };
 }
 function InlinePanelLayers({ panel, children }) {
-  return /* @__PURE__ */ jsx54(LayerProvider, { zIndex: panel.zIndex, children: /* @__PURE__ */ jsx54(StackedLayerProvider, { layer: panel.layer, children }) });
+  return /* @__PURE__ */ jsx54(StackedLayerProvider, { layer: panel.layer, children });
 }
 
 // src/components/data/SortMenu.tsx
@@ -10728,7 +10733,9 @@ function ComingSoon({
 function InlineSoon({ label, detail, backend, eta, effort, onRoadmap, allowed, onBypass, blur, tip, className, rest, children }) {
   const [open2, setOpen] = React55.useState(false);
   const [anchor, pos] = useHoverCard(open2);
-  const zIndex = useOverlayLayer(open2);
+  const hoverCardRef = React55.useRef(null);
+  const hoverLayer = useStackedLayer({ active: open2, containerRef: hoverCardRef, returnFocus: false });
+  const zIndex = useLayerZIndex(hoverLayer);
   const close2 = React55.useRef(null);
   const show = () => {
     if (close2.current) {
@@ -10775,9 +10782,10 @@ function InlineSoon({ label, detail, backend, eta, effort, onRoadmap, allowed, o
           }
         ),
         open2 && pos ? createPortal5(
-          /* @__PURE__ */ jsx80(LayerProvider, { zIndex, children: /* @__PURE__ */ jsx80(
+          /* @__PURE__ */ jsx80(
             "div",
             {
+              ref: hoverCardRef,
               className: "fd-soon-note fd-soon-hovercard",
               role: "tooltip",
               style: { position: "fixed", left: pos.left, top: pos.top, bottom: pos.bottom, width: pos.width, zIndex },
@@ -10797,7 +10805,7 @@ function InlineSoon({ label, detail, backend, eta, effort, onRoadmap, allowed, o
                 }
               )
             }
-          ) }),
+          ),
           document.body
         ) : null
       ]
@@ -14351,6 +14359,7 @@ export {
   JobTray,
   Json,
   KeyHint,
+  LAYER_STEP,
   LoadingRegion,
   Markdown,
   MarkdownEditor,
@@ -14365,6 +14374,7 @@ export {
   ModeSwitch,
   ModelControls,
   NumberInput,
+  OVERLAY_CEILING,
   POPOVER_BODY_MIN,
   PacketCard,
   Pagination,
@@ -14377,6 +14387,7 @@ export {
   ProgressBar,
   QueryKit,
   QuotaRow,
+  ROOT_STEP,
   Radio,
   RangeSlider,
   RelativeTime,
@@ -14421,6 +14432,7 @@ export {
   VIRTUAL_LIST_BUFFER_ROWS,
   VIRTUAL_LIST_ROW_GAP,
   VirtualList,
+  __resetLayerStackForTests,
   acceptMatches,
   anyOfFilter,
   applyPrefs,
@@ -14470,6 +14482,7 @@ export {
   useChatEngine,
   useDocumentTitle,
   useFeatureStatus,
+  useLayerZIndex,
   usePopoverPosition,
   useResponsiveRail,
   useRuntimeMode,