stimulus_plumbers 0.2.2

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

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module StimulusPlumbers
+  module Form
+    module Fields
+      module Choice
+        def check_box(attribute, options = {}, checked_value = "1", unchecked_value = "0")
+          rails_opts, form_field_opts = extract_options(options)
+          form_field_opts[:layout] ||= :inline
+          field     = build_field(attribute, form_field_opts)
+          html_opts = merge_html_options(rails_opts, field_theme(:form_checkbox, error: field.error?), field.html_opts)
+          render_field(field, super(attribute, html_opts, checked_value, unchecked_value))
+        end
+
+        def radio_button(attribute, tag_value, options = {})
+          rails_opts, form_field_opts = extract_options(options)
+          form_field_opts[:layout] ||= :inline
+          field     = build_field(attribute, form_field_opts, input_id: field_id(attribute, tag_value))
+          html_opts = merge_html_options(rails_opts, field_theme(:form_radio, error: field.error?), field.html_opts)
+          render_field(field, super(attribute, tag_value, html_opts))
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module StimulusPlumbers
+  module Form
+    module Fields
+      module File
+        def file_field(attribute, options = {})
+          rails_opts, form_field_opts = extract_options(options)
+          field     = build_field(attribute, form_field_opts)
+          html_opts = merge_html_options(rails_opts, field_theme(:form_file, error: field.error?), field.html_opts)
+          render_field(field, super(attribute, html_opts))
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+module StimulusPlumbers
+  module Form
+    module Fields
+      class Renderer
+        attr_reader :template, :theme, :field
+
+        def initialize(template, theme, field)
+          @template = template
+          @theme    = theme
+          @field    = field
+        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
+          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)
+        end
+
+        def hint_html
+          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)
+        end
+
+        def errors_html
+          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")
+          end.join.html_safe
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module StimulusPlumbers
+  module Form
+    module Fields
+      module Select
+        def select(attribute, choices = nil, 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)
+          render_field(field, super(attribute, choices, rails_opts, html_opts))
+        end
+
+        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)
+          render_field(
+            field,
+            super(attribute, collection, value_method, text_method, rails_opts, html_opts)
+          )
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module StimulusPlumbers
+  module Form
+    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
+        ].freeze
+
+        FIELD_TYPES.each do |method_name|
+          define_method(method_name) do |attribute, options = {}|
+            rails_opts, form_field_opts = extract_options(options)
+            field = build_field(attribute, form_field_opts)
+            html_opts = merge_html_options(rails_opts, field_theme(:form_input, error: field.error?), field.html_opts)
+            render_field(field, super(attribute, html_opts))
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module StimulusPlumbers
+  module Form
+    module Fields
+      module TextArea
+        def text_area(attribute, options = {})
+          rails_opts, form_field_opts = extract_options(options)
+          field     = build_field(attribute, form_field_opts)
+          html_opts = merge_html_options(rails_opts, field_theme(:form_textarea, error: field.error?), field.html_opts)
+          render_field(field, super(attribute, html_opts))
+        end
+      end
+    end
+  end
+end

data/lib/stimulus_plumbers/helpers/action_list_helper.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module StimulusPlumbers
+  module Helpers
+    module ActionListHelper
+      def sp_action_list(**html_options, &block)
+        action_list_renderer.list(**html_options, &block)
+      end
+
+      def sp_action_list_section(title: nil, **html_options, &block)
+        action_list_renderer.section(title: title, **html_options, &block)
+      end
+
+      def sp_action_list_item(content = nil, url: nil, external: false, active: false, **html_options, &block)
+        action_list_renderer.item(content, url: url, external: external, active: active, **html_options, &block)
+      end
+
+      private
+
+      def action_list_renderer
+        Components::ActionList::Renderer.new(self)
+      end
+    end
+  end
+end

data/lib/stimulus_plumbers/helpers/avatar_helper.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+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)
+      end
+
+      private
+
+      def avatar_renderer
+        Components::Avatar::Renderer.new(self)
+      end
+    end
+  end
+end

