@bensdev/react-sidebar 0.2.0 → 0.3.0

package/dist/index.d.ts

@@ -46,7 +46,12 @@ interface SidebarActionItem extends SidebarItemBase {
 interface SidebarGroupItem extends SidebarItemBase {
     type: 'group';
     items: SidebarItem[];
-    /** `false` renders a static section: label as heading, children always visible. */
+    /**
+     * `false` renders a static section: label as heading, children always visible — including on
+     * the collapsed icon rail, where it overrides `collapsedGroupBehavior` entirely (no flyout, no
+     * hiding). Give the group an `icon` to also get a row for it on the rail; without one, only its
+     * (icon-bearing) children render there.
+     */
     collapsible?: boolean;
     defaultOpen?: boolean;
     open?: boolean;
@@ -176,6 +181,12 @@ interface SidebarProps {
     onOpenGroupsChange?: (ids: string[]) => void;
     accordion?: boolean;
     autoOpenActiveGroup?: boolean;
+    /**
+     * How a *collapsible* group presents once the sidebar collapses to its icon rail: a
+     * hover/focus flyout (default), inline-and-indented (`"expand"`), or trigger-only with
+     * children unreachable (`"ignore"`). Has no effect on `collapsible: false` groups — those
+     * always stay fully expanded, on the rail or off.
+     */
     collapsedGroupBehavior?: 'flyout' | 'expand' | 'ignore';
     mobileOpen?: boolean;
     onMobileClose?: () => void;

package/dist/index.js

@@ -500,10 +500,17 @@ function SidebarGroupRow({ item, depth }) {
             children: /* @__PURE__ */ jsx(ChevronDownIcon, { size: 14 })
           }
         ),
-        showTooltip && behavior !== "flyout" && /* @__PURE__ */ jsx(Tooltip, { id: tooltipId, className: ctx.classNames.tooltip, children: item.tooltip ?? item.label })
+        showTooltip && (!collapsible || behavior !== "flyout") && /* @__PURE__ */ jsx(Tooltip, { id: tooltipId, className: ctx.classNames.tooltip, children: item.tooltip ?? item.label })
       ]
     }
   );
+  if (!collapsible) {
+    const showTrigger = item.icon != null || !isRail;
+    return /* @__PURE__ */ jsxs("li", { className: cx("bsb-list-item", "bsb-group"), children: [
+      showTrigger && trigger,
+      /* @__PURE__ */ jsx("ul", { id: panelId, className: cx("bsb-group__panel", ctx.classNames.groupPanel), children: /* @__PURE__ */ jsx(SidebarNodeList, { items: item.items, depth: depth + 1 }) })
+    ] });
+  }
   if (isRail && behavior === "flyout") {
     return /* @__PURE__ */ jsxs("li", { className: cx("bsb-list-item", "bsb-group", "bsb-group--flyout"), children: [
       trigger,
@@ -526,7 +533,7 @@ function SidebarGroupRow({ item, depth }) {
   }
   return /* @__PURE__ */ jsxs("li", { className: cx("bsb-list-item", "bsb-group"), children: [
     trigger,
-    (isOpen || !collapsible) && /* @__PURE__ */ jsx("ul", { id: panelId, className: cx("bsb-group__panel", ctx.classNames.groupPanel), children: /* @__PURE__ */ jsx(SidebarNodeList, { items: item.items, depth: depth + 1 }) })
+    isOpen && /* @__PURE__ */ jsx("ul", { id: panelId, className: cx("bsb-group__panel", ctx.classNames.groupPanel), children: /* @__PURE__ */ jsx(SidebarNodeList, { items: item.items, depth: depth + 1 }) })
   ] });
 }
 function SidebarNode({ item, depth }) {
@@ -830,7 +837,10 @@ function MobileDrawer({
   closeLabel,
   classNames,
   durationMs = 400,
-  children
+  children,
+  rootClassName,
+  rootStyle,
+  rootDataAttrs
 }) {
   const { mounted, state, onPanelTransitionEnd } = useMountTransition(open, durationMs);
   const panelRef = React21.useRef(null);
@@ -842,7 +852,7 @@ function MobileDrawer({
   useBodyScrollLock(lockScroll && open);
   if (!mounted) return null;
   const widthValue = typeof width === "number" ? `${width}px` : width;
-  return /* @__PURE__ */ jsxs(Portal, { target: portalTarget, disabled: disablePortal, children: [
+  return /* @__PURE__ */ jsx(Portal, { target: portalTarget, disabled: disablePortal, children: /* @__PURE__ */ jsxs("div", { className: cx(rootClassName, "bsb-root--drawer-host"), style: rootStyle, ...rootDataAttrs, children: [
     /* @__PURE__ */ jsx(
       "div",
       {
@@ -881,7 +891,7 @@ function MobileDrawer({
         ]
       }
     )
-  ] });
+  ] }) });
 }
 function widthToCss(value) {
   if (value == null) return void 0;
@@ -1125,35 +1135,32 @@ var Sidebar = React21.forwardRef(function Sidebar2(props, ref) {
         )
       }
     ),
-    isMobile && /* @__PURE__ */ jsx(
-      "div",
-      {
-        ref: rootRef,
-        className: rootClassName,
-        style: mergedStyle,
-        ...rootDataAttrs,
-        children: /* @__PURE__ */ jsx(
-          MobileDrawer,
-          {
-            open: mobileOpen,
-            onClose: closeMobile,
-            ariaLabel,
-            width: drawerWidth,
-            position,
-            closeOnEscape,
-            closeOnBackdropClick,
-            trapFocus,
-            lockScroll,
-            restoreFocus,
-            portalTarget,
-            disablePortal,
-            closeLabel: "Close navigation",
-            classNames,
-            children: /* @__PURE__ */ jsx(SidebarShell, { ...shellProps, collapsed: false, showToggle: false, onToggle: toggleCollapsed, togglePosition: position, toggleStrategy, toggleLabels: { expand: "Expand sidebar", collapse: "Collapse sidebar" } })
-          }
-        )
-      }
-    )
+    isMobile && /* @__PURE__ */ jsxs(Fragment, { children: [
+      /* @__PURE__ */ jsx("span", { ref: rootRef, "aria-hidden": "true", style: { display: "none" } }),
+      /* @__PURE__ */ jsx(
+        MobileDrawer,
+        {
+          open: mobileOpen,
+          onClose: closeMobile,
+          ariaLabel,
+          width: drawerWidth,
+          position,
+          closeOnEscape,
+          closeOnBackdropClick,
+          trapFocus,
+          lockScroll,
+          restoreFocus,
+          portalTarget,
+          disablePortal,
+          closeLabel: "Close navigation",
+          classNames,
+          rootClassName,
+          rootStyle: mergedStyle,
+          rootDataAttrs,
+          children: /* @__PURE__ */ jsx(SidebarShell, { ...shellProps, collapsed: false, showToggle: false, onToggle: toggleCollapsed, togglePosition: position, toggleStrategy, toggleLabels: { expand: "Expand sidebar", collapse: "Collapse sidebar" } })
+        }
+      )
+    ] })
   ] });
 });
 Sidebar.displayName = "Sidebar";