@aurodesignsystem-dev/auro-formkit 0.0.0-pr1488.2 → 0.0.0-pr1489.0

package/custom-elements.json

@@ -128,6 +128,17 @@
               },
               "attribute": "isFullscreen",
               "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "showFooter",
+              "privacy": "public",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "If declared, the footer slot will be rendered even when not in fullscreen mode.",
+              "attribute": "showFooter",
+              "reflects": true
             }
           ],
           "events": [
@@ -159,6 +170,14 @@
               },
               "default": "false",
               "fieldName": "large"
+            },
+            {
+              "name": "showFooter",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "If declared, the footer slot will be rendered even when not in fullscreen mode.",
+              "fieldName": "showFooter"
             }
           ],
           "superclass": {
@@ -4216,7 +4235,7 @@
             {
               "kind": "method",
               "name": "handleHover",
-              "description": "Handles user hover events and dispatches a custom event.",
+              "description": "Handles user hover events and dispatches a custom event.\nAlways dispatches for range pickers so the preview updates correctly.",
               "privacy": "private",
               "return": {
                 "type": {
@@ -4224,6 +4243,51 @@
                 }
               }
             },
+            {
+              "kind": "method",
+              "name": "isOutOfRange",
+              "parameters": [
+                {
+                  "name": "day",
+                  "description": "An object containing the dateFrom and day of month values.",
+                  "type": {
+                    "text": "Object"
+                  }
+                },
+                {
+                  "name": "min",
+                  "description": "The minimum date value.",
+                  "type": {
+                    "text": "Number"
+                  }
+                },
+                {
+                  "name": "max",
+                  "description": "The maximum date value.",
+                  "type": {
+                    "text": "Number"
+                  }
+                }
+              ],
+              "description": "Checks if the current date is outside the valid min/max range.\nOut-of-range cells are not focusable and are hidden from screen readers.",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "Boolean"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "isBlackout",
+              "description": "Checks if the current date is a blackout date (in disabledDays but within range).\nBlackout cells are focusable but not selectable.",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "Boolean"
+                }
+              }
+            },
             {
               "kind": "method",
               "name": "isEnabled",
@@ -4257,7 +4321,7 @@
                   }
                 }
               ],
-              "description": "Checks if the current date is a valid date depending on the min and max values.",
+              "description": "Checks if the current date is disabled based on min/max range or the\nlegacy disabledDays timestamp list.  Sets the `disabled` attribute on the\nhost when the date falls outside the allowed range or appears in\ndisabledDays. Note: blackout dates are handled separately by `isBlackout()`.",
               "privacy": "private",
               "return": {
                 "type": {
@@ -4265,6 +4329,39 @@
                 }
               }
             },
+            {
+              "kind": "method",
+              "name": "getCellId",
+              "description": "Generates a unique cell ID in the format cell-YYYY-MM-DD.",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "String"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "getAriaLabel",
+              "description": "Generates a localized aria-label for the cell button using Intl.DateTimeFormat.\nIncludes range position and blackout status.",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "String"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "getRangePosition",
+              "description": "Determines the range position of this cell relative to the current selection.",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "String|null"
+                }
+              }
+            },
             {
               "kind": "method",
               "name": "isDepartDate",
@@ -4462,6 +4559,31 @@
                 }
               }
             },
+            {
+              "kind": "method",
+              "name": "configurePopover",
+              "description": "Configures the popover instance with the calendar month boundary.\nCalled from firstUpdated and updated because the popover element is only\nrendered after hasPopoverContent becomes true (set by handleSlotContent).",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "focusButton",
+              "description": "Programmatically focuses the cell's interactive button element.",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "renderCellButton"
+            },
             {
               "kind": "field",
               "name": "day",
@@ -4611,6 +4733,27 @@
               "default": "false",
               "attribute": "renderForDateSlot"
             },
