@vonage/vivid 5.19.0 → 5.20.0

package/unbundled/affix.js

@@ -1,4 +1,4 @@
-import { r as Icon } from "./definition2.js";
+import { r as Icon } from "./definition.js";
 import { t as __decorate } from "./decorate.js";
 import { attr, html, observable, slotted } from "@microsoft/fast-element";
 //#region src/shared/patterns/affix.ts

package/unbundled/aria-binding-directive.cjs

@@ -2,6 +2,105 @@ require("./chunk.cjs");
 const require_vivid_element = require("./vivid-element.cjs");
 let _microsoft_fast_element = require("@microsoft/fast-element");
 let _microsoft_fast_web_utilities = require("@microsoft/fast-web-utilities");
+//#region src/shared/aria/idrefs-controller.ts
+var parseIdrefs = (idrefs) => {
+	if (!idrefs.trim()) return [];
+	return idrefs.trim().split(/\s+/);
+};
+var idrefsControllers = /* @__PURE__ */ new WeakMap();
+/** Manages a single IDREF property for an element. Lazily created only when the property is used. */
+var IdrefsController = class IdrefsController {
+	static resolvedElements(host, property) {
+		return idrefsControllers.get(host)?.get(property)?.getResolvedElements() ?? null;
+	}
+	static for(host, property) {
+		let controllersByProp = idrefsControllers.get(host);
+		if (!controllersByProp) {
+			controllersByProp = /* @__PURE__ */ new Map();
+			idrefsControllers.set(host, controllersByProp);
+		}
+		let controller = controllersByProp.get(property);
+		if (!controller) {
+			controller = new IdrefsController(host, property);
+			controllersByProp.set(property, controller);
+		}
+		return controller;
+	}
+	constructor(host, propertyName) {
+		this.host = host;
+		this.propertyName = propertyName;
+		host._addController(this);
+	}
+	#isConnected = false;
+	hostConnected() {
+		this.#isConnected = true;
+		this.#updateResolution();
+	}
+	hostDisconnected() {
+		this.#isConnected = false;
+		this.#updateResolution();
+	}
+	getAttribute() {
+		return this.host[`_${this.propertyName}`];
+	}
+	setAttribute(value) {
+		this.host[`_${this.propertyName}`] = value;
+		require_vivid_element.handleAriaPropertyChange(this.host, this.propertyName);
+		this.#updateResolution();
+	}
+	#resolvedElements = null;
+	#setResolvedElements(elements) {
+		this.#resolvedElements = elements;
+		require_vivid_element.publishAriaPropertyChange(this.host, this.propertyName);
+	}
+	getResolvedElements() {
+		if (!this.host.isConnected && this.#resolvedElements) return [];
+		return this.#resolvedElements;
+	}
+	/** When elements property is set on the host */
+	setElements(elements) {
+		this.setAttribute(elements !== null ? "" : null);
+		this.#setResolvedElements(elements);
+	}
+	#updateResolution() {
+		this.#cleanupObserver();
+		if (!(this.#isConnected && this.host.isConnected)) return;
+		const attrValue = this.getAttribute();
+		if (attrValue) {
+			const idList = parseIdrefs(attrValue);
+			if (idList.length === 0) {
+				this.#setResolvedElements([]);
+				return;
+			}
+			const resolved = this.#resolveIds(idList);
+			this.#setResolvedElements(resolved);
+			if (resolved.length < idList.length) this.#observeForElements(idList);
+		}
+	}
+	#resolveId(id) {
+		return this.host.getRootNode().getElementById(id);
+	}
+	#resolveIds(idList) {
+		return idList.map((id) => this.#resolveId(id)).filter((el) => el !== null);
+	}
+	#observer;
+	#observeForElements(idList) {
+		this.#observer = new MutationObserver(() => {
+			const resolved = this.#resolveIds(idList);
+			this.#setResolvedElements(resolved);
+			if (resolved.length === idList.length) this.#cleanupObserver();
+		});
+		this.#observer.observe(this.host.getRootNode(), {
+			childList: true,
+			subtree: true
+		});
+	}
+	#cleanupObserver() {
+		this.#observer?.disconnect();
+		this.#observer = void 0;
+	}
+};
+//#endregion
 //#region src/shared/aria/aria-binding-directive.ts
 var setAriaAttribute = (target, property, value) => _microsoft_fast_element.DOM.setAttribute(target, require_vivid_element.ariaAttributeName(property), value === false ? null : value);
 /**
@@ -24,9 +123,14 @@ var AriaBindingDirective = class extends _microsoft_fast_element.StatelessAttach
 		const target = controller.targets[this.targetNodeId];
 		if (this.options.requireHost && target !== source) throw new Error("Target element must be the same as the source element");
 		for (const behaviour of this.propertyBindingBehaviours) behaviour.bind(controller);
-		for (const key of this.options.forwardedProperties) setAriaAttribute(target, key, source[key]);
+		for (const key of this.options.forwardedValueProperties) setAriaAttribute(target, key, source[key]);
+		const setIdrefElementsOnTarget = (property) => {
+			target[`${property}Elements`] = IdrefsController.resolvedElements(source, property);
+		};
+		for (const key of this.options.forwardedIdrefsProperties) setIdrefElementsOnTarget(key);
 		const onAriaPropertyChange = (source, property) => {
-			if (this.options.forwardedProperties.has(property)) setAriaAttribute(target, property, source[property]);
+			if (this.options.forwardedValueProperties.has(property)) setAriaAttribute(target, property, source[property]);
+			if (this.options.forwardedIdrefsProperties.has(property)) setIdrefElementsOnTarget(property);
 		};
 		require_vivid_element.subscribeToAriaPropertyChanges(source, onAriaPropertyChange);
 		controller.onUnbind({ unbind: () => require_vivid_element.unsubscribeFromAriaPropertyChanges(source, onAriaPropertyChange) });
@@ -40,3 +144,9 @@ Object.defineProperty(exports, "AriaBindingDirective", {
 		return AriaBindingDirective;
 	}
 });
+Object.defineProperty(exports, "IdrefsController", {
+	enumerable: true,
+	get: function() {
+		return IdrefsController;
+	}
+});

package/unbundled/aria-binding-directive.js

@@ -1,6 +1,105 @@
-import { a as subscribeToAriaPropertyChanges, o as unsubscribeFromAriaPropertyChanges, r as ariaAttributeName } from "./vivid-element.js";
+import { c as subscribeToAriaPropertyChanges, l as unsubscribeFromAriaPropertyChanges, o as handleAriaPropertyChange, r as ariaAttributeName, s as publishAriaPropertyChange } from "./vivid-element.js";
 import { DOM, HTMLBindingDirective, HTMLDirective, StatelessAttachedAttributeDirective, oneWay } from "@microsoft/fast-element";
 import { uniqueId } from "@microsoft/fast-web-utilities";
+//#region src/shared/aria/idrefs-controller.ts
+var parseIdrefs = (idrefs) => {
+	if (!idrefs.trim()) return [];
+	return idrefs.trim().split(/\s+/);
+};
+var idrefsControllers = /* @__PURE__ */ new WeakMap();
+/** Manages a single IDREF property for an element. Lazily created only when the property is used. */
+var IdrefsController = class IdrefsController {
+	static resolvedElements(host, property) {
+		return idrefsControllers.get(host)?.get(property)?.getResolvedElements() ?? null;
+	}
+	static for(host, property) {
+		let controllersByProp = idrefsControllers.get(host);
+		if (!controllersByProp) {
+			controllersByProp = /* @__PURE__ */ new Map();
+			idrefsControllers.set(host, controllersByProp);
+		}
+		let controller = controllersByProp.get(property);
+		if (!controller) {
+			controller = new IdrefsController(host, property);
+			controllersByProp.set(property, controller);
+		}
+		return controller;
+	}
+	constructor(host, propertyName) {
+		this.host = host;
+		this.propertyName = propertyName;
+		host._addController(this);
+	}
+	#isConnected = false;
+	hostConnected() {
+		this.#isConnected = true;
+		this.#updateResolution();
+	}
+	hostDisconnected() {
+		this.#isConnected = false;
+		this.#updateResolution();
+	}
+	getAttribute() {
+		return this.host[`_${this.propertyName}`];
+	}
+	setAttribute(value) {
+		this.host[`_${this.propertyName}`] = value;
+		handleAriaPropertyChange(this.host, this.propertyName);
+		this.#updateResolution();
+	}
+	#resolvedElements = null;
+	#setResolvedElements(elements) {
+		this.#resolvedElements = elements;
+		publishAriaPropertyChange(this.host, this.propertyName);
+	}
+	getResolvedElements() {
+		if (!this.host.isConnected && this.#resolvedElements) return [];
+		return this.#resolvedElements;
+	}
+	/** When elements property is set on the host */
+	setElements(elements) {
+		this.setAttribute(elements !== null ? "" : null);
+		this.#setResolvedElements(elements);
+	}
+	#updateResolution() {
+		this.#cleanupObserver();
+		if (!(this.#isConnected && this.host.isConnected)) return;
+		const attrValue = this.getAttribute();
+		if (attrValue) {
+			const idList = parseIdrefs(attrValue);
+			if (idList.length === 0) {
+				this.#setResolvedElements([]);
+				return;
+			}
+			const resolved = this.#resolveIds(idList);
+			this.#setResolvedElements(resolved);
+			if (resolved.length < idList.length) this.#observeForElements(idList);
+		}
+	}
+	#resolveId(id) {
+		return this.host.getRootNode().getElementById(id);
+	}
+	#resolveIds(idList) {
+		return idList.map((id) => this.#resolveId(id)).filter((el) => el !== null);
+	}
+	#observer;
+	#observeForElements(idList) {
+		this.#observer = new MutationObserver(() => {
+			const resolved = this.#resolveIds(idList);
+			this.#setResolvedElements(resolved);
+			if (resolved.length === idList.length) this.#cleanupObserver();
+		});
+		this.#observer.observe(this.host.getRootNode(), {
+			childList: true,
+			subtree: true
+		});
+	}
+	#cleanupObserver() {
+		this.#observer?.disconnect();
+		this.#observer = void 0;
+	}
+};
+//#endregion
 //#region src/shared/aria/aria-binding-directive.ts
 var setAriaAttribute = (target, property, value) => DOM.setAttribute(target, ariaAttributeName(property), value === false ? null : value);
 /**
@@ -23,9 +122,14 @@ var AriaBindingDirective = class extends StatelessAttachedAttributeDirective {
 		const target = controller.targets[this.targetNodeId];
 		if (this.options.requireHost && target !== source) throw new Error("Target element must be the same as the source element");
 		for (const behaviour of this.propertyBindingBehaviours) behaviour.bind(controller);
-		for (const key of this.options.forwardedProperties) setAriaAttribute(target, key, source[key]);
+		for (const key of this.options.forwardedValueProperties) setAriaAttribute(target, key, source[key]);
+		const setIdrefElementsOnTarget = (property) => {
+			target[`${property}Elements`] = IdrefsController.resolvedElements(source, property);
+		};
+		for (const key of this.options.forwardedIdrefsProperties) setIdrefElementsOnTarget(key);
 		const onAriaPropertyChange = (source, property) => {
-			if (this.options.forwardedProperties.has(property)) setAriaAttribute(target, property, source[property]);
+			if (this.options.forwardedValueProperties.has(property)) setAriaAttribute(target, property, source[property]);
+			if (this.options.forwardedIdrefsProperties.has(property)) setIdrefElementsOnTarget(property);
 		};
 		subscribeToAriaPropertyChanges(source, onAriaPropertyChange);
 		controller.onUnbind({ unbind: () => unsubscribeFromAriaPropertyChanges(source, onAriaPropertyChange) });
@@ -33,4 +137,4 @@ var AriaBindingDirective = class extends StatelessAttachedAttributeDirective {
 };
 HTMLDirective.define(AriaBindingDirective);
 //#endregion
-export { AriaBindingDirective as t };
+export { IdrefsController as n, AriaBindingDirective as t };

package/unbundled/calendar-picker.template.cjs

@@ -1,6 +1,6 @@
 require("./chunk.cjs");
-const require_definition = require("./definition.cjs");
 const require_decorate = require("./decorate.cjs");
+const require_definition = require("./definition6.cjs");
 const require_definition$1 = require("./definition7.cjs");
 const require_divider = require("./divider.cjs");
 let _microsoft_fast_element = require("@microsoft/fast-element");
@@ -4978,7 +4978,6 @@ function renderCalendarGrid(context) {
 }
 function renderMonthPickerGrid(context) {
 	const dividerTag = context.tagFor(require_divider.Divider);
-	const visuallyHiddenTag = context.tagFor(require_definition.VisuallyHidden);
 	return _microsoft_fast_element.html`
 		<${dividerTag}
 			class='months-separator'
@@ -4996,7 +4995,13 @@ function renderMonthPickerGrid(context) {
 									<button
 										class="${(x, c) => (0, _microsoft_fast_web_utilities.classNames)("month", "button", ["current", areMonthsEqual(x.month, c.parentContext.parentContext.parent._currentMonth)], ["selected", areMonthsEqual(x.month, c.parentContext.parentContext.parent._selectedMonth)])}"
 										tabindex="${(x, c) => c.parentContext.parentContext.parent._tabbableMonth && areMonthsEqual(x.month, c.parentContext.parentContext.parent._tabbableMonth) ? 1 : -1}"
-										aria-label="${(x) => x.monthName}"
+										aria-label="${(x, c) => {
+		const picker = c.parentContext.parentContext.parent;
+		const announcements = [x.monthName];
+		if (areMonthsEqual(x.month, picker._currentMonth)) announcements.push(picker.locale.calendarPicker.currentLabel);
+		if (areMonthsEqual(x.month, picker._selectedMonth)) announcements.push(picker.locale.calendarPicker.selectedLabel);
+		return announcements.join(" ");
+	}}"
 										data-month="${(x) => monthToStr(x.month)}"
 										?disabled="${(x, c) => !c.parentContext.parentContext.parent._isMonthInValidRange(x.month)}"
 										@click="${(x, c) => c.parentContext.parentContext.parent._onMonthClick(x.month)}"
@@ -5004,13 +5009,6 @@ function renderMonthPickerGrid(context) {
 										@keydown="${(x, c) => c.parentContext.parentContext.parent._onMonthKeydown(x.month, c.event)}"
 									>
 										${(x) => x.label}
-										<${visuallyHiddenTag}>${(x, c) => {
-		const picker = c.parentContext.parentContext.parent;
-		const announcements = [];
-		if (areMonthsEqual(x.month, picker._currentMonth)) announcements.push(picker.locale.calendarPicker.currentLabel);
-		if (areMonthsEqual(x.month, picker._selectedMonth)) announcements.push(picker.locale.calendarPicker.selectedLabel);
-		return announcements.join(" ");
-	}}</${visuallyHiddenTag}>
 									</button>
 								</span>
 							`)}

package/unbundled/calendar-picker.template.js

@@ -1,5 +1,5 @@
-import { r as VisuallyHidden } from "./definition.js";
 import { t as __decorate } from "./decorate.js";
+import { r as VisuallyHidden } from "./definition6.js";
 import { i as Button } from "./definition7.js";
 import { t as Divider } from "./divider.js";
 import { Updates, attr, html, observable, repeat, volatile, when } from "@microsoft/fast-element";
@@ -4977,7 +4977,6 @@ function renderCalendarGrid(context) {
 }
 function renderMonthPickerGrid(context) {
 	const dividerTag = context.tagFor(Divider);
-	const visuallyHiddenTag = context.tagFor(VisuallyHidden);
 	return html`
 		<${dividerTag}
 			class='months-separator'
@@ -4995,7 +4994,13 @@ function renderMonthPickerGrid(context) {
 									<button
 										class="${(x, c) => classNames("month", "button", ["current", areMonthsEqual(x.month, c.parentContext.parentContext.parent._currentMonth)], ["selected", areMonthsEqual(x.month, c.parentContext.parentContext.parent._selectedMonth)])}"
 										tabindex="${(x, c) => c.parentContext.parentContext.parent._tabbableMonth && areMonthsEqual(x.month, c.parentContext.parentContext.parent._tabbableMonth) ? 1 : -1}"
-										aria-label="${(x) => x.monthName}"
+										aria-label="${(x, c) => {
+		const picker = c.parentContext.parentContext.parent;
+		const announcements = [x.monthName];
+		if (areMonthsEqual(x.month, picker._currentMonth)) announcements.push(picker.locale.calendarPicker.currentLabel);
+		if (areMonthsEqual(x.month, picker._selectedMonth)) announcements.push(picker.locale.calendarPicker.selectedLabel);
+		return announcements.join(" ");
+	}}"
 										data-month="${(x) => monthToStr(x.month)}"
 										?disabled="${(x, c) => !c.parentContext.parentContext.parent._isMonthInValidRange(x.month)}"
 										@click="${(x, c) => c.parentContext.parentContext.parent._onMonthClick(x.month)}"
@@ -5003,13 +5008,6 @@ function renderMonthPickerGrid(context) {
 										@keydown="${(x, c) => c.parentContext.parentContext.parent._onMonthKeydown(x.month, c.event)}"
 									>
 										${(x) => x.label}
-										<${visuallyHiddenTag}>${(x, c) => {
-		const picker = c.parentContext.parentContext.parent;
-		const announcements = [];
-		if (areMonthsEqual(x.month, picker._currentMonth)) announcements.push(picker.locale.calendarPicker.currentLabel);
-		if (areMonthsEqual(x.month, picker._selectedMonth)) announcements.push(picker.locale.calendarPicker.selectedLabel);
-		return announcements.join(" ");
-	}}</${visuallyHiddenTag}>
 									</button>
 								</span>
 							`)}

package/unbundled/char-count.cjs

@@ -1,7 +1,7 @@
 require("./chunk.cjs");
-const require_definition = require("./definition.cjs");
 const require_decorate = require("./decorate.cjs");
 const require_localized = require("./localized.cjs");
+const require_definition = require("./definition6.cjs");
 let _microsoft_fast_element = require("@microsoft/fast-element");
 //#region src/shared/patterns/char-count/char-count.ts
 /**

package/unbundled/char-count.js

@@ -1,6 +1,6 @@
-import { r as VisuallyHidden } from "./definition.js";
 import { t as __decorate } from "./decorate.js";
 import { t as Localized } from "./localized.js";
+import { r as VisuallyHidden } from "./definition6.js";
 import { attr, html, ref } from "@microsoft/fast-element";
 //#region src/shared/patterns/char-count/char-count.ts
 /**

package/unbundled/definition.cjs

@@ -1,42 +1,116 @@
 require("./chunk.cjs");
 const require_vivid_element = require("./vivid-element.cjs");
+const require_numberConverter = require("./numberConverter.cjs");
+const require_decorate = require("./decorate.cjs");
 let _microsoft_fast_element = require("@microsoft/fast-element");
-//#region src/lib/visually-hidden/visually-hidden.scss?inline
-var visually_hidden_default = ":host{display:contents}slot:not(:focus-within){clip:rect(0 0 0 0);clip-path:inset(50%);white-space:nowrap;width:1px;height:1px;display:inline;position:absolute;overflow:hidden}";
+let _microsoft_fast_web_utilities = require("@microsoft/fast-web-utilities");
+//#region src/lib/icon/icon.scss?inline
+var icon_default = ":host{vertical-align:sub;display:inline-block}.control.connotation-accent{--_connotation-color-primary:var(--vvd-icon-accent-primary,var(--vvd-color-canvas-text))}.control.connotation-announcement{--_connotation-color-primary:var(--vvd-icon-announcement-primary,var(--vvd-color-announcement-500))}.control.connotation-cta{--_connotation-color-primary:var(--vvd-icon-cta-primary,var(--vvd-color-cta-500))}.control.connotation-success{--_connotation-color-primary:var(--vvd-icon-success-primary,var(--vvd-color-success-500))}.control.connotation-warning{--_connotation-color-primary:var(--vvd-icon-warning-primary,var(--vvd-color-warning-300))}.control.connotation-alert{--_connotation-color-primary:var(--vvd-icon-alert-primary,var(--vvd-color-alert-500))}.control.connotation-information{--_connotation-color-primary:var(--vvd-icon-information-primary,var(--vvd-color-information-500))}.control.size--6{--_icon-block-size:calc(1px * (40 + 4 * clamp(-1, var(--vvd-size-density,0), 2)) - 1px * (40 + 4 * clamp(-1, var(--vvd-size-density,0), 2) - 16))}.control.size--5{--_icon-block-size:calc(1px * (40 + 4 * clamp(-1, var(--vvd-size-density,0), 2) - 20))}.control.size--4{--_icon-block-size:calc(1px * (40 + 4 * clamp(-1, var(--vvd-size-density,0), 2) - 16))}.control.size--3{--_icon-block-size:calc(1px * (40 + 4 * clamp(-1, var(--vvd-size-density,0), 2) - 12))}.control.size--2{--_icon-block-size:calc(1px * (40 + 4 * clamp(-1, var(--vvd-size-density,0), 2) - 8))}.control.size--1{--_icon-block-size:calc(1px * (40 + 4 * clamp(-1, var(--vvd-size-density,0), 2) - 4))}.control.size-0{--_icon-block-size:calc(1px * (40 + 4 * clamp(-1, var(--vvd-size-density,0), 2)))}.control.size-1{--_icon-block-size:calc(1px * (40 + 4 * clamp(-1, var(--vvd-size-density,0), 2) + 4))}.control.size-2{--_icon-block-size:calc(1px * (40 + 4 * clamp(-1, var(--vvd-size-density,0), 2) + 8))}.control.size-3{--_icon-block-size:calc(1px * (40 + 4 * clamp(-1, var(--vvd-size-density,0), 2) + 12))}.control.size-4{--_icon-block-size:calc(1px * (40 + 4 * clamp(-1, var(--vvd-size-density,0), 2) + 16))}.control.size-5{--_icon-block-size:calc(1px * (40 + 4 * clamp(-1, var(--vvd-size-density,0), 2) + 20))}.control:not(.size--6,.size--5,.size--4,.size--3,.size--2,.size--1,.size-0,.size-1,.size-2,.size-3,.size-4,.size-5){--_icon-block-size:1em}.control{margin:unset;block-size:var(--_icon-block-size);color:currentColor;contain:strict;inline-size:var(--_icon-block-size);display:flex}.control[class*=connotation]{color:var(--_connotation-color-primary)}slot,svg,::slotted(:where(svg,img)){block-size:inherit;inline-size:inherit;margin:auto}";
 //#endregion
-//#region src/lib/visually-hidden/visually-hidden.ts
+//#region src/lib/icon/icon.ts
+var PLACEHOLDER_DELAY = 500;
+var PLACEHOLDER_TIMEOUT = 2e3;
 /**
-* @component visually-hidden
+* @public
+* @component icon
+* @slot - Default slot.
+* @testQuery name name
 */
