particle-calendar 0.1.2 → 0.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 17a944d9500da90f93bc1ae2166a6db7c3981748a68220a4d7e175f5687a8aaf
-  data.tar.gz: f89d7bd6a3127fadb36a8a7a18414cd742db527841825d5ff9ff75cca6b7867a
+  metadata.gz: f9f0c170b7f8d695d6c4fb1e46c8469870536a9d551eb13a5ef19b2b48929db2
+  data.tar.gz: 464aa7b98a03dfaf87f8f7a60db717dc83e87c49a336733f2f2ffcc626b1dfc5
 SHA512:
-  metadata.gz: 5d38ea5409eab57b743d2cda80a510d2edb470f64e2e9d039c738e0ed2888f2f7cdc1baddb27ad3ad721a743b022479f961e88cfa2afcde0fc653b01e55806a0
-  data.tar.gz: c5f54ef3084f4ee381e030bc1ee4cdf5d1d2cd4943089987bad9d130a35c60936236f4cf14e03674c9f0cc3d21dc67092159403087172bf5b6491b4f89933ebe
+  metadata.gz: 9fd923f8052c1d844203a7b76601e16dfc181b75f2492c451a208e16deae106d916cd122a7422b37e17883b72de90b6fd89fbb86bd5f045189d9e68f0f8accf6
+  data.tar.gz: 105bba2a9405df074f8e634e88a59abd6407487ae5ddf76e0ddc7933ae8406388ca2da91869b5b6c32f2177eccea9d9989011bd3426a426b8b12bb6a49a1625a

data/README.md

