jfs-components 0.0.74 → 0.0.78

package/lib/module/components/LottiePlayer/loadNativeLottieView.js

@@ -0,0 +1,69 @@
+"use strict";
+
+import React from 'react';
+import { Text, View } from 'react-native';
+
+/** Props we forward to the underlying native Lottie view. */
+import { jsx as _jsx } from "react/jsx-runtime";
+const INSTALL_HINT = 'LottiePlayer requires lottie-react-native in your app.\n' + '  npm install lottie-react-native\n' + '  cd ios && pod install';
+
+/**
+ * Metro resolves `require('lottie-react-native')` at bundle time even inside
+ * try/catch, which breaks apps that import `jfs-components` without having
+ * the optional peer installed. Splitting the module id into a runtime string
+ * keeps Metro from statically linking it — the native module is loaded only
+ * when present in the consumer's node_modules.
+ */
+function resolveNativeLottieModuleName() {
+  return ['lottie', '-react', '-native'].join('');
+}
+function LottieUnavailableView({
+  style
+}) {
+  if (__DEV__) {
+    return /*#__PURE__*/_jsx(View, {
+      style: [style, {
+        alignItems: 'center',
+        justifyContent: 'center',
+        backgroundColor: 'rgba(255, 196, 0, 0.12)',
+        borderWidth: 1,
+        borderColor: 'rgba(255, 196, 0, 0.45)',
+        borderRadius: 8,
+        padding: 8
+      }],
+      children: /*#__PURE__*/_jsx(Text, {
+        style: {
+          color: '#8a6d00',
+          fontSize: 11,
+          textAlign: 'center',
+          lineHeight: 15
+        },
+        children: INSTALL_HINT
+      })
+    });
+  }
+  return /*#__PURE__*/_jsx(View, {
+    style: style
+  });
+}
+function LottieUnavailable(props) {
+  React.useEffect(() => {
+    if (__DEV__) {
+      console.warn(`[jfs-components/LottiePlayer] ${INSTALL_HINT}`);
+    }
+  }, []);
+  return /*#__PURE__*/_jsx(LottieUnavailableView, {
+    style: props.style
+  });
+}
+let cachedView;
+export function getNativeLottieView() {
+  if (cachedView !== undefined) return cachedView;
+  try {
+    const mod = require(resolveNativeLottieModuleName());
+    cachedView = mod.default ?? LottieUnavailable;
+  } catch {
+    cachedView = LottieUnavailable;
+  }
+  return cachedView;
+}

package/lib/module/components/LottiePlayer/loadWebLottieView.js

@@ -0,0 +1,45 @@
+"use strict";
+
+import React from 'react';
+
+/** Props we forward to the underlying web Lottie view. */
+import { jsx as _jsx } from "react/jsx-runtime";
+const INSTALL_HINT = 'LottiePlayer requires lottie-react in your app.\n' + '  npm install lottie-react';
+function resolveWebLottieModuleName() {
+  return ['lottie', '-react'].join('');
+}
+function LottieUnavailable(props) {
+  React.useEffect(() => {
+    if (typeof __DEV__ !== 'undefined' && __DEV__) {
+      console.warn(`[jfs-components/LottiePlayer] ${INSTALL_HINT}`);
+    }
+  }, []);
+  return /*#__PURE__*/_jsx("div", {
+    style: {
+      ...props.style,
+      display: 'flex',
+      alignItems: 'center',
+      justifyContent: 'center',
+      backgroundColor: 'rgba(255, 196, 0, 0.12)',
+      border: '1px solid rgba(255, 196, 0, 0.45)',
+      borderRadius: 8,
+      padding: 8,
+      color: '#8a6d00',
+      fontSize: 11,
+      textAlign: 'center',
+      lineHeight: '15px'
+    },
+    children: typeof __DEV__ !== 'undefined' && __DEV__ ? INSTALL_HINT : null
+  });
+}
+let cachedView;
+export function getWebLottieView() {
+  if (cachedView !== undefined) return cachedView;
+  try {
+    const mod = require(resolveWebLottieModuleName());
+    cachedView = mod.default ?? LottieUnavailable;
+  } catch {
+    cachedView = LottieUnavailable;
+  }
+  return cachedView;
+}

package/lib/module/components/MessageField/MessageField.js

