jfs-components 0.0.62 → 0.0.64

package/lib/module/components/Section/Section.js

@@ -1,83 +1,269 @@
 "use strict";
 
-import React, { useState, useRef, useCallback, useEffect } from 'react';
+import React, { useState, useMemo, useRef, useCallback } from 'react';
 import { View, Text, Pressable, Platform } from 'react-native';
+import Animated, { FadeInUp, FadeOutUp, ReduceMotion, useAnimatedStyle, useSharedValue, withSpring } from 'react-native-reanimated';
 import { getVariableByName } from '../../design-tokens/figma-variables-resolver';
 import NavArrow from '../NavArrow/NavArrow';
+import IconCapsule from '../IconCapsule/IconCapsule';
+import ListItem from '../ListItem/ListItem';
 import { usePressableWebSupport } from '../../utils/web-platform-utils';
-import { cloneChildrenWithModes, flattenChildren } from '../../utils/react-utils';
+import { EMPTY_MODES, cloneChildrenWithModes, flattenChildren } from '../../utils/react-utils';
+
+// Match Button: delay the press visual on iOS so a scroll-cancelled touch
+// never applies the "pressed" style. See Button.tsx for the rationale.
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+const IS_WEB = Platform.OS === 'web';
+const IS_IOS = Platform.OS === 'ios';
+const HEADER_PRESS_DELAY = IS_IOS ? 130 : 0;
+
+// Module-scope style constants — never re-allocated per render.
+const headerWrapStyle = {
+  flexDirection: 'row',
+  alignItems: 'center',
+  justifyContent: 'space-between'
+};
+const headerHoverStyle = {
+  opacity: 0.95
+};
+const headerPressedStyle = {
+  opacity: 0.85
+};
+const headerFocusStyle = {
+  borderColor: '#222',
+  borderWidth: 1
+};
 
 // ---------------------------------------------------------------------------
-// Shared grid layout: measures widest child, enforces uniform width,
-// chunks into fixed rows of up to maxColumns, space-between per row.
+// Shared grid layout — first-row-anchored sizing.
+//
+// We measure each cell of the *first row* via `onLayout`, take their max as
+// the canonical cellWidth, then apply that explicit width to every cell in
+// every row. Combined with `justify-content: space-between`, this preserves
+// three visual invariants regardless of viewport width:
+//   1. The first cell hugs the container's left edge.
+//   2. The last cell hugs the container's right edge.
+//   3. Cells in row N column K align with cells in row N+1 column K
+//      (uniform cell width across the whole grid).
+//
+// Why first-row-anchored?
+//
+// The first row is *always present* (collapsed and expanded both render it),
+// so the measurement happens exactly once on first mount and stays valid for
+// the lifetime of the SlotGrid — the cellWidth is *stable across toggles*.
+// New cells in row 2+ mount when the user expands, and by that time
+// `cellWidth` is already cached, so their `Animated.View` `entering` cascade
+// is never interrupted by a re-measurement-driven re-render.
+//
+// Why not container-width math (e.g. `(containerWidth - gaps) / columns`)?
+// That makes every cell wide enough to fill its share of the row. On wide
+// viewports each cell becomes much wider than its content (icon + label),
+// the content centers inside its oversized cell, and the visible result is
+// a "dead margin" of empty space on the left and right of the grid. Sizing
+// cells to natural content + `space-between` instead pushes the first cell
+// flush left and the last cell flush right, distributing leftover space as
+// the inter-cell gap.
+//
+// Why not measure every cell?
+// The original implementation did, and `max()` could change when the item
+// count changed (collapsed picks one max, expanded another), producing a
+// visible width jump on toggle. The per-cell remeasurement also forced a
+// re-render in the same React batch as the `entering` animation mounting,
+// which Reanimated treats as a cancellation signal — cells visibly didn't
+// animate. Anchoring to the first row eliminates both costs.
+//
+// First-frame behavior is preserved (no blank-flash): until the first-row
+// `onLayout` fires, cells render at their natural width with `space-between`
+// already laying them out correctly; the only thing that changes after
+// measurement is that subsequent rows snap to the same cellWidth so columns
+// align.
 // ---------------------------------------------------------------------------
