@vonage/vivid 5.24.0 → 5.27.0

package/unbundled/definition55.js

@@ -1,57 +1,337 @@
 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 { t as isApplePlatform } from "./platform.js";
-import { html, observable, slotted } from "@microsoft/fast-element";
-//#region src/lib/platform-switch/platform-switch.scss?inline
-var platform_switch_default = ":host{display:contents}";
+import { t as AffixIcon } from "./affix.js";
+import { t as componentEnum } from "./component-enum.js";
+import { n as delegateAria, t as DelegatesAria } from "./delegates-aria.js";
+import { n as FormAssociated } from "./form-associated.js";
+import { t as Localized } from "./localized.js";
+import { i as Button, t as buttonDefinition } from "./definition6.js";
+import { u as Shape } from "./enums.js";
+import { t as Divider } from "./divider.js";
+import { n as visuallyHiddenDefinition, r as VisuallyHidden } from "./definition22.js";
+import { n as feedbackMessageDefinition } from "./feedback-message.js";
+import { t as FormElement } from "./form-element.js";
+import { t as WithErrorText } from "./with-error-text.js";
+import { t as WithSuccessText } from "./with-success-text.js";
+import { t as WithFeedback } from "./mixins.js";
+import { t as contextualHelpDefinition } from "./definition25.js";
+import { t as WithContextualHelp } from "./with-contextual-help.js";
+import { t as dividerDefinition } from "./definition36.js";
+import { Updates, attr, html, nullableNumberConverter, observable, ref, slotted, when } from "@microsoft/fast-element";
+import { classNames, keyArrowDown, keyArrowUp } from "@microsoft/fast-web-utilities";
+//#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{--_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}.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,:focus),.control::slotted(input:not(:focus)){text-overflow:ellipsis!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/platform-switch/platform-switch.ts
+//#region src/lib/number-field/number-field.ts
+var numberFieldAppearance = componentEnum(["fieldset", "ghost"], "fieldset");
+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 platform-switch
-* @slot - Default slot accepts children with optional platform constraints.
+* @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 PlatformSwitch = class extends VividElement {
+var NumberField = class extends WithContextualHelp(WithFeedback(WithErrorText(WithSuccessText(FormElement(AffixIcon(Localized(DelegatesAria(FormAssociated(VividElement))))))))) {
+	constructor(..._args) {
+		super(..._args);
+		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 */
-	slottedContentChanged() {
-		this.#updateVisibility();
-	}
-	#updateVisibility() {
-		const children = this.slottedContent.filter((n) => n instanceof HTMLElement);
-		let matched = false;
-		for (const child of children) {
-			if (matched) {
-				child.hidden = true;
-				continue;
-			}
-			if (this.#matches(child)) {
-				child.hidden = false;
-				matched = true;
-			} else child.hidden = true;
+	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
+	*/
+	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
+	*/
+	minChanged(_, next) {
+		this.min = Math.min(next, this.max ?? next);
+		this.proxy.min = this.min.toString();
+		this.validate();
+	}
+	/** The value property, typed as a number. */
+	get valueAsNumber() {
+		return parseFloat(this.value);
+	}
+	set valueAsNumber(next) {
+		this.value = next.toString();
+	}
+	/** @internal */
+	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");
 		}
 	}
-	#matches(el) {
-		const keyboard = isApplePlatform() ? "apple" : "standard";
-		const keyboardConstraint = el.dataset.keyboard;
-		if (keyboardConstraint === void 0) return true;
-		return keyboardConstraint === keyboard;
+	/** @internal */
+	get _numberPatterns() {
+		return this.locale.common.useCommaAsDecimalSeparator ? numberPatternsWithComma : numberPatternsWithPeriod;
+	}
+	#valueToPresentationValue(value) {
+		return value.replace(".", this.locale.common.useCommaAsDecimalSeparator ? "," : ".");
+	}
+	#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 : "";
+	}
+	/** Validates the Number Field against its constraints (e.g. `min`, `max`, `required`) and updates its validity state. */
+	validate() {
+		super.validate(this.control);
+	}
+	/** Increments the value using the step value */
+	stepUp() {
+		makeStep(this, STEP_DIRECTION.up);
+	}
+	/** Decrements the value using the step value */
+	stepDown() {
+		makeStep(this, STEP_DIRECTION.down);
+	}
+	/**
+	* Sets up the initial state of the number field
+	* @internal
+	*/
+	connectedCallback() {
+		super.connectedCallback();
+		this.proxy.setAttribute("type", "number");
+		this.validate();
+		this._presentationValue = this.#valueToPresentationValue(this.value);
+		if (this.autofocus) Updates.enqueue(() => {
+			this.focus();
+		});
+	}
+	/** Selects all the text in the number field */
+	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
+	*/
+	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
+	*/
+	handleChange() {
+		this.$emit("change");
+	}
+	/**
+	* Handles the internal control's `keydown` event
+	* @internal
+	*/
+	handleKeyDown(e) {
+		switch (e.key) {
+			case keyArrowUp:
+				this.stepUp();
+				return false;
+			case keyArrowDown:
+				this.stepDown();
+				return false;
+		}
+		return true;
 	}
 };
