@vonage/vivid 4.24.0 → 4.25.0

package/shared/definition45.js

@@ -1,904 +1,1276 @@
-import { P as Popup, p as popupDefinition } from './definition65.js';
-import { i as iconDefinition } from './definition28.js';
-import { l as listboxOptionDefinition } from './definition36.js';
-import { D as DOM, O as Observable, o as observable, a as attr, v as volatile, h as html, g as createRegisterFunction, i as defineVividComponent } from './vivid-element.js';
-import { a as applyMixinsWithObservables } from './applyMixinsWithObservables.js';
-import { L as Listbox } from './listbox.js';
-import { H as HostSemantics, a as applyHostSemantics } from './host-semantics.js';
+import { B as Button, c as chevronTemplateFactory, b as buttonDefinition } from './definition11.js';
+import { P as Popup, p as popupDefinition } from './definition67.js';
+import { I as Icon, i as iconDefinition } from './definition28.js';
+import { P as ProgressRing, p as progressRingDefinition } from './definition39.js';
+import { O as Observable, D as DOM, V as VividElement, a as attr, n as nullableNumberConverter, o as observable, h as html, d as createRegisterFunction, f as defineVividComponent } from './vivid-element.js';
+import { a as WithFeedback, f as feedbackMessageDefinition } from './mixins.js';
+import { s as scrollIntoView } from './scrollIntoView.js';
+import { D as DelegatesAria, d as delegateAria } from './delegates-aria.js';
 import { F as FormAssociated } from './form-associated.js';
-import { i as inRange } from './numbers.js';
+import { W as WithErrorText } from './with-error-text.js';
+import { W as WithSuccessText } from './with-success-text.js';
+import { F as FormElement } from './form-element.js';
 import { A as AffixIconWithTrailing, a as affixIconTemplateFactory, I as IconWrapper } from './affix.js';
-import { u as uniqueId } from './strings.js';
-import { a as keySpace, b as keyEscape, c as keyTab, d as keyEnd, e as keyArrowUp, f as keyArrowDown, g as keyHome, k as keyEnter } from './key-codes.js';
-import { F as FormElementSuccessText, a as FormElementHelperText, e as errorText, f as formElements, g as getFeedbackTemplate } from './form-elements.js';
-import { L as ListboxOption } from './option.js';
-import { c as chevronTemplateFactory } from './definition11.js';
-import { h as handleEscapeKeyAndStopPropogation } from './index.js';
-import { r as ref } from './ref.js';
+import { L as Localized } from './localized.js';
+import { i as isListboxOption } from './option.js';
 import { w as when } from './when.js';
+import { r as ref } from './ref.js';
 import { s as slotted } from './slotted.js';
 import { c as classNames } from './class-names.js';
+import { r as repeat } from './repeat.js';
 
-const styles = ".chevron{display:flex;flex-shrink:0;font:var(--vvd-typography-base-extended);transform:rotate(0);transition:transform .2s}:host([aria-expanded=true]) .chevron,:host([open]) .chevron{transform:rotate(180deg)}:host(:focus-visible){outline:none}:host{display:inline-flex;flex-direction:column;gap:4px;--_low-ink-color: var(--vvd-color-neutral-600);--focus-stroke-gap-color: transparent}:host([disabled]){--_low-ink-color: var(--vvd-color-neutral-400);cursor:not-allowed}.label{color:var(--vvd-color-canvas-text);contain:inline-size;font:var(--vvd-typography-base)}.control{--_appearance-color-text: var(--vvd-color-canvas-text);--_appearance-color-fill: var(--vvd-color-canvas);--_appearance-color-outline: var(--vvd-color-neutral-500)}.control.appearance-ghost{--_appearance-color-text: var(--_connotation-color-firm);--_appearance-color-fill: transparent;--_appearance-color-outline: transparent}.control:where(.hover,:hover):where(:not(.disabled,:disabled,.readonly)){--_appearance-color-text: var(--vvd-color-canvas-text);--_appearance-color-fill: var(--vvd-color-canvas);--_appearance-color-outline: var(--vvd-color-neutral-700)}.control:where(.hover,:hover):where(:not(.disabled,:disabled,.readonly)).appearance-ghost{--_appearance-color-text: var(--_connotation-color-firm);--_appearance-color-fill: var(--_connotation-color-faint);--_appearance-color-outline: transparent}.control:where(.disabled,:disabled){--_appearance-color-text: var(--vvd-color-neutral-300);--_appearance-color-fill: var(--vvd-color-neutral-100);--_appearance-color-outline: var(--vvd-color-neutral-300)}.control:where(.disabled,:disabled).appearance-ghost{--_appearance-color-text: var(--vvd-color-neutral-300);--_appearance-color-fill: transparent;--_appearance-color-outline: transparent}.control:where(.readonly):where(:not(.disabled,:disabled)){--_appearance-color-text: var(--vvd-color-canvas-text);--_appearance-color-fill: var(--vvd-color-neutral-200);--_appearance-color-outline: var(--vvd-color-neutral-400)}.control:where(.readonly):where(:not(.disabled,:disabled)).appearance-ghost{--_appearance-color-text: var(--vvd-color-neutral-600);--_appearance-color-fill: transparent;--_appearance-color-outline: transparent}.control:where(.error):where(:not(.disabled,:disabled)){--_appearance-color-text: notSet;--_appearance-color-fill: var(--vvd-color-alert-50);--_appearance-color-outline: var(--vvd-color-alert-500)}.control:where(.error):where(:not(.disabled,:disabled)).appearance-ghost{--_appearance-color-text: notSet;--_appearance-color-fill: var(--vvd-color-alert-50);--_appearance-color-outline: transparent}.control:where(.success):where(:not(.disabled,:disabled)){--_appearance-color-text: notSet;--_appearance-color-fill: var(--vvd-color-success-50);--_appearance-color-outline: var(--vvd-color-success-500)}.control:where(.success):where(:not(.disabled,:disabled)).appearance-ghost{--_appearance-color-text: notSet;--_appearance-color-fill: var(--vvd-color-success-50);--_appearance-color-outline: transparent}.control{--_connotation-color-primary: var(--vvd-select-accent-primary, var(--vvd-color-canvas-text));--_connotation-color-primary-text: var(--vvd-select-accent-primary-text, var(--vvd-color-canvas));--_connotation-color-primary-increment: var(--vvd-select-accent-primary-increment, var(--vvd-color-neutral-800));--_connotation-color-intermediate: var(--vvd-select-accent-intermediate, var(--vvd-color-neutral-500));--_connotation-color-faint: var(--vvd-select-accent-faint, var(--vvd-color-neutral-50));--_connotation-color-soft: var(--vvd-select-accent-soft, var(--vvd-color-neutral-100));--_connotation-color-firm: var(--vvd-select-accent-firm, var(--vvd-color-canvas-text));--_connotation-color-fierce: var(--vvd-select-accent-fierce, var(--vvd-color-neutral-700))}.control{border-radius:var(--_select-control-border-radius);block-size:var(--_select-block-size);padding-inline:var(--_select-padding-inline)}.control{--_select-icon-size: calc(1px*(40 + 4*clamp(-1, var(--vvd-size-density, 0), 2))/2) ;--_select-block-size: calc(1px*(40 + 4*clamp(-1, var(--vvd-size-density, 0), 2))) ;--_select-padding-inline: calc(1px*(40 + 4*clamp(-1, var(--vvd-size-density, 0), 2))*.4) ;display:flex;align-items:center;justify-content:space-between;background-color:var(--_appearance-color-fill);box-shadow:inset 0 0 0 1px var(--_appearance-color-outline);color:var(--_appearance-color-text);font:var(--vvd-typography-base);gap:8px;transition:box-shadow .2s,background-color .2s}.control.size-condensed{--_select-icon-size: calc(1px*(40 + 4*clamp(-1, var(--vvd-size-density, 0), 2))*.4) ;--_select-block-size: calc(1px*(32 + 4*clamp(-1, var(--vvd-size-density, 0), 2))) ;--_select-padding-inline: calc(1px*(24 + 4*clamp(-1, var(--vvd-size-density, 0), 2))/2) }.control.size-condensed:not(.shape-pill){--_select-control-border-radius: 4px}.control-wrapper{position:relative}.control:not(.disabled){cursor:pointer}.control.disabled{pointer-events:none}.control:not(.shape-pill){--_select-control-border-radius: 8px}.control.shape-pill{--_select-control-border-radius: 24px}:host(:focus-visible) .control{box-shadow:0 0 0 4px color-mix(in srgb,var(--vvd-color-cta-500),transparent 85%),inset 0 0 0 3px var(--focus-stroke-gap-color, currentColor);outline:1px solid var(--focus-stroke-color, var(--vvd-color-cta-500));outline-offset:calc(-1px - var(--focus-inset, 0px))}.listbox{display:flex;max-height:var(--select-height, 408px);flex-direction:column;padding:4px;gap:2px;overflow-y:auto}:host([multiple]:focus-visible) .listbox{box-shadow:0 0 0 4px color-mix(in srgb,var(--vvd-color-cta-500),transparent 85%),inset 0 0 0 3px var(--focus-stroke-gap-color, currentColor);outline:1px solid var(--focus-stroke-color, var(--vvd-color-cta-500));outline-offset:calc(-1px - var(--focus-inset, 0px));border-radius:8px}.selected-value{display:flex;overflow:hidden;flex-grow:1;align-items:center;column-gap:12px;white-space:nowrap}.selected-value .text{overflow:hidden;max-inline-size:100%;text-overflow:ellipsis}.control.shows-placeholder .selected-value .text{color:var(--vvd-color-neutral-600)}.selected-value slot[name=icon]{flex:0 0 var(--_select-icon-size);font-size:var(--_select-icon-size);line-height:1}.control.has-meta .selected-value{padding-inline-end:8px}.feedback-wrapper{display:contents}::part(popup-base){inline-size:max-content;min-inline-size:var(--_select-fixed-width, 100%)}:host([multiple]) ::part(popup-base){position:static}";
+const styles = ".chevron{display:flex;flex-shrink:0;font:var(--vvd-typography-base-extended);transform:rotate(0);transition:transform .2s}:host([data-expanded=true]) .chevron,:host([open]) .chevron{transform:rotate(180deg)}:not(.disabled) .chevron{cursor:pointer}.disabled .chevron{color:var(--_low-ink-color);cursor:not-allowed}:host(:focus-visible){outline:none}:host{display:inline-block;inline-size:300px;--_low-ink-color: var(--vvd-color-neutral-600)}:host([disabled]){--_low-ink-color: var(--vvd-color-neutral-400);cursor:not-allowed}.control-wrapper{display:flex;flex-direction:column;gap:4px}.label{color:var(--vvd-color-canvas-text);font:var(--vvd-typography-base)}.selection-count{color:var(--_low-ink-color);font:var(--vvd-typography-base)}.fieldset{--_connotation-color-primary: var(--vvd-searchable-select-accent-primary, var(--vvd-color-canvas-text));--_connotation-color-primary-text: var(--vvd-searchable-select-accent-primary-text, var(--vvd-color-canvas));--_connotation-color-primary-increment: var(--vvd-searchable-select-accent-primary-increment, var(--vvd-color-neutral-800));--_connotation-color-intermediate: var(--vvd-searchable-select-accent-intermediate, var(--vvd-color-neutral-500));--_connotation-color-faint: var(--vvd-searchable-select-accent-faint, var(--vvd-color-neutral-50));--_connotation-color-soft: var(--vvd-searchable-select-accent-soft, var(--vvd-color-neutral-100));--_connotation-color-firm: var(--vvd-searchable-select-accent-firm, var(--vvd-color-canvas-text));--_connotation-color-fierce: var(--vvd-searchable-select-accent-fierce, var(--vvd-color-neutral-700))}.fieldset{--_appearance-color-text: var(--vvd-color-canvas-text);--_appearance-color-fill: var(--vvd-color-canvas);--_appearance-color-outline: var(--vvd-color-neutral-500)}.fieldset.appearance-ghost{--_appearance-color-text: var(--_connotation-color-firm);--_appearance-color-fill: transparent;--_appearance-color-outline: transparent}.fieldset:where(.hover,:hover):where(:not(.disabled,:disabled,.readonly)){--_appearance-color-text: var(--vvd-color-canvas-text);--_appearance-color-fill: var(--vvd-color-canvas);--_appearance-color-outline: var(--vvd-color-neutral-700)}.fieldset:where(.hover,:hover):where(:not(.disabled,:disabled,.readonly)).appearance-ghost{--_appearance-color-text: var(--_connotation-color-firm);--_appearance-color-fill: var(--_connotation-color-faint);--_appearance-color-outline: transparent}.fieldset:where(.disabled,:disabled){--_appearance-color-text: var(--vvd-color-neutral-300);--_appearance-color-fill: var(--vvd-color-neutral-100);--_appearance-color-outline: var(--vvd-color-neutral-300)}.fieldset:where(.disabled,:disabled).appearance-ghost{--_appearance-color-text: var(--vvd-color-neutral-300);--_appearance-color-fill: transparent;--_appearance-color-outline: transparent}.fieldset:where(.readonly):where(:not(.disabled,:disabled)){--_appearance-color-text: var(--vvd-color-canvas-text);--_appearance-color-fill: var(--vvd-color-neutral-200);--_appearance-color-outline: var(--vvd-color-neutral-400)}.fieldset:where(.readonly):where(:not(.disabled,:disabled)).appearance-ghost{--_appearance-color-text: var(--vvd-color-neutral-600);--_appearance-color-fill: transparent;--_appearance-color-outline: transparent}.fieldset:where(.error):where(:not(.disabled,:disabled)){--_appearance-color-text: notSet;--_appearance-color-fill: var(--vvd-color-alert-50);--_appearance-color-outline: var(--vvd-color-alert-500)}.fieldset:where(.error):where(:not(.disabled,:disabled)).appearance-ghost{--_appearance-color-text: notSet;--_appearance-color-fill: var(--vvd-color-alert-50);--_appearance-color-outline: transparent}.fieldset:where(.success):where(:not(.disabled,:disabled)){--_appearance-color-text: notSet;--_appearance-color-fill: var(--vvd-color-success-50);--_appearance-color-outline: var(--vvd-color-success-500)}.fieldset:where(.success):where(:not(.disabled,:disabled)).appearance-ghost{--_appearance-color-text: notSet;--_appearance-color-fill: var(--vvd-color-success-50);--_appearance-color-outline: transparent}.fieldset{display:flex;align-items:center;justify-content:space-between;background-color:var(--_appearance-color-fill);box-shadow:inset 0 0 0 1px var(--_appearance-color-outline);color:var(--_appearance-color-text);font:var(--vvd-typography-base);gap:8px;padding-block:8px;padding-inline:16px;transition:box-shadow .2s,background-color .2s}.fieldset:focus-within{box-shadow:0 0 0 4px color-mix(in srgb,var(--vvd-color-cta-500),transparent 85%),inset 0 0 0 3px var(--focus-stroke-gap-color, currentColor);outline:1px solid var(--focus-stroke-color, var(--vvd-color-cta-500));outline-offset:calc(-1px - var(--focus-inset, 0px));--focus-stroke-gap-color: transparent}:host(:not([shape=pill])) .fieldset{border-radius:8px}:host([shape=pill]) .fieldset{border-radius:24px}.popup-wrapper{position:relative}.content-area{display:flex;overflow:hidden;flex:1;flex-direction:column;gap:8px;min-block-size:24px}.tag-row{display:flex;gap:8px;inline-size:100%}.tag-row.contains-only-input:not(:focus-within){display:contents}.tag-wrapper{overflow:hidden}.tag{max-inline-size:100%}input{box-sizing:border-box;flex:1;border:none;background:none;block-size:24px;font:var(--vvd-typography-base);max-inline-size:100%;min-inline-size:100px;outline:none}.contains-only-input input:not(:focus){position:absolute;block-size:0;inline-size:0;min-inline-size:0;opacity:0;pointer-events:none}.listbox{display:flex;flex-direction:column;padding:4px;gap:2px;max-block-size:var(--searchable-select-height, 408px);overflow-y:auto}.empty-message{display:flex;align-items:center;justify-content:center;color:var(--vvd-color-neutral-300);font:var(--vvd-typography-base);min-block-size:40px;text-align:center}::part(popup-base){inline-size:max-content;min-inline-size:var(--_searchable-select-fixed-width, 100%)}slot[name=icon]{font-size:20px}.visually-hidden{position:absolute;overflow:hidden;width:1px;height:1px;clip:rect(0 0 0 0);clip-path:inset(50%);white-space:nowrap}";
 
