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

package/components/counter/demo/design.md

@@ -116,7 +116,7 @@
 <auro-header level="2" id="shapeSizeLayout">Shape, size, and layout support</auro-header>
 <p>The <code>auro-counter-group</code> component supports the <code>shape</code>, <code>size</code>, and <code>layout</code> feature set when <code>isDropdown</code> is set. The component defaults to <code>layout="classic"</code>, <code>shape="classic"</code>, and <code>size="xl"</code>.</p>
 <auro-header level="3" id="classicLayout">Classic layout</auro-header>
-<p>The <code>classic</code> layout is default for <code>auro-counter-group</code>. No customization is needed to achieve this look.</p>
+<p>The <code>classic</code> layout is the default for <code>auro-counter-group</code>. You don't need to set anything to get this look.</p>
 <div class="exampleWrapper">
 <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../apiExamples/dropdown.html) -->
 <!-- The below content is automatically added from ./../apiExamples/dropdown.html -->

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

@@ -14,13 +14,20 @@
 <auro-anchorlink fluid href="#minimalConfig">Minimal config</auro-anchorlink>
 <auro-anchorlink fluid href="#slots">Slots</auro-anchorlink>
 <auro-anchorlink fluid href="#slotsGroup" class="level2 body-xs">auro-counter-group</auro-anchorlink>
+<auro-anchorlink fluid href="#slot-default-group" class="level2 body-xs">- (default)</auro-anchorlink>
 <auro-anchorlink fluid href="#slot-label" class="level2 body-xs">- label</auro-anchorlink>
 <auro-anchorlink fluid href="#slot-helpText" class="level2 body-xs">- helpText</auro-anchorlink>
 <auro-anchorlink fluid href="#slot-valueText" class="level2 body-xs">- valueText</auro-anchorlink>
+<auro-anchorlink fluid href="#slot-typeIcon" class="level2 body-xs">- typeIcon</auro-anchorlink>
+<auro-anchorlink fluid href="#slot-bib-fullscreen-headline" class="level2 body-xs">- bib.fullscreen.headline</auro-anchorlink>
+<auro-anchorlink fluid href="#slot-bib-fullscreen-footer" class="level2 body-xs">- bib.fullscreen.footer</auro-anchorlink>
+<auro-anchorlink fluid href="#slot-ariaLabel-bib-close" class="level2 body-xs">- ariaLabel.bib.close</auro-anchorlink>
 <auro-anchorlink fluid href="#slotsCounter" class="level2 body-xs">auro-counter</auro-anchorlink>
 <auro-anchorlink fluid href="#slot-default-counter" class="level2 body-xs">- (default)</auro-anchorlink>
 <auro-anchorlink fluid href="#slot-description" class="level2 body-xs">- description</auro-anchorlink>
 <auro-anchorlink fluid href="#slot-helpText-counter" class="level2 body-xs">- helpText</auro-anchorlink>
+<auro-anchorlink fluid href="#slot-ariaLabel-minus" class="level2 body-xs">- ariaLabel.minus</auro-anchorlink>
+<auro-anchorlink fluid href="#slot-ariaLabel-plus" class="level2 body-xs">- ariaLabel.plus</auro-anchorlink>
 <auro-anchorlink fluid href="#stateManagement">State management</auro-anchorlink>
 <auro-anchorlink fluid href="#validity" class="level2 body-xs">Validity</auro-anchorlink>
 <auro-anchorlink fluid href="#publicFunctions">Functions</auro-anchorlink>
@@ -28,6 +35,8 @@
 <auro-anchorlink fluid href="#increment" class="level2 body-xs">increment()</auro-anchorlink>
 <auro-anchorlink fluid href="#decrement" class="level2 body-xs">decrement()</auro-anchorlink>
 <auro-anchorlink fluid href="#reset" class="level2 body-xs">reset()</auro-anchorlink>
+<auro-anchorlink fluid href="#showBib" class="level2 body-xs">showBib()</auro-anchorlink>
+<auro-anchorlink fluid href="#hideBib" class="level2 body-xs">hideBib()</auro-anchorlink>
 </auro-nav>
 </nav>
 <div class="mainContent">
@@ -49,7 +58,7 @@
 <!-- AURO-GENERATED-CONTENT:START (FILE:src=./../docs/partials/getting-started/customRegistration.md) -->
 <!-- The below content is automatically added from ./../docs/partials/getting-started/customRegistration.md -->
 <auro-header level="4">Custom component registration for version management</auro-header>
-There are two key parts to every Auro component: the <auro-hyperlink href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Classes">class</auro-hyperlink> and the custom element definition. The class defines the component's behavior, while the custom element registers it under a specific name so it can be used in HTML.
+Every Auro component has two key parts: the <auro-hyperlink href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Classes">class</auro-hyperlink> and the custom element definition. The class defines the component's behavior, while the custom element registers it under a specific name so it can be used in HTML.
 
 Import only the component class, then call its `register(name)` method with a unique name:
 