-var VisuallyHidden = class extends require_vivid_element.VividElement {};
+var Icon = class extends require_vivid_element.VividElement {
+	constructor(..._args) {
+		super(..._args);
+		this.iconLoaded = false;
+		this.#currentRequestId = 0;
+		this.#abortController = null;
+	}
+	#currentRequestId;
+	#abortController;
+	/**
+	* @internal
+	*/
+	async nameChanged() {
+		const requestId = ++this.#currentRequestId;
+		if (this.#abortController) this.#abortController.abort();
+		this.#abortController = new AbortController();
+		this._svg = void 0;
+		this.iconLoaded = false;
+		let timeout = setTimeout(() => {
+			/* v8 ignore else -- @preserve */
+			if (this.#currentRequestId === requestId) {
+				this._svg = require_numberConverter.PLACEHOLDER_ICON;
+				timeout = setTimeout(() => {
+					/* v8 ignore else -- @preserve */
+					if (this.#currentRequestId === requestId && this._svg === require_numberConverter.PLACEHOLDER_ICON) this._svg = void 0;
+				}, PLACEHOLDER_TIMEOUT);
+			}
+		}, PLACEHOLDER_DELAY);
+		try {
+			const svg = await require_numberConverter.resolveIcon(this.name, this.#abortController.signal);
+			/* v8 ignore else -- @preserve */
+			if (this.#currentRequestId === requestId) this._svg = svg;
+		} catch {
+			if (this.#currentRequestId === requestId) this._svg = void 0;
+		} finally {
+			if (this.#currentRequestId === requestId) {
+				clearTimeout(timeout);
+				this.iconLoaded = true;
+			}
+		}
+	}
+};
+require_decorate.__decorate([_microsoft_fast_element.attr], Icon.prototype, "connotation", void 0);
+require_decorate.__decorate([(0, _microsoft_fast_element.attr)({ converter: require_numberConverter.numberConverter })], Icon.prototype, "size", void 0);
+require_decorate.__decorate([_microsoft_fast_element.observable], Icon.prototype, "_svg", void 0);
+require_decorate.__decorate([_microsoft_fast_element.observable], Icon.prototype, "iconLoaded", void 0);
+require_decorate.__decorate([_microsoft_fast_element.attr], Icon.prototype, "label", void 0);
+require_decorate.__decorate([_microsoft_fast_element.attr], Icon.prototype, "name", void 0);
 //#endregion
-//#region src/lib/visually-hidden/visually-hidden.template.ts
-var VisuallyHiddenTemplate = () => _microsoft_fast_element.html`<slot></slot>`;
+//#region src/lib/icon/icon.template.ts
+var getClasses = ({ connotation, size }) => (0, _microsoft_fast_web_utilities.classNames)("control", [`connotation-${connotation}`, Boolean(connotation)], [`size-${size}`, typeof size === "number"]);
+var iconTemplate = () => {
+	const isDecorative = (x) => !x.label || x.label.trim().length === 0;
+	return _microsoft_fast_element.html`
+		<span
+			class="${getClasses}"
+			role="${(x) => isDecorative(x) ? null : "img"}"
+			?aria-hidden="${(x) => isDecorative(x)}"
+			aria-label="${(x) => x.label || null}"
+			?aria-busy="${(x) => !x?.iconLoaded}"
+		>
+			<slot aria-hidden="true">
+				${(0, _microsoft_fast_element.when)((x) => x?.iconLoaded && x?._svg, (x) => _microsoft_fast_element.html`${_microsoft_fast_element.html.partial(x._svg)}`)}
+			</slot>
+		</span>
+	`;
+};
 //#endregion
-//#region src/lib/visually-hidden/definition.ts
-var visuallyHiddenDefinition = require_vivid_element.defineVividComponent("visually-hidden", VisuallyHidden, VisuallyHiddenTemplate, [], { styles: visually_hidden_default });
+//#region src/lib/icon/definition.ts
+/**
+* @internal
+*/
+var iconDefinition = require_vivid_element.defineVividComponent("icon", Icon, iconTemplate, [], { styles: icon_default });
 /**
-* Registers the visually-hidden element with the design system.
+* Registers the icon component & its prerequisite components with the design system.
 *
 * @param prefix - the prefix to use for the component name
 */
-var registerVisuallyHidden = require_vivid_element.createRegisterFunction(visuallyHiddenDefinition);
+var registerIcon = require_vivid_element.createRegisterFunction(iconDefinition);
 //#endregion
-Object.defineProperty(exports, "VisuallyHidden", {
+Object.defineProperty(exports, "Icon", {
 	enumerable: true,
 	get: function() {
-		return VisuallyHidden;
+		return Icon;
 	}
 });
-Object.defineProperty(exports, "registerVisuallyHidden", {
+Object.defineProperty(exports, "iconDefinition", {
 	enumerable: true,
 	get: function() {
-		return registerVisuallyHidden;
+		return iconDefinition;
 	}
 });
-Object.defineProperty(exports, "visuallyHiddenDefinition", {
+Object.defineProperty(exports, "registerIcon", {
 	enumerable: true,
 	get: function() {
-		return visuallyHiddenDefinition;
+		return registerIcon;
 	}
 });

package/unbundled/definition.js

@@ -1,24 +1,98 @@
-import { c as createRegisterFunction, s as defineVividComponent, t as VividElement } from "./vivid-element.js";
-import { html } from "@microsoft/fast-element";
-//#region src/lib/visually-hidden/visually-hidden.scss?inline
-var visually_hidden_default = ":host{display:contents}slot:not(:focus-within){clip:rect(0 0 0 0);clip-path:inset(50%);white-space:nowrap;width:1px;height:1px;display:inline;position:absolute;overflow:hidden}";
+import { d as createRegisterFunction, t as VividElement, u as defineVividComponent } from "./vivid-element.js";
+import { n as resolveIcon, r as PLACEHOLDER_ICON, t as numberConverter } from "./numberConverter.js";
+import { t as __decorate } from "./decorate.js";
+import { attr, html, observable, when } from "@microsoft/fast-element";
+import { classNames } from "@microsoft/fast-web-utilities";
+//#region src/lib/icon/icon.scss?inline
+var icon_default = ":host{vertical-align:sub;display:inline-block}.control.connotation-accent{--_connotation-color-primary:var(--vvd-icon-accent-primary,var(--vvd-color-canvas-text))}.control.connotation-announcement{--_connotation-color-primary:var(--vvd-icon-announcement-primary,var(--vvd-color-announcement-500))}.control.connotation-cta{--_connotation-color-primary:var(--vvd-icon-cta-primary,var(--vvd-color-cta-500))}.control.connotation-success{--_connotation-color-primary:var(--vvd-icon-success-primary,var(--vvd-color-success-500))}.control.connotation-warning{--_connotation-color-primary:var(--vvd-icon-warning-primary,var(--vvd-color-warning-300))}.control.connotation-alert{--_connotation-color-primary:var(--vvd-icon-alert-primary,var(--vvd-color-alert-500))}.control.connotation-information{--_connotation-color-primary:var(--vvd-icon-information-primary,var(--vvd-color-information-500))}.control.size--6{--_icon-block-size:calc(1px * (40 + 4 * clamp(-1, var(--vvd-size-density,0), 2)) - 1px * (40 + 4 * clamp(-1, var(--vvd-size-density,0), 2) - 16))}.control.size--5{--_icon-block-size:calc(1px * (40 + 4 * clamp(-1, var(--vvd-size-density,0), 2) - 20))}.control.size--4{--_icon-block-size:calc(1px * (40 + 4 * clamp(-1, var(--vvd-size-density,0), 2) - 16))}.control.size--3{--_icon-block-size:calc(1px * (40 + 4 * clamp(-1, var(--vvd-size-density,0), 2) - 12))}.control.size--2{--_icon-block-size:calc(1px * (40 + 4 * clamp(-1, var(--vvd-size-density,0), 2) - 8))}.control.size--1{--_icon-block-size:calc(1px * (40 + 4 * clamp(-1, var(--vvd-size-density,0), 2) - 4))}.control.size-0{--_icon-block-size:calc(1px * (40 + 4 * clamp(-1, var(--vvd-size-density,0), 2)))}.control.size-1{--_icon-block-size:calc(1px * (40 + 4 * clamp(-1, var(--vvd-size-density,0), 2) + 4))}.control.size-2{--_icon-block-size:calc(1px * (40 + 4 * clamp(-1, var(--vvd-size-density,0), 2) + 8))}.control.size-3{--_icon-block-size:calc(1px * (40 + 4 * clamp(-1, var(--vvd-size-density,0), 2) + 12))}.control.size-4{--_icon-block-size:calc(1px * (40 + 4 * clamp(-1, var(--vvd-size-density,0), 2) + 16))}.control.size-5{--_icon-block-size:calc(1px * (40 + 4 * clamp(-1, var(--vvd-size-density,0), 2) + 20))}.control:not(.size--6,.size--5,.size--4,.size--3,.size--2,.size--1,.size-0,.size-1,.size-2,.size-3,.size-4,.size-5){--_icon-block-size:1em}.control{margin:unset;block-size:var(--_icon-block-size);color:currentColor;contain:strict;inline-size:var(--_icon-block-size);display:flex}.control[class*=connotation]{color:var(--_connotation-color-primary)}slot,svg,::slotted(:where(svg,img)){block-size:inherit;inline-size:inherit;margin:auto}";
 //#endregion
-//#region src/lib/visually-hidden/visually-hidden.ts
+//#region src/lib/icon/icon.ts
+var PLACEHOLDER_DELAY = 500;
+var PLACEHOLDER_TIMEOUT = 2e3;
 /**
-* @component visually-hidden
+* @public
+* @component icon
+* @slot - Default slot.
+* @testQuery name name
 */
-var VisuallyHidden = class extends VividElement {};
+var Icon = class extends VividElement {
+	constructor(..._args) {
+		super(..._args);
+		this.iconLoaded = false;
+		this.#currentRequestId = 0;
+		this.#abortController = null;
+	}
+	#currentRequestId;
+	#abortController;
+	/**
+	* @internal
+	*/
+	async nameChanged() {
+		const requestId = ++this.#currentRequestId;
+		if (this.#abortController) this.#abortController.abort();
+		this.#abortController = new AbortController();
+		this._svg = void 0;
+		this.iconLoaded = false;
+		let timeout = setTimeout(() => {
+			/* v8 ignore else -- @preserve */
+			if (this.#currentRequestId === requestId) {
+				this._svg = PLACEHOLDER_ICON;
+				timeout = setTimeout(() => {
+					/* v8 ignore else -- @preserve */
+					if (this.#currentRequestId === requestId && this._svg === PLACEHOLDER_ICON) this._svg = void 0;
+				}, PLACEHOLDER_TIMEOUT);
+			}
+		}, PLACEHOLDER_DELAY);
+		try {
+			const svg = await resolveIcon(this.name, this.#abortController.signal);
+			/* v8 ignore else -- @preserve */
+			if (this.#currentRequestId === requestId) this._svg = svg;
+		} catch {
+			if (this.#currentRequestId === requestId) this._svg = void 0;
+		} finally {
+			if (this.#currentRequestId === requestId) {
+				clearTimeout(timeout);
+				this.iconLoaded = true;
+			}
+		}
+	}
+};
+__decorate([attr], Icon.prototype, "connotation", void 0);
+__decorate([attr({ converter: numberConverter })], Icon.prototype, "size", void 0);
+__decorate([observable], Icon.prototype, "_svg", void 0);
+__decorate([observable], Icon.prototype, "iconLoaded", void 0);
+__decorate([attr], Icon.prototype, "label", void 0);
+__decorate([attr], Icon.prototype, "name", void 0);
 //#endregion
-//#region src/lib/visually-hidden/visually-hidden.template.ts
-var VisuallyHiddenTemplate = () => html`<slot></slot>`;
+//#region src/lib/icon/icon.template.ts
+var getClasses = ({ connotation, size }) => classNames("control", [`connotation-${connotation}`, Boolean(connotation)], [`size-${size}`, typeof size === "number"]);
+var iconTemplate = () => {
+	const isDecorative = (x) => !x.label || x.label.trim().length === 0;
+	return html`
+		<span
+			class="${getClasses}"
+			role="${(x) => isDecorative(x) ? null : "img"}"
+			?aria-hidden="${(x) => isDecorative(x)}"
+			aria-label="${(x) => x.label || null}"
+			?aria-busy="${(x) => !x?.iconLoaded}"
+		>
+			<slot aria-hidden="true">
+				${when((x) => x?.iconLoaded && x?._svg, (x) => html`${html.partial(x._svg)}`)}
+			</slot>
+		</span>
+	`;
+};
 //#endregion
-//#region src/lib/visually-hidden/definition.ts
-var visuallyHiddenDefinition = defineVividComponent("visually-hidden", VisuallyHidden, VisuallyHiddenTemplate, [], { styles: visually_hidden_default });
+//#region src/lib/icon/definition.ts
 /**
-* Registers the visually-hidden element with the design system.
+* @internal
+*/
+var iconDefinition = defineVividComponent("icon", Icon, iconTemplate, [], { styles: icon_default });
+/**
+* Registers the icon component & its prerequisite components with the design system.
 *
 * @param prefix - the prefix to use for the component name
 */
-var registerVisuallyHidden = createRegisterFunction(visuallyHiddenDefinition);
+var registerIcon = createRegisterFunction(iconDefinition);
 //#endregion
-export { visuallyHiddenDefinition as n, VisuallyHidden as r, registerVisuallyHidden as t };
+export { registerIcon as n, Icon as r, iconDefinition as t };

package/unbundled/definition10.js

@@ -1,4 +1,4 @@
-import { c as createRegisterFunction, s as defineVividComponent, t as VividElement } from "./vivid-element.js";
+import { d as createRegisterFunction, t as VividElement, u as defineVividComponent } from "./vivid-element.js";
 import { t as __decorate } from "./decorate.js";
 import { i as Button, t as buttonDefinition } from "./definition7.js";
 import { r as Elevation, t as elevationDefinition } from "./definition8.js";

package/unbundled/definition11.js

@@ -1,4 +1,4 @@
-import { c as createRegisterFunction, s as defineVividComponent, t as VividElement } from "./vivid-element.js";
+import { d as createRegisterFunction, t as VividElement, u as defineVividComponent } from "./vivid-element.js";
 import { t as __decorate } from "./decorate.js";
 import { t as DelegatesAria } from "./delegates-aria.js";
 import { n as FormAssociated } from "./form-associated.js";