@salesforcedevs/dx-components 0.3.12 → 0.3.14-banner-alpha1

package/src/modules/dx/dropdown/__tests__/dropdown.test.ts

@@ -1,194 +0,0 @@
-import Dropdown from "dx/dropdown";
-import DropdownTest from "tests/dropdownTest";
-import { getOptionsCount } from "utils/options";
-import { createRenderComponent } from "utils/tests";
-import mockNestedOptions from "./mockNestedOptions";
-import mockProps from "./mockProps";
-
-const TAG = "dx-dropdown";
-const render = createRenderComponent(TAG, Dropdown);
-
-const renderWithSlot = createRenderComponent("dx-dropdown-test", DropdownTest);
-
-describe(TAG, () => {
-    it("renders all options when open", async () => {
-        const component = render({ ...mockProps, open: true });
-        await Promise.resolve();
-        const options = component.shadowRoot.querySelectorAll(
-            "dx-dropdown-option"
-        );
-        expect(options.length).toEqual(mockProps.options.length);
-        return expect(component).toBeAccessible();
-    });
-
-    it("renders all nested options and the callout link when open", async () => {
-        const component = render({
-            ...mockProps,
-            options: mockNestedOptions,
-            open: true
-        });
-        await Promise.resolve();
-        const options = component.shadowRoot.querySelectorAll(
-            "dx-dropdown-option"
-        );
-        const link = component.shadowRoot.querySelector(".callout_link");
-        const count = getOptionsCount(mockNestedOptions);
-        expect(options.length).toEqual(count);
-        expect(link).not.toBeNull();
-        return expect(component).toBeAccessible();
-    });
-
-    it("value prop activates the selected option", async () => {
-        const component = render({ ...mockProps, open: true });
-        await Promise.resolve();
-        const options = Array.from(
-            component.shadowRoot.querySelectorAll("dx-dropdown-option")
-        );
-        const selectedOption = options.find(
-            // @ts-ignore
-            (option: HTMLElement) => option.active === true
-        );
-        // @ts-ignore
-        const id = selectedOption.option.id;
-        expect(id).toEqual(mockProps.value);
-        return expect(component).toBeAccessible();
-    });
-
-    it.skip("calls onchange with correct value and closes afterwards, returning focus to the control", async () => {
-        const component = renderWithSlot();
-        const mockChange = jest.fn();
-        const mockClose = jest.fn();
-
-        await Promise.resolve();
-
-        const button = component.shadowRoot.querySelector("dx-button");
-        const dropdown = component.shadowRoot.querySelector("dx-dropdown");
-        dropdown.addEventListener("change", mockChange);
-        dropdown.addEventListener("close", mockClose);
-
-        const options = dropdown.shadowRoot.querySelectorAll(
-            "dx-dropdown-option"
-        );
-        const option = options[0];
-        // @ts-ignore
-        const id = option.option.id;
-
-        // @ts-ignore
-        option.dispatchEvent(new CustomEvent("select", { detail: id }));
-
-        expect(mockChange.mock.calls[0][0].detail).toEqual(id);
-        expect(mockClose).toBeCalledTimes(1);
-
-        expect(button.isSameNode(component.shadowRoot.activeElement)).toEqual(
-            true
-        );
-
-        return expect(component).toBeAccessible();
-    });
-
-    it("doesnt close after onchange when stayOpenAfterChange is true", async () => {
-        const component = render({
-            ...mockProps,
-            stayOpenAfterChange: true,
-            open: true
-        });
-        const mockClose = jest.fn();
-
-        component.addEventListener("close", mockClose);
-
-        await Promise.resolve();
-
-        const option = component.shadowRoot.querySelector("dx-dropdown-option");
-        // @ts-ignore
-        const id = option.option.id;
-        // @ts-ignore
-        option.dispatchEvent(new CustomEvent("select", { detail: id }));
-
-        expect(mockClose).not.toHaveBeenCalled();
-        return expect(component).toBeAccessible();
-    });
-
-    it.skip("renders options with a slotted control after interaction", async () => {
-        const component = renderWithSlot();
-
-        await Promise.resolve();
-
-        const button = component.shadowRoot.querySelector("dx-button");
-        button.click();
-
-        await Promise.resolve();
-
-        const options = component.shadowRoot.querySelectorAll(
-            "dx-dropdown-option"
-        );
-
-        expect(options.length).toEqual(mockProps.options.length);
-    });
-
-    it.skip("doesn't blow up when keyboard events are fired while closed", async () => {
-        const component = renderWithSlot();
-
-        await Promise.resolve();
-
-        const dropdown = component.shadowRoot.querySelector("dx-dropdown");
-        const dropdownMenu = dropdown.shadowRoot.querySelector(".menu_list");
-
-        dropdownMenu.dispatchEvent(
-            new KeyboardEvent("keydown", { key: "ArrowUp" })
-        );
-        expect(dropdown.shadowRoot.activeElement).toBeNull();
-    });
-
-    it.skip("focuses the first option on dropdown open, allows cyclic incrementing and decrementing of focused option with keyboard", async () => {
-        const component = renderWithSlot();
-
-        await Promise.resolve();
-
-        const button = component.shadowRoot.querySelector("dx-button");
-        const dropdown = component.shadowRoot.querySelector("dx-dropdown");
-        const dropdownMenu = dropdown.shadowRoot.querySelector(".menu_list");
-        const options = dropdown.shadowRoot.querySelectorAll(
-            "dx-dropdown-option"
-        );
-
-        button.click();
-
-        await Promise.resolve();
-
-        expect(
-            options[0].isSameNode(dropdown.shadowRoot.activeElement)
-        ).toEqual(true);
-
-        dropdownMenu.dispatchEvent(
-            new KeyboardEvent("keydown", { key: "ArrowUp" })
-        );
-
-        expect(
-            options[options.length - 1].isSameNode(
-                dropdown.shadowRoot.activeElement
-            )
-        ).toEqual(true);
-
-        dropdownMenu.dispatchEvent(
-            new KeyboardEvent("keydown", { key: "ArrowDown" })
-        );
-
-        expect(
-            options[0].isSameNode(dropdown.shadowRoot.activeElement)
-        ).toEqual(true);
-
-        dropdownMenu.dispatchEvent(
-            new KeyboardEvent("keydown", { key: "ArrowDown" })
-        );
-
-        expect(
-            options[1].isSameNode(dropdown.shadowRoot.activeElement)
-        ).toEqual(true);
-
-        dropdownMenu.dispatchEvent(
-            new KeyboardEvent("keydown", { key: "ArrowDown" })
-        );
-
-        return expect(component).toBeAccessible();
-    });
-});

