npm - @watermarkinsights/ripple - Versions diffs - 5.3.0 → 5.3.1-0 - Mend

@watermarkinsights/ripple 5.3.0 → 5.3.1-0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (357) hide show

package/dist/collection/components/wm-action-menu/wm-action-menu.e2e.js ADDED Viewed

@@ -0,0 +1,200 @@
+import { newE2EPage } from "@stencil/core/testing";
+import { AxePuppeteer } from "@axe-core/puppeteer";
+describe("wm-action-menu", () => {
+    let page;
+    beforeEach(async () => {
+        page = await newE2EPage();
+        await page.setContent("<html lang='en'><head><title>Page</title></head><body><main><h1>Title</h1><wm-action-menu id='test' tooltip='menu name'><wm-menuitem id='first' onClick='action()'>First action</wm-menuitem><wm-menuitem id='second'>Second action</wm-menuitem><wm-menuitem id='third'>Third action</wm-menuitem></wm-action-menu><script>function action() {document.getElementById('first').innerHTML = 'Changed text'}</script></main></body></html>");
+    });
+    it("passes Axe checks", async () => {
+        const results = await new AxePuppeteer(page).analyze();
+        expect(results.violations.length).toBe(0);
+    });
+    //ATTRIBUTES;
+    it("has the right WAI_ARIA roles, states and properties", async () => {
+        const wmbtn = await page.find("wm-action-menu >>> wm-button");
+        const menu = await page.find("wm-action-menu >>> #menu-test");
+        const second = await page.find("#second");
+        const third = await page.find("#third");
+        await page.waitForChanges();
+        // check aria-expanded attribute
+        expect(wmbtn).toEqualAttribute("aria-expanded", "false");
+        // If the element with the aria-expanded attribute controls the expansion of another grouping container that is not 'owned by' the element, the author SHOULD reference the container by using the aria-controls attribute.
+        // src: https://www.w3.org/WAI/PF/aria/states_and_properties#aria-expanded
+        expect(wmbtn).toEqualAttribute("aria-controls", "menu-test");
+        // An element that contains or owns all the menu items has role menu.
+        expect(menu).toEqualAttribute("role", "menu");
+        expect(menu).toEqualAttribute("tabindex", "-1");
+        // Each menuitem in the menu has role menuitem.
+        expect(second).toEqualAttribute("role", "menuitem"); // just checking one randomly
+        expect(third).toEqualAttribute("tabindex", "-1");
+    });
+    // Down Arrow: Moves focus to the first menuitem. If the dropdown is collapsed, it also expands the list.
+    // Up Arrow: Moves focus to the last menuitem. If the dropdown is collapsed, it also expands the list.
+    it("handles Up and Down Arrow keys", async () => {
+        const wmbtn = await page.find("wm-action-menu >>> wm-button");
+        expect(wmbtn.getAttribute("aria-expanded")).toEqual("false");
+        await page.keyboard.press("Tab");
+        await page.waitForChanges();
+        await page.keyboard.press("ArrowDown");
+        await page.waitForChanges();
+        expect(wmbtn.getAttribute("aria-expanded")).toEqual("true");
+        const first = await page.find("wm-menuitem#first >>> div");
+        const second = await page.find("wm-menuitem#second >>> div");
+        expect(first).toHaveClass("focus");
+        await page.keyboard.press("ArrowDown");
+        await page.waitForChanges();
+        expect(second).toHaveClass("focus");
+        await page.keyboard.press("ArrowUp");
+        await page.waitForChanges();
+        expect(first).toHaveClass("focus");
+        await page.keyboard.press("Enter");
+        await page.waitForChanges();
+        await page.waitForTimeout(500); //allow closing animation and setTimeout to finish
+        expect(wmbtn.getAttribute("aria-expanded")).toEqual("false");
+        await page.keyboard.press("ArrowUp");
+        await page.waitForChanges();
+        // after the action runs the dropdown close and the dev should focus the relevant element.
+        // in case they don't, focus will return to the body. The component checks that and brings focus
+        // back to the button when that's the case.
+        // Things seem to happen differently with headless chrome / puppeteer. Focus stays on the menuitem even after
+        // it has become unable to have focus in normal browsers (after dropdown closes). Focus never gets to body.
+        // So here we simply test that the active el is not the body
+        const activeEl = await page.evaluate(() => document.activeElement.tagName);
+        expect(activeEl).not.toEqual("BODY");
+        expect(wmbtn.getAttribute("aria-expanded")).toEqual("true");
+        await page.keyboard.press("ArrowUp");
+        await page.waitForChanges();
+        expect(second).toHaveClass("focus");
+    });
+    // Home: If the dropdown is displayed, moves focus to first menuitem.
+    // End: If the dropdown is displayed, moves focus to last menuitem.
+    it("handles Home and End keys", async () => {
+        await page.keyboard.press("Tab");
+        await page.keyboard.press("Enter");
+        await page.waitForTimeout(40);
+        await page.keyboard.press("ArrowDown");
+        await page.keyboard.press("ArrowDown");
+        await page.waitForChanges();
+        const focusedEl = await page.find("wm-menuitem#third >>> div");
+        expect(focusedEl).toHaveClass("focus");
+        await page.keyboard.press("Home");
+        await page.waitForChanges();
+        const homefocusedEl = await page.find("wm-menuitem#first >>> div");
+        expect(focusedEl).not.toHaveClass("focus");
+        expect(homefocusedEl).toHaveClass("focus");
+        await page.keyboard.press("End");
+        await page.waitForChanges();
+        const endfocusedEl = await page.find("wm-menuitem#third >>> div");
+        expect(endfocusedEl).toHaveClass("focus");
+    });
+    // - Type a character: focus moves to the next menuitem with a name that starts with the typed character.
+    // - Type multiple characters in rapid succession: focus moves to the next menuitem with a name that starts with the string of characters typed
+    it("handles typing", async () => {
+        await page.keyboard.press("Tab");
+        await page.keyboard.press("Enter");
+        await page.waitForChanges();
+        await page.keyboard.press("t");
+        await page.waitForChanges();
+        const focusedEl = await page.find("wm-menuitem#third >>> div");
+        expect(focusedEl).toHaveClass("focus");
+    });
+    // OPEN / CLOSE
+    // Spacebar: Should open the popup (we didn't implement, comes for free. Test is to make sure we don't break it)
+    it("handles the Spacebar key", async () => {
+        await page.keyboard.press("Tab");
+        await page.keyboard.press("Space");
+        await page.waitForChanges();
+        const wmbtn = await page.find("wm-action-menu >>> wm-button");
+        expect(wmbtn.getAttribute("aria-expanded")).toEqual("true");
+    });
+    // Escape: If the menu is displayed, closes the popup and returns focus to the button.
+    it("handles the Escape key", async () => {
+        await page.keyboard.press("Tab");
+        await page.keyboard.press("Enter");
+        await page.waitForChanges();
+        const wmbtn = await page.find("wm-action-menu >>> wm-button");
+        expect(wmbtn.getAttribute("aria-expanded")).toEqual("true");
+        await page.keyboard.press("ArrowDown");
+        await page.keyboard.press("Escape");
+        await page.waitForChanges();
+        await page.waitForTimeout(500); //allow closing animation and setTimeout to finish
+        expect(wmbtn.getAttribute("aria-expanded")).toEqual("false");
+        const activeElId = await page.evaluate(() => document.activeElement.id);
+        expect(activeElId).toEqual("test");
+        //When dropdown reopens, focus returns to first element
+        await page.keyboard.press("Enter");
+        await page.waitForChanges();
+        expect(wmbtn.getAttribute("aria-expanded")).toEqual("true");
+        const focusedEl = await page.find("wm-menuitem#first >>> div");
+        expect(focusedEl).toHaveClass("focus"); //
+    });
+    // Enter:
+    // - If the focus is on the button, it expands the dropdown and places focuses on the first menuitem.
+    // - If the dropdown is open, it closes the dropdown.
+    it("opens and closes the dropdown when enter key is pressed", async () => {
+        await page.keyboard.press("Tab");
+        const wmbtn = await page.find("wm-action-menu >>> wm-button");
+        await page.keyboard.press("Enter");
+        await page.waitForChanges();
+        expect(wmbtn.getAttribute("aria-expanded")).toEqual("true");
+        await page.keyboard.press("Enter");
+        await page.waitForChanges();
+        expect(wmbtn.getAttribute("aria-expanded")).toEqual("false");
+    });
+    it("runs the onClick function passed to the menuitem when clicked or key pressed", async () => {
+        page = await newE2EPage();
+        await page.setContent(`<html lang='en'><head><title>Page</title></head><body><main><h1>Title</h1>
+      <wm-action-menu id='test' tooltip='menu name'>
+      <wm-menuitem id='first' onClick='action()'>First action</wm-menuitem>
+      </wm-action-menu>
+      <div id='changeMe'>default</div>
+      <script>
+      function action() {
+        document.getElementById('changeMe').textContent += "&"
+      }
+      </script></main></body></html>`);
+        const div = await page.find("#changeMe");
+        await page.keyboard.press("Tab");
+        await page.waitForChanges();
+        await page.keyboard.press("Enter");
+        await page.waitForChanges();
+        await page.keyboard.press("Enter");
+        await page.waitForChanges();
+        expect(div.textContent).toBe("default&");
+        await page.waitForTimeout(300); // make sure menu is closed before reopening (closes after the 250ms animation)
+        await page.keyboard.press("Enter");
+        await page.waitForChanges();
+        await page.click("#first");
+        await page.waitForChanges();
+        expect(div.textContent).toBe("default&&");
+    });
+    it("doesn't open the dropdown if the dropdown is disabled", async () => {
+        await page.evaluate(() => document.querySelector("wm-action-menu").setAttribute("disabled", "true"));
+        await page.keyboard.press("Tab");
+        await page.keyboard.press("Enter");
+        await page.waitForChanges();
+        const wmbtn = await page.find("wm-action-menu >>> wm-button");
+        await page.waitForChanges();
+        expect(wmbtn.getAttribute("aria-expanded")).toEqual("false");
+    });
+    // TOOLTIP
+    it("renders a tooltip when type is icon", async () => {
+        await page.keyboard.press("Tab");
+        await page.waitForChanges();
+        const tooltipEl = await page.find("#wm-tooltip");
+        expect(tooltipEl.textContent).toBe("menu name");
+    });
+    it("uses the label instead of tooltip text", async () => {
+        page = await newE2EPage();
+        await page.setContent("<wm-action-menu icon='f1c0' action-menu-type='icon' tooltip='delete' label-for-identical-buttons='delete this particular thing'><wm-menuitem>1</wm-menuitem></wm-action-menu>");
+        // use case: when the tooltip is something like "edit" and there are several buttons on a page, the aria label should be more specific than the tooltip
+        const wmbtn = await page.find("wm-action-menu >>> wm-button");
+        const btn = wmbtn.shadowRoot.querySelector("button");
+        await page.keyboard.press("Tab");
+        await page.waitForChanges();
+        const tooltipEl = await page.find("#wm-tooltip");
+        expect(tooltipEl.textContent).toEqual("delete");
+        expect(btn).toEqualAttribute("aria-label", "delete this particular thing");
+    });
+});

