ckeditor5 1.16.1 → 1.16.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 95f068ef75561d88a26a68c5aafa6e6f86b55405984e83bf35909085f288f9ba
-  data.tar.gz: d72e733641c5ac8c4f9d1e20731d54ffd2c0e4d88bc3b82618eb62b8c2820049
+  metadata.gz: 80773f82ac9fcdf35feac2e568206c4dd5dbd04240ae891b880549fc7192ef12
+  data.tar.gz: d4c4244344977827288691f7846bce8737c70d9df170aff1fa2fb52a3a400d1a
 SHA512:
-  metadata.gz: 31fb63fa1ac20061e1c28150178b7b8f92ca54e99073f2e180a7823d7f76f58c75a9f55e70b9a6f729d9715389b1a349305027e6d6c0c56bb2f7539d1a6bc0ad
-  data.tar.gz: 4019ffcc8e326be64930092815d5ff68436e4c242a67853adf735b4667aa7bec624df66fe9614d0f7e4bb00c67c2c0cf0e1195c43647d397b9f99ab8a0637479
+  metadata.gz: 2b681fd82436a62b4da89064979c02f4952ba1c210473b3d00791fe34627555e6df6761c4fb9cdbd49ea3258a3ce508c7c2c013ae4dccb56eb452848f936024a
+  data.tar.gz: 1c2170807abc784d8905b6817a8b1fb03c08d1f8ce3be48403923b96c255232c7acea65bacd417922e0014e5b18f7eb58dd6702837d0fc7bca3df936bee9774d

data/README.md

@@ -82,26 +82,26 @@ end
 
 Voilà! You have CKEditor 5 integrated with your Rails application. 🎉
 
-## Try Our Demos! 🎮 ✨
+## Try Demos! 🎮 ✨
 
