ckeditor5 1.24.10 → 1.26.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bbaa06c0cde62bfe01904bb70ca7c8e0f4db04610d2f71543d1fbd657182e781
-  data.tar.gz: 36ac98e55c8d927fc094cac0b60dd23284a0667ca0d3387b0858d980bc0f33bd
+  metadata.gz: ae47ab2c50827fd1a0716bc093475ce4e55a237ad3a9f4c35ba0b66d8ea46f7c
+  data.tar.gz: 13e648a1a348203b84f7220b7160c9d98e25753a97a207e4c5260d8d4d598571
 SHA512:
-  metadata.gz: 525255ffbc1aadedfe42eea761822f123f3f4de0617e19a443dcb3051d95841ced3f3fda0c8d73241094c84c4e6eac410f26b33ea9ebd1271d9ddd15ab52bcf3
-  data.tar.gz: 85f17299ba06f3187f7211eb345e93c4d5e7efbd6c2772fb855df883c7af732fd61ce8f32c788899fba3012fcb90770627c33b52182a280b70329a88f8361ce6
+  metadata.gz: c311294593a9de01ba525eab43d6dbf0418f454e6c7754a8c2a607464539ca82ed39f61a66d58f5c3a977f89a39c591adfb60b63711c47f3c2657e6c3442c49e
+  data.tar.gz: 64f021c1316971588676e9819d422b09d83bea982d74e94544ccbcc703ffb381778dc08aa308620559701a030d88423c20b5b3a678abfc1854daebb33f9fccc1

data/README.md

