@the-portland-company/shell 0.68.1 → 0.69.0

package/dist/app-chrome.d.cts

@@ -2,6 +2,7 @@ import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode } from 'react';
 import { NavItem, NavBreadcrumb, StandardNavMode, NavLinkComponent, NavChromeFetcher, NavMode, NavUserMenu, NavOrgOption, StandardNavIconKey, NavIcon, NavFooter, NavDisplayMode } from './native.cjs';
 import './theme-preference.cjs';
+import './FormColumn-DsNP6NVG.cjs';
 
 declare function deriveBreadcrumbs(items: NavItem[], pathname: string, opts?: {
     search?: string;
@@ -103,13 +104,16 @@ type PolitogyAppMode = StandardNavMode;
  * so widening the surface takes a shell release and a review by whoever owns
  * the shell.
  *
- * Never add a grant for a visual input. `contentWrapper` qualifies because the
- * app either does or does not already emit its own `<main>`; `breadcrumbs`
- * qualifies because only the app knows which record a deep link points at.
- * "Petitions wants a wider box" would not qualify — that is a look, and looks
- * come from tokens.
+ * Never add a grant for a visual input. `breadcrumbs` qualifies because only
+ * the app knows which record a deep link points at. "Petitions wants a wider
+ * box" would not qualify — that is a look, and looks come from tokens.
+ *
+ * RETIRED (0.69.0): the `contentWrapper` grant. The frame's `<main>` is fluid
+ * and apps never emit their own page container (Brand guideline "Content
+ * width is fluid"; Reference/UI-Platform → PolitogyAppFrame), so no app may be
+ * granted one. Do not re-add it.
  */
-type PolitogyFrameGrant = 'contentWrapper' | 'breadcrumbs' | 'title';
+type PolitogyFrameGrant = 'breadcrumbs' | 'title';
 /**
  * The per-app registry — the ONLY place app identity lives. A new app adds a
  * row here and inherits every chrome behavior; it never re-derives one.
@@ -256,10 +260,10 @@ type PolitogyFrameData = {
 /** See `PolitogyFrameData.frame` — honored per the app's registry `grants`. */
 type PolitogyGrantedFrame = {
     /**
-     * How the frame wraps page content. `'bare'` for an app that already emits
-     * its own `<main>` + container, which the default otherwise nests inside
-     * `mx-auto max-w-7xl` — producing a doubled gutter and, strictly, invalid
-     * HTML (a `<main>` inside a `<main>`).
+     * @deprecated RETIRED in 0.69.0 and ignored: no app holds a `contentWrapper`
+     * grant any more. The frame's `<main>` is fluid; remove the app's own page
+     * container (`PageContainer`) and stop passing this. Still typed so an app
+     * that passes it keeps compiling until it is cleaned up.
      */
     contentWrapper?: 'padded' | 'bare';
     /**
@@ -288,9 +292,17 @@ type PolitogyCoreFrame = {
     mode?: NavMode;
     /** Real linked-account switching + core's theme persistence. */
     userMenu?: NavUserMenu;
-    /** Mode-specific brand wordmark (core swaps it per operating Mode). */
+    /**
+     * @deprecated Ignored since 0.69.0. The rail logo is the all-white lockup
+     * from Brand `assets.logoHorizontal`, read at runtime, in every Mode —
+     * never a mode-specific or bundled wordmark (Left-Navigation §5).
+     */
     brandLogoSrc?: string;
-    /** Core wraps every page in PageContainer, which emits its own <main>. */
+    /**
+     * @deprecated Core still wraps its pages in `PageContainer`, which emits its
+     * own `<main>`, so `'bare'` is honored for core until those pages are
+     * migrated to the frame's fluid `<main>`. Not available to any other app.
+     */
     contentWrapper?: 'padded' | 'bare';
 };
 type PolitogyBuildMeta = {

package/dist/app-chrome.d.ts

@@ -2,6 +2,7 @@ import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode } from 'react';
 import { NavItem, NavBreadcrumb, StandardNavMode, NavLinkComponent, NavChromeFetcher, NavMode, NavUserMenu, NavOrgOption, StandardNavIconKey, NavIcon, NavFooter, NavDisplayMode } from './native.js';
 import './theme-preference.js';
+import './FormColumn-DsNP6NVG.js';
 
 declare function deriveBreadcrumbs(items: NavItem[], pathname: string, opts?: {
     search?: string;
@@ -103,13 +104,16 @@ type PolitogyAppMode = StandardNavMode;
  * so widening the surface takes a shell release and a review by whoever owns
  * the shell.
  *
- * Never add a grant for a visual input. `contentWrapper` qualifies because the
- * app either does or does not already emit its own `<main>`; `breadcrumbs`
- * qualifies because only the app knows which record a deep link points at.
- * "Petitions wants a wider box" would not qualify — that is a look, and looks
- * come from tokens.
+ * Never add a grant for a visual input. `breadcrumbs` qualifies because only
+ * the app knows which record a deep link points at. "Petitions wants a wider
+ * box" would not qualify — that is a look, and looks come from tokens.
+ *
+ * RETIRED (0.69.0): the `contentWrapper` grant. The frame's `<main>` is fluid
+ * and apps never emit their own page container (Brand guideline "Content
+ * width is fluid"; Reference/UI-Platform → PolitogyAppFrame), so no app may be
+ * granted one. Do not re-add it.
  */
-type PolitogyFrameGrant = 'contentWrapper' | 'breadcrumbs' | 'title';
+type PolitogyFrameGrant = 'breadcrumbs' | 'title';
 /**
  * The per-app registry — the ONLY place app identity lives. A new app adds a
  * row here and inherits every chrome behavior; it never re-derives one.
@@ -256,10 +260,10 @@ type PolitogyFrameData = {
 /** See `PolitogyFrameData.frame` — honored per the app's registry `grants`. */
 type PolitogyGrantedFrame = {
     /**
-     * How the frame wraps page content. `'bare'` for an app that already emits
-     * its own `<main>` + container, which the default otherwise nests inside
-     * `mx-auto max-w-7xl` — producing a doubled gutter and, strictly, invalid
-     * HTML (a `<main>` inside a `<main>`).
+     * @deprecated RETIRED in 0.69.0 and ignored: no app holds a `contentWrapper`
+     * grant any more. The frame's `<main>` is fluid; remove the app's own page
+     * container (`PageContainer`) and stop passing this. Still typed so an app
+     * that passes it keeps compiling until it is cleaned up.
      */
     contentWrapper?: 'padded' | 'bare';
     /**
@@ -288,9 +292,17 @@ type PolitogyCoreFrame = {
     mode?: NavMode;
     /** Real linked-account switching + core's theme persistence. */
     userMenu?: NavUserMenu;
-    /** Mode-specific brand wordmark (core swaps it per operating Mode). */
+    /**
+     * @deprecated Ignored since 0.69.0. The rail logo is the all-white lockup
+     * from Brand `assets.logoHorizontal`, read at runtime, in every Mode —
+     * never a mode-specific or bundled wordmark (Left-Navigation §5).
+     */
     brandLogoSrc?: string;
-    /** Core wraps every page in PageContainer, which emits its own <main>. */
+    /**
+     * @deprecated Core still wraps its pages in `PageContainer`, which emits its
+     * own `<main>`, so `'bare'` is honored for core until those pages are
+     * migrated to the frame's fluid `<main>`. Not available to any other app.
+     */
     contentWrapper?: 'padded' | 'bare';
 };
 type PolitogyBuildMeta = {

package/dist/app-chrome.js

@@ -1,6 +1,7 @@
 "use client";
 import { broadcastLogout, watchLogout } from './chunk-LL6LSJAH.js';
-import { clearBetaBannerDismissal, standardPolitogyNav, isNavItemActive, NavAppShell, NavChromeProvider, TopBarWidgetSlot, FuelAction, SpecOverlayAction, NotificationsAction, SupportAction, useChromeMe, useThemePreference, useNavChromeFetcher, useChromeOrgs } from './chunk-2UTIX3LI.js';
+import { clearBetaBannerDismissal, standardPolitogyNav, isNavItemActive, NavAppShell, NavChromeProvider, TopBarWidgetSlot, FuelAction, SpecOverlayAction, NotificationsAction, SupportAction, useChromeMe, useThemePreference, useNavChromeFetcher, useChromeOrgs } from './chunk-WFUWFMCA.js';
+import { warnDeprecated } from './chunk-LPSBSAF3.js';
 import './chunk-NHBNM5P3.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';
@@ -464,13 +465,54 @@ function LoadingScreen({
     }
   );
 }
+function parseCssUrl(value) {
+  if (!value) return null;
+  const m = /^url\(\s*(['"]?)(.*?)\1\s*\)$/i.exec(value.trim());
+  const url = m?.[2]?.trim();
+  return url && /^https:\/\//i.test(url) ? url : null;
+}
+function readBrandAsset(kind) {
+  if (typeof document === "undefined") return null;
+  try {
+    return parseCssUrl(
+      window.getComputedStyle(document.documentElement).getPropertyValue(`--asset-${kind}`)
+    );
+  } catch {
+    return null;
+  }
+}
+var EMPTY = { logoHorizontal: null, logoSquare: null };
+var RETRY_MS = [0, 250, 1e3, 3e3];
+function useBrandAssets() {
+  const [assets, setAssets] = useState(EMPTY);
+  useEffect(() => {
+    let done = false;
+    const read = () => {
+      if (done) return;
+      const next = {
+        logoHorizontal: readBrandAsset("logo-horizontal"),
+        logoSquare: readBrandAsset("logo-square")
+      };
+      setAssets(
+        (prev) => prev.logoHorizontal === next.logoHorizontal && prev.logoSquare === next.logoSquare ? prev : next
+      );
+    };
+    const links = Array.from(
+      document.querySelectorAll('link[rel="stylesheet"][href*="api/tokens"]')
+    );
+    links.forEach((l) => l.addEventListener("load", read));
+    const timers = RETRY_MS.map((ms) => window.setTimeout(read, ms));
+    read();
+    return () => {
+      done = true;
+      links.forEach((l) => l.removeEventListener("load", read));
+      timers.forEach((t) => window.clearTimeout(t));
+    };
+  }, []);
+  return assets;
+}
 var CORE_APP = "vrm";
 var DEFAULT_SIGN_OUT_URL = "/auth/signout";
-var DEFAULT_BRAND_LOGO = "/brand/logos/relationship-mode-logo.png";
-var MODE_BRAND_LOGOS = {
-  petition: "/brand/logos/petition-mode-logo.svg"
-};
-var modeBrandLogo = (mode) => mode && MODE_BRAND_LOGOS[mode] || DEFAULT_BRAND_LOGO;
 var POLITOGY_APPS = {
   vrm: { title: "Politogy VRM", origin: "https://app.politogyvrm.com", storagePrefix: "vrm" },
   contacts: {
@@ -488,13 +530,12 @@ var POLITOGY_APPS = {
     origin: "https://petition-mode.politogyvrm.com",
     storagePrefix: "petitions",
     mode: "petition",
-    // Petitions wraps every page in its own PageContainer (which emits its own
-    // <main>), and its adjudication case is addressed per sheet and per line —
-    // a trail derived from the nav tree reads "Dashboard › Adjudication" on
-    // every one of those URLs and cannot name the record you are actually on.
-    // 'title' for the same reason: its pages have real names ("Batches"),
-    // where the registry can only say "Petitions".
-    grants: ["contentWrapper", "breadcrumbs", "title"],
+    // Its adjudication case is addressed per sheet and per line — a trail
+    // derived from the nav tree reads "Dashboard › Adjudication" on every one
+    // of those URLs and cannot name the record you are actually on. 'title'
+    // for the same reason: its pages have real names ("Batches"), where the
+    // registry can only say "Petitions".
+    grants: ["breadcrumbs", "title"],
     navShape: "flat",
     beta: false
   },
@@ -586,6 +627,19 @@ function FrameBody({
 }) {
   const meta = POLITOGY_APPS[app];
   const chrome = useChromeState();
+  const brandAssets = useBrandAssets();
+  if (data?.frame?.contentWrapper !== void 0) {
+    warnDeprecated(
+      "frame.contentWrapper",
+      "`data.frame.contentWrapper` is retired and ignored: the frame's <main> is fluid. Remove the app's own page container and drop the prop."
+    );
+  }
+  if (data?.core?.brandLogoSrc !== void 0) {
+    warnDeprecated(
+      "core.brandLogoSrc",
+      "`data.core.brandLogoSrc` is ignored: the rail logo is read at runtime from Brand `assets.logoHorizontal`."
+    );
+  }
   const bootAppMode = meta.mode;
   const bootOrgId = chrome?.orgId ?? null;
   const [bootVisible, setBootVisible] = useState(true);
@@ -724,7 +778,11 @@ function FrameBody({
         sidebar: {
           pathname,
           brand: {
-            logoSrc: core?.brandLogoSrc ?? modeBrandLogo(appMode),
+            logoSrc: brandAssets.logoHorizontal ?? void 0,
+            logoSquareSrc: brandAssets.logoSquare ?? void 0,
+            // Reserve the logo's box while the token sheet loads; never draw a
+            // stand-in.
+            logoPending: true,
             logoAlt: "Politogy",
             badgeLabel: "P",
             title: "Politogy"
@@ -756,7 +814,7 @@ function FrameBody({
         },
         betaBanner: meta.beta === true ? {} : void 0,
         modeId: appMode,
-        contentWrapper: core?.contentWrapper ?? granted("contentWrapper"),
+        contentWrapper: core?.contentWrapper,
         topBar: {
           // Core's pages publish their own identity; every other app is one
           // product surface and takes its registry title.