stimulus_plumbers 0.4.8 → 0.4.10

data/lib/stimulus_plumbers/components/progress_meter.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+module StimulusPlumbers
+  module Components
+    class ProgressMeter < Plumber::Base
+      def render(...) = render_meter(...)
+
+      private
+
+      def render_meter(value:, min: 0, max: 100, low: nil, high: nil, optimum: nil, **kwargs)
+        attrs = { value: value, min: min, max: max, low: low, high: high, optimum: optimum }.compact
+        html_options = merge_html_options(
+          theme.resolve(:progress_meter),
+          kwargs,
+          stimulus_data(value: value, min: min, max: max, low: low, high: high, optimum: optimum),
+          attrs
+        )
+        template.content_tag(:meter, nil, **html_options)
+      end
+
+      def stimulus_data(value:, min:, max:, low:, high:, optimum:)
+        data = {
+          controller:               "progress",
+          "progress-target":        "meter",
+          "progress-variant-value": "meter",
+          "progress-current-value": value,
+          "progress-min-value":     min,
+          "progress-max-value":     max
+        }
+        data["progress-low-value"]     = low if low
+        data["progress-high-value"]    = high if high
+        data["progress-optimum-value"] = optimum if optimum
+        { data: data }
+      end
+    end
+  end
+end

data/lib/stimulus_plumbers/components/progress_ring.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+module StimulusPlumbers
+  module Components
+    class ProgressRing < Plumber::Base
+      def render(...) = render_ring(...)
+
+      private
+
+      def render_ring(value:, max: 100, min: 0, indeterminate: false, **kwargs)
+        icon_options = merge_html_options(
+          theme.resolve(:progress_ring),
+          kwargs,
+          stimulus_data(value: value, min: min, max: max, indeterminate: indeterminate),
+          { role: "progressbar", aria: progress_aria(value: value, min: min, max: max, indeterminate: indeterminate) }
+        )
+        Components::Icon.new(template).render(name: "progress-ring", **icon_options)
+      end
+
+      def progress_aria(value:, min:, max:, indeterminate:)
+        aria = { valuemin: min, valuemax: max }
+        aria[:valuenow] = value unless indeterminate
+        aria
+      end
+
+      def stimulus_data(value:, min:, max:, indeterminate:)
+        {
+          data: {
+            controller:                     "progress",
+            "progress-variant-value":       "ring",
+            "progress-current-value":       value,
+            "progress-min-value":           min,
+            "progress-max-value":           max,
+            "progress-indeterminate-value": indeterminate
+          }
+        }
+      end
+    end
+  end
+end

data/lib/stimulus_plumbers/components/timeline/event.rb

@@ -107,11 +107,12 @@ module StimulusPlumbers
           if type == :icon && icon_name
             Components::Icon.new(template).render(
               name:    icon_name,
+              size:    :sm,
               classes: theme.resolve(:timeline_item_indicator_icon_slot).fetch(:classes, ""),
               aria:    { hidden: "true" }
             )
           else
-            template.content_tag(:span, nil, **merge_html_options(theme.resolve(:timeline_item_indicator_dot)))
+            Components::Indicator.new(template).render(type: :dot, variant: :primary)
           end
         end
 

data/lib/stimulus_plumbers/components/timeline/group.rb

@@ -4,7 +4,8 @@ module StimulusPlumbers
   module Components
     class Timeline
       class Group < Plumber::Base
-        def render(**kwargs, &block)
+        def render(orientation: :vertical, **kwargs, &block)
+          @orientation = orientation
           content = template.capture(self, &block)
           html_options = merge_html_options(theme.resolve(:timeline_group), kwargs)
           template.content_tag(:div, content, **html_options)
@@ -12,7 +13,7 @@ module StimulusPlumbers
 
         def section(date:, datetime: nil, **kwargs, &block)
           inner_tl = Timeline.new(template)
-          inner_tl.instance_variable_set(:@orientation, :vertical)
+          inner_tl.instance_variable_set(:@orientation, @orientation)
           inner_tl.instance_variable_set(:@interactive, false)
 
           events_html  = template.capture(inner_tl, &block)
