stimulus_plumbers 0.4.5 → 0.4.9

data/lib/stimulus_plumbers/components/link.rb

@@ -6,7 +6,7 @@ module StimulusPlumbers
       def render(content = nil, url:, icon_leading: nil, icon_trailing: nil, **kwargs, &block)
         icon_trailing ||= "external-link" if kwargs[:target] == "_blank"
 
-        slots = Link::Slots.new
+        slots = Link::Slots.new(template)
         slots.with_icon_leading(icon_leading) if icon_leading
         slots.with_icon_trailing(icon_trailing) if icon_trailing
 
@@ -45,6 +45,7 @@ module StimulusPlumbers
 
           Components::Icon.new(template).render(
             name:    value,
+            size:    :sm,
             classes: theme.resolve(:link_icon).fetch(:classes, ""),
             aria:    { hidden: "true" }
           )

data/lib/stimulus_plumbers/components/list/item.rb

@@ -5,7 +5,7 @@ module StimulusPlumbers
     class List
       class Item < Plumber::Base
         def render(content = nil, **kwargs, &block)
-          slots = List::Item::Slots.new
+          slots = List::Item::Slots.new(template)
           slots.with_title(content) if content
           slots.with_icon_trailing("external-link") if kwargs[:url].present? && kwargs[:target] == "_blank"
           yield slots if block_given?

data/lib/stimulus_plumbers/components/ordered_list/item/slots.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module StimulusPlumbers
+  module Components
+    class OrderedList
+      class Item
+        class Slots < Plumber::Slots
+          slot :icon_leading, :title, :description, :icon_trailing
+        end
+      end
+    end
+  end
+end

data/lib/stimulus_plumbers/components/ordered_list/item.rb

@@ -0,0 +1,129 @@
+# frozen_string_literal: true
+
+module StimulusPlumbers
+  module Components
+    class OrderedList
+      class Item < Plumber::Base
+        HANDLE_ACTION = "pointerdown->reorderable#onPointerDown pointermove->reorderable#onPointerMove " \
+                        "pointerup->reorderable#onPointerUp"
+
+        def render(content = nil, id:, handle: :item, url: nil, target: nil, active: false, **html_options, &block)
+          validate_options!(id, url, html_options)
+
+          slots = build_slots(content, &block)
+
+          build(id: id, handle: handle) do |attrs|
+            template.content_tag(:li, **attrs) do
+              template.safe_join(
+                [
+                  render_icon_position(slots, :leading),
+                  render_body(slots, url: url, target: target, active: active, **html_options),
+                  render_icon_position(slots, :trailing)
+                ]
+              )
+            end
+          end
+        end
+
+        def build(id:, handle: :item, &block)
+          @handle = handle
+          html_options = merge_html_options(theme.resolve(:ordered_list_item), { id: id }, item_target_attrs)
+          template.capture(html_options, &block)
+        end
+
+        private
+
+        def validate_options!(id, url, html_options)
+          raise ArgumentError, "id: is required so the item appears in reorderable:reordered's itemIds" if id.blank?
+          return unless url.blank? && html_options.present?
+
+          raise ArgumentError, "html_options are only applied to the <a> rendered when url: is set"
+        end
+
+        def build_slots(content, &block)
+          slots = OrderedList::Item::Slots.new(template)
+          slots.with_title(content) if content
+          yield slots if block_given?
+          slots
+        end
+
+        def item_target_attrs
+          if @handle == :item
+            { data: { "reorderable-target": "item handle", action: HANDLE_ACTION } }
+          else
+            { data: { "reorderable-target": "item" } }
+          end
+        end
+
+        def render_body(slots, url:, target:, active:, **html_options)
+          content = render_content_slot(slots)
+          return content unless url.present?
+
+          aria  = active ? { aria: { current: "page" } } : {}
+          attrs = merge_html_options(html_options, { data: { "reorderable-target": "trigger" } }, aria)
+          template.content_tag(:a, content, href: url, target: target, **attrs)
+        end
+
+        def render_icon_position(slots, position)
+          slot_name   = position == :leading ? :icon_leading : :icon_trailing
+          is_handle   = @handle == position
+          custom_icon = render_icon_slot(slots, slot_name)
+          return unless custom_icon || is_handle
+
+          html_options = merge_html_options(theme.resolve(:ordered_list_item_handle), handle_target_attrs(is_handle))
+          template.content_tag(:span, custom_icon || default_handle_icon, **html_options)
+        end
+
+        def handle_target_attrs(is_handle)
+          return {} unless is_handle
+
+          { data: { "reorderable-target": "handle", action: HANDLE_ACTION } }
+        end
+
+        def render_icon_slot(slots, name)
+          slots.resolve(name) do |value|
+            next value unless Components::Icon.icon_name?(value)
+
+            Components::Icon.new(template).render(
+              name:    value,
+              size:    :sm,
+              classes: theme.resolve(:ordered_list_item_handle).fetch(:classes, ""),
+              aria:    { hidden: "true" }
+            )
+          end
+        end
+
+        def default_handle_icon
+          Components::Icon.new(template).render(
+            name:    "grip-vertical",
+            size:    :sm,
+            classes: theme.resolve(:ordered_list_item_handle).fetch(:classes, ""),
+            aria:    { hidden: "true" }
+          )
+        end
+
+        def render_content_slot(slots)
+          title       = render_title_slot(slots)
+          description = render_description_slot(slots)
+          return unless title || description
+
+          template.content_tag(:span, **merge_html_options(theme.resolve(:ordered_list_item_content))) do
+            template.safe_join([title, description])
+          end
+        end
+
+        def render_title_slot(slots)
+          slots.resolve(:title) do |v|
+            template.content_tag(:span, v, **merge_html_options(theme.resolve(:ordered_list_item_title)))
+          end
+        end
+
+        def render_description_slot(slots)
+          slots.resolve(:description) do |v|
+            template.content_tag(:span, v, **merge_html_options(theme.resolve(:ordered_list_item_description)))
+          end
+        end
+      end
+    end
+  end
+end

