stimulus_plumbers 0.2.7 → 0.2.9

data/lib/stimulus_plumbers/plumber/dispatcher.rb

@@ -0,0 +1,111 @@
+# frozen_string_literal: true
+
+# :markup: markdown
+
+module StimulusPlumbers
+  module Plumber
+    module Dispatcher
+      class MethodCall
+        attr_reader :method_name, :args, :kwargs
+
+        def initialize(method_name, *args, **kwargs)
+          @method_name = method_name
+          @args = args
+          @kwargs = kwargs
+          validate!
+        end
+
+        def call(target)
+          raise NotImplementedError, "#{method_name.inspect} not implemented" unless target.respond_to?(method_name, true)
+
+          method_call = target.method(method_name)
+          accepts_args = method_call.arity.negative? ? args : args.take(method_call.arity)
+          accepts_kwargs = method_call.parameters.any? { |type, _| %i[key keyreq keyrest].include?(type) }
+          accepts_kwargs ? method_call.call(*accepts_args, **kwargs) : method_call.call(*accepts_args)
+        end
+
+        private
+
+        def validate!
+          return if method_name.is_a?(String) || method_name.is_a?(Symbol)
+
+          raise ArgumentError, "invalid method name: #{method_name.inspect}"
+        end
+      end
+
+      class InstanceExec
+        attr_reader :block, :args, :kwargs
+
+        def initialize(block, *args, **kwargs)
+          @block = block
+          @args = args
+          @kwargs = kwargs
+          validate!
+        end
+
+        def call(target)
+          accepts_args = block.arity.negative? ? args : args.take(block.arity)
+          accepts_kwargs = block.parameters.any? { |type, _| %i[key keyreq keyrest].include?(type) }
+          if accepts_kwargs
+            target.instance_exec(
+              *accepts_args,
+              **kwargs,
+              &block
+            )
+          else
+            target.instance_exec(*accepts_args, &block)
+          end
+        end
+
+        private
+
+        def validate!
+          raise ArgumentError, "invalid block: #{block.inspect}" unless block.is_a?(Proc)
+        end
+      end
+
+      class KlassProxy
+        attr_reader :klass, :method_name, :args, :kwargs, :init_args, :init_kwargs
+
+        def initialize(klass, method_name, *args, init_args: [], init_kwargs: {}, **kwargs)
+          @klass = klass
+          @method_name = method_name
+          @args = args
+          @kwargs = kwargs
+          @init_args = init_args
+          @init_kwargs = init_kwargs
+          validate!
+        end
+
+        def call(_target)
+          klass.new(*init_args, **init_kwargs).public_send(method_name, *args, **kwargs)
+        end
+
+        private
+
+        def validate!
+          raise ArgumentError, "invalid class: #{klass.inspect}" unless klass.is_a?(Module)
+          return if method_name.is_a?(String) || method_name.is_a?(Symbol)
+
+          raise ArgumentError, "invalid method name: #{method_name.inspect}"
+        end
+      end
+
+      def self.build(callable, *args, method_name: nil, init_args: [], init_kwargs: {}, **kwargs)
+        case callable
+        when Symbol
+          MethodCall.new(callable, *args, **kwargs)
+        when Proc
+          InstanceExec.new(callable, *args, **kwargs)
+        when Module
+          KlassProxy.new(callable, method_name, *args, init_args: init_args, init_kwargs: init_kwargs, **kwargs)
+        when String
+          klass = callable.safe_constantize
+          raise ArgumentError, "could not resolve class from: #{callable.inspect}" unless klass
+
+          KlassProxy.new(klass, method_name, *args, init_args: init_args, init_kwargs: init_kwargs, **kwargs)
+        end
+      end
+    end
+  end
+end

