blume 0.6.4 → 0.6.5

package/docs/content/navigation.mdx

@@ -60,7 +60,7 @@ navigation: {
 ```
 
 - **`flat`** (default) — a non-collapsible header with its pages listed beneath. Pages that aren't in any group always list first, above the group sections, so they can't be mistaken for a group's children.
-- **`group`** — a collapsible `<details>` disclosure per group. Pair it with `collapsed` in [folder meta](/docs/content/meta) to set the initial state; a group containing the current page always starts open.
+- **`group`** — a collapsible `<details>` disclosure per group. Groups start collapsed by default; a group containing the current page always starts open, so only the section you're in is expanded. Set `collapsed: false` in [folder meta](/docs/content/meta) to force a group open regardless.
 - **`page`** — each group is a single row that, when clicked, slides the sidebar into a sub-panel showing only that group's items, with a back arrow at the top. The panel is route-aware, so landing directly on a page inside the group opens straight to it.
 
 :::tip

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "blume",
-  "version": "0.6.4",
+  "version": "0.6.5",
   "description": "Documentation that's fast, AI-ready, and zero-config.",
   "keywords": [
     "astro",

package/src/components/layout/NavTree.astro

@@ -218,7 +218,9 @@ const initialId =
         // `group`: a collapsible `<details>` disclosure.
         if (display === "group") {
           const active = hasActivePage(item);
-          const open = depth === 0 || active || item.collapsed === false;
+          // Default every group closed; open only those on the active path (so
+          // the current page's ancestors stay expanded) or forced open via meta.
+          const open = active || item.collapsed === false;
           return (
             <li class={spacing}>
               <details class="group" open={open}>

package/src/core/navigation.ts

@@ -184,16 +184,20 @@ const sortNodes = (nodes: MutableNode[]): void => {
 };
 
 /**
- * In flat display a group renders as a plain section header, so a loose page
- * sorted after a group would visually read as that group's last child. Hoist
- * pages above groups at every level (relative order otherwise preserved).
+ * Hoist loose pages above groups so root-level pages read as top-level entries
+ * rather than a group's trailing children (relative order otherwise preserved).
+ * All display modes hoist the root level. Flat additionally recurses into every
+ * group: there a group renders as a plain section header, so a loose page sorted
+ * after a group would visually read as that group's last child.
  */
-const hoistPages = (nodes: MutableNode[]): void => {
+const hoistPages = (nodes: MutableNode[], recurse: boolean): void => {
   const pages = nodes.filter((node) => node.kind === "page");
   const groups = nodes.filter((node) => node.kind === "group");
   nodes.splice(0, nodes.length, ...pages, ...groups);
-  for (const group of groups) {
-    hoistPages(group.children);
+  if (recurse) {
+    for (const group of groups) {
+      hoistPages(group.children, recurse);
+    }
   }
 };
 
@@ -280,9 +284,7 @@ const buildFileSystemSidebar = (
 
   applyFolderMeta(root, folderMeta, sharedMeta, metaPrefix);
   sortNodes(root.children);
-  if (display === "flat") {
-    hoistPages(root.children);
-  }
+  hoistPages(root.children, display === "flat");
   return root.children.map((child) => toNavNode(child, display));
 };