stimulus_plumbers 0.2.9 → 0.3.1

data/lib/stimulus_plumbers/themes/base.rb

@@ -13,6 +13,7 @@ module StimulusPlumbers
         **Schema::CARD,
         **Schema::COMBOBOX,
         **Schema::FORM,
+        **Schema::ICON,
         **Schema::LAYOUT
       }.freeze
 
@@ -20,6 +21,22 @@ module StimulusPlumbers
         @name ||= self.class.name.demodulize.delete_suffix("Theme")
       end
 
+      def avatar_colors
+        {}
+      end
+
+      def avatar_color_range
+        []
+      end
+
+      def icons
+        {}
+      end
+
+      def icon_range
+        icons.keys
+      end
+
       def attribute_names(component)
         SCHEMA.fetch(component, {}).keys
       end
@@ -49,11 +66,7 @@ module StimulusPlumbers
       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
+        range = range_for(schema)
         return value if range.empty? || range.include?(value)
 
         StimulusPlumbers::Logger.warn(
@@ -62,6 +75,14 @@ module StimulusPlumbers
         )
         schema[:default]
       end
+
+      def range_for(schema)
+        if schema[:range].is_a?(Symbol)
+          respond_to?(schema[:range], true) ? send(schema[:range]) : []
+        else
+          schema[:range]
+        end
+      end
     end
   end
 end

data/lib/stimulus_plumbers/themes/configuration.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+module StimulusPlumbers
+  module Themes
+    class Configuration
+      def register(name, klass)
+        raise ArgumentError, "#{klass} must be a subclass of Themes::Base" unless klass <= Base
+
+        registry[name.to_sym] = klass
+        self
+      end
+
+      def use(name_or_instance)
+        @current = resolve(name_or_instance)
+        self
+      end
+
+      def current
+        @current ||= Base.new
+      end
+
+      def registry
+        @registry ||= {}
+      end
+
+      private
+
+      def resolve(value)
+        return value if value.is_a?(Base)
+
+        klass = registry[value.to_sym]
+        raise ArgumentError, "Unknown theme #{value.inspect}. Registered: #{registry.keys.inspect}" unless klass
+
+        klass.new
+      end
+    end
+  end
+end

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

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module StimulusPlumbers
+  module Themes
+    module Schema
+      module Form
+        module Ranges
+          LAYOUT         = %i[stacked inline].freeze
+          SUBMIT_VARIANT = %i[default button].freeze
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module StimulusPlumbers
+  module Themes
+    module Schema
+      module Icon
+        DEFAULTS = {
+          fill:            "none",
+          view_box:        "0 0 24 24",
+          width:           "24",
+          height:          "24",
+          stroke:          "currentColor",
+          stroke_width:    1.5,
+          stroke_linecap:  :round,
+          stroke_linejoin: :round
+        }.freeze
+
+        ATTRS = ([:d] + DEFAULTS.keys).freeze
+
+        def self.resolve(icon_data)
+          return unless icon_data.is_a?(Hash)
+
+          merged = DEFAULTS.merge(icon_data.slice(*ATTRS)).transform_values(&:to_s)
+          return merged if merged[:d].present?
+
+          StimulusPlumbers::Logger.warn("Icon missing required :d attribute")
+          nil
+        end
+      end
+    end
+  end
+end

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

@@ -8,7 +8,7 @@ module StimulusPlumbers
         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
+        BUTTON_VARIANT = %i[primary secondary outline destructive ghost link].freeze
       end
     end
   end

data/lib/stimulus_plumbers/themes/schema.rb

@@ -1,6 +1,8 @@
 # frozen_string_literal: true
 
 require_relative "schema/ranges"
+require_relative "schema/form/ranges"
+require_relative "schema/icon"
 
 module StimulusPlumbers
   module Themes
