compony 0.5.2 → 0.5.4

data/doc/file.README.html

@@ -624,6 +624,8 @@
 </li><li>
 <p><code>skip_authentication!</code> which disables authentication, in case you provided some. You need to implement <code>authorize</code> regardless.</p>
 </li><li>
+<p><code>skip_forgery_protection!</code> which disables CSRF protection for the controller action generated for this standalone configuration.</p>
+</li><li>
 <p><code>layout</code> which takes the file name of a Rails layout and defaults to <code>layouts/application</code>. Use this to have your Rails application look differently depending on the component.</p>
 </li><li>
 <p><code>verb</code> which takes an HTTP verb as a symbol, one of: <code>%i[get head post put delete connect options trace patch]</code>. <code>verb</code> can be called up to once per verb. Inside each <code>verb</code> call, you can call (in the non-resourceful case):</p>
@@ -1089,6 +1091,7 @@ The number 8 has the binary form 1000. Enter a number and press ENTER: [8]
 <p>Examples:</p>
 
 <pre class="code ruby"><code class="ruby"><span class='id identifier rubyid_compony_link'>compony_link</span><span class='lparen'>(</span><span class='symbol'>:index</span><span class='comma'>,</span> <span class='symbol'>:users</span><span class='rparen'>)</span> <span class='comment'># &quot;View all users&quot; -&gt; &#39;users/index&#39;
+</span><span class='id identifier rubyid_compony_link'>compony_link</span><span class='lparen'>(</span><span class='const'><span class='object_link'><a href="Components.html" title="Components (module)">Components</a></span></span><span class='op'>::</span><span class='const'>Users</span><span class='op'>::</span><span class='const'>Index</span><span class='rparen'>)</span> <span class='comment'># same as above
 </span><span class='id identifier rubyid_compony_link'>compony_link</span><span class='lparen'>(</span><span class='symbol'>:index</span><span class='comma'>,</span> <span class='symbol'>:users</span><span class='comma'>,</span> <span class='label'>label_opts:</span> <span class='lbrace'>{</span> <span class='label'>format:</span> <span class='symbol'>:short</span> <span class='rbrace'>}</span><span class='rparen'>)</span> <span class='comment'># &quot;All&quot; -&gt; &#39;users/index&#39;
 </span><span class='id identifier rubyid_compony_link'>compony_link</span><span class='lparen'>(</span><span class='symbol'>:show</span><span class='comma'>,</span> <span class='const'>User</span><span class='period'>.</span><span class='id identifier rubyid_first'>first</span><span class='rparen'>)</span> <span class='comment'># &quot;View John Doe&quot; -&gt; &#39;users/show/1&#39;
 </span><span class='id identifier rubyid_compony_link'>compony_link</span><span class='lparen'>(</span><span class='symbol'>:destroy</span><span class='comma'>,</span> <span class='const'>User</span><span class='period'>.</span><span class='id identifier rubyid_first'>first</span><span class='comma'>,</span> <span class='label'>method:</span> <span class='symbol'>:delete</span><span class='rparen'>)</span> <span class='comment'># &quot;Delete John Doe&quot; -&gt; &#39;users/destroy/1&#39;
