@patternfly/documentation-framework 6.26.3 → 6.27.0

package/CHANGELOG.md

@@ -3,6 +3,25 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# 6.27.0 (2025-10-09)
+
+
+### Features
+
+* **sideNav:** Adds support for grouped nav with headers and dividers. ([#4754](https://github.com/patternfly/patternfly-org/issues/4754)) ([91f9227](https://github.com/patternfly/patternfly-org/commit/91f92276400dc255f931c7df6c75963adf2c54bc))
+
+
+
+
+
+## 6.26.4 (2025-10-09)
+
+**Note:** Version bump only for package @patternfly/documentation-framework
+
+
+
+
+
 ## 6.26.3 (2025-10-09)
 
 **Note:** Version bump only for package @patternfly/documentation-framework

package/components/sideNav/sideNav.js

@@ -4,14 +4,21 @@ import {
   Label,
   Nav,
   NavList,
+  NavGroup,
   NavExpandable,
   PageContextConsumer,
   capitalize,
   Flex,
-  FlexItem
+  FlexItem,
+  Divider
 } from '@patternfly/react-core';
 import { css } from '@patternfly/react-styles';
 import { Location } from '@reach/router';
+
+const DIVIDER_STYLES = {
+  marginTop: 'var(--pf-t--global--spacer--md)',
+  marginBottom: 'var(--pf-t--global--spacer--md)'
+};
 import { makeSlug } from '../../helpers';
 import globalBreakpointXl from '@patternfly/react-tokens/dist/esm/t_global_breakpoint_xl';
 import { trackEvent } from '../../helpers';
@@ -163,20 +170,45 @@ export const SideNav = ({ groupedRoutes = {}, navItems = [] }) => {
     }
   }, []);
 
+  const groupedItems = React.useMemo(() => 
+    (navItems || []).filter(entry => entry && entry.title), [navItems]);
+  const ungroupedItems = React.useMemo(() => 
+    (navItems || []).filter(entry => entry && !entry.title), [navItems]);
+
+  const renderNavItem = React.useCallback((item) => {
+    if (!item) return null;
+    
+    return item.section ? (
+      <Location key={item.section}>
+        {({ location }) => ExpandableNav({ groupedRoutes, location, section: item.section })}
+      </Location>
+    ) : NavItem({
+      key: item.href || `nav-item-${Math.random()}`,
+      text: item.text || (item.href ? capitalize(item.href.replace(/\//g, '').replace(/-/g, ' ')) : 'Untitled'),
+      href: item.href
+    });
+  }, [groupedRoutes]);
+
   return (
     <Nav aria-label="Side Nav" theme="light">
-      <NavList className="ws-side-nav-list">
-        {navItems.map(({ section, text, href }) =>
-          section ? (
-            <Location key={section}>{({ location }) => ExpandableNav({ groupedRoutes, location, section })}</Location>
-          ) : (
-            NavItem({
-              text: text || capitalize(href.replace(/\//g, '').replace(/-/g, ' ')),
-              href: href
-            })
-          )
-        )}
-      </NavList>
+      {/* Render grouped items */}
+      {groupedItems.map((group) => (
+        <React.Fragment key={group.title}>
+          <NavGroup title={group.title}>
+            <NavList className="ws-side-nav-list" aria-label={`${group.title} navigation`}>
+              {group.items.map(renderNavItem)}
+            </NavList>
+          </NavGroup>
+          {group.hasDivider && <Divider style={DIVIDER_STYLES} />}
+        </React.Fragment>
+      ))}
+      
+      {/* Render ungrouped items - this handles the current flat structure */}
+      {ungroupedItems.length > 0 && (
+        <NavList className="ws-side-nav-list">
+          {ungroupedItems.map(renderNavItem)}
+        </NavList>
+      )}
     </Nav>
   );
-};
+};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@patternfly/documentation-framework",
   "description": "A framework to build documentation for PatternFly.",
-  "version": "6.26.3",
+  "version": "6.27.0",
   "author": "Red Hat",
   "license": "MIT",
   "bin": {
@@ -12,7 +12,7 @@
     "@babel/preset-env": "7.27.1",
     "@babel/preset-react": "^7.24.1",
     "@mdx-js/util": "1.6.16",
-    "@patternfly/ast-helpers": "^1.4.0-alpha.288",
+    "@patternfly/ast-helpers": "^1.4.0-alpha.290",
     "@reach/router": "npm:@gatsbyjs/reach-router@1.3.9",
     "autoprefixer": "10.4.19",
     "babel-loader": "^9.1.3",
@@ -95,5 +95,5 @@
     "http-cache-semantics": ">=4.1.1",
     "nanoid": "3.3.8"
   },
-  "gitHead": "e82225dc040a0e72d930004a05587785ce5227a4"
+  "gitHead": "777009a54b36e38d563933c2f39b5f34384abd86"
 }