@watermarkinsights/ripple 3.16.0 → 3.17.0-2

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

@@ -1,545 +1,545 @@
-import { h, Component, Prop, Element, Listen, Watch, Host, State } from "@stencil/core";
-import { getIconCodeFromName } from "../../global/interfaces";
-import { generateId, adjustTooltipPlacement, toBool } from "../../global/functions";
-export class Button {
-  constructor() {
-    // icon and tooltip have reflect set to true. Without reflect, the react wrappers don't expose the attribute
-    // and the component throws errors when they are required (when buttonType is icononly or navigational)
-    this.disabled = false;
-    this.buttonType = null;
-    this.buttonStyle = null; // DEPRECATED in favor of button-type
-    this.tooltipPosition = "bottom-right";
-    this.permanentlyDelete = false;
-    this.textWrap = true;
-    this.tooltipVisible = false; // this is not part of the documented API but we need to expose as prop in order to change it from the focus method defined in WillLoad()
-    this.isTabbing = false;
-    this.btnPos = { old: {}, new: {} }; // for tooltip position. old and new are DOMRect
-    this.id = generateId();
-    this.ariaPopup = 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",
-      "selectoronly",
-      "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", "selectoronly"].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);
-    // replacing the prototype's focus event by our own
-    // to delegate focus to the appropriate el in the shadow root
-    // we could replace by ShadowRoot.delegatesFocus()
-    // when there's enough support for it
-    // @ts-ignore
-    this.el.focus = function () {
-      if (!this.disabled) {
-        this.shadowRoot.querySelector("button").focus();
-        // prevent tooltip from showing on programmatic focus
-        requestAnimationFrame(() => {
-          this.tooltipVisible = false;
-        });
-      }
-    };
-    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
-      this.tooltipEl.textContent = this.isTruncated ? this.el.textContent : this.tooltip;
-      // 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 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": "string | null",
-        "resolved": "null | string",
-        "references": {}
-      },
-      "required": false,
-      "optional": false,
-      "docs": {
-        "tags": [],
-        "text": ""
-      },
-      "attribute": "button-type",
-      "reflect": false,
-      "defaultValue": "null"
-    },
-    "buttonStyle": {
-      "type": "string",
-      "mutable": true,
-      "complexType": {
-        "original": "string | null",
-        "resolved": "null | string",
-        "references": {}
-      },
-      "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, Component, Prop, Element, Listen, Watch, Host, State } from "@stencil/core";
+import { getIconCodeFromName } from "../../global/interfaces";
+import { generateId, adjustTooltipPlacement, toBool } from "../../global/functions";
+export class Button {
+  constructor() {
+    // icon and tooltip have reflect set to true. Without reflect, the react wrappers don't expose the attribute
+    // and the component throws errors when they are required (when buttonType is icononly or navigational)
+    this.disabled = false;
+    this.buttonType = null;
+    this.buttonStyle = null; // DEPRECATED in favor of button-type
+    this.tooltipPosition = "bottom-right";
+    this.permanentlyDelete = false;
+    this.textWrap = true;
+    this.tooltipVisible = false; // this is not part of the documented API but we need to expose as prop in order to change it from the focus method defined in WillLoad()
+    this.isTabbing = false;
+    this.btnPos = { old: {}, new: {} }; // for tooltip position. old and new are DOMRect
+    this.id = generateId();
+    this.ariaPopup = 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",
+      "selectoronly",
+      "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", "selectoronly"].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);
+    // replacing the prototype's focus event by our own
+    // to delegate focus to the appropriate el in the shadow root
+    // we could replace by ShadowRoot.delegatesFocus()
+    // when there's enough support for it
+    // @ts-ignore
+    this.el.focus = function () {
+      if (!this.disabled) {
+        this.shadowRoot.querySelector("button").focus();
+        // prevent tooltip from showing on programmatic focus
+        requestAnimationFrame(() => {
+          this.tooltipVisible = false;
+        });
+      }
+    };
+    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
+      this.tooltipEl.textContent = this.isTruncated ? this.el.textContent : this.tooltip;
+      // 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 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": "string | null",
+        "resolved": "null | string",
+        "references": {}
+      },
+      "required": false,
+      "optional": false,
+      "docs": {
+        "tags": [],
+        "text": ""
+      },
+      "attribute": "button-type",
+      "reflect": false,
+      "defaultValue": "null"
+    },
+    "buttonStyle": {
+      "type": "string",
+      "mutable": true,
+      "complexType": {
+        "original": "string | null",
+        "resolved": "null | string",
+        "references": {}
+      },
+      "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
+    }]; }
+}