plutonium 0.52.0 → 0.53.0

data/lib/plutonium/action/base.rb

@@ -5,41 +5,9 @@ require "active_support/string_inquirer"
 module Plutonium
   module Action
     # Base class for all actions in the Plutonium framework.
-    #
-    # @attr_reader [Symbol] name The name of the action.
-    # @attr_reader [String] label The human-readable label for the action.
-    # @attr_reader [String, nil] icon The icon associated with the action.
-    # @attr_reader [RouteOptions] route_options The routing options for the action.
-    # @attr_reader [String, nil] confirmation The confirmation message for the action.
-    # @attr_reader [String, nil] turbo_frame The Turbo Frame ID for the action.
-    # @attr_reader [Symbol, nil] color The color associated with the action.
-    # @attr_reader [Symbol, nil] category The category of the action.
-    # @attr_reader [Integer] position The position of the action within its category.
     class Base
-      attr_reader :name, :label, :description, :icon, :route_options, :confirmation, :turbo, :turbo_frame, :color, :category, :position, :return_to, :modal
-
-      # Initialize a new action.
-      #
-      # @param [Symbol] name The name of the action.
-      # @param [Hash] options The options for the action.
-      # @option options [String] :label The human-readable label for the action.
-      # @option options [String] :description The human-readable description for the action.
-      # @option options [String] :icon The icon associated with the action (e.g., 'fa-edit' for Font Awesome).
-      # @option options [Symbol] :color The color associated with the action (e.g., :primary, :secondary, :success, :warning, :danger).
-      # @option options [String] :confirmation The confirmation message to display before executing the action.
-      # @option options [RouteOptions, Hash] :route_options The routing options for the action.
-      # @option options [String] :turbo_frame The Turbo Frame ID for the action (used in Hotwire/Turbo Drive applications).
-      # @option options [String, Symbol] :return_to Override the return_to URL for this action. If not provided, defaults to current URL.
-      # @option options [Boolean] :bulk_action (false) If true, applies to a bulk selection of records (e.g., "Mark Selected as Read").
-      # @option options [Boolean] :collection_record_action (false) If true, applies to records in a collection (e.g., "Edit Record" button in a table).
-      # @option options [Boolean] :record_action (false) If true, applies to an individual record (e.g., "Delete" button on a Show page).
-      # @option options [Boolean] :resource_action (false) If true, applies to the entire resource and can be used in any context (e.g., "Import from CSV").
-      # @option options [Symbol] :category The category of the action. Determines visibility and grouping.
-      #   Valid values include:
-      #   @option options [Symbol] :primary Always shown and given prominence in the UI.
-      #   @option options [Symbol] :secondary Shown in secondary menus or less prominent areas.
-      #   @option options [Symbol] :danger Actions that require caution, often destructive operations.
-      # @option options [Integer] :position (50) The position of the action in its group. Lower numbers appear first.
+      attr_reader :name, :label, :description, :icon, :route_options, :confirmation, :turbo, :color, :category, :position, :return_to
+
       def initialize(name, **options)
         @name = name.to_sym
         @label = options[:label] || @name.to_s.titleize
@@ -57,51 +25,53 @@ module Plutonium
         @resource_action = options[:resource_action] || false
         @category = ActiveSupport::StringInquirer.new((options[:category] || :secondary).to_s)
         @position = options[:position] || 50
-        @modal = options[:modal] || :centered
-        validate_modal!
+        @modal_mode = options[:modal]
+        @modal_size = options[:size]
+        validate_modal_mode!
+        validate_modal_size!
 
         freeze
       end
 
-      # @return [Boolean] Whether this is a bulk action.
-      def bulk_action?
-        @bulk_action
+      # Resolves to the definition's `modal_mode` when unset on the action.
+      def modal_mode(definition = nil)
+        return @modal_mode if @modal_mode || definition.nil?
+        definition.modal_mode
       end
 
-      # @return [Boolean] Whether this is a collection record action.
-      def collection_record_action?
-        @collection_record_action
+      # Resolves to the definition's `modal_size` when unset on the action.
+      def modal_size(definition = nil)
+        return @modal_size if @modal_size || definition.nil?
+        definition.modal_size
       end
 
