@the-portland-company/shell 0.97.0 → 0.97.1

package/dist/{index-BaUIPQpN.d.cts → index-SHcw15A4.d.cts}

@@ -300,9 +300,19 @@ declare function TopBarCountBadge({ count }: {
  * Pure CSS (group-hover) so it works on <a>, <button> and <summary> triggers.
  * The trigger must carry `group/tbtip relative` (topBarIconButtonClass does).
  */
-declare function TopBarTooltip({ title, description, }: {
+declare function TopBarTooltip({ title, description, align, }: {
     title: string;
     description?: ReactNode;
+    /**
+     * `center` (default): the body is centered under the trigger.
+     * `end`: the body's right edge lines up with the trigger's right edge, so a
+     * control at the right end of the top bar (Organization settings, My profile)
+     * keeps its tooltip on screen. The arrow stays on the trigger's center either
+     * way (Brand guideline "Tooltips point at their trigger"). Measured
+     * 2026-11-05 at 1547px: the centered 224px body ran 75px past the viewport
+     * for My profile and 35px for Organization settings.
+     */
+    align?: 'center' | 'end';
 }): react_jsx_runtime.JSX.Element;
 /**
  * The up-pointing arrow every top-bar panel renders, anchored under its
@@ -804,6 +814,25 @@ declare function modeIdFromLabel(label: string | undefined): string | undefined;
 declare function shortUserName(name: string): string;
 /** Short environment name for the rail's build line ("prod", "staging", "local"). */
 declare function shortEnvLabel(label: string): string;
+/**
+ * The left-bar build line (Left-Navigation §10, UI-Platform → Debug info;
+ * decided 2026-11-05, Ben): ONE quiet line, `v<version> · <Mon D>`, 10px mono
+ * in the inactive-row gray (`--sidebar-row-text`: 66% white, #F0CFD2 on the
+ * Campaign rail; the dimmest rail gray that clears 4.5:1 on both rails). The
+ * full build info (env, commit, version, date, author) is the hover title, so
+ * it stays one hover away for the team. Replaces the two rows
+ * `env | commit | version` / `date | author` until the Debug info button ships.
+ */
+declare function buildLineParts(meta: {
+    envLabel?: string;
+    version?: string;
+    commit?: string;
+    commitDate?: string;
+    commitAuthor?: string;
+}): {
+    line: string;
+    detail: string;
+};
 declare function envChipClasses(label: string): string;
 type NavBrand = {
     /** Where the logo links to. Defaults to "/". */
@@ -1259,4 +1288,4 @@ type NavAppShellProps = {
 };
 declare function NavAppShell({ sidebar, topBar, betaBanner, contentWrapper, accountMenuPlacement, modeId, children, }: NavAppShellProps): react_jsx_runtime.JSX.Element;
 
-export { type CreditHealthState as $, AI_CREDITS_STATE_TITLES as A, type BreadcrumbBarProps as B, Card as C, BETA_BANNER_DISMISS_KEY as D, BreadcrumbBar as E, FormColumn as F, CAMPAIGN_FEATURE_AVAILABILITY as G, HeaderTabBar as H, CORE_APP_ORIGIN as I, CORE_BILLING_PATH as J, KNOWN_TAB_GLYPHS as K, CREDIT_TYPE_LABELS as L, CREDIT_TYPE_ORDER as M, type NavItem as N, type CampaignFeatureAvailability as O, type PageHeaderProps as P, type ChromeMe as Q, RowMenu as R, type StandardNavIconKey as S, type TabGlyphComponent as T, type ChromeNotificationAlert as U, type ChromeNotificationImport as V, type ChromeNotificationQuarantine as W, type ChromeNotificationReply as X, type ChromeNotificationsPayload as Y, type ChromeOrgSummary as Z, type CommunicationsFuelStatus as _, AiCreditsState as a, useThemePreference as a$, type CreditTypeKey as a0, CreditsAction as a1, type CreditsIconState as a2, FuelAction as a3, type FuelChannelStatus as a4, MyProfileAction as a5, NavAppShell as a6, type NavAppShellProps as a7, NavBetaBanner as a8, type NavBetaBannerProps as a9, type ThemePreference as aA, TopBarCountBadge as aB, type TopBarIconTone as aC, TopBarLinkAction as aD, type TopBarLinkActionProps as aE, TopBarPanelArrow as aF, TopBarPopover as aG, TopBarTooltip as aH, TopBarWidgetSlot as aI, clearBetaBannerDismissal as aJ, creditGaugeRatio as aK, creditStateWord as aL, creditTooltipLine as aM, creditsAriaLabel as aN, creditsIconState as aO, envChipClasses as aP, isNavItemActive as aQ, modeIdFromLabel as aR, resolveOrgLogoUrl as aS, shortEnvLabel as aT, shortUserName as aU, standardPolitogyNav as aV, topBarIconButtonClass as aW, useChromeMe as aX, useChromeOrgs as aY, useNavChromeDedupedFetch as aZ, useNavChromeFetcher as a_, type NavBrand as aa, NavChromeProvider as ab, NavDisplayAction as ac, type NavLinkProps as ad, type NavLinkedAccount as ae, type NavModeOption as af, type NavOrg as ag, type NavRoleBadge as ah, NavSidebar as ai, type NavSidebarProps as aj, type NavTab as ak, NavTabStrip as al, type NavTabStripProps as am, NavThemeControl as an, NavTopBar as ao, type NavTopBarAction as ap, type NavTopBarProps as aq, type NavUser as ar, NotificationsAction as as, OrganizationSettingsAction as at, PageHeader as au, type PageHeaderMode as av, SPECS_ORIGIN as aw, SpecOverlayAction as ax, type StandardNavOptions as ay, SupportAction as az, type AiCreditsStateKind as b, type CommsNotification as c, type CommsNotificationKind as d, type HeaderTabBarItem as e, type NotificationsAdapter as f, type NotificationsFeed as g, RowMenuItem as h, type RowMenuPlacement as i, aiCreditsWalletUrl as j, createCommsNotificationsAdapter as k, emptyNotificationsFeed as l, rowMenuPosition as m, normalizeNotificationsFeed as n, type NavIcon as o, type NavBreadcrumb as p, type StandardNavMode as q, resolveTabGlyph as r, type NavLinkComponent as s, type NavChromeFetcher as t, type NavMode as u, type NavUserMenu as v, type NavOrgOption as w, type NavFooterLink as x, type NavFooter as y, type NavDisplayMode as z };
+export { type CreditHealthState as $, AI_CREDITS_STATE_TITLES as A, type BreadcrumbBarProps as B, Card as C, BETA_BANNER_DISMISS_KEY as D, BreadcrumbBar as E, FormColumn as F, CAMPAIGN_FEATURE_AVAILABILITY as G, HeaderTabBar as H, CORE_APP_ORIGIN as I, CORE_BILLING_PATH as J, KNOWN_TAB_GLYPHS as K, CREDIT_TYPE_LABELS as L, CREDIT_TYPE_ORDER as M, type NavItem as N, type CampaignFeatureAvailability as O, type PageHeaderProps as P, type ChromeMe as Q, RowMenu as R, type StandardNavIconKey as S, type TabGlyphComponent as T, type ChromeNotificationAlert as U, type ChromeNotificationImport as V, type ChromeNotificationQuarantine as W, type ChromeNotificationReply as X, type ChromeNotificationsPayload as Y, type ChromeOrgSummary as Z, type CommunicationsFuelStatus as _, AiCreditsState as a, useNavChromeFetcher as a$, type CreditTypeKey as a0, CreditsAction as a1, type CreditsIconState as a2, FuelAction as a3, type FuelChannelStatus as a4, MyProfileAction as a5, NavAppShell as a6, type NavAppShellProps as a7, NavBetaBanner as a8, type NavBetaBannerProps as a9, type ThemePreference as aA, TopBarCountBadge as aB, type TopBarIconTone as aC, TopBarLinkAction as aD, type TopBarLinkActionProps as aE, TopBarPanelArrow as aF, TopBarPopover as aG, TopBarTooltip as aH, TopBarWidgetSlot as aI, buildLineParts as aJ, clearBetaBannerDismissal as aK, creditGaugeRatio as aL, creditStateWord as aM, creditTooltipLine as aN, creditsAriaLabel as aO, creditsIconState as aP, envChipClasses as aQ, isNavItemActive as aR, modeIdFromLabel as aS, resolveOrgLogoUrl as aT, shortEnvLabel as aU, shortUserName as aV, standardPolitogyNav as aW, topBarIconButtonClass as aX, useChromeMe as aY, useChromeOrgs as aZ, useNavChromeDedupedFetch as a_, type NavBrand as aa, NavChromeProvider as ab, NavDisplayAction as ac, type NavLinkProps as ad, type NavLinkedAccount as ae, type NavModeOption as af, type NavOrg as ag, type NavRoleBadge as ah, NavSidebar as ai, type NavSidebarProps as aj, type NavTab as ak, NavTabStrip as al, type NavTabStripProps as am, NavThemeControl as an, NavTopBar as ao, type NavTopBarAction as ap, type NavTopBarProps as aq, type NavUser as ar, NotificationsAction as as, OrganizationSettingsAction as at, PageHeader as au, type PageHeaderMode as av, SPECS_ORIGIN as aw, SpecOverlayAction as ax, type StandardNavOptions as ay, SupportAction as az, type AiCreditsStateKind as b, useThemePreference as b0, type CommsNotification as c, type CommsNotificationKind as d, type HeaderTabBarItem as e, type NotificationsAdapter as f, type NotificationsFeed as g, RowMenuItem as h, type RowMenuPlacement as i, aiCreditsWalletUrl as j, createCommsNotificationsAdapter as k, emptyNotificationsFeed as l, rowMenuPosition as m, normalizeNotificationsFeed as n, type NavIcon as o, type NavBreadcrumb as p, type StandardNavMode as q, resolveTabGlyph as r, type NavLinkComponent as s, type NavChromeFetcher as t, type NavMode as u, type NavUserMenu as v, type NavOrgOption as w, type NavFooterLink as x, type NavFooter as y, type NavDisplayMode as z };

package/dist/{index-BEMGfLpI.d.ts → index-smsLP_tM.d.ts}

@@ -300,9 +300,19 @@ declare function TopBarCountBadge({ count }: {
  * Pure CSS (group-hover) so it works on <a>, <button> and <summary> triggers.
  * The trigger must carry `group/tbtip relative` (topBarIconButtonClass does).
  */
-declare function TopBarTooltip({ title, description, }: {
+declare function TopBarTooltip({ title, description, align, }: {
     title: string;
     description?: ReactNode;
+    /**
+     * `center` (default): the body is centered under the trigger.
+     * `end`: the body's right edge lines up with the trigger's right edge, so a
+     * control at the right end of the top bar (Organization settings, My profile)
+     * keeps its tooltip on screen. The arrow stays on the trigger's center either
+     * way (Brand guideline "Tooltips point at their trigger"). Measured
+     * 2026-11-05 at 1547px: the centered 224px body ran 75px past the viewport
+     * for My profile and 35px for Organization settings.
+     */
+    align?: 'center' | 'end';
 }): react_jsx_runtime.JSX.Element;
 /**
  * The up-pointing arrow every top-bar panel renders, anchored under its
@@ -804,6 +814,25 @@ declare function modeIdFromLabel(label: string | undefined): string | undefined;
 declare function shortUserName(name: string): string;
 /** Short environment name for the rail's build line ("prod", "staging", "local"). */
 declare function shortEnvLabel(label: string): string;
+/**
+ * The left-bar build line (Left-Navigation §10, UI-Platform → Debug info;
+ * decided 2026-11-05, Ben): ONE quiet line, `v<version> · <Mon D>`, 10px mono
+ * in the inactive-row gray (`--sidebar-row-text`: 66% white, #F0CFD2 on the
+ * Campaign rail; the dimmest rail gray that clears 4.5:1 on both rails). The
+ * full build info (env, commit, version, date, author) is the hover title, so
+ * it stays one hover away for the team. Replaces the two rows
+ * `env | commit | version` / `date | author` until the Debug info button ships.
+ */
+declare function buildLineParts(meta: {
+    envLabel?: string;
+    version?: string;
+    commit?: string;
+    commitDate?: string;
+    commitAuthor?: string;
+}): {
+    line: string;
+    detail: string;
+};
 declare function envChipClasses(label: string): string;
 type NavBrand = {
     /** Where the logo links to. Defaults to "/". */
@@ -1259,4 +1288,4 @@ type NavAppShellProps = {
 };
 declare function NavAppShell({ sidebar, topBar, betaBanner, contentWrapper, accountMenuPlacement, modeId, children, }: NavAppShellProps): react_jsx_runtime.JSX.Element;
 
-export { type CreditHealthState as $, AI_CREDITS_STATE_TITLES as A, type BreadcrumbBarProps as B, Card as C, BETA_BANNER_DISMISS_KEY as D, BreadcrumbBar as E, FormColumn as F, CAMPAIGN_FEATURE_AVAILABILITY as G, HeaderTabBar as H, CORE_APP_ORIGIN as I, CORE_BILLING_PATH as J, KNOWN_TAB_GLYPHS as K, CREDIT_TYPE_LABELS as L, CREDIT_TYPE_ORDER as M, type NavItem as N, type CampaignFeatureAvailability as O, type PageHeaderProps as P, type ChromeMe as Q, RowMenu as R, type StandardNavIconKey as S, type TabGlyphComponent as T, type ChromeNotificationAlert as U, type ChromeNotificationImport as V, type ChromeNotificationQuarantine as W, type ChromeNotificationReply as X, type ChromeNotificationsPayload as Y, type ChromeOrgSummary as Z, type CommunicationsFuelStatus as _, AiCreditsState as a, useThemePreference as a$, type CreditTypeKey as a0, CreditsAction as a1, type CreditsIconState as a2, FuelAction as a3, type FuelChannelStatus as a4, MyProfileAction as a5, NavAppShell as a6, type NavAppShellProps as a7, NavBetaBanner as a8, type NavBetaBannerProps as a9, type ThemePreference as aA, TopBarCountBadge as aB, type TopBarIconTone as aC, TopBarLinkAction as aD, type TopBarLinkActionProps as aE, TopBarPanelArrow as aF, TopBarPopover as aG, TopBarTooltip as aH, TopBarWidgetSlot as aI, clearBetaBannerDismissal as aJ, creditGaugeRatio as aK, creditStateWord as aL, creditTooltipLine as aM, creditsAriaLabel as aN, creditsIconState as aO, envChipClasses as aP, isNavItemActive as aQ, modeIdFromLabel as aR, resolveOrgLogoUrl as aS, shortEnvLabel as aT, shortUserName as aU, standardPolitogyNav as aV, topBarIconButtonClass as aW, useChromeMe as aX, useChromeOrgs as aY, useNavChromeDedupedFetch as aZ, useNavChromeFetcher as a_, type NavBrand as aa, NavChromeProvider as ab, NavDisplayAction as ac, type NavLinkProps as ad, type NavLinkedAccount as ae, type NavModeOption as af, type NavOrg as ag, type NavRoleBadge as ah, NavSidebar as ai, type NavSidebarProps as aj, type NavTab as ak, NavTabStrip as al, type NavTabStripProps as am, NavThemeControl as an, NavTopBar as ao, type NavTopBarAction as ap, type NavTopBarProps as aq, type NavUser as ar, NotificationsAction as as, OrganizationSettingsAction as at, PageHeader as au, type PageHeaderMode as av, SPECS_ORIGIN as aw, SpecOverlayAction as ax, type StandardNavOptions as ay, SupportAction as az, type AiCreditsStateKind as b, type CommsNotification as c, type CommsNotificationKind as d, type HeaderTabBarItem as e, type NotificationsAdapter as f, type NotificationsFeed as g, RowMenuItem as h, type RowMenuPlacement as i, aiCreditsWalletUrl as j, createCommsNotificationsAdapter as k, emptyNotificationsFeed as l, rowMenuPosition as m, normalizeNotificationsFeed as n, type NavIcon as o, type NavBreadcrumb as p, type StandardNavMode as q, resolveTabGlyph as r, type NavLinkComponent as s, type NavChromeFetcher as t, type NavMode as u, type NavUserMenu as v, type NavOrgOption as w, type NavFooterLink as x, type NavFooter as y, type NavDisplayMode as z };
+export { type CreditHealthState as $, AI_CREDITS_STATE_TITLES as A, type BreadcrumbBarProps as B, Card as C, BETA_BANNER_DISMISS_KEY as D, BreadcrumbBar as E, FormColumn as F, CAMPAIGN_FEATURE_AVAILABILITY as G, HeaderTabBar as H, CORE_APP_ORIGIN as I, CORE_BILLING_PATH as J, KNOWN_TAB_GLYPHS as K, CREDIT_TYPE_LABELS as L, CREDIT_TYPE_ORDER as M, type NavItem as N, type CampaignFeatureAvailability as O, type PageHeaderProps as P, type ChromeMe as Q, RowMenu as R, type StandardNavIconKey as S, type TabGlyphComponent as T, type ChromeNotificationAlert as U, type ChromeNotificationImport as V, type ChromeNotificationQuarantine as W, type ChromeNotificationReply as X, type ChromeNotificationsPayload as Y, type ChromeOrgSummary as Z, type CommunicationsFuelStatus as _, AiCreditsState as a, useNavChromeFetcher as a$, type CreditTypeKey as a0, CreditsAction as a1, type CreditsIconState as a2, FuelAction as a3, type FuelChannelStatus as a4, MyProfileAction as a5, NavAppShell as a6, type NavAppShellProps as a7, NavBetaBanner as a8, type NavBetaBannerProps as a9, type ThemePreference as aA, TopBarCountBadge as aB, type TopBarIconTone as aC, TopBarLinkAction as aD, type TopBarLinkActionProps as aE, TopBarPanelArrow as aF, TopBarPopover as aG, TopBarTooltip as aH, TopBarWidgetSlot as aI, buildLineParts as aJ, clearBetaBannerDismissal as aK, creditGaugeRatio as aL, creditStateWord as aM, creditTooltipLine as aN, creditsAriaLabel as aO, creditsIconState as aP, envChipClasses as aQ, isNavItemActive as aR, modeIdFromLabel as aS, resolveOrgLogoUrl as aT, shortEnvLabel as aU, shortUserName as aV, standardPolitogyNav as aW, topBarIconButtonClass as aX, useChromeMe as aY, useChromeOrgs as aZ, useNavChromeDedupedFetch as a_, type NavBrand as aa, NavChromeProvider as ab, NavDisplayAction as ac, type NavLinkProps as ad, type NavLinkedAccount as ae, type NavModeOption as af, type NavOrg as ag, type NavRoleBadge as ah, NavSidebar as ai, type NavSidebarProps as aj, type NavTab as ak, NavTabStrip as al, type NavTabStripProps as am, NavThemeControl as an, NavTopBar as ao, type NavTopBarAction as ap, type NavTopBarProps as aq, type NavUser as ar, NotificationsAction as as, OrganizationSettingsAction as at, PageHeader as au, type PageHeaderMode as av, SPECS_ORIGIN as aw, SpecOverlayAction as ax, type StandardNavOptions as ay, SupportAction as az, type AiCreditsStateKind as b, useThemePreference as b0, type CommsNotification as c, type CommsNotificationKind as d, type HeaderTabBarItem as e, type NotificationsAdapter as f, type NotificationsFeed as g, RowMenuItem as h, type RowMenuPlacement as i, aiCreditsWalletUrl as j, createCommsNotificationsAdapter as k, emptyNotificationsFeed as l, rowMenuPosition as m, normalizeNotificationsFeed as n, type NavIcon as o, type NavBreadcrumb as p, type StandardNavMode as q, resolveTabGlyph as r, type NavLinkComponent as s, type NavChromeFetcher as t, type NavMode as u, type NavUserMenu as v, type NavOrgOption as w, type NavFooterLink as x, type NavFooter as y, type NavDisplayMode as z };

package/dist/index.cjs

@@ -1463,19 +1463,26 @@ try{d.setAttribute("data-theme",dark?"dark":"light");d.style.colorScheme=dark?"d
 }catch(e){}})();`;
 function TopBarTooltip({
   title,
-  description
+  description,
+  align = "center"
 }) {
+  const bodyPosition = align === "end" ? "right-0" : "left-1/2 -translate-x-1/2";
+  const arrowPosition = align === "end" ? "" : "left-1/2 -translate-x-1/2";
+  const arrowStyle = align === "end" ? { right: "calc(var(--topbar-icon-button-size, 34px) / 2 - 5px)" } : void 0;
   return /* @__PURE__ */ jsxRuntime.jsxs(
     "span",
     {
       role: "tooltip",
-      className: "pointer-events-none absolute left-1/2 top-full z-50 mt-2 hidden w-max max-w-56 -translate-x-1/2 flex-col rounded-lg border border-[color:var(--app-btn-tooltip-bg,#2F3136)] bg-[color:var(--app-btn-tooltip-bg,#2F3136)] px-3 py-2 text-left shadow-[var(--shadow-soft)] group-hover/tbtip:flex group-focus-visible/tbtip:flex",
+      "data-tooltip-align": align,
+      className: `pointer-events-none absolute ${bodyPosition} top-full z-50 mt-2 hidden w-max max-w-56 flex-col rounded-lg border border-[color:var(--app-btn-tooltip-bg,#2F3136)] bg-[color:var(--app-btn-tooltip-bg,#2F3136)] px-3 py-2 text-left shadow-[var(--shadow-soft)] group-hover/tbtip:flex group-focus-visible/tbtip:flex`,
       children: [
         /* @__PURE__ */ jsxRuntime.jsx(
           "span",
           {
             "aria-hidden": true,
-            className: "absolute -top-[5px] left-1/2 h-2.5 w-2.5 -translate-x-1/2 rotate-45 border-l border-t border-[color:var(--app-btn-tooltip-bg,#2F3136)] bg-[color:var(--app-btn-tooltip-bg,#2F3136)]"
+            "data-tooltip-arrow": true,
+            style: arrowStyle,
+            className: `absolute -top-[5px] ${arrowPosition} h-2.5 w-2.5 rotate-45 border-l border-t border-[color:var(--app-btn-tooltip-bg,#2F3136)] bg-[color:var(--app-btn-tooltip-bg,#2F3136)]`
           }
         ),
         /* @__PURE__ */ jsxRuntime.jsx("span", { className: "text-xs font-semibold text-[color:var(--app-btn-tooltip-fg,#FFFFFF)]", children: title }),