@aurodesignsystem-dev/auro-formkit 0.0.0-pr1628.0 → 0.0.0-pr1628.1

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

@@ -1381,7 +1381,7 @@ class AuroHelpText extends i$2 {
   }
 }
 
-var formkitVersion = '202611081705';
+var formkitVersion = '202611081756';
 
 // 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

@@ -1381,7 +1381,7 @@ class AuroHelpText extends i$2 {
   }
 }
 
-var formkitVersion = '202611081705';
+var formkitVersion = '202611081756';
 
 // 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

@@ -1381,7 +1381,7 @@ class AuroHelpText extends i$2 {
   }
 }
 
-var formkitVersion = '202611081705';
+var formkitVersion = '202611081756';
 
 // 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

@@ -1334,7 +1334,7 @@ class AuroHelpText extends LitElement {
   }
 }
 
-var formkitVersion = '202611081705';
+var formkitVersion = '202611081756';
 
 // 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

@@ -1334,7 +1334,7 @@ class AuroHelpText extends LitElement {
   }
 }
 
-var formkitVersion = '202611081705';
+var formkitVersion = '202611081756';
 
 // 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/accessibility.md

@@ -28,7 +28,7 @@ Each menu option exposes the following ARIA attributes:
 | `aria-posinset` | `{index}` | The 1-based position of the option within the set. |
 
 <auro-header level="3" id="helpTextAndErrors">Help text and errors</auro-header>
-- Help text is associated with the component so screen readers can announce contextual guidance.
+- The input doesn't currently reference the `helpText` slot content with `aria-describedby`, so screen readers don't read the help text when the input gets focus. While the combobox is invalid, they read the error message instead.
 - When validation fails, the error message is rendered with `role="alert"` and `aria-live="assertive"` so screen readers announce it immediately.
 
 <auro-header level="2" id="activeDescendant">Active descendant</auro-header>

package/components/combobox/demo/customize.md

@@ -587,6 +587,7 @@
 <tr><td><code>dropdownTrigger</code></td><td>Doesn't currently style anything, because the dropdown inside the combobox doesn't render a <code>trigger</code> part.</td></tr>
 <tr><td><code>dropdownChevron</code></td><td>Doesn't currently style anything, because the combobox doesn't show a chevron.</td></tr>
 <tr><td><code>dropdownSize</code></td><td>The element that sets the bib's size. Only <code>height</code>, <code>width</code>, <code>max-height</code>, and <code>max-width</code> apply.</td></tr>
+<tr><td><code>dropdownBibTemplate</code></td><td>The container inside the bib that holds the options and, in the fullscreen bib, the headline, close button, and input.</td></tr>
 <tr><td><code>helpText</code></td><td>The help text and error message below the combobox.</td></tr>
 </tbody>
 </table>

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

@@ -5299,7 +5299,7 @@ let AuroHelpText$2 = class AuroHelpText extends i$3 {
   }
 };
 
