@scania/tegel 1.25.0-fix-a11y-chip-more-improvements-beta.0 → 1.25.0-fix-a11y-text-field-beta.0

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

@@ -10,13 +10,33 @@ export class TdsDropdown {
     constructor() {
         this.setDefaultOption = () => {
             if (this.internalDefaultValue) {
-                // Convert the internal default value to an array if it's not already
+                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
-                    ? this.internalDefaultValue.split(',')
+                    ? new Set(this.internalDefaultValue.split(','))
                     : [this.internalDefaultValue];
-                this.updateDropdownState(defaultValues);
+                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) {
@@ -25,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) {
@@ -68,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;
@@ -76,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();
@@ -110,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;
@@ -127,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) {
@@ -149,111 +172,17 @@ 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.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.updateDropdownState([]);
-    }
-    async removeValue(oldValue) {
-        const newValues = this.selectedOptions.filter((v) => v !== oldValue);
-        this.updateDropdownState(newValues);
+        this.dropdownList.scrollTop = 0;
+        this.internalReset();
+        this.handleChange();
     }
     /** Method that forces focus on the input element. */
     async focusElement() {
@@ -274,6 +203,81 @@ 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;
     }
@@ -320,7 +324,7 @@ 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();
             }
         }
     }
@@ -331,14 +335,10 @@ export class TdsDropdown {
         }
     }
     componentWillLoad() {
-        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);
+        if (this.defaultValue !== undefined && this.defaultValue !== null) {
+            this.internalDefaultValue = convertToString(this.defaultValue);
         }
+        this.setDefaultOption();
     }
     /** Method to handle slot changes */
     handleSlotChange() {
@@ -348,16 +348,29 @@ export class TdsDropdown {
     normalizeString(text) {
         return this.normalizeText ? text.normalize('NFD').replace(/\p{Diacritic}/gu, '') : text;
     }
-    /**
-     * @internal
-     */
-    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');
@@ -372,10 +385,11 @@ export class TdsDropdown {
         }
     }
     render() {
-        appendHiddenInput(this.host, this.name, this.selectedOptions.join(','), this.disabled);
-        return (h(Host, { key: '490d34545b3a09c3b4342fa09d38f6bf9c782498', role: "select", 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: '7eb96c0134032654df98a3b68ffb692a2cd91d2b', class: `label-outside ${this.disabled ? 'disabled' : ''}` }, this.label)), h("div", { key: '439fddb188ad65239e9d5451a82ab3bbe8f47fb7', class: {
+            } }, 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,
@@ -387,7 +401,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}
-                    ${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: {
@@ -398,7 +412,15 @@ export class TdsDropdown {
                     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;
                 }
@@ -418,15 +440,17 @@ 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: 'd6381f78466994f05415cf8981b3cedaaf4df6a9', ref: (element) => {
+            }, 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,
@@ -437,11 +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: '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: {
+            } }, 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: 'c0eb10dfeaa5236f5ac02dabf44329e85d52dcda', name: "error", size: "16px" }), this.helper))));
+            } }, this.error && h("tds-icon", { key: 'ffd574d493f3bbaa37ddc7b14a8372ba4b23bd70', name: "error", size: "16px" }), this.helper))));
     }
     static get is() { return "tds-dropdown"; }
     static get encapsulation() { return "shadow"; }
@@ -738,35 +762,16 @@ 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": {},
-            "internalValue": {},
+            "value": {},
             "filterResult": {},
             "filterFocus": {},
-            "internalDefaultValue": {},
-            "selectedOptions": {}
+            "internalDefaultValue": {}
         };
     }
     static get events() {
@@ -849,32 +854,24 @@ export class TdsDropdown {
     }
     static get methods() {
         return {
-            "setValue": {
+            "reset": {
                 "complexType": {
-                    "signature": "(value: string | number | string[] | number[]) => Promise<{ value: string | number; label: string; }[]>",
-                    "parameters": [{
-                            "name": "value",
-                            "type": "string | number | string[] | number[]",
-                            "docs": ""
-                        }],
+                    "signature": "() => Promise<void>",
+                    "parameters": [],
                     "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": "",
+                    "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": [],
@@ -887,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",
@@ -925,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 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": "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",
@@ -963,11 +975,8 @@ export class TdsDropdown {
                     "return": "Promise<void>"
                 },
                 "docs": {
-                    "text": "",
-                    "tags": [{
-                            "name": "internal",
-                            "text": undefined
-                        }]
+                    "text": "Method for closing the Dropdown.",
+                    "tags": []
                 }
             }
         };
@@ -975,9 +984,6 @@ export class TdsDropdown {
     static get elementRef() { return "host"; }
     static get watchers() {
         return [{
-                "propName": "value",
-                "methodName": "handleValueChange"
-            }, {
                 "propName": "open",
                 "methodName": "handleOpenState"
             }, {