stimulus_plumbers 0.3.3 → 0.4.2

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: stimulus_plumbers
 version: !ruby/object:Gem::Version
-  version: 0.3.3
+  version: 0.4.2
 platform: ruby
 authors:
 - Ryan Chang
@@ -40,52 +40,67 @@ files:
 - CHANGELOG.md
 - README.md
 - app/assets/javascripts/stimulus-plumbers/.keep
+- app/assets/javascripts/stimulus-plumbers/controllers.manifest.json
 - app/assets/javascripts/stimulus-plumbers/stimulus-plumbers-controllers.es.js
 - app/assets/javascripts/stimulus-plumbers/stimulus-plumbers-controllers.umd.js
 - app/assets/stylesheets/stimulus_plumbers/tokens.css
+- config/locales/en.yml
 - lib/stimulus_plumbers.rb
-- lib/stimulus_plumbers/components/action_list.rb
-- lib/stimulus_plumbers/components/action_list/item.rb
-- lib/stimulus_plumbers/components/action_list/section.rb
 - lib/stimulus_plumbers/components/avatar.rb
 - lib/stimulus_plumbers/components/button.rb
 - lib/stimulus_plumbers/components/button/group.rb
+- lib/stimulus_plumbers/components/button/slots.rb
 - lib/stimulus_plumbers/components/calendar.rb
-- lib/stimulus_plumbers/components/calendar/month/turbo.rb
-- lib/stimulus_plumbers/components/calendar/month/turbo/days_of_month.rb
-- lib/stimulus_plumbers/components/calendar/month/turbo/days_of_week.rb
+- lib/stimulus_plumbers/components/calendar/turbo.rb
+- lib/stimulus_plumbers/components/calendar/turbo/days_of_month.rb
+- lib/stimulus_plumbers/components/calendar/turbo/days_of_week.rb
+- lib/stimulus_plumbers/components/calendar/turbo/months_of_year.rb
+- lib/stimulus_plumbers/components/calendar/turbo/years_of_decade.rb
 - lib/stimulus_plumbers/components/card.rb
-- lib/stimulus_plumbers/components/card/section.rb
+- lib/stimulus_plumbers/components/card/slots.rb
 - lib/stimulus_plumbers/components/combobox.rb
+- lib/stimulus_plumbers/components/combobox/builder.rb
 - lib/stimulus_plumbers/components/combobox/date.rb
+- lib/stimulus_plumbers/components/combobox/date/navigation.rb
+- lib/stimulus_plumbers/components/combobox/date/navigator.rb
 - lib/stimulus_plumbers/components/combobox/dropdown.rb
 - lib/stimulus_plumbers/components/combobox/options.rb
 - lib/stimulus_plumbers/components/combobox/options/option.rb
 - lib/stimulus_plumbers/components/combobox/options/option_group.rb
-- lib/stimulus_plumbers/components/combobox/popover.rb
 - lib/stimulus_plumbers/components/combobox/time.rb
-- lib/stimulus_plumbers/components/combobox/time/drum.rb
 - lib/stimulus_plumbers/components/combobox/trigger.rb
 - lib/stimulus_plumbers/components/combobox/typeahead.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/input_group.rb
+- lib/stimulus_plumbers/components/link.rb
+- lib/stimulus_plumbers/components/link/slots.rb
+- lib/stimulus_plumbers/components/list.rb
+- lib/stimulus_plumbers/components/list/item.rb
+- lib/stimulus_plumbers/components/list/item/slots.rb
+- lib/stimulus_plumbers/components/list/section.rb
 - lib/stimulus_plumbers/components/popover.rb
-- lib/stimulus_plumbers/components/popover/builder.rb
+- lib/stimulus_plumbers/components/popover/panel.rb
+- lib/stimulus_plumbers/components/popover/trigger.rb
+- lib/stimulus_plumbers/components/timeline.rb
+- lib/stimulus_plumbers/components/timeline/event.rb
+- lib/stimulus_plumbers/components/timeline/event/slots.rb
+- lib/stimulus_plumbers/components/timeline/group.rb
 - lib/stimulus_plumbers/configuration.rb
 - lib/stimulus_plumbers/engine.rb
+- lib/stimulus_plumbers/form/base.rb
 - lib/stimulus_plumbers/form/builder.rb
 - lib/stimulus_plumbers/form/field.rb
 - lib/stimulus_plumbers/form/fields/error.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/inputs/choice.rb
