@aurodesignsystem-dev/auro-formkit 0.0.0-pr1595.6 → 0.0.0-pr1595.8

package/components/checkbox/demo/api.md

@@ -81,7 +81,7 @@ The `auro-checkbox` element is for the purpose of allowing users to select one o
 | `auroCheckbox-focusout` | `CustomEvent<any>` | Notifies when the checkbox loses focus.          |
 | `auroCheckbox-input`    | `CustomEvent<any>` | Notifies when the checked value is changed by user interaction. **DEPRECATED** - Use the `input` event instead. |
 | `change`                |                    | Notifies when checked value is changed. **DEPRECATED** - Use the `input` event instead. |
-| `input`                 |                    | Notifies when when checked value is changed by user's interface. |
+| `input`                 |                    | Notifies when checked value is changed by user's interface. |
 
 ## Slots
 

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

@@ -138,7 +138,6 @@ let AuroLibraryRuntimeUtils$1 = class AuroLibraryRuntimeUtils {
 // See LICENSE in the project root for license information.
 
 
-/* eslint-disable jsdoc/no-undefined-types -- @fires event names are not types */
 /**
  * The `auro-checkbox` element is for the purpose of allowing users to select one or more options of a limited number of choices.
  * @customElement auro-checkbox
@@ -149,13 +148,12 @@ let AuroLibraryRuntimeUtils$1 = class AuroLibraryRuntimeUtils {
  *
  * @slot default - The default slot for the checkbox label.
  *
- * @fires change - Notifies when checked value is changed. **DEPRECATED** - Use the `input` event instead.
- * @fires input - Notifies when when checked value is changed by user's interface.
+ * @event change - Notifies when checked value is changed. **DEPRECATED** - Use the `input` event instead.
+ * @event input - Notifies when checked value is changed by user's interface.
  * @event auroCheckbox-input - Notifies when the checked value is changed by user interaction. **DEPRECATED** - Use the `input` event instead.
  * @event auroCheckbox-focusin - Notifies when the checkbox receives focus.
  * @event auroCheckbox-focusout - Notifies when the checkbox loses focus.
  */
-/* eslint-enable jsdoc/no-undefined-types */
 
 // build the component class
 class AuroCheckbox extends i$2 {
@@ -1286,7 +1284,7 @@ class AuroHelpText extends i$2 {
   }
 }
 
-var formkitVersion = '202608300411';
+var formkitVersion = '202608311921';
 
 // 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

@@ -138,7 +138,6 @@ let AuroLibraryRuntimeUtils$1 = class AuroLibraryRuntimeUtils {
 // See LICENSE in the project root for license information.
 
 
-/* eslint-disable jsdoc/no-undefined-types -- @fires event names are not types */
 /**
  * The `auro-checkbox` element is for the purpose of allowing users to select one or more options of a limited number of choices.
  * @customElement auro-checkbox
@@ -149,13 +148,12 @@ let AuroLibraryRuntimeUtils$1 = class AuroLibraryRuntimeUtils {
  *
  * @slot default - The default slot for the checkbox label.
  *
- * @fires change - Notifies when checked value is changed. **DEPRECATED** - Use the `input` event instead.
- * @fires input - Notifies when when checked value is changed by user's interface.
+ * @event change - Notifies when checked value is changed. **DEPRECATED** - Use the `input` event instead.
+ * @event input - Notifies when checked value is changed by user's interface.
  * @event auroCheckbox-input - Notifies when the checked value is changed by user interaction. **DEPRECATED** - Use the `input` event instead.
  * @event auroCheckbox-focusin - Notifies when the checkbox receives focus.
  * @event auroCheckbox-focusout - Notifies when the checkbox loses focus.
  */
-/* eslint-enable jsdoc/no-undefined-types */
 
 // build the component class
 class AuroCheckbox extends i$2 {
@@ -1286,7 +1284,7 @@ class AuroHelpText extends i$2 {
   }
 }
 
-var formkitVersion = '202608300411';
+var formkitVersion = '202608311921';
 
 // 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

@@ -138,7 +138,6 @@ let AuroLibraryRuntimeUtils$1 = class AuroLibraryRuntimeUtils {
 // See LICENSE in the project root for license information.
 
 
-/* eslint-disable jsdoc/no-undefined-types -- @fires event names are not types */
 /**
  * The `auro-checkbox` element is for the purpose of allowing users to select one or more options of a limited number of choices.
  * @customElement auro-checkbox
@@ -149,13 +148,12 @@ let AuroLibraryRuntimeUtils$1 = class AuroLibraryRuntimeUtils {
  *
  * @slot default - The default slot for the checkbox label.
  *
- * @fires change - Notifies when checked value is changed. **DEPRECATED** - Use the `input` event instead.
- * @fires input - Notifies when when checked value is changed by user's interface.
+ * @event change - Notifies when checked value is changed. **DEPRECATED** - Use the `input` event instead.
+ * @event input - Notifies when checked value is changed by user's interface.
  * @event auroCheckbox-input - Notifies when the checked value is changed by user interaction. **DEPRECATED** - Use the `input` event instead.
  * @event auroCheckbox-focusin - Notifies when the checkbox receives focus.
  * @event auroCheckbox-focusout - Notifies when the checkbox loses focus.
  */
-/* eslint-enable jsdoc/no-undefined-types */
 
 // build the component class
 class AuroCheckbox extends i$2 {
@@ -1286,7 +1284,7 @@ class AuroHelpText extends i$2 {
   }
 }
 
-var formkitVersion = '202608300411';
+var formkitVersion = '202608311921';
 
 // 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/auro-checkbox.d.ts

@@ -8,8 +8,8 @@
  *
  * @slot default - The default slot for the checkbox label.
  *
- * @fires change - Notifies when checked value is changed. **DEPRECATED** - Use the `input` event instead.
- * @fires input - Notifies when when checked value is changed by user's interface.
+ * @event change - Notifies when checked value is changed. **DEPRECATED** - Use the `input` event instead.
+ * @event input - Notifies when checked value is changed by user's interface.
  * @event auroCheckbox-input - Notifies when the checked value is changed by user interaction. **DEPRECATED** - Use the `input` event instead.
  * @event auroCheckbox-focusin - Notifies when the checkbox receives focus.
  * @event auroCheckbox-focusout - Notifies when the checkbox loses focus.

package/components/checkbox/dist/index.js

@@ -98,7 +98,6 @@ let AuroLibraryRuntimeUtils$1 = class AuroLibraryRuntimeUtils {
 // See LICENSE in the project root for license information.
 
 
-/* eslint-disable jsdoc/no-undefined-types -- @fires event names are not types */
 /**
  * The `auro-checkbox` element is for the purpose of allowing users to select one or more options of a limited number of choices.
  * @customElement auro-checkbox
@@ -109,13 +108,12 @@ let AuroLibraryRuntimeUtils$1 = class AuroLibraryRuntimeUtils {
  *
  * @slot default - The default slot for the checkbox label.
  *
- * @fires change - Notifies when checked value is changed. **DEPRECATED** - Use the `input` event instead.
- * @fires input - Notifies when when checked value is changed by user's interface.
+ * @event change - Notifies when checked value is changed. **DEPRECATED** - Use the `input` event instead.
+ * @event input - Notifies when checked value is changed by user's interface.
  * @event auroCheckbox-input - Notifies when the checked value is changed by user interaction. **DEPRECATED** - Use the `input` event instead.
  * @event auroCheckbox-focusin - Notifies when the checkbox receives focus.
  * @event auroCheckbox-focusout - Notifies when the checkbox loses focus.
  */
-/* eslint-enable jsdoc/no-undefined-types */
 
 // build the component class
 class AuroCheckbox extends LitElement {
@@ -1239,7 +1237,7 @@ class AuroHelpText extends LitElement {
   }
 }
 
-var formkitVersion = '202608300411';
+var formkitVersion = '202608311921';
 
 // 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

@@ -98,7 +98,6 @@ let AuroLibraryRuntimeUtils$1 = class AuroLibraryRuntimeUtils {
 // See LICENSE in the project root for license information.
 
 
-/* eslint-disable jsdoc/no-undefined-types -- @fires event names are not types */
 /**
  * The `auro-checkbox` element is for the purpose of allowing users to select one or more options of a limited number of choices.
  * @customElement auro-checkbox
@@ -109,13 +108,12 @@ let AuroLibraryRuntimeUtils$1 = class AuroLibraryRuntimeUtils {
  *
  * @slot default - The default slot for the checkbox label.
  *
- * @fires change - Notifies when checked value is changed. **DEPRECATED** - Use the `input` event instead.
- * @fires input - Notifies when when checked value is changed by user's interface.
+ * @event change - Notifies when checked value is changed. **DEPRECATED** - Use the `input` event instead.
+ * @event input - Notifies when checked value is changed by user's interface.
  * @event auroCheckbox-input - Notifies when the checked value is changed by user interaction. **DEPRECATED** - Use the `input` event instead.
  * @event auroCheckbox-focusin - Notifies when the checkbox receives focus.
  * @event auroCheckbox-focusout - Notifies when the checkbox loses focus.
  */
-/* eslint-enable jsdoc/no-undefined-types */
 
 // build the component class
 class AuroCheckbox extends LitElement {
@@ -1239,7 +1237,7 @@ class AuroHelpText extends LitElement {
   }
 }
 
-var formkitVersion = '202608300411';
+var formkitVersion = '202608311921';
 
 // 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

@@ -28,7 +28,7 @@ The `auro-combobox` element provides users with a way to select an option from a
 | `noValidate`                          | `novalidate`                          |           | `boolean`                                        |                  | If set, disables auto-validation on blur.        |
 | `offset`                              | `offset`                              |           | `number`                                         | "0"              | Gap between the trigger element and bib.         |
 | `onDark`                              | `ondark`                              |           | `boolean`                                        |                  | DEPRECATED - use `appearance="inverse"` instead. |
-| `optionSelected`                      | `optionselected`                      |           | `HTMLElement`                                    |                  | Specifies the current selected option.           |
+| `optionSelected`                      |                                       |           | `HTMLElement`                                    |                  | Specifies the current selected option.           |
 | `persistInput`                        | `persistinput`                        |           | `boolean`                                        |                  | If declared, selecting a menu option will not change the input value. By doing so,<br />the current menu filter will be preserved and the user can continue from their last<br />filter state. It is recommended to use this in combination with the `displayValue` slot. |
 | `placeholder`                         | `placeholder`                         |           | `string`                                         |                  | Define custom placeholder text, only supported by date input formats. |
 | `placement`                           | `placement`                           |           | `'top' \| 'right' \| 'bottom' \| 'left' \| 'bottom-start' \| 'top-start' \| 'top-end' \| 'right-start' \| 'right-end' \| 'bottom-end' \| 'left-start' \| 'left-end'` | "'bottom-start'" | Position where the bib should appear relative to the trigger. |

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

@@ -4539,7 +4539,7 @@ class AuroDropdownBib extends i$3 {
        */
       bibTemplate: {
         type: Object,
-        attribute: 'bibtemplate'
+        attribute: false
       },
 
       /**
@@ -5066,7 +5066,7 @@ let AuroHelpText$2 = class AuroHelpText extends i$3 {
   }
 };
 
-var formkitVersion$2 = '202608300411';
+var formkitVersion$2 = '202608311921';
 
 /**
  * AuroElement is the shared base class for layout-aware Auro form components.
@@ -5734,7 +5734,7 @@ class AuroDropdown extends AuroElement$2 {
        */
       onSlotChange: {
         type: Function,
-        attribute: 'onslotchange',
+        attribute: false,
         reflect: false
       },
 
@@ -18935,7 +18935,7 @@ let AuroHelpText$1 = class AuroHelpText extends i$3 {
   }
 };
 
-var formkitVersion$1 = '202608300411';
+var formkitVersion$1 = '202608311921';
 
 // Copyright (c) 2025 Alaska Airlines. All right reserved. Licensed under the Apache-2.0 license
 // See LICENSE in the project root for license information.
@@ -20127,7 +20127,7 @@ class AuroBibtemplate extends i$3 {
   }
 }
 
-var formkitVersion = '202608300411';
+var formkitVersion = '202608311921';
 
 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}`;
 
@@ -20563,20 +20563,31 @@ class AuroCombobox extends AuroElement {
     this.persistInput = false;
     this.required = false;
     this.typedValue = undefined;
+
+    /** @type {'filter' | 'suggestion'} */
     this.behavior = "suggestion";
     this.clearBtnFocused = false;
 
     // Defaults that effect the overall layout of the combobox
     this.checkmark = false;
     this.dvInputOnly = false;
+
+    /** @type {'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'disabled'} */
     this.fullscreenBreakpoint = 'sm';
+
+    /** @type {'classic' | 'emphasized' | 'snowflake'} */
     this.layout = 'classic';
     this.matchWidth = true;
+
+    /** @type {'box' | 'classic' | 'pill' | 'pill-left' | 'pill-right' | 'rounded' | 'snowflake'} */
     this.shape = 'classic';
+
+    /** @type {'xs' | 'sm' | 'md' | 'lg' | 'xl'} */
     this.size = 'xl';
     this.triggerIcon = false;
 
     // Defaults that effect the dropdown
+    /** @type {'top' | 'right' | 'bottom' | 'left' | 'bottom-start' | 'top-start' | 'top-end' | 'right-start' | 'right-end' | 'bottom-end' | 'left-start' | 'left-end'} */
     this.placement = 'bottom-start';
     this.offset = 0;
     this.noFlip = false;
@@ -20873,7 +20884,7 @@ class AuroCombobox extends AuroElement {
        */
       optionSelected: {
         type: Object,
-        attribute: 'optionselected'
+        attribute: false
       },
 
       /**
@@ -21466,7 +21477,7 @@ class AuroCombobox extends AuroElement {
           // focus, which fires focusout on the child auro-input before the
           // bib input receives focus. That focusout triggers the input's own
           // validate(), which dispatches a composed auroFormElement-validated
-          // event. Because composed events are retargetted at each shadow DOM
+          // event. Because composed events are re-targeted at each shadow DOM
           // boundary, the event appears to originate from the combobox itself
           // and its listener unconditionally sets this.validity — causing
           // premature validation. This flag suppresses all validation paths
@@ -21729,7 +21740,7 @@ class AuroCombobox extends AuroElement {
           this.optionSelected = selected;
         }
 
-        // Skip writeback when this event is the echo of our own setMenuValue —
+        // Skip write-back when this event is the echo of our own setMenuValue —
         // otherwise it cascades against handleInputValueChange in suggestion mode.
         if (this._pendingMenuValueSync) {
           this._pendingMenuValueSync = false;
@@ -22091,7 +22102,7 @@ class AuroCombobox extends AuroElement {
       // Ignore dispatches from the bib (fullscreen) input. It's re-validated
       // inside this.validate()'s auroInputElements loop with its own
       // (often undefined) validity, and the event is composed/bubbles up to
-      // this listener with `target` retargeted to the combobox. Letting it
+      // this listener with `target` re-targeted to the combobox. Letting it
       // through would overwrite the trigger input's correct validity with
       // the bib input's stale one (e.g. wiping `tooShort` during typing).
       if (this.inputInBib && evt.composedPath()[0] === this.inputInBib && this.inputInBib !== this.input) {

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

@@ -4539,7 +4539,7 @@ class AuroDropdownBib extends i$3 {
        */
       bibTemplate: {
         type: Object,
-        attribute: 'bibtemplate'
+        attribute: false
       },
 
       /**
@@ -5066,7 +5066,7 @@ let AuroHelpText$2 = class AuroHelpText extends i$3 {
   }
 };
 
-var formkitVersion$2 = '202608300411';
+var formkitVersion$2 = '202608311921';
 
 /**
  * AuroElement is the shared base class for layout-aware Auro form components.
@@ -5734,7 +5734,7 @@ class AuroDropdown extends AuroElement$2 {
        */
       onSlotChange: {
         type: Function,
-        attribute: 'onslotchange',
+        attribute: false,
         reflect: false
       },
 
@@ -18935,7 +18935,7 @@ let AuroHelpText$1 = class AuroHelpText extends i$3 {
   }
 };
 
-var formkitVersion$1 = '202608300411';
+var formkitVersion$1 = '202608311921';
 
 // Copyright (c) 2025 Alaska Airlines. All right reserved. Licensed under the Apache-2.0 license
 // See LICENSE in the project root for license information.
@@ -20127,7 +20127,7 @@ class AuroBibtemplate extends i$3 {
   }
 }
 
-var formkitVersion = '202608300411';
+var formkitVersion = '202608311921';
 
 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}`;
 
@@ -20563,20 +20563,31 @@ class AuroCombobox extends AuroElement {
     this.persistInput = false;
     this.required = false;
     this.typedValue = undefined;
+
+    /** @type {'filter' | 'suggestion'} */
     this.behavior = "suggestion";
     this.clearBtnFocused = false;
 
     // Defaults that effect the overall layout of the combobox
     this.checkmark = false;
     this.dvInputOnly = false;
+
+    /** @type {'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'disabled'} */
     this.fullscreenBreakpoint = 'sm';
+
+    /** @type {'classic' | 'emphasized' | 'snowflake'} */
     this.layout = 'classic';
     this.matchWidth = true;
+
+    /** @type {'box' | 'classic' | 'pill' | 'pill-left' | 'pill-right' | 'rounded' | 'snowflake'} */
     this.shape = 'classic';
+
+    /** @type {'xs' | 'sm' | 'md' | 'lg' | 'xl'} */
     this.size = 'xl';
     this.triggerIcon = false;
 
     // Defaults that effect the dropdown
+    /** @type {'top' | 'right' | 'bottom' | 'left' | 'bottom-start' | 'top-start' | 'top-end' | 'right-start' | 'right-end' | 'bottom-end' | 'left-start' | 'left-end'} */
     this.placement = 'bottom-start';
     this.offset = 0;
     this.noFlip = false;
@@ -20873,7 +20884,7 @@ class AuroCombobox extends AuroElement {
        */
       optionSelected: {
         type: Object,
-        attribute: 'optionselected'
+        attribute: false
       },
 
       /**
@@ -21466,7 +21477,7 @@ class AuroCombobox extends AuroElement {
           // focus, which fires focusout on the child auro-input before the
           // bib input receives focus. That focusout triggers the input's own
           // validate(), which dispatches a composed auroFormElement-validated
-          // event. Because composed events are retargetted at each shadow DOM
+          // event. Because composed events are re-targeted at each shadow DOM
           // boundary, the event appears to originate from the combobox itself
           // and its listener unconditionally sets this.validity — causing
           // premature validation. This flag suppresses all validation paths
@@ -21729,7 +21740,7 @@ class AuroCombobox extends AuroElement {
           this.optionSelected = selected;
         }
 
-        // Skip writeback when this event is the echo of our own setMenuValue —
+        // Skip write-back when this event is the echo of our own setMenuValue —
         // otherwise it cascades against handleInputValueChange in suggestion mode.
         if (this._pendingMenuValueSync) {
           this._pendingMenuValueSync = false;
@@ -22091,7 +22102,7 @@ class AuroCombobox extends AuroElement {
       // Ignore dispatches from the bib (fullscreen) input. It's re-validated
       // inside this.validate()'s auroInputElements loop with its own
       // (often undefined) validity, and the event is composed/bubbles up to
-      // this listener with `target` retargeted to the combobox. Letting it
+      // this listener with `target` re-targeted to the combobox. Letting it
       // through would overwrite the trigger input's correct validity with
       // the bib input's stale one (e.g. wiping `tooShort` during typing).
       if (this.inputInBib && evt.composedPath()[0] === this.inputInBib && this.inputInBib !== this.input) {

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

@@ -4554,7 +4554,7 @@ class AuroDropdownBib extends i$3 {
        */
       bibTemplate: {
         type: Object,
-        attribute: 'bibtemplate'
+        attribute: false
       },
 
       /**
@@ -5081,7 +5081,7 @@ let AuroHelpText$2 = class AuroHelpText extends i$3 {
   }
 };
 
-var formkitVersion$2 = '202608300411';
+var formkitVersion$2 = '202608311921';
 
 /**
  * AuroElement is the shared base class for layout-aware Auro form components.
@@ -5749,7 +5749,7 @@ class AuroDropdown extends AuroElement$2 {
        */
       onSlotChange: {
         type: Function,
-        attribute: 'onslotchange',
+        attribute: false,
         reflect: false
       },
 
@@ -18950,7 +18950,7 @@ let AuroHelpText$1 = class AuroHelpText extends i$3 {
   }
 };
 
-var formkitVersion$1 = '202608300411';
+var formkitVersion$1 = '202608311921';
 
 // Copyright (c) 2025 Alaska Airlines. All right reserved. Licensed under the Apache-2.0 license
 // See LICENSE in the project root for license information.
@@ -20142,7 +20142,7 @@ class AuroBibtemplate extends i$3 {
   }
 }
 
-var formkitVersion = '202608300411';
+var formkitVersion = '202608311921';
 
 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}`;
 
@@ -20578,20 +20578,31 @@ class AuroCombobox extends AuroElement {
     this.persistInput = false;
     this.required = false;
     this.typedValue = undefined;
+
+    /** @type {'filter' | 'suggestion'} */
     this.behavior = "suggestion";
     this.clearBtnFocused = false;
 
     // Defaults that effect the overall layout of the combobox
     this.checkmark = false;
     this.dvInputOnly = false;
+
+    /** @type {'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'disabled'} */
     this.fullscreenBreakpoint = 'sm';
+
+    /** @type {'classic' | 'emphasized' | 'snowflake'} */
     this.layout = 'classic';
     this.matchWidth = true;
+
+    /** @type {'box' | 'classic' | 'pill' | 'pill-left' | 'pill-right' | 'rounded' | 'snowflake'} */
     this.shape = 'classic';
+
+    /** @type {'xs' | 'sm' | 'md' | 'lg' | 'xl'} */
     this.size = 'xl';
     this.triggerIcon = false;
 
     // Defaults that effect the dropdown
+    /** @type {'top' | 'right' | 'bottom' | 'left' | 'bottom-start' | 'top-start' | 'top-end' | 'right-start' | 'right-end' | 'bottom-end' | 'left-start' | 'left-end'} */
     this.placement = 'bottom-start';
     this.offset = 0;
     this.noFlip = false;
@@ -20888,7 +20899,7 @@ class AuroCombobox extends AuroElement {
        */
       optionSelected: {
         type: Object,
-        attribute: 'optionselected'
+        attribute: false
       },
 
       /**
@@ -21481,7 +21492,7 @@ class AuroCombobox extends AuroElement {
           // focus, which fires focusout on the child auro-input before the
           // bib input receives focus. That focusout triggers the input's own
           // validate(), which dispatches a composed auroFormElement-validated
-          // event. Because composed events are retargetted at each shadow DOM
+          // event. Because composed events are re-targeted at each shadow DOM
           // boundary, the event appears to originate from the combobox itself
           // and its listener unconditionally sets this.validity — causing
           // premature validation. This flag suppresses all validation paths
@@ -21744,7 +21755,7 @@ class AuroCombobox extends AuroElement {
           this.optionSelected = selected;
         }
 
-        // Skip writeback when this event is the echo of our own setMenuValue —
+        // Skip write-back when this event is the echo of our own setMenuValue —
         // otherwise it cascades against handleInputValueChange in suggestion mode.
         if (this._pendingMenuValueSync) {
           this._pendingMenuValueSync = false;
@@ -22106,7 +22117,7 @@ class AuroCombobox extends AuroElement {
       // Ignore dispatches from the bib (fullscreen) input. It's re-validated
       // inside this.validate()'s auroInputElements loop with its own
       // (often undefined) validity, and the event is composed/bubbles up to
-      // this listener with `target` retargeted to the combobox. Letting it
+      // this listener with `target` re-targeted to the combobox. Letting it
       // through would overwrite the trigger input's correct validity with
       // the bib input's stale one (e.g. wiping `tooShort` during typing).
       if (this.inputInBib && evt.composedPath()[0] === this.inputInBib && this.inputInBib !== this.input) {

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

@@ -348,16 +348,21 @@ export class AuroCombobox extends AuroElement {
     persistInput: boolean | undefined;
     required: boolean | undefined;
     typedValue: any;
-    behavior: string | undefined;
+    /** @type {'filter' | 'suggestion'} */
+    behavior: "filter" | "suggestion" | undefined;
     clearBtnFocused: boolean | undefined;
     checkmark: boolean | undefined;
     dvInputOnly: boolean | undefined;
-    fullscreenBreakpoint: string | undefined;
+    /** @type {'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'disabled'} */
+    fullscreenBreakpoint: "xs" | "sm" | "md" | "lg" | "xl" | "disabled" | undefined;
     matchWidth: boolean | undefined;
-    shape: string | undefined;
-    size: string | undefined;
+    /** @type {'box' | 'classic' | 'pill' | 'pill-left' | 'pill-right' | 'rounded' | 'snowflake'} */
+    shape: "classic" | "snowflake" | "box" | "pill" | "pill-left" | "pill-right" | "rounded" | undefined;
+    /** @type {'xs' | 'sm' | 'md' | 'lg' | 'xl'} */
+    size: "xs" | "sm" | "md" | "lg" | "xl" | undefined;
     triggerIcon: boolean | undefined;
-    placement: string | undefined;
+    /** @type {'top' | 'right' | 'bottom' | 'left' | 'bottom-start' | 'top-start' | 'top-end' | 'right-start' | 'right-end' | 'bottom-end' | 'left-start' | 'left-end'} */
+    placement: "top" | "right" | "bottom" | "left" | "bottom-start" | "top-start" | "top-end" | "right-start" | "right-end" | "bottom-end" | "left-start" | "left-end" | undefined;
     offset: number | undefined;
     noFlip: boolean | undefined;
     shift: boolean | undefined;