+            {
+              "kind": "field",
+              "name": "active",
+              "privacy": "public",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "attribute": "active",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "hasPopoverContent",
+              "privacy": "public",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "attribute": "hasPopoverContent"
+            },
             {
               "kind": "field",
               "name": "runtimeUtils",
@@ -4622,6 +4765,12 @@
             }
           ],
           "events": [
+            {
+              "name": "calendar-cell-activate",
+              "type": {
+                "text": "CustomEvent"
+              }
+            },
             {
               "name": "date-is-hovered",
               "type": {
@@ -4748,6 +4897,22 @@
               },
               "default": "false",
               "fieldName": "renderForDateSlot"
+            },
+            {
+              "name": "active",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "active"
+            },
+            {
+              "name": "hasPopoverContent",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "hasPopoverContent"
             }
           ],
           "superclass": {
@@ -4806,10 +4971,78 @@
                 }
               }
             },
+            {
+              "kind": "method",
+              "name": "getHeadingId",
+              "description": "Returns the unique heading ID for this month, used by aria-labelledby.",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "String"
+                }
+              }
+            },
             {
               "kind": "method",
               "name": "localeChanged",
-              "description": "Determines the current month name based on locale.\nThis is a rewrite of the function used in the class RangeDatepickerCalendar and should not be removed from here.",
+              "description": "Determines the current month name based on locale.\nAlso builds parallel arrays of full day names for abbr attributes.\nThis is a rewrite of the function used in the class RangeDatepickerCalendar and should not be removed from here.",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "renderDayOfWeek",
+              "parameters": [
+                {
+                  "name": "dayOfWeek",
+                  "description": "The short day name.",
+                  "type": {
+                    "text": "String"
+                  }
+                },
+                {
+                  "name": "index",
+                  "description": "The index in the dayNamesOfTheWeek array.",
+                  "type": {
+                    "text": "Number"
+                  }
+                }
+              ],
+              "description": "Renders a day-of-week header with abbr attribute for the full day name.",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "Object"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "getFocusableCells",
+              "description": "Returns all focusable cell elements (enabled + blackout, not out-of-range) in this month.",
+              "return": {
+                "type": {
+                  "text": "Array"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "handleGridKeyDown",
+              "parameters": [
+                {
+                  "name": "event",
+                  "description": "The keyboard event.",
+                  "type": {
+                    "text": "KeyboardEvent"
+                  }
+                }
+              ],
+              "description": "Handles arrow key navigation within the month grid.\nDispatches a cross-month navigation event when the boundary is reached.",
               "privacy": "private",
               "return": {
                 "type": {
@@ -4817,6 +5050,15 @@
                 }
               }
             },
+            {
+              "kind": "method",
+              "name": "renderWeek",
+              "parameters": [
+                {
+                  "name": "week"
+                }
+              ]
+            },
             {
               "kind": "method",
               "name": "renderDay",
@@ -4837,6 +5079,20 @@
               "reflects": true
             }
           ],
+          "events": [
+            {
+              "name": "calendar-month-boundary",
+              "type": {
+                "text": "CustomEvent"
+              }
+            },
+            {
+              "name": "calendar-cell-activate",
+              "type": {
+                "text": "CustomEvent"
+              }
+            }
+          ],
           "attributes": [
             {
               "name": "monthFirst",
@@ -4904,6 +5160,28 @@
                 }
               }
             },
