@scania/tegel 1.24.0-fix-CDEP-264-button-allow-boolean-props-beta.0 → 1.24.0-value-prop.beta.6

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

@@ -9,33 +9,13 @@ export class TdsDropdown {
     constructor() {
         this.setDefaultOption = () => {
             if (this.defaultValue) {
-                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 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.defaultValue}"`);
-                }
+                const normalizedValues = Array.from(defaultValues);
+                this.updateDropdownState(normalizedValues);
             }
         };
-        /* 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) {
@@ -44,6 +24,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) {
@@ -57,7 +67,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;
@@ -66,38 +75,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', this.value.map((val) => val).toString());
-            }
-        };
         this.handleFilter = (event) => {
             this.tdsInput.emit(event);
             const query = event.target.value.toLowerCase();
@@ -128,8 +109,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;
@@ -143,13 +126,6 @@ export class TdsDropdown {
         this.handleBlur = (event) => {
             this.tdsBlur.emit(event);
         };
-        this.handleChange = () => {
-            var _a, _b;
-            this.tdsChange.emit({
-                name: this.name,
-                value: (_b = (_a = this.value) === null || _a === void 0 ? void 0 : _a.map((value) => value).toString()) !== null && _b !== void 0 ? _b : null,
-            });
-        };
         this.resetInput = () => {
             const inputEl = this.host.querySelector('input');
             if (inputEl) {
@@ -172,107 +148,101 @@ 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.selectedOptions = [];
     }
-    /** 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();
-    }
-    /** Method that forces focus on the input element. */
-    async focusElement() {
-        this.focusInputElement();
-        this.handleFocus({});
+    handleValueChange(newValue) {
+        // Normalize to array
+        const normalizedValue = this.normalizeValue(newValue);
+        // Only update if actually changed
+        if (this.hasValueChanged(normalizedValue, this.selectedOptions)) {
+            this.updateDropdownState(normalizedValue);
+        }
     }
-    /** 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, label) {
-        let nextValue;
-        if (typeof value === 'string')
-            nextValue = [value];
-        else
-            nextValue = value;
-        if (!this.multiselect && nextValue.length > 1) {
-            console.warn('Tried to select multiple items, but multiselect is not enabled.');
-            nextValue = [nextValue[0]];
+    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 !== '');
         }
-        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 Array.isArray(value) ? value : [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) => {
+            element.setSelected(this.selectedOptions.includes(element.value));
+        });
+    }
+    updateDisplayValue() {
+        this.internalValue = this.getSelectedChildrenLabels().join(', ');
+        if (this.filter && this.inputElement) {
+            this.inputElement.value = this.internalValue;
         }
-        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) => ({
+    }
+    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) => ({
             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);
-        }
+    async reset() {
+        this.updateDropdownState([]);
     }
-    /** 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 }));
+        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({});
     }
     /** Method for closing the Dropdown. */
     async close() {
@@ -321,12 +291,15 @@ 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() : '';
             }
         }
     }
     componentWillLoad() {
-        this.setDefaultOption();
+        if (this.defaultValue && !this.value) {
+            const initialValue = this.multiselect ? this.defaultValue.split(',') : [this.defaultValue];
+            this.updateDropdownState(initialValue);
+        }
     }
     /** Method to handle slot changes */
     handleSlotChange() {
@@ -336,29 +309,13 @@ 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);
-                }
-            });
-        });
+    async appendValue(value) {
+        if (this.multiselect) {
+            this.updateDropdownState([...this.selectedOptions, value]);
+        }
+        else {
+            this.updateDropdownState([value]);
+        }
     }
     componentDidRender() {
         const form = this.host.closest('form');
@@ -373,9 +330,8 @@ export class TdsDropdown {
         }
     }
     render() {
-        var _a, _b, _c, _d;
-        appendHiddenInput(this.host, this.name, (_a = this.value) === null || _a === void 0 ? void 0 : _a.map((value) => value).toString(), this.disabled);
-        return (h(Host, { key: 'b452aebe0997ce114fff5c7527d7305e97bf6462', role: "select", class: `${this.modeVariant ? `tds-mode-variant-${this.modeVariant}` : ''}` }, this.label && this.labelPosition === 'outside' && (h("div", { key: '356273d3065daebba4d72a7f30f745dab1eb803e', class: `label-outside ${this.disabled ? 'disabled' : ''}` }, this.label)), h("div", { key: 'c8b617da62a01e0432fee90c243723edde5fecca', class: `dropdown-select ${this.size} ${this.disabled ? 'disabled' : ''}` }, this.filter ? (h("div", { class: {
+        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: {
                 filter: true,
                 focus: this.filterFocus,
                 disabled: this.disabled,
@@ -383,7 +339,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}
-                    ${((_b = this.value) === null || _b === void 0 ? void 0 : _b.length) ? 'selected' : ''}
+                    ${this.selectedOptions.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) => {
@@ -392,15 +348,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;
                 }
@@ -418,14 +366,14 @@ export class TdsDropdown {
                     this.open = false;
                 }
             }, class: `
-                ${this.value ? 'value' : 'placeholder'}
+                ${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}
-                    ${((_c = this.value) === null || _c === void 0 ? void 0 : _c.length) ? 'selected' : ''}
-                    ` }, this.label)), h("div", { class: `placeholder ${this.size}` }, ((_d = this.value) === null || _d === void 0 ? void 0 : _d.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: 'bd702f67929bfd42350b11a9680e007dd74e4bad', ref: (element) => (this.dropdownList = element), class: {
+                    ${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: {
                 'dropdown-list': true,
                 [this.size]: true,
                 [this.getOpenDirection()]: true,
@@ -434,7 +382,7 @@ 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: '64c67c8aa6aa68089c59de1fdedb915ea4beb3af', onSlotchange: () => this.handleSlotChange() }), this.filterResult === 0 && this.noResultText !== '' && (h("div", { key: '2152a99732579e2c2f7e82d450743e67d8b9f263', class: `no-result ${this.size}` }, this.noResultText))), this.helper && (h("div", { key: 'fbc4ebc39a4ca4fc49a77ea1160042ad1de005ec', class: `helper ${this.error ? 'error' : ''} ${this.disabled ? 'disabled' : ''}` }, this.error && h("tds-icon", { key: '318107cbe939b82250bb97bfbceae4017e438ba1', name: "error", size: "16px" }), this.helper))));
+            } }, 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))));
     }
     static get is() { return "tds-dropdown"; }
     static get encapsulation() { return "shadow"; }
