plutonium 0.12.9 → 0.12.11

data/lib/plutonium/core/associations/renderers/base.rb

@@ -0,0 +1,77 @@
+module Plutonium
+  module Core
+    module Associations
+      module Renderers
+        class Base
+          include Plutonium::Core::Renderable
+
+          attr_reader :name, :reflection
+
+          def initialize(name, reflection:, **user_options)
+            @name = name
+            @reflection = reflection
+            @user_options = user_options
+          end
+
+          # Sets the record object on the renderer and merges render options.
+          #
+          # @param record [Object] the record object.
+          # @param render_options [Hash] additional options for rendering.
+          # @return [self] the renderer instance.
+          def with(record:, **render_options)
+            @record = record
+            @render_options = render_options
+            @options = build_options(render_options)
+
+            self
+          end
+
+          private
+
+          # Returns the merged options for rendering.
+          #
+          # @raise [RuntimeError] if accessed before rendering.
+          # @return [Hash] the merged options.
+          def options
+            raise "cannot access #options before calling #with" unless defined?(@options)
+
+            @options
+          end
+
+          # Returns the record object.
+          #
+          # @raise [RuntimeError] if accessed before rendering.
+          # @return [Object] the record object.
+          def record
+            raise "cannot access #record before calling #with" unless defined?(@record)
+
+            @record
+          end
+
+          def renderer_options
+            {}
+          end
+
+          def label
+            options[:label] || record.class.human_attribute_name(name)
+          end
+
+          # Returns the value of the record's attribute corresponding to the renderer's name.
+          #
+          # @return [Object] the value of the attribute.
+          def value
+            record.public_send(name)
+          end
+
+          # Builds the options for rendering by merging renderer options, user options, and render options.
+          #
+          # @param render_options [Hash] additional options for rendering.
+          # @return [Hash] the merged options.
+          def build_options(render_options)
+            renderer_options.deep_merge(@user_options).deep_merge(render_options)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/plutonium/core/associations/renderers/factory.rb

@@ -17,8 +17,6 @@ module Plutonium
           end
 
           def self.for_resource_association(resource_class, attr_name, **options)
-            options[:label] ||= resource_class.human_attribute_name(attr_name)
-
             association = resource_class.try(:reflect_on_association, attr_name)
             raise ArgumentError, "#{attr_name} is not a valid association of #{resource_class}" unless association.present?
             raise ArgumentError, "#{association.klass} does is not a resource record" unless association.klass.include?(Plutonium::Resource::Record)

data/lib/plutonium/core/associations/renderers/has_many_renderer.rb

@@ -2,12 +2,14 @@ module Plutonium
   module Core
     module Associations
       module Renderers
-        class HasManyRenderer < BasicRenderer
-          def render(view_context, record)
-            view_context.render_component :has_many_panel,
+        class HasManyRenderer < Base
+          def render
+            render_component(
+              :has_many_panel,
               title: label,
-              src: view_context.resource_url_for(reflection.klass, parent: record),
+              src: resource_url_for(reflection.klass, parent: record),
               **options
+            )
           end
         end
       end

data/lib/plutonium/core/controllers/crud_actions.rb

@@ -15,7 +15,7 @@ module Plutonium
           @search_object = current_query_object
           base_query = policy_scope(resource_class)
           base_query = @search_object.apply(base_query)
-          base_query = base_query.send(params[:scope].to_sym) if params[:scope].present?
+          base_query = base_query.public_send(params[:scope].to_sym) if params[:scope].present?
           @pagy, @resource_records = pagy base_query
           @collection = build_collection
 

data/lib/plutonium/core/controllers/presentable.rb