+            {
+              "kind": "method",
+              "name": "announceMonthChange",
+              "description": "Announces the current month and year via the live region after navigation.",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "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.",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
             {
               "kind": "method",
               "name": "renderAllCalendars",
@@ -4946,32 +5224,196 @@
             },
             {
               "kind": "method",
-              "name": "injectSlot",
-              "parameters": [
-                {
-                  "name": "slotName"
-                },
-                {
-                  "name": "nodes"
-                }
-              ]
-            },
-            {
-              "kind": "field",
-              "name": "util",
+              "name": "getMonthComponents",
+              "description": "Gets all rendered month components.",
               "privacy": "private",
-              "default": "new AuroDatepickerUtilities()"
+              "return": {
+                "type": {
+                  "text": "Array"
+                }
+              }
             },
             {
-              "kind": "field",
-              "name": "utilCal",
+              "kind": "method",
+              "name": "getAllFocusableCells",
+              "description": "Gets all focusable cells across all rendered months.",
               "privacy": "private",
-              "default": "new CalendarUtilities()"
+              "return": {
+                "type": {
+                  "text": "Array"
+                }
+              }
             },
             {
-              "kind": "field",
-              "name": "utilCalRender",
-              "privacy": "private",
+              "kind": "method",
+              "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.",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "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.",
+              "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": "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": "scrollToActiveCell",
+              "description": "Scrolls the calendar to ensure the month containing the active cell is visible.",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "announceSelection",
+              "parameters": [
+                {
+                  "name": "dateStr",
+                  "description": "The localized date string to announce.",
+                  "type": {
+                    "text": "String"
+                  }
+                }
+              ],
+              "description": "Announces a date selection via the live region.",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "formatAnnouncementDate",
+              "parameters": [
+                {
+                  "name": "timestamp",
+                  "description": "Unix timestamp in seconds.",
+                  "type": {
+                    "text": "String|Number"
+                  }
+                }
+              ],
+              "description": "Formats a Unix timestamp (seconds) as a localized date string for SR announcements.",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "String"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "injectSlot",
+              "parameters": [
+                {
+                  "name": "slotName"
+                },
+                {
+                  "name": "nodes"
+                }
+              ]
+            },
+            {
+              "kind": "field",
+              "name": "util",
+              "privacy": "private",
+              "default": "new AuroDatepickerUtilities()"
+            },
+            {
+              "kind": "field",
+              "name": "utilCal",
+              "privacy": "private",
+              "default": "new CalendarUtilities()"
+            },
+            {
+              "kind": "field",
+              "name": "utilCalRender",
+              "privacy": "private",
               "default": "new UtilitiesCalendarRender()"
             },
             {
@@ -5047,6 +5489,16 @@
               "attribute": "isFullscreen",
               "reflects": true
             },
+            {
+              "kind": "field",
+              "name": "activeCellDate",
+              "type": {
+                "text": "null"
+              },
+              "description": "The date of the currently active cell (Unix timestamp).\nOnly one cell across the entire calendar has tabindex=\"0\" at a time.",
+              "privacy": "private",
+              "default": "null"
+            },
             {
               "kind": "field",
               "name": "firstMonthRenderable",
@@ -5671,6 +6123,17 @@
                 }
               }
             },
+            {
+              "kind": "method",
+              "name": "focusActiveCellWhenReady",
+              "description": "Attempts to focus the active calendar cell using a rAF retry loop.\nShared by both fullscreen and desktop open paths.",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
             {
               "kind": "method",
               "name": "configureDropdown",
@@ -5822,6 +6285,26 @@
                 }
               }
             },
+            {
+              "kind": "method",
+              "name": "isBlackoutDate",
+              "parameters": [
+                {
+                  "name": "dateStr",
+                  "description": "A date string in the component's configured format.",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "description": "Checks whether a formatted date string matches a blackout date.",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "boolean"
+                }
+              }
+            },
             {
               "kind": "method",
               "name": "validate",
@@ -6151,6 +6634,114 @@
               "attribute": "range",
               "reflects": true
             },
