jfs-components 0.0.74 → 0.0.78

package/CHANGELOG.md

@@ -4,6 +4,115 @@ All notable changes to this project are documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
+## [0.0.78] - 2026-05-29
+
+- Added `ExpandableCheckbox` — checkbox row with collapsible long label and Read more / Read less toggle.
+- Added `FullscreenModal` — full-screen modal with parallax hero, close button, disclaimer, and action footer slots.
+- Added `MessageField` — multi-line textarea with FormField States (Idle / Active / Read Only / Error / Disabled) and Form context integration.
+- Added `SuggestiveSearch` — search input with inline suggestion dropdown.
+- `Accordion` — new `contained` variant and hover state handling.
+- `NavArrow` — pressable when `onPress` is provided; 44 pt touch target.
+- `Checkbox` — 44 pt touch target; checkmark rendered inside the box view.
+- `FormField` / `TextInput` — tap anywhere in the input row to focus on first tap (Android double-tap fix).
+- `ActionFooter` — Android keyboard counter-shift so the footer stays behind the keyboard instead of jumping up.
+- `ListItem` — title/support text use `AppearanceBrand: 'Neutral'` without forcing it onto slot children.
+- `Stepper` / `Step` / `StepLabel` — `showLine`, `metaText`, `meta` props; larger indicator sizing; public type exports.
+- `Title` — line-height clamp to prevent descender clipping on Android.
+
+---
+
+## [0.0.77] - 2026-05-25
+
+### Added
+
+- **Skeleton / shimmer loading system** — new `src/skeleton/` module exported from the package root. One context provider (`<SkeletonGroup loading>`) flips an entire subtree into shape-preserving placeholders. The following primitives auto-skeletonize when inside an active group: `Text`, `Image`, `Badge`, `Button`, `IconButton`, `Avatar`, and `Icon`. Each one also accepts a per-instance `loading?: boolean` override. The atomic `<Skeleton kind="text|image|badge|other" width height />` block is available for non-primitive layouts. Honours `prefers-reduced-motion` automatically; one Reanimated clock per group; gradient angle locked to 135° on any aspect ratio.
+- **`LottiePlayer`** — new component that renders Lottie animations using `lottie-react-native` (native) and `lottie-react` (web) via platform extensions (`LottiePlayer.web.tsx`). Both libraries are declared as **optional peer dependencies**, so installing `jfs-components` does not pull them in. Sizing is token-driven via `media/width` / `media/height` (`Media / Output` mode → `L | M | S` = `117 / 70 / 20`) — same contract `PageHero` and `LottieIntroBlock` already use for their media slots.
+- New on-device dev-client scaffold under `example/` (Expo dev client + Storybook + Playground host), with its native deps pinned independently from the library.
+
+### Changed
+
+- `ActionFooter` rewritten (~240 lines): `IconButton` children keep their intrinsic square size, every other child is auto-stretched to share the remaining horizontal space; modes now propagate to all slot children via `cloneChildrenWithModes`.
+- `PageHero` API expansion (+65 lines): improved Figma alignment, new examples in stories/MDX.
+- `RechargeCard` re-aligned to Figma node `2235:937`: container now draws the `rechargeCard/strokeWidth` + `rechargeCard/stroke/color` border, fallback colors for title/spec/disclaimer reset to `#000000`, `minWidth` falls back to `312`, and background fallback is now `#ffffff`. Hardcoded label/style overrides removed — colors come purely from tokens.
+- `RechargeCard` now ships sensible slot mode defaults (overridable via the consumer's `modes` prop):
+  - inner `MoneyValue` defaults to `Context3: 'Balance & Cards'` (36 px / 900-weight Figma scale).
+  - inner `ButtonGroup` defaults to `AppearanceBrand: 'Secondary'`, `Button / Size: 'S'`, `Emphasis: 'High'`. The previous typo (`Appearance.Brand`) is fixed to match the actual `AppearanceBrand` collection, and defaults are spread *before* `modes` so any key can be overridden externally.
+- Figma/token sync pass across `ActionFooter`, `DropdownInput`, `FormField`, `HStack`, `InputSearch`, `Nudge`, `Section`, `Stepper/StepLabel`, `SupportText/SupportTextIcon`, `VStack`, plus refreshed Coin Variables tokens, `.token-metadata.json`, and icons registry.
+- Storybook config: babel-transpile `storybook-assets/` alongside `src/` so Lottie + platform-extension demo files resolve cleanly; `tsconfig.build.json` now excludes `storybook-assets/`.
+
+### Library usage notes
+
+#### Lottie animations
+
+`LottiePlayer` is the only Lottie surface — `lottie-react-native` / `lottie-react` are optional peers and must be installed by the consumer:
+
+```sh
+# React Native (iOS / Android)
+npm install lottie-react-native
+cd ios && pod install
+
+# Web (or react-native-web)
+npm install lottie-react
+```
+
+Then pass a **parsed JSON object** (URI sources are intentionally not supported — web players need data pre-parsed):
+
+```tsx
+import { LottiePlayer, PageHero, LottieIntroBlock } from 'jfs-components'
+import animation from './assets/loader.json'
+
+<LottiePlayer source={animation} />                          // 117×117 (default)
+<LottiePlayer source={animation} size={70} />                // explicit size
+<LottiePlayer source={animation} modes={{ 'Media / Output': 'S' }} /> // 20×20 via token
+<PageHero media={<LottiePlayer source={animation} />} />     // any media slot
+<LottieIntroBlock mediaSlot={<LottiePlayer source={animation} />} />
+```
+
+#### Skeleton / shimmer loading
+
+Wrap any subtree in `<SkeletonGroup loading={!data}>` — **no other changes to the screen are required**. All instrumented JFS primitives inside (`Text`, `Image`, `Badge`, `Button`, `IconButton`, `Avatar`, `Icon`) automatically swap themselves for a shape-preserving shimmer placeholder while `loading` is `true`, and revert to their real content when it flips to `false`. Layout never jumps because the placeholder reuses the same measured box as the real element.
+
+```tsx
+import { SkeletonGroup, Card, Image, Text, Badge, Button } from 'jfs-components'
+
+function Profile({ user }) {
+  return (
+    <SkeletonGroup loading={!user}>
+      <Card media={<Image imageSource={user?.cover} ratio={16 / 9} />}>
+        <Card.Title>{user?.name}</Card.Title>
+        <Card.SupportText>{user?.role}</Card.SupportText>
+        <Badge label={user?.tier ?? 'Member'} />
+        <Button label="Follow" />
+      </Card>
+    </SkeletonGroup>
+  )
+}
+```
+
+Two escape hatches when the auto-instrumentation isn't enough:
+
+```tsx
+// 1) Bind a single primitive to its own load event, ignoring the group:
+<Image imageSource={uri} ratio={16/9} loading={!loaded} onLoad={() => setLoaded(true)} />
+
+// 2) Drop in atomic <Skeleton/> blocks for layouts not built on JFS primitives.
+//    Inside an active <SkeletonGroup> they shimmer with the same clock; outside one they render nothing.
+import { Skeleton } from 'jfs-components'
+<SkeletonGroup loading>
+  <View style={{ flexDirection: 'row', gap: 12 }}>
+    <Skeleton kind="other" width={48} height={48} />
+    <View style={{ flex: 1, gap: 6 }}>
+      <Skeleton kind="text" width="80%" height={16} />
+      <Skeleton kind="text" width="60%" height={14} />
+    </View>
+  </View>
+</SkeletonGroup>
+```
+
+Reduced motion is auto-detected from the OS (`AccessibilityInfo` on native, `prefers-reduced-motion` on web); override via `<SkeletonGroup reducedMotion>` for testing or forced behaviour.
+
+---
+
 ## [0.0.74] - 2026-05-19
 
 - Added new account and onboarding components: `AccountCard` (connected/add variants), `PageHero`, `LottieIntroBlock`, and `PoweredByLabel`.

package/lib/commonjs/components/Accordion/Accordion.js

@@ -17,34 +17,45 @@ function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r
 if (_reactNative.Platform.OS === 'android' && _reactNative.UIManager.setLayoutAnimationEnabledExperimental) {
   _reactNative.UIManager.setLayoutAnimationEnabledExperimental(true);
 }
+function resolveAccordionStateMode(disabled, isExpanded, isHovered, contained) {
+  if (disabled) return 'Disabled';
+  if (contained) {
+    return isExpanded ? 'Open Hover' : 'Hover';
+  }
+  if (isExpanded) {
+    return isHovered ? 'Open Hover' : 'Open';
+  }
+  return isHovered ? 'Hover' : 'Idle';
+}
+function toFontWeight(value, fallback) {
+  if (typeof value === 'number') return String(value);
+  if (typeof value === 'string') {
+    const normalized = value.trim().toLowerCase();
+    if (normalized === 'bold') return '700';
+    if (normalized === 'medium') return '500';
+    if (normalized === 'regular' || normalized === 'normal') return '400';
+    if (/^\d+$/.test(normalized)) return normalized;
+    return value;
+  }
+  return fallback;
+}
 /**
  * Accordion component that mirrors the Figma "Accordion" component.
  *
- * This component supports:
- *  - **Expandable/collapsible content** with smooth animation
- *  - **States**: Idle, Hover, Open, Disabled
- *  - **Slot** for custom content
- *  - **Design-token driven styling** via `getVariableByName` and `modes`
+ * Supports two visual treatments via the `contained` prop:
+ *  - **`contained={false}`** (default) — transparent header at rest; filled
+ *    background on hover / press.
+ *  - **`contained={true}`** — header always uses the filled background.
  *
- * Wherever the Figma layer name contains "Slot", this component exposes a
- * dedicated React "slot" prop:
- *  - Slot "content" → `children`
+ * Interaction states (Idle, Hover, Open, Disabled) are resolved automatically
+ * from `expanded`, `disabled`, hover, and `contained` — consumers should not
+ * pass `'Accordion States'` in `modes`.
  *
  * @component
- * @param {Object} props
- * @param {string} [props.title='Accordion title'] - The accordion header title
- * @param {boolean} [props.defaultExpanded=false] - Initial expanded state
- * @param {boolean} [props.expanded] - Controlled expanded state
- * @param {Function} [props.onExpandedChange] - Callback fired when expanded state changes
- * @param {boolean} [props.disabled=false] - Whether the accordion is disabled
- * @param {React.ReactNode} [props.children] - Content to display when expanded
- * @param {Object} [props.modes={}] - Modes object passed to `getVariableByName` for all design tokens
- * @param {Object} [props.style] - Optional container style overrides
- * @param {string} [props.accessibilityLabel] - Accessibility label for the accordion. If not provided, uses title
- * @param {string} [props.accessibilityHint] - Additional accessibility hint for screen readers
  */
 function Accordion({
   title = 'Accordion title',
+  contained = false,
   defaultExpanded = false,
   expanded: controlledExpanded,
   onExpandedChange,
@@ -58,21 +69,19 @@ function Accordion({
   webAccessibilityProps,
   ...rest
 }) {
-  // Internal state for uncontrolled mode
   const [internalExpanded, setInternalExpanded] = (0, _react.useState)(defaultExpanded);
-
-  // Determine if controlled or uncontrolled
+  const [isHovered, setIsHovered] = (0, _react.useState)(false);
   const isControlled = controlledExpanded !== undefined;
   const isExpanded = isControlled ? controlledExpanded : internalExpanded;
-
-  // Hover state for web
-  const [isHovered, setIsHovered] = (0, _react.useState)(false);
-
-  // Handle toggle
+  const resolvedModes = (0, _react.useMemo)(() => {
+    const accordionState = resolveAccordionStateMode(disabled, isExpanded, isHovered, contained);
+    return {
+      ...modes,
+      'Accordion States': accordionState
+    };
+  }, [contained, disabled, isExpanded, isHovered, modes]);
   const handleToggle = () => {
     if (disabled) return;
-
-    // Animate the layout change
     _reactNative.LayoutAnimation.configureNext(_reactNative.LayoutAnimation.Presets.easeInEaseOut);
     if (isControlled) {
       onExpandedChange?.(!isExpanded);
@@ -81,23 +90,20 @@ function Accordion({
       onExpandedChange?.(!isExpanded);
     }
   };
-
-  // Resolve design tokens
-  const titleColor = disabled ? '#999999' : (0, _figmaVariablesResolver.getVariableByName)('accordion/title/color', modes) || '#0d0d0d';
-  const titleFontSize = (0, _figmaVariablesResolver.getVariableByName)('accordion/title/fontSize', modes) || 18;
-  const titleLineHeight = (0, _figmaVariablesResolver.getVariableByName)('accordion/title/lineHeight', modes) || 20;
-  const titleFontFamily = (0, _figmaVariablesResolver.getVariableByName)('accordion/title/fontFamily', modes) || 'System';
-  const iconColor = (0, _figmaVariablesResolver.getVariableByName)('accordion/icon/color', modes) || '#141414';
-  const iconSize = (0, _figmaVariablesResolver.getVariableByName)('accordion/icon/size', modes) || 24;
-  const headerGap = (0, _figmaVariablesResolver.getVariableByName)('accordion/header/gap', modes) || 12;
-  const headerPaddingVertical = (0, _figmaVariablesResolver.getVariableByName)('accordion/header/padding/vertical', modes) || 24;
-  const headerBackground = isHovered && !disabled ? '#f2f2f2' : (0, _figmaVariablesResolver.getVariableByName)('accordion/header/background', modes) || 'transparent';
-  const contentGap = (0, _figmaVariablesResolver.getVariableByName)('accordion/content/gap', modes) || 12;
-  const contentPaddingTop = (0, _figmaVariablesResolver.getVariableByName)('accordion/content/padding/top', modes) || 8;
-  const contentPaddingBottom = isExpanded ? (0, _figmaVariablesResolver.getVariableByName)('accordion/content/padding/bottom', modes) ?? 24 : 8;
-  const borderColor = (0, _figmaVariablesResolver.getVariableByName)('accordion/border/color', modes) || '#e6e6e6';
-
-  // Styles
+  const titleColor = (0, _figmaVariablesResolver.getVariableByName)('accordion/title/color', resolvedModes) ?? '#0d0d0d';
+  const titleFontSize = (0, _figmaVariablesResolver.getVariableByName)('accordion/title/fontSize', resolvedModes) ?? 14;
+  const titleLineHeight = (0, _figmaVariablesResolver.getVariableByName)('accordion/title/lineHeight', resolvedModes) ?? 20;
+  const titleFontFamily = (0, _figmaVariablesResolver.getVariableByName)('accordion/title/fontFamily', resolvedModes) ?? 'System';
+  const titleFontWeight = toFontWeight((0, _figmaVariablesResolver.getVariableByName)('accordion/title/fontWeight', resolvedModes), '700');
+  const iconColor = (0, _figmaVariablesResolver.getVariableByName)('accordion/icon/color', resolvedModes) ?? '#141414';
+  const iconSize = (0, _figmaVariablesResolver.getVariableByName)('accordion/icon/size', resolvedModes) ?? 24;
+  const headerGap = (0, _figmaVariablesResolver.getVariableByName)('accordion/header/gap', resolvedModes) ?? 12;
+  const headerPaddingVertical = (0, _figmaVariablesResolver.getVariableByName)('accordion/header/padding/vertical', resolvedModes) ?? 8;
+  const headerBackground = (0, _figmaVariablesResolver.getVariableByName)('accordion/header/background', resolvedModes) ?? 'transparent';
+  const contentGap = (0, _figmaVariablesResolver.getVariableByName)('accordion/content/gap', resolvedModes) ?? 12;
+  const contentPaddingTop = (0, _figmaVariablesResolver.getVariableByName)('accordion/content/padding/top', resolvedModes) ?? 8;
+  const contentPaddingBottom = (0, _figmaVariablesResolver.getVariableByName)('accordion/content/padding/bottom', resolvedModes) ?? 8;
+  const borderColor = (0, _figmaVariablesResolver.getVariableByName)('accordion/border/color', resolvedModes) ?? '#e6e6e6';
   const containerStyle = {
     borderBottomWidth: 1,
     borderBottomColor: borderColor
@@ -117,7 +123,7 @@ function Accordion({
     fontSize: titleFontSize,
     lineHeight: titleLineHeight,
     fontFamily: titleFontFamily,
-    fontWeight: '700'
+    fontWeight: titleFontWeight
   };
   const contentStyle = {
     backgroundColor: 'transparent',
@@ -127,11 +133,7 @@ function Accordion({
     paddingHorizontal: 0,
     overflow: 'hidden'
   };
-
-  // Generate default accessibility label
   const defaultAccessibilityLabel = accessibilityLabel || title;
-
-  // Web platform support
   const webProps = (0, _webPlatformUtils.usePressableWebSupport)({
     restProps: {},
     onPress: handleToggle,
@@ -139,9 +141,7 @@ function Accordion({
     accessibilityLabel: defaultAccessibilityLabel,
     webAccessibilityProps
   });
-
-  // Process children to pass modes
-  const processedChildren = children ? (0, _reactUtils.cloneChildrenWithModes)(_react.default.Children.toArray(children), modes) : null;
+  const processedChildren = children ? (0, _reactUtils.cloneChildrenWithModes)(_react.default.Children.toArray(children), resolvedModes) : null;
   return /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.View, {
     style: [containerStyle, style],
     ...rest,
@@ -171,7 +171,7 @@ function Accordion({
       }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_Icon.default, {
         name: isExpanded ? 'ic_minus' : 'ic_add',
         size: iconSize,
-        color: disabled ? '#999999' : iconColor,
+        color: iconColor,
         accessibilityElementsHidden: true,
         importantForAccessibility: "no"
       })]

package/lib/commonjs/components/ActionFooter/ActionFooter.js

@@ -4,37 +4,104 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.default = void 0;
-var _react = _interopRequireDefault(require("react"));
+var _react = _interopRequireWildcard(require("react"));
 var _reactNative = require("react-native");
 var _figmaVariablesResolver = require("../../design-tokens/figma-variables-resolver");
 var _reactUtils = require("../../utils/react-utils");
 var _IconButton = _interopRequireDefault(require("../IconButton/IconButton"));
 var _jsxRuntime = require("react/jsx-runtime");
 function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
+const IS_WEB = _reactNative.Platform.OS === 'web';
+
+// ---------------------------------------------------------------------------
+// Yoga-safe stretch
+// ---------------------------------------------------------------------------
+//
+// React Native (Yoga) interprets the `flex: 1` shorthand as
+//   { flexGrow: 1, flexShrink: 1, flexBasis: 0 }
+// which is the *equal-share* variant. That is the correct math for what we
+// want here (equal-width action buttons), BUT Yoga has a well-known foot-gun
+// when this child sits inside a parent whose main-axis size hasn't been
+// resolved yet on the first layout pass: the child collapses to 0 and the
+// inner text gets clipped to "" before the parent ever measures.
+//
+// The defensive incantation used elsewhere in this codebase (see
+// `CardCTA.leftWrap` and the `MediaCard.Header` fix in CHANGELOG.md) is to
+// keep the equal-share math but explicitly clamp `minWidth` to 0 so Yoga
+// always allows the child to participate in the shrink algorithm, even when
+// the parent itself is in an undetermined state. Combined with explicit
+// `flexGrow`/`flexShrink`/`flexBasis` (NOT the `flex` shorthand) this
+// renders correctly on iOS, Android, and Web — and crucially never produces
+// the "buttons render as empty pills" failure mode the previous version had
+// on iOS dev clients.
+const STRETCH_STYLE = {
+  flexGrow: 1,
+  flexShrink: 1,
+  flexBasis: 0,
+  minWidth: 0
+};
+
+// Platform-specific drop shadow. Web boxShadow can't go through
+// Platform.select (RN's typed surface doesn't include it) so we keep it as a
+// separate constant and append it below.
+const NATIVE_SHADOW = _reactNative.Platform.select({
+  ios: {
+    shadowColor: '#0c0d10',
+    shadowOffset: {
+      width: 0,
+      height: -12
+    },
+    shadowOpacity: 0.16,
+    shadowRadius: 24
+  },
+  android: {
+    elevation: 16
+  },
+  default: {}
+});
+const WEB_SHADOW = IS_WEB ? {
+  boxShadow: '0px -12px 24px 0px rgba(12, 13, 16, 0.12), 0px -16px 48px 0px rgba(12, 13, 16, 0.16)'
+} : null;
+
+// The runtime token a slot child must equal (by reference) to be treated as
+// an IconButton. `IconButton` is exported wrapped in `React.memo`, so the
+// element.type identity comparison works for both `<IconButton />` from the
+// same module and any `React.memo`-wrapped re-export. The fallback check
+// (`type.type === IconButton`) catches one extra layer of `forwardRef` /
+// `memo` wrapping which can happen when consumers re-export the component.
+function isIconButtonElement(element) {
+  const t = element.type;
+  if (t === _IconButton.default) return true;
+  if (t && typeof t === 'object' && t.type === _IconButton.default) return true;
+  return false;
+}
+
 /**
- * ActionFooter component that provides a fixed footer container for action buttons.
- * 
- * This component is designed to hold action items like IconButton and Button components
- * at the bottom of a screen. It includes a shadow for visual separation from content above.
- * 
- * The `modes` prop is automatically passed to all slot children. If a child has its own
- * `modes` prop, it will be merged with the parent's modes (child modes take precedence).
- * 
- * @component
- * @param {Object} props - Component props
- * @param {React.ReactNode} [props.children] - Action elements to display (e.g., IconButton, Button)
- * @param {Object} [props.modes={}] - Mode configuration for design tokens (automatically passed to children)
- * @param {Object} [props.style] - Optional style overrides
- * @param {string} [props.accessibilityLabel] - Accessibility label for the footer region
- * 
+ * ActionFooter — a sticky bottom container for primary screen actions.
+ *
+ * Layout contract:
+ *   - The outer container stretches horizontally (`alignSelf: 'stretch'`) so
+ *     it fills the parent regardless of whether the parent is a flex column,
+ *     a ScrollView contentContainer, or a plain View.
+ *   - The inner slot is a single row sized by its tallest child. It does NOT
+ *     use `flex: 1` — that previously caused the row to collapse to zero on
+ *     the first Yoga pass on native, taking the button labels with it.
+ *   - `IconButton` children keep their intrinsic square size.
+ *   - Every other child is auto-stretched with the Yoga-safe stretch style
+ *     above so two `<Button>` siblings render at equal width on iOS, Android,
+ *     and Web.
+ *
+ * The `modes` prop is automatically pushed down to every slot child via
+ * {@link cloneChildrenWithModes}; explicit child-level modes win over the
+ * parent's modes.
+ *
  * @example
  * ```tsx
- * // Basic usage - modes are automatically passed to all children.
- * // Non-IconButton children (e.g., Button) are auto-stretched to fill.
  * <ActionFooter modes={modes}>
  *   <IconButton iconName="ic_split" />
- *   <Button label="Request" />
- *   <Button label="Pay" />
+ *   <Button label="Request" modes={{ AppearanceBrand: 'Secondary' }} />
+ *   <Button label="Pay" modes={{ AppearanceBrand: 'Primary' }} />
  * </ActionFooter>
  * ```
  */
@@ -42,76 +109,120 @@ function ActionFooter({
   children,
   modes = _reactUtils.EMPTY_MODES,
   style,
-  accessibilityLabel = undefined
+  accessibilityLabel
 }) {
-  // Resolve design tokens
-  const backgroundColor = (0, _figmaVariablesResolver.getVariableByName)('actionFooter/background', modes) ?? '#ffffff';
-  const gap = (0, _figmaVariablesResolver.getVariableByName)('actionFooter/gap', modes) ?? 8;
-  const paddingHorizontal = (0, _figmaVariablesResolver.getVariableByName)('actionFooter/padding/horizontal', modes) ?? 16;
-  const paddingTop = (0, _figmaVariablesResolver.getVariableByName)('actionFooter/padding/top', modes) ?? 10;
-  const paddingBottom = (0, _figmaVariablesResolver.getVariableByName)('actionFooter/padding/bottom', modes) ?? 41;
-
-  // Shadow styles - cross-platform
-  const shadowStyle = _reactNative.Platform.select({
-    ios: {
-      shadowColor: 'rgba(12, 13, 16, 1)',
-      shadowOffset: {
-        width: 0,
-        height: -12
-      },
-      shadowOpacity: 0.16,
-      shadowRadius: 24
-    },
-    android: {
-      elevation: 16
-    },
-    default: {
-      // Web shadow using boxShadow (RNW supports this)
-    }
-  });
-  const containerStyle = {
-    backgroundColor,
-    paddingLeft: paddingHorizontal,
-    paddingRight: paddingHorizontal,
-    paddingTop,
-    paddingBottom,
-    ...shadowStyle
-  };
-
-  // Slot container style for horizontal layout of action items
-  const slotStyle = {
-    flexDirection: 'row',
-    alignItems: 'flex-start',
-    gap,
-    flex: 1
-  };
+  // -------------------------------------------------------------------------
+  // Keep the footer locked in place behind the software keyboard (Android).
+  // -------------------------------------------------------------------------
+  //
+  // The Android activity is configured with `windowSoftInputMode="adjustResize"`,
+  // which shrinks the app window by the keyboard height when the keyboard
+  // opens. A bottom-anchored footer therefore gets lifted UP by the keyboard
+  // height — exactly the jump the design does not want.
+  //
+  // To counteract that, we translate the footer back DOWN by the same keyboard
+  // height so it visually stays exactly where it was (now sitting behind the
+  // keyboard). iOS does not resize the window for the keyboard, so the footer
+  // already stays put there; we only run this on Android to avoid pushing the
+  // footer off-screen on platforms that don't lift it in the first place.
+  const keyboardOffset = (0, _react.useRef)(new _reactNative.Animated.Value(0)).current;
+  (0, _react.useEffect)(() => {
+    if (_reactNative.Platform.OS !== 'android') return undefined;
+    const animateTo = (toValue, duration) => {
+      _reactNative.Animated.timing(keyboardOffset, {
+        toValue,
+        // Match the OS keyboard animation so the resize and our counter-shift
+        // cancel out smoothly with no visible footer movement.
+        duration: typeof duration === 'number' && duration > 0 ? duration : 150,
+        useNativeDriver: true
+      }).start();
+    };
+    const showSub = _reactNative.Keyboard.addListener('keyboardDidShow', e => {
+      animateTo(e?.endCoordinates?.height ?? 0, e?.duration);
+    });
+    const hideSub = _reactNative.Keyboard.addListener('keyboardDidHide', e => {
+      animateTo(0, e?.duration);
+    });
+    return () => {
+      showSub.remove();
+      hideSub.remove();
+    };
+  }, [keyboardOffset]);
 
-  // Web-specific box-shadow
-  const webShadow = _reactNative.Platform.OS === 'web' ? {
-    boxShadow: '0px -12px 24px 0px rgba(12, 13, 16, 0.12), 0px -16px 48px 0px rgba(12, 13, 16, 0.16)'
-  } : {};
-  const flatChildren = (0, _reactUtils.flattenChildren)(children);
-  const processedChildren = (0, _reactUtils.cloneChildrenWithModes)(flatChildren, modes);
-  const enhancedChildren = processedChildren.map((child, index) => {
-    if (! /*#__PURE__*/_react.default.isValidElement(child)) return child;
-    const element = child;
-    const isIconButton = element.type === _IconButton.default;
-    const stretchStyle = isIconButton ? undefined : {
-      flex: 1
+  // All token reads collapsed into a single useMemo keyed on `modes`. With
+  // the shared `EMPTY_MODES` default this resolves once for the common path
+  // and never re-allocates the container/slot style objects between renders.
+  const {
+    containerStyle,
+    slotStyle
+  } = (0, _react.useMemo)(() => {
+    const backgroundColor = (0, _figmaVariablesResolver.getVariableByName)('actionFooter/background', modes) ?? '#ffffff';
+    const gap = (0, _figmaVariablesResolver.getVariableByName)('actionFooter/gap', modes) ?? 8;
+    const paddingHorizontal = (0, _figmaVariablesResolver.getVariableByName)('actionFooter/padding/horizontal', modes) ?? 16;
+    const paddingTop = (0, _figmaVariablesResolver.getVariableByName)('actionFooter/padding/top', modes) ?? 10;
+    const paddingBottom = (0, _figmaVariablesResolver.getVariableByName)('actionFooter/padding/bottom', modes) ?? 41;
+    const container = {
+      // `alignSelf: 'stretch'` is the cross-platform way to ask "fill the
+      // parent's cross axis" — in the common case (column parent) this gives
+      // us full-width without the caller needing to pass `width: '100%'`.
+      alignSelf: 'stretch',
+      backgroundColor,
+      paddingLeft: paddingHorizontal,
+      paddingRight: paddingHorizontal,
+      paddingTop,
+      paddingBottom,
+      ...NATIVE_SHADOW
+    };
+    const slot = {
+      flexDirection: 'row',
+      // Vertically center the IconButton against the slightly taller Buttons
+      // so the row reads as a single optical baseline.
+      alignItems: 'center',
+      gap
+    };
+    return {
+      containerStyle: container,
+      slotStyle: slot
     };
-    return /*#__PURE__*/_react.default.cloneElement(element, {
-      key: element.key ?? index,
-      style: [stretchStyle, element.props.style]
+  }, [modes]);
+
+  // Process children once per (children, modes) tuple:
+  //   1. Flatten Fragments so each action is its own keyed sibling.
+  //   2. Push `modes` down so callers don't have to thread it manually.
+  //   3. Auto-stretch every non-IconButton with the Yoga-safe stretch style.
+  //
+  // The result identity is stable across re-renders when the inputs don't
+  // change, which keeps the `React.memo`-wrapped Button/IconButton children
+  // from re-rendering for no reason.
+  const enhancedChildren = (0, _react.useMemo)(() => {
+    const flat = (0, _reactUtils.flattenChildren)(children);
+    const withModes = (0, _reactUtils.cloneChildrenWithModes)(flat, modes);
+    return withModes.map((child, index) => {
+      if (! /*#__PURE__*/_react.default.isValidElement(child)) return child;
+      const element = child;
+      if (isIconButtonElement(element)) return element;
+      return /*#__PURE__*/_react.default.cloneElement(element, {
+        key: element.key ?? `action-footer-item-${index}`,
+        style: [STRETCH_STYLE, element.props.style]
+      });
     });
-  });
-  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
-    style: [containerStyle, webShadow, style],
+  }, [children, modes]);
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Animated.View, {
+    style: [containerStyle, WEB_SHADOW, style,
+    // Counter-translate by the keyboard height on Android so `adjustResize`
+    // can't lift the footer above the keyboard (no-op on iOS/web where the
+    // value stays at 0).
+    {
+      transform: [{
+        translateY: keyboardOffset
+      }]
+    }],
     accessibilityRole: "toolbar",
-    accessibilityLabel: undefined,
+    accessibilityLabel: accessibilityLabel,
     children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
       style: slotStyle,
       children: enhancedChildren
     })
   });
 }
-var _default = exports.default = ActionFooter;
+var _default = exports.default = /*#__PURE__*/_react.default.memo(ActionFooter);