@the-portland-company/shell 0.52.0 → 0.53.1

package/dist/app-chrome.d.cts

@@ -24,6 +24,46 @@ declare function resolveIdentity(input: {
     loaded?: boolean;
 }): ResolvedIdentity;
 
+/** One stage in the boot pipeline (spec §7). */
+type BootStageId = 's0_session' | 's1_org' | 's2_uvp_connect' | 's3_district' | 's4_universe' | 's5_layers' | 's6_verified' | 's7_tribes' | 's8_intelligence' | 's9_shell';
+type BootPhase = 'booting' | 'slow' | 'error' | 'done';
+/**
+ * The progress-reporting contract (spec §14, Shell package integration
+ * point). An app with a real pipeline drives this; the shape is intentionally
+ * small so a future per-app pipeline can report into it without a shell
+ * release.
+ */
+type BootProgress = {
+    stageId: BootStageId;
+    /** 0–100, real, monotonic — never supplied as a guess. */
+    pct: number;
+    /** The account's own status line for this stage (spec §8; tokens already
+     * filled, fallback already applied by the caller). */
+    label: string;
+    phase: BootPhase;
+    /** Critical-stage failure: Retry / Sign out (spec §9.1). */
+    onRetry?: () => void;
+    onSignOut?: () => void;
+};
+type LoadingScreenProps = {
+    /** Real pipeline progress, when the host app has one wired. */
+    bootProgress?: BootProgress;
+    /**
+     * Fallback completion signal used when `bootProgress` is absent: the
+     * screen dismisses once this flips true. Callers pass the same "org list
+     * resolved" signal FrameBody already computes, so a consumer that never
+     * wires the full contract still gets a truthful (if coarse) boot report
+     * instead of a spinner.
+     */
+    syntheticReady?: boolean;
+    /** True while the screen should be mounted at all (trigger gate lives in
+     * frame.tsx; this component only renders its own exit transition). */
+    visible: boolean;
+    /** Called after the fade-out completes and the DOM node should unmount. */
+    onExitComplete: () => void;
+};
+declare function LoadingScreen({ bootProgress, syntheticReady, visible, onExitComplete, }: LoadingScreenProps): react_jsx_runtime.JSX.Element | null;
+
 /** Every app that renders the shared chrome. Keyed by its subdomain. */
 type PolitogyAppKey = 'vrm' | 'contacts' | 'forms' | 'surveys' | 'polls' | 'petitions' | 'email' | 'a2p' | 'phonebank' | 'canvass' | 'signs' | 'ctas';
 /**
@@ -205,7 +245,7 @@ type PolitogyBuildMeta = {
     commitDate?: string;
     commitAuthor?: string;
 };
-declare function PolitogyAppFrame({ app, pathname, search, linkComponent, session, onSignOut, signOutUrl, buildMeta, data, children, }: {
+declare function PolitogyAppFrame({ app, pathname, search, linkComponent, session, onSignOut, signOutUrl, buildMeta, data, bootProgress, appReady, children, }: {
     app: PolitogyAppKey;
     /** Current path from the app's router (Next: usePathname()). */
     pathname: string;
@@ -225,6 +265,19 @@ declare function PolitogyAppFrame({ app, pathname, search, linkComponent, sessio
     buildMeta?: PolitogyBuildMeta;
     /** Optional DATA plumbing (never styling) — see PolitogyFrameData. */
     data?: PolitogyFrameData;
+    /**
+     * Real boot-pipeline progress (Specs/Loading-Screen §14 contract). Absent
+     * for apps that have not wired their own pipeline yet — the frame then
+     * reports a truthful but coarse two-stage boot instead of a spinner.
+     */
+    bootProgress?: BootProgress;
+    /**
+     * Explicit "the host app is ready to be shown" signal. When omitted (every
+     * app today), the Loading Screen dismisses itself once the chrome's own
+     * org/nav state resolves, so none of the 14 consumer apps has to opt in to
+     * keep working.
+     */
+    appReady?: boolean;
     children: ReactNode;
 }): react_jsx_runtime.JSX.Element;
 
