@the-portland-company/shell 0.3.1 → 0.3.4

package/dist/index.d.cts

@@ -270,6 +270,10 @@ interface ShellProviderProps {
     devNotesMenu?: ReactNode;
     /** href used by the UserMenu "My Profile" link. Defaults to '/my-profile'. */
     myProfileHref?: string;
+    /** Optional avatar URL override for the header UserMenu. Useful when the
+     *  app has additional avatar sources (profile.avatar_url, memoji selection
+     *  in localStorage, branded default URL) that aren't in user_metadata. */
+    userAvatarUrl?: string;
 }
 /** Return value of useShellAuth(). */
 interface ShellAuthValue {
@@ -362,9 +366,12 @@ interface ShellChromeValue {
         href?: string;
     }>;
     headerActions?: ReactNode;
+    /** Avatar URL override for UserMenu. Apps that store the avatar in their own
+     *  profile table or localStorage should pass it here. */
+    userAvatarUrl?: string;
 }
 declare const ShellChromeContext: react.Context<ShellChromeValue | null>;
-declare function ShellProvider({ children, supabaseClient, currentApp, appRegistry, basename, organization, linkedAccounts, support, devNotesMenu, myProfileHref, }: ShellProviderProps): react_jsx_runtime.JSX.Element;
+declare function ShellProvider({ children, supabaseClient, currentApp, appRegistry, basename, organization, linkedAccounts, support, devNotesMenu, myProfileHref, userAvatarUrl, }: ShellProviderProps): react_jsx_runtime.JSX.Element;
 
 declare function useShellAuth(): ShellAuthValue;
 
@@ -698,6 +705,9 @@ interface ShellChromeProps {
     }>;
     /** Header right-side action buttons (rendered before the icon row). */
     headerActions?: ReactNode;
+    /** Avatar URL override for UserMenu. Pass a value computed from the app's
+     *  profile.avatar_url / localStorage / default fallback chain. */
+    userAvatarUrl?: string;
 }
 /**
  * Drop-in chrome binding for apps where the org/linked-account/support data
@@ -711,7 +721,7 @@ interface ShellChromeProps {
  * Apps that have all the data available at the ShellProvider construction
  * site can pass the same props to <ShellProvider> directly instead.
  */
-declare function ShellChrome({ children, organization, linkedAccounts, support, devNotesMenu, myProfileHref, mode, navItems, navigationPreference, role, footer, brandLogoSrc, headerIconsSlot, organizationSettingsHref, showContinueOnboarding, onContinueOnboarding, pageTitle, breadcrumbs, headerActions, }: ShellChromeProps): react_jsx_runtime.JSX.Element;
+declare function ShellChrome({ children, organization, linkedAccounts, support, devNotesMenu, myProfileHref, mode, navItems, navigationPreference, role, footer, brandLogoSrc, headerIconsSlot, organizationSettingsHref, showContinueOnboarding, onContinueOnboarding, pageTitle, breadcrumbs, headerActions, userAvatarUrl, }: ShellChromeProps): react_jsx_runtime.JSX.Element;
 
 /** Returns a normalized 7-char hex color, or null if the input isn't valid. */
 declare function normalizeHexColor(value?: string | null): string | null;

package/dist/index.d.ts

@@ -270,6 +270,10 @@ interface ShellProviderProps {
     devNotesMenu?: ReactNode;
     /** href used by the UserMenu "My Profile" link. Defaults to '/my-profile'. */
     myProfileHref?: string;
+    /** Optional avatar URL override for the header UserMenu. Useful when the
+     *  app has additional avatar sources (profile.avatar_url, memoji selection
+     *  in localStorage, branded default URL) that aren't in user_metadata. */
+    userAvatarUrl?: string;
 }
 /** Return value of useShellAuth(). */
 interface ShellAuthValue {
@@ -362,9 +366,12 @@ interface ShellChromeValue {
         href?: string;
     }>;
     headerActions?: ReactNode;
+    /** Avatar URL override for UserMenu. Apps that store the avatar in their own
+     *  profile table or localStorage should pass it here. */
+    userAvatarUrl?: string;
 }
 declare const ShellChromeContext: react.Context<ShellChromeValue | null>;
-declare function ShellProvider({ children, supabaseClient, currentApp, appRegistry, basename, organization, linkedAccounts, support, devNotesMenu, myProfileHref, }: ShellProviderProps): react_jsx_runtime.JSX.Element;
+declare function ShellProvider({ children, supabaseClient, currentApp, appRegistry, basename, organization, linkedAccounts, support, devNotesMenu, myProfileHref, userAvatarUrl, }: ShellProviderProps): react_jsx_runtime.JSX.Element;
 
 declare function useShellAuth(): ShellAuthValue;
 
@@ -698,6 +705,9 @@ interface ShellChromeProps {
     }>;
     /** Header right-side action buttons (rendered before the icon row). */
     headerActions?: ReactNode;
