@watermarkinsights/ripple 5.16.0-alpha.2 → 5.16.0-alpha.5

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

@@ -0,0 +1,555 @@
+import { h, Host } from "@stencil/core";
+import { getIconCodeFromName } from "../../global/interfaces";
+import { generateId, hideTooltip, handleDisabledAttribute, showTooltip, toBool, triggerFormSubmit, } from "../../global/functions";
+export class Button {
+    constructor() {
+        this.id = generateId();
+        this.ariaPopup = false;
+        this.disabled = false;
+        this.buttonType = "secondary";
+        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.isSubmit = 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 isTruncated() {
+        return !!this.buttonEl && this.buttonType === "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 ["icononly", "navigational", "icononly-ai", "navigational-ai"].includes(this.buttonType) || this.isTruncated;
+    }
+    get buttonClasses() {
+        let classes = "wm-button";
+        classes += this.permanentlyDelete ? " -permanentlydelete" : "";
+        // Handle AI variants by adding both base and ai classes
+        if (this.buttonType.endsWith("-ai")) {
+            const baseType = this.buttonType.replace("-ai", "");
+            classes += ` -${baseType} ai`;
+        }
+        else {
+            classes += this.buttonType ? ` -${this.buttonType}` : " -secondary";
+        }
+        classes += this.textWrap ? "" : " nowrap";
+        classes += this.isTabbing ? " user-is-tabbing" : "";
+        classes += this.isTruncated ? " -truncated" : "";
+        classes += this.customBackground === "dark" ? " dark" : "";
+        return classes;
+    }
+    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() {
+        hideTooltip();
+    }
+    validateType(newValue) {
+        const valid = [
+            "primary",
+            "secondary",
+            "textonly",
+            "icononly",
+            "navigational",
+            "selector",
+            "selector-primary",
+            "pairpositive",
+            "pairnegative",
+            "primary-ai",
+            "secondary-ai",
+            "textonly-ai",
+            "icononly-ai",
+            "navigational-ai",
+        ].includes(newValue);
+        if (!valid) {
+            this.buttonType = "secondary";
+        }
+        this.validateIcon();
+    }
+    updateIcon() {
+        this.icon = getIconCodeFromName(this.icon);
+    }
+    handleDisabledChange() {
+        handleDisabledAttribute(this.el, this.isDisabled);
+    }
+    validateIcon() {
+        switch (this.buttonType) {
+            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;
+        }
+    }
+    handleMouseEnter(ev) {
+        if (this.hasTooltip) {
+            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;
+            }
+            showTooltip(this.tooltipPosition, ev.target, tooltipText);
+        }
+    }
+    handleFocus(ev) {
+        if (this.hasTooltip && this.isTabbing) {
+            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;
+            }
+            showTooltip(this.tooltipPosition, ev.target, tooltipText);
+        }
+    }
+    /**
+     * Register CSS custom properties for AI gradient animations
+     * These need to be registered in JS since @property doesn't work in shadow DOM
+     */
+    registerCSSProperties() {
+        if (typeof CSS !== "undefined" && "registerProperty" in CSS) {
+            try {
+                CSS.registerProperty({
+                    name: "--ai-gradient-start",
+                    syntax: "<color>",
+                    inherits: false,
+                    initialValue: "#2779C8"
+                });
+                CSS.registerProperty({
+                    name: "--ai-gradient-end",
+                    syntax: "<color>",
+                    inherits: false,
+                    initialValue: "#6259C4"
+                });
+                CSS.registerProperty({
+                    name: "--secondary-button-fill",
+                    syntax: "<color>",
+                    inherits: false,
+                    initialValue: "#FFFFFF"
+                });
+                CSS.registerProperty({
+                    name: "--wmbutton-percent-1",
+                    syntax: "<percentage>",
+                    inherits: false,
+                    initialValue: "0%"
+                });
+                CSS.registerProperty({
+                    name: "--wmbutton-percent-2",
+                    syntax: "<percentage>",
+                    inherits: false,
+                    initialValue: "70.19%"
+                });
+                CSS.registerProperty({
+                    name: "--wmbutton-percent-3",
+                    syntax: "<percentage>",
+                    inherits: false,
+                    initialValue: "-50%"
+                });
+            }
+            catch (e) {
+                // Properties might already be registered, or CSS.registerProperty might not be supported
+                // This is fine, the animations will still work but might be less smooth
+            }
+        }
+    }
+    componentWillLoad() {
+        this.registerCSSProperties();
+        if (this.buttonType.endsWith("-ai")) {
+            this.icon = "#ai-sparkles";
+        }
+        this.validateType(this.buttonType);
+        if (this.icon) {
+            this.icon = getIconCodeFromName(this.icon);
+        }
+        handleDisabledAttribute(this.el, this.isDisabled);
+    }
+    componentDidLoad() {
+        if (document.body.classList.contains("wmcl-user-is-tabbing")) {
+            this.toggleTabbingOn();
+        }
+        this.isSubmit && this.el.addEventListener("click", () => triggerFormSubmit(this.el.closest("form")));
+        this.ariaPopup = !!this.el.getAttribute("aria-haspopup");
+    }
+    getAriaLabel() {
+        if (this.buttonType === "icononly" ||
+            this.buttonType === "navigational" ||
+            this.buttonType === "icononly-ai" ||
+            this.buttonType === "navigational-ai") {
+            return this.labelForIdenticalButtons || this.tooltip;
+        }
+        if (this.labelForIdenticalButtons) {
+            return this.labelForIdenticalButtons;
+        }
+    }
+    renderIcon() {
+        this.iconSize && this.el.style.setProperty("--icon-size", this.iconSize);
+        let transformStyle = "";
+        transformStyle += this.iconRotate ? `rotate(${this.iconRotate}deg)` : "";
+        transformStyle += this.iconFlip === "horizontal" ? `scaleX(-1)` : "";
+        transformStyle += this.iconFlip === "vertical" ? `scaleY(-1)` : "";
+        const iconStyles = Object.assign({}, ((this.iconRotate || this.iconFlip) && { transform: transformStyle }));
+        if (this.icon.match(/^#/)) {
+            // Icon ID
+            return h("span", { class: `svg-icon svg-${this.icon.slice(1)}`, style: iconStyles });
+        }
+        else if (this.icon.match(/^\/\S*[#]\S*/)) {
+            // starts with /, any number of non-whitespace characters, followed by #, followed by any non-whitespace characters
+            // Relative Path & Symbol
+            return (h("svg", { xmlns: "http://www.w3.org/2000/svg", class: "svg-icon", style: Object.assign(Object.assign({}, iconStyles), { "--icon-fill": "currentColor" }), fill: "currentColor" }, h("use", { href: this.icon })));
+        }
+        else {
+            // MDI
+            return (h("span", { class: "mdi", style: iconStyles, "aria-hidden": "true" }, String.fromCodePoint(parseInt(`0x${this.icon}`))));
+        }
+    }
+    render() {
+        return (h(Host, { key: 'ed44edc43c12cbbc088b6a2872e1e26d816c1cba', class: `${this.isDisabled ? "button-disabled" : ""} -${this.buttonType}` }, h("button", { key: '0b94c327dd29d98e981a72fe38b122cc06313aa1', 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: (ev) => this.handleMouseEnter(ev), onMouseLeave: () => hideTooltip(), onFocus: (ev) => this.handleFocus(ev), onBlur: () => hideTooltip(), onClick: () => hideTooltip() }, (this.icon || this.buttonType.endsWith("-ai")) && this.renderIcon(), (!this.buttonType.startsWith("navigational") && !this.buttonType.startsWith("icononly")) && (h("span", { key: 'c31ae6ac51a1aee66734f3501e49cf9cde1bfc7a', class: "button-text" }, h("slot", { key: 'd75aa45be52f340e755bd96ea029bd51fdd69150' }))), (this.buttonType == "selector" || this.buttonType == "selector-primary") && (h("div", { key: '8d510ff0af0bdbd882214d09b41a26d344591b55', class: "selector-icon svg-icon svg-expand-more" })))));
+    }
+    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",
+                    "resolved": "\"icononly\" | \"icononly-ai\" | \"navigational\" | \"navigational-ai\" | \"pairnegative\" | \"pairpositive\" | \"primary\" | \"primary-ai\" | \"secondary\" | \"secondary-ai\" | \"selector\" | \"selector-primary\" | \"textonly\" | \"textonly-ai\"",
+                    "references": {
+                        "validButtonTypes": {
+                            "location": "import",
+                            "path": "../../global/interfaces",
+                            "id": "src/global/interfaces.ts::validButtonTypes"
+                        }
+                    }
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [],
+                    "text": ""
+                },
+                "attribute": "button-type",
+                "reflect": false,
+                "defaultValue": "\"secondary\""
+            },
+            "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",
+                            "id": "src/global/interfaces.ts::TooltipPlacement"
+                        }
+                    }
+                },
+                "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
+            },
+            "isSubmit": {
+                "type": "boolean",
+                "mutable": false,
+                "complexType": {
+                    "original": "boolean",
+                    "resolved": "boolean",
+                    "references": {}
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [],
+                    "text": ""
+                },
+                "attribute": "is-submit",
+                "reflect": false,
+                "defaultValue": "false"
+            }
+        };
+    }
+    static get states() {
+        return {
+            "isTabbing": {}
+        };
+    }
+    static get elementRef() { return "el"; }
+    static get watchers() {
+        return [{
+                "propName": "buttonType",
+                "methodName": "validateType"
+            }, {
+                "propName": "icon",
+                "methodName": "updateIcon"
+            }, {
+                "propName": "disabled",
+                "methodName": "handleDisabledChange"
+            }];
+    }
+    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
+            }];
+    }
+}