backstage 0.1.11 → 0.1.12

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: da942f19c113814d2f7a5e738b3b7f7ce1cc1e8b23beeaabe8e9ef7e1f0d1b50
-  data.tar.gz: 805dedf4003e77e48d6e9bf5eb426d3f24e91fe61297a97eebd3c1f8a858e8f1
+  metadata.gz: e1dc01f215a31bcb5c84237cdfb95a7622ab7c8298e3b822eb476a9363e2f35c
+  data.tar.gz: 2a83eb127cfe5da24e409bf9f1ef69019a4d11be122402b5ca712f66ddfd1b3d
 SHA512:
-  metadata.gz: 76d4dd10a000b8aeb880f7df124140c351553e44fd98ee3ab42b980cb7abb315297fc959c50a2f3770c48d289db77b28326d4073677046c43dc83cb12022d29d
-  data.tar.gz: 800c78a96cc7e9289edff896f5264d0aa73399c4ae30f1ad6557e100213a1c4975f6da1c823fc0f4842744952320f9fe18f3f6a5f1ebe7a3de9b964742c1999a
+  metadata.gz: 46f7f8d377fa8c1fa57f3113b224df3428cdc99d21282ea1812a3e4d6b5f617c1f051adcc303217df1da8f4c2edfa1c800fa32dc3ae91b4f77aca0f3deb90a82
+  data.tar.gz: 3600c7c9e27c410a887fa6e63458eee543eb2d23271ee24adb99d1a8785272c7e3625498a86ae6ee54f0d68da3b6a6ed826c858a764394dcaea0b30536195d81

data/CHANGELOG.md

@@ -7,6 +7,14 @@ This project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.htm
 
 ## [Unreleased]
 
+## [0.1.12] — 2026-05-25
+
+### Added
+
+- `c.row :field1, :field2` groups fields horizontally in a Pico CSS grid on the edit page
+- `c.section "Label" [, collapsed: true]` wraps fields in a native `<details>`/`<summary>` collapsible block (no JavaScript required); rows and individual fields can be nested inside sections
+- `c.field` called inside a `section` block moves an existing auto-discovered field into the section rather than leaving it at the top level
+
 ## [0.1.11] — 2026-05-25
 
 ### Fixed

data/app/controllers/backstage/resources_controller.rb

@@ -85,10 +85,21 @@ module Backstage
     end
 
     def record_params
-      permitted = @resource_config.edit_fields.reject(&:readonly?).map do |field|
-        field.has_many? ? {field.name => []} : field.name
+      params
+        .require(@resource_config.model_class.model_name.param_key)
+        .permit(permitted_field_names(@resource_config.edit_fields))
+    end
+
+    def permitted_field_names(fields)
+      fields.reject(&:readonly?).flat_map do |field|
+        if field.container?
+          permitted_field_names(field.sub_fields)
+        elsif field.has_many?
+          [{field.name => []}]
+        else
+          [field.name]
+        end
       end
-      params.require(@resource_config.model_class.model_name.param_key).permit(permitted)
     end
   end
 end

data/app/views/backstage/fields/_row.html.erb

@@ -0,0 +1,8 @@
+<div class="grid">
+  <% field.sub_fields.each do |sub| %>
+    <div>
+      <%= f.label sub.name %>
+      <%= render partial: sub.partial_path, locals: { f: f, field: sub, record: @record } %>
+    </div>
+  <% end %>
+</div>

data/app/views/backstage/fields/_section.html.erb

@@ -0,0 +1,13 @@
+<details <%= "open" unless field.collapsed? %>>
+  <summary><strong><%= field.heading %></strong></summary>
+  <% field.sub_fields.each do |sub| %>
+    <% if sub.container? %>
+      <%= render partial: sub.partial_path, locals: { f: f, field: sub, record: @record } %>
+    <% else %>
+      <div>
+        <%= f.label sub.name %>
+        <%= render partial: sub.partial_path, locals: { f: f, field: sub, record: @record } %>
+      </div>
+    <% end %>
+  <% end %>
+</details>

data/app/views/backstage/resources/edit.html.erb

@@ -5,10 +5,14 @@
   <div>
     <%= form_with model: @record, url: resource_path(resource: params[:resource], id: @record.id), method: :patch do |f| %>
       <% @resource_config.edit_fields.each do |field| %>
-        <div>
-          <%= f.label field.name %>
+        <% if field.container? %>
           <%= render partial: field.partial_path, locals: { f: f, field: field, record: @record } %>
-        </div>
+        <% else %>
+          <div>
+            <%= f.label field.name %>
+            <%= render partial: field.partial_path, locals: { f: f, field: field, record: @record } %>
+          </div>
+        <% end %>
       <% end %>
       <%= f.submit "Save" %>
     <% end %>

data/lib/backstage/field.rb

@@ -32,6 +32,30 @@ module Backstage
       type == :has_many
     end
 
+    def row?
+      type == :row
+    end
+
+    def section?
+      type == :section
+    end
+
+    def container?
+      row? || section?
+    end
+
+    def sub_fields
+      options[:sub_fields] || []
+    end
+
+    def heading
+      options[:heading]
+    end
+
+    def collapsed?
+      options.fetch(:collapsed, false)
+    end
+
     def association
       options[:association]
     end

data/lib/backstage/resource_config.rb

@@ -74,13 +74,34 @@ module Backstage
       if existing
         existing.options.merge!(opts)
         existing.instance_variable_set(:@type, type.to_sym) if type
+        if @current_target
+          @edit_fields.reject! { |f| f.name == sym }
+          @current_target << existing
+        end
       else
         new_field = Field.new(sym, type || :string, opts)
-        @edit_fields << new_field
-        @index_fields << new_field unless @index_fields_explicit
+        (@current_target || @edit_fields) << new_field
+        @index_fields << new_field unless @index_fields_explicit || @current_target
       end
     end
 
+    def row(*names)
+      syms = names.map(&:to_sym)
+      sub = syms.map { |n| find_field(n) || Field.new(n, :string) }
+      @edit_fields.reject! { |f| syms.include?(f.name) }
+      row_field = Field.new(:"row_#{names.first}", :row, sub_fields: sub)
+      (@current_target || @edit_fields) << row_field
+    end
+
+    def section(heading, **opts)
+      section_field = Field.new(:"section_#{heading.parameterize}", :section,
+        heading: heading, sub_fields: [], **opts)
+      @current_target = section_field.sub_fields
+      yield if block_given?
+      @current_target = nil
+      @edit_fields << section_field
+    end
+
     private
 
     def find_field(name)

data/lib/backstage/version.rb

@@ -1,3 +1,3 @@
 module Backstage
-  VERSION = "0.1.11"
+  VERSION = "0.1.12"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: backstage
 version: !ruby/object:Gem::Version
-  version: 0.1.11
+  version: 0.1.12
 platform: ruby
 authors:
 - Gareth James
@@ -51,6 +51,8 @@ files:
 - app/views/backstage/fields/_has_many.html.erb
 - app/views/backstage/fields/_image_url.html.erb
 - app/views/backstage/fields/_integer.html.erb
+- app/views/backstage/fields/_row.html.erb
+- app/views/backstage/fields/_section.html.erb
 - app/views/backstage/fields/_string.html.erb
 - app/views/backstage/fields/_text.html.erb
 - app/views/backstage/fields/_thumbnails.html.erb