@@ -0,0 +1,313 @@
+"use strict";
+
+import React, { useCallback, useMemo, useRef, useState } from 'react';
+import { View, Text, Pressable, TextInput as RNTextInput } from 'react-native';
+import { getVariableByName } from '../../design-tokens/figma-variables-resolver';
+import { useTokens } from '../../design-tokens/JFSThemeProvider';
+import { EMPTY_MODES } from '../../utils/react-utils';
+import { useFormContext } from '../Form/Form';
+
+// ---------------------------------------------------------------------------
+// Types
+// ---------------------------------------------------------------------------
+
+/**
+ * Visual state of the textarea. Mirrors the `FormField States` collection so
+ * MessageField slots into the same theming pipeline as FormField. The state
+ * is always derived from props (`isInvalid`, `isDisabled`, `isReadOnly` and
+ * focus) and is locked in `modes['FormField States']` — passing that key in
+ * `modes` is intentionally ignored to keep interactive behaviour and visual
+ * state in sync.
+ */
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+// ---------------------------------------------------------------------------
+// Token helpers
+// ---------------------------------------------------------------------------
+
+function toNumber(value, fallback) {
+  if (typeof value === 'number' && Number.isFinite(value)) return value;
+  if (typeof value === 'string') {
+    const parsed = parseFloat(value);
+    if (Number.isFinite(parsed)) return parsed;
+  }
+  return fallback;
+}
+function toFontWeight(value, fallback) {
+  if (typeof value === 'number') return value.toString();
+  if (typeof value === 'string' && value.length > 0) return value;
+  return fallback;
+}
+function firstError(error) {
+  if (!error) return undefined;
+  if (Array.isArray(error)) return error[0];
+  return error;
+}
+function useMessageFieldTokens(modes) {
+  return useMemo(() => {
+    const wrapperGap = toNumber(getVariableByName('messageField/gap', modes), 8);
+    const labelColor = getVariableByName('messageField/label/foreground', modes) || '#000000';
+    const labelFontFamily = getVariableByName('messageField/label/fontFamily', modes) || 'JioType Var';
+    const labelFontSize = toNumber(getVariableByName('messageField/label/fontSize', modes), 14);
+    const labelLineHeight = toNumber(getVariableByName('messageField/label/lineHeight', modes), 17);
+    const labelFontWeight = toFontWeight(getVariableByName('messageField/label/fontWeight', modes), '500');
+    const textareaBackground = getVariableByName('messageField/textarea/background', modes) || '#ffffff';
+    const textareaBorderColor = getVariableByName('messageField/textarea/border/color', modes) || '#b5b6b7';
+    const textareaBorderSize = toNumber(getVariableByName('messageField/textarea/border/size', modes), 1.5);
+    const textareaRadius = toNumber(getVariableByName('messageField/textarea/radius', modes), 8);
+    const textareaPadding = toNumber(getVariableByName('messageField/textarea/padding', modes), 12);
+    const textareaHeight = toNumber(getVariableByName('messageField/textarea/height', modes), 108);
+    const textareaGap = toNumber(getVariableByName('messageField/textarea/gap', modes), 0);
+
+    // `messageField/text/foreground` is the input text color. It also
+    // serves as the placeholder color — in mode-aware token sets it
+    // resolves to a muted/idle color when empty and shifts darker via
+    // the `FormField States` cascade once typed-state tokens land. We
+    // never re-route this through another token (e.g. the counter
+    // color) because that conflates two semantically distinct tokens.
+    const inputTextColor = getVariableByName('messageField/text/foreground', modes) || '#707275';
+    const inputFontFamily = getVariableByName('messageField/text/fontFamily', modes) || 'JioType Var';
+    const inputFontSize = toNumber(getVariableByName('messageField/text/fontSize', modes), 16);
+    const inputLineHeight = toNumber(getVariableByName('messageField/text/lineHeight', modes), 21);
+    const inputFontWeight = toFontWeight(getVariableByName('messageField/text/fontWeight', modes), '400');
+    const counterColor = getVariableByName('messageField/maxLength/foreground', modes) || '#24262b';
+    const counterFontFamily = getVariableByName('messageField/maxLength/fontFamily', modes) || 'JioType Var';
+    const counterFontSize = toNumber(getVariableByName('messageField/maxLength/fontSize', modes), 14);
+    const counterLineHeight = toNumber(getVariableByName('messageField/maxLength/lineHeight', modes), 18);
+    const counterFontWeight = toFontWeight(getVariableByName('messageField/maxLength/fontWeight', modes), '400');
+    return {
+      wrapperGap,
+      labelColor,
+      labelFontFamily,
+      labelFontSize,
+      labelLineHeight,
+      labelFontWeight,
+      textareaBackground,
+      textareaBorderColor,
+      textareaBorderSize,
+      textareaRadius,
+      textareaPadding,
+      textareaHeight,
+      textareaGap,
+      inputTextColor,
+      inputFontFamily,
+      inputFontSize,
+      inputLineHeight,
+      inputFontWeight,
+      counterColor,
+      counterFontFamily,
+      counterFontSize,
+      counterLineHeight,
+      counterFontWeight
+    };
+  }, [modes]);
+}
+
+// ---------------------------------------------------------------------------
+// Component
+// ---------------------------------------------------------------------------
+
+const REQUIRED_INDICATOR_COLOR = '#d93d3d';
+function MessageField({
+  label,
+  placeholder,
+  value,
+  defaultValue,
+  onChangeText,
+  name,
+  maxLength,
+  showCounter,
+  rows,
+  isRequired = false,
+  isDisabled = false,
+  isInvalid = false,
+  isReadOnly = false,
+  autoFocus = false,
+  modes: propModes = EMPTY_MODES,
+  style,
+  textareaStyle,
+  inputStyle,
+  accessibilityLabel,
+  accessibilityHint,
+  testID,
+  onFocus,
+  onBlur
+}) {
+  const formCtx = useFormContext();
+  const formError = name && formCtx ? firstError(formCtx.validationErrors[name]) : undefined;
+  const resolvedIsInvalid = isInvalid || Boolean(formError);
+  const isControlled = value !== undefined;
+  const [uncontrolledValue, setUncontrolledValue] = useState(defaultValue ?? '');
+  const currentValue = isControlled ? value : uncontrolledValue;
+  const [isFocused, setIsFocused] = useState(false);
+  const interactive = !isDisabled && !isReadOnly;
+
+  // Ref to the native textarea so tapping anywhere in the (padded) textarea
+  // container focuses it on the FIRST tap, fixing the Android "two taps to
+  // open the keyboard" issue.
+  const inputRef = useRef(null);
+  const focusInput = useCallback(() => {
+    if (!interactive) return;
+    inputRef.current?.focus();
+  }, [interactive]);
+  const {
+    modes: globalModes
+  } = useTokens();
+  const baseModes = useMemo(() => ({
+    ...globalModes,
+    ...propModes
+  }), [globalModes, propModes]);
+
+  // FormField States cascade — error > disabled > read only > active (focus)
+  // > idle. Always derived from props and locked into the modes object so
+  // consumers cannot pass `modes={{ 'FormField States': ... }}` and get out
+  // of sync with the component's actual interactive behaviour.
+  const stateMode = useMemo(() => {
+    if (resolvedIsInvalid) return 'Error';
+    if (isDisabled) return 'Disabled';
+    if (isReadOnly) return 'Read Only';
+    if (isFocused) return 'Active';
+    return 'Idle';
+  }, [resolvedIsInvalid, isDisabled, isReadOnly, isFocused]);
+  const modes = useMemo(() => ({
+    ...baseModes,
+    'FormField States': stateMode
+  }), [baseModes, stateMode]);
+  const tokens = useMessageFieldTokens(modes);
+
+  // ---------- Event handlers ---------------------------------------------
+  const handleFocus = useCallback(e => {
+    setIsFocused(true);
+    onFocus?.(e);
+  }, [onFocus]);
+  const handleBlur = useCallback(e => {
+    setIsFocused(false);
+    onBlur?.(e);
+  }, [onBlur]);
+  const handleChangeText = useCallback(next => {
+    if (!isControlled) {
+      setUncontrolledValue(next);
+    }
+    onChangeText?.(next);
+    if (name && formCtx) formCtx.onFieldChange(name);
+  }, [isControlled, onChangeText, name, formCtx]);
+
+  // ---------- Derived layout values --------------------------------------
+  const computedHeight = useMemo(() => {
+    if (rows && rows > 0) {
+      return Math.round(rows * tokens.inputLineHeight + 2 * tokens.textareaPadding);
+    }
+    return tokens.textareaHeight;
+  }, [rows, tokens.inputLineHeight, tokens.textareaPadding, tokens.textareaHeight]);
+  const shouldShowCounter = useMemo(() => {
+    if (showCounter === false) return false;
+    if (showCounter === true) return true;
+    return typeof maxLength === 'number';
+  }, [showCounter, maxLength]);
+  const counterText = useMemo(() => {
+    const count = currentValue.length;
+    if (typeof maxLength === 'number') return `${count}/${maxLength}`;
+    return `${count}`;
+  }, [currentValue.length, maxLength]);
+
+  // ---------- Styles -----------------------------------------------------
+  const wrapperStyle = useMemo(() => ({
+    gap: tokens.wrapperGap,
+    width: '100%'
+  }), [tokens.wrapperGap]);
+  const labelRowStyle = useMemo(() => ({
+    flexDirection: 'row',
+    alignItems: 'baseline'
+  }), []);
+  const labelTextStyle = useMemo(() => ({
+    color: tokens.labelColor,
+    fontFamily: tokens.labelFontFamily,
+    fontSize: tokens.labelFontSize,
+    lineHeight: tokens.labelLineHeight,
+    fontWeight: tokens.labelFontWeight
+  }), [tokens.labelColor, tokens.labelFontFamily, tokens.labelFontSize, tokens.labelLineHeight, tokens.labelFontWeight]);
+  const requiredIndicatorStyle = useMemo(() => ({
+    ...labelTextStyle,
+    color: REQUIRED_INDICATOR_COLOR
+  }), [labelTextStyle]);
+  const textareaContainerStyle = useMemo(() => ({
+    backgroundColor: tokens.textareaBackground,
+    borderColor: tokens.textareaBorderColor,
+    borderWidth: tokens.textareaBorderSize,
+    borderStyle: 'solid',
+    borderRadius: tokens.textareaRadius,
+    padding: tokens.textareaPadding,
+    height: computedHeight,
+    width: '100%',
+    overflow: 'hidden',
+    // The gap token is for content within the textarea (icons, etc.);
+    // we keep it so downstream layouts that pass children align.
+    gap: tokens.textareaGap
+  }), [tokens.textareaBackground, tokens.textareaBorderColor, tokens.textareaBorderSize, tokens.textareaRadius, tokens.textareaPadding, computedHeight, tokens.textareaGap]);
+  const inputTextStyle = useMemo(() => ({
+    flex: 1,
+    color: tokens.inputTextColor,
+    fontFamily: tokens.inputFontFamily,
+    fontSize: tokens.inputFontSize,
+    lineHeight: tokens.inputLineHeight,
+    fontWeight: tokens.inputFontWeight,
+    padding: 0,
+    margin: 0,
+    textAlignVertical: 'top',
+    // Disable the default web focus ring; the textarea border
+    // already encodes focus state.
+    outlineStyle: 'none',
+    outlineWidth: 0,
+    outlineColor: 'transparent'
+  }), [tokens.inputTextColor, tokens.inputFontFamily, tokens.inputFontSize, tokens.inputLineHeight, tokens.inputFontWeight]);
+  const counterTextStyle = useMemo(() => ({
+    color: tokens.counterColor,
+    fontFamily: tokens.counterFontFamily,
+    fontSize: tokens.counterFontSize,
+    lineHeight: tokens.counterLineHeight,
+    fontWeight: tokens.counterFontWeight,
+    textAlign: 'right',
+    width: '100%'
+  }), [tokens.counterColor, tokens.counterFontFamily, tokens.counterFontSize, tokens.counterLineHeight, tokens.counterFontWeight]);
+  const resolvedA11yLabel = accessibilityLabel || label || placeholder || 'Message field';
+  return /*#__PURE__*/_jsxs(View, {
+    style: [wrapperStyle, style],
+    pointerEvents: isDisabled ? 'none' : 'auto',
+    testID: testID,
+    accessible: false,
+    children: [label != null && label !== '' && /*#__PURE__*/_jsxs(View, {
+      style: labelRowStyle,
+      children: [/*#__PURE__*/_jsx(Text, {
+        style: labelTextStyle,
+        children: label
+      }), isRequired && /*#__PURE__*/_jsx(Text, {
+        style: requiredIndicatorStyle,
+        children: " *"
+      })]
+    }), /*#__PURE__*/_jsx(Pressable, {
+      style: [textareaContainerStyle, textareaStyle],
+      onPress: focusInput,
+      accessible: false,
+      children: /*#__PURE__*/_jsx(RNTextInput, {
+        ref: inputRef,
+        multiline: true,
+        value: currentValue,
+        onChangeText: handleChangeText,
+        onFocus: handleFocus,
+        onBlur: handleBlur,
+        placeholder: placeholder ?? '',
+        placeholderTextColor: tokens.inputTextColor,
+        editable: interactive,
+        maxLength: maxLength,
+        autoFocus: autoFocus,
+        accessibilityLabel: resolvedA11yLabel,
+        accessibilityHint: accessibilityHint,
+        style: [inputTextStyle, inputStyle]
+      })
+    }), shouldShowCounter && /*#__PURE__*/_jsx(Text, {
+      style: counterTextStyle,
+      accessibilityElementsHidden: true,
+      children: counterText
+    })]
+  });
+}
+export default MessageField;

