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

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

@@ -70,7 +70,7 @@ export class AuroCombobox extends AuroElement {
             reflect: boolean;
         };
         /**
-         * 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[]}
@@ -103,7 +103,7 @@ export class AuroCombobox extends AuroElement {
             reflect: boolean;
         };
         /**
-         * ID for the dropdown.
+         * Holds the dropdown's ID, which the trigger input uses for `aria-controls`.
          * @private
          */
         dropdownId: {
@@ -112,7 +112,7 @@ export class AuroCombobox extends AuroElement {
             attribute: boolean;
         };
         /**
-         * Whether or not the dropdown is open.
+         * Records whether the bib is open.
          * @private
          */
         dropdownOpen: {
@@ -402,7 +402,7 @@ export class AuroCombobox extends AuroElement {
          */
         fullscreenBreakpoint: "xs" | "sm" | "md" | "lg" | "xl" | "disabled";
         /**
-         * Specifies the currently active option.
+         * Holds the active (highlighted) option.
          * @private
          * @type {HTMLElement}
          */
@@ -474,9 +474,9 @@ export class AuroCombobox extends AuroElement {
     _userTyped: boolean | undefined;
     _pendingTimers: Set<any> | undefined;
     /**
-     * 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.
@@ -527,7 +527,7 @@ export class AuroCombobox extends AuroElement {
     private updateFilter;
     noMatchOption: any;
     /**
-     * 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}
      */
@@ -539,7 +539,7 @@ export class AuroCombobox extends AuroElement {
      */
     private updateTriggerTextDisplay;
     /**
-     * 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
@@ -555,10 +555,10 @@ export 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}
@@ -644,20 +644,20 @@ export class AuroCombobox extends AuroElement {
     private configureInput;
     /**
      * 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}
@@ -678,7 +678,9 @@ export class AuroCombobox extends AuroElement {
      */
     private handleMenuLoadingChange;
     /**
-     * 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}
@@ -686,9 +688,9 @@ export class AuroCombobox extends AuroElement {
     private handleInputValueChange;
     _syncingBibValue: boolean | undefined;
     /**
-     * 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/dist/index.js

@@ -5232,7 +5232,7 @@ let AuroHelpText$2 = class AuroHelpText extends LitElement {
   }
 };
 
-var formkitVersion$2 = '202611081705';
+var formkitVersion$2 = '202611081803';
 
 /**
  * Shared base class for layout-aware Auro form components, such as `auro-input`, `auro-select`, and `auro-menu`.
@@ -19406,7 +19406,7 @@ let AuroHelpText$1 = class AuroHelpText extends LitElement {
   }
 };
 
-var formkitVersion$1 = '202611081705';
+var formkitVersion$1 = '202611081803';
 
 // Copyright (c) 2025 Alaska Airlines. All right reserved. Licensed under the Apache-2.0 license
 // See LICENSE in the project root for license information.
@@ -20692,7 +20692,7 @@ class AuroBibtemplate extends LitElement {
   }
 }
 
-var formkitVersion = '202611081705';
+var formkitVersion = '202611081803';
 
 var styleCss$1 = css`.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}`;
 
@@ -21264,9 +21264,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.
@@ -21324,7 +21324,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[]}
@@ -21381,7 +21381,7 @@ class AuroCombobox extends AuroElement {
       },
 
       /**
-       * ID for the dropdown.
+       * Holds the dropdown's ID, which the trigger input uses for `aria-controls`.
        * @private
        */
       dropdownId: {
@@ -21391,7 +21391,7 @@ class AuroCombobox extends AuroElement {
       },
 
       /**
-       * Whether or not the dropdown is open.
+       * Records whether the bib is open.
        * @private
        */
       dropdownOpen: {
@@ -21740,7 +21740,7 @@ class AuroCombobox extends AuroElement {
       },
 
       /**
-       * Specifies the currently active option.
+       * Holds the active (highlighted) option.
        * @private
        * @type {HTMLElement}
        */
@@ -21917,7 +21917,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}
    */
@@ -21997,7 +21997,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
@@ -22050,10 +22050,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}
@@ -22659,20 +22659,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}
@@ -22733,7 +22733,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}
@@ -22843,9 +22845,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/dist/registered.js

@@ -5232,7 +5232,7 @@ let AuroHelpText$2 = class AuroHelpText extends LitElement {
   }
 };
 
-var formkitVersion$2 = '202611081705';
+var formkitVersion$2 = '202611081803';
 
 /**
  * Shared base class for layout-aware Auro form components, such as `auro-input`, `auro-select`, and `auro-menu`.
@@ -19406,7 +19406,7 @@ let AuroHelpText$1 = class AuroHelpText extends LitElement {
   }
 };
 
-var formkitVersion$1 = '202611081705';
+var formkitVersion$1 = '202611081803';
 
 // Copyright (c) 2025 Alaska Airlines. All right reserved. Licensed under the Apache-2.0 license
 // See LICENSE in the project root for license information.
@@ -20692,7 +20692,7 @@ class AuroBibtemplate extends LitElement {
   }
 }
 
-var formkitVersion = '202611081705';
+var formkitVersion = '202611081803';
 
 var styleCss$1 = css`.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}`;
 
@@ -21264,9 +21264,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.
@@ -21324,7 +21324,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[]}
@@ -21381,7 +21381,7 @@ class AuroCombobox extends AuroElement {
       },
 
       /**
-       * ID for the dropdown.
+       * Holds the dropdown's ID, which the trigger input uses for `aria-controls`.
        * @private
        */
       dropdownId: {
@@ -21391,7 +21391,7 @@ class AuroCombobox extends AuroElement {
       },
 
       /**
-       * Whether or not the dropdown is open.
+       * Records whether the bib is open.
        * @private
        */
       dropdownOpen: {
@@ -21740,7 +21740,7 @@ class AuroCombobox extends AuroElement {
       },
 
       /**
-       * Specifies the currently active option.
+       * Holds the active (highlighted) option.
        * @private
        * @type {HTMLElement}
        */
@@ -21917,7 +21917,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}
    */
@@ -21997,7 +21997,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
@@ -22050,10 +22050,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}
@@ -22659,20 +22659,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}
@@ -22733,7 +22733,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}
@@ -22843,9 +22845,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/counter/demo/api.md

