@aurodesignsystem-dev/auro-formkit 0.0.0-pr1514.3 → 0.0.0-pr1514.5

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

@@ -152,8 +152,10 @@ export class AuroCalendar extends RangeDatepicker {
      */
     private activeCellDate;
     /**
-     * Cached reference to the active cell host, set by setActiveCell.
-     * Lets scrollToActiveCell skip a full cell scan on each arrow key.
+     * Cached reference to the active cell host. Set by setActiveCell and
+     * refreshed by scrollToActiveCell when its cache check misses (stale
+     * or missing). Lets scrollToActiveCell skip a full cell scan on each
+     * arrow key.
      * @private
      */
     private _activeCell;
@@ -469,11 +471,26 @@ export class AuroCalendar extends RangeDatepicker {
      */
     private hoveredDateChanged;
     /**
-     * Scrolls the calendar to ensure the active cell is visible.
-     * Targets the cell itself (not its month) so that same-month vertical
-     * navigation in mobile fullscreen — where a single month can exceed the
-     * viewport height — scrolls to the target row. `block: 'nearest'` is a
-     * no-op when the cell is already in view, preserving desktop behavior.
+     * Scrolls the calendar so the active cell is visible.
+     *
+     * Walks the flat tree (rendered, slot-aware) outward from the active
+     * cell's button and calls `scrollBy` on every vertically-scrollable
+     * ancestor by whatever delta still separates the cell from that
+     * ancestor's viewport. Native `scrollIntoView` is not used because the
+     * cell sits inside multiple nested scroll containers (the dropdown bib's
+     * `<dialog>`, the bibtemplate's `#bodyContainer`) and the algorithm only
+     * scrolls one of them on its own, leaving the cell short of the
+     * viewport in mobile fullscreen.
+     *
+     * Uses `behavior: 'instant'` so each `scrollBy` resolves synchronously,
+     * letting the next iteration's `getBoundingClientRect` read post-scroll
+     * positions accurately. This also satisfies `prefers-reduced-motion`
+     * users by avoiding scroll animation altogether.
+     *
+     * The active cell is looked up from the cache populated by
+     * `setActiveCell`. On a cache miss (stale or absent) the cache is
+     * refreshed from a single full scan so subsequent calls stay on the
+     * fast path.
      * @private
      * @returns {void}
      */