compony 0.3.2 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 06e0173c3d9173301367b1775e1fec05c0ea40a77f5738fcd8639ec7e3e327f0
-  data.tar.gz: 51ba73e024c5ad97f7a8a935c91b01d06b382ca0870fc95b5e011a9c50726029
+  metadata.gz: 284687f68aedb913ed18269036ecac33270b9134c8d68b5550c7c550cffa0f47
+  data.tar.gz: 764c77b44877c8d9fb2f758bbc3f755a45b91ed8f0bc61418f8da903f100a32c
 SHA512:
-  metadata.gz: 89574a221ec8f0bf76e62efc7d378d35b9607d42288d96f2c8e2cee05fac06b415e1d7f2b00f60f58e2775588e942c40cfb7c3dd4f1081b0784a07b0c45bbed5
-  data.tar.gz: a05cc34c77c8c921f51b282f754e4c46bcf5ee469d63d448427c72caa08a757bc81e3a31bb8c3db61b268abd8dfbed27b8d6b42c21e230b269cf4ac4cb178f71
+  metadata.gz: d4a694e1628e12abdc788ae30bb27ad6d1107f1edd01190f9a79b158abaf9a5aac7ba07a86b24b29362e0c8022d1e4f2072150aae268c286b86b5cff0887de35
+  data.tar.gz: 5e52a76eb1df4fcc8299b2ab59f1a1134ef23509a426877ad64ab9ac3918cd131f540406a073c1afbf063924d25afcecbe429dcd1d0765e1ab8b2c7b0367a43d

data/CHANGELOG.md

@@ -1,3 +1,33 @@
+# 0.4.0
+
+- Support Cancancan's `accessible_attributes`
+  - Cancancan has fixed https://github.com/CanCanCommunity/cancancan/issues/838
+  - Automatically declare all fields as ActiveModel attributes
+    - When using this feature together with ActiveType, be sure to add `include ActiveModel::Attributes` at the top of your virtual models.
+    - Due to Rails' implementation of `authenticate_by`, `:password` and `:password_confirmation` can not be attributes and thus should no longer be declared as fields in your applications.
+      - To handle password fields in forms, `pw_field` and `schema_pw_field` were added
+  - Require `cancancan_action` for every Form, respectively `form_cancancan_action` for every WithForm
+  - Filter form fields by Cancancan action, effectively providing per-field authorization
+  - Attention, this feature is only used when using `field` and `schema_field`, it will not affect custom inputs or schema lines.
+  - Require Ruby 3.2.2
+
+## Steps to perform
+
+- If using ActiveType, add `include ActiveModel::Attributes` at the top of your virtual models.
+- In your User model, remove `field :password` and `field :password_confirmation`
+  - If on login, you get the ArgumentError "One or more password arguments are required", you have forgotten to do this.
+- In your User Form:
+  - replace `concat field :password` by `concat pw_field :password`
+  - replace `concat field :password_confirmation` by `concat pw_field :password_confirmation`
+  - replace `schema_field :password` by `schema_pw_field :password`
+  - replace `schema_field :password_confirmation` by `schema_pw_field :password_confirmation`
+- Make sure your forms work as expected, as cancancan action is now required (see above).
+  - Either supply the appropriate action (e.g. `:edit` or `:new`), or pass `nil` to disable per-field authorization for a form.
+
+# 0.3.3
+
+- In `RequestContext`, distinguish between `content` and `content!`, where the first allows for missing content blocks.
+
 # 0.3.2
 
 - Add label content block to edit component

data/Gemfile.lock

@@ -1,9 +1,9 @@
 PATH
   remote: .
   specs:
-    compony (0.2.3.edge)
+    compony (0.3.0.edge)
       anchormodel (~> 0.2.0)
-      cancancan (~> 3.4.0)
+      cancancan (~> 3.6.0)
       dslblend (>= 0.0.3)
       dyny (>= 0.0.3)
       rails (>= 7.1.2)
@@ -94,7 +94,7 @@ GEM
     base64 (0.2.0)
     bigdecimal (3.1.4)
     builder (3.2.4)
-    cancancan (3.4.0)
+    cancancan (3.6.0)
     concurrent-ruby (1.2.2)
     connection_pool (2.4.1)
     crass (1.0.6)

data/README.md

