compony 0.11.11 → 0.11.13

data/doc/file.gotchas.html

@@ -60,20 +60,20 @@
       <div id="content"><div id='filecontents'>
 <p><a href="/README_md.html#guide--documentation">Back to the guide</a></p>
 
-<h1 id="label-Gotchas+-2F+anti-patterns">Gotchas / anti-patterns</h1>
+<h1 id="gotchas--anti-patterns">Gotchas / anti-patterns</h1>
 
 <p>Known footguns, each with <strong>symptom → cause → fix</strong>. Skim before debugging.</p>
 
-<h3 id="label-1.+standalone+without+an+explicit+path-3A">1. <code>standalone</code> without an explicit <code>path:</code></h3>
+<h3 id="1-standalone-without-an-explicit-path">1. <code>standalone</code> without an explicit <code>path:</code></h3>
 <ul><li>
 <p><strong>Symptom:</strong> <code>undefined method &#39;..._comp_path&#39;</code>, or no route generated for the component.</p>
 </li><li>
 <p><strong>Cause:</strong> <code>standalone</code> only emits a route when a <code>path:</code> is given.</p>
 </li><li>
-<p><strong>Fix:</strong> Always pass <code>standalone path: &#39;users/show/:id&#39; do ... end</code>. A component with no  standalone is valid but must be nested in another component (has no URL).</p>
+<p><strong>Fix:</strong> Always pass <code>standalone path: &#39;users/show/:id&#39; do ... end</code>. A component with no standalone is valid but must be nested in another component (has no URL).</p>
 </li></ul>
 
-<h3 id="label-2.+render_intent+-2F+render_sub_comp+output+not+appearing">2. <code>render_intent</code> / <code>render_sub_comp</code> output not appearing</h3>
+<h3 id="2-renderintent--rendersubcomp-output-not-appearing">2. <code>render_intent</code> / <code>render_sub_comp</code> output not appearing</h3>
 <ul><li>
 <p><strong>Symptom:</strong> The button/list silently missing from the rendered page.</p>
 </li><li>
@@ -82,25 +82,25 @@
 <p><strong>Fix:</strong> Wrap it: <code>concat render_intent(:edit, user)</code> (Dyny’s equivalent of <code>&lt;%= %&gt;</code>).</p>
 </li></ul>
 
-<h3 id="label-3.+Overriding+respond+skips+authorization">3. Overriding <code>respond</code> skips authorization</h3>
+<h3 id="3-overriding-respond-skips-authorization">3. Overriding <code>respond</code> skips authorization</h3>
 <ul><li>
 <p><strong>Symptom:</strong> An endpoint is reachable without the expected permission check.</p>
 </li><li>
-<p><strong>Cause:</strong> <code>authorize</code> is evaluated inside the <em>default</em> <code>respond</code>. A custom <code>respond</code>  (especially the <code>nil</code>/all-formats one) replaces it.</p>
+<p><strong>Cause:</strong> <code>authorize</code> is evaluated inside the <em>default</em> <code>respond</code>. A custom <code>respond</code> (especially the <code>nil</code>/all-formats one) replaces it.</p>
 </li><li>
-<p><strong>Fix:</strong> Re-check authorization yourself inside the custom <code>respond</code>, or keep a separate  default <code>respond</code> for the relevant format.</p>
+<p><strong>Fix:</strong> Re-check authorization yourself inside the custom <code>respond</code>, or keep a separate default <code>respond</code> for the relevant format.</p>
 </li></ul>
 
-<h3 id="label-4.+schema_field+with+the+foreign+key+name">4. <code>schema_field</code> with the foreign key name</h3>
+<h3 id="4-schemafield-with-the-foreign-key-name">4. <code>schema_field</code> with the foreign key name</h3>
 <ul><li>
 <p><strong>Symptom:</strong> Association param rejected by Schemacop / not assigned.</p>
 </li><li>
 <p><strong>Cause:</strong> Compony adds <code>_id</code> for associations automatically.</p>
 </li><li>
-<p><strong>Fix:</strong> Use the <strong>association name</strong>: <code>schema_field :author</code>, not <code>schema_field :author_id</code>.  Same for <code>field :author</code> in <code>form_fields</code>.</p>
+<p><strong>Fix:</strong> Use the <strong>association name</strong>: <code>schema_field :author</code>, not <code>schema_field :author_id</code>. Same for <code>field :author</code> in <code>form_fields</code>.</p>
 </li></ul>
 
-<h3 id="label-5.+Model+without+label">5. Model without <code>label</code></h3>
+<h3 id="5-model-without-label">5. Model without <code>label</code></h3>
 <ul><li>
 <p><strong>Symptom:</strong> Errors or blank text when Compony renders titles/links for the model.</p>
 </li><li>
