@aurodesignsystem-dev/auro-formkit 0.0.0-pr1480.0 → 0.0.0-pr1480.10

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,32 @@ export class AuroCalendar extends RangeDatepicker {
      * @returns {void}
      */
     private scrollToActiveCell;
+    /**
+     * Generates a unique ID for the live region scoped to this datepicker.
+     * Uses the datepicker host's id attribute if present, otherwise falls
+     * back to a random hash.
+     * @private
+     * @returns {string} The unique live region element ID.
+     */
+    private _getLiveRegionId;
+    _liveRegionId: string | null | undefined;
+    /**
+     * Returns (and lazily creates) a document-level aria-live region.
+     * Chrome does not reliably observe aria-live regions inside shadow DOM
+     * (even one level up in a parent component's shadow root), so this
+     * element must be appended to document.body. Each datepicker instance
+     * gets its own uniquely-identified live region.
+     * @private
+     * @returns {HTMLElement} The live region element.
+     */
+    private getOrCreateLiveRegion;
+    _liveRegion: HTMLElement | HTMLDivElement | 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}
@@ -336,7 +406,6 @@ export class AuroCalendar extends RangeDatepicker {
      * @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 = '202605210248';
+var formkitVersion = '202605262117';
 
 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 = '202605210248';
+var formkitVersion = '202605262117';
 
 class AuroElement extends i {
   static get properties() {

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

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

package/components/dropdown/dist/index.js

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

package/components/dropdown/dist/registered.js

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