onContentInsetChange not exposed for KeyboardChatScrollView

[marcelino-borges]

First of all, I really appreciate the work done with this lib, it has helped me A LOT! Thanks for the great work, guys!

Describe the bug
I have the v1.21.6 installed in my project, while implementing a realtime chat with the KeyboardChatScrollView (inverted=true) component.

But I noticed that on Android (iOS is ok) my list is not scrolling correctly to the end (bottom of the list in an inverted list) when a new message arrives. So I spotted the prop onContentInsetChange mentioned in the docs, but it seems this prop is not being exposed for the KeyboardChatScrollView component.

In 2026 of course [almost] everyone is using Claude Code to develop, so I have also asked our friend to grep for it as well, and it's not being found in the search.

Code snippet

<KeyboardChatScrollView
  ref={combinedRef}
  automaticallyAdjustContentInsets={false}
  contentInsetAdjustmentBehavior="never"
  onContentInsetChange // <-- Prop doesn't exist
  {...props}
  inverted
/>

TS error:

Type '{ inverted: true; contentContainerStyle?: StyleProp<ViewStyle>; innerViewRef?: RefObject<View> | undefined; scrollViewRef?: RefObject<ScrollView> | undefined; ... 156 more ...; onContentInsetChange: any; }' is not assignable to type 'IntrinsicAttributes & { ScrollViewComponent?: AnimatedScrollViewComponent | undefined; inverted?: boolean | undefined; ... 5 more ...; blankSpace?: SharedValue<...> | undefined; } & ScrollViewProps & { ...; } & RefAttributes<...>'.
  Property 'onContentInsetChange' does not exist on type 'IntrinsicAttributes & { ScrollViewComponent?: AnimatedScrollViewComponent | undefined; inverted?: boolean | undefined; ... 5 more ...; blankSpace?: SharedValue<...> | undefined; } & ScrollViewProps & { ...; } & RefAttributes<...>'. Did you mean 'onContentSizeChange'? ts(2322)

Repo for reproducing
None

To Reproduce
I think there's no need to repro this, right? There is no prop to test.

But:

1. Import and use the KeyboardChatScrollView component
2. Type the prop name onContentInsetChange in it
3. See TS error, as there is no prop with this name

Expected behavior
If the docs mention this prop, we should have this prop available and be able to use it

Screenshots
Docs mentioning the prop:

Prop not available:

Smartphone (please complete the following information):

• Desktop OS: MacOS Tahoe 26.3.1
• Device: iPhone17, varied iOS simulators and Android simulator (Pixel 9)
• OS: Android 16, iOS 26.3.1
• RN version: 0.83.2
• RN architecture: new
• JS engine: Hermes
• Library version: 1.21.6

Additional context
None

[kirillzyusko]

Hey @marcelino-borges

Thank you for such a detailed issue!

It will be fixed in #1447 - basically changes are in main and docs is always reflecting latest main, but yes, you are right, those changes are not included yet in latest release 😔

I'm planning to publish new release tomorrow, so tomorrow the issue will be solved in 1.12.7 🤞