data/lib/stimulus_plumbers/helpers/button_helper.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+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(
+          content,
+          url: url, external: external, variant: variant, size: size, **html_options,
+          &block
+        )
+      end
+
+      def sp_button_group(alignment: :left, direction: :row, **html_options, &block)
+        button_renderer.group(alignment: alignment, direction: direction, **html_options, &block)
+      end
+
+      private
+
+      def button_renderer
+        Components::Button::Renderer.new(self)
+      end
+    end
+  end
+end

data/lib/stimulus_plumbers/helpers/calendar_helper.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module StimulusPlumbers
+  module Helpers
+    module CalendarHelper
+      def sp_calendar_month(date: nil, **html_options, &block)
+        if date
+          html_options.deep_merge!(
+            data: {
+              "calendar-month-year-value":  date.year,
+              "calendar-month-month-value": date.month - 1,
+              "calendar-month-day-value":   date.day
+            }
+          )
+        end
+        calendar_renderer.month(**html_options, &block)
+      end
+
+      private
+
+      def calendar_renderer
+        Components::Calendar::Renderer.new(self)
+      end
+    end
+  end
+end

data/lib/stimulus_plumbers/helpers/calendar_turbo_helper.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module StimulusPlumbers
+  module Helpers
+    module CalendarTurboHelper
+      def sp_calendar_month_turbo(
+        date: Date.today,
+        today: Date.today,
+        selectable: false,
+        selected_date: nil,
+        show_other_months: false,
+        **html_options
+      )
+        calendar_month_turbo_renderer.render(
+          date:              date,
+          today:             today,
+          selectable:        selectable,
+          selected_date:     selected_date,
+          show_other_months: show_other_months,
+          **html_options
+        )
+      end
+
+      private
+
+      def calendar_month_turbo_renderer
+        Components::Calendar::Month::Turbo::Renderer.new(self)
+      end
+    end
+  end
+end

data/lib/stimulus_plumbers/helpers/card_helper.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module StimulusPlumbers
+  module Helpers
+    module CardHelper
+      def sp_card(title: nil, **html_options, &block)
+        card_renderer.card(title: title, **html_options, &block)
+      end
+
+      def sp_card_section(title: nil, **html_options, &block)
+        card_renderer.section(title: title, **html_options, &block)
+      end
+
+      private
+
+      def card_renderer
+        Components::Card::Renderer.new(self)
+      end
+    end
+  end
+end

data/lib/stimulus_plumbers/helpers/date_picker_helper.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module StimulusPlumbers
+  module Helpers
+    module DatePickerHelper
+      def sp_date_picker_month(record = nil, attribute = nil, **html_options)
+        calendar_id        = sp_dom_id(record, [attribute, "date"].filter(&:presence).join("_"))
+        calendar_dialog_id = "#{calendar_id}_dialog"
+        Components::DatePicker::Renderer.new(self).render(
+          calendar_id:        calendar_id,
+          calendar_dialog_id: calendar_dialog_id,
+          **html_options
+        )
+      end
+    end
+  end
+end

data/lib/stimulus_plumbers/helpers/plumber_helper.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module StimulusPlumbers
+  module Helpers
+    module PlumberHelper
+      def sp_dom_id(record = nil, suffix = nil)
+        if record
+          dom_id(record, suffix)
+        else
+          "#{suffix}_#{SecureRandom.hex(8)}"
+        end
+      end
+    end
+  end
+end

data/lib/stimulus_plumbers/helpers/popover_helper.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module StimulusPlumbers
+  module Helpers
+    module PopoverHelper
+      def sp_popover(interactive: true, **html_options, &block)
+        popover_renderer.popover(interactive: interactive, **html_options, &block)
+      end
+
+      private
+
+      def popover_renderer
+        Components::Popover::Renderer.new(self)
+      end
+    end
+  end
+end

data/lib/stimulus_plumbers/helpers.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+require_relative "helpers/plumber_helper"
+require_relative "helpers/action_list_helper"
+require_relative "helpers/avatar_helper"
+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/popover_helper"
+
+module StimulusPlumbers
+  module Helpers
+    include PlumberHelper
+    include ActionListHelper
+    include AvatarHelper
+    include ButtonHelper
+    include CalendarHelper
+    include CalendarTurboHelper
+    include CardHelper
+    include DatePickerHelper
+    include PopoverHelper
+  end
+end

