react-native-terra-ui 0.8.1 → 0.9.1

package/lib/module/components/screen/parts/ScreenFrame.js.map

@@ -1 +1 @@
-{"version":3,"names":["useCallback","useContext","useState","Animated","StyleSheet","ScreenHeaderAppearanceContext","ScreenSafeArea","jsx","_jsx","Fragment","_Fragment","jsxs","_jsxs","ScreenFrame","children","edges","appearance","topInset","setTopInset","onLayout","event","nativeEvent","layout","y","View","style","styles","content","top","background","undefined","pointerEvents","topSafeArea","color","animatedStyle","create","flex","height","backgroundColor","position","left","right"],"sourceRoot":"../../../../../src","sources":["components/screen/parts/ScreenFrame.tsx"],"mappings":";;;AAAA,SAAiCA,WAAW,EAAEC,UAAU,EAAEC,QAAQ,QAAQ,OAAO;AAGjF,OAAOC,QAAQ,MAAM,yBAAyB;AAC9C,SAASC,UAAU,QAAQ,wBAAwB;AAGnD,SAASC,6BAA6B;AACtC,SAASC,cAAc;AAA2B,SAAAC,GAAA,IAAAC,IAAA,EAAAC,QAAA,IAAAC,SAAA,EAAAC,IAAA,IAAAC,KAAA;AAElD,OAAO,SAASC,WAAWA,CAAC;EAAEC,QAAQ;EAAEC;AAAyD,CAAC,EAAE;EAClG,MAAMC,UAAU,GAAGf,UAAU,CAACI,6BAA6B,CAAC;EAC5D,MAAM,CAACY,QAAQ,EAAEC,WAAW,CAAC,GAAGhB,QAAQ,CAAC,CAAC,CAAC;EAC3C,MAAMiB,QAAQ,GAAGnB,WAAW,CAAEoB,KAAwB,IAAK;IACzD;IACAF,WAAW,CAACE,KAAK,CAACC,WAAW,CAACC,MAAM,CAACC,CAAC,CAAC;EACzC,CAAC,EAAE,EAAE,CAAC;EAEN,oBACEX,KAAA,CAAAF,SAAA;IAAAI,QAAA,gBACEN,IAAA,CAACF,cAAc;MAACS,KAAK,EAAEA,KAAM;MAAAD,QAAA,eAC3BN,IAAA,CAACgB,IAAI;QAACC,KAAK,EAAEC,MAAM,CAACC,OAAQ;QAACR,QAAQ,EAAEA,QAAS;QAAAL,QAAA,EAC7CA;MAAQ,CACL;IAAC,CACO,CAAC,EAChBC,KAAK,CAACa,GAAG,IAAIZ,UAAU,EAAEa,UAAU,KAAKC,SAAS,iBAChDtB,IAAA,CAACL,QAAQ,CAACqB,IAAI;MACZO,aAAa,EAAC,MAAM;MACpBN,KAAK,EAAE,CACLC,MAAM,CAACM,WAAW,CAACf,QAAQ,EAAED,UAAU,CAACa,UAAU,CAACI,KAAK,CAAC,EACzDjB,UAAU,CAACa,UAAU,CAACK,aAAa;IACnC,CACH,CACF;EAAA,CACD,CAAC;AAEP;AAEA,MAAMR,MAAM,GAAGtB,UAAU,CAAC+B,MAAM,CAAC,OAAO;EACtCR,OAAO,EAAE;IAAES,IAAI,EAAE;EAAE,CAAC;EACpBJ,WAAW,EAAEA,CAACK,MAAc,EAAEC,eAAuB,MAAM;IACzDC,QAAQ,EAAE,UAAU;IACpBX,GAAG,EAAE,CAAC;IACNY,IAAI,EAAE,CAAC;IACPC,KAAK,EAAE,CAAC;IACRJ,MAAM;IACNC;EACF,CAAC;AACH,CAAC,CAAC,CAAC","ignoreList":[]}
+{"version":3,"names":["useCallback","useContext","useState","Animated","StyleSheet","ScreenHeaderAppearanceContext","ScreenSafeArea","jsx","_jsx","Fragment","_Fragment","jsxs","_jsxs","ScreenFrame","children","edges","appearance","topInset","setTopInset","onLayout","event","nativeEvent","layout","y","View","collapsable","style","styles","content","top","background","undefined","pointerEvents","topSafeArea","color","animatedStyle","create","flex","height","backgroundColor","position","left","right"],"sourceRoot":"../../../../../src","sources":["components/screen/parts/ScreenFrame.tsx"],"mappings":";;;AAAA,SAAiCA,WAAW,EAAEC,UAAU,EAAEC,QAAQ,QAAQ,OAAO;AAGjF,OAAOC,QAAQ,MAAM,yBAAyB;AAC9C,SAASC,UAAU,QAAQ,wBAAwB;AAGnD,SAASC,6BAA6B;AACtC,SAASC,cAAc;AAA2B,SAAAC,GAAA,IAAAC,IAAA,EAAAC,QAAA,IAAAC,SAAA,EAAAC,IAAA,IAAAC,KAAA;AAElD,OAAO,SAASC,WAAWA,CAAC;EAAEC,QAAQ;EAAEC;AAAyD,CAAC,EAAE;EAClG,MAAMC,UAAU,GAAGf,UAAU,CAACI,6BAA6B,CAAC;EAC5D,MAAM,CAACY,QAAQ,EAAEC,WAAW,CAAC,GAAGhB,QAAQ,CAAC,CAAC,CAAC;EAC3C,MAAMiB,QAAQ,GAAGnB,WAAW,CAAEoB,KAAwB,IAAK;IACzD;IACAF,WAAW,CAACE,KAAK,CAACC,WAAW,CAACC,MAAM,CAACC,CAAC,CAAC;EACzC,CAAC,EAAE,EAAE,CAAC;EAEN,oBACEX,KAAA,CAAAF,SAAA;IAAAI,QAAA,gBACEN,IAAA,CAACF,cAAc;MAACS,KAAK,EAAEA,KAAM;MAAAD,QAAA,eAQ3BN,IAAA,CAACgB,IAAI;QAACC,WAAW,EAAE,KAAM;QAACC,KAAK,EAAEC,MAAM,CAACC,OAAQ;QAACT,QAAQ,EAAEA,QAAS;QAAAL,QAAA,EACjEA;MAAQ,CACL;IAAC,CACO,CAAC,EAChBC,KAAK,CAACc,GAAG,IAAIb,UAAU,EAAEc,UAAU,KAAKC,SAAS,iBAChDvB,IAAA,CAACL,QAAQ,CAACqB,IAAI;MACZQ,aAAa,EAAC,MAAM;MACpBN,KAAK,EAAE,CACLC,MAAM,CAACM,WAAW,CAAChB,QAAQ,EAAED,UAAU,CAACc,UAAU,CAACI,KAAK,CAAC,EACzDlB,UAAU,CAACc,UAAU,CAACK,aAAa;IACnC,CACH,CACF;EAAA,CACD,CAAC;AAEP;AAEA,MAAMR,MAAM,GAAGvB,UAAU,CAACgC,MAAM,CAAC,OAAO;EACtCR,OAAO,EAAE;IAAES,IAAI,EAAE;EAAE,CAAC;EACpBJ,WAAW,EAAEA,CAACK,MAAc,EAAEC,eAAuB,MAAM;IACzDC,QAAQ,EAAE,UAAU;IACpBX,GAAG,EAAE,CAAC;IACNY,IAAI,EAAE,CAAC;IACPC,KAAK,EAAE,CAAC;IACRJ,MAAM;IACNC;EACF,CAAC;AACH,CAAC,CAAC,CAAC","ignoreList":[]}