package/src/modules/dx/dropdown/__tests__/mockNestedOptions.ts

@@ -1,96 +0,0 @@
-export default [
-    {
-        label: "Products",
-        id: "brands",
-        calloutLink: {
-            href: "www.google.com",
-            target: "_blank",
-            label: "View all Products"
-        },
-        options: [
-            {
-                label: "Heroku",
-                id: "heroku",
-                iconSymbol: "heroku",
-                iconSprite: "salesforcebrand"
-            },
-            {
-                label: "Tableau",
-                id: "tableau",
-                iconSymbol: "analytics",
-                iconSprite: "salesforcebrand"
-            },
-            {
-                label: "Quip",
-                id: "quip",
-                iconSymbol: "collaboration",
-                iconSprite: "salesforcebrand"
-            },
-            {
-                label: "Mulesoft",
-                id: "mulesoft",
-                iconSymbol: "integration",
-                iconSprite: "salesforcebrand"
-            }
-        ]
-    },
-    {
-        label: "Platform",
-        id: "platform",
-        options: [
-            {
-                label: "Apex",
-                id: "apex"
-            },
-            {
-                label: "Lightning Web Components",
-                id: "LWC"
-            },
-            {
-                label: "Mobile",
-                id: "mobile"
-            },
-            {
-                label: "Apex Other",
-                id: "apex2"
-            },
-            {
-                label: "Lightning Web Runtime",
-                id: "LWR"
-            },
-            {
-                label: "Apex Legends",
-                id: "legends"
-            },
-            {
-                label: "Einstein",
-                id: "einstein"
-            },
-            {
-                label: "Mobile SDK",
-                id: "mobilesdk"
-            }
-        ]
-    },
-    {
-        label: "Sandwich",
-        id: "sandwich",
-        options: [
-            {
-                label: "Bread",
-                description: "Lets get this bread.",
-                id: "bread"
-            },
-            {
-                label: "Peanut Butter",
-                description: "This is tasty PB.",
-                id: "pb"
-            },
-            {
-                label: "Jelly",
-                description: "This is jelly, maybe grape jelly.",
-                id: "jelly"
-            }
-        ]
-    }
-];