@@ -151,6 +151,12 @@ availability:
 first_day_of_week: sunday
 ```
 
+`weekend_days` controls which weekday labels appear red in the desktop calendar header. Date headings keep their normal color. It defaults to Saturday and Sunday, regardless of `first_day_of_week` or availability windows. Use distinct lowercase weekday names; an empty list disables weekend highlighting:
+
+```yaml
+weekend_days: [friday, saturday]
+```
+
 ### Minimum slots and event buffers
 
 `minimum_slot_minutes` removes shorter free fragments after subtraction. The default is `0`.

data/config/availability.example.yml

@@ -13,6 +13,9 @@ minimum_slot_minutes: 60
 # The calendar grid starts on Monday by default. Any lowercase weekday is accepted.
 first_day_of_week: monday
 
+# Weekday labels in the desktop header appear red. Defaults to Saturday and Sunday.
+weekend_days: [saturday, sunday]
+
 event_buffer:
   before_minutes: 0
   after_minutes: 0

data/lib/availability/application.rb

@@ -69,7 +69,8 @@ module Availability
         enabled: config.enabled,
         today: today,
         days_to_show: config.days_to_show,
-        first_day_of_week: config.first_day_of_week
+        first_day_of_week: config.first_day_of_week,
+        weekend_days: config.weekend_days
       )
     end
 

data/lib/availability/config.rb

@@ -14,7 +14,8 @@ module Availability
     include ConfigValueParser
 
     TOP_LEVEL_KEYS = %w[
-      enabled timezone calendar_urls days_to_show minimum_slot_minutes event_buffer availability first_day_of_week
+      enabled timezone calendar_urls days_to_show minimum_slot_minutes event_buffer
+      availability first_day_of_week weekend_days
     ].freeze
     EVENT_BUFFER_KEYS = %w[before_minutes after_minutes].freeze
     WEEKDAYS = %w[sunday monday tuesday wednesday thursday friday saturday].freeze
@@ -24,7 +25,7 @@ module Availability
     MAX_CALENDAR_URLS = 20
 
     attr_reader :enabled, :timezone, :calendar_urls, :days_to_show,
-                :minimum_slot_minutes, :buffer_before_minutes, :buffer_after_minutes, :first_day_of_week
+                :minimum_slot_minutes, :buffer_before_minutes, :buffer_after_minutes, :first_day_of_week, :weekend_days
 
     def self.load(path, env: ENV)
       raise ConfigError, "configuration file not found: #{path}" unless File.file?(path)
@@ -58,7 +59,8 @@ module Availability
       @timezone = parse_timezone
       @days_to_show = bounded_positive_integer('days_to_show', default: 28, maximum: MAX_DAYS_TO_SHOW)
       @minimum_slot_minutes = nonnegative_integer('minimum_slot_minutes', default: 0)
-      @first_day_of_week = parse_first_day_of_week
+      @first_day_of_week = weekday('first_day_of_week', default: 'monday', allowed: WEEKDAYS)
+      @weekend_days = weekday_list('weekend_days', default: %w[saturday sunday], allowed: WEEKDAYS)
     end
 
     def stringify_keys(value)
@@ -81,15 +83,6 @@ module Availability
       raise ConfigError, "timezone is unknown: #{name}"
     end
 
-    def parse_first_day_of_week
-      day = @raw.fetch('first_day_of_week', 'monday')
-      unless day.is_a?(String) && WEEKDAYS.include?(day)
-        raise ConfigError, "first_day_of_week must be one of: #{WEEKDAYS.join(', ')}"
-      end
-
-      day
-    end
-
     def parse_buffers
       buffer = @raw.fetch('event_buffer', {})
       raise ConfigError, 'event_buffer must be a mapping' unless buffer.is_a?(Hash)

data/lib/availability/config_value_parser.rb

@@ -44,5 +44,23 @@ module Availability
 
       raise ConfigError, "#{label} must be a non-negative integer"
     end
+
+    def weekday_list(key, default:, allowed:)
+      days = @raw.fetch(key, default)
+      raise ConfigError, "#{key} must be an array" unless days.is_a?(Array)
+      unless days.all? { |day| day.is_a?(String) && allowed.include?(day) }
+        raise ConfigError, "#{key} must contain only: #{allowed.join(', ')}"
+      end
+      raise ConfigError, "#{key} must not contain duplicates" unless days.uniq.length == days.length
+
+      days.dup.freeze
+    end
+
+    def weekday(key, default:, allowed:)
+      day = @raw.fetch(key, default)
+      return day if day.is_a?(String) && allowed.include?(day)
+
+      raise ConfigError, "#{key} must be one of: #{allowed.join(', ')}"
+    end
   end
 end

data/lib/availability/renderer.rb

@@ -13,17 +13,17 @@ module Availability
       @template = ERB.new(File.read(template_path), trim_mode: '-')
     end
 
-    def render(days:, generated_at:, timezone:, enabled:, today:, days_to_show:, first_day_of_week:)
-      view = View.new(
+    def render(days:, generated_at:, timezone:, enabled:, today:, days_to_show:, first_day_of_week:, weekend_days:)
+      @template.result(View.new(
         days: days,
         generated_at: generated_at,
         timezone: timezone,
         enabled: enabled,
         today: today,
         days_to_show: days_to_show,
-        first_day_of_week: first_day_of_week
-      )
-      @template.result(view.template_binding)
+        first_day_of_week: first_day_of_week,
+        weekend_days: weekend_days
+      ).template_binding)
     end
 
     # Exposes only display-safe availability values and formatting helpers to ERB.
@@ -32,7 +32,8 @@ module Availability
 
       attr_reader :enabled, :today
 
-      def initialize(days:, generated_at:, timezone:, enabled:, today:, days_to_show:, first_day_of_week:)
+      def initialize(days:, generated_at:, timezone:, enabled:, today:, days_to_show:, first_day_of_week:,
+                     weekend_days:)
         @days = days
         @generated_at = generated_at
         @timezone = timezone
@@ -40,6 +41,7 @@ module Availability
         @today = today
         @days_to_show = days_to_show
         @first_day_of_week = first_day_of_week
+        @weekend_days = weekend_days
       end
 
       def template_binding
@@ -80,6 +82,10 @@ module Availability
         WEEKDAYS.rotate(WEEKDAYS.index(@first_day_of_week))
       end
 
+      def weekend_day?(weekday)
+        @weekend_days.include?(weekday)
+      end
+
       def updated_at
         @timezone.to_local(@generated_at.getutc).strftime('%-d %b %Y, %H:%M %Z')
       end

data/lib/availability/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Availability
-  VERSION = '0.1.2'
+  VERSION = '0.1.3'
 end

data/templates/index.html.erb

@@ -27,6 +27,7 @@
       --today-label-background: #e0f2fe;
       --today-label-text: #075985;
       --empty: #526175;
+      --weekend: #b91c1c;
       --shadow: 0 1px 2px rgb(15 23 42 / 0.04), 0 8px 24px rgb(15 23 42 / 0.04);
       font-family: Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
     }
@@ -148,6 +149,8 @@
       text-transform: uppercase;
     }
 
+    .weekday-header span.weekend { color: var(--weekend); }
+
     .days {
       display: grid;
       grid-template-columns: repeat(7, minmax(0, 1fr));
@@ -358,6 +361,7 @@
         --today-label-background: #0c4a6e;
         --today-label-text: #bae6fd;
         --empty: #a3aec0;
+        --weekend: #fca5a5;
         --shadow: 0 1px 2px rgb(0 0 0 / 0.2), 0 10px 28px rgb(0 0 0 / 0.16);
       }
     }
@@ -394,7 +398,7 @@
     <% if enabled -%>
       <div class="calendar">
         <div class="weekday-header" aria-hidden="true">
-          <% weekdays.each do |weekday| -%><span><%= h weekday[0, 3] %></span><% end -%>
+          <% weekdays.each do |weekday| -%><span<%= ' class="weekend"' if weekend_day?(weekday) %>><%= h weekday[0, 3] %></span><% end -%>
         </div>
         <% weeks.each_with_index do |week, index| -%>
           <section class="week" aria-labelledby="week-<%= index + 1 %>-heading">

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: particle-calendar
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.1.3
 platform: ruby
 authors:
 - Timur Yanberdin