react-native-gifted-chat 3.0.0-alpha.0 → 3.0.0

package/CHANGELOG.md

@@ -0,0 +1,295 @@
+# Changelog
+
+## [3.0.0] - 2025-11-23
+
+This is a major release with significant breaking changes, new features, and improvements. The library has been completely rewritten in TypeScript with improved type safety, better keyboard handling, and enhanced customization options.
+
+### 🚨 Breaking Changes
+
+#### Renamed Props (GiftedChat)
+- `onInputTextChanged` → moved to `textInputProps.onChangeText` (follows React Native naming pattern)
+- `alwaysShowSend` → `isSendButtonAlwaysVisible` (consistent boolean naming convention)
+- `onPress` → `onPressMessage` (more specific naming)
+- `onLongPress` → `onLongPressMessage` (more specific naming)
+- `options` → `actions` (better semantic naming, different type signature)
+- `optionTintColor` → `actionSheetOptionTintColor` (clearer naming)
+- `renderUsernameOnMessage` → `isUsernameVisible` (consistent boolean naming)
+- `showUserAvatar` → `isUserAvatarVisible` (consistent boolean naming)
+- `showAvatarForEveryMessage` → `isAvatarVisibleForEveryMessage` (consistent boolean naming)
+- `renderAvatarOnTop` → `isAvatarOnTop` (consistent boolean naming)
+- `focusOnInputWhenOpeningKeyboard` → `shouldFocusInputOnKeyboardOpen` (consistent boolean naming)
+- `messageContainerRef` → `messagesContainerRef` (typo fix)
+- `alignTop` → `isAlignedTop` (consistent boolean naming)
+- `inverted` → `isInverted` (consistent boolean naming)
+
+#### Removed Props (GiftedChat)
+- `bottomOffset` - use `keyboardAvoidingViewProps.keyboardVerticalOffset` instead
+- `disableKeyboardController` - removed keyboard controller configuration
+- `isKeyboardInternallyHandled` - keyboard handling now always uses react-native-keyboard-controller
+- `lightboxProps` - custom Modal implementation replaced react-native-lightbox-v2
+- `placeholder` - moved to `textInputProps.placeholder`
+- `disableComposer` - moved to `textInputProps.editable={false}`
+- `keyboardShouldPersistTaps` - moved to `listProps.keyboardShouldPersistTaps`
+- `maxInputLength` - moved to `textInputProps.maxLength`
+- `extraData` - moved to `listProps.extraData`
+- `infiniteScroll` - use `loadEarlierMessagesProps.isInfiniteScrollEnabled` instead
+- `parsePatterns` - removed, automatic link parsing improved
+
+#### Props Moved to MessagesContainer (via spreading)
+These props moved from `GiftedChatProps` to `MessagesContainerProps` but are still accessible on `GiftedChat` via prop spreading:
+- `messages` - now in MessagesContainerProps
+- `isTyping` - now in MessagesContainerProps (via TypingIndicatorProps)
+- `loadEarlier` → `loadEarlierMessagesProps.isAvailable`
+- `isLoadingEarlier` → `loadEarlierMessagesProps.isLoading`
+- `onLoadEarlier` → `loadEarlierMessagesProps.onPress`
+- `renderLoadEarlier` - now in MessagesContainerProps
+- `renderDay` - now in MessagesContainerProps
+- `renderMessage` - now in MessagesContainerProps
+- `renderFooter` - now in MessagesContainerProps
+- `renderChatEmpty` - now in MessagesContainerProps
+- `scrollToBottomStyle` - now in MessagesContainerProps
+- `isScrollToBottomEnabled` - now in MessagesContainerProps
+- `scrollToBottomComponent` - now in MessagesContainerProps
+- `onQuickReply` - now in MessagesContainerProps
+- `listViewProps` → `listProps` (renamed in MessagesContainerProps)
+
+#### Type Signature Changes
+- `options`: changed from `{ [key: string]: () => void }` to `Array<{ title: string, action: () => void }>`
+- `textInputProps`: changed from `object` to `Partial<React.ComponentProps<typeof TextInput>>`
+- `renderInputToolbar`: now accepts `React.ComponentType | React.ReactElement | function | null` (can be component, element, function, or null)
+- All callback props now use arrow function syntax instead of function syntax for better type inference
+
+#### Dependency Changes
+- Removed `react-native-lightbox-v2` (replaced with custom Modal implementation)
+- Removed `react-native-iphone-x-helper` (deprecated)
+- Removed `react-native-keyboard-controller` as direct dependency
+- Added `react-native-keyboard-controller` as peer dependency (>=1.0.0)
+- Added `react-native-gesture-handler` as peer dependency (>=2.0.0)
+- Added `react-native-reanimated` support for v3 & v4
+- Added `react-native-safe-area-context` as peer dependency (>=5.0.0)
+
+### ✨ New Features
+
+#### TypeScript Migration
+- Complete conversion from JavaScript to TypeScript/TSX
+- Improved type safety and IntelliSense support
+- Better type definitions for all components and props
+- Refactored types to arrow functions for better readability
+
+#### Keyboard Handling
+- New `keyboardTopToolbarHeight` prop for better keyboard customization
+- New `keyboardAvoidingViewProps` to pass props to KeyboardAvoidingView from react-native-keyboard-controller
+- Improved keyboard behavior and offset handling
+- Consolidated keyboard configuration (removed individual keyboard props in favor of `keyboardAvoidingViewProps`)
+- Fixed auto-grow text input behavior
+- Better keyboard open/close transitions
+- New `OverKeyboardView` component for MessageImage to keep keyboard open
+
+#### Message Rendering
+- `isDayAnimationEnabled` prop to control day separator animations
+- Support for passing custom components in render functions
+- Improved message parsing with better link detection
+- Parse links in system messages (fixes #2105)
+- Better phone number parsing with custom matchers support
+- Improved URL parsing (email, phone, URL detection)
+
+#### UI & Styling
+- Dark theme support in example app
+- Safe area provider included in library
+- Improved LoadEarlier messages logic
+- Better themed styles implementation
+- Fixed press animation for TouchableOpacity
+- Replaced deprecated `TouchableWithoutFeedback` with `Pressable`
+- Better scroll to bottom button behavior on Android
+
+#### Image Viewing
+- Custom Modal implementation replacing react-native-lightbox-v2
+- Better image viewing experience with proper insets handling
+- Improved MessageImage component
+
+#### Accessibility & UX
+- `renderTicks` prop for message status indicators
+- Better scroll to bottom wrapper visibility handling
+- `useCallbackThrottled` for improved scroll performance
+- Allow passing children to SystemMessage
+- Improved load earlier messages functionality
+
+### 🐛 Bug Fixes
+
+- Fixed duplicate paragraph tags in README
+- Fixed scroll to bottom when `isScrollToBottomEnabled=false` (#2652)
+- Fixed TypeScript type inconsistencies and ESLint errors (#2653)
+- Fixed automatic scroll to bottom issues (#2630, #2621, #2644)
+- Fixed DayAnimated test import and added proper test coverage for renderDay prop
+- Fixed not passed `isDayAnimationEnabled` prop
+- Fixed MessageContainer scroll to bottom press on Android
+- Fixed safer change ScrollToBottomWrapper visibility
+- Fixed dependency cycles in imports
+- Fixed MessageText container style
+- Fixed reanimated issue in MessageContainer
+- Fixed construct messages on send in example
+- Fixed web support in example
+- Fixed #2659 (memoization issues)
+- Fixed #2640 (various bug fixes)
+- Fixed show location in example
+- Fixed errors in keyboard handling
+- Fixed load earlier messages functionality
+- Fixed Bubble type parameter to re-enable generics on message prop (#2639)
+- Fixed listViewProps typing with Partial<FlatListProps> (#2628)
+- Fixed MessageContainer to add renderDay prop and insert DayAnimated Component (#2632)
+- Fixed dateFormatCalendar default value in README
+
+### 🔧 Improvements
+
+#### Performance
+- Memoized values & functions for better performance
+- Better scroll performance with throttled callbacks
+- Optimized re-renders
+
+#### Code Quality
+- Added ESLint with import sorting
+- Fixed all examples with ESLint
+- Improved code structure and organization
+- Better error handling
+- Cleaner prop passing and component structure
+
+#### Testing
+- All tests converted to TypeScript
+- Updated snapshots for new components
+- Run tests in correct timezone (Europe/Paris)
+- Improved test coverage
+- Added comprehensive copilot instructions with validated commands
+
+#### Documentation
+- Improved README structure and formatting
+- Better prop documentation and grouping
+- Added matchers example
+- Added working Expo Snack link
+- Better feature documentation
+- Added maintainer section
+- Improved previews and images
+- Added export documentation
+- Fixed formatting issues and typos
+- Better keyboard props documentation
+
+#### Example App
+- Updated to latest React Native and Expo
+- Added tabs with different chat examples
+- Added working link to Expo Snack
+- Better example organization
+- Added dark theme support
+- Removed padding from bottom of toolbar
+- Added custom phone matcher example
+- Switch to dev build in README
+- Android: transparent navigation & status bars by default
+- Better project structure with multiple example types
+
+#### Build & Development
+- Better dependency management
+- Updated to Node.js >= 20
+- Yarn 1.22.22+ as package manager
+- Added stale workflow for issue management
+- Script to rebuild native dependencies
+- Improved local development setup
+
+### 📦 Dependencies
+
+#### Added
+- `@expo/react-native-action-sheet`: ^4.1.1
+- `@types/lodash.isequal`: ^4.5.8
+- `dayjs`: ^1.11.19
+- `lodash.isequal`: ^4.5.0
+- `react-native-autolink`: ^4.2.0
+- `react-native-zoom-reanimated`: ^1.4.10
+
+#### Peer Dependencies (now required)
+- `react`: >=18.0.0
+- `react-native`: *
+- `react-native-gesture-handler`: >=2.0.0
+- `react-native-keyboard-controller`: >=1.0.0
+- `react-native-reanimated`: >=3.0.0 || ^4.0.0
+- `react-native-safe-area-context`: >=5.0.0
+
+### 🔄 Migration Guide
+
+#### Update Prop Names
+```javascript
+// Before (v2.8.1)
+<GiftedChat
+  messages={messages}
+  onInputTextChanged={handleTextChange}
+  alwaysShowSend={true}
+  onPress={handlePress}
+  onLongPress={handleLongPress}
+  options={{ 'Option 1': action1, 'Option 2': action2 }}
+  optionTintColor="#007AFF"
+  bottomOffset={100}
+  placeholder="Type a message..."
+  maxInputLength={1000}
+  renderUsernameOnMessage={true}
+  showUserAvatar={false}
+  showAvatarForEveryMessage={false}
+  renderAvatarOnTop={false}
+  alignTop={false}
+  inverted={true}
+  loadEarlier={true}
+  isLoadingEarlier={false}
+  onLoadEarlier={handleLoadEarlier}
+/>
+
+// After (v3.0.0)
+<GiftedChat
+  messages={messages}
+  textInputProps={{
+    onChangeText: handleTextChange,
+    placeholder: "Type a message...",
+    maxLength: 1000
+  }}
+  isSendButtonAlwaysVisible={true}
+  onPressMessage={handlePress}
+  onLongPressMessage={handleLongPress}
+  actions={[
+    { title: 'Option 1', action: action1 },
+    { title: 'Option 2', action: action2 }
+  ]}
+  actionSheetOptionTintColor="#007AFF"
+  keyboardAvoidingViewProps={{ keyboardVerticalOffset: 100 }}
+  isUsernameVisible={true}
+  isUserAvatarVisible={false}
+  isAvatarVisibleForEveryMessage={false}
+  isAvatarOnTop={false}
+  isAlignedTop={false}
+  isInverted={true}
+  loadEarlierMessagesProps={{
+    isAvailable: true,
+    isLoading: false,
+    onPress: handleLoadEarlier
+  }}
+/>
+```
+
+#### Install Peer Dependencies
+```bash
+npm install react-native-gesture-handler react-native-keyboard-controller react-native-reanimated react-native-safe-area-context
+# or
+yarn add react-native-gesture-handler react-native-keyboard-controller react-native-reanimated react-native-safe-area-context
+```
+
+#### Update Image Lightbox
+The library now uses a custom Modal implementation instead of react-native-lightbox-v2. If you were customizing the lightbox, you'll need to update your customization approach.
+
+### 📝 Notes
+
+- This version includes 170+ commits since v2.8.1
+- Full TypeScript support with improved type definitions
+- Better React Native compatibility (tested with RN 0.81.5)
+- Improved React 19 support
+- Better Expo integration
+
+### 👥 Contributors
+
+Special thanks to all contributors who made this release possible, including fixes and improvements from the community.
+
+---
+
+For detailed commit history, see: https://github.com/FaridSafi/react-native-gifted-chat/compare/2.8.1...3.0.0

package/README.md

@@ -1,11 +1,3 @@
-<p align="center">
-<p align="center">
-   <a href="https://reactnative.gallery/FaridSafi/gifted-chat">
-    <img alt="react-native-gifted-chat" src="https://thumbs.gfycat.com/AbsoluteSadDobermanpinscher-size_restricted.gif" width="260" height="510" />
- </a>
-
-</p>
-
 <h3 align="center">
   💬 Gifted Chat
 </h3>
@@ -16,26 +8,61 @@
   <a href="https://www.npmjs.com/package/react-native-gifted-chat">
   <img alt="npm downloads" src="https://img.shields.io/npm/dm/react-native-gifted-chat.svg"/></a>
   <a href="https://www.npmjs.com/package/react-native-gifted-chat"><img alt="npm version" src="https://badge.fury.io/js/react-native-gifted-chat.svg"/></a>
+  <a href="https://circleci.com/gh/FaridSafi/react-native-gifted-chat"><img src="https://circleci.com/gh/FaridSafi/react-native-gifted-chat.svg?style=shield" alt="build"></a>
 </p>
+
+---
+
+<h3 align="center">
+  🚀 Try it now in your browser!
+</h3>
 <p align="center">
-  <a href="https://circleci.com/gh/FaridSafi/react-native-gifted-chat"><img src="https://circleci.com/gh/FaridSafi/react-native-gifted-chat.svg?style=shield" alt="build"></a>
-  <a title='License' href="https://github.com/FaridSafi/react-native-gifted-chat/blob/master/LICENSE" height="18">
-    <img src='https://img.shields.io/badge/license-MIT-blue.svg' />
+  <a href="https://snack.expo.dev/@kesha-antonov/gifted-chat-playground" target="_blank">
+    <img src="https://img.shields.io/badge/▶️_Try_GiftedChat_Playground-4630EB?style=for-the-badge&logo=expo&logoColor=white" alt="Try GiftedChat on Expo Snack"/>
   </a>
-  <a href="#hire-an-expert"><img src="https://img.shields.io/badge/%F0%9F%92%AA-hire%20an%20expert-brightgreen"/></a>
+</p>
+<p align="center">
+  <strong>No installation required • Interactive examples • Edit and run in real-time</strong>
 </p>
 
+<br />
+
+<!-- previews -->
+
 <p align="center">
-  <a href="https://snack.expo.dev/@kesha-antonov/gifted-chat-playground" target="_blank">Snack GiftedChat playground</a>
-  <img height="18" src="https://snack.expo.io/favicon.ico" />
+  <img width="200" src="https://github.com/user-attachments/assets/c9da88f5-0b20-471c-8cd7-373bdb767517" />
+  &nbsp;&nbsp;&nbsp;&nbsp;
+  <img width="200" src="https://github.com/user-attachments/assets/f72b17f1-6c2e-43b5-87e7-477011aa3b07" />
+  &nbsp;&nbsp;&nbsp;&nbsp;
+  <img width="200" src="https://github.com/user-attachments/assets/86711e73-ee3c-4527-b38d-e4dab47a44fe" />
 </p>
 
+---
+
+## Features
+
+- Fully customizable components
+- Composer actions (to attach photos, etc.)
+- Load earlier messages
+- Copy messages to clipboard
+- Touchable links using [react-native-autolink](https://github.com/joshswan/react-native-autolink)
+- Avatar as user's initials
+- Localized dates
+- Multi-line TextInput
+- InputToolbar avoiding keyboard
+- System message
+- Quick Reply messages (bot)
+- Typing indicator
+- Ticks indicator to display message status ( delivered, read )
+- Scroll to bottom button
+- react-native-web [web configuration](#react-native-web)
+
 ## Sponsor
 
 <p align="center">
   <br/>
   <a href="https://www.lereacteur.io" target="_blank">
-    <img src="https://raw.githubusercontent.com/FaridSafi/react-native-gifted-chat/master/media/logo_sponsor.png">
+    <img src="https://raw.githubusercontent.com/FaridSafi/react-native-gifted-chat/master/media/logo_sponsor.png" height="60">
   </a>
   <br>
   <p align="center">
@@ -51,7 +78,7 @@
 <p align="center">
   <br/>
   <a href="https://getstream.io/chat/?utm_source=Github&utm_medium=Github_Repo_Content_Ad&utm_content=Developer&utm_campaign=Github_Jan2022_Chat&utm_term=react-native-gifted-chat" target="_blank">
-    <img src="https://raw.githubusercontent.com/FaridSafi/react-native-gifted-chat/master/media/stream-logo.png" height="50">
+    <img src="https://raw.githubusercontent.com/FaridSafi/react-native-gifted-chat/master/media/stream-logo.png" height="40">
   </a>
   <br>
   <p align="center">
@@ -65,7 +92,7 @@
 <p align="center">
   <br/>
   <a href="https://www.ethora.com" target="_blank">
-    <img src="https://www.dappros.com/wp-content/uploads/2023/12/Ethora-Logo.png" width="300px">
+    <img src="https://www.dappros.com/wp-content/uploads/2023/12/Ethora-Logo.png" height="60">
   </a>
   <br>
   <p align="center">
@@ -80,50 +107,26 @@
  <a href="https://amzn.to/3ZmTyb2" target="_blank">React Key Concepts: Consolidate your knowledge of React’s core features (2nd ed. Edition)</a>
 </p>
 
-## Features
-
-- Fully customizable components
-- Composer actions (to attach photos, etc.)
-- Load earlier messages
-- Copy messages to clipboard
-- Touchable links using [react-native-autolink](https://github.com/joshswan/react-native-autolink)
-- Avatar as user's initials
-- Localized dates
-- Multi-line TextInput
-- InputToolbar avoiding keyboard
-- System message
-- Quick Reply messages (bot)
-- Typing indicator
-- react-native-web [web configuration](#react-native-web)
-
 # Getting started
 
-## 🚧👷 Important notice
-
-There's currently WIP going on to make the library more performant, modern in terms of chat UI and easier to maintain. If you have any issues, please report them. If you want to contribute, please do so.
-
-The most stable version is `2.6.5`. If you want to use the latest version, please be aware that it's a work in progress.
-
-Readme for this version: [2.6.5 readme](https://github.com/FaridSafi/react-native-gifted-chat/blob/eebab3751fcbe07715135e6e7b2aa3f76a10d8ac/README.md)
-
 ## Installation
 
 ### Install dependencies
 
 Yarn:
 ```bash
-yarn add react-native-gifted-chat react-native-reanimated react-native-keyboard-controller react-native-gesture-handler react-native-safe-area-context
+yarn add react-native-gifted-chat react-native-reanimated react-native-gesture-handler react-native-safe-area-context react-native-keyboard-controller
 ```
 
 Npm:
 
 ```bash
-npm install --save react-native-gifted-chat react-native-reanimated react-native-keyboard-controller react-native-gesture-handler react-native-safe-area-context
+npm install --save react-native-gifted-chat react-native-reanimated react-native-gesture-handler react-native-safe-area-context react-native-keyboard-controller
 ```
 
 Expo
 ```bash
-npx expo install react-native-gifted-chat react-native-reanimated react-native-keyboard-controller react-native-gesture-handler react-native-safe-area-context
+npx expo install react-native-gifted-chat react-native-reanimated react-native-gesture-handler react-native-safe-area-context react-native-keyboard-controller
 ```
 
 ### Non-expo users
@@ -136,10 +139,13 @@ npx pod-install
 
 Follow guide: [react-native-reanimated](https://docs.swmansion.com/react-native-reanimated/docs/fundamentals/getting-started/#step-2-add-reanimateds-babel-plugin)
 
-## Simple example
+## Examples
+
+### Basic usage
 
 ```jsx
 import React, { useState, useCallback, useEffect } from 'react'
+import { Platform } from 'react-native'
 import { GiftedChat } from 'react-native-gifted-chat'
 import { useSafeAreaInsets } from 'react-native-safe-area-context'
 
@@ -149,7 +155,8 @@ export function Example() {
 
   // If you have a tab bar, include its height
   const tabbarHeight = 50
-  const keyboardBottomOffset = insets.bottom + tabbarHeight
+  const keyboardTopToolbarHeight = Platform.select({ ios: 44, default: 0 })
+  const keyboardVerticalOffset = insets.bottom + tabbarHeight + keyboardTopToolbarHeight
 
   useEffect(() => {
     setMessages([
@@ -179,13 +186,14 @@ export function Example() {
       user={{
         _id: 1,
       }}
-      keyboardBottomOffset={keyboardBottomOffset}
+
+      keyboardAvoidingViewProps={{ keyboardVerticalOffset }}
     />
   )
 }
 ```
 
-## Different examples
+### Other examples
 
 Check out code of [`examples`](example)
 
@@ -205,14 +213,13 @@ Messages, system messages, quick replies etc.: [data structure](src/Models.ts)
 
 ### Refs
 
-- **`messageContainerRef`** _(FlatList ref)_ - Ref to the flatlist
+- **`messagesContainerRef`** _(FlatList ref)_ - Ref to the flatlist
 - **`textInputRef`** _(TextInput ref)_ - Ref to the text input
 
 ### Keyboard & Layout
 
-- **`keyboardBottomOffset`** _(Integer)_ - Distance between the bottom of the screen and bottom of the `GiftedChat` component. Useful when you have a tab bar or navigation bar; default is `0`. Needed for correct keyboard avoiding behavior. Without it you might see gap between the keyboard and the input toolbar if you have a tab bar, navigation bar, or safe area.
-- **`isKeyboardInternallyHandled`** _(Bool)_ - Determine whether to handle keyboard awareness inside the plugin. If you have your own keyboard handling outside the plugin set this to false; default is `true`
-- **`shouldFocusInputOnKeyboardOpen`** _(Bool)_ - Focus on <TextInput> automatically when opening the keyboard; default `true`
+- **`keyboardProviderProps`** _(Object)_ - Props to be passed to the [`KeyboardProvider`](https://kirillzyusko.github.io/react-native-keyboard-controller/docs/api/keyboard-provider) for keyboard handling.
+- **`keyboardAvoidingViewProps`** _(Object)_ - Props to be passed to the [`KeyboardAvoidingView`](https://kirillzyusko.github.io/react-native-keyboard-controller/docs/api/keyboard-avoiding-view). The `behavior` prop defaults to `'padding'`.
 - **`isAlignedTop`** _(Boolean)_ Controls whether or not the message bubbles appear at the top of the chat (Default is false - bubbles align to bottom)
 - **`isInverted`** _(Bool)_ - Reverses display order of `messages`; default is `true`
 
@@ -229,7 +236,7 @@ Messages, system messages, quick replies etc.: [data structure](src/Models.ts)
 - **`renderSend`** _(Component | Function)_ - Custom send button; you can pass children to the original `Send` component quite easily, for example, to use a custom icon ([example](https://github.com/FaridSafi/react-native-gifted-chat/pull/487))
 - **`renderActions`** _(Component | Function)_ - Custom action button on the left of the message composer
 - **`renderAccessory`** _(Component | Function)_ - Custom second line of actions below the message composer
-- **`textInputProps`** _(Object)_ - props to be passed to the [`<TextInput>`](https://reactnative.dev/docs/textinput.html).
+- **`textInputProps`** _(Object)_ - props to be passed to the [`<TextInput>`](https://reactnative.dev/docs/textinput).
 
 ### Actions & Action Sheet
 
@@ -244,22 +251,21 @@ Messages, system messages, quick replies etc.: [data structure](src/Models.ts)
 - **`renderMessage`** _(Component | Function)_ - Custom message container
 - **`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 MessageContainer (separate from the ListView)
-- **`listProps`** _(Object)_ - Extra props to be passed to the messages [`<FlatList>`](https://reactnative.dev/docs/flatlist.html); some props can't be overridden, see the code in `MessageContainer.render()` for details
+- **`renderChatFooter`** _(Component | Function)_ - Custom component to render below the MessagesContainer (separate from the ListView)
+- **`listProps`** _(Object)_ - Extra props to be passed to the messages [`<FlatList>`](https://reactnative.dev/docs/flatlist)
 
 ### Message Bubbles & Content
 
-- **`renderBubble`** _(Component | Function)_ - Custom message bubble
+- **`renderBubble`** _(Component | Function(`props: BubbleProps`))_ - Custom message bubble. Receives [BubbleProps](src/Bubble/types.ts) as parameter.
 - **`renderMessageText`** _(Component | Function)_ - Custom message text
 - **`renderMessageImage`** _(Component | Function)_ - Custom message image
 - **`renderMessageVideo`** _(Component | Function)_ - Custom message video
 - **`renderMessageAudio`** _(Component | Function)_ - Custom message audio
 - **`renderCustomView`** _(Component | Function)_ - Custom view inside the bubble
 - **`isCustomViewBottom`** _(Bool)_ - Determine whether renderCustomView is displayed before or after the text, image and video views; default is `false`
-- **`renderTicks`** _(Component | Function(`message`))_ - Custom ticks indicator to display message status
 - **`onPressMessage`** _(Function(`context`, `message`))_ - Callback when a message bubble is pressed
 - **`onLongPressMessage`** _(Function(`context`, `message`))_ - Callback when a message bubble is long-pressed; you can use this to show action sheets (e.g., copy, delete, reply)
-- **`imageProps`** _(Object)_ - Extra props to be passed to the [`<Image>`](https://reactnative.dev/docs/image.html) component created by the default `renderMessageImage`
+- **`imageProps`** _(Object)_ - Extra props to be passed to the [`<Image>`](https://reactnative.dev/docs/image) component created by the default `renderMessageImage`
 - **`imageStyle`** _(Object)_ - Custom style for message images
 - **`videoProps`** _(Object)_ - Extra props to be passed to the video component created by the required `renderMessageVideo`
 - **`messageTextProps`** _(Object)_ - Extra props to be passed to the MessageText component. Useful for customizing link parsing behavior, text styles, and matchers. Supports all [react-native-autolink](https://github.com/joshswan/react-native-autolink) props including:
@@ -341,6 +347,7 @@ See full example in [LinksExample](example/components/chat-examples/LinksExample
 - **`renderDay`** _(Component | Function)_ - Custom day above a message
 - **`renderTime`** _(Component | Function)_ - Custom time inside a message
 - **`timeTextStyle`** _(Object)_ - Custom text style for time inside messages (supports left/right styles)
+- **`isDayAnimationEnabled`** _(Bool)_ - Enable animated day label that appears on scroll; default is `true`
 
 ### System Messages
 
@@ -414,30 +421,8 @@ If you are using Create React Native App / Expo, no Android specific installatio
 </View>
 ```
 
-If you use React Navigation, additional handling may be required to account for navigation headers and tabs. `KeyboardAvoidingView`'s `keyboardVerticalOffset` property can be set to the height of the navigation header and [`tabBarOptions.keyboardHidesTabBar`](https://reactnavigation.org/docs/en/bottom-tab-navigator.html#bottomtabnavigatorconfig) can be set to keep the tab bar from being shown when the keyboard is up. Due to a [bug with calculating height on Android phones with notches](facebook/react-native#23693), `KeyboardAvoidingView` is recommended over other solutions that involve calculating the height of the window.
-
-- adding an opaque background status bar on app.json (even though `android:windowSoftInputMode="adjustResize"` is set internally on Expo's Android apps, the translucent status bar causes it not to work): https://docs.expo.io/versions/latest/guides/configuration.html#androidstatusbar
-
-- If you plan to use `GiftedChat` inside a `Modal`, see [#200](https://github.com/FaridSafi/react-native-gifted-chat/issues/200).
-
 ## Notes for local development
 
-### Native
-
-1. Install `yarn global add expo-cli`
-2. Install dependencies`yarn install`
-3. `expo start`
-
-### react-native-web
-
-#### With expo
-
-1. Install `yarn global add expo-cli`
-2. Install dependencies`yarn install`
-3. `expo start -w`
-
-[Upgrade snack version](https://snackager.expo.io/bundle/react-native-gifted-chat@0.15.0?bypassCache=true)
-
 #### With create-react-app
 
 1. `yarn add -D react-app-rewired`
@@ -509,25 +494,16 @@ fireEvent(loadingWrapper, 'layout', {
 1. Find responses in existing issues
 1. Try to keep issues for issues
 
-## License
+## Hire an expert
 
-- [MIT](LICENSE)
+Looking for a React Native freelance expert with more than 14 years of experience? Contact Xavier from his [website](https://xaviercarpentier.com)
 
 ## Author
 
-Feel free to ask me questions on Twitter [@FaridSafi](https://www.twitter.com/FaridSafi)! or [@xcapetir](https://www.twitter.com/xcapetir)!
-
-## Contributors
-
-- Kevin Cooper [cooperka](https://github.com/cooperka)
-- Kfir Golan [kfiroo](https://github.com/kfiroo)
-- Bruno Cascio [brunocascio](https://github.com/brunocascio)
-- Xavier Carpentier [xcarpentier](https://github.com/xcarpentier)
-- Kesha Antonov [kesha-antonov](https://github.com/kesha-antonov)
-- [more](https://github.com/FaridSafi/react-native-gifted-chat/graphs/contributors)
+Feel free to ask me questions on Twitter [@FaridSafi](https://www.twitter.com/FaridSafi) or [@xcapetir](https://www.twitter.com/xcapetir)
 
-## Hire an expert!
+## Maintainer
 
-Looking for a React Native freelance expert with more than 14 years of experience? Contact Xavier from his [website](https://xaviercarpentier.com)!
+Have any questions? Reach out to [Kesha Antonov](https://github.com/kesha-antonov)
 
-Need expert help with React Native Gifted Chat? Reach out to [Kesha Antonov](mailto:innokenty.longway@gmail.com)
+Please note that I'm maintaining this project in my free time for free. If you find any issues, feel free to open them, and I'll do my best to address them as time permits.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-gifted-chat",
-  "version": "3.0.0-alpha.0",
+  "version": "3.0.0",
   "description": "The most complete chat UI for React Native",
   "keywords": [
     "android",
@@ -94,7 +94,7 @@
     "react-dom": "19.1.0",
     "react-native": "0.81.5",
     "react-native-gesture-handler": "^2.29.1",
-    "react-native-keyboard-controller": "^1.19.5",
+    "react-native-keyboard-controller": "^1.19.6",
     "react-native-reanimated": "^3.19.4",
     "react-native-safe-area-context": "^5.6.2",
     "react-test-renderer": "19.1.0",