@aurodesignsystem-dev/auro-formkit 0.0.0-pr1504.0 → 0.0.0-pr1506.0

package/components/select/dist/registered.js

@@ -623,7 +623,7 @@ class AuroFormValidation {
       } else if (this.runtimeUtils.elementMatch(elem, 'auro-input') && elem.errorMessage === '') {
         const input = elem.renderRoot.querySelector('input');
 
-        if (input.validationMessage.length > 0) {
+        if (input && input.validationMessage.length > 0) {
           elem.errorMessage = input.validationMessage;
         }
       } else if (this.runtimeUtils.elementMatch(elem, 'auro-combobox') && elem.errorMessage === '') {
@@ -835,6 +835,36 @@ function navigateArrow(component, direction, options = {}) {
   }
 }
 
+/**
+ * Returns the enabled (non-disabled) options for a menu, safely.
+ *
+ * Auro-menu's `options` getter returns `undefined` when the menu has no items
+ * (initItems sets `items` to undefined for empty menus). Callers that reach for
+ * `.find()` / `[...spread]` would otherwise crash; this helper normalizes the
+ * empty case to `[]` so array methods are always safe.
+ *
+ * @param {HTMLElement | null | undefined} menu - The auro-menu element.
+ * @returns {Array<HTMLElement>} Non-disabled options, empty array when none.
+ */
+function getEnabledOptions(menu) {
+  return (menu?.options || []).filter((option) => !option.disabled);
+}
+
+/**
+ * Returns the active (selectable + visible) options for type-ahead navigation.
+ *
+ * Uses auro-menuoption's `isActive` getter, which excludes disabled, hidden,
+ * and static options (e.g. `static nomatch` placeholders) so the type-ahead
+ * cursor never lands on a non-actionable item. Same empty-safe handling as
+ * `getEnabledOptions`.
+ *
+ * @param {HTMLElement | null | undefined} menu - The auro-menu element.
+ * @returns {Array<HTMLElement>} Active options, empty array when none.
+ */
+function getActiveOptions(menu) {
+  return (menu?.options || []).filter((option) => option.isActive);
+}
+
 /* eslint-disable new-cap */
 
 const selectKeyboardStrategy = {
@@ -867,6 +897,14 @@ const selectKeyboardStrategy = {
   },
 
   Escape(component, evt, ctx) {
+    // Always clear the type-ahead buffer — Escape is a universal cancel.
+    // Safe to call when the buffer is empty.
+    // eslint-disable-next-line no-underscore-dangle
+    if (typeof component._clearTypeaheadBuffer === 'function') {
+      // eslint-disable-next-line no-underscore-dangle
+      component._clearTypeaheadBuffer();
+    }
+
     if (!ctx.isExpanded) {
       return;
     }
@@ -883,7 +921,8 @@ const selectKeyboardStrategy = {
     }
     evt.preventDefault();
     evt.stopPropagation();
-    const lastOption = [...component.menu.menuService.menuOptions].reverse().find((option) => !option.disabled);
+    // `pop()` is safe here: getEnabledOptions returns a fresh filtered array.
+    const lastOption = getEnabledOptions(component.menu).pop();
     if (lastOption) {
       component.menu.updateActiveOption(lastOption);
     }
@@ -905,7 +944,7 @@ const selectKeyboardStrategy = {
     }
     evt.preventDefault();
     evt.stopPropagation();
-    const firstOption = component.menu.menuService.menuOptions.find((option) => !option.disabled);
+    const [firstOption] = getEnabledOptions(component.menu);
     if (firstOption) {
       component.menu.updateActiveOption(firstOption);
     }
@@ -925,16 +964,25 @@ const selectKeyboardStrategy = {
   },
 
   default(component, evt, ctx) {
-    component.updateActiveOptionBasedOnKey(evt.key);
+    // Space resolves to either typeahead-buffer extension or bib toggle
+    // depending on whether a type-ahead buffer is active. Mirrors native
+    // <select> and the WAI-ARIA APG Listbox guidance: mid-typeahead space
+    // is a search character (e.g. "San Francisco"); otherwise it toggles.
     if (evt.key === ' ') {
       evt.preventDefault();
       evt.stopPropagation();
+      if (component.typeaheadBuffer && component.typeaheadBuffer.length > 0) {
+        component.updateActiveOptionBasedOnKey(evt.key);
+        return;
+      }
       if (ctx.isExpanded) {
         component.dropdown.hide();
-        return;
+      } else {
+        component.dropdown.show();
       }
-      component.dropdown.show();
+      return;
     }
+    component.updateActiveOptionBasedOnKey(evt.key);
   },
 };
 
@@ -4846,7 +4894,7 @@ let AuroHelpText$1 = class AuroHelpText extends LitElement {
   }
 };
 
-var formkitVersion$1 = '202606141505';
+var formkitVersion$1 = '202606190840';
 
 class AuroElement extends LitElement {
   static get properties() {
@@ -6859,7 +6907,7 @@ class AuroHelpText extends LitElement {
   }
 }
 
-var formkitVersion = '202606141505';
+var formkitVersion = '202606190840';
 
 var styleCss = 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}.body-default{font-size:var(--wcss-body-default-font-size, 1rem);font-weight:var(--wcss-body-default-weight, );line-height:var(--wcss-body-default-line-height, 1.5rem)}.body-default,.body-default-emphasized{font-family:var(--wcss-body-family, "AS Circular"),system-ui,-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif;letter-spacing:var(--wcss-body-letter-spacing, 0)}.body-default-emphasized{font-size:var(--wcss-body-default-emphasized-font-size, 1rem);font-weight:var(--wcss-body-default-emphasized-weight, );line-height:var(--wcss-body-default-emphasized-line-height, 1.5rem)}.body-lg{font-size:var(--wcss-body-lg-font-size, 1.125rem);font-weight:var(--wcss-body-lg-weight, );line-height:var(--wcss-body-lg-line-height, 1.625rem)}.body-lg,.body-lg-emphasized{font-family:var(--wcss-body-family, "AS Circular"),system-ui,-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif;letter-spacing:var(--wcss-body-letter-spacing, 0)}.body-lg-emphasized{font-size:var(--wcss-body-lg-emphasized-font-size, 1.125rem);font-weight:var(--wcss-body-lg-emphasized-weight, );line-height:var(--wcss-body-lg-emphasized-line-height, 1.625rem)}.body-sm{font-size:var(--wcss-body-sm-font-size, 0.875rem);font-weight:var(--wcss-body-sm-weight, );line-height:var(--wcss-body-sm-line-height, 1.25rem)}.body-sm,.body-sm-emphasized{font-family:var(--wcss-body-family, "AS Circular"),system-ui,-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif;letter-spacing:var(--wcss-body-letter-spacing, 0)}.body-sm-emphasized{font-size:var(--wcss-body-sm-emphasized-font-size, 0.875rem);font-weight:var(--wcss-body-sm-emphasized-weight, );line-height:var(--wcss-body-sm-emphasized-line-height, 1.25rem)}.body-xs{font-size:var(--wcss-body-xs-font-size, 0.75rem);font-weight:var(--wcss-body-xs-weight, );line-height:var(--wcss-body-xs-line-height, 1rem)}.body-xs,.body-xs-emphasized{font-family:var(--wcss-body-family, "AS Circular"),system-ui,-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif;letter-spacing:var(--wcss-body-letter-spacing, 0)}.body-xs-emphasized{font-size:var(--wcss-body-xs-emphasized-font-size, 0.75rem);font-weight:var(--wcss-body-xs-emphasized-weight, );line-height:var(--wcss-body-xs-emphasized-line-height, 1rem)}.body-2xs{font-size:var(--wcss-body-2xs-font-size, 0.625rem);font-weight:var(--wcss-body-2xs-weight, );line-height:var(--wcss-body-2xs-line-height, 0.875rem)}.body-2xs,.body-2xs-emphasized{font-family:var(--wcss-body-family, "AS Circular"),system-ui,-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif;letter-spacing:var(--wcss-body-letter-spacing, 0)}.body-2xs-emphasized{font-size:var(--wcss-body-2xs-emphasized-font-size, 0.625rem);font-weight:var(--wcss-body-2xs-emphasized-weight, );line-height:var(--wcss-body-2xs-emphasized-line-height, 0.875rem)}.display-2xl{font-family:var(--wcss-display-2xl-family, "AS Circular"),var(--wcss-display-2xl-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-size:var(--wcss-display-2xl-font-size, clamp(3.5rem, 6vw, 5.375rem));font-weight:var(--wcss-display-2xl-weight, 300);letter-spacing:var(--wcss-display-2xl-letter-spacing, 0);line-height:var(--wcss-display-2xl-line-height, 1.3)}.display-xl{font-family:var(--wcss-display-xl-family, "AS Circular"),var(--wcss-display-xl-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-size:var(--wcss-display-xl-font-size, clamp(3rem, 5.3333333333vw, 4.5rem));font-weight:var(--wcss-display-xl-weight, 300);letter-spacing:var(--wcss-display-xl-letter-spacing, 0);line-height:var(--wcss-display-xl-line-height, 1.3)}.display-lg{font-family:var(--wcss-display-lg-family, "AS Circular"),var(--wcss-display-lg-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-size:var(--wcss-display-lg-font-size, clamp(2.75rem, 4.6666666667vw, 4rem));font-weight:var(--wcss-display-lg-weight, 300);letter-spacing:var(--wcss-display-lg-letter-spacing, 0);line-height:var(--wcss-display-lg-line-height, 1.3)}.display-md{font-family:var(--wcss-display-md-family, "AS Circular"),var(--wcss-display-md-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-size:var(--wcss-display-md-font-size, clamp(2.5rem, 4vw, 3.5rem));font-weight:var(--wcss-display-md-weight, 300);letter-spacing:var(--wcss-display-md-letter-spacing, 0);line-height:var(--wcss-display-md-line-height, 1.3)}.display-sm{font-family:var(--wcss-display-sm-family, "AS Circular"),var(--wcss-display-sm-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-size:var(--wcss-display-sm-font-size, clamp(2rem, 3.6666666667vw, 3rem));font-weight:var(--wcss-display-sm-weight, 300);letter-spacing:var(--wcss-display-sm-letter-spacing, 0);line-height:var(--wcss-display-sm-line-height, 1.3)}.display-xs{font-family:var(--wcss-display-xs-family, "AS Circular"),var(--wcss-display-xs-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-size:var(--wcss-display-xs-font-size, clamp(1.75rem, 3vw, 2.375rem));font-weight:var(--wcss-display-xs-weight, 300);letter-spacing:var(--wcss-display-xs-letter-spacing, 0);line-height:var(--wcss-display-xs-line-height, 1.3)}.heading-xl{font-family:var(--wcss-heading-xl-family, "AS Circular"),var(--wcss-heading-xl-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-size:var(--wcss-heading-xl-font-size, clamp(2rem, 3vw, 2.5rem));font-weight:var(--wcss-heading-xl-weight, 300);letter-spacing:var(--wcss-heading-xl-letter-spacing, 0);line-height:var(--wcss-heading-xl-line-height, 1.3)}.heading-lg{font-family:var(--wcss-heading-lg-family, "AS Circular"),var(--wcss-heading-lg-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-size:var(--wcss-heading-lg-font-size, clamp(1.75rem, 2.6666666667vw, 2.25rem));font-weight:var(--wcss-heading-lg-weight, 300);letter-spacing:var(--wcss-heading-lg-letter-spacing, 0);line-height:var(--wcss-heading-lg-line-height, 1.3)}.heading-md{font-family:var(--wcss-heading-md-family, "AS Circular"),var(--wcss-heading-md-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-size:var(--wcss-heading-md-font-size, clamp(1.625rem, 2.3333333333vw, 1.75rem));font-weight:var(--wcss-heading-md-weight, 300);letter-spacing:var(--wcss-heading-md-letter-spacing, 0);line-height:var(--wcss-heading-md-line-height, 1.3)}.heading-sm{font-family:var(--wcss-heading-sm-family, "AS Circular"),var(--wcss-heading-sm-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-size:var(--wcss-heading-sm-font-size, clamp(1.375rem, 2vw, 1.5rem));font-weight:var(--wcss-heading-sm-weight, 300);letter-spacing:var(--wcss-heading-sm-letter-spacing, 0);line-height:var(--wcss-heading-sm-line-height, 1.3)}.heading-xs{font-family:var(--wcss-heading-xs-family, "AS Circular"),var(--wcss-heading-xs-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-size:var(--wcss-heading-xs-font-size, clamp(1.25rem, 1.6666666667vw, 1.25rem));font-weight:var(--wcss-heading-xs-weight, 300);letter-spacing:var(--wcss-heading-xs-letter-spacing, 0);line-height:var(--wcss-heading-xs-line-height, 1.3)}.heading-2xs{font-family:var(--wcss-heading-2xs-family, "AS Circular"),var(--wcss-heading-2xs-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-size:var(--wcss-heading-2xs-font-size, clamp(1.125rem, 1.5vw, 1.125rem));font-weight:var(--wcss-heading-2xs-weight, 300);letter-spacing:var(--wcss-heading-2xs-letter-spacing, 0);line-height:var(--wcss-heading-2xs-line-height, 1.3)}.accent-2xl{font-family:var(--wcss-accent-2xl-family, "Good OT"),var(--wcss-accent-2xl-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-size:var(--wcss-accent-2xl-font-size, clamp(2rem, 3.1666666667vw, 2.375rem));font-weight:var(--wcss-accent-2xl-weight, 450);letter-spacing:var(--wcss-accent-2xl-letter-spacing, 0.05em);line-height:var(--wcss-accent-2xl-line-height, 1)}.accent-2xl,.accent-xl{text-transform:uppercase}.accent-xl{font-family:var(--wcss-accent-xl-family, "Good OT"),var(--wcss-accent-xl-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-size:var(--wcss-accent-xl-font-size, clamp(1.625rem, 2.3333333333vw, 2rem));font-weight:var(--wcss-accent-xl-weight, 450);letter-spacing:var(--wcss-accent-xl-letter-spacing, 0.05em);line-height:var(--wcss-accent-xl-line-height, 1.3)}.accent-lg{font-family:var(--wcss-accent-lg-family, "Good OT"),var(--wcss-accent-lg-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-size:var(--wcss-accent-lg-font-size, clamp(1.5rem, 2.1666666667vw, 1.75rem));font-weight:var(--wcss-accent-lg-weight, 450);letter-spacing:var(--wcss-accent-lg-letter-spacing, 0.05em);line-height:var(--wcss-accent-lg-line-height, 1.3)}.accent-lg,.accent-md{text-transform:uppercase}.accent-md{font-family:var(--wcss-accent-md-family, "Good OT"),var(--wcss-accent-md-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-size:var(--wcss-accent-md-font-size, clamp(1.375rem, 1.8333333333vw, 1.5rem));font-weight:var(--wcss-accent-md-weight, 500);letter-spacing:var(--wcss-accent-md-letter-spacing, 0.05em);line-height:var(--wcss-accent-md-line-height, 1.3)}.accent-sm{font-family:var(--wcss-accent-sm-family, "Good OT"),var(--wcss-accent-sm-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-size:var(--wcss-accent-sm-font-size, clamp(1.125rem, 1.5vw, 1.25rem));font-weight:var(--wcss-accent-sm-weight, 500);letter-spacing:var(--wcss-accent-sm-letter-spacing, 0.05em);line-height:var(--wcss-accent-sm-line-height, 1.3)}.accent-sm,.accent-xs{text-transform:uppercase}.accent-xs{font-family:var(--wcss-accent-xs-family, "Good OT"),var(--wcss-accent-xs-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-size:var(--wcss-accent-xs-font-size, clamp(1rem, 1.3333333333vw, 1rem));font-weight:var(--wcss-accent-xs-weight, 500);letter-spacing:var(--wcss-accent-xs-letter-spacing, 0.1em);line-height:var(--wcss-accent-xs-line-height, 1.3)}.accent-2xs{font-family:var(--wcss-accent-2xs-family, "Good OT"),var(--wcss-accent-2xs-family-fallback, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif);font-size:var(--wcss-accent-2xs-font-size, clamp(0.875rem, 1.1666666667vw, 0.875rem));font-weight:var(--wcss-accent-2xs-weight, 450);letter-spacing:var(--wcss-accent-2xs-letter-spacing, 0.1em);line-height:var(--wcss-accent-2xs-line-height, 1.3);text-transform:uppercase}[auro-dropdown]{--ds-auro-dropdown-trigger-border-color: var(--ds-auro-select-border-color);--ds-auro-dropdown-trigger-background-color: var(--ds-auro-select-background-color);--ds-auro-dropdown-trigger-container-color: var(--ds-auro-select-background-color);--ds-auro-dropdown-trigger-outline-color: var(--ds-auro-select-outline-color)}:host{display:inline-block;text-align:left;vertical-align:top}:host([layout*=emphasized]) [auro-dropdown],:host([layout*=snowflake]) [auro-dropdown]{--ds-auro-select-border-color: transparent}:host([layout*=emphasized]) .mainContent,:host([layout*=snowflake]) .mainContent{text-align:center}.mainContent{position:relative;display:flex;overflow:hidden;flex:1;flex-direction:column;align-items:center;justify-content:center}.valueContainer [slot=displayValue]{display:none}.accents{display:flex;flex-direction:row;align-items:center;justify-content:center}::slotted([slot=typeIcon]){margin-right:var(--ds-size-100, 0.5rem)}.displayValue{display:block}.displayValue:not(.force){display:none}.displayValue:not(.force).hasContent:is(.withValue):not(.hasFocus){display:block}.triggerContent{display:flex;width:100%;align-items:center;justify-content:center}:host([layout*=emphasized]) .triggerContent{padding:0 var(--ds-size-100, 0.5rem) 0 var(--ds-size-300, 1.5rem)}:host([layout*=snowflake]) .triggerContent{padding:0 var(--ds-size-100, 0.5rem) 0 var(--ds-size-200, 1rem)}:host([layout*=snowflake]) label{padding-block:var(--ds-size-25, 0.125rem)}:host([layout*=classic]) .triggerContent{padding:0 var(--ds-size-100, 0.5rem)}:host([layout*=classic]) .mainContent{align-items:start}:host([layout*=classic]) label{overflow:hidden;cursor:text;text-overflow:ellipsis;white-space:nowrap}:host([layout*=classic]) .value{height:auto}label{color:var(--ds-auro-select-label-text-color)}:host(:is([validity]:not([validity=valid]))) [auro-dropdown]{--ds-auro-select-border-color: var(--ds-basic-color-status-error, #e31f26);--ds-auro-select-outline-color: var(--ds-basic-color-status-error, #e31f26);--ds-auro-dropdown-helptext-text-color: var(--ds-basic-color-texticon-default, #2a2a2a)}:host([ondark]:is([validity]:not([validity=valid]))) [auro-dropdown],:host([appearance=inverse]:is([validity]:not([validity=valid]))) [auro-dropdown]{--ds-auro-select-border-color: var(--ds-advanced-color-state-error-inverse, #f9a4a8);--ds-auro-select-outline-color: var(--ds-advanced-color-state-error-inverse, #f9a4a8);--ds-auro-dropdown-helptext-text-color: var(--ds-basic-color-texticon-inverse, #ffffff)}#slotHolder{display:none}:host([fluid]){width:100%}:host([disabled]){pointer-events:none;user-select:none}:host([disabled]:not([ondark])) [auro-dropdown],:host([disabled]:not([appearance=inverse])) [auro-dropdown]{--ds-auro-select-border-color: var(--ds-basic-color-border-subtle, #dddddd)}:host(:not([layout*=classic])[disabled][ondark]) [auro-dropdown],:host(:not([layout*=classic])[disabled][appearance=inverse]) [auro-dropdown]{--ds-auro-select-border-color: transparent}`;
 
@@ -6964,6 +7012,16 @@ class AuroSelect extends AuroElement$1 {
      * @private
      */
     this.hasDisplayValueContent = false;
+
+    /**
+     * @private
+     */
+    this.typeaheadBuffer = '';
+
+    /**
+     * @private
+     */
+    this._typeaheadTimeout = null;
   }
 
   /**
@@ -6976,6 +7034,7 @@ class AuroSelect extends AuroElement$1 {
     this.fullscreenBreakpoint = 'sm';
     this.onDark = false;
     this.isPopoverVisible = false;
+    this.typeaheadTimeoutMs = 500;
 
     // Layout Config
     this.layout = 'classic';
@@ -7279,6 +7338,16 @@ class AuroSelect extends AuroElement$1 {
         attribute: false
       },
 
+      /**
+       * Milliseconds of keyboard inactivity before the type-ahead buffer resets.
+       * Increase for users who type slowly.
+       * @default 500
+       */
+      typeaheadTimeoutMs: {
+        type: Number,
+        reflect: true
+      },
+
       /**
        * Specifies the `validityState` this element is in.
        */
@@ -7411,7 +7480,7 @@ class AuroSelect extends AuroElement$1 {
             this.menu.updateActiveOption(this.optionSelected[0]);
           } else {
             // If no activeOption has yet to be set, then make the first enabled option active by default
-            const firstActive = this.menu.menuService.menuOptions.find((option) => !option.disabled);
+            const [firstActive] = getEnabledOptions(this.menu);
             this.menu.updateActiveOption(firstActive);
           }
         }
@@ -7635,12 +7704,23 @@ class AuroSelect extends AuroElement$1 {
       this.menu.multiSelect = this.multiSelect;
     }
 
+    // Menu's items are populated by initItems() during its firstUpdated/slotchange.
+    // Since the parent select's firstUpdated runs before the child menu's, call initItems()
+    // here so renderNativeSelect can render the native <option> list on first paint.
+    if (typeof this.menu.initItems === 'function') {
+      this.menu.initItems();
+    }
     this.options = this.menu.options;
     this.updateOptionPositions();
     this.menu.addEventListener("auroMenu-loadingChange", (event) => this.handleMenuLoadingChange(event));
 
-    this.menu.addEventListener("auroMenu-deselectPrevented", () => {
-      this.hideBib();
+    this.menu.addEventListener("auroMenu-selectValueFailure", () => {
+      this.value = undefined;
+      this.optionSelected = this.multiSelect ? [] : undefined;
+      // The trigger label is rendered imperatively into #value, so a property
+      // change alone won't clear it. Refresh so stale text doesn't linger when
+      // a runtime value change fails to match any option.
+      this.updateDisplayedValue();
     });
 
     this.menu.addEventListener('auroMenu-activatedOption', (evt) => {
@@ -7662,16 +7742,20 @@ class AuroSelect extends AuroElement$1 {
       }
     });
 
-    this.menu.addEventListener('auroMenu-selectedOption', (event) => {
+    this.menu.addEventListener('auroMenu-selectedOption', () => {
 
       // Update the displayed value
       this.updateDisplayedValue();
 
-      const options = event.detail.options || [];
-
-      this.value = event.detail.stringValue;
+      this.value = this.menu.value;
 
-      this.optionSelected = this.multiSelect ? options : options[0];
+      // Clone the multiselect array so external mutation of select.optionSelected
+      // can't reach back into menu's internal state through a shared reference.
+      let nextSelected = this.menu.optionSelected;
+      if (this.multiSelect) {
+        nextSelected = Array.isArray(nextSelected) ? [...nextSelected] : [];
+      }
+      this.optionSelected = nextSelected;
 
       if (this.dropdown.isPopoverVisible && !this.multiSelect) {
         this.dropdown.hide();
@@ -7680,7 +7764,7 @@ class AuroSelect extends AuroElement$1 {
 
       // Announce the selection after the dropdown closes so it isn't
       // overridden by VoiceOver's "collapsed" announcement from aria-expanded.
-      const selectedValue = event.detail.stringValue;
+      const selectedValue = this.menu.currentLabel;
       const announcementDelay = 300;
       setTimeout(() => {
         announceToScreenReader(this._getAnnouncementRoot(), `${selectedValue}, selected`);
@@ -7703,6 +7787,7 @@ class AuroSelect extends AuroElement$1 {
     this.addEventListener('blur', () => {
       this.validate();
       this.hasFocus = false;
+      this._clearTypeaheadBuffer();
     });
   }
 
@@ -7716,41 +7801,89 @@ class AuroSelect extends AuroElement$1 {
     }
   }
 
+  /**
+   * Returns the lowercase, trimmed text content of a menu option.
+   * @private
+   * @param {HTMLElement} option - The menu option element.
+   * @returns {string}
+   */
+  _getOptionDisplayText(option) {
+    return (option.textContent || '').trim().toLowerCase();
+  }
+
+  /**
+   * Empties the type-ahead buffer and cancels any pending reset timeout.
+   * Called when focus leaves the component, when Escape closes the bib, and on disconnect
+   * so a stale buffer never bridges into a fresh interaction.
+   * @private
+   */
+  _clearTypeaheadBuffer() {
+    if (this._typeaheadTimeout) {
+      clearTimeout(this._typeaheadTimeout);
+      this._typeaheadTimeout = null;
+    }
+    this.typeaheadBuffer = '';
+  }
+
   /**
    * Updates the active option in the menu based on keyboard input.
+   *
+   * Implements the WAI-ARIA APG Listbox type-ahead pattern: accumulates printable
+   * keystrokes into a buffer that resets after `typeaheadTimeoutMs` of inactivity.
+   * A multi-character buffer matches the first option whose displayed text starts
+   * with the buffer; repeating a single character cycles through options that start
+   * with that character.
    * @private
    * @param {string} _key - The key pressed by the user.
    * @returns {void}
    */
   updateActiveOptionBasedOnKey(_key) {
+    // Ignore non-printable keys (Shift, ArrowDown, Tab, etc.)
+    if (typeof _key !== 'string' || _key.length !== 1) {
+      return;
+    }
 
-    // Get a lowercase version of the key pressed
-    const key = _key.toLowerCase();
-
-    // Calculate how many times the same letter has been pressed
-    this.sameLetterTimes = key === this.lastLetter ? this.sameLetterTimes + 1 : 0;
+    // No selectable options to match against — clear any stale buffer/timer so
+    // Space stays a bib toggle and the next keystroke after fresh options load
+    // starts cleanly. `getActiveOptions` excludes disabled, hidden, and static
+    // options (e.g. `static nomatch` placeholders). Checked BEFORE mutating
+    // the buffer.
+    const options = getActiveOptions(this.menu);
+    if (!options.length) {
+      this._clearTypeaheadBuffer();
+      return;
+    }
 
-    // Set last letter for tracking
-    this.lastLetter = key;
+    const key = _key.toLowerCase();
 
-    // Get all the options that start with the last letter pressed
-    const letterOptions = this.menu.options.filter((option) => {
-      const optionText = option.value || '';
-      return optionText.toLowerCase().startsWith(this.lastLetter);
-    });
+    // Reset the buffer after a period of inactivity
+    if (this._typeaheadTimeout) {
+      clearTimeout(this._typeaheadTimeout);
+    }
+    this._typeaheadTimeout = setTimeout(() => {
+      this._clearTypeaheadBuffer();
+    }, this.typeaheadTimeoutMs);
 
-    // If we have options that match the letter pressed
-    if (letterOptions.length) {
+    this.typeaheadBuffer += key;
 
-      // Show the dropdown if it is not already visible
-      this.dropdown.show();
+    const isRepeatedChar = this.typeaheadBuffer.length > 1 && new Set(this.typeaheadBuffer).size === 1;
 
-      // Get the index we're after based on how many times the letter has been pressed and the length of the letterOptions array
-      const index = this.sameLetterTimes < letterOptions.length ? this.sameLetterTimes : this.sameLetterTimes % letterOptions.length;
+    let match = null;
+    if (isRepeatedChar) {
+      const matches = options.filter((option) => this._getOptionDisplayText(option).startsWith(key));
+      if (matches.length) {
+        const cycleIndex = (this.typeaheadBuffer.length - 1) % matches.length;
+        match = matches[cycleIndex];
+      }
+    } else {
+      match = options.find((option) => this._getOptionDisplayText(option).startsWith(this.typeaheadBuffer));
+    }
 
-      // Select the new option in the menu
-      const newOption = letterOptions[index];
-      this.menu.updateActiveOption(newOption);
+    if (match) {
+      if (!this.dropdown.isPopoverVisible) {
+        this.dropdown.show();
+      }
+      this.menu.updateActiveOption(match);
     }
   }
 
@@ -7864,6 +7997,11 @@ class AuroSelect extends AuroElement$1 {
     }
   }
 
+  disconnectedCallback() {
+    super.disconnectedCallback();
+    this._clearTypeaheadBuffer();
+  }
+
   // lifecycle runs only after the element's DOM has been updated the first time
   firstUpdated() {
     // Add the tag name as an attribute if it is different than the component name
@@ -7876,7 +8014,7 @@ class AuroSelect extends AuroElement$1 {
 
   setMenuValue(value) {
     if (!this.menu) return;
-    this.menu.value = value;
+    this.menu.selectByValue(value);
   }
 
   /**

package/components/select/dist/selectUtils.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Returns the enabled (non-disabled) options for a menu, safely.
+ *
+ * Auro-menu's `options` getter returns `undefined` when the menu has no items
+ * (initItems sets `items` to undefined for empty menus). Callers that reach for
+ * `.find()` / `[...spread]` would otherwise crash; this helper normalizes the
+ * empty case to `[]` so array methods are always safe.
+ *
+ * @param {HTMLElement | null | undefined} menu - The auro-menu element.
+ * @returns {Array<HTMLElement>} Non-disabled options, empty array when none.
+ */
+export function getEnabledOptions(menu: HTMLElement | null | undefined): Array<HTMLElement>;
+/**
+ * Returns the active (selectable + visible) options for type-ahead navigation.
+ *
+ * Uses auro-menuoption's `isActive` getter, which excludes disabled, hidden,
+ * and static options (e.g. `static nomatch` placeholders) so the type-ahead
+ * cursor never lands on a non-actionable item. Same empty-safe handling as
+ * `getEnabledOptions`.
+ *
+ * @param {HTMLElement | null | undefined} menu - The auro-menu element.
+ * @returns {Array<HTMLElement>} Active options, empty array when none.
+ */
+export function getActiveOptions(menu: HTMLElement | null | undefined): Array<HTMLElement>;