@watermarkinsights/ripple 3.26.0-9 → 3.26.0

package/dist/collection/components/wm-button/wm-button.js

@@ -1,575 +1,575 @@
-import { h, Host } from "@stencil/core";
-import { getIconCodeFromName } from "../../global/interfaces";
-import { generateId, adjustTooltipPlacement, toBool } from "../../global/functions";
-export class Button {
-  constructor() {
-    this.btnPos = { old: {}, new: {} }; // for tooltip position. old and new are DOMRect
-    this.id = generateId();
-    this.ariaPopup = false;
-    this.disabled = false;
-    this.buttonType = null;
-    this.buttonStyle = null;
-    this.icon = undefined;
-    this.iconSize = undefined;
-    this.iconRotate = undefined;
-    this.iconFlip = undefined;
-    this.tooltip = undefined;
-    this.labelForIdenticalButtons = undefined;
-    this.tooltipPosition = "bottom-right";
-    this.permanentlyDelete = false;
-    this.textWrap = true;
-    this.customBackground = undefined;
-    this.tooltipVisible = false;
-    this.isTabbing = false;
-  }
-  get isDisabled() {
-    // string "false" needs to be treated as bool False because react wrappers convert bool to string.
-    return toBool(this.disabled);
-  }
-  get tempButtonType() {
-    // uses of this getter should be replaced with this.buttonType when buttonStyle is fully phased out
-    // don't forget to reset this.buttonType's default value to secondary
-    return this.buttonType || this.buttonStyle || "secondary";
-  }
-  get isTruncated() {
-    return (!!this.buttonEl && this.tempButtonType === "textonly" && this.buttonEl.offsetWidth < this.buttonEl.scrollWidth);
-  }
-  get hasTooltip() {
-    // tooltip is only rendered for icononly and navigational types, or if the button text is truncated
-    return this.tempButtonType === "icononly" || this.tempButtonType === "navigational" || this.isTruncated;
-  }
-  get tooltipEl() {
-    return document.getElementById("wm-tooltip");
-  }
-  get buttonClasses() {
-    let classes = "wm-button";
-    classes += this.permanentlyDelete ? " -permanentlydelete" : "";
-    classes += this.tempButtonType ? " -" + this.tempButtonType : " -secondary";
-    classes += this.textWrap ? "" : " nowrap";
-    classes += this.isTabbing ? " user-is-tabbing" : "";
-    classes += this.isTruncated ? " -truncated" : "";
-    classes += this.customBackground === "dark" ? " dark" : "";
-    return classes;
-  }
-  get iconStyles() {
-    let transformStyle = "";
-    transformStyle += this.iconRotate ? `rotate(${this.iconRotate}deg)` : "";
-    transformStyle += this.iconFlip === "horizontal" ? `scaleX(-1)` : "";
-    transformStyle += this.iconFlip === "vertical" ? `scaleY(-1)` : "";
-    return Object.assign(Object.assign({}, (this.iconSize && { fontSize: this.iconSize })), ((this.iconRotate || this.iconFlip) && { transform: transformStyle }));
-  }
-  toggleTabbingOn() {
-    this.isTabbing = true;
-  }
-  toggleTabbingOff() {
-    this.isTabbing = false;
-  }
-  // we need to listen for scroll events during the capture phase because they do not bubble up
-  // there can be layouts where the main content has 100vh and overflows
-  // in these cases window will register no scroll events unless we catch on they way down
-  handleScroll() {
-    if (this.tooltipVisible) {
-      this.hideTooltip();
-    }
-  }
-  validateType(newValue) {
-    const valid = [
-      "primary",
-      "secondary",
-      "textonly",
-      "icononly",
-      "navigational",
-      "selector",
-      "selector-primary",
-      "pairpositive",
-      "pairnegative",
-    ].includes(newValue);
-    if (!valid) {
-      this.buttonType = "secondary";
-    }
-    this.validateIcon();
-  }
-  // remove entire watcher after buttonStyle has been fully removed
-  validateDeprecatedType(newValue) {
-    const valid = ["primary", "secondary", "textonly", "icononly", "navigational", "selector"].includes(newValue);
-    if (!valid) {
-      this.buttonStyle = "secondary";
-    }
-    this.validateIcon();
-  }
-  updateIcon() {
-    this.icon = getIconCodeFromName(this.icon);
-  }
-  validateIcon() {
-    switch (this.tempButtonType) {
-      case "icononly":
-      case "navigational":
-        // if the style is icononly or navigational...
-        // - an icon must be provided
-        if (!this.icon) {
-          console.error("wm-button should have a valid 'icon' property when button-type is set to 'icononly' or 'navigational'.");
-        }
-        // - if no tooltip text was passed and we couldn't generate one, throw an error
-        if (!this.tooltip) {
-          console.error("wm-button should have a valid 'tooltip' property when button-type is set to 'icononly' or 'navigational'.");
-        }
-        break;
-      case "pairpositive":
-        this.icon = "f12c";
-        break;
-      case "pairnegative":
-        this.icon = "f739";
-        break;
-    }
-  }
-  handleKeydown(ev) {
-    switch (ev.key) {
-      case "Enter":
-        ev.preventDefault();
-        if (!this.isDisabled) {
-          this.el.click();
-        }
-        break;
-    }
-  }
-  componentWillLoad() {
-    if (this.buttonStyle) {
-      console.warn("wm-button: button-style has been deprecated as of v3.1.0. Please use button-type instead.");
-    }
-    this.validateType(this.tempButtonType);
-    if (this.icon) {
-      this.icon = this.icon = getIconCodeFromName(this.icon);
-    }
-  }
-  componentDidLoad() {
-    if (document.body.classList.contains("wmcl-user-is-tabbing")) {
-      this.toggleTabbingOn();
-    }
-    this.ariaPopup = !!this.el.getAttribute("aria-haspopup");
-    this.btnPos.new = this.buttonEl.getBoundingClientRect();
-  }
-  showTooltip() {
-    if (this.hasTooltip) {
-      // set tooltip text
-      let tooltipText = "";
-      if (this.isTruncated && this.el.textContent) {
-        // when truncated, tooltip text is the button's content
-        tooltipText = this.el.textContent;
-      }
-      else if (this.tooltip) {
-        // otherwise it is the tooltip property if present
-        tooltipText = this.tooltip;
-      }
-      this.tooltipEl.textContent = tooltipText;
-      // tooltip only has a maxWidth if it contains whitespace and can break
-      const hasNoWhitespace = tooltipText.match(/^[^\s]+$/);
-      if (hasNoWhitespace) {
-        this.tooltipEl.classList.add("single-word");
-        this.tooltipEl.style.setProperty("--wmTooltipMaxWidth", "none");
-      }
-      else {
-        this.tooltipEl.classList.remove("single-word");
-        this.tooltipEl.style.removeProperty("--wmTooltipMaxWidth");
-      }
-      // adjust placement in case there is no space to place the tooltip where specified via prop
-      // calculation outside of the function to keep it pure
-      const adjustedTooltipPlacement = adjustTooltipPlacement(this.tooltipPosition, this.buttonEl, this.tooltipEl);
-      this.btnPos.old = {};
-      const tooltipRect = this.tooltipEl.getBoundingClientRect();
-      this.tooltipEl.style.transitionDelay = "500ms";
-      this.tooltipEl.style.opacity = "1";
-      // This slight delay fixes an issue for keyboard users:
-      // if they tab to a button out of screen bounds, the page scrolls
-      // and hideTooltip() would be triggered before the tooltip would show
-      setTimeout(() => {
-        this.tooltipVisible = true;
-        this.positionTooltip(adjustedTooltipPlacement, tooltipRect);
-      }, 50);
-    }
-  }
-  positionTooltip(tPos, tooltipRect) {
-    if (this.tooltipVisible) {
-      window.requestAnimationFrame(() => this.positionTooltip(tPos, tooltipRect));
-    }
-    this.btnPos.new = this.buttonEl.getBoundingClientRect();
-    if (this.btnPos.new.top != this.btnPos.old.top || this.btnPos.new.left != this.btnPos.old.left) {
-      // this is to figure out how to offset, given the size of the button and of the tooltip
-      // to get the center positions, calculate the difference between the button width and the tooltip width
-      const vDiff = (this.btnPos.new.height - tooltipRect.height) / 2;
-      const hDiff = (this.btnPos.new.width - tooltipRect.width) / 2;
-      // the naming convention defaults to center in the absence of a value
-      // Values "top" and "bottom" imply horizontal centering; Values "right" and "left" imply vertical centering
-      // therefore we first set to center first, then adjust accordingly
-      let vPos = this.btnPos.new.top + vDiff;
-      let hPos = this.btnPos.new.left + hDiff;
-      if (tPos.includes("top")) {
-        vPos = this.btnPos.new.top - tooltipRect.height - 8;
-      }
-      if (tPos.includes("bottom")) {
-        vPos = this.btnPos.new.bottom + 8;
-      }
-      if (tPos.includes("left")) {
-        hPos = this.btnPos.new.left - tooltipRect.width - 8;
-      }
-      if (tPos.includes("right")) {
-        hPos = this.btnPos.new.right + 8;
-      }
-      // after all positioning has been calculated, if tooltip is off-screen or closer than 24px it is readjusted
-      // this only occurs when the tooltip is overflowing to the left and is positioned top or bottom
-      // (button placed too far left, or screen size under 268px)
-      hPos = Math.max(hPos, 24);
-      this.tooltipEl.style.setProperty("--wmTooltipTop", vPos + "px");
-      this.tooltipEl.style.setProperty("--wmTooltipLeft", hPos + "px");
-      // this.tooltipEl.style.top = vPos + "px";
-      // this.tooltipEl.style.left = hPos + "px";
-      // this.tooltipEl.style.top = (vPos / 16).toString() + "rem";
-      // this.tooltipEl.style.left = (hPos / 16).toString() + "rem";
-      this.btnPos.old = this.btnPos.new;
-    }
-  }
-  hideTooltip() {
-    if (this.hasTooltip) {
-      this.tooltipEl.style.transitionDelay = "0s";
-      this.tooltipEl.style.opacity = "0";
-      this.tooltipVisible = false;
-    }
-  }
-  showTooltipForKeyboardUsers() {
-    if (this.isTabbing) {
-      this.showTooltip();
-    }
-  }
-  getAriaLabel() {
-    if (this.tempButtonType === "icononly" || this.tempButtonType === "navigational") {
-      return this.labelForIdenticalButtons || this.tooltip;
-    }
-    if (this.labelForIdenticalButtons) {
-      return this.labelForIdenticalButtons;
-    }
-  }
-  render() {
-    return (h(Host, { class: this.isDisabled ? "button-disabled" : "" }, h("button", { id: this.id, class: `${this.buttonClasses}`, disabled: this.isDisabled, ref: (el) => (this.buttonEl = el), "aria-label": this.getAriaLabel(), "aria-hasPopup": this.ariaPopup ? "menu" : null, onMouseEnter: () => this.showTooltip(), onMouseLeave: () => this.hideTooltip(), onFocus: () => this.showTooltipForKeyboardUsers(), onBlur: () => this.hideTooltip(), onClick: () => this.hideTooltip() }, this.icon && (h("span", { class: "mdi", style: this.iconStyles }, String.fromCodePoint(parseInt(`0x${this.icon}`)))), h("span", { class: "button-text" }, h("slot", null)))));
-  }
-  static get is() { return "wm-button"; }
-  static get encapsulation() { return "shadow"; }
-  static get delegatesFocus() { return true; }
-  static get originalStyleUrls() {
-    return {
-      "$": ["wm-button.scss"]
-    };
-  }
-  static get styleUrls() {
-    return {
-      "$": ["wm-button.css"]
-    };
-  }
-  static get properties() {
-    return {
-      "disabled": {
-        "type": "boolean",
-        "mutable": false,
-        "complexType": {
-          "original": "boolean",
-          "resolved": "boolean",
-          "references": {}
-        },
-        "required": false,
-        "optional": false,
-        "docs": {
-          "tags": [],
-          "text": ""
-        },
-        "attribute": "disabled",
-        "reflect": true,
-        "defaultValue": "false"
-      },
-      "buttonType": {
-        "type": "string",
-        "mutable": true,
-        "complexType": {
-          "original": "validButtonTypes | null",
-          "resolved": "\"icononly\" | \"navigational\" | \"pairnegative\" | \"pairpositive\" | \"primary\" | \"secondary\" | \"selector\" | \"selector-primary\" | \"textonly\" | null",
-          "references": {
-            "validButtonTypes": {
-              "location": "import",
-              "path": "../../global/interfaces"
-            }
-          }
-        },
-        "required": false,
-        "optional": false,
-        "docs": {
-          "tags": [],
-          "text": ""
-        },
-        "attribute": "button-type",
-        "reflect": false,
-        "defaultValue": "null"
-      },
-      "buttonStyle": {
-        "type": "string",
-        "mutable": true,
-        "complexType": {
-          "original": "validButtonTypes | null",
-          "resolved": "\"icononly\" | \"navigational\" | \"pairnegative\" | \"pairpositive\" | \"primary\" | \"secondary\" | \"selector\" | \"selector-primary\" | \"textonly\" | null",
-          "references": {
-            "validButtonTypes": {
-              "location": "import",
-              "path": "../../global/interfaces"
-            }
-          }
-        },
-        "required": false,
-        "optional": false,
-        "docs": {
-          "tags": [],
-          "text": ""
-        },
-        "attribute": "button-style",
-        "reflect": false,
-        "defaultValue": "null"
-      },
-      "icon": {
-        "type": "string",
-        "mutable": true,
-        "complexType": {
-          "original": "string",
-          "resolved": "string | undefined",
-          "references": {}
-        },
-        "required": false,
-        "optional": true,
-        "docs": {
-          "tags": [],
-          "text": ""
-        },
-        "attribute": "icon",
-        "reflect": true
-      },
-      "iconSize": {
-        "type": "string",
-        "mutable": false,
-        "complexType": {
-          "original": "string",
-          "resolved": "string | undefined",
-          "references": {}
-        },
-        "required": false,
-        "optional": true,
-        "docs": {
-          "tags": [],
-          "text": ""
-        },
-        "attribute": "icon-size",
-        "reflect": false
-      },
-      "iconRotate": {
-        "type": "number",
-        "mutable": false,
-        "complexType": {
-          "original": "number",
-          "resolved": "number | undefined",
-          "references": {}
-        },
-        "required": false,
-        "optional": true,
-        "docs": {
-          "tags": [],
-          "text": ""
-        },
-        "attribute": "icon-rotate",
-        "reflect": false
-      },
-      "iconFlip": {
-        "type": "string",
-        "mutable": false,
-        "complexType": {
-          "original": "\"horizontal\" | \"vertical\"",
-          "resolved": "\"horizontal\" | \"vertical\" | undefined",
-          "references": {}
-        },
-        "required": false,
-        "optional": true,
-        "docs": {
-          "tags": [],
-          "text": ""
-        },
-        "attribute": "icon-flip",
-        "reflect": false
-      },
-      "tooltip": {
-        "type": "string",
-        "mutable": true,
-        "complexType": {
-          "original": "string",
-          "resolved": "string | undefined",
-          "references": {}
-        },
-        "required": false,
-        "optional": true,
-        "docs": {
-          "tags": [],
-          "text": ""
-        },
-        "attribute": "tooltip",
-        "reflect": true
-      },
-      "labelForIdenticalButtons": {
-        "type": "string",
-        "mutable": false,
-        "complexType": {
-          "original": "string",
-          "resolved": "string | undefined",
-          "references": {}
-        },
-        "required": false,
-        "optional": true,
-        "docs": {
-          "tags": [],
-          "text": ""
-        },
-        "attribute": "label-for-identical-buttons",
-        "reflect": false
-      },
-      "tooltipPosition": {
-        "type": "string",
-        "mutable": false,
-        "complexType": {
-          "original": "TooltipPlacement",
-          "resolved": "\"bottom\" | \"bottom-left\" | \"bottom-right\" | \"left\" | \"right\" | \"top\" | \"top-left\" | \"top-right\"",
-          "references": {
-            "TooltipPlacement": {
-              "location": "import",
-              "path": "../../global/interfaces"
-            }
-          }
-        },
-        "required": false,
-        "optional": false,
-        "docs": {
-          "tags": [],
-          "text": ""
-        },
-        "attribute": "tooltip-position",
-        "reflect": false,
-        "defaultValue": "\"bottom-right\""
-      },
-      "permanentlyDelete": {
-        "type": "boolean",
-        "mutable": false,
-        "complexType": {
-          "original": "boolean",
-          "resolved": "boolean | undefined",
-          "references": {}
-        },
-        "required": false,
-        "optional": true,
-        "docs": {
-          "tags": [],
-          "text": ""
-        },
-        "attribute": "permanently-delete",
-        "reflect": false,
-        "defaultValue": "false"
-      },
-      "textWrap": {
-        "type": "boolean",
-        "mutable": false,
-        "complexType": {
-          "original": "boolean",
-          "resolved": "boolean",
-          "references": {}
-        },
-        "required": false,
-        "optional": false,
-        "docs": {
-          "tags": [],
-          "text": ""
-        },
-        "attribute": "text-wrap",
-        "reflect": false,
-        "defaultValue": "true"
-      },
-      "customBackground": {
-        "type": "string",
-        "mutable": false,
-        "complexType": {
-          "original": "string",
-          "resolved": "string | undefined",
-          "references": {}
-        },
-        "required": false,
-        "optional": true,
-        "docs": {
-          "tags": [],
-          "text": ""
-        },
-        "attribute": "custom-background",
-        "reflect": false
-      },
-      "tooltipVisible": {
-        "type": "boolean",
-        "mutable": true,
-        "complexType": {
-          "original": "boolean",
-          "resolved": "boolean",
-          "references": {}
-        },
-        "required": false,
-        "optional": false,
-        "docs": {
-          "tags": [],
-          "text": ""
-        },
-        "attribute": "tooltip-visible",
-        "reflect": false,
-        "defaultValue": "false"
-      }
-    };
-  }
-  static get states() {
-    return {
-      "isTabbing": {}
-    };
-  }
-  static get elementRef() { return "el"; }
-  static get watchers() {
-    return [{
-        "propName": "buttonType",
-        "methodName": "validateType"
-      }, {
-        "propName": "buttonStyle",
-        "methodName": "validateDeprecatedType"
-      }, {
-        "propName": "icon",
-        "methodName": "updateIcon"
-      }];
-  }
-  static get listeners() {
-    return [{
-        "name": "wmUserIsTabbing",
-        "method": "toggleTabbingOn",
-        "target": "window",
-        "capture": false,
-        "passive": false
-      }, {
-        "name": "wmUserIsNotTabbing",
-        "method": "toggleTabbingOff",
-        "target": "window",
-        "capture": false,
-        "passive": false
-      }, {
-        "name": "scroll",
-        "method": "handleScroll",
-        "target": "window",
-        "capture": true,
-        "passive": true
-      }, {
-        "name": "keydown",
-        "method": "handleKeydown",
-        "target": undefined,
-        "capture": false,
-        "passive": false
-      }];
-  }
-}
+import { h, Host } from "@stencil/core";
+import { getIconCodeFromName } from "../../global/interfaces";
+import { generateId, adjustTooltipPlacement, toBool } from "../../global/functions";
+export class Button {
+  constructor() {
+    this.btnPos = { old: {}, new: {} }; // for tooltip position. old and new are DOMRect
+    this.id = generateId();
+    this.ariaPopup = false;
+    this.disabled = false;
+    this.buttonType = null;
+    this.buttonStyle = null;
+    this.icon = undefined;
+    this.iconSize = undefined;
+    this.iconRotate = undefined;
+    this.iconFlip = undefined;
+    this.tooltip = undefined;
+    this.labelForIdenticalButtons = undefined;
+    this.tooltipPosition = "bottom-right";
+    this.permanentlyDelete = false;
+    this.textWrap = true;
+    this.customBackground = undefined;
+    this.tooltipVisible = false;
+    this.isTabbing = false;
+  }
+  get isDisabled() {
+    // string "false" needs to be treated as bool False because react wrappers convert bool to string.
+    return toBool(this.disabled);
+  }
+  get tempButtonType() {
+    // uses of this getter should be replaced with this.buttonType when buttonStyle is fully phased out
+    // don't forget to reset this.buttonType's default value to secondary
+    return this.buttonType || this.buttonStyle || "secondary";
+  }
+  get isTruncated() {
+    return (!!this.buttonEl && this.tempButtonType === "textonly" && this.buttonEl.offsetWidth < this.buttonEl.scrollWidth);
+  }
+  get hasTooltip() {
+    // tooltip is only rendered for icononly and navigational types, or if the button text is truncated
+    return this.tempButtonType === "icononly" || this.tempButtonType === "navigational" || this.isTruncated;
+  }
+  get tooltipEl() {
+    return document.getElementById("wm-tooltip");
+  }
+  get buttonClasses() {
+    let classes = "wm-button";
+    classes += this.permanentlyDelete ? " -permanentlydelete" : "";
+    classes += this.tempButtonType ? " -" + this.tempButtonType : " -secondary";
+    classes += this.textWrap ? "" : " nowrap";
+    classes += this.isTabbing ? " user-is-tabbing" : "";
+    classes += this.isTruncated ? " -truncated" : "";
+    classes += this.customBackground === "dark" ? " dark" : "";
+    return classes;
+  }
+  get iconStyles() {
+    let transformStyle = "";
+    transformStyle += this.iconRotate ? `rotate(${this.iconRotate}deg)` : "";
+    transformStyle += this.iconFlip === "horizontal" ? `scaleX(-1)` : "";
+    transformStyle += this.iconFlip === "vertical" ? `scaleY(-1)` : "";
+    return Object.assign(Object.assign({}, (this.iconSize && { fontSize: this.iconSize })), ((this.iconRotate || this.iconFlip) && { transform: transformStyle }));
+  }
+  toggleTabbingOn() {
+    this.isTabbing = true;
+  }
+  toggleTabbingOff() {
+    this.isTabbing = false;
+  }
+  // we need to listen for scroll events during the capture phase because they do not bubble up
+  // there can be layouts where the main content has 100vh and overflows
+  // in these cases window will register no scroll events unless we catch on they way down
+  handleScroll() {
+    if (this.tooltipVisible) {
+      this.hideTooltip();
+    }
+  }
+  validateType(newValue) {
+    const valid = [
+      "primary",
+      "secondary",
+      "textonly",
+      "icononly",
+      "navigational",
+      "selector",
+      "selector-primary",
+      "pairpositive",
+      "pairnegative",
+    ].includes(newValue);
+    if (!valid) {
+      this.buttonType = "secondary";
+    }
+    this.validateIcon();
+  }
+  // remove entire watcher after buttonStyle has been fully removed
+  validateDeprecatedType(newValue) {
+    const valid = ["primary", "secondary", "textonly", "icononly", "navigational", "selector"].includes(newValue);
+    if (!valid) {
+      this.buttonStyle = "secondary";
+    }
+    this.validateIcon();
+  }
+  updateIcon() {
+    this.icon = getIconCodeFromName(this.icon);
+  }
+  validateIcon() {
+    switch (this.tempButtonType) {
+      case "icononly":
+      case "navigational":
+        // if the style is icononly or navigational...
+        // - an icon must be provided
+        if (!this.icon) {
+          console.error("wm-button should have a valid 'icon' property when button-type is set to 'icononly' or 'navigational'.");
+        }
+        // - if no tooltip text was passed and we couldn't generate one, throw an error
+        if (!this.tooltip) {
+          console.error("wm-button should have a valid 'tooltip' property when button-type is set to 'icononly' or 'navigational'.");
+        }
+        break;
+      case "pairpositive":
+        this.icon = "f12c";
+        break;
+      case "pairnegative":
+        this.icon = "f739";
+        break;
+    }
+  }
+  handleKeydown(ev) {
+    switch (ev.key) {
+      case "Enter":
+        ev.preventDefault();
+        if (!this.isDisabled) {
+          this.el.click();
+        }
+        break;
+    }
+  }
+  componentWillLoad() {
+    if (this.buttonStyle) {
+      console.warn("wm-button: button-style has been deprecated as of v3.1.0. Please use button-type instead.");
+    }
+    this.validateType(this.tempButtonType);
+    if (this.icon) {
+      this.icon = this.icon = getIconCodeFromName(this.icon);
+    }
+  }
+  componentDidLoad() {
+    if (document.body.classList.contains("wmcl-user-is-tabbing")) {
+      this.toggleTabbingOn();
+    }
+    this.ariaPopup = !!this.el.getAttribute("aria-haspopup");
+    this.btnPos.new = this.buttonEl.getBoundingClientRect();
+  }
+  showTooltip() {
+    if (this.hasTooltip) {
+      // set tooltip text
+      let tooltipText = "";
+      if (this.isTruncated && this.el.textContent) {
+        // when truncated, tooltip text is the button's content
+        tooltipText = this.el.textContent;
+      }
+      else if (this.tooltip) {
+        // otherwise it is the tooltip property if present
+        tooltipText = this.tooltip;
+      }
+      this.tooltipEl.textContent = tooltipText;
+      // tooltip only has a maxWidth if it contains whitespace and can break
+      const hasNoWhitespace = tooltipText.match(/^[^\s]+$/);
+      if (hasNoWhitespace) {
+        this.tooltipEl.classList.add("single-word");
+        this.tooltipEl.style.setProperty("--wmTooltipMaxWidth", "none");
+      }
+      else {
+        this.tooltipEl.classList.remove("single-word");
+        this.tooltipEl.style.removeProperty("--wmTooltipMaxWidth");
+      }
+      // adjust placement in case there is no space to place the tooltip where specified via prop
+      // calculation outside of the function to keep it pure
+      const adjustedTooltipPlacement = adjustTooltipPlacement(this.tooltipPosition, this.buttonEl, this.tooltipEl);
+      this.btnPos.old = {};
+      const tooltipRect = this.tooltipEl.getBoundingClientRect();
+      this.tooltipEl.style.transitionDelay = "500ms";
+      this.tooltipEl.style.opacity = "1";
+      // This slight delay fixes an issue for keyboard users:
+      // if they tab to a button out of screen bounds, the page scrolls
+      // and hideTooltip() would be triggered before the tooltip would show
+      setTimeout(() => {
+        this.tooltipVisible = true;
+        this.positionTooltip(adjustedTooltipPlacement, tooltipRect);
+      }, 50);
+    }
+  }
+  positionTooltip(tPos, tooltipRect) {
+    if (this.tooltipVisible) {
+      window.requestAnimationFrame(() => this.positionTooltip(tPos, tooltipRect));
+    }
+    this.btnPos.new = this.buttonEl.getBoundingClientRect();
+    if (this.btnPos.new.top != this.btnPos.old.top || this.btnPos.new.left != this.btnPos.old.left) {
+      // this is to figure out how to offset, given the size of the button and of the tooltip
+      // to get the center positions, calculate the difference between the button width and the tooltip width
+      const vDiff = (this.btnPos.new.height - tooltipRect.height) / 2;
+      const hDiff = (this.btnPos.new.width - tooltipRect.width) / 2;
+      // the naming convention defaults to center in the absence of a value
+      // Values "top" and "bottom" imply horizontal centering; Values "right" and "left" imply vertical centering
+      // therefore we first set to center first, then adjust accordingly
+      let vPos = this.btnPos.new.top + vDiff;
+      let hPos = this.btnPos.new.left + hDiff;
+      if (tPos.includes("top")) {
+        vPos = this.btnPos.new.top - tooltipRect.height - 8;
+      }
+      if (tPos.includes("bottom")) {
+        vPos = this.btnPos.new.bottom + 8;
+      }
+      if (tPos.includes("left")) {
+        hPos = this.btnPos.new.left - tooltipRect.width - 8;
+      }
+      if (tPos.includes("right")) {
+        hPos = this.btnPos.new.right + 8;
+      }
+      // after all positioning has been calculated, if tooltip is off-screen or closer than 24px it is readjusted
+      // this only occurs when the tooltip is overflowing to the left and is positioned top or bottom
+      // (button placed too far left, or screen size under 268px)
+      hPos = Math.max(hPos, 24);
+      this.tooltipEl.style.setProperty("--wmTooltipTop", vPos + "px");
+      this.tooltipEl.style.setProperty("--wmTooltipLeft", hPos + "px");
+      // this.tooltipEl.style.top = vPos + "px";
+      // this.tooltipEl.style.left = hPos + "px";
+      // this.tooltipEl.style.top = (vPos / 16).toString() + "rem";
+      // this.tooltipEl.style.left = (hPos / 16).toString() + "rem";
+      this.btnPos.old = this.btnPos.new;
+    }
+  }
+  hideTooltip() {
+    if (this.hasTooltip) {
+      this.tooltipEl.style.transitionDelay = "0s";
+      this.tooltipEl.style.opacity = "0";
+      this.tooltipVisible = false;
+    }
+  }
+  showTooltipForKeyboardUsers() {
+    if (this.isTabbing) {
+      this.showTooltip();
+    }
+  }
+  getAriaLabel() {
+    if (this.tempButtonType === "icononly" || this.tempButtonType === "navigational") {
+      return this.labelForIdenticalButtons || this.tooltip;
+    }
+    if (this.labelForIdenticalButtons) {
+      return this.labelForIdenticalButtons;
+    }
+  }
+  render() {
+    return (h(Host, { class: this.isDisabled ? "button-disabled" : "" }, h("button", { id: this.id, class: `${this.buttonClasses}`, disabled: this.isDisabled, ref: (el) => (this.buttonEl = el), "aria-label": this.getAriaLabel(), "aria-hasPopup": this.ariaPopup ? "menu" : null, onMouseEnter: () => this.showTooltip(), onMouseLeave: () => this.hideTooltip(), onFocus: () => this.showTooltipForKeyboardUsers(), onBlur: () => this.hideTooltip(), onClick: () => this.hideTooltip() }, this.icon && (h("span", { class: "mdi", style: this.iconStyles }, String.fromCodePoint(parseInt(`0x${this.icon}`)))), h("span", { class: "button-text" }, h("slot", null)))));
+  }
+  static get is() { return "wm-button"; }
+  static get encapsulation() { return "shadow"; }
+  static get delegatesFocus() { return true; }
+  static get originalStyleUrls() {
+    return {
+      "$": ["wm-button.scss"]
+    };
+  }
+  static get styleUrls() {
+    return {
+      "$": ["wm-button.css"]
+    };
+  }
+  static get properties() {
+    return {
+      "disabled": {
+        "type": "boolean",
+        "mutable": false,
+        "complexType": {
+          "original": "boolean",
+          "resolved": "boolean",
+          "references": {}
+        },
+        "required": false,
+        "optional": false,
+        "docs": {
+          "tags": [],
+          "text": ""
+        },
+        "attribute": "disabled",
+        "reflect": true,
+        "defaultValue": "false"
+      },
+      "buttonType": {
+        "type": "string",
+        "mutable": true,
+        "complexType": {
+          "original": "validButtonTypes | null",
+          "resolved": "\"icononly\" | \"navigational\" | \"pairnegative\" | \"pairpositive\" | \"primary\" | \"secondary\" | \"selector\" | \"selector-primary\" | \"textonly\" | null",
+          "references": {
+            "validButtonTypes": {
+              "location": "import",
+              "path": "../../global/interfaces"
+            }
+          }
+        },
+        "required": false,
+        "optional": false,
+        "docs": {
+          "tags": [],
+          "text": ""
+        },
+        "attribute": "button-type",
+        "reflect": false,
+        "defaultValue": "null"
+      },
+      "buttonStyle": {
+        "type": "string",
+        "mutable": true,
+        "complexType": {
+          "original": "validButtonTypes | null",
+          "resolved": "\"icononly\" | \"navigational\" | \"pairnegative\" | \"pairpositive\" | \"primary\" | \"secondary\" | \"selector\" | \"selector-primary\" | \"textonly\" | null",
+          "references": {
+            "validButtonTypes": {
+              "location": "import",
+              "path": "../../global/interfaces"
+            }
+          }
+        },
+        "required": false,
+        "optional": false,
+        "docs": {
+          "tags": [],
+          "text": ""
+        },
+        "attribute": "button-style",
+        "reflect": false,
+        "defaultValue": "null"
+      },
+      "icon": {
+        "type": "string",
+        "mutable": true,
+        "complexType": {
+          "original": "string",
+          "resolved": "string | undefined",
+          "references": {}
+        },
+        "required": false,
+        "optional": true,
+        "docs": {
+          "tags": [],
+          "text": ""
+        },
+        "attribute": "icon",
+        "reflect": true
+      },
+      "iconSize": {
+        "type": "string",
+        "mutable": false,
+        "complexType": {
+          "original": "string",
+          "resolved": "string | undefined",
+          "references": {}
+        },
+        "required": false,
+        "optional": true,
+        "docs": {
+          "tags": [],
+          "text": ""
+        },
+        "attribute": "icon-size",
+        "reflect": false
+      },
+      "iconRotate": {
+        "type": "number",
+        "mutable": false,
+        "complexType": {
+          "original": "number",
+          "resolved": "number | undefined",
+          "references": {}
+        },
+        "required": false,
+        "optional": true,
+        "docs": {
+          "tags": [],
+          "text": ""
+        },
+        "attribute": "icon-rotate",
+        "reflect": false
+      },
+      "iconFlip": {
+        "type": "string",
+        "mutable": false,
+        "complexType": {
+          "original": "\"horizontal\" | \"vertical\"",
+          "resolved": "\"horizontal\" | \"vertical\" | undefined",
+          "references": {}
+        },
+        "required": false,
+        "optional": true,
+        "docs": {
+          "tags": [],
+          "text": ""
+        },
+        "attribute": "icon-flip",
+        "reflect": false
+      },
+      "tooltip": {
+        "type": "string",
+        "mutable": true,
+        "complexType": {
+          "original": "string",
+          "resolved": "string | undefined",
+          "references": {}
+        },
+        "required": false,
+        "optional": true,
+        "docs": {
+          "tags": [],
+          "text": ""
+        },
+        "attribute": "tooltip",
+        "reflect": true
+      },
+      "labelForIdenticalButtons": {
+        "type": "string",
+        "mutable": false,
+        "complexType": {
+          "original": "string",
+          "resolved": "string | undefined",
+          "references": {}
+        },
+        "required": false,
+        "optional": true,
+        "docs": {
+          "tags": [],
+          "text": ""
+        },
+        "attribute": "label-for-identical-buttons",
+        "reflect": false
+      },
+      "tooltipPosition": {
+        "type": "string",
+        "mutable": false,
+        "complexType": {
+          "original": "TooltipPlacement",
+          "resolved": "\"bottom\" | \"bottom-left\" | \"bottom-right\" | \"left\" | \"right\" | \"top\" | \"top-left\" | \"top-right\"",
+          "references": {
+            "TooltipPlacement": {
+              "location": "import",
+              "path": "../../global/interfaces"
+            }
+          }
+        },
+        "required": false,
+        "optional": false,
+        "docs": {
+          "tags": [],
+          "text": ""
+        },
+        "attribute": "tooltip-position",
+        "reflect": false,
+        "defaultValue": "\"bottom-right\""
+      },
+      "permanentlyDelete": {
+        "type": "boolean",
+        "mutable": false,
+        "complexType": {
+          "original": "boolean",
+          "resolved": "boolean | undefined",
+          "references": {}
+        },
+        "required": false,
+        "optional": true,
+        "docs": {
+          "tags": [],
+          "text": ""
+        },
+        "attribute": "permanently-delete",
+        "reflect": false,
+        "defaultValue": "false"
+      },
+      "textWrap": {
+        "type": "boolean",
+        "mutable": false,
+        "complexType": {
+          "original": "boolean",
+          "resolved": "boolean",
+          "references": {}
+        },
+        "required": false,
+        "optional": false,
+        "docs": {
+          "tags": [],
+          "text": ""
+        },
+        "attribute": "text-wrap",
+        "reflect": false,
+        "defaultValue": "true"
+      },
+      "customBackground": {
+        "type": "string",
+        "mutable": false,
+        "complexType": {
+          "original": "string",
+          "resolved": "string | undefined",
+          "references": {}
+        },
+        "required": false,
+        "optional": true,
+        "docs": {
+          "tags": [],
+          "text": ""
+        },
+        "attribute": "custom-background",
+        "reflect": false
+      },
+      "tooltipVisible": {
+        "type": "boolean",
+        "mutable": true,
+        "complexType": {
+          "original": "boolean",
+          "resolved": "boolean",
+          "references": {}
+        },
+        "required": false,
+        "optional": false,
+        "docs": {
+          "tags": [],
+          "text": ""
+        },
+        "attribute": "tooltip-visible",
+        "reflect": false,
+        "defaultValue": "false"
+      }
+    };
+  }
+  static get states() {
+    return {
+      "isTabbing": {}
+    };
+  }
+  static get elementRef() { return "el"; }
+  static get watchers() {
+    return [{
+        "propName": "buttonType",
+        "methodName": "validateType"
+      }, {
+        "propName": "buttonStyle",
+        "methodName": "validateDeprecatedType"
+      }, {
+        "propName": "icon",
+        "methodName": "updateIcon"
+      }];
+  }
+  static get listeners() {
+    return [{
+        "name": "wmUserIsTabbing",
+        "method": "toggleTabbingOn",
+        "target": "window",
+        "capture": false,
+        "passive": false
+      }, {
+        "name": "wmUserIsNotTabbing",
+        "method": "toggleTabbingOff",
+        "target": "window",
+        "capture": false,
+        "passive": false
+      }, {
+        "name": "scroll",
+        "method": "handleScroll",
+        "target": "window",
+        "capture": true,
+        "passive": true
+      }, {
+        "name": "keydown",
+        "method": "handleKeydown",
+        "target": undefined,
+        "capture": false,
+        "passive": false
+      }];
+  }
+}