@the-portland-company/shell 0.67.0 → 0.68.1

package/dist/app-chrome.d.cts

@@ -147,6 +147,14 @@ declare const POLITOGY_APPS: Record<PolitogyAppKey, {
      * product shows the platform's Beta notice is a platform decision.
      */
     beta?: boolean;
+    /**
+     * false: the chrome does NOT draw its own page-title line (the 56px
+     * `<h1>` above `main`); the app's page body owns its title. Specs/Contacts
+     * design: the page opens on its own "RELATIONSHIP MODE" eyebrow + H1, so
+     * a chrome-owned "Contacts" line above it was a second heading not in the
+     * design. Registry-level (platform decision), like `beta`.
+     */
+    pageTitle?: false;
 }>;
 type PolitogyAppSession = {
     /** Stable IdP subject (`sub`). */
@@ -163,14 +171,6 @@ 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.
- */
 type PolitogyFrameData = {
     /** Chrome-API fetcher override for apps that authenticate client-side. */
     fetchJson?: NavChromeFetcher;
@@ -178,11 +178,36 @@ type PolitogyFrameData = {
     devNotes?: ChromeDevNotesConfig;
     /** Controlled org state for apps that own active-org + switching. */
     org?: ControlledOrgState;
-    /** App-owned children for a standard nav entry this app owns (Contacts). */
+    /**
+     * App-owned children for a standard nav entry this app owns (Contacts).
+     * `count` is the live contact total, pre-formatted ("31.9K"), drawn
+     * right-aligned on the Contacts row (Specs/Contacts design rail).
+     */
     contactsItem?: {
         href?: string;
         children?: NavItem[];
+        count?: string | number | null;
     };
+    /**
+     * Top-level standard-nav rows to omit, by label (e.g. `['Polls', 'CTAs']`).
+     * The Specs/Contacts design rail shows exactly Dashboard · Contacts · Email
+     * broadcast · SMS/MMS blast / Calls to action · Forms · Surveys / My profile
+     * · Organization settings. Default: nothing hidden.
+     */
+    hiddenNavItems?: string[];
+    /**
+     * Universal-search placeholder. Defaults per app (Contacts: "Search
+     * contacts, segments, forms"), else "Search".
+     */
+    searchPlaceholder?: string;
+    /**
+     * true: render the rail as flat rows — every standard entry's `children`
+     * are stripped before the sidebar draws, so no row carries an accordion
+     * chevron (Specs/Contacts design rail: nine plain rows). Routing data is
+     * untouched: active-row matching still uses the unstripped tree, exactly
+     * as the 'tabs only' preference does. Default: children kept.
+     */
+    flatNav?: boolean;
     /** Petitions app: nest its own routes under the Petition-mode entry. */
     petitionsItem?: {
         href?: string;
@@ -396,8 +421,11 @@ declare function PolitogyAppChrome({ storagePrefix, proxyBasePath, fetchJson: fe
     identity: ChromeIdentity;
     children: ReactNode;
 }): react_jsx_runtime.JSX.Element;
-/** The standard top-bar action cluster. The Alerts bell renders LAST so it
- * sits farthest right, immediately left of the My Account badge. */
+/** The standard top-bar action cluster — Reference/UI-Platform v30 "Top bar":
+ * Search | Dev notes | Credits | Notifications | Help (farthest right). The
+ * Navigation Display switcher moved into the account menu (0.68.0); the Spec
+ * overlay slot still renders between Credits and Notifications when the
+ * signed-in user is allowed it (it draws nothing otherwise). */
 declare function ChromeTopBarActions(): react_jsx_runtime.JSX.Element | null;
 /** True when any core-org membership carries a super-admin tier. */
 declare function useIsSuperAdmin(): boolean;

package/dist/app-chrome.d.ts

@@ -147,6 +147,14 @@ declare const POLITOGY_APPS: Record<PolitogyAppKey, {
      * product shows the platform's Beta notice is a platform decision.
      */
     beta?: boolean;
+    /**
+     * false: the chrome does NOT draw its own page-title line (the 56px
+     * `<h1>` above `main`); the app's page body owns its title. Specs/Contacts
+     * design: the page opens on its own "RELATIONSHIP MODE" eyebrow + H1, so
+     * a chrome-owned "Contacts" line above it was a second heading not in the
+     * design. Registry-level (platform decision), like `beta`.
+     */
+    pageTitle?: false;
 }>;
 type PolitogyAppSession = {
     /** Stable IdP subject (`sub`). */
@@ -163,14 +171,6 @@ 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.
- */
 type PolitogyFrameData = {
     /** Chrome-API fetcher override for apps that authenticate client-side. */
     fetchJson?: NavChromeFetcher;
@@ -178,11 +178,36 @@ type PolitogyFrameData = {
     devNotes?: ChromeDevNotesConfig;
     /** Controlled org state for apps that own active-org + switching. */
     org?: ControlledOrgState;
-    /** App-owned children for a standard nav entry this app owns (Contacts). */
+    /**
+     * App-owned children for a standard nav entry this app owns (Contacts).
+     * `count` is the live contact total, pre-formatted ("31.9K"), drawn
+     * right-aligned on the Contacts row (Specs/Contacts design rail).
+     */
     contactsItem?: {
         href?: string;
         children?: NavItem[];
+        count?: string | number | null;
     };
+    /**
+     * Top-level standard-nav rows to omit, by label (e.g. `['Polls', 'CTAs']`).
+     * The Specs/Contacts design rail shows exactly Dashboard · Contacts · Email
+     * broadcast · SMS/MMS blast / Calls to action · Forms · Surveys / My profile
+     * · Organization settings. Default: nothing hidden.
+     */
+    hiddenNavItems?: string[];
+    /**
+     * Universal-search placeholder. Defaults per app (Contacts: "Search
+     * contacts, segments, forms"), else "Search".
+     */
+    searchPlaceholder?: string;
+    /**
+     * true: render the rail as flat rows — every standard entry's `children`
+     * are stripped before the sidebar draws, so no row carries an accordion
+     * chevron (Specs/Contacts design rail: nine plain rows). Routing data is
+     * untouched: active-row matching still uses the unstripped tree, exactly
+     * as the 'tabs only' preference does. Default: children kept.
+     */
+    flatNav?: boolean;
     /** Petitions app: nest its own routes under the Petition-mode entry. */
     petitionsItem?: {
         href?: string;
@@ -396,8 +421,11 @@ declare function PolitogyAppChrome({ storagePrefix, proxyBasePath, fetchJson: fe
     identity: ChromeIdentity;
     children: ReactNode;
 }): react_jsx_runtime.JSX.Element;
-/** The standard top-bar action cluster. The Alerts bell renders LAST so it
- * sits farthest right, immediately left of the My Account badge. */
+/** The standard top-bar action cluster — Reference/UI-Platform v30 "Top bar":
+ * Search | Dev notes | Credits | Notifications | Help (farthest right). The
+ * Navigation Display switcher moved into the account menu (0.68.0); the Spec
+ * overlay slot still renders between Credits and Notifications when the
+ * signed-in user is allowed it (it draws nothing otherwise). */
 declare function ChromeTopBarActions(): react_jsx_runtime.JSX.Element | null;
 /** True when any core-org membership carries a super-admin tier. */
 declare function useIsSuperAdmin(): boolean;

package/dist/app-chrome.js

@@ -1,7 +1,7 @@
 "use client";
 import { broadcastLogout, watchLogout } from './chunk-LL6LSJAH.js';
-import { clearBetaBannerDismissal, standardPolitogyNav, isNavItemActive, NavAppShell, NavChromeProvider, FuelAction, NavDisplayAction, TopBarWidgetSlot, SpecOverlayAction, SupportAction, NotificationsAction, useChromeMe, useThemePreference, useNavChromeFetcher, useChromeOrgs } from './chunk-T5ERHFNT.js';
-import './chunk-JHIFJZ73.js';
+import { clearBetaBannerDismissal, standardPolitogyNav, isNavItemActive, NavAppShell, NavChromeProvider, TopBarWidgetSlot, FuelAction, SpecOverlayAction, NotificationsAction, SupportAction, useChromeMe, useThemePreference, useNavChromeFetcher, useChromeOrgs } from './chunk-2UTIX3LI.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';
 import { createContext, useMemo, useRef, useEffect, useState, useCallback, useContext } from 'react';
@@ -473,7 +473,12 @@ var MODE_BRAND_LOGOS = {
 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: { title: "Contacts", origin: "https://contacts.politogyvrm.com", storagePrefix: "contacts" },
+  contacts: {
+    title: "Contacts",
+    origin: "https://contacts.politogyvrm.com",
+    storagePrefix: "contacts",
+    pageTitle: false
+  },
   forms: { title: "Forms", origin: "https://forms.politogyvrm.com", storagePrefix: "forms" },
   surveys: { title: "Surveys", origin: "https://surveys.politogyvrm.com", storagePrefix: "surveys" },
   polls: { title: "Polls", origin: "https://polls.politogyvrm.com", storagePrefix: "polls" },
@@ -514,6 +519,9 @@ var POLITOGY_APPS = {
   canvass: { title: "Field Canvassing", origin: "https://canvass.politogyvrm.com", storagePrefix: "canvass", mode: "campaign" },
   signs: { title: "Sign Mapping", origin: "https://signs.politogyvrm.com", storagePrefix: "signs", mode: "campaign" }
 };
+var DEFAULT_SEARCH_PLACEHOLDER = {
+  contacts: "Search contacts, segments, forms"
+};
 function PolitogyAppFrame({
   app,
   pathname,
@@ -672,10 +680,11 @@ function FrameBody({
       // under it. This is routing data, not chrome configuration.
       contactsItem: data?.contactsItem,
       petitionsItem: data?.petitionsItem,
+      hiddenItems: data?.hiddenNavItems,
       mode: navMode,
       activeOrgId
     }),
-    [data?.contactsItem, data?.petitionsItem, navMode, activeOrgId]
+    [data?.contactsItem, data?.petitionsItem, data?.hiddenNavItems, navMode, activeOrgId]
   );
   const navItems = core?.nav ?? derivedNavItems;
   const navIsActive = useMemo(() => {
@@ -724,7 +733,7 @@ function FrameBody({
             // 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,
+            items: (navDisplay === "tabs" || data?.flatNav === true) && meta.navShape !== "flat" ? navItems.map(({ children: _sub, ...item }) => item) : navItems,
             isActive: navIsActive,
             flatten: meta.navShape === "flat"
           },
@@ -751,7 +760,7 @@ function FrameBody({
         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,
+          title: core?.page?.title ?? (grants?.includes("title") ? data?.frame?.title : void 0) ?? (meta.pageTitle === false ? void 0 : meta.title),
           breadcrumbs,
           user: {
             name: identity.userName,
@@ -767,7 +776,7 @@ 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: {},
+          search: { placeholder: data?.searchPlaceholder ?? DEFAULT_SEARCH_PLACEHOLDER[app] ?? "Search" },
           // "Build notes" — a quiet text button that starts the right-hand
           // group. The spec names the element and its position but not its
           // destination content; `onOpen` is left unset until that is defined.
@@ -1166,8 +1175,6 @@ function ChromeTopBarActions() {
   const state = useChromeState();
   if (!state) return null;
   return /* @__PURE__ */ jsxs(Fragment, { children: [
-    /* @__PURE__ */ jsx(FuelAction, { orgId: state.orgId }),
-    /* @__PURE__ */ jsx(NavDisplayAction, { value: state.navDisplay, onChange: state.setNavDisplay }),
     /* @__PURE__ */ jsx(
       TopBarWidgetSlot,
       {
@@ -1176,9 +1183,10 @@ function ChromeTopBarActions() {
         children: /* @__PURE__ */ jsx(ChromeDevNotesMenu, {})
       }
     ),
+    /* @__PURE__ */ jsx(FuelAction, { orgId: state.orgId }),
     /* @__PURE__ */ jsx(SpecOverlayAction, { orgId: state.orgId, orgName: state.orgs.find((o) => o.id === state.orgId)?.name ?? null }),
-    /* @__PURE__ */ jsx(SupportAction, { orgId: state.orgId }),
-    /* @__PURE__ */ jsx(NotificationsAction, { orgId: state.orgId })
+    /* @__PURE__ */ jsx(NotificationsAction, { orgId: state.orgId }),
+    /* @__PURE__ */ jsx(SupportAction, { orgId: state.orgId })
   ] });
 }
 function ChromeDevNotesMenu() {
@@ -1232,7 +1240,8 @@ function useChromeUserMenu({
     roles: (state?.orgs ?? []).filter((o) => o.rawRole || o.role).map((o) => ({ role: o.rawRole ?? o.role, orgName: o.name })),
     accounts: [{ id: userId, name: userName, email, avatarUrl: null, active: true }],
     addAccountHref: `${coreBase}/my-profile#accounts`,
-    theme: { value: theme.value, onChange: theme.setValue }
+    theme: { value: theme.value, onChange: theme.setValue },
+    navDisplay: state ? { value: state.navDisplay, onChange: state.setNavDisplay } : void 0
   };
 }
 var MODE_DEFS = [
@@ -1295,10 +1304,19 @@ function useChromeMode(arg = {}) {
   return {
     label: current.label,
     icon: current.icon,
-    options: options.length > 1 ? options.map((o) => ({ id: o.id, label: o.label, icon: o.icon })) : void 0,
-    onSelect: options.length > 1 ? (id) => {
+    // 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
+    // reads as available (no layout shift, nothing clickable it shouldn't be).
+    options: MODE_DEFS.map((o) => ({
+      id: o.id,
+      label: o.label,
+      icon: o.icon,
+      available: entitled ? Boolean(entitled[o.id]) || o.id === current.id : o.id === current.id
+    })),
+    onSelect: options.length > 0 ? (id) => {
       const def = MODE_DEFS.find((m) => m.id === id);
-      if (!def) return;
+      if (!def || !entitled?.[def.id]) return;
       setSelectedModeId(id);
       try {
         localStorage.setItem(MODE_STORAGE_KEY, id);