kaafil-react-uikit 0.8.0 → 0.10.0

package/dist/admin/index.d.cts

@@ -120,7 +120,14 @@ interface AgencySettingsScreenProps {
     readonly style?: KaafilTokenOverrides;
 }
 
-declare function AgencySettingsScreen({ title, subtitle, components, style, }: AgencySettingsScreenProps): 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 AgencySettingsScreen(props: AgencySettingsScreenProps): ReactNode;
 
 /** A locally-edited draft of one item — the same shape `items[]` needs to
  * become on save (`PatchChecklistTemplateRequest`'s item shape: `key`,
@@ -491,7 +498,14 @@ interface TripBookingsSectionProps {
     readonly style?: KaafilTokenOverrides;
 }
 
-declare function TripBookingsSection({ tripRef, onOpenDocuments, style, }: TripBookingsSectionProps): 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 TripBookingsSection(props: TripBookingsSectionProps): ReactNode;
 
 interface ChecklistItemRowProps {
     readonly item: ChecklistItemLiveRow;
@@ -545,7 +559,14 @@ interface TripChecklistSectionProps {
     readonly style?: KaafilTokenOverrides;
 }
 
-declare function TripChecklistSection({ tripRef, readOnly, initialPhase, onItemToggled, components, style, }: TripChecklistSectionProps): 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 TripChecklistSection(props: TripChecklistSectionProps): ReactNode;
 
 /** `Trip.eventType`, derived off the row so it cannot drift from the wire. */
 type TripEventType = AgencyTripRow['eventType'];
@@ -600,7 +621,14 @@ interface TripDocumentsSectionProps {
     readonly style?: KaafilTokenOverrides;
 }
 
-declare function TripDocumentsSection({ tripRef, style }: TripDocumentsSectionProps): 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 TripDocumentsSection(props: TripDocumentsSectionProps): ReactNode;
 
 /** An expense that is not a tombstone. A VOID is not a tombstone — the row
  * stays live with `voidedAt` set. */
@@ -622,7 +650,14 @@ interface TripExpensesSectionProps {
     readonly style?: KaafilTokenOverrides;
 }
 
-declare function TripExpensesSection({ tripRef, style }: TripExpensesSectionProps): 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 TripExpensesSection(props: TripExpensesSectionProps): ReactNode;
 
 type FloatMovementType = FloatMovementRow['type'];
 type FloatDirection = FloatMovementRow['direction'];
@@ -634,7 +669,14 @@ interface TripFloatSectionProps {
     readonly style?: KaafilTokenOverrides;
 }
 
