@the-portland-company/shell 0.73.2 → 0.75.0

package/CHANGELOG.md

@@ -1,3 +1,23 @@
+## 0.75.0
+
+Built on top of 0.74.0 (`claude/retire-nav`). Two fixes:
+
+- **Regression fix**: restored the `Polls` row to `standardPolitogyNav`'s default Collect section. Commit 03c4dc2 (retiring `app.politogyvrm.com`) dropped it entirely instead of repointing it — Polls (`polls.politogyvrm.com`) is a standalone app, independent of the retired core app, and belongs in the default tree. Apps that don't want it pass `hiddenItems: ['Polls']`.
+- **Cross-app nav prerender**: `NavAppShell` now renders a `<script type="speculationrules">` (via the new `SpeculationRulesScript`, built on `buildNavSpeculationRules`/`collectSiblingAppUrls` in `src/speculation/emitRules.ts`) for every sibling `*.politogyvrm.com` link in the consumer's own sidebar tree, `eagerness: "moderate"` — the browser prerenders on hover/pointerdown of a matching link, no custom JS trigger needed. Sign-out and other destructive rows (by label or `/signout`-style path) are excluded. Browsers without Speculation Rules support fall back, once idle, to `<link rel="prefetch">` tags for the same URLs. Because this is wired into `NavAppShell` itself (used by both `PolitogyAppFrame` and direct `NavAppShell` consumers), every consumer gets it with no per-app opt-in.
+  - **Each sibling app must send `Supports-Loading-Mode: credentialed-prerender`** on its responses for cross-origin prerender to activate while the user is authenticated — without it the browser silently falls back to a normal navigation (other agents are adding this header per-app).
+  - `buildSpeculationRules`/`AppRegistryEntry` (the old, unused registry-based API) is kept for back-compat and now documented `@deprecated` in favor of `buildNavSpeculationRules`.
+
+## 0.74.0
+
+Repoint `standardPolitogyNav` off `app.politogyvrm.com` (Reference/UI-Platform → "Retirement of app.politogyvrm.com", DECIDED 2026-10-07; District data target per v44).
+- Dashboard, Battleground, District data → `dashboard.politogyvrm.com`.
+- Organization settings (incl. the depth-3 Subscription & Billing branch) → `settings.politogyvrm.com`.
+- My profile → `auth.politogyvrm.com` (Politogy ID account app).
+- Calls to action → the standalone CTAs app (`ctas.politogyvrm.com`), replacing the legacy in-core feature.
+- Removed the V1 Email Broadcast legacy child row (VRM core's email surface is retired).
+- `coreBaseUrl` is now optional and unused — every row resolves against its V2 host directly. Kept on `StandardNavOptions` so existing callers compile unchanged.
+- Added `PolitogyAppKey` registry entries `dashboard` (`dashboard.politogyvrm.com`) and `settings` (`settings.politogyvrm.com`) so those new V2 apps can drop their own hardcoded chrome config.
+
 ## 0.72.0
 
 Left-Navigation §5, §10 and §12.

package/dist/app-chrome.cjs

@@ -187,6 +187,91 @@ function writeRailPreference(pref) {
   }
 }
 