@@ -109,16 +109,16 @@
 <p><strong>Fix:</strong> Implement <code>def label</code> on every Compony model (or have a <code>label</code> column).</p>
 </li></ul>
 
-<h3 id="label-6.+Forgetting+to+forward+args+in+a+custom+initialize">6. Forgetting to forward args in a custom <code>initialize</code></h3>
+<h3 id="6-forgetting-to-forward-args-in-a-custom-initialize">6. Forgetting to forward args in a custom <code>initialize</code></h3>
 <ul><li>
 <p><strong>Symptom:</strong> <code>parent_comp</code>, <code>@data</code>, comp opts mysteriously <code>nil</code>; nesting broken.</p>
 </li><li>
 <p><strong>Cause:</strong> The base initializer wires essential state. Skipping <code>super</code> drops it.</p>
 </li><li>
-<p><strong>Fix:</strong> Call <code>super(*args, **kwargs, &amp;block)</code> first, then set your own ivars. Prefer  putting logic in <code>setup</code> instead of overriding <code>initialize</code>.</p>
+<p><strong>Fix:</strong> Call <code>super(*args, **kwargs, &amp;block)</code> first, then set your own ivars. Prefer putting logic in <code>setup</code> instead of overriding <code>initialize</code>.</p>
 </li></ul>
 
-<h3 id="label-7.+Reading+a+label+without+its+block+argument">7. Reading a label without its block argument</h3>
+<h3 id="7-reading-a-label-without-its-block-argument">7. Reading a label without its block argument</h3>
 <ul><li>
 <p><strong>Symptom:</strong> <code>wrong number of arguments</code> from a label block.</p>
 </li><li>
@@ -127,7 +127,7 @@
 <p><strong>Fix:</strong> <code>label(User.first)</code> for resourceful; <code>label</code> (no arg) otherwise. At most one arg.</p>
 </li></ul>
 
-<h3 id="label-8.+content+-3Aname+inside+a+block+tries+to+render+another+component-27s+block">8. <code>content :name</code> inside a block tries to render another component’s block</h3>
+<h3 id="8-content-name-inside-a-block-tries-to-render-another-components-block">8. <code>content :name</code> inside a block tries to render another component’s block</h3>
 <ul><li>
 <p><strong>Symptom:</strong> Content block not found / unexpected output.</p>
 </li><li>
@@ -136,25 +136,25 @@
 <p><strong>Fix:</strong> To embed another component use <code>render_sub_comp</code>, not nested <code>content</code>.</p>
 </li></ul>
 
-<h3 id="label-9.+Multiple+pages+in+one+component">9. Multiple pages in one component</h3>
+<h3 id="9-multiple-pages-in-one-component">9. Multiple pages in one component</h3>
 <ul><li>
 <p><strong>Symptom:</strong> Tangled <code>standalone</code>/<code>verb</code>/<code>respond</code> tree, confusing routes.</p>
 </li><li>
-<p><strong>Cause:</strong> Extra <code>standalone</code> calls are for <em>companion</em> endpoints (AJAX tiles, autocomplete  JSON) of the <em>same</em> screen — not for separate pages.</p>
+<p><strong>Cause:</strong> Extra <code>standalone</code> calls are for <em>companion</em> endpoints (AJAX tiles, autocomplete JSON) of the <em>same</em> screen — not for separate pages.</p>
 </li><li>
-<p><strong>Fix:</strong> One screen = one component exposing one main route. Make another component for  another page.</p>
+<p><strong>Fix:</strong> One screen = one component exposing one main route. Make another component for another page.</p>
 </li></ul>
 
-<h3 id="label-10.+Resourceful+component+on+a+path+without+-3Aid">10. Resourceful component on a path without <code>:id</code></h3>
+<h3 id="10-resourceful-component-on-a-path-without-id">10. Resourceful component on a path without <code>:id</code></h3>
 <ul><li>
 <p><strong>Symptom:</strong> <code>Couldn&#39;t find &lt;Model&gt; without an ID</code> (e.g. an Index at <code>/users</code>).</p>
 </li><li>
 <p><strong>Cause:</strong> Default <code>load_data</code> does <code>data_class.find(params[:id])</code>.</p>
 </li><li>
-<p><strong>Fix:</strong> Override <code>load_data { @data = User.all }</code> (or your scope) for collection/index  components.</p>
+<p><strong>Fix:</strong> Override <code>load_data { @data = User.all }</code> (or your scope) for collection/index components.</p>
 </li></ul>
 
-<h3 id="label-11.+redirect_to+with+a+hardcoded+path">11. <code>redirect_to</code> with a hardcoded path</h3>
+<h3 id="11-redirectto-with-a-hardcoded-path">11. <code>redirect_to</code> with a hardcoded path</h3>
 <ul><li>
 <p><strong>Symptom:</strong> Links break after renaming/moving a component.</p>
 </li><li>
