@aurodesignsystem-dev/auro-formkit 0.0.0-pr1522.3 → 0.0.0-pr1524.1

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

@@ -1275,7 +1275,7 @@ class AuroHelpText extends i$2 {
   }
 }
 
-var formkitVersion = '202607012103';
+var formkitVersion = '202607022214';
 
 // Copyright (c) 2026 Alaska Airlines. All rights reserved. Licensed under the Apache-2.0 license
 // See LICENSE in the project root for license information.

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

@@ -1275,7 +1275,7 @@ class AuroHelpText extends i$2 {
   }
 }
 
-var formkitVersion = '202607012103';
+var formkitVersion = '202607022214';
 
 // Copyright (c) 2026 Alaska Airlines. All rights reserved. Licensed under the Apache-2.0 license
 // See LICENSE in the project root for license information.

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

@@ -1275,7 +1275,7 @@ class AuroHelpText extends i$2 {
   }
 }
 
-var formkitVersion = '202607012103';
+var formkitVersion = '202607022214';
 
 // Copyright (c) 2026 Alaska Airlines. All rights reserved. Licensed under the Apache-2.0 license
 // See LICENSE in the project root for license information.

package/components/checkbox/dist/index.js

@@ -1228,7 +1228,7 @@ class AuroHelpText extends LitElement {
   }
 }
 
-var formkitVersion = '202607012103';
+var formkitVersion = '202607022214';
 
 // Copyright (c) 2026 Alaska Airlines. All rights reserved. Licensed under the Apache-2.0 license
 // See LICENSE in the project root for license information.

package/components/checkbox/dist/registered.js

@@ -1228,7 +1228,7 @@ class AuroHelpText extends LitElement {
   }
 }
 
-var formkitVersion = '202607012103';
+var formkitVersion = '202607022214';
 
 // Copyright (c) 2026 Alaska Airlines. All rights reserved. Licensed under the Apache-2.0 license
 // See LICENSE in the project root for license information.

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

@@ -4879,7 +4879,7 @@ let AuroHelpText$2 = class AuroHelpText extends i$3 {
   }
 };
 
