@dloizides/ui-nav 1.6.0 → 1.7.0

package/dist/index.js

@@ -2,10 +2,15 @@
 
 var reactNative = require('react-native');
 var uiFeedback = require('@dloizides/ui-feedback');
-var react = require('react');
+var React5 = require('react');
 var jsxRuntime = require('react/jsx-runtime');
+var uiLayout = require('@dloizides/ui-layout');
 var authWeb = require('@dloizides/auth-web');
 
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var React5__default = /*#__PURE__*/_interopDefault(React5);
+
 // src/Sidebar.tsx
 
 // src/isRouteActive.ts
@@ -14,6 +19,7 @@ function isRouteActive(pathname, route) {
   return pathname === route || pathname.startsWith(`${route}/`);
 }
 var ACTIVE_BORDER_RADIUS = 4;
+var NAV_LINK_GAP = 4;
 var navStyles = reactNative.StyleSheet.create({
   // --- Sidebar ---
   sidebarContainer: {
@@ -76,6 +82,13 @@ var navBarStyles = reactNative.StyleSheet.create({
     rowGap: 4,
     paddingVertical: 8
   },
+  // EXPANDED: the row must NOT wrap — otherwise flexbox drops the right slot onto a 2nd line the
+  // moment brand+links+right overflow, instead of SHRINKING the (scrollable) links. `flex-shrink`
+  // only distributes negative space on a `nowrap` line; with `wrap` it wraps first and never shrinks.
+  // Collapsed keeps `wrap` so the stacked links/right (width:100%) can drop to their own lines.
+  innerNoWrap: {
+    flexWrap: "nowrap"
+  },
   brand: { marginRight: 16, flexShrink: 0 },
   toggle: {
     marginLeft: "auto",
@@ -89,22 +102,26 @@ var navBarStyles = reactNative.StyleSheet.create({
     justifyContent: "center"
   },
   toggleGlyph: { fontSize: 20, fontWeight: "700" },
-  // Expanded links live inside a horizontal ScrollView so the bar stays ONE ROW no matter how many
-  // items an app passes: they never wrap onto a second line — any overflow scrolls instead, with the
-  // brand (left) and right slot pinned. `linksScroll` is the ScrollView's own box (a shrinkable,
-  // growable flex child that may collapse to 0 and scroll); `links` is its non-wrapping content row.
-  linksScroll: {
+  // Expanded links live on ONE ROW that never wraps: it is a shrinkable/growable flex child that
+  // fills the space between the pinned brand (left) and right slot, and CLIPS overflow. A measure
+  // pass (priority+) then keeps only the leading items that fit inline and collapses the rest behind
+  // the "More ▾" overflow trigger — so no item is ever cut off; the surplus moves into a dropdown.
+  // `overflow:'hidden'` only masks the single unmeasured first frame before the fit resolves.
+  linksRow: {
     flexGrow: 1,
     flexShrink: 1,
-    minWidth: 0
-  },
-  links: {
+    minWidth: 0,
     flexDirection: "row",
     alignItems: "center",
     flexWrap: "nowrap",
-    columnGap: 4,
-    rowGap: 4
+    columnGap: NAV_LINK_GAP,
+    overflow: "hidden"
   },
+  // Each inline link + the overflow trigger sit in a natural-width cell that never shrinks, so their
+  // measured widths are their true content widths (what the priority+ fit computation reasons about).
+  linkCell: { flexShrink: 0 },
+  overflowTrigger: { columnGap: 4 },
+  overflowChevron: { fontSize: 12, fontWeight: "700" },
   // Collapsed (below breakpoint): links drop onto their own full-width line,
   // stacked vertically — mirrors the v1 `.gn-links` responsive behaviour.
   linksStacked: {
@@ -202,21 +219,21 @@ var NavExpandableItem = ({
   renderChevron,
   depth = 0
 }) => {
-  const [expanded, setExpanded] = react.useState(false);
-  const [focused, setFocused] = react.useState(false);
+  const [expanded, setExpanded] = React5.useState(false);
+  const [focused, setFocused] = React5.useState(false);
   const { theme } = uiFeedback.useUi();
   const colors = theme.colors;
   const primaryColor = theme.palette.primary["500"];
-  const toggle = react.useCallback(() => setExpanded((v) => !v), []);
+  const toggle = React5.useCallback(() => setExpanded((v) => !v), []);
   const indent = depth * BASE_INDENT;
   const hasChildren = Array.isArray(item.children) && item.children.length > 0;
   const isActive = isRouteActive(pathname, item.route);
-  const activeItemStyle = react.useMemo(
+  const activeItemStyle = React5.useMemo(
     () => ({ backgroundColor: colors.border, borderRadius: ACTIVE_BORDER_RADIUS }),
     [colors.border]
   );
-  const paddingStyle = react.useMemo(() => ({ paddingLeft: indent + BASE_INDENT }), [indent]);
-  const headerPaddingStyle = react.useMemo(() => ({ paddingLeft: indent }), [indent]);
+  const paddingStyle = React5.useMemo(() => ({ paddingLeft: indent + BASE_INDENT }), [indent]);
+  const headerPaddingStyle = React5.useMemo(() => ({ paddingLeft: indent }), [indent]);
   if (!hasChildren)
     return /* @__PURE__ */ jsxRuntime.jsxs(
       reactNative.TouchableOpacity,
@@ -350,7 +367,9 @@ var NAV_TEST_IDS = {
   /** responsive hamburger toggle in the horizontal NavBar (shown below the breakpoint). */
   navBarToggle: "navbar-toggle",
   /** links container in the horizontal NavBar. */
-  navBarLinks: "navbar-links"
+  navBarLinks: "navbar-links",
+  /** the "More ▾" priority+ overflow trigger in the horizontal NavBar (shown when items spill). */
+  navBarOverflow: "navbar-overflow"
 };
 var APP_SHELL_SUFFIX = {
   content: "-content",
@@ -380,7 +399,7 @@ var FocusableTouchable = ({
   testID,
   children
 }) => {
-  const [focused, setFocused] = react.useState(false);
+  const [focused, setFocused] = React5.useState(false);
   return /* @__PURE__ */ jsxRuntime.jsx(
     reactNative.Pressable,
     {
@@ -532,8 +551,8 @@ var NavBarLink = ({
   navigateHint,
   onPress
 }) => {
-  const [hovered, setHovered] = react.useState(false);
-  const [focused, setFocused] = react.useState(false);
+  const [hovered, setHovered] = React5.useState(false);
+  const [focused, setFocused] = React5.useState(false);
   const isHovered = hovered && !isActive;
   const textColor = isActive ? TEXT_ON_PRIMARY2 : isHovered ? colors.hoverText : colors.rest;
   const pillStyle = isActive ? { backgroundColor: colors.activeBg } : isHovered ? { backgroundColor: colors.hoverBg } : void 0;
@@ -565,14 +584,116 @@ var NavBarLink = ({
     }
   );
 };
+var TEXT_ON_PRIMARY3 = "#ffffff";
+var NO_ACTIVE_ROUTE = "";
+var NavOverflowMenu = ({
+  items,
+  pathname,
+  onNavigate,
+  colors,
+  label,
+  hint,
+  testID,
+  variant
+}) => {
+  const options = React5.useMemo(() => items.map((item) => ({ label: item.label, value: item.route })), [items]);
+  const activeRoute = React5.useMemo(
+    () => items.find((item) => isRouteActive(pathname, item.route))?.route ?? NO_ACTIVE_ROUTE,
+    [items, pathname]
+  );
+  const optionTestID = React5.useMemo(() => {
+    const byRoute = new Map(items.map((item) => [item.route, item.testID ?? item.key]));
+    return (route) => byRoute.get(route) ?? `${testID}-option-${route}`;
+  }, [items, testID]);
+  const hasActive = activeRoute !== NO_ACTIVE_ROUTE;
+  const textColor = hasActive ? TEXT_ON_PRIMARY3 : colors.rest;
+  const pillStyle = hasActive ? { backgroundColor: colors.activeBg } : void 0;
+  return /* @__PURE__ */ jsxRuntime.jsx(
+    uiLayout.ModalDropdown,
+    {
+      accessibilityHint: hint,
+      accessibilityLabel: label,
+      optionTestID,
+      options,
+      testID,
+      value: activeRoute,
+      variant,
+      onChange: onNavigate,
+      renderTrigger: ({ isOpen }) => /* @__PURE__ */ jsxRuntime.jsxs(reactNative.View, { style: [navBarStyles.link, navBarStyles.overflowTrigger, pillStyle], children: [
+        /* @__PURE__ */ jsxRuntime.jsx(reactNative.Text, { style: [navBarStyles.linkText, { color: textColor }], children: label }),
+        /* @__PURE__ */ jsxRuntime.jsx(reactNative.Text, { style: [navBarStyles.overflowChevron, { color: textColor }], children: isOpen ? "\u25B4" : "\u25BE" })
+      ] })
+    }
+  );
+};
+
+// src/computeVisibleCount.ts
+function sum(values) {
+  return values.reduce((acc, value) => acc + value, 0);
+}
+function computeVisibleCount({ availableWidth, itemWidths, moreWidth, gap }) {
+  const total = itemWidths.length;
+  if (total === 0) return 0;
+  if (availableWidth <= 0 || itemWidths.some((width) => width <= 0)) return total;
+  const fullRowWidth = sum(itemWidths) + gap * (total - 1);
+  if (fullRowWidth <= availableWidth) return total;
+  const reservedForMore = moreWidth + gap;
+  let used = 0;
+  let count = 0;
+  for (let index = 0; index < total; index += 1) {
+    const width = itemWidths[index] ?? 0;
+    const withGap = used + (count > 0 ? gap : 0) + width;
+    if (withGap + reservedForMore > availableWidth) break;
+    used = withGap;
+    count += 1;
+  }
+  return count;
+}
+
+// src/useNavOverflow.ts
+function resizeWidthBuffer(previous, count) {
+  const next = new Array(count).fill(0);
+  const shared = Math.min(previous.length, count);
+  for (let index = 0; index < shared; index += 1) next[index] = previous[index] ?? 0;
+  return next;
+}
+function useNavOverflow(itemCount, gap) {
+  const [availableWidth, setAvailableWidthState] = React5.useState(0);
+  const [moreWidth, setMoreWidthState] = React5.useState(0);
+  const [itemWidths, setItemWidths] = React5.useState(() => new Array(itemCount).fill(0));
+  React5.useEffect(() => {
+    setItemWidths((previous) => previous.length === itemCount ? previous : resizeWidthBuffer(previous, itemCount));
+  }, [itemCount]);
+  const setItemWidth = React5.useCallback((index, width) => {
+    setItemWidths((previous) => {
+      if (index < 0 || index >= previous.length || previous[index] === width) return previous;
+      const next = previous.slice();
+      next[index] = width;
+      return next;
+    });
+  }, []);
+  const setAvailableWidth = React5.useCallback(
+    (width) => setAvailableWidthState((previous) => previous === width ? previous : width),
+    []
+  );
+  const setMoreWidth = React5.useCallback(
+    (width) => setMoreWidthState((previous) => previous === width ? previous : width),
+    []
+  );
+  const visibleCount = React5.useMemo(
+    () => computeVisibleCount({ availableWidth, itemWidths, moreWidth, gap }),
+    [availableWidth, itemWidths, moreWidth, gap]
+  );
+  return { visibleCount, setAvailableWidth, setItemWidth, setMoreWidth };
+}
 var REDUCED_MOTION_QUERY = "(prefers-reduced-motion: reduce)";
 function getReducedMotionQuery() {
   if (typeof window === "undefined" || typeof window.matchMedia !== "function") return void 0;
   return window.matchMedia(REDUCED_MOTION_QUERY);
 }
 function useReducedMotion() {
-  const [reduced, setReduced] = react.useState(() => getReducedMotionQuery()?.matches ?? false);
-  react.useEffect(() => {
+  const [reduced, setReduced] = React5.useState(() => getReducedMotionQuery()?.matches ?? false);
+  React5.useEffect(() => {
     const mql = getReducedMotionQuery();
     if (mql === void 0 || mql.addEventListener === void 0) return void 0;
     const onChange = () => setReduced(mql.matches);
@@ -601,6 +722,8 @@ var NavBar = ({
   menuHint = "",
   renderMenuIcon,
   collapseBelow = DEFAULT_COLLAPSE_BELOW,
+  overflowLabel = "More",
+  overflowHint = "",
   containerStyle
 }) => {
   const { theme } = uiFeedback.useUi();
@@ -608,19 +731,20 @@ var NavBar = ({
   const primaryColor = theme.palette.primary["500"];
   const { width } = reactNative.useWindowDimensions();
   const reducedMotion = useReducedMotion();
-  const [open, setOpen] = react.useState(false);
-  const [toggleFocused, setToggleFocused] = react.useState(false);
+  const [open, setOpen] = React5.useState(false);
+  const [toggleFocused, setToggleFocused] = React5.useState(false);
+  const { visibleCount, setAvailableWidth, setItemWidth, setMoreWidth } = useNavOverflow(items.length, NAV_LINK_GAP);
   const collapsed = width < collapseBelow;
   const showLinks = !collapsed || open;
-  const toggleMenu = react.useCallback(() => setOpen((v) => !v), []);
-  const handlePress = react.useCallback(
+  const toggleMenu = React5.useCallback(() => setOpen((v) => !v), []);
+  const handlePress = React5.useCallback(
     (route) => {
       setOpen(false);
       onNavigate(route);
     },
     [onNavigate]
   );
-  const linkColors = react.useMemo(
+  const linkColors = React5.useMemo(
     () => ({
       rest: colors.textSecondary,
       hoverText: colors.text,
@@ -641,7 +765,7 @@ var NavBar = ({
         { backgroundColor: colors.surface, borderBottomColor: colors.border },
         containerStyle
       ],
-      children: /* @__PURE__ */ jsxRuntime.jsxs(reactNative.View, { style: navBarStyles.inner, children: [
+      children: /* @__PURE__ */ jsxRuntime.jsxs(reactNative.View, { style: [navBarStyles.inner, collapsed ? null : navBarStyles.innerNoWrap], children: [
         brand !== void 0 ? /* @__PURE__ */ jsxRuntime.jsx(reactNative.View, { style: navBarStyles.brand, children: brand }) : null,
         collapsed ? /* @__PURE__ */ jsxRuntime.jsx(
           reactNative.Pressable,
@@ -661,7 +785,7 @@ var NavBar = ({
           }
         ) : null,
         showLinks ? (() => {
-          const links = items.map((item) => /* @__PURE__ */ jsxRuntime.jsx(
+          const renderLink = (item) => /* @__PURE__ */ jsxRuntime.jsx(
             NavBarLink,
             {
               collapsed,
@@ -672,19 +796,50 @@ var NavBar = ({
               navigateHint,
               reducedMotion,
               onPress: handlePress
-            },
-            item.key
-          ));
-          return collapsed ? /* @__PURE__ */ jsxRuntime.jsx(reactNative.View, { nativeID: LINKS_REGION_ID, style: navBarStyles.linksStacked, testID: NAV_TEST_IDS.navBarLinks, children: links }) : /* @__PURE__ */ jsxRuntime.jsx(
-            reactNative.ScrollView,
+            }
+          );
+          if (collapsed) {
+            return /* @__PURE__ */ jsxRuntime.jsx(reactNative.View, { nativeID: LINKS_REGION_ID, style: navBarStyles.linksStacked, testID: NAV_TEST_IDS.navBarLinks, children: items.map((item) => /* @__PURE__ */ jsxRuntime.jsx(React5__default.default.Fragment, { children: renderLink(item) }, item.key)) });
+          }
+          const visibleItems = items.slice(0, visibleCount);
+          const overflowItems = items.slice(visibleCount);
+          return /* @__PURE__ */ jsxRuntime.jsxs(
+            reactNative.View,
             {
-              horizontal: true,
-              showsHorizontalScrollIndicator: false,
               nativeID: LINKS_REGION_ID,
-              style: navBarStyles.linksScroll,
-              contentContainerStyle: navBarStyles.links,
+              style: navBarStyles.linksRow,
               testID: NAV_TEST_IDS.navBarLinks,
-              children: links
+              onLayout: (event) => setAvailableWidth(event.nativeEvent.layout.width),
+              children: [
+                visibleItems.map((item, index) => /* @__PURE__ */ jsxRuntime.jsx(
+                  reactNative.View,
+                  {
+                    style: navBarStyles.linkCell,
+                    onLayout: (event) => setItemWidth(index, event.nativeEvent.layout.width),
+                    children: renderLink(item)
+                  },
+                  item.key
+                )),
+                overflowItems.length > 0 ? /* @__PURE__ */ jsxRuntime.jsx(
+                  reactNative.View,
+                  {
+                    style: navBarStyles.linkCell,
+                    onLayout: (event) => setMoreWidth(event.nativeEvent.layout.width),
+                    children: /* @__PURE__ */ jsxRuntime.jsx(
+                      NavOverflowMenu,
+                      {
+                        colors: linkColors,
+                        hint: overflowHint,
+                        items: overflowItems,
+                        label: overflowLabel,
+                        pathname,
+                        testID: NAV_TEST_IDS.navBarOverflow,
+                        onNavigate: handlePress
+                      }
+                    )
+                  }
+                ) : null
+              ]
             }
           );
         })() : null,
@@ -693,6 +848,12 @@ var NavBar = ({
     }
   );
 };
+var Nav = (props) => {
+  if (props.orientation === "vertical") {
+    return /* @__PURE__ */ jsxRuntime.jsx(Sidebar, { ...props });
+  }
+  return /* @__PURE__ */ jsxRuntime.jsx(NavBar, { ...props });
+};
 var MOBILE_BREAKPOINT = 768;
 var SCRIM_COLOR = "rgba(0, 0, 0, 0.5)";
 var MENU_GLYPH2 = "\u2630";
@@ -742,8 +903,8 @@ var MobileDrawer = ({
   drawerTestID,
   scrimTestID
 }) => {
-  const panelRef = react.useRef(null);
-  react.useEffect(() => {
+  const panelRef = React5.useRef(null);
+  React5.useEffect(() => {
     const node = panelRef.current;
     if (node === null || typeof node.addEventListener !== "function") return void 0;
     const handleClick = (event) => {
@@ -861,15 +1022,15 @@ var AppShell = ({
   const { width: viewportWidth } = reactNative.useWindowDimensions();
   const isNarrow = viewportWidth < MOBILE_BREAKPOINT;
   const useDrawer = sidebar !== void 0 && isNarrow;
-  const [drawerOpen, setDrawerOpen] = react.useState(false);
-  const openDrawer = react.useCallback(() => setDrawerOpen(true), []);
-  const closeDrawer = react.useCallback(() => setDrawerOpen(false), []);
-  react.useEffect(() => {
+  const [drawerOpen, setDrawerOpen] = React5.useState(false);
+  const openDrawer = React5.useCallback(() => setDrawerOpen(true), []);
+  const closeDrawer = React5.useCallback(() => setDrawerOpen(false), []);
+  React5.useEffect(() => {
     if (!isNarrow && drawerOpen) setDrawerOpen(false);
   }, [isNarrow, drawerOpen]);
   const drawerLabels = { ...DEFAULT_DRAWER_LABELS, ...mobileMenu };
   const isUnauthenticated = gate !== void 0 && !gate.pending && !gate.authenticated;
-  react.useEffect(() => {
+  React5.useEffect(() => {
     if (isUnauthenticated && gate !== void 0) gate.onRedirect();
   }, [isUnauthenticated, gate]);
   if (gate?.pending === true)
@@ -936,9 +1097,12 @@ exports.AppShell = AppShell;
 exports.BASE_INDENT = BASE_INDENT;
 exports.CHEVRON_ICON_SIZE = CHEVRON_ICON_SIZE;
 exports.NAV_ICON_SIZE = NAV_ICON_SIZE;
+exports.NAV_LINK_GAP = NAV_LINK_GAP;
 exports.NAV_TEST_IDS = NAV_TEST_IDS;
+exports.Nav = Nav;
 exports.NavBar = NavBar;
 exports.NavExpandableItem = NavExpandableItem;
+exports.NavOverflowMenu = NavOverflowMenu;
 exports.Sidebar = Sidebar;
 exports.Topbar = Topbar;
 exports.accessibleNavItems = accessibleNavItems;