@scania/tegel 1.23.0-value-prop.beta.5 → 1.24.0-a11y-block-beta.1

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

@@ -9,13 +9,33 @@ 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 normalizedValues = Array.from(defaultValues);
-                this.updateDropdownState(normalizedValues);
+                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}"`);
+                }
             }
         };
+        /* Returns a list of all children that are tds-dropdown-option elements */
         this.getChildren = () => {
             const tdsDropdownOptions = Array.from(this.host.children).filter((element) => element.tagName === 'TDS-DROPDOWN-OPTION');
             if (tdsDropdownOptions.length === 0) {
@@ -24,36 +44,6 @@ export class TdsDropdown {
             else
                 return tdsDropdownOptions;
         };
-        this.getSelectedChildren = () => {
-            if (this.selectedOptions.length === 0)
-                return [];
-            return this.selectedOptions
-                .map((stringValue) => {
-                var _a;
-                const matchingElement = (_a = this.getChildren()) === null || _a === void 0 ? void 0 : _a.find((element) => element.value === stringValue);
-                return matchingElement;
-            })
-                .filter(Boolean);
-        };
-        this.getSelectedChildrenLabels = () => {
-            var _a;
-            return (_a = this.getSelectedChildren()) === null || _a === void 0 ? void 0 : _a.map((element) => element.textContent.trim());
-        };
-        this.getValue = () => {
-            const labels = this.getSelectedChildrenLabels();
-            if (!labels) {
-                return '';
-            }
-            return labels === null || labels === void 0 ? void 0 : labels.join(', ');
-        };
-        this.setValueAttribute = () => {
-            if (this.selectedOptions.length === 0) {
-                this.host.removeAttribute('value');
-            }
-            else {
-                this.host.setAttribute('value', this.selectedOptions.join(','));
-            }
-        };
         this.getOpenDirection = () => {
             var _a, _b, _c, _d, _e;
             if (this.openDirection === 'auto' || !this.openDirection) {
@@ -67,6 +57,7 @@ export class TdsDropdown {
             }
             return this.openDirection;
         };
+        /* Toggles the open state of the Dropdown and sets focus to the input element */
         this.handleToggleOpen = () => {
             if (!this.disabled) {
                 this.open = !this.open;
@@ -75,10 +66,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', this.value.map((val) => val).toString());
+            }
+        };
         this.handleFilter = (event) => {
             this.tdsInput.emit(event);
             const query = event.target.value.toLowerCase();
@@ -109,10 +128,8 @@ export class TdsDropdown {
         this.handleFilterReset = () => {
             this.reset();
             this.inputElement.value = '';
-            this.handleFilter({ target: { value: '' } });
+            this.handleFilter({ target: { value: this.inputElement.value } });
             this.inputElement.focus();
-            // Add this line to ensure internal value is cleared
-            this.internalValue = '';
         };
         this.handleFocus = (event) => {
             this.open = true;
@@ -126,6 +143,13 @@ 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) {
@@ -148,99 +172,107 @@ export class TdsDropdown {
         this.normalizeText = true;
         this.noResultText = 'No result';
         this.defaultValue = undefined;
-        this.value = null;
         this.open = false;
-        this.internalValue = undefined;
+        this.value = undefined;
         this.filterResult = undefined;
         this.filterFocus = undefined;
-        this.selectedOptions = [];
     }
-    handleValueChange(newValue) {
-        // Normalize to array
-        const normalizedValue = this.normalizeValue(newValue);
-        // Only update if actually changed
-        if (this.hasValueChanged(normalizedValue, this.selectedOptions)) {
-            this.updateDropdownState(normalizedValue);
-        }
-    }
-    normalizeValue(value) {
-        if (!value || value === '')
-            return []; // Handle both null and empty string
-        // For multiselect, keep array. For single select, wrap in array
-        if (this.multiselect) {
-            return Array.isArray(value) ? value : value.split(',').filter((v) => v !== '');
-        }
-        return Array.isArray(value) ? value : [value];
-    }
-    hasValueChanged(newValue, currentValue) {
-        if (newValue.length !== currentValue.length)
-            return true;
-        return newValue.some((val) => !currentValue.includes(val));
+    /** Method that resets the Dropdown, marks all children as non-selected and resets the value to null. */
+    async reset() {
+        this.dropdownList.scrollTop = 0;
+        this.internalReset();
+        this.handleChange();
     }
-    updateDropdownState(values) {
-        // Update internal state
-        this.selectedOptions = this.validateValues(values);
-        // Then update the value prop to match
-        this.value = this.multiselect ? this.selectedOptions : this.selectedOptions[0] || null;
-        // Update DOM
-        this.updateOptionElements();
-        // Update display value
-        this.updateDisplayValue();
-        // Emit change event
-        this.emitChange();
-        // Update value attribute
-        this.setValueAttribute();
+    /** Method that forces focus on the input element. */
+    async focusElement() {
+        this.focusInputElement();
+        this.handleFocus({});
     }
-    validateValues(values) {
-        return values.filter((val) => {
-            var _a;
-            const isValid = (_a = this.getChildren()) === null || _a === void 0 ? void 0 : _a.some((element) => element.value === val);
-            if (!isValid) {
-                console.warn(`Option with value "${val}" does not exist`);
+    /** Method for setting the value of the Dropdown.
+     *
+     * Single selection example:
+     *
+     * <code>
+     *  dropdown.setValue('option-1', 'Option 1');
+     * </code>
+     *
+     * Multiselect example:
+     *
+     * <code>
+     *  dropdown.setValue(['option-1', 'option-2']);
+     * </code>
+     */
+    //  The label is optional here ONLY to not break the API. Should be removed for 2.0.
+    // @ts-ignore
+    // eslint-disable-next-line no-unused-vars, @typescript-eslint/no-unused-vars
+    async setValue(value, 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]];
+        }
+        nextValue = [...new Set(nextValue)];
+        this.internalReset();
+        for (let i = 0; i < nextValue.length; i++) {
+            const optionExist = this.getChildren().some((element) => element.value === nextValue[i]);
+            if (!optionExist) {
+                nextValue.splice(i, 1);
             }
-            return isValid;
-        });
-    }
-    updateOptionElements() {
-        var _a;
-        (_a = this.getChildren()) === null || _a === void 0 ? void 0 : _a.forEach((element) => {
-            element.setSelected(this.selectedOptions.includes(element.value));
-        });
-    }
-    updateDisplayValue() {
-        this.internalValue = this.getSelectedChildrenLabels().join(', ');
-        if (this.filter && this.inputElement) {
-            this.inputElement.value = this.internalValue;
         }
-    }
-    emitChange() {
-        const value = this.multiselect
-            ? this.selectedOptions.join(',')
-            : this.selectedOptions[0] || null;
-        this.tdsChange.emit({
-            name: this.name,
-            value: value !== null && value !== void 0 ? value : null,
-        });
-    }
-    async setValue(value) {
-        const normalizedValue = this.normalizeValue(value);
-        this.updateDropdownState(normalizedValue);
-        return this.getSelectedChildren().map((element) => ({
+        this.value = nextValue;
+        this.setValueAttribute();
+        this.selectChildrenAsSelectedBasedOnSelectionProp();
+        this.handleChange();
+        /* This returns an array of object with a value and label pair. This is ONLY to not break the API. Should be removed for 2.0. */
+        /* https://tegel.atlassian.net/browse/CDEP-2703 */
+        const selection = this.getSelectedChildren().map((element) => ({
             value: element.value,
             label: element.textContent.trim(),
         }));
+        // Update inputElement value and placeholder text
+        if (this.filter) {
+            this.inputElement.value = this.getValue();
+        }
+        return selection;
     }
-    async reset() {
-        this.updateDropdownState([]);
+    /**
+     * @internal
+     */
+    async appendValue(value) {
+        if (this.multiselect && this.value) {
+            this.setValue([...this.value, value]);
+        }
+        else {
+            this.setValue(value);
+        }
     }
+    /** Method for removing a selected value in the Dropdown. */
     async removeValue(oldValue) {
-        const newValues = this.selectedOptions.filter((v) => v !== oldValue);
-        this.updateDropdownState(newValues);
-    }
-    /** Method that forces focus on the input element. */
-    async focusElement() {
-        this.focusInputElement();
-        this.handleFocus({});
+        var _a, _b;
+        let label;
+        if (this.multiselect) {
+            (_a = this.getChildren()) === null || _a === void 0 ? void 0 : _a.forEach((element) => {
+                var _a;
+                if (element.value === oldValue) {
+                    this.value = (_a = this.value) === null || _a === void 0 ? void 0 : _a.filter((value) => value !== element.value);
+                    label = element.textContent.trim();
+                    element.setSelected(false);
+                }
+                return element;
+            });
+        }
+        else {
+            this.reset();
+        }
+        this.handleChange();
+        this.setValueAttribute();
+        /* This returns an array of object with a value and label pair. This is ONLY to not break the API. Should be removed for 2.0. */
+        /* https://tegel.atlassian.net/browse/CDEP-2703 */
+        return (_b = this.value) === null || _b === void 0 ? void 0 : _b.map((value) => ({ value, label }));
     }
     /** Method for closing the Dropdown. */
     async close() {
@@ -289,15 +321,12 @@ 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();
             }
         }
     }
     componentWillLoad() {
-        if (this.defaultValue && !this.value) {
-            const initialValue = this.multiselect ? this.defaultValue.split(',') : [this.defaultValue];
-            this.updateDropdownState(initialValue);
-        }
+        this.setDefaultOption();
     }
     /** Method to handle slot changes */
     handleSlotChange() {
@@ -307,13 +336,29 @@ export class TdsDropdown {
     normalizeString(text) {
         return this.normalizeText ? text.normalize('NFD').replace(/\p{Diacritic}/gu, '') : text;
     }
-    async appendValue(value) {
-        if (this.multiselect) {
-            this.updateDropdownState([...this.selectedOptions, value]);
-        }
-        else {
-            this.updateDropdownState([value]);
-        }
+    /** Method that resets the dropdown without emitting an event. */
+    internalReset() {
+        this.getChildren().forEach((element) => {
+            element.setSelected(false);
+            return element;
+        });
+        this.value = null;
+        this.setValueAttribute();
+    }
+    selectChildrenAsSelectedBasedOnSelectionProp() {
+        this.getChildren().forEach((element) => {
+            this.value.forEach((selection) => {
+                if (element.value !== selection) {
+                    // If not multiselect, we need to unselect all other options.
+                    if (!this.multiselect) {
+                        element.setSelected(false);
+                    }
+                }
+                else {
+                    element.setSelected(true);
+                }
+            });
+        });
     }
     componentDidRender() {
         const form = this.host.closest('form');
@@ -328,8 +373,15 @@ export class TdsDropdown {
         }
     }
     render() {
-        appendHiddenInput(this.host, this.name, this.selectedOptions.join(','), this.disabled);
-        return (h(Host, { key: 'b084be887c56fbce2c51c70c6c5e29d2dbff0555', role: "select", class: `${this.modeVariant ? `tds-mode-variant-${this.modeVariant}` : ''}` }, this.label && this.labelPosition === 'outside' && (h("div", { key: 'b24fadee61a85c008cff52fe1e47570f7b3db29e', class: `label-outside ${this.disabled ? 'disabled' : ''}` }, this.label)), h("div", { key: '01ba50787cfdb187f5fa602ac6d21283a1fcd98b', class: `dropdown-select ${this.size} ${this.disabled ? 'disabled' : ''}` }, this.filter ? (h("div", { class: {
+        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: '3b547dda7bede0ae8e020d976d08ed9d8bf50356', role: "select", class: {
+                [`tds-mode-variant-${this.modeVariant}`]: Boolean(this.modeVariant),
+            } }, this.label && this.labelPosition === 'outside' && (h("div", { key: 'ca3c45bce793171f4af249b4c007d4279599f2b4', class: `label-outside ${this.disabled ? 'disabled' : ''}` }, this.label)), h("div", { key: 'fb12d8b69a4430977b3269f44f9b5e5600965cc1', class: {
+                'dropdown-select': true,
+                [this.size]: true,
+                'disabled': this.disabled,
+            } }, this.filter ? (h("div", { class: {
                 filter: true,
                 focus: this.filterFocus,
                 disabled: this.disabled,
@@ -337,16 +389,26 @@ export class TdsDropdown {
             } }, h("div", { class: "value-wrapper" }, this.label && this.labelPosition === 'inside' && this.placeholder && (h("div", { class: `label-inside ${this.size}` }, this.label)), this.label && this.labelPosition === 'inside' && !this.placeholder && (h("div", { class: `
                     label-inside-as-placeholder
                     ${this.size}
-                    ${this.selectedOptions.length ? 'selected' : ''}
+                    ${((_b = this.value) === null || _b === void 0 ? void 0 : _b.length) ? 'selected' : ''}
                     ` }, this.label)), h("input", {
             // eslint-disable-next-line no-return-assign
-            ref: (inputEl) => (this.inputElement = inputEl), class: `${this.labelPosition === 'inside' ? 'placeholder' : ''}`, type: "text", placeholder: this.filterFocus ? '' : this.placeholder, value: this.multiselect && this.filterFocus ? '' : this.getValue(), disabled: this.disabled, onInput: (event) => this.handleFilter(event), onBlur: (event) => {
+            ref: (inputEl) => (this.inputElement = inputEl), class: {
+                placeholder: this.labelPosition === 'inside',
+            }, type: "text", placeholder: this.filterFocus ? '' : this.placeholder, value: this.multiselect && this.filterFocus ? '' : this.getValue(), disabled: this.disabled, onInput: (event) => this.handleFilter(event), onBlur: (event) => {
                 this.filterFocus = false;
                 if (this.multiselect) {
                     this.inputElement.value = this.getValue();
                 }
                 this.handleBlur(event);
-            }, onFocus: (event) => this.handleFocus(event), onKeyDown: (event) => {
+            }, onFocus: (event) => {
+                this.open = true;
+                this.filterFocus = true;
+                if (this.multiselect) {
+                    this.inputElement.value = '';
+                }
+                this.handleFocus(event);
+                this.handleFilter({ target: { value: '' } });
+            }, onKeyDown: (event) => {
                 if (event.key === 'Escape') {
                     this.open = false;
                 }
@@ -355,7 +417,10 @@ export class TdsDropdown {
                 if (event.key === 'Enter') {
                     this.handleFilterReset();
                 }
-            }, class: `clear-icon ${this.open && this.inputElement.value !== '' ? '' : 'hide'}`, name: "cross", size: "16px" }), h("tds-icon", { tabIndex: 0, role: "button", "aria-label": "Open/Close dropdown", svgTitle: "Open/Close dropdown", onClick: this.handleToggleOpen, onKeyDown: (event) => {
+            }, class: {
+                'clear-icon': true,
+                'hide': !(this.open && this.inputElement.value !== ''),
+            }, name: "cross", size: "16px" }), h("tds-icon", { tabIndex: 0, role: "button", "aria-label": "Open/Close dropdown", svgTitle: "Open/Close dropdown", onClick: this.handleToggleOpen, onKeyDown: (event) => {
                 if (event.key === 'Enter') {
                     this.handleToggleOpen();
                 }
@@ -363,15 +428,19 @@ export class TdsDropdown {
                 if (event.key === 'Escape') {
                     this.open = false;
                 }
-            }, class: `
-                ${this.selectedOptions.length ? 'value' : 'placeholder'}
-                ${this.open ? 'open' : 'closed'}
-                ${this.error ? 'error' : ''}
-                `, disabled: this.disabled }, h("div", { class: `value-wrapper ${this.size}` }, this.label && this.labelPosition === 'inside' && this.placeholder && (h("div", { class: `label-inside ${this.size}` }, this.label)), this.label && this.labelPosition === 'inside' && !this.placeholder && (h("div", { class: `
-                    label-inside-as-placeholder
-                    ${this.size}
-                    ${this.selectedOptions.length ? 'selected' : ''}
-                    ` }, this.label)), h("div", { class: `placeholder ${this.size}` }, this.selectedOptions.length ? this.getValue() : this.placeholder), h("tds-icon", { "aria-label": "Open/Close dropdown", svgTitle: "Open/Close dropdown", class: `menu-icon ${this.open ? 'open' : 'closed'}`, name: "chevron_down", size: "16px" }))))), h("div", { key: '849ff954ec4ae3fc46e1de5dd236d409e9796adb', ref: (element) => (this.dropdownList = element), class: {
+            }, class: {
+                value: Boolean(this.value),
+                placeholder: Boolean(!this.value),
+                open: this.open,
+                closed: !this.open,
+                error: this.error,
+            }, disabled: this.disabled }, h("div", { class: `value-wrapper ${this.size}` }, this.label && this.labelPosition === 'inside' && this.placeholder && (h("div", { class: `label-inside ${this.size}` }, this.label)), this.label && this.labelPosition === 'inside' && !this.placeholder && (h("div", { class: {
+                'label-inside-as-placeholder': true,
+                [this.size]: true,
+                'selected': Boolean((_c = this.value) === null || _c === void 0 ? void 0 : _c.length),
+            } }, 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: 'b734958a92e331bc6fcd07a0cf716219cec235c1', ref: (element) => {
+                this.dropdownList = element;
+            }, class: {
                 'dropdown-list': true,
                 [this.size]: true,
                 [this.getOpenDirection()]: true,
@@ -380,7 +449,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: 'bae1fc6a37421363f0f104a5b1637dad11b13722', onSlotchange: () => this.handleSlotChange() }), this.filterResult === 0 && this.noResultText !== '' && (h("div", { key: 'b8c57fb7c25949a603734eaff7ccae28aa01b787', class: `no-result ${this.size}` }, this.noResultText))), this.helper && (h("div", { key: 'c06e8e79f8ecaf3abc7fa97ea520b0e81ea48b33', class: `helper ${this.error ? 'error' : ''} ${this.disabled ? 'disabled' : ''}` }, this.error && h("tds-icon", { key: '7793cdff81b04b20111083c9ad288773339c570d', name: "error", size: "16px" }), this.helper))));
+            } }, h("slot", { key: '85d5f7599b21df148a34416fb271c894ff6a2e3e', onSlotchange: () => this.handleSlotChange() }), this.filterResult === 0 && this.noResultText !== '' && (h("div", { key: '5009c99ade06605dd2605e28f59b82e78e3f3bec', class: `no-result ${this.size}` }, this.noResultText))), this.helper && (h("div", { key: '88d55d60aac26a3c5af04bfa74b6649d5d893fce', class: {
+                helper: true,
+                error: this.error,
+                disabled: this.disabled,
+            } }, this.error && h("tds-icon", { key: '1f6f2b7272f35501bf684816b4bc1cd746910fe9', name: "error", size: "16px" }), this.helper))));
     }
     static get is() { return "tds-dropdown"; }
     static get encapsulation() { return "shadow"; }
@@ -677,34 +750,15 @@ export class TdsDropdown {
                 },
                 "attribute": "default-value",
                 "reflect": false
-            },
-            "value": {
-                "type": "string",
-                "mutable": true,
-                "complexType": {
-                    "original": "string | string[]",
-                    "resolved": "string | string[]",
-                    "references": {}
-                },
-                "required": false,
-                "optional": false,
-                "docs": {
-                    "tags": [],
-                    "text": "Value of the dropdown. For multiselect, provide array of strings. For single select, provide a string."
-                },
-                "attribute": "value",
-                "reflect": false,
-                "defaultValue": "null"
             }
         };
     }
     static get states() {
         return {
             "open": {},
-            "internalValue": {},
+            "value": {},
             "filterResult": {},
-            "filterFocus": {},
-            "selectedOptions": {}
+            "filterFocus": {}
         };
     }
     static get events() {
@@ -783,51 +837,28 @@ export class TdsDropdown {
                         }
                     }
                 }
-            }, {
-                "method": "tdsValueChange",
-                "name": "tdsValueChange",
-                "bubbles": true,
-                "cancelable": false,
-                "composed": true,
-                "docs": {
-                    "tags": [],
-                    "text": "Value change event for the Dropdown."
-                },
-                "complexType": {
-                    "original": "{\n    name: string;\n    value: string;\n  }",
-                    "resolved": "{ name: string; value: string; }",
-                    "references": {}
-                }
             }];
     }
     static get methods() {
         return {
-            "setValue": {
+            "reset": {
                 "complexType": {
-                    "signature": "(value: string | string[]) => Promise<{ value: string; label: string; }[]>",
-                    "parameters": [{
-                            "name": "value",
-                            "type": "string | string[]",
-                            "docs": ""
-                        }],
+                    "signature": "() => Promise<void>",
+                    "parameters": [],
                     "references": {
                         "Promise": {
                             "location": "global",
                             "id": "global::Promise"
-                        },
-                        "HTMLTdsDropdownOptionElement": {
-                            "location": "global",
-                            "id": "global::HTMLTdsDropdownOptionElement"
                         }
                     },
-                    "return": "Promise<{ value: string; label: string; }[]>"
+                    "return": "Promise<void>"
                 },
                 "docs": {
-                    "text": "",
+                    "text": "Method that resets the Dropdown, marks all children as non-selected and resets the value to null.",
                     "tags": []
                 }
             },
-            "reset": {
+            "focusElement": {
                 "complexType": {
                     "signature": "() => Promise<void>",
                     "parameters": [],
@@ -840,15 +871,19 @@ 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[], label?: string) => Promise<{ value: string; label: string; }[]>",
                     "parameters": [{
-                            "name": "oldValue",
+                            "name": "value",
+                            "type": "string | string[]",
+                            "docs": ""
+                        }, {
+                            "name": "label",
                             "type": "string",
                             "docs": ""
                         }],
@@ -856,19 +891,27 @@ export class TdsDropdown {
                         "Promise": {
                             "location": "global",
                             "id": "global::Promise"
+                        },
+                        "HTMLTdsDropdownOptionElement": {
+                            "location": "global",
+                            "id": "global::HTMLTdsDropdownOptionElement"
                         }
                     },
-                    "return": "Promise<void>"
+                    "return": "Promise<{ value: string; 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",
@@ -878,35 +921,42 @@ export class TdsDropdown {
                     "return": "Promise<void>"
                 },
                 "docs": {
-                    "text": "Method that forces focus on the input element.",
-                    "tags": []
+                    "text": "",
+                    "tags": [{
+                            "name": "internal",
+                            "text": undefined
+                        }]
                 }
             },
-            "close": {
+            "removeValue": {
                 "complexType": {
-                    "signature": "() => Promise<void>",
-                    "parameters": [],
+                    "signature": "(oldValue: string) => Promise<{ value: string; label: string; }[]>",
+                    "parameters": [{
+                            "name": "oldValue",
+                            "type": "string",
+                            "docs": ""
+                        }],
                     "references": {
                         "Promise": {
                             "location": "global",
                             "id": "global::Promise"
+                        },
+                        "HTMLTdsDropdownOptionElement": {
+                            "location": "global",
+                            "id": "global::HTMLTdsDropdownOptionElement"
                         }
                     },
-                    "return": "Promise<void>"
+                    "return": "Promise<{ value: string; label: string; }[]>"
                 },
                 "docs": {
-                    "text": "Method for closing the Dropdown.",
+                    "text": "Method for removing a selected value in the Dropdown.",
                     "tags": []
                 }
             },
-            "appendValue": {
+            "close": {
                 "complexType": {
-                    "signature": "(value: string) => Promise<void>",
-                    "parameters": [{
-                            "name": "value",
-                            "type": "string",
-                            "docs": ""
-                        }],
+                    "signature": "() => Promise<void>",
+                    "parameters": [],
                     "references": {
                         "Promise": {
                             "location": "global",
@@ -916,7 +966,7 @@ export class TdsDropdown {
                     "return": "Promise<void>"
                 },
                 "docs": {
-                    "text": "",
+                    "text": "Method for closing the Dropdown.",
                     "tags": []
                 }
             }
@@ -925,9 +975,6 @@ export class TdsDropdown {
     static get elementRef() { return "host"; }
     static get watchers() {
         return [{
-                "propName": "value",
-                "methodName": "handleValueChange"
-            }, {
                 "propName": "open",
                 "methodName": "handleOpenState"
             }];