+// src/speculation/emitRules.ts
+var DESTRUCTIVE_LABEL_PATTERNS = ["sign out", "signout", "log out", "logout", "delete"];
+var DESTRUCTIVE_PATH_PATTERNS = ["/signout", "/sign-out", "/logout", "/log-out"];
+function isDestructive(item) {
+  const label = item.label.toLowerCase();
+  if (DESTRUCTIVE_LABEL_PATTERNS.some((p) => label.includes(p))) return true;
+  const href = (item.href ?? "").toLowerCase();
+  return DESTRUCTIVE_PATH_PATTERNS.some((p) => href.includes(p));
+}
+function collectSiblingAppUrls(items, currentOrigin) {
+  const urls = /* @__PURE__ */ new Set();
+  const walk = (list) => {
+    for (const item of list) {
+      if (item.kind === "section") continue;
+      if (item.href && !isDestructive(item)) {
+        try {
+          const url = new URL(item.href, currentOrigin);
+          if (url.origin !== currentOrigin && /^https?:$/.test(url.protocol)) {
+            urls.add(url.href);
+          }
+        } catch {
+        }
+      }
+      if (item.children?.length) walk(item.children);
+    }
+  };
+  walk(items);
+  return Array.from(urls);
+}
+function buildNavSpeculationRules(items, currentOrigin = typeof window !== "undefined" ? window.location.origin : "") {
+  const urls = collectSiblingAppUrls(items, currentOrigin);
+  if (urls.length === 0) return null;
+  return {
+    prerender: [{ source: "list", urls, eagerness: "moderate" }]
+  };
+}
+
+// src/speculation/SpeculationRulesScript.tsx
+var SCRIPT_ID = "politogy-speculation-rules";
+var PREFETCH_ATTR = "data-politogy-speculation-prefetch";
+function SpeculationRulesScript({ items }) {
+  const origin = typeof window !== "undefined" ? window.location.origin : "";
+  const rules = react.useMemo(() => buildNavSpeculationRules(items, origin), [items, origin]);
+  const json = rules ? JSON.stringify(rules) : null;
+  react.useEffect(() => {
+    if (!json || typeof document === "undefined") return;
+    let el = document.getElementById(SCRIPT_ID);
+    if (!el) {
+      el = document.createElement("script");
+      el.id = SCRIPT_ID;
+      el.type = "speculationrules";
+      document.head.appendChild(el);
+    }
+    el.textContent = json;
+    return () => {
+    };
+  }, [json]);
+  react.useEffect(() => {
+    if (typeof document === "undefined" || typeof window === "undefined") return;
+    const supportsSpecRules = typeof HTMLScriptElement !== "undefined" && typeof HTMLScriptElement.supports === "function" && HTMLScriptElement.supports(
+      "speculationrules"
+    );
+    if (supportsSpecRules) return;
+    const urls = collectSiblingAppUrls(items, origin);
+    if (urls.length === 0) return;
+    const schedule = typeof window.requestIdleCallback === "function" ? window.requestIdleCallback : (cb) => setTimeout(cb, 2e3);
+    const added = [];
+    schedule(() => {
+      for (const url of urls) {
+        if (document.querySelector(`link[${PREFETCH_ATTR}][href="${url}"]`)) continue;
+        const link = document.createElement("link");
+        link.rel = "prefetch";
+        link.href = url;
+        link.setAttribute(PREFETCH_ATTR, "");
+        document.head.appendChild(link);
+        added.push(link);
+      }
+    });
+    return () => {
+      added.forEach((l) => l.remove());
+    };
+  }, [items, origin]);
+  return null;
+}
+
 // src/theme-preference.ts
 var THEME_STORAGE_KEY = "politogy_theme";
 var THEME_COOKIE = "politogy_theme";
@@ -1966,6 +2051,9 @@ var PHONEBANK_ORIGIN = "https://phonebank.politogyvrm.com/";
 var CANVASS_ORIGIN = "https://canvass.politogyvrm.com/";
 var SIGNS_ORIGIN = "https://signs.politogyvrm.com/";
 var POLLS_ORIGIN = "https://polls.politogyvrm.com/";
