feat(editor-safe-area): add convenience constructors none, symmetric, and fromLTRB (#742)

* feat(editor-safe-area): add constructors for no padding, symmetric padding, and custom edge padding

* refactor: clean up imports and remove unused filtered_widget references

* chore(release): bump version to 11.18.2 and update changelog

Author: hm21

CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## 11.18.2
+- **FEAT**(EditorSafeArea): Add convenience constructors `none`, `symmetric`, and `fromLTRB` for easier safe area configuration.
+- **FIX**(HelperLines): Resolves the issue of horizontal lines not showing up when the editor overflows the screen.
+
 ## 11.18.1
 - **FIX**(filter-editor): Ensure that the applied filters can also be removed.
 

lib/core/models/editor_configs/utils/editor_safe_area.dart

@@ -44,6 +44,36 @@ class EditorSafeArea {
     this.bottom = true,
   });
 
+  /// Creates an [EditorSafeArea] with no safe area padding on any edge.
+  const EditorSafeArea.none()
+      : top = false,
+        left = false,
+        right = false,
+        bottom = false;
+
+  /// Creates an [EditorSafeArea] with symmetric safe area padding.
+  ///
+  /// If [vertical] is `true`, padding is applied to the top and bottom edges.
+  /// If [horizontal] is `true`, padding is applied to the left and right edges.
+  const EditorSafeArea.symmetric({
+    bool vertical = false,
+    bool horizontal = false,
+  })  : top = vertical,
+        bottom = vertical,
+        left = horizontal,
+        right = horizontal;
+
+  /// Creates an [EditorSafeArea] with the specified padding for each edge.
+  ///
+  /// Similar to [EdgeInsets.fromLTRB], this constructor allows you to specify
+  /// the safe area padding for each edge individually.
+  const EditorSafeArea.fromLTRB(
+    this.left,
+    this.top,
+    this.right,
+    this.bottom,
+  );
+
   /// If `true`, applies safe area padding to the top edge.
   final bool top;
 

lib/features/crop_rotate_editor/crop_rotate_editor.dart

@@ -21,6 +21,7 @@ import '/features/crop_rotate_editor/widgets/outside_gestures/crop_rotate_gestur
 import '/features/crop_rotate_editor/widgets/outside_gestures/outside_gesture_listener.dart';
 import '/plugins/defer_pointer/defer_pointer.dart';
 import '/pro_image_editor.dart';
+import '/shared/extensions/double_extension.dart';
 import '/shared/mixins/extended_loop.dart';
 import '/shared/services/content_recorder/widgets/record_invisible_widget.dart';
 import '/shared/services/layer_transform_generator.dart';
@@ -33,8 +34,6 @@ import '/shared/widgets/extended/mouse_region/extended_rebuild_mouse_region.dart
 import '/shared/widgets/layer/layer_stack.dart';
 import '/shared/widgets/screen_resize_detector.dart';
 import '/shared/widgets/transform/transformed_content_generator.dart';
-import '../../shared/extensions/double_extension.dart';
-import '../filter_editor/widgets/filtered_widget.dart';
 import 'enums/crop_area_part.dart';
 import 'enums/crop_rotate_angle_side.dart';
 import 'mixins/crop_area_history.dart';

lib/features/filter_editor/filter_editor.dart

@@ -18,14 +18,14 @@ import '/shared/utils/file_constructor_utils.dart';
 import '/shared/widgets/layer/layer_stack.dart';
 import '/shared/widgets/transform/transformed_content_generator.dart';
 import 'constants/identity_matrix_constant.dart';
-import 'types/filter_matrix.dart';
 import 'utils/lerp_color_matrix_utils.dart';
-import 'widgets/filtered_widget.dart';
 
+export 'types/filter_matrix.dart';
 export 'utils/filter_generator/filter_addons.dart';
 export 'utils/filter_generator/filter_model.dart';
 export 'utils/filter_generator/filter_presets.dart';
 export 'widgets/filter_editor_item_list.dart';
+export 'widgets/filtered_widget.dart';
 
 /// The `FilterEditor` widget allows users to editing images with filters
 ///

lib/features/main_editor/main_editor.dart

@@ -30,7 +30,6 @@ import '/shared/utils/transparent_image_generator_utils.dart';
 import '/shared/widgets/adaptive_dialog.dart';
 import '/shared/widgets/extended/interactive_viewer/extended_interactive_viewer.dart';
 import '/shared/widgets/screen_resize_detector.dart';
-import '../filter_editor/types/filter_matrix.dart';
 import '../filter_editor/widgets/filter_generator.dart';
 import '../paint_editor/models/paint_editor_response_model.dart';
 import '../paint_editor/widgets/paint_editor_layer_editor.dart';

lib/features/main_editor/widgets/main_editor_helper_lines.dart

@@ -69,7 +69,7 @@ class MainEditorHelperLines extends StatelessWidget {
                 final scale = viewer?.scaleFactor ?? 1;
 
                 final offset = viewer?.offset ?? Offset.zero;
-                final screenSize = sizesManager.screen;
+                final screenSize = sizesManager.editorSize;
                 final editorBodySize = sizesManager.bodySize;
 
                 if (configs.helperLines.isDisabledAtZoom && scale > 1) {

lib/features/paint_editor/paint_editor.dart

@@ -29,7 +29,6 @@ import '/shared/widgets/extended/interactive_viewer/extended_interactive_viewer.
 import '/shared/widgets/layer/layer_stack.dart';
 import '/shared/widgets/slider_bottom_sheet.dart';
 import '/shared/widgets/transform/transformed_content_generator.dart';
-import '../filter_editor/widgets/filtered_widget.dart';
 import '../main_editor/services/layer_copy_manager.dart';
 import 'controllers/paint_controller.dart';
 import 'models/paint_editor_response_model.dart';

lib/features/tune_editor/tune_editor.dart

@@ -16,7 +16,6 @@ import '/shared/services/content_recorder/widgets/content_recorder.dart';
 import '/shared/utils/file_constructor_utils.dart';
 import '/shared/widgets/layer/layer_stack.dart';
 import '/shared/widgets/transform/transformed_content_generator.dart';
-import '../filter_editor/widgets/filtered_widget.dart';
 import 'utils/tune_presets.dart';
 import 'widgets/tune_editor_appbar.dart';
 

lib/pro_image_editor.dart

@@ -66,6 +66,7 @@ export 'core/utils/image_converter.dart';
 export '/shared/utils/parser/int_parser.dart';
 export '/shared/utils/parser/double_parser.dart';
 export '/shared/utils/parser/size_parser.dart';
+export '/core/models/editor_configs/utils/editor_safe_area.dart';
 
 /// Widgets
 export 'shared/widgets/animated/fade_in_up.dart';

pubspec.yaml

@@ -1,6 +1,6 @@
 name: pro_image_editor
 description: "A Flutter image editor: Seamlessly enhance your images with user-friendly editing features."
-version: 11.18.1
+version: 11.18.2
 homepage: https://github.com/hm21/pro_image_editor/
 repository: https://github.com/hm21/pro_image_editor/
 documentation: https://github.com/hm21/pro_image_editor/