jfs-components 0.0.63 → 0.0.64

package/src/components/Section/Section.tsx

@@ -1,7 +1,17 @@
 import React, { useState, useMemo, useRef, useCallback } from 'react'
 import { View, Text, Pressable, Platform, type StyleProp, type ViewStyle, type PressableStateCallbackType } 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, type WebAccessibilityProps } from '../../utils/web-platform-utils'
 import { EMPTY_MODES, cloneChildrenWithModes, flattenChildren } from '../../utils/react-utils'
 
@@ -22,39 +32,80 @@ const headerPressedStyle: ViewStyle = { opacity: 0.85 }
 const headerFocusStyle: ViewStyle = { borderColor: '#222', borderWidth: 1 }
 
 // ---------------------------------------------------------------------------
-// Shared grid layout: measures the widest child once per item-count, then
-// renders uniform-width cells laid out with `justify-content: space-between`.
-// This preserves three visual invariants regardless of viewport width:
+// 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).
-// Pure flex sizing (e.g. `flexBasis: 0; flexGrow: 1`) cannot satisfy (1) and
-// (2) on wide viewports — it distributes extra space inside each cell, which
-// makes the icon+label content drift toward each cell's center and produces
-// visible "dead" margins on the left and right of the grid.
 //
-// To avoid the blank-flash that the previous implementation suffered from
-// (it hid the grid with `opacity: 0` until measurement completed, and reset
-// every measurement when the item count changed):
-//   * Cells render at their *natural* widths during measurement instead of
-//     being hidden. With `space-between`, the first/last cells already hug
-//     the edges; only the column alignment can be off by a few pixels for
-//     the single frame between mount and the onLayout callback.
-//   * On item-count change (e.g. expand / collapse), we clear the per-cell
-//     samples but keep the rendered layout visible — we never blank out.
-//   * No 500ms safety timeout is needed because the grid is visible from the
-//     first frame.
+// 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.
 // ---------------------------------------------------------------------------
 const SLOT_GRID_MAX_COLUMNS = 4
 
+// 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
+
 type SlotGridProps = {
   items: React.ReactNode[];
   gap: number;
   maxColumns?: number;
+  /**
+   * If set, cells whose index is `>= animateExtrasFromIndex` are wrapped in
+   * `Animated.View` with staggered FadeInUp/FadeOutUp builders so that they
+   * fade in (and reverse-fade out) when they mount or unmount. Cells below
+   * this threshold render as plain `<View>` and are unaffected.
+   */
+  animateExtrasFromIndex?: number;
+  /**
+   * If true, the rows container animates its height via an explicit
+   * `useSharedValue` + `withSpring` driven by `onLayout` measurements of the
+   * inner content (with `overflow: 'hidden'` to clip mid-animation). Cells
+   * inside always render at their natural size — they are *never* resized
+   * during the transition. Default false.
+   */
+  animateContainerLayout?: boolean;
 }
 
