compony 0.11.11 → 0.11.13

data/doc/file.with_form.html

@@ -63,22 +63,22 @@
 <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+WithForm">Pre-built components: WithForm</h1>
+<h1 id="pre-built-components-withform">Pre-built components: WithForm</h1>
 
-<p><code>Compony::Components::WithForm</code> is the abstract base for components that render and submit a form. It is <strong>twinned</strong> with a href="./form_md.html"></a> component: WithForm provides the route, authorization and resource handling; the Form provides the inputs and param schema. href="./new_md.html"></a> and href="./edit_md.html"></a> both inherit from WithForm — you rarely subclass it directly, but understanding the twinning explains how they work.</p>
+<p><code>Compony::Components::WithForm</code> is the abstract base for components that render and submit a form. It is <strong>twinned</strong> with a <a href="./form_md.html"><code>Form</code></a> component: WithForm provides the route, authorization and resource handling; the Form provides the inputs and param schema. <a href="./new_md.html"><code>New</code></a> and <a href="./edit_md.html"><code>Edit</code></a> both inherit from WithForm — you rarely subclass it directly, but understanding the twinning explains how they work.</p>
 
 <p>A WithForm component may be resourceful (New/Edit are) but does not have to be.</p>
 
-<h2 id="label-How+the+twinning+works">How the twinning works</h2>
+<h2 id="how-the-twinning-works">How the twinning works</h2>
 <ul><li>
-<p><code>form_comp</code> returns the Form instance, built lazily. It defaults to the component named  <code>Form</code> in the <strong>same family</strong>, instantiated with this component as <code>parent_comp</code> and  passed <code>submit_verb</code>, <code>submit_path</code> and <code>cancancan_action</code>.</p>
+<p><code>form_comp</code> returns the Form instance, built lazily. It defaults to the component named <code>Form</code> in the <strong>same family</strong>, instantiated with this component as <code>parent_comp</code> and passed <code>submit_verb</code>, <code>submit_path</code> and <code>cancancan_action</code>.</p>
 </li><li>
-<p>The Form renders inside this component’s <code>content</code> (e.g. New/Edit do  <code>concat form_comp.render(controller, data: @data)</code>).</p>
+<p>The Form renders inside this component’s <code>content</code> (e.g. New/Edit do <code>concat form_comp.render(controller, data: @data)</code>).</p>
 </li><li>
-<p>The form’s <code>&lt;form&gt;</code> posts back to <code>submit_path</code> using <code>submit_verb</code>; that same component  handles the submit verb (POST for New, PATCH for Edit) and runs the resourceful  lifecycle (<code>assign_attributes</code> → <code>store_data</code> → <code>respond</code>).</p>
+<p>The form’s <code>&lt;form&gt;</code> posts back to <code>submit_path</code> using <code>submit_verb</code>; that same component handles the submit verb (POST for New, PATCH for Edit) and runs the resourceful lifecycle (<code>assign_attributes</code> → <code>store_data</code> → <code>respond</code>).</p>
 </li></ul>
 
-<h2 id="label-DSL+methods">DSL methods</h2>
+<h2 id="dsl-methods">DSL methods</h2>
 
 <table role="table">
 <thead>
@@ -90,34 +90,34 @@
 </thead>
 <tbody>
 <tr>
