chore: mark clipboard action buttons as experimental

Author: EchoEllet

doc/migration/10_to_11.md

@@ -497,5 +497,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.

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;
@@ -35,6 +41,7 @@ class ClipboardMonitor {
   }
 }
 
+@experimental
 class QuillToolbarClipboardButton extends QuillToolbarToggleStyleBaseButton {
   QuillToolbarClipboardButton({
     required super.controller,

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