compony 0.11.11 → 0.11.13

data/doc/file.dsl_reference.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-DSL+reference">DSL reference</h1>
+<h1 id="dsl-reference">DSL reference</h1>
 
 <p>Flat lookup of every Compony DSL method, its calling context, signature, and a one-line description. This page is generated from <code># DSL method</code> markers in the source — when in doubt the Ruby source under <code>lib/compony/</code> is authoritative. “Context” says where the call is legal.</p>
 
@@ -81,7 +81,7 @@
 <p><strong>model</strong> — in an <code>ActiveRecord</code>/model class that <code>include</code>s the model mixin.</p>
 </li></ul>
 
-<h2 id="label-Component+definition">Component definition</h2>
+<h2 id="component-definition">Component definition</h2>
 
 <table role="table">
 <thead>
@@ -94,70 +94,70 @@
 </thead>
 <tbody>
 <tr>
-<td>‘setup`</td>
+<td><code>setup</code></td>
 <td>class</td>
-<td>‘setup { block }`</td>
+<td><code>setup { block }</code></td>
 <td>Main config block. Runs at end of init; parent runs before child.</td>
 </tr>
 <tr>
-<td>‘label`</td>
+<td><code>label</code></td>
 <td>setup</td>
-<td>‘label(:short/:long/:all) { |model| … }`</td>
+<td><code>label(:short/:long/:all) { |model| ... }</code></td>
 <td>Component title + link/button text. Resourceful comps take 1 block arg.</td>
 </tr>
 <tr>
-<td>‘color`</td>
+<td><code>color</code></td>
 <td>setup</td>
-<td>‘color { ’#AA0000’ }‘</td>
+<td><code>color { &#39;#AA0000&#39; }</code></td>
 <td>Component color (not used by Compony itself).</td>
 </tr>
 <tr>
-<td>‘icon`</td>
+<td><code>icon</code></td>
 <td>setup</td>
-<td>‘icon { %i[fa-solid circle] }`</td>
+<td><code>icon { %i[fa-solid circle] }</code></td>
 <td>Component icon (not used by Compony itself).</td>
 </tr>
 <tr>
-<td>‘content`</td>
+<td><code>content</code></td>
 <td>setup</td>
-<td>‘content(name = :main, before: nil, hidden: false) { block }`</td>
-<td>Define/replace a named view block (Dyny). ‘hidden: true` = don’t auto-render. Non-obvious use: hidden ‘:main` + `:wrapper` chrome → [patterns §1](/doc/guide/patterns.md#1-the-app-base-component-layer).</td>
+<td><code>content(name = :main, before: nil, hidden: false) { block }</code></td>
+<td>Define/replace a named view block (Dyny). <code>hidden: true</code> = don’t auto-render. Non-obvious use: hidden <code>:main</code> + <code>:wrapper</code> chrome → <a href="/doc/guide/patterns_md.html#1-the-app-base-component-layer">patterns §1</a>.</td>
 </tr>
 <tr>
-<td>‘content`</td>
+<td><code>content</code></td>
 <td>content</td>
-<td>‘content(:name)`</td>
-<td>Render another content block of the <strong>same</strong> component (nesting). [patterns §1](/doc/guide/patterns.md#1-the-app-base-component-layer).</td>
+<td><code>content(:name)</code></td>
+<td>Render another content block of the <em>same</em> component (nesting). <a href="/doc/guide/patterns_md.html#1-the-app-base-component-layer">patterns §1</a>.</td>
 </tr>
 <tr>
-<td>‘remove_content`</td>
+<td><code>remove_content</code></td>
 <td>setup</td>
-<td>‘remove_content(:name)`</td>
+<td><code>remove_content(:name)</code></td>
 <td>Remove an inherited content block (returns false if absent).</td>
 </tr>
 <tr>
-<td>‘remove_content!`</td>
+<td><code>remove_content!</code></td>
 <td>setup</td>
-<td>‘remove_content!(:name)`</td>
+<td><code>remove_content!(:name)</code></td>
 <td>Same, raises if the block was not found.</td>
 </tr>
 <tr>
-<td>‘before_render`</td>
+<td><code>before_render</code></td>
 <td>setup</td>
-<td>‘before_render(name = :main, before: nil) { block }`</td>
-<td>Pre-content hook. If it sets a response body (e.g. redirect), content is skipped. Non-obvious uses: verb-independent guard → [patterns §8](/doc/guide/patterns.md#8-lifecycle-hooks-for-derived-data); wizard step nav → [patterns §16](/doc/guide/patterns.md#16-multi-step-wizard-across-components).</td>
+<td><code>before_render(name = :main, before: nil) { block }</code></td>
+<td>Pre-content hook. If it sets a response body (e.g. redirect), content is skipped. Non-obvious uses: verb-independent guard → <a href="/doc/guide/patterns_md.html#8-lifecycle-hooks-for-derived-data">patterns §8</a>; wizard step nav → <a href="/doc/guide/patterns_md.html#16-multi-step-wizard-across-components">patterns §16</a>.</td>
 </tr>
 <tr>
-<td>‘exposed_intents`</td>
+<td><code>exposed_intents</code></td>
 <td>setup</td>