data/lib/stimulus_plumbers/logger.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module StimulusPlumbers
+  module Logger
+    LEVELS = %i[debug info warn error].freeze
+
+    module_function
+
+    LEVELS.each do |level|
+      define_method(level) do |message|
+        tagged = StimulusPlumbers.config.log_formatter.call(message)
+        if defined?(Rails) && Rails.respond_to?(:logger) && Rails.logger
+          Rails.logger.public_send(level, tagged)
+        else
+          warn(tagged)
+        end
+      end
+    end
+  end
+end

data/lib/stimulus_plumbers/themes/action_list.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module StimulusPlumbers
+  module Themes
+    module ActionList
+      SCHEMA = {
+        action_list_item: {
+          active: { default: false, range: Schema::Ranges::BOOL_RANGE }
+        }.freeze,
+        action_list:      {}.freeze
+      }.freeze
+    end
+  end
+end

data/lib/stimulus_plumbers/themes/avatar.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module StimulusPlumbers
+  module Themes
+    module Avatar
+      SCHEMA = {
+        avatar: {
+          size:  { default: :md,  range: Schema::Ranges::SIZE_RANGE },
+          color: { default: nil,  range: :avatar_color_range }
+        }.freeze
+      }.freeze
+    end
+  end
+end

data/lib/stimulus_plumbers/themes/base.rb

@@ -0,0 +1,73 @@
+# frozen_string_literal: true
+
+require_relative "schema/ranges"
+require_relative "action_list"
+require_relative "avatar"
+require_relative "button"
+require_relative "calendar"
+require_relative "card"
+require_relative "form"
+require_relative "layout"
+
+module StimulusPlumbers
+  module Themes
+    class Base
+      SCHEMA = {
+        **ActionList::SCHEMA,
+        **Avatar::SCHEMA,
+        **Button::SCHEMA,
+        **Calendar::SCHEMA,
+        **Card::SCHEMA,
+        **Form::SCHEMA,
+        **Layout::SCHEMA
+      }.freeze
+
+      def name
+        @name ||= self.class.name.demodulize.delete_suffix("Theme")
+      end
+
+      def attribute_names(component)
+        SCHEMA.fetch(component, {}).keys
+      end
+
+      # Resolves presentational classes for a component slot.
+      # Returns a Hash with :classes (String) and optionally :style (String).
+      # Returns {} when no mapping exists for the given component.
+      def resolve(component, **args)
+        method_name = :"#{component}_classes"
+        unless respond_to?(method_name, true)
+          StimulusPlumbers::Logger.warn("#{self.class} has no classes method for component #{component.inspect}")
+          return {}
+        end
+
+        send(method_name, **validate_args(component.to_sym, args))
+      end
+
+      private
+
+      def validate_args(component, args)
+        schema = SCHEMA.fetch(component, {})
+        args.slice(*schema.keys).each_with_object({}) do |(key, value), result|
+          result[key] = coerce_arg(component, key, value, schema[key])
+        end
+      end
+
+      def coerce_arg(component, key, value, schema)
+        return value unless schema
+
+        range = if schema[:range].is_a?(Symbol)
+                  respond_to?(schema[:range], true) ? send(schema[:range]) : []
+                else
+                  schema[:range]
+                end
+        return value if range.empty? || range.include?(value)
+
+        StimulusPlumbers::Logger.warn(
+          "#{component}##{key} received unknown value #{value.inspect}. " \
+          "Range: #{schema[:range].inspect}. Falling back to: #{schema[:default].inspect}"
+        )
+        schema[:default]
+      end
+    end
+  end
+end

data/lib/stimulus_plumbers/themes/button.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module StimulusPlumbers
+  module Themes
+    module Button
+      SCHEMA = {
+        button:       {
+          variant: { default: :primary, range: %i[primary secondary outline destructive ghost link].freeze },
+          size:    { default: :md,      range: Schema::Ranges::SIZE_RANGE }
+        }.freeze,
+        button_group: {
+          alignment: { default: :left, range: Schema::Ranges::ALIGN_RANGE },
+          direction: { default: :row,  range: Schema::Ranges::DIR_RANGE }
+        }.freeze
+      }.freeze
+    end
+  end
+end