@@ -29,10 +30,11 @@ module StimulusPlumbers
             theme.resolve(:timeline_group_section_date),
             datetime ? { datetime: datetime } : {}
           )
+          list_attrs = merge_html_options(theme.resolve(:timeline_group_section_list, orientation: @orientation))
           template.safe_join(
             [
               template.content_tag(:time, date, **date_attrs),
-              template.content_tag(:ol, events_html, **merge_html_options(theme.resolve(:timeline_group_section_list)))
+              template.content_tag(:ol, events_html, **list_attrs)
             ]
           )
         end

data/lib/stimulus_plumbers/engine.rb

@@ -9,10 +9,6 @@ module StimulusPlumbers
     config.autoload_paths << File.expand_path("../stimulus-plumbers", __dir__)
     config.i18n.load_path += Dir[File.expand_path("../../config/locales/*.{rb,yml}", __dir__)]
 
-    initializer "stimulus_plumbers.assets", after: :set_default_precompile do |app|
-      app.config.assets.precompile += %w[stimulus_plumbers/tokens.css] if app.config.respond_to?(:assets)
-    end
-
     initializer "stimulus_plumbers.helpers" do
       ActiveSupport.on_load(:action_view) do
         include StimulusPlumbers::Helpers

data/lib/stimulus_plumbers/form/builder.rb

@@ -11,6 +11,8 @@ require_relative "fields/renderer"
 require_relative "fields/fieldset"
 require_relative "fields/inputs/checkbox"
 require_relative "fields/inputs/combobox"
+require_relative "fields/inputs/code"
+require_relative "fields/inputs/credit_card"
 require_relative "fields/inputs/datetime"
 require_relative "fields/inputs/radio"
 require_relative "fields/inputs/file"
@@ -30,6 +32,8 @@ module StimulusPlumbers
       include Plumber::Options::Html
       include Plumber::Options::Aria
       include Fields::Inputs::Checkbox
+      include Fields::Inputs::Code
+      include Fields::Inputs::CreditCard
       include Fields::Inputs::Datetime
       include Fields::Inputs::Radio
       include Fields::Inputs::File

data/lib/stimulus_plumbers/form/field.rb

@@ -8,7 +8,7 @@ module StimulusPlumbers
     class Field < Base
       TYPES = %i[
         text email number url tel color month week range datetime_local
-        text_area file password date time select search
+        text_area file password date time select search code credit_card
       ].freeze
       COLLECTION_TYPES = %i[radio check_box collection_select grouped_collection_select].freeze
       OPTIONS          = (Base::OPTIONS + %i[hide_label]).freeze

data/lib/stimulus_plumbers/form/fields/inputs/code.rb

