kaafil-react-uikit 0.9.0 → 0.10.1

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>, {
@@ -479,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;
@@ -533,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;
@@ -595,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;
@@ -606,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
@@ -691,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
@@ -820,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[];
@@ -858,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`),

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>, {
@@ -479,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;
@@ -533,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;
@@ -595,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;
@@ -606,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
@@ -691,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
@@ -820,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[];
@@ -858,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`),