@@ -329,6 +338,8 @@ Ensure your `tsconfig.json` uses `"moduleResolution": "bundler"` so TypeScript c
 <auro-header level="2" id="slots">Slots</auro-header>
 <auro-header level="3" id="slotsGroup">auro-counter-group</auro-header>
 <p>The following slots are available on the <code>&lt;auro-counter-group&gt;</code> element.</p>
+<auro-header level="4" id="slot-default-group">(default)</auro-header>
+<p>The <code>auro-counter</code> elements in the group. Every group needs at least one.</p>
 <auro-header level="4" id="slot-label">label</auro-header>
 <p>The label shown in the dropdown trigger, such as "Passengers". Applies only when <code>isDropdown</code> is set.</p>
 <div class="exampleWrapper">
@@ -455,6 +466,14 @@ Ensure your `tsconfig.json` uses `"moduleResolution": "bundler"` so TypeScript c
 &lt;/div&gt;</code></pre>
 <!-- AURO-GENERATED-CONTENT:END -->
 </auro-accordion>
+<auro-header level="4" id="slot-typeIcon">typeIcon</auro-header>
+<p>An icon shown at the start of the dropdown trigger, such as a person icon for a passenger selector. Applies only when <code>isDropdown</code> is set.</p>
+<auro-header level="4" id="slot-bib-fullscreen-headline">bib.fullscreen.headline</auro-header>
+<p>The heading shown at the top of the fullscreen dropdown, such as "Passengers". Set it whenever <code>isDropdown</code> is set.</p>
+<auro-header level="4" id="slot-bib-fullscreen-footer">bib.fullscreen.footer</auro-header>
+<p>Content shown at the bottom of the fullscreen dropdown, such as Reset and Save buttons. Applies only when <code>isDropdown</code> is set.</p>
+<auro-header level="4" id="slot-ariaLabel-bib-close">ariaLabel.bib.close</auro-header>
+<p>Text screen readers announce for the close button in the fullscreen dropdown, such as "Close passenger selector". Defaults to "Close". Applies only when <code>isDropdown</code> is set.</p>
 <auro-header level="3" id="slotsCounter">auro-counter</auro-header>
 <p>The following slots are available on the <code>&lt;auro-counter&gt;</code> element.</p>
 <auro-header level="4" id="slot-default-counter">(default)</auro-header>
@@ -529,7 +548,11 @@ Ensure your `tsconfig.json` uses `"moduleResolution": "bundler"` so TypeScript c
   &lt;span slot="helpText"&gt;This is help text for the counter&lt;/span&gt;
 &lt;/auro-counter&gt;</code></pre>
 <!-- AURO-GENERATED-CONTENT:END -->
-</auro-accordion>
+</auro-accordion>
+<auro-header level="4" id="slot-ariaLabel-minus">ariaLabel.minus</auro-header>
+<p>Text screen readers announce for the minus button, such as "Remove adult". Defaults to "−" (a minus sign), so set it on every counter.</p>
+<auro-header level="4" id="slot-ariaLabel-plus">ariaLabel.plus</auro-header>
+<p>Text screen readers announce for the plus button, such as "Add adult". Defaults to "+", so set it on every counter.</p>
 <!-- AURO-GENERATED-CONTENT:END -->
 </section>
 <section>
@@ -602,6 +625,10 @@ Ensure your `tsconfig.json` uses `"moduleResolution": "bundler"` so TypeScript c
 }</code></pre>
 <!-- AURO-GENERATED-CONTENT:END -->
 </auro-accordion>
+<auro-header level="3" id="showBib">showBib()</auro-header>
+<p>Opens a counter group's dropdown if it's closed. Does nothing unless <code>isDropdown</code> is set.</p>
+<auro-header level="3" id="hideBib">hideBib()</auro-header>
+<p>Closes a counter group's dropdown if it's open. Does nothing unless <code>isDropdown</code> is set.</p>
 </section>
 </div>
 </div>

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

@@ -1164,7 +1164,7 @@ let AuroHelpText$1 = class AuroHelpText extends i$2 {
   }
 };
 