-      # @return [Boolean] Whether this is a record action.
-      def record_action?
-        @record_action
+      # Downgrades the remote-modal frame to nil when the definition has
+      # `modal false`, so the link navigates as a full page instead of
+      # targeting a frame that won't exist. Other frames pass through.
+      def turbo_frame(definition = nil)
+        return nil if definition && targets_remote_modal? && definition.modal_mode == false
+        @turbo_frame
       end
 
-      # @return [Boolean] Whether this is a resource action.
-      def resource_action?
-        @resource_action
-      end
+      def bulk_action? = @bulk_action
+      def collection_record_action? = @collection_record_action
+      def record_action? = @record_action
+      def resource_action? = @resource_action
 
       def permitted_by?(policy)
         policy.allowed_to?(:"#{name}?")
       end
 
       # Returns a new Action with the given options merged over this one.
-      # Used by the resource definition to derive variants (e.g. dropping
-      # `turbo_frame` when `modal false` is configured) without mutating
-      # the frozen original.
       def with(**overrides)
         self.class.new(name, **to_options.merge(overrides))
       end
 
       protected
 
-      # Canonical representation for reconstruction via `with`. Every
+      # Canonical option hash for reconstruction via `with`. Every
       # attribute set in `initialize` MUST appear here; otherwise
       # `with(**overrides)` would silently drop it on round-trip.
-      # `category` is exposed as a Symbol since `initialize` re-wraps
-      # it in StringInquirer.
       def to_options
         {
           label: @label,
@@ -119,21 +89,31 @@ module Plutonium
           resource_action: @resource_action,
           category: @category.to_sym,
           position: @position,
-          modal: @modal
+          modal: @modal_mode,
+          size: @modal_size
         }
       end
 
       private
 
-      def validate_modal!
-        return if [:centered, :slideover].include?(@modal)
-        raise ArgumentError, "modal must be :centered or :slideover, got #{@modal.inspect}"
+      def targets_remote_modal?
+        @turbo_frame == Plutonium::REMOTE_MODAL_FRAME
+      end
+
+      def validate_modal_mode!
+        return if @modal_mode.nil?
+        return if [:centered, :slideover].include?(@modal_mode)
+        raise ArgumentError, "modal must be :centered or :slideover, got #{@modal_mode.inspect}"
+      end
+
+      def validate_modal_size!
+        return if @modal_size.nil?
+        return if Plutonium::UI::Modal::Base::VALID_SIZES.include?(@modal_size)
+        raise ArgumentError,
+          "size must be one of #{Plutonium::UI::Modal::Base::VALID_SIZES.inspect}, " \
+            "got #{@modal_size.inspect}"
       end
 
-      # Build RouteOptions from the provided options
-      #
-      # @param [RouteOptions, Hash, nil] options The routing options
-      # @return [RouteOptions] The built RouteOptions object
       def build_route_options(options)
         case options
         when RouteOptions

data/lib/plutonium/configuration.rb

@@ -30,6 +30,12 @@ module Plutonium
     # @return [Symbol] :classic (legacy Header/Sidebar) or :modern (Topbar/IconRail)
     attr_accessor :shell
 
