plutonium 0.54.0 → 0.56.0

data/lib/plutonium/ui/display/components/badge.rb

@@ -0,0 +1,83 @@
+# frozen_string_literal: true
+
+require "digest"
+
+module Plutonium
+  module UI
+    module Display
+      module Components
+        # Renders a scalar value (typically an enum / status) as a colored pill.
+        #
+        #   display :status, as: :badge
+        #   display :status, as: :badge, colors: {archived: :neutral, vip: :accent}
+        class Badge < Phlexi::Display::Components::Base
+          include Phlexi::Display::Components::Concerns::DisplaysValue
+
+          VARIANTS = %i[neutral primary secondary success danger warning info accent].freeze
+
+          # Decorative variants used for values with no semantic meaning, chosen
+          # deterministically so a given value always gets the same color.
+          DECORATIVE = %i[primary secondary info accent].freeze
+
+          SEMANTIC_VARIANTS = {
+            "active" => :success, "approved" => :success, "completed" => :success,
+            "complete" => :success, "success" => :success, "succeeded" => :success,
+            "paid" => :success, "published" => :success, "enabled" => :success,
+            "confirmed" => :success, "verified" => :success, "live" => :success,
+            "available" => :success, "fulfilled" => :success, "done" => :success,
+            "pending" => :warning, "processing" => :warning, "in_progress" => :warning,
+            "draft" => :warning, "review" => :warning, "waiting" => :warning,
+            "scheduled" => :warning, "trial" => :warning, "paused" => :warning,
+            "on_hold" => :warning, "partial" => :warning,
+            "failed" => :danger, "rejected" => :danger, "cancelled" => :danger,
+            "canceled" => :danger, "error" => :danger, "inactive" => :danger,
+            "disabled" => :danger, "expired" => :danger, "banned" => :danger,
+            "blocked" => :danger, "closed" => :danger, "unpaid" => :danger,
+            "overdue" => :danger, "refunded" => :danger, "declined" => :danger,
+            "new" => :info, "queued" => :info, "open" => :info, "info" => :info
+          }.freeze
+
+          def self.variant_for(value, colors: nil)
+            return :neutral if value.nil?
+
+            if colors
+              override = colors[value] || colors[value.to_s.to_sym] || colors[value.to_s]
+              return override if override && VARIANTS.include?(override.to_sym)
+            end
+
+            key = value.to_s.downcase
+            SEMANTIC_VARIANTS[key] || decorative_variant_for(key)
+          end
+
+          # Stable across processes (String#hash is seeded, so we digest instead).
+          def self.decorative_variant_for(key)
+            index = Digest::SHA256.hexdigest(key)[0, 8].to_i(16) % DECORATIVE.size
+            DECORATIVE[index]
+          end
+
+          def self.humanize(value)
+            value.to_s.humanize
+          end
+
+          def render_value(value)
+            variant = self.class.variant_for(value, colors: @colors)
+            span(**attributes, class: tokens("pu-badge", "pu-badge-#{variant}")) do
+              plain self.class.humanize(value)
+            end
+          end
+
+          protected
+
+          def build_attributes
+            @colors = attributes.delete(:colors)
+            super
+          end
+
+          def normalize_value(value)
+            value
+          end
+        end
+      end
+    end
+  end
+end

data/lib/plutonium/ui/display/components/boolean.rb

@@ -4,18 +4,40 @@ module Plutonium
   module UI
     module Display
       module Components
+        # Renders a boolean as a colored "Yes" / "No" pill with a leading icon.
         class Boolean < Phlexi::Display::Components::Base
           include Phlexi::Display::Components::Concerns::DisplaysValue
 
           def render_value(value)
-            p(**attributes) do
-              if value
-                render Phlex::TablerIcons::Check.new(class: "inline-block w-5 h-5 text-green-600")
-              else
-                render Phlex::TablerIcons::X.new(class: "inline-block w-5 h-5 text-red-500")
-              end
+            if value
+              pill(label: true_label, variant: "pu-badge-success", icon: Phlex::TablerIcons::Check)
+            else
+              pill(label: false_label, variant: "pu-badge-neutral", icon: Phlex::TablerIcons::X)
             end
           end
