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

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

@@ -1284,7 +1284,7 @@ class AuroHelpText extends i$2 {
   }
 }
 
-var formkitVersion = '202608291822';
+var formkitVersion = '202608300041';
 
 // Copyright (c) 2026 Alaska Airlines. All rights reserved. Licensed under the Apache-2.0 license
 // See LICENSE in the project root for license information.

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

@@ -1284,7 +1284,7 @@ class AuroHelpText extends i$2 {
   }
 }
 
-var formkitVersion = '202608291822';
+var formkitVersion = '202608300041';
 
 // Copyright (c) 2026 Alaska Airlines. All rights reserved. Licensed under the Apache-2.0 license
 // See LICENSE in the project root for license information.

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

@@ -1284,7 +1284,7 @@ class AuroHelpText extends i$2 {
   }
 }
 
-var formkitVersion = '202608291822';
+var formkitVersion = '202608300041';
 
 // Copyright (c) 2026 Alaska Airlines. All rights reserved. Licensed under the Apache-2.0 license
 // See LICENSE in the project root for license information.

package/components/checkbox/dist/index.js

@@ -1237,7 +1237,7 @@ class AuroHelpText extends LitElement {
   }
 }
 
-var formkitVersion = '202608291822';
+var formkitVersion = '202608300041';
 
 // Copyright (c) 2026 Alaska Airlines. All rights reserved. Licensed under the Apache-2.0 license
 // See LICENSE in the project root for license information.

package/components/checkbox/dist/registered.js

@@ -1237,7 +1237,7 @@ class AuroHelpText extends LitElement {
   }
 }
 
-var formkitVersion = '202608291822';
+var formkitVersion = '202608300041';
 
 // Copyright (c) 2026 Alaska Airlines. All rights reserved. Licensed under the Apache-2.0 license
 // See LICENSE in the project root for license information.

package/components/combobox/demo/api.md

@@ -9,7 +9,7 @@ The `auro-combobox` element provides users with a way to select an option from a
 
 | Property                              | Attribute                             | Modifiers | Type                                             | Default          | Description                                      |
 |---------------------------------------|---------------------------------------|-----------|--------------------------------------------------|------------------|--------------------------------------------------|
-| `appearance`                          | `appearance`                          |           | `string`                                         | "'default'"      | Defines whether the component will be on lighter or darker backgrounds. |
+| `appearance`                          | `appearance`                          |           | `'default' \| 'inverse'`                         | "'default'"      | Defines whether the component will be on lighter or darker backgrounds. |
 | `autoPlacement`                       | `autoplacement`                       |           | `boolean`                                        |                  | If declared, bib's position will be automatically calculated where to appear. |
 | `autocomplete`                        | `autocomplete`                        |           | `string`                                         |                  | An enumerated attribute that defines what the user agent can suggest for autofill. At this time, only `autocomplete="off"` is supported. |
 | `behavior`                            | `behavior`                            |           | `'filter' \| 'suggestion'`                       | "'suggestion'"   | Sets the behavior of the combobox, "filter" or "suggestion".<br />"filter" requires the user to select an option from the menu.<br />"suggestion" allows the user to enter a value not present in the menu options. |
@@ -41,7 +41,7 @@ The `auro-combobox` element provides users with a way to select an option from a
 | `shift`                               | `shift`                               |           | `boolean`                                        |                  | If declared, the dropdown will shift its position to avoid being cut off by the viewport. |
 | `size`                                | `size`                                |           | `'xs' \| 'sm' \| 'md' \| 'lg' \| 'xl'`           | "'xl'"           | Sets the size of the combobox.                   |
 | `triggerIcon`                         | `triggericon`                         |           | `boolean`                                        |                  | If set, the `icon` attribute will be applied to the trigger `auro-input` element.<br />Icon rendering is currently limited to `type="credit-card"`. Setting `triggerIcon`<br />without a supported `type` propagates the attribute but does not render a visible icon. |