+var SETTINGS_ORIGIN = "https://settings.politogyvrm.com/";
+var DASHBOARD_ORIGIN = "https://dashboard.politogyvrm.com/";
+var AUTH_ORIGIN = "https://auth.politogyvrm.com/";
 var PETITION_MODE_ORIGIN = "https://petition-mode.politogyvrm.com/";
 function applyHiddenItems(items, hidden) {
   if (!hidden || hidden.length === 0) return items;
@@ -1997,29 +2085,23 @@ var APP_EMAIL_CHILDREN = [
   { label: "Statistics", icon: "barChart", href: `${EMAIL_APP}/statistics` },
   { label: "Deliverability", icon: "activity", href: `${EMAIL_APP}/deliverability` }
 ];
-var EMAIL_V1_LEGACY = { label: "Email V1 (legacy)", icon: "clock", path: "/relationship/email/dashboard" };
-var CTA_CHILDREN = [
-  { label: "Dashboard", icon: "grid", path: "/relationship/cta-database/dashboard" },
-  { label: "Create & Edit", icon: "edit", path: "/relationship/cta-creator/create-and-edit" },
-  { label: "Submissions", icon: "fileText", path: "/relationship/cta-submissions/submissions" }
-];
 var ORG_SETTINGS_CHILDREN = [
-  { label: "General", icon: "settings", path: "/organization-settings" },
+  { label: "General", icon: "settings", path: "organization-settings" },
   {
     label: "Subscription & Billing",
     icon: "creditCard",
-    path: "/organization-settings/subscription-billing",
+    path: "organization-settings/subscription-billing",
     children: [
-      { label: "Current Plan", icon: "fileText", path: "/organization-settings/subscription-billing/current-plan" },
-      { label: "SMS, MMS & Email Usage", icon: "activity", path: "/organization-settings/subscription-billing/text-email" },
-      { label: "Wallet", icon: "dollarSign", path: "/organization-settings/subscription-billing/wallet" },
-      { label: "10DLC", icon: "messageSquare", path: "/organization-settings/subscription-billing/10dlc" },
-      { label: "Billing History", icon: "clock", path: "/organization-settings/subscription-billing/billing-history" }
+      { label: "Current Plan", icon: "fileText", path: "organization-settings/subscription-billing/current-plan" },
+      { label: "SMS, MMS & Email Usage", icon: "activity", path: "organization-settings/subscription-billing/text-email" },
+      { label: "Wallet", icon: "dollarSign", path: "organization-settings/subscription-billing/wallet" },
+      { label: "10DLC", icon: "messageSquare", path: "organization-settings/subscription-billing/10dlc" },
+      { label: "Billing History", icon: "clock", path: "organization-settings/subscription-billing/billing-history" }
     ]
   },
-  { label: "Email", icon: "mail", path: "/organization-settings/email-settings" },
-  { label: "Users", icon: "users", path: "/organization-settings/users" },
-  { label: "Shared Links", icon: "share", path: "/organization-settings/shared-links" }
+  { label: "Email", icon: "mail", path: "organization-settings/email-settings" },
+  { label: "Users", icon: "users", path: "organization-settings/users" },
+  { label: "Shared Links", icon: "share", path: "organization-settings/shared-links" }
 ];
 var APP_FORMS_CHILDREN = [
   { label: "Forms", icon: "list", href: "https://forms.politogyvrm.com/?tab=forms" },
@@ -2035,6 +2117,10 @@ var APP_POLLS_CHILDREN = [
   { label: "Command Center", icon: "grid", href: "https://polls.politogyvrm.com/" },
   { label: "New Poll", icon: "edit", href: "https://polls.politogyvrm.com/polls/new" }
 ];
+var APP_CTAS_CHILDREN = [
+  { label: "CTAs", icon: "list", href: "https://ctas.politogyvrm.com/" },
+  { label: "Canvas", icon: "edit", href: "https://ctas.politogyvrm.com/?tab=canvas" }
+];
 var APP_A2P_CHILDREN = [
   { label: "Dashboard", icon: "grid", path: "dashboard" },
   { label: "Compose", icon: "edit", path: "compose" },
@@ -2062,35 +2148,39 @@ var APP_SIGNS_CHILDREN = [
   { label: "Reports", icon: "barChart", path: "reports" }
 ];
 function standardPolitogyNav(opts) {
-  const base = opts.coreBaseUrl.replace(/\/+$/, "");
-  const abs = (path) => `${base}${path.startsWith("/") ? path : `/${path}`}`;
   const icon = (key) => opts.icons?.[key] ?? standardNavIcons[key];
   const orgParam = opts.activeOrgId ? `org=${opts.activeOrgId}` : "";
   const withOrg = (url) => orgParam ? `${url}${url.includes("?") ? "&" : "?"}${orgParam}` : url;
-  const leaves = (children) => children.map((c) => ({ label: c.label, icon: icon(c.icon), href: withOrg(abs(c.path)) }));
-  const branches = (children) => children.map((c) => ({
-    label: c.label,
-    icon: icon(c.icon),
-    href: withOrg(abs(c.path)),
-    children: c.children ? leaves(c.children) : void 0
-  }));
+  const leaves = (origin, children) => appLeaves(origin, children);
+  const branches = (origin, children) => {
+    const o = origin.replace(/\/+$/, "");
+    return children.map((c) => ({
+      label: c.label,
+      icon: icon(c.icon),
+      href: withOrg(`${o}/${c.path}`),
+      children: c.children ? leaves(origin, c.children) : void 0
+    }));
+  };
   const appLeaves = (origin, children, modeParam) => {
-    const base2 = origin.replace(/\/+$/, "");
+    const base = origin.replace(/\/+$/, "");
     return children.map((c) => {
-      const url = c.path ? `${base2}/${c.path}` : `${base2}/`;
+      const url = c.path ? `${base}/${c.path}` : `${base}/`;
       const withMode = modeParam ? `${url}${url.includes("?") ? "&" : "?"}mode=${modeParam}` : url;
       return { label: c.label, icon: icon(c.icon), href: withOrg(withMode) };
     });
   };
   const accountRows = () => [
     { kind: "section", label: "Account" },
-    // My Profile is global — NOT org-suffixed (main-app ShellChromeBridge).
-    { label: "My profile", icon: icon("circleUser"), href: withOrg(abs("/my-profile")) },
+    // My Profile moved to the Politogy ID account app (auth.politogyvrm.com)
+    // with the retirement of app.politogyvrm.com.
+    { label: "My profile", icon: icon("circleUser"), href: withOrg(`${AUTH_ORIGIN}my-profile`) },
     {
       label: "Organization settings",
       icon: icon("settings"),
-      href: withOrg(abs("/organization-settings")),
-      children: branches(ORG_SETTINGS_CHILDREN)
+      // Organization settings moved to the standalone Settings app
+      // (settings.politogyvrm.com, Specs/Organization-Settings v12).
+      href: withOrg(`${SETTINGS_ORIGIN}organization-settings`),
+      children: branches(SETTINGS_ORIGIN, ORG_SETTINGS_CHILDREN)
     }
   ];
   const buildRelationship = () => {
@@ -2112,16 +2202,15 @@ function standardPolitogyNav(opts) {
     };
     return [
       { kind: "section", label: "Relationship" },
-      { label: "Dashboard", icon: icon("layoutDashboard"), href: withOrg(abs("/relationship/dashboard")) },
+      // Dashboard moved to the standalone Dashboard app (dashboard.politogyvrm.com,
+      // Specs/Relationship-Dashboard) with the retirement of app.politogyvrm.com.
+      { label: "Dashboard", icon: icon("layoutDashboard"), href: withOrg(DASHBOARD_ORIGIN) },
       contacts,
       {
         label: "Email broadcast",
         icon: icon("mail"),
         href: withOrg(`${EMAIL_APP}/dashboard`),
-        children: [
-          ...APP_EMAIL_CHILDREN.map((c) => ({ label: c.label, icon: icon(c.icon), href: withOrg(c.href) })),
-          ...leaves([EMAIL_V1_LEGACY])
-        ]
+        children: APP_EMAIL_CHILDREN.map((c) => ({ label: c.label, icon: icon(c.icon), href: withOrg(c.href) }))
       },
       {
         // SMS/MMS Blast is the a2p app entered in RELATIONSHIP mode (a2p is
@@ -2134,8 +2223,14 @@ function standardPolitogyNav(opts) {
         children: appLeaves(A2P_ORIGIN, APP_A2P_CHILDREN, "relationship")
       },
       { kind: "section", label: "Collect" },
-      // Carries no top-level href in VRM core (parent row only toggles).
-      { label: "Calls to action", icon: icon("mousePointerClick"), children: leaves(CTA_CHILDREN) },
+      // Calls to action moved to the standalone CTAs app (ctas./runtime.
+      // politogyvrm.com, Specs/CTAs) with the retirement of app.politogyvrm.com.
+      {
+        label: "Calls to action",
+        icon: icon("mousePointerClick"),
+        href: withOrg("https://ctas.politogyvrm.com/"),
+        children: APP_CTAS_CHILDREN.map((c) => ({ label: c.label, icon: icon(c.icon), href: withOrg(c.href) }))
+      },
       {
         label: "Forms",
         icon: icon("fileText"),
@@ -2148,6 +2243,16 @@ function standardPolitogyNav(opts) {
         href: withOrg("https://surveys.politogyvrm.com/surveys"),
         children: APP_SURVEYS_CHILDREN.map((c) => ({ label: c.label, icon: icon(c.icon), href: withOrg(c.href) }))
       },
+      // Polls (polls.politogyvrm.com) — kept in the default Collect section;
+      // apps that want it hidden pass `hiddenItems: ['Polls']`. Regression:
+      // dropped entirely in 03c4dc2 when app.politogyvrm.com retired; restored
+      // here (this row is independent of the retired app).
+      {
+        label: "Polls",
+        icon: icon("chartNoAxes"),
+        href: withOrg(POLLS_ORIGIN),
+        children: APP_POLLS_CHILDREN.map((c) => ({ label: c.label, icon: icon(c.icon), href: withOrg(c.href) }))
+      },
       ...accountRows()
     ];
   };
@@ -2161,8 +2266,12 @@ function standardPolitogyNav(opts) {
       // Battleground is the Campaign landing page; there is no Campaign
       // Dashboard row, and Voter Contact and Tribes have no row.
       { kind: "section", label: "Race data" },
-      { label: "Battleground", icon: icon("crosshair"), href: withOrg(abs("/campaign/battleground")) },
-      { label: "District data", icon: icon("landmark"), href: withOrg(abs("/campaign/districts")) },
+      // Battleground moved to the Dashboard app (dashboard.politogyvrm.com)
+      // until a dedicated Battleground host is decided (UI-Platform route table).
+      { label: "Battleground", icon: icon("crosshair"), href: withOrg(`${DASHBOARD_ORIGIN}battleground`) },
+      // District data moved to the Dashboard app (dashboard.politogyvrm.com)
+      // per Reference/UI-Platform v44.
+      { label: "District data", icon: icon("landmark"), href: withOrg(`${DASHBOARD_ORIGIN}districts`) },
       { kind: "section", label: "Research" },
       {
         label: "Polling",
@@ -3655,6 +3764,7 @@ function NavAppShell({
       "data-politogy-mode": modeId ?? modeIdFromLabel(sidebar.mode?.label),
       className: "min-h-screen bg-[color:var(--background)] text-[color:var(--foreground)]",
       children: [
+        /* @__PURE__ */ jsxRuntime.jsx(SpeculationRulesScript, { items: sidebar.nav.items }),
         /* @__PURE__ */ jsxRuntime.jsx(
           NavSidebar,
           {
@@ -4345,6 +4455,13 @@ var POLITOGY_APPS = {
   // Specs/Left-Navigation §9.2: Polling is a Campaign row (Research).
   polls: { title: "Polls", origin: "https://polls.politogyvrm.com", storagePrefix: "polls", mode: "campaign" },
   ctas: { title: "CTAs", origin: "https://ctas.politogyvrm.com", storagePrefix: "ctas" },
+  // V2 apps that replace retired app.politogyvrm.com pages (Reference/
+  // UI-Platform v42 "Retirement of app.politogyvrm.com"). Dashboard hosts the
+  // Relationship Dashboard + Campaign Battleground/District data/Campaigns
+  // (Specs/Relationship-Dashboard); Settings hosts org settings & billing
+  // (Specs/Organization-Settings).
+  dashboard: { title: "Dashboard", origin: "https://dashboard.politogyvrm.com", storagePrefix: "dashboard" },
+  settings: { title: "Settings", origin: "https://settings.politogyvrm.com", storagePrefix: "settings" },
   petitions: {
     title: "Petitions",
     origin: "https://petition-mode.politogyvrm.com",