Merge branch 'master' into release

* master: (83 commits)
  Add copyWith methods to DefaultStyles, HorizontalSpacing, and VerticalSpacing (singerdmx#2550)
  docs: update migration guide to relfect singerdmx#2529
  chore(release): prepare to publish 11.4.0
  feat: allow to override link validation check, and accept mailto and other links by default (singerdmx#2525)
  chore(release): prepare to publish 11.3.0
  Fix selection in readOnly mode, Add magnifier via RawMagnifier widget (singerdmx#2529)
  Clarify platform support of QuillEditorConfig.onKeyPressed (singerdmx#2542)
  chore(release): prepare to publish 11.2.0
  feat: cache for toPlainText in Document to avoid unnecessary text computing (singerdmx#2482)
  chore(example): update deps
  chore(release): prepare to publish 11.1.2
  fix: QuillEditor doesn't respect the system keyboard brightness by default on iOS (singerdmx#2522)
  chore(release): prepare to publish flutter_quill_test
  chore(release): prepare to publish 11.1.1
  Chore: general improvements in flutter_quill_tests API (singerdmx#2512)
  Explicitly schedule frame on secondary click. (singerdmx#2507)
  chore(release): prepare to publish 11.1.0
  fix: unpredictable endless loop of '_handleFocusChanged' in the phase of page route changing when editor is set to readonly. (singerdmx#2488)
  feat: Enable BoxDecoration for DefaultTextBlockStyle of header Attribute (singerdmx#2438)
  Expose Rule type so that Document.setCustomRules can be used (singerdmx#2484)
  ...

Author: shanshen6

.github/ISSUE_TEMPLATE/1_bug.yml

@@ -1,31 +1,30 @@
 name: Report a bug
-description: |
-  You found a bug in Flutter Quill causing your application to crash or
-  throw an exception, a widget is buggy, unexpected behavior or something looks wrong.
+description: Report issues with Flutter Quill, including crashes, exceptions, buggy widgets, or unexpected behavior.
 labels: 'bug'
 body:
   - type: markdown
     attributes:
       value: |
-        Thank you for using Flutter Quill!
+        Please provide the following details to help us address your issue effectively.
 
   - type: checkboxes
     attributes:
-      label: Is there an existing issue for this?
+      label: Have you checked for an existing issue?
+      description: Ensure there isn’t already an open issue for this bug.
       options:
       - label: I have searched the [existing issues](https://github.com/singerdmx/flutter-quill/issues)
         required: true
   - type: input
     attributes:
-      label: Flutter Quill version
-      description: The version of the project for the packages (e.g., `flutter_quill` and `flutter_quill_extensions`)
-      placeholder: (e.g., 10.0.0)
+      label: Flutter Quill Version
+      description: The package version that's used in pubspec.lock
+      placeholder: e.g., 11.0.0
     validations:
-      required: false
+      required: true
   - type: textarea
     attributes:
-      label: Steps to reproduce
-      description: Please tell us exactly how to reproduce the problem you are running into.
+      label: Steps to Reproduce
+      description: Provide a clear step-by-step guide to reproduce the issue.
       placeholder: |
         1. ...
         2. ...
@@ -35,20 +34,22 @@ body:
   - type: textarea
     attributes:
       label: Expected results
-      description: Please tell us what is expected to happen.
+      description: Describe what you expected to happen.
     validations:
       required: true
   - type: textarea
     attributes:
       label: Actual results
-      description: Please tell us what is actually happening.
+      description: Describe what is happening instead of the expected behavior.
     validations:
       required: true
   - type: textarea
     attributes:
       label: Additional Context
       description: |
-        Include additional information such as Screenshots or Logs if needed.
+        Add any extra information such as screenshots, videos, or logs to help diagnose the issue.
+
+        Consider sharing the `pubspec.lock` file of the project if relevant.
 
         If the logs are too large to be uploaded to GitHub, you may upload
         them as a `txt` file or use online tools like https://pastebin.com to
@@ -57,17 +58,16 @@ body:
         <details>
         <summary>Screenshots / Video demonstration</summary>
 
-        [Upload media here]
+        [Attach media here]
 
         </details>
 
-
         <details><summary>Logs</summary>
 
         ```console
-        [Paste your logs here]
+        [Paste logs here]
         ```
 
         </details>
     validations:
-      required: false
+      required: false

.github/ISSUE_TEMPLATE/2_feature_request.yml

@@ -1,41 +1,36 @@
 name: Feature request
-description: Suggest a new idea for Flutter Quill.
+description: Propose a new idea or enhancement for Flutter Quill.
 labels: 'enhancement'
 body:
   - type: markdown
     attributes:
       value: |
-        Thank you for using Flutter Quill!
+        Please provide the following details to help us evaluate your feature request.
 
   - type: checkboxes
     attributes:
-      label: Is there an existing issue for this?
-      description: Please search to see if an issue already exists for this feature request or proposal.
+      label: Have you checked for an existing issue?
+      description: Ensure there isn’t already an open issue for this feature request.
       options:
         - label: I have searched the [existing issues](https://github.com/singerdmx/flutter-quill/issues)
           required: true
   - type: textarea
     attributes:
       label: Use case
       description: |
-        Please tell us the problem you are running into that led to you wanting
-        a new feature.
-
-        Is your feature request related to a problem? Please give a clear and
-        concise description of what the problem is.
-
-        Describe the alternative solutions you've considered. Is there already a solution that solves this?
+        Describe the problem or challenge that led to this feature request. 
+        Include any alternative solutions you’ve considered and why they don’t work.
     validations:
       required: true
   - type: textarea
     attributes:
       label: Proposal
       description: |
-        Briefly but precisely describe what you would like Flutter Quill to be able to do.
+        Describe your proposed solution and what you’d like Flutter Quill to do.
 
-        Consider attaching something showing what you are imagining:
-         * images
-         * videos
-         * code samples
+        You can include additional resources such as:
+         - Images
+         - Videos
+         - Code samples
     validations:
       required: true

.github/ISSUE_TEMPLATE/3_question.yml

@@ -1 +1,5 @@
 blank_issues_enabled: true
+contact_links:
+  - name: Community Support
+    url: https://github.com/singerdmx/flutter-quill/discussions/new?category=q-a
+    about: Ask a question about using the package.

.github/ISSUE_TEMPLATE/config.yml

@@ -1,46 +1,107 @@
-# TODO: Update the workflow to build on Android, iOS, desktop (macOS and Windows) instead of just Linux and Web
-
-name: 🏗️ Build the example
+name: Build the example
 
 on:
   pull_request:
     branches: [master, dev]
 
 jobs:
-  build_linux:
-    name: 🐧 Build Linux and Web Apps
+  # Build the Linux, Android and web apps on Linux
+  linux-web-android:
+    name: Linux, Android and Web Apps
     runs-on: ubuntu-latest
 
     steps:
-      - name: 📦 Checkout repository
-        uses: actions/checkout@v4
+      - uses: actions/checkout@v4
+
+      - name: Set up Flutter 
+        uses: subosito/flutter-action@v2
+        with:
+          channel: stable
+          cache: true
+
+      - name: Verify Flutter installation
+        run: flutter --version
+
+      - name: Install flutter_quill dependencies
+        run: flutter pub get
+
+      - name: Install example dependencies
+        run: flutter pub get -C example
+
+      - name: Build the Web app
+        run: flutter build web --release --dart-define=CI=true
+        working-directory: ./example
+
+      - name: Build the Web app with WebAssembly
+        run: flutter build web --release --wasm --dart-define=CI=true
+        working-directory: ./example
+
+      - name: Install Linux dependencies
+        run: |
+          sudo apt-get update -y
+          sudo apt-get install -y curl git unzip xz-utils zip libglu1-mesa
+          sudo apt-get install -y clang cmake ninja-build pkg-config libgtk-3-dev liblzma-dev libstdc++-12-dev
+
+      - name: Build the Linux app
+        run: flutter build linux --release --dart-define=CI=true
+        working-directory: ./example
+
+      - name: Build the Android app
+        run: flutter build appbundle --release --dart-define=CI=true
+        working-directory: ./example
+
+  macos:
+    name: iOS and macOS apps
+    runs-on: macos-latest
+
+    steps:
+      - uses: actions/checkout@v4
 
-      - name: 🛠️ Set up Flutter 
+      - name: Set up Flutter 
         uses: subosito/flutter-action@v2
         with:
-          channel: 'stable'
+          channel: stable
           cache: true
 
-      - name: 🔍 Verify Flutter installation
+      - name: Verify Flutter installation
         run: flutter --version
 
-      - name: 📥 Install Flutter dependencies
+      - name: Install flutter_quill dependencies
         run: flutter pub get
 
-      - name: 🌐 Build Flutter Web Application
-        run: flutter build web --release --verbose --dart-define=CI=true
+      - name: Install example dependencies
+        run: flutter pub get -C example
+
+      - name: Build the iOS app
+        run: flutter build ios --no-codesign --release --dart-define=CI=true
+        working-directory: ./example
+
+      - name: Build the macOS app
+        run: flutter build macos --release --dart-define=CI=true
         working-directory: ./example
 
-      # TODO: Update the CI to not upgrade all the packages to save some time
-      - name: 🔄 Update and Upgrade APT Packages
-        run: sudo apt update -y && sudo apt upgrade -y
+  windows:
+    name: Windows app
+    runs-on: windows-latest
 
-      - name: 🛠️ Install Flutter Linux Prerequisites
-        run: sudo apt install -y curl git unzip xz-utils zip libglu1-mesa
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Flutter 
+        uses: subosito/flutter-action@v2
+        with:
+          channel: stable
+          cache: true
+
+      - name: Verify Flutter installation
+        run: flutter --version
+
+      - name: Install flutter_quill dependencies
+        run: flutter pub get
 
-      - name: 🧩 Install Flutter Linux Desktop Dependencies
-        run: sudo apt install -y clang cmake git ninja-build pkg-config libgtk-3-dev liblzma-dev libstdc++-12-dev
+      - name: Install example dependencies
+        run: flutter pub get -C example
 
-      - name: 🐧 Build Flutter Linux Desktop Application
-        run: flutter build linux --release --verbose --dart-define=CI=true
+      - name: Build the Windows app
+        run: flutter build windows --release --dart-define=CI=true
         working-directory: ./example

.github/workflows/build.yml

@@ -1,4 +1,4 @@
-name: 📝 Changelog File Check
+name: Changelog File Check
 
 # This workflow only validates if the CHANGELOG.md file was updated and doesn't validate the format.
 
@@ -10,10 +10,10 @@ on:
 
 jobs:
   changelog:
-    name: 🔍 Verify Changelog Modification
+    name: Verify Changelog Modification
     runs-on: ubuntu-latest
     steps:
-      - name: ✅ Check if CHANGELOG.md was modified
+      - name: Check if CHANGELOG.md was modified
         uses: tarides/changelog-check-action@v2
         with:
           changelog: CHANGELOG.md

.github/workflows/changelog.yml

@@ -0,0 +1,60 @@
+name: Code Quality Checks
+
+on:
+  push:
+    branches: [master, dev]
+  pull_request:
+    branches: [master, dev]
+
+jobs:
+  tests:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Flutter
+        uses: subosito/flutter-action@v2
+        with:
+          channel: stable
+          cache: true
+
+      - name: Verify Flutter installation
+        run: flutter --version
+
+      - name: Install Flutter dependencies
+        run: flutter pub get
+      
+      - name: Install flutter_quill_extensions dependencies
+        run: flutter pub get -C flutter_quill_extensions
+
+      - name: Install flutter_quill_test dependencies
+        run: flutter pub get -C flutter_quill_test
+
+      - name: Perform Flutter Analysis
+        run: flutter analyze
+
+      # TODO: Restore Dart formatting check, disabled due to an issue https://github.com/singerdmx/flutter-quill/actions/runs/13355109619/job/37296760819.
+      # - name: Check Dart code formatting
+      #   run: dart format --set-exit-if-changed .
+      
+      - name: Preview Dart proposed changes
+        run: dart fix --dry-run
+
+      # TODO: Restore Dart formatting check, disabled due to an issue https://github.com/singerdmx/flutter-quill/actions/runs/13355109619/job/37296760819.
+      # - name: Check if the flutter_quill package is ready for publishing
+      #   run: flutter pub publish --dry-run
+
+      # # TODO: Restore Dart formatting check, disabled due to an issue https://github.com/singerdmx/flutter-quill/actions/runs/13355109619/job/37296760819.
+      # - name: Check if the flutter_quill_extensions is ready for publishing
+      #   run: flutter pub publish --dry-run -C flutter_quill_extensions
+
+      - name: Check the translations
+        run: dart ./scripts/translations_check.dart
+
+      - name: Install cider
+        run: dart pub global activate cider
+
+      # TODO: Need a more strict way to validate the format that uses https://keepachangelog.com/en/1.1.0/
+      - name: Validate CHANGELOG.md format
+        run: $HOME/.pub-cache/bin/cider list CHANGELOG.md