@vonage/vivid 5.17.0 → 5.19.0

package/unbundled/definition51.cjs

@@ -1,337 +1,377 @@
 require("./chunk.cjs");
 const require_vivid_element = require("./vivid-element.cjs");
-const require_definition = require("./definition2.cjs");
+const require_definition = require("./definition.cjs");
+const require_definition$1 = require("./definition2.cjs");
 const require_decorate = require("./decorate.cjs");
+const require_affix = require("./affix.cjs");
 const require_delegates_aria = require("./delegates-aria.cjs");
+const require_form_associated = require("./form-associated.cjs");
+const require_form_element = require("./form-element.cjs");
+const require_with_success_text = require("./with-success-text.cjs");
+const require_with_error_text = require("./with-error-text.cjs");
+const require_with_contextual_help = require("./with-contextual-help.cjs");
 const require_localized = require("./localized.cjs");
-const require_definition$1 = require("./definition7.cjs");
-const require_definition$2 = require("./definition8.cjs");
+const require_definition$2 = require("./definition7.cjs");
+const require_enums = require("./enums.cjs");
+const require_divider = require("./divider.cjs");
+const require_mixins = require("./mixins.cjs");
+const require_definition$3 = require("./definition25.cjs");
+const require_definition$4 = require("./definition36.cjs");
 let _microsoft_fast_element = require("@microsoft/fast-element");
 let _microsoft_fast_web_utilities = require("@microsoft/fast-web-utilities");
