@vonage/vivid 4.23.0 → 4.25.0

package/shared/definition46.cjs

@@ -1,160 +1,895 @@
 'use strict';
 
-const definition = require('./definition15.cjs');
-const definition$1 = require('./definition41.cjs');
+const definition = require('./definition67.cjs');
+const definition$2 = require('./definition28.cjs');
+const definition$3 = require('./definition37.cjs');
 const vividElement = require('./vivid-element.cjs');
-const delegatesAria = require('./delegates-aria.cjs');
-const enums = require('./enums.cjs');
-const classNames = require('./class-names.cjs');
+const mixins = require('./mixins.cjs');
+const listbox = require('./listbox.cjs');
+const hostSemantics = require('./host-semantics.cjs');
+const formAssociated = require('./form-associated.cjs');
+const numbers = require('./numbers.cjs');
+const withErrorText = require('./with-error-text.cjs');
+const withSuccessText = require('./with-success-text.cjs');
+const formElement = require('./form-element.cjs');
+const affix = require('./affix.cjs');
+const strings = require('./strings.cjs');
+const keyCodes = require('./key-codes.cjs');
+const option = require('./option.cjs');
+const definition$1 = require('./definition11.cjs');
+const index = require('./index.cjs');
+const ref = require('./ref.cjs');
 const when = require('./when.cjs');
+const slotted = require('./slotted.cjs');
+const classNames = require('./class-names.cjs');
 
-const styles = ":host{display:flex}.base.connotation-cta{--_connotation-color-firm-all: var(--vvd-selectable-box-cta-firm-all, var(--vvd-color-cta-600));--_connotation-color-pale: var(--vvd-selectable-box-cta-pale, var(--vvd-color-cta-300));--_connotation-color-fierce: var(--vvd-selectable-box-cta-fierce, var(--vvd-color-cta-700));--_connotation-color-faint: var(--vvd-selectable-box-cta-faint, var(--vvd-color-cta-50));--_connotation-color-soft: var(--vvd-selectable-box-cta-soft, var(--vvd-color-cta-100))}.base:not(.connotation-cta){--_connotation-color-firm-all: var(--vvd-selectable-box-accent-firm-all, var(--vvd-color-neutral-600));--_connotation-color-pale: var(--vvd-selectable-box-accent-pale, var(--vvd-color-neutral-300));--_connotation-color-fierce: var(--vvd-selectable-box-accent-fierce, var(--vvd-color-neutral-700));--_connotation-color-faint: var(--vvd-selectable-box-accent-faint, var(--vvd-color-neutral-50));--_connotation-color-soft: var(--vvd-selectable-box-accent-soft, var(--vvd-color-neutral-100))}.base{--_appearance-color-text: var(--_connotation-color-firm-all);--_appearance-color-fill: transparent;--_appearance-color-outline: var(--_connotation-color-pale)}.base:where(.hover,:hover):where(:not(.disabled,:disabled,.readonly)){--_appearance-color-text: var(--_connotation-color-firm-all);--_appearance-color-fill: transparent;--_appearance-color-outline: var(--_connotation-color-firm-all)}.base:where(.selected):where(:not(.disabled,:disabled)){--_appearance-color-text: var(--_connotation-color-firm-all);--_appearance-color-fill: var(--_connotation-color-soft);--_appearance-color-outline: var(--_connotation-color-pale)}.base:where(.selected):where(.hover,:hover):where(:not(.disabled,:disabled,.readonly)){--_appearance-color-text: var(--_connotation-color-firm-all);--_appearance-color-fill: var(--_connotation-color-faint);--_appearance-color-outline: var(--_connotation-color-firm-all)}.base{position:relative;padding:var(--selectable-box-spacing, 16px);border:1px solid var(--_appearance-color-outline);border-radius:8px;background-color:var(--_appearance-color-fill);inline-size:100%;padding-block-start:calc(var(--selectable-box-spacing, 16px) + 36px);text-align:start}.base:focus-visible{--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))}.base.tight{overflow:hidden;min-height:calc(var(--selectable-box-spacing, 16px) * 2 + 22px);padding:0}.base.clickable{cursor:pointer}.control{position:absolute;inset-block-start:var(--selectable-box-spacing, 16px);inset-inline-end:var(--selectable-box-spacing, 16px)}";
+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)}: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}";
 
 var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __decorateClass = (decorators, target, key, kind) => {
-  var result = void 0 ;
+  var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
   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);
