jfs-components 0.0.73 → 0.0.77

package/lib/commonjs/skeleton/useReducedMotion.js

@@ -0,0 +1,64 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useReducedMotion = useReducedMotion;
+var _react = require("react");
+var _reactNative = require("react-native");
+/**
+ * Cross-platform "prefers reduced motion" hook.
+ *
+ *  - Native: reads `AccessibilityInfo.isReduceMotionEnabled()` and subscribes
+ *    to `reduceMotionChanged` events so the value stays live as the user
+ *    toggles the OS setting.
+ *  - Web: uses `window.matchMedia('(prefers-reduced-motion: reduce)')`,
+ *    subscribing to its `change` event.
+ *  - Anywhere either API is missing: returns `false` (no reduction).
+ *
+ * The hook never throws — every native API access is defensively guarded so
+ * the skeleton system stays safe in tests, SSR, and constrained sandboxes.
+ */
+function useReducedMotion() {
+  const [reduced, setReduced] = (0, _react.useState)(false);
+  (0, _react.useEffect)(() => {
+    let cancelled = false;
+    if (_reactNative.Platform.OS === 'web') {
+      if (typeof window === 'undefined' || typeof window.matchMedia !== 'function') {
+        return;
+      }
+      const mql = window.matchMedia('(prefers-reduced-motion: reduce)');
+      const update = matches => {
+        if (!cancelled) setReduced(matches);
+      };
+      update(mql.matches);
+      const listener = e => update(e.matches);
+      if (typeof mql.addEventListener === 'function') {
+        mql.addEventListener('change', listener);
+        return () => {
+          cancelled = true;
+          mql.removeEventListener('change', listener);
+        };
+      }
+      const legacyMql = mql;
+      legacyMql.addListener?.(listener);
+      return () => {
+        cancelled = true;
+        legacyMql.removeListener?.(listener);
+      };
+    }
+    if (typeof _reactNative.AccessibilityInfo?.isReduceMotionEnabled === 'function') {
+      _reactNative.AccessibilityInfo.isReduceMotionEnabled().then(value => {
+        if (!cancelled) setReduced(!!value);
+      }).catch(() => {});
+    }
+    const sub = typeof _reactNative.AccessibilityInfo?.addEventListener === 'function' ? _reactNative.AccessibilityInfo.addEventListener('reduceMotionChanged', value => {
+      if (!cancelled) setReduced(!!value);
+    }) : null;
+    return () => {
+      cancelled = true;
+      sub?.remove?.();
+    };
+  }, []);
+  return reduced;
+}

package/lib/module/components/AccountCard/AccountCard.js

