pro_image_editor

• FIX(paint-editor): Resolved an issue where the opacityBottomSheetBackground was not applying any effect. This resolves issue #540.

• FEAT(callbacks): Add onStateHistoryChange callback to MainEditorCallbacks.
• FEAT(callbacks): Add onImageDecoded callback to MainEditorCallbacks.
• FEAT(main-editor): Add autoCorrectZoomOffset and AutoCorrectZoomScale parameters to the addLayer method, allowing layers to be added inside the viewport even when the user is zoomed into a specific area of the editor.
• FEAT(main-editor): Add closeSubEditor method to close all subeditors.

• FEAT(layer-interaction): Add releaseThreshold to control snapping behavior for helper lines.
• FEAT(helper-lines): add isDisabledAtZoom property to control visibility based on zoom level.

• FIX(widget-layer): Resolved an issue where the edit button on editable WidgetLayer was visible even when interaction was disabled. This resolves issue #532.
• FEAT(callback): Add onHoverRemoveAreaChange to detect hover on remove area. This was requested in #531.

• FIX(export): Resolved an issue where exporting multiple layers could overwrite existing ones. This resolves issue #527.

• FIX(layer): Resolved an issue where importing a layer didn’t restore the boxConstraints.

• FEAT(layer): Show alignment guides when layers share the same x or y position.

• FIX(compat): Increased minimum Flutter SDK version to 3.32.0 to ensure compatibility with updated OverlayPortal APIs.

• FIX(gestures): Add new widget GestureInterceptor to prevent unnecessary gesture bubbling up the widget tree.

• FEAT(callbacks): Add new onKeyboardEvent callback to MainEditorCallbacks.

• FEAT(layer): Move the layer selection to the overlay to prevent it from being captured. This change allows layers to remain selected even after an interaction. The behavior can be controlled using the keepSelectionOnInteraction variable in the LayerInteractionConfigs.
• FEAT(layer-stack): Add moveLayerForward and moveLayerBackward to move a layer one step forward or backward in the stack.
• FEAT(layer-stack): Add moveLayerToFront and moveLayerToBack to move a layer to the top or bottom of the stack.
• FEAT(layer-stack): Add getLayerStackIndex to retrieve a layer's index in the stack.
• FEAT(layer): Add duplicateLayer to the LayerCopyManager.
• FEAT(callback): Add onLayerTapDown and onLayerTapUp to the MainEditorCallbacks.
• FEAT(layer): Add layer type identification for emoji, text, paint, and widget layers.
• FEAT(cropMode): The CropMode can now be dynamically switched inside the cropRotateEditor by updating the cropMode value.
• FEAT(crop-editor): The CropEditor now supports every aspect ratio for the round cropper, not just aspect ratio 1.
• FEAT(crop-editor): Changing the aspect ratio no longer resets other applied changes like flip or rotate.
• FEAT(paint-editor): Add addPainting method that allows to programmatically create new paintings.

<br/>

• FIX(text-layer): Resolve textLayer opening without requiring double-tap.
• FIX(autoSource): Resolve issue where an error is thrown when the 'file' argument in the 'autoSource' constructor is null. This resolves issue #509.
• FIX(text-editor): Resolve the issue of input text auto-wrapping, which does not happen in the main editor. This resolves issue #469.
• FIX(paint-editor): Resolve the issue where drawings shift when the AppBar or BottomBar is missing in the main editor. This resolves issue #410.

<br/>

• DOCS(example): Introduce a new example to showcase a more contemporary layer selection design.

<br/>

• TEST: Added more than 200 new unit and widget tests to improve coverage and ensure more robust error detection.

<br/>

Breaking Changes

• Removed all deprecated configuration settings.
• Changed the layer selection system to use an overlay-based approach. This may lead to different results in certain edge cases. If you have implemented a custom selection behavior, review it to ensure compatibility.
• Remove the configuration enableRoundCropper from CropRotateEditorConfigs and add the configuration initialCropMode.

• FEAT(Text-Editor): Add the inputTextFieldAlign property to the TextEditorConfigs to dynamically align the input field. This was requested in #502.

• FEAT(import): Add enableInitialEmptyState to ImportEditorConfigs so the editor can replace the existing state history without including an empty first page.

• FIX(bottom-sheet): Wrap bottom sheets in SafeArea to ensure proper display within device safe zones.

