plutonium 0.55.0 → 0.56.0

data/lib/generators/pu/lite/tune/tune_generator.rb

@@ -0,0 +1,105 @@
+# frozen_string_literal: true
+
+require_relative "../../lib/plutonium_generators"
+
+module Pu
+  module Lite
+    class TuneGenerator < Rails::Generators::Base
+      include PlutoniumGenerators::Generator
+
+      desc "Tune config/database.yml with performance pragmas for SQLite"
+
+      RAILS_8_1 = ::Gem::Version.new("8.1.0")
+      DATABASE_YML = "config/database.yml"
+
+      def start
+        path = File.expand_path(DATABASE_YML, destination_root)
+        unless File.exist?(path)
+          log :skip, "#{DATABASE_YML} not found"
+          return
+        end
+
+        content = File.read(path)
+        if content.include?("wal_autocheckpoint")
+          log :skip, "pragmas already tuned in #{DATABASE_YML}"
+          return
+        end
+
+        new_content = apply_pragmas(content, rails_version)
+        if new_content == content
+          log :skip, "no `default: &default` block in #{DATABASE_YML}"
+          return
+        end
+
+        create_file DATABASE_YML, new_content, force: true
+        say_status :tune, "added SQLite pragmas to #{DATABASE_YML}"
+      rescue => e
+        exception "#{self.class} failed:", e
+      end
+
+      private
+
+      # Pure: returns content with pragmas inserted into the `default: &default`
+      # block. Merges into an existing default-level `pragmas:` mapping (2-space
+      # indent) if present, otherwise inserts a fresh pragmas block. Returns the
+      # content unchanged when there is no default anchor. Scoped to the default
+      # block so a `pragmas:` nested under another env (e.g. production.primary)
+      # is never touched.
+      def apply_pragmas(content, version)
+        anchor = content.match(/^default: &default\n/)
+        return content unless anchor
+
+        body_start = anchor.end(0)
+        rest = content[body_start..]
+        # the default block runs until the next top-level (column-0) line
+        next_top = rest =~ /^\S/
+        default_body = next_top ? rest[0...next_top] : rest
+        tail = next_top ? rest[next_top..] : ""
+
+        if default_body.match?(/^  pragmas:\s*$/)
+          new_body = default_body.sub(/^(  pragmas:[ \t]*\n)/) { $1 + pragma_keys(version) }
+          content[0...body_start] + new_body + tail
+        else
+          content.sub(/^default: &default\n/, "default: &default\n" + pragma_block(version))
+        end
+      end
+
+      def pragma_block(version)
+        comment = <<~COMMENT.gsub(/^/, "  ")
+          # Plutonium-tuned SQLite pragmas (pu:lite:tune).
+          # Rails 8.1+ already sets WAL, synchronous=NORMAL, foreign_keys,
+          # mmap=128MB and journal_size_limit by default; only deltas are added
+          # there. We intentionally do NOT set SQLite's internal busy pragma —
+          # Rails routes the `timeout:` key to the sqlite3 gem's constant-poll
+          # busy_handler_timeout, which has better tail-latency than SQLite's
+          # backoff.
+          pragmas:
+        COMMENT
+        comment + pragma_keys(version)
+      end
+
+      def pragma_keys(version)
+        keys = +""
+        if version < RAILS_8_1
+          keys << <<~YAML.gsub(/^/, "    ")
+            journal_mode: WAL
+            synchronous: NORMAL
+            foreign_keys: true
+            journal_size_limit: 67108864 # 64 MB
+          YAML
+        end
+        keys << <<~YAML.gsub(/^/, "    ")
+          cache_size: -64000           # 64 MB page cache (default ~2 MB is too small)
+          temp_store: 2                # MEMORY — sorts/temp indexes stay off disk
+          mmap_size: 536870912         # 512 MB (override the 128 MB default)
+          wal_autocheckpoint: 10000    # checkpoint every ~40 MB of WAL, fewer pauses
+        YAML
+        keys
+      end
+
+      def rails_version
+        @rails_version ||= ::Gem::Version.new(Rails::VERSION::STRING).release
+      end
+    end
+  end
+end

data/lib/plutonium/models/has_cents.rb

@@ -166,6 +166,16 @@ module Plutonium
         def has_cents_attribute?(attribute)
           has_cents_attributes.key?(attribute.to_sym)
         end
