stimulus_plumbers 0.2.7 → 0.2.9

data/lib/stimulus_plumbers/form/{field_component.rb → field.rb}

@@ -2,8 +2,8 @@
 
 module StimulusPlumbers
   module Form
-    class FieldComponent
-      OPTIONS = %i[label details error required label_visibility layout].freeze
+    class Field
+      OPTIONS = %i[label details error required label_visibility layout reveal clearable].freeze
 
       attr_reader :object,
                   :attribute,
@@ -14,15 +14,17 @@ module StimulusPlumbers
                   :label_visibility,
                   :layout
 
-      def initialize(object:,
-                     attribute:,
-                     input_id:,
-                     label: nil,
-                     details: nil,
-                     error: nil,
-                     required: false,
-                     label_visibility: :visible,
-                     layout: :stacked)
+      def initialize(
+        object:,
+        attribute:,
+        input_id:,
+        label: nil,
+        details: nil,
+        error: nil,
+        required: false,
+        label_visibility: :visible,
+        layout: :stacked
+      )
         @object           = object
         @attribute        = attribute
         @input_id         = input_id

data/lib/stimulus_plumbers/form/fields/combobox.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+module StimulusPlumbers
+  module Form
+    module Fields
+      module Combobox
+        COMPONENT_CLASS = {
+          autocomplete: Components::Combobox::Autocomplete,
+          date:         Components::Combobox::Date,
+          dropdown:     Components::Combobox::Dropdown,
+          time:         Components::Combobox::Time
+        }.freeze
+
+        def combobox_field(attribute, type:, options: [], **html_options)
+          klass = COMPONENT_CLASS.fetch(type) do
+            raise ArgumentError,
+                  "unsupported combobox type #{type.inspect}. Must be one of: #{COMPONENT_CLASS.keys.join(", ")}"
+          end
+
+          rails_opts, field_opts = extract_options(html_options)
+          field         = build_field(attribute, field_opts)
+          base_id       = field_id(attribute)
+          current_value = object&.public_send(attribute)
+
+          popover = klass.new(@template).render(options: options, value: current_value, **rails_opts)
+          opts    = klass.default_opts.deep_merge(
+            input:   { name: field_name(attribute), value: current_value },
+            popover: { content: popover }
+          )
+          wrapper = Components::Combobox.new(@template).render(
+            base_id: base_id,
+            options: opts,
+            **field_theme(:form_combobox, error: field.error?),
+            **field.html_opts
+          )
+          render_field(field, wrapper)
+        end
+      end
+    end
+  end
+end

data/lib/stimulus_plumbers/form/fields/error.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module StimulusPlumbers
+  module Form
+    module Fields
+      class Error < Plumber::Base
+        def render(message:, id:)
+          klass = theme.resolve(:form_error).fetch(:classes, "")
+          template.content_tag(:p, message, id: id, class: klass.presence, role: "alert")
+        end
+      end
+    end
+  end
+end

data/lib/stimulus_plumbers/form/fields/group.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module StimulusPlumbers
+  module Form
+    module Fields
+      class Group < Plumber::Base
+        def render(layout: :stacked, error: false, &block)
+          klass = theme.resolve(:form_group, layout: layout, error: error).fetch(:classes, "")
+          template.content_tag(:div, class: klass.presence, &block)
+        end
+      end
+    end
+  end
+end

data/lib/stimulus_plumbers/form/fields/hint.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module StimulusPlumbers
+  module Form
+    module Fields
+      class Hint < Plumber::Base
+        def render(text:, id:)
+          klass = theme.resolve(:form_details).fetch(:classes, "")
+          template.content_tag(:p, text, id: id, class: klass.presence)
+        end
+      end
+    end
+  end
+end

data/lib/stimulus_plumbers/form/fields/label.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module StimulusPlumbers
+  module Form
+    module Fields
+      class Label < Plumber::Base
+        def render(text:, for_id:, required: false, hidden: false)
+          klass = theme.resolve(:form_label, required: required, hidden: hidden).fetch(:classes, "")
+
+          inner = text.dup.html_safe
+          if required
+            mark_klass = theme.resolve(:form_required_mark).fetch(:classes, "")
+            inner += template.content_tag(:span, "*", "aria-hidden": "true", class: mark_klass.presence)
+          end
+
+          template.content_tag(:label, inner, for: for_id, class: klass.presence)
+        end
+      end
+    end
+  end
+end

