@dloizides/ui-nav 1.13.1 → 1.15.0

package/CHANGELOG.md

@@ -1,5 +1,30 @@
 # Changelog
 
+## 1.14.0
+
+- **Feature (an expandable nav group now ANIMATES its expand/collapse instead of snapping).**
+  `NavExpandableItem` used to conditionally render its children (`{expanded ? … : null}`),
+  so a sidebar/drawer group's leaves appeared and vanished INSTANTLY on toggle — a hard,
+  jarring cut with no transition. The group's children are now wrapped in the
+  `@dloizides/ui-motion` `<Collapse open={expanded}>`, which measures the children's natural
+  height and animates a real `Animated.Value` height on WEB and native alike (the height code
+  path RN's native-only `LayoutAnimation` never gave the web build), collapsing to instant
+  under `prefers-reduced-motion`.
+  - **Collapsed leaves stay non-interactive.** Per the `Collapse` contract the children remain
+    MOUNTED at all times (their state and a11y focus order are preserved); when collapsed they
+    are clipped to zero height under `overflow: hidden`, so a collapsed group's leaves are
+    neither visible nor tappable in a real browser even though they are in the tree. This is a
+    deliberate change from the prior "absent from the DOM when collapsed" behaviour.
+  - **`aria-expanded` and the mobile-drawer contract are intact.** The group header still emits
+    `aria-expanded` (the `ariaExpandedProps` spread is unchanged), so `MobileDrawer` still tells
+    a group TOGGLE apart from a navigating LEAF and does not dismiss the drawer when a group is
+    expanded on mobile. The active-leaf accent bar, docs-style section-header styling, chevron
+    slot, testIDs, and all a11y roles/labels/hints are unchanged.
+  - **No public API change.** `NavExpandableItemProps` / `NavItem` are untouched — the animation
+    is derived from the `expanded` state the component already tracked. `@dloizides/ui-motion`
+    (`^1.0.1`) is added as a runtime dependency; all 7 portals gain the animated group on their
+    next bump for free. Consumers with no expandable groups are visually unaffected.
+
 ## 1.13.1
 
 - **Fix (mobile drawer: a sub-item / leaf tap dismissed the drawer WITHOUT navigating).**

package/dist/index.js

@@ -3,6 +3,7 @@
 var reactNative = require('react-native');
 var uiFeedback = require('@dloizides/ui-feedback');
 var React2 = require('react');
+var uiMotion = require('@dloizides/ui-motion');
 var jsxRuntime = require('react/jsx-runtime');
 var uiLayout = require('@dloizides/ui-layout');
 var authWeb = require('@dloizides/auth-web');
@@ -413,7 +414,7 @@ var NavExpandableItem = ({
         ]
       }
     ),
-    expanded ? /* @__PURE__ */ jsxRuntime.jsx(reactNative.View, { style: expandableStyles.childrenContainer, children: item.children?.map((child) => /* @__PURE__ */ jsxRuntime.jsx(
+    /* @__PURE__ */ jsxRuntime.jsx(uiMotion.Collapse, { open: expanded, children: /* @__PURE__ */ jsxRuntime.jsx(reactNative.View, { style: expandableStyles.childrenContainer, children: item.children?.map((child) => /* @__PURE__ */ jsxRuntime.jsx(
       NavExpandableItem,
       {
         collapseHint,
@@ -426,7 +427,7 @@ var NavExpandableItem = ({
         onNavigate
       },
       child.key
-    )) }) : null
+    )) }) })
   ] });
 };
 function isBareText(node) {