@flytedan/flytebot-design-system 0.18.0 → 0.20.0

package/dist/index.d.cts

@@ -437,38 +437,6 @@ interface SidebarNavProps {
 }
 declare const SidebarNav: React.ForwardRefExoticComponent<SidebarNavProps & React.RefAttributes<HTMLElement>>;
 
-interface FlytedeskMarkProps {
-    size?: "sm" | "md" | "lg";
-    className?: string;
-}
-/** Just the flytedesk logo, no label — for contexts too small for a stacked brand
- *  (a collapsed rail, a favicon-sized corner mark). */
-declare function FlytedeskMark({ size, className, ...rest }: FlytedeskMarkProps): React.JSX.Element;
-interface FlytedeskBrandProps {
-    /** The consuming app's name, shown under the logo — e.g. "Media Planner", "Admin". */
-    appName: string;
-    size?: "sm" | "md" | "lg";
-    className?: string;
-}
-/** The flytedesk logo stacked over the app's name — meant to drop straight into
- *  SidebarNav's `brand` slot in every flytedesk app. */
-declare function FlytedeskBrand({ appName, size, className, ...rest }: FlytedeskBrandProps): React.JSX.Element;
-
-/**
- * Places within one screen. Underline only — no pill tabs in the product.
- */
-interface TabsProps {
-    tabs: Array<string | {
-        value: string;
-        label: string;
-        count?: number;
-    }>;
-    value?: string;
-    onChange?: (value: string) => void;
-    className?: string;
-}
-declare function Tabs({ tabs, value, onChange, className, ...rest }: TabsProps): React.JSX.Element;
-
 /** 60px app header: breadcrumb left, actions right, and a 2px route loader along its top edge. */
 interface TopbarProps {
     /** A non-last crumb with `onClick` calls it (via `preventDefault`) instead of following
@@ -502,6 +470,139 @@ interface TopbarProps {
 }
 declare function Topbar({ crumbs, actions, overflowActions, overflowBreakpoint, loading, onMenu, className, ...rest }: TopbarProps): React.JSX.Element;
 
+/**
+ * MP-221: the Topbar + SidebarNav + useResponsiveRail composition every flytedesk app
+ * shell hand-assembled — the full-height flex column, the rail/content flex row, the
+ * scrim, the overlay-close-on-navigate wiring and the centered, max-width content
+ * column — lived three times over (media-planner's PlannerShell, sms-app's Shell, and
+ * this package's own SidebarNav docs demo, which told every new app to copy it). The
+ * design of this API reads BOTH real compositions (PlannerShell.tsx, Shell.tsx): a
+ * plain "app passes nav items + identity + actions" shape covers everything the two
+ * shared, and each of PlannerShell's app-specific extras (the command palette,
+ * TestModeBar/RolePreviewBar, the assistant panel, Dev tools) stays out of it, reached
+ * 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.
+ */
+interface AppShellProps {
+    /** Rendered in SidebarNav's fixed-height brand row (e.g. FlytedeskBrand/FlytedeskMark,
+     *  optionally wrapped in a "go home" button — that wrapping is app behaviour, not
+     *  something AppShell can supply generically). */
+    brand?: React.ReactNode;
+    /** SidebarNav's groups. */
+    navGroups: Array<{
+        label?: string;
+        items: SidebarNavItem[];
+    }>;
+    /** The active item's value, matched against each item's own `value`. */
+    currentNav?: string;
+    /** Called with an item's value when it's clicked. AppShell closes the rail itself
+     *  first when it's an overlay — an app never has to remember that half of the wiring. */
+    onNavigate: (value: string) => void;
+    /** SidebarNav's footer slot (e.g. media-planner's "Jump to… ⌘K" trigger). */
+    navFooter?: React.ReactNode;
+    /** The rail's open state on first render while docked — the seam for an app's own
+     *  persisted desktop preference (e.g. a `usePref`-backed value). Ignored while the
+     *  initial viewport is already in overlay range, which always starts closed. */
+    initialNavOpen?: boolean;
+    /** Called with the new open state whenever it changes while docked — an app's hook
+     *  into persisting `initialNavOpen`. Never called for a transient overlay open/close. */
+    onNavOpenChange?: (open: boolean) => void;
+    /** Max-width (px) at which the rail becomes a scrimmed overlay instead of a docked
+     *  column. Must match the design system's own `.fd-side` breakpoint (default 1024)
+     *  unless an app's own CSS overrides that breakpoint too. */
+    railBreakpoint?: number;
+    /** Topbar's breadcrumbs. */
+    crumbs?: TopbarProps["crumbs"];
+    /** Shows Topbar's route-loading indicator along its top edge. */
+    loading?: boolean;
+    /** Topbar's never-collapsing slot — the one control every screen needs to keep
+     *  directly reachable, typically the AccountMenu. */
+    actions: React.ReactNode;
+    /** Topbar's slot that collapses into a "More actions" menu under `overflowBreakpoint`
+     *  (an assistant launcher, AppearanceMenu, a version badge, Dev tools, undo, …). */
+    overflowActions?: React.ReactNode;
+    overflowBreakpoint?: number;
+    /** A full-width band rendered above the rail/content row, outside the scrollable
+     *  content column — e.g. a test-mode or role-preview banner. Omit for none. */
+    banner?: React.ReactNode;
+    /** A third flex sibling rendered after the main content column (e.g. an assistant
+     *  side panel that goes full-screen below the same breakpoint the rail does). Called
+     *  with the rail's own `overlay` flag so a panel that needs its own scrim/stacking at
+     *  that width can key off the same breakpoint AppShell already computed, rather than
+     *  re-deriving it. */
+    trailingPanel?: (ctx: {
+        overlay: boolean;
+    }) => React.ReactNode;
+    /** Max width (px) of the centered content column. Default 1440 — every current
+     *  flytedesk app shell's own value. */
+    contentMaxWidth?: number;
+    /** The shell's own height. Default `"100vh"`, correct for the real, top-level use
+     *  every app mounts this at. A demo or preview embedding AppShell inside a bounded
+     *  container (this package's own docs site) passes e.g. `"100%"` instead. */
+    height?: string | number;
+    /** Extra class name on the content column (e.g. media-planner's container-query
+     *  class for its own responsive grids). */
+    contentClassName?: string;
+    className?: string;
+    /** The routed screen content, rendered inside the padded, centered content column. */
+    children: React.ReactNode;
+}
+declare function AppShell({ brand, navGroups, currentNav, onNavigate, navFooter, initialNavOpen, onNavOpenChange, railBreakpoint, crumbs, loading, actions, overflowActions, overflowBreakpoint, banner, trailingPanel, contentMaxWidth, height, contentClassName, className, children, }: AppShellProps): React.JSX.Element;
+
+interface FlytedeskMarkProps {
+    size?: "sm" | "md" | "lg";
+    className?: string;
+}
+/** Just the flytedesk logo, no label — for contexts too small for a stacked brand
+ *  (a collapsed rail, a favicon-sized corner mark). */
+declare function FlytedeskMark({ size, className, ...rest }: FlytedeskMarkProps): React.JSX.Element;
+interface FlytedeskBrandProps {
+    /** The consuming app's name, shown under the logo — e.g. "Media Planner", "Admin". */
+    appName: string;
+    size?: "sm" | "md" | "lg";
+    className?: string;
+}
+/** The flytedesk logo stacked over the app's name — meant to drop straight into
+ *  SidebarNav's `brand` slot in every flytedesk app. */
+declare function FlytedeskBrand({ appName, size, className, ...rest }: FlytedeskBrandProps): React.JSX.Element;
+/**
+ * MP-221: the Flytedesk favicon — the exact `.ico` media-planner and sms-app both
+ * shipped as a byte-identical copy in `apps/web/public/favicon.ico` (SMS-5 gate
+ * review) — now ships as a real file in this package, at `assets/favicon.ico`
+ * (`"./assets/*"` in package.json's `exports`). A Vite app resolves it with the same
+ * `?url` suffix it already uses for any other imported asset, then installs it with
+ * this helper instead of hand-writing the `<link rel="icon">` DOM code per app:
+ *
+ *   import favicon from "@flytedan/flytebot-design-system/assets/favicon.ico?url";
+ *   import { installFlytedeskFavicon } from "@flytedan/flytebot-design-system";
+ *
+ *   installFlytedeskFavicon(favicon); // once, e.g. at the top of main.tsx
+ *
+ * Takes the resolved URL rather than resolving it itself: asset URL resolution is the
+ * consuming app's own bundler's job (Vite rewrites the import at build time to a
+ * hashed, content-addressed path), not something this package can do on an app's
+ * behalf without bundling a copy of every app's Vite config.
+ */
+declare function installFlytedeskFavicon(url: string): void;
+
+/**
+ * Places within one screen. Underline only — no pill tabs in the product.
+ */
+interface TabsProps {
+    tabs: Array<string | {
+        value: string;
+        label: string;
+        count?: number;
+    }>;
+    value?: string;
+    onChange?: (value: string) => void;
+    className?: string;
+}
+declare function Tabs({ tabs, value, onChange, className, ...rest }: TabsProps): React.JSX.Element;
+
 /** A person or organisation mark. Initials on a soft brand tint when no image exists. */
 interface AvatarProps {
     name?: string;
@@ -2145,7 +2246,10 @@ interface AccountMenuProps {
     /** Preferred over href navigation — lets an SPA route without a page load. */
     onNavigate?: (href: string | undefined, item: AccountMenuLink) => void;
     /** May return a Promise — the sign-out item shows a spinner and disables itself until it
-     *  settles, then closes the menu. Falls back to the injected session's own `signOut`. */
+     *  settles. On success the menu closes; on rejection the menu stays open with an inline,
+     *  announced error and a Retry (MP-221) — the session is unchanged, so closing here would
+     *  tell the user they signed out when they didn't. Falls back to the injected session's
+     *  own `signOut`. */
     onSignOut?: () => void | Promise<void>;
     showRoles?: boolean;
     /** Demo affordance: impersonate another member to see their UI. Default true. */
@@ -2483,6 +2587,59 @@ interface ProfilePageProps {
  */
 declare function ProfilePage({ user: userProp, fields, notifications, extra, onChangePhoto, onSave, onNavigate, sessions, onSignOutEverywhere, className, }: ProfilePageProps): React.JSX.Element;
 
+/**
+ * MP-224: the one flytedesk sign-in screen, moved here from media-planner's
+ * hand-built `LoginPage` so every app (media-planner now, sms-app in SMS-5)
+ * renders the same branded screen instead of drifting copies — sms-app's own
+ * copy had regressed to showing its raw app id ("sms-app") as the heading.
+ *
+ * Purely presentational: this component knows nothing about any app's session
+ * library. The app supplies `productName` for the heading and `onSignIn()`,
+ * called on click — the app then does its own full-page navigation to its
+ * API's `/auth/login` (a real browser navigation, not a fetch, since the
+ * subsequent hop through flytedesk-id and back is a redirect chain the
+ * browser has to actually follow). This component only drives the button's
+ * own loading state from that click until the page unloads; it never
+ * initiates the navigation itself.
+ *
+ * `continueAs` is optional and purely additive: when present, it shows a
+ * "Continue as {name}" primary action (with its own "Resuming…" loading
+ * state) plus a "Not you? Sign in with flytedesk ID" link that falls back to
+ * the ordinary sign-in button via `onDecline`. The actual silent-resume
+ * mechanism (prompt=none) is out of scope here — it lives in app-kit (AK-14)
+ * and the app supplies it as `onContinue`.
+ *
+ * Visual design carried over unchanged from media-planner's LoginPage: navy
+ * gradient background, faint grid overlay, the flytedesk wordmark, and the
+ * card's gradient top stripe. The wordmark reuses `FlytedeskMark` (this
+ * package's existing brand asset) rather than a second inline SVG — its
+ * artwork is fixed dark-navy ink with dark-theme handled by a CSS filter (see
+ * FlytedeskBrand.tsx), so it is wrapped in its own `data-theme="dark"` scope
+ * here to force the white variant against this page's permanently-dark
+ * background, without affecting the (light) Card beneath it.
+ */
+interface SignInContinueAs {
+    /** The previously-signed-in user's display name, e.g. "Dana Reyes". */
+    name: string;
+    /** One more silent sign-in attempt. Resolve on success (the app then
+     *  re-renders signed in) or on failure (the app falls back by no longer
+     *  passing `continueAs`, or the user clicks "Not you?"). */
+    onContinue: () => Promise<void>;
+    /** "Not you? Sign in with flytedesk ID" was clicked — show the ordinary
+     *  sign-in button instead. */
+    onDecline: () => void;
+}
+interface SignInPageProps {
+    /** The heading, e.g. "Media Planner" or "SMS". */
+    productName: string;
+    /** Starts the app's own full-page navigation to its API's /auth/login.
+     *  This component shows the button's loading state from the click until
+     *  the page unloads. */
+    onSignIn: () => void;
+    continueAs?: SignInContinueAs;
+}
+declare function SignInPage({ productName, onSignIn, continueAs }: SignInPageProps): React.JSX.Element;
+
 interface RoadmapTimelineProps {
     /** Called with a flag key when the reader clicks one — route it to your flag admin. */
     onOpenFlag?: (flagKey: string) => void;
@@ -4133,4 +4290,22 @@ declare function useResponsiveRail(options?: UseResponsiveRailOptions): UseRespo
 
 declare function useFocusTrap(containerRef: React.RefObject<HTMLElement | null>, active: boolean): void;
 
-export { AccountMenu, type AccountMenuLink, type AccountMenuProps, AgentChatPanel, type AgentChatPanelProps, AnchoredPopover, type AnchoredPopoverProps, AnimNum, type AnimNumProps, ApiSpecBrowser, type ApiSpecBrowserProps, type AppEntry, 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, 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, Drawer, type DrawerProps, Dropzone, DropzoneKit, type DropzoneProps, ENTITY_ROW_METRIC_WIDTH, type EditorTrigger, EmptyState, type EmptyStateProps, type EndpointSpec, EntityRow, type EntityRowAction, type EntityRowContent, type EntityRowMetric, EntityRowMetrics, type EntityRowMetricsProps, type EntityRowProps, FILE_VIEWER_CSV_ROW_LIMIT, FILE_VIEWER_TEXT_LIMIT, FeatureGate, type FeatureGateProps, type FeatureStatus, FileBrowser, type FileBrowserFile, type FileBrowserFolder, type FileBrowserPermissions, type FileBrowserProps, FileChip, type FileChipProps, FileGrid, type FileGridProps, FileKit, FilePickButton, type FilePickButtonProps, type FileRejection, FileStrip, type FileStripProps, FileTile, type FileTileProps, type FileUploadHandler, FileViewer, type FileViewerProps, FilterBar, type FilterBarProps, type FilterField, type FilterFieldOption, type FilterFieldSelect, type FilterFieldText, Flag$1 as Flag, type FlagExplanation, type FlagProps, FlytedeskBrand, type FlytedeskBrandProps, FlytedeskMark, type FlytedeskMarkProps, FormatEta, Gate, type GateProps, IMPORTANCE_LEVELS, IconButton, type IconButtonProps, type ImportanceLevel, type ImportanceLevelId, ImportanceTag, type ImportanceTagProps, type ImportanceTokens, Input, type InputProps, type JobStatus, 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 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, 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 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, formatDuration, formatEta, formatRelative, groupMessages, hasModifier, iconForMime, importanceLevel, importanceTokens, isImage, isSystemMessage, jobBucket, languageLabel, loadPrefs, markdownToText, meterFormats, modifierLabel, parseDelimited, pastedTextName, pluralizeUnit, preferenceScore, preferenceSegments, rangeFilter, resolveTheme, revokeAttachment, savePrefs, toAttachment, tokenize, useAppearancePrefs, useChatEngine, useFeatureStatus, useFocusTrap, usePopoverPosition, useResponsiveRail, useRuntimeMode, useServerTable, useSessionContext, useStagedFiles, visibleMessages };
+/**
+ * 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,
+ * SignIn.tsx and index.html each spelled " · SMS · Flytedesk" separately — SMS-5
+ * code-quality review item 5). One place composes it now.
+ *
+ * `routeTitle` is optional so a route with no title of its own (e.g. a bare loading
+ * state) still gets a correct "<app> · Flytedesk" title instead of a dangling separator.
+ */
+declare function formatDocumentTitle(routeTitle: string | undefined | null, appName: string): string;
+/**
+ * Sets `document.title` to `formatDocumentTitle(routeTitle, appName)` for as long as the
+ * calling component is mounted, and re-applies it whenever either argument changes —
+ * e.g. call it once per route component with that route's own title. Does nothing
+ * outside a DOM environment (SSR/tests with no `document`).
+ */
+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, 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, Drawer, type DrawerProps, Dropzone, DropzoneKit, type DropzoneProps, ENTITY_ROW_METRIC_WIDTH, type EditorTrigger, EmptyState, type EmptyStateProps, type EndpointSpec, EntityRow, type EntityRowAction, type EntityRowContent, type EntityRowMetric, EntityRowMetrics, type EntityRowMetricsProps, type EntityRowProps, FILE_VIEWER_CSV_ROW_LIMIT, FILE_VIEWER_TEXT_LIMIT, FeatureGate, type FeatureGateProps, type FeatureStatus, FileBrowser, type FileBrowserFile, type FileBrowserFolder, type FileBrowserPermissions, type FileBrowserProps, FileChip, type FileChipProps, FileGrid, type FileGridProps, FileKit, FilePickButton, type FilePickButtonProps, type FileRejection, FileStrip, type FileStripProps, FileTile, type FileTileProps, type FileUploadHandler, FileViewer, type FileViewerProps, FilterBar, type FilterBarProps, type FilterField, type FilterFieldOption, type FilterFieldSelect, type FilterFieldText, Flag$1 as Flag, type FlagExplanation, type FlagProps, FlytedeskBrand, type FlytedeskBrandProps, FlytedeskMark, type FlytedeskMarkProps, FormatEta, Gate, type GateProps, IMPORTANCE_LEVELS, IconButton, type IconButtonProps, type ImportanceLevel, type ImportanceLevelId, ImportanceTag, type ImportanceTagProps, type ImportanceTokens, Input, type InputProps, type JobStatus, 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 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 UsageLimit, UseFeatureStatus, type UseResponsiveRailOptions, type UseResponsiveRailResult, UseRuntimeMode, type UseServerTableOptions, type User, VIRTUAL_LIST_BUFFER_ROWS, VIRTUAL_LIST_ROW_GAP, type VersionRecord, type VersionStore, VirtualList, type VirtualListProps, type VirtualLoadedBand, type VirtualWindow, type VoiceHandler, acceptMatches, anyOfFilter, applyPrefs, channelWeightOf, computeNeedMore, computeVirtualWindow, createLocalStorageAppearanceStore, createVersionStore, eqFilter, extensionOf, extractClipboardFiles, filterFiles, formatAbsolute, formatBytes, formatClock, formatDocumentTitle, formatDuration, formatEta, formatRelative, groupMessages, hasModifier, iconForMime, importanceLevel, importanceTokens, installFlytedeskFavicon, isImage, isSystemMessage, jobBucket, languageLabel, loadPrefs, markdownToText, meterFormats, modifierLabel, parseDelimited, pastedTextName, pluralizeUnit, preferenceScore, preferenceSegments, rangeFilter, resolveTheme, revokeAttachment, savePrefs, toAttachment, tokenize, useAppearancePrefs, useChatEngine, useDocumentTitle, useFeatureStatus, useFocusTrap, usePopoverPosition, useResponsiveRail, useRuntimeMode, useServerTable, useSessionContext, useStagedFiles, visibleMessages };

package/dist/index.d.ts

@@ -437,38 +437,6 @@ interface SidebarNavProps {
 }
 declare const SidebarNav: React.ForwardRefExoticComponent<SidebarNavProps & React.RefAttributes<HTMLElement>>;
 
-interface FlytedeskMarkProps {
-    size?: "sm" | "md" | "lg";
-    className?: string;
-}
-/** Just the flytedesk logo, no label — for contexts too small for a stacked brand
- *  (a collapsed rail, a favicon-sized corner mark). */
-declare function FlytedeskMark({ size, className, ...rest }: FlytedeskMarkProps): React.JSX.Element;
-interface FlytedeskBrandProps {
-    /** The consuming app's name, shown under the logo — e.g. "Media Planner", "Admin". */
-    appName: string;
-    size?: "sm" | "md" | "lg";
-    className?: string;
-}
-/** The flytedesk logo stacked over the app's name — meant to drop straight into
- *  SidebarNav's `brand` slot in every flytedesk app. */
-declare function FlytedeskBrand({ appName, size, className, ...rest }: FlytedeskBrandProps): React.JSX.Element;
-
-/**
- * Places within one screen. Underline only — no pill tabs in the product.
- */
-interface TabsProps {
-    tabs: Array<string | {
-        value: string;
-        label: string;
-        count?: number;
-    }>;
-    value?: string;
-    onChange?: (value: string) => void;
-    className?: string;
-}
-declare function Tabs({ tabs, value, onChange, className, ...rest }: TabsProps): React.JSX.Element;
-
 /** 60px app header: breadcrumb left, actions right, and a 2px route loader along its top edge. */
 interface TopbarProps {
     /** A non-last crumb with `onClick` calls it (via `preventDefault`) instead of following
@@ -502,6 +470,139 @@ interface TopbarProps {
 }
 declare function Topbar({ crumbs, actions, overflowActions, overflowBreakpoint, loading, onMenu, className, ...rest }: TopbarProps): React.JSX.Element;
 
+/**
+ * MP-221: the Topbar + SidebarNav + useResponsiveRail composition every flytedesk app
+ * shell hand-assembled — the full-height flex column, the rail/content flex row, the
+ * scrim, the overlay-close-on-navigate wiring and the centered, max-width content
+ * column — lived three times over (media-planner's PlannerShell, sms-app's Shell, and
+ * this package's own SidebarNav docs demo, which told every new app to copy it). The
+ * design of this API reads BOTH real compositions (PlannerShell.tsx, Shell.tsx): a
+ * plain "app passes nav items + identity + actions" shape covers everything the two
+ * shared, and each of PlannerShell's app-specific extras (the command palette,
+ * TestModeBar/RolePreviewBar, the assistant panel, Dev tools) stays out of it, reached
+ * 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.
+ */
+interface AppShellProps {
+    /** Rendered in SidebarNav's fixed-height brand row (e.g. FlytedeskBrand/FlytedeskMark,
+     *  optionally wrapped in a "go home" button — that wrapping is app behaviour, not
+     *  something AppShell can supply generically). */
+    brand?: React.ReactNode;
+    /** SidebarNav's groups. */
+    navGroups: Array<{
+        label?: string;
+        items: SidebarNavItem[];
+    }>;
+    /** The active item's value, matched against each item's own `value`. */
+    currentNav?: string;
+    /** Called with an item's value when it's clicked. AppShell closes the rail itself
+     *  first when it's an overlay — an app never has to remember that half of the wiring. */
+    onNavigate: (value: string) => void;
+    /** SidebarNav's footer slot (e.g. media-planner's "Jump to… ⌘K" trigger). */
+    navFooter?: React.ReactNode;
+    /** The rail's open state on first render while docked — the seam for an app's own
+     *  persisted desktop preference (e.g. a `usePref`-backed value). Ignored while the
+     *  initial viewport is already in overlay range, which always starts closed. */
+    initialNavOpen?: boolean;
+    /** Called with the new open state whenever it changes while docked — an app's hook
+     *  into persisting `initialNavOpen`. Never called for a transient overlay open/close. */
+    onNavOpenChange?: (open: boolean) => void;
+    /** Max-width (px) at which the rail becomes a scrimmed overlay instead of a docked
+     *  column. Must match the design system's own `.fd-side` breakpoint (default 1024)
+     *  unless an app's own CSS overrides that breakpoint too. */
+    railBreakpoint?: number;
+    /** Topbar's breadcrumbs. */
+    crumbs?: TopbarProps["crumbs"];
+    /** Shows Topbar's route-loading indicator along its top edge. */
+    loading?: boolean;
+    /** Topbar's never-collapsing slot — the one control every screen needs to keep
+     *  directly reachable, typically the AccountMenu. */
+    actions: React.ReactNode;
+    /** Topbar's slot that collapses into a "More actions" menu under `overflowBreakpoint`
+     *  (an assistant launcher, AppearanceMenu, a version badge, Dev tools, undo, …). */
+    overflowActions?: React.ReactNode;
+    overflowBreakpoint?: number;
+    /** A full-width band rendered above the rail/content row, outside the scrollable
+     *  content column — e.g. a test-mode or role-preview banner. Omit for none. */
+    banner?: React.ReactNode;
+    /** A third flex sibling rendered after the main content column (e.g. an assistant
+     *  side panel that goes full-screen below the same breakpoint the rail does). Called
+     *  with the rail's own `overlay` flag so a panel that needs its own scrim/stacking at
+     *  that width can key off the same breakpoint AppShell already computed, rather than
+     *  re-deriving it. */
+    trailingPanel?: (ctx: {
+        overlay: boolean;
+    }) => React.ReactNode;
+    /** Max width (px) of the centered content column. Default 1440 — every current
+     *  flytedesk app shell's own value. */
+    contentMaxWidth?: number;
+    /** The shell's own height. Default `"100vh"`, correct for the real, top-level use
+     *  every app mounts this at. A demo or preview embedding AppShell inside a bounded
+     *  container (this package's own docs site) passes e.g. `"100%"` instead. */
+    height?: string | number;
+    /** Extra class name on the content column (e.g. media-planner's container-query
+     *  class for its own responsive grids). */
+    contentClassName?: string;
+    className?: string;
+    /** The routed screen content, rendered inside the padded, centered content column. */
+    children: React.ReactNode;
+}
+declare function AppShell({ brand, navGroups, currentNav, onNavigate, navFooter, initialNavOpen, onNavOpenChange, railBreakpoint, crumbs, loading, actions, overflowActions, overflowBreakpoint, banner, trailingPanel, contentMaxWidth, height, contentClassName, className, children, }: AppShellProps): React.JSX.Element;
+
+interface FlytedeskMarkProps {
+    size?: "sm" | "md" | "lg";
+    className?: string;
+}
+/** Just the flytedesk logo, no label — for contexts too small for a stacked brand
+ *  (a collapsed rail, a favicon-sized corner mark). */
+declare function FlytedeskMark({ size, className, ...rest }: FlytedeskMarkProps): React.JSX.Element;
+interface FlytedeskBrandProps {
+    /** The consuming app's name, shown under the logo — e.g. "Media Planner", "Admin". */
+    appName: string;
+    size?: "sm" | "md" | "lg";
+    className?: string;
+}
+/** The flytedesk logo stacked over the app's name — meant to drop straight into
+ *  SidebarNav's `brand` slot in every flytedesk app. */
+declare function FlytedeskBrand({ appName, size, className, ...rest }: FlytedeskBrandProps): React.JSX.Element;
+/**
+ * MP-221: the Flytedesk favicon — the exact `.ico` media-planner and sms-app both
+ * shipped as a byte-identical copy in `apps/web/public/favicon.ico` (SMS-5 gate
+ * review) — now ships as a real file in this package, at `assets/favicon.ico`
+ * (`"./assets/*"` in package.json's `exports`). A Vite app resolves it with the same
+ * `?url` suffix it already uses for any other imported asset, then installs it with
+ * this helper instead of hand-writing the `<link rel="icon">` DOM code per app:
+ *
+ *   import favicon from "@flytedan/flytebot-design-system/assets/favicon.ico?url";
+ *   import { installFlytedeskFavicon } from "@flytedan/flytebot-design-system";
+ *
+ *   installFlytedeskFavicon(favicon); // once, e.g. at the top of main.tsx
+ *
+ * Takes the resolved URL rather than resolving it itself: asset URL resolution is the
+ * consuming app's own bundler's job (Vite rewrites the import at build time to a
+ * hashed, content-addressed path), not something this package can do on an app's
+ * behalf without bundling a copy of every app's Vite config.
+ */
+declare function installFlytedeskFavicon(url: string): void;
+
+/**
+ * Places within one screen. Underline only — no pill tabs in the product.
+ */
+interface TabsProps {
+    tabs: Array<string | {
+        value: string;
+        label: string;
+        count?: number;
+    }>;
+    value?: string;
+    onChange?: (value: string) => void;
+    className?: string;
+}
+declare function Tabs({ tabs, value, onChange, className, ...rest }: TabsProps): React.JSX.Element;
+
 /** A person or organisation mark. Initials on a soft brand tint when no image exists. */
 interface AvatarProps {
     name?: string;
@@ -2145,7 +2246,10 @@ interface AccountMenuProps {
     /** Preferred over href navigation — lets an SPA route without a page load. */
     onNavigate?: (href: string | undefined, item: AccountMenuLink) => void;
     /** May return a Promise — the sign-out item shows a spinner and disables itself until it
-     *  settles, then closes the menu. Falls back to the injected session's own `signOut`. */
+     *  settles. On success the menu closes; on rejection the menu stays open with an inline,
+     *  announced error and a Retry (MP-221) — the session is unchanged, so closing here would
+     *  tell the user they signed out when they didn't. Falls back to the injected session's
+     *  own `signOut`. */
     onSignOut?: () => void | Promise<void>;
     showRoles?: boolean;
     /** Demo affordance: impersonate another member to see their UI. Default true. */
@@ -2483,6 +2587,59 @@ interface ProfilePageProps {
  */
 declare function ProfilePage({ user: userProp, fields, notifications, extra, onChangePhoto, onSave, onNavigate, sessions, onSignOutEverywhere, className, }: ProfilePageProps): React.JSX.Element;
 
+/**
+ * MP-224: the one flytedesk sign-in screen, moved here from media-planner's
+ * hand-built `LoginPage` so every app (media-planner now, sms-app in SMS-5)
+ * renders the same branded screen instead of drifting copies — sms-app's own
+ * copy had regressed to showing its raw app id ("sms-app") as the heading.
+ *
+ * Purely presentational: this component knows nothing about any app's session
+ * library. The app supplies `productName` for the heading and `onSignIn()`,
+ * called on click — the app then does its own full-page navigation to its
+ * API's `/auth/login` (a real browser navigation, not a fetch, since the
+ * subsequent hop through flytedesk-id and back is a redirect chain the
+ * browser has to actually follow). This component only drives the button's
+ * own loading state from that click until the page unloads; it never
+ * initiates the navigation itself.
+ *
+ * `continueAs` is optional and purely additive: when present, it shows a
+ * "Continue as {name}" primary action (with its own "Resuming…" loading
+ * state) plus a "Not you? Sign in with flytedesk ID" link that falls back to
+ * the ordinary sign-in button via `onDecline`. The actual silent-resume
+ * mechanism (prompt=none) is out of scope here — it lives in app-kit (AK-14)
+ * and the app supplies it as `onContinue`.
+ *
+ * Visual design carried over unchanged from media-planner's LoginPage: navy
+ * gradient background, faint grid overlay, the flytedesk wordmark, and the
+ * card's gradient top stripe. The wordmark reuses `FlytedeskMark` (this
+ * package's existing brand asset) rather than a second inline SVG — its
+ * artwork is fixed dark-navy ink with dark-theme handled by a CSS filter (see
+ * FlytedeskBrand.tsx), so it is wrapped in its own `data-theme="dark"` scope
+ * here to force the white variant against this page's permanently-dark
+ * background, without affecting the (light) Card beneath it.
+ */
+interface SignInContinueAs {
+    /** The previously-signed-in user's display name, e.g. "Dana Reyes". */
+    name: string;
+    /** One more silent sign-in attempt. Resolve on success (the app then
+     *  re-renders signed in) or on failure (the app falls back by no longer
+     *  passing `continueAs`, or the user clicks "Not you?"). */
+    onContinue: () => Promise<void>;
+    /** "Not you? Sign in with flytedesk ID" was clicked — show the ordinary
+     *  sign-in button instead. */
+    onDecline: () => void;
+}
+interface SignInPageProps {
+    /** The heading, e.g. "Media Planner" or "SMS". */
+    productName: string;
+    /** Starts the app's own full-page navigation to its API's /auth/login.
+     *  This component shows the button's loading state from the click until
+     *  the page unloads. */
+    onSignIn: () => void;
+    continueAs?: SignInContinueAs;
+}
+declare function SignInPage({ productName, onSignIn, continueAs }: SignInPageProps): React.JSX.Element;
+
 interface RoadmapTimelineProps {
     /** Called with a flag key when the reader clicks one — route it to your flag admin. */
     onOpenFlag?: (flagKey: string) => void;
@@ -4133,4 +4290,22 @@ declare function useResponsiveRail(options?: UseResponsiveRailOptions): UseRespo
 
 declare function useFocusTrap(containerRef: React.RefObject<HTMLElement | null>, active: boolean): void;
 
-export { AccountMenu, type AccountMenuLink, type AccountMenuProps, AgentChatPanel, type AgentChatPanelProps, AnchoredPopover, type AnchoredPopoverProps, AnimNum, type AnimNumProps, ApiSpecBrowser, type ApiSpecBrowserProps, type AppEntry, 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, 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, Drawer, type DrawerProps, Dropzone, DropzoneKit, type DropzoneProps, ENTITY_ROW_METRIC_WIDTH, type EditorTrigger, EmptyState, type EmptyStateProps, type EndpointSpec, EntityRow, type EntityRowAction, type EntityRowContent, type EntityRowMetric, EntityRowMetrics, type EntityRowMetricsProps, type EntityRowProps, FILE_VIEWER_CSV_ROW_LIMIT, FILE_VIEWER_TEXT_LIMIT, FeatureGate, type FeatureGateProps, type FeatureStatus, FileBrowser, type FileBrowserFile, type FileBrowserFolder, type FileBrowserPermissions, type FileBrowserProps, FileChip, type FileChipProps, FileGrid, type FileGridProps, FileKit, FilePickButton, type FilePickButtonProps, type FileRejection, FileStrip, type FileStripProps, FileTile, type FileTileProps, type FileUploadHandler, FileViewer, type FileViewerProps, FilterBar, type FilterBarProps, type FilterField, type FilterFieldOption, type FilterFieldSelect, type FilterFieldText, Flag$1 as Flag, type FlagExplanation, type FlagProps, FlytedeskBrand, type FlytedeskBrandProps, FlytedeskMark, type FlytedeskMarkProps, FormatEta, Gate, type GateProps, IMPORTANCE_LEVELS, IconButton, type IconButtonProps, type ImportanceLevel, type ImportanceLevelId, ImportanceTag, type ImportanceTagProps, type ImportanceTokens, Input, type InputProps, type JobStatus, 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 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, 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 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, formatDuration, formatEta, formatRelative, groupMessages, hasModifier, iconForMime, importanceLevel, importanceTokens, isImage, isSystemMessage, jobBucket, languageLabel, loadPrefs, markdownToText, meterFormats, modifierLabel, parseDelimited, pastedTextName, pluralizeUnit, preferenceScore, preferenceSegments, rangeFilter, resolveTheme, revokeAttachment, savePrefs, toAttachment, tokenize, useAppearancePrefs, useChatEngine, useFeatureStatus, useFocusTrap, usePopoverPosition, useResponsiveRail, useRuntimeMode, useServerTable, useSessionContext, useStagedFiles, visibleMessages };
+/**
+ * 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,
+ * SignIn.tsx and index.html each spelled " · SMS · Flytedesk" separately — SMS-5
+ * code-quality review item 5). One place composes it now.
+ *
+ * `routeTitle` is optional so a route with no title of its own (e.g. a bare loading
+ * state) still gets a correct "<app> · Flytedesk" title instead of a dangling separator.
+ */
+declare function formatDocumentTitle(routeTitle: string | undefined | null, appName: string): string;
+/**
+ * Sets `document.title` to `formatDocumentTitle(routeTitle, appName)` for as long as the
+ * calling component is mounted, and re-applies it whenever either argument changes —
+ * e.g. call it once per route component with that route's own title. Does nothing
+ * outside a DOM environment (SSR/tests with no `document`).
+ */
+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, 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, Drawer, type DrawerProps, Dropzone, DropzoneKit, type DropzoneProps, ENTITY_ROW_METRIC_WIDTH, type EditorTrigger, EmptyState, type EmptyStateProps, type EndpointSpec, EntityRow, type EntityRowAction, type EntityRowContent, type EntityRowMetric, EntityRowMetrics, type EntityRowMetricsProps, type EntityRowProps, FILE_VIEWER_CSV_ROW_LIMIT, FILE_VIEWER_TEXT_LIMIT, FeatureGate, type FeatureGateProps, type FeatureStatus, FileBrowser, type FileBrowserFile, type FileBrowserFolder, type FileBrowserPermissions, type FileBrowserProps, FileChip, type FileChipProps, FileGrid, type FileGridProps, FileKit, FilePickButton, type FilePickButtonProps, type FileRejection, FileStrip, type FileStripProps, FileTile, type FileTileProps, type FileUploadHandler, FileViewer, type FileViewerProps, FilterBar, type FilterBarProps, type FilterField, type FilterFieldOption, type FilterFieldSelect, type FilterFieldText, Flag$1 as Flag, type FlagExplanation, type FlagProps, FlytedeskBrand, type FlytedeskBrandProps, FlytedeskMark, type FlytedeskMarkProps, FormatEta, Gate, type GateProps, IMPORTANCE_LEVELS, IconButton, type IconButtonProps, type ImportanceLevel, type ImportanceLevelId, ImportanceTag, type ImportanceTagProps, type ImportanceTokens, Input, type InputProps, type JobStatus, 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 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 UsageLimit, UseFeatureStatus, type UseResponsiveRailOptions, type UseResponsiveRailResult, UseRuntimeMode, type UseServerTableOptions, type User, VIRTUAL_LIST_BUFFER_ROWS, VIRTUAL_LIST_ROW_GAP, type VersionRecord, type VersionStore, VirtualList, type VirtualListProps, type VirtualLoadedBand, type VirtualWindow, type VoiceHandler, acceptMatches, anyOfFilter, applyPrefs, channelWeightOf, computeNeedMore, computeVirtualWindow, createLocalStorageAppearanceStore, createVersionStore, eqFilter, extensionOf, extractClipboardFiles, filterFiles, formatAbsolute, formatBytes, formatClock, formatDocumentTitle, formatDuration, formatEta, formatRelative, groupMessages, hasModifier, iconForMime, importanceLevel, importanceTokens, installFlytedeskFavicon, isImage, isSystemMessage, jobBucket, languageLabel, loadPrefs, markdownToText, meterFormats, modifierLabel, parseDelimited, pastedTextName, pluralizeUnit, preferenceScore, preferenceSegments, rangeFilter, resolveTheme, revokeAttachment, savePrefs, toAttachment, tokenize, useAppearancePrefs, useChatEngine, useDocumentTitle, useFeatureStatus, useFocusTrap, usePopoverPosition, useResponsiveRail, useRuntimeMode, useServerTable, useSessionContext, useStagedFiles, visibleMessages };