@uplynk/lynk-design 1.19.1 → 1.19.2

package/dist/chunks/chunk.YMNJ75P3.js

@@ -0,0 +1,1276 @@
+import {
+  LynkTag
+} from "./chunk.WH3VWYR6.js";
+import {
+  LynkOption
+} from "./chunk.YYALM5V6.js";
+import {
+  scrollIntoView
+} from "./chunk.WSPFGNPB.js";
+import {
+  combobox_custom_styles_default
+} from "./chunk.3QDNRTLD.js";
+import {
+  combobox_styles_default
+} from "./chunk.N2A3BQBF.js";
+import {
+  defaultOptionRenderer
+} from "./chunk.2GOQR7WJ.js";
+import {
+  createOptionFromDifferentTypes,
+  filterOnlyOptgroups,
+  getAllOptions,
+  getAssignedElementsForSlot,
+  normalizeString
+} from "./chunk.OQP364MA.js";
+import {
+  LynkFormField
+} from "./chunk.XSSZIJ3T.js";
+import {
+  LynkPopup
+} from "./chunk.HONHU6BN.js";
+import {
+  FormControlController
+} from "./chunk.5AIQMNFQ.js";
+import {
+  waitForEvent
+} from "./chunk.B4BZKR24.js";
+import {
+  animateTo,
+  stopAnimations
+} from "./chunk.POQ2R5WV.js";
+import {
+  getAnimation,
+  setDefaultAnimation
+} from "./chunk.HKGM3EFE.js";
+import {
+  LocalizeController
+} from "./chunk.VIBAEA26.js";
+import {
+  LynkIcon
+} from "./chunk.335GLGJ2.js";
+import {
+  HasSlotController
+} from "./chunk.OW5NIGGX.js";
+import {
+  watch
+} from "./chunk.SPANRPKG.js";
+import {
+  LynkElement
+} from "./chunk.QEGXVYYA.js";
+import {
+  component_styles_default
+} from "./chunk.Y7724W4D.js";
+import {
+  __decorateClass
+} from "./chunk.O6LH3WX2.js";
+
+// src/components/combobox/combobox.component.ts
+import { html } from "lit";
+import { property, query, state } from "lit/decorators.js";
+import { classMap } from "lit/directives/class-map.js";
+import { unsafeHTML } from "lit/directives/unsafe-html.js";
+var LynkCombobox = class extends LynkElement {
+  constructor() {
+    super(...arguments);
+    this.formControlController = new FormControlController(this, {
+      assumeInteractionOn: ["ev-blur", "ev-input"]
+    });
+    this.hasSlotController = new HasSlotController(
+      this,
+      "help-text",
+      "help-tip",
+      "label",
+      "label-end",
+      "help-text-end"
+    );
+    this.localize = new LocalizeController(this);
+    /** The last value of a lynk-option, that was selected by click or via keyboard navigation */
+    this.lastOptionValue = "";
+    this.isOptionRendererTriggered = false;
+    this.hasFocus = false;
+    this.displayLabel = "";
+    this.selectedOptions = [];
+    this.numberFilteredOptions = 0;
+    this.cachedOptions = [];
+    this.showCustomOption = false;
+    this.query = "";
+    this.valueHasChanged = false;
+    this.name = "";
+    this._value = "";
+    this.defaultValue = "";
+    this.state = "default";
+    this.size = "medium";
+    this.placeholder = "";
+    this.disabled = false;
+    this.readonly = false;
+    this.required = false;
+    this.optional = false;
+    this.dirty = false;
+    this.clearable = false;
+    this.open = false;
+    this.hoist = false;
+    this.label = "";
+    this.placement = "bottom";
+    this.helpTip = "";
+    this.helpText = "";
+    this.labelEnd = "";
+    this.helpTextEnd = "";
+    this.form = "";
+    this.inline = false;
+    this.allowCustomValues = false;
+    this.multiple = false;
+    this.maxOptionsVisible = 3;
+    this.getTag = (option) => {
+      return html`
+      <lynk-tag
+        part="tag"
+        exportparts="
+              base:tag__base,
+              content:tag__content,
+              remove-button:tag__remove-button,
+              remove-button__base:tag__remove-button__base
+            "
+        size=${this.size}
+        removable
+        @ev-remove=${(event) => this.handleTagRemove(event, option)}
+      >
+        ${option.getTextLabel()}
+      </lynk-tag>
+    `;
+    };
+    this.getOption = defaultOptionRenderer;
+    this.filter = (option, queryStr) => {
+      let content = (option == null ? void 0 : option.textContent) || "";
+      if (option instanceof LynkOption) {
+        content = option.getTextLabel();
+      }
+      const normalizedOption = normalizeString(content);
+      const normalizedQuery = normalizeString(queryStr);
+      return normalizedOption.includes(normalizedQuery);
+    };
+    this.handleDocumentFocusIn = (event) => {
+      const path = event.composedPath();
+      if (this && !path.includes(this)) {
+        this.hide();
+      }
+    };
+    this.handleDocumentKeyDown = (event) => {
+      var _a, _b;
+      const target = event.target;
+      const isClearButton = target.closest(".combobox__clear") !== null;
+      const isTagRemove = target.closest("lynk-tag") !== null || target.closest("lynk-icon-button") !== null;
+      if (isClearButton || isTagRemove) {
+        return;
+      }
+      if (event.key === "Escape") {
+        if (this.open && !this.closeWatcher) {
+          event.preventDefault();
+          event.stopPropagation();
+          this.hide();
+          this.displayInput.focus({ preventScroll: true });
+        } else if (!this.open) {
+          this.clearCombobox();
+        }
+      }
+      if (event.key === "Enter") {
+        const currentOption = this.getCurrentOption();
+        const hasModifier = event.metaKey || event.ctrlKey || event.shiftKey || event.altKey;
+        if (this.multiple) {
+          if (!this.open && !hasModifier) {
+            setTimeout(() => {
+              if (!event.defaultPrevented) {
+                this.formControlController.submit();
+              }
+            });
+            return;
+          }
+          if (!this.open || (currentOption == null ? void 0 : currentOption.disabled)) {
+            return;
+          }
+          if ((_a = currentOption == null ? void 0 : currentOption.classList) == null ? void 0 : _a.contains("combobox__custom-option")) {
+            this.addCustomOptionValue(this.displayInput.value.trim());
+          } else if (currentOption) {
+            this.toggleOptionSelection(currentOption);
+          }
+          return;
+        }
+        if (!currentOption) {
+          const matchingOption = this.getSlottedOptions().find((option) => {
+            const optionValue = option.value || (option.getTextLabel ? option.getTextLabel() : option.textContent || "");
+            const optionLabel = option.getTextLabel ? option.getTextLabel() : option.textContent || "";
+            return optionValue === this.displayInput.value || optionLabel === this.displayInput.value;
+          });
+          if (matchingOption) {
+            const oldValue = this.lastOptionValue;
+            this.setSelectedOption(matchingOption);
+            if (this.value !== oldValue) {
+              this.updateComplete.then(() => {
+                this.emit("ev-input");
+                this.emit("ev-change");
+              });
+            }
+            if (this.open) {
+              this.hide();
+              this.displayInput.focus({ preventScroll: true });
+            }
+            return;
+          }
+          if (this.allowCustomValues && this.displayInput.value.trim() && this.open) {
+            const customValue = this.displayInput.value.trim();
+            const oldValue = this.lastOptionValue;
+            this.value = customValue;
+            this.displayLabel = customValue;
+            this.displayInput.value = customValue;
+            this.lastOptionValue = customValue;
+            this.setSelectedOption(void 0);
+            if (customValue !== oldValue) {
+              this.updateComplete.then(() => {
+                this.emit("ev-add-option", {
+                  detail: { value: customValue }
+                });
+                this.emit("ev-input");
+                this.emit("ev-change");
+              });
+            }
+            this.hide();
+            this.displayInput.focus({ preventScroll: true });
+            return;
+          }
+        }
+        if (!this.open && !hasModifier) {
+          setTimeout(() => {
+            if (!event.defaultPrevented) {
+              this.formControlController.submit();
+            }
+          });
+          return;
+        }
+        if (!this.open || (currentOption == null ? void 0 : currentOption.disabled)) {
+          return;
+        }
+        if (currentOption) {
+          const oldValue = this.lastOptionValue;
+          if ((_b = currentOption.classList) == null ? void 0 : _b.contains("combobox__custom-option")) {
+            const customValue = this.displayInput.value.trim();
+            this.value = customValue;
+            this.displayLabel = customValue;
+            this.displayInput.value = customValue;
+            this.lastOptionValue = customValue;
+            this.setSelectedOption(void 0);
+            if (customValue !== oldValue) {
+              this.updateComplete.then(() => {
+                this.emit("ev-add-option", {
+                  detail: { value: customValue }
+                });
+                this.emit("ev-input");
+                this.emit("ev-change");
+              });
+            }
+          } else {
+            this.setSelectedOption(currentOption);
+            if (this.value !== oldValue) {
+              this.updateComplete.then(() => {
+                this.emit("ev-input");
+                this.emit("ev-change");
+              });
+            }
+          }
+        }
+        this.hide();
+        this.displayInput.focus({ preventScroll: true });
+        return;
+      }
+      if (["ArrowUp", "ArrowDown"].includes(event.key)) {
+        event.preventDefault();
+        event.stopPropagation();
+        if (!this.open) {
+          this.show();
+        }
+        this.selectNextOption(event.key === "ArrowDown");
+      }
+      if (["Home", "End"].includes(event.key)) {
+        event.preventDefault();
+        event.stopPropagation();
+        if (event.key === "Home") {
+          this.displayInput.setSelectionRange(0, 0);
+        } else if (event.key === "End") {
+          this.displayInput.setSelectionRange(this.displayInput.value.length, this.displayInput.value.length);
+        }
+      }
+    };
+    this.handleDocumentMouseDown = (event) => {
+      const path = event.composedPath();
+      if (this && !path.includes(this)) {
+        this.hide();
+      }
+    };
+  }
+  get value() {
+    return this._value;
+  }
+  set value(val) {
+    if (val === void 0 || val === null) {
+      val = this.multiple ? [] : "";
+    }
+    if (this.multiple) {
+      val = Array.isArray(val) ? val : val === "" ? [] : val.split(" ");
+    } else {
+      val = Array.isArray(val) ? val.join(" ") : val;
+    }
+    if (this._value === val) {
+      return;
+    }
+    this.valueHasChanged = true;
+    this._value = val;
+  }
+  /** Gets the validity state object */
+  get validity() {
+    return this.valueInput.validity;
+  }
+  /** Gets the validation message */
+  get validationMessage() {
+    return this.valueInput.validationMessage;
+  }
+  connectedCallback() {
+    super.connectedCallback();
+    if (!this.valueHasChanged) {
+      const cachedValueHasChanged = this.valueHasChanged;
+      this.value = this.defaultValue;
+      this.valueHasChanged = cachedValueHasChanged;
+    }
+    this.open = false;
+  }
+  disconnectedCallback() {
+    super.disconnectedCallback();
+    this.removeOpenListeners();
+  }
+  attributeChangedCallback(name, oldVal, newVal) {
+    super.attributeChangedCallback(name, oldVal, newVal);
+    if (name === "value") {
+      const cachedValueHasChanged = this.valueHasChanged;
+      this.value = this.defaultValue;
+      this.valueHasChanged = cachedValueHasChanged;
+    }
+  }
+  firstUpdated() {
+    this.updateComplete.then(() => {
+      if (this.multiple) {
+        this.syncSelectedOptions();
+        return;
+      }
+      const matchingOption = this.getSlottedOptions().find((option) => {
+        const optionValue = option.value || (option.getTextLabel ? option.getTextLabel() : option.textContent || "");
+        return optionValue === this.value;
+      });
+      this.displayLabel = matchingOption ? matchingOption.getTextLabel ? matchingOption.getTextLabel() : matchingOption.textContent || this.value : this.value;
+    });
+    this.formControlController.updateValidity();
+  }
+  addOpenListeners() {
+    var _a;
+    document.addEventListener("focusin", this.handleDocumentFocusIn);
+    document.addEventListener("keydown", this.handleDocumentKeyDown);
+    document.addEventListener("mousedown", this.handleDocumentMouseDown);
+    if (this.getRootNode() !== document) {
+      this.getRootNode().addEventListener("focusin", this.handleDocumentFocusIn);
+    }
+    if ("CloseWatcher" in window) {
+      (_a = this.closeWatcher) == null ? void 0 : _a.destroy();
+      this.closeWatcher = new CloseWatcher();
+      this.closeWatcher.onclose = () => {
+        if (this.open) {
+          this.hide();
+          this.displayInput.focus({ preventScroll: true });
+        }
+      };
+    }
+  }
+  removeOpenListeners() {
+    var _a;
+    document.removeEventListener("focusin", this.handleDocumentFocusIn);
+    document.removeEventListener("keydown", this.handleDocumentKeyDown);
+    document.removeEventListener("mousedown", this.handleDocumentMouseDown);
+    if (this.getRootNode() !== document) {
+      this.getRootNode().removeEventListener("focusin", this.handleDocumentFocusIn);
+    }
+    (_a = this.closeWatcher) == null ? void 0 : _a.destroy();
+  }
+  handleFocus() {
+    this.hasFocus = true;
+    this.emit("ev-focus");
+  }
+  handleBlur() {
+    this.hasFocus = false;
+    this.emit("ev-blur");
+  }
+  handleComboboxMouseDown(event) {
+    if (this.disabled || this.readonly) {
+      return;
+    }
+    const path = event.composedPath();
+    const isTag = path.some(
+      (el) => {
+        var _a, _b;
+        return el instanceof Element && (((_a = el.tagName) == null ? void 0 : _a.toLowerCase()) === "lynk-tag" || ((_b = el.tagName) == null ? void 0 : _b.toLowerCase()) === "lynk-icon-button");
+      }
+    );
+    if (isTag) {
+      return;
+    }
+    const toggleListboxOpen = () => {
+      if (this.open) {
+        return this.hide();
+      } else {
+        if (this.multiple) {
+          this.createComboboxOptionsFromQuery(this.query);
+          return this.show();
+        }
+        const hasExactMatch = this.getSlottedOptions().some((option) => {
+          const optionValue = option.value || (option.getTextLabel ? option.getTextLabel() : option.textContent || "");
+          return optionValue === this.value;
+        });
+        const queryString = hasExactMatch ? "" : this.value;
+        this.createComboboxOptionsFromQuery(queryString);
+        return this.show();
+      }
+    };
+    event.preventDefault();
+    toggleListboxOpen().then(() => {
+      setTimeout(() => this.displayInput.focus({ preventScroll: true }));
+    });
+  }
+  handleComboboxKeyDown(event) {
+    if (event.key === "Tab") {
+      return;
+    }
+    this.handleDocumentKeyDown(event);
+  }
+  handleClearClick(event) {
+    event.stopPropagation();
+    this.clearCombobox();
+  }
+  clearCombobox() {
+    if (this.multiple) {
+      const hasValue = Array.isArray(this.value) && this.value.length > 0;
+      if (!hasValue && this.query === "") {
+        return;
+      }
+      this.value = [];
+      this.query = "";
+      this.displayInput.value = "";
+      this.lastOptionValue = "";
+      this.selectedOptions = [];
+      this.createComboboxOptionsFromQuery("");
+      this.displayInput.focus({ preventScroll: true });
+      this.updateComplete.then(() => {
+        this.formControlController.updateValidity();
+        this.emit("ev-clear");
+        this.emit("ev-input");
+        this.emit("ev-change");
+      });
+      return;
+    }
+    if (this.value !== "") {
+      this.value = "";
+      this.displayInput.value = "";
+      this.lastOptionValue = "";
+      this.setSelectedOption(void 0);
+      this.displayInput.focus({ preventScroll: true });
+      this.updateComplete.then(() => {
+        this.emit("ev-clear");
+        this.emit("ev-input");
+        this.emit("ev-change");
+      });
+    }
+  }
+  preventLoosingFocus(event) {
+    event.stopPropagation();
+    event.preventDefault();
+  }
+  handleOptionClick(event) {
+    const target = event.target;
+    const option = target.closest("lynk-option");
+    const customOption = target.closest(".combobox__custom-option");
+    const oldValue = this.lastOptionValue;
+    if (this.multiple) {
+      if (customOption) {
+        this.addCustomOptionValue(this.displayInput.value.trim());
+        this.updateComplete.then(() => this.displayInput.focus({ preventScroll: true }));
+        return;
+      }
+      if (option && !option.disabled) {
+        this.toggleOptionSelection(option);
+        this.updateComplete.then(() => this.displayInput.focus({ preventScroll: true }));
+      }
+      return;
+    }
+    if (customOption) {
+      const customValue = this.displayInput.value.trim();
+      this.value = customValue;
+      this.displayLabel = customValue;
+      this.displayInput.value = customValue;
+      this.lastOptionValue = customValue;
+      this.setSelectedOption(void 0);
+      this.updateComplete.then(() => {
+        this.emit("ev-add-option", {
+          detail: { value: customValue }
+        });
+        this.emit("ev-input");
+        this.emit("ev-change");
+      });
+      this.hide();
+      this.displayInput.focus({ preventScroll: true });
+      return;
+    }
+    if (option && !option.disabled) {
+      this.setSelectedOption(option);
+      this.updateComplete.then(() => this.displayInput.focus({ preventScroll: true }));
+      if (this.value !== oldValue) {
+        this.updateComplete.then(() => {
+          this.emit("ev-input");
+          this.emit("ev-change");
+        });
+      }
+      this.hide();
+      this.displayInput.focus({ preventScroll: true });
+    }
+  }
+  /**
+   * Selects the following or previous option.
+   *
+   * @param isNext - A boolean indicating whether to select the following option (true)
+   *                 or the previous option (false).
+   */
+  selectNextOption(isNext) {
+    const filteredOptions = this.getAllFilteredOptions();
+    if (filteredOptions.length === 0) {
+      return;
+    }
+    const currentOption = this.getCurrentOption();
+    const currentIndex = filteredOptions.indexOf(currentOption);
+    let newIndex = Math.max(0, currentIndex);
+    if (isNext) {
+      const nextIndex = currentIndex + 1;
+      newIndex = nextIndex > filteredOptions.length - 1 ? 0 : nextIndex;
+    } else {
+      const previousIndex = currentIndex - 1;
+      newIndex = previousIndex < 0 ? filteredOptions.length - 1 : previousIndex;
+    }
+    this.setCurrentOption(filteredOptions[newIndex]);
+    const selectedOption = this.getCurrentOption();
+    if (selectedOption && typeof selectedOption.getBoundingClientRect === "function") {
+      scrollIntoView(selectedOption, this.listbox, "vertical", "auto");
+    }
+  }
+  getAllFilteredOptions() {
+    const filteredOptions = this.getSlottedOptions().filter((option) => !option.hidden);
+    if (this.showCustomOption) {
+      const customOptionElement = this.renderRoot.querySelector(".combobox__custom-option");
+      if (customOptionElement) {
+        filteredOptions.push(customOptionElement);
+      }
+    }
+    return filteredOptions;
+  }
+  getCurrentOption() {
+    const customOptionElement = this.renderRoot.querySelector(".combobox__custom-option--current");
+    if (customOptionElement) {
+      return customOptionElement;
+    }
+    return this.getAllFilteredOptions().find((option) => option.current);
+  }
+  // Sets the current option, which is the option the user is currently interacting with
+  // (e.g. via keyboard). Only one option may be "current" at a time.
+  setCurrentOption(option) {
+    var _a;
+    const allOptions = this.getAllFilteredOptions();
+    const customOptionElement = this.renderRoot.querySelector(".combobox__custom-option");
+    this.displayInput.removeAttribute("aria-activedescendant");
+    if (customOptionElement) {
+      customOptionElement.classList.remove("combobox__custom-option--current");
+    }
+    allOptions.forEach((el) => {
+      var _a2;
+      if ((_a2 = el.classList) == null ? void 0 : _a2.contains("combobox__custom-option")) {
+        el.classList.remove("combobox__custom-option--current");
+      } else if ("current" in el) {
+        el.current = false;
+        el.setAttribute("aria-selected", "false");
+      }
+    });
+    if (option) {
+      if ((_a = option.classList) == null ? void 0 : _a.contains("combobox__custom-option")) {
+        option.classList.add("combobox__custom-option--current");
+        this.displayInput.setAttribute("aria-activedescendant", "custom-option");
+      } else if ("current" in option) {
+        option.current = true;
+        option.setAttribute("aria-selected", "true");
+        this.displayInput.setAttribute("aria-activedescendant", option.id);
+      }
+    }
+  }
+  /**
+   * Updates the selected options cache, the current value, and the display value
+   */
+  setSelectedOption(option) {
+    var _a, _b;
+    this.selectedOption = option;
+    const optionValue = ((_a = this.selectedOption) == null ? void 0 : _a.value) || ((_b = this.selectedOption) == null ? void 0 : _b.getTextLabel());
+    if (option) {
+      this.lastOptionValue = optionValue || "";
+    }
+    this.value = optionValue != null ? optionValue : this.displayInput.value;
+    this.updateComplete.then(() => {
+      var _a2, _b2;
+      this.displayLabel = (_b2 = (_a2 = this.selectedOption) == null ? void 0 : _a2.getTextLabel()) != null ? _b2 : this.displayInput.value;
+      this.formControlController.updateValidity();
+    });
+  }
+  /**
+   * Toggles an option's selection state when `multiple` is enabled. When `force` is provided the option's
+   * selection is set explicitly, otherwise it is flipped. Clears the current filter query so all options are
+   * shown again after a selection change.
+   */
+  toggleOptionSelection(option, force) {
+    const optionValue = option.value || option.getTextLabel();
+    const current = Array.isArray(this.value) ? [...this.value] : [];
+    const index = current.indexOf(optionValue);
+    const shouldSelect = force === void 0 ? index === -1 : force;
+    if (shouldSelect && index === -1) {
+      current.push(optionValue);
+    } else if (!shouldSelect && index !== -1) {
+      current.splice(index, 1);
+    } else {
+      return;
+    }
+    this.query = "";
+    if (this.displayInput) {
+      this.displayInput.value = "";
+    }
+    this.value = current;
+    this.updateComplete.then(() => {
+      this.emit("ev-input");
+      this.emit("ev-change");
+      this.formControlController.updateValidity();
+    });
+  }
+  /** Adds a custom (non-listed) value to the current selection when `multiple` and `allowCustomValues` are enabled. */
+  addCustomOptionValue(customValue) {
+    if (!customValue) {
+      return;
+    }
+    const current = Array.isArray(this.value) ? [...this.value] : [];
+    if (current.includes(customValue)) {
+      return;
+    }
+    current.push(customValue);
+    this.query = "";
+    if (this.displayInput) {
+      this.displayInput.value = "";
+    }
+    this.value = current;
+    this.showCustomOption = false;
+    this.updateComplete.then(() => {
+      this.emit("ev-add-option", { detail: { value: customValue } });
+      this.emit("ev-input");
+      this.emit("ev-change");
+      this.formControlController.updateValidity();
+    });
+  }
+  /**
+   * Rebuilds the `selectedOptions` cache (used to render tags) from the current value array. Values that do not
+   * match a slotted option (e.g. custom values) get a lightweight option so their tag can still be displayed.
+   */
+  syncSelectedOptions() {
+    if (!this.multiple) {
+      return;
+    }
+    const values = Array.isArray(this.value) ? this.value : [];
+    const allOptions = [...this.cachedOptions, ...this.getSlottedOptions()];
+    this.selectedOptions = values.map((val) => {
+      const match = allOptions.find((option) => (option.value || option.getTextLabel()) === val);
+      if (match) {
+        return match;
+      }
+      const customOption = document.createElement("lynk-option");
+      customOption.value = val;
+      customOption.textContent = val;
+      return customOption;
+    });
+  }
+  handleTagRemove(event, option) {
+    event.stopPropagation();
+    if (this.disabled) {
+      return;
+    }
+    this.toggleOptionSelection(option, false);
+  }
+  /** Renders the tags shown for each selected option when `multiple` is enabled. */
+  get tags() {
+    return this.selectedOptions.map((option, index) => {
+      if (index < this.maxOptionsVisible || this.maxOptionsVisible <= 0) {
+        const tag = this.getTag(option, index);
+        return html`<div @ev-remove=${(e) => this.handleTagRemove(e, option)}>
+          ${typeof tag === "string" ? unsafeHTML(tag) : tag}
+        </div>`;
+      } else if (index === this.maxOptionsVisible) {
+        return html`<lynk-tag size=${this.size}>+${this.selectedOptions.length - index}</lynk-tag>`;
+      }
+      return html``;
+    });
+  }
+  handleInvalid(event) {
+    this.formControlController.setValidity(false);
+    this.formControlController.emitInvalidEvent(event);
+  }
+  handlePropertiesChange() {
+    this.createComboboxOptionsFromQuery(this.multiple ? this.query : this.value);
+  }
+  handleDisabledChange() {
+    this.formControlController.setValidity(this.disabled);
+    if (this.disabled) {
+      this.open = false;
+      this.handleOpenChange();
+    }
+  }
+  handleValueChange() {
+    if (!this.valueHasChanged) {
+      const cachedValueHasChanged = this.valueHasChanged;
+      this.value = this.defaultValue;
+      this.valueHasChanged = cachedValueHasChanged;
+    }
+    if (this.multiple) {
+      this.syncSelectedOptions();
+      this.createComboboxOptionsFromQuery(this.query);
+      this.setCurrentOption(null);
+      return;
+    }
+    const matchingOption = this.getSlottedOptions().find((option) => {
+      const optionValue = option.value || (option.getTextLabel ? option.getTextLabel() : option.textContent || "");
+      return optionValue === this.value;
+    });
+    this.displayLabel = matchingOption ? matchingOption.getTextLabel ? matchingOption.getTextLabel() : matchingOption.textContent || this.value : this.value;
+    this.createComboboxOptionsFromQuery(this.value);
+    this.setCurrentOption(null);
+  }
+  async handleOpenChange() {
+    if (this.open && !this.disabled && !this.readonly) {
+      if (this.numberFilteredOptions === 0) {
+        this.open = false;
+        this.emit("ev-error");
+        return;
+      }
+      this.emit("ev-show");
+      this.addOpenListeners();
+      await stopAnimations(this);
+      this.listbox.hidden = false;
+      this.popup.active = true;
+      const { keyframes: keyframes2, options: options2 } = getAnimation(this, "combobox.show", { dir: this.localize.dir() });
+      await animateTo(this.popup.popup, keyframes2, options2);
+      this.emit("ev-after-show");
+      return;
+    }
+    this.setCurrentOption(null);
+    this.displayInput.removeAttribute("aria-activedescendant");
+    this.emit("ev-hide");
+    this.removeOpenListeners();
+    await stopAnimations(this);
+    const { keyframes, options } = getAnimation(this, "combobox.hide", { dir: this.localize.dir() });
+    await animateTo(this.popup.popup, keyframes, options);
+    this.listbox.hidden = true;
+    this.popup.active = false;
+    this.emit("ev-after-hide");
+  }
+  /**
+   * Shows the listbox. If it is not possible to open the listbox, because there are no
+   * appropriate filtered options, a ev-error is emitted and the listbox stays closed.
+   */
+  async show() {
+    if (this.open || this.disabled || this.readonly) {
+      this.open = false;
+      return void 0;
+    }
+    this.open = true;
+    return await Promise.race([waitForEvent(this, "ev-after-show"), waitForEvent(this, "ev-error")]);
+  }
+  /** Hides the listbox. */
+  async hide() {
+    if (!this.open || this.disabled) {
+      this.open = false;
+      return void 0;
+    }
+    this.open = false;
+    return await waitForEvent(this, "ev-after-hide");
+  }
+  /**
+   * Checks for validity but does not show a validation message.
+   * Returns `true` when valid and `false` when invalid.
+   */
+  checkValidity() {
+    return this.valueInput.checkValidity();
+  }
+  /** Gets the associated form, if one exists. */
+  getForm() {
+    return this.formControlController.getForm();
+  }
+  /** Checks for validity and shows the browser's validation message if the control is invalid. */
+  reportValidity() {
+    return this.valueInput.reportValidity();
+  }
+  /** Sets a custom validation message. Pass an empty string to restore validity. */
+  setCustomValidity(message) {
+    this.valueInput.setCustomValidity(message);
+    this.formControlController.updateValidity();
+  }
+  /** Sets focus on the control. */
+  focus(options) {
+    this.displayInput.focus(options);
+  }
+  /** Removes focus from the control. */
+  blur() {
+    this.displayInput.blur();
+  }
+  createComboboxOptionsFromQuery(queryString) {
+    var _a;
+    this.numberFilteredOptions = 0;
+    this.isOptionRendererTriggered = true;
+    if (this.cachedOptions.length === 0) {
+      this.cacheSlottedOptionsAndOptgroups();
+    }
+    this.getSlottedOptions().forEach((option) => {
+      const cachedOption = this.cachedOptions.find((o) => o.id === option.id) || option;
+      const optionResult = this.getOption(cachedOption, queryString);
+      let updatedOption = createOptionFromDifferentTypes(optionResult);
+      if (!updatedOption) {
+        updatedOption = cachedOption;
+      }
+      const hideOption = !(this.filter(updatedOption, queryString) || queryString === "");
+      updatedOption.hidden = hideOption;
+      if ("selected" in updatedOption) {
+        const optionValue = updatedOption.value || updatedOption.getTextLabel();
+        if (this.multiple) {
+          updatedOption.selected = Array.isArray(this.value) && this.value.includes(optionValue);
+        } else {
+          const isMatched = optionValue === this.value;
+          updatedOption.selected = isMatched;
+          if ("current" in updatedOption) {
+            updatedOption.current = isMatched;
+          }
+        }
+      }
+      option.replaceWith(updatedOption);
+      if (!hideOption) {
+        this.numberFilteredOptions += 1;
+      }
+    });
+    this.showCustomOption = false;
+    if (this.allowCustomValues && queryString.trim() && this.numberFilteredOptions === 0) {
+      this.showCustomOption = true;
+      this.numberFilteredOptions = 1;
+    }
+    const visibleOptgroups = this.getSlottedOptGroups().filter((optgroup) => {
+      const options = getAllOptions(Array.from(optgroup.children)).flat();
+      const isVisible = options.some((option) => !option.hidden);
+      optgroup.hidden = !isVisible;
+      return isVisible;
+    });
+    (_a = visibleOptgroups[0]) == null ? void 0 : _a.style.setProperty("--display-divider", "none");
+    setTimeout(() => {
+      this.isOptionRendererTriggered = false;
+    }, 0);
+  }
+  async handleInput() {
+    const inputValue = this.displayInput.value;
+    if (this.multiple) {
+      this.query = inputValue;
+      this.createComboboxOptionsFromQuery(this.query);
+      await this.updateComplete;
+      this.open = this.numberFilteredOptions > 0;
+      this.emit("ev-input");
+      return;
+    }
+    this.value = inputValue;
+    await this.updateComplete;
+    this.open = this.numberFilteredOptions > 0;
+    this.setSelectedOption(void 0);
+    this.formControlController.updateValidity();
+    this.emit("ev-input");
+  }
+  handleChange() {
+    if (this.multiple) {
+      return;
+    }
+    if (!this.selectedOption) {
+      this.value = this.displayInput.value;
+      this.updateComplete.then(() => {
+        this.formControlController.updateValidity();
+      });
+      this.emit("ev-change");
+    }
+  }
+  getSlottedOptions() {
+    return getAllOptions(getAssignedElementsForSlot(this.defaultSlot)).flat();
+  }
+  getSlottedOptGroups() {
+    return filterOnlyOptgroups(getAssignedElementsForSlot(this.defaultSlot));
+  }
+  cacheSlottedOptionsAndOptgroups() {
+    const slottedOptions = this.getSlottedOptions();
+    const slottedOptgroups = this.getSlottedOptGroups();
+    slottedOptions.forEach((option, index) => {
+      option.id = option.id || `lynk-combobox-option-${index}`;
+    });
+    slottedOptgroups.forEach((optgroup, index) => {
+      optgroup.id = optgroup.id || `lynk-combobox-optgroup-${index}`;
+    });
+    this.cachedOptions = [...slottedOptions];
+  }
+  /* @internal - used by options to update labels */
+  handleDefaultSlotChange() {
+    if (!this.isOptionRendererTriggered) {
+      if (!customElements.get("lynk-option")) {
+        customElements.whenDefined("lynk-option").then(() => this.handleDefaultSlotChange());
+        return;
+      }
+      this.cacheSlottedOptionsAndOptgroups();
+      if (this.multiple) {
+        this.syncSelectedOptions();
+        this.createComboboxOptionsFromQuery(this.query);
+        return;
+      }
+      if (this.value) {
+        const matchingOption = this.getSlottedOptions().find((option) => {
+          const optionValue = option.value || (option.getTextLabel ? option.getTextLabel() : option.textContent || "");
+          return optionValue === this.value;
+        });
+        if (matchingOption) {
+          this.displayLabel = matchingOption.getTextLabel ? matchingOption.getTextLabel() : matchingOption.textContent || this.value;
+        }
+      }
+      this.createComboboxOptionsFromQuery(this.value);
+      if (this.hasFocus && this.value.length > 0 && !this.open) {
+        this.show();
+      }
+    }
+  }
+  render() {
+    var _a;
+    const hasSelection = this.multiple ? Array.isArray(this.value) && this.value.length > 0 : ((_a = this.value) == null ? void 0 : _a.length) > 0;
+    const hasClearIcon = this.clearable && !this.disabled && !this.readonly && (hasSelection || this.multiple && this.query.length > 0);
+    const isPlaceholderVisible = !!this.placeholder && !hasSelection && (!this.multiple || this.query.length === 0);
+    return html`
+      <lynk-form-field
+        .size=${this.size}
+        .state=${this.state}
+        .label=${this.hasSlotController.test("label") ? "" : this.label}
+        .helpText=${this.hasSlotController.test("help-text") ? "" : this.helpText}
+        .helpTip=${this.hasSlotController.test("help-tip") ? "" : this.helpTip}
+        .labelEnd=${this.hasSlotController.test("label-end") ? "" : this.labelEnd}
+        .helpTextEnd=${this.hasSlotController.test("help-text-end") ? "" : this.helpTextEnd}
+        .required=${this.required}
+        .optional=${this.optional}
+        .readonly=${this.readonly}
+        .dirty=${this.dirty}
+        .focused=${this.hasFocus}
+        .inline=${this.inline}
+        ?data-user-invalid=${this.hasAttribute("data-user-invalid")}
+        ?data-user-valid=${this.hasAttribute("data-user-valid")}
+        ?data-invalid=${this.hasAttribute("data-invalid")}
+        ?data-valid=${this.hasAttribute("data-valid")}
+      >
+        ${this.hasSlotController.test("label") ? html`<slot name="label" slot="label"></slot>` : ""}
+        ${this.hasSlotController.test("help-text") ? html`<slot name="help-text" slot="help-text"></slot>` : ""}
+        ${this.hasSlotController.test("help-tip") ? html`<slot name="help-tip" slot="help-tip"></slot>` : ""}
+        ${this.hasSlotController.test("label-end") ? html`<slot name="label-end" slot="label-end"></slot>` : ""}
+        ${this.hasSlotController.test("help-text-end") ? html`<slot name="help-text-end" slot="help-text-end"></slot>` : ""}
+        <lynk-popup
+          class=${classMap({
+      combobox: true,
+      "combobox--bottom": this.placement === "bottom",
+      "combobox--disabled": this.disabled,
+      "combobox--readonly": this.readonly,
+      "combobox--focused": this.hasFocus,
+      "combobox--large": this.size === "large",
+      "combobox--medium": this.size === "medium",
+      "combobox--multiple": this.multiple,
+      "combobox--open": this.open,
+      "combobox--placeholder-visible": isPlaceholderVisible,
+      "combobox--small": this.size === "small",
+      "combobox--standard": true,
+      "combobox--top": this.placement === "top"
+    })}
+          placement=${this.placement}
+          strategy=${this.hoist ? "fixed" : "absolute"}
+          flip
+          shift
+          sync="width"
+          auto-size="vertical"
+          auto-size-padding="10"
+        >
+          <div
+            part="combobox"
+            class="combobox__inputs"
+            slot="anchor"
+            @keydown=${this.handleComboboxKeyDown}
+            @mousedown=${this.handleComboboxMouseDown}
+          >
+            <slot part="prefix" name="prefix" class="combobox__prefix"></slot>
+
+            ${this.multiple && this.selectedOptions.length > 0 ? html`<div part="tags" class="combobox__tags">${this.tags}</div>` : ""}
+
+            <input
+              part="display-input"
+              class="combobox__display-input"
+              type="text"
+              placeholder=${isPlaceholderVisible ? this.placeholder : ""}
+              .disabled=${this.disabled}
+              .value=${this.multiple ? this.query : this.displayLabel}
+              ?readonly=${this.readonly}
+              autocomplete="off"
+              spellcheck="false"
+              autocapitalize="off"
+              aria-controls="listbox"
+              aria-expanded=${this.open ? "true" : "false"}
+              aria-haspopup="listbox"
+              aria-label=${this.label || "Combobox"}
+              aria-disabled=${this.disabled ? "true" : "false"}
+              aria-readonly=${this.readonly ? "true" : "false"}
+              role="combobox"
+              tabindex="0"
+              @focus=${this.handleFocus}
+              @blur=${this.handleBlur}
+              aria-autocomplete="list"
+              aria-owns="listbox"
+              @input=${this.handleInput}
+              @change=${this.handleChange}
+            />
+
+            <input
+              class="combobox__value-input"
+              type="text"
+              ?disabled=${this.disabled}
+              ?required=${this.required}
+              .value=${Array.isArray(this.value) ? this.value.join(", ") : this.value}
+              tabindex="-1"
+              aria-hidden="true"
+              @focus=${() => this.focus()}
+              @invalid=${this.handleInvalid}
+            />
+
+            ${hasClearIcon ? html`
+                    <button
+                      part="clear-button"
+                      class="combobox__clear"
+                      type="button"
+                      aria-label=${this.localize.term("clearEntry")}
+                      @mousedown=${this.preventLoosingFocus}
+                      @click=${this.handleClearClick}
+                      tabindex="-1"
+                    >
+                      <slot name="clear-icon">
+                        <lynk-icon name="x-circle-fill" library="system"></lynk-icon>
+                      </slot>
+                    </button>
+                  ` : ""}
+
+            <slot name="suffix" part="suffix" class="combobox__suffix"></slot>
+
+            <slot name="expand-icon" part="expand-icon" class="combobox__expand-icon">
+              <lynk-icon library="system" name="chevron-down"></lynk-icon>
+            </slot>
+          </div>
+
+          <div
+            id="listbox"
+            role="listbox"
+            aria-expanded=${this.open ? "true" : "false"}
+            aria-multiselectable=${this.multiple ? "true" : "false"}
+            aria-label=${this.label || "Combobox options"}
+            part="listbox"
+            class="combobox__listbox"
+            tabindex="-1"
+            @mousedown=${this.preventLoosingFocus}
+            @mouseup=${this.handleOptionClick}
+          >
+            <div class="combobox__listbox-options" part="filtered-listbox">
+              <slot @slotchange=${this.handleDefaultSlotChange}></slot>
+              ${this.showCustomOption ? html`
+                      <div id="custom-option" class="combobox__custom-option" role="option" tabindex="-1">
+                        + Add "${this.displayInput.value.trim()}"
+                      </div>
+                    ` : ""}
+            </div>
+          </div>
+        </lynk-popup>
+        <slot name="action"></slot>
+      </lynk-form-field>
+    `;
+  }
+};
+LynkCombobox.styles = [component_styles_default, combobox_styles_default, combobox_custom_styles_default];
+LynkCombobox.dependencies = {
+  "lynk-form-field": LynkFormField,
+  "lynk-icon": LynkIcon,
+  "lynk-popup": LynkPopup,
+  "lynk-tag": LynkTag
+};
+__decorateClass([
+  query(".combobox")
+], LynkCombobox.prototype, "popup", 2);
+__decorateClass([
+  query(".combobox__inputs")
+], LynkCombobox.prototype, "combobox", 2);
+__decorateClass([
+  query(".combobox__display-input")
+], LynkCombobox.prototype, "displayInput", 2);
+__decorateClass([
+  query(".combobox__value-input")
+], LynkCombobox.prototype, "valueInput", 2);
+__decorateClass([
+  query(".combobox__listbox")
+], LynkCombobox.prototype, "listbox", 2);
+__decorateClass([
+  query("slot:not([name])")
+], LynkCombobox.prototype, "defaultSlot", 2);
+__decorateClass([
+  state()
+], LynkCombobox.prototype, "hasFocus", 2);
+__decorateClass([
+  state()
+], LynkCombobox.prototype, "displayLabel", 2);
+__decorateClass([
+  state()
+], LynkCombobox.prototype, "selectedOption", 2);
+__decorateClass([
+  state()
+], LynkCombobox.prototype, "selectedOptions", 2);
+__decorateClass([
+  state()
+], LynkCombobox.prototype, "numberFilteredOptions", 2);
+__decorateClass([
+  state()
+], LynkCombobox.prototype, "cachedOptions", 2);
+__decorateClass([
+  state()
+], LynkCombobox.prototype, "showCustomOption", 2);
+__decorateClass([
+  state()
+], LynkCombobox.prototype, "query", 2);
+__decorateClass([
+  state()
+], LynkCombobox.prototype, "valueHasChanged", 2);
+__decorateClass([
+  property()
+], LynkCombobox.prototype, "name", 2);
+__decorateClass([
+  state()
+], LynkCombobox.prototype, "value", 1);
+__decorateClass([
+  property({ attribute: "value" })
+], LynkCombobox.prototype, "defaultValue", 2);
+__decorateClass([
+  property({ reflect: true })
+], LynkCombobox.prototype, "state", 2);
+__decorateClass([
+  property({ reflect: true })
+], LynkCombobox.prototype, "size", 2);
+__decorateClass([
+  property()
+], LynkCombobox.prototype, "placeholder", 2);
+__decorateClass([
+  property({ reflect: true, type: Boolean })
+], LynkCombobox.prototype, "disabled", 2);
+__decorateClass([
+  property({ type: Boolean, reflect: true })
+], LynkCombobox.prototype, "readonly", 2);
+__decorateClass([
+  property({ type: Boolean, reflect: true })
+], LynkCombobox.prototype, "required", 2);
+__decorateClass([
+  property({ type: Boolean, reflect: true })
+], LynkCombobox.prototype, "optional", 2);
+__decorateClass([
+  property({ type: Boolean, reflect: true })
+], LynkCombobox.prototype, "dirty", 2);
+__decorateClass([
+  property({ type: Boolean })
+], LynkCombobox.prototype, "clearable", 2);
+__decorateClass([
+  property({ reflect: true, type: Boolean })
+], LynkCombobox.prototype, "open", 2);
+__decorateClass([
+  property({ type: Boolean })
+], LynkCombobox.prototype, "hoist", 2);
+__decorateClass([
+  property()
+], LynkCombobox.prototype, "label", 2);
+__decorateClass([
+  property({ reflect: true })
+], LynkCombobox.prototype, "placement", 2);
+__decorateClass([
+  property({ attribute: "help-tip" })
+], LynkCombobox.prototype, "helpTip", 2);
+__decorateClass([
+  property({ attribute: "help-text" })
+], LynkCombobox.prototype, "helpText", 2);
+__decorateClass([
+  property({ attribute: "label-end" })
+], LynkCombobox.prototype, "labelEnd", 2);
+__decorateClass([
+  property({ attribute: "help-text-end" })
+], LynkCombobox.prototype, "helpTextEnd", 2);
+__decorateClass([
+  property({ reflect: true })
+], LynkCombobox.prototype, "form", 2);
+__decorateClass([
+  property({ type: Boolean, reflect: true })
+], LynkCombobox.prototype, "inline", 2);
+__decorateClass([
+  property({ type: Boolean, attribute: "allow-custom-values" })
+], LynkCombobox.prototype, "allowCustomValues", 2);
+__decorateClass([
+  property({ type: Boolean, reflect: true })
+], LynkCombobox.prototype, "multiple", 2);
+__decorateClass([
+  property({ attribute: "max-options-visible", type: Number })
+], LynkCombobox.prototype, "maxOptionsVisible", 2);
+__decorateClass([
+  property()
+], LynkCombobox.prototype, "getTag", 2);
+__decorateClass([
+  property()
+], LynkCombobox.prototype, "getOption", 2);
+__decorateClass([
+  property()
+], LynkCombobox.prototype, "filter", 2);
+__decorateClass([
+  watch(["filter", "getOption"], { waitUntilFirstUpdate: true })
+], LynkCombobox.prototype, "handlePropertiesChange", 1);
+__decorateClass([
+  watch("disabled", { waitUntilFirstUpdate: true })
+], LynkCombobox.prototype, "handleDisabledChange", 1);
+__decorateClass([
+  watch(["defaultValue", "value"], { waitUntilFirstUpdate: true })
+], LynkCombobox.prototype, "handleValueChange", 1);
+__decorateClass([
+  watch("open", { waitUntilFirstUpdate: true })
+], LynkCombobox.prototype, "handleOpenChange", 1);
+setDefaultAnimation("combobox.show", {
+  keyframes: [
+    { opacity: 0, scale: 0.9 },
+    { opacity: 1, scale: 1 }
+  ],
+  options: { duration: 100, easing: "ease" }
+});
+setDefaultAnimation("combobox.hide", {
+  keyframes: [
+    { opacity: 1, scale: 1 },
+    { opacity: 0, scale: 0.9 }
+  ],
+  options: { duration: 100, easing: "ease" }
+});
+
+export {
+  LynkCombobox
+};