@@ -1225,6 +1225,8 @@ class User < ApplicationRecord
 end
 ```
 
+All fields declared this way are automatically exported as Rails Model attributes. Note that this also means that you should never declare `password` and `password_confirmation` as a Compony field, as you will get the ArgumentError "One or more password arguments are required" otherwise. Read more about handling password fields in the section about `Compony::Components::Form`.
+
 Compony fields provide the following features:
 
 - a label that lets you generate a name for the column: `User.fields[:first_name].label`
@@ -1345,6 +1347,45 @@ end
 
 Note that the inputs and schema are two completely different concepts that are not auto-inferred from each other. You must make sure that they always correspond. If you forget to mention a field in `schema_fields`, posting the form will fail. Luckily, Schemacop's excellent error messaging will explain which parameter is prohibited.
 
+Both calls respect Cancancan's `permitted_attributes` directive. This means that you can safely declare `field` and `schema_field` in a form that is shared among users with different kinds of permissions. If the current user is not allowed to access a field, the input will be omitted automatically. Further, the parameter validation will exclude that field, effectively disallowing that user from submitting that parameter.
+
+#### Handling password fields
+
+When using Rails' `has_secure_password` method, which typically generates the attributes accessors `:password` and `password_confirmation`, do not declare these two as fields in your User model.
+
+There are two main reasons for this:
+
+- `password` and `password_confirmation` should never show up in lists and show pages, and as these kinds of components tend to iterate over all fields, it's best to have anything that should not show up there declared as a field in the first place.
+- Rails' `authenticate_by` does not work when `password` is declared as a model attribute.
+
+Instead of making these accessors Compony fields, ignore them in the User model and use the following methods in your Form:
+
+```ruby
+class Components::Users::Form < Compony::Components::Form
+  setup do
+    form_fields do
+      # ...
+      concat pw_field(:password)
+      concat pw_field(:password_confirmation)
+    end
+
+    # ...
+    schema_pw_field :password
+    schema_pw_field :password_confirmation
+  end
+end
+```
+
+In contrast to the regular `field` and `schema_field` calls, their `pw_...` pendants do not check for per-field authorization. Instead, they check whether the current user can `:set_password` on the form's object. Therefore, your ability may look something like:
+
+```ruby
+class Ability
+  # ...
+  can :manage, User # This allows full access to all users
+  cannot :manage, User, [:user_role] # This prohibits access to user_role, thus removing the input and making the parameter invalid if passed anyway
+  cannot :set_password, User # This prohibits setting and changing passwords of any user
+```
+
 ### New
 
 This component is the Compony equivalent to a typical Rails controller's `new` and `create` actions.

data/Rakefile

@@ -14,7 +14,7 @@ task :gemspec do
     s.files         = `git ls-files`.split($INPUT_RECORD_SEPARATOR)
     s.executables   = []
     s.require_paths = ['lib']
-    s.required_ruby_version = '>= 3.0.0'
+    s.required_ruby_version = '>= 3.2.2'
 
     # Dependencies
     s.add_development_dependency 'yard', '>= 0.9.28'
@@ -28,7 +28,7 @@ task :gemspec do
     s.add_runtime_dependency 'simple_form', '>= 5.1.0'
     s.add_runtime_dependency 'dslblend', '>= 0.0.3'
     s.add_runtime_dependency 'anchormodel', '~> 0.2.0'
-    s.add_runtime_dependency 'cancancan', '~> 3.4.0'
+    s.add_runtime_dependency 'cancancan', '~> 3.6.1'
   end
 
   File.open('compony.gemspec', 'w') do |f|

data/VERSION

@@ -1 +1 @@
-0.3.2
+0.4.0

data/compony.gemspec

@@ -2,19 +2,19 @@
 # This file is auto-generated via: 'rake gemspec'.
 
 # -*- encoding: utf-8 -*-
-# stub: compony 0.3.2 ruby lib
+# stub: compony 0.4.0 ruby lib
 
 Gem::Specification.new do |s|
   s.name = "compony".freeze
-  s.version = "0.3.2".freeze
+  s.version = "0.4.0".freeze
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0".freeze) if s.respond_to? :required_rubygems_version=
   s.require_paths = ["lib".freeze]
   s.authors = ["Sandro Kalbermatter".freeze, "contributors".freeze]
-  s.date = "2024-06-01"
+  s.date = "2024-06-11"
   s.files = [".gitignore".freeze, ".ruby-version".freeze, ".yardopts".freeze, "CHANGELOG.md".freeze, "Gemfile".freeze, "Gemfile.lock".freeze, "LICENSE".freeze, "README.md".freeze, "Rakefile".freeze, "TODO.md".freeze, "VERSION".freeze, "app/controllers/compony_controller.rb".freeze, "compony.gemspec".freeze, "config/locales/de.yml".freeze, "config/locales/en.yml".freeze, "config/locales/fr.yml".freeze, "config/routes.rb".freeze, "doc/ComponentGenerator.html".freeze, "doc/Components.html".freeze, "doc/ComponentsGenerator.html".freeze, "doc/Compony.html".freeze, "doc/Compony/Component.html".freeze, "doc/Compony/ComponentMixins.html".freeze, "doc/Compony/ComponentMixins/Default.html".freeze, "doc/Compony/ComponentMixins/Default/Labelling.html".freeze, "doc/Compony/ComponentMixins/Default/Standalone.html".freeze, "doc/Compony/ComponentMixins/Default/Standalone/ResourcefulVerbDsl.html".freeze, "doc/Compony/ComponentMixins/Default/Standalone/StandaloneDsl.html".freeze, "doc/Compony/ComponentMixins/Default/Standalone/VerbDsl.html".freeze, "doc/Compony/ComponentMixins/Resourceful.html".freeze, "doc/Compony/Components.html".freeze, "doc/Compony/Components/Button.html".freeze, "doc/Compony/Components/Destroy.html".freeze, "doc/Compony/Components/Edit.html".freeze, "doc/Compony/Components/Form.html".freeze, "doc/Compony/Components/New.html".freeze, "doc/Compony/Components/WithForm.html".freeze, "doc/Compony/ControllerMixin.html".freeze, "doc/Compony/Engine.html".freeze, "doc/Compony/MethodAccessibleHash.html".freeze, "doc/Compony/ModelFields.html".freeze, "doc/Compony/ModelFields/Anchormodel.html".freeze, "doc/Compony/ModelFields/Association.html".freeze, "doc/Compony/ModelFields/Attachment.html".freeze, "doc/Compony/ModelFields/Base.html".freeze, "doc/Compony/ModelFields/Boolean.html".freeze, "doc/Compony/ModelFields/Color.html".freeze, "doc/Compony/ModelFields/Currency.html".freeze, "doc/Compony/ModelFields/Date.html".freeze, "doc/Compony/ModelFields/Datetime.html".freeze, "doc/Compony/ModelFields/Decimal.html".freeze, "doc/Compony/ModelFields/Email.html".freeze, "doc/Compony/ModelFields/Float.html".freeze, "doc/Compony/ModelFields/Integer.html".freeze, "doc/Compony/ModelFields/Percentage.html".freeze, "doc/Compony/ModelFields/Phone.html".freeze, "doc/Compony/ModelFields/RichText.html".freeze, "doc/Compony/ModelFields/String.html".freeze, "doc/Compony/ModelFields/Text.html".freeze, "doc/Compony/ModelFields/Time.html".freeze, "doc/Compony/ModelFields/Url.html".freeze, "doc/Compony/ModelMixin.html".freeze, "doc/Compony/NaturalOrdering.html".freeze, "doc/Compony/RequestContext.html".freeze, "doc/Compony/Version.html".freeze, "doc/Compony/ViewHelpers.html".freeze, "doc/ComponyController.html".freeze, "doc/_index.html".freeze, "doc/class_list.html".freeze, "doc/css/common.css".freeze, "doc/css/full_list.css".freeze, "doc/css/style.css".freeze, "doc/file.README.html".freeze, "doc/file_list.html".freeze, "doc/frames.html".freeze, "doc/imgs/intro-example-destroy.png".freeze, "doc/imgs/intro-example-edit.png".freeze, "doc/imgs/intro-example-index.png".freeze, "doc/imgs/intro-example-new.png".freeze, "doc/imgs/intro-example-show.png".freeze, "doc/index.html".freeze, "doc/js/app.js".freeze, "doc/js/full_list.js".freeze, "doc/js/jquery.js".freeze, "doc/method_list.html".freeze, "doc/resourceful_lifecycle.graphml".freeze, "doc/resourceful_lifecycle.pdf".freeze, "doc/resourceful_lifecycle.png".freeze, "doc/top-level-namespace.html".freeze, "lib/compony.rb".freeze, "lib/compony/component.rb".freeze, "lib/compony/component_mixins/default/labelling.rb".freeze, "lib/compony/component_mixins/default/standalone.rb".freeze, "lib/compony/component_mixins/default/standalone/resourceful_verb_dsl.rb".freeze, "lib/compony/component_mixins/default/standalone/standalone_dsl.rb".freeze, "lib/compony/component_mixins/default/standalone/verb_dsl.rb".freeze, "lib/compony/component_mixins/resourceful.rb".freeze, "lib/compony/components/button.rb".freeze, "lib/compony/components/destroy.rb".freeze, "lib/compony/components/edit.rb".freeze, "lib/compony/components/form.rb".freeze, "lib/compony/components/new.rb".freeze, "lib/compony/components/with_form.rb".freeze, "lib/compony/controller_mixin.rb".freeze, "lib/compony/engine.rb".freeze, "lib/compony/method_accessible_hash.rb".freeze, "lib/compony/model_fields/anchormodel.rb".freeze, "lib/compony/model_fields/association.rb".freeze, "lib/compony/model_fields/attachment.rb".freeze, "lib/compony/model_fields/base.rb".freeze, "lib/compony/model_fields/boolean.rb".freeze, "lib/compony/model_fields/color.rb".freeze, "lib/compony/model_fields/currency.rb".freeze, "lib/compony/model_fields/date.rb".freeze, "lib/compony/model_fields/datetime.rb".freeze, "lib/compony/model_fields/decimal.rb".freeze, "lib/compony/model_fields/email.rb".freeze, "lib/compony/model_fields/float.rb".freeze, "lib/compony/model_fields/integer.rb".freeze, "lib/compony/model_fields/percentage.rb".freeze, "lib/compony/model_fields/phone.rb".freeze, "lib/compony/model_fields/rich_text.rb".freeze, "lib/compony/model_fields/string.rb".freeze, "lib/compony/model_fields/text.rb".freeze, "lib/compony/model_fields/time.rb".freeze, "lib/compony/model_fields/url.rb".freeze, "lib/compony/model_mixin.rb".freeze, "lib/compony/natural_ordering.rb".freeze, "lib/compony/request_context.rb".freeze, "lib/compony/version.rb".freeze, "lib/compony/view_helpers.rb".freeze, "lib/generators/component/USAGE".freeze, "lib/generators/component/component_generator.rb".freeze, "lib/generators/component/templates/component.rb.erb".freeze, "lib/generators/component/templates/destroy.rb.erb".freeze, "lib/generators/component/templates/edit.rb.erb".freeze, "lib/generators/component/templates/form.rb.erb".freeze, "lib/generators/component/templates/new.rb.erb".freeze, "lib/generators/components/USAGE".freeze, "lib/generators/components/components_generator.rb".freeze, "logo.svg".freeze]
-  s.required_ruby_version = Gem::Requirement.new(">= 3.0.0".freeze)
-  s.rubygems_version = "3.5.9".freeze
+  s.required_ruby_version = Gem::Requirement.new(">= 3.2.2".freeze)
+  s.rubygems_version = "3.5.11".freeze
   s.summary = "Compony is a Gem that allows you to write your Rails application in component-style fashion. It combines a controller action and route along \\ with its view into a single Ruby class. This allows writing much DRYer code, using inheritance even in views and much easier refactoring for your Rails \\ applications, helping you to keep the code clean as the application evolves.".freeze
 
   s.specification_version = 4
@@ -29,5 +29,5 @@ Gem::Specification.new do |s|
   s.add_runtime_dependency(%q<simple_form>.freeze, [">= 5.1.0".freeze])
   s.add_runtime_dependency(%q<dslblend>.freeze, [">= 0.0.3".freeze])
   s.add_runtime_dependency(%q<anchormodel>.freeze, ["~> 0.2.0".freeze])
-  s.add_runtime_dependency(%q<cancancan>.freeze, ["~> 3.4.0".freeze])
+  s.add_runtime_dependency(%q<cancancan>.freeze, ["~> 3.6.1".freeze])
 end

data/doc/ComponentGenerator.html

@@ -6,7 +6,7 @@
 <title>
   Class: ComponentGenerator
   
-    &mdash; Documentation by YARD 0.9.34
+    &mdash; Documentation by YARD 0.9.36
   
 </title>
 
@@ -221,9 +221,9 @@
 </div>
 
       <div id="footer">
-  Generated on Sat Jun  1 14:22:43 2024 by
+  Generated on Tue Jun 11 11:15:54 2024 by
   <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
-  0.9.34 (ruby-3.2.2).
+  0.9.36 (ruby-3.2.2).
 </div>
 
     </div>

data/doc/Components.html

@@ -6,7 +6,7 @@
 <title>
   Module: Components
   
-    &mdash; Documentation by YARD 0.9.34
+    &mdash; Documentation by YARD 0.9.36
   
 </title>
 
@@ -95,9 +95,9 @@
 </div>
 
       <div id="footer">
-  Generated on Sat Jun  1 14:22:42 2024 by
+  Generated on Tue Jun 11 11:15:54 2024 by
   <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
-  0.9.34 (ruby-3.2.2).
+  0.9.36 (ruby-3.2.2).
 </div>
 
     </div>

data/doc/ComponentsGenerator.html

@@ -6,7 +6,7 @@
 <title>
   Class: ComponentsGenerator
   
-    &mdash; Documentation by YARD 0.9.34
+    &mdash; Documentation by YARD 0.9.36
   
 </title>
 
@@ -193,9 +193,9 @@
 </div>
 
       <div id="footer">
-  Generated on Sat Jun  1 14:22:43 2024 by
+  Generated on Tue Jun 11 11:15:54 2024 by
   <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
-  0.9.34 (ruby-3.2.2).
+  0.9.36 (ruby-3.2.2).
 </div>
 
     </div>

data/doc/Compony/Component.html

@@ -6,7 +6,7 @@
 <title>
   Class: Compony::Component
   
-    &mdash; Documentation by YARD 0.9.34
+    &mdash; Documentation by YARD 0.9.36
   
 </title>
 
@@ -275,7 +275,7 @@
         <li class="public ">
   <span class="summary_signature">
     
-      <a href="#before_render-instance_method" title="#before_render (instance method)">#<strong>before_render</strong>(name = :main, before: nil, **kwargs, &amp;block)  &#x21d2; Object </a>
+      <a href="#before_render-instance_method" title="#before_render (instance method)">#<strong>before_render</strong>(name = :main, before: nil, &amp;block)  &#x21d2; Object </a>
     
 
     
@@ -347,7 +347,7 @@
         <li class="public ">
   <span class="summary_signature">
     
-      <a href="#content-instance_method" title="#content (instance method)">#<strong>content</strong>(name = :main, before: nil, **kwargs, &amp;block)  &#x21d2; Object </a>
+      <a href="#content-instance_method" title="#content (instance method)">#<strong>content</strong>(name = :main, before: nil, &amp;block)  &#x21d2; Object </a>
     
 
     
@@ -1089,7 +1089,7 @@
       <div class="method_details ">
   <h3 class="signature " id="before_render-instance_method">
   
-    #<strong>before_render</strong>(name = :main, before: nil, **kwargs, &amp;block)  &#x21d2; <tt>Object</tt> 
+    #<strong>before_render</strong>(name = :main, before: nil, &amp;block)  &#x21d2; <tt>Object</tt> 
   
 
   
@@ -1176,9 +1176,9 @@
     <td>
       <pre class="code"><span class="info file"># File 'lib/compony/component.rb', line 121</span>
 
-<span class='kw'>def</span> <span class='id identifier rubyid_before_render'>before_render</span><span class='lparen'>(</span><span class='id identifier rubyid_name'>name</span> <span class='op'>=</span> <span class='symbol'>:main</span><span class='comma'>,</span> <span class='label'>before:</span> <span class='kw'>nil</span><span class='comma'>,</span> <span class='op'>**</span><span class='id identifier rubyid_kwargs'>kwargs</span><span class='comma'>,</span> <span class='op'>&amp;</span><span class='id identifier rubyid_block'>block</span><span class='rparen'>)</span>
+<span class='kw'>def</span> <span class='id identifier rubyid_before_render'>before_render</span><span class='lparen'>(</span><span class='id identifier rubyid_name'>name</span> <span class='op'>=</span> <span class='symbol'>:main</span><span class='comma'>,</span> <span class='label'>before:</span> <span class='kw'>nil</span><span class='comma'>,</span> <span class='op'>**</span><span class='comma'>,</span> <span class='op'>&amp;</span><span class='id identifier rubyid_block'>block</span><span class='rparen'>)</span>
   <span class='id identifier rubyid_fail'>fail</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>`before_render` expects a block in </span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_inspect'>inspect</span><span class='embexpr_end'>}</span><span class='tstring_content'>.</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span> <span class='kw'>unless</span> <span class='id identifier rubyid_block_given?'>block_given?</span>
-  <span class='ivar'>@before_render_blocks</span><span class='period'>.</span><span class='id identifier rubyid_natural_push'>natural_push</span><span class='lparen'>(</span><span class='id identifier rubyid_name'>name</span><span class='comma'>,</span> <span class='id identifier rubyid_block'>block</span><span class='comma'>,</span> <span class='label'>before:</span><span class='comma'>,</span> <span class='op'>**</span><span class='id identifier rubyid_kwargs'>kwargs</span><span class='rparen'>)</span>
+  <span class='ivar'>@before_render_blocks</span><span class='period'>.</span><span class='id identifier rubyid_natural_push'>natural_push</span><span class='lparen'>(</span><span class='id identifier rubyid_name'>name</span><span class='comma'>,</span> <span class='id identifier rubyid_block'>block</span><span class='comma'>,</span> <span class='label'>before:</span><span class='comma'>,</span> <span class='op'>**</span><span class='rparen'>)</span>
 <span class='kw'>end</span></pre>
     </td>
   </tr>
@@ -1270,7 +1270,7 @@
       <div class="method_details ">
   <h3 class="signature " id="content-instance_method">
   
-    #<strong>content</strong>(name = :main, before: nil, **kwargs, &amp;block)  &#x21d2; <tt>Object</tt> 
+    #<strong>content</strong>(name = :main, before: nil, &amp;block)  &#x21d2; <tt>Object</tt> 
   
 
   
@@ -1376,12 +1376,12 @@
     <td>
       <pre class="code"><span class="info file"># File 'lib/compony/component.rb', line 132</span>
 
-<span class='kw'>def</span> <span class='id identifier rubyid_content'>content</span><span class='lparen'>(</span><span class='id identifier rubyid_name'>name</span> <span class='op'>=</span> <span class='symbol'>:main</span><span class='comma'>,</span> <span class='label'>before:</span> <span class='kw'>nil</span><span class='comma'>,</span> <span class='op'>**</span><span class='id identifier rubyid_kwargs'>kwargs</span><span class='comma'>,</span> <span class='op'>&amp;</span><span class='id identifier rubyid_block'>block</span><span class='rparen'>)</span>
+<span class='kw'>def</span> <span class='id identifier rubyid_content'>content</span><span class='lparen'>(</span><span class='id identifier rubyid_name'>name</span> <span class='op'>=</span> <span class='symbol'>:main</span><span class='comma'>,</span> <span class='label'>before:</span> <span class='kw'>nil</span><span class='comma'>,</span> <span class='op'>**</span><span class='comma'>,</span> <span class='op'>&amp;</span><span class='id identifier rubyid_block'>block</span><span class='rparen'>)</span>
   <span class='comment'># A block is required here, but if this is an override (e.g. to hide another content block), we can tolerate the missing block.
 </span>  <span class='kw'>if</span> <span class='op'>!</span><span class='id identifier rubyid_block_given?'>block_given?</span> <span class='op'>&amp;&amp;</span> <span class='ivar'>@content_blocks</span><span class='period'>.</span><span class='id identifier rubyid_find'>find</span> <span class='lbrace'>{</span> <span class='op'>|</span><span class='id identifier rubyid_b'>b</span><span class='op'>|</span> <span class='id identifier rubyid_b'>b</span><span class='period'>.</span><span class='id identifier rubyid_name'>name</span> <span class='op'>==</span> <span class='id identifier rubyid_name'>name</span> <span class='rbrace'>}</span><span class='period'>.</span><span class='id identifier rubyid_nil?'>nil?</span>
     <span class='id identifier rubyid_fail'>fail</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>`content` expects a block in </span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_inspect'>inspect</span><span class='embexpr_end'>}</span><span class='tstring_content'>.</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span>
   <span class='kw'>end</span>
-  <span class='ivar'>@content_blocks</span><span class='period'>.</span><span class='id identifier rubyid_natural_push'>natural_push</span><span class='lparen'>(</span><span class='id identifier rubyid_name'>name</span><span class='comma'>,</span> <span class='id identifier rubyid_block'>block</span> <span class='op'>||</span> <span class='symbol'>:missing</span><span class='comma'>,</span> <span class='label'>before:</span><span class='comma'>,</span> <span class='op'>**</span><span class='id identifier rubyid_kwargs'>kwargs</span><span class='rparen'>)</span>
+  <span class='ivar'>@content_blocks</span><span class='period'>.</span><span class='id identifier rubyid_natural_push'>natural_push</span><span class='lparen'>(</span><span class='id identifier rubyid_name'>name</span><span class='comma'>,</span> <span class='id identifier rubyid_block'>block</span> <span class='op'>||</span> <span class='symbol'>:missing</span><span class='comma'>,</span> <span class='label'>before:</span><span class='comma'>,</span> <span class='op'>**</span><span class='rparen'>)</span>
 <span class='kw'>end</span></pre>
     </td>
   </tr>
@@ -2243,9 +2243,9 @@
 </div>
 
       <div id="footer">
-  Generated on Sat Jun  1 14:22:43 2024 by
+  Generated on Tue Jun 11 11:15:54 2024 by
   <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
-  0.9.34 (ruby-3.2.2).
+  0.9.36 (ruby-3.2.2).
 </div>
 
     </div>

data/doc/Compony/ComponentMixins/Default/Labelling.html

@@ -6,7 +6,7 @@
 <title>
   Module: Compony::ComponentMixins::Default::Labelling
   
-    &mdash; Documentation by YARD 0.9.34
+    &mdash; Documentation by YARD 0.9.36
   
 </title>
 
@@ -396,9 +396,9 @@
 </div>
 
       <div id="footer">
-  Generated on Sat Jun  1 14:22:42 2024 by
+  Generated on Tue Jun 11 11:15:54 2024 by
   <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
-  0.9.34 (ruby-3.2.2).
+  0.9.36 (ruby-3.2.2).
 </div>
 
     </div>

data/doc/Compony/ComponentMixins/Default/Standalone/ResourcefulVerbDsl.html

@@ -6,7 +6,7 @@
 <title>
   Class: Compony::ComponentMixins::Default::Standalone::ResourcefulVerbDsl
   
-    &mdash; Documentation by YARD 0.9.34
+    &mdash; Documentation by YARD 0.9.36
   
 </title>
 
@@ -529,9 +529,9 @@
 </div>
 
       <div id="footer">
-  Generated on Sat Jun  1 14:22:43 2024 by
+  Generated on Tue Jun 11 11:15:55 2024 by
   <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
-  0.9.34 (ruby-3.2.2).
+  0.9.36 (ruby-3.2.2).
 </div>
 
     </div>

data/doc/Compony/ComponentMixins/Default/Standalone/StandaloneDsl.html

@@ -6,7 +6,7 @@
 <title>
   Class: Compony::ComponentMixins::Default::Standalone::StandaloneDsl
   
-    &mdash; Documentation by YARD 0.9.34
+    &mdash; Documentation by YARD 0.9.36
   
 </title>
 
@@ -228,7 +228,7 @@
         <li class="protected ">
   <span class="summary_signature">
     
-      <a href="#verb-instance_method" title="#verb (instance method)">#<strong>verb</strong>(verb, *args, **nargs)  &#x21d2; Object </a>
+      <a href="#verb-instance_method" title="#verb (instance method)">#<strong>verb</strong>(verb, **nargs)  &#x21d2; Object </a>
     
 
     
@@ -484,7 +484,7 @@
       <div class="method_details ">
   <h3 class="signature " id="verb-instance_method">
   
-    #<strong>verb</strong>(verb, *args, **nargs)  &#x21d2; <tt>Object</tt>  <span class="extras">(protected)</span>
+    #<strong>verb</strong>(verb, **nargs)  &#x21d2; <tt>Object</tt>  <span class="extras">(protected)</span>
   
 
   
@@ -553,18 +553,18 @@
     <td>
       <pre class="code"><span class="info file"># File 'lib/compony/component_mixins/default/standalone/standalone_dsl.rb', line 40</span>
 
-<span class='kw'>def</span> <span class='id identifier rubyid_verb'>verb</span><span class='lparen'>(</span><span class='id identifier rubyid_verb'>verb</span><span class='comma'>,</span> <span class='op'>*</span><span class='id identifier rubyid_args'>args</span><span class='comma'>,</span> <span class='op'>**</span><span class='id identifier rubyid_nargs'>nargs</span><span class='comma'>,</span> <span class='op'>&amp;</span><span class='rparen'>)</span>
+<span class='kw'>def</span> <span class='id identifier rubyid_verb'>verb</span><span class='lparen'>(</span><span class='id identifier rubyid_verb'>verb</span><span class='comma'>,</span> <span class='op'>*</span><span class='comma'>,</span> <span class='op'>**</span><span class='id identifier rubyid_nargs'>nargs</span><span class='comma'>,</span> <span class='op'>&amp;</span><span class='rparen'>)</span>
   <span class='id identifier rubyid_verb'>verb</span> <span class='op'>=</span> <span class='id identifier rubyid_verb'>verb</span><span class='period'>.</span><span class='id identifier rubyid_to_sym'>to_sym</span>
   <span class='id identifier rubyid_verb_dsl_class'>verb_dsl_class</span> <span class='op'>=</span> <span class='ivar'>@component</span><span class='period'>.</span><span class='id identifier rubyid_resourceful?'>resourceful?</span> <span class='op'>?</span> <span class='const'><span class='object_link'><a href="ResourcefulVerbDsl.html" title="Compony::ComponentMixins::Default::Standalone::ResourcefulVerbDsl (class)">ResourcefulVerbDsl</a></span></span> <span class='op'>:</span> <span class='const'><span class='object_link'><a href="VerbDsl.html" title="Compony::ComponentMixins::Default::Standalone::VerbDsl (class)">VerbDsl</a></span></span>
   <span class='kw'>if</span> <span class='ivar'>@verbs</span><span class='lbracket'>[</span><span class='id identifier rubyid_verb'>verb</span><span class='rbracket'>]</span>
-    <span class='ivar'>@verbs</span><span class='lbracket'>[</span><span class='id identifier rubyid_verb'>verb</span><span class='rbracket'>]</span><span class='period'>.</span><span class='id identifier rubyid_deep_merge!'>deep_merge!</span> <span class='id identifier rubyid_verb_dsl_class'>verb_dsl_class</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span><span class='lparen'>(</span><span class='ivar'>@component</span><span class='comma'>,</span> <span class='id identifier rubyid_verb'>verb</span><span class='comma'>,</span> <span class='op'>*</span><span class='id identifier rubyid_args'>args</span><span class='comma'>,</span> <span class='op'>**</span><span class='id identifier rubyid_nargs'>nargs</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_to_conf'>to_conf</span><span class='lparen'>(</span><span class='label'>provide_defaults:</span> <span class='kw'>false</span><span class='comma'>,</span> <span class='op'>&amp;</span><span class='rparen'>)</span>
+    <span class='ivar'>@verbs</span><span class='lbracket'>[</span><span class='id identifier rubyid_verb'>verb</span><span class='rbracket'>]</span><span class='period'>.</span><span class='id identifier rubyid_deep_merge!'>deep_merge!</span> <span class='id identifier rubyid_verb_dsl_class'>verb_dsl_class</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span><span class='lparen'>(</span><span class='ivar'>@component</span><span class='comma'>,</span> <span class='id identifier rubyid_verb'>verb</span><span class='comma'>,</span> <span class='op'>*</span><span class='comma'>,</span> <span class='op'>**</span><span class='id identifier rubyid_nargs'>nargs</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_to_conf'>to_conf</span><span class='lparen'>(</span><span class='label'>provide_defaults:</span> <span class='kw'>false</span><span class='comma'>,</span> <span class='op'>&amp;</span><span class='rparen'>)</span>
   <span class='kw'>else</span>
     <span class='comment'># Note about provide_defaults:
 </span>    <span class='comment'># - We must pass false if this is the second time `standalone` was called for this component -&gt; see @provide_defaults
 </span>    <span class='comment'># - We musst pass false if this is the second time `verb` was called for this component -&gt; handled by the if statement (other branch)
 </span>    <span class='comment'># - We must pass true otherwise (handled by this branch)
 </span>    <span class='ivar'>@verbs</span><span class='lbracket'>[</span><span class='id identifier rubyid_verb'>verb</span><span class='rbracket'>]</span> <span class='op'>=</span> <span class='const'><span class='object_link'><a href="../../../../Compony.html" title="Compony (module)">Compony</a></span></span><span class='op'>::</span><span class='const'><span class='object_link'><a href="../../../MethodAccessibleHash.html" title="Compony::MethodAccessibleHash (class)">MethodAccessibleHash</a></span></span><span class='period'>.</span><span class='id identifier rubyid_new'><span class='object_link'><a href="../../../MethodAccessibleHash.html#initialize-instance_method" title="Compony::MethodAccessibleHash#initialize (method)">new</a></span></span><span class='lparen'>(</span>
-      <span class='id identifier rubyid_verb_dsl_class'>verb_dsl_class</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span><span class='lparen'>(</span><span class='ivar'>@component</span><span class='comma'>,</span> <span class='id identifier rubyid_verb'>verb</span><span class='comma'>,</span> <span class='op'>*</span><span class='id identifier rubyid_args'>args</span><span class='comma'>,</span> <span class='op'>**</span><span class='id identifier rubyid_nargs'>nargs</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_to_conf'>to_conf</span><span class='lparen'>(</span><span class='label'>provide_defaults:</span> <span class='ivar'>@provide_defaults</span><span class='comma'>,</span> <span class='op'>&amp;</span><span class='rparen'>)</span>
+      <span class='id identifier rubyid_verb_dsl_class'>verb_dsl_class</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span><span class='lparen'>(</span><span class='ivar'>@component</span><span class='comma'>,</span> <span class='id identifier rubyid_verb'>verb</span><span class='comma'>,</span> <span class='op'>*</span><span class='comma'>,</span> <span class='op'>**</span><span class='id identifier rubyid_nargs'>nargs</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_to_conf'>to_conf</span><span class='lparen'>(</span><span class='label'>provide_defaults:</span> <span class='ivar'>@provide_defaults</span><span class='comma'>,</span> <span class='op'>&amp;</span><span class='rparen'>)</span>
     <span class='rparen'>)</span>
   <span class='kw'>end</span>
 <span class='kw'>end</span></pre>
@@ -578,9 +578,9 @@
 </div>
 
       <div id="footer">
-  Generated on Sat Jun  1 14:22:43 2024 by
+  Generated on Tue Jun 11 11:15:55 2024 by
   <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
-  0.9.34 (ruby-3.2.2).
+  0.9.36 (ruby-3.2.2).
 </div>
 
     </div>

data/doc/Compony/ComponentMixins/Default/Standalone/VerbDsl.html

@@ -6,7 +6,7 @@
 <title>
   Class: Compony::ComponentMixins::Default::Standalone::VerbDsl
   
-    &mdash; Documentation by YARD 0.9.34
+    &mdash; Documentation by YARD 0.9.36
   
 </title>
 
@@ -567,9 +567,9 @@
 </div>
 
       <div id="footer">
-  Generated on Sat Jun  1 14:22:43 2024 by
+  Generated on Tue Jun 11 11:15:54 2024 by
   <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
-  0.9.34 (ruby-3.2.2).
+  0.9.36 (ruby-3.2.2).
 </div>
 
     </div>

data/doc/Compony/ComponentMixins/Default/Standalone.html

@@ -6,7 +6,7 @@
 <title>
   Module: Compony::ComponentMixins::Default::Standalone
   
-    &mdash; Documentation by YARD 0.9.34
+    &mdash; Documentation by YARD 0.9.36
   
 </title>
 
@@ -682,9 +682,9 @@
 </div>
 
       <div id="footer">
-  Generated on Sat Jun  1 14:22:42 2024 by
+  Generated on Tue Jun 11 11:15:54 2024 by
   <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
-  0.9.34 (ruby-3.2.2).
+  0.9.36 (ruby-3.2.2).
 </div>
 
     </div>

data/doc/Compony/ComponentMixins/Default.html

@@ -6,7 +6,7 @@
 <title>
   Module: Compony::ComponentMixins::Default
   
-    &mdash; Documentation by YARD 0.9.34
+    &mdash; Documentation by YARD 0.9.36
   
 </title>
 
@@ -116,9 +116,9 @@
 </div>
 
       <div id="footer">
-  Generated on Sat Jun  1 14:22:42 2024 by
+  Generated on Tue Jun 11 11:15:54 2024 by
   <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
-  0.9.34 (ruby-3.2.2).
+  0.9.36 (ruby-3.2.2).
 </div>
 
     </div>

data/doc/Compony/ComponentMixins/Resourceful.html

@@ -6,7 +6,7 @@
 <title>
   Module: Compony::ComponentMixins::Resourceful
   
-    &mdash; Documentation by YARD 0.9.34
+    &mdash; Documentation by YARD 0.9.36
   
 </title>
 
@@ -1183,9 +1183,9 @@
 </div>
 
       <div id="footer">
-  Generated on Sat Jun  1 14:22:42 2024 by
+  Generated on Tue Jun 11 11:15:54 2024 by
   <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
-  0.9.34 (ruby-3.2.2).
+  0.9.36 (ruby-3.2.2).
 </div>
 
     </div>

data/doc/Compony/ComponentMixins.html

@@ -6,7 +6,7 @@
 <title>
   Module: Compony::ComponentMixins
   
-    &mdash; Documentation by YARD 0.9.34
+    &mdash; Documentation by YARD 0.9.36
   
 </title>
 
@@ -116,9 +116,9 @@
 </div>
 
       <div id="footer">
-  Generated on Sat Jun  1 14:22:42 2024 by
+  Generated on Tue Jun 11 11:15:54 2024 by
   <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
-  0.9.34 (ruby-3.2.2).
+  0.9.36 (ruby-3.2.2).
 </div>
 
     </div>

data/doc/Compony/Components/Button.html

@@ -6,7 +6,7 @@
 <title>
   Class: Compony::Components::Button
   
-    &mdash; Documentation by YARD 0.9.34
+    &mdash; Documentation by YARD 0.9.36
   
 </title>
 
@@ -283,9 +283,9 @@
 </div>
 
       <div id="footer">
-  Generated on Sat Jun  1 14:22:43 2024 by
+  Generated on Tue Jun 11 11:15:54 2024 by
   <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
-  0.9.34 (ruby-3.2.2).
+  0.9.36 (ruby-3.2.2).
 </div>
 
     </div>

data/doc/Compony/Components/Destroy.html

@@ -6,7 +6,7 @@
 <title>
   Class: Compony::Components::Destroy
   
-    &mdash; Documentation by YARD 0.9.34
+    &mdash; Documentation by YARD 0.9.36
   
 </title>
 
@@ -374,9 +374,9 @@
 </div>
 
       <div id="footer">
-  Generated on Sat Jun  1 14:22:43 2024 by
+  Generated on Tue Jun 11 11:15:54 2024 by
   <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
-  0.9.34 (ruby-3.2.2).
+  0.9.36 (ruby-3.2.2).
 </div>
 
     </div>