jamdesk 1.1.168 → 1.1.169

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jamdesk",
-  "version": "1.1.168",
+  "version": "1.1.169",
   "description": "CLI for Jamdesk — build, preview, and deploy documentation sites from MDX. Dev server with hot reload, 50+ components, OpenAPI support, AI search, and Mintlify migration",
   "keywords": [
     "jamdesk",

package/vendored/components/navigation/Sidebar.tsx

@@ -433,7 +433,9 @@ export function Sidebar({ config, layout = 'header-logo', tabsPosition: tabsPosi
   // Prevent body scroll when sidebar is open on mobile
   useBodyScrollLock(isOpen);
 
-  // Toggle group expansion; if expanding, navigate to first page.
+  // Toggle group expansion; if expanding, navigate to first page. Top-level
+  // sections never visually collapse — for them the toggled key only gates
+  // prefetch (see renderGroupContents) while the click still navigates.
   // The router.push must run AFTER the setState commits — calling it inside the
   // updater triggers "Cannot update a component (Router) while rendering Sidebar".
   const handleGroupClick = useCallback((group: ResolvedGroup, key: string) => {
@@ -460,8 +462,11 @@ export function Sidebar({ config, layout = 'header-logo', tabsPosition: tabsPosi
   // (mounting them only while open) while an unnamed group renders them inline.
   function renderGroupContents(group: ResolvedGroup, level: number, indexPath: GroupIndexPath) {
     const isExpanded = expandedGroups.has(groupStateKey(scope, indexPath));
-    // Closed named groups never reach here (their contents are unmounted), so a
-    // rendered named group is always expanded; unnamed groups always prefetch.
+    // Top-level sections stay mounted while collapsed-in-state, so their Links
+    // hold prefetch until the section is seeded or clicked expanded (don't fan
+    // out RSC prefetches for every section on large sites). Closed NESTED named
+    // groups never reach here (their contents are unmounted), so a rendered
+    // nested named group is always expanded; unnamed groups always prefetch.
     const shouldPrefetch = !group.name || isExpanded;
 
     if (group.items) {
@@ -549,9 +554,11 @@ export function Sidebar({ config, layout = 'header-logo', tabsPosition: tabsPosi
     );
   }
 
-  // Render a navigation group (supports nesting). Every named group — top-level
-  // or nested — is an accordion: a button carrying aria-expanded/aria-controls
-  // toggles an addressable panel whose descendants mount only while expanded.
+  // Render a navigation group (supports nesting). Top-level named groups are
+  // permanent sections: the header never collapses, its contents stay mounted,
+  // and clicking it navigates to the group's first page. Nested named groups
+  // are accordions: a button carrying aria-expanded/aria-controls toggles an
+  // addressable panel whose descendants mount only while expanded.
   function renderGroup(group: ResolvedGroup, level: number = 0, indexPath: GroupIndexPath = []) {
     // Skip rendering if group has no name and no content
     if (!group.name && group.pages.length === 0 && !group.nested?.length && !group.items?.length) {
@@ -559,13 +566,38 @@ export function Sidebar({ config, layout = 'header-logo', tabsPosition: tabsPosi
     }
 
     const key = groupStateKey(scope, indexPath);
-    const panelId = groupPanelId(scope, indexPath);
     const isExpanded = expandedGroups.has(key);
-    const isTopLevel = level === 0;
-    const outerClassName = isTopLevel ? 'ml-6' : level === 1 ? '' : 'ml-3';
-    const buttonClassName = isTopLevel
-      ? 'flex items-center gap-2 w-full min-h-8 py-1.5 mb-2 text-left text-sm font-semibold text-[var(--color-text-tertiary)] cursor-pointer focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-[var(--color-accent)] focus-visible:ring-offset-2'
-      : `nav-group-l1 flex items-center gap-1.5 ${layout === 'header-logo' ? 'pr-3' : 'px-3'} py-1.5 rounded-lg text-sm transition-colors w-full text-left text-[var(--color-text-tertiary)] hover:text-[var(--color-text-primary)] cursor-pointer focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-[var(--color-accent)] focus-visible:ring-offset-2`;
+
+    if (level === 0) {
+      return (
+        <div key={key} className="ml-6">
+          {group.name && (
+            <button
+              type="button"
+              onClick={() => handleGroupClick(group, key)}
+              className="flex items-center justify-between w-full text-left mb-2 cursor-pointer"
+            >
+              <span className="text-sm font-semibold text-[var(--color-text-tertiary)] flex items-center gap-2">
+                {group.icon && (
+                  <i className={`${getIconClass(group.icon)} text-[14px]`} aria-hidden="true" />
+                )}
+                {group.name}
+                {group.tag && (
+                  <span className="px-1.5 py-0.5 text-[9px] font-semibold rounded bg-[var(--color-accent)]/15 text-[var(--color-accent)] normal-case tracking-normal">
+                    {group.tag}
+                  </span>
+                )}
+              </span>
+            </button>
+          )}
+          {renderGroupContents(group, level, indexPath)}
+        </div>
+      );
+    }
+
+    const panelId = groupPanelId(scope, indexPath);
+    const outerClassName = level === 1 ? '' : 'ml-3';
+    const buttonClassName = `nav-group-l1 flex items-center gap-1.5 ${layout === 'header-logo' ? 'pr-3' : 'px-3'} py-1.5 rounded-lg text-sm transition-colors w-full text-left text-[var(--color-text-tertiary)] hover:text-[var(--color-text-primary)] cursor-pointer focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-[var(--color-accent)] focus-visible:ring-offset-2`;
 
     return (
       <div key={key} className={outerClassName}>
@@ -582,7 +614,7 @@ export function Sidebar({ config, layout = 'header-logo', tabsPosition: tabsPosi
             )}
             <span className="flex-1 min-w-0 truncate">{group.name}</span>
             {group.tag && (
-              <span className={`${isTopLevel ? 'text-[9px]' : 'text-[10px]'} px-1.5 py-0.5 font-semibold rounded bg-[var(--color-accent)]/15 text-[var(--color-accent)]`}>
+              <span className="px-1.5 py-0.5 text-[10px] font-semibold rounded bg-[var(--color-accent)]/15 text-[var(--color-accent)]">
                 {group.tag}
               </span>
             )}

package/vendored/workspace-package-lock.json

@@ -217,57 +217,57 @@
       }
     },
     "node_modules/@fortawesome/fontawesome-common-types": {
-      "version": "7.3.0",
-      "resolved": "https://registry.npmjs.org/@fortawesome/fontawesome-common-types/-/fontawesome-common-types-7.3.0.tgz",
-      "integrity": "sha512-X/vND0Y1l9fVJ9O79UgtZnXSpz4aNF3bXlDxiJAEAm6kgeSftp9wjjBPgqzazJV8YlmxfRoeXNfSCJ48sf/Hhw==",
+      "version": "7.3.1",
+      "resolved": "https://registry.npmjs.org/@fortawesome/fontawesome-common-types/-/fontawesome-common-types-7.3.1.tgz",
+      "integrity": "sha512-k0C0sdHmZtAo6dRDtd1Z/qcpyHbL0CKsjV8seMY/21xGhY5Wsv0XRmiI/xEEH4y2c9b1+jvgNs/3EqhV27yUEA==",
       "license": "MIT",
       "engines": {
         "node": ">=6"
       }
     },
     "node_modules/@fortawesome/fontawesome-svg-core": {
-      "version": "7.3.0",
-      "resolved": "https://registry.npmjs.org/@fortawesome/fontawesome-svg-core/-/fontawesome-svg-core-7.3.0.tgz",
-      "integrity": "sha512-MFbTNLDWkLJwbozDvHOZ7hwyDjQcBMBattlcOQ6ZmV5YD9bBrqdl1rNtmVjQ/lzqveXXX3sMz2Ew6fAgXoxmkw==",
+      "version": "7.3.1",
+      "resolved": "https://registry.npmjs.org/@fortawesome/fontawesome-svg-core/-/fontawesome-svg-core-7.3.1.tgz",
+      "integrity": "sha512-BoxVN3PKnMbgStHhjoaky/oWdxHomDqmBVA24IA3KEmssFGeI7u9YT/BJceOjIum/t6TpPa/vcMKaVYQeIQ/3Q==",
       "license": "MIT",
       "dependencies": {
-        "@fortawesome/fontawesome-common-types": "7.3.0"
+        "@fortawesome/fontawesome-common-types": "7.3.1"
       },
       "engines": {
         "node": ">=6"
       }
     },
     "node_modules/@fortawesome/free-brands-svg-icons": {
-      "version": "7.3.0",
-      "resolved": "https://registry.npmjs.org/@fortawesome/free-brands-svg-icons/-/free-brands-svg-icons-7.3.0.tgz",
-      "integrity": "sha512-W6C9ZbPWpwcUycq6U90lVbvWTrEnr01Td2x5jlO8fOtvww4kqDBMSmZqXQCc6FIIJD4kTH6G1MBRExAaSXz3yg==",
+      "version": "7.3.1",
+      "resolved": "https://registry.npmjs.org/@fortawesome/free-brands-svg-icons/-/free-brands-svg-icons-7.3.1.tgz",
+      "integrity": "sha512-8eiNzycuFhy3mZsi5EVO8JpO3H8l7/kSCl4Gk4iUew9hJuzYFqAAD6kqgeEup3+YZ9hL+5cjjorGzrRLkYuURg==",
       "license": "(CC-BY-4.0 AND MIT)",
       "dependencies": {
-        "@fortawesome/fontawesome-common-types": "7.3.0"
+        "@fortawesome/fontawesome-common-types": "7.3.1"
       },
       "engines": {
         "node": ">=6"
       }
     },
     "node_modules/@fortawesome/free-regular-svg-icons": {
-      "version": "7.3.0",
-      "resolved": "https://registry.npmjs.org/@fortawesome/free-regular-svg-icons/-/free-regular-svg-icons-7.3.0.tgz",
-      "integrity": "sha512-4675NiHzJJs0dLStFpp5G1JNfMYxqFSxZ2iCaiMfHptjlc8McLG9oqcd5pFEiPiqfiV2YG25cJ9EYWIEhUvp+A==",
+      "version": "7.3.1",
+      "resolved": "https://registry.npmjs.org/@fortawesome/free-regular-svg-icons/-/free-regular-svg-icons-7.3.1.tgz",
+      "integrity": "sha512-q1EsmL7Q8DDnkRBUjSvrxbq7c9oVwwVjCn/xa5apKmdp65YSgzUg2y0Ltnd5aDbT6GdAQQdXql5Ha90ArqIReQ==",
       "license": "(CC-BY-4.0 AND MIT)",
       "dependencies": {
-        "@fortawesome/fontawesome-common-types": "7.3.0"
+        "@fortawesome/fontawesome-common-types": "7.3.1"
       },
       "engines": {
         "node": ">=6"
       }
     },
     "node_modules/@fortawesome/free-solid-svg-icons": {
-      "version": "7.3.0",
-      "resolved": "https://registry.npmjs.org/@fortawesome/free-solid-svg-icons/-/free-solid-svg-icons-7.3.0.tgz",
-      "integrity": "sha512-YxI/CuwWeI3nPIoYU//vkDS+3ige/67DPZ6XwMATpYEFESzO9L8zfJOKllGRgIlpT/uebrZCcvAzp3peD7GmTw==",
+      "version": "7.3.1",
+      "resolved": "https://registry.npmjs.org/@fortawesome/free-solid-svg-icons/-/free-solid-svg-icons-7.3.1.tgz",
+      "integrity": "sha512-v0BLa0eqg7ubvVWeNSHVBs8fWH/GJicERZoJaxJ3FE/lj67VSqzoMg9pzfZVOfLMX10y0pGwQAuxoRVVH2patg==",
       "license": "(CC-BY-4.0 AND MIT)",
       "dependencies": {
-        "@fortawesome/fontawesome-common-types": "7.3.0"
+        "@fortawesome/fontawesome-common-types": "7.3.1"
       },
       "engines": {
         "node": ">=6"