data/lib/stimulus_plumbers/plumber/html_options.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+require "active_support/concern"
+
+module StimulusPlumbers
+  module Plumber
+    module HtmlOptions
+      extend ActiveSupport::Concern
+
+      def merge_html_options(*hashes)
+        classes     = hashes.flat_map { |h| [h[:class], h[:classes]] }
+        data_hashes = hashes.map { |h| h[:data] || {} }
+        rest        = hashes.map { |h| h.except(:class, :classes, :data) }.reduce({}, :deep_merge)
+
+        class_value = merge_string_option(*classes).presence
+        merged_data = merge_data_options(*data_hashes)
+
+        result = class_value ? rest.merge(class: class_value) : rest
+        merged_data.present? ? result.merge(data: merged_data) : result
+      end
+
+      STIMULUS_SPACEJOIN_KEYS = %i[controller action].freeze
+
+      def merge_data_options(*hashes, spacejoin: STIMULUS_SPACEJOIN_KEYS)
+        hashes.reduce({}) do |acc, d|
+          acc.merge(d) do |key, old_val, new_val|
+            if spacejoin.include?(key.to_sym)
+              merge_string_option(old_val, new_val).presence || new_val
+            else
+              new_val
+            end
+          end
+        end
+      end
+
+      def merge_string_option(*parts, delimiter: " ")
+        tokens = parts.flat_map { |part| normalize_part(part, delimiter) }
+        tokens.compact.uniq.join(delimiter)
+      end
+
+      def normalize_part(value, delimiter)
+        case value
+        when String then value.present? ? value.split(delimiter) : []
+        when Hash then value.filter_map { |key, val| key if val }
+        when Array then [merge_string_option(*value).presence]
+        else []
+        end
+      end
+    end
+  end
+end

data/lib/stimulus_plumbers/plumber/renderer.rb