package/dist/collection/components/wm-action-menu/wm-action-menu.js CHANGED Viewed

@@ -190,7 +190,7 @@ export class ActionMenu {
         return null;
     }
     render() {
-        return (h(Host, { key: 'e6d63a25a3589c42657c7cf0825f9973861e92ae', onBlur: () => this.close(false) }, h("div", { key: '5744b207e0ebec31cb7a70b8c616700b9436d58b', class: getTextDir() }, h("wm-button", { key: '9509bafa8ac5acbb76aafc464d36e4b97b0a8d07', "button-type": this.internalButtonType, tooltip: this.tooltip, "custom-background": this.darkMode ? "dark" : undefined, "label-for-identical-buttons": this.labelForIdenticalButtons, icon: this.actionMenuType === "icon" ? "f1d9" : "", iconSize: this.actionMenuType === "icon" ? "24px" : undefined, id: "menubtn", onClick: () => (this.isExpanded ? this.close() : this.open()), onBlur: (ev) => this.handleButtonBlur(ev), disabled: this.disabled, ref: (el) => (this.wmButtonEl = el), "tooltip-position": this.tooltipPosition || this.horizontalPosition, "aria-haspopup": "true", "aria-expanded": this.isExpanded ? "true" : "false", "aria-controls": "menu" }, this.buttonText), h("div", { key: 'e7846dd17a5b343b506a8c60176bba8ef8e8c2e0', class: `dropdown ${this.openUp ? "open-up" : ""} ${this.horizontalPosition} ${this.isExpanded ? "open" : ""} hidden`, id: "menu", tabindex: -1, role: "menu", ref: (el) => (this.itemsEl = el) }, h("slot", { key: 'e227cd3ea8e2093e64c4b8c335ee098768139fd3' })))));
+        return (h(Host, { onBlur: () => this.close(false) }, h("div", { class: getTextDir() }, h("wm-button", { "button-type": this.internalButtonType, tooltip: this.tooltip, "custom-background": this.darkMode ? "dark" : undefined, "label-for-identical-buttons": this.labelForIdenticalButtons, icon: this.actionMenuType === "icon" ? "f1d9" : "", iconSize: this.actionMenuType === "icon" ? "24px" : undefined, id: "menubtn", onClick: () => (this.isExpanded ? this.close() : this.open()), onBlur: (ev) => this.handleButtonBlur(ev), disabled: this.disabled, ref: (el) => (this.wmButtonEl = el), "tooltip-position": this.tooltipPosition || this.horizontalPosition, "aria-haspopup": "true", "aria-expanded": this.isExpanded ? "true" : "false", "aria-controls": "menu" }, this.buttonText), h("div", { class: `dropdown ${this.openUp ? "open-up" : ""} ${this.horizontalPosition} ${this.isExpanded ? "open" : ""} hidden`, id: "menu", tabindex: -1, role: "menu", ref: (el) => (this.itemsEl = el) }, h("slot", null)))));
     }
     static get is() { return "wm-action-menu"; }
     static get encapsulation() { return "shadow"; }

