@shortstravelmgmt/component-lib 0.2.11 → 0.2.12-canary.30.g1e89a1a

package/dist/index.d.ts

@@ -9,15 +9,15 @@ import React__default, { CSSProperties, HTMLAttributes, ButtonHTMLAttributes, In
  * Components should use these tokens via the useTheme hook or css utility.
  */
 declare const brandColors: {
-    readonly blue: "#15538C";
-    readonly blueDeep: "#0E3F6E";
-    readonly blueTint: "#E5EDF4";
+    readonly blue: "#19345F";
+    readonly blueDeep: "#0C1E3E";
+    readonly blueTint: "#E4F1F8";
 };
 declare const primaryColors: {
-    readonly primary: "#0A53EF";
-    readonly primaryDark: "#1A43D1";
-    readonly primaryLight: "#E6ECFB";
-    readonly primaryLightHover: "#DAE3F8";
+    readonly primary: "#19345F";
+    readonly primaryDark: "#0C1E3E";
+    readonly primaryLight: "#E4F1F8";
+    readonly primaryLightHover: "#D3E4F0";
 };
 declare const neutralColors: {
     readonly basecolor: "#F5F5F5";
@@ -44,8 +44,20 @@ declare const statusColors: {
     readonly warning: "#9F5500";
     readonly gold: "#FFC179";
     readonly error: "#940000";
+    readonly successInk: "#0F7350";
+    readonly warningInk: "#8F4C00";
+    readonly successAccent: "#2E9E6B";
+    readonly warningAccent: "#E8A13A";
+    readonly dangerAccent: "#D7503A";
+    readonly dangerAccentStrong: "#C0402C";
+    readonly dangerAccentStrongHover: "#A33524";
 };
 declare const accentColors: {
+    readonly teal: "#00BCD0";
+    readonly tealHover: "#00AEEF";
+    readonly tealContrast: "#0C1E3E";
+    readonly tealInk: "#009AAB";
+    readonly tealGlow: "rgba(0, 188, 208, 0.35)";
     readonly mint: "#37C3A4";
     readonly forest: "#003E1B";
     readonly forestLight: "#E2F0EC";
@@ -106,13 +118,13 @@ declare const vendorColors: {
     };
 };
 declare const gradients: {
-    readonly avatar: "linear-gradient(135deg, #4F7FFF 0%, #4066E8 100%)";
+    readonly avatar: "linear-gradient(135deg, #19345F 0%, #00BCD0 100%)";
 };
 declare const alertTokens: {
     readonly primary: {
-        readonly fg: "#0A53EF";
-        readonly bg: "#E6ECFB";
-        readonly border: "#0A53EF";
+        readonly fg: "#19345F";
+        readonly bg: "#E4F1F8";
+        readonly border: "#19345F";
     };
     readonly success: {
         readonly fg: "#138660";
@@ -137,8 +149,8 @@ declare const semanticColors: {
         readonly 3: "#5C5C5C";
         readonly 4: "#787878";
         readonly disabled: "#C7C7CA";
-        readonly link: "#0A53EF";
-        readonly linkHover: "#1A43D1";
+        readonly link: "#19345F";
+        readonly linkHover: "#0C1E3E";
     };
     readonly bg: {
         readonly page: "#F5F5F5";
@@ -148,8 +160,9 @@ declare const semanticColors: {
     };
 };
 declare const fontFamily: {
-    readonly base: "'Roboto Flex', system-ui, -apple-system, 'Segoe UI', sans-serif";
-    readonly display: "'Roboto Flex', system-ui, -apple-system, sans-serif";
+    readonly base: "'Inter', system-ui, -apple-system, 'Segoe UI', sans-serif";
+    readonly display: "'Montserrat', system-ui, -apple-system, sans-serif";
+    readonly label: "'Roboto Condensed', system-ui, -apple-system, sans-serif";
     readonly mono: "'JetBrains Mono', ui-monospace, 'SFMono-Regular', Menlo, Consolas, monospace";
 };
 declare const fontSize: {
@@ -225,15 +238,15 @@ declare const transition: {
 declare const lightTheme: {
     readonly colors: {
         readonly brand: {
-            readonly blue: "#15538C";
-            readonly blueDeep: "#0E3F6E";
-            readonly blueTint: "#E5EDF4";
+            readonly blue: "#19345F";
+            readonly blueDeep: "#0C1E3E";
+            readonly blueTint: "#E4F1F8";
         };
         readonly primary: {
-            readonly primary: "#0A53EF";
-            readonly primaryDark: "#1A43D1";
-            readonly primaryLight: "#E6ECFB";
-            readonly primaryLightHover: "#DAE3F8";
+            readonly primary: "#19345F";
+            readonly primaryDark: "#0C1E3E";
+            readonly primaryLight: "#E4F1F8";
+            readonly primaryLightHover: "#D3E4F0";
         };
         readonly neutral: {
             readonly basecolor: "#F5F5F5";
@@ -260,8 +273,20 @@ declare const lightTheme: {
             readonly warning: "#9F5500";
             readonly gold: "#FFC179";
             readonly error: "#940000";
+            readonly successInk: "#0F7350";
+            readonly warningInk: "#8F4C00";
+            readonly successAccent: "#2E9E6B";
+            readonly warningAccent: "#E8A13A";
+            readonly dangerAccent: "#D7503A";
+            readonly dangerAccentStrong: "#C0402C";
+            readonly dangerAccentStrongHover: "#A33524";
         };
         readonly accent: {
+            readonly teal: "#00BCD0";
+            readonly tealHover: "#00AEEF";
+            readonly tealContrast: "#0C1E3E";
+            readonly tealInk: "#009AAB";
+            readonly tealGlow: "rgba(0, 188, 208, 0.35)";
             readonly mint: "#37C3A4";
             readonly forest: "#003E1B";
             readonly forestLight: "#E2F0EC";
@@ -323,9 +348,9 @@ declare const lightTheme: {
         };
         readonly alert: {
             readonly primary: {
-                readonly fg: "#0A53EF";
-                readonly bg: "#E6ECFB";
-                readonly border: "#0A53EF";
+                readonly fg: "#19345F";
+                readonly bg: "#E4F1F8";
+                readonly border: "#19345F";
             };
             readonly success: {
                 readonly fg: "#138660";
@@ -350,8 +375,8 @@ declare const lightTheme: {
                 readonly 3: "#5C5C5C";
                 readonly 4: "#787878";
                 readonly disabled: "#C7C7CA";
-                readonly link: "#0A53EF";
-                readonly linkHover: "#1A43D1";
+                readonly link: "#19345F";
+                readonly linkHover: "#0C1E3E";
             };
             readonly bg: {
                 readonly page: "#F5F5F5";
@@ -363,8 +388,9 @@ declare const lightTheme: {
     };
     readonly typography: {
         readonly fontFamily: {
-            readonly base: "'Roboto Flex', system-ui, -apple-system, 'Segoe UI', sans-serif";
-            readonly display: "'Roboto Flex', system-ui, -apple-system, sans-serif";
+            readonly base: "'Inter', system-ui, -apple-system, 'Segoe UI', sans-serif";
+            readonly display: "'Montserrat', system-ui, -apple-system, sans-serif";
+            readonly label: "'Roboto Condensed', system-ui, -apple-system, sans-serif";
             readonly mono: "'JetBrains Mono', ui-monospace, 'SFMono-Regular', Menlo, Consolas, monospace";
         };
         readonly fontSize: {
@@ -439,11 +465,29 @@ declare const lightTheme: {
         readonly slow: "300ms ease";
     };
     readonly gradients: {
-        readonly avatar: "linear-gradient(135deg, #4F7FFF 0%, #4066E8 100%)";
+        readonly avatar: "linear-gradient(135deg, #19345F 0%, #00BCD0 100%)";
     };
 };
 declare const darkTheme: {
     readonly colors: {
+        readonly primary: {
+            readonly primary: "#0A53EF";
+            readonly primaryDark: "#1A43D1";
+            readonly primaryLight: "#E6ECFB";
+            readonly primaryLightHover: "#DAE3F8";
+        };
+        readonly accent: {
+            readonly tealInk: "#00BCD0";
+            readonly teal: "#00BCD0";
+            readonly tealHover: "#00AEEF";
+            readonly tealContrast: "#0C1E3E";
+            readonly tealGlow: "rgba(0, 188, 208, 0.35)";
+            readonly mint: "#37C3A4";
+            readonly forest: "#003E1B";
+            readonly forestLight: "#E2F0EC";
+            readonly tangerine: "#FE7C35";
+            readonly tangerineLight: "#FFE2C1";
+        };
         readonly neutral: {
             readonly basecolor: "#1a1a1a";
             readonly subtle: "#2a2a2a";
@@ -482,28 +526,22 @@ declare const darkTheme: {
             };
         };
         readonly brand: {
-            readonly blue: "#15538C";
-            readonly blueDeep: "#0E3F6E";
-            readonly blueTint: "#E5EDF4";
-        };
-        readonly primary: {
-            readonly primary: "#0A53EF";
-            readonly primaryDark: "#1A43D1";
-            readonly primaryLight: "#E6ECFB";
-            readonly primaryLightHover: "#DAE3F8";
+            readonly blue: "#19345F";
+            readonly blueDeep: "#0C1E3E";
+            readonly blueTint: "#E4F1F8";
         };
         readonly status: {
             readonly success: "#138660";
             readonly warning: "#9F5500";
             readonly gold: "#FFC179";
             readonly error: "#940000";
-        };
-        readonly accent: {
-            readonly mint: "#37C3A4";
-            readonly forest: "#003E1B";
-            readonly forestLight: "#E2F0EC";
-            readonly tangerine: "#FE7C35";
-            readonly tangerineLight: "#FFE2C1";
+            readonly successInk: "#0F7350";
+            readonly warningInk: "#8F4C00";
+            readonly successAccent: "#2E9E6B";
+            readonly warningAccent: "#E8A13A";
+            readonly dangerAccent: "#D7503A";
+            readonly dangerAccentStrong: "#C0402C";
+            readonly dangerAccentStrongHover: "#A33524";
         };
         readonly team: {
             readonly men: "#8AC6D9";
@@ -560,9 +598,9 @@ declare const darkTheme: {
         };
         readonly alert: {
             readonly primary: {
-                readonly fg: "#0A53EF";
-                readonly bg: "#E6ECFB";
-                readonly border: "#0A53EF";
+                readonly fg: "#19345F";
+                readonly bg: "#E4F1F8";
+                readonly border: "#19345F";
             };
             readonly success: {
                 readonly fg: "#138660";
@@ -583,8 +621,9 @@ declare const darkTheme: {
     };
     readonly typography: {
         readonly fontFamily: {
-            readonly base: "'Roboto Flex', system-ui, -apple-system, 'Segoe UI', sans-serif";
-            readonly display: "'Roboto Flex', system-ui, -apple-system, sans-serif";
+            readonly base: "'Inter', system-ui, -apple-system, 'Segoe UI', sans-serif";
+            readonly display: "'Montserrat', system-ui, -apple-system, sans-serif";
+            readonly label: "'Roboto Condensed', system-ui, -apple-system, sans-serif";
             readonly mono: "'JetBrains Mono', ui-monospace, 'SFMono-Regular', Menlo, Consolas, monospace";
         };
         readonly fontSize: {
@@ -659,7 +698,7 @@ declare const darkTheme: {
         readonly slow: "300ms ease";
     };
     readonly gradients: {
-        readonly avatar: "linear-gradient(135deg, #4F7FFF 0%, #4066E8 100%)";
+        readonly avatar: "linear-gradient(135deg, #19345F 0%, #00BCD0 100%)";
     };
 };
 /**
@@ -669,7 +708,12 @@ declare const darkTheme: {
 interface Theme {
     colors: {
         brand: typeof brandColors;
-        primary: typeof primaryColors;
+        primary: {
+            primary: string;
+            primaryDark: string;
+            primaryLight: string;
+            primaryLightHover: string;
+        };
         neutral: {
             basecolor: string;
             subtle: string;
@@ -691,7 +735,9 @@ interface Theme {
             error: string;
         };
         status: typeof statusColors;
-        accent: typeof accentColors;
+        accent: {
+            [K in keyof typeof accentColors]: string;
+        };
         team: typeof teamColors;
         travel: typeof travelColors;
         vendor: typeof vendorColors;
@@ -944,6 +990,10 @@ interface AlertProps {
     /** Additional CSS class */
     className?: string;
 }
+/**
+ * Inline message calling out status or guidance in place, without interrupting the user.
+ * Use a modal instead when the user has to act before continuing.
+ */
 declare const Alert: React__default.FC<AlertProps>;
 
 type AlertVariant = 'primary' | 'success' | 'warning' | 'error';
@@ -1007,6 +1057,10 @@ interface AvatarGroupProps extends HTMLAttributes<HTMLDivElement> {
     /** Maximum number of avatars to show before +N */
     max?: number;
 }
+/**
+ * Row of overlapping avatars for a team or traveler party.
+ * Collapses everything past `max` into a +N counter so the row keeps a fixed footprint.
+ */
 declare const AvatarGroup: React__default.FC<AvatarGroupProps>;
 
 type BadgeVariant = 'default' | 'success' | 'warning' | 'error' | 'info';
@@ -1128,61 +1182,124 @@ interface DatepickerProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 't
  */
 declare const Datepicker: React.ForwardRefExoticComponent<DatepickerProps & React.RefAttributes<HTMLInputElement>>;
 
+/**
+ * The library's icon set.
+ *
+ * Every icon is a 24x24 stroked SVG that inherits its color from
+ * `currentColor` and scales through the `size` prop, so an icon picks up the
+ * text color of whatever it sits in without extra styling.
+ */
+
 interface IconProps extends SVGProps<SVGSVGElement> {
     /** Icon size in pixels */
     size?: number;
     /** Icon color (defaults to currentColor) */
     color?: string;
 }
+/** Air segment (travel type `A`). */
 declare const PlaneIcon: React__default.FC<IconProps>;
+/** Rental car segment (travel type `C`). */
 declare const CarIcon: React__default.FC<IconProps>;
+/** Hotel segment (travel type `H`). */
 declare const HotelIcon: React__default.FC<IconProps>;
+/** Limo or black car segment (travel type `L`). */
 declare const LimoIcon: React__default.FC<IconProps>;
+/** Rail segment (travel type `R`). */
 declare const RailIcon: React__default.FC<IconProps>;
+/** Motorcoach segment (travel type `B`), including team charters. */
 declare const BusIcon: React__default.FC<IconProps>;
+/** Magnifying glass, for search inputs and filter triggers. */
 declare const SearchIcon: React__default.FC<IconProps>;
+/** Downward chevron, for expanding a section or opening a dropdown. */
 declare const ChevronDownIcon: React__default.FC<IconProps>;
+/** Upward chevron, for collapsing an expanded section. */
 declare const ChevronUpIcon: React__default.FC<IconProps>;
+/** Rightward chevron, for drill-in navigation and breadcrumbs. */
 declare const ChevronRightIcon: React__default.FC<IconProps>;
+/** Leftward chevron, for back navigation and carousels. */
 declare const ChevronLeftIcon: React__default.FC<IconProps>;
+/** Outbound arrow, for departing legs and external links. */
 declare const ArrowUpRightIcon: React__default.FC<IconProps>;
+/** Inbound arrow, for returning legs. */
 declare const ArrowDownLeftIcon: React__default.FC<IconProps>;
+/** Eye, for view-only actions and visibility toggles. */
 declare const EyeIcon: React__default.FC<IconProps>;
+/** Download, for exporting reports and manifests. */
 declare const DownloadIcon: React__default.FC<IconProps>;
+/** Upload, for importing rosters and attaching files. */
 declare const UploadIcon: React__default.FC<IconProps>;
+/** Funnel, for opening filter controls. */
 declare const FilterIcon: React__default.FC<IconProps>;
+/** Calendar, for date pickers and schedule views. */
 declare const CalendarIcon: React__default.FC<IconProps>;
+/** Single person, for a traveler or profile. */
 declare const UserIcon: React__default.FC<IconProps>;
+/** Group of people, for teams, rosters, and group travel. */
 declare const UsersIcon: React__default.FC<IconProps>;
+/** Envelope, for email addresses and send actions. */
 declare const MailIcon: React__default.FC<IconProps>;
+/** Handset, for phone numbers. */
 declare const PhoneIcon: React__default.FC<IconProps>;
+/** Agent headset, for travel agent contact and support. */
 declare const HeadsetIcon: React__default.FC<IconProps>;
+/** Printer, for print actions. */
 declare const PrinterIcon: React__default.FC<IconProps>;
+/** Circular arrows, for reloading data and retrying a failed request. */
 declare const RefreshIcon: React__default.FC<IconProps>;
+/** Warning triangle, for warning and error states. */
 declare const WarningIcon: React__default.FC<IconProps>;
+/** Checkmark, for success states and confirmed selections. */
 declare const CheckIcon: React__default.FC<IconProps>;
+/** Cross, for clearing a value or marking a negative state. */
 declare const XIcon: React__default.FC<IconProps>;
+/** Plus, for add and create actions. */
 declare const PlusIcon: React__default.FC<IconProps>;
+/** Minus, for remove and decrement actions. */
 declare const MinusIcon: React__default.FC<IconProps>;
+/** Hamburger, for opening navigation on small screens. */
 declare const MenuIcon: React__default.FC<IconProps>;
+/** Lightbulb, for tips and informational callouts. */
 declare const LightbulbIcon: React__default.FC<IconProps>;
+/** Megaphone, for announcements and broadcast banners. */
 declare const MegaphoneIcon: React__default.FC<IconProps>;
+/** Close, for dismissing modals, drawers, and alerts. */
 declare const CloseIcon: React__default.FC<IconProps>;
+/** Dashboard, for the home and overview destinations. */
 declare const DashboardIcon: React__default.FC<IconProps>;
+/** Report, for reporting destinations and exports. */
 declare const ReportIcon: React__default.FC<IconProps>;
+/** Gear, for settings and configuration. */
 declare const SettingsIcon: React__default.FC<IconProps>;
+/** Short's Travel mark, for brand placements and app headers. */
 declare const LogoIcon: React__default.FC<IconProps>;
+/** Rising trend line, for a metric moving up. */
 declare const TrendUpIcon: React__default.FC<IconProps>;
+/** Falling trend line, for a metric moving down. */
 declare const TrendDownIcon: React__default.FC<IconProps>;
+/** Information, for help text and info banners. */
 declare const InfoIcon: React__default.FC<IconProps>;
+/** Document, for itineraries, invoices, and attachments. */
 declare const DocumentIcon: React__default.FC<IconProps>;
+/** Building, for schools, venues, and vendor offices. */
 declare const BuildingIcon: React__default.FC<IconProps>;
+/** Grid, for switching to a card or tile layout. */
 declare const GridIcon: React__default.FC<IconProps>;
+/** Pencil, for edit actions. */
 declare const EditIcon: React__default.FC<IconProps>;
+/** House, for the home destination. */
 declare const HomeIcon: React__default.FC<IconProps>;
+/** Cube, for packages, equipment, and bundled services. */
 declare const CubeIcon: React__default.FC<IconProps>;
+/** Padlock, for restricted access and locked records. */
 declare const LockIcon: React__default.FC<IconProps>;
+/** Trash can, for delete actions. */
 declare const TrashIcon: React__default.FC<IconProps>;
+/**
+ * Every icon keyed by name, for choosing one at runtime.
+ *
+ * Use a direct import when the icon is known at author time; reach for this
+ * only when the name arrives as data (a nav config, an API response).
+ */
 declare const Icons: {
     readonly Plane: React__default.FC<IconProps>;
     readonly Car: React__default.FC<IconProps>;
@@ -1267,6 +1384,9 @@ interface TextareaProps extends Omit<TextareaHTMLAttributes<HTMLTextAreaElement>
     /** Makes textarea take full width */
     fullWidth?: boolean;
 }
+/**
+ * Multi-line text field sharing the Input label, helper text, and error treatment.
+ */
 declare const Textarea: React__default.ForwardRefExoticComponent<TextareaProps & React__default.RefAttributes<HTMLTextAreaElement>>;
 
 interface MetricProps {
@@ -1341,6 +1461,10 @@ interface SpinnerProps {
     /** Accessible label */
     label?: string;
 }
+/**
+ * Indeterminate loading indicator for waits with no known duration.
+ * Exposes its label to screen readers, so give it one that says what is loading.
+ */
 declare const Spinner: React__default.FC<SpinnerProps>;
 
 type StatusBadgeVariant = 'ticketed' | 'itinerary' | 'not-ticketed' | 'submitted' | 'pending' | 'cancelled' | 'approved' | 'rejected' | 'in-review';
@@ -1350,6 +1474,10 @@ interface StatusBadgeProps extends Omit<HTMLAttributes<HTMLSpanElement>, 'childr
     /** Optional custom label (defaults to formatted status) */
     label?: string;
 }
+/**
+ * Badge for a travel record status, styled per status so the same state always reads the same.
+ * Falls back to a formatted version of the status code when no label is given.
+ */
 declare const StatusBadge: React__default.FC<StatusBadgeProps>;
 
 type TagVariant = 'default' | 'primary' | 'success' | 'warning' | 'error' | 'info'
@@ -1374,6 +1502,10 @@ interface TagProps {
     /** Inline styles */
     style?: React__default.CSSProperties;
 }
+/**
+ * Compact label for keywords, categories, and applied filters.
+ * Becomes a button when clickable, and can carry a remove affordance.
+ */
 declare const Tag: React__default.ForwardRefExoticComponent<TagProps & React__default.RefAttributes<HTMLSpanElement>>;
 
 type TimepickerSize = 'sm' | 'md' | 'lg';
@@ -1445,6 +1577,10 @@ interface ToggleProps {
      */
     disabledIcon?: ReactNode;
 }
+/**
+ * Switch for a setting that applies immediately, with no separate save step.
+ * Use a checkbox instead when the change is submitted with a form.
+ */
 declare const Toggle: React__default.FC<ToggleProps>;
 
 type TooltipPosition = 'top' | 'bottom' | 'left' | 'right';
@@ -1465,6 +1601,10 @@ interface TooltipProps {
     /** Additional CSS class */
     className?: string;
 }
+/**
+ * Hover and focus label for a control whose purpose is not obvious from its face.
+ * Supplementary only -- never put information here that a user must have.
+ */
 declare const Tooltip: React__default.FC<TooltipProps>;
 
 type TravelType = 'A' | 'C' | 'H' | 'L' | 'R' | 'B' | 'U';
@@ -1476,6 +1616,10 @@ interface TypeIconProps extends Omit<HTMLAttributes<HTMLSpanElement>, 'children'
     /** Show tooltip on hover */
     showTooltip?: boolean;
 }
+/**
+ * Segment icon keyed to a travel type code, color-coded per type.
+ * Use TravelServiceIcon when the vendor matters as well as the type.
+ */
 declare const TypeIcon: React__default.FC<TypeIconProps>;
 
 type VendorCode = 'DL' | 'AA' | 'UA' | 'WN' | 'B6' | 'AS' | 'F9' | 'NK' | 'G4' | 'HA' | string;
@@ -1491,6 +1635,10 @@ interface TravelServiceIconProps extends Omit<HTMLAttributes<HTMLSpanElement>, '
     /** Show multi-segment indicator */
     multi?: boolean;
 }
+/**
+ * Segment icon that identifies the vendor as well as the travel type.
+ * Shows the vendor mark when one is known, and can flag a multi-segment leg.
+ */
 declare const TravelServiceIcon: React__default.FC<TravelServiceIconProps>;
 
 interface AccordionProps {
@@ -1516,18 +1664,29 @@ interface AccordionProps {
 declare const Accordion: React__default.FC<AccordionProps>;
 
 interface SegmentedSelectorOption {
+    /** Value reported through `onChange` when this option is picked. */
     id: string;
+    /** Visible text. Omit for an icon-only option. */
     label?: string;
+    /** Accessible name, required when the option is icon-only. */
     alt?: string;
+    /** Icon element shown before the label. */
     icon?: ReactNode;
 }
 interface SegmentedSelectorProps {
+    /** Options to render, left to right. */
     options: SegmentedSelectorOption[];
+    /** Id of the currently selected option. */
     value: string;
+    /** Called with the newly selected option id. */
     onChange?: (value: string) => void;
+    /** Disables every option. */
     disabled?: boolean;
+    /** Control size. */
     size?: 'sm' | 'md' | 'lg';
+    /** Additional CSS class. */
     className?: string;
+    /** Accessible name for the group. */
     ariaLabel?: string;
     /** Stable hook used by Hub acceptance and Chromatic tests. */
     dataTest?: string;
@@ -1538,18 +1697,32 @@ interface SegmentedSelectorProps {
     /** Which side of the label an option's icon sits on. Defaults to left. */
     iconPosition?: 'left' | 'right';
 }
+/**
+ * Single-select control rendering its options as one connected row of buttons.
+ * Backs the calendar selectors below; use those when their options fit.
+ */
 declare const SegmentedSelector: ({ options, value, onChange, disabled, size, className, ariaLabel, dataTest, itemClassName, activeItemClassName, iconPosition, }: SegmentedSelectorProps) => React.JSX.Element;
 type CalendarViewValue = 'calendar' | 'card' | 'list';
 interface CalendarViewSelectorProps extends Omit<SegmentedSelectorProps, 'options' | 'value' | 'onChange' | 'ariaLabel'> {
+    /** Currently selected layout. */
     value: CalendarViewValue;
+    /** Called with the newly selected layout. */
     onChange?: (value: CalendarViewValue) => void;
 }
+/**
+ * Chooses how the team travel calendar lays out: calendar grid, cards, or list.
+ */
 declare const CalendarViewSelector: ({ value, onChange, ...props }: CalendarViewSelectorProps) => React.JSX.Element;
 type CalendarTypeValue = 'trips' | 'due_dates';
 interface CalendarTypeSelectorProps extends Omit<SegmentedSelectorProps, 'options' | 'value' | 'onChange' | 'ariaLabel'> {
+    /** Currently selected item type. */
     value: CalendarTypeValue;
+    /** Called with the newly selected item type. */
     onChange?: (value: CalendarTypeValue) => void;
 }
+/**
+ * Chooses what the team travel calendar plots -- trips or due dates.
+ */
 declare const CalendarTypeSelector: ({ value, onChange, ...props }: CalendarTypeSelectorProps) => React.JSX.Element;
 
 interface ContactCardProps {
@@ -1650,6 +1823,10 @@ interface DropdownItemProps {
     /** Additional CSS class */
     className?: string;
 }
+/**
+ * Button that reveals a menu of actions, closing on outside click or Escape.
+ * Compose the menu from DropdownItem; for choosing a value, use Segment or FilterChip instead.
+ */
 declare const Dropdown: React__default.FC<DropdownProps> & {
     Item: React__default.FC<DropdownItemProps>;
 };
@@ -1785,6 +1962,10 @@ interface FilterChipProps {
     /** Additional CSS class */
     className?: string;
 }
+/**
+ * Compact single-select filter showing its current value on the chip itself.
+ * Can filter its own options when the list is long enough to need searching.
+ */
 declare const FilterChip: React__default.FC<FilterChipProps>;
 
 interface FormFieldProps {
@@ -1809,6 +1990,11 @@ interface FormFieldProps {
     /** Children for custom input rendering */
     children?: React__default.ReactNode;
 }
+/**
+ * Pairs a labelled control with its helper text and error message, wiring up the
+ * accessible associations between them.
+ * Renders an Input or Textarea via `as`, or any control passed as children.
+ */
 declare const FormField: React__default.ForwardRefExoticComponent<FormFieldProps & React__default.RefAttributes<HTMLInputElement | HTMLTextAreaElement>>;
 
 interface FormRowProps {
@@ -1852,8 +2038,11 @@ interface FormSectionProps {
 declare const FormSection: React__default.FC<FormSectionProps>;
 
 interface FormStackProps {
+    /** Form fields to space evenly. */
     children: ReactNode;
+    /** Vertical space between fields. */
     gap?: 'sm' | 'md' | 'lg';
+    /** Additional CSS class. */
     className?: string;
 }
 /** Standard vertical form-field rhythm used by Hub modal forms. */
@@ -1894,13 +2083,23 @@ declare const InfoTile: React__default.FC<InfoTileProps>;
 
 type ManifestView = 'passengers' | 'equipment';
 interface ManifestViewToggleProps {
+    /** Manifest currently shown. */
     view: ManifestView;
+    /** Called with the manifest the user switched to. */
     onView: (view: ManifestView) => void;
+    /** Passenger count shown on the passengers tab. */
     paxCount: number;
+    /** Equipment count shown on the equipment tab. */
     eqCount: number;
+    /** Marks the manifest as locked, swapping both tab icons for a padlock. Presentational only -- it does not stop the switch. */
     locked: boolean;
+    /** Additional CSS class. */
     className?: string;
 }
+/**
+ * Tabs switching a charter manifest between its passenger and equipment lists,
+ * each showing its current count.
+ */
 declare const ManifestViewToggle: ({ view, onView, paxCount, eqCount, locked, className, }: ManifestViewToggleProps) => React.JSX.Element;
 
 /** A user option that can be searched for and selected. */
@@ -1993,6 +2192,11 @@ interface NavItemProps {
     /** Accessible description */
     'aria-label'?: string;
 }
+/**
+ * One destination in a navigation list, with an optional icon and badge.
+ * Renders as a link when given `href`, otherwise as a button.
+ * Collapses to icon-only, keeping its label available to screen readers.
+ */
 declare const NavItem: React__default.FC<NavItemProps>;
 
 interface PageHeaderProps {
@@ -2091,8 +2295,18 @@ interface ProgressCircleProps {
      */
     diameter?: number;
 }
+/**
+ * Horizontal bar for determinate progress -- a known percentage of a known total.
+ * Use Spinner when the duration is unknown.
+ */
 declare const ProgressBar: React__default.FC<ProgressBarProps>;
+/**
+ * Ring showing determinate progress, for tighter spaces than ProgressBar fits.
+ */
 declare const ProgressCircle: React__default.FC<ProgressCircleProps>;
+/**
+ * Namespace bundling the progress indicators as `Progress.Bar` and `Progress.Circle`.
+ */
 declare const Progress: {
     Bar: React__default.FC<ProgressBarProps>;
     Circle: React__default.FC<ProgressCircleProps>;
@@ -2169,17 +2383,31 @@ interface SearchFieldProps {
     /** Accessible label */
     'aria-label'?: string;
 }
+/**
+ * Search input with clear and submit affordances.
+ * Works controlled via `value` or uncontrolled via `defaultValue`; `onChange` fires
+ * per keystroke while `onSearch` fires only on submit.
+ */
 declare const SearchField: React__default.ForwardRefExoticComponent<SearchFieldProps & React__default.RefAttributes<HTMLInputElement>>;
 
 interface SchoolContactFormProps {
+    /** Whether the form is adding or editing, used for the heading. */
     mode?: 'Add' | 'Edit' | string;
+    /** Optional control for prefilling the form from an existing portal user. */
     createFromPortalUser?: ReactNode;
+    /** Rendered first name field. */
     firstNameField: ReactNode;
+    /** Rendered middle initial field. */
     middleInitialField: ReactNode;
+    /** Rendered last name field. */
     lastNameField: ReactNode;
+    /** Rendered business phone field. */
     businessPhoneField: ReactNode;
+    /** Rendered cell phone field. */
     cellPhoneField: ReactNode;
+    /** Rendered email field. */
     emailField: ReactNode;
+    /** Additional CSS class. */
     className?: string;
 }
 /**
@@ -2214,6 +2442,10 @@ interface SegmentProps {
     /** Accessible label */
     'aria-label'?: string;
 }
+/**
+ * Segmented control for picking one of a few options that are all worth showing.
+ * Prefer a Dropdown once the list outgrows the available width.
+ */
 declare const Segment: React__default.FC<SegmentProps>;
 
 interface SelectFilterOption {
@@ -2306,17 +2538,29 @@ declare const ServiceToggle: React__default.FC<ServiceToggleProps>;
 declare const ServiceToggleList: React__default.FC<ServiceToggleListProps>;
 
 type SupplierTypeValue = 'A' | 'C' | 'H';
+/**
+ * The selectable supplier types, without the "All" entry the toggle adds.
+ */
 declare const SUPPLIER_TYPE_OPTIONS: Array<{
     value: SupplierTypeValue;
     label: string;
 }>;
 interface SupplierTypeToggleProps {
+    /** Selected supplier type, or `''` for all. Makes the toggle controlled. */
     value?: SupplierTypeValue | '';
+    /** Initial selection when uncontrolled. */
     defaultValue?: SupplierTypeValue | '';
+    /** Called with the newly selected supplier type, or `''` for all. */
     onChange?: (value: SupplierTypeValue | '') => void;
+    /** Disables every option. */
     disabled?: boolean;
+    /** Additional CSS class. */
     className?: string;
 }
+/**
+ * Filters a supplier list down to air, car, or hotel.
+ * Works controlled via `value` or uncontrolled via `defaultValue`.
+ */
 declare const SupplierTypeToggle: ({ value, defaultValue, onChange, disabled, className, }: SupplierTypeToggleProps) => React.JSX.Element;
 
 interface TeamCalendarHeaderProps {
@@ -2364,13 +2608,19 @@ declare const TeamHeader: {
     displayName: string;
 };
 interface TeamSubMenuTab {
+    /** Value reported through `onTabChange` when this tab is picked. */
     id: string;
+    /** Visible tab text. */
     label: string;
 }
 interface TeamSubMenuProps {
+    /** Tabs to render. Defaults to the standard team management set. */
     tabs?: TeamSubMenuTab[];
+    /** Id of the currently selected tab. */
     activeTab?: string;
+    /** Called with the newly selected tab id. */
     onTabChange?: (tabId: string) => void;
+    /** Additional CSS class. */
     className?: string;
 }
 /** Router-agnostic counterpart of Hub's team-management submenu. */
@@ -2380,32 +2630,55 @@ declare const TeamSubMenu: {
 };
 
 interface FlightData {
+    /** Whether the leg is a commercial booking or a charter. */
     type: 'commercial' | 'charter';
+    /** Departure airport code. */
     departure: string;
+    /** Arrival airport code. */
     arrival: string;
+    /** Departure date. */
     departureDate: string;
+    /** Departure time, local to the departure airport. */
     departureTime?: string;
+    /** Arrival date, when it differs from the departure date. */
     arrivalDate?: string;
+    /** Arrival time, local to the arrival airport. */
     arrivalTime?: string;
+    /** Operating carrier name. */
     airline?: string;
+    /** Flight number. */
     flightNumber?: string;
 }
 interface GroundData {
+    /** Vehicle class for the leg. */
     type: 'bus' | 'van' | 'car' | 'limo';
+    /** Ground operator name. */
     company?: string;
+    /** Where the vehicle collects the party. */
     pickupLocation: string;
+    /** Where the vehicle drops the party. */
     dropoffLocation: string;
+    /** Pickup date. */
     pickupDate: string;
+    /** Pickup time, local to the pickup location. */
     pickupTime?: string;
+    /** Number of vehicles on the leg. */
     vehicleCount?: number;
 }
 interface HotelData {
+    /** Property name. */
     name: string;
+    /** Street address. */
     address?: string;
+    /** City, shown when the address is omitted. */
     city?: string;
+    /** Check-in date. */
     checkIn: string;
+    /** Check-out date. */
     checkOut: string;
+    /** Number of rooms held. */
     roomCount?: number;
+    /** Hotel confirmation number. */
     confirmationNumber?: string;
 }
 type SegmentVariant = 'light' | 'dark';
@@ -2420,18 +2693,27 @@ interface TripSegmentProps {
     children: ReactNode;
 }
 interface AirSegmentProps {
+    /** Flights on this segment, in travel order. */
     flights: FlightData[];
+    /** Visual variant. */
     variant?: SegmentVariant;
+    /** Additional CSS class. */
     className?: string;
 }
 interface GroundSegmentProps {
+    /** Ground legs on this segment, in travel order. */
     segments: GroundData[];
+    /** Visual variant. */
     variant?: SegmentVariant;
+    /** Additional CSS class. */
     className?: string;
 }
 interface HotelSegmentProps {
+    /** Hotel stays on this segment, in travel order. */
     hotels: HotelData[];
+    /** Visual variant. */
     variant?: SegmentVariant;
+    /** Additional CSS class. */
     className?: string;
 }
 /**
@@ -2603,70 +2885,102 @@ interface GroupTravelDueStatus {
     complete: boolean;
 }
 interface GroupTravelPnr {
+    /** Identifier for the PNR. */
     id: string | number;
     /** Airline record locator, or the placeholder used before one has been issued. */
     recordLocator: string;
     complete: boolean;
 }
 interface AgentGroupTravelRequest {
+    /** Identifier for the PNR. */
     id: number;
     /** School/account this request belongs to — rows are grouped by this value. */
     accountName: string;
     /** Whether an agent or the client themselves submitted the request. */
     source: GroupTravelRequestSource;
+    /** Master trip this request became, once one exists. */
     masterTripId?: number;
     /** Shown as a tooltip and highlights the ID when present. */
     notes?: string;
     /** ISO (yyyy-mm-dd) trip start date. */
     startDate: string;
+    /** Trip name. */
     name: string;
+    /** Sport name shown in the row. */
     sport: string;
     /** Sport code used for the sport filter, e.g. "MBB". */
     sportCode: string;
+    /** Airline handling the group, once assigned. */
     carrier?: string;
+    /** Whether commercial air is part of the request. */
     air: boolean;
+    /** Whether a charter is part of the request. */
     charter: boolean;
+    /** Whether rental cars are part of the request. */
     car: boolean;
+    /** Whether a motorcoach is part of the request. */
     motorcoach: boolean;
+    /** Whether hotel rooms are part of the request. */
     hotel: boolean;
+    /** Whether the hotel is booked as a group block. */
     groupHotel: boolean;
+    /** Routing summary for the trip. */
     routing: string;
     /** ISO (yyyy-mm-dd) date submitted. */
     submittedDate?: string;
     /** ISO (yyyy-mm-dd) date the quote was sent. */
     quoteSentDate?: string;
+    /** Due status for confirming the booking. */
     confirmation: GroupTravelDueStatus;
+    /** Due status for the deposit. */
     deposit: GroupTravelDueStatus;
+    /** Due status for the utilization review. */
     utilization: GroupTravelDueStatus;
+    /** Due status for submitting traveler names. */
     names: GroupTravelDueStatus;
+    /** Due status for ticketing. */
     ticketing: GroupTravelDueStatus;
     /** One entry per PNR in this group; more than one renders as an expandable "Multi" group. */
     pnrs: GroupTravelPnr[];
 }
 interface AgentGroupTravelRequestSportOption {
+    /** Sport code matched against a request. */
     code: string;
+    /** Visible sport name. */
     label: string;
 }
 interface AgentGroupTravelRequestViewOption {
+    /** Identifier for the saved view. */
     id: string;
+    /** Visible view name. */
     label: string;
     /** Account names included in this saved view. */
     accountNames: string[];
 }
 interface AgentGroupTravelRequestsTableProps {
+    /** Requests to list. Rows are grouped by account. */
     requests: AgentGroupTravelRequest[];
+    /** Sports offered in the sport filter. */
     sports?: AgentGroupTravelRequestSportOption[];
     /** Saved account-group "views"; the view filter is hidden when none are supplied. */
     views?: AgentGroupTravelRequestViewOption[];
     /** ISO (yyyy-mm-dd) reference date for due-status coloring. Defaults to today; pass a fixed value in stories/tests for determinism. */
     today?: string;
+    /** Called with the request the agent opened. */
     onOpenRequest?: (id: number) => void;
+    /** Called with the master trip the agent opened. */
     onViewMasterTrip?: (masterTripId: number) => void;
+    /** Called with the request the agent deleted. */
     onDeleteRequest?: (id: number) => void;
+    /** Called with the record locator the agent copied. */
     onCopyPnr?: (recordLocator: string) => void;
+    /** Called with the request and the milestone the agent marked complete or incomplete. */
     onToggleDueStatus?: (id: number, field: GroupTravelDueField) => void;
+    /** Called with the request and its new submitted date. */
     onSubmittedDateChange?: (id: number, value: string) => void;
+    /** Called with the request and its new quote-sent date. */
     onQuoteSentDateChange?: (id: number, value: string) => void;
+    /** Additional CSS class. */
     className?: string;
 }
 /** Computes the short "A/C/B/H/GH/CA" travel-type codes shown in the Type column. */
@@ -2760,6 +3074,10 @@ interface AppLayoutProps {
     /** Additional CSS class */
     className?: string;
 }
+/**
+ * Generic page frame: sidebar, top bar, and content area.
+ * Use HubAppShell for Hub screens -- it adds the Hub navigation and branding.
+ */
 declare const AppLayout: React__default.FC<AppLayoutProps>;
 
 type CardVariant = 'default' | 'bordered' | 'elevated';
@@ -2784,30 +3102,49 @@ interface CardHeaderProps extends HTMLAttributes<HTMLDivElement> {
     /** Actions to display in the header */
     actions?: React__default.ReactNode;
 }
+/**
+ * Top of a Card: title, subtitle, and any header actions.
+ */
 declare const CardHeader: React__default.FC<CardHeaderProps>;
 interface CardBodyProps extends HTMLAttributes<HTMLDivElement> {
 }
+/**
+ * Main content region of a Card, carrying the card padding.
+ */
 declare const CardBody: React__default.FC<CardBodyProps>;
 interface CardFooterProps extends HTMLAttributes<HTMLDivElement> {
 }
+/**
+ * Bottom of a Card, for actions and summary detail.
+ */
 declare const CardFooter: React__default.FC<CardFooterProps>;
 
 /** The three notifications the Charter Sourcing backend currently sends. */
 type CharterSourcingEmailVariant = 'admin-review' | 'submitter-approved' | 'submitter-updated';
 /** One origin/destination pair included in the email's route summary. */
 interface CharterSourcingEmailLeg {
+    /** Departure airport code. */
     origin: string;
+    /** Arrival airport code. */
     destination: string;
 }
 /** Contract-backed quote facts shared by all three notifications. */
 interface CharterSourcingEmailQuote {
+    /** Sourcing request the quote answers. */
     requestId: string;
+    /** Operator quoting the charter. */
     carrier: string;
+    /** Aircraft type offered. */
     aircraft: string;
+    /** Passenger count the quote covers. */
     passengers: string | number;
+    /** Legs in the quoted routing, in travel order. */
     legs: readonly CharterSourcingEmailLeg[];
+    /** Outbound travel date. */
     outboundDate: string;
+    /** Return travel date. */
     returnDate: string;
+    /** Who submitted the quote. */
     submittedBy: string;
     /**
      * Preformatted amount without an assumed currency symbol. The backend only
@@ -2817,8 +3154,11 @@ interface CharterSourcingEmailQuote {
 }
 /** One scalar value changed by an administrator. */
 interface CharterSourcingEmailChange {
+    /** Field that changed. */
     label: string;
+    /** Value before the change. */
     previousValue: string;
+    /** Value after the change. */
     updatedValue: string;
 }
 /** Hub only sends an update notification when at least one field changed. */
@@ -2827,20 +3167,26 @@ type CharterSourcingEmailChanges = readonly [
     ...CharterSourcingEmailChange[]
 ];
 interface CharterSourcingEmailPreviewBaseProps {
+    /** Quote the email is about. */
     quote: CharterSourcingEmailQuote;
     /**
      * Original production recipient shown when a non-production environment
      * diverts the message to its configured test inbox.
      */
     testServerOriginalRecipient?: string;
+    /** Additional CSS class. */
     className?: string;
 }
 /** Props mirror the three real sends; an update must contain at least one change. */
 type CharterSourcingEmailPreviewProps = CharterSourcingEmailPreviewBaseProps & ({
+    /** Which of the three sends to preview. */
     variant: 'admin-review' | 'submitter-approved';
+    /** Not carried by these sends -- only an update lists changes. */
     changes?: never;
 } | {
+    /** Which of the three sends to preview. */
     variant: 'submitter-updated';
+    /** What changed since the last send. An update must list at least one. */
     changes: CharterSourcingEmailChanges;
 });
 /** The exact comma-separated route label used by the backend subject and body. */
@@ -2956,9 +3302,22 @@ interface DrawerFooterProps {
     /** Additional CSS class */
     className?: string;
 }
+/**
+ * Top of a Drawer: title and the close affordance.
+ */
 declare const DrawerHeader: React__default.FC<DrawerHeaderProps>;
+/**
+ * Scrollable content region of a Drawer.
+ */
 declare const DrawerBody: React__default.FC<DrawerBodyProps>;
+/**
+ * Bottom of a Drawer, for actions that stay visible while the body scrolls.
+ */
 declare const DrawerFooter: React__default.FC<DrawerFooterProps>;
+/**
+ * Panel sliding in from an edge for secondary work that keeps the page behind it
+ * in context. Traps focus while open and closes on Escape or backdrop click.
+ */
 declare const Drawer: React__default.FC<DrawerProps> & {
     Header: typeof DrawerHeader;
     Body: typeof DrawerBody;
@@ -2966,26 +3325,42 @@ declare const Drawer: React__default.FC<DrawerProps> & {
 };
 
 interface TravelDueDateItem {
+    /** Date the task is due. */
     duedate: string;
+    /** When the task was completed. Empty while it is outstanding. */
     completeddatetime: string;
+    /** Short task name. */
     tasktitle: string;
+    /** Identifier for the task. */
     taskid: number;
+    /** Workflow status text as the source system reports it. */
     status: string;
+    /** Who completed the task. */
     completedby: string;
+    /** Longer explanation of what the task requires. */
     description: string;
+    /** Travel service the task belongs to (air, ground, hotel). */
     servicetype?: string;
+    /** Sport the task belongs to. */
     sportCode: string;
+    /** Trip the task belongs to. */
     tripId: string;
+    /** Name of that trip, for display without a second lookup. */
     tripName: string;
+    /** Master trip the task rolls up to, used to open the trip from a task. */
     masterTripGUID?: string;
     /** Set by the API when the due date has passed; used by `overdueOnly`. */
     pastdue?: boolean;
 }
 type GroupedTravelDueDates = Record<string, TravelDueDateItem[]>;
 interface DueDatesDrawerProps {
+    /** Whether the drawer is open. */
     isOpen: boolean;
+    /** Tasks to show, already grouped by date. */
     dueDates: GroupedTravelDueDates;
+    /** Date to focus when opening from a calendar day. */
     selectedDate?: string | null;
+    /** Trip to focus when opening from a trip. */
     selectedTrip?: string | null;
     /**
      * NG-702/NG-811: opened via the Overdue Actions card — only past-due,
@@ -2993,11 +3368,20 @@ interface DueDatesDrawerProps {
      * rather than showing every due date.
      */
     overdueOnly?: boolean;
+    /** Called when the user dismisses the drawer. */
     onClose: () => void;
+    /** Called with the task the user marked complete or incomplete. */
     onToggle?: (item: TravelDueDateItem) => void;
+    /** Called with the master trip of the task the user opened. */
     onTaskClick?: (masterTripGUID: string) => void;
+    /** Additional CSS class. */
     className?: string;
 }
+/**
+ * Whether a task counts as done.
+ * Treats a completion timestamp as authoritative, since the source systems do not
+ * always write the status text back.
+ */
 declare const isTravelDueDateCompleted: (item: Pick<TravelDueDateItem, "status" | "completeddatetime">) => boolean;
 declare const isTravelDueDateOverdue: (item: Pick<TravelDueDateItem, "completeddatetime" | "pastdue">) => boolean;
 /** Hub's searchable, status-aware due-dates drawer. */
@@ -3093,16 +3477,32 @@ declare namespace GridTable {
 }
 
 interface HubNavigationItem {
+    /** Stable id, matched against `activeNavKey` to mark the current destination. */
     key: string;
+    /** Visible text for the entry. */
     label: string;
+    /** Route the entry points at. The shell reports it back rather than navigating itself. */
     path: string;
+    /** Icon shown beside the label, and alone when the rail is collapsed. */
     icon: ReactNode;
 }
+/**
+ * Individual Travel entry, kept separate because not every account has it.
+ */
 declare const HUB_INDIVIDUAL_TRAVEL_ITEM: HubNavigationItem;
 /** Canonical navigation identity for the carrier-facing STM Charters portal. */
 declare const HUB_STM_CHARTERS_ITEM: HubNavigationItem;
+/**
+ * The default primary navigation, in display order.
+ */
 declare const HUB_NAV_ITEMS: HubNavigationItem[];
+/**
+ * Administration entry, shown in the footer to admins.
+ */
 declare const HUB_ADMIN_ITEM: HubNavigationItem;
+/**
+ * Agent workspace entry, shown in the footer to admins.
+ */
 declare const HUB_AGENTS_ITEM: HubNavigationItem;
 /**
  * Sourcing sits with the admin-gated footer items rather than in `HUB_NAV_ITEMS`: the
@@ -3112,46 +3512,70 @@ declare const HUB_SOURCING_ITEM: HubNavigationItem;
 /** Off-fleet quote review is an admin surface too, so it is gated the same way. */
 declare const HUB_OFF_FLEET_ITEM: HubNavigationItem;
 interface HubAppShellActions {
+    /** Whether the mobile navigation drawer is currently open. */
     isMobileNavOpen: boolean;
+    /** Opens or closes the mobile navigation drawer. */
     toggleMobileNav: () => void;
 }
 interface HubAppShellProps {
+    /** Page content rendered inside the shell. */
     children: ReactNode;
+    /** Primary navigation entries. Defaults to the standard Hub set. */
     navItems?: HubNavigationItem[];
     /** Set to `null` when Individual Travel is not available to the current user or account. */
     individualTravelItem?: HubNavigationItem | null;
+    /** Agent workspace entry, rendered in the footer and gated on `isAdmin`. */
     agentsItem?: HubNavigationItem;
     /** ACMI sourcing entry, rendered in the footer and shown only when `isAdmin` is true. */
     sourcingItem?: HubNavigationItem;
     /** Off-fleet quote review entry, rendered in the footer and gated on `isAdmin`. */
     offFleetItem?: HubNavigationItem;
+    /** Administration entry, rendered in the footer and gated on `isAdmin`. */
     adminItem?: HubNavigationItem;
     /**
      * Authoritative footer navigation. When provided (including an empty array),
      * it replaces the default admin-gated Sourcing, Off-Fleet, Agents, and Administration items.
      */
     footerNavItems?: HubNavigationItem[];
+    /** Key of the entry to mark as current. */
     activeNavKey?: string;
+    /** Called with the entry the user picked. The host performs the routing. */
     onNavigate?: (item: HubNavigationItem) => void;
+    /** Called when the user activates the logo. */
     onLogoClick?: () => void;
+    /** Called when the user chooses to hand off to the legacy portal. */
     onLegacyPortal?: () => void;
+    /** Account switcher rendered in the top bar. */
     accountSelector?: ReactNode;
+    /** Renders top bar actions, given the shell state so they can drive the mobile nav. */
     renderTopbarActions?: (actions: HubAppShellActions) => ReactNode;
+    /** Renders extra content inside the mobile drawer, given a callback that closes it. */
     renderMobileExtras?: (close: () => void) => ReactNode;
+    /** Content pinned to the bottom of the mobile drawer. */
     mobileFooter?: ReactNode;
+    /** Profile menu rendered in the top bar. */
     profileMenu?: ReactNode;
+    /** Initials shown in the top bar when no profile menu is supplied. */
     userInitials?: string;
+    /** Whether the current user sees the admin-gated footer entries. */
     isAdmin?: boolean;
+    /** Renders navigation as non-interactive, for loading and restricted states. */
     navigationDisabled?: boolean;
+    /** Shows the shell in its loading state. */
     loading?: boolean;
+    /** Renders the content area as non-interactive while an operation blocks it. */
     contentDisabled?: boolean;
+    /** Whether to render children at all. Set false to hold the frame while content resolves. */
     showContent?: boolean;
-    /** Logo for expanded sidebar state */
+    /** Overrides the default brand mark, shown while the side rail is expanded. */
     logo?: ReactNode;
-    /** Logo for collapsed sidebar state (icon only, no text) */
+    /** Overrides the brand mark shown while the side rail is collapsed, where only an icon fits. */
     collapsedLogo?: ReactNode;
+    /** Whether the side rail starts expanded. */
     defaultExpanded?: boolean;
+    /** Beta tag shown beside the brand mark. */
     betaLabel?: string;
+    /** Additional CSS class. */
     className?: string;
 }
 /** The shared application navigation and content shell used by Hub and its Storybook pages. */
@@ -3421,11 +3845,17 @@ declare const MembershipPrograms: {
 };
 
 interface ManifestCapacityStatsProps {
+    /** Passengers currently manifested. */
     paxCount: number;
+    /** Seats available on the aircraft. */
     seats: number;
+    /** Total passenger weight, in pounds. */
     paxWeight: number;
+    /** Total cargo and equipment weight, in pounds. */
     cargoWeight: number;
+    /** Maximum payload the aircraft can carry, in pounds. */
     payloadLimit: number;
+    /** Additional CSS class. */
     className?: string;
 }
 /** Advisory seat and payload meters from Hub's charter manifest. */
@@ -3454,11 +3884,21 @@ interface ModalProps {
     /** Additional CSS class */
     className?: string;
 }
+/**
+ * Dialog that interrupts the page until the user resolves it.
+ * Traps focus, closes on Escape, and restores focus to the trigger on close.
+ * Use an Alert instead when the user does not have to act.
+ */
 declare const Modal: React__default.FC<ModalProps>;
 interface ModalFooterProps {
+    /** Footer content, usually the confirm and cancel actions. */
     children: React__default.ReactNode;
+    /** Additional CSS class. */
     className?: string;
 }
+/**
+ * Action row for the bottom of a Modal, keeping button order consistent across dialogs.
+ */
 declare const ModalFooter: React__default.FC<ModalFooterProps>;
 interface ConfirmModalProps extends Omit<ModalProps, 'footer' | 'children'> {
     /** Message to display */
@@ -3474,6 +3914,10 @@ interface ConfirmModalProps extends Omit<ModalProps, 'footer' | 'children'> {
     /** Whether confirm action is in progress */
     loading?: boolean;
 }
+/**
+ * Modal preset for confirming a single action, with the confirm and cancel
+ * buttons already wired.
+ */
 declare const ConfirmModal: React__default.FC<ConfirmModalProps>;
 
 type ModuleSize = 'sm' | 'md' | 'lg';
@@ -3534,21 +3978,34 @@ declare const ModuleVerticalDivider: React__default.FC<{
 }>;
 
 interface SystemBanner {
+    /** Identifier for the banner, used to key and dismiss it. */
     id: string;
+    /** Banner body as trusted HTML from the announcements system. */
     html: string;
+    /** Expanded detail revealed when the reader opens the banner. */
     detailHtml?: string;
 }
 interface TravelAlertBanner {
+    /** Identifier for the alert. */
     id: string;
+    /** Headline summarizing the disruption. */
     title: string;
+    /** Supporting detail. */
     body?: string;
+    /** Link to the full advisory. */
     href?: string;
 }
 interface PageBannersProps {
+    /** Platform-wide notices such as maintenance windows. */
     systemBanners: SystemBanner[];
+    /** Travel alerts affecting trips, such as weather or carrier disruption. */
     alertBanners: TravelAlertBanner[];
+    /** Additional CSS class. */
     className?: string;
 }
+/**
+ * Stacked notices for the top of a page: platform notices first, then travel alerts.
+ */
 declare const PageBanners: ({ systemBanners, alertBanners, className, }: PageBannersProps) => React.JSX.Element | null;
 
 interface PreferenceField {
@@ -4098,6 +4555,9 @@ interface TableProps<T = any> {
     /** Additional CSS class */
     className?: string;
 }
+/**
+ * Data table with sorting, selection, and empty and loading states.
+ */
 declare const Table: <T extends Record<string, any> = any>({ columns, data, rowKey, bordered, striped, hoverable, compact, loading, emptyMessage, emptyContent, selectable, selectedRowKeys, defaultSelectedRowKeys, onSelectionChange, isRowSelectable, rowSelectionLabel, selectAllLabel, onRowClick, className, }: TableProps<T>) => React__default.JSX.Element;
 
 interface TeamOption {
@@ -4132,61 +4592,106 @@ declare const TeamCard: {
 
 type TeamContactId = string | number;
 interface TeamContactOption {
+    /** Identifier reported back through the selected contact ids. */
     id: TeamContactId;
+    /** Contact name shown in the picker. */
     name: string;
+    /** Role at the school, shown beside the name. */
     title?: string;
+    /** Contact email address. */
     email?: string;
+    /** Contact phone number. */
     phone?: string;
+    /** Whether the contact is still active. Inactive contacts stay selectable so existing assignments survive. */
     active?: boolean;
 }
 interface TeamContactsValue {
+    /** Contact who owns the trip. */
     primaryContactId?: TeamContactId;
+    /** Backup contact. */
     secondaryContactId?: TeamContactId;
+    /** Contacts copied on correspondence. Holes are kept so empty rows stay in place while editing. */
     ccContactIds?: Array<TeamContactId | undefined>;
 }
 interface TeamContactsLoadingState {
+    /** Whether the primary contact is being saved. */
     primary?: boolean;
+    /** Whether the secondary contact is being saved. */
     secondary?: boolean;
+    /** Per-row save state for the copied contacts, positionally matched to `ccContactIds`. */
     cc?: boolean[];
 }
 interface TeamContactsPanelProps {
+    /** Contacts available to assign. */
     contacts: TeamContactOption[];
+    /** Currently assigned contacts. */
     value: TeamContactsValue;
+    /** Called with the full assignment after any change. */
     onChange?: (value: TeamContactsValue) => void;
+    /** Disables every picker. */
     disabled?: boolean;
+    /** Per-slot save state, for showing progress on the row being written. */
     loading?: TeamContactsLoadingState;
+    /** Stable hook for acceptance and visual tests. */
     dataTestId?: string;
+    /** Additional CSS class. */
     className?: string;
 }
+/**
+ * Assigns a team's primary, secondary, and copied travel contacts.
+ * Each slot saves independently, so `loading` is per slot rather than per panel.
+ */
 declare const TeamContactsPanel: {
     ({ contacts, value, onChange, disabled, loading, dataTestId, className, }: TeamContactsPanelProps): React.JSX.Element;
     displayName: string;
 };
 
 interface SeasonOption {
+    /** Value reported through `onSeasonChange` when this season is picked. */
     value: string;
+    /** Visible season text. */
     label: string;
 }
 interface TeamScheduleActionsProps {
+    /** Whether the schedule is currently in its compact layout. */
     isCompactView: boolean;
+    /** Number of trips in the current season, shown in the summary. */
     tripCount: number;
+    /** Label for the season currently shown. */
     seasonLabel: string;
+    /** Value of the selected season, when a season picker is offered. */
     seasonValue?: string;
+    /** Seasons available to pick from. Omit to show only the stepper arrows. */
     seasonOptions?: SeasonOption[];
+    /** Disables stepping back, at the earliest season on record. */
     previousSeasonDisabled?: boolean;
+    /** Disables export, when there is nothing to export. */
     exportDisabled?: boolean;
+    /** Shows export as in progress. */
     exporting?: boolean;
+    /** Disables raising a group travel request. */
     groupTravelDisabled?: boolean;
+    /** Disables merging events. */
     mergeDisabled?: boolean;
+    /** Shows the merge as in progress. */
     merging?: boolean;
+    /** Called when the user switches between compact and full schedule layouts. */
     onViewSchedule?: () => void;
+    /** Called when the user leaves the schedule. */
     onBack?: () => void;
+    /** Called when the user steps to the previous season. */
     onPreviousSeason?: () => void;
+    /** Called when the user steps to the next season. */
     onNextSeason?: () => void;
+    /** Called with the season the user picked. */
     onSeasonChange?: (value: string) => void;
+    /** Called when the user exports the schedule. */
     onExport?: () => void;
+    /** Called when the user raises a group travel request. */
     onGroupTravelRequest?: () => void;
+    /** Called when the user merges duplicate events. */
     onMergeEvents?: () => void;
+    /** Additional CSS class. */
     className?: string;
 }
 /** Exact presentational counterpart of Hub's Team Schedule action controls. */
@@ -4194,18 +4699,29 @@ declare const TeamScheduleActions: ({ isCompactView, tripCount, seasonLabel, sea
 
 /** @deprecated Legacy injected row. Prefer the structured `data` prop. */
 interface TeamScheduleCompactRow {
+    /** Identifier for the row. */
     id: string | number;
+    /** Rendered trip cell. */
     trip: ReactNode;
+    /** Rendered events cell. */
     events: ReactNode;
 }
 interface TeamScheduleCompactEvent {
+    /** Identifier for the event. */
     id: string | number;
+    /** Opposing school. */
     opponent: string;
+    /** Event name. */
     title: string;
+    /** Date the event is played. */
     date: string;
+    /** Start time, when one is set. */
     time?: string;
+    /** Marker shown while the date or time is still to be confirmed. */
     tbc?: string;
+    /** Where the event is played. */
     location: string;
+    /** Whether the event is home or away. */
     homeAway: string;
     /** Leading 48px cell (e.g. checkbox or drag handle). */
     leading?: ReactNode;
@@ -4213,14 +4729,21 @@ interface TeamScheduleCompactEvent {
     action?: ReactNode;
 }
 interface TeamScheduleCompactTrip {
+    /** Identifier for the trip. */
     id: string | number;
+    /** Rendered group travel request indicator. */
     gtr?: ReactNode;
+    /** First day of travel. */
     travelStart: string;
+    /** Last day of travel. */
     travelEnd: string;
+    /** Trip name. */
     tripName: string;
+    /** Rendered summary of the travel services on the trip. */
     services?: ReactNode;
     /** Trailing 116px cell (e.g. Edit action). */
     action?: ReactNode;
+    /** Competitions the trip covers. */
     events: TeamScheduleCompactEvent[];
 }
 interface TeamScheduleCompactTableProps {
@@ -4233,19 +4756,25 @@ interface TeamScheduleCompactTableProps {
     rows?: TeamScheduleCompactRow[];
     /** Header labels for legacy `rows` mode only. */
     tripHeaders?: ReactNode[];
+    /** Header labels for the event columns in legacy `rows` mode only. */
     eventHeaders?: ReactNode[];
+    /** Called when the user adds an event. */
     onAddEvent?: () => void;
+    /** Disables adding an event. */
     addEventDisabled?: boolean;
+    /** Additional CSS class. */
     className?: string;
     /** Click trip column headers to sort. */
     enableSorting?: boolean;
     /** Search box matching trip and event text. */
     enableGlobalFilter?: boolean;
+    /** Placeholder for the search box. */
     globalFilterPlaceholder?: string;
     /** Per-column text filters under the trip headers. */
     enableColumnFilters?: boolean;
     /** Page the trips with prev/next controls. */
     enablePagination?: boolean;
+    /** Trips per page when pagination is on. */
     pageSize?: number;
     /** Checkbox per trip plus a select-all header checkbox. */
     enableRowSelection?: boolean;
@@ -4260,26 +4789,43 @@ interface TeamScheduleCompactTableProps {
 declare const TeamScheduleCompactTable: ({ data, rows, tripHeaders, eventHeaders, onAddEvent, addEventDisabled, className, enableSorting, enableGlobalFilter, globalFilterPlaceholder, enableColumnFilters, enablePagination, pageSize, enableRowSelection, onRowSelectionChange, enableColumnVisibility, enableExpanding, }: TeamScheduleCompactTableProps) => React.JSX.Element;
 
 interface TeamScheduleDueDate {
+    /** Identifier for the task. */
     id?: string | number;
+    /** Short task name. */
     title: string;
+    /** Date the task is due. */
     date: string;
 }
 interface TeamScheduleExpandedRow {
+    /** Stable identifier for the trip. */
     masterTripGUID: string;
+    /** Sport the trip belongs to. */
     sportCode?: string;
+    /** First day of travel. */
     travelStartDate?: string;
+    /** Last day of travel. */
     travelEndDate?: string;
+    /** Trip name. */
     tripName: string;
+    /** Outstanding tasks for the trip. */
     dueDates?: TeamScheduleDueDate[];
+    /** Rendered air itinerary for the trip. */
     airSegment?: ReactNode;
+    /** Rendered ground itinerary for the trip. */
     groundSegment?: ReactNode;
+    /** Rendered lodging for the trip. */
     hotelSegment?: ReactNode;
 }
 interface TeamScheduleExpandedTableProps {
+    /** Trips to show, in display order. */
     rows: TeamScheduleExpandedRow[];
+    /** Team the schedule belongs to, shown in the header. */
     teamCode?: string;
+    /** Called with the trip the user opened. */
     onTripClick?: (row: TeamScheduleExpandedRow) => void;
+    /** Text shown when there are no trips. */
     emptyMessage?: string;
+    /** Additional CSS class. */
     className?: string;
 }
 declare const formatTeamScheduleTravelDates: (startValue?: string, endValue?: string) => string;
@@ -4289,20 +4835,33 @@ declare const TeamScheduleExpandedTable: ({ rows, teamCode, onTripClick, emptyMe
 
 type TeamScheduleHomeAway = 'Home' | 'Away' | 'Neutral';
 interface TeamScheduleEditorEvent {
+    /** Identifier for the event. */
     id: string | number;
+    /** Date the event is played. */
     eventDate: string;
+    /** Opposing school. */
     opponent: string;
+    /** Event name. */
     eventTitle: string;
+    /** Whether the event is home or away. */
     homeOrAway: TeamScheduleHomeAway;
+    /** Whether the event is a candidate for merging into another. */
     mergeable?: boolean;
 }
 interface TeamScheduleEditorTrip {
+    /** Identifier for the trip. */
     id: string | number;
+    /** Whether a group travel request has already been raised for the trip. */
     gtrExists?: boolean;
+    /** First day of travel. */
     travelStartDate: string;
+    /** Last day of travel. */
     travelEndDate: string;
+    /** Trip name. */
     tripName: string;
+    /** Travel services on the trip, as codes or a preformatted summary. */
     services: string[] | string;
+    /** Competitions the trip covers. */
     events: TeamScheduleEditorEvent[];
 }
 interface TeamScheduleEditorProps {
@@ -4314,113 +4873,219 @@ interface TeamScheduleEditorProps {
     opponentOptions?: string[];
     /** Called after any saved edit or deletion. */
     onChange?: (rows: TeamScheduleEditorTrip[]) => void;
+    /** Called with the trip the user saved. */
     onSaveTrip?: (trip: TeamScheduleEditorTrip) => void;
+    /** Called with the trip the user deleted. */
     onDeleteTrip?: (trip: TeamScheduleEditorTrip) => void;
+    /** Called with the event the user saved, and its trip when it has one. */
     onSaveEvent?: (event: TeamScheduleEditorEvent, trip?: TeamScheduleEditorTrip) => void;
+    /** Called with the event the user deleted and the trip it came from. */
     onDeleteEvent?: (event: TeamScheduleEditorEvent, trip: TeamScheduleEditorTrip) => void;
+    /** Called with the trip the user raised a group travel request for. */
     onOpenGroupTravelRequest?: (trip: TeamScheduleEditorTrip) => void;
+    /** Called with the ids of the currently selected trips. */
     onSelectedTripsChange?: (ids: Array<string | number>) => void;
+    /** Called with the ids of the currently selected events. */
     onSelectedEventsChange?: (ids: Array<string | number>) => void;
+    /** Additional CSS class. */
     className?: string;
 }
+/**
+ * Inline editor for a team's season: trips, and the events inside each trip.
+ * Works controlled via `rows` or uncontrolled via `initialRows`.
+ */
 declare const TeamScheduleEditor: ({ rows, initialRows, opponentOptions, onChange, onSaveTrip, onDeleteTrip, onSaveEvent, onDeleteEvent, onOpenGroupTravelRequest, onSelectedTripsChange, onSelectedEventsChange, className, }: TeamScheduleEditorProps) => React.JSX.Element;
 
 type TeamTravelCalendarDuration = 'month' | 'week';
 type TeamTravelCalendarItemType = 'trips' | 'due_dates';
 interface TeamTravelCalendarDueDate {
+    /** Identifier for the task, unique within the trip. */
     taskid: number | string;
+    /** Date the task is due. */
     duedate: string;
+    /** Short task name shown on the calendar. */
     tasktitle: string;
+    /** Longer explanation of what the task requires. */
     description?: string;
+    /** Workflow status of the task. */
     status?: string;
+    /** When the task was completed, absent while it is outstanding. */
     completeddatetime?: string;
+    /** Who completed the task. */
     completedby?: string;
+    /** Travel service the task belongs to (air, ground, hotel). */
     servicetype?: string;
+    /** Sport the task belongs to. */
     sportCode?: string;
+    /** Trip the task belongs to. */
     tripId?: string;
+    /** Name of that trip, for display without a second lookup. */
     tripName?: string;
+    /** Start date of that trip. */
     tripStart?: string;
+    /** Master trip this task rolls up to. */
     masterTripGUID?: string;
 }
 interface TeamTravelCalendarEvent {
+    /** Identifier for the event. */
     id?: string | number;
+    /** Event name. */
     eventtitle?: string;
+    /** Opposing team. */
     opponentname?: string;
+    /** Where the event is played. */
     venuename?: string;
+    /** Date the event starts. */
     eventstartdate?: string;
+    /** Whether the event is home or away. */
     homeoraway?: string;
 }
 interface TeamTravelCalendarTrip {
+    /** Stable identifier for the trip across systems. */
     masterTripGUID: string;
+    /** Numeric trip identifier, where the legacy portal uses one. */
     masterTripID?: number | string;
+    /** Sport the trip belongs to. */
     sportCode: string;
+    /** First day of travel. */
     tripStart: string;
+    /** Last day of travel. */
     tripEnd: string;
+    /** Trip name shown on the calendar. */
     tripName: string;
+    /** Booking status of the air portion. */
     air_status?: string;
+    /** Booking status of the charter portion. */
     charter_status?: string;
+    /** Booking status of the ground portion. */
     ground_status?: string;
+    /** Booking status of the hotel portion. */
     hotel_status?: string;
+    /** Tasks due for this trip. */
     duedates?: TeamTravelCalendarDueDate[];
+    /** Competitions this trip covers. */
     events?: TeamTravelCalendarEvent[];
 }
 interface TeamTravelCalendarSportGroup {
+    /** Sport the group covers. */
     sportCode: string;
+    /** Human-readable sport name. */
     sportDescription: string;
+    /** Number of upcoming trips, shown on the group header. */
     upcomingCount?: number;
+    /** Start date of the next trip, shown on the group header. */
     nextTripStartDate?: string;
+    /** Trips in the group. */
     trips: TeamTravelCalendarTrip[];
 }
 interface TeamTravelCalendarToolbarProps {
+    /** Period the calendar currently spans. */
     duration: TeamTravelCalendarDuration;
+    /** Period label shown between the navigation controls. */
     label?: string;
     /** Optional app-owned date picker/navigation control. */
     navigation?: ReactNode;
+    /** Called with the newly selected period length. */
     onDurationChange?: (duration: TeamTravelCalendarDuration) => void;
+    /** Called when the user jumps back to today. */
     onToday?: () => void;
+    /** Called when the user steps back one period. */
     onPrevious?: () => void;
+    /** Called when the user steps forward one period. */
     onNext?: () => void;
+    /** Additional CSS class. */
     className?: string;
 }
+/**
+ * Period controls shared by the calendar views: previous, next, today, and month/week.
+ * Stateless -- the host owns the active date and passes the label back in.
+ */
 declare const TeamTravelCalendarToolbar: ({ duration, label, navigation, onDurationChange, onToday, onPrevious, onNext, className, }: TeamTravelCalendarToolbarProps) => React.JSX.Element;
 interface TeamTravelCalendarViewProps {
+    /** Any date inside the period to render. */
     activeDate: string;
+    /** Whether to render a month or a week. */
     duration?: TeamTravelCalendarDuration;
+    /** Whether cells plot trips or due dates. */
     type?: TeamTravelCalendarItemType;
+    /** Trips to plot. Used when `type` is `trips`. */
     trips?: TeamTravelCalendarTrip[];
+    /** Tasks to plot. Used when `type` is `due_dates`. */
     dueDates?: TeamTravelCalendarDueDate[];
+    /** Date to mark as today. Defaults to the current date; set it to keep snapshots stable. */
     today?: string;
+    /** Toolbar rendered above the grid, usually a TeamTravelCalendarToolbar. */
     toolbar?: ReactNode;
+    /** Called with the trip the user opened. */
     onTripClick?: (trip: TeamTravelCalendarTrip) => void;
+    /** Called with the day the user opened, and the task when one was clicked directly. */
     onDueDateClick?: (date: string, dueDate?: TeamTravelCalendarDueDate) => void;
+    /** Called with the task the user marked complete or incomplete. */
     onDueDateToggle?: (dueDate: TeamTravelCalendarDueDate) => void;
+    /** Additional CSS class. */
     className?: string;
 }
+/**
+ * Month or week grid plotting a team's trips or task due dates onto calendar days.
+ */
 declare const TeamTravelCalendarView: ({ activeDate, duration, type, trips, dueDates, today, toolbar, onTripClick, onDueDateClick, onDueDateToggle, className, }: TeamTravelCalendarViewProps) => React.JSX.Element;
 interface TeamTravelCalendarCardViewProps {
+    /** Trips grouped by sport, in display order. */
     groups: TeamTravelCalendarSportGroup[];
+    /** Whether cards summarize trips or due dates. */
     type?: TeamTravelCalendarItemType;
+    /** Toolbar rendered above the cards. */
     toolbar?: ReactNode;
+    /** Called with the trip the user opened. */
     onTripClick?: (trip: TeamTravelCalendarTrip) => void;
+    /** Called with the task the user opened. */
     onDueDateClick?: (dueDate: TeamTravelCalendarDueDate) => void;
+    /** Called with the task the user marked complete or incomplete. */
     onDueDateToggle?: (dueDate: TeamTravelCalendarDueDate) => void;
+    /** Additional CSS class. */
     className?: string;
 }
+/**
+ * The same travel plotted as cards grouped by sport, for scanning across sports
+ * rather than across dates.
+ */
 declare const TeamTravelCalendarCardView: ({ groups, type, toolbar, onTripClick, onDueDateClick, onDueDateToggle, className, }: TeamTravelCalendarCardViewProps) => React.JSX.Element;
 interface TeamTravelCalendarListViewProps {
+    /** Trips to list, in display order. */
     trips: TeamTravelCalendarTrip[];
+    /** Whether rows show trips or due dates. */
     type?: TeamTravelCalendarItemType;
+    /** Toolbar rendered above the list. */
     toolbar?: ReactNode;
+    /** Label describing the period the list covers. */
     periodLabel?: string;
+    /** Count of upcoming trips shown in the list header. */
     upcomingTrips?: number;
+    /** Called with the trip the user opened. */
     onTripClick?: (trip: TeamTravelCalendarTrip) => void;
+    /** Called with the trip whose task list the user opened. */
     onDueDatesClick?: (trip: TeamTravelCalendarTrip) => void;
+    /** Called with the task the user opened. */
     onDueDateClick?: (dueDate: TeamTravelCalendarDueDate) => void;
+    /** Called with the task the user marked complete or incomplete. */
     onDueDateToggle?: (dueDate: TeamTravelCalendarDueDate) => void;
+    /** Additional CSS class. */
     className?: string;
 }
+/**
+ * The same travel as a dense chronological list, for long periods that a grid
+ * cannot show at once.
+ */
 declare const TeamTravelCalendarListView: ({ trips, type, toolbar, periodLabel, upcomingTrips, onTripClick, onDueDatesClick, onDueDateClick, onDueDateToggle, className, }: TeamTravelCalendarListViewProps) => React.JSX.Element;
+/**
+ * Formats the heading for a calendar period -- "March 2026" for a month,
+ * a date range for a week.
+ */
 declare const getTeamTravelCalendarPeriodLabel: (activeDate: string, duration: TeamTravelCalendarDuration) => string;
+/**
+ * Steps a date forward or back by whole periods, returning the new active date.
+ * Pass a negative `amount` to step backwards.
+ */
 declare const moveTeamTravelCalendarPeriod: (activeDate: string, duration: TeamTravelCalendarDuration, amount: number) => string;
 
 type TeamFormMode = 'Add' | 'Edit';
@@ -4440,84 +5105,154 @@ interface ManagedFormProps<T> {
     showActions?: boolean;
     /** Disable every field and action. */
     disabled?: boolean;
+    /** Additional CSS class. */
     className?: string;
 }
 interface TeamEquipmentValues {
+    /** What the item is. */
     description: string;
+    /** Weight per unit, in pounds. Drives the manifest payload total. */
     weight: TeamNumericValue;
+    /** How many are travelling. */
     quantity: TeamNumericValue;
+    /** Height per unit, in inches. */
     height: TeamNumericValue;
+    /** Width per unit, in inches. */
     width: TeamNumericValue;
+    /** Depth per unit, in inches. */
     depth: TeamNumericValue;
 }
 interface TeamEquipmentFormProps extends ManagedFormProps<TeamEquipmentValues> {
+    /** Whether the form is adding or editing. */
     mode?: TeamFormMode;
 }
+/**
+ * Adds or edits a piece of team equipment, including the dimensions and weight
+ * that charter payload planning depends on.
+ */
 declare const TeamEquipmentForm: ({ mode, values, initialValues, onChange, onSubmit, onCancel, showActions, disabled, className, }: TeamEquipmentFormProps) => React.JSX.Element;
 interface TeamUserAccessValues {
+    /** Portal user being granted access to the team. */
     userId: string;
 }
 interface TeamUserAccessFormProps extends ManagedFormProps<TeamUserAccessValues> {
+    /** Portal users available to grant access to. */
     options: SelectOption[];
 }
+/**
+ * Grants an existing portal user access to a team.
+ */
 declare const TeamUserAccessForm: ({ options, values, initialValues, onChange, onSubmit, onCancel, showActions, disabled, className, }: TeamUserAccessFormProps) => React.JSX.Element;
 type TeamProgramType = 'Air' | 'Car' | 'Hotel';
 interface TeamProgramValues {
+    /** Which loyalty program the number belongs to. */
     type: TeamProgramType;
+    /** Supplier running the program. */
     supplier: string;
+    /** The team's account or membership number. */
     accountNumber: string;
 }
 interface TeamProgramFormProps extends ManagedFormProps<TeamProgramValues> {
+    /** Suppliers to offer per program type. Types left out fall back to a free-text entry. */
     supplierOptions?: Partial<Record<TeamProgramType, SelectOption[]>>;
 }
+/**
+ * Records a loyalty or corporate program number the team travels under.
+ */
 declare const TeamProgramForm: ({ values, initialValues, onChange, onSubmit, onCancel, showActions, disabled, className, supplierOptions, }: TeamProgramFormProps) => React.JSX.Element;
 interface TeamRosterMemberValues {
+    /** Portal user this roster member is linked to, when they have an account. */
     portalUserId: string;
+    /** Given name, as it appears on the government ID used to travel. */
     firstName: string;
+    /** Middle name, as it appears on that ID. */
     middleName: string;
+    /** Confirms the traveler has no middle name, so the empty field is deliberate. */
     noMiddleName: boolean;
+    /** Family name, as it appears on that ID. */
     lastName: string;
+    /** Whether the traveler is an athlete, coach, staff member, or guest. */
     travelerType: string;
+    /** Date of birth, required by carriers for ticketing. */
     birthDate: string;
+    /** Gender as recorded on the travel document. */
     gender: string;
+    /** Traveler weight, in pounds. Feeds charter payload calculations. */
     weight: TeamNumericValue;
+    /** Passport number, for international travel. */
     passportNumber: string;
+    /** TSA PreCheck / Known Traveler Number. */
     knownTravelerNumber: string;
+    /** DHS redress number, where the traveler has one. */
     dhsRedressNumber: string;
+    /** Airline the frequent flyer number belongs to. */
     airline: string;
+    /** Frequent flyer number for that airline. */
     frequentFlyerNumber: string;
+    /** Accessibility needs, seating, and meal requests. */
     specialRequests: string;
 }
 interface TeamPortalUserOption extends SelectOption {
+    /** Traveler details to prefill the form with when this user is picked. */
     traveler?: Partial<TeamRosterMemberValues>;
 }
 interface TeamRosterMemberFormProps extends ManagedFormProps<TeamRosterMemberValues> {
+    /** Whether the form is adding or editing. */
     mode?: TeamFormMode;
+    /** Portal users a roster member can be created from. */
     portalUsers?: TeamPortalUserOption[];
+    /** Airlines offered for the frequent flyer number. */
     airlineOptions?: SelectOption[];
+    /** Traveler types offered. */
     travelerTypeOptions?: SelectOption[];
 }
+/**
+ * Adds or edits a roster member, including the identity details carriers require
+ * for ticketing. Can prefill from a linked portal user.
+ */
 declare const TeamRosterMemberForm: ({ mode, values, initialValues, onChange, onSubmit, onCancel, showActions, disabled, className, portalUsers, airlineOptions, travelerTypeOptions, }: TeamRosterMemberFormProps) => React.JSX.Element;
 type TeamImportKind = 'equipment' | 'roster' | 'teamworks-roster';
 interface TeamImportFormProps {
+    /** What the uploaded file contains. */
     kind: TeamImportKind;
+    /** Called with the file the user chose. */
     onSubmit?: (file: File) => void;
+    /** Called when the user abandons the import. */
     onCancel?: () => void;
+    /** Disables the form while an import is running. */
     disabled?: boolean;
+    /** Additional CSS class. */
     className?: string;
 }
+/**
+ * Bulk-loads roster or equipment records from an uploaded file.
+ */
 declare const TeamImportForm: ({ kind, onSubmit, onCancel, disabled, className }: TeamImportFormProps) => React.JSX.Element;
 
 interface TravelSummaryMetricsProps {
+    /** Trips completed so far this season. */
     tripsTraveled?: string | number;
+    /** Trips still ahead this season. */
     remainingTrips?: string | number;
+    /** Total trip spend for the season. */
     seasonTripCosts?: string | number;
+    /** Season the figures cover. */
     seasonLabel: string;
+    /** Count of overdue tasks, surfaced as the one actionable tile. */
     overdueActions?: string | number;
+    /** Called when the user opens the overdue tasks. The tile is static without it. */
     onOverdueActionsClick?: () => void;
+    /** Additional CSS class. */
     className?: string;
 }
+/**
+ * Formats a trip cost for a metric tile, abbreviating thousands so long figures
+ * do not wrap.
+ */
 declare const formatCompactTripCost: (value?: string | number) => string | undefined;
+/**
+ * Season-at-a-glance tiles: trips taken, trips remaining, spend, and overdue tasks.
+ */
 declare const TravelSummaryMetrics: ({ tripsTraveled, remainingTrips, seasonTripCosts, seasonLabel, overdueActions, onOverdueActionsClick, className, }: TravelSummaryMetricsProps) => React.JSX.Element;
 
 interface TravelerFormData {
@@ -4555,7 +5290,9 @@ interface TravelerFormProps {
     children?: ReactNode;
     /** Form sections - render props approach */
     renderNameSection?: (values: TravelerFormData) => ReactNode;
+    /** Renders the traveler detail fields, given the current values. */
     renderDetailsSection?: (values: TravelerFormData) => ReactNode;
+    /** Renders the travel preference fields, given the current values. */
     renderPreferencesSection?: (values: TravelerFormData) => ReactNode;
     /** Footer actions */
     footer?: ReactNode;
@@ -4629,6 +5366,9 @@ interface TripTableProps {
     /** Additional CSS class */
     className?: string;
 }
+/**
+ * Trip listing with the segment, status, and date columns the travel screens share.
+ */
 declare const TripTable: React__default.FC<TripTableProps>;
 
 type AdministrationTab = 'system' | 'client';
@@ -4639,13 +5379,19 @@ interface AdministrationCard {
     icon?: ReactNode;
 }
 interface AdministrationPageProps {
+    /** Tab currently shown. */
     activeTab?: AdministrationTab;
     /** Authoritative tabs for the current viewer. An empty array renders no tab controls. */
     enabledTabs?: AdministrationTab[];
+    /** Called with the tab the user selected. */
     onTabChange?: (tab: AdministrationTab) => void;
+    /** Administration destinations offered on the current tab. */
     cards?: AdministrationCard[];
+    /** Called with the destination the user opened. */
     onCardClick?: (card: AdministrationCard) => void;
+    /** Content rendered below the cards, for a tab that hosts its own screen. */
     children?: ReactNode;
+    /** Additional CSS class. */
     className?: string;
 }
 /** Hub administration shell and system-card index. */
@@ -4664,20 +5410,35 @@ interface AgentGroupTravelRequestsPageProps {
     today?: string;
     /** Shows the STM-employee-only quick links (agent request form, CDS requests, actionable items, administer views). */
     isStmEmployee?: boolean;
+    /** Called when the agent returns to booking. */
     onBackToBookATrip?: () => void;
+    /** Called when the agent raises a request on behalf of a school. */
     onSubmitNewRequest?: () => void;
+    /** Called when the agent raises a request through the agent-only form. */
     onSubmitAgentRequest?: () => void;
+    /** Called when the agent searches closed requests. */
     onSearchPastRequests?: () => void;
+    /** Called when the agent opens the CDS request queue. */
     onShowCdsRequests?: () => void;
+    /** Called when the agent opens the items needing action. */
     onShowActionableItems?: () => void;
+    /** Called when the agent manages the saved account-group views. */
     onAdministerViews?: () => void;
+    /** Called with the request the agent opened. */
     onOpenRequest?: (id: number) => void;
+    /** Called with the master trip the agent opened. */
     onViewMasterTrip?: (masterTripId: number) => void;
+    /** Called with the request the agent deleted. */
     onDeleteRequest?: (id: number) => void;
+    /** Called with the record locator the agent copied. */
     onCopyPnr?: (recordLocator: string) => void;
+    /** Called with the request and the milestone the agent marked complete or incomplete. */
     onToggleDueStatus?: (id: number, field: GroupTravelDueField) => void;
+    /** Called with the request and its new submitted date. */
     onSubmittedDateChange?: (id: number, value: string) => void;
+    /** Called with the request and its new quote-sent date. */
     onQuoteSentDateChange?: (id: number, value: string) => void;
+    /** Additional CSS class. */
     className?: string;
 }
 /** Hub's agent-facing Group Travel Request screen — the "Book a Trip" quick links plus the open-requests list. */
@@ -4810,6 +5571,7 @@ interface ChampionshipBidDetailPageProps {
     onBack?: () => void;
     /** BCP 47 locale used to format seats and total cost. */
     locale?: string;
+    /** Additional CSS class. */
     className?: string;
 }
 /**
@@ -5022,31 +5784,57 @@ interface CharterManifestEquipment {
     weight: number;
 }
 interface CharterManifestPageProps {
+    /** Trip the manifest belongs to. */
     tripName: string;
+    /** First day of travel. */
     travelStartDate?: string;
+    /** Last day of travel. */
     travelEndDate?: string;
+    /** Seats available on the aircraft. */
     seats: number;
+    /** Maximum payload the aircraft can carry, in pounds. */
     payloadLimit: number;
+    /** Total passenger weight, in pounds. */
     passengerWeight: number;
+    /** Total cargo and equipment weight, in pounds. */
     cargoWeight: number;
+    /** Operator flying the charter. */
     carrierName?: string;
+    /** Note from the operator about the manifest. */
     carrierNote?: string;
+    /** Passengers currently manifested. */
     passengers?: CharterManifestPassenger[];
+    /** Equipment currently manifested. */
     equipment?: CharterManifestEquipment[];
+    /** Flight segments the manifest covers. */
     segments?: CharterManifestSegment[];
+    /** Whether the manifest is locked against further edits after a final send. */
     locked?: boolean;
+    /** How far the manifest has progressed through initial and final sends. */
     sendState?: ManifestSendState;
+    /** Called when the user leaves the manifest. */
     onBack?: () => void;
+    /** Called when the user generates the manifest file for the operator. */
     onGenerateFile?: () => void;
+    /** Called when the user reassigns the charter to another operator. */
     onChangeCarrier?: () => void;
+    /** Called when the user splits the manifest across segments. */
     onSplitSegments?: () => void;
+    /** Called when the user adds passengers. */
     onAddPassengers?: () => void;
+    /** Called when the user adds equipment. */
     onAddEquipment?: () => void;
+    /** Called with the passenger the user removed. */
     onRemovePassenger?: (passenger: CharterManifestPassenger) => void;
+    /** Called with the equipment the user removed. */
     onRemoveEquipment?: (equipment: CharterManifestEquipment) => void;
+    /** Called when the user sends the initial manifest to the operator. */
     onSendInitial?: () => void;
+    /** Called when the user sends the final manifest, locking it. */
     onSendFinal?: () => void;
+    /** Called when the user retracts an initial send. */
     onUndoInitial?: () => void;
+    /** Additional CSS class. */
     className?: string;
 }
 /** Stateless, service-free rendering of Hub's charter manifest page. */
@@ -5104,6 +5892,7 @@ interface ChartersAccessManagementPageProps {
     onChangeRole?: (membership: ChartersAccessMembership, role: ChartersAccessRole) => void | Promise<void>;
     /** Remove STM Charters access after the page confirmation. */
     onRemoveAccess?: (membership: ChartersAccessMembership) => void | Promise<void>;
+    /** Additional CSS class. */
     className?: string;
 }
 /**
@@ -5212,14 +6001,21 @@ interface ContactUsData {
     groupHotelContacts?: ContactInfo[];
 }
 interface ContactUsPageProps {
+    /** Page heading. */
     title?: string;
+    /** Which state to render. Drives the loading, empty, and error treatments. */
     state?: 'loading' | 'data' | 'empty' | 'error';
+    /** Message shown in the error state. */
     errorMessage?: string;
+    /** Contact details to show in the data state. */
     data?: ContactUsData;
+    /** Called when the user prints the contact sheet. */
     onPrint?: () => void;
     /** Generic cards remain available for non-Hub consumers. */
     cards?: ContactCardData[];
+    /** Content rendered below the cards. */
     children?: ReactNode;
+    /** Additional CSS class. */
     className?: string;
 }
 /** Exact presentational counterpart of the Hub Contact Us screen. */
@@ -5274,21 +6070,37 @@ interface DashboardWidget {
     };
 }
 interface DashboardPageProps {
+    /** Greeting line above the name. */
     greeting?: string;
+    /** Name the greeting addresses. */
     firstName?: string;
+    /** School or account shown in the subtitle. */
     accountName?: string;
+    /** Widgets to render, in display order. */
     widgets?: DashboardWidget[];
+    /** Platform-wide notices shown above the widgets. */
     systemBanners?: SystemBanner[];
+    /** Travel alerts shown above the widgets. */
     alertBanners?: TravelAlertBanner[];
+    /** Whether the layout is saved, saving, or failed to save. */
     syncStatus?: 'idle' | 'saving' | 'error';
+    /** Called with the widget the user refreshed. */
     onRefresh?: (widget: DashboardWidget) => void;
+    /** Called with the widget the user removed. */
     onRemove?: (widget: DashboardWidget) => void;
+    /** Called with the widget and its new size. */
     onResize?: (widget: DashboardWidget, size: DashboardWidgetSize) => void;
+    /** Called with the positions a widget moved from and to. */
     onReorder?: (from: number, to: number) => void;
+    /** Called when the user restores the default layout. */
     onReset?: () => void;
+    /** Called with the type of widget the user added. */
     onAddWidget?: (type: DashboardWidget['type']) => void;
+    /** Called with the widget and the traveler date range the user picked. */
     onTravelerRangeChange?: (widget: DashboardWidget, range: DashboardTravelerRange) => void;
+    /** Called with the route a widget link points at. The host performs the routing. */
     onNavigate?: (path: string, state?: unknown) => void;
+    /** Additional CSS class. */
     className?: string;
 }
 /** Exact, service-free rendering of Hub's personalized home page. */
@@ -5369,22 +6181,33 @@ interface FeatureFlagManagementPageProps {
     rules: FeatureFlagRule[];
     /** Controlled account and audience options. */
     targetOptions: FeatureFlagTargetOptions;
+    /** Whether the catalog and rules are still loading. */
     loading?: boolean;
+    /** Load error shown in place of the rule list. */
     error?: string;
+    /** Called when the user retries a failed load. */
     onRetry?: () => void;
     /** Host mutation state. It disables all mutation controls. */
     submitting?: boolean;
     /** Controlled user-search results are returned through `targetOptions.users`. */
     onSearchUsers?: (query: string, accountId?: FeatureFlagIdentifier) => void | Promise<void>;
+    /** Whether a user search is in flight. */
     userSearchLoading?: boolean;
+    /** Error from the last user search. */
     userSearchError?: string;
     /** Called when an account selection needs account-scoped audience options from the host. */
     onAccountChange?: (accountId?: FeatureFlagIdentifier) => void | Promise<void>;
+    /** Whether account-scoped audience options are loading. */
     audienceLoading?: boolean;
+    /** Error from the last audience load. */
     audienceError?: string;
+    /** Called with the rule the user created. */
     onCreateRule?: (value: FeatureFlagRuleFormValue) => void | Promise<void>;
+    /** Called with the edit the user submitted. */
     onEditRule?: (request: FeatureFlagRuleEditRequest) => void | Promise<void>;
+    /** Called with the rule the user deactivated. */
     onDeactivateRule?: (request: FeatureFlagRuleDeactivateRequest) => void | Promise<void>;
+    /** Additional CSS class. */
     className?: string;
 }
 /**
@@ -5407,20 +6230,36 @@ interface GroupTravelRequestContact {
     email?: string;
 }
 interface GroupTravelRequestPageProps {
+    /** Event the request is being raised for, shown in the heading. */
     eventName?: string;
+    /** Number of steps in the wizard, shown in the progress indicator. */
     totalPages?: number;
+    /** Called with the completed request. */
     onSubmit?: (data: GroupTravelRequestValues) => void;
+    /** Called when the user abandons the request. */
     onCancel?: () => void;
+    /** Called with the full request on every field change. */
     onChange?: (data: GroupTravelRequestValues) => void;
+    /** Values to prefill the wizard with. */
     initialValues?: GroupTravelRequestValues;
+    /** Team contacts offered as the request contact. */
     contacts?: GroupTravelRequestContact[];
+    /** Catering choices offered for the trip. */
     cateringOptions?: string[];
+    /** Default pickup address, offered as the departure point. */
     schoolAddress?: string;
+    /** Travel services the request can cover, and how each is configured. */
     services?: ServiceConfig[];
     /** Retained for consumers that provide a custom summary configuration. */
     summarySections?: SummarySectionConfig[];
+    /** Additional CSS class. */
     className?: string;
 }
+/**
+ * Multi-step wizard for requesting travel for a whole team.
+ * Collects the trip, the services needed, and the traveling party, and hands the
+ * completed request to the host through `onSubmit`.
+ */
 declare const GroupTravelRequestPage: {
     ({ eventName, totalPages, onSubmit, onCancel, onChange, initialValues, contacts, cateringOptions, schoolAddress, services, summarySections, className, }: GroupTravelRequestPageProps): React.JSX.Element;
     displayName: string;
@@ -5539,6 +6378,10 @@ interface IndividualTravelPageProps {
     /** Additional CSS class. */
     className?: string;
 }
+/**
+ * Landing page for a single traveler's own requests, listing what they have raised
+ * and offering a new one.
+ */
 declare const IndividualTravelPage: React__default.FC<IndividualTravelPageProps>;
 
 /** Travel services represented by the legacy individual-request record. */
@@ -5730,9 +6573,17 @@ interface IndividualTravelRequestFormPageProps {
     onRetry?: () => void;
     /** Optional account-specific fee or response-time notice. */
     notice?: ReactNode;
+    /** Label for the submit button. */
     submitLabel?: string;
+    /** Additional CSS class. */
     className?: string;
 }
+/**
+ * Form for one traveler to request their own travel.
+ * The questions asked come from the account configuration, so the host supplies
+ * them rather than the page assuming a fixed set.
+ * Renders read-only when no `onSubmit` is given.
+ */
 declare const IndividualTravelRequestFormPage: React__default.FC<IndividualTravelRequestFormPageProps>;
 
 interface IndividualTravelRequestDetailPageProps {
@@ -5746,9 +6597,11 @@ interface IndividualTravelRequestDetailPageProps {
     notice?: ReactNode;
     /** Optional host-owned return route. Hidden when absent. */
     onBack?: () => void;
+    /** Label for the back link. */
     backLabel?: string;
     /** Optional retry for a failed host query. Hidden unless an error is present. */
     onRetry?: () => void;
+    /** Additional CSS class. */
     className?: string;
 }
 /**
@@ -6176,12 +7029,21 @@ interface RosterProgramNumberRow {
     accountNumber: string;
 }
 interface RosterProgramNumbersPageProps {
+    /** Loyalty and corporate program numbers held for the team. */
     programs: RosterProgramNumberRow[];
+    /** Whether the programs are still loading. */
     loading?: boolean;
+    /** Whether a save is in flight. */
     saving?: boolean;
+    /** Called when the user leaves the page. */
     onBack?: () => void;
+    /** Called with the full set of programs the user saved. */
     onSubmit?: (programs: RosterProgramNumberRow[]) => void | Promise<void>;
 }
+/**
+ * Edits the loyalty and corporate program numbers a team travels under, saving them
+ * as one set.
+ */
 declare const RosterProgramNumbersPage: {
     ({ programs, loading, saving, onBack, onSubmit, }: RosterProgramNumbersPageProps): React.JSX.Element;
     displayName: string;
@@ -6234,11 +7096,18 @@ interface RosterReportOption {
     description?: string;
 }
 interface RosterReportsPageProps {
+    /** Reports the user can run. */
     reports: RosterReportOption[];
+    /** Report currently running, shown as in progress. */
     runningReportId?: string;
+    /** Called when the user leaves the page. */
     onBack?: () => void;
+    /** Called with the report the user ran. */
     onRun?: (report: RosterReportOption) => void | Promise<void>;
 }
+/**
+ * Lists the roster reports a user can run, and reports progress while one runs.
+ */
 declare const RosterReportsPage: {
     ({ reports, runningReportId, onBack, onRun }: RosterReportsPageProps): React.JSX.Element;
     displayName: string;