@vonage/vivid 5.25.0 → 5.27.0

package/unbundled/definition64.js

@@ -1,123 +1,810 @@
-import { d as createRegisterFunction, t as VividElement, u as defineVividComponent } from "./vivid-element.js";
+import { d as createRegisterFunction, u as defineVividComponent } from "./vivid-element.js";
+import { t as iconDefinition } from "./definition.js";
 import { t as __decorate } from "./decorate.js";
-import { c as impl, n as removeSymbol, s as sortedContributions, t as dispatchSlottableRequest } from "./slottable-request.js";
-import { ElementStyles, html, observable, ref } from "@microsoft/fast-element";
-import { DOMSerializer, Mark, Node } from "prosemirror-model";
-//#region src/lib/rich-text-view/rich-text-view.scss?inline
-var rich_text_view_default = ":host{display:contents}.content{overflow-wrap:break-word;white-space:break-spaces;display:contents}";
+import { a as affixIconTemplateFactory, i as IconWrapper, n as AffixIconWithTrailing } from "./affix.js";
+import { t as componentEnum } from "./component-enum.js";
+import { n as FormAssociated } from "./form-associated.js";
+import { t as Localized } from "./localized.js";
+import { i as Button, r as chevronTemplateFactory, t as buttonDefinition } from "./definition6.js";
+import { t as handleEscapeKeyAndStopPropogation } from "./dialog.js";
+import { i as Popup, t as popupDefinition } from "./definition9.js";
+import { n as applyHostSemantics, t as HostSemantics } from "./host-semantics.js";
+import { n as feedbackMessageDefinition } from "./feedback-message.js";
+import { t as FormElement } from "./form-element.js";
+import { t as WithErrorText } from "./with-error-text.js";
+import { t as WithSuccessText } from "./with-success-text.js";
+import { n as WithLightDOMFeedback } from "./mixins.js";
+import { t as WithContextualHelp } from "./with-contextual-help.js";
+import { t as ListboxOption } from "./option.js";
+import { t as listboxOptionDefinition } from "./definition29.js";
+import { t as optgroupDefinition } from "./definition30.js";
+import { t as Listbox } from "./listbox.js";
+import { Observable, Updates, attr, html, observable, ref, slotted, volatile, when } from "@microsoft/fast-element";
+import { classNames, inRange, keyArrowDown, keyArrowUp, keyEnd, keyEnter, keyEscape, keyHome, keySpace, keyTab, uniqueId } from "@microsoft/fast-web-utilities";
+//#region src/lib/select/select.scss?inline
+var select_default = ".label-wrapper{align-items:center;gap:var(--label-wrapper-gap,4px);flex-direction:row;display:flex}.label-wrapper[hidden]{display:none}.label:not(slot),.label::slotted(label){flex:0 auto}.chevron{font:var(--vvd-typography-base-extended);flex-shrink:0;display:flex;transform:rotate(0)}@media (prefers-reduced-motion:no-preference){.chevron{transition:transform .2s}}:host([data-expanded=true]) .chevron,:host([open]) .chevron{transform:rotate(180deg)}:host(:focus-visible){outline:none}:host{--_low-ink-color:var(--vvd-color-neutral-600);--focus-stroke-gap-color:transparent;flex-direction:column;gap:4px;display:inline-flex}:host([disabled]){--_low-ink-color:var(--vvd-color-neutral-600);cursor:not-allowed}.label{color:var(--vvd-color-canvas-text);font:var(--vvd-typography-base)}.control{border-radius:var(--_select-control-border-radius);block-size:var(--_select-block-size);padding-inline:var(--_select-padding-inline);--_select-icon-size:calc(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(calc(1px * (40 + 4 * clamp(-1, var(--vvd-size-density,0), 2))) / 2.5);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);justify-content:space-between;align-items:center;gap:8px;transition:box-shadow .2s,background-color .2s;display:flex}.control.size-condensed{--_select-icon-size:calc(calc(1px * (40 + 4 * clamp(-1, var(--vvd-size-density,0), 2))) / 2.5);--_select-block-size:calc(1px * (40 + 4 * clamp(-1, var(--vvd-size-density,0), 2) - 8));--_select-padding-inline:calc(calc(1px * (40 + 4 * clamp(-1, var(--vvd-size-density,0), 2) - 16)) / 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}.listbox{max-height:var(--select-height,408px);flex-direction:column;gap:2px;padding:4px;display:flex;overflow-y:auto}:host([multiple]:focus-visible) .listbox{box-shadow:0 0 0 4px color-mix(in sRGB, var(--focus-stroke-color,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{white-space:nowrap;flex-grow:1;align-items:center;column-gap:12px;display:flex;overflow:hidden}.selected-value .text{text-overflow:ellipsis;max-inline-size:100%;overflow:hidden}.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}@supports selector(:has(*)){:host(:focus-within) .control:not(.has-activedescendant,:has(.clear-button:focus)){--focus-stroke-gap-color:transparent;box-shadow:0 0 0 4px color-mix(in sRGB, var(--focus-stroke-color,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))}}@supports not selector(:has(*)){:host(:focus-within) .control:not(.has-activedescendant){--focus-stroke-gap-color:transparent;box-shadow:0 0 0 4px color-mix(in sRGB, var(--focus-stroke-color,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))}}:host(:not(:focus-visible)){--_suppressable-focus-shadow:none;--_suppressable-focus-outline:none;--_suppressable-focus-outline-offset:0}:host([multiple]) .clear-button{margin-inline-start:auto}:host([multiple][clearable]) .label-wrapper{min-block-size:calc(1px * (40 + 4 * clamp(-1, var(--vvd-size-density,0), 2) - 16))}";
 //#endregion