package/lib/typescript/src/components/screen/Screen.d.ts

@@ -40,7 +40,10 @@ export interface ScreenProps extends ViewProps {
      * @defaultValue "surface.canvas"
      */
     background?: ColorToken;
-    /** @deprecated Has no effect. Bottom safe-area clearance is detected automatically. */
+    /**
+     * @deprecated Has no effect. A tab bar is part of the bottom safe area the
+     * scroll container already clears; nothing needs to declare it.
+     */
     inTabView?: boolean;
     /**
      * Axes that receive `layout.screen.padding` content padding in scroll containers.
@@ -48,7 +51,24 @@ export interface ScreenProps extends ViewProps {
      * @defaultValue "all"
      */
     contentPadding?: ScreenContentPadding;
-    /** Native safe-area edges applied once to the root. @defaultValue "auto" */
+    /**
+     * Native safe-area edges the screen protects. Applied once, at the root.
+     *
+     * The bottom edge is handed to the primary vertical scroll container when there
+     * is one: that container keeps a full-bleed viewport, so its content scrolls
+     * under a tab bar or home indicator and comes to rest clear of it. Every other
+     * edge, and the bottom of a screen with no such container, is padding on the
+     * root frame. Drop `"bottom"` from the list to reserve no room for the bar at
+     * all — see `extraBottomPadding` for adding your own.
+     *
+     * On iOS, a screen with no `Screen.Header` hands both vertical edges to UIKit's
+     * own content-inset adjustment instead: the bar above such a screen is a native
+     * navigation bar, and a native large title only collapses for a scroll view
+     * that fills the screen. Do not also pass `contentInsetAdjustmentBehavior` to
+     * the container there — the default already asks UIKit for it.
+     *
+     * @defaultValue "auto"
+     */
     safeArea?: ScreenSafeAreaPolicy;
     /** @deprecated Use contentPadding. */
     margins?: ScreenMargins;
@@ -71,9 +91,11 @@ type ScreenComponent = ReturnType<typeof forwardRef<ComponentRef<typeof View>, S
  * Themed screen root with shared scroll state and a local header portal.
  *
  * Pair a `Screen.Header` child with one primary `Screen.ScrollView`
- * or `Screen.List`. The root applies safe-area clearance to all children;
- * scroll containers add themed content padding and header clearance. The ref targets
- * the root View, not the scroll container.
+ * or `Screen.List`. The root applies safe-area clearance to all children, except
+ * the bottom edge when that primary container is vertical — it pads that inset
+ * into the end of its own content instead, so content scrolls under a bottom bar
+ * rather than stopping above it. Scroll containers add themed content padding and
+ * header clearance. The ref targets the root View, not the scroll container.
  *
  * @example
  * ```tsx

package/lib/typescript/src/components/screen/Screen.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Screen.d.ts","sourceRoot":"","sources":["../../../../../src/components/screen/Screen.tsx"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,wBAAwB,EAC7B,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,QAAQ,EACR,UAAU,EAEV,KAAK,iBAAiB,EACtB,KAAK,SAAS,EAEf,MAAM,OAAO,CAAC;AACf,OAAO,EAAE,IAAI,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAIpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAM/C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAkB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAc,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,oBAAoB,EAAE,aAAa,EAAE,cAAc,IAAI,oBAAoB,EAAE,MAAM,YAAS,CAAC;AAG3G,qFAAqF;AACrF,MAAM,MAAM,iBAAiB,CAAC,CAAC,SAAS,WAAW,GAAG,OAAO,QAAQ,IAAI,iBAAiB,CACxF;IACE;;;;OAIG;IACH,EAAE,CAAC,EAAE,CAAC,CAAC;CACR,GAAG,IAAI,CAAC,wBAAwB,CAAC,CAAC,CAAC,EAAE,UAAU,CAAC,CAClD,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,iBAAS,YAAY,CAAC,CAAC,SAAS,WAAW,GAAG,OAAO,QAAQ,EAAE,EAC7D,QAAQ,EACR,EAAE,EACF,GAAG,IAAI,EACR,EAAE,iBAAiB,CAAC,CAAC,CAAC,+BAOtB;kBAXQ,YAAY;;;AA+BrB,uFAAuF;AACvF,MAAM,WAAW,WAAY,SAAQ,SAAS;IAC5C,qFAAqF;IACrF,QAAQ,EAAE,SAAS,CAAC;IACpB;;;;OAIG;IACH,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,uFAAuF;IACvF,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;OAIG;IACH,cAAc,CAAC,EAAE,oBAAoB,CAAC;IACtC,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC,sCAAsC;IACtC,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB;;OAEG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,KAAK,eAAe,GAAG,UAAU,CAAC,OAAO,UAAU,CAAC,YAAY,CAAC,OAAO,IAAI,CAAC,EAAE,WAAW,CAAC,CAAC,GAAG;IAC7F,2DAA2D;IAC3D,MAAM,EAAE,OAAO,YAAY,CAAC;IAC5B,6EAA6E;IAC7E,UAAU,EAAE,OAAO,gBAAgB,CAAC;IACpC,kEAAkE;IAClE,QAAQ,EAAE,OAAO,cAAc,CAAC;IAChC,sEAAsE;IACtE,IAAI,EAAE,OAAO,UAAU,CAAC;CACzB,CAAC;AA6CF;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,MAAM,iBAAa,CAAC"}
+{"version":3,"file":"Screen.d.ts","sourceRoot":"","sources":["../../../../../src/components/screen/Screen.tsx"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,wBAAwB,EAC7B,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,QAAQ,EACR,UAAU,EAEV,KAAK,iBAAiB,EAEtB,KAAK,SAAS,EAEf,MAAM,OAAO,CAAC;AACf,OAAO,EAAY,IAAI,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAI9D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAM/C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAkB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAc,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,oBAAoB,EAAE,aAAa,EAAE,cAAc,IAAI,oBAAoB,EAAE,MAAM,YAAS,CAAC;AAG3G,qFAAqF;AACrF,MAAM,MAAM,iBAAiB,CAAC,CAAC,SAAS,WAAW,GAAG,OAAO,QAAQ,IAAI,iBAAiB,CACxF;IACE;;;;OAIG;IACH,EAAE,CAAC,EAAE,CAAC,CAAC;CACR,GAAG,IAAI,CAAC,wBAAwB,CAAC,CAAC,CAAC,EAAE,UAAU,CAAC,CAClD,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,iBAAS,YAAY,CAAC,CAAC,SAAS,WAAW,GAAG,OAAO,QAAQ,EAAE,EAC7D,QAAQ,EACR,EAAE,EACF,GAAG,IAAI,EACR,EAAE,iBAAiB,CAAC,CAAC,CAAC,+BAOtB;kBAXQ,YAAY;;;AA+DrB,uFAAuF;AACvF,MAAM,WAAW,WAAY,SAAQ,SAAS;IAC5C,qFAAqF;IACrF,QAAQ,EAAE,SAAS,CAAC;IACpB;;;;OAIG;IACH,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;OAIG;IACH,cAAc,CAAC,EAAE,oBAAoB,CAAC;IACtC;;;;;;;;;;;;;;;;;OAiBG;IACH,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC,sCAAsC;IACtC,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB;;OAEG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,KAAK,eAAe,GAAG,UAAU,CAAC,OAAO,UAAU,CAAC,YAAY,CAAC,OAAO,IAAI,CAAC,EAAE,WAAW,CAAC,CAAC,GAAG;IAC7F,2DAA2D;IAC3D,MAAM,EAAE,OAAO,YAAY,CAAC;IAC5B,6EAA6E;IAC7E,UAAU,EAAE,OAAO,gBAAgB,CAAC;IACpC,kEAAkE;IAClE,QAAQ,EAAE,OAAO,cAAc,CAAC;IAChC,sEAAsE;IACtE,IAAI,EAAE,OAAO,UAAU,CAAC;CACzB,CAAC;AAgIF;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,MAAM,iBAAa,CAAC"}

package/lib/typescript/src/components/screen/ScreenContext.d.ts

@@ -14,6 +14,39 @@ export interface ScreenContextValue {
     contentPadding: ScreenContentPadding;
     /** Safe-area policy applied by the root; descendants must not reapply it. */
     safeArea: ScreenSafeArea;
+    /**
+     * Whether the primary scroll container pads the bottom safe area itself.
+     *
+     * True when the policy protects the bottom edge *and* the root found a vertical
+     * scroll container to hand it to. The root then leaves that edge off the frame,
+     * so the container keeps a full-bleed viewport and its content passes under the
+     * bar; the container pays the inset back at the end of its content instead.
+     * False leaves the bottom to the frame, which is what a screen of plain children
+     * or a horizontal container needs.
+     */
+    contentOwnsBottomInset: boolean;
+    /**
+     * Whether the platform's own content-inset adjustment pays the vertical insets.
+     *
+     * True on an iOS screen with no `Screen.Header`: the navigation bar above such a
+     * screen is UIKit's, and only UIKit can inset a scroll view for one — a native
+     * large title resizes on every frame of its collapse, and it refuses to collapse
+     * at all for a scroll view that does not fill the screen. The frame therefore
+     * keeps no vertical edge, the container asks for
+     * `contentInsetAdjustmentBehavior: "automatic"` rather than `"never"`, and
+     * `contentOwnsBottomInset` stays false because UIKit pays that edge too.
+     */
+    platformAdjustsInsets: boolean;
+    /**
+     * Whether this screen *would* hand its vertical insets to the platform, if it
+     * found a vertical scroll container among its children.
+     *
+     * Everything `platformAdjustsInsets` needs except the container itself. The two
+     * differ only when the container is nested inside another component, where the
+     * root cannot see it — which is a mistake on such a screen, and the difference
+     * is how a mounting container detects that it was the one missed.
+     */
+    platformInsetsEligible: boolean;
     /** @deprecated Use contentPadding. */
     margins: ScreenContentPadding;
     /** Whether a `Screen.Header` is present. Used by scroll containers to add top inset. */
@@ -50,6 +83,12 @@ export interface ScreenScrollProviderProps {
     /** Which axes scroll containers pad with `layout.screen.padding`. Default `'all'`. */
     contentPadding?: ScreenContentPadding;
     safeArea?: ScreenSafeArea;
+    /** Whether the primary scroll container pads the bottom safe area. Default false. */
+    contentOwnsBottomInset?: boolean;
+    /** Whether the platform adjusts the scroll container's vertical insets. Default false. */
+    platformAdjustsInsets?: boolean;
+    /** Whether the screen qualifies for that, container aside. Default false. */
+    platformInsetsEligible?: boolean;
     /** Whether a `Screen.Header` child is present. Default false. */
     hasHeader?: boolean;
     /** Resolved background color shared with scroll containers. */
@@ -59,7 +98,7 @@ export interface ScreenScrollProviderProps {
  * Owns the screen's shared scroll ref, offset, snap offsets, and header collapse
  * metrics. Scroll containers bind the ref via {@link useScreen}.
  */
-export declare function ScreenScrollProvider({ background, children, contentPadding, safeArea, hasHeader, }: ScreenScrollProviderProps): import("react").JSX.Element;
+export declare function ScreenScrollProvider({ background, children, contentPadding, safeArea, contentOwnsBottomInset, platformAdjustsInsets, platformInsetsEligible, hasHeader, }: ScreenScrollProviderProps): import("react").JSX.Element;
 /**
  * Reads the nearest `Screen`'s configuration, shared scroll state, and ref.
  * Read `scrollY.value` in Reanimated worklets to animate without React renders.

package/lib/typescript/src/components/screen/ScreenContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ScreenContext.d.ts","sourceRoot":"","sources":["../../../../../src/components/screen/ScreenContext.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,SAAS,EAA8C,MAAM,OAAO,CAAC;AAElG,OAAO,QAAQ,EAAE,EACf,KAAK,WAAW,EAChB,KAAK,sBAAsB,EAC3B,KAAK,WAAW,EAIjB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,KAAK,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,YAAS,CAAC;AAEpE,6EAA6E;AAC7E,MAAM,MAAM,eAAe,GAAG,WAAW,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;AAE/D,yDAAyD;AACzD,eAAO,MAAM,yBAAyB,kBAAkB,CAAC;AAEzD,gFAAgF;AAChF,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,cAAc,EAAE,oBAAoB,CAAC;IACrC,6EAA6E;IAC7E,QAAQ,EAAE,cAAc,CAAC;IACzB,sCAAsC;IACtC,OAAO,EAAE,oBAAoB,CAAC;IAC9B,wFAAwF;IACxF,SAAS,EAAE,OAAO,CAAC;IACnB,8EAA8E;IAC9E,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC7B;;;OAGG;IACH,oBAAoB,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC1C;;;OAGG;IACH,iBAAiB,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IACxC,iGAAiG;IACjG,uBAAuB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAClD;;;;OAIG;IACH,SAAS,EAAE,eAAe,CAAC;IAC3B,yDAAyD;IACzD,aAAa,EAAE,sBAAsB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAE/D,+DAA+D;IAC/D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,aAAa,oDAAiD,CAAC;AAE5E,4DAA4D;AAC5D,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,SAAS,CAAC;IACpB,sFAAsF;IACtF,cAAc,CAAC,EAAE,oBAAoB,CAAC;IACtC,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,iEAAiE;IACjE,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB,+DAA+D;IAC/D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,EACnC,UAA0B,EAC1B,QAAQ,EACR,cAAsB,EACtB,QAAiB,EACjB,SAAiB,GAClB,EAAE,yBAAyB,+BAkD3B;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,SAAS,IAAI,kBAAkB,CAM9C"}
+{"version":3,"file":"ScreenContext.d.ts","sourceRoot":"","sources":["../../../../../src/components/screen/ScreenContext.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,SAAS,EAA8C,MAAM,OAAO,CAAC;AAElG,OAAO,QAAQ,EAAE,EACf,KAAK,WAAW,EAChB,KAAK,sBAAsB,EAC3B,KAAK,WAAW,EAIjB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,KAAK,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,YAAS,CAAC;AAEpE,6EAA6E;AAC7E,MAAM,MAAM,eAAe,GAAG,WAAW,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;AAE/D,yDAAyD;AACzD,eAAO,MAAM,yBAAyB,kBAAkB,CAAC;AAEzD,gFAAgF;AAChF,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,cAAc,EAAE,oBAAoB,CAAC;IACrC,6EAA6E;IAC7E,QAAQ,EAAE,cAAc,CAAC;IACzB;;;;;;;;;OASG;IACH,sBAAsB,EAAE,OAAO,CAAC;IAChC;;;;;;;;;;OAUG;IACH,qBAAqB,EAAE,OAAO,CAAC;IAC/B;;;;;;;;OAQG;IACH,sBAAsB,EAAE,OAAO,CAAC;IAChC,sCAAsC;IACtC,OAAO,EAAE,oBAAoB,CAAC;IAC9B,wFAAwF;IACxF,SAAS,EAAE,OAAO,CAAC;IACnB,8EAA8E;IAC9E,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC7B;;;OAGG;IACH,oBAAoB,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC1C;;;OAGG;IACH,iBAAiB,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IACxC,iGAAiG;IACjG,uBAAuB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAClD;;;;OAIG;IACH,SAAS,EAAE,eAAe,CAAC;IAC3B,yDAAyD;IACzD,aAAa,EAAE,sBAAsB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAE/D,+DAA+D;IAC/D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,aAAa,oDAAiD,CAAC;AAE5E,4DAA4D;AAC5D,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,SAAS,CAAC;IACpB,sFAAsF;IACtF,cAAc,CAAC,EAAE,oBAAoB,CAAC;IACtC,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,qFAAqF;IACrF,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,0FAA0F;IAC1F,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,6EAA6E;IAC7E,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,iEAAiE;IACjE,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB,+DAA+D;IAC/D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,EACnC,UAA0B,EAC1B,QAAQ,EACR,cAAsB,EACtB,QAAiB,EACjB,sBAA8B,EAC9B,qBAA6B,EAC7B,sBAA8B,EAC9B,SAAiB,GAClB,EAAE,yBAAyB,+BAwD3B;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,SAAS,IAAI,kBAAkB,CAM9C"}

package/lib/typescript/src/components/screen/ScreenList.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ScreenList.d.ts","sourceRoot":"","sources":["../../../../../src/components/screen/ScreenList.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"ScreenList.d.ts","sourceRoot":"","sources":["../../../../../src/components/screen/ScreenList.tsx"],"names":[],"mappings":"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"}

package/lib/typescript/src/components/screen/ScreenScrollView.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ScreenScrollView.d.ts","sourceRoot":"","sources":["../../../../../src/components/screen/ScreenScrollView.tsx"],"names":[],"mappings":"AAAA,OAAO,EAA2C,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAChF,OAAO,EAAmB,KAAK,eAAe,EAAE,KAAK,SAAS,EAAQ,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAW3G,OAAO,KAAK,EAAwB,qBAAqB,EAAE,MAAM,YAAS,CAAC;AAG3E,qFAAqF;AACrF,MAAM,WAAW,qBAAsB,SAAQ,IAAI,CAAC,eAAe,EAAE,YAAY,CAAC,EAAE,qBAAqB;IACvG,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,iEAAiE;IACjE,YAAY,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IACpC,uFAAuF;IACvF,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,gBAAgB,8MA2D5B,CAAC"}
+{"version":3,"file":"ScreenScrollView.d.ts","sourceRoot":"","sources":["../../../../../src/components/screen/ScreenScrollView.tsx"],"names":[],"mappings":"AAAA,OAAO,EAA2C,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAChF,OAAO,EAAmB,KAAK,eAAe,EAAE,KAAK,SAAS,EAAQ,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAa3G,OAAO,KAAK,EAAwB,qBAAqB,EAAE,MAAM,YAAS,CAAC;AAG3E,qFAAqF;AACrF,MAAM,WAAW,qBAAsB,SAAQ,IAAI,CAAC,eAAe,EAAE,YAAY,CAAC,EAAE,qBAAqB;IACvG,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,iEAAiE;IACjE,YAAY,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IACpC,uFAAuF;IACvF,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,gBAAgB,8MA6E5B,CAAC"}

package/lib/typescript/src/components/screen/hooks/use-nested-container-warning.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Warns, in development, when this container is the one the screen root failed
+ * to find.
+ *
+ * The root inspects its own children and fragments but does not execute
+ * component children, so a container rendered inside one is invisible to it (see
+ * `hasScrollContainerOwningBottom`). On a header-less iOS screen that changes
+ * behaviour rather than just bookkeeping: the frame pads the top edge, the scroll
+ * view no longer fills the screen, and UIKit stops collapsing the native large
+ * title — silently, with the screen otherwise looking correct.
+ *
+ * The container is the only place that can tell. `platformInsetsEligible` says
+ * the screen qualified; a container mounting while `platformAdjustsInsets` is
+ * false says the root never saw it. Both true together mean exactly this mistake,
+ * so there is nothing here to false-positive on: a screen with no scroll
+ * container at all never runs this hook, and a deliberate `safeArea` opt-out is
+ * not eligible in the first place.
+ *
+ * @param container Name to report, e.g. `"Screen.List"`.
+ * @param horizontal Whether this container scrolls horizontally; those are never
+ *   candidates for the vertical insets and never warn.
+ */
+export declare function useNestedContainerWarning(container: string, horizontal: boolean): void;
+//# sourceMappingURL=use-nested-container-warning.d.ts.map

package/lib/typescript/src/components/screen/hooks/use-nested-container-warning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-nested-container-warning.d.ts","sourceRoot":"","sources":["../../../../../../src/components/screen/hooks/use-nested-container-warning.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,GAAG,IAAI,CAatF"}

package/lib/typescript/src/components/screen/parts/ScreenBottomInset.android.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Android's bottom safe area as scroll content — see the iOS file for why this
+ * is a native view rather than a measured inset.
+ *
+ * `insetType: "all"` is the same combination the Screen frame uses: system insets
+ * plus native interface insets, which is what carries a native tab bar. The frame
+ * leaves the bottom edge unconsumed when the content owns it, so this view still
+ * sees the inset and is the one to consume it.
+ */
+export declare function ScreenBottomInset(): import("react").JSX.Element;
+//# sourceMappingURL=ScreenBottomInset.android.d.ts.map

package/lib/typescript/src/components/screen/parts/ScreenBottomInset.android.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScreenBottomInset.android.d.ts","sourceRoot":"","sources":["../../../../../../src/components/screen/parts/ScreenBottomInset.android.tsx"],"names":[],"mappings":"AAiBA;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,gCAEhC"}

package/lib/typescript/src/components/screen/parts/ScreenBottomInset.d.ts

@@ -0,0 +1,17 @@
+/**
+ * The bottom safe area as a piece of scroll content rather than frame padding.
+ *
+ * A scroll container that yields its bottom edge to the content (see
+ * `contentOwnsBottomInset`) keeps a full-bleed viewport, so its rows pass under
+ * a tab bar or home indicator instead of stopping above one. This spacer is what
+ * keeps the *end* of that content clear of the bar: an empty safe-area view whose
+ * own padding is its whole height.
+ *
+ * Deliberately a native safe-area view rather than a measured number. The inset
+ * that matters here includes bars this screen does not own — a native tab bar is
+ * a sibling view, not a window inset — and asking the platform for padding gets
+ * the same answer the frame would have applied, on both platforms, without a JS
+ * round trip through a value that lands a frame late.
+ */
+export declare function ScreenBottomInset(): import("react").JSX.Element;
+//# sourceMappingURL=ScreenBottomInset.d.ts.map

package/lib/typescript/src/components/screen/parts/ScreenBottomInset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScreenBottomInset.d.ts","sourceRoot":"","sources":["../../../../../../src/components/screen/parts/ScreenBottomInset.tsx"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,gCAEhC"}

package/lib/typescript/src/components/screen/parts/ScreenFrame.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ScreenFrame.d.ts","sourceRoot":"","sources":["../../../../../../src/components/screen/parts/ScreenFrame.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,iBAAiB,EAAqC,MAAM,OAAO,CAAC;AAMlF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAU,CAAC;AAIpD,wBAAgB,WAAW,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,iBAAiB,CAAC;IAAE,KAAK,EAAE,mBAAmB,CAAA;CAAE,CAAC,+BA0BjG"}
+{"version":3,"file":"ScreenFrame.d.ts","sourceRoot":"","sources":["../../../../../../src/components/screen/parts/ScreenFrame.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,iBAAiB,EAAqC,MAAM,OAAO,CAAC;AAMlF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAU,CAAC;AAIpD,wBAAgB,WAAW,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,iBAAiB,CAAC;IAAE,KAAK,EAAE,mBAAmB,CAAA;CAAE,CAAC,+BAiCjG"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-terra-ui",
-  "version": "0.8.1",
+  "version": "0.9.1",
   "description": "Themeable React Native UI components built on react-native-unistyles",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",

package/src/components/screen/Screen.tsx

@@ -7,12 +7,13 @@ import {
   forwardRef,
   isValidElement,
   type PropsWithChildren,
+  type ReactElement,
   type ReactNode,
   useMemo,
 } from "react";
-import { View, type ViewProps } from "react-native";
+import { Platform, View, type ViewProps } from "react-native";
 
-import { StyleSheet, useUnistyles } from "react-native-unistyles";
+import { useUnistyles } from "react-native-unistyles";
 
 import type { ColorToken } from "#theme/types";
 import { resolveThemeColor } from "#utils/resolve-theme-color";
@@ -64,6 +65,38 @@ function ScreenHeader<T extends ElementType = typeof Fragment>({
 }
 ScreenHeader.displayName = "Screen.Header";
 
+/**
+ * Whether this child is a vertical scroll container that can pad its own bottom
+ * inset. A horizontal one cannot: bottom padding does nothing for it, so the
+ * frame keeps that edge.
+ */
+function ownsBottomInset(child: ReactElement): boolean {
+  if ((child.props as { horizontal?: boolean }).horizontal) return false;
+  if (child.type === ScreenScrollView || child.type === ScreenList) return true;
+  // Fast Refresh can retain an older function identity in existing child elements.
+  const { displayName } = child.type as { displayName?: string };
+  return displayName === "Screen.ScrollView" || displayName === "Screen.List";
+}
+
+/**
+ * Whether the screen has such a container among its children. Inspects fragments,
+ * but does not execute arbitrary child components — a container nested inside one
+ * is not found, and the frame keeps the bottom edge.
+ */
+function hasScrollContainerOwningBottom(children: ReactNode): boolean {
+  let found = false;
+  Children.forEach(children, (child) => {
+    if (found) return;
+    if (!isValidElement(child)) return;
+    if (child.type === Fragment) {
+      found = hasScrollContainerOwningBottom((child.props as PropsWithChildren).children);
+      return;
+    }
+    found = ownsBottomInset(child);
+  });
+  return found;
+}
+
 /** Inspect fragments, but do not execute arbitrary child components. */
 function hasScreenHeader(children: ReactNode): boolean {
   let found = false;
@@ -91,7 +124,10 @@ export interface ScreenProps extends ViewProps {
    * @defaultValue "surface.canvas"
    */
   background?: ColorToken;
-  /** @deprecated Has no effect. Bottom safe-area clearance is detected automatically. */
+  /**
+   * @deprecated Has no effect. A tab bar is part of the bottom safe area the
+   * scroll container already clears; nothing needs to declare it.
+   */
   inTabView?: boolean;
   /**
    * Axes that receive `layout.screen.padding` content padding in scroll containers.
@@ -99,7 +135,24 @@ export interface ScreenProps extends ViewProps {
    * @defaultValue "all"
    */
   contentPadding?: ScreenContentPadding;
-  /** Native safe-area edges applied once to the root. @defaultValue "auto" */
+  /**
+   * Native safe-area edges the screen protects. Applied once, at the root.
+   *
+   * The bottom edge is handed to the primary vertical scroll container when there
+   * is one: that container keeps a full-bleed viewport, so its content scrolls
+   * under a tab bar or home indicator and comes to rest clear of it. Every other
+   * edge, and the bottom of a screen with no such container, is padding on the
+   * root frame. Drop `"bottom"` from the list to reserve no room for the bar at
+   * all — see `extraBottomPadding` for adding your own.
+   *
+   * On iOS, a screen with no `Screen.Header` hands both vertical edges to UIKit's
+   * own content-inset adjustment instead: the bar above such a screen is a native
+   * navigation bar, and a native large title only collapses for a scroll view
+   * that fills the screen. Do not also pass `contentInsetAdjustmentBehavior` to
+   * the container there — the default already asks UIKit for it.
+   *
+   * @defaultValue "auto"
+   */
   safeArea?: ScreenSafeAreaPolicy;
   /** @deprecated Use contentPadding. */
   margins?: ScreenMargins;
@@ -137,19 +190,102 @@ const ScreenBase = forwardRef<ComponentRef<typeof View>, ScreenProps>(function S
   const hasHeader = useMemo(() => hasScreenHeader(children), [children]);
   const resolvedMargins = contentPadding ?? margins ?? (hasMargins === false ? "none" : "all");
   const edges = useMemo(() => resolveSafeAreaEdges(safeArea), [safeArea]);
+  const hasVerticalScrollContainer = useMemo(() => hasScrollContainerOwningBottom(children), [children]);
+  /*
+    A screen with no `Screen.Header` wears UIKit's own navigation bar, and only
+    UIKit can inset a scroll view for one.
+
+    A native large title changes height on every frame of its collapse, and the
+    bar is a sibling view this screen cannot measure — so an inset computed in JS
+    is always a frame late and always the wrong size. Worse, UIKit will not
+    collapse the title at all unless the scroll view it finds fills the screen:
+    padding the top edge on the frame starts that view 168pt down (measured on an
+    iPhone 17, expanded title), and the title then stays full size while rows
+    scroll up and overprint it.
+
+    So the frame keeps no vertical edge on such a screen, the container turns
+    UIKit's `contentInsetAdjustmentBehavior` back on, and UIKit pays the top and
+    the bottom both — which is why `ScreenBottomInset` stands down here rather
+    than paying that edge a second time. iOS only: this is UIKit's mechanism, and
+    Android has no navigation bar to track.
+
+    Both vertical edges have to be protected to hand them over, because UIKit
+    adjusts for both or for neither. A policy that asks for one and not the other
+    cannot be expressed this way, so it keeps the ordinary treatment below and
+    is honoured exactly as written — at the cost of the title collapse, which is
+    the better trade: an edge list is an explicit instruction, and silently
+    insetting an edge the caller excluded would be the worse surprise.
+  */
+  const platformInsetsEligible = Platform.OS === "ios" && !hasHeader && edges.top && edges.bottom;
+  const platformAdjustsInsets = platformInsetsEligible && hasVerticalScrollContainer;
+  /*
+    Otherwise the bottom edge goes to the scroll container when there is one to
+    take it.
+
+    Applied to the frame, the bottom inset shrinks the scroll viewport, so content
+    stops above a tab bar rather than passing beneath it — and on iOS that inset
+    includes the bar itself, which UIKit folds into a tab screen's safe area. The
+    container reaches the same resting position by padding the end of its content
+    instead, which is how the platform's own content-inset adjustment behaves.
+  */
+  const contentOwnsBottomInset = !platformAdjustsInsets && edges.bottom && hasVerticalScrollContainer;
+  const frameEdges = useMemo(
+    () =>
+      platformAdjustsInsets
+        ? { ...edges, top: false, bottom: false }
+        : contentOwnsBottomInset
+          ? { ...edges, bottom: false }
+          : edges,
+    [platformAdjustsInsets, contentOwnsBottomInset, edges]
+  );
   const { theme } = useUnistyles();
   const resolvedBackground = resolveThemeColor(background, theme) ?? theme.color["surface.canvas"];
+  /*
+    A plain object, not a Unistyles stylesheet, and the background belongs in it
+    rather than arriving later.
+
+    Unistyles applies a dynamic function's style after mount. UIKit resolves a
+    screen's scroll view once, while it is being presented, and a scroll area
+    that was not yet the size of the screen at that moment never drives the
+    navigation bar afterwards — the large title stays expanded for the rest of
+    the screen's life.
+  */
+  const rootStyle = useMemo(
+    () => ({ flex: 1, backgroundColor: resolvedBackground }) as const,
+    [resolvedBackground]
+  );
 
   return (
-    <View ref={ref} style={[styles.container(resolvedBackground), style]} {...rest}>
+    /*
+      `collapsable={false}`, because a background colour alone is the worst of
+      both worlds here.
+
+      Fabric decides two things separately: whether a view is mounted at all, and
+      whether it *keeps* its children. A `View` with only layout styles is
+      dropped and its children are re-parented to its own parent — harmless. Give
+      it a background and it is mounted, but it still does not form a stacking
+      context, so the children are mounted *beside* it instead of inside it. The
+      screen's view then begins with an empty full-screen view, and UIKit — which
+      finds the scroll view by walking first subviews down from the view
+      controller (`RNSScrollViewFinder` mirrors the same walk) — reaches that dead
+      end and finds nothing. Measured on an iPhone 17: no content-inset
+      adjustment and no large-title collapse at all.
+
+      `collapsable={false}` forms the stacking context, so the frame, the safe
+      areas, and the scroll container stay in one unbroken first-subview chain.
+    */
+    <View collapsable={false} ref={ref} style={[rootStyle, style]} {...rest}>
       <ScreenScrollProvider
         background={resolvedBackground}
         contentPadding={resolvedMargins}
         safeArea={safeArea}
+        contentOwnsBottomInset={contentOwnsBottomInset}
+        platformAdjustsInsets={platformAdjustsInsets}
+        platformInsetsEligible={platformInsetsEligible}
         hasHeader={hasHeader}
       >
         <ScreenHeaderAppearanceProvider>
-          <ScreenFrame edges={edges}>
+          <ScreenFrame edges={frameEdges}>
             <PortalProvider>{children}</PortalProvider>
           </ScreenFrame>
         </ScreenHeaderAppearanceProvider>
@@ -167,9 +303,11 @@ ScreenBase.List = ScreenList;
  * Themed screen root with shared scroll state and a local header portal.
  *
  * Pair a `Screen.Header` child with one primary `Screen.ScrollView`
- * or `Screen.List`. The root applies safe-area clearance to all children;
- * scroll containers add themed content padding and header clearance. The ref targets
- * the root View, not the scroll container.
+ * or `Screen.List`. The root applies safe-area clearance to all children, except
+ * the bottom edge when that primary container is vertical — it pads that inset
+ * into the end of its own content instead, so content scrolls under a bottom bar
+ * rather than stopping above it. Scroll containers add themed content padding and
+ * header clearance. The ref targets the root View, not the scroll container.
  *
  * @example
  * ```tsx
@@ -180,10 +318,3 @@ ScreenBase.List = ScreenList;
  * ```
  */
 export const Screen = ScreenBase;
-
-const styles = StyleSheet.create(() => ({
-  container: (backgroundColor: string) => ({
-    flex: 1,
-    backgroundColor,
-  }),
-}));

package/src/components/screen/ScreenContext.tsx

@@ -26,6 +26,39 @@ export interface ScreenContextValue {
   contentPadding: ScreenContentPadding;
   /** Safe-area policy applied by the root; descendants must not reapply it. */
   safeArea: ScreenSafeArea;
+  /**
+   * Whether the primary scroll container pads the bottom safe area itself.
+   *
+   * True when the policy protects the bottom edge *and* the root found a vertical
+   * scroll container to hand it to. The root then leaves that edge off the frame,
+   * so the container keeps a full-bleed viewport and its content passes under the
+   * bar; the container pays the inset back at the end of its content instead.
+   * False leaves the bottom to the frame, which is what a screen of plain children
+   * or a horizontal container needs.
+   */
+  contentOwnsBottomInset: boolean;
+  /**
+   * Whether the platform's own content-inset adjustment pays the vertical insets.
+   *
+   * True on an iOS screen with no `Screen.Header`: the navigation bar above such a
+   * screen is UIKit's, and only UIKit can inset a scroll view for one — a native
+   * large title resizes on every frame of its collapse, and it refuses to collapse
+   * at all for a scroll view that does not fill the screen. The frame therefore
+   * keeps no vertical edge, the container asks for
+   * `contentInsetAdjustmentBehavior: "automatic"` rather than `"never"`, and
+   * `contentOwnsBottomInset` stays false because UIKit pays that edge too.
+   */
+  platformAdjustsInsets: boolean;
+  /**
+   * Whether this screen *would* hand its vertical insets to the platform, if it
+   * found a vertical scroll container among its children.
+   *
+   * Everything `platformAdjustsInsets` needs except the container itself. The two
+   * differ only when the container is nested inside another component, where the
+   * root cannot see it — which is a mistake on such a screen, and the difference
+   * is how a mounting container detects that it was the one missed.
+   */
+  platformInsetsEligible: boolean;
   /** @deprecated Use contentPadding. */
   margins: ScreenContentPadding;
   /** Whether a `Screen.Header` is present. Used by scroll containers to add top inset. */
@@ -65,6 +98,12 @@ export interface ScreenScrollProviderProps {
   /** Which axes scroll containers pad with `layout.screen.padding`. Default `'all'`. */
   contentPadding?: ScreenContentPadding;
   safeArea?: ScreenSafeArea;
+  /** Whether the primary scroll container pads the bottom safe area. Default false. */
+  contentOwnsBottomInset?: boolean;
+  /** Whether the platform adjusts the scroll container's vertical insets. Default false. */
+  platformAdjustsInsets?: boolean;
+  /** Whether the screen qualifies for that, container aside. Default false. */
+  platformInsetsEligible?: boolean;
   /** Whether a `Screen.Header` child is present. Default false. */
   hasHeader?: boolean;
 
@@ -81,6 +120,9 @@ export function ScreenScrollProvider({
   children,
   contentPadding = "all",
   safeArea = "auto",
+  contentOwnsBottomInset = false,
+  platformAdjustsInsets = false,
+  platformInsetsEligible = false,
   hasHeader = false,
 }: ScreenScrollProviderProps) {
   const scrollY = useSharedValue(0);
@@ -108,6 +150,9 @@ export function ScreenScrollProvider({
       background,
       contentPadding,
       safeArea,
+      contentOwnsBottomInset,
+      platformAdjustsInsets,
+      platformInsetsEligible,
       margins: contentPadding,
       hasHeader,
       scrollY,
@@ -121,6 +166,9 @@ export function ScreenScrollProvider({
       background,
       contentPadding,
       safeArea,
+      contentOwnsBottomInset,
+      platformAdjustsInsets,
+      platformInsetsEligible,
       hasHeader,
       scrollY,
       headerCollapseHeight,

package/src/components/screen/ScreenList.tsx

@@ -16,8 +16,10 @@ import { StyleSheet } from "react-native-unistyles";
 
 import { resolveScreenPadding } from "#theme/screen-padding";
 import { PortalHost } from "../portal";
+import { useNestedContainerWarning } from "./hooks/use-nested-container-warning";
 import { useScreenRef } from "./hooks/use-screen-ref";
 import { useScreenScrollHandler } from "./hooks/use-screen-scroll-handler";
+import { ScreenBottomInset } from "./parts/ScreenBottomInset";
 import { renderScreenPlaceholder } from "./parts/ScreenPlaceholder";
 import { SCREEN_HEADER_PORTAL_HOST, useScreen } from "./ScreenContext";
 import type { ScreenContentPadding, ScreenScrollableProps } from "./types";
@@ -172,7 +174,13 @@ const ScreenListBase = forwardRef(function ScreenList(
     headerSnapOffsets,
     contentPadding: screenPadding,
     hasHeader,
+    contentOwnsBottomInset,
+    platformAdjustsInsets,
   } = useScreen();
+  // The root yields the bottom edge only to a vertical container, so a horizontal
+  // one here is a secondary container and must not pay the inset a second time.
+  const ownsBottomInset = contentOwnsBottomInset && !horizontal;
+  useNestedContainerWarning("Screen.List", horizontal);
   const mergedRef = useScreenRef(isDefaultFlatList ? scrollRef : undefined, ref);
   const resolvedPadding = contentPadding ?? margins ?? screenPadding;
   const resolvedLoading = isLoading ?? loading;
@@ -191,6 +199,14 @@ const ScreenListBase = forwardRef(function ScreenList(
       {renderListComponent(ListHeaderComponent)}
     </>
   );
+  const footer = ownsBottomInset ? (
+    <>
+      {renderListComponent(ListFooterComponent)}
+      <ScreenBottomInset />
+    </>
+  ) : (
+    ListFooterComponent
+  );
 
   return (
     <AnimatedComponent
@@ -199,7 +215,12 @@ const ScreenListBase = forwardRef(function ScreenList(
       renderItem={renderItem}
       style={[{ backgroundColor: background }, style]}
       horizontal={horizontal}
-      contentInsetAdjustmentBehavior="never"
+      /*
+        UIKit owns the vertical insets on a header-less iOS screen — see
+        `platformAdjustsInsets`. Everywhere else the frame has already paid them,
+        so a second adjustment here would count them twice.
+      */
+      contentInsetAdjustmentBehavior={platformAdjustsInsets ? "automatic" : "never"}
       automaticallyAdjustContentInsets={false}
       automaticallyAdjustsScrollIndicatorInsets={false}
       contentContainerStyle={[
@@ -207,7 +228,7 @@ const ScreenListBase = forwardRef(function ScreenList(
         contentContainerStyle,
       ]}
       ListHeaderComponent={header}
-      ListFooterComponent={ListFooterComponent}
+      ListFooterComponent={footer}
       ListEmptyComponent={placeholder ?? ListEmptyComponent}
       showsVerticalScrollIndicator={false}
       scrollEventThrottle={16}