compony 0.5.6 → 0.5.8

data/doc/Compony/ViewHelpers.html

@@ -172,7 +172,7 @@
         <li class="public ">
   <span class="summary_signature">
     
-      <a href="#compony_link-instance_method" title="#compony_link (instance method)">#<strong>compony_link</strong>(comp_name_or_cst_or_class, model_or_family_name_or_cst = nil, *link_args, label: nil, label_opts: {}, params: {}, standalone_name: nil, **link_kwargs)  &#x21d2; Object </a>
+      <a href="#compony_link-instance_method" title="#compony_link (instance method)">#<strong>compony_link</strong>(comp_name_or_cst_or_class, model_or_family_name_or_cst = nil, *link_args, label: nil, label_opts: {}, params: {}, feasibility_action: nil, feasibility_target: nil, standalone_name: nil, **link_kwargs)  &#x21d2; Object </a>
     
 
     
@@ -280,12 +280,12 @@
       <pre class="lines">
 
 
-47
-48
-49</pre>
+54
+55
+56</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/compony/view_helpers.rb', line 47</span>
+      <pre class="code"><span class="info file"># File 'lib/compony/view_helpers.rb', line 54</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_compony_button'>compony_button</span><span class='lparen'>(</span><span class='op'>...</span><span class='rparen'>)</span>
   <span class='const'><span class='object_link'><a href="../Compony.html" title="Compony (module)">Compony</a></span></span><span class='period'>.</span><span class='id identifier rubyid_button'><span class='object_link'><a href="../Compony.html#button-class_method" title="Compony.button (method)">button</a></span></span><span class='lparen'>(</span><span class='op'>...</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_render'>render</span><span class='lparen'>(</span><span class='id identifier rubyid_helpers'>helpers</span><span class='period'>.</span><span class='id identifier rubyid_controller'>controller</span><span class='rparen'>)</span>
@@ -298,7 +298,7 @@
       <div class="method_details ">
   <h3 class="signature " id="compony_link-instance_method">
   
-    #<strong>compony_link</strong>(comp_name_or_cst_or_class, model_or_family_name_or_cst = nil, *link_args, label: nil, label_opts: {}, params: {}, standalone_name: nil, **link_kwargs)  &#x21d2; <tt>Object</tt> 
+    #<strong>compony_link</strong>(comp_name_or_cst_or_class, model_or_family_name_or_cst = nil, *link_args, label: nil, label_opts: {}, params: {}, feasibility_action: nil, feasibility_target: nil, standalone_name: nil, **link_kwargs)  &#x21d2; <tt>Object</tt> 
   
 
   
@@ -429,7 +429,14 @@
 39
 40
 41
-42</pre>
+42
+43
+44
+45
+46
+47
+48
+49</pre>
     </td>
     <td>
       <pre class="code"><span class="info file"># File 'lib/compony/view_helpers.rb', line 22</span>
@@ -440,6 +447,8 @@
                  <span class='label'>label:</span> <span class='kw'>nil</span><span class='comma'>,</span>
                  <span class='label'>label_opts:</span> <span class='lbrace'>{</span><span class='rbrace'>}</span><span class='comma'>,</span>
                  <span class='label'>params:</span> <span class='lbrace'>{</span><span class='rbrace'>}</span><span class='comma'>,</span>
+                 <span class='label'>feasibility_action:</span> <span class='kw'>nil</span><span class='comma'>,</span>
+                 <span class='label'>feasibility_target:</span> <span class='kw'>nil</span><span class='comma'>,</span>
                  <span class='label'>standalone_name:</span> <span class='kw'>nil</span><span class='comma'>,</span>
                  <span class='op'>**</span><span class='id identifier rubyid_link_kwargs'>link_kwargs</span><span class='rparen'>)</span>
   <span class='id identifier rubyid_model'>model</span> <span class='op'>=</span> <span class='id identifier rubyid_model_or_family_name_or_cst'>model_or_family_name_or_cst</span><span class='period'>.</span><span class='id identifier rubyid_respond_to?'>respond_to?</span><span class='lparen'>(</span><span class='symbol'>:model_name</span><span class='rparen'>)</span> <span class='op'>?</span> <span class='id identifier rubyid_model_or_family_name_or_cst'>model_or_family_name_or_cst</span> <span class='op'>:</span> <span class='kw'>nil</span>