• FIX(video-editor): Add missing image parameter to GroundedFilterBar.

• FEAT(video-editor): Added new parameters to CompleteParameters required for extending the editor with video editing.

<br/>

• FIX(video-editor): Fixed issue where filter previews were displayed incorrectly.
• FIX(video-editor): Fixed issue where the trim bar lost its state when moving a layer.

• FIX(double-tap): Resolve issue where double tapping still zooms even when enableZoom is set to false. This resolves issue #484.

• FEAT(polygon): Added new paint-mode "polygon".

• FIX(widget-layer): copyWith now correctly includes exportConfigs.

• FIX(Main-Editor): Corrected editor name handling in openPage to ensure proper behavior of onOpenSubEditor, onStartCloseSubEditor and onEndCloseSubEditor. This resolves issue #474.

• FIX(Layers): Corrected size calculation to prevent layer shifting.
• FIX(Main-Editor): Fixed an issue where disabled layers blocked zoom gestures.

• FIX(Crop-Rotate-Editor): Ensure the editor respects the maxOutputSize constraint.

• FIX(Crop-Rotate-Editor): Prevent crashes when clamping values with reversed lower and upper limits. This resolves issue #462.

• FEAT(Sticker-Editor): Added builder parameter to StickerEditorConfigs, which will replace buildStickers in the future. The new builder supports directly returning a WidgetLayer instead of just a Widget, enabling more flexibility and control.

• FIX(Paint-Eraser): Resolved an issue where the layer eraser only worked when the user tapped on a layer.

• FIX(Image-Generation): Resolved an issue that the image generation was slowly.

• FEAT(Layer): Introduce BoxConstraints to Layer class for enhanced constraint management and layout control.

• FEAT(Main-Editor): Add EditorSafeArea to the Main editor to follow SubEditor logic.

• FIX(Tune-Editor): Ensure the back button works properly. This resolves issue #449.

• FIX(Import): Ensure imported numbers are type-safe even if int and double are incorrect. This resolves issue #447.

• FEAT(image-converter): Add singleton ImageConverter class for format conversion without the image editor.

• FEAT(double-tap): Support double-tap to zoom in/out when zoom is enabled. More details in Feature-Request #429.

• FIX(zoom): Fixed issue where config enableMainEditorZoomFactor had no effect when creating a new text-layer. Resolves #426.

• FIX(onCompleteWithParameters): Return correct parameters on completion. Resolves #403.

• FEAT(callback): Added copyWith method to all callback models. More details in Feature-Request #424.
• FEAT(zoom): Preserved zoom state by sharing Matrix4 between paint and main editor

• FEAT(callback): Added onSelectedLayerChanged callback to notify when the selected layer changes. More details in PR #423.

• FEAT(jpeg-encoder): Add jpegBackgroundColor option to ImageGenerationConfigs to allow customization of JPEG background color.

<br/>

• FIX(crop_editor): Add missing copyWith parameters to ensure proper cloning of configuration states.
• FIX(PaintEditor.drawing): Ensure cropToImageBounds is false to prevent unintended cropping behavior.

• FEAT: Video editing has now been fully implemented in the image editor across all platforms except the web, for which support is not planned. For more details and a list of limitations, please refer to that discussion thread.

• FEAT: Added clearLayerSelection method to reset selected layers.
• FEAT: Added selectLayerByIndex method to select a layer using its index.
• FEAT: Added selectLayerById method to select a layer by its unique ID.

• FEAT: Replaced the external packages emoji_picker_flutter, universal_io, and flutter_web_plugins with lightweight internal implementations. The editor now only relies on official Dart and Flutter packages, reducing dependencies and improving maintainability.
• FEAT: Added a new preview-only constructor for video editing: ProImageEditor.video. This feature allows previewing video edits but does not yet support video export. Example usage can be found here.

• FIX(import): Resolve state restoration issue causing layer shift on cropped images. Resolves #292.

• FIX(state-history): Resolve issue where the state history limitation does not work when enableBackgroundGeneration is set to false.

• FIX(Wasm): Fixes an issue where image generation fails when using WebAssembly. Resolves #391.

• DOCS(readme): simplify README for better readability

• FEAT: Add getter editorScaleFactor to retrieve current scale factor. See pull request #392 for more details.

• STYLE: Improved Dart code formatting