cocooned 2.4.1 → 3.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a39782348816fe6d41942f786eb178890583e6a94980f99b726c19fa6c9eb4b5
-  data.tar.gz: 6837f2d09cecd7d6e3588a258308c784e9cddbb498b781a4c1692cced332c1a0
+  metadata.gz: 4452a44114a2a49166816f4966764b27cccf5de838568acb29fc68544fb96878
+  data.tar.gz: 7d28fe11d1d06bb28433be2587411471ce79db0983347de07acf40a2e62bc3d7
 SHA512:
-  metadata.gz: 0d54e9ea05d221bdbd8dfb6546236ccaaa9972f2dcbfa232b751b08ad7f6b6f0195579d526070f7264bea97d9f44878ab3427c6f345b6ac6f7b3657458e12a31
-  data.tar.gz: 354d3a47a177fe27d863e92119a46525d7526d5d656ea151dcf57194e00b0dd00f9e498a0c3fedff82a6c78bb5280ffb5f01a5e780e81c654425986406ea5d4a
+  metadata.gz: 8af0b42463b95aac1f4bf2c1f290a75735a1ebb304fe333f79124da55bb2f0d694c05e23292b3328accb0b70c596205b918a6912757f2e8dbddcd5101f6df4bc
+  data.tar.gz: e95c020441e9c26e4941d49ec7e202dc22af173b02af6bf2023a46260004dceee1e0ca9f352bed232a80b085c819a35f26d9994013a21a76ed65f669d2f4f471

data/CHANGELOG.md

@@ -6,6 +6,36 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 
 ## [Unreleased]
 
