@aurodesignsystem-dev/auro-formkit 0.0.0-pr1489.5 → 0.0.0-pr1490.0

package/components/checkbox/dist/index.js

@@ -492,109 +492,236 @@ class AuroCheckbox extends LitElement {
   }
 }
 
-class DateFormatter {
+/**
+ * @description Splits a date string into its parts according to the provided format. Does NOT validate that the result is a real calendar date — use `parseDate` when validation is required.
+ * @param {string} dateStr - Date string to parse.
+ * @param {string} format - Date format to parse.
+ * @returns {{ month?: string, day?: string, year?: string }|undefined}
+ */
+function getDateParts(dateStr, format) {
+  if (!dateStr) {
+    return undefined;
+  }
+
+  const formatSeparatorMatch = format.match(/[/.-]/);
+  let valueParts;
+  let formatParts;
+
+  if (formatSeparatorMatch) {
+    const separator = formatSeparatorMatch[0];
+    valueParts = dateStr.split(separator);
+    formatParts = format.split(separator);
+  } else {
+    if (dateStr.match(/[/.-]/)) {
+      throw new Error(
+        "AuroDatepickerUtilities | parseDate: Date string has no separators",
+      );
+    }
 
-  constructor() {
+    if (dateStr.length !== format.length) {
+      throw new Error(
+        "AuroDatepickerUtilities | parseDate: Date string and format length do not match",
+      );
+    }
 
-    /**
-     * @description Parses a date string into its components.
-     * @param {string} dateStr - Date string to parse.
-     * @param {string} format - Date format to parse.
-     * @returns {Object<key["month" | "day" | "year"]: number>|undefined}
-     */
-    this.parseDate = (dateStr, format = 'mm/dd/yyyy') => {
+    valueParts = [dateStr];
+    formatParts = [format];
+  }
 
-      // Guard Clause: Date string is defined
-      if (!dateStr) {
-        return undefined;
-      }
+  if (valueParts.length !== formatParts.length) {
+    throw new Error(
+      `AuroDatepickerUtilities | parseDate: Date string and format do not match : ${dateStr} vs ${format}`,
+    );
+  }
 
-      // Assume the separator is a "/" a defined in our code base
-      const separator = '/';
+  const result = formatParts.reduce((acc, part, index) => {
+    const value = valueParts[index];
 
-      // Get the parts of the date and format
-      const valueParts = dateStr.split(separator);
-      const formatParts = format.split(separator);
+    if (/m/iu.test(part) && part.length === value.length) {
+      acc.month = value;
+    } else if (/d/iu.test(part) && part.length === value.length) {
+      acc.day = value;
+    } else if (/y/iu.test(part) && part.length === value.length) {
+      acc.year = value;
+    }
 
-      // Check if the value and format have the correct number of parts
-      if (valueParts.length !== formatParts.length) {
-        throw new Error('AuroDatepickerUtilities | parseDate: Date string and format length do not match');
-      }
+    return acc;
+  }, {});
 
-      // Holds the result to be returned
-      const result = formatParts.reduce((acc, part, index) => {
-        const value = valueParts[index];
+  if (!result.month && !result.day && !result.year) {
+    throw new Error(
+      "AuroDatepickerUtilities | parseDate: Unable to parse date string",
+    );
+  }
 
-        if ((/m/iu).test(part)) {
-          acc.month = value;
-        } else if ((/d/iu).test(part)) {
-          acc.day = value;
-        } else if ((/y/iu).test(part)) {
-          acc.year = value;
-        }
+  return result;
+}
 
-        return acc;
-      }, {});
+function isCalendarDate(year, month, day) {
+  let yearNumber = Number(year);
+  const monthNumber = Number(month);
+  const dayNumber = Number(day);
 
-      // If we found all the parts, return the result
-      if (result.month && result.year) {
-        return result;
-      }
+  if (
+    !Number.isInteger(yearNumber) ||
+    !Number.isInteger(monthNumber) ||
+    !Number.isInteger(dayNumber)
+  ) {
+    return false;
+  }
 
-      // Throw an error to let the dev know we were unable to parse the date string
-      throw new Error('AuroDatepickerUtilities | parseDate: Unable to parse date string');
-    };
+  // Handle 2-digit years by converting them to 4-digit years based on a cutoff. This allows for parsing of 2-digit year formats while still validating the resulting date.
+  if (yearNumber < 100 && yearNumber >= 50) {
+    yearNumber += 1900;
+  } else if (yearNumber < 50) {
+    yearNumber += 2000;
+  }
 
-    /**
-     * Convert a date object to string format.
-     * @param {Object} date - Date to convert to string.
-     * @param {String} locale - Optional locale to use for the date string. Defaults to user's locale.
-     * @returns {String} Returns the date as a string.
-     */
-    this.getDateAsString = (date, locale = undefined) => date.toLocaleDateString(locale, {
-      year: "numeric",
-      month: "2-digit",
-      day: "2-digit",
-    });
+  const stringified = `${String(yearNumber).padStart(4, "0")}-${String(monthNumber).padStart(2, "0")}-${String(dayNumber).padStart(2, "0")}`;
+  const date = new Date(stringified.replace(/[.-]/g, "/"));
 
-    /**
-     * Converts a date string to a North American date format.
-     * @param {String} dateStr - Date to validate.
-     * @param {String} format - Date format to validate against.
-     * @returns {Boolean}
-     */
-    this.toNorthAmericanFormat = (dateStr, format) => {
+  return (
+    !Number.isNaN(date.getTime()) && toISOFormatString(date) === stringified
+  );
+}
 
-      if (format === 'mm/dd/yyyy') {
-        return dateStr;
-      }
+/**
+ * @description Parses a date string into its components and validates that the result is a real calendar date. Use `getDateParts` instead when raw splitting without validation is needed (e.g. for in-progress input).
+ *
+ * Partial formats are supported: components absent from `format` default to `year → "0"`,
+ * `month → "01"`, `day → "01"` for calendar validation only. The returned object contains
+ * only the fields actually present in the format string — missing fields are never injected.
+ * @param {string} dateStr - Date string to parse.
+ * @param {string} format - Date format to parse.
+ * @returns {{ month?: string, day?: string, year?: string }|undefined}
+ * @throws {Error} Throws when the parsed result does not represent a valid calendar date.
+ */
+function parseDate(dateStr, format = "mm/dd/yyyy") {
+  if (!dateStr || !format) {
+    return undefined;
+  }
+  const result = getDateParts(dateStr.trim(), format);
+
+  if (!result) {
+    return undefined;
+  }
 
-      const parsedDate = this.parseDate(dateStr, format);
+  const lowerFormat = format.toLowerCase();
+  const year = lowerFormat.includes("yy") ? result.year : "0";
+  const month = lowerFormat.includes("mm") ? result.month : "01";
+  const day = lowerFormat.includes("dd") ? result.day : "01";
 
-      if (!parsedDate) {
-        throw new Error('AuroDatepickerUtilities | toNorthAmericanFormat: Unable to parse date string');
-      }
+  if (isCalendarDate(year, month, day)) {
+    return result;
+  }
 
-      const { month, day, year } = parsedDate;
+  throw new Error(
+    `AuroDatepickerUtilities | parseDate: Date string is not a valid date ${JSON.stringify(result)} with format ${format}`,
+  );
+}
 
-      const dateParts = [];
-      if (month) {
-        dateParts.push(month);
-      }
+/**
+ * Convert a date object to string format.
+ * @param {Object} date - Date to convert to string.
+ * @param {String} locale - Optional locale to use for the date string. Defaults to user's locale.
+ * @returns {String} Returns the date as a string.
+ */
+function getDateAsString(date, locale = undefined) {
+  return date.toLocaleDateString(locale, {
+    year: "numeric",
+    month: "2-digit",
+    day: "2-digit",
+  });
+}
 
-      if (day) {
-        dateParts.push(day);
-      }
+/**
+ * Converts a date string to a North American date format.
+ * @param {String} dateStr - Date to validate.
+ * @param {String} format - Date format to validate against.
+ * @returns {String}
+ */
+function toNorthAmericanFormat$1(dateStr, format) {
+  if (format === "mm/dd/yyyy") {
+    return dateStr;
+  }
 
-      if (year) {
-        dateParts.push(year);
-      }
+  const parsedDate = parseDate(dateStr, format);
 
-      return dateParts.join('/');
-    };
+  if (!parsedDate) {
+    throw new Error(
+      "AuroDatepickerUtilities | toNorthAmericanFormat: Unable to parse date string",
+    );
   }
+
+  const { month, day, year } = parsedDate;
+
+  return [month, day, year].filter(Boolean).join("/");
+}
+
+/**
+ * Validates that a date string matches the provided format and represents a real calendar date.
+ *
+ * @param {string} dateStr - Date string to validate.
+ * @param {string} [format="yyyy-mm-dd"] - Format of the date string.
+ * @returns {boolean} True when the date string is valid for the provided format, otherwise false.
+ */
+function isValidDate(dateStr, format = "yyyy-mm-dd") {
+  try {
+    if (typeof dateStr !== "string" || !dateStr || format?.length < 8) {
+      return false;
+    }
+
+    if (parseDate(dateStr, format)) {
+      return true;
+    }
+  } catch (error) {
+    return false;
+  }
+  return false;
+}
+
+/**
+ * Converts a JavaScript Date instance to a simple ISO-like date string. This returns only the calendar date portion without any time or timezone information.
+ *
+ * @param {Date} date - Date instance to convert to an ISO-like string.
+ * @returns {string} A string in the format "yyyy-mm-dd" representing the provided date.
+ * @throws {Error} Throws an error when the input is not a valid Date instance.
+ */
+function toISOFormatString(date) {
+  if (!(date instanceof Date) || Number.isNaN(date.getTime())) {
+    throw new Error(
+      "AuroDatepickerUtilities | toISOFormatString: Input must be a valid Date instance",
+    );
+  }
+  return `${String(date.getFullYear()).padStart(4, "0")}-${String(date.getMonth() + 1).padStart(2, "0")}-${String(date.getDate()).padStart(2, "0")}`;
 }
-const dateFormatter = new DateFormatter();
+
+/**
+ * Converts a date string into a JavaScript Date instance. This method supports ISO formatted strings and other formats that can be parsed by the formatter.
+ *
+ * @param {String} dateStr - Date string to convert into a Date object.
+ * @param {String} format - Date format used to parse the string when it is not in ISO format.
+ * @returns {Date|null} Returns a Date instance for valid input or null for non-string input.
+ * @throws {Error} Throws when parsing fails for non-ISO string input.
+ */
+function stringToDateInstance(dateStr, format = "yyyy-mm-dd") {
+  if (typeof dateStr !== "string") {
+    return null;
+  }
+
+  const { month, day, year } = parseDate(dateStr, format);
+  return new Date(`${year}/${month}/${day}`);
+}
+
+const dateFormatter = {
+  parseDate,
+  getDateParts,
+  getDateAsString,
+  toNorthAmericanFormat: toNorthAmericanFormat$1,
+  isValidDate,
+  toISOFormatString,
+  stringToDateInstance,
+};
 
 // filepath: dateConstraints.mjs
 const DATE_UTIL_CONSTRAINTS = {
@@ -666,12 +793,11 @@ class AuroDateUtilitiesBase {
 /* eslint-disable no-magic-numbers */
 
 class AuroDateUtilities extends AuroDateUtilitiesBase {
-
   /**
    * Returns the current century.
    * @returns {String} The current century.
    */
-  getCentury () {
+  getCentury() {
     return String(new Date().getFullYear()).slice(0, 2);
   }
 
@@ -680,14 +806,12 @@ class AuroDateUtilities extends AuroDateUtilitiesBase {
    * @param {String} year - The year to convert to four digits.
    * @returns {String} The four digit year.
    */
-  getFourDigitYear (year) {
-
+  getFourDigitYear(year) {
     const strYear = String(year).trim();
     return strYear.length <= 2 ? this.getCentury() + strYear : strYear;
   }
 
   constructor() {
-
     super();
 
     /**
@@ -696,7 +820,8 @@ class AuroDateUtilities extends AuroDateUtilitiesBase {
      * @param {Object} date2 - Second date to compare.
      * @returns {Boolean} Returns true if the dates match.
      */
-    this.datesMatch = (date1, date2) => new Date(date1).getTime() === new Date(date2).getTime();
+    this.datesMatch = (date1, date2) =>
+      new Date(date1).getTime() === new Date(date2).getTime();
 
     /**
      * Returns true if value passed in is a valid date.
@@ -705,53 +830,41 @@ class AuroDateUtilities extends AuroDateUtilitiesBase {
      * @returns {Boolean}
      */
     this.validDateStr = (date, format) => {
-
       // The length we expect the date string to be
-      const dateStrLength = format.length;
+      const dateStrLength = format?.length || 0;
 
       // Guard Clause: Date and format are defined
       if (typeof date === "undefined" || typeof format === "undefined") {
-        throw new Error('AuroDatepickerUtilities | validateDateStr: Date and format are required');
+        throw new Error(
+          "AuroDatepickerUtilities | validateDateStr: Date and format are required",
+        );
       }
 
       // Guard Clause: Date should be of type string
       if (typeof date !== "string") {
-        throw new Error('AuroDatepickerUtilities | validateDateStr: Date must be a string');
+        throw new Error(
+          "AuroDatepickerUtilities | validateDateStr: Date must be a string",
+        );
       }
 
       // Guard Clause: Format should be of type string
       if (typeof format !== "string") {
-        throw new Error('AuroDatepickerUtilities | validateDateStr: Format must be a string');
+        throw new Error(
+          "AuroDatepickerUtilities | validateDateStr: Format must be a string",
+        );
       }
 
       // Guard Clause: Length is what we expect it to be
       if (date.length !== dateStrLength) {
         return false;
       }
-      // Get a formatted date string and parse it
-      const dateParts = dateFormatter.parseDate(date, format);
 
-      // Guard Clause: Date parse succeeded
-      if (!dateParts) {
+      // Get a formatted date string and parse and validate it
+      try {
+        return Boolean(dateFormatter.parseDate(date, format));
+      } catch (error) {
         return false;
       }
-
-      // Create the expected date string based on the date parts
-      const expectedDateStr = `${dateParts.month}/${dateParts.day || "01"}/${this.getFourDigitYear(dateParts.year)}`;
-
-      // Generate a date object that we will extract a string date from to compare to the passed in date string
-      const dateObj = new Date(this.getFourDigitYear(dateParts.year), dateParts.month - 1, dateParts.day || 1);
-
-      // Get the date string of the date object we created from the string date
-      const actualDateStr = dateFormatter.getDateAsString(dateObj, "en-US");
-
-      // Guard Clause: Generated date matches date string input
-      if (expectedDateStr !== actualDateStr) {
-        return false;
-      }
-
-      // If we passed all other checks, we can assume the date is valid
-      return true;
     };
 
     /**
@@ -761,10 +874,11 @@ class AuroDateUtilities extends AuroDateUtilitiesBase {
      * @returns {boolean}
      */
     this.dateAndFormatMatch = (value, format) => {
-
       // Ensure we have both values we need to do the comparison
       if (!value || !format) {
-        throw new Error('AuroFormValidation | dateFormatMatch: value and format are required');
+        throw new Error(
+          "AuroFormValidation | dateFormatMatch: value and format are required",
+        );
       }
 
       // If the lengths are different, they cannot match
@@ -773,11 +887,10 @@ class AuroDateUtilities extends AuroDateUtilitiesBase {
       }
 
       // Get the parts of the date
-      const dateParts = dateFormatter.parseDate(value, format);
+      const dateParts = dateFormatter.getDateParts(value, format);
 
       // Validator for day
       const dayValueIsValid = (day) => {
-
         // Guard clause: if there is no day in the dateParts, we can ignore this check.
         if (!dateParts.day) {
           return true;
@@ -793,7 +906,9 @@ class AuroDateUtilities extends AuroDateUtilitiesBase {
 
         // Guard clause: ensure day is a valid integer
         if (Number.isNaN(numDay)) {
-          throw new Error('AuroDatepickerUtilities | dayValueIsValid: Unable to parse day value integer');
+          throw new Error(
+            "AuroDatepickerUtilities | dayValueIsValid: Unable to parse day value integer",
+          );
         }
 
         // Guard clause: ensure day is within the valid range
@@ -807,6 +922,10 @@ class AuroDateUtilities extends AuroDateUtilitiesBase {
 
       // Validator for month
       const monthValueIsValid = (month) => {
+        // Guard clause: if there is no month in the dateParts, we can ignore this check.
+        if (!dateParts.month) {
+          return true;
+        }
 
         // Guard clause: ensure month exists.
         if (!month) {
@@ -818,7 +937,9 @@ class AuroDateUtilities extends AuroDateUtilitiesBase {
 
         // Guard clause: ensure month is a valid integer
         if (Number.isNaN(numMonth)) {
-          throw new Error('AuroDatepickerUtilities | monthValueIsValid: Unable to parse month value integer');
+          throw new Error(
+            "AuroDatepickerUtilities | monthValueIsValid: Unable to parse month value integer",
+          );
         }
 
         // Guard clause: ensure month is within the valid range
@@ -832,6 +953,10 @@ class AuroDateUtilities extends AuroDateUtilitiesBase {
 
       // Validator for year
       const yearIsValid = (_year) => {
+        // Guard clause: if there is no year in the dateParts, we can ignore this check.
+        if (!dateParts.year) {
+          return true;
+        }
 
         // Guard clause: ensure year exists.
         if (!_year) {
@@ -846,7 +971,9 @@ class AuroDateUtilities extends AuroDateUtilitiesBase {
 
         // Guard clause: ensure year is a valid integer
         if (Number.isNaN(numYear)) {
-          throw new Error('AuroDatepickerUtilities | yearValueIsValid: Unable to parse year value integer');
+          throw new Error(
+            "AuroDatepickerUtilities | yearValueIsValid: Unable to parse year value integer",
+          );
         }
 
         // Guard clause: ensure year is within the valid range
@@ -862,7 +989,7 @@ class AuroDateUtilities extends AuroDateUtilitiesBase {
       const checks = [
         monthValueIsValid(dateParts.month),
         dayValueIsValid(dateParts.day),
-        yearIsValid(dateParts.year)
+        yearIsValid(dateParts.year),
       ];
 
       // If any of the checks failed, the date format does not match and the result is invalid
@@ -896,10 +1023,7 @@ const {
 } = dateUtilities;
 
 const {
-  toNorthAmericanFormat,
-  parseDate,
-  getDateAsString
-} = dateFormatter;
+  toNorthAmericanFormat} = dateFormatter;
 
 // Copyright (c) Alaska Air. All right reserved. Licensed under the Apache-2.0 license
 // See LICENSE in the project root for license information.
@@ -1635,7 +1759,7 @@ class AuroHelpText extends LitElement {
   }
 }
 
-var formkitVersion = '202606011922';
+var formkitVersion = '202606012111';
 
 // Copyright (c) 2026 Alaska Airlines. All rights reserved. Licensed under the Apache-2.0 license
 // See LICENSE in the project root for license information.