feat: implements messagesContainerInsets prop

README.md

@@ -317,6 +317,7 @@ function ChatScreen() {
 - **`renderLoading`** _(Component | Function)_ - Render a loading view when initializing
 - **`renderChatEmpty`** _(Component | Function)_ - Custom component to render in the ListView when messages are empty
 - **`renderChatFooter`** _(Component | Function)_ - Custom component to render below the MessagesContainer (separate from the ListView)
+- **`messagesContainerInsets`** _(Object)_ - Content insets for the messages container FlatList. Accepts `{ top, left, bottom, right }`.
 - **`listProps`** _(Object)_ - Extra props to be passed to the messages [`<FlatList>`](https://reactnative.dev/docs/flatlist). Supports all FlatList props including `maintainVisibleContentPosition` for keeping scroll position when new messages arrive (useful for AI chatbots).
 
 ### Message Bubbles & Content

src/MessagesContainer/index.tsx

@@ -43,6 +43,7 @@ export const MessagesContainer = <TMessage extends IMessage>(props: MessagesCont
     scrollToBottomComponent: scrollToBottomComponentProp,
     renderDay: renderDayProp,
     isDayAnimationEnabled = true,
+    messagesContainerInsets,
   } = props
 
   const listPropsOnScrollProp = listProps?.onScroll
@@ -397,6 +398,7 @@ export const MessagesContainer = <TMessage extends IMessage>(props: MessagesCont
         renderItem={renderItem}
         inverted={isInverted}
         automaticallyAdjustContentInsets={false}
+        contentInset={messagesContainerInsets}
         style={stylesCommon.fill}
         contentContainerStyle={styles.messagesContainer}
         ListEmptyComponent={renderChatEmpty}

src/MessagesContainer/types.ts

@@ -1,6 +1,7 @@
 import { RefObject } from 'react'
 import {
   FlatListProps,
+  Insets,
   StyleProp,
   ViewStyle,
 } from 'react-native'
@@ -83,6 +84,8 @@ export interface MessagesContainerProps<TMessage extends IMessage = IMessage>
   typingIndicatorStyle?: StyleProp<ViewStyle>
   /** Enable animated day label that appears on scroll; default is true */
   isDayAnimationEnabled?: boolean
+  /** Content insets for the messages container FlatList */
+  messagesContainerInsets?: Insets
   /** Reply functionality configuration */
   reply?: ReplyProps<TMessage>
 }