+    /** Avatar URL override for UserMenu. Pass a value computed from the app's
+     *  profile.avatar_url / localStorage / default fallback chain. */
+    userAvatarUrl?: string;
 }
 /**
  * Drop-in chrome binding for apps where the org/linked-account/support data
@@ -711,7 +721,7 @@ interface ShellChromeProps {
  * Apps that have all the data available at the ShellProvider construction
  * site can pass the same props to <ShellProvider> directly instead.
  */
-declare function ShellChrome({ children, organization, linkedAccounts, support, devNotesMenu, myProfileHref, mode, navItems, navigationPreference, role, footer, brandLogoSrc, headerIconsSlot, organizationSettingsHref, showContinueOnboarding, onContinueOnboarding, pageTitle, breadcrumbs, headerActions, }: ShellChromeProps): react_jsx_runtime.JSX.Element;
+declare function ShellChrome({ children, organization, linkedAccounts, support, devNotesMenu, myProfileHref, mode, navItems, navigationPreference, role, footer, brandLogoSrc, headerIconsSlot, organizationSettingsHref, showContinueOnboarding, onContinueOnboarding, pageTitle, breadcrumbs, headerActions, userAvatarUrl, }: ShellChromeProps): react_jsx_runtime.JSX.Element;
 
 /** Returns a normalized 7-char hex color, or null if the input isn't valid. */
 declare function normalizeHexColor(value?: string | null): string | null;

package/dist/index.js

@@ -1147,7 +1147,8 @@ function ShellProvider({
   linkedAccounts,
   support,
   devNotesMenu,
-  myProfileHref
+  myProfileHref,
+  userAvatarUrl
 }) {
   const [status, setStatus] = useState("loading");
   const [session, setSession] = useState(null);
@@ -1189,9 +1190,10 @@ function ShellProvider({
   const chrome = useMemo(
     () => ({
       devNotesMenu: devNotesMenu ?? null,
-      myProfileHref: myProfileHref ?? "/my-profile"
+      myProfileHref: myProfileHref ?? "/my-profile",
+      userAvatarUrl
     }),
-    [devNotesMenu, myProfileHref]
+    [devNotesMenu, myProfileHref, userAvatarUrl]
   );
   return /* @__PURE__ */ jsx(ShellAuthContext.Provider, { value, children: /* @__PURE__ */ jsx(ShellMetaContext.Provider, { value: meta, children: /* @__PURE__ */ jsx(ShellOrgContext.Provider, { value: organization ?? null, children: /* @__PURE__ */ jsx(ShellLinkedAccountsContext.Provider, { value: linkedAccounts ?? null, children: /* @__PURE__ */ jsx(ShellSupportProviderContext.Provider, { value: support ?? null, children: /* @__PURE__ */ jsx(ShellModeContext.Provider, { value: null, children: /* @__PURE__ */ jsx(ShellNavItemsContext.Provider, { value: null, children: /* @__PURE__ */ jsx(ShellNavigationPreferenceContext.Provider, { value: null, children: /* @__PURE__ */ jsx(ShellRoleContext.Provider, { value: null, children: /* @__PURE__ */ jsx(ShellFooterContext.Provider, { value: null, children: /* @__PURE__ */ jsx(ShellChromeContext.Provider, { value: chrome, children: /* @__PURE__ */ jsx(ChakraProvider, { theme: politogyTheme, children }) }) }) }) }) }) }) }) }) }) }) });
 }
@@ -1278,7 +1280,8 @@ function UserMenu() {
     myProfileHref,
     organizationSettingsHref,
     showContinueOnboarding,
-    onContinueOnboarding
+    onContinueOnboarding,
+    userAvatarUrl
   } = useShellChrome();
   const linked = useShellLinkedAccounts();
   const mode = useShellMode();
@@ -1289,7 +1292,7 @@ function UserMenu() {
   const menuListBorderColor = useColorModeValue("gray.200", "gray.700");
   if (status !== "authenticated" || !user) return null;
   const displayName = getUserDisplayName(user.raw);
-  const avatarUrl = avatarUrlFromUser(user);
+  const avatarUrl = userAvatarUrl ?? avatarUrlFromUser(user);
   const modeConfig = mode?.getModeConfig() ?? null;
   const currentOrg = org?.currentOrg ?? null;
   const linkedAccounts = linked?.linkedAccounts ?? [];
@@ -2905,7 +2908,8 @@ function ShellChrome({
   onContinueOnboarding,
   pageTitle,
   breadcrumbs,
-  headerActions
+  headerActions,
+  userAvatarUrl
 }) {
   const chrome = useMemo(
     () => ({
@@ -2918,7 +2922,8 @@ function ShellChrome({
       onContinueOnboarding,
       pageTitle,
       breadcrumbs,
-      headerActions
+      headerActions,
+      userAvatarUrl
     }),
     [
       devNotesMenu,
@@ -2930,7 +2935,8 @@ function ShellChrome({
       onContinueOnboarding,
       pageTitle,
       breadcrumbs,
-      headerActions
+      headerActions,
+      userAvatarUrl
     ]
   );
   const navItemsValue = useMemo(