+    # @return [String] host URL of the Navii avatar service (no path), used by
+    #   {Plutonium::UI::Avatar} as the default profile-image fallback. The
+    #   component appends the `/avatar/:seed` route. Repoint this to self-host
+    #   or proxy the service.
+    attr_accessor :navii_host_url
+
     # Map of version numbers to their default configurations
     VERSION_DEFAULTS = {
       1.0 => proc do |config|
@@ -52,6 +58,7 @@ module Plutonium
       @cache_discovery = !Rails.env.development?
       @enable_hotreload = Rails.env.development?
       @shell = :modern
+      @navii_host_url = "https://api.navii.dev"
     end
 
     # Load default configuration for a specific version

data/lib/plutonium/definition/actions.rb

@@ -6,19 +6,19 @@ module Plutonium
       included do
         defineable_prop :action
 
-        def self.action(name, interaction: nil, **)
+        def self.action(name, interaction: nil, **opts)
           defined_actions[name] = if interaction
-            Plutonium::Action::Interactive::Factory.create(name, interaction:, **)
+            Plutonium::Action::Interactive::Factory.create(name, interaction:, **opts)
           else
-            Plutonium::Action::Simple.new(name, **)
+            Plutonium::Action::Simple.new(name, **opts)
           end
         end
 
-        def action(name, interaction: nil, **)
+        def action(name, interaction: nil, **opts)
           instance_defined_actions[name] = if interaction
-            Plutonium::Action::Interactive::Factory.create(name, interaction:, **)
+            Plutonium::Action::Interactive::Factory.create(name, interaction:, **opts)
           else
-            Plutonium::Action::Simple.new(name, **)
+            Plutonium::Action::Simple.new(name, **opts)
           end
         end
 
@@ -32,12 +32,10 @@ module Plutonium
 
         # standard CRUD actions
 
-        # turbo_frame for :new and :edit is set by
-        # Resource::Definition.configure_crud_modal_targets! based on the
-        # `modal` config. Don't hard-code it here.
         action(:new, route_options: {action: :new},
           resource_action: true, category: :primary,
-          icon: Phlex::TablerIcons::Plus, position: 10)
+          icon: Phlex::TablerIcons::Plus, position: 10,
+          turbo_frame: Plutonium::REMOTE_MODAL_FRAME)
 
         action(:show, route_options: {action: :show},
           collection_record_action: true, category: :primary,
@@ -45,7 +43,8 @@ module Plutonium
 
         action(:edit, route_options: {action: :edit},
           record_action: true, collection_record_action: true, category: :primary,
-          icon: Phlex::TablerIcons::Edit, position: 20)
+          icon: Phlex::TablerIcons::Edit, position: 20,
+          turbo_frame: Plutonium::REMOTE_MODAL_FRAME)
 
         action(:destroy, route_options: {method: :delete},
           record_action: true, collection_record_action: true, category: :danger,

data/lib/plutonium/definition/base.rb

@@ -86,6 +86,35 @@ module Plutonium
       # false = always hide
       inheritable_config_attr :submit_and_continue
 
+      # modals — drive how :new / :edit and interactive actions render.
+      # Actions read these lazily at render time, so override order and
+      # subclass inheritance both work naturally.
+      VALID_MODAL_MODES = [:centered, :slideover, false].freeze
+
+      inheritable_config_attr :modal_mode, :modal_size
+      modal_mode :slideover
+      modal_size :md
+
+      # Sets `modal_mode` and `modal_size` together with validation.
+      #
+      # - :slideover (default) — slide-in panel from the right
+      # - :centered — centered dialog
+      # - false — no modal; new/edit are full standalone pages
+      #
+      # `size:` see Plutonium::UI::Modal::Base::VALID_SIZES. `:auto`
+      # hugs the form's natural width.
+      def self.modal(mode, size: :md)
+        unless VALID_MODAL_MODES.include?(mode)
+          raise ArgumentError, "modal must be one of #{VALID_MODAL_MODES.inspect}, got #{mode.inspect}"
+        end
+        unless Plutonium::UI::Modal::Base::VALID_SIZES.include?(size)
+          raise ArgumentError,
+            "modal size must be one of #{Plutonium::UI::Modal::Base::VALID_SIZES.inspect}, got #{size.inspect}"
+        end
+        modal_mode mode
+        modal_size size
+      end
+
       def initialize
         super
       end

data/lib/plutonium/helpers/assets_helper.rb

@@ -4,29 +4,6 @@ module Plutonium
   module Helpers
     # Helper module for managing asset-related functionality
     module AssetsHelper
-      # Generate a stylesheet tag for the resource
-      #
-      # @return [ActiveSupport::SafeBuffer] HTML stylesheet link tag
-      def resource_stylesheet_tag
-        url = resource_asset_url_for(:css, resource_stylesheet_asset)
-        stylesheet_link_tag(url, "data-turbo-track": "reload")
-      end
-
-      # Generate a script tag for the resource
-      #
-      # @return [ActiveSupport::SafeBuffer] HTML script tag
-      def resource_script_tag
-        url = resource_asset_url_for(:js, resource_script_asset)
-        javascript_include_tag(url, "data-turbo-track": "reload", type: "module")
-      end
-
-      # Generate a favicon link tag
-      #
-      # @return [ActiveSupport::SafeBuffer] HTML favicon link tag
-      def resource_favicon_tag
-        favicon_link_tag(resource_favicon_asset)
-      end
-
       # Generate an image tag for the logo
       #
       # @param classname [String] CSS class name for the image tag
@@ -56,13 +33,6 @@ module Plutonium
         Plutonium.configuration.assets.script
       end
 
-      # Get the favicon asset path
-      #
-      # @return [String] path to the favicon asset
-      def resource_favicon_asset
-        Plutonium.configuration.assets.favicon
-      end
-
       private
 
       # Generate the appropriate asset URL based on the environment

data/lib/plutonium/helpers/content_helper.rb

@@ -17,50 +17,6 @@ module Plutonium
           }
         )
       end
