feat(text-editor): add enableTapOutsideToSave prop to text editor configs (#695)

Author: caghp94

CHANGELOG.md

@@ -1,5 +1,8 @@
 # Changelog
 
+## X.X.X
+- **FEAT**(text-editor): Added `enableTapOutsideToSave` configuration to `TextEditorConfigs` to control whether tapping outside the text field saves the text annotation. When set to `false`, users must use the done button or other explicit save actions. Defaults to `true` for backward compatibility.
+
 ## 11.11.0
 - **FEAT**(dashDotLine): Added new paint-mode "dashDotLine".
 

lib/core/models/editor_configs/text_editor_configs.dart

@@ -54,6 +54,7 @@ class TextEditorConfigs
     this.showFontScaleButton = true,
     this.showBackgroundModeButton = true,
     this.enableMainEditorZoomFactor = false,
+    this.enableTapOutsideToSave = true,
     this.enableAutoOverflow = true,
     this.initFontSize = 24.0,
     this.initialPrimaryColor = const Color(0xFF000000),
@@ -111,6 +112,14 @@ class TextEditorConfigs
   /// editor's zoom level.
   final bool enableMainEditorZoomFactor;
 
+  /// Whether tapping outside the text field saves the text annotation.
+  ///
+  /// When `true` (default), tapping outside the text input area will save
+  /// the current text and close the editor. When `false`, tapping outside
+  /// will not trigger the save action, requiring users to use the done
+  /// button or other explicit save actions.
+  final bool enableTapOutsideToSave;
+
   /// The initial font size for text.
   final double initFontSize;
 
@@ -204,6 +213,7 @@ class TextEditorConfigs
     bool? enableEdit,
     bool? showSelectFontStyleBottomBar,
     bool? enableMainEditorZoomFactor,
+    bool? enableTapOutsideToSave,
     bool? enableAutoOverflow,
     Color? initialPrimaryColor,
     Color? initialSecondaryColor,
@@ -236,6 +246,8 @@ class TextEditorConfigs
           showSelectFontStyleBottomBar ?? this.showSelectFontStyleBottomBar,
       enableMainEditorZoomFactor:
           enableMainEditorZoomFactor ?? this.enableMainEditorZoomFactor,
+      enableTapOutsideToSave:
+          enableTapOutsideToSave ?? this.enableTapOutsideToSave,
       enableAutoOverflow: enableAutoOverflow ?? this.enableAutoOverflow,
       initialPrimaryColor: initialPrimaryColor ?? this.initialPrimaryColor,
       initialSecondaryColor:

lib/features/text_editor/text_editor.dart

@@ -396,7 +396,7 @@ class TextEditorState extends State<TextEditor>
 
       return GestureDetector(
         behavior: HitTestBehavior.translucent,
-        onTap: done,
+        onTap: textEditorConfigs.enableTapOutsideToSave ? done : null,
         child: Stack(
           children: [
             if (textEditorConfigs.widgets.bodyItems != null)