stimulus_plumbers 0.3.3 → 0.4.2

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

@@ -0,0 +1,191 @@
+# frozen_string_literal: true
+
+module StimulusPlumbers
+  module Components
+    class Calendar
+      class Turbo
+        class DaysOfMonth < Plumber::Base
+          DAYS_PER_ROW = 7
+
+          attr_reader :date, :today, :selectable, :selected_date, :show_other_months, :since, :till
+
+          def initialize(
+            template,
+            date: Date.today,
+            today: Date.today,
+            selectable: false,
+            selected_date: nil,
+            show_other_months: false,
+            since: nil,
+            till: nil
+          )
+            super(template)
+            @date              = date
+            @today             = today
+            @selectable        = selectable
+            @selected_date     = selected_date
+            @show_other_months = show_other_months
+            @since             = since
+            @till              = till
+          end
+
+          def render(...)
+            render_days_of_month(...)
+          end
+
+          private
+
+          def render_days_of_month(**html_options)
+            html_options = merge_html_options(
+              theme.resolve(:calendar_days_of_month),
+              html_options
+            )
+            template.content_tag(:div, **html_options, role: "rowgroup") { weeks_of_month }
+          end
+
+          def weeks_of_month
+            week_options = merge_html_options(
+              theme.resolve(:calendar_row),
+              { role: "row" }
+            )
+            template.safe_join(
+              build_days.each_slice(DAYS_PER_ROW).map do |days|
+                template.content_tag(:div, **week_options) { days_in_row(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_PER_ROW - (total % DAYS_PER_ROW)) % DAYS_PER_ROW
+            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_row(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)
+            html_options = merge_html_options(
+              theme.resolve(:calendar_day),
+              { role: "gridcell", tabindex: -1, aria: { hidden: "true" } }
+            )
+            template.content_tag(:span, **html_options) do
+              template.content_tag(:time, nil, datetime: date.iso8601)
+            end
+          end
+
+          def current_month_day_cell(date)
+            if in_range?(date)
+              tag = selectable ? :button : :span
+              template.content_tag(tag, **day_cell_html_options(date)) do
+                template.content_tag(:time, date.day.to_s, datetime: date.iso8601)
+              end
+            else
+              disabled_current_month_day_cell(date)
+            end
+          end
+
+          def disabled_current_month_day_cell(date)
+            html_options = merge_html_options(
+              theme.resolve(:calendar_day),
+              { role: "gridcell", tabindex: -1, aria: { disabled: "true" } }
+            )
+            template.content_tag(:span, **html_options) do
+              template.content_tag(:time, date.day.to_s, datetime: date.iso8601)
+            end
+          end
+
+          def day_cell_html_options(date)
+            is_today = date == today
+            is_selected = selected_date && date == selected_date
+            merge_html_options(
+              theme.resolve(:calendar_day),
+              {
+                role:     "gridcell",
+                tabindex: date == focus_day ? 0 : -1,
+                aria:     {
+                  current:  is_today ? "date" : nil,
+                  selected: if selectable then is_selected ? "true" : "false" end
+                }
+              }
+            )
+          end
+
+          def other_month_day_cell(date)
+            if selectable && in_range?(date)
+              navigable_other_month_day_cell(date)
+            else
+              disabled_other_month_day_cell(date)
+            end
+          end
+
+          def navigable_other_month_day_cell(date)
+            options = merge_html_options(
+              theme.resolve(:calendar_day, outside: true),
+              { role: "gridcell", tabindex: -1, aria: { selected: "false" } }
+            )
+            template.content_tag(:button, **options, type: "button") do
+              template.content_tag(:time, date.day.to_s, datetime: date.iso8601)
+            end
+          end
+
+          def disabled_other_month_day_cell(date)
+            options = merge_html_options(
+              theme.resolve(:calendar_day, outside: true),
+              { 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
+
+          def in_range?(date)
+            (since.nil? || date >= since) && (till.nil? || date <= till)
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,62 @@
+# frozen_string_literal: true
+
+module StimulusPlumbers
+  module Components
+    class Calendar
+      class Turbo
+        class DaysOfWeek < Plumber::Base
+          WEEKDAY_FORMATS = %i[narrow short long].freeze
+
+          attr_reader :format
+
+          def initialize(template, format: :short)
+            super(template)
+            @format = format
+          end
+
+          def render(...)
+            render_days_of_week(...)
+          end
+
+          private
+
+          def render_days_of_week(**kwargs)
+            html_options = merge_html_options(
+              theme.resolve(:calendar_days_of_week),
+              kwargs
+            )
+            template.content_tag(:div, **html_options) { days_of_week }
+          end
+
+          def days_of_week
+            week_options = merge_html_options(
+              theme.resolve(:calendar_row),
+              { role: "row" }
+            )
+            template.content_tag(:div, **week_options) do
+              template.safe_join(
+                day_names.map do |abbr, full|
+                  options = { role: "columnheader" }
+                  options[:aria] = { label: abbr } if format == :narrow
+                  template.content_tag(:span, display_name(abbr, full), **options)
+                end
+              )
+            end
+          end
+
+          def display_name(abbr, full)
+            case format
+            when :narrow then abbr[0, 1]
+            when :long   then full
+            else              abbr
+            end
+          end
+
+          def day_names
+            I18n.t("date.abbr_day_names").zip(I18n.t("date.day_names"))
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,137 @@
+# frozen_string_literal: true
+
+module StimulusPlumbers
+  module Components
+    class Calendar
+      class Turbo
+        class MonthsOfYear < Plumber::Base
+          YEAR_SIZE      = 12
+          MONTHS_PER_ROW = 4
+          MONTH_FORMATS  = %i[narrow short long].freeze
+
+          attr_reader :date, :today, :selected_date, :format, :since, :till, :disabled_months
+
+          def initialize(
+            template,
+            date: Date.today,
+            today: Date.today,
+            selected_date: nil,
+            format: :short,
+            since: nil,
+            till: nil,
+            disabled_months: []
+          )
+            super(template)
+            @date           = date
+            @today          = today
+            @selected_date  = selected_date
+            @format         = format
+            @since          = since
+            @till           = till
+            @disabled_months = disabled_months
+          end
+
+          def render(...)
+            render_months_of_year(...)
+          end
+
+          private
+
+          def render_months_of_year(**html_options)
+            html_options = merge_html_options(
+              theme.resolve(:calendar_months_of_year),
+              html_options
+            )
+            template.content_tag(:div, role: "rowgroup", **html_options) { months_of_year }
+          end
+
+          def months_of_year
+            row_options = merge_html_options(
+              theme.resolve(:calendar_row),
+              { role: "row" }
+            )
+            template.safe_join(
+              month_names.each_slice(MONTHS_PER_ROW).map do |months|
+                template.content_tag(:div, **row_options) { months_in_row(months) }
+              end
+            )
+          end
+
+          def month_names
+            I18n.t("date.abbr_month_names").compact.first(YEAR_SIZE)
+                .zip(I18n.t("date.month_names").compact.first(YEAR_SIZE))
+                .each_with_index.map do |(abbr, full), i|
+                  month_num = i + 1
+                  [month_num, abbr, full, month_disabled?(month_num, abbr, full)]
+                end
+          end
+
+          def months_in_row(months)
+            template.safe_join(months.map { |number, abbr, full, disabled| month_cell(number, abbr, full, disabled) })
+          end
+
+          def month_cell(month_number, abbr, full, disabled)
+            options = month_cell_html_options(month_number, disabled)
+            options[:aria][:label] = abbr if format == :narrow
+            template.content_tag(:button, display_name(abbr, full), **options)
+          end
+
+          def display_name(abbr, full)
+            case format
+            when :narrow then abbr[0, 1]
+            when :long   then full
+            else              abbr
+            end
+          end
+
+          def month_cell_html_options(month_number, disabled)
+            merge_html_options(
+              theme.resolve(:calendar_month),
+              {
+                role:     "gridcell",
+                tabindex: focused_month?(month_number, disabled) ? 0 : -1,
+                data:     { month: month_number },
+                aria:     {
+                  current:  current_month?(month_number) ? "month" : nil,
+                  selected: selected_date_in_month?(month_number) ? "true" : "false",
+                  disabled: disabled ? "true" : nil
+                }
+              }
+            )
+          end
+
+          def month_disabled?(month_num, abbr, full)
+            month_start = Date.new(date.year, month_num, 1)
+            month_end   = Date.new(date.year, month_num, -1)
+            (since && month_end < since) ||
+              (till && month_start > till) ||
+              month_in_disabled_list?(month_num, abbr, full)
+          end
+
+          def month_in_disabled_list?(month_num, abbr, full)
+            disabled_months.any? { |v| v.to_s == month_num.to_s } ||
+              disabled_months.include?(abbr) ||
+              disabled_months.include?(full)
+          end
+
+          def current_month?(month_number)
+            month_number == today.month && date.year == today.year
+          end
+
+          def focused_month?(month_number, disabled)
+            !disabled && (selected_date_in_month?(month_number) ||
+              (current_month?(month_number) && !selected_date_in_current_year?))
+          end
+
+          def selected_date_in_current_year?
+            selected_date && selected_date.year == date.year
+          end
+
+          def selected_date_in_month?(month)
+            selected_date && month == selected_date.month && date.year == selected_date.year
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,114 @@
+# frozen_string_literal: true
+
+module StimulusPlumbers
+  module Components
+    class Calendar
+      class Turbo
+        class YearsOfDecade < Plumber::Base
+          YEARS_PER_ROW = 4
+          DECADE_SIZE   = 10
+
+          attr_reader :date, :today, :selected_date, :since, :till, :disabled_years
+
+          def initialize(
+            template,
+            date: Date.today,
+            today: Date.today,
+            selected_date: nil,
+            since: nil,
+            till: nil,
+            disabled_years: []
+          )
+            super(template)
+            @date           = date
+            @today          = today
+            @selected_date  = selected_date
+            @since          = since
+            @till           = till
+            @disabled_years = disabled_years
+          end
+
+          def render(...)
+            render_years_of_decade(...)
+          end
+
+          private
+
+          def render_years_of_decade(**html_options)
+            html_options = merge_html_options(
+              theme.resolve(:calendar_years_of_decade),
+              html_options
+            )
+            template.content_tag(:div, role: "rowgroup", **html_options) { years_of_decade }
+          end
+
+          def years_of_decade
+            row_options = merge_html_options(
+              theme.resolve(:calendar_row),
+              { role: "row" }
+            )
+            template.safe_join(
+              year_names.each_slice(YEARS_PER_ROW).map do |years|
+                template.content_tag(:div, **row_options) { years_in_row(years) }
+              end
+            )
+          end
+
+          def year_names
+            decade_start = (date.year / DECADE_SIZE) * DECADE_SIZE
+            ((decade_start - 1)..(decade_start + DECADE_SIZE)).map do |y|
+              [y, year_disabled?(y, decade_start)]
+            end
+          end
+
+          def years_in_row(years)
+            template.safe_join(years.map { |year, disabled| year_cell(year, disabled) })
+          end
+
+          def year_cell(year, disabled)
+            template.content_tag(:button, year.to_s, **year_cell_html_options(year, disabled))
+          end
+
+          def year_cell_html_options(year, disabled)
+            merge_html_options(
+              theme.resolve(:calendar_year),
+              {
+                role:     "gridcell",
+                tabindex: focused_year?(year, disabled) ? 0 : -1,
+                data:     { year: year },
+                aria:     {
+                  current:  current_year?(year) ? "year" : nil,
+                  selected: selected_date_in_year?(year) ? "true" : "false",
+                  disabled: disabled ? "true" : nil
+                }
+              }
+            )
+          end
+
+          def year_disabled?(year, decade_start)
+            outside_decade?(year, decade_start) ||
+              (since && year < since.year) ||
+              (till && year > till.year) ||
+              disabled_years.any? { |v| v.to_s == year.to_s }
+          end
+
+          def outside_decade?(year, decade_start)
+            year < decade_start || year > (decade_start + DECADE_SIZE - 1)
+          end
+
+          def current_year?(year)
+            year == today.year
+          end
+
+          def focused_year?(year, disabled)
+            !disabled && (selected_date_in_year?(year) || (current_year?(year) && !selected_date))
+          end
+
+          def selected_date_in_year?(year)
+            selected_date && year == selected_date.year
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,112 @@
+# frozen_string_literal: true
+
+module StimulusPlumbers
+  module Components
+    class Calendar
+      class Turbo < Plumber::Base
+        MONTH_SELECTOR_CONTROLLER   = "calendar-month-selector"
+        YEAR_SELECTOR_CONTROLLER    = "calendar-year-selector"
+        DECADE_SELECTOR_CONTROLLER  = "calendar-decade-selector"
+
+        def month(
+          date: Date.today,
+          today: Date.today,
+          show_other_months: false,
+          weekday_format: :short,
+          selectable: false,
+          selected_date: nil,
+          since: nil,
+          till: nil,
+          **kwargs
+        )
+          html_options = merge_html_options(
+            theme.resolve(:calendar),
+            kwargs,
+            { data: { controller: MONTH_SELECTOR_CONTROLLER } }
+          )
+          template.content_tag(:div, role: "grid", **html_options) do
+            template.safe_join(
+              [
+                Turbo::DaysOfWeek.new(template, format: weekday_format).render,
+                Turbo::DaysOfMonth.new(
+                  template,
+                  date:              date,
+                  today:             today,
+                  selectable:        selectable,
+                  selected_date:     selected_date,
+                  show_other_months: show_other_months,
+                  since:             since,
+                  till:              till
+                ).render
+              ]
+            )
+          end
+        end
+
+        def year(
+          date: Date.today,
+          today: Date.today,
+          selected_date: nil,
+          month_format: :short,
+          since: nil,
+          till: nil,
+          disabled_months: [],
+          **kwargs
+        )
+          html_options = merge_html_options(
+            theme.resolve(:calendar_quarter_grid),
+            kwargs,
+            {
+              role: "grid",
+              aria: { label: I18n.t("stimulus_plumbers.calendar.year_view") },
+              data: { controller: YEAR_SELECTOR_CONTROLLER }
+            }
+          )
+          template.content_tag(:div, **html_options) do
+            Turbo::MonthsOfYear.new(
+              template,
+              date:            date,
+              today:           today,
+              selected_date:   selected_date,
+              format:          month_format,
+              since:           since,
+              till:            till,
+              disabled_months: disabled_months
+            ).render
+          end
+        end
+
+        def decade(
+          date: Date.today,
+          today: Date.today,
+          selected_date: nil,
+          since: nil,
+          till: nil,
+          disabled_years: [],
+          **kwargs
+        )
+          html_options = merge_html_options(
+            theme.resolve(:calendar_quarter_grid),
+            kwargs,
+            {
+              role: "grid",
+              aria: { label: I18n.t("stimulus_plumbers.calendar.decade_view") },
+              data: { controller: DECADE_SELECTOR_CONTROLLER }
+            }
+          )
+          template.content_tag(:div, **html_options) do
+            Turbo::YearsOfDecade.new(
+              template,
+              date:           date,
+              today:          today,
+              selected_date:  selected_date,
+              since:          since,
+              till:           till,
+              disabled_years: disabled_years
+            ).render
+          end
+        end
+      end
+    end
+  end
+end