@@ -32,7 +32,7 @@ module Plutonium
           Plutonium::Core::Ui::Collection.new(
             resource_class:,
             records: @resource_records,
-            fields: current_presenter.defined_renderers_for(*presentable_attributes),
+            fields: current_presenter.defined_field_renderers_for(*presentable_attributes),
             actions: current_presenter.actions,
             pager: @pagy,
             search_object: @search_object
@@ -43,7 +43,7 @@ module Plutonium
           Plutonium::Core::Ui::Detail.new(
             resource_class:,
             record: resource_record,
-            fields: current_presenter.defined_renderers_for(*presentable_attributes),
+            fields: current_presenter.defined_field_renderers_for(*presentable_attributes),
             associations: current_presenter.defined_association_renderers_for(*permitted_associations),
             actions: current_presenter.actions
           )
@@ -52,7 +52,7 @@ module Plutonium
         def build_form
           Plutonium::Core::Ui::Form.new(
             record: resource_record,
-            inputs: current_presenter.defined_inputs_for(*presentable_attributes)
+            inputs: current_presenter.defined_field_inputs_for(*presentable_attributes)
           )
         end
 

data/lib/plutonium/core/definers/field_definer.rb

@@ -4,14 +4,14 @@ module Plutonium
       module FieldDefiner
         extend ActiveSupport::Concern
 
-        include InputDefiner
-        include RendererDefiner
+        include FieldInputDefiner
+        include FieldRendererDefiner
 
         private
 
         def define_field(name, type: nil, input: nil, renderer: nil, input_options: {}, renderer_options: {})
-          define_input(name, type:, input:, **input_options)
-          define_renderer(name, type:, renderer:, **renderer_options)
+          define_field_input(name, type:, input:, **input_options)
+          define_field_renderer(name, type:, renderer:, **renderer_options)
         end
       end
     end

data/lib/plutonium/core/definers/{input_definer.rb → field_input_definer.rb}

@@ -1,7 +1,7 @@
 module Plutonium
   module Core
     module Definers
-      module InputDefiner
+      module FieldInputDefiner
         extend ActiveSupport::Concern
         include Plutonium::Core::Autodiscovery::InputDiscoverer
 
@@ -47,14 +47,14 @@ module Plutonium
           attr_reader :hash
         end
 
-        def defined_inputs_for(*names)
+        def defined_field_inputs_for(*names)
           (names - input_definitions.keys).each do |name|
-            define_input(name, input: autodiscover_input(name))
+            define_field_input(name, input: autodiscover_input(name))
           end
           input_definitions.slice(*names)
         end
 
-        def define_input(name, input: nil, type: nil, **options)
+        def define_field_input(name, input: nil, type: nil, **options)
           input_definitions[name] = if input.present?
             input
           elsif type.present?

data/lib/plutonium/core/definers/{renderer_definer.rb → field_renderer_definer.rb}

@@ -1,23 +1,23 @@
 module Plutonium
   module Core
     module Definers
-      module RendererDefiner
+      module FieldRendererDefiner
         extend ActiveSupport::Concern
         include Plutonium::Core::Autodiscovery::RendererDiscoverer
 
-        def defined_renderers_for(*names)
-          (names - renderer_definitions.keys).each do |name|
-            define_renderer(name, renderer: autodiscover_renderer(name))
+        def defined_field_renderers_for(*names)
+          (names - field_renderer_definitions.keys).each do |name|
+            define_field_renderer(name, renderer: autodiscover_renderer(name))
           end
-          renderer_definitions.slice(*names)
+          field_renderer_definitions.slice(*names)
         end
 
         private
 
-        def renderer_definitions = @renderer_definitions ||= {}
+        def field_renderer_definitions = @field_renderer_definitions ||= {}
 
-        def define_renderer(name, renderer: nil, type: nil, **options)
-          renderer_definitions[name] = if renderer.present?
+        def define_field_renderer(name, renderer: nil, type: nil, **options)
+          field_renderer_definitions[name] = if renderer.present?
             renderer
           elsif type.present?
             Plutonium::Core::Fields::Renderers::Factory.build(name, type:, **options)
@@ -28,8 +28,8 @@ module Plutonium
           end
         end
 
-        def renderer_defined?(name)
-          renderer_definitions.key? name
+        def field_renderer_defined?(name)
+          field_renderer_definitions.key? name
         end
       end
     end

data/lib/plutonium/core/fields/inputs/attachment_input.rb

@@ -5,9 +5,9 @@ module Plutonium
         class AttachmentInput < SimpleFormInput
           attr_reader :reflection
 
-          def initialize(name, reflection:, **user_options)
+          def initialize(name, reflection:, **options)
             @reflection = reflection
-            super(name, **user_options)
+            super(name, **options)
           end
 
           private

data/lib/plutonium/core/fields/inputs/base.rb

@@ -3,17 +3,23 @@ module Plutonium
     module Fields
       module Inputs
         class Base
-          attr_reader :name, :user_options
+          include Plutonium::Core::Renderable
 
+          attr_reader :name
+
+          # Initializes the Base input class with a name and user-defined options.
+          #
+          # @param name [String] the name of the input field.
+          # @param user_options [Hash] user-defined options for the input field.
           def initialize(name, **user_options)
             @name = name
             @user_options = user_options
           end
 
-          def render(view_context, f, record, **)
-            raise NotImplementedError, "#{self.class}#render"
-          end
-
+          # Collects parameters matching the input field's name with multi-parameter attributes.
+          #
+          # @param params [Hash] the parameters to collect from.
+          # @return [Hash] the collected parameters.
           def collect(params)
             # Handles multi parameter attributes
             # https://www.cookieshq.co.uk/posts/rails-spelunking-date-select
@@ -26,17 +32,77 @@ module Plutonium
             # - parameter(1i)
             # - parameter(2f)
             regex = /^#{param}(\(\d+[if]?\))?$/
-            keys = params.select { |key, value| regex.match?(key) }.keys
+            keys = params.select { |key, _| regex.match?(key) }.keys
             params.slice(*keys)
           end
 
-          protected
+          # Sets the form and record objects on the input field.
+          #
+          # @param form [Object] the form object.
+          # @param record [Object] the record object.
+          # @param render_options [Hash] additional options for rendering.
+          def with(form:, record:, **render_options)
+            @form = form
+            @record = record
+            @render_options = render_options
+            @options = build_options(render_options)
+
+            self
+          end
+
+          private
+
+          # Returns input-specific options, can be overridden by subclasses.
+          #
+          # @return [Hash] the input-specific options.
+          def input_options
+            {}
+          end
+
+          # Returns the parameter name for the input field.
+          #
+          # @return [String] the parameter name.
+          def param
+            name
+          end
+
+          # Raises an error if #options is accessed before rendering.
+          #
+          # @raise [RuntimeError] if accessed before rendering.
+          # @return [Hash] the rendering options.
+          def options
+            raise "cannot access #options before calling #with" unless defined?(@options)
 
-          def input_options = {}
+            @options
+          end
 
-          def param = name
+          # Raises an error if #form is accessed before rendering.
+          #
+          # @raise [RuntimeError] if accessed before rendering.
+          # @return [Object] the form object.
+          def form
+            raise "cannot access #form before calling #with" unless defined?(@form)
+
+            @form
+          end
 
-          def options = @options ||= input_options.deep_merge(@user_options)
+          # Raises an error if #record is accessed before rendering.
+          #
+          # @raise [RuntimeError] if accessed before rendering.
+          # @return [Object] the record object.
+          def record
+            raise "cannot access #record before calling #with" unless defined?(@record)
+
+            @record
+          end
+
+          # Builds the options for rendering by merging input options, user options, and render options.
+          #
+          # @param render_options [Hash] additional options for rendering.
+          # @return [Hash] the merged options.
+          def build_options(render_options)
+            input_options.deep_merge(@user_options).deep_merge(render_options)
+          end
         end
       end
     end

data/lib/plutonium/core/fields/inputs/checkbox_input.rb

@@ -5,7 +5,9 @@ module Plutonium
         class CheckboxInput < SimpleFormInput
           private
 
-          def input_options = {wrapper: :resource_checkbox}
+          def input_options
+            {wrapper: :resource_checkbox}
+          end
         end
       end
     end

data/lib/plutonium/core/fields/inputs/date_time_input.rb

@@ -5,7 +5,9 @@ module Plutonium
         class DateTimeInput < SimpleFormInput
           private
 
-          def input_options = {wrapper: :resource_multi_select}
+          def input_options
+            {wrapper: :resource_multi_select}
+          end
         end
       end
     end

data/lib/plutonium/core/fields/inputs/nested_input.rb

@@ -3,52 +3,67 @@ module Plutonium
     module Fields
       module Inputs
         class NestedInput < Base
-          include Plutonium::Core::Definers::InputDefiner
+          include Plutonium::Core::Definers::FieldInputDefiner
 
           attr_reader :inputs, :resource_class
 
-          def initialize(name, inputs:, resource_class:, allow_destroy:, update_only:, limit:, **user_options)
+          def initialize(name, inputs:, resource_class:, allow_destroy:, update_only:, limit:, **options)
             @inputs = inputs
             @resource_class = resource_class
             @allow_destroy = allow_destroy
             @update_only = update_only
             @limit = limit
 
-            super(name, **user_options)
+            super(name, **options)
           end
 
-          def render(view_context, f, record, **opts)
-            opts = options.deep_merge opts
-            view_context.render_component :nested_resource_form_fields, form: f, **opts
+          def render
+            render_component :nested_resource_form_fields, form:, **options
           end
 
           def collect(params)
+            nested_params = params[param] || {}
+            attributes = (nested_params.keys.first == "0") ? collect_indexed_attributes(nested_params) : collect_single_attributes(nested_params)
+            {param => attributes}
+          end
+
+          private
+
+          def collect_single_attributes(params)
+            collected = defined_inputs.collect_all(params)
+            collected[:id] = params[:id] if params.key?(:id) && !@update_only
+            collected[:_destroy] = params[:_destroy] if @allow_destroy
+            collected
+          end
+
+          def collect_indexed_attributes(params)
             attributes = {}
-            params[param].each do |index, nested_params|
+            params.each do |index, nested_params|
               collected = defined_inputs.collect_all(nested_params)
               collected[:id] = nested_params[:id] if nested_params.key?(:id) && !@update_only
               collected[:_destroy] = nested_params[:_destroy] if @allow_destroy
               attributes[index] = collected
             end
-
-            {param => attributes}
+            attributes
           end
 
-          private
-
-          def param = :"#{name}_attributes"
+          def param
+            :"#{name}_attributes"
+          end
 
-          def input_options = {
-            name:,
-            resource_class:,
-            allow_destroy: @allow_destroy,
-            update_only: @update_only,
-            limit: @limit,
-            inputs: defined_inputs
-          }
+          def input_options
+            {
+              name:,
+              resource_class:,
+              allow_destroy: @allow_destroy,
+              update_only: @update_only,
+              limit: @limit,
+              inputs: defined_inputs
+            }
+          end
 
           def defined_inputs
-            @defined_inputs ||= defined_inputs_for(*inputs)
+            @defined_inputs ||= defined_field_inputs_for(*inputs)
           end
         end
       end

data/lib/plutonium/core/fields/inputs/noop_input.rb

@@ -3,10 +3,7 @@ module Plutonium
     module Fields
       module Inputs
         class NoopInput
-          def initialize(*)
-          end
-
-          def render(view_context, f, record, **)
+          def render
           end
 
           def collect(params)

data/lib/plutonium/core/fields/inputs/polymorphic_belongs_to_association_input.rb

@@ -3,9 +3,8 @@ module Plutonium
     module Fields
       module Inputs
         class PolymorphicBelongsToAssociationInput < SimpleFormAssociationInput
-          def render(view_context, f, record, **opts)
-            opts = options.deep_merge opts
-            f.input param, **opts
+          def render
+            form.input param, **options
           end
 
           private
@@ -15,12 +14,11 @@ module Plutonium
           end
 
           def input_options
+            collection = @user_options.delete(:collection).presence || associated_classes
             {
               as: :grouped_select,
+              collection:,
               label: reflection.name.to_s.humanize,
-              collection: associated_classes.map { |klass|
-                            [klass.name, klass.all]
-                          }.to_h,
               group_label_method: :first,
               group_method: :last, include_blank: "Select One"
             }
@@ -38,7 +36,10 @@ module Plutonium
                 end
               end
             end
-            associated_classes
+
+            associated_classes.map { |klass|
+              [klass.name, klass.all]
+            }.to_h
           end
         end
       end

data/lib/plutonium/core/fields/inputs/simple_form_association_input.rb

@@ -5,14 +5,13 @@ module Plutonium
         class SimpleFormAssociationInput < Base
           attr_reader :reflection
 
-          def initialize(name, reflection:, **user_options)
+          def initialize(name, reflection:, **)
             @reflection = reflection
-            super(name, **user_options)
+            super(name, **)
           end
 
-          def render(view_context, f, record, **opts)
-            opts = options.deep_merge opts
-            f.association name, **opts
+          def render
+            form.association name, **options
           end
 
           private

data/lib/plutonium/core/fields/inputs/simple_form_input.rb

@@ -3,9 +3,8 @@ module Plutonium
     module Fields
       module Inputs
         class SimpleFormInput < Base
-          def render(view_context, f, record, **opts)
-            opts = options.deep_merge opts
-            f.input name, **opts
+          def render
+            form.input name, **options
           end
         end
       end

data/lib/plutonium/core/fields/renderers/association_renderer.rb

@@ -2,7 +2,7 @@ module Plutonium
   module Core
     module Fields
       module Renderers
-        class AssociationRenderer < BasicRenderer
+        class AssociationRenderer < Base
           attr_reader :reflection
 
           def initialize(name, reflection:, **user_options)
@@ -10,10 +10,16 @@ module Plutonium
             super(name, **user_options)
           end
 
-          def render(view_context, record)
-            value = record.send(name)
-            options = self.options.merge(helper: value.class.include?(Plutonium::Resource::Record) ? :display_association_value : :display_name_of)
-            view_context.display_field value:, **options
+          def render
+            display_field value:, **options
+          end
+
+          private
+
+          def renderer_options
+            {
+              helper: value.class.include?(Plutonium::Resource::Record) ? :display_association_value : :display_name_of
+            }
           end
         end
       end

data/lib/plutonium/core/fields/renderers/attachment_renderer.rb

@@ -2,16 +2,9 @@ module Plutonium
   module Core
     module Fields
       module Renderers
-        class AttachmentRenderer < BasicRenderer
-          attr_reader :reflection
-
-          def initialize(name, reflection:, **user_options)
-            @reflection = reflection
-            super(name, **user_options)
-          end
-
-          def render(view_context, record)
-            view_context.attachment_preview record.send(name), **options
+        class AttachmentRenderer < AssociationRenderer
+          def render
+            attachment_preview value, **options
           end
 
           private