@vonage/vivid 5.23.1 → 5.25.0

package/unbundled/definition49.js

@@ -1,63 +1,603 @@
-import { d as createRegisterFunction, n as replaces, t as VividElement, u as defineVividComponent } from "./vivid-element.js";
-import { t as iconDefinition } from "./definition.js";
+import { d as createRegisterFunction, t as VividElement, u as defineVividComponent } from "./vivid-element.js";
 import { t as __decorate } from "./decorate.js";
-import { a as affixIconTemplateFactory, i as IconWrapper, t as AffixIcon } from "./affix.js";
-import { t as Linkable } from "./linkable.js";
-import { attr, html } from "@microsoft/fast-element";
-import { classNames } from "@microsoft/fast-web-utilities";
-//#region src/lib/nav-item/nav-item.scss?inline
-var nav_item_default = ".control{box-sizing:border-box;background-color:var(--_appearance-color-fill);box-shadow:inset 0 0 0 1px var(--_appearance-color-outline);font:var(--vvd-typography-base);hyphens:auto;inline-size:100%;min-block-size:calc(1px * (40 + 4 * clamp(-1, var(--vvd-size-density,0), 2)));vertical-align:middle;border-radius:8px;align-items:center;gap:12px;text-decoration:none;display:inline-flex}.control.current{color:var(--_appearance-color-text)}@supports not (color:color-mix(in srgb, var(--one-color), var(--second-color))){.control.current{background-color:var(--_connotation-color-primary)}}.control.current:focus-visible{outline:none;position:relative}.control.current:focus-visible:after{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:var(--focus-border-radius,inherit);block-size:calc(100% + var(--focus-block-size-addition,4px));content:\"\";inline-size:calc(100% + var(--focus-block-size-addition,4px));display:block;position:absolute;inset-block-start:50%;inset-inline-start:50%;transform:translate(-50%,-50%)}.control.connotation-cta{--_connotation-color-primary:var(--vvd-nav-item-cta-primary,var(--vvd-color-cta-500));--_connotation-color-primary-text:var(--vvd-nav-item-cta-primary-text,var(--vvd-color-canvas));--_connotation-color-primary-increment:var(--vvd-nav-item-cta-primary-increment,var(--vvd-color-cta-600));--_connotation-color-contrast:var(--vvd-nav-item-cta-contrast,var(--vvd-color-cta-800));--_connotation-color-fierce:var(--vvd-nav-item-cta-fierce,var(--vvd-color-cta-700));--_connotation-color-fierce-primary:var(--vvd-nav-item-cta-fierce-primary,var(--vvd-color-cta-700));--_connotation-color-faint:var(--vvd-nav-item-cta-faint,var(--vvd-color-cta-50));--_connotation-color-firm:var(--vvd-nav-item-cta-firm,var(--vvd-color-cta-600));--_connotation-color-soft:var(--vvd-nav-item-cta-soft,var(--vvd-color-cta-100))}.control:not(.connotation-cta){--_connotation-color-primary:var(--vvd-nav-item-accent-primary,var(--vvd-color-canvas-text));--_connotation-color-primary-text:var(--vvd-nav-item-accent-primary-text,var(--vvd-color-canvas));--_connotation-color-primary-increment:var(--vvd-nav-item-accent-primary-increment,var(--vvd-color-neutral-800));--_connotation-color-contrast:var(--vvd-nav-item-accent-contrast,var(--vvd-color-neutral-800));--_connotation-color-fierce:var(--vvd-nav-item-accent-fierce,var(--vvd-color-neutral-700));--_connotation-color-fierce-primary:var(--vvd-nav-item-accent-fierce-primary,var(--vvd-color-canvas-text));--_connotation-color-faint:var(--vvd-nav-item-accent-faint,var(--vvd-color-neutral-50));--_connotation-color-firm:var(--vvd-nav-item-accent-firm,var(--vvd-color-canvas-text));--_connotation-color-soft:var(--vvd-nav-item-accent-soft,var(--vvd-color-neutral-100))}.control,.control.appearance-ghost-light{--_appearance-color-text:var(--_connotation-color-firm);--_appearance-color-fill:transparent;--_appearance-color-outline:transparent}@media (hover:hover){.control:hover:where(:not(.disabled,:disabled,.readonly)){--_appearance-color-text:var(--_connotation-color-firm);--_appearance-color-fill:var(--_connotation-color-faint);--_appearance-color-outline:transparent}.control:hover:where(:not(.disabled,:disabled,.readonly)).appearance-ghost-light{--_appearance-color-text:var(--_connotation-color-fierce-primary);--_appearance-color-fill:color-mix(in sRGB, var(--_connotation-color-primary), transparent 90%);--_appearance-color-outline:transparent}}.control.hover:where(:not(.disabled,:disabled,.readonly)){--_appearance-color-text:var(--_connotation-color-firm);--_appearance-color-fill:var(--_connotation-color-faint);--_appearance-color-outline:transparent}.control.hover:where(:not(.disabled,:disabled,.readonly)).appearance-ghost-light{--_appearance-color-text:var(--_connotation-color-fierce-primary);--_appearance-color-fill:color-mix(in sRGB, var(--_connotation-color-primary), transparent 90%);--_appearance-color-outline:transparent}.control:active:where(:not(.disabled,:disabled)){--_appearance-color-text:var(--_connotation-color-firm);--_appearance-color-fill:var(--_connotation-color-soft);--_appearance-color-outline:transparent}.control:active:where(:not(.disabled,:disabled)).appearance-ghost-light{--_appearance-color-text:var(--_connotation-color-fierce-primary);--_appearance-color-fill:color-mix(in sRGB, var(--_connotation-color-primary), transparent 80%);--_appearance-color-outline:transparent}.control.active:where(:not(.disabled,:disabled)){--_appearance-color-text:var(--_connotation-color-firm);--_appearance-color-fill:var(--_connotation-color-soft);--_appearance-color-outline:transparent}.control.active:where(:not(.disabled,:disabled)).appearance-ghost-light{--_appearance-color-text:var(--_connotation-color-fierce-primary);--_appearance-color-fill:color-mix(in sRGB, var(--_connotation-color-primary), transparent 80%);--_appearance-color-outline:transparent}.control.selected:where(:not(.disabled,:disabled)){--_appearance-color-text:var(--_connotation-color-primary-text);--_appearance-color-fill:var(--_connotation-color-primary);--_appearance-color-outline:transparent}.control.selected:where(:not(.disabled,:disabled)).appearance-ghost-light{--_appearance-color-text:var(--_connotation-color-primary-text);--_appearance-color-fill:color-mix(in sRGB, var(--_connotation-color-firm), transparent 10%);--_appearance-color-outline:transparent}@media (hover:hover){.control.selected:hover:where(:not(.disabled,:disabled,.readonly)){--_appearance-color-text:var(--_connotation-color-primary-text);--_appearance-color-fill:var(--_connotation-color-primary-increment);--_appearance-color-outline:transparent}.control.selected:hover:where(:not(.disabled,:disabled,.readonly)).appearance-ghost-light{--_appearance-color-text:var(--_connotation-color-primary-text);--_appearance-color-fill:color-mix(in sRGB, var(--_connotation-color-fierce-primary), transparent 20%);--_appearance-color-outline:transparent}}.control.selected.hover:where(:not(.disabled,:disabled,.readonly)){--_appearance-color-text:var(--_connotation-color-primary-text);--_appearance-color-fill:var(--_connotation-color-primary-increment);--_appearance-color-outline:transparent}.control.selected.hover:where(:not(.disabled,:disabled,.readonly)).appearance-ghost-light{--_appearance-color-text:var(--_connotation-color-primary-text);--_appearance-color-fill:color-mix(in sRGB, var(--_connotation-color-fierce-primary), transparent 20%);--_appearance-color-outline:transparent}.control.icon-only{block-size:calc(1px * (40 + 4 * clamp(-1, var(--vvd-size-density,0), 2)));inline-size:calc(1px * (40 + 4 * clamp(-1, var(--vvd-size-density,0), 2)));place-content:center;display:flex;position:relative}.control.icon-only slot[name=meta]{display:block;position:absolute;inset-block-start:calc((calc(1px * (40 + 4 * clamp(-1, var(--vvd-size-density,0), 2))) - 20px) / 2);inset-inline-end:calc((calc(1px * (40 + 4 * clamp(-1, var(--vvd-size-density,0), 2))) - 20px) / 2);transform:translate(50%,-50%)}.control:not(.icon-only){padding-block:10px;padding-inline:16px}.control:not(.current){color:var(--vvd-color-canvas-text);--focus-stroke-gap-color:transparent}.control:not(.current):focus-visible{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(:dir(rtl)) .icon-only slot[name=meta]{transform:translate(-50%,-50%)}slot[name=icon]{font-size:20px;line-height:1}";
-//#endregion
-//#region src/lib/nav-item/nav-item.ts
+import { n as applyHostSemantics, t as HostSemantics } from "./host-semantics.js";
+import { n as isListboxOption } from "./option.js";
+import { n as isOptgroup } from "./optgroup.js";
+import { t as extractOptions } from "./extractOptions.js";
+import { attr, html, observable, slotted, when } from "@microsoft/fast-element";
+import { keySpace, uniqueId } from "@microsoft/fast-web-utilities";
+import scrollIntoView from "scroll-into-view-if-needed";
+//#region src/shared/listbox/with-options-filter.ts
+function applyFilter(allOptions, allElements, optionFilter, searchText) {
+	const newFilteredOptions = [];
+	for (const option of allOptions) {
+		option._vvdSearchText = searchText;
+		const matches = !searchText || optionFilter(option, searchText);
+		option._isNotMatching = !matches;
+		if (!option.hidden && !option.disabled && matches) newFilteredOptions.push(option);
+	}
+	for (const el of allElements) if (isOptgroup(el)) {
+		const hasVisibleOption = Array.from(el.children).some((child) => isListboxOption(child) && !child._isNotMatching && !child.hidden);
+		el.style.display = hasVisibleOption ? "" : "none";
+	}
+	return newFilteredOptions;
+}
+var WithOptionsFilter = (Base) => {
+	class WithOptionsElement extends Base {
+		constructor(..._args) {
+			super(..._args);
+			this.searchText = "";
+			this._filteredOptions = [];
+		}
+		/** @internal */
+		_slottedOptionsChanged() {
+			super._slottedOptionsChanged();
+			this._updateFilter();
+		}
+		/** @internal */
+		searchTextChanged() {
+			this._updateFilter();
+		}
+		/** @internal */
+		optionFilterChanged() {
+			this._updateFilter();
+		}
+		/** @internal */
+		_updateFilter() {
+			this._filteredOptions = applyFilter(this._slottedOptions, this._slottedElements, this.optionFilter ?? ((option, searchText) => option.text.toLowerCase().includes(searchText.toLowerCase())), this.searchText);
+		}
+	}
+	__decorate([attr({
+		attribute: "search-text",
+		mode: "fromView"
+	})], WithOptionsElement.prototype, "searchText", void 0);
+	__decorate([observable], WithOptionsElement.prototype, "optionFilter", void 0);
+	__decorate([observable], WithOptionsElement.prototype, "_filteredOptions", void 0);
+	return WithOptionsElement;
+};
+//#endregion
+//#region src/shared/listbox/with-options.ts
+/** A mixin for elements that accept slotted options */
+var WithOptions = (Base) => {
+	class WithOptionsElement extends Base {
+		constructor(..._args) {
+			super(..._args);
+			this._slottedElements = [];
+			this.#onOptgroupChange = () => {
+				this._slottedElementsChanged();
+			};
+			this._slottedOptions = [];
+		}
+		/** @internal */
+		_slottedElementsChanged() {
+			this._slottedOptions = extractOptions(this._slottedElements);
+		}
+		#onOptgroupChange;
+		connectedCallback() {
+			super.connectedCallback();
+			this.addEventListener("optgroup-change", this.#onOptgroupChange);
+		}
+		disconnectedCallback() {
+			super.disconnectedCallback();
+			this.removeEventListener("optgroup-change", this.#onOptgroupChange);
+		}
+		/** @internal */
+		_slottedOptionsChanged() {
+			for (const option of this._slottedOptions) if (!option.id) option.id = uniqueId("option-");
+		}
+	}
+	__decorate([observable], WithOptionsElement.prototype, "_slottedElements", void 0);
+	__decorate([observable], WithOptionsElement.prototype, "_slottedOptions", void 0);
+	return WithOptionsElement;
+};
+var optionsTemplate = html`<slot
+	${slotted({
+	filter: ((n) => isListboxOption(n) || isOptgroup(n)),
+	flatten: true,
+	property: "_slottedElements"
+})}
+>
+</slot>`;
+//#endregion
+//#region src/shared/listbox/selection.ts
+var modifierKeys = (e) => {
+	const modKey = e.ctrlKey || e.metaKey;
+	return e.shiftKey && modKey ? "ShiftMod" : e.shiftKey ? "Shift" : modKey ? "Mod" : null;
+};
+var selectionForMove = (state, ctx, move, mods) => {
+	if (move.amount === "step" && mods === "Mod") return null;
+	if (ctx.selectionMode === "multiple") {
+		if (move.amount === "step" && mods === "Shift") return {
+			action: {
+				type: "extend-from-anchor",
+				anchorIndex: state.rangeAnchorIndex ?? state.activeIndex
+			},
+			replaceExisting: false
+		};
+		if (move.amount === "limit" && mods === "ShiftMod") return {
+			action: { type: "select-from-current" },
+			replaceExisting: false
+		};
+	}
+	if (ctx.selectionBehavior === "replace") return {
+		action: { type: "select" },
+		replaceExisting: true
+	};
+	return null;
+};
+/** How the selection should change when an option is triggered (by pressing Space or clicking) */
+var selectionForTrigger = (ctx, mods) => {
+	if (mods === "Shift") return {
+		action: { type: "select-from-most-recent" },
+		replaceExisting: ctx.selectionBehavior === "replace"
+	};
+	if (mods === "Mod") return {
+		action: { type: "toggle" },
+		replaceExisting: false
+	};
+	if (ctx.selectionBehavior === "replace") return {
+		action: { type: "select" },
+		replaceExisting: true
+	};
+	return {
+		action: { type: "toggle" },
+		replaceExisting: false
+	};
+};
+function addRange(baseValues, ctx, fromIdx, toIdx) {
+	const baseSet = new Set(baseValues);
+	const [from, to] = [fromIdx, toIdx].sort((a, b) => a - b);
+	const newValues = [...baseValues];
+	for (let i = from; i <= to; i++) {
+		const v = ctx.selectable.optionValue(i);
+		if (!baseSet.has(v)) newValues.push(v);
+	}
+	return newValues;
+}
+function updateAnchoredRange(baseValues, ctx, anchorIdx, targetIdx, prevTargetIdx) {
+	const baseSet = new Set(baseValues);
+	const [from, , to] = [
+		anchorIdx,
+		targetIdx,
+		prevTargetIdx
+	].sort((a, b) => a - b);
+	let newValues = [...baseValues];
+	for (let i = from; i <= to; i++) {
+		const v = ctx.selectable.optionValue(i);
+		if (i < anchorIdx && i < targetIdx || i > anchorIdx && i > targetIdx) {
+			if (baseSet.has(v)) newValues = newValues.filter((val) => val !== v);
+		} else if (!baseSet.has(v)) newValues.push(v);
+	}
+	return newValues;
+}
+function mostRecentlySelectedIndex(state, ctx) {
+	const values = state.values;
+	for (let i = values.length - 1; i >= 0; i--) {
+		const index = ctx.selectable.optionIndex(values[i]);
+		if (index !== null) return index;
+	}
+	return null;
+}
+function applyAction(state, ctx, command) {
+	const newState = (v) => {
+		return {
+			...state,
+			values: v.values ?? state.values,
+			activeIndex: v.activeIndex ?? state.activeIndex,
+			rangeAnchorIndex: v.rangeAnchorIndex ?? null
+		};
+	};
+	if (command.type !== "action") return newState({});
+	const prevValues = state.values;
+	const { targetIndex, selection } = command;
+	const enforceRestrictions = (newValues) => {
+		if (ctx.selectionMode === "single" && newValues.length > 1) return [newValues[newValues.length - 1]];
+		if (ctx.requiredSelection !== "none") {
+			if (newValues.length === 0) return prevValues;
+			if (ctx.requiredSelection === "selectable") {
+				if (!newValues.some((v) => ctx.selectable.optionIndex(v) !== null)) return prevValues;
+			}
+		}
+		return newValues;
+	};
+	const targetValue = ctx.selectable.optionValue(targetIndex);
+	const baseValues = selection?.replaceExisting ? [] : prevValues;
+	switch (selection?.action.type) {
+		case void 0: return newState({ activeIndex: targetIndex });
+		case "select": return newState({
+			activeIndex: targetIndex,
+			values: enforceRestrictions(prevValues.includes(targetValue) ? prevValues : [...baseValues, targetValue])
+		});
+		case "toggle": return newState({
+			activeIndex: targetIndex,
+			values: enforceRestrictions(prevValues.includes(targetValue) ? baseValues.filter((v) => v !== targetValue) : [...baseValues, targetValue])
+		});
+		case "select-from-current": return newState({
+			activeIndex: targetIndex,
+			values: enforceRestrictions(addRange(baseValues, ctx, state.activeIndex, targetIndex))
+		});
+		case "select-from-most-recent": return newState({
+			activeIndex: targetIndex,
+			values: enforceRestrictions(addRange(baseValues, ctx, mostRecentlySelectedIndex(state, ctx) ?? 0, targetIndex))
+		});
+		case "extend-from-anchor": return newState({
+			values: enforceRestrictions(updateAnchoredRange(baseValues, ctx, selection.action.anchorIndex, targetIndex, state.activeIndex)),
+			activeIndex: targetIndex,
+			rangeAnchorIndex: selection.action.anchorIndex
+		});
+	}
+}
+//#endregion
+//#region src/shared/listbox/typeahead.ts
+var TypeaheadTimeout = 2e3;
+function typeaheadFromKey(state, _ctx, key, now) {
+	const typeahead = state.typeahead && state.typeahead.lastInputMs > now - TypeaheadTimeout ? state.typeahead : null;
+	return key.length === 1 && !(key === keySpace && !typeahead) ? {
+		buffer: (typeahead?.buffer ?? "") + key,
+		lastInputMs: now
+	} : null;
+}
+function applyTypeahead(state, ctx, command) {
+	if (command.type !== "typeahead") return {
+		...state,
+		typeahead: null
+	};
+	const typeahead = command.typeahead;
+	for (let candidateIdx = (state.activeIndex + 1) % ctx.selectable.numOptions; candidateIdx !== state.activeIndex; candidateIdx = (candidateIdx + 1) % ctx.selectable.numOptions) if (ctx.selectable.optionText(candidateIdx).toLowerCase().startsWith(typeahead.buffer.toLowerCase())) return {
+		...applyAction(state, ctx, {
+			type: "action",
+			targetIndex: candidateIdx,
+			selection: command.selection
+		}),
+		typeahead
+	};
+	return {
+		...state,
+		typeahead
+	};
+}
+//#endregion
+//#region src/shared/listbox/options.ts
+var optionsInterface = (options) => ({
+	numOptions: options.length,
+	optionValue: (index) => options[index].value,
+	optionText: (index) => options[index].text,
+	optionIndex: (value) => {
+		const index = options.findIndex((o) => o.value === value);
+		return index === -1 ? null : index;
+	},
+	isEq: (newOptions) => options === newOptions
+});
+function initialValues(ctx, allOptions, providedValues) {
+	const selectedValues = allOptions.filter((option) => option.selected || providedValues.includes(option.value)).map((o) => o.value);
+	const maxSelected = ctx.selectionMode === "single" ? 1 : Infinity;
+	return ensureRequiredSelection(ctx, selectedValues.slice(0, maxSelected), maxSelected);
+}
+//#endregion
+//#region src/shared/listbox/state.ts
+function isUIState(state) {
+	return "activeIndex" in state;
+}
+function applyContextChange(state, newCtx, requestedValues) {
+	const validValues = requestedValues.filter((v) => newCtx.all.optionIndex(v) !== null);
+	const maxSelected = newCtx.selectionMode === "single" ? 1 : Infinity;
+	let values = validValues.slice(0, maxSelected);
+	values = ensureRequiredSelection(newCtx, values, maxSelected);
+	return {
+		...state,
+		values
+	};
+}
+/**
+* Applies the `requiredSelection` restriction to a set of values, selecting a selectable option if needed.
+* @internal
+*/
+function ensureRequiredSelection(ctx, values, maxSelected) {
+	if (ctx.requiredSelection === "none" || ctx.selectable.numOptions === 0) return values;
+	if (values.length === 0) return [ctx.selectable.optionValue(0)];
+	if (ctx.requiredSelection === "selectable") {
+		if (!values.some((v) => ctx.selectable.optionIndex(v) !== null)) return maxSelected === 1 ? [ctx.selectable.optionValue(0)] : [...values, ctx.selectable.optionValue(0)];
+	}
+	return values;
+}
+function initialState(ctx, providedOptions, providedValues) {
+	const values = initialValues(ctx, providedOptions, providedValues);
+	if (ctx.selectable.numOptions === 0) return valuesOnlyState(values);
+	let activeIndex = 0;
+	for (const candidate of values) {
+		const index = ctx.selectable.optionIndex(candidate);
+		if (index !== null) {
+			activeIndex = index;
+			break;
+		}
+	}
+	return {
+		values,
+		activeIndex,
+		typeahead: null,
+		rangeAnchorIndex: null
+	};
+}
+function valuesOnlyState(values) {
+	return { values };
+}
+//#endregion
+//#region src/shared/listbox/move.ts
+function moveFromKey(key) {
+	switch (key) {
+		case "Home": return {
+			direction: "backward",
+			amount: "limit"
+		};
+		case "End": return {
+			direction: "forward",
+			amount: "limit"
+		};
+		case "PageUp": return {
+			direction: "backward",
+			amount: "page"
+		};
+		case "PageDown": return {
+			direction: "forward",
+			amount: "page"
+		};
+		case "ArrowUp": return {
+			direction: "backward",
+			amount: "step"
+		};
+		case "ArrowDown": return {
+			direction: "forward",
+			amount: "step"
+		};
+	}
+	return null;
+}
+function moveIndex(index, numItems, pageSize, move) {
+	const limits = {
+		backward: 0,
+		forward: numItems - 1
+	};
+	const dirs = {
+		backward: -1,
+		forward: 1
+	};
+	const amounts = {
+		step: 1,
+		page: pageSize
+	};
+	switch (move.amount) {
+		case "limit": return limits[move.direction];
+		case "page":
+		case "step": return Math.min(limits.forward, Math.max(limits.backward, index + dirs[move.direction] * amounts[move.amount]));
+	}
+}
+//#endregion
+//#region src/shared/listbox/commands.ts
+var PageSize = 10;
+function commandFromKey(state, ctx, e, now) {
+	if (!isUIState(state)) return null;
+	const typeahead = typeaheadFromKey(state, ctx, e.key, now);
+	if (typeahead) return {
+		type: "typeahead",
+		typeahead,
+		selection: ctx.selectionBehavior === "replace" ? {
+			action: { type: "select" },
+			replaceExisting: true
+		} : null
+	};
+	const move = moveFromKey(e.key);
+	if (move) return {
+		type: "action",
+		targetIndex: moveIndex(state.activeIndex, ctx.selectable.numOptions, PageSize, move),
+		selection: selectionForMove(state, ctx, move, modifierKeys(e))
+	};
+	if (e.key === " ") return {
+		type: "action",
+		targetIndex: state.activeIndex,
+		selection: selectionForTrigger(ctx, modifierKeys(e))
+	};
+	return null;
+}
+function commandFromClick(_state, ctx, e, targetIndex) {
+	return {
+		type: "action",
+		targetIndex,
+		selection: selectionForTrigger(ctx, modifierKeys(e))
+	};
+}
+function apply(state, context, command) {
+	state = applyTypeahead(state, context, command);
+	state = applyAction(state, context, command);
+	return state;
+}
+//#endregion
+//#region src/lib/listbox/listbox.ts
+var deepEqual = (a, b) => JSON.stringify(a) === JSON.stringify(b);
 /**
-* Based largely on the {@link https://developer.mozilla.org/en-US/docs/Web/HTML/Element/a | <a> element }.
-*
 * @public
-* @component nav-item
-* @slot meta - A slot to add additional content to the nav item.
-* @slot icon - The preferred way to add an icon to the component.
-* @testSelector byLabel byLabel
-* @testAction click click #control
-* @testQuery current navCurrent true
-* @testQuery !current navCurrent false
-* @testRef control shadow .control
+* @component listbox
+* @slot - Holds the available options.
+* @slot no-matches - Message that appears when no options match the search query.
+* @event {CustomEvent<undefined>} change - Fired when the selected options change.
+* @vueModel modelValue value change `event.currentTarget.value`
+* @vueModel values values change `event.currentTarget.values`
 */
-var NavItem = class extends AffixIcon(Linkable(VividElement)) {
+var Listbox = class extends WithOptionsFilter(WithOptions(HostSemantics(VividElement))) {
 	constructor(..._args) {
 		super(..._args);
-		this.current = false;
+		this.selectionMode = "single";
+		this.selectionBehavior = "toggle";
+		this.requiredSelection = "none";
+		this._activeDescendantId = null;
+		this.values = [];
+		this._state = valuesOnlyState([]);
+		this._ctx = {
+			selectionMode: "single",
+			selectionBehavior: "toggle",
+			requiredSelection: "none",
+			selectable: optionsInterface([]),
+			all: optionsInterface([])
+		};
+		this._externalChangeQueued = false;
+	}
+	/** @internal */
+	selectionModeChanged() {
+		this._registerExternalChange();
+	}
+	/** @internal */
+	selectionBehaviorChanged() {
+		this._registerExternalChange();
+	}
+	/** @internal */
+	requiredSelectionChanged() {
+		this._registerExternalChange();
+	}
+	/** @internal */
+	_filteredOptionsChanged() {
+		this._registerExternalChange();
+	}
+	/** @internal */
+	valuesChanged() {
+		if (this._state && !deepEqual(this._state.values, this.values)) this._registerExternalChange();
+	}
+	/** The first selected option value, or `null` if no option is selected. In single-selection mode, this can be used as an alternative to `values`. */
+	get value() {
+		return this.values[0] ?? null;
+	}
+	set value(value) {
+		this.values = value === null ? [] : [value];
+	}
+	/**
+	* Use a microtask to batch multiple synchronous changes. Otherwise, we may update the state based on half-applied changes.
+	* @internal
+	*/
+	_registerExternalChange() {
+		if (!this._externalChangeQueued) {
+			this._externalChangeQueued = true;
+			queueMicrotask(() => this._applyPendingExternalChanges());
+		}
+	}
+	/**
+	* React to external changes of props or options
+	* @internal
+	*/
+	_applyPendingExternalChanges() {
+		this._externalChangeQueued = false;
+		if (!this._ctx.all.isEq(this._slottedOptions) || !this._ctx.selectable.isEq(this._filteredOptions)) {
+			this._initializeState();
+			return;
+		}
+		const newCtx = {
+			...this._ctx,
+			selectionMode: this.selectionMode,
+			selectionBehavior: this.selectionBehavior,
+			requiredSelection: this.requiredSelection
+		};
+		this._ctx = newCtx;
+		this._applyNewState(applyContextChange(this._state, newCtx, this.values));
+	}
+	/** @internal */
+	_initializeState() {
+		this._ctx = {
+			selectionMode: this.selectionMode,
+			selectionBehavior: this.selectionBehavior,
+			requiredSelection: this.requiredSelection,
+			selectable: optionsInterface(this._filteredOptions),
+			all: optionsInterface(this._slottedOptions)
+		};
+		if (!this._slottedOptions?.length) {
+			this._state = valuesOnlyState([]);
+			this._activeDescendantId = null;
+			return;
+		}
+		this._applyNewState(initialState(this._ctx, this._slottedOptions, this.values));
+	}
+	/** @internal */
+	_applyNewState(toState) {
+		if (isUIState(toState)) {
+			const activeOption = this._filteredOptions[toState.activeIndex];
+			this._activeDescendantId = activeOption.id;
+			scrollIntoView(activeOption, {
+				block: "nearest",
+				scrollMode: "if-needed"
+			});
+		} else this._activeDescendantId = null;
+		const valuesChanged = !deepEqual(this.values, toState.values);
+		this._state = toState;
+		this.values = [...toState.values];
+		this._updateSlottedOptions();
+		if (valuesChanged) this.$emit("change", void 0, {
+			bubbles: false,
+			composed: false
+		});
+	}
+	/** @internal */
+	_updateSlottedOptions() {
+		for (const option of this._slottedOptions) {
+			option.selected = this.values.includes(option.value);
+			option._highlighted = Boolean(this._activeDescendantId && option.id === this._activeDescendantId);
+		}
+	}
+	/** @internal */
+	_onKeydown(e) {
+		const command = commandFromKey(this._state, this._ctx, e, Date.now());
+		if (command) {
+			this._applyNewState(apply(this._state, this._ctx, command));
+			return false;
+		}
+		return true;
+	}
+	/** @internal */
+	_onClick(e) {
+		const clickedOnOption = e.target.closest(`[data-vvd-component=option]`);
+		const targetIndex = clickedOnOption ? this._filteredOptions.indexOf(clickedOnOption) : -1;
+		if (targetIndex === -1) return true;
+		const state = this._state;
+		this._applyNewState(apply(state, this._ctx, commandFromClick(state, this._ctx, e, targetIndex)));
+		return false;
 	}
 };
-__decorate([attr], NavItem.prototype, "text", void 0);
-__decorate([attr], NavItem.prototype, "connotation", void 0);
-__decorate([attr], NavItem.prototype, "appearance", void 0);
-__decorate([replaces({
-	deprecatedPropertyName: "ariaCurrent",
-	fromDeprecated: (v) => Boolean(v),
-	toDeprecated: (v) => v ? "page" : null
-}), attr({
-	attribute: "current",
-	mode: "boolean"
-})], NavItem.prototype, "current", void 0);
-//#endregion
-//#region src/lib/nav-item/nav-item.template.ts
-var NavItemTemplate = (context) => {
-	const affixIconTemplate = affixIconTemplateFactory(context);
-	return html`${(x) => x._renderLinkElement(html`${(x) => affixIconTemplate(x.icon, IconWrapper.Slot)}
-				${(x) => x.text} <slot name="meta"></slot>`, (x) => classNames("control", ["icon-only", !x.text], [`connotation-${x.connotation}`, Boolean(x.connotation)], [`appearance-${x.appearance}`, Boolean(x.appearance)], ["current selected", x.current]))}`;
+__decorate([attr({
+	attribute: "selection-mode",
+	mode: "fromView"
+})], Listbox.prototype, "selectionMode", void 0);
+__decorate([attr({
+	attribute: "selection-behavior",
+	mode: "fromView"
+})], Listbox.prototype, "selectionBehavior", void 0);
+__decorate([attr({
+	attribute: "required-selection",
+	mode: "fromView"
+})], Listbox.prototype, "requiredSelection", void 0);
+__decorate([observable], Listbox.prototype, "_activeDescendantId", void 0);
+__decorate([observable], Listbox.prototype, "values", void 0);
+//#endregion
+//#region src/lib/listbox/listbox.scss?inline
+var listbox_default = ":host{outline:none;flex-direction:column;gap:2px;display:flex}:host(:not(:focus-visible)){--_suppressable-focus-shadow:none;--_suppressable-focus-outline:none;--_suppressable-focus-outline-offset:0}";
+//#endregion
+//#region src/lib/listbox/listbox.template.ts
+var listboxTemplate = (_context) => {
+	return html`<template
+		tabindex="0"
+		${applyHostSemantics({
+		role: "listbox",
+		ariaMultiSelectable: (x) => x.selectionMode === "multiple" ? "true" : void 0
+	})}
+		aria-activedescendant="${(x) => x._activeDescendantId}"
+		@click="${(x, c) => x._onClick(c.event)}"
+		@keydown="${(x, c) => x._onKeydown(c.event)}"
+		>${optionsTemplate}${when((x) => x.searchText !== "" && x._filteredOptions.length === 0, html`<slot name="no-matches"></slot>`)}</template
+	>`;
 };
 //#endregion
-//#region src/lib/nav-item/definition.ts
+//#region src/lib/listbox/definition.ts
 /** @internal */
-var navItemDefinition = defineVividComponent("nav-item", NavItem, NavItemTemplate, [iconDefinition], {
-	styles: nav_item_default,
-	shadowOptions: { delegatesFocus: true }
-});
+var listboxDefinition = defineVividComponent("listbox", Listbox, listboxTemplate, [], { styles: listbox_default });
 /**
-* Registers the nav-item elements with the design system.
+* Registers the listbox elements with the design system.
 *
 * @param prefix - the prefix to use for the component name
 */
-var registerNavItem = createRegisterFunction(navItemDefinition);
+var registerListbox = createRegisterFunction(listboxDefinition);
 //#endregion
-export { registerNavItem as n, NavItem as r, navItemDefinition as t };
+export { registerListbox as n, Listbox as r, listboxDefinition as t };