@payloadcms/next 4.0.0-internal.5b1e7cd → 4.0.0-internal.c2b57ce

package/dist/elements/Nav/NavWrapper/index.js

@@ -8,7 +8,7 @@ import React from 'react';
  * @internal
  */
 export const NavWrapper = props => {
-  const $ = _c(11);
+  const $ = _c(10);
   const {
     baseClass,
     children
@@ -16,46 +16,43 @@ export const NavWrapper = props => {
   const {
     hydrated,
     navOpen,
-    navRef,
-    shouldAnimate
+    navRef
   } = useNav();
   const t0 = navOpen && `${baseClass}--nav-open`;
-  const t1 = shouldAnimate && `${baseClass}--nav-animate`;
-  const t2 = hydrated && `${baseClass}--nav-hydrated`;
-  let t3;
-  if ($[0] !== baseClass || $[1] !== t0 || $[2] !== t1 || $[3] !== t2) {
-    t3 = [baseClass, t0, t1, t2].filter(Boolean);
+  const t1 = hydrated && `${baseClass}--nav-hydrated`;
+  let t2;
+  if ($[0] !== baseClass || $[1] !== t0 || $[2] !== t1) {
+    t2 = [baseClass, t0, t1].filter(Boolean);
     $[0] = baseClass;
     $[1] = t0;
     $[2] = t1;
     $[3] = t2;
-    $[4] = t3;
   } else {
-    t3 = $[4];
+    t2 = $[3];
   }
-  const t4 = t3.join(" ");
-  const t5 = !navOpen ? true : undefined;
-  const t6 = `${baseClass}__scroll`;
-  let t7;
-  if ($[5] !== children || $[6] !== navRef || $[7] !== t4 || $[8] !== t5 || $[9] !== t6) {
-    t7 = _jsx("aside", {
-      className: t4,
-      inert: t5,
+  const t3 = t2.join(" ");
+  const t4 = !navOpen ? true : undefined;
+  const t5 = `${baseClass}__scroll`;
+  let t6;
+  if ($[4] !== children || $[5] !== navRef || $[6] !== t3 || $[7] !== t4 || $[8] !== t5) {
+    t6 = _jsx("aside", {
+      className: t3,
+      inert: t4,
       children: _jsx("div", {
-        className: t6,
+        className: t5,
         ref: navRef,
         children
       })
     });
-    $[5] = children;
-    $[6] = navRef;
+    $[4] = children;
+    $[5] = navRef;
+    $[6] = t3;
     $[7] = t4;
     $[8] = t5;
     $[9] = t6;
-    $[10] = t7;
   } else {
-    t7 = $[10];
+    t6 = $[9];
   }
-  return t7;
+  return t6;
 };
 //# sourceMappingURL=index.js.map

package/dist/elements/Nav/NavWrapper/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["c","_c","useNav","React","NavWrapper","props","$","baseClass","children","hydrated","navOpen","navRef","shouldAnimate","t0","t1","t2","t3","filter","Boolean","t4","join","t5","undefined","t6","t7","_jsx","className","inert","ref"],"sources":["../../../../src/elements/Nav/NavWrapper/index.tsx"],"sourcesContent":["'use client'\nimport { useNav } from '@payloadcms/ui'\nimport React from 'react'\n\nimport './index.scss'\n\n/**\n * @internal\n */\nexport const NavWrapper: React.FC<{\n  baseClass?: string\n  children: React.ReactNode\n}> = (props) => {\n  const { baseClass, children } = props\n\n  const { hydrated, navOpen, navRef, shouldAnimate } = useNav()\n\n  return (\n    <aside\n      className={[\n        baseClass,\n        navOpen && `${baseClass}--nav-open`,\n        shouldAnimate && `${baseClass}--nav-animate`,\n        hydrated && `${baseClass}--nav-hydrated`,\n      ]\n        .filter(Boolean)\n        .join(' ')}\n      inert={!navOpen ? true : undefined}\n    >\n      <div className={`${baseClass}__scroll`} ref={navRef}>\n        {children}\n      </div>\n    </aside>\n  )\n}\n"],"mappings":"AAAA;;AAAA,SAAAA,CAAA,IAAAC,EAAA;;AACA,SAASC,MAAM,QAAQ;AACvB,OAAOC,KAAA,MAAW;AAIlB;;;AAGA,OAAO,MAAMC,UAAA,GAGRC,KAAA;EAAA,MAAAC,CAAA,GAAAL,EAAA;EACH;IAAAM,SAAA;IAAAC;EAAA,IAAgCH,KAAA;EAEhC;IAAAI,QAAA;IAAAC,OAAA;IAAAC,MAAA;IAAAC;EAAA,IAAqDV,MAAA;EAM/C,MAAAW,EAAA,GAAAH,OAAA,IAAW,GAAGH,SAAA,YAAqB;EACnC,MAAAO,EAAA,GAAAF,aAAA,IAAiB,GAAGL,SAAA,eAAwB;EAC5C,MAAAQ,EAAA,GAAAN,QAAA,IAAY,GAAGF,SAAA,gBAAyB;EAAA,IAAAS,EAAA;EAAA,IAAAV,CAAA,QAAAC,SAAA,IAAAD,CAAA,QAAAO,EAAA,IAAAP,CAAA,QAAAQ,EAAA,IAAAR,CAAA,QAAAS,EAAA;IAJ/BC,EAAA,IACTT,SAAA,EACAM,EAAmC,EACnCC,EAA4C,EAC5CC,EAAwC,EAAAE,MAAA,CAAAC,OAEhC;IAAAZ,CAAA,MAAAC,SAAA;IAAAD,CAAA,MAAAO,EAAA;IAAAP,CAAA,MAAAQ,EAAA;IAAAR,CAAA,MAAAS,EAAA;IAAAT,CAAA,MAAAU,EAAA;EAAA;IAAAA,EAAA,GAAAV,CAAA;EAAA;EANC,MAAAa,EAAA,GAAAH,EAMD,CAAAI,IAAA,CACF;EACD,MAAAC,EAAA,IAACX,OAAA,UAAAY,SAAiB;EAET,MAAAC,EAAA,MAAGhB,SAAA,UAAmB;EAAA,IAAAiB,EAAA;EAAA,IAAAlB,CAAA,QAAAE,QAAA,IAAAF,CAAA,QAAAK,MAAA,IAAAL,CAAA,QAAAa,EAAA,IAAAb,CAAA,QAAAe,EAAA,IAAAf,CAAA,QAAAiB,EAAA;IAXxCC,EAAA,GAAAC,IAAA,CAAC;MAAAC,SAAA,EACYP,EAOH;MAAAQ,KAAA,EACDN,EAAkB;MAAAb,QAAA,EAEzBiB,IAAA,CAAC;QAAAC,SAAA,EAAeH,EAAsB;QAAAK,GAAA,EAAOjB,MAAA;QAAAH;MAAA,C;;;;;;;;;;;SAX/CgB,E;CAgBJ","ignoreList":[]}
+{"version":3,"file":"index.js","names":["c","_c","useNav","React","NavWrapper","props","$","baseClass","children","hydrated","navOpen","navRef","t0","t1","t2","filter","Boolean","t3","join","t4","undefined","t5","t6","_jsx","className","inert","ref"],"sources":["../../../../src/elements/Nav/NavWrapper/index.tsx"],"sourcesContent":["'use client'\nimport { useNav } from '@payloadcms/ui'\nimport React from 'react'\n\nimport './index.scss'\n\n/**\n * @internal\n */\nexport const NavWrapper: React.FC<{\n  baseClass?: string\n  children: React.ReactNode\n}> = (props) => {\n  const { baseClass, children } = props\n\n  const { hydrated, navOpen, navRef } = useNav()\n\n  return (\n    <aside\n      className={[\n        baseClass,\n        navOpen && `${baseClass}--nav-open`,\n        hydrated && `${baseClass}--nav-hydrated`,\n      ]\n        .filter(Boolean)\n        .join(' ')}\n      inert={!navOpen ? true : undefined}\n    >\n      <div className={`${baseClass}__scroll`} ref={navRef}>\n        {children}\n      </div>\n    </aside>\n  )\n}\n"],"mappings":"AAAA;;AAAA,SAAAA,CAAA,IAAAC,EAAA;;AACA,SAASC,MAAM,QAAQ;AACvB,OAAOC,KAAA,MAAW;AAIlB;;;AAGA,OAAO,MAAMC,UAAA,GAGRC,KAAA;EAAA,MAAAC,CAAA,GAAAL,EAAA;EACH;IAAAM,SAAA;IAAAC;EAAA,IAAgCH,KAAA;EAEhC;IAAAI,QAAA;IAAAC,OAAA;IAAAC;EAAA,IAAsCT,MAAA;EAMhC,MAAAU,EAAA,GAAAF,OAAA,IAAW,GAAGH,SAAA,YAAqB;EACnC,MAAAM,EAAA,GAAAJ,QAAA,IAAY,GAAGF,SAAA,gBAAyB;EAAA,IAAAO,EAAA;EAAA,IAAAR,CAAA,QAAAC,SAAA,IAAAD,CAAA,QAAAM,EAAA,IAAAN,CAAA,QAAAO,EAAA;IAH/BC,EAAA,IACTP,SAAA,EACAK,EAAmC,EACnCC,EAAwC,EAAAE,MAAA,CAAAC,OAEhC;IAAAV,CAAA,MAAAC,SAAA;IAAAD,CAAA,MAAAM,EAAA;IAAAN,CAAA,MAAAO,EAAA;IAAAP,CAAA,MAAAQ,EAAA;EAAA;IAAAA,EAAA,GAAAR,CAAA;EAAA;EALC,MAAAW,EAAA,GAAAH,EAKD,CAAAI,IAAA,CACF;EACD,MAAAC,EAAA,IAACT,OAAA,UAAAU,SAAiB;EAET,MAAAC,EAAA,MAAGd,SAAA,UAAmB;EAAA,IAAAe,EAAA;EAAA,IAAAhB,CAAA,QAAAE,QAAA,IAAAF,CAAA,QAAAK,MAAA,IAAAL,CAAA,QAAAW,EAAA,IAAAX,CAAA,QAAAa,EAAA,IAAAb,CAAA,QAAAe,EAAA;IAVxCC,EAAA,GAAAC,IAAA,CAAC;MAAAC,SAAA,EACYP,EAMH;MAAAQ,KAAA,EACDN,EAAkB;MAAAX,QAAA,EAEzBe,IAAA,CAAC;QAAAC,SAAA,EAAeH,EAAsB;QAAAK,GAAA,EAAOf,MAAA;QAAAH;MAAA,C;;;;;;;;;;;SAV/Cc,E;CAeJ","ignoreList":[]}

package/dist/elements/Nav/SidebarTabs/TabError/index.css

@@ -0,0 +1,29 @@
+@layer payload-default {
+  .sidebar-tab-error__content {
+    display: flex;
+    flex-direction: column;
+    gap: 2px;
+    line-height: 1.4;
+
+    strong {
+      font-weight: 600;
+    }
+
+    span {
+      opacity: 0.8;
+      font-size: 0.625rem;
+    }
+  }
+
+  .sidebar-tab-error__retry {
+    all: unset;
+    margin-top: var(--spacer-1);
+    font-size: 0.625rem;
+    text-decoration: underline;
+    cursor: pointer;
+
+    &:hover {
+      opacity: 0.8;
+    }
+  }
+}

package/dist/elements/Nav/SidebarTabs/TabError/index.d.ts

@@ -0,0 +1,8 @@
+import React from 'react';
+import './index.css';
+export type TabErrorProps = {
+    message: string;
+    onRetry: () => void;
+};
+export declare const TabError: React.FC<TabErrorProps>;
+//# sourceMappingURL=index.d.ts.map

package/dist/elements/Nav/SidebarTabs/TabError/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/elements/Nav/SidebarTabs/TabError/index.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,OAAO,aAAa,CAAA;AAIpB,MAAM,MAAM,aAAa,GAAG;IAC1B,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,IAAI,CAAA;CACpB,CAAA;AAED,eAAO,MAAM,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAC,aAAa,CAY5C,CAAA"}

package/dist/elements/Nav/SidebarTabs/TabError/index.js

@@ -0,0 +1,42 @@
+'use client';
+
+import { c as _c } from "react/compiler-runtime";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useTranslation } from '@payloadcms/ui';
+import React from 'react';
+const baseClass = 'sidebar-tab-error';
+export const TabError = t0 => {
+  const $ = _c(4);
+  const {
+    message,
+    onRetry
+  } = t0;
+  const {
+    t
+  } = useTranslation();
+  let t1;
+  if ($[0] !== message || $[1] !== onRetry || $[2] !== t) {
+    t1 = _jsx("div", {
+      className: baseClass,
+      children: _jsxs("div", {
+        className: `${baseClass}__content`,
+        children: [_jsx("span", {
+          children: message
+        }), _jsx("button", {
+          className: `${baseClass}__retry`,
+          onClick: onRetry,
+          type: "button",
+          children: t("general:retry")
+        })]
+      })
+    });
+    $[0] = message;
+    $[1] = onRetry;
+    $[2] = t;
+    $[3] = t1;
+  } else {
+    t1 = $[3];
+  }
+  return t1;
+};
+//# sourceMappingURL=index.js.map

package/dist/elements/Nav/SidebarTabs/TabError/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["c","_c","useTranslation","React","baseClass","TabError","t0","$","message","onRetry","t","t1","_jsx","className","children","_jsxs","onClick","type"],"sources":["../../../../../src/elements/Nav/SidebarTabs/TabError/index.tsx"],"sourcesContent":["'use client'\n\nimport { useTranslation } from '@payloadcms/ui'\nimport React from 'react'\n\nimport './index.css'\n\nconst baseClass = 'sidebar-tab-error'\n\nexport type TabErrorProps = {\n  message: string\n  onRetry: () => void\n}\n\nexport const TabError: React.FC<TabErrorProps> = ({ message, onRetry }) => {\n  const { t } = useTranslation()\n  return (\n    <div className={baseClass}>\n      <div className={`${baseClass}__content`}>\n        <span>{message}</span>\n        <button className={`${baseClass}__retry`} onClick={onRetry} type=\"button\">\n          {t('general:retry')}\n        </button>\n      </div>\n    </div>\n  )\n}\n"],"mappings":"AAAA;;AAAA,SAAAA,CAAA,IAAAC,EAAA;;AAEA,SAASC,cAAc,QAAQ;AAC/B,OAAOC,KAAA,MAAW;AAIlB,MAAMC,SAAA,GAAY;AAOlB,OAAO,MAAMC,QAAA,GAAoCC,EAAA;EAAA,MAAAC,CAAA,GAAAN,EAAA;EAAC;IAAAO,OAAA;IAAAC;EAAA,IAAAH,EAAoB;EACpE;IAAAI;EAAA,IAAcR,cAAA;EAAA,IAAAS,EAAA;EAAA,IAAAJ,CAAA,QAAAC,OAAA,IAAAD,CAAA,QAAAE,OAAA,IAAAF,CAAA,QAAAG,CAAA;IAEZC,EAAA,GAAAC,IAAA,CAAC;MAAAC,SAAA,EAAAT,SAAA;MAAAU,QAAA,EACCC,KAAA,CAAC;QAAAF,SAAA,EAAe,GAAAT,SAAA,WAAuB;QAAAU,QAAA,GACrCF,IAAA,CAAC;UAAAE,QAAA,EAAMN;QAAA,C,GACPI,IAAA,CAAC;UAAAC,SAAA,EAAkB,GAAAT,SAAA,SAAqB;UAAAY,OAAA,EAAWP,OAAA;UAAAQ,IAAA,EAAc;UAAAH,QAAA,EAC9DJ,CAAA,CAAE;QAAA,C;;;;;;;;;;SAJTC,E;CASJ","ignoreList":[]}

package/dist/elements/Nav/SidebarTabs/constants.d.ts

@@ -0,0 +1,2 @@
+export declare const DEFAULT_NAV_TAB_SLUG = "nav";
+//# sourceMappingURL=constants.d.ts.map

package/dist/elements/Nav/SidebarTabs/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/elements/Nav/SidebarTabs/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB,QAAQ,CAAA"}

package/dist/elements/Nav/SidebarTabs/constants.js

@@ -0,0 +1,2 @@
+export const DEFAULT_NAV_TAB_SLUG = 'nav';
+//# sourceMappingURL=constants.js.map

package/dist/elements/Nav/SidebarTabs/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","names":["DEFAULT_NAV_TAB_SLUG"],"sources":["../../../../src/elements/Nav/SidebarTabs/constants.ts"],"sourcesContent":["export const DEFAULT_NAV_TAB_SLUG = 'nav'\n"],"mappings":"AAAA,OAAO,MAAMA,oBAAA,GAAuB","ignoreList":[]}

package/dist/elements/Nav/SidebarTabs/index.client.d.ts

@@ -0,0 +1,22 @@
+import React from 'react';
+export type TabMetadata = {
+    icon: React.ReactNode;
+    isDefaultActive?: boolean;
+    label: string;
+    /** Whether this tab can be loaded/revalidated via serverFunction */
+    lazyLoadable?: boolean;
+    slug: string;
+};
+export type SidebarTabsClientProps = {
+    baseClass: string;
+    initialActiveTabID: string;
+    initialTabContents: Record<string, React.ReactNode>;
+    /**
+     * Delay before showing loading spinner (in ms), prevents flashing on fast loads
+     * @default 200
+     */
+    loadingDelay?: number;
+    tabs: TabMetadata[];
+};
+export declare const SidebarTabsClient: React.FC<SidebarTabsClientProps>;
+//# sourceMappingURL=index.client.d.ts.map

package/dist/elements/Nav/SidebarTabs/index.client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.client.d.ts","sourceRoot":"","sources":["../../../../src/elements/Nav/SidebarTabs/index.client.tsx"],"names":[],"mappings":"AAUA,OAAO,KAAwC,MAAM,OAAO,CAAA;AAM5D,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,KAAK,CAAC,SAAS,CAAA;IACrB,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,KAAK,EAAE,MAAM,CAAA;IACb,oEAAoE;IACpE,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED,MAAM,MAAM,sBAAsB,GAAG;IACnC,SAAS,EAAE,MAAM,CAAA;IACjB,kBAAkB,EAAE,MAAM,CAAA;IAC1B,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,SAAS,CAAC,CAAA;IACnD;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,IAAI,EAAE,WAAW,EAAE,CAAA;CACpB,CAAA;AAED,eAAO,MAAM,iBAAiB,EAAE,KAAK,CAAC,EAAE,CAAC,sBAAsB,CA4L9D,CAAA"}

package/dist/elements/Nav/SidebarTabs/index.client.js

@@ -0,0 +1,195 @@
+'use client';
+
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { DelayedSpinner, SidebarTabsProvider, Tooltip, usePreferences, useServerFunctions } from '@payloadcms/ui';
+import { PREFERENCE_KEYS } from 'payload/shared';
+import React, { useCallback, useRef, useState } from 'react';
+import { TabError } from './TabError/index.js';
+export const SidebarTabsClient = ({
+  baseClass,
+  initialActiveTabID,
+  initialTabContents,
+  loadingDelay = 200,
+  tabs
+}) => {
+  const {
+    setPreference
+  } = usePreferences();
+  const {
+    serverFunction
+  } = useServerFunctions();
+  const [activeTabID, setActiveTabID] = useState(initialActiveTabID);
+  const [tabContent, setTabContent] = useState(initialTabContents);
+  const [loadingTab, setLoadingTab] = useState(null);
+  const [hoveredTab, setHoveredTab] = useState(null);
+  const loadingTabsRef = useRef(new Set());
+  const tabContentRef = useRef(initialTabContents);
+  // Update cached content when server provides new initialTabContents
+  // This is needed because useState only uses initialValue on first mount
+  React.useEffect(() => {
+    tabContentRef.current = {
+      ...tabContentRef.current,
+      ...initialTabContents
+    };
+    setTabContent(prev => ({
+      ...prev,
+      ...initialTabContents
+    }));
+  }, [initialTabContents]);
+  const loadTabContent = useCallback(async (tabSlug, {
+    revalidate = false
+  } = {}) => {
+    const hasCachedContent = Boolean(tabContentRef.current[tabSlug]);
+    // Skip if already loaded (unless revalidating) or currently loading
+    if (hasCachedContent && !revalidate || loadingTabsRef.current.has(tabSlug)) {
+      return;
+    }
+    // Mark as loading - only show spinner if no cached content
+    loadingTabsRef.current.add(tabSlug);
+    if (!hasCachedContent) {
+      setLoadingTab(tabSlug);
+    }
+    try {
+      const result = await serverFunction({
+        name: 'render-tab',
+        args: {
+          tabSlug
+        }
+      });
+      const newContent_0 = {
+        ...tabContentRef.current,
+        [tabSlug]: result.component
+      };
+      tabContentRef.current = newContent_0;
+      setTabContent(newContent_0);
+    } catch (error) {
+      // On revalidate failure, keep showing cached content
+      if (hasCachedContent && revalidate) {
+        return;
+      }
+      const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+      const handleRetry = () => {
+        // Clear the error and retry loading
+        const clearedContent = {
+          ...tabContentRef.current
+        };
+        delete clearedContent[tabSlug];
+        tabContentRef.current = clearedContent;
+        setTabContent(clearedContent);
+        void loadTabContent(tabSlug);
+      };
+      const newContent = {
+        ...tabContentRef.current,
+        [tabSlug]: /*#__PURE__*/_jsx(TabError, {
+          message: errorMessage,
+          onRetry: handleRetry
+        })
+      };
+      tabContentRef.current = newContent;
+      setTabContent(newContent);
+    } finally {
+      loadingTabsRef.current.delete(tabSlug);
+      setLoadingTab(null);
+    }
+  }, [serverFunction]);
+  const reloadTabContent = useCallback(tabSlug_0 => {
+    // Clear cached content to force reload
+    const clearedContent_0 = {
+      ...tabContentRef.current
+    };
+    delete clearedContent_0[tabSlug_0];
+    tabContentRef.current = clearedContent_0;
+    setTabContent(clearedContent_0);
+    void loadTabContent(tabSlug_0);
+  }, [loadTabContent]);
+  const handleTabChange = useCallback(slug => {
+    setActiveTabID(slug);
+    void setPreference(PREFERENCE_KEYS.NAV_SIDEBAR_ACTIVE_TAB, {
+      activeTab: slug
+    });
+    // Only revalidate tabs that can be loaded via serverFunction
+    // Pre-rendered React elements (like default nav) can't be revalidated
+    const tab = tabs.find(t => t.slug === slug);
+    void loadTabContent(slug, {
+      revalidate: tab?.lazyLoadable ?? false
+    });
+  }, [setPreference, loadTabContent, tabs]);
+  const handleTabKeyDown = useCallback((e, currentIndex) => {
+    if (e.key === 'ArrowLeft' || e.key === 'ArrowRight') {
+      e.preventDefault();
+      const direction = e.key === 'ArrowLeft' ? -1 : 1;
+      const newIndex = (currentIndex + direction + tabs.length) % tabs.length;
+      const newTab = tabs[newIndex];
+      handleTabChange(newTab.slug);
+      // Focus will be handled by the tabIndex change
+      setTimeout(() => {
+        document.querySelector(`.${baseClass}__tab--active`)?.focus();
+      }, 0);
+    }
+  }, [baseClass, handleTabChange, tabs]);
+  const activeContent = tabContent[activeTabID];
+  // If there's only one tab (the default nav), render it without tab UI
+  if (tabs.length === 1) {
+    return /*#__PURE__*/_jsx(_Fragment, {
+      children: activeContent
+    });
+  }
+  return /*#__PURE__*/_jsx(SidebarTabsProvider, {
+    activeTabSlug: activeTabID,
+    reloadTabContent: reloadTabContent,
+    children: /*#__PURE__*/_jsxs("div", {
+      className: baseClass,
+      children: [/*#__PURE__*/_jsx("div", {
+        className: `${baseClass}__tabs`,
+        role: "tablist",
+        children: tabs.map((tab_0, index) => {
+          const isActive = tab_0.slug === activeTabID;
+          return /*#__PURE__*/_jsxs("button", {
+            "aria-selected": isActive,
+            className: `${baseClass}__tab ${isActive ? `${baseClass}__tab--active` : ''}`,
+            onClick: () => handleTabChange(tab_0.slug),
+            onKeyDown: e_0 => handleTabKeyDown(e_0, index),
+            onMouseEnter: () => setHoveredTab(tab_0.slug),
+            onMouseLeave: () => setHoveredTab(null),
+            role: "tab",
+            tabIndex: isActive ? 0 : -1,
+            type: "button",
+            children: [/*#__PURE__*/_jsx(Tooltip, {
+              className: `${baseClass}__tooltip`,
+              position: "bottom",
+              show: hoveredTab === tab_0.slug,
+              children: tab_0.label
+            }), /*#__PURE__*/_jsx("span", {
+              className: `${baseClass}__tab-icon`,
+              children: tab_0.icon
+            }), /*#__PURE__*/_jsx("span", {
+              className: `${baseClass}__tab-label`,
+              children: tab_0.label
+            })]
+          }, tab_0.slug);
+        })
+      }), /*#__PURE__*/_jsxs("div", {
+        className: `${baseClass}__content`,
+        role: "tabpanel",
+        children: [/*#__PURE__*/_jsx(DelayedSpinner, {
+          baseClass: baseClass,
+          delay: loadingDelay,
+          isLoading: loadingTab === activeTabID
+        }), tabs.map(tab_1 => {
+          const content = tabContent[tab_1.slug];
+          if (!content) {
+            return null;
+          }
+          const isActive_0 = tab_1.slug === activeTabID && loadingTab !== activeTabID;
+          return /*#__PURE__*/_jsx("div", {
+            style: isActive_0 ? undefined : {
+              display: 'none'
+            },
+            children: content
+          }, tab_1.slug);
+        })]
+      })]
+    })
+  });
+};
+//# sourceMappingURL=index.client.js.map

package/dist/elements/Nav/SidebarTabs/index.client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.client.js","names":["DelayedSpinner","SidebarTabsProvider","Tooltip","usePreferences","useServerFunctions","PREFERENCE_KEYS","React","useCallback","useRef","useState","TabError","SidebarTabsClient","baseClass","initialActiveTabID","initialTabContents","loadingDelay","tabs","setPreference","serverFunction","activeTabID","setActiveTabID","tabContent","setTabContent","loadingTab","setLoadingTab","hoveredTab","setHoveredTab","loadingTabsRef","Set","tabContentRef","useEffect","current","prev","loadTabContent","tabSlug","revalidate","hasCachedContent","Boolean","has","add","result","name","args","newContent","component","error","errorMessage","Error","message","handleRetry","clearedContent","_jsx","onRetry","delete","reloadTabContent","handleTabChange","slug","NAV_SIDEBAR_ACTIVE_TAB","activeTab","tab","find","t","lazyLoadable","handleTabKeyDown","e","currentIndex","key","preventDefault","direction","newIndex","length","newTab","setTimeout","document","querySelector","focus","activeContent","_Fragment","activeTabSlug","_jsxs","className","role","map","index","isActive","onClick","onKeyDown","onMouseEnter","onMouseLeave","tabIndex","type","position","show","label","icon","delay","isLoading","content","style","undefined","display"],"sources":["../../../../src/elements/Nav/SidebarTabs/index.client.tsx"],"sourcesContent":["'use client'\n\nimport {\n  DelayedSpinner,\n  SidebarTabsProvider,\n  Tooltip,\n  usePreferences,\n  useServerFunctions,\n} from '@payloadcms/ui'\nimport { PREFERENCE_KEYS } from 'payload/shared'\nimport React, { useCallback, useRef, useState } from 'react'\n\nimport type { RenderTabServerFnArgs, RenderTabServerFnReturnType } from './renderTabServerFn.js'\n\nimport { TabError } from './TabError/index.js'\n\nexport type TabMetadata = {\n  icon: React.ReactNode\n  isDefaultActive?: boolean\n  label: string\n  /** Whether this tab can be loaded/revalidated via serverFunction */\n  lazyLoadable?: boolean\n  slug: string\n}\n\nexport type SidebarTabsClientProps = {\n  baseClass: string\n  initialActiveTabID: string\n  initialTabContents: Record<string, React.ReactNode>\n  /**\n   * Delay before showing loading spinner (in ms), prevents flashing on fast loads\n   * @default 200\n   */\n  loadingDelay?: number\n  tabs: TabMetadata[]\n}\n\nexport const SidebarTabsClient: React.FC<SidebarTabsClientProps> = ({\n  baseClass,\n  initialActiveTabID,\n  initialTabContents,\n  loadingDelay = 200,\n  tabs,\n}) => {\n  const { setPreference } = usePreferences()\n  const { serverFunction } = useServerFunctions()\n\n  const [activeTabID, setActiveTabID] = useState(initialActiveTabID)\n  const [tabContent, setTabContent] = useState<Record<string, React.ReactNode>>(initialTabContents)\n  const [loadingTab, setLoadingTab] = useState<null | string>(null)\n  const [hoveredTab, setHoveredTab] = useState<null | string>(null)\n  const loadingTabsRef = useRef<Set<string>>(new Set())\n  const tabContentRef = useRef(initialTabContents)\n\n  // Update cached content when server provides new initialTabContents\n  // This is needed because useState only uses initialValue on first mount\n  React.useEffect(() => {\n    tabContentRef.current = { ...tabContentRef.current, ...initialTabContents }\n    setTabContent((prev) => ({ ...prev, ...initialTabContents }))\n  }, [initialTabContents])\n\n  const loadTabContent = useCallback(\n    async (tabSlug: string, { revalidate = false }: { revalidate?: boolean } = {}) => {\n      const hasCachedContent = Boolean(tabContentRef.current[tabSlug])\n\n      // Skip if already loaded (unless revalidating) or currently loading\n      if ((hasCachedContent && !revalidate) || loadingTabsRef.current.has(tabSlug)) {\n        return\n      }\n\n      // Mark as loading - only show spinner if no cached content\n      loadingTabsRef.current.add(tabSlug)\n      if (!hasCachedContent) {\n        setLoadingTab(tabSlug)\n      }\n\n      try {\n        const result = (await serverFunction({\n          name: 'render-tab',\n          args: { tabSlug } as RenderTabServerFnArgs,\n        })) as RenderTabServerFnReturnType\n\n        const newContent = {\n          ...tabContentRef.current,\n          [tabSlug]: result.component,\n        }\n\n        tabContentRef.current = newContent\n        setTabContent(newContent)\n      } catch (error) {\n        // On revalidate failure, keep showing cached content\n        if (hasCachedContent && revalidate) {\n          return\n        }\n\n        const errorMessage = error instanceof Error ? error.message : 'Unknown error'\n\n        const handleRetry = () => {\n          // Clear the error and retry loading\n          const clearedContent = { ...tabContentRef.current }\n          delete clearedContent[tabSlug]\n          tabContentRef.current = clearedContent\n          setTabContent(clearedContent)\n          void loadTabContent(tabSlug)\n        }\n\n        const newContent = {\n          ...tabContentRef.current,\n          [tabSlug]: <TabError message={errorMessage} onRetry={handleRetry} />,\n        }\n\n        tabContentRef.current = newContent\n        setTabContent(newContent)\n      } finally {\n        loadingTabsRef.current.delete(tabSlug)\n        setLoadingTab(null)\n      }\n    },\n    [serverFunction],\n  )\n\n  const reloadTabContent = useCallback(\n    (tabSlug: string) => {\n      // Clear cached content to force reload\n      const clearedContent = { ...tabContentRef.current }\n      delete clearedContent[tabSlug]\n      tabContentRef.current = clearedContent\n      setTabContent(clearedContent)\n\n      void loadTabContent(tabSlug)\n    },\n    [loadTabContent],\n  )\n\n  const handleTabChange = useCallback(\n    (slug: string) => {\n      setActiveTabID(slug)\n      void setPreference(PREFERENCE_KEYS.NAV_SIDEBAR_ACTIVE_TAB, { activeTab: slug })\n      // Only revalidate tabs that can be loaded via serverFunction\n      // Pre-rendered React elements (like default nav) can't be revalidated\n      const tab = tabs.find((t) => t.slug === slug)\n      void loadTabContent(slug, { revalidate: tab?.lazyLoadable ?? false })\n    },\n    [setPreference, loadTabContent, tabs],\n  )\n\n  const handleTabKeyDown = useCallback(\n    (e: React.KeyboardEvent, currentIndex: number) => {\n      if (e.key === 'ArrowLeft' || e.key === 'ArrowRight') {\n        e.preventDefault()\n        const direction = e.key === 'ArrowLeft' ? -1 : 1\n        const newIndex = (currentIndex + direction + tabs.length) % tabs.length\n        const newTab = tabs[newIndex]\n        handleTabChange(newTab.slug)\n        // Focus will be handled by the tabIndex change\n        setTimeout(() => {\n          document.querySelector<HTMLButtonElement>(`.${baseClass}__tab--active`)?.focus()\n        }, 0)\n      }\n    },\n    [baseClass, handleTabChange, tabs],\n  )\n\n  const activeContent = tabContent[activeTabID]\n\n  // If there's only one tab (the default nav), render it without tab UI\n  if (tabs.length === 1) {\n    return <>{activeContent}</>\n  }\n\n  return (\n    <SidebarTabsProvider activeTabSlug={activeTabID} reloadTabContent={reloadTabContent}>\n      <div className={baseClass}>\n        <div className={`${baseClass}__tabs`} role=\"tablist\">\n          {tabs.map((tab, index) => {\n            const isActive = tab.slug === activeTabID\n\n            return (\n              <button\n                aria-selected={isActive}\n                className={`${baseClass}__tab ${isActive ? `${baseClass}__tab--active` : ''}`}\n                key={tab.slug}\n                onClick={() => handleTabChange(tab.slug)}\n                onKeyDown={(e) => handleTabKeyDown(e, index)}\n                onMouseEnter={() => setHoveredTab(tab.slug)}\n                onMouseLeave={() => setHoveredTab(null)}\n                role=\"tab\"\n                tabIndex={isActive ? 0 : -1}\n                type=\"button\"\n              >\n                <Tooltip\n                  className={`${baseClass}__tooltip`}\n                  position=\"bottom\"\n                  show={hoveredTab === tab.slug}\n                >\n                  {tab.label}\n                </Tooltip>\n                <span className={`${baseClass}__tab-icon`}>{tab.icon}</span>\n                <span className={`${baseClass}__tab-label`}>{tab.label}</span>\n              </button>\n            )\n          })}\n        </div>\n        <div className={`${baseClass}__content`} role=\"tabpanel\">\n          <DelayedSpinner\n            baseClass={baseClass}\n            delay={loadingDelay}\n            isLoading={loadingTab === activeTabID}\n          />\n          {tabs.map((tab) => {\n            const content = tabContent[tab.slug]\n            if (!content) {\n              return null\n            }\n            const isActive = tab.slug === activeTabID && loadingTab !== activeTabID\n            return (\n              <div key={tab.slug} style={isActive ? undefined : { display: 'none' }}>\n                {content}\n              </div>\n            )\n          })}\n        </div>\n      </div>\n    </SidebarTabsProvider>\n  )\n}\n"],"mappings":"AAAA;;;AAEA,SACEA,cAAc,EACdC,mBAAmB,EACnBC,OAAO,EACPC,cAAc,EACdC,kBAAkB,QACb;AACP,SAASC,eAAe,QAAQ;AAChC,OAAOC,KAAA,IAASC,WAAW,EAAEC,MAAM,EAAEC,QAAQ,QAAQ;AAIrD,SAASC,QAAQ,QAAQ;AAuBzB,OAAO,MAAMC,iBAAA,GAAsDA,CAAC;EAClEC,SAAS;EACTC,kBAAkB;EAClBC,kBAAkB;EAClBC,YAAA,GAAe,GAAG;EAClBC;AAAI,CACL;EACC,MAAM;IAAEC;EAAa,CAAE,GAAGd,cAAA;EAC1B,MAAM;IAAEe;EAAc,CAAE,GAAGd,kBAAA;EAE3B,MAAM,CAACe,WAAA,EAAaC,cAAA,CAAe,GAAGX,QAAA,CAASI,kBAAA;EAC/C,MAAM,CAACQ,UAAA,EAAYC,aAAA,CAAc,GAAGb,QAAA,CAA0CK,kBAAA;EAC9E,MAAM,CAACS,UAAA,EAAYC,aAAA,CAAc,GAAGf,QAAA,CAAwB;EAC5D,MAAM,CAACgB,UAAA,EAAYC,aAAA,CAAc,GAAGjB,QAAA,CAAwB;EAC5D,MAAMkB,cAAA,GAAiBnB,MAAA,CAAoB,IAAIoB,GAAA;EAC/C,MAAMC,aAAA,GAAgBrB,MAAA,CAAOM,kBAAA;EAE7B;EACA;EACAR,KAAA,CAAMwB,SAAS,CAAC;IACdD,aAAA,CAAcE,OAAO,GAAG;MAAE,GAAGF,aAAA,CAAcE,OAAO;MAAE,GAAGjB;IAAmB;IAC1EQ,aAAA,CAAeU,IAAA,KAAU;MAAE,GAAGA,IAAI;MAAE,GAAGlB;IAAmB;EAC5D,GAAG,CAACA,kBAAA,CAAmB;EAEvB,MAAMmB,cAAA,GAAiB1B,WAAA,CACrB,OAAO2B,OAAA,EAAiB;IAAEC,UAAA,GAAa;EAAK,CAA4B,GAAG,CAAC,CAAC;IAC3E,MAAMC,gBAAA,GAAmBC,OAAA,CAAQR,aAAA,CAAcE,OAAO,CAACG,OAAA,CAAQ;IAE/D;IACA,IAAIE,gBAAC,IAAoB,CAACD,UAAA,IAAeR,cAAA,CAAeI,OAAO,CAACO,GAAG,CAACJ,OAAA,GAAU;MAC5E;IACF;IAEA;IACAP,cAAA,CAAeI,OAAO,CAACQ,GAAG,CAACL,OAAA;IAC3B,IAAI,CAACE,gBAAA,EAAkB;MACrBZ,aAAA,CAAcU,OAAA;IAChB;IAEA,IAAI;MACF,MAAMM,MAAA,GAAU,MAAMtB,cAAA,CAAe;QACnCuB,IAAA,EAAM;QACNC,IAAA,EAAM;UAAER;QAAQ;MAClB;MAEA,MAAMS,YAAA,GAAa;QACjB,GAAGd,aAAA,CAAcE,OAAO;QACxB,CAACG,OAAA,GAAUM,MAAA,CAAOI;MACpB;MAEAf,aAAA,CAAcE,OAAO,GAAGY,YAAA;MACxBrB,aAAA,CAAcqB,YAAA;IAChB,EAAE,OAAOE,KAAA,EAAO;MACd;MACA,IAAIT,gBAAA,IAAoBD,UAAA,EAAY;QAClC;MACF;MAEA,MAAMW,YAAA,GAAeD,KAAA,YAAiBE,KAAA,GAAQF,KAAA,CAAMG,OAAO,GAAG;MAE9D,MAAMC,WAAA,GAAcA,CAAA;QAClB;QACA,MAAMC,cAAA,GAAiB;UAAE,GAAGrB,aAAA,CAAcE;QAAQ;QAClD,OAAOmB,cAAc,CAAChB,OAAA,CAAQ;QAC9BL,aAAA,CAAcE,OAAO,GAAGmB,cAAA;QACxB5B,aAAA,CAAc4B,cAAA;QACd,KAAKjB,cAAA,CAAeC,OAAA;MACtB;MAEA,MAAMS,UAAA,GAAa;QACjB,GAAGd,aAAA,CAAcE,OAAO;QACxB,CAACG,OAAA,GAAQ,aAAEiB,IAAA,CAACzC,QAAA;UAASsC,OAAA,EAASF,YAAA;UAAcM,OAAA,EAASH;;MACvD;MAEApB,aAAA,CAAcE,OAAO,GAAGY,UAAA;MACxBrB,aAAA,CAAcqB,UAAA;IAChB,UAAU;MACRhB,cAAA,CAAeI,OAAO,CAACsB,MAAM,CAACnB,OAAA;MAC9BV,aAAA,CAAc;IAChB;EACF,GACA,CAACN,cAAA,CAAe;EAGlB,MAAMoC,gBAAA,GAAmB/C,WAAA,CACtB2B,SAAA;IACC;IACA,MAAMgB,gBAAA,GAAiB;MAAE,GAAGrB,aAAA,CAAcE;IAAQ;IAClD,OAAOmB,gBAAc,CAAChB,SAAA,CAAQ;IAC9BL,aAAA,CAAcE,OAAO,GAAGmB,gBAAA;IACxB5B,aAAA,CAAc4B,gBAAA;IAEd,KAAKjB,cAAA,CAAeC,SAAA;EACtB,GACA,CAACD,cAAA,CAAe;EAGlB,MAAMsB,eAAA,GAAkBhD,WAAA,CACrBiD,IAAA;IACCpC,cAAA,CAAeoC,IAAA;IACf,KAAKvC,aAAA,CAAcZ,eAAA,CAAgBoD,sBAAsB,EAAE;MAAEC,SAAA,EAAWF;IAAK;IAC7E;IACA;IACA,MAAMG,GAAA,GAAM3C,IAAA,CAAK4C,IAAI,CAAEC,CAAA,IAAMA,CAAA,CAAEL,IAAI,KAAKA,IAAA;IACxC,KAAKvB,cAAA,CAAeuB,IAAA,EAAM;MAAErB,UAAA,EAAYwB,GAAA,EAAKG,YAAA,IAAgB;IAAM;EACrE,GACA,CAAC7C,aAAA,EAAegB,cAAA,EAAgBjB,IAAA,CAAK;EAGvC,MAAM+C,gBAAA,GAAmBxD,WAAA,CACvB,CAACyD,CAAA,EAAwBC,YAAA;IACvB,IAAID,CAAA,CAAEE,GAAG,KAAK,eAAeF,CAAA,CAAEE,GAAG,KAAK,cAAc;MACnDF,CAAA,CAAEG,cAAc;MAChB,MAAMC,SAAA,GAAYJ,CAAA,CAAEE,GAAG,KAAK,cAAc,CAAC,IAAI;MAC/C,MAAMG,QAAA,GAAW,CAACJ,YAAA,GAAeG,SAAA,GAAYpD,IAAA,CAAKsD,MAAM,IAAItD,IAAA,CAAKsD,MAAM;MACvE,MAAMC,MAAA,GAASvD,IAAI,CAACqD,QAAA,CAAS;MAC7Bd,eAAA,CAAgBgB,MAAA,CAAOf,IAAI;MAC3B;MACAgB,UAAA,CAAW;QACTC,QAAA,CAASC,aAAa,CAAoB,IAAI9D,SAAA,eAAwB,GAAG+D,KAAA;MAC3E,GAAG;IACL;EACF,GACA,CAAC/D,SAAA,EAAW2C,eAAA,EAAiBvC,IAAA,CAAK;EAGpC,MAAM4D,aAAA,GAAgBvD,UAAU,CAACF,WAAA,CAAY;EAE7C;EACA,IAAIH,IAAA,CAAKsD,MAAM,KAAK,GAAG;IACrB,oBAAOnB,IAAA,CAAA0B,SAAA;gBAAGD;;EACZ;EAEA,oBACEzB,IAAA,CAAClD,mBAAA;IAAoB6E,aAAA,EAAe3D,WAAA;IAAamC,gBAAA,EAAkBA,gBAAA;cACjE,aAAAyB,KAAA,CAAC;MAAIC,SAAA,EAAWpE,SAAA;8BACduC,IAAA,CAAC;QAAI6B,SAAA,EAAW,GAAGpE,SAAA,QAAiB;QAAEqE,IAAA,EAAK;kBACxCjE,IAAA,CAAKkE,GAAG,CAAC,CAACvB,KAAA,EAAKwB,KAAA;UACd,MAAMC,QAAA,GAAWzB,KAAA,CAAIH,IAAI,KAAKrC,WAAA;UAE9B,oBACE4D,KAAA,CAAC;YACC,iBAAeK,QAAA;YACfJ,SAAA,EAAW,GAAGpE,SAAA,SAAkBwE,QAAA,GAAW,GAAGxE,SAAA,eAAwB,GAAG,IAAI;YAE7EyE,OAAA,EAASA,CAAA,KAAM9B,eAAA,CAAgBI,KAAA,CAAIH,IAAI;YACvC8B,SAAA,EAAYtB,GAAA,IAAMD,gBAAA,CAAiBC,GAAA,EAAGmB,KAAA;YACtCI,YAAA,EAAcA,CAAA,KAAM7D,aAAA,CAAciC,KAAA,CAAIH,IAAI;YAC1CgC,YAAA,EAAcA,CAAA,KAAM9D,aAAA,CAAc;YAClCuD,IAAA,EAAK;YACLQ,QAAA,EAAUL,QAAA,GAAW,IAAI,CAAC;YAC1BM,IAAA,EAAK;oCAELvC,IAAA,CAACjD,OAAA;cACC8E,SAAA,EAAW,GAAGpE,SAAA,WAAoB;cAClC+E,QAAA,EAAS;cACTC,IAAA,EAAMnE,UAAA,KAAekC,KAAA,CAAIH,IAAI;wBAE5BG,KAAA,CAAIkC;6BAEP1C,IAAA,CAAC;cAAK6B,SAAA,EAAW,GAAGpE,SAAA,YAAqB;wBAAG+C,KAAA,CAAImC;6BAChD3C,IAAA,CAAC;cAAK6B,SAAA,EAAW,GAAGpE,SAAA,aAAsB;wBAAG+C,KAAA,CAAIkC;;aAjB5ClC,KAAA,CAAIH,IAAI;QAoBnB;uBAEFuB,KAAA,CAAC;QAAIC,SAAA,EAAW,GAAGpE,SAAA,WAAoB;QAAEqE,IAAA,EAAK;gCAC5C9B,IAAA,CAACnD,cAAA;UACCY,SAAA,EAAWA,SAAA;UACXmF,KAAA,EAAOhF,YAAA;UACPiF,SAAA,EAAWzE,UAAA,KAAeJ;YAE3BH,IAAA,CAAKkE,GAAG,CAAEvB,KAAA;UACT,MAAMsC,OAAA,GAAU5E,UAAU,CAACsC,KAAA,CAAIH,IAAI,CAAC;UACpC,IAAI,CAACyC,OAAA,EAAS;YACZ,OAAO;UACT;UACA,MAAMb,UAAA,GAAWzB,KAAA,CAAIH,IAAI,KAAKrC,WAAA,IAAeI,UAAA,KAAeJ,WAAA;UAC5D,oBACEgC,IAAA,CAAC;YAAmB+C,KAAA,EAAOd,UAAA,GAAWe,SAAA,GAAY;cAAEC,OAAA,EAAS;YAAO;sBACjEH;aADOtC,KAAA,CAAIH,IAAI;QAItB;;;;AAKV","ignoreList":[]}

package/dist/elements/Nav/SidebarTabs/index.css

@@ -0,0 +1,80 @@
+@layer payload-default {
+  .sidebar-tabs {
+    display: flex;
+    flex-direction: column;
+    width: 100%;
+    flex-grow: 1;
+    gap: var(--spacer-2-5);
+  }
+
+  .sidebar-tabs__tabs {
+    display: flex;
+    gap: 0;
+    background-color: var(--color-bg-secondary);
+    border-radius: var(--radius-medium);
+    width: 100%;
+  }
+
+  .sidebar-tabs__tab {
+    all: unset;
+    box-sizing: border-box;
+    display: flex;
+    flex: 1;
+    align-items: center;
+    justify-content: center;
+    height: var(--spacer-4);
+    padding: 0 var(--spacer-1);
+    cursor: pointer;
+    border-radius: var(--radius-medium);
+    border: var(--stroke-width-small) solid transparent;
+    background-color: transparent;
+    color: var(--color-icon-secondary);
+    transition:
+      background-color 0.15s ease,
+      border-color 0.15s ease,
+      color 0.15s ease;
+    position: relative;
+
+    &:hover {
+      color: var(--color-icon);
+    }
+  }
+
+  .sidebar-tabs__tab--active {
+    background-color: var(--color-bg);
+    border-color: var(--color-border);
+    color: var(--color-icon);
+  }
+
+  .sidebar-tabs__tab-icon {
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    transition: opacity 0.15s ease;
+  }
+
+  /* Visually hidden but still accessible for screen readers */
+  .sidebar-tabs__tab-label {
+    position: absolute;
+    width: 1px;
+    height: 1px;
+    padding: 0;
+    overflow: hidden;
+    clip: rect(0, 0, 0, 0);
+    white-space: nowrap;
+    border-width: 0;
+  }
+
+  .sidebar-tabs__content {
+    width: 100%;
+    flex-grow: 1;
+    position: relative;
+  }
+
+  .sidebar-tabs__loading {
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    min-height: calc(var(--spacer-6) * 2.5);
+  }
+}

package/dist/elements/Nav/SidebarTabs/index.d.ts

@@ -0,0 +1,17 @@
+import type { NavPreferences, PayloadComponent, SidebarTab } from 'payload';
+import React from 'react';
+import type { NavProps } from '../index.js';
+import './index.css';
+type SidebarTabWithReactNode = {
+    components: {
+        Content: PayloadComponent | React.ReactNode;
+        Icon: PayloadComponent | React.ReactNode;
+    };
+} & Omit<SidebarTab, 'components'>;
+export type SidebarTabsProps = {
+    navPreferences: NavPreferences;
+    tabs: SidebarTabWithReactNode[];
+} & NavProps;
+export declare const SidebarTabs: React.FC<SidebarTabsProps>;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/elements/Nav/SidebarTabs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/elements/Nav/SidebarTabs/index.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAI3E,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAG3C,OAAO,aAAa,CAAA;AAEpB,KAAK,uBAAuB,GAAG;IAC7B,UAAU,EAAE;QACV,OAAO,EAAE,gBAAgB,GAAG,KAAK,CAAC,SAAS,CAAA;QAC3C,IAAI,EAAE,gBAAgB,GAAG,KAAK,CAAC,SAAS,CAAA;KACzC,CAAA;CACF,GAAG,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC,CAAA;AAElC,MAAM,MAAM,gBAAgB,GAAG;IAC7B,cAAc,EAAE,cAAc,CAAA;IAC9B,IAAI,EAAE,uBAAuB,EAAE,CAAA;CAChC,GAAG,QAAQ,CAAA;AAIZ,eAAO,MAAM,WAAW,EAAE,KAAK,CAAC,EAAE,CAAC,gBAAgB,CA4FlD,CAAA"}

package/dist/elements/Nav/SidebarTabs/index.js

@@ -0,0 +1,85 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { getTranslation } from '@payloadcms/translations';
+import { RenderServerComponent } from '@payloadcms/ui/elements/RenderServerComponent';
+import React from 'react';
+import { SidebarTabsClient } from './index.client.js';
+const baseClass = 'sidebar-tabs';
+export const SidebarTabs = props => {
+  const {
+    documentSubViewType,
+    i18n,
+    locale,
+    navPreferences,
+    params,
+    payload,
+    permissions,
+    req,
+    searchParams,
+    tabs,
+    user,
+    viewType
+  } = props;
+  // Determine which tab should be active on initial load
+  // First try saved preference, then default tab, then first tab
+  const preferredTabSlug = navPreferences.activeTab || tabs.find(tab => tab.isDefaultActive)?.slug || tabs[0]?.slug;
+  // Verify the preferred tab actually exists, otherwise fall back to default or first tab
+  const activeTab = tabs.find(t => t.slug === preferredTabSlug) || tabs.find(tab => tab.isDefaultActive) || tabs[0];
+  const initialActiveTabID = activeTab?.slug || tabs[0]?.slug;
+  // Build initial tab contents
+  // Strategy: Pre-render tabs that are already React elements (can't be lazy-loaded),
+  // and only render the initially active tab if it's a CustomComponent (can be lazy-loaded)
+  const initialTabContents = {};
+  const renderComponent = component => {
+    // Check if component is already a React node (payload provided React component)
+    if (/*#__PURE__*/React.isValidElement(component)) {
+      return component;
+    } else {
+      // Otherwise render it as a CustomComponent
+      return RenderServerComponent({
+        clientProps: {
+          documentSubViewType,
+          viewType
+        },
+        Component: component,
+        importMap: payload.importMap,
+        serverProps: {
+          i18n,
+          locale,
+          params,
+          payload,
+          permissions,
+          req,
+          searchParams,
+          user
+        }
+      });
+    }
+  };
+  for (const tab of tabs) {
+    if (/*#__PURE__*/React.isValidElement(tab.components.Content)) {
+      initialTabContents[tab.slug] = tab.components.Content;
+    }
+  }
+  // If the active tab is a CustomComponent (lazy-loadable), render it now
+  if (activeTab && ! /*#__PURE__*/React.isValidElement(activeTab.components.Content)) {
+    initialTabContents[activeTab.slug] = renderComponent(activeTab.components.Content);
+  }
+  return /*#__PURE__*/_jsx(SidebarTabsClient, {
+    baseClass: baseClass,
+    initialActiveTabID: initialActiveTabID,
+    initialTabContents: initialTabContents,
+    tabs: tabs.map(tab => {
+      const labelText = tab.label ? getTranslation(tab.label, i18n) : tab.slug;
+      // CustomComponents can be lazy-loaded/revalidated, React elements cannot
+      const isLazyLoadable = ! /*#__PURE__*/React.isValidElement(tab.components.Content);
+      return {
+        slug: tab.slug,
+        icon: renderComponent(tab.components.Icon),
+        isDefaultActive: tab.isDefaultActive,
+        label: labelText,
+        lazyLoadable: isLazyLoadable
+      };
+    })
+  });
+};
+//# sourceMappingURL=index.js.map