-
-      def read_more(content, clamp = 4)
-        return if content.blank?
-
-        # Stimulus Read More (https://www.stimulus-components.com/docs/stimulus-read-more/)
-        style = "overflow: hidden; display: -webkit-box; -webkit-box-orient: vertical; " \
-                "-webkit-line-clamp: var(--read-more-line-clamp, #{clamp});"
-
-        tag.div(
-          data: {
-            controller: "read-more",
-            read_more_more_text_value: "Read more",
-            read_more_less_text_value: "Read less"
-          }
-        ) do
-          concat tag.div(content,
-            style:,
-            data: {read_more_target: "content"})
-
-          next unless content.lines.size > clamp
-
-          concat tag.button("Read more",
-            class: "btn btn-sm btn-link text-decoration-none ps-0",
-            data: {action: "read-more#toggle"})
-        end
-      end
-
-      def quill(content)
-        return if content.blank?
-
-        tag.div(
-          content,
-          class: "ql-viewer",
-          data: {
-            controller: "quill-viewer"
-          }
-        )
-      end
-
-      def clamp_content(content)
-        return if content.blank?
-
-        tag.div content, class: "clamped-content"
-      end
     end
   end
 end

data/lib/plutonium/helpers/display_helper.rb

@@ -1,11 +1,6 @@
 module Plutonium
   module Helpers
     module DisplayHelper
-      # def tooltip(text)
-      #   text = sanitize text
-      #   "title=\"#{text}\" data-controller=\"tooltip\" data-bs-title=\"#{text}\"".html_safe
-      # end
-
       def resource_name(resource_class, count = 1)
         resource_class.model_name.human.pluralize(count)
       end
@@ -32,59 +27,10 @@ module Plutonium
         end
       end
 
-      def display_field(value:, helper: nil, **options)
-        return "-" unless value.present?
-
-        stack_multiple = options.key?(:stack_multiple) ? options.delete(:stack_multiple) : helper != :display_name_of
-
-        # clean options list
-        options.select! { |k, _v| !k.starts_with? "pu_" }
-
-        if value.respond_to?(:each) && stack_multiple
-          tag.ul class: "list-unstyled m-0" do
-            value.each do |val|
-              rendered = display_field_value(value: val, helper:, **options)
-              concat tag.li(rendered)
-            end
-          end
-        else
-          rendered = display_field_value(value:, helper:, **options)
-          tag.span rendered
-        end
-      end
-
       def display_datetime_value(value)
         timeago value
       end
 
-      def display_field_value(value:, helper: nil, title: nil, **)
-        title = (title != false) ? title || display_name_of(value) : nil
-        rendered = helper.present? ? send(helper, value, **) : value
-        tag.span rendered, title:
-      end
-
-      def display_association_value(association)
-        display_name = display_name_of(association)
-        if registered_resources.include?(association.class)
-          link_to display_name, resource_url_for(association, parent: nil),
-            class: "font-medium text-primary-600 dark:text-primary-500"
-        else
-          display_name
-        end
-      end
-
-      def display_numeric_value(value)
-        number_with_delimiter value
-      end
-
-      def display_boolean_value(value)
-        tag.input type: :checkbox, class: "form-check-input", checked: value, disabled: true
-      end
-
-      def display_url_value(value)
-        link_to nil, value, class: "font-medium text-primary-600 dark:text-primary-500", target: :blank
-      end
-
       def display_name_of(obj, separator: ", ")
         return unless obj.present?
 
@@ -103,14 +49,6 @@ module Plutonium
         # Oh well. Just convert it to a string.
         obj.to_s
       end
-
-      def display_clamped_quill(value)
-        clamp_content quill(value)
-      end
-
-      def display_attachment_value(value, **, &)
-        attachment_preview(value, **, &)
-      end
     end
   end
 end