@@ -1449,6 +1452,8 @@ my_button = Compony.button(:index, :users, enabled: -&gt; { |controller| control
 <p>Optional: <code>schema_line</code> takes a single Schemacop line. Use this for custom whitelisting of an argument, e.g. if you have an input that does not have a corresponding model field.</p>
 </li><li>
 <p>Optional: <code>schema</code> allows you to instead fully define your own custom Schemacop V3 schema manually. Note that this disables all of the above schema calls.</p>
+</li><li>
+<p>Optional: <code>disable!</code> causes generated inputs to be disabled. Alternatively, <code>disabled: true</code> can be passed to the initializer to achieve the same result.</p>
 </li></ul>
 
 <p>The <code>form_fields</code> block acts much like a content block and you will use Dyny there. Two additional methods are made available exclusively inside the block:</p>
@@ -1515,6 +1520,39 @@ my_button = Compony.button(:index, :users, enabled: -&gt; { |controller| control
   cannot :set_password, User # This prohibits setting and changing passwords of any user
 </code></pre>
 
+<h4 id="label-Dealing+with+multilingual+fields">Dealing with multilingual fields</h4>
+
+<p>When using Gems such as <code>mobility</code>, Compony provides support for multilingual fields. For instance, assuming that a model has the attribute <code>label</code> translated in English and German, making <code>label</code> a virtual attribute reading either <code>label_en</code> and <code>label_de</code>, depending on the user’s language, Compony automatically generates a multilingual field if the following is used:</p>
+
+<p>In the model:</p>
+
+<pre class="code ruby"><code class="ruby"><span class='kw'>class</span> <span class='const'>Foo</span> <span class='op'>&lt;</span> <span class='const'>ApplicationRecord</span>
+  <span class='comment'># No need to write:
+</span>  <span class='id identifier rubyid_field'>field</span> <span class='symbol'>:label</span><span class='comma'>,</span> <span class='symbol'>:string</span><span class='comma'>,</span> <span class='label'>virtual:</span> <span class='kw'>true</span>
+  <span class='const'>I18n</span><span class='period'>.</span><span class='id identifier rubyid_available_locales'>available_locales</span><span class='period'>.</span><span class='id identifier rubyid_each'>each</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_locale'>locale</span><span class='op'>|</span>
+    <span class='id identifier rubyid_field'>field</span> <span class='symbol'>:&quot;label_</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_locale'>locale</span><span class='embexpr_end'>}</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='symbol'>:string</span>
+  <span class='kw'>end</span>
+
+  <span class='comment'># Instead, write this, which is equivalent:
+</span>  <span class='id identifier rubyid_field'>field</span> <span class='symbol'>:label</span><span class='comma'>,</span> <span class='symbol'>:string</span><span class='comma'>,</span> <span class='label'>multilang:</span> <span class='kw'>true</span>
+<span class='kw'>end</span>
+</code></pre>
+
+<p>In the same mindset, you can simplify your form as follows to generate one input per language:</p>
+
+<pre class="code ruby"><code class="ruby"><span class='kw'>class</span> <span class='const'><span class='object_link'><a href="Components.html" title="Components (module)">Components</a></span></span><span class='op'>::</span><span class='const'>Foos</span><span class='op'>::</span><span class='const'>Form</span> <span class='op'>&lt;</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="Compony/Components.html" title="Compony::Components (module)">Components</a></span></span><span class='op'>::</span><span class='const'><span class='object_link'><a href="Compony/Components/Form.html" title="Compony::Components::Form (class)">Form</a></span></span>
+  <span class='id identifier rubyid_setup'>setup</span> <span class='kw'>do</span>
+    <span class='id identifier rubyid_form_fields'>form_fields</span> <span class='kw'>do</span>
+      <span class='comment'># Since `field` only generates an input, you must loop over them and render them as you wish, e.g. with &quot;concat&quot;:
+</span>      <span class='id identifier rubyid_field'>field</span><span class='lparen'>(</span><span class='symbol'>:label</span><span class='comma'>,</span> <span class='label'>multilang:</span> <span class='kw'>true</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_each'>each</span> <span class='lbrace'>{</span> <span class='op'>|</span><span class='id identifier rubyid_inp'>inp</span><span class='op'>|</span> <span class='id identifier rubyid_concat'>concat</span> <span class='id identifier rubyid_inp'>inp</span> <span class='rbrace'>}</span>
+    <span class='kw'>end</span>
+
+    <span class='comment'># Don&#39;t forget to mark `schema_field` as multilingual as well, which will accept label_en and label_de:
+</span>    <span class='id identifier rubyid_schema_field'>schema_field</span> <span class='symbol'>:label</span><span class='comma'>,</span> <span class='label'>multilang:</span> <span class='kw'>true</span>
+  <span class='kw'>end</span>
+<span class='kw'>end</span>
+</code></pre>
+
 <h3 id="label-New">New</h3>
 
 <p>This component is the Compony equivalent to a typical Rails controller’s <code>new</code> and <code>create</code> actions.</p>
@@ -1692,7 +1730,7 @@ my_button = Compony.button(:index, :users, enabled: -&gt; { |controller| control
 </div></div>
 
       <div id="footer">
-  Generated on Wed Nov 20 10:54:24 2024 by
+  Generated on Fri Feb 14 13:24:11 2025 by
   <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.9.37 (ruby-3.3.5).
 </div>

data/doc/index.html

@@ -624,6 +624,8 @@
 </li><li>
 <p><code>skip_authentication!</code> which disables authentication, in case you provided some. You need to implement <code>authorize</code> regardless.</p>
 </li><li>
+<p><code>skip_forgery_protection!</code> which disables CSRF protection for the controller action generated for this standalone configuration.</p>
+</li><li>
 <p><code>layout</code> which takes the file name of a Rails layout and defaults to <code>layouts/application</code>. Use this to have your Rails application look differently depending on the component.</p>
 </li><li>
 <p><code>verb</code> which takes an HTTP verb as a symbol, one of: <code>%i[get head post put delete connect options trace patch]</code>. <code>verb</code> can be called up to once per verb. Inside each <code>verb</code> call, you can call (in the non-resourceful case):</p>
@@ -1089,6 +1091,7 @@ The number 8 has the binary form 1000. Enter a number and press ENTER: [8]
 <p>Examples:</p>
 
 <pre class="code ruby"><code class="ruby"><span class='id identifier rubyid_compony_link'>compony_link</span><span class='lparen'>(</span><span class='symbol'>:index</span><span class='comma'>,</span> <span class='symbol'>:users</span><span class='rparen'>)</span> <span class='comment'># &quot;View all users&quot; -&gt; &#39;users/index&#39;
+</span><span class='id identifier rubyid_compony_link'>compony_link</span><span class='lparen'>(</span><span class='const'><span class='object_link'><a href="Components.html" title="Components (module)">Components</a></span></span><span class='op'>::</span><span class='const'>Users</span><span class='op'>::</span><span class='const'>Index</span><span class='rparen'>)</span> <span class='comment'># same as above
 </span><span class='id identifier rubyid_compony_link'>compony_link</span><span class='lparen'>(</span><span class='symbol'>:index</span><span class='comma'>,</span> <span class='symbol'>:users</span><span class='comma'>,</span> <span class='label'>label_opts:</span> <span class='lbrace'>{</span> <span class='label'>format:</span> <span class='symbol'>:short</span> <span class='rbrace'>}</span><span class='rparen'>)</span> <span class='comment'># &quot;All&quot; -&gt; &#39;users/index&#39;
 </span><span class='id identifier rubyid_compony_link'>compony_link</span><span class='lparen'>(</span><span class='symbol'>:show</span><span class='comma'>,</span> <span class='const'>User</span><span class='period'>.</span><span class='id identifier rubyid_first'>first</span><span class='rparen'>)</span> <span class='comment'># &quot;View John Doe&quot; -&gt; &#39;users/show/1&#39;
 </span><span class='id identifier rubyid_compony_link'>compony_link</span><span class='lparen'>(</span><span class='symbol'>:destroy</span><span class='comma'>,</span> <span class='const'>User</span><span class='period'>.</span><span class='id identifier rubyid_first'>first</span><span class='comma'>,</span> <span class='label'>method:</span> <span class='symbol'>:delete</span><span class='rparen'>)</span> <span class='comment'># &quot;Delete John Doe&quot; -&gt; &#39;users/destroy/1&#39;
@@ -1449,6 +1452,8 @@ my_button = Compony.button(:index, :users, enabled: -&gt; { |controller| control
 <p>Optional: <code>schema_line</code> takes a single Schemacop line. Use this for custom whitelisting of an argument, e.g. if you have an input that does not have a corresponding model field.</p>
 </li><li>
 <p>Optional: <code>schema</code> allows you to instead fully define your own custom Schemacop V3 schema manually. Note that this disables all of the above schema calls.</p>
+</li><li>
+<p>Optional: <code>disable!</code> causes generated inputs to be disabled. Alternatively, <code>disabled: true</code> can be passed to the initializer to achieve the same result.</p>
 </li></ul>
 
 <p>The <code>form_fields</code> block acts much like a content block and you will use Dyny there. Two additional methods are made available exclusively inside the block:</p>
@@ -1515,6 +1520,39 @@ my_button = Compony.button(:index, :users, enabled: -&gt; { |controller| control
   cannot :set_password, User # This prohibits setting and changing passwords of any user
 </code></pre>
 
+<h4 id="label-Dealing+with+multilingual+fields">Dealing with multilingual fields</h4>
+
+<p>When using Gems such as <code>mobility</code>, Compony provides support for multilingual fields. For instance, assuming that a model has the attribute <code>label</code> translated in English and German, making <code>label</code> a virtual attribute reading either <code>label_en</code> and <code>label_de</code>, depending on the user’s language, Compony automatically generates a multilingual field if the following is used:</p>
+
+<p>In the model:</p>
+
+<pre class="code ruby"><code class="ruby"><span class='kw'>class</span> <span class='const'>Foo</span> <span class='op'>&lt;</span> <span class='const'>ApplicationRecord</span>
+  <span class='comment'># No need to write:
+</span>  <span class='id identifier rubyid_field'>field</span> <span class='symbol'>:label</span><span class='comma'>,</span> <span class='symbol'>:string</span><span class='comma'>,</span> <span class='label'>virtual:</span> <span class='kw'>true</span>
+  <span class='const'>I18n</span><span class='period'>.</span><span class='id identifier rubyid_available_locales'>available_locales</span><span class='period'>.</span><span class='id identifier rubyid_each'>each</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_locale'>locale</span><span class='op'>|</span>
+    <span class='id identifier rubyid_field'>field</span> <span class='symbol'>:&quot;label_</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_locale'>locale</span><span class='embexpr_end'>}</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='symbol'>:string</span>
+  <span class='kw'>end</span>
+
+  <span class='comment'># Instead, write this, which is equivalent:
+</span>  <span class='id identifier rubyid_field'>field</span> <span class='symbol'>:label</span><span class='comma'>,</span> <span class='symbol'>:string</span><span class='comma'>,</span> <span class='label'>multilang:</span> <span class='kw'>true</span>
+<span class='kw'>end</span>
+</code></pre>
+
+<p>In the same mindset, you can simplify your form as follows to generate one input per language:</p>
+
+<pre class="code ruby"><code class="ruby"><span class='kw'>class</span> <span class='const'><span class='object_link'><a href="Components.html" title="Components (module)">Components</a></span></span><span class='op'>::</span><span class='const'>Foos</span><span class='op'>::</span><span class='const'>Form</span> <span class='op'>&lt;</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="Compony/Components.html" title="Compony::Components (module)">Components</a></span></span><span class='op'>::</span><span class='const'><span class='object_link'><a href="Compony/Components/Form.html" title="Compony::Components::Form (class)">Form</a></span></span>
+  <span class='id identifier rubyid_setup'>setup</span> <span class='kw'>do</span>
+    <span class='id identifier rubyid_form_fields'>form_fields</span> <span class='kw'>do</span>
+      <span class='comment'># Since `field` only generates an input, you must loop over them and render them as you wish, e.g. with &quot;concat&quot;:
+</span>      <span class='id identifier rubyid_field'>field</span><span class='lparen'>(</span><span class='symbol'>:label</span><span class='comma'>,</span> <span class='label'>multilang:</span> <span class='kw'>true</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_each'>each</span> <span class='lbrace'>{</span> <span class='op'>|</span><span class='id identifier rubyid_inp'>inp</span><span class='op'>|</span> <span class='id identifier rubyid_concat'>concat</span> <span class='id identifier rubyid_inp'>inp</span> <span class='rbrace'>}</span>
+    <span class='kw'>end</span>
+
+    <span class='comment'># Don&#39;t forget to mark `schema_field` as multilingual as well, which will accept label_en and label_de:
+</span>    <span class='id identifier rubyid_schema_field'>schema_field</span> <span class='symbol'>:label</span><span class='comma'>,</span> <span class='label'>multilang:</span> <span class='kw'>true</span>
+  <span class='kw'>end</span>
+<span class='kw'>end</span>
+</code></pre>
+
 <h3 id="label-New">New</h3>
 
 <p>This component is the Compony equivalent to a typical Rails controller’s <code>new</code> and <code>create</code> actions.</p>
@@ -1692,7 +1730,7 @@ my_button = Compony.button(:index, :users, enabled: -&gt; { |controller| control
 </div></div>
 
       <div id="footer">
-  Generated on Wed Nov 20 10:54:23 2024 by
+  Generated on Fri Feb 14 13:24:10 2025 by
   <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.9.37 (ruby-3.3.5).
 </div>

data/doc/method_list.html

@@ -392,6 +392,14 @@
   
 
   <li class="even ">
+    <div class="item">
+      <span class='object_link'><a href="Compony/Components/Form.html#disable!-instance_method" title="Compony::Components::Form#disable! (method)">#disable!</a></span>
+      <small>Compony::Components::Form</small>
+    </div>
+  </li>
+  
+
+  <li class="odd ">
     <div class="item">
       <span class='object_link'><a href="Compony/RequestContext.html#evaluate_with_backfire-instance_method" title="Compony::RequestContext#evaluate_with_backfire (method)">#evaluate_with_backfire</a></span>
       <small>Compony::RequestContext</small>
@@ -399,7 +407,7 @@
   </li>
   
 
-  <li class="odd ">
+  <li class="even ">
     <div class="item">
       <span class='object_link'><a href="Compony/ModelFields/Base.html#extra_attrs-instance_method" title="Compony::ModelFields::Base#extra_attrs (method)">#extra_attrs</a></span>
       <small>Compony::ModelFields::Base</small>
@@ -407,7 +415,7 @@
   </li>
   
 
-  <li class="even ">
+  <li class="odd ">
     <div class="item">
       <span class='object_link'><a href="Compony/Components/Form.html#f-instance_method" title="Compony::Components::Form#f (method)">#f</a></span>
       <small>Compony::Components::Form</small>
@@ -415,7 +423,7 @@
   </li>
   
 
-  <li class="odd ">
+  <li class="even ">
     <div class="item">
       <span class='object_link'><a href="Compony/Component.html#family_cst-class_method" title="Compony::Component.family_cst (method)">family_cst</a></span>
       <small>Compony::Component</small>
@@ -423,7 +431,7 @@
   </li>
   
 
-  <li class="even ">
+  <li class="odd ">
     <div class="item">
       <span class='object_link'><a href="Compony/Component.html#family_cst-instance_method" title="Compony::Component#family_cst (method)">#family_cst</a></span>
       <small>Compony::Component</small>
@@ -431,7 +439,7 @@
   </li>
   
 
-  <li class="odd ">
+  <li class="even ">
     <div class="item">
       <span class='object_link'><a href="Compony/Component.html#family_name-class_method" title="Compony::Component.family_name (method)">family_name</a></span>
       <small>Compony::Component</small>
@@ -439,7 +447,7 @@
   </li>
   
 
-  <li class="even ">
+  <li class="odd ">
     <div class="item">
       <span class='object_link'><a href="Compony/Component.html#family_name-instance_method" title="Compony::Component#family_name (method)">#family_name</a></span>
       <small>Compony::Component</small>
@@ -447,7 +455,7 @@
   </li>
   
 
-  <li class="odd ">
+  <li class="even ">
     <div class="item">
       <span class='object_link'><a href="Compony.html#family_name_for-class_method" title="Compony.family_name_for (method)">family_name_for</a></span>
       <small>Compony</small>
@@ -455,7 +463,7 @@
   </li>
   
 
-  <li class="even ">
+  <li class="odd ">
     <div class="item">
       <span class='object_link'><a href="Compony/ModelMixin.html#feasibility_messages-instance_method" title="Compony::ModelMixin#feasibility_messages (method)">#feasibility_messages</a></span>
       <small>Compony::ModelMixin</small>
@@ -463,7 +471,7 @@
   </li>
   
 
-  <li class="odd ">
+  <li class="even ">
     <div class="item">
       <span class='object_link'><a href="Compony/ModelMixin.html#feasible%3F-instance_method" title="Compony::ModelMixin#feasible? (method)">#feasible?</a></span>
       <small>Compony::ModelMixin</small>
@@ -471,7 +479,7 @@
   </li>
   
 
-  <li class="even ">
+  <li class="odd ">
     <div class="item">
       <span class='object_link'><a href="Compony/ModelMixin.html#field-instance_method" title="Compony::ModelMixin#field (method)">#field</a></span>
       <small>Compony::ModelMixin</small>
@@ -479,7 +487,7 @@
   </li>
   
 
-  <li class="odd ">
+  <li class="even ">
     <div class="item">
       <span class='object_link'><a href="Compony/Components/Form.html#field-instance_method" title="Compony::Components::Form#field (method)">#field</a></span>
       <small>Compony::Components::Form</small>
@@ -487,7 +495,7 @@
   </li>
   
 
-  <li class="even ">
+  <li class="odd ">
     <div class="item">
       <span class='object_link'><a href="Compony/Components/WithForm.html#form_cancancan_action-instance_method" title="Compony::Components::WithForm#form_cancancan_action (method)">#form_cancancan_action</a></span>
       <small>Compony::Components::WithForm</small>
@@ -495,7 +503,7 @@
   </li>
   
 
-  <li class="odd ">
+  <li class="even ">
     <div class="item">
       <span class='object_link'><a href="Compony/Components/WithForm.html#form_comp-instance_method" title="Compony::Components::WithForm#form_comp (method)">#form_comp</a></span>
       <small>Compony::Components::WithForm</small>
@@ -503,7 +511,7 @@
   </li>
   
 
-  <li class="even ">
+  <li class="odd ">
     <div class="item">
       <span class='object_link'><a href="Compony/Components/WithForm.html#form_comp_class-instance_method" title="Compony::Components::WithForm#form_comp_class (method)">#form_comp_class</a></span>
       <small>Compony::Components::WithForm</small>
@@ -511,7 +519,7 @@
   </li>
   
 
-  <li class="odd ">
+  <li class="even ">
     <div class="item">
       <span class='object_link'><a href="Compony/Components/Form.html#form_fields-instance_method" title="Compony::Components::Form#form_fields (method)">#form_fields</a></span>
       <small>Compony::Components::Form</small>
@@ -519,6 +527,14 @@
   </li>
   
 
+  <li class="odd ">
+    <div class="item">
+      <span class='object_link'><a href="Compony/Components/Form.html#form_params-instance_method" title="Compony::Components::Form#form_params (method)">#form_params</a></span>
+      <small>Compony::Components::Form</small>
+    </div>
+  </li>
+  
+
   <li class="even ">
     <div class="item">
       <span class='object_link'><a href="Compony/ModelMixin.html#full_feasibility_messages-instance_method" title="Compony::ModelMixin#full_feasibility_messages (method)">#full_feasibility_messages</a></span>
@@ -1296,6 +1312,14 @@
   
 
   <li class="odd ">
+    <div class="item">
+      <span class='object_link'><a href="Compony/ComponentMixins/Default/Standalone/StandaloneDsl.html#skip_forgery_protection!-instance_method" title="Compony::ComponentMixins::Default::Standalone::StandaloneDsl#skip_forgery_protection! (method)">#skip_forgery_protection!</a></span>
+      <small>Compony::ComponentMixins::Default::Standalone::StandaloneDsl</small>
+    </div>
+  </li>
+  
+
+  <li class="even ">
     <div class="item">
       <span class='object_link'><a href="Compony/ComponentMixins/Default/Standalone.html#standalone-instance_method" title="Compony::ComponentMixins::Default::Standalone#standalone (method)">#standalone</a></span>
       <small>Compony::ComponentMixins::Default::Standalone</small>
@@ -1303,7 +1327,7 @@
   </li>
   
 
-  <li class="even ">
+  <li class="odd ">
     <div class="item">
       <span class='object_link'><a href="Compony/ComponentMixins/Default/Standalone.html#standalone_access_permitted_for%3F-instance_method" title="Compony::ComponentMixins::Default::Standalone#standalone_access_permitted_for? (method)">#standalone_access_permitted_for?</a></span>
       <small>Compony::ComponentMixins::Default::Standalone</small>
@@ -1311,7 +1335,7 @@
   </li>
   
 
-  <li class="odd ">
+  <li class="even ">
     <div class="item">
       <span class='object_link'><a href="Compony/ComponentMixins/Resourceful.html#store_data-instance_method" title="Compony::ComponentMixins::Resourceful#store_data (method)">#store_data</a></span>
       <small>Compony::ComponentMixins::Resourceful</small>
@@ -1319,7 +1343,7 @@
   </li>
   
 
-  <li class="even ">
+  <li class="odd ">
     <div class="item">
       <span class='object_link'><a href="Compony/ComponentMixins/Default/Standalone/ResourcefulVerbDsl.html#store_data-instance_method" title="Compony::ComponentMixins::Default::Standalone::ResourcefulVerbDsl#store_data (method)">#store_data</a></span>
       <small>Compony::ComponentMixins::Default::Standalone::ResourcefulVerbDsl</small>
@@ -1327,7 +1351,7 @@
   </li>
   
 
-  <li class="odd ">
+  <li class="even ">
     <div class="item">
       <span class='object_link'><a href="Compony/Component.html#sub_comp-instance_method" title="Compony::Component#sub_comp (method)">#sub_comp</a></span>
       <small>Compony::Component</small>
@@ -1335,7 +1359,7 @@
   </li>
   
 
-  <li class="even ">
+  <li class="odd ">
     <div class="item">
       <span class='object_link'><a href="Compony/Components/WithForm.html#submit_path-instance_method" title="Compony::Components::WithForm#submit_path (method)">#submit_path</a></span>
       <small>Compony::Components::WithForm</small>
@@ -1343,7 +1367,7 @@
   </li>
   
 
-  <li class="odd ">
+  <li class="even ">
     <div class="item">
       <span class='object_link'><a href="Compony/Components/WithForm.html#submit_verb-instance_method" title="Compony::Components::WithForm#submit_verb (method)">#submit_verb</a></span>
       <small>Compony::Components::WithForm</small>
@@ -1351,7 +1375,7 @@
   </li>
   
 
-  <li class="even ">
+  <li class="odd ">
     <div class="item">
       <span class='object_link'><a href="Compony/ComponentMixins/Default/Standalone/VerbDsl.html#to_conf-instance_method" title="Compony::ComponentMixins::Default::Standalone::VerbDsl#to_conf (method)">#to_conf</a></span>
       <small>Compony::ComponentMixins::Default::Standalone::VerbDsl</small>
@@ -1359,7 +1383,7 @@
   </li>
   
 
-  <li class="odd ">
+  <li class="even ">
     <div class="item">
       <span class='object_link'><a href="Compony/ComponentMixins/Default/Standalone/StandaloneDsl.html#to_conf-instance_method" title="Compony::ComponentMixins::Default::Standalone::StandaloneDsl#to_conf (method)">#to_conf</a></span>
       <small>Compony::ComponentMixins::Default::Standalone::StandaloneDsl</small>
@@ -1367,7 +1391,7 @@
   </li>
   
 
-  <li class="even ">
+  <li class="odd ">
     <div class="item">
       <span class='object_link'><a href="Compony/ComponentMixins/Default/Standalone/ResourcefulVerbDsl.html#to_conf-instance_method" title="Compony::ComponentMixins::Default::Standalone::ResourcefulVerbDsl#to_conf (method)">#to_conf</a></span>
       <small>Compony::ComponentMixins::Default::Standalone::ResourcefulVerbDsl</small>
@@ -1375,7 +1399,7 @@
   </li>
   
 
-  <li class="odd ">
+  <li class="even ">
     <div class="item">
       <span class='object_link'><a href="Compony/ModelFields/Base.html#transform_and_join-instance_method" title="Compony::ModelFields::Base#transform_and_join (method)">#transform_and_join</a></span>
       <small>Compony::ModelFields::Base</small>
@@ -1383,7 +1407,7 @@
   </li>
   
 
-  <li class="even ">
+  <li class="odd ">
     <div class="item">
       <span class='object_link'><a href="Compony/ModelFields/Url.html#value_for-instance_method" title="Compony::ModelFields::Url#value_for (method)">#value_for</a></span>
       <small>Compony::ModelFields::Url</small>
@@ -1391,7 +1415,7 @@
   </li>
   
 
-  <li class="odd ">
+  <li class="even ">
     <div class="item">
       <span class='object_link'><a href="Compony/ModelFields/Base.html#value_for-instance_method" title="Compony::ModelFields::Base#value_for (method)">#value_for</a></span>
       <small>Compony::ModelFields::Base</small>
@@ -1399,7 +1423,7 @@
   </li>
   
 
-  <li class="even ">
+  <li class="odd ">
     <div class="item">
       <span class='object_link'><a href="Compony/ModelFields/Date.html#value_for-instance_method" title="Compony::ModelFields::Date#value_for (method)">#value_for</a></span>
       <small>Compony::ModelFields::Date</small>
@@ -1407,7 +1431,7 @@
   </li>
   
 
-  <li class="odd ">
+  <li class="even ">
     <div class="item">
       <span class='object_link'><a href="Compony/ModelFields/Color.html#value_for-instance_method" title="Compony::ModelFields::Color#value_for (method)">#value_for</a></span>
       <small>Compony::ModelFields::Color</small>
@@ -1415,7 +1439,7 @@
   </li>
   
 
-  <li class="even ">
+  <li class="odd ">
     <div class="item">
       <span class='object_link'><a href="Compony/ModelFields/Email.html#value_for-instance_method" title="Compony::ModelFields::Email#value_for (method)">#value_for</a></span>
       <small>Compony::ModelFields::Email</small>
@@ -1423,7 +1447,7 @@
   </li>
   
 
-  <li class="odd ">
+  <li class="even ">
     <div class="item">
       <span class='object_link'><a href="Compony/ModelFields/Phone.html#value_for-instance_method" title="Compony::ModelFields::Phone#value_for (method)">#value_for</a></span>
       <small>Compony::ModelFields::Phone</small>
@@ -1431,7 +1455,7 @@
   </li>
   
 
-  <li class="even ">
+  <li class="odd ">
     <div class="item">
       <span class='object_link'><a href="Compony/ModelFields/Boolean.html#value_for-instance_method" title="Compony::ModelFields::Boolean#value_for (method)">#value_for</a></span>
       <small>Compony::ModelFields::Boolean</small>
@@ -1439,7 +1463,7 @@
   </li>
   
 
-  <li class="odd ">
+  <li class="even ">
     <div class="item">
       <span class='object_link'><a href="Compony/ModelFields/Currency.html#value_for-instance_method" title="Compony::ModelFields::Currency#value_for (method)">#value_for</a></span>
       <small>Compony::ModelFields::Currency</small>
@@ -1447,7 +1471,7 @@
   </li>
   
 
-  <li class="even ">
+  <li class="odd ">
     <div class="item">
       <span class='object_link'><a href="Compony/ModelFields/Datetime.html#value_for-instance_method" title="Compony::ModelFields::Datetime#value_for (method)">#value_for</a></span>
       <small>Compony::ModelFields::Datetime</small>
@@ -1455,7 +1479,7 @@
   </li>
   
 
-  <li class="odd ">
+  <li class="even ">
     <div class="item">
       <span class='object_link'><a href="Compony/ModelFields/Attachment.html#value_for-instance_method" title="Compony::ModelFields::Attachment#value_for (method)">#value_for</a></span>
       <small>Compony::ModelFields::Attachment</small>
@@ -1463,7 +1487,7 @@
   </li>
   
 
-  <li class="even ">
+  <li class="odd ">
     <div class="item">
       <span class='object_link'><a href="Compony/ModelFields/Percentage.html#value_for-instance_method" title="Compony::ModelFields::Percentage#value_for (method)">#value_for</a></span>
       <small>Compony::ModelFields::Percentage</small>
@@ -1471,7 +1495,7 @@
   </li>
   
 
-  <li class="odd ">
+  <li class="even ">
     <div class="item">
       <span class='object_link'><a href="Compony/ModelFields/Anchormodel.html#value_for-instance_method" title="Compony::ModelFields::Anchormodel#value_for (method)">#value_for</a></span>
       <small>Compony::ModelFields::Anchormodel</small>
@@ -1479,7 +1503,7 @@
   </li>
   
 
-  <li class="even ">
+  <li class="odd ">
     <div class="item">
       <span class='object_link'><a href="Compony/ModelFields/Association.html#value_for-instance_method" title="Compony::ModelFields::Association#value_for (method)">#value_for</a></span>
       <small>Compony::ModelFields::Association</small>
@@ -1487,7 +1511,7 @@
   </li>
   
 
-  <li class="odd ">
+  <li class="even ">
     <div class="item">
       <span class='object_link'><a href="Compony/ComponentMixins/Default/Standalone/StandaloneDsl.html#verb-instance_method" title="Compony::ComponentMixins::Default::Standalone::StandaloneDsl#verb (method)">#verb</a></span>
       <small>Compony::ComponentMixins::Default::Standalone::StandaloneDsl</small>
@@ -1495,7 +1519,7 @@
   </li>
   
 
-  <li class="even ">
+  <li class="odd ">
     <div class="item">
       <span class='object_link'><a href="Compony.html#with_button_defaults-class_method" title="Compony.with_button_defaults (method)">with_button_defaults</a></span>
       <small>Compony</small>
@@ -1503,7 +1527,7 @@
   </li>
   
 
-  <li class="odd ">
+  <li class="even ">
     <div class="item">
       <span class='object_link'><a href="Compony/Components/Form.html#with_simpleform-instance_method" title="Compony::Components::Form#with_simpleform (method)">#with_simpleform</a></span>
       <small>Compony::Components::Form</small>

data/doc/top-level-namespace.html

@@ -102,7 +102,7 @@
 </div>
 
       <div id="footer">
-  Generated on Wed Nov 20 10:54:24 2024 by
+  Generated on Fri Feb 14 13:24:11 2025 by
   <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.9.37 (ruby-3.3.5).
 </div>

data/lib/compony/component_mixins/default/standalone/standalone_dsl.rb

@@ -17,6 +17,7 @@ module Compony
             @scope_args = scope_args
             @verbs = {}
             @skip_authentication = false
+            @skip_forgery_protection = false
             @layout = true # can be overriden by false or a string
           end
 
@@ -25,16 +26,17 @@ module Compony
             evaluate(&block)
             @component = block.binding.eval('self') # Fetches the component holding this DSL call (via the block)
             return {
-              name:                @name,
-              path:                @path,
-              constraints:         @constraints,
-              scope:               @scope,
-              scope_args:          @scope_args,
-              verbs:               @verbs,
-              rails_action_name:   Compony.rails_action_name(comp_name, family_name, @name),
-              path_helper_name:    Compony.path_helper_name(comp_name, family_name, @name),
-              skip_authentication: @skip_authentication,
-              layout:              @layout
+              name:                    @name,
+              path:                    @path,
+              constraints:             @constraints,
+              scope:                   @scope,
+              scope_args:              @scope_args,
+              verbs:                   @verbs,
+              rails_action_name:       Compony.rails_action_name(comp_name, family_name, @name),
+              path_helper_name:        Compony.path_helper_name(comp_name, family_name, @name),
+              skip_authentication:     @skip_authentication,
+              skip_forgery_protection: @skip_forgery_protection,
+              layout:                  @layout
             }.compact
           end
 
@@ -65,6 +67,12 @@ module Compony
             @skip_authentication = true
           end
 
+          # DSL
+          # Defines that for this component, no forgery protection (CSRF) should be performed.
+          def skip_forgery_protection!
+            @skip_forgery_protection = true
+          end
+
           # DSL
           # Speficies the Rails layout (under `app/views/layouts`) that should be used to render this component.
           # Defaults to Rails' default (`layouts/application`) if the method is never called.