@esri/calcite-components 1.4.0 → 1.4.1-next.1

package/dist/extras/docs-json.json

@@ -1,5 +1,5 @@
 {
-  "timestamp": "2023-05-22T22:12:39",
+  "timestamp": "2023-05-24T16:56:36",
   "compiler": {
     "name": "@stencil/core",
     "version": "2.22.3",
@@ -14014,7 +14014,12 @@
       "tag": "calcite-menu-item",
       "readme": "# calcite-menu-item\n",
       "docs": "",
-      "docsTags": [],
+      "docsTags": [
+        {
+          "name": "slot",
+          "text": "submenu-item - A slot for adding `calcite-menu-item`s in a submenu."
+        }
+      ],
       "usage": {},
       "props": [
         {
@@ -14267,7 +14272,12 @@
         }
       ],
       "styles": [],
-      "slots": [],
+      "slots": [
+        {
+          "name": "submenu-item",
+          "docs": "A slot for adding `calcite-menu-item`s in a submenu."
+        }
+      ],
       "parts": [],
       "dependents": [],
       "dependencies": [
@@ -14732,7 +14742,44 @@
       "tag": "calcite-navigation",
       "readme": "# calcite-navigation\n",
       "docs": "",
-      "docsTags": [],
+      "docsTags": [
+        {
+          "name": "slot",
+          "text": "logo - A slot for adding a `calcite-logo` component to the primary navigation level."
+        },
+        {
+          "name": "slot",
+          "text": "user - A slot for adding a `calcite-user` component to the primary navigation level."
+        },
+        {
+          "name": "slot",
+          "text": "progress - A slot for adding a `calcite-progress` component to the primary navigation level."
+        },
+        {
+          "name": "slot",
+          "text": "navigation-action - A slot for adding a `calcite-action` component to the primary navigation level."
+        },
+        {
+          "name": "slot",
+          "text": "content-start - A slot for adding a `calcite-menu`, `calcite-action`, or other interactive elements in the start position of any navigation level."
+        },
+        {
+          "name": "slot",
+          "text": "content-center - A slot for adding a `calcite-menu`, `calcite-action`, or other interactive elements in the center position of the primary navigation level."
+        },
+        {
+          "name": "slot",
+          "text": "content-end - A slot for adding a `calcite-menu`, `calcite-action`, or other interactive elements in the end position of any navigation level."
+        },
+        {
+          "name": "slot",
+          "text": "navigation-secondary - A slot for adding a `calcite-navigation` component in the secondary navigation level. Components rendered here will not display `calcite-navigation-logo` or `calcite-navigation-user` components."
+        },
+        {
+          "name": "slot",
+          "text": "navigation-tertiary - A slot for adding a `calcite-navigation` component in the tertiary navigation level.  Components rendered here will not display `calcite-navigation-logo` or `calcite-navigation-user` components."
+        }
+      ],
       "usage": {
         "Basic": "```html\n<calcite-shell>\n  <calcite-navigation slot=\"header\">\n    <calcite-chip-group slot=\"content-center\">\n      <calcite-chip>nav item 1</calcite-chip>\n      <calcite-chip>nav item 2</calcite-chip>\n      <calcite-chip>nav item 3</calcite-chip>\n    </calcite-chip-group>\n  </calcite-navigation>\n</calcite-shell>\n```\n"
       },
@@ -14813,7 +14860,44 @@
           "docs": "Specifies the width of the component's content area."
         }
       ],
-      "slots": [],
+      "slots": [
+        {
+          "name": "content-center",
+          "docs": "A slot for adding a `calcite-menu`, `calcite-action`, or other interactive elements in the center position of the primary navigation level."
+        },
+        {
+          "name": "content-end",
+          "docs": "A slot for adding a `calcite-menu`, `calcite-action`, or other interactive elements in the end position of any navigation level."
+        },
+        {
+          "name": "content-start",
+          "docs": "A slot for adding a `calcite-menu`, `calcite-action`, or other interactive elements in the start position of any navigation level."
+        },
+        {
+          "name": "logo",
+          "docs": "A slot for adding a `calcite-logo` component to the primary navigation level."
+        },
+        {
+          "name": "navigation-action",
+          "docs": "A slot for adding a `calcite-action` component to the primary navigation level."
+        },
+        {
+          "name": "navigation-secondary",
+          "docs": "A slot for adding a `calcite-navigation` component in the secondary navigation level. Components rendered here will not display `calcite-navigation-logo` or `calcite-navigation-user` components."
+        },
+        {
+          "name": "navigation-tertiary",
+          "docs": "A slot for adding a `calcite-navigation` component in the tertiary navigation level.  Components rendered here will not display `calcite-navigation-logo` or `calcite-navigation-user` components."
+        },
+        {
+          "name": "progress",
+          "docs": "A slot for adding a `calcite-progress` component to the primary navigation level."
+        },
+        {
+          "name": "user",
+          "docs": "A slot for adding a `calcite-user` component to the primary navigation level."
+        }
+      ],
       "parts": [],
       "dependents": [],
       "dependencies": [

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
+ * v1.4.1-next.1
  */
 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
+ * v1.4.1-next.1
  */
 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
+ * v1.4.1-next.1
  */
 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
+ * v1.4.1-next.1
  */
 (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/color-picker/color-picker.d.ts

@@ -36,14 +36,12 @@ export declare class ColorPicker implements InteractiveComponent, LoadableCompon
    * The format of `value`.
    *
    * When `"auto"`, the format will be inferred from `value` when set.
-   *
    * @default "auto"
    */
   format: Format;
   handleFormatChange(format: Format): void;
   /**
    * When `true`, hides the RGB/HSV channel inputs.
-   *
    * @deprecated use `channelsDisabled` instead
    */
   hideChannels: boolean;
@@ -51,13 +49,11 @@ export declare class ColorPicker implements InteractiveComponent, LoadableCompon
   hexDisabled: boolean;
   /**
    * When `true`, hides the hex input.
-   *
    * @deprecated use `hexDisabled` instead
    */
   hideHex: boolean;
   /**
    * When `true`, hides the saved colors section.
-   *
    * @deprecated use `savedDisabled` instead
    */
   hideSaved: boolean;
@@ -79,7 +75,6 @@ export declare class ColorPicker implements InteractiveComponent, LoadableCompon
    * The component's value, where the value can be a CSS color string, or a RGB, HSL or HSV object.
    *
    * The type will be preserved as the color is updated.
-   *
    * @default "#007ac2"
    * @see [CSS Color](https://developer.mozilla.org/en-US/docs/Web/CSS/color)
    * @see [ColorValue](https://github.com/Esri/calcite-components/blob/master/src/components/color-picker/interfaces.ts#L10)

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

@@ -1,12 +1,11 @@
 import { Event, EventEmitter, VNode } from "../../stencil-public-runtime";
-import { Scale, Status } from "../interfaces";
+import { Scale, Status, Position } from "../interfaces";
 import { FormComponent } from "../../utils/form";
 import { InteractiveComponent } from "../../utils/interactive";
 import { LabelableComponent } from "../../utils/label";
 import { LoadableComponent } from "../../utils/loadable";
 import { LocalizedComponent, NumberingSystem } from "../../utils/locale";
 import { T9nComponent } from "../../utils/t9n";
-import { Position } from "../interfaces";
 import { InputMessages } from "./assets/input/t9n";
 import { InputPlacement, NumberNudgeDirection } from "./interfaces";
 /**

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

@@ -1,9 +1,11 @@
+import { VNode } from "../../stencil-public-runtime";
 import { LoadableComponent } from "../../utils/loadable";
 import { LocalizedComponent } from "../../utils/locale";
 import { T9nComponent } from "../../utils/t9n";
 import { MenuMessages } from "./assets/menu/t9n";
+import { GlobalAttrComponent } from "../../utils/globalAttributes";
 type Layout = "horizontal" | "vertical";
-export declare class CalciteMenu implements LocalizedComponent, T9nComponent, LoadableComponent {
+export declare class CalciteMenu implements GlobalAttrComponent, LocalizedComponent, T9nComponent, LoadableComponent {
   el: HTMLCalciteMenuElement;
   /**
    * Accessible name for the component.
@@ -25,16 +27,12 @@ export declare class CalciteMenu implements LocalizedComponent, T9nComponent, Lo
    * @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;
+  globalAttributes: {
+    role: string;
+  };
   menuItems: HTMLCalciteMenuItemElement[];
   connectedCallback(): void;
   componentWillLoad(): Promise<void>;
@@ -46,6 +44,6 @@ export declare class CalciteMenu implements LocalizedComponent, T9nComponent, Lo
   handleMenuSlotChange: (event: Event) => void;
   focusParentElement(el: HTMLCalciteMenuItemElement): void;
   setMenuItemLayout(items: HTMLCalciteMenuItemElement[], layout: Layout): void;
-  render(): any;
+  render(): VNode;
 }
 export {};

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

@@ -7,6 +7,9 @@ import { T9nComponent } from "../../utils/t9n";
 import { MenuItemMessages } from "./assets/menu-item/t9n";
 import { LocalizedComponent } from "../../utils/locale";
 type Layout = "horizontal" | "vertical";
+/**
+ * @slot submenu-item - A slot for adding `calcite-menu-item`s in a submenu.
+ */
 export declare class CalciteMenuItem implements LoadableComponent, T9nComponent, LocalizedComponent {
   el: HTMLCalciteMenuItemElement;
   /** When `true`, the component is highlighted. */

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

@@ -1,5 +1,16 @@
 import { EventEmitter, VNode } from "../../stencil-public-runtime";
 import { LoadableComponent } from "../../utils/loadable";
+/**
+ * @slot logo - A slot for adding a `calcite-logo` component to the primary navigation level.
+ * @slot user - A slot for adding a `calcite-user` component to the primary navigation level.
+ * @slot progress - A slot for adding a `calcite-progress` component to the primary navigation level.
+ * @slot navigation-action - A slot for adding a `calcite-action` component to the primary navigation level.
+ * @slot content-start - A slot for adding a `calcite-menu`, `calcite-action`, or other interactive elements in the start position of any navigation level.
+ * @slot content-center - A slot for adding a `calcite-menu`, `calcite-action`, or other interactive elements in the center position of the primary navigation level.
+ * @slot content-end - A slot for adding a `calcite-menu`, `calcite-action`, or other interactive elements in the end position of any navigation level.
+ * @slot navigation-secondary - A slot for adding a `calcite-navigation` component in the secondary navigation level. Components rendered here will not display `calcite-navigation-logo` or `calcite-navigation-user` components.
+ * @slot navigation-tertiary - A slot for adding a `calcite-navigation` component in the tertiary navigation level.  Components rendered here will not display `calcite-navigation-logo` or `calcite-navigation-user` components.
+ */
 export declare class CalciteNavigation implements LoadableComponent {
   el: HTMLCalciteNavigationElement;
   /**

package/dist/types/components/navigation-logo/navigation-logo.d.ts

@@ -10,7 +10,6 @@ export declare class CalciteNavigationLogo implements LoadableComponent {
   label: string;
   /**
    * Defines the relationship between the `href` value and the current document.
-   *
    * @mdn [rel](https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/rel)
    */
   rel: string;
@@ -18,7 +17,6 @@ export declare class CalciteNavigationLogo implements LoadableComponent {
   description: string;
   /**
    * Specifies where to open the linked document defined in the `href` property.
-   *
    * @mdn [target](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/a#attr-target)
    */
   target: string;

package/dist/types/components/navigation-logo/resources.d.ts

@@ -2,4 +2,6 @@ export declare const CSS: {
   container: string;
   heading: string;
   description: string;
+  anchor: string;
+  image: string;
 };

package/dist/types/components/navigation-user/resources.d.ts

@@ -2,4 +2,5 @@ export declare const CSS: {
   textContainer: string;
   fullName: string;
   username: string;
+  button: string;
 };

package/dist/types/components.d.ts

@@ -2546,10 +2546,6 @@ export namespace Components {
           * Made into a prop for testing purposes only.
          */
         "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.
-         */
-        "role": string;
         /**
           * Sets focus on the component's first focusable element.
          */

package/dist/types/utils/globalAttributes.d.ts

@@ -13,9 +13,9 @@ export interface GlobalAttrComponent {
    */
   readonly el: HTMLElement;
   /**
-   * The watched attributes object.
-   * Should be stateful.
-   * '@State() inheritedAttributes = {};'
+   * The object that stores global attributes to apply internally during rendering.
+   *
+   * This prop should use the `@State` decorator.
    */
   globalAttributes: AttributeObject;
 }
@@ -23,17 +23,16 @@ export interface GlobalAttrComponent {
  * Helper to set up listening for changes to global attributes.
  *
  * render(): VNode {
- *   const lang = this.inheritedAttributes['lang'] ?? 'en';
- *   return <div>My lang is {lang}</div>;
+ * return (<Host>
+ * <ul {...this.globalAttributes}></div>
+ * </Host>);
  * }
- *
  * @param component
  * @param attributeFilter
  */
 export declare function watchGlobalAttributes(component: GlobalAttrComponent, attributeFilter: AllowedGlobalAttribute[]): void;
 /**
  * Helper remove listening for changes to inherited attributes.
- *
  * @param component
  */
 export declare function unwatchGlobalAttributes(component: GlobalAttrComponent): void;

package/dist/types/utils/t9n.d.ts

@@ -3,7 +3,6 @@ export type MessageBundle = Record<string, string>;
 export declare const componentLangToMessageBundleCache: Record<string, Promise<MessageBundle>>;
 /**
  * This utility sets up the messages used by the component. It should be awaited in the `componentWillLoad` lifecycle hook.
- *
  * @param component
  */
 export declare function setUpMessages(component: T9nComponent): Promise<void>;
@@ -14,7 +13,6 @@ export declare function setUpMessages(component: T9nComponent): Promise<void>;
  *
  * 1. called from `LocalizedComponent`'s `onLocaleChange` method or
  * 2. called from a watcher configured to watch `LocalizedComponent`'s `effectiveLocale` prop
- *
  * @param component
  * @param lang
  */
@@ -25,7 +23,6 @@ export declare function updateMessages(component: T9nComponent, lang: string): P
  * It needs to be called in `connectedCallback`
  *
  * **Note**: this must be called after `LocalizedComponent`'s `connectLocalized` method.
- *
  * @param component
  */
 export declare function connectMessages(component: T9nComponent): void;
@@ -33,7 +30,6 @@ export declare function connectMessages(component: T9nComponent): void;
  * This utility tears down internals for messages support.
  *
  * It needs to be called in `disconnectedCallback`
- *
  * @param component
  */
 export declare function disconnectMessages(component: T9nComponent): void;
@@ -67,7 +63,6 @@ export interface T9nComponent extends LocalizedComponent {
    * This private method ensures messages are kept in sync.
    *
    * This method should be empty and configured to watch for changes on  `messageOverrides` property.
-   *
    * @Watch("messageOverrides")
    * onMessagesChange(): void {
    *  \/* wired up by t9n util *\/