-let _floating_ui_dom = require("@floating-ui/dom");
-//#region src/lib/popover/popover.scss?inline
-var popover_default = ":host{display:inline-block}.base{white-space:initial;--scrollbar-track-color:transparent;--scrollbar-thumb-color:color-mix(in srgb, var(--vvd-color-neutral-950), transparent 70%);scrollbar-color:var(--scrollbar-thumb-color) var(--scrollbar-track-color);scrollbar-width:thin}.base ::-webkit-scrollbar{width:4px}.base ::-webkit-scrollbar-track{background:var(--scrollbar-track-color)}.base ::-webkit-scrollbar-thumb{background-color:var(--scrollbar-fallback-track-color,var(--scrollbar-thumb-color));border:0;border-radius:4px}.base{border:none;border-radius:8px;inline-size:max-content;min-inline-size:fit-content;margin:0;padding:0;position:fixed;overflow:visible}.base:focus-visible{outline:none}.base::backdrop{background-color:var(--popover-backdrop-bg,transparent)}.control{padding:var(--popover-padding,24px);border-radius:inherit;background:var(--vvd-color-surface-4dp);color:var(--vvd-color-canvas-text);gap:var(--popover-gap,24px);flex-direction:column;display:flex}.control:not(.open){display:none}.control.condensed{--popover-padding:12px;--popover-gap:12px}.control.manual{padding-block-start:40px}.arrow{z-index:-1;background:var(--vvd-color-surface-4dp);width:8px;height:8px;position:absolute;transform:rotate(45deg)}.dismiss-button{position:absolute;inset-block-start:4px;inset-inline-end:4px}";
+//#region src/lib/number-field/number-field.scss?inline
+var number_field_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}:host{display:inline-block}.base{--_appearance-color-text:var(--vvd-color-canvas-text);--_appearance-color-fill:var(--vvd-color-canvas);--_appearance-color-outline:var(--vvd-color-neutral-500)}.base.appearance-ghost{--_appearance-color-text:var(--_connotation-color-firm);--_appearance-color-fill:transparent;--_appearance-color-outline:transparent}@media (hover:hover){.base: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)}.base: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}}.base.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)}.base.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}.base:disabled{--_appearance-color-text:var(--vvd-color-neutral-600);--_appearance-color-fill:var(--vvd-color-neutral-100);--_appearance-color-outline:var(--vvd-color-neutral-300)}.base:disabled.appearance-ghost{--_appearance-color-text:var(--vvd-color-neutral-300);--_appearance-color-fill:transparent;--_appearance-color-outline:transparent}.base.disabled{--_appearance-color-text:var(--vvd-color-neutral-600);--_appearance-color-fill:var(--vvd-color-neutral-100);--_appearance-color-outline:var(--vvd-color-neutral-300)}.base.disabled.appearance-ghost{--_appearance-color-text:var(--vvd-color-neutral-300);--_appearance-color-fill:transparent;--_appearance-color-outline:transparent}.base.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)}.base.readonly:where(:not(.disabled,:disabled)).appearance-ghost{--_appearance-color-text:var(--vvd-color-neutral-600);--_appearance-color-fill:transparent;--_appearance-color-outline:transparent}.base.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)}.base.error:where(:not(.disabled,:disabled)).appearance-ghost{--_appearance-color-text:notSet;--_appearance-color-fill:var(--vvd-color-alert-50);--_appearance-color-outline:transparent}.base.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)}.base.success:where(:not(.disabled,:disabled)).appearance-ghost{--_appearance-color-text:notSet;--_appearance-color-fill:var(--vvd-color-success-50);--_appearance-color-outline:transparent}.base{--_connotation-color-primary:var(--vvd-text-field-accent-primary,var(--vvd-color-canvas-text));--_connotation-color-primary-text:var(--vvd-text-field-accent-primary-text,var(--vvd-color-canvas));--_connotation-color-primary-increment:var(--vvd-text-field-accent-primary-increment,var(--vvd-color-neutral-800));--_connotation-color-intermediate:var(--vvd-text-field-accent-intermediate,var(--vvd-color-neutral-500));--_connotation-color-firm:var(--vvd-text-field-accent-firm,var(--vvd-color-canvas-text));--_connotation-color-fierce:var(--vvd-text-field-accent-fierce,var(--vvd-color-neutral-700));--_connotation-color-faint:var(--vvd-text-field-accent-faint,var(--vvd-color-neutral-50));--_connotation-color-soft:var(--vvd-text-field-accent-soft,var(--vvd-color-neutral-100));--_text-field-gutter-start:calc(calc(1px * (40 + 4 * clamp(-1, var(--vvd-size-density,0), 2))) / 2.5);--_text-field-gutter-end:calc(calc(1px * (40 + 4 * clamp(-1, var(--vvd-size-density,0), 2))) / 2.5);--_text-field-icon-size:calc(calc(1px * (40 + 4 * clamp(-1, var(--vvd-size-density,0), 2))) / 2);--_text-field-block-size:calc(1px * (40 + 4 * clamp(-1, var(--vvd-size-density,0), 2)));--_text-field-border-radius:8px;--_text-field-pill-border-radius:24px;grid-template-columns:min-content 1fr max-content;align-items:center;gap:4px;width:100%;display:inline-grid}.base.size-condensed{--_text-field-gutter-start:calc(calc(1px * (40 + 4 * clamp(-1, var(--vvd-size-density,0), 2) - 16)) / 2);--_text-field-gutter-end:calc(calc(1px * (40 + 4 * clamp(-1, var(--vvd-size-density,0), 2) - 16)) / 2);--_text-field-icon-size:calc(calc(1px * (40 + 4 * clamp(-1, var(--vvd-size-density,0), 2) - 8)) / 2);--_text-field-block-size:calc(1px * (40 + 4 * clamp(-1, var(--vvd-size-density,0), 2) - 8));--_text-field-border-radius:4px}@supports (user-select:none){.base{user-select:none}}.base:not(.disabled){--_low-ink-color:var(--vvd-color-neutral-600)}.base.disabled{--_low-ink-color:var(--_appearance-color-text)}.label:not(slot),.label::slotted(label){font:var(--vvd-typography-base);grid-area:1/1/auto/4;box-sizing:initial!important;padding:initial!important;margin:initial!important;color:var(--vvd-color-canvas-text)!important}.char-count+.label:not(slot),.char-count+.label::slotted(label){grid-column:1/3}.char-count{color:var(--_low-ink-color);font:var(--vvd-typography-base)}.label-wrapper{grid-area:1/1/auto/4}.char-count+.label-wrapper{grid-column:1/3}.fieldset{background-color:var(--_appearance-color-fill);font:var(--vvd-typography-base);grid-column:1/4;align-items:center;padding-block:0;transition:color .2s,background-color .2s;display:flex;position:relative}.fieldset:after{border-radius:inherit;block-size:100%;box-shadow:inset 0 0 0 1px var(--_appearance-color-outline);content:\"\";pointer-events:none;inline-size:100%;transition:box-shadow .2s;display:block;position:absolute}.fieldset:focus-visible{outline:none}.base>.fieldset{block-size:var(--_text-field-block-size)}.base:not(.shape-pill) .fieldset{border-radius:var(--_text-field-border-radius)}.base.shape-pill .fieldset{border-radius:var(--_text-field-pill-border-radius)}.wrapper{border-radius:inherit;block-size:100%;inline-size:100%}.control{border-radius:inherit;text-align:start}.control:not(slot),.control::slotted(input){font:inherit;text-align:inherit;outline:#0000;box-sizing:border-box!important;border-radius:inherit!important;width:100%!important;margin:initial!important;appearance:none!important;block-size:100%!important;color:inherit!important;padding-block:0!important;padding-inline:var(--_text-field-gutter-start) var(--_text-field-gutter-end)!important;background-color:#0000!important;border:0!important}.control:not(slot):disabled,.control::slotted(input:disabled){cursor:not-allowed!important;opacity:1!important;-webkit-text-fill-color:var(--_appearance-color-text)!important}.control:not(slot)::placeholder{opacity:1!important;-webkit-text-fill-color:var(--_low-ink-color)!important}.control::slotted(input:-webkit-autofill){-webkit-box-shadow:0 0 0 1000px var(--_appearance-color-fill) inset;-webkit-text-fill-color:var(--_appearance-color-text)!important}.control:not(slot):-webkit-autofill{-webkit-box-shadow:0 0 0 1000px var(--_appearance-color-fill) inset;-webkit-text-fill-color:var(--_appearance-color-text)!important}.has-icon .control:not(slot),.has-icon .control::slotted(input){padding-inline-start:calc(var(--_text-field-icon-size) + var(--_text-field-gutter-start) * 2)!important}.icon{z-index:1;color:var(--_low-ink-color);font-size:var(--_text-field-icon-size);line-height:1;position:absolute;inset-block-start:50%;inset-inline-start:calc(100% + var(--_text-field-gutter-start));transform:translateY(-50%)}.leading-items-wrapper{position:relative}.base.no-leading .leading-items-wrapper{display:none}.action-items-wrapper{margin-inline-end:4px}.base:not(.action-items) .action-items-wrapper{display:none}@supports selector(:has(*)){.base:not(.has-activedescendant) .fieldset:has(.wrapper .control:focus-within):after{--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(*)){.base:not(.has-activedescendant) .wrapper:focus-within: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));--focus-stroke-gap-color:transparent;z-index:1;border-radius:inherit;content:\"\";pointer-events:none;display:block;position:absolute;inset:0}}:host([internal-part]) .fieldset{font:var(--vvd-typography-heading-4);background-color:#0000;line-height:1.1}:host([internal-part]) .fieldset:not(:focus-within):after{block-size:1px;inset-block-end:0}@supports selector(:has(*)){:host([internal-part]) .fieldset:has(.action-items-wrapper:focus-within):after{block-size:1px;inset-block-end:0}}:host([internal-part]) .control{text-align:center}slot[name=_mirrored-helper-text]{display:none}.base{--_text-field-gutter-end:70px}.control::-webkit-outer-spin-button{appearance:none}.control::-webkit-inner-spin-button{appearance:none}.control-buttons{z-index:1;display:flex;position:absolute;right:3px}.readonly .control-buttons,.disabled .control-buttons{pointer-events:none}.control-buttons .divider{margin-block:8px}.control-buttons>*{flex-shrink:0}";
 //#endregion
-//#region src/lib/popover/popover.ts
+//#region src/lib/number-field/number-field.ts
+var STEP_DIRECTION = {
+	up: 1,
+	down: -1
+};
+function makeStep(element, direction) {
+	const value = parseFloat(element.value);
+	const stepUpValue = !isNaN(value) ? value + direction * element.step : element.min > 0 ? element.min : element.max < 0 ? element.max : !element.min ? direction * element.step : 0;
+	element.value = Number(stepUpValue.toFixed(12)).toString();
+	element._updatedValueAnnouncement = element.locale.numberField.updatedValueAnnouncement(element._presentationValue);
+}
+var buildNumberPatterns = (decimalSeparator) => {
+	const ds = decimalSeparator.source;
+	return {
+		invalidCharacters: new RegExp(`[^0-9\\-+e${ds}]`, "g"),
+		additionalDecimalSeparators: new RegExp(`(?<=${ds}.*)${ds}`, "g"),
+		trailingDecimalSeparator: new RegExp(`${ds}$`),
+		decimalSeparator
+	};
+};
+var numberPatternsWithPeriod = buildNumberPatterns(/\./);
+var numberPatternsWithComma = buildNumberPatterns(/,/);
+var validNumber = /^-?((\d*\.\d+)|(\d+))$/;
 /**
 * @public
-* @component popover
-* @slot - Default slot for the popover content.
-* @slot anchor - Slot for the trigger element.
-* @slot footer - Use the footer slot in order to add action buttons or other contents to the bottom of the dialog.
-* @event {CustomEvent} open - Fired when the popover opens.
-* @event {CustomEvent} close - Fired when the popover closes.
+* @component number-field
+* @slot helper-text - Describes how to use the number-field. Alternative to the `helper-text` attribute.
+* @event {CustomEvent<undefined>} input - Fires a custom 'input' event when the value has changed
+* @event {CustomEvent<undefined>} change - Fires a custom 'change' event when the value has changed
+* @vueModel modelValue value input,@lazy:change `event.currentTarget.value`
+* @vueModel valueAsNumber valueAsNumber input,@lazy:change `event.currentTarget.valueAsNumber`
+* @testAction fill fill #control
+* @testAction clear clear #control
+* @testAction clickIncrement clickButton #incrementButton
+* @testAction clickDecrement clickButton #decrementButton
+* @testQuery valueAsNumber valueAsNumber
+* @testRef control shadow input.control
+* @testRef incrementButton shadowButton #add
+* @testRef decrementButton shadowButton #subtract
 */
-var Popover = class extends require_localized.Localized(require_delegates_aria.DelegatesAria(require_vivid_element.VividElement)) {
+var NumberField = class extends require_with_contextual_help.WithContextualHelp(require_mixins.WithFeedback(require_with_error_text.WithErrorText(require_with_success_text.WithSuccessText(require_form_element.FormElement(require_affix.AffixIcon(require_localized.Localized(require_delegates_aria.DelegatesAria(require_form_associated.FormAssociated(require_vivid_element.VividElement))))))))) {
 	constructor(..._args) {
 		super(..._args);
-		this.placement = "bottom";
-		this.manual = false;
-		this.layout = "default";
-		this.offset = 8;
-		this.alternate = false;
-		this.dismissButtonAriaLabel = null;
-		this.arrow = false;
-		this.open = false;
+		this.proxy = document.createElement("input");
+		this.readOnly = false;
+		this.autofocus = false;
+		this.step = 1;
+		this.isUserInput = false;
+		this._presentationValue = "";
+		this._updatedValueAnnouncement = "";
+		this.incrementButtonAriaLabel = null;
+		this.decrementButtonAriaLabel = null;
 	}
-	/**
-	* @internal
-	*/
-	placementChanged() {
-		this.#updateAutoUpdate();
+	stepChanged(_, next) {
+		this.proxy.setAttribute("step", Number.isFinite(next) ? next.toString() : "");
 	}
 	/**
+	* Ensures that the max is greater than the min and that the value
+	*  is less than the max
+	*
 	* @internal
 	*/
-	arrowChanged() {
-		this.#updateAutoUpdate();
+	maxChanged(_, next) {
+		this.max = Math.max(next, this.min ?? next);
+		this.proxy.max = this.max.toString();
+		this.validate();
 	}
 	/**
+	* Ensures that the min is less than the max and that the value
+	*  is greater than the min
+	*
 	* @internal
 	*/
-	openChanged(_oldValue, newValue) {
-		if (!this._popoverEl) return;
-		const isOpen = this._popoverEl.matches(":popover-open");
-		if (newValue && !isOpen) this._popoverEl.showPopover();
-		else if (!newValue && isOpen) this._popoverEl.hidePopover();
-		this.#updateAutoUpdate();
+	minChanged(_, next) {
+		this.min = Math.min(next, this.max ?? next);
+		this.proxy.min = this.min.toString();
+		this.validate();
 	}
 	/**
-	* @internal
+	* The value property, typed as a number.
+	*
+	* @public
 	*/
-	anchorChanged() {
-		this.#updateAnchor();
+	get valueAsNumber() {
+		return parseFloat(this.value);
 	}
-	/**
-	* @internal
-	*/
-	_slottedAnchorChanged() {
-		this.#updateAnchor();
+	set valueAsNumber(next) {
+		this.value = next.toString();
 	}
 	/**
 	* @internal
 	*/
-	#currentAnchor = null;
-	/**
-	* @internal
-	*/
-	#updateAnchor() {
-		if (!this._popoverEl) return;
-		const newAnchor = this.anchor || this._slottedAnchor?.[0] || null;
-		if (this.#currentAnchor === newAnchor) return;
-		if (this.#currentAnchor) this.#unbindTrigger(this.#currentAnchor);
-		this.#currentAnchor = newAnchor;
-		if (this.#currentAnchor && this._popoverEl) {
-			this.#bindTrigger(this.#currentAnchor);
-			this.#updateAutoUpdate();
+	valueChanged(previous, next) {
+		this.value = validNumber.test(next) ? next : "";
+		if (next !== this.value) return;
+		if (this.control && !this.isUserInput) this._presentationValue = this.#valueToPresentationValue(this.value);
+		super.valueChanged(previous, this.value);
+		if (previous !== void 0 && !this.isUserInput) {
+			this.$emit("input");
+			this.$emit("change");
 		}
 	}
 	/**
 	* @internal
 	*/
-	#bindTrigger(anchor) {
-		anchor.setAttribute("aria-haspopup", "dialog");
-		if (anchor instanceof HTMLButtonElement || anchor instanceof HTMLInputElement) anchor.popoverTargetElement = this._popoverEl;
-		else anchor.addEventListener("click", this.#manualToggle);
+	get _numberPatterns() {
+		return this.locale.common.useCommaAsDecimalSeparator ? numberPatternsWithComma : numberPatternsWithPeriod;
 	}
-	/**
-	* @internal
-	*/
-	#unbindTrigger(anchor) {
-		anchor.removeAttribute("aria-haspopup");
-		if (anchor instanceof HTMLButtonElement || anchor instanceof HTMLInputElement) anchor.popoverTargetElement = null;
-		else anchor.removeEventListener("click", this.#manualToggle);
+	#valueToPresentationValue(value) {
+		return value.replace(".", this.locale.common.useCommaAsDecimalSeparator ? "," : ".");
 	}
-	/**
-	* @internal
-	*/
-	#manualToggle = () => {
-		this._popoverEl.togglePopover();
-	};
-	/**
-	* @internal
-	*/
-	get #middleware() {
-		let middleware = [
-			(0, _floating_ui_dom.inline)(),
-			(0, _floating_ui_dom.flip)(),
-			(0, _floating_ui_dom.shift)(),
-			(0, _floating_ui_dom.hide)()
-		];
-		/* v8 ignore next -- @preserve */
-		let offsetValue = this.offset ?? 0;
-		if (this.arrow && this._arrowEl) {
-			offsetValue = 12;
-			middleware = [...middleware, (0, _floating_ui_dom.arrow)({
-				element: this._arrowEl,
-				padding: 10
-			})];
-		}
-		/* v8 ignore else -- @preserve */
-		if (offsetValue > 0) middleware.unshift((0, _floating_ui_dom.offset)(offsetValue));
-		return middleware;
+	#inputToPresentationValue(input) {
+		return input.replace(this._numberPatterns.invalidCharacters, "").replace(this._numberPatterns.additionalDecimalSeparators, "");
+	}
+	#presentationValueToValue(presentationValue) {
+		const candidate = presentationValue.replace(this._numberPatterns.trailingDecimalSeparator, "").replace(this._numberPatterns.decimalSeparator, ".");
+		return validNumber.test(candidate) ? candidate : "";
+	}
+	/** {@inheritDoc (FormAssociated:interface).validate} */
+	validate() {
+		super.validate(this.control);
 	}
 	/**
-	* @internal
-	*/
-	#cleanup;
-	/**
-	* @internal
+	* Increments the value using the step value
+	*
+	* @public
 	*/
-	#updateAutoUpdate() {
-		this.#cleanup?.();
-		if (this.open && this.#currentAnchor && this._popoverEl) this.#cleanup = (0, _floating_ui_dom.autoUpdate)(this.#currentAnchor, this._popoverEl, this.#autoUpdateCallback);
+	stepUp() {
+		makeStep(this, STEP_DIRECTION.up);
 	}
 	/**
-	* Tracks the promise of the last position update.
-	* @internal
+	* Decrements the value using the step value
+	*
+	* @public
 	*/
-	#lastPositionUpdate;
+	stepDown() {
+		makeStep(this, STEP_DIRECTION.down);
+	}
 	/**
+	* Sets up the initial state of the number field
 	* @internal
 	*/
-	#autoUpdateCallback = () => {
-		this.#lastPositionUpdate = this.updatePosition();
-	};
+	connectedCallback() {
+		super.connectedCallback();
+		this.proxy.setAttribute("type", "number");
+		this.validate();
+		this._presentationValue = this.#valueToPresentationValue(this.value);
+		if (this.autofocus) _microsoft_fast_element.Updates.enqueue(() => {
+			this.focus();
+		});
+	}
 	/**
-	* Updates the position of the popover
+	* Selects all the text in the number field
+	*
 	* @public
 	*/
-	async updatePosition() {
-		/* v8 ignore if -- @preserve */
-		if (!this.open || !this.#currentAnchor || !this._popoverEl) return;
-		const positionData = await (0, _floating_ui_dom.computePosition)(this.#currentAnchor, this._popoverEl, {
-			placement: this.placement,
-			strategy: "fixed",
-			middleware: this.#middleware
-		});
-		/* v8 ignore if -- @preserve */
-		if (!this.open) return;
-		this.#assignPopoverPosition(positionData);
-		if (this.arrow && this._arrowEl) this.#assignArrowPosition(positionData);
+	select() {
+		this.control.select();
+		/**
+		* The select event does not permeate the shadow DOM boundary.
+		* This fn effectively proxies the select event,
+		* emitting a `select` event whenever the internal
+		* control emits a `select` event
+		*/
+		this.$emit("select");
 	}
 	/**
+	* Handles the internal control's `input` event
 	* @internal
 	*/
-	#assignPopoverPosition(data) {
-		const { x, y } = data;
-		Object.assign(this._popoverEl.style, {
-			left: `${x}px`,
-			top: `${y}px`,
-			visibility: data.middlewareData.hide?.referenceHidden ? "hidden" : "visible"
-		});
+	handleTextInput() {
+		this._presentationValue = this.#inputToPresentationValue(this.control.value);
+		if (this.control.value !== this._presentationValue) this.control.value = this._presentationValue;
+		this.isUserInput = true;
+		this.value = this.#presentationValueToValue(this._presentationValue);
+		this.isUserInput = false;
 	}
 	/**
+	* Change event handler for inner control.
+	* @remarks
+	* "Change" events are not `composable` so they will not
+	* permeate the shadow DOM boundary. This fn effectively proxies
+	* the change event, emitting a `change` event whenever the internal
+	* control emits a `change` event
 	* @internal
 	*/
-	#assignArrowPosition(data) {
-		/* v8 ignore if -- @preserve */
-		if (!this._arrowEl) return;
-		const { x: arrowX, y: arrowY } = data.middlewareData.arrow;
-		const styles = {
-			left: "calc(100% - 4px)",
-			right: "-4px",
-			top: "calc(100% - 4px)",
-			bottom: "-4px"
-		};
-		const staticAxis = data.placement.split("-")[0];
-		Object.assign(this._arrowEl.style, {
-			left: arrowX ? `${arrowX}px` : styles[staticAxis],
-			top: arrowY ? `${arrowY}px` : styles[staticAxis]
-		});
+	handleChange() {
+		this.$emit("change");
 	}
 	/**
-	* Syncs native toggle state (Esc key, light dismiss) back to the 'open' attribute.
+	* Handles the internal control's `keydown` event
 	* @internal
 	*/
-	#handleNativeToggle = (e) => {
-		const isOpen = e.newState ? e.newState === "open" : this._popoverEl.matches(":popover-open");
-		if (this.open !== isOpen) this.open = isOpen;
-		this.$emit(isOpen ? "open" : "close", void 0, { bubbles: false });
-	};
-	connectedCallback() {
-		super.connectedCallback();
-		this.#updateAnchor();
-		/* v8 ignore else -- @preserve */
-		if (this._popoverEl) {
-			this._popoverEl.addEventListener("toggle", this.#handleNativeToggle);
-			if (this.open && !this._popoverEl.matches(":popover-open")) {
-				this._popoverEl.showPopover();
-				this.#updateAutoUpdate();
-			}
-		}
-	}
-	disconnectedCallback() {
-		super.disconnectedCallback();
-		this.#cleanup?.();
-		if (this.#currentAnchor) {
-			this.#unbindTrigger(this.#currentAnchor);
-			this.#currentAnchor = null;
+	handleKeyDown(e) {
+		switch (e.key) {
+			case _microsoft_fast_web_utilities.keyArrowUp:
+				this.stepUp();
+				return false;
+			case _microsoft_fast_web_utilities.keyArrowDown:
+				this.stepDown();
+				return false;
 		}
-		/* v8 ignore else -- @preserve */
-		if (this._popoverEl) this._popoverEl.removeEventListener("toggle", this.#handleNativeToggle);
-	}
-	show() {
-		this.open = true;
-		return this.#lastPositionUpdate ?? Promise.resolve();
-	}
-	hide() {
-		this.open = false;
-	}
-	toggle() {
-		this.open = !this.open;
+		return true;
 	}
 };
-require_decorate.__decorate([(0, _microsoft_fast_element.attr)({ mode: "fromView" })], Popover.prototype, "placement", void 0);
-require_decorate.__decorate([(0, _microsoft_fast_element.attr)({ mode: "boolean" })], Popover.prototype, "manual", void 0);
-require_decorate.__decorate([(0, _microsoft_fast_element.attr)({ mode: "fromView" })], Popover.prototype, "layout", void 0);
 require_decorate.__decorate([(0, _microsoft_fast_element.attr)({
-	attribute: "offset",
-	mode: "fromView",
-	converter: _microsoft_fast_element.nullableNumberConverter
-})], Popover.prototype, "offset", void 0);
-require_decorate.__decorate([(0, _microsoft_fast_element.attr)({ mode: "boolean" })], Popover.prototype, "alternate", void 0);
-require_decorate.__decorate([(0, _microsoft_fast_element.attr)({ attribute: "dismiss-button-aria-label" })], Popover.prototype, "dismissButtonAriaLabel", void 0);
-require_decorate.__decorate([(0, _microsoft_fast_element.attr)({ mode: "boolean" })], Popover.prototype, "arrow", void 0);
-require_decorate.__decorate([(0, _microsoft_fast_element.attr)({ mode: "boolean" })], Popover.prototype, "open", void 0);
-require_decorate.__decorate([_microsoft_fast_element.observable], Popover.prototype, "anchor", void 0);
-require_decorate.__decorate([_microsoft_fast_element.observable], Popover.prototype, "_slottedAnchor", void 0);
+	attribute: "readonly",
+	mode: "boolean"
+})], NumberField.prototype, "readOnly", void 0);
+require_decorate.__decorate([(0, _microsoft_fast_element.attr)({ mode: "boolean" })], NumberField.prototype, "autofocus", void 0);
+require_decorate.__decorate([_microsoft_fast_element.attr], NumberField.prototype, "placeholder", void 0);
+require_decorate.__decorate([_microsoft_fast_element.attr], NumberField.prototype, "list", void 0);
+require_decorate.__decorate([(0, _microsoft_fast_element.attr)({ converter: _microsoft_fast_element.nullableNumberConverter })], NumberField.prototype, "maxlength", void 0);
+require_decorate.__decorate([(0, _microsoft_fast_element.attr)({ converter: _microsoft_fast_element.nullableNumberConverter })], NumberField.prototype, "minlength", void 0);
+require_decorate.__decorate([(0, _microsoft_fast_element.attr)({ converter: _microsoft_fast_element.nullableNumberConverter })], NumberField.prototype, "size", void 0);
+require_decorate.__decorate([(0, _microsoft_fast_element.attr)()], NumberField.prototype, "scale", void 0);
+require_decorate.__decorate([(0, _microsoft_fast_element.attr)({ converter: _microsoft_fast_element.nullableNumberConverter })], NumberField.prototype, "step", void 0);
+require_decorate.__decorate([(0, _microsoft_fast_element.attr)({ converter: _microsoft_fast_element.nullableNumberConverter })], NumberField.prototype, "max", void 0);
+require_decorate.__decorate([(0, _microsoft_fast_element.attr)({ converter: _microsoft_fast_element.nullableNumberConverter })], NumberField.prototype, "min", void 0);
+require_decorate.__decorate([_microsoft_fast_element.observable], NumberField.prototype, "defaultSlottedNodes", void 0);
+require_decorate.__decorate([_microsoft_fast_element.observable], NumberField.prototype, "_presentationValue", void 0);
+require_decorate.__decorate([_microsoft_fast_element.observable], NumberField.prototype, "_updatedValueAnnouncement", void 0);
+require_decorate.__decorate([(0, _microsoft_fast_element.attr)({ attribute: "increment-button-aria-label" })], NumberField.prototype, "incrementButtonAriaLabel", void 0);
+require_decorate.__decorate([(0, _microsoft_fast_element.attr)({ attribute: "decrement-button-aria-label" })], NumberField.prototype, "decrementButtonAriaLabel", void 0);
+require_decorate.__decorate([_microsoft_fast_element.attr], NumberField.prototype, "appearance", void 0);
+require_decorate.__decorate([_microsoft_fast_element.attr], NumberField.prototype, "shape", void 0);
+require_decorate.__decorate([_microsoft_fast_element.attr], NumberField.prototype, "autoComplete", void 0);
 //#endregion
-//#region src/lib/popover/popover.template.ts
-var getClasses = ({ open, manual, layout }) => (0, _microsoft_fast_web_utilities.classNames)("control", ["open", Boolean(open)], ["manual", Boolean(manual)], ["condensed", layout === "condensed"]);
+//#region src/lib/number-field/number-field.template.ts
+var getStateClasses = ({ errorValidationMessage, disabled, value, readOnly, placeholder, appearance, shape, label, successText, scale }) => (0, _microsoft_fast_web_utilities.classNames)(["error", Boolean(errorValidationMessage)], ["disabled", disabled], ["has-value", Boolean(value)], ["readonly", readOnly], ["placeholder", Boolean(placeholder)], [`appearance-${appearance}`, Boolean(appearance)], [`shape-${shape}`, Boolean(shape)], ["no-label", !label], ["success", !!successText], [`size-${scale}`, Boolean(scale)]);
+function renderLabel() {
+	return _microsoft_fast_element.html` <label for="control" class="label">
+		${(x) => x.label}
+	</label>`;
+}
+function setControlButtonShape(numberField) {
+	return numberField.shape === require_enums.Shape.Pill ? require_enums.Shape.Pill : null;
+}
+function getTabIndex(numberField) {
+	return numberField.disabled || numberField.readOnly ? "-1" : null;
+}
 /**
-* The template for the Popover component.
-*
 * @param context - element definition context
-* @public
 */
-var popoverTemplate = (context) => {
-	const elevationTag = context.tagFor(require_definition$2.Elevation);
-	const buttonTag = context.tagFor(require_definition$1.Button);
-	const iconTag = context.tagFor(require_definition.Icon);
+function numberControlButtons(context) {
+	const buttonTag = context.tagFor(require_definition$2.Button);
+	const dividerTag = context.tagFor(require_divider.Divider);
+	return _microsoft_fast_element.html`
+		<div class="control-buttons" ?inert="${(x) => x.disabled || x.readOnly}">
+			<${buttonTag} id="subtract" icon="minus-line"
+				?disabled="${(x) => x.disabled || x.readOnly}"
+				aria-label=${(x) => x.decrementButtonAriaLabel || x.locale.numberField.decrementButtonLabel(x.step)}
+				shape="${setControlButtonShape}"
+				type="button"
+				size="${(x) => x.scale === "condensed" ? "super-condensed" : "condensed"}"
+				tabindex="${getTabIndex}"
+				@click="${(x) => x.stepDown()}"></${buttonTag}>
+			<${dividerTag} class="divider" orientation="vertical"></${dividerTag}>
+			<${buttonTag} id="add" icon="plus-line"
+				?disabled="${(x) => x.disabled || x.readOnly}"
+				aria-label=${(x) => x.incrementButtonAriaLabel || x.locale.numberField.incrementButtonLabel(x.step)}
+				shape="${setControlButtonShape}"
+				type="button"
+				size="${(x) => x.scale === "condensed" ? "super-condensed" : "condensed"}"
+				tabindex="${getTabIndex}"
+				@click="${(x) => x.stepUp()}"></${buttonTag}>
+			</div>
+	`;
+}
+var NumberFieldTemplate = (context) => {
+	const visuallyHiddenTag = context.tagFor(require_definition.VisuallyHidden);
 	return _microsoft_fast_element.html`
-		<slot name="anchor" ${(0, _microsoft_fast_element.slotted)("_slottedAnchor")}></slot>
-		<${elevationTag}>
-			<div class="base" 
-				${(0, _microsoft_fast_element.ref)("_popoverEl")} 
-				popover="${(x) => x.manual ? "manual" : "auto"}"
-				tabindex="-1"
-				autofocus
-				${require_delegates_aria.delegateAria({
-		role: "dialog",
-		ariaModal: "false"
-	})}
-			>
-				<div class="${getClasses}" 
-					part="${(x) => x.alternate ? "vvd-theme-alternate" : ""}">
-					<slot></slot>
-					<slot name="footer"></slot>
-					${(0, _microsoft_fast_element.when)((x) => x.manual, _microsoft_fast_element.html`<${buttonTag}
-							aria-label="${(x) => x.dismissButtonAriaLabel || x.locale.popover.dismissButtonLabel}"
-							type="button"
-							size="condensed"
-							class="dismiss-button"
-							@click="${(x) => x.hide()}">
-							<${iconTag} name="close-line" slot="icon"></${iconTag}>
-						</${buttonTag}>`)}
-					${(0, _microsoft_fast_element.when)((x) => x.arrow, _microsoft_fast_element.html`<div class="arrow" ${(0, _microsoft_fast_element.ref)("_arrowEl")}></div>`)}
+		<div class="base ${getStateClasses}">
+			<div class="label-wrapper" ?hidden=${(x) => !x.label && !x._hasContextualHelp}>
+				${(0, _microsoft_fast_element.when)((x) => x.label, renderLabel())}
+				<slot name="contextual-help" ${(0, _microsoft_fast_element.slotted)("_contextualHelpSlottedContent")}></slot>
+			</div>
+			<div class="fieldset">
+				<div class="wrapper">
+					<input
+						class="control"
+						id="control"
+						@input="${(x) => x.handleTextInput()}"
+						@change="${(x) => x.handleChange()}"
+						@keydown="${(x, c) => x.handleKeyDown(c.event)}"
+						?autofocus="${(x) => x.autofocus}"
+						?disabled="${(x) => x.disabled}"
+						list="${(x) => x.list}"
+						maxlength="${(x) => x.maxlength}"
+						minlength="${(x) => x.minlength}"
+						placeholder="${(x) => x.placeholder}"
+						?readonly="${(x) => x.readOnly}"
+						?required="${(x) => x.required}"
+						size="${(x) => x.size}"
+						autocomplete="${(x) => x.autoComplete}"
+						name="${(x) => x.name}"
+						?spellcheck="${(x) => x.spellcheck}"
+						:value="${(x) => x._presentationValue}"
+						type="text"
+						aria-describedby="${(x) => x._feedbackDescribedBy}"
+						${require_delegates_aria.delegateAria()}
+						${(0, _microsoft_fast_element.ref)("control")}
+					/>
 				</div>
+				${() => numberControlButtons(context)}
 			</div>
-		</${elevationTag}>
+			${(x) => x._getFeedbackTemplate(context)}
+			<${visuallyHiddenTag} id="value-announcement" role="status" aria-atomic="true">
+				${(x) => x._updatedValueAnnouncement}</${visuallyHiddenTag}>
+		</div>
 	`;
 };
 //#endregion
-//#region src/lib/popover/definition.ts
-var popoverDefinition = require_vivid_element.defineVividComponent("popover", Popover, popoverTemplate, [
-	require_definition$1.buttonDefinition,
-	require_definition.iconDefinition,
-	require_definition$2.elevationDefinition
+//#region src/lib/number-field/definition.ts
+/**
+* @internal
+*/
+var numberFieldDefinition = require_vivid_element.defineVividComponent("number-field", NumberField, NumberFieldTemplate, [
+	require_definition$2.buttonDefinition,
+	require_definition$4.dividerDefinition,
+	require_definition$1.iconDefinition,
+	require_mixins.feedbackMessageDefinition,
+	require_definition.visuallyHiddenDefinition,
+	require_definition$3.contextualHelpDefinition
 ], {
-	styles: popover_default,
+	styles: number_field_default,
 	shadowOptions: { delegatesFocus: true }
 });
 /**
-* Registers the popover element with the design system.
+* Registers the number-field elements with the design system.
 *
 * @param prefix - the prefix to use for the component name
 */
-var registerPopover = require_vivid_element.createRegisterFunction(popoverDefinition);
+var registerNumberField = require_vivid_element.createRegisterFunction(numberFieldDefinition);
 //#endregion
-Object.defineProperty(exports, "Popover", {
+Object.defineProperty(exports, "NumberField", {
 	enumerable: true,
 	get: function() {
-		return Popover;
+		return NumberField;
 	}
 });
-Object.defineProperty(exports, "popoverDefinition", {
+Object.defineProperty(exports, "numberFieldDefinition", {
 	enumerable: true,
 	get: function() {
-		return popoverDefinition;
+		return numberFieldDefinition;
 	}
 });
-Object.defineProperty(exports, "registerPopover", {
+Object.defineProperty(exports, "registerNumberField", {
 	enumerable: true,
 	get: function() {
-		return registerPopover;
+		return registerNumberField;
 	}
 });