data/lib/plutonium/helpers/turbo_helper.rb

@@ -16,10 +16,6 @@ module Plutonium
       # modal frame specifically.
       def in_secondary_modal? = current_turbo_frame == Plutonium::REMOTE_MODAL_SECONDARY_FRAME
 
-      def remote_modal_frame_tag(&)
-        turbo_frame_tag(Plutonium::REMOTE_MODAL_FRAME, &)
-      end
-
       # Returns a turbo-frame-scoped element id. Two identically-named forms
       # can be on the page simultaneously (e.g. a primary modal opens a
       # secondary modal, each rendering an `id="resource-form"`). When the

data/lib/plutonium/helpers.rb

@@ -3,10 +3,8 @@ module Plutonium
     def self.included(base)
       base.class_eval do
         include Plutonium::Helpers::ApplicationHelper
-        include Plutonium::Helpers::AttachmentHelper
         include Plutonium::Helpers::ContentHelper
         include Plutonium::Helpers::DisplayHelper
-        include Plutonium::Helpers::TableHelper
         include Plutonium::Helpers::TurboHelper
         include Plutonium::Helpers::TurboStreamActionsHelper
         include Plutonium::Helpers::AssetsHelper

data/lib/plutonium/resource/definition.rb

@@ -1,48 +1,6 @@
 module Plutonium
   module Resource
     class Definition < Plutonium::Definition::Base
-      class_attribute :modal_mode, default: :slideover, instance_accessor: false
-
-      VALID_MODAL_MODES = [:centered, :slideover, false].freeze
-
-      # Sets how :new / :edit actions render.
-      # - :slideover (default) — slide-in panel from the right
-      # - :centered — centered dialog
-      # - false — no modal; new/edit are full standalone pages
-      def self.modal(mode)
-        unless VALID_MODAL_MODES.include?(mode)
-          raise ArgumentError, "modal must be one of #{VALID_MODAL_MODES.inspect}, got #{mode.inspect}"
-        end
-        self.modal_mode = mode
-        configure_crud_modal_targets!
-      end
-
-      # Re-derives the default :new / :edit actions so their turbo_frame
-      # matches the current `modal_mode`. Called when `.modal` is set
-      # and once at Resource::Definition load (so the default
-      # :slideover state propagates to the action records). Subclasses
-      # inherit those records via DefineableProps#inherited (deep_dup);
-      # calling `.modal` on a subclass re-runs this method locally.
-      def self.configure_crud_modal_targets!
-        target = (modal_mode == false) ? nil : Plutonium::REMOTE_MODAL_FRAME
-        [:new, :edit].each do |name|
-          action = defined_actions[name]
-          next unless action
-          next if action.turbo_frame == target
-          defined_actions[name] = action.with(turbo_frame: target)
-        end
-      end
-
-      def modal
-        self.class.modal_mode
-      end
-
-      # Apply the default modal target ("remote_modal") to :new / :edit
-      # so resources that never call `.modal` still get the slideover
-      # behavior. Subclasses inherit the configured actions via
-      # DefineableProps' deep_dup; calling `.modal` on a subclass
-      # re-runs the configuration locally.
-      configure_crud_modal_targets!
     end
   end
 end

data/lib/plutonium/ui/action_button.rb

@@ -50,7 +50,7 @@ module Plutonium
         link_to(
           url_with_return_to,
           class: button_classes,
-          data: {turbo_frame: @action.turbo_frame}.merge(@extra_data)
+          data: {turbo_frame: @action.turbo_frame(current_definition)}.merge(@extra_data)
         ) do
           render_button_content
         end
@@ -67,7 +67,7 @@ module Plutonium
             data: {
               turbo: @action.turbo,
               turbo_confirm: @action.confirmation.presence,
-              turbo_frame: @action.turbo_frame
+              turbo_frame: @action.turbo_frame(current_definition)
             }
           }
         ) do
@@ -84,7 +84,8 @@ module Plutonium
         }
 
         # Add turbo frame if specified
-        link_attrs[:data] = {turbo_frame: @action.turbo_frame} if @action.turbo_frame
+        frame = @action.turbo_frame(current_definition)
+        link_attrs[:data] = {turbo_frame: frame} if frame
 
         # Add confirmation and method for non-GET requests
         if @action.confirmation || @action.route_options.method != :get