@scania/tegel 1.24.0-value-prop.beta.6 → 1.25.0-fix-a11y-checkbox-beta.1

package/dist/collection/components/dropdown/dropdown.js

@@ -2,20 +2,41 @@ import { Host, h, } from "@stencil/core";
 import findNextFocusableElement from "../../utils/findNextFocusableElement";
 import findPreviousFocusableElement from "../../utils/findPreviousFocusableElement";
 import appendHiddenInput from "../../utils/appendHiddenInput";
+import { convertToString, convertArrayToStrings } from "../../utils/convertToString";
 /**
  * @slot <default> - <b>Unnamed slot.</b> For dropdown option elements.
  */
 export class TdsDropdown {
     constructor() {
         this.setDefaultOption = () => {
-            if (this.defaultValue) {
+            if (this.internalDefaultValue) {
+                const children = Array.from(this.host.children).filter((element) => element.tagName === 'TDS-DROPDOWN-OPTION');
+                if (children.length === 0) {
+                    console.warn('TDS DROPDOWN: No options found. Disregard if loading data asynchronously.');
+                    return;
+                }
                 const defaultValues = this.multiselect
-                    ? new Set(this.defaultValue.split(','))
-                    : [this.defaultValue];
-                const normalizedValues = Array.from(defaultValues);
-                this.updateDropdownState(normalizedValues);
+                    ? new Set(this.internalDefaultValue.split(','))
+                    : [this.internalDefaultValue];
+                const childrenMap = new Map(children.map((element) => [element.value, element]));
+                const matchedValues = Array.from(defaultValues).filter((value) => {
+                    const element = childrenMap.get(value);
+                    if (element) {
+                        element.setSelected(true);
+                        return true;
+                    }
+                    return false;
+                });
+                if (matchedValues.length > 0) {
+                    this.value = [...new Set(this.value ? [...this.value, ...matchedValues] : matchedValues)];
+                    this.setValueAttribute();
+                }
+                else {
+                    console.warn(`TDS DROPDOWN: No matching option found for defaultValue "${this.internalDefaultValue}"`);
+                }
             }
         };
+        /* Returns a list of all children that are tds-dropdown-option elements */
         this.getChildren = () => {
             const tdsDropdownOptions = Array.from(this.host.children).filter((element) => element.tagName === 'TDS-DROPDOWN-OPTION');
             if (tdsDropdownOptions.length === 0) {
@@ -24,36 +45,6 @@ export class TdsDropdown {
             else
                 return tdsDropdownOptions;
         };
-        this.getSelectedChildren = () => {
-            if (this.selectedOptions.length === 0)
-                return [];
-            return this.selectedOptions
-                .map((stringValue) => {
-                var _a;
-                const matchingElement = (_a = this.getChildren()) === null || _a === void 0 ? void 0 : _a.find((element) => element.value === stringValue);
-                return matchingElement;
-            })
-                .filter(Boolean);
-        };
-        this.getSelectedChildrenLabels = () => {
-            var _a;
-            return (_a = this.getSelectedChildren()) === null || _a === void 0 ? void 0 : _a.map((element) => element.textContent.trim());
-        };
-        this.getValue = () => {
-            const labels = this.getSelectedChildrenLabels();
-            if (!labels) {
-                return '';
-            }
-            return labels === null || labels === void 0 ? void 0 : labels.join(', ');
-        };
-        this.setValueAttribute = () => {
-            if (this.selectedOptions.length === 0) {
-                this.host.removeAttribute('value');
-            }
-            else {
-                this.host.setAttribute('value', this.selectedOptions.join(','));
-            }
-        };
         this.getOpenDirection = () => {
             var _a, _b, _c, _d, _e;
             if (this.openDirection === 'auto' || !this.openDirection) {
@@ -67,6 +58,7 @@ export class TdsDropdown {
             }
             return this.openDirection;
         };
+        /* Toggles the open state of the Dropdown and sets focus to the input element */
         this.handleToggleOpen = () => {
             if (!this.disabled) {
                 this.open = !this.open;
@@ -75,10 +67,38 @@ export class TdsDropdown {
                 }
             }
         };
+        /* Focuses the input element in the Dropdown, if the reference is present. */
         this.focusInputElement = () => {
             if (this.inputElement)
                 this.inputElement.focus();
         };
+        this.getSelectedChildren = () => {
+            var _a;
+            return (_a = this.value) === null || _a === void 0 ? void 0 : _a.map((stringValue) => {
+                const matchingElement = this.getChildren().find((element) => element.value === stringValue);
+                return matchingElement;
+            }).filter(Boolean);
+        };
+        this.getSelectedChildrenLabels = () => {
+            var _a;
+            return (_a = this.getSelectedChildren()) === null || _a === void 0 ? void 0 : _a.map((element) => element.textContent.trim());
+        };
+        this.getValue = () => {
+            const labels = this.getSelectedChildrenLabels();
+            if (!labels) {
+                return '';
+            }
+            return labels === null || labels === void 0 ? void 0 : labels.join(', ');
+        };
+        this.setValueAttribute = () => {
+            var _a;
+            if (!this.value || ((_a = this.value) === null || _a === void 0 ? void 0 : _a.toString()) === '') {
+                this.host.removeAttribute('value');
+            }
+            else {
+                this.host.setAttribute('value', convertArrayToStrings(this.value).join(','));
+            }
+        };
         this.handleFilter = (event) => {
             this.tdsInput.emit(event);
             const query = event.target.value.toLowerCase();
@@ -109,10 +129,8 @@ export class TdsDropdown {
         this.handleFilterReset = () => {
             this.reset();
             this.inputElement.value = '';
-            this.handleFilter({ target: { value: '' } });
+            this.handleFilter({ target: { value: this.inputElement.value } });
             this.inputElement.focus();
-            // Add this line to ensure internal value is cleared
-            this.internalValue = '';
         };
         this.handleFocus = (event) => {
             this.open = true;
@@ -126,6 +144,12 @@ export class TdsDropdown {
         this.handleBlur = (event) => {
             this.tdsBlur.emit(event);
         };
+        this.handleChange = () => {
+            this.tdsChange.emit({
+                name: this.name,
+                value: this.value ? convertArrayToStrings(this.value).join(',') : null,
+            });
+        };
         this.resetInput = () => {
             const inputEl = this.host.querySelector('input');
             if (inputEl) {
@@ -148,101 +172,110 @@ export class TdsDropdown {
         this.normalizeText = true;
         this.noResultText = 'No result';
         this.defaultValue = undefined;
-        this.value = null;
         this.open = false;
-        this.internalValue = undefined;
+        this.value = undefined;
         this.filterResult = undefined;
         this.filterFocus = undefined;
-        this.selectedOptions = [];
-    }
-    handleValueChange(newValue) {
-        // Normalize to array
-        const normalizedValue = this.normalizeValue(newValue);
-        // Only update if actually changed
-        if (this.hasValueChanged(normalizedValue, this.selectedOptions)) {
-            this.updateDropdownState(normalizedValue);
-        }
-    }
-    normalizeValue(value) {
-        if (!value || value === '')
-            return []; // Handle both null and empty string
-        // For multiselect, keep array. For single select, wrap in array
-        if (this.multiselect) {
-            return Array.isArray(value) ? value : value.split(',').filter((v) => v !== '');
-        }
-        return Array.isArray(value) ? value : [value];
+        this.internalDefaultValue = undefined;
     }
-    hasValueChanged(newValue, currentValue) {
-        if (newValue.length !== currentValue.length)
-            return true;
-        return newValue.some((val) => !currentValue.includes(val));
+    /** Method that resets the Dropdown, marks all children as non-selected and resets the value to null. */
+    async reset() {
+        this.dropdownList.scrollTop = 0;
+        this.internalReset();
+        this.handleChange();
     }
-    updateDropdownState(values) {
-        // Update internal state
-        this.selectedOptions = [...this.validateValues(values)]; // Force new array reference
-        // Then update the value prop to match
-        this.value = this.multiselect ? this.selectedOptions : this.selectedOptions[0] || null;
-        // Force update of internal value
-        this.internalValue = this.getValue();
-        // Update DOM
-        this.updateOptionElements();
-        // Update display value
-        this.updateDisplayValue();
-        // Emit change event
-        this.emitChange();
-        // Update value attribute
-        this.setValueAttribute();
+    /** Method that forces focus on the input element. */
+    async focusElement() {
+        this.focusInputElement();
+        this.handleFocus({});
     }
-    validateValues(values) {
-        return values.filter((val) => {
-            var _a;
-            const isValid = (_a = this.getChildren()) === null || _a === void 0 ? void 0 : _a.some((element) => element.value === val);
-            if (!isValid) {
-                console.warn(`Option with value "${val}" does not exist`);
+    /** Method for setting the value of the Dropdown.
+     *
+     * Single selection example:
+     *
+     * <code>
+     *  dropdown.setValue('option-1', 'Option 1');
+     * </code>
+     *
+     * Multiselect example:
+     *
+     * <code>
+     *  dropdown.setValue(['option-1', 'option-2']);
+     * </code>
+     */
+    //  The label is optional here ONLY to not break the API. Should be removed for 2.0.
+    // @ts-ignore
+    // eslint-disable-next-line no-unused-vars, @typescript-eslint/no-unused-vars
+    async setValue(value) {
+        let nextValue;
+        if (Array.isArray(value)) {
+            nextValue = convertArrayToStrings(value);
+        }
+        else {
+            nextValue = [convertToString(value)];
+        }
+        if (!this.multiselect && nextValue.length > 1) {
+            console.warn('Tried to select multiple items, but multiselect is not enabled.');
+            nextValue = [nextValue[0]];
+        }
+        nextValue = [...new Set(nextValue)];
+        this.internalReset();
+        for (let i = 0; i < nextValue.length; i++) {
+            const optionExist = this.getChildren().some((element) => element.value === nextValue[i]);
+            if (!optionExist) {
+                nextValue.splice(i, 1);
             }
-            return isValid;
-        });
-    }
-    updateOptionElements() {
-        var _a;
-        (_a = this.getChildren()) === null || _a === void 0 ? void 0 : _a.forEach((element) => {
-            element.setSelected(this.selectedOptions.includes(element.value));
-        });
-    }
-    updateDisplayValue() {
-        this.internalValue = this.getSelectedChildrenLabels().join(', ');
-        if (this.filter && this.inputElement) {
-            this.inputElement.value = this.internalValue;
         }
-    }
-    emitChange() {
-        const value = this.multiselect
-            ? this.selectedOptions.join(',')
-            : this.selectedOptions[0] || null;
-        this.tdsChange.emit({
-            name: this.name,
-            value: value !== null && value !== void 0 ? value : null,
-        });
-    }
-    async setValue(value) {
-        const normalizedValue = this.normalizeValue(value);
-        this.updateDropdownState(normalizedValue);
-        return this.getSelectedChildren().map((element) => ({
+        this.value = nextValue;
+        this.setValueAttribute();
+        this.selectChildrenAsSelectedBasedOnSelectionProp();
+        this.handleChange();
+        /* This returns an array of object with a value and label pair. This is ONLY to not break the API. Should be removed for 2.0. */
+        /* https://tegel.atlassian.net/browse/CDEP-2703 */
+        const selection = this.getSelectedChildren().map((element) => ({
             value: element.value,
             label: element.textContent.trim(),
         }));
+        // Update inputElement value and placeholder text
+        if (this.filter) {
+            this.inputElement.value = this.getValue();
+        }
+        return selection;
     }
-    async reset() {
-        this.updateDropdownState([]);
+    /**
+     * @internal
+     */
+    async appendValue(value) {
+        if (this.multiselect && this.value) {
+            this.setValue([...this.value, value]);
+        }
+        else {
+            this.setValue(value);
+        }
     }
+    /** Method for removing a selected value in the Dropdown. */
     async removeValue(oldValue) {
-        const newValues = this.selectedOptions.filter((v) => v !== oldValue);
-        this.updateDropdownState(newValues);
-    }
-    /** Method that forces focus on the input element. */
-    async focusElement() {
-        this.focusInputElement();
-        this.handleFocus({});
+        var _a, _b;
+        let label;
+        if (this.multiselect) {
+            (_a = this.getChildren()) === null || _a === void 0 ? void 0 : _a.forEach((element) => {
+                var _a;
+                if (element.value === oldValue) {
+                    this.value = (_a = this.value) === null || _a === void 0 ? void 0 : _a.filter((value) => value !== element.value);
+                    label = element.textContent.trim();
+                    element.setSelected(false);
+                }
+                return element;
+            });
+        }
+        else {
+            this.reset();
+        }
+        this.handleChange();
+        this.setValueAttribute();
+        /* This returns an array of object with a value and label pair. This is ONLY to not break the API. Should be removed for 2.0. */
+        /* https://tegel.atlassian.net/browse/CDEP-2703 */
+        return (_b = this.value) === null || _b === void 0 ? void 0 : _b.map((value) => ({ value, label }));
     }
     /** Method for closing the Dropdown. */
     async close() {
@@ -291,15 +324,21 @@ export class TdsDropdown {
     handleOpenState() {
         if (this.filter && this.multiselect) {
             if (!this.open) {
-                this.inputElement.value = this.selectedOptions.length ? this.getValue() : '';
+                this.inputElement.value = this.getValue();
             }
         }
     }
+    handleDefaultValueChange(newValue) {
+        if (newValue !== undefined && newValue !== null) {
+            this.internalDefaultValue = convertToString(newValue);
+            this.setDefaultOption();
+        }
+    }
     componentWillLoad() {
-        if (this.defaultValue && !this.value) {
-            const initialValue = this.multiselect ? this.defaultValue.split(',') : [this.defaultValue];
-            this.updateDropdownState(initialValue);
+        if (this.defaultValue !== undefined && this.defaultValue !== null) {
+            this.internalDefaultValue = convertToString(this.defaultValue);
         }
+        this.setDefaultOption();
     }
     /** Method to handle slot changes */
     handleSlotChange() {
@@ -309,13 +348,29 @@ export class TdsDropdown {
     normalizeString(text) {
         return this.normalizeText ? text.normalize('NFD').replace(/\p{Diacritic}/gu, '') : text;
     }
-    async appendValue(value) {
-        if (this.multiselect) {
-            this.updateDropdownState([...this.selectedOptions, value]);
-        }
-        else {
-            this.updateDropdownState([value]);
-        }
+    /** Method that resets the dropdown without emitting an event. */
+    internalReset() {
+        this.getChildren().forEach((element) => {
+            element.setSelected(false);
+            return element;
+        });
+        this.value = null;
+        this.setValueAttribute();
+    }
+    selectChildrenAsSelectedBasedOnSelectionProp() {
+        this.getChildren().forEach((element) => {
+            this.value.forEach((selection) => {
+                if (element.value !== selection) {
+                    // If not multiselect, we need to unselect all other options.
+                    if (!this.multiselect) {
+                        element.setSelected(false);
+                    }
+                }
+                else {
+                    element.setSelected(true);
+                }
+            });
+        });
     }
     componentDidRender() {
         const form = this.host.closest('form');
@@ -330,8 +385,15 @@ export class TdsDropdown {
         }
     }
     render() {
-        appendHiddenInput(this.host, this.name, this.selectedOptions.join(','), this.disabled);
-        return (h(Host, { key: 'e61969b03dc211a0007166d7319285cc50207910', role: "select", class: `${this.modeVariant ? `tds-mode-variant-${this.modeVariant}` : ''}` }, this.label && this.labelPosition === 'outside' && (h("div", { key: 'd97ce5d02635b30698564226be8c55b477f42de5', class: `label-outside ${this.disabled ? 'disabled' : ''}` }, this.label)), h("div", { key: '29099efd6d106a5c6013ac83a545c290bb1d0af7', class: `dropdown-select ${this.size} ${this.disabled ? 'disabled' : ''}` }, this.filter ? (h("div", { class: {
+        var _a, _b, _c;
+        appendHiddenInput(this.host, this.name, this.value ? convertArrayToStrings(this.value).join(',') : null, this.disabled);
+        return (h(Host, { key: '0bb6532a6a87ba128f556022792fe5afb3e3e482', role: "select", class: {
+                [`tds-mode-variant-${this.modeVariant}`]: Boolean(this.modeVariant),
+            } }, this.label && this.labelPosition === 'outside' && (h("div", { key: 'c65377474abaae962436d53b42e19eeda2bcdda6', class: `label-outside ${this.disabled ? 'disabled' : ''}` }, this.label)), h("div", { key: '80d21a17eef6a3d8ff7f73e5a52a744ae4aa08b6', class: {
+                'dropdown-select': true,
+                [this.size]: true,
+                'disabled': this.disabled,
+            } }, this.filter ? (h("div", { class: {
                 filter: true,
                 focus: this.filterFocus,
                 disabled: this.disabled,
@@ -339,16 +401,26 @@ export class TdsDropdown {
             } }, h("div", { class: "value-wrapper" }, this.label && this.labelPosition === 'inside' && this.placeholder && (h("div", { class: `label-inside ${this.size}` }, this.label)), this.label && this.labelPosition === 'inside' && !this.placeholder && (h("div", { class: `
                     label-inside-as-placeholder
                     ${this.size}
-                    ${this.selectedOptions.length ? 'selected' : ''}
+                    ${((_a = this.value) === null || _a === void 0 ? void 0 : _a.length) ? 'selected' : ''}
                     ` }, this.label)), h("input", {
             // eslint-disable-next-line no-return-assign
-            ref: (inputEl) => (this.inputElement = inputEl), class: `${this.labelPosition === 'inside' ? 'placeholder' : ''}`, type: "text", placeholder: this.filterFocus ? '' : this.placeholder, value: this.multiselect && this.filterFocus ? '' : this.getValue(), disabled: this.disabled, onInput: (event) => this.handleFilter(event), onBlur: (event) => {
+            ref: (inputEl) => (this.inputElement = inputEl), class: {
+                placeholder: this.labelPosition === 'inside',
+            }, type: "text", placeholder: this.filterFocus ? '' : this.placeholder, value: this.multiselect && this.filterFocus ? '' : this.getValue(), disabled: this.disabled, onInput: (event) => this.handleFilter(event), onBlur: (event) => {
                 this.filterFocus = false;
                 if (this.multiselect) {
                     this.inputElement.value = this.getValue();
                 }
                 this.handleBlur(event);
-            }, onFocus: (event) => this.handleFocus(event), onKeyDown: (event) => {
+            }, onFocus: (event) => {
+                this.open = true;
+                this.filterFocus = true;
+                if (this.multiselect) {
+                    this.inputElement.value = '';
+                }
+                this.handleFocus(event);
+                this.handleFilter({ target: { value: '' } });
+            }, onKeyDown: (event) => {
                 if (event.key === 'Escape') {
                     this.open = false;
                 }
@@ -357,7 +429,10 @@ export class TdsDropdown {
                 if (event.key === 'Enter') {
                     this.handleFilterReset();
                 }
-            }, class: `clear-icon ${this.open && this.inputElement.value !== '' ? '' : 'hide'}`, name: "cross", size: "16px" }), h("tds-icon", { tabIndex: 0, role: "button", "aria-label": "Open/Close dropdown", svgTitle: "Open/Close dropdown", onClick: this.handleToggleOpen, onKeyDown: (event) => {
+            }, class: {
+                'clear-icon': true,
+                'hide': !(this.open && this.inputElement.value !== ''),
+            }, name: "cross", size: "16px" }), h("tds-icon", { tabIndex: 0, role: "button", "aria-label": "Open/Close dropdown", svgTitle: "Open/Close dropdown", onClick: this.handleToggleOpen, onKeyDown: (event) => {
                 if (event.key === 'Enter') {
                     this.handleToggleOpen();
                 }
@@ -365,15 +440,19 @@ export class TdsDropdown {
                 if (event.key === 'Escape') {
                     this.open = false;
                 }
-            }, class: `
-                ${this.selectedOptions.length ? 'value' : 'placeholder'}
-                ${this.open ? 'open' : 'closed'}
-                ${this.error ? 'error' : ''}
-                `, disabled: this.disabled }, h("div", { class: `value-wrapper ${this.size}` }, this.label && this.labelPosition === 'inside' && this.placeholder && (h("div", { class: `label-inside ${this.size}` }, this.label)), this.label && this.labelPosition === 'inside' && !this.placeholder && (h("div", { class: `
-                    label-inside-as-placeholder
-                    ${this.size}
-                    ${this.selectedOptions.length ? 'selected' : ''}
-                    ` }, this.label)), h("div", { class: `placeholder ${this.size}` }, this.selectedOptions.length ? this.getValue() : this.placeholder), h("tds-icon", { "aria-label": "Open/Close dropdown", svgTitle: "Open/Close dropdown", class: `menu-icon ${this.open ? 'open' : 'closed'}`, name: "chevron_down", size: "16px" }))))), h("div", { key: '04cf1b3b829f482b189a59fb5fd8f9c3932b4982', ref: (element) => (this.dropdownList = element), class: {
+            }, class: {
+                value: Boolean(this.value),
+                placeholder: Boolean(!this.value),
+                open: this.open,
+                closed: !this.open,
+                error: this.error,
+            }, disabled: this.disabled }, h("div", { class: `value-wrapper ${this.size}` }, this.label && this.labelPosition === 'inside' && this.placeholder && (h("div", { class: `label-inside ${this.size}` }, this.label)), this.label && this.labelPosition === 'inside' && !this.placeholder && (h("div", { class: {
+                'label-inside-as-placeholder': true,
+                [this.size]: true,
+                'selected': Boolean((_b = this.value) === null || _b === void 0 ? void 0 : _b.length),
+            } }, this.label)), h("div", { class: `placeholder ${this.size}` }, ((_c = this.value) === null || _c === void 0 ? void 0 : _c.length) ? this.getValue() : this.placeholder), h("tds-icon", { "aria-label": "Open/Close dropdown", svgTitle: "Open/Close dropdown", class: `menu-icon ${this.open ? 'open' : 'closed'}`, name: "chevron_down", size: "16px" }))))), h("div", { key: '1f1c87b17a78c2a65add834208f487c6e9a4f77e', ref: (element) => {
+                this.dropdownList = element;
+            }, class: {
                 'dropdown-list': true,
                 [this.size]: true,
                 [this.getOpenDirection()]: true,
@@ -382,7 +461,11 @@ export class TdsDropdown {
                 'closed': !this.open,
                 [`animation-enter-${this.animation}`]: this.animation !== 'none' && this.open,
                 [`animation-exit-${this.animation}`]: this.animation !== 'none' && !this.open,
-            } }, h("slot", { key: '3dce31c592336d9b5c2e8e5fa25a0a8ff23694d3', onSlotchange: () => this.handleSlotChange() }), this.filterResult === 0 && this.noResultText !== '' && (h("div", { key: '7f1e8b0d7fff2f09412f389507ff7c2f2430a70b', class: `no-result ${this.size}` }, this.noResultText))), this.helper && (h("div", { key: '0c728acc0d233f674ad7bc394176aa89b01ee66d', class: `helper ${this.error ? 'error' : ''} ${this.disabled ? 'disabled' : ''}` }, this.error && h("tds-icon", { key: '65691c3c11f4b6c908028475c03d1f4b6f35ce74', name: "error", size: "16px" }), this.helper))));
+            } }, h("slot", { key: '6eb6b21f865702aa56af12b9e54bdb2c6c7c8cc2', onSlotchange: () => this.handleSlotChange() }), this.filterResult === 0 && this.noResultText !== '' && (h("div", { key: '58c15bd69f38c001e0d6c74466ddfe97d6d77a79', class: `no-result ${this.size}` }, this.noResultText))), this.helper && (h("div", { key: 'cc7e1a7f988e6bc61f3bacb7dd9a564b6c1f738d', class: {
+                helper: true,
+                error: this.error,
+                disabled: this.disabled,
+            } }, this.error && h("tds-icon", { key: 'ffd574d493f3bbaa37ddc7b14a8372ba4b23bd70', name: "error", size: "16px" }), this.helper))));
     }
     static get is() { return "tds-dropdown"; }
     static get encapsulation() { return "shadow"; }
@@ -664,11 +747,11 @@ export class TdsDropdown {
                 "defaultValue": "'No result'"
             },
             "defaultValue": {
-                "type": "string",
+                "type": "any",
                 "mutable": false,
                 "complexType": {
-                    "original": "string",
-                    "resolved": "string",
+                    "original": "string | number",
+                    "resolved": "number | string",
                     "references": {}
                 },
                 "required": false,
@@ -679,34 +762,16 @@ export class TdsDropdown {
                 },
                 "attribute": "default-value",
                 "reflect": false
-            },
-            "value": {
-                "type": "string",
-                "mutable": true,
-                "complexType": {
-                    "original": "string | string[]",
-                    "resolved": "string | string[]",
-                    "references": {}
-                },
-                "required": false,
-                "optional": false,
-                "docs": {
-                    "tags": [],
-                    "text": "Value of the dropdown. For multiselect, provide array of strings. For single select, provide a string."
-                },
-                "attribute": "value",
-                "reflect": false,
-                "defaultValue": "null"
             }
         };
     }
     static get states() {
         return {
             "open": {},
-            "internalValue": {},
+            "value": {},
             "filterResult": {},
             "filterFocus": {},
-            "selectedOptions": {}
+            "internalDefaultValue": {}
         };
     }
     static get events() {
@@ -785,51 +850,28 @@ export class TdsDropdown {
                         }
                     }
                 }
-            }, {
-                "method": "tdsValueChange",
-                "name": "tdsValueChange",
-                "bubbles": true,
-                "cancelable": false,
-                "composed": true,
-                "docs": {
-                    "tags": [],
-                    "text": "Value change event for the Dropdown."
-                },
-                "complexType": {
-                    "original": "{\n    name: string;\n    value: string;\n  }",
-                    "resolved": "{ name: string; value: string; }",
-                    "references": {}
-                }
             }];
     }
     static get methods() {
         return {
-            "setValue": {
+            "reset": {
                 "complexType": {
-                    "signature": "(value: string | string[]) => Promise<{ value: string; label: string; }[]>",
-                    "parameters": [{
-                            "name": "value",
-                            "type": "string | string[]",
-                            "docs": ""
-                        }],
+                    "signature": "() => Promise<void>",
+                    "parameters": [],
                     "references": {
                         "Promise": {
                             "location": "global",
                             "id": "global::Promise"
-                        },
-                        "HTMLTdsDropdownOptionElement": {
-                            "location": "global",
-                            "id": "global::HTMLTdsDropdownOptionElement"
                         }
                     },
-                    "return": "Promise<{ value: string; label: string; }[]>"
+                    "return": "Promise<void>"
                 },
                 "docs": {
-                    "text": "",
+                    "text": "Method that resets the Dropdown, marks all children as non-selected and resets the value to null.",
                     "tags": []
                 }
             },
-            "reset": {
+            "focusElement": {
                 "complexType": {
                     "signature": "() => Promise<void>",
                     "parameters": [],
@@ -842,35 +884,43 @@ export class TdsDropdown {
                     "return": "Promise<void>"
                 },
                 "docs": {
-                    "text": "",
+                    "text": "Method that forces focus on the input element.",
                     "tags": []
                 }
             },
-            "removeValue": {
+            "setValue": {
                 "complexType": {
-                    "signature": "(oldValue: string) => Promise<void>",
+                    "signature": "(value: string | string[] | number | number[]) => Promise<{ value: string | number; label: string; }[]>",
                     "parameters": [{
-                            "name": "oldValue",
-                            "type": "string",
+                            "name": "value",
+                            "type": "string | number | string[] | number[]",
                             "docs": ""
                         }],
                     "references": {
                         "Promise": {
                             "location": "global",
                             "id": "global::Promise"
+                        },
+                        "HTMLTdsDropdownOptionElement": {
+                            "location": "global",
+                            "id": "global::HTMLTdsDropdownOptionElement"
                         }
                     },
-                    "return": "Promise<void>"
+                    "return": "Promise<{ value: string | number; label: string; }[]>"
                 },
                 "docs": {
-                    "text": "",
+                    "text": "Method for setting the value of the Dropdown.\n\nSingle selection example:\n\n<code>\ndropdown.setValue('option-1', 'Option 1');\n</code>\n\nMultiselect example:\n\n<code>\ndropdown.setValue(['option-1', 'option-2']);\n</code>",
                     "tags": []
                 }
             },
-            "focusElement": {
+            "appendValue": {
                 "complexType": {
-                    "signature": "() => Promise<void>",
-                    "parameters": [],
+                    "signature": "(value: string) => Promise<void>",
+                    "parameters": [{
+                            "name": "value",
+                            "type": "string",
+                            "docs": ""
+                        }],
                     "references": {
                         "Promise": {
                             "location": "global",
@@ -880,35 +930,42 @@ export class TdsDropdown {
                     "return": "Promise<void>"
                 },
                 "docs": {
-                    "text": "Method that forces focus on the input element.",
-                    "tags": []
+                    "text": "",
+                    "tags": [{
+                            "name": "internal",
+                            "text": undefined
+                        }]
                 }
             },
-            "close": {
+            "removeValue": {
                 "complexType": {
-                    "signature": "() => Promise<void>",
-                    "parameters": [],
+                    "signature": "(oldValue: string) => Promise<{ value: string; label: string; }[]>",
+                    "parameters": [{
+                            "name": "oldValue",
+                            "type": "string",
+                            "docs": ""
+                        }],
                     "references": {
                         "Promise": {
                             "location": "global",
                             "id": "global::Promise"
+                        },
+                        "HTMLTdsDropdownOptionElement": {
+                            "location": "global",
+                            "id": "global::HTMLTdsDropdownOptionElement"
                         }
                     },
-                    "return": "Promise<void>"
+                    "return": "Promise<{ value: string; label: string; }[]>"
                 },
                 "docs": {
-                    "text": "Method for closing the Dropdown.",
+                    "text": "Method for removing a selected value in the Dropdown.",
                     "tags": []
                 }
             },
-            "appendValue": {
+            "close": {
                 "complexType": {
-                    "signature": "(value: string) => Promise<void>",
-                    "parameters": [{
-                            "name": "value",
-                            "type": "string",
-                            "docs": ""
-                        }],
+                    "signature": "() => Promise<void>",
+                    "parameters": [],
                     "references": {
                         "Promise": {
                             "location": "global",
@@ -918,7 +975,7 @@ export class TdsDropdown {
                     "return": "Promise<void>"
                 },
                 "docs": {
-                    "text": "",
+                    "text": "Method for closing the Dropdown.",
                     "tags": []
                 }
             }
@@ -927,11 +984,11 @@ export class TdsDropdown {
     static get elementRef() { return "host"; }
     static get watchers() {
         return [{
-                "propName": "value",
-                "methodName": "handleValueChange"
-            }, {
                 "propName": "open",
                 "methodName": "handleOpenState"
+            }, {
+                "propName": "defaultValue",
+                "methodName": "handleDefaultValueChange"
             }];
     }
     static get listeners() {