@@ -0,0 +1,241 @@
+"use strict";
+
+import React, { useCallback, useMemo, useRef } from 'react';
+import { Image as RNImage, Platform, Pressable, Text, View } from 'react-native';
+import { getVariableByName } from '../../design-tokens/figma-variables-resolver';
+import { EMPTY_MODES, cloneChildrenWithModes } from '../../utils/react-utils';
+import Icon from '../../icons/Icon';
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+const IS_IOS = Platform.OS === 'ios';
+const PRESS_DELAY = IS_IOS ? 130 : 0;
+const DEFAULT_IMAGE_RATIO = 125 / 82;
+const pressedOverlayStyle = {
+  opacity: 0.7
+};
+
+// Default modes for the "Add" placeholder icon (`iconButton/*` tokens).
+// Caller-supplied `modes` are merged on top so every key here can be overridden.
+const ADD_ICON_DEFAULT_MODES = Object.freeze({
+  AppearanceBrand: 'Secondary',
+  Emphasis: 'Low',
+  "Button / Size": "M"
+});
+const toNumber = (value, fallback) => {
+  if (typeof value === 'number') return Number.isFinite(value) ? value : fallback;
+  if (typeof value === 'string') {
+    const parsed = Number(value);
+    return Number.isFinite(parsed) ? parsed : fallback;
+  }
+  return fallback;
+};
+const toFontWeight = (value, fallback) => {
+  if (typeof value === 'number') return String(value);
+  if (typeof value === 'string') return value;
+  return fallback;
+};
+const normalizeImageSource = src => {
+  if (src == null) return undefined;
+  if (typeof src === 'string') return {
+    uri: src
+  };
+  return src;
+};
+
+/**
+ * `AccountCard` — a compact card preview used to represent a linked
+ * financial account in lists / grids.
+ *
+ * Two visual states are supported via the `state` prop:
+ *
+ *  1. `'connected'` (default): renders a small card-art preview, a bold
+ *     `title` and a regular-weight `subtitle` (e.g. masked account number).
+ *  2. `'add'`: renders a soft-tinted placeholder field with a centred `+`
+ *     icon and the `title` underneath, intended as the "add new account"
+ *     entry-point at the end of a list of connected accounts.
+ *
+ * All values resolve through the `accountCard/*` design tokens with
+ * sensible Figma defaults so the card renders correctly out of the box.
+ *
+ * @component
+ * @param {AccountCardProps} props
+ */
+function AccountCard({
+  state = 'connected',
+  title = 'Personal account',
+  subtitle = '**** 5651',
+  imageSource,
+  imageRatio = DEFAULT_IMAGE_RATIO,
+  cardSlot,
+  addIcon = 'ic_add',
+  onPress,
+  disabled = false,
+  modes = EMPTY_MODES,
+  style,
+  accessibilityLabel,
+  accessibilityHint
+}) {
+  const iconModes = useMemo(() => modes === EMPTY_MODES ? ADD_ICON_DEFAULT_MODES : {
+    ...ADD_ICON_DEFAULT_MODES,
+    ...modes
+  }, [modes]);
+
+  // ---- Tokens ---------------------------------------------------------
+  const gap = toNumber(getVariableByName('accountCard/gap', modes), 8);
+  const textWrapGap = toNumber(getVariableByName('accountCard/textWrap/gap', modes), 0);
+  const titleColor = getVariableByName('accountCard/title/foreground', modes) ?? '#0d0d0f';
+  const titleFontFamily = getVariableByName('accountCard/title/fontFamily', modes) ?? 'JioType Var';
+  const titleFontSize = toNumber(getVariableByName('accountCard/title/fontSize', modes), 12);
+  const titleLineHeight = toNumber(getVariableByName('accountCard/title/lineHeight', modes), 16);
+  const titleFontWeight = toFontWeight(getVariableByName('accountCard/title/fontWeight', modes), '700');
+  const subtitleColor = getVariableByName('accountCard/subtitle/foreground', modes) ?? '#24262b';
+  const subtitleFontFamily = getVariableByName('accountCard/subtitle/fontFamily', modes) ?? 'JioType Var';
+  const subtitleFontSize = toNumber(getVariableByName('accountCard/subtitle/fontSize', modes), 12);
+  const subtitleLineHeight = toNumber(getVariableByName('accountCard/subtitle/lineHeight', modes), 16);
+  const subtitleFontWeight = toFontWeight(getVariableByName('accountCard/subtitle/fontWeight', modes), '400');
+  const addFieldRadius = toNumber(getVariableByName('accountCard/addItemField/radius', modes), 8);
+  const addFieldBg = getVariableByName('accountCard/addItemField/bg', modes) ?? '#ede8ff';
+  const addIconColor = getVariableByName('iconButton/icon/color', iconModes) ?? '#5d00b5';
+  const addIconSize = toNumber(getVariableByName('iconButton/icon/size', iconModes), 16);
+
+  // ---- Styles ---------------------------------------------------------
+  const titleStyle = {
+    color: titleColor,
+    fontFamily: titleFontFamily,
+    fontSize: titleFontSize,
+    lineHeight: titleLineHeight,
+    fontWeight: titleFontWeight,
+    width: '100%'
+  };
+  const subtitleStyle = {
+    color: subtitleColor,
+    fontFamily: subtitleFontFamily,
+    fontSize: subtitleFontSize,
+    lineHeight: subtitleLineHeight,
+    fontWeight: subtitleFontWeight,
+    width: '100%'
+  };
+  const imageBoxStyle = {
+    width: '100%',
+    aspectRatio: imageRatio,
+    overflow: 'hidden'
+  };
+
+  // RN's `<Image>` accepts `ImageStyle`, which has a narrower `overflow`
+  // union than `ViewStyle`. Build the image-only style separately so the
+  // shared box dimensions can be reused without a cast.
+  const imageStyle = {
+    width: '100%',
+    aspectRatio: imageRatio
+  };
+  const addFieldStyle = {
+    ...imageBoxStyle,
+    backgroundColor: addFieldBg,
+    borderRadius: addFieldRadius,
+    alignItems: 'center',
+    justifyContent: 'center'
+  };
+
+  // ---- Image / placeholder area --------------------------------------
+  const renderCardArea = () => {
+    if (cardSlot !== undefined && cardSlot !== null) {
+      const processed = cloneChildrenWithModes(cardSlot, modes);
+      return /*#__PURE__*/_jsx(View, {
+        style: imageBoxStyle,
+        pointerEvents: "box-none",
+        children: processed.length === 1 ? processed[0] : processed
+      });
+    }
+    if (state === 'add') {
+      return /*#__PURE__*/_jsx(View, {
+        style: addFieldStyle,
+        accessibilityElementsHidden: true,
+        importantForAccessibility: "no",
+        children: /*#__PURE__*/_jsx(Icon, {
+          name: addIcon,
+          size: addIconSize,
+          color: addIconColor
+        })
+      });
+    }
+    const normalized = normalizeImageSource(imageSource);
+    if (normalized) {
+      return /*#__PURE__*/_jsx(RNImage, {
+        source: normalized,
+        style: imageStyle,
+        resizeMode: "cover",
+        accessibilityElementsHidden: true,
+        importantForAccessibility: "no"
+      });
+    }
+    return /*#__PURE__*/_jsx(View, {
+      style: imageBoxStyle
+    });
+  };
+
+  // ---- Pressable wiring ----------------------------------------------
+  // Keep React state out of the press path. `Pressable`'s style callback
+  // applies the pressed visual without a re-render.
+  const userHandlersRef = useRef({});
+  const handlePressIn = useCallback(e => {
+    userHandlersRef.current.onPressIn?.(e);
+  }, []);
+  const handlePressOut = useCallback(e => {
+    userHandlersRef.current.onPressOut?.(e);
+  }, []);
+  const containerStyle = useMemo(() => ({
+    width: '100%',
+    flexDirection: 'column',
+    alignItems: 'flex-start',
+    gap,
+    opacity: disabled ? 0.5 : 1
+  }), [gap, disabled]);
+  const pressableStyle = useCallback(({
+    pressed
+  }) => [containerStyle, style, pressed && !disabled && onPress ? pressedOverlayStyle : null], [containerStyle, style, disabled, onPress]);
+  const showSubtitle = state === 'connected' && subtitle != null && subtitle !== '';
+  const a11yRole = onPress ? 'button' : undefined;
+  const a11yLabel = accessibilityLabel ?? title;
+  const content = /*#__PURE__*/_jsxs(_Fragment, {
+    children: [renderCardArea(), title != null && title !== '' || showSubtitle ? /*#__PURE__*/_jsxs(View, {
+      style: {
+        width: '100%',
+        flexDirection: 'column',
+        alignItems: 'flex-start',
+        gap: textWrapGap
+      },
+      children: [title != null && title !== '' ? /*#__PURE__*/_jsx(Text, {
+        style: titleStyle,
+        numberOfLines: 1,
+        children: title
+      }) : null, showSubtitle ? /*#__PURE__*/_jsx(Text, {
+        style: subtitleStyle,
+        numberOfLines: 1,
+        children: subtitle
+      }) : null]
+    }) : null]
+  });
+  if (!onPress) {
+    return /*#__PURE__*/_jsx(View, {
+      accessibilityLabel: a11yLabel,
+      accessibilityHint: accessibilityHint,
+      style: [containerStyle, style],
+      children: content
+    });
+  }
+  return /*#__PURE__*/_jsx(Pressable, {
+    accessibilityRole: a11yRole,
+    accessibilityLabel: a11yLabel,
+    accessibilityHint: accessibilityHint,
+    accessibilityState: {
+      disabled
+    },
+    onPress: disabled ? undefined : onPress,
+    disabled: disabled,
+    onPressIn: handlePressIn,
+    onPressOut: handlePressOut,
+    unstable_pressDelay: PRESS_DELAY,
+    style: pressableStyle,
+    children: content
+  });
+}
+export default /*#__PURE__*/React.memo(AccountCard);

