feat: Add edit message support. (closes #336)

- Add enableEditMessage flag to FeatureActiveConfig (default: true)
- Add onEditTap callback to ChatView and ReplyPopupConfiguration
- Add EditMessageCallback typedef
- Create EditMessageView widget showing 'Editing' indicator above textfield
- Extend SendMessageWidget with assignEditMessage() and edit mode logic
- Add Edit button to ReplyPopupWidget (own messages only)
- Wire assignEditMessage through ChatListWidget -> ChatView
- Show 'Edited' label on messages where updateAt is non-null
- Add edit/edited/editing strings to ChatViewLocale (backward-compatible)
- Expose ChatView.getEditingMessage() static helper
- Add doc/documentation.md section for Edit Message feature

Author: vasu-nageshri

CHANGELOG.md

@@ -1,13 +1,14 @@
 ## [Unreleased]
 
-* **Feat**: ✨Added backgroundImageFit and backgroundImageRepeat to 
-  ChatBackgroundConfiguration for controllable chat wallpaper layout.
 * **Fix**: [423](https://github.com/SimformSolutionsPvtLtd/chatview/pull/423)
   Rendering issue in attached image preview when sending message on web.
 * **Feat**: [420](https://github.com/SimformSolutionsPvtLtd/chatview/pull/420) Added support for
   `playerMode` in `VoiceMessageConfiguration` with `single` and `multi`.
 * **Feat**: [434](https://github.com/SimformSolutionsPvtLtd/chatview/pull/434) Add optional
   `boxShadow` to `ChatBubble` and apply it in `TextMessageView` when set.
+* **Feat**: ✨Added backgroundImageFit and backgroundImageRepeat to
+    ChatBackgroundConfiguration for controllable chat wallpaper layout.
+* **Feat**: [336](https://github.com/SimformSolutionsPvtLtd/chatview/issues/336) Add edit message support.
 
 ## [3.0.0]
 

doc/documentation.md

@@ -853,6 +853,107 @@ ChatView(
     lastSeenAgoBuilderVisibility: false,
     receiptsBuilderVisibility: false,
     enableTextSelection: true,
+    enableEditMessage: true, // Enable the Edit Message feature (default: true)
+  ),
+  // ...
+)
+```
+
+## Edit Message Feature
+
+ChatView supports editing previously sent text messages, similar to WhatsApp and Telegram.
+
+### How It Works
+
+1. Long-press a message bubble sent by the current user.
+2. Tap **Edit** in the reply pop-up.
+3. The original text is pre-filled into the input field with an *Editing* indicator above it.
+4. Modify the text and press Send.
+5. Your `onEditTap` callback is called with the **original `Message`** and the **new text**.
+6. Messages that have been edited display a subtle *Edited* label below the bubble.
+
+### Basic Integration
+
+```dart
+ChatView(
+  // ...
+  onEditTap: (Message originalMessage, String newText) {
+    // Update the message in your data source / backend.
+    // Set `updateAt` on the message to trigger the "Edited" label in the UI.
+    final updatedMessage = Message(
+      id: originalMessage.id,
+      message: newText,
+      createdAt: originalMessage.createdAt,
+      sentBy: originalMessage.sentBy,
+      updateAt: DateTime.now(), // marks the message as edited
+      replyMessage: originalMessage.replyMessage,
+      messageType: originalMessage.messageType,
+    );
+
+    chatController.updateMessage(updatedMessage); // depends on your controller API
+  },
+  replyPopupConfig: ReplyPopupConfiguration(
+    // Optional: react to the edit tap in the popup before the editing UI opens.
+    onEditTap: (message) => debugPrint('Editing: ${message.id}'),
+  ),
+  // ...
+)
+```
+
+### Disabling the Feature
+
+```dart
+ChatView(
+  featureActiveConfig: const FeatureActiveConfig(
+    enableEditMessage: false, // hides the Edit button entirely
+  ),
+)
+```
+
+### Localization
+
+The edit-related strings can be customized via `ChatViewLocale`:
+
+```dart
+PackageStrings.addLocaleObject(
+  'es',
+  const ChatViewLocale(
+    // ... all other required fields ...
+    edit: 'Editar',
+    edited: 'Editado',
+    editing: 'Editando',
+  ),
+);
+PackageStrings.setLocale('es');
+```
+
+### Static Helper
+
+Use `ChatView.getEditingMessage(context)` to read the message currently being edited
+from a widget that is a descendant of `ChatView`:
+
+```dart
+final editingMsg = ChatView.getEditingMessage(context);
+if (editingMsg != null) {
+  // User is in edit mode for editingMsg.
+}
+```
+
+### Customizing the Edit Indicator Label
+
+When a user enters edit mode, an indicator bar is displayed above the text field showing a label
+(default: locale-resolved `"Editing"`). You can override this label via `SendMessageConfiguration`:
+
+```dart
+ChatView(
+  // ...
+  sendMessageConfig: SendMessageConfiguration(
+    /// The label shown in the editing indicator bar above the text field
+    /// when the user is editing an existing message.
+    ///
+    /// If omitted, falls back to the locale-resolved value of
+    /// `PackageStrings.currentLocale.editing` (e.g. `"Editing"`).
+    editLabel: 'Editing message',
   ),
   // ...
 )

lib/chatview.dart

@@ -57,3 +57,4 @@ export 'src/widgets/action_widgets/text_field_action_button.dart';
 export 'src/widgets/chat_list/chatlist.dart';
 export 'src/widgets/chat_view.dart';
 export 'src/widgets/chat_view_appbar.dart';
+export 'src/widgets/edit_message_view.dart';

lib/src/models/config_models/feature_active_config.dart

@@ -37,6 +37,7 @@ class FeatureActiveConfig {
     this.enableOtherUserName = true,
     this.enableScrollToBottomButton = false,
     this.enableTextSelection = false,
+    this.enableMessageEditing = true,
   });
 
   /// Used for enable/disable swipe to reply.
@@ -85,4 +86,13 @@ class FeatureActiveConfig {
   ///
   /// Defaults to `false`.
   final bool enableTextSelection;
+
+  /// Used for enable/disable the Edit Message feature.
+  ///
+  /// When enabled, an "Edit" option appears in the reply popup for
+  /// messages sent by the current user, allowing them to modify the
+  /// message text in-place.
+  ///
+  /// Defaults to `true`.
+  final bool enableMessageEditing;
 }

lib/src/models/config_models/reply_popup_configuration.dart

@@ -32,6 +32,7 @@ class ReplyPopupConfiguration {
     this.onReplyTap,
     this.onReportTap,
     this.onMoreTap,
+    this.onEditTap,
     this.backgroundColor,
     this.replyPopupBuilder,
   });
@@ -48,6 +49,9 @@ class ReplyPopupConfiguration {
   /// Provides callback on onReply button.
   final ValueSetter<Message>? onReplyTap;
 
+  /// Provides callback on edit button (only shown for current user's messages).
+  final ValueSetter<Message>? onEditTap;
+
   /// Provides callback on onReport button.
   final ValueSetter<Message>? onReportTap;
 

lib/src/models/config_models/send_message_configuration.dart

@@ -53,6 +53,7 @@ class SendMessageConfiguration {
     this.imageBorderRadius,
     this.selectedImageViewBuilder,
     this.sendButtonStyle,
+    this.editLabel,
   });
 
   /// Used to give background color to text field.
@@ -123,6 +124,15 @@ class SendMessageConfiguration {
 
   /// Used to give style to send button.
   final ButtonStyle? sendButtonStyle;
+
+  /// Custom label displayed in the "editing message" indicator bar shown
+  /// above the text field when the user is editing an existing message.
+  ///
+  /// Example: `"Editing message"` or a localized equivalent.
+  ///
+  /// If not provided, falls back to the locale-resolved value of
+  /// `PackageStrings.currentLocale.editing`.
+  final String? editLabel;
 }
 
 class ImagePickerIconsConfiguration {

lib/src/utils/chat_view_locale.dart

@@ -56,6 +56,9 @@ final class ChatViewLocale {
     required this.deleteChat,
     required this.noChats,
     required this.noSearchResults,
+    this.edit = 'Edit',
+    this.edited = 'Edited',
+    this.editing = 'Editing',
   });
 
   /// Create from `Map<String, String>`
@@ -94,6 +97,9 @@ final class ChatViewLocale {
       deleteChat: map['deleteChat']?.toString() ?? '',
       noChats: map['noChats']?.toString() ?? '',
       noSearchResults: map['noSearchResults']?.toString() ?? '',
+      edit: map['edit']?.toString() ?? 'Edit',
+      edited: map['edited']?.toString() ?? 'Edited',
+      editing: map['editing']?.toString() ?? 'Editing',
     );
   }
 
@@ -131,6 +137,15 @@ final class ChatViewLocale {
   final String noChats;
   final String noSearchResults;
 
+  /// Label for the edit action button in the reply popup.
+  final String edit;
+
+  /// Label shown next to an edited message.
+  final String edited;
+
+  /// Label shown in the text field header when editing a message.
+  final String editing;
+
   /// English defaults
   static const en = ChatViewLocale(
     today: 'Today',
@@ -166,5 +181,8 @@ final class ChatViewLocale {
     deleteChat: 'Delete Chat',
     noChats: 'No Chats',
     noSearchResults: 'No search results',
+    edit: 'Edit',
+    edited: 'Edited',
+    editing: 'Editing',
   );
 }

lib/src/values/typedefs.dart

@@ -96,6 +96,14 @@ typedef ChatBubbleLongPressCallback = void Function(
   double xCordinate,
   Message message,
 );
+
+/// Callback invoked when the user confirms an edit.
+/// [message] is the original message being edited.
+/// [updatedMessage] is the updated text content.
+typedef EditMessageCallback = void Function(
+  Message message,
+  String updatedMessage,
+);
 typedef ChatTextFieldViewBuilderCallback<T> = Widget Function(
   BuildContext context,
   T value,

lib/src/widgets/chat_bubble_widget.dart

@@ -25,6 +25,7 @@ import 'package:flutter/material.dart';
 import '../extensions/extensions.dart';
 import '../models/config_models/feature_active_config.dart';
 import '../utils/constants/constants.dart';
+import '../utils/package_strings.dart';
 import '../values/enumeration.dart';
 import '../values/typedefs.dart';
 import 'chat_view_inherited_widget.dart';
@@ -273,6 +274,22 @@ class _ChatBubbleWidgetState extends State<ChatBubbleWidget> {
                   onTap: () => widget.onReplyTap
                       ?.call(widget.message.replyMessage.messageId),
                 ),
+        if (widget.message.updateAt != null)
+          Padding(
+            padding: EdgeInsets.only(
+              left: isMessageBySender ? 0 : 8,
+              right: isMessageBySender ? 8 : 0,
+              bottom: 2,
+            ),
+            child: Text(
+              PackageStrings.currentLocale.edited,
+              style: const TextStyle(
+                fontSize: 11,
+                color: Colors.grey,
+                fontStyle: FontStyle.italic,
+              ),
+            ),
+          ),
         SwipeToReply(
           isMessageByCurrentUser: isMessageBySender,
           onSwipe: isMessageBySender ? onLeftSwipe : onRightSwipe,

lib/src/widgets/chat_list_widget.dart

@@ -34,6 +34,7 @@ class ChatListWidget extends StatefulWidget {
     Key? key,
     required this.chatController,
     required this.assignReplyMessage,
+    this.assignEditMessage,
     this.loadingWidget,
     this.loadMoreData,
     this.isLastPage,
@@ -58,6 +59,9 @@ class ChatListWidget extends StatefulWidget {
   /// bubble.
   final ValueSetter<Message> assignReplyMessage;
 
+  /// Provides callback for entering edit mode for a message.
+  final ValueSetter<Message>? assignEditMessage;
+
   /// Provides callback when user tap anywhere on whole chat.
   final VoidCallback? onChatListTap;
 
@@ -187,12 +191,43 @@ class _ChatListWidgetState extends State<ChatListWidget> {
                   ScaffoldMessenger.of(context).hideCurrentSnackBar();
                   replyPopup?.onReplyTap?.call(message);
                 },
+                onEditTap: _buildEditTapHandler(
+                  message: message,
+                  sentByCurrentUser: sentByCurrentUser,
+                  replyPopup: replyPopup,
+                ),
                 sentByCurrentUser: sentByCurrentUser,
               ),
         ),
       ).closed;
   }
 
+  VoidCallback? _buildEditTapHandler({
+    required Message message,
+    required bool sentByCurrentUser,
+    required ReplyPopupConfiguration? replyPopup,
+  }) {
+    if (!sentByCurrentUser) return null;
+    if (!(featureActiveConfig?.enableMessageEditing ?? true)) return null;
+
+    // Only enable Edit when we can actually enter edit mode.
+    if (widget.assignEditMessage == null) return null;
+
+    return () => _handleEditTap(message, replyPopup);
+  }
+
+  void _handleEditTap(
+    Message message,
+    ReplyPopupConfiguration? replyPopup,
+  ) {
+    widget.assignEditMessage?.call(message);
+    if (featureActiveConfig?.enableReactionPopup ?? false) {
+      chatViewIW?.showPopUp.value = false;
+    }
+    ScaffoldMessenger.of(context).hideCurrentSnackBar();
+    replyPopup?.onEditTap?.call(message);
+  }
+
   void _onChatListTap() {
     widget.onChatListTap?.call();
     if (!kIsWeb && (Platform.isIOS || Platform.isAndroid)) {