-<td>‘submit_verb`</td>
-<td>‘submit_verb(:patch)`</td>
-<td>HTTP verb the twinned form submits with. Mandatory (New sets ‘:post`, Edit `:patch`).</td>
+<td><code>submit_verb</code></td>
+<td><code>submit_verb(:patch)</code></td>
+<td>HTTP verb the twinned form submits with. Mandatory (New sets <code>:post</code>, Edit <code>:patch</code>).</td>
 </tr>
 <tr>
-<td>‘form_comp_class`</td>
-<td>‘form_comp_class(Components::Users::SignupForm)`</td>
-<td>Use a specific Form class instead of the same-family ‘Form`.</td>
+<td><code>form_comp_class</code></td>
+<td><code>form_comp_class(Components::Users::SignupForm)</code></td>
+<td>Use a specific Form class instead of the same-family <code>Form</code>.</td>
 </tr>
 <tr>
-<td>‘submit_path`</td>
-<td>‘submit_path { Compony.path(:create, :users) }`</td>
+<td><code>submit_path</code></td>
+<td><code>submit_path { Compony.path(:create, :users) }</code></td>
 <td>Override where the form submits. Block is given the controller; defaults to this component’s own path.</td>
 </tr>
 <tr>
-<td>‘form_cancancan_action`</td>
-<td>‘form_cancancan_action(:edit)`</td>
-<td>CanCanCan action used by the Form for per-field ‘permitted_attributes` (New sets `:new`, Edit `:edit`). Pass `nil` to disable per-field auth.</td>
+<td><code>form_cancancan_action</code></td>
+<td><code>form_cancancan_action(:edit)</code></td>
+<td>CanCanCan action used by the Form for per-field <code>permitted_attributes</code> (New sets <code>:new</code>, Edit <code>:edit</code>). Pass <code>nil</code> to disable per-field auth.</td>
 </tr>
 <tr>
-<td>‘form_comp`</td>
-<td>‘form_comp`</td>
+<td><code>form_comp</code></td>
+<td><code>form_comp</code></td>
 <td>(Not DSL — a reader.) The Form instance; override in a subclass for full control.</td>
 </tr>
 </tbody>
 </table>
 
-<h2 id="label-Example-3A+a+custom+non-default+form">Example: a custom non-default form</h2>
+<h2 id="example-a-custom-non-default-form">Example: a custom non-default form</h2>
 
 <pre class="code ruby"><code class="ruby"><span class='kw'>class</span> <span class='const'><span class='object_link'><a href="Components.html" title="Components (module)">Components</a></span></span><span class='op'>::</span><span class='const'>Users</span><span class='op'>::</span><span class='const'>Signup</span> <span class='op'>&lt;</span> <span class='const'><span class='object_link'><a href="Compony.html" title="Compony (module)">Compony</a></span></span><span class='op'>::</span><span class='const'><span class='object_link'><a href="Compony/Components.html" title="Compony::Components (module)">Components</a></span></span><span class='op'>::</span><span class='const'><span class='object_link'><a href="Compony/Components/New.html" title="Compony::Components::New (class)">New</a></span></span>
   <span class='id identifier rubyid_setup'>setup</span> <span class='kw'>do</span>
@@ -143,11 +143,11 @@
 <span class='kw'>end</span>
 </code></pre>
 
-<p>For the full submit/redirect behavior see href="./new_md.html"></a> and href="./edit_md.html"></a>; for the form input/schema DSL see href="./form_md.html"></a>; for the lifecycle hooks see <a href="/doc/guide/resourceful_md.html">Resourceful</a>. Multi-step and clone flows that reuse this machinery are in <a href="../patterns_md.html#11-non-crud-job-dispatch-toggles-clone">Real-world patterns</a>.</p>
+<p>For the full submit/redirect behavior see <a href="./new_md.html"><code>New</code></a> and <a href="./edit_md.html"><code>Edit</code></a>; for the form input/schema DSL see <a href="./form_md.html"><code>Form</code></a>; for the lifecycle hooks see <a href="/doc/guide/resourceful_md.html">Resourceful</a>. Multi-step and clone flows that reuse this machinery are in <a href="../patterns_md.html#11-non-crud-job-dispatch-toggles-clone">Real-world patterns</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/index.html

@@ -60,7 +60,7 @@
       <div id="content"><div id='filecontents'>
 <p>&lt;img src=“logo.svg” height=250 alt=“Compony logo”/&gt;</p>
 
-<h1 id="label-Where+to+read+what">Where to read what</h1>
+<h1 id="where-to-read-what">Where to read what</h1>
 <ul><li>
 <p>Get to know what Compony is and which concepts it uses in the <a href="https://github.com/kalsan/compony">README on GitHub</a>.</p>
 </li><li>
@@ -69,7 +69,7 @@
 <p>There is also a <a href="https://www.rubydoc.info/github/kalsan/compony.git">RubyDoc page for Compony</a> available.</p>
 </li></ul>
 
-<h1 id="label-About+Compony">About Compony</h1>
+<h1 id="about-compony">About Compony</h1>
 
 <p>Compony is a Gem that allows you to write your Rails application in <strong>component-style</strong> fashion. It combines a controller action and route along with its view into a single Ruby class. Along with the DSL approach and a powerful model mixin, Compony <strong>makes your application’s code more semantic</strong>, allows writing <strong>much DRYer code</strong>, using inheritance even in views and <strong>much easier refactoring</strong> for your Rails applications, helping you to <strong>keep the code clean as the application evolves</strong>.</p>
 
@@ -95,15 +95,15 @@
 <p>Compony uses <a href="https://github.com/CanCanCommunity/cancancan">CanCanCan</a> for authorization but does not provide an authentication mechanism. You can easily build your own by creating login/logout components that manage cookies, and configure Compony to enforce authentication using the <code>Compony.authentication_before_action</code> setter. I have also successfully tested Compony to work with <a href="https://github.com/heartcombo/devise">Devise</a>.</p>
 </li></ul>
 
-<h2 id="label-State+of+the+project">State of the project</h2>
+<h2 id="state-of-the-project">State of the project</h2>
 
-<p>I am actively using this framework in various applications and both performance and reliability are good. However, the project is experimental and lacking peer reviews and especially automatic testing, such as unit and integration tests. Also, expect there to be (<a href="/CHANGELOG_md.html">documented</a>) breaking changes in the future, as the API will likely be further refined, resulting in renamings and deprecation of various methods.</p>
+<p>I am actively using this framework in various applications and both performance and reliability are good. However, the project is experimental and lacking peer reviews and especially extensive automatic testing, such as unit and integration tests. Also, expect there to be (<a href="/CHANGELOG_md.html">documented</a>) breaking changes in the future, as the API will likely be further refined, resulting in renamings and deprecation of various methods.</p>
 
-<h2 id="label-Other+projects+exploring+similar+concepts">Other projects exploring similar concepts</h2>
+<h2 id="other-projects-exploring-similar-concepts">Other projects exploring similar concepts</h2>
 
 <p>A project with a similar aim, but a different approach, is <a href="https://github.com/phlex-ruby/phlex">Phlex</a>.</p>
 
-<h1 id="label-Guide+-2F+Documentation">Guide / Documentation</h1>
+<h1 id="guide--documentation">Guide / Documentation</h1>
 
 <p>The following topics should help you get started. Please note that the links will not work in yard doc - read this on <a href="https://github.com/kalsan/compony">Compony’s GitHub repo</a>.</p>
 <ul><li>
@@ -181,18 +181,28 @@
 </li></ul>
 </li></ul>
 
-<h1 id="label-Contributing">Contributing</h1>
+<h1 id="contributing">Contributing</h1>
 
 <p>Compony is Free Software under the LGPLv3 and you are most welcome to contribute to it.</p>
 <ul><li>
-<p>If you spotted a security vulnerability, <strong>do not open an issue</strong> but instead use the contact form at <a href="https://kalsan.ch/#contact">kalsan.ch/#contact</a> instead (English is just fine, even if the website is in German).</p>
+<p>If you spotted a security vulnerability, <strong>do not open an issue</strong> but instead use the contact form at <a href="https://kalsan.ch/#contact">https://kalsan.ch/#contact</a> instead (English is just fine, even if the website is in German).</p>
 </li><li>
 <p>If you’d like to contribute feedback or discuss something, please open an issue.</p>
 </li><li>
 <p>If you have an idea that is worth implementing, please fork the repo, implement your changes in your own fork, and open a pull request.</p>
 </li></ul>
 
-<h1 id="label-Caveats">Caveats</h1>
+<h2 id="running-the-tests">Running the tests</h2>
+
+<p>The gem ships an RSpec suite backed by a minimal dummy Rails app (in-memory SQLite, no setup needed):</p>
+
+<pre class="code ruby"><code class="ruby"><span class='id identifier rubyid_bundle'>bundle</span> <span class='id identifier rubyid_install'>install</span>
+<span class='id identifier rubyid_bundle'>bundle</span> <span class='id identifier rubyid_exec'>exec</span> <span class='id identifier rubyid_rspec'>rspec</span>   <span class='comment'># or: bundle exec rake spec (also the default rake task)
+</span></code></pre>
+
+<p>See <a href="./spec/README_md.html">spec/README.md</a> for the suite’s layout and the reasons behind the Gemfile’s <code>rails</code> and <code>rack</code> version pins.</p>
+
+<h1 id="caveats">Caveats</h1>
 <ul><li>
 <p>The API is not yet as consistent as I’d like it. Examples:</p>
 </li><li>
@@ -212,7 +222,7 @@
 <p>Compony is not compatible with <code>tailwindcss-rails</code>. This is likely due to Tailwind automatically removing any CSS that is not used by the application and the usage detection not picking up Compony components, as their content is not provided in views.</p>
 </li></ul>
 
-<h1 id="label-Acknowledgements">Acknowledgements</h1>
+<h1 id="acknowledgements">Acknowledgements</h1>
 
 <p>A big thank you to Alex and Koni who have patiently listened to my weird ideas and helped me developing them further, resulting in a few of the key concepts of Compony, such as <code>param_name</code>, or the way forms are structured.</p>
 
@@ -220,7 +230,7 @@
 </div></div>
 
       <div id="footer">
-  Generated on Sat Jun  6 09:14:45 2026 by
+  Generated on Tue Aug 18 14:36:32 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/top-level-namespace.html

@@ -102,7 +102,7 @@
 </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>

data/lib/compony/model_fields/base.rb

@@ -72,6 +72,9 @@ module Compony
           data = data.compact.map(&transform_block) if block_given?
           return controller.helpers.safe_join(data.compact, ', ')
         else
+          # A nil value has nothing to transform, and the transform blocks are written for actual values, thus they are
+          # not required to be nil safe. This mirrors the compact applied to enumerables above.
+          return nil if data.nil?
           data = transform_block.call(data) if block_given?
           return data
         end

data/spec/README.md

@@ -0,0 +1,22 @@
+# Compony test suite
+
+Run with `bundle exec rspec` (or `rake spec`).
+
+## Layout
+
+- `spec/dummy` — a minimal Rails app (in-memory SQLite) hosting the gem, with a `User`
+  model, CRUD components under `app/components/users`, and plain components under
+  `app/components/statics`. The schema lives in `spec/dummy/db/schema.rb` and is loaded
+  fresh on boot by `spec/rails_helper.rb`.
+- `spec/compony` — unit specs for the plain-Ruby parts (module API, intents, model mixin,
+  model fields, `MethodAccessibleHash`, `NaturalOrdering`, component DSL basics).
+- `spec/requests` — request specs exercising routing, rendering, the pre-built CRUD
+  components (Index/Show/New/Edit/Destroy/Form), feasibility and authorization end-to-end.
+
+## Version pins (Gemfile)
+
+- `rack >= 3.1`: the pre-built components respond with the `:unprocessable_content`
+  status, which only exists from Rack 3.1.
+- `rails ~> 7.2.1`: Rails 8.1 renamed the form helper `text_area` to `textarea`, which
+  collides with Dyny 0.0.3's `textarea` HTML tag helper on the view context and breaks
+  every simple_form textarea. Remove the pin once Dyny is fixed for Rails >= 8.1.

data/spec/compony/component_spec.rb

@@ -0,0 +1,80 @@
+RSpec.describe Compony::Component do
+  describe 'naming' do
+    it 'knows its comp and family name' do
+      expect(Components::Users::Show.comp_name).to eq('show')
+      expect(Components::Users::Show.family_name).to eq('users')
+    end
+  end
+
+  describe 'labelling' do
+    let(:user) { User.create!(name: 'Alice') }
+
+    it 'returns the long label by default' do
+      expect(Components::Users::Show.new.label(user)).to eq('Show user Alice')
+    end
+
+    it 'returns the short label on demand' do
+      expect(Components::Users::Show.new.label(user, format: :short)).to eq('Show')
+    end
+
+    it 'applies label(:all) to both formats' do
+      comp = Components::Users::Index.new
+      expect(comp.label(format: :long)).to eq('Users')
+      expect(comp.label(format: :short)).to eq('Users')
+    end
+  end
+
+  describe 'setup inheritance' do
+    it 'runs the parent setup before the child setup, letting children override' do
+      parent = Class.new(Compony::Component) do
+        setup do
+          label(:all) { 'Parent' }
+        end
+      end
+      child = Class.new(parent) do
+        setup do
+          label(:all) { 'Child' }
+        end
+      end
+      stub_const('Components::Tests::Parent', parent)
+      stub_const('Components::Tests::Child', child)
+      expect(child.new.label).to eq('Child')
+      expect(parent.new.label).to eq('Parent')
+    end
+  end
+
+  describe 'standalone config' do
+    it 'stores path and verbs' do
+      config = Components::Users::Show.new.standalone_configs[nil] || Components::Users::Show.new.standalone_configs.values.first
+      expect(config[:path]).to eq('users/show/:id')
+      expect(config[:verbs].keys).to eq([:get])
+    end
+
+    it 'marks components without standalone as not standalone-routed' do
+      comp_class = Class.new(Compony::Component) do
+        setup do
+          label(:all) { 'Nested' }
+          content { div 'hi' }
+        end
+      end
+      stub_const('Components::Tests::Nested', comp_class)
+      expect(comp_class.new.standalone_configs.values.pluck(:path).compact).to be_empty
+    end
+
+    it 'records skip_authentication!' do
+      config = Components::Statics::Home.new.standalone_configs.values.first
+      expect(config[:skip_authentication]).to be(true)
+    end
+  end
+
+  describe 'resourceful' do
+    it 'marks resourceful components' do
+      expect(Components::Users::Show.new.resourceful?).to be(true)
+      expect(Components::Statics::Home.new.resourceful?).to be(false)
+    end
+
+    it 'infers the data class from the family name' do
+      expect(Components::Users::Show.new.data_class).to eq(User)
+    end
+  end
+end

data/spec/compony/compony_spec.rb

@@ -0,0 +1,102 @@
+RSpec.describe Compony do
+  describe '.family_name_for' do
+    it 'underscores strings and symbols' do
+      expect(described_class.family_name_for('Users')).to eq('users')
+      expect(described_class.family_name_for(:Users)).to eq('users')
+      expect(described_class.family_name_for(:users)).to eq('users')
+    end
+
+    it 'derives the family from a model instance' do
+      expect(described_class.family_name_for(User.new)).to eq('users')
+    end
+
+    it 'derives the family from a model class' do
+      expect(described_class.family_name_for(User)).to eq('users')
+    end
+  end
+
+  describe '.comp_class_for' do
+    it 'resolves a component from comp and family symbols' do
+      expect(described_class.comp_class_for(:show, :users)).to eq(Components::Users::Show)
+    end
+
+    it 'resolves a component from a model instance' do
+      expect(described_class.comp_class_for(:show, User.new)).to eq(Components::Users::Show)
+    end
+
+    it 'returns nil for a missing component' do
+      expect(described_class.comp_class_for(:missing, :users)).to be_nil
+    end
+  end
+
+  describe '.comp_class_for!' do
+    it 'fails for a missing component' do
+      expect { described_class.comp_class_for!(:missing, :users) }.to raise_error(RuntimeError, /No component found/)
+    end
+
+    it 'resolves an existing component' do
+      expect(described_class.comp_class_for!(:edit, :users)).to eq(Components::Users::Edit)
+    end
+  end
+
+  describe '.intent' do
+    it 'builds an intent' do
+      intent = described_class.intent(:show, :users)
+      expect(intent).to be_a(Compony::Intent)
+      expect(intent.comp_class).to eq(Components::Users::Show)
+    end
+
+    it 'passes through an existing intent' do
+      intent = described_class.intent(:show, :users)
+      expect(described_class.intent(intent)).to be(intent)
+    end
+  end
+
+  describe '.path' do
+    it 'generates the path for a component with a model' do
+      user = User.create!(name: 'Alice')
+      expect(described_class.path(:show, user)).to eq("/users/show/#{user.id}")
+    end
+
+    it 'generates the path for a component without model' do
+      expect(described_class.path(:index, :users)).to eq('/users')
+    end
+  end
+
+  describe '.button_component_class' do
+    it 'returns the default css button class' do
+      expect(described_class.button_component_class).to eq(Compony::Components::Buttons::CssButton)
+    end
+
+    it 'returns the link class for :link' do
+      expect(described_class.button_component_class(:link)).to eq(Compony::Components::Buttons::Link)
+    end
+
+    it 'fails for an unknown style' do
+      expect { described_class.button_component_class(:nope) }.to raise_error(RuntimeError, /Unknown button style/)
+    end
+  end
+
+  describe '.default_button_style' do
+    it 'defaults to :css_button' do
+      expect(described_class.default_button_style).to eq(:css_button)
+    end
+  end
+
+  describe '.model_field_class_for' do
+    it 'resolves built-in field classes' do
+      expect(described_class.model_field_class_for('String')).to eq(Compony::ModelFields::String)
+      expect(described_class.model_field_class_for('Date')).to eq(Compony::ModelFields::Date)
+    end
+
+    it 'fails for unknown field types' do
+      expect { described_class.model_field_class_for('Nope') }.to raise_error(RuntimeError, /No `model_field_namespace`/)
+    end
+  end
+
+  describe '.model_field_namespaces' do
+    it 'defaults to the built-in namespace' do
+      expect(described_class.model_field_namespaces).to eq(['Compony::ModelFields'])
+    end
+  end
+end

data/spec/compony/intent_spec.rb

@@ -0,0 +1,94 @@
+RSpec.describe Compony::Intent do
+  let(:user) { User.create!(name: 'Alice') }
+  let(:admin) { User.create!(name: 'Root', admin: true) }
+
+  describe 'component resolution' do
+    it 'resolves from comp and family' do
+      expect(described_class.new(:show, :users).comp_class).to eq(Components::Users::Show)
+    end
+
+    it 'resolves from a model' do
+      expect(described_class.new(:show, user).comp_class).to eq(Components::Users::Show)
+    end
+
+    it 'accepts a component class directly' do
+      expect(described_class.new(Components::Users::Show).comp_class).to eq(Components::Users::Show)
+    end
+
+    it 'fails when neither component nor name/label are given' do
+      expect { described_class.new }.to raise_error(RuntimeError, /must be given the kwargs/)
+    end
+
+    it 'allows a component-less intent with name and label' do
+      intent = described_class.new(name: :external, label: 'External', path: 'https://example.com')
+      expect(intent.comp_class).to be_nil
+      expect(intent.name).to eq(:external)
+      expect(intent.label).to eq('External')
+      expect(intent.path).to eq('https://example.com')
+    end
+  end
+
+  describe '#model?' do
+    it 'is true for a record' do
+      expect(described_class.new(:show, user).model?).to be(true)
+    end
+
+    it 'is false for a family symbol' do
+      expect(described_class.new(:index, :users).model?).to be(false)
+    end
+  end
+
+  describe '#path' do
+    it 'builds the path from the model' do
+      expect(described_class.new(:show, user).path).to eq("/users/show/#{user.id}")
+    end
+
+    it 'prefers an explicitly given path string' do
+      expect(described_class.new(:show, user, path: '/custom').path).to eq('/custom')
+    end
+  end
+
+  describe '#name' do
+    it 'joins comp and family name' do
+      expect(described_class.new(:show, :users).name).to eq(:show_users)
+    end
+  end
+
+  describe '#method' do
+    it 'defaults to :get' do
+      expect(described_class.new(:show, user).method).to eq(:get)
+    end
+
+    it 'can be overridden' do
+      expect(described_class.new(:destroy, user, method: :delete).method).to eq(:delete)
+    end
+  end
+
+  describe 'feasibility' do
+    it 'is feasible for allowed actions' do
+      expect(described_class.new(:destroy, user).feasible?).to be(true)
+    end
+
+    it 'is infeasible when the model prevents the action' do
+      expect(described_class.new(:destroy, admin).feasible?).to be(false)
+    end
+
+    it 'is feasible when no model is involved' do
+      expect(described_class.new(:index, :users).feasible?).to be(true)
+    end
+
+    it 'disables the button when infeasible' do
+      opts = described_class.new(:destroy, admin).button_comp_opts
+      expect(opts[:href]).to be_nil
+      expect(opts[:class]).to eq('disabled')
+      expect(opts[:title]).to eq('Cannot destroy admins.')
+    end
+
+    it 'enables the button when feasible' do
+      opts = described_class.new(:destroy, user).button_comp_opts
+      expect(opts[:href]).to be_present
+      expect(opts[:class]).to be_nil
+      expect(opts[:title]).to be_nil
+    end
+  end
+end

data/spec/compony/method_accessible_hash_spec.rb

@@ -0,0 +1,32 @@
+RSpec.describe Compony::MethodAccessibleHash do
+  it 'symbolizes keys given in the constructor' do
+    hash = described_class.new('foo' => 1, bar: 2)
+    expect(hash[:foo]).to eq(1)
+    expect(hash[:bar]).to eq(2)
+  end
+
+  it 'provides read access via methods' do
+    hash = described_class.new(foo: :bar)
+    expect(hash.foo).to eq(:bar)
+  end
+
+  it 'returns nil for missing keys' do
+    expect(described_class.new.anything).to be_nil
+  end
+
+  it 'provides write access via methods' do
+    hash = described_class.new
+    hash.foo = 42
+    expect(hash[:foo]).to eq(42)
+  end
+
+  it 'responds to any method' do
+    expect(described_class.new).to respond_to(:whatever)
+  end
+
+  it 'symbolizes keys on merge' do
+    merged = described_class.new(foo: 1).merge('bar' => 2)
+    expect(merged[:bar]).to eq(2)
+    expect(merged['bar']).to be_nil
+  end
+end

data/spec/compony/model_fields_spec.rb

@@ -0,0 +1,70 @@
+RSpec.describe 'Compony::ModelFields' do
+  let(:user) do
+    User.create!(name: 'Alice', age: 30, comment: 'Hi', email: 'alice@example.com', admin: true, born_on: Date.new(1990, 5, 6))
+  end
+
+  let(:controller) do
+    ApplicationController.new.tap { |controller| controller.set_request!(ActionDispatch::Request.new({})) }
+  end
+
+  describe 'value_for' do
+    it 'returns the raw value for string fields' do
+      expect(User.fields[:name].value_for(user)).to eq('Alice')
+    end
+
+    it 'formats booleans via I18n' do
+      value = User.fields[:admin].value_for(user)
+      expect(value).to be_present
+      expect(value).not_to eq(true) # must be a human-readable representation, not the raw boolean
+    end
+
+    it 'localizes dates' do
+      expect(User.fields[:born_on].value_for(user)).to eq(I18n.l(Date.new(1990, 5, 6)))
+    end
+
+    it 'renders emails as mailto links when given a controller' do
+      controller = ApplicationController.new
+      controller.set_request!(ActionDispatch::Request.new({}))
+      value = User.fields[:email].value_for(user, controller:)
+      expect(value).to include('mailto:alice@example.com')
+    end
+
+    it 'fails for emails without controller' do
+      expect { User.fields[:email].value_for(user) }.to raise_error(RuntimeError, /Must pass controller/)
+    end
+
+    it 'formats percentages' do
+      user.update!(margin_relative: 0.5)
+      expect(User.fields[:margin_relative].value_for(user, controller:)).to eq('50.0%')
+    end
+
+    it 'returns nil-safe values for blank fields' do
+      empty = User.create!(name: 'Bob')
+      expect(User.fields[:born_on].value_for(empty)).to be_blank
+      expect(User.fields[:email].value_for(empty, controller: ApplicationController.new)).to be_blank
+    end
+
+    # A field may legitimately hold no value, e.g. a percentage that relates to zero. Formatting such a value must not
+    # raise, no matter which type the field has.
+    it 'returns nil for every field type of a record that has no values' do
+      empty = User.create!(name: 'Bob')
+      User.fields.each_value do |field|
+        next unless empty.send(field.name).nil? # e.g. name is given and admin defaults to false
+        expect { field.value_for(empty, controller:) }.not_to raise_error, "field #{field.name} raised"
+        expect(field.value_for(empty, controller:)).to be_blank, "field #{field.name} did not answer with a blank value"
+      end
+    end
+  end
+
+  describe 'label' do
+    it 'uses human_attribute_name' do
+      expect(User.fields[:name].label).to eq(User.human_attribute_name(:name))
+    end
+  end
+
+  describe 'schema_line' do
+    it 'returns a proc for schemacop integration' do
+      expect(User.fields[:name].schema_line).to be_a(Proc)
+    end
+  end
+end