stimulus_plumbers 0.3.3 → 0.4.2

data/lib/stimulus_plumbers/themes/base.rb

@@ -7,7 +7,7 @@ module StimulusPlumbers
   module Themes
     class Base
       SCHEMA = {
-        **Schema::ACTION_LIST,
+        **Schema::LIST,
         **Schema::AVATAR,
         **Schema::BUTTON,
         **Schema::CALENDAR,
@@ -16,18 +16,20 @@ module StimulusPlumbers
         **Schema::FORM,
         **Schema::ICON,
         **Schema::INPUT_GROUP,
-        **Schema::LAYOUT
+        **Schema::LAYOUT,
+        **Schema::LINK,
+        **Schema::TIMELINE
       }.freeze
 
       def name
         @name ||= self.class.name.demodulize.delete_suffix("Theme")
       end
 
-      def avatar_colors
+      def avatar_variants
         {}
       end
 
-      def avatar_color_range
+      def avatar_variant_range
         []
       end
 
@@ -39,9 +41,6 @@ module StimulusPlumbers
         SCHEMA.fetch(component, {}).keys
       end
 
-      # Resolves presentational classes for a component slot.
-      # Returns a Hash with :classes (String) and optionally :style (String).
-      # Returns {} when no mapping exists for the given component.
       def resolve(component, **args)
         method_name = :"#{component}_classes"
         unless respond_to?(method_name, true)

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

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module StimulusPlumbers
+  module Themes
+    module Schema
+      module Avatar
+        module Ranges
+          SIZE = %i[xs sm md lg xl].freeze
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module StimulusPlumbers
+  module Themes
+    module Schema
+      module Button
+        module Ranges
+          TYPE    = %i[default outline ghost fab fab_outline dashed card].freeze
+          SIZE    = %i[xs sm md lg xl].freeze
+          LAYOUT  = %i[stacked inline].freeze
+          VARIANT = %i[primary secondary tertiary success destructive warning info].freeze
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module StimulusPlumbers
+  module Themes
+    module Schema
+      module Card
+        module Ranges
+          VARIANT = %i[primary secondary tertiary success destructive warning info].freeze
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module StimulusPlumbers
+  module Themes
+    module Schema
+      module Form
+        module Checkbox
+          module Ranges
+            TYPE    = %i[default button card].freeze
+            VARIANT = %i[primary secondary tertiary success destructive warning info].freeze
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module StimulusPlumbers
+  module Themes
+    module Schema
+      module Form
+        module Floating
+          module Ranges
+            TYPE = %i[standard filled outlined].freeze
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module StimulusPlumbers
+  module Themes
+    module Schema
+      module Form
+        module Radio
+          module Ranges
+            TYPE    = %i[default button card].freeze
+            VARIANT = %i[primary secondary tertiary success destructive warning info].freeze
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -5,8 +5,7 @@ module StimulusPlumbers
     module Schema
       module Form
         module Ranges
-          LAYOUT         = %i[stacked inline].freeze
-          SUBMIT_VARIANT = %i[default button].freeze
+          LAYOUT = %i[stacked inline].freeze
         end
       end
     end

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

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module StimulusPlumbers
+  module Themes
+    module Schema
+      module Link
+        module Ranges
+          TYPE    = %i[default button card].freeze
+          VARIANT = %i[default success destructive warning info].freeze
+        end
+      end
+    end
+  end
+end

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

@@ -4,11 +4,7 @@ module StimulusPlumbers
   module Themes
     module Schema
       module Ranges
-        BOOL           = [true, false].freeze
-        SIZE           = %i[xs sm md lg xl].freeze
-        FLEX_ALIGN     = %i[left center right top bottom].freeze
-        FLEX_DIRECTION = %i[row col].freeze
-        BUTTON_VARIANT = %i[primary secondary outline destructive ghost link fab dashed].freeze
+        BOOL = [true, false].freeze
       end
     end
   end

data/lib/stimulus_plumbers/themes/schema.rb

@@ -1,96 +1,170 @@
 # frozen_string_literal: true
 
+require_relative "../form/field"
 require_relative "schema/ranges"