+
+          private
+
+          def pill(label:, variant:, icon:)
+            span(**attributes, class: tokens("pu-badge", variant), "aria-label": label) do
+              render icon.new(class: "w-3.5 h-3.5")
+              plain label
+            end
+          end
+
+          def true_label = @true_label || "Yes"
+
+          def false_label = @false_label || "No"
+
+          def build_attributes
+            @true_label = attributes.delete(:true_label)
+            @false_label = attributes.delete(:false_label)
+            super
+          end
+
+          # Keep the real boolean — the default stringifies, turning `false` into
+          # the truthy string "false".
+          def normalize_value(value) = value
         end
       end
     end

data/lib/plutonium/ui/display/components/currency.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+require "active_support/number_helper"
+
+module Plutonium
+  module UI
+    module Display
+      module Components
+        # Renders a numeric value as currency (delimited, 2 decimals). No symbol
+        # by default; pass a literal `unit:` ("£") or a Symbol read off the
+        # record (`unit: :currency_symbol`) for per-row currencies.
+        #
+        #   display :price, as: :currency
+        #   display :price, as: :currency, unit: "£"
+        #   display :price, as: :currency, unit: :currency_symbol
+        class Currency < Phlexi::Display::Components::Base
+          include Phlexi::Display::Components::Concerns::DisplaysValue
+
+          def render_value(value)
+            p(**attributes) { format_currency(value) }
+          end
+
+          protected
+
+          def build_attributes
+            @unit = attributes.delete(:unit)
+            @options = attributes.delete(:options) || {}
+            super
+          end
+
+          private
+
+          def format_currency(value)
+            ActiveSupport::NumberHelper.number_to_currency(value, unit: resolved_unit, **@options)
+          end
+
+          def resolved_unit
+            case @unit
+            when nil then ""
+            when Symbol then field.object.public_send(@unit)
+            else @unit
+            end
+          end
+
+          def normalize_value(value) = value
+        end
+      end
+    end
+  end
+end

data/lib/plutonium/ui/display/options/inferred_types.rb

@@ -8,13 +8,26 @@ module Plutonium
           private
 
           def infer_field_component
+            # has_cents decimal accessors infer as :float/:decimal; render money.
+            return :currency if has_cents_field?
+
             case inferred_field_type
             when :attachment
               :attachment
+            when :boolean
+              # phlexi-display falls back to :string, rendering "true"/"false".
+              :boolean
+            when :enum
+              :badge
             else
               super
             end
           end
+
+          def has_cents_field?
+            klass = object.class
+            klass.respond_to?(:has_cents_decimal_attribute?) && klass.has_cents_decimal_attribute?(key)
+          end
         end
       end
     end

data/lib/plutonium/ui/display/theme.rb

@@ -25,6 +25,11 @@ module Plutonium
             color: "flex items-center text-lg text-[var(--pu-text)] whitespace-pre-line",
             color_indicator: "w-10 h-10 rounded-lg mr-3 shadow-sm border border-[var(--pu-border)]",
 
+            # Boolean / badge pills — variant class is applied by the component.
+            boolean: "",
+            badge: "",
+            currency: "text-lg text-[var(--pu-text)] tabular-nums",
+
             # Contact info
             email: "flex items-center gap-2 text-lg text-primary-600 dark:text-primary-400 hover:text-primary-500 transition-colors",
             phone: "flex items-center gap-2 text-lg text-primary-600 dark:text-primary-400 hover:text-primary-500 transition-colors",

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

@@ -42,6 +42,11 @@ module Plutonium
           end
           alias_method :markdown_tag, :easymde_tag
 
+          def toggle_tag(**, &)
+            create_component(Plutonium::UI::Form::Components::Toggle, :toggle, **, &)
+          end
+          alias_method :switch_tag, :toggle_tag
+
           def slim_select_tag(**attributes, &)
             attributes[:data_controller] = tokens(attributes[:data_controller], "slim-select")
             select_tag(**attributes, required: false, class!: "", &)

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

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Plutonium
+  module UI
+    module Form
+      module Components
+        # Switch-styled boolean input (`input :notify, as: :toggle`). Identical
+        # behavior to the checkbox; only the `.pu-toggle` styling differs.
+        class Toggle < Phlexi::Form::Components::Checkbox
+        end
+      end
+    end
+  end
+end