-__decorate([observable], PlatformSwitch.prototype, "slottedContent", void 0);
+__decorate([attr({
+	attribute: "readonly",
+	mode: "boolean"
+})], NumberField.prototype, "readOnly", void 0);
+__decorate([attr({ mode: "boolean" })], NumberField.prototype, "autofocus", void 0);
+__decorate([attr], NumberField.prototype, "placeholder", void 0);
+__decorate([attr], NumberField.prototype, "list", void 0);
+__decorate([attr({ converter: nullableNumberConverter })], NumberField.prototype, "maxlength", void 0);
+__decorate([attr({ converter: nullableNumberConverter })], NumberField.prototype, "minlength", void 0);
+__decorate([attr({ converter: nullableNumberConverter })], NumberField.prototype, "size", void 0);
+__decorate([attr()], NumberField.prototype, "scale", void 0);
+__decorate([attr({ converter: nullableNumberConverter })], NumberField.prototype, "step", void 0);
+__decorate([attr({ converter: nullableNumberConverter })], NumberField.prototype, "max", void 0);
+__decorate([attr({ converter: nullableNumberConverter })], NumberField.prototype, "min", void 0);
+__decorate([observable], NumberField.prototype, "defaultSlottedNodes", void 0);
+__decorate([observable], NumberField.prototype, "_presentationValue", void 0);
+__decorate([observable], NumberField.prototype, "_updatedValueAnnouncement", void 0);
+__decorate([attr({ attribute: "increment-button-aria-label" })], NumberField.prototype, "incrementButtonAriaLabel", void 0);
+__decorate([attr({ attribute: "decrement-button-aria-label" })], NumberField.prototype, "decrementButtonAriaLabel", void 0);
+__decorate([attr], NumberField.prototype, "appearance", void 0);
+__decorate([attr], NumberField.prototype, "shape", void 0);
+__decorate([attr], NumberField.prototype, "autoComplete", void 0);
 //#endregion
-//#region src/lib/platform-switch/platform-switch.template.ts
-var PlatformSwitchTemplate = () => {
-	return html`<slot ${slotted("slottedContent")}></slot>`;
+//#region src/lib/number-field/number-field.template.ts
+function renderLabel() {
+	return html` <label for="control" class="label">
+		${(x) => x.label}
+	</label>`;
+}
+function setControlButtonShape(numberField) {
+	return numberField.shape === Shape.Pill ? Shape.Pill : null;
+}
+function getTabIndex(numberField) {
+	return numberField.disabled || numberField.readOnly ? "-1" : null;
+}
+/** @param context - element definition context */
+function numberControlButtons(context) {
+	const buttonTag = context.tagFor(Button);
+	const dividerTag = context.tagFor(Divider);
+	return 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(VisuallyHidden);
+	return html`
+		<div class="base ${(x) => classNames(`connotation-accent`, `appearance-${numberFieldAppearance.parse(x.appearance)}`, "with-idle", "with-hover", "with-disabled", "with-readonly", "with-error", "with-success", ["error", Boolean(x.errorValidationMessage)], ["disabled", x.disabled], ["has-value", Boolean(x.value)], ["readonly", x.readOnly], ["placeholder", Boolean(x.placeholder)], [`shape-${x.shape}`, Boolean(x.shape)], ["no-label", !x.label], ["success", !!x.successText], [`size-${x.scale}`, Boolean(x.scale)])}">
+			<div class="label-wrapper" ?hidden=${(x) => !x.label && !x._hasContextualHelp}>
+				${when((x) => x.label, renderLabel())}
+				<slot name="contextual-help" ${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"
+						${delegateAria({ ariaDescribedBy: (x) => x._feedbackDescribedBy })}
+						${ref("control")}
+					/>
+				</div>
+				${() => numberControlButtons(context)}
+			</div>
+			${(x) => x._getFeedbackTemplate(context)}
+			<${visuallyHiddenTag} id="value-announcement" role="status" aria-atomic="true">
+				${(x) => x._updatedValueAnnouncement}</${visuallyHiddenTag}>
+		</div>
+	`;
 };
 //#endregion
-//#region src/lib/platform-switch/definition.ts
+//#region src/lib/number-field/definition.ts
 /** @internal */
-var platformSwitchDefinition = defineVividComponent("platform-switch", PlatformSwitch, PlatformSwitchTemplate, [], { styles: platform_switch_default });
+var numberFieldDefinition = defineVividComponent("number-field", NumberField, NumberFieldTemplate, [
+	buttonDefinition,
+	dividerDefinition,
+	iconDefinition,
+	feedbackMessageDefinition,
+	visuallyHiddenDefinition,
+	contextualHelpDefinition
+], {
+	styles: number_field_default,
+	shadowOptions: { delegatesFocus: true }
+});
 /**
-* Registers the platform-switch 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 registerPlatformSwitch = createRegisterFunction(platformSwitchDefinition);
+var registerNumberField = createRegisterFunction(numberFieldDefinition);
 //#endregion
-export { registerPlatformSwitch as n, PlatformSwitch as r, platformSwitchDefinition as t };
+export { registerNumberField as n, NumberField as r, numberFieldDefinition as t };