+
+        # Checks if a given attribute is the decimal accessor of a has_cents pair
+        # (e.g. :amount for `has_cents :amount_cents`).
+        #
+        # @param attribute [Symbol] The attribute to check
+        # @return [Boolean]
+        def has_cents_decimal_attribute?(attribute)
+          attribute = attribute.to_sym
+          has_cents_attributes.any? { |_, opts| opts[:name] == attribute }
+        end
       end
     end
   end

data/lib/plutonium/resource/controllers/interactive_actions.rb

@@ -244,9 +244,26 @@ module Plutonium
         # @return [Hash] The submitted interaction parameters
         def submitted_interaction_params
           @submitted_interaction_params ||= begin
-            interaction = current_interactive_action.interaction
+            action = current_interactive_action
+            interaction = action.interaction
+            instance = interaction.new(view_context:)
+            # Bind the action's subject before the form is rendered for param
+            # extraction. extract_input renders the form when it hasn't been
+            # rendered yet, which eagerly materializes input choices — any
+            # `choices:` proc (or other render-time config) that reads the
+            # subject would otherwise run against a nil resource/resources and
+            # raise a deep-stack NoMethodError before the interaction ever runs.
+            # This mirrors the subject the real instance is given in
+            # build_interactive_*_action_interaction. interaction_params still
+            # strips :resource/:resources from the extracted params, so
+            # mass-assignment safety is unaffected.
+            if action.record_action? || action.collection_record_action?
+              instance.resource = resource_record!
+            elsif action.bulk_action?
+              instance.resources = interactive_bulk
+            end
             extracted = interaction
-              .build_form(interaction.new(view_context:))
+              .build_form(instance)
               .extract_input(params, view_context:)[:interaction]
             clean_structured_inputs(interaction, extracted)
           end

data/lib/plutonium/routing/mapper_extensions.rb

@@ -99,8 +99,13 @@ module Plutonium
           next unless base_config
 
           # Register with association-based key: "parent_plural/association_name"
+          # Force route_type: :resources — has_many associations always nest as a
+          # plural (member-with-id) route, even when the child resource is registered
+          # `singular: true` at the top level (which would otherwise leak :resource
+          # into base_config and make member URL helpers resolve to the wrong name).
           nested_key = "#{resource.model_name.plural}/#{assoc_info[:name]}"
           nested_config = base_config.merge(
+            route_type: :resources,
             association_name: assoc_info[:name],
             resource_class: assoc_info[:klass]
           )

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

@@ -34,6 +34,15 @@ module Plutonium
             create_component(Plutonium::UI::Display::Components::Color, :color, **, &)
           end
 
+          def badge_tag(**, &)
+            create_component(Plutonium::UI::Display::Components::Badge, :badge, **, &)
+          end
+          alias_method :enum_tag, :badge_tag
+
+          def currency_tag(**, &)
+            create_component(Plutonium::UI::Display::Components::Currency, :currency, **, &)
+          end
+
           # Type aliases for common column types
           alias_method :float_tag, :number_tag
           alias_method :decimal_tag, :number_tag

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

@@ -191,12 +191,24 @@ 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: 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
 
@@ -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

@@ -115,45 +115,12 @@ module Plutonium
                 div(class: FIELD_GRID_CLASS) do
                   fields.each { |input| render_simple_resource_field(input, definition, nested) }
                 end
-                render_structured_remove_button
-              end
-              render_structured_removed_bar
-            end
-          end
-
-          def render_structured_remove_button
-            div(class: "flex items-center justify-end") do
-              button(
-                type: :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",
-                data_action: "structured-input-row#remove"
-              ) do
-                render Phlex::TablerIcons::Trash.new(class: "w-4 h-4")
-                span { "Remove" }
-              end
-            end
-          end
-
-          # Compact bar shown in place of the row once it's marked for removal.
-          def render_structured_removed_bar
-            div(
-              data_structured_input_row_target: "removed",
-              hidden: true,
-              class: "flex items-center justify-between gap-3 text-sm text-[var(--pu-text-muted)]"
-            ) do
-              span(class: "italic") { "Removed" }
-              button(
-                type: :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-50 dark:text-secondary-300 dark:hover:bg-secondary-900/30 " \
-                       "focus:outline-none focus:ring-4 focus:ring-secondary-200 dark:focus:ring-secondary-900",
-                data_action: "structured-input-row#restore"
-              ) do
-                render Phlex::TablerIcons::ArrowBackUp.new(class: "w-4 h-4")
-                span { "Restore" }
+                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
 

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,6 +4,7 @@ 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