@@ -0,0 +1,86 @@
+# frozen_string_literal: true
+
+module StimulusPlumbers
+  module Form
+    module Fields
+      module Inputs
+        module Code
+          private
+
+          def render_code_input(attribute, html_opts, opts, error, length:, charset: :digits, groups: [], **kwargs)
+            floating = kwargs.delete(:floating)
+            raise ArgumentError, "floating labels are not supported for code fields" if floating.present?
+
+            validate_code_options!(length, groups)
+            inputmode = kwargs.delete(:inputmode) || (charset.to_sym == :digits ? "numeric" : nil)
+            autocomplete = kwargs.delete(:autocomplete) || "one-time-code"
+            config = { error: error, length: length, charset: charset, groups: groups,
+                       autocomplete: autocomplete, inputmode: inputmode, kwargs: kwargs
+}
+            render_code_field(attribute, html_opts, opts, config)
+          end
+
+          def render_code_field(attribute, html_opts, opts, config)
+            @template.content_tag(:div, **code_wrapper_options(config)) do
+              @template.safe_join(
+                [render_code_cells(config), code_input(attribute, html_opts, opts, config)]
+              )
+            end
+          end
+
+          def code_wrapper_options(config)
+            merge_html_options(
+              theme.resolve(:form_field_input_code, error: config[:error]),
+              { data: {
+                controller:                    "input-formatter",
+                input_formatter_format_value:  "code",
+                input_formatter_options_value: { charset: config[:charset].to_s, length: config[:length] }.to_json,
+                input_formatter_groups_value:  config[:groups].presence
+              }
+}
+            )
+          end
+
+          def code_input(attribute, html_opts, opts, config)
+            input_options = merge_html_options(
+              theme.resolve(:form_field_input_code_overlay, error: config[:error]),
+              opts,
+              html_opts,
+              config[:kwargs],
+              { maxlength: config[:length], autocomplete: config[:autocomplete], inputmode: config[:inputmode],
+                data: { input_formatter_target: "input", action: formatter_actions }
+}
+            )
+            @template.text_field(@object_name, attribute, objectify_options(input_options))
+          end
+
+          def render_code_cells(config)
+            count = config[:groups].present? ? config[:groups].sum : config[:length]
+            cell_options = merge_html_options(
+              theme.resolve(:form_field_input_code_cell, error: config[:error]),
+              { data: { input_formatter_target: "cell" } }
+            )
+            @template.content_tag(:div, **merge_html_options(theme.resolve(:form_field_input_code_cells))) do
+              @template.safe_join(Array.new(count) { @template.content_tag(:span, nil, **cell_options) })
+            end
+          end
+
+          def validate_code_options!(length, groups)
+            raise ArgumentError, "length must be a positive integer" unless positive_integer?(length)
+            return if groups.blank?
+
+            raise ArgumentError, "groups must be an array of positive integers" unless valid_groups?(groups)
+            raise ArgumentError, "groups must add up to length" unless groups.sum == length
+          end
+
+          def valid_groups?(groups) = groups.is_a?(Array) && groups.all? { |group| positive_integer?(group) }
+          def positive_integer?(value) = value.is_a?(Integer) && value.positive?
+
+          def formatter_actions
+            "input->input-formatter#onInput focus->input-formatter#onFocus blur->input-formatter#onBlur"
+          end
+        end
+      end
+    end
+  end
+end

data/lib/stimulus_plumbers/form/fields/inputs/credit_card.rb

@@ -0,0 +1,98 @@
+# frozen_string_literal: true
+
+module StimulusPlumbers
+  module Form
+    module Fields
+      module Inputs
+        module CreditCard
+          DEFAULT_GROUPS = [4, 4, 4, 4].freeze
+
+          private
+
+          def render_credit_card_input(attribute, html_opts, opts, error, groups: DEFAULT_GROUPS, floating: nil, **kwargs)
+            raise ArgumentError, "floating labels are not supported for credit card fields" if floating.present?
+
+            normalized_groups = groups.presence || DEFAULT_GROUPS
+            inputmode = kwargs.delete(:inputmode) || "numeric"
+            autocomplete = kwargs.delete(:autocomplete) || "cc-number"
+            validate_credit_card_groups!(normalized_groups)
+            length = normalized_groups.sum
+            config = { error: error, groups: normalized_groups, length: length,
+                       autocomplete: autocomplete, inputmode: inputmode, kwargs: kwargs
+}
+            render_credit_card_field(attribute, html_opts, opts, config)
+          end
+
+          def render_credit_card_field(attribute, html_opts, opts, config)
+            @template.content_tag(:div, **credit_card_wrapper_options(config)) do
+              @template.safe_join(
+                [render_credit_card_cells(config), credit_card_input(attribute, html_opts, opts, config)]
+              )
+            end
+          end
+
+          def credit_card_wrapper_options(config)
+            merge_html_options(
+              theme.resolve(:form_field_input_credit_card, error: config[:error]),
+              { data: {
+                controller:                   "input-formatter",
+                input_formatter_format_value: "creditCard",
+                input_formatter_groups_value: config[:groups]
+              }
+}
+            )
+          end
+
+          def credit_card_input(attribute, html_opts, opts, config)
+            input_options = merge_html_options(
+              theme.resolve(:form_field_input_credit_card_overlay, error: config[:error]),
+              opts,
+              html_opts,
+              config[:kwargs],
+              { maxlength: config[:length], autocomplete: config[:autocomplete], inputmode: config[:inputmode],
+                data: { input_formatter_target: "input", action: formatter_actions }
+}
+            )
+            @template.text_field(@object_name, attribute, objectify_options(input_options))
+          end
+
+          def render_credit_card_cells(config)
+            cells = config[:groups].each_index.flat_map do |index|
+              index.zero? ? [render_credit_card_cell(config)] : [render_credit_card_separator, render_credit_card_cell(config)]
+            end
+
+            @template.content_tag(:div, **merge_html_options(theme.resolve(:form_field_input_credit_card_cells))) do
+              @template.safe_join(cells)
+            end
+          end
+
+          def render_credit_card_cell(config)
+            cell_options = merge_html_options(
+              theme.resolve(:form_field_input_credit_card_cell, error: config[:error]),
+              { data: { input_formatter_target: "cell" } }
+            )
+            @template.content_tag(:span, nil, **cell_options)
+          end
+
+          def render_credit_card_separator
+            separator_options = merge_html_options(
+              theme.resolve(:form_field_input_credit_card_separator),
+              { aria: { hidden: true } }
+            )
+            @template.content_tag(:span, "-", **separator_options)
+          end
+
+          def validate_credit_card_groups!(groups)
+            return if groups.is_a?(Array) && groups.all? { |group| group.is_a?(Integer) && group.positive? }
+
+            raise ArgumentError, "groups must be an array of positive integers"
+          end
+
+          def formatter_actions
+            "input->input-formatter#onInput focus->input-formatter#onFocus blur->input-formatter#onBlur"
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -51,6 +51,7 @@ module StimulusPlumbers
             build_reveal_button do
               Components::Icon.new(@template).render(
                 name: "reveal",
+                size: :sm,
                 aria: { hidden: "true" },
                 **theme.resolve(:button_icon)
               )

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