@@ -22,17 +22,17 @@ A counter that lets people choose a number, such as how many passengers are trav
 
 ### Properties and attributes
 
-| Properties | Attributes | Modifiers | Type                   | Default   | Category | Range | Description                                                                                                                                                                                                                                           |
-| ---------- | ---------- | --------- | ---------------------- | --------- | -------- | ----- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| appearance | appearance |           | `default` \| `inverse` | `default` | ui       |       | Sets the colors to match the background behind the counter. Use `inverse` on dark backgrounds and `default` on light ones.                                                                                                                            |
-| disabled   | disabled   |           | boolean                |           | ui       |       | Turns the counter off. A disabled counter is shown in a muted style, its buttons can't be clicked, and it's removed from the keyboard tab order.                                                                                                      |
-| onDark     | ondark     |           | boolean                |           | ui       |       | Deprecated: Use `appearance="inverse"` instead.<br>Shows the counter in colors for dark backgrounds.                                                                                                                                                  |
-| error      | error      |           | string                 |           | behavior |       | Sets a custom error message, such as "Select at least one adult", and marks the counter invalid. The message replaces the help text. Set it with the `error` attribute: setting only the `error` property doesn't currently mark the counter invalid. |
-| max        | max        |           | number                 | `9`       | behavior | 0–9   | Sets the highest value the counter allows. The plus button turns off at this value.                                                                                                                                                                   |
-| min        | min        |           | number                 | `0`       | behavior | 0–9   | Sets the lowest value the counter allows. The counter starts at this value, and the minus button turns off at it.                                                                                                                                     |
-| name       | name       |           | string                 |           | behavior |       | Sets the key for this counter's entry in the group's `value` object, such as `adults`. Applies only inside `auro-counter-group`, which uses `counter-0`, `counter-1`, and so on for counters without a name.                                          |
-| validity   | validity   | readonly  | string                 |           | behavior |       | Reports whether the counter passes validation: `valid`, or the reason it fails, such as `customError`, `rangeOverflow`, or `rangeUnderflow`.                                                                                                          |
-| value      | value      |           | number \| undefined    |           | behavior |       | Sets the counter's value. A value outside `min` and `max` (0–9 by default) isn't moved back into range; it marks the counter invalid instead. A value that's `undefined`, `null`, or not a number clears the value to `undefined`.                    |
+| Properties | Attributes | Modifiers | Type                   | Default   | Category | Range | Description                                                                                                                                                                                                                                                                                                                               |
+| ---------- | ---------- | --------- | ---------------------- | --------- | -------- | ----- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| appearance | appearance |           | `default` \| `inverse` | `default` | ui       |       | Sets the colors to match the background behind the counter. Use `inverse` on dark backgrounds and `default` on light ones.                                                                                                                                                                                                                |
+| disabled   | disabled   |           | boolean                |           | ui       |       | Turns the counter off. A disabled counter is shown in a muted style, its buttons can't be clicked, and it's removed from the keyboard tab order.                                                                                                                                                                                          |
+| onDark     | ondark     |           | boolean                |           | ui       |       | Deprecated: Use `appearance="inverse"` instead.<br>Shows the counter in colors for dark backgrounds.                                                                                                                                                                                                                                      |
+| error      | error      |           | string                 |           | behavior |       | Sets a custom error message, such as "Select at least one adult", and marks the counter invalid. The message replaces the help text. Set the `error` attribute before the counter first renders, or call `validate()` after changing it: setting only the property, or changing the attribute later, doesn't currently update `validity`. |
+| max        | max        |           | number                 | `9`       | behavior | 0–9   | Sets the highest value the counter allows. The plus button turns off at this value.                                                                                                                                                                                                                                                       |
+| min        | min        |           | number                 | `0`       | behavior | 0–9   | Sets the lowest value the counter allows. The counter starts at this value, and the minus button turns off at it.                                                                                                                                                                                                                         |
+| name       | name       |           | string                 |           | behavior |       | Sets the key for this counter's entry in the group's `value` object, such as `adults`. Applies only inside `auro-counter-group`, which uses `counter-0`, `counter-1`, and so on for counters without a name.                                                                                                                              |
+| validity   | validity   | readonly  | string                 |           | behavior |       | Reports whether the counter passes validation: `valid`, or the reason it fails, such as `customError`, `rangeOverflow`, or `rangeUnderflow`.                                                                                                                                                                                              |
+| value      | value      |           | number \| undefined    |           | behavior |       | Sets the counter's value. A value outside `min` and `max` (0–9 by default) isn't moved back into range; it marks the counter invalid instead. A value that's `undefined`, `null`, or not a number clears the value to `undefined`.                                                                                                        |
 
 ### Methods
 
