@scania/tegel 1.0.0 → 1.0.3

package/dist/collection/components/datetime/datetime.stories.js

@@ -1,5 +1,5 @@
 import readme from "./readme.md";
-import { formatHtmlPreview } from "../../utils/utils";
+import formatHtmlPreview from "../../stories/formatHtmlPreview";
 import { ComponentsFolder } from "../../utils/constants";
 export default {
   title: `${ComponentsFolder}/Datetime`,
@@ -174,46 +174,46 @@ const datetimeTemplate = ({ modeVariant, state, type, size, defaultValue, minVal
     else
       return false;
   };
-  return formatHtmlPreview(`
-    <style>
-        /* Note: Demo classes used here are just for demo purposes in Storybook */
-        .demo-wrapper {
-            width: 180px;
-        }
-    </style>
-
-  <div class="demo-wrapper">
-
-    <tds-datetime
-      id="datetime"
-      ${defaultValue !== 'None' ? `default-value="${getDefaultValue(defaultValue, type)}"` : ''}
-      ${modeVariant !== 'Inherit from parent' ? `mode-variant="${modeVariant.toLowerCase()}"` : ''}
-      type="${typeLookup[type]}"      
-      ${minValue ? `min=${minValue}` : ''}
-      ${maxValue ? `min=${maxValue}` : ''}
-      size="${sizeLookup[size]}"
-      state="${stateLookup[state]}"
-      ${disabled ? 'disabled' : ''}
-      ${noMinWidth ? 'no-min-width' : ''}
-      ${label ? `label="${label}" ` : ''}
-      ${helper ? `helper="${helper}" ` : ''}
-      >
-    </tds-datetime>
-  </div>
-
-    <script>
-    /* DEMO Code: Used only for Storybook demo purposes */
-      datetimeElement = document.querySelector('tds-datetime');
-      datetimeElement.addEventListener('tdsChange', (event) => {
-        console.log(event);
-      });
-      datetimeElement.addEventListener('tdsFocus', (event) => {
-        console.log(event);
-      });
-      datetimeElement.addEventListener('tdsBlur', (event) => {
-        console.log(event);
-      });
-    </script>
+  return formatHtmlPreview(`
+    <style>
+        /* Note: Demo classes used here are just for demo purposes in Storybook */
+        .demo-wrapper {
+            width: 180px;
+        }
+    </style>
+
+  <div class="demo-wrapper">
+
+    <tds-datetime
+      id="datetime"
+      ${defaultValue !== 'None' ? `default-value="${getDefaultValue(defaultValue, type)}"` : ''}
+      ${modeVariant !== 'Inherit from parent' ? `mode-variant="${modeVariant.toLowerCase()}"` : ''}
+      type="${typeLookup[type]}"      
+      ${minValue ? `min=${minValue}` : ''}
+      ${maxValue ? `min=${maxValue}` : ''}
+      size="${sizeLookup[size]}"
+      state="${stateLookup[state]}"
+      ${disabled ? 'disabled' : ''}
+      ${noMinWidth ? 'no-min-width' : ''}
+      ${label ? `label="${label}" ` : ''}
+      ${helper ? `helper="${helper}" ` : ''}
+      >
+    </tds-datetime>
+  </div>
+
+    <script>
+    /* DEMO Code: Used only for Storybook demo purposes */
+      datetimeElement = document.querySelector('tds-datetime');
+      datetimeElement.addEventListener('tdsChange', (event) => {
+        console.log(event);
+      });
+      datetimeElement.addEventListener('tdsFocus', (event) => {
+        console.log(event);
+      });
+      datetimeElement.addEventListener('tdsBlur', (event) => {
+        console.log(event);
+      });
+    </script>
 `);
 };
 export const Default = datetimeTemplate.bind({});

package/dist/collection/components/divider/divider.stories.js

@@ -1,4 +1,4 @@
-import { formatHtmlPreview } from "../../utils/utils";
+import formatHtmlPreview from "../../stories/formatHtmlPreview";
 import readme from "./readme.md";
 import { ComponentsFolder } from "../../utils/constants";
 export default {
@@ -54,9 +54,9 @@ export default {
     height: 150,
   },
 };
-const Template = ({ orientation, width, height }) => formatHtmlPreview(`
-  <div style="${orientation === 'Horizontal' ? `width: ${width}px;` : `height: ${height}px;`}">
-    <tds-divider orientation="${orientation.toLowerCase()}"></tds-divider>
-  </div>
+const Template = ({ orientation, width, height }) => formatHtmlPreview(`
+  <div style="${orientation === 'Horizontal' ? `width: ${width}px;` : `height: ${height}px;`}">
+    <tds-divider orientation="${orientation.toLowerCase()}"></tds-divider>
+  </div>
 `);
 export const Default = Template.bind({});

package/dist/collection/components/dropdown/dropdown-option/dropdown-option.css

@@ -41,14 +41,14 @@
   outline-offset: -2px;
 }
 :host .dropdown-option .multiselect {
-  padding: 0 16px;
   width: 100%;
+  height: 100%;
 }
-:host .dropdown-option .multiselect tds-checkbox,
-:host .dropdown-option .multiselect .tds-checkbox-webcomponent,
-:host .dropdown-option .multiselect label {
+:host .dropdown-option .multiselect tds-checkbox {
+  display: flex;
   height: 100%;
   width: 100%;
+  padding: 0 16px;
 }
 :host .dropdown-option:hover {
   background-color: var(--tds-dropdown-option-background-hover);

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

@@ -16,7 +16,7 @@ export class TdsDropdownOption {
     this.handleSingleSelect = () => {
       if (!this.disabled) {
         this.selected = true;
-        this.parentElement.setValue(this.value, this.label);
+        this.parentElement.appendValue(this.value);
         this.parentElement.close();
         this.tdsSelect.emit({
           value: this.value,
@@ -27,7 +27,7 @@ export class TdsDropdownOption {
     this.handleMultiselect = (event) => {
       if (!this.disabled) {
         if (event.detail.checked) {
-          this.parentElement.setValue(this.value, this.label);
+          this.parentElement.appendValue(this.value);
           this.selected = true;
           this.tdsSelect.emit({
             value: this.value,
@@ -42,6 +42,7 @@ export class TdsDropdownOption {
             selected: this.selected,
           });
         }
+        event.stopPropagation();
       }
     };
     this.handleFocus = (event) => {
@@ -61,10 +62,10 @@ export class TdsDropdownOption {
     this.selected = selected;
   }
   render() {
-    return (h(Host, { role: "option", "aria-disabled": this.disabled, "aria-selected": this.selected }, h("div", { class: `dropdown-option 
-          ${this.size}
-          ${this.selected ? 'selected' : ''}
-          ${this.disabled ? 'disabled' : ''}
+    return (h(Host, { role: "option", "aria-disabled": this.disabled, "aria-selected": this.selected }, h("div", { class: `dropdown-option 
+          ${this.size}
+          ${this.selected ? 'selected' : ''}
+          ${this.disabled ? 'disabled' : ''}
           ` }, this.multiselect ? (h("div", { class: "multiselect", onKeyDown: (event) => {
         if (event.key === 'Escape') {
           this.parentElement.close();
@@ -146,7 +147,7 @@ export class TdsDropdownOption {
           "text": "Click event for the Dropdown option."
         },
         "complexType": {
-          "original": "{\r\n    selected: boolean;\r\n    value: string;\r\n  }",
+          "original": "{\n    selected: boolean;\n    value: string;\n  }",
           "resolved": "{ selected: boolean; value: string; }",
           "references": {}
         }

package/dist/collection/components/dropdown/dropdown.css

@@ -20,9 +20,14 @@
 }
 :host button.value {
   color: var(--tds-dropdown-value-color);
+  font: var(--tds-detail-02);
+  letter-spacing: var(--tds-detail-02-ls);
+  /** Needed to not get be affected by overflow:hidden 
+  The original line-height is 1.14 */
+  line-height: 1.3;
 }
 :host button:focus {
-  border-bottom-color: transparent;
+  border-bottom-color: var(--tds-dropdown-border-bottom-open);
 }
 :host button:focus::before {
   content: "";
@@ -30,7 +35,7 @@
   bottom: 0;
   left: 0;
   width: 100%;
-  height: 2px;
+  height: 1px;
   background: var(--tds-dropdown-border-bottom-open);
 }
 :host button.error {

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

@@ -1,28 +1,28 @@
 import { Host, h } from "@stencil/core";
-import { appendHiddenInput, findNextFocusableItem, findPreviousFocusableItem, } from "../../utils/utils";
+import findNextFocusableElement from "../../utils/findNextFocusableElement";
+import findPreviousFocusableElement from "../../utils/findPreviousFocusableElement";
+import appendHiddenInput from "../../utils/appendHiddenInput";
 /**
  * @slot <default> - <b>Unnamed slot.</b> For dropdown option elements.
  */
 export class TdsDropdown {
   constructor() {
     this.setDefaultOption = () => {
-      this.children = Array.from(this.host.children)
+      Array.from(this.host.children)
         .filter((element) => element.tagName === 'TDS-DROPDOWN-OPTION')
-        .map((element) => {
+        .forEach((element) => {
         if (this.multiselect) {
           this.defaultValue.split(',').forEach((value) => {
             if (value === element.value) {
               element.setSelected(true);
-              this.selection = this.selection
-                ? [...this.selection, { value: element.value, label: element.textContent }]
-                : [{ value: element.value, label: element.textContent }];
+              this.value = this.value ? [...this.value, element.value] : [element.value];
             }
           });
         }
         else {
           if (this.defaultValue === element.value) {
             element.setSelected(true);
-            this.selection = [{ value: element.value, label: element.textContent }];
+            this.value = [element.value];
           }
           else {
             element.setSelected(false);
@@ -46,19 +46,28 @@ export class TdsDropdown {
       }
       return this.openDirection;
     };
+    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 = () => {
-      var _a, _b;
-      if (this.filter) {
-        return (_a = this.selection) === null || _a === void 0 ? void 0 : _a.map((item) => item.label).toString();
-      }
-      return (_b = this.selection) === null || _b === void 0 ? void 0 : _b.map((item) => item.label).join(', ');
+      const labels = this.getSelectedChildrenLabels();
+      return this.filter ? labels === null || labels === void 0 ? void 0 : labels.join(', ') : labels === null || labels === void 0 ? void 0 : labels.toString();
     };
     this.handleFilter = (event) => {
       this.tdsInput.emit(event);
       const query = event.target.value.toLowerCase();
       /* Check if the query is empty, and if so, show all options */
+      const children = this.getChildren();
       if (query === '') {
-        this.children = this.children.map((element) => {
+        children.forEach((element) => {
           element.removeAttribute('hidden');
           return element;
         });
@@ -66,7 +75,7 @@ export class TdsDropdown {
         /* Hide the options that do not match the query */
       }
       else {
-        this.filterResult = this.children.filter((element) => {
+        this.filterResult = children.filter((element) => {
           if (!element.textContent.toLowerCase().includes(query.toLowerCase())) {
             element.setAttribute('hidden', '');
           }
@@ -87,7 +96,7 @@ export class TdsDropdown {
       var _a, _b;
       this.tdsChange.emit({
         name: this.name,
-        value: (_b = (_a = this.selection) === null || _a === void 0 ? void 0 : _a.map((item) => item.value).toString()) !== null && _b !== void 0 ? _b : null,
+        value: (_b = (_a = this.value) === null || _a === void 0 ? void 0 : _a.map((value) => value).toString()) !== null && _b !== void 0 ? _b : null,
       });
     };
     this.name = undefined;
@@ -105,46 +114,82 @@ export class TdsDropdown {
     this.noResultText = 'No result';
     this.defaultValue = undefined;
     this.open = false;
-    this.selection = undefined;
+    this.value = undefined;
     this.filterResult = undefined;
     this.filterFocus = undefined;
   }
   /** Method that resets the Dropdown, marks all children as non-selected and resets the value to null. */
   async reset() {
-    this.children = this.getChildren().map((element) => {
-      element.setSelected(false);
-      return element;
-    });
-    this.selection = null;
-    this.host.setAttribute('value', null);
+    this.internalReset();
     this.handleChange();
   }
-  /** Method for setting the value of the Dropdown. */
-  async setValue(newValue, newValueLabel) {
-    if (this.multiselect) {
-      this.selection = this.selection
-        ? [...this.selection, { value: newValue, label: newValueLabel }]
-        : [{ value: newValue, label: newValueLabel }];
+  /** 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.
+  // eslint-disable-next-line no-unused-vars, @typescript-eslint/no-unused-vars
+  async setValue(value, label) {
+    var _a;
+    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]];
     }
-    else {
-      this.selection = [{ value: newValue, label: newValueLabel }];
-      this.children = this.getChildren().map((element) => {
-        if (element.value !== newValue) {
-          element.setSelected(false);
-        }
-        return element;
-      });
+    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.host.setAttribute('value', (_a = this.value) === null || _a === void 0 ? void 0 : _a.map((val) => val).toString());
+    this.selectChildrenAsSelectedBasedOnSelectionProp();
     this.handleChange();
-    this.host.setAttribute('value', this.selection.map((selection) => selection.value).toString());
-    return this.selection;
+    /* 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. */
+    // TODO - Clean up and just return this.value for 2.0
+    const selection = this.getSelectedChildren().map((element) => ({
+      value: element.value,
+      label: element.textContent.trim(),
+    }));
+    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) {
-      this.children = this.getChildren().map((element) => {
+      (_a = this.getChildren()) === null || _a === void 0 ? void 0 : _a.forEach((element) => {
+        var _a;
         if (element.value === oldValue) {
-          this.selection = this.selection.filter((item) => item.value !== element.value);
+          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;
@@ -154,7 +199,9 @@ export class TdsDropdown {
       this.reset();
     }
     this.handleChange();
-    return this.selection;
+    /* 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. */
+    // TODO - Clean up and just return this.value for 2.0
+    return (_b = this.value) === null || _b === void 0 ? void 0 : _b.map((value) => ({ value, label }));
   }
   /** Method for closing the Dropdown. */
   async close() {
@@ -175,23 +222,24 @@ export class TdsDropdown {
     if (!activeElement) {
       return;
     }
+    const children = this.getChildren();
     if (event.key === 'ArrowDown') {
       /* Get the index of the current focus index, if there is no
       nextElementSibling return the index for the first child in our Dropdown.  */
       const startingIndex = activeElement.nextElementSibling
-        ? this.children.findIndex((element) => element === activeElement.nextElementSibling)
+        ? children.findIndex((element) => element === activeElement.nextElementSibling)
         : 0;
-      const elementIndex = findNextFocusableItem(this.children, startingIndex);
-      this.children[elementIndex].focus();
+      const elementIndex = findNextFocusableElement(children, startingIndex);
+      children[elementIndex].focus();
     }
     else if (event.key === 'ArrowUp') {
       /* Get the index of the current focus index, if there is no
       previousElementSibling return the index for the first last in our Dropdown.  */
       const startingIndex = activeElement.nextElementSibling
-        ? this.children.findIndex((element) => element === activeElement.previousElementSibling)
+        ? this.getChildren().findIndex((element) => element === activeElement.previousElementSibling)
         : 0;
-      const elementIndex = findPreviousFocusableItem(this.children, startingIndex);
-      this.children[elementIndex].focus();
+      const elementIndex = findPreviousFocusableElement(children, startingIndex);
+      children[elementIndex].focus();
     }
     else if (event.key === 'Escape') {
       this.open = false;
@@ -200,10 +248,9 @@ export class TdsDropdown {
   // If the Dropdown gets closed,
   // this sets the value of the dropdown to the current selection labels or null if no selection is made.
   handleOpenState() {
-    var _a, _b;
     if (this.filter && this.multiselect) {
       if (!this.open) {
-        this.inputElement.value = (_b = (_a = this.selection) === null || _a === void 0 ? void 0 : _a.map((item) => item.label).toString()) !== null && _b !== void 0 ? _b : null;
+        this.inputElement.value = this.getValue();
       }
     }
   }
@@ -212,14 +259,38 @@ export class TdsDropdown {
       this.setDefaultOption();
     }
   }
+  /** Method that resets the dropdown without emitting an event. */
+  internalReset() {
+    this.getChildren().forEach((element) => {
+      element.setSelected(false);
+      return element;
+    });
+    this.value = null;
+    this.host.setAttribute('value', null);
+  }
+  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);
+        }
+      });
+    });
+  }
   render() {
     var _a, _b, _c, _d;
-    appendHiddenInput(this.host, this.name, (_a = this.selection) === null || _a === void 0 ? void 0 : _a.map((item) => item.value).toString(), this.disabled);
-    return (h(Host, { role: "select", class: `${this.modeVariant ? `tds-mode-variant-${this.modeVariant}` : ''}` }, this.label && this.labelPosition === 'outside' && (h("div", { class: `label-outside ${this.disabled ? 'disabled' : ''}` }, this.label)), h("div", { class: `dropdown-select ${this.size} ${this.disabled ? 'disabled' : ''}` }, this.filter ? (h("div", { class: `filter ${this.filterFocus ? 'focus' : ''}
-            ${this.disabled ? 'disabled' : ''}` }, 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.selection) === null || _b === void 0 ? void 0 : _b.length) ? 'selected' : ''}
+    appendHiddenInput(this.host, this.name, (_a = this.value) === null || _a === void 0 ? void 0 : _a.map((value) => value).toString(), this.disabled);
+    return (h(Host, { role: "select", class: `${this.modeVariant ? `tds-mode-variant-${this.modeVariant}` : ''}` }, this.label && this.labelPosition === 'outside' && (h("div", { class: `label-outside ${this.disabled ? 'disabled' : ''}` }, this.label)), h("div", { class: `dropdown-select ${this.size} ${this.disabled ? 'disabled' : ''}` }, this.filter ? (h("div", { class: `filter ${this.filterFocus ? 'focus' : ''}
+            ${this.disabled ? 'disabled' : ''}` }, 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.label)), h("input", {
       // eslint-disable-next-line no-return-assign
       ref: (element) => (this.inputElement = element), class: `${this.labelPosition === 'inside' ? 'placeholder' : ''}`, type: "text", placeholder: this.placeholder, value: this.getValue(), disabled: this.disabled, onInput: (event) => this.handleFilter(event), onBlur: (event) => {
@@ -242,18 +313,18 @@ export class TdsDropdown {
         if (event.key === 'Escape') {
           this.open = false;
         }
-      }, class: `
-                ${this.selection ? '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.selection) === null || _c === void 0 ? void 0 : _c.length) ? 'selected' : ''}
-                    ` }, this.label)), h("div", { class: `placeholder ${this.size}` }, ((_d = this.selection) === null || _d === void 0 ? void 0 : _d.length) ? this.getValue() : this.placeholder), h("tds-icon", { class: `${this.open ? 'open' : 'closed'}`, name: "chevron_down", size: "16px" }))))), h("div", { ref: (element) => (this.dropdownList = element), class: `dropdown-list
-            ${this.size}
-            ${this.open ? 'open' : 'closed'}
-            ${this.getOpenDirection()}
+      }, class: `
+                ${this.value ? '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", { class: `${this.open ? 'open' : 'closed'}`, name: "chevron_down", size: "16px" }))))), h("div", { ref: (element) => (this.dropdownList = element), class: `dropdown-list
+            ${this.size}
+            ${this.open ? 'open' : 'closed'}
+            ${this.getOpenDirection()}
             ${this.label && this.labelPosition === 'outside' ? 'label-outside' : ''}` }, h("slot", null), this.filterResult === 0 && (h("div", { class: `no-result ${this.size}` }, this.noResultText))), this.helper && (h("div", { class: `helper ${this.error ? 'error' : ''} ${this.disabled ? 'disabled' : ''}` }, this.error && h("tds-icon", { name: "error", size: "16px" }), this.helper))));
   }
   static get is() { return "tds-dropdown"; }
@@ -521,7 +592,7 @@ export class TdsDropdown {
   static get states() {
     return {
       "open": {},
-      "selection": {},
+      "value": {},
       "filterResult": {},
       "filterFocus": {}
     };
@@ -538,7 +609,7 @@ export class TdsDropdown {
           "text": "Change event for the Dropdown."
         },
         "complexType": {
-          "original": "{\r\n    name: string;\r\n    value: string;\r\n  }",
+          "original": "{\n    name: string;\n    value: string;\n  }",
           "resolved": "{ name: string; value: string; }",
           "references": {}
         }
@@ -614,10 +685,6 @@ export class TdsDropdown {
             "Promise": {
               "location": "global",
               "id": "global::Promise"
-            },
-            "HTMLTdsDropdownOptionElement": {
-              "location": "global",
-              "id": "global::HTMLTdsDropdownOptionElement"
             }
           },
           "return": "Promise<void>"
@@ -629,7 +696,7 @@ export class TdsDropdown {
       },
       "setValue": {
         "complexType": {
-          "signature": "(newValue: string, newValueLabel: string) => Promise<{ value: string; label: string; }[]>",
+          "signature": "(value: string | string[], label?: string) => Promise<{ value: string; label: string; }[]>",
           "parameters": [{
               "tags": [],
               "text": ""
@@ -650,10 +717,33 @@ export class TdsDropdown {
           "return": "Promise<{ value: string; label: string; }[]>"
         },
         "docs": {
-          "text": "Method for setting the value of the Dropdown.",
+          "text": "Method for setting the value of the Dropdown.\n\nSingle selection example:\n\n<code>\ndropdown.setValue('option-1', 'Option 1');\n</code>\n\nMultiselect example:\n\n<code>\ndropdown.setValue(['option-1', 'option-2']);\n</code>",
           "tags": []
         }
       },
+      "appendValue": {
+        "complexType": {
+          "signature": "(value: string) => Promise<void>",
+          "parameters": [{
+              "tags": [],
+              "text": ""
+            }],
+          "references": {
+            "Promise": {
+              "location": "global",
+              "id": "global::Promise"
+            }
+          },
+          "return": "Promise<void>"
+        },
+        "docs": {
+          "text": "",
+          "tags": [{
+              "name": "internal",
+              "text": undefined
+            }]
+        }
+      },
       "removeValue": {
         "complexType": {
           "signature": "(oldValue: string) => Promise<{ value: string; label: string; }[]>",