package/lib/module/components/ActionFooter/ActionFooter.js

@@ -1,35 +1,101 @@
 "use strict";
 
-import React from 'react';
+import React, { useMemo } from 'react';
 import { View, Platform } from 'react-native';
 import { getVariableByName } from '../../design-tokens/figma-variables-resolver';
 import { EMPTY_MODES, cloneChildrenWithModes, flattenChildren } from '../../utils/react-utils';
 import IconButton from '../IconButton/IconButton';
 import { jsx as _jsx } from "react/jsx-runtime";
+const IS_WEB = 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 = 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) return true;
+  if (t && typeof t === 'object' && t.type === IconButton) 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>
  * ```
  */
@@ -37,76 +103,74 @@ function ActionFooter({
   children,
   modes = EMPTY_MODES,
   style,
-  accessibilityLabel = undefined
+  accessibilityLabel
 }) {
-  // Resolve design tokens
-  const backgroundColor = getVariableByName('actionFooter/background', modes) ?? '#ffffff';
-  const gap = getVariableByName('actionFooter/gap', modes) ?? 8;
-  const paddingHorizontal = getVariableByName('actionFooter/padding/horizontal', modes) ?? 16;
-  const paddingTop = getVariableByName('actionFooter/padding/top', modes) ?? 10;
-  const paddingBottom = getVariableByName('actionFooter/padding/bottom', modes) ?? 41;
-
-  // Shadow styles - cross-platform
-  const shadowStyle = 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
-  };
-
-  // Web-specific box-shadow
-  const webShadow = 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 = flattenChildren(children);
-  const processedChildren = cloneChildrenWithModes(flatChildren, modes);
-  const enhancedChildren = processedChildren.map((child, index) => {
-    if (! /*#__PURE__*/React.isValidElement(child)) return child;
-    const element = child;
-    const isIconButton = element.type === IconButton;
-    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
+  } = useMemo(() => {
+    const backgroundColor = getVariableByName('actionFooter/background', modes) ?? '#ffffff';
+    const gap = getVariableByName('actionFooter/gap', modes) ?? 8;
+    const paddingHorizontal = getVariableByName('actionFooter/padding/horizontal', modes) ?? 16;
+    const paddingTop = getVariableByName('actionFooter/padding/top', modes) ?? 10;
+    const paddingBottom = 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
     };
-    return /*#__PURE__*/React.cloneElement(element, {
-      key: element.key ?? index,
-      style: [stretchStyle, element.props.style]
+    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
+    };
+  }, [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 = useMemo(() => {
+    const flat = flattenChildren(children);
+    const withModes = cloneChildrenWithModes(flat, modes);
+    return withModes.map((child, index) => {
+      if (! /*#__PURE__*/React.isValidElement(child)) return child;
+      const element = child;
+      if (isIconButtonElement(element)) return element;
+      return /*#__PURE__*/React.cloneElement(element, {
+        key: element.key ?? `action-footer-item-${index}`,
+        style: [STRETCH_STYLE, element.props.style]
+      });
     });
-  });
+  }, [children, modes]);
   return /*#__PURE__*/_jsx(View, {
-    style: [containerStyle, webShadow, style],
+    style: [containerStyle, WEB_SHADOW, style],
     accessibilityRole: "toolbar",
-    accessibilityLabel: undefined,
+    accessibilityLabel: accessibilityLabel,
     children: /*#__PURE__*/_jsx(View, {
       style: slotStyle,
       children: enhancedChildren
     })
   });
 }
-export default ActionFooter;
+export default /*#__PURE__*/React.memo(ActionFooter);

package/lib/module/components/AppBar/AppBar.js

@@ -42,12 +42,13 @@ export default function AppBar({
   const containerStyle = {
     flexDirection: 'row',
     alignItems: 'center',
-    justifyContent: 'space-between',
+    // No `justifyContent` here: with the inline middle slot using `flex: 1`
+    // the three sections lay out naturally (leading | middle | actions).
+    // When middleSlot is absent we fall back to `space-between` at the wrapper
+    // level so leading & actions still anchor to the edges.
     paddingHorizontal: paddingHorizontal ?? 16,
     paddingVertical: paddingVertical ?? (isMain ? 16 : 10),
     backgroundColor: backgroundColor ?? '#FFFFFF'
-    // We can set minHeight if we want to enforce consistency, but padding should dictate it mostly.
-    // Figma shows specific heights implicitly via padding + content.
     // MainPage: h=68 (16 top/bot padding? 36 height content?)
     // SubPage: h=52
   };
@@ -110,8 +111,17 @@ export default function AppBar({
     style: actionsStyle,
     children: cloneChildrenWithModes(React.Children.toArray(actionsSlot), modes)
   }) : null;
+
+  // When there is no middleSlot we want leading & actions pinned to the
+  // outer edges, so we apply `space-between` at the wrapper. With a middle
+  // slot present, the middle (flex: 1) absorbs the remaining space, so
+  // `space-between` is a no-op.
+  const wrapperStyle = {
+    ...containerStyle,
+    justifyContent: processedMiddle ? 'flex-start' : 'space-between'
+  };
   return /*#__PURE__*/_jsxs(View, {
-    style: [containerStyle, style],
+    style: [wrapperStyle, style],
     accessibilityRole: "header",
     accessibilityLabel: undefined,
     ...(accessibilityHint ? {
@@ -126,15 +136,11 @@ export default function AppBar({
       children: processedLeading
     }), processedMiddle && /*#__PURE__*/_jsx(View, {
       style: {
-        position: 'absolute',
-        left: 0,
-        right: 0,
-        top: 0,
-        bottom: 0,
+        flex: 1,
+        minWidth: 0,
         alignItems: 'center',
         justifyContent: 'center',
-        zIndex: -1 // Behind actions if overlap? Or should be on top? 
-        // Usually middle title shouldn't block actions. `pointerEvents="box-none"` is safer.
+        paddingHorizontal: 8
       },
       pointerEvents: "box-none",
       children: processedMiddle

package/lib/module/components/Avatar/Avatar.js

@@ -4,6 +4,8 @@ import React, { useCallback, useMemo, useRef, useState } from 'react';
 import { Pressable, View, Image, Text, Platform } from 'react-native';
 import { getVariableByName } from '../../design-tokens/figma-variables-resolver';
 import { EMPTY_MODES } from '../../utils/react-utils';
+import Skeleton from '../../skeleton/Skeleton';
+import { useSkeleton } from '../../skeleton/SkeletonGroup';
 import { jsx as _jsx } from "react/jsx-runtime";
 const avatarImage = require('./31595e70c4181263f9971590224b12934b280c9b.png');
 
@@ -123,11 +125,19 @@ function Avatar({
   // component intentionally renders `accessibilityLabel={undefined}` on the
   // wrapper (the inner Text/Image carry the label instead).
   accessibilityLabel: _accessibilityLabel,
+  loading,
   ...rest
 }) {
   const isMonogram = style === 'Monogram';
   const tokens = useMemo(() => resolveAvatarTokens(modes, isMonogram), [modes, isMonogram]);
 
+  // Skeleton context — read unconditionally; the actual short-circuit
+  // happens AFTER all remaining hooks below.
+  const {
+    active: groupActive
+  } = useSkeleton();
+  const isLoading = loading ?? groupActive;
+
   // Focus is a sustained visible state — keep mirroring on web; gate the
   // setter so it never fires on native (where focus events don't fire on
   // these elements anyway).
@@ -158,6 +168,15 @@ function Avatar({
     pressed
   }) => [tokens.containerStyle, pressed ? pressedOverlayStyle : null, isFocused ? focusOverlayStyle : null], [tokens.containerStyle, isFocused]);
   const staticContainerStyle = useMemo(() => [tokens.containerStyle, isFocused ? focusOverlayStyle : null], [tokens.containerStyle, isFocused]);
+  if (isLoading) {
+    const size = tokens.containerStyle.width;
+    return /*#__PURE__*/_jsx(Skeleton, {
+      kind: "other",
+      width: size,
+      height: size,
+      modes: modes
+    });
+  }
 
   // The inner content varies; everything else (wrapper, handlers, style) is shared.
   const innerContent = isMonogram ? /*#__PURE__*/_jsx(View, {