hizuke 0.0.4 → 0.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6a44032e09036e25847a067394cf50b60f47197e5fe4d29b068c0e822960db9d
-  data.tar.gz: 8f6a2d515fe0b1b64e970ef5ced8aad5aaa96febfd6c44448dc765d78521a709
+  metadata.gz: 0b0d90523e4927c6aeac7e03575aeb0bbb9cc923e6524cf63eacfbcff6115cb8
+  data.tar.gz: b641b880ad5ac8a67a29437702aea3c7f690695d9a560c039b2eead361b4d30f
 SHA512:
-  metadata.gz: be87cac6f8fdf4ca69ca42641ad214804787a498b019d80b80b263835ce5fed52215af0d1f6e04e30e12889c710cb56db7df19a2c20c056c4969c97cfddbbd90
-  data.tar.gz: 8e36da5a76ea3f9940b3970bab64a6dd2fa33a050caf02d9dd743e2052773ea4f28678f142dc82ce4b16dd436d0396b07afcb8bf961f9168e5d9d8fed2c733e6
+  metadata.gz: 788e7bcd5b09046f865771f7b9fc3ef55bab5ed6b1374891ef24006d67db8e3759fadaf34d21fd9ed60bce27331ef1ca6545a0fe9cd8c272ac74265b7f97772f
+  data.tar.gz: c8a4b2c5c5d07cf3c8f3d4233121a0f92c379ff2d8caaa05804e021b19da07271deec84af4ffa2061fa98e3cf84419113a09307ae25ee402fa194e874e607f81

data/CHANGELOG.md

@@ -5,6 +5,20 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.1.0] - 2025-05-08
+
+### Added
+- Support for Christmas date parsing:
+  - "christmas" / "xmas" - returns December 25th of the current year
+  - "last christmas" / "lastchristmas" - returns December 25th of the previous year
+  - "next christmas" / "nextchristmas" - returns December 25th of the next year
+
+### Changed
+- Major refactoring of the entire codebase:
+  - Improved code organization and structure
+  - Better error handling and edge case management
+  - Cleaner API design for better developer experience
+
 ## [0.0.4] - 2025-04-29
 
 ### Added

data/Gemfile

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-source "https://rubygems.org"
+source 'https://rubygems.org'
 
 # Specify your gem's dependencies in hizuke.gemspec
-gemspec 
+gemspec

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    hizuke (0.0.4)
+    hizuke (0.1.0)
 
 GEM
   remote: https://rubygems.org/

data/README.md

@@ -165,6 +165,9 @@ Currently, the following English date keywords are supported:
 - `mid month` / `midmonth` - returns the date of the 15th day of the current month
 - `next quarter` / `nextquarter` - returns the first day of the next quarter
 - `last quarter` / `lastquarter` - returns the first day of the last quarter
+- `christmas` / `xmas` - returns the date of Christmas (December 25th) of the current year (or next year if Christmas has already passed)
+- `next christmas` / `nextchristmas` - returns the date of Christmas (December 25th) of the next year
+- `last christmas` / `lastchristmas` - returns the date of Christmas (December 25th) of the previous year
 
 ## Supported Time Formats
 

data/Rakefile

@@ -1,12 +1,12 @@
 # frozen_string_literal: true
 
-require "bundler/gem_tasks"
-require "rake/testtask"
+require 'bundler/gem_tasks'
+require 'rake/testtask'
 
 Rake::TestTask.new(:test) do |t|
-  t.libs << "test"
-  t.libs << "lib"
-  t.test_files = FileList["test/**/test_*.rb"]
+  t.libs << 'test'
+  t.libs << 'lib'
+  t.test_files = FileList['test/**/test_*.rb']
 end
 
-task default: :test 
+task default: :test

data/hizuke.gemspec

@@ -1,22 +1,25 @@
 # frozen_string_literal: true
 
-require_relative "lib/hizuke/version"
+require_relative 'lib/hizuke/version'
 
 Gem::Specification.new do |spec|
-  spec.name = "hizuke"
+  spec.name = 'hizuke'
   spec.version = Hizuke::VERSION
-  spec.authors = ["Juraj Maťaše"]
-  spec.email = ["juraj@hey.com"]
+  spec.authors = ['Juraj Maťaše']
+  spec.email = ['juraj@hey.com']
 