-Want to see some cool examples? We've got you covered! Check out our interactive [demo application](https://github.com/Mati365/ckeditor5-rails/tree/main/sandbox/app/views/demos) packed with various editor configurations. You can also explore official CKEditor 5 [examples](https://ckeditor.com/docs/ckeditor5/latest/examples/builds/classic-editor.html) for more inspiration! 💡
+Explore various editor configurations with the interactive [demo application](https://github.com/Mati365/ckeditor5-rails/tree/main/sandbox/app/views/demos). For additional inspiration, visit the official CKEditor 5 [examples](https://ckeditor.com/docs/ckeditor5/latest/examples/builds/classic-editor.html).
 
-Ready to play with the demos locally? It's super easy! Just follow these steps: 🚀
+To run the demos locally, follow these steps:
 
 ```bash
-bundle install # Install all the goodies 📦
-bundle exec guard -g rails # Fire up the server 🔥
+bundle install # Install dependencies
+bundle exec guard -g rails # Start the server
 ```
 
-Now the fun part - open [http://localhost:3000/](http://localhost:3000/) in your browser and start experimenting! 🎯 Feel free to tweak the code and make it your own! 🎨
+Open [http://localhost:3000/](http://localhost:3000/) in a browser to start experimenting. Modify the code as needed.
 
-Want to extend CKEditor's functionality? Check out our [plugins directory](https://github.com/Mati365/ckeditor5-rails/tree/main/lib/ckeditor5/rails/plugins) and create your own awesome plugins! 🔌 We love community contributions - your plugin could be the next great addition to our ecosystem! ⭐
+For extending CKEditor's functionality, refer to the [plugins directory](https://github.com/Mati365/ckeditor5-rails/tree/main/lib/ckeditor5/rails/plugins) to create custom plugins. Community contributions are welcome.
 
 ## Table of Contents 📚
 
 - [CKEditor 5 Rails Integration ✨](#ckeditor-5-rails-integration-)
   - [Installation 🛠️](#installation-️)
-  - [Try Our Demos! 🎮 ✨](#try-our-demos--)
+  - [Try Demos! 🎮 ✨](#try-demos--)
   - [Table of Contents 📚](#table-of-contents-)
   - [Presets 🎨](#presets-)
     - [Automatic upgrades 🔄](#automatic-upgrades-)
@@ -628,7 +628,7 @@ end
 
 #### `inline_plugin(name, code)` method
 
-Use with caution as this is an inline definition of the plugin code, and you can define a custom class or function for the plugin here. The example below shows how to define a custom plugin that highlights the text:
+⚠️ **Warning:** Use with caution as this is an inline definition of the plugin code, and it can potentially cause XSS vulnerabilities. Only use this method with static, trusted JavaScript code. The example below shows how to define a custom plugin that highlights the text:
 
 ```rb
 # config/initializers/ckeditor5.rb
@@ -645,6 +645,8 @@ CKEditor5::Rails.configure do
       }
 
       init() {
+        const config = this.editor.config.get('myCustomPlugin') || {};
+
         // ... Your plugin code
       }
     }
@@ -652,6 +654,23 @@ CKEditor5::Rails.configure do
 end
 ```
 
+To configure the custom plugin, use the `configure` method in your initializer. The example below shows how to configure the `myCustomPlugin`:
+
+```rb
+# config/initializers/ckeditor5.rb
+
+CKEditor5::Rails.configure do
+  # ... other configuration
+
+  configure :myCustomPlugin, {
+    option1: 'value1',
+    option2: 'value2'
+  }
+end
+```
+
+This approach is resistant to XSS attacks as it avoids inline JavaScript.
+
 #### `simple_upload_adapter(url)` method
 
 Defines the URL for the simple upload adapter. The default endpoint is `/uploads` and the method is `POST`. The example below shows how to set the URL to `/uploads`:
@@ -1129,16 +1148,18 @@ Format of the `ckeditor5_context` helper:
 ```erb
 <!-- app/views/demos/index.html.erb -->
 
-<%= ckeditor5_context config: { ... }, plugins: [ ... ] do %>
+<%= ckeditor5_context @context_preset do %>
   <%= ckeditor5_editor %>
   <%= ckeditor5_editor %>
 <% end %>
 ```
 
-The `ckeditor5_context` helper takes the `config` and `plugins` keyword arguments. The `config` keyword argument allows you to define the shared configuration of the editor instances, while the `plugins` keyword argument allows you to define the shared plugins. Format of these arguments is the same as in the `ckeditor5_editor` helper.
+The `ckeditor5_context` helper takes the context preset as an argument and renders the editor instances within the context. The context preset defines the shared configuration and state of the editor instances. It should be defined somewhere in controller.
 
 ### Example usage of `ckeditor5_context` helper 📝
 
+In your view:
+
 ```erb
 <!-- app/views/demos/index.html.erb -->
 
@@ -1146,7 +1167,7 @@ The `ckeditor5_context` helper takes the `config` and `plugins` keyword argument
   <%= ckeditor5_assets preset: :ultrabasic %>
 <% end %>
 
-<%= ckeditor5_context do %>
+<%= ckeditor5_context @context_preset do %>
   <%= ckeditor5_editor initial_data: 'Hello World' %>
 
   <br>
@@ -1155,6 +1176,39 @@ The `ckeditor5_context` helper takes the `config` and `plugins` keyword argument
 <% end %>
 ```
 
+In your controller:
+
+```rb
+# app/controllers/demos_controller.rb
+
+class DemosController < ApplicationController
+  def index
+    @context_preset = ckeditor5_context_preset do
+      # Syntax is identical to the `toolbar` method of the preset configuration.
+      toolbar :bold, :italic
+
+      # It's possible to define plugins. Syntax is identical to the `plugins` method of the preset configuration.
+      # Example:
+      # plugin :Bold
+      # inline_plugin :MyCustomPlugin, '...'
+    end
+  end
+end
+```
+
+It's possible to omit the preset argument, in that case the empty preset will be used.
+
+```erb
+<!-- app/views/demos/index.html.erb -->
+
+<%= ckeditor5_context do %>
+  <%= ckeditor5_editor %>
+  <%= ckeditor5_editor %>
+<% end %>
+```
+
+See demo for more details.
+
 ## How to access editor instance? 🤔
 
 You can access the editor instance using plain HTML and JavaScript, as CKEditor 5 is a web component with defined `instance`, `instancePromise` and `editables` properties.

data/lib/ckeditor5/rails/assets/assets_bundle.rb

@@ -38,7 +38,7 @@ module CKEditor5::Rails::Assets
     end
   end
 
-  class JSExportsMeta
+  class JSUrlImportMeta
     attr_reader :url, :import_meta
 
     delegate :esm?, :window?, :import_name, :window_name, :import_as, :to_h, to: :import_meta

data/lib/ckeditor5/rails/cdn/ckbox_bundle.rb

@@ -20,11 +20,11 @@ module CKEditor5::Rails
 
       def scripts
         @scripts ||= [
-          Assets::JSExportsMeta.new(
+          Assets::JSUrlImportMeta.new(
             create_cdn_url('ckbox', version, 'ckbox.js'),
             window_name: 'CKBox'
           ),
-          *translations_js_exports_meta
+          *translations_js_url_imports
         ]
       end
 
@@ -46,11 +46,11 @@ module CKEditor5::Rails
               'theme must be a string or symbol'
       end
 
-      def translations_js_exports_meta
+      def translations_js_url_imports
         translations.map do |lang|
           url = create_cdn_url('ckbox', version, "translations/#{lang}.js")
 
-          Assets::JSExportsMeta.new(url, window_name: 'CKBOX_TRANSLATIONS', translation: true)
+          Assets::JSUrlImportMeta.new(url, window_name: 'CKBOX_TRANSLATIONS', translation: true)
         end
       end
     end

data/lib/ckeditor5/rails/cdn/ckeditor_bundle.rb

@@ -22,8 +22,8 @@ module CKEditor5::Rails
 
       def scripts
         @scripts ||= [
-          js_exports_meta,
-          *translations_js_exports_meta
+          js_url_imports,
+          *translations_js_url_imports
         ]
       end
 
@@ -35,18 +35,18 @@ module CKEditor5::Rails
 
       private
 
-      def js_exports_meta
-        Assets::JSExportsMeta.new(
+      def js_url_imports
+        Assets::JSUrlImportMeta.new(
           create_cdn_url(import_name, version, "#{import_name}.js"),
           import_name: import_name
         )
       end
 
-      def translations_js_exports_meta
+      def translations_js_url_imports
         translations.map do |lang|
           url = create_cdn_url(import_name, version, "translations/#{lang}.js")
 
-          Assets::JSExportsMeta.new(
+          Assets::JSUrlImportMeta.new(
             url,
             import_name: "#{import_name}/translations/#{lang}.js",
             translation: true

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

@@ -1,13 +1,19 @@
 # frozen_string_literal: true
 
-require_relative 'props'
+require_relative 'preset_builder'
+require_relative 'preset_serializer'
 
 module CKEditor5::Rails::Context
   module Helpers
-    def ckeditor5_context(**config, &block)
-      context_props = Props.new(config)
+    def ckeditor5_context(preset = nil, &block)
+      preset ||= PresetBuilder.new
+      context_props = PresetSerializer.new(preset)
 
       tag.public_send(:'ckeditor-context-component', **context_props.to_attributes, &block)
     end
+
+    def ckeditor5_context_preset(&block)
+      PresetBuilder.new(&block)
+    end
   end
 end

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

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+require_relative '../presets/concerns/configuration_methods'
+require_relative '../presets/concerns/plugin_methods'
+
+module CKEditor5::Rails
+  module Context
+    class PresetBuilder
+      include Presets::Concerns::ConfigurationMethods
+      include Presets::Concerns::PluginMethods
+
+      def initialize(&block)
+        @config = {
+          plugins: []
+        }
+
+        instance_eval(&block) if block_given?
+      end
+
+      def initialize_copy(source)
+        super
+
+        @config = {
+          plugins: source.config[:plugins].map(&:dup)
+        }.merge(
+          source.config.except(:plugins).deep_dup
+        )
+      end
+    end
+  end
+end

data/lib/ckeditor5/rails/context/{props.rb → preset_serializer.rb}

@@ -2,9 +2,9 @@
 
 module CKEditor5::Rails
   module Context
-    class Props
-      def initialize(config)
-        @config = config
+    class PresetSerializer
+      def initialize(preset)
+        @preset = preset
       end
 
       def to_attributes
@@ -16,7 +16,7 @@ module CKEditor5::Rails
 
       private
 
-      attr_reader :config
+      delegate :config, to: :@preset
 
       def serialize_plugins
         (config[:plugins] || []).map { |plugin| Editor::PropsPlugin.normalize(plugin).to_h }.to_json

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

@@ -2,7 +2,7 @@
 
 module CKEditor5::Rails::Plugins
   class SimpleUploadAdapter < CKEditor5::Rails::Editor::PropsInlinePlugin
-    PLUGIN_CODE = <<~JAVASCRIPT
+    PLUGIN_CODE = <<~JS
       import { Plugin, FileRepository } from 'ckeditor5';
 
       export default class SimpleUploadAdapter extends Plugin {
@@ -78,7 +78,7 @@ module CKEditor5::Rails::Plugins
           });
         }
       }
-    JAVASCRIPT
+    JS
 
     def initialize
       super(:SimpleUploadAdapter, PLUGIN_CODE)

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

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+require 'active_support'
+
+module CKEditor5::Rails
+  module Presets
+    module Concerns
+      module ConfigurationMethods
+        extend ActiveSupport::Concern
+
+        included do
+          attr_reader :config
+        end
+
+        def configure(key, value)
+          config[key] = value
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module CKEditor5::Rails
+  module Presets
+    module Concerns
+      module PluginMethods
+        def inline_plugin(name, code)
+          config[:plugins] << Editor::PropsInlinePlugin.new(name, code)
+        end
+
+        def plugin(name, **kwargs)
+          plugin_obj = PluginsBuilder.create_plugin(name, **kwargs)
+          config[:plugins] << plugin_obj
+          plugin_obj
+        end
+
+        def plugins(*names, **kwargs, &block)
+          config[:plugins] ||= []
+
+          names.each { |name| plugin(name, **kwargs) } unless names.empty?
+
+          builder = PluginsBuilder.new(config[:plugins])
+          builder.instance_eval(&block) if block_given?
+          builder
+        end
+      end
+    end
+  end
+end

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

@@ -1,11 +1,14 @@
 # frozen_string_literal: true
 
+require_relative 'concerns/configuration_methods'
+require_relative 'concerns/plugin_methods'
+
 module CKEditor5::Rails
   module Presets
     class PresetBuilder
       include Editor::Helpers::Config
-
-      attr_reader :config
+      include Concerns::ConfigurationMethods
+      include Concerns::PluginMethods
 
       def initialize(&block)
         @version = nil
@@ -46,10 +49,6 @@ module CKEditor5::Rails
         license_key == 'GPL'
       end
 
-      def menubar?
-        @config.dig(:menuBar, :isVisible) || false
-      end
-
       def to_h_with_overrides(**overrides)
         {
           version: overrides.fetch(:version, version),
@@ -144,16 +143,16 @@ module CKEditor5::Rails
         @type = type
       end
 
-      def configure(key, value)
-        @config[key] = value
-      end
-
       def menubar(visible: true)
-        @config[:menuBar] = {
+        config[:menuBar] = {
           isVisible: visible
         }
       end
 
+      def menubar?
+        config.dig(:menuBar, :isVisible) || false
+      end
+
       def toolbar(*items, should_group_when_full: true, &block)
         if @config[:toolbar].blank? || !items.empty?
           @config[:toolbar] = {
@@ -167,30 +166,10 @@ module CKEditor5::Rails
         builder
       end
 
-      def inline_plugin(name, code)
-        @config[:plugins] << Editor::PropsInlinePlugin.new(name, code)
-      end
-
-      def plugin(name, **kwargs)
-        plugin_obj = PluginsBuilder.create_plugin(name, **kwargs)
-        @config[:plugins] << plugin_obj
-        plugin_obj
-      end
-
-      def plugins(*names, **kwargs, &block)
-        @config[:plugins] ||= []
-
-        names.each { |name| plugin(name, **kwargs) } unless names.empty?
-
-        builder = PluginsBuilder.new(@config[:plugins])
-        builder.instance_eval(&block) if block_given?
-        builder
-      end
-
       def language(ui = nil, content: ui) # rubocop:disable Naming/MethodParameterName
-        return @config[:language] if ui.nil?
+        return config[:language] if ui.nil?
 
-        @config[:language] = {
+        config[:language] = {
           ui: ui,
           content: content
         }

data/lib/ckeditor5/rails/version.rb

@@ -2,7 +2,7 @@
 
 module CKEditor5
   module Rails
-    VERSION = '1.16.1'
+    VERSION = '1.16.2'
 
     DEFAULT_CKEDITOR_VERSION = '43.3.1'
   end

data/spec/e2e/features/context_spec.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+require 'e2e/spec_helper'
+
+RSpec.describe 'CKEditor5 Context Integration', type: :feature, js: true do
+  before { visit 'context' }
+
+  it 'initializes context with multiple editors' do
+    expect(page).to have_css('.ck-editor__editable', count: 2, wait: 10)
+  end
+
+  it 'initializes the magic context plugin' do
+    eventually do
+      plugin_exists = page.evaluate_script('window.MagicContextPlugin !== undefined')
+      expect(plugin_exists).to be true
+    end
+  end
+
+  it 'allows editing content in context editors' do
+    editors = all('.ck-editor__editable')
+
+    # Test first editor
+    editors[0].click
+    editors[0].send_keys([[:control, 'a'], :backspace])
+    editors[0].send_keys('Modified Context Item 1')
+
+    # Test second editor
+    editors[1].click
+    editors[1].send_keys([[:control, 'a'], :backspace])
+    editors[1].send_keys('Modified Context Item 2')
+
+    # Verify content
+    expect(editors[0].text).to eq('Modified Context Item 1')
+    expect(editors[1].text).to eq('Modified Context Item 2')
+  end
+end

data/spec/lib/ckeditor5/rails/assets/asset_bundle_hml_serializer_spec.rb

@@ -19,11 +19,11 @@ RSpec.describe CKEditor5::Rails::Assets::AssetsBundleHtmlSerializer do
 
   let(:scripts) do
     [
-      CKEditor5::Rails::Assets::JSExportsMeta.new(
+      CKEditor5::Rails::Assets::JSUrlImportMeta.new(
         'https://cdn.com/script1.js',
         window_name: 'CKEditor5'
       ),
-      CKEditor5::Rails::Assets::JSExportsMeta.new(
+      CKEditor5::Rails::Assets::JSUrlImportMeta.new(
         'https://cdn.com/script2.js',
         import_name: '@ckeditor/script2'
       )

data/spec/lib/ckeditor5/rails/assets/assets_bundle_spec.rb

@@ -35,8 +35,10 @@ RSpec.describe CKEditor5::Rails::Assets::AssetsBundle do
 
   describe '#translations_scripts' do
     let(:bundle) { concrete_class.new }
-    let(:translation_script) { instance_double(CKEditor5::Rails::Assets::JSExportsMeta, translation?: true) }
-    let(:regular_script) { instance_double(CKEditor5::Rails::Assets::JSExportsMeta, translation?: false) }
+    let(:translation_script) do
+      instance_double(CKEditor5::Rails::Assets::JSUrlImportMeta, translation?: true)
+    end
+    let(:regular_script) { instance_double(CKEditor5::Rails::Assets::JSUrlImportMeta, translation?: false) }
 
     before do
       allow(bundle).to receive(:scripts).and_return([translation_script, regular_script])
@@ -48,8 +50,8 @@ RSpec.describe CKEditor5::Rails::Assets::AssetsBundle do
   end
 
   describe '#<<' do
-    let(:script1) { instance_double(CKEditor5::Rails::Assets::JSExportsMeta) }
-    let(:script2) { instance_double(CKEditor5::Rails::Assets::JSExportsMeta) }
+    let(:script1) { instance_double(CKEditor5::Rails::Assets::JSUrlImportMeta) }
+    let(:script2) { instance_double(CKEditor5::Rails::Assets::JSUrlImportMeta) }
     let(:stylesheet1) { '/path/to/style1.css' }
     let(:stylesheet2) { '/path/to/style2.css' }
 
@@ -101,8 +103,8 @@ RSpec.describe CKEditor5::Rails::Assets::AssetsBundle do
   end
 
   describe '#preloads' do
-    let(:script1) { instance_double(CKEditor5::Rails::Assets::JSExportsMeta, url: '/js/script1.js') }
-    let(:script2) { instance_double(CKEditor5::Rails::Assets::JSExportsMeta, url: '/js/script2.js') }
+    let(:script1) { instance_double(CKEditor5::Rails::Assets::JSUrlImportMeta, url: '/js/script1.js') }
+    let(:script2) { instance_double(CKEditor5::Rails::Assets::JSUrlImportMeta, url: '/js/script2.js') }
     let(:stylesheet1) { '/css/style1.css' }
     let(:stylesheet2) { '/css/style2.css' }
 
@@ -136,7 +138,7 @@ RSpec.describe CKEditor5::Rails::Assets::AssetsBundle do
   end
 end
 
-RSpec.describe CKEditor5::Rails::Assets::JSExportsMeta do
+RSpec.describe CKEditor5::Rails::Assets::JSUrlImportMeta do
   let(:url) { '/path/to/script.js' }
 
   describe '#initialize' do

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

@@ -36,7 +36,7 @@ RSpec.describe CKEditor5::Rails::Cdn::CKBoxBundle do
 
   describe '#scripts' do
     it 'returns array with main script' do
-      expect(bundle.scripts.first).to be_a(CKEditor5::Rails::Assets::JSExportsMeta)
+      expect(bundle.scripts.first).to be_a(CKEditor5::Rails::Assets::JSUrlImportMeta)
       expect(bundle.scripts.first.url).to include('ckbox.js')
       expect(bundle.scripts.first.window_name).to eq('CKBox')
     end

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

@@ -14,7 +14,28 @@ RSpec.describe CKEditor5::Rails::Context::Helpers do
   let(:helper) { test_class.new }
 
   describe '#ckeditor5_context' do
-    it 'creates context component with default attributes' do
+    let(:empty_preset) { CKEditor5::Rails::Context::PresetBuilder.new }
+
+    let(:custom_preset) do
+      CKEditor5::Rails::Context::PresetBuilder.new do
+        configure :preset, :custom
+      end
+    end
+
+    let(:cdn_preset) do
+      CKEditor5::Rails::Context::PresetBuilder.new do
+        configure :cdn, :jsdelivr
+      end
+    end
+
+    let(:complex_preset) do
+      CKEditor5::Rails::Context::PresetBuilder.new do
+        configure :preset, :custom
+        configure :cdn, :jsdelivr
+      end
+    end
+
+    it 'is optional to pass a preset' do
       expect(helper.ckeditor5_context).to have_tag(
         'ckeditor-context-component',
         with: {
@@ -24,8 +45,18 @@ RSpec.describe CKEditor5::Rails::Context::Helpers do
       )
     end
 
+    it 'creates context component with default attributes' do
+      expect(helper.ckeditor5_context(empty_preset)).to have_tag(
+        'ckeditor-context-component',
+        with: {
+          plugins: '[]',
+          config: '{}'
+        }
+      )
+    end
+
     it 'creates context component with preset configuration' do
-      expect(helper.ckeditor5_context(preset: :custom)).to have_tag(
+      expect(helper.ckeditor5_context(custom_preset)).to have_tag(
         'ckeditor-context-component',
         with: {
           plugins: '[]',
@@ -35,7 +66,7 @@ RSpec.describe CKEditor5::Rails::Context::Helpers do
     end
 
     it 'creates context component with cdn configuration' do
-      expect(helper.ckeditor5_context(cdn: :jsdelivr)).to have_tag(
+      expect(helper.ckeditor5_context(cdn_preset)).to have_tag(
         'ckeditor-context-component',
         with: {
           plugins: '[]',
@@ -45,7 +76,7 @@ RSpec.describe CKEditor5::Rails::Context::Helpers do
     end
 
     it 'creates context component with multiple configurations' do
-      result = helper.ckeditor5_context(preset: :custom, cdn: :jsdelivr)
+      result = helper.ckeditor5_context(complex_preset)
 
       expect(result).to have_tag(
         'ckeditor-context-component',
@@ -57,11 +88,24 @@ RSpec.describe CKEditor5::Rails::Context::Helpers do
     end
 
     it 'accepts block content' do
-      result = helper.ckeditor5_context { 'Content' }
+      result = helper.ckeditor5_context(empty_preset) { 'Content' }
 
       expect(result).to have_tag('ckeditor-context-component') do
         with_text 'Content'
       end
     end
   end
+
+  describe '#ckeditor5_context_preset' do
+    it 'creates a new preset builder' do
+      preset = helper.ckeditor5_context_preset do
+        configure :preset, :custom
+      end
+
+      expect(preset.config).to eq(
+        plugins: [],
+        preset: :custom
+      )
+    end
+  end
 end

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

@@ -0,0 +1,85 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+RSpec.describe CKEditor5::Rails::Context::PresetBuilder do
+  subject(:builder) { described_class.new }
+
+  describe '#initialize' do
+    it 'creates empty config with plugins array' do
+      expect(builder.config).to eq({ plugins: [] })
+    end
+
+    it 'accepts configuration block' do
+      builder = described_class.new do
+        configure :language, 'en'
+      end
+
+      expect(builder.config[:language]).to eq('en')
+    end
+  end
+
+  describe '#initialize_copy' do
+    let(:original) do
+      described_class.new do
+        configure :language, 'en'
+        plugin 'Test'
+      end
+    end
+
+    it 'creates deep copy of config' do
+      copy = original.dup
+
+      expect(copy.config).not_to be(original.config)
+      expect(copy.config[:plugins]).not_to be(original.config[:plugins])
+      expect(copy.config[:plugins].first).not_to be(original.config[:plugins].first)
+    end
+  end
+
+  describe '#configure' do
+    it 'sets config value' do
+      builder.configure(:toolbar, { items: ['bold'] })
+      expect(builder.config[:toolbar]).to eq({ items: ['bold'] })
+    end
+  end
+
+  describe '#plugin' do
+    it 'adds normalized plugin to config' do
+      plugin = builder.plugin('Test')
+
+      expect(builder.config[:plugins]).to include(plugin)
+      expect(plugin).to be_a(CKEditor5::Rails::Editor::PropsPlugin)
+    end
+
+    it 'accepts plugin options' do
+      plugin = builder.plugin('Test', premium: true)
+
+      expect(plugin.js_import_meta[:import_name]).to eq('ckeditor5-premium-features')
+    end
+  end
+
+  describe '#plugins' do
+    it 'adds multiple plugins at once' do
+      builder.plugins('Test1', 'Test2')
+
+      expect(builder.config[:plugins].map(&:name)).to eq(%w[Test1 Test2])
+    end
+
+    it 'accepts block for complex configuration' do
+      builder.plugins do
+        append 'Test1'
+        append 'Test2', premium: true
+      end
+
+      expect(builder.config[:plugins].map(&:name)).to eq(%w[Test1 Test2])
+    end
+
+    it 'accepts both arguments and block' do
+      builder.plugins('Test1') do
+        append 'Test2'
+      end
+
+      expect(builder.config[:plugins].map(&:name)).to eq(%w[Test1 Test2])
+    end
+  end
+end

data/spec/lib/ckeditor5/rails/context/{props_spec.rb → preset_serializer_spec.rb}

@@ -2,28 +2,27 @@
 
 require 'spec_helper'
 
-RSpec.describe CKEditor5::Rails::Context::Props do
-  let(:config) do
-    {
-      plugins: [
-        CKEditor5::Rails::Editor::PropsPlugin.new('Plugin1', import_name: '@ckeditor/plugin1'),
-        CKEditor5::Rails::Editor::PropsInlinePlugin.new('plugin2', 'export default class Plugin2 {}')
-      ],
-      toolbar: { items: %w[bold italic] },
-      language: 'en'
-    }
+RSpec.describe CKEditor5::Rails::Context::PresetSerializer do
+  let(:preset) do
+    CKEditor5::Rails::Context::PresetBuilder.new do
+      plugin 'Plugin1', import_name: '@ckeditor/plugin1'
+      inline_plugin 'plugin2', 'export default class Plugin2 {}'
+
+      configure :toolbar, { items: %w[bold italic] }
+      configure :language, 'en'
+    end
   end
 
-  subject(:props) { described_class.new(config) }
+  subject(:serializer) { described_class.new(preset) }
 
   describe '#initialize' do
-    it 'accepts a config hash' do
-      expect { described_class.new({}) }.not_to raise_error
+    it 'accepts a preset instance' do
+      expect { described_class.new(preset) }.not_to raise_error
     end
   end
 
   describe '#to_attributes' do
-    subject(:attributes) { props.to_attributes }
+    subject(:attributes) { serializer.to_attributes }
 
     it 'returns a hash with plugins and config keys' do
       expect(attributes).to be_a(Hash)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ckeditor5
 version: !ruby/object:Gem::Version
-  version: 1.16.1
+  version: 1.16.2
 platform: ruby
 authors:
 - Mateusz Bagiński
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-11-22 00:00:00.000000000 Z
+date: 2024-11-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -56,7 +56,8 @@ files:
 - lib/ckeditor5/rails/cdn/helpers.rb
 - lib/ckeditor5/rails/cdn/url_generator.rb
 - lib/ckeditor5/rails/context/helpers.rb
-- lib/ckeditor5/rails/context/props.rb
+- lib/ckeditor5/rails/context/preset_builder.rb
+- lib/ckeditor5/rails/context/preset_serializer.rb
 - lib/ckeditor5/rails/editor/editable_height_normalizer.rb
 - lib/ckeditor5/rails/editor/helpers.rb
 - lib/ckeditor5/rails/editor/helpers/config_helpers.rb
@@ -69,6 +70,8 @@ files:
 - lib/ckeditor5/rails/hooks/form.rb
 - lib/ckeditor5/rails/hooks/simple_form.rb
 - lib/ckeditor5/rails/plugins/simple_upload_adapter.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
@@ -76,6 +79,7 @@ files:
 - lib/ckeditor5/rails/semver.rb
 - lib/ckeditor5/rails/version.rb
 - lib/ckeditor5/rails/version_detector.rb
+- spec/e2e/features/context_spec.rb
 - spec/e2e/features/editor_types_spec.rb
 - spec/e2e/features/form_integration_spec.rb
 - spec/e2e/spec_helper.rb
@@ -88,7 +92,8 @@ files:
 - spec/lib/ckeditor5/rails/cdn/helpers_spec.rb
 - spec/lib/ckeditor5/rails/cdn/url_generator_spec.rb
 - spec/lib/ckeditor5/rails/context/helpers_spec.rb
-- spec/lib/ckeditor5/rails/context/props_spec.rb
+- spec/lib/ckeditor5/rails/context/preset_builder_spec.rb
+- spec/lib/ckeditor5/rails/context/preset_serializer_spec.rb
 - spec/lib/ckeditor5/rails/editor/editable_height_normalizer_spec.rb
 - spec/lib/ckeditor5/rails/editor/helpers/config_helpers_spec.rb
 - spec/lib/ckeditor5/rails/editor/helpers/editor_helpers_spec.rb
@@ -131,6 +136,7 @@ signing_key:
 specification_version: 4
 summary: CKEditor 5 for Rails
 test_files:
+- spec/e2e/features/context_spec.rb
 - spec/e2e/features/editor_types_spec.rb
 - spec/e2e/features/form_integration_spec.rb
 - spec/e2e/spec_helper.rb
@@ -143,7 +149,8 @@ test_files:
 - spec/lib/ckeditor5/rails/cdn/helpers_spec.rb
 - spec/lib/ckeditor5/rails/cdn/url_generator_spec.rb
 - spec/lib/ckeditor5/rails/context/helpers_spec.rb
-- spec/lib/ckeditor5/rails/context/props_spec.rb
+- spec/lib/ckeditor5/rails/context/preset_builder_spec.rb
+- spec/lib/ckeditor5/rails/context/preset_serializer_spec.rb
 - spec/lib/ckeditor5/rails/editor/editable_height_normalizer_spec.rb
 - spec/lib/ckeditor5/rails/editor/helpers/config_helpers_spec.rb
 - spec/lib/ckeditor5/rails/editor/helpers/editor_helpers_spec.rb