@esri/calcite-components 1.0.0-next.452 → 1.0.0-next.455

package/dist/extras/docs-json.json

@@ -1,5 +1,5 @@
 {
-  "timestamp": "2022-04-30T22:19:26",
+  "timestamp": "2022-05-04T16:22:30",
   "compiler": {
     "name": "@stencil/core",
     "version": "2.15.1",
@@ -19718,11 +19718,11 @@
       "docsTags": [
         {
           "name": "slot",
-          "text": "- A slot for adding `calcite-value-list-item` elements. Items are displayed as a vertical list."
+          "text": "- A slot for adding calcite-value-list-item elements. List items are displayed as a vertical list."
         },
         {
           "name": "slot",
-          "text": "menu-actions - A slot for adding a button + menu combo for performing actions like sorting."
+          "text": "menu-actions - A slot for adding a button and menu combination for performing actions, such as sorting."
         }
       ],
       "usage": {
@@ -19737,7 +19737,7 @@
           "mutable": false,
           "attr": "disabled",
           "reflectToAttr": true,
-          "docs": "When true, disabled prevents interaction. This state shows items with lower opacity/grayed.",
+          "docs": "When true, prevents user interaction. This state shows list items grayed out and with lower opacity.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -19754,7 +19754,7 @@
           "mutable": false,
           "attr": "drag-enabled",
           "reflectToAttr": true,
-          "docs": "When true, the items will be sortable via drag and drop.",
+          "docs": "When true, list items are sortable via a draggable button.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -19771,7 +19771,7 @@
           "mutable": false,
           "attr": "filter-enabled",
           "reflectToAttr": true,
-          "docs": "When true, an input appears at the top of the list that can be used by end users to filter items in the list.",
+          "docs": "When true, an input appears at the top of the list that can be used by end users to filter list items.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -19788,7 +19788,7 @@
           "mutable": false,
           "attr": "filter-placeholder",
           "reflectToAttr": true,
-          "docs": "Placeholder text for the filter input field.",
+          "docs": "Placeholder text for the filter's input field.",
           "docsTags": [],
           "values": [
             {
@@ -19837,7 +19837,7 @@
           "mutable": false,
           "attr": "multiple",
           "reflectToAttr": true,
-          "docs": "Multiple Works similar to standard radio buttons and checkboxes.\nWhen true, a user can select multiple items at a time.\nWhen false, only a single item can be selected at a time\nand selecting a new item will deselect any other selected items.",
+          "docs": "Similar to standard radio buttons and checkboxes.\nWhen true, a user can select multiple list items at a time.\nWhen false, only a single list item can be selected at a time,\nand selecting a new list item will deselect any other selected list items.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -19854,7 +19854,7 @@
           "mutable": false,
           "attr": "selection-follows-focus",
           "reflectToAttr": false,
-          "docs": "When true and single-selection is enabled, the selection will change when navigating items via the keyboard.",
+          "docs": "When true and single-selection is enabled, the selection changes when navigating list items via the keyboard.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -19897,7 +19897,7 @@
           "bubbles": true,
           "cancelable": true,
           "composed": true,
-          "docs": "Emitted when any of the item selections have changed.",
+          "docs": "Emits when any of the list item selections have changed.",
           "docsTags": []
         },
         {
@@ -19906,7 +19906,7 @@
           "bubbles": true,
           "cancelable": true,
           "composed": true,
-          "docs": "Emitted when the order of the list has changed.",
+          "docs": "Emits when the order of the list has changed.",
           "docsTags": []
         }
       ],
@@ -19941,11 +19941,11 @@
       "slots": [
         {
           "name": "",
-          "docs": "A slot for adding `calcite-value-list-item` elements. Items are displayed as a vertical list."
+          "docs": "A slot for adding calcite-value-list-item elements. List items are displayed as a vertical list."
         },
         {
           "name": "menu-actions",
-          "docs": "A slot for adding a button + menu combo for performing actions like sorting."
+          "docs": "A slot for adding a button and menu combination for performing actions, such as sorting."
         }
       ],
       "parts": [],
@@ -19995,7 +19995,7 @@
           "mutable": false,
           "attr": "description",
           "reflectToAttr": true,
-          "docs": "An optional description for this item. Will appear below the label text.",
+          "docs": "An optional description for the list item that displays below the label text.",
           "docsTags": [],
           "values": [
             {
@@ -20011,7 +20011,7 @@
           "mutable": false,
           "attr": "disabled",
           "reflectToAttr": true,
-          "docs": "When true, the item cannot be clicked and is visually muted",
+          "docs": "When true, the list item cannot be clicked and is visually muted.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -20056,7 +20056,7 @@
           "mutable": false,
           "attr": "label",
           "reflectToAttr": true,
-          "docs": "The main label for this item. Appears next to the icon.",
+          "docs": "The main label for the list item. Appears next to the icon.",
           "docsTags": [],
           "values": [
             {
@@ -20071,7 +20071,7 @@
           "type": "{ [x: string]: unknown; }",
           "mutable": false,
           "reflectToAttr": false,
-          "docs": "Used to provide additional metadata to an item, primarily used when the parent list has a filter.",
+          "docs": "Provides additional metadata to a list item. Primary use is for a filter on the parent list.",
           "docsTags": [],
           "values": [
             {
@@ -20104,7 +20104,7 @@
           "mutable": false,
           "attr": "removable",
           "reflectToAttr": true,
-          "docs": "Set this to true to display a remove action that removes the item from the list.",
+          "docs": "When true, adds an action to remove the list item.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -20121,7 +20121,7 @@
           "mutable": true,
           "attr": "selected",
           "reflectToAttr": true,
-          "docs": "Set this to true to pre-select an item. Toggles when an item is checked/unchecked.",
+          "docs": "When true, preselects the list item. Toggles when an item is checked/unchecked.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -20138,7 +20138,7 @@
           "mutable": false,
           "attr": "value",
           "reflectToAttr": false,
-          "docs": "The item's associated value.",
+          "docs": "The list item's associated value.",
           "docsTags": [],
           "values": [
             {
@@ -20158,7 +20158,7 @@
           },
           "signature": "setFocus() => Promise<void>",
           "parameters": [],
-          "docs": "Sets focus on the component.",
+          "docs": "Set focus on the component.",
           "docsTags": []
         },
         {
@@ -20169,7 +20169,7 @@
           },
           "signature": "toggleSelected(coerce?: boolean) => Promise<void>",
           "parameters": [],
-          "docs": "Used to toggle the selection state. By default this won't trigger an event.\nThe first argument allows the value to be coerced, rather than swapping values.",
+          "docs": "Toggle the selection state. By default this won't trigger an event.\nThe first argument allows the value to be coerced, rather than swapping values.",
           "docsTags": []
         }
       ],
@@ -20180,7 +20180,7 @@
           "bubbles": true,
           "cancelable": true,
           "composed": true,
-          "docs": "Emitted whenever the remove button is pressed.",
+          "docs": "Emits when the remove button is pressed.",
           "docsTags": []
         }
       ],

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.0.0-next.452
+ * v1.0.0-next.455
  */
 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.0.0-next.452
+ * v1.0.0-next.455
  */
 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.0.0-next.452
+ * v1.0.0-next.455
  */
 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.0.0-next.452
+ * v1.0.0-next.455
  */
 (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/action-menu/action-menu.d.ts

@@ -1,4 +1,4 @@
-import { EventEmitter } from "../../stencil-public-runtime";
+import { Event, EventEmitter } from "../../stencil-public-runtime";
 import { VNode } from "../../stencil-public-runtime";
 import { PopperPlacement, OverlayPositioning, ComputedPlacement } from "../../utils/popper";
 import { Scale } from "../interfaces";
@@ -54,6 +54,7 @@ export declare class ActionMenu implements ConditionalSlotComponent {
   guid: string;
   menuId: string;
   menuButtonId: string;
+  tooltipEl: HTMLCalciteTooltipElement;
   activeMenuItemIndex: number;
   activeMenuItemIndexHandler(): void;
   /** Sets focus on the component. */
@@ -66,10 +67,10 @@ export declare class ActionMenu implements ConditionalSlotComponent {
   render(): VNode;
   handleCalciteActionClick: () => void;
   menuButtonClick: () => void;
+  updateTooltip: (event: Event) => void;
   setTooltipReferenceElement: () => void;
   updateAction: (action: HTMLCalciteActionElement, index: number) => void;
   updateActions: (actions: HTMLCalciteActionElement[]) => void;
-  getAssignedElements(): HTMLElement[];
   getActions: () => void;
   isValidKey(key: string, supportedKeys: string[]): boolean;
   menuButtonKeyUp: (event: KeyboardEvent) => void;

package/dist/types/components/chip/resources.d.ts

@@ -1,8 +1,9 @@
 export declare const CSS: {
   title: string;
   close: string;
-  chipImageContainer: string;
-  calciteChipIcon: string;
+  imageContainer: string;
+  chipIcon: string;
+  closeIcon: string;
 };
 export declare const TEXT: {
   close: string;

package/dist/types/components/value-list/value-list.d.ts

@@ -4,24 +4,24 @@ import { ICON_TYPES } from "./resources";
 import { ListFocusId, ItemData } from "../pick-list/shared-list-logic";
 import { InteractiveComponent } from "../../utils/interactive";
 /**
- * @slot - A slot for adding `calcite-value-list-item` elements. Items are displayed as a vertical list.
- * @slot menu-actions - A slot for adding a button + menu combo for performing actions like sorting.
+ * @slot - A slot for adding calcite-value-list-item elements. List items are displayed as a vertical list.
+ * @slot menu-actions - A slot for adding a button and menu combination for performing actions, such as sorting.
  */
 export declare class ValueList<ItemElement extends HTMLCalciteValueListItemElement = HTMLCalciteValueListItemElement> implements InteractiveComponent {
   /**
-   * When true, disabled prevents interaction. This state shows items with lower opacity/grayed.
+   * When true, prevents user interaction. This state shows list items grayed out and with lower opacity.
    */
   disabled: boolean;
   /**
-   * When true, the items will be sortable via drag and drop.
+   * When true, list items are sortable via a draggable button.
    */
   dragEnabled: boolean;
   /**
-   * When true, an input appears at the top of the list that can be used by end users to filter items in the list.
+   * When true, an input appears at the top of the list that can be used by end users to filter list items.
    */
   filterEnabled: boolean;
   /**
-   * Placeholder text for the filter input field.
+   * Placeholder text for the filter's input field.
    */
   filterPlaceholder: string;
   /**
@@ -35,14 +35,14 @@ export declare class ValueList<ItemElement extends HTMLCalciteValueListItemEleme
    */
   loading: boolean;
   /**
-   * Multiple Works similar to standard radio buttons and checkboxes.
-   * When true, a user can select multiple items at a time.
-   * When false, only a single item can be selected at a time
-   * and selecting a new item will deselect any other selected items.
+   * Similar to standard radio buttons and checkboxes.
+   * When true, a user can select multiple list items at a time.
+   * When false, only a single list item can be selected at a time,
+   * and selecting a new list item will deselect any other selected list items.
    */
   multiple: boolean;
   /**
-   * When true and single-selection is enabled, the selection will change when navigating items via the keyboard.
+   * When true and single-selection is enabled, the selection changes when navigating list items via the keyboard.
    */
   selectionFollowsFocus: boolean;
   selectedValues: Map<string, ItemElement>;
@@ -59,11 +59,11 @@ export declare class ValueList<ItemElement extends HTMLCalciteValueListItemEleme
   componentDidRender(): void;
   disconnectedCallback(): void;
   /**
-   * Emitted when any of the item selections have changed.
+   * Emits when any of the list item selections have changed.
    */
   calciteListChange: EventEmitter<Map<string, HTMLCalciteValueListItemElement>>;
   /**
-   * Emitted when the order of the list has changed.
+   * Emits when the order of the list has changed.
    */
   calciteListOrderChange: EventEmitter<any[]>;
   calciteListFocusOutHandler(event: FocusEvent): void;

package/dist/types/components/value-list-item/value-list-item.d.ts

@@ -8,15 +8,15 @@ import { InteractiveComponent } from "../../utils/interactive";
  */
 export declare class ValueListItem implements ConditionalSlotComponent, InteractiveComponent {
   /**
-   * An optional description for this item. Will appear below the label text.
+   * An optional description for the list item that displays below the label text.
    */
   description?: string;
   /**
-   * When true, the item cannot be clicked and is visually muted
+   * When true, the list item cannot be clicked and is visually muted.
    */
   disabled: boolean;
   /**
-   * @internal When false, the item cannot be deselected by user interaction.
+   * @internal When false, the list item cannot be deselected by user interaction.
    */
   disableDeselect: boolean;
   /**
@@ -24,7 +24,7 @@ export declare class ValueListItem implements ConditionalSlotComponent, Interact
    */
   nonInteractive: boolean;
   /**
-   * @internal - stores the activated state of the drag handle.
+   * @internal - Stores the activated state of the drag handle.
    */
   handleActivated?: boolean;
   /**
@@ -33,23 +33,23 @@ export declare class ValueListItem implements ConditionalSlotComponent, Interact
    */
   icon?: ICON_TYPES | null;
   /**
-   * The main label for this item. Appears next to the icon.
+   * The main label for the list item. Appears next to the icon.
    */
   label: string;
   /**
-   * Used to provide additional metadata to an item, primarily used when the parent list has a filter.
+   * Provides additional metadata to a list item. Primary use is for a filter on the parent list.
    */
   metadata?: Record<string, unknown>;
   /**
-   * Set this to true to display a remove action that removes the item from the list.
+   * When true, adds an action to remove the list item.
    */
   removable: boolean;
   /**
-   * Set this to true to pre-select an item. Toggles when an item is checked/unchecked.
+   * When true, preselects the list item. Toggles when an item is checked/unchecked.
    */
   selected: boolean;
   /**
-   * The item's associated value.
+   * The list item's associated value.
    */
   value: any;
   el: HTMLCalciteValueListItemElement;
@@ -59,14 +59,14 @@ export declare class ValueListItem implements ConditionalSlotComponent, Interact
   disconnectedCallback(): void;
   componentDidRender(): void;
   /**
-   * Used to toggle the selection state. By default this won't trigger an event.
+   * Toggle the selection state. By default this won't trigger an event.
    * The first argument allows the value to be coerced, rather than swapping values.
    */
   toggleSelected(coerce?: boolean): Promise<void>;
-  /** Sets focus on the component. */
+  /** Set focus on the component. */
   setFocus(): Promise<void>;
   /**
-   * Emitted whenever the remove button is pressed.
+   * Emits when the remove button is pressed.
    */
   calciteListItemRemove: EventEmitter<void>;
   calciteListItemChangeHandler(event: CustomEvent): void;

package/dist/types/components.d.ts

@@ -3443,19 +3443,19 @@ export namespace Components {
     }
     interface CalciteValueList {
         /**
-          * When true, disabled prevents interaction. This state shows items with lower opacity/grayed.
+          * When true, prevents user interaction. This state shows list items grayed out and with lower opacity.
          */
         "disabled": boolean;
         /**
-          * When true, the items will be sortable via drag and drop.
+          * When true, list items are sortable via a draggable button.
          */
         "dragEnabled": boolean;
         /**
-          * When true, an input appears at the top of the list that can be used by end users to filter items in the list.
+          * When true, an input appears at the top of the list that can be used by end users to filter list items.
          */
         "filterEnabled": boolean;
         /**
-          * Placeholder text for the filter input field.
+          * Placeholder text for the filter's input field.
          */
         "filterPlaceholder": string;
         /**
@@ -3471,11 +3471,11 @@ export namespace Components {
          */
         "loading": boolean;
         /**
-          * Multiple Works similar to standard radio buttons and checkboxes. When true, a user can select multiple items at a time. When false, only a single item can be selected at a time and selecting a new item will deselect any other selected items.
+          * Similar to standard radio buttons and checkboxes. When true, a user can select multiple list items at a time. When false, only a single list item can be selected at a time, and selecting a new list item will deselect any other selected list items.
          */
         "multiple": boolean;
         /**
-          * When true and single-selection is enabled, the selection will change when navigating items via the keyboard.
+          * When true and single-selection is enabled, the selection changes when navigating list items via the keyboard.
          */
         "selectionFollowsFocus": boolean;
         /**
@@ -3485,12 +3485,12 @@ export namespace Components {
     }
     interface CalciteValueListItem {
         /**
-          * An optional description for this item. Will appear below the label text.
+          * An optional description for the list item that displays below the label text.
          */
         "description"?: string;
         "disableDeselect": boolean;
         /**
-          * When true, the item cannot be clicked and is visually muted
+          * When true, the list item cannot be clicked and is visually muted.
          */
         "disabled": boolean;
         "handleActivated"?: boolean;
@@ -3500,11 +3500,11 @@ export namespace Components {
          */
         "icon"?: ICON_TYPES | null;
         /**
-          * The main label for this item. Appears next to the icon.
+          * The main label for the list item. Appears next to the icon.
          */
         "label": string;
         /**
-          * Used to provide additional metadata to an item, primarily used when the parent list has a filter.
+          * Provides additional metadata to a list item. Primary use is for a filter on the parent list.
          */
         "metadata"?: Record<string, unknown>;
         /**
@@ -3512,23 +3512,23 @@ export namespace Components {
          */
         "nonInteractive": boolean;
         /**
-          * Set this to true to display a remove action that removes the item from the list.
+          * When true, adds an action to remove the list item.
          */
         "removable": boolean;
         /**
-          * Set this to true to pre-select an item. Toggles when an item is checked/unchecked.
+          * When true, preselects the list item. Toggles when an item is checked/unchecked.
          */
         "selected": boolean;
         /**
-          * Sets focus on the component.
+          * Set focus on the component.
          */
         "setFocus": () => Promise<void>;
         /**
-          * Used to toggle the selection state. By default this won't trigger an event. The first argument allows the value to be coerced, rather than swapping values.
+          * Toggle the selection state. By default this won't trigger an event. The first argument allows the value to be coerced, rather than swapping values.
          */
         "toggleSelected": (coerce?: boolean) => Promise<void>;
         /**
-          * The item's associated value.
+          * The list item's associated value.
          */
         "value": any;
     }
@@ -7532,19 +7532,19 @@ declare namespace LocalJSX {
     }
     interface CalciteValueList {
         /**
-          * When true, disabled prevents interaction. This state shows items with lower opacity/grayed.
+          * When true, prevents user interaction. This state shows list items grayed out and with lower opacity.
          */
         "disabled"?: boolean;
         /**
-          * When true, the items will be sortable via drag and drop.
+          * When true, list items are sortable via a draggable button.
          */
         "dragEnabled"?: boolean;
         /**
-          * When true, an input appears at the top of the list that can be used by end users to filter items in the list.
+          * When true, an input appears at the top of the list that can be used by end users to filter list items.
          */
         "filterEnabled"?: boolean;
         /**
-          * Placeholder text for the filter input field.
+          * Placeholder text for the filter's input field.
          */
         "filterPlaceholder"?: string;
         /**
@@ -7556,29 +7556,29 @@ declare namespace LocalJSX {
          */
         "loading"?: boolean;
         /**
-          * Multiple Works similar to standard radio buttons and checkboxes. When true, a user can select multiple items at a time. When false, only a single item can be selected at a time and selecting a new item will deselect any other selected items.
+          * Similar to standard radio buttons and checkboxes. When true, a user can select multiple list items at a time. When false, only a single list item can be selected at a time, and selecting a new list item will deselect any other selected list items.
          */
         "multiple"?: boolean;
         /**
-          * Emitted when any of the item selections have changed.
+          * Emits when any of the list item selections have changed.
          */
         "onCalciteListChange"?: (event: CustomEvent<Map<string, HTMLCalciteValueListItemElement>>) => void;
         /**
-          * Emitted when the order of the list has changed.
+          * Emits when the order of the list has changed.
          */
         "onCalciteListOrderChange"?: (event: CustomEvent<any[]>) => void;
         /**
-          * When true and single-selection is enabled, the selection will change when navigating items via the keyboard.
+          * When true and single-selection is enabled, the selection changes when navigating list items via the keyboard.
          */
         "selectionFollowsFocus"?: boolean;
     }
     interface CalciteValueListItem {
         /**
-          * An optional description for this item. Will appear below the label text.
+          * An optional description for the list item that displays below the label text.
          */
         "description"?: string;
         /**
-          * When true, the item cannot be clicked and is visually muted
+          * When true, the list item cannot be clicked and is visually muted.
          */
         "disabled"?: boolean;
         /**
@@ -7587,11 +7587,11 @@ declare namespace LocalJSX {
          */
         "icon"?: ICON_TYPES | null;
         /**
-          * The main label for this item. Appears next to the icon.
+          * The main label for the list item. Appears next to the icon.
          */
         "label": string;
         /**
-          * Used to provide additional metadata to an item, primarily used when the parent list has a filter.
+          * Provides additional metadata to a list item. Primary use is for a filter on the parent list.
          */
         "metadata"?: Record<string, unknown>;
         /**
@@ -7599,19 +7599,19 @@ declare namespace LocalJSX {
          */
         "nonInteractive"?: boolean;
         /**
-          * Emitted whenever the remove button is pressed.
+          * Emits when the remove button is pressed.
          */
         "onCalciteListItemRemove"?: (event: CustomEvent<void>) => void;
         /**
-          * Set this to true to display a remove action that removes the item from the list.
+          * When true, adds an action to remove the list item.
          */
         "removable"?: boolean;
         /**
-          * Set this to true to pre-select an item. Toggles when an item is checked/unchecked.
+          * When true, preselects the list item. Toggles when an item is checked/unchecked.
          */
         "selected"?: boolean;
         /**
-          * The item's associated value.
+          * The list item's associated value.
          */
         "value": any;
     }