+- lib/stimulus_plumbers/form/fields/inputs/checkbox.rb
+- lib/stimulus_plumbers/form/fields/inputs/combobox.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/radio.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
@@ -95,8 +110,9 @@ files:
 - 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/label/floating.rb
+- lib/stimulus_plumbers/form/fields/renderer.rb
 - lib/stimulus_plumbers/helpers.rb
-- lib/stimulus_plumbers/helpers/action_list_helper.rb
 - lib/stimulus_plumbers/helpers/avatar_helper.rb
 - lib/stimulus_plumbers/helpers/button_helper.rb
 - lib/stimulus_plumbers/helpers/calendar_helper.rb
@@ -104,8 +120,12 @@ files:
 - 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/icon_helper.rb
+- lib/stimulus_plumbers/helpers/link_helper.rb
+- lib/stimulus_plumbers/helpers/list_helper.rb
 - lib/stimulus_plumbers/helpers/plumber_helper.rb
 - lib/stimulus_plumbers/helpers/popover_helper.rb
+- lib/stimulus_plumbers/helpers/timeline_helper.rb
 - lib/stimulus_plumbers/logger.rb
 - lib/stimulus_plumbers/plumber/base.rb
 - lib/stimulus_plumbers/plumber/dispatcher.rb
@@ -113,15 +133,27 @@ files:
 - 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/options/aria.rb
+- lib/stimulus_plumbers/plumber/options/html.rb
+- lib/stimulus_plumbers/plumber/options/stimulus.rb
+- lib/stimulus_plumbers/plumber/options/theme.rb
+- lib/stimulus_plumbers/plumber/options/token_list.rb
 - lib/stimulus_plumbers/plumber/renderer.rb
+- lib/stimulus_plumbers/plumber/slots.rb
 - lib/stimulus_plumbers/themes/base.rb
 - lib/stimulus_plumbers/themes/configuration.rb
 - lib/stimulus_plumbers/themes/icons/external.rb
 - lib/stimulus_plumbers/themes/icons/registry.rb
 - lib/stimulus_plumbers/themes/schema.rb
+- lib/stimulus_plumbers/themes/schema/avatar/ranges.rb
+- lib/stimulus_plumbers/themes/schema/button/ranges.rb
+- lib/stimulus_plumbers/themes/schema/card/ranges.rb
+- lib/stimulus_plumbers/themes/schema/form/checkbox/ranges.rb
+- lib/stimulus_plumbers/themes/schema/form/floating/ranges.rb
+- lib/stimulus_plumbers/themes/schema/form/radio/ranges.rb
 - lib/stimulus_plumbers/themes/schema/form/ranges.rb
 - lib/stimulus_plumbers/themes/schema/icon.rb
+- lib/stimulus_plumbers/themes/schema/link/ranges.rb
 - lib/stimulus_plumbers/themes/schema/ranges.rb
 - lib/stimulus_plumbers/version.rb
 homepage: https://github.com/ryancyq/stimulus-plumbers

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

@@ -1,30 +0,0 @@
-# frozen_string_literal: true
-
-module StimulusPlumbers
-  module Components
-    class ActionList
-      class Item < Plumber::Base
-        def render(content = nil, **kwargs, &block)
-          render_item(content, **kwargs, &block)
-        end
-
-        private
-
-        def render_item(content, url: nil, external: false, active: false, **kwargs, &block)
-          html_options = merge_html_options(
-            { classes: theme.resolve(:action_list_item, active: active).fetch(:classes, "") },
-            kwargs
-          )
-
-          template.content_tag(:li) do
-            render_button(content, url: url, external: external, variant: :outline, **html_options, &block)
-          end
-        end
-
-        def render_button(content, url: nil, external: false, **kwargs, &block)
-          Components::Button.new(template).render(content, url: url, external: external, **kwargs, &block)
-        end
-      end
-    end
-  end
-end

data/lib/stimulus_plumbers/components/action_list/section.rb

@@ -1,28 +0,0 @@
-# frozen_string_literal: true
-
-module StimulusPlumbers
-  module Components
-    class ActionList
-      class Section < Plumber::Base
-        def render(...)
-          render_section(...)
-        end
-
-        private
-
-        def render_section(title: nil, **kwargs, &block)
-          template.content_tag(:li, **kwargs) do
-            ul_opts = {}
-            ul_opts[:aria] = { label: title } if title.present?
-            template.safe_join(
-              [
-                (template.content_tag(:span, title, aria: { hidden: "true" }) if title.present?),
-                template.content_tag(:ul, template.capture(&block), **ul_opts)
-              ]
-            )
-          end
-        end
-      end
-    end
-  end
-end

