@vonage/vivid 5.23.1-preview.0 → 5.24.0

package/unbundled/definition9.js

@@ -1,167 +1,226 @@
 import { d as createRegisterFunction, t as VividElement, u as defineVividComponent } from "./vivid-element.js";
-import { t as iconDefinition } from "./definition.js";
 import { t as __decorate } from "./decorate.js";
-import { a as affixIconTemplateFactory, i as IconWrapper, r as IconAriaHidden, t as AffixIcon } from "./affix.js";
-import { t as Localized } from "./localized.js";
-import { i as Button, t as buttonDefinition } from "./definition7.js";
-import { r as Connotation } from "./enums.js";
-import { r as Elevation, t as elevationDefinition } from "./definition8.js";
-import { t as handleEscapeKeyAndStopPropogation } from "./dialog.js";
-import { attr, html, nullableNumberConverter, ref, when } from "@microsoft/fast-element";
+import { i as Button, t as buttonDefinition } from "./definition6.js";
+import { r as Elevation, t as elevationDefinition } from "./definition7.js";
+import { attr, html, nullableNumberConverter, observable, ref, when } from "@microsoft/fast-element";
 import { classNames } from "@microsoft/fast-web-utilities";
-//#region src/lib/alert/alert.scss?inline
-var alert_default = ".control{z-index:10;inline-size:max-content;max-inline-size:var(--alert-max-inline-size,fit-content);min-inline-size:var(--alert-min-inline-size,420px);border-radius:8px;margin-block:16px;margin-inline:auto;transition:opacity .15s cubic-bezier(0,0,.2,1),transform .15s cubic-bezier(0,0,.2,1);position:fixed;inset-block-end:0;inset-inline:0}@media (prefers-reduced-motion:reduce){.control{transition-duration:.01ms}}.control.placement-top,.control.placement-top-start,.control.placement-top-end{inset-block:0 auto}.control.placement-top-start,.control.placement-bottom-start{right:auto;margin-inline:16px;inset-inline-end:auto}.control.placement-top-end,.control.placement-bottom-end{margin-inline:16px;inset-inline-start:auto}.control:where(.strategy-static){inline-size:auto;margin:0;position:static}.control:not(.open){opacity:0;transform:scale(.8)}.control.open{opacity:1;transform:scale(1)}@media (width<=768px){.control{min-inline-size:var(--alert-min-inline-size,auto)}}.base.connotation-success{--_connotation-color-primary:var(--vvd-alert-success-primary,var(--vvd-color-success-500));--_connotation-color-primary-text:var(--vvd-alert-success-primary-text,var(--vvd-color-canvas))}.base.connotation-information{--_connotation-color-primary:var(--vvd-alert-information-primary,var(--vvd-color-information-500));--_connotation-color-primary-text:var(--vvd-alert-information-primary-text,var(--vvd-color-canvas))}.base.connotation-alert{--_connotation-color-primary:var(--vvd-alert-alert-primary,var(--vvd-color-alert-500));--_connotation-color-primary-text:var(--vvd-alert-alert-primary-text,var(--vvd-color-canvas))}.base.connotation-warning{--_connotation-color-primary:var(--vvd-alert-warning-primary,var(--vvd-color-warning-300));--_connotation-color-primary-text:var(--vvd-alert-warning-primary-text,var(--vvd-color-canvas-text))}.base.connotation-announcement{--_connotation-color-primary:var(--vvd-alert-announcement-primary,var(--vvd-color-announcement-500));--_connotation-color-primary-text:var(--vvd-alert-announcement-primary-text,var(--vvd-color-canvas))}.base:not(.connotation-success,.connotation-information,.connotation-alert,.connotation-warning,.connotation-announcement){--_connotation-color-primary:var(--vvd-alert-accent-primary,var(--vvd-color-canvas-text));--_connotation-color-primary-text:var(--vvd-alert-accent-primary-text,var(--vvd-color-canvas))}.base{--_appearance-color-text:var(--_connotation-color-primary-text);--_appearance-color-fill:var(--_connotation-color-primary);--_appearance-color-outline:transparent;background-color:var(--vvd-color-neutral-50);color:var(--vvd-color-canvas-text);border-radius:8px;align-items:center;column-gap:16px;padding:16px;display:flex}.base .alert-text{margin-inline-end:auto}.base .alert-text .headline{font:var(--vvd-typography-base-bold);margin-block:0 4px}.base .alert-text .main-text{font:var(--vvd-typography-base)}.base .alert-text .headline+::slotted([slot=main i]:first-child):before,.base .alert-text .main-text+::slotted([slot=main i]:first-child):before{content:\"\";margin-top:8px;display:block}.base slot[name=icon]{color:var(--_appearance-color-fill);flex-shrink:0;font-size:24px;line-height:1}.base .dismiss-button{border-left:1px solid var(--vvd-color-neutral-200);padding-inline-start:16px}";
-//#endregion
-//#region src/lib/alert/alert.ts
-var CONNOTATION_ICON_MAP = {
-	[Connotation.Accent]: "megaphone-line",
-	[Connotation.Information]: "info-line",
-	[Connotation.Success]: "check-circle-line",
-	[Connotation.Warning]: "warning-line",
-	[Connotation.Announcement]: "sparkles-line",
-	[Connotation.Alert]: "error-line"
+import { arrow, autoPlacement, autoUpdate, computePosition, flip, hide, inline, offset, shift, size } from "@floating-ui/dom";
+//#region src/lib/popup/popup.ts
+var PlacementStrategy = {
+	Flip: "flip",
+	AutoPlacementHorizontal: "auto-placement-horizontal",
+	AutoPlacementVertical: "auto-placement-vertical"
+};
+var placementStrategyMiddlewares = {
+	[PlacementStrategy.Flip]: flip(),
+	[PlacementStrategy.AutoPlacementHorizontal]: autoPlacement({ allowedPlacements: [
+		"bottom",
+		"top",
+		"bottom-start",
+		"bottom-end",
+		"top-start",
+		"top-end"
+	] }),
+	[PlacementStrategy.AutoPlacementVertical]: autoPlacement({ allowedPlacements: [
+		"left",
+		"right",
+		"left-start",
+		"left-end",
+		"right-start",
+		"right-end"
+	] })
 };
 /**
-* @public
-* @component alert
-* @slot main - The main content of the Alert.
-* @slot action-items - Add action items to the Alert using this slot.
-* @slot icon - The preferred way to add an icon to the component.
-* @event {CustomEvent<undefined>} open - Fired when the Alert is opened
-* @event {CustomEvent<undefined>} close - Fired when the Alert is closed
-* @testSelector byHeadline byHeadline
-* @testQuery open open true
-* @testQuery closed open false
+* @component popup
+* @slot - Default slot.
 */
-var Alert = class extends AffixIcon(Localized(VividElement)) {
+var Popup = class extends VividElement {
 	constructor(..._args) {
 		super(..._args);
-		this.dismissButtonAriaLabel = null;
-		this.removable = false;
-		this.placement = "bottom";
-		this.timeoutms = 0;
 		this.open = false;
-		this.#closeOnEscape = (e) => {
-			if (this.open && this.removable && handleEscapeKeyAndStopPropogation(e)) this.open = false;
-		};
-		this.#onTransitionEnd = () => {
-			if (!this.open) this.style.display = "none";
-			else this.style.display = "contents";
+		this.dismissible = false;
+		this.arrow = false;
+		this.alternate = false;
+		this.placementStrategy = PlacementStrategy.Flip;
+		this.animationFrame = false;
+		this.shiftCrossAxis = false;
+		this.strategy = "fixed";
+		this.offset = null;
+		this.#autoUpdateCallback = () => {
+			this.#lastPositionUpdate = this.updatePosition();
+			return this.#lastPositionUpdate;
 		};
 	}
-	#timeoutID;
-	/**
-	* @internal
-	*/
-	openChanged(oldValue, newValue) {
-		if (oldValue === void 0) return;
-		this.$emit(newValue ? "open" : "close");
-		this.#setupTimeout();
-		if (newValue) {
-			this.style.display = "contents";
-			const closeBtn = this.shadowRoot.querySelector(".dismiss-button");
-			if (this.removable) closeBtn?.focus();
-		} else this.style.display = "none";
+	get #middleware() {
+		let middleware = [
+			inline(),
+			placementStrategyMiddlewares[this.placementStrategy],
+			shift({ crossAxis: this.shiftCrossAxis }),
+			hide(),
+			size({ apply({ availableWidth, availableHeight, elements }) {
+				Object.assign(elements.floating.style, {
+					maxWidth: `${availableWidth}px`,
+					maxHeight: `${availableHeight}px`
+				});
+			} })
+		];
+		let offsetValue = this.offset ?? 0;
+		if (this.arrow) {
+			offsetValue += 12;
+			middleware = [...middleware, arrow({
+				element: this.arrowEl,
+				padding: 10
+			})];
+		}
+		if (offsetValue > 0) middleware.unshift(offset(offsetValue));
+		return middleware;
+	}
+	#cleanup;
+	openChanged(_, newValue) {
+		this.#togglePopover();
+		this.#updateAutoUpdate();
+		this.$emit(newValue ? "vwc-popup:open" : "vwc-popup:close");
+	}
+	/** @internal */
+	animationFrameChanged() {
+		this.#updateAutoUpdate();
+	}
+	/** @internal */
+	shiftCrossAxisChanged() {
+		this.#updateAutoUpdate();
+	}
+	/** @internal */
+	anchorChanged() {
+		this.#updateAutoUpdate();
+	}
+	/** @internal */
+	strategyChanged() {
+		this.#togglePopover();
 	}
 	connectedCallback() {
 		super.connectedCallback();
-		this.addEventListener("keydown", this.#closeOnEscape);
-		this._controlEl.addEventListener("transitionend", this.#onTransitionEnd);
-		this.#setupTimeout();
+		this.#togglePopover();
+		this.#updateAutoUpdate();
 	}
 	disconnectedCallback() {
 		super.disconnectedCallback();
-		if (this.#timeoutID) clearTimeout(this.#timeoutID);
-		this.removeEventListener("keydown", this.#closeOnEscape);
-		this._controlEl.removeEventListener("transitionend", this.#onTransitionEnd);
+		this.#updateAutoUpdate();
+	}
+	#updateAutoUpdate() {
+		this.#cleanup?.();
+		if (!this.isConnected) return;
+		if (this.open && this.controlEl) this.controlEl.classList.add("open");
+		if (this.anchorEl && this.open && this.popupEl) this.#cleanup = autoUpdate(this.anchorEl, this.popupEl, () => void this.#autoUpdateCallback(), { animationFrame: this.animationFrame });
 	}
-	get conditionedIcon() {
-		return this.icon || this.connotation && CONNOTATION_ICON_MAP[this.connotation];
+	#togglePopover() {
+		if (this.popupEl && this.strategy === "fixed") if (this.open) this.popupEl.showPopover();
+		else this.popupEl.hidePopover();
 	}
-	#setupTimeout() {
-		if (this.#timeoutID) clearTimeout(this.#timeoutID);
-		if (this.open && this.timeoutms > 0) this.#timeoutID = setTimeout(() => this.open = false, this.timeoutms);
+	#lastPositionUpdate;
+	#autoUpdateCallback;
+	/** Updates popup's position */
+	async updatePosition() {
+		if (!this.open || !this.anchorEl) return;
+		const positionData = await computePosition(this.anchorEl, this.popupEl, {
+			placement: this.placement,
+			strategy: this.strategy,
+			middleware: this.#middleware
+		});
+		this.#assignPopupPosition(positionData);
+		if (this.arrow) this.#assignArrowPosition(positionData);
+	}
+	#assignPopupPosition(data) {
+		const { x: popupX, y: popupY } = data;
+		const { referenceHidden } = data.middlewareData.hide;
+		Object.assign(this.popupEl.style, {
+			left: `${popupX}px`,
+			top: `${popupY}px`,
+			visibility: referenceHidden ? "hidden" : "visible"
+		});
+	}
+	#assignArrowPosition(data) {
+		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]
+		});
+	}
+	get anchorEl() {
+		return this.anchor ?? null;
+	}
+	/**
+	* Shows the popup.
+	* Unlike toggling the `open` attribute, show() will wait for the popup to become visible and positioned correctly.
+	*/
+	show() {
+		this.open = true;
+		return this.#lastPositionUpdate ?? Promise.resolve();
+	}
+	hide() {
+		this.open = false;
 	}
-	#closeOnEscape;
-	#onTransitionEnd;
 };
