fix: dynamic bottomOffset over-scrolling (#1204)

## 📜 Description

Fixed an issue when change of `bottomSheet` with opened keyboard leads
to unexpectedly big scroll.

## 💡 Motivation and Context

The issue is that our `point`/`relativeScrollTo` remains the same. But
when we focus our input we get `scrollPosition.value === 0`. When
scrolling has completed we update that value to an actual scroll
position (let's say to 209). When `bottomOffset` gets changed we scroll
from current position (remember `point` hasn't been changed) but we add
already scrolled distance and we get an incorrect offset.

To overcome this issue we need to reset our scroll position to
"unscrolled" state. In fact we already use that pattern with scroll
restoration (change scroll position, call `maybeScroll`, restore
position). So I decided to create a utility function called
`performScrollWithRestoration` that will substitute scroll to a new
position, do a scrolling and restore original position.

The fix is working well, it fixes a problem in example app and e2e tests
successfully pass 🤞

Closes
#1203

## 📢 Changelog

<!-- High level overview of important changes -->
<!-- For example: fixed status bar manipulation; added new types
declarations; -->
<!-- If your changes don't affect one of platform/language below - then
remove this platform/language -->

### JS

- added `performScrollWithRestoration` utility function;
- call `performScrollWithRestoration` when `bottomOffset` gets changed
(passing `scrollBeforeKeyboardMovement` value).

## 🤔 How Has This Been Tested?

Tested manually in Fabric example, iPhone 16 Pro (iOS 26.0).

## 📸 Screenshots (if appropriate):

|Before|After|
|------|------|
|<video
src="https://github.com/user-attachments/assets/f01235d5-e94a-47fd-9221-fb74d4b495eb">|<video
src="https://github.com/user-attachments/assets/865f0a90-1766-43c7-ab9a-4ff961ba76fe">|

## 📝 Checklist

- [x] CI successfully passed
- [x] I added new mocks and corresponding unit-tests if library API was
changed

Author: kirillzyusko

FabricExample/src/screens/Examples/AwareScrollViewStickyFooter/index.tsx

@@ -1,5 +1,5 @@
 import React, { useCallback, useEffect, useMemo, useState } from "react";
-import { Alert, Button, Text, View } from "react-native";
+import { Button, Text, View } from "react-native";
 import {
   KeyboardAwareScrollView,
   KeyboardStickyView,
@@ -23,6 +23,7 @@ type Variant = (typeof variants)[number];
 export default function AwareScrollViewStickyFooter({ navigation }: Props) {
   const { bottom } = useSafeAreaInsets();
   const [footerHeight, setFooterHeight] = useState(0);
+  const [additionalHeight, setAdditionalHeight] = useState(0);
   const [variant, setVariant] = useState<Variant>("v1");
 
   const handleLayout = useCallback((evt: LayoutChangeEvent) => {
@@ -64,10 +65,11 @@ export default function AwareScrollViewStickyFooter({ navigation }: Props) {
       ]}
     >
       <KeyboardAwareScrollView
-        bottomOffset={(v1v2 ? footerHeight : 0) + 50}
+        bottomOffset={(v1v2 ? footerHeight + additionalHeight : 0) + 50}
         contentContainerStyle={styles.content}
         keyboardShouldPersistTaps="handled"
         style={styles.container}
+        testID="aware_scroll_sticky_view_scroll_container"
       >
         {new Array(10).fill(0).map((_, i) => (
           <TextInput
@@ -79,10 +81,17 @@ export default function AwareScrollViewStickyFooter({ navigation }: Props) {
       </KeyboardAwareScrollView>
       {v1v2 && (
         <KeyboardStickyView offset={offset}>
+          <View
+            style={{ height: additionalHeight, backgroundColor: "magenta" }}
+          />
           <View style={styles.footer} onLayout={handleLayout}>
             <Text style={styles.footerText}>A mocked sticky footer</Text>
             <TextInput placeholder="Amount" style={styles.inputInFooter} />
-            <Button title="Click me" onPress={() => Alert.alert("Clicked")} />
+            <Button
+              testID="toggle_height"
+              title="Toggle height"
+              onPress={() => setAdditionalHeight(additionalHeight ? 0 : 50)}
+            />
           </View>
         </KeyboardStickyView>
       )}

e2e/kit/016-aware-scroll-view-with-sticky-view.e2e.ts

@@ -0,0 +1,35 @@
+import { expectBitmapsToBeEqual } from "./asserts";
+import {
+  scrollDownUntilElementIsVisible,
+  waitAndTap,
+  waitForExpect,
+} from "./helpers";
+
+const BLINKING_CURSOR = 0.35;
+
+describe("AwareScrollView with StickyView test cases", () => {
+  it("should push input above keyboard on focus", async () => {
+    await waitAndTap("aware_scroll_view_sticky_footer");
+    await scrollDownUntilElementIsVisible(
+      "aware_scroll_sticky_view_scroll_container",
+      "TextInput#4",
+    );
+    await waitAndTap("TextInput#4");
+    await waitForExpect(async () => {
+      await expectBitmapsToBeEqual(
+        "AwareScrollViewWithStickyViewFirstInputFocused",
+        BLINKING_CURSOR,
+      );
+    });
+  });
+
+  it("should react on `bottomOffset` change", async () => {
+    await waitAndTap("toggle_height");
+    await waitForExpect(async () => {
+      await expectBitmapsToBeEqual(
+        "AwareScrollViewWithStickyViewBottomOffsetChanged",
+        BLINKING_CURSOR,
+      );
+    });
+  });
+});