plutonium 0.58.1 → 0.60.0

data/lib/plutonium/ui/form/components/section.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+module Plutonium
+  module UI
+    module Form
+      module Components
+        # Renders a form section's chrome (heading/description, optional native
+        # <details> collapsible, and a fields grid) and yields to a block that
+        # renders the section's fields (the form supplies render_resource_field).
+        class Section < Plutonium::UI::Component::Base
+          def initialize(resolved, grid_class:)
+            @section = resolved.section
+            @grid_class = grid_class
+          end
+
+          SECTION_CLASS = "space-y-4 border-t border-[var(--pu-border-muted)] pt-6 first:border-t-0 first:pt-0"
+          HEADING_CLASS = "text-base font-semibold text-[var(--pu-text)]"
+          SUMMARY_CLASS = "#{HEADING_CLASS} cursor-pointer select-none"
+          DESCRIPTION_CLASS = "text-sm text-[var(--pu-text-muted)]"
+
+          def view_template(&fields_block)
+            if @section.collapsible?
+              details(open: !@section.collapsed?, class: SECTION_CLASS) do
+                summary(class: SUMMARY_CLASS) { heading_text }
+                describe
+                grid(&fields_block)
+              end
+            else
+              div(class: SECTION_CLASS) do
+                header_block
+                grid(&fields_block)
+              end
+            end
+          end
+
+          private
+
+          def header_block
+            return if @section.ungrouped? && @section.options[:label].nil?
+            h3(class: HEADING_CLASS) { heading_text }
+            describe
+          end
+
+          def heading_text = @section.label
+
+          def describe
+            return unless @section.description
+            p(class: DESCRIPTION_CLASS) { @section.description }
+          end
+
+          def grid(&fields_block)
+            div(class: @grid_class, &fields_block)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/plutonium/ui/form/resource.rb

@@ -98,11 +98,81 @@ module Plutonium
         end
 
         def render_fields
