@ukic/web-components 2.1.0-beta.9 → 2.2.0

package/dist/collection/components/ic-menu-item/ic-menu-item.js

@@ -0,0 +1,394 @@
+import { Host, h, } from "@stencil/core";
+import { getParentElement, isSlotUsed, onComponentRequiredPropUndefined, removeDisabledFalse, } from "../../utils/helpers";
+import Check from "../../assets/check-icon.svg";
+import Chevron from "../../assets/chevron-icon.svg";
+/**
+ * @slot icon - Content will be placed to the left of the menu item label.
+ */
+export class MenuItem {
+  constructor() {
+    this.handleClick = (e) => {
+      if (this.submenuTriggerFor !== undefined) {
+        this.triggerPopoverMenuInstance.emit();
+      }
+      else if (this.variant === "toggle") {
+        e.preventDefault();
+        this.toggleChecked
+          ? (this.toggleChecked = false)
+          : (this.toggleChecked = true);
+      }
+      this.handleMenuItemClick.emit({
+        label: this.label,
+        hasSubMenu: !!this.el.submenuTriggerFor,
+      });
+    };
+    this.getMenuItemAriaLabel = () => {
+      let ariaLabel = this.label;
+      if (this.description !== undefined) {
+        ariaLabel = `${ariaLabel}, ${this.description}`;
+      }
+      if (this.keyboardShortcut !== undefined) {
+        ariaLabel = `${ariaLabel}, ${this.keyboardShortcut}`;
+      }
+      if (this.variant === "destructive") {
+        ariaLabel = `${ariaLabel}, destructive`;
+      }
+      if (this.submenuTriggerFor !== undefined) {
+        ariaLabel = `${ariaLabel}, triggers submenu`;
+      }
+      if (this.el.classList.contains("ic-popover-submenu-back-button")) {
+        ariaLabel = "Go back to parent menu";
+      }
+      const parentEl = getParentElement(this.el);
+      if (parentEl.tagName === "IC-MENU-GROUP" &&
+        parentEl.label) {
+        return `${ariaLabel}, ${parentEl.label} menu group`;
+      }
+      else {
+        return ariaLabel;
+      }
+    };
+    this.toggleChecked = false;
+    this.description = undefined;
+    this.disabled = false;
+    this.href = undefined;
+    this.hreflang = undefined;
+    this.keyboardShortcut = undefined;
+    this.label = undefined;
+    this.referrerpolicy = undefined;
+    this.rel = undefined;
+    this.submenuTriggerFor = undefined;
+    this.target = undefined;
+    this.variant = "default";
+  }
+  componentWillLoad() {
+    // This ensures that trigger menu items are always set to the default variant
+    if (this.submenuTriggerFor !== undefined && this.variant !== "default") {
+      this.variant = "default";
+    }
+    removeDisabledFalse(this.disabled, this.el);
+  }
+  componentDidLoad() {
+    onComponentRequiredPropUndefined([{ prop: this.label, propName: "label" }], "Menu Item");
+  }
+  handleHostClick(e) {
+    if (this.disabled) {
+      e.stopImmediatePropagation();
+    }
+  }
+  render() {
+    // A helper function that checks if a prop has been defined
+    const isPropDefined = (prop) => {
+      return prop !== undefined ? prop : null;
+    };
+    // A sub-component to layout the menu information correctly in ic-button
+    const MenuItemInformation = () => {
+      return (h("div", { class: "menu-item-info" }, h("div", { class: "menu-labels" }, h("ic-typography", { class: "menu-item-label" }, this.label), this.keyboardShortcut && (h("ic-typography", { variant: "caption", class: "shortcut" }, this.keyboardShortcut))), this.description && (h("ic-typography", { class: "menu-item-description", variant: "caption" }, this.description))));
+    };
+    return (h(Host, { class: {
+        ["disabled"]: this.disabled,
+      } }, h("li", { role: this.variant === "toggle" ? "menuitemcheckbox" : "menuitem", "aria-disabled": `${this.disabled}`, "aria-checked": this.variant === "toggle" && this.toggleChecked === true
+        ? true
+        : this.variant === "toggle" && this.toggleChecked === false
+          ? false
+          : undefined }, h("ic-button", { disableTooltip: true, fullWidth: true, variant: "tertiary", onClick: this.handleClick, href: isPropDefined(this.href), hreflang: isPropDefined(this.hreflang), target: isPropDefined(this.target), rel: isPropDefined(this.rel), referrerpolicy: this.referrerpolicy !== undefined ? this.referrerpolicy : null, "aria-disabled": `${this.disabled}`, "aria-label": this.getMenuItemAriaLabel(), "aria-controls": this.submenuTriggerFor !== undefined
+        ? `ic-popover-submenu-${this.submenuTriggerFor}`
+        : false, "aria-haspopup": this.submenuTriggerFor !== undefined ||
+        this.el.classList.contains("ic-popover-submenu-back-button")
+        ? "menu"
+        : false, "aria-owns": this.submenuTriggerFor !== undefined
+        ? `ic-popover-submenu-${this.submenuTriggerFor}`
+        : false }, h("div", { class: "focus-border" }, isSlotUsed(this.el, "icon") && (h("span", { class: "icon" }, h("slot", { name: "icon" }))), h(MenuItemInformation, null), this.variant === "toggle" && (h("span", { class: {
+        ["check-icon"]: true,
+        ["hide"]: !this.toggleChecked,
+      }, "aria-hidden": "true", innerHTML: Check })), this.submenuTriggerFor !== undefined && (h("span", { class: { ["submenu-icon"]: true }, "aria-hidden": "true", innerHTML: Chevron })))))));
+  }
+  static get is() { return "ic-menu-item"; }
+  static get encapsulation() { return "shadow"; }
+  static get delegatesFocus() { return true; }
+  static get originalStyleUrls() {
+    return {
+      "$": ["ic-menu-item.css"]
+    };
+  }
+  static get styleUrls() {
+    return {
+      "$": ["ic-menu-item.css"]
+    };
+  }
+  static get properties() {
+    return {
+      "description": {
+        "type": "string",
+        "mutable": false,
+        "complexType": {
+          "original": "string",
+          "resolved": "string",
+          "references": {}
+        },
+        "required": false,
+        "optional": true,
+        "docs": {
+          "tags": [],
+          "text": "The description displayed in the menu item, below the label."
+        },
+        "attribute": "description",
+        "reflect": false
+      },
+      "disabled": {
+        "type": "boolean",
+        "mutable": false,
+        "complexType": {
+          "original": "boolean",
+          "resolved": "boolean",
+          "references": {}
+        },
+        "required": false,
+        "optional": true,
+        "docs": {
+          "tags": [],
+          "text": "If `true`, the menu item will be in disabled state."
+        },
+        "attribute": "disabled",
+        "reflect": false,
+        "defaultValue": "false"
+      },
+      "href": {
+        "type": "string",
+        "mutable": false,
+        "complexType": {
+          "original": "string",
+          "resolved": "string",
+          "references": {}
+        },
+        "required": false,
+        "optional": true,
+        "docs": {
+          "tags": [],
+          "text": "The URL that the link points to. This will render the menu item as an \"a\" tag."
+        },
+        "attribute": "href",
+        "reflect": false
+      },
+      "hreflang": {
+        "type": "string",
+        "mutable": false,
+        "complexType": {
+          "original": "string",
+          "resolved": "string",
+          "references": {}
+        },
+        "required": false,
+        "optional": true,
+        "docs": {
+          "tags": [],
+          "text": "The human language of the linked URL."
+        },
+        "attribute": "hreflang",
+        "reflect": false
+      },
+      "keyboardShortcut": {
+        "type": "string",
+        "mutable": false,
+        "complexType": {
+          "original": "string",
+          "resolved": "string",
+          "references": {}
+        },
+        "required": false,
+        "optional": true,
+        "docs": {
+          "tags": [],
+          "text": "The label describing the keyboard shortcut for a menu item's action."
+        },
+        "attribute": "keyboard-shortcut",
+        "reflect": false
+      },
+      "label": {
+        "type": "string",
+        "mutable": false,
+        "complexType": {
+          "original": "string",
+          "resolved": "string",
+          "references": {}
+        },
+        "required": true,
+        "optional": false,
+        "docs": {
+          "tags": [],
+          "text": "The label to display in the menu item."
+        },
+        "attribute": "label",
+        "reflect": false
+      },
+      "referrerpolicy": {
+        "type": "string",
+        "mutable": false,
+        "complexType": {
+          "original": "ReferrerPolicy",
+          "resolved": "\"\" | \"no-referrer\" | \"no-referrer-when-downgrade\" | \"origin\" | \"origin-when-cross-origin\" | \"same-origin\" | \"strict-origin\" | \"strict-origin-when-cross-origin\" | \"unsafe-url\"",
+          "references": {
+            "ReferrerPolicy": {
+              "location": "global"
+            }
+          }
+        },
+        "required": false,
+        "optional": true,
+        "docs": {
+          "tags": [],
+          "text": "How much of the referrer to send when following the link."
+        },
+        "attribute": "referrerpolicy",
+        "reflect": false
+      },
+      "rel": {
+        "type": "string",
+        "mutable": false,
+        "complexType": {
+          "original": "string",
+          "resolved": "string",
+          "references": {}
+        },
+        "required": false,
+        "optional": true,
+        "docs": {
+          "tags": [],
+          "text": "The relationship of the linked URL as space-separated link types."
+        },
+        "attribute": "rel",
+        "reflect": false
+      },
+      "submenuTriggerFor": {
+        "type": "string",
+        "mutable": false,
+        "complexType": {
+          "original": "string",
+          "resolved": "string",
+          "references": {}
+        },
+        "required": false,
+        "optional": true,
+        "docs": {
+          "tags": [],
+          "text": "This references the popover menu instance that the menu item is a trigger for. If this prop is set, then the variant will always be default."
+        },
+        "attribute": "submenu-trigger-for",
+        "reflect": false
+      },
+      "target": {
+        "type": "string",
+        "mutable": false,
+        "complexType": {
+          "original": "string",
+          "resolved": "string",
+          "references": {}
+        },
+        "required": false,
+        "optional": true,
+        "docs": {
+          "tags": [],
+          "text": "The place to display the linked URL, as the name for a browsing context (a tab, window, or iframe)."
+        },
+        "attribute": "target",
+        "reflect": false
+      },
+      "variant": {
+        "type": "string",
+        "mutable": true,
+        "complexType": {
+          "original": "IcMenuItemVariants",
+          "resolved": "\"default\" | \"destructive\" | \"toggle\"",
+          "references": {
+            "IcMenuItemVariants": {
+              "location": "import",
+              "path": "./ic-menu-item.types"
+            }
+          }
+        },
+        "required": false,
+        "optional": false,
+        "docs": {
+          "tags": [],
+          "text": "The variant of the menu item."
+        },
+        "attribute": "variant",
+        "reflect": true,
+        "defaultValue": "\"default\""
+      }
+    };
+  }
+  static get states() {
+    return {
+      "toggleChecked": {}
+    };
+  }
+  static get events() {
+    return [{
+        "method": "childBlur",
+        "name": "childBlur",
+        "bubbles": true,
+        "cancelable": true,
+        "composed": true,
+        "docs": {
+          "tags": [{
+              "name": "internal",
+              "text": "Emitted when item loses focus."
+            }],
+          "text": ""
+        },
+        "complexType": {
+          "original": "void",
+          "resolved": "void",
+          "references": {}
+        }
+      }, {
+        "method": "handleMenuItemClick",
+        "name": "handleMenuItemClick",
+        "bubbles": true,
+        "cancelable": true,
+        "composed": true,
+        "docs": {
+          "tags": [{
+              "name": "internal",
+              "text": "Emitted when the user clicks a menu item."
+            }],
+          "text": ""
+        },
+        "complexType": {
+          "original": "{\n    label: string;\n    hasSubMenu: boolean;\n  }",
+          "resolved": "{ label: string; hasSubMenu: boolean; }",
+          "references": {}
+        }
+      }, {
+        "method": "triggerPopoverMenuInstance",
+        "name": "triggerPopoverMenuInstance",
+        "bubbles": true,
+        "cancelable": true,
+        "composed": true,
+        "docs": {
+          "tags": [{
+              "name": "internal",
+              "text": "Emitted when the user clicks a menu item that triggers a popover menu instance."
+            }],
+          "text": ""
+        },
+        "complexType": {
+          "original": "void",
+          "resolved": "void",
+          "references": {}
+        }
+      }];
+  }
+  static get elementRef() { return "el"; }
+  static get listeners() {
+    return [{
+        "name": "click",
+        "method": "handleHostClick",
+        "target": undefined,
+        "capture": true,
+        "passive": false
+      }];
+  }
+}
+//# sourceMappingURL=ic-menu-item.js.map