@@ -0,0 +1,89 @@
+# frozen_string_literal: true
+
+require "active_support/concern"
+
+module StimulusPlumbers
+  module Plumber
+    module Renderer
+      extend ActiveSupport::Concern
+
+      included do
+        class_attribute :renderers, instance_writer: false, default: {}
+      end
+
+      module ClassMethods
+        # rubocop:disable Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity
+        def renders(method_name, with: nil, &block)
+          raise ArgumentError, "method_name must be Symbol" unless method_name.is_a?(Symbol)
+          raise ArgumentError, "provide either with: or a block" if !with.nil? && block_given?
+
+          with = block if block_given?
+
+          with_proc_or_symbol = with.is_a?(Proc) || with.is_a?(Symbol)
+          with_klazz = with.is_a?(Module) || with.is_a?(String)
+          raise ArgumentError, "with: must be a Symbol/Proc/Class" unless with_proc_or_symbol || with_klazz
+
+          self.renderers = renderers.merge(method_name => with)
+          ActiveSupport.version >= "7.2" ? generate_renderer_method(method_name) : eval_renderer_method(method_name)
+        end
+        # rubocop:enable Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity
+
+        private
+
+        def generated_renderer_methods
+          @generated_renderer_methods ||= Module.new.tap { |mod| prepend mod }
+        end
+
+        def eval_renderer_method(method_name)
+          generated_renderer_methods.module_eval(<<-RUBY, __FILE__, __LINE__ + 1)
+            # def method_name(*args, **kwargs)
+            #   renderer = renderers.fetch(:method_name, {})
+            #
+            #   unless renderer.present?
+            #     raise ArgumentError, "#method_name not found in renderer" unless defined?(super)
+            #     super
+            #   end
+            #
+            #   dispatcher = StimulusPlumbers::Plumber::Dispatcher.build(
+            #     renderer, *args, method_name: :#{method_name}, init_args: [template], **kwargs
+            #   )
+            #   raise ArgumentError, "invalid renderer, got: \#{renderer.inspect}" unless dispatcher
+            #
+            #   dispatcher.call(self)
+            # end
+            #{renderer_method_template(method_name)}
+          RUBY
+        end
+
+        def generate_renderer_method(method_name)
+          require "active_support/code_generator"
+          ActiveSupport::CodeGenerator.batch(generated_renderer_methods, __FILE__, __LINE__) do |owner|
+            owner.define_cached_method(method_name, namespace: :plumber_renderers) do |batch|
+              batch << renderer_method_template(method_name)
+            end
+          end
+        end
+
+        def renderer_method_template(method_name)
+          <<-RUBY
+          def #{method_name}(*args, **kwargs)
+            renderer = renderers.fetch(:#{method_name}, {})
+
+            unless renderer.present?
+              raise ArgumentError, "##{method_name} not found in renderer" unless defined?(super)
+              super
+            end
+
+            dispatcher = StimulusPlumbers::Plumber::Dispatcher.build(
+              renderer, *args, method_name: :#{method_name}, init_args: [template], **kwargs
+            )
+            raise ArgumentError, "invalid renderer, got: \#{renderer.inspect}" unless dispatcher
+
+            dispatcher.call(self)
+          end
+          RUBY
+        end
+      end
+    end
+  end
+end

data/lib/stimulus_plumbers/themes/base.rb

@@ -1,25 +1,19 @@
 # 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"
+require_relative "schema"
 
 module StimulusPlumbers
   module Themes
     class Base
       SCHEMA = {
-        **ActionList::SCHEMA,
-        **Avatar::SCHEMA,
-        **Button::SCHEMA,
-        **Calendar::SCHEMA,
-        **Card::SCHEMA,
-        **Form::SCHEMA,
-        **Layout::SCHEMA
+        **Schema::ACTION_LIST,
+        **Schema::AVATAR,
+        **Schema::BUTTON,
+        **Schema::CALENDAR,
+        **Schema::CARD,
+        **Schema::COMBOBOX,
+        **Schema::FORM,
+        **Schema::LAYOUT
       }.freeze
 
       def name

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

@@ -4,11 +4,11 @@ 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
+        BOOL           = [true, false].freeze
+        SIZE           = %i[sm md lg].freeze
+        FLEX_ALIGN     = %i[left center right top bottom].freeze
+        FLEX_DIRECTION = %i[row col].freeze
+        FORM_LAYOUT    = %i[stacked inline].freeze
       end
     end
   end

data/lib/stimulus_plumbers/themes/schema.rb

@@ -0,0 +1,97 @@
+# frozen_string_literal: true
+
+require_relative "schema/ranges"
+
+module StimulusPlumbers
+  module Themes
+    module Schema
+      ACTION_LIST = {
+        action_list_item: {
+          active: { default: false, range: Ranges::BOOL }
+        }.freeze,
+        action_list:      {}.freeze
+      }.freeze
+
+      AVATAR = {
+        avatar: {
+          size:  { default: :md, range: Ranges::SIZE },
+          color: { default: nil, range: :avatar_color_range }
+        }.freeze
+      }.freeze
+
+      BUTTON = {
+        button:       {
+          variant: { default: :primary, range: %i[primary secondary outline destructive ghost link].freeze },
+          size:    { default: :md,      range: Ranges::SIZE }
+        }.freeze,
+        button_group: {
+          alignment: { default: :left, range: Ranges::FLEX_ALIGN },
+          direction: { default: :row,  range: Ranges::FLEX_DIRECTION }
+        }.freeze
+      }.freeze
+
+      CALENDAR = {
+        calendar:                           {}.freeze,
+        calendar_days_of_week:              {}.freeze,
+        calendar_days_of_month:             {}.freeze,
+        calendar_day:                       {
+          today:    { default: false, range: Ranges::BOOL },
+          selected: { default: false, range: Ranges::BOOL },
+          outside:  { default: false, range: Ranges::BOOL }
+        }.freeze,
+        calendar_navigation:                {}.freeze,
+        calendar_navigation_navigator:      {}.freeze,
+        calendar_navigation_navigator_icon: {}.freeze
+      }.freeze
+
+      CARD = {
+        card:         {}.freeze,
+        card_section: {}.freeze
+      }.freeze
+
+      COMBOBOX = {
+        combobox_option:               {
+          selected: { default: false, range: Ranges::BOOL },
+          disabled: { default: false, range: Ranges::BOOL }
+        }.freeze,
+        combobox_option_group:         {}.freeze,
+        combobox_listbox:              {}.freeze,
+        combobox_autocomplete_loading: {}.freeze,
+        combobox_autocomplete_empty:   {}.freeze,
+        combobox_time:                 {}.freeze
+      }.freeze
+
+      FORM = {
+        form_group:         {
+          layout: { default: :stacked, range: Ranges::FORM_LAYOUT },
+          error:  { default: false,    range: Ranges::BOOL }
+        }.freeze,
+        form_label:         {
+          required: { default: false, range: Ranges::BOOL },
+          hidden:   { default: false, range: Ranges::BOOL }
+        }.freeze,
+        form_required_mark: {}.freeze,
+        form_details:       {}.freeze,
+        form_error:         {}.freeze,
+        form_input:         { error: { default: false, range: Ranges::BOOL } }.freeze,
+        form_textarea:      { error: { default: false, range: Ranges::BOOL } }.freeze,
+        form_file:          { error: { default: false, range: Ranges::BOOL } }.freeze,
+        form_select:        { error: { default: false, range: Ranges::BOOL } }.freeze,
+        form_checkbox:      { error: { default: false, range: Ranges::BOOL } }.freeze,
+        form_radio:         { error: { default: false, range: Ranges::BOOL } }.freeze,
+        form_input_group:   { error: { default: false, range: Ranges::BOOL } }.freeze,
+        form_combobox:      { error: { default: false, range: Ranges::BOOL } }.freeze,
+        form_input_reveal:  {}.freeze,
+        form_button_reveal: {}.freeze,
+        form_submit:        {
+          variant: { default: :default, range: %i[default button].freeze }
+        }.freeze
+      }.freeze
+
+      LAYOUT = {
+        divider: {}.freeze,
+        popover: {}.freeze
+      }.freeze
+    end
+  end
+end

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

@@ -4,7 +4,16 @@ module StimulusPlumbers
   module Themes
     module Tailwind
       module Calendar
-        BASE = %w[
+        GRID = %w[w-full].freeze
+
+        DAYS_OF_WEEK = %w[
+          grid grid-cols-7 text-center text-[--sp-text-xs]
+          font-medium text-[--sp-color-muted-fg] mb-1
+        ].freeze
+
+        DAYS_OF_MONTH = %w[grid grid-cols-7].freeze
+
+        DAY = %w[
           size-[--sp-calendar-day-size] rounded-[--sp-radius-md]
           flex items-center justify-center text-[--sp-text-sm]
           hover:bg-[--sp-color-muted] cursor-pointer
@@ -16,18 +25,55 @@ module StimulusPlumbers
           hover:bg-[--sp-color-primary]/90
         ].freeze
 
+        NAV = %w[flex items-center justify-between gap-1 mb-2].freeze
+
+        NAV_BTN = %w[
+          inline-flex items-center justify-center
+          size-[--sp-calendar-day-size] rounded-[--sp-radius-md]
+          text-[--sp-color-fg] hover:bg-[--sp-color-muted]
+          focus-visible:outline-none focus-visible:ring-2
+          focus-visible:ring-[--sp-focus-ring-color]
+          disabled:pointer-events-none disabled:opacity-50
+        ].freeze
+
+        NAV_ICON = %w[size-4 stroke-current].freeze
+
         private
 
+        def calendar_classes
+          { classes: klasses(*GRID) }
+        end
+
+        def calendar_days_of_week_classes
+          { classes: klasses(*DAYS_OF_WEEK) }
+        end
+
+        def calendar_days_of_month_classes
+          { classes: klasses(*DAYS_OF_MONTH) }
+        end
+
         def calendar_day_classes(today: false, selected: false, outside: false)
           {
             classes: klasses(
-              *BASE,
+              *DAY,
               *(today    ? ["font-bold"] : []),
               *(selected ? DAY_SELECTED : []),
               *(outside  ? %w[text-[--sp-color-muted-fg] opacity-50] : [])
             )
           }
         end
+
+        def calendar_navigation_classes
+          { classes: klasses(*NAV) }
+        end
+
+        def calendar_navigation_navigator_classes
+          { classes: klasses(*NAV_BTN) }
+        end
+
+        def calendar_navigation_navigator_icon_classes
+          { classes: klasses(*NAV_ICON) }
+        end
       end
     end
   end

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

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+
+module StimulusPlumbers
+  module Themes
+    module Tailwind
+      module Combobox
+        LISTBOX = %w[
+          py-[--sp-space-1] overflow-y-auto max-h-60
+        ].freeze
+
+        OPTION_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]
+        ].freeze
+
+        OPTION_SELECTED = %w[
+          bg-[--sp-color-primary]/10 text-[--sp-color-primary]
+        ].freeze
+
+        OPTION_DISABLED = %w[
+          opacity-50 cursor-not-allowed pointer-events-none
+        ].freeze
+
+        OPTION_GROUP = %w[py-[--sp-space-1]].freeze
+
+        AUTOCOMPLETE_LOADING = %w[
+          flex items-center justify-center
+          py-[--sp-space-2] text-[--sp-text-sm] text-[--sp-color-muted-fg]
+        ].freeze
+
+        AUTOCOMPLETE_EMPTY = %w[
+          flex items-center justify-center
+          py-[--sp-space-2] text-[--sp-text-sm] text-[--sp-color-muted-fg]
+        ].freeze
+
+        TIME = %w[flex gap-[--sp-space-2] overflow-hidden].freeze
+
+        private
+
+        def combobox_listbox_classes
+          { classes: klasses(*LISTBOX) }
+        end
+
+        def combobox_option_classes(selected: false, disabled: false)
+          {
+            classes: klasses(
+              *OPTION_BASE,
+              *(selected ? OPTION_SELECTED : []),
+              *(disabled ? OPTION_DISABLED : [])
+            )
+          }
+        end
+
+        def combobox_option_group_classes
+          { classes: klasses(*OPTION_GROUP) }
+        end
+
+        def combobox_autocomplete_loading_classes
+          { classes: klasses(*AUTOCOMPLETE_LOADING) }
+        end
+
+        def combobox_autocomplete_empty_classes
+          { classes: klasses(*AUTOCOMPLETE_EMPTY) }
+        end
+
+        def combobox_time_classes
+          { classes: klasses(*TIME) }
+        end
+      end
+    end
+  end
+end

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