data/lib/plutonium/ui/form/concerns/renders_nested_resource_fields.rb

@@ -10,7 +10,7 @@ module Plutonium
         module RendersNestedResourceFields
           extend ActiveSupport::Concern
 
-          DEFAULT_NESTED_LIMIT = 10
+          DEFAULT_NESTED_LIMIT = RepeaterFieldStyles::DEFAULT_LIMIT
           NESTED_OPTION_KEYS = [:allow_destroy, :update_only, :macro, :class].freeze
           SINGULAR_MACROS = %i[belongs_to has_one].freeze
 
@@ -191,17 +191,29 @@ module Plutonium
           end
 
           def render_nested_fields_fieldset(nested, context)
+            removable = !nested.object&.persisted? || context.options[:allow_destroy]
             fieldset(
               data_new_record: !nested.object&.persisted?,
-              class: "nested-resource-form-fields border border-[var(--pu-border)] rounded-[var(--pu-radius-md)] p-4 space-y-4 relative"
+              class: RepeaterFieldStyles::FIELDSET_CLASS
             ) do
-              render_nested_fields_fieldset_content(nested, context)
-              render_nested_fields_delete_button(nested, context.options)
+              # Content is wrapped so the controller can hide it (and reveal the
+              # removed bar) on remove without disturbing the row itself, leaving
+              # the hidden _destroy field in place to submit the deletion.
+              div(data_nested_content: "") do
+                render_nested_fields_fieldset_content(nested, context)
+                render_repeater_remove_button(action: "nested-resource-form-fields#remove") if removable
+              end
+              if removable
+                render_repeater_removed_bar(
+                  restore_action: "nested-resource-form-fields#restore",
+                  data_nested_removed: ""
+                )
+              end
             end
           end
 
           def render_nested_fields_fieldset_content(nested, context)
-            div(class: "grid grid-cols-1 md:grid-cols-2 2xl:grid-cols-4 gap-4 grid-flow-row-dense") do
+            div(class: RepeaterFieldStyles::FIELD_GRID_CLASS) do
               render_nested_fields_hidden_fields(nested, context)
               render_nested_fields_visible_fields(nested, context)
             end
@@ -220,29 +232,6 @@ module Plutonium
             end
           end
 
