@aurodesignsystem/auro-formkit 5.6.0 → 5.8.0

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

@@ -14,6 +14,15 @@
  */
 export class AuroCombobox extends AuroElement {
     static get properties(): {
+        /**
+         * Defines whether the component will be on lighter or darker backgrounds.
+         * @property {'default', 'inverse'}
+         * @default 'default'
+         */
+        appearance: {
+            type: StringConstructor;
+            reflect: boolean;
+        };
         /**
          * An enumerated attribute that defines what the user agent can suggest for autofill. At this time, only `autocomplete="off"` is supported.
          * @default false
@@ -38,6 +47,16 @@ export class AuroCombobox extends AuroElement {
             type: ArrayConstructor;
             reflect: boolean;
         };
+        /**
+         * Sets the behavior of the combobox, "filter" or "suggestion".
+         * "filter" requires the user to select an option from the menu.
+         * "suggestion" allows the user to enter a value not present in the menu options.
+         * @default suggestion
+         */
+        behavior: {
+            type: StringConstructor;
+            reflect: boolean;
+        };
         /**
          * When attribute is present auro-menu will apply check marks to selected options.
          */
@@ -105,7 +124,7 @@ export class AuroCombobox extends AuroElement {
             reflect: boolean;
         };
         /**
-         * If set, combobox will not filter menuoptions based in input.
+         * If set, combobox will not filter menuoptions based on input.
          */
         noFilter: {
             type: BooleanConstructor;
@@ -144,7 +163,7 @@ export class AuroCombobox extends AuroElement {
             reflect: boolean;
         };
         /**
-         * If declared, onDark styles will be applied to the trigger.
+         * DEPRECATED - use `appearance` instead.
          */
         onDark: {
             type: BooleanConstructor;
@@ -207,6 +226,12 @@ export class AuroCombobox extends AuroElement {
         setCustomValidityValueMissing: {
             type: StringConstructor;
         };
+        /**
+         * Custom help text message to display when validity = `valueMissing` due to the user not choosing a menu option when behavior = "filter".
+         */
+        setCustomValidityValueMissingFilter: {
+            type: StringConstructor;
+        };
         /**
          * Indicates whether the combobox is in a dirty state (has been interacted with).
          * @type {boolean}
@@ -288,6 +313,7 @@ export class AuroCombobox extends AuroElement {
      *
      */
     static register(name?: string): void;
+    appearance: string;
     disabled: boolean;
     msgSelectionMissing: string;
     noFilter: boolean;
@@ -297,6 +323,7 @@ export class AuroCombobox extends AuroElement {
     required: boolean;
     value: any;
     typedValue: any;
+    behavior: string;
     checkmark: boolean;
     dvInputOnly: boolean;
     fullscreenBreakpoint: string;
@@ -385,14 +412,6 @@ export class AuroCombobox extends AuroElement {
      * @returns {void}
      */
     showBib(): void;
-    /**
-     * Forces focus to the internal input element and positions the cursor at the end of the text.
-     * This is used when clicking anywhere within the Combobox to ensure the input receives focus
-     * and the cursor is positioned at the end for better user experience.
-     * @private
-     * @returns {void}
-     */
-    private forceFocusToInputEnd;
     /**
      * Binds all behavior needed to the dropdown after rendering.
      * @private