@@ -46,9 +46,9 @@ A counter that lets people choose a number, such as how many passengers are trav
 
 ### Events
 
-| Name  | Description                                    |
-| ----- | ---------------------------------------------- |
-| input | Notifies that the counter's value has changed. |
+| Name  | Description                                                                                                                                                                                    |
+| ----- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| input | Fires whenever `value` changes, including when the counter sets its starting value, with the new number in `event.detail.value`. It doesn't currently bubble, so listen on the counter itself. |
 
 ### Slots
 
@@ -134,10 +134,10 @@ Groups related counters, such as passenger types, so they share one total and on
 
 ### Events
 
-| Name                      | Description                                                                                                    |
-| ------------------------- | -------------------------------------------------------------------------------------------------------------- |
-| auroFormElement-validated | Fires each time the group is validated, with the result in `event.detail.validity` and `event.detail.message`. |
-| input                     | Fires when any counter's value changes, with the new `total` and `value` in `event.detail`.                    |
+| Name                      | Description                                                                                                                                             |
+| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| auroFormElement-validated | Fires each time the group is validated, with the result in `event.detail.validity` and `event.detail.message`.                                          |
+| input                     | Fires when any counter's value changes, with the new `total` and `value` in `event.detail`. It doesn't currently bubble, so listen on the group itself. |
 
 ### Slots
 

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

@@ -1166,7 +1166,7 @@ let AuroHelpText$1 = class AuroHelpText extends i$1 {
   }
 };
 
-var formkitVersion$1 = '202611081705';
+var formkitVersion$1 = '202611081803';
 
 // Copyright (c) 2026 Alaska Airlines. All rights reserved. Licensed under the Apache-2.0 license
 // See LICENSE in the project root for license information.