+      result = (kind ? decorator(target, key, result) : decorator(result)) || result;
+  if (kind && result) __defProp(target, key, result);
   return result;
 };
-class SelectableBox extends delegatesAria.DelegatesAria(vividElement.VividElement) {
+class Select extends mixins.WithLightDOMFeedback(
+  withErrorText.WithErrorText(
+    withSuccessText.WithSuccessText(
+      formElement.FormElement(hostSemantics.HostSemantics(affix.AffixIconWithTrailing(formAssociated.FormAssociated(listbox.Listbox))))
+    )
+  )
+) {
   constructor() {
     super(...arguments);
-    this.checked = false;
-    this.clickable = false;
-    this.clickableBox = false;
-    this.tight = false;
+    /**
+     * @internal
+     */
+    this.proxy = document.createElement("select");
+    this.activeIndex = -1;
+    /**
+     * The start index when checking a range of options.
+     *
+     * @internal
+     */
+    this.rangeStartIndex = -1;
+    this.open = false;
+    /**
+     * The unique id for the internal listbox element.
+     *
+     * @internal
+     */
+    this.listboxId = strings.uniqueId("listbox-");
+    this.maxHeight = 0;
+    this.fixedDropdown = false;
+    this.placeholderOption = null;
+    this._feedbackWrapper = null;
+  }
+  /**
+   * Returns the last checked option.
+   *
+   * @internal
+   */
+  get activeOption() {
+    return this.options[this.activeIndex];
+  }
+  /**
+   * Returns the list of checked options.
+   *
+   * @internal
+   */
+  get checkedOptions() {
+    return this.options.filter((o) => o.checked);
+  }
+  /**
+   * Returns the index of the first selected option.
+   *
+   * @internal
+   */
+  get firstSelectedOptionIndex() {
+    return this.options.indexOf(this.firstSelectedOption);
+  }
+  /**
+   * Updates the `ariaActiveDescendant` property when the active index changes.
+   *
+   * @internal
+   */
+  activeIndexChanged(_, next) {
+    this._activeDescendant = this.options[next]?.id ?? "";
+    this.focusAndScrollOptionIntoView();
+  }
+  /**
+   * 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;
+    }
   }
   /**
+   * 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
    */
-  _handleCheckedChange() {
-    if (this.controlType === "radio" && this.checked) return;
-    this.checked = !this.checked;
-    if (this.clickableBox || this.clickable) this.$emit("change");
+  checkFirstOption(preserveChecked) {
+    if (preserveChecked) {
+      if (this.rangeStartIndex === -1) {
+        this.rangeStartIndex = this.activeIndex + 1;
+      }
+      this.options.forEach((o, i) => {
+        o.checked = numbers.inRange(i, this.rangeStartIndex);
+      });
+    } else {
+      this.uncheckAllOptions();
+    }
+    this.activeIndex = 0;
+    this.checkActiveIndex();
+  }
+  /**
+   * 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 = numbers.inRange(i, this.rangeStartIndex, this.length);
+      });
+    } else {
+      this.uncheckAllOptions();
+    }
+    this.activeIndex = this.length - 1;
+    this.checkActiveIndex();
   }
   /**
+   * 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
    */
-  _handleKeydown(event) {
-    if ((event.code === "Space" || event.code === "Enter") && (this.clickableBox || this.clickable))
-      return this._handleCheckedChange();
+  checkNextOption(preserveChecked) {
+    if (preserveChecked) {
+      if (this.rangeStartIndex === -1) {
+        this.rangeStartIndex = this.activeIndex;
+      }
+      this.options.forEach((o, i) => {
+        o.checked = numbers.inRange(i, this.rangeStartIndex, this.activeIndex + 1);
+      });
+    } else {
+      this.uncheckAllOptions();
+    }
+    this.activeIndex += this.activeIndex < this.length - 1 ? 1 : 0;
+    this.checkActiveIndex();
+  }
+  /**
+   * 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 = numbers.inRange(i, this.activeIndex, this.rangeStartIndex);
+      });
+    } else {
+      this.uncheckAllOptions();
+    }
+    this.activeIndex -= this.activeIndex > 0 ? 1 : 0;
+    this.checkActiveIndex();
+  }
+  /**
+   * @internal
+   */
+  focusAndScrollOptionIntoView() {
+    super.focusAndScrollOptionIntoView(this.activeOption);
+  }
+  /**
+   * 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;
+  }
+  /**
+   * Sets an option as selected and gives it focus.
+   *
+   * @public
+   */
+  setSelectedOptions() {
+    if (!this.multiple) {
+      super.setSelectedOptions();
+      return;
+    }
+    if (this.$fastController.isConnected && this.options) {
+      this.selectedOptions = this.options.filter((o) => o.selected);
+      this.focusAndScrollOptionIntoView();
+    }
+  }
+  /**
+   * 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);
+  }
+  /**
+   * @internal
+   */
+  typeaheadBufferChanged(prev, next) {
+    if (!this.multiple) {
+      super.typeaheadBufferChanged(prev, next);
+      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.typeaheadExpired = false;
+    }
+  }
+  /**
+   * 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;
+    }
+  }
+  /**
+   * Sets focus when the open property changes.
+   *
+   * @internal
+   */
+  openChanged(prev, next) {
+    if (!this.collapsible) {
+      return;
+    }
+    if (this.open) {
+      this.focusAndScrollOptionIntoView();
+      this.indexWhenOpened = this.selectedIndex;
+      vividElement.DOM.queueUpdate(() => this.focus());
+      return;
+    }
+    const didClose = prev === true && next === false;
+    const selectionChangedWhileOpen = this.indexWhenOpened !== this.selectedIndex;
+    if (didClose && selectionChangedWhileOpen) {
+      this.updateValue(true);
+    }
+  }
+  get collapsible() {
+    return !this.multiple;
+  }
+  /**
+   * @internal
+   */
+  valueChanged(prev, next) {
+    let nextValue = next;
+    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) {
+        nextValue = "";
+        this.selectedIndex = selectedIndex;
+      }
+      nextValue = this.firstSelectedOption?.value ?? nextValue;
+    }
+    if (next !== nextValue) {
+      this.value = nextValue;
+      return;
+    }
+    super.valueChanged(prev, next);
+    this.updateDisplayValue();
+  }
+  /**
+   * 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
+      });
+    }
+  }
+  /**
+   * 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();
+  }
+  /**
+   * Handle opening and closing the listbox when the select is clicked.
+   *
+   * @param e - the mouse event
+   * @internal
+   */
+  clickHandler(e) {
+    if (this.disabled) {
+      return;
+    }
+    const clickedOption = e.target.closest(
+      `option,[role=option]`
+    );
+    if (clickedOption && clickedOption.disabled) {
+      return;
+    }
+    if (this.multiple) {
+      this.uncheckAllOptions();
+      this.activeIndex = this.options.indexOf(clickedOption);
+      this.checkActiveIndex();
+      this.toggleSelectedForAllCheckedOptions();
+    } else {
+      super.clickHandler(e);
+    }
+    if (this.collapsible) {
+      this.open = !this.open;
+    }
     return true;
   }
+  /**
+   * Handles focus state when the element or its children lose focus.
+   *
+   * @param e - The focus event
+   * @internal
+   */
+  focusoutHandler(e) {
+    if (this.multiple) {
+      this.uncheckAllOptions();
+    }
+    if (!this.open) {
+      return true;
+    }
+    const focusTarget = e.relatedTarget;
+    if (this.isSameNode(focusTarget)) {
+      this.focus();
+      return;
+    }
+    if (!this.options.includes(focusTarget)) {
+      this.open = false;
+      if (this.indexWhenOpened !== this.selectedIndex) {
+        this.updateValue(true);
+      }
+    }
+  }
+  /**
+   * 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();
+    }
+  }
+  /**
+   * 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;
+  }
+  /**
+   * @internal
+   */
+  multipleChanged(_, next) {
+    this.options.forEach((o) => {
+      o.checked = next ? false : void 0;
+    });
+    this.setSelectedOptions();
+    if (this.proxy) {
+      this.proxy.multiple = next;
+    }
+  }
+  /**
+   * 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;
+      }
+    });
+  }
+  /**
+   * 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);
+        }
+      });
+    }
+  }
+  /**
+   * Handles keydown actions when the select is in multiple selection mode.
+   *
+   * @internal
+   */
+  multipleKeydownHandler(e) {
+    if (this.disabled) {
+      return;
+    }
+    const { key, shiftKey } = e;
+    this.shouldSkipFocus = false;
+    switch (key) {
+      case keyCodes.keyHome: {
+        this.checkFirstOption(shiftKey);
+        return;
+      }
+      case keyCodes.keyArrowDown: {
+        this.checkNextOption(shiftKey);
+        return;
+      }
+      case keyCodes.keyArrowUp: {
+        this.checkPreviousOption(shiftKey);
+        return;
+      }
+      case keyCodes.keyEnd: {
+        this.checkLastOption(shiftKey);
+        return;
+      }
+      case keyCodes.keyTab: {
+        this.focusAndScrollOptionIntoView();
+        return;
+      }
+      case keyCodes.keyEscape: {
+        this.uncheckAllOptions();
+        this.checkActiveIndex();
+        return;
+      }
+      case keyCodes.keySpace: {
+        e.preventDefault();
+        if (this.typeaheadExpired) {
+          this.toggleSelectedForAllCheckedOptions();
+          return;
+        }
+      }
+      default: {
+        if (key.length === 1) {
+          this.handleTypeAhead(`${key}`);
+        }
+        return;
+      }
+    }
+  }
+  /**
+   * 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 keyCodes.keySpace: {
+        e.preventDefault();
+        if (this.collapsible && this.typeaheadExpired) {
+          this.open = !this.open;
+        }
+        break;
+      }
+      case keyCodes.keyHome:
+      case keyCodes.keyEnd: {
+        e.preventDefault();
+        break;
+      }
+      case keyCodes.keyEnter: {
+        e.preventDefault();
+        this.open = !this.open;
+        break;
+      }
+      case keyCodes.keyEscape: {
+        if (this.collapsible && this.open) {
+          e.preventDefault();
+          this.open = false;
+        }
+        break;
+      }
+      case keyCodes.keyTab: {
+        if (this.collapsible && this.open) {
+          e.preventDefault();
+          this.open = false;
+        }
+        return true;
+      }
+    }
+    if (this.collapsible && !this.open && this.selectedIndex !== selectedIndexBefore) {
+      this.updateValue(true);
+    }
+    return !(e.key === keyCodes.keyArrowDown || e.key === keyCodes.keyArrowUp);
+  }
+  connectedCallback() {
+    super.connectedCallback();
+    this.addEventListener("focusout", this.focusoutHandler);
+    this.addEventListener("contentchange", this.updateDisplayValue);
+  }
+  disconnectedCallback() {
+    this.removeEventListener("focusout", this.focusoutHandler);
+    this.removeEventListener("contentchange", this.updateDisplayValue);
+    super.disconnectedCallback();
+  }
+  /**
+   *
+   * @internal
+   */
+  updateDisplayValue() {
+    if (this.collapsible) {
+      vividElement.Observable.notify(this, "displayValue");
+    }
+  }
+  get displayValue() {
+    vividElement.Observable.track(this, "displayValue");
+    return this.firstSelectedOption?.getAttribute("label") ?? this.firstSelectedOption?.text ?? this.placeholder ?? "";
+  }
+  setDefaultSelectedOption() {
+    const options = Array.from(this.children).filter(
+      listbox.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;
+    }
+  }
+  /*
+   * @internal
+   */
+  slottedOptionsChanged(prev, next) {
+    this.options.forEach((o) => {
+      const notifier = vividElement.Observable.getNotifier(o);
+      notifier.unsubscribe(this, "value");
+    });
+    super.slottedOptionsChanged(prev, next);
+    this.options.forEach((o) => {
+      const notifier = vividElement.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();
+  }
+  formResetCallback() {
+    this.setProxyOptions();
+    super.setDefaultSelectedOption();
+    if (this.selectedIndex === -1) {
+      this.selectedIndex = 0;
+    }
+    if (this.placeholder) {
+      this.selectedIndex = -1;
+    }
+  }
 }
 __decorateClass([
-  vividElement.attr({ mode: "boolean" })
-], SelectableBox.prototype, "checked");
+  vividElement.observable
+], Select.prototype, "activeIndex", 2);
+// @ts-expect-error Type is incorrectly non-optional
 __decorateClass([
   vividElement.attr({ mode: "boolean" })
-], SelectableBox.prototype, "clickable");
+], Select.prototype, "multiple", 2);
+__decorateClass([
+  vividElement.attr({ attribute: "open", mode: "boolean" })
+], Select.prototype, "open", 2);
+__decorateClass([
+  vividElement.volatile
+], Select.prototype, "collapsible", 1);
+__decorateClass([
+  vividElement.observable
+], Select.prototype, "control", 2);
+__decorateClass([
+  vividElement.observable
+], Select.prototype, "maxHeight", 2);
+__decorateClass([
+  vividElement.observable
+], Select.prototype, "_anchor", 2);
 __decorateClass([
-  vividElement.attr({ attribute: "clickable-box", mode: "boolean" })
-], SelectableBox.prototype, "clickableBox");
+  vividElement.attr()
+], Select.prototype, "scale", 2);
 __decorateClass([
   vividElement.attr
-], SelectableBox.prototype, "connotation");
+], Select.prototype, "appearance", 2);
 __decorateClass([
-  vividElement.attr({ attribute: "control-type" })
-], SelectableBox.prototype, "controlType");
+  vividElement.attr
+], Select.prototype, "shape", 2);
 __decorateClass([
-  vividElement.attr({ mode: "boolean" })
-], SelectableBox.prototype, "tight");
+  vividElement.attr({ mode: "boolean", attribute: "fixed-dropdown" })
+], Select.prototype, "fixedDropdown", 2);
+__decorateClass([
+  vividElement.attr
+], Select.prototype, "placeholder", 2);
+__decorateClass([
+  vividElement.observable
+], Select.prototype, "placeholderOption", 2);
+__decorateClass([
+  vividElement.observable
+], Select.prototype, "_feedbackWrapper", 2);
+__decorateClass([
+  vividElement.observable
+], Select.prototype, "metaSlottedContent", 2);
 