package/dist/collection/components/wm-action-menu/wm-action-menu.spec.js ADDED Viewed

@@ -0,0 +1,48 @@
+import { newSpecPage } from "@stencil/core/testing";
+import { ActionMenu } from "./wm-action-menu";
+import { Menuitem } from "../wm-menuitem/wm-menuitem";
+import * as globalFuncs from "../../global/functions";
+jest.spyOn(globalFuncs, "getTextDir").mockImplementation(() => "rtl");
+jest.spyOn(globalFuncs, "generateId");
+// @ts-ignore
+globalFuncs.generateId.mockImplementation(() => "random-id");
+describe("wm-action-menu", () => {
+    it("builds", async () => {
+        const page = await newSpecPage({
+            components: [ActionMenu, Menuitem],
+            html: "<wm-action-menu action-menu-type='icon' tooltip='Menu Name'><wm-menuitem icon='f3eb' onClick='someFunction()'>Menuitem one</wm-menuitem></wm-action-menu>",
+        });
+        expect(page.root).toMatchSnapshot();
+    });
+    it("has the right props", () => {
+        const menu = new ActionMenu();
+        expect(menu).toHaveProperty("childItems");
+        expect(menu).toHaveProperty("keysSoFar");
+        expect(menu).toHaveProperty("searchIndex");
+        expect(menu).toHaveProperty("tooltipPosition");
+        expect(menu).toHaveProperty("actionMenuType");
+        expect(menu).toHaveProperty("buttonText");
+        expect(menu).toHaveProperty("tooltip");
+        expect(menu).toHaveProperty("labelForIdenticalButtons");
+    });
+    describe("error throwing", () => {
+        it("throws error when action-menu-type is text/selector but no button-text is passed", async () => {
+            const mockFunc = jest.fn();
+            console.error = mockFunc;
+            await newSpecPage({
+                components: [ActionMenu, Menuitem],
+                html: "<wm-action-menu action-menu-type='text'><wm-menuitem icon='f3eb' onClick='someFunction()'>Menuitem one</wm-menuitem></wm-action-menu>",
+            });
+            expect(mockFunc).toHaveBeenCalledWith("wm-action-menu should have a valid button-text property when action-menu-type is set to 'text' or 'selector'");
+        });
+        it("throws error when action-menu-type is icon but no tooltip is passed", async () => {
+            const mockFunc = jest.fn();
+            console.error = mockFunc;
+            await newSpecPage({
+                components: [ActionMenu, Menuitem],
+                html: "<wm-action-menu action-menu-type='icon'><wm-menuitem icon='f3eb' onClick='someFunction()'>Menuitem one</wm-menuitem></wm-action-menu>",
+            });
+            expect(mockFunc).toHaveBeenCalledWith("wm-action-menu should have a valid tooltip when action-menu-type is set to 'icon'");
+        });
+    });
+});

