@esri/calcite-components 1.4.0-next.13 → 1.4.0-next.15

package/dist/extras/docs-json.json

@@ -1,5 +1,5 @@
 {
-  "timestamp": "2023-05-12T01:22:34",
+  "timestamp": "2023-05-12T22:40:34",
   "compiler": {
     "name": "@stencil/core",
     "version": "2.22.3",
@@ -652,6 +652,7 @@
         "calcite-action-pad",
         "calcite-flow-item",
         "calcite-list-item",
+        "calcite-menu-item",
         "calcite-panel",
         "calcite-pick-list-item",
         "calcite-popover",
@@ -685,6 +686,9 @@
         "calcite-list-item": [
           "calcite-action"
         ],
+        "calcite-menu-item": [
+          "calcite-action"
+        ],
         "calcite-panel": [
           "calcite-action"
         ],
@@ -8729,6 +8733,7 @@
         "calcite-input-time-picker",
         "calcite-link",
         "calcite-list-item",
+        "calcite-menu-item",
         "calcite-modal",
         "calcite-notice",
         "calcite-pagination",
@@ -8810,6 +8815,9 @@
         "calcite-list-item": [
           "calcite-icon"
         ],
+        "calcite-menu-item": [
+          "calcite-icon"
+        ],
         "calcite-modal": [
           "calcite-icon"
         ],
@@ -13877,6 +13885,382 @@
         ]
       }
     },
