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

package/components/counter/dist/registered.js

@@ -258,109 +258,236 @@ let p$2 = class p{registerComponent(t,a){customElements.get(t)||customElements.d
 
 var iconVersion$1 = '9.1.2';
 
-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);
 
-      const parsedDate = this.parseDate(dateStr, format);
+  if (!result) {
+    return undefined;
+  }
 
-      if (!parsedDate) {
-        throw new Error('AuroDatepickerUtilities | toNorthAmericanFormat: Unable to parse date string');
-      }
+  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";
 
-      const { month, day, year } = parsedDate;
+  if (isCalendarDate(year, month, day)) {
+    return result;
+  }
 
-      const dateParts = [];
-      if (month) {
-        dateParts.push(month);
-      }
+  throw new Error(
+    `AuroDatepickerUtilities | parseDate: Date string is not a valid date ${JSON.stringify(result)} with format ${format}`,
+  );
+}
 
-      if (day) {
-        dateParts.push(day);
-      }
+/**
+ * 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 (year) {
-        dateParts.push(year);
-      }
+/**
+ * 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;
+  }
 
-      return dateParts.join('/');
-    };
+  const parsedDate = parseDate(dateStr, format);
+
+  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")}`;
+}
+
+/**
+ * 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 = new DateFormatter();
+
+const dateFormatter = {
+  parseDate,
+  getDateParts,
+  getDateAsString,
+  toNorthAmericanFormat: toNorthAmericanFormat$1,
+  isValidDate,
+  toISOFormatString,
+  stringToDateInstance,
+};
 
 // filepath: dateConstraints.mjs
 const DATE_UTIL_CONSTRAINTS = {
@@ -432,12 +559,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);
   }
 
@@ -446,14 +572,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();
 
     /**
@@ -462,7 +586,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.
@@ -471,53 +596,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;
     };
 
     /**
@@ -527,10 +640,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
@@ -539,11 +653,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;
@@ -559,7 +672,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
@@ -573,6 +688,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) {
@@ -584,7 +703,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
@@ -598,6 +719,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) {
@@ -612,7 +737,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
@@ -628,7 +755,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
@@ -662,10 +789,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.
@@ -1471,7 +1595,7 @@ class AuroHelpText extends LitElement {
   }
 }
 
-var formkitVersion = '202606011921';
+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.

package/components/datepicker/demo/accessibility.md

@@ -35,17 +35,19 @@ The calendar uses the WAI-ARIA grid pattern for screen reader navigation:
 | `role="rowgroup"` | Header / body groups | Groups the day-of-week header row and the week rows. |
 | `role="row"` | Week row | Groups each week of date cells. |
 | `role="columnheader"` | Day-of-week header | Each day-of-week abbreviation. Rendered as an `<abbr>` element with the full day name in the `title` attribute so screen readers can announce the expanded form. |
-| `role="gridcell"` | In-range date cell | Each selectable date cell. Includes `aria-selected`, `aria-current="date"` (for today), and a visually-hidden text label. |
+| `role="gridcell"` | In-range date cell, active-descendant proxy | Each selectable date cell. Includes `aria-selected`, `aria-current="date"` (for today), and a visually-hidden text label. A proxy `<span>` inside the calendar grid wrapper mirrors the active cell's ARIA attributes for `aria-activedescendant`. |
 | `role="presentation"` | Out-of-range date cell | Cells outside the valid min/max range. Also receive `aria-hidden="true"` and `tabindex="-1"` to remove them from both the accessibility tree and the tab order. |
 | `aria-disabled="true"` | Blackout date cell | Cells matching the `blackout` dates list. Unlike out-of-range cells, blackout cells **remain focusable** via arrow-key navigation so screen reader users can discover them. The cell's label includes ", unavailable" to communicate that the date cannot be selected. |
 | `aria-selected` | Date cell button | `"true"` for the selected date(s), `"false"` for all other in-range cells. |
-| Accessible name | Date cell button | Provided via visually-hidden text content (not an `aria-label` attribute). Localized label built from `Intl.DateTimeFormat` (weekday, month, day, year), plus the range position label (e.g., "range start") and availability status (", unavailable" for blackout dates). |
+| Accessible name | Date cell button | Provided via visually-hidden text content (not an `aria-label` attribute). Localized label built from `Intl.DateTimeFormat` (weekday, month, day, year), plus any date slot content (e.g. prices), the range position label (e.g., "range start"), and availability status (", unavailable" for blackout dates). |
 
 <auro-header level="2" id="focusManagement">Focus Management</auro-header>
 The component uses `delegatesFocus: true` on its shadow root, meaning focus is automatically delegated to the first focusable element inside the component (the date input).
 
-<auro-header level="3" id="rovingTabindex">Roving Tabindex</auro-header>
-The calendar grid uses a **roving tabindex** pattern. Only one date cell across the entire calendar has `tabindex="0"` at a time — all other cells have `tabindex="-1"`. Arrow keys move the active cell without wrapping; when a boundary is reached the calendar navigates to the adjacent month.
+<auro-header level="3" id="ariaActivedescendant">aria-activedescendant</auro-header>
+The calendar grid uses an **`aria-activedescendant`** pattern for keyboard navigation. DOM focus remains on a wrapper element (`#calendarGrid`) while `aria-activedescendant` points to a proxy `<span>` that mirrors the active cell's ARIA attributes (`aria-label`, `aria-selected`, `aria-current`, `aria-disabled`). This approach keeps the screen reader in sync with the visually active cell without moving DOM focus on every keystroke, which prevents duplicate announcements during rapid arrow-key navigation.
+
+The active cell receives a `.visualFocus` CSS class to display a visible focus ring, since the native `:focus-visible` pseudo-class applies to the grid wrapper (which holds actual DOM focus), not to individual cells.
 
 The initial active cell is determined in priority order:
 
@@ -55,11 +57,12 @@ The initial active cell is determined in priority order:
 4. The first past enabled date.
 
 <auro-header level="3" id="focusOnOpen">Focus on Open</auro-header>
-When the calendar bib opens, focus moves to the active date cell inside the calendar grid. This applies to both desktop and fullscreen modes.
+When the calendar bib opens, focus moves to the calendar grid wrapper (`#calendarGrid`). The `aria-activedescendant` attribute points to a proxy element that carries the active date cell's label, so screen readers announce the active date. This applies to both desktop and fullscreen modes.
 
 <auro-header level="2" id="screenReaderAnnouncements">Screen Reader Announcements</auro-header>
 - **Date selection** — When a date is selected, the calendar's live region (`aria-live="assertive"`) announces the formatted date (e.g., "Wednesday, January 15, 2025"). For range datepickers, both the start and end date selections are announced.
-- **Date cell labels** — Each date cell contains a visually-hidden `<span class="srOnly">` with the full localized label. VoiceOver reads this content instead of `aria-label`, which iOS VoiceOver does not reliably announce on buttons.
+- **Debounced navigation announcement** — During arrow-key navigation, a debounced live region (150 ms) announces the full date context (date, slot content, range position, availability) after the user pauses. This prevents overlapping announcements during rapid navigation.
+- **Date cell labels** — Each date cell contains a visually-hidden `<span class="srOnly">` with the full localized label, including any date slot content (e.g. prices). VoiceOver reads this content instead of `aria-label`, which iOS VoiceOver does not reliably announce on buttons.
 - **Validation errors** — When a validation error occurs, the error message is rendered with `role="alert"` and `aria-live="assertive"`, causing it to be announced immediately without requiring focus.
 - **Help text** — The help text content is associated with the input so that screen readers announce it as part of the element description when focused.
 

package/components/datepicker/demo/api.md

@@ -9,7 +9,7 @@ The `auro-datepicker` component provides users with a way to select a date or da
 
 | Property                          | Attribute                         | Modifiers | Type                                             | Default                                          | Description                                      |
 |-----------------------------------|-----------------------------------|-----------|--------------------------------------------------|--------------------------------------------------|--------------------------------------------------|
-| `appearance`                      | `appearance`                      |           | `string`                                         | "'default'"                                      | Defines whether the component will be on lighter or darker backgrounds. |
+| `appearance`                      | `appearance`                      |           | `'default' \| 'inverse'`                         | "'default'"                                      | Defines whether the component will be on lighter or darker backgrounds. |
 | `autoPlacement`                   | `autoPlacement`                   |           | `boolean`                                        | "false"                                          | If declared, bib's position will be automatically calculated where to appear. |
 | `blackoutDates`                   | `blackoutDates`                   |           | `array`                                          | []                                               | Array of dates that cannot be selected. Dates should be in ISO format (YYYY-MM-DD). |
 | `blackoutLabel`                   | `blackoutLabel`                   |           | `string`                                         | "unavailable"                                    | Label announced for blackout (disabled but in-range) date cells. |