feat: extraContentPadding prop

[kirillzyusko]

📜 Description

Added extraContentPadding prop for KeyboardChatScrollView component.

💡 Motivation and Context

This prop is very useful when you want to extend scrollable range and re-arrange the content so that it takes the same position as before (relatively). Theoretically "re-arrange" functionality must be configurable, but I tested many apps and what I can tell is that it looks like almost always this "re-arrange" respects keyboardLiftBehavior prop. Later we can introduce additional prop to have a better control, but for now we keep it simple.

I was thinking on whether to make this prop a SharedValue or a plain value and I decided to make it SharedValue because:

• theoretically we may do all work on UI thread, i. e. synchronously detect "input growth" and synchronously adjust position;
• we may want to change position with animation (with plain number we would have to add animated prop or smth like that);
• we may want to have a customizable animation (duration, easing, so SharedValue can be a perfect driver).

We also heavily use reanimated hooks internally, so integration with SharedValue looks very natural.

I intentionally didn't want to modify original hooks and I extended functionality using new hook: useExtraContentPadding. This new hook extends contentInsets + adjust scroll position. Maybe we'll et conflicts between hook in future, but at the moment it's extendable 😎

Closes #1324

📢 Changelog

Docs

• added new prop description;
• added new prop usage in guide page;

JS

• added extraContentPadding prop for KeyboardChatScrollView component
• cover new functionality by unit tests;

🤔 How Has This Been Tested?

Tested manually on:

• iPhone 17 Pro (iOS 26.2);
• Pixel 7 Pro (Android 16)

📸 Screenshots (if appropriate):

Android	iOS
telegram-cloud-document-2-5280683915592373225.mp4	Simulator.Screen.Recording.-.iPhone.17.Pro.-.2026-03-05.at.17.31.28.mov

📝 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
286745 bytes	279973 bytes	6772 bytes 📈

[github-actions]

PR Preview Action v1.8.1
🚀 View preview at https://kirillzyusko.github.io/react-native-keyboard-controller/pr-preview/pr-1332/
Built to branch gh-pages at 2026-03-05 14:54 UTC. Preview will be ready when the GitHub Pages deployment is complete.

[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	Mar 5, 2026, 2:55 PM