-<td>‘exposed_intents { add …; remove … }`</td>
-<td>Declare intents the layout/parent renders. See ‘add`/`remove`, and the toolbar pattern → [patterns §9](/doc/guide/patterns.md#9-exposed-intents-as-the-action-toolbar).</td>
+<td><code>exposed_intents { add ...; remove ... }</code></td>
+<td>Declare intents the layout/parent renders. See <code>add</code>/<code>remove</code>, and the toolbar pattern → <a href="/doc/guide/patterns_md.html#9-exposed-intents-as-the-action-toolbar">patterns §9</a>.</td>
 </tr>
 <tr>
-<td>‘path`</td>
+<td><code>path</code></td>
 <td>setup</td>
-<td>‘path { |model, *args, standalone_name:, **kw| … }`</td>
-<td>Override path generation for this component (advanced). Runs outside the request context — build URLs via ‘Rails.application.routes.url_helpers`. Non-obvious use: mint a signed token into the URL → [patterns §18](/doc/guide/patterns.md#18-signed-token-capability-links-auth-less-onboarding–magic-links); see also [standalone.md](/doc/guide/standalone.md#customizing-path-generation).</td>
+<td><code>path { |model, *args, standalone_name:, **kw| ... }</code></td>
+<td>Override path generation for this component (advanced). Runs outside the request context — build URLs via <code>Rails.application.routes.url_helpers</code>. Non-obvious use: mint a signed token into the URL → <a href="/doc/guide/patterns_md.html#18-signed-token-capability-links-auth-less-onboarding--magic-links">patterns §18</a>; see also <a href="/doc/guide/standalone_md.html#customizing-path-generation">standalone.md</a>.</td>
 </tr>
 </tbody>
 </table>
@@ -174,19 +174,19 @@
 </thead>
 <tbody>
 <tr>
-<td>‘add`</td>
-<td>‘add(comp, model_or_family, before: nil, **intent_opts)`</td>
+<td><code>add</code></td>
+<td><code>add(comp, model_or_family, before: nil, **intent_opts)</code></td>
 <td>Add/replace an exposed intent (keyed by intent name).</td>
 </tr>
 <tr>
-<td>‘remove`</td>
-<td>‘remove(:intent_name)`</td>
+<td><code>remove</code></td>
+<td><code>remove(:intent_name)</code></td>
 <td>Remove a previously added exposed intent.</td>
 </tr>
 </tbody>
 </table>
 
-<h2 id="label-Standalone+-28routing-29">Standalone (routing)</h2>
+<h2 id="standalone-routing">Standalone (routing)</h2>
 
 <table role="table">
 <thead>
@@ -199,51 +199,51 @@
 </thead>
 <tbody>
 <tr>
-<td>‘standalone`</td>
+<td><code>standalone</code></td>
 <td>setup</td>
-<td>‘standalone(name = nil, path:, constraints: nil, scope: nil, scope_args: {}) { … }`</td>
-<td>Generate a Rails route. Non-obvious use: a <strong>named</strong> extra ‘standalone` for an ajax companion endpoint of the same screen → [patterns §17](/doc/guide/patterns.md#17-inline-patch-without-a-form-reorder–quick-toggle).</td>
+<td><code>standalone(name = nil, path:, constraints: nil, scope: nil, scope_args: {}) { ... }</code></td>
+<td>Generate a Rails route. Non-obvious use: a <em>named</em> extra <code>standalone</code> for an ajax companion endpoint of the same screen → <a href="/doc/guide/patterns_md.html#17-inline-patch-without-a-form-reorder--quick-toggle">patterns §17</a>.</td>
 </tr>
 <tr>
-<td>‘verb`</td>
+<td><code>verb</code></td>
 <td>standalone</td>
-<td>‘verb(:get/:post/:patch/:put/:delete/…) { … }`</td>
+<td><code>verb(:get/:post/:patch/:put/:delete/...) { ... }</code></td>
 <td>Config one HTTP verb. Up to once per verb per standalone.</td>
 </tr>
 <tr>
-<td>‘skip_authentication!`</td>
+<td><code>skip_authentication!</code></td>
 <td>standalone</td>
-<td>‘skip_authentication!`</td>
-<td>Disable app authentication for this standalone (still need ‘authorize`). Non-obvious use: token-gated auth-less links → [patterns §18](/doc/guide/patterns.md#18-signed-token-capability-links-auth-less-onboarding–magic-links).</td>
+<td><code>skip_authentication!</code></td>
+<td>Disable app authentication for this standalone (still need <code>authorize</code>). Non-obvious use: token-gated auth-less links → <a href="/doc/guide/patterns_md.html#18-signed-token-capability-links-auth-less-onboarding--magic-links">patterns §18</a>.</td>
 </tr>
 <tr>
-<td>‘skip_forgery_protection!`</td>
+<td><code>skip_forgery_protection!</code></td>
 <td>standalone</td>
-<td>‘skip_forgery_protection!`</td>
-<td>Disable CSRF for this standalone’s action. Non-obvious use: inbound webhooks → [patterns §13](/doc/guide/patterns.md#13-public-endpoints–webhooks).</td>
+<td><code>skip_forgery_protection!</code></td>
+<td>Disable CSRF for this standalone’s action. Non-obvious use: inbound webhooks → <a href="/doc/guide/patterns_md.html#13-public-endpoints--webhooks">patterns §13</a>.</td>
 </tr>
 <tr>
-<td>‘layout`</td>
+<td><code>layout</code></td>
 <td>standalone</td>
-<td>‘layout(’layouts/backend’)‘</td>
-<td>Rails layout for this standalone. Defaults to ‘layouts/application`. Centralize in the base layer → [patterns §1](/doc/guide/patterns.md#1-the-app-base-component-layer).</td>
+<td><code>layout(&#39;layouts/backend&#39;)</code></td>
+<td>Rails layout for this standalone. Defaults to <code>layouts/application</code>. Centralize in the base layer → <a href="/doc/guide/patterns_md.html#1-the-app-base-component-layer">patterns §1</a>.</td>
 </tr>
 <tr>
-<td>‘authorize`</td>
+<td><code>authorize</code></td>
 <td>verb</td>
-<td>‘authorize { can?(:read, @data) }`</td>
-<td><strong>Mandatory.</strong> Truthy = access; falsy → ‘CanCan::AccessDenied`. Non-obvious use: validate a signed token → [patterns §18](/doc/guide/patterns.md#18-signed-token-capability-links-auth-less-onboarding–magic-links).</td>
+<td><code>authorize { can?(:read, @data) }</code></td>
+<td><strong>Mandatory.</strong> Truthy = access; falsy → <code>CanCan::AccessDenied</code>. Non-obvious use: validate a signed token → <a href="/doc/guide/patterns_md.html#18-signed-token-capability-links-auth-less-onboarding--magic-links">patterns §18</a>.</td>
 </tr>
 <tr>
-<td>‘respond`</td>
+<td><code>respond</code></td>
 <td>verb</td>
-<td>‘respond(format = nil) { … }`</td>
-<td>Override the controller response (e.g. send_data, render json, redirect). Overriding ‘nil` format **skips `authorize`** — re-check yourself. Non-obvious uses: CSV/PDF export → [patterns §10](/doc/guide/patterns.md#10-csv–pdf-via-respond-format); ajax-only PATCH → [patterns §17](/doc/guide/patterns.md#17-inline-patch-without-a-form-reorder–quick-toggle).</td>
+<td><code>respond(format = nil) { ... }</code></td>
+<td>Override the controller response (e.g. send_data, render json, redirect). Overriding <code>nil</code> format <strong>skips <code>authorize</code></strong> — re-check yourself. Non-obvious uses: CSV/PDF export → <a href="/doc/guide/patterns_md.html#10-csv--pdf-via-respond-format">patterns §10</a>; ajax-only PATCH → <a href="/doc/guide/patterns_md.html#17-inline-patch-without-a-form-reorder--quick-toggle">patterns §17</a>.</td>
 </tr>
 </tbody>
 </table>
 
-<h2 id="label-Resourceful+lifecycle+hooks">Resourceful lifecycle hooks</h2>
+<h2 id="resourceful-lifecycle-hooks">Resourceful lifecycle hooks</h2>
 
 <p>Available in <strong>setup</strong> (global, all verbs) on resourceful components; the same names also work inside a <strong>verb</strong> block to override for one path+verb.</p>
 
@@ -257,39 +257,39 @@
 </thead>
 <tbody>
 <tr>
-<td>‘data_class`</td>
-<td>‘data_class(NewClass = nil)`</td>
-<td>Set/get the model class. Defaults to family name singularized+constantized. Non-obvious use: point at a ‘VirtualModel` → [patterns §12](/doc/guide/patterns.md#12-virtual-model-for-non-persistent–upload-forms).</td>
+<td><code>data_class</code></td>
+<td><code>data_class(NewClass = nil)</code></td>
+<td>Set/get the model class. Defaults to family name singularized+constantized. Non-obvious use: point at a <code>VirtualModel</code> → <a href="/doc/guide/patterns_md.html#12-virtual-model-for-non-persistent--upload-forms">patterns §12</a>.</td>
 </tr>
 <tr>
-<td>‘load_data`</td>
-<td>‘load_data { @data = … }`</td>
-<td>Override record loading. Default: ‘<a href=":id">data_class.find(params</a>)`. Runs before `authorize`. Non-obvious uses: Index scope → [patterns §3](/doc/guide/patterns.md#3-index–load_data-scope–nested-list); load+dup for clone → [patterns §11](/doc/guide/patterns.md#11-non-crud-job-dispatch-toggles-clone).</td>
+<td><code>load_data</code></td>
+<td><code>load_data { @data = ... }</code></td>
+<td>Override record loading. Default: <code>data_class.find(params[:id])</code>. Runs before <code>authorize</code>. Non-obvious uses: Index scope → <a href="/doc/guide/patterns_md.html#3-index--load_data-scope--nested-list">patterns §3</a>; load+dup for clone → <a href="/doc/guide/patterns_md.html#11-non-crud-job-dispatch-toggles-clone">patterns §11</a>.</td>
 </tr>
 <tr>
-<td>‘after_load_data`</td>
-<td>‘after_load_data { … }`</td>
-<td>Runs after ‘load_data`, before `authorize`. Refine an AR relation here.</td>
+<td><code>after_load_data</code></td>
+<td><code>after_load_data { ... }</code></td>
+<td>Runs after <code>load_data</code>, before <code>authorize</code>. Refine an AR relation here.</td>
 </tr>
 <tr>
-<td>‘assign_attributes`</td>
-<td>‘assign_attributes { … }`</td>
-<td>Assign validated params onto ‘@data`. Pre-built forms supply a default.</td>
+<td><code>assign_attributes</code></td>
+<td><code>assign_attributes { ... }</code></td>
+<td>Assign validated params onto <code>@data</code>. Pre-built forms supply a default.</td>
 </tr>
 <tr>
-<td>‘after_assign_attributes`</td>
-<td>‘after_assign_attributes { … }`</td>
-<td>After ‘assign_attributes`, before `store_data`. Prefill/derive fields here → [patterns §8](/doc/guide/patterns.md#8-lifecycle-hooks-for-derived-data); seed from a token → [patterns §18](/doc/guide/patterns.md#18-signed-token-capability-links-auth-less-onboarding–magic-links).</td>
+<td><code>after_assign_attributes</code></td>
+<td><code>after_assign_attributes { ... }</code></td>
+<td>After <code>assign_attributes</code>, before <code>store_data</code>. Prefill/derive fields here → <a href="/doc/guide/patterns_md.html#8-lifecycle-hooks-for-derived-data">patterns §8</a>; seed from a token → <a href="/doc/guide/patterns_md.html#18-signed-token-capability-links-auth-less-onboarding--magic-links">patterns §18</a>.</td>
 </tr>
 <tr>
-<td>‘store_data`</td>
-<td>‘store_data { @data.save }`</td>
-<td>Persist ‘@data`. Override for virtual models / uploads → [patterns §12](/doc/guide/patterns.md#12-virtual-model-for-non-persistent–upload-forms), or to enqueue work / multi-record txn → [patterns §11](/doc/guide/patterns.md#11-non-crud-job-dispatch-toggles-clone).</td>
+<td><code>store_data</code></td>
+<td><code>store_data { @data.save }</code></td>
+<td>Persist <code>@data</code>. Override for virtual models / uploads → <a href="/doc/guide/patterns_md.html#12-virtual-model-for-non-persistent--upload-forms">patterns §12</a>, or to enqueue work / multi-record txn → <a href="/doc/guide/patterns_md.html#11-non-crud-job-dispatch-toggles-clone">patterns §11</a>.</td>
 </tr>
 </tbody>
 </table>
 
-<h2 id="label-Form+component+DSL">Form component DSL</h2>
+<h2 id="form-component-dsl">Form component DSL</h2>
 
 <p><code>class Components::X::Form &lt; Compony::Components::Form</code></p>
 
@@ -304,81 +304,81 @@
 </thead>
 <tbody>
 <tr>
-<td>‘form_fields`</td>
+<td><code>form_fields</code></td>
 <td>setup</td>
-<td>‘form_fields { … }`</td>
-<td><strong>Mandatory.</strong> Block holding the form inputs (Dyny + ‘field`/`f`).</td>
+<td><code>form_fields { ... }</code></td>
+<td><strong>Mandatory.</strong> Block holding the form inputs (Dyny + <code>field</code>/<code>f</code>).</td>
 </tr>
 <tr>
-<td>‘field`</td>
+<td><code>field</code></td>
 <td>form_fields</td>
-<td>‘field(:name, multilang: false, **simple_form_opts)`</td>
-<td>Render a simple_form input inferred from the model field. ‘as:`/`hidden:` supported.</td>
+<td><code>field(:name, multilang: false, **simple_form_opts)</code></td>
+<td>Render a simple_form input inferred from the model field. <code>as:</code>/<code>hidden:</code> supported.</td>
 </tr>
 <tr>
-<td>‘pw_field`</td>
+<td><code>pw_field</code></td>
 <td>form_fields</td>
-<td>‘pw_field(:password, **opts)`</td>
-<td>Password input; checks ‘:set_password` ability.</td>
+<td><code>pw_field(:password, **opts)</code></td>
+<td>Password input; checks <code>:set_password</code> ability.</td>
 </tr>
 <tr>
-<td>‘f`</td>
+<td><code>f</code></td>
 <td>form_fields</td>
-<td>‘f`</td>
-<td>The underlying ‘simple_form` builder (for `f.rich_text_area` etc.).</td>
+<td><code>f</code></td>
+<td>The underlying <code>simple_form</code> builder (for <code>f.rich_text_area</code> etc.).</td>
 </tr>
 <tr>
-<td>‘collect`</td>
+<td><code>collect</code></td>
 <td>form_fields</td>
-<td>‘collect(…)`</td>
+<td><code>collect(...)</code></td>
 <td>Wrap a collection in Rails-compatible format (Anchormodel helper).</td>
 </tr>
 <tr>
-<td>‘schema_field`</td>
+<td><code>schema_field</code></td>
 <td>setup</td>
-<td>‘schema_field(:name, multilang: false)`</td>
-<td>Whitelist one field in the Schemacop param schema. For associations use the **association name**, not ‘_id`.</td>
+<td><code>schema_field(:name, multilang: false)</code></td>
+<td>Whitelist one field in the Schemacop param schema. For associations use the <strong>association name</strong>, not <code>_id</code>.</td>
 </tr>
 <tr>
-<td>‘schema_fields`</td>
+<td><code>schema_fields</code></td>
 <td>setup</td>
-<td>‘schema_fields(:a, :b, …)`</td>
-<td>Mass ‘schema_field`.</td>
+<td><code>schema_fields(:a, :b, ...)</code></td>
+<td>Mass <code>schema_field</code>.</td>
 </tr>
 <tr>
-<td>‘schema_pw_field`</td>
+<td><code>schema_pw_field</code></td>
 <td>setup</td>
-<td>‘schema_pw_field(:password)`</td>
-<td>Whitelist a password param (checks ‘:set_password`).</td>
+<td><code>schema_pw_field(:password)</code></td>
+<td>Whitelist a password param (checks <code>:set_password</code>).</td>
 </tr>
 <tr>
-<td>‘schema_line`</td>
+<td><code>schema_line</code></td>
 <td>setup</td>
-<td>‘schema_line { str? :foo }`</td>
-<td>Add a raw Schemacop3 line (nested attrs, custom shapes) → [patterns §5](/doc/guide/patterns.md#5-custom-form–schemacop-kept-in-sync).</td>
+<td><code>schema_line { str? :foo }</code></td>
+<td>Add a raw Schemacop3 line (nested attrs, custom shapes) → <a href="/doc/guide/patterns_md.html#5-custom-form--schemacop-kept-in-sync">patterns §5</a>.</td>
 </tr>
 <tr>
-<td>‘schema`</td>
+<td><code>schema</code></td>
 <td>setup</td>
-<td>‘schema(:wrapper_key) { … }`</td>
+<td><code>schema(:wrapper_key) { ... }</code></td>
 <td>Replace the whole schema + wrapper key (fully manual).</td>
 </tr>
 <tr>
-<td>‘form_params`</td>
+<td><code>form_params</code></td>
 <td>setup</td>
-<td>‘form_params(**opts)`</td>
-<td>Extra kwargs passed to ‘simple_form_for`.</td>
+<td><code>form_params(**opts)</code></td>
+<td>Extra kwargs passed to <code>simple_form_for</code>.</td>
 </tr>
 <tr>
-<td>‘disable!`</td>
+<td><code>disable!</code></td>
 <td>setup</td>
-<td>‘disable!`</td>
+<td><code>disable!</code></td>
 <td>Render all inputs disabled.</td>
 </tr>
 <tr>
-<td>‘skip_autofocus`</td>
+<td><code>skip_autofocus</code></td>
 <td>setup</td>
-<td>‘skip_autofocus`</td>
+<td><code>skip_autofocus</code></td>
 <td>Don’t autofocus the first field.</td>
 </tr>
 </tbody>
@@ -396,54 +396,54 @@
 </thead>
 <tbody>
 <tr>
-<td>‘submit_verb`</td>
-<td>‘submit_verb(:patch)`</td>
-<td>HTTP verb the form submits with (‘:post` for New, `:patch` for Edit).</td>
+<td><code>submit_verb</code></td>
+<td><code>submit_verb(:patch)</code></td>
+<td>HTTP verb the form submits with (<code>:post</code> for New, <code>:patch</code> for Edit).</td>
 </tr>
 <tr>
-<td>‘form_comp_class`</td>
-<td>‘form_comp_class(Components::X::MyForm)`</td>
-<td>Use a custom Form component instead of ‘Components::&lt;Family&gt;::Form`. Non-obvious uses: non-default form → [patterns §5](/doc/guide/patterns.md#5-custom-form–schemacop-kept-in-sync); token-gated signup → [patterns §18](/doc/guide/patterns.md#18-signed-token-capability-links-auth-less-onboarding–magic-links).</td>
+<td><code>form_comp_class</code></td>
+<td><code>form_comp_class(Components::X::MyForm)</code></td>
+<td>Use a custom Form component instead of <code>Components::&lt;Family&gt;::Form</code>. Non-obvious uses: non-default form → <a href="/doc/guide/patterns_md.html#5-custom-form--schemacop-kept-in-sync">patterns §5</a>; token-gated signup → <a href="/doc/guide/patterns_md.html#18-signed-token-capability-links-auth-less-onboarding--magic-links">patterns §18</a>.</td>
 </tr>
 <tr>
-<td>‘form_cancancan_action`</td>
-<td>‘form_cancancan_action(:edit)`</td>
-<td>CanCanCan action used for per-field ‘permitted_attributes`. Pass `nil` to disable per-field auth (e.g. token-gated forms → [patterns §18](/doc/guide/patterns.md#18-signed-token-capability-links-auth-less-onboarding–magic-links)).</td>
+<td><code>form_cancancan_action</code></td>
+<td><code>form_cancancan_action(:edit)</code></td>
+<td>CanCanCan action used for per-field <code>permitted_attributes</code>. Pass <code>nil</code> to disable per-field auth (e.g. token-gated forms → <a href="/doc/guide/patterns_md.html#18-signed-token-capability-links-auth-less-onboarding--magic-links">patterns §18</a>).</td>
 </tr>
 <tr>
-<td>‘submit_path`</td>
-<td>‘submit_path { Compony.path(…) }`</td>
-<td>Override where the form POSTs/PATCHes to. Non-obvious use: carry a token through submit → [patterns §18](/doc/guide/patterns.md#18-signed-token-capability-links-auth-less-onboarding–magic-links).</td>
+<td><code>submit_path</code></td>
+<td><code>submit_path { Compony.path(...) }</code></td>
+<td>Override where the form POSTs/PATCHes to. Non-obvious use: carry a token through submit → <a href="/doc/guide/patterns_md.html#18-signed-token-capability-links-auth-less-onboarding--magic-links">patterns §18</a>.</td>
 </tr>
 <tr>
-<td>‘on_created` / `on_updated`</td>
-<td>‘on_created { … }`</td>
+<td><code>on_created</code> / <code>on_updated</code></td>
+<td><code>on_created { ... }</code></td>
 <td>Post-save, pre-respond hook (success).</td>
 </tr>
 <tr>
-<td>‘on_created_respond` / `on_updated_respond`</td>
-<td>‘… { … }`</td>
+<td><code>on_created_respond</code> / <code>on_updated_respond</code></td>
+<td><code>... { ... }</code></td>
 <td>Override the success response (default: flash + redirect).</td>
 </tr>
 <tr>
-<td>‘on_created_redirect_path` / `on_updated_redirect_path`</td>
-<td>‘… { path }`</td>
-<td>Override the success redirect target. Non-obvious use: chain wizard steps → [patterns §16](/doc/guide/patterns.md#16-multi-step-wizard-across-components).</td>
+<td><code>on_created_redirect_path</code> / <code>on_updated_redirect_path</code></td>
+<td><code>... { path }</code></td>
+<td>Override the success redirect target. Non-obvious use: chain wizard steps → <a href="/doc/guide/patterns_md.html#16-multi-step-wizard-across-components">patterns §16</a>.</td>
 </tr>
 <tr>
-<td>‘on_create_failed_respond` / `on_update_failed`</td>
-<td>‘… { … }`</td>
+<td><code>on_create_failed_respond</code> / <code>on_update_failed</code></td>
+<td><code>... { ... }</code></td>
 <td>Override the validation-failure response.</td>
 </tr>
 <tr>
-<td>‘on_destroyed` / `on_destroyed_respond` / `on_destroyed_redirect_path`</td>
-<td>‘… { … }`</td>
+<td><code>on_destroyed</code> / <code>on_destroyed_respond</code> / <code>on_destroyed_redirect_path</code></td>
+<td><code>... { ... }</code></td>
 <td>Destroy component equivalents.</td>
 </tr>
 </tbody>
 </table>
 
-<h2 id="label-List+-2F+Index+component+DSL">List / Index component DSL</h2>
+<h2 id="list--index-component-dsl">List / Index component DSL</h2>
 
 <p><code>Compony::Components::List</code> (nest in Index or owner Show); <code>Compony::Components::Index</code>.</p>
 
@@ -458,93 +458,93 @@
 </thead>
 <tbody>
 <tr>
-<td>‘column`</td>
+<td><code>column</code></td>
 <td>setup</td>
-<td>‘column(:name, label: nil, class: nil, link_opts: {}) { |record| … }`</td>
+<td><code>column(:name, label: nil, class: nil, link_opts: {}) { |record| ... }</code></td>
 <td>Add/define a column; block renders the cell.</td>
 </tr>
 <tr>
-<td>‘columns`</td>
+<td><code>columns</code></td>
 <td>setup</td>
-<td>‘columns(:a, :b, as_title: false)`</td>
-<td>Add several field-based columns. ‘as_title: true` = card title on mobile.</td>
+<td><code>columns(:a, :b, as_title: false)</code></td>
+<td>Add several field-based columns. <code>as_title: true</code> = card title on mobile.</td>
 </tr>
 <tr>
-<td>‘filter`</td>
+<td><code>filter</code></td>
 <td>setup</td>
-<td>‘filter(:name, label: nil) { |f| … }`</td>
+<td><code>filter(:name, label: nil) { |f| ... }</code></td>
 <td>Add/define a filter; block customizes the input.</td>
 </tr>
 <tr>
-<td>‘filters`</td>
+<td><code>filters</code></td>
 <td>setup</td>
-<td>‘filters(:a, :b)`</td>
+<td><code>filters(:a, :b)</code></td>
 <td>Add several filters.</td>
 </tr>
 <tr>
-<td>‘sort`</td>
+<td><code>sort</code></td>
 <td>setup</td>
-<td>‘sort(:name, label: nil)`</td>
+<td><code>sort(:name, label: nil)</code></td>
 <td>Add a sort option.</td>
 </tr>
 <tr>
-<td>‘sorts`</td>
+<td><code>sorts</code></td>
 <td>setup</td>
-<td>‘sorts(:a, :b)`</td>
+<td><code>sorts(:a, :b)</code></td>
 <td>Add several sort options.</td>
 </tr>
 <tr>
-<td>‘default_sorting`</td>
+<td><code>default_sorting</code></td>
 <td>setup</td>
-<td>‘default_sorting(’id desc’)‘</td>
+<td><code>default_sorting(&#39;id desc&#39;)</code></td>
 <td>Default Ransack sort string.</td>
 </tr>
 <tr>
-<td>‘row_intents`</td>
+<td><code>row_intents</code></td>
 <td>setup</td>
-<td>‘row_intents(**opts) { add/remove }`</td>
-<td>Per-row action buttons (intent DSL) → [patterns §4](/doc/guide/patterns.md#4-list-customization).</td>
+<td><code>row_intents(**opts) { add/remove }</code></td>
+<td>Per-row action buttons (intent DSL) → <a href="/doc/guide/patterns_md.html#4-list-customization">patterns §4</a>.</td>
 </tr>
 <tr>
-<td>‘pagination`</td>
+<td><code>pagination</code></td>
 <td>setup</td>
-<td>‘pagination(false)`</td>
+<td><code>pagination(false)</code></td>
 <td>Enable/disable pagination (caution: loads all rows).</td>
 </tr>
 <tr>
-<td>‘results_per_page`</td>
+<td><code>results_per_page</code></td>
 <td>setup</td>
-<td>‘results_per_page(20)`</td>
+<td><code>results_per_page(20)</code></td>
 <td>Rows per page when paginating.</td>
 </tr>
 <tr>
-<td>‘filtering`</td>
+<td><code>filtering</code></td>
 <td>setup</td>
-<td>‘filtering(false)`</td>
+<td><code>filtering(false)</code></td>
 <td>Enable/disable filtering entirely.</td>
 </tr>
 <tr>
-<td>‘sorting`</td>
+<td><code>sorting</code></td>
 <td>setup</td>
-<td>‘sorting(false)`</td>
+<td><code>sorting(false)</code></td>
 <td>Enable/disable both sorting links and in-filter sorting.</td>
 </tr>
 <tr>
-<td>‘sorting_in_filter` / `sorting_links`</td>
+<td><code>sorting_in_filter</code> / <code>sorting_links</code></td>
 <td>setup</td>
-<td>‘sorting_links(false)`</td>
+<td><code>sorting_links(false)</code></td>
 <td>Toggle one sorting UI independently.</td>
 </tr>
 <tr>
-<td>‘filter_label_class` / `filter_input_class` / `filter_select_class`</td>
+<td><code>filter_label_class</code> / <code>filter_input_class</code> / <code>filter_select_class</code></td>
 <td>setup</td>
-<td>‘filter_input_class(’…‘)`</td>
+<td><code>filter_input_class(&#39;...&#39;)</code></td>
 <td>CSS classes for filter form elements.</td>
 </tr>
 <tr>
-<td>‘skip_column`</td>
+<td><code>skip_column</code></td>
 <td>setup</td>
-<td>‘skip_column(:name)`</td>
+<td><code>skip_column(:name)</code></td>
 <td>Remove an inherited column (Show/List).</td>
 </tr>
 </tbody>
@@ -552,7 +552,7 @@
 
 <p>Many of these also accept <code>skip_*</code> kwargs on the constructor when the List is nested via <code>render_sub_comp</code> (e.g. <code>render_sub_comp(:list, coll, skip_pagination: true)</code>).</p>
 
-<h2 id="label-Model+mixin+-28in+your+ApplicationRecord+models-29">Model mixin (in your <code>ApplicationRecord</code> models)</h2>
+<h2 id="model-mixin-in-your-applicationrecord-models">Model mixin (in your <code>ApplicationRecord</code> models)</h2>
 
 <table role="table">
 <thead>
@@ -565,53 +565,53 @@
 </thead>
 <tbody>
 <tr>
-<td>‘field`</td>
+<td><code>field</code></td>
 <td>model (class)</td>
-<td>‘field(:name, :type, multilang: false, **attrs)`</td>
+<td><code>field(:name, :type, multilang: false, **attrs)</code></td>
 <td>Declare a UI-relevant attribute + its type/formatting.</td>
 </tr>
 <tr>
-<td>‘prevent`</td>
+<td><code>prevent</code></td>
 <td>model (class)</td>
-<td>‘prevent(:destroy, ’msg’) { condition }‘</td>
+<td><code>prevent(:destroy, &#39;msg&#39;) { condition }</code></td>
 <td>Feasibility: block returns truthy → action prevented (buttons disabled).</td>
 </tr>
 <tr>
-<td>‘owned_by`</td>
+<td><code>owned_by</code></td>
 <td>model (class)</td>
-<td>‘owned_by(:invoice)`</td>
+<td><code>owned_by(:invoice)</code></td>
 <td>Mark this model as owned by another; adjusts redirects/top actions.</td>
 </tr>
 <tr>
-<td>‘skip_autodetect_feasibilities`</td>
+<td><code>skip_autodetect_feasibilities</code></td>
 <td>model (class)</td>
-<td>‘skip_autodetect_feasibilities`</td>
-<td>Don’t auto-derive ‘:destroy` preventions from `dependent:` associations.</td>
+<td><code>skip_autodetect_feasibilities</code></td>
+<td>Don’t auto-derive <code>:destroy</code> preventions from <code>dependent:</code> associations.</td>
 </tr>
 <tr>
-<td>‘feasible?`</td>
+<td><code>feasible?</code></td>
 <td>model (instance)</td>
-<td>‘record.feasible?(:destroy)`</td>
+<td><code>record.feasible?(:destroy)</code></td>
 <td>True if no prevention blocks the action.</td>
 </tr>
 <tr>
-<td>‘feasibility_messages`</td>
+<td><code>feasibility_messages</code></td>
 <td>model (instance)</td>
-<td>‘record.feasibility_messages(:destroy)`</td>
-<td>Array of reasons (like ‘errors`).</td>
+<td><code>record.feasibility_messages(:destroy)</code></td>
+<td>Array of reasons (like <code>errors</code>).</td>
 </tr>
 <tr>
-<td>‘full_feasibility_messages`</td>
+<td><code>full_feasibility_messages</code></td>
 <td>model (instance)</td>
-<td>‘record.full_feasibility_messages(:destroy)`</td>
-<td>Joined human string (like ‘full_messages`).</td>
+<td><code>record.full_feasibility_messages(:destroy)</code></td>
+<td>Joined human string (like <code>full_messages</code>).</td>
 </tr>
 </tbody>
 </table>
 
 <p><code>label</code> is not a DSL method but <strong>every Compony model must implement <code>def label</code></strong> (or have a <code>label</code> column) — used for titles and link text.</p>
 
-<h2 id="label-Intent+-2F+navigation+helpers">Intent / navigation helpers</h2>
+<h2 id="intent--navigation-helpers">Intent / navigation helpers</h2>
 
 <p>Used from <code>content</code> blocks or controllers — see <a href="/doc/guide/intents_md.html">intents.md</a>.</p>
 
@@ -626,34 +626,34 @@
 </thead>
 <tbody>
 <tr>
-<td>‘Compony.intent`</td>
+<td><code>Compony.intent</code></td>
 <td>anywhere</td>
-<td>‘Compony.intent(:show, model, **opts)`</td>
-<td>Build an ‘Intent`.</td>
+<td><code>Compony.intent(:show, model, **opts)</code></td>
+<td>Build an <code>Intent</code>.</td>
 </tr>
 <tr>
-<td>‘Compony.path`</td>
+<td><code>Compony.path</code></td>
 <td>anywhere</td>
-<td>‘Compony.path(:index, :users, **opts)`</td>
+<td><code>Compony.path(:index, :users, **opts)</code></td>
 <td>Rails path string (redirects).</td>
 </tr>
 <tr>
-<td>‘render_intent`</td>
+<td><code>render_intent</code></td>
 <td>content</td>
-<td>‘render_intent(:edit, model, style:, label:, button:)`</td>
-<td>Render a link/button to a component. Wrap in ‘concat`.</td>
+<td><code>render_intent(:edit, model, style:, label:, button:)</code></td>
+<td>Render a link/button to a component. Wrap in <code>concat</code>.</td>
 </tr>
 <tr>
-<td>‘render_sub_comp`</td>
+<td><code>render_sub_comp</code></td>
 <td>content</td>
-<td>‘render_sub_comp(:list, @data.quotes, **opts)`</td>
-<td>Instantiate + nest another component. Wrap in ‘concat`.</td>
+<td><code>render_sub_comp(:list, @data.quotes, **opts)</code></td>
+<td>Instantiate + nest another component. Wrap in <code>concat</code>.</td>
 </tr>
 <tr>
-<td>‘Compony.comp_class_for`</td>
+<td><code>Compony.comp_class_for</code></td>
 <td>anywhere</td>
-<td>‘Compony.comp_class_for(:show, family)`</td>
-<td>Comp class or ‘nil`.</td>
+<td><code>Compony.comp_class_for(:show, family)</code></td>
+<td>Comp class or <code>nil</code>.</td>
 </tr>
 </tbody>
 </table>
@@ -662,7 +662,7 @@
 </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>