ckeditor5 1.25.0 → 1.26.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 51c0f877edf5aa0ddc0c6b2333f5b631f1ce04144a84eb20c4555bfe63d3206b
-  data.tar.gz: 5d477a6bdf0d8fd05fc3bfedfe34f33398a1c58a015a5de8f6871afd1f38f4bb
+  metadata.gz: b30c6cdd98e034209f4dd07ffa70d5a209c207fc1f7a7b37dfd58192a12ac4bc
+  data.tar.gz: e36f7f055fc52af917e2b146653879172a840af29e16665a650c6331092a18a7
 SHA512:
-  metadata.gz: 401eb14e4e732e5ac3bd1d249372234b0d134277ad934e1cf38968a121824004266acf00ec71699ef3325288a28346fa42254735480207bc3d3a1c901b4b49d9
-  data.tar.gz: 21679ec808b05ff0c052fe419799e47a44b6587b66119cc43d2092c969f0634f52ee8f34c2a8a93eb5300e50c2c7e258cb3d8a4d073898b86ca07d4f1070839b
+  metadata.gz: de3f06d82c4dedc97d34e3082a2f1aaf13323b9fb15ed0bc68d126fa4f63890234206e5fc52528e27332937d9330fc70440b687cc91a7facfe6f8a7b04271836
+  data.tar.gz: 26c4eeb0617420bd283841c0bd4bd77a3516eef5287e59a7388591bc6f8538838c7abba67ccc20fc4a32db5662daa8c168954767eb158a96a4cfcc626ed36310

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,6 +137,8 @@ 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)
@@ -317,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>
@@ -335,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
@@ -979,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>

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

@@ -73,7 +73,7 @@ module CKEditor5::Rails
       type ||= preset.type
 
       # Add some fallbacks
-      config[:licenseKey] ||= context[:license_key]
+      config[:licenseKey] ||= context[:license_key] || preset.license_key
       config[:language] = { ui: language } if language
 
       editor_props = Editor::Props.new(

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,9 +3,7 @@
 require 'rails/engine'
 
 require_relative 'presets/manager'
-require_relative 'plugins/simple_upload_adapter'
-require_relative 'plugins/wproofreader'
-require_relative 'plugins/special_characters_bootstrap'
+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, max_version: '44.4.0')
+      compress!
+    end
+  end
+end

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

@@ -1,6 +1,5 @@
 # frozen_string_literal: true
 
-require_relative '../editor/props_external_plugin'
 require_relative '../editor/props_inline_plugin'
 
 module CKEditor5::Rails::Plugins

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 !@version || plugin.applicable_for_version?(@version)
+
+          register_plugin(plugin)
+        end
+
         # Register a single plugin by name
         #
         # @param name [Symbol, Editor::PropsBasePlugin] Plugin name or instance
@@ -109,8 +127,10 @@ module CKEditor5::Rails
         # Check if the plugin looks like an inline plugin
         # @param plugin [Editor::PropsBasePlugin] Plugin instance
         # @return [Boolean] True if the plugin is an inline plugin
-        def looks_like_inline_plugin?(plugin)
-          plugin.respond_to?(:code) && plugin.code.present?
+        def looks_like_unsafe_inline_plugin?(plugin)
+          plugin.respond_to?(:code) &&
+            plugin.code.present? &&
+            !plugin.is_a?(CKEditor5::Rails::Editor::PropsPatchPlugin)
         end
 
         # Register a plugin in the editor configuration.
@@ -122,7 +142,7 @@ module CKEditor5::Rails
         # @param plugin_obj [Editor::PropsBasePlugin] Plugin instance to register
         # @return [Editor::PropsBasePlugin] The registered plugin
         def register_plugin(plugin_obj)
-          if disallow_inline_plugins && looks_like_inline_plugin?(plugin_obj)
+          if disallow_inline_plugins && looks_like_unsafe_inline_plugin?(plugin_obj)
             raise DisallowedInlinePluginError, 'Inline plugins are not allowed here.'
           end
 

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

@@ -172,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
@@ -185,6 +190,17 @@ module CKEditor5::Rails
         else
           @version = Semver.new(version)
         end
+
+        # If there is no license key set, and the version if newer than 44.0.0, switch to GPL
+        # as the license key is now required in all versions
+        gpl if license_key.nil? && @version.major >= 44
+        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

data/lib/ckeditor5/rails/semver.rb

@@ -10,6 +10,13 @@ module CKEditor5
       include Comparable
 
       def initialize(version_string)
+        if version_string.is_a?(Semver)
+          @major = version_string.major
+          @minor = version_string.minor
+          @patch = version_string.patch
+          return
+        end
+
         validate!(version_string)
         @major, @minor, @patch = version_string.split('.').map(&:to_i)
       end

data/lib/ckeditor5/rails/version.rb

@@ -2,7 +2,7 @@
 
 module CKEditor5
   module Rails
-    VERSION = '1.25.0'
+    VERSION = '1.26.1'
 
     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/helpers/editor_helpers_spec.rb

@@ -24,6 +24,7 @@ RSpec.describe CKEditor5::Rails::Editor::Helpers::Editor do
     allow(preset).to receive(:config).and_return({})
     allow(preset).to receive(:automatic_upgrades?).and_return(false)
     allow(preset).to receive(:editable_height).and_return(nil)
+    allow(preset).to receive(:license_key).and_return(nil)
   end
 
   before do
@@ -225,6 +226,18 @@ RSpec.describe CKEditor5::Rails::Editor::Helpers::Editor do
         expect(helper.ckeditor5_editor(editable_height: 600)).to include('editable-height="600px"')
       end
     end
