kaafil-react-uikit 0.1.0 → 0.3.0

package/dist/admin/index.js

@@ -1,8 +1,8 @@
-import { useAgencySettings, useAgencyChecklistTemplates, useAgencyForms, useAgencyManagerProfile, useAgencyJourneyTriggers, useBookings, useDirectories, useCapabilityStatuses, useAgencyTrip, useAgencyAdminMe, useTravellerFormResponses, familySafeSections, useShareLinks, usePaginatedList, useAgencyTrips, useAgencyTripManifest, resolveBlockerDeepLink } from '../chunk-FFXGZZGJ.js';
-import { useChecklists, useFiles, useExpenses, useVendors, useFloat, useManagers, useForms, useItinerary, useCollections, useParties, usePickups, useRooming, useSeating, classifyError, useTravellerProfile, roomingHeuristicSeverity, useManagerToday, useCloseout, parseRoomingTone, TONE_FAMILIES, SHADES_PER_FAMILY, FALLBACK_GLYPH } from '../chunk-7WXE5SUS.js';
-import '../chunk-JMWXQTE3.js';
-export { BootErrorScreen, LockedTripScreen, NotFoundScreen, OfflineFallbackScreen, PlanLockedScreen, SessionExpiredScreen } from '../chunk-PYETPKTT.js';
-import { createRegistry, useKaafilChrome, tokenStyle, useSession, useKaafilClient } from '../chunk-2SRBJ4H7.js';
+import { useAgencySettings, useAgencyChecklistTemplates, useAgencyForms, useAgencyManagerProfile, useAgencyJourneyTriggers, useBookings, useDirectories, useCapabilityStatuses, useAgencyTrip, useAgencyAdminMe, useTravellerFormResponses, familySafeSections, useShareLinks, usePaginatedList, useAgencyTrips, useAgencyTripManifest, resolveBlockerDeepLink } from '../chunk-YTSYRLGS.js';
+import { useChecklists, useFiles, useExpenses, useVendors, useFloat, useManagers, useForms, useItinerary, useCollections, useParties, usePickups, useRooming, useSeating, classifyError, useTravellerProfile, roomingHeuristicSeverity, useManagerToday, useCloseout, parseRoomingTone, TONE_FAMILIES, SHADES_PER_FAMILY, FALLBACK_GLYPH } from '../chunk-WTTGPWMR.js';
+import '../chunk-VLP323AD.js';
+export { BootErrorScreen, LockedTripScreen, NotFoundScreen, OfflineFallbackScreen, PlanLockedScreen, SessionExpiredScreen } from '../chunk-GJ2J3PYN.js';
+import { createRegistry, useKaafilChrome, tokenStyle, useSession, useKaafilClient } from '../chunk-A4Z2YBEF.js';
 import { useState, useEffect, useCallback, useMemo, useId, useRef, Children } from 'react';
 import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
 

package/dist/{chunk-YHOQRKDJ.cjs → chunk-57SUK3GD.cjs}

@@ -1,12 +1,12 @@
 'use strict';
 