@@ -163,56 +163,56 @@
 <p><strong>Fix:</strong> Use <code>redirect_to Compony.path(:index, :users)</code> / <code>Compony.path(:show, @data)</code>.</p>
 </li></ul>
 
-<h3 id="label-12.+ActiveStorage+attachment+on+a+virtual+model">12. ActiveStorage attachment on a virtual model</h3>
+<h3 id="12-activestorage-attachment-on-a-virtual-model">12. ActiveStorage attachment on a virtual model</h3>
 <ul><li>
 <p><strong>Symptom:</strong> Uploaded file not persisted for a <code>Compony::VirtualModel</code>.</p>
 </li><li>
-<p><strong>Cause:</strong> Virtual models aren’t backed by a real table; the default <code>store_data</code> save  doesn’t persist attachments.</p>
+<p><strong>Cause:</strong> Virtual models aren’t backed by a real table; the default <code>store_data</code> save doesn’t persist attachments.</p>
 </li><li>
-<p><strong>Fix:</strong> Override <code>store_data</code> to only validate (<code>@create_succeeded = @data.validate</code>) and  perform the real mutation/attachment in <code>on_created_respond</code>. See  <a href="/doc/guide/virtual_models_md.html">virtual_models.md</a>.</p>
+<p><strong>Fix:</strong> Override <code>store_data</code> to only validate (<code>@create_succeeded = @data.validate</code>) and perform the real mutation/attachment in <code>on_created_respond</code>. See <a href="/doc/guide/virtual_models_md.html">virtual_models.md</a>.</p>
 </li></ul>
 
-<h3 id="label-13.+tailwindcss-rails+purges+Compony+styles">13. <code>tailwindcss-rails</code> purges Compony styles</h3>
+<h3 id="13-tailwindcss-rails-purges-compony-styles">13. <code>tailwindcss-rails</code> purges Compony styles</h3>
 <ul><li>
 <p><strong>Symptom:</strong> Compony component markup unstyled in production.</p>
 </li><li>
-<p><strong>Cause:</strong> Tailwind’s unused-CSS purge doesn’t scan component classes (their HTML isn’t in  <code>app/views</code>).</p>
+<p><strong>Cause:</strong> Tailwind’s unused-CSS purge doesn’t scan component classes (their HTML isn’t in <code>app/views</code>).</p>
 </li><li>
-<p><strong>Fix:</strong> Safelist the classes, or don’t use <code>tailwindcss-rails</code> with Compony (see  README “Caveats”).</p>
+<p><strong>Fix:</strong> Safelist the classes, or don’t use <code>tailwindcss-rails</code> with Compony (see README “Caveats”).</p>
 </li></ul>
 
-<h3 id="label-14.+Public+endpoint+still+401-2Fredirecting">14. Public endpoint still 401/redirecting</h3>
+<h3 id="14-public-endpoint-still-401redirecting">14. Public endpoint still 401/redirecting</h3>
 <ul><li>
 <p><strong>Symptom:</strong> Webhook/public action blocked by app auth or CSRF.</p>
 </li><li>
-<p><strong>Cause:</strong> <code>skip_authentication!</code> alone doesn’t remove CSRF, and <code>authorize</code> is still  mandatory.</p>
+<p><strong>Cause:</strong> <code>skip_authentication!</code> alone doesn’t remove CSRF, and <code>authorize</code> is still mandatory.</p>
 </li><li>
-<p><strong>Fix:</strong> In the standalone: <code>skip_authentication!</code> + <code>skip_forgery_protection!</code>, and in  the verb <code>authorize { true }</code> (then validate a bearer token yourself).</p>
+<p><strong>Fix:</strong> In the standalone: <code>skip_authentication!</code> + <code>skip_forgery_protection!</code>, and in the verb <code>authorize { true }</code> (then validate a bearer token yourself).</p>
 </li></ul>
 
-<h3 id="label-15.+Hand-rolled+endpoint+where+a+pre-built+CRUD+component+exists">15. Hand-rolled endpoint where a pre-built CRUD component exists</h3>
+<h3 id="15-hand-rolled-endpoint-where-a-pre-built-crud-component-exists">15. Hand-rolled endpoint where a pre-built CRUD component exists</h3>
 <ul><li>
-<p><strong>Symptom:</strong> A custom <code>Compony::Component</code> with manual <code>button_to</code>/standalone for  delete/edit/create, duplicating routing, authorization, confirmation UI, styling.</p>
+<p><strong>Symptom:</strong> A custom <code>Compony::Component</code> with manual <code>button_to</code>/standalone for delete/edit/create, duplicating routing, authorization, confirmation UI, styling.</p>
 </li><li>
 <p><strong>Cause:</strong> Reaching for a bespoke component instead of the pre-built one.</p>
 </li><li>
