jfs-components 0.0.86 → 0.0.95

package/lib/typescript/src/components/FullscreenModal/FullscreenModal.d.ts

@@ -10,18 +10,21 @@ export type FullscreenModalProps = {
     /** Secondary line below the supporting paragraph (e.g. a price / timeline). */
     priceText?: string;
     /**
-     * Background media rendered full-bleed behind the hero text. Bring any
-     * renderer — most commonly an `Image`, but a `LottiePlayer`, `Video`, or
-     * `SvgXml` works too. It is laid out at the full modal width; size it with an
-     * aspect ratio (e.g. `<Image ratio={3 / 4} />`) so its height follows the
-     * width naturally. The media scrolls together with the rest of the content
-     * (no parallax). `modes` are cascaded into it.
+     * Full-bleed background media for the whole modal. It is pinned to the top
+     * and laid out at the full modal width; size it with an aspect ratio
+     * (e.g. `<Image ratio={1080 / 4140} />`) so its height follows the width
+     * naturally. It renders as a single continuous background BEHIND both the
+     * hero text and the body content — there is no separate body box stacked on
+     * top of it. Bring any renderer — most commonly an `Image`, but a
+     * `LottiePlayer`, `Video`, or `SvgXml` works too. It never intercepts
+     * touches and the foreground content scrolls over it (no parallax).
+     * `modes` are cascaded into it.
      */
     heroMedia?: React.ReactNode;
     /**
-     * Fallback height for the hero text region when no `heroMedia` is provided.
-     * When `heroMedia` is present, the hero height is driven entirely by the
-     * media's own aspect ratio and this value is ignored. Defaults to 420.
+     * Height reserved for the hero text region (eyebrow / headline / supporting
+     * / price), whose content is anchored to the bottom. Applies whether or not
+     * `heroMedia` is present. Defaults to 420.
      */
     heroHeight?: number;
     /** Whether to render the floating close button (top-right). Defaults to true. */
@@ -41,15 +44,17 @@ export type FullscreenModalProps = {
     onPrimaryAction?: () => void;
     /** Disclaimer text shown below the default primary action button. */
     disclaimer?: string;
-    /** Solid backdrop color for the scrollable body. Defaults to a near-black. */
-    backgroundColor?: string;
     /** Body content (typically `Section`s). `modes` are cascaded automatically. */
     children?: React.ReactNode;
-    /** Mode configuration. `context5` is always forced to `'Fullscreen Modal'`. */
+    /**
+     * Mode configuration. `Page type` defaults to `'JioPlus'` (overridable here),
+     * and `context5` is always forced to `'Fullscreen Modal'` (non-overridable).
+     * The resolved modes cascade to the body, hero media, and the `ActionFooter`.
+     */
     modes?: Record<string, any>;
     /** Style overrides for the outer container. */
     style?: StyleProp<ViewStyle>;
-    /** Style overrides for the scroll body wrapper (the dark content area). */
+    /** Style overrides for the transparent body wrapper. */
     contentContainerStyle?: StyleProp<ViewStyle>;
     testID?: string;
 };
@@ -64,12 +69,21 @@ export type FullscreenModalProps = {
  * That mode is cascaded into `children`, the footer, and the hero text via
  * `cloneChildrenWithModes` / the merged `modes` object.
  *
- * ### Hero
- * The `heroMedia` is rendered full modal width inside the scroll body and
- * takes its height from its own aspect ratio. The hero text (eyebrow /
- * headline / supporting / price) is overlaid on top, anchored to the bottom.
- * The whole hero scrolls together with the rest of the content — there is no
- * parallax effect.
+ * ### Background media
+ * The `heroMedia` is a single full-bleed background pinned to the top of the
+ * modal at the full width and its own natural aspect ratio. It lives at the
+ * ROOT — behind both the scrolling content and the (transparent) footer — so
+ * it fills the whole surface and is NEVER clipped to the content height. It
+ * also contributes ZERO scroll height: the scroll extent is driven purely by
+ * the in-flow foreground (hero text + `children`), so the number of body
+ * elements dictates how far the surface scrolls. It still scrolls in lockstep
+ * WITH the content (the background is translated by the scroll offset), so the
+ * content reads as sitting ON one continuous image that moves with it — there
+ * is no parallax and no separate solid body box.
+ *
+ * Pass a background sized to the full width at its natural ratio
+ * (e.g. `<Image imageSource={bg} ratio={1080 / 4140} />`). Use an asset at
+ * least as tall as the surface so it covers the full modal.
  *
  * @component
  * @example
@@ -79,7 +93,7 @@ export type FullscreenModalProps = {
  *   headline="Get more from your money."
  *   supportingText="JioFinance+ is your upgraded financial experience…"
  *   priceText="₹999/year · ₹0 until 2027"
- *   heroMedia={<Image imageSource={hero} ratio={3 / 4} />}
+ *   heroMedia={<Image imageSource={hero} ratio={1080 / 4140} />}
  *   primaryActionLabel="Upgrade for free"
  *   disclaimer="By upgrading, we'll check your eligibility with Experian."
  *   onPrimaryAction={() => upgrade()}
@@ -90,6 +104,6 @@ export type FullscreenModalProps = {
  * </FullscreenModal>
  * ```
  */
-declare function FullscreenModal({ eyebrow, headline, supportingText, priceText, heroMedia, heroHeight, showClose, onClose, closeAccessibilityLabel, footer, primaryActionLabel, onPrimaryAction, disclaimer, backgroundColor, children, modes: propModes, style, contentContainerStyle, testID, }: FullscreenModalProps): import("react/jsx-runtime").JSX.Element;
+declare function FullscreenModal({ eyebrow, headline, supportingText, priceText, heroMedia, heroHeight, showClose, onClose, closeAccessibilityLabel, footer, primaryActionLabel, onPrimaryAction, disclaimer, children, modes: propModes, style, contentContainerStyle, testID, }: FullscreenModalProps): import("react/jsx-runtime").JSX.Element;
 export default FullscreenModal;
 //# sourceMappingURL=FullscreenModal.d.ts.map

package/lib/typescript/src/components/Icon/Icon.d.ts

@@ -0,0 +1,75 @@
+import React from 'react';
+import { type AccessibilityProps, type StyleProp, type ViewStyle } from 'react-native';
+import type { UnifiedSource } from '../../utils/MediaSource';
+type IconProps = AccessibilityProps & {
+    /**
+     * Built-in icon name from the registry, in the `ic_something` format
+     * (e.g. `'ic_card'`, `'ic_scan_qr_code'`). When omitted and no `source` or
+     * `children` slot is supplied, defaults to `'ic_card'` to match the Figma
+     * design's default glyph.
+     */
+    iconName?: string;
+    /**
+     * Unified fallback source rendered when `iconName` is missing or not in the
+     * registry. Accepts a remote URI, an inline SVG XML string, a `require()`
+     * asset, an SVG React component, or an already-rendered element. The media
+     * is tinted with the mode-resolved icon color so it follows design tokens
+     * just like a built-in icon. See {@link UnifiedSource}.
+     */
+    source?: UnifiedSource;
+    /**
+     * Icon slot. Render any node here (another `Icon`, a custom SVG component,
+     * etc.) and it takes precedence over `iconName`/`source`. `modes` cascade
+     * into the slotted children automatically.
+     */
+    children?: React.ReactNode;
+    /**
+     * Override the mode-resolved icon color. When omitted the value comes from
+     * the `icon/color` design token.
+     */
+    color?: string;
+    /**
+     * Override the mode-resolved icon size (in px). When omitted the value comes
+     * from the `icon/size` design token.
+     */
+    size?: number;
+    modes?: Record<string, any>;
+    style?: StyleProp<ViewStyle>;
+};
+/**
+ * Icon component — a design-token-driven wrapper around a single glyph.
+ *
+ * It mirrors the Figma "Icon" component: a padded, centered container whose
+ * color and size are resolved from the `icon/*` design tokens via `modes`.
+ * The glyph itself can be supplied three ways, in order of precedence:
+ *
+ *  1. `children` — a real slot for any node (custom SVG component, nested
+ *     `Icon`, etc.). `modes` cascade into the slot automatically.
+ *  2. `iconName` — a registry icon in the `ic_something` format.
+ *  3. `source` — a {@link UnifiedSource} fallback (remote URI, inline SVG XML,
+ *     `require()` asset, SVG component, or React element), tinted with the
+ *     mode-resolved icon color.
+ *
+ * `color` and `size` props let consumers override the token values per
+ * instance without touching `modes`.
+ *
+ * @example
+ * ```tsx
+ * // Built-in registry icon (default path).
+ * <Icon iconName="ic_card" modes={{ 'Color Mode': 'Light' }} />
+ *
+ * // Per-instance overrides.
+ * <Icon iconName="ic_ccv" color="#5c00b5" size={24} />
+ *
+ * // Fallback to an external source when the name isn't in the registry.
+ * <Icon source="https://cdn.example.com/glyph.svg" />
+ *
+ * // Slot: render any node as the icon.
+ * <Icon><BrandLogo /></Icon>
+ * ```
+ */
+declare function Icon({ iconName, source, children, color, size, modes: propModes, style: styleProp, ...rest }: IconProps): import("react/jsx-runtime").JSX.Element;
+declare const _default: React.MemoExoticComponent<typeof Icon>;
+export default _default;
+export type { IconProps };
+//# sourceMappingURL=Icon.d.ts.map

package/lib/typescript/src/components/index.d.ts

@@ -43,6 +43,7 @@ export { default as MonthlyStatusGrid, CalendarGlyph, type MonthlyStatusGridProp
 export { default as Gauge, type GaugeProps } from './Gauge/Gauge';
 export { default as HoldingsCard, type HoldingsCardProps } from './HoldingsCard/HoldingsCard';
 export { default as HStack, type HStackProps } from './HStack/HStack';
+export { default as Icon, type IconProps } from './Icon/Icon';
 export { default as IconButton } from './IconButton/IconButton';
 export { default as IconCapsule } from './IconCapsule/IconCapsule';
 export { default as Image, type ImageProps } from './Image/Image';

package/lib/typescript/src/icons/registry.d.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-06-03T15:59:02.370Z
+ * Generated: 2026-06-04T14:40:09.533Z
  */
 export declare const iconRegistry: Record<string, {
     path: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jfs-components",
-  "version": "0.0.86",
+  "version": "0.0.95",
   "description": "React Native Jio Finance Components Library",
   "author": "sunshuaiqi@gmail.com",
   "license": "MIT",

package/src/assets.d.ts

@@ -0,0 +1,24 @@
+declare module '*.png' {
+  const value: string
+  export default value
+}
+
+declare module '*.jpg' {
+  const value: string
+  export default value
+}
+
+declare module '*.jpeg' {
+  const value: string
+  export default value
+}
+
+declare module '*.gif' {
+  const value: string
+  export default value
+}
+
+declare module '*.webp' {
+  const value: string
+  export default value
+}

package/src/components/FullscreenModal/FullscreenModal.tsx

@@ -1,9 +1,8 @@
-import React, { useMemo } from 'react'
+import React, { useMemo, useRef } from 'react'
 import {
   View,
   Text,
-  ScrollView,
-  StyleSheet,
+  Animated,
   type StyleProp,
   type ViewStyle,
   type TextStyle,
@@ -31,6 +30,17 @@ import Slot from '../Slot/Slot'
 // ---------------------------------------------------------------------------
 const FULLSCREEN_MODAL_FORCED_MODES = Object.freeze({ context5: 'Fullscreen Modal' })
 
+// ---------------------------------------------------------------------------
+// Default modes
+//
+// A FullscreenModal is a "JioPlus" surface, so it defaults the `Page type`
+// collection to `'JioPlus'`. Unlike the forced modes above this IS
+// overridable — it is applied before the caller's `modes`, so passing
+// `modes={{ 'Page type': 'SubPage' }}` still wins. Frozen for stable identity
+// (keeps the token resolver's per-modes cache hot).
+// ---------------------------------------------------------------------------
+const FULLSCREEN_MODAL_DEFAULT_MODES = Object.freeze({ 'Page type': 'JioPlus' })
+
 export type FullscreenModalProps = {
   /** Small eyebrow line above the headline. */
   eyebrow?: string
@@ -41,18 +51,21 @@ export type FullscreenModalProps = {
   /** Secondary line below the supporting paragraph (e.g. a price / timeline). */
   priceText?: string
   /**
-   * Background media rendered full-bleed behind the hero text. Bring any
-   * renderer — most commonly an `Image`, but a `LottiePlayer`, `Video`, or
-   * `SvgXml` works too. It is laid out at the full modal width; size it with an
-   * aspect ratio (e.g. `<Image ratio={3 / 4} />`) so its height follows the
-   * width naturally. The media scrolls together with the rest of the content
-   * (no parallax). `modes` are cascaded into it.
+   * Full-bleed background media for the whole modal. It is pinned to the top
+   * and laid out at the full modal width; size it with an aspect ratio
+   * (e.g. `<Image ratio={1080 / 4140} />`) so its height follows the width
+   * naturally. It renders as a single continuous background BEHIND both the
+   * hero text and the body content — there is no separate body box stacked on
+   * top of it. Bring any renderer — most commonly an `Image`, but a
+   * `LottiePlayer`, `Video`, or `SvgXml` works too. It never intercepts
+   * touches and the foreground content scrolls over it (no parallax).
+   * `modes` are cascaded into it.
    */
   heroMedia?: React.ReactNode
   /**
-   * Fallback height for the hero text region when no `heroMedia` is provided.
-   * When `heroMedia` is present, the hero height is driven entirely by the
-   * media's own aspect ratio and this value is ignored. Defaults to 420.
+   * Height reserved for the hero text region (eyebrow / headline / supporting
+   * / price), whose content is anchored to the bottom. Applies whether or not
+   * `heroMedia` is present. Defaults to 420.
    */
   heroHeight?: number
   /** Whether to render the floating close button (top-right). Defaults to true. */
@@ -72,15 +85,17 @@ export type FullscreenModalProps = {
   onPrimaryAction?: () => void
   /** Disclaimer text shown below the default primary action button. */
   disclaimer?: string
-  /** Solid backdrop color for the scrollable body. Defaults to a near-black. */
-  backgroundColor?: string
   /** Body content (typically `Section`s). `modes` are cascaded automatically. */
   children?: React.ReactNode
-  /** Mode configuration. `context5` is always forced to `'Fullscreen Modal'`. */
+  /**
+   * Mode configuration. `Page type` defaults to `'JioPlus'` (overridable here),
+   * and `context5` is always forced to `'Fullscreen Modal'` (non-overridable).
+   * The resolved modes cascade to the body, hero media, and the `ActionFooter`.
+   */
   modes?: Record<string, any>
   /** Style overrides for the outer container. */
   style?: StyleProp<ViewStyle>
-  /** Style overrides for the scroll body wrapper (the dark content area). */
+  /** Style overrides for the transparent body wrapper. */
   contentContainerStyle?: StyleProp<ViewStyle>
   testID?: string
 }
@@ -171,12 +186,21 @@ function HeroText({ eyebrow, headline, supportingText, priceText, modes }: HeroT
  * That mode is cascaded into `children`, the footer, and the hero text via
  * `cloneChildrenWithModes` / the merged `modes` object.
  *
- * ### Hero
- * The `heroMedia` is rendered full modal width inside the scroll body and
- * takes its height from its own aspect ratio. The hero text (eyebrow /
- * headline / supporting / price) is overlaid on top, anchored to the bottom.
- * The whole hero scrolls together with the rest of the content — there is no
- * parallax effect.
+ * ### Background media
+ * The `heroMedia` is a single full-bleed background pinned to the top of the
+ * modal at the full width and its own natural aspect ratio. It lives at the
+ * ROOT — behind both the scrolling content and the (transparent) footer — so
+ * it fills the whole surface and is NEVER clipped to the content height. It
+ * also contributes ZERO scroll height: the scroll extent is driven purely by
+ * the in-flow foreground (hero text + `children`), so the number of body
+ * elements dictates how far the surface scrolls. It still scrolls in lockstep
+ * WITH the content (the background is translated by the scroll offset), so the
+ * content reads as sitting ON one continuous image that moves with it — there
+ * is no parallax and no separate solid body box.
+ *
+ * Pass a background sized to the full width at its natural ratio
+ * (e.g. `<Image imageSource={bg} ratio={1080 / 4140} />`). Use an asset at
+ * least as tall as the surface so it covers the full modal.
  *
  * @component
  * @example
@@ -186,7 +210,7 @@ function HeroText({ eyebrow, headline, supportingText, priceText, modes }: HeroT
  *   headline="Get more from your money."
  *   supportingText="JioFinance+ is your upgraded financial experience…"
  *   priceText="₹999/year · ₹0 until 2027"
- *   heroMedia={<Image imageSource={hero} ratio={3 / 4} />}
+ *   heroMedia={<Image imageSource={hero} ratio={1080 / 4140} />}
  *   primaryActionLabel="Upgrade for free"
  *   disclaimer="By upgrading, we'll check your eligibility with Experian."
  *   onPrimaryAction={() => upgrade()}
@@ -211,7 +235,6 @@ function FullscreenModal({
   primaryActionLabel = 'Upgrade for free',
   onPrimaryAction,
   disclaimer = "By upgrading, we'll check your eligibility with Experian.",
-  backgroundColor = '#0f0d0a',
   children,
   modes: propModes = EMPTY_MODES,
   style,
@@ -220,15 +243,38 @@ function FullscreenModal({
 }: FullscreenModalProps) {
   const { modes: globalModes } = useTokens()
 
-  // context5 is appended last so it always wins, regardless of what the
-  // caller (or the global theme) passes.
+  // Merge order (low → high priority):
+  //   global theme → component defaults (Page type: JioPlus) → caller modes →
+  //   forced modes (context5). So `Page type` defaults to JioPlus but the
+  //   caller can override it, while `context5` always wins. This single `modes`
+  //   object is what cascades to the body, hero media, and the ActionFooter.
   const modes = useMemo(
-    () => ({ ...globalModes, ...propModes, ...FULLSCREEN_MODAL_FORCED_MODES }),
+    () => ({
+      ...globalModes,
+      ...FULLSCREEN_MODAL_DEFAULT_MODES,
+      ...propModes,
+      ...FULLSCREEN_MODAL_FORCED_MODES,
+    }),
     [globalModes, propModes]
   )
 
   const rootGap = Number(getVariableByName('fullScreenModal/gap', modes)) || 16
 
+  // Drives the background's parallax-free sync with the scroll. The hero media
+  // lives at the ROOT (so it is never clipped to the content height and sits
+  // behind the transparent footer), but we translate it up by the exact scroll
+  // offset so it moves in lockstep with the content — i.e. it scrolls WITH the
+  // body without ever contributing to the scroll height.
+  const scrollY = useRef(new Animated.Value(0)).current
+  const onScroll = useMemo(
+    () =>
+      Animated.event([{ nativeEvent: { contentOffset: { y: scrollY } } }], {
+        useNativeDriver: true,
+      }),
+    [scrollY]
+  )
+  const heroTranslateY = useMemo(() => Animated.multiply(scrollY, -1), [scrollY])
+
   const processedHeroMedia = useMemo(
     () =>
       heroMedia ? cloneChildrenWithModes(heroMedia, modes, FULLSCREEN_MODAL_FORCED_MODES) : null,
@@ -241,9 +287,11 @@ function FullscreenModal({
     [children, modes]
   )
 
-  // No-media fallback: without hero media the text region needs an explicit
-  // resting height (driven by `heroHeight`) so the hero still has presence.
-  const heroTextFallbackStyle = useMemo<ViewStyle>(
+  // The hero text region always reserves `heroHeight` and anchors its content
+  // to the bottom, so the eyebrow/headline block sits in the lower part of the
+  // first screenful — over the background media when present, in flow
+  // otherwise.
+  const heroTextRegionStyle = useMemo<ViewStyle>(
     () => ({
       minHeight: heroHeight,
       justifyContent: 'flex-end',
@@ -253,17 +301,18 @@ function FullscreenModal({
     [heroHeight]
   )
 
+  // Body is intentionally transparent — the background media shows through
+  // behind it. There is no solid "body box" stacked on top of the image.
   const bodyStyle = useMemo<StyleProp<ViewStyle>>(
     () => [
       {
-        backgroundColor,
         gap: rootGap,
         paddingTop: rootGap,
         paddingBottom: 24,
       },
       contentContainerStyle,
     ],
-    [backgroundColor, rootGap, contentContainerStyle]
+    [rootGap, contentContainerStyle]
   )
 
   const heroTextNode = (
@@ -276,21 +325,6 @@ function FullscreenModal({
     />
   )
 
-  // The hero scrolls inline with the body (no parallax). When media is present
-  // it is laid out full modal width and takes its height from its own aspect
-  // ratio; the hero text is overlaid on top, anchored to the bottom. Without
-  // media the text simply renders in flow at the fallback height.
-  const hero = processedHeroMedia ? (
-    <View style={heroMediaContainerStyle}>
-      {processedHeroMedia}
-      <View style={heroTextOverlayStyle} pointerEvents="box-none">
-        {heroTextNode}
-      </View>
-    </View>
-  ) : (
-    <View style={heroTextFallbackStyle}>{heroTextNode}</View>
-  )
-
   // Footer: a fully custom node, or the default Button + Disclaimer column.
   let footerContent: React.ReactNode = null
   if (footer) {
@@ -310,18 +344,48 @@ function FullscreenModal({
   }
 
   return (
-    <View style={[rootStyle, { backgroundColor }, style]} testID={testID}>
-      <ScrollView
+    <View style={[rootStyle, style]} testID={testID}>
+      {/*
+       * Layout model:
+       *  - `processedHeroMedia` is a ROOT-LEVEL full-bleed background pinned to
+       *    the top at full modal width and rendered at its own natural aspect
+       *    ratio — it is NEVER clipped to the content height, so it extends as
+       *    far down as its own height allows and fills the surface BEHIND both
+       *    the scrolling content and the (transparent) footer. Because it lives
+       *    outside the ScrollView it contributes ZERO scroll height, yet we
+       *    translate it by the scroll offset (`heroTranslateY`) so it visually
+       *    scrolls in lockstep WITH the content (no parallax, no clip).
+       *    `pointerEvents="none"` lets touches reach the content/footer.
+       *  - The ScrollView is transparent and holds only the foreground (hero
+       *    text + body) IN FLOW, so the number of actual elements dictates how
+       *    far the surface scrolls.
+       */}
+      {processedHeroMedia ? (
+        <Animated.View
+          style={[heroBackgroundStyle, { transform: [{ translateY: heroTranslateY }] }]}
+          pointerEvents="none"
+        >
+          {processedHeroMedia}
+        </Animated.View>
+      ) : null}
+
+      <Animated.ScrollView
         style={scrollViewStyle}
         contentContainerStyle={scrollContentStyle}
         showsVerticalScrollIndicator={false}
+        onScroll={onScroll}
+        scrollEventThrottle={16}
         // Tap an input in the body and it focuses on the FIRST tap, even when
         // the keyboard is already open (default 'never' eats that tap).
         keyboardShouldPersistTaps="handled"
       >
-        {hero}
-        <View style={bodyStyle}>{processedChildren}</View>
-      </ScrollView>
+        <View style={foregroundFlowStyle}>
+          <View style={heroTextRegionStyle}>{heroTextNode}</View>
+          {processedChildren ? (
+            <View style={bodyStyle}>{processedChildren}</View>
+          ) : null}
+        </View>
+      </Animated.ScrollView>
 
       {footerContent ? (
         <ActionFooter modes={modes}>{footerContent}</ActionFooter>
@@ -346,14 +410,13 @@ const scrollViewStyle: ViewStyle = { flex: 1 }
 const scrollContentStyle: ViewStyle = { flexGrow: 1 }
 const fullWidthStyle: ViewStyle = { width: '100%' }
 const closeButtonStyle: ViewStyle = { position: 'absolute', top: 12, right: 12 }
-// Full-width hero wrapper; height comes from the media's own aspect ratio.
-const heroMediaContainerStyle: ViewStyle = { width: '100%', position: 'relative' }
-// Hero text overlaid on the media, anchored to the bottom edge.
-const heroTextOverlayStyle: ViewStyle = {
-  ...StyleSheet.absoluteFillObject,
-  justifyContent: 'flex-end',
-  paddingHorizontal: 16,
-  paddingBottom: 16,
-}
+// Root-level full-bleed background media. Pinned to the top at full modal
+// width; the media inside keeps its own natural aspect ratio (only `top` is
+// pinned — no `bottom`/`overflow` clip), so it is NEVER cut to the content
+// height and fills the surface behind the scrolling content and the footer.
+// Living outside the ScrollView, it adds nothing to the scroll height.
+const heroBackgroundStyle: ViewStyle = { position: 'absolute', top: 0, left: 0, right: 0 }
+// The foreground always flows normally — its content drives the scroll height.
+const foregroundFlowStyle: ViewStyle = { width: '100%' }
 
 export default FullscreenModal