package/lib/module/components/NavArrow/NavArrow.js

@@ -1,11 +1,22 @@
 "use strict";
 
 import React, { useMemo } from 'react';
-import { View } from 'react-native';
+import { Platform, Pressable, View } from 'react-native';
 import Svg, { Polyline } from 'react-native-svg';
 import { getVariableByName } from '../../design-tokens/figma-variables-resolver';
+import { usePressableWebSupport } from '../../utils/web-platform-utils';
 import { EMPTY_MODES } from '../../utils/react-utils';
 import { jsx as _jsx } from "react/jsx-runtime";
+/** Minimum touch target per iOS HIG / Material accessibility guidance. */
+const MIN_TOUCH_TARGET = 44;
+const IS_IOS = Platform.OS === 'ios';
+const PRESS_DELAY = IS_IOS ? 130 : 0;
+const touchTargetStyle = {
+  minWidth: MIN_TOUCH_TARGET,
+  minHeight: MIN_TOUCH_TARGET,
+  alignItems: 'center',
+  justifyContent: 'center'
+};
 function resolveNavArrowTokens(modes) {
   const iconColor = getVariableByName('navArrow/icon/color', modes) || '#24262b';
   const widthToken = Number(getVariableByName('navArrow/width', modes)) || 6;
@@ -46,6 +57,8 @@ function NavArrow({
   modes = EMPTY_MODES,
   style,
   accessibilityLabel,
+  onPress,
+  disabled = false,
   ...rest
 }) {
   const tokens = useMemo(() => resolveNavArrowTokens(modes), [modes]);
@@ -59,8 +72,7 @@ function NavArrow({
       borderRadius: tokens.borderRadius,
       backgroundColor: tokens.backgroundColor,
       alignItems: 'center',
-      justifyContent: 'center',
-      ...(style || {})
+      justifyContent: 'center'
     };
     const chevronW = isDown ? tokens.iconHeight : tokens.iconWidth;
     const chevronH = isDown ? tokens.iconWidth : tokens.iconHeight;
@@ -86,26 +98,55 @@ function NavArrow({
       svgHeight,
       points
     };
-  }, [tokens, direction, style]);
+  }, [tokens, direction]);
   const defaultAccessibilityLabel = accessibilityLabel || (direction === 'Back' ? 'Go back' : direction === 'Forward' ? 'Go forward' : 'Go down');