-| `type`                                | `type`                                |           | `string`                                         |                  | Applies the defined value as the type attribute on `auro-input`. |
+| `type`                                | `type`                                |           | `'text' \| 'password' \| 'email' \| 'credit-card' \| 'tel' \| 'number' \| 'date'` |                  | Applies the defined value as the type attribute on `auro-input`. |
 | `typedValue`                          | `typedvalue`                          |           | `string`                                         |                  | Specifies the value of the input element within the combobox. |
 | `validity`                            | `validity`                            |           | `string`                                         |                  | Specifies the `validityState` this element is in. |
 | `value`                               | `value`                               |           | `string`                                         |                  | Value selected for the dropdown menu. When set programmatically or as a preset attribute, the value must match a selectable option. If it matches an option marked `disabled` or `static`, the selection is rejected: `value` and `optionSelected` are cleared to `undefined`. `hidden` options (including those filtered out by type-ahead) remain selectable by value. |

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

@@ -5005,7 +5005,7 @@ let AuroHelpText$2 = class AuroHelpText extends i$3 {
   }
 };
 
-var formkitVersion$2 = '202608291822';
+var formkitVersion$2 = '202608300041';
 
 /**
  * AuroElement is the shared base class for layout-aware Auro form components.
@@ -5545,7 +5545,7 @@ class AuroDropdown extends AuroElement$2 {
        */
       hasTriggerContent: {
         type: Boolean,
-        attribute: 'hastriggercontent'
+        attribute: false
       },
 
       /**
@@ -5668,6 +5668,7 @@ class AuroDropdown extends AuroElement$2 {
 
       /**
        *  If declared, and a function is set, that function will execute when the slot content is updated.
+       * @type {() => void}
        */
       onSlotChange: {
         type: Function,
@@ -17091,7 +17092,10 @@ class BaseInput extends AuroElement$1 {
     // during its own update cycle sees a populated util instance.
     this.activeLabel = false;
 
-    /** @private */
+    /**
+     * @private
+     * @type {string[]}
+     */
     this.allowedInputTypes = [
       "text",
       "number",
@@ -17104,7 +17108,10 @@ class BaseInput extends AuroElement$1 {
     /** @type {'default' | 'inverse'} */
     this.appearance = "default";
 
-    /** @private */
+    /**
+     * @private
+     * @type {Record<string, string>}
+     */
     this.dateFormatMap = {
       'mm/dd/yyyy': 'dateMMDDYYYY',
       'dd/mm/yyyy': 'dateDDMMYYYY',
@@ -17150,7 +17157,10 @@ class BaseInput extends AuroElement$1 {
     this.setCustomValidityForType = undefined;
     // Credit Card is intentionally excluded — its mask manages the cursor
     // itself, and listing it here caused cursor placement issues in Safari.
-    /** @private */
+    /**
+     * @private
+     * @type {string[]}
+     */
     this.setSelectionInputTypes = [
       "text",
       "password",
@@ -18861,7 +18871,7 @@ let AuroHelpText$1 = class AuroHelpText extends i$3 {
   }
 };
 
-var formkitVersion$1 = '202608291822';
+var formkitVersion$1 = '202608300041';
 
 // Copyright (c) 2025 Alaska Airlines. All right reserved. Licensed under the Apache-2.0 license
 // See LICENSE in the project root for license information.
@@ -20053,7 +20063,7 @@ class AuroBibtemplate extends i$3 {
   }
 }
 
-var formkitVersion = '202608291822';
+var formkitVersion = '202608300041';
 
 var styleCss$3 = i$6`.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}:host{display:block;text-align:left}:host [auro-dropdown]{--ds-auro-dropdown-trigger-background-color: transparent}:host #inputInBib::part(wrapper){box-shadow:none}:host #inputInBib::part(accent-left){display:none}:host([layout*=classic]) [auro-input]{width:100%}:host([layout*=classic]) [auro-input]::part(helpText){display:none}:host([layout*=classic]) #slotHolder{display:none}`;
 
@@ -20478,6 +20488,7 @@ class AuroCombobox extends AuroElement {
    */
   _initializeDefaults() {
     // Defaults that effect the combobox behavior and state
+    /** @type {'default' | 'inverse'} */
     this.appearance = "default";
     this.disabled = false;
     this.msgSelectionMissing = 'Please select an option.';
@@ -20563,7 +20574,7 @@ class AuroCombobox extends AuroElement {
 
       /**
        * Defines whether the component will be on lighter or darker backgrounds.
-       * @property {'default' | 'inverse'} appearance - The visual appearance of the component.
+       * @type {'default' | 'inverse'}
        * @default 'default'
        */
       appearance: {
@@ -20592,6 +20603,7 @@ class AuroCombobox extends AuroElement {
        * Array of available options to display in the dropdown.
        * This array contains all non-hidden options (e.g., hidden by filtering on input value).
        * @private
+       * @type {HTMLElement[]}
        */
       availableOptions: {
         state: true,
@@ -20890,6 +20902,7 @@ class AuroCombobox extends AuroElement {
 
       /**
        * Applies the defined value as the type attribute on `auro-input`.
+       * @type {'text' | 'password' | 'email' | 'credit-card' | 'tel' | 'number' | 'date'}
        */
       type: {
         type: String,
@@ -20949,6 +20962,7 @@ class AuroCombobox extends AuroElement {
       /**
        * Specifies the currently active option.
        * @private
+       * @type {HTMLElement}
        */
       optionActive: {
         type: Object,
@@ -22719,7 +22733,7 @@ let menuInstanceIdCounter = 0;
  * @event {CustomEvent<Element>} auroMenu-activatedOption - Notifies that a menuoption has been made `active`.
  * @event {CustomEvent<any>} auroMenu-customEventFired - Notifies that a custom event has been fired.
  * @event {CustomEvent<{ loading: boolean; hasLoadingPlaceholder: boolean; }>} auroMenu-loadingChange - Notifies when the loading attribute is changed.
- * @event {CustomEvent<{ options: Array }>} auroMenu-optionsChange - Notifies that the set of available menu options has changed.
+ * @event {CustomEvent<{ options: Array<HTMLElement> }>} auroMenu-optionsChange - Notifies that the set of available menu options has changed.
  * @event {CustomEvent<any>} auroMenu-selectValueFailure - Notifies that an attempt to select a menuoption by matching a value has failed.
  * @event {CustomEvent<any>} auroMenu-selectValueReset - Notifies that the component value has been reset.
  * @event {CustomEvent<any>} auroMenu-selectedOption - Notifies that a new menuoption selection has been made.
@@ -22901,6 +22915,7 @@ class AuroMenu extends AuroElement {
       /**
        * Specifies the current active menuOption.
        * @readonly
+       * @type {HTMLElement}
        */
       optionActive: {
         type: Object,
@@ -22910,6 +22925,7 @@ class AuroMenu extends AuroElement {
       /**
        * The currently selected menu option(s). In single-select mode this is a single `HTMLElement` (or `undefined` when nothing is selected). In multi-select mode this is an array of `HTMLElement`s.
        * @readonly
+       * @type {HTMLElement | HTMLElement[]}
        */
       optionSelected: {
         // Allow HTMLElement, HTMLElement[] arrays and undefined
@@ -24195,7 +24211,7 @@ class AuroMenuOption extends AuroElement {
       },
 
       /**
-       * @private
+       * When set, selecting this option dispatches a custom event of the given name from the parent `auro-menu` (and an `auroMenu-customEventFired` event) instead of selecting the option.
        */
       event: {
         type: String,

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

@@ -5005,7 +5005,7 @@ let AuroHelpText$2 = class AuroHelpText extends i$3 {
   }
 };
 
-var formkitVersion$2 = '202608291822';
+var formkitVersion$2 = '202608300041';
 
 /**
  * AuroElement is the shared base class for layout-aware Auro form components.
@@ -5545,7 +5545,7 @@ class AuroDropdown extends AuroElement$2 {
        */
       hasTriggerContent: {
         type: Boolean,
-        attribute: 'hastriggercontent'
+        attribute: false
       },
 
       /**
@@ -5668,6 +5668,7 @@ class AuroDropdown extends AuroElement$2 {
 
       /**
        *  If declared, and a function is set, that function will execute when the slot content is updated.
+       * @type {() => void}
        */
       onSlotChange: {
         type: Function,
@@ -17091,7 +17092,10 @@ class BaseInput extends AuroElement$1 {
     // during its own update cycle sees a populated util instance.
     this.activeLabel = false;
 
-    /** @private */
+    /**
+     * @private
+     * @type {string[]}
+     */
     this.allowedInputTypes = [
       "text",
       "number",
@@ -17104,7 +17108,10 @@ class BaseInput extends AuroElement$1 {
     /** @type {'default' | 'inverse'} */
     this.appearance = "default";
 
-    /** @private */
+    /**
+     * @private
+     * @type {Record<string, string>}
+     */
     this.dateFormatMap = {
       'mm/dd/yyyy': 'dateMMDDYYYY',
       'dd/mm/yyyy': 'dateDDMMYYYY',
@@ -17150,7 +17157,10 @@ class BaseInput extends AuroElement$1 {
     this.setCustomValidityForType = undefined;
     // Credit Card is intentionally excluded — its mask manages the cursor
     // itself, and listing it here caused cursor placement issues in Safari.
-    /** @private */
+    /**
+     * @private
+     * @type {string[]}
+     */
     this.setSelectionInputTypes = [
       "text",
       "password",
@@ -18861,7 +18871,7 @@ let AuroHelpText$1 = class AuroHelpText extends i$3 {
   }
 };
 
-var formkitVersion$1 = '202608291822';
+var formkitVersion$1 = '202608300041';
 
 // Copyright (c) 2025 Alaska Airlines. All right reserved. Licensed under the Apache-2.0 license
 // See LICENSE in the project root for license information.
@@ -20053,7 +20063,7 @@ class AuroBibtemplate extends i$3 {
   }
 }
 
-var formkitVersion = '202608291822';
+var formkitVersion = '202608300041';
 
 var styleCss$3 = i$6`.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}:host{display:block;text-align:left}:host [auro-dropdown]{--ds-auro-dropdown-trigger-background-color: transparent}:host #inputInBib::part(wrapper){box-shadow:none}:host #inputInBib::part(accent-left){display:none}:host([layout*=classic]) [auro-input]{width:100%}:host([layout*=classic]) [auro-input]::part(helpText){display:none}:host([layout*=classic]) #slotHolder{display:none}`;
 
@@ -20478,6 +20488,7 @@ class AuroCombobox extends AuroElement {
    */
   _initializeDefaults() {
     // Defaults that effect the combobox behavior and state
+    /** @type {'default' | 'inverse'} */
     this.appearance = "default";
     this.disabled = false;
     this.msgSelectionMissing = 'Please select an option.';
@@ -20563,7 +20574,7 @@ class AuroCombobox extends AuroElement {
 
       /**
        * Defines whether the component will be on lighter or darker backgrounds.
-       * @property {'default' | 'inverse'} appearance - The visual appearance of the component.
+       * @type {'default' | 'inverse'}
        * @default 'default'
        */
       appearance: {
@@ -20592,6 +20603,7 @@ class AuroCombobox extends AuroElement {
        * Array of available options to display in the dropdown.
        * This array contains all non-hidden options (e.g., hidden by filtering on input value).
        * @private
+       * @type {HTMLElement[]}
        */
       availableOptions: {
         state: true,
@@ -20890,6 +20902,7 @@ class AuroCombobox extends AuroElement {
 
       /**
        * Applies the defined value as the type attribute on `auro-input`.
+       * @type {'text' | 'password' | 'email' | 'credit-card' | 'tel' | 'number' | 'date'}
        */
       type: {
         type: String,
@@ -20949,6 +20962,7 @@ class AuroCombobox extends AuroElement {
       /**
        * Specifies the currently active option.
        * @private
+       * @type {HTMLElement}
        */
       optionActive: {
         type: Object,
@@ -22719,7 +22733,7 @@ let menuInstanceIdCounter = 0;
  * @event {CustomEvent<Element>} auroMenu-activatedOption - Notifies that a menuoption has been made `active`.
  * @event {CustomEvent<any>} auroMenu-customEventFired - Notifies that a custom event has been fired.
  * @event {CustomEvent<{ loading: boolean; hasLoadingPlaceholder: boolean; }>} auroMenu-loadingChange - Notifies when the loading attribute is changed.
- * @event {CustomEvent<{ options: Array }>} auroMenu-optionsChange - Notifies that the set of available menu options has changed.
+ * @event {CustomEvent<{ options: Array<HTMLElement> }>} auroMenu-optionsChange - Notifies that the set of available menu options has changed.
  * @event {CustomEvent<any>} auroMenu-selectValueFailure - Notifies that an attempt to select a menuoption by matching a value has failed.
  * @event {CustomEvent<any>} auroMenu-selectValueReset - Notifies that the component value has been reset.
  * @event {CustomEvent<any>} auroMenu-selectedOption - Notifies that a new menuoption selection has been made.
@@ -22901,6 +22915,7 @@ class AuroMenu extends AuroElement {
       /**
        * Specifies the current active menuOption.
        * @readonly
+       * @type {HTMLElement}
        */
       optionActive: {
         type: Object,
@@ -22910,6 +22925,7 @@ class AuroMenu extends AuroElement {
       /**
        * The currently selected menu option(s). In single-select mode this is a single `HTMLElement` (or `undefined` when nothing is selected). In multi-select mode this is an array of `HTMLElement`s.
        * @readonly
+       * @type {HTMLElement | HTMLElement[]}
        */
       optionSelected: {
         // Allow HTMLElement, HTMLElement[] arrays and undefined
@@ -24195,7 +24211,7 @@ class AuroMenuOption extends AuroElement {
       },
 
       /**
-       * @private
+       * When set, selecting this option dispatches a custom event of the given name from the parent `auro-menu` (and an `auroMenu-customEventFired` event) instead of selecting the option.
        */
       event: {
         type: String,

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

@@ -5020,7 +5020,7 @@ let AuroHelpText$2 = class AuroHelpText extends i$3 {
   }
 };
 
-var formkitVersion$2 = '202608291822';
+var formkitVersion$2 = '202608300041';
 
 /**
  * AuroElement is the shared base class for layout-aware Auro form components.
@@ -5560,7 +5560,7 @@ class AuroDropdown extends AuroElement$2 {
        */
       hasTriggerContent: {
         type: Boolean,
-        attribute: 'hastriggercontent'
+        attribute: false
       },
 
       /**
@@ -5683,6 +5683,7 @@ class AuroDropdown extends AuroElement$2 {
 
       /**
        *  If declared, and a function is set, that function will execute when the slot content is updated.
+       * @type {() => void}
        */
       onSlotChange: {
         type: Function,
@@ -17106,7 +17107,10 @@ class BaseInput extends AuroElement$1 {
     // during its own update cycle sees a populated util instance.
     this.activeLabel = false;
 
-    /** @private */
+    /**
+     * @private
+     * @type {string[]}
+     */
     this.allowedInputTypes = [
       "text",
       "number",
@@ -17119,7 +17123,10 @@ class BaseInput extends AuroElement$1 {
     /** @type {'default' | 'inverse'} */
     this.appearance = "default";
 
-    /** @private */
+    /**
+     * @private
+     * @type {Record<string, string>}
+     */
     this.dateFormatMap = {
       'mm/dd/yyyy': 'dateMMDDYYYY',
       'dd/mm/yyyy': 'dateDDMMYYYY',
@@ -17165,7 +17172,10 @@ class BaseInput extends AuroElement$1 {
     this.setCustomValidityForType = undefined;
     // Credit Card is intentionally excluded — its mask manages the cursor
     // itself, and listing it here caused cursor placement issues in Safari.
-    /** @private */
+    /**
+     * @private
+     * @type {string[]}
+     */
     this.setSelectionInputTypes = [
       "text",
       "password",
@@ -18876,7 +18886,7 @@ let AuroHelpText$1 = class AuroHelpText extends i$3 {
   }
 };
 
-var formkitVersion$1 = '202608291822';
+var formkitVersion$1 = '202608300041';
 
 // Copyright (c) 2025 Alaska Airlines. All right reserved. Licensed under the Apache-2.0 license
 // See LICENSE in the project root for license information.
@@ -20068,7 +20078,7 @@ class AuroBibtemplate extends i$3 {
   }
 }
 
-var formkitVersion = '202608291822';
+var formkitVersion = '202608300041';
 
 var styleCss$3 = i$6`.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}:host{display:block;text-align:left}:host [auro-dropdown]{--ds-auro-dropdown-trigger-background-color: transparent}:host #inputInBib::part(wrapper){box-shadow:none}:host #inputInBib::part(accent-left){display:none}:host([layout*=classic]) [auro-input]{width:100%}:host([layout*=classic]) [auro-input]::part(helpText){display:none}:host([layout*=classic]) #slotHolder{display:none}`;
 
@@ -20493,6 +20503,7 @@ class AuroCombobox extends AuroElement {
    */
   _initializeDefaults() {
     // Defaults that effect the combobox behavior and state
+    /** @type {'default' | 'inverse'} */
     this.appearance = "default";
     this.disabled = false;
     this.msgSelectionMissing = 'Please select an option.';
@@ -20578,7 +20589,7 @@ class AuroCombobox extends AuroElement {
 
       /**
        * Defines whether the component will be on lighter or darker backgrounds.
-       * @property {'default' | 'inverse'} appearance - The visual appearance of the component.
+       * @type {'default' | 'inverse'}
        * @default 'default'
        */
       appearance: {
@@ -20607,6 +20618,7 @@ class AuroCombobox extends AuroElement {
        * Array of available options to display in the dropdown.
        * This array contains all non-hidden options (e.g., hidden by filtering on input value).
        * @private
+       * @type {HTMLElement[]}
        */
       availableOptions: {
         state: true,
@@ -20905,6 +20917,7 @@ class AuroCombobox extends AuroElement {
 
       /**
        * Applies the defined value as the type attribute on `auro-input`.
+       * @type {'text' | 'password' | 'email' | 'credit-card' | 'tel' | 'number' | 'date'}
        */
       type: {
         type: String,
@@ -20964,6 +20977,7 @@ class AuroCombobox extends AuroElement {
       /**
        * Specifies the currently active option.
        * @private
+       * @type {HTMLElement}
        */
       optionActive: {
         type: Object,
@@ -22734,7 +22748,7 @@ let menuInstanceIdCounter = 0;
  * @event {CustomEvent<Element>} auroMenu-activatedOption - Notifies that a menuoption has been made `active`.
  * @event {CustomEvent<any>} auroMenu-customEventFired - Notifies that a custom event has been fired.
  * @event {CustomEvent<{ loading: boolean; hasLoadingPlaceholder: boolean; }>} auroMenu-loadingChange - Notifies when the loading attribute is changed.
- * @event {CustomEvent<{ options: Array }>} auroMenu-optionsChange - Notifies that the set of available menu options has changed.
+ * @event {CustomEvent<{ options: Array<HTMLElement> }>} auroMenu-optionsChange - Notifies that the set of available menu options has changed.
  * @event {CustomEvent<any>} auroMenu-selectValueFailure - Notifies that an attempt to select a menuoption by matching a value has failed.
  * @event {CustomEvent<any>} auroMenu-selectValueReset - Notifies that the component value has been reset.
  * @event {CustomEvent<any>} auroMenu-selectedOption - Notifies that a new menuoption selection has been made.
@@ -22916,6 +22930,7 @@ class AuroMenu extends AuroElement {
       /**
        * Specifies the current active menuOption.
        * @readonly
+       * @type {HTMLElement}
        */
       optionActive: {
         type: Object,
@@ -22925,6 +22940,7 @@ class AuroMenu extends AuroElement {
       /**
        * The currently selected menu option(s). In single-select mode this is a single `HTMLElement` (or `undefined` when nothing is selected). In multi-select mode this is an array of `HTMLElement`s.
        * @readonly
+       * @type {HTMLElement | HTMLElement[]}
        */
       optionSelected: {
         // Allow HTMLElement, HTMLElement[] arrays and undefined
@@ -24210,7 +24226,7 @@ class AuroMenuOption extends AuroElement {
       },
 
       /**
-       * @private
+       * When set, selecting this option dispatches a custom event of the given name from the parent `auro-menu` (and an `auroMenu-customEventFired` event) instead of selecting the option.
        */
       event: {
         type: String,

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

@@ -20,13 +20,10 @@ export class AuroCombobox extends AuroElement {
     static get properties(): {
         /**
          * Defines whether the component will be on lighter or darker backgrounds.
-         * @property {'default' | 'inverse'} appearance - The visual appearance of the component.
+         * @type {'default' | 'inverse'}
          * @default 'default'
          */
-        appearance: {
-            type: StringConstructor;
-            reflect: boolean;
-        };
+        appearance: "default" | "inverse";
         /**
          * An enumerated attribute that defines what the user agent can suggest for autofill. At this time, only `autocomplete="off"` is supported.
          */
@@ -46,14 +43,9 @@ export class AuroCombobox extends AuroElement {
          * Array of available options to display in the dropdown.
          * This array contains all non-hidden options (e.g., hidden by filtering on input value).
          * @private
+         * @type {HTMLElement[]}
          */
-        availableOptions: {
-            state: boolean;
-            attribute: boolean;
-            type: ArrayConstructor;
-            reflect: boolean;
-            hasChanged(newVal: any, oldVal: any): any;
-        };
+        availableOptions: HTMLElement[];
         /**
          * Sets the behavior of the combobox, "filter" or "suggestion".
          * "filter" requires the user to select an option from the menu.
@@ -281,11 +273,9 @@ export class AuroCombobox extends AuroElement {
         };
         /**
          * Applies the defined value as the type attribute on `auro-input`.
+         * @type {'text' | 'password' | 'email' | 'credit-card' | 'tel' | 'number' | 'date'}
          */
-        type: {
-            type: StringConstructor;
-            reflect: boolean;
-        };
+        type: "text" | "password" | "email" | "credit-card" | "tel" | "number" | "date";
         /**
          * Specifies the value of the input element within the combobox.
          */
@@ -328,12 +318,9 @@ export class AuroCombobox extends AuroElement {
         /**
          * Specifies the currently active option.
          * @private
+         * @type {HTMLElement}
          */
-        optionActive: {
-            type: ObjectConstructor;
-            reflect: boolean;
-            attribute: boolean;
-        };
+        optionActive: HTMLElement;
     };
     static get styles(): import("lit").CSSResult[];
     /**
@@ -350,7 +337,8 @@ export class AuroCombobox extends AuroElement {
      * @returns {void} Internal defaults.
      */
     private _initializeDefaults;
-    appearance: string | undefined;
+    /** @type {'default' | 'inverse'} */
+    appearance: "default" | "inverse" | undefined;
     disabled: boolean | undefined;
     msgSelectionMissing: string | undefined;
     noFilter: boolean | undefined;