-var formkitVersion$2 = '202611081705';
+var formkitVersion$2 = '202611081756';
 
 /**
  * Shared base class for layout-aware Auro form components, such as `auro-input`, `auro-select`, and `auro-menu`.
@@ -19480,7 +19480,7 @@ let AuroHelpText$1 = class AuroHelpText extends i$3 {
   }
 };
 
-var formkitVersion$1 = '202611081705';
+var formkitVersion$1 = '202611081756';
 
 // Copyright (c) 2025 Alaska Airlines. All right reserved. Licensed under the Apache-2.0 license
 // See LICENSE in the project root for license information.
@@ -20766,7 +20766,7 @@ class AuroBibtemplate extends i$3 {
   }
 }
 
-var formkitVersion = '202611081705';
+var formkitVersion = '202611081756';
 
 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}`;
 
@@ -21338,9 +21338,9 @@ class AuroCombobox extends AuroElement {
   }
 
   /**
-   * Wraps setTimeout and records the timer id so disconnectedCallback
-   * can cancel any outstanding callbacks. The id is removed from the set
-   * once the callback fires so the set doesn't grow unbounded.
+   * Wraps `setTimeout` and records the timer ID so `disconnectedCallback`
+   * can cancel any outstanding callbacks. The ID is removed from the set
+   * once the callback fires, so the set doesn't keep growing.
    * @param {Function} fn - The callback to run.
    * @param {number} ms - The delay in milliseconds.
    * @returns {number} The timer id.
@@ -21398,7 +21398,7 @@ class AuroCombobox extends AuroElement {
       },
 
       /**
-       * Array of the options shown in the menu: every option that isn't hidden,
+       * Holds the options shown in the menu: every option that isn't hidden,
        * such as by filtering on the typed text, plus `persistent` options.
        * @private
        * @type {HTMLElement[]}
@@ -21455,7 +21455,7 @@ class AuroCombobox extends AuroElement {
       },
 
       /**
-       * ID for the dropdown.
+       * Holds the dropdown's ID, which the trigger input uses for `aria-controls`.
        * @private
        */
       dropdownId: {
@@ -21465,7 +21465,7 @@ class AuroCombobox extends AuroElement {
       },
 
       /**
-       * Whether or not the dropdown is open.
+       * Records whether the bib is open.
        * @private
        */
       dropdownOpen: {
@@ -21814,7 +21814,7 @@ class AuroCombobox extends AuroElement {
       },
 
       /**
-       * Specifies the currently active option.
+       * Holds the active (highlighted) option.
        * @private
        * @type {HTMLElement}
        */
@@ -21991,7 +21991,7 @@ class AuroCombobox extends AuroElement {
   }
 
   /**
-   * Syncs the values and states of this component, the input, and the menu, including this.optionSelected and this.menu.optionSelected.
+   * Sets the menu's `matchWord` to the input text, then updates the input text and `displayValue` content from the selected option's label, or from `value` when no option is selected.
    * @private
    * @returns {void}
    */
@@ -22071,7 +22071,7 @@ class AuroCombobox extends AuroElement {
   }
 
   /**
-   * Writes nextValue to the trigger input and the bib input when their current
+   * Writes `nextValue` to the trigger input and the bib input when their current
    * value differs, then re-asserts imask after Lit's update flushes.
    * @param {string} nextValue - The value to write to both inputs.
    * @returns {Promise<void>} The promise that resolves after both inputs flush and imask
@@ -22124,10 +22124,10 @@ class AuroCombobox extends AuroElement {
    * @param {boolean} [options.preferComboboxValue=false] - If true,
    *   matches the selected option against `this.value` first. If false,
    *   matches against `this.input.value` first. Matching `this.value` first is needed on mount and re-mount
-   *   because under `persistInput` the consumer's typedValue prop can drift
+   *   because under `persistInput` the consumer's `typedValue` prop can drift
    *   from the framework value (Svelte `{#key}` re-mount after a swap, or
    *   SPA preselect after route change) and the old input-first match would
-   *   then pick the stale text. Only handleSlotChange passes this; typing
+   *   then pick the stale text. Only `handleSlotChange` passes this; typing
    *   and clearing paths keep the input-first match so user clears aren't
    *   undone.
    * @returns {void}
@@ -22733,20 +22733,20 @@ class AuroCombobox extends AuroElement {
 
   /**
    * Flags genuine clear-button activations on an auro-input so the SPA-preselect
-   * guard in handleInputValueChange doesn't swallow them.
+   * guard in `handleInputValueChange` doesn't swallow them.
    *
-   * The auro-input clear button fires an `isProgrammatic` input event (via
-   * notifyValueChanged) that is indistinguishable in shape from the
-   * SPA-preselect echo that guard bails on (isProgrammatic + set value + empty
-   * input). Without this one-shot flag, clicking clear would leave
-   * this.value/optionSelected stale (AB#1634257).
+   * The auro-input clear button fires an `isProgrammatic` input event (through
+   * `notifyValueChanged`) that has the same shape as the SPA-preselect echo
+   * that guard bails on (`isProgrammatic`, a set value, and an empty input).
+   * Without this one-shot flag, clicking clear would leave `value` and
+   * `optionSelected` stale (AB#1634257).
    *
-   * Delegated on the shadow root so it works regardless of when .clearBtn
-   * renders (it only exists after a value is set), and covers both real clicks
-   * and programmatic clearBtn.click() (which no focusin precedes). Registered in
-   * the CAPTURE phase so the flag is set BEFORE the button's own @click
-   * (handleClickClear) fires its synchronous input event, which is when
-   * handleInputValueChange reads the flag.
+   * Delegated on the shadow root so it works whenever `.clearBtn` renders
+   * (it only exists after a value is set), and covers both real clicks and
+   * programmatic `clearBtn.click()` calls, which no `focusin` precedes.
+   * Registered in the capture phase so the flag is set before the button's own
+   * `@click` handler (`handleClickClear`) fires its synchronous input event,
+   * which is when `handleInputValueChange` reads the flag.
    * @private
    * @param {Element} inputEl - The auro-input whose clear button to track.
    * @returns {void}
@@ -22807,7 +22807,9 @@ class AuroCombobox extends AuroElement {
   }
 
   /**
-   * Handles changes to the input value and the updates that follow from them.
+   * Called when the text in the trigger input or the fullscreen bib input changes.
+   * Keeps both inputs and `value` in sync, clears the combobox when the input is emptied,
+   * validates when focus is outside the combobox unless `noValidate` is set, and fires `inputValue`.
    * @private
    * @param {Event} event - The input event triggered by the input element.
    * @returns {void}
@@ -22917,9 +22919,9 @@ class AuroCombobox extends AuroElement {
   }
 
   /**
-   * Handles input value changes originating from the trigger input.
-   * Refreshes menu options and filtering, delegates to handleInputValueChange
-   * for value synchronization, and manages fullscreen bib focus.
+   * Called when the text in the trigger input changes.
+   * Refreshes the menu's options and filtering, passes the change to `handleInputValueChange`,
+   * and keeps focus in the fullscreen bib input while that bib is open.
    * @private
    * @param {Event} event - The input event from the trigger input element.
    * @returns {void}

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

@@ -352,9 +352,9 @@ Ensure your `tsconfig.json` uses `"moduleResolution": "bundler"` so TypeScript c
 <auro-header level="2" id="slots">Slots</auro-header>
 <p>The following slots are available on the <code>&lt;auro-combobox&gt;</code> element.</p>
 <auro-header level="3" id="slot-default">(default)</auro-header>
-<p>The <code>&lt;auro-menu&gt;</code> that holds the <code>&lt;auro-menuoption&gt;</code> elements the user chooses from. Required.</p>
+<p>The <code>&lt;auro-menu&gt;</code> that holds the <code>&lt;auro-menuoption&gt;</code> elements the user chooses from. Every combobox needs one.</p>
 <auro-header level="3" id="slot-label">label</auro-header>
-<p>Text for the combobox label. Required, because it gives the input its accessible name.</p>
+<p>Text for the combobox label. Every combobox needs a label, because it gives the input its accessible name.</p>
 <auro-header level="3" id="slot-helpText">helpText</auro-header>
 <p>Help text shown below the combobox. When validation fails, the error message replaces it.</p>
 <auro-header level="3" id="slot-optionalLabel">optionalLabel</auro-header>
@@ -371,9 +371,9 @@ Ensure your `tsconfig.json` uses `"moduleResolution": "bundler"` so TypeScript c
 </section>
 <section>
 <auro-header level="2" id="stateManagement">State management</auro-header>
-<p>The following properties hold the combobox's current state. Read them with JavaScript. You can also set <code>value</code> and <code>typedValue</code>.</p>
+<p>The following properties hold the combobox's current state. Read them with JavaScript, and set <code>value</code> or <code>typedValue</code> to change them.</p>
 <auro-header level="3" id="inputValue">inputValue</auro-header>
-<p>Gets the text currently in the input, whether or not it matches a menu option. It changes as the user types. Read-only.</p>
+<p>Gets the text currently in the input, whether or not it matches a menu option. It changes as the user types, and it's read-only.</p>
 <auro-header level="3" id="optionSelected">optionSelected</auro-header>
 <p>Returns the currently selected <code>&lt;auro-menuoption&gt;</code> element, or <code>undefined</code> if no option is selected.</p>
 <auro-header level="3" id="typedValue">typedValue</auro-header>

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

@@ -5299,7 +5299,7 @@ let AuroHelpText$2 = class AuroHelpText extends i$3 {
   }
 };
 
-var formkitVersion$2 = '202611081705';
+var formkitVersion$2 = '202611081756';
 
 /**
  * Shared base class for layout-aware Auro form components, such as `auro-input`, `auro-select`, and `auro-menu`.
@@ -19480,7 +19480,7 @@ let AuroHelpText$1 = class AuroHelpText extends i$3 {
   }
 };
 
-var formkitVersion$1 = '202611081705';
+var formkitVersion$1 = '202611081756';
 
 // Copyright (c) 2025 Alaska Airlines. All right reserved. Licensed under the Apache-2.0 license
 // See LICENSE in the project root for license information.
@@ -20766,7 +20766,7 @@ class AuroBibtemplate extends i$3 {
   }
 }
 
-var formkitVersion = '202611081705';
+var formkitVersion = '202611081756';
 
 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}`;
 
@@ -21338,9 +21338,9 @@ class AuroCombobox extends AuroElement {
   }
 
   /**
-   * Wraps setTimeout and records the timer id so disconnectedCallback
-   * can cancel any outstanding callbacks. The id is removed from the set
-   * once the callback fires so the set doesn't grow unbounded.
+   * Wraps `setTimeout` and records the timer ID so `disconnectedCallback`
+   * can cancel any outstanding callbacks. The ID is removed from the set
+   * once the callback fires, so the set doesn't keep growing.
    * @param {Function} fn - The callback to run.
    * @param {number} ms - The delay in milliseconds.
    * @returns {number} The timer id.
@@ -21398,7 +21398,7 @@ class AuroCombobox extends AuroElement {
       },
 
       /**
-       * Array of the options shown in the menu: every option that isn't hidden,
+       * Holds the options shown in the menu: every option that isn't hidden,
        * such as by filtering on the typed text, plus `persistent` options.
        * @private
        * @type {HTMLElement[]}
@@ -21455,7 +21455,7 @@ class AuroCombobox extends AuroElement {
       },
 
       /**
-       * ID for the dropdown.
+       * Holds the dropdown's ID, which the trigger input uses for `aria-controls`.
        * @private
        */
       dropdownId: {
@@ -21465,7 +21465,7 @@ class AuroCombobox extends AuroElement {
       },
 
       /**
-       * Whether or not the dropdown is open.
+       * Records whether the bib is open.
        * @private
        */
       dropdownOpen: {
@@ -21814,7 +21814,7 @@ class AuroCombobox extends AuroElement {
       },
 
       /**
-       * Specifies the currently active option.
+       * Holds the active (highlighted) option.
        * @private
        * @type {HTMLElement}
        */
@@ -21991,7 +21991,7 @@ class AuroCombobox extends AuroElement {
   }
 
   /**
-   * Syncs the values and states of this component, the input, and the menu, including this.optionSelected and this.menu.optionSelected.
+   * Sets the menu's `matchWord` to the input text, then updates the input text and `displayValue` content from the selected option's label, or from `value` when no option is selected.
    * @private
    * @returns {void}
    */
@@ -22071,7 +22071,7 @@ class AuroCombobox extends AuroElement {
   }
 
   /**
-   * Writes nextValue to the trigger input and the bib input when their current
+   * Writes `nextValue` to the trigger input and the bib input when their current
    * value differs, then re-asserts imask after Lit's update flushes.
    * @param {string} nextValue - The value to write to both inputs.
    * @returns {Promise<void>} The promise that resolves after both inputs flush and imask
@@ -22124,10 +22124,10 @@ class AuroCombobox extends AuroElement {
    * @param {boolean} [options.preferComboboxValue=false] - If true,
    *   matches the selected option against `this.value` first. If false,
    *   matches against `this.input.value` first. Matching `this.value` first is needed on mount and re-mount
-   *   because under `persistInput` the consumer's typedValue prop can drift
+   *   because under `persistInput` the consumer's `typedValue` prop can drift
    *   from the framework value (Svelte `{#key}` re-mount after a swap, or
    *   SPA preselect after route change) and the old input-first match would
-   *   then pick the stale text. Only handleSlotChange passes this; typing
+   *   then pick the stale text. Only `handleSlotChange` passes this; typing
    *   and clearing paths keep the input-first match so user clears aren't
    *   undone.
    * @returns {void}
@@ -22733,20 +22733,20 @@ class AuroCombobox extends AuroElement {
 
   /**
    * Flags genuine clear-button activations on an auro-input so the SPA-preselect
-   * guard in handleInputValueChange doesn't swallow them.
+   * guard in `handleInputValueChange` doesn't swallow them.
    *
-   * The auro-input clear button fires an `isProgrammatic` input event (via
-   * notifyValueChanged) that is indistinguishable in shape from the
-   * SPA-preselect echo that guard bails on (isProgrammatic + set value + empty
-   * input). Without this one-shot flag, clicking clear would leave
-   * this.value/optionSelected stale (AB#1634257).
+   * The auro-input clear button fires an `isProgrammatic` input event (through
+   * `notifyValueChanged`) that has the same shape as the SPA-preselect echo
+   * that guard bails on (`isProgrammatic`, a set value, and an empty input).
+   * Without this one-shot flag, clicking clear would leave `value` and
+   * `optionSelected` stale (AB#1634257).
    *
-   * Delegated on the shadow root so it works regardless of when .clearBtn
-   * renders (it only exists after a value is set), and covers both real clicks
-   * and programmatic clearBtn.click() (which no focusin precedes). Registered in
-   * the CAPTURE phase so the flag is set BEFORE the button's own @click
-   * (handleClickClear) fires its synchronous input event, which is when
-   * handleInputValueChange reads the flag.
+   * Delegated on the shadow root so it works whenever `.clearBtn` renders
+   * (it only exists after a value is set), and covers both real clicks and
+   * programmatic `clearBtn.click()` calls, which no `focusin` precedes.
+   * Registered in the capture phase so the flag is set before the button's own
+   * `@click` handler (`handleClickClear`) fires its synchronous input event,
+   * which is when `handleInputValueChange` reads the flag.
    * @private
    * @param {Element} inputEl - The auro-input whose clear button to track.
    * @returns {void}
@@ -22807,7 +22807,9 @@ class AuroCombobox extends AuroElement {
   }
 
   /**
-   * Handles changes to the input value and the updates that follow from them.
+   * Called when the text in the trigger input or the fullscreen bib input changes.
+   * Keeps both inputs and `value` in sync, clears the combobox when the input is emptied,
+   * validates when focus is outside the combobox unless `noValidate` is set, and fires `inputValue`.
    * @private
    * @param {Event} event - The input event triggered by the input element.
    * @returns {void}
@@ -22917,9 +22919,9 @@ class AuroCombobox extends AuroElement {
   }
 
   /**
-   * Handles input value changes originating from the trigger input.
-   * Refreshes menu options and filtering, delegates to handleInputValueChange
-   * for value synchronization, and manages fullscreen bib focus.
+   * Called when the text in the trigger input changes.
+   * Refreshes the menu's options and filtering, passes the change to `handleInputValueChange`,
+   * and keeps focus in the fullscreen bib input while that bib is open.
    * @private
    * @param {Event} event - The input event from the trigger input element.
    * @returns {void}

package/components/combobox/demo/index.md

@@ -131,7 +131,7 @@
 <li><strong><code>nomatch</code></strong>: The option is shown only when no other options match the typed value, such as "No results found".</li>
 </ul>
 <div class="note">
-<strong>Note:</strong> Filtering can be disabled entirely by setting the <code>noFilter</code> attribute on the combobox. When <code>noFilter</code> is set, all options remain visible regardless of the typed value. Match highlighting still applies. This is useful when menu options are dynamically generated through an API call as the user types into the input, since the server is already returning only relevant results.
+<strong>Note:</strong> Set <code>noFilter</code> on the combobox to turn off filtering. Every option then stays visible whatever the user types, and matching text is still highlighted. Use it when your code replaces the options as the user types, such as with results from a server that already returns only matching options.
 </div>
 <auro-header level="3" id="presetValue">Preset the value</auro-header>
 <p>To show a value when the component first renders, preset its <code>value</code>.</p>

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

@@ -5314,7 +5314,7 @@ let AuroHelpText$2 = class AuroHelpText extends i$3 {
   }
 };
 
-var formkitVersion$2 = '202611081705';
+var formkitVersion$2 = '202611081756';
 
 /**
  * Shared base class for layout-aware Auro form components, such as `auro-input`, `auro-select`, and `auro-menu`.
@@ -19495,7 +19495,7 @@ let AuroHelpText$1 = class AuroHelpText extends i$3 {
   }
 };
 
-var formkitVersion$1 = '202611081705';
+var formkitVersion$1 = '202611081756';
 
 // Copyright (c) 2025 Alaska Airlines. All right reserved. Licensed under the Apache-2.0 license
 // See LICENSE in the project root for license information.
@@ -20781,7 +20781,7 @@ class AuroBibtemplate extends i$3 {
   }
 }
 
-var formkitVersion = '202611081705';
+var formkitVersion = '202611081756';
 
 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}`;
 
@@ -21353,9 +21353,9 @@ class AuroCombobox extends AuroElement {
   }
 
   /**
-   * Wraps setTimeout and records the timer id so disconnectedCallback
-   * can cancel any outstanding callbacks. The id is removed from the set
-   * once the callback fires so the set doesn't grow unbounded.
+   * Wraps `setTimeout` and records the timer ID so `disconnectedCallback`
+   * can cancel any outstanding callbacks. The ID is removed from the set
+   * once the callback fires, so the set doesn't keep growing.
    * @param {Function} fn - The callback to run.
    * @param {number} ms - The delay in milliseconds.
    * @returns {number} The timer id.
@@ -21413,7 +21413,7 @@ class AuroCombobox extends AuroElement {
       },
 
       /**
-       * Array of the options shown in the menu: every option that isn't hidden,
+       * Holds the options shown in the menu: every option that isn't hidden,
        * such as by filtering on the typed text, plus `persistent` options.
        * @private
        * @type {HTMLElement[]}
@@ -21470,7 +21470,7 @@ class AuroCombobox extends AuroElement {
       },
 
       /**
-       * ID for the dropdown.
+       * Holds the dropdown's ID, which the trigger input uses for `aria-controls`.
        * @private
        */
       dropdownId: {
@@ -21480,7 +21480,7 @@ class AuroCombobox extends AuroElement {
       },
 
       /**
-       * Whether or not the dropdown is open.
+       * Records whether the bib is open.
        * @private
        */
       dropdownOpen: {
@@ -21829,7 +21829,7 @@ class AuroCombobox extends AuroElement {
       },
 
       /**
-       * Specifies the currently active option.
+       * Holds the active (highlighted) option.
        * @private
        * @type {HTMLElement}
        */
@@ -22006,7 +22006,7 @@ class AuroCombobox extends AuroElement {
   }
 
   /**
-   * Syncs the values and states of this component, the input, and the menu, including this.optionSelected and this.menu.optionSelected.
+   * Sets the menu's `matchWord` to the input text, then updates the input text and `displayValue` content from the selected option's label, or from `value` when no option is selected.
    * @private
    * @returns {void}
    */
@@ -22086,7 +22086,7 @@ class AuroCombobox extends AuroElement {
   }
 
   /**
-   * Writes nextValue to the trigger input and the bib input when their current
+   * Writes `nextValue` to the trigger input and the bib input when their current
    * value differs, then re-asserts imask after Lit's update flushes.
    * @param {string} nextValue - The value to write to both inputs.
    * @returns {Promise<void>} The promise that resolves after both inputs flush and imask
@@ -22139,10 +22139,10 @@ class AuroCombobox extends AuroElement {
    * @param {boolean} [options.preferComboboxValue=false] - If true,
    *   matches the selected option against `this.value` first. If false,
    *   matches against `this.input.value` first. Matching `this.value` first is needed on mount and re-mount
-   *   because under `persistInput` the consumer's typedValue prop can drift
+   *   because under `persistInput` the consumer's `typedValue` prop can drift
    *   from the framework value (Svelte `{#key}` re-mount after a swap, or
    *   SPA preselect after route change) and the old input-first match would
-   *   then pick the stale text. Only handleSlotChange passes this; typing
+   *   then pick the stale text. Only `handleSlotChange` passes this; typing
    *   and clearing paths keep the input-first match so user clears aren't
    *   undone.
    * @returns {void}
@@ -22748,20 +22748,20 @@ class AuroCombobox extends AuroElement {
 
   /**
    * Flags genuine clear-button activations on an auro-input so the SPA-preselect
-   * guard in handleInputValueChange doesn't swallow them.
+   * guard in `handleInputValueChange` doesn't swallow them.
    *
-   * The auro-input clear button fires an `isProgrammatic` input event (via
-   * notifyValueChanged) that is indistinguishable in shape from the
-   * SPA-preselect echo that guard bails on (isProgrammatic + set value + empty
-   * input). Without this one-shot flag, clicking clear would leave
-   * this.value/optionSelected stale (AB#1634257).
+   * The auro-input clear button fires an `isProgrammatic` input event (through
+   * `notifyValueChanged`) that has the same shape as the SPA-preselect echo
+   * that guard bails on (`isProgrammatic`, a set value, and an empty input).
+   * Without this one-shot flag, clicking clear would leave `value` and
+   * `optionSelected` stale (AB#1634257).
    *
-   * Delegated on the shadow root so it works regardless of when .clearBtn
-   * renders (it only exists after a value is set), and covers both real clicks
-   * and programmatic clearBtn.click() (which no focusin precedes). Registered in
-   * the CAPTURE phase so the flag is set BEFORE the button's own @click
-   * (handleClickClear) fires its synchronous input event, which is when
-   * handleInputValueChange reads the flag.
+   * Delegated on the shadow root so it works whenever `.clearBtn` renders
+   * (it only exists after a value is set), and covers both real clicks and
+   * programmatic `clearBtn.click()` calls, which no `focusin` precedes.
+   * Registered in the capture phase so the flag is set before the button's own
+   * `@click` handler (`handleClickClear`) fires its synchronous input event,
+   * which is when `handleInputValueChange` reads the flag.
    * @private
    * @param {Element} inputEl - The auro-input whose clear button to track.
    * @returns {void}
@@ -22822,7 +22822,9 @@ class AuroCombobox extends AuroElement {
   }
 
   /**
-   * Handles changes to the input value and the updates that follow from them.
+   * Called when the text in the trigger input or the fullscreen bib input changes.
+   * Keeps both inputs and `value` in sync, clears the combobox when the input is emptied,
+   * validates when focus is outside the combobox unless `noValidate` is set, and fires `inputValue`.
    * @private
    * @param {Event} event - The input event triggered by the input element.
    * @returns {void}
@@ -22932,9 +22934,9 @@ class AuroCombobox extends AuroElement {
   }
 
   /**
-   * Handles input value changes originating from the trigger input.
-   * Refreshes menu options and filtering, delegates to handleInputValueChange
-   * for value synchronization, and manages fullscreen bib focus.
+   * Called when the text in the trigger input changes.
+   * Refreshes the menu's options and filtering, passes the change to `handleInputValueChange`,
+   * and keeps focus in the fullscreen bib input while that bib is open.
    * @private
    * @param {Event} event - The input event from the trigger input element.
    * @returns {void}

package/components/combobox/demo/voiceover.md

@@ -40,7 +40,7 @@
 </tbody>
 </table>
 </li>
-<li><strong>Additional description:</strong> <code>helpText</code> slot content if present (after a brief pause)</li>
+<li><strong>Additional description:</strong> The error message while the combobox is invalid (after a brief pause). VoiceOver doesn't currently read the <code>helpText</code> slot content, because the input doesn't reference it.</li>
 </ol>
 <auro-header level="3" id="voiceOverNavigateAnnouncement">Navigating options</auro-header>
 <p>Announces each option <em>"[option label], [<em>"selected"</em> if <code>selected</code>], [<em>"dimmed"</em> if <code>disabled</code>]"</em> as you move.</p>