data/lib/stimulus_plumbers/form/fields/password.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+module StimulusPlumbers
+  module Form
+    module Fields
+      module Password
+        def password_field(attribute, options = {})
+          rails_opts, form_field_opts = extract_options(options)
+          reveal = form_field_opts.delete(:reveal) { false }
+          field  = build_field(attribute, form_field_opts)
+
+          input_html = if reveal
+                         input_opts = merge_html_options(
+                           rails_opts,
+                           field_theme(:form_input_reveal),
+                           field.html_opts,
+                           { "data-input-format-target": "input" }
+                         )
+                         build_input_group(
+                           super(attribute, input_opts),
+                           field,
+                           trailing:                       reveal_button,
+                           "data-controller":              "input-format",
+                           "data-input-format-type-value": "password"
+                         )
+                       else
+                         html_opts = merge_html_options(
+                           rails_opts,
+                           field_theme(:form_input, error: field.error?),
+                           field.html_opts
+                         )
+                         super(attribute, html_opts)
+                       end
+
+          render_field(field, input_html)
+        end
+
+        private
+
+        def reveal_button
+          @template.content_tag(
+            :button,
+            "",
+            type:                       "button",
+            class:                      field_theme(:form_button_reveal)[:class],
+            "aria-label":               "Show password",
+            "aria-pressed":             "false",
+            "data-input-format-target": "toggle",
+            "data-action":              "click->input-format#toggle"
+          )
+        end
+      end
+    end
+  end
+end

data/lib/stimulus_plumbers/form/fields/renderer.rb

@@ -13,42 +13,37 @@ module StimulusPlumbers
         end
 
         def call(input_html)
-          field_klass = theme.resolve(:form_group, layout: field.layout, error: field.error?).fetch(:classes, "")
-
-          template.content_tag(:div, class: field_klass) do
-            label_html + input_html.html_safe + hint_html + errors_html
+          Group.new(template).render(layout: field.layout, error: field.error?) do
+            (field_label + input_html.html_safe + field_hint + field_errors).html_safe
           end
         end
 
         private
 
-        def label_html
-          klass = theme.resolve(:form_label, required: field.required).fetch(:classes, "")
-          klass = "#{klass} sr-only".strip if field.label_hidden?
-
-          inner = field.label_text.dup.html_safe
-          if field.required
-            mark_klass = theme.resolve(:form_required_mark).fetch(:classes, "")
-            inner += template.content_tag(:span, "*", "aria-hidden": "true", class: mark_klass)
-          end
-
-          template.content_tag(:label, inner, for: field.input_id, class: klass)
+        def field_label
+          Label.new(template).render(
+            text:     field.label_text,
+            for_id:   field.input_id,
+            required: field.required,
+            hidden:   field.label_hidden?
+          )
         end
 
-        def hint_html
+        def field_hint
           return "".html_safe unless field.details.present?
 
-          klass = theme.resolve(:form_details).fetch(:classes, "")
-          template.content_tag(:p, field.details, id: field.hint_id, class: klass)
+          Hint.new(template).render(
+            text: field.details,
+            id:   field.hint_id
+          )
         end
 
-        def errors_html
+        def field_errors
           return "".html_safe if field.errors.none?
 
-          klass = theme.resolve(:form_error).fetch(:classes, "")
           field.errors.map.with_index(1) do |message, i|
             id = field.errors.one? ? field.error_id : "#{field.error_id}_#{i}"
-            template.content_tag(:p, message, id: id, class: klass, role: "alert")
+            Error.new(template).render(message: message, id: id)
           end.join.html_safe
         end
       end

data/lib/stimulus_plumbers/form/fields/search.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+module StimulusPlumbers
+  module Form
+    module Fields
+      module Search
+        def search_field(attribute, options = {})
+          rails_opts, form_field_opts = extract_options(options)
+          clearable = form_field_opts.delete(:clearable) { false }
+          field     = build_field(attribute, form_field_opts)
+
+          input_html = if clearable
+                         input_opts = merge_html_options(
+                           rails_opts,
+                           field_theme(:form_input, error: field.error?),
+                           field.html_opts,
+                           { "data-input-search-target": "input", inputmode: "search" }
+                         )
+                         build_input_group(
+                           super(attribute, input_opts),
+                           field,
+                           trailing:          clear_button,
+                           "data-controller": "input-search",
+                           role:              "search"
+                         )
+                       else
+                         html_opts = merge_html_options(
+                           rails_opts,
+                           field_theme(:form_input, error: field.error?),
+                           field.html_opts
+                         )
+                         super(attribute, html_opts)
+                       end
+
+          render_field(field, input_html)
+        end
+
+        private
+
+        def clear_button
+          @template.content_tag(
+            :button,
+            "",
+            type:                       "button",
+            class:                      field_theme(:form_button_reveal)[:class],
+            "aria-label":               "Clear search",
+            "data-input-search-target": "clear",
+            "data-action":              "click->input-search#clear"
+          )
+        end
+      end
+    end
+  end
+end

