@aurodesignsystem-dev/auro-formkit 0.0.0-pr1489.1 → 0.0.0-pr1489.10

package/custom-elements.json

@@ -4198,13 +4198,6 @@
                     "text": "Number"
                   }
                 },
-                {
-                  "name": "hoveredDate",
-                  "description": "Hovered date.",
-                  "type": {
-                    "text": "Number"
-                  }
-                },
                 {
                   "name": "day",
                   "description": "An object containing the dateFrom and day of month values.",
@@ -4213,7 +4206,7 @@
                   }
                 }
               ],
-              "description": "Handles selected and hovered states of the calendar cell when the date changes.",
+              "description": "Handles selected state of the calendar cell when the selection changes.\nAlso clears any imperative range preview classes so classMap is the\nsole source of truth after a selection update.",
               "privacy": "private",
               "return": {
                 "type": {
@@ -4235,7 +4228,18 @@
             {
               "kind": "method",
               "name": "handleHover",
-              "description": "Handles user hover events and dispatches a custom event.\nAlways dispatches for range pickers so the preview updates correctly.",
+              "description": "Handles user hover events and dispatches a custom event.\nDoes NOT set any reactive properties — the range preview is handled\nimperatively by the calendar component to avoid O(N) re-renders.",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "handleFocus",
+              "description": "Handles focus events on the cell button.\nDispatches a lightweight event for the calendar to handle SR\nannouncements and range preview updates without triggering\nany Lit lifecycle updates.",
               "privacy": "private",
               "return": {
                 "type": {
@@ -4510,7 +4514,7 @@
                   }
                 }
               ],
-              "description": "Checks if the current date is a highlighted date.",
+              "description": "Checks if the current date is a referenced date.",
               "return": {
                 "type": {
                   "text": ""
@@ -4570,10 +4574,77 @@
                 }
               }
             },
+            {
+              "kind": "method",
+              "name": "updateHostAria",
+              "description": "Updates ARIA attributes on the host element so that\nariaActiveDescendantElement can expose cell info to the SR.",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
             {
               "kind": "method",
               "name": "focusButton",
-              "description": "Programmatically focuses the cell's interactive button element.",
+              "description": "Programmatically focuses the cell's interactive button element.\nUses focusVisible: true so the :focus-visible ring appears even when\nthe bib was opened via mouse click (which sets mouse input modality).",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "setActive",
+              "description": "Imperatively marks this cell as active without triggering a Lit re-render.\nNote: buttons stay tabindex=\"-1\" because the grid uses aria-activedescendant.",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "clearActive",
+              "description": "Imperatively marks this cell as inactive without triggering a Lit re-render.",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "updateRangePreviewClasses",
+              "parameters": [
+                {
+                  "name": "hoveredDate",
+                  "description": "Unix timestamp of the currently hovered/focused date.",
+                  "type": {
+                    "text": "Number"
+                  }
+                },
+                {
+                  "name": "dateFrom",
+                  "description": "Unix timestamp of the selected departure date.",
+                  "type": {
+                    "text": "Number"
+                  }
+                }
+              ],
+              "description": "Updates range preview classes imperatively (no Lit re-render).\nCalled by the calendar component when the hovered date changes\nduring range selection (dateFrom set, dateTo not yet set).",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "clearRangePreviewClasses",
+              "description": "Clears all imperative range preview classes from the cell button.\nCalled when a selection occurs so classMap becomes the sole source of truth.",
               "return": {
                 "type": {
                   "text": "void"
@@ -4604,16 +4675,6 @@
               "default": "false",
               "attribute": "selected"
             },
-            {
-              "kind": "field",
-              "name": "hovered",
-              "privacy": "public",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "attribute": "hovered"
-            },
             {
               "kind": "field",
               "name": "dateTo",
@@ -4685,16 +4746,6 @@
               "default": "[]",
               "attribute": "disabledDays"
             },
-            {
-              "kind": "field",
-              "name": "hoveredDate",
-              "privacy": "public",
-              "type": {
-                "text": "null"
-              },
-              "default": "null",
-              "attribute": "hoveredDate"
-            },
             {
               "kind": "field",
               "name": "isCurrentDate",
@@ -4736,13 +4787,10 @@
             {
               "kind": "field",
               "name": "active",
-              "privacy": "public",
               "type": {
                 "text": "boolean"
               },
-              "default": "false",
-              "attribute": "active",
-              "reflects": true
+              "default": "false"
             },
             {
               "kind": "field",
@@ -4776,6 +4824,12 @@
               "type": {
                 "text": "CustomEvent"
               }
+            },
+            {
+              "name": "calendar-cell-focused",
+              "type": {
+                "text": "CustomEvent"
+              }
             }
           ],
           "attributes": [
@@ -4795,14 +4849,6 @@
               "default": "false",
               "fieldName": "selected"
             },
-            {
-              "name": "hovered",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "fieldName": "hovered"
-            },
             {
               "name": "dateTo",
               "type": {
@@ -4859,14 +4905,6 @@
               "default": "[]",
               "fieldName": "disabledDays"
             },
-            {
-              "name": "hoveredDate",
-              "type": {
-                "text": "null"
-              },
-              "default": "null",
-              "fieldName": "hoveredDate"
-            },
             {
               "name": "isCurrentDate",
               "type": {
@@ -4898,14 +4936,6 @@
               "default": "false",
               "fieldName": "renderForDateSlot"
             },
-            {
-              "name": "active",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "fieldName": "active"
-            },
             {
               "name": "hasPopoverContent",
               "type": {
@@ -4921,6 +4951,10 @@
           },
           "tagName": "auro-formkit-calendar-cell",
           "customElement": true
+        },
+        {
+          "kind": "variable",
+          "name": "blackout"
         }
       ],
       "exports": [
@@ -5032,17 +5066,28 @@
             },
             {
               "kind": "method",
-              "name": "handleGridKeyDown",
+              "name": "handleDateHovered",
               "parameters": [
                 {
                   "name": "event",
-                  "description": "The keyboard event.",
+                  "description": "The date-is-hovered event from a cell.",
                   "type": {
-                    "text": "KeyboardEvent"
+                    "text": "CustomEvent"
                   }
                 }
               ],
-              "description": "Handles arrow key navigation within the month grid.\nDispatches a cross-month navigation event when the boundary is reached.",
+              "description": "Overrides the base class handler to prevent setting `this.hoveredDate`\nas a reactive property. Instead, just dispatches the event upward so\nthe calendar can handle range preview imperatively.",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "handleTbodyMouseLeave",
+              "description": "Dispatches a bubbling event when the mouse leaves the date grid body\nso the parent calendar can clear the range hover preview.",
               "privacy": "private",
               "return": {
                 "type": {
@@ -5081,13 +5126,13 @@
           ],
           "events": [
             {
-              "name": "calendar-month-boundary",
+              "name": "hovered-date-changed",
               "type": {
                 "text": "CustomEvent"
               }
             },
             {
-              "name": "calendar-cell-activate",
+              "name": "calendar-month-mouseleave",
               "type": {
                 "text": "CustomEvent"
               }
@@ -5141,6 +5186,16 @@
             {
               "kind": "method",
               "name": "handlePrevMonth",
+              "parameters": [
+                {
+                  "name": "options",
+                  "description": "Optional settings.",
+                  "optional": true,
+                  "type": {
+                    "text": "@param {boolean} [options.skipActiveUpdate=false] - When true, skip the active cell\n   *   recomputation. Used by arrow key handlers that manage the active cell themselves.\n   * "
+                  }
+                }
+              ],
               "description": "Updates the month and year when the user navigates to the previous calendar month.",
               "privacy": "private",
               "return": {
@@ -5152,6 +5207,16 @@
             {
               "kind": "method",
               "name": "handleNextMonth",
+              "parameters": [
+                {
+                  "name": "options",
+                  "description": "Optional settings.",
+                  "optional": true,
+                  "type": {
+                    "text": "@param {boolean} [options.skipActiveUpdate=false] - When true, skip the active cell\n   *   recomputation. Used by arrow key handlers that manage the active cell themselves.\n   * "
+                  }
+                }
+              ],
               "description": "Updates the month and year when the user navigates to the next calendar month.",
               "privacy": "private",
               "return": {
@@ -5174,7 +5239,7 @@
             {
               "kind": "method",
               "name": "updateActiveCellForVisibleMonth",
-              "description": "Recomputes and sets the active cell for the newly visible month after\nmonth navigation. Without this, activeCellDate can point at a date in\nthe old month, leaving no tabindex=\"0\" cell in the grid.",
+              "description": "Updates the active cell after month navigation (prev/next buttons).\nAlways moves the active cell to the first enabled date in the newly\nvisible months so that tabbing back to the grid lands on an enabled cell.",
               "privacy": "private",
               "return": {
                 "type": {
@@ -5246,68 +5311,261 @@
             },
             {
               "kind": "method",
-              "name": "setActiveCell",
+              "name": "setActiveCell",
+              "parameters": [
+                {
+                  "name": "date",
+                  "description": "Unix timestamp of the cell to activate.",
+                  "type": {
+                    "text": "Number"
+                  }
+                }
+              ],
+              "description": "Sets the active cell across all months. Only one cell has tabindex=\"0\" at a time.\nUses imperative DOM manipulation — no Lit re-render triggered.\nAlso updates ariaActiveDescendantElement on the grid wrapper so\nscreen readers announce the active cell without moving DOM focus.",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "focusActiveCell",
+              "description": "Focuses the calendar grid wrapper and sets the active cell.\nDOM focus stays on the grid wrapper; the aria-live region\ntells the screen reader which cell is \"active\".",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "handleGridFocusIn",
+              "description": "Shows the activeCell ring when the grid gains focus.",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "handleGridFocusOut",
+              "description": "Hides the activeCell ring when the grid loses focus.",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "computeActiveDate",
+              "parameters": [
+                {
+                  "name": "options",
+                  "default": "{}",
+                  "description": "Optional settings.",
+                  "optional": true,
+                  "type": {
+                    "text": "@param {boolean} [options.skipDateFrom=false] - When true, skip the selected-date\n   *   shortcut (step 1). Used after month navigation so the active cell lands in the\n   *   newly visible month instead of jumping back to the selected date's month.\n   * "
+                  }
+                }
+              ],
+              "description": "Computes the initial active date from data properties alone — no DOM required.\nPriority:\n  1. Selected date (dateFrom) if within range\n  2. Today's date if not disabled (in-range and not blackout)\n  3. First future non-disabled date (scans day-by-day from today up to 1 year)\n  4. First previous non-disabled date (scans day-by-day from today up to 1 year)\n  5. First enabled date in finite [min, max] range\n  5b. First enabled date scanning forward from finite min (unbounded max)\n  5c. First enabled date scanning backward from finite max (unbounded min)\n  6. First in-range date (even if blackout) so focus can land somewhere\n  7. Undefined — no valid target.",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "Number|undefined"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "isDateInRange",
+              "parameters": [
+                {
+                  "name": "targetTs",
+                  "description": "Unix timestamp in seconds.",
+                  "type": {
+                    "text": "Number"
+                  }
+                }
+              ],
+              "description": "Checks if a target date (unix seconds) is within the configured [min, max] range.\nReturns false if the date falls outside the range, preventing navigation\nto months where all dates are disabled.",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "Boolean"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "handleGridKeyDown",
+              "parameters": [
+                {
+                  "name": "event",
+                  "description": "The keyboard event.",
+                  "type": {
+                    "text": "KeyboardEvent"
+                  }
+                }
+              ],
+              "description": "Handles arrow key navigation on the calendar grid wrapper.\nFocus stays on the grid wrapper; only ariaActiveDescendantElement\nand the visual active-cell indicator change.",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "handleMonthBoundary",
+              "parameters": [
+                {
+                  "name": "event",
+                  "description": "The boundary event with direction and source date info.",
+                  "type": {
+                    "text": "CustomEvent"
+                  }
+                }
+              ],
+              "description": "Handles cross-month boundary navigation events from month components.",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "handleCellActivate",
+              "parameters": [
+                {
+                  "name": "event",
+                  "description": "The activation event with target date.",
+                  "type": {
+                    "text": "CustomEvent"
+                  }
+                }
+              ],
+              "description": "Handles cell activation events from month components.",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "handleCellFocused",
+              "parameters": [
+                {
+                  "name": "event",
+                  "description": "The calendar-cell-focused event.",
+                  "type": {
+                    "text": "CustomEvent"
+                  }
+                }
+              ],
+              "description": "Handles focus events from calendar cells.\nUpdates the live region with an SR announcement and triggers\nthe imperative range preview if applicable.",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "buildFocusAnnouncement",
+              "parameters": [
+                {
+                  "name": "date",
+                  "description": "Unix timestamp (seconds) of the focused cell.",
+                  "type": {
+                    "text": "Number"
+                  }
+                }
+              ],
+              "description": "Builds a full SR announcement string for a focused cell date.\nIncludes the localized date, range position, popover content,\nand blackout status.",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "String"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "getRangePositionLabel",
               "parameters": [
                 {
                   "name": "date",
-                  "description": "Unix timestamp of the cell to activate.",
+                  "description": "Unix timestamp (seconds).",
                   "type": {
                     "text": "Number"
                   }
                 }
               ],
-              "description": "Sets the active cell across all months. Only one cell has tabindex=\"0\" at a time.",
+              "description": "Determines the range position label for a given date.",
+              "privacy": "private",
               "return": {
                 "type": {
-                  "text": "void"
+                  "text": "String|null"
                 }
               }
             },
             {
               "kind": "method",
-              "name": "focusActiveCell",
-              "description": "Focuses the currently active cell. If activeCellDate is set but no cell\nhas the active attribute yet, sets it first. Waits for the cell's render\nto complete so the focused button is the final DOM element.",
+              "name": "isDateBlackout",
+              "parameters": [
+                {
+                  "name": "dateTs",
+                  "description": "Unix timestamp (seconds).",
+                  "type": {
+                    "text": "Number"
+                  }
+                }
+              ],
+              "description": "Checks whether a given date is a blackout date.",
+              "privacy": "private",
               "return": {
                 "type": {
-                  "text": "void"
+                  "text": "Boolean"
                 }
               }
             },
             {
               "kind": "method",
-              "name": "computeActiveDate",
+              "name": "updateRangePreview",
               "parameters": [
                 {
-                  "name": "options",
-                  "default": "{}",
-                  "description": "Optional settings.",
-                  "optional": true,
+                  "name": "hoveredDate",
+                  "description": "Unix timestamp of the hovered/focused date.",
                   "type": {
-                    "text": "@param {boolean} [options.skipDateFrom=false] - When true, skip the selected-date\n   *   shortcut (step 1). Used after month navigation so the active cell lands in the\n   *   newly visible month instead of jumping back to the selected date's month.\n   * "
+                    "text": "Number"
                   }
                 }
               ],
-              "description": "Computes the initial active date from data properties alone — no DOM required.\nPriority:\n  1. Selected date (dateFrom) if within range\n  2. Today's date if not disabled (in-range and not blackout)\n  3. First future non-disabled date (scans day-by-day from today up to 1 year)\n  4. First previous non-disabled date (scans day-by-day from today up to 1 year)\n  5. First enabled date in finite [min, max] range\n  5b. First enabled date scanning forward from finite min (unbounded max)\n  5c. First enabled date scanning backward from finite max (unbounded min)\n  6. First in-range date (even if blackout) so focus can land somewhere\n  7. undefined — no valid target",
+              "description": "Updates the range preview classes imperatively across all cells.\nOnly active when in range mode with dateFrom set and dateTo not yet set.",
               "privacy": "private",
               "return": {
                 "type": {
-                  "text": "Number|undefined"
+                  "text": "void"
                 }
               }
             },
             {
               "kind": "method",
-              "name": "handleMonthBoundary",
-              "parameters": [
-                {
-                  "name": "event",
-                  "description": "The boundary event with direction and source date info.",
-                  "type": {
-                    "text": "CustomEvent"
-                  }
-                }
-              ],
-              "description": "Handles cross-month boundary navigation events from month components.",
+              "name": "clearRangePreview",
+              "description": "Clears range preview classes from all cells.",
               "privacy": "private",
               "return": {
                 "type": {
@@ -5317,17 +5575,17 @@
             },
             {
               "kind": "method",
-              "name": "handleCellActivate",
+              "name": "hoveredDateChanged",
               "parameters": [
                 {
                   "name": "event",
-                  "description": "The activation event with target date.",
+                  "description": "The hovered-date-changed event from a month.",
                   "type": {
                     "text": "CustomEvent"
                   }
                 }
               ],
-              "description": "Handles cell activation events from month components.",
+              "description": "Overrides the base class handler to prevent setting `this.hoveredDate`\nas a reactive property. Instead, handles the range preview imperatively.",
               "privacy": "private",
               "return": {
                 "type": {
@@ -5346,6 +5604,17 @@
                 }
               }
             },
+            {
+              "kind": "method",
+              "name": "getOrCreateLiveRegion",
+              "description": "Returns (and lazily creates) an aria-live region inside the dropdown's\n<dialog> element. This placement is critical for two reasons:\n\n1. Inside the dialog's accessible scope — dialog.showModal() makes\n   everything outside the top-layer dialog inert, and desktop modal\n   mode uses _setPageInert() on document.body siblings. A live region\n   on document.body would be invisible to screen readers in both cases.\n\n2. Not nested in shadow DOM — Chrome inconsistently observes aria-live\n   mutations inside shadow DOM across machines and versions. The dialog\n   element is only one shadow root deep (the dropdown bib's shadow DOM),\n   which Chrome handles reliably. The calendar's own shadow DOM (nested\n   inside the bib via slotting) is two+ levels deep and unreliable.",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "HTMLElement"
+                }
+              }
+            },
             {
               "kind": "method",
               "name": "announceSelection",
@@ -5358,7 +5627,27 @@
                   }
                 }
               ],
-              "description": "Announces a date selection via the live region.",
+              "description": "Announces a date selection or focus change via the live region.\nUses requestAnimationFrame to ensure the clear and set happen in\nseparate rendering frames — Chrome may coalesce synchronous or\nmicrotask-deferred mutations into a single accessibility tree update.",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "announceFocusDebounced",
+              "parameters": [
+                {
+                  "name": "dateStr",
+                  "description": "The localized date string to announce.",
+                  "type": {
+                    "text": "String"
+                  }
+                }
+              ],
+              "description": "Debounced version of announceSelection for focus navigation.\nUses the assertive live region with a 150ms debounce so only the\nfinal cell after rapid arrow-key traversal is announced. We\noriginally tried aria-live=\"polite\" here, but VoiceOver treats\npolite as \"wait until idle\" — which never happens during active\nkeyboard navigation — so the announcements were silently dropped.",
               "privacy": "private",
               "return": {
                 "type": {
@@ -5499,6 +5788,16 @@
               "privacy": "private",
               "default": "null"
             },
+            {
+              "kind": "field",
+              "name": "_gridHasFocus",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Whether the #calendarGrid wrapper currently has focus.\nUsed to determine whether the visualFocus ring should be shown.",
+              "privacy": "private",
+              "default": "false"
+            },
             {
               "kind": "field",
               "name": "firstMonthRenderable",
@@ -5514,6 +5813,16 @@
               "privacy": "private",
               "default": "null"
             },
+            {
+              "kind": "field",
+              "name": "disabledDays",
+              "type": {
+                "text": "array"
+              },
+              "description": "Legacy array of disabled-date timestamps.",
+              "privacy": "private",
+              "default": "[]"
+            },
             {
               "kind": "field",
               "name": "numCalendars",
@@ -5555,6 +5864,12 @@
               "default": "undefined",
               "attribute": "dropdown"
             },
+            {
+              "kind": "field",
+              "name": "_calendarInstanceId",
+              "description": "Unique instance ID for the live region element.",
+              "privacy": "private"
+            },
             {
               "kind": "field",
               "name": "calendarEndMonth",
@@ -5966,7 +6281,13 @@
             {
               "kind": "field",
               "name": "commonDisplayValueWrapperClasses",
+              "description": "Common display value wrapper classes.",
               "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "Object"
+                }
+              },
               "readonly": true
             },
             {
@@ -6468,6 +6789,7 @@
               "parameters": [
                 {
                   "name": "event",
+                  "description": "The mouse event from the clear button click.",
                   "type": {
                     "text": "MouseEvent"
                   }
@@ -7331,6 +7653,24 @@
               "default": "false",
               "fieldName": "autoPlacement"
             },
+            {
+              "name": "blackoutDates",
+              "type": {
+                "text": "array"
+              },
+              "description": "Array of dates that cannot be selected. Dates should be in ISO format (YYYY-MM-DD).",
+              "default": "[]",
+              "fieldName": "blackoutDates"
+            },
+            {
+              "name": "blackoutLabel",
+              "type": {
+                "text": "string"
+              },
+              "description": "Label announced for blackout (disabled but in-range) date cells.",
+              "default": "'unavailable'",
+              "fieldName": "blackoutLabel"
+            },
             {
               "name": "calendarEndDate",
               "type": {
@@ -7392,20 +7732,22 @@
               "fieldName": "error"
             },
             {
-              "name": "hasFocus",
+              "name": "format",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "default": "false",
-              "fieldName": "hasFocus"
+              "description": "Specifies the date format. The default is `mm/dd/yyyy`.",
+              "default": "'mm/dd/yyyy'",
+              "fieldName": "format"
             },
             {
-              "name": "hasValue",
+              "name": "fullscreenBreakpoint",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "default": "false",
-              "fieldName": "hasValue"
+              "description": "Defines the screen size breakpoint at which the dropdown switches to fullscreen mode on mobile. `disabled` indicates a dropdown should _never_ enter fullscreen.\n\nWhen expanded, the dropdown will automatically display in fullscreen mode\nif the screen size is equal to or smaller than the selected breakpoint.",
+              "default": "'sm'",
+              "fieldName": "fullscreenBreakpoint"
             },
             {
               "name": "hasAllValues",
@@ -7416,22 +7758,20 @@
               "fieldName": "hasAllValues"
             },
             {
-              "name": "format",
+              "name": "hasFocus",
               "type": {
-                "text": "string"
+                "text": "boolean"
               },
-              "description": "Specifies the date format. The default is `mm/dd/yyyy`.",
-              "default": "'mm/dd/yyyy'",
-              "fieldName": "format"
+              "default": "false",
+              "fieldName": "hasFocus"
             },
             {
-              "name": "fullscreenBreakpoint",
+              "name": "hasValue",
               "type": {
-                "text": "string"
+                "text": "boolean"
               },
-              "description": "Defines the screen size breakpoint at which the dropdown switches to fullscreen mode on mobile. `disabled` indicates a dropdown should _never_ enter fullscreen.\n\nWhen expanded, the dropdown will automatically display in fullscreen mode\nif the screen size is equal to or smaller than the selected breakpoint.",
-              "default": "'sm'",
-              "fieldName": "fullscreenBreakpoint"
+              "default": "false",
+              "fieldName": "hasValue"
             },
             {
               "name": "inputmode",
@@ -7479,6 +7819,13 @@
               "description": "Minimum date. All dates before will be disabled.",
               "fieldName": "minDate"
             },
+            {
+              "name": "monthFirst",
+              "type": {
+                "text": "boolean"
+              },
+              "fieldName": "monthFirst"
+            },
             {
               "name": "monthNames",
               "type": {
@@ -7489,29 +7836,31 @@
               "fieldName": "monthNames"
             },
             {
-              "name": "monthFirst",
+              "name": "navLabelNextMonth",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "fieldName": "monthFirst"
+              "description": "Accessible label for the next month navigation button.",
+              "default": "'Next month'",
+              "fieldName": "navLabelNextMonth"
             },
             {
-              "name": "noFlip",
+              "name": "navLabelPrevMonth",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "description": "If declared, the bib will NOT flip to an alternate position\nwhen there isn't enough space in the specified `placement`.",
-              "default": "false",
-              "fieldName": "noFlip"
+              "description": "Accessible label for the previous month navigation button.",
+              "default": "'Previous month'",
+              "fieldName": "navLabelPrevMonth"
             },
             {
-              "name": "shift",
+              "name": "noFlip",
               "type": {
                 "text": "boolean"
               },
-              "description": "If declared, the dropdown will shift its position to avoid being cut off by the viewport.",
+              "description": "If declared, the bib will NOT flip to an alternate position\nwhen there isn't enough space in the specified `placement`.",
               "default": "false",
-              "fieldName": "shift"
+              "fieldName": "noFlip"
             },
             {
               "name": "noValidate",
@@ -7575,22 +7924,13 @@
               "fieldName": "range"
             },
             {
-              "name": "rangeLabelStart",
-              "type": {
-                "text": "string"
-              },
-              "description": "Label announced for the range start date cell.",
-              "default": "'range start'",
-              "fieldName": "rangeLabelStart"
-            },
-            {
-              "name": "rangeLabelEnd",
+              "name": "rangeLabelAfterRange",
               "type": {
                 "text": "string"
               },
-              "description": "Label announced for the range end date cell.",
-              "default": "'range end'",
-              "fieldName": "rangeLabelEnd"
+              "description": "Label announced for cells after the range (or after start when no end is selected).",
+              "default": "'after range'",
+              "fieldName": "rangeLabelAfterRange"
             },
             {
               "name": "rangeLabelBeforeRange",
@@ -7602,58 +7942,31 @@
               "fieldName": "rangeLabelBeforeRange"
             },
             {
-              "name": "rangeLabelInRange",
-              "type": {
-                "text": "string"
-              },
-              "description": "Label announced for cells within the selected range.",
-              "default": "'in range'",
-              "fieldName": "rangeLabelInRange"
-            },
-            {
-              "name": "rangeLabelAfterRange",
-              "type": {
-                "text": "string"
-              },
-              "description": "Label announced for cells after the range (or after start when no end is selected).",
-              "default": "'after range'",
-              "fieldName": "rangeLabelAfterRange"
-            },
-            {
-              "name": "blackoutDates",
-              "type": {
-                "text": "array"
-              },
-              "description": "Array of dates that cannot be selected. Dates should be in ISO format (YYYY-MM-DD).",
-              "default": "[]",
-              "fieldName": "blackoutDates"
-            },
-            {
-              "name": "blackoutLabel",
+              "name": "rangeLabelEnd",
               "type": {
                 "text": "string"
               },
-              "description": "Label announced for blackout (disabled but in-range) date cells.",
-              "default": "'unavailable'",
-              "fieldName": "blackoutLabel"
+              "description": "Label announced for the range end date cell.",
+              "default": "'range end'",
+              "fieldName": "rangeLabelEnd"
             },
             {
-              "name": "navLabelPrevMonth",
+              "name": "rangeLabelInRange",
               "type": {
                 "text": "string"
               },
-              "description": "Accessible label for the previous month navigation button.",
-              "default": "'Previous month'",
-              "fieldName": "navLabelPrevMonth"
+              "description": "Label announced for cells within the selected range.",
+              "default": "'in range'",
+              "fieldName": "rangeLabelInRange"
             },
             {
-              "name": "navLabelNextMonth",
+              "name": "rangeLabelStart",
               "type": {
                 "text": "string"
               },
-              "description": "Accessible label for the next month navigation button.",
-              "default": "'Next month'",
-              "fieldName": "navLabelNextMonth"
+              "description": "Label announced for the range start date cell.",
+              "default": "'range start'",
+              "fieldName": "rangeLabelStart"
             },
             {
               "name": "referenceDates",
@@ -7712,6 +8025,15 @@
               "description": "Custom help text message to display when validity = `valueMissing`.",
               "fieldName": "setCustomValidityValueMissing"
             },
+            {
+              "name": "shift",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "If declared, the dropdown will shift its position to avoid being cut off by the viewport.",
+              "default": "false",
+              "fieldName": "shift"
+            },
             {
               "name": "stacked",
               "type": {
@@ -8700,7 +9022,7 @@
             {
               "kind": "method",
               "name": "_clearPageInert",
-              "description": "Restores `inert` state on siblings that were tracked by `_setPageInert`.\nPreserves the previous inert state so externally-inerted elements are\nnot inadvertently re-enabled.",
+              "description": "Restores `inert` state on siblings that were tracked by `_setPageInert`.\nUses reference counting so inert is only cleared when the last modal\ndropdown releases a given element. Preserves the original inert state\nso externally-inerted elements are not inadvertently re-enabled.",
               "privacy": "private"
             },
             {