Minor adjustments.

Author: tomshaw

config/config.php

@@ -1,9 +1,7 @@
 <?php
 
 /**
- * This configuration file defines the calendar table name, start months for each season and the start month of the fiscal year.
- *
- * @return array
+ * Configuration file for the Laravel Calendar Table package.
  */
 return [
     /**
@@ -13,7 +11,18 @@
 
     /**
      * The 'seasons' array defines the start month for each season.
-     * Each key is a season name, and each value is the start month for that season.
+     *
+     * This configuration assumes the meteorological seasons of the Northern Hemisphere, where the seasons are defined as follows:
+     * - Spring starts in March (3rd month)
+     * - Summer starts in June (6th month)
+     * - Autumn starts in September (9th month)
+     * - Winter starts in December (12th month)
+     *
+     * Users in the Southern Hemisphere should reconfigure the seasons approximately six months offset from those of the Northern Hemisphere:
+     * - Spring starts in September
+     * - Summer starts in December
+     * - Autumn starts in March
+     * - Winter starts in June
      */
     'seasons' => [
         'Spring' => 3,
@@ -23,7 +32,13 @@
     ],
 
     /**
-     * The 'fiscal_year_start_month' defines the start month of the fiscal year.
+     * The 'fiscal_year_start_month' option defines the start month of the fiscal year.
+     *
+     * Months are represented as numbers between 1 (January) and 12 (December).
+     *
+     * In this case, the fiscal year starts in October (10th month). This might be the case for a company or government that operates on a fiscal year that begins on October 1 and ends on September 30 of the following year.
+     *
+     * Users should adjust this setting to match their own fiscal year. For example, if the fiscal year starts in July, they would set this option to 7.
      */
     'fiscal_year_start_month' => 10,
 ];

phpstan-baseline.neon

@@ -1,11 +1,2 @@
 parameters:
-	ignoreErrors:
-		-
-			message: "#^Unable to resolve the template type TKey in call to function collect$#"
-			count: 1
-			path: src/Commands/CalendarTableCommand.php
-
-		-
-			message: "#^Unable to resolve the template type TValue in call to function collect$#"
-			count: 1
-			path: src/Commands/CalendarTableCommand.php
+	ignoreErrors: []

src/Commands/CalendarTableCommand.php

@@ -39,7 +39,7 @@ public function __construct()
     {
         parent::__construct();
 
-        $this->tableName = config('calendar-table.table_name','date_dimension');
+        $this->tableName = config('calendar-table.table_name', 'date_dimension');
     }
 
     /**
@@ -181,22 +181,44 @@ public function isValidYear(int $input)
     /**
      * Determines the season for a given date.
      *
+     * This function determines the season for a given date based on the start month of each season.
+     * The function iterates through the seasons array and returns the first season where the start month is less than or equal to the current month.
+     * If no season is found, the function returns 'Winter' as the default season.
      *
-     * @throws \Exception If the 'seasons' configuration is not set.
+     * @param  Carbon  $date  The date for which the season is to be determined.
+     * @return string The season for the given date.
      */
     public function determineSeason(Carbon $date): string
     {
-        // Determine the season
-        return collect(config('calendar-table.seasons'), [])->filter(function ($startMonth) use ($date) {
-            return $date->month >= $startMonth;
-        })->keys()->last() ?? 'Winter';
+        $seasons = config('calendar-table.seasons', [
+            'Spring' => 3,
+            'Summer' => 6,
+            'Autumn' => 9,
+            'Winter' => 12,
+        ]);
+
+        // Reverse the seasons array so we can find the first season where the start month is less than or equal to the current month
+        $seasons = array_reverse($seasons, true);
+
+        foreach ($seasons as $season => $startMonth) {
+            if ($date->month >= $startMonth) {
+                return $season;
+            }
+        }
+
+        return 'Winter';
     }
 
     /**
-     * Calculates the fiscal year and quarter for a given date.
+     * Determines the fiscal year and quarter for a given date.
      *
+     * This function determines the fiscal year and quarter for a given date based on the start month of the fiscal year.
+     * The function calculates the fiscal year based on the month of the date and the start month of the fiscal year.
+     * If the month of the date is greater than or equal to the start month of the fiscal year, the fiscal year is incremented by 1.
+     * The fiscal quarter is calculated based on the month of the date and the start month of the fiscal year.
      *
-     * @throws \Exception If the 'fiscal_year_start_month' configuration is not set.
+     * @param  Carbon  $date  The date for which the fiscal year and quarter are to be determined.
+     * @return array An array containing the fiscal year and quarter for the given date.
      */
     public function fiscalYearQuarter(Carbon $date): array
     {