@aurodesignsystem-dev/auro-formkit 0.0.0-pr1524.1 → 0.0.0-pr1530.1

package/components/datepicker/dist/index.js

@@ -11638,23 +11638,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);
@@ -12232,13 +12237,36 @@ class AuroCalendarCell extends LitElement {
   }
 
   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);
 
     if (!calendar) {
-      setTimeout(() => this.firstUpdated(), 0);
+      // Retry on the next event-loop turn to give the ancestor chain a chance
+      // 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) {
+        return;
+      }
+      this._firstUpdatedRetryTimer = setTimeout(() => {
+        this._firstUpdatedRetryTimer = null;
+        this._initFromAncestors();
+      }, 0);
       return;
     }
+    this._firstUpdatedRetries = 0;
     this.calendar = calendar;
     this.datepicker = calendar.datepicker;
     this._slotContentHandler = () => {
@@ -12266,6 +12294,10 @@ class AuroCalendarCell extends LitElement {
     if (this.datepicker && this._slotContentHandler) {
       this.datepicker.removeEventListener('auroDatePicker-newSlotContent', this._slotContentHandler);
     }
+    if (this._firstUpdatedRetryTimer) {
+      clearTimeout(this._firstUpdatedRetryTimer);
+      this._firstUpdatedRetryTimer = null;
+    }
   }
 
   /**
@@ -13637,7 +13669,7 @@ class AuroBibtemplate extends LitElement {
   }
 }
 
-var formkitVersion$2 = '202607022214';
+var formkitVersion$2 = '202607022134';
 
 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=literal`${unsafeStatic(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$1 = 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$1=css`: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$4=css`.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}}
@@ -13776,7 +13808,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
@@ -13809,6 +13844,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,
@@ -14354,8 +14427,19 @@ class AuroCalendar extends RangeDatepicker {
   /**
    * Returns a memoized Set of blackout timestamps (seconds) drawn from both
    * the legacy `disabledDays` array and the datepicker's ISO `blackoutDates`.
-   * The cache invalidates when either source array's reference changes, which
-   * matches Lit's own reactive identity semantics for array properties.
+   *
+   * The cache invalidates on **reference identity** — only when the
+   * consumer reassigns the array (`el.blackoutDates = [...]`), matching
+   * Lit's own reactivity semantics for array properties. In-place mutations
+   * on the existing array (`push`, `splice`, index assignment) will NOT
+   * invalidate the cache and the new entries will be silently ignored.
+   * Consumers must reassign to update — see the JSDoc on
+   * `auro-datepicker.blackoutDates` for the recommended pattern.
+   *
+   * A shallow-equality tier was considered but rejected: it would run
+   * O(N) work on every cell render (this method is called per-cell via
+   * `isBlackout()`) and still wouldn't catch same-length value swaps,
+   * offering a false sense of safety.
    * @private
    * @returns {Set<Number>}
    */
@@ -14536,7 +14620,24 @@ class AuroCalendar extends RangeDatepicker {
     // rendered month(s) first so a single-month calendar does not pick a date
     // that has no DOM cell. Determine the visible range based on centralDate and
     // the number of rendered months.
-    const renderedMonths = Math.max(this.numCalendars, 1);
+    //
+    // 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) {
+      renderedMonths = this.numCalendars;
+    } else {
+      renderedMonths = this.noRange ? 1 : 2;
+    }
+
     const visibleAnchor = this.centralDateObject ?? new Date(now * 1000);
     const visMonthStart = new Date(visibleAnchor.getFullYear(), visibleAnchor.getMonth(), 1);
     visMonthStart.setHours(0, 0, 0, 0);
@@ -14806,6 +14907,8 @@ class AuroCalendar extends RangeDatepicker {
       let targetIndex = -1;
       if (direction === 'next') {
         targetIndex = currentIndex + 1;
+      } else if (direction === 'prev') {
+        targetIndex = currentIndex - 1;
       }
 
       if (targetIndex >= 0 && targetIndex < allCells.length) {
@@ -15410,6 +15513,10 @@ class AuroCalendar extends RangeDatepicker {
    * originally tried aria-live="polite" here, but VoiceOver treats
    * polite as "wait until idle" — which never happens during active
    * keyboard navigation — so the announcements were silently dropped.
+   *
+   * This is a documented deviation from WCAG 2.1 SC 4.1.3, which
+   * prefers `polite` for status messages. See the "Documented
+   * Deviation" section in components/datepicker/docs/pages/accessibility.md.
    * @private
    * @param {String} dateStr - The localized date string to announce.
    * @returns {void}
@@ -19455,7 +19562,7 @@ let AuroHelpText$2 = class AuroHelpText extends LitElement {
   }
 };
 
-var formkitVersion$1 = '202607022214';
+var formkitVersion$1 = '202607022134';
 
 let AuroElement$2 = class AuroElement extends LitElement {
   static get properties() {
@@ -32337,17 +32444,14 @@ class BaseInput extends AuroElement$1 {
    * @returns {void}
    */
   notifyValueChanged() {
-    // This echoes Lit's reactive value update (and handleClickClear's
-    // programmatic clear) — it is NOT a fresh user-input event. Mark it
-    // `isProgrammatic` so consumers (e.g. auro-combobox) can distinguish
-    // it from genuine user typing and skip clobbering their own
-    // programmatic state during init-time renders.
-    const inputEvent = new Event('input', {
+    let inputEvent = null;
+
+    inputEvent = new Event('input', {
       bubbles: true,
       composed: true,
     });
-    inputEvent.isProgrammatic = true;
 
+    // Dispatched event to alert outside shadow DOM context of event firing.
     this.dispatchEvent(inputEvent);
   }
 
@@ -33060,7 +33164,7 @@ let AuroHelpText$1 = class AuroHelpText extends LitElement {
   }
 };
 
-var formkitVersion = '202607022214';
+var formkitVersion = '202607022134';
 
 // Copyright (c) 2025 Alaska Airlines. All right reserved. Licensed under the Apache-2.0 license
 // See LICENSE in the project root for license information.
@@ -33346,15 +33450,20 @@ class AuroInput extends BaseInput {
    * @returns {void}
    */
   checkDisplayValueSlotChange() {
-    // flatten:true resolves through auro-combobox's forwarding slot
-    // (<slot name="displayValue" slot="displayValue">) so a clone appended
-    // directly to auro-input's light DOM alongside the forwarder still
-    // counts as content. The prior nodes[0].tagName === 'SLOT' recursion
-    // discarded any siblings past the forwarder.
-    const slot = this.shadowRoot.querySelector('slot[name="displayValue"]');
-    const nodes = slot.assignedNodes({ flatten: true });
+    let nodes = this.shadowRoot.querySelector('slot[name="displayValue"]').assignedNodes();
+
+    // Handle when DisplayValue is multi-level slot content (e.g. combobox passing displayValue to input)
+    if (nodes && nodes[0] && nodes[0].tagName === 'SLOT') {
+      nodes = nodes[0].assignedNodes();
+    }
+
+    let hasContent = false;
 
-    this.hasDisplayValueContent = nodes.length > 0;
+    if (nodes.length > 0) {
+      hasContent = true;
+    }
+
+    this.hasDisplayValueContent = hasContent;
   }
 
   firstUpdated() {
@@ -34432,6 +34541,15 @@ const datepickerKeyboardStrategy = {
     evt.stopPropagation();
     evt.preventDefault();
 
+    // Signal to the visibility-change handler in auro-datepicker.js that
+    // focus should be restored to the trigger regardless of hasFocus.
+    // hidePopover() (desktop non-modal path) does not auto-restore focus,
+    // and hiding the grid's popover ancestor drops focus to <body>. That
+    // synchronously fires focusout on the datepicker host — clearing
+    // hasFocus — before updated() runs, which would otherwise skip the
+    // input refocus. Native <dialog>.close() (modal path) restores focus
+    // itself, but the flag is harmless there.
+    component._restoreFocusOnClose = true;
     component.hideBib();
   },
 
@@ -34705,6 +34823,14 @@ class AuroDatePicker extends AuroElement {
 
       /**
        * Array of dates that cannot be selected. Dates should be in ISO format (YYYY-MM-DD).
+       *
+       * **Immutable update required.** The datepicker treats this array as
+       * immutable and memoizes a lookup Set keyed on the array's reference
+       * identity — matching Lit's own reactivity semantics for array
+       * properties. In-place mutations (`blackoutDates.push(...)`,
+       * `blackoutDates[i] = ...`, `blackoutDates.splice(...)`) will not
+       * invalidate the cache and the new entries will be silently ignored.
+       * To update, reassign the property: `el.blackoutDates = [...el.blackoutDates, '2024-12-25']`.
        */
       blackoutDates: {
         type: Array,
@@ -35590,12 +35716,13 @@ class AuroDatePicker extends AuroElement {
         this.calendar.activeCellDate = null;
 
         // Show the month containing the selected date (or today) instead of
-        // whichever month the user last navigated to.
+        // whichever month the user last navigated to. Route through
+        // updateCentralDate so centralDate stays first-of-month.
         // Respect consumer-provided centralDate/calendarStartDate if no value is set.
         if (this.valueObject) {
-          this.centralDate = this.value;
+          this.calendarRenderUtil.updateCentralDate(this, this.value);
         } else if (!this.centralDate && !this.calendarStartDate && !this.minDate) {
-          this.centralDate = dateFormatter$1.toISOFormatString(new Date());
+          this.calendarRenderUtil.updateCentralDate(this, new Date());
         }
       }
 
@@ -35653,8 +35780,15 @@ class AuroDatePicker extends AuroElement {
         // Always clear the inert flag. Only restore focus to the input when the datepicker
         // still has focus (e.g. Escape, date selected) — not when the user tabbed away,
         // which would pull them back and require extra Tab presses to escape.
+        //
+        // `_restoreFocusOnClose` is set by the Escape handler in
+        // datepickerKeyboardStrategy.js to force restore even when hasFocus
+        // has already been cleared — hidePopover() (desktop non-modal path)
+        // can drop focus to <body> before this update fires.
         this.dropdown.trigger.inert = false;
-        if (this.hasFocus) {
+        const shouldRestoreFocus = this.hasFocus || this._restoreFocusOnClose;
+        this._restoreFocusOnClose = false;
+        if (shouldRestoreFocus) {
           requestAnimationFrame(() => {
             if (!this.dropdown.isPopoverVisible) {
               this.inputList[0].focus();
@@ -36100,6 +36234,18 @@ class AuroDatePicker extends AuroElement {
       this.calendar.requestUpdate();
       this.dispatchEvent(new CustomEvent('auroDatePicker-newSlotContent'));
     }
+
+    // Range invariant: if a value change (from click or programmatic) has
+    // moved start past end, clear valueEnd here so both properties land in
+    // the SAME reactive cycle. Doing it in updated() would schedule a
+    // second cycle after cellClickActive/wasCellClick has already been
+    // consumed by the value branch, leaving the valueEnd branch to run
+    // with a stale handshake and racing with any intervening programmatic
+    // value assignments.
+    if ((changedProperties.has('value') || changedProperties.has('valueEnd')) &&
+      this.valueObject && this.valueEndObject && this.valueObject > this.valueEndObject) {
+      this.valueEnd = undefined;
+    }
   }
 
   updated(changedProperties) {
@@ -36167,8 +36313,12 @@ class AuroDatePicker extends AuroElement {
 
       if (this.value && this.value.length === this.inputList[0].lengthForType && !(this.wasCellClick && this.range)) {
         // Skip centralDate update when user clicked a cell in range mode
-        // to prevent the displayed months from shifting
-        this.centralDate = this.value;
+        // to prevent the displayed months from shifting. Route through
+        // updateCentralDate so centralDate stays first-of-month — direct
+        // assignment of the raw value briefly holds a mid-month string
+        // and violates the invariant that observers (e.g. calendar sync)
+        // rely on.
+        this.calendarRenderUtil.updateCentralDate(this, this.value);
       }
 
       this.setHasValue();
@@ -36226,8 +36376,10 @@ class AuroDatePicker extends AuroElement {
 
       if (this.valueEnd && this.valueEnd.length === this.inputList[1].lengthForType && !this.wasCellClick) {
         // Skip centralDate update when user clicked a cell in range mode
-        // to prevent the displayed months from shifting
-        this.centralDate = this.valueEnd;
+        // to prevent the displayed months from shifting. Route through
+        // updateCentralDate to preserve the first-of-month invariant
+        // (see matching comment in the value branch above).
+        this.calendarRenderUtil.updateCentralDate(this, this.valueEnd);
       }
 
       this.validate();
@@ -36251,10 +36403,6 @@ class AuroDatePicker extends AuroElement {
       this.validation.validate(lastInput, true);
     }
 
-    if (this.valueObject && this.valueEndObject && this.valueObject > this.valueEndObject) {
-      this.valueEnd = undefined;
-    }
-
     // This resets the datepicker when the minDate is set to a new value that is
     // a later date than the current value date
     if (changedProperties.has('minDate') && this.minDate) {