package/src/modules/dx/dropdown/__tests__/mockOptions.ts

@@ -1,10 +0,0 @@
-export default [
-    { label: "Banana", id: "banana" },
-    { label: "Orange", id: "orange" },
-    { label: "Potato", id: "potato" },
-    { label: "Shoe", id: "shoe" },
-    { label: "Broom", id: "broom" },
-    { label: "Spaghetti", id: "spaghetti" },
-    { label: "Tater Tot", id: "tater" },
-    { label: "Lint", id: "lint" }
-];

package/src/modules/dx/dropdown/__tests__/mockProps.ts

@@ -1,6 +0,0 @@
-import mockOptions from "./mockOptions";
-
-export default {
-    value: "potato",
-    options: mockOptions
-};

package/src/modules/dx/dropdown/dropdown.stories.ts

@@ -1,75 +0,0 @@
-import { html } from "lit-html";
-import mockOptions from "./__tests__/mockOptions";
-import mockNestedOptions from "./__tests__/mockNestedOptions";
-
-export default {
-    title: "dx/dx-dropdown",
-    component: "dx-dropdown"
-};
-
-const options = JSON.stringify(mockOptions);
-const nestedOptions = JSON.stringify(mockNestedOptions);
-const nestedOptionsTwoItems = JSON.stringify(mockNestedOptions.slice(0, 2));
-
-// prettier-ignore
-const styles = () => html`
-    <style>
-        #root {
-            display: grid;
-            grid-template-columns: repeat(3, 1fr);
-            grid-gap: 20px;
-            justify-items: center;
-        }
-    </style>
-`;
-
-// prettier-ignore
-export const Base = () => html`
-    ${styles()}
-    <dx-dropdown options="${options}">
-        <dx-button icon-symbol="chevrondown">
-            Default
-        </dx-button>
-    </dx-dropdown>
-
-    <br />
-
-    <dx-dropdown stay-open-after-change="true" options="${options}">
-        <dx-button icon-symbol="chevrondown">
-            Stay Open After Change
-        </dx-button>
-    </dx-dropdown>
-
-    <br />
-
-    <dx-dropdown
-        options="${nestedOptions}"
-        placement="bottom"
-        offset="medium"
-    >
-        <dx-button icon-symbol="chevrondown">
-            Nested Options
-        </dx-button>
-    </dx-dropdown>
-
-    <br />
-
-    <dx-dropdown
-        options="${nestedOptionsTwoItems}"
-        placement="bottom"
-        offset="medium"
-    >
-        <dx-button icon-symbol="chevrondown">
-            Nested Options 2 Items
-        </dx-button>
-    </dx-dropdown>
-`;
-
-export const DisabledControl = () => html`
-    ${styles()}
-    <dx-dropdown options="${options}">
-        <dx-button icon-symbol="chevrondown" disabled="true">
-            I'm disabled
-        </dx-button>
-    </dx-dropdown>
-`;

package/src/modules/dx/dropdownOption/__tests__/dropdownOption.test.ts

