feat: customizing portation and export structured quill delta

* Support customizing portation actions by overriding callback.
  * `BBCodePortationButtonClickedCallback`.
* Support export quill delta as `List<Map<String, dynamic>>`.
  * `toQuillDeltaJson`.

Author: realth000

lib/flutter_bbcode_editor.dart

@@ -7,6 +7,7 @@ export 'src/editor.dart'
         BBCodeEditorToolbar,
         BBCodeExt,
         BBCodeUrlPicker,
+        BBCodePortationButtonClickedCallback,
         PickColorResult,
         PickUrlResult,
         buildBBCodeEditorController;

lib/src/editor.dart

@@ -1,3 +1,4 @@
+import 'dart:async';
 import 'dart:convert';
 import 'dart:io';
 

lib/src/editor_controller.dart

@@ -1,5 +1,9 @@
 part of 'editor.dart';
 
+/// Function as portation button clicked callback.
+typedef BBCodePortationButtonClickedCallback =
+    FutureOr<void> Function(BuildContext context, BBCodeEditorController controller);
+
 /// Alias type.
 typedef BBCodeEditorController = QuillController;
 
@@ -99,6 +103,21 @@ extension BBCodeExt on BBCodeEditorController {
     return ret;
   }
 
+  /// Convert current document to quill delta json object.
+  List<Map<String, dynamic>> toQuillDeltaJson({bool trimCR = true}) {
+    if (!trimCR) {
+      return document.toDelta().toJson();
+    }
+
+    return document
+        .toDelta()
+        .operations
+        .map(
+          (op) => jsonDecode(jsonEncode(op.toJson()).replaceAll('\r', '')) as Map<String, dynamic>,
+        )
+        .toList();
+  }
+
   /// Convert current document to quill delta.
   String toQuillDelta({bool trimCR = true}) {
     final data = jsonEncode(document.toDelta().toJson());

lib/src/editor_tool_bar.dart

@@ -60,6 +60,7 @@ class BBCodeEditorToolbar extends StatefulWidget {
     BBCodeUrlPicker? urlPicker,
     BBCodeImagePicker? imagePicker,
     BBCodeUsernamePicker? usernamePicker,
+    BBCodePortationButtonClickedCallback? onPortationButtonClicked,
     String? host,
     this.showUndo = true,
     this.showRedo = true,
@@ -101,6 +102,7 @@ class BBCodeEditorToolbar extends StatefulWidget {
        _urlPicker = urlPicker,
        _imagePicker = imagePicker,
        _usernamePicker = usernamePicker,
+       _onPortationButtonClicked = onPortationButtonClicked,
        _host = host;
 
   final BBCodeEditorController _controller;
@@ -112,6 +114,7 @@ class BBCodeEditorToolbar extends StatefulWidget {
   final BBCodeUrlPicker? _urlPicker;
   final BBCodeImagePicker? _imagePicker;
   final BBCodeUsernamePicker? _usernamePicker;
+  final BBCodePortationButtonClickedCallback? _onPortationButtonClicked;
 
   /// The focus node shared with editor.
   final FocusNode? focusNode;
@@ -565,7 +568,10 @@ class _BBCodeEditorToolbarState extends State<BBCodeEditorToolbar> {
                   controller: controller,
                   options: BBCodePortationButtonOptions(
                     tooltip: context.bbcodeL10n.portationTitle,
-                    onPressed: () async => openPortationModalBottomSheet(context, widget._controller),
+                    onPressed:
+                        widget._onPortationButtonClicked != null
+                            ? () async => widget._onPortationButtonClicked!(context, widget._controller)
+                            : () async => openPortationModalBottomSheet(context, widget._controller),
                   ),
                   baseOptions: baseOptions,
                 ),