-<p><strong>Fix:</strong> For CRUD use the pre-built parents (<code>Destroy</code>/<code>Edit</code>/<code>New</code>/<code>Show</code>/<code>Index</code>) and  point with <code>render_intent(:destroy, record)</code>. Reserve custom <code>Compony::Component</code>  standalones for genuinely non-CRUD actions (job dispatch, webhooks, multi-record ops).  Put a resourceful component in the family of the model it operates on, not the family  it is navigated from; pass parent context via path params.</p>
+<p><strong>Fix:</strong> For CRUD use the pre-built parents (<code>Destroy</code>/<code>Edit</code>/<code>New</code>/<code>Show</code>/<code>Index</code>) and point with <code>render_intent(:destroy, record)</code>. Reserve custom <code>Compony::Component</code> standalones for genuinely non-CRUD actions (job dispatch, webhooks, multi-record ops). Put a resourceful component in the family of the model it operates on, not the family it is navigated from; pass parent context via path params.</p>
 </li></ul>
 
-<h3 id="label-16.+attr_accessor+on+a+model+for+form-only+fields">16. <code>attr_accessor</code> on a model for form-only fields</h3>
+<h3 id="16-attraccessor-on-a-model-for-form-only-fields">16. <code>attr_accessor</code> on a model for form-only fields</h3>
 <ul><li>
 <p><strong>Symptom:</strong> Virtual form fields declared as <code>attr_accessor</code> on the ActiveRecord model.</p>
 </li><li>
 <p><strong>Cause:</strong> Polluting the persistent model with form-only concerns.</p>
 </li><li>
-<p><strong>Fix:</strong> Use an <code>ActiveType::Record[Model]</code> (or <code>Compony::VirtualModel</code>) inner class on  the component with <code>ar_attribute</code> + <code>field</code>, and set <code>data_class</code> to it. See  <a href="/doc/guide/virtual_models_md.html">virtual_models.md</a>.</p>
+<p><strong>Fix:</strong> Use an <code>ActiveType::Record[Model]</code> (or <code>Compony::VirtualModel</code>) inner class on the component with <code>ar_attribute</code> + <code>field</code>, and set <code>data_class</code> to it. See <a href="/doc/guide/virtual_models_md.html">virtual_models.md</a>.</p>
 </li></ul>
 
 <p><a href="/README_md.html#guide--documentation">Guide index</a></p>
 </div></div>
 
       <div id="footer">
-  Generated on Sat Jun  6 09:14:47 2026 by
+  Generated on Tue Aug 18 14:36:35 2026 by
   <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.9.34 (ruby-3.4.9).
 </div>

data/doc/file.index.html

@@ -63,23 +63,23 @@
 <p><a href="/doc/guide/pre_built_components_md.html">List of pre-built components</a></p>
 </li></ul>
 
-<h1 id="label-Pre-built+components-3A+Index">Pre-built components: Index</h1>
+<h1 id="pre-built-components-index">Pre-built components: Index</h1>
 
-<p><code>Compony::Components::Index</code> is a resourceful standalone component corresponding to Rails’ <code>index</code> controller action. It holds a collection of records and is a thin wrapper that nests the href="./list_md.html"></a> component of the same family.</p>
+<p><code>Compony::Components::Index</code> is a resourceful standalone component corresponding to Rails’ <code>index</code> controller action. It holds a collection of records and is a thin wrapper that nests the <a href="./list_md.html"><code>List</code></a> component of the same family.</p>
 
-<h2 id="label-What+it+does+by+default">What it does by default</h2>
+<h2 id="what-it-does-by-default">What it does by default</h2>
 
 <p>The shipped <code>setup</code> (see <code>lib/compony/components/index.rb</code>) is deliberately minimal:</p>
 <ul><li>
-<p><strong>Route:</strong> <code>standalone path: family_name</code> with a <code>verb :get</code> authorized by  <code>can?(:index, data_class)</code>, e.g. <code>/users</code>.</p>
+<p><strong>Route:</strong> <code>standalone path: family_name</code> with a <code>verb :get</code> authorized by <code>can?(:index, data_class)</code>, e.g. <code>/users</code>.</p>
 </li><li>
 <p><strong>Label:</strong> <code>label(:all) { data_class.model_name.human(count: 2) }</code> — e.g. “Users”.</p>
 </li><li>