-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.
@@ -1229,7 +1229,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$2 {
 
@@ -1350,7 +1350,7 @@ class AuroCounter extends i$2 {
       },
 
       /**
-       * 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: {
@@ -1388,7 +1388,7 @@ class AuroCounter extends i$2 {
       },
 
       /**
-       * 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: {
@@ -5779,7 +5779,7 @@ class AuroHelpText extends i$2 {
   }
 }
 
-var formkitVersion = '202611081705';
+var formkitVersion = '202611081803';
 
 /**
  * Shared base class for layout-aware Auro form components, such as `auro-input`, `auro-select`, and `auro-menu`.
@@ -8380,7 +8380,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() {
@@ -8512,8 +8512,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: {
@@ -8710,7 +8710,7 @@ class AuroCounterGroup extends AuroElement {
       },
 
       /**
-       * The current text in the valueText slot.
+       * Holds the text in the `valueText` slot.
        * @category behavior
        * @private
        */
@@ -8782,9 +8782,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
@@ -8869,9 +8869,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() {
@@ -8903,7 +8903,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() {

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

@@ -1164,7 +1164,7 @@ let AuroHelpText$1 = class AuroHelpText extends i$2 {
   }
 };
 
-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.
@@ -1229,7 +1229,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$2 {
 
@@ -1350,7 +1350,7 @@ class AuroCounter extends i$2 {
       },
 
       /**
-       * 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: {
@@ -1388,7 +1388,7 @@ class AuroCounter extends i$2 {
       },
 
       /**
-       * 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: {
@@ -5779,7 +5779,7 @@ class AuroHelpText extends i$2 {
   }
 }
 
-var formkitVersion = '202611081705';
+var formkitVersion = '202611081803';
 
 /**
  * Shared base class for layout-aware Auro form components, such as `auro-input`, `auro-select`, and `auro-menu`.
@@ -8380,7 +8380,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() {
@@ -8512,8 +8512,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: {
@@ -8710,7 +8710,7 @@ class AuroCounterGroup extends AuroElement {
       },
 
       /**
-       * The current text in the valueText slot.
+       * Holds the text in the `valueText` slot.
        * @category behavior
        * @private
        */
@@ -8782,9 +8782,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
@@ -8869,9 +8869,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() {
@@ -8903,7 +8903,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() {

package/components/counter/dist/auro-counter-group.d.ts

@@ -40,7 +40,7 @@
  * @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.
  */
 export class AuroCounterGroup extends AuroElement {
     static get styles(): import("lit").CSSResult[];
@@ -65,8 +65,8 @@ export class AuroCounterGroup extends AuroElement {
             reflect: boolean;
         };
         /**
-         * 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: {
@@ -207,7 +207,7 @@ export class AuroCounterGroup extends AuroElement {
         };
         value: Record<string, number>;
         /**
-         * The current text in the valueText slot.
+         * Holds the text in the `valueText` slot.
          * @category behavior
          * @private
          */
@@ -327,9 +327,9 @@ export class AuroCounterGroup extends AuroElement {
      */
     private getErrorMessages;
     /**
-     * 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
@@ -347,14 +347,14 @@ export class AuroCounterGroup extends AuroElement {
      */
     showBib(): void;
     /**
-     * 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
      */
     private configureDropdownCounters;
     /**
-     * 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
      */
     private configureBibtemplate;

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

@@ -31,7 +31,7 @@
  * @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.
  */
 export class AuroCounter extends LitElement {
     /**

package/components/counter/dist/index.js

@@ -1114,7 +1114,7 @@ let AuroHelpText$1 = class AuroHelpText extends LitElement {
   }
 };
 
-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.
@@ -1179,7 +1179,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 LitElement {
 
@@ -1300,7 +1300,7 @@ class AuroCounter extends LitElement {
       },
 
       /**
-       * 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: {
@@ -1338,7 +1338,7 @@ class AuroCounter extends LitElement {
       },
 
       /**
-       * 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: {
@@ -5711,7 +5711,7 @@ class AuroHelpText extends LitElement {
   }
 }
 
-var formkitVersion = '202611081705';
+var formkitVersion = '202611081803';
 
 /**
  * Shared base class for layout-aware Auro form components, such as `auro-input`, `auro-select`, and `auro-menu`.
@@ -8312,7 +8312,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() {
@@ -8444,8 +8444,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: {
@@ -8642,7 +8642,7 @@ class AuroCounterGroup extends AuroElement {
       },
 
       /**
-       * The current text in the valueText slot.
+       * Holds the text in the `valueText` slot.
        * @category behavior
        * @private
        */
@@ -8714,9 +8714,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
@@ -8801,9 +8801,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() {
@@ -8835,7 +8835,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() {

package/components/counter/dist/registered.js

@@ -1114,7 +1114,7 @@ let AuroHelpText$1 = class AuroHelpText extends LitElement {
   }
 };
 
-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.
@@ -1179,7 +1179,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 LitElement {
 
@@ -1300,7 +1300,7 @@ class AuroCounter extends LitElement {
       },
 
       /**
-       * 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: {
@@ -1338,7 +1338,7 @@ class AuroCounter extends LitElement {
       },
 
       /**
-       * 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: {
@@ -5711,7 +5711,7 @@ class AuroHelpText extends LitElement {
   }
 }
 
-var formkitVersion = '202611081705';
+var formkitVersion = '202611081803';
 
 /**
  * Shared base class for layout-aware Auro form components, such as `auro-input`, `auro-select`, and `auro-menu`.
@@ -8312,7 +8312,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() {
@@ -8444,8 +8444,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: {
@@ -8642,7 +8642,7 @@ class AuroCounterGroup extends AuroElement {
       },
 
       /**
-       * The current text in the valueText slot.
+       * Holds the text in the `valueText` slot.
        * @category behavior
        * @private
        */
@@ -8714,9 +8714,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
@@ -8801,9 +8801,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() {
@@ -8835,7 +8835,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() {