+    {
+      "filePath": "./src/components/menu/menu.tsx",
+      "encapsulation": "shadow",
+      "tag": "calcite-menu",
+      "readme": "# calcite-nav-menu\n",
+      "docs": "",
+      "docsTags": [],
+      "usage": {},
+      "props": [
+        {
+          "name": "label",
+          "type": "string",
+          "mutable": false,
+          "attr": "label",
+          "reflectToAttr": false,
+          "docs": "Accessible name for the component.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": true
+        },
+        {
+          "name": "layout",
+          "type": "\"horizontal\" | \"vertical\"",
+          "mutable": false,
+          "attr": "layout",
+          "reflectToAttr": true,
+          "docs": "Specifies the layout of the component.",
+          "docsTags": [],
+          "default": "\"horizontal\"",
+          "values": [
+            {
+              "value": "horizontal",
+              "type": "string"
+            },
+            {
+              "value": "vertical",
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false
+        },
+        {
+          "name": "messageOverrides",
+          "type": "{ more?: string; }",
+          "mutable": true,
+          "reflectToAttr": false,
+          "docs": "Use this property to override individual strings used by the component.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "{ more?: string; }"
+            }
+          ],
+          "optional": false,
+          "required": false
+        }
+      ],
+      "methods": [
+        {
+          "name": "setFocus",
+          "returns": {
+            "type": "Promise<void>",
+            "docs": ""
+          },
+          "signature": "setFocus() => Promise<void>",
+          "parameters": [],
+          "docs": "Sets focus on the component's first focusable element.",
+          "docsTags": []
+        }
+      ],
+      "events": [],
+      "listeners": [
+        {
+          "event": "calciteInternalMenuItemKeyEvent",
+          "capture": false,
+          "passive": false
+        }
+      ],
+      "styles": [],
+      "slots": [],
+      "parts": [],
+      "dependents": [
+        "calcite-menu-item"
+      ],
+      "dependencies": [],
+      "dependencyGraph": {
+        "calcite-menu-item": [
+          "calcite-menu"
+        ]
+      }
+    },
+    {
+      "filePath": "./src/components/menu-item/menu-item.tsx",
+      "encapsulation": "shadow",
+      "tag": "calcite-menu-item",
+      "readme": "# calcite-nav-menu-item\n",
+      "docs": "",
+      "docsTags": [],
+      "usage": {},
+      "props": [
+        {
+          "name": "active",
+          "type": "boolean",
+          "mutable": false,
+          "attr": "active",
+          "reflectToAttr": true,
+          "docs": "When `true`, the component is highlighted.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "boolean"
+            }
+          ],
+          "optional": false,
+          "required": false
+        },
+        {
+          "name": "breadcrumb",
+          "type": "boolean",
+          "mutable": false,
+          "attr": "breadcrumb",
+          "reflectToAttr": true,
+          "docs": "When `true`, the component displays a breadcrumb trail for use as a navigational aid.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "boolean"
+            }
+          ],
+          "optional": false,
+          "required": false
+        },
+        {
+          "name": "href",
+          "type": "string",
+          "mutable": false,
+          "attr": "href",
+          "reflectToAttr": false,
+          "docs": "Specifies the URL destination of the component, which can be set as an absolute or relative path.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false
+        },
+        {
+          "name": "iconEnd",
+          "type": "string",
+          "mutable": false,
+          "attr": "icon-end",
+          "reflectToAttr": true,
+          "docs": "Specifies an icon to display at the end of the component.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false
+        },
+        {
+          "name": "iconFlipRtl",
+          "type": "\"both\" | \"end\" | \"start\"",
+          "mutable": false,
+          "attr": "icon-flip-rtl",
+          "reflectToAttr": true,
+          "docs": "Displays the `iconStart` and/or `iconEnd` as flipped when the element direction is right-to-left (`\"rtl\"`).",
+          "docsTags": [],
+          "values": [
+            {
+              "value": "both",
+              "type": "string"
+            },
+            {
+              "value": "end",
+              "type": "string"
+            },
+            {
+              "value": "start",
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false
+        },
+        {
+          "name": "iconStart",
+          "type": "string",
+          "mutable": false,
+          "attr": "icon-start",
+          "reflectToAttr": true,
+          "docs": "Specifies an icon to display at the start of the component.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false
+        },
+        {
+          "name": "label",
+          "type": "string",
+          "mutable": false,
+          "attr": "label",
+          "reflectToAttr": false,
+          "docs": "Accessible name for the component.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": true
+        },
+        {
+          "name": "messageOverrides",
+          "type": "{ submenu?: string; open?: string; }",
+          "mutable": true,
+          "reflectToAttr": false,
+          "docs": "Use this property to override individual strings used by the component.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "{ submenu?: string; open?: string; }"
+            }
+          ],
+          "optional": false,
+          "required": false
+        },
+        {
+          "name": "open",
+          "type": "boolean",
+          "mutable": true,
+          "attr": "open",
+          "reflectToAttr": true,
+          "docs": "When `true`, the component will display any slotted `calcite-menu-item` in an open overflow menu.",
+          "docsTags": [],
+          "default": "false",
+          "values": [
+            {
+              "type": "boolean"
+            }
+          ],
+          "optional": false,
+          "required": false
+        },
+        {
+          "name": "rel",
+          "type": "string",
+          "mutable": false,
+          "attr": "rel",
+          "reflectToAttr": true,
+          "docs": "Defines the relationship between the `href` value and the current document.",
+          "docsTags": [
+            {
+              "name": "mdn",
+              "text": "[rel](https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/rel)"
+            }
+          ],
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false
+        },
+        {
+          "name": "target",
+          "type": "string",
+          "mutable": false,
+          "attr": "target",
+          "reflectToAttr": true,
+          "docs": "Specifies where to open the linked document defined in the `href` property.",
+          "docsTags": [
+            {
+              "name": "mdn",
+              "text": "[target](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/a#attr-target)"
+            }
+          ],
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false
+        },
+        {
+          "name": "text",
+          "type": "string",
+          "mutable": false,
+          "attr": "text",
+          "reflectToAttr": false,
+          "docs": "Specifies the text to display.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false
+        }
+      ],
+      "methods": [
+        {
+          "name": "setFocus",
+          "returns": {
+            "type": "Promise<void>",
+            "docs": ""
+          },
+          "signature": "setFocus() => Promise<void>",
+          "parameters": [],
+          "docs": "Sets focus on the component.",
+          "docsTags": []
+        }
+      ],
+      "events": [
+        {
+          "event": "calciteMenuItemSelect",
+          "detail": "void",
+          "bubbles": true,
+          "cancelable": true,
+          "composed": true,
+          "docs": "Emits when the component is selected.",
+          "docsTags": []
+        }
+      ],
+      "listeners": [
+        {
+          "event": "click",
+          "target": "window",
+          "capture": false,
+          "passive": false
+        },
+        {
+          "event": "focusout",
+          "capture": false,
+          "passive": false
+        }
+      ],
+      "styles": [],
+      "slots": [],
+      "parts": [],
+      "dependents": [],
+      "dependencies": [
+        "calcite-icon",
+        "calcite-action",
+        "calcite-menu"
+      ],
+      "dependencyGraph": {
+        "calcite-menu-item": [
+          "calcite-icon",
+          "calcite-action",
+          "calcite-menu"
+        ],
+        "calcite-action": [
+          "calcite-loader",
+          "calcite-icon"
+        ]
+      }
+    },
     {
       "filePath": "./src/components/modal/modal.tsx",
       "encapsulation": "shadow",

package/dist/extras/vscode-data.json

@@ -3853,6 +3853,95 @@
         }
       ]
     },