+            {
+              "kind": "field",
+              "name": "rangeLabelStart",
+              "privacy": "public",
+              "type": {
+                "text": "string"
+              },
+              "description": "Label announced for the range start date cell.",
+              "default": "'range start'",
+              "attribute": "rangeLabelStart",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "rangeLabelEnd",
+              "privacy": "public",
+              "type": {
+                "text": "string"
+              },
+              "description": "Label announced for the range end date cell.",
+              "default": "'range end'",
+              "attribute": "rangeLabelEnd",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "rangeLabelBeforeRange",
+              "privacy": "public",
+              "type": {
+                "text": "string"
+              },
+              "description": "Label announced for cells before the range start.",
+              "default": "'before range'",
+              "attribute": "rangeLabelBeforeRange",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "rangeLabelInRange",
+              "privacy": "public",
+              "type": {
+                "text": "string"
+              },
+              "description": "Label announced for cells within the selected range.",
+              "default": "'in range'",
+              "attribute": "rangeLabelInRange",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "rangeLabelAfterRange",
+              "privacy": "public",
+              "type": {
+                "text": "string"
+              },
+              "description": "Label announced for cells after the range (or after start when no end is selected).",
+              "default": "'after range'",
+              "attribute": "rangeLabelAfterRange",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "blackoutDates",
+              "privacy": "public",
+              "type": {
+                "text": "array"
+              },
+              "description": "Array of dates that cannot be selected. Dates should be in ISO format (YYYY-MM-DD).",
+              "default": "[]",
+              "attribute": "blackoutDates",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "blackoutLabel",
+              "privacy": "public",
+              "type": {
+                "text": "string"
+              },
+              "description": "Label announced for blackout (disabled but in-range) date cells.",
+              "default": "'unavailable'",
+              "attribute": "blackoutLabel",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "navLabelPrevMonth",
+              "privacy": "public",
+              "type": {
+                "text": "string"
+              },
+              "description": "Accessible label for the previous month navigation button.",
+              "default": "'Previous month'",
+              "attribute": "navLabelPrevMonth",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "navLabelNextMonth",
+              "privacy": "public",
+              "type": {
+                "text": "string"
+              },
+              "description": "Accessible label for the next month navigation button.",
+              "default": "'Next month'",
+              "attribute": "navLabelNextMonth",
+              "reflects": true
+            },
             {
               "kind": "field",
               "name": "stacked",
@@ -6604,7 +7195,7 @@
               "type": {
                 "text": "string"
               },
-              "description": "Custom help text message to display when validity = `customError`.",
+              "description": "Custom help text message to display when validity = `customError`.\nAlso used as the validation message when a blackout date is typed into the input.",
               "attribute": "setCustomValidityCustomError"
             },
             {
@@ -6714,8 +7305,11 @@
               "description": "Notifies that new slot content has been added to the datepicker."
             },
             {
-              "description": "Notifies that the component value(s) have been validated.",
-              "name": "auroFormElement-validated"
+              "name": "auroFormElement-validated",
+              "type": {
+                "text": "CustomEvent"
+              },
+              "description": "Notifies that the component value(s) have been validated."
             }
           ],
           "attributes": [
@@ -6980,6 +7574,87 @@
               "default": "false",
               "fieldName": "range"
             },
