@aurodesignsystem/auro-formkit 5.10.0 → 5.11.0

package/CHANGELOG.md

@@ -1,29 +1,69 @@
-# [5.10.0](https://github.com/AlaskaAirlines/auro-formkit/compare/v5.9.4...v5.10.0) (2026-02-14)
+# [5.11.0](https://github.com/AlaskaAirlines/auro-formkit/compare/v5.10.0...v5.11.0) (2026-03-10)
 
 
 ### Bug Fixes
 
-* add Chromatic workflow for visual testing on rc branches ([ad9c2d3](https://github.com/AlaskaAirlines/auro-formkit/commit/ad9c2d32b0181a222c9cb4731887bf0683f486c5))
-* address failing a11y tests in select and combobox ([45230a8](https://github.com/AlaskaAirlines/auro-formkit/commit/45230a81b71959594c2ba65745f515a5a3befd1f))
-* adjust types to enable cem to process correctly ([6781a8d](https://github.com/AlaskaAirlines/auro-formkit/commit/6781a8dcdd9f4eda11286a83a923e0eaeab428e7))
-* **combobox:** error attribute now correctly displays error UI [#1272](https://github.com/AlaskaAirlines/auro-formkit/issues/1272) ([96f09ab](https://github.com/AlaskaAirlines/auro-formkit/commit/96f09abf449fcfdf6f935aa51215f216ef739e29))
-* **combobox:** update validity check to reflect correct state after clearing customError ([77eaa14](https://github.com/AlaskaAirlines/auro-formkit/commit/77eaa14d29ea10419facecde0472b1c2f9ff4142))
-* **combobox:** updateActiveOption method correctly highlights menu option [#1275](https://github.com/AlaskaAirlines/auro-formkit/issues/1275) ([2733cbb](https://github.com/AlaskaAirlines/auro-formkit/commit/2733cbb34dbad71a45f761449d73fb87dd6b54bb))
-* make menuoptions visible to screenreaders [#456](https://github.com/AlaskaAirlines/auro-formkit/issues/456) ([c6326a2](https://github.com/AlaskaAirlines/auro-formkit/commit/c6326a29ab0ee0423a28a975cd9082b828599b7e))
-* set max length for each input type [#1331](https://github.com/AlaskaAirlines/auro-formkit/issues/1331) ([1dbfa0c](https://github.com/AlaskaAirlines/auro-formkit/commit/1dbfa0cb6182db0f6faaf807a7664b0af060ddee))
-* update release workflow to include cache directories ([72c45d0](https://github.com/AlaskaAirlines/auro-formkit/commit/72c45d024595ea244fa3e959bf284110d63aee3b))
-* user input credit card formatting logic [#1324](https://github.com/AlaskaAirlines/auro-formkit/issues/1324) ([8328de1](https://github.com/AlaskaAirlines/auro-formkit/commit/8328de1337d1233089c41efff4d6ded6d73b8322))
+* **combobox, dropdown:** enhance dropdown behavior for fullscreen and button interactions ([bc4ff17](https://github.com/AlaskaAirlines/auro-formkit/commit/bc4ff1790782617c06a01b9884a04e51a45763d6))
+* **combobox, select:** improve Tab key behavior for accessibility in fullscreen and non-fullscreen modes ([f466745](https://github.com/AlaskaAirlines/auro-formkit/commit/f466745dcc6a251c68275356428f8d5f4d73b142))
+* **combobox:** add description for appearance property in JSDoc ([44ce771](https://github.com/AlaskaAirlines/auro-formkit/commit/44ce77134eea1a8b85a393dcea6050110e2b8652))
+* **combobox:** fix test by managing focus during fullscreen dialog transitions ([c40a1bf](https://github.com/AlaskaAirlines/auro-formkit/commit/c40a1bf5db2b4f651007477448a567379cb97182))
+* **combobox:** make label slot selector element-agnostic ([d2afe7e](https://github.com/AlaskaAirlines/auro-formkit/commit/d2afe7ede7ab7b3d048457d09498bf8372ce6a62))
+* **combobox:** prevent default behavior when clear button is focused ([6058438](https://github.com/AlaskaAirlines/auro-formkit/commit/60584386947acef6752feccd11e91cc0809fbe67))
+* **combobox:** prevent fullscreen dialog from closing immediately after reopen ([ecf8998](https://github.com/AlaskaAirlines/auro-formkit/commit/ecf899836092af8f0ebb307fff2ea0bdaa52f114))
+* **combobox:** reset _inFullscreenTransition flag on disconnect ([27d18ad](https://github.com/AlaskaAirlines/auro-formkit/commit/27d18ade8c6586849ebbbb6c76a681313b9e1c92))
+* **combobox:** restore focus to trigger input after closing fullscreen dialog ([0fbd4d5](https://github.com/AlaskaAirlines/auro-formkit/commit/0fbd4d53694cc117ee0fd7edc958c60c065906f1))
+* **combobox:** suppress validation during fullscreen focus transition ([8fd9b95](https://github.com/AlaskaAirlines/auro-formkit/commit/8fd9b95cedfbaa357a0ba3394b6478177e00940d))
+* **combobox:** update test to manage focus during fullscreen dialog transitions ([c517b04](https://github.com/AlaskaAirlines/auro-formkit/commit/c517b046fc8dfc32160424ee232421f506a99c12))
+* **counter-group:** close fullscreen dialog with Tab key for improved accessibility ([ba54a38](https://github.com/AlaskaAirlines/auro-formkit/commit/ba54a381d211c5a2c35275237262b27e89c7ae18))
+* **counter:** voiceover to read raw number instead of percentage AB[#1443553](https://github.com/AlaskaAirlines/auro-formkit/issues/1443553) ([e275fe0](https://github.com/AlaskaAirlines/auro-formkit/commit/e275fe06c4e24ed77cbbcc0714dd1ae36e729d57))
+* **datepicker:** accessibility and focus management for fullscreen dropdown ([5ec0cb9](https://github.com/AlaskaAirlines/auro-formkit/commit/5ec0cb9e6256633c4bc22e08c1af3c2e6f2db1c6))
+* **datepicker:** close fullscreen dialog with Tab key for improved accessibility ([51742be](https://github.com/AlaskaAirlines/auro-formkit/commit/51742be661b9310d5854600c4e2feae3ae01916c))
+* **datepicker:** use double rAF for reliable close-button focus in fullscreen dialog ([54594df](https://github.com/AlaskaAirlines/auro-formkit/commit/54594df959af7379c5631ed9258c96f5a83eea99))
+* **dialog:** reset dialog dimensions for custom styling ([6712bd2](https://github.com/AlaskaAirlines/auro-formkit/commit/6712bd2cdd2e65d127c3d30f8487d79c36b0885a))
+* **dropdown, select:** handle tab key behavior across full-screen and desktop ([6db8d89](https://github.com/AlaskaAirlines/auro-formkit/commit/6db8d89866a35c4556513f7a83e430370bca3e9e))
+* **dropdown:** add matchWidth attribute for consistent dropdown sizing ([4bbfb47](https://github.com/AlaskaAirlines/auro-formkit/commit/4bbfb47d2d63f4bbbd4c605e1b1d63e9ed96bdda))
+* **dropdown:** address page scroll lock in mobile AB[#1490375](https://github.com/AlaskaAirlines/auro-formkit/issues/1490375) ([5fb0560](https://github.com/AlaskaAirlines/auro-formkit/commit/5fb0560c67e3c14b50cbc8ab191ea43d3ef6194b))
+* **dropdown:** change dialog position to relative for accurate placement ([8a31130](https://github.com/AlaskaAirlines/auro-formkit/commit/8a3113066bb26e126fb10a84b33fe2f42eb2fef6))
+* **dropdown:** enhance keyboard event handling for accessibility in modal dialogs ([37f7a0d](https://github.com/AlaskaAirlines/auro-formkit/commit/37f7a0d35d8f1d39a6ff3f20f62e8961811344e5))
+* **dropdown:** expose dialogRole property on AuroDropdownBib to avoid shadow DOM piercing ([5a0e339](https://github.com/AlaskaAirlines/auro-formkit/commit/5a0e3393fbe4c0fa8a70b7a99f32d969bb37eaf2))
+* **dropdown:** prevent layout containment on dropdown host for proper positioning ([5895d57](https://github.com/AlaskaAirlines/auro-formkit/commit/5895d5744579a54efeb53a46d070b0968f7dee41))
+* **dropdown:** prevent page scroll and enhance backdrop behavior for fullscreen dialogs on mobile ([28d1b29](https://github.com/AlaskaAirlines/auro-formkit/commit/28d1b2976c8995e1fdcaa650d780127339ca3b16))
+* **dropdown:** remove autoPlacement from right bib trigger description because they conflict ([10e6da3](https://github.com/AlaskaAirlines/auro-formkit/commit/10e6da3886037e828f263e4ac241d3d62b6b66f6))
+* **dropdown:** replace popover API with dialog element for accessibility #AB1475605 ([cd58918](https://github.com/AlaskaAirlines/auro-formkit/commit/cd5891860f985933da09a8f1c0ae3f33f44e626a)), closes [#AB1475605](https://github.com/AlaskaAirlines/auro-formkit/issues/AB1475605)
+* ensure virtual keyboard retention in fullscreen dialogs for iOS Safari ([047229d](https://github.com/AlaskaAirlines/auro-formkit/commit/047229d3bd6827d692777a96a20181e1159c81af))
+* **input, combobox:** add autofocus to input and enable focus delegation for fullscreen dialogs ([4b4bb6e](https://github.com/AlaskaAirlines/auro-formkit/commit/4b4bb6e10575b267130b1913fc9ce38d6229097f))
+* **input:** address credit card autofill validation issue AB[#1481792](https://github.com/AlaskaAirlines/auro-formkit/issues/1481792) ([4a80de0](https://github.com/AlaskaAirlines/auro-formkit/commit/4a80de0a7466744eafdceb7e98d6ef614099cb11))
+* **input:** address credit card autofill validation issue AB[#1481792](https://github.com/AlaskaAirlines/auro-formkit/issues/1481792) ([1b2b2ae](https://github.com/AlaskaAirlines/auro-formkit/commit/1b2b2ae29a56e6139eab6922d0f84de2053c77f6))
+* lint errors ([c8f5ea5](https://github.com/AlaskaAirlines/auro-formkit/commit/c8f5ea58fb77cbad130258bf25faba3baf802027))
+* **menu:** replace random ID generation with monotonic counter in auro-menuoption ([f07bc5f](https://github.com/AlaskaAirlines/auro-formkit/commit/f07bc5f24830369e62482806b61ac60225a4db87))
+* move shadowRootOptions from constructor mutation to static class field ([bef802b](https://github.com/AlaskaAirlines/auro-formkit/commit/bef802b91f38ff1147212e1b4e48f8f6a327bcc3))
+* **reset:** allow select to fully reset when function is called ([fa55e45](https://github.com/AlaskaAirlines/auro-formkit/commit/fa55e450e85721ad9f73ea42e4ca4a83547655ec))
+* **scroll:** prevent double scroll bar on menu in max-height select ([606cd8a](https://github.com/AlaskaAirlines/auro-formkit/commit/606cd8aec7be5d989f39fa43a614454eaf20667e))
+* **select, dropdown, combobox:** update Tab key behavior for accessibility compliance ([85ce2e0](https://github.com/AlaskaAirlines/auro-formkit/commit/85ce2e06866792d59a471a273fe8f411fdad255c))
+* **select:** check dropdown trigger exists ([0b7deba](https://github.com/AlaskaAirlines/auro-formkit/commit/0b7deba1f70b81ae1f7168b2ae922ee797557c1e))
+* **select:** ensure dropdown trigger is focused only if it exists ([63c7088](https://github.com/AlaskaAirlines/auro-formkit/commit/63c708870a3295c1cf15132abcd2c0986e4a6923))
+* **select:** remove autoPlacement from right bib trigger because they conflict ([cb3c463](https://github.com/AlaskaAirlines/auro-formkit/commit/cb3c463fe711a8c6f8eae281c816c72d0b9086f3))
+* **select:** restore focus to trigger after closing fullscreen dialog ([f95194c](https://github.com/AlaskaAirlines/auro-formkit/commit/f95194ca6ce2839a9eb3c1004abfec4c884dcf64))
+* **select:** scroll selected option into view when dropdown opens - rebase merge oversight ([d47e4fd](https://github.com/AlaskaAirlines/auro-formkit/commit/d47e4fd5eb5c22047385f02c3c289c9a8ed47450))
+* **select:** set focus to dropdown trigger after hiding the bib ([d047ec1](https://github.com/AlaskaAirlines/auro-formkit/commit/d047ec1de7ab298c161bc2aaa267dca4fcda54fd))
+* stringfy counter's aria-valuetext AB[#1443553](https://github.com/AlaskaAirlines/auro-formkit/issues/1443553) ([3a14172](https://github.com/AlaskaAirlines/auro-formkit/commit/3a14172df462688fcde66dcd99962378594bc159))
+* update auro-library to guard against voiceover taps dismissing dialogs ([2268a3b](https://github.com/AlaskaAirlines/auro-formkit/commit/2268a3bd79ef710eb1aa96e0f21325c782211401))
 
 
 ### Features
 
-* add story generation utilities and update stories for checkbox component ([9afbfbe](https://github.com/AlaskaAirlines/auro-formkit/commit/9afbfbe66de1eaa05ab9291ee05c71a65d810c67))
+* add focusCloseButton method for improved accessibility in fullscreen dialogs ([2cbc2e9](https://github.com/AlaskaAirlines/auro-formkit/commit/2cbc2e945f2492bb796ed3cd7e810fe12656d1ba))
+* **datepicker:** add label slots for a11y compliance AB[#1398255](https://github.com/AlaskaAirlines/auro-formkit/issues/1398255) ([7f8214e](https://github.com/AlaskaAirlines/auro-formkit/commit/7f8214e235b84d819adb58eed24b39e6c9cb159d))
+* **form:** implement Enter key submission for form elements and enhance validation logic AB[#1485830](https://github.com/AlaskaAirlines/auro-formkit/issues/1485830) ([9ddb54c](https://github.com/AlaskaAirlines/auro-formkit/commit/9ddb54c6d4a24591e4ed69ff9aca86df9a4924fa))
+* keyboardStrategy maps ([e084776](https://github.com/AlaskaAirlines/auro-formkit/commit/e084776222405978431a99e10ff7dcac31d403ad))
+* **select:** add functionality for activating option programmatically ([8afe40e](https://github.com/AlaskaAirlines/auro-formkit/commit/8afe40e889745820ff755f08fcd83caee55e47ec))
 
 
-### Reverts
+### Performance Improvements
 
-* Revert "fix: address failing a11y tests in select and combobox" ([7a40335](https://github.com/AlaskaAirlines/auro-formkit/commit/7a4033504e5cf3c94d27e2133b09e4379d405791))
-* Revert "fix: make menuoptions visible to screenreaders [#456](https://github.com/AlaskaAirlines/auro-formkit/issues/456)" ([aaddbb5](https://github.com/AlaskaAirlines/auro-formkit/commit/aaddbb585e28b38025b49b3cf72dfab598bbcef9))
+* **combobox:** improve scroll behavior for a11y support ([a45563f](https://github.com/AlaskaAirlines/auro-formkit/commit/a45563f4ac2bdd0b64ea32743b020d204896c8c5))
+* **scroll:** activated menuoption into view AB[#1489578](https://github.com/AlaskaAirlines/auro-formkit/issues/1489578) ([8787c53](https://github.com/AlaskaAirlines/auro-formkit/commit/8787c5346b1103ae83bab1249f6cf6d6a0b22ddd))
+* **select:** scroll selected menuoption into view AB[#1489578](https://github.com/AlaskaAirlines/auro-formkit/issues/1489578) ([e581feb](https://github.com/AlaskaAirlines/auro-formkit/commit/e581febaaf9ef8eabe5ccd939609758d114ea376))
 
 ### Changelog
 

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

@@ -48,6 +48,12 @@ export class AuroBibtemplate extends LitElement {
      * @returns {void}
      */
     preventBodyScroll(event: Event): void;
+    /**
+     * Focuses the close button inside the bibtemplate's shadow DOM.
+     * Used by parent components to set initial focus when the fullscreen dialog opens.
+     * @returns {void}
+     */
+    focusCloseButton(): void;
     onCloseButtonClick(): void;
     /**
      * Exposes CSS parts for styling from parent components.

package/components/bibtemplate/dist/index.js

@@ -322,6 +322,18 @@ class AuroBibtemplate extends LitElement {
     this.removeEventListener('touchmove', this.preventBodyScroll, { passive: false });
   }
 
+  /**
+   * Focuses the close button inside the bibtemplate's shadow DOM.
+   * Used by parent components to set initial focus when the fullscreen dialog opens.
+   * @returns {void}
+   */
+  focusCloseButton() {
+    const closeBtn = this.shadowRoot.querySelector('#closeButton');
+    if (closeBtn) {
+      closeBtn.focus();
+    }
+  }
+
   onCloseButtonClick() {
     this.dispatchEvent(new Event("close-click", { bubbles: true,
       composed: true }));

package/components/bibtemplate/dist/registered.js

@@ -322,6 +322,18 @@ class AuroBibtemplate extends LitElement {
     this.removeEventListener('touchmove', this.preventBodyScroll, { passive: false });
   }
 
+  /**
+   * Focuses the close button inside the bibtemplate's shadow DOM.
+   * Used by parent components to set initial focus when the fullscreen dialog opens.
+   * @returns {void}
+   */
+  focusCloseButton() {
+    const closeBtn = this.shadowRoot.querySelector('#closeButton');
+    if (closeBtn) {
+      closeBtn.focus();
+    }
+  }
+
   onCloseButtonClick() {
     this.dispatchEvent(new Event("close-click", { bubbles: true,
       composed: true }));

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

@@ -1300,7 +1300,7 @@ class AuroFormValidation {
         }
       }
 
-      if (!hasValue && elem.required && elem.touched) {
+      if (!hasValue && elem.required && (force || elem.touched)) {
         elem.validity = 'valueMissing';
         elem.errorMessage = elem.setCustomValidityValueMissing || elem.setCustomValidity || '';
       } else if (hasValue && this.runtimeUtils.elementMatch(elem, 'auro-input')) {
@@ -1324,7 +1324,7 @@ class AuroFormValidation {
       if (!isCombobox || isCombobox && !elem.persistInput) {
 
         // run validation on all inputs since we're going to use them to set the validity of this component
-        this.auroInputElements.forEach(input => input.validate());
+        this.auroInputElements.forEach(input => input.validate(force));
 
         // Reset element validity to the validity of the input
         elem.validity = this.auroInputElements[0].validity;
@@ -1687,7 +1687,7 @@ class AuroHelpText extends i$2 {
   }
 }
 
-var formkitVersion = '202602140013';
+var formkitVersion = '202603102257';
 
 // Copyright (c) 2026 Alaska Airlines. All right reserved. Licensed under the Apache-2.0 license
 // See LICENSE in the project root for license information.

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

@@ -1292,7 +1292,7 @@ class AuroFormValidation {
         }
       }
 
-      if (!hasValue && elem.required && elem.touched) {
+      if (!hasValue && elem.required && (force || elem.touched)) {
         elem.validity = 'valueMissing';
         elem.errorMessage = elem.setCustomValidityValueMissing || elem.setCustomValidity || '';
       } else if (hasValue && this.runtimeUtils.elementMatch(elem, 'auro-input')) {
@@ -1316,7 +1316,7 @@ class AuroFormValidation {
       if (!isCombobox || isCombobox && !elem.persistInput) {
 
         // run validation on all inputs since we're going to use them to set the validity of this component
-        this.auroInputElements.forEach(input => input.validate());
+        this.auroInputElements.forEach(input => input.validate(force));
 
         // Reset element validity to the validity of the input
         elem.validity = this.auroInputElements[0].validity;
@@ -1679,7 +1679,7 @@ class AuroHelpText extends i$2 {
   }
 }
 
-var formkitVersion = '202602140013';
+var formkitVersion = '202603102257';
 
 // Copyright (c) 2026 Alaska Airlines. All right reserved. Licensed under the Apache-2.0 license
 // See LICENSE in the project root for license information.

package/components/checkbox/dist/index.js

@@ -1245,7 +1245,7 @@ class AuroFormValidation {
         }
       }
 
-      if (!hasValue && elem.required && elem.touched) {
+      if (!hasValue && elem.required && (force || elem.touched)) {
         elem.validity = 'valueMissing';
         elem.errorMessage = elem.setCustomValidityValueMissing || elem.setCustomValidity || '';
       } else if (hasValue && this.runtimeUtils.elementMatch(elem, 'auro-input')) {
@@ -1269,7 +1269,7 @@ class AuroFormValidation {
       if (!isCombobox || isCombobox && !elem.persistInput) {
 
         // run validation on all inputs since we're going to use them to set the validity of this component
-        this.auroInputElements.forEach(input => input.validate());
+        this.auroInputElements.forEach(input => input.validate(force));
 
         // Reset element validity to the validity of the input
         elem.validity = this.auroInputElements[0].validity;
@@ -1632,7 +1632,7 @@ class AuroHelpText extends LitElement {
   }
 }
 
-var formkitVersion = '202602140013';
+var formkitVersion = '202603102257';
 
 // Copyright (c) 2026 Alaska Airlines. All right reserved. Licensed under the Apache-2.0 license
 // See LICENSE in the project root for license information.

package/components/checkbox/dist/registered.js

@@ -1245,7 +1245,7 @@ class AuroFormValidation {
         }
       }
 
-      if (!hasValue && elem.required && elem.touched) {
+      if (!hasValue && elem.required && (force || elem.touched)) {
         elem.validity = 'valueMissing';
         elem.errorMessage = elem.setCustomValidityValueMissing || elem.setCustomValidity || '';
       } else if (hasValue && this.runtimeUtils.elementMatch(elem, 'auro-input')) {
@@ -1269,7 +1269,7 @@ class AuroFormValidation {
       if (!isCombobox || isCombobox && !elem.persistInput) {
 
         // run validation on all inputs since we're going to use them to set the validity of this component
-        this.auroInputElements.forEach(input => input.validate());
+        this.auroInputElements.forEach(input => input.validate(force));
 
         // Reset element validity to the validity of the input
         elem.validity = this.auroInputElements[0].validity;
@@ -1632,7 +1632,7 @@ class AuroHelpText extends LitElement {
   }
 }
 
-var formkitVersion = '202602140013';
+var formkitVersion = '202603102257';
 
 // Copyright (c) 2026 Alaska Airlines. All right reserved. Licensed under the Apache-2.0 license
 // See LICENSE in the project root for license information.