+require_relative "schema/avatar/ranges"
+require_relative "schema/button/ranges"
+require_relative "schema/card/ranges"
+require_relative "schema/link/ranges"
 require_relative "schema/form/ranges"
+require_relative "schema/form/checkbox/ranges"
+require_relative "schema/form/floating/ranges"
+require_relative "schema/form/radio/ranges"
 require_relative "schema/icon"
 
 module StimulusPlumbers
   module Themes
     module Schema
-      ACTION_LIST = {
-        action_list_item: {
-          active: { default: false, validate: Ranges::BOOL }
-        }.freeze,
-        action_list:      {}.freeze
+      LIST = {
+        list:                     {}.freeze,
+        list_section:             {}.freeze,
+        list_section_title:       {}.freeze,
+        list_section_description: {}.freeze,
+        list_item:                {}.freeze,
+        list_item_icon:           {}.freeze,
+        list_item_content:        {}.freeze,
+        list_item_title:          {}.freeze,
+        list_item_description:    {}.freeze
       }.freeze
 
       AVATAR = {
-        avatar: {
-          size:  { default: :md, validate: Ranges::SIZE },
-          color: { default: nil, validate: :avatar_color_range }
-        }.freeze
+        avatar:       {
+          size:    { default: :md, validate: Avatar::Ranges::SIZE },
+          variant: { default: nil, validate: :avatar_variant_range }
+        }.freeze,
+        avatar_image: {}.freeze
       }.freeze
 
       BUTTON = {
         button:       {
-          variant: { default: :primary, validate: Ranges::BUTTON_VARIANT },
-          size:    { default: :md,      validate: Ranges::SIZE }
+          type:    { default: :default, validate: Button::Ranges::TYPE },
+          variant: { default: :primary, validate: Button::Ranges::VARIANT },
+          size:    { default: :md,      validate: Button::Ranges::SIZE }
         }.freeze,
         button_group: {
-          alignment: { default: :left, validate: Ranges::FLEX_ALIGN },
-          direction: { default: :row,  validate: Ranges::FLEX_DIRECTION }
+          layout: { default: :inline, validate: Button::Ranges::LAYOUT }
         }.freeze,
         button_icon:  {}.freeze
       }.freeze
 
       CALENDAR = {
-        calendar:                      {}.freeze,
-        calendar_days_of_week:         {}.freeze,
-        calendar_week:                 {}.freeze,
-        calendar_days_of_month:        {}.freeze,
-        calendar_day:                  {
+        calendar:                 {}.freeze,
+        calendar_days_of_week:    {}.freeze,
+        calendar_days_of_month:   {}.freeze,
+        calendar_months_of_year:  {}.freeze,
+        calendar_years_of_decade: {}.freeze,
+        calendar_row:             {}.freeze,
+        calendar_day:             {
           today:    { default: false, validate: Ranges::BOOL },
           selected: { default: false, validate: Ranges::BOOL },
           outside:  { default: false, validate: Ranges::BOOL }
         }.freeze,
-        calendar_navigation:           {}.freeze,
-        calendar_navigation_navigator: {}.freeze
+        calendar_month:           {
+          outside: { default: false, validate: Ranges::BOOL }
+        }.freeze,
+        calendar_year:            {
+          outside: { default: false, validate: Ranges::BOOL }
+        }.freeze,
+        calendar_quarter_grid:    {}.freeze
       }.freeze
 
       CARD = {
-        card:         {}.freeze,
-        card_section: {}.freeze
+        card:        { variant: { default: :tertiary, validate: Card::Ranges::VARIANT } }.freeze,
+        card_header: {}.freeze,
+        card_icon:   {}.freeze,
+        card_title:  {}.freeze,
+        card_body:   {}.freeze,
+        card_action: {}.freeze
       }.freeze
 
       COMBOBOX = {
-        combobox_trigger:           {}.freeze,
-        combobox_trigger_group:     {}.freeze,
-        combobox_option:            {
+        combobox:                           {}.freeze,
+        combobox_popover:                   {}.freeze,
+        combobox_trigger:                   {}.freeze,
+        combobox_trigger_icon:              {}.freeze,
+        combobox_trigger_group:             {}.freeze,
+        combobox_option:                    {
           selected: { default: false, validate: Ranges::BOOL },
           disabled: { default: false, validate: Ranges::BOOL }
         }.freeze,
-        combobox_option_group:      {}.freeze,
-        combobox_listbox:           {}.freeze,
-        combobox_typeahead_loading: {}.freeze,
-        combobox_typeahead_empty:   {}.freeze,
-        combobox_time:              {}.freeze
+        combobox_option_group:              {}.freeze,
+        combobox_listbox:                   {}.freeze,
+        combobox_typeahead_loading:         {}.freeze,
+        combobox_typeahead_loading_icon:    {}.freeze,
+        combobox_typeahead_empty:           {}.freeze,
+        combobox_time:                      {}.freeze,
+        combobox_time_drum:                 { type: { default: :unit, validate: %i[unit period] } }.freeze,
+        combobox_date_navigation:           {}.freeze,
+        combobox_date_navigation_navigator: {}.freeze,
+        combobox_date_navigation_title:     {}.freeze
       }.freeze
 
       FORM = {
-        form_group:           {
+        form_group:                     {
           layout: { default: :stacked, validate: Form::Ranges::LAYOUT },
           error:  { default: false,    validate: Ranges::BOOL }
         }.freeze,
-        form_label:           {
+        form_field_label:               {
           required: { default: false, validate: Ranges::BOOL },
-          hidden:   { default: false, validate: Ranges::BOOL }
-        }.freeze,
-        form_required_mark:   {}.freeze,
-        form_details:         {}.freeze,
-        form_error:           {}.freeze,
-        form_input:           { error: { default: false, validate: Ranges::BOOL } }.freeze,
-        form_textarea:        { error: { default: false, validate: Ranges::BOOL } }.freeze,
-        form_file:            { error: { default: false, validate: Ranges::BOOL } }.freeze,
-        form_select:          { error: { default: false, validate: Ranges::BOOL } }.freeze,
-        form_checkbox:        { error: { default: false, validate: Ranges::BOOL } }.freeze,
-        form_radio:           { error: { default: false, validate: Ranges::BOOL } }.freeze,
-        form_combobox:        { error: { default: false, validate: Ranges::BOOL } }.freeze,
-        form_input_reveal:    { error: { default: false, validate: Ranges::BOOL } }.freeze,
-        form_input_clearable: {}.freeze,
-        form_button_reveal:   {}.freeze,
-        form_button_clear:    {}.freeze,
-        form_submit:          {
-          variant: { default: :default, validate: Form::Ranges::SUBMIT_VARIANT }
+          hidden:   { default: false, validate: Ranges::BOOL },
+          floating: { default: nil,   validate: [nil, *Form::Floating::Ranges::TYPE] },
+          error:    { default: false, validate: Ranges::BOOL }
+        }.freeze,
+        form_field_required_mark:       {}.freeze,
+        form_field_hint:                {}.freeze,
+        form_field_error:               {}.freeze,
+        form_field_choice_items:        {
+          layout: { default: :stacked, validate: Form::Ranges::LAYOUT }
+        }.freeze,
+        form_field_checkbox_label:      {
+          type:    { default: :default,  validate: Form::Checkbox::Ranges::TYPE },
+          variant: { default: :tertiary, validate: Form::Checkbox::Ranges::VARIANT }
+        }.freeze,
+        form_field_radio_label:         {
+          type:    { default: :default,  validate: Form::Radio::Ranges::TYPE },
+          variant: { default: :tertiary, validate: Form::Radio::Ranges::VARIANT }
+        }.freeze,
+        form_field_radio_item_group:    {}.freeze,
+        form_field_input:               {
+          error:    { default: false, validate: Ranges::BOOL },
+          floating: { default: nil,   validate: [nil, *Form::Floating::Ranges::TYPE] }
+        }.freeze,
+        form_field_input_group:         {
+          floating: { default: nil, validate: [nil, *Form::Floating::Ranges::TYPE] }
+        }.freeze,
+        form_field_input_textarea:      {
+          error:    { default: false, validate: Ranges::BOOL },
+          floating: { default: nil,   validate: [nil, *Form::Floating::Ranges::TYPE] }
+        }.freeze,
+        form_field_input_file:          {
+          error:    { default: false, validate: Ranges::BOOL },
+          floating: { default: nil,   validate: [nil, *Form::Floating::Ranges::TYPE] }
+        }.freeze,
+        form_field_input_select:        {
+          error:    { default: false, validate: Ranges::BOOL },
+          floating: { default: nil,   validate: [nil, *Form::Floating::Ranges::TYPE] }
+        }.freeze,
+        form_field_input_checkbox:      {
+          error:   { default: false,     validate: Ranges::BOOL },
+          type:    { default: :default,  validate: Form::Checkbox::Ranges::TYPE },
+          variant: { default: :tertiary, validate: Form::Checkbox::Ranges::VARIANT }
+        }.freeze,
+        form_field_input_radio:         {
+          error:   { default: false,     validate: Ranges::BOOL },
+          type:    { default: :default,  validate: Form::Radio::Ranges::TYPE },
+          variant: { default: :tertiary, validate: Form::Radio::Ranges::VARIANT }
+        }.freeze,
+        form_field_input_combobox:      {
+          error:    { default: false, validate: Ranges::BOOL },
+          floating: { default: nil,   validate: [nil, *Form::Floating::Ranges::TYPE] }
+        }.freeze,
+        form_field_input_reveal:        { error: { default: false, validate: Ranges::BOOL } }.freeze,
+        form_field_input_clearable:     {}.freeze,
+        form_field_input_button_reveal: {}.freeze,
+        form_field_input_button_clear:  {}.freeze,
+        form_submit:                    {
+          type:    { default: :default, validate: Button::Ranges::TYPE },
+          variant: { default: :primary, validate: Button::Ranges::VARIANT }
         }.freeze
       }.freeze
 
@@ -99,15 +173,59 @@ module StimulusPlumbers
       }.freeze
 
       INPUT_GROUP = {
-        input_group: { error: { default: false, validate: Ranges::BOOL } }.freeze
+        input_group: {
+          error:    { default: false, validate: Ranges::BOOL },
+          floating: { default: nil,   validate: [nil, *Form::Floating::Ranges::TYPE] }
+        }.freeze
+      }.freeze
+
+      LINK = {
+        link:      {
+          type:    { default: :default, validate: Link::Ranges::TYPE },
+          variant: { default: :default, validate: Link::Ranges::VARIANT }
+        }.freeze,
+        link_icon: {}.freeze
       }.freeze
 
       LAYOUT = {
         divider:           {}.freeze,
         divider_separator: {}.freeze,
         divider_label:     {}.freeze,
+        popover_wrapper:   {}.freeze,
+        popover_trigger:   {}.freeze,
         popover:           {}.freeze
       }.freeze
+
+      TIMELINE = {
+        timeline:                          {
+          orientation: { default: :vertical, validate: %i[vertical horizontal] }
+        }.freeze,
+        timeline_item:                     {
+          orientation: { default: :vertical, validate: %i[vertical horizontal] }
+        }.freeze,
+        timeline_item_indicator:           {
+          type:        { default: :dot,      validate: %i[dot icon] },
+          orientation: { default: :vertical, validate: %i[vertical horizontal] }
+        }.freeze,
+        timeline_item_time:                {
+          type: { default: :default, validate: %i[default badge] }
+        }.freeze,
+        timeline_item_title:               {}.freeze,
+        timeline_item_heading:             {}.freeze,
+        timeline_item_trigger:             {}.freeze,
+        timeline_item_description:         {}.freeze,
+        timeline_item_detail:              {}.freeze,
+        timeline_item_actions:             {}.freeze,
+        timeline_item_indicator_dot:       {}.freeze,
+        timeline_item_connector:           {}.freeze,
+        timeline_item_content:             {}.freeze,
+        timeline_track_line:               {}.freeze,
+        timeline_item_indicator_icon_slot: {}.freeze,
+        timeline_group:                    {}.freeze,
+        timeline_group_section:            {}.freeze,
+        timeline_group_section_date:       {}.freeze,
+        timeline_group_section_list:       {}.freeze
+      }.freeze
     end
   end
 end

data/lib/stimulus_plumbers/version.rb

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

data/lib/stimulus_plumbers.rb

@@ -11,48 +11,55 @@ require_relative "stimulus_plumbers/helpers"
 require_relative "stimulus_plumbers/logger"
 
 # -- Plumber base --
-require_relative "stimulus_plumbers/plumber/html_options"
 require_relative "stimulus_plumbers/plumber/dispatcher"
-require_relative "stimulus_plumbers/plumber/renderer"
+require_relative "stimulus_plumbers/plumber/slots"
 require_relative "stimulus_plumbers/plumber/base"
 
 # -- UI components --
 require_relative "stimulus_plumbers/components/icon"
 require_relative "stimulus_plumbers/components/avatar"
 require_relative "stimulus_plumbers/components/button"
+require_relative "stimulus_plumbers/components/button/slots"
 require_relative "stimulus_plumbers/components/button/group"
+require_relative "stimulus_plumbers/components/link"
+require_relative "stimulus_plumbers/components/link/slots"
 require_relative "stimulus_plumbers/components/card"
-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/card/slots"
+require_relative "stimulus_plumbers/components/list"
+require_relative "stimulus_plumbers/components/list/section"
+require_relative "stimulus_plumbers/components/list/item"
+require_relative "stimulus_plumbers/components/list/item/slots"
+require_relative "stimulus_plumbers/components/timeline"
+require_relative "stimulus_plumbers/components/timeline/event"
+require_relative "stimulus_plumbers/components/timeline/event/slots"
+require_relative "stimulus_plumbers/components/timeline/group"
 require_relative "stimulus_plumbers/components/divider"
 require_relative "stimulus_plumbers/components/input_group"
 require_relative "stimulus_plumbers/components/popover"
-require_relative "stimulus_plumbers/components/popover/builder"
+require_relative "stimulus_plumbers/components/popover/trigger"
+require_relative "stimulus_plumbers/components/popover/panel"
 
 # -- Calendar --
 require_relative "stimulus_plumbers/components/calendar"
-require_relative "stimulus_plumbers/components/calendar/month/turbo"
-require_relative "stimulus_plumbers/components/calendar/month/turbo/days_of_week"
-require_relative "stimulus_plumbers/components/calendar/month/turbo/days_of_month"
-
-# -- Date picker --
-require_relative "stimulus_plumbers/components/date_picker/navigator"
-require_relative "stimulus_plumbers/components/date_picker/navigation"
+require_relative "stimulus_plumbers/components/calendar/turbo"
+require_relative "stimulus_plumbers/components/calendar/turbo/days_of_week"
+require_relative "stimulus_plumbers/components/calendar/turbo/days_of_month"
+require_relative "stimulus_plumbers/components/calendar/turbo/months_of_year"
+require_relative "stimulus_plumbers/components/calendar/turbo/years_of_decade"
 
 # -- Combobox --
 require_relative "stimulus_plumbers/components/combobox"
 require_relative "stimulus_plumbers/components/combobox/trigger"
-require_relative "stimulus_plumbers/components/combobox/popover"
 require_relative "stimulus_plumbers/components/combobox/options"
 require_relative "stimulus_plumbers/components/combobox/options/option"
 require_relative "stimulus_plumbers/components/combobox/options/option_group"
 require_relative "stimulus_plumbers/components/combobox/date"
+require_relative "stimulus_plumbers/components/combobox/date/navigator"
+require_relative "stimulus_plumbers/components/combobox/date/navigation"
 require_relative "stimulus_plumbers/components/combobox/dropdown"
 require_relative "stimulus_plumbers/components/combobox/typeahead"
 require_relative "stimulus_plumbers/components/combobox/time"
-require_relative "stimulus_plumbers/components/combobox/time/drum"
+require_relative "stimulus_plumbers/components/combobox/builder"
 
 # -- Form --
 require_relative "stimulus_plumbers/form/field"
@@ -60,6 +67,7 @@ require_relative "stimulus_plumbers/form/fields/error"
 require_relative "stimulus_plumbers/form/fields/group"
 require_relative "stimulus_plumbers/form/fields/hint"
 require_relative "stimulus_plumbers/form/fields/label"
+require_relative "stimulus_plumbers/form/fields/label/floating"
 require_relative "stimulus_plumbers/form/builder"
 
 module StimulusPlumbers