package/dist/collection/components/ic-menu-item/ic-menu-item.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ic-menu-item.js","sourceRoot":"","sources":["../../../src/components/ic-menu-item/ic-menu-item.tsx"],"names":[],"mappings":"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","sourcesContent":["import {\n  Component,\n  Element,\n  Host,\n  Prop,\n  h,\n  State,\n  Event,\n  EventEmitter,\n  Listen,\n} from \"@stencil/core\";\nimport {\n  getParentElement,\n  isSlotUsed,\n  onComponentRequiredPropUndefined,\n  removeDisabledFalse,\n} from \"../../utils/helpers\";\nimport { IcMenuItemVariants } from \"./ic-menu-item.types\";\nimport Check from \"../../assets/check-icon.svg\";\nimport Chevron from \"../../assets/chevron-icon.svg\";\n\n/**\n * @slot icon - Content will be placed to the left of the menu item label.\n */\n\n@Component({\n  tag: \"ic-menu-item\",\n  styleUrl: \"ic-menu-item.css\",\n  shadow: {\n    delegatesFocus: true,\n  },\n})\nexport class MenuItem {\n  @Element() el: HTMLIcMenuItemElement;\n\n  @State() toggleChecked: boolean = false;\n\n  /**\n   * The description displayed in the menu item, below the label.\n   */\n  @Prop() description?: string;\n\n  /**\n   * If `true`, the menu item will be in disabled state.\n   */\n  @Prop() disabled?: boolean = false;\n\n  /**\n   * The URL that the link points to. This will render the menu item as an \"a\" tag.\n   */\n  @Prop() href?: string;\n\n  /**\n   * The human language of the linked URL.\n   */\n  @Prop() hreflang?: string;\n\n  /**\n   * The label describing the keyboard shortcut for a menu item's action.\n   */\n  @Prop() keyboardShortcut?: string;\n\n  /**\n   * The label to display in the menu item.\n   */\n  @Prop() label!: string;\n\n  /**\n   * How much of the referrer to send when following the link.\n   */\n  @Prop() referrerpolicy?: ReferrerPolicy;\n\n  /**\n   * The relationship of the linked URL as space-separated link types.\n   */\n  @Prop() rel?: string;\n\n  /**\n   * This references the popover menu instance that the menu item is a trigger for. If this prop is set, then the variant will always be default.\n   */\n  @Prop() submenuTriggerFor?: string;\n\n  /**\n   * The place to display the linked URL, as the name for a browsing context (a tab, window, or iframe).\n   */\n  @Prop() target?: string;\n\n  /**\n   * The variant of the menu item.\n   */\n  @Prop({ mutable: true, reflect: true }) variant: IcMenuItemVariants =\n    \"default\";\n\n  /**\n   * @internal Emitted when item loses focus.\n   */\n  @Event() childBlur: EventEmitter<void>;\n\n  /**\n   * @internal Emitted when the user clicks a menu item.\n   */\n  @Event() handleMenuItemClick: EventEmitter<{\n    label: string;\n    hasSubMenu: boolean;\n  }>;\n\n  /**\n   * @internal Emitted when the user clicks a menu item that triggers a popover menu instance.\n   */\n  @Event() triggerPopoverMenuInstance: EventEmitter<void>;\n\n  componentWillLoad(): void {\n    // This ensures that trigger menu items are always set to the default variant\n    if (this.submenuTriggerFor !== undefined && this.variant !== \"default\") {\n      this.variant = \"default\";\n    }\n    removeDisabledFalse(this.disabled, this.el);\n  }\n\n  componentDidLoad(): void {\n    onComponentRequiredPropUndefined(\n      [{ prop: this.label, propName: \"label\" }],\n      \"Menu Item\"\n    );\n  }\n\n  @Listen(\"click\", { capture: true })\n  handleHostClick(e: Event): void {\n    if (this.disabled) {\n      e.stopImmediatePropagation();\n    }\n  }\n\n  private handleClick = (e: Event): void => {\n    if (this.submenuTriggerFor !== undefined) {\n      this.triggerPopoverMenuInstance.emit();\n    } else if (this.variant === \"toggle\") {\n      e.preventDefault();\n      this.toggleChecked\n        ? (this.toggleChecked = false)\n        : (this.toggleChecked = true);\n    }\n    this.handleMenuItemClick.emit({\n      label: this.label,\n      hasSubMenu: !!this.el.submenuTriggerFor,\n    });\n  };\n\n  private getMenuItemAriaLabel = (): string => {\n    let ariaLabel = this.label;\n\n    if (this.description !== undefined) {\n      ariaLabel = `${ariaLabel}, ${this.description}`;\n    }\n\n    if (this.keyboardShortcut !== undefined) {\n      ariaLabel = `${ariaLabel}, ${this.keyboardShortcut}`;\n    }\n\n    if (this.variant === \"destructive\") {\n      ariaLabel = `${ariaLabel}, destructive`;\n    }\n\n    if (this.submenuTriggerFor !== undefined) {\n      ariaLabel = `${ariaLabel}, triggers submenu`;\n    }\n\n    if (this.el.classList.contains(\"ic-popover-submenu-back-button\")) {\n      ariaLabel = \"Go back to parent menu\";\n    }\n    const parentEl = getParentElement(this.el);\n\n    if (\n      parentEl.tagName === \"IC-MENU-GROUP\" &&\n      (parentEl as HTMLIcMenuGroupElement).label\n    ) {\n      return `${ariaLabel}, ${\n        (parentEl as HTMLIcMenuGroupElement).label\n      } menu group`;\n    } else {\n      return ariaLabel;\n    }\n  };\n\n  render() {\n    // A helper function that checks if a prop has been defined\n    const isPropDefined = (prop: string) => {\n      return prop !== undefined ? prop : null;\n    };\n\n    // A sub-component to layout the menu information correctly in ic-button\n    const MenuItemInformation = () => {\n      return (\n        <div class=\"menu-item-info\">\n          <div class=\"menu-labels\">\n            <ic-typography class=\"menu-item-label\">{this.label}</ic-typography>\n            {this.keyboardShortcut && (\n              <ic-typography variant=\"caption\" class=\"shortcut\">\n                {this.keyboardShortcut}\n              </ic-typography>\n            )}\n          </div>\n          {this.description && (\n            <ic-typography class=\"menu-item-description\" variant=\"caption\">\n              {this.description}\n            </ic-typography>\n          )}\n        </div>\n      );\n    };\n\n    return (\n      <Host\n        class={{\n          [\"disabled\"]: this.disabled,\n        }}\n      >\n        <li\n          role={this.variant === \"toggle\" ? \"menuitemcheckbox\" : \"menuitem\"}\n          aria-disabled={`${this.disabled}`}\n          aria-checked={\n            this.variant === \"toggle\" && this.toggleChecked === true\n              ? true\n              : this.variant === \"toggle\" && this.toggleChecked === false\n              ? false\n              : undefined\n          }\n        >\n          <ic-button\n            disableTooltip\n            fullWidth\n            variant=\"tertiary\"\n            onClick={this.handleClick}\n            href={isPropDefined(this.href)}\n            hreflang={isPropDefined(this.hreflang)}\n            target={isPropDefined(this.target)}\n            rel={isPropDefined(this.rel)}\n            referrerpolicy={\n              this.referrerpolicy !== undefined ? this.referrerpolicy : null\n            }\n            aria-disabled={`${this.disabled}`}\n            aria-label={this.getMenuItemAriaLabel()}\n            aria-controls={\n              this.submenuTriggerFor !== undefined\n                ? `ic-popover-submenu-${this.submenuTriggerFor}`\n                : false\n            }\n            aria-haspopup={\n              this.submenuTriggerFor !== undefined ||\n              this.el.classList.contains(\"ic-popover-submenu-back-button\")\n                ? \"menu\"\n                : false\n            }\n            aria-owns={\n              this.submenuTriggerFor !== undefined\n                ? `ic-popover-submenu-${this.submenuTriggerFor}`\n                : false\n            }\n          >\n            <div class=\"focus-border\">\n              {isSlotUsed(this.el, \"icon\") && (\n                <span class=\"icon\">\n                  <slot name=\"icon\"></slot>\n                </span>\n              )}\n              <MenuItemInformation />\n              {this.variant === \"toggle\" && (\n                <span\n                  class={{\n                    [\"check-icon\"]: true,\n                    [\"hide\"]: !this.toggleChecked,\n                  }}\n                  aria-hidden=\"true\"\n                  innerHTML={Check}\n                />\n              )}\n              {this.submenuTriggerFor !== undefined && (\n                <span\n                  class={{ [\"submenu-icon\"]: true }}\n                  aria-hidden=\"true\"\n                  innerHTML={Chevron}\n                />\n              )}\n            </div>\n          </ic-button>\n        </li>\n      </Host>\n    );\n  }\n}\n"]}