@@ -21,8 +21,8 @@ module StimulusPlumbers
         CHECKBOX      = %w[size-4 rounded border-gray-500 text-blue-700].freeze
         RADIO         = %w[size-4 border-gray-500 text-blue-700].freeze
 
-        ACTOR_BASE    = %w[flex items-center overflow-hidden rounded-md border].freeze
-        ACTOR_BORDER  = { error: "border-red-700", default: "border-gray-500" }.freeze
+        INPUT_GROUP_BASE   = %w[flex items-center overflow-hidden rounded-md border].freeze
+        INPUT_GROUP_BORDER = { error: "border-red-700", default: "border-gray-500" }.freeze
 
         INPUT_REVEAL = %w[
           flex-1 border-0 bg-transparent px-3 py-2 text-sm text-gray-900 focus:outline-none
@@ -38,8 +38,8 @@ module StimulusPlumbers
           { classes: klasses(*GROUP_BASE, layout == :inline ? GROUP_INLINE : "flex-col") }
         end
 
-        def form_label_classes(**)
-          { classes: klasses(*LABEL) }
+        def form_label_classes(hidden: false, **)
+          { classes: klasses(*LABEL, hidden ? "sr-only" : nil) }
         end
 
         def form_required_mark_classes
@@ -78,8 +78,12 @@ module StimulusPlumbers
           { classes: klasses(*RADIO) }
         end
 
-        def form_actor_classes(error: false)
-          { classes: klasses(*ACTOR_BASE, ACTOR_BORDER[error ? :error : :default]) }
+        def form_input_group_classes(error: false)
+          { classes: klasses(*INPUT_GROUP_BASE, INPUT_GROUP_BORDER[error ? :error : :default]) }
+        end
+
+        def form_combobox_classes(error: false)
+          form_input_classes(error: error)
         end
 
         def form_input_reveal_classes

data/lib/stimulus_plumbers/themes/tailwind_theme.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require_relative "tailwind/action_list"
+require_relative "tailwind/combobox"
 require_relative "tailwind/avatar"
 require_relative "tailwind/button"
 require_relative "tailwind/calendar"
@@ -12,6 +13,7 @@ module StimulusPlumbers
   module Themes
     class TailwindTheme < Base
       include Tailwind::ActionList
+      include Tailwind::Combobox
       include Tailwind::Avatar
       include Tailwind::Button
       include Tailwind::Calendar

data/lib/stimulus_plumbers/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module StimulusPlumbers
-  VERSION = "0.2.7"
+  VERSION = "0.2.9"
 end