@the-portland-company/shell 0.81.2 → 0.84.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-_Y7jOKPN.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--q40spnY.cjs';
 import './theme-preference.cjs';
 
 /**
@@ -181,6 +181,21 @@ type PolitogyAppSession = {
      */
     userName?: string | null;
 };
+/**
+ * Optional DATA plumbing for apps whose session/auth differs — never styling.
+ *
+ * Everything here is about WHERE data comes from (which fetcher, which org
+ * state, which routes an app owns), not what the chrome looks like. Adding a
+ * visual option to this type would re-open the drift this component exists to
+ * close.
+ */
+/**
+ * Universal-search placeholder, per Mode (Reference/UI-Platform v56 "Top bar —
+ * required elements", decided by Ben 2026-10-12). The Glossary term is Tribe,
+ * so the design frame's "segments" is not used. An app may still pass its own
+ * copy through `data.searchPlaceholder`.
+ */
+declare const MODE_SEARCH_PLACEHOLDER: Record<string, string>;
 type PolitogyFrameData = {
     /** Chrome-API fetcher override for apps that authenticate client-side. */
     fetchJson?: NavChromeFetcher;
@@ -386,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;
@@ -565,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, 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-bYu6DxNt.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-C4ob05Pc.js';
 import './theme-preference.js';
 
 /**
@@ -181,6 +181,21 @@ type PolitogyAppSession = {
      */
     userName?: string | null;
 };
+/**
+ * Optional DATA plumbing for apps whose session/auth differs — never styling.
+ *
+ * Everything here is about WHERE data comes from (which fetcher, which org
+ * state, which routes an app owns), not what the chrome looks like. Adding a
+ * visual option to this type would re-open the drift this component exists to
+ * close.
+ */
+/**
+ * Universal-search placeholder, per Mode (Reference/UI-Platform v56 "Top bar —
+ * required elements", decided by Ben 2026-10-12). The Glossary term is Tribe,
+ * so the design frame's "segments" is not used. An app may still pass its own
+ * copy through `data.searchPlaceholder`.
+ */
+declare const MODE_SEARCH_PLACEHOLDER: Record<string, string>;
 type PolitogyFrameData = {
     /** Chrome-API fetcher override for apps that authenticate client-side. */
     fetchJson?: NavChromeFetcher;
@@ -386,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;
@@ -565,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, 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-MYY6N6D4.js';
-export { standardNavIcons } from './chunk-MYY6N6D4.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-QS3Z4N73.js';
+export { standardNavIcons } from './chunk-QS3Z4N73.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';
@@ -593,8 +593,10 @@ var POLITOGY_APPS = {
   canvass: { title: "Field Canvassing", origin: "https://canvass.politogyvrm.com", storagePrefix: "canvass", mode: "campaign", grants: ["title"] },
   signs: { title: "Sign Mapping", origin: "https://signs.politogyvrm.com", storagePrefix: "signs", mode: "campaign", grants: ["title"] }
 };
-var DEFAULT_SEARCH_PLACEHOLDER = {
-  contacts: "Search contacts, segments, forms"
+var MODE_SEARCH_PLACEHOLDER = {
+  relationship: "Search contacts, Tribes, forms",
+  campaign: "Search voters, walk lists, polls",
+  petition: "Search petitions, sheets, circulators"
 };
 function PolitogyAppFrame({
   app,
@@ -801,7 +803,7 @@ function FrameBody({
       {
         visible: bootVisible,
         bootProgress,
-        syntheticReady: appReady ?? chromeResolved,
+        syntheticReady: (appReady ?? chromeResolved) && !chrome?.orgPending,
         onExitComplete: () => setBootVisible(false)
       },
       bootGeneration
@@ -872,7 +874,9 @@ function FrameBody({
           // search is the only thing on the left end of the bar. No app wires
           // search yet, so this stays decorative (`NavTopBarProps.search` — "an
           // app that has not wired search yet still gets the correct chrome").
-          search: { placeholder: data?.searchPlaceholder ?? DEFAULT_SEARCH_PLACEHOLDER[app] ?? "Search" },
+          search: {
+            placeholder: data?.searchPlaceholder ?? MODE_SEARCH_PLACEHOLDER[appMode ?? mode.id ?? "relationship"] ?? "Search"
+          },
           // No Build notes control (Reference/UI-Platform, decided 2026-10-03).
           // The action cluster is IDENTICAL everywhere — core included. Page
           // actions sit BEFORE it, never inside it, so the Alerts bell keeps its
@@ -889,6 +893,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);
@@ -904,6 +920,7 @@ function TokenChromeStateProvider({
   const [pendingOrg, setPendingOrg] = useState(null);
   const tokenOrgRef = useRef(tokenOrg);
   tokenOrgRef.current = tokenOrg;
+  const leavingRef = useRef(false);
   useEffect(() => {
     setNavDisplayState(resolveNavDisplay());
   }, []);
@@ -944,6 +961,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);
@@ -966,8 +984,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);
       }
@@ -1032,10 +1058,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 {
@@ -1072,7 +1101,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([]);
@@ -1130,6 +1161,10 @@ function ChromeStateProvider({
     } catch {
     }
     writeActiveOrgCookie(id);
+    if (isOrgId(id)) {
+      const href = orgSwitchLanding.href(id);
+      if (href) orgSwitchLanding.navigate(href);
+    }
   }, []);
   const setNavDisplay = useCallback(
     (m) => {
@@ -1196,8 +1231,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 {
@@ -1518,6 +1555,7 @@ function useChromeMode(arg = {}) {
   const selected = selectedModeId ? options.find((m) => m.id === selectedModeId) ?? null : null;
   const current = pinned ?? selected ?? options[0] ?? MODE_DEFS.find((m) => m.id === fallbackModeId) ?? MODE_DEFS[0];
   return {
+    id: current.id,
     label: current.label,
     icon: current.icon,
     // Left-Navigation §7 / Reference/UI-Platform: always the row of three icon
@@ -1548,6 +1586,6 @@ function useChromeMode(arg = {}) {
   };
 }
 
-export { ChromeTopBarActions, LoadingScreen, 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