feat: add onContentInsetChange callback

[kirillzyusko]

📜 Description

Added onContentInsetChange callback.

💡 Motivation and Context

Modifying contentInsets changes scrollable area. In react-native this event propagates through onScroll event. In JS I can not modify it (this event) just because we have so many variation in terms of how to intercept the onScroll event (Animated, Reanimated, plain JS callback) so that for example for Animated with native driver I can not simply modify event structure, because I'll emit event from JS but this event is not possible to send to mobile.

So I decided to add separate onContentInsetChange event. At the moment this callback will be needed in LegendList to implement accurate scrollToEnd and other functions that depends on precise scroll coordinates.

📢 Changelog

JS

• added onContentInsetChange callback;

🤔 How Has This Been Tested?

Tested manually.

📝 Checklist

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

[github-actions]

📊 Package size report

Current size	Target Size	Difference
314639 bytes	312153 bytes	2486 bytes 📈

[github-actions]

PR Preview Action v1.8.1
Preview removed because the pull request was closed.
2026-04-28 09:36 UTC

[argos-ci]

The latest updates on your projects. Learn more about Argos notifications ↗︎

Build	Status	Details	Updated (UTC)
default (Inspect)	⚠️ Changes detected (Review)	1 changed	Apr 27, 2026, 10:54 AM

[github-actions]

1. Runtime Error when contentInset is undefined
   Why: Accessing contentInset?.top in ScrollViewWithBottomPadding can cause a runtime error if contentInset is undefined because .top is accessed on an undefined value.
   Fix: Ensure contentInset is properly initialized or use nullish coalescing to handle undefined cases.

2. Missing Initialization of contentOffsetY
   Why: If contentOffsetY is not passed as a prop, it can lead to undefined behavior when accessing .value.
   Fix: Initialize contentOffsetY with a default value if it's not provided to prevent runtime errors.