-  spec.summary = "A simple date parser for natural language time references"
-  spec.description = "Hizuke is a lightweight utility that extracts dates from text by recognizing common time expressions. It cleans the original text and returns both the parsed date and the text without the date reference."
-  spec.homepage = "https://github.com/majur/hizuke"
-  spec.license = "MIT"
-  spec.required_ruby_version = ">= 2.6.0"
+  spec.summary = 'A simple date parser for natural language time references'
+  spec.description = 'Hizuke is a lightweight utility that extracts dates from text ' \
+                     'by recognizing common time expressions. ' \
+                     'It cleans the original text and returns both the parsed date ' \
+                     'and the text without the date reference.'
+  spec.homepage = 'https://github.com/majur/hizuke'
+  spec.license = 'MIT'
+  spec.required_ruby_version = '>= 2.6.0'
 
-  spec.metadata["homepage_uri"] = spec.homepage
-  spec.metadata["source_code_uri"] = spec.homepage
-  spec.metadata["changelog_uri"] = "#{spec.homepage}/blob/main/CHANGELOG.md"
+  spec.metadata['homepage_uri'] = spec.homepage
+  spec.metadata['source_code_uri'] = spec.homepage
+  spec.metadata['changelog_uri'] = "#{spec.homepage}/blob/main/CHANGELOG.md"
 
   # Specify which files should be added to the gem when it is released.
   # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
@@ -25,12 +28,12 @@ Gem::Specification.new do |spec|
       (f == __FILE__) || f.match(%r{\A(?:(?:bin|test|spec|features)/|\.(?:git|travis|circleci)|appveyor)})
     end
   end
-  spec.bindir = "exe"
+  spec.bindir = 'exe'
   spec.executables = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
-  spec.require_paths = ["lib"]
+  spec.require_paths = ['lib']
 
   # Add development dependencies here
-  spec.add_development_dependency "minitest", "~> 5.0"
-  spec.add_development_dependency "rake", "~> 13.0"
-  spec.add_development_dependency "rubocop", "~> 1.21"
-end 
+  spec.add_development_dependency 'minitest', '~> 5.0'
+  spec.add_development_dependency 'rake', '~> 13.0'
+  spec.add_development_dependency 'rubocop', '~> 1.21'
+end

data/lib/hizuke/constants.rb