-var chunkV36WWMTF_cjs = require('./chunk-V36WWMTF.cjs');
+var chunkUALMCHNW_cjs = require('./chunk-UALMCHNW.cjs');
 var react = require('react');
 var jsxRuntime = require('react/jsx-runtime');
 
 // src/core/hooks/useOfflineEngine.ts
 function useOfflineEngine() {
-  return chunkV36WWMTF_cjs.useRequiredContext(chunkV36WWMTF_cjs.OfflineEngineContext, "useOfflineEngine", "OfflineShell");
+  return chunkUALMCHNW_cjs.useRequiredContext(chunkUALMCHNW_cjs.OfflineEngineContext, "useOfflineEngine", "OfflineShell");
 }
 var BrandAssetsContext = react.createContext(null);
 function useKaafilBrand() {
@@ -68,14 +68,14 @@ function BrandShell({
   headStrategy = "none",
   children
 }) {
-  const persona = chunkV36WWMTF_cjs.usePersona();
+  const persona = chunkUALMCHNW_cjs.usePersona();
   const assets = react.useMemo(
     () => ({ appName, logo, logoMark, favicon }),
     [appName, logo, logoMark, favicon]
   );
   const rejectedOwnPage = headStrategy === "own-page" && persona !== "share";
   react.useEffect(() => {
-    if (headStrategy === "own-page" && persona !== "share" && chunkV36WWMTF_cjs.isDevelopment()) {
+    if (headStrategy === "own-page" && persona !== "share" && chunkUALMCHNW_cjs.isDevelopment()) {
       throw new Error(
         `BrandShell: headStrategy="own-page" was requested under a non-share persona ("${persona}") \u2014 only the traveller/share surface may own document.head (00-decisions.md U-005). Falls back to "none" in production.`
       );
@@ -86,7 +86,7 @@ function BrandShell({
     // work under every `headStrategy` and warning about it told integrators
     // their correct code was wrong. `favicon` has no in-page use at all, so
     // passing one under `'none'` genuinely is a no-op worth flagging.
-    favicon !== void 0 && chunkV36WWMTF_cjs.isDevelopment()) {
+    favicon !== void 0 && chunkUALMCHNW_cjs.isDevelopment()) {
       console.warn(
         'BrandShell: headStrategy="none" (the default) is a hard no-op \u2014 "favicon" was passed but document.head is never touched under "none" (00-decisions.md U-005). "appName" is unaffected: it still feeds the in-page brand fallback.'
       );
@@ -106,5 +106,5 @@ exports.BrandShell = BrandShell;
 exports.useKaafilBrand = useKaafilBrand;
 exports.useKaafilShareMeta = useKaafilShareMeta;
 exports.useOfflineEngine = useOfflineEngine;
-//# sourceMappingURL=chunk-YHOQRKDJ.cjs.map
-//# sourceMappingURL=chunk-YHOQRKDJ.cjs.map
+//# sourceMappingURL=chunk-57SUK3GD.cjs.map
+//# sourceMappingURL=chunk-57SUK3GD.cjs.map

package/dist/{chunk-YHOQRKDJ.cjs.map → chunk-57SUK3GD.cjs.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/core/hooks/useOfflineEngine.ts","../src/core/shells/BrandShell.tsx"],"names":["useRequiredContext","OfflineEngineContext","createContext","useContext","useEffect","usePersona","useMemo","isDevelopment","jsxs"],"mappings":";;;;;;;AAgBO,SAAS,gBAAA,GAAkC;AAChD,EAAA,OAAOA,oCAAA,CAAmBC,sCAAA,EAAsB,kBAAA,EAAoB,cAAc,CAAA;AACpF;ACYA,IAAM,kBAAA,GAAqBC,oBAAwC,IAAI,CAAA;AAKhE,SAAS,cAAA,GAAoC;AAClD,EAAA,OAAOC,gBAAA,CAAW,kBAAkB,CAAA,IAAK,EAAC;AAC5C;AAWA,SAAS,iBAAiB,MAAA,EAAsC;AAC9D,EAAA,OAAO;AAAA,IACL,OAAO,MAAA,CAAO,OAAA;AAAA,IACd,SAAS,MAAA,CAAO,OAAA;AAAA,IAChB,SAAS,MAAA,CAAO,OAAA;AAAA,IAChB,aAAA,EAAe,MAAA;AAAA,IACf,OAAA,EAAS,MAAA;AAAA;AAAA;AAAA;AAAA,IAIT,MAAA,EAAQ;AAAA,GACV;AACF;AAMA,SAAS,kBAAA,CAAmB,EAAE,IAAA,EAAK,EAAuC;AACxE,EAAAC,eAAA,CAAU,MAAM;AACd,IAAA,IAAI,IAAA,CAAK,UAAU,MAAA,EAAW;AAC5B,MAAA,QAAA,CAAS,QAAQ,IAAA,CAAK,KAAA;AAAA,IACxB;AACA,IAAA,IAAI,IAAA,CAAK,YAAY,MAAA,EAAW;AAC9B,MAAA,IAAI,IAAA,GAAO,QAAA,CAAS,aAAA,CAA+B,iCAAiC,CAAA;AACpF,MAAA,IAAI,SAAS,IAAA,EAAM;AACjB,QAAA,IAAA,GAAO,QAAA,CAAS,cAAc,MAAM,CAAA;AACpC,QAAA,IAAA,CAAK,GAAA,GAAM,MAAA;AACX,QAAA,IAAA,CAAK,YAAA,CAAa,iBAAiB,EAAE,CAAA;AACrC,QAAA,QAAA,CAAS,IAAA,CAAK,YAAY,IAAI,CAAA;AAAA,MAChC;AACA,MAAA,IAAA,CAAK,OAAO,IAAA,CAAK,OAAA;AAAA,IACnB;AACA,IAAA,MAAM,OAAA,GAAU,CACd,IAAA,EACA,OAAA,EACA,OAA4B,MAAA,KACnB;AACT,MAAA,IAAI,YAAY,MAAA,EAAW;AACzB,QAAA;AAAA,MACF;AACA,MAAA,IAAI,MAAM,QAAA,CAAS,aAAA,CAA+B,QAAQ,IAAI,CAAA,EAAA,EAAK,IAAI,CAAA,iBAAA,CAAmB,CAAA;AAC1F,MAAA,IAAI,QAAQ,IAAA,EAAM;AAChB,QAAA,GAAA,GAAM,QAAA,CAAS,cAAc,MAAM,CAAA;AACnC,QAAA,GAAA,CAAI,YAAA,CAAa,MAAM,IAAI,CAAA;AAC3B,QAAA,GAAA,CAAI,YAAA,CAAa,iBAAiB,EAAE,CAAA;AACpC,QAAA,QAAA,CAAS,IAAA,CAAK,YAAY,GAAG,CAAA;AAAA,MAC/B;AACA,MAAA,GAAA,CAAI,OAAA,GAAU,OAAA;AAAA,IAChB,CAAA;AACA,IAAA,OAAA,CAAQ,UAAA,EAAY,IAAA,CAAK,OAAA,EAAS,UAAU,CAAA;AAC5C,IAAA,OAAA,CAAQ,gBAAA,EAAkB,IAAA,CAAK,aAAA,EAAe,UAAU,CAAA;AACxD,IAAA,OAAA,CAAQ,UAAA,EAAY,IAAA,CAAK,OAAA,EAAS,UAAU,CAAA;AAC5C,IAAA,OAAA,CAAQ,QAAA,EAAU,KAAK,MAAM,CAAA;AAAA,EAC/B,CAAA,EAAG,CAAC,IAAI,CAAC,CAAA;AAET,EAAA,OAAO,IAAA;AACT;AAWO,SAAS,UAAA,CAAW;AAAA,EACzB,OAAA;AAAA,EACA,IAAA;AAAA,EACA,QAAA;AAAA,EACA,OAAA;AAAA,EACA,YAAA,GAAe,MAAA;AAAA,EACf;AACF,CAAA,EAA+B;AAC7B,EAAA,MAAM,UAAUC,4BAAA,EAAW;AAC3B,EAAA,MAAM,MAAA,GAASC,aAAA;AAAA,IACb,OAAO,EAAE,OAAA,EAAS,IAAA,EAAM,UAAU,OAAA,EAAQ,CAAA;AAAA,IAC1C,CAAC,OAAA,EAAS,IAAA,EAAM,QAAA,EAAU,OAAO;AAAA,GACnC;AAEA,EAAA,MAAM,eAAA,GAAkB,YAAA,KAAiB,UAAA,IAAc,OAAA,KAAY,OAAA;AAEnE,EAAAF,eAAA,CAAU,MAAM;AACd,IAAA,IAAI,YAAA,KAAiB,UAAA,IAAc,OAAA,KAAY,OAAA,IAAWG,iCAAc,EAAG;AACzE,MAAA,MAAM,IAAI,KAAA;AAAA,QACR,iFACO,OAAO,CAAA,6HAAA;AAAA,OAEhB;AAAA,IACF;AACA,IAAA,IACE,YAAA,KAAiB,MAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAOjB,OAAA,KAAY,MAAA,IACZA,+BAAA,EAAc,EACd;AAEA,MAAA,OAAA,CAAQ,IAAA;AAAA,QACN;AAAA,OAGF;AAAA,IACF;AAAA,EACF,CAAA,EAAG,CAAC,YAAA,EAAc,OAAA,EAAS,OAAO,CAAC,CAAA;AAEnC,EAAA,MAAM,aAAA,GAAgB,YAAA,KAAiB,UAAA,IAAc,OAAA,KAAY,WAAW,CAAC,eAAA;AAE7E,EAAA,uBACEC,eAAA,CAAC,kBAAA,CAAmB,QAAA,EAAnB,EAA4B,OAAO,MAAA,EACjC,QAAA,EAAA;AAAA,IAAA,aAAA,kCAAiB,kBAAA,EAAA,EAAmB,IAAA,EAAM,gBAAA,CAAiB,MAAM,GAAG,CAAA,GAAK,IAAA;AAAA,IACzE;AAAA,GAAA,EACH,CAAA;AAEJ;AASO,SAAS,mBAAmB,MAAA,EAAsC;AACvE,EAAA,OAAOF,cAAQ,MAAM,gBAAA,CAAiB,MAAM,CAAA,EAAG,CAAC,MAAM,CAAC,CAAA;AACzD","file":"chunk-YHOQRKDJ.cjs","sourcesContent":["'use client';\n\n// `08-core-hooks.md §2.1`. The escape hatch underneath every hook in §2 — a\n// composite should reach for a narrower hook before this one.\n\nimport type { OfflineEngine, OutboxOp } from 'kaafil-js/client';\nimport { OfflineEngineContext } from '../internal/contexts';\nimport { useRequiredContext } from '../internal/useRequiredContext';\n\n// Re-exported so a composite (`ManagerSyncCenterSection.types.ts`) can name\n// one outbox op's shape without importing `kaafil-js/client` directly —\n// hard rule #1.\nexport type { OutboxOp };\n\n/** Returns the engine instance `OfflineShell` opened via\n * `client.openOffline(options)`. Throws outside the provider tree. */\nexport function useOfflineEngine(): OfflineEngine {\n  return useRequiredContext(OfflineEngineContext, 'useOfflineEngine', 'OfflineShell');\n}\n","'use client';\n\n// `shells/06-brand-shell.md`. Eighth in the locked mount order\n// (`shells/README.md §2` row 8) — supplies host-side brand assets\n// (fallback chain: partner logo → neutral mark → text-only appName,\n// `05-theming-and-branding.md §8`) and, opt-in and persona-gated, controls\n// `document.head` for the traveller/share surface only. Fetches nothing\n// from the engine (`00-decisions.md` U-007 — per-agency brand assets are a\n// named non-goal for the backend).\n\nimport type { ReactNode } from 'react';\nimport { createContext, useContext, useEffect, useMemo } from 'react';\nimport { usePersona } from '../hooks/usePersona';\nimport { isDevelopment } from '../internal/isDevelopment';\n\nexport interface KaafilBrandAssets {\n  readonly appName?: string;\n  readonly logo?: string | ReactNode;\n  readonly logoMark?: string | ReactNode;\n  readonly favicon?: string;\n}\n\nexport interface BrandShellProps extends KaafilBrandAssets {\n  readonly headStrategy?: 'none' | 'own-page';\n  readonly children?: ReactNode;\n}\n\n/** Shell-owned, not a `08-core-hooks.md` catalog entry (component authoring\n * — this context's eventual consumer, a logo/header component reading the\n * fallback chain — is out of scope for this phase). */\nconst BrandAssetsContext = createContext<KaafilBrandAssets | null>(null);\n\n/** Reads the brand assets `BrandShell` forwarded, or `{}` when mounted\n * without one (never throws — brand is presentational, not load-bearing the\n * way a session read is). */\nexport function useKaafilBrand(): KaafilBrandAssets {\n  return useContext(BrandAssetsContext) ?? {};\n}\n\nexport interface ShareMeta {\n  readonly title: string | undefined;\n  readonly favicon: string | undefined;\n  readonly ogTitle: string | undefined;\n  readonly ogDescription: string | undefined;\n  readonly ogImage: string | undefined;\n  readonly robots: 'noindex' | 'index';\n}\n\nfunction resolveShareMeta(assets: KaafilBrandAssets): ShareMeta {\n  return {\n    title: assets.appName,\n    favicon: assets.favicon,\n    ogTitle: assets.appName,\n    ogDescription: undefined,\n    ogImage: undefined,\n    // Share meta defaults to noindex — a share link is private-by-obscurity;\n    // indexing it is a disclosure bug, never the shipped default\n    // (`00-decisions.md` U-005).\n    robots: 'noindex',\n  };\n}\n\n/** Only the traveller/share surface may write `document.head` — mounted\n * exclusively by `BrandShell` under a persona-permitted `'own-page'`\n * request. Renders nothing into the page body: title/meta writes are not\n * \"visual output\" in the sense `shells/README.md §1` means the phrase. */\nfunction KaafilDocumentHead({ meta }: { readonly meta: ShareMeta }): null {\n  useEffect(() => {\n    if (meta.title !== undefined) {\n      document.title = meta.title;\n    }\n    if (meta.favicon !== undefined) {\n      let link = document.querySelector<HTMLLinkElement>('link[rel=\"icon\"][data-kf-brand]');\n      if (link === null) {\n        link = document.createElement('link');\n        link.rel = 'icon';\n        link.setAttribute('data-kf-brand', '');\n        document.head.appendChild(link);\n      }\n      link.href = meta.favicon;\n    }\n    const setMeta = (\n      name: string,\n      content: string | undefined,\n      attr: 'name' | 'property' = 'name',\n    ): void => {\n      if (content === undefined) {\n        return;\n      }\n      let tag = document.querySelector<HTMLMetaElement>(`meta[${attr}=\"${name}\"][data-kf-brand]`);\n      if (tag === null) {\n        tag = document.createElement('meta');\n        tag.setAttribute(attr, name);\n        tag.setAttribute('data-kf-brand', '');\n        document.head.appendChild(tag);\n      }\n      tag.content = content;\n    };\n    setMeta('og:title', meta.ogTitle, 'property');\n    setMeta('og:description', meta.ogDescription, 'property');\n    setMeta('og:image', meta.ogImage, 'property');\n    setMeta('robots', meta.robots);\n  }, [meta]);\n\n  return null;\n}\n\n/**\n * Forwards brand assets unconditionally; enforces `headStrategy` before\n * ever mounting `<KaafilDocumentHead>`. `'none'` is a HARD no-op — no\n * branch below it ever touches `document.head`, even when `favicon`/\n * `appName` are supplied. `'own-page'` is runtime-rejected under\n * `agencyAdmin`/`manager` (dev throw, prod warning + silent `'none'`\n * fallback — the same shape `useCapability()` uses for a wrong-persona call,\n * `08-core-hooks.md §1.4`).\n */\nexport function BrandShell({\n  appName,\n  logo,\n  logoMark,\n  favicon,\n  headStrategy = 'none',\n  children,\n}: BrandShellProps): ReactNode {\n  const persona = usePersona();\n  const assets = useMemo(\n    () => ({ appName, logo, logoMark, favicon }),\n    [appName, logo, logoMark, favicon],\n  );\n\n  const rejectedOwnPage = headStrategy === 'own-page' && persona !== 'share';\n\n  useEffect(() => {\n    if (headStrategy === 'own-page' && persona !== 'share' && isDevelopment()) {\n      throw new Error(\n        'BrandShell: headStrategy=\"own-page\" was requested under a non-share persona ' +\n          `(\"${persona}\") — only the traveller/share surface may own document.head ` +\n          '(00-decisions.md U-005). Falls back to \"none\" in production.',\n      );\n    }\n    if (\n      headStrategy === 'none' &&\n      // `favicon` ONLY. `appName` is not a head-only prop: it is the last rung\n      // of the in-page brand fallback chain (partner logo -> neutral mark ->\n      // text-only appName, 05-theming-and-branding.md §8), so it does real\n      // work under every `headStrategy` and warning about it told integrators\n      // their correct code was wrong. `favicon` has no in-page use at all, so\n      // passing one under `'none'` genuinely is a no-op worth flagging.\n      favicon !== undefined &&\n      isDevelopment()\n    ) {\n      // biome-ignore lint/suspicious/noConsole: dev-only, gated above by isDevelopment()\n      console.warn(\n        'BrandShell: headStrategy=\"none\" (the default) is a hard no-op — \"favicon\" was passed ' +\n          'but document.head is never touched under \"none\" (00-decisions.md U-005). ' +\n          '\"appName\" is unaffected: it still feeds the in-page brand fallback.',\n      );\n    }\n  }, [headStrategy, persona, favicon]);\n\n  const shouldOwnPage = headStrategy === 'own-page' && persona === 'share' && !rejectedOwnPage;\n\n  return (\n    <BrandAssetsContext.Provider value={assets}>\n      {shouldOwnPage ? <KaafilDocumentHead meta={resolveShareMeta(assets)} /> : null}\n      {children}\n    </BrandAssetsContext.Provider>\n  );\n}\n\n/**\n * Shell-owned read-only alternative to `<KaafilDocumentHead>` — for a host\n * (e.g. Next.js App Router) that already owns `<head>` via its own\n * `metadata`/`generateMetadata` export and must keep `headStrategy=\"none\"`\n * here. Never writes the head itself; exactly one of the two paths is\n * active per mount (`shells/06-brand-shell.md`).\n */\nexport function useKaafilShareMeta(assets: KaafilBrandAssets): ShareMeta {\n  return useMemo(() => resolveShareMeta(assets), [assets]);\n}\n"]}
+{"version":3,"sources":["../src/core/hooks/useOfflineEngine.ts","../src/core/shells/BrandShell.tsx"],"names":["useRequiredContext","OfflineEngineContext","createContext","useContext","useEffect","usePersona","useMemo","isDevelopment","jsxs"],"mappings":"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","file":"chunk-57SUK3GD.cjs","sourcesContent":["'use client';\n\n// `08-core-hooks.md §2.1`. The escape hatch underneath every hook in §2 — a\n// composite should reach for a narrower hook before this one.\n\nimport type { OfflineEngine, OutboxOp } from 'kaafil-js/client';\nimport { OfflineEngineContext } from '../internal/contexts';\nimport { useRequiredContext } from '../internal/useRequiredContext';\n\n// Re-exported so a composite (`ManagerSyncCenterSection.types.ts`) can name\n// one outbox op's shape without importing `kaafil-js/client` directly —\n// hard rule #1.\nexport type { OutboxOp };\n\n/** Returns the engine instance `OfflineShell` opened via\n * `client.openOffline(options)`. Throws outside the provider tree. */\nexport function useOfflineEngine(): OfflineEngine {\n  return useRequiredContext(OfflineEngineContext, 'useOfflineEngine', 'OfflineShell');\n}\n","'use client';\n\n// `shells/06-brand-shell.md`. Eighth in the locked mount order\n// (`shells/README.md §2` row 8) — supplies host-side brand assets\n// (fallback chain: partner logo → neutral mark → text-only appName,\n// `05-theming-and-branding.md §8`) and, opt-in and persona-gated, controls\n// `document.head` for the traveller/share surface only. Fetches nothing\n// from the engine (`00-decisions.md` U-007 — per-agency brand assets are a\n// named non-goal for the backend).\n\nimport type { ReactNode } from 'react';\nimport { createContext, useContext, useEffect, useMemo } from 'react';\nimport { usePersona } from '../hooks/usePersona';\nimport { isDevelopment } from '../internal/isDevelopment';\n\nexport interface KaafilBrandAssets {\n  readonly appName?: string;\n  readonly logo?: string | ReactNode;\n  readonly logoMark?: string | ReactNode;\n  readonly favicon?: string;\n}\n\nexport interface BrandShellProps extends KaafilBrandAssets {\n  readonly headStrategy?: 'none' | 'own-page';\n  readonly children?: ReactNode;\n}\n\n/** Shell-owned, not a `08-core-hooks.md` catalog entry (component authoring\n * — this context's eventual consumer, a logo/header component reading the\n * fallback chain — is out of scope for this phase). */\nconst BrandAssetsContext = createContext<KaafilBrandAssets | null>(null);\n\n/** Reads the brand assets `BrandShell` forwarded, or `{}` when mounted\n * without one (never throws — brand is presentational, not load-bearing the\n * way a session read is). */\nexport function useKaafilBrand(): KaafilBrandAssets {\n  return useContext(BrandAssetsContext) ?? {};\n}\n\nexport interface ShareMeta {\n  readonly title: string | undefined;\n  readonly favicon: string | undefined;\n  readonly ogTitle: string | undefined;\n  readonly ogDescription: string | undefined;\n  readonly ogImage: string | undefined;\n  readonly robots: 'noindex' | 'index';\n}\n\nfunction resolveShareMeta(assets: KaafilBrandAssets): ShareMeta {\n  return {\n    title: assets.appName,\n    favicon: assets.favicon,\n    ogTitle: assets.appName,\n    ogDescription: undefined,\n    ogImage: undefined,\n    // Share meta defaults to noindex — a share link is private-by-obscurity;\n    // indexing it is a disclosure bug, never the shipped default\n    // (`00-decisions.md` U-005).\n    robots: 'noindex',\n  };\n}\n\n/** Only the traveller/share surface may write `document.head` — mounted\n * exclusively by `BrandShell` under a persona-permitted `'own-page'`\n * request. Renders nothing into the page body: title/meta writes are not\n * \"visual output\" in the sense `shells/README.md §1` means the phrase. */\nfunction KaafilDocumentHead({ meta }: { readonly meta: ShareMeta }): null {\n  useEffect(() => {\n    if (meta.title !== undefined) {\n      document.title = meta.title;\n    }\n    if (meta.favicon !== undefined) {\n      let link = document.querySelector<HTMLLinkElement>('link[rel=\"icon\"][data-kf-brand]');\n      if (link === null) {\n        link = document.createElement('link');\n        link.rel = 'icon';\n        link.setAttribute('data-kf-brand', '');\n        document.head.appendChild(link);\n      }\n      link.href = meta.favicon;\n    }\n    const setMeta = (\n      name: string,\n      content: string | undefined,\n      attr: 'name' | 'property' = 'name',\n    ): void => {\n      if (content === undefined) {\n        return;\n      }\n      let tag = document.querySelector<HTMLMetaElement>(`meta[${attr}=\"${name}\"][data-kf-brand]`);\n      if (tag === null) {\n        tag = document.createElement('meta');\n        tag.setAttribute(attr, name);\n        tag.setAttribute('data-kf-brand', '');\n        document.head.appendChild(tag);\n      }\n      tag.content = content;\n    };\n    setMeta('og:title', meta.ogTitle, 'property');\n    setMeta('og:description', meta.ogDescription, 'property');\n    setMeta('og:image', meta.ogImage, 'property');\n    setMeta('robots', meta.robots);\n  }, [meta]);\n\n  return null;\n}\n\n/**\n * Forwards brand assets unconditionally; enforces `headStrategy` before\n * ever mounting `<KaafilDocumentHead>`. `'none'` is a HARD no-op — no\n * branch below it ever touches `document.head`, even when `favicon`/\n * `appName` are supplied. `'own-page'` is runtime-rejected under\n * `agencyAdmin`/`manager` (dev throw, prod warning + silent `'none'`\n * fallback — the same shape `useCapability()` uses for a wrong-persona call,\n * `08-core-hooks.md §1.4`).\n */\nexport function BrandShell({\n  appName,\n  logo,\n  logoMark,\n  favicon,\n  headStrategy = 'none',\n  children,\n}: BrandShellProps): ReactNode {\n  const persona = usePersona();\n  const assets = useMemo(\n    () => ({ appName, logo, logoMark, favicon }),\n    [appName, logo, logoMark, favicon],\n  );\n\n  const rejectedOwnPage = headStrategy === 'own-page' && persona !== 'share';\n\n  useEffect(() => {\n    if (headStrategy === 'own-page' && persona !== 'share' && isDevelopment()) {\n      throw new Error(\n        'BrandShell: headStrategy=\"own-page\" was requested under a non-share persona ' +\n          `(\"${persona}\") — only the traveller/share surface may own document.head ` +\n          '(00-decisions.md U-005). Falls back to \"none\" in production.',\n      );\n    }\n    if (\n      headStrategy === 'none' &&\n      // `favicon` ONLY. `appName` is not a head-only prop: it is the last rung\n      // of the in-page brand fallback chain (partner logo -> neutral mark ->\n      // text-only appName, 05-theming-and-branding.md §8), so it does real\n      // work under every `headStrategy` and warning about it told integrators\n      // their correct code was wrong. `favicon` has no in-page use at all, so\n      // passing one under `'none'` genuinely is a no-op worth flagging.\n      favicon !== undefined &&\n      isDevelopment()\n    ) {\n      // biome-ignore lint/suspicious/noConsole: dev-only, gated above by isDevelopment()\n      console.warn(\n        'BrandShell: headStrategy=\"none\" (the default) is a hard no-op — \"favicon\" was passed ' +\n          'but document.head is never touched under \"none\" (00-decisions.md U-005). ' +\n          '\"appName\" is unaffected: it still feeds the in-page brand fallback.',\n      );\n    }\n  }, [headStrategy, persona, favicon]);\n\n  const shouldOwnPage = headStrategy === 'own-page' && persona === 'share' && !rejectedOwnPage;\n\n  return (\n    <BrandAssetsContext.Provider value={assets}>\n      {shouldOwnPage ? <KaafilDocumentHead meta={resolveShareMeta(assets)} /> : null}\n      {children}\n    </BrandAssetsContext.Provider>\n  );\n}\n\n/**\n * Shell-owned read-only alternative to `<KaafilDocumentHead>` — for a host\n * (e.g. Next.js App Router) that already owns `<head>` via its own\n * `metadata`/`generateMetadata` export and must keep `headStrategy=\"none\"`\n * here. Never writes the head itself; exactly one of the two paths is\n * active per mount (`shells/06-brand-shell.md`).\n */\nexport function useKaafilShareMeta(assets: KaafilBrandAssets): ShareMeta {\n  return useMemo(() => resolveShareMeta(assets), [assets]);\n}\n"]}

package/dist/{chunk-2SRBJ4H7.js → chunk-A4Z2YBEF.js}

@@ -174,12 +174,16 @@ function isDevelopment() {
 }
 
 // src/core/internal/useCapabilityRows.ts
+var CAPABILITY_CACHE_PREFIX = "journey.capabilities:";
 function useCapabilityRows(tripRef) {
   const client = useContext(KaafilClientContext);
   const persona = usePersona();
   const engine = useContext(OfflineEngineContext);
-  const [rows, setRows] = useState([]);
-  const [loaded, setLoaded] = useState(false);
+  const cachedRows = engine?.reads.get(
+    `${CAPABILITY_CACHE_PREFIX}${tripRef}`
+  )?.value;
+  const [rows, setRows] = useState(() => cachedRows ?? []);
+  const [loaded, setLoaded] = useState(cachedRows !== void 0);
   useEffect(() => {
     if (persona === "share") {
       if (isDevelopment()) {
@@ -195,17 +199,27 @@ function useCapabilityRows(tripRef) {
       return;
     }
     const openClient = client;
+    const cacheKey = `${CAPABILITY_CACHE_PREFIX}${tripRef}`;
+    const openEngine = engine;
+    const copy = openEngine?.reads.get(cacheKey);
+    if (copy !== void 0) {
+      setRows(copy.value);
+      setLoaded(true);
+    }
     let cancelled = false;
     async function load() {
       try {
         const response = await openClient.journey.capabilities({ tripRef });
+        void openEngine?.reads.set(cacheKey, [...response], response.meta.serverTime).catch(() => {
+        });
         if (!cancelled) {
           setRows(response);
           setLoaded(true);
         }
       } catch {
+        const cached = openEngine?.reads.get(cacheKey);
         if (!cancelled) {
-          setRows([]);
+          setRows(cached?.value ?? []);
           setLoaded(true);
         }
       }
@@ -6031,5 +6045,5 @@ function tokenStyle(overrides, own) {
 }
 
 export { ConfigContext, I18nShell, KaafilClientContext, OfflineEngineContext, SessionContext, UNKNOWN_CAPABILITY_TRIPLE, createRegistry, darkReasonFor, deriveCapabilityTriple, isDevelopment, tokenStyle, useCapabilities, useCapability, useCapabilityRows, useKaafilChrome, useKaafilClient, useOfflineEvent, useOfflineMutation, useOutboxStatus, usePersona, useRequiredContext, useSession };
-//# sourceMappingURL=chunk-2SRBJ4H7.js.map
-//# sourceMappingURL=chunk-2SRBJ4H7.js.map
+//# sourceMappingURL=chunk-A4Z2YBEF.js.map
+//# sourceMappingURL=chunk-A4Z2YBEF.js.map