compony 0.11.12 → 0.11.14

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 Tue Jun 30 22:41:19 2026 by
+  Generated on Wed Oct  7 10:48:18 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/guide/pre_built_components/form.md

@@ -91,7 +91,7 @@ In the model:
 class Foo < ApplicationRecord
   # No need to write:
   field :label, :string, virtual: true
-  I18n.available_locales.each do |locale|
+  Compony.content_locales.each do |locale|
     field :"label_#{locale}", :string
   end
 
@@ -114,4 +114,23 @@ class Components::Foos::Form < Compony::Components::Form
     schema_field :label, multilang: true
   end
 end
-```
+```
+
+### Content locales
+
+By default, `multilang: true` generates one field per locale in `I18n.available_locales`. If your app's locales differ
+from the languages your content is stored in, for instance because it uses regional locales such as `:"de-CH"` and
+`:"de-DE"` while content is stored per language, configure the content locales in an initializer:
+
+```ruby
+# config/initializers/compony.rb
+Compony.content_locales = %i[de en fr]
+```
+
+With `I18n.available_locales = %i[de de-CH en fr]`, `field :label, :string, multilang: true` then generates `label`
+(virtual), `label_de`, `label_en` and `label_fr`, without a `label_de-CH`. The form's `field` and `schema_field` follow
+the same setting.
+
+Model fields are generated when the model class loads, so the setting must be in place before any model loads. An
+initializer guarantees that. If the locales are only known later, pass a callable instead, which is evaluated every time
+the content locales are needed: `Compony.content_locales = -> { MyApp.content_locales }`.

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 Tue Jun 30 22:41:17 2026 by
+  Generated on Wed Oct  7 10:48:16 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/method_list.html

@@ -364,6 +364,22 @@
   </li>
   
 
+  <li class="odd ">
+    <div class="item">
+      <span class='object_link'><a href="Compony.html#content_locales-class_method" title="Compony.content_locales (method)">content_locales</a></span>
+      <small>Compony</small>
+    </div>
+  </li>
+  
+
+  <li class="even ">
+    <div class="item">
+      <span class='object_link'><a href="Compony.html#content_locales=-class_method" title="Compony.content_locales= (method)">content_locales=</a></span>
+      <small>Compony</small>
+    </div>
+  </li>
+  
+
   <li class="odd ">
     <div class="item">
       <span class='object_link'><a href="Compony/RequestContext.html#controller-instance_method" title="Compony::RequestContext#controller (method)">#controller</a></span>

data/doc/top-level-namespace.html

@@ -102,7 +102,7 @@
 </div>
 
       <div id="footer">
-  Generated on Tue Jun 30 22:41:20 2026 by
+  Generated on Wed Oct  7 10:48:19 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/components/form.rb

@@ -106,7 +106,8 @@ module Compony
       # DSL method (inside `form_fields`). Renders a simple_form input inferred from the model field `name`.
       # Respects per-field CanCanCan authorization; skipped fields render nothing.
       # @param name [Symbol,String] The model field (use the association name, not the `_id`, for associations).
-      # @param multilang [Boolean] If true, generates one suffixed input per available locale and returns the array (useful with the "mobility" gem).
+      # @param multilang [Boolean] If true, generates one suffixed input per content locale and returns the array (useful with the "mobility" gem).
+      #   See {Compony.content_locales}.
       # @param input_opts [Hash] Passed to simple_form. Notable keys: `as:` (input type), `hidden: true`, `autofocus:`.
       # @return [String,Array<String>] The input HTML (array when `multilang`).
       # @api public
@@ -114,7 +115,7 @@ module Compony
         fail("The `field` method may only be called inside `form_fields` for #{inspect}.") unless @simpleform
 
         if multilang
-          I18n.available_locales.map { |locale| field("#{name}_#{locale}", **input_opts) }
+          Compony.content_locales.map { |locale| field("#{name}_#{locale}", **input_opts) }
         else
           name = name.to_sym
 
@@ -215,12 +216,12 @@ module Compony
       # DSL method, whitelists a single field of `data_class` in the param schema, auto-generating the correct schema line.
       # Respects per-field CanCanCan authorization.
       # @param field_name [Symbol,String] The model field (association name, not `_id`, for associations).
-      # @param multilang [Boolean] If true, whitelists one suffixed field per available locale (useful with the "mobility" gem).
+      # @param multilang [Boolean] If true, whitelists one suffixed field per content locale, see {Compony.content_locales} (useful with the "mobility" gem).
       # @return [void]
       # @api public
       def schema_field(field_name, multilang: false)
         if multilang
-          I18n.available_locales.each { |locale| schema_field("#{field_name}_#{locale}") }
+          Compony.content_locales.each { |locale| schema_field("#{field_name}_#{locale}") }
         else
           # This runs upon component setup.
           @schema_lines_for_data << proc do |data, controller|

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/lib/compony/model_mixin.rb

