Merge branch 'master' into master

Author: EchoEllet

CHANGELOG.md

@@ -10,10 +10,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
-### Added
+### Changed
 
+- **BREAKING**: Change the `options` parameter class type from `QuillToolbarToggleStyleButtonOptions` to `QuillToolbarClipboardButtonOptions` in `QuillToolbarClipboardButton`. To migrate, use `QuillToolbarClipboardButtonOptions` instead of `QuillToolbarToggleStyleButtonOptions` [#2433](https://github.com/singerdmx/flutter-quill/pull/2433).
 - `enableClipboardPaste` flag in `QuillToolbarClipboardButton` to determine if the button defaults to `null,` which will use `ClipboardMonitor`, which checks every second if the clipboard has content to paste [#2427](https://github.com/singerdmx/flutter-quill/pull/2427).
-- Croatian (hr) language translation.
+
+## [11.0.0-dev.19] - 2025-01-10
+
+### Added
+
+- Croatian (hr) language translation [#2431](https://github.com/singerdmx/flutter-quill/pull/2431).
 
 ### Changed
 
@@ -180,7 +186,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Apple-specific font dependency for subscript and superscript functionality from the example.
 - **BREAKING**: The [`super_clipboard`](https://pub.dev/packages/super_clipboard) plugin, To restore legacy behavior for `super_clipboard`, use [`flutter_quill_extensions`](https://pub.dev/packages/flutter_quill_extensions) package and `FlutterQuillExtensions.useSuperClipboardPlugin()`.
 
-[unreleased]: https://github.com/singerdmx/flutter-quill/compare/v11.0.0-dev.18...HEAD
+[unreleased]: https://github.com/singerdmx/flutter-quill/compare/v11.0.0-dev.19...HEAD
+[11.0.0-dev.19]: https://github.com/singerdmx/flutter-quill/compare/v11.0.0-dev.18...v11.0.0-dev.19
 [11.0.0-dev.18]: https://github.com/singerdmx/flutter-quill/compare/v11.0.0-dev.17...v11.0.0-dev.18
 [11.0.0-dev.17]: https://github.com/singerdmx/flutter-quill/compare/v11.0.0-dev.16...v11.0.0-dev.17
 [11.0.0-dev.16]: https://github.com/singerdmx/flutter-quill/compare/v11.0.0-dev.15...v11.0.0-dev.16

doc/migration/10_to_11.md

@@ -351,6 +351,7 @@ required for **custom toolbars**.
 - Renames `QuillToolbarToggleCheckListButtonOptions.isShouldRequestKeyboard` to `QuillToolbarToggleCheckListButtonOptions.shouldRequestKeyboard`.
 - Moved `onClipboardPaste` from `QuillControllerConfig` to `QuillClipboardConfig`. Added `clipboardConfig` property to `QuillControllerConfig`.
 - Moved `onImagePaste` and `onGifPaste` from the editor's config (`QuillEditorConfig` or `QuillRawEditorConfig`) to the clipboard's config (`QuillClipboardConfig`), which is part of the controller's config (`QuillControllerConfig`).
+- Changed the options type from `QuillToolbarToggleStyleButtonOptions` to `QuillToolbarClipboardButtonOptions` in `QuillToolbarClipboardButton`, use the new options class.
 
 ## 💥 Breaking behavior
 
@@ -497,5 +498,6 @@ in non-major releases:
 - The `shouldNotifyListeners` in `QuillController.replaceText()`, `QuillController.replaceText()`, `QuillController.formatSelection()`.
 - The `QuillController.clipboardSelection()`.
 - The `CopyCutServiceProvider`, `CopyCutService`, and `DefaultCopyCutService`.
+- The clipboard action buttons in the `QuillSimpleToolbar` (`showClipboardCut`, `showClipboardCopy` and `showClipboardPaste`), including `QuillToolbarClipboardButton` and `ClipboardMonitor` due to a performance issue [#2421](https://github.com/singerdmx/flutter-quill/issues/2421).
 
 The functionality itself has not changed and no experimental changes were introduced.

example/pubspec.lock

@@ -217,7 +217,7 @@ packages:
       path: ".."
       relative: true
     source: path
-    version: "11.0.0-dev.18"
+    version: "11.0.0-dev.19"
   flutter_quill_delta_from_html:
     dependency: transitive
     description:

lib/src/editor/config/editor_config.dart

@@ -488,6 +488,12 @@ class QuillEditorConfig {
     Brightness? keyboardAppearance,
     ScrollPhysics? scrollPhysics,
     ValueChanged<String>? onLaunchUrl,
+    bool Function(
+            TapDragDownDetails details, TextPosition Function(Offset offset))?
+        onTapDown,
+    bool Function(
+            TapDragUpDetails details, TextPosition Function(Offset offset))?
+        onTapUp,
     Iterable<EmbedBuilder>? embedBuilders,
     EmbedBuilder? unknownEmbedBuilder,
     CustomStyleBuilder? customStyleBuilder,
@@ -547,6 +553,8 @@ class QuillEditorConfig {
       keyboardAppearance: keyboardAppearance ?? this.keyboardAppearance,
       scrollPhysics: scrollPhysics ?? this.scrollPhysics,
       onLaunchUrl: onLaunchUrl ?? this.onLaunchUrl,
+      onTapUp: onTapUp ?? this.onTapUp,
+      onTapDown: onTapDown ?? this.onTapDown,
       embedBuilders: embedBuilders ?? this.embedBuilders,
       unknownEmbedBuilder: unknownEmbedBuilder ?? this.unknownEmbedBuilder,
       customStyleBuilder: customStyleBuilder ?? this.customStyleBuilder,

lib/src/toolbar/buttons/clipboard_button.dart

@@ -1,16 +1,22 @@
+@experimental
+library;
+
 import 'dart:async';
 
 import 'package:flutter/foundation.dart';
 import 'package:flutter/material.dart';
+import 'package:meta/meta.dart';
 
 import '../../common/utils/widgets.dart';
 import '../../editor_toolbar_controller_shared/clipboard/clipboard_service_provider.dart';
 import '../../l10n/extensions/localizations_ext.dart';
 import '../base_button/base_value_button.dart';
 import '../simple_toolbar.dart';
 
+@experimental
 enum ClipboardAction { cut, copy, paste }
 
+@experimental
 class ClipboardMonitor {
   bool _canPaste = false;
   bool get canPaste => _canPaste;
@@ -51,17 +57,23 @@ class ClipboardMonitor {
   }
 }
 
+@experimental
 class QuillToolbarClipboardButton extends QuillToolbarToggleStyleBaseButton {
   QuillToolbarClipboardButton({
     required super.controller,
     required this.clipboardAction,
-    super.options = const QuillToolbarToggleStyleButtonOptions(),
+    QuillToolbarClipboardButtonOptions? options,
 
     /// Shares common options between all buttons, prefer the [options]
     /// over the [baseOptions].
     super.baseOptions,
     super.key,
-  });
+  })  : _options = options,
+        super(options: options ?? const QuillToolbarClipboardButtonOptions());
+
+  // TODO: This field will be used by the PR: https://github.com/singerdmx/flutter-quill/pull/2427
+  // ignore: unused_field
+  final QuillToolbarClipboardButtonOptions? _options;
 
   final ClipboardAction clipboardAction;
 

lib/src/toolbar/config/buttons/clipboard_button_options.dart

@@ -0,0 +1,29 @@
+/// @docImport '../../buttons/clipboard_button.dart';
+
+@experimental
+library;
+
+import 'package:meta/meta.dart';
+import 'toggle_style_options.dart';
+
+@experimental
+class QuillToolbarClipboardButtonOptions
+    extends QuillToolbarToggleStyleButtonOptions {
+  const QuillToolbarClipboardButtonOptions({
+    super.iconData,
+    super.afterButtonPressed,
+    super.childBuilder,
+    super.iconTheme,
+    super.tooltip,
+    super.iconSize,
+    super.iconButtonFactor,
+    this.enableClipboardPaste,
+  });
+
+  /// Determines if the paste button is enabled. The button is disabled and cannot be clicked if set to `false`.
+  ///
+  /// Defaults to [ClipboardMonitor] in case of `null`, which checks if the clipboard has content to paste every second and only then enables the button, indicating to the user that they can paste something.
+  ///
+  /// Set it to `true` to enable it even if the clipboard has no content to paste, which will do nothing on a press.
+  final bool? enableClipboardPaste;
+}

lib/src/toolbar/config/simple_toolbar_button_options.dart

@@ -1,7 +1,8 @@
-import 'package:flutter/foundation.dart' show immutable;
+import 'package:meta/meta.dart';
 
 import 'base_button_options.dart';
 import 'buttons/clear_format_options.dart';
+import 'buttons/clipboard_button_options.dart';
 import 'buttons/color_options.dart';
 import 'buttons/custom_button_options.dart';
 import 'buttons/font_family_options.dart';
@@ -21,6 +22,7 @@ import 'buttons/toggle_style_options.dart';
 export '../buttons/search/search_dialog.dart';
 export 'base_button_options.dart';
 export 'buttons/clear_format_options.dart';
+export 'buttons/clipboard_button_options.dart';
 export 'buttons/color_options.dart';
 export 'buttons/custom_button_options.dart';
 export 'buttons/font_family_options.dart';
@@ -76,9 +78,12 @@ class QuillSimpleToolbarButtonOptions {
     this.linkStyle = const QuillToolbarLinkStyleButtonOptions(),
     this.linkStyle2 = const QuillToolbarLinkStyleButton2Options(),
     this.customButtons = const QuillToolbarCustomButtonOptions(),
-    this.clipboardCut = const QuillToolbarToggleStyleButtonOptions(),
-    this.clipboardCopy = const QuillToolbarToggleStyleButtonOptions(),
-    this.clipboardPaste = const QuillToolbarToggleStyleButtonOptions(),
+    @experimental
+    this.clipboardCut = const QuillToolbarClipboardButtonOptions(),
+    @experimental
+    this.clipboardCopy = const QuillToolbarClipboardButtonOptions(),
+    @experimental
+    this.clipboardPaste = const QuillToolbarClipboardButtonOptions(),
   });
 
   /// The base options that will apply to all buttons,
@@ -109,26 +114,19 @@ class QuillSimpleToolbarButtonOptions {
   final QuillToolbarColorButtonOptions backgroundColor;
   final QuillToolbarClearFormatButtonOptions clearFormat;
 
-  /// The reason we call this buttons in the end because this is responsible
-  /// for all the alignment buttons and not just one, you still
-  /// can customize the icons and tooltips
-  /// and you have child builder
   final QuillToolbarSelectAlignmentButtonOptions selectAlignmentButtons;
 
   final QuillToolbarSearchButtonOptions search;
 
-  final QuillToolbarToggleStyleButtonOptions clipboardCut;
-  final QuillToolbarToggleStyleButtonOptions clipboardCopy;
-  final QuillToolbarToggleStyleButtonOptions clipboardPaste;
+  @experimental
+  final QuillToolbarClipboardButtonOptions clipboardCut;
+  @experimental
+  final QuillToolbarClipboardButtonOptions clipboardCopy;
+  @experimental
+  final QuillToolbarClipboardButtonOptions clipboardPaste;
 
-  /// The reason we call this buttons in the end because this is responsible
-  /// for all the header style buttons and not just one, you still
-  /// can customize it and you also have child builder
   final QuillToolbarSelectHeaderStyleButtonsOptions selectHeaderStyleButtons;
 
-  /// The reason we call this buttons in the end because this is responsible
-  /// for all the header style buttons and not just one, you still
-  /// can customize it and you also have child builder
   final QuillToolbarSelectHeaderStyleDropdownButtonOptions
       selectHeaderStyleDropdownButton;
 

lib/src/toolbar/config/simple_toolbar_config.dart

@@ -107,9 +107,9 @@ class QuillSimpleToolbarConfig {
     this.showSearchButton = true,
     this.showSubscript = true,
     this.showSuperscript = true,
-    this.showClipboardCut = false,
-    this.showClipboardCopy = false,
-    this.showClipboardPaste = false,
+    @experimental this.showClipboardCut = false,
+    @experimental this.showClipboardCopy = false,
+    @experimental this.showClipboardPaste = false,
     this.linkStyleType = LinkStyleType.original,
     this.headerStyleType = HeaderStyleType.original,
 
@@ -179,8 +179,11 @@ class QuillSimpleToolbarConfig {
   final bool showSearchButton;
   final bool showSubscript;
   final bool showSuperscript;
+  @experimental
   final bool showClipboardCut;
+  @experimental
   final bool showClipboardCopy;
+  @experimental
   final bool showClipboardPaste;
 
   /// This activates a functionality that is only implemented in [flutter_quill] and is NOT originally

pubspec.yaml

@@ -1,6 +1,6 @@
 name: flutter_quill
 description: "A rich text editor built for Android, iOS, Web, and desktop platforms. It's the WYSIWYG editor and a Quill component for Flutter."
-version: 11.0.0-dev.18
+version: 11.0.0-dev.19
 homepage: https://github.com/singerdmx/flutter-quill/
 repository: https://github.com/singerdmx/flutter-quill/
 issue_tracker: https://github.com/singerdmx/flutter-quill/issues/