@@ -119,8 +119,7 @@ For extending CKEditor's functionality, refer to the [plugins directory](https:/
     - [Automatic upgrades 🔄](#automatic-upgrades-)
     - [Available Configuration Methods ⚙️](#available-configuration-methods-️)
       - [`cdn(cdn = nil, &block)` method](#cdncdn--nil-block-method)
-      - [`version(version)` method](#versionversion-method)
-      - [`automatic_upgrades(enabled: true)` method](#automatic_upgradesenabled-true-method)
+      - [`version(version, apply_patches: true)` method](#versionversion-apply_patches-true-method)
       - [`gpl` method](#gpl-method)
       - [`license_key(key)` method](#license_keykey-method)
       - [`premium` method](#premium-method)
@@ -138,7 +137,10 @@ For extending CKEditor's functionality, refer to the [plugins directory](https:/
       - [`plugins(*names, **kwargs)` method](#pluginsnames-kwargs-method)
       - [`inline_plugin(name, code)` method](#inline_pluginname-code-method)
       - [`external_plugin(name, script:, import_as: nil, window_name: nil, stylesheets: [])` method](#external_pluginname-script-import_as-nil-window_name-nil-stylesheets--method)
+      - [`patch_plugin(plugin)`](#patch_pluginplugin)
+      - [`apply_integration_patches` method](#apply_integration_patches-method)
       - [`simple_upload_adapter(url)` method](#simple_upload_adapterurl-method)
+      - [`special_characters(&block)` method](#special_charactersblock-method)
       - [`wproofreader(version: nil, cdn: nil, **config)` method](#wproofreaderversion-nil-cdn-nil-config-method)
     - [Controller / View helpers 📦](#controller--view-helpers-)
       - [`ckeditor5_element_ref(selector)` method](#ckeditor5_element_refselector-method)
@@ -316,7 +318,7 @@ end
 ```
 </details>
 
-#### `version(version)` method
+#### `version(version, apply_patches: true)` method
 
 <details>
   <summary>Set up the version of CKEditor 5 to be used by the integration</summary>
@@ -334,6 +336,23 @@ CKEditor5::Rails.configure do
   version '44.1.0'
 end
 ```
+
+In order to disable default patches, you can pass the `apply_patches: false` keyword argument to the `version` method.
+
+```rb
+# config/initializers/ckeditor5.rb
+
+CKEditor5::Rails.configure do
+  # ... other configuration
+
+  version '44.1.0', apply_patches: false
+end
+```
+
+The patches are defined in the `lib/ckeditor5/rails/plugins/patches` directory. If you want to apply custom patches, you can use the `patch_plugin` method.
+
+```rb
+
 </details>
 
 #### `automatic_upgrades(enabled: true)` method
@@ -978,6 +997,76 @@ end
 
 </details>
 
+#### `patch_plugin(plugin)`
+
+<details>
+  <summary>Appends plugin that applies patch to the specific versions of CKEditor 5</summary>
+
+<br />
+
+Defines a plugin that applies a patch to the specific versions of CKEditor 5. The example below shows how to define a plugin that applies a patch to the `44.1.0` version:
+
+```rb
+# config/initializers/ckeditor5.rb
+
+CKEditor5::Rails.configure do
+  # ... other configuration
+
+  patch_plugin MyPatchPlugin.new
+end
+```
+
+where the `MyPatchPlugin` should inherit from `KEditor5::Rails::Editor::PropsPatchPlugin` and implement the `initialize` method. For example:
+
+```rb
+class YourPatch < CKEditor5::Rails::Editor::PropsPatchPlugin
+  PLUGIN_CODE = <<~JS
+    const { Plugin, ColorPickerView, debounce } = await import( 'ckeditor5' );
+
+    return class YourPatch extends Plugin {
+      static get pluginName() {
+        return 'YourPatch';
+      }
+
+      constructor(editor) {
+        super(editor);
+
+        // ... your patch
+      }
+    }
+  JS
+
+  def initialize
+    super(:YourPatch, PLUGIN_CODE, min_version: nil, max_version: '45.0.0')
+    compress!
+  end
+end
+```
+</details>
+
+#### `apply_integration_patches` method
+
+<details>
+  <summary>Apply patches to the specific versions of CKEditor 5</summary>
+
+<br />
+
+Defines a method that applies patches to the specific versions of CKEditor 5. The example below shows how to apply patches to the `44.1.0` version:
+
+```rb
+# config/initializers/ckeditor5.rb
+
+CKEditor5::Rails.configure do
+  # ... other configuration
+
+  apply_integration_patches
+end
+```
+
+It's useful when you want to apply patches to the specific versions of CKEditor 5. The patches are defined in the `lib/ckeditor5/rails/plugins/patches` directory.
+
+</details>
+
 #### `simple_upload_adapter(url)` method
 
 <details>
@@ -1001,6 +1090,52 @@ end
 ```
 </details>
 
+#### `special_characters(&block)` method
+
+<details>
+  <summary>Configure special characters plugin</summary>
+
+<br />
+
+Defines the special characters plugin to be included in the editor. The example below shows how to include the special characters plugin:
+
+```rb
+# config/initializers/ckeditor5.rb
+
+CKEditor5::Rails.configure do
+  # ... other configuration
+
+  special_characters do
+    # Enable built-in packs using symbols
+    packs :Text, :Essentials, :Currency, :Mathematical, :Latin
+
+    # Custom groups
+    group 'Emoji', label: 'Emoticons' do
+      item 'smiley', '😊'
+      item 'heart', '❤️'
+    end
+
+    group 'Arrows',
+          items: [
+            { title: 'right arrow', character: '→' },
+            { title: 'left arrow', character: '←' }
+          ]
+
+    group 'Mixed',
+          items: [{ title: 'star', character: '⭐' }],
+          label: 'Mixed Characters' do
+      item 'heart', '❤️'
+    end
+
+    order :Text, :Currency, :Mathematical, :Latin, :Emoji, :Arrows, :Mixed
+  end
+end
+```
+
+For more info about the special characters plugin, check the [official documentation](https://ckeditor.com/docs/ckeditor5/latest/features/special-characters.html).
+
+</details>
+
 #### `wproofreader(version: nil, cdn: nil, **config)` method
 
 <details>

data/lib/ckeditor5/rails/editor/helpers.rb

@@ -3,6 +3,7 @@
 require_relative 'props_plugin'
 require_relative 'props_inline_plugin'
 require_relative 'props_external_plugin'
+require_relative 'props_patch_plugin'
 require_relative 'props'
 
 module CKEditor5::Rails::Editor::Helpers

data/lib/ckeditor5/rails/editor/props_patch_plugin.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+require_relative '../semver'
+require_relative 'props_inline_plugin'
+
+module CKEditor5::Rails::Editor
+  class PropsPatchPlugin < PropsInlinePlugin
+    attr_reader :min_version, :max_version
+
+    def initialize(name, code, min_version: nil, max_version: nil)
+      super(name, code)
+
+      @min_version = min_version && CKEditor5::Rails::Semver.new(min_version)
+      @max_version = max_version && CKEditor5::Rails::Semver.new(max_version)
+
+      compress!
+    end
+
+    def self.applicable_for_version?(editor_version, min_version: nil, max_version: nil)
+      return true if min_version.nil? && max_version.nil?
+
+      current_version = CKEditor5::Rails::Semver.new(editor_version)
+
+      min_check = min_version.nil? || current_version >= CKEditor5::Rails::Semver.new(min_version)
+      max_check = max_version.nil? || current_version <= CKEditor5::Rails::Semver.new(max_version)
+
+      min_check && max_check
+    end
+
+    def applicable_for_version?(editor_version)
+      self.class.applicable_for_version?(
+        editor_version,
+        min_version: @min_version&.to_s,
+        max_version: @max_version&.to_s
+      )
+    end
+  end
+end

data/lib/ckeditor5/rails/engine.rb

@@ -3,8 +3,7 @@
 require 'rails/engine'
 
 require_relative 'presets/manager'
-require_relative 'plugins/simple_upload_adapter'
-require_relative 'plugins/wproofreader'
+require_relative 'plugins'
 
 module CKEditor5::Rails
   class PresetNotFoundError < ArgumentError; end

data/lib/ckeditor5/rails/plugins/patches/fix_color_picker_race_condition.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+require_relative '../../editor/props_patch_plugin'
+
+module CKEditor5::Rails::Plugins::Patches
+  # Fixes focus management issues in the CKEditor5 color picker component
+  # by ensuring proper focus handling when the color picker is opened.
+  #
+  # The patch modifies the ColorPickerView's focus behavior to properly
+  # focus either the hex input field (when visible) or the first slider.
+  #
+  # @see https://github.com/ckeditor/ckeditor5/issues/17069
+  class FixColorPickerRaceCondition < CKEditor5::Rails::Editor::PropsPatchPlugin
+    PLUGIN_CODE = <<~JS
+      const { Plugin, ColorPickerView, debounce } = await import( 'ckeditor5' );
+
+      return class FixColorPickerRaceCondition extends Plugin {
+        static get pluginName() {
+          return 'FixColorPickerRaceCondition';
+        }
+
+        constructor(editor) {
+          super(editor);
+          this.editor = editor;
+          this.#applyPatch();
+        }
+
+        #applyPatch() {
+          const { focus } = ColorPickerView.prototype;
+
+          ColorPickerView.prototype.focus = function() {
+              try {
+                if (!this._config.hideInput) {
+                  this.hexInputRow.children.get( 1 ).focus();
+                }
+
+                this.slidersView.first.focus();
+              } catch (error) {
+                focus.apply(this, arguments);
+              }
+          }
+        }
+      }
+    JS
+
+    def initialize
+      super(:FixColorPickerRaceCondition, PLUGIN_CODE)
+      compress!
+    end
+  end
+end

data/lib/ckeditor5/rails/plugins/simple_upload_adapter.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require_relative '../editor/props_inline_plugin'
+
 module CKEditor5::Rails::Plugins
   class SimpleUploadAdapter < CKEditor5::Rails::Editor::PropsInlinePlugin
     PLUGIN_CODE = <<~JS

data/lib/ckeditor5/rails/plugins/special_characters_bootstrap.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+require_relative '../editor/props_inline_plugin'
+
+module CKEditor5::Rails::Plugins
+  class SpecialCharactersBootstrap < CKEditor5::Rails::Editor::PropsInlinePlugin
+    PLUGIN_CODE = <<~JS
+      const { Plugin } = await import( 'ckeditor5' );
+
+      return class SpecialCharactersBootstrap extends Plugin {
+        static get pluginName() {
+          return 'SpecialCharactersBootstrap';
+        }
+
+        get bootstrapConfig() {
+          return this.editor.config.get('specialCharactersBootstrap');
+        }
+
+        async init() {
+          const { editor, bootstrapConfig } = this;
+          const currentConfig = editor.config.get('specialCharacters');
+
+          if (!bootstrapConfig) {
+            return;
+          }
+
+          editor.config.define('specialCharacters', {
+            ...currentConfig,
+            order: bootstrapConfig.order || currentConfig.order,
+          } );
+        }
+
+        async afterInit() {
+          const { editor, bootstrapConfig } = this;
+          const specialCharacters = editor.plugins.get('SpecialCharacters');
+
+          if (!specialCharacters || !bootstrapConfig) {
+            return;
+          }
+
+          const groups = bootstrapConfig.groups || [];
+
+          for (const { name, items, options } of groups) {
+            specialCharacters.addItems(name, items, {
+              label: name,
+              ...options
+            });
+          }
+        }
+      }
+    JS
+
+    def initialize
+      super(:SpecialCharactersBootstrap, PLUGIN_CODE)
+      compress!
+    end
+  end
+end

data/lib/ckeditor5/rails/plugins/wproofreader.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-require_relative '../editor/props_external_plugin'
+require_relative '../editor/props_inline_plugin'
 
 module CKEditor5::Rails::Plugins
   class WProofreader < CKEditor5::Rails::Editor::PropsExternalPlugin

data/lib/ckeditor5/rails/plugins.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module CKEditor5::Rails::Plugins
+  module Patches
+  end
+end
+
+# Core plugins
+require_relative 'plugins/simple_upload_adapter'
+require_relative 'plugins/wproofreader'
+require_relative 'plugins/special_characters_bootstrap'
+
+# Plugin patches and fixes
+require_relative 'plugins/patches/fix_color_picker_race_condition'

data/lib/ckeditor5/rails/presets/concerns/plugin_methods.rb

@@ -12,6 +12,7 @@ module CKEditor5::Rails
         class DisallowedInlinePluginError < ArgumentError; end
         class MissingInlinePluginError < StandardError; end
         class UnsupportedESModuleError < StandardError; end
+        class InvalidPatchPluginError < ArgumentError; end
 
         included do
           attr_reader :disallow_inline_plugins, :disallow_inline_plugin_compression
@@ -67,6 +68,23 @@ module CKEditor5::Rails
           register_plugin(plugin)
         end
 
+        # Registers a patch plugin that modifies CKEditor behavior for specific versions
+        #
+        # @param plugin [Editor::PropsPatchPlugin] Patch plugin instance to register
+        # @raise [InvalidPatchPluginError] When provided plugin is not a PropsPatchPlugin
+        # @return [Editor::PropsPatchPlugin, nil] Returns plugin if registered, nil if not applicable
+        # @example Apply patch for specific CKEditor versions
+        #   patch_plugin PropsPatchPlugin.new(:PatchName, code, min_version: '35.0.0', max_version: '36.0.0')
+        def patch_plugin(plugin)
+          unless plugin.is_a?(Editor::PropsPatchPlugin)
+            raise InvalidPatchPluginError, 'Provided plugin must be a PropsPatchPlugin instance'
+          end
+
+          return unless plugin.applicable_for_version?(config[:version])
+
+          register_plugin(plugin)
+        end
+
         # Register a single plugin by name
         #
         # @param name [Symbol, Editor::PropsBasePlugin] Plugin name or instance

data/lib/ckeditor5/rails/presets/preset_builder.rb

@@ -2,6 +2,7 @@
 
 require_relative 'concerns/configuration_methods'
 require_relative 'concerns/plugin_methods'
+require_relative 'special_characters_builder'
 
 module CKEditor5::Rails
   module Presets
@@ -171,11 +172,16 @@ module CKEditor5::Rails
       end
 
       # Set or get editor version
-      # @param version [String, nil] Editor version
+      # @param version [String, nil] Editor version to set
+      # @param apply_patches [Boolean] Whether to apply integration patches after setting version
       # @example Set specific version
       #   version '43.3.1'
-      # @return [String, nil] Current version
-      def version(version = nil)
+      # @example Set version without applying patches
+      #   version '43.3.1', apply_patches: false
+      # @example Get current version
+      #   version # => "43.3.1"
+      # @return [String, nil] Current version string or nil if not set
+      def version(version = nil, apply_patches: true)
         return @version&.to_s if version.nil?
 
         if @automatic_upgrades && version
@@ -184,6 +190,14 @@ module CKEditor5::Rails
         else
           @version = Semver.new(version)
         end
+
+        apply_integration_patches if apply_patches
+      end
+
+      # Apply integration patches for the current version
+      # @return [void]
+      def apply_integration_patches
+        patch_plugin Plugins::Patches::FixColorPickerRaceCondition.new
       end
 
       # Enable or disable automatic version upgrades
@@ -368,6 +382,46 @@ module CKEditor5::Rails
         end
       end
 
+      # Configure special characters plugin
+      #
+      # @yield Block for configuring special characters
+      # @example Basic configuration with block
+      #   special_characters do
+      #     group 'Emoji', label: 'Emoticons' do
+      #       item 'smiley', '😊'
+      #       item 'heart', '❤️'
+      #     end
+      #     order :Text, :Emoji
+      #   end
+      # @example Configuration with direct items array
+      #   special_characters do
+      #     group 'Arrows',
+      #           items: [
+      #             { title: 'right', character: '→' },
+      #             { title: 'left', character: '←' }
+      #           ]
+      #   end
+      # @example Mixed configuration
+      #   special_characters do
+      #     group 'Mixed',
+      #           items: [{ title: 'star', character: '⭐' }],
+      #           label: 'Mixed Characters' do
+      #       item 'heart', '❤️'
+      #     end
+      #   end
+      def special_characters(&block)
+        builder = SpecialCharactersBuilder.new
+        builder.instance_eval(&block) if block_given?
+
+        plugins do
+          append(:SpecialCharacters)
+          builder.packs_plugins.each { |pack| append(pack) }
+          prepend(Plugins::SpecialCharactersBootstrap.new)
+        end
+
+        configure(:specialCharactersBootstrap, builder.to_h)
+      end
+
       private
 
       def deep_copy_toolbar(toolbar)

data/lib/ckeditor5/rails/presets/special_characters_builder.rb

@@ -0,0 +1,150 @@
+# frozen_string_literal: true
+
+module CKEditor5::Rails::Presets
+  # Builder class for configuring special characters in CKEditor5
+  #
+  # @example Basic configuration
+  #   special_characters do
+  #     group 'Emoji', label: 'Emoticons' do
+  #       item 'smiley', '😊'
+  #     end
+  #
+  #     order :Text, :Mathematical, :Emoji
+  #   end
+  class SpecialCharactersBuilder
+    attr_reader :packs_plugins
+
+    # Builder class for configuring special characters groups
+    #
+    # @example Basic group configuration
+    #   group = Group.new('Emoji', label: 'Emoticons')
+    #   group.item('smiley', '😊')
+    class Group
+      attr_reader :name, :label
+      private attr_reader :items
+
+      # Initialize a new special characters group
+      #
+      # @param name [String] Name of the group
+      # @param label [String, nil] Optional display label for the group
+      def initialize(name, label: nil)
+        @name = name
+        @label = label
+        @items = []
+      end
+
+      # Add a single character to the group
+      #
+      # @param title [String] Character title/description
+      # @param character [String] The special character
+      # @example Add smiley face
+      #   item 'smiley face', '😊'
+      def item(title, character)
+        @items << { title: title, character: character }
+      end
+
+      # Add multiple characters to the group at once
+      #
+      # @param collection [Array<Hash>] Array of character definitions
+      # @example Add multiple items
+      #   add_items [
+      #     { title: 'star', character: '⭐' },
+      #     { title: 'heart', character: '❤️' }
+      #   ]
+      def add_items(collection)
+        collection.each do |item|
+          @items << item.slice(:title, :character)
+        end
+      end
+
+      # Add multiple characters to the group
+      #
+      # @param items [Array<Hash>] Array of character definitions
+      def add_characters(items)
+        items.each do |item|
+          @items << item.slice(:title, :character)
+        end
+      end
+
+      # Convert group configuration to hash
+      #
+      # @return [Hash] Group configuration hash
+      def to_h
+        {
+          name: @name,
+          items: @items,
+          options: label ? { label: label } : {}
+        }
+      end
+    end
+
+    # Initialize a new special characters builder
+    #
+    # @example Create new builder
+    #   SpecialCharactersBuilder.new
+    def initialize
+      @groups = []
+      @order = []
+      @packs_plugins = []
+    end
+
+    # Define a new special characters group
+    #
+    # @param name [String] Name of the group
+    # @param items [Array<Hash>] Optional array of character items
+    # @param label [String, nil] Optional display label
+    # @yield Group configuration block
+    # @return [Group] Created group instance
+    # @example Define group with items array
+    #   group 'Emoji',
+    #         items: [
+    #           { title: 'smiley', character: '😊' },
+    #           { title: 'heart', character: '❤️' }
+    #         ],
+    #         label: 'Emoticons'
+    # @example Define group with block
+    #   group 'Emoji', label: 'Emoticons' do
+    #     item 'smiley', '😊'
+    #     item 'heart', '❤️'
+    #   end
+    def group(name, items: [], label: nil, &block)
+      group = Group.new(name, label: label)
+      group.add_characters(items) if items.any?
+      group.instance_eval(&block) if block_given?
+      @groups << group
+      group
+    end
+
+    # Enable special characters packs
+    #
+    # @param names [Array<Symbol, String>] Pack names to enable
+    # @example Enable essential and extended characters
+    #   packs :Text, :Currency, :Mathematical
+    def packs(*names)
+      names.each do |name|
+        plugin_name = "SpecialCharacters#{name.to_s.capitalize}"
+        @packs_plugins << plugin_name
+      end
+    end
+
+    # Set the display order of character groups
+    #
+    # @param categories [Array<Symbol, String>] Category names in desired order
+    # @example Set display order
+    #   order :Text, :Mathematical, 'Currency', :Emoji
+    def order(*categories)
+      @order = categories.map(&:to_s)
+    end
+
+    # Convert builder configuration to hash
+    #
+    # @return [Hash] Complete special characters configuration
+    def to_h
+      {
+        groups: @groups.map(&:to_h),
+        order: @order,
+        packs: @packs_plugins
+      }
+    end
+  end
+end

data/lib/ckeditor5/rails/version.rb

@@ -2,7 +2,7 @@
 
 module CKEditor5
   module Rails
-    VERSION = '1.24.10'
+    VERSION = '1.26.0'
 
     DEFAULT_CKEDITOR_VERSION = '44.1.0'
   end

data/spec/lib/ckeditor5/rails/cdn/helpers_spec.rb

@@ -20,7 +20,7 @@ RSpec.describe CKEditor5::Rails::Cdn::Helpers do
   let(:helper) { test_class.new }
   let(:preset) do
     CKEditor5::Rails::Presets::PresetBuilder.new do
-      version '34.1.0'
+      version '34.1.0', apply_patches: false
       type :classic
       translations :pl
       cdn :cloud
@@ -151,7 +151,7 @@ RSpec.describe CKEditor5::Rails::Cdn::Helpers do
     context 'when overriding preset values' do
       let(:preset) do
         CKEditor5::Rails::Presets::PresetBuilder.new do
-          version '34.1.0'
+          version '34.1.0', apply_patches: false
           type :classic
           language :pl
           cdn :cloud

data/spec/lib/ckeditor5/rails/editor/props_patch_plugin_spec.rb

@@ -0,0 +1,71 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+RSpec.describe CKEditor5::Rails::Editor::PropsPatchPlugin do
+  let(:plugin_name) { 'testPlugin' }
+  let(:plugin_code) { 'console.log("test");' }
+
+  describe '#initialize' do
+    it 'creates plugin with version constraints' do
+      plugin = described_class.new(plugin_name, plugin_code, min_version: '29.0.0', max_version: '30.0.0')
+
+      expect(plugin.min_version.to_s).to eq('29.0.0')
+      expect(plugin.max_version.to_s).to eq('30.0.0')
+    end
+
+    it 'creates plugin without version constraints' do
+      plugin = described_class.new(plugin_name, plugin_code)
+
+      expect(plugin.min_version).to be_nil
+      expect(plugin.max_version).to be_nil
+    end
+  end
+
+  describe '.applicable_for_version?' do
+    it 'returns true when no version constraints' do
+      expect(described_class.applicable_for_version?('29.0.0')).to be true
+    end
+
+    it 'returns true when version is within constraints' do
+      result = described_class.applicable_for_version?(
+        '29.1.0',
+        min_version: '29.0.0',
+        max_version: '30.0.0'
+      )
+      expect(result).to be true
+    end
+
+    it 'returns false when version is too low' do
+      result = described_class.applicable_for_version?(
+        '28.9.9',
+        min_version: '29.0.0',
+        max_version: '30.0.0'
+      )
+      expect(result).to be false
+    end
+
+    it 'returns false when version is too high' do
+      result = described_class.applicable_for_version?(
+        '30.0.1',
+        min_version: '29.0.0',
+        max_version: '30.0.0'
+      )
+      expect(result).to be false
+    end
+  end
+
+  describe '#applicable_for_version?' do
+    let(:plugin) do
+      described_class.new(plugin_name, plugin_code, min_version: '29.0.0', max_version: '30.0.0')
+    end
+
+    it 'returns true for version within constraints' do
+      expect(plugin.applicable_for_version?('29.1.0')).to be true
+    end
+
+    it 'returns false for version outside constraints' do
+      expect(plugin.applicable_for_version?('28.9.9')).to be false
+    end
+  end
+end

data/spec/lib/ckeditor5/rails/presets/manager_spec.rb

@@ -20,7 +20,7 @@ RSpec.describe CKEditor5::Rails::Presets::Manager do
       it 'creates new preset based on default' do
         manager.define(:custom) do
           automatic_upgrades enabled: false
-          version '36.0.0'
+          version '36.0.0', apply_patches: false
         end
 
         expect(manager[:custom].version).to eq('36.0.0')
@@ -32,7 +32,7 @@ RSpec.describe CKEditor5::Rails::Presets::Manager do
       it 'creates completely new preset' do
         manager.define(:custom, inherit: false) do
           automatic_upgrades enabled: false
-          version '36.0.0'
+          version '36.0.0', apply_patches: false
         end
 
         expect(manager[:custom].version).to eq('36.0.0')

data/spec/lib/ckeditor5/rails/presets/preset_builder_spec.rb

@@ -1,8 +1,6 @@
 # frozen_string_literal: true
 
 require 'spec_helper'
-require_relative './plugins_builder_spec'
-require_relative './toolbar_builder_spec'
 
 RSpec.describe CKEditor5::Rails::Presets::PresetBuilder do
   let(:builder) { described_class.new }
@@ -520,4 +518,145 @@ RSpec.describe CKEditor5::Rails::Presets::PresetBuilder do
       expect(builder.config[:wproofreader]).to eq({ language: 'en' })
     end
   end
+
+  describe '#special_characters' do
+    it 'configures special characters with groups and items' do # rubocop:disable Metrics/BlockLength
+      builder.special_characters do
+        group 'Emoji', label: 'Emoticons' do
+          item 'smiley', '😊'
+          item 'heart', '❤️'
+        end
+
+        group 'Arrows',
+              items: [
+                { title: 'right', character: '→' },
+                { title: 'left', character: '←' }
+              ]
+
+        group 'Mixed',
+              items: [{ title: 'star', character: '⭐' }],
+              label: 'Mixed Characters' do
+          item 'heart', '❤️'
+        end
+
+        order :Text, :Arrows, :Emoji, :Mixed
+      end
+
+      expect(builder.config[:specialCharactersBootstrap]).to eq({
+                                                                  groups: [
+                                                                    {
+                                                                      name: 'Emoji',
+                                                                      items: [
+                                                                        { title: 'smiley', character: '😊' },
+                                                                        { title: 'heart', character: '❤️' }
+                                                                      ],
+                                                                      options: { label: 'Emoticons' }
+                                                                    },
+                                                                    {
+                                                                      name: 'Arrows',
+                                                                      items: [
+                                                                        { title: 'right', character: '→' },
+                                                                        { title: 'left', character: '←' }
+                                                                      ],
+                                                                      options: {}
+                                                                    },
+                                                                    {
+                                                                      name: 'Mixed',
+                                                                      items: [
+                                                                        { title: 'star', character: '⭐' },
+                                                                        { title: 'heart', character: '❤️' }
+                                                                      ],
+                                                                      options: { label: 'Mixed Characters' }
+                                                                    }
+                                                                  ],
+                                                                  order: %w[Text Arrows Emoji Mixed],
+                                                                  packs: []
+                                                                })
+
+      plugin_names = builder.config[:plugins].map(&:name)
+      expect(plugin_names).to include(:SpecialCharacters)
+      expect(plugin_names).to include(:SpecialCharactersBootstrap)
+    end
+
+    it 'enables special characters packs' do
+      builder.special_characters do
+        packs :Text, :Mathematical, :Currency
+      end
+
+      plugin_names = builder.config[:plugins].map(&:name)
+      expect(plugin_names).to include(
+        :SpecialCharactersBootstrap,
+        :SpecialCharacters,
+        'SpecialCharactersText',
+        'SpecialCharactersMathematical',
+        'SpecialCharactersCurrency'
+      )
+    end
+  end
+
+  describe '#patch_plugin' do
+    let(:patch_plugin) do
+      CKEditor5::Rails::Editor::PropsPatchPlugin.new(
+        :TestPatch,
+        <<~JAVASCRIPT
+          const { Plugin } = await import('ckeditor5');
+          return class TestPatch extends Plugin {
+            init() {}
+          }
+        JAVASCRIPT
+      )
+    end
+
+    it 'raises error when plugin is not a PropsPatchPlugin' do
+      invalid_plugin = CKEditor5::Rails::Editor::PropsPlugin.new(:InvalidPatch)
+
+      expect { builder.patch_plugin(invalid_plugin) }
+        .to raise_error(
+          CKEditor5::Rails::Presets::Concerns::PluginMethods::InvalidPatchPluginError,
+          'Provided plugin must be a PropsPatchPlugin instance'
+        )
+    end
+
+    it 'applies patch when applicable' do
+      allow(patch_plugin).to receive(:applicable_for_version?).and_return(true)
+
+      builder.version('35.0.0', apply_patches: false)
+      builder.patch_plugin(patch_plugin)
+
+      plugin_names = builder.config[:plugins].map(&:name)
+      expect(plugin_names).to include(:TestPatch)
+    end
+
+    it 'skips patch when not applicable' do
+      allow(patch_plugin).to receive(:applicable_for_version?).and_return(false)
+
+      builder.version('35.0.0')
+      builder.patch_plugin(patch_plugin)
+
+      plugin_names = builder.config[:plugins].map(&:name)
+      expect(plugin_names).not_to include(:TestPatch)
+    end
+
+    it 'applies patch when version is not set' do
+      builder.patch_plugin(patch_plugin)
+
+      plugin_names = builder.config[:plugins].map(&:name)
+      expect(plugin_names).to include(:TestPatch)
+    end
+  end
+
+  describe '#apply_integration_patches' do
+    it 'applies known integration patches' do
+      builder.version('35.0.0', apply_patches: false)
+      expect { builder.apply_integration_patches }
+        .to change { builder.config[:plugins].count }
+        .by(1)
+    end
+
+    it 'apply patches when version is not set' do
+      expect { builder.apply_integration_patches }
+        .to change { builder.config[:plugins].count }
+        .by(1)
+    end
+  end
 end

data/spec/lib/ckeditor5/rails/presets/special_characters_builder_spec.rb

@@ -0,0 +1,157 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+RSpec.describe CKEditor5::Rails::Presets::SpecialCharactersBuilder do
+  subject(:builder) { described_class.new }
+
+  describe '#group' do
+    it 'creates a group with items array' do
+      group = builder.group('Arrows', items: [
+                              { title: 'right', character: '→' },
+                              { title: 'left', character: '←' }
+                            ])
+
+      expect(group.to_h).to eq({
+                                 name: 'Arrows',
+                                 items: [
+                                   { title: 'right', character: '→' },
+                                   { title: 'left', character: '←' }
+                                 ],
+                                 options: {}
+                               })
+    end
+
+    it 'creates a group with block syntax' do
+      group = builder.group('Emoji', label: 'Emoticons') do
+        item 'smiley', '😊'
+        item 'heart', '❤️'
+      end
+
+      expect(group.to_h).to eq({
+                                 name: 'Emoji',
+                                 items: [
+                                   { title: 'smiley', character: '😊' },
+                                   { title: 'heart', 'character': '❤️' }
+                                 ],
+                                 options: { label: 'Emoticons' }
+                               })
+    end
+
+    it 'creates a group with mixed configuration' do
+      group = builder.group('Mixed',
+                            items: [{ title: 'star', character: '⭐' }],
+                            label: 'Mixed Characters') do
+        item 'heart', '❤️'
+      end
+
+      expect(group.to_h).to eq({
+                                 name: 'Mixed',
+                                 items: [
+                                   { title: 'star', character: '⭐' },
+                                   { title: 'heart', 'character': '❤️' }
+                                 ],
+                                 options: { label: 'Mixed Characters' }
+                               })
+    end
+  end
+
+  describe '#packs' do
+    it 'registers special characters plugins' do
+      builder.packs(:Text, :Mathematical, :Currency)
+
+      expect(builder.packs_plugins).to eq(%w[
+                                            SpecialCharactersText
+                                            SpecialCharactersMathematical
+                                            SpecialCharactersCurrency
+                                          ])
+    end
+  end
+
+  describe '#order' do
+    it 'sets the display order of character groups' do
+      builder.order(:Text, :Mathematical, 'Currency', :Emoji)
+
+      expect(builder.to_h[:order]).to eq(%w[Text Mathematical Currency Emoji])
+    end
+  end
+
+  describe '#to_h' do
+    it 'returns complete configuration' do
+      builder.group('Emoji', label: 'Emoticons') do
+        item 'smiley', '😊'
+      end
+
+      builder.packs(:Text, :Mathematical)
+      builder.order(:Text, :Mathematical, :Emoji)
+
+      expect(builder.to_h).to eq({
+                                   groups: [{
+                                     name: 'Emoji',
+                                     items: [{ title: 'smiley', character: '😊' }],
+                                     options: { label: 'Emoticons' }
+                                   }],
+                                   order: %w[Text Mathematical Emoji],
+                                   packs: %w[SpecialCharactersText SpecialCharactersMathematical]
+                                 })
+    end
+  end
+
+  describe CKEditor5::Rails::Presets::SpecialCharactersBuilder::Group do
+    subject(:group) { described_class.new('Test', label: 'Test Group') }
+
+    describe '#item' do
+      it 'adds a single character' do
+        group.item('test', '*')
+        expect(group.to_h[:items]).to eq([{ title: 'test', character: '*' }])
+      end
+    end
+
+    describe '#add_items' do
+      it 'adds multiple characters' do
+        group.add_items([
+                          { title: 'star', character: '⭐' },
+                          { title: 'heart', 'character': '❤️' }
+                        ])
+
+        expect(group.to_h[:items]).to eq([
+                                           { title: 'star', character: '⭐' },
+                                           { title: 'heart', 'character': '❤️' }
+                                         ])
+      end
+
+      it 'filters out invalid keys' do
+        group.add_items([
+                          { title: 'star', character: '⭐', invalid: 'key' }
+                        ])
+
+        expect(group.to_h[:items]).to eq([
+                                           { title: 'star', character: '⭐' }
+                                         ])
+      end
+    end
+
+    describe '#to_h' do
+      it 'includes group name, items and options' do
+        group.item('test', '*')
+
+        expect(group.to_h).to eq({
+                                   name: 'Test',
+                                   items: [{ title: 'test', character: '*' }],
+                                   options: { label: 'Test Group' }
+                                 })
+      end
+
+      it 'omits empty options' do
+        group = described_class.new('Test')
+        group.item('test', '*')
+
+        expect(group.to_h).to eq({
+                                   name: 'Test',
+                                   items: [{ title: 'test', character: '*' }],
+                                   options: {}
+                                 })
+      end
+    end
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ckeditor5
 version: !ruby/object:Gem::Version
-  version: 1.24.10
+  version: 1.26.0
 platform: ruby
 authors:
 - Mateusz Bagiński
@@ -9,7 +9,7 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-01-28 00:00:00.000000000 Z
+date: 2025-02-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -82,19 +82,24 @@ files:
 - lib/ckeditor5/rails/editor/props_base_plugin.rb
 - lib/ckeditor5/rails/editor/props_external_plugin.rb
 - lib/ckeditor5/rails/editor/props_inline_plugin.rb
+- lib/ckeditor5/rails/editor/props_patch_plugin.rb
 - lib/ckeditor5/rails/editor/props_plugin.rb
 - lib/ckeditor5/rails/engine.rb
 - lib/ckeditor5/rails/helpers.rb
 - lib/ckeditor5/rails/hooks/form.rb
 - lib/ckeditor5/rails/hooks/importmap.rb
 - lib/ckeditor5/rails/hooks/simple_form.rb
+- lib/ckeditor5/rails/plugins.rb
+- lib/ckeditor5/rails/plugins/patches/fix_color_picker_race_condition.rb
 - lib/ckeditor5/rails/plugins/simple_upload_adapter.rb
+- lib/ckeditor5/rails/plugins/special_characters_bootstrap.rb
 - lib/ckeditor5/rails/plugins/wproofreader.rb
 - lib/ckeditor5/rails/presets/concerns/configuration_methods.rb
 - lib/ckeditor5/rails/presets/concerns/plugin_methods.rb
 - lib/ckeditor5/rails/presets/manager.rb
 - lib/ckeditor5/rails/presets/plugins_builder.rb
 - lib/ckeditor5/rails/presets/preset_builder.rb
+- lib/ckeditor5/rails/presets/special_characters_builder.rb
 - lib/ckeditor5/rails/presets/toolbar_builder.rb
 - lib/ckeditor5/rails/semver.rb
 - lib/ckeditor5/rails/version.rb
@@ -123,6 +128,7 @@ files:
 - spec/lib/ckeditor5/rails/editor/props_base_plugin_spec.rb
 - spec/lib/ckeditor5/rails/editor/props_external_plugin_spec.rb
 - spec/lib/ckeditor5/rails/editor/props_inline_plugin_spec.rb
+- spec/lib/ckeditor5/rails/editor/props_patch_plugin_spec.rb
 - spec/lib/ckeditor5/rails/editor/props_plugin_spec.rb
 - spec/lib/ckeditor5/rails/editor/props_spec.rb
 - spec/lib/ckeditor5/rails/engine_spec.rb
@@ -133,6 +139,7 @@ files:
 - spec/lib/ckeditor5/rails/presets/manager_spec.rb
 - spec/lib/ckeditor5/rails/presets/plugins_builder_spec.rb
 - spec/lib/ckeditor5/rails/presets/preset_builder_spec.rb
+- spec/lib/ckeditor5/rails/presets/special_characters_builder_spec.rb
 - spec/lib/ckeditor5/rails/presets/toolbar_builder_spec.rb
 - spec/lib/ckeditor5/rails/semver_spec.rb
 - spec/lib/ckeditor5/rails/version_detector_spec.rb
@@ -191,6 +198,7 @@ test_files:
 - spec/lib/ckeditor5/rails/editor/props_base_plugin_spec.rb
 - spec/lib/ckeditor5/rails/editor/props_external_plugin_spec.rb
 - spec/lib/ckeditor5/rails/editor/props_inline_plugin_spec.rb
+- spec/lib/ckeditor5/rails/editor/props_patch_plugin_spec.rb
 - spec/lib/ckeditor5/rails/editor/props_plugin_spec.rb
 - spec/lib/ckeditor5/rails/editor/props_spec.rb
 - spec/lib/ckeditor5/rails/engine_spec.rb
@@ -201,6 +209,7 @@ test_files:
 - spec/lib/ckeditor5/rails/presets/manager_spec.rb
 - spec/lib/ckeditor5/rails/presets/plugins_builder_spec.rb
 - spec/lib/ckeditor5/rails/presets/preset_builder_spec.rb
+- spec/lib/ckeditor5/rails/presets/special_characters_builder_spec.rb
 - spec/lib/ckeditor5/rails/presets/toolbar_builder_spec.rb
 - spec/lib/ckeditor5/rails/semver_spec.rb
 - spec/lib/ckeditor5/rails/version_detector_spec.rb