data/lib/stimulus_plumbers/themes/calendar.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module StimulusPlumbers
+  module Themes
+    module Calendar
+      SCHEMA = {
+        calendar_day: {
+          today:    { default: false, range: Schema::Ranges::BOOL_RANGE },
+          selected: { default: false, range: Schema::Ranges::BOOL_RANGE },
+          outside:  { default: false, range: Schema::Ranges::BOOL_RANGE }
+        }.freeze
+      }.freeze
+    end
+  end
+end

data/lib/stimulus_plumbers/themes/card.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module StimulusPlumbers
+  module Themes
+    module Card
+      SCHEMA = {
+        card:         {}.freeze,
+        card_section: {}.freeze
+      }.freeze
+    end
+  end
+end

data/lib/stimulus_plumbers/themes/form.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module StimulusPlumbers
+  module Themes
+    module Form
+      SCHEMA = {
+        form_group:         {
+          layout: { default: :stacked, range: Schema::Ranges::LAYOUT_RANGE },
+          error:  { default: false,    range: Schema::Ranges::BOOL_RANGE }
+        }.freeze,
+        form_label:         { required: { default: false, range: Schema::Ranges::BOOL_RANGE } }.freeze,
+        form_required_mark: {}.freeze,
+        form_details:       {}.freeze,
+        form_error:         {}.freeze,
+        form_input:         { error: { default: false, range: Schema::Ranges::BOOL_RANGE } }.freeze,
+        form_textarea:      { error: { default: false, range: Schema::Ranges::BOOL_RANGE } }.freeze,
+        form_file:          { error: { default: false, range: Schema::Ranges::BOOL_RANGE } }.freeze,
+        form_select:        { error: { default: false, range: Schema::Ranges::BOOL_RANGE } }.freeze,
+        form_checkbox:      { error: { default: false, range: Schema::Ranges::BOOL_RANGE } }.freeze,
+        form_radio:         { error: { default: false, range: Schema::Ranges::BOOL_RANGE } }.freeze,
+        form_actor:         { error: { default: false, range: Schema::Ranges::BOOL_RANGE } }.freeze,
+        form_input_reveal:  {}.freeze,
+        form_button_reveal: {}.freeze,
+        form_submit:        {
+          variant: { default: :default, range: %i[default button].freeze }
+        }.freeze
+      }.freeze
+    end
+  end
+end

data/lib/stimulus_plumbers/themes/layout.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module StimulusPlumbers
+  module Themes
+    module Layout
+      SCHEMA = {
+        divider: {}.freeze,
+        popover: {}.freeze
+      }.freeze
+    end
+  end
+end

data/lib/stimulus_plumbers/themes/schema/ranges.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module StimulusPlumbers
+  module Themes
+    module Schema
+      module Ranges
+        BOOL_RANGE   = [true, false].freeze
+        SIZE_RANGE   = %i[sm md lg].freeze
+        ALIGN_RANGE  = %i[left center right top bottom].freeze
+        DIR_RANGE    = %i[row col].freeze
+        LAYOUT_RANGE = %i[stacked inline].freeze
+      end
+    end
+  end
+end

data/lib/stimulus_plumbers/themes/tailwind/action_list.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module StimulusPlumbers
+  module Themes
+    module Tailwind
+      module ActionList
+        LIST_ITEM_ACTIVE = %w[bg-[--sp-color-primary]/10 text-[--sp-color-primary]].freeze
+        LIST_ITEM_BASE   = %w[
+          flex items-center gap-[--sp-space-2] w-full
+          px-[--sp-space-2] py-[--sp-space-1]
+          rounded-[--sp-radius-sm] text-[--sp-text-sm]
+          cursor-pointer select-none outline-none
+          hover:bg-[--sp-color-muted] focus:bg-[--sp-color-muted] focus:text-[--sp-color-fg]
+        ].freeze
+
+        private
+
+        def action_list_classes
+          { classes: klasses("py-[--sp-space-1]") }
+        end
+
+        def action_list_item_classes(active: false)
+          {
+            classes: klasses(
+              *LIST_ITEM_BASE,
+              *(active ? LIST_ITEM_ACTIVE : [])
+            )
+          }
+        end
+      end
+    end
+  end
+end