-__decorate([attr({ attribute: "dismiss-button-aria-label" })], Alert.prototype, "dismissButtonAriaLabel", void 0);
-__decorate([attr({ mode: "boolean" })], Alert.prototype, "removable", void 0);
-__decorate([attr({ mode: "fromView" })], Alert.prototype, "placement", void 0);
-__decorate([attr], Alert.prototype, "headline", void 0);
-__decorate([attr], Alert.prototype, "text", void 0);
+__decorate([attr({ mode: "boolean" })], Popup.prototype, "open", void 0);
+__decorate([attr({ mode: "boolean" })], Popup.prototype, "dismissible", void 0);
+__decorate([attr({ mode: "boolean" })], Popup.prototype, "arrow", void 0);
+__decorate([attr({ mode: "boolean" })], Popup.prototype, "alternate", void 0);
+__decorate([attr({ mode: "fromView" })], Popup.prototype, "placement", void 0);
+__decorate([attr({
+	mode: "boolean",
+	attribute: "animation-frame"
+})], Popup.prototype, "animationFrame", void 0);
 __decorate([attr({
-	mode: "fromView",
+	mode: "boolean",
+	attribute: "shift-cross-axis"
+})], Popup.prototype, "shiftCrossAxis", void 0);
+__decorate([attr({ mode: "fromView" })], Popup.prototype, "strategy", void 0);
+__decorate([attr({
+	attribute: "offset",
 	converter: nullableNumberConverter
-})], Alert.prototype, "timeoutms", void 0);
-__decorate([attr], Alert.prototype, "connotation", void 0);
-__decorate([attr], Alert.prototype, "strategy", void 0);
-__decorate([attr({ mode: "boolean" })], Alert.prototype, "open", void 0);
+})], Popup.prototype, "offset", void 0);
+__decorate([observable], Popup.prototype, "anchor", void 0);
 //#endregion