-          def render_nested_fields_delete_button(nested, options)
-            return unless !nested.object&.persisted? || options[:allow_destroy]
-
-            render_nested_fields_delete_button_content
-          end
-
-          def render_nested_fields_delete_button_content
-            div(class: "flex items-center justify-end") do
-              label(class: "inline-flex items-center text-md font-medium text-red-900 cursor-pointer") do
-                plain "Delete"
-                render_nested_fields_delete_checkbox
-              end
-            end
-          end
-
-          def render_nested_fields_delete_checkbox
-            input(
-              type: :checkbox,
-              class: "w-4 h-4 ms-2 text-danger-600 bg-danger-100 border-danger-300 rounded focus:ring-danger-500 dark:focus:ring-danger-600 focus:ring-2 dark:bg-[var(--pu-surface-alt)] dark:border-[var(--pu-border)] cursor-pointer",
-              data_action: "nested-resource-form-fields#remove"
-            )
-          end
-
           def render_nested_fields_add_button(context)
             div do
               button(

data/lib/plutonium/ui/form/concerns/renders_repeater_row_controls.rb

@@ -0,0 +1,67 @@
+# frozen_string_literal: true
+
+module Plutonium
+  module UI
+    module Form
+      module Concerns
+        # Shared chrome for removable repeater rows (structured inputs and
+        # nested resource fields): the "Remove" button and the compact
+        # "Removed — Restore" accent bar shown in its place. Centralising these
+        # keeps the two concerns visually in lockstep.
+        # @api private
+        module RendersRepeaterRowControls
+          extend ActiveSupport::Concern
+
+          private
+
+          REMOVE_BUTTON_CLASS =
+            "inline-flex items-center gap-1 px-3 py-1.5 text-sm font-medium rounded-lg cursor-pointer " \
+            "text-danger-700 hover:bg-danger-50 dark:text-danger-400 dark:hover:bg-danger-950/30 " \
+            "focus:outline-none focus:ring-4 focus:ring-danger-200 dark:focus:ring-danger-900"
+
+          RESTORE_BUTTON_CLASS =
+            "inline-flex items-center gap-1 px-3 py-1.5 text-sm font-medium rounded-lg cursor-pointer " \
+            "text-secondary-700 hover:bg-secondary-100 dark:text-secondary-300 dark:hover:bg-secondary-900/40 " \
+            "focus:outline-none focus:ring-4 focus:ring-secondary-200 dark:focus:ring-secondary-900"
+
+          # Right-aligned "Remove" button that triggers the row's remove action.
+          def render_repeater_remove_button(action:)
+            div(class: "flex items-center justify-end") do
+              button(type: :button, class: REMOVE_BUTTON_CLASS, data_action: action) do
+                render Phlex::TablerIcons::Trash.new(class: "w-4 h-4")
+                span { "Remove" }
+              end
+            end
+          end
+
+          # Compact accent bar shown in place of a removed row. Negative margin
+          # cancels the row's padding so the bar fills the fieldset edge-to-edge;
+          # a left danger stripe + struck-through label read as "pending delete".
+          #
+          # @param restore_action [String] Stimulus action for the Restore button
+          # @param label [String] text shown beside the trash icon
+          # @param bar_data [Hash] extra data attributes (Stimulus target/marker)
+          #   the controller uses to find and toggle this bar
+          def render_repeater_removed_bar(restore_action:, label: "Removed", **bar_data)
+            div(
+              hidden: true,
+              class: "-m-4 flex items-center justify-between gap-3 px-4 py-2.5 " \
+                     "rounded-[var(--pu-radius-md)] border-l-4 border-danger-400 dark:border-danger-600 " \
+                     "bg-danger-50/70 dark:bg-danger-950/20",
+              **bar_data
+            ) do
+              span(class: "inline-flex items-center gap-2 text-sm text-[var(--pu-text-muted)]") do
+                render Phlex::TablerIcons::Trash.new(class: "w-4 h-4 shrink-0 text-danger-500 dark:text-danger-400")
+                span(class: "line-through decoration-danger-400/60") { label }
+              end
+              button(type: :button, class: RESTORE_BUTTON_CLASS, data_action: restore_action) do
+                render Phlex::TablerIcons::ArrowBackUp.new(class: "w-4 h-4")
+                span { "Restore" }
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/plutonium/ui/form/concerns/renders_structured_inputs.rb

@@ -0,0 +1,145 @@
+# frozen_string_literal: true
+
+module Plutonium
+  module UI
+    module Form
+      module Concerns
+        # Renders classless structured inputs (single → hash via nest_one,
+        # repeater → array via nest_many). Field/namespace work is delegated to
+        # the form; this concern owns the structural markup.
+        # @api private
+        module RendersStructuredInputs
+          extend ActiveSupport::Concern
+
+          private
+
+          def render_structured_input(name)
+            entry = resource_definition.defined_structured_inputs[name]
+            options = entry[:options] || {}
+            definition = structured_input_fields_definition(entry)
+            fields = options[:fields] || definition.defined_inputs.keys
+            repeat = options[:repeat]
+
+            if repeat
+              render_structured_repeater(name, definition, fields, repeat_limit(repeat))
+            else
+              render_structured_single(name, definition, fields)
+            end
+          end
+
+          def structured_input_fields_definition(entry)
+            return entry[:options][:using] if entry[:options]&.key?(:using)
+
+            holder = Plutonium::Definition::StructuredInputs::FieldsDefinition.new
+            entry[:block].call(holder)
+            holder
+          end
+
+          def repeat_limit(repeat)
+            repeat.is_a?(Integer) ? repeat : RepeaterFieldStyles::DEFAULT_LIMIT
+          end
+
+          # --- single -------------------------------------------------------
+
+          def render_structured_single(name, definition, fields)
+            raw = structured_input_value(name)
+            value = raw.is_a?(Hash) ? raw.with_indifferent_access : {}
+            div(class: "col-span-full space-y-2 my-4") do
+              h2(class: "text-lg font-semibold text-[var(--pu-text)]") { name.to_s.humanize }
+              nest_one(name, as: name, object: value) do |nested|
+                render_structured_fieldset(nested, definition, fields, removable: false)
+              end
+            end
+          end
+
+          # --- repeater -----------------------------------------------------
+
+          def render_structured_repeater(name, definition, fields, limit)
+            rows = Array(structured_input_value(name)).map { |row| row.is_a?(Hash) ? row.with_indifferent_access : row }
+            existing_collection = rows.presence || {NEW_RECORD: {}}
+            div(
+              class: "col-span-full space-y-2 my-4",
+              data: {
+                controller: "nested-resource-form-fields",
+                nested_resource_form_fields_limit_value: limit
+              }
+            ) do
+              h2(class: "text-lg font-semibold text-[var(--pu-text)]") { name.to_s.humanize }
+              template data_nested_resource_form_fields_target: "template" do
+                nest_many(name, as: name, collection: {NEW_RECORD: {}}, default: {NEW_RECORD: {}}, template: true) do |nested|
+                  render_structured_fieldset(nested, definition, fields, removable: true)
+                end
+              end
+              nest_many(name, as: name, collection: existing_collection) do |nested|
+                if nested.object.blank?
+                  vanish { render_structured_fieldset(nested, definition, fields, removable: true) }
+                else
+                  render_structured_fieldset(nested, definition, fields, removable: true)
+                end
+              end
+              div(data_nested_resource_form_fields_target: :target, hidden: true)
+              render_structured_add_button(name)
+            end
+          end
+
+          # --- helpers ------------------------------------------------------
+
+          def structured_input_value(name)
+            obj = object
+            return nil unless obj.respond_to?(name)
+            obj.public_send(name)
+          end
+
+          # Single source of truth shared with RendersNestedResourceFields.
+          FIELDSET_CLASS = RepeaterFieldStyles::FIELDSET_CLASS
+          FIELD_GRID_CLASS = RepeaterFieldStyles::FIELD_GRID_CLASS
+
+          # @param removable [Boolean] repeater rows are removable; a single
+          #   structured input is the one-and-only object, so it is not.
+          def render_structured_fieldset(nested, definition, fields, removable:)
+            unless removable
+              return fieldset(class: FIELDSET_CLASS) do
+                div(class: FIELD_GRID_CLASS) do
+                  fields.each { |input| render_simple_resource_field(input, definition, nested) }
+                end
+              end
+            end
+
+            # Removable rows soft-delete by DISABLING the inner fieldset: a
+            # disabled <fieldset> is omitted from submission, so the server just
+            # receives the payload without this row and rebuilds the JSON column
+            # from what it gets (no _destroy marker). The row stays in the DOM,
+            # collapsed to a "Removed — Restore" bar, so it can be restored.
+            div(data_controller: "structured-input-row", class: FIELDSET_CLASS) do
+              fieldset(data_structured_input_row_target: "content", class: "space-y-4 border-0 p-0 m-0") do
+                div(class: FIELD_GRID_CLASS) do
+                  fields.each { |input| render_simple_resource_field(input, definition, nested) }
+                end
+                render_repeater_remove_button(action: "structured-input-row#remove")
+              end
+              render_repeater_removed_bar(
+                restore_action: "structured-input-row#restore",
+                data_structured_input_row_target: "removed"
+              )
+            end
+          end
+
+          def render_structured_add_button(name)
+            div do
+              button(
+                type: :button,
+                class: "inline-block",
+                data: {action: "nested-resource-form-fields#add", nested_resource_form_fields_target: "addButton"}
+              ) do
+                span(class: "bg-secondary-700 text-white flex items-center justify-center px-4 py-1.5 text-sm font-medium rounded-lg") do
+                  render Phlex::TablerIcons::Plus.new(class: "w-4 h-4 mr-1")
+                  span { "Add #{name.to_s.singularize.humanize}" }
+                end
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/plutonium/ui/form/concerns/repeater_field_styles.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module Plutonium
+  module UI
+    module Form
+      module Concerns
+        # Shared sizing + chrome for repeater-style field groups. Both
+        # RendersNestedResourceFields and RendersStructuredInputs render the
+        # same fieldset/grid markup and share a default row limit, so the
+        # values live here to keep the two concerns from drifting apart.
+        module RepeaterFieldStyles
+          # Default maximum number of rows a repeater renders/clones.
+          DEFAULT_LIMIT = 10
+
+          # Outer fieldset chrome for a single repeater row.
+          FIELDSET_CLASS = "nested-resource-form-fields border border-[var(--pu-border)] rounded-[var(--pu-radius-md)] p-4 space-y-4 relative"
+
+          # Responsive grid the row's fields are laid out in.
+          FIELD_GRID_CLASS = "grid grid-cols-1 md:grid-cols-2 2xl:grid-cols-4 gap-4 grid-flow-row-dense"
+        end
+      end
+    end
+  end
+end

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

@@ -27,8 +27,13 @@ module Plutonium
             )
           )
 