+            {
+              "name": "rangeLabelStart",
+              "type": {
+                "text": "string"
+              },
+              "description": "Label announced for the range start date cell.",
+              "default": "'range start'",
+              "fieldName": "rangeLabelStart"
+            },
+            {
+              "name": "rangeLabelEnd",
+              "type": {
+                "text": "string"
+              },
+              "description": "Label announced for the range end date cell.",
+              "default": "'range end'",
+              "fieldName": "rangeLabelEnd"
+            },
+            {
+              "name": "rangeLabelBeforeRange",
+              "type": {
+                "text": "string"
+              },
+              "description": "Label announced for cells before the range start.",
+              "default": "'before range'",
+              "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",
+              "type": {
+                "text": "string"
+              },
+              "description": "Label announced for blackout (disabled but in-range) date cells.",
+              "default": "'unavailable'",
+              "fieldName": "blackoutLabel"
+            },
+            {
+              "name": "navLabelPrevMonth",
+              "type": {
+                "text": "string"
+              },
+              "description": "Accessible label for the previous month navigation button.",
+              "default": "'Previous month'",
+              "fieldName": "navLabelPrevMonth"
+            },
+            {
+              "name": "navLabelNextMonth",
+              "type": {
+                "text": "string"
+              },
+              "description": "Accessible label for the next month navigation button.",
+              "default": "'Next month'",
+              "fieldName": "navLabelNextMonth"
+            },
             {
               "name": "referenceDates",
               "type": {
@@ -7010,7 +7685,7 @@
               "type": {
                 "text": "string"
               },
-              "description": "Custom help text message to display when validity = `customError`.",
+              "description": "Custom help text message to display when validity = `customError`.\nAlso used as the validation message when a blackout date is typed into the input.",
               "fieldName": "setCustomValidityCustomError"
             },
             {
@@ -7151,7 +7826,7 @@
           "type": {
             "text": "object"
           },
-          "default": "{ Escape(component, evt) { if (!component.dropdown || !component.dropdown.isPopoverVisible) { return; } // Prevent the Escape key from bubbling up and closing any parent dialogs / drawers / popups. // Because stopPropagation prevents the document-level floatingUI keydown handler from // seeing this event, we must also close the dropdown explicitly. evt.stopPropagation(); component.dropdown.hide(); }, }"
+          "default": "{ Escape(component, evt, ctx) { if (!ctx.isExpanded) { return; } // Stop propagation so parent containers (auro-dialog, auro-drawer) // don't also react to Escape. evt.stopPropagation(); evt.preventDefault(); component.hideBib(); }, Enter(component, evt, ctx) { if (ctx.isExpanded) { return; } // Only open from the trigger input, not the clear button or other internal elements. // evt.target is retargeted to the host in shadow DOM, so use composedPath() // to find the real origin. The clear button is rendered with class \"clearBtn\". const path = evt.composedPath(); if (path.some(el => el.classList?.contains('clearBtn'))) { return; } evt.preventDefault(); component.dropdown.show(); }, ' '(component, evt, ctx) { if (ctx.isExpanded) { return; } // Only open from the trigger input, not the clear button or other internal elements. // evt.target is retargeted to the host in shadow DOM, so use composedPath() // to find the real origin. The clear button is rendered with class \"clearBtn\". const path = evt.composedPath(); if (path.some(el => el.classList?.contains('clearBtn'))) { return; } evt.preventDefault(); component.dropdown.show(); }, }"
         }
       ],
       "exports": [
@@ -8005,6 +8680,29 @@
               "name": "updateFocusTrap",
               "privacy": "private"
             },
+            {
+              "kind": "method",
+              "name": "_getActiveElements",
+              "description": "Returns the chain of active (focused) elements through shadow roots.",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "Array<HTMLElement>"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "_setPageInert",
+              "description": "Sets `inert` on sibling elements of the dropdown's top-level host\nso that content outside the dropdown is not interactive while the modal is open.\nWalks up through shadow DOM boundaries to find the outermost host element\nin the light DOM, then sets `inert` on siblings at each ancestor level\nto ensure all page content outside the host subtree is inert.",
+              "privacy": "private"
+            },
+            {
+              "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.",
+              "privacy": "private"
+            },
             {
               "kind": "method",
               "name": "handleFocusout",
@@ -8311,6 +9009,17 @@
               "attribute": "autoPlacement",
               "reflects": true
             },
+            {
+              "kind": "field",
+              "name": "desktopModal",
+              "privacy": "public",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "If declared, the dropdown will behave as a modal dialog when in a desktop viewport size.",
+              "attribute": "desktopModal",
+              "reflects": true
+            },
             {
               "kind": "field",
               "name": "disableEventShow",
@@ -8617,6 +9326,14 @@
               "description": "If declared, bib's position will be automatically calculated where to appear.",
               "fieldName": "autoPlacement"
             },
+            {
+              "name": "desktopModal",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "If declared, the dropdown will behave as a modal dialog when in a desktop viewport size.",
+              "fieldName": "desktopModal"
+            },
             {
               "name": "disableEventShow",
               "type": {