@@ -83,6 +83,7 @@ module StimulusPlumbers
             build_clear_button do
               Components::Icon.new(@template).render(
                 name: "close",
+                size: :sm,
                 aria: { hidden: "true" },
                 **theme.resolve(:button_icon)
               )

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

@@ -18,6 +18,8 @@ module StimulusPlumbers
           text_area:      :render_text_area_input,
           file:           :render_file_input,
           password:       :render_password_input,
+          code:           :render_code_input,
+          credit_card:    :render_credit_card_input,
           date:           :render_combobox_date,
           time:           :render_combobox_time,
           select:         :render_combobox_dropdown,

data/lib/stimulus_plumbers/generators/css_entrypoint.rb

@@ -1,15 +1,25 @@
 # frozen_string_literal: true
 
+require "fileutils"
+
 module StimulusPlumbers
   module Generators
     module CssEntrypoint
-      STIMULUS_PLUMBERS_CSS_FILE = "STIMULUS_PLUMBERS_CSS_FILE"
+      STIMULUS_PLUMBERS_CSS_ENTRY = "STIMULUS_PLUMBERS_CSS_ENTRY"
 
-      def entry_css_file(candidates:, env_var:, fallback_env_var: nil)
-        [env_var, fallback_env_var].compact.each do |var|
-          next unless ENV[var]
+      # Shared with stimulus_plumbers_tailwind's InstallGenerator — checked in order,
+      # each path is another gem/tool's own default entry file. Detection is theme-
+      # agnostic: any of these may be the CSS entry regardless of which theme is active.
+      ENTRY_CANDIDATES = [
+        "app/assets/stylesheets/application.tailwind.css", # tailwindcss-rails 2.x default
+        "app/assets/tailwind/application.css",             # tailwindcss-rails 3.x+ default
+        "app/assets/stylesheets/application.css",          # Rails/Propshaft default manifest
+        "app/javascript/entrypoints/application.css"       # jsbundling-rails (esbuild/webpack) default
+      ].freeze
 
-          path = File.expand_path(ENV.fetch(var, nil))
+      def entry_css_file(candidates:, env_var:)
+        if ENV[env_var]
+          path = File.expand_path(ENV.fetch(env_var, nil))
           return path if File.exist?(path)
         end
 
