@aurodesignsystem-dev/auro-formkit 0.0.0-pr1628.5 → 0.0.0-pr1628.6

package/components/input/dist/utilities.d.ts

@@ -5,6 +5,9 @@
  * @returns {string} The locale's date format in lowercase.
  */
 export function getDateFormatFromLocale(locale: string): string;
+/**
+ * Helpers that set up input masks and convert between the text shown in the field, `Date` objects, and ISO date strings (`YYYY-MM-DD`), for one locale and date format.
+ */
 export class AuroInputUtilities {
     /**
      * Creates a set of date and mask helpers for one locale and format.
@@ -17,7 +20,15 @@ export class AuroInputUtilities {
         format?: string | undefined;
     });
     locale: string;
+    /**
+     * Sets the date format to use instead of the locale's format, such as `mm/dd/yyyy`. `updateFormat()` also sets it.
+     * @type {string|undefined}
+     */
     overrideFormat: string | undefined;
+    /**
+     * The `Intl.DateTimeFormat` date formatter for the helpers' locale. The helpers don't currently use it.
+     * @type {Intl.DateTimeFormat}
+     */
     formatter: Intl.DateTimeFormat;
     /**
      * Gets the uppercase date mask for the instance's locale, such as `MM/DD/YYYY` for `en-US`.

package/components/menu/demo/accessibility.md

@@ -1,4 +1,4 @@
-<auro-header level="1" id="overview">Menu - Accessibility</auro-header>
+<auro-header level="1" id="overview">Menu: Accessibility</auro-header>
 <div class="contentWrapper">
 <div class="mainContent">
 <div class="scrollWrapper">

package/components/menu/demo/customize.md

@@ -1,4 +1,4 @@
-<auro-header level="1" id="overview">Menu - Customize</auro-header>
+<auro-header level="1" id="overview">Menu: Customize</auro-header>
 <div class="contentWrapper">
 <nav>
 <auro-nav anchorNavContent=".scrollWrapper">

package/components/menu/demo/design.md

@@ -1,4 +1,4 @@
-<auro-header level="1" id="overview">Menu - Design</auro-header>
+<auro-header level="1" id="overview">Menu: Design</auro-header>
 <div class="contentWrapper">
 <div class="mainContent">
 <div class="scrollWrapper">

package/components/menu/demo/getting-started.md

@@ -1,4 +1,4 @@
-<auro-header level="1" id="overview">Menu - Getting started</auro-header>
+<auro-header level="1" id="overview">Menu: Getting started</auro-header>
 <div class="contentWrapper">
 <nav>
 <auro-nav anchorNavContent=".scrollWrapper">

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

@@ -632,7 +632,7 @@ class AuroMenu extends AuroElement {
       },
 
       /**
-       * Indent level for submenus.
+       * Holds how deeply a nested menu is indented, which sets how many spacers its options get.
        * @private
        */
       level: {
@@ -804,8 +804,8 @@ class AuroMenu extends AuroElement {
   }
 
   /**
-   * Formatted value based on `multiSelect` state.
-   * Default type is `String`, changing to `Array<String>` when `multiSelect` is true.
+   * Gets `value` in the shape the menu works with: the string itself, or, in multi-select mode,
+   * an array of values parsed from the JSON array string.
    * @private
    * @returns {String|Array<String>}
    */
@@ -1615,7 +1615,7 @@ class AuroMenu extends AuroElement {
   }
 
   /**
-   * Handles keyboard navigation and selection.
+   * Called when a key is pressed in the menu. The arrow keys move the active option, and Enter and Tab select it.
    * @private
    * @param {KeyboardEvent} event - The keydown event.
    */
@@ -1641,7 +1641,7 @@ class AuroMenu extends AuroElement {
   }
 
   /**
-   * Handles option selection via click events from menuoptions.
+   * Called when an option fires `auroMenuOption-click`. Selects the clicked option, unless the menu is disabled or nested in another menu.
    * @private
    * @param {CustomEvent} event - The auroMenuOption-click event.
    */
@@ -1661,7 +1661,7 @@ class AuroMenu extends AuroElement {
   }
 
   /**
-   * Handles option hover events.
+   * Called when the pointer moves over an option. Makes it the active option, unless it can't be highlighted.
    * @private
    * @param {CustomEvent} event - The `auroMenuOption-mouseover` event.
    */
@@ -1685,7 +1685,7 @@ class AuroMenu extends AuroElement {
   }
 
   /**
-   * Handles slot change events.
+   * Called when the menu's content changes. Sets the menu up again, and re-applies a `value` that was set before the options arrived.
    * @private
    */
   handleSlotChange() {
@@ -1781,7 +1781,7 @@ class AuroMenu extends AuroElement {
   }
 
   /**
-   * Handles custom events defined on options.
+   * Fires the event named in the option's `event` attribute, then `auroMenu-customEventFired`, with the option in `detail.option`.
    * @private
    * @param {HTMLElement} option - Option with custom event.
    */
@@ -1801,6 +1801,7 @@ class AuroMenu extends AuroElement {
   }
 
   /**
+   * Checks whether two selections hold the same options, in any order.
    * @private
    * @param {any} current - The current selection.
    * @param {any} next - The new selection to compare.
@@ -2283,7 +2284,7 @@ class AuroMenuOption extends AuroElement {
   }
 
   /**
-   * Handles click events on the menu option.
+   * Called when the option is clicked. Fires `auroMenuOption-click`, unless the option or a menu containing it is disabled.
    * @private
    */
   handleClick() {

package/components/menu/demo/keyboard-behavior.md

@@ -1,4 +1,4 @@
-<auro-header level="1" id="overview">Menu - Keyboard behavior</auro-header>
+<auro-header level="1" id="overview">Menu: Keyboard behavior</auro-header>
 <div class="contentWrapper">
 <div class="mainContent">
 <div class="scrollWrapper">

package/components/menu/demo/voiceover.md

@@ -1,4 +1,4 @@
-<auro-header level="1" id="overview">Menu - VoiceOver behavior</auro-header>
+<auro-header level="1" id="overview">Menu: VoiceOver behavior</auro-header>
 <p>This page documents the VoiceOver experience when using the <code>&lt;auro-menu&gt;</code> component. It covers announcements and interactions for menu navigation and option selection.</p>
 <div class="note"><strong>Note:</strong> In the standard integrations (<code>&lt;auro-select&gt;</code>, <code>&lt;auro-combobox&gt;</code>), keyboard focus stays on the parent trigger or input and <strong>doesn't</strong> move into the menu. The parent captures keys and drives the menu, and the active option is announced via <code>aria-activedescendant</code> on the trigger rather than by moving DOM focus between options. The focus-on-the-menu behavior described alongside the standalone case below only applies when an author makes <code>&lt;auro-menu&gt;</code> itself focusable (for example, <code>tabindex="0"</code>).</p>
 <auro-header level="2" id="voiceOverInteractiveAnnouncements">Interactive announcements</auro-header>

package/components/menu/dist/auro-menu.d.ts

@@ -63,7 +63,7 @@ export class AuroMenu extends AuroElement {
             reflect: boolean;
         };
         /**
-         * Indent level for submenus.
+         * Holds how deeply a nested menu is indented, which sets how many spacers its options get.
          * @private
          */
         level: {
@@ -135,25 +135,25 @@ export class AuroMenu extends AuroElement {
     loading: boolean;
     multiSelect: boolean;
     /**
-     * Handles keyboard navigation and selection.
+     * Called when a key is pressed in the menu. The arrow keys move the active option, and Enter and Tab select it.
      * @private
      * @param {KeyboardEvent} event - The keydown event.
      */
     private handleKeyDown;
     /**
-     * Handles option selection via click events from menuoptions.
+     * Called when an option fires `auroMenuOption-click`. Selects the clicked option, unless the menu is disabled or nested in another menu.
      * @private
      * @param {CustomEvent} event - The auroMenuOption-click event.
      */
     private handleMouseSelect;
     /**
-     * Handles option hover events.
+     * Called when the pointer moves over an option. Makes it the active option, unless it can't be highlighted.
      * @private
      * @param {CustomEvent} event - The `auroMenuOption-mouseover` event.
      */
     private handleOptionHover;
     /**
-     * Handles slot change events.
+     * Called when the menu's content changes. Sets the menu up again, and re-applies a `value` that was set before the options arrived.
      * @private
      */
     private handleSlotChange;
@@ -203,8 +203,8 @@ export class AuroMenu extends AuroElement {
      */
     readonly get currentLabel(): string;
     /**
-     * Formatted value based on `multiSelect` state.
-     * Default type is `String`, changing to `Array<String>` when `multiSelect` is true.
+     * Gets `value` in the shape the menu works with: the string itself, or, in multi-select mode,
+     * an array of values parsed from the JSON array string.
      * @private
      * @returns {String|Array<String>}
      */
@@ -316,7 +316,7 @@ export class AuroMenu extends AuroElement {
      */
     updateActiveOption(indexOrOption: number | HTMLElement): void;
     /**
-     * Handles custom events defined on options.
+     * Fires the event named in the option's `event` attribute, then `auroMenu-customEventFired`, with the option in `detail.option`.
      * @private
      * @param {HTMLElement} option - Option with custom event.
      */
@@ -328,6 +328,7 @@ export class AuroMenu extends AuroElement {
      */
     private notifySelectionChange;
     /**
+     * Checks whether two selections hold the same options, in any order.
      * @private
      * @param {any} current - The current selection.
      * @param {any} next - The new selection to compare.

package/components/menu/dist/auro-menuoption.d.ts

@@ -175,7 +175,7 @@ export class AuroMenuOption extends AuroElement {
      */
     attachTo(): void;
     /**
-     * Handles click events on the menu option.
+     * Called when the option is clicked. Fires `auroMenuOption-click`, unless the option or a menu containing it is disabled.
      * @private
      */
     private handleClick;

package/components/menu/dist/index.js

@@ -637,7 +637,7 @@ class AuroMenu extends AuroElement {
       },
 
       /**
-       * Indent level for submenus.
+       * Holds how deeply a nested menu is indented, which sets how many spacers its options get.
        * @private
        */
       level: {
@@ -809,8 +809,8 @@ class AuroMenu extends AuroElement {
   }
 
   /**
-   * Formatted value based on `multiSelect` state.
-   * Default type is `String`, changing to `Array<String>` when `multiSelect` is true.
+   * Gets `value` in the shape the menu works with: the string itself, or, in multi-select mode,
+   * an array of values parsed from the JSON array string.
    * @private
    * @returns {String|Array<String>}
    */
@@ -1620,7 +1620,7 @@ class AuroMenu extends AuroElement {
   }
 
   /**
-   * Handles keyboard navigation and selection.
+   * Called when a key is pressed in the menu. The arrow keys move the active option, and Enter and Tab select it.
    * @private
    * @param {KeyboardEvent} event - The keydown event.
    */
@@ -1646,7 +1646,7 @@ class AuroMenu extends AuroElement {
   }
 
   /**
-   * Handles option selection via click events from menuoptions.
+   * Called when an option fires `auroMenuOption-click`. Selects the clicked option, unless the menu is disabled or nested in another menu.
    * @private
    * @param {CustomEvent} event - The auroMenuOption-click event.
    */
@@ -1666,7 +1666,7 @@ class AuroMenu extends AuroElement {
   }
 
   /**
-   * Handles option hover events.
+   * Called when the pointer moves over an option. Makes it the active option, unless it can't be highlighted.
    * @private
    * @param {CustomEvent} event - The `auroMenuOption-mouseover` event.
    */
@@ -1690,7 +1690,7 @@ class AuroMenu extends AuroElement {
   }
 
   /**
-   * Handles slot change events.
+   * Called when the menu's content changes. Sets the menu up again, and re-applies a `value` that was set before the options arrived.
    * @private
    */
   handleSlotChange() {
@@ -1786,7 +1786,7 @@ class AuroMenu extends AuroElement {
   }
 
   /**
-   * Handles custom events defined on options.
+   * Fires the event named in the option's `event` attribute, then `auroMenu-customEventFired`, with the option in `detail.option`.
    * @private
    * @param {HTMLElement} option - Option with custom event.
    */
@@ -1806,6 +1806,7 @@ class AuroMenu extends AuroElement {
   }
 
   /**
+   * Checks whether two selections hold the same options, in any order.
    * @private
    * @param {any} current - The current selection.
    * @param {any} next - The new selection to compare.
@@ -2275,7 +2276,7 @@ class AuroMenuOption extends AuroElement {
   }
 
   /**
-   * Handles click events on the menu option.
+   * Called when the option is clicked. Fires `auroMenuOption-click`, unless the option or a menu containing it is disabled.
    * @private
    */
   handleClick() {

package/components/menu/dist/registered.js

@@ -598,7 +598,7 @@ class AuroMenu extends AuroElement {
       },
 
       /**
-       * Indent level for submenus.
+       * Holds how deeply a nested menu is indented, which sets how many spacers its options get.
        * @private
        */
       level: {
@@ -770,8 +770,8 @@ class AuroMenu extends AuroElement {
   }
 
   /**
-   * Formatted value based on `multiSelect` state.
-   * Default type is `String`, changing to `Array<String>` when `multiSelect` is true.
+   * Gets `value` in the shape the menu works with: the string itself, or, in multi-select mode,
+   * an array of values parsed from the JSON array string.
    * @private
    * @returns {String|Array<String>}
    */
@@ -1581,7 +1581,7 @@ class AuroMenu extends AuroElement {
   }
 
   /**
-   * Handles keyboard navigation and selection.
+   * Called when a key is pressed in the menu. The arrow keys move the active option, and Enter and Tab select it.
    * @private
    * @param {KeyboardEvent} event - The keydown event.
    */
@@ -1607,7 +1607,7 @@ class AuroMenu extends AuroElement {
   }
 
   /**
-   * Handles option selection via click events from menuoptions.
+   * Called when an option fires `auroMenuOption-click`. Selects the clicked option, unless the menu is disabled or nested in another menu.
    * @private
    * @param {CustomEvent} event - The auroMenuOption-click event.
    */
@@ -1627,7 +1627,7 @@ class AuroMenu extends AuroElement {
   }
 
   /**
-   * Handles option hover events.
+   * Called when the pointer moves over an option. Makes it the active option, unless it can't be highlighted.
    * @private
    * @param {CustomEvent} event - The `auroMenuOption-mouseover` event.
    */
@@ -1651,7 +1651,7 @@ class AuroMenu extends AuroElement {
   }
 
   /**
-   * Handles slot change events.
+   * Called when the menu's content changes. Sets the menu up again, and re-applies a `value` that was set before the options arrived.
    * @private
    */
   handleSlotChange() {
@@ -1747,7 +1747,7 @@ class AuroMenu extends AuroElement {
   }
 
   /**
-   * Handles custom events defined on options.
+   * Fires the event named in the option's `event` attribute, then `auroMenu-customEventFired`, with the option in `detail.option`.
    * @private
    * @param {HTMLElement} option - Option with custom event.
    */
@@ -1767,6 +1767,7 @@ class AuroMenu extends AuroElement {
   }
 
   /**
+   * Checks whether two selections hold the same options, in any order.
    * @private
    * @param {any} current - The current selection.
    * @param {any} next - The new selection to compare.
@@ -2236,7 +2237,7 @@ class AuroMenuOption extends AuroElement {
   }
 
   /**
-   * Handles click events on the menu option.
+   * Called when the option is clicked. Fires `auroMenuOption-click`, unless the option or a menu containing it is disabled.
    * @private
    */
   handleClick() {

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

@@ -1338,7 +1338,7 @@ class AuroHelpText extends i$2 {
   }
 }
 
-var formkitVersion = '202611081948';
+var formkitVersion = '202611082047';
 
 // Copyright (c) Alaska Air. All right reserved. Licensed under the Apache-2.0 license
 // See LICENSE in the project root for license information.

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

@@ -1338,7 +1338,7 @@ class AuroHelpText extends i$2 {
   }
 }
 
-var formkitVersion = '202611081948';
+var formkitVersion = '202611082047';
 
 // Copyright (c) Alaska Air. All right reserved. Licensed under the Apache-2.0 license
 // See LICENSE in the project root for license information.

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

@@ -1338,7 +1338,7 @@ class AuroHelpText extends i$2 {
   }
 }
 
-var formkitVersion = '202611081948';
+var formkitVersion = '202611082047';
 
 // Copyright (c) Alaska Air. All right reserved. Licensed under the Apache-2.0 license
 // See LICENSE in the project root for license information.

package/components/radio/dist/index.js

@@ -1277,7 +1277,7 @@ class AuroHelpText extends LitElement {
   }
 }
 
-var formkitVersion = '202611081948';
+var formkitVersion = '202611082047';
 
 // Copyright (c) Alaska Air. All right reserved. Licensed under the Apache-2.0 license
 // See LICENSE in the project root for license information.

package/components/radio/dist/registered.js

@@ -1277,7 +1277,7 @@ class AuroHelpText extends LitElement {
   }
 }
 
-var formkitVersion = '202611081948';
+var formkitVersion = '202611082047';
 
 // Copyright (c) Alaska Air. All right reserved. Licensed under the Apache-2.0 license
 // See LICENSE in the project root for license information.

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

@@ -5185,7 +5185,7 @@ let AuroHelpText$1 = class AuroHelpText extends i$2 {
   }
 };
 
-var formkitVersion$1 = '202611081948';
+var formkitVersion$1 = '202611082047';
 
 /**
  * Shared base class for layout-aware Auro form components, such as `auro-input`, `auro-select`, and `auro-menu`.
@@ -7525,7 +7525,7 @@ class AuroHelpText extends i$2 {
   }
 }
 
-var formkitVersion = '202611081948';
+var formkitVersion = '202611082047';
 
 var styleCss$2 = i$5`.util_displayInline{display:inline}.util_displayInlineBlock{display:inline-block}.util_displayBlock{display:block}.util_displayFlex{display:flex}.util_displayHidden{display:none}.util_displayHiddenVisually{position:absolute;overflow:hidden;clip:rect(1px, 1px, 1px, 1px);width:1px;height:1px;padding:0;border:0}.body-default{font-family:var(--wcss-body-family, "AS Circular"),system-ui,-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif;font-size:var(--wcss-body-default-font-size, 1rem);font-variant-ligatures:none;font-weight:var(--wcss-body-default-weight, );line-height:var(--wcss-body-default-line-height, 1.5rem)}.body-default,.body-default-emphasized{letter-spacing:var(--wcss-body-letter-spacing, 0)}.body-default-emphasized{font-family:var(--wcss-body-family, "AS Circular"),system-ui,-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif;font-size:var(--wcss-body-default-emphasized-font-size, 1rem);font-variant-ligatures:none;font-weight:var(--wcss-body-default-emphasized-weight, );line-height:var(--wcss-body-default-emphasized-line-height, 1.5rem)}.body-lg{font-family:var(--wcss-body-family, "AS Circular"),system-ui,-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif;font-size:var(--wcss-body-lg-font-size, 1.125rem);font-variant-ligatures:none;font-weight:var(--wcss-body-lg-weight, );line-height:var(--wcss-body-lg-line-height, 1.625rem)}.body-lg,.body-lg-emphasized{letter-spacing:var(--wcss-body-letter-spacing, 0)}.body-lg-emphasized{font-family:var(--wcss-body-family, "AS Circular"),system-ui,-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif;font-size:var(--wcss-body-lg-emphasized-font-size, 1.125rem);font-variant-ligatures:none;font-weight:var(--wcss-body-lg-emphasized-weight, );line-height:var(--wcss-body-lg-emphasized-line-height, 1.625rem)}.body-sm{font-family:var(--wcss-body-family, "AS Circular"),system-ui,-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif;font-size:var(--wcss-body-sm-font-size, 0.875rem);font-variant-ligatures:none;font-weight:var(--wcss-body-sm-weight, );line-height:var(--wcss-body-sm-line-height, 1.25rem)}.body-sm,.body-sm-emphasized{letter-spacing:var(--wcss-body-letter-spacing, 0)}.body-sm-emphasized{font-family:var(--wcss-body-family, "AS Circular"),system-ui,-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif;font-size:var(--wcss-body-sm-emphasized-font-size, 0.875rem);font-variant-ligatures:none;font-weight:var(--wcss-body-sm-emphasized-weight, );line-height:var(--wcss-body-sm-emphasized-line-height, 1.25rem)}.body-xs{font-family:var(--wcss-body-family, "AS Circular"),system-ui,-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif;font-size:var(--wcss-body-xs-font-size, 0.75rem);font-variant-ligatures:none;font-weight:var(--wcss-body-xs-weight, );line-height:var(--wcss-body-xs-line-height, 1rem)}.body-xs,.body-xs-emphasized{letter-spacing:var(--wcss-body-letter-spacing, 0)}.body-xs-emphasized{font-family:var(--wcss-body-family, "AS Circular"),system-ui,-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif;font-size:var(--wcss-body-xs-emphasized-font-size, 0.75rem);font-variant-ligatures:none;font-weight:var(--wcss-body-xs-emphasized-weight, );line-height:var(--wcss-body-xs-emphasized-line-height, 1rem)}.body-2xs{font-family:var(--wcss-body-family, "AS Circular"),system-ui,-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif;font-size:var(--wcss-body-2xs-font-size, 0.625rem);font-variant-ligatures:none;font-weight:var(--wcss-body-2xs-weight, );line-height:var(--wcss-body-2xs-line-height, 0.875rem)}.body-2xs,.body-2xs-emphasized{letter-spacing:var(--wcss-body-letter-spacing, 0)}.body-2xs-emphasized{font-family:var(--wcss-body-family, "AS Circular"),system-ui,-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif;font-size:var(--wcss-body-2xs-emphasized-font-size, 0.625rem);font-variant-ligatures:none;font-weight:var(--wcss-body-2xs-emphasized-weight, );line-height:var(--wcss-body-2xs-emphasized-line-height, 0.875rem)}.display-2xl{font-family:var(--wcss-display-2xl-family, "AS Circular"),var(--wcss-display-2xl-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-size:var(--wcss-display-2xl-font-size, clamp(3.5rem, 6vw, 5.375rem));font-variant-ligatures:none;font-weight:var(--wcss-display-2xl-weight, 300);letter-spacing:var(--wcss-display-2xl-letter-spacing, 0);line-height:var(--wcss-display-2xl-line-height, 1.3)}.display-xl{font-family:var(--wcss-display-xl-family, "AS Circular"),var(--wcss-display-xl-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-size:var(--wcss-display-xl-font-size, clamp(3rem, 5.3333333333vw, 4.5rem));font-variant-ligatures:none;font-weight:var(--wcss-display-xl-weight, 300);letter-spacing:var(--wcss-display-xl-letter-spacing, 0);line-height:var(--wcss-display-xl-line-height, 1.3)}.display-lg{font-family:var(--wcss-display-lg-family, "AS Circular"),var(--wcss-display-lg-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-size:var(--wcss-display-lg-font-size, clamp(2.75rem, 4.6666666667vw, 4rem));font-variant-ligatures:none;font-weight:var(--wcss-display-lg-weight, 300);letter-spacing:var(--wcss-display-lg-letter-spacing, 0);line-height:var(--wcss-display-lg-line-height, 1.3)}.display-md{font-family:var(--wcss-display-md-family, "AS Circular"),var(--wcss-display-md-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-size:var(--wcss-display-md-font-size, clamp(2.5rem, 4vw, 3.5rem));font-variant-ligatures:none;font-weight:var(--wcss-display-md-weight, 300);letter-spacing:var(--wcss-display-md-letter-spacing, 0);line-height:var(--wcss-display-md-line-height, 1.3)}.display-sm{font-family:var(--wcss-display-sm-family, "AS Circular"),var(--wcss-display-sm-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-size:var(--wcss-display-sm-font-size, clamp(2rem, 3.6666666667vw, 3rem));font-variant-ligatures:none;font-weight:var(--wcss-display-sm-weight, 300);letter-spacing:var(--wcss-display-sm-letter-spacing, 0);line-height:var(--wcss-display-sm-line-height, 1.3)}.display-xs{font-family:var(--wcss-display-xs-family, "AS Circular"),var(--wcss-display-xs-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-size:var(--wcss-display-xs-font-size, clamp(1.75rem, 3vw, 2.375rem));font-variant-ligatures:none;font-weight:var(--wcss-display-xs-weight, 300);letter-spacing:var(--wcss-display-xs-letter-spacing, 0);line-height:var(--wcss-display-xs-line-height, 1.3)}.heading-xl{font-family:var(--wcss-heading-xl-family, "AS Circular"),var(--wcss-heading-xl-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-size:var(--wcss-heading-xl-font-size, clamp(2rem, 3vw, 2.5rem));font-variant-ligatures:none;font-weight:var(--wcss-heading-xl-weight, 300);letter-spacing:var(--wcss-heading-xl-letter-spacing, 0);line-height:var(--wcss-heading-xl-line-height, 1.3)}.heading-lg{font-family:var(--wcss-heading-lg-family, "AS Circular"),var(--wcss-heading-lg-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-size:var(--wcss-heading-lg-font-size, clamp(1.75rem, 2.6666666667vw, 2.25rem));font-variant-ligatures:none;font-weight:var(--wcss-heading-lg-weight, 300);letter-spacing:var(--wcss-heading-lg-letter-spacing, 0);line-height:var(--wcss-heading-lg-line-height, 1.3)}.heading-md{font-family:var(--wcss-heading-md-family, "AS Circular"),var(--wcss-heading-md-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-size:var(--wcss-heading-md-font-size, clamp(1.625rem, 2.3333333333vw, 1.75rem));font-variant-ligatures:none;font-weight:var(--wcss-heading-md-weight, 300);letter-spacing:var(--wcss-heading-md-letter-spacing, 0);line-height:var(--wcss-heading-md-line-height, 1.3)}.heading-sm{font-family:var(--wcss-heading-sm-family, "AS Circular"),var(--wcss-heading-sm-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-size:var(--wcss-heading-sm-font-size, clamp(1.375rem, 2vw, 1.5rem));font-variant-ligatures:none;font-weight:var(--wcss-heading-sm-weight, 300);letter-spacing:var(--wcss-heading-sm-letter-spacing, 0);line-height:var(--wcss-heading-sm-line-height, 1.3)}.heading-xs{font-family:var(--wcss-heading-xs-family, "AS Circular"),var(--wcss-heading-xs-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-size:var(--wcss-heading-xs-font-size, clamp(1.25rem, 1.6666666667vw, 1.25rem));font-variant-ligatures:none;font-weight:var(--wcss-heading-xs-weight, 300);letter-spacing:var(--wcss-heading-xs-letter-spacing, 0);line-height:var(--wcss-heading-xs-line-height, 1.3)}.heading-2xs{font-family:var(--wcss-heading-2xs-family, "AS Circular"),var(--wcss-heading-2xs-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-size:var(--wcss-heading-2xs-font-size, clamp(1.125rem, 1.5vw, 1.125rem));font-variant-ligatures:none;font-weight:var(--wcss-heading-2xs-weight, 300);letter-spacing:var(--wcss-heading-2xs-letter-spacing, 0);line-height:var(--wcss-heading-2xs-line-height, 1.3)}.accent-2xl{font-family:var(--wcss-accent-2xl-family, "Good OT"),var(--wcss-accent-2xl-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-size:var(--wcss-accent-2xl-font-size, clamp(2rem, 3.1666666667vw, 2.375rem));font-variant-ligatures:none;font-weight:var(--wcss-accent-2xl-weight, 450);letter-spacing:var(--wcss-accent-2xl-letter-spacing, 0.05em);line-height:var(--wcss-accent-2xl-line-height, 1)}.accent-2xl,.accent-xl{text-transform:uppercase}.accent-xl{font-family:var(--wcss-accent-xl-family, "Good OT"),var(--wcss-accent-xl-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-size:var(--wcss-accent-xl-font-size, clamp(1.625rem, 2.3333333333vw, 2rem));font-variant-ligatures:none;font-weight:var(--wcss-accent-xl-weight, 450);letter-spacing:var(--wcss-accent-xl-letter-spacing, 0.05em);line-height:var(--wcss-accent-xl-line-height, 1.3)}.accent-lg{font-family:var(--wcss-accent-lg-family, "Good OT"),var(--wcss-accent-lg-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-size:var(--wcss-accent-lg-font-size, clamp(1.5rem, 2.1666666667vw, 1.75rem));font-variant-ligatures:none;font-weight:var(--wcss-accent-lg-weight, 450);letter-spacing:var(--wcss-accent-lg-letter-spacing, 0.05em);line-height:var(--wcss-accent-lg-line-height, 1.3)}.accent-lg,.accent-md{text-transform:uppercase}.accent-md{font-family:var(--wcss-accent-md-family, "Good OT"),var(--wcss-accent-md-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-size:var(--wcss-accent-md-font-size, clamp(1.375rem, 1.8333333333vw, 1.5rem));font-variant-ligatures:none;font-weight:var(--wcss-accent-md-weight, 500);letter-spacing:var(--wcss-accent-md-letter-spacing, 0.05em);line-height:var(--wcss-accent-md-line-height, 1.3)}.accent-sm{font-family:var(--wcss-accent-sm-family, "Good OT"),var(--wcss-accent-sm-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-size:var(--wcss-accent-sm-font-size, clamp(1.125rem, 1.5vw, 1.25rem));font-variant-ligatures:none;font-weight:var(--wcss-accent-sm-weight, 500);letter-spacing:var(--wcss-accent-sm-letter-spacing, 0.05em);line-height:var(--wcss-accent-sm-line-height, 1.3)}.accent-sm,.accent-xs{text-transform:uppercase}.accent-xs{font-family:var(--wcss-accent-xs-family, "Good OT"),var(--wcss-accent-xs-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-size:var(--wcss-accent-xs-font-size, clamp(1rem, 1.3333333333vw, 1rem));font-variant-ligatures:none;font-weight:var(--wcss-accent-xs-weight, 500);letter-spacing:var(--wcss-accent-xs-letter-spacing, 0.1em);line-height:var(--wcss-accent-xs-line-height, 1.3)}.accent-2xs{font-family:var(--wcss-accent-2xs-family, "Good OT"),var(--wcss-accent-2xs-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-size:var(--wcss-accent-2xs-font-size, clamp(0.875rem, 1.1666666667vw, 0.875rem));font-variant-ligatures:none;font-weight:var(--wcss-accent-2xs-weight, 450);letter-spacing:var(--wcss-accent-2xs-letter-spacing, 0.1em);line-height:var(--wcss-accent-2xs-line-height, 1.3);text-transform:uppercase}[auro-dropdown]{--ds-auro-dropdown-trigger-border-color: var(--ds-auro-select-border-color);--ds-auro-dropdown-trigger-background-color: var(--ds-auro-select-background-color);--ds-auro-dropdown-trigger-container-color: var(--ds-auro-select-background-color);--ds-auro-dropdown-trigger-outline-color: var(--ds-auro-select-outline-color)}:host{display:inline-block;text-align:left;vertical-align:top}:host([layout*=emphasized]) [auro-dropdown],:host([layout*=snowflake]) [auro-dropdown]{--ds-auro-select-border-color: transparent}:host([layout*=emphasized]) .mainContent,:host([layout*=snowflake]) .mainContent{text-align:center}.mainContent{position:relative;display:flex;overflow:hidden;flex:1;flex-direction:column;align-items:center;justify-content:center}.valueContainer{max-width:100%}#dropdownLabel,.value,#placeholder{overflow:hidden;text-overflow:ellipsis;white-space:nowrap}#dropdownLabel{display:block}.accents{display:flex;flex-direction:row;align-items:center;justify-content:center}::slotted([slot=typeIcon]){margin-right:var(--ds-size-100, 0.5rem)}.displayValue{display:block}.displayValue:not(.force){display:none}.displayValue:not(.force).hasContent:is(.withValue):not(.hasFocus){display:block}.triggerContent{display:flex;width:100%;box-sizing:border-box;align-items:center;justify-content:center}:host([layout*=emphasized]) .triggerContent{padding:0 var(--ds-size-100, 0.5rem) 0 var(--ds-size-300, 1.5rem)}:host([layout*=snowflake]) .triggerContent{padding:0 var(--ds-size-100, 0.5rem) 0 var(--ds-size-200, 1rem)}:host([layout*=snowflake]) label{padding-block:var(--ds-size-25, 0.125rem)}:host([layout*=classic]) .triggerContent{padding:0 var(--ds-size-100, 0.5rem)}:host([layout*=classic]) .mainContent{align-items:start}:host([layout*=classic]) label{cursor:text}:host([layout*=classic]) .value{height:auto}label{color:var(--ds-auro-select-label-text-color)}:host(:is([validity]:not([validity=valid]))) [auro-dropdown]{--ds-auro-select-border-color: var(--ds-basic-color-status-error, #e31f26);--ds-auro-select-outline-color: var(--ds-basic-color-status-error, #e31f26);--ds-auro-dropdown-helptext-text-color: var(--ds-basic-color-texticon-default, #2a2a2a)}:host([ondark]:is([validity]:not([validity=valid]))) [auro-dropdown],:host([appearance=inverse]:is([validity]:not([validity=valid]))) [auro-dropdown]{--ds-auro-select-border-color: var(--ds-advanced-color-state-error-inverse, #f9a4a8);--ds-auro-select-outline-color: var(--ds-advanced-color-state-error-inverse, #f9a4a8);--ds-auro-dropdown-helptext-text-color: var(--ds-basic-color-texticon-inverse, #ffffff)}#slotHolder{display:none}:host([fluid]){width:100%}:host([disabled]){pointer-events:none;user-select:none}:host([disabled]:not([ondark])) [auro-dropdown],:host([disabled]:not([appearance=inverse])) [auro-dropdown]{--ds-auro-select-border-color: var(--ds-basic-color-border-subtle, #dddddd)}:host(:not([layout*=classic])[disabled][ondark]) [auro-dropdown],:host(:not([layout*=classic])[disabled][appearance=inverse]) [auro-dropdown]{--ds-auro-select-border-color: transparent}`;
 
@@ -9796,7 +9796,7 @@ class AuroMenu extends AuroElement$1 {
       },
 
       /**
-       * Indent level for submenus.
+       * Holds how deeply a nested menu is indented, which sets how many spacers its options get.
        * @private
        */
       level: {
@@ -9968,8 +9968,8 @@ class AuroMenu extends AuroElement$1 {
   }
 
   /**
-   * Formatted value based on `multiSelect` state.
-   * Default type is `String`, changing to `Array<String>` when `multiSelect` is true.
+   * Gets `value` in the shape the menu works with: the string itself, or, in multi-select mode,
+   * an array of values parsed from the JSON array string.
    * @private
    * @returns {String|Array<String>}
    */
@@ -10779,7 +10779,7 @@ class AuroMenu extends AuroElement$1 {
   }
 
   /**
-   * Handles keyboard navigation and selection.
+   * Called when a key is pressed in the menu. The arrow keys move the active option, and Enter and Tab select it.
    * @private
    * @param {KeyboardEvent} event - The keydown event.
    */
@@ -10805,7 +10805,7 @@ class AuroMenu extends AuroElement$1 {
   }
 
   /**
-   * Handles option selection via click events from menuoptions.
+   * Called when an option fires `auroMenuOption-click`. Selects the clicked option, unless the menu is disabled or nested in another menu.
    * @private
    * @param {CustomEvent} event - The auroMenuOption-click event.
    */
@@ -10825,7 +10825,7 @@ class AuroMenu extends AuroElement$1 {
   }
 
   /**
-   * Handles option hover events.
+   * Called when the pointer moves over an option. Makes it the active option, unless it can't be highlighted.
    * @private
    * @param {CustomEvent} event - The `auroMenuOption-mouseover` event.
    */
@@ -10849,7 +10849,7 @@ class AuroMenu extends AuroElement$1 {
   }
 
   /**
-   * Handles slot change events.
+   * Called when the menu's content changes. Sets the menu up again, and re-applies a `value` that was set before the options arrived.
    * @private
    */
   handleSlotChange() {
@@ -10945,7 +10945,7 @@ class AuroMenu extends AuroElement$1 {
   }
 
   /**
-   * Handles custom events defined on options.
+   * Fires the event named in the option's `event` attribute, then `auroMenu-customEventFired`, with the option in `detail.option`.
    * @private
    * @param {HTMLElement} option - Option with custom event.
    */
@@ -10965,6 +10965,7 @@ class AuroMenu extends AuroElement$1 {
   }
 
   /**
+   * Checks whether two selections hold the same options, in any order.
    * @private
    * @param {any} current - The current selection.
    * @param {any} next - The new selection to compare.
@@ -11394,7 +11395,7 @@ class AuroMenuOption extends AuroElement$1 {
   }
 
   /**
-   * Handles click events on the menu option.
+   * Called when the option is clicked. Fires `auroMenuOption-click`, unless the option or a menu containing it is disabled.
    * @private
    */
   handleClick() {