@scania/tegel 1.25.0-fix-a11y-checkbox-testing-previous-version-beta.0 → 1.25.0-fix-a11y-chip-more-improvements-beta.0

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

@@ -10,33 +10,13 @@ export class TdsDropdown {
     constructor() {
         this.setDefaultOption = () => {
             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;
-                }
+                // Convert the internal default value to an array if it's not already
                 const defaultValues = this.multiselect
-                    ? new Set(this.internalDefaultValue.split(','))
+                    ? 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}"`);
-                }
+                this.updateDropdownState(defaultValues);
             }
         };
-        /* 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) {
@@ -45,6 +25,36 @@ 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) {
@@ -58,7 +68,6 @@ 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;
@@ -67,38 +76,10 @@ 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();
@@ -129,8 +110,10 @@ export class TdsDropdown {
         this.handleFilterReset = () => {
             this.reset();
             this.inputElement.value = '';
-            this.handleFilter({ target: { value: this.inputElement.value } });
+            this.handleFilter({ target: { value: '' } });
             this.inputElement.focus();
+            // Add this line to ensure internal value is cleared
+            this.internalValue = '';
         };
         this.handleFocus = (event) => {
             this.open = true;
@@ -144,12 +127,6 @@ 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) {
@@ -172,17 +149,111 @@ export class TdsDropdown {
         this.normalizeText = true;
         this.noResultText = 'No result';
         this.defaultValue = undefined;
+        this.value = null;
         this.open = false;
-        this.value = undefined;
+        this.internalValue = undefined;
         this.filterResult = undefined;
         this.filterFocus = undefined;
         this.internalDefaultValue = 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) {
+            if (Array.isArray(value)) {
+                return convertArrayToStrings(value);
+            }
+            return value
+                .toString()
+                .split(',')
+                .filter((v) => v !== '');
+        }
+        // Single select - convert to string array
+        return Array.isArray(value) ? convertArrayToStrings(value) : [convertToString(value)];
+    }
+    hasValueChanged(newValue, currentValue) {
+        if (newValue.length !== currentValue.length)
+            return true;
+        return newValue.some((val) => !currentValue.includes(val));
+    }
+    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();
+    }
+    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`);
+            }
+            return isValid;
+        });
+    }
+    updateOptionElements() {
+        var _a;
+        (_a = this.getChildren()) === null || _a === void 0 ? void 0 : _a.forEach((element) => {
+            // Convert element.value to string for comparison
+            element.setSelected(this.selectedOptions.includes(convertToString(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) {
+        let normalizedValue;
+        if (Array.isArray(value)) {
+            normalizedValue = convertArrayToStrings(value);
+        }
+        else {
+            normalizedValue = [convertToString(value)];
+        }
+        this.updateDropdownState(normalizedValue);
+        return this.getSelectedChildren().map((element) => ({
+            value: element.value,
+            label: element.textContent.trim(),
+        }));
     }
-    /** 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();
+        this.updateDropdownState([]);
+    }
+    async removeValue(oldValue) {
+        const newValues = this.selectedOptions.filter((v) => v !== oldValue);
+        this.updateDropdownState(newValues);
     }
     /** Method that forces focus on the input element. */
     async focusElement() {
@@ -203,81 +274,6 @@ export class TdsDropdown {
      *  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);
-            }
-        }
-        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;
-    }
-    /**
-     * @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) {
-        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() {
         this.open = false;
     }
@@ -324,7 +320,7 @@ export class TdsDropdown {
     handleOpenState() {
         if (this.filter && this.multiselect) {
             if (!this.open) {
-                this.inputElement.value = this.getValue();
+                this.inputElement.value = this.selectedOptions.length ? this.getValue() : '';
             }
         }
     }
@@ -335,10 +331,14 @@ export class TdsDropdown {
         }
     }
     componentWillLoad() {
-        if (this.defaultValue !== undefined && this.defaultValue !== null) {
-            this.internalDefaultValue = convertToString(this.defaultValue);
+        if (this.defaultValue && !this.value) {
+            // Convert defaultValue to string before splitting
+            const defaultValueStr = convertToString(this.defaultValue);
+            const initialValue = this.multiselect
+                ? defaultValueStr.split(',').map(convertToString)
+                : [convertToString(this.defaultValue)];
+            this.updateDropdownState(initialValue);
         }
-        this.setDefaultOption();
     }
     /** Method to handle slot changes */
     handleSlotChange() {
@@ -348,29 +348,16 @@ export class TdsDropdown {
     normalizeString(text) {
         return this.normalizeText ? text.normalize('NFD').replace(/\p{Diacritic}/gu, '') : text;
     }
-    /** 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);
-                }
-            });
-        });
+    /**
+     * @internal
+     */
+    async appendValue(value) {
+        if (this.multiselect) {
+            this.updateDropdownState([...this.selectedOptions, value]);
+        }
+        else {
+            this.updateDropdownState([value]);
+        }
     }
     componentDidRender() {
         const form = this.host.closest('form');
@@ -385,11 +372,10 @@ export class TdsDropdown {
         }
     }
     render() {
-        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: {
+        appendHiddenInput(this.host, this.name, this.selectedOptions.join(','), this.disabled);
+        return (h(Host, { key: '490d34545b3a09c3b4342fa09d38f6bf9c782498', 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: {
+            } }, this.label && this.labelPosition === 'outside' && (h("div", { key: '7eb96c0134032654df98a3b68ffb692a2cd91d2b', class: `label-outside ${this.disabled ? 'disabled' : ''}` }, this.label)), h("div", { key: '439fddb188ad65239e9d5451a82ab3bbe8f47fb7', class: {
                 'dropdown-select': true,
                 [this.size]: true,
                 'disabled': this.disabled,
@@ -401,7 +387,7 @@ 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}
-                    ${((_a = this.value) === null || _a === void 0 ? void 0 : _a.length) ? 'selected' : ''}
+                    ${this.selectedOptions.length ? 'selected' : ''}
                     ` }, this.label)), h("input", {
             // eslint-disable-next-line no-return-assign
             ref: (inputEl) => (this.inputElement = inputEl), class: {
@@ -412,15 +398,7 @@ export class TdsDropdown {
                     this.inputElement.value = this.getValue();
                 }
                 this.handleBlur(event);
-            }, onFocus: (event) => {
-                this.open = true;
-                this.filterFocus = true;
-                if (this.multiselect) {
-                    this.inputElement.value = '';
-                }
-                this.handleFocus(event);
-                this.handleFilter({ target: { value: '' } });
-            }, onKeyDown: (event) => {
+            }, onFocus: (event) => this.handleFocus(event), onKeyDown: (event) => {
                 if (event.key === 'Escape') {
                     this.open = false;
                 }
@@ -440,17 +418,15 @@ export class TdsDropdown {
                 if (event.key === 'Escape') {
                     this.open = false;
                 }
-            }, 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) => {
+            }, 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: 'd6381f78466994f05415cf8981b3cedaaf4df6a9', ref: (element) => {
                 this.dropdownList = element;
             }, class: {
                 'dropdown-list': true,
@@ -461,11 +437,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: '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: {
+            } }, h("slot", { key: 'c36a9cb5398a7d290f11576431982e869986e4a0', onSlotchange: () => this.handleSlotChange() }), this.filterResult === 0 && this.noResultText !== '' && (h("div", { key: '5ec07552d105f8a4addc46da0172f67cf9233817', class: `no-result ${this.size}` }, this.noResultText))), this.helper && (h("div", { key: 'b3e240c31060f2d2bce6e3647f903f9ff1250ed5', class: {
                 helper: true,
                 error: this.error,
                 disabled: this.disabled,
-            } }, this.error && h("tds-icon", { key: 'ffd574d493f3bbaa37ddc7b14a8372ba4b23bd70', name: "error", size: "16px" }), this.helper))));
+            } }, this.error && h("tds-icon", { key: 'c0eb10dfeaa5236f5ac02dabf44329e85d52dcda', name: "error", size: "16px" }), this.helper))));
     }
     static get is() { return "tds-dropdown"; }
     static get encapsulation() { return "shadow"; }
@@ -762,16 +738,35 @@ export class TdsDropdown {
                 },
                 "attribute": "default-value",
                 "reflect": false
+            },
+            "value": {
+                "type": "any",
+                "mutable": true,
+                "complexType": {
+                    "original": "string | number | (string | number)[]",
+                    "resolved": "(string | number)[] | number | string",
+                    "references": {}
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [],
+                    "text": "Value of the dropdown. For multiselect, provide array of strings/numbers. For single select, provide a string/number."
+                },
+                "attribute": "value",
+                "reflect": false,
+                "defaultValue": "null"
             }
         };
     }
     static get states() {
         return {
             "open": {},
-            "value": {},
+            "internalValue": {},
             "filterResult": {},
             "filterFocus": {},
-            "internalDefaultValue": {}
+            "internalDefaultValue": {},
+            "selectedOptions": {}
         };
     }
     static get events() {
@@ -854,24 +849,32 @@ export class TdsDropdown {
     }
     static get methods() {
         return {
-            "reset": {
+            "setValue": {
                 "complexType": {
-                    "signature": "() => Promise<void>",
-                    "parameters": [],
+                    "signature": "(value: string | number | string[] | number[]) => Promise<{ value: string | number; label: string; }[]>",
+                    "parameters": [{
+                            "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": "Method that resets the Dropdown, marks all children as non-selected and resets the value to null.",
+                    "text": "",
                     "tags": []
                 }
             },
-            "focusElement": {
+            "reset": {
                 "complexType": {
                     "signature": "() => Promise<void>",
                     "parameters": [],
@@ -884,43 +887,35 @@ export class TdsDropdown {
                     "return": "Promise<void>"
                 },
                 "docs": {
-                    "text": "Method that forces focus on the input element.",
+                    "text": "",
                     "tags": []
                 }
             },
-            "setValue": {
+            "removeValue": {
                 "complexType": {
-                    "signature": "(value: string | string[] | number | number[]) => Promise<{ value: string | number; label: string; }[]>",
+                    "signature": "(oldValue: string) => Promise<void>",
                     "parameters": [{
-                            "name": "value",
-                            "type": "string | number | string[] | number[]",
+                            "name": "oldValue",
+                            "type": "string",
                             "docs": ""
                         }],
                     "references": {
                         "Promise": {
                             "location": "global",
                             "id": "global::Promise"
-                        },
-                        "HTMLTdsDropdownOptionElement": {
-                            "location": "global",
-                            "id": "global::HTMLTdsDropdownOptionElement"
                         }
                     },
-                    "return": "Promise<{ value: string | number; label: string; }[]>"
+                    "return": "Promise<void>"
                 },
                 "docs": {
-                    "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>",
+                    "text": "",
                     "tags": []
                 }
             },
-            "appendValue": {
+            "focusElement": {
                 "complexType": {
-                    "signature": "(value: string) => Promise<void>",
-                    "parameters": [{
-                            "name": "value",
-                            "type": "string",
-                            "docs": ""
-                        }],
+                    "signature": "() => Promise<void>",
+                    "parameters": [],
                     "references": {
                         "Promise": {
                             "location": "global",
@@ -930,42 +925,35 @@ export class TdsDropdown {
                     "return": "Promise<void>"
                 },
                 "docs": {
-                    "text": "",
-                    "tags": [{
-                            "name": "internal",
-                            "text": undefined
-                        }]
+                    "text": "Method that forces focus on the input element.",
+                    "tags": []
                 }
             },
-            "removeValue": {
+            "close": {
                 "complexType": {
-                    "signature": "(oldValue: string) => Promise<{ value: string; label: string; }[]>",
-                    "parameters": [{
-                            "name": "oldValue",
-                            "type": "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": "Method for removing a selected value in the Dropdown.",
+                    "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": []
                 }
             },
-            "close": {
+            "appendValue": {
                 "complexType": {
-                    "signature": "() => Promise<void>",
-                    "parameters": [],
+                    "signature": "(value: string) => Promise<void>",
+                    "parameters": [{
+                            "name": "value",
+                            "type": "string",
+                            "docs": ""
+                        }],
                     "references": {
                         "Promise": {
                             "location": "global",
@@ -975,8 +963,11 @@ export class TdsDropdown {
                     "return": "Promise<void>"
                 },
                 "docs": {
-                    "text": "Method for closing the Dropdown.",
-                    "tags": []
+                    "text": "",
+                    "tags": [{
+                            "name": "internal",
+                            "text": undefined
+                        }]
                 }
             }
         };
@@ -984,6 +975,9 @@ export class TdsDropdown {
     static get elementRef() { return "host"; }
     static get watchers() {
         return [{
+                "propName": "value",
+                "methodName": "handleValueChange"
+            }, {
                 "propName": "open",
                 "methodName": "handleOpenState"
             }, {