@vonage/vivid 3.48.0 → 3.49.0-preview.0

package/shared/definition16.cjs

@@ -0,0 +1,746 @@
+'use strict';
+
+const index = require('./index.cjs');
+const definition$1 = require('./definition26.cjs');
+const definition = require('./definition60.cjs');
+const definition$2 = require('./definition58.cjs');
+const definition$3 = require('./definition35.cjs');
+const textField = require('./text-field.cjs');
+const affix = require('./affix.cjs');
+const index$1 = require('./index2.cjs');
+const listbox = require('./listbox.cjs');
+const startEnd = require('./start-end.cjs');
+const select_options = require('./select.options.cjs');
+const applyMixins = require('./apply-mixins.cjs');
+const formAssociated = require('./form-associated.cjs');
+const numbers = require('./numbers.cjs');
+const strings = require('./strings.cjs');
+const focus = require('./focus2.cjs');
+const ref = require('./ref.cjs');
+const slotted = require('./slotted.cjs');
+const when = require('./when.cjs');
+const classNames = require('./class-names.cjs');
+
+class _Combobox extends listbox.Listbox$1 {
+}
+/**
+ * A form-associated base class for the {@link (Combobox:class)} component.
+ *
+ * @internal
+ */
+class FormAssociatedCombobox extends formAssociated.FormAssociated(_Combobox) {
+    constructor() {
+        super(...arguments);
+        this.proxy = document.createElement("input");
+    }
+}
+
+/**
+ * Autocomplete values for combobox.
+ * @public
+ */
+const ComboboxAutocomplete = {
+    inline: "inline",
+    list: "list",
+    both: "both",
+    none: "none",
+};
+
+/**
+ * A Combobox Custom HTML Element.
+ * Implements the {@link https://w3c.github.io/aria-practices/#combobox | ARIA combobox }.
+ *
+ * @slot start - Content which can be provided before the input
+ * @slot end - Content which can be provided after the input
+ * @slot control - Used to replace the input element representing the combobox
+ * @slot indicator - The visual indicator representing the expanded state
+ * @slot - The default slot for the options
+ * @csspart control - The wrapper element containing the input area, including start and end
+ * @csspart selected-value - The input element representing the selected value
+ * @csspart indicator - The element wrapping the indicator slot
+ * @csspart listbox - The wrapper for the listbox slotted options
+ * @fires change - Fires a custom 'change' event when the value updates
+ *
+ * @public
+ */
+let Combobox$1 = class Combobox extends FormAssociatedCombobox {
+    constructor() {
+        super(...arguments);
+        /**
+         * The internal value property.
+         *
+         * @internal
+         */
+        this._value = "";
+        /**
+         * The collection of currently filtered options.
+         *
+         * @public
+         */
+        this.filteredOptions = [];
+        /**
+         * The current filter value.
+         *
+         * @internal
+         */
+        this.filter = "";
+        /**
+         * The initial state of the position attribute.
+         *
+         * @internal
+         */
+        this.forcedPosition = false;
+        /**
+         * The unique id for the internal listbox element.
+         *
+         * @internal
+         */
+        this.listboxId = strings.uniqueId("listbox-");
+        /**
+         * The max height for the listbox when opened.
+         *
+         * @internal
+         */
+        this.maxHeight = 0;
+        /**
+         * The open attribute.
+         *
+         * @public
+         * @remarks
+         * HTML Attribute: open
+         */
+        this.open = false;
+    }
+    /**
+     * Reset the element to its first selectable option when its parent form is reset.
+     *
+     * @internal
+     */
+    formResetCallback() {
+        super.formResetCallback();
+        this.setDefaultSelectedOption();
+        this.updateValue();
+    }
+    /** {@inheritDoc (FormAssociated:interface).validate} */
+    validate() {
+        super.validate(this.control);
+    }
+    get isAutocompleteInline() {
+        return (this.autocomplete === ComboboxAutocomplete.inline || this.isAutocompleteBoth);
+    }
+    get isAutocompleteList() {
+        return this.autocomplete === ComboboxAutocomplete.list || this.isAutocompleteBoth;
+    }
+    get isAutocompleteBoth() {
+        return this.autocomplete === ComboboxAutocomplete.both;
+    }
+    /**
+     * Sets focus and synchronize ARIA attributes when the open property changes.
+     *
+     * @param prev - the previous open value
+     * @param next - the current open value
+     *
+     * @internal
+     */
+    openChanged() {
+        if (this.open) {
+            this.ariaControls = this.listboxId;
+            this.ariaExpanded = "true";
+            this.setPositioning();
+            this.focusAndScrollOptionIntoView();
+            // focus is directed to the element when `open` is changed programmatically
+            index.DOM.queueUpdate(() => this.focus());
+            return;
+        }
+        this.ariaControls = "";
+        this.ariaExpanded = "false";
+    }
+    /**
+     * The list of options.
+     *
+     * @public
+     * @remarks
+     * Overrides `Listbox.options`.
+     */
+    get options() {
+        index.Observable.track(this, "options");
+        return this.filteredOptions.length ? this.filteredOptions : this._options;
+    }
+    set options(value) {
+        this._options = value;
+        index.Observable.notify(this, "options");
+    }
+    /**
+     * Updates the placeholder on the proxy element.
+     * @internal
+     */
+    placeholderChanged() {
+        if (this.proxy instanceof HTMLInputElement) {
+            this.proxy.placeholder = this.placeholder;
+        }
+    }
+    positionChanged(prev, next) {
+        this.positionAttribute = next;
+        this.setPositioning();
+    }
+    /**
+     * The value property.
+     *
+     * @public
+     */
+    get value() {
+        index.Observable.track(this, "value");
+        return this._value;
+    }
+    set value(next) {
+        var _a, _b, _c;
+        const prev = `${this._value}`;
+        if (this.$fastController.isConnected && this.options) {
+            const selectedIndex = this.options.findIndex(el => el.text.toLowerCase() === next.toLowerCase());
+            const prevSelectedValue = (_a = this.options[this.selectedIndex]) === null || _a === void 0 ? void 0 : _a.text;
+            const nextSelectedValue = (_b = this.options[selectedIndex]) === null || _b === void 0 ? void 0 : _b.text;
+            this.selectedIndex =
+                prevSelectedValue !== nextSelectedValue
+                    ? selectedIndex
+                    : this.selectedIndex;
+            next = ((_c = this.firstSelectedOption) === null || _c === void 0 ? void 0 : _c.text) || next;
+        }
+        if (prev !== next) {
+            this._value = next;
+            super.valueChanged(prev, next);
+            index.Observable.notify(this, "value");
+        }
+    }
+    /**
+     * Handle opening and closing the listbox when the combobox is clicked.
+     *
+     * @param e - the mouse event
+     * @internal
+     */
+    clickHandler(e) {
+        if (this.disabled) {
+            return;
+        }
+        if (this.open) {
+            const captured = e.target.closest(`option,[role=option]`);
+            if (!captured || captured.disabled) {
+                return;
+            }
+            this.selectedOptions = [captured];
+            this.control.value = captured.text;
+            this.clearSelectionRange();
+            this.updateValue(true);
+        }
+        this.open = !this.open;
+        if (this.open) {
+            this.control.focus();
+        }
+        return true;
+    }
+    connectedCallback() {
+        super.connectedCallback();
+        this.forcedPosition = !!this.positionAttribute;
+        if (this.value) {
+            this.initialValue = this.value;
+        }
+    }
+    /**
+     * Synchronize the `aria-disabled` property when the `disabled` property changes.
+     *
+     * @param prev - The previous disabled value
+     * @param next - The next disabled value
+     *
+     * @internal
+     */
+    disabledChanged(prev, next) {
+        if (super.disabledChanged) {
+            super.disabledChanged(prev, next);
+        }
+        this.ariaDisabled = this.disabled ? "true" : "false";
+    }
+    /**
+     * Filter available options by text value.
+     *
+     * @public
+     */
+    filterOptions() {
+        if (!this.autocomplete || this.autocomplete === ComboboxAutocomplete.none) {
+            this.filter = "";
+        }
+        const filter = this.filter.toLowerCase();
+        this.filteredOptions = this._options.filter(o => o.text.toLowerCase().startsWith(this.filter.toLowerCase()));
+        if (this.isAutocompleteList) {
+            if (!this.filteredOptions.length && !filter) {
+                this.filteredOptions = this._options;
+            }
+            this._options.forEach(o => {
+                o.hidden = !this.filteredOptions.includes(o);
+            });
+        }
+    }
+    /**
+     * Focus the control and scroll the first selected option into view.
+     *
+     * @internal
+     * @remarks
+     * Overrides: `Listbox.focusAndScrollOptionIntoView`
+     */
+    focusAndScrollOptionIntoView() {
+        if (this.contains(document.activeElement)) {
+            this.control.focus();
+            if (this.firstSelectedOption) {
+                requestAnimationFrame(() => {
+                    var _a;
+                    (_a = this.firstSelectedOption) === null || _a === void 0 ? void 0 : _a.scrollIntoView({ block: "nearest" });
+                });
+            }
+        }
+    }
+    /**
+     * Handle focus state when the element or its children lose focus.
+     *
+     * @param e - The focus event
+     * @internal
+     */
+    focusoutHandler(e) {
+        this.syncValue();
+        if (!this.open) {
+            return true;
+        }
+        const focusTarget = e.relatedTarget;
+        if (this.isSameNode(focusTarget)) {
+            this.focus();
+            return;
+        }
+        if (!this.options || !this.options.includes(focusTarget)) {
+            this.open = false;
+        }
+    }
+    /**
+     * Handle content changes on the control input.
+     *
+     * @param e - the input event
+     * @internal
+     */
+    inputHandler(e) {
+        this.filter = this.control.value;
+        this.filterOptions();
+        if (!this.isAutocompleteInline) {
+            this.selectedIndex = this.options
+                .map(option => option.text)
+                .indexOf(this.control.value);
+        }
+        if (e.inputType.includes("deleteContent") || !this.filter.length) {
+            return true;
+        }
+        if (this.isAutocompleteList && !this.open) {
+            this.open = true;
+        }
+        if (this.isAutocompleteInline) {
+            if (this.filteredOptions.length) {
+                this.selectedOptions = [this.filteredOptions[0]];
+                this.selectedIndex = this.options.indexOf(this.firstSelectedOption);
+                this.setInlineSelection();
+            }
+            else {
+                this.selectedIndex = -1;
+            }
+        }
+        return;
+    }
+    /**
+     * Handle keydown actions for listbox navigation.
+     *
+     * @param e - the keyboard event
+     * @internal
+     */
+    keydownHandler(e) {
+        const key = e.key;
+        if (e.ctrlKey || e.shiftKey) {
+            return true;
+        }
+        switch (key) {
+            case "Enter": {
+                this.syncValue();
+                if (this.isAutocompleteInline) {
+                    this.filter = this.value;
+                }
+                this.open = false;
+                this.clearSelectionRange();
+                break;
+            }
+            case "Escape": {
+                if (!this.isAutocompleteInline) {
+                    this.selectedIndex = -1;
+                }
+                if (this.open) {
+                    this.open = false;
+                    break;
+                }
+                this.value = "";
+                this.control.value = "";
+                this.filter = "";
+                this.filterOptions();
+                break;
+            }
+            case "Tab": {
+                this.setInputToSelection();
+                if (!this.open) {
+                    return true;
+                }
+                e.preventDefault();
+                this.open = false;
+                break;
+            }
+            case "ArrowUp":
+            case "ArrowDown": {
+                this.filterOptions();
+                if (!this.open) {
+                    this.open = true;
+                    break;
+                }
+                if (this.filteredOptions.length > 0) {
+                    super.keydownHandler(e);
+                }
+                if (this.isAutocompleteInline) {
+                    this.setInlineSelection();
+                }
+                break;
+            }
+            default: {
+                return true;
+            }
+        }
+    }
+    /**
+     * Handle keyup actions for value input and text field manipulations.
+     *
+     * @param e - the keyboard event
+     * @internal
+     */
+    keyupHandler(e) {
+        const key = e.key;
+        switch (key) {
+            case "ArrowLeft":
+            case "ArrowRight":
+            case "Backspace":
+            case "Delete":
+            case "Home":
+            case "End": {
+                this.filter = this.control.value;
+                this.selectedIndex = -1;
+                this.filterOptions();
+                break;
+            }
+        }
+    }
+    /**
+     * Ensure that the selectedIndex is within the current allowable filtered range.
+     *
+     * @param prev - the previous selected index value
+     * @param next - the current selected index value
+     *
+     * @internal
+     */
+    selectedIndexChanged(prev, next) {
+        if (this.$fastController.isConnected) {
+            next = numbers.limit(-1, this.options.length - 1, next);
+            // we only want to call the super method when the selectedIndex is in range
+            if (next !== this.selectedIndex) {
+                this.selectedIndex = next;
+                return;
+            }
+            super.selectedIndexChanged(prev, next);
+        }
+    }
+    /**
+     * Move focus to the previous selectable option.
+     *
+     * @internal
+     * @remarks
+     * Overrides `Listbox.selectPreviousOption`
+     */
+    selectPreviousOption() {
+        if (!this.disabled && this.selectedIndex >= 0) {
+            this.selectedIndex = this.selectedIndex - 1;
+        }
+    }
+    /**
+     * Set the default selected options at initialization or reset.
+     *
+     * @internal
+     * @remarks
+     * Overrides `Listbox.setDefaultSelectedOption`
+     */
+    setDefaultSelectedOption() {
+        if (this.$fastController.isConnected && this.options) {
+            const selectedIndex = this.options.findIndex(el => el.getAttribute("selected") !== null || el.selected);
+            this.selectedIndex = selectedIndex;
+            if (!this.dirtyValue && this.firstSelectedOption) {
+                this.value = this.firstSelectedOption.text;
+            }
+            this.setSelectedOptions();
+        }
+    }
+    /**
+     * Focus and set the content of the control based on the first selected option.
+     *
+     * @internal
+     */
+    setInputToSelection() {
+        if (this.firstSelectedOption) {
+            this.control.value = this.firstSelectedOption.text;
+            this.control.focus();
+        }
+    }
+    /**
+     * Focus, set and select the content of the control based on the first selected option.
+     *
+     * @internal
+     */
+    setInlineSelection() {
+        if (this.firstSelectedOption) {
+            this.setInputToSelection();
+            this.control.setSelectionRange(this.filter.length, this.control.value.length, "backward");
+        }
+    }
+    /**
+     * Determines if a value update should involve emitting a change event, then updates the value.
+     *
+     * @internal
+     */
+    syncValue() {
+        var _a;
+        const newValue = this.selectedIndex > -1 ? (_a = this.firstSelectedOption) === null || _a === void 0 ? void 0 : _a.text : this.control.value;
+        this.updateValue(this.value !== newValue);
+    }
+    /**
+     * Calculate and apply listbox positioning based on available viewport space.
+     *
+     * @param force - direction to force the listbox to display
+     * @public
+     */
+    setPositioning() {
+        const currentBox = this.getBoundingClientRect();
+        const viewportHeight = window.innerHeight;
+        const availableBottom = viewportHeight - currentBox.bottom;
+        this.position = this.forcedPosition
+            ? this.positionAttribute
+            : currentBox.top > availableBottom
+                ? select_options.SelectPosition.above
+                : select_options.SelectPosition.below;
+        this.positionAttribute = this.forcedPosition
+            ? this.positionAttribute
+            : this.position;
+        this.maxHeight =
+            this.position === select_options.SelectPosition.above ? ~~currentBox.top : ~~availableBottom;
+    }
+    /**
+     * Ensure that the entire list of options is used when setting the selected property.
+     *
+     * @param prev - the previous list of selected options
+     * @param next - the current list of selected options
+     *
+     * @internal
+     * @remarks
+     * Overrides: `Listbox.selectedOptionsChanged`
+     */
+    selectedOptionsChanged(prev, next) {
+        if (this.$fastController.isConnected) {
+            this._options.forEach(o => {
+                o.selected = next.includes(o);
+            });
+        }
+    }
+    /**
+     * Synchronize the form-associated proxy and update the value property of the element.
+     *
+     * @param prev - the previous collection of slotted option elements
+     * @param next - the next collection of slotted option elements
+     *
+     * @internal
+     */
+    slottedOptionsChanged(prev, next) {
+        super.slottedOptionsChanged(prev, next);
+        this.updateValue();
+    }
+    /**
+     * Sets the value and to match the first selected option.
+     *
+     * @param shouldEmit - if true, the change event will be emitted
+     *
+     * @internal
+     */
+    updateValue(shouldEmit) {
+        var _a;
+        if (this.$fastController.isConnected) {
+            this.value = ((_a = this.firstSelectedOption) === null || _a === void 0 ? void 0 : _a.text) || this.control.value;
+            this.control.value = this.value;
+        }
+        if (shouldEmit) {
+            this.$emit("change");
+        }
+    }
+    /**
+     * @internal
+     */
+    clearSelectionRange() {
+        const controlValueLength = this.control.value.length;
+        this.control.setSelectionRange(controlValueLength, controlValueLength);
+    }
+};
+index.__decorate([
+    index.attr({ attribute: "autocomplete", mode: "fromView" })
+], Combobox$1.prototype, "autocomplete", void 0);
+index.__decorate([
+    index.observable
+], Combobox$1.prototype, "maxHeight", void 0);
+index.__decorate([
+    index.attr({ attribute: "open", mode: "boolean" })
+], Combobox$1.prototype, "open", void 0);
+index.__decorate([
+    index.attr
+], Combobox$1.prototype, "placeholder", void 0);
+index.__decorate([
+    index.attr({ attribute: "position" })
+], Combobox$1.prototype, "positionAttribute", void 0);
+index.__decorate([
+    index.observable
+], Combobox$1.prototype, "position", void 0);
+/**
+ * Includes ARIA states and properties relating to the ARIA combobox role.
+ *
+ * @public
+ */
+class DelegatesARIACombobox {
+}
+index.__decorate([
+    index.observable
+], DelegatesARIACombobox.prototype, "ariaAutoComplete", void 0);
+index.__decorate([
+    index.observable
+], DelegatesARIACombobox.prototype, "ariaControls", void 0);
+applyMixins.applyMixins(DelegatesARIACombobox, listbox.DelegatesARIAListbox);
+applyMixins.applyMixins(Combobox$1, startEnd.StartEnd, DelegatesARIACombobox);
+
+const styles = ":host{position:relative}.base{--_text-field-gutter-end: 44px}.icon{inset-inline-end:16px;inset-inline-start:unset}:not(.disabled) .icon{cursor:pointer}.disabled .icon{cursor:not-allowed}.listbox{padding:4px;background-color:var(--_appearance-color-fill);border-radius:8px;box-shadow:inset 0 0 0 1px var(--_appearance-color-outline);contain:paint}.listbox{--_connotation-color-backdrop: var(--vvd-combobox-accent-backdrop, var(--vvd-color-canvas));--_connotation-color-intermediate: var(--vvd-combobox-accent-intermediate, var(--vvd-color-neutral-500));--_connotation-color-primary: var(--vvd-combobox-accent-primary, var(--vvd-color-canvas-text));--_connotation-color-soft: var(--vvd-combobox-accent-soft, var(--vvd-color-neutral-100))}.listbox{--_appearance-color-text: var(--vvd-color-canvas-text);--_appearance-color-fill: var(--_connotation-color-backdrop);--_appearance-color-outline: var(--_connotation-color-intermediate)}.listbox.appearance-ghost{--_appearance-color-text: var(--_connotation-color-primary);--_appearance-color-fill: transparent;--_appearance-color-outline: transparent}.listbox:where(:disabled,.disabled){--_appearance-color-text: var(--vvd-color-neutral-300);--_appearance-color-fill: var(--vvd-color-neutral-100);--_appearance-color-outline: var(--vvd-color-neutral-300)}.listbox:where(:disabled,.disabled).appearance-ghost{--_appearance-color-text: var(--vvd-color-neutral-300);--_appearance-color-fill: transparent;--_appearance-color-outline: transparent}::part(popup-base){inline-size:100%}\n";
+
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __decorateClass = (decorators, target, key, kind) => {
+  var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
+  for (var i = decorators.length - 1, decorator; i >= 0; i--)
+    if (decorator = decorators[i])
+      result = (kind ? decorator(target, key, result) : decorator(result)) || result;
+  if (kind && result)
+    __defProp(target, key, result);
+  return result;
+};
+let Combobox = class extends Combobox$1 {
+  connectedCallback() {
+    super.connectedCallback();
+    this._popup.anchor = this._anchor;
+  }
+};
+__decorateClass([
+  index.attr
+], Combobox.prototype, "placement", 2);
+Combobox = __decorateClass([
+  index$1.formElements
+], Combobox);
+applyMixins.applyMixins(Combobox, affix.AffixIcon);
+
+function renderLabel() {
+  return index.html`
+	  <label for="control" class="label">
+		  ${(x) => x.label}
+	  </label>`;
+}
+const getStateClasses = ({
+  disabled,
+  placeholder,
+  label
+}) => classNames.classNames(
+  "base",
+  ["disabled", disabled],
+  ["placeholder", Boolean(placeholder)],
+  ["no-label", !label]
+);
+function renderInput(context) {
+  const affixIconTemplate = affix.affixIconTemplateFactory(context);
+  const focusTemplate = focus.focusTemplateFactory(context);
+  return index.html`
+		<div class="${getStateClasses}" ${ref.ref("_anchor")}>
+			${when.when((x) => x.label, renderLabel())}
+			<div class="fieldset">
+				<input
+					id="control"
+					class="control"
+					aria-activedescendant="${(x) => x.open ? x.ariaActiveDescendant : null}"
+					aria-autocomplete="${(x) => x.ariaAutoComplete}"
+					aria-controls="${(x) => x.ariaControls}"
+					aria-disabled="${(x) => x.ariaDisabled}"
+					aria-expanded="${(x) => x.ariaExpanded}"
+					aria-haspopup="listbox"
+					placeholder="${(x) => x.placeholder}"
+					role="combobox"
+					type="text"
+					?disabled="${(x) => x.disabled}"
+					:value="${(x) => x.value}"
+					@input="${(x, c) => x.inputHandler(c.event)}"
+					@keyup="${(x, c) => x.keyupHandler(c.event)}"
+					${ref.ref("control")}
+				/>
+				${() => affixIconTemplate("chevron-down-line")}
+				${() => focusTemplate}
+			</div>
+		</div>`;
+}
+const comboboxTemplate = (context) => {
+  const popupTag = context.tagFor(definition.Popup);
+  return index.html`
+        <template
+            aria-disabled="${(x) => x.ariaDisabled}"
+            autocomplete="${(x) => x.autocomplete}"
+            tabindex="${(x) => !x.disabled ? "0" : null}"
+            @click="${(x, c) => x.clickHandler(c.event)}"
+            @focusout="${(x, c) => x.focusoutHandler(c.event)}"
+            @keydown="${(x, c) => x.keydownHandler(c.event)}"
+        >
+			${() => renderInput(context)}
+			<${popupTag} class="popup"
+				?open="${(x) => x.open}"
+				placement="${(x) => x.placement}"
+				strategy="absolute"
+				${ref.ref("_popup")}>
+				<div id="${(x) => x.listboxId}"
+					class="listbox"
+					role="listbox"
+					?disabled="${(x) => x.disabled}"
+					${ref.ref("listbox")}>
+					<slot ${slotted.slotted({
+    filter: listbox.Listbox.slottedOptionFilter,
+    flatten: true,
+    property: "slottedOptions"
+  })}>
+					</slot>
+				</div>
+			</${popupTag}>
+        </template>
+		`;
+};
+
+const combobox = Combobox.compose({
+  baseName: "combobox",
+  template: comboboxTemplate,
+  styles: [textField.styles, styles],
+  shadowOptions: {
+    delegatesFocus: true
+  }
+})();
+const comboboxRegistries = [combobox, ...definition$1.iconRegistries, ...definition.popupRegistries, ...definition$2.focusRegistries, ...definition$3.listboxOptionRegistries];
+const registerCombobox = index.registerFactory(comboboxRegistries);
+
+exports.combobox = combobox;
+exports.comboboxRegistries = comboboxRegistries;
+exports.registerCombobox = registerCombobox;