@dloizides/ui-nav 1.7.0 → 1.9.0

package/dist/index.mjs

@@ -1,5 +1,5 @@
-import { StyleSheet, Platform, TouchableOpacity, View, Text, useWindowDimensions, Pressable, ActivityIndicator, ScrollView } from 'react-native';
-import { useUi } from '@dloizides/ui-feedback';
+import { StyleSheet, Platform, TouchableOpacity, View, Text, useWindowDimensions, ActivityIndicator, ScrollView, Pressable } from 'react-native';
+import { useUi, UiProvider } from '@dloizides/ui-feedback';
 import React5, { useState, useCallback, useMemo, useEffect, useRef } from 'react';
 import { jsxs, jsx } from 'react/jsx-runtime';
 import { ModalDropdown } from '@dloizides/ui-layout';
@@ -155,6 +155,86 @@ var navBarStyles = StyleSheet.create({
     columnGap: 8
   }
 });
+var pillNavStyles = StyleSheet.create({
+  // Cross-nav pill row (kefi coral dashboard switcher): fully-rounded pills, wraps.
+  container: {
+    flexDirection: "row",
+    flexWrap: "wrap",
+    alignItems: "center",
+    columnGap: 8,
+    rowGap: 8,
+    paddingVertical: 8
+  },
+  pill: {
+    paddingHorizontal: 16,
+    paddingVertical: 8,
+    borderRadius: 999,
+    minHeight: 36,
+    flexDirection: "row",
+    alignItems: "center",
+    columnGap: 6,
+    justifyContent: "center"
+  },
+  pillText: { fontSize: 14, fontWeight: "600" }
+});
+var darkModeStyles = StyleSheet.create({
+  // Segmented Light / Dark / System control.
+  segmentRow: {
+    flexDirection: "row",
+    alignItems: "center",
+    borderWidth: 1,
+    borderRadius: 8,
+    overflow: "hidden",
+    alignSelf: "flex-start"
+  },
+  segment: {
+    paddingHorizontal: 12,
+    paddingVertical: 8,
+    minHeight: 36,
+    flexDirection: "row",
+    alignItems: "center",
+    columnGap: 6,
+    justifyContent: "center"
+  },
+  segmentText: { fontSize: 13, fontWeight: "600" },
+  // Cycle-button variant.
+  cycle: {
+    paddingHorizontal: 12,
+    paddingVertical: 8,
+    minHeight: 44,
+    minWidth: 44,
+    borderRadius: 8,
+    flexDirection: "row",
+    alignItems: "center",
+    columnGap: 6,
+    justifyContent: "center"
+  },
+  cycleText: { fontSize: 13, fontWeight: "600" }
+});
+var collapsedRailStyles = StyleSheet.create({
+  // Intermediate (tablet) icon-only rail: a narrow vertical strip of icon buttons.
+  container: {
+    width: 64,
+    paddingTop: 16,
+    paddingHorizontal: 8,
+    borderRightWidth: 1,
+    height: "100%",
+    alignItems: "center"
+  },
+  // Each item is a ≥44×44 centred touch target with a rounded active/hover pill.
+  item: {
+    width: 48,
+    height: 48,
+    marginVertical: 4,
+    borderRadius: 8,
+    alignItems: "center",
+    justifyContent: "center"
+  },
+  // Glyph fallback (the label's first character) when an item has no renderIcon.
+  glyph: { fontSize: 18, fontWeight: "700" },
+  spacer: { flex: 1 },
+  slot: { alignItems: "center" }
+});
 var expandableStyles = StyleSheet.create({
   childItem: {
     borderRadius: 4,
@@ -371,6 +451,8 @@ var APP_SHELL_SUFFIX = {
   nav: "-nav",
   /** The persistent left rail of the back-office layout (only when `sidebar` is supplied). */
   sidebar: "-sidebar",
+  /** The intermediate persistent COLLAPSED (icon-only) rail (3-tier layout, tablet band). */
+  collapsedSidebar: "-collapsed-sidebar",
   /** Mobile hamburger that opens the nav drawer (back-office layout, below the breakpoint). */
   menuToggle: "-menu-toggle",
   /** The mobile nav drawer panel (holds the `sidebar` slot when opened on a narrow viewport). */
@@ -704,7 +786,7 @@ var MENU_GLYPH = "\u2630";
 function ariaControlsProps(id) {
   return { "aria-controls": id };
 }
-var NavBar = ({
+var NavBarInner = ({
   items,
   pathname,
   onNavigate,
@@ -718,7 +800,8 @@ var NavBar = ({
   collapseBelow = DEFAULT_COLLAPSE_BELOW,
   overflowLabel = "More",
   overflowHint = "",
-  containerStyle
+  containerStyle,
+  contentMaxWidth
 }) => {
   const { theme } = useUi();
   const colors = theme.colors;
@@ -730,6 +813,10 @@ var NavBar = ({
   const { visibleCount, setAvailableWidth, setItemWidth, setMoreWidth } = useNavOverflow(items.length, NAV_LINK_GAP);
   const collapsed = width < collapseBelow;
   const showLinks = !collapsed || open;
+  const innerCapStyle = useMemo(
+    () => contentMaxWidth === void 0 ? null : { maxWidth: contentMaxWidth, width: "100%", alignSelf: "center" },
+    [contentMaxWidth]
+  );
   const toggleMenu = useCallback(() => setOpen((v) => !v), []);
   const handlePress = useCallback(
     (route) => {
@@ -759,7 +846,7 @@ var NavBar = ({
         { backgroundColor: colors.surface, borderBottomColor: colors.border },
         containerStyle
       ],
-      children: /* @__PURE__ */ jsxs(View, { style: [navBarStyles.inner, collapsed ? null : navBarStyles.innerNoWrap], children: [
+      children: /* @__PURE__ */ jsxs(View, { style: [navBarStyles.inner, collapsed ? null : navBarStyles.innerNoWrap, innerCapStyle], children: [
         brand !== void 0 ? /* @__PURE__ */ jsx(View, { style: navBarStyles.brand, children: brand }) : null,
         collapsed ? /* @__PURE__ */ jsx(
           Pressable,
@@ -842,13 +929,57 @@ var NavBar = ({
     }
   );
 };
+var NavBar = ({ barTheme, ...props }) => {
+  const { t, navigate } = useUi();
+  if (barTheme === void 0) return /* @__PURE__ */ jsx(NavBarInner, { ...props });
+  return /* @__PURE__ */ jsx(UiProvider, { navigate, t, theme: barTheme, children: /* @__PURE__ */ jsx(NavBarInner, { ...props }) });
+};
 var Nav = (props) => {
   if (props.orientation === "vertical") {
     return /* @__PURE__ */ jsx(Sidebar, { ...props });
   }
   return /* @__PURE__ */ jsx(NavBar, { ...props });
 };
-var MOBILE_BREAKPOINT = 768;
+var CARD_PADDING = 20;
+var CARD_BORDER_RADIUS = 12;
+var CARD_BORDER_WIDTH = 1;
+var CARD_TITLE_FONT_SIZE = 16;
+var CARD_MESSAGE_FONT_SIZE = 14;
+var CARD_TITLE_MARGIN_BOTTOM = 8;
+var styles = StyleSheet.create({
+  centerFill: { flex: 1, justifyContent: "center", alignItems: "center" },
+  card: {
+    padding: CARD_PADDING,
+    borderRadius: CARD_BORDER_RADIUS,
+    borderWidth: CARD_BORDER_WIDTH
+  },
+  cardTitle: { fontSize: CARD_TITLE_FONT_SIZE, fontWeight: "700", marginBottom: CARD_TITLE_MARGIN_BOTTOM },
+  cardMessage: { fontSize: CARD_MESSAGE_FONT_SIZE }
+});
+function MessageCard({
+  message,
+  accentColor,
+  testID
+}) {
+  const { theme } = useUi();
+  const colors = theme.colors;
+  return /* @__PURE__ */ jsxs(View, { style: [styles.card, { backgroundColor: colors.surface, borderColor: accentColor }], testID, children: [
+    /* @__PURE__ */ jsx(Text, { style: [styles.cardTitle, { color: accentColor }], children: message.titleText }),
+    /* @__PURE__ */ jsx(Text, { style: [styles.cardMessage, { color: colors.textSecondary }], children: message.messageText })
+  ] });
+}
+function useContentBody(state, children, testID) {
+  const { theme } = useUi();
+  const primary = theme.palette.primary["500"];
+  const errorColor = theme.semantic.error["500"];
+  if (state?.forbidden)
+    return /* @__PURE__ */ jsx(MessageCard, { accentColor: errorColor, message: state.forbidden, testID: `${testID}${APP_SHELL_SUFFIX.forbidden}` });
+  if (state?.error)
+    return /* @__PURE__ */ jsx(MessageCard, { accentColor: errorColor, message: state.error, testID: `${testID}${APP_SHELL_SUFFIX.error}` });
+  if (state?.loading === true)
+    return /* @__PURE__ */ jsx(View, { style: styles.centerFill, testID: `${testID}${APP_SHELL_SUFFIX.loading}`, children: /* @__PURE__ */ jsx(ActivityIndicator, { color: primary, size: "large" }) });
+  return children;
+}
 var SCRIM_COLOR = "rgba(0, 0, 0, 0.5)";
 var MENU_GLYPH2 = "\u2630";
 var MENU_MIN_TARGET = 44;
@@ -862,7 +993,7 @@ var DEFAULT_DRAWER_LABELS = {
   closeLabel: "Close menu",
   closeHint: "Close the navigation menu"
 };
-var styles = StyleSheet.create({
+var styles2 = StyleSheet.create({
   overlay: { ...StyleSheet.absoluteFillObject, zIndex: DRAWER_Z_INDEX },
   scrim: { ...StyleSheet.absoluteFillObject, backgroundColor: SCRIM_COLOR },
   panel: { position: "absolute", top: 0, bottom: 0, left: 0 },
@@ -883,10 +1014,10 @@ var MenuToggle = ({ label, hint, onOpen, testID }) => {
       accessibilityHint: hint,
       accessibilityLabel: label,
       ringColor: theme.palette.primary["500"],
-      style: styles.menuToggle,
+      style: styles2.menuToggle,
       testID,
       onPress: onOpen,
-      children: /* @__PURE__ */ jsx(Text, { style: [styles.menuToggleGlyph, { color: theme.colors.text }], children: MENU_GLYPH2 })
+      children: /* @__PURE__ */ jsx(Text, { style: [styles2.menuToggleGlyph, { color: theme.colors.text }], children: MENU_GLYPH2 })
     }
   );
 };
@@ -909,21 +1040,34 @@ var MobileDrawer = ({
     node.addEventListener("click", handleClick);
     return () => node.removeEventListener("click", handleClick);
   }, [onClose]);
-  return /* @__PURE__ */ jsxs(View, { style: styles.overlay, children: [
+  return /* @__PURE__ */ jsxs(View, { style: styles2.overlay, children: [
     /* @__PURE__ */ jsx(
       Pressable,
       {
         accessibilityHint: labels.closeHint,
         accessibilityLabel: labels.closeLabel,
         accessibilityRole: "button",
-        style: styles.scrim,
+        style: styles2.scrim,
         testID: scrimTestID,
         onPress: onClose
       }
     ),
-    /* @__PURE__ */ jsx(View, { ref: panelRef, "aria-modal": true, role: "dialog", style: styles.panel, testID: drawerTestID, children: sidebar })
+    /* @__PURE__ */ jsx(View, { ref: panelRef, "aria-modal": true, role: "dialog", style: styles2.panel, testID: drawerTestID, children: sidebar })
   ] });
 };
+
+// src/railMode.ts
+var RAIL_FULL_BREAKPOINT = 768;
+var DEFAULT_COLLAPSED_RAIL_MAX = 1024;
+function resolveRailMode({ viewport, hasSidebar, hasCollapsed, range }) {
+  if (!hasSidebar) return "none";
+  if (hasCollapsed) {
+    if (viewport >= range.max) return "full";
+    if (viewport >= range.min) return "collapsed";
+    return "drawer";
+  }
+  return viewport >= RAIL_FULL_BREAKPOINT ? "full" : "drawer";
+}
 function resolveContentMaxWidth(width, viewport) {
   if (width === "full") return "full";
   const wideMinViewport = width.wideMinViewport ?? Number.POSITIVE_INFINITY;
@@ -935,13 +1079,7 @@ function useContentMaxWidth(width) {
   return resolveContentMaxWidth(width, viewport);
 }
 var DEFAULT_CONTENT_PADDING = 24;
-var CARD_PADDING = 20;
-var CARD_BORDER_RADIUS = 12;
-var CARD_BORDER_WIDTH = 1;
-var CARD_TITLE_FONT_SIZE = 16;
-var CARD_MESSAGE_FONT_SIZE = 14;
-var CARD_TITLE_MARGIN_BOTTOM = 8;
-var styles2 = StyleSheet.create({
+var styles3 = StyleSheet.create({
   root: { flex: 1 },
   centerFill: { flex: 1, justifyContent: "center", alignItems: "center" },
   scroll: { flex: 1 },
@@ -955,50 +1093,14 @@ var styles2 = StyleSheet.create({
   columnCapped: { flex: 1, width: "100%", alignSelf: "center" },
   // Non-flex variant used to cap the nav strip's inner content to the content
   // column so the nav aligns with the page content instead of running full-bleed.
-  chromeCapped: { width: "100%", alignSelf: "center" },
-  card: {
-    padding: CARD_PADDING,
-    borderRadius: CARD_BORDER_RADIUS,
-    borderWidth: CARD_BORDER_WIDTH
-  },
-  cardTitle: { fontSize: CARD_TITLE_FONT_SIZE, fontWeight: "700", marginBottom: CARD_TITLE_MARGIN_BOTTOM },
-  cardMessage: { fontSize: CARD_MESSAGE_FONT_SIZE }
+  chromeCapped: { width: "100%", alignSelf: "center" }
 });
-function MessageCard({
-  message,
-  accentColor,
-  testID
-}) {
-  const { theme } = useUi();
-  const colors = theme.colors;
-  return /* @__PURE__ */ jsxs(
-    View,
-    {
-      style: [styles2.card, { backgroundColor: colors.surface, borderColor: accentColor }],
-      testID,
-      children: [
-        /* @__PURE__ */ jsx(Text, { style: [styles2.cardTitle, { color: accentColor }], children: message.titleText }),
-        /* @__PURE__ */ jsx(Text, { style: [styles2.cardMessage, { color: colors.textSecondary }], children: message.messageText })
-      ]
-    }
-  );
-}
-function useContentBody(state, children, testID) {
-  const { theme } = useUi();
-  const primary = theme.palette.primary["500"];
-  const errorColor = theme.semantic.error["500"];
-  if (state?.forbidden)
-    return /* @__PURE__ */ jsx(MessageCard, { accentColor: errorColor, message: state.forbidden, testID: `${testID}${APP_SHELL_SUFFIX.forbidden}` });
-  if (state?.error)
-    return /* @__PURE__ */ jsx(MessageCard, { accentColor: errorColor, message: state.error, testID: `${testID}${APP_SHELL_SUFFIX.error}` });
-  if (state?.loading === true)
-    return /* @__PURE__ */ jsx(View, { style: styles2.centerFill, testID: `${testID}${APP_SHELL_SUFFIX.loading}`, children: /* @__PURE__ */ jsx(ActivityIndicator, { color: primary, size: "large" }) });
-  return children;
-}
 var AppShell = ({
   header,
   nav,
   sidebar,
+  collapsedSidebar,
+  collapsedRailRange,
   mobileMenu,
   banner,
   width = "full",
@@ -1014,34 +1116,40 @@ var AppShell = ({
   const maxWidth = useContentMaxWidth(width);
   const body = useContentBody(state, children, testID);
   const { width: viewportWidth } = useWindowDimensions();
-  const isNarrow = viewportWidth < MOBILE_BREAKPOINT;
-  const useDrawer = sidebar !== void 0 && isNarrow;
+  const railRange = collapsedRailRange ?? { min: RAIL_FULL_BREAKPOINT, max: DEFAULT_COLLAPSED_RAIL_MAX };
+  const railMode = resolveRailMode({
+    viewport: viewportWidth,
+    hasSidebar: sidebar !== void 0,
+    hasCollapsed: collapsedSidebar !== void 0,
+    range: railRange
+  });
+  const useDrawer = railMode === "drawer";
   const [drawerOpen, setDrawerOpen] = useState(false);
   const openDrawer = useCallback(() => setDrawerOpen(true), []);
   const closeDrawer = useCallback(() => setDrawerOpen(false), []);
   useEffect(() => {
-    if (!isNarrow && drawerOpen) setDrawerOpen(false);
-  }, [isNarrow, drawerOpen]);
+    if (!useDrawer && drawerOpen) setDrawerOpen(false);
+  }, [useDrawer, drawerOpen]);
   const drawerLabels = { ...DEFAULT_DRAWER_LABELS, ...mobileMenu };
   const isUnauthenticated = gate !== void 0 && !gate.pending && !gate.authenticated;
   useEffect(() => {
     if (isUnauthenticated && gate !== void 0) gate.onRedirect();
   }, [isUnauthenticated, gate]);
   if (gate?.pending === true)
-    return /* @__PURE__ */ jsx(View, { style: [styles2.root, styles2.centerFill, { backgroundColor: theme.colors.background }], testID: `${testID}${APP_SHELL_SUFFIX.pending}`, children: /* @__PURE__ */ jsx(ActivityIndicator, { color: primary, size: "large" }) });
+    return /* @__PURE__ */ jsx(View, { style: [styles3.root, styles3.centerFill, { backgroundColor: theme.colors.background }], testID: `${testID}${APP_SHELL_SUFFIX.pending}`, children: /* @__PURE__ */ jsx(ActivityIndicator, { color: primary, size: "large" }) });
   if (isUnauthenticated) return null;
-  const columnStyle = maxWidth === "full" ? styles2.columnFull : [styles2.columnCapped, { maxWidth }];
-  const navInnerStyle = chromeAlignment === "content" && maxWidth !== "full" ? [styles2.chromeCapped, { maxWidth, paddingHorizontal: contentPadding }] : void 0;
+  const columnStyle = maxWidth === "full" ? styles3.columnFull : [styles3.columnCapped, { maxWidth }];
+  const navInnerStyle = chromeAlignment === "content" && maxWidth !== "full" ? [styles3.chromeCapped, { maxWidth, paddingHorizontal: contentPadding }] : void 0;
   const scroller = /* @__PURE__ */ jsx(
     ScrollView,
     {
-      contentContainerStyle: [styles2.scrollContent, { padding: contentPadding }],
-      style: styles2.scroll,
+      contentContainerStyle: [styles3.scrollContent, { padding: contentPadding }],
+      style: styles3.scroll,
       testID: `${testID}${APP_SHELL_SUFFIX.content}`,
       children: /* @__PURE__ */ jsx(View, { style: columnStyle, children: body })
     }
   );
-  const headerRegion = useDrawer ? /* @__PURE__ */ jsxs(View, { style: styles2.headerRow, testID: `${testID}${APP_SHELL_SUFFIX.header}`, children: [
+  const headerRegion = useDrawer ? /* @__PURE__ */ jsxs(View, { style: styles3.headerRow, testID: `${testID}${APP_SHELL_SUFFIX.header}`, children: [
     /* @__PURE__ */ jsx(
       MenuToggle,
       {
@@ -1051,15 +1159,15 @@ var AppShell = ({
         onOpen: openDrawer
       }
     ),
-    /* @__PURE__ */ jsx(View, { style: styles2.headerFill, children: header })
+    /* @__PURE__ */ jsx(View, { style: styles3.headerFill, children: header })
   ] }) : /* @__PURE__ */ jsx(View, { testID: `${testID}${APP_SHELL_SUFFIX.header}`, children: header });
-  const showRail = sidebar !== void 0 && !isNarrow;
-  return /* @__PURE__ */ jsxs(View, { style: [styles2.root, { backgroundColor: theme.colors.background }], testID, children: [
+  const railRegion = railMode === "full" ? /* @__PURE__ */ jsx(View, { testID: `${testID}${APP_SHELL_SUFFIX.sidebar}`, children: sidebar }) : railMode === "collapsed" ? /* @__PURE__ */ jsx(View, { testID: `${testID}${APP_SHELL_SUFFIX.collapsedSidebar}`, children: collapsedSidebar }) : null;
+  return /* @__PURE__ */ jsxs(View, { style: [styles3.root, { backgroundColor: theme.colors.background }], testID, children: [
     headerRegion,
     nav !== void 0 ? /* @__PURE__ */ jsx(View, { testID: `${testID}${APP_SHELL_SUFFIX.nav}`, children: navInnerStyle !== void 0 ? /* @__PURE__ */ jsx(View, { style: navInnerStyle, children: nav }) : nav }) : null,
     banner !== void 0 ? /* @__PURE__ */ jsx(View, { testID: `${testID}${APP_SHELL_SUFFIX.banner}`, children: banner }) : null,
-    showRail ? /* @__PURE__ */ jsxs(View, { style: styles2.bodyRow, children: [
-      /* @__PURE__ */ jsx(View, { testID: `${testID}${APP_SHELL_SUFFIX.sidebar}`, children: sidebar }),
+    railRegion !== null ? /* @__PURE__ */ jsxs(View, { style: styles3.bodyRow, children: [
+      railRegion,
       scroller
     ] }) : scroller,
     useDrawer && drawerOpen ? /* @__PURE__ */ jsx(
@@ -1074,6 +1182,262 @@ var AppShell = ({
     ) : null
   ] });
 };
+var COLLAPSED_ICON_SIZE = 22;
+function glyphFor(label) {
+  return label.trim().charAt(0).toUpperCase();
+}
+var CollapsedRail = ({
+  items,
+  pathname,
+  onNavigate,
+  regionLabel,
+  navigateHint = (label) => label,
+  header,
+  footer,
+  containerStyle
+}) => {
+  const { theme } = useUi();
+  const colors = theme.colors;
+  const primaryColor = theme.palette.primary["500"];
+  return /* @__PURE__ */ jsxs(
+    View,
+    {
+      accessibilityRole: "none",
+      "aria-label": regionLabel,
+      role: "navigation",
+      style: [
+        collapsedRailStyles.container,
+        { backgroundColor: colors.surface, borderRightColor: colors.border },
+        containerStyle
+      ],
+      children: [
+        header !== void 0 ? /* @__PURE__ */ jsx(View, { style: collapsedRailStyles.slot, children: header }) : null,
+        items.map((item) => {
+          const active = isRouteActive(pathname, item.route);
+          const iconColor = active ? primaryColor : colors.textSecondary;
+          return /* @__PURE__ */ jsx(
+            FocusableTouchable,
+            {
+              accessibilityHint: navigateHint(item.label),
+              accessibilityLabel: item.label,
+              ringColor: primaryColor,
+              style: [collapsedRailStyles.item, active ? { backgroundColor: colors.border } : void 0],
+              testID: item.testID ?? item.key,
+              onPress: () => onNavigate(item.route),
+              children: typeof item.renderIcon === "function" ? item.renderIcon(iconColor, COLLAPSED_ICON_SIZE) : /* @__PURE__ */ jsx(Text, { style: [collapsedRailStyles.glyph, { color: iconColor }], children: glyphFor(item.label) })
+            },
+            item.key
+          );
+        }),
+        /* @__PURE__ */ jsx(View, { style: collapsedRailStyles.spacer }),
+        footer !== void 0 ? /* @__PURE__ */ jsx(View, { style: collapsedRailStyles.slot, children: footer }) : null
+      ]
+    }
+  );
+};
+function wantsTopBar(layout, hasHeader, hasTopBar) {
+  return layout === "top" || layout === "both" || hasHeader || layout === "side" && hasTopBar;
+}
+function wantsSideRail(layout, hasSideRail) {
+  return (layout === "side" || layout === "both") && hasSideRail;
+}
+var NavShell = ({
+  layout,
+  pathname,
+  onNavigate,
+  regionLabel,
+  navigateHint,
+  topBar,
+  header,
+  sideRail,
+  children,
+  collapsedSidebar: collapsedSidebarProp,
+  collapsedRailRange: collapsedRailRangeProp,
+  ...shellProps
+}) => {
+  const showTopBar = wantsTopBar(layout, header !== void 0, topBar !== void 0);
+  const showSideRail = wantsSideRail(layout, sideRail !== void 0);
+  const headerNode = header !== void 0 ? header : showTopBar && topBar !== void 0 ? /* @__PURE__ */ jsx(
+    NavBar,
+    {
+      barTheme: topBar.barTheme,
+      brand: topBar.brand,
+      collapseBelow: topBar.collapseBelow,
+      containerStyle: topBar.containerStyle,
+      contentMaxWidth: topBar.contentMaxWidth,
+      items: topBar.items,
+      menuHint: topBar.menuHint,
+      menuLabel: topBar.menuLabel,
+      navigateHint,
+      overflowHint: topBar.overflowHint,
+      overflowLabel: topBar.overflowLabel,
+      pathname,
+      regionLabel,
+      renderMenuIcon: topBar.renderMenuIcon,
+      right: topBar.right,
+      onNavigate
+    }
+  ) : null;
+  const sidebarNode = showSideRail && sideRail !== void 0 ? /* @__PURE__ */ jsx(
+    Sidebar,
+    {
+      collapseHint: sideRail.collapseHint,
+      containerStyle: sideRail.containerStyle,
+      expandHint: sideRail.expandHint,
+      footer: sideRail.footer,
+      header: sideRail.header,
+      items: sideRail.items,
+      navigateHint,
+      pathname,
+      regionLabel,
+      renderChevron: sideRail.renderChevron,
+      title: sideRail.title,
+      onNavigate
+    }
+  ) : void 0;
+  const collapsedCfg = showSideRail ? sideRail?.collapsed : void 0;
+  const collapsedNode = collapsedCfg !== void 0 && sideRail !== void 0 ? /* @__PURE__ */ jsx(
+    CollapsedRail,
+    {
+      footer: collapsedCfg.footer,
+      header: collapsedCfg.header,
+      items: collapsedCfg.items ?? sideRail.items,
+      navigateHint,
+      pathname,
+      regionLabel,
+      onNavigate
+    }
+  ) : collapsedSidebarProp;
+  const collapsedRange = collapsedCfg?.range ?? collapsedRailRangeProp;
+  return /* @__PURE__ */ jsx(
+    AppShell,
+    {
+      ...shellProps,
+      collapsedRailRange: collapsedRange,
+      collapsedSidebar: collapsedNode,
+      header: headerNode,
+      sidebar: sidebarNode,
+      children
+    }
+  );
+};
+var TEXT_ON_PRIMARY4 = "#ffffff";
+var DEFAULT_MIN_ITEMS = 1;
+var PillNav = ({
+  items,
+  pathname,
+  onNavigate,
+  regionLabel,
+  navigateHint = (label) => label,
+  minItems = DEFAULT_MIN_ITEMS,
+  containerStyle
+}) => {
+  const { theme } = useUi();
+  const colors = theme.colors;
+  const primaryColor = theme.palette.primary["500"];
+  if (items.length < minItems) return null;
+  return /* @__PURE__ */ jsx(
+    View,
+    {
+      accessibilityRole: "none",
+      "aria-label": regionLabel,
+      role: "navigation",
+      style: [pillNavStyles.container, containerStyle],
+      children: items.map((item) => {
+        const active = isRouteActive(pathname, item.route);
+        const textColor = active ? TEXT_ON_PRIMARY4 : colors.textSecondary;
+        const pillStyle = active ? { backgroundColor: primaryColor } : { backgroundColor: colors.surfaceElevated };
+        return /* @__PURE__ */ jsxs(
+          FocusableTouchable,
+          {
+            accessibilityHint: navigateHint(item.label),
+            accessibilityLabel: item.label,
+            accessibilityRole: "link",
+            ringColor: primaryColor,
+            style: [pillNavStyles.pill, pillStyle],
+            testID: item.testID ?? item.key,
+            onPress: () => onNavigate(item.route),
+            children: [
+              typeof item.renderIcon === "function" ? item.renderIcon(textColor, NAV_ICON_SIZE) : null,
+              /* @__PURE__ */ jsx(Text, { style: [pillNavStyles.pillText, { color: textColor }], children: item.label })
+            ]
+          },
+          item.key
+        );
+      })
+    }
+  );
+};
+var TEXT_ON_PRIMARY5 = "#ffffff";
+var DARK_MODE_ICON_SIZE = 16;
+var DarkModeControl = ({
+  value,
+  options,
+  onChange,
+  regionLabel,
+  variant = "segmented",
+  testID,
+  containerStyle
+}) => {
+  const { theme } = useUi();
+  const colors = theme.colors;
+  const primaryColor = theme.palette.primary["500"];
+  const currentIndex = options.findIndex((option) => option.value === value);
+  const current = currentIndex >= 0 ? options[currentIndex] : options[0];
+  const advance = useCallback(() => {
+    if (options.length === 0) return;
+    const from = currentIndex >= 0 ? currentIndex : 0;
+    const next = options[(from + 1) % options.length];
+    if (next !== void 0) onChange(next.value);
+  }, [options, currentIndex, onChange]);
+  if (options.length === 0 || current === void 0) return null;
+  if (variant === "cycle") {
+    const iconColor = colors.text;
+    return /* @__PURE__ */ jsx(View, { "aria-label": regionLabel, style: containerStyle, children: /* @__PURE__ */ jsxs(
+      FocusableTouchable,
+      {
+        accessibilityHint: current.hint,
+        accessibilityLabel: current.label,
+        ringColor: primaryColor,
+        style: [darkModeStyles.cycle, { backgroundColor: colors.surfaceElevated }],
+        testID,
+        onPress: advance,
+        children: [
+          typeof current.renderIcon === "function" ? current.renderIcon(iconColor, DARK_MODE_ICON_SIZE) : null,
+          /* @__PURE__ */ jsx(Text, { style: [darkModeStyles.cycleText, { color: colors.text }], children: current.label })
+        ]
+      }
+    ) });
+  }
+  return /* @__PURE__ */ jsx(
+    View,
+    {
+      "aria-label": regionLabel,
+      role: "group",
+      style: [darkModeStyles.segmentRow, { borderColor: colors.border }, containerStyle],
+      children: options.map((option) => {
+        const active = option.value === value;
+        const textColor = active ? TEXT_ON_PRIMARY5 : colors.textSecondary;
+        return /* @__PURE__ */ jsxs(
+          FocusableTouchable,
+          {
+            accessibilityHint: option.hint,
+            accessibilityLabel: option.label,
+            ringColor: primaryColor,
+            style: [darkModeStyles.segment, active ? { backgroundColor: primaryColor } : void 0],
+            testID: testID !== void 0 ? `${testID}-${option.value}` : void 0,
+            onPress: () => onChange(option.value),
+            children: [
+              typeof option.renderIcon === "function" ? option.renderIcon(textColor, DARK_MODE_ICON_SIZE) : null,
+              /* @__PURE__ */ jsx(Text, { style: [darkModeStyles.segmentText, { color: textColor }], children: option.label })
+            ]
+          },
+          option.value
+        );
+      })
+    }
+  );
+};
 function roleRoutesToNavItems(routes, translate) {
   return routes.map((entry) => ({
     key: entry.role,
@@ -1085,6 +1449,6 @@ function accessibleNavItems(user, table, translate) {
   return roleRoutesToNavItems(resolveAccessibleRoutes(user, table), translate);
 }
 
-export { ACTIVE_BORDER_RADIUS, APP_SHELL_SUFFIX, AppShell, BASE_INDENT, CHEVRON_ICON_SIZE, NAV_ICON_SIZE, NAV_LINK_GAP, NAV_TEST_IDS, Nav, NavBar, NavExpandableItem, NavOverflowMenu, Sidebar, Topbar, accessibleNavItems, expandableStyles, isRouteActive, navStyles, resolveContentMaxWidth, roleRoutesToNavItems, useContentMaxWidth };
+export { ACTIVE_BORDER_RADIUS, APP_SHELL_SUFFIX, AppShell, BASE_INDENT, CHEVRON_ICON_SIZE, CollapsedRail, DEFAULT_COLLAPSED_RAIL_MAX, DarkModeControl, NAV_ICON_SIZE, NAV_LINK_GAP, NAV_TEST_IDS, Nav, NavBar, NavExpandableItem, NavOverflowMenu, NavShell, PillNav, RAIL_FULL_BREAKPOINT, Sidebar, Topbar, accessibleNavItems, collapsedRailStyles, darkModeStyles, expandableStyles, isRouteActive, navStyles, pillNavStyles, resolveContentMaxWidth, resolveRailMode, roleRoutesToNavItems, useContentMaxWidth };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map