package/dist/collection/components/ic-menu-item/ic-menu-item.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ic-menu-item.types.js.map

package/dist/collection/components/ic-menu-item/ic-menu-item.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ic-menu-item.types.js","sourceRoot":"","sources":["../../../src/components/ic-menu-item/ic-menu-item.types.ts"],"names":[],"mappings":"","sourcesContent":["export type IcMenuItemVariants = \"toggle\" | \"destructive\" | \"default\";\n"]}

package/dist/collection/components/ic-menu-item/test/basic/ic-menu-item.spec.js

@@ -0,0 +1,108 @@
+import { newSpecPage } from "@stencil/core/testing";
+import { MenuItem } from "../../ic-menu-item";
+import { Button } from "../../../ic-button/ic-button";
+describe("menu item variants", () => {
+  it("should render the default variant", async () => {
+    const page = await newSpecPage({
+      components: [MenuItem],
+      html: `<ic-menu-item
+            label="Default variant"
+          />`,
+    });
+    expect(page.root).toMatchSnapshot();
+  });
+  it("should render a menu item with a description", async () => {
+    const page = await newSpecPage({
+      components: [MenuItem],
+      html: `<ic-menu-item
+            label="Default variant"
+            description="This is the default variant of the menu item with a description"
+          />`,
+    });
+    expect(page.root).toMatchSnapshot();
+  });
+  it("should render with keyboard shortcut", async () => {
+    const page = await newSpecPage({
+      components: [MenuItem],
+      html: `<ic-menu-item
+              label="Toggle variant"
+              keyboard-shortcut="Cmd+"
+            />`,
+    });
+    expect(page.root).toMatchSnapshot();
+  });
+  it("should render the toggle variant", async () => {
+    const page = await newSpecPage({
+      components: [MenuItem, Button],
+      html: `<ic-menu-item
+            variant="toggle"
+            label="Toggle variant"
+            id="test-menu-item"
+          />`,
+    });
+    expect(page.root).toMatchSnapshot();
+    expect(page.rootInstance.variant).toMatch("toggle");
+    expect(page.rootInstance.toggleChecked).toBeFalsy();
+    const button = page.root.shadowRoot
+      .querySelector("li > ic-button")
+      .shadowRoot.querySelector("button");
+    button.click();
+    await page.waitForChanges;
+  });
+  it("should render the destructive variant", async () => {
+    const page = await newSpecPage({
+      components: [MenuItem],
+      html: `<ic-menu-item
+            variant="destuctive"
+            label="Destructive variant"
+          />`,
+    });
+    expect(page.root).toMatchSnapshot();
+  });
+  it("should render a menu item that triggers a popover menu instance", async () => {
+    const page = await newSpecPage({
+      components: [MenuItem],
+      html: `<ic-menu-item
+            variant="destuctive"
+            submenu-trigger-for="submenu-1"
+            label="Destructive variant"
+          />`,
+    });
+    expect(page.rootInstance.submenuTriggerFor).not.toBeUndefined();
+    expect(page.rootInstance.variant).toMatch("default");
+  });
+  it('should emit the triggerPopoverMenuInstance event when the menu item has the prop: "submenu-trigger-for" and is clicked', async () => {
+    const page = await newSpecPage({
+      components: [MenuItem, Button],
+      html: `<ic-menu-item
+      id="test-menu-item"
+            submenu-trigger-for="submenu-1"
+            label="I emit an event"
+          />`,
+    });
+    const eventSpy = jest.fn();
+    page.win.addEventListener("triggerPopoverMenuInstance", eventSpy);
+    expect(page.rootInstance.submenuTriggerFor).not.toBeUndefined();
+    const element = await document.getElementById("test-menu-item");
+    await element.click();
+    await page.waitForChanges();
+    await page.rootInstance.handleClick;
+  });
+  it("should prevent default action on click if variant is 'toggle'", async () => {
+    const page = await newSpecPage({
+      components: [MenuItem],
+      html: `<ic-menu-item
+      id="test-menu-item"
+            label="I emit an event"
+            variant="toggle"
+          />`,
+    });
+    const eventSpy = jest.fn();
+    const mockEvent = {
+      preventDefault: eventSpy,
+    };
+    await page.rootInstance.handleClick(mockEvent);
+    expect(eventSpy).toHaveBeenCalled();
+  });
+});
+//# sourceMappingURL=ic-menu-item.spec.js.map

