@aurodesignsystem-dev/auro-formkit 0.0.0-pr1594.2 → 0.0.0-pr1595.1

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

@@ -4388,8 +4388,11 @@ const DESIGN_TOKEN_BREAKPOINT_OPTIONS = [
 ];
 
 /**
+ * The `auro-dropdownbib` element renders the dropdown's bib as a dialog/popover container and manages its fullscreen and modal display.
  * @prop { String } fullscreenBreakpoint - Defines the screen size breakpoint (`lg`, `md`, `sm`, or `xs`) at which the dropdown switches to fullscreen mode on mobile. When expanded, the dropdown will automatically display in fullscreen mode if the screen size is equal to or smaller than the selected breakpoint.
  * @csspart bibContainer - Apply css to the bib container.
+ * @event auro-dropdownbib-connected - Notifies that the dropdown bib has connected to the DOM, passing a reference to the element in the event detail.
+ * @event auro-bib-cancel - Notifies that the bib was cancelled (e.g. via the ESC key) so parent components can close it.
  */
 
 class AuroDropdownBib extends i$3 {
@@ -4404,9 +4407,17 @@ class AuroDropdownBib extends i$3 {
 
     AuroLibraryRuntimeUtils$1$2.prototype.handleComponentTagRename(this, 'auro-dropdownbib');
 
-    this.shape = "rounded";
     this.matchWidth = false;
     this.hasActiveDescendant = false;
+
+    this.initializeArchitectureDefaults();
+  }
+
+  // The `shape` default is set in a helper (not the constructor body) so the CEM
+  // analyzer keeps its `@type` union instead of inferring `string` from a
+  // constructor-literal assignment. See AlaskaAirlines/discussions#653.
+  initializeArchitectureDefaults() {
+    this.shape = "rounded";
   }
 
   static get styles() {
@@ -4425,6 +4436,7 @@ class AuroDropdownBib extends i$3 {
        */
       isFullscreen: {
         type: Boolean,
+        attribute: 'isfullscreen',
         reflect: true
       },
 
@@ -4450,6 +4462,7 @@ class AuroDropdownBib extends i$3 {
        */
       matchWidth: {
         type: Boolean,
+        attribute: 'matchwidth',
         reflect: true
       },
 
@@ -4465,11 +4478,18 @@ class AuroDropdownBib extends i$3 {
        * A reference to the associated bib template element.
        */
       bibTemplate: {
-        type: Object
+        type: Object,
+        attribute: 'bibtemplate'
       },
 
+      /**
+       * Sets the shape of the dropdown bib.
+       * @type {'box' | 'classic' | 'pill' | 'rounded' | 'snowflake'}
+       * @default 'rounded'
+       */
       shape: {
         type: String,
+        attribute: "shape",
         reflect: true
       },
 
@@ -4481,7 +4501,8 @@ class AuroDropdownBib extends i$3 {
        * @private
        */
       dialogLabel: {
-        type: String
+        type: String,
+        attribute: 'dialoglabel'
       },
 
       /**
@@ -4492,7 +4513,8 @@ class AuroDropdownBib extends i$3 {
        * @private
        */
       dialogRole: {
-        type: String
+        type: String,
+        attribute: 'dialogrole'
       },
 
       /**
@@ -4500,7 +4522,8 @@ class AuroDropdownBib extends i$3 {
        * @private
        */
       hasActiveDescendant: {
-        type: Boolean
+        type: Boolean,
+        attribute: 'hasactivedescendant'
       }
     };
   }
@@ -4851,6 +4874,8 @@ let AuroHelpText$2 = class AuroHelpText extends i$3 {
     super();
 
     this.error = false;
+
+    /** @type {'default' | 'inverse'} */
     this.appearance = "default";
     this.onDark = false;
     this.hasTextContent = false;
@@ -4871,8 +4896,8 @@ let AuroHelpText$2 = class AuroHelpText extends i$3 {
     return {
 
       /**
-       * Defines whether the component will be on lighter or darker backgrounds.
-       * @property {'default', 'inverse'} - The appearance of the help text, either default (for light backgrounds) or inverse (for dark backgrounds).
+       * The appearance of the help text, either default (for light backgrounds) or inverse (for dark backgrounds).
+       * @type {'default' | 'inverse'}
        * @default 'default'
        */
       appearance: {
@@ -4885,6 +4910,7 @@ let AuroHelpText$2 = class AuroHelpText extends i$3 {
        */
       slotNodes: {
         type: Boolean,
+        attribute: 'slotnodes',
       },
 
       /**
@@ -4892,6 +4918,7 @@ let AuroHelpText$2 = class AuroHelpText extends i$3 {
        */
       hasTextContent: {
         type: Boolean,
+        attribute: 'hastextcontent',
       },
 
       /**
@@ -4907,6 +4934,7 @@ let AuroHelpText$2 = class AuroHelpText extends i$3 {
        */
       onDark: {
         type: Boolean,
+        attribute: 'ondark',
         reflect: true
       }
     };
@@ -4977,39 +5005,39 @@ let AuroHelpText$2 = class AuroHelpText extends i$3 {
   }
 };
 
-var formkitVersion$2 = '202608261850';
+var formkitVersion$2 = '202608300032';
 
+/**
+ * AuroElement is the shared base class for layout-aware Auro form components.
+ *
+ * It defines the common `layout`, `shape`, `size`, and `ondark` reactive
+ * properties and the architecture helpers (`renderLayout`, `resetShapeClasses`,
+ * `resetLayoutClasses`) that subclasses use to render a chosen layout and apply
+ * the matching `shape-*` / `layout-*` wrapper classes. Subclasses supply their
+ * own default and valid value set for `layout`, `shape`, and `size`.
+ */
 let AuroElement$2 = class AuroElement extends i$3 {
   static get properties() {
     return {
 
       /**
-       * Defines the language of an element.
-       * @default {'default'}
+       * When true, renders the component styled for use on a dark background.
        */
-      layout: {
-        type: String,
-        attribute: "layout",
-        reflect: true
-      },
-
-      shape: {
-        type: String,
-        attribute: "shape",
-        reflect: true
-      },
-
-      size: {
-        type: String,
-        attribute: "size",
-        reflect: true
-      },
-
       onDark: {
         type: Boolean,
         attribute: "ondark",
         reflect: true
       }
+
+      // NOTE: `layout`, `shape`, and `size` are intentionally NOT declared here.
+      // Their valid value sets differ per component, and the CEM analyzer roots
+      // an inherited property's `type` in the class that declares it — a base
+      // declaration would force every subclass's `@type` to be discarded and
+      // emitted as plain `string`. Each subclass declares its own `layout` /
+      // `shape` / `size` with an exact `@type` union instead. AuroElement still
+      // consumes `this.layout` / `this.shape` / `this.size` in its render and
+      // architecture helpers below (subclasses guarantee the reactive props).
+      // See AlaskaAirlines/discussions#653.
     };
   }
 
@@ -5095,6 +5123,7 @@ let AuroElement$2 = class AuroElement extends i$3 {
  * @slot helpText - Defines the content of the helpText.
  * @slot trigger - Defines the content of the trigger.
  * @csspart trigger - The trigger content container.
+ * @csspart wrapper - The trigger wrapper element surrounding the trigger content and chevron.
  * @csspart chevron - The collapsed/expanded state icon container.
  * @csspart size - The size of the dropdown bib. (height, width, maxHeight, maxWidth only)
  * @csspart helpText - The helpText content container.
@@ -5119,7 +5148,7 @@ class AuroDropdown extends AuroElement$2 {
 
     /**
      * When true, the dropdown skips its generic focus restoration on close.
-     * Set by consumers (e.g. combobox) that manage their own focus routing
+     * Set by consumers (for example combobox) that manage their own focus routing
      * via setClearBtnFocus / setInputFocus / keyboard strategy.
      * Separate from noHideOnThisFocusLoss (which controls auto-close behavior).
      * @private
@@ -5288,7 +5317,7 @@ class AuroDropdown extends AuroElement$2 {
   /**
    * Focus the trigger content. When the trigger wrapper itself is focusable
    * (has tabindex), focus it directly. Otherwise, focus the first focusable
-   * element slotted into the trigger slot (e.g. the auro-input).
+   * element slotted into the trigger slot (for example the auro-input).
    * @private
    */
   focusTrigger() {
@@ -5385,6 +5414,7 @@ class AuroDropdown extends AuroElement$2 {
        */
       autoPlacement: {
         type: Boolean,
+        attribute: 'autoplacement',
         reflect: true
       },
 
@@ -5393,6 +5423,7 @@ class AuroDropdown extends AuroElement$2 {
        */
       desktopModal: {
         type: Boolean,
+        attribute: 'desktopmodal',
         reflect: true
       },
 
@@ -5401,6 +5432,7 @@ class AuroDropdown extends AuroElement$2 {
        */
       disableEventShow: {
         type: Boolean,
+        attribute: 'disableeventshow',
         reflect: true
       },
 
@@ -5434,14 +5466,16 @@ class AuroDropdown extends AuroElement$2 {
        */
       disableKeyboardHandling: {
         type: Boolean,
+        attribute: 'disablekeyboardhandling',
         reflect: true
       },
 
       /**
-       * @private
+       * Sets the width of the dropdown bib in pixels.
        */
       dropdownWidth: {
-        type: Number
+        type: Number,
+        attribute: 'dropdownwidth'
       },
 
       /**
@@ -5466,7 +5500,8 @@ class AuroDropdown extends AuroElement$2 {
        * Contains the help text message for the current validity error.
        */
       errorMessage: {
-        type: String
+        type: String,
+        attribute: 'errormessage'
       },
 
       /**
@@ -5474,6 +5509,7 @@ class AuroDropdown extends AuroElement$2 {
        */
       focusShow: {
         type: Boolean,
+        attribute: 'focusshow',
         reflect: true
       },
 
@@ -5491,6 +5527,7 @@ class AuroDropdown extends AuroElement$2 {
        */
       isBibFullscreen: {
         type: Boolean,
+        attribute: 'isbibfullscreen',
         reflect: true
       },
 
@@ -5499,6 +5536,7 @@ class AuroDropdown extends AuroElement$2 {
        */
       hoverToggle: {
         type: Boolean,
+        attribute: 'hovertoggle',
         reflect: true
       },
 
@@ -5506,7 +5544,8 @@ class AuroDropdown extends AuroElement$2 {
        * @private
        */
       hasTriggerContent: {
-        type: Boolean
+        type: Boolean,
+        attribute: false
       },
 
       /**
@@ -5519,6 +5558,7 @@ class AuroDropdown extends AuroElement$2 {
        */
       fullscreenBreakpoint: {
         type: String,
+        attribute: "fullscreenbreakpoint",
         reflect: true
       },
 
@@ -5529,6 +5569,27 @@ class AuroDropdown extends AuroElement$2 {
        */
       layout: {
         type: String,
+        attribute: "layout",
+        reflect: true
+      },
+
+      /**
+       * Sets the shape of the dropdown.
+       * @type {'box' | 'classic' | 'pill' | 'pill-left' | 'pill-right' | 'rounded' | 'snowflake'}
+       */
+      shape: {
+        type: String,
+        attribute: "shape",
+        reflect: true
+      },
+
+      /**
+       * Sets the size of the dropdown.
+       * @type {'xs' | 'sm' | 'md' | 'lg' | 'xl'}
+       */
+      size: {
+        type: String,
+        attribute: "size",
         reflect: true
       },
 
@@ -5538,6 +5599,7 @@ class AuroDropdown extends AuroElement$2 {
        */
       parentBorder: {
         type: Boolean,
+        attribute: 'parentborder',
         reflect: true
       },
 
@@ -5546,6 +5608,7 @@ class AuroDropdown extends AuroElement$2 {
        */
       matchWidth: {
         type: Boolean,
+        attribute: 'matchwidth',
         reflect: true
       },
 
@@ -5555,6 +5618,7 @@ class AuroDropdown extends AuroElement$2 {
        */
       noFlip: {
         type: Boolean,
+        attribute: 'noflip',
         reflect: true
       },
 
@@ -5571,6 +5635,7 @@ class AuroDropdown extends AuroElement$2 {
        */
       noHideOnThisFocusLoss: {
         type: Boolean,
+        attribute: 'nohideonthisfocusloss',
         reflect: true
       },
 
@@ -5579,6 +5644,7 @@ class AuroDropdown extends AuroElement$2 {
        */
       noToggle: {
         type: Boolean,
+        attribute: 'notoggle',
         reflect: true
       },
 
@@ -5596,14 +5662,17 @@ class AuroDropdown extends AuroElement$2 {
        */
       onDark: {
         type: Boolean,
+        attribute: 'ondark',
         reflect: true
       },
 
       /**
        *  If declared, and a function is set, that function will execute when the slot content is updated.
+       * @type {() => void}
        */
       onSlotChange: {
         type: Function,
+        attribute: 'onslotchange',
         reflect: false
       },
 
@@ -5618,10 +5687,11 @@ class AuroDropdown extends AuroElement$2 {
       },
 
       /**
-       * @private
+       * Sets the tabindex applied to the dropdown trigger for keyboard focus order.
        */
       tabIndex: {
-        type: Number
+        type: Number,
+        attribute: 'tabindex'
       },
 
       /**
@@ -5845,7 +5915,7 @@ class AuroDropdown extends AuroElement$2 {
     /**
      * @description Let subscribers know that the dropdown ID ha been generated and added.
      * @event auroDropdown-idAdded
-     * @type {Object<key: 'id', value: string>} - The ID of the dropdown bib element.
+     * @type {CustomEvent<{ id: string }>} - Detail carries the generated ID of the dropdown bib element.
      */
     this.dispatchEvent(new CustomEvent('auroDropdown-idAdded', {detail: {id: this.floater.element.id}}));
 
@@ -10994,37 +11064,37 @@ class AuroFormValidation {
   }
 }
 
+/**
+ * AuroElement is the shared base class for layout-aware Auro form components.
+ *
+ * It defines the common `layout`, `shape`, `size`, and `ondark` reactive
+ * properties and the architecture helpers (`renderLayout`, `resetShapeClasses`,
+ * `resetLayoutClasses`) that subclasses use to render a chosen layout and apply
+ * the matching `shape-*` / `layout-*` wrapper classes. Subclasses supply their
+ * own default and valid value set for `layout`, `shape`, and `size`.
+ */
 let AuroElement$1 = class AuroElement extends i$3 {
   static get properties() {
     return {
 
       /**
-       * Defines the language of an element.
-       * @default {'default'}
+       * When true, renders the component styled for use on a dark background.
        */
-      layout: {
-        type: String,
-        attribute: "layout",
-        reflect: true
-      },
-
-      shape: {
-        type: String,
-        attribute: "shape",
-        reflect: true
-      },
-
-      size: {
-        type: String,
-        attribute: "size",
-        reflect: true
-      },
-
       onDark: {
         type: Boolean,
         attribute: "ondark",
         reflect: true
       }
+
+      // NOTE: `layout`, `shape`, and `size` are intentionally NOT declared here.
+      // Their valid value sets differ per component, and the CEM analyzer roots
+      // an inherited property's `type` in the class that declares it — a base
+      // declaration would force every subclass's `@type` to be discarded and
+      // emitted as plain `string`. Each subclass declares its own `layout` /
+      // `shape` / `size` with an exact `@type` union instead. AuroElement still
+      // consumes `this.layout` / `this.shape` / `this.size` in its render and
+      // architecture helpers below (subclasses guarantee the reactive props).
+      // See AlaskaAirlines/discussions#653.
     };
   }
 
@@ -16991,6 +17061,7 @@ class DomHandler {
  * Base class for auro-input component that provides core input functionality.
  * @event input - Event fires when the value of an `auro-input` has been changed.
  * @event auroFormElement-validated - Notifies that the `validity` and `errorMessage` value has changed.
+ * @event auroInput-validityChange - Notifies that the `validity` state of the input has changed.
  */
 class BaseInput extends AuroElement$1 {
 
@@ -17021,7 +17092,10 @@ class BaseInput extends AuroElement$1 {
     // during its own update cycle sees a populated util instance.
     this.activeLabel = false;
 
-    /** @private */
+    /**
+     * @private
+     * @type {string[]}
+     */
     this.allowedInputTypes = [
       "text",
       "number",
@@ -17030,9 +17104,14 @@ class BaseInput extends AuroElement$1 {
       "credit-card",
       "tel"
     ];
+
+    /** @type {'default' | 'inverse'} */
     this.appearance = "default";
 
-    /** @private */
+    /**
+     * @private
+     * @type {Record<string, string>}
+     */
     this.dateFormatMap = {
       'mm/dd/yyyy': 'dateMMDDYYYY',
       'dd/mm/yyyy': 'dateDDMMYYYY',
@@ -17063,7 +17142,6 @@ class BaseInput extends AuroElement$1 {
 
     /** @private */
     this.label = 'Input label is undefined';
-    this.layout = 'classic';
     this.locale = 'en-US';
     this._format = undefined;
 
@@ -17079,17 +17157,18 @@ class BaseInput extends AuroElement$1 {
     this.setCustomValidityForType = undefined;
     // Credit Card is intentionally excluded — its mask manages the cursor
     // itself, and listing it here caused cursor placement issues in Safari.
-    /** @private */
+    /**
+     * @private
+     * @type {string[]}
+     */
     this.setSelectionInputTypes = [
       "text",
       "password",
       "email"
     ];
-    this.shape = 'classic';
 
     /** @private */
     this.showPassword = false;
-    this.size = 'lg';
     this.touched = false;
 
     /** @private */
@@ -17107,6 +17186,24 @@ class BaseInput extends AuroElement$1 {
     /** @private */
     this.validationCCLength = undefined;
     this.value = undefined;
+
+    this.initializeArchitectureDefaults();
+  }
+
+  /**
+   * Sets the default `layout`, `shape`, and `size` values.
+   *
+   * These are assigned in a helper method rather than the constructor body so
+   * the CEM analyzer keeps their `@type` string-literal unions (a literal
+   * assignment in the constructor would make the analyzer infer `string` and
+   * override the union — see AlaskaAirlines/discussions#653, gotcha 1).
+   * @private
+   * @returns {void}
+   */
+  initializeArchitectureDefaults() {
+    this.layout = 'classic';
+    this.shape = 'classic';
+    this.size = 'lg';
   }
 
   // function to define props used within the scope of this component
@@ -17114,11 +17211,45 @@ class BaseInput extends AuroElement$1 {
     return {
       ...super.properties,
 
+      /**
+       * Sets the layout variant of the input.
+       * @type {'classic' | 'emphasized' | 'emphasized-left' | 'emphasized-right' | 'snowflake' | 'snowflake-left' | 'snowflake-right'}
+       * @default 'classic'
+       */
+      layout: {
+        type: String,
+        attribute: "layout",
+        reflect: true
+      },
+
+      /**
+       * Sets the shape of the input.
+       * @type {'box' | 'classic' | 'pill' | 'pill-left' | 'pill-right' | 'rounded' | 'snowflake'}
+       * @default 'classic'
+       */
+      shape: {
+        type: String,
+        attribute: "shape",
+        reflect: true
+      },
+
+      /**
+       * Sets the size of the input.
+       * @type {'xs' | 'sm' | 'md' | 'lg' | 'xl'}
+       * @default 'lg'
+       */
+      size: {
+        type: String,
+        attribute: "size",
+        reflect: true
+      },
+
       /**
        * The value for the role attribute.
        */
       a11yRole: {
         type: String,
+        attribute: 'a11yrole',
         reflect: true
       },
 
@@ -17127,6 +17258,7 @@ class BaseInput extends AuroElement$1 {
        */
       a11yControls: {
         type: String,
+        attribute: 'a11ycontrols',
         reflect: true
       },
 
@@ -17135,6 +17267,7 @@ class BaseInput extends AuroElement$1 {
        */
       a11yExpanded: {
         type: Boolean,
+        attribute: 'a11yexpanded',
         reflect: true
       },
 
@@ -17144,6 +17277,7 @@ class BaseInput extends AuroElement$1 {
        */
       a11yActivedescendant: {
         type: String,
+        attribute: 'a11yactivedescendant',
         reflect: true
       },
 
@@ -17154,6 +17288,7 @@ class BaseInput extends AuroElement$1 {
        */
       activeLabel: {
         type: Boolean,
+        attribute: 'activelabel',
         reflect: true
       },
 
@@ -17168,7 +17303,8 @@ class BaseInput extends AuroElement$1 {
       },
 
       /**
-       * An enumerated attribute that controls whether and how text input is automatically capitalized as it is entered/edited by the user. [off/none, on/sentences, words, characters].
+       * An enumerated attribute that controls whether and how text input is automatically capitalized as it is entered/edited by the user.
+       * @type {'off' | 'none' | 'on' | 'sentences' | 'words' | 'characters'}
        */
       autocapitalize: {
         type: String,
@@ -17185,6 +17321,7 @@ class BaseInput extends AuroElement$1 {
 
       /**
        * When set to `off`, stops iOS from auto-correcting words when typed into a text box.
+       * @type {'on' | 'off'}
        */
       autocorrect: {
         type: String,
@@ -17195,7 +17332,8 @@ class BaseInput extends AuroElement$1 {
        * Custom help text message for email type validity.
        */
       customValidityTypeEmail: {
-        type: String
+        type: String,
+        attribute: 'customvaliditytypeemail'
       },
 
       /**
@@ -17211,6 +17349,7 @@ class BaseInput extends AuroElement$1 {
        */
       dvInputOnly: {
         type: Boolean,
+        attribute: 'dvinputonly',
         reflect: true
       },
 
@@ -17226,7 +17365,8 @@ class BaseInput extends AuroElement$1 {
        * Contains the help text message for the current validity error.
        */
       errorMessage: {
-        type: String
+        type: String,
+        attribute: 'errormessage'
       },
 
       /**
@@ -17262,6 +17402,7 @@ class BaseInput extends AuroElement$1 {
        */
       hideLabelVisually: {
         type: Boolean,
+        attribute: 'hidelabelvisually',
         reflect: true
       },
 
@@ -17328,6 +17469,7 @@ class BaseInput extends AuroElement$1 {
        */
       maxLength: {
         type: Number,
+        attribute: 'maxlength',
         reflect: true
       },
 
@@ -17343,6 +17485,7 @@ class BaseInput extends AuroElement$1 {
        */
       minLength: {
         type: Number,
+        attribute: 'minlength',
         reflect: true
       },
 
@@ -17368,6 +17511,7 @@ class BaseInput extends AuroElement$1 {
        */
       noValidate: {
         type: Boolean,
+        attribute: 'novalidate',
         reflect: true
       },
 
@@ -17376,6 +17520,7 @@ class BaseInput extends AuroElement$1 {
        */
       onDark: {
         type: Boolean,
+        attribute: 'ondark',
         reflect: true
       },
 
@@ -17415,77 +17560,88 @@ class BaseInput extends AuroElement$1 {
        * Sets a custom help text message to display for all validityStates.
        */
       setCustomValidity: {
-        type: String
+        type: String,
+        attribute: 'setcustomvalidity'
       },
 
       /**
        * Custom help text message to display when validity = `badInput`.
        */
       setCustomValidityBadInput: {
-        type: String
+        type: String,
+        attribute: 'setcustomvaliditybadinput'
       },
 
       /**
        * Custom help text message to display when validity = `customError`.
        */
       setCustomValidityCustomError: {
-        type: String
+        type: String,
+        attribute: 'setcustomvaliditycustomerror'
       },
 
       /**
        * Custom help text message to display for the declared element `type` and type validity fails.
        */
       setCustomValidityForType: {
-        type: String
+        type: String,
+        attribute: 'setcustomvalidityfortype'
       },
 
       /**
        * Custom help text message to display when validity = `patternMismatch`.
        */
       setCustomValidityPatternMismatch: {
-        type: String
+        type: String,
+        attribute: 'setcustomvaliditypatternmismatch'
       },
 
       /**
        * Custom help text message to display when validity = `rangeOverflow`.
        */
       setCustomValidityRangeOverflow: {
-        type: String
+        type: String,
+        attribute: 'setcustomvalidityrangeoverflow'
       },
 
       /**
        * Custom help text message to display when validity = `rangeUnderflow`.
        */
       setCustomValidityRangeUnderflow: {
-        type: String
+        type: String,
+        attribute: 'setcustomvalidityrangeunderflow'
       },
 
       /**
        * Custom help text message to display when validity = `tooLong`.
        */
       setCustomValidityTooLong: {
-        type: String
+        type: String,
+        attribute: 'setcustomvaliditytoolong'
       },
 
       /**
        * Custom help text message to display when validity = `tooShort`.
        */
       setCustomValidityTooShort: {
-        type: String
+        type: String,
+        attribute: 'setcustomvaliditytooshort'
       },
 
       /**
        * Custom help text message to display when validity = `valueMissing`.
        */
       setCustomValidityValueMissing: {
-        type: String
+        type: String,
+        attribute: 'setcustomvalidityvaluemissing'
       },
 
       /**
        * @ignore
        */
       showPassword: {
-        state: true
+        state: true,
+        attribute: false
       },
 
       /**
@@ -17497,7 +17653,8 @@ class BaseInput extends AuroElement$1 {
       },
 
       /**
-       * An enumerated attribute defines whether the element may be checked for spelling errors. [true, false]. When set to `false` the attribute `autocorrect` is set to `off` and `autocapitalize` is set to `none`.
+       * An enumerated attribute defines whether the element may be checked for spelling errors. When set to `false` the attribute `autocorrect` is set to `off` and `autocapitalize` is set to `none`.
+       * @type {'true' | 'false'}
        */
       spellcheck: {
         type: String,
@@ -17528,7 +17685,8 @@ class BaseInput extends AuroElement$1 {
        * Sets validation mode to re-eval with each input.
        */
       validateOnInput: {
-        type: Boolean
+        type: Boolean,
+        attribute: 'validateoninput'
       },
 
       /**
@@ -18582,6 +18740,8 @@ let AuroHelpText$1 = class AuroHelpText extends i$3 {
     super();
 
     this.error = false;
+
+    /** @type {'default' | 'inverse'} */
     this.appearance = "default";
     this.onDark = false;
     this.hasTextContent = false;
@@ -18602,8 +18762,8 @@ let AuroHelpText$1 = class AuroHelpText extends i$3 {
     return {
 
       /**
-       * Defines whether the component will be on lighter or darker backgrounds.
-       * @property {'default', 'inverse'} - The appearance of the help text, either default (for light backgrounds) or inverse (for dark backgrounds).
+       * The appearance of the help text, either default (for light backgrounds) or inverse (for dark backgrounds).
+       * @type {'default' | 'inverse'}
        * @default 'default'
        */
       appearance: {
@@ -18616,6 +18776,7 @@ let AuroHelpText$1 = class AuroHelpText extends i$3 {
        */
       slotNodes: {
         type: Boolean,
+        attribute: 'slotnodes',
       },
 
       /**
@@ -18623,6 +18784,7 @@ let AuroHelpText$1 = class AuroHelpText extends i$3 {
        */
       hasTextContent: {
         type: Boolean,
+        attribute: 'hastextcontent',
       },
 
       /**
@@ -18638,6 +18800,7 @@ let AuroHelpText$1 = class AuroHelpText extends i$3 {
        */
       onDark: {
         type: Boolean,
+        attribute: 'ondark',
         reflect: true
       }
     };
@@ -18708,7 +18871,7 @@ let AuroHelpText$1 = class AuroHelpText extends i$3 {
   }
 };
 
-var formkitVersion$1 = '202608261850';
+var formkitVersion$1 = '202608300032';
 
 // Copyright (c) 2025 Alaska Airlines. All right reserved. Licensed under the Apache-2.0 license
 // See LICENSE in the project root for license information.
@@ -19722,6 +19885,9 @@ var headerVersion = '5.0.1';
  * @slot subheader - Slot for the subheader content.
  * @slot footer - Slot for the footer content.
  * @slot ariaLabel.close - Slot for the close button aria-label.
+ * @csspart bibtemplate - The outermost bibtemplate container element.
+ * @event close-click - Notifies when the close button is clicked.
+ * @event auro-bibtemplate-connected - Notifies that the bibtemplate has connected to the DOM, passing a reference to the element in the event detail.
  */
 class AuroBibtemplate extends i$3 {
 
@@ -19761,10 +19927,19 @@ class AuroBibtemplate extends i$3 {
   // function to define props used within the scope of this component
   static get properties() {
     return {
+
+      /**
+       * If declared, the bibtemplate renders in fullscreen mode, exposing the header, subheader, and footer regions.
+       */
       isFullscreen: {
         type: Boolean,
+        attribute: 'isfullscreen',
         reflect: true
       },
+
+      /**
+       * If declared, the fullscreen headline renders using the larger display heading style.
+       */
       large: {
         type: Boolean,
         reflect: true
@@ -19775,6 +19950,7 @@ class AuroBibtemplate extends i$3 {
        */
       showFooter: {
         type: Boolean,
+        attribute: 'showfooter',
         reflect: true
       }
     };
@@ -19887,7 +20063,7 @@ class AuroBibtemplate extends i$3 {
   }
 }
 
-var formkitVersion = '202608261850';
+var formkitVersion = '202608300032';
 
 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}`;
 
@@ -19895,37 +20071,37 @@ var styleEmphasizedCss = i$6`:host([layout*=emphasized][shape*=pill]) [auro-inpu
 
 var styleSnowflakeCss = i$6`:host([layout*=snowflake][shape*=snowflake]) [auro-input]{width:100%}:host([layout*=snowflake][shape*=snowflake]) [auro-input]::part(inputHelpText){display:none}:host([layout*=snowflake][shape*=snowflake])::part(helpText){text-align:center}`;
 
+/**
+ * AuroElement is the shared base class for layout-aware Auro form components.
+ *
+ * It defines the common `layout`, `shape`, `size`, and `ondark` reactive
+ * properties and the architecture helpers (`renderLayout`, `resetShapeClasses`,
+ * `resetLayoutClasses`) that subclasses use to render a chosen layout and apply
+ * the matching `shape-*` / `layout-*` wrapper classes. Subclasses supply their
+ * own default and valid value set for `layout`, `shape`, and `size`.
+ */
 class AuroElement extends i$3 {
   static get properties() {
     return {
 
       /**
-       * Defines the language of an element.
-       * @default {'default'}
+       * When true, renders the component styled for use on a dark background.
        */
-      layout: {
-        type: String,
-        attribute: "layout",
-        reflect: true
-      },
-
-      shape: {
-        type: String,
-        attribute: "shape",
-        reflect: true
-      },
-
-      size: {
-        type: String,
-        attribute: "size",
-        reflect: true
-      },
-
       onDark: {
         type: Boolean,
         attribute: "ondark",
         reflect: true
       }
+
+      // NOTE: `layout`, `shape`, and `size` are intentionally NOT declared here.
+      // Their valid value sets differ per component, and the CEM analyzer roots
+      // an inherited property's `type` in the class that declares it — a base
+      // declaration would force every subclass's `@type` to be discarded and
+      // emitted as plain `string`. Each subclass declares its own `layout` /
+      // `shape` / `size` with an exact `@type` union instead. AuroElement still
+      // consumes `this.layout` / `this.shape` / `this.size` in its render and
+      // architecture helpers below (subclasses guarantee the reactive props).
+      // See AlaskaAirlines/discussions#653.
     };
   }
 
@@ -20101,6 +20277,8 @@ class AuroHelpText extends i$3 {
     super();
 
     this.error = false;
+
+    /** @type {'default' | 'inverse'} */
     this.appearance = "default";
     this.onDark = false;
     this.hasTextContent = false;
@@ -20121,8 +20299,8 @@ class AuroHelpText extends i$3 {
     return {
 
       /**
-       * Defines whether the component will be on lighter or darker backgrounds.
-       * @property {'default', 'inverse'} - The appearance of the help text, either default (for light backgrounds) or inverse (for dark backgrounds).
+       * The appearance of the help text, either default (for light backgrounds) or inverse (for dark backgrounds).
+       * @type {'default' | 'inverse'}
        * @default 'default'
        */
       appearance: {
@@ -20135,6 +20313,7 @@ class AuroHelpText extends i$3 {
        */
       slotNodes: {
         type: Boolean,
+        attribute: 'slotnodes',
       },
 
       /**
@@ -20142,6 +20321,7 @@ class AuroHelpText extends i$3 {
        */
       hasTextContent: {
         type: Boolean,
+        attribute: 'hastextcontent',
       },
 
       /**
@@ -20157,6 +20337,7 @@ class AuroHelpText extends i$3 {
        */
       onDark: {
         type: Boolean,
+        attribute: 'ondark',
         reflect: true
       }
     };
@@ -20287,6 +20468,7 @@ function getOptionLabel(option) {
  * @slot label - Defines the content of the label.
  * @slot helpText - Defines the content of the helpText.
  * @slot displayValue - Allows custom HTML content to display the selected value when the combobox is not focused. Only works with `snowflake` and `emphasized` layouts.
+ * @csspart helpText - The help text and error message content container.
  * @event auroCombobox-valueSet - (Deprecated) Notifies that the component has a new value set.
  * @event input - Notifies that the component has a new value set.
  * @event inputValue - Notifies that the components internal HTML5 input value has changed.
@@ -20306,6 +20488,7 @@ class AuroCombobox extends AuroElement {
    */
   _initializeDefaults() {
     // Defaults that effect the combobox behavior and state
+    /** @type {'default' | 'inverse'} */
     this.appearance = "default";
     this.disabled = false;
     this.msgSelectionMissing = 'Please select an option.';
@@ -20391,7 +20574,7 @@ class AuroCombobox extends AuroElement {
 
       /**
        * Defines whether the component will be on lighter or darker backgrounds.
-       * @property {'default' | 'inverse'} appearance - The visual appearance of the component.
+       * @type {'default' | 'inverse'}
        * @default 'default'
        */
       appearance: {
@@ -20412,6 +20595,7 @@ class AuroCombobox extends AuroElement {
        */
       autoPlacement: {
         type: Boolean,
+        attribute: 'autoplacement',
         reflect: true
       },
 
@@ -20419,9 +20603,11 @@ class AuroCombobox extends AuroElement {
        * Array of available options to display in the dropdown.
        * This array contains all non-hidden options (e.g., hidden by filtering on input value).
        * @private
+       * @type {HTMLElement[]}
        */
       availableOptions: {
         state: true,
+        attribute: false,
         type: Array,
         reflect: false,
         hasChanged(newVal, oldVal) {
@@ -20491,6 +20677,7 @@ class AuroCombobox extends AuroElement {
        */
       dvInputOnly: {
         type: Boolean,
+        attribute: 'dvinputonly',
         reflect: true
       },
 
@@ -20524,6 +20711,29 @@ class AuroCombobox extends AuroElement {
        */
       layout: {
         type: String,
+        attribute: "layout",
+        reflect: true
+      },
+
+      /**
+       * Sets the shape of the combobox.
+       * @type {'box' | 'classic' | 'pill' | 'pill-left' | 'pill-right' | 'rounded' | 'snowflake'}
+       * @default 'classic'
+       */
+      shape: {
+        type: String,
+        attribute: "shape",
+        reflect: true
+      },
+
+      /**
+       * Sets the size of the combobox.
+       * @type {'xs' | 'sm' | 'md' | 'lg' | 'xl'}
+       * @default 'xl'
+       */
+      size: {
+        type: String,
+        attribute: "size",
         reflect: true
       },
 
@@ -20533,6 +20743,7 @@ class AuroCombobox extends AuroElement {
        */
       matchWidth: {
         type: Boolean,
+        attribute: 'matchwidth',
         reflect: true
       },
 
@@ -20541,6 +20752,7 @@ class AuroCombobox extends AuroElement {
        */
       noFilter: {
         type: Boolean,
+        attribute: 'nofilter',
         reflect: true
       },
 
@@ -20550,6 +20762,7 @@ class AuroCombobox extends AuroElement {
        */
       noFlip: {
         type: Boolean,
+        attribute: 'noflip',
         reflect: true
       },
 
@@ -20566,6 +20779,7 @@ class AuroCombobox extends AuroElement {
        */
       noValidate: {
         type: Boolean,
+        attribute: 'novalidate',
         reflect: true
       },
 
@@ -20583,6 +20797,7 @@ class AuroCombobox extends AuroElement {
        */
       onDark: {
         type: Boolean,
+        attribute: 'ondark',
         reflect: true
       },
 
@@ -20591,7 +20806,8 @@ class AuroCombobox extends AuroElement {
        * @type {HTMLElement}
        */
       optionSelected: {
-        type: Object
+        type: Object,
+        attribute: 'optionselected'
       },
 
       /**
@@ -20601,6 +20817,7 @@ class AuroCombobox extends AuroElement {
        */
       persistInput: {
         type: Boolean,
+        attribute: 'persistinput',
         reflect: true
       },
 
@@ -20634,28 +20851,32 @@ class AuroCombobox extends AuroElement {
        * Sets a custom help text message to display for all validityStates.
        */
       setCustomValidity: {
-        type: String
+        type: String,
+        attribute: 'setcustomvalidity'
       },
 
       /**
        * Custom help text message to display when validity = `customError`.
        */
       setCustomValidityCustomError: {
-        type: String
+        type: String,
+        attribute: 'setcustomvaliditycustomerror'
       },
 
       /**
        * Custom help text message to display when validity = `valueMissing`.
        */
       setCustomValidityValueMissing: {
-        type: String
+        type: String,
+        attribute: 'setcustomvalidityvaluemissing'
       },
 
       /**
        * Custom help text message to display when validity = `valueMissing` due to the user not choosing a menu option when behavior = "filter".
        */
       setCustomValidityValueMissingFilter: {
-        type: String
+        type: String,
+        attribute: 'setcustomvalidityvaluemissingfilter'
       },
 
       /**
@@ -20675,11 +20896,13 @@ class AuroCombobox extends AuroElement {
        */
       triggerIcon: {
         type: Boolean,
+        attribute: 'triggericon',
         reflect: true
       },
 
       /**
        * Applies the defined value as the type attribute on `auro-input`.
+       * @type {'text' | 'password' | 'email' | 'credit-card' | 'tel' | 'number' | 'date'}
        */
       type: {
         type: String,
@@ -20691,6 +20914,7 @@ class AuroCombobox extends AuroElement {
        */
       typedValue: {
         type: String,
+        attribute: 'typedvalue',
         reflect: true
       },
 
@@ -20716,6 +20940,7 @@ class AuroCombobox extends AuroElement {
        */
       largeFullscreenHeadline: {
         type: Boolean,
+        attribute: 'largefullscreenheadline',
         reflect: true
       },
       /* eslint-enable jsdoc/require-description-complete-sentence */
@@ -20730,12 +20955,14 @@ class AuroCombobox extends AuroElement {
        */
       fullscreenBreakpoint: {
         type: String,
+        attribute: "fullscreenbreakpoint",
         reflect: true
       },
 
       /**
        * Specifies the currently active option.
        * @private
+       * @type {HTMLElement}
        */
       optionActive: {
         type: Object,
@@ -22506,6 +22733,7 @@ let menuInstanceIdCounter = 0;
  * @event {CustomEvent<Element>} auroMenu-activatedOption - Notifies that a menuoption has been made `active`.
  * @event {CustomEvent<any>} auroMenu-customEventFired - Notifies that a custom event has been fired.
  * @event {CustomEvent<{ loading: boolean; hasLoadingPlaceholder: boolean; }>} auroMenu-loadingChange - Notifies when the loading attribute is changed.
+ * @event {CustomEvent<{ options: Array<HTMLElement> }>} auroMenu-optionsChange - Notifies that the set of available menu options has changed.
  * @event {CustomEvent<any>} auroMenu-selectValueFailure - Notifies that an attempt to select a menuoption by matching a value has failed.
  * @event {CustomEvent<any>} auroMenu-selectValueReset - Notifies that the component value has been reset.
  * @event {CustomEvent<any>} auroMenu-selectedOption - Notifies that a new menuoption selection has been made.
@@ -22520,15 +22748,7 @@ class AuroMenu extends AuroElement {
 
     // State properties (reactive)
 
-    /**
-     * @private
-     */
-    this.shape = "box";
-
-    /**
-     * @private
-     */
-    this.size = "sm";
+    this.initializeArchitectureDefaults();
 
     // Value of the selected options
     this.value = undefined;
@@ -22569,8 +22789,6 @@ class AuroMenu extends AuroElement {
 
     // Instance properties (non-reactive)
 
-    menuInstanceIdCounter += 1;
-
     Object.assign(this, {
       // Root-level menu (true) or a nested submenu (false)
       rootMenu: true,
@@ -22582,7 +22800,7 @@ class AuroMenu extends AuroElement {
       loadingSlots: null,
       // Unique id for this menu instance; prefixes every auto-generated option
       // key so keys never collide across menus in the same document.
-      _menuInstanceId: `menu-${menuInstanceIdCounter}`,
+      _menuInstanceId: `menu-${menuInstanceIdCounter += 1}`,
       // Monotonically increasing counter for option key generation. Never
       // resets, so a key is never reused within this instance's lifetime.
       _optionKeyCounter: 0,
@@ -22598,10 +22816,50 @@ class AuroMenu extends AuroElement {
     });
   }
 
+  // Defaults for the layout/shape/size architecture props are set in a helper
+  // (not the constructor body) so the CEM analyzer keeps their `@type` unions
+  // instead of inferring `string` from a constructor-literal assignment.
+  // See AlaskaAirlines/discussions#653.
+  initializeArchitectureDefaults() {
+    this.shape = "box";
+    this.size = "sm";
+  }
+
   static get properties() {
     return {
       ...super.properties,
 
+      /**
+       * Applies a named layout variant to the menu. Free-form string consumed by the shared architecture helpers; menu defines no closed value set.
+       */
+      layout: {
+        type: String,
+        attribute: "layout",
+        reflect: true
+      },
+
+      /**
+       * Sets the shape of the menu options.
+       * @type {'box' | 'pill' | 'snowflake'}
+       * @default 'box'
+       */
+      shape: {
+        type: String,
+        attribute: "shape",
+        reflect: true
+      },
+
+      /**
+       * Sets the size of the menu options.
+       * @type {'xs' | 'sm' | 'md' | 'lg' | 'xl'}
+       * @default 'sm'
+       */
+      size: {
+        type: String,
+        attribute: "size",
+        reflect: true
+      },
+
       /**
        * When true, the entire menu and all options are disabled.
        */
@@ -22657,6 +22915,7 @@ class AuroMenu extends AuroElement {
       /**
        * Specifies the current active menuOption.
        * @readonly
+       * @type {HTMLElement}
        */
       optionActive: {
         type: Object,
@@ -22666,6 +22925,7 @@ class AuroMenu extends AuroElement {
       /**
        * The currently selected menu option(s). In single-select mode this is a single `HTMLElement` (or `undefined` when nothing is selected). In multi-select mode this is an array of `HTMLElement`s.
        * @readonly
+       * @type {HTMLElement | HTMLElement[]}
        */
       optionSelected: {
         // Allow HTMLElement, HTMLElement[] arrays and undefined
@@ -23883,9 +24143,36 @@ class AuroMenuOption extends AuroElement {
   static get properties() {
     return {
       ...super.properties,
+
+      /**
+       * Sets the shape of the option. When unset, it inherits the shape of the parent `auro-menu`.
+       * @type {'box' | 'pill' | 'snowflake'}
+       * @default 'box'
+       */
+      shape: {
+        type: String,
+        attribute: "shape",
+        reflect: true
+      },
+
+      /**
+       * Sets the size of the option. When unset, it inherits the size of the parent `auro-menu`.
+       * @type {'xs' | 'sm' | 'md' | 'lg' | 'xl'}
+       * @default 'sm'
+       */
+      size: {
+        type: String,
+        attribute: "size",
+        reflect: true
+      },
+
+      /**
+       * When true, this option will not show the checkmark when selected.
+       */
       noCheckmark: {
         type: Boolean,
-        reflect: true
+        reflect: true,
+        attribute: 'nocheckmark'
       },
 
       /**
@@ -23897,21 +24184,34 @@ class AuroMenuOption extends AuroElement {
         type: Boolean,
         reflect: true
       },
+
+      /**
+       * When true, the option is disabled and cannot be selected.
+       */
       disabled: {
         type: Boolean,
         reflect: true
       },
+
+      /**
+       * The value associated with this menu option.
+       */
       value: {
         type: String,
         reflect: true
       },
+
+      /**
+       * Sets the tab order of the menu option.
+       */
       tabIndex: {
         type: Number,
-        reflect: true
+        reflect: true,
+        attribute: 'tabindex'
       },
 
       /**
-       * @private
+       * When set, selecting this option dispatches a custom event of the given name from the parent `auro-menu` (and an `auroMenu-customEventFired` event) instead of selecting the option.
        */
       event: {
         type: String,