package/dist/collection/components/wm-button/wm-button.e2e.js ADDED Viewed

@@ -0,0 +1,55 @@
+import { newE2EPage } from "@stencil/core/testing";
+import { AxePuppeteer } from "@axe-core/puppeteer";
+describe("wm-button", () => {
+    let page;
+    beforeEach(async () => {
+        page = await newE2EPage();
+    });
+    it("passes Axe checks", async () => {
+        await page.setContent(`<html lang='en'><head><title>Page</title></head><body><main><h1>Title</h1>
+      <wm-button>Click me</wm-button>
+      </main></body></html>`);
+        const results = await new AxePuppeteer(page).analyze();
+        expect(results.violations.length).toBe(0);
+    });
+    it("renders a button", async () => {
+        await page.setContent("<wm-button></wm-button>");
+        const element = await page.find("wm-button >>> button");
+        expect(element).not.toBeNull();
+    });
+    it("delegates focus", async () => {
+        await page.setContent("<wm-button>click here</wm-button>");
+        const wmButton = await page.find("wm-button");
+        wmButton.focus();
+        let activeEl = await page.evaluate(async () => {
+            let el = await document.activeElement.shadowRoot.activeElement;
+            return el.nodeName;
+        });
+        expect(activeEl).toBe("BUTTON");
+    });
+    it("renders a tooltip for text-only buttons if text is truncated", async () => {
+        await page.setContent("<wm-button text-wrap='false' style='width: 100px' button-type='textonly'>Text-only button with a very long text and text-wrap set to false</wm-button>");
+        await page.waitForChanges();
+        await page.keyboard.press("Tab");
+        await page.waitForChanges();
+        const tooltip = await page.find("#wm-tooltip");
+        expect(tooltip.textContent).toEqual("Text-only button with a very long text and text-wrap set to false");
+    });
+    it("uses the label instead of tooltip text", async () => {
+        // use case: when the tooltip is something like "edit" and there are several buttons on a page, the aria label should be more specific than the tooltip
+        await page.setContent("<wm-button button-type='icononly' icon='f1c0' tooltip='delete' label-for-identical-buttons='Delete item 37' ></wm-button>");
+        await page.waitForChanges();
+        const btn = await page.find("wm-button >>> button");
+        expect(btn.getAttribute("aria-label")).toBe("Delete item 37");
+    });
+    it("renders the passed-in property button type property as a class", async () => {
+        await page.setContent("<wm-button></wm-button>");
+        const component = await page.find("wm-button");
+        const defaultButton = await page.find("wm-button >>> button");
+        expect(defaultButton).toHaveClass("-secondary");
+        component.setProperty("buttonType", "primary");
+        const primaryButton = await page.find("wm-button >>> button");
+        await page.waitForChanges();
+        expect(primaryButton).toHaveClass("-primary");
+    });
+});

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