-const slotGridRowStyle: ViewStyle = {
+const slotGridRowFlowStyle: ViewStyle = {
   flexDirection: 'row',
   justifyContent: 'space-between',
 }
@@ -63,53 +114,42 @@ const SlotGrid = React.memo(function SlotGrid({
   items,
   gap,
   maxColumns = SLOT_GRID_MAX_COLUMNS,
+  animateExtrasFromIndex,
+  animateContainerLayout,
 }: SlotGridProps) {
   const totalItems = items.length
-
-  const [maxItemWidth, setMaxItemWidth] = useState<number | null>(null)
-  // Tracks the item-count that `maxItemWidth` corresponds to. When the
-  // current `totalItems` differs, the existing measurement is considered
-  // stale and cells fall back to natural widths until remeasurement.
-  const [measuredForCount, setMeasuredForCount] = useState(0)
-  const itemWidthsRef = useRef<Map<number, number>>(new Map())
-
-  // Synchronously invalidate per-cell samples when the item count changes
-  // (e.g. show more / less). We deliberately do NOT touch `maxItemWidth` or
-  // `measuredForCount` state here — flipping them would force an extra render
-  // pass; instead we let the count mismatch (`measuredForCount !== totalItems`)
-  // gate the use of the stale value, and the next onLayout cycle will publish
-  // a fresh `maxItemWidth` for the new count.
-  const prevTotalRef = useRef(totalItems)
-  if (prevTotalRef.current !== totalItems) {
-    prevTotalRef.current = totalItems
-    itemWidthsRef.current = new Map()
-  }
-
-  const handleItemLayout = useCallback(
+  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<number | null>(null)
+  const firstRowWidthsRef = useRef<Map<number, number>>(new Map())
+  const handleFirstRowItemLayout = useCallback(
     (index: number, width: number) => {
-      const widths = itemWidthsRef.current
+      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 >= totalItems && totalItems > 0) {
+      if (widths.size >= firstRowSize && firstRowSize > 0) {
         let newMax = 0
         for (const w of widths.values()) {
           if (w > newMax) newMax = w
         }
-        setMaxItemWidth((prev) =>
+        setFirstRowMaxWidth((prev) =>
           prev !== null && Math.abs(prev - newMax) < 0.5 ? prev : newMax
         )
-        setMeasuredForCount(totalItems)
       }
     },
-    [totalItems]
+    [firstRowSize]
   )
 
-  const hasFreshMeasurement =
-    maxItemWidth !== null && measuredForCount === totalItems
-  const cellWidth = hasFreshMeasurement ? maxItemWidth : undefined
-
-  const columns = Math.min(maxColumns, totalItems || 1)
+  const cellWidth = firstRowMaxWidth
 
   const rows: React.ReactNode[][] = []
   for (let i = 0; i < items.length; i += columns) {
@@ -117,52 +157,173 @@ const SlotGrid = React.memo(function SlotGrid({
   }
 
   const containerStyle = useMemo<ViewStyle>(() => ({ gap }), [gap])
-  const measuredCellStyle = useMemo<ViewStyle | undefined>(
-    () => (cellWidth !== undefined ? { width: cellWidth } : undefined),
+  const cellStyle = useMemo<ViewStyle | undefined>(
+    () => (cellWidth !== null ? { width: cellWidth } : undefined),
     [cellWidth]
   )
 
-  return (
-    <View style={containerStyle}>
+  // `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 as number)
+    : 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<number>(-1)
+  const isFirstHeightLayoutRef = useRef(true)
+  const handleContentLayout = useCallback(
+    (e: { nativeEvent: { layout: { height: number } } }) => {
+      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' as const }
+  )
+
+  const rowsChildren = (
+    <>
       {rows.map((row, rowIndex) => {
         const spacersNeeded = row.length < columns ? columns - row.length : 0
         return (
-          <View key={rowIndex} style={slotGridRowStyle}>
+          <View key={rowIndex} style={rowStyle}>
             {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: { nativeEvent: { layout: { width: number } } }) =>
+                      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 (
+                  <Animated.View
+                    key={itemIndex}
+                    entering={entering}
+                    exiting={exiting}
+                    {...(onLayoutHandler ? { onLayout: onLayoutHandler } : null)}
+                    style={cellStyle}
+                  >
+                    {child}
+                  </Animated.View>
+                )
+              }
+
               return (
                 <View
                   key={itemIndex}
-                  onLayout={
-                    hasFreshMeasurement
-                      ? undefined
-                      : (e) =>
-                          handleItemLayout(
-                            itemIndex,
-                            e.nativeEvent.layout.width
-                          )
-                  }
-                  style={measuredCellStyle}
+                  {...(onLayoutHandler ? { onLayout: onLayoutHandler } : null)}
+                  style={cellStyle}
                 >
                   {child}
                 </View>
               )
             })}
-            {hasFreshMeasurement &&
+            {cellWidth !== null &&
               spacersNeeded > 0 &&
               Array.from({ length: spacersNeeded }, (_, i) => (
-                <View key={`spacer-${i}`} style={measuredCellStyle} />
+                <View key={`spacer-${i}`} style={cellStyle} />
               ))}
           </View>
         )
       })}
-    </View>
+    </>
   )
+
+  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 (
+      <Animated.View style={animatedHeightStyle}>
+        <View style={containerStyle} onLayout={handleContentLayout}>
+          {rowsChildren}
+        </View>
+      </Animated.View>
+    )
+  }
+
+  return <View style={containerStyle}>{rowsChildren}</View>
 }, slotGridPropsAreEqual)
 
 function slotGridPropsAreEqual(prev: SlotGridProps, next: SlotGridProps) {
   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++) {
@@ -481,6 +642,11 @@ function SectionSlot({ slot, modes, direction, rowGap, columnGap }: SectionSlotP
   return <View style={columnContainerStyle}>{processed}</View>
 }
 
+type BentoToggleRenderState = {
+  expanded: boolean;
+  toggle: () => void;
+}
+
 type SectionBentoProps = {
   navSlot?: React.ReactNode;
   upiSlot?: React.ReactNode;
@@ -492,6 +658,43 @@ type SectionBentoProps = {
    * Web-specific accessibility props (only used on web platform)
    */
   webAccessibilityProps?: WebAccessibilityProps;
+  /**
+   * Total cell count visible when collapsed (real items + the toggle cell).
+   * Defaults to {@link SLOT_GRID_MAX_COLUMNS} (4) so the collapsed state fills
+   * exactly one row. When `navSlot.length <= collapsedCount`, expansion is
+   * disabled (no toggle injected, no animation wrappers — identical to the
+   * legacy behavior for back-compat).
+   */
+  collapsedCount?: number;
+  /**
+   * Uncontrolled initial expanded state. Ignored when `expanded` is provided.
+   * Defaults to `false`.
+   */
+  defaultExpanded?: boolean;
+  /**
+   * Controlled expanded state. When provided, `onExpandedChange` should also
+   * be provided so the component can request changes.
+   */
+  expanded?: boolean;
+  /**
+   * Called when the user taps the toggle. Required in controlled mode; ignored
+   * in uncontrolled mode unless you want to observe the change.
+   */
+  onExpandedChange?: (next: boolean) => void;
+  /** Label shown on the toggle cell when collapsed. Default `'More'`. */
+  toggleMoreLabel?: string;
+  /** Label shown on the toggle cell when expanded. Default `'Less'`. */
+  toggleLessLabel?: string;
+  /** Icon name shown on the toggle when collapsed. Default `'ic_chevron_down'`. */
+  toggleMoreIcon?: string;
+  /** Icon name shown on the toggle when expanded. Default `'ic_chevron_up'`. */
+  toggleLessIcon?: string;
+  /**
+   * Escape hatch: render a custom toggle cell instead of the default ListItem.
+   * The provided node is rendered in the toggle's grid slot. Wire `toggle()` to
+   * any tap interaction inside it. Height + per-cell animations still apply.
+   */
+  renderToggle?: (state: BentoToggleRenderState) => React.ReactNode;
 } & React.ComponentProps<typeof View>;
 
 /**
@@ -526,9 +729,17 @@ function SectionBento({
   // 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
 }: SectionBentoProps) {
-  // 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
@@ -556,6 +767,71 @@ function SectionBento({
     [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<boolean>(defaultExpanded)
+  const expanded = isControlled ? (controlledExpanded as boolean) : 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<React.ReactNode[]>(() => {
+    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 })
+      : (
+        <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 (
     <View
       style={[containerStyle, style]}
@@ -564,10 +840,16 @@ function SectionBento({
       accessibilityHint={accessibilityHint}
       {...rest}
     >
-      {processedNavSlot && (
+      {navGridItems.length > 0 && (
         <SlotGrid
-          items={processedNavSlot as React.ReactNode[]}
+          items={navGridItems}
           gap={gap}
+          {...(canExpand
+            ? {
+                animateExtrasFromIndex: collapsedCount,
+                animateContainerLayout: true,
+              }
+            : null)}
         />
       )}
       {processedUpiSlot && (
@@ -579,6 +861,64 @@ function SectionBento({
   )
 }
 
+// ---------------------------------------------------------------------------
+// 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.
+// ---------------------------------------------------------------------------
+type DefaultBentoToggleProps = {
+  expanded: boolean;
+  onPress: () => void;
+  modes: Record<string, any>;
+  moreLabel: string;
+  lessLabel: string;
+  moreIcon: string;
+  lessIcon: string;
+  /** How many additional actions become visible when expanding. Used in the a11y hint. */
+  extraCount: number;
+}
+
+function DefaultBentoToggle({
+  expanded,
+  onPress,
+  modes,
+  moreLabel,
+  lessLabel,
+  moreIcon,
+  lessIcon,
+  extraCount,
+}: DefaultBentoToggleProps) {
+  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 (
+    <ListItem
+      layout="Vertical"
+      supportText={label}
+      leading={<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
 

package/src/icons/registry.ts

@@ -4,7 +4,7 @@
  * Auto-generated from SVG files in src/icons/
  * DO NOT EDIT MANUALLY - Run "npm run icons:generate" to regenerate
  * 
- * Generated: 2026-04-20T08:18:55.051Z
+ * Generated: 2026-04-20T20:41:14.535Z
  */
 
 // Icon name to SVG data mapping