@@ -19,11 +19,12 @@ module Compony
       end
 
       # DSL method, defines a new field which will be translated and can be added to field groups
-      # If multilang is true, a suffixed field is generated for every available locale, along with a non-suffixed virtual field (useful with gem "mobility")
+      # If multilang is true, a suffixed field is generated for every content locale, along with a non-suffixed virtual field (useful with gem "mobility").
+      # See Compony.content_locales.
       def field(name, type, multilang: false, **extra_attrs)
         if multilang
           field(name, type, virtual: true, **extra_attrs)
-          I18n.available_locales.each { |locale| field("#{name}_#{locale}", type, **extra_attrs) }
+          Compony.content_locales.each { |locale| field("#{name}_#{locale}", type, **extra_attrs) }
         else
           name = name.to_sym
           self.fields = fields.dup

data/lib/compony.rb

@@ -35,6 +35,17 @@ module Compony
     @model_field_namespaces = model_field_namespaces
   end
 
+  # Setter for the content locales, i.e. the languages in which `multilang: true` fields exist (useful with gem "mobility").
+  # Set this when your app's `I18n.available_locales` differ from the languages your content is stored in, e.g. when
+  # using regional locales such as `:"de-CH"` while content is stored per language (`label_de`, `label_en`, ...).
+  # Model fields are generated when the model class loads, so set this in an initializer, before any model is loaded.
+  # Alternatively, pass a callable, which is evaluated every time the content locales are needed.
+  # @param content_locales [Array<Symbol,String>,#call] The content locales, or a callable returning them. Defaults to `I18n.available_locales`.
+  # @see {Compony#content_locales}
+  def self.content_locales=(content_locales)
+    @content_locales = content_locales
+  end
+
   # Setter for the name of the Rails `before_action` that should be called to
   # ensure that users are authenticated before accessing the component. For
   # instance, implement a method `def enforce_authentication` in your
@@ -99,6 +110,14 @@ module Compony
     return @model_field_namespaces ||= ['Compony::ModelFields']
   end
 
+  # Getter for the content locales, defaults to `I18n.available_locales`.
+  # @return [Array<Symbol>] The locales for which `multilang: true` fields generate a suffixed field.
+  # @see Compony#content_locales= Explanation of content_locales (documented in the corresponding setter)
+  def self.content_locales
+    content_locales = @content_locales.respond_to?(:call) ? @content_locales.call : @content_locales
+    return (content_locales || I18n.available_locales).map(&:to_sym)
+  end
+
   # Getter for the name of the Rails `before_action` that enforces authentication.
   # @see Compony#authentication_before_action= Explanation of authentication_before_action (documented in the corresponding setter)
   def self.authentication_before_action

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/components/form_spec.rb

@@ -0,0 +1,31 @@
+RSpec.describe Compony::Components::Form do
+  describe 'multilang' do
+    around do |example|
+      original_available_locales = I18n.available_locales
+      I18n.available_locales = %i[en de de-CH fr es]
+      Compony.content_locales = %i[de en fr es]
+      example.run
+    ensure
+      I18n.available_locales = original_available_locales
+      Compony.content_locales = nil
+    end
+
+    let(:form) { described_class.new }
+
+    it 'renders one field per content locale' do
+      form.instance_variable_set(:@simpleform, Object.new) # `field` refuses to run outside `form_fields`
+      allow(form).to receive(:field).and_call_original
+      allow(form).to receive(:field).with(a_string_starting_with('label_')) { |name| name }
+      expect(form.field(:label, multilang: true)).to eq(%w[label_de label_en label_fr label_es])
+    end
+
+    it 'whitelists one schema field per content locale' do
+      allow(form).to receive(:schema_field).and_call_original
+      form.send(:schema_field, :label, multilang: true) # DSL method, protected
+      %w[label_de label_en label_fr label_es].each do |name|
+        expect(form).to have_received(:schema_field).with(name)
+      end
+      expect(form).not_to have_received(:schema_field).with('label_de-CH')
+    end
+  end
+end

data/spec/compony/compony_spec.rb

@@ -0,0 +1,130 @@
+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
+
+  describe '.content_locales' do
+    around do |example|
+      original_available_locales = I18n.available_locales
+      example.run
+    ensure
+      I18n.available_locales = original_available_locales
+      described_class.content_locales = nil
+    end
+
+    it 'defaults to I18n.available_locales' do
+      I18n.available_locales = %i[en de]
+      expect(described_class.content_locales).to eq(%i[en de])
+    end
+
+    it 'returns the configured locales as symbols' do
+      described_class.content_locales = %w[de en]
+      expect(described_class.content_locales).to eq(%i[de en])
+    end
+
+    it 'evaluates a callable every time' do
+      locales = %i[de]
+      described_class.content_locales = -> { locales }
+      expect(described_class.content_locales).to eq(%i[de])
+      locales = %i[de fr]
+      expect(described_class.content_locales).to eq(%i[de fr])
+    end
+  end
+end