-          # Use existing infrastructure to build the URL
-          subject = action.record_action? ? resource_record! : resource_class
+          # Use existing infrastructure to build the URL.
+          # Record-level actions (shown on the show page AND/OR on collection rows)
+          # operate on a single record, so the commit URL must target the record.
+          # `record_action?` alone is wrong: a collection-row action can be
+          # surfaced with `record_action: false` while still being record-scoped.
+          record_scoped = action.record_action? || action.collection_record_action?
+          subject = record_scoped ? resource_record! : resource_class
           route_options_to_url(commit_route_options, subject)
         end
 

data/lib/plutonium/ui/form/options/inferred_types.rb

@@ -19,6 +19,8 @@ module Plutonium
               :slim_select
             when :date, :time, :datetime
               :flatpickr
+            when :boolean
+              :toggle
             else
               inferred_field_component
             end

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

@@ -4,7 +4,9 @@ module Plutonium
   module UI
     module Form
       class Resource < Base
+        include Plutonium::UI::Form::Concerns::RendersRepeaterRowControls
         include Plutonium::UI::Form::Concerns::RendersNestedResourceFields
+        include Plutonium::UI::Form::Concerns::RendersStructuredInputs
 
         attr_reader :resource_fields, :resource_definition, :singular_resource
 
@@ -171,7 +173,9 @@ module Plutonium
 
         def render_resource_field(name)
           when_permitted(name) do