data/lib/stimulus_plumbers/components/action_list.rb

@@ -1,29 +0,0 @@
-# frozen_string_literal: true
-
-module StimulusPlumbers
-  module Components
-    class ActionList < Plumber::Base
-      def render(...)
-        render_list(...)
-      end
-
-      def section(...)
-        ActionList::Section.new(template).render(...)
-      end
-
-      def item(content = nil, **kwargs, &block)
-        ActionList::Item.new(template).render(content, **kwargs, &block)
-      end
-
-      private
-
-      def render_list(role: "list", **kwargs, &block)
-        html_options = merge_html_options(
-          { role: role, classes: theme.resolve(:action_list).fetch(:classes, "") },
-          kwargs
-        )
-        template.content_tag(:ul, template.capture(&block), **html_options)
-      end
-    end
-  end
-end

data/lib/stimulus_plumbers/components/calendar/month/turbo/days_of_month.rb

@@ -1,149 +0,0 @@
-# frozen_string_literal: true
-
-module StimulusPlumbers
-  module Components
-    class Calendar
-      module Month
-        class Turbo
-          class DaysOfMonth < Plumber::Base
-            DAYS_IN_WEEK = 7
-
-            attr_reader :date, :today, :selectable, :selected_date, :show_other_months
-
-            def initialize(
-              template,
-              date: Date.today,
-              today: Date.today,
-              selectable: false,
-              selected_date: nil,
-              show_other_months: false
-            )
-              super(template)
-              @date              = date
-              @today             = today
-              @selectable        = selectable
-              @selected_date     = selected_date
-              @show_other_months = show_other_months
-            end
-
-            def render(...)
-              render_days_of_month(...)
-            end
-
-            private
-
-            def render_days_of_month(**html_options)
-              html_options = merge_html_options(
-                { classes: theme.resolve(:calendar_days_of_month).fetch(:classes, "") },
-                html_options
-              )
-              template.content_tag(:div, **html_options, role: "rowgroup") { weeks_of_month }
-            end
-
-            def weeks_of_month
-              week_options = merge_html_options(
-                { classes: theme.resolve(:calendar_week).fetch(:classes, "") },
-                { role: "row" }
-              )
-              template.safe_join(
-                build_days.each_slice(DAYS_IN_WEEK).map do |days|
-                  template.content_tag(:div, **week_options) { days_in_week(days) }
-                end
-              )
-            end
-
-            def focus_day
-              @focus_day ||= if selected_date_in_current_month?
-                               selected_date
-                             elsif today_in_current_month?
-                               today
-                             else
-                               date.beginning_of_month
-                             end
-            end
-
-            def build_days
-              first        = date.beginning_of_month
-              last         = date.end_of_month
-              current_days = first.upto(last).to_a
-              prev_filler_days(first) + current_days + next_filler_days(last, current_days.length)
-            end
-
-            def prev_filler_days(first_day_of_month)
-              week_start = first_day_of_month - first_day_of_month.wday
-              week_start.upto(first_day_of_month - 1).to_a
-            end
-
-            def next_filler_days(last_day_of_month, days_in_month)
-              week_start_offset = last_day_of_month.beginning_of_month.wday
-              total             = week_start_offset + days_in_month
-              next_count = (DAYS_IN_WEEK - (total % DAYS_IN_WEEK)) % DAYS_IN_WEEK
-              next_count.positive? ? (last_day_of_month + 1).upto(last_day_of_month + next_count).to_a : []
-            end
-
-            def selected_date_in_current_month?
-              selected_date&.month == date.month && selected_date&.year == date.year
-            end
-
-            def today_in_current_month?
-              today.month == date.month && today.year == date.year
-            end
-
-            def days_in_week(days)
-              template.safe_join(
-                days.map do |day|
-                  if day.month == date.month
-                    current_month_day_cell(day)
-                  elsif show_other_months
-                    other_month_day_cell(day)
-                  else
-                    hidden_day_cell(day)
-                  end
-                end
-              )
-            end
-
-            def hidden_day_cell(date)
-              template.content_tag(:span, role: "gridcell", tabindex: -1, aria: { hidden: "true" }) do
-                template.content_tag(:time, nil, datetime: date.iso8601)
-              end
-            end
-
-            def current_month_day_cell(date)
-              tag = selectable ? :button : :span
-              template.content_tag(tag, **day_cell_html_options(date, today)) do
-                template.content_tag(:time, date.day.to_s, datetime: date.iso8601)
-              end
-            end
-
-            def day_cell_html_options(date, today)
-              is_today = date == today
-              selected = selected_date && date == selected_date
-              merge_html_options(
-                { classes: theme.resolve(:calendar_day).fetch(:classes, "") },
-                {
-                  role:     "gridcell",
-                  tabindex: date == focus_day ? 0 : -1,
-                  aria:     {
-                    current:  is_today ? "date" : nil,
-                    selected: if selectable then selected ? "true" : "false" end
-                  }
-                }
-              )
-            end
-
-            def other_month_day_cell(date)
-              options = merge_html_options(
-                { classes: theme.resolve(:calendar_day, outside: true).fetch(:classes, "") },
-                { role: "gridcell", tabindex: -1, aria: { disabled: "true", selected: "false" } }
-              )
-              template.content_tag(:span, **options) do
-                template.content_tag(:time, date.day.to_s, datetime: date.iso8601)
-              end
-            end
-          end
-        end
-      end
-    end
-  end
-end