@@ -18,11 +28,9 @@ module StimulusPlumbers
           .find { |f| File.exist?(f) }
       end
 
-      def warn_entry_css_not_found(candidates:, env_var:, label:, fallback_env_var: nil)
+      def warn_entry_css_not_found(candidates:, env_var:, label:)
         tried = candidates.map { |c| File.join(destination_root, c) }
-        [env_var, fallback_env_var].compact.each do |var|
-          tried.unshift(File.expand_path(ENV[var])) if ENV[var]
-        end
+        tried.unshift(File.expand_path(ENV[env_var])) if ENV[env_var]
         say "Could not find a #{label} entry file. Tried: #{tried.join(", ")}. " \
             "Set #{env_var}=/path/to/entry.css and re-run.",
             :red
@@ -42,6 +50,26 @@ module StimulusPlumbers
         say "Could not update #{relative_to_destination(css_file)}: #{e.message}. Skipping.", :yellow
       end
 
+      # CSS copied by an installer belongs to the application from this point on.
+      # Keep an existing file intact so a generator rerun never overwrites local
+      # customizations (the same policy used by tailwindcss-rails' installer).
+      def copy_asset(source, destination)
+        path = File.join(destination_root, destination)
+
+        if File.exist?(path)
+          say_status :identical, destination
+          return true
+        end
+
+        FileUtils.mkdir_p(File.dirname(path))
+        FileUtils.cp(source, path)
+        say_status :create, destination, :green
+        true
+      rescue Errno::EROFS, Errno::EACCES => e
+        say "Could not copy #{destination}: #{e.message}. Skipping.", :yellow
+        false
+      end
+
       # `stale_pattern:` is required — every call site needs stale-import detection,
       # so making it optional would leave an untested "anchor without stale" state.
       def content_edit(content, directive, stale_pattern:, anchor_pattern: nil)

data/lib/stimulus_plumbers/generators/tokens_directive.rb

@@ -1,19 +1,23 @@
 # frozen_string_literal: true
 
+require "pathname"
+
 module StimulusPlumbers
   module Generators
     module TokensDirective
-      GEM_ROOT            = File.expand_path("../../..", __dir__)
-      TOKENS_CSS_REL_PATH = "app/assets/stylesheets/stimulus_plumbers/tokens.css"
+      TOKENS_CSS_PATH = "app/assets/stylesheets/stimulus_plumbers/tokens.css"
 
       module_function
 
-      def directive
-        %(@import "#{GEM_ROOT}/#{TOKENS_CSS_REL_PATH}";)
+      def directive(from:, destination_root:)
+        path = Pathname.new(destination_root).join(TOKENS_CSS_PATH)
+        rel  = path.relative_path_from(Pathname.new(from))
+        rel  = "./#{rel}" unless rel.to_s.start_with?(".", "/")
+        %(@import "#{rel}";)
       end
 
       def stale_pattern
-        %r{@import "[^"]*#{Regexp.escape(TOKENS_CSS_REL_PATH)}";}
+        %r{@import "[^"]*#{Regexp.escape(TOKENS_CSS_PATH)}";}
       end
     end
   end

data/lib/stimulus_plumbers/helpers/avatar_helper.rb

@@ -4,13 +4,7 @@ module StimulusPlumbers
   module Helpers
     module AvatarHelper
       def sp_avatar(...)
-        avatar_renderer.render(...)
-      end
-
-      private
-
-      def avatar_renderer
-        Components::Avatar.new(self)
+        Components::Avatar.new(self).render(...)
       end
     end
   end

data/lib/stimulus_plumbers/helpers/button_helper.rb

@@ -4,18 +4,12 @@ module StimulusPlumbers
   module Helpers
     module ButtonHelper
       def sp_button(content = nil, **kwargs, &block)
-        button_renderer.render(content, **kwargs, &block)
+        Components::Button.new(self).render(content, **kwargs, &block)
       end
 
       def sp_button_group(...)
         Components::Button::Group.new(self).render(...)
       end