@@ -166,7 +166,7 @@ export class Button {
         }
     }
     render() {
-        return (h(Host, { key: 'c0a05cbcd26354a8ec8ce24fc560ec676dc3eedc', class: `${this.isDisabled ? "button-disabled" : ""} -${this.buttonType}` }, h("button", { key: 'f3808a14ca42ea578fe257e7818c2b5be798b61e', 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 && (h("span", { key: '7c247a1febac517d8521a451692536f612657de9', class: "mdi", style: this.iconStyles, "aria-hidden": "true" }, String.fromCodePoint(parseInt(`0x${this.icon}`)))), h("span", { key: 'f4410ed7907af38ab29eb69c90e2bbb3b2e51cb8', class: "button-text" }, h("slot", { key: '2b72eba1f3b0db9ec8a73e37044a3f371264de77' })))));
+        return (h(Host, { class: `${this.isDisabled ? "button-disabled" : ""} -${this.buttonType}` }, 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: (ev) => this.handleMouseEnter(ev), onMouseLeave: () => hideTooltip(), onFocus: (ev) => this.handleFocus(ev), onBlur: () => hideTooltip(), onClick: () => hideTooltip() }, this.icon && (h("span", { class: "mdi", style: this.iconStyles, "aria-hidden": "true" }, 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"; }

package/dist/collection/components/wm-button/wm-button.spec.js ADDED Viewed

@@ -0,0 +1,74 @@
+import { newSpecPage } from "@stencil/core/testing";
+import * as globalFunctions from "../../global/functions";
+jest.spyOn(globalFunctions, "generateId").mockReturnValue("random-id");
+import { Button } from "./wm-button";
+describe("button", () => {
+    it("builds", async () => {
+        const page = await newSpecPage({
+            components: [Button],
+            html: "<wm-button></wm-button>",
+        });
+        expect(page.root).toMatchSnapshot();
+    });
+    it("has style and an icon type props with default values", async () => {
+        const page = await newSpecPage({
+            components: [Button],
+            html: "<wm-button></wm-button>",
+        });
+        const button = page.root;
+        const buttonEl = page.root.shadowRoot.querySelector("button");
+        expect(button).toHaveProperty("buttonType");
+        expect(button.buttonType).toEqual("secondary");
+        expect(buttonEl).toHaveClass("-secondary");
+        expect(button).toHaveProperty("icon");
+        expect(button.icon).toEqual(undefined);
+        expect(button).toHaveProperty("iconSize");
+        expect(button.iconSize).toBeUndefined;
+    });
+    it("has a method that validates the style property and resets an invalid property to a button type of secondary", async () => {
+        const page = await newSpecPage({
+            components: [Button],
+            html: "<wm-button></wm-button>",
+        });
+        const button = page.root;
+        expect(button).toHaveProperty("buttonType");
+        button.setAttribute("button-type", "foobar");
+        expect(button.buttonType).toEqual("secondary");
+    });
+    it("sets the aria label if the property labelForIdenticalButtons is passed", async () => {
+        const page = await newSpecPage({
+            components: [Button],
+            html: "<wm-button label-for-identical-buttons='read this instead of the text'>Button</wm-button>",
+        });
+        const button = page.root.shadowRoot.querySelector("button");
+        expect(button).toEqualAttribute("aria-label", "read this instead of the text");
+    });
+    // TOOLTIP
+    describe("error throwing", () => {
+        it("throws error when icononly or navigational button used without tooltip", async () => {
+            const mockFunc = jest.fn();
+            console.error = mockFunc;
+            await newSpecPage({
+                components: [Button],
+                html: "<wm-button icon='f1c0' button-type='icononly'></wm-button>",
+            });
+            expect(mockFunc).toHaveBeenCalledWith("wm-button should have a valid 'tooltip' property when button-type is set to 'icononly' or 'navigational'.");
+            const mockFunc2 = jest.fn();
+            console.error = mockFunc2;
+            await newSpecPage({
+                components: [Button],
+                html: "<wm-button icon='f1c0' button-type='navigational'></wm-button>",
+            });
+            expect(mockFunc2).toHaveBeenCalledWith("wm-button should have a valid 'tooltip' property when button-type is set to 'icononly' or 'navigational'.");
+        });
+        it("throws error when icononly button used without icon", async () => {
+            const mockFunc = jest.fn();
+            console.error = mockFunc;
+            await newSpecPage({
+                components: [Button],
+                html: "<wm-button button-type='icononly' tooltip='edit'></wm-button>",
+            });
+            expect(mockFunc).toHaveBeenCalledWith("wm-button should have a valid 'icon' property when button-type is set to 'icononly' or 'navigational'.");
+        });
+    });
+});

package/dist/collection/components/wm-file/wm-file.js CHANGED Viewed

@@ -168,7 +168,7 @@ export class File {
         return (h("div", { class: `file-wrapper ${this.progress === 100 ? "checked" : ""}` }, h("div", { class: `file ${this.errorMessage ? "--error" : ""}` }, this.renderFileName(), !this.errorMessage && (h("div", { class: `right-group ${this.isCondensed ? "condensed" : ""}` }, this.renderFileInfo(), this.fileActions !== "" && this.renderFileControls())), this.errorMessage && (h("wm-button", { "permanently-delete": true, "button-type": "textonly", "label-for-identical-buttons": this.generateClearButtonLabel(this.name), onClick: () => this.wmFileErrorCleared.emit() }, this.clearButtonText))), this.errorMessage && h("div", { class: "error-message" }, this.errorMessage)));
     }
     render() {
-        return h(Host, { key: '0943b20ae9ce90cb1687ff3c092622d2169f9c47', role: "listitem" }, this.isUploading ? this.renderFileInProgress() : this.renderFile());
+        return h(Host, { role: "listitem" }, this.isUploading ? this.renderFileInProgress() : this.renderFile());
     }
     static get is() { return "wm-file"; }
     static get encapsulation() { return "shadow"; }

package/dist/collection/components/wm-file/wm-file.spec.js ADDED Viewed

@@ -0,0 +1,194 @@
+import { newSpecPage } from "@stencil/core/testing";
+import { File } from "./wm-file";
+// mock ResizeObserver
+global.ResizeObserver = jest.fn().mockImplementation(() => ({
+    observe: jest.fn(),
+    unobserve: jest.fn(),
+    disconnect: jest.fn(),
+}));
+describe("wm-file", () => {
+    let html, page;
+    async function createPageHelper() {
+        return await newSpecPage({
+            components: [File],
+            html: `<wm-file
+      id="file1"
+      name="File retrieved from server"
+      type="pdf"
+      last-updated="10/30/97 3:46 PM"
+      size="22 KB"
+      file-actions="download preview delete"
+      >
+      </wm-file>`,
+        });
+    }
+    it("renders green check alongside recently uploaded files", async () => {
+        html = `<wm-file
+    id="file1"
+    name="File retrieved from server"
+    type="pdf"
+    last-updated="10/30/97 3:46 PM"
+    size="22 KB"
+    file-actions="download preview delete"
+    progress="100"
+    >
+    </wm-file>`;
+        page = await newSpecPage({ components: [File], html });
+        await page.waitForChanges();
+        const fileWrapperEl = page.root.shadowRoot.querySelector(".file-wrapper");
+        expect(fileWrapperEl).toHaveClass("checked");
+    });
+    it("renders file actions in the proper order", async () => {
+        html = `<wm-file
+    id="file1"
+    name="File retrieved from server"
+    type="pdf"
+    last-updated="10/30/97 3:46 PM"
+    size="22 KB"
+    file-actions="download delete preview"
+    >
+    </wm-file>`;
+        page = await newSpecPage({ components: [File], html });
+        await page.waitForChanges();
+        const fileActionEls = page.root.shadowRoot.querySelectorAll("wm-button");
+        expect(fileActionEls[0]).toEqualAttribute("tooltip", "Preview");
+        expect(fileActionEls[1]).toEqualAttribute("tooltip", "Download");
+        expect(fileActionEls[2]).toEqualAttribute("tooltip", "Delete");
+    });
+    it("defaults available actions to download and delete", async () => {
+        html = `<wm-file
+    id="file1"
+    name="File retrieved from server"
+    type="pdf"
+    last-updated="10/30/97 3:46 PM"
+    size="22 KB"
+    >
+    </wm-file>`;
+        page = await newSpecPage({ components: [File], html });
+        await page.waitForChanges();
+        const deleteButton = page.root.shadowRoot.querySelector(".delete-button");
+        const downloadButton = page.root.shadowRoot.querySelector(".download-button");
+        const previewButton = page.root.shadowRoot.querySelector(".preview-button");
+        expect(deleteButton).toBeTruthy();
+        expect(downloadButton).toBeTruthy();
+        expect(previewButton).toBeFalsy();
+    });
+    it("displays no file actions when an empty string is passed", async () => {
+        html = `<wm-file
+    id="file1"
+    name="File retrieved from server"
+    type="pdf"
+    last-updated="10/30/97 3:46 PM"
+    size="22 KB"
+    file-actions=""
+    >
+    </wm-file>`;
+        page = await newSpecPage({ components: [File], html });
+        await page.waitForChanges();
+        const deleteButton = page.root.shadowRoot.querySelector(".delete-button");
+        const downloadButton = page.root.shadowRoot.querySelector(".download-button");
+        const previewButton = page.root.shadowRoot.querySelector(".preview-button");
+        expect(deleteButton).toBeFalsy();
+        expect(downloadButton).toBeFalsy();
+        expect(previewButton).toBeFalsy();
+    });
+    it("renders timestamp by default, size if specified, or none based on show-info prop", async () => {
+        page = await createPageHelper();
+        await page.waitForChanges();
+        let fileInfoEl = page.root.shadowRoot.querySelector(".file-info");
+        expect(fileInfoEl.textContent).toBe("10/30/97 3:46 PM");
+        page = await newSpecPage({
+            components: [File],
+            html: `<wm-file
+      id="file1"
+      name="File retrieved from server"
+      type="pdf"
+      last-updated="10/30/97 3:46 PM"
+      size="22 KB"
+      file-actions="download preview delete"
+      show-info="size"
+      >
+      </wm-file>`,
+        });
+        await page.waitForChanges();
+        fileInfoEl = page.root.shadowRoot.querySelector(".file-info");
+        expect(fileInfoEl.textContent).toBe("22 KB");
+        page = await newSpecPage({
+            components: [File],
+            html: `<wm-file
+      id="file1"
+      name="File retrieved from server"
+      type="pdf"
+      last-updated="10/30/97 3:46 PM"
+      size="22 KB"
+      file-actions="download preview delete"
+      show-info="time"
+      >
+      </wm-file>`,
+        });
+        await page.waitForChanges();
+        fileInfoEl = page.root.shadowRoot.querySelector(".file-info");
+        expect(fileInfoEl.textContent).toBe("10/30/97 3:46 PM");
+        page = await newSpecPage({
+            components: [File],
+            html: `<wm-file
+      id="file1"
+      name="File retrieved from server"
+      type="pdf"
+      last-updated="10/30/97 3:46 PM"
+      size="22 KB"
+      file-actions="download preview delete"
+      show-info="none"
+      >
+      </wm-file>`,
+        });
+        await page.waitForChanges();
+        fileInfoEl = page.root.shadowRoot.querySelector(".file-info");
+        expect(fileInfoEl).toBeFalsy();
+    });
+    it("emits the appropriate events when user clicks the buttons", async () => {
+        const filePreviewedSpy = jest.fn();
+        const fileDownloadedSpy = jest.fn();
+        const fileDeletedSpy = jest.fn();
+        html = `<wm-file
+      id="file1"
+      name="File retrieved from server"
+      type="pdf"
+      last-updated="10/30/97 3:46 PM"
+      size="22 KB"
+      file-actions="download preview delete"
+      >
+      </wm-file>`;
+        page = await newSpecPage({ components: [File], html });
+        await page.waitForChanges();
+        page.root.addEventListener("wmFilePreview", filePreviewedSpy);
+        page.root.addEventListener("wmFileDownload", fileDownloadedSpy);
+        page.root.addEventListener("wmFileDelete", fileDeletedSpy);
+        // wmFilePreview
+        page.root.shadowRoot.querySelector(".preview-button").click();
+        await page.waitForChanges();
+        expect(filePreviewedSpy.mock.calls[0][0].target.id).toBe("file1");
+        // wmFileDownload
+        page.root.shadowRoot.querySelector(".download-button").click();
+        await page.waitForChanges();
+        expect(fileDownloadedSpy.mock.calls[0][0].target.id).toBe("file1");
+        // wmFileDelete
+        page.root.shadowRoot.querySelector(".delete-button").click();
+        await page.waitForChanges();
+        expect(fileDeletedSpy.mock.calls[0][0].target.id).toBe("file1");
+        jest.restoreAllMocks();
+    });
+    it("renders with an error if one is passed", async () => {
+        html = `<wm-file
+      id="file1"
+      error-message="Example error message"
+      file='{"id": "file1", "name": "File retrieved from server.pdf", "lastUpdated": "10/30/97 3:46 PM", "size": "22 KB", "fileActions": "download preview delete"}'
+      ></wm-file>`;
+        page = await newSpecPage({ components: [File], html });
+        await page.waitForChanges();
+        const fileDiv = page.root.shadowRoot.querySelector(".file");
+        expect(fileDiv).toHaveClass("--error");
+        const errorText = page.root.shadowRoot.querySelector(".error-message");
+        expect(errorText.textContent).toBe("Example error message");
+    });
+});

package/dist/collection/components/wm-file-list/wm-file-list.js CHANGED Viewed

@@ -4,7 +4,7 @@ export class FileList {
         this.showInfo = "last-updated";
     }
     render() {
-        return (h("div", { key: '7517d9199e320a918e7b87501e2a6841d17e70f5', role: "list", class: "list-wrapper" }, h("slot", { key: 'c90eaf77aa45b5b146ad71cfa3891cbc0a26ab9a' })));
+        return (h("div", { role: "list", class: "list-wrapper" }, h("slot", null)));
     }
     static get is() { return "wm-file-list"; }
     static get encapsulation() { return "shadow"; }