data/lib/stimulus_plumbers/components/calendar/month/turbo/days_of_week.rb

@@ -1,43 +0,0 @@
-# frozen_string_literal: true
-
-module StimulusPlumbers
-  module Components
-    class Calendar
-      module Month
-        class Turbo
-          class DaysOfWeek < Plumber::Base
-            def render(...)
-              render_days_of_week(...)
-            end
-
-            private
-
-            def render_days_of_week(**kwargs)
-              html_options = merge_html_options(
-                { classes: theme.resolve(:calendar_days_of_week).fetch(:classes, "") },
-                kwargs
-              )
-              template.content_tag(:div, **html_options) { days_of_week }
-            end
-
-            def days_of_week
-              week_options = merge_html_options(
-                { classes: theme.resolve(:calendar_week).fetch(:classes, "") },
-                { role: "row" }
-              )
-              template.content_tag(:div, **week_options) do
-                template.safe_join(
-                  day_names.map { |abbr, full| template.content_tag(:span, abbr, role: "columnheader", abbr: full) }
-                )
-              end
-            end
-
-            def day_names
-              I18n.t("date.abbr_day_names").zip(I18n.t("date.day_names"))
-            end
-          end
-        end
-      end
-    end
-  end
-end

data/lib/stimulus_plumbers/components/calendar/month/turbo.rb

@@ -1,59 +0,0 @@
-# frozen_string_literal: true
-
-module StimulusPlumbers
-  module Components
-    class Calendar
-      module Month
-        class Turbo < Plumber::Base
-          STIMULUS_CONTROLLER = "calendar-month-observer"
-
-          def render(...)
-            render_turbo(...)
-          end
-
-          private
-
-          def render_turbo(
-            date: Date.today,
-            today: Date.today,
-            selectable: false,
-            selected_date: nil,
-            show_other_months: false,
-            **kwargs
-          )
-            html_options = merge_html_options(
-              {
-                classes: theme.resolve(:calendar).fetch(:classes, ""),
-                data:    { controller: STIMULUS_CONTROLLER, action: "click->#{STIMULUS_CONTROLLER}#select" }
-              },
-              kwargs
-            )
-
-            template.content_tag(:div, role: "grid", **html_options) do
-              template.safe_join(
-                [
-                  days_of_week,
-                  days_of_month(
-                    date:              date,
-                    today:             today,
-                    selectable:        selectable,
-                    selected_date:     selected_date,
-                    show_other_months: show_other_months
-                  )
-                ]
-              )
-            end
-          end
-
-          def days_of_week(**kwargs)
-            Turbo::DaysOfWeek.new(template).render(**kwargs)
-          end
-
-          def days_of_month(**kwargs)
-            Turbo::DaysOfMonth.new(template, **kwargs).render
-          end
-        end
-      end
-    end
-  end
-end

data/lib/stimulus_plumbers/components/card/section.rb

@@ -1,31 +0,0 @@
-# frozen_string_literal: true
-
-module StimulusPlumbers
-  module Components
-    class Card
-      class Section < Plumber::Base
-        def render(...)
-          render_section(...)
-        end
-
-        private
-
-        def render_section(title: nil, title_tag: :h3, **kwargs, &block)
-          html_options = merge_html_options(
-            { classes: theme.resolve(:card_section).fetch(:classes, "") },
-            kwargs
-          )
-
-          template.content_tag(:div, **html_options) do
-            template.safe_join(
-              [
-                (template.content_tag(title_tag, title) if title.present?),
-                template.capture(&block)
-              ]
-            )
-          end
-        end
-      end
-    end
-  end
-end

