kaafil-react-uikit 0.8.0 → 0.10.0

package/dist/manager/index.d.cts

@@ -64,7 +64,14 @@ interface ManagerChecklistSectionProps {
     readonly style?: KaafilTokenOverrides;
 }
 
-declare function ManagerChecklistSection({ tripRef, components, style, }: ManagerChecklistSectionProps): ReactNode;
+/**
+ * The session gate. `SessionShell` renders its children throughout the async
+ * open window with `SessionContext` populated but no client yet, so any
+ * client-backed hook below throws until the credential resolves. The split is
+ * not optional: Rules of Hooks forbid returning early before the inner hooks
+ * in one component.
+ */
+declare function ManagerChecklistSection(props: ManagerChecklistSectionProps): ReactNode;
 
 interface BlockerRowProps {
     readonly blocker: CloseoutBlockerRow;
@@ -94,21 +101,42 @@ interface ManagerCloseoutSectionProps {
     readonly style?: KaafilTokenOverrides;
 }
 
-declare function ManagerCloseoutSection({ tripRef, onBlockerAction, onSubmitUnlockRequest, components, style, }: ManagerCloseoutSectionProps): ReactNode;
+/**
+ * The session gate. `SessionShell` renders its children throughout the async
+ * open window with `SessionContext` populated but no client yet, so any
+ * client-backed hook below throws until the credential resolves. The split is
+ * not optional: Rules of Hooks forbid returning early before the inner hooks
+ * in one component.
+ */
+declare function ManagerCloseoutSection(props: ManagerCloseoutSectionProps): ReactNode;
 
 interface ManagerDocumentsSectionProps {
     readonly tripRef: string;
     readonly style?: KaafilTokenOverrides;
 }
 
-declare function ManagerDocumentsSection({ tripRef, style, }: ManagerDocumentsSectionProps): ReactNode;
+/**
+ * The session gate. `SessionShell` renders its children throughout the async
+ * open window with `SessionContext` populated but no client yet, so any
+ * client-backed hook below throws until the credential resolves. The split is
+ * not optional: Rules of Hooks forbid returning early before the inner hooks
+ * in one component.
+ */
+declare function ManagerDocumentsSection(props: ManagerDocumentsSectionProps): ReactNode;
 
 interface ManagerFloatLedgerSectionProps {
     readonly tripRef: string;
     readonly style?: KaafilTokenOverrides;
 }
 
-declare function ManagerFloatLedgerSection({ tripRef, style, }: ManagerFloatLedgerSectionProps): ReactNode;
+/**
+ * The session gate. `SessionShell` renders its children throughout the async
+ * open window with `SessionContext` populated but no client yet, so any
+ * client-backed hook below throws until the credential resolves. The split is
+ * not optional: Rules of Hooks forbid returning early before the inner hooks
+ * in one component.
+ */
+declare function ManagerFloatLedgerSection(props: ManagerFloatLedgerSectionProps): ReactNode;
 
 /** One answer this composite is about to write back — mirrors
  * `SubmitFormResponseInput['answers'][number]` so nothing here hand-shapes
@@ -185,7 +213,14 @@ interface ManagerFormsSectionProps {
     readonly style?: KaafilTokenOverrides;
 }
 
-declare function ManagerFormsSection({ tripRef, initialFormRef, travellerRef, onSubmitted, components, style, }: ManagerFormsSectionProps): ReactNode;
+/**
+ * The session gate. `SessionShell` renders its children throughout the async
+ * open window with `SessionContext` populated but no client yet, so any
+ * client-backed hook below throws until the credential resolves. The split is
+ * not optional: Rules of Hooks forbid returning early before the inner hooks
+ * in one component.
+ */
+declare function ManagerFormsSection(props: ManagerFormsSectionProps): ReactNode;
 
 interface DayStripProps {
     readonly days: readonly ItineraryDayRow[];
@@ -223,7 +258,14 @@ interface ManagerItinerarySectionProps {
     readonly style?: KaafilTokenOverrides;
 }
 
-declare function ManagerItinerarySection({ tripRef, emptyView, components, style, }: ManagerItinerarySectionProps): ReactNode;
+/**
+ * The session gate. `SessionShell` renders its children throughout the async
+ * open window with `SessionContext` populated but no client yet, so any
+ * client-backed hook below throws until the credential resolves. The split is
+ * not optional: Rules of Hooks forbid returning early before the inner hooks
+ * in one component.
+ */
+declare function ManagerItinerarySection(props: ManagerItinerarySectionProps): ReactNode;
 
 interface TripBookingGroupCardProps {
     readonly group: ManifestBookingGroup;
@@ -318,7 +360,14 @@ interface ManifestBookingGroup {
     readonly currency: string;
 }
 
-declare function ManagerManifestSection({ tripRef, onCollectFromGroup, onOpenTraveller, emptyView, components, style, }: ManagerManifestSectionProps): ReactNode;
+/**
+ * The session gate. `SessionShell` renders its children throughout the async
+ * open window with `SessionContext` populated but no client yet, so any
+ * client-backed hook below throws until the credential resolves. The split is
+ * not optional: Rules of Hooks forbid returning early before the inner hooks
+ * in one component.
+ */
+declare function ManagerManifestSection(props: ManagerManifestSectionProps): ReactNode;
 
 interface ManagerMeSectionProps {
     /** Fired when a recent-trip row is tapped — the host's own real
@@ -333,7 +382,14 @@ interface ManagerMeSectionProps {
     readonly style?: KaafilTokenOverrides;
 }
 
-declare function ManagerMeSection({ onOpenTrip, onSignOut, style, }: ManagerMeSectionProps): ReactNode;
+/**
+ * The session gate. `SessionShell` renders its children throughout the async
+ * open window with `SessionContext` populated but no client yet, so any
+ * client-backed hook below throws until the credential resolves. The split is
+ * not optional: Rules of Hooks forbid returning early before the inner hooks
+ * in one component.
+ */
+declare function ManagerMeSection(props: ManagerMeSectionProps): ReactNode;
 
 interface BalanceDueDisplayRow {
     readonly travellerId: string;
@@ -404,7 +460,14 @@ interface ManagerMoneySectionProps {
     readonly style?: KaafilTokenOverrides;
 }
 
-declare function ManagerMoneySection({ tripRef, onViewFloatLedger, components, style, }: ManagerMoneySectionProps): ReactNode;
+/**
+ * The session gate. `SessionShell` renders its children throughout the async
+ * open window with `SessionContext` populated but no client yet, so any
+ * client-backed hook below throws until the credential resolves. The split is
+ * not optional: Rules of Hooks forbid returning early before the inner hooks
+ * in one component.
+ */
+declare function ManagerMoneySection(props: ManagerMoneySectionProps): ReactNode;
 
 interface ManagerNotificationsSectionProps {
     /** Fired after a row marks itself read — the host decides what a non-null
@@ -419,7 +482,14 @@ interface ManagerNotificationsSectionProps {
     readonly style?: KaafilTokenOverrides;
 }
 
-declare function ManagerNotificationsSection({ onSelectNotification, style, }: ManagerNotificationsSectionProps): ReactNode;
+/**
+ * The session gate. `SessionShell` renders its children throughout the async
+ * open window with `SessionContext` populated but no client yet, so any
+ * client-backed hook below throws until the credential resolves. The split is
+ * not optional: Rules of Hooks forbid returning early before the inner hooks
+ * in one component.
+ */
+declare function ManagerNotificationsSection(props: ManagerNotificationsSectionProps): ReactNode;
 
 type WireOnly<T> = T extends unknown ? Omit<T, 'status' | 'syncedAt'> : never;
 type ManagerTodayEngaged = Extract<WireOnly<ManagerTodayReady>, {
@@ -428,6 +498,13 @@ type ManagerTodayEngaged = Extract<WireOnly<ManagerTodayReady>, {
 type ManagerTodayIdle = Extract<WireOnly<ManagerTodayReady>, {
     kind: 'idle';
 }>;
+/** The module a hero quick-link chip (or the closeout card's "still need
+ * closing" row) navigates to. Named rather than inlined because
+ * `KaafilManagerApp` maps every member onto a real `ManagerTripTabKey` and
+ * needs to refer to the union where its own `onNavigateModule` is optional —
+ * `Parameters<typeof onNavigateModule>[0]` cannot narrow through an optional
+ * prop. */
+type ManagerModuleKey = 'manifest' | 'rooming' | 'checklist' | 'docs' | 'closing-day';
 interface ManagerNowSectionProps {
     /** The trip this section reads `useManagerToday(tripRef)` for — resolved
      * by the caller, typically off `useManagerMe()`'s own `defaultTripId`. */
@@ -438,7 +515,7 @@ interface ManagerNowSectionProps {
      * where each key routes to; a module whose composite doesn't exist yet
      * (`'closing-day'` included — `ClosingDayFlow` is a later wave) still
      * fires this callback, so the host can no-op it until it does. */
-    readonly onNavigateModule: (moduleKey: 'manifest' | 'rooming' | 'checklist' | 'docs' | 'closing-day') => void;
+    readonly onNavigateModule: (moduleKey: ManagerModuleKey) => void;
     /** Fired once a Quick Actions "Log an expense" submit REALLY succeeds
      * (the FAB opens a real `LogExpenseSheet` internally, backed by
      * `useExpenses(tripRef).log()` — the same sheet `ManagerMoneySection`'s
@@ -472,7 +549,14 @@ interface ManagerOverviewSectionProps {
     readonly style?: KaafilTokenOverrides;
 }
 
-declare function ManagerOverviewSection({ tripRef, style }: ManagerOverviewSectionProps): ReactNode;
+/**
+ * The session gate. `SessionShell` renders its children throughout the async
+ * open window with `SessionContext` populated but no client yet, so any
+ * client-backed hook below throws until the credential resolves. The split is
+ * not optional: Rules of Hooks forbid returning early before the inner hooks
+ * in one component.
+ */
+declare function ManagerOverviewSection(props: ManagerOverviewSectionProps): ReactNode;
 
 interface CloseStopResolution {
     readonly travellerId: string;
@@ -526,7 +610,14 @@ interface ManagerPickupsSectionProps {
     readonly style?: KaafilTokenOverrides;
 }
 
-declare function ManagerPickupsSection({ tripRef, eventType, components, style, }: ManagerPickupsSectionProps): ReactNode;
+/**
+ * The session gate. `SessionShell` renders its children throughout the async
+ * open window with `SessionContext` populated but no client yet, so any
+ * client-backed hook below throws until the credential resolves. The split is
+ * not optional: Rules of Hooks forbid returning early before the inner hooks
+ * in one component.
+ */
+declare function ManagerPickupsSection(props: ManagerPickupsSectionProps): ReactNode;
 
 interface RoomCardProps {
     readonly room: RoomingRoom;
@@ -588,7 +679,14 @@ interface ManagerRoomingSectionProps {
     readonly style?: KaafilTokenOverrides;
 }
 
-declare function ManagerRoomingSection({ tripRef, onOpenTraveller, emptyView, components, style, }: ManagerRoomingSectionProps): ReactNode;
+/**
+ * The session gate. `SessionShell` renders its children throughout the async
+ * open window with `SessionContext` populated but no client yet, so any
+ * client-backed hook below throws until the credential resolves. The split is
+ * not optional: Rules of Hooks forbid returning early before the inner hooks
+ * in one component.
+ */
+declare function ManagerRoomingSection(props: ManagerRoomingSectionProps): ReactNode;
 
 interface ManagerRosterSectionProps {
     readonly tripRef: string;
@@ -599,7 +697,14 @@ interface ManagerRosterSectionProps {
     readonly style?: KaafilTokenOverrides;
 }
 
-declare function ManagerRosterSection({ tripRef, onOpenTraveller, style, }: ManagerRosterSectionProps): ReactNode;
+/**
+ * The session gate. `SessionShell` renders its children throughout the async
+ * open window with `SessionContext` populated but no client yet, so any
+ * client-backed hook below throws until the credential resolves. The split is
+ * not optional: Rules of Hooks forbid returning early before the inner hooks
+ * in one component.
+ */
+declare function ManagerRosterSection(props: ManagerRosterSectionProps): ReactNode;
 
 interface ManagerSyncCenterSectionProps {
     /** Scopes the itemized outbox view to one trip's own lane — the real
@@ -684,7 +789,14 @@ interface ManagerTravellerProfileSectionProps {
     readonly style?: KaafilTokenOverrides;
 }
 
-declare function ManagerTravellerProfileSection({ tripRef, travellerRef, components, style, }: ManagerTravellerProfileSectionProps): ReactNode;
+/**
+ * The session gate. `SessionShell` renders its children throughout the async
+ * open window with `SessionContext` populated but no client yet, so any
+ * client-backed hook below throws until the credential resolves. The split is
+ * not optional: Rules of Hooks forbid returning early before the inner hooks
+ * in one component.
+ */
+declare function ManagerTravellerProfileSection(props: ManagerTravellerProfileSectionProps): ReactNode;
 
 /** The one real trip-vs-trek field (`Trip.eventType`, no third value) —
  * derived structurally off `useManagerMe()`'s own trip row so this file
@@ -813,7 +925,14 @@ interface ManagerVehiclesSectionProps {
     readonly style?: KaafilTokenOverrides;
 }
 
-declare function ManagerVehiclesSection({ tripRef, onOpenTraveller, emptyView, components, style, }: ManagerVehiclesSectionProps): ReactNode;
+/**
+ * The session gate. `SessionShell` renders its children throughout the async
+ * open window with `SessionContext` populated but no client yet, so any
+ * client-backed hook below throws until the credential resolves. The split is
+ * not optional: Rules of Hooks forbid returning early before the inner hooks
+ * in one component.
+ */
+declare function ManagerVehiclesSection(props: ManagerVehiclesSectionProps): ReactNode;
 
 interface VendorListSectionProps {
     readonly vendors: readonly TripVendorRow[];
@@ -851,7 +970,14 @@ interface ManagerVendorsSectionProps {
     readonly style?: KaafilTokenOverrides;
 }
 
-declare function ManagerVendorsSection({ tripRef, category, onVendorSelect, emptyView, components, style, }: ManagerVendorsSectionProps): ReactNode;
+/**
+ * The session gate. `SessionShell` renders its children throughout the async
+ * open window with `SessionContext` populated but no client yet, so any
+ * client-backed hook below throws until the credential resolves. The split is
+ * not optional: Rules of Hooks forbid returning early before the inner hooks
+ * in one component.
+ */
+declare function ManagerVendorsSection(props: ManagerVendorsSectionProps): ReactNode;
 
 /** The 3 bottom-nav destinations this Surface owns — Trip/Trek merge into
  * one tab (icon/label switch off the selected trip's real `eventType`),
@@ -883,8 +1009,14 @@ interface KaafilManagerAppProps {
      * deep-linking level below `initialTripRef`/`activeTab` (e.g. landing
      * directly on the Money tab from a push notification). */
     readonly initialTripTabKey?: ManagerTripTabKey;
-    /** → `ManagerNowSection.onNavigateModule` (required there). */
-    readonly onNavigateModule: (moduleKey: 'manifest' | 'rooming' | 'checklist' | 'docs' | 'closing-day') => void;
+    /** An analytics/URL-sync MIRROR, not the navigation itself — optional for
+     * the same reason `onOpenTraveller` is, and unlike the four required
+     * callbacks below. `ManagerNowSection.onNavigateModule` is required there
+     * and is satisfied by this Surface's own `handleNavigateModule`, which maps
+     * every key onto a real `ManagerTripTabKey` and performs the navigation
+     * directly. Omit it and the quick-link chips still work; you lose only the
+     * host-side hook. */
+    readonly onNavigateModule?: (moduleKey: ManagerModuleKey) => void;
     /** → `ManagerNowSection.onLogExpense` (required there). */
     readonly onLogExpense: () => void;
     /** → `ManagerNowSection.onCollectPayment` (required there). */

package/dist/manager/index.d.ts

@@ -64,7 +64,14 @@ interface ManagerChecklistSectionProps {
     readonly style?: KaafilTokenOverrides;
 }
 
-declare function ManagerChecklistSection({ tripRef, components, style, }: ManagerChecklistSectionProps): ReactNode;
+/**
+ * The session gate. `SessionShell` renders its children throughout the async
+ * open window with `SessionContext` populated but no client yet, so any
+ * client-backed hook below throws until the credential resolves. The split is
+ * not optional: Rules of Hooks forbid returning early before the inner hooks
+ * in one component.
+ */
+declare function ManagerChecklistSection(props: ManagerChecklistSectionProps): ReactNode;
 
 interface BlockerRowProps {
     readonly blocker: CloseoutBlockerRow;
@@ -94,21 +101,42 @@ interface ManagerCloseoutSectionProps {
     readonly style?: KaafilTokenOverrides;
 }
 
-declare function ManagerCloseoutSection({ tripRef, onBlockerAction, onSubmitUnlockRequest, components, style, }: ManagerCloseoutSectionProps): ReactNode;
+/**
+ * The session gate. `SessionShell` renders its children throughout the async
+ * open window with `SessionContext` populated but no client yet, so any
+ * client-backed hook below throws until the credential resolves. The split is
+ * not optional: Rules of Hooks forbid returning early before the inner hooks
+ * in one component.
+ */
+declare function ManagerCloseoutSection(props: ManagerCloseoutSectionProps): ReactNode;
 
 interface ManagerDocumentsSectionProps {
     readonly tripRef: string;
     readonly style?: KaafilTokenOverrides;
 }
 
-declare function ManagerDocumentsSection({ tripRef, style, }: ManagerDocumentsSectionProps): ReactNode;
+/**
+ * The session gate. `SessionShell` renders its children throughout the async
+ * open window with `SessionContext` populated but no client yet, so any
+ * client-backed hook below throws until the credential resolves. The split is
+ * not optional: Rules of Hooks forbid returning early before the inner hooks
+ * in one component.
+ */
+declare function ManagerDocumentsSection(props: ManagerDocumentsSectionProps): ReactNode;
 
 interface ManagerFloatLedgerSectionProps {
     readonly tripRef: string;
     readonly style?: KaafilTokenOverrides;
 }
 
-declare function ManagerFloatLedgerSection({ tripRef, style, }: ManagerFloatLedgerSectionProps): ReactNode;
+/**
+ * The session gate. `SessionShell` renders its children throughout the async
+ * open window with `SessionContext` populated but no client yet, so any
+ * client-backed hook below throws until the credential resolves. The split is
+ * not optional: Rules of Hooks forbid returning early before the inner hooks
+ * in one component.
+ */
+declare function ManagerFloatLedgerSection(props: ManagerFloatLedgerSectionProps): ReactNode;
 
 /** One answer this composite is about to write back — mirrors
  * `SubmitFormResponseInput['answers'][number]` so nothing here hand-shapes
@@ -185,7 +213,14 @@ interface ManagerFormsSectionProps {
     readonly style?: KaafilTokenOverrides;
 }
 
-declare function ManagerFormsSection({ tripRef, initialFormRef, travellerRef, onSubmitted, components, style, }: ManagerFormsSectionProps): ReactNode;
+/**
+ * The session gate. `SessionShell` renders its children throughout the async
+ * open window with `SessionContext` populated but no client yet, so any
+ * client-backed hook below throws until the credential resolves. The split is
+ * not optional: Rules of Hooks forbid returning early before the inner hooks
+ * in one component.
+ */
+declare function ManagerFormsSection(props: ManagerFormsSectionProps): ReactNode;
 
 interface DayStripProps {
     readonly days: readonly ItineraryDayRow[];
@@ -223,7 +258,14 @@ interface ManagerItinerarySectionProps {
     readonly style?: KaafilTokenOverrides;
 }
 
-declare function ManagerItinerarySection({ tripRef, emptyView, components, style, }: ManagerItinerarySectionProps): ReactNode;
+/**
+ * The session gate. `SessionShell` renders its children throughout the async
+ * open window with `SessionContext` populated but no client yet, so any
+ * client-backed hook below throws until the credential resolves. The split is
+ * not optional: Rules of Hooks forbid returning early before the inner hooks
+ * in one component.
+ */
+declare function ManagerItinerarySection(props: ManagerItinerarySectionProps): ReactNode;
 
 interface TripBookingGroupCardProps {
     readonly group: ManifestBookingGroup;
@@ -318,7 +360,14 @@ interface ManifestBookingGroup {
     readonly currency: string;
 }
 
-declare function ManagerManifestSection({ tripRef, onCollectFromGroup, onOpenTraveller, emptyView, components, style, }: ManagerManifestSectionProps): ReactNode;
+/**
+ * The session gate. `SessionShell` renders its children throughout the async
+ * open window with `SessionContext` populated but no client yet, so any
+ * client-backed hook below throws until the credential resolves. The split is
+ * not optional: Rules of Hooks forbid returning early before the inner hooks
+ * in one component.
+ */
+declare function ManagerManifestSection(props: ManagerManifestSectionProps): ReactNode;
 
 interface ManagerMeSectionProps {
     /** Fired when a recent-trip row is tapped — the host's own real
@@ -333,7 +382,14 @@ interface ManagerMeSectionProps {
     readonly style?: KaafilTokenOverrides;
 }
 
-declare function ManagerMeSection({ onOpenTrip, onSignOut, style, }: ManagerMeSectionProps): ReactNode;
+/**
+ * The session gate. `SessionShell` renders its children throughout the async
+ * open window with `SessionContext` populated but no client yet, so any
+ * client-backed hook below throws until the credential resolves. The split is
+ * not optional: Rules of Hooks forbid returning early before the inner hooks
+ * in one component.
+ */
+declare function ManagerMeSection(props: ManagerMeSectionProps): ReactNode;
 
 interface BalanceDueDisplayRow {
     readonly travellerId: string;
@@ -404,7 +460,14 @@ interface ManagerMoneySectionProps {
     readonly style?: KaafilTokenOverrides;
 }
 
-declare function ManagerMoneySection({ tripRef, onViewFloatLedger, components, style, }: ManagerMoneySectionProps): ReactNode;
+/**
+ * The session gate. `SessionShell` renders its children throughout the async
+ * open window with `SessionContext` populated but no client yet, so any
+ * client-backed hook below throws until the credential resolves. The split is
+ * not optional: Rules of Hooks forbid returning early before the inner hooks
+ * in one component.
+ */
+declare function ManagerMoneySection(props: ManagerMoneySectionProps): ReactNode;
 
 interface ManagerNotificationsSectionProps {
     /** Fired after a row marks itself read — the host decides what a non-null
@@ -419,7 +482,14 @@ interface ManagerNotificationsSectionProps {
     readonly style?: KaafilTokenOverrides;
 }
 
-declare function ManagerNotificationsSection({ onSelectNotification, style, }: ManagerNotificationsSectionProps): ReactNode;
+/**
+ * The session gate. `SessionShell` renders its children throughout the async
+ * open window with `SessionContext` populated but no client yet, so any
+ * client-backed hook below throws until the credential resolves. The split is
+ * not optional: Rules of Hooks forbid returning early before the inner hooks
+ * in one component.
+ */
+declare function ManagerNotificationsSection(props: ManagerNotificationsSectionProps): ReactNode;
 
 type WireOnly<T> = T extends unknown ? Omit<T, 'status' | 'syncedAt'> : never;
 type ManagerTodayEngaged = Extract<WireOnly<ManagerTodayReady>, {
@@ -428,6 +498,13 @@ type ManagerTodayEngaged = Extract<WireOnly<ManagerTodayReady>, {
 type ManagerTodayIdle = Extract<WireOnly<ManagerTodayReady>, {
     kind: 'idle';
 }>;
+/** The module a hero quick-link chip (or the closeout card's "still need
+ * closing" row) navigates to. Named rather than inlined because
+ * `KaafilManagerApp` maps every member onto a real `ManagerTripTabKey` and
+ * needs to refer to the union where its own `onNavigateModule` is optional —
+ * `Parameters<typeof onNavigateModule>[0]` cannot narrow through an optional
+ * prop. */
+type ManagerModuleKey = 'manifest' | 'rooming' | 'checklist' | 'docs' | 'closing-day';
 interface ManagerNowSectionProps {
     /** The trip this section reads `useManagerToday(tripRef)` for — resolved
      * by the caller, typically off `useManagerMe()`'s own `defaultTripId`. */
@@ -438,7 +515,7 @@ interface ManagerNowSectionProps {
      * where each key routes to; a module whose composite doesn't exist yet
      * (`'closing-day'` included — `ClosingDayFlow` is a later wave) still
      * fires this callback, so the host can no-op it until it does. */
-    readonly onNavigateModule: (moduleKey: 'manifest' | 'rooming' | 'checklist' | 'docs' | 'closing-day') => void;
+    readonly onNavigateModule: (moduleKey: ManagerModuleKey) => void;
     /** Fired once a Quick Actions "Log an expense" submit REALLY succeeds
      * (the FAB opens a real `LogExpenseSheet` internally, backed by
      * `useExpenses(tripRef).log()` — the same sheet `ManagerMoneySection`'s
@@ -472,7 +549,14 @@ interface ManagerOverviewSectionProps {
     readonly style?: KaafilTokenOverrides;
 }
 
-declare function ManagerOverviewSection({ tripRef, style }: ManagerOverviewSectionProps): ReactNode;
+/**
+ * The session gate. `SessionShell` renders its children throughout the async
+ * open window with `SessionContext` populated but no client yet, so any
+ * client-backed hook below throws until the credential resolves. The split is
+ * not optional: Rules of Hooks forbid returning early before the inner hooks
+ * in one component.
+ */
+declare function ManagerOverviewSection(props: ManagerOverviewSectionProps): ReactNode;
 
 interface CloseStopResolution {
     readonly travellerId: string;
@@ -526,7 +610,14 @@ interface ManagerPickupsSectionProps {
     readonly style?: KaafilTokenOverrides;
 }
 
-declare function ManagerPickupsSection({ tripRef, eventType, components, style, }: ManagerPickupsSectionProps): ReactNode;
+/**
+ * The session gate. `SessionShell` renders its children throughout the async
+ * open window with `SessionContext` populated but no client yet, so any
+ * client-backed hook below throws until the credential resolves. The split is
+ * not optional: Rules of Hooks forbid returning early before the inner hooks
+ * in one component.
+ */
+declare function ManagerPickupsSection(props: ManagerPickupsSectionProps): ReactNode;
 
 interface RoomCardProps {
     readonly room: RoomingRoom;
@@ -588,7 +679,14 @@ interface ManagerRoomingSectionProps {
     readonly style?: KaafilTokenOverrides;
 }
 
-declare function ManagerRoomingSection({ tripRef, onOpenTraveller, emptyView, components, style, }: ManagerRoomingSectionProps): ReactNode;
+/**
+ * The session gate. `SessionShell` renders its children throughout the async
+ * open window with `SessionContext` populated but no client yet, so any
+ * client-backed hook below throws until the credential resolves. The split is
+ * not optional: Rules of Hooks forbid returning early before the inner hooks
+ * in one component.
+ */
+declare function ManagerRoomingSection(props: ManagerRoomingSectionProps): ReactNode;
 
 interface ManagerRosterSectionProps {
     readonly tripRef: string;
@@ -599,7 +697,14 @@ interface ManagerRosterSectionProps {
     readonly style?: KaafilTokenOverrides;
 }
 
-declare function ManagerRosterSection({ tripRef, onOpenTraveller, style, }: ManagerRosterSectionProps): ReactNode;
+/**
+ * The session gate. `SessionShell` renders its children throughout the async
+ * open window with `SessionContext` populated but no client yet, so any
+ * client-backed hook below throws until the credential resolves. The split is
+ * not optional: Rules of Hooks forbid returning early before the inner hooks
+ * in one component.
+ */
+declare function ManagerRosterSection(props: ManagerRosterSectionProps): ReactNode;
 
 interface ManagerSyncCenterSectionProps {
     /** Scopes the itemized outbox view to one trip's own lane — the real
@@ -684,7 +789,14 @@ interface ManagerTravellerProfileSectionProps {
     readonly style?: KaafilTokenOverrides;
 }
 
-declare function ManagerTravellerProfileSection({ tripRef, travellerRef, components, style, }: ManagerTravellerProfileSectionProps): ReactNode;
+/**
+ * The session gate. `SessionShell` renders its children throughout the async
+ * open window with `SessionContext` populated but no client yet, so any
+ * client-backed hook below throws until the credential resolves. The split is
+ * not optional: Rules of Hooks forbid returning early before the inner hooks
+ * in one component.
+ */
+declare function ManagerTravellerProfileSection(props: ManagerTravellerProfileSectionProps): ReactNode;
 
 /** The one real trip-vs-trek field (`Trip.eventType`, no third value) —
  * derived structurally off `useManagerMe()`'s own trip row so this file
@@ -813,7 +925,14 @@ interface ManagerVehiclesSectionProps {
     readonly style?: KaafilTokenOverrides;
 }
 
-declare function ManagerVehiclesSection({ tripRef, onOpenTraveller, emptyView, components, style, }: ManagerVehiclesSectionProps): ReactNode;
+/**
+ * The session gate. `SessionShell` renders its children throughout the async
+ * open window with `SessionContext` populated but no client yet, so any
+ * client-backed hook below throws until the credential resolves. The split is
+ * not optional: Rules of Hooks forbid returning early before the inner hooks
+ * in one component.
+ */
+declare function ManagerVehiclesSection(props: ManagerVehiclesSectionProps): ReactNode;
 
 interface VendorListSectionProps {
     readonly vendors: readonly TripVendorRow[];
@@ -851,7 +970,14 @@ interface ManagerVendorsSectionProps {
     readonly style?: KaafilTokenOverrides;
 }
 
-declare function ManagerVendorsSection({ tripRef, category, onVendorSelect, emptyView, components, style, }: ManagerVendorsSectionProps): ReactNode;
+/**
+ * The session gate. `SessionShell` renders its children throughout the async
+ * open window with `SessionContext` populated but no client yet, so any
+ * client-backed hook below throws until the credential resolves. The split is
+ * not optional: Rules of Hooks forbid returning early before the inner hooks
+ * in one component.
+ */
+declare function ManagerVendorsSection(props: ManagerVendorsSectionProps): ReactNode;
 
 /** The 3 bottom-nav destinations this Surface owns — Trip/Trek merge into
  * one tab (icon/label switch off the selected trip's real `eventType`),
@@ -883,8 +1009,14 @@ interface KaafilManagerAppProps {
      * deep-linking level below `initialTripRef`/`activeTab` (e.g. landing
      * directly on the Money tab from a push notification). */
     readonly initialTripTabKey?: ManagerTripTabKey;
-    /** → `ManagerNowSection.onNavigateModule` (required there). */
-    readonly onNavigateModule: (moduleKey: 'manifest' | 'rooming' | 'checklist' | 'docs' | 'closing-day') => void;
+    /** An analytics/URL-sync MIRROR, not the navigation itself — optional for
+     * the same reason `onOpenTraveller` is, and unlike the four required
+     * callbacks below. `ManagerNowSection.onNavigateModule` is required there
+     * and is satisfied by this Surface's own `handleNavigateModule`, which maps
+     * every key onto a real `ManagerTripTabKey` and performs the navigation
+     * directly. Omit it and the quick-link chips still work; you lose only the
+     * host-side hook. */
+    readonly onNavigateModule?: (moduleKey: ManagerModuleKey) => void;
     /** → `ManagerNowSection.onLogExpense` (required there). */
     readonly onLogExpense: () => void;
     /** → `ManagerNowSection.onCollectPayment` (required there). */