+
+    context 'when using license key' do
+      it 'uses license key from preset when no other license key is provided' do
+        custom_context = { preset: :default, bundle: 'custom-bundle' }
+        allow(helper).to receive(:ckeditor5_context_or_fallback).and_return(custom_context)
+
+        allow(preset).to receive(:license_key).and_return('preset-license-key')
+
+        result = helper.ckeditor5_editor
+        expect(result).to include('preset-license-key')
+      end
+    end
   end
 
   describe '#ckeditor5_editable' do

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

@@ -0,0 +1,157 @@
+# 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 true when version is equal to min constraint' do
+      result = described_class.applicable_for_version?(
+        '29.0.0',
+        min_version: '29.0.0'
+      )
+      expect(result).to be true
+    end
+
+    it 'returns true when version is equal to max constraint' do
+      result = described_class.applicable_for_version?(
+        '30.0.0',
+        max_version: '30.0.0'
+      )
+      expect(result).to be true
+    end
+
+    it 'returns true when version is higher than min constraint (patch)' do
+      result = described_class.applicable_for_version?(
+        '29.0.1',
+        min_version: '29.0.0'
+      )
+      expect(result).to be true
+    end
+
+    it 'returns true when version is higher than min constraint (minor)' do
+      result = described_class.applicable_for_version?(
+        '29.1.0',
+        min_version: '29.0.0'
+      )
+      expect(result).to be true
+    end
+
+    it 'returns true when version is higher than min constraint (major)' do
+      result = described_class.applicable_for_version?(
+        '30.0.0',
+        min_version: '29.0.0'
+      )
+      expect(result).to be true
+    end
+
+    it 'returns false when version is not equal to max constraint (patch)' do
+      result = described_class.applicable_for_version?(
+        '30.0.1',
+        max_version: '30.0.0'
+      )
+      expect(result).to be false
+    end
+
+    it 'returns false when version is not equal to min constraint (minor)' do
+      result = described_class.applicable_for_version?(
+        '29.1.0',
+        max_version: '29.0.0'
+      )
+      expect(result).to be false
+    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
+    context 'with both version constraints' 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
+
+    context 'with only min_version constraint' do
+      let(:plugin) do
+        described_class.new(plugin_name, plugin_code, min_version: '29.0.0')
+      end
+
+      it 'returns true for version above min_version' do
+        expect(plugin.applicable_for_version?('30.0.0')).to be true
+      end
+
+      it 'returns false for version below min_version' do
+        expect(plugin.applicable_for_version?('28.9.9')).to be false
+      end
+    end
+
+    context 'with only max_version constraint' do
+      let(:plugin) do
+        described_class.new(plugin_name, plugin_code, max_version: '30.0.0')
+      end
+
+      it 'returns true for version below max_version' do
+        expect(plugin.applicable_for_version?('29.0.0')).to be true
+      end
+
+      it 'returns false for version above max_version' do
+        expect(plugin.applicable_for_version?('30.0.1')).to be false
+      end
+    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

@@ -31,6 +31,34 @@ RSpec.describe CKEditor5::Rails::Presets::PresetBuilder do
     end
   end
 
+  describe '#version' do
+    it 'sets version' do
+      builder.version '35.0.0'
+      expect(builder.version).to eq('35.0.0')
+    end
+
+    context 'with version >= 44.0.0' do
+      it 'sets GPL license when no license key is set' do
+        builder.version('44.0.0')
+        expect(builder.license_key).to eq('GPL')
+        expect(builder.premium?).to be false
+      end
+
+      it 'does not change license when license key is already set' do
+        builder.license_key('commercial-key')
+        builder.version('44.0.0')
+        expect(builder.license_key).to eq('commercial-key')
+      end
+    end
+
+    context 'with version < 44.0.0' do
+      it 'does not set GPL license automatically' do
+        builder.version('43.0.0')
+        expect(builder.license_key).to be_nil
+      end
+    end
+  end
+
   describe '#initialize_copy' do
     let(:original) do
       described_class.new do
@@ -520,6 +548,10 @@ RSpec.describe CKEditor5::Rails::Presets::PresetBuilder do
   end
 
   describe '#special_characters' do
+    it 'should not crash if block is not provided' do
+      expect { builder.special_characters }.not_to raise_error
+    end
+
     it 'configures special characters with groups and items' do # rubocop:disable Metrics/BlockLength
       builder.special_characters do
         group 'Emoji', label: 'Emoticons' do
@@ -542,36 +574,38 @@ RSpec.describe CKEditor5::Rails::Presets::PresetBuilder do
         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: []
-                                                                })
+      data = {
+        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: []
+      }
+
+      expect(builder.config[:specialCharactersBootstrap]).to eq(data)
 
       plugin_names = builder.config[:plugins].map(&:name)
       expect(plugin_names).to include(:SpecialCharacters)
@@ -593,4 +627,70 @@ RSpec.describe CKEditor5::Rails::Presets::PresetBuilder do
       )
     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/semver_spec.rb

@@ -8,6 +8,15 @@ RSpec.describe CKEditor5::Rails::Semver do
       it 'accepts version in x.y.z format' do
         expect { described_class.new('1.2.3') }.not_to raise_error
       end
+
+      it 'accepts Semver object' do
+        original = described_class.new('1.2.3')
+        copied = described_class.new(original)
+
+        expect(copied.major).to eq(1)
+        expect(copied.minor).to eq(2)
+        expect(copied.patch).to eq(3)
+      end
     end
 
     context 'with invalid version' do

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ckeditor5
 version: !ruby/object:Gem::Version
-  version: 1.25.0
+  version: 1.26.1
 platform: ruby
 authors:
 - Mateusz Bagiński
@@ -9,7 +9,7 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-02-05 00:00:00.000000000 Z
+date: 2025-02-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -82,12 +82,15 @@ 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
@@ -125,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
@@ -194,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