+  const webProps = usePressableWebSupport({
+    restProps: rest,
+    onPress,
+    disabled,
+    accessibilityLabel: defaultAccessibilityLabel
+  });
+  const chevron = /*#__PURE__*/_jsx(Svg, {
+    width: computed.svgWidth,
+    height: computed.svgHeight,
+    viewBox: `0 0 ${computed.svgWidth} ${computed.svgHeight}`,
+    children: /*#__PURE__*/_jsx(Polyline, {
+      points: computed.points,
+      stroke: tokens.iconColor,
+      strokeWidth: tokens.strokeWeight,
+      strokeLinecap: "round",
+      strokeLinejoin: "round",
+      fill: "none"
+    })
+  });
+  if (onPress) {
+    return /*#__PURE__*/_jsx(Pressable, {
+      onPress: onPress,
+      disabled: disabled,
+      accessibilityRole: "button",
+      accessibilityLabel: defaultAccessibilityLabel,
+      accessibilityState: {
+        disabled
+      },
+      unstable_pressDelay: PRESS_DELAY,
+      style: ({
+        pressed
+      }) => [touchTargetStyle, style, pressed && !disabled ? {
+        opacity: 0.7
+      } : null],
+      ...webProps,
+      children: /*#__PURE__*/_jsx(View, {
+        style: computed.containerStyle,
+        children: chevron
+      })
+    });
+  }
   return /*#__PURE__*/_jsx(View, {
-    style: computed.containerStyle,
+    style: [computed.containerStyle, style],
     accessibilityRole: "image",
     accessibilityLabel: defaultAccessibilityLabel,
     ...rest,
-    children: /*#__PURE__*/_jsx(Svg, {
-      width: computed.svgWidth,
-      height: computed.svgHeight,
-      viewBox: `0 0 ${computed.svgWidth} ${computed.svgHeight}`,
-      children: /*#__PURE__*/_jsx(Polyline, {
-        points: computed.points,
-        stroke: tokens.iconColor,
-        strokeWidth: tokens.strokeWeight,
-        strokeLinecap: "round",
-        strokeLinejoin: "round",
-        fill: "none"
-      })
-    })
+    children: chevron
   });
 }
 export default /*#__PURE__*/React.memo(NavArrow);