data/lib/stimulus_plumbers/components/ordered_list.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module StimulusPlumbers
+  module Components
+    class OrderedList < Plumber::Base
+      def render(move_key: "Alt", editing: false, orientation: nil, role: "list", **kwargs, &block)
+        stimulus = {
+          data: {
+            controller:                      "reorderable",
+            "reorderable-move-key-value":    move_key,
+            "reorderable-editing-value":     editing,
+            "reorderable-orientation-value": orientation
+          }.compact
+        }
+        html_options = merge_html_options(theme.resolve(:ordered_list), kwargs, stimulus)
+        template.content_tag(:ol, template.capture(self, &block), **html_options, role: role)
+      end
+
+      def item(content = nil, **kwargs, &block)
+        OrderedList::Item.new(template).render(content, **kwargs, &block)
+      end
+    end
+  end
+end

data/lib/stimulus_plumbers/components/progress_bar.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+module StimulusPlumbers
+  module Components
+    class ProgressBar < Plumber::Base
+      def render(...) = render_bar(...)
+
+      private
+
+      def render_bar(value:, min: 0, max: 100, indeterminate: false, **kwargs)
+        html_options = merge_html_options(
+          theme.resolve(:progress_bar),
+          kwargs,
+          stimulus_data(value: value, min: min, max: max, indeterminate: indeterminate),
+          { role: "progressbar", aria: progress_aria(value: value, min: min, max: max, indeterminate: indeterminate) }
+        )
+        template.content_tag(:div, render_fill, **html_options)
+      end
+
+      def render_fill
+        template.content_tag(
+          :div,
+          nil,
+          **merge_html_options(theme.resolve(:progress_bar_fill), { data: { "progress-target": "fill" } })
+        )
+      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":       "bar",
+            "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/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

@@ -13,7 +13,7 @@ module StimulusPlumbers
         def render(datetime: nil, id: nil, interactive: false, orientation: :vertical, **kwargs, &block)
           @detail_id = self.class.detail_id_for(id || template.sp_dom_id)
 
-          slots = Timeline::Event::Slots.new
+          slots = Timeline::Event::Slots.new(template)
           yield slots if block_given?
 
           validate_slots!(slots, datetime: datetime)
@@ -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

@@ -18,5 +18,9 @@ module StimulusPlumbers
         include StimulusPlumbers::Helpers
       end
     end
+
+    rake_tasks do
+      load File.join(__dir__, "../tasks/stimulus_plumbers.rake")
+    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/generators/css_entrypoint.rb

@@ -0,0 +1,80 @@
+# frozen_string_literal: true
+
+module StimulusPlumbers
+  module Generators
+    module CssEntrypoint
+      STIMULUS_PLUMBERS_CSS_ENTRY = "STIMULUS_PLUMBERS_CSS_ENTRY"
+
+      # 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
+
+      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
+
+        candidates
+          .map { |c| File.join(destination_root, c) }
+          .find { |f| File.exist?(f) }
+      end
+
+      def warn_entry_css_not_found(candidates:, env_var:, label:)
+        tried = candidates.map { |c| File.join(destination_root, c) }
+        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
+      end
+
+      def apply_edit(css_file, directive, stale_pattern:, anchor_pattern: nil)
+        content              = File.read(css_file)
+        new_content, status  = content_edit(content, directive, stale_pattern: stale_pattern, anchor_pattern: anchor_pattern)
+
+        if new_content
+          File.write(css_file, new_content)
+          say_status status, relative_to_destination(css_file), :green
+        else
+          say_status :identical, relative_to_destination(css_file)
+        end
+      rescue Errno::EROFS, Errno::EACCES => e
+        say "Could not update #{relative_to_destination(css_file)}: #{e.message}. Skipping.", :yellow
+      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)
+        return nil if content.include?(directive)
+
+        if (existing = content.match(stale_pattern))
+          return [content.sub(existing[0], directive), :update]
+        end
+
+        anchor_pattern ? insert_near_anchor(content, directive, anchor_pattern) : prepend(content, directive)
+      end
+
+      def prepend(content, directive)
+        ["#{directive}\n#{content}", :prepend]
+      end
+
+      def insert_near_anchor(content, directive, anchor_pattern)
+        if (anchor = content.match(anchor_pattern))
+          [content.sub(anchor[0], "#{anchor[0]}\n#{directive}"), :insert]
+        else
+          ["#{content.rstrip}\n#{directive}\n", :append]
+        end
+      end
+
+      def relative_to_destination(path)
+        path.delete_prefix("#{destination_root}/")
+      end
+    end
+  end
+end

data/lib/stimulus_plumbers/generators/tokens_directive.rb

@@ -0,0 +1,24 @@
+# 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"
+
+      module_function
+
+      def directive(from:)
+        path = Pathname.new(GEM_ROOT).join(TOKENS_CSS_REL_PATH)
+        rel  = path.relative_path_from(Pathname.new(from))
+        %(@import "#{rel}";)
+      end
+
+      def stale_pattern
+        %r{@import "[^"]*#{Regexp.escape(TOKENS_CSS_REL_PATH)}";}
+      end
+    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