@aurodesignsystem-dev/auro-formkit 0.0.0-pr1480.1 → 0.0.0-pr1480.11

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

@@ -238,14 +238,13 @@ export class AuroCalendarCell extends LitElement {
      */
     focusButton(): void;
     /**
-     * Imperatively marks this cell as active (tabindex="0") without
-     * triggering a Lit re-render.
+     * Imperatively marks this cell as active without triggering a Lit re-render.
+     * Note: buttons stay tabindex="-1" because the grid uses aria-activedescendant.
      * @returns {void}
      */
     setActive(): void;
     /**
-     * Imperatively marks this cell as inactive (tabindex="-1") without
-     * triggering a Lit re-render.
+     * Imperatively marks this cell as inactive without triggering a Lit re-render.
      * @returns {void}
      */
     clearActive(): void;

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

@@ -129,6 +129,12 @@ export class AuroCalendar extends RangeDatepicker {
      * @private
      */
     private activeCellDate;
+    /**
+     * Whether the #calendarGrid wrapper currently has focus.
+     * Used to determine whether the visualFocus ring should be shown.
+     * @private
+     */
+    private _gridHasFocus;
     /**
      * @private
      */
@@ -154,16 +160,35 @@ export class AuroCalendar extends RangeDatepicker {
      */
     private buttonTag;
     dropdown: any;
+    /**
+     * Updates the month and year when the user navigates to the previous calendar month.
+     * @private
+     * @param {Object} [options] - Optional settings.
+     * @param {boolean} [options.skipActiveUpdate=false] - When true, skip the active cell
+     *   recomputation. Used by arrow key handlers that manage the active cell themselves.
+     * @returns {void}
+     */
+    private handlePrevMonth;
+    /**
+     * Updates the month and year when the user navigates to the next calendar month.
+     * @private
+     * @param {Object} [options] - Optional settings.
+     * @param {boolean} [options.skipActiveUpdate=false] - When true, skip the active cell
+     *   recomputation. Used by arrow key handlers that manage the active cell themselves.
+     * @returns {void}
+     */
+    private handleNextMonth;
     /**
      * Announces the current month and year via the live region after navigation.
      * @private
      * @returns {void}
      */
     private announceMonthChange;
+    _focusAnnounceTimer: any;
     /**
-     * Recomputes and sets the active cell for the newly visible month after
-     * month navigation. Without this, activeCellDate can point at a date in
-     * the old month, leaving no tabindex="0" cell in the grid.
+     * Updates the active cell after month navigation (prev/next buttons).
+     * Always moves the active cell to the first enabled date in the newly
+     * visible months so that tabbing back to the grid lands on an enabled cell.
      * @private
      * @returns {void}
      */
@@ -210,11 +235,23 @@ export class AuroCalendar extends RangeDatepicker {
     setActiveCell(date: number): void;
     /**
      * Focuses the calendar grid wrapper and sets the active cell.
-     * DOM focus stays on the grid wrapper; ariaActiveDescendantElement
+     * DOM focus stays on the grid wrapper; the aria-live region
      * tells the screen reader which cell is "active".
      * @returns {void}
      */
     focusActiveCell(): void;
+    /**
+     * Shows the activeCell ring when the grid gains focus.
+     * @private
+     * @returns {void}
+     */
+    private handleGridFocusIn;
+    /**
+     * Hides the activeCell ring when the grid loses focus.
+     * @private
+     * @returns {void}
+     */
+    private handleGridFocusOut;
     /**
      * Computes the initial active date from data properties alone — no DOM required.
      * Priority:
@@ -236,6 +273,15 @@ export class AuroCalendar extends RangeDatepicker {
      * @returns {Number|undefined} Unix timestamp (seconds) of the date to activate, or undefined.
      */
     private computeActiveDate;
+    /**
+     * Checks if a target date (unix seconds) is within the configured [min, max] range.
+     * Returns false if the date falls outside the range, preventing navigation
+     * to months where all dates are disabled.
+     * @private
+     * @param {Number} targetTs - Unix timestamp in seconds.
+     * @returns {Boolean} True if the date is within range.
+     */
+    private isDateInRange;
     /**
      * Handles arrow key navigation on the calendar grid wrapper.
      * Focus stays on the grid wrapper; only ariaActiveDescendantElement
@@ -319,8 +365,23 @@ export class AuroCalendar extends RangeDatepicker {
      * @returns {void}
      */
     private scrollToActiveCell;
+    /**
+     * Returns the aria-live region element from this component's shadow DOM.
+     * The region is rendered as part of the Lit template so it lives inside
+     * the dialog's accessible scope — both when the dropdown uses
+     * showModal() (top layer) and when desktop mode uses _setPageInert().
+     * A live region on document.body would be made inert in both cases.
+     * @private
+     * @returns {HTMLElement} The live region element.
+     */
+    private getOrCreateLiveRegion;
+    _liveRegion: Element | null | undefined;
+    _announceRafId: any;
     /**
      * Announces a date selection or focus change via the live region.
+     * Uses requestAnimationFrame to ensure the clear and set happen in
+     * separate rendering frames — Chrome may coalesce synchronous or
+     * microtask-deferred mutations into a single accessibility tree update.
      * @private
      * @param {String} dateStr - The localized date string to announce.
      * @returns {void}
@@ -328,15 +389,16 @@ export class AuroCalendar extends RangeDatepicker {
     private announceSelection;
     /**
      * Debounced version of announceSelection for focus navigation.
-     * Only announces the last focused date after rapid navigation pauses,
-     * preventing the screen reader from queueing up stale announcements
-     * that can't keep pace with arrow-key traversal.
+     * Uses the assertive live region with a 150ms debounce so only the
+     * final cell after rapid arrow-key traversal is announced. We
+     * 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.
      * @private
      * @param {String} dateStr - The localized date string to announce.
      * @returns {void}
      */
     private announceFocusDebounced;
-    _focusAnnounceTimer: any;
     /**
      * Formats a Unix timestamp (seconds) as a localized date string for SR announcements.
      * @private

package/components/dropdown/demo/customize.min.js

@@ -3942,7 +3942,7 @@ class AuroHelpText extends i {
   }
 }
 
-var formkitVersion = '202605210326';
+var formkitVersion = '202605262243';
 
 class AuroElement extends i {
   static get properties() {

package/components/dropdown/demo/getting-started.min.js

@@ -3942,7 +3942,7 @@ class AuroHelpText extends i {
   }
 }
 
-var formkitVersion = '202605210326';
+var formkitVersion = '202605262243';
 
 class AuroElement extends i {
   static get properties() {

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

@@ -3969,7 +3969,7 @@ class AuroHelpText extends i {
   }
 }
 
-var formkitVersion = '202605210326';
+var formkitVersion = '202605262243';
 
 class AuroElement extends i {
   static get properties() {

package/components/dropdown/dist/index.js

@@ -3874,7 +3874,7 @@ class AuroHelpText extends LitElement {
   }
 }
 
-var formkitVersion = '202605210326';
+var formkitVersion = '202605262243';
 
 class AuroElement extends LitElement {
   static get properties() {

package/components/dropdown/dist/registered.js

@@ -3874,7 +3874,7 @@ class AuroHelpText extends LitElement {
   }
 }
 
-var formkitVersion = '202605210326';
+var formkitVersion = '202605262243';
 
 class AuroElement extends LitElement {
   static get properties() {