kaafil-react-uikit 0.4.0 → 0.4.2

package/dist/{chunk-XBLAVNP3.cjs → chunk-V6UQ6GIM.cjs}

@@ -1,13 +1,15 @@
 'use strict';
 
-var chunkA7C74SJT_cjs = require('./chunk-A7C74SJT.cjs');
-var chunk6BY2NPBZ_cjs = require('./chunk-6BY2NPBZ.cjs');
-var chunk3N2EQ2KC_cjs = require('./chunk-3N2EQ2KC.cjs');
+var chunkDI77H7ED_cjs = require('./chunk-DI77H7ED.cjs');
+var chunkLO3GQFQ6_cjs = require('./chunk-LO3GQFQ6.cjs');
+var chunkCK3L6Y43_cjs = require('./chunk-CK3L6Y43.cjs');
 var react = require('react');
 var client = require('kaafil-js/client');
+var reactDom = require('react-dom');
+var jsxRuntime = require('react/jsx-runtime');
 
 function useAgencyAdminMe() {
-  const client = chunk3N2EQ2KC_cjs.useKaafilClient();
+  const client = chunkCK3L6Y43_cjs.useKaafilClient();
   const [result, setResult] = react.useState({ status: "loading" });
   react.useEffect(() => {
     let cancelled = false;
@@ -29,7 +31,7 @@ function useAgencyAdminMe() {
   return result;
 }
 function useAgencyChecklistTemplates() {
-  const client = chunk3N2EQ2KC_cjs.useKaafilClient();
+  const client = chunkCK3L6Y43_cjs.useKaafilClient();
   const [templates, setTemplates] = react.useState([]);
   const [loaded, setLoaded] = react.useState(false);
   const [lastFetchFailed, setLastFetchFailed] = react.useState(false);
@@ -89,7 +91,7 @@ function useAgencyChecklistTemplates() {
   };
 }
 function useAgencyForms() {
-  const client = chunk3N2EQ2KC_cjs.useKaafilClient();
+  const client = chunkCK3L6Y43_cjs.useKaafilClient();
   const [forms, setForms] = react.useState([]);
   const [loaded, setLoaded] = react.useState(false);
   const [lastFetchFailed, setLastFetchFailed] = react.useState(false);
@@ -245,7 +247,7 @@ function useAgencyForms() {
   };
 }
 function useAgencyJourneyTriggers() {
-  const client = chunk3N2EQ2KC_cjs.useKaafilClient();
+  const client = chunkCK3L6Y43_cjs.useKaafilClient();
   const [triggers, setTriggers] = react.useState([]);
   const [loaded, setLoaded] = react.useState(false);
   const [lastFetchFailed, setLastFetchFailed] = react.useState(false);
@@ -273,7 +275,7 @@ function useAgencyJourneyTriggers() {
   return { triggers, loaded, lastFetchFailed, refresh, patchTrigger };
 }
 function useAgencyManagerProfile(managerRef) {
-  const client = chunk3N2EQ2KC_cjs.useKaafilClient();
+  const client = chunkCK3L6Y43_cjs.useKaafilClient();
   const [read, setRead] = react.useState(void 0);
   const [readFailed, setReadFailed] = react.useState(false);
   const refresh = react.useCallback(async () => {
@@ -291,8 +293,8 @@ function useAgencyManagerProfile(managerRef) {
   return { read, readFailed, refresh };
 }
 function useAgencySettings() {
-  const client = chunk3N2EQ2KC_cjs.useKaafilClient();
-  const [document, setDocument] = react.useState(void 0);
+  const client = chunkCK3L6Y43_cjs.useKaafilClient();
+  const [document2, setDocument] = react.useState(void 0);
   const [loaded, setLoaded] = react.useState(false);
   const [lastFetchFailed, setLastFetchFailed] = react.useState(false);
   const refresh = react.useCallback(async () => {
@@ -316,10 +318,10 @@ function useAgencySettings() {
     },
     [client, refresh]
   );
-  return { document, loaded, lastFetchFailed, refresh, patchSettings };
+  return { document: document2, loaded, lastFetchFailed, refresh, patchSettings };
 }
 function useAgencyTrip(tripRef) {
-  const client = chunk3N2EQ2KC_cjs.useKaafilClient();
+  const client = chunkCK3L6Y43_cjs.useKaafilClient();
   const [read, setRead] = react.useState(void 0);
   const [readFailed, setReadFailed] = react.useState(false);
   const refresh = react.useCallback(async () => {
@@ -339,7 +341,7 @@ function useAgencyTrip(tripRef) {
 var DEFAULT_PAGE_LIMIT = 20;
 var GROUPED_PAGE_LIMIT = 100;
 function useAgencyTripManifest(tripRef) {
-  const client = chunk3N2EQ2KC_cjs.useKaafilClient();
+  const client = chunkCK3L6Y43_cjs.useKaafilClient();
   const [facets, setFacets] = react.useState(void 0);
   const mountedRef = react.useRef(true);
   react.useEffect(() => {
@@ -370,7 +372,7 @@ function useAgencyTripManifest(tripRef) {
 }
 var DEFAULT_PAGE_LIMIT2 = 20;
 function useAgencyTrips() {
-  const client = chunk3N2EQ2KC_cjs.useKaafilClient();
+  const client = chunkCK3L6Y43_cjs.useKaafilClient();
   const [segmentCounts, setSegmentCounts] = react.useState(
     void 0
   );
@@ -400,18 +402,18 @@ function useAgencyTrips() {
   );
   return { makeTripsFetch, segmentCounts };
 }
-var useBookingsInternal = chunkA7C74SJT_cjs.createDomainHook("bookings", (tripRef) => {
+var useBookingsInternal = chunkDI77H7ED_cjs.createDomainHook("bookings", (tripRef) => {
   const {
     rows: bookings,
     syncedAt,
     refreshLive
-  } = chunkA7C74SJT_cjs.useSnapshotList(tripRef, "bookings", {
+  } = chunkDI77H7ED_cjs.useSnapshotList(tripRef, "bookings", {
     live: async (liveClient, ref) => {
       const response = await liveClient.bookings.list({ tripRef: ref });
       return { rows: [...response], syncedAt: response.meta.serverTime };
     }
   });
-  const vouchersMutation = chunk3N2EQ2KC_cjs.useOfflineMutation({
+  const vouchersMutation = chunkCK3L6Y43_cjs.useOfflineMutation({
     tripRef,
     enqueue: (engine, input) => engine.enqueue({
       tripRef,
@@ -448,10 +450,10 @@ function useBookings(tripRef) {
   return useBookingsInternal(tripRef);
 }
 function useCapabilityStatuses(tripRef) {
-  const { rows, loaded } = chunk3N2EQ2KC_cjs.useCapabilityRows(tripRef);
+  const { rows, loaded } = chunkCK3L6Y43_cjs.useCapabilityRows(tripRef);
   const statuses = react.useMemo(() => {
     const map = /* @__PURE__ */ new Map();
-    for (const row of rows) map.set(row.capability, chunk3N2EQ2KC_cjs.deriveCapabilityTriple(row).status);
+    for (const row of rows) map.set(row.capability, chunkCK3L6Y43_cjs.deriveCapabilityTriple(row).status);
     return map;
   }, [rows]);
   return { statuses, loaded };
@@ -469,8 +471,8 @@ var DirectoriesWriteError = class _DirectoriesWriteError extends Error {
   }
 };
 function useDirectories(agencyRef) {
-  const client = chunk3N2EQ2KC_cjs.useKaafilClient();
-  const serverTime = chunk6BY2NPBZ_cjs.useServerTime();
+  const client = chunkCK3L6Y43_cjs.useKaafilClient();
+  const serverTime = chunkLO3GQFQ6_cjs.useServerTime();
   const makeManagersFetch = react.useCallback(
     (filters) => async (cursor) => {
       const page = await client.agencies.managers.listPage({
@@ -517,7 +519,7 @@ function useDirectories(agencyRef) {
           isLead: input.isLead
         });
       } catch (error) {
-        throw new DirectoriesWriteError(chunkA7C74SJT_cjs.classifyError(error));
+        throw new DirectoriesWriteError(chunkDI77H7ED_cjs.classifyError(error));
       }
     },
     [client]
@@ -532,7 +534,7 @@ function useDirectories(agencyRef) {
           ...input.isLead === void 0 ? {} : { isLead: input.isLead }
         });
       } catch (error) {
-        throw new DirectoriesWriteError(chunkA7C74SJT_cjs.classifyError(error));
+        throw new DirectoriesWriteError(chunkDI77H7ED_cjs.classifyError(error));
       }
     },
     [client]
@@ -545,7 +547,7 @@ function useDirectories(agencyRef) {
           managerRef: input.managerRef
         });
       } catch (error) {
-        throw new DirectoriesWriteError(chunkA7C74SJT_cjs.classifyError(error));
+        throw new DirectoriesWriteError(chunkDI77H7ED_cjs.classifyError(error));
       }
     },
     [client]
@@ -581,7 +583,7 @@ function useDirectories(agencyRef) {
         if (error instanceof DirectoriesWriteError) {
           throw error;
         }
-        throw new DirectoriesWriteError(chunkA7C74SJT_cjs.classifyError(error));
+        throw new DirectoriesWriteError(chunkDI77H7ED_cjs.classifyError(error));
       }
     },
     [client, serverTime]
@@ -597,7 +599,7 @@ function useDirectories(agencyRef) {
           externalTravellerId: input.externalTravellerId
         });
       } catch (error) {
-        throw new DirectoriesWriteError(chunkA7C74SJT_cjs.classifyError(error));
+        throw new DirectoriesWriteError(chunkDI77H7ED_cjs.classifyError(error));
       }
     },
     [client]
@@ -610,7 +612,7 @@ function useDirectories(agencyRef) {
           travellerRef: input.travellerRef
         });
       } catch (error) {
-        throw new DirectoriesWriteError(chunkA7C74SJT_cjs.classifyError(error));
+        throw new DirectoriesWriteError(chunkDI77H7ED_cjs.classifyError(error));
       }
     },
     [client]
@@ -625,7 +627,7 @@ function useDirectories(agencyRef) {
           travellerRefs: [...input.travellerRefs]
         });
       } catch (error) {
-        throw new DirectoriesWriteError(chunkA7C74SJT_cjs.classifyError(error));
+        throw new DirectoriesWriteError(chunkDI77H7ED_cjs.classifyError(error));
       }
     },
     [client]
@@ -642,7 +644,7 @@ function useDirectories(agencyRef) {
           ...input.travellerRefs !== void 0 ? { travellerRefs: [...input.travellerRefs] } : {}
         });
       } catch (error) {
-        throw new DirectoriesWriteError(chunkA7C74SJT_cjs.classifyError(error));
+        throw new DirectoriesWriteError(chunkDI77H7ED_cjs.classifyError(error));
       }
     },
     [client]
@@ -652,7 +654,7 @@ function useDirectories(agencyRef) {
       try {
         await client.trips.parties.remove({ tripRef: input.tripRef, partyId: input.partyId });
       } catch (error) {
-        throw new DirectoriesWriteError(chunkA7C74SJT_cjs.classifyError(error));
+        throw new DirectoriesWriteError(chunkDI77H7ED_cjs.classifyError(error));
       }
     },
     [client]
@@ -666,7 +668,7 @@ function useDirectories(agencyRef) {
           body: input.body
         });
       } catch (error) {
-        throw new DirectoriesWriteError(chunkA7C74SJT_cjs.classifyError(error));
+        throw new DirectoriesWriteError(chunkDI77H7ED_cjs.classifyError(error));
       }
     },
     [client]
@@ -713,7 +715,7 @@ function usePaginatedList(fetch, options) {
       setPageIndex(index);
       setError(void 0);
     } catch (caught) {
-      setError(chunkA7C74SJT_cjs.classifyError(caught));
+      setError(chunkDI77H7ED_cjs.classifyError(caught));
       setHasNext(false);
     } finally {
       setSettled(true);
@@ -744,12 +746,6 @@ function usePaginatedList(fetch, options) {
     loadPrev
   };
 }
-
-// src/core/hooks/useResolvedSetting.ts
-function useResolvedSetting(key) {
-  const config = chunk3N2EQ2KC_cjs.useRequiredContext(chunk3N2EQ2KC_cjs.ConfigContext, "useResolvedSetting", "ConfigShell");
-  return config.resolveSetting(key);
-}
 var SHARE_SECTION_KEYS = [
   "itinerary",
   "rooming",
@@ -778,7 +774,7 @@ var ShareLinkWriteError = class extends Error {
   }
 };
 function useShareLinks(tripRef, travellerRef) {
-  const client = chunk3N2EQ2KC_cjs.useKaafilClient();
+  const client = chunkCK3L6Y43_cjs.useKaafilClient();
   const [links, setLinks] = react.useState(void 0);
   const [readFailed, setReadFailed] = react.useState(false);
   const refresh = react.useCallback(async () => {
@@ -809,7 +805,7 @@ function useShareLinks(tripRef, travellerRef) {
         await refresh();
         return minted;
       } catch (error) {
-        throw new ShareLinkWriteError(chunkA7C74SJT_cjs.classifyError(error));
+        throw new ShareLinkWriteError(chunkDI77H7ED_cjs.classifyError(error));
       }
     },
     [client, tripRef, refresh]
@@ -820,7 +816,7 @@ function useShareLinks(tripRef, travellerRef) {
         await client.shareTokens.revoke({ id });
         await refresh();
       } catch (error) {
-        throw new ShareLinkWriteError(chunkA7C74SJT_cjs.classifyError(error));
+        throw new ShareLinkWriteError(chunkDI77H7ED_cjs.classifyError(error));
       }
     },
     [client, refresh]
@@ -836,7 +832,7 @@ function useShareLinks(tripRef, travellerRef) {
         });
         await refresh();
       } catch (error) {
-        throw new ShareLinkWriteError(chunkA7C74SJT_cjs.classifyError(error));
+        throw new ShareLinkWriteError(chunkDI77H7ED_cjs.classifyError(error));
       }
     },
     [client, refresh]
@@ -848,7 +844,7 @@ function useShareLinks(tripRef, travellerRef) {
         await refresh();
         return minted;
       } catch (error) {
-        throw new ShareLinkWriteError(chunkA7C74SJT_cjs.classifyError(error));
+        throw new ShareLinkWriteError(chunkDI77H7ED_cjs.classifyError(error));
       }
     },
     [client, refresh]
@@ -859,7 +855,7 @@ function useShareLinks(tripRef, travellerRef) {
         const response = await client.shareTokens.reveal({ id });
         return response.token;
       } catch (error) {
-        throw new ShareLinkWriteError(chunkA7C74SJT_cjs.classifyError(error));
+        throw new ShareLinkWriteError(chunkDI77H7ED_cjs.classifyError(error));
       }
     },
     [client]
@@ -867,7 +863,7 @@ function useShareLinks(tripRef, travellerRef) {
   return { links, readFailed, refresh, mint, revoke, patch, regenerate, reveal };
 }
 function useTravellerFormResponses(tripRef, travellerRef) {
-  const client = chunk3N2EQ2KC_cjs.useKaafilClient();
+  const client = chunkCK3L6Y43_cjs.useKaafilClient();
   const [responses, setResponses] = react.useState(
     void 0
   );
@@ -891,6 +887,504 @@ function useTravellerFormResponses(tripRef, travellerRef) {
   }, [refresh]);
   return { responses, readFailed, refresh };
 }
+var ThemeAttributesContext = react.createContext(null);
+var FAMILY_DEFAULT_FRAME = {
+  admin: "desk",
+  manager: "field",
+  traveller: "document"
+};
+var DESK_MINIMUM_CONTAINER_WIDTH_PX = 640;
+function ShadowIsolationBoundary({
+  className,
+  children
+}) {
+  const hostRef = react.useRef(null);
+  const [shadowContainer, setShadowContainer] = react.useState(null);
+  react.useEffect(() => {
+    const host = hostRef.current;
+    if (host === null) {
+      return;
+    }
+    const shadow = host.shadowRoot ?? host.attachShadow({ mode: "open" });
+    let container = shadow.querySelector("div[data-kf-shadow-content]");
+    if (container === null) {
+      container = document.createElement("div");
+      container.setAttribute("data-kf-shadow-content", "");
+      shadow.appendChild(container);
+    }
+    setShadowContainer(container);
+  }, []);
+  return /* @__PURE__ */ jsxRuntime.jsx("div", { ref: hostRef, className, "data-kf-isolation": "shadow", children: shadowContainer !== null ? reactDom.createPortal(children, shadowContainer) : null });
+}
+function useDeskMinimumWidthWarning(rootRef, frame) {
+  react.useEffect(() => {
+    if (frame !== "desk" || !chunkCK3L6Y43_cjs.isDevelopment() || typeof ResizeObserver === "undefined") {
+      return;
+    }
+    const node = rootRef.current;
+    if (node === null) {
+      return;
+    }
+    let warned = false;
+    const observer = new ResizeObserver((entries) => {
+      const entry = entries[0];
+      if (entry === void 0 || warned) {
+        return;
+      }
+      if (entry.contentRect.width < DESK_MINIMUM_CONTAINER_WIDTH_PX) {
+        warned = true;
+        console.warn(
+          `kaafil-react-uikit: the 'desk' frame's .kf-root is narrower than the stated minimum container width (05-theming-and-branding.md \xA74.4). AppShell never auto-swaps frames \u2014 mount the manager family, or pass frame="field" explicitly, for this container.`
+        );
+      }
+    });
+    observer.observe(node);
+    return () => observer.disconnect();
+  }, [rootRef, frame]);
+}
+function useUnfilledConnectivitySlotWarning(frame, connectivitySlot) {
+  react.useEffect(() => {
+    if (frame === "field" && connectivitySlot === void 0 && chunkCK3L6Y43_cjs.isDevelopment()) {
+      console.warn(
+        `kaafil-react-uikit: AppShell's "field" frame has no connectivitySlot filled \u2014 the permanently-visible connectivity/sync region this frame reserves is empty (01-app-shell.md, briefing \xA727.2).`
+      );
+    }
+  }, [frame, connectivitySlot]);
+}
+function AppShell({
+  frame,
+  family,
+  isolation = "scoped",
+  navSlot,
+  actionBarSlot,
+  connectivitySlot,
+  children,
+  style
+}) {
+  const themeAttributes = react.useContext(ThemeAttributesContext);
+  const rootRef = react.useRef(null);
+  const resolvedFrame = frame ?? (family !== void 0 ? FAMILY_DEFAULT_FRAME[family] : "document");
+  useDeskMinimumWidthWarning(rootRef, resolvedFrame);
+  useUnfilledConnectivitySlotWarning(resolvedFrame, connectivitySlot);
+  const dataAttributes = {
+    "data-kf-frame": resolvedFrame
+  };
+  if (family !== void 0) {
+    dataAttributes["data-kf-family"] = family;
+  }
+  if (themeAttributes !== null) {
+    dataAttributes["data-kf-theme"] = themeAttributes.theme;
+    if (themeAttributes.density !== void 0) {
+      dataAttributes["data-kf-density"] = themeAttributes.density;
+    }
+  }
+  const content = /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
+    resolvedFrame === "desk" && navSlot !== void 0 ? /* @__PURE__ */ jsxRuntime.jsx("div", { className: "kf-app-shell__nav", children: navSlot }) : null,
+    /* @__PURE__ */ jsxRuntime.jsx("div", { className: "kf-app-shell__content", children }),
+    resolvedFrame === "field" && actionBarSlot !== void 0 ? /* @__PURE__ */ jsxRuntime.jsx("div", { className: "kf-app-shell__action-bar", children: actionBarSlot }) : null,
+    resolvedFrame === "field" && connectivitySlot !== void 0 ? /* @__PURE__ */ jsxRuntime.jsx("div", { className: "kf-app-shell__connectivity", children: connectivitySlot }) : null,
+    /* @__PURE__ */ jsxRuntime.jsx("div", { className: "kf-app-shell__live-region", role: "status", "aria-live": "polite" })
+  ] });
+  if (isolation === "shadow") {
+    return /* @__PURE__ */ jsxRuntime.jsx(
+      "div",
+      {
+        ref: rootRef,
+        className: "kf-root",
+        "data-kf-isolation": "shadow",
+        ...dataAttributes,
+        style: chunkCK3L6Y43_cjs.tokenStyle(style),
+        children: /* @__PURE__ */ jsxRuntime.jsx(ShadowIsolationBoundary, { className: "kf-app-shell__shadow-host", children: content })
+      }
+    );
+  }
+  return /* @__PURE__ */ jsxRuntime.jsx(
+    "div",
+    {
+      ref: rootRef,
+      className: "kf-root",
+      "data-kf-isolation": "scoped",
+      ...dataAttributes,
+      style: chunkCK3L6Y43_cjs.tokenStyle(style),
+      children: content
+    }
+  );
+}
+function ConfigShell({ seedConfig = {}, children }) {
+  const value = react.useMemo(
+    () => ({
+      resolveSetting(key) {
+        const agencyValue = seedConfig.agency?.[key];
+        if (agencyValue !== void 0) {
+          return agencyValue;
+        }
+        const tenantValue = seedConfig.tenant?.[key];
+        return tenantValue === void 0 ? void 0 : tenantValue;
+      }
+    }),
+    [seedConfig.agency, seedConfig.tenant]
+  );
+  return /* @__PURE__ */ jsxRuntime.jsx(chunkCK3L6Y43_cjs.ConfigContext.Provider, { value, children });
+}
+function classifyForFallback(error) {
+  const classification = chunkDI77H7ED_cjs.classifyError(error);
+  if (classification.code === "RESOURCE_NOT_FOUND") {
+    return { classification: "isolation", code: classification.code };
+  }
+  if (classification.path === "parked" || classification.unsatisfiableScheme) {
+    return { classification: "parked", code: classification.code };
+  }
+  return { classification: "retryable", code: classification.code };
+}
+var FALLBACK_STYLE = {
+  fontFamily: "system-ui, sans-serif",
+  padding: "1.5rem",
+  border: "1px solid #999",
+  borderRadius: "4px",
+  color: "#1a1a1a",
+  background: "#fff"
+};
+function DefaultFallback({
+  ctx,
+  onRetry
+}) {
+  const role = ctx.classification === "retryable" ? "status" : "alert";
+  const ariaLive = ctx.classification === "retryable" ? "polite" : "assertive";
+  const message = ctx.classification === "isolation" ? "Not found." : ctx.classification === "parked" ? "This action can't be completed right now." : "Something went wrong.";
+  return /* @__PURE__ */ jsxRuntime.jsxs("div", { style: FALLBACK_STYLE, role, "aria-live": ariaLive, children: [
+    /* @__PURE__ */ jsxRuntime.jsx("p", { style: { margin: 0 }, children: message }),
+    ctx.classification === "retryable" ? /* @__PURE__ */ jsxRuntime.jsx("button", { type: "button", onClick: onRetry, style: { marginTop: "0.75rem" }, children: "Try again" }) : null
+  ] });
+}
+var ErrorShell = class extends react.Component {
+  state = { caught: null, retryKey: 0 };
+  static getDerivedStateFromError(error) {
+    return { caught: { error } };
+  }
+  handleRetry = () => {
+    this.setState((current) => ({ caught: null, retryKey: current.retryKey + 1 }));
+  };
+  render() {
+    if (this.state.caught !== null) {
+      const ctx = classifyForFallback(this.state.caught.error);
+      if (this.props.fallbackSlot !== void 0) {
+        return this.props.fallbackSlot(ctx);
+      }
+      return /* @__PURE__ */ jsxRuntime.jsx(DefaultFallback, { ctx, onRetry: this.handleRetry });
+    }
+    return /* @__PURE__ */ jsxRuntime.jsx(react.Fragment, { children: this.props.children }, this.state.retryKey);
+  }
+};
+var SessionExpiryBridgeContext = react.createContext(void 0);
+function OfflineShell({
+  storage,
+  blob,
+  conflictResolver,
+  readEntity,
+  scope,
+  children
+}) {
+  const client = react.useContext(chunkCK3L6Y43_cjs.KaafilClientContext);
+  const persona = chunkCK3L6Y43_cjs.usePersona();
+  const session = chunkCK3L6Y43_cjs.useSession();
+  const reportExpired = react.useContext(SessionExpiryBridgeContext);
+  const [engine, setEngine] = react.useState(null);
+  const engineRef = react.useRef(null);
+  const derivedScope = scope ?? `${persona}:${session.agencyRef ?? "share"}`;
+  react.useEffect(() => {
+    if (session.status !== "authenticated" || client === null) {
+      return;
+    }
+    const newEngine = client.openOffline({
+      storage,
+      scope: derivedScope,
+      ...readEntity !== void 0 ? { readEntity } : {},
+      ...conflictResolver !== void 0 ? { conflictResolver } : {},
+      ...blob !== void 0 ? { blob } : {}
+      // GAP flagged in this phase's report: a share session's local
+      // `expiresAt` enforcement (`OpenOfflineOptions.share`,
+      // `07-offline-and-sync.md §8`) needs an `expiresAt` this shell has no
+      // source for yet — it is not on `useSession()`'s derived shape and no
+      // prop carries it. Omitted here rather than guessed; a share engine
+      // opens without the local expiry/grace/purge enforcement until that
+      // value has a wire source.
+    });
+    engineRef.current = newEngine;
+    let opened = false;
+    let disposed = false;
+    void newEngine.open().then(() => {
+      opened = true;
+      if (disposed) {
+        newEngine.close();
+        return;
+      }
+      if (engineRef.current === newEngine) setEngine(newEngine);
+    }).catch(() => {
+      if (!disposed && engineRef.current === newEngine) setEngine(null);
+    });
+    const unsubscribeSessionExpired = persona !== "share" ? newEngine.events.on("session.expired", () => reportExpired?.("session")) : void 0;
+    const unsubscribeShareExpired = persona === "share" ? newEngine.events.on("share.expired", () => reportExpired?.("share")) : void 0;
+    const unsubscribeShareRevoked = persona === "share" ? newEngine.events.on("share.revoked", () => reportExpired?.("share")) : void 0;
+    return () => {
+      unsubscribeSessionExpired?.();
+      unsubscribeShareExpired?.();
+      unsubscribeShareRevoked?.();
+      disposed = true;
+      if (opened) newEngine.close();
+      if (engineRef.current === newEngine) {
+        engineRef.current = null;
+      }
+    };
+  }, [client, derivedScope, session.status, persona, reportExpired]);
+  return /* @__PURE__ */ jsxRuntime.jsx(chunkCK3L6Y43_cjs.OfflineEngineContext.Provider, { value: engine, children });
+}
+
+// src/core/shells/internal/jwtKind.ts
+function base64UrlDecode(segment) {
+  const padded = segment.replace(/-/g, "+").replace(/_/g, "/");
+  const withPadding = padded + "=".repeat((4 - padded.length % 4) % 4);
+  return atob(withPadding);
+}
+function decodeManagerOrAgencyAdminKind(accessToken) {
+  const segments = accessToken.split(".");
+  const payloadSegment = segments[1];
+  if (segments.length !== 3 || payloadSegment === void 0) {
+    throw new Error(
+      'SessionShell could not parse "accessToken" as a JWT \u2014 it does not have the three dot-separated segments every manager/agencyAdmin session token has.'
+    );
+  }
+  let claim;
+  try {
+    claim = JSON.parse(base64UrlDecode(payloadSegment));
+  } catch {
+    throw new Error(
+      `SessionShell could not decode "accessToken"'s payload segment as JSON \u2014 the value handed to <KaafilUIKitProvider accessToken> is not a well-formed JWT.`
+    );
+  }
+  const kind = claim.kind;
+  if (kind === "agencyAdmin") {
+    return "agencyAdmin";
+  }
+  if (kind === "managerSession" || kind === "manager") {
+    return "managerSession";
+  }
+  throw new Error(
+    `SessionShell read an unrecognised "kind" claim ("${String(kind)}") off "accessToken" \u2014 expected the manager or agencyAdmin session JWT shape (00-decisions.md U-003).`
+  );
+}
+async function resolveCredential(props) {
+  if (props.credentialResolver !== void 0) {
+    const resolved = await props.credentialResolver();
+    if ("shareToken" in resolved) {
+      return { kind: "share", shareToken: resolved.shareToken };
+    }
+    const kind2 = decodeManagerOrAgencyAdminKind(resolved.accessToken) === "agencyAdmin" ? "agencyAdmin" : "manager";
+    return { kind: kind2, ...resolved };
+  }
+  if (props.shareToken !== void 0) {
+    return { kind: "share", shareToken: props.shareToken };
+  }
+  const kind = decodeManagerOrAgencyAdminKind(props.accessToken) === "agencyAdmin" ? "agencyAdmin" : "manager";
+  return {
+    kind,
+    accessToken: props.accessToken,
+    refreshToken: props.refreshToken,
+    agencyRef: props.agencyRef
+  };
+}
+function SessionShell(props) {
+  const { environment = "live", onRefresh, onSessionExpired, children } = props;
+  const [state, setState] = react.useState(null);
+  const expiredCallbackFiredRef = react.useRef(false);
+  const currentPersonaRef = react.useRef("manager");
+  const reportExpired = react.useCallback(() => {
+    if (expiredCallbackFiredRef.current) {
+      return;
+    }
+    expiredCallbackFiredRef.current = true;
+    onSessionExpired?.(currentPersonaRef.current);
+    setState(
+      (current) => current === null ? current : { ...current, session: { ...current.session, status: "expired" } }
+    );
+  }, [onSessionExpired]);
+  const accessTokenDep = "accessToken" in props ? props.accessToken : void 0;
+  const refreshTokenDep = "refreshToken" in props ? props.refreshToken : void 0;
+  const agencyRefDep = "agencyRef" in props ? props.agencyRef : void 0;
+  const shareTokenDep = "shareToken" in props ? props.shareToken : void 0;
+  react.useEffect(() => {
+    let cancelled = false;
+    const client$1 = new client.KaafilClient({ environment });
+    expiredCallbackFiredRef.current = false;
+    async function open() {
+      const credential = await resolveCredential(props);
+      if (cancelled) {
+        return;
+      }
+      currentPersonaRef.current = credential.kind;
+      if (credential.kind === "share") {
+        client$1.share.open({ token: credential.shareToken });
+      } else if (credential.kind === "agencyAdmin") {
+        client$1.admin.open({
+          accessToken: credential.accessToken,
+          refreshToken: credential.refreshToken,
+          agencyRef: credential.agencyRef,
+          ...onRefresh !== void 0 ? { onRefresh } : {}
+        });
+      } else {
+        client$1.session.open({
+          accessToken: credential.accessToken,
+          refreshToken: credential.refreshToken,
+          agencyRef: credential.agencyRef,
+          ...onRefresh !== void 0 ? { onRefresh } : {}
+        });
+      }
+      setState({
+        client: client$1,
+        session: {
+          status: "authenticated",
+          persona: credential.kind,
+          agencyRef: credential.agencyRef,
+          environment
+        }
+      });
+    }
+    void open();
+    return () => {
+      cancelled = true;
+      client$1.close();
+    };
+  }, [environment, accessTokenDep, refreshTokenDep, agencyRefDep, shareTokenDep]);
+  if (state === null) {
+    return /* @__PURE__ */ jsxRuntime.jsx(SessionExpiryBridgeContext.Provider, { value: reportExpired, children: /* @__PURE__ */ jsxRuntime.jsx(
+      chunkCK3L6Y43_cjs.SessionContext.Provider,
+      {
+        value: { status: "opening", persona: "manager", agencyRef: void 0, environment },
+        children
+      }
+    ) });
+  }
+  return /* @__PURE__ */ jsxRuntime.jsx(SessionExpiryBridgeContext.Provider, { value: reportExpired, children: /* @__PURE__ */ jsxRuntime.jsx(chunkCK3L6Y43_cjs.KaafilClientContext.Provider, { value: state.client, children: /* @__PURE__ */ jsxRuntime.jsx(chunkCK3L6Y43_cjs.SessionContext.Provider, { value: state.session, children }) }) });
+}
+function emit(onEvent, event) {
+  if (onEvent === void 0) {
+    return;
+  }
+  try {
+    onEvent(event);
+  } catch {
+  }
+}
+function TelemetryShell({ onEvent, children }) {
+  const session = chunkCK3L6Y43_cjs.useSession();
+  const serverTime = chunkLO3GQFQ6_cjs.useServerTime();
+  const previousStatusRef = react.useRef(void 0);
+  react.useEffect(() => {
+    const previousStatus = previousStatusRef.current;
+    if (serverTime.sinceLastSync !== void 0) {
+      if (session.status === "authenticated" && previousStatus !== "authenticated") {
+        emit(onEvent, {
+          type: "session.opened",
+          timestamp: serverTime.now(),
+          persona: session.persona
+        });
+      }
+      if (session.status === "expired" && previousStatus !== "expired") {
+        emit(onEvent, {
+          type: "session.expired",
+          timestamp: serverTime.now(),
+          persona: session.persona
+        });
+      }
+    }
+    previousStatusRef.current = session.status;
+  }, [session.status, serverTime.sinceLastSync]);
+  return /* @__PURE__ */ jsxRuntime.jsx(jsxRuntime.Fragment, { children });
+}
+function resolveSystemTheme() {
+  if (typeof window === "undefined" || typeof window.matchMedia !== "function") {
+    return "light";
+  }
+  return window.matchMedia("(prefers-color-scheme: dark)").matches ? "dark" : "light";
+}
+function ThemeShell({ theme = "system", density, children }) {
+  const [systemTheme, setSystemTheme] = react.useState(
+    () => theme === "system" ? resolveSystemTheme() : theme
+  );
+  react.useEffect(() => {
+    if (theme !== "system" || typeof window === "undefined" || typeof window.matchMedia !== "function") {
+      return;
+    }
+    const query = window.matchMedia("(prefers-color-scheme: dark)");
+    const listener = (event) => {
+      setSystemTheme(event.matches ? "dark" : "light");
+    };
+    query.addEventListener("change", listener);
+    return () => query.removeEventListener("change", listener);
+  }, [theme]);
+  const resolvedTheme = theme === "system" ? systemTheme : theme;
+  const value = react.useMemo(() => ({ theme: resolvedTheme, density }), [resolvedTheme, density]);
+  return /* @__PURE__ */ jsxRuntime.jsx(ThemeAttributesContext.Provider, { value, children });
+}
+var DefaultCapabilityViewsContext = react.createContext({});
+function useDefaultCapabilityViews() {
+  return react.useContext(DefaultCapabilityViewsContext);
+}
+var BuildShareUrlContext = react.createContext(null);
+function useBuildShareUrl() {
+  return react.useContext(BuildShareUrlContext);
+}
+function KaafilUIKitProvider(props) {
+  const {
+    environment,
+    onSessionExpired,
+    density,
+    theme,
+    brand,
+    locale,
+    isolation,
+    onEvent,
+    storage,
+    blob,
+    conflictResolver,
+    readEntity,
+    offlineScope,
+    seedConfig,
+    defaultCapabilityViews,
+    buildShareUrl,
+    children,
+    ...credential
+  } = props;
+  const inner = /* @__PURE__ */ jsxRuntime.jsx(BuildShareUrlContext.Provider, { value: buildShareUrl ?? null, children: /* @__PURE__ */ jsxRuntime.jsx(DefaultCapabilityViewsContext.Provider, { value: defaultCapabilityViews ?? {}, children: /* @__PURE__ */ jsxRuntime.jsx(ConfigShell, { seedConfig, children: /* @__PURE__ */ jsxRuntime.jsx(
+    chunkCK3L6Y43_cjs.BrandShell,
+    {
+      appName: brand?.appName,
+      logo: brand?.logo,
+      logoMark: brand?.logoMark,
+      favicon: brand?.favicon,
+      headStrategy: brand?.headStrategy,
+      children: /* @__PURE__ */ jsxRuntime.jsx(TelemetryShell, { onEvent, children })
+    }
+  ) }) }) });
+  return /* @__PURE__ */ jsxRuntime.jsx(ErrorShell, { children: /* @__PURE__ */ jsxRuntime.jsx(ThemeShell, { theme, density, children: /* @__PURE__ */ jsxRuntime.jsx(chunkCK3L6Y43_cjs.I18nShell, { locale, children: /* @__PURE__ */ jsxRuntime.jsx(AppShell, { isolation, children: /* @__PURE__ */ jsxRuntime.jsx(
+    SessionShell,
+    {
+      ...credential,
+      environment,
+      onSessionExpired,
+      children: storage !== void 0 ? /* @__PURE__ */ jsxRuntime.jsx(
+        OfflineShell,
+        {
+          storage,
+          blob,
+          conflictResolver,
+          readEntity,
+          scope: offlineScope,
+          children: inner
+        }
+      ) : inner
+    }
+  ) }) }) }) });
+}
 
 // src/core/routing/deepLinks.ts
 var CLOSEOUT_ACTION_TAB = {
@@ -972,7 +1466,15 @@ var TRIP_TAB_KEY_SET = {
   forms: true
 };
 
+exports.AppShell = AppShell;
 exports.CLOSEOUT_ACTION_TAB = CLOSEOUT_ACTION_TAB;
+exports.ConfigShell = ConfigShell;
+exports.ErrorShell = ErrorShell;
+exports.KaafilUIKitProvider = KaafilUIKitProvider;
+exports.OfflineShell = OfflineShell;
+exports.SessionShell = SessionShell;
+exports.TelemetryShell = TelemetryShell;
+exports.ThemeShell = ThemeShell;
 exports.familySafeSections = familySafeSections;
 exports.fromSearchParams = fromSearchParams;
 exports.isTripTabKey = isTripTabKey;
@@ -988,11 +1490,12 @@ exports.useAgencyTrip = useAgencyTrip;
 exports.useAgencyTripManifest = useAgencyTripManifest;
 exports.useAgencyTrips = useAgencyTrips;
 exports.useBookings = useBookings;
+exports.useBuildShareUrl = useBuildShareUrl;
 exports.useCapabilityStatuses = useCapabilityStatuses;
+exports.useDefaultCapabilityViews = useDefaultCapabilityViews;
 exports.useDirectories = useDirectories;
 exports.usePaginatedList = usePaginatedList;
-exports.useResolvedSetting = useResolvedSetting;
 exports.useShareLinks = useShareLinks;
 exports.useTravellerFormResponses = useTravellerFormResponses;
-//# sourceMappingURL=chunk-XBLAVNP3.cjs.map
-//# sourceMappingURL=chunk-XBLAVNP3.cjs.map
+//# sourceMappingURL=chunk-V6UQ6GIM.cjs.map
+//# sourceMappingURL=chunk-V6UQ6GIM.cjs.map