-//#region src/lib/alert/alert.template.ts
-var getClasses = ({ connotation }) => classNames("base", [`connotation-${connotation}`, Boolean(connotation)]);
-var getControlClasses = ({ open, placement, strategy }) => classNames("control", ["open", open], [`placement-${placement}`, Boolean(placement)], [`strategy-${strategy}`, Boolean(strategy)]);
-function renderIcon(c, x) {
-	const affixIconTemplate = affixIconTemplateFactory(c);
-	const icon = x.conditionedIcon;
-	const announcement = !x.icon && x.connotation ? {
-		label: x.locale.connotationAnnoncement[`${x.connotation}Icon`],
-		announceOnUpdate: true
-	} : void 0;
-	return affixIconTemplate(icon, IconWrapper.Slot, IconAriaHidden.Hidden, announcement);
-}
-function renderDismissButton(buttonTag) {
-	return html`
-		<${buttonTag}
-			aria-label="${(x) => x.dismissButtonAriaLabel || x.locale.alert.dismissButtonLabel}"
-			size="condensed"
-			type="button"
-			class="dismiss-button"
-			icon="close-line"
-			@click="${(x) => x.open = false}">
-		</${buttonTag}>`;
+//#region src/lib/popup/popup.scss?inline
+var popup_default = ":host{display:var(--_popup-display,inline)}.control{border-radius:inherit;background:var(--vvd-color-surface-4dp);contain:layout}.control:not(.open){display:none}.popup-wrapper{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}.popup-wrapper ::-webkit-scrollbar{width:4px}.popup-wrapper ::-webkit-scrollbar-track{background:var(--scrollbar-track-color)}.popup-wrapper ::-webkit-scrollbar-thumb{background-color:var(--scrollbar-fallback-track-color,var(--scrollbar-thumb-color));border:0;border-radius:4px}.popup-wrapper{z-index:var(--_popup-z-index,10);border:none;border-radius:8px;inline-size:max-content;min-inline-size:fit-content;margin:0;padding:0;overflow:visible}.popup-wrapper:not(.absolute){position:fixed}.popup-wrapper.absolute{position:absolute;top:0;left:0}.popup-content{color:var(--vvd-color-canvas-text);display:grid}.dismissible .popup-content{grid-template-columns:1fr auto;align-content:start}.arrow{z-index:-1;background:var(--vvd-color-surface-4dp);width:8px;height:8px;position:absolute;transform:rotate(45deg)}.dismissible-button{align-self:flex-start;margin-block-start:4px;margin-inline-end:4px}";
+//#endregion
+//#region src/lib/popup/popup.template.ts
+function handlePopover(x) {
+	return x.strategy && x.strategy === "fixed" ? "manual" : null;
 }
-var AlertTemplate = (context) => {
+var popupTemplate = (context) => {
 	const elevationTag = context.tagFor(Elevation);
 	const buttonTag = context.tagFor(Button);
 	return html`
-	<${elevationTag} class="elevation" dp='8' exportparts="vvd-theme-alternate">
-		<div class="${getControlClasses}" ${ref("_controlEl")}>
-			<div
-				part="vvd-theme-alternate"
-				class="${getClasses}"
-				role="alert"
-				aria-hidden="${(x) => x.open ? "false" : "true"}"
-				?hidden="${(x) => !x.open}"
-			>
-				${(x) => renderIcon(context, x)}
-				<div class="alert-text">
-					${when((x) => x.headline, html`<h2 class="headline">${(x) => x.headline}</h2>`)}
-					${when((x) => x.text, html`<div class="main-text">${(x) => x.text}</div>`)}
-					<slot name="main"></slot>
+  <${elevationTag}>
+		<div popover="${handlePopover}" class="popup-wrapper ${(x) => x.strategy}" ${ref("popupEl")} part="popup-base">
+			<div ${ref("controlEl")} class="${(x) => classNames("control", ["open", x.open], ["dismissible", x.dismissible], ["alternate", x.alternate])}" aria-hidden="${(x) => x.open ? "false" : "true"}"
+				part="${(x) => x.alternate ? "vvd-theme-alternate" : ""}">
+				<div class="popup-content">
+					<slot></slot>
+					${when((x) => x.dismissible, html`<${buttonTag} size="condensed" @click="${(x) => x.open = false}"
+						class="dismissible-button" icon="close-small-solid" shape="pill"></${buttonTag}>`)}
 				</div>
-				<slot class="action-items" name="action-items"></slot>
-				${when((x) => x.removable, renderDismissButton(buttonTag))}
+				${when((x) => x.arrow, html`<div class="arrow" ${ref("arrowEl")}></div>`)}
 			</div>
-		</div>
-	</${elevationTag}>
-	`;
+    </div>
+  </${elevationTag}>`;
 };
 //#endregion
-//#region src/lib/alert/definition.ts
-/**
-* @internal
-*/
-var alertDefinition = defineVividComponent("alert", Alert, AlertTemplate, [
-	iconDefinition,
-	buttonDefinition,
-	elevationDefinition
-], { styles: alert_default });
+//#region src/lib/popup/definition.ts
+/** @internal */
+var popupDefinition = defineVividComponent("popup", Popup, popupTemplate, [elevationDefinition, buttonDefinition], { styles: popup_default });
 /**
-* Registers the alert elements with the design system.
+* Registers the popup elements with the design system.
 *
 * @param prefix - the prefix to use for the component name
 */
-var registerAlert = createRegisterFunction(alertDefinition);
+var registerPopup = createRegisterFunction(popupDefinition);
 //#endregion
-export { registerAlert as n, Alert as r, alertDefinition as t };
+export { Popup as i, registerPopup as n, PlacementStrategy as r, popupDefinition as t };

package/unbundled/delegates-aria.cjs

@@ -1,9 +1,7 @@
 const require_vivid_element = require("./vivid-element.cjs");
 const require_aria_binding_directive = require("./aria-binding-directive.cjs");
 //#region src/shared/aria/delegates-aria.ts
-/**
-* Directive to delegate ARIA properties to the target element.
-*/
+/** Directive to delegate ARIA properties to the target element. */
 function delegateAria(boundProperties = {}, options = {}) {
 	return new require_aria_binding_directive.AriaBindingDirective({
 		boundProperties,

package/unbundled/delegates-aria.js

@@ -1,9 +1,7 @@
 import { a as ariaValueProperties, i as ariaIdrefsProperties } from "./vivid-element.js";
 import { n as IdrefsController, t as AriaBindingDirective } from "./aria-binding-directive.js";
 //#region src/shared/aria/delegates-aria.ts
-/**
-* Directive to delegate ARIA properties to the target element.
-*/
+/** Directive to delegate ARIA properties to the target element. */
 function delegateAria(boundProperties = {}, options = {}) {
 	return new AriaBindingDirective({
 		boundProperties,

package/unbundled/divider.cjs

@@ -9,16 +9,11 @@ let _microsoft_fast_web_utilities = require("@microsoft/fast-web-utilities");
 /**
 * @deprecated This will be removed along with the divider's role attribute
 * Divider roles
-* @public
 */
 var DividerRole = {
-	/**
-	* The divider semantically separates content
-	*/
+	/** The divider semantically separates content */
 	separator: "separator",
-	/**
-	* The divider has no semantic value and is for visual presentation only.
-	*/
+	/** The divider has no semantic value and is for visual presentation only. */
 	presentation: "presentation"
 };
 /**

package/unbundled/divider.js

@@ -8,16 +8,11 @@ import { Orientation } from "@microsoft/fast-web-utilities";
 /**
 * @deprecated This will be removed along with the divider's role attribute
 * Divider roles
-* @public
 */
 var DividerRole = {
-	/**
-	* The divider semantically separates content
-	*/
+	/** The divider semantically separates content */
 	separator: "separator",
-	/**
-	* The divider has no semantic value and is for visual presentation only.
-	*/
+	/** The divider has no semantic value and is for visual presentation only. */
 	presentation: "presentation"
 };
 /**

package/unbundled/extractOptions.cjs

@@ -0,0 +1,21 @@
+const require_definition = require("./definition29.cjs");
+const require_definition$1 = require("./definition30.cjs");
+//#region src/shared/foundation/listbox/extractOptions.ts
+/**
+* Extracts all options from a list of slotted elements, including options nested inside optgroups.
+*/
+function extractOptions(elements) {
+	const options = [];
+	for (const item of elements) if (require_definition.isListboxOption(item)) options.push(item);
+	else if (require_definition$1.isOptgroup(item)) {
+		for (const child of Array.from(item.children)) if (require_definition.isListboxOption(child)) options.push(child);
+	}
+	return options;
+}
+//#endregion
+Object.defineProperty(exports, "extractOptions", {
+	enumerable: true,
+	get: function() {
+		return extractOptions;
+	}
+});

package/unbundled/extractOptions.js

@@ -0,0 +1,16 @@
+import { i as isListboxOption } from "./definition29.js";
+import { i as isOptgroup } from "./definition30.js";
+//#region src/shared/foundation/listbox/extractOptions.ts
+/**
+* Extracts all options from a list of slotted elements, including options nested inside optgroups.
+*/
+function extractOptions(elements) {
+	const options = [];
+	for (const item of elements) if (isListboxOption(item)) options.push(item);
+	else if (isOptgroup(item)) {
+		for (const child of Array.from(item.children)) if (isListboxOption(child)) options.push(child);
+	}
+	return options;
+}
+//#endregion
+export { extractOptions as t };

package/unbundled/form-associated.cjs

@@ -12,9 +12,7 @@ var InternalsMap = /* @__PURE__ */ new WeakMap();
 * This mixin also provides the `value`/... properties.
 */
 var FormAssociated = (Base) => {
-	/**
-	* @testQuery value value
-	*/
+	/** @testQuery value value */
 	class FormAssociatedElement extends Base {
 		/**
 		* Must evaluate to true to enable elementInternals.
@@ -25,9 +23,7 @@ var FormAssociated = (Base) => {
 		static get formAssociated() {
 			return supportsElementInternals;
 		}
-		/**
-		* Returns the validity state of the element
-		*/
+		/** Returns the validity state of the element */
 		get validity() {
 			return this.elementInternals ? this.elementInternals.validity : this.proxy.validity;
 		}
@@ -52,9 +48,7 @@ var FormAssociated = (Base) => {
 		get willValidate() {
 			return this.elementInternals ? this.elementInternals.willValidate : this.proxy.willValidate;
 		}
-		/**
-		* A reference to all associated label elements
-		*/
+		/** A reference to all associated label elements */
 		get labels() {
 			if (this.elementInternals) return Object.freeze(Array.from(this.elementInternals.labels));
 			else if (this.proxy instanceof HTMLElement && this.id) {
@@ -63,9 +57,7 @@ var FormAssociated = (Base) => {
 				return Object.freeze(forLabels.concat(Array.from(parentLabels)));
 			} else return _microsoft_fast_element.emptyArray;
 		}
-		/**
-		* @internal
-		*/
+		/** @internal */
 		valueChanged(_previous, _next) {
 			this.dirtyValue = true;
 			if (this.proxy instanceof HTMLElement) this.proxy.value = this.value;
@@ -82,32 +74,24 @@ var FormAssociated = (Base) => {
 		set currentValue(value) {
 			this.value = value;
 		}
-		/**
-		* @internal
-		*/
+		/** @internal */
 		initialValueChanged(_previous, _next) {
 			if (!this.dirtyValue) {
 				this.value = this.initialValue;
 				this.dirtyValue = false;
 			}
 		}
-		/**
-		* @internal
-		*/
+		/** @internal */
 		disabledChanged(_previous, _next) {
 			if (this.proxy instanceof HTMLElement) this.proxy.disabled = this.disabled;
 			_microsoft_fast_element.Updates.enqueue(() => this.classList.toggle("disabled", this.disabled));
 		}
-		/**
-		* @internal
-		*/
+		/** @internal */
 		nameChanged(_previous, _next) {
 			/* v8 ignore if -- @preserve */
 			if (this.proxy instanceof HTMLElement) this.proxy.name = this.name;
 		}
-		/**
-		* @internal
-		*/
+		/** @internal */
 		requiredChanged(_previous, _next) {
 			if (this.proxy instanceof HTMLElement) this.proxy.required = this.required;
 			_microsoft_fast_element.Updates.enqueue(() => this.classList.toggle("required", this.required));
@@ -137,9 +121,7 @@ var FormAssociated = (Base) => {
 			this.initialValue = this.initialValue || "";
 			if (!this.elementInternals) this.formResetCallback = this.formResetCallback.bind(this);
 		}
-		/**
-		* @internal
-		*/
+		/** @internal */
 		connectedCallback() {
 			super.connectedCallback();
 			this.addEventListener("keypress", this._keypressHandler);
@@ -152,17 +134,13 @@ var FormAssociated = (Base) => {
 				if (this.form) this.form.addEventListener("reset", this.formResetCallback);
 			}
 		}
-		/**
-		* @internal
-		*/
+		/** @internal */
 		disconnectedCallback() {
 			super.disconnectedCallback();
 			this.proxyEventsToBlock.forEach((name) => this.proxy.removeEventListener(name, this.stopPropagation));
 			if (!this.elementInternals && this.form) this.form.removeEventListener("reset", this.formResetCallback);
 		}
-		/**
-		* Return the current validity of the element.
-		*/
+		/** Return the current validity of the element. */
 		checkValidity() {
 			return this.elementInternals ? this.elementInternals.checkValidity() : this.proxy.checkValidity();
 		}
@@ -205,9 +183,7 @@ var FormAssociated = (Base) => {
 		formDisabledCallback(disabled) {
 			this.disabled = disabled;
 		}
-		/**
-		* @internal
-		*/
+		/** @internal */
 		formResetCallback() {
 			this.value = this.initialValue;
 			this.dirtyValue = false;
@@ -272,9 +248,7 @@ var FormAssociated = (Base) => {
 		setFormValue(value, state) {
 			if (this.elementInternals) this.elementInternals.setFormValue(value, state || value);
 		}
-		/**
-		* @internal
-		*/
+		/** @internal */
 		_keypressHandler(e) {
 			switch (e.key) {
 				case _microsoft_fast_web_utilities.keyEnter:
@@ -301,9 +275,7 @@ var FormAssociated = (Base) => {
 	require_decorate.__decorate([(0, _microsoft_fast_element.attr)({ mode: "boolean" })], FormAssociatedElement.prototype, "required", void 0);
 	return FormAssociatedElement;
 };
-/**
-* `current-checked` is inexplicably not a boolean attribute, so we need to convert from "true"/"false" to boolean.
-*/
+/** `current-checked` is inexplicably not a boolean attribute, so we need to convert from "true"/"false" to boolean. */
 var currentCheckedConverter = {
 	fromView(value) {
 		if (typeof value === "string") return value.toLowerCase() === "true";
@@ -313,9 +285,7 @@ var currentCheckedConverter = {
 		return value ? "true" : "false";
 	}
 };
-/**
-* Extends FormAssociated to provide `checked`/....
-*/
+/** Extends FormAssociated to provide `checked`/.... */
 var CheckableFormAssociated = (Base) => {
 	class CheckableFormAssociatedElement extends FormAssociated(Base) {
 		constructor(..._args) {
@@ -323,9 +293,7 @@ var CheckableFormAssociated = (Base) => {
 			this.dirtyChecked = false;
 			this.defaultChecked = false;
 		}
-		/**
-		* @internal
-		*/
+		/** @internal */
 		defaultCheckedChanged() {
 			/* v8 ignore else -- @preserve */
 			if (!this.dirtyChecked) {
@@ -333,9 +301,7 @@ var CheckableFormAssociated = (Base) => {
 				this.dirtyChecked = false;
 			}
 		}
-		/**
-		* @internal
-		*/
+		/** @internal */
 		checkedChanged(prev, _next) {
 			if (!this.dirtyChecked) this.dirtyChecked = true;
 			this.updateForm();
@@ -363,23 +329,17 @@ var CheckableFormAssociated = (Base) => {
 		set currentChecked(value) {
 			this.checked = value;
 		}
-		/**
-		* @internal
-		*/
+		/** @internal */
 		updateForm() {
 			const value = this.checked ? this.value : null;
 			this.setFormValue(value, value);
 		}
-		/**
-		* @internal
-		*/
+		/** @internal */
 		connectedCallback() {
 			super.connectedCallback();
 			this.updateForm();
 		}
-		/**
-		* @internal
-		*/
+		/** @internal */
 		formResetCallback() {
 			super.formResetCallback();
 			this.checked = this.defaultChecked;