-import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 const SLOT_GRID_MAX_COLUMNS = 4;
-function SlotGrid({
+
+// Beyond this many "extra" cells, additional cells reuse the cap delay so very
+// large grids (16, 32, …) still feel snappy instead of cascading for >1s.
+const SLOT_GRID_STAGGER_CAP = 8;
+const SLOT_GRID_ENTER_STAGGER_MS = 35;
+const SLOT_GRID_EXIT_STAGGER_MS = 20;
+const SLOT_GRID_EXIT_DURATION_MS = 160;
+const slotGridRowFlowStyle = {
+  flexDirection: 'row',
+  justifyContent: 'space-between'
+};
+const SlotGrid = /*#__PURE__*/React.memo(function SlotGrid({
   items,
   gap,
-  maxColumns = SLOT_GRID_MAX_COLUMNS
+  maxColumns = SLOT_GRID_MAX_COLUMNS,
+  animateExtrasFromIndex,
+  animateContainerLayout
 }) {
-  const [maxItemWidth, setMaxItemWidth] = useState(null);
-  const [measureTimedOut, setMeasureTimedOut] = useState(false);
-  const itemWidthsRef = useRef(new Map());
   const totalItems = items.length;
-  useEffect(() => {
-    itemWidthsRef.current.clear();
-    setMaxItemWidth(null);
-    setMeasureTimedOut(false);
-  }, [totalItems]);
-  useEffect(() => {
-    if (maxItemWidth !== null) return;
-    const timer = setTimeout(() => setMeasureTimedOut(true), 500);
-    return () => clearTimeout(timer);
-  }, [maxItemWidth, totalItems]);
-  const handleItemLayout = useCallback((index, width) => {
-    itemWidthsRef.current.set(index, width);
-    if (itemWidthsRef.current.size >= totalItems && totalItems > 0) {
-      setMaxItemWidth(Math.max(...itemWidthsRef.current.values()));
-    }
-  }, [totalItems]);
-  const isMeasured = maxItemWidth !== null;
   const columns = Math.min(maxColumns, totalItems || 1);
+  // Number of cells in the first row. Capped by `columns` (a fully-filled row)
+  // and by `totalItems` (e.g. a 1-item grid has a 1-cell first row).
+  const firstRowSize = Math.min(columns, totalItems);
+
+  // First-row width measurement. Only cells whose `itemIndex < firstRowSize`
+  // get an `onLayout` callback. Once we have a width sample for each first-row
+  // cell, we publish the max and the callbacks become inert — no further
+  // measurement happens for the rest of the SlotGrid's lifetime, so toggles
+  // never trigger a re-measurement-driven re-render.
+  const [firstRowMaxWidth, setFirstRowMaxWidth] = useState(null);
+  const firstRowWidthsRef = useRef(new Map());
+  const handleFirstRowItemLayout = useCallback((index, width) => {
+    const widths = firstRowWidthsRef.current;
+    const previous = widths.get(index);
+    if (previous !== undefined && Math.abs(previous - width) < 0.5) return;
+    widths.set(index, width);
+    if (widths.size >= firstRowSize && firstRowSize > 0) {
+      let newMax = 0;
+      for (const w of widths.values()) {
+        if (w > newMax) newMax = w;
+      }
+      setFirstRowMaxWidth(prev => prev !== null && Math.abs(prev - newMax) < 0.5 ? prev : newMax);
+    }
+  }, [firstRowSize]);
+  const cellWidth = firstRowMaxWidth;
   const rows = [];
   for (let i = 0; i < items.length; i += columns) {
     rows.push(items.slice(i, i + columns));
   }
-  return /*#__PURE__*/_jsx(View, {
-    style: {
-      gap,
-      ...(isMeasured || measureTimedOut ? {} : {
-        opacity: 0
-      })
-    },
+  const containerStyle = useMemo(() => ({
+    gap
+  }), [gap]);
+  const cellStyle = useMemo(() => cellWidth !== null ? {
+    width: cellWidth
+  } : undefined, [cellWidth]);
+
+  // `space-between` distributes any leftover row space as inter-cell gap, so
+  // the first cell is flush-left and the last cell is flush-right regardless
+  // of whether cellWidth has been measured yet. Identical layout strategy
+  // before and after measurement — no first-frame layout shift.
+  const rowStyle = slotGridRowFlowStyle;
+  const animationsEnabled = animateExtrasFromIndex !== undefined;
+  // Resolve the threshold once. When undefined we treat it as
+  // Number.POSITIVE_INFINITY so the per-cell branch always picks the plain
+  // `<View>` path.
+  const extrasThreshold = animationsEnabled ? animateExtrasFromIndex : Number.POSITIVE_INFINITY;
+  // Total count of "extra" cells currently rendered. Used to compute the
+  // reverse-stagger delay for the exiting animation so that the last cell
+  // leaves first.
+  const extrasCount = animationsEnabled ? Math.max(0, totalItems - extrasThreshold) : 0;
+  const useAnimatedContainer = animateContainerLayout === true;
+
+  // Explicit-height clip animation:
+  //
+  // Reanimated's `LinearTransition` interpolates the container's bounds, and
+  // in practice that interpolation drags on the cells inside (they momentarily
+  // appear squashed because the parent is shorter than its natural content
+  // for the duration of the animation). To keep cells at their *natural size
+  // throughout*, we instead:
+  //   1. Render the rows inside an inner `<View>` that sizes to its content
+  //      naturally — cells are never squeezed, never resized.
+  //   2. Wrap that inner view in an `Animated.View` with `overflow: 'hidden'`
+  //      and an explicit `height` driven by a shared value.
+  //   3. The inner view reports its natural height via `onLayout`. The first
+  //      measurement snaps the shared value (no first-mount animation). Every
+  //      subsequent change (e.g. expand/collapse adds or removes rows) springs
+  //      the shared value to the new natural height.
+  //
+  // Visually: the container reveals/conceals content like a curtain, and the
+  // cells never deform.
+  const animatedHeight = useSharedValue(-1);
+  const isFirstHeightLayoutRef = useRef(true);
+  const handleContentLayout = useCallback(e => {
+    const h = e.nativeEvent.layout.height;
+    if (h <= 0) return;
+    if (isFirstHeightLayoutRef.current) {
+      isFirstHeightLayoutRef.current = false;
+      animatedHeight.value = h;
+      return;
+    }
+    animatedHeight.value = withSpring(h, {
+      damping: 22,
+      stiffness: 180,
+      reduceMotion: ReduceMotion.System
+    });
+  }, [animatedHeight]);
+  const animatedHeightStyle = useAnimatedStyle(() => animatedHeight.value < 0 ? {} : {
+    height: animatedHeight.value,
+    overflow: 'hidden'
+  });
+  const rowsChildren = /*#__PURE__*/_jsx(_Fragment, {
     children: rows.map((row, rowIndex) => {
       const spacersNeeded = row.length < columns ? columns - row.length : 0;
       return /*#__PURE__*/_jsxs(View, {
-        style: {
-          flexDirection: 'row',
-          justifyContent: 'space-between'
-        },
+        style: rowStyle,
         children: [row.map((child, colIndex) => {
           const itemIndex = rowIndex * columns + colIndex;
+          // Only first-row cells participate in measurement, and only
+          // until firstRowMaxWidth has been published. After that the
+          // onLayout becomes a no-op (we elide it).
+          const onLayoutHandler = firstRowMaxWidth === null && itemIndex < firstRowSize ? e => handleFirstRowItemLayout(itemIndex, e.nativeEvent.layout.width) : undefined;
+          if (itemIndex >= extrasThreshold) {
+            const extraOrdinal = itemIndex - extrasThreshold;
+            const enterStaggerSteps = Math.min(extraOrdinal, SLOT_GRID_STAGGER_CAP);
+            const reverseOrdinal = Math.max(0, extrasCount - 1 - extraOrdinal);
+            const exitStaggerSteps = Math.min(reverseOrdinal, SLOT_GRID_STAGGER_CAP);
+            const entering = FadeInUp.springify().damping(18).delay(enterStaggerSteps * SLOT_GRID_ENTER_STAGGER_MS).reduceMotion(ReduceMotion.System);
+            const exiting = FadeOutUp.duration(SLOT_GRID_EXIT_DURATION_MS).delay(exitStaggerSteps * SLOT_GRID_EXIT_STAGGER_MS).reduceMotion(ReduceMotion.System);
+            return /*#__PURE__*/_jsx(Animated.View, {
+              entering: entering,
+              exiting: exiting,
+              ...(onLayoutHandler ? {
+                onLayout: onLayoutHandler
+              } : null),
+              style: cellStyle,
+              children: child
+            }, itemIndex);
+          }
           return /*#__PURE__*/_jsx(View, {
-            onLayout: !isMeasured ? e => handleItemLayout(itemIndex, e.nativeEvent.layout.width) : undefined,
-            style: isMeasured ? {
-              width: maxItemWidth
-            } : undefined,
+            ...(onLayoutHandler ? {
+              onLayout: onLayoutHandler
+            } : null),
+            style: cellStyle,
             children: child
           }, itemIndex);
-        }), isMeasured && spacersNeeded > 0 && Array.from({
+        }), cellWidth !== null && spacersNeeded > 0 && Array.from({
           length: spacersNeeded
         }, (_, i) => /*#__PURE__*/_jsx(View, {
-          style: {
-            width: maxItemWidth
-          }
+          style: cellStyle
         }, `spacer-${i}`))]
       }, rowIndex);
     })
   });
+  if (useAnimatedContainer) {
+    // Outer Animated.View clips and animates height. Inner View holds the
+    // rows at natural size and reports its natural height for the spring
+    // target. Cell-width measurement happens on the cells themselves
+    // (first-row only) — no container-level onLayout is needed.
+    return /*#__PURE__*/_jsx(Animated.View, {
+      style: animatedHeightStyle,
+      children: /*#__PURE__*/_jsx(View, {
+        style: containerStyle,
+        onLayout: handleContentLayout,
+        children: rowsChildren
+      })
+    });
+  }
+  return /*#__PURE__*/_jsx(View, {
+    style: containerStyle,
+    children: rowsChildren
+  });
+}, slotGridPropsAreEqual);
+function slotGridPropsAreEqual(prev, next) {
+  if (prev.gap !== next.gap) return false;
+  if ((prev.maxColumns ?? SLOT_GRID_MAX_COLUMNS) !== (next.maxColumns ?? SLOT_GRID_MAX_COLUMNS)) return false;
+  if (prev.animateExtrasFromIndex !== next.animateExtrasFromIndex) return false;
+  if (prev.animateContainerLayout !== next.animateContainerLayout) return false;
+  if (prev.items === next.items) return true;
+  if (prev.items.length !== next.items.length) return false;
+  for (let i = 0; i < prev.items.length; i++) {
+    if (prev.items[i] !== next.items[i]) return false;
+  }
+  return true;
 }
+
 /**
  * Section component that mirrors the Figma "Section" component.
  *
@@ -102,96 +288,99 @@ function SlotGrid({
  * @param {string} [props.accessibilityLabel] - Accessibility label for the section. If not provided, uses title
  * @param {string} [props.accessibilityHint] - Additional accessibility hint for screen readers
  */
-function Section({
-  title = 'Section title',
-  supportText = 'Section support text',
-  showSupportText = true,
-  slot,
-  slotDirection = 'row',
-  modes = {},
-  onPress,
-  style,
-  accessibilityLabel,
-  accessibilityHint,
-  webAccessibilityProps,
-  ...rest
-}) {
-  const [isHeaderFocused, setIsHeaderFocused] = useState(false);
-  const [isHeaderHovered, setIsHeaderHovered] = useState(false);
-  const [isHeaderPressed, setIsHeaderPressed] = useState(false);
-  const headerFocusStyle = isHeaderFocused ? {
-    borderColor: '#222',
-    borderWidth: 1
-  } : {};
-  const headerHoverStyle = isHeaderHovered ? {
-    opacity: 0.95
-  } : {};
-  const headerPressedStyle = isHeaderPressed ? {
-    opacity: 0.85
-  } : {};
-  // Resolve section container tokens
+
+function resolveSectionTokens(modes) {
   const backgroundColor = getVariableByName('section/background/color', modes) || '#ffffff';
   const sectionGap = getVariableByName('section/gap', modes) || 12;
   const slotGap = getVariableByName('slot/gap', modes) || 12;
   const paddingHorizontal = getVariableByName('section/padding/horizontal', modes) || 12;
   const paddingVertical = getVariableByName('section/padding/vertical', modes) || 16;
   const radius = getVariableByName('section/radius', modes) || 12;
-
-  // Resolve section header tokens
   const headerGap = getVariableByName('section/header/gap', modes) || 8;
   const headerPaddingHorizontal = getVariableByName('section/header/padding/horizontal', modes) || 0;
   const headerPaddingVertical = getVariableByName('section/header/padding/vertical', modes) || 0;
-
-  // Resolve section title tokens
   const titleColor = getVariableByName('section/title/color', modes) || '#0f0d0a';
   const titleFontSize = getVariableByName('section/title/fontSize', modes) || 18;
   const titleLineHeight = getVariableByName('section/title/lineHeight', modes) || 20;
   const titleFontFamily = getVariableByName('section/title/fontFamily', modes) || 'System';
   const titleFontWeightRaw = getVariableByName('section/title/fontWeight', modes) || 800;
   const titleFontWeight = typeof titleFontWeightRaw === 'number' ? titleFontWeightRaw.toString() : titleFontWeightRaw;
-
-  // Resolve section support text tokens
   const supportTextColor = getVariableByName('section/supportText/color', modes) || '#1f1a14';
   const supportTextFontSize = getVariableByName('section/supportText/fontSize', modes) || 14;
   const supportTextLineHeight = getVariableByName('section/supportText/lineHeight', modes) || 18;
   const supportTextFontFamily = getVariableByName('section/supportText/fontFamily', modes) || 'System';
   const supportTextFontWeightRaw = getVariableByName('section/supportText/fontWeight', modes) || 500;
   const supportTextFontWeight = typeof supportTextFontWeightRaw === 'number' ? supportTextFontWeightRaw.toString() : supportTextFontWeightRaw;
-  const containerStyle = {
-    backgroundColor,
-    paddingHorizontal,
-    paddingVertical,
-    borderRadius: radius,
-    gap: sectionGap
-  };
-  const headerStyle = {
-    paddingHorizontal: headerPaddingHorizontal,
-    paddingVertical: headerPaddingVertical,
-    gap: headerGap
-  };
-  const headerWrapStyle = {
-    flexDirection: 'row',
-    alignItems: 'center',
-    justifyContent: 'space-between'
-  };
-  const titleStyle = {
-    flex: 1,
-    color: titleColor,
-    fontSize: titleFontSize,
-    lineHeight: titleLineHeight,
-    fontFamily: titleFontFamily,
-    fontWeight: titleFontWeight
-  };
-  const supportTextStyle = {
-    color: supportTextColor,
-    fontSize: supportTextFontSize,
-    lineHeight: supportTextLineHeight,
-    fontFamily: supportTextFontFamily,
-    fontWeight: supportTextFontWeight
+  return {
+    containerStyle: {
+      backgroundColor,
+      paddingHorizontal,
+      paddingVertical,
+      borderRadius: radius,
+      gap: sectionGap
+    },
+    headerStyle: {
+      paddingHorizontal: headerPaddingHorizontal,
+      paddingVertical: headerPaddingVertical,
+      gap: headerGap
+    },
+    titleStyle: {
+      flex: 1,
+      color: titleColor,
+      fontSize: titleFontSize,
+      lineHeight: titleLineHeight,
+      fontFamily: titleFontFamily,
+      fontWeight: titleFontWeight
+    },
+    supportTextStyle: {
+      color: supportTextColor,
+      fontSize: supportTextFontSize,
+      lineHeight: supportTextLineHeight,
+      fontFamily: supportTextFontFamily,
+      fontWeight: supportTextFontWeight
+    },
+    sectionGap,
+    slotGap
   };
+}
+function Section({
+  title = 'Section title',
+  supportText = 'Section support text',
+  showSupportText = true,
+  slot,
+  slotDirection = 'row',
+  modes = EMPTY_MODES,
+  onPress,
+  style,
+  // accessibilityLabel is intentionally accepted on the type for API
+  // back-compat, but the inner Pressable/View deliberately pass
+  // `accessibilityLabel={undefined}` (the title Text carries the label
+  // instead). Prefix to satisfy the unused-var lint while keeping the prop
+  // shape unchanged.
+  accessibilityLabel: _accessibilityLabel,
+  accessibilityHint,
+  webAccessibilityProps,
+  ...rest
+}) {
+  // Focus and hover are still mirrored in React because they are visible,
+  // sustained states (web-only in practice). The setters are gated so they
+  // never fire on native — keeping the component render-free during touch.
+  // Press is handled imperatively via the `Pressable` style callback so a
+  // scroll-cancelled touch never schedules a React render.
+  const [isHeaderFocused, setIsHeaderFocused] = useState(false);
+  const [isHeaderHovered, setIsHeaderHovered] = useState(false);
 
-  // Generate default accessibility label from title and supportText
-  const defaultAccessibilityLabel = accessibilityLabel || (showSupportText ? `${title}. ${supportText}` : title);
+  // Mirror user handlers in a ref so our wrappers can stay referentially
+  // stable. Without this, every parent re-render would hand Pressable fresh
+  // function identities and re-bind every event.
+  const userHandlersRef = useRef({});
+  userHandlersRef.current.onPressIn = rest?.onPressIn;
+  userHandlersRef.current.onPressOut = rest?.onPressOut;
+  userHandlersRef.current.onHoverIn = rest?.onHoverIn;
+  userHandlersRef.current.onHoverOut = rest?.onHoverOut;
+  userHandlersRef.current.onFocus = rest?.onFocus;
+  userHandlersRef.current.onBlur = rest?.onBlur;
+  const tokens = useMemo(() => resolveSectionTokens(modes), [modes]);
 
   // Get web platform support props (only used when onPress is defined)
   const webProps = usePressableWebSupport({
@@ -205,7 +394,7 @@ function Section({
     children: [/*#__PURE__*/_jsxs(View, {
       style: headerWrapStyle,
       children: [/*#__PURE__*/_jsx(Text, {
-        style: titleStyle,
+        style: tokens.titleStyle,
         numberOfLines: 1,
         accessibilityElementsHidden: true,
         importantForAccessibility: "no",
@@ -215,16 +404,49 @@ function Section({
         modes: modes
       })]
     }), showSupportText && /*#__PURE__*/_jsx(Text, {
-      style: supportTextStyle,
+      style: tokens.supportTextStyle,
       numberOfLines: 2,
       accessibilityElementsHidden: true,
       importantForAccessibility: "no",
       children: supportText
     })]
   });
+
+  // Stable handler identities. User handlers are read through the ref so
+  // these wrappers don't need new identities each render.
+  const handlePressIn = useCallback(e => {
+    userHandlersRef.current.onPressIn?.(e);
+  }, []);
+  const handlePressOut = useCallback(e => {
+    userHandlersRef.current.onPressOut?.(e);
+  }, []);
+  const handleHoverIn = useCallback(e => {
+    if (IS_WEB) setIsHeaderHovered(true);
+    userHandlersRef.current.onHoverIn?.(e);
+  }, []);
+  const handleHoverOut = useCallback(e => {
+    if (IS_WEB) setIsHeaderHovered(false);
+    userHandlersRef.current.onHoverOut?.(e);
+  }, []);
+  const handleFocus = useCallback(e => {
+    if (IS_WEB) setIsHeaderFocused(true);
+    userHandlersRef.current.onFocus?.(e);
+  }, []);
+  const handleBlur = useCallback(e => {
+    if (IS_WEB) setIsHeaderFocused(false);
+    userHandlersRef.current.onBlur?.(e);
+  }, []);
+
+  // The pressed visual is applied by the host view directly through the
+  // Pressable style callback — no React render is scheduled. We still want
+  // the (constant) hover style on web so we keep it in the array.
+  const headerStyleCallback = useCallback(({
+    pressed
+  }) => [tokens.headerStyle, pressed ? headerPressedStyle : null, isHeaderHovered ? headerHoverStyle : null, isHeaderFocused ? headerFocusStyle : null], [tokens.headerStyle, isHeaderHovered, isHeaderFocused]);
+  const containerStyleArray = useMemo(() => [tokens.containerStyle, style], [tokens.containerStyle, style]);
   return /*#__PURE__*/_jsxs(View, {
-    style: [containerStyle, style],
-    ...(Platform.OS === 'web' ? {
+    style: containerStyleArray,
+    ...(IS_WEB ? {
       accessibilityRole: 'region'
     } : undefined),
     accessibilityLabel: undefined,
@@ -233,52 +455,59 @@ function Section({
     children: [onPress ? /*#__PURE__*/_jsx(Pressable, {
       accessibilityRole: "button",
       accessibilityLabel: undefined,
-      accessibilityHint: accessibilityHint || "Opens section details",
+      accessibilityHint: accessibilityHint || 'Opens section details',
       onPress: onPress,
-      onPressIn: e => {
-        setIsHeaderPressed(true);
-        rest?.onPressIn?.(e);
-      },
-      onPressOut: e => {
-        setIsHeaderPressed(false);
-        rest?.onPressOut?.(e);
-      },
-      onFocus: e => {
-        setIsHeaderFocused(true);
-        rest?.onFocus?.(e);
-      },
-      onBlur: e => {
-        setIsHeaderFocused(false);
-        rest?.onBlur?.(e);
-      },
-      onHoverIn: e => {
-        setIsHeaderHovered(true);
-        rest?.onHoverIn?.(e);
-      },
-      onHoverOut: e => {
-        setIsHeaderHovered(false);
-        rest?.onHoverOut?.(e);
-      },
-      style: ({
-        pressed
-      }) => [headerStyle, pressed ? headerPressedStyle : null, headerHoverStyle, headerFocusStyle],
+      onPressIn: handlePressIn,
+      onPressOut: handlePressOut,
+      onFocus: handleFocus,
+      onBlur: handleBlur,
+      onHoverIn: handleHoverIn,
+      onHoverOut: handleHoverOut,
+      unstable_pressDelay: HEADER_PRESS_DELAY,
+      style: headerStyleCallback,
       ...webProps,
       children: headerContent
     }) : /*#__PURE__*/_jsx(View, {
-      style: headerStyle,
+      style: tokens.headerStyle,
       children: headerContent
-    }), slot && slotDirection === 'row' && /*#__PURE__*/_jsx(SlotGrid, {
-      items: cloneChildrenWithModes(flattenChildren(slot), modes),
-      gap: sectionGap
-    }), slot && slotDirection === 'column' && /*#__PURE__*/_jsx(View, {
-      style: {
-        flexDirection: 'column',
-        gap: slotGap
-      },
-      children: cloneChildrenWithModes(flattenChildren(slot), modes)
+    }), slot && /*#__PURE__*/_jsx(SectionSlot, {
+      slot: slot,
+      modes: modes,
+      direction: slotDirection,
+      rowGap: tokens.sectionGap,
+      columnGap: tokens.slotGap
     })]
   });
 }
+/**
+ * Internal helper that processes the slot children once per (slot, modes) pair
+ * and dispatches to the row (SlotGrid) or column layout. Splitting this out of
+ * `Section` lets the parent re-render (e.g. for header press/hover state)
+ * without re-walking the slot tree via `cloneChildrenWithModes`.
+ */
+function SectionSlot({
+  slot,
+  modes,
+  direction,
+  rowGap,
+  columnGap
+}) {
+  const processed = useMemo(() => cloneChildrenWithModes(flattenChildren(slot), modes), [slot, modes]);
+  const columnContainerStyle = useMemo(() => ({
+    flexDirection: 'column',
+    gap: columnGap
+  }), [columnGap]);
+  if (direction === 'row') {
+    return /*#__PURE__*/_jsx(SlotGrid, {
+      items: processed,
+      gap: rowGap
+    });
+  }
+  return /*#__PURE__*/_jsx(View, {
+    style: columnContainerStyle,
+    children: processed
+  });
+}
 /**
  * Section.Bento component that mirrors the Figma "Section.Bento" component.
  *
@@ -301,30 +530,88 @@ function Section({
  * @param {string} [props.accessibilityLabel] - Accessibility label for the section
  * @param {string} [props.accessibilityHint] - Additional accessibility hint for screen readers
  */
+const sectionBentoUpiRowStyle = {
+  flexDirection: 'row',
+  gap: 8
+};
 function SectionBento({
   navSlot,
   upiSlot,
-  modes = {},
+  modes = EMPTY_MODES,
   style,
-  accessibilityLabel = undefined,
+  // Same rationale as Section: accepted on the type but unused internally.
+  accessibilityLabel: _accessibilityLabel,
   accessibilityHint,
+  collapsedCount = SLOT_GRID_MAX_COLUMNS,
+  defaultExpanded = false,
+  expanded: controlledExpanded,
+  onExpandedChange,
+  toggleMoreLabel = 'More',
+  toggleLessLabel = 'Less',
+  toggleMoreIcon = 'ic_chevron_down',
+  toggleLessIcon = 'ic_chevron_up',
+  renderToggle,
   ...rest
 }) {
-  // Resolve section container tokens
   const backgroundColor = getVariableByName('section/background/color', modes) || '#ffffff';
   const gap = getVariableByName('section/gap', modes) || 12;
   const paddingHorizontal = getVariableByName('section/padding/horizontal', modes) || 12;
   const paddingVertical = getVariableByName('section/padding/vertical', modes) || 16;
   const radius = getVariableByName('section/radius', modes) || 12;
-  const containerStyle = {
+  const containerStyle = useMemo(() => ({
     backgroundColor,
     paddingHorizontal,
     paddingVertical,
     borderRadius: radius,
     gap
-  };
-  const processedNavSlot = navSlot ? cloneChildrenWithModes(flattenChildren(navSlot), modes) : null;
-  const processedUpiSlot = upiSlot ? cloneChildrenWithModes(flattenChildren(upiSlot), modes) : null;
+  }), [backgroundColor, paddingHorizontal, paddingVertical, radius, gap]);
+  const processedNavSlot = useMemo(() => navSlot ? cloneChildrenWithModes(flattenChildren(navSlot), modes) : null, [navSlot, modes]);
+  const processedUpiSlot = useMemo(() => upiSlot ? cloneChildrenWithModes(flattenChildren(upiSlot), modes) : null, [upiSlot, modes]);
+
+  // `canExpand` is true iff there are strictly more real items than fit into
+  // the collapsed grid. When `allRealItems.length === collapsedCount` we just
+  // render them all with no toggle — identical to the pre-feature behavior.
+  const allRealItems = useMemo(() => processedNavSlot ?? [], [processedNavSlot]);
+  const canExpand = allRealItems.length > collapsedCount;
+  const isControlled = controlledExpanded !== undefined;
+  const [internalExpanded, setInternalExpanded] = useState(defaultExpanded);
+  const expanded = isControlled ? controlledExpanded : internalExpanded;
+
+  // Mirror onExpandedChange in a ref so `toggle` can stay referentially stable.
+  const onExpandedChangeRef = useRef(onExpandedChange);
+  onExpandedChangeRef.current = onExpandedChange;
+  const isControlledRef = useRef(isControlled);
+  isControlledRef.current = isControlled;
+  const expandedRef = useRef(expanded);
+  expandedRef.current = expanded;
+  const toggle = useCallback(() => {
+    const next = !expandedRef.current;
+    if (!isControlledRef.current) {
+      setInternalExpanded(next);
+    }
+    onExpandedChangeRef.current?.(next);
+  }, []);
+  const navGridItems = useMemo(() => {
+    if (!canExpand) {
+      return allRealItems;
+    }
+    // Leave the last collapsed slot for the toggle cell.
+    const visibleRealItems = expanded ? allRealItems : allRealItems.slice(0, collapsedCount - 1);
+    const toggleNode = renderToggle ? renderToggle({
+      expanded,
+      toggle
+    }) : /*#__PURE__*/_jsx(DefaultBentoToggle, {
+      expanded: expanded,
+      onPress: toggle,
+      modes: modes,
+      moreLabel: toggleMoreLabel,
+      lessLabel: toggleLessLabel,
+      moreIcon: toggleMoreIcon,
+      lessIcon: toggleLessIcon,
+      extraCount: allRealItems.length - (collapsedCount - 1)
+    });
+    return [...visibleRealItems, toggleNode];
+  }, [canExpand, allRealItems, expanded, collapsedCount, renderToggle, toggle, modes, toggleMoreLabel, toggleLessLabel, toggleMoreIcon, toggleLessIcon]);
   return /*#__PURE__*/_jsxs(View, {
     style: [containerStyle, style],
     ...(Platform.OS === 'web' ? {
@@ -333,19 +620,66 @@ function SectionBento({
     accessibilityLabel: undefined,
     accessibilityHint: accessibilityHint,
     ...rest,
-    children: [processedNavSlot && /*#__PURE__*/_jsx(SlotGrid, {
-      items: processedNavSlot,
-      gap: gap
+    children: [navGridItems.length > 0 && /*#__PURE__*/_jsx(SlotGrid, {
+      items: navGridItems,
+      gap: gap,
+      ...(canExpand ? {
+        animateExtrasFromIndex: collapsedCount,
+        animateContainerLayout: true
+      } : null)
     }), processedUpiSlot && /*#__PURE__*/_jsx(View, {
-      style: {
-        flexDirection: 'row',
-        gap: 8
-      },
+      style: sectionBentoUpiRowStyle,
       children: processedUpiSlot
     })]
   });
 }
 
+// ---------------------------------------------------------------------------
+// DefaultBentoToggle — internal toggle cell rendered by `SectionBento` when no
+// `renderToggle` prop is provided. Uses a vertical `ListItem` so the cell
+// matches the visual rhythm of the surrounding nav items in every mode.
+//
+// Two icons (`ic_chevron_down` / `ic_chevron_up`) are used instead of a
+// rotating single icon, because the toggle cell is reconciled by position
+// (collapsed: end of row 1; expanded: end of last row), so any persistent
+// shared-value-driven rotation would lose its anchor across toggles.
+// ---------------------------------------------------------------------------
+
+function DefaultBentoToggle({
+  expanded,
+  onPress,
+  modes,
+  moreLabel,
+  lessLabel,
+  moreIcon,
+  lessIcon,
+  extraCount
+}) {
+  const label = expanded ? lessLabel : moreLabel;
+  const iconName = expanded ? lessIcon : moreIcon;
+  const accessibilityState = useMemo(() => ({
+    expanded
+  }), [expanded]);
+  const webAccessibilityProps = useMemo(() => ({
+    ariaExpanded: expanded
+  }), [expanded]);
+  const accessibilityHint = expanded ? `Hides ${extraCount} additional ${extraCount === 1 ? 'action' : 'actions'}` : `Shows ${extraCount} additional ${extraCount === 1 ? 'action' : 'actions'}`;
+  return /*#__PURE__*/_jsx(ListItem, {
+    layout: "Vertical",
+    supportText: label,
+    leading: /*#__PURE__*/_jsx(IconCapsule, {
+      iconName: iconName,
+      modes: modes
+    }),
+    modes: modes,
+    onPress: onPress,
+    accessibilityLabel: label,
+    accessibilityHint: accessibilityHint,
+    accessibilityState: accessibilityState,
+    webAccessibilityProps: webAccessibilityProps
+  });
+}
+
 // Attach Bento as a property of Section using namespace pattern
 Section.Bento = SectionBento;
 export default Section;