@the-portland-company/shell 0.82.0 → 0.85.0

package/dist/app-chrome.d.cts

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode } from 'react';
-import { S as StandardNavIconKey, f as NavIcon, N as NavItem, g as NavBreadcrumb, h as StandardNavMode, i as NavLinkComponent, j as NavChromeFetcher, k as NavMode, l as NavUserMenu, m as NavOrgOption, b as NotificationsAdapter, o as NavFooterLink, p as NavFooter, q as NavDisplayMode } from './index-C3PFq1hl.cjs';
+import { S as StandardNavIconKey, f as NavIcon, N as NavItem, g as NavBreadcrumb, h as StandardNavMode, i as NavLinkComponent, j as NavChromeFetcher, k as NavMode, l as NavUserMenu, m as NavOrgOption, b as NotificationsAdapter, o as NavFooterLink, p as NavFooter, q as NavDisplayMode } from './index-bfbWLC7_.cjs';
 import './theme-preference.cjs';
 
 /**
@@ -401,6 +401,21 @@ type ChromeState = {
     navDisplay: NavDisplayMode;
     setNavDisplay: (m: NavDisplayMode) => void;
 };
+/**
+ * Where an organization switch goes (Specs/Left-Navigation §6, §11.2, decided
+ * 2026-10-15 by Ben): the new organization's Relationship Dashboard, from every
+ * app, Mode and page, behind the Loading Screen. The Relationship Dashboard is
+ * the one page every organization has, so nothing the user was looking at is
+ * carried into an organization that may not have it. (Measured before this: a
+ * switch from Campaign Mode to an organization without it kept the Campaign
+ * rail, then showed an access error that needed a sign-out.)
+ *
+ * An object so tests can replace `navigate` (jsdom cannot navigate).
+ */
+declare const orgSwitchLanding: {
+    href(orgId: string): string | null;
+    navigate(href: string): void;
+};
 declare function useChromeState(): ChromeState | null;
 type ControlledOrgState = {
     orgId: string | null;
@@ -580,4 +595,4 @@ type UseChromeModeArg = ModeId | {
  */
 declare function useChromeMode(arg?: UseChromeModeArg): NavMode;
 
-export { type BootPhase, type BootProgress, type BootStageId, type ChromeDevNotesConfig, type ChromeIdentity, ChromeTopBarActions, type ControlledOrgState, LoadingScreen, MODE_SEARCH_PLACEHOLDER, POLITOGY_APPS, PolitogyAppChrome, PolitogyAppFrame, type PolitogyAppKey, type PolitogyAppMode, type PolitogyAppSession, type PolitogyBuildMeta, type PolitogyFrameData, type PolitogyFrameGrant, type PolitogyGrantedFrame, type ResolvedIdentity, type TokenOrgState, deriveBreadcrumbs, footerLinks, looksLikeEmail, modeLandingHref, resolveIdentity, standardNavIcons, useChromeFooter, useChromeIdentity, useChromeMode, useChromeState, useChromeUserMenu, useIsSuperAdmin };
+export { type BootPhase, type BootProgress, type BootStageId, type ChromeDevNotesConfig, type ChromeIdentity, ChromeTopBarActions, type ControlledOrgState, LoadingScreen, MODE_SEARCH_PLACEHOLDER, POLITOGY_APPS, PolitogyAppChrome, PolitogyAppFrame, type PolitogyAppKey, type PolitogyAppMode, type PolitogyAppSession, type PolitogyBuildMeta, type PolitogyFrameData, type PolitogyFrameGrant, type PolitogyGrantedFrame, type ResolvedIdentity, type TokenOrgState, deriveBreadcrumbs, footerLinks, looksLikeEmail, modeLandingHref, orgSwitchLanding, resolveIdentity, standardNavIcons, useChromeFooter, useChromeIdentity, useChromeMode, useChromeState, useChromeUserMenu, useIsSuperAdmin };

package/dist/app-chrome.d.ts

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode } from 'react';
-import { S as StandardNavIconKey, f as NavIcon, N as NavItem, g as NavBreadcrumb, h as StandardNavMode, i as NavLinkComponent, j as NavChromeFetcher, k as NavMode, l as NavUserMenu, m as NavOrgOption, b as NotificationsAdapter, o as NavFooterLink, p as NavFooter, q as NavDisplayMode } from './index-CwTnsR9R.js';
+import { S as StandardNavIconKey, f as NavIcon, N as NavItem, g as NavBreadcrumb, h as StandardNavMode, i as NavLinkComponent, j as NavChromeFetcher, k as NavMode, l as NavUserMenu, m as NavOrgOption, b as NotificationsAdapter, o as NavFooterLink, p as NavFooter, q as NavDisplayMode } from './index-C31E7M9l.js';
 import './theme-preference.js';
 
 /**
@@ -401,6 +401,21 @@ type ChromeState = {
     navDisplay: NavDisplayMode;
     setNavDisplay: (m: NavDisplayMode) => void;
 };
+/**
+ * Where an organization switch goes (Specs/Left-Navigation §6, §11.2, decided
+ * 2026-10-15 by Ben): the new organization's Relationship Dashboard, from every
+ * app, Mode and page, behind the Loading Screen. The Relationship Dashboard is
+ * the one page every organization has, so nothing the user was looking at is
+ * carried into an organization that may not have it. (Measured before this: a
+ * switch from Campaign Mode to an organization without it kept the Campaign
+ * rail, then showed an access error that needed a sign-out.)
+ *
+ * An object so tests can replace `navigate` (jsdom cannot navigate).
+ */
+declare const orgSwitchLanding: {
+    href(orgId: string): string | null;
+    navigate(href: string): void;
+};
 declare function useChromeState(): ChromeState | null;
 type ControlledOrgState = {
     orgId: string | null;
@@ -580,4 +595,4 @@ type UseChromeModeArg = ModeId | {
  */
 declare function useChromeMode(arg?: UseChromeModeArg): NavMode;
 
-export { type BootPhase, type BootProgress, type BootStageId, type ChromeDevNotesConfig, type ChromeIdentity, ChromeTopBarActions, type ControlledOrgState, LoadingScreen, MODE_SEARCH_PLACEHOLDER, POLITOGY_APPS, PolitogyAppChrome, PolitogyAppFrame, type PolitogyAppKey, type PolitogyAppMode, type PolitogyAppSession, type PolitogyBuildMeta, type PolitogyFrameData, type PolitogyFrameGrant, type PolitogyGrantedFrame, type ResolvedIdentity, type TokenOrgState, deriveBreadcrumbs, footerLinks, looksLikeEmail, modeLandingHref, resolveIdentity, standardNavIcons, useChromeFooter, useChromeIdentity, useChromeMode, useChromeState, useChromeUserMenu, useIsSuperAdmin };
+export { type BootPhase, type BootProgress, type BootStageId, type ChromeDevNotesConfig, type ChromeIdentity, ChromeTopBarActions, type ControlledOrgState, LoadingScreen, MODE_SEARCH_PLACEHOLDER, POLITOGY_APPS, PolitogyAppChrome, PolitogyAppFrame, type PolitogyAppKey, type PolitogyAppMode, type PolitogyAppSession, type PolitogyBuildMeta, type PolitogyFrameData, type PolitogyFrameGrant, type PolitogyGrantedFrame, type ResolvedIdentity, type TokenOrgState, deriveBreadcrumbs, footerLinks, looksLikeEmail, modeLandingHref, orgSwitchLanding, resolveIdentity, standardNavIcons, useChromeFooter, useChromeIdentity, useChromeMode, useChromeState, useChromeUserMenu, useIsSuperAdmin };

package/dist/app-chrome.js

@@ -1,8 +1,8 @@
 "use client";
 import { broadcastLogout, watchLogout } from './chunk-LL6LSJAH.js';
-import { clearBetaBannerDismissal, standardPolitogyNav, standardNavIcons, isNavItemActive, NavAppShell } from './chunk-VWY6IIAR.js';
-export { standardNavIcons } from './chunk-VWY6IIAR.js';
-import { warnDeprecated, NavChromeProvider, TopBarWidgetSlot, FuelAction, SpecOverlayAction, NotificationsAction, SupportAction, useChromeMe, useNavChromeDedupedFetch, useChromeOrgs, useNavChromeFetcher } from './chunk-L73FZKGE.js';
+import { clearBetaBannerDismissal, standardPolitogyNav, standardNavIcons, isNavItemActive, NavAppShell } from './chunk-OOVS5D2K.js';
+export { standardNavIcons } from './chunk-OOVS5D2K.js';
+import { warnDeprecated, NavChromeProvider, TopBarWidgetSlot, FuelAction, SpecOverlayAction, NotificationsAction, SupportAction, useChromeMe, useNavChromeDedupedFetch, useChromeOrgs, useNavChromeFetcher } from './chunk-PRZP2SB6.js';
 import './chunk-BHRVZPZ7.js';
 import { NAV_DISPLAY_DEFAULT, resolveNavDisplay, writeNavDisplayLocal, writeNavDisplayCookie, isNavDisplayPreference, NAV_DISPLAY_STORAGE_KEY, readNavDisplayCookie } from './chunk-7YVJ7HQG.js';
 import { authBaseUrl, orgIdTail, settingsBaseUrl, ORG_ID_QUERY_PARAM, readOrgSelectorFromUrl, matchOrgSelector, syncOrgIdInUrl, isOrgId, switchActiveOrg, ACTIVE_ORG_QUERY_PARAM, writeActiveOrgCookie, resolveActiveOrg, readActiveOrgCookie } from './chunk-5LO5W7W5.js';
@@ -520,10 +520,19 @@ var CORE_APP = "vrm";
 var DEFAULT_SIGN_OUT_URL = "/auth/signout";
 var POLITOGY_APPS = {
   vrm: { title: "Politogy VRM", origin: "https://app.politogyvrm.com", storagePrefix: "vrm" },
+  // Contacts, Forms, Surveys and CTAs are Relationship rows only (Specs/
+  // Left-Navigation §9.1; Campaign has none of them, §9.2), so they are
+  // PINNED to Relationship like the Dashboard below. Left unscoped, the mode
+  // switcher and rail colour took the user's last mode choice while the rows
+  // stayed Relationship: after picking Campaign, Contacts drew the red
+  // "Campaign mode" rail around Relationship rows, even after a reload
+  // (measured 2026-10-16 on We need Steve; §11.1 "the rail never shows a mix
+  // of two modes").
   contacts: {
     title: "Contacts",
     origin: "https://contacts.politogyvrm.com",
     storagePrefix: "contacts",
+    mode: "relationship",
     pageTitle: false
   },
   // 'title' for forms/surveys/polls/ctas for the same reason as petitions
@@ -532,11 +541,11 @@ var POLITOGY_APPS = {
   // page header falls back to the static registry title forever, so the
   // designed "<mode> mode" eyebrow + H2 + subtitle block never gets the real
   // per-page title an app passes it (UI-Platform → Page header).
-  forms: { title: "Forms", origin: "https://forms.politogyvrm.com", storagePrefix: "forms", grants: ["title"] },
-  surveys: { title: "Surveys", origin: "https://surveys.politogyvrm.com", storagePrefix: "surveys", grants: ["title"] },
+  forms: { title: "Forms", origin: "https://forms.politogyvrm.com", storagePrefix: "forms", mode: "relationship", grants: ["title"] },
+  surveys: { title: "Surveys", origin: "https://surveys.politogyvrm.com", storagePrefix: "surveys", mode: "relationship", grants: ["title"] },
   // Specs/Left-Navigation §9.2: Polling is a Campaign row (Research).
   polls: { title: "Polls", origin: "https://polls.politogyvrm.com", storagePrefix: "polls", mode: "campaign", grants: ["title"] },
-  ctas: { title: "CTAs", origin: "https://ctas.politogyvrm.com", storagePrefix: "ctas", grants: ["title"] },
+  ctas: { title: "CTAs", origin: "https://ctas.politogyvrm.com", storagePrefix: "ctas", mode: "relationship", grants: ["title"] },
   // V2 apps that replace retired app.politogyvrm.com pages (Reference/
   // UI-Platform v42 "Retirement of app.politogyvrm.com"). Dashboard is the
   // Relationship Dashboard, the Relationship Mode landing page, and nothing
@@ -760,7 +769,7 @@ function FrameBody({
   const coreOrgs = chrome?.orgs ?? [];
   const activeCoreOrg = coreOrgs.find((o) => o.id === chrome?.orgId) ?? null;
   const navDisplay = chrome?.navDisplay ?? "both";
-  const navMode = appMode ?? "relationship";
+  const navMode = appMode ?? (app !== CORE_APP && isStandardNavMode(mode.id) ? mode.id : "relationship");
   const activeOrgId = chrome?.orgId ?? null;
   const derivedNavItems = useMemo(
     () => standardPolitogyNav({
@@ -803,7 +812,7 @@ function FrameBody({
       {
         visible: bootVisible,
         bootProgress,
-        syntheticReady: appReady ?? chromeResolved,
+        syntheticReady: (appReady ?? chromeResolved) && !chrome?.orgPending && (appMode !== void 0 || mode.resolved !== false),
         onExitComplete: () => setBootVisible(false)
       },
       bootGeneration
@@ -893,6 +902,18 @@ function FrameBody({
 }
 var ORG_STORAGE_KEY = "vrm.activeOrg";
 var MODE_STORAGE_KEY = "vrm.activeMode";
+var orgSwitchLanding = {
+  href(orgId) {
+    return modeLandingHref("relationship", {
+      orgId,
+      hostname: typeof window === "undefined" ? null : window.location.hostname
+    });
+  },
+  navigate(href) {
+    window.location.assign(href);
+  }
+};
+var ORG_SWITCH_REEXCHANGE_BUDGET_MS = 4e3;
 var ChromeStateContext = createContext(null);
 function useChromeState() {
   return useContext(ChromeStateContext);
@@ -908,6 +929,7 @@ function TokenChromeStateProvider({
   const [pendingOrg, setPendingOrg] = useState(null);
   const tokenOrgRef = useRef(tokenOrg);
   tokenOrgRef.current = tokenOrg;
+  const leavingRef = useRef(false);
   useEffect(() => {
     setNavDisplayState(resolveNavDisplay());
   }, []);
@@ -948,6 +970,7 @@ function TokenChromeStateProvider({
   }, [overrideOrg, tokenOrg.orgId]);
   useEffect(() => {
     if (!pendingOrg || tokenOrg.orgId !== pendingOrg) return;
+    if (leavingRef.current) return;
     setPendingOrg(null);
     try {
       const next = syncOrgIdInUrl(window.location.href, pendingOrg);
@@ -970,8 +993,16 @@ function TokenChromeStateProvider({
           window.history.replaceState(window.history.state, "", url.toString());
         } catch {
         }
-        await tokenOrgRef.current.onReexchange(claims.orgId, { perTab: false });
+        leavingRef.current = true;
+        await Promise.race([
+          Promise.resolve(tokenOrgRef.current.onReexchange(claims.orgId, { perTab: false })).catch(() => {
+          }),
+          new Promise((resolve) => setTimeout(resolve, ORG_SWITCH_REEXCHANGE_BUDGET_MS))
+        ]);
+        const href = orgSwitchLanding.href(claims.orgId);
+        if (href) orgSwitchLanding.navigate(href);
       } catch (err) {
+        leavingRef.current = false;
         setPendingOrg(null);
         tokenOrgRef.current.onSwitchError?.(err);
       }
@@ -1036,10 +1067,13 @@ function ChromeStateProvider({
   const navReconciled = useRef(false);
   const orgReconciled = useRef(false);
   const hadBootSelector = useRef(false);
+  const bootUrlTail = useRef(null);
   useEffect(() => {
     try {
+      const urlSelector = readOrgSelectorFromUrl(window.location.search);
+      if (urlSelector && !isOrgId(urlSelector)) bootUrlTail.current = urlSelector;
       const selector = resolveActiveOrg();
-      if (selector) hadBootSelector.current = true;
+      if (selector || urlSelector) hadBootSelector.current = true;
       const storedOrg = selector ?? localStorage.getItem(ORG_STORAGE_KEY);
       if (storedOrg) setOrgIdState(storedOrg);
     } catch {
@@ -1076,7 +1110,9 @@ function ChromeStateProvider({
   }, []);
   useEffect(() => {
     if (!orgs || orgs.length === 0) return;
-    setOrgIdState((prev) => prev && orgs.some((o) => o.id === prev) ? prev : orgs[0].id);
+    const fromUrl = matchOrgSelector(bootUrlTail.current, orgs)?.id ?? null;
+    bootUrlTail.current = null;
+    setOrgIdState((prev) => fromUrl ?? (prev && orgs.some((o) => o.id === prev) ? prev : orgs[0].id));
   }, [orgs]);
   const activeOrgRef = useRef(null);
   const memberOrgsRef = useRef([]);
@@ -1134,6 +1170,10 @@ function ChromeStateProvider({
     } catch {
     }
     writeActiveOrgCookie(id);
+    if (isOrgId(id)) {
+      const href = orgSwitchLanding.href(id);
+      if (href) orgSwitchLanding.navigate(href);
+    }
   }, []);
   const setNavDisplay = useCallback(
     (m) => {
@@ -1200,8 +1240,10 @@ function ChromeStateProvider({
     }
     try {
       const url = new URL(window.location.href);
-      if (url.searchParams.get(ACTIVE_ORG_QUERY_PARAM) !== activeOrgId) {
-        url.searchParams.set(ACTIVE_ORG_QUERY_PARAM, activeOrgId);
+      const tail = orgIdTail(activeOrgId);
+      if (url.searchParams.has(ACTIVE_ORG_QUERY_PARAM) || url.searchParams.get(ORG_ID_QUERY_PARAM) !== tail) {
+        url.searchParams.delete(ACTIVE_ORG_QUERY_PARAM);
+        url.searchParams.set(ORG_ID_QUERY_PARAM, tail);
         window.history.replaceState(window.history.state, "", url.toString());
       }
     } catch {
@@ -1490,6 +1532,7 @@ function useChromeMode(arg = {}) {
   const orgId = ctx?.orgId ?? null;
   const orgPending = ctx?.orgPending ?? false;
   const [entitled, setEntitled] = useState(null);
+  const [settledOrgId, setSettledOrgId] = useState(null);
   const [selectedModeId, setSelectedModeId] = useState(null);
   useEffect(() => {
     try {
@@ -1504,6 +1547,7 @@ function useChromeMode(arg = {}) {
     const bootMe = me;
     if (bootMe && bootMe.account === orgId && bootMe.modes !== void 0) {
       setEntitled(bootMe.modes ?? null);
+      setSettledOrgId(orgId);
       return;
     }
     let cancelled = false;
@@ -1511,7 +1555,9 @@ function useChromeMode(arg = {}) {
       if (cancelled) return;
       const modes = data?.modes ?? null;
       setEntitled(modes);
+      setSettledOrgId(orgId);
     }).catch(() => {
+      if (!cancelled) setSettledOrgId(orgId);
     });
     return () => {
       cancelled = true;
@@ -1525,6 +1571,9 @@ function useChromeMode(arg = {}) {
     id: current.id,
     label: current.label,
     icon: current.icon,
+    // A registry pin is final at once; otherwise the mode is final when the
+    // active org's Modes are in (or nothing can be read: no chrome or no org).
+    resolved: Boolean(pinned) || !dedupedFetch || !orgId || settledOrgId === orgId && !orgPending,
     // Left-Navigation §7 / Reference/UI-Platform: always the row of three icon
     // buttons. A mode the organization does not hold is shown dimmed and not
     // selectable, never hidden. Before entitlements land only the current mode
@@ -1553,6 +1602,6 @@ function useChromeMode(arg = {}) {
   };
 }
 
-export { ChromeTopBarActions, LoadingScreen, MODE_SEARCH_PLACEHOLDER, POLITOGY_APPS, PolitogyAppChrome, PolitogyAppFrame, deriveBreadcrumbs, footerLinks, looksLikeEmail, modeLandingHref, resolveIdentity, useChromeFooter, useChromeIdentity, useChromeMode, useChromeState, useChromeUserMenu, useIsSuperAdmin };
+export { ChromeTopBarActions, LoadingScreen, MODE_SEARCH_PLACEHOLDER, POLITOGY_APPS, PolitogyAppChrome, PolitogyAppFrame, deriveBreadcrumbs, footerLinks, looksLikeEmail, modeLandingHref, orgSwitchLanding, resolveIdentity, useChromeFooter, useChromeIdentity, useChromeMode, useChromeState, useChromeUserMenu, useIsSuperAdmin };
 //# sourceMappingURL=app-chrome.js.map
 //# sourceMappingURL=app-chrome.js.map