-var formkitVersion$2 = '202607012103';
+var formkitVersion$2 = '202607022214';
 
 let AuroElement$2 = class AuroElement extends i$3 {
   static get properties() {
@@ -17768,14 +17768,17 @@ class BaseInput extends AuroElement$1 {
    * @returns {void}
    */
   notifyValueChanged() {
-    let inputEvent = null;
-
-    inputEvent = new Event('input', {
+    // This echoes Lit's reactive value update (and handleClickClear's
+    // programmatic clear) — it is NOT a fresh user-input event. Mark it
+    // `isProgrammatic` so consumers (e.g. auro-combobox) can distinguish
+    // it from genuine user typing and skip clobbering their own
+    // programmatic state during init-time renders.
+    const inputEvent = new Event('input', {
       bubbles: true,
       composed: true,
     });
+    inputEvent.isProgrammatic = true;
 
-    // Dispatched event to alert outside shadow DOM context of event firing.
     this.dispatchEvent(inputEvent);
   }
 
@@ -18488,7 +18491,7 @@ let AuroHelpText$1 = class AuroHelpText extends i$3 {
   }
 };
 
-var formkitVersion$1 = '202607012103';
+var formkitVersion$1 = '202607022214';
 
 // Copyright (c) 2025 Alaska Airlines. All right reserved. Licensed under the Apache-2.0 license
 // See LICENSE in the project root for license information.
@@ -18774,20 +18777,15 @@ class AuroInput extends BaseInput {
    * @returns {void}
    */
   checkDisplayValueSlotChange() {
-    let nodes = this.shadowRoot.querySelector('slot[name="displayValue"]').assignedNodes();
-
-    // Handle when DisplayValue is multi-level slot content (e.g. combobox passing displayValue to input)
-    if (nodes && nodes[0] && nodes[0].tagName === 'SLOT') {
-      nodes = nodes[0].assignedNodes();
-    }
-
-    let hasContent = false;
-
-    if (nodes.length > 0) {
-      hasContent = true;
-    }
+    // flatten:true resolves through auro-combobox's forwarding slot
+    // (<slot name="displayValue" slot="displayValue">) so a clone appended
+    // directly to auro-input's light DOM alongside the forwarder still
+    // counts as content. The prior nodes[0].tagName === 'SLOT' recursion
+    // discarded any siblings past the forwarder.
+    const slot = this.shadowRoot.querySelector('slot[name="displayValue"]');
+    const nodes = slot.assignedNodes({ flatten: true });
 
-    this.hasDisplayValueContent = hasContent;
+    this.hasDisplayValueContent = nodes.length > 0;
   }
 
   firstUpdated() {
@@ -19614,7 +19612,7 @@ class AuroBibtemplate extends i$3 {
   }
 }
 
-var formkitVersion = '202607012103';
+var formkitVersion = '202607022214';
 
 var styleCss$3 = i$6`.util_displayInline{display:inline}.util_displayInlineBlock{display:inline-block}.util_displayBlock{display:block}.util_displayFlex{display:flex}.util_displayHidden{display:none}.util_displayHiddenVisually{position:absolute;overflow:hidden;clip:rect(1px, 1px, 1px, 1px);width:1px;height:1px;padding:0;border:0}:host{display:block;text-align:left}:host [auro-dropdown]{--ds-auro-dropdown-trigger-background-color: transparent}:host #inputInBib::part(wrapper){box-shadow:none}:host #inputInBib::part(accent-left){display:none}:host([layout*=classic]) [auro-input]{width:100%}:host([layout*=classic]) [auro-input]::part(helpText){display:none}:host([layout*=classic]) #slotHolder{display:none}`;
 
@@ -20713,9 +20711,19 @@ class AuroCombobox extends AuroElement {
   /**
    * Processes hidden state of all menu options and determines if there are any available options not hidden.
    * @private
+   * @param {object} [options={}] - Optional flag bag.
+   * @param {boolean} [options.preferComboboxValue=false] - When true,
+   *   handleMenuOptions matches the selected option against `this.value`
+   *   first instead of `this.input.value`. Needed on mount and re-mount
+   *   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
+   *   and clearing paths keep the input-first match so user clears aren't
+   *   undone.
    * @returns {void}
    */
-  handleMenuOptions() {
+  handleMenuOptions({ preferComboboxValue = false } = {}) {
     this.generateOptionsArray();
     this.availableOptions = [];
     // Single source of truth for the menu's filter/highlight token per call.
@@ -20736,7 +20744,20 @@ class AuroCombobox extends AuroElement {
       option.setAttribute('aria-posinset', index + 1);
     });
 
-    if (this.input.value && this.menu.options && this.menu.options.some((opt) => opt.value === this.input.value)) {
+    // On mount/re-mount (via handleSlotChange), prefer the framework-set
+    // `this.value` when it matches a menu option. Covers SPA preselect and
+    // consumer swap patterns (e.g. Svelte `{#key}` re-mount) where
+    // `this.value` is authoritative but `this.input.value` may be empty or
+    // carry stale typed text from another field. Event-driven callers do
+    // not pass the flag, otherwise user clears would be undone by
+    // re-syncing to the previous combobox.value.
+    if (preferComboboxValue &&
+        this.value &&
+        this.menu.options?.some((opt) => opt.value === this.value)) {
+      this.setMenuValue(this.value);
+      this.syncValuesAndStates();
+    } else if (this.input.value &&
+        this.menu.options?.some((opt) => opt.value === this.input.value)) {
       this.setMenuValue(this.input.value);
       this.syncValuesAndStates();
     }
@@ -21173,7 +21194,25 @@ class AuroCombobox extends AuroElement {
       this.optionActive = evt.detail;
 
       if (this.input) {
-        this.input.setActiveDescendant(this.optionActive);
+        // setActiveDescendant runs after Lit's update finishes because the
+        // template's `.a11yActivedescendant` binding calls setAttribute on
+        // the internal <input> in auro-input.updated(), which clears the
+        // reflected ariaActiveDescendantElement property. Setting the ref
+        // synchronously here would get overwritten by that attribute write.
+        // Awaiting updateComplete lets the attribute write finish first,
+        // then the ref sticks and screen readers can cross the shadow-DOM
+        // boundary to the auro-menuoption in light DOM.
+        //
+        // The equality check covers the async gap: this.optionActive can
+        // change before the callback runs (user arrowed elsewhere, or the
+        // menu closed and cleared it to null), so we bail if the target
+        // no longer matches to avoid reinstating a stale ref.
+        const targetOption = this.optionActive;
+        this.updateComplete.then(() => {
+          if (this.input && this.optionActive === targetOption) {
+            this.input.setActiveDescendant(targetOption);
+          }
+        });
       }
 
       // In fullscreen mode the menu sits inside a nested <dialog> shadow root,
@@ -21310,6 +21349,18 @@ class AuroCombobox extends AuroElement {
       }
     }
 
+    // SPA preselect guard: on init render, auro-input's notifyValueChanged
+    // echoes an empty value through as an isProgrammatic input event before
+    // the framework-set combobox.value has propagated down to the input.
+    // Without this bail, the `this.value = this.input.value` below clobbers
+    // the framework value with '' and clear() wipes optionSelected. Scoped
+    // to the exact shape of that echo (isProgrammatic + non-empty combobox
+    // value + empty input.value) so it doesn't affect the swap/typed paths
+    // where value/input already track each other through the sync helpers.
+    if (event && event.isProgrammatic && this.value && !this.input.value) {
+      return;
+    }
+
     this.value = this.input.value;
 
     // Ignore re-entrant input events caused by programmatic value sets.
@@ -21742,7 +21793,11 @@ class AuroCombobox extends AuroElement {
           }
         });
 
-        this.handleMenuOptions();
+        // Slot change (mount/re-mount): pass `preferComboboxValue` so that a
+        // framework-set `this.value` wins over any stale `input.value` when
+        // matching against the newly-available options. Fixes the display
+        // for SPA preselect and Svelte `{#key}` re-mount swap patterns.
+        this.handleMenuOptions({ preferComboboxValue: true });
 
         break;
 

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

@@ -4879,7 +4879,7 @@ let AuroHelpText$2 = class AuroHelpText extends i$3 {
   }
 };
 
-var formkitVersion$2 = '202607012103';
+var formkitVersion$2 = '202607022214';
 
 let AuroElement$2 = class AuroElement extends i$3 {
   static get properties() {
@@ -17768,14 +17768,17 @@ class BaseInput extends AuroElement$1 {
    * @returns {void}
    */
   notifyValueChanged() {
-    let inputEvent = null;
-
-    inputEvent = new Event('input', {
+    // This echoes Lit's reactive value update (and handleClickClear's
+    // programmatic clear) — it is NOT a fresh user-input event. Mark it
+    // `isProgrammatic` so consumers (e.g. auro-combobox) can distinguish
+    // it from genuine user typing and skip clobbering their own
+    // programmatic state during init-time renders.
+    const inputEvent = new Event('input', {
       bubbles: true,
       composed: true,
     });
+    inputEvent.isProgrammatic = true;
 
-    // Dispatched event to alert outside shadow DOM context of event firing.
     this.dispatchEvent(inputEvent);
   }
 
@@ -18488,7 +18491,7 @@ let AuroHelpText$1 = class AuroHelpText extends i$3 {
   }
 };
 
-var formkitVersion$1 = '202607012103';
+var formkitVersion$1 = '202607022214';
 
 // Copyright (c) 2025 Alaska Airlines. All right reserved. Licensed under the Apache-2.0 license
 // See LICENSE in the project root for license information.
@@ -18774,20 +18777,15 @@ class AuroInput extends BaseInput {
    * @returns {void}
    */
   checkDisplayValueSlotChange() {
-    let nodes = this.shadowRoot.querySelector('slot[name="displayValue"]').assignedNodes();
-
-    // Handle when DisplayValue is multi-level slot content (e.g. combobox passing displayValue to input)
-    if (nodes && nodes[0] && nodes[0].tagName === 'SLOT') {
-      nodes = nodes[0].assignedNodes();
-    }
-
-    let hasContent = false;
-
-    if (nodes.length > 0) {
-      hasContent = true;
-    }
+    // flatten:true resolves through auro-combobox's forwarding slot
+    // (<slot name="displayValue" slot="displayValue">) so a clone appended
+    // directly to auro-input's light DOM alongside the forwarder still
+    // counts as content. The prior nodes[0].tagName === 'SLOT' recursion
+    // discarded any siblings past the forwarder.
+    const slot = this.shadowRoot.querySelector('slot[name="displayValue"]');
+    const nodes = slot.assignedNodes({ flatten: true });
 
-    this.hasDisplayValueContent = hasContent;
+    this.hasDisplayValueContent = nodes.length > 0;
   }
 
   firstUpdated() {
@@ -19614,7 +19612,7 @@ class AuroBibtemplate extends i$3 {
   }
 }
 
-var formkitVersion = '202607012103';
+var formkitVersion = '202607022214';
 
 var styleCss$3 = i$6`.util_displayInline{display:inline}.util_displayInlineBlock{display:inline-block}.util_displayBlock{display:block}.util_displayFlex{display:flex}.util_displayHidden{display:none}.util_displayHiddenVisually{position:absolute;overflow:hidden;clip:rect(1px, 1px, 1px, 1px);width:1px;height:1px;padding:0;border:0}:host{display:block;text-align:left}:host [auro-dropdown]{--ds-auro-dropdown-trigger-background-color: transparent}:host #inputInBib::part(wrapper){box-shadow:none}:host #inputInBib::part(accent-left){display:none}:host([layout*=classic]) [auro-input]{width:100%}:host([layout*=classic]) [auro-input]::part(helpText){display:none}:host([layout*=classic]) #slotHolder{display:none}`;
 
@@ -20713,9 +20711,19 @@ class AuroCombobox extends AuroElement {
   /**
    * Processes hidden state of all menu options and determines if there are any available options not hidden.
    * @private
+   * @param {object} [options={}] - Optional flag bag.
+   * @param {boolean} [options.preferComboboxValue=false] - When true,
+   *   handleMenuOptions matches the selected option against `this.value`
+   *   first instead of `this.input.value`. Needed on mount and re-mount
+   *   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
+   *   and clearing paths keep the input-first match so user clears aren't
+   *   undone.
    * @returns {void}
    */
-  handleMenuOptions() {
+  handleMenuOptions({ preferComboboxValue = false } = {}) {
     this.generateOptionsArray();
     this.availableOptions = [];
     // Single source of truth for the menu's filter/highlight token per call.
@@ -20736,7 +20744,20 @@ class AuroCombobox extends AuroElement {
       option.setAttribute('aria-posinset', index + 1);
     });
 
-    if (this.input.value && this.menu.options && this.menu.options.some((opt) => opt.value === this.input.value)) {
+    // On mount/re-mount (via handleSlotChange), prefer the framework-set
+    // `this.value` when it matches a menu option. Covers SPA preselect and
+    // consumer swap patterns (e.g. Svelte `{#key}` re-mount) where
+    // `this.value` is authoritative but `this.input.value` may be empty or
+    // carry stale typed text from another field. Event-driven callers do
+    // not pass the flag, otherwise user clears would be undone by
+    // re-syncing to the previous combobox.value.
+    if (preferComboboxValue &&
+        this.value &&
+        this.menu.options?.some((opt) => opt.value === this.value)) {
+      this.setMenuValue(this.value);
+      this.syncValuesAndStates();
+    } else if (this.input.value &&
+        this.menu.options?.some((opt) => opt.value === this.input.value)) {
       this.setMenuValue(this.input.value);
       this.syncValuesAndStates();
     }
@@ -21173,7 +21194,25 @@ class AuroCombobox extends AuroElement {
       this.optionActive = evt.detail;
 
       if (this.input) {
-        this.input.setActiveDescendant(this.optionActive);
+        // setActiveDescendant runs after Lit's update finishes because the
+        // template's `.a11yActivedescendant` binding calls setAttribute on
+        // the internal <input> in auro-input.updated(), which clears the
+        // reflected ariaActiveDescendantElement property. Setting the ref
+        // synchronously here would get overwritten by that attribute write.
+        // Awaiting updateComplete lets the attribute write finish first,
+        // then the ref sticks and screen readers can cross the shadow-DOM
+        // boundary to the auro-menuoption in light DOM.
+        //
+        // The equality check covers the async gap: this.optionActive can
+        // change before the callback runs (user arrowed elsewhere, or the
+        // menu closed and cleared it to null), so we bail if the target
+        // no longer matches to avoid reinstating a stale ref.
+        const targetOption = this.optionActive;
+        this.updateComplete.then(() => {
+          if (this.input && this.optionActive === targetOption) {
+            this.input.setActiveDescendant(targetOption);
+          }
+        });
       }
 
       // In fullscreen mode the menu sits inside a nested <dialog> shadow root,
@@ -21310,6 +21349,18 @@ class AuroCombobox extends AuroElement {
       }
     }
 
+    // SPA preselect guard: on init render, auro-input's notifyValueChanged
+    // echoes an empty value through as an isProgrammatic input event before
+    // the framework-set combobox.value has propagated down to the input.
+    // Without this bail, the `this.value = this.input.value` below clobbers
+    // the framework value with '' and clear() wipes optionSelected. Scoped
+    // to the exact shape of that echo (isProgrammatic + non-empty combobox
+    // value + empty input.value) so it doesn't affect the swap/typed paths
+    // where value/input already track each other through the sync helpers.
+    if (event && event.isProgrammatic && this.value && !this.input.value) {
+      return;
+    }
+
     this.value = this.input.value;
 
     // Ignore re-entrant input events caused by programmatic value sets.
@@ -21742,7 +21793,11 @@ class AuroCombobox extends AuroElement {
           }
         });
 
-        this.handleMenuOptions();
+        // Slot change (mount/re-mount): pass `preferComboboxValue` so that a
+        // framework-set `this.value` wins over any stale `input.value` when
+        // matching against the newly-available options. Fixes the display
+        // for SPA preselect and Svelte `{#key}` re-mount swap patterns.
+        this.handleMenuOptions({ preferComboboxValue: true });
 
         break;
 

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

@@ -4894,7 +4894,7 @@ let AuroHelpText$2 = class AuroHelpText extends i$3 {
   }
 };
 
-var formkitVersion$2 = '202607012103';
+var formkitVersion$2 = '202607022214';
 
 let AuroElement$2 = class AuroElement extends i$3 {
   static get properties() {
@@ -17783,14 +17783,17 @@ class BaseInput extends AuroElement$1 {
    * @returns {void}
    */
   notifyValueChanged() {
-    let inputEvent = null;
-
-    inputEvent = new Event('input', {
+    // This echoes Lit's reactive value update (and handleClickClear's
+    // programmatic clear) — it is NOT a fresh user-input event. Mark it
+    // `isProgrammatic` so consumers (e.g. auro-combobox) can distinguish
+    // it from genuine user typing and skip clobbering their own
+    // programmatic state during init-time renders.
+    const inputEvent = new Event('input', {
       bubbles: true,
       composed: true,
     });
+    inputEvent.isProgrammatic = true;
 
-    // Dispatched event to alert outside shadow DOM context of event firing.
     this.dispatchEvent(inputEvent);
   }
 
@@ -18503,7 +18506,7 @@ let AuroHelpText$1 = class AuroHelpText extends i$3 {
   }
 };
 
-var formkitVersion$1 = '202607012103';
+var formkitVersion$1 = '202607022214';
 
 // Copyright (c) 2025 Alaska Airlines. All right reserved. Licensed under the Apache-2.0 license
 // See LICENSE in the project root for license information.
@@ -18789,20 +18792,15 @@ class AuroInput extends BaseInput {
    * @returns {void}
    */
   checkDisplayValueSlotChange() {
-    let nodes = this.shadowRoot.querySelector('slot[name="displayValue"]').assignedNodes();
-
-    // Handle when DisplayValue is multi-level slot content (e.g. combobox passing displayValue to input)
-    if (nodes && nodes[0] && nodes[0].tagName === 'SLOT') {
-      nodes = nodes[0].assignedNodes();
-    }
-
-    let hasContent = false;
-
-    if (nodes.length > 0) {
-      hasContent = true;
-    }
+    // flatten:true resolves through auro-combobox's forwarding slot
+    // (<slot name="displayValue" slot="displayValue">) so a clone appended
+    // directly to auro-input's light DOM alongside the forwarder still
+    // counts as content. The prior nodes[0].tagName === 'SLOT' recursion
+    // discarded any siblings past the forwarder.
+    const slot = this.shadowRoot.querySelector('slot[name="displayValue"]');
+    const nodes = slot.assignedNodes({ flatten: true });
 
-    this.hasDisplayValueContent = hasContent;
+    this.hasDisplayValueContent = nodes.length > 0;
   }
 
   firstUpdated() {
@@ -19629,7 +19627,7 @@ class AuroBibtemplate extends i$3 {
   }
 }
 
-var formkitVersion = '202607012103';
+var formkitVersion = '202607022214';
 
 var styleCss$3 = i$6`.util_displayInline{display:inline}.util_displayInlineBlock{display:inline-block}.util_displayBlock{display:block}.util_displayFlex{display:flex}.util_displayHidden{display:none}.util_displayHiddenVisually{position:absolute;overflow:hidden;clip:rect(1px, 1px, 1px, 1px);width:1px;height:1px;padding:0;border:0}:host{display:block;text-align:left}:host [auro-dropdown]{--ds-auro-dropdown-trigger-background-color: transparent}:host #inputInBib::part(wrapper){box-shadow:none}:host #inputInBib::part(accent-left){display:none}:host([layout*=classic]) [auro-input]{width:100%}:host([layout*=classic]) [auro-input]::part(helpText){display:none}:host([layout*=classic]) #slotHolder{display:none}`;
 
@@ -20728,9 +20726,19 @@ class AuroCombobox extends AuroElement {
   /**
    * Processes hidden state of all menu options and determines if there are any available options not hidden.
    * @private
+   * @param {object} [options={}] - Optional flag bag.
+   * @param {boolean} [options.preferComboboxValue=false] - When true,
+   *   handleMenuOptions matches the selected option against `this.value`
+   *   first instead of `this.input.value`. Needed on mount and re-mount
+   *   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
+   *   and clearing paths keep the input-first match so user clears aren't
+   *   undone.
    * @returns {void}
    */
-  handleMenuOptions() {
+  handleMenuOptions({ preferComboboxValue = false } = {}) {
     this.generateOptionsArray();
     this.availableOptions = [];
     // Single source of truth for the menu's filter/highlight token per call.
@@ -20751,7 +20759,20 @@ class AuroCombobox extends AuroElement {
       option.setAttribute('aria-posinset', index + 1);
     });
 
-    if (this.input.value && this.menu.options && this.menu.options.some((opt) => opt.value === this.input.value)) {
+    // On mount/re-mount (via handleSlotChange), prefer the framework-set
+    // `this.value` when it matches a menu option. Covers SPA preselect and
+    // consumer swap patterns (e.g. Svelte `{#key}` re-mount) where
+    // `this.value` is authoritative but `this.input.value` may be empty or
+    // carry stale typed text from another field. Event-driven callers do
+    // not pass the flag, otherwise user clears would be undone by
+    // re-syncing to the previous combobox.value.
+    if (preferComboboxValue &&
+        this.value &&
+        this.menu.options?.some((opt) => opt.value === this.value)) {
+      this.setMenuValue(this.value);
+      this.syncValuesAndStates();
+    } else if (this.input.value &&
+        this.menu.options?.some((opt) => opt.value === this.input.value)) {
       this.setMenuValue(this.input.value);
       this.syncValuesAndStates();
     }
@@ -21188,7 +21209,25 @@ class AuroCombobox extends AuroElement {
       this.optionActive = evt.detail;
 
       if (this.input) {
-        this.input.setActiveDescendant(this.optionActive);
+        // setActiveDescendant runs after Lit's update finishes because the
+        // template's `.a11yActivedescendant` binding calls setAttribute on
+        // the internal <input> in auro-input.updated(), which clears the
+        // reflected ariaActiveDescendantElement property. Setting the ref
+        // synchronously here would get overwritten by that attribute write.
+        // Awaiting updateComplete lets the attribute write finish first,
+        // then the ref sticks and screen readers can cross the shadow-DOM
+        // boundary to the auro-menuoption in light DOM.
+        //
+        // The equality check covers the async gap: this.optionActive can
+        // change before the callback runs (user arrowed elsewhere, or the
+        // menu closed and cleared it to null), so we bail if the target
+        // no longer matches to avoid reinstating a stale ref.
+        const targetOption = this.optionActive;
+        this.updateComplete.then(() => {
+          if (this.input && this.optionActive === targetOption) {
+            this.input.setActiveDescendant(targetOption);
+          }
+        });
       }
 
       // In fullscreen mode the menu sits inside a nested <dialog> shadow root,
@@ -21325,6 +21364,18 @@ class AuroCombobox extends AuroElement {
       }
     }
 
+    // SPA preselect guard: on init render, auro-input's notifyValueChanged
+    // echoes an empty value through as an isProgrammatic input event before
+    // the framework-set combobox.value has propagated down to the input.
+    // Without this bail, the `this.value = this.input.value` below clobbers
+    // the framework value with '' and clear() wipes optionSelected. Scoped
+    // to the exact shape of that echo (isProgrammatic + non-empty combobox
+    // value + empty input.value) so it doesn't affect the swap/typed paths
+    // where value/input already track each other through the sync helpers.
+    if (event && event.isProgrammatic && this.value && !this.input.value) {
+      return;
+    }
+
     this.value = this.input.value;
 
     // Ignore re-entrant input events caused by programmatic value sets.
@@ -21757,7 +21808,11 @@ class AuroCombobox extends AuroElement {
           }
         });
 
-        this.handleMenuOptions();
+        // Slot change (mount/re-mount): pass `preferComboboxValue` so that a
+        // framework-set `this.value` wins over any stale `input.value` when
+        // matching against the newly-available options. Fixes the display
+        // for SPA preselect and Svelte `{#key}` re-mount swap patterns.
+        this.handleMenuOptions({ preferComboboxValue: true });
 
         break;
 

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

@@ -424,6 +424,16 @@ export class AuroCombobox extends AuroElement {
     /**
      * Processes hidden state of all menu options and determines if there are any available options not hidden.
      * @private
+     * @param {object} [options={}] - Optional flag bag.
+     * @param {boolean} [options.preferComboboxValue=false] - When true,
+     *   handleMenuOptions matches the selected option against `this.value`
+     *   first instead of `this.input.value`. Needed on mount and re-mount
+     *   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
+     *   and clearing paths keep the input-first match so user clears aren't
+     *   undone.
      * @returns {void}
      */
     private handleMenuOptions;