+    {
+      "name": "calcite-menu",
+      "description": {
+        "kind": "markdown",
+        "value": ""
+      },
+      "attributes": [
+        {
+          "name": "label",
+          "description": "Accessible name for the component."
+        },
+        {
+          "name": "layout",
+          "description": "Specifies the layout of the component.",
+          "values": [
+            {
+              "name": "horizontal"
+            },
+            {
+              "name": "vertical"
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "name": "calcite-menu-item",
+      "description": {
+        "kind": "markdown",
+        "value": ""
+      },
+      "attributes": [
+        {
+          "name": "active",
+          "description": "When `true`, the component is highlighted."
+        },
+        {
+          "name": "breadcrumb",
+          "description": "When `true`, the component displays a breadcrumb trail for use as a navigational aid."
+        },
+        {
+          "name": "href",
+          "description": "Specifies the URL destination of the component, which can be set as an absolute or relative path."
+        },
+        {
+          "name": "icon-end",
+          "description": "Specifies an icon to display at the end of the component."
+        },
+        {
+          "name": "icon-flip-rtl",
+          "description": "Displays the `iconStart` and/or `iconEnd` as flipped when the element direction is right-to-left (`\"rtl\"`).",
+          "values": [
+            {
+              "name": "both"
+            },
+            {
+              "name": "end"
+            },
+            {
+              "name": "start"
+            }
+          ]
+        },
+        {
+          "name": "icon-start",
+          "description": "Specifies an icon to display at the start of the component."
+        },
+        {
+          "name": "label",
+          "description": "Accessible name for the component."
+        },
+        {
+          "name": "open",
+          "description": "When `true`, the component will display any slotted `calcite-menu-item` in an open overflow menu."
+        },
+        {
+          "name": "rel",
+          "description": "Defines the relationship between the `href` value and the current document."
+        },
+        {
+          "name": "target",
+          "description": "Specifies where to open the linked document defined in the `href` property."
+        },
+        {
+          "name": "text",
+          "description": "Specifies the text to display."
+        }
+      ]
+    },
     {
       "name": "calcite-modal",
       "description": {

package/dist/loader/cdn.js

@@ -1,7 +1,7 @@
 /*!
  * All material copyright ESRI, All Rights Reserved, unless otherwise specified.
  * See https://github.com/Esri/calcite-components/blob/master/LICENSE.md for details.
- * v1.4.0-next.13
+ * v1.4.0-next.15
  */
 module.exports = require('../cjs/loader.cjs.js');
 module.exports.applyPolyfills = function() { return Promise.resolve() };

package/dist/loader/index.cjs.js

@@ -1,7 +1,7 @@
 /*!
  * All material copyright ESRI, All Rights Reserved, unless otherwise specified.
  * See https://github.com/Esri/calcite-components/blob/master/LICENSE.md for details.
- * v1.4.0-next.13
+ * v1.4.0-next.15
  */
 module.exports = require('../cjs/loader.cjs.js');
 module.exports.applyPolyfills = function() { return Promise.resolve() };

package/dist/loader/index.es2017.js

@@ -1,7 +1,7 @@
 /*!
  * All material copyright ESRI, All Rights Reserved, unless otherwise specified.
  * See https://github.com/Esri/calcite-components/blob/master/LICENSE.md for details.
- * v1.4.0-next.13
+ * v1.4.0-next.15
  */
 export * from '../esm/polyfills/index.js';
 export * from '../esm/loader.js';

package/dist/loader/index.js

@@ -1,7 +1,7 @@
 /*!
  * All material copyright ESRI, All Rights Reserved, unless otherwise specified.
  * See https://github.com/Esri/calcite-components/blob/master/LICENSE.md for details.
- * v1.4.0-next.13
+ * v1.4.0-next.15
  */
 (function(){if("undefined"!==typeof window&&void 0!==window.Reflect&&void 0!==window.customElements){var a=HTMLElement;window.HTMLElement=function(){return Reflect.construct(a,[],this.constructor)};HTMLElement.prototype=a.prototype;HTMLElement.prototype.constructor=HTMLElement;Object.setPrototypeOf(HTMLElement,a)}})();
 export * from '../esm/polyfills/index.js';

package/dist/types/components/menu/assets/menu/t9n/index.d.ts

@@ -0,0 +1,3 @@
+export type MenuMessages = {
+  more: string;
+};

package/dist/types/components/menu/menu.d.ts

@@ -0,0 +1,51 @@
+import { LoadableComponent } from "../../utils/loadable";
+import { LocalizedComponent } from "../../utils/locale";
+import { T9nComponent } from "../../utils/t9n";
+import { MenuMessages } from "./assets/menu/t9n";
+type Layout = "horizontal" | "vertical";
+export declare class CalciteMenu implements LocalizedComponent, T9nComponent, LoadableComponent {
+  el: HTMLCalciteMenuElement;
+  /**
+   * Accessible name for the component.
+   */
+  label: string;
+  /**
+   * Specifies the layout of the component.
+   */
+  layout: Layout;
+  handleLayoutChange(value: Layout): void;
+  /**
+   * Use this property to override individual strings used by the component.
+   */
+  messageOverrides: Partial<MenuMessages>;
+  onMessagesChange(): void;
+  /**
+   * Made into a prop for testing purposes only.
+   *
+   * @internal
+   */
+  messages: MenuMessages;
+  /**
+   * Specifies the role of `menu` component. Marked as internal for parsing the role attribute in `menu-item` component shadowDOM.
+   * This property falls outside of the `globalAttribute` interface pattern because it is immutable and has a default value.
+   * @internal
+   *
+   */
+  role: string;
+  defaultMessages: MenuMessages;
+  effectiveLocale: string;
+  effectiveLocaleChange(): void;
+  menuItems: HTMLCalciteMenuItemElement[];
+  connectedCallback(): void;
+  componentWillLoad(): Promise<void>;
+  componentDidLoad(): void;
+  disconnectedCallback(): void;
+  /** Sets focus on the component's first focusable element. */
+  setFocus(): Promise<void>;
+  calciteInternalNavMenuItemKeyEvent(event: CustomEvent): void;
+  handleMenuSlotChange: (event: Event) => void;
+  focusParentElement(el: HTMLCalciteMenuItemElement): void;
+  setMenuItemLayout(items: HTMLCalciteMenuItemElement[], layout: Layout): void;
+  render(): any;
+}
+export {};

package/dist/types/components/menu-item/interfaces.d.ts

@@ -0,0 +1,5 @@
+export interface MenuItemCustomEvent {
+  event: KeyboardEvent;
+  children?: HTMLCalciteMenuItemElement[];
+  isSubmenuOpen?: boolean;
+}