+## Version 3.0.0 (2026-01-27)
+
+## Breaking changes
+
+* Respect browser accessibility settings on reduced motion to determinate the default value of the `animate` option (#120)  
+  `animate` will be set to false by default if the `(prefers-reduced-motion: reduce)` media query matches.
+* Proper instances cleanup through [explicit resource management](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Resource_management) (#115)  
+  Introduce a `dispose` method on Cocooned instances to clean up what was done in the `start` method: remove event listeners and delete references to the disposed instance, so it can be cleanly garbage collected.
+  This may require you to install a polyfill for `DisposableStack` and `[Symbol.dispose]()` to support older browsers.
+
+To not introduce too many breaking changes in a single release, removal of long-time deprecated features have been postponed to Cocooned 4.0 (#122)
+
+## Added
+
+* Optional Stimulus integration (#119)
+  Introduce two ways to integrate Cocooned with Stimulus: `registerCocoonedContainer` and `useCocooned`. See documentation for details.
+
+### Changed
+
+* Add Ruby 4.0 to the test matrix (#112)
+
+## Version 2.5.0 (2025-10-23)
+
+* Upgrade to use `eslint ~> 9` (#103)
+* Configure dependabot to auto-update Github Actions (#99)
+* Drop support for Rails 7.1, Ruby 2.7 and Ruby 3.1 (#98)
+* Add Rails 8.1 to the test matrix (#96)
+* Remove Rails 7.0 from the test matrix (#92)
+* Add Ruby 3.4 to the test matrix (#88)
+
 ## Version 2.4.1 (2024-11-25)
 
 ### Changed

data/README.md

@@ -5,7 +5,7 @@
 
 Cocooned makes it easier to handle nested forms in Rails.
 
-Cocooned is form builder-agnostic: it works with standard Rails (>= 7.0, < 8.0) form helpers, [Formtastic](https://github.com/justinfrench/formtastic) or [SimpleForm](https://github.com/plataformatec/simple_form).
+Cocooned is form builder-agnostic: it works with standard Rails (>= 7.0, < 8.2) form helpers, [Formtastic](https://github.com/justinfrench/formtastic) or [SimpleForm](https://github.com/plataformatec/simple_form).
 
 1. [Background](#some-background)
 2. [Installation](#installation)
@@ -23,7 +23,7 @@ Cocooned is a fork of [Cocoon](https://github.com/nathanvda/cocoon) by [Nathan V
 
 However, the project seems to have only received minimal fixes since 2018 and many pull requests, even simple ones, have been on hold for a long time. In 2019, as I needed more than what Cocoon provided at this time, I had the choice to either maintain an extension or to fork it and integrate everything that was waiting and more.
 
-Over the time, Cocooned turned into an almost complete rewrite of Cocoon with more functionnalities, a more fluent API (I hope) and integration with modern toolchains. Still, **Cocooned is completely compatible with Cocoon and can be used as a drop-in replacement** as long as we talk about Ruby code. Change the name of the gem in your Gemfile and you're done. **This compatibility layer with the original Cocoon API will be dropped in the next major release.**
+Over the time, Cocooned turned into an almost complete rewrite of Cocoon with more functionnalities, a more fluent API (I hope) and integration with modern toolchains. Still, **Cocooned is compatible with Cocoon and can be used as a**(n almost) **drop-in replacement. This compatibility layer with the original Cocoon API will be dropped in the next major release.**
 
 On the JavaScript side, Cocooned 2.0 removed the dependency to jQuery (Yeah! :tada:). See [JavaScript](#javascript) for details.
 
@@ -40,15 +40,18 @@ gem 'cocooned'
 Cocooned comes with an NPM companion package: [`@notus.sh/cocooned`](https://www.npmjs.com/package/@notus.sh/cocooned).
 It bundles JavaScript files to handles in-browser interactions with your nested forms.
 
-If you use import maps (Rails 7.0+ default), add it with:
+Install it with your favorite package manager:
 
 ```shell
+# bun
+$ bun install @notus.sh/cocooned
+# importmap (Rails ~7.0 default)
 $ bin/importmap pin @notus.sh/cocooned
-```
-
-If you use Yarn and Webpack (Rails 5.1+ default), add it with:
-
-```shell
+# npm
+$ npm install @notus.sh/cocooned
+# pnpm
+$ pnpm add @notus.sh/cocooned
+# yarn
 $ yarn add @notus.sh/cocooned
 ```
 

data/app/assets/javascripts/cocoon.js

@@ -1,3 +1,3 @@
 //= require 'cocooned'
 
-/* TODO: Remove in 3.0 */
+/* TODO: Remove in 4.0 */

data/app/assets/javascripts/cocooned.js

@@ -36,6 +36,153 @@
     }
   }
 
+  class Traverser {
+    constructor (origin, traversal) {
+      this.#origin = origin;
+      this.#traversal = traversal;
+    }
+
+    resolve (selector) {
+      if (this.#traversal in this.#origin && typeof this.#origin[this.#traversal] === 'function') {
+        return this._tryMethod(this.#traversal, selector)
+      }
+
+      if (this.#traversal in this.#origin) {
+        return this._tryProperty(this.#traversal)
+      }
+
+      const method = `_${this.#traversal}`;
+      if (method in this) {
+        return this[method](selector)
+      }
+
+      return null
+    }
+
+    /* Protected and private attributes and methods */
+    #origin
+    #traversal
+
+    _tryMethod (method, selector) {
+      try {
+        const resolved = this.#origin[method](selector);
+        if (resolved instanceof HTMLElement) {
+          return resolved
+        }
+      } catch (e) {}
+
+      return null
+    }
+
+    _tryProperty (property) {
+      const resolved = this.#origin[property];
+      if (resolved instanceof HTMLElement) {
+        return resolved
+      }
+
+      return null
+    }
+
+    _parent (selector) {
+      if (this.#origin.parentElement.matches(selector)) {
+        return this.#origin.parentElement
+      }
+      return null
+    }
+
+    _prev (selector) {
+      if (this.#origin.previousElementSibling.matches(selector)) {
+        return this.#origin.previousElementSibling
+      }
+      return null
+    }
+
+    _next (selector) {
+      if (this.#origin.nextElementSibling.matches(selector)) {
+        return this.#origin.nextElementSibling
+      }
+      return null
+    }
+
+    _siblings (selector) {
+      return this.#origin.parentElement.querySelector(selector)
+    }
+  }
+
+  class Deprecator {
+    logger
+    package
+    version
+
+    constructor (version, packageName, logger) {
+      this.version = version;
+      this.package = packageName;
+      this.logger = logger;
+    }
+
+    warn (message, replacement = null) {
+      if (message in this.#emitted) {
+        return
+      }
+
+      const warning = `${message}. It will be removed from ${this.package} ${this.version}`;
+      const alternative = (replacement !== null ? `, use ${replacement} instead` : '');
+      this.logger.warn(`DEPRECATION WARNING: ${warning}${alternative}.`);
+
+      this.#emitted[message] = true;
+    }
+
+    /* Protected and private attributes and methods */
+    #emitted = Object.create(null)
+  }
+
+  const deprecators = Object.create(null);
+
+  function deprecator (version, packageName = 'Cocooned', logger = console) {
+    const hash = [version, packageName].join('#');
+    if (!(hash in deprecators)) {
+      deprecators[hash] = new Deprecator(version, packageName, logger);
+    }
+
+    return deprecators[hash]
+  }
+
+  class Listener {
+    constructor (eventTarget, type, listener) {
+      this.#eventTarget = eventTarget;
+      this.#type = type;
+      this.#listener = listener;
+
+      this.#eventTarget.addEventListener(this.#type, this.#listener);
+    }
+
+    dispose () {
+      this.#eventTarget.removeEventListener(this.#type, this.#listener);
+    }
+
+    /* Protected and private attributes and methods */
+    #eventTarget
+    #type
+    #listener
+  }
+
+  disposable(Listener);
+
+  if (typeof Symbol.dispose !== "symbol") {
+    console.warn(`
+    Cocooned use Disposable objects but they are not supported by your browser.
+    See Cocooned documentation for polyfill options.
+  `);
+  }
+
+  function disposable(klass) {
+    if (typeof Symbol.dispose !== "symbol") {
+      return
+    }
+
+    klass.prototype[Symbol.dispose] = klass.prototype.dispose;
+  }
+
   // Borrowed from <https://stackoverflow.com/a/2117523>
   function uuidv4 () {
     return ([1e7] + -1e3 + -4e3 + -8e3 + -1e11).replace(/[018]/g, c =>
@@ -69,13 +216,22 @@
     ]
   }
 
+  const canAnimate = (
+    'animate' in document.createElement('div') &&
+    typeof document.createElement('div').animate === 'function'
+  );
+
+  const shouldAnimate = (
+    'matchMedia' in window &&
+    !window.matchMedia('(prefers-reduced-motion: reduce)').matches
+  );
+
   const instances = Object.create(null);
 
   class Base {
     static get defaultOptions () {
-      const element = document.createElement('div');
       return {
-        animate: ('animate' in element && typeof element.animate === 'function'),
+        animate: canAnimate && shouldAnimate,
         animator: defaultAnimator,
         duration: 450
       }
@@ -98,7 +254,7 @@
 
     constructor (container, options) {
       this._container = container;
-      this._uuid = uuidv4();
+      this.__uuid = uuidv4();
       this._options = this.constructor._normalizeOptions({
         ...this.constructor.defaultOptions,
         ...('cocoonedOptions' in container.dataset ? JSON.parse(container.dataset.cocoonedOptions) : {}),
@@ -115,16 +271,31 @@
     }
 
     start () {
-      this.container.dataset.cocoonedContainer = true;
-      this.container.dataset.cocoonedUuid = this._uuid;
-      instances[this._uuid] = this;
+      if (!('cocoonedContainer' in this.container.dataset)) {
+        deprecator('4.0').warn(
+          'CSS classes based detection is deprecated',
+          'cocooned_container Rails helper to declare containers'
+        );
+        this.container.dataset.cocoonedContainer = true;
+      }
+
+      this.container.dataset.cocoonedUuid = this.__uuid;
+      this._onDispose(() => delete this.container.dataset.cocoonedUuid);
+
+      instances[this.__uuid] = this;
+      this._onDispose(() => delete instances[this.__uuid]);
 
       const hideDestroyed = () => { hideMarkedForDestruction(this, this.items); };
 
       hideDestroyed();
-      this.container.ownerDocument.addEventListener('page:load', hideDestroyed);
-      this.container.ownerDocument.addEventListener('turbo:load', hideDestroyed);
-      this.container.ownerDocument.addEventListener('turbolinks:load', hideDestroyed);
+      this._addEventListener(this.container.ownerDocument, 'page:load', hideDestroyed);
+      this._addEventListener(this.container.ownerDocument, 'turbo:load', hideDestroyed);
+      this._addEventListener(this.container.ownerDocument, 'turbolinks:load', hideDestroyed);
+    }
+
+    dispose () {
+      this._disposer.dispose();
+      this._container = null;
     }
 
     notify (node, eventType, eventData) {
@@ -180,8 +351,21 @@
 
     _container
     _options
-    __uuid
+    __disposer
     __emitter
+    __uuid
+
+    _addEventListener (target, type, listener) {
+      this._disposer.use(new Listener(target, type, listener));
+    }
+
+    get _disposer () {
+      if (typeof this.__disposer === 'undefined') {
+        this.__disposer = new DisposableStack();
+      }
+
+      return this.__disposer
+    }
 
     get _emitter () {
       if (typeof this.__emitter === 'undefined') {
@@ -191,6 +375,10 @@
       return this.__emitter
     }
 
+    _onDispose (callback) {
+      this._disposer.defer(callback);
+    }
+
     _selectors (name) {
       return this.constructor.selectors[name]
     }
@@ -205,6 +393,8 @@
     }
   }
 
+  disposable(Base);
+
   class Trigger {
     constructor (trigger, cocooned) {
       this._trigger = trigger;
@@ -277,117 +467,6 @@
     }
   }
 
-  class Traverser {
-    constructor (origin, traversal) {
-      this.#origin = origin;
-      this.#traversal = traversal;
-    }
-
-    resolve (selector) {
-      if (this.#traversal in this.#origin && typeof this.#origin[this.#traversal] === 'function') {
-        return this._tryMethod(this.#traversal, selector)
-      }
-
-      if (this.#traversal in this.#origin) {
-        return this._tryProperty(this.#traversal)
-      }
-
-      const method = `_${this.#traversal}`;
-      if (method in this) {
-        return this[method](selector)
-      }
-
-      return null
-    }
-
-    /* Protected and private attributes and methods */
-    #origin
-    #traversal
-
-    _tryMethod (method, selector) {
-      try {
-        const resolved = this.#origin[method](selector);
-        if (resolved instanceof HTMLElement) {
-          return resolved
-        }
-      } catch (e) {}
-
-      return null
-    }
-
-    _tryProperty (property) {
-      const resolved = this.#origin[property];
-      if (resolved instanceof HTMLElement) {
-        return resolved
-      }
-
-      return null
-    }
-
-    _parent (selector) {
-      if (this.#origin.parentElement.matches(selector)) {
-        return this.#origin.parentElement
-      }
-      return null
-    }
-
-    _prev (selector) {
-      if (this.#origin.previousElementSibling.matches(selector)) {
-        return this.#origin.previousElementSibling
-      }
-      return null
-    }
-
-    _next (selector) {
-      if (this.#origin.nextElementSibling.matches(selector)) {
-        return this.#origin.nextElementSibling
-      }
-      return null
-    }
-
-    _siblings (selector) {
-      return this.#origin.parentElement.querySelector(selector)
-    }
-  }
-
-  class Deprecator {
-    logger
-    package
-    version
-
-    constructor (version, packageName, logger) {
-      this.version = version;
-      this.package = packageName;
-      this.logger = logger;
-    }
-
-    warn (message, replacement = null) {
-      if (message in this.#emitted) {
-        return
-      }
-
-      const warning = `${message}. It will be removed from ${this.package} ${this.version}`;
-      const alternative = (replacement !== null ? `, use ${replacement} instead` : '');
-      this.logger.warn(`DEPRECATION WARNING: ${warning}${alternative}.`);
-
-      this.#emitted[message] = true;
-    }
-
-    /* Protected and private attributes and methods */
-    #emitted = Object.create(null)
-  }
-
-  const deprecators = Object.create(null);
-
-  function deprecator (version, packageName = 'Cocooned', logger = console) {
-    const hash = [version, packageName].join('#');
-    if (!(hash in deprecators)) {
-      deprecators[hash] = new Deprecator(version, packageName, logger);
-    }
-
-    return deprecators[hash]
-  }
-
   class Extractor {
     constructor (trigger, cocooned) {
       this.#trigger = trigger;
@@ -466,7 +545,7 @@
         return this.#trigger.ownerDocument.querySelector(node)
       }
 
-      deprecator('3.0').warn('associationInsertionTraversal is deprecated');
+      deprecator('4.0').warn('associationInsertionTraversal is deprecated');
       const traverser = new Traverser(this.#trigger, this.#dataset.associationInsertionTraversal);
 
       return traverser.resolve(node)
@@ -736,12 +815,12 @@
         .map(element => Add.create(element, this))
         .filter(trigger => this.toContainer(trigger.insertionNode) === this.container);
 
-      this.addTriggers.forEach(add => add.trigger.addEventListener(
-        'click',
-        clickHandler$1((e) => add.handle(e))
-      ));
+      this.addTriggers.forEach(add => {
+        this._addEventListener(add.trigger, 'click', clickHandler$1((e) => add.handle(e)));
+      });
 
-      this.container.addEventListener(
+      this._addEventListener(
+        this.container,
         'click',
         itemDelegatedClickHandler(this, this._selector('triggers.remove'), (e) => {
           const trigger = new Remove(e.target, this);
@@ -795,7 +874,7 @@
         return
       }
 
-      this.container.addEventListener('cocooned:before-insert', e => {
+      this._addEventListener(this.container, 'cocooned:before-insert', e => {
         if (this.items.length < this.options.limit) {
           return
         }
@@ -943,16 +1022,16 @@
         return
       }
 
-      this.container.addEventListener('cocooned:after-insert', e => this._reindexer.reindex(e));
-      this.container.addEventListener('cocooned:after-remove', e => this._reindexer.reindex(e));
-      this.container.addEventListener('cocooned:after-move', e => this._reindexer.reindex(e));
+      this._addEventListener(this.container, 'cocooned:after-insert', e => this._reindexer.reindex(e));
+      this._addEventListener(this.container, 'cocooned:after-remove', e => this._reindexer.reindex(e));
+      this._addEventListener(this.container, 'cocooned:after-move', e => this._reindexer.reindex(e));
       const form = this.container.closest('form');
       if (form !== null) {
-        form.addEventListener('submit', e => this._reindexer.reindex(e));
+        this._addEventListener(form, 'submit', e => this._reindexer.reindex(e));
       }
 
-      this.container.addEventListener('click', clickHandler(this, this._selector('triggers.up'), Up));
-      this.container.addEventListener('click', clickHandler(this, this._selector('triggers.down'), Down));
+      this._addEventListener(this.container, 'click', clickHandler(this, this._selector('triggers.up'), Up));
+      this._addEventListener(this.container, 'click', clickHandler(this, this._selector('triggers.down'), Down));
     }
 
     /* Protected and private attributes and methods */
@@ -1051,7 +1130,7 @@
 
   $(() => cocoonAutoStart($));
 
-  deprecator('3.0').warn(
+  deprecator('4.0').warn(
     'Loading @notus.sh/cocooned/cocooned is deprecated',
     '@notus.sh/cocooned/jquery, @notus.sh/cocooned or `@notus.sh/cocooned/src/cocooned/cocooned`'
   );

data/app/assets/stylesheets/cocoon.css

@@ -2,4 +2,4 @@
  *= require cocooned
  */
 
-/* TODO: Remove in 3.0 */
+/* TODO: Remove in 4.0 */

data/app/assets/stylesheets/cocooned.css

@@ -1 +1 @@
-/* TODO: Remove in 3.0 */
+/* TODO: Remove in 4.0 */

data/cocooned.gemspec

@@ -13,8 +13,8 @@ Gem::Specification.new do |spec|
 
   spec.summary      = 'Form builder agnostic handling of Rails nested forms'
   spec.description  = <<-DESC.gsub(/\s+/, ' ')
-    Easier nested form in Rails with capabilities to add, remove, reorder or limit nested items.
-    Works with standard Rails form builder, Formtastic or SimpleForm, and with or without jQuery.
+    Rails nested form made easy, with standard Rails form builder, Formtastic or SimpleForm.
+    Unobtrusive and zero-dependencies JavaScript included, with optional integration with jQuery and Stimulus.
   DESC
   spec.homepage = 'https://github.com/notus-sh/cocooned'
 
@@ -38,11 +38,11 @@ Gem::Specification.new do |spec|
   spec.files = `git ls-files -z`.split("\x0").reject do |f|
     f.match(excluded_dirs) || excluded_files.include?(f)
   end
-  spec.required_ruby_version = '>= 2.7'
+  spec.required_ruby_version = '>= 3.1'
 
-  spec.add_dependency 'rails', '>= 7.0', '< 8.1'
+  spec.add_dependency 'rails', '>= 7.2', '< 8.2'
 
-  spec.add_development_dependency 'bundler', '~> 2.1'
+  spec.add_development_dependency 'bundler', '>= 2.1'
   spec.add_development_dependency 'rake', '~> 13.0'
   spec.add_development_dependency 'rspec', '~> 3.11'
 end

data/lib/cocooned/deprecation.rb

@@ -26,14 +26,14 @@ module Cocooned
           cocooned_add_item_link(...)
         end
         deprecate link_to_add_association: 'Use :cocooned_add_link instead',
-                  deprecator: Deprecation['3.0']
+                  deprecator: Deprecation['4.0']
 
         # @deprecated: Please use {#cocooned_remove_item_link} instead
         def link_to_remove_association(...)
           cocooned_remove_item_link(...)
         end
         deprecate link_to_remove_association: 'Use :cocooned_remove_item_link instead',
-                  deprecator: Deprecation['3.0']
+                  deprecator: Deprecation['4.0']
       end
     end
 
@@ -44,7 +44,7 @@ module Cocooned
         def i18n_namespaces
           return super unless I18n.exists?(:cocoon)
 
-          Deprecation['3.0'].warn 'Support for the :cocoon i18n namespace will be removed in 3.0', caller_locations(3)
+          Deprecation['4.0'].warn 'Support for the :cocoon i18n namespace will be removed in 4.0', caller_locations(3)
           super + %w[cocoon]
         end
       end
@@ -57,7 +57,7 @@ module Cocooned
         def html_data
           return super unless data_keys.size.positive?
 
-          Deprecation['3.0'].warn 'Compatibility with options named data-* will be removed in 3.0', caller_locations(3)
+          Deprecation['4.0'].warn 'Compatibility with options named data-* will be removed in 4.0', caller_locations(3)
           html_data_normalize super.merge(data_options)
         end
 
@@ -78,7 +78,7 @@ module Cocooned
 
         def association_options
           if options.key? :insertion_traversal
-            Deprecation['3.0'].warn 'Support for the :insertion_traversal will be removed in 3.0', caller_locations(3)
+            Deprecation['4.0'].warn 'Support for the :insertion_traversal will be removed in 4.0', caller_locations(3)
           end
 
           super
@@ -91,7 +91,7 @@ module Cocooned
         def renderer_options
           return super unless options.key?(:render_options)
 
-          Deprecation['3.0'].warn 'Support for :render_options will be removed in 3.0', caller_locations(3)
+          Deprecation['4.0'].warn 'Support for :render_options will be removed in 4.0', caller_locations(3)
           legacy_options = options.delete(:render_options)
 
           super.tap do |opts|

data/lib/cocooned/helpers/containers.rb

@@ -29,13 +29,11 @@ module Cocooned
       #
       # Any other argument or option supported by `ActionView::Base#content_tag`
       # will be forwarded.
-      def cocooned_container(*args, &block)
+      def cocooned_container(*args, &)
         options = args.extract_options!.dup
         name = args.shift || :div
-        defaults = cocooned_wrapper_defaults(options, %w[cocooned-container], :'cocooned-container')
-        defaults[:data][:cocooned_options] = options.extract!(:limit, :reorderable).to_json
 
-        content_tag(name, *args, **options.deep_merge(defaults), &block)
+        content_tag(name, *args, **cocooned_container_options(options), &)
       end
 
       # Wrap content with the expected markup for a Cocooned item.
@@ -53,20 +51,33 @@ module Cocooned
       #
       # Any argument or option supported by `ActionView::Base#content_tag` will
       # be forwarded.
-      def cocooned_item(*args, &block)
+      def cocooned_item(*args, &)
         options = args.extract_options!.dup
         name = args.shift || :div
-        defaults = cocooned_wrapper_defaults(options, %w[cocooned-item nested-fields], :'cocooned-item')
 
-        content_tag(name, *args, **options.deep_merge(defaults), &block)
+        content_tag(name, *args, **cocooned_item_options(options), &)
       end
 
       protected
 
-      def cocooned_wrapper_defaults(options, additional_classes, mark)
-        classes = Array.wrap(options.delete(:class)).flat_map { |k| k.to_s.split }.compact_blank
+      def cocooned_container_options(options)
+        options.deep_merge(
+          class: token_list(options.delete(:class), %w[cocooned-container]),
+          data: {
+            controller: [options.dig(:data, :controller), :cocooned].compact_blank.map(&:to_s).join(' '),
+            cocooned_container: true,
+            cocooned_options: options.extract!(:limit, :reorderable).to_json
+          }
+        )
+      end
 
-        { class: (classes + additional_classes), data: { mark => true } }
+      def cocooned_item_options(options)
+        options.deep_merge(
+          class: token_list(options.delete(:class), %w[cocooned-item nested-fields]),
+          data: {
+            cocooned_item: true
+          }
+        )
       end
     end
   end

data/lib/cocooned/helpers/tags/add.rb

@@ -107,8 +107,8 @@ module Cocooned
         #
         # See the documentation of +ActionView::Base#link_to+ for additional
         # options.
-        def cocooned_add_item_link(*args, &block)
-          cocooned_link(Cocooned::Tags::Add, *args, &block)
+        def cocooned_add_item_link(...)
+          cocooned_link(Cocooned::Tags::Add, ...)
         end
 
         # Output a button to add an item in a nested form.
@@ -127,8 +127,8 @@ module Cocooned
         #
         # See Cocooned::Helpers::Tags::Add main documentation for a reference of
         # supported options.
-        def cocooned_add_item_button(*args, &block)
-          cocooned_button(Cocooned::Tags::Add, *args, &block)
+        def cocooned_add_item_button(...)
+          cocooned_button(Cocooned::Tags::Add, ...)
         end
       end
     end

data/lib/cocooned/helpers/tags/down.rb

@@ -44,8 +44,8 @@ module Cocooned
         #
         # See the documentation of +ActionView::Base#link_to+ for additional
         # options.
-        def cocooned_move_item_down_link(*args, &block)
-          cocooned_link(Cocooned::Tags::Down, *args, &block)
+        def cocooned_move_item_down_link(...)
+          cocooned_link(Cocooned::Tags::Down, ...)
         end
 
         # Output a button to move an item down.
@@ -67,8 +67,8 @@ module Cocooned
         #
         # See the documentation of +ActionView::Helpers::FormBuilder#button+ for
         # valid options.
-        def cocooned_move_item_down_button(*args, &block)
-          cocooned_button(Cocooned::Tags::Down, *args, &block)
+        def cocooned_move_item_down_button(...)
+          cocooned_button(Cocooned::Tags::Down, ...)
         end
       end
     end

data/lib/cocooned/helpers/tags/remove.rb

@@ -45,8 +45,8 @@ module Cocooned
         #
         # See the documentation of +ActionView::Base#link_to+ for additional
         # options.
-        def cocooned_remove_item_link(*args, &block)
-          cocooned_link(Cocooned::Tags::Remove, *args, &block)
+        def cocooned_remove_item_link(...)
+          cocooned_link(Cocooned::Tags::Remove, ...)
         end
 
         # Output a button to remove an item (and an hidden field to mark
@@ -69,8 +69,8 @@ module Cocooned
         #
         # See the documentation of +ActionView::Base#link_to+ for additional
         # options.
-        def cocooned_remove_item_button(*args, &block)
-          cocooned_button(Cocooned::Tags::Remove, *args, &block)
+        def cocooned_remove_item_button(...)
+          cocooned_button(Cocooned::Tags::Remove, ...)
         end
       end
     end

data/lib/cocooned/helpers/tags/up.rb

@@ -44,8 +44,8 @@ module Cocooned
         #
         # See the documentation of +ActionView::Base#link_to+ for additional
         # options.
-        def cocooned_move_item_up_link(*args, &block)
-          cocooned_link(Cocooned::Tags::Up, *args, &block)
+        def cocooned_move_item_up_link(...)
+          cocooned_link(Cocooned::Tags::Up, ...)
         end
 
         # Output a button to move an item up.
@@ -67,8 +67,8 @@ module Cocooned
         #
         # See the documentation of +ActionView::Helpers::FormBuilder#button+ for
         # valid options.
-        def cocooned_move_item_up_button(*args, &block)
-          cocooned_button(Cocooned::Tags::Up, *args, &block)
+        def cocooned_move_item_up_button(...)
+          cocooned_button(Cocooned::Tags::Up, ...)
         end
       end
     end

data/lib/cocooned/helpers/tags.rb

@@ -46,14 +46,14 @@ module Cocooned
 
       protected
 
-      def cocooned_link(klass, *args, &block)
+      def cocooned_link(klass, *args, &)
         options = args.extract_options!
-        klass.create(self, *args, **options, &block).render(as: :link)
+        klass.create(self, *args, **options, &).render(as: :link)
       end
 
-      def cocooned_button(klass, *args, &block)
+      def cocooned_button(klass, *args, &)
         options = args.extract_options!
-        klass.create(self, *args, **options, &block).render(as: :button)
+        klass.create(self, *args, **options, &).render(as: :button)
       end
     end
   end

data/lib/cocooned/tags/add.rb

@@ -25,9 +25,9 @@ module Cocooned
       include AssociationOptions
       include Cocooned::Deprecated::TagsHelper::AssociationOptions
 
-      def initialize(template, form, association, **options, &block)
+      def initialize(template, form, association, ...)
         @association = association
-        super(template, form, **options, &block)
+        super(template, form, ...)
       end
 
       def render(as: :link)

data/lib/cocooned/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Cocooned
-  VERSION = '2.4.1'
+  VERSION = '3.0.0'
 end

metadata

@@ -1,15 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: cocooned
 version: !ruby/object:Gem::Version
-  version: 2.4.1
+  version: 3.0.0
 platform: ruby
 authors:
 - Gaël-Ian Havard
 - Nathan Van der Auwera
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-11-25 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -17,32 +16,32 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '7.0'
+        version: '7.2'
     - - "<"
       - !ruby/object:Gem::Version
-        version: '8.1'
+        version: '8.2'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '7.0'
+        version: '7.2'
     - - "<"
       - !ruby/object:Gem::Version
-        version: '8.1'
+        version: '8.2'
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '2.1'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '2.1'
 - !ruby/object:Gem::Dependency
@@ -73,9 +72,9 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '3.11'
-description: " Easier nested form in Rails with capabilities to add, remove, reorder
-  or limit nested items. Works with standard Rails form builder, Formtastic or SimpleForm,
-  and with or without jQuery. "
+description: " Rails nested form made easy, with standard Rails form builder, Formtastic
+  or SimpleForm. Unobtrusive and zero-dependencies JavaScript included, with optional
+  integration with jQuery and Stimulus. "
 email:
 - gael-ian@notus.sh
 - nathan@dixis.com
@@ -123,7 +122,6 @@ metadata:
   homepage_uri: https://github.com/notus-sh/cocooned
   source_code_uri: https://github.com/notus-sh/cocooned
   funding_uri: https://opencollective.com/notus-sh
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -131,15 +129,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '2.7'
+      version: '3.1'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.3
-signing_key:
+rubygems_version: 4.0.3
 specification_version: 4
 summary: Form builder agnostic handling of Rails nested forms
 test_files: []