@@ -731,15 +679,34 @@ 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": {},
-            "value": {},
+            "internalValue": {},
             "filterResult": {},
-            "filterFocus": {}
+            "filterFocus": {},
+            "selectedOptions": {}
         };
     }
     static get events() {
@@ -818,28 +785,51 @@ 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 {
-            "reset": {
+            "setValue": {
                 "complexType": {
-                    "signature": "() => Promise<void>",
-                    "parameters": [],
+                    "signature": "(value: string | string[]) => Promise<{ value: string; label: string; }[]>",
+                    "parameters": [{
+                            "name": "value",
+                            "type": "string | 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 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": [],
@@ -852,19 +842,15 @@ 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[], label?: string) => Promise<{ value: string; label: string; }[]>",
+                    "signature": "(oldValue: string) => Promise<void>",
                     "parameters": [{
-                            "name": "value",
-                            "type": "string | string[]",
-                            "docs": ""
-                        }, {
-                            "name": "label",
+                            "name": "oldValue",
                             "type": "string",
                             "docs": ""
                         }],
@@ -872,27 +858,19 @@ export class TdsDropdown {
                         "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 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",
@@ -902,42 +880,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 closing the Dropdown.",
                     "tags": []
                 }
             },
-            "close": {
+            "appendValue": {
                 "complexType": {
-                    "signature": "() => Promise<void>",
-                    "parameters": [],
+                    "signature": "(value: string) => Promise<void>",
+                    "parameters": [{
+                            "name": "value",
+                            "type": "string",
+                            "docs": ""
+                        }],
                     "references": {
                         "Promise": {
                             "location": "global",
@@ -947,7 +918,7 @@ export class TdsDropdown {
                     "return": "Promise<void>"
                 },
                 "docs": {
-                    "text": "Method for closing the Dropdown.",
+                    "text": "",
                     "tags": []
                 }
             }
@@ -956,6 +927,9 @@ export class TdsDropdown {
     static get elementRef() { return "host"; }
     static get watchers() {
         return [{
+                "propName": "value",
+                "methodName": "handleValueChange"
+            }, {
                 "propName": "open",
                 "methodName": "handleOpenState"
             }];