-            if resource_definition.respond_to?(:defined_nested_inputs) && resource_definition.defined_nested_inputs[name]
+            if resource_definition.respond_to?(:defined_structured_inputs) && resource_definition.defined_structured_inputs[name]
+              render_structured_input(name)
+            elsif resource_definition.respond_to?(:defined_nested_inputs) && resource_definition.defined_nested_inputs[name]
               render_nested_resource_field(name)
             else
               render_simple_resource_field(name, resource_definition, self)

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

@@ -39,6 +39,11 @@ module Plutonium
             valid_boolean: "pu-checkbox",
             invalid_boolean: "pu-checkbox pu-input-invalid",
 
+            # Toggle switch (opt-in boolean input: `as: :toggle`)
+            toggle: "pu-toggle",
+            valid_toggle: "pu-toggle",
+            invalid_toggle: "pu-toggle pu-input-invalid",
+
             # Radio buttons
             radio_button: "pu-radio",
             collection_radio_buttons: "flex flex-col gap-2",
@@ -81,6 +86,13 @@ module Plutonium
             invalid_int_tel_input: :invalid_input,
             neutral_int_tel_input: :neutral_input,
 
+            # JSON / JSONB textarea — without this the component falls back to
+            # the neutral (classless) theme and loses pu-input's dark styling.
+            json: :input,
+            valid_json: :valid_input,
+            invalid_json: :invalid_input,
+            neutral_json: :neutral_input,
+
             # Uppy file upload
             uppy: :file,
             valid_uppy: :valid_file,