@aurodesignsystem-dev/auro-formkit 0.0.0-pr1530.0 → 0.0.0-pr1530.2

package/components/datepicker/demo/index.min.js

@@ -11680,23 +11680,28 @@ var popoverVersion = '6.0.1';
  * @returns {number|null} Local-midnight Unix timestamp (seconds), or null.
  */
 function parseIsoToTimestamp(isoStr) {
+  // Strict YYYY-MM-DD matcher with named groups. Rejects trailing garbage
+  // ("2024x-01-01"), short segments ("2024-1-1"), and any non-digit
+  // characters. `parseInt` alone accepted both because it stops at the
+  // first non-digit and doesn't require a minimum length.
+  const ISO_DATE_RE = /^(?<year>\d{4})-(?<month>\d{2})-(?<day>\d{2})$/u;
+  const MAX_MONTH = 12;
+  const MAX_DAY = 31;
+
   if (typeof isoStr !== 'string') {
     return null;
   }
-  const parts = isoStr.split('-');
-  if (parts.length !== 3) {
-    return null;
-  }
-  const year = parseInt(parts[0], 10);
-  const month = parseInt(parts[1], 10);
-  const day = parseInt(parts[2], 10);
-  if (!Number.isFinite(year) || !Number.isFinite(month) || !Number.isFinite(day)) {
+  const match = ISO_DATE_RE.exec(isoStr);
+  if (!match) {
     return null;
   }
+  const year = Number(match.groups.year);
+  const month = Number(match.groups.month);
+  const day = Number(match.groups.day);
   // Reject overflow values like "2024-13-40" — JS `new Date(year, month, day)`
   // silently normalizes those to a different calendar day, which would
   // disable the wrong date if we let the result through.
-  if (month < 1 || month > 12 || day < 1 || day > 31) {
+  if (month < 1 || month > MAX_MONTH || day < 1 || day > MAX_DAY) {
     return null;
   }
   const date = new Date(year, month - 1, day);
@@ -12274,6 +12279,18 @@ class AuroCalendarCell extends i$1 {
   }
 
   firstUpdated() {
+    this._initFromAncestors();
+  }
+
+  /**
+   * Wires the cell to its ancestor calendar-month and calendar (and, via
+   * the calendar, to the datepicker). Extracted from firstUpdated() so the
+   * retry loop can re-attempt without recursively invoking a Lit lifecycle
+   * method (which is outside the framework's contract).
+   * @private
+   * @returns {void}
+   */
+  _initFromAncestors() {
     const calendarMonth = this.runtimeUtils.closestElement('auro-formkit-calendar-month', this);
     const calendar = this.runtimeUtils.closestElement('auro-formkit-calendar', calendarMonth);
 
@@ -12282,12 +12299,12 @@ class AuroCalendarCell extends i$1 {
       // to attach — but cap attempts so a permanently detached cell doesn't
       // spin forever. 10 turns is far more than any observed race needs.
       this._firstUpdatedRetries = (this._firstUpdatedRetries || 0) + 1;
-      if (this._firstUpdatedRetries > 10) { // eslint-disable-line no-magic-numbers
+      if (this._firstUpdatedRetries > 10) {
         return;
       }
       this._firstUpdatedRetryTimer = setTimeout(() => {
         this._firstUpdatedRetryTimer = null;
-        this.firstUpdated();
+        this._initFromAncestors();
       }, 0);
       return;
     }
@@ -13700,7 +13717,7 @@ class AuroBibtemplate extends i$1 {
   }
 }
 
-var formkitVersion$2 = '202607021905';
+var formkitVersion$2 = '202607022225';
 
 let l$1 = class l{generateElementName(t,e){let o=t;return o+="-",o+=e.replace(/[.]/g,"_"),o}generateTag(o,s,a){const r=this.generateElementName(o,s),i=i$5`${s$5(r)}`;return customElements.get(r)||customElements.define(r,class extends a{}),i}};let d$1 = class d{registerComponent(t,e){customElements.get(t)||customElements.define(t,class extends e{});}closestElement(t,e=this,o=(e,s=e&&e.closest(t))=>e&&e!==document&&e!==window?s||o(e.getRootNode().host):null){return o(e)}handleComponentTagRename(t,e){const o=e.toLowerCase();t.tagName.toLowerCase()!==o&&t.setAttribute(o,true);}elementMatch(t,e){const o=e.toLowerCase();return t.tagName.toLowerCase()===o||t.hasAttribute(o)}getSlotText(t,e){const o=t.shadowRoot?.querySelector(`slot[name="${e}"]`),s=(o?.assignedNodes({flatten:true})||[]).map(t=>t.textContent?.trim()).join(" ").trim();return s||null}};let h$4 = class h{registerComponent(t,e){customElements.get(t)||customElements.define(t,class extends e{});}closestElement(t,e=this,o=(e,s=e&&e.closest(t))=>e&&e!==document&&e!==window?s||o(e.getRootNode().host):null){return o(e)}handleComponentTagRename(t,e){const o=e.toLowerCase();t.tagName.toLowerCase()!==o&&t.setAttribute(o,true);}elementMatch(t,e){const o=e.toLowerCase();return t.tagName.toLowerCase()===o||t.hasAttribute(o)}};var c$3=i$3`:host{color:var(--ds-auro-loader-color)}:host>span{background-color:var(--ds-auro-loader-background-color);border-color:var(--ds-auro-loader-border-color)}:host([onlight]),:host([appearance=brand]){--ds-auro-loader-color: var(--ds-basic-color-brand-primary, #01426a)}:host([ondark]),:host([appearance=inverse]){--ds-auro-loader-color: var(--ds-basic-color-texticon-inverse, #ffffff)}:host([orbit])>span{--ds-auro-loader-background-color: transparent}:host([orbit])>span:nth-child(1){--ds-auro-loader-border-color: currentcolor;opacity:.25}:host([orbit])>span:nth-child(2){--ds-auro-loader-border-color: currentcolor;border-right-color:transparent;border-bottom-color:transparent;border-left-color:transparent}
 `,u$6=i$3`.body-default{font-size:var(--wcss-body-default-font-size, 1rem);line-height:var(--wcss-body-default-line-height, 1.5rem)}.body-default,.body-lg{font-family:var(--wcss-body-family, "AS Circular"),system-ui,-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif;font-weight:var(--wcss-body-weight, 450);letter-spacing:var(--wcss-body-letter-spacing, 0)}.body-lg{font-size:var(--wcss-body-lg-font-size, 1.125rem);line-height:var(--wcss-body-lg-line-height, 1.625rem)}.body-sm{font-size:var(--wcss-body-sm-font-size, .875rem);line-height:var(--wcss-body-sm-line-height, 1.25rem)}.body-sm,.body-xs{font-family:var(--wcss-body-family, "AS Circular"),system-ui,-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif;font-weight:var(--wcss-body-weight, 450);letter-spacing:var(--wcss-body-letter-spacing, 0)}.body-xs{font-size:var(--wcss-body-xs-font-size, .75rem);line-height:var(--wcss-body-xs-line-height, 1rem)}.body-2xs{font-family:var(--wcss-body-family, "AS Circular"),system-ui,-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif;font-size:var(--wcss-body-2xs-font-size, .625rem);font-weight:var(--wcss-body-weight, 450);letter-spacing:var(--wcss-body-letter-spacing, 0);line-height:var(--wcss-body-2xs-line-height, .875rem)}.display-2xl{font-family:var(--wcss-display-2xl-family, "AS Circular"),var(--wcss-display-2xl-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-size:var(--wcss-display-2xl-font-size, clamp(3.5rem, 6vw, 5.375rem));font-weight:var(--wcss-display-2xl-weight, 300);letter-spacing:var(--wcss-display-2xl-letter-spacing, 0);line-height:var(--wcss-display-2xl-line-height, 1.3)}.display-xl{font-family:var(--wcss-display-xl-family, "AS Circular"),var(--wcss-display-xl-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-size:var(--wcss-display-xl-font-size, clamp(3rem, 5.3333333333vw, 4.5rem));font-weight:var(--wcss-display-xl-weight, 300);letter-spacing:var(--wcss-display-xl-letter-spacing, 0);line-height:var(--wcss-display-xl-line-height, 1.3)}.display-lg{font-family:var(--wcss-display-lg-family, "AS Circular"),var(--wcss-display-lg-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-size:var(--wcss-display-lg-font-size, clamp(2.75rem, 4.6666666667vw, 4rem));font-weight:var(--wcss-display-lg-weight, 300);letter-spacing:var(--wcss-display-lg-letter-spacing, 0);line-height:var(--wcss-display-lg-line-height, 1.3)}.display-md{font-family:var(--wcss-display-md-family, "AS Circular"),var(--wcss-display-md-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-size:var(--wcss-display-md-font-size, clamp(2.5rem, 4vw, 3.5rem));font-weight:var(--wcss-display-md-weight, 300);letter-spacing:var(--wcss-display-md-letter-spacing, 0);line-height:var(--wcss-display-md-line-height, 1.3)}.display-sm{font-family:var(--wcss-display-sm-family, "AS Circular"),var(--wcss-display-sm-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-size:var(--wcss-display-sm-font-size, clamp(2rem, 3.6666666667vw, 3rem));font-weight:var(--wcss-display-sm-weight, 300);letter-spacing:var(--wcss-display-sm-letter-spacing, 0);line-height:var(--wcss-display-sm-line-height, 1.3)}.display-xs{font-family:var(--wcss-display-xs-family, "AS Circular"),var(--wcss-display-xs-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-size:var(--wcss-display-xs-font-size, clamp(1.75rem, 3vw, 2.375rem));font-weight:var(--wcss-display-xs-weight, 300);letter-spacing:var(--wcss-display-xs-letter-spacing, 0);line-height:var(--wcss-display-xs-line-height, 1.3)}.heading-xl{font-family:var(--wcss-heading-xl-family, "AS Circular"),var(--wcss-heading-xl-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-size:var(--wcss-heading-xl-font-size, clamp(2rem, 3vw, 2.5rem));font-weight:var(--wcss-heading-xl-weight, 300);letter-spacing:var(--wcss-heading-xl-letter-spacing, 0);line-height:var(--wcss-heading-xl-line-height, 1.3)}.heading-lg{font-family:var(--wcss-heading-lg-family, "AS Circular"),var(--wcss-heading-lg-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-size:var(--wcss-heading-lg-font-size, clamp(1.75rem, 2.6666666667vw, 2.25rem));font-weight:var(--wcss-heading-lg-weight, 300);letter-spacing:var(--wcss-heading-lg-letter-spacing, 0);line-height:var(--wcss-heading-lg-line-height, 1.3)}.heading-md{font-family:var(--wcss-heading-md-family, "AS Circular"),var(--wcss-heading-md-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-size:var(--wcss-heading-md-font-size, clamp(1.625rem, 2.3333333333vw, 1.75rem));font-weight:var(--wcss-heading-md-weight, 300);letter-spacing:var(--wcss-heading-md-letter-spacing, 0);line-height:var(--wcss-heading-md-line-height, 1.3)}.heading-sm{font-family:var(--wcss-heading-sm-family, "AS Circular"),var(--wcss-heading-sm-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-size:var(--wcss-heading-sm-font-size, clamp(1.375rem, 2vw, 1.5rem));font-weight:var(--wcss-heading-sm-weight, 300);letter-spacing:var(--wcss-heading-sm-letter-spacing, 0);line-height:var(--wcss-heading-sm-line-height, 1.3)}.heading-xs{font-family:var(--wcss-heading-xs-family, "AS Circular"),var(--wcss-heading-xs-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-size:var(--wcss-heading-xs-font-size, clamp(1.25rem, 1.6666666667vw, 1.25rem));font-weight:var(--wcss-heading-xs-weight, 450);letter-spacing:var(--wcss-heading-xs-letter-spacing, 0);line-height:var(--wcss-heading-xs-line-height, 1.3)}.heading-2xs{font-family:var(--wcss-heading-2xs-family, "AS Circular"),var(--wcss-heading-2xs-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-size:var(--wcss-heading-2xs-font-size, clamp(1.125rem, 1.5vw, 1.125rem));font-weight:var(--wcss-heading-2xs-weight, 450);letter-spacing:var(--wcss-heading-2xs-letter-spacing, 0);line-height:var(--wcss-heading-2xs-line-height, 1.3)}.accent-2xl{font-family:var(--wcss-accent-2xl-family, "Good OT"),var(--wcss-accent-2xl-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-size:var(--wcss-accent-2xl-font-size, clamp(2rem, 3.1666666667vw, 2.375rem));font-weight:var(--wcss-accent-2xl-weight, 450);letter-spacing:var(--wcss-accent-2xl-letter-spacing, .05em);line-height:var(--wcss-accent-2xl-line-height, 1)}.accent-2xl,.accent-xl{text-transform:uppercase}.accent-xl{font-family:var(--wcss-accent-xl-family, "Good OT"),var(--wcss-accent-xl-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-size:var(--wcss-accent-xl-font-size, clamp(1.625rem, 2.3333333333vw, 2rem));font-weight:var(--wcss-accent-xl-weight, 450);letter-spacing:var(--wcss-accent-xl-letter-spacing, .05em);line-height:var(--wcss-accent-xl-line-height, 1.3)}.accent-lg{font-family:var(--wcss-accent-lg-family, "Good OT"),var(--wcss-accent-lg-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-size:var(--wcss-accent-lg-font-size, clamp(1.5rem, 2.1666666667vw, 1.75rem));font-weight:var(--wcss-accent-lg-weight, 450);letter-spacing:var(--wcss-accent-lg-letter-spacing, .05em);line-height:var(--wcss-accent-lg-line-height, 1.3)}.accent-lg,.accent-md{text-transform:uppercase}.accent-md{font-family:var(--wcss-accent-md-family, "Good OT"),var(--wcss-accent-md-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-size:var(--wcss-accent-md-font-size, clamp(1.375rem, 1.8333333333vw, 1.5rem));font-weight:var(--wcss-accent-md-weight, 500);letter-spacing:var(--wcss-accent-md-letter-spacing, .05em);line-height:var(--wcss-accent-md-line-height, 1.3)}.accent-sm{font-family:var(--wcss-accent-sm-family, "Good OT"),var(--wcss-accent-sm-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-size:var(--wcss-accent-sm-font-size, clamp(1.125rem, 1.5vw, 1.25rem));font-weight:var(--wcss-accent-sm-weight, 500);letter-spacing:var(--wcss-accent-sm-letter-spacing, .05em);line-height:var(--wcss-accent-sm-line-height, 1.3)}.accent-sm,.accent-xs{text-transform:uppercase}.accent-xs{font-family:var(--wcss-accent-xs-family, "Good OT"),var(--wcss-accent-xs-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-size:var(--wcss-accent-xs-font-size, clamp(1rem, 1.3333333333vw, 1rem));font-weight:var(--wcss-accent-xs-weight, 500);letter-spacing:var(--wcss-accent-xs-letter-spacing, .1em);line-height:var(--wcss-accent-xs-line-height, 1.3)}.accent-2xs{font-family:var(--wcss-accent-2xs-family, "Good OT"),var(--wcss-accent-2xs-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-size:var(--wcss-accent-2xs-font-size, clamp(.875rem, 1.1666666667vw, .875rem));font-weight:var(--wcss-accent-2xs-weight, 450);letter-spacing:var(--wcss-accent-2xs-letter-spacing, .1em);line-height:var(--wcss-accent-2xs-line-height, 1.3);text-transform:uppercase}:focus:not(:focus-visible){outline:3px solid transparent}:host,:host>span{position:relative}:host{width:2rem;height:2rem;display:inline-block;font-size:0}:host>span{position:absolute;display:inline-block;float:none;top:0;left:0;width:2rem;height:2rem;border-radius:100%;border-style:solid;border-width:0;box-sizing:border-box}:host([xs]),:host([xs])>span{width:1.2rem;height:1.2rem}:host([sm]),:host([sm])>span{width:3rem;height:3rem}:host([md]),:host([md])>span{width:5rem;height:5rem}:host([lg]),:host([lg])>span{width:8rem;height:8rem}:host{--margin: .375rem;--margin-xs: .2rem;--margin-sm: .5rem;--margin-md: .75rem;--margin-lg: 1rem}:host([pulse]),:host([pulse])>span{position:relative}:host([pulse]){width:calc(3rem + var(--margin) * 6);height:calc(1rem + var(--margin) * 2)}:host([pulse])>span{width:1rem;height:1rem;margin:var(--margin);animation:pulse 1.5s ease infinite}:host([pulse][xs]){width:calc(1.95rem + var(--margin-xs) * 6);height:calc(.65rem + var(--margin-xs) * 2)}:host([pulse][xs])>span{margin:var(--margin-xs);width:.65rem;height:.65rem}:host([pulse][sm]){width:calc(6rem + var(--margin-sm) * 6);height:calc(2rem + var(--margin-sm) * 2)}:host([pulse][sm])>span{margin:var(--margin-sm);width:2rem;height:2rem}:host([pulse][md]){width:calc(9rem + var(--margin-md) * 6);height:calc(3rem + var(--margin-md) * 2)}:host([pulse][md])>span{margin:var(--margin-md);width:3rem;height:3rem}:host([pulse][lg]){width:calc(15rem + var(--margin-lg) * 6);height:calc(5rem + var(--margin-lg) * 2)}:host([pulse][lg])>span{margin:var(--margin-lg);width:5rem;height:5rem}:host([pulse])>span:nth-child(1){animation-delay:-.4s}:host([pulse])>span:nth-child(2){animation-delay:-.2s}:host([pulse])>span:nth-child(3){animation-delay:0ms}@keyframes pulse{0%,to{opacity:.1;transform:scale(.9)}50%{opacity:1;transform:scale(1.1)}}:host([orbit]),:host([orbit])>span{opacity:1}:host([orbit])>span{border-width:5px}:host([orbit])>span:nth-child(2){animation:orbit 2s linear infinite}:host([orbit][sm])>span{border-width:8px}:host([orbit][md])>span{border-width:13px}:host([orbit][lg])>span{border-width:21px}@keyframes orbit{0%{transform:rotate(0)}to{transform:rotate(360deg)}}:host([ringworm])>svg{animation:rotate 2s linear infinite;height:100%;width:100%;stroke:currentcolor;stroke-width:8}:host([ringworm]) .path{stroke-dashoffset:0;animation:ringworm 1.5s ease-in-out infinite;stroke-linecap:round}@keyframes rotate{to{transform:rotate(360deg)}}@keyframes ringworm{0%{stroke-dasharray:1,200;stroke-dashoffset:0}50%{stroke-dasharray:89,200;stroke-dashoffset:-35px}to{stroke-dasharray:89,200;stroke-dashoffset:-124px}}:host([laser]){position:static;width:100%;display:block;height:0;overflow:hidden;font-size:unset}:host([laser])>span{position:fixed;width:100%;height:.25rem;border-radius:0;z-index:100}:host([laser])>span:nth-child(1){border-color:currentcolor;opacity:.25}:host([laser])>span:nth-child(2){border-color:currentcolor;animation:laser 2s linear infinite;opacity:1;width:50%}:host([laser][sm])>span:nth-child(2){width:20%}:host([laser][md])>span:nth-child(2){width:30%}:host([laser][lg])>span:nth-child(2){width:50%;animation-duration:1.5s}:host([laser][xl])>span:nth-child(2){width:80%;animation-duration:1.5s}@keyframes laser{0%{left:-100%}to{left:110%}}:host>.no-animation{display:none}@media (prefers-reduced-motion: reduce){:host{display:flex;align-items:center;justify-content:center}:host>span{opacity:1}:host>.loader{display:none}:host>svg{display:none}:host>.no-animation{display:block}}
@@ -13839,7 +13856,10 @@ class AuroCalendar extends RangeDatepicker {
      * Support will be removed in a future major release.
      * @private
      */
-    this.disabledDays = [];
+    // Initialize the backing field directly so the constructor's default
+    // empty array doesn't trigger the deprecation warning. Assignments from
+    // consumers still route through the setter below.
+    this._disabledDays = [];
 
     /**
      * @private
@@ -13872,6 +13892,44 @@ class AuroCalendar extends RangeDatepicker {
     this._calendarInstanceId = Date.now().toString(36);
   }
 
+  /**
+   * @deprecated See constructor JSDoc — migrate to
+   * `auro-datepicker.blackoutDates`. The getter/setter pair exists so the
+   * one-time deprecation warning fires as soon as a consumer assigns a
+   * non-empty array (empty assignments are ignored — an empty array is
+   * indistinguishable from the constructor default and would produce a
+   * spurious warning), rather than only when `_getBlackoutSet()` happens
+   * to rebuild.
+   * @returns {Array} The current legacy `disabledDays` array.
+   */
+  get disabledDays() {
+    return this._disabledDays;
+  }
+
+  /**
+   * @param {Array} value - The legacy `disabledDays` array to set.
+   */
+  set disabledDays(value) {
+    const oldValue = this._disabledDays;
+    // Coerce non-arrays to `[]`. Consumers occasionally pass `null`
+    // (Lit's Array attribute converter returns null for a missing/empty
+    // attribute) or misuse the API; downstream code in
+    // `auro-calendar-cell.isEnabled` calls `.findIndex()` on this value
+    // without an Array.isArray guard, so a truthy non-array would throw
+    // at render.
+    const coerced = Array.isArray(value) ? value : [];
+    if (coerced.length > 0) {
+      this._warnDisabledDaysDeprecated();
+    }
+    this._disabledDays = coerced;
+    // `disabledDays` is a Lit `@property({ type: Array })` on the
+    // RangeDatepicker base class; Lit's generated setter (which we've
+    // overridden here to insert the warning) is what normally invalidates
+    // the reactive cycle. Re-invoke requestUpdate manually so consumer
+    // assignments still re-render the calendar.
+    this.requestUpdate('disabledDays', oldValue);
+  }
+
   static get styles() {
     return [
       styleCss$7,
@@ -14611,12 +14669,15 @@ class AuroCalendar extends RangeDatepicker {
     // that has no DOM cell. Determine the visible range based on centralDate and
     // the number of rendered months.
     //
-    // numCalendars is assigned during renderAllCalendars(), which runs after
-    // updated() — so the visible-change handler's eager computeActiveDate()
-    // call arrives with numCalendars still undefined. Math.max(undefined, 1)
-    // is NaN, which would silently skip the visible-month scan below. Fall
-    // back to maximumRenderableMonths' desktop default (1 for non-range,
-    // 2 for range) so the scan window is correctly sized on first open.
+    // numCalendars is assigned inside renderAllCalendars(), which runs during
+    // render() — so by the time the visible-change handler in updated()
+    // calls computeActiveDate() in the same cycle, numCalendars is normally
+    // set. Guard against the pre-first-render path anyway (e.g. any future
+    // caller that reaches computeActiveDate before render() has run):
+    // Math.max(undefined, 1) is NaN, which would silently skip the
+    // visible-month scan below. Fall back to maximumRenderableMonths'
+    // desktop default (1 for non-range, 2 for range) so the scan window is
+    // correctly sized whenever numCalendars is not yet populated.
     let renderedMonths = null;
 
     if (Number.isFinite(this.numCalendars) && this.numCalendars > 0) {
@@ -19573,7 +19634,7 @@ let AuroHelpText$2 = class AuroHelpText extends i$1 {
   }
 };
 
-var formkitVersion$1 = '202607021905';
+var formkitVersion$1 = '202607022225';
 
 let AuroElement$2 = class AuroElement extends i$1 {
   static get properties() {
@@ -31588,14 +31649,16 @@ class BaseInput extends AuroElement$1 {
     this.label = 'Input label is undefined';
     this.layout = 'classic';
     this.locale = 'en-US';
+    this._format = undefined;
+
+    /** @private */
+    this._userSetFormat = false;
     this.max = undefined;
     this.maxLength = undefined;
     this.min = undefined;
     this.minLength = undefined;
     this.noValidate = false;
     this.onDark = false;
-    // Raw values returned from the input mask before model normalization.
-    this._rawMaskValue = undefined;
     this.required = false;
     this.setCustomValidityForType = undefined;
     // Credit Card is intentionally excluded — its mask manages the cursor
@@ -31753,7 +31816,8 @@ class BaseInput extends AuroElement$1 {
        */
       format: {
         type: String,
-        reflect: true
+        reflect: true,
+        noAccessor: true
       },
 
       /**
@@ -32091,6 +32155,34 @@ class BaseInput extends AuroElement$1 {
     return this.max && dateFormatter.isValidDate(this.max) ? dateFormatter.stringToDateInstance(this.max) : undefined;
   }
 
+  get format() {
+    return this._format;
+  }
+
+  /**
+   * Overrides LitElement's generated accessor so we can track whether the
+   * consumer explicitly set `format`. Locale-derived updates use
+   * `_setFormatFromLocale` instead, which skips this flag.
+   */
+  set format(value) {
+    const oldValue = this._format;
+    this._format = value ? value.toLowerCase() : value;
+    this._userSetFormat = Boolean(value);
+    this.requestUpdate('format', oldValue);
+  }
+
+  /**
+   * Sets format without marking it as user-set. Used by locale auto-derive
+   * so that a subsequent locale change can still update the format.
+   * @private
+   * @param {string} value
+   */
+  _setFormatFromLocale(value) {
+    const oldValue = this._format;
+    this._format = value ? value.toLowerCase() : value;
+    this.requestUpdate('format', oldValue);
+  }
+
   connectedCallback() {
     super.connectedCallback();
 
@@ -32138,15 +32230,6 @@ class BaseInput extends AuroElement$1 {
 
     this.inputId = this.id ? `${this.id}-input` : window.crypto.randomUUID();
 
-    // Normalize the format token to lowercase so case-mixed values supplied
-    // via attribute (e.g. `format="MM/DD/YYYY"`) hit the `dateFormatMap`
-    // lookup inside `setCustomHelpTextMessage`. Without this, an uppercase
-    // format silently misses the map and leaves `setCustomValidityForType`
-    // unset.
-    if (this.format) {
-      this.format = this.format.toLowerCase();
-    }
-
     // use validity message override if declared when initializing the component
     if (this.hasAttribute('setCustomValidity')) {
       this.ValidityMessageOverride = this.setCustomValidity;
@@ -32253,12 +32336,10 @@ class BaseInput extends AuroElement$1 {
   updated(changedProperties) {
     super.updated(changedProperties);
 
-    // When locale changes without an explicit format override, derive format from the new locale.
-    // Only runs if the current format is still the previous locale's default (not user-overridden).
+    // When locale changes, auto-derive format unless the consumer explicitly set one.
     if (changedProperties.has('locale') && !changedProperties.has('format') && this.type === 'date') {
-      const previousLocaleFormat = getDateFormatFromLocale(changedProperties.get('locale'));
-      if (!this.format || this.format.toLowerCase() === previousLocaleFormat) {
-        this.format = getDateFormatFromLocale(this.locale);
+      if (!this._userSetFormat) {
+        this._setFormatFromLocale(getDateFormatFromLocale(this.locale));
       }
     }
 
@@ -32429,9 +32510,6 @@ class BaseInput extends AuroElement$1 {
         this.maskInstance.on('accept', () => {
           if (this._configuringMask) return;
           this.value = this.util.toModelValue(this.maskInstance.value, this.format);
-          if (this.type === "date") {
-            this._rawMaskValue = this.maskInstance.value;
-          }
         });
 
         // Mask fires 'complete' on the restore step below for any value that
@@ -32439,9 +32517,6 @@ class BaseInput extends AuroElement$1 {
         this.maskInstance.on('complete', () => {
           if (this._configuringMask) return;
           this.value = this.util.toModelValue(this.maskInstance.value, this.format);
-          if (this.type === "date") {
-            this._rawMaskValue = this.maskInstance.value;
-          }
         });
 
         // Write existingValue through the mask (not the input directly) so
@@ -32678,8 +32753,7 @@ class BaseInput extends AuroElement$1 {
 
     // Set default date format if type=date and no format is defined
     if (this.type === "date" && !this.format) {
-      // Use locale to determine default date format
-      this.format = this.util.getDateMaskFromLocale().toLowerCase();
+      this._setFormatFromLocale(this.util.getDateMaskFromLocale().toLowerCase());
       this.util.updateFormat(this.format);
     }
   }
@@ -32708,7 +32782,7 @@ class BaseInput extends AuroElement$1 {
     const creditCard = this.matchInputValueToCreditCard();
     const previousFormat = this.format;
 
-    this.format = creditCard.maskFormat;
+    this._setFormatFromLocale(creditCard.maskFormat);
 
     this.maxLength = creditCard.formatLength;
     this.minLength = creditCard.formatMinLength;
@@ -33182,7 +33256,7 @@ let AuroHelpText$1 = class AuroHelpText extends i$1 {
   }
 };
 
-var formkitVersion = '202607021905';
+var formkitVersion = '202607022225';
 
 // Copyright (c) 2025 Alaska Airlines. All right reserved. Licensed under the Apache-2.0 license
 // See LICENSE in the project root for license information.

package/components/datepicker/demo/keyboard-behavior.md

@@ -33,14 +33,14 @@
 <td>-</td>
 <td>Collapsed</td>
 <td>Trigger input, <strong>NOT</strong> the input clear button</td>
-<td>Opens the calendar bib. Focus moves to the calendar grid, with <code>aria-activedescendant</code> pointing to the active date cell. The Enter key behavior overrides the inherited <code>auro-dropdown</code> key behavior outlined below.</td>
+<td>Opens the calendar bib. Focus moves to the calendar grid; the active date cell is marked imperatively and announced via the <code>aria-live</code> region. The Enter key behavior overrides the inherited <code>auro-dropdown</code> key behavior outlined below.</td>
 </tr>
 <tr>
 <td>Space</td>
 <td>-</td>
 <td>Collapsed</td>
 <td>Trigger input, <strong>NOT</strong> the input clear button</td>
-<td>Opens the calendar bib. Focus moves to the calendar grid, with <code>aria-activedescendant</code> pointing to the active date cell. The Space key behavior overrides the inherited <code>auro-dropdown</code> key behavior outlined below.</td>
+<td>Opens the calendar bib. Focus moves to the calendar grid; the active date cell is marked imperatively and announced via the <code>aria-live</code> region. The Space key behavior overrides the inherited <code>auro-dropdown</code> key behavior outlined below.</td>
 </tr>
 </tbody>
 </table>
@@ -89,7 +89,7 @@
 </tbody>
 </table>
 <auro-header level="3" id="keyEvents-calendarGrid">Calendar grid</auro-header>
-<p>When the calendar bib is open, DOM focus remains on a wrapper element (<code>#calendarGrid</code>) while <code>aria-activedescendant</code> points to a proxy element that mirrors the active cell's ARIA attributes. Arrow keys move the active cell indicator without wrapping — when a boundary is reached the calendar navigates to the adjacent month. A debounced live region announces the full date context after navigation pauses.</p>
+<p>When the calendar bib is open, DOM focus stays on the <code>#calendarGrid</code> wrapper. The active cell is tracked imperatively (an <code>active</code> property on the cell host and an <code>.activeCell</code> class on its button) — no <code>aria-activedescendant</code> or proxy element is used. Arrow keys move the active cell indicator without wrapping; when a boundary is reached the calendar navigates to the adjacent month. A debounced <code>aria-live</code> region announces the full date context after navigation pauses.</p>
 <table>
 <thead>
 <tr>

package/components/datepicker/demo/voiceover.md

@@ -37,7 +37,7 @@
 <auro-header level="3" id="voiceOverClearButton">Clear Button</auro-header>
 <p>When the clear button is focused, VoiceOver announces the <code>aria-label</code> from the <code>ariaLabel.input.clear</code> slot (or the default i18n text), followed by <em>"button"</em>.</p>
 <auro-header level="3" id="voiceOverCalendarNavigation">Calendar Navigation</auro-header>
-<p>When the calendar bib is open, DOM focus stays on the calendar grid wrapper while <code>aria-activedescendant</code> points to a proxy element that mirrors the active cell's ARIA attributes. This prevents duplicate screen reader announcements during rapid arrow-key navigation. A debounced live region (150 ms) announces the full context after the user pauses.</p>
+<p>When the calendar bib is open, DOM focus stays on the calendar grid wrapper. The active cell is tracked imperatively (an <code>active</code> property on the cell host and an <code>.activeCell</code> class on its button) and its full localized label is announced through a debounced <code>aria-live</code> region (150&nbsp;ms), so rapid arrow-key navigation produces one announcement per pause rather than one per keystroke.</p>
 <p>Users can navigate calendar cells using VoiceOver gestures (swipe left/right) or arrow keys. Each cell announces:</p>
 <ul>
 <li>The full localized date (e.g. <em>"Thursday, May 14, 2026"</em>)</li>
@@ -70,7 +70,7 @@
 <ol>
 <li><strong>Focus</strong> — Tab to the datepicker input.</li>
 <li><strong>Type a date</strong> — Enter a date value directly, or press Enter/Space to open the calendar.</li>
-<li><strong>Calendar opens</strong> — Focus moves to the calendar grid wrapper, with <code>aria-activedescendant</code> pointing to the active date. VoiceOver announces the active date. Navigate dates with VoiceOver gestures (swipe) or arrow keys.</li>
+<li><strong>Calendar opens</strong> — Focus moves to the calendar grid wrapper. The initial active cell is marked imperatively, and the <code>aria-live</code> region announces its full localized label so VoiceOver reads the active date. Navigate dates with VoiceOver gestures (swipe) or arrow keys.</li>
 <li><strong>Select a date</strong> — Activate a calendar cell (double-tap with VoiceOver, or Enter/Space with keyboard) to select the date. The selected date is announced via a live region and populates the input. The calendar remains open; close it by pressing Escape or activating the Done button.</li>
 </ol>
 <auro-header level="2" id="voiceOverSmallVPAnnouncements">Small Viewport Workflow</auro-header>
@@ -78,7 +78,7 @@
 <ol>
 <li><strong>Focus</strong> — Tab or swipe to the datepicker input.</li>
 <li>
-<strong>Open:</strong> The fullscreen modal dialog opens. VoiceOver announces the dialog name (e.g. <em>"Departure date, dialog"</em>). Focus is moved to the calendar grid wrapper, with <code>aria-activedescendant</code> pointing to the active date.
+<strong>Open:</strong> The fullscreen modal dialog opens. VoiceOver announces the dialog name (e.g. <em>"Departure date, dialog"</em>). Focus is moved to the calendar grid wrapper, and the <code>aria-live</code> region announces the initial active date.
 </li>
 <li><strong>Navigate dates</strong> — Swipe through calendar cells or use arrow keys.</li>
 <li>

package/components/datepicker/demo/why-datepicker.md

@@ -4,11 +4,11 @@
 <p>Native date inputs vary widely across browsers and platforms, with inconsistent screen reader announcements, keyboard behavior, and focus management.</p>
 <p><code>auro-datepicker</code> provides:</p>
 <ul>
-<li><strong>Full keyboard navigation</strong> — Arrow keys move between days, months, and years. Enter and Space select a date. Escape closes the calendar. The <code>aria-activedescendant</code> pattern keeps DOM focus on the calendar grid wrapper while visually indicating the active cell, so screen readers stay in sync without duplicate announcements during rapid navigation.</li>
+<li><strong>Full keyboard navigation</strong> — Arrow keys move between days, months, and years. Enter and Space select a date. Escape closes the calendar. DOM focus stays on the calendar grid wrapper while an imperatively-tracked active cell is announced through a debounced <code>aria-live</code> region, so screen readers stay in sync without duplicate announcements during rapid navigation.</li>
 <li><strong>Rich ARIA semantics</strong> — Every cell is labeled with its full date, day-of-week, and contextual state (e.g. "selected", "today", "unavailable", "range start", "in range"). Screen reader users hear meaningful announcements, not just numbers.</li>
 <li><strong>Live region announcements</strong> — Month changes are announced via <code>aria-live</code> so assistive technology users know the visible month has changed.</li>
 <li><strong>Reduced motion support</strong> — Scrolling and transitions respect <code>prefers-reduced-motion</code>.</li>
-<li><strong>Focus management</strong> — Opening the calendar moves focus to the calendar grid wrapper, with <code>aria-activedescendant</code> pointing to the active date cell. Closing it returns focus to the trigger input. The fullscreen dialog uses <code>showModal()</code> for native inert-background behavior, while the desktop modal traps focus within the bib.</li>
+<li><strong>Focus management</strong> — Opening the calendar moves focus to the calendar grid wrapper; the initial active date cell is marked imperatively and announced via the <code>aria-live</code> region. Closing returns focus to the trigger input. The fullscreen dialog uses <code>showModal()</code> for native inert-background behavior, while the desktop modal traps focus within the bib.</li>
 </ul>
 <p>By contrast, native <code>&lt;input type="date"&gt;</code> delegates all of this to the browser, and the result differs significantly between Chrome, Safari, and Firefox — often with no keyboard navigation of the calendar grid at all on some platforms.</p>
 <auro-header level="2" id="dateRangeSelection">Date range selection</auro-header>

package/components/datepicker/dist/auro-calendar-cell.d.ts

@@ -219,6 +219,15 @@ export class AuroCalendarCell extends LitElement {
      */
     private handleSlotContent;
     firstUpdated(): void;
+    /**
+     * Wires the cell to its ancestor calendar-month and calendar (and, via
+     * the calendar, to the datepicker). Extracted from firstUpdated() so the
+     * retry loop can re-attempt without recursively invoking a Lit lifecycle
+     * method (which is outside the framework's contract).
+     * @private
+     * @returns {void}
+     */
+    private _initFromAncestors;
     _firstUpdatedRetries: any;
     _firstUpdatedRetryTimer: any;
     calendar: any;

package/components/datepicker/dist/auro-calendar.d.ts

@@ -173,6 +173,15 @@ export class AuroCalendar extends RangeDatepicker {
      * @private
      */
     private calendarRangeMonths;
+    /**
+     * @deprecated Use `auro-datepicker.blackoutDates` (an array of
+     * `YYYY-MM-DD` ISO strings) instead. This legacy array of Unix
+     * timestamps is still honored for backward compatibility but emits a
+     * one-time `console.debug` the first time a non-empty value is observed.
+     * Support will be removed in a future major release.
+     * @private
+     */
+    private _disabledDays;
     /**
      * @private
      */