package/dist/collection/components/ic-menu-item/test/basic/ic-menu-item.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ic-menu-item.spec.js","sourceRoot":"","sources":["../../../../../src/components/ic-menu-item/test/basic/ic-menu-item.spec.ts"],"names":[],"mappings":"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","sourcesContent":["import { newSpecPage } from \"@stencil/core/testing\";\nimport { MenuItem } from \"../../ic-menu-item\";\nimport { Button } from \"../../../ic-button/ic-button\";\n\ndescribe(\"menu item variants\", () => {\n  it(\"should render the default variant\", async () => {\n    const page = await newSpecPage({\n      components: [MenuItem],\n      html: `<ic-menu-item\n            label=\"Default variant\"\n          />`,\n    });\n\n    expect(page.root).toMatchSnapshot();\n  });\n\n  it(\"should render a menu item with a description\", async () => {\n    const page = await newSpecPage({\n      components: [MenuItem],\n      html: `<ic-menu-item\n            label=\"Default variant\"\n            description=\"This is the default variant of the menu item with a description\"\n          />`,\n    });\n\n    expect(page.root).toMatchSnapshot();\n  });\n\n  it(\"should render with keyboard shortcut\", async () => {\n    const page = await newSpecPage({\n      components: [MenuItem],\n      html: `<ic-menu-item\n              label=\"Toggle variant\"\n              keyboard-shortcut=\"Cmd+\"\n            />`,\n    });\n    expect(page.root).toMatchSnapshot();\n  });\n\n  it(\"should render the toggle variant\", async () => {\n    const page = await newSpecPage({\n      components: [MenuItem, Button],\n      html: `<ic-menu-item\n            variant=\"toggle\"\n            label=\"Toggle variant\"\n            id=\"test-menu-item\"\n          />`,\n    });\n\n    expect(page.root).toMatchSnapshot();\n    expect(page.rootInstance.variant).toMatch(\"toggle\");\n    expect(page.rootInstance.toggleChecked).toBeFalsy();\n\n    const button = page.root.shadowRoot\n      .querySelector(\"li > ic-button\")\n      .shadowRoot.querySelector(\"button\");\n\n    button.click();\n    await page.waitForChanges;\n  });\n\n  it(\"should render the destructive variant\", async () => {\n    const page = await newSpecPage({\n      components: [MenuItem],\n      html: `<ic-menu-item\n            variant=\"destuctive\"\n            label=\"Destructive variant\"\n          />`,\n    });\n\n    expect(page.root).toMatchSnapshot();\n  });\n\n  it(\"should render a menu item that triggers a popover menu instance\", async () => {\n    const page = await newSpecPage({\n      components: [MenuItem],\n      html: `<ic-menu-item\n            variant=\"destuctive\"\n            submenu-trigger-for=\"submenu-1\"\n            label=\"Destructive variant\"\n          />`,\n    });\n\n    expect(page.rootInstance.submenuTriggerFor).not.toBeUndefined();\n\n    expect(page.rootInstance.variant).toMatch(\"default\");\n  });\n\n  it('should emit the triggerPopoverMenuInstance event when the menu item has the prop: \"submenu-trigger-for\" and is clicked', async () => {\n    const page = await newSpecPage({\n      components: [MenuItem, Button],\n      html: `<ic-menu-item\n      id=\"test-menu-item\"\n            submenu-trigger-for=\"submenu-1\"\n            label=\"I emit an event\"\n          />`,\n    });\n\n    const eventSpy = jest.fn();\n    page.win.addEventListener(\"triggerPopoverMenuInstance\", eventSpy);\n    expect(page.rootInstance.submenuTriggerFor).not.toBeUndefined();\n\n    const element = await document.getElementById(\"test-menu-item\");\n\n    await element.click();\n\n    await page.waitForChanges();\n\n    await page.rootInstance.handleClick;\n  });\n\n  it(\"should prevent default action on click if variant is 'toggle'\", async () => {\n    const page = await newSpecPage({\n      components: [MenuItem],\n      html: `<ic-menu-item\n      id=\"test-menu-item\"\n            label=\"I emit an event\"\n            variant=\"toggle\"\n          />`,\n    });\n\n    const eventSpy = jest.fn();\n\n    const mockEvent = {\n      preventDefault: eventSpy,\n    };\n\n    await page.rootInstance.handleClick(mockEvent as unknown as MouseEvent);\n\n    expect(eventSpy).toHaveBeenCalled();\n  });\n});\n"]}

package/dist/collection/components/ic-navigation-button/ic-navigation-button.css

@@ -450,3 +450,7 @@ video {
 :host(.in-side-menu) {
   margin-right: 0;
 }
+
+:host::part(button) {
+  height: 100%;
+}