@@ -449,11 +458,16 @@
     <span class='id identifier rubyid_target_comp_instance'>target_comp_instance</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='period'>.</span><span class='id identifier rubyid_comp_class_for!'><span class='object_link'><a href="../Compony.html#comp_class_for!-class_method" title="Compony.comp_class_for! (method)">comp_class_for!</a></span></span><span class='lparen'>(</span><span class='id identifier rubyid_comp_name_or_cst_or_class'>comp_name_or_cst_or_class</span><span class='comma'>,</span> <span class='id identifier rubyid_model_or_family_name_or_cst'>model_or_family_name_or_cst</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span><span class='lparen'>(</span><span class='label'>data:</span> <span class='id identifier rubyid_model'>model</span><span class='rparen'>)</span>
   <span class='kw'>end</span>
   <span class='kw'>return</span> <span class='kw'>unless</span> <span class='id identifier rubyid_target_comp_instance'>target_comp_instance</span><span class='period'>.</span><span class='id identifier rubyid_standalone_access_permitted_for?'>standalone_access_permitted_for?</span><span class='lparen'>(</span><span class='kw'>self</span><span class='comma'>,</span> <span class='label'>standalone_name:</span><span class='rparen'>)</span>
-  <span class='kw'>return</span> <span class='id identifier rubyid_helpers'>helpers</span><span class='period'>.</span><span class='id identifier rubyid_link_to'>link_to</span><span class='lparen'>(</span>
-    <span class='id identifier rubyid_label'>label</span> <span class='op'>||</span> <span class='id identifier rubyid_target_comp_instance'>target_comp_instance</span><span class='period'>.</span><span class='id identifier rubyid_label'>label</span><span class='lparen'>(</span><span class='id identifier rubyid_model'>model</span><span class='comma'>,</span> <span class='op'>**</span><span class='id identifier rubyid_label_opts'>label_opts</span><span class='rparen'>)</span><span class='comma'>,</span>
-    <span class='const'><span class='object_link'><a href="../Compony.html" title="Compony (module)">Compony</a></span></span><span class='period'>.</span><span class='id identifier rubyid_path'><span class='object_link'><a href="../Compony.html#path-class_method" title="Compony.path (method)">path</a></span></span><span class='lparen'>(</span><span class='id identifier rubyid_target_comp_instance'>target_comp_instance</span><span class='period'>.</span><span class='id identifier rubyid_comp_name'>comp_name</span><span class='comma'>,</span> <span class='id identifier rubyid_target_comp_instance'>target_comp_instance</span><span class='period'>.</span><span class='id identifier rubyid_family_name'>family_name</span><span class='comma'>,</span> <span class='id identifier rubyid_model'>model</span><span class='comma'>,</span> <span class='label'>standalone_name:</span><span class='comma'>,</span> <span class='op'>**</span><span class='id identifier rubyid_params'>params</span><span class='rparen'>)</span><span class='comma'>,</span>
-    <span class='op'>*</span><span class='id identifier rubyid_link_args'>link_args</span><span class='comma'>,</span> <span class='op'>**</span><span class='id identifier rubyid_link_kwargs'>link_kwargs</span>
-  <span class='rparen'>)</span>
+  <span class='id identifier rubyid_feasibility_action'>feasibility_action</span> <span class='op'>||=</span> <span class='id identifier rubyid_comp_name_or_cst_or_class'>comp_name_or_cst_or_class</span><span class='period'>.</span><span class='id identifier rubyid_to_s'>to_s</span><span class='period'>.</span><span class='id identifier rubyid_underscore'>underscore</span><span class='period'>.</span><span class='id identifier rubyid_to_sym'>to_sym</span>
+  <span class='id identifier rubyid_feasibility_target'>feasibility_target</span> <span class='op'>||=</span> <span class='id identifier rubyid_model'>model</span>
+  <span class='id identifier rubyid_label'>label</span> <span class='op'>||=</span> <span class='id identifier rubyid_target_comp_instance'>target_comp_instance</span><span class='period'>.</span><span class='id identifier rubyid_label'>label</span><span class='lparen'>(</span><span class='id identifier rubyid_model'>model</span><span class='comma'>,</span> <span class='op'>**</span><span class='id identifier rubyid_label_opts'>label_opts</span><span class='rparen'>)</span>
+  <span class='id identifier rubyid_path'>path</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='period'>.</span><span class='id identifier rubyid_path'><span class='object_link'><a href="../Compony.html#path-class_method" title="Compony.path (method)">path</a></span></span><span class='lparen'>(</span><span class='id identifier rubyid_target_comp_instance'>target_comp_instance</span><span class='period'>.</span><span class='id identifier rubyid_comp_name'>comp_name</span><span class='comma'>,</span> <span class='id identifier rubyid_target_comp_instance'>target_comp_instance</span><span class='period'>.</span><span class='id identifier rubyid_family_name'>family_name</span><span class='comma'>,</span> <span class='id identifier rubyid_model'>model</span><span class='comma'>,</span> <span class='label'>standalone_name:</span><span class='comma'>,</span> <span class='op'>**</span><span class='id identifier rubyid_params'>params</span><span class='rparen'>)</span>
+  <span class='kw'>if</span> <span class='id identifier rubyid_feasibility_target'>feasibility_target</span> <span class='op'>&amp;&amp;</span> <span class='op'>!</span><span class='id identifier rubyid_feasibility_target'>feasibility_target</span><span class='period'>.</span><span class='id identifier rubyid_feasible?'>feasible?</span><span class='lparen'>(</span><span class='id identifier rubyid_feasibility_action'>feasibility_action</span><span class='rparen'>)</span>
+    <span class='id identifier rubyid_path'>path</span> <span class='op'>=</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>#</span><span class='tstring_end'>&#39;</span></span>
+    <span class='id identifier rubyid_link_kwargs'>link_kwargs</span><span class='lbracket'>[</span><span class='symbol'>:class</span><span class='rbracket'>]</span> <span class='op'>=</span> <span class='id identifier rubyid_link_kwargs'>link_kwargs</span><span class='lbracket'>[</span><span class='symbol'>:class</span><span class='rbracket'>]</span><span class='period'>.</span><span class='id identifier rubyid_is_a?'>is_a?</span><span class='lparen'>(</span><span class='const'>String</span><span class='rparen'>)</span> <span class='op'>?</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_link_kwargs'>link_kwargs</span><span class='lbracket'>[</span><span class='symbol'>:class</span><span class='rbracket'>]</span><span class='embexpr_end'>}</span><span class='tstring_content'> disabled</span><span class='tstring_end'>&quot;</span></span> <span class='op'>:</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>disabled</span><span class='tstring_end'>&#39;</span></span>
+    <span class='id identifier rubyid_link_kwargs'>link_kwargs</span><span class='lbracket'>[</span><span class='symbol'>:title</span><span class='rbracket'>]</span> <span class='op'>=</span> <span class='id identifier rubyid_feasibility_target'>feasibility_target</span><span class='period'>.</span><span class='id identifier rubyid_full_feasibility_messages'>full_feasibility_messages</span><span class='lparen'>(</span><span class='id identifier rubyid_feasibility_action'>feasibility_action</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_presence'>presence</span>
+  <span class='kw'>end</span>
+  <span class='kw'>return</span> <span class='id identifier rubyid_helpers'>helpers</span><span class='period'>.</span><span class='id identifier rubyid_link_to'>link_to</span><span class='lparen'>(</span><span class='id identifier rubyid_label'>label</span><span class='comma'>,</span> <span class='id identifier rubyid_path'>path</span><span class='comma'>,</span> <span class='op'>*</span><span class='id identifier rubyid_link_args'>link_args</span><span class='comma'>,</span> <span class='op'>**</span><span class='id identifier rubyid_link_kwargs'>link_kwargs</span><span class='rparen'>)</span>
 <span class='kw'>end</span></pre>
     </td>
   </tr>
@@ -465,7 +479,7 @@
 </div>
 
       <div id="footer">
-  Generated on Thu Jul 10 11:04:51 2025 by
+  Generated on Thu Aug 28 14:18:36 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/Compony.html

@@ -2206,7 +2206,7 @@
 </div>
 
       <div id="footer">
-  Generated on Thu Jul 10 11:04:51 2025 by
+  Generated on Thu Aug 28 14:18:36 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/ComponyController.html

@@ -114,7 +114,7 @@
 </div>
 
       <div id="footer">
-  Generated on Thu Jul 10 11:04:51 2025 by
+  Generated on Thu Aug 28 14:18:37 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

@@ -566,7 +566,7 @@
 </div>
 
       <div id="footer">
-  Generated on Thu Jul 10 11:04:48 2025 by
+  Generated on Thu Aug 28 14:18:34 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/file.README.html

@@ -1272,18 +1272,20 @@ my_button = Compony.button(:index, :users, enabled: -> { |controller| control
 <span class='kw'>end</span>
 </code></pre>
 
-<p><strong>Note that the feasibility framework currently only affects buttons pointing to actions, not the action itself.</strong> If a user were to issue the HTTP call manually, the component happily responds and performs the action. This is why you should always back important preventions with an appropriate Rails model validation:</p>
+<p><strong>Note that the feasibility framework currently only affects buttons/links pointing to actions, not the action itself.</strong> If a user were to issue the HTTP call manually, the component happily responds and performs the action. This is why you should always back important preventions with an appropriate Rails model validation:</p>
 <ul><li>
 <p>The Rails model validation prevents that invalid data can be saved to the database.</p>
 </li><li>
-<p>The feasibility framework disables buttons and explains to guide the user.</p>
+<p>The feasibility framework disables buttons and links and explains to guide the user.</p>
+</li><li>
+<p>Links are disabled by changing the href to <code>&#39;#&#39;</code> and adding the <code>.disabled</code> class, which is useful when bootstrap is used.</p>
 </li><li>
 <p>Authorization is orthogonal to this, limiting the actions of a specific user.</p>
 </li><li>
 <p>If an action is both prevented and not authorized, the authorization “wins” and the action button is not shown at all.</p>
 </li></ul>
 
-<p>Compony has a feature that auto-detects feasibility. In particular, it checks for <code>dependent</code> relations in the <code>has_one</code>/<code>has_many</code> relations and disables delete buttons that point to objects that have dependent objects that cannot automatically be destroyed.</p>
+<p>Compony has a feature that auto-detects feasibility of some actions. In particular, it checks for <code>dependent</code> relations in the <code>has_one</code>/<code>has_many</code> relations and disables delete buttons that point to objects that have dependent objects that cannot automatically be destroyed.</p>
 
 <p>To disable auto detection, call <code>skip_autodetect_feasibilities</code> in your model.</p>
 
@@ -1632,6 +1634,26 @@ my_button = Compony.button(:index, :users, enabled: -&gt; { |controller| control
 <p><code>rails g components Users</code> will generate a set of the most used components.</p>
 </li></ul>
 
+<h3 id="label-Support+for+custom+base+components">Support for custom base components</h3>
+
+<p>If your application has many components that share the same functionality, it may be a good idea to create a custom base component, which acts as an abstract class.</p>
+
+<p>Examples:</p>
+<ul><li>
+<p>Perhaps you have code shared in all of your <code>New</code> components. In this case, create <code>BaseComponents::New</code> and inherit from <code>Compony::Components::New</code>. In <code>setup</code> of your base component, you can now perform all the configurations needed. Now you may inherit from it: <code>class Components::Users::New &lt; BaseComponents::New</code>.</p>
+</li><li>
+<p>Perhaps you often implement the same kind of component, for instance an index component displaying a filterable list. In this case, create <code>BaseComponents::Index</code> and inherit as follows: <code>class Components::Users::Index &lt; BaseComponents::Index</code>.</p>
+</li></ul>
+
+<p>Compony has the following convention:</p>
+<ul><li>
+<p>implement a custom base component in the directory <code>app/compony/base_components/your_component.rb</code></p>
+</li><li>
+<p>name the class <code>BaseComponents::YourComponent</code> where <code>BaseComponents</code> is typically a module simple meant for namespacing</p>
+</li></ul>
+
+<p>When respecting these conventions, compony’s generators will automatically make generated classes inherit from the suitable base component if one is available. In the example above, <code>rails g component Users::Index</code> will automatically make the generated class inherit from <code>BaseComponent::Index</code>.</p>
+
 <h2 id="label-Internal+datastructures">Internal datastructures</h2>
 
 <p>Compony has a few internal data structures that are worth mentioning. Especially when building your own UI framework on top of Compony, these might come in handy.</p>
@@ -1730,7 +1752,7 @@ my_button = Compony.button(:index, :users, enabled: -&gt; { |controller| control
 </div></div>
 
       <div id="footer">
-  Generated on Thu Jul 10 11:04:50 2025 by
+  Generated on Thu Aug 28 14:18:36 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

@@ -1272,18 +1272,20 @@ my_button = Compony.button(:index, :users, enabled: -> { |controller| control
 <span class='kw'>end</span>
 </code></pre>
 
-<p><strong>Note that the feasibility framework currently only affects buttons pointing to actions, not the action itself.</strong> If a user were to issue the HTTP call manually, the component happily responds and performs the action. This is why you should always back important preventions with an appropriate Rails model validation:</p>
+<p><strong>Note that the feasibility framework currently only affects buttons/links pointing to actions, not the action itself.</strong> If a user were to issue the HTTP call manually, the component happily responds and performs the action. This is why you should always back important preventions with an appropriate Rails model validation:</p>
 <ul><li>
 <p>The Rails model validation prevents that invalid data can be saved to the database.</p>
 </li><li>
-<p>The feasibility framework disables buttons and explains to guide the user.</p>
+<p>The feasibility framework disables buttons and links and explains to guide the user.</p>
+</li><li>
+<p>Links are disabled by changing the href to <code>&#39;#&#39;</code> and adding the <code>.disabled</code> class, which is useful when bootstrap is used.</p>
 </li><li>
 <p>Authorization is orthogonal to this, limiting the actions of a specific user.</p>
 </li><li>
 <p>If an action is both prevented and not authorized, the authorization “wins” and the action button is not shown at all.</p>
 </li></ul>
 
-<p>Compony has a feature that auto-detects feasibility. In particular, it checks for <code>dependent</code> relations in the <code>has_one</code>/<code>has_many</code> relations and disables delete buttons that point to objects that have dependent objects that cannot automatically be destroyed.</p>
+<p>Compony has a feature that auto-detects feasibility of some actions. In particular, it checks for <code>dependent</code> relations in the <code>has_one</code>/<code>has_many</code> relations and disables delete buttons that point to objects that have dependent objects that cannot automatically be destroyed.</p>
 
 <p>To disable auto detection, call <code>skip_autodetect_feasibilities</code> in your model.</p>
 
@@ -1632,6 +1634,26 @@ my_button = Compony.button(:index, :users, enabled: -&gt; { |controller| control
 <p><code>rails g components Users</code> will generate a set of the most used components.</p>
 </li></ul>
 
+<h3 id="label-Support+for+custom+base+components">Support for custom base components</h3>
+
+<p>If your application has many components that share the same functionality, it may be a good idea to create a custom base component, which acts as an abstract class.</p>
+
+<p>Examples:</p>
+<ul><li>
+<p>Perhaps you have code shared in all of your <code>New</code> components. In this case, create <code>BaseComponents::New</code> and inherit from <code>Compony::Components::New</code>. In <code>setup</code> of your base component, you can now perform all the configurations needed. Now you may inherit from it: <code>class Components::Users::New &lt; BaseComponents::New</code>.</p>
+</li><li>
+<p>Perhaps you often implement the same kind of component, for instance an index component displaying a filterable list. In this case, create <code>BaseComponents::Index</code> and inherit as follows: <code>class Components::Users::Index &lt; BaseComponents::Index</code>.</p>
+</li></ul>
+
+<p>Compony has the following convention:</p>
+<ul><li>
+<p>implement a custom base component in the directory <code>app/compony/base_components/your_component.rb</code></p>
+</li><li>
+<p>name the class <code>BaseComponents::YourComponent</code> where <code>BaseComponents</code> is typically a module simple meant for namespacing</p>
+</li></ul>
+
+<p>When respecting these conventions, compony’s generators will automatically make generated classes inherit from the suitable base component if one is available. In the example above, <code>rails g component Users::Index</code> will automatically make the generated class inherit from <code>BaseComponent::Index</code>.</p>
+
 <h2 id="label-Internal+datastructures">Internal datastructures</h2>
 
 <p>Compony has a few internal data structures that are worth mentioning. Especially when building your own UI framework on top of Compony, these might come in handy.</p>
@@ -1730,7 +1752,7 @@ my_button = Compony.button(:index, :users, enabled: -&gt; { |controller| control
 </div></div>
 
       <div id="footer">
-  Generated on Thu Jul 10 11:04:49 2025 by
+  Generated on Thu Aug 28 14:18:35 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

@@ -232,14 +232,6 @@
   
 
   <li class="even ">
-    <div class="item">
-      <span class='object_link'><a href="Compony/Component.html#comp_cst-instance_method" title="Compony::Component#comp_cst (method)">#comp_cst</a></span>
-      <small>Compony::Component</small>
-    </div>
-  </li>
-  
-
-  <li class="odd ">
     <div class="item">
       <span class='object_link'><a href="Compony/Component.html#comp_name-class_method" title="Compony::Component.comp_name (method)">comp_name</a></span>
       <small>Compony::Component</small>
@@ -247,14 +239,6 @@
   </li>
   
 
-  <li class="even ">
-    <div class="item">
-      <span class='object_link'><a href="Compony/Component.html#comp_name-instance_method" title="Compony::Component#comp_name (method)">#comp_name</a></span>
-      <small>Compony::Component</small>
-    </div>
-  </li>
-  
-
   <li class="odd ">
     <div class="item">
       <span class='object_link'><a href="Compony/Component.html#comp_opts-instance_method" title="Compony::Component#comp_opts (method)">#comp_opts</a></span>
@@ -432,14 +416,6 @@
   
 
   <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>
-    </div>
-  </li>
-  
-
-  <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>
@@ -447,14 +423,6 @@
   </li>
   
 
-  <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>
-    </div>
-  </li>
-  
-
   <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>

data/doc/top-level-namespace.html

@@ -102,7 +102,7 @@
 </div>
 
       <div id="footer">
-  Generated on Thu Jul 10 11:04:50 2025 by
+  Generated on Thu Aug 28 14:18:36 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.rb

@@ -113,24 +113,16 @@ module Compony
     end
 
     # Returns the name of the module constant (=family) of this component. Do not override.
-    def family_cst
-      self.class.family_cst
-    end
+    delegate :family_cst, to: :class
 
     # Returns the family name
-    def family_name
-      self.class.family_name
-    end
+    delegate :family_name, to: :class
 
     # Returns the name of the class constant of this component. Do not override.
-    def comp_cst
-      self.class.comp_cst
-    end
+    delegate :comp_cst, to: :class
 
     # Returns the component name
-    def comp_name
-      self.class.comp_name
-    end
+    delegate :comp_name, to: :class
 
     # DSL method
     # Adds or overrides a before_render block.
@@ -160,7 +152,7 @@ module Compony
     # DSL method
     # Removes a content block. Use this in subclasses if a content block defined in the parent should be removed from the child.
     # @param [Symbol,String] name Name of the content block that should be removed
-    def remove_content(name)
+    def remove_content(name) # rubocop:disable Naming/PredicateMethod
       existing_index = @content_blocks.find_index { |el| el.name == name.to_sym }
       if existing_index.nil?
         return false

data/lib/compony/components/edit.rb

@@ -4,6 +4,7 @@ module Compony
     # This component is used for the Rails edit and update paradigm. Performs update when the form is submitted.
     class Edit < Compony::Components::WithForm
       include Compony::ComponentMixins::Resourceful
+
       setup do
         submit_verb :patch
         standalone path: "#{family_name}/:id/edit" do
@@ -77,7 +78,7 @@ module Compony
           elsif data_class.owner_model_attr.present?
             Compony.path(:show, @data.send(data_class.owner_model_attr))
           else
-            Compony.path(:index, @data)
+            Compony.path(:index, family_cst)
           end
         end
 

data/lib/compony/components/new.rb

@@ -69,7 +69,7 @@ module Compony
           elsif data_class.owner_model_attr.present?
             Compony.path(:show, @data.send(data_class.owner_model_attr))
           else
-            Compony.path(:index, @data)
+            Compony.path(:index, family_cst)
           end
         end
 

data/lib/compony/model_fields/rich_text.rb

@@ -2,7 +2,7 @@ module Compony
   module ModelFields
     class RichText < Base
       def simpleform_input(form, _component, name: nil, **input_opts)
-        return form.input name || @name, **input_opts.merge(as: :rich_text_area)
+        return form.input name || @name, **input_opts, as: :rich_text_area
       end
     end
   end

data/lib/compony/request_context.rb

@@ -43,7 +43,7 @@ module Compony
     end
 
     # Renders a content block from the current component.
-    def content(name)
+    def content(name) # rubocop:disable Naming/PredicateMethod
       name = name.to_sym
       content_block = component.content_blocks.find { |el| el.name == name }
       return false if content_block.nil?

data/lib/compony/view_helpers.rb

@@ -25,6 +25,8 @@ module Compony
                      label: nil,
                      label_opts: {},
                      params: {},
+                     feasibility_action: nil,
+                     feasibility_target: nil,
                      standalone_name: nil,
                      **link_kwargs)
       model = model_or_family_name_or_cst.respond_to?(:model_name) ? model_or_family_name_or_cst : nil
@@ -34,11 +36,16 @@ module Compony
         target_comp_instance = Compony.comp_class_for!(comp_name_or_cst_or_class, model_or_family_name_or_cst).new(data: model)
       end
       return unless target_comp_instance.standalone_access_permitted_for?(self, standalone_name:)
-      return helpers.link_to(
-        label || target_comp_instance.label(model, **label_opts),
-        Compony.path(target_comp_instance.comp_name, target_comp_instance.family_name, model, standalone_name:, **params),
-        *link_args, **link_kwargs
-      )
+      feasibility_action ||= comp_name_or_cst_or_class.to_s.underscore.to_sym
+      feasibility_target ||= model
+      label ||= target_comp_instance.label(model, **label_opts)
+      path ||= Compony.path(target_comp_instance.comp_name, target_comp_instance.family_name, model, standalone_name:, **params)
+      if feasibility_target && !feasibility_target.feasible?(feasibility_action)
+        path = '#'
+        link_kwargs[:class] = link_kwargs[:class].is_a?(String) ? "#{link_kwargs[:class]} disabled" : 'disabled'
+        link_kwargs[:title] = feasibility_target.full_feasibility_messages(feasibility_action).presence
+      end
+      return helpers.link_to(label, path, *link_args, **link_kwargs)
     end
 
     # Given a component and a family/model, this instanciates and renders a button component.

data/lib/generators/component/component_generator.rb

@@ -10,6 +10,13 @@ class ComponentGenerator < Rails::Generators::NamedBase
     @comp_cst = @comp.camelize # Tolerate singular and plural
     @args = args
 
+    # If BaseComponents::ComponentAboutToBeGenerated is present, inherit from that
+    if defined?(BaseComponents.const_defined?(@comp_cst))
+      @parent_base_component_class = BaseComponents.const_get(@comp_cst)
+      template 'with_base_component.rb.erb', "app/components/#{@family}/#{@comp}.rb"
+      return
+    end
+    # If a Compony component with the specified name exists, inherit from that
     case @comp_cst
     when 'Destroy'
       template 'destroy.rb.erb', "app/components/#{@family}/#{@comp}.rb"
@@ -20,6 +27,7 @@ class ComponentGenerator < Rails::Generators::NamedBase
     when 'New'
       template 'new.rb.erb', "app/components/#{@family}/#{@comp}.rb"
     else
+      # Inherit from regular component
       template 'component.rb.erb', "app/components/#{@family}/#{@comp}.rb"
     end
   end

data/lib/generators/component/templates/with_base_component.rb.erb

@@ -0,0 +1,4 @@
+class Components::<%= @family_cst %>::<%= @comp_cst %> < <%= @parent_base_component_class %>
+  setup do
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: compony
 version: !ruby/object:Gem::Version
-  version: 0.5.6
+  version: 0.5.8
 platform: ruby
 authors:
 - Sandro Kalbermatter
@@ -306,6 +306,7 @@ files:
 - lib/generators/component/templates/edit.rb.erb
 - lib/generators/component/templates/form.rb.erb
 - lib/generators/component/templates/new.rb.erb
+- lib/generators/component/templates/with_base_component.rb.erb
 - lib/generators/components/USAGE
 - lib/generators/components/components_generator.rb
 - logo.svg