-//#region src/lib/rich-text-view/rich-text-view.ts
+//#region src/lib/select/select.ts
+var selectAppearance = componentEnum(["fieldset", "ghost"], "fieldset");
 /**
 * @public
-* @component rich-text-view
-* @dynamicSlot `@vonage/vivid#RteChildSlotProps` child - Used for custom rendered children.
+* @component select
+* @slot - Default slot.
+* @slot icon - The preferred way to add an icon to the select control.
+* @slot meta - Slot to add meta content to the select control.
+* @slot helper-text - Describes how to use the select. Alternative to the `helper-text` attribute.
+* @event {CustomEvent<undefined>} input - Fires a custom 'input' event when the value updates
+* @event {CustomEvent<HTMLElement>} change - Fires a custom 'change' event when the value updates
+* @vueModel modelValue value input,@lazy:change `event.currentTarget.value`
+* @testAction selectOptionByValue selectOptionByValue
+* @testAction selectOptionByText selectOptionByText
 */
-var RichTextView = class extends VividElement {
+var Select = class extends WithLightDOMFeedback(WithContextualHelp(WithErrorText(WithSuccessText(Localized(FormElement(HostSemantics(AffixIconWithTrailing(FormAssociated(Listbox))))))))) {
 	constructor(..._args) {
 		super(..._args);
-		this._slotCounter = 0;
-		this._slottedChildren = /* @__PURE__ */ new Set();
-		this._slotRequests = /* @__PURE__ */ new Set();
-		this._contentElement = null;
+		this.proxy = document.createElement("select");
+		this.activeIndex = -1;
+		this.rangeStartIndex = -1;
+		this.open = false;
+		this.listboxId = uniqueId("listbox-");
+		this.maxHeight = 0;
+		this.fixedDropdown = false;
+		this._feedbackWrapper = null;
+		this._isResetting = false;
+		this.clearable = false;
+		this._isClearButtonFocused = false;
+	}
+	/**
+	* 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;
+		/* v8 ignore else -- @preserve */
+		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
+	*/
+	checkFirstOption(preserveChecked) {
+		const firstSelectableIndex = this.getNextSelectableIndex(0);
+		if (firstSelectableIndex === -1) return;
+		if (preserveChecked) {
+			if (this.rangeStartIndex === -1) this.rangeStartIndex = this.activeIndex;
+			this.options.forEach((o, i) => {
+				o.checked = inRange(i, firstSelectableIndex, this.rangeStartIndex + 1) && !o.disabled;
+			});
+		} else this.uncheckAllOptions();
+		this.activeIndex = firstSelectableIndex;
+		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) {
+		const lastSelectableIndex = this.getPreviousSelectableIndex(this.length - 1);
+		if (lastSelectableIndex === -1) return;
+		if (preserveChecked) {
+			if (this.rangeStartIndex === -1) this.rangeStartIndex = this.activeIndex;
+			this.options.forEach((o, i) => {
+				o.checked = inRange(i, this.rangeStartIndex, lastSelectableIndex + 1) && !o.disabled;
+			});
+		} else this.uncheckAllOptions();
+		this.activeIndex = lastSelectableIndex;
+		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
+	*/
+	checkNextOption(preserveChecked) {
+		const nextIndex = this.getNextSelectableIndex(this.activeIndex + 1);
+		if (nextIndex === -1) return;
+		if (preserveChecked) {
+			if (this.rangeStartIndex === -1) this.rangeStartIndex = this.activeIndex;
+			this.options.forEach((o, i) => {
+				o.checked = inRange(i, this.rangeStartIndex, nextIndex + 1) && !o.disabled;
+			});
+		} else this.uncheckAllOptions();
+		this.activeIndex = nextIndex;
+		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) {
+		const previousIndex = this.getPreviousSelectableIndex(this.activeIndex - 1);
+		if (previousIndex === -1) return;
+		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, previousIndex, this.rangeStartIndex + 1) && !o.disabled;
+			});
+		} else this.uncheckAllOptions();
+		this.activeIndex = previousIndex;
+		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) {
+			super.focusinHandler(e);
+			return;
+		}
+		/* v8 ignore else -- @preserve */
+		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. */
+	setSelectedOptions() {
+		if (!this.multiple) {
+			super.setSelectedOptions();
+			return;
+		}
+		/* v8 ignore else -- @preserve */
+		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;
+		}
+		/* v8 ignore if -- @preserve */
+		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);
+		/* v8 ignore else -- @preserve */
+		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;
+			Updates.enqueue(() => this.focus());
+			return;
+		}
+		const didClose = prev && !next;
+		const selectionChangedWhileOpen = this.indexWhenOpened !== this.selectedIndex;
+		if (didClose && selectionChangedWhileOpen) this.updateValue(true);
+	}
+	/**
+	* The component is collapsible when in single-selection mode.
+	*
+	* @internal
+	*/
+	get collapsible() {
+		return !this.multiple;
 	}
 	/** @internal */