-const getClasses = ({
-  connotation,
-  tight,
-  checked,
-  clickableBox,
-  clickable
+const getStateClasses = ({
+  shape,
+  disabled,
+  appearance,
+  metaSlottedContent,
+  errorValidationMessage,
+  successText,
+  placeholder,
+  value,
+  scale
 }) => classNames.classNames(
-  "base",
-  [`connotation-${connotation}`, Boolean(connotation)],
-  ["tight", tight],
-  ["selected", checked],
-  ["clickable", clickableBox || clickable],
-  ["readonly", !clickableBox && !clickable]
+  ["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)]
 );
-function handleControlChange(x) {
-  if (!x.clickableBox) x._handleCheckedChange();
+function renderLabel() {
+  return vividElement.html` <label
+		for="${(x) => x.multiple ? null : "control"}"
+		class="label"
+		id="label"
+	>
+		${(x) => x.label}
+	</label>`;
+}
+function renderPlaceholder(context) {
+  const optionTag = context.tagFor(option.ListboxOption);
+  return vividElement.html`
+		<${optionTag} ${ref.ref("placeholderOption")}
+			text="${(x) => x.placeholder}" hidden disabled>
+		</${optionTag}>`;
 }
-function checkbox(context) {
-  const checkboxTag = context.tagFor(definition.Checkbox);
-  return vividElement.html`${when.when(
-    (x) => x.controlType !== "radio",
-    vividElement.html`
-		<${checkboxTag}
-			${delegatesAria.delegateAria(
-      {
-        ariaLabel: (x) => !x.clickableBox && !x.clickable && x.ariaLabel ? x.ariaLabel : null
-      },
-      { onlySpecified: true }
-    )}
-			@change="${(x) => handleControlChange(x)}"
-			class="control checkbox"
-			connotation="${(x) => x.connotation === "cta" ? enums.Connotation.CTA : enums.Connotation.Accent}"
-			:checked="${(x) => x.checked}"
-			inert="${(x) => x.clickableBox || x.clickable ? true : null}"
-		></${checkboxTag}>`
-  )} `;
+function selectValue(context) {
+  const affixIconTemplate = affix.affixIconTemplateFactory(context);
+  const chevronTemplate = definition$1.chevronTemplateFactory(context);
+  return vividElement.html` <div
+		class="control ${getStateClasses}"
+		${ref.ref("_anchor")}
+		id="control"
+		?disabled="${(x) => x.disabled}"
+	>
+		<div class="selected-value">
+			${(x) => affixIconTemplate(x.icon, affix.IconWrapper.Slot)}
+			<span class="text">${(x) => x.displayValue}</span>
+			<slot name="meta" ${slotted.slotted("metaSlottedContent")}></slot>
+		</div>
+		${chevronTemplate}
+	</div>`;
+}
+function setFixedDropdownVarWidth(x) {
+  return x.open && x.fixedDropdown ? `--_select-fixed-width: ${Math.round(x.getBoundingClientRect().width)}px` : null;
 }
-function radio(context) {
-  const radioTag = context.tagFor(definition$1.Radio);
-  return vividElement.html`${when.when(
-    (x) => x.controlType === "radio",
-    vividElement.html`
-		<${radioTag}
-			${delegatesAria.delegateAria(
-      {
-        ariaLabel: (x) => !x.clickableBox && !x.clickable && x.ariaLabel ? x.ariaLabel : null
-      },
-      { onlySpecified: true }
-    )}
-			@change="${(x) => handleControlChange(x)}"
-			class="control radio"
-			connotation="${(x) => x.connotation === "cta" ? enums.Connotation.CTA : enums.Connotation.Accent}"
-			:checked="${(x) => x.checked}"
-			inert="${(x) => x.clickableBox || x.clickable ? true : null}"
-		></${radioTag}>`
-  )} `;
+function renderControl(context) {
+  const popupTag = context.tagFor(definition.Popup);
+  return vividElement.html`
+			${when.when((x) => x.label, renderLabel())}
+			<div class="control-wrapper">
+				${when.when((x) => !x.multiple, selectValue(context))}
+				<${popupTag} class="popup"
+					style="${setFixedDropdownVarWidth}"
+					?open="${(x) => x.collapsible ? x.open : true}"
+					:anchor="${(x) => x._anchor}"
+					placement="bottom-start"
+					strategy="${(x) => x.fixedDropdown ? null : "absolute"}">
+					<div class="listbox"
+						id="${(x) => x.listboxId}"
+						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.ref("listbox")}>
+						${when.when((x) => x.placeholder, renderPlaceholder(context))}
+						<slot
+							${slotted.slotted({
+    filter: listbox.Listbox.slottedOptionFilter,
+    flatten: true,
+    property: "slottedOptions"
+  })}>
+						</slot>
+				 	</div>
+				</${popupTag}>
+			</div>
+		`;
 }
-const SelectableBoxTemplate = (context) => {
-  return vividElement.html`<template>
-		<div
-			class="${getClasses}"
-			tabindex="${(x) => x.clickableBox || x.clickable ? "0" : null}"
-			${delegatesAria.delegateAria({
-    role: (x) => x.clickableBox || x.clickable ? "button" : null,
-    ariaPressed: (x) => x.clickableBox || x.clickable ? x.checked ? "true" : "false" : null,
-    ariaLabel: (x) => x.clickableBox || x.clickable ? x.ariaLabel : null
+function ifNotFromFeedback(handler) {
+  return (x, c) => {
+    if (!c.event.composedPath().includes(x._feedbackWrapper)) {
+      return handler(x, c.event);
+    }
+    return true;
+  };
+}
+const SelectTemplate = (context) => {
+  return vividElement.html`
+		<template
+			class="base"
+			${hostSemantics.applyHostSemantics({
+    role: "combobox",
+    ariaLabel: (x) => x.ariaLabel ?? x.label,
+    ariaHasPopup: (x) => x.collapsible ? "listbox" : "false",
+    ariaExpanded: (x) => x.open,
+    ariaDisabled: (x) => x.disabled
   })}
-			@keydown="${(x, c) => x._handleKeydown(c.event)}"
-			@click="${(x) => x.clickableBox || x.clickable ? x._handleCheckedChange() : null}"
+			aria-controls="${(x) => x.listboxId}"
+			aria-activedescendant="${(x) => x._activeDescendant}"
+			aria-describedby="${(x) => x._feedbackDescribedBy}"
+			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 && index.handleEscapeKeyAndStopPropogation(e);
+    return x.keydownHandler(e);
+  })}"
+			@mousedown="${ifNotFromFeedback(
+    (x, e) => x.mousedownHandler(e)
+  )}"
 		>
-			${checkbox(context)} ${radio(context)}
-			<slot></slot>
-		</div>
-	</template>`;
+			${renderControl(context)}
+			<div class="feedback-wrapper" ${ref.ref("_feedbackWrapper")}>
+				${(x) => x._getFeedbackTemplate(context)}
+			</div>
+		</template>
+	`;
 };
 
-const selectableBoxDefinition = vividElement.defineVividComponent(
-  "selectable-box",
-  SelectableBox,
-  SelectableBoxTemplate,
-  [definition.checkboxDefinition, definition$1.radioDefinition],
+const selectDefinition = vividElement.defineVividComponent(
+  "select",
+  Select,
+  SelectTemplate,
+  [
+    definition.popupDefinition,
+    definition$2.iconDefinition,
+    definition$3.listboxOptionDefinition,
+    mixins.feedbackMessageDefinition
+  ],
   {
-    styles,
-    shadowOptions: {
-      delegatesFocus: true
-    }
+    styles
   }
 );
-const registerSelectableBox = vividElement.createRegisterFunction(
-  selectableBoxDefinition
-);
+const registerSelect = vividElement.createRegisterFunction(selectDefinition);
 
-exports.SelectableBox = SelectableBox;
-exports.registerSelectableBox = registerSelectableBox;
-exports.selectableBoxDefinition = selectableBoxDefinition;
+exports.Select = Select;
+exports.registerSelect = registerSelect;
+exports.selectDefinition = selectDefinition;