-          fields_wrapper {
-            resource_fields.each { |name|
-              render_resource_field name
+          sections = resolve_form_layout
+          if sections.nil?
+            fields_wrapper {
+              resource_fields.each { |name| render_resource_field name }
             }
-          }
+          else
+            sections.each { |rs| render_form_section(rs) }
+          end
+        end
+
+        # Resolve the whole form layout for THIS render, in one pass: drop
+        # condition-hidden sections and evaluate any proc-valued options, all in
+        # the form instance context (where `object`, `current_user`, `params` and
+        # helpers live — same context as input/section `condition:`). Returns nil
+        # when no form_layout is declared (caller falls back to a single grid).
+        def resolve_form_layout
+          sections = resource_definition.resolve_form_sections(resource_fields)
+          return nil if sections.nil?
+
+          sections.filter_map do |resolved|
+            section = resolved.section
+            condition = section.condition
+            next if condition && !instance_exec(&condition)
+
+            # `columns` stays a validated literal; everything else may be a proc.
+            options = section.options.to_h do |key, value|
+              [key, (key != :condition && value.is_a?(Proc)) ? instance_exec(&value) : value]
+            end
+            Plutonium::Definition::FormLayout::ResolvedSection.new(
+              section: Plutonium::Definition::FormLayout::Section.new(
+                key: section.key, fields: section.fields, options: options.freeze
+              ),
+              fields: resolved.fields
+            )
+          end
+        end
+
+        # Pure presentation — the section is already resolved (visible, options
+        # evaluated) by resolve_form_layout.
+        def render_form_section(resolved)
+          section = resolved.section
+          render Plutonium::UI::Form::Components::Section.new(
+            resolved, grid_class: section_grid_class(section.columns)
+          ) do
+            # Inside a multi-column section, let fields flow into the grid cells
+            # instead of forcing each to span the full row (see col-span default
+            # in render_simple_resource_field).
+            previous = @section_columns
+            @section_columns = section.columns
+            begin
+              resolved.fields.each { |name| render_resource_field name }
+            ensure
+              @section_columns = previous
+            end
+          end
+        end
+
+        # True while rendering fields inside a section that declared an explicit
+        # column count > 1. Such fields default to a single grid cell rather than
+        # `col-span-full`, so the section's grid actually lays out in columns.
+        def in_multi_column_section?
+          @section_columns.to_i > 1
+        end
+
+        # nil → the form's default responsive grid; an Integer overrides columns.
+        def section_grid_class(columns)
+          return themed(:fields_wrapper, nil) if columns.nil?
+
+          base = "grid gap-6 grid-flow-row-dense grid-cols-1"
+          case columns.to_i
+          when 1 then base
+          when 2 then "#{base} md:grid-cols-2"
+          when 3 then "#{base} md:grid-cols-2 lg:grid-cols-3"
+          else "#{base} md:grid-cols-2 2xl:grid-cols-#{columns.to_i}"
+          end
         end
 
         def render_actions
@@ -232,10 +302,18 @@ module Plutonium
             end
           else
             wrapper_options = input_options[:wrapper] || {}
+            # Only supply a default column span when the field hasn't declared its
+            # own (via `wrapper: {class: "col-span-..."}`). A field-level col-span
+            # ALWAYS wins — including inside a section with `columns:` — so authors
+            # can opt a single field back to full width in a multi-column section,
+            # or vice versa.
+            # TODO: remove the string check once theming supports class merges.
             if !wrapper_options[:class] || !wrapper_options[:class].include?("col-span")
-              # temp hack to allow col span overrides
-              # TODO: remove once we complete theming, which will support merges
-              wrapper_options[:class] = tokens("col-span-full", wrapper_options[:class])
+              # In a multi-column section the field flows into a single grid cell
+              # (no col-span), so the declared `columns:` actually takes effect.
+              # Everywhere else fields span the full row.
+              default_span = in_multi_column_section? ? nil : "col-span-full"
+              wrapper_options[:class] = tokens(default_span, wrapper_options[:class])
             end
 
             render form.field(name, **field_options).wrapped(

data/lib/plutonium/ui/table/components/toolbar.rb

@@ -8,7 +8,7 @@ module Plutonium
         # inline search, and column config / overflow icon buttons into a single
         # tight strip rendered above the table when shell == :modern.
         class Toolbar < Plutonium::UI::Component::Base
-          def initialize(query:, search_url:, search_param: :q, search_value: nil, views: [:table], current_view: :table, view_cookie_name: nil, view_cookie_path: "/")
+          def initialize(query:, search_url:, search_param: :q, search_value: nil, views: [:table], current_view: :table, view_cookie_name: nil, view_cookie_path: "/", export: nil)
             @query = query
             @search_url = search_url
             @search_param = search_param
@@ -17,10 +17,11 @@ module Plutonium
             @current_view = current_view
             @view_cookie_name = view_cookie_name
             @view_cookie_path = view_cookie_path
+            @export = export
           end
 
           def render?
-            @views.size > 1 || has_filters? || has_search?
+            @views.size > 1 || has_filters? || has_search? || @export.present?
           end
 
           def view_template
@@ -29,11 +30,17 @@ module Plutonium
               render switcher
               render_divider if switcher.render?
               render_filter_button
+              render_export_button if @export
               div(class: "flex-1")
               render_search if has_search?
             end
           end
 
+          # Export split button, rendered just after the Filter button.
+          def render_export_button
+            render Plutonium::UI::ExportButton.new(**@export)
+          end
+
           private
 
           def has_filters?

data/lib/plutonium/ui/table/resource.rb

@@ -47,10 +47,27 @@ module Plutonium
             views: resource_definition.defined_index_views,
             current_view: :table,
             view_cookie_name: Plutonium::UI::Page::Index.view_cookie_name(resource_class),
-            view_cookie_path: Plutonium::UI::Page::Index.view_cookie_path(request)
+            view_cookie_path: Plutonium::UI::Page::Index.view_cookie_path(request),
+            export: export_toolbar_config
           )
         end
 
+        # Export split-button config, or nil when the policy forbids export.
+        # The primary link carries the current query (selected scope + filters
+        # + search); "Export all" carries `?all=1`.
+        def export_toolbar_config
+          return nil unless current_policy.allowed_to?(:export_csv?)
+
+          {
+            scoped_url: resource_url_for(resource_class, action: :export_csv, **export_query_params),
+            all_url: resource_url_for(resource_class, action: :export_csv, all: 1)
+          }
+        end
+
+        def export_query_params
+          params[:q].present? ? {q: params[:q].to_unsafe_h} : {}
+        end
+
         def render_filter_pills
           TableFilterPills(query: current_query_object, total_count: pagy_instance&.count)
         end

data/lib/plutonium/version.rb

@@ -1,5 +1,5 @@
 module Plutonium
-  VERSION = "0.58.1"
+  VERSION = "0.60.0"
   NEXT_MAJOR_VERSION = VERSION.split(".").tap { |v|
     v[1] = v[1].to_i + 1
     v[2] = 0

data/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@radioactive-labs/plutonium",
-  "version": "0.58.1",
+  "version": "0.60.0",
   "description": "Build production-ready Rails apps in minutes, not days. Convention-driven, fully customizable, AI-ready.",
   "type": "module",
   "main": "src/js/core.js",

data/plutonium.gemspec

@@ -51,6 +51,7 @@ Gem::Specification.new do |spec|
 
   spec.add_dependency "zeitwerk"
   spec.add_dependency "rails", ">= 7.2"
+  spec.add_dependency "csv" # CSV export; no longer a default gem on Ruby 3.4+
   spec.add_dependency "listen", "~> 3.8"
   spec.add_dependency "pagy", "~> 43.0"
   spec.add_dependency "rabl", "~> 0.17.0" # TODO: what to do with RABL

data/src/css/slim_select.css

@@ -43,9 +43,11 @@
   border-radius: var(--pu-radius-md);
   color: var(--pu-text);
 }
+
 .ss-main:hover {
   border-color: var(--pu-border-strong);
 }
+
 .ss-main:focus,
 .ss-main[aria-expanded="true"] {
   border-color: var(--pu-input-focus-ring);
@@ -196,9 +198,11 @@
   font-size: inherit;
   line-height: inherit;
 }
+
 .ss-content .ss-search input::placeholder {
   color: var(--pu-input-placeholder);
 }
+
 .ss-content .ss-search input:focus {
   border-color: var(--pu-input-focus-ring);
   box-shadow: 0 0 0 3px theme(colors.primary.500 / 15%);
@@ -225,7 +229,7 @@
 
 /* List */
 .ss-content .ss-list {
-  @apply flex-auto h-auto overflow-x-hidden overflow-y-auto;
+  @apply flex-auto h-auto overflow-x-hidden overflow-y-auto mb-2;
 }
 
 .ss-content .ss-list .ss-error {
@@ -345,10 +349,12 @@
 .ss-main.ss-invalid {
   @apply border-danger-500 bg-danger-50/50 text-danger-900;
 }
+
 .ss-main.ss-invalid:focus,
 .ss-main.ss-invalid[aria-expanded="true"] {
   box-shadow: 0 0 0 3px theme(colors.danger.500 / 15%);
 }
+
 .dark .ss-main.ss-invalid {
   @apply bg-danger-950/20 border-danger-500/70 text-danger-200;
 }
@@ -360,10 +366,12 @@
 .ss-main.ss-valid {
   @apply border-success-500 bg-success-50/50 text-success-900;
 }
+
 .ss-main.ss-valid:focus,
 .ss-main.ss-valid[aria-expanded="true"] {
   box-shadow: 0 0 0 3px theme(colors.success.500 / 15%);
 }
+
 .dark .ss-main.ss-valid {
   @apply bg-success-950/20 border-success-500/70 text-success-200;
 }
@@ -385,7 +393,8 @@
   width: 100% !important;
   border-radius: 0 !important;
   margin: 0 !important;
-  pointer-events: none !important; /* Disabled by default */
+  pointer-events: none !important;
+  /* Disabled by default */
 }
 
 /* When active (dropdown is expanded), enable pointer events */

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: plutonium
 version: !ruby/object:Gem::Version
-  version: 0.58.1
+  version: 0.60.0
 platform: ruby
 authors:
 - Stefan Froelich
 bindir: exe
 cert_chain: []
-date: 2026-06-10 00:00:00.000000000 Z
+date: 2026-06-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: zeitwerk
@@ -37,6 +37,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '7.2'
+- !ruby/object:Gem::Dependency
+  name: csv
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: listen
   requirement: !ruby/object:Gem::Requirement
@@ -641,6 +655,7 @@ files:
 - docs/reference/index.md
 - docs/reference/resource/actions.md
 - docs/reference/resource/definition.md
+- docs/reference/resource/export.md
 - docs/reference/resource/index.md
 - docs/reference/resource/model.md
 - docs/reference/resource/query.md
@@ -670,6 +685,8 @@ files:
 - docs/superpowers/plans/2026-06-02-structured-inputs.md.tasks.json
 - docs/superpowers/plans/2026-06-04-sqlite-tune-maintenance-generators.md
 - docs/superpowers/plans/2026-06-04-sqlite-tune-maintenance-generators.md.tasks.json
+- docs/superpowers/plans/2026-06-14-form-sectioning.md
+- docs/superpowers/plans/2026-06-14-form-sectioning.md.tasks.json
 - docs/superpowers/specs/2026-04-08-plutonium-skills-overhaul-design.md
 - docs/superpowers/specs/2026-04-14-plutonium-testing-design.md
 - docs/superpowers/specs/2026-05-07-ui-layout-overhaul-design.md
@@ -680,6 +697,8 @@ files:
 - docs/superpowers/specs/2026-05-29-avatar-component-design.md
 - docs/superpowers/specs/2026-06-01-structured-inputs-design.md
 - docs/superpowers/specs/2026-06-04-sqlite-tune-maintenance-generators-design.md
+- docs/superpowers/specs/2026-06-12-export-csv-default-action-design.md
+- docs/superpowers/specs/2026-06-14-form-sectioning-design.md
 - esbuild.config.js
 - exe/pug
 - gemfiles/rails_7.gemfile
@@ -888,6 +907,7 @@ files:
 - lib/generators/pu/rodauth/templates/app/controllers/plugin_controller.rb.tt
 - lib/generators/pu/rodauth/templates/app/controllers/rodauth_controller.rb.tt
 - lib/generators/pu/rodauth/templates/app/interactions/invite_admin_interaction.rb.tt
+- lib/generators/pu/rodauth/templates/app/interactions/resend_admin_interaction.rb.tt
 - lib/generators/pu/rodauth/templates/app/mailers/account_mailer.rb.tt
 - lib/generators/pu/rodauth/templates/app/mailers/rodauth_mailer.rb.tt
 - lib/generators/pu/rodauth/templates/app/models/account.rb.tt
@@ -979,6 +999,7 @@ files:
 - lib/plutonium/definition/base.rb
 - lib/plutonium/definition/config_attr.rb
 - lib/plutonium/definition/defineable_props.rb
+- lib/plutonium/definition/form_layout.rb
 - lib/plutonium/definition/index_views.rb
 - lib/plutonium/definition/inheritable_config_attr.rb
 - lib/plutonium/definition/metadata.rb
@@ -1045,6 +1066,7 @@ files:
 - lib/plutonium/resource/controllers/crud_actions.rb
 - lib/plutonium/resource/controllers/crud_actions/index_action.rb
 - lib/plutonium/resource/controllers/defineable.rb
+- lib/plutonium/resource/controllers/export_csv.rb
 - lib/plutonium/resource/controllers/interactive_actions.rb
 - lib/plutonium/resource/controllers/presentable.rb
 - lib/plutonium/resource/controllers/queryable.rb
@@ -1105,6 +1127,7 @@ files:
 - lib/plutonium/ui/dyna_frame/content.rb
 - lib/plutonium/ui/dyna_frame/host.rb
 - lib/plutonium/ui/empty_card.rb
+- lib/plutonium/ui/export_button.rb
 - lib/plutonium/ui/form/base.rb
 - lib/plutonium/ui/form/components/easymde.rb
 - lib/plutonium/ui/form/components/flatpickr.rb
@@ -1113,6 +1136,7 @@ files:
 - lib/plutonium/ui/form/components/json.rb
 - lib/plutonium/ui/form/components/key_value_store.rb
 - lib/plutonium/ui/form/components/resource_select.rb
+- lib/plutonium/ui/form/components/section.rb
 - lib/plutonium/ui/form/components/secure_association.rb
 - lib/plutonium/ui/form/components/secure_polymorphic_association.rb
 - lib/plutonium/ui/form/components/sticky_footer.rb