@@ -21,7 +23,7 @@ module StimulusPlumbers
 
       BUTTON = {
         button:       {
-          variant: { default: :primary, range: %i[primary secondary outline destructive ghost link].freeze },
+          variant: { default: :primary, range: Ranges::BUTTON_VARIANT },
           size:    { default: :md,      range: Ranges::SIZE }
         }.freeze,
         button_group: {
@@ -33,6 +35,7 @@ module StimulusPlumbers
       CALENDAR = {
         calendar:                           {}.freeze,
         calendar_days_of_week:              {}.freeze,
+        calendar_week:                      {}.freeze,
         calendar_days_of_month:             {}.freeze,
         calendar_day:                       {
           today:    { default: false, range: Ranges::BOOL },
@@ -41,7 +44,9 @@ module StimulusPlumbers
         }.freeze,
         calendar_navigation:                {}.freeze,
         calendar_navigation_navigator:      {}.freeze,
-        calendar_navigation_navigator_icon: {}.freeze
+        calendar_navigation_navigator_icon: {
+          name: { default: "arrow-left", range: :icon_range }
+        }.freeze
       }.freeze
 
       CARD = {
@@ -50,6 +55,7 @@ module StimulusPlumbers
       }.freeze
 
       COMBOBOX = {
+        combobox_trigger:              {}.freeze,
         combobox_option:               {
           selected: { default: false, range: Ranges::BOOL },
           disabled: { default: false, range: Ranges::BOOL }
@@ -63,7 +69,7 @@ module StimulusPlumbers
 
       FORM = {
         form_group:         {
-          layout: { default: :stacked, range: Ranges::FORM_LAYOUT },
+          layout: { default: :stacked, range: Form::Ranges::LAYOUT },
           error:  { default: false,    range: Ranges::BOOL }
         }.freeze,
         form_label:         {
@@ -81,13 +87,19 @@ module StimulusPlumbers
         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_input_reveal:  { error: { default: false, range: Ranges::BOOL } }.freeze,
+        form_input_search:  {}.freeze,
         form_button_reveal: {}.freeze,
+        form_button_clear:  {}.freeze,
         form_submit:        {
-          variant: { default: :default, range: %i[default button].freeze }
+          variant: { default: :default, range: Form::Ranges::SUBMIT_VARIANT }
         }.freeze
       }.freeze
 
+      ICON = {
+        icon: {}.freeze
+      }.freeze
+
       LAYOUT = {
         divider: {}.freeze,
         popover: {}.freeze

data/lib/stimulus_plumbers/version.rb

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

data/lib/stimulus_plumbers.rb

@@ -26,6 +26,7 @@ require_relative "stimulus_plumbers/components/card/section"
 require_relative "stimulus_plumbers/components/action_list"
 require_relative "stimulus_plumbers/components/action_list/section"
 require_relative "stimulus_plumbers/components/action_list/item"
+require_relative "stimulus_plumbers/components/divider"
 require_relative "stimulus_plumbers/components/popover"
 require_relative "stimulus_plumbers/components/popover/builder"
 
@@ -54,10 +55,11 @@ require_relative "stimulus_plumbers/components/combobox/time/drum"
 
 # -- Form --
 require_relative "stimulus_plumbers/form/field"
+require_relative "stimulus_plumbers/form/fields/error"
 require_relative "stimulus_plumbers/form/fields/group"
-require_relative "stimulus_plumbers/form/fields/label"
 require_relative "stimulus_plumbers/form/fields/hint"
-require_relative "stimulus_plumbers/form/fields/error"
+require_relative "stimulus_plumbers/form/fields/input_group"
+require_relative "stimulus_plumbers/form/fields/label"
 require_relative "stimulus_plumbers/form/builder"
 
 module StimulusPlumbers

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: stimulus_plumbers
 version: !ruby/object:Gem::Version
-  version: 0.2.9
+  version: 0.3.1
 platform: ruby
 authors:
 - Ryan Chang
@@ -10,7 +10,7 @@ cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: railties
+  name: actionview
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -69,6 +69,7 @@ files:
 - lib/stimulus_plumbers/components/combobox/trigger.rb
 - lib/stimulus_plumbers/components/date_picker/navigation.rb
 - lib/stimulus_plumbers/components/date_picker/navigator.rb
+- lib/stimulus_plumbers/components/divider.rb
 - lib/stimulus_plumbers/components/icon.rb
 - lib/stimulus_plumbers/components/popover.rb
 - lib/stimulus_plumbers/components/popover/builder.rb
@@ -76,20 +77,24 @@ files:
 - lib/stimulus_plumbers/engine.rb
 - lib/stimulus_plumbers/form/builder.rb
 - lib/stimulus_plumbers/form/field.rb
-- lib/stimulus_plumbers/form/fields/choice.rb
-- lib/stimulus_plumbers/form/fields/combobox.rb
 - lib/stimulus_plumbers/form/fields/error.rb
-- lib/stimulus_plumbers/form/fields/file.rb
+- lib/stimulus_plumbers/form/fields/fieldset.rb
 - lib/stimulus_plumbers/form/fields/group.rb
 - lib/stimulus_plumbers/form/fields/hint.rb
+- lib/stimulus_plumbers/form/fields/input_group.rb
+- lib/stimulus_plumbers/form/fields/inputs/choice.rb
+- lib/stimulus_plumbers/form/fields/inputs/datetime.rb
+- lib/stimulus_plumbers/form/fields/inputs/file.rb
+- lib/stimulus_plumbers/form/fields/inputs/password.rb
+- lib/stimulus_plumbers/form/fields/inputs/search.rb
+- lib/stimulus_plumbers/form/fields/inputs/select.rb
+- lib/stimulus_plumbers/form/fields/inputs/select/grouped.rb
+- lib/stimulus_plumbers/form/fields/inputs/select/timezone.rb
+- lib/stimulus_plumbers/form/fields/inputs/select/weekday.rb
+- lib/stimulus_plumbers/form/fields/inputs/submit.rb
+- lib/stimulus_plumbers/form/fields/inputs/text.rb
+- lib/stimulus_plumbers/form/fields/inputs/text_area.rb
 - lib/stimulus_plumbers/form/fields/label.rb
-- lib/stimulus_plumbers/form/fields/password.rb
-- lib/stimulus_plumbers/form/fields/renderer.rb
-- lib/stimulus_plumbers/form/fields/search.rb
-- lib/stimulus_plumbers/form/fields/select.rb
-- lib/stimulus_plumbers/form/fields/submit.rb
-- lib/stimulus_plumbers/form/fields/text.rb
-- lib/stimulus_plumbers/form/fields/text_area.rb
 - lib/stimulus_plumbers/helpers.rb
 - lib/stimulus_plumbers/helpers/action_list_helper.rb
 - lib/stimulus_plumbers/helpers/avatar_helper.rb
@@ -98,25 +103,24 @@ files:
 - lib/stimulus_plumbers/helpers/calendar_turbo_helper.rb
 - lib/stimulus_plumbers/helpers/card_helper.rb
 - lib/stimulus_plumbers/helpers/combobox_helper.rb
+- lib/stimulus_plumbers/helpers/divider_helper.rb
 - lib/stimulus_plumbers/helpers/plumber_helper.rb
 - lib/stimulus_plumbers/helpers/popover_helper.rb
 - lib/stimulus_plumbers/logger.rb
 - lib/stimulus_plumbers/plumber/base.rb
 - lib/stimulus_plumbers/plumber/dispatcher.rb
+- lib/stimulus_plumbers/plumber/dispatcher/callable_inspector.rb
+- lib/stimulus_plumbers/plumber/dispatcher/instance_exec.rb
+- lib/stimulus_plumbers/plumber/dispatcher/klass_proxy.rb
+- lib/stimulus_plumbers/plumber/dispatcher/method_call.rb
 - lib/stimulus_plumbers/plumber/html_options.rb
 - lib/stimulus_plumbers/plumber/renderer.rb
 - lib/stimulus_plumbers/themes/base.rb
+- lib/stimulus_plumbers/themes/configuration.rb
 - lib/stimulus_plumbers/themes/schema.rb
+- lib/stimulus_plumbers/themes/schema/form/ranges.rb
+- lib/stimulus_plumbers/themes/schema/icon.rb
 - lib/stimulus_plumbers/themes/schema/ranges.rb
-- lib/stimulus_plumbers/themes/tailwind/action_list.rb
-- lib/stimulus_plumbers/themes/tailwind/avatar.rb
-- lib/stimulus_plumbers/themes/tailwind/button.rb
-- lib/stimulus_plumbers/themes/tailwind/calendar.rb
-- lib/stimulus_plumbers/themes/tailwind/card.rb
-- lib/stimulus_plumbers/themes/tailwind/combobox.rb
-- lib/stimulus_plumbers/themes/tailwind/form.rb
-- lib/stimulus_plumbers/themes/tailwind/layout.rb
-- lib/stimulus_plumbers/themes/tailwind_theme.rb
 - lib/stimulus_plumbers/version.rb
 homepage: https://github.com/ryancyq/stimulus-plumbers
 licenses:

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

@@ -1,25 +0,0 @@
-# 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/combobox.rb

@@ -1,41 +0,0 @@
-# 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/file.rb

@@ -1,16 +0,0 @@
-# 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/password.rb

@@ -1,55 +0,0 @@
-# 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

@@ -1,52 +0,0 @@
-# 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)
-          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 field_label
-          Label.new(template).render(
-            text:     field.label_text,
-            for_id:   field.input_id,
-            required: field.required,
-            hidden:   field.label_hidden?
-          )
-        end
-
-        def field_hint
-          return "".html_safe unless field.details.present?
-
-          Hint.new(template).render(
-            text: field.details,
-            id:   field.hint_id
-          )
-        end
-
-        def field_errors
-          return "".html_safe if field.errors.none?
-
-          field.errors.map.with_index(1) do |message, i|
-            id = field.errors.one? ? field.error_id : "#{field.error_id}_#{i}"
-            Error.new(template).render(message: message, id: id)
-          end.join.html_safe
-        end
-      end
-    end
-  end
-end

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

@@ -1,54 +0,0 @@
-# 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

@@ -1,33 +0,0 @@
-# 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/submit.rb

@@ -1,23 +0,0 @@
-# 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