-declare function TripFloatSection({ tripRef, style }: TripFloatSectionProps): 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 TripFloatSection(props: TripFloatSectionProps): ReactNode;
 
 interface FormRowProps {
     readonly form: TripFormRow;
@@ -669,7 +711,14 @@ interface TripFormsSectionProps {
     readonly style?: KaafilTokenOverrides;
 }
 
-declare function TripFormsSection({ tripRef, readOnly, components, style, }: TripFormsSectionProps): 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 TripFormsSection(props: TripFormsSectionProps): ReactNode;
 
 type ItineraryViewMode = 'days' | 'timeline';
 interface TripItinerarySectionProps {
@@ -689,7 +738,14 @@ interface ItineraryDayGroup {
     readonly items: readonly ItineraryItemRow[];
 }
 
-declare function TripItinerarySection({ tripRef, onOpenVendor, style, }: TripItinerarySectionProps): 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 TripItinerarySection(props: TripItinerarySectionProps): ReactNode;
 
 /** How the body is arranged. The reference's own two modes. */
 type ManifestGroupBy = 'booking_group' | 'none';
@@ -771,7 +827,14 @@ interface TripPaymentsSectionProps {
     readonly style?: KaafilTokenOverrides;
 }
 
-declare function TripPaymentsSection({ tripRef, balance, style, }: TripPaymentsSectionProps): 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 TripPaymentsSection(props: TripPaymentsSectionProps): ReactNode;
 
 /** A stop that is not a tombstone. */
 type PickupStopLiveRow = Exclude<PickupStopDeltaRow, {
@@ -804,7 +867,14 @@ interface TripPickupsSectionProps {
     readonly style?: KaafilTokenOverrides;
 }
 
-declare function TripPickupsSection({ tripRef, timeZone, tripStartIso, style, }: TripPickupsSectionProps): 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 TripPickupsSection(props: TripPickupsSectionProps): ReactNode;
 
 /** A room that is not a tombstone. */
 type RoomingRoomLiveRow = Exclude<RoomingRoomDeltaRow, {
@@ -847,7 +917,14 @@ interface TripRoomingSectionProps {
     readonly style?: KaafilTokenOverrides;
 }
 
-declare function TripRoomingSection({ tripRef, timeZone, tripStartIso, tripEndIso, style, }: TripRoomingSectionProps): 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 TripRoomingSection(props: TripRoomingSectionProps): ReactNode;
 
 type VendorCategory = TripVendorRow['category'];
 /** Where one supplier is used on this trip. A count is `undefined`, never 0,
@@ -871,7 +948,14 @@ interface TripSuppliersSectionProps {
     readonly style?: KaafilTokenOverrides;
 }
 
-declare function TripSuppliersSection({ tripRef, style }: TripSuppliersSectionProps): 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 TripSuppliersSection(props: TripSuppliersSectionProps): ReactNode;
 
 /** A vehicle that is not a tombstone. */
 type SeatingVehicleLiveRow = Exclude<SeatingVehicleDeltaRow, {
@@ -901,7 +985,14 @@ interface TripVehiclesSectionProps {
     readonly style?: KaafilTokenOverrides;
 }
 
-declare function TripVehiclesSection({ tripRef, durationDays, style, }: TripVehiclesSectionProps): 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 TripVehiclesSection(props: TripVehiclesSectionProps): ReactNode;
 
 /** Every panel this surface can show. Ordered by `TAB_ORDER` in
  * `internal/tripTabRegistry.tsx`, never by this union's declaration order. */
@@ -956,7 +1047,14 @@ interface TripKpiCell {
     readonly tone?: 'pos' | 'warn' | 'mute';
 }
 
-declare function TripWorkspace({ tripRef, initialTab, onBack, onOpenTravellerProfile, panels, components, style, }: TripWorkspaceProps): 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 TripWorkspace(props: TripWorkspaceProps): ReactNode;
 
 /** A registry key (hard rule #8), never an inline SVG passed per-item —
  * `AdminShell` owns its own icon set, matching `ManagerShell`'s own fixed

package/dist/admin/index.d.ts

@@ -120,7 +120,14 @@ interface AgencySettingsScreenProps {
     readonly style?: KaafilTokenOverrides;
 }
 
-declare function AgencySettingsScreen({ title, subtitle, components, style, }: AgencySettingsScreenProps): 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 AgencySettingsScreen(props: AgencySettingsScreenProps): ReactNode;
 
 /** A locally-edited draft of one item — the same shape `items[]` needs to
  * become on save (`PatchChecklistTemplateRequest`'s item shape: `key`,
@@ -491,7 +498,14 @@ interface TripBookingsSectionProps {
     readonly style?: KaafilTokenOverrides;
 }
 
-declare function TripBookingsSection({ tripRef, onOpenDocuments, style, }: TripBookingsSectionProps): 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 TripBookingsSection(props: TripBookingsSectionProps): ReactNode;
 
 interface ChecklistItemRowProps {
     readonly item: ChecklistItemLiveRow;
@@ -545,7 +559,14 @@ interface TripChecklistSectionProps {
     readonly style?: KaafilTokenOverrides;
 }
 
-declare function TripChecklistSection({ tripRef, readOnly, initialPhase, onItemToggled, components, style, }: TripChecklistSectionProps): 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 TripChecklistSection(props: TripChecklistSectionProps): ReactNode;
 
 /** `Trip.eventType`, derived off the row so it cannot drift from the wire. */
 type TripEventType = AgencyTripRow['eventType'];
@@ -600,7 +621,14 @@ interface TripDocumentsSectionProps {
     readonly style?: KaafilTokenOverrides;
 }
 
-declare function TripDocumentsSection({ tripRef, style }: TripDocumentsSectionProps): 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 TripDocumentsSection(props: TripDocumentsSectionProps): ReactNode;
 
 /** An expense that is not a tombstone. A VOID is not a tombstone — the row
  * stays live with `voidedAt` set. */
@@ -622,7 +650,14 @@ interface TripExpensesSectionProps {
     readonly style?: KaafilTokenOverrides;
 }
 
-declare function TripExpensesSection({ tripRef, style }: TripExpensesSectionProps): 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 TripExpensesSection(props: TripExpensesSectionProps): ReactNode;
 
 type FloatMovementType = FloatMovementRow['type'];
 type FloatDirection = FloatMovementRow['direction'];
@@ -634,7 +669,14 @@ interface TripFloatSectionProps {
     readonly style?: KaafilTokenOverrides;
 }
 
-declare function TripFloatSection({ tripRef, style }: TripFloatSectionProps): 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 TripFloatSection(props: TripFloatSectionProps): ReactNode;
 
 interface FormRowProps {
     readonly form: TripFormRow;
@@ -669,7 +711,14 @@ interface TripFormsSectionProps {
     readonly style?: KaafilTokenOverrides;
 }
 
-declare function TripFormsSection({ tripRef, readOnly, components, style, }: TripFormsSectionProps): 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 TripFormsSection(props: TripFormsSectionProps): ReactNode;
 
 type ItineraryViewMode = 'days' | 'timeline';
 interface TripItinerarySectionProps {
@@ -689,7 +738,14 @@ interface ItineraryDayGroup {
     readonly items: readonly ItineraryItemRow[];
 }
 
-declare function TripItinerarySection({ tripRef, onOpenVendor, style, }: TripItinerarySectionProps): 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 TripItinerarySection(props: TripItinerarySectionProps): ReactNode;
 
 /** How the body is arranged. The reference's own two modes. */
 type ManifestGroupBy = 'booking_group' | 'none';
@@ -771,7 +827,14 @@ interface TripPaymentsSectionProps {
     readonly style?: KaafilTokenOverrides;
 }
 
-declare function TripPaymentsSection({ tripRef, balance, style, }: TripPaymentsSectionProps): 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 TripPaymentsSection(props: TripPaymentsSectionProps): ReactNode;
 
 /** A stop that is not a tombstone. */
 type PickupStopLiveRow = Exclude<PickupStopDeltaRow, {
@@ -804,7 +867,14 @@ interface TripPickupsSectionProps {
     readonly style?: KaafilTokenOverrides;
 }
 
-declare function TripPickupsSection({ tripRef, timeZone, tripStartIso, style, }: TripPickupsSectionProps): 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 TripPickupsSection(props: TripPickupsSectionProps): ReactNode;
 
 /** A room that is not a tombstone. */
 type RoomingRoomLiveRow = Exclude<RoomingRoomDeltaRow, {
@@ -847,7 +917,14 @@ interface TripRoomingSectionProps {
     readonly style?: KaafilTokenOverrides;
 }
 
-declare function TripRoomingSection({ tripRef, timeZone, tripStartIso, tripEndIso, style, }: TripRoomingSectionProps): 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 TripRoomingSection(props: TripRoomingSectionProps): ReactNode;
 
 type VendorCategory = TripVendorRow['category'];
 /** Where one supplier is used on this trip. A count is `undefined`, never 0,
@@ -871,7 +948,14 @@ interface TripSuppliersSectionProps {
     readonly style?: KaafilTokenOverrides;
 }
 
-declare function TripSuppliersSection({ tripRef, style }: TripSuppliersSectionProps): 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 TripSuppliersSection(props: TripSuppliersSectionProps): ReactNode;
 
 /** A vehicle that is not a tombstone. */
 type SeatingVehicleLiveRow = Exclude<SeatingVehicleDeltaRow, {
@@ -901,7 +985,14 @@ interface TripVehiclesSectionProps {
     readonly style?: KaafilTokenOverrides;
 }
 
-declare function TripVehiclesSection({ tripRef, durationDays, style, }: TripVehiclesSectionProps): 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 TripVehiclesSection(props: TripVehiclesSectionProps): ReactNode;
 
 /** Every panel this surface can show. Ordered by `TAB_ORDER` in
  * `internal/tripTabRegistry.tsx`, never by this union's declaration order. */
@@ -956,7 +1047,14 @@ interface TripKpiCell {
     readonly tone?: 'pos' | 'warn' | 'mute';
 }
 
-declare function TripWorkspace({ tripRef, initialTab, onBack, onOpenTravellerProfile, panels, components, style, }: TripWorkspaceProps): 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 TripWorkspace(props: TripWorkspaceProps): ReactNode;
 
 /** A registry key (hard rule #8), never an inline SVG passed per-item —
  * `AdminShell` owns its own icon set, matching `ManagerShell`'s own fixed