-class _Select extends Listbox {
-}
-class FormAssociatedSelect extends FormAssociated(_Select) {
-  constructor() {
-    super(...arguments);
-    this.proxy = document.createElement("select");
-  }
-}
+const optionTagStyles = ".base.connotation-cta{--_connotation-color-contrast: var(--vvd-option-tag-cta-contrast, var(--vvd-color-cta-800))}.base:not(.connotation-cta){--_connotation-color-contrast: var(--vvd-option-tag-accent-contrast, var(--vvd-color-neutral-800))}.base{position:relative;display:inline-flex;box-sizing:border-box;align-items:center;background-color:var(--fill-color);block-size:calc(1px*(24 + 4*clamp(-1,var(--vvd-size-density, 0),2)));box-shadow:inset 0 0 0 1px var(--outline-color);color:var(--text-color);column-gap:8px;font:var(--vvd-typography-base-bold);max-inline-size:100%;padding-inline:8px;user-select:none;vertical-align:middle}.base:not(.disabled){--text-color: var(--_connotation-color-contrast);--fill-color: color-mix( in srgb, var(--_connotation-color-contrast), transparent 87.5% );--outline-color: transparent}.base.disabled{--text-color: var(--vvd-color-neutral-300);--fill-color: color-mix( in srgb, var(--vvd-color-neutral-800), transparent 87.5% );--outline-color: transparent}.base:not(.shape-pill){border-radius:4px}.base.shape-pill{border-radius:16px}.label{overflow:hidden;max-inline-size:100%;text-overflow:ellipsis;white-space:nowrap}slot[name=icon]{font-size:calc(calc(1px*(24 + 4*clamp(-1,var(--vvd-size-density, 0),2))) / 1.5);line-height:1}.icon-placeholder{inline-size:calc(calc(1px*(24 + 4*clamp(-1,var(--vvd-size-density, 0),2))) / 1.5)}.remove-button{display:flex;align-items:center;border-radius:inherit;cursor:pointer;outline:none}.disabled .remove-button{pointer-events:none}.remove-button:focus-visible:before{--focus-stroke-gap-color: transparent;box-shadow:0 0 0 4px color-mix(in srgb,var(--vvd-color-cta-500),transparent 85%),inset 0 0 0 3px var(--focus-stroke-gap-color, currentColor);outline:1px solid var(--focus-stroke-color, var(--vvd-color-cta-500));outline-offset:calc(-1px - var(--focus-inset, 0px));position:absolute;z-index:1;display:block;border-radius:inherit;content:\"\";inset:0;pointer-events:none}";
 
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __decorateClass = (decorators, target, key, kind) => {
-  var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
+var __defProp$1 = Object.defineProperty;
+var __decorateClass$1 = (decorators, target, key, kind) => {
+  var result = void 0 ;
   for (var i = decorators.length - 1, decorator; i >= 0; i--)
     if (decorator = decorators[i])
-      result = (kind ? decorator(target, key, result) : decorator(result)) || result;
-  if (kind && result) __defProp(target, key, result);
+      result = (decorator(target, key, result) ) || result;
+  if (result) __defProp$1(target, key, result);
   return result;
 };
-let Select = class extends HostSemantics(
-  AffixIconWithTrailing(FormAssociatedSelect)
+const TagGapPx = 8;
+const InputMinWidthPx = 100;
+const PageSize = 10;
+const isFormAssociatedTryingToSetFormValue = (value) => typeof value === "string";
+class SearchableSelect extends WithFeedback(
+  WithErrorText(
+    WithSuccessText(
+      FormElement(
+        DelegatesAria(
+          AffixIconWithTrailing(Localized(FormAssociated(VividElement)))
+        )
+      )
+    )
+  )
 ) {
   constructor() {
     super(...arguments);
-    this.activeIndex = -1;
+    this.fixedDropdown = false;
+    this.open = false;
+    this.multiple = false;
+    this.externalTags = false;
+    this.maxLines = null;
+    this.values = [];
+    this.initialValues = [];
+    this._currentSearchText = null;
+    // --- Slotted options ---
     /**
-     * The start index when checking a range of options.
-     *
      * @internal
      */
-    this.rangeStartIndex = -1;
-    this.open = false;
+    this._areOptionsInitialized = false;
+    this.#slottedOptionsChangeHandler = {
+      handleChange: (source, _) => {
+        if (source.selected && !this.values.includes(source.value)) {
+          this.values = [...this.values, source.value];
+        } else if (!source.selected && this.values.includes(source.value)) {
+          this.values = this.values.filter((option) => option !== source.value);
+        }
+      }
+    };
+    // --- Option tag icons ---
+    this.#clonedTagIcons = /* @__PURE__ */ new Map();
+    this._filteredOptions = [];
+    this._filteredEnabledOptions = [];
+    this.loading = false;
+    this._highlightedOptionIndex = null;
+    this._numElidedTags = 0;
+    this._tagRows = [];
+    this._lastTagRow = [];
+    this.clearable = false;
+    this.maxSelected = null;
+    this._slottedDisabledOptions = [];
+    // --- Form handling ---
     /**
-     * The unique id for the internal listbox element.
-     *
      * @internal
      */
-    this.listboxId = uniqueId("listbox-");
-    this.maxHeight = 0;
-    this.fixedDropdown = false;
-    this.placeholderOption = null;
-    this._feedbackWrapper = null;
+    this.proxy = document.createElement("input");
+    this.setFormValue = (value, state) => {
+      if (isFormAssociatedTryingToSetFormValue(value)) {
+        return;
+      }
+      super.setFormValue(value, state);
+    };
+    this._changeDescription = "";
+    // --- Core ---
+    this.#resizeObserver = new ResizeObserver(() => {
+      this.#updateTagLayout();
+    });
   }
   /**
-   * Returns the last checked option.
-   *
    * @internal
    */