package/lib/module/components/PageHero/PageHero.js

@@ -9,12 +9,14 @@ import { EMPTY_MODES, cloneChildrenWithModes } from '../../utils/react-utils';
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 /**
  * PageHero displays a centered hero block typically used at the top of a page
- * or feature screen. It contains an eyebrow line, a large headline, an optional
- * supporting line (e.g. price/timeline), and an optional action button.
+ * or feature screen. It contains an optional media slot (illustration / image
+ * / Lottie / SVG / video — consumer's choice), an eyebrow line, a large
+ * headline, an optional supporting line (e.g. price / timeline), and an
+ * optional action button.
  *
  * All visual values are resolved from Figma design tokens via
- * `getVariableByName`. The button slot cascades the active `modes` to its
- * children through `cloneChildrenWithModes`.
+ * `getVariableByName`. Slots cascade the active `modes` to their children
+ * through `cloneChildrenWithModes`.
  *
  * @component
  * @example
@@ -25,6 +27,13 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
  *   supportingText="₹999/year · ₹0 until 2027"
  *   buttonLabel="Renew for free"
  *   onButtonPress={() => navigate('Upgrade')}
+ *   media={
+ *     <Image
+ *       imageSource={require('./assets/upgrade.png')}
+ *       width={117}
+ *       height={117}
+ *     />
+ *   }
  * />
  * ```
  */