-
-      private
-
-      def button_renderer
-        Components::Button.new(self)
-      end
     end
   end
 end

data/lib/stimulus_plumbers/helpers/calendar_helper.rb

@@ -9,20 +9,13 @@ module StimulusPlumbers
                          kwargs.deep_merge(
                            data: {
                              "calendar-month-year-value":  date.year,
-                             "calendar-month-month-value": date.month - 1,
-                             "calendar-month-day-value":   date.day
+                             "calendar-month-month-value": date.month - 1
                            }
                          )
                        else
                          kwargs
                        end
-        calendar_renderer.month(**html_options)
-      end
-
-      private
-
-      def calendar_renderer
-        Components::Calendar.new(self)
+        Components::Calendar.new(self).month(**html_options)
       end
     end
   end

data/lib/stimulus_plumbers/helpers/calendar_turbo_helper.rb

@@ -31,8 +31,7 @@ module StimulusPlumbers
           [
             content_tag(
               :turbo_frame,
-              id:   "calendar-month-frame",
-              data: { "combobox-date-target": "monthView" }
+              id: "calendar-month-frame"
             ) do
               calendar_turbo_renderer.month(
                 date:              date,
@@ -48,8 +47,7 @@ module StimulusPlumbers
             content_tag(
               :turbo_frame,
               id:     "calendar-year-frame",
-              hidden: true,
-              data:   { "combobox-date-target": "yearView" }
+              hidden: true
             ) do
               calendar_turbo_renderer.year(
                 date:            date,
@@ -63,8 +61,7 @@ module StimulusPlumbers
             content_tag(
               :turbo_frame,
               id:     "calendar-decade-frame",
-              hidden: true,
-              data:   { "combobox-date-target": "decadeView" }
+              hidden: true
             ) do
               calendar_turbo_renderer.decade(
                 date:           date,

data/lib/stimulus_plumbers/helpers/checklist_helper.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module StimulusPlumbers
+  module Helpers
+    module ChecklistHelper
+      def sp_checklist(...)
+        Components::Checklist.new(self).render(...)
+      end
+    end
+  end
+end

data/lib/stimulus_plumbers/helpers/indicator_helper.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module StimulusPlumbers
+  module Helpers
+    module IndicatorHelper
+      def sp_indicator(variant: :primary, type: :dot, pulse: false, **kwargs, &block)
+        Components::Indicator.new(self).render(type: type, variant: variant, pulse: pulse, **kwargs, &block)
+      end
+    end
+  end
+end

data/lib/stimulus_plumbers/helpers/ordered_list_helper.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module StimulusPlumbers
+  module Helpers
+    module OrderedListHelper
+      def sp_ordered_list(...)
+        Components::OrderedList.new(self).render(...)
+      end
+    end
+  end
+end

data/lib/stimulus_plumbers/helpers/popover_helper.rb

@@ -4,13 +4,7 @@ module StimulusPlumbers
   module Helpers
     module PopoverHelper
       def sp_popover(...)
-        popover_renderer.render(...)
-      end
-
-      private
-
-      def popover_renderer
-        Components::Popover.new(self)
+        Components::Popover.new(self).render(...)
       end
     end
   end

data/lib/stimulus_plumbers/helpers/progress_helper.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module StimulusPlumbers
+  module Helpers
+    module ProgressHelper
+      def sp_progress_bar(value:, min: 0, max: 100, indeterminate: false, **kwargs)
+        Components::ProgressBar.new(self).render(value: value, min: min, max: max, indeterminate: indeterminate, **kwargs)
+      end
+
+      def sp_progress_ring(value:, min: 0, max: 100, indeterminate: false, **kwargs)
+        Components::ProgressRing.new(self).render(value: value, min: min, max: max, indeterminate: indeterminate, **kwargs)
+      end
+
+      def sp_progress_meter(value:, min: 0, max: 100, low: nil, high: nil, optimum: nil, **kwargs)
+        Components::ProgressMeter.new(self).render(
+          value: value, min: min, max: max, low: low, high: high, optimum: optimum, **kwargs
+        )
+      end
+    end
+  end
+end