-<p><strong>Data:</strong> <code>load_data { @data = data_class.accessible_by(controller.current_ability) }</code>  — the full CanCanCan[https://github.com/CanCanCommunity/cancancan]-scoped collection.</p>
+<p><strong>Data:</strong> <code>load_data { @data = data_class.accessible_by(controller.current_ability) }</code> — the full <a href="https://github.com/CanCanCommunity/cancancan">CanCanCan</a>-scoped collection.</p>
 </li><li>
-<p><strong>Exposed intent:</strong> adds a <code>:new</code> intent (unless the model is  <a href="/doc/guide/ownership_md.html">owned</a> by another).</p>
+<p><strong>Exposed intent:</strong> adds a <code>:new</code> intent (unless the model is <a href="/doc/guide/ownership_md.html">owned</a> by another).</p>
 </li><li>
-<p><strong>Content:</strong> <code>concat render_sub_comp(:list, @data)</code> — delegates all rendering to the  family’s <code>List</code>.</p>
+<p><strong>Content:</strong> <code>concat render_sub_comp(:list, @data)</code> — delegates all rendering to the family’s <code>List</code>.</p>
 </li></ul>
 
 <p>So with both an <code>Index</code> and a <code>List</code> component present, a family lists out of the box:</p>
@@ -90,7 +90,7 @@
 <span class='kw'>end</span>
 </code></pre>
 
-<h2 id="label-Typical+overrides">Typical overrides</h2>
+<h2 id="typical-overrides">Typical overrides</h2>
 
 <p>Narrow or order the collection:</p>
 
@@ -121,11 +121,11 @@
 <span class='kw'>end</span>
 </code></pre>
 
-<p>In practice apps put the layout/markup chrome in a <code>BaseComponents::Index</code> and inherit from that — see <a href="../patterns_md.html#3-index--load_data-scope--nested-list">Real-world patterns</a>. For column/filter/sort configuration, see href="./list_md.html"></a>.</p>
+<p>In practice apps put the layout/markup chrome in a <code>BaseComponents::Index</code> and inherit from that — see <a href="../patterns_md.html#3-index--load_data-scope--nested-list">Real-world patterns</a>. For column/filter/sort configuration, see <a href="./list_md.html"><code>List</code></a>.</p>
 </div></div>
 
       <div id="footer">
-  Generated on Sat Jun  6 09:14:47 2026 by
+  Generated on Tue Aug 18 14:36:34 2026 by
   <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.9.34 (ruby-3.4.9).
 </div>

data/doc/file.inheritance.html

@@ -60,7 +60,7 @@
       <div id="content"><div id='filecontents'>
 <p><a href="/README_md.html#guide--documentation">Back to the guide</a></p>
 
-<h1 id="label-Inheritance">Inheritance</h1>
+<h1 id="inheritance">Inheritance</h1>
 
 <p>Compony’s key advantage is that you can write DRYer code with it. To achieve this, you are encouraged to create abstract components, implement common functionality there and inherit from them in other components.</p>
 
@@ -71,7 +71,7 @@
 <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>
 
-<h2 id="label-Behavior">Behavior</h2>
+<h2 id="behavior">Behavior</h2>
 
 <p>When inheriting from another component class, <code>setup</code> can be called in the child as well in order to overwrite specified configurations. The parent’s <code>setup</code> block will be run first, then the child’s, then the grand-child’s and so on.</p>
 
@@ -102,7 +102,7 @@
 <span class='kw'>end</span>
 </code></pre>
 
-<h2 id="label-Un-exposing+a+component">Un-exposing a component</h2>
+<h2 id="un-exposing-a-component">Un-exposing a component</h2>
 
 <p>If a component’s parent class is <a href="./standalone_md.html">standalone</a> but the child should not be, use <code>clear_standalone!</code>:</p>
 
@@ -111,7 +111,7 @@
 <span class='kw'>end</span>
 </code></pre>
 
-<h2 id="label-Best+practice">Best practice</h2>
+<h2 id="best-practice">Best practice</h2>
 
 <p>Compony has the following convention:</p>
 <ul><li>
@@ -126,7 +126,7 @@
 </div></div>
 
       <div id="footer">
-  Generated on Sat Jun  6 09:14:46 2026 by
+  Generated on Tue Aug 18 14:36:33 2026 by
   <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.9.34 (ruby-3.4.9).
 </div>

data/doc/file.installation.html

@@ -60,9 +60,9 @@
       <div id="content"><div id='filecontents'>
 <p><a href="/README_md.html#guide--documentation">Back to the guide</a></p>
 
-<h1 id="label-Installation">Installation</h1>
+<h1 id="installation">Installation</h1>
 
-<h2 id="label-Installing+Compony">Installing Compony</h2>
+<h2 id="installing-compony">Installing Compony</h2>
 
 <p>First, add Compony to your Gemfile:</p>
 
@@ -78,7 +78,7 @@
 <pre class="code ruby"><code class="ruby"><span class='id identifier rubyid_include'>include</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/ModelMixin.html" title="Compony::ModelMixin (module)">ModelMixin</a></span></span>
 </code></pre>
 
-<h2 id="label-Installing+CanCanCan">Installing CanCanCan</h2>
+<h2 id="installing-cancancan">Installing CanCanCan</h2>
 
 <p>Create the file <code>app/models/ability.rb</code> with the following content:</p>
 
@@ -91,21 +91,21 @@
 <span class='kw'>end</span>
 </code></pre>
 
-<p>This is an initial dummy ability that allows anyone to do anything. Most likely, you will want to adjust the file. For documentation, refer to <a href="https://github.com/CanCanCommunity/cancancan/">github.com/CanCanCommunity/cancancan/</a>.</p>
+<p>This is an initial dummy ability that allows anyone to do anything. Most likely, you will want to adjust the file. For documentation, refer to <a href="https://github.com/CanCanCommunity/cancancan/">https://github.com/CanCanCommunity/cancancan/</a>.</p>
 
-<h2 id="label-Optional-3A+installing+anchormodel">Optional: installing anchormodel</h2>
+<h2 id="optional-installing-anchormodel">Optional: installing anchormodel</h2>
 
-<p>To take advantage of the anchormodel integration, follow the installation instructions under <a href="https://github.com/kalsan/anchormodel/">github.com/kalsan/anchormodel/</a>.</p>
+<p>To take advantage of the anchormodel integration, follow the installation instructions under <a href="https://github.com/kalsan/anchormodel/">https://github.com/kalsan/anchormodel/</a>.</p>
 
-<h2 id="label-Optional-3A+installing+active_type">Optional: installing <code>active_type</code></h2>
+<h2 id="optional-installing-activetype">Optional: installing <code>active_type</code></h2>
 
-<p>To take advantage of <a href="./virtual_models_md.html">virtual models</a> through the <code>active_type</code> integration, follow the instructions under <a href="https://github.com/makandra/active_type">github.com/makandra/active_type</a></p>
+<p>To take advantage of <a href="./virtual_models_md.html">virtual models</a> through the <code>active_type</code> integration, follow the instructions under <a href="https://github.com/makandra/active_type">https://github.com/makandra/active_type</a></p>
 
 <p><a href="/README_md.html#guide--documentation">Guide index</a></p>
 </div></div>
 
       <div id="footer">
-  Generated on Sat Jun  6 09:14:46 2026 by
+  Generated on Tue Aug 18 14:36:33 2026 by
   <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.9.34 (ruby-3.4.9).
 </div>

data/doc/file.integrations.html

@@ -60,11 +60,11 @@
       <div id="content"><div id='filecontents'>
 <p><a href="/README_md.html#guide--documentation">Back to the guide</a></p>
 
-<h1 id="label-Integrations+-26+companion+gems">Integrations &amp; companion gems</h1>
+<h1 id="integrations--companion-gems">Integrations &amp; companion gems</h1>
 
-<p>What Compony pulls in, what it optionally lights up, and what you are expected to add yourself. The authoritative source for hard dependencies and their version constraints is the <code>:gemspec</code> task in href="/Rakefile"></a> (it generates <code>compony.gemspec</code>); the table below mirrors it and must be updated together with it (see <a href="/doc/guide/maintaining_md.html">maintaining.md</a>).</p>
+<p>What Compony pulls in, what it optionally lights up, and what you are expected to add yourself. The authoritative source for hard dependencies and their version constraints is the <code>:gemspec</code> task in <a href="/Rakefile"><code>Rakefile</code></a> (it generates <code>compony.gemspec</code>); the table below mirrors it and must be updated together with it (see <a href="/doc/guide/maintaining_md.html">maintaining.md</a>).</p>
 
-<h2 id="label-Hard+runtime+dependencies+-28installed+automatically-29">Hard runtime dependencies (installed automatically)</h2>
+<h2 id="hard-runtime-dependencies-installed-automatically">Hard runtime dependencies (installed automatically)</h2>
 
 <table role="table">
 <thead>
@@ -76,44 +76,44 @@
 </thead>
 <tbody>
 <tr>
-<td>‘rails`</td>
-<td>‘&gt;= 7.2.1`</td>
+<td><code>rails</code></td>
+<td><code>&gt;= 7.2.1</code></td>
 <td>Routing, controllers, views Compony plugs into.</td>
 </tr>
 <tr>
-<td>‘request_store`</td>
-<td>‘&gt;= 1.7`</td>
-<td>Per-request storage (e.g. ‘Compony.root_comp`).</td>
+<td><code>request_store</code></td>
+<td><code>&gt;= 1.7</code></td>
+<td>Per-request storage (e.g. <code>Compony.root_comp</code>).</td>
 </tr>
 <tr>
-<td>‘dyny`</td>
-<td>‘&gt;= 0.0.3`</td>
-<td>HTML-as-Ruby templating used in ‘content` blocks.</td>
+<td><code>dyny</code></td>
+<td><code>&gt;= 0.0.3</code></td>
+<td>HTML-as-Ruby templating used in <code>content</code> blocks.</td>
 </tr>
 <tr>
-<td>‘schemacop`</td>
-<td>‘&gt;= 3.0.17`</td>
-<td>Strong-param schema validation behind ‘schema_field` / `schema_line`.</td>
+<td><code>schemacop</code></td>
+<td><code>&gt;= 3.0.17</code></td>
+<td>Strong-param schema validation behind <code>schema_field</code> / <code>schema_line</code>.</td>
 </tr>
 <tr>
-<td>‘simple_form`</td>
-<td>‘&gt;= 5.3.1`</td>
-<td>The form builder behind the Form component’s ‘field`.</td>
+<td><code>simple_form</code></td>
+<td><code>&gt;= 5.3.1</code></td>
+<td>The form builder behind the Form component’s <code>field</code>.</td>
 </tr>
 <tr>
-<td>‘dslblend`</td>
-<td>‘&gt;= 0.0.3`</td>
-<td>Powers the ‘RequestContext` multi-provider DSL.</td>
+<td><code>dslblend</code></td>
+<td><code>&gt;= 0.0.3</code></td>
+<td>Powers the <code>RequestContext</code> multi-provider DSL.</td>
 </tr>
 <tr>
-<td>‘anchormodel`</td>
-<td>‘&gt;= 0.3.0`</td>
-<td>‘anchormodel` model-field type + enum-like associations.</td>
+<td><code>anchormodel</code></td>
+<td><code>&gt;= 0.3.0</code></td>
+<td><code>anchormodel</code> model-field type + enum-like associations.</td>
 </tr>
 <tr>
-<td>‘cancancan`</td>
-<td>‘~&gt; 3.6.1`</td>
-<td>Authorization: ‘authorize { can?(…) }`, `accessible_by`, per-field `permitted_attributes`.</td>
+<td><code>cancancan</code></td>
+<td><code>~&gt; 3.6.1</code></td>
+<td>Authorization: <code>authorize { can?(...) }</code>, <code>accessible_by</code>, per-field <code>permitted_attributes</code>.</td>
 </tr>
 </tbody>
 </table>
@@ -124,7 +124,7 @@
 <p>Version note: the gemspec requires <code>rails &gt;= 7.2.1</code>. If the README’s prose mentions an older range, the gemspec wins — keep them in sync when bumping (see maintaining.md).</p>
 </blockquote>
 
-<h2 id="label-Optional+-E2-80-94+presence+unlocks+a+feature">Optional — presence unlocks a feature</h2>
+<h2 id="optional--presence-unlocks-a-feature">Optional — presence unlocks a feature</h2>
 
 <p>These are <strong>not</strong> declared dependencies; Compony detects them and enables behavior if they are in the host app’s bundle.</p>
 
@@ -137,17 +137,17 @@
 </thead>
 <tbody>
 <tr>
-<td>‘active_type`</td>
-<td>‘Compony::VirtualModel` (loaded only if `ActiveType::Object` is defined). Non-persistent / upload / wizard forms — [patterns §12](/doc/guide/patterns.md#12-virtual-model-for-non-persistent–upload-forms), [virtual_models.md](/doc/guide/virtual_models.md).</td>
+<td><code>active_type</code></td>
+<td><code>Compony::VirtualModel</code> (loaded only if <code>ActiveType::Object</code> is defined). Non-persistent / upload / wizard forms — <a href="/doc/guide/patterns_md.html#12-virtual-model-for-non-persistent--upload-forms">patterns §12</a>, <a href="/doc/guide/virtual_models_md.html">virtual_models.md</a>.</td>
 </tr>
 <tr>
-<td>‘ransack`</td>
-<td>List filtering, sorting links and the sort select in [‘List`](/doc/guide/pre_built_components/list.md). Without it, declare no `filter`/`sort` and those UIs stay off.</td>
+<td><code>ransack</code></td>
+<td>List filtering, sorting links and the sort select in <a href="/doc/guide/pre_built_components/list_md.html"><code>List</code></a>. Without it, declare no <code>filter</code>/<code>sort</code> and those UIs stay off.</td>
 </tr>
 </tbody>
 </table>
 
-<h2 id="label-App-side+companions+-28you+add+these-29">App-side companions (you add these)</h2>
+<h2 id="app-side-companions-you-add-these">App-side companions (you add these)</h2>
 
 <p>Compony is UI- and auth-agnostic; these are conventional choices in real apps, pulled in by your app, not by Compony.</p>
 
@@ -162,45 +162,45 @@
 <tbody>
 <tr>
 <td>Authentication</td>
-<td>Devise, or a custom login component + ‘Compony.authentication_before_action=`</td>
-<td>Compony ships <strong>no</strong> auth ([README](/README.md)); token-link flows → [patterns §18](/doc/guide/patterns.md#18-signed-token-capability-links-auth-less-onboarding–magic-links)</td>
+<td>Devise, or a custom login component + <code>Compony.authentication_before_action=</code></td>
+<td>Compony ships <strong>no</strong> auth (<a href="/README_md.html">README</a>); token-link flows → <a href="/doc/guide/patterns_md.html#18-signed-token-capability-links-auth-less-onboarding--magic-links">patterns §18</a></td>
 </tr>
 <tr>
 <td>Turbo / Stimulus</td>
-<td>‘turbo-rails`, `stimulus-rails`</td>
-<td>Compony fully supports Turbo Drive; inline-edit → [patterns §15](/doc/guide/patterns.md#15-inline-edit-card-with-a-turbo-frame), ajax PATCH → [patterns §17](/doc/guide/patterns.md#17-inline-patch-without-a-form-reorder–quick-toggle)</td>
+<td><code>turbo-rails</code>, <code>stimulus-rails</code></td>
+<td>Compony fully supports Turbo Drive; inline-edit → <a href="/doc/guide/patterns_md.html#15-inline-edit-card-with-a-turbo-frame">patterns §15</a>, ajax PATCH → <a href="/doc/guide/patterns_md.html#17-inline-patch-without-a-form-reorder--quick-toggle">patterns §17</a></td>
 </tr>
 <tr>
 <td>Select / date inputs</td>
-<td>TomSelect, Flatpickr (as registered ‘simple_form` inputs)</td>
-<td>‘field(:x, as: :tom_select/:flatpickr_*)` — [patterns §5–6](/doc/guide/patterns.md#5-custom-form–schemacop-kept-in-sync)</td>
+<td>TomSelect, Flatpickr (as registered <code>simple_form</code> inputs)</td>
+<td><code>field(:x, as: :tom_select/:flatpickr_*)</code> — <a href="/doc/guide/patterns_md.html#5-custom-form--schemacop-kept-in-sync">patterns §5–6</a></td>
 </tr>
 <tr>
 <td>i18n</td>
 <td>Rails I18n and/or FastGettext</td>
-<td>Component labels; gem ships ‘config/locales/de,en,fr.yml`</td>
+<td>Component labels; gem ships <code>config/locales/{de,en,fr}.yml</code></td>
 </tr>
 <tr>
 <td>File handling</td>
 <td>ActiveStorage (+ a variant/processor)</td>
-<td>Attachment fields, virtual-model uploads — [patterns §12](/doc/guide/patterns.md#12-virtual-model-for-non-persistent–upload-forms)</td>
+<td>Attachment fields, virtual-model uploads — <a href="/doc/guide/patterns_md.html#12-virtual-model-for-non-persistent--upload-forms">patterns §12</a></td>
 </tr>
 <tr>
 <td>PDF / CSV</td>
-<td>Prawn / wicked_pdf, Ruby ‘CSV`</td>
-<td>Export endpoints — [patterns §10](/doc/guide/patterns.md#10-csv–pdf-via-respond-format)</td>
+<td>Prawn / wicked_pdf, Ruby <code>CSV</code></td>
+<td>Export endpoints — <a href="/doc/guide/patterns_md.html#10-csv--pdf-via-respond-format">patterns §10</a></td>
 </tr>
 <tr>
 <td>Signed tokens</td>
-<td>‘jwt`</td>
-<td>Capability links — [patterns §18](/doc/guide/patterns.md#18-signed-token-capability-links-auth-less-onboarding–magic-links)</td>
+<td><code>jwt</code></td>
+<td>Capability links — <a href="/doc/guide/patterns_md.html#18-signed-token-capability-links-auth-less-onboarding--magic-links">patterns §18</a></td>
 </tr>
 </tbody>
 </table>
 
 <p>Incompatibility: <code>tailwindcss-rails</code> purges Compony component CSS (component HTML is not in <code>app/views</code>); see <a href="/doc/guide/gotchas_md.html#13-tailwindcss-rails-purges-compony-styles">gotchas.md #13</a>.</p>
 
-<h2 id="label-Development+dependencies">Development dependencies</h2>
+<h2 id="development-dependencies">Development dependencies</h2>
 
 <p><code>yard &gt;= 0.9.28</code> (docs), <code>rubocop &gt;= 1.48</code>, <code>rubocop-rails &gt;= 2.18.0</code> (lint).</p>
 
@@ -208,7 +208,7 @@
 </div></div>
 
       <div id="footer">
-  Generated on Sat Jun  6 09:14:48 2026 by
+  Generated on Tue Aug 18 14:36:35 2026 by
   <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.9.34 (ruby-3.4.9).
 </div>