@@ -0,0 +1,86 @@
+# frozen_string_literal: true
+
+module Hizuke
+  # Module containing constants used throughout Hizuke
+  module Constants
+    # Mapping of day names to their wday values (0-6, Sunday is 0)
+    DAYS_OF_WEEK = {
+      'monday' => 1,
+      'tuesday' => 2,
+      'wednesday' => 3,
+      'thursday' => 4,
+      'friday' => 5,
+      'saturday' => 6,
+      'sunday' => 0
+    }.freeze
+
+    # Date keywords mapping
+    DATE_KEYWORDS = {
+      'yesterday' => -1,
+      'today' => 0,
+      'tomorrow' => 1,
+      'dayaftertomorrow' => 2,
+      'day after tomorrow' => 2,
+      'daybeforeyesterday' => -2,
+      'day before yesterday' => -2,
+      'nextweek' => :next_week,
+      'next week' => :next_week,
+      'lastweek' => :last_week,
+      'last week' => :last_week,
+      'nextmonth' => :next_month,
+      'next month' => :next_month,
+      'lastmonth' => :last_month,
+      'last month' => :last_month,
+      'nextyear' => :next_year,
+      'next year' => :next_year,
+      'lastyear' => :last_year,
+      'last year' => :last_year,
+      'nextquarter' => :next_quarter,
+      'next quarter' => :next_quarter,
+      'lastquarter' => :last_quarter,
+      'last quarter' => :last_quarter,
+      'thisweekend' => :this_weekend,
+      'this weekend' => :this_weekend,
+      'endofweek' => :end_of_week,
+      'end of week' => :end_of_week,
+      'endofmonth' => :end_of_month,
+      'end of month' => :end_of_month,
+      'endofyear' => :end_of_year,
+      'end of year' => :end_of_year,
+      'midweek' => :mid_week,
+      'mid week' => :mid_week,
+      'midmonth' => :mid_month,
+      'mid month' => :mid_month,
+      'christmas' => :christmas,
+      'xmas' => :christmas,
+      'nextchristmas' => :next_christmas,
+      'next christmas' => :next_christmas,
+      'lastchristmas' => :last_christmas,
+      'last christmas' => :last_christmas
+    }.freeze
+
+    # Regex patterns for dynamic date references
+    IN_X_DAYS_PATTERN = /in (\d+) days?/i.freeze
+    X_DAYS_AGO_PATTERN = /(\d+) days? ago/i.freeze
+    IN_X_WEEKS_PATTERN = /in (\d+) weeks?/i.freeze
+    X_WEEKS_AGO_PATTERN = /(\d+) weeks? ago/i.freeze
+    IN_X_MONTHS_PATTERN = /in (\d+) months?/i.freeze
+    X_MONTHS_AGO_PATTERN = /(\d+) months? ago/i.freeze
+    IN_X_YEARS_PATTERN = /in (\d+) years?/i.freeze
+    X_YEARS_AGO_PATTERN = /(\d+) years? ago/i.freeze
+
+    # Regex patterns for specific days of the week
+    THIS_DAY_PATTERN = /this (monday|tuesday|wednesday|thursday|friday|saturday|sunday)/i.freeze
+    NEXT_DAY_PATTERN = /next (monday|tuesday|wednesday|thursday|friday|saturday|sunday)/i.freeze
+    LAST_DAY_PATTERN = /last (monday|tuesday|wednesday|thursday|friday|saturday|sunday)/i.freeze
+
+    # Regex patterns for time references
+    TIME_PATTERN = /(?:at|@)\s*(\d{1,2})(?::(\d{1,2}))?(?::(\d{1,2}))?\s*(am|pm)?/i.freeze
+
+    # Regex patterns for word-based time references
+    NOON_PATTERN = /at\s+noon/i.freeze
+    MIDNIGHT_PATTERN = /at\s+midnight/i.freeze
+    MORNING_PATTERN = /in\s+the\s+morning/i.freeze
+    EVENING_PATTERN = /in\s+the\s+evening/i.freeze
+  end
+end

data/lib/hizuke/date_calculator.rb