-	viewChanged(oldView, newView) {
-		if (oldView) this._removeStyles();
-		if (newView) this._addStyles(newView);
-		this._updateView();
-	}
-	_addStyles(view) {
-		const config = view[impl].config[impl];
-		this._styles = new ElementStyles(sortedContributions(config.features.flatMap((f) => f.getStyles())));
-		this._styles.addStylesTo(this.shadowRoot);
-	}
-	_removeStyles() {
-		if (this._styles) {
-			this._styles.removeStylesFrom(this.shadowRoot);
-			this._styles = void 0;
+	valueChanged(prev, next) {
+		const nextSelectedIndex = this.options.findIndex((el) => el.value === next);
+		const validNextSelectedIndex = this._validSelectedIndex(nextSelectedIndex);
+		const nextValue = this.options[validNextSelectedIndex]?.value ?? "";
+		if (this.selectedIndex !== validNextSelectedIndex) this.selectedIndex = validNextSelectedIndex;
+		if (next !== 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
+			});
 		}
 	}
-	_cleanupLightDom() {
-		for (const el of this._slottedChildren) this.removeChild(el);
-		for (const slotName of this._slotRequests) dispatchSlottableRequest(this, "child", slotName, removeSymbol);
-		this._slottedChildren.clear();
-		this._slotRequests.clear();
-		this._slotCounter = 0;
-	}
-	_updateView() {
-		if (!this._contentElement) return;
-		this._contentElement.innerHTML = "";
-		this._cleanupLightDom();
-		if (this.view) this._contentElement.appendChild(this._renderView(this.view));
-	}
-	_renderView(rteView) {
-		const ctx = rteView[impl];
-		if (rteView.type === "node" && rteView.node.type === "doc") rteView = rteView.children;
-		if (rteView.type === "fragment") {
-			const frag = document.createDocumentFragment();
-			for (const child of rteView.content) frag.appendChild(this._renderView(child));
-			return frag;
+	/**
+	* 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 || this._isFromContextualHelp(e)) return;
+		const clickedOption = e.target.closest(`option,[role=option],[data-vvd-component=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;
 		}
-		const customRenderedView = ctx.options.renderChildView?.(rteView) ?? false;
-		if (customRenderedView) return this._handleCustomRender(rteView, customRenderedView);
-		else return this._renderDefault(rteView);
-	}
-	_handleCustomRender(rteView, customResult) {
-		const slotName = `child-view-${this._slotCounter++}`;
-		const slot = document.createElement("slot");
-		slot.setAttribute("name", slotName);
-		if (customResult === true) {
-			this._slotRequests.add(slotName);
-			dispatchSlottableRequest(this, "child", slotName, { view: rteView });
-		} else {
-			const { dom, contentDom = dom } = customResult;
-			const nestedView = document.createElement(this.tagName);
-			nestedView.view = rteView.children;
-			contentDom.appendChild(nestedView);
-			dom.setAttribute("slot", slotName);
-			this.appendChild(dom);
-			this._slottedChildren.add(dom);
+		/* v8 ignore else -- @preserve */
+		if (!this.options.includes(focusTarget)) {
+			this.open = false;
+			if (this.indexWhenOpened !== this.selectedIndex) this.updateValue(true);
 		}
-		return slot;
-	}
-	_renderDefault(view) {
-		const schema = view[impl].config[impl].schema;
-		if (view.type === "node" && view.node.type === "text") return document.createTextNode(view.node.text);
-		const item = view.type === "node" ? view.node : view.mark;
-		const pmItem = view.type === "node" ? Node.fromJSON(schema, item) : Mark.fromJSON(schema, item);
-		const spec = pmItem instanceof Node ? pmItem.type.spec.toDOM(pmItem) : pmItem.type.spec.toDOM(pmItem, true);
-		const { dom, contentDOM = dom } = DOMSerializer.renderSpec(document, spec);
-		const childrenRendered = this._renderView(view.children);
-		contentDOM.appendChild(childrenRendered);
-		return dom;
+	}
+	/**
+	* 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();
+		/* v8 ignore if -- @preserve */
+		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() {
+		/* v8 ignore else -- @preserve */
+		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 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();
+				/* v8 ignore else -- @preserve */
+				if (this.typeaheadExpired) {
+					this.toggleSelectedForAllCheckedOptions();
+					return;
+				}
+			default:
+				/* v8 ignore else -- @preserve */
+				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);
+		switch (e.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) this.open = false;
+				return true;
+		}
+		if (this.collapsible && !this.open && this.selectedIndex !== selectedIndexBefore) this.updateValue(true);
+		return !(e.key === keyArrowDown || e.key === keyArrowUp);
+	}
 	connectedCallback() {
 		super.connectedCallback();
-		this._updateView();
+		this.addEventListener("focusout", this.focusoutHandler);
+		this.addEventListener("contentchange", this.updateDisplayValue);
 	}