@@ -1,82 +0,0 @@
-import DropdownOption from "dx/dropdownOption";
-import { createRenderComponent } from "utils/tests";
-import { MOCK_BUTTON_PROPS, MOCK_LINK_PROPS } from "./mockProps";
-
-const TAG = "dx-dropdown-option";
-const render = createRenderComponent(TAG, DropdownOption);
-
-const appendToMenu = (element: HTMLElement) => {
-    const menu = document.createElement("DIV");
-    document.body.appendChild(menu);
-    menu.setAttribute("role", "menu");
-    menu.appendChild(element);
-};
-
-describe(TAG, () => {
-    it("renders a button by default", () => {
-        const component = render(MOCK_BUTTON_PROPS);
-        expect(component.shadowRoot.querySelector("button")).not.toBeNull();
-
-        appendToMenu(component);
-        return expect(component).toBeAccessible();
-    });
-
-    it("renders the correct label, description, and img", () => {
-        const component = render(MOCK_BUTTON_PROPS);
-        const label = component.shadowRoot.querySelector(".option_label")
-            .textContent;
-        expect(label).toEqual(MOCK_BUTTON_PROPS.option.label);
-
-        const description = component.shadowRoot.querySelector(
-            ".option_description"
-        ).textContent;
-        expect(description).toEqual(MOCK_BUTTON_PROPS.option.description);
-
-        const img = component.shadowRoot.querySelector(".option_icon");
-        expect(img).not.toBeNull();
-
-        appendToMenu(component);
-        return expect(component).toBeAccessible();
-    });
-
-    it("renders a link with the correct href when given link props", () => {
-        const component = render(MOCK_LINK_PROPS);
-
-        const href = component.shadowRoot
-            .querySelector("a")
-            .getAttribute("href");
-        expect(href).toEqual(MOCK_LINK_PROPS.option.link.href);
-
-        appendToMenu(component);
-        return expect(component).toBeAccessible();
-    });
-
-    it("applies the active class correctly", () => {
-        const component = render({ ...MOCK_BUTTON_PROPS, active: true });
-        const optionEl = component.shadowRoot.querySelector(".option-active");
-        expect(optionEl).not.toBeNull();
-
-        appendToMenu(component);
-        return expect(component).toBeAccessible();
-    });
-
-    it("can focus itself", () => {
-        const component = render(MOCK_BUTTON_PROPS);
-        component.focus();
-
-        expect(document.activeElement).toEqual(component);
-    });
-
-    it("onClick function is fired when button is clicked", () => {
-        const onClickMock = jest.fn();
-        const component = render({
-            ...MOCK_BUTTON_PROPS,
-            onclick: onClickMock
-        });
-
-        const option = component.shadowRoot.querySelector(".option");
-        option.click();
-
-        expect(onClickMock).toBeCalled();
-    });
-});

package/src/modules/dx/dropdownOption/__tests__/mockProps.ts

@@ -1,20 +0,0 @@
-export const MOCK_BUTTON_PROPS = {
-    option: {
-        id: "documentation",
-        label: "Documentation",
-        description: "Documentation is kewl",
-        iconSymbol: "heroku",
-        iconSprite: "salesforcebrand"
-    }
-};
-
-export const MOCK_LINK_PROPS = {
-    option: {
-        id: "documentation",
-        label: "Documentation",
-        link: {
-            href: "/documentation",
-            target: null
-        }
-    }
-};

package/src/modules/dx/emptyState/__tests__/emptyState.test.ts

@@ -1,33 +0,0 @@
-import EmptyState from "dx/emptyState";
-import { createRenderComponent } from "utils/tests";
-import mockProps from "./mockProps";
-
-const TAG = "dx-empty-state";
-const render = createRenderComponent(TAG, EmptyState);
-
-describe(TAG, () => {
-    it("renders", () => {
-        const element = render(mockProps);
-        const container: HTMLElement = element.shadowRoot.querySelector(
-            ".container"
-        );
-        const renderedTitle: HTMLElement = element.shadowRoot.querySelector(
-            "h3"
-        );
-        const renderedSubTitle: HTMLElement = element.shadowRoot.querySelector(
-            "p"
-        );
-        const image: HTMLImageElement = element.shadowRoot.querySelector("img");
-
-        expect(renderedTitle).not.toBeNull();
-        expect(renderedSubTitle).not.toBeNull();
-        expect(container).not.toBeNull();
-        expect(image).not.toBeNull();
-
-        expect(renderedSubTitle.textContent).toEqual(mockProps.subtitle);
-        expect(renderedTitle.textContent).toEqual(mockProps.title);
-        expect(image.src).toEqual(`http://localhost${mockProps.imgSrc}`);
-
-        return expect(element).toBeAccessible();
-    });
-});

package/src/modules/dx/emptyState/__tests__/mockProps.ts

@@ -1,6 +0,0 @@
-export default {
-    title: "No matches",
-    subtitle: "Try searching for different words",
-    imgSrc: "/assets/svg/lake-mountain.svg",
-    imgAlt: "test"
-};

package/src/modules/dx/emptyState/emptyState.stories.ts