@@ -0,0 +1,458 @@
+# frozen_string_literal: true
+
+module Hizuke
+  # Base module for date calculations
+  module BaseCalculator
+    # Calculate date for "this [day]" - the current/upcoming day in this week
+    # @param target_wday [Integer] the target day of week (0-6, Sunday is 0)
+    # @return [Date] the calculated date
+    def calculate_this_day(target_wday)
+      today = Date.today
+      today_wday = today.wday
+
+      # Calculate days until the target day in this week
+      days_diff = (target_wday - today_wday) % 7
+
+      # If it's the same day, return today's date
+      return today if days_diff.zero?
+
+      # Return the date of the next occurrence in this week
+      today + days_diff
+    end
+
+    # Calculate date for "next [day]" - the day in next week
+    # @param target_wday [Integer] the target day of week (0-6, Sunday is 0)
+    # @return [Date] the calculated date
+    def calculate_next_day(target_wday)
+      today = Date.today
+      today_wday = today.wday
+
+      # Calculate days until the next occurrence
+      days_until_target = (target_wday - today_wday) % 7
+
+      # If today is the target day or the target day is earlier in the week,
+      # we want the day next week, so add 7 days
+      days_until_target += 7 if days_until_target.zero? || target_wday < today_wday
+
+      today + days_until_target
+    end
+
+    # Calculate date for "last [day]" - the day in previous week
+    # @param target_wday [Integer] the target day of week (0-6, Sunday is 0)
+    # @return [Date] the calculated date
+    def calculate_last_day(target_wday)
+      today = Date.today
+      today_wday = today.wday
+
+      # Calculate days since the last occurrence
+      days_since_target = (today_wday - target_wday) % 7
+
+      # If today is the target day or the target day is later in the week,
+      # we want the day last week, so add 7 days
+      days_since_target += 7 if days_since_target.zero? || target_wday > today_wday
+
+      today - days_since_target
+    end
+
+    # Handles date calculations for integer values (relative days)
+    # @param date_value [Integer] number of days from today
+    # @return [Date] calculated date
+    def calculate_relative_days(date_value)
+      Date.today + date_value
+    end
+
+    # Return mapping for week and month related date keywords
+    # @return [Hash] Mapping of keywords to method names
+    def temporal_period_methods
+      {
+        next_week: :calculate_week_date,
+        last_week: :calculate_week_date,
+        next_month: :calculate_month_date,
+        last_month: :calculate_month_date
+      }
+    end
+
+    # Return mapping for year and quarter related date keywords
+    # @return [Hash] Mapping of keywords to method names
+    def yearly_period_methods
+      {
+        next_year: :calculate_year_date,
+        last_year: :calculate_year_date,
+        next_quarter: :calculate_quarter_date,
+        last_quarter: :calculate_quarter_date
+      }
+    end
+
+    # Return mapping for special period related date keywords
+    # @return [Hash] Mapping of keywords to method names
+    def special_period_methods
+      {
+        this_weekend: :calculate_period_end_date,
+        end_of_week: :calculate_period_end_date,
+        end_of_month: :calculate_period_end_date,
+        end_of_year: :calculate_period_end_date,
+        mid_week: :calculate_period_mid_date,
+        mid_month: :calculate_period_mid_date
+      }
+    end
+
+    # Return mapping for holiday related date keywords
+    # @return [Hash] Mapping of keywords to method names
+    def holiday_methods
+      {
+        christmas: :calculate_holiday_date,
+        next_christmas: :calculate_holiday_date,
+        last_christmas: :calculate_holiday_date
+      }
+    end
+
+    # Maps date value symbols to calculation methods
+    # @return [Hash] the mapping of symbols to method names
+    def date_calculation_methods
+      temporal_period_methods.merge(yearly_period_methods)
+                             .merge(special_period_methods)
+                             .merge(holiday_methods)
+    end
+
+    # Calculate the date based on the keyword value
+    # @param date_value [Symbol, Integer] the date value to calculate from
+    # @return [Date] the calculated date
+    def calculate_date(date_value)
+      return calculate_relative_days(date_value) if date_value.is_a?(Integer)
+
+      # Look up which method to call for this symbol
+      method_name = date_calculation_methods[date_value]
+      return unless method_name
+
+      # Call the appropriate method with the date_value
+      send(method_name, date_value)
+    end
+  end
+
+  # Module for week-related date calculations
+  module WeekCalculator
+    # Calculate week-related dates
+    # @param date_value [Symbol] the date keyword (:next_week or :last_week)
+    # @return [Date] the calculated date
+    def calculate_week_date(date_value)
+      case date_value
+      when :next_week
+        calculate_next_week_date
+      when :last_week
+        calculate_last_week_date
+      end
+    end
+
+    # Calculate date for next week
+    # @return [Date] the date for next week (following Monday)
+    def calculate_next_week_date
+      # Find next Monday
+      days_until_monday = (1 - Date.today.wday) % 7
+      # If today is Monday, we want next Monday, not today
+      days_until_monday = 7 if days_until_monday.zero?
+      Date.today + days_until_monday
+    end
+
+    # Calculate date for last week
+    # @return [Date] the date for last week (previous Monday)
+    def calculate_last_week_date
+      # Find last Monday
+      days_since_monday = (Date.today.wday - 1) % 7
+      # If today is Monday, we want last Monday, not today
+      days_since_monday = 7 if days_since_monday.zero?
+      Date.today - days_since_monday - 7
+    end
+  end
+
+  # Module for month-related date calculations
+  module MonthCalculator
+    # Calculate month-related dates
+    # @param date_value [Symbol] the date keyword (:next_month or :last_month)
+    # @return [Date] the calculated date
+    def calculate_month_date(date_value)
+      case date_value
+      when :next_month
+        calculate_next_month_date
+      when :last_month
+        calculate_last_month_date
+      end
+    end
+
+    # Calculate date for next month
+    # @return [Date] the first day of the next month
+    def calculate_next_month_date
+      # Return the first day of the next month
+      next_month = Date.today >> 1
+      Date.new(next_month.year, next_month.month, 1)
+    end
+
+    # Calculate date for last month
+    # @return [Date] the first day of the previous month
+    def calculate_last_month_date
+      # Return the first day of the previous month
+      prev_month = Date.today << 1
+      Date.new(prev_month.year, prev_month.month, 1)
+    end
+  end
+
+  # Module for year-related date calculations
+  module YearCalculator
+    # Calculate year-related dates
+    # @param date_value [Symbol] the date keyword (:next_year or :last_year)
+    # @return [Date] the calculated date
+    def calculate_year_date(date_value)
+      case date_value
+      when :next_year
+        calculate_next_year_date
+      when :last_year
+        calculate_last_year_date
+      end
+    end
+
+    # Calculate date for next year
+    # @return [Date] the first day of the next year
+    def calculate_next_year_date
+      # Return the first day of the next year
+      next_year = Date.today.year + 1
+      Date.new(next_year, 1, 1)
+    end
+
+    # Calculate date for last year
+    # @return [Date] the first day of the last year
+    def calculate_last_year_date
+      # Return the first day of the last year
+      last_year = Date.today.year - 1
+      Date.new(last_year, 1, 1)
+    end
+  end
+
+  # Module for quarter-related date calculations
+  module QuarterCalculator
+    # Calculate quarter-related dates
+    # @param date_value [Symbol] the date keyword (:next_quarter or :last_quarter)
+    # @return [Date] the calculated date
+    def calculate_quarter_date(date_value)
+      case date_value
+      when :next_quarter
+        calculate_next_quarter_date
+      when :last_quarter
+        calculate_last_quarter_date
+      end
+    end
+
+    # Calculate the date for next quarter
+    # @return [Date] the first day of the next quarter
+    def calculate_next_quarter_date
+      today = Date.today
+      current_month = today.month
+
+      next_quarter_month = determine_next_quarter_month(current_month)
+      next_quarter_year = determine_next_quarter_year(today.year, current_month)
+
+      Date.new(next_quarter_year, next_quarter_month, 1)
+    end
+
+    # Determine the start month of the next quarter
+    # @param current_month [Integer] the current month (1-12)
+    # @return [Integer] the month number of the next quarter star
+    def determine_next_quarter_month(current_month)
+      if current_month <= 3
+        4  # Q2 starts in April
+      elsif current_month <= 6
+        7  # Q3 starts in July
+      elsif current_month <= 9
+        10 # Q4 starts in October
+      else
+        1  # Q1 of next year starts in January
+      end
+    end
+
+    # Determine the year of the next quarter
+    # @param current_year [Integer] the current year
+    # @param current_month [Integer] the current month (1-12)
+    # @return [Integer] the year of the next quarter
+    def determine_next_quarter_year(current_year, current_month)
+      current_year + (current_month > 9 ? 1 : 0)
+    end
+
+    # Calculate the date for last quarter
+    # @return [Date] the first day of the last quarter
+    def calculate_last_quarter_date
+      today = Date.today
+      current_month = today.month
+
+      last_quarter_month = determine_last_quarter_month(current_month)
+      last_quarter_year = determine_last_quarter_year(today.year, current_month)
+
+      Date.new(last_quarter_year, last_quarter_month, 1)
+    end
+
+    # Determine the start month of the last quarter
+    # @param current_month [Integer] the current month (1-12)
+    # @return [Integer] the month number of the last quarter star
+    def determine_last_quarter_month(current_month)
+      if current_month <= 3
+        10 # Q4 of last year starts in October
+      elsif current_month <= 6
+        1  # Q1 starts in January
+      elsif current_month <= 9
+        4  # Q2 starts in April
+      else
+        7  # Q3 starts in July
+      end
+    end
+
+    # Determine the year of the last quarter
+    # @param current_year [Integer] the current year
+    # @param current_month [Integer] the current month (1-12)
+    # @return [Integer] the year of the last quarter
+    def determine_last_quarter_year(current_year, current_month)
+      current_year - (current_month <= 3 ? 1 : 0)
+    end
+  end
+
+  # Module for period-related date calculations
+  module PeriodCalculator
+    # Calculate end of period dates
+    # @param date_value [Symbol] the date keyword
+    # @return [Date] the calculated date
+    def calculate_period_end_date(date_value)
+      case date_value
+      when :this_weekend
+        calculate_weekend_date
+      when :end_of_week
+        calculate_end_of_week_date
+      when :end_of_month
+        calculate_end_of_month_date
+      when :end_of_year
+        calculate_end_of_year_date
+      end
+    end
+
+    # Calculate date for weekend (Saturday)
+    # @return [Date] the date of the upcoming weekend
+    def calculate_weekend_date
+      # Calculate days until Saturday
+      days_until_saturday = (6 - Date.today.wday) % 7
+      # If today is Saturday or Sunday, we're already on the weekend
+      days_until_saturday = 0 if [0, 6].include?(Date.today.wday)
+      Date.today + days_until_saturday
+    end
+
+    # Calculate date for end of week (Sunday)
+    # @return [Date] the date of the upcoming Sunday
+    def calculate_end_of_week_date
+      # Calculate days until Sunday (end of week)
+      days_until_sunday = (0 - Date.today.wday) % 7
+      # If today is Sunday, we're already at the end of the week
+      days_until_sunday = 0 if days_until_sunday.zero?
+      Date.today + days_until_sunday
+    end
+
+    # Calculate date for end of month
+    # @return [Date] the last day of the current month
+    def calculate_end_of_month_date
+      # Return the last day of the current month
+      # Get the first day of next month
+      next_month = Date.today >> 1
+      first_day_next_month = Date.new(next_month.year, next_month.month, 1)
+      # Subtract one day to get the last day of current month
+      first_day_next_month - 1
+    end
+
+    # Calculate date for end of year
+    # @return [Date] the last day of the current year
+    def calculate_end_of_year_date
+      # Return the last day of the current year (December 31)
+      Date.new(Date.today.year, 12, 31)
+    end
+
+    # Calculate mid-period dates
+    # @param date_value [Symbol] the date keyword
+    # @return [Date] the calculated date
+    def calculate_period_mid_date(date_value)
+      case date_value
+      when :mid_week
+        calculate_mid_week_date
+      when :mid_month
+        calculate_mid_month_date
+      end
+    end
+
+    # Calculate date for mid-week (Wednesday)
+    # @return [Date] the date of the current week's Wednesday
+    def calculate_mid_week_date
+      # Return Wednesday of the current week
+      today_wday = Date.today.wday
+      target_wday = 3 # Wednesday
+      days_diff = (target_wday - today_wday) % 7
+      # If the difference is more than 3, then Wednesday has passed this week
+      # So we need to go back to Wednesday
+      days_diff -= 7 if days_diff > 3
+      Date.today + days_diff
+    end
+
+    # Calculate date for mid-month (15th)
+    # @return [Date] the 15th day of the current month
+    def calculate_mid_month_date
+      # Return the 15th day of the current month
+      Date.new(Date.today.year, Date.today.month, 15)
+    end
+  end
+
+  # Module for holiday-related date calculations
+  module HolidayCalculator
+    # Calculate holiday-related dates
+    # @param date_value [Symbol] the date keyword (:christmas, :next_christmas, or :last_christmas)
+    # @return [Date] the calculated date
+    def calculate_holiday_date(date_value)
+      case date_value
+      when :christmas
+        calculate_christmas_date
+      when :next_christmas
+        calculate_next_christmas_date
+      when :last_christmas
+        calculate_last_christmas_date
+      end
+    end
+
+    # Calculate this year's Christmas date (December 25)
+    # @return [Date] the date for Christmas this year
+    def calculate_christmas_date
+      current_year = Date.today.year
+      christmas_date = Date.new(current_year, 12, 25)
+
+      # If Christmas has already passed this year, return next year's Christmas
+      if Date.today > christmas_date
+        Date.new(current_year + 1, 12, 25)
+      else
+        christmas_date
+      end
+    end
+
+    # Calculate next year's Christmas date (December 25 of next year)
+    # @return [Date] the date for Christmas next year
+    def calculate_next_christmas_date
+      current_year = Date.today.year
+      Date.new(current_year + 1, 12, 25)
+    end
+
+    # Calculate last year's Christmas date (December 25 of previous year)
+    # @return [Date] the date for Christmas last year
+    def calculate_last_christmas_date
+      current_year = Date.today.year
+      Date.new(current_year - 1, 12, 25)
+    end
+  end
+
+  # Main module for date calculations
+  module DateCalculator
+    include BaseCalculator
+    include WeekCalculator
+    include MonthCalculator
+    include YearCalculator
+    include QuarterCalculator
+    include PeriodCalculator
+    include HolidayCalculator
+  end
+end