data/lib/stimulus_plumbers/form/fields/select.rb

@@ -11,8 +11,14 @@ module StimulusPlumbers
           render_field(field, super(attribute, choices, rails_opts, html_opts))
         end
 
-        def collection_select(attribute, collection, value_method, text_method,
-                              options = {}, html_options = {})
+        def collection_select(
+          attribute,
+          collection,
+          value_method,
+          text_method,
+          options = {},
+          html_options = {}
+        )
           rails_opts, form_field_opts = extract_options(options)
           field     = build_field(attribute, form_field_opts)
           html_opts = merge_html_options(html_options, field_theme(:form_select, error: field.error?), field.html_opts)

data/lib/stimulus_plumbers/form/fields/submit.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module StimulusPlumbers
+  module Form
+    module Fields
+      module Submit
+        def submit(value = nil, options = {})
+          if value.is_a?(Hash)
+            options = value
+            value = nil
+          end
+          value   ||= submit_default_value
+          variant   = options.delete(:variant) { :default }
+          @template.tag.input(
+            type:  "submit",
+            value: value,
+            **merge_html_options(field_theme(:form_submit, variant: variant), options)
+          )
+        end
+      end
+    end
+  end
+end

data/lib/stimulus_plumbers/form/fields/text.rb

@@ -5,10 +5,18 @@ module StimulusPlumbers
     module Fields
       module Text
         FIELD_TYPES = %i[
-          text_field email_field url_field telephone_field search_field
-          number_field color_field date_field datetime_local_field
-          time_field month_field week_field range_field
-          password_field
+          color_field
+          date_field
+          datetime_local_field
+          email_field
+          month_field
+          number_field
+          range_field
+          telephone_field
+          text_field
+          time_field
+          url_field
+          week_field
         ].freeze
 
         FIELD_TYPES.each do |method_name|

data/lib/stimulus_plumbers/helpers/action_list_helper.rb

@@ -4,7 +4,7 @@ module StimulusPlumbers
   module Helpers
     module ActionListHelper
       def sp_action_list(**html_options, &block)
-        action_list_renderer.list(**html_options, &block)
+        action_list_renderer.render(**html_options, &block)
       end
 
       def sp_action_list_section(title: nil, **html_options, &block)
@@ -18,7 +18,7 @@ module StimulusPlumbers
       private
 
       def action_list_renderer
-        Components::ActionList::Renderer.new(self)
+        Components::ActionList.new(self)
       end
     end
   end

data/lib/stimulus_plumbers/helpers/avatar_helper.rb

@@ -4,13 +4,13 @@ module StimulusPlumbers
   module Helpers
     module AvatarHelper
       def sp_avatar(name: nil, initials: nil, url: nil, color: nil, size: :md, **html_options, &block)
-        avatar_renderer.avatar(name: name, initials: initials, url: url, color: color, size: size, **html_options, &block)
+        avatar_renderer.render(name: name, initials: initials, url: url, color: color, size: size, **html_options, &block)
       end
 
       private
 
       def avatar_renderer
-        Components::Avatar::Renderer.new(self)
+        Components::Avatar.new(self)
       end
     end
   end

data/lib/stimulus_plumbers/helpers/button_helper.rb

@@ -4,7 +4,7 @@ module StimulusPlumbers
   module Helpers
     module ButtonHelper
       def sp_button(content = nil, url: nil, external: false, variant: :primary, size: :md, **html_options, &block)