@@ -37,6 +46,7 @@ function PageHero({
   onButtonPress,
   showButton = true,
   buttonSlot,
+  media,
   modes: propModes = EMPTY_MODES,
   style,
   testID
@@ -51,6 +61,12 @@ function PageHero({
   const gap = Number(getVariableByName('PageHero/gap', modes)) || 16;
   const paddingHorizontal = Number(getVariableByName('PageHero/padding/horizontal', modes)) || 0;
   const textWrapGap = Number(getVariableByName('PageHero/textWrap/gap', modes)) || 8;
+
+  // Media slot box — matches the 117×117 frame in Figma (node 4540:7845).
+  // Tokens fall back to 117 when not defined in the variables collection,
+  // so the layout stays stable on consumers that haven't tokenized this yet.
+  const mediaWidth = Number(getVariableByName('media/width', modes)) || 117;
+  const mediaHeight = Number(getVariableByName('media/height', modes)) || 117;
   const eyebrowColor = getVariableByName('PageHero/eyebrow/color', modes) || '#ffffff';
   const eyebrowFontFamily = getVariableByName('PageHero/eyebrow/fontFamily', modes) || 'System';
   const eyebrowFontSize = Number(getVariableByName('PageHero/eyebrow/fontSize', modes)) || 18;
@@ -126,10 +142,30 @@ function PageHero({
     // shape never does.
     // eslint-disable-next-line react-hooks/exhaustive-deps
   }, [buttonSlot, showButton, buttonLabel, onButtonPress, modes]);
+
+  // Sized container for the media slot. Always rendered when `media` is
+  // provided, so the slot has a predictable box (matches Figma frame
+  // 4540:7845 — 117×117 by default) even if the inner element omits its
+  // own width/height. `overflow: 'hidden'` mirrors the Figma frame's
+  // `clipsContent` so a slightly oversized illustration doesn't break
+  // the centered layout.
+  const mediaContent = useMemo(() => {
+    if (media === undefined || media === null) return null;
+    return /*#__PURE__*/_jsx(View, {
+      style: {
+        width: mediaWidth,
+        height: mediaHeight,
+        alignItems: 'center',
+        justifyContent: 'center',
+        overflow: 'hidden'
+      },
+      children: cloneChildrenWithModes(media, modes)
+    });
+  }, [media, mediaWidth, mediaHeight, modes]);
   return /*#__PURE__*/_jsxs(View, {
     style: [containerStyle, style],
     testID: testID,
-    children: [/*#__PURE__*/_jsxs(View, {
+    children: [mediaContent, /*#__PURE__*/_jsxs(View, {
       style: textWrapStyle,
       children: [eyebrow ? /*#__PURE__*/_jsx(Text, {
         style: eyebrowStyle,