data/lib/stimulus_plumbers/components/combobox/popover.rb

@@ -1,47 +0,0 @@
-# frozen_string_literal: true
-
-module StimulusPlumbers
-  module Components
-    class Combobox
-      class Popover < Plumber::Base
-        def render(...)
-          render_popover(...)
-        end
-
-        private
-
-        def render_popover(
-          stimulus_controller:,
-          id:,
-          tag: :div,
-          role: nil,
-          label: nil,
-          labelledby: nil,
-          content: nil,
-          data: {},
-          **kwargs,
-          &block
-        )
-          opts = {}
-          opts[:role] = role if role
-          if labelledby
-            opts[:aria] = { labelledby: labelledby }
-          elsif label
-            opts[:aria] = { label: label }
-          end
-
-          html_options = merge_html_options(
-            { id: id, hidden: "" },
-            { data: { "#{stimulus_controller}_target": "popover" } },
-            { data: data },
-            opts,
-            kwargs
-          )
-
-          html_content = block_given? ? template.capture(id, &block) : content
-          template.content_tag(tag, html_content, **html_options)
-        end
-      end
-    end
-  end
-end

data/lib/stimulus_plumbers/components/combobox/time/drum.rb

@@ -1,43 +0,0 @@
-# frozen_string_literal: true
-
-module StimulusPlumbers
-  module Components
-    class Combobox
-      class Time
-        class Drum < Plumber::Base
-          def render(...)
-            render_drum(...)
-          end
-
-          private
-
-          def render_drum(stimulus_controller:, target:, label:, items:, selected: nil)
-            template.content_tag(
-              :ul,
-              **merge_html_options(
-                { classes: theme.resolve(:combobox_listbox).fetch(:classes, "") },
-                {
-                  role:     "listbox",
-                  tabindex: "0",
-                  aria:     { label: label },
-                  data:     { "#{stimulus_controller}_target": target }
-                },
-                { data: { action: "click->#{stimulus_controller}#select keydown->#{stimulus_controller}#onNavigate" } }
-              )
-            ) do
-              template.safe_join(
-                items.map do |text, value|
-                  Options::Option.new(template).render(
-                    label:    text,
-                    value:    value,
-                    selected: value.to_s == selected.to_s
-                  )
-                end
-              )
-            end
-          end
-        end
-      end
-    end
-  end
-end

data/lib/stimulus_plumbers/components/date_picker/navigation.rb

@@ -1,41 +0,0 @@
-# frozen_string_literal: true
-
-module StimulusPlumbers
-  module Components
-    module DatePicker
-      class Navigation < Plumber::Base
-        def render(step:, stimulus_controller:, **kwargs)
-          html_options = merge_html_options(
-            { classes: theme.resolve(:calendar_navigation).fetch(:classes, ""), aria: { label: "DatePicker Navigation" } },
-            kwargs
-          )
-
-          template.content_tag(:nav, **html_options) do
-            template.safe_join(navigators(stimulus_controller, step))
-          end
-        end
-
-        private
-
-        def navigators(stimulus_controller, step)
-          [
-            navigator(stimulus_controller, target: "previous", icon: "arrow-left", label: ["previous", step].join(" ").titleize),
-            navigator(stimulus_controller, target: "day",      label: "Day"),
-            navigator(stimulus_controller, target: "month",    label: "Month"),
-            navigator(stimulus_controller, target: "year",     label: "Year"),
-            navigator(stimulus_controller, target: "next",     icon: "arrow-right", label: ["next", step].join(" ").titleize)
-          ]
-        end
-
-        def navigator(stimulus_controller, target:, label:, icon: nil)
-          opts = {
-            aria: { label: label },
-            data: { "#{stimulus_controller}-target" => target }
-          }
-          opts[:icon] = icon if icon
-          Navigator.new(template).render(**opts)
-        end
-      end
-    end
-  end
-end

data/lib/stimulus_plumbers/components/date_picker/navigator.rb

@@ -1,23 +0,0 @@
-# frozen_string_literal: true
-
-module StimulusPlumbers
-  module Components
-    module DatePicker
-      class Navigator < Plumber::Base
-        def render(...)
-          render_navigator(...)
-        end
-
-        private
-
-        def render_navigator(icon: nil, **kwargs)
-          html_options = merge_html_options(
-            { classes: theme.resolve(:calendar_navigation_navigator).fetch(:classes, "") },
-            kwargs
-          )
-          Components::Button.new(template).render(variant: :ghost, size: nil, icon_leading: icon, **html_options)
-        end
-      end
-    end
-  end
-end