-        button_renderer.button(
+        button_renderer.render(
           content,
           url: url, external: external, variant: variant, size: size, **html_options,
           &block
@@ -18,7 +18,7 @@ module StimulusPlumbers
       private
 
       def button_renderer
-        Components::Button::Renderer.new(self)
+        Components::Button.new(self)
       end
     end
   end

data/lib/stimulus_plumbers/helpers/calendar_helper.rb

@@ -19,7 +19,7 @@ module StimulusPlumbers
       private
 
       def calendar_renderer
-        Components::Calendar::Renderer.new(self)
+        Components::Calendar.new(self)
       end
     end
   end

data/lib/stimulus_plumbers/helpers/calendar_turbo_helper.rb

@@ -24,7 +24,7 @@ module StimulusPlumbers
       private
 
       def calendar_month_turbo_renderer
-        Components::Calendar::Month::Turbo::Renderer.new(self)
+        Components::Calendar::Month::Turbo.new(self)
       end
     end
   end

data/lib/stimulus_plumbers/helpers/card_helper.rb

@@ -4,7 +4,7 @@ module StimulusPlumbers
   module Helpers
     module CardHelper
       def sp_card(title: nil, **html_options, &block)
-        card_renderer.card(title: title, **html_options, &block)
+        card_renderer.render(title: title, **html_options, &block)
       end
 
       def sp_card_section(title: nil, **html_options, &block)
@@ -14,7 +14,7 @@ module StimulusPlumbers
       private
 
       def card_renderer
-        Components::Card::Renderer.new(self)
+        Components::Card.new(self)
       end
     end
   end

data/lib/stimulus_plumbers/helpers/combobox_helper.rb

@@ -0,0 +1,74 @@
+# frozen_string_literal: true
+
+module StimulusPlumbers
+  module Helpers
+    module ComboboxHelper
+      def sp_combobox_date(label: nil, value: nil, **html_options)
+        opts = Components::Combobox::Date.default_opts.deep_merge(
+          input:   { value: value },
+          popover: { content: Components::Combobox::Date.new(self).render(value: value) }
+        )
+        opts = opts.deep_merge(trigger: { aria_label: label }) if label
+        Components::Combobox.new(self).render(
+          base_id: sp_dom_id,
+          options: opts,
+          data:    { input_format_type_value: "date" },
+          **html_options
+        )
+      end
+
+      def sp_combobox_dropdown(label: nil, options: [], value: nil, **html_options)
+        opts = Components::Combobox::Dropdown.default_opts.deep_merge(
+          input:   { value: value },
+          popover: { content: Components::Combobox::Dropdown.new(self).render(options: options, value: value, label: label) }
+        )
+        opts = opts.deep_merge(trigger: { aria_label: label }) if label
+        Components::Combobox.new(self).render(
+          base_id: sp_dom_id,
+          options: opts,
+          **html_options
+        )
+      end
+
+      def sp_combobox_autocomplete(label: nil, options: [], value: nil, url: nil, **html_options)
+        id         = sp_dom_id
+        popover_id = "#{id}_popover"
+        opts       = Components::Combobox::Autocomplete.default_opts.deep_merge(
+          input:   { value: value },
+          popover: {
+            content: Components::Combobox::Autocomplete.new(self).render(
+              options: options,
+              value:   value,
+              label:   label
+            ),
+            data:    url ? { combobox_dropdown_url_value: url } : {}
+          }
+        )
+        opts = opts.deep_merge(trigger: { aria_label: label }) if label
+        Components::Combobox.new(self).render(
+          base_id: id,
+          options: opts,
+          data:    {
+            input_combobox_combobox_dropdown_outlet: "##{popover_id}",
+            action:                                  "input->input-combobox#onInput"
+          },
+          **html_options
+        )
+      end
+
+      def sp_combobox_time(format: :h12, label: nil, step: 1, value: nil, **html_options)
+        opts = Components::Combobox::Time.default_opts.deep_merge(
+          input:   { value: value },
+          popover: { content: Components::Combobox::Time.new(self).render(format: format, step: step, value: value) }
+        )
+        opts = opts.deep_merge(trigger: { aria_label: label }) if label
+        Components::Combobox.new(self).render(
+          base_id: sp_dom_id,
+          options: opts,
+          data:    { input_format_type_value: "time", input_format_options_value: { format: format }.to_json },
+          **html_options
+        )
+      end
+    end
+  end
+end

data/lib/stimulus_plumbers/helpers/popover_helper.rb

@@ -4,13 +4,13 @@ module StimulusPlumbers
   module Helpers
     module PopoverHelper
       def sp_popover(interactive: true, **html_options, &block)
-        popover_renderer.popover(interactive: interactive, **html_options, &block)
+        popover_renderer.render(interactive: interactive, **html_options, &block)
       end
 
       private
 
       def popover_renderer
-        Components::Popover::Renderer.new(self)
+        Components::Popover.new(self)
       end
     end
   end

data/lib/stimulus_plumbers/helpers.rb

@@ -7,7 +7,7 @@ require_relative "helpers/button_helper"
 require_relative "helpers/calendar_helper"
 require_relative "helpers/calendar_turbo_helper"
 require_relative "helpers/card_helper"
-require_relative "helpers/date_picker_helper"
+require_relative "helpers/combobox_helper"
 require_relative "helpers/popover_helper"
 
 module StimulusPlumbers
@@ -19,7 +19,7 @@ module StimulusPlumbers
     include CalendarHelper
     include CalendarTurboHelper
     include CardHelper
-    include DatePickerHelper
+    include ComboboxHelper
     include PopoverHelper
   end
 end

data/lib/stimulus_plumbers/plumber/base.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module StimulusPlumbers
+  module Plumber
+    class Base
+      include HtmlOptions
+      include Renderer
+
+      attr_reader :template
+
+      def initialize(template)
+        @template = template
+      end
+
+      def theme
+        StimulusPlumbers.config.theme
+      end
+    end
+  end
+end