@@ -1,65 +0,0 @@
-import { html } from "lit-html";
-
-export default {
-    title: "dx/dx-empty-state",
-    component: "dx-empty-state"
-};
-
-const createStyles = () => html`
-    <style>
-        body {
-            padding: 12px 0 0 0 !important;
-        }
-        .title {
-            font-weight: bold;
-            margin: 24px;
-        }
-    </style>
-`;
-
-const title = (value: string) => html`<p class="title">${value}</p>`;
-
-const customTextStyles = () => html`
-    <style>
-        .custom-text-styles::part(container) {
-            position: relative;
-        }
-
-        .custom-text-styles::part(title),
-        .custom-text-styles::part(subtitle) {
-            --y-pos: -100%;
-            position: absolute;
-            top: 50%;
-            left: 50%;
-            transform: translateX(-50%) translateY(var(--y-pos));
-        }
-
-        .custom-text-styles::part(subtitle) {
-            --y-pos: 100%;
-        }
-    </style>
-`;
-
-export const Base = () => html`
-    ${createStyles()} ${title("Default")}
-    <dx-empty-state
-        title="No matches"
-        subtitle="Try searching for different words"
-        img-src="/assets/svg/lake-mountain.svg"
-        img-alt="test"
-    ></dx-empty-state>
-
-    ${title(
-        "Large title/subtitle. Center text w/ external styles via part selector."
-    )}
-    ${customTextStyles()}
-    <dx-empty-state
-        title="Beep boop. That did not compute."
-        subtitle="No results"
-        img-src="/assets/svg/docs-empty-state.svg"
-        img-alt="test"
-        subtitle-size="large"
-        title-size="large"
-        class="custom-text-styles"
-    ></dx-empty-state>
-`;

package/src/modules/dx/feature/__tests__/feature.test.ts

@@ -1,30 +0,0 @@
-import Feature from "dx/feature";
-import { createRenderComponent } from "utils/tests";
-import mockProps from "./mockProps";
-
-const TAG = "dx-feature";
-const render = createRenderComponent(TAG, Feature);
-
-describe(TAG, () => {
-    it("renders an accessible feature with description on the left by default", () => {
-        const element = render(mockProps);
-
-        const sectionEl = element.shadowRoot.querySelector("section");
-        expect(sectionEl).not.toBeNull();
-        expect(sectionEl.className).toBe("description-left");
-
-        return expect(sectionEl).toBeAccessible();
-    });
-
-    it("renders a feature with description on the rigth", () => {
-        const element = render(mockProps);
-        element.descriptionPosition = "right";
-        document.body.appendChild(element);
-
-        const sectionEl = element.shadowRoot.querySelector("section");
-        expect(sectionEl).not.toBeNull();
-        expect(sectionEl.className).toBe("description-right");
-
-        return expect(element).toBeAccessible();
-    });
-});

package/src/modules/dx/feature/__tests__/mockProps.ts

@@ -1,8 +0,0 @@
-export default {
-    title: "Einstein Prediction Builder",
-    buttonHref: "https://lmgtfy.app",
-    buttonLabel: "Build a predictive app",
-    imageSrc: "https://i.imgur.com/FUsyxR5.jpg",
-    body:
-        "Build AI predictions into your <b>Salesforce</b> app for data stored in standard or custom objects using only clicks—then deploy and embed predictions onto any page in Salesforce."
-};

package/src/modules/dx/featureGrid/__tests__/featureGrid.test.ts

@@ -1,21 +0,0 @@
-// This test requires a wrapper component that's not exposed in the build.
-import FeatureGridTest from "tests/featureGridTest";
-import { createRenderComponent } from "utils/tests";
-
-const TAG = "dx-feature-grid";
-const render = createRenderComponent(TAG, FeatureGridTest);
-
-describe(TAG, () => {
-    it("renders a feature grid with mixed description positions", async () => {
-        const gridTestEl = render();
-        const featureEls = gridTestEl.shadowRoot.querySelectorAll("dx-feature");
-
-        await Promise.resolve();
-        expect(featureEls.length).toBe(3);
-        expect(featureEls[0].descriptionPosition).toBe("left");
-        expect(featureEls[1].descriptionPosition).toBe("right");
-        expect(featureEls[2].descriptionPosition).toBe("left");
-
-        return expect(gridTestEl).toBeAccessible();
-    });
-});