@@ -375,4 +428,4 @@ type UseChromeModeArg = ModeId | {
  */
 declare function useChromeMode(arg?: UseChromeModeArg): NavMode;
 
-export { type ChromeDevNotesConfig, type ChromeIdentity, ChromeTopBarActions, type ControlledOrgState, POLITOGY_APPS, PolitogyAppChrome, PolitogyAppFrame, type PolitogyAppKey, type PolitogyAppMode, type PolitogyAppSession, type PolitogyBuildMeta, type PolitogyFrameData, type PolitogyFrameGrant, type PolitogyGrantedFrame, type ResolvedIdentity, deriveBreadcrumbs, looksLikeEmail, resolveIdentity, standardNavIcons, useChromeFooter, useChromeIdentity, useChromeMode, useChromeState, useChromeUserMenu, useIsSuperAdmin };
+export { type BootPhase, type BootProgress, type BootStageId, type ChromeDevNotesConfig, type ChromeIdentity, ChromeTopBarActions, type ControlledOrgState, LoadingScreen, POLITOGY_APPS, PolitogyAppChrome, PolitogyAppFrame, type PolitogyAppKey, type PolitogyAppMode, type PolitogyAppSession, type PolitogyBuildMeta, type PolitogyFrameData, type PolitogyFrameGrant, type PolitogyGrantedFrame, type ResolvedIdentity, deriveBreadcrumbs, looksLikeEmail, resolveIdentity, standardNavIcons, useChromeFooter, useChromeIdentity, useChromeMode, useChromeState, useChromeUserMenu, useIsSuperAdmin };

package/dist/app-chrome.d.ts

@@ -24,6 +24,46 @@ declare function resolveIdentity(input: {
     loaded?: boolean;
 }): ResolvedIdentity;
 
+/** One stage in the boot pipeline (spec §7). */
+type BootStageId = 's0_session' | 's1_org' | 's2_uvp_connect' | 's3_district' | 's4_universe' | 's5_layers' | 's6_verified' | 's7_tribes' | 's8_intelligence' | 's9_shell';
+type BootPhase = 'booting' | 'slow' | 'error' | 'done';
+/**
+ * The progress-reporting contract (spec §14, Shell package integration
+ * point). An app with a real pipeline drives this; the shape is intentionally
+ * small so a future per-app pipeline can report into it without a shell
+ * release.
+ */
+type BootProgress = {
+    stageId: BootStageId;
+    /** 0–100, real, monotonic — never supplied as a guess. */
+    pct: number;
+    /** The account's own status line for this stage (spec §8; tokens already
+     * filled, fallback already applied by the caller). */
+    label: string;
+    phase: BootPhase;
+    /** Critical-stage failure: Retry / Sign out (spec §9.1). */
+    onRetry?: () => void;
+    onSignOut?: () => void;
+};
+type LoadingScreenProps = {
+    /** Real pipeline progress, when the host app has one wired. */
+    bootProgress?: BootProgress;
+    /**
+     * Fallback completion signal used when `bootProgress` is absent: the
+     * screen dismisses once this flips true. Callers pass the same "org list
+     * resolved" signal FrameBody already computes, so a consumer that never
+     * wires the full contract still gets a truthful (if coarse) boot report
+     * instead of a spinner.
+     */
+    syntheticReady?: boolean;
+    /** True while the screen should be mounted at all (trigger gate lives in
+     * frame.tsx; this component only renders its own exit transition). */
+    visible: boolean;
+    /** Called after the fade-out completes and the DOM node should unmount. */
+    onExitComplete: () => void;
+};
+declare function LoadingScreen({ bootProgress, syntheticReady, visible, onExitComplete, }: LoadingScreenProps): react_jsx_runtime.JSX.Element | null;
+
 /** Every app that renders the shared chrome. Keyed by its subdomain. */
 type PolitogyAppKey = 'vrm' | 'contacts' | 'forms' | 'surveys' | 'polls' | 'petitions' | 'email' | 'a2p' | 'phonebank' | 'canvass' | 'signs' | 'ctas';
 /**
@@ -205,7 +245,7 @@ type PolitogyBuildMeta = {
     commitDate?: string;
     commitAuthor?: string;
 };
-declare function PolitogyAppFrame({ app, pathname, search, linkComponent, session, onSignOut, signOutUrl, buildMeta, data, children, }: {
+declare function PolitogyAppFrame({ app, pathname, search, linkComponent, session, onSignOut, signOutUrl, buildMeta, data, bootProgress, appReady, children, }: {
     app: PolitogyAppKey;
     /** Current path from the app's router (Next: usePathname()). */
     pathname: string;
@@ -225,6 +265,19 @@ declare function PolitogyAppFrame({ app, pathname, search, linkComponent, sessio
     buildMeta?: PolitogyBuildMeta;
     /** Optional DATA plumbing (never styling) — see PolitogyFrameData. */
     data?: PolitogyFrameData;
+    /**
+     * Real boot-pipeline progress (Specs/Loading-Screen §14 contract). Absent
+     * for apps that have not wired their own pipeline yet — the frame then
+     * reports a truthful but coarse two-stage boot instead of a spinner.
+     */
+    bootProgress?: BootProgress;
+    /**
+     * Explicit "the host app is ready to be shown" signal. When omitted (every
+     * app today), the Loading Screen dismisses itself once the chrome's own
+     * org/nav state resolves, so none of the 14 consumer apps has to opt in to
+     * keep working.
+     */
+    appReady?: boolean;
     children: ReactNode;
 }): react_jsx_runtime.JSX.Element;
 
@@ -375,4 +428,4 @@ type UseChromeModeArg = ModeId | {
  */
 declare function useChromeMode(arg?: UseChromeModeArg): NavMode;
 
-export { type ChromeDevNotesConfig, type ChromeIdentity, ChromeTopBarActions, type ControlledOrgState, POLITOGY_APPS, PolitogyAppChrome, PolitogyAppFrame, type PolitogyAppKey, type PolitogyAppMode, type PolitogyAppSession, type PolitogyBuildMeta, type PolitogyFrameData, type PolitogyFrameGrant, type PolitogyGrantedFrame, type ResolvedIdentity, deriveBreadcrumbs, looksLikeEmail, resolveIdentity, standardNavIcons, useChromeFooter, useChromeIdentity, useChromeMode, useChromeState, useChromeUserMenu, useIsSuperAdmin };
+export { type BootPhase, type BootProgress, type BootStageId, type ChromeDevNotesConfig, type ChromeIdentity, ChromeTopBarActions, type ControlledOrgState, LoadingScreen, POLITOGY_APPS, PolitogyAppChrome, PolitogyAppFrame, type PolitogyAppKey, type PolitogyAppMode, type PolitogyAppSession, type PolitogyBuildMeta, type PolitogyFrameData, type PolitogyFrameGrant, type PolitogyGrantedFrame, type ResolvedIdentity, deriveBreadcrumbs, looksLikeEmail, resolveIdentity, standardNavIcons, useChromeFooter, useChromeIdentity, useChromeMode, useChromeState, useChromeUserMenu, useIsSuperAdmin };

package/dist/app-chrome.js

@@ -4,10 +4,10 @@ import { clearBetaBannerDismissal, standardPolitogyNav, NavAppShell, NavChromePr
 import './chunk-U4RZPZET.js';
 import { NAV_DISPLAY_DEFAULT, resolveNavDisplay, isNavDisplayPreference, writeNavDisplayCookie, writeNavDisplayLocal, NAV_DISPLAY_STORAGE_KEY, readNavDisplayCookie } from './chunk-6UHJV2FH.js';
 import { resolveActiveOrg, isOrgId, writeActiveOrgCookie, ACTIVE_ORG_QUERY_PARAM, readActiveOrgCookie } from './chunk-W2HITMV5.js';
-import { createContext, useRef, useCallback, useEffect, useMemo, useContext, useState } from 'react';
+import { createContext, useMemo, useRef, useEffect, useState, useCallback, useContext } from 'react';
 import { DevNotesMenu, createDevNotesClient, DevNotesProvider, DevNotesTaskListModal, DevNotesOverlay } from '@the-portland-company/devnotes';
 import { FiFlag, FiTarget, FiMapPin, FiMap, FiPhone, FiShare2, FiDollarSign, FiCreditCard, FiSettings, FiBriefcase, FiBarChart2, FiUser, FiClock, FiSend, FiFileText, FiEdit3, FiUpload, FiList, FiGrid, FiLifeBuoy, FiActivity, FiLayout, FiMessageSquare, FiMail, FiUsers, FiHome } from 'react-icons/fi';
-import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
+import { jsxs, jsx, Fragment } from 'react/jsx-runtime';
 
 // src/lib/breadcrumbs.ts
 function deriveBreadcrumbs(items, pathname, opts) {
@@ -78,6 +78,216 @@ function resolveIdentity(input) {
     loaded: input.loaded ?? false
   };
 }
+var SYNTHETIC_STAGES = [
+  { pct: 20, label: "Connecting to your organization\u2026" },
+  { pct: 100, label: "Ready." }
+];
+var ANNOUNCE_THROTTLE_MS = 1500;
+var MIN_DWELL_MS = 450;
+var FILL_EASE_MS = 380;
+var HOLD_MS = 240;
+var FADE_MS = 300;
+function usePrefersReducedMotion() {
+  const [reduced, setReduced] = useState(false);
+  useEffect(() => {
+    if (typeof window === "undefined" || !window.matchMedia) return;
+    const mq = window.matchMedia("(prefers-reduced-motion: reduce)");
+    setReduced(mq.matches);
+    const onChange = () => setReduced(mq.matches);
+    mq.addEventListener("change", onChange);
+    return () => mq.removeEventListener("change", onChange);
+  }, []);
+  return reduced;
+}
+function useThrottledAnnouncement(label, isFinal) {
+  const [announced, setAnnounced] = useState(label);
+  const lastAtRef = useRef(0);
+  useEffect(() => {
+    const now = Date.now();
+    if (isFinal || now - lastAtRef.current >= ANNOUNCE_THROTTLE_MS) {
+      lastAtRef.current = now;
+      setAnnounced(label);
+      return;
+    }
+    const wait = ANNOUNCE_THROTTLE_MS - (now - lastAtRef.current);
+    const t = setTimeout(() => {
+      lastAtRef.current = Date.now();
+      setAnnounced(label);
+    }, wait);
+    return () => clearTimeout(t);
+  }, [label, isFinal]);
+  return announced;
+}
+function useDwelledLabel(label) {
+  const [displayed, setDisplayed] = useState(label);
+  const shownAtRef = useRef(0);
+  const pendingRef = useRef(null);
+  useEffect(() => {
+    if (label === displayed) return;
+    const elapsed = Date.now() - shownAtRef.current;
+    if (pendingRef.current) clearTimeout(pendingRef.current);
+    if (elapsed >= MIN_DWELL_MS) {
+      shownAtRef.current = Date.now();
+      setDisplayed(label);
+    } else {
+      pendingRef.current = setTimeout(() => {
+        shownAtRef.current = Date.now();
+        setDisplayed(label);
+      }, MIN_DWELL_MS - elapsed);
+    }
+    return () => {
+      if (pendingRef.current) clearTimeout(pendingRef.current);
+    };
+  }, [label]);
+  return displayed;
+}
+function LoadingScreen({
+  bootProgress,
+  syntheticReady,
+  visible,
+  onExitComplete
+}) {
+  const reducedMotion = usePrefersReducedMotion();
+  const synthetic = useMemo(() => {
+    const stage = syntheticReady ? SYNTHETIC_STAGES[1] : SYNTHETIC_STAGES[0];
+    return {
+      pct: stage.pct,
+      label: stage.label,
+      phase: syntheticReady ? "done" : "booting"
+    };
+  }, [syntheticReady]);
+  const pct = bootProgress?.pct ?? synthetic.pct;
+  const rawLabel = bootProgress?.label ?? synthetic.label;
+  const phase = bootProgress?.phase ?? synthetic.phase;
+  const isFinal = phase === "done" && pct >= 100;
+  const highWaterRef = useRef(0);
+  const clampedPct = Math.max(pct, highWaterRef.current);
+  useEffect(() => {
+    highWaterRef.current = clampedPct;
+  }, [clampedPct]);
+  const displayedLabel = useDwelledLabel(rawLabel);
+  const announced = useThrottledAnnouncement(displayedLabel, isFinal);
+  const [fading, setFading] = useState(false);
+  useEffect(() => {
+    if (!isFinal) return;
+    const holdMs = reducedMotion ? 0 : HOLD_MS;
+    const fadeMs = reducedMotion ? 0 : FADE_MS;
+    const holdTimer = setTimeout(() => {
+      setFading(true);
+      const fadeTimer = setTimeout(onExitComplete, fadeMs);
+      return () => clearTimeout(fadeTimer);
+    }, holdMs);
+    return () => clearTimeout(holdTimer);
+  }, [isFinal, reducedMotion]);
+  if (!visible) return null;
+  const isError = phase === "error";
+  return /* @__PURE__ */ jsxs(
+    "div",
+    {
+      "data-testid": "politogy-loading-screen",
+      style: {
+        position: "fixed",
+        inset: 0,
+        zIndex: 2147483e3,
+        display: "flex",
+        flexDirection: "column",
+        alignItems: "center",
+        justifyContent: "center",
+        gap: "2rem",
+        background: "var(--color-ink-900, #0a0a0c)",
+        color: "#fff",
+        opacity: fading ? 0 : 1,
+        transition: reducedMotion ? void 0 : `opacity ${FADE_MS}ms ease-out`
+      },
+      children: [
+        /* @__PURE__ */ jsxs(
+          "div",
+          {
+            "aria-label": "Politogy",
+            style: {
+              display: "flex",
+              alignItems: "center",
+              gap: "0.6rem",
+              fontFamily: "var(--font-sans, ui-sans-serif, system-ui, sans-serif)"
+            },
+            children: [
+              /* @__PURE__ */ jsx(
+                "span",
+                {
+                  "aria-hidden": "true",
+                  style: {
+                    display: "inline-flex",
+                    alignItems: "center",
+                    justifyContent: "center",
+                    width: 34,
+                    height: 26,
+                    borderRadius: 6,
+                    background: "#fff",
+                    color: "var(--color-ink-900, #0a0a0c)",
+                    fontSize: "0.8125rem",
+                    fontWeight: 800,
+                    letterSpacing: "-0.02em"
+                  },
+                  children: "vrm"
+                }
+              ),
+              /* @__PURE__ */ jsx("span", { style: { fontSize: "1.375rem", fontWeight: 700, letterSpacing: "-0.02em" }, children: "Politogy" })
+            ]
+          }
+        ),
+        /* @__PURE__ */ jsxs("div", { style: { width: 320, maxWidth: "80vw" }, children: [
+          /* @__PURE__ */ jsx(
+            "div",
+            {
+              role: "progressbar",
+              "aria-valuemin": 0,
+              "aria-valuemax": 100,
+              "aria-valuenow": Math.round(clampedPct),
+              "aria-label": "Loading your workspace",
+              style: {
+                height: 3,
+                width: "100%",
+                borderRadius: 2,
+                background: "rgba(255,255,255,0.12)",
+                overflow: "hidden"
+              },
+              children: /* @__PURE__ */ jsx(
+                "div",
+                {
+                  style: {
+                    height: "100%",
+                    width: `${clampedPct}%`,
+                    background: "linear-gradient(90deg, var(--color-race-blue, #1d4ed8), var(--color-race-red, #dc2626))",
+                    transition: reducedMotion ? void 0 : `width ${FILL_EASE_MS}ms ease-out`
+                  }
+                }
+              )
+            }
+          ),
+          /* @__PURE__ */ jsx(
+            "div",
+            {
+              role: "status",
+              "aria-live": "polite",
+              style: {
+                marginTop: "0.75rem",
+                fontFamily: "var(--font-mono, ui-monospace, monospace)",
+                fontSize: "0.8125rem",
+                color: isError ? "var(--color-race-red, #dc2626)" : "rgba(255,255,255,0.72)",
+                textAlign: "center"
+              },
+              children: announced
+            }
+          ),
+          isError && (bootProgress?.onRetry || bootProgress?.onSignOut) && /* @__PURE__ */ jsxs("div", { style: { marginTop: "1rem", display: "flex", gap: "0.75rem", justifyContent: "center" }, children: [
+            bootProgress?.onRetry && /* @__PURE__ */ jsx("button", { type: "button", onClick: bootProgress.onRetry, children: "Retry" }),
+            bootProgress?.onSignOut && /* @__PURE__ */ jsx("button", { type: "button", onClick: bootProgress.onSignOut, children: "Sign out" })
+          ] })
+        ] })
+      ]
+    }
+  );
+}
 var CORE_APP = "vrm";
 var DEFAULT_SIGN_OUT_URL = "/auth/signout";
 var DEFAULT_BRAND_LOGO = "/brand/logos/relationship-mode-logo.png";
@@ -128,6 +338,8 @@ function PolitogyAppFrame({
   signOutUrl = DEFAULT_SIGN_OUT_URL,
   buildMeta,
   data,
+  bootProgress,
+  appReady,
   children
 }) {
   const meta = POLITOGY_APPS[app];
@@ -156,6 +368,8 @@ function PolitogyAppFrame({
           signOutUrl,
           buildMeta,
           data,
+          bootProgress,
+          appReady,
           children
         }
       )
@@ -172,10 +386,33 @@ function FrameBody({
   signOutUrl,
   buildMeta,
   data,
+  bootProgress,
+  appReady,
   children
 }) {
   const meta = POLITOGY_APPS[app];
   const chrome = useChromeState();
+  const bootAppMode = meta.mode;
+  const bootOrgId = chrome?.orgId ?? null;
+  const [bootVisible, setBootVisible] = useState(true);
+  const [bootGeneration, setBootGeneration] = useState(0);
+  const seenOrgRef = useRef(bootOrgId);
+  const seenModeRef = useRef(bootAppMode);
+  useEffect(() => {
+    if (seenOrgRef.current !== null && seenOrgRef.current !== bootOrgId) {
+      setBootVisible(true);
+      setBootGeneration((g) => g + 1);
+    }
+    seenOrgRef.current = bootOrgId;
+  }, [bootOrgId]);
+  useEffect(() => {
+    if (seenModeRef.current !== void 0 && seenModeRef.current !== bootAppMode) {
+      setBootVisible(true);
+      setBootGeneration((g) => g + 1);
+    }
+    seenModeRef.current = bootAppMode;
+  }, [bootAppMode]);
+  const chromeResolved = chrome == null || !chrome.orgsLoading;
   const signOutRef = useRef(onSignOut);
   signOutRef.current = onSignOut;
   const signingOutRef = useRef(false);
@@ -250,70 +487,82 @@ function FrameBody({
     [navItems, pathname, search, meta.origin]
   );
   const breadcrumbs = core ? core.page?.breadcrumbs : grants?.includes("breadcrumbs") ? granted("breadcrumbs") : derivedBreadcrumbs;
-  return /* @__PURE__ */ jsx(
-    NavAppShell,
-    {
-      sidebar: {
-        pathname,
-        brand: {
-          logoSrc: core?.brandLogoSrc ?? modeBrandLogo(appMode),
-          logoAlt: "Politogy",
-          badgeLabel: "P",
-          title: "Politogy"
-        },
-        nav: {
-          // A flat rail's sub-menu IS the nav, so the 'tabs only' preference
-          // (which strips children) would leave one childless parent row —
-          // flat apps ignore the stripping.
-          items: navDisplay === "tabs" && meta.navShape !== "flat" ? navItems.map(({ children: _sub, ...item }) => item) : navItems,
-          flatten: meta.navShape === "flat"
-        },
-        // The app's own workspace is NOT the organization — it is a per-app
-        // bootstrap account with a different id in every app. Showing it while
-        // the chrome API resolves flashed the wrong org on every load ("not
-        // connected to the account"). Shimmer while in flight; only fall back
-        // to the app label once the chrome lookup has actually failed.
-        org: activeCoreOrg ? {
-          name: activeCoreOrg.name,
-          id: activeCoreOrg.id,
-          logoUrl: activeCoreOrg.logoUrl,
-          brandColor: activeCoreOrg.brandColor,
-          organizations: coreOrgs,
-          onSwitch: chrome?.setOrgId
-        } : chrome?.orgsLoading ? { name: null, id: null, loading: true } : { name: session.accountName, id: session.accountId },
-        mode,
-        footer,
-        linkComponent
+  return /* @__PURE__ */ jsxs(Fragment, { children: [
+    /* @__PURE__ */ jsx(
+      LoadingScreen,
+      {
+        visible: bootVisible,
+        bootProgress,
+        syntheticReady: appReady ?? chromeResolved,
+        onExitComplete: () => setBootVisible(false)
       },
-      betaBanner: meta.beta === false ? void 0 : {},
-      modeId: appMode,
-      contentWrapper: core?.contentWrapper ?? granted("contentWrapper"),
-      topBar: {
-        // Core's pages publish their own identity; every other app is one
-        // product surface and takes its registry title.
-        title: core?.page?.title ?? (grants?.includes("title") ? data?.frame?.title : void 0) ?? meta.title,
-        breadcrumbs,
-        user: {
-          name: identity.userName,
-          email: identity.email,
-          // The chrome API's avatar wins; the app may supply a fallback chain
-          // (e.g. a stored memoji) for users with no uploaded photo.
-          avatarUrl: identity.avatarUrl ?? data?.fallbackAvatarUrl ?? null,
-          role: session.role
+      bootGeneration
+    ),
+    /* @__PURE__ */ jsx(
+      NavAppShell,
+      {
+        sidebar: {
+          pathname,
+          brand: {
+            logoSrc: core?.brandLogoSrc ?? modeBrandLogo(appMode),
+            logoAlt: "Politogy",
+            badgeLabel: "P",
+            title: "Politogy"
+          },
+          nav: {
+            // A flat rail's sub-menu IS the nav, so the 'tabs only' preference
+            // (which strips children) would leave one childless parent row —
+            // flat apps ignore the stripping.
+            items: navDisplay === "tabs" && meta.navShape !== "flat" ? navItems.map(({ children: _sub, ...item }) => item) : navItems,
+            flatten: meta.navShape === "flat"
+          },
+          // The app's own workspace is NOT the organization — it is a per-app
+          // bootstrap account with a different id in every app. Showing it while
+          // the chrome API resolves flashed the wrong org on every load ("not
+          // connected to the account"). Shimmer while in flight; only fall back
+          // to the app label once the chrome lookup has actually failed.
+          org: activeCoreOrg ? {
+            name: activeCoreOrg.name,
+            id: activeCoreOrg.id,
+            logoUrl: activeCoreOrg.logoUrl,
+            brandColor: activeCoreOrg.brandColor,
+            organizations: coreOrgs,
+            onSwitch: chrome?.setOrgId
+          } : chrome?.orgsLoading ? { name: null, id: null, loading: true } : { name: session.accountName, id: session.accountId },
+          mode,
+          footer,
+          linkComponent
         },
-        userMenu,
-        onSignOut: handleSignOut,
-        // The action cluster is IDENTICAL everywhere — core included. Page
-        // actions sit BEFORE it, never inside it, so the Alerts bell keeps its
-        // required position: farthest right, immediately before My Account.
-        actions: /* @__PURE__ */ jsxs(Fragment, { children: [
-          core?.page?.actions,
-          /* @__PURE__ */ jsx(ChromeTopBarActions, {})
-        ] })
-      },
-      children
-    }
-  );
+        betaBanner: meta.beta === false ? void 0 : {},
+        modeId: appMode,
+        contentWrapper: core?.contentWrapper ?? granted("contentWrapper"),
+        topBar: {
+          // Core's pages publish their own identity; every other app is one
+          // product surface and takes its registry title.
+          title: core?.page?.title ?? (grants?.includes("title") ? data?.frame?.title : void 0) ?? meta.title,
+          breadcrumbs,
+          user: {
+            name: identity.userName,
+            email: identity.email,
+            // The chrome API's avatar wins; the app may supply a fallback chain
+            // (e.g. a stored memoji) for users with no uploaded photo.
+            avatarUrl: identity.avatarUrl ?? data?.fallbackAvatarUrl ?? null,
+            role: session.role
+          },
+          userMenu,
+          onSignOut: handleSignOut,
+          // The action cluster is IDENTICAL everywhere — core included. Page
+          // actions sit BEFORE it, never inside it, so the Alerts bell keeps its
+          // required position: farthest right, immediately before My Account.
+          actions: /* @__PURE__ */ jsxs(Fragment, { children: [
+            core?.page?.actions,
+            /* @__PURE__ */ jsx(ChromeTopBarActions, {})
+          ] })
+        },
+        children
+      }
+    )
+  ] });
 }
 var standardNavIcons = {
   home: FiHome,
@@ -790,6 +1039,6 @@ function useChromeMode(arg = {}) {
   };
 }
 
-export { ChromeTopBarActions, POLITOGY_APPS, PolitogyAppChrome, PolitogyAppFrame, deriveBreadcrumbs, looksLikeEmail, resolveIdentity, standardNavIcons, useChromeFooter, useChromeIdentity, useChromeMode, useChromeState, useChromeUserMenu, useIsSuperAdmin };
+export { ChromeTopBarActions, LoadingScreen, POLITOGY_APPS, PolitogyAppChrome, PolitogyAppFrame, deriveBreadcrumbs, looksLikeEmail, resolveIdentity, standardNavIcons, useChromeFooter, useChromeIdentity, useChromeMode, useChromeState, useChromeUserMenu, useIsSuperAdmin };
 //# sourceMappingURL=app-chrome.js.map
 //# sourceMappingURL=app-chrome.js.map