-  get activeOption() {
-    return this.options[this.activeIndex];
+  openChanged() {
+    if (!this.open) {
+      this.#transitionHighlightedOptionTo(null);
+    }
   }
   /**
-   * Returns the list of checked options.
-   *
    * @internal
    */
-  get checkedOptions() {
-    return this.options.filter((o) => o.checked);
+  valuesChanged() {
+    if (!this._areOptionsInitialized) {
+      return;
+    }
+    if (!this.multiple && this.values.length > 1) {
+      this.values = [this.values[0]];
+      return;
+    }
+    if (this.values.some((value) => !this.#isValidValue(value))) {
+      this.values = this.values.filter((value) => this.#isValidValue(value));
+      return;
+    }
+    this.value = this.values.length ? this.values[0] : "";
+    this.#updateSelectionLimit();
+    this.#updateSelectedOnSlottedOptions();
+    if (this.$fastController.isConnected) {
+      this.#updateTagLayout();
+    }
+    this.#updateFormValue();
   }
-  /**
-   * Returns the index of the first selected option.
-   *
-   * @internal
-   */
-  get firstSelectedOptionIndex() {
-    return this.options.indexOf(this.firstSelectedOption);
+  #updateValuesThroughUserInteraction(newValues) {
+    this.values = newValues;
+    this.$emit("change", void 0, {
+      bubbles: false
+    });
+    this.$emit("input", void 0, {
+      bubbles: false
+    });
   }
-  /**
-   * Updates the `ariaActiveDescendant` property when the active index changes.
-   *
-   * @internal
-   */
-  activeIndexChanged(_, next) {
-    this._activeDescendant = this.options[next]?.id ?? "";
-    this.focusAndScrollOptionIntoView();
+  #updateValuesWhileMaintainingOrder(newValues) {
+    const oldSet = new Set(this.values);
+    const newSet = new Set(newValues);
+    this.values = [...this.values].filter((v) => newSet.has(v)).concat([...newValues].filter((v) => !oldSet.has(v)));
   }
   /**
-   * Toggles the checked state for the currently active option.
-   *
-   * @remarks
-   * Multiple-selection mode only.
-   *
    * @internal
    */
-  checkActiveIndex() {
-    const activeItem = this.activeOption;
-    if (activeItem) {
-      activeItem.checked = true;
+  initialValuesChanged() {
+    if (!this.dirtyValue) {
+      this.values = this.initialValues;
+      this.dirtyValue = false;
     }
   }
+  #isValidValue(value) {
+    return this._slottedOptions.some((option) => option.value === value);
+  }
   /**
-   * Sets the active index to the first option and marks it as checked.
-   *
-   * @remarks
-   * Multi-selection mode only.
-   *
-   * @param preserveChecked - mark all options unchecked before changing the active index
-   *
    * @internal
    */
-  checkFirstOption(preserveChecked) {
-    if (preserveChecked) {
-      if (this.rangeStartIndex === -1) {
-        this.rangeStartIndex = this.activeIndex + 1;
-      }
-      this.options.forEach((o, i) => {
-        o.checked = inRange(i, this.rangeStartIndex);
-      });
+  valueChanged(prev, next) {
+    super.valueChanged(prev, next);
+    if (!this._areOptionsInitialized) {
+      return;
+    }
+    const isValidValue = this._slottedOptions.some(
+      (option) => option.value === next
+    );
+    if (this.values[0] !== next) {
+      this.values = isValidValue ? [next] : [];
+    }
+  }
+  get selectedIndex() {
+    if (this.values.length) {
+      return this._slottedOptions.findIndex(
+        (option) => option.value === this.values[0]
+      );
     } else {
-      this.uncheckAllOptions();
+      return -1;
     }
-    this.activeIndex = 0;
-    this.checkActiveIndex();
+  }
+  set selectedIndex(index) {
+    this.value = this._slottedOptions[index]?.value ?? "";
+  }
+  get options() {
+    return [...this._slottedOptions];
+  }
+  get selectedOptions() {
+    return this._slottedOptions.filter(
+      (option) => this.values.includes(option.value)
+    );
   }
   /**
-   * Decrements the active index and sets the matching option as checked.
-   *
-   * @remarks
-   * Multi-selection mode only.
-   *
-   * @param preserveChecked - mark all options unchecked before changing the active index
-   *
    * @internal
    */
-  checkLastOption(preserveChecked) {
-    if (preserveChecked) {
-      if (this.rangeStartIndex === -1) {
-        this.rangeStartIndex = this.activeIndex;
-      }
-      this.options.forEach((o, i) => {
-        o.checked = inRange(i, this.rangeStartIndex, this.length);
-      });
-    } else {
-      this.uncheckAllOptions();
-    }
-    this.activeIndex = this.length - 1;
-    this.checkActiveIndex();
+  _currentSearchTextChanged() {
+    this.#updateFilteredOptions();
+    this.$emit("search-text-change", void 0, {
+      bubbles: false,
+      composed: false
+    });
   }
   /**
-   * Increments the active index and marks the matching option as checked.
-   *
-   * @remarks
-   * Multiple-selection mode only.
-   *
-   * @param preserveChecked - mark all options unchecked before changing the active index
-   *
-   * @internal
+   * The current search text of the component.
    */
-  checkNextOption(preserveChecked) {
-    if (preserveChecked) {
-      if (this.rangeStartIndex === -1) {
-        this.rangeStartIndex = this.activeIndex;
-      }
-      this.options.forEach((o, i) => {
-        o.checked = inRange(i, this.rangeStartIndex, this.activeIndex + 1);
-      });
-    } else {
-      this.uncheckAllOptions();
-    }
-    this.activeIndex += this.activeIndex < this.length - 1 ? 1 : 0;
-    this.checkActiveIndex();
+  get searchText() {
+    return this._currentSearchText ?? "";
   }
   /**
-   * Decrements the active index and marks the matching option as checked.
-   *
-   * @remarks
-   * Multiple-selection mode only.
-   *
-   * @param preserveChecked - mark all options unchecked before changing the active index
-   *
    * @internal
    */
-  checkPreviousOption(preserveChecked) {
-    if (preserveChecked) {
-      if (this.rangeStartIndex === -1) {
-        this.rangeStartIndex = this.activeIndex;
-      }
-      if (this.checkedOptions.length === 1) {
-        this.rangeStartIndex += 1;
-      }
-      this.options.forEach((o, i) => {
-        o.checked = inRange(i, this.activeIndex, this.rangeStartIndex);
-      });
-    } else {
-      this.uncheckAllOptions();
-    }
-    this.activeIndex -= this.activeIndex > 0 ? 1 : 0;
-    this.checkActiveIndex();
+  get _inputValue() {
+    return this._currentSearchText ?? (!this.multiple && this.value !== "" ? this.#textForValue(this.value) ?? "" : "");
   }
   /**
    * @internal
    */
-  focusAndScrollOptionIntoView() {
-    super.focusAndScrollOptionIntoView(this.activeOption);
+  _onInputInput(event) {
+    this._currentSearchText = event.target.value;
   }
   /**
-   * In multiple-selection mode:
-   * If any options are selected, the first selected option is checked when
-   * the listbox receives focus. If no options are selected, the first
-   * selectable option is checked.
-   *
    * @internal
    */
-  focusinHandler(e) {
-    if (!this.multiple) {
-      return super.focusinHandler(e);
-    }
-    if (!this.shouldSkipFocus && e.target === e.currentTarget) {
-      this.uncheckAllOptions();
-      if (this.activeIndex === -1) {
-        this.activeIndex = this.firstSelectedOptionIndex !== -1 ? this.firstSelectedOptionIndex : 0;
-      }
-      this.checkActiveIndex();
-      this.setSelectedOptions();
-      this.focusAndScrollOptionIntoView();
-    }
-    this.shouldSkipFocus = false;
+  _onInputFocus(_) {
+    this.#updateFilteredOptions();
+    this.open = true;
   }
   /**
-   * Sets an option as selected and gives it focus.
-   *
-   * @public
+   * @internal
    */
-  setSelectedOptions() {
-    if (!this.multiple) {
-      super.setSelectedOptions();
-      return;
-    }
-    if (this.$fastController.isConnected && this.options) {
-      this.selectedOptions = this.options.filter((o) => o.selected);
-      this.focusAndScrollOptionIntoView();
-    }
+  _onInputBlur(_) {
+    this.open = false;
+    this._currentSearchText = null;
+    this._changeDescription = "";
   }
   /**
-   * Toggles the selected state of the provided options. If any provided items
-   * are in an unselected state, all items are set to selected. If every
-   * provided item is selected, they are all unselected.
-   *
    * @internal
    */
-  toggleSelectedForAllCheckedOptions() {
-    const enabledCheckedOptions = this.checkedOptions.filter(
-      (o) => !o.disabled
-    );
-    const force = !enabledCheckedOptions.every((o) => o.selected);
-    enabledCheckedOptions.forEach((o) => o.selected = force);
-    this.selectedIndex = this.options.indexOf(
-      enabledCheckedOptions[enabledCheckedOptions.length - 1]
-    );
-    this.setSelectedOptions();
-    this.updateValue(true);
+  _onInputKeydown(e) {
+    if (e.ctrlKey || e.shiftKey) {
+      return true;
+    }
+    switch (e.key) {
+      case "Enter":
+        this.#selectHighlightedOption();
+        return false;
+      case "Escape":
+        this.open = false;
+        break;
+      case "Home":
+        if (!this.open) {
+          this.open = true;
+          break;
+        }
+        this.#highlightFirstOption();
+        return false;
+      case "End":
+        if (!this.open) {
+          this.open = true;
+          break;
+        }
+        this.#highlightLastOption();
+        return false;
+      case "PageUp":
+        if (!this.open) {
+          this.open = true;
+          break;
+        }
+        this.#highlightPrevPage();
+        return false;
+      case "PageDown":
+        if (!this.open) {
+          this.open = true;
+          break;
+        }
+        this.#highlightNextPage();
+        return false;
+      case "ArrowUp":
+        if (!this.open) {
+          this.open = true;
+          break;
+        }
+        this.#highlightPreviousOption();
+        return false;
+      case "ArrowDown":
+        if (!this.open) {
+          this.open = true;
+          break;
+        }
+        this.#highlightNextOption();
+        return false;
+      case "ArrowLeft":
+        if (this.multiple && this._inputValue === "" && this.values.length && !this.externalTags) {
+          this.#moveTagFocusTo(this.#nextTagIndexLeft(this.values.length));
+          return false;
+        }
+        return true;
+      case "Backspace":
+        if (this.multiple && this._inputValue === "" && this.values.length) {
+          this._onTagRemoved(this.values[this.values.length - 1]);
+          return false;
+        }
+        return true;
+      default:
+        if (!this.open) {
+          this.open = true;
+        }
+        return true;
+    }
+    return true;
   }
   /**
    * @internal
    */
-  typeaheadBufferChanged(prev, next) {
-    if (!this.multiple) {
-      super.typeaheadBufferChanged(prev, next);
+  _slottedOptionsChanged(oldValue, newValue) {
+    const hasSlottedOptions = Boolean(
+      this.querySelectorAll(`:not([slot])`).length
+    );
+    if (!newValue.length && hasSlottedOptions) {
       return;
     }
-    if (this.$fastController.isConnected) {
-      const typeaheadMatches = this.getTypeaheadMatches();
-      const activeIndex = this.options.indexOf(typeaheadMatches[0]);
-      if (activeIndex > -1) {
-        this.activeIndex = activeIndex;
-        this.uncheckAllOptions();
-        this.checkActiveIndex();
+    this._areOptionsInitialized = true;
+    if (oldValue) {
+      this._slottedDisabledOptions = [];
+      for (const option of oldValue) {
+        const notifier = Observable.getNotifier(option);
+        notifier.unsubscribe(this.#slottedOptionsChangeHandler, "selected");
+      }
+    }
+    if (newValue) {
+      for (const option of newValue) {
+        option._displayCheckmark = true;
+        const notifier = Observable.getNotifier(option);
+        notifier.subscribe(this.#slottedOptionsChangeHandler, "selected");
       }
-      this.typeaheadExpired = false;
     }
+    const values = [];
+    for (const option of this._slottedOptions) {
+      if (option.selected || option.value === this.value || this.values.includes(option.value)) {
+        values.push(option.value);
+      }
+      if (option.disabled) {
+        this._slottedDisabledOptions.push(option);
+      }
+    }
+    this.#updateValuesWhileMaintainingOrder(values);
+    this.#updateFilteredOptions();
+    this.#updateSelectionLimit();
+  }
+  #slottedOptionsChangeHandler;
+  #updateSelectedOnSlottedOptions() {
+    for (const option of this._slottedOptions) {
+      option.selected = this.values.includes(option.value);
+      this.#updateClonedTagIconOfOption(option);
+    }
+  }
+  #handleOptionInteraction(option) {
+    const value = option.value;
+    let newValues;
+    let shouldClearSearchText = false;
+    const isSelection = !this.values.includes(value);
+    if (this.multiple) {
+      if (isSelection) {
+        newValues = [...this.values, value];
+      } else {
+        newValues = this.values.filter((option2) => option2 !== value);
+      }
+      shouldClearSearchText = true;
+    } else {
+      if (isSelection) {
+        newValues = [value];
+        shouldClearSearchText = true;
+      } else {
+        newValues = [];
+      }
+      this.open = false;
+    }
+    this.#updateValuesThroughUserInteraction(newValues);
+    const optionMessage = isSelection ? this.locale.searchableSelect.optionSelectedMessage(option.text) : this.locale.searchableSelect.optionDeselectedMessage(option.text);
+    const maxSelectedMessage = this.multiple && this.maxSelected && this.maxSelected >= 1 ? this.locale.searchableSelect.maxSelectedMessage(
+      this.values.length,
+      this.maxSelected
+    ) : "";
+    this._changeDescription = `${optionMessage} ${maxSelectedMessage}`;
+    if (shouldClearSearchText) {
+      this._currentSearchText = null;
+    }
+  }
+  #clonedTagIcons;
+  #tagIconOfOption(option) {
+    return option.querySelector('[slot="tag-icon"]');
   }
   /**
-   * Unchecks all options.
-   *
-   * @remarks
-   * Multiple-selection mode only.
-   *
-   * @param preserveChecked - reset the rangeStartIndex
-   *
    * @internal
    */
-  uncheckAllOptions(preserveChecked = false) {
-    this.options.forEach((o) => o.checked = false);
-    if (!preserveChecked) {
-      this.rangeStartIndex = -1;
+  _tagIconSlotName(value) {
+    return `_tag-icon-${this.values.indexOf(value)}`;
+  }
+  #updateClonedTagIconOfOption(option) {
+    if (option.selected && this.#tagIconOfOption(option)) {
+      let clone = this.#clonedTagIcons.get(option);
+      if (!clone) {
+        clone = this.#tagIconOfOption(option).cloneNode(true);
+        this.#clonedTagIcons.set(option, clone);
+      }
+      clone.slot = this._tagIconSlotName(option.value);
+      this.appendChild(clone);
+    } else {
+      const clone = this.#clonedTagIcons.get(option);
+      if (clone) {
+        clone.remove();
+        this.#clonedTagIcons.delete(option);
+      }
     }
   }
   /**
-   * Sets focus when the open property changes.
-   *
    * @internal
    */
-  openChanged(prev, next) {
-    if (!this.collapsible) {
-      return;
+  optionFilterChanged() {
+    this.#updateFilteredOptions();
+  }
+  #updateFilteredOptions() {
+    const newFilteredOptions = [];
+    const optionFilter = this.optionFilter ?? ((option, searchText) => option.text.toLowerCase().includes(searchText.toLowerCase()));
+    for (const option of this._slottedOptions ?? []) {
+      option._vvdSearchText = this.searchText;
+      const matches = !this.searchText || optionFilter(option, this.searchText);
+      option._isNotMatching = !matches;
+      if (!option.hidden && matches) {
+        newFilteredOptions.push(option);
+      }
     }
-    if (this.open) {
-      this.focusAndScrollOptionIntoView();
-      this.indexWhenOpened = this.selectedIndex;
-      DOM.queueUpdate(() => this.focus());
-      return;
+    this.#transitionHighlightedOptionTo(null);
+    this._filteredOptions = newFilteredOptions;
+    this._filteredEnabledOptions = newFilteredOptions.filter(
+      (option) => !option.disabled
+    );
+  }
+  #transitionHighlightedOptionTo(index) {
+    if (typeof this._highlightedOptionIndex === "number") {
+      this._filteredEnabledOptions[this._highlightedOptionIndex]._highlighted = false;
+    }
+    if (typeof index === "number") {
+      if (!this._filteredEnabledOptions.length) {
+        index = null;
+      } else {
+        index = Math.max(
+          0,
+          Math.min(this._filteredEnabledOptions.length - 1, index)
+        );
+      }
+    }
+    this._highlightedOptionIndex = index;
+    if (typeof this._highlightedOptionIndex === "number") {
+      const highlightedOption = this._filteredEnabledOptions[this._highlightedOptionIndex];
+      highlightedOption._highlighted = true;
+      scrollIntoView(highlightedOption, this._listbox, "nearest");
+      this._changeDescription = this.locale.searchableSelect.optionFocusedMessage(
+        highlightedOption.text,
+        this._highlightedOptionIndex + 1,
+        this._filteredEnabledOptions.length
+      );
     }
-    const didClose = prev === true && next === false;
-    const selectionChangedWhileOpen = this.indexWhenOpened !== this.selectedIndex;
-    if (didClose && selectionChangedWhileOpen) {
-      this.updateValue(true);
+  }
+  #selectHighlightedOption() {
+    if (this._highlightedOptionIndex === null) {
+      return;
     }
+    this.#handleOptionInteraction(
+      this._filteredEnabledOptions[this._highlightedOptionIndex]
+    );
+  }
+  #highlightFirstOption() {
+    this.#transitionHighlightedOptionTo(0);
   }
-  get collapsible() {
-    return !this.multiple;
+  #highlightLastOption() {
+    this.#transitionHighlightedOptionTo(
+      this._filteredEnabledOptions.length - 1
+    );
+  }
+  #highlightPrevPage() {
+    this.#transitionHighlightedOptionTo(
+      (this._highlightedOptionIndex ?? this._filteredEnabledOptions.length) - PageSize
+    );
   }
+  #highlightNextPage() {
+    this.#transitionHighlightedOptionTo(
+      (this._highlightedOptionIndex ?? -1) + PageSize
+    );
+  }
+  #highlightPreviousOption() {
+    this.#transitionHighlightedOptionTo(
+      (this._highlightedOptionIndex ?? this._filteredEnabledOptions.length) - 1
+    );
+  }
+  #highlightNextOption() {
+    this.#transitionHighlightedOptionTo(
+      (this._highlightedOptionIndex ?? -1) + 1
+    );
+  }
+  // --- Tags ---
   /**
-   * The value property.
-   *
-   * @public
+   * @internal
    */
-  get value() {
-    Observable.track(this, "value");
-    return this._value;
-  }
-  set value(next) {
-    const prev = `${this._value}`;
-    if (this.length) {
-      const selectedIndex = this._options.findIndex((el) => el.value === next);
-      const prevSelectedValue = this._options[this.selectedIndex]?.value ?? null;
-      const nextSelectedValue = this._options[selectedIndex]?.value ?? null;
-      if (selectedIndex === -1 || prevSelectedValue !== nextSelectedValue) {
-        next = "";
-        this.selectedIndex = selectedIndex;
-      }
-      next = this.firstSelectedOption?.value ?? next;
-    }
-    if (prev !== next) {
-      this._value = next;
-      super.valueChanged(prev, next);
-      Observable.notify(this, "value");
-      this.updateDisplayValue();
-    }
+  _tagLabelForValue(value) {
+    const option = this._slottedOptions.find(
+      (option2) => option2.value === value
+    );
+    return option.label;
   }
   /**
-   * Sets the value and display value to match the first selected option.
-   *
-   * @param shouldEmit - if true, the input and change events will be emitted
-   *
    * @internal
    */
-  updateValue(shouldEmit) {
-    if (this.$fastController.isConnected) {
-      this.value = this.firstSelectedOption?.value ?? "";
-    }
-    if (shouldEmit) {
-      this.$emit("input");
-      this.$emit("change", this, {
-        bubbles: true,
-        composed: void 0
-      });
-    }
+  _tagConnotationForValue(value) {
+    const option = this._slottedOptions.find(
+      (option2) => option2.value === value
+    );
+    return option.tagConnotation;
   }
   /**
-   * Updates the proxy value when the selected index changes.
-   *
-   * @param prev - the previous selected index
-   * @param next - the next selected index
-   *
    * @internal
    */
-  selectedIndexChanged(prev, next) {
-    super.selectedIndexChanged(prev, next);
-    this.updateValue();
+  _isTagDisabled(value) {
+    const option = this._slottedOptions.find(
+      (option2) => option2.value === value
+    );
+    return this.disabled || option.disabled;
+  }
+  #textForValue(value) {
+    return this._slottedOptions?.find((option) => option.value === value)?.text;
   }
   /**
-   * Handle opening and closing the listbox when the select is clicked.
-   *
-   * @param e - the mouse event
    * @internal
    */
-  clickHandler(e) {
-    if (this.disabled) {
+  #measureTagWidth(label, removable, hasIcon) {
+    const tag = document.createElement(this._optionTagTagName);
+    tag.label = label;
+    tag.removable = removable;
+    tag.style.cssText = "position: absolute; visibility: hidden;";
+    tag.hasIconPlaceholder = hasIcon;
+    this.shadowRoot.appendChild(tag);
+    const width = tag.getBoundingClientRect().width;
+    tag.remove();
+    return width;
+  }
+  #updateTagLayout() {
+    if (!this.multiple) {
+      this._numElidedTags = 0;
+      this._tagRows = [];
+      this._lastTagRow = [];
       return;
     }
-    const clickedOption = e.target.closest(
-      `option,[role=option]`
-    );
-    if (clickedOption && clickedOption.disabled) {
+    if (this.externalTags) {
+      this._numElidedTags = this.values.length;
+      this._tagRows = [];
+      this._lastTagRow = [];
       return;
     }
-    if (this.multiple) {
-      this.uncheckAllOptions();
-      this.activeIndex = this.options.indexOf(clickedOption);
-      this.checkActiveIndex();
-      this.toggleSelectedForAllCheckedOptions();
-    } else {
-      super.clickHandler(e);
+    const rowWidth = this._contentArea.getBoundingClientRect().width;
+    const rows = [[]];
+    let currentRowIndex = 0;
+    let currentRowWidth = InputMinWidthPx;
+    let i;
+    for (i = this.values.length - 1; i >= 0; i--) {
+      const isLastRow = this.maxLines && currentRowIndex === this.maxLines - 1;
+      const tagWidth = this.#measureTagWidth(
+        this._tagLabelForValue(this.values[i]),
+        true,
+        this.#tagIconOfOption(this.selectedOptions[i]) !== null
+      );
+      const entry = {
+        value: this.values[i],
+        width: tagWidth
+      };
+      let elidedTagCounterWidth = 0;
+      if (isLastRow) {
+        const numElidedTags = i;
+        if (numElidedTags) {
+          elidedTagCounterWidth = TagGapPx + this.#measureTagWidth(numElidedTags.toString(), false, false);
+        }
+      }
+      const totalWidthNeeded = currentRowWidth + TagGapPx + tagWidth + elidedTagCounterWidth;
+      if (totalWidthNeeded > rowWidth) {
+        if (isLastRow) {
+          if (i === this.values.length - 1) {
+            rows[currentRowIndex].unshift(entry);
+            currentRowWidth += TagGapPx + tagWidth;
+          } else {
+            break;
+          }
+        } else {
+          rows.push([]);
+          currentRowIndex++;
+          rows[currentRowIndex].unshift(entry);
+          currentRowWidth = tagWidth;
+        }
+        continue;
+      }
+      rows[currentRowIndex].unshift(entry);
+      currentRowWidth += TagGapPx + tagWidth;
     }
-    if (this.collapsible) {
-      this.open = !this.open;
+    this._numElidedTags = i + 1;
+    rows.reverse();
+    for (let i2 = 0; i2 < rows.length - 1; i2++) {
+      let lineWidth = rows[i2].map((e) => e.width).reduce((a, b) => a + b, 0) + (rows[i2].length - 1) * TagGapPx;
+      if (i2 === 0 && this._numElidedTags) {
+        lineWidth += TagGapPx + this.#measureTagWidth(this._numElidedTags.toString(), false, false);
+      }
+      while (rows[i2 + 1].length && lineWidth + TagGapPx + rows[i2 + 1][0].width <= rowWidth) {
+        const nextTag = rows[i2 + 1].shift();
+        rows[i2].push(nextTag);
+        lineWidth += TagGapPx + nextTag.width;
+      }
     }
-    return true;
+    const rowValues = rows.map((line) => line.map((entry) => entry.value));
+    this._tagRows = rowValues.slice(0, -1);
+    this._lastTagRow = rowValues.slice(-1)[0];
   }
   /**
-   * Handles focus state when the element or its children lose focus.
-   *
-   * @param e - The focus event
    * @internal
    */
-  focusoutHandler(e) {
-    if (this.multiple) {
-      this.uncheckAllOptions();
+  _onTagRemoved(value) {
+    this.#updateValuesThroughUserInteraction(
+      this.values.filter((option) => option !== value)
+    );
+    this.#updateFilteredOptions();
+  }
+  /**
+   * @internal
+   */
+  _onTagKeydown(event) {
+    const tagIndex = parseInt(event.target.dataset.index);
+    switch (event.key) {
+      case "Backspace":
+      case "Delete":
+      case "Enter":
+      case " ": {
+        this._onTagRemoved(this.values[tagIndex]);
+        DOM.processUpdates();
+        this.#moveTagFocusTo(this.#nextTagIndexForRemoved(tagIndex));
+        break;
+      }
+      case "ArrowLeft":
+        this.#moveTagFocusTo(this.#nextTagIndexLeft(tagIndex) ?? tagIndex);
+        break;
+      case "ArrowRight":
+        this.#moveTagFocusTo(this.#nextTagIndexRight(tagIndex));
+        break;
     }
-    if (!this.open) {
-      return true;
+    return true;
+  }
+  #moveTagFocusTo(index) {
+    if (index === null) {
+      this._input.focus();
+    } else {
+      this.shadowRoot.querySelector(`[data-index="${index}"]`)?.focus();
     }
-    const focusTarget = e.relatedTarget;
-    if (this.isSameNode(focusTarget)) {
-      this.focus();
-      return;
+  }
+  #nextTagIndexLeft(index) {
+    if (!this.values.length) {
+      return null;
     }
-    if (!this.options.includes(focusTarget)) {
-      this.open = false;
-      if (this.indexWhenOpened !== this.selectedIndex) {
-        this.updateValue(true);
+    for (let i = index - 1; i >= 0; i--) {
+      if (!this._isTagDisabled(this.values[i])) {
+        return i;
       }
     }
+    return null;
+  }
+  #nextTagIndexRight(index) {
+    if (!this.values.length) {
+      return null;
+    }
+    for (let i = index + 1; i < this.values.length; i++) {
+      if (!this._isTagDisabled(this.values[i])) {
+        return i;
+      }
+    }
+    return null;
+  }
+  #nextTagIndexForRemoved(index) {
+    return this.#nextTagIndexRight(index - 1) ?? this.#nextTagIndexLeft(index);
   }
   /**
-   * Updates the value when an option's value changes.
-   *
-   * @param source - the source object
-   * @param propertyName - the property to evaluate
-   *
    * @internal
    */
-  handleChange(source, propertyName) {
-    super.handleChange(source, propertyName);
-    if (propertyName === "value") {
-      this.updateValue();
+  _onListboxClick(e) {
+    if (this.disabled) {
+      return;
+    }
+    const capturedOption = e.target.closest(
+      `option,[role=option]`
+    );
+    if (capturedOption && !capturedOption.disabled) {
+      this.#handleOptionInteraction(capturedOption);
     }
   }
   /**
-   * Prevents focus when a scrollbar is clicked.
-   *
-   * @param e - the mouse event object
-   *
    * @internal
    */
-  mousedownHandler(e) {
-    if (e.offsetX >= 0 && e.offsetX <= this.listbox.scrollWidth) {
-      return super.mousedownHandler(e);
-    }
-    return this.collapsible;
+  get _shouldShowClearButton() {
+    return this.clearable && this.values.length > 0;
   }
   /**
    * @internal
    */
-  multipleChanged(_, next) {
-    this.options.forEach((o) => {
-      o.checked = next ? false : void 0;
-    });
-    this.setSelectedOptions();
-    if (this.proxy) {
-      this.proxy.multiple = next;
-    }
+  _onClearButtonClick() {
+    this.#updateValuesThroughUserInteraction(
+      this.selectedOptions.filter((option) => option.disabled).map((option) => option.value)
+    );
   }
   /**
-   * Updates the selectedness of each option when the list of selected options changes.
-   *
-   * @param prev - the previous list of selected options
-   * @param next - the current list of selected options
-   *
    * @internal
    */
-  selectedOptionsChanged(prev, next) {
-    super.selectedOptionsChanged(prev, next);
-    this.options.forEach((o, i) => {
-      const proxyOption = this.proxy.options.item(i);
-      if (proxyOption) {
-        proxyOption.selected = o.selected;
+  maxSelectedChanged() {
+    this.#updateSelectionLimit();
+  }
+  #updateSelectionLimit() {
+    if (!this.multiple || typeof this.maxSelected !== "number" || this.maxSelected <= 0) {
+      return;
+    }
+    const options = this._slottedOptions.filter(
+      (option) => !this._slottedDisabledOptions.includes(option)
+    );
+    if (this.values.length >= this.maxSelected) {
+      const unselectedOptions = options.filter(
+        (option) => !this.selectedOptions.includes(option)
+      );
+      for (const option of unselectedOptions) {
+        option.disabled = true;
       }
-    });
+    } else {
+      for (const option of options) {
+        option.disabled = false;
+      }
+    }
+  }
+  #determineInitialValues() {
+    return this.initialValues.length ? this.initialValues : this.initialValue ? [this.initialValue] : [];
   }
   /**
-   * Resets and fills the proxy to match the component's options.
-   *
    * @internal
    */
-  setProxyOptions() {
-    if (this.proxy instanceof HTMLSelectElement && this.options) {
-      this.proxy.length = 0;
-      this.options.forEach((option) => {
-        const proxyOption = option.proxy || (option instanceof HTMLOptionElement ? option.cloneNode() : null);
-        if (proxyOption) {
-          this.proxy.options.add(proxyOption);
-        }
-      });
+  nameChanged(previous, next) {
+    super.nameChanged(previous, next);
+    this.#updateFormValue();
+  }
+  #updateFormValue() {
+    if (!this.name) {
+      this.setFormValue(null);
+    } else {
+      const formData = new FormData();
+      for (const value of this.values) {
+        formData.append(this.name, value);
+      }
+      this.setFormValue(formData);
     }
   }
   /**
-   * Handles keydown actions when the select is in multiple selection mode.
-   *
    * @internal
    */
-  multipleKeydownHandler(e) {
+  formResetCallback() {
+    super.formResetCallback();
+    this.#updateValuesThroughUserInteraction(this.#determineInitialValues());
+  }
+  #resizeObserver;
+  /**
+   * @internal
+   */
+  _onFieldsetClick(e) {
     if (this.disabled) {
       return;
     }
-    const { key, shiftKey } = e;
-    this.shouldSkipFocus = false;
-    switch (key) {
-      case keyHome: {
-        this.checkFirstOption(shiftKey);
-        return;
-      }
-      case keyArrowDown: {
-        this.checkNextOption(shiftKey);
-        return;
-      }
-      case keyArrowUp: {
-        this.checkPreviousOption(shiftKey);
-        return;
-      }
-      case keyEnd: {
-        this.checkLastOption(shiftKey);
-        return;
-      }
-      case keyTab: {
-        this.focusAndScrollOptionIntoView();
-        return;
-      }
-      case keyEscape: {
-        this.uncheckAllOptions();
-        this.checkActiveIndex();
-        return;
-      }
-      case keySpace: {
-        e.preventDefault();
-        if (this.typeaheadExpired) {
-          this.toggleSelectedForAllCheckedOptions();
-          return;
-        }
-      }
-      default: {
-        if (key.length === 1) {
-          this.handleTypeAhead(`${key}`);
-        }
-        return;
-      }
+    if (!e.defaultPrevented) {
+      this._input.focus();
+      this.open = true;
     }
   }
   /**
-   * Handle keyboard interaction for the select.
-   *
-   * @param e - the keyboard event
    * @internal
    */
-  keydownHandler(e) {
-    const selectedIndexBefore = this.selectedIndex;
-    if (this.multiple) {
-      this.multipleKeydownHandler(e);
-    } else {
-      super.keydownHandler(e);
-    }
-    const key = e.key;
-    switch (key) {
-      case keySpace: {
-        e.preventDefault();
-        if (this.collapsible && this.typeaheadExpired) {
-          this.open = !this.open;
-        }
-        break;
-      }
-      case keyHome:
-      case keyEnd: {
-        e.preventDefault();
-        break;
-      }
-      case keyEnter: {
-        e.preventDefault();
-        this.open = !this.open;
-        break;
-      }
-      case keyEscape: {
-        if (this.collapsible && this.open) {
-          e.preventDefault();
-          this.open = false;
-        }
-        break;
-      }
-      case keyTab: {
-        if (this.collapsible && this.open) {
-          e.preventDefault();
-          this.open = false;
-        }
-        return true;
-      }
-    }
-    if (this.collapsible && !this.open && this.selectedIndex !== selectedIndexBefore) {
-      this.updateValue(true);
+  _onChevronClick() {
+    if (this.open) {
+      this.open = false;
+      return false;
     }
-    return !(e.key === keyArrowDown || e.key === keyArrowUp);
+    return true;
   }
   connectedCallback() {
     super.connectedCallback();
-    this.addEventListener("focusout", this.focusoutHandler);
-    this.addEventListener("contentchange", this.updateDisplayValue);
+    if (!this.values.length) {
+      this.values = this.#determineInitialValues();
+    }
+    this.#resizeObserver.observe(this._contentArea);
   }
   disconnectedCallback() {
-    this.removeEventListener("focusout", this.focusoutHandler);
-    this.removeEventListener("contentchange", this.updateDisplayValue);
     super.disconnectedCallback();
+    this.#resizeObserver.disconnect();
   }
   /**
-   *
    * @internal
    */
-  updateDisplayValue() {
-    if (this.collapsible) {
-      Observable.notify(this, "displayValue");
-    }
-  }
-  labelChanged() {
-    if (!this.ariaLabel) {
-      this.ariaLabel = this.label;
-    }
-  }
-  get displayValue() {
-    Observable.track(this, "displayValue");
-    return this.firstSelectedOption?.getAttribute("label") ?? this.firstSelectedOption?.text ?? this.placeholder ?? "";
-  }
-  setDefaultSelectedOption() {
-    const options = Array.from(this.children).filter(
-      Listbox.slottedOptionFilter
-    );
-    const selectedIndex = options.findIndex(
-      (el) => el.hasAttribute("selected") || el.selected || el.value === this.value
-    );
-    if (selectedIndex === -1 && !this.placeholderOption) {
-      this.selectedIndex = 0;
-      return;
-    }
-    if (selectedIndex !== -1 || this.placeholder !== "") {
-      this.selectedIndex = selectedIndex;
-      return;
-    }
+  validate() {
+    super.validate(this._input ?? void 0);
   }
-  /*
+  /**
    * @internal
    */
-  slottedOptionsChanged(prev, next) {
-    this.options.forEach((o) => {
-      const notifier = Observable.getNotifier(o);
-      notifier.unsubscribe(this, "value");
-    });
-    super.slottedOptionsChanged(prev, next);
-    this.options.forEach((o) => {
-      const notifier = Observable.getNotifier(o);
-      notifier.subscribe(this, "value");
-    });
-    this.setProxyOptions();
-    this.updateValue();
-    const scale = this.getAttribute("scale") || this.scale;
-    next.forEach((element) => {
-      if (scale) {
-        element.setAttribute("scale", scale);
-        element.scale = scale;
-      }
-    });
-    this.proxy.value = this.value;
-    this.validate();
+  focus(options) {
+    this._input?.focus(options);
   }
-  formResetCallback() {
-    this.setProxyOptions();
-    super.setDefaultSelectedOption();
-    if (this.selectedIndex === -1) {
-      this.selectedIndex = 0;
-    }
-    if (this.placeholder) {
-      this.selectedIndex = -1;
+  /**
+   * @internal
+   */
+  _onMouseDown(event) {
+    const originalTarget = event.composedPath()[0];
+    if (!event.defaultPrevented && originalTarget !== this._input) {
+      this._input.focus();
+      return false;
     }
+    return true;
   }
-};
-__decorateClass([
+}
+__decorateClass$1([
+  attr
+], SearchableSelect.prototype, "appearance");
+__decorateClass$1([
+  attr
+], SearchableSelect.prototype, "shape");
+__decorateClass$1([
+  attr({ mode: "boolean", attribute: "fixed-dropdown" })
+], SearchableSelect.prototype, "fixedDropdown");
+__decorateClass$1([
+  attr
+], SearchableSelect.prototype, "placeholder");
+__decorateClass$1([
+  attr({ mode: "boolean" })
+], SearchableSelect.prototype, "open");
+__decorateClass$1([
+  attr({ mode: "boolean" })
+], SearchableSelect.prototype, "multiple");
+__decorateClass$1([
+  attr({ attribute: "external-tags", mode: "boolean" })
+], SearchableSelect.prototype, "externalTags");
+__decorateClass$1([
+  attr({ attribute: "max-lines", converter: nullableNumberConverter })
+], SearchableSelect.prototype, "maxLines");
+__decorateClass$1([
   observable
-], Select.prototype, "activeIndex", 2);
-// @ts-expect-error Type is incorrectly non-optional
-__decorateClass([
+], SearchableSelect.prototype, "values");
+__decorateClass$1([
+  observable
+], SearchableSelect.prototype, "initialValues");
+__decorateClass$1([
+  observable
+], SearchableSelect.prototype, "_input");
+__decorateClass$1([
+  observable
+], SearchableSelect.prototype, "_currentSearchText");
+__decorateClass$1([
+  observable
+], SearchableSelect.prototype, "_slottedOptions");
+__decorateClass$1([
+  observable
+], SearchableSelect.prototype, "optionFilter");
+__decorateClass$1([
+  observable
+], SearchableSelect.prototype, "_filteredOptions");
+__decorateClass$1([
+  observable
+], SearchableSelect.prototype, "_filteredEnabledOptions");
+__decorateClass$1([
+  attr({
+    mode: "boolean"
+  })
+], SearchableSelect.prototype, "loading");
+__decorateClass$1([
+  observable
+], SearchableSelect.prototype, "_highlightedOptionIndex");
+__decorateClass$1([
+  observable
+], SearchableSelect.prototype, "_contentArea");
+__decorateClass$1([
+  observable
+], SearchableSelect.prototype, "_numElidedTags");
+__decorateClass$1([
+  observable
+], SearchableSelect.prototype, "_tagRows");
+__decorateClass$1([
+  observable
+], SearchableSelect.prototype, "_lastTagRow");
+__decorateClass$1([
+  observable
+], SearchableSelect.prototype, "_listbox");
+__decorateClass$1([
   attr({ mode: "boolean" })
-], Select.prototype, "multiple", 2);
-__decorateClass([
-  attr({ attribute: "open", mode: "boolean" })
-], Select.prototype, "open", 2);
-__decorateClass([
-  volatile
-], Select.prototype, "collapsible", 1);
-__decorateClass([
+], SearchableSelect.prototype, "clearable");
+__decorateClass$1([
+  attr({ attribute: "max-selected", converter: nullableNumberConverter })
+], SearchableSelect.prototype, "maxSelected");
+__decorateClass$1([
   observable
-], Select.prototype, "control", 2);
-__decorateClass([
+], SearchableSelect.prototype, "_slottedDisabledOptions");
+__decorateClass$1([
   observable
-], Select.prototype, "maxHeight", 2);
-__decorateClass([
+], SearchableSelect.prototype, "_changeDescription");
+__decorateClass$1([
   observable
-], Select.prototype, "_anchor", 2);
-__decorateClass([
-  attr()
-], Select.prototype, "scale", 2);
-__decorateClass([
-  attr
-], Select.prototype, "appearance", 2);
+], SearchableSelect.prototype, "_anchor");
+
+var __defProp = Object.defineProperty;
+var __decorateClass = (decorators, target, key, kind) => {
+  var result = void 0 ;
+  for (var i = decorators.length - 1, decorator; i >= 0; i--)
+    if (decorator = decorators[i])
+      result = (decorator(target, key, result) ) || result;
+  if (result) __defProp(target, key, result);
+  return result;
+};
+class OptionTag extends Localized(VividElement) {
+  constructor() {
+    super(...arguments);
+    this.removable = false;
+    this.disabled = false;
+    this.hasIconPlaceholder = false;
+  }
+  _onClickRemove() {
+    this.$emit("remove", void 0, {
+      bubbles: false
+    });
+  }
+}
 __decorateClass([
   attr
-], Select.prototype, "shape", 2);
+], OptionTag.prototype, "shape");
 __decorateClass([
-  attr({ mode: "boolean", attribute: "fixed-dropdown" })
-], Select.prototype, "fixedDropdown", 2);
+  observable
+], OptionTag.prototype, "connotation");
 __decorateClass([
   attr
-], Select.prototype, "placeholder", 2);
+], OptionTag.prototype, "label");
 __decorateClass([
-  observable
-], Select.prototype, "placeholderOption", 2);
+  attr({ mode: "boolean" })
+], OptionTag.prototype, "removable");
 __decorateClass([
-  observable
-], Select.prototype, "_feedbackWrapper", 2);
+  attr({ mode: "boolean" })
+], OptionTag.prototype, "disabled");
 __decorateClass([
   observable
-], Select.prototype, "metaSlottedContent", 2);
-Select = __decorateClass([
-  errorText,
-  formElements
-], Select);
-applyMixinsWithObservables(
-  Select,
-  FormElementHelperText,
-  FormElementSuccessText
-);
+], OptionTag.prototype, "hasIconPlaceholder");
 
-const getStateClasses = ({
-  shape,
-  disabled,
-  appearance,
-  metaSlottedContent,
-  errorValidationMessage,
-  successText,
-  placeholder,
-  value,
-  scale
-}) => classNames(
-  ["disabled", disabled],
-  [`appearance-${appearance}`, Boolean(appearance)],
-  [`shape-${shape}`, Boolean(shape)],
-  ["has-meta", Boolean(metaSlottedContent?.length)],
-  ["error", Boolean(errorValidationMessage)],
-  ["success", !!successText],
-  ["shows-placeholder", Boolean(placeholder) && !value],
-  [`size-${scale}`, Boolean(scale)]
+const getStateClasses = (x) => classNames(
+  ["disabled", x.disabled],
+  [`appearance-${x.appearance}`, Boolean(x.appearance)],
+  [`shape-${x.shape}`, Boolean(x.shape)],
+  ["error", Boolean(x.errorValidationMessage)],
+  ["success", !!x.successText]
 );
 function renderLabel() {
-  return html` <label
-		for="${(x) => x.multiple ? null : "control"}"
-		class="label"
-		id="label"
-	>
-		${(x) => x.label}
-	</label>`;
+  return html`
+		<label for="control" class="label" id="label"> ${(x) => x.label} </label>
+	`;
 }
-function renderPlaceholder(context) {
-  const optionTag = context.tagFor(ListboxOption);
+function renderSelectionCount() {
   return html`
-		<${optionTag} ${ref("placeholderOption")}
-			text="${(x) => x.placeholder}" hidden disabled>
-		</${optionTag}>`;
+		<span
+			id="selection-count"
+			class="selection-count"
+			aria-label="${(x) => x.locale.searchableSelect.maxSelectedMessage(
+    x.values.length,
+    x.maxSelected
+  )}"
+			>(${(x) => `${x.values.length}/${x.maxSelected}`})</span
+		>
+	`;
 }
-function selectValue(context) {
+const tagTemplateFactory = (context, getComponent) => {
+  const optionTagTag = context.tagFor(OptionTag);
+  return html`
+		<div class="tag-wrapper">
+			<${optionTagTag}
+				class="tag"
+				tabindex="-1"
+				data-index="${(x, c) => getComponent(c).values.indexOf(x)}"
+				removable
+				:label="${(x, c) => getComponent(c)._tagLabelForValue(x)}"
+				:shape="${(_, c) => getComponent(c).shape}"
+				:connotation="${(x, c) => getComponent(c)._tagConnotationForValue(x)}"
+				?disabled="${(x, c) => getComponent(c)._isTagDisabled(x)}"
+				@remove="${(x, c) => getComponent(c)._onTagRemoved(x)}"
+				@keydown="${(_, c) => getComponent(c)._onTagKeydown(c.event)}"
+				@mousedown="${() => false}">
+				<slot slot="icon" name="${(x, c) => getComponent(c)._tagIconSlotName(x)}"></slot>
+			</${optionTagTag}>
+		</div>
+	`;
+};
+const elidedTagTemplateFactory = (context, getComponent) => {
+  const optionTagTag = context.tagFor(OptionTag);
+  return html`
+		<${optionTagTag}
+			class="tag"
+			tabindex="-1"
+			:label="${(x, c) => getComponent(x, c)._numElidedTags.toString()}"
+			:shape="${(x, c) => getComponent(x, c).shape}"
+			?disabled="${(x, c) => getComponent(x, c).disabled}"
+			@mousedown="${() => false}">
+		</${optionTagTag}>
+	`;
+};
+function renderFieldset(context) {
+  const buttonTag = context.tagFor(Button);
+  const progressRingTag = context.tagFor(ProgressRing);
   const affixIconTemplate = affixIconTemplateFactory(context);
   const chevronTemplate = chevronTemplateFactory(context);
-  return html` <div
-		class="control ${getStateClasses}"
-		${ref("_anchor")}
-		id="control"
-		?disabled="${(x) => x.disabled}"
-	>
-		<div class="selected-value">
+  const tagTemplate = tagTemplateFactory(context, (c) => c.parent);
+  const nestedTagTemplate = tagTemplateFactory(
+    context,
+    (c) => c.parentContext.parent
+  );
+  const elidedTagTemplate = elidedTagTemplateFactory(context, (x, _) => x);
+  const nestedElidedTagTemplate = elidedTagTemplateFactory(
+    context,
+    (_, c) => c.parent
+  );
+  return html`
+		<div
+			class="fieldset ${getStateClasses}"
+			@click="${(x, c) => x._onFieldsetClick(c.event)}"
+			${ref("_anchor")}
+		>
 			${(x) => affixIconTemplate(x.icon, IconWrapper.Slot)}
-			<span class="text">${(x) => x.displayValue}</span>
-			<slot name="meta" ${slotted("metaSlottedContent")}></slot>
+			<div class="content-area" ${ref("_contentArea")}>
+				${repeat(
+    (x) => x._tagRows,
+    html`
+						<div class="tag-row">
+							${when(
+      (_, c) => c.isFirst && c.parent._numElidedTags,
+      nestedElidedTagTemplate
+    )}
+							${repeat((x) => x, nestedTagTemplate)}
+						</div>
+					`,
+    { positioning: true }
+  )}
+				<div
+					class="tag-row ${(x) => classNames([
+    "contains-only-input",
+    x._tagRows.length > 0 && x._lastTagRow.length === 0
+  ])}"
+				>
+					${when(
+    (x) => x._tagRows.length === 0 && x._numElidedTags,
+    elidedTagTemplate
+  )}
+					${repeat((x) => x._lastTagRow, tagTemplate)}
+					<input
+						id="control"
+						class="control"
+						autocomplete="off"
+						aria-controls="listbox"
+						aria-describedby="${(x) => x._feedbackDescribedBy} ${(x) => x.multiple && x.maxSelected && x.maxSelected >= 1 ? "selection-count" : null}"
+						${delegateAria({
+    role: "combobox",
+    ariaAutoComplete: "list",
+    ariaHasPopup: "listbox",
+    ariaExpanded: (x) => x.open
+  })}
+						placeholder="${(x) => x.multiple && x.values.length ? "" : x.placeholder}"
+						type="text"
+						?disabled="${(x) => x.disabled}"
+						:value="${(x) => x._inputValue}"
+						@input="${(x, c) => {
+    x._onInputInput(c.event);
+    c.event.stopPropagation();
+  }}"
+						@change="${(_, c) => {
+    c.event.stopPropagation();
+  }}"
+						@focus="${(x, c) => x._onInputFocus(c.event)}"
+						@blur="${(x, c) => x._onInputBlur(c.event)}"
+						@keydown="${(x, c) => x._onInputKeydown(c.event)}"
+						${ref("_input")}
+					/>
+				</div>
+			</div>
+			<slot name="meta"></slot>
+			${when(
+    (x) => x._shouldShowClearButton,
+    html`<${buttonTag}
+					aria-label="${(x) => x.locale.searchableSelect.clearButtonLabel}"
+					@click="${(x) => x._onClearButtonClick()}"
+					@mousedown="${() => false}"
+					?disabled="${(x) => x.disabled}"
+					:shape="${(x) => x.shape}"
+					size="super-condensed"
+					icon="close-line"
+					appearance="ghost-light"
+					tabindex="-1"
+				></${buttonTag}>`
+  )}
+			<div @mousedown="${() => false}" @click="${(x) => x._onChevronClick()}">
+				${when(
+    (x) => x.loading,
+    html`<${progressRingTag} indeterminate size="-6"></${progressRingTag}>`
+  )}
+				${when((x) => !x.loading, chevronTemplate)}
+			</div>
 		</div>
-		${chevronTemplate}
-	</div>`;
+	`;
 }
 function setFixedDropdownVarWidth(x) {
-  return x.open && x.fixedDropdown ? `--_select-fixed-width: ${Math.round(x.getBoundingClientRect().width)}px` : null;
+  return x.open && x.fixedDropdown ? `--_searchable-select-fixed-width: ${Math.round(
+    x.getBoundingClientRect().width
+  )}px` : null;
 }
 function renderControl(context) {
   const popupTag = context.tagFor(Popup);
   return html`
-			${when((x) => x.label, renderLabel())}
-			<div class="control-wrapper">
-				${when((x) => !x.multiple, selectValue(context))}
-				<${popupTag} class="popup"
-					style="${setFixedDropdownVarWidth}"
-					?open="${(x) => x.collapsible ? x.open : true}"
+		${when(
+    (x) => x.label || x.multiple && x.maxSelected && x.maxSelected >= 1,
+    html`
+				<div>
+					${when((x) => x.label, renderLabel())}
+					${when(
+      (x) => x.multiple && x.maxSelected && x.maxSelected >= 1,
+      renderSelectionCount()
+    )}
+				</div>
+			`
+  )}
+		<span aria-live="assertive" aria-relevant="text" class="visually-hidden">
+			${(x) => x._changeDescription}
+		</span>
+		<div>
+			${renderFieldset(context)}
+			<div class="popup-wrapper">
+				<${popupTag}
 					:anchor="${(x) => x._anchor}"
+					:open="${(x) => x.open}"
+					class="popup"
 					placement="bottom-start"
-					strategy="${(x) => x.fixedDropdown ? null : "absolute"}">
-					<div class="listbox"
-						id="${(x) => x.listboxId}"
+					style="${setFixedDropdownVarWidth}"
+					strategy="${(x) => x.fixedDropdown ? "fixed" : "absolute"}">
+					<div
+						class="listbox"
 						role="listbox"
 						aria-multiselectable="${(x) => x.multiple}"
-						aria-label="${(x) => x.multiple && !x.label && x.ariaLabel ? x.ariaLabel : null}"
-						aria-labelledby="${(x) => x.multiple && x.label ? "label" : null}"
-						?disabled="${(x) => x.disabled}"
-						?hidden="${(x) => x.collapsible ? !x.open : false}"
-						${ref("listbox")}>
-						${when((x) => x.placeholder, renderPlaceholder(context))}
+						aria-required="${(x) => x.required}"
+						${ref("_listbox")}
+						@click="${(x, c) => x._onListboxClick(c.event)}"
+						@mousedown="${() => false}"
+					>
 						<slot
 							${slotted({
-    filter: Listbox.slottedOptionFilter,
+    filter: isListboxOption,
     flatten: true,
-    property: "slottedOptions"
+    property: "_slottedOptions"
   })}>
 						</slot>
-				 	</div>
+						${when(
+    (x) => x._filteredOptions.length === 0,
+    html`<div class="empty-message">
+								${when(
+      (x) => x.loading,
+      html`<slot name="loading-options">
+										${(x) => x.locale.searchableSelect.loadingOptionsMessage}
+									</slot>`
+    )}
+								${when(
+      (x) => !x.loading && x.searchText === "",
+      html`<slot name="no-options">
+										${(x) => x.locale.searchableSelect.noOptionsMessage}
+									</slot>`
+    )}
+								${when(
+      (x) => !x.loading && x.searchText !== "",
+      html`<slot name="no-matches">
+										${(x) => x.locale.searchableSelect.noMatchesMessage}
+									</slot>`
+    )}
+							</div>`
+  )}
+					</div>
 				</${popupTag}>
 			</div>
-		`;
-}
-function ifNotFromFeedback(handler) {
-  return (x, c) => {
-    if (!c.event.composedPath().includes(x._feedbackWrapper)) {
-      return handler(x, c.event);
-    }
-    return true;
-  };
+		</div>
+	`;
 }
-const SelectTemplate = (context) => {
+const SearchableSelectTemplate = (context) => {
+  const optionTagTag = context.tagFor(OptionTag);
   return html`
 		<template
-			class="base"
-			${applyHostSemantics({
-    role: "combobox",
-    ariaLabel: (x) => x.ariaLabel ?? x.label,
-    ariaHasPopup: (x) => x.collapsible ? "listbox" : "false",
-    ariaExpanded: (x) => x.open,
-    ariaDisabled: (x) => x.disabled
-  })}
-			aria-controls="${(x) => x.listboxId}"
-			aria-activedescendant="${(x) => x._activeDescendant}"
-			tabindex="${(x) => !x.disabled ? "0" : null}"
-			@click="${ifNotFromFeedback((x, e) => x.clickHandler(e))}"
-			@focusin="${ifNotFromFeedback((x, e) => x.focusinHandler(e))}"
-			@focusout="${ifNotFromFeedback(
-    (x, e) => x.focusoutHandler(e)
-  )}"
-			@keydown="${ifNotFromFeedback((x, e) => {
-    x.open && handleEscapeKeyAndStopPropogation(e);
-    return x.keydownHandler(e);
-  })}"
-			@mousedown="${ifNotFromFeedback(
-    (x, e) => x.mousedownHandler(e)
-  )}"
+			:_optionTagTagName="${() => optionTagTag}"
+			@mousedown="${(x, c) => x._onMouseDown(c.event)}"
 		>
-			${renderControl(context)}
-			<div class="feedback-wrapper" ${ref("_feedbackWrapper")}>
-				${getFeedbackTemplate(context)}
+			<div class="control-wrapper">
+				${renderControl(context)} ${(x) => x._getFeedbackTemplate(context)}
 			</div>
 		</template>
 	`;
 };
 
-const selectDefinition = defineVividComponent(
-  "select",
-  Select,
-  SelectTemplate,
-  [popupDefinition, iconDefinition, listboxOptionDefinition],
+const getClasses = ({ shape, connotation, disabled, removable }) => classNames(
+  "base",
+  ["disabled", disabled],
+  ["removable", removable],
+  [`shape-${shape}`, Boolean(shape)],
+  [`connotation-${connotation}`, Boolean(connotation)]
+);
+function renderRemoveButton(iconTag) {
+  return html`
+		<span
+			class="remove-button"
+			aria-label="${(x) => x.locale.searchableSelect.removeTagButtonLabel(x.label)}"
+			role="button"
+			tabindex="${(x) => x.disabled ? null : 0}"
+			@click="${(x) => x._onClickRemove()}"
+		>
+			<${iconTag} name="close-line"></${iconTag}>
+		</span>
+	`;
+}
+const optionTagTemplate = (context) => {
+  const iconTag = context.tagFor(Icon);
+  return html`<span class="${getClasses}" aria-disabled="${(x) => x.disabled}">
+		<slot name="icon" aria-hidden="true">
+			${when(
+    (x) => x.hasIconPlaceholder,
+    html`<div class="icon-placeholder"></div>`
+  )}
+		</slot>
+		${when(
+    (x) => x.label,
+    (x) => html`<span class="label">${x.label}</span>`
+  )}
+		${when((x) => x.removable, renderRemoveButton(iconTag))}
+	</span>`;
+};
+
+const optionTagDefinition = defineVividComponent(
+  "option-tag",
+  OptionTag,
+  optionTagTemplate,
+  [iconDefinition],
+  {
+    styles: [optionTagStyles],
+    shadowOptions: {
+      delegatesFocus: true
+    }
+  }
+);
+const searchableSelectDefinition = defineVividComponent(
+  "searchable-select",
+  SearchableSelect,
+  SearchableSelectTemplate,
+  [
+    buttonDefinition,
+    popupDefinition,
+    iconDefinition,
+    optionTagDefinition,
+    progressRingDefinition,
+    feedbackMessageDefinition
+  ],
   {
     styles
   }
 );
-const registerSelect = createRegisterFunction(selectDefinition);
+const registerSearchableSelect = createRegisterFunction(
+  searchableSelectDefinition
+);
 
-export { Select as S, registerSelect as r, selectDefinition as s };
+export { SearchableSelect as S, registerSearchableSelect as r };