@@ -1231,7 +1231,7 @@ const keyboardStrategy = {
  * @csspart controlPlus - The plus button, which raises the value by 1.
  * @csspart helpText - The paragraph that shows the help text, or the error message while the counter is invalid.
  *
- * @event input - Notifies that the counter's value has changed.
+ * @event input - Fires whenever `value` changes, including when the counter sets its starting value, with the new number in `event.detail.value`. It doesn't currently bubble, so listen on the counter itself.
  */
 class AuroCounter extends i$1 {
 
@@ -1352,7 +1352,7 @@ class AuroCounter extends i$1 {
       },
 
       /**
-       * The trimmed text of the default slot, which `auro-counter-group` shows in its dropdown summary.
+       * Holds the trimmed text of the default slot, which `auro-counter-group` shows in its dropdown summary.
        * @private
        */
       defaultSlot: {
@@ -1390,7 +1390,7 @@ class AuroCounter extends i$1 {
       },
 
       /**
-       * Sets a custom error message, such as "Select at least one adult", and marks the counter invalid. The message replaces the help text. Set it with the `error` attribute: setting only the `error` property doesn't currently mark the counter invalid.
+       * Sets a custom error message, such as "Select at least one adult", and marks the counter invalid. The message replaces the help text. Set the `error` attribute before the counter first renders, or call `validate()` after changing it: setting only the property, or changing the attribute later, doesn't currently update `validity`.
        * @category behavior
        */
       error: {
@@ -5781,7 +5781,7 @@ class AuroHelpText extends i$1 {
   }
 }
 
-var formkitVersion = '202611081705';
+var formkitVersion = '202611081803';
 
 /**
  * Shared base class for layout-aware Auro form components, such as `auro-input`, `auro-select`, and `auro-menu`.
@@ -8382,7 +8382,7 @@ const counterGroupKeyboardStrategy = {
  * @csspart helpText - The paragraph that shows the help text, or the combined error message while a counter is invalid. Rendered only when `isDropdown` is set.
  *
  * @event auroFormElement-validated - Fires each time the group is validated, with the result in `event.detail.validity` and `event.detail.message`.
- * @event input - Fires when any counter's value changes, with the new `total` and `value` in `event.detail`.
+ * @event input - Fires when any counter's value changes, with the new `total` and `value` in `event.detail`. It doesn't currently bubble, so listen on the group itself.
  */
 class AuroCounterGroup extends AuroElement {
   constructor() {
@@ -8514,8 +8514,8 @@ class AuroCounterGroup extends AuroElement {
       },
 
       /**
-       * The current error message to display when the component is invalid.
-       * This is set by validation and isn't available to consumers.
+       * Holds the error message shown while the group is invalid.
+       * Validation sets it, and it isn't available to consumers.
        * @private
        */
       errorMessage: {
@@ -8712,7 +8712,7 @@ class AuroCounterGroup extends AuroElement {
       },
 
       /**
-       * The current text in the valueText slot.
+       * Holds the text in the `valueText` slot.
        * @category behavior
        * @private
        */
@@ -8784,9 +8784,9 @@ class AuroCounterGroup extends AuroElement {
   };
 
   /**
-   * Synchronously recomputes this.validity/this.errorMessage from the current
-   * validity of the child counters. Extracted from updateValidity() so that
-   * validate() can re-apply this aggregation immediately after the shared
+   * Synchronously recomputes `this.validity` and `this.errorMessage` from the current
+   * validity of the child counters. Extracted from `updateValidity()` so that
+   * `validate()` can re-apply this aggregation immediately after the shared
    * validation engine runs, instead of waiting on a deferred timer.
    * @returns {void}
    * @private
@@ -8871,9 +8871,9 @@ class AuroCounterGroup extends AuroElement {
   }
 
   /**
-   * Configures the dropdown counters by selecting all `auro-counter` elements,
-   * appending them to the `auro-counter-wrapper` element within the shadow DOM,
-   * and setting up keyboard navigation and input event listeners.
+   * Finds the dropdown and the counters slotted into its `auro-counter-wrapper`,
+   * adds `input` and `auroFormElement-validated` listeners to each counter, and
+   * updates `value` and the group's validity. Also sets up the bib template when `isDropdown` is set.
    * @private
    */
   configureDropdownCounters() {
@@ -8905,7 +8905,7 @@ class AuroCounterGroup extends AuroElement {
   }
 
   /**
-   * Sets up a close event listener and moves any slotted `bib.fullscreen.headline` and `bib.fullscreen.footer` content into the bibtemplate.
+   * Finds the bib template, closes the dropdown when its close button is clicked, and moves focus to the close button when the fullscreen dropdown opens.
    * @private
    */
   configureBibtemplate() {