@the-portland-company/shell 0.36.2 → 0.37.0

package/dist/native.d.cts

@@ -18,6 +18,20 @@ type NavIconLike = ComponentType<{
 declare const CORE_APP_ORIGIN = "https://app.politogyvrm.com";
 /** Text/Email fuel top-up page (SMS Signal + Email Broadcast). */
 declare const CORE_BILLING_PATH = "/organization-settings/subscription-billing/text-email";
+/**
+ * Resolve an organization logo URL for rendering in ANY app.
+ *
+ * `organizations.logo_url` is authored by VRM core and stored as a ROOT-RELATIVE
+ * core route — `/api/storage/public?bucket=organization-logos&path=<org>/logo.png`
+ * (the signed-storage proxy). VRM core renders it correctly because that path
+ * resolves against its own origin; every other app resolves it against its own
+ * origin (forms.politogyvrm.com/api/storage/public), gets a 404, and shows a
+ * broken image. The chrome API passes the stored value through verbatim, so the
+ * resolution belongs here — one definition for every app, core included.
+ *
+ * Absolute URLs (http/https/data/blob) pass through untouched.
+ */
+declare function resolveOrgLogoUrl(url: string | null | undefined): string | undefined;
 declare function topBarIconButtonClass(tone?: 'default' | 'warning' | 'danger'): string;
 /** The shared count badge — one definition, used by every slot. */
 declare function TopBarCountBadge({ count }: {
@@ -67,6 +81,9 @@ type ChromeMe = {
     userName: string | null;
     avatarUrl: string | null;
     themePreference: string | null;
+    /** Universal navigation-display choice ('menu'|'tabs'|'both'); null when
+     *  unset or when the profile column is absent in this environment. */
+    navDisplay: string | null;
     account?: string | null;
     accountName?: string | null;
     role?: string | null;
@@ -609,4 +626,4 @@ type NavAppShellProps = {
 };
 declare function NavAppShell({ sidebar, topBar, betaBanner, contentWrapper, children, }: NavAppShellProps): react_jsx_runtime.JSX.Element;
 
-export { CAMPAIGN_FEATURE_AVAILABILITY, CORE_APP_ORIGIN, CORE_BILLING_PATH, type CampaignFeatureAvailability, type ChromeMe, type ChromeNotificationAlert, type ChromeNotificationImport, type ChromeNotificationQuarantine, type ChromeNotificationReply, type ChromeNotificationsPayload, type ChromeOrgSummary, type CommunicationsFuelStatus, FuelAction, type FuelChannelStatus, NavAppShell, type NavAppShellProps, NavBetaBanner, type NavBetaBannerProps, type NavBrand, type NavBreadcrumb, type NavChromeFetcher, NavChromeProvider, NavDisplayAction, type NavDisplayMode, type NavFooter, type NavFooterLink, type NavIcon, type NavItem, type NavLinkComponent, type NavLinkProps, type NavLinkedAccount, type NavMode, type NavModeOption, type NavOrg, type NavOrgOption, type NavRoleBadge, NavSidebar, type NavSidebarProps, type NavTab, NavTabStrip, type NavTabStripProps, NavThemeControl, NavTopBar, type NavTopBarAction, type NavTopBarProps, type NavUser, type NavUserMenu, NotificationsAction, type StandardNavIconKey, type StandardNavMode, type StandardNavOptions, SupportAction, type ThemePreference, TopBarCountBadge, TopBarPanelArrow, TopBarPopover, TopBarTooltip, TopBarWidgetSlot, envChipClasses, isNavItemActive, standardPolitogyNav, topBarIconButtonClass, useChromeMe, useChromeOrgs, useNavChromeFetcher, useThemePreference };
+export { CAMPAIGN_FEATURE_AVAILABILITY, CORE_APP_ORIGIN, CORE_BILLING_PATH, type CampaignFeatureAvailability, type ChromeMe, type ChromeNotificationAlert, type ChromeNotificationImport, type ChromeNotificationQuarantine, type ChromeNotificationReply, type ChromeNotificationsPayload, type ChromeOrgSummary, type CommunicationsFuelStatus, FuelAction, type FuelChannelStatus, NavAppShell, type NavAppShellProps, NavBetaBanner, type NavBetaBannerProps, type NavBrand, type NavBreadcrumb, type NavChromeFetcher, NavChromeProvider, NavDisplayAction, type NavDisplayMode, type NavFooter, type NavFooterLink, type NavIcon, type NavItem, type NavLinkComponent, type NavLinkProps, type NavLinkedAccount, type NavMode, type NavModeOption, type NavOrg, type NavOrgOption, type NavRoleBadge, NavSidebar, type NavSidebarProps, type NavTab, NavTabStrip, type NavTabStripProps, NavThemeControl, NavTopBar, type NavTopBarAction, type NavTopBarProps, type NavUser, type NavUserMenu, NotificationsAction, type StandardNavIconKey, type StandardNavMode, type StandardNavOptions, SupportAction, type ThemePreference, TopBarCountBadge, TopBarPanelArrow, TopBarPopover, TopBarTooltip, TopBarWidgetSlot, envChipClasses, isNavItemActive, resolveOrgLogoUrl, standardPolitogyNav, topBarIconButtonClass, useChromeMe, useChromeOrgs, useNavChromeFetcher, useThemePreference };

package/dist/native.d.ts

@@ -18,6 +18,20 @@ type NavIconLike = ComponentType<{
 declare const CORE_APP_ORIGIN = "https://app.politogyvrm.com";
 /** Text/Email fuel top-up page (SMS Signal + Email Broadcast). */
 declare const CORE_BILLING_PATH = "/organization-settings/subscription-billing/text-email";
+/**
+ * Resolve an organization logo URL for rendering in ANY app.
+ *
+ * `organizations.logo_url` is authored by VRM core and stored as a ROOT-RELATIVE
+ * core route — `/api/storage/public?bucket=organization-logos&path=<org>/logo.png`
+ * (the signed-storage proxy). VRM core renders it correctly because that path
+ * resolves against its own origin; every other app resolves it against its own
+ * origin (forms.politogyvrm.com/api/storage/public), gets a 404, and shows a
+ * broken image. The chrome API passes the stored value through verbatim, so the
+ * resolution belongs here — one definition for every app, core included.
+ *
+ * Absolute URLs (http/https/data/blob) pass through untouched.
+ */
+declare function resolveOrgLogoUrl(url: string | null | undefined): string | undefined;
 declare function topBarIconButtonClass(tone?: 'default' | 'warning' | 'danger'): string;
 /** The shared count badge — one definition, used by every slot. */
 declare function TopBarCountBadge({ count }: {
@@ -67,6 +81,9 @@ type ChromeMe = {
     userName: string | null;
     avatarUrl: string | null;
     themePreference: string | null;
+    /** Universal navigation-display choice ('menu'|'tabs'|'both'); null when
+     *  unset or when the profile column is absent in this environment. */
+    navDisplay: string | null;
     account?: string | null;
     accountName?: string | null;
     role?: string | null;
@@ -609,4 +626,4 @@ type NavAppShellProps = {
 };
 declare function NavAppShell({ sidebar, topBar, betaBanner, contentWrapper, children, }: NavAppShellProps): react_jsx_runtime.JSX.Element;
 
-export { CAMPAIGN_FEATURE_AVAILABILITY, CORE_APP_ORIGIN, CORE_BILLING_PATH, type CampaignFeatureAvailability, type ChromeMe, type ChromeNotificationAlert, type ChromeNotificationImport, type ChromeNotificationQuarantine, type ChromeNotificationReply, type ChromeNotificationsPayload, type ChromeOrgSummary, type CommunicationsFuelStatus, FuelAction, type FuelChannelStatus, NavAppShell, type NavAppShellProps, NavBetaBanner, type NavBetaBannerProps, type NavBrand, type NavBreadcrumb, type NavChromeFetcher, NavChromeProvider, NavDisplayAction, type NavDisplayMode, type NavFooter, type NavFooterLink, type NavIcon, type NavItem, type NavLinkComponent, type NavLinkProps, type NavLinkedAccount, type NavMode, type NavModeOption, type NavOrg, type NavOrgOption, type NavRoleBadge, NavSidebar, type NavSidebarProps, type NavTab, NavTabStrip, type NavTabStripProps, NavThemeControl, NavTopBar, type NavTopBarAction, type NavTopBarProps, type NavUser, type NavUserMenu, NotificationsAction, type StandardNavIconKey, type StandardNavMode, type StandardNavOptions, SupportAction, type ThemePreference, TopBarCountBadge, TopBarPanelArrow, TopBarPopover, TopBarTooltip, TopBarWidgetSlot, envChipClasses, isNavItemActive, standardPolitogyNav, topBarIconButtonClass, useChromeMe, useChromeOrgs, useNavChromeFetcher, useThemePreference };
+export { CAMPAIGN_FEATURE_AVAILABILITY, CORE_APP_ORIGIN, CORE_BILLING_PATH, type CampaignFeatureAvailability, type ChromeMe, type ChromeNotificationAlert, type ChromeNotificationImport, type ChromeNotificationQuarantine, type ChromeNotificationReply, type ChromeNotificationsPayload, type ChromeOrgSummary, type CommunicationsFuelStatus, FuelAction, type FuelChannelStatus, NavAppShell, type NavAppShellProps, NavBetaBanner, type NavBetaBannerProps, type NavBrand, type NavBreadcrumb, type NavChromeFetcher, NavChromeProvider, NavDisplayAction, type NavDisplayMode, type NavFooter, type NavFooterLink, type NavIcon, type NavItem, type NavLinkComponent, type NavLinkProps, type NavLinkedAccount, type NavMode, type NavModeOption, type NavOrg, type NavOrgOption, type NavRoleBadge, NavSidebar, type NavSidebarProps, type NavTab, NavTabStrip, type NavTabStripProps, NavThemeControl, NavTopBar, type NavTopBarAction, type NavTopBarProps, type NavUser, type NavUserMenu, NotificationsAction, type StandardNavIconKey, type StandardNavMode, type StandardNavOptions, SupportAction, type ThemePreference, TopBarCountBadge, TopBarPanelArrow, TopBarPopover, TopBarTooltip, TopBarWidgetSlot, envChipClasses, isNavItemActive, resolveOrgLogoUrl, standardPolitogyNav, topBarIconButtonClass, useChromeMe, useChromeOrgs, useNavChromeFetcher, useThemePreference };

package/dist/native.js

@@ -1,5 +1,5 @@
 "use client";
-export { CAMPAIGN_FEATURE_AVAILABILITY, CORE_APP_ORIGIN, CORE_BILLING_PATH, FuelAction, NavAppShell, NavBetaBanner, NavChromeProvider, NavDisplayAction, NavSidebar, NavTabStrip, NavThemeControl, NavTopBar, NotificationsAction, SupportAction, TopBarCountBadge, TopBarPanelArrow, TopBarPopover, TopBarTooltip, TopBarWidgetSlot, envChipClasses, isNavItemActive, standardPolitogyNav, topBarIconButtonClass, useChromeMe, useChromeOrgs, useNavChromeFetcher, useThemePreference } from './chunk-LIGKGXFT.js';
+export { CAMPAIGN_FEATURE_AVAILABILITY, CORE_APP_ORIGIN, CORE_BILLING_PATH, FuelAction, NavAppShell, NavBetaBanner, NavChromeProvider, NavDisplayAction, NavSidebar, NavTabStrip, NavThemeControl, NavTopBar, NotificationsAction, SupportAction, TopBarCountBadge, TopBarPanelArrow, TopBarPopover, TopBarTooltip, TopBarWidgetSlot, envChipClasses, isNavItemActive, resolveOrgLogoUrl, standardPolitogyNav, topBarIconButtonClass, useChromeMe, useChromeOrgs, useNavChromeFetcher, useThemePreference } from './chunk-CGSS2PDG.js';
 import './chunk-LL7RCJQN.js';
 //# sourceMappingURL=native.js.map
 //# sourceMappingURL=native.js.map

package/dist/nav-preference.cjs

@@ -0,0 +1,75 @@
+'use strict';
+
+// src/nav-preference.ts
+var NAV_DISPLAY_STORAGE_KEY = "politogy_nav_display";
+var NAV_DISPLAY_COOKIE = "politogy_nav_display";
+var LEGACY_NAV_DISPLAY_KEY = "vrm.navDisplay";
+var NAV_DISPLAY_DEFAULT = "both";
+var VALID = ["menu", "tabs", "both"];
+function isNavDisplayPreference(v) {
+  return typeof v === "string" && VALID.includes(v);
+}
+function readNavDisplayCookie() {
+  if (typeof document === "undefined") return null;
+  try {
+    const m = document.cookie.match(
+      new RegExp(`(?:^|;\\s*)${NAV_DISPLAY_COOKIE}=([^;]+)`)
+    );
+    const v = m ? decodeURIComponent(m[1]) : null;
+    return isNavDisplayPreference(v) ? v : null;
+  } catch {
+    return null;
+  }
+}
+function writeNavDisplayCookie(pref) {
+  if (typeof document === "undefined" || typeof window === "undefined") return;
+  const host = window.location.hostname;
+  const domainAttr = /(^|\.)politogyvrm\.com$/i.test(host) ? "; Domain=.politogyvrm.com" : "";
+  const secure = window.location.protocol === "https:" ? "; Secure" : "";
+  document.cookie = `${NAV_DISPLAY_COOKIE}=${encodeURIComponent(
+    pref
+  )}; Path=/; Max-Age=31536000; SameSite=Lax${domainAttr}${secure}`;
+}
+function readNavDisplayLocal() {
+  if (typeof localStorage === "undefined") return null;
+  try {
+    const current = localStorage.getItem(NAV_DISPLAY_STORAGE_KEY);
+    if (isNavDisplayPreference(current)) return current;
+    const legacy = localStorage.getItem(LEGACY_NAV_DISPLAY_KEY);
+    return isNavDisplayPreference(legacy) ? legacy : null;
+  } catch {
+    return null;
+  }
+}
+function writeNavDisplayLocal(pref) {
+  if (typeof localStorage === "undefined") return;
+  try {
+    localStorage.setItem(NAV_DISPLAY_STORAGE_KEY, pref);
+  } catch {
+  }
+}
+function resolveNavDisplay() {
+  return readNavDisplayCookie() ?? readNavDisplayLocal() ?? NAV_DISPLAY_DEFAULT;
+}
+var NAV_DISPLAY_PREPAINT_SCRIPT = `(function(){try{
+var KEY=${JSON.stringify(NAV_DISPLAY_STORAGE_KEY)};
+var VALID=["menu","tabs","both"];
+function fromCookie(){try{var m=document.cookie.match(/(?:^|;\\s*)${NAV_DISPLAY_COOKIE}=([^;]+)/);return m?decodeURIComponent(m[1]):null;}catch(e){return null;}}
+var cookie=fromCookie();
+if(cookie&&VALID.indexOf(cookie)!==-1){var ls=null;try{ls=localStorage.getItem(KEY);}catch(e){}
+if(cookie!==ls){try{localStorage.setItem(KEY,cookie);}catch(e){}}}
+}catch(e){}})();`;
+
+exports.LEGACY_NAV_DISPLAY_KEY = LEGACY_NAV_DISPLAY_KEY;
+exports.NAV_DISPLAY_COOKIE = NAV_DISPLAY_COOKIE;
+exports.NAV_DISPLAY_DEFAULT = NAV_DISPLAY_DEFAULT;
+exports.NAV_DISPLAY_PREPAINT_SCRIPT = NAV_DISPLAY_PREPAINT_SCRIPT;
+exports.NAV_DISPLAY_STORAGE_KEY = NAV_DISPLAY_STORAGE_KEY;
+exports.isNavDisplayPreference = isNavDisplayPreference;
+exports.readNavDisplayCookie = readNavDisplayCookie;
+exports.readNavDisplayLocal = readNavDisplayLocal;
+exports.resolveNavDisplay = resolveNavDisplay;
+exports.writeNavDisplayCookie = writeNavDisplayCookie;
+exports.writeNavDisplayLocal = writeNavDisplayLocal;
+//# sourceMappingURL=nav-preference.cjs.map
+//# sourceMappingURL=nav-preference.cjs.map

package/dist/nav-preference.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/nav-preference.ts"],"names":[],"mappings":";;;AAwBO,IAAM,uBAAA,GAA0B;AAChC,IAAM,kBAAA,GAAqB;AAG3B,IAAM,sBAAA,GAAyB;AAE/B,IAAM,mBAAA,GAA4C;AAEzD,IAAM,KAAA,GAAyC,CAAC,MAAA,EAAQ,MAAA,EAAQ,MAAM,CAAA;AAE/D,SAAS,uBAAuB,CAAA,EAAuC;AAC5E,EAAA,OAAO,OAAO,CAAA,KAAM,QAAA,IAAa,KAAA,CAA4B,SAAS,CAAC,CAAA;AACzE;AAGO,SAAS,oBAAA,GAAoD;AAClE,EAAA,IAAI,OAAO,QAAA,KAAa,WAAA,EAAa,OAAO,IAAA;AAC5C,EAAA,IAAI;AACF,IAAA,MAAM,CAAA,GAAI,SAAS,MAAA,CAAO,KAAA;AAAA,MACxB,IAAI,MAAA,CAAO,CAAA,WAAA,EAAc,kBAAkB,CAAA,QAAA,CAAU;AAAA,KACvD;AACA,IAAA,MAAM,IAAI,CAAA,GAAI,kBAAA,CAAmB,CAAA,CAAE,CAAC,CAAC,CAAA,GAAI,IAAA;AACzC,IAAA,OAAO,sBAAA,CAAuB,CAAC,CAAA,GAAI,CAAA,GAAI,IAAA;AAAA,EACzC,CAAA,CAAA,MAAQ;AACN,IAAA,OAAO,IAAA;AAAA,EACT;AACF;AAMO,SAAS,sBAAsB,IAAA,EAAkC;AACtE,EAAA,IAAI,OAAO,QAAA,KAAa,WAAA,IAAe,OAAO,WAAW,WAAA,EAAa;AACtE,EAAA,MAAM,IAAA,GAAO,OAAO,QAAA,CAAS,QAAA;AAC7B,EAAA,MAAM,UAAA,GAAa,0BAAA,CAA2B,IAAA,CAAK,IAAI,IAAI,2BAAA,GAA8B,EAAA;AACzF,EAAA,MAAM,MAAA,GAAS,MAAA,CAAO,QAAA,CAAS,QAAA,KAAa,WAAW,UAAA,GAAa,EAAA;AACpE,EAAA,QAAA,CAAS,MAAA,GAAS,CAAA,EAAG,kBAAkB,CAAA,CAAA,EAAI,kBAAA;AAAA,IACzC;AAAA,GACD,CAAA,wCAAA,EAA2C,UAAU,CAAA,EAAG,MAAM,CAAA,CAAA;AACjE;AAGO,SAAS,mBAAA,GAAmD;AACjE,EAAA,IAAI,OAAO,YAAA,KAAiB,WAAA,EAAa,OAAO,IAAA;AAChD,EAAA,IAAI;AACF,IAAA,MAAM,OAAA,GAAU,YAAA,CAAa,OAAA,CAAQ,uBAAuB,CAAA;AAC5D,IAAA,IAAI,sBAAA,CAAuB,OAAO,CAAA,EAAG,OAAO,OAAA;AAC5C,IAAA,MAAM,MAAA,GAAS,YAAA,CAAa,OAAA,CAAQ,sBAAsB,CAAA;AAC1D,IAAA,OAAO,sBAAA,CAAuB,MAAM,CAAA,GAAI,MAAA,GAAS,IAAA;AAAA,EACnD,CAAA,CAAA,MAAQ;AACN,IAAA,OAAO,IAAA;AAAA,EACT;AACF;AAEO,SAAS,qBAAqB,IAAA,EAAkC;AACrE,EAAA,IAAI,OAAO,iBAAiB,WAAA,EAAa;AACzC,EAAA,IAAI;AACF,IAAA,YAAA,CAAa,OAAA,CAAQ,yBAAyB,IAAI,CAAA;AAAA,EACpD,CAAA,CAAA,MAAQ;AAAA,EAER;AACF;AAGO,SAAS,iBAAA,GAA0C;AACxD,EAAA,OAAO,oBAAA,EAAqB,IAAK,mBAAA,EAAoB,IAAK,mBAAA;AAC5D;AAMO,IAAM,2BAAA,GAA8B,CAAA;AAAA,QAAA,EACjC,IAAA,CAAK,SAAA,CAAU,uBAAuB,CAAC,CAAA;AAAA;AAAA,kEAAA,EAEmB,kBAAkB,CAAA;AAAA;AAAA;AAAA;AAAA,gBAAA","file":"nav-preference.cjs","sourcesContent":["// Universal navigation-display preference — the same cross-app contract as the\n// theme (see ./theme-preference, which this deliberately mirrors).\n//\n// The user's choice of how navigation renders (Menu / Tabs / Both) follows the\n// authenticated user across every Politogy app + subdomain. Three layers:\n//   1. VRM Core `profiles.nav_display_preference` — source of truth, persisted\n//      via the chrome API (`PATCH me/preferences { navDisplay }`) and read back\n//      from `GET me` (`navDisplay`).\n//   2. `.politogyvrm.com` cookie `politogy_nav_display` — the cross-subdomain\n//      vehicle (app session cookies are host-only, and so is localStorage).\n//   3. localStorage — same-app fast reads and cross-tab `storage` events.\n//\n// Before this existed the preference lived ONLY in localStorage under\n// `vrm.navDisplay`, which is per-ORIGIN: every app subdomain kept its own copy\n// and a freshly opened app booted the default, so the setting appeared not to\n// hold when moving between apps. The legacy key is still read as a fallback so\n// an existing local choice survives the upgrade.\n//\n// Server-safe (no 'use client'): layouts may import NAV_DISPLAY_PREPAINT_SCRIPT.\n\nexport type NavDisplayPreference = 'menu' | 'tabs' | 'both'\n\n// One key for BOTH the localStorage store and the cross-subdomain cookie, so a\n// choice in one app is the same key in the next.\nexport const NAV_DISPLAY_STORAGE_KEY = 'politogy_nav_display'\nexport const NAV_DISPLAY_COOKIE = 'politogy_nav_display'\n\n/** Pre-0.37 host-only key. Read for migration; never written. */\nexport const LEGACY_NAV_DISPLAY_KEY = 'vrm.navDisplay'\n\nexport const NAV_DISPLAY_DEFAULT: NavDisplayPreference = 'both'\n\nconst VALID: readonly NavDisplayPreference[] = ['menu', 'tabs', 'both']\n\nexport function isNavDisplayPreference(v: unknown): v is NavDisplayPreference {\n  return typeof v === 'string' && (VALID as readonly string[]).includes(v)\n}\n\n/** Read the shared cookie (browser only; null on the server or when unset). */\nexport function readNavDisplayCookie(): NavDisplayPreference | null {\n  if (typeof document === 'undefined') return null\n  try {\n    const m = document.cookie.match(\n      new RegExp(`(?:^|;\\\\s*)${NAV_DISPLAY_COOKIE}=([^;]+)`),\n    )\n    const v = m ? decodeURIComponent(m[1]) : null\n    return isNavDisplayPreference(v) ? v : null\n  } catch {\n    return null\n  }\n}\n\n// Same host-aware scoping as the theme cookie: parent domain on\n// *.politogyvrm.com so every app subdomain reads it, host-only elsewhere\n// (localhost, *.pages.dev preview) because browsers silently drop a mismatched\n// Domain attribute. 1-year, SameSite=Lax, Secure on https.\nexport function writeNavDisplayCookie(pref: NavDisplayPreference): void {\n  if (typeof document === 'undefined' || typeof window === 'undefined') return\n  const host = window.location.hostname\n  const domainAttr = /(^|\\.)politogyvrm\\.com$/i.test(host) ? '; Domain=.politogyvrm.com' : ''\n  const secure = window.location.protocol === 'https:' ? '; Secure' : ''\n  document.cookie = `${NAV_DISPLAY_COOKIE}=${encodeURIComponent(\n    pref,\n  )}; Path=/; Max-Age=31536000; SameSite=Lax${domainAttr}${secure}`\n}\n\n/** Read the local store, falling back to the legacy host-only key. */\nexport function readNavDisplayLocal(): NavDisplayPreference | null {\n  if (typeof localStorage === 'undefined') return null\n  try {\n    const current = localStorage.getItem(NAV_DISPLAY_STORAGE_KEY)\n    if (isNavDisplayPreference(current)) return current\n    const legacy = localStorage.getItem(LEGACY_NAV_DISPLAY_KEY)\n    return isNavDisplayPreference(legacy) ? legacy : null\n  } catch {\n    return null\n  }\n}\n\nexport function writeNavDisplayLocal(pref: NavDisplayPreference): void {\n  if (typeof localStorage === 'undefined') return\n  try {\n    localStorage.setItem(NAV_DISPLAY_STORAGE_KEY, pref)\n  } catch {\n    /* storage unavailable */\n  }\n}\n\n/** Boot precedence: cookie → localStorage (incl. legacy) → default. */\nexport function resolveNavDisplay(): NavDisplayPreference {\n  return readNavDisplayCookie() ?? readNavDisplayLocal() ?? NAV_DISPLAY_DEFAULT\n}\n\n// Inline pre-paint script — optional, and the mirror of THEME_PREPAINT_SCRIPT.\n// Nav display has no paint-blocking visual (the frame is client-rendered), but\n// seeding localStorage from the cookie before hydration keeps the first render\n// on the synced value instead of the default. Self-contained and silent.\nexport const NAV_DISPLAY_PREPAINT_SCRIPT = `(function(){try{\nvar KEY=${JSON.stringify(NAV_DISPLAY_STORAGE_KEY)};\nvar VALID=[\"menu\",\"tabs\",\"both\"];\nfunction fromCookie(){try{var m=document.cookie.match(/(?:^|;\\\\s*)${NAV_DISPLAY_COOKIE}=([^;]+)/);return m?decodeURIComponent(m[1]):null;}catch(e){return null;}}\nvar cookie=fromCookie();\nif(cookie&&VALID.indexOf(cookie)!==-1){var ls=null;try{ls=localStorage.getItem(KEY);}catch(e){}\nif(cookie!==ls){try{localStorage.setItem(KEY,cookie);}catch(e){}}}\n}catch(e){}})();`\n"]}

package/dist/nav-preference.d.cts

@@ -0,0 +1,18 @@
+type NavDisplayPreference = 'menu' | 'tabs' | 'both';
+declare const NAV_DISPLAY_STORAGE_KEY = "politogy_nav_display";
+declare const NAV_DISPLAY_COOKIE = "politogy_nav_display";
+/** Pre-0.37 host-only key. Read for migration; never written. */
+declare const LEGACY_NAV_DISPLAY_KEY = "vrm.navDisplay";
+declare const NAV_DISPLAY_DEFAULT: NavDisplayPreference;
+declare function isNavDisplayPreference(v: unknown): v is NavDisplayPreference;
+/** Read the shared cookie (browser only; null on the server or when unset). */
+declare function readNavDisplayCookie(): NavDisplayPreference | null;
+declare function writeNavDisplayCookie(pref: NavDisplayPreference): void;
+/** Read the local store, falling back to the legacy host-only key. */
+declare function readNavDisplayLocal(): NavDisplayPreference | null;
+declare function writeNavDisplayLocal(pref: NavDisplayPreference): void;
+/** Boot precedence: cookie → localStorage (incl. legacy) → default. */
+declare function resolveNavDisplay(): NavDisplayPreference;
+declare const NAV_DISPLAY_PREPAINT_SCRIPT: string;
+
+export { LEGACY_NAV_DISPLAY_KEY, NAV_DISPLAY_COOKIE, NAV_DISPLAY_DEFAULT, NAV_DISPLAY_PREPAINT_SCRIPT, NAV_DISPLAY_STORAGE_KEY, type NavDisplayPreference, isNavDisplayPreference, readNavDisplayCookie, readNavDisplayLocal, resolveNavDisplay, writeNavDisplayCookie, writeNavDisplayLocal };

package/dist/nav-preference.d.ts

@@ -0,0 +1,18 @@
+type NavDisplayPreference = 'menu' | 'tabs' | 'both';
+declare const NAV_DISPLAY_STORAGE_KEY = "politogy_nav_display";
+declare const NAV_DISPLAY_COOKIE = "politogy_nav_display";
+/** Pre-0.37 host-only key. Read for migration; never written. */
+declare const LEGACY_NAV_DISPLAY_KEY = "vrm.navDisplay";
+declare const NAV_DISPLAY_DEFAULT: NavDisplayPreference;
+declare function isNavDisplayPreference(v: unknown): v is NavDisplayPreference;
+/** Read the shared cookie (browser only; null on the server or when unset). */
+declare function readNavDisplayCookie(): NavDisplayPreference | null;
+declare function writeNavDisplayCookie(pref: NavDisplayPreference): void;
+/** Read the local store, falling back to the legacy host-only key. */
+declare function readNavDisplayLocal(): NavDisplayPreference | null;
+declare function writeNavDisplayLocal(pref: NavDisplayPreference): void;
+/** Boot precedence: cookie → localStorage (incl. legacy) → default. */
+declare function resolveNavDisplay(): NavDisplayPreference;
+declare const NAV_DISPLAY_PREPAINT_SCRIPT: string;
+
+export { LEGACY_NAV_DISPLAY_KEY, NAV_DISPLAY_COOKIE, NAV_DISPLAY_DEFAULT, NAV_DISPLAY_PREPAINT_SCRIPT, NAV_DISPLAY_STORAGE_KEY, type NavDisplayPreference, isNavDisplayPreference, readNavDisplayCookie, readNavDisplayLocal, resolveNavDisplay, writeNavDisplayCookie, writeNavDisplayLocal };

package/dist/nav-preference.js

@@ -0,0 +1,3 @@
+export { LEGACY_NAV_DISPLAY_KEY, NAV_DISPLAY_COOKIE, NAV_DISPLAY_DEFAULT, NAV_DISPLAY_PREPAINT_SCRIPT, NAV_DISPLAY_STORAGE_KEY, isNavDisplayPreference, readNavDisplayCookie, readNavDisplayLocal, resolveNavDisplay, writeNavDisplayCookie, writeNavDisplayLocal } from './chunk-6UHJV2FH.js';
+//# sourceMappingURL=nav-preference.js.map
+//# sourceMappingURL=nav-preference.js.map

package/dist/nav-preference.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"nav-preference.js"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@the-portland-company/shell",
-  "version": "0.36.2",
+  "version": "0.37.0",
   "description": "Shared chrome (header, sidebar, footer, theme, auth) for politogy apps. Drop into any Vite SPA to inherit the politogy look and signed-in user.",
   "license": "UNLICENSED",
   "private": false,
@@ -36,6 +36,11 @@
       "import": "./dist/theme-preference.js",
       "require": "./dist/theme-preference.cjs"
     },
+    "./nav-preference": {
+      "types": "./dist/nav-preference.d.ts",
+      "import": "./dist/nav-preference.js",
+      "require": "./dist/nav-preference.cjs"
+    },
     "./active-org": {
       "types": "./dist/active-org.d.ts",
       "import": "./dist/active-org.js",