-	/** @internal */
 	disconnectedCallback() {
+		this.removeEventListener("focusout", this.focusoutHandler);
+		this.removeEventListener("contentchange", this.updateDisplayValue);
 		super.disconnectedCallback();
-		this._removeStyles();
-		this._cleanupLightDom();
+	}
+	/** @internal */
+	updateDisplayValue() {
+		if (this.collapsible) Observable.notify(this, "displayValue");
+	}
+	get displayValue() {
+		Observable.track(this, "displayValue");
+		return this.firstSelectedOption?.getAttribute("label") ?? this.firstSelectedOption?.text ?? this.placeholder ?? "";
+	}
+	_newDefaultSelectedIndex(prev, next, currentSelectIndex) {
+		const defaultSelectedIndex = super._newDefaultSelectedIndex(prev, next, currentSelectIndex);
+		if (defaultSelectedIndex === null && currentSelectIndex === -1 && !this.placeholder) {
+			const firstSelectableIndex = this.getNextSelectableIndex(0);
+			if (firstSelectableIndex !== -1) return firstSelectableIndex;
+		}
+		return defaultSelectedIndex;
+	}
+	_isDefaultSelected(option) {
+		return super._isDefaultSelected(option) || option.value === this.initialValue || !this._isResetting && option.value === this.value;
+	}
+	slottedOptionsChanged(prev, next) {
+		this.options.forEach((o) => {
+			Observable.getNotifier(o).unsubscribe(this, "value");
+		});
+		super.slottedOptionsChanged(prev, next);
+		this.options.forEach((o) => {
+			Observable.getNotifier(o).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();
+		this._isResetting = true;
+		this.selectedIndex = this._newDefaultSelectedIndex([], this.options, -1) ?? -1;
+		this._isResetting = false;
+	}
+	/** @internal */
+	get _shouldShowClearButton() {
+		if (!this.clearable) return false;
+		if (this.multiple) return this.selectedOptions?.length > 0;
+		return this.value !== "";
+	}
+	/** @internal */
+	_onClearButtonFocus() {
+		this._isClearButtonFocused = true;
+		this.activeIndex = -1;
+		this.uncheckAllOptions();
+	}
+	/** @internal */
+	_onClearButtonBlur() {
+		this._isClearButtonFocused = false;
+	}
+	/** @internal */
+	get _shouldShowLabelWrapper() {
+		return Boolean(this.label || this._hasContextualHelp || this.multiple && this._shouldShowClearButton);
+	}
+	/** @internal */
+	_onClearButtonClick() {
+		if (this.multiple) this.selectedOptions.forEach((o) => {
+			/* v8 ignore else -- @preserve */
+			if (!o.disabled) o.selected = false;
+		});
+		else this.selectedIndex = -1;
+		this.updateValue(true);
 	}
 };
-__decorate([observable], RichTextView.prototype, "view", void 0);
+__decorate([observable], Select.prototype, "activeIndex", void 0);
+__decorate([attr({ mode: "boolean" })], Select.prototype, "multiple", void 0);
+__decorate([attr({
+	attribute: "open",
+	mode: "boolean"
+})], Select.prototype, "open", void 0);
+__decorate([volatile], Select.prototype, "collapsible", null);
+__decorate([observable], Select.prototype, "control", void 0);
+__decorate([observable], Select.prototype, "maxHeight", void 0);
+__decorate([observable], Select.prototype, "_anchor", void 0);
+__decorate([attr()], Select.prototype, "scale", void 0);
+__decorate([attr], Select.prototype, "appearance", void 0);
+__decorate([attr], Select.prototype, "shape", void 0);
+__decorate([attr({
+	mode: "boolean",
+	attribute: "fixed-dropdown"
+})], Select.prototype, "fixedDropdown", void 0);
+__decorate([attr], Select.prototype, "placeholder", void 0);
+__decorate([observable], Select.prototype, "_feedbackWrapper", void 0);
+__decorate([observable], Select.prototype, "metaSlottedContent", void 0);
+__decorate([attr({ mode: "boolean" })], Select.prototype, "clearable", void 0);
+__decorate([observable], Select.prototype, "_isClearButtonFocused", void 0);
 //#endregion
-//#region src/lib/rich-text-view/rich-text-view.template.ts
-var RichTextViewTemplate = () => html`<div class="content rich-text" ${ref("_contentElement")}></div>`;
+//#region src/lib/select/select.template.ts
+function renderLabel() {
+	return html` <label
+		for="${(x) => x.multiple ? null : "control"}"
+		class="label"
+		id="label"
+	>
+		${(x) => x.label}
+	</label>`;
+}
+function renderPlaceholder(context) {
+	const optionTag = context.tagFor(ListboxOption);
+	return html`
+		<${optionTag} text="${(x) => x.placeholder}" hidden disabled>
+		</${optionTag}>`;
+}
+function renderClearButton(context) {
+	const buttonTag = context.tagFor(Button);
+	return html`
+		<${buttonTag}
+			aria-label="${(x) => x.locale.select.clearButtonLabel}"
+			aria-hidden="${(x) => x._isClearButtonFocused ? "false" : "true"}"
+			@click="${(x, c) => {
+		x._onClearButtonClick();
+		c.event.stopPropagation();
+	}}"
+			@mousedown="${() => false}"
+			@keydown="${(x, c) => {
+		/* v8 ignore next -- @preserve */
+		if (c.event.key === "Tab") x._onClearButtonBlur();
+		c.event.stopPropagation();
+		return true;
+	}}"
+			@focusin="${(x, c) => {
+		c.event.stopPropagation();
+		x._onClearButtonFocus();
+	}}"
+			@focusout="${(x) => x._onClearButtonBlur()}"
+			?disabled="${(x) => x.disabled}"
+			:shape="${(x) => x.shape}"
+			size="super-condensed"
+			icon="close-line"
+			appearance="ghost-light"
+			class="clear-button"
+			tabindex="0"
+		></${buttonTag}>
+	`;
+}
+function selectValue(context) {
+	const affixIconTemplate = affixIconTemplateFactory(context);
+	const chevronTemplate = chevronTemplateFactory(context);
+	return html` <div
+		class="control ${(x) => classNames(["has-activedescendant", Boolean(x._activeDescendant) && x.open], ["disabled", x.disabled], "connotation-accent", `appearance-${selectAppearance.parse(x.appearance)}`, "with-idle", "with-hover", "with-disabled", "with-readonly", "with-error", "with-success", [`shape-${x.shape}`, Boolean(x.shape)], ["has-meta", Boolean(x.metaSlottedContent?.length)], ["error", Boolean(x.errorValidationMessage)], ["success", !!x.successText], ["shows-placeholder", Boolean(x.placeholder) && !x.value], [`size-${x.scale}`, Boolean(x.scale)])}"
+		${ref("_anchor")}
+		id="control"
+		?disabled="${(x) => x.disabled}"
+	>
+		<div class="selected-value">
+			${(x) => affixIconTemplate(x.icon, IconWrapper.Slot)}
+			<span class="text">${(x) => x.displayValue}</span>
+			<slot name="meta" ${slotted("metaSlottedContent")}></slot>
+		</div>
+		${when((x) => x._shouldShowClearButton, renderClearButton(context))}
+		${chevronTemplate}
+	</div>`;
+}
+function setFixedDropdownVarWidth(x) {
+	return x.open && x.fixedDropdown ? `--_select-fixed-width: ${Math.round(x.getBoundingClientRect().width)}px` : null;
+}
+/** @param context - element definition context */
+function renderControl(context) {
+	const popupTag = context.tagFor(Popup);
+	return html`
+			<div class="label-wrapper" ?hidden=${(x) => !x._shouldShowLabelWrapper}>
+				${when((x) => x.label, renderLabel())}
+				${when((x) => x.multiple && x._shouldShowClearButton, renderClearButton(context))}
+				<slot name="contextual-help" ${slotted("_contextualHelpSlottedContent")}></slot>
+			</div>
+			<div class="control-wrapper">
+				${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("listbox")}>
+						${when((x) => x.placeholder, renderPlaceholder(context))}
+						<slot
+							${slotted({
+		filter: Listbox.slottedOptionFilter,
+		flatten: true,
+		property: "slottedOptions"
+	})}>
+						</slot>
+				 	</div>
+				</${popupTag}>
+			</div>
+		`;
+}
+/** Ignore events that originate from feedback, e.g. a click on link */
+function ifNotFromFeedback(handler) {
+	return (x, c) => {
+		if (!c.event.composedPath().includes(x._feedbackWrapper)) {
+			handler(x, c.event);
+			return;
+		}
+		return true;
+	};
+}
+/**
+* As `ifNotFromFeedback`, but forwards the handler's return value.
+*
+* FAST prevents an event's default action unless the binding returns exactly
+* `true`, so handlers that need to opt out of that — e.g. keydown, where
+* preventing the default action on Tab would trap focus on the select — must
+* have their result passed through rather than discarded.
+*/
+function ifNotFromFeedbackPreservingDefault(handler) {
+	return (x, c) => {
+		if (!c.event.composedPath().includes(x._feedbackWrapper)) return handler(x, c.event);
+		return true;
+	};
+}
+var SelectTemplate = (context) => {
+	return html`
+		<template
+			${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.open ? x._activeDescendant : null}"
+			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="${ifNotFromFeedbackPreservingDefault((x, e) => {
+		if (x.open) handleEscapeKeyAndStopPropogation(e);
+		return x.keydownHandler(e);
+	})}"
+			@mousedown="${ifNotFromFeedback((x, e) => x.mousedownHandler(e))}"
+		>
+			${renderControl(context)}
+			<div class="feedback-wrapper" ${ref("_feedbackWrapper")}>
+				${(x) => x._getFeedbackTemplate(context)}
+			</div>
+		</template>
+	`;
+};
 //#endregion
-//#region src/lib/rich-text-view/definition.ts
-var richTextViewDefinition = defineVividComponent("rich-text-view", RichTextView, RichTextViewTemplate, [], {
-	styles: rich_text_view_default,
-	shadowOptions: { delegatesFocus: true }
-});
+//#region src/lib/select/definition.ts
+/** @internal */
+var selectDefinition = defineVividComponent("select", Select, SelectTemplate, [
+	popupDefinition,
+	iconDefinition,
+	listboxOptionDefinition,
+	optgroupDefinition,
+	buttonDefinition,
+	feedbackMessageDefinition
+], { styles: select_default });
 /**
-* Registers the rich-text-view element with the design system.
+* Registers the select elements with the design system.
 *
 * @param prefix - the prefix to use for the component name
 */
-var registerRichTextView = createRegisterFunction(richTextViewDefinition);
+var registerSelect = createRegisterFunction(selectDefinition);
 //#endregion
-export { richTextViewDefinition as n, RichTextView as r, registerRichTextView as t };
+export { selectDefinition as n, Select as r, registerSelect as t };