@esri/calcite-components 1.0.0-next.465 → 1.0.0-next.468

package/dist/collection/components/option/option.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.465
+ * v1.0.0-next.468
  */
 import { Component, h, Prop, Element, Event, Watch } from "@stencil/core";
 import { createObserver } from "../../utils/observers";
@@ -18,14 +18,14 @@ export class Option {
     this.disabled = false;
     this.mutationObserver = createObserver("mutation", () => {
       this.ensureTextContentDependentProps();
-      this.calciteOptionChange.emit();
+      this.calciteInternalOptionChange.emit();
     });
   }
   handlePropChange(_newValue, _oldValue, propName) {
     if (propName === "label" || propName === "value") {
       this.ensureTextContentDependentProps();
     }
-    this.calciteOptionChange.emit();
+    this.calciteInternalOptionChange.emit();
   }
   //--------------------------------------------------------------------------
   //
@@ -150,8 +150,8 @@ export class Option {
     }
   }; }
   static get events() { return [{
-      "method": "calciteOptionChange",
-      "name": "calciteOptionChange",
+      "method": "calciteInternalOptionChange",
+      "name": "calciteInternalOptionChange",
       "bubbles": true,
       "cancelable": true,
       "composed": true,

package/dist/collection/components/option-group/option-group.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.465
+ * v1.0.0-next.468
  */
 import { Component, h, Prop, Watch, Event, Fragment } from "@stencil/core";
 /**
@@ -20,7 +20,7 @@ export class OptionGroup {
     this.disabled = false;
   }
   handlePropChange() {
-    this.calciteOptionGroupChange.emit();
+    this.calciteInternalOptionGroupChange.emit();
   }
   //--------------------------------------------------------------------------
   //
@@ -78,8 +78,8 @@ export class OptionGroup {
     }
   }; }
   static get events() { return [{
-      "method": "calciteOptionGroupChange",
-      "name": "calciteOptionGroupChange",
+      "method": "calciteInternalOptionGroupChange",
+      "name": "calciteInternalOptionGroupChange",
       "bubbles": true,
       "cancelable": true,
       "composed": true,

package/dist/collection/components/pagination/pagination.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.465
+ * v1.0.0-next.468
  */
 import { Component, Element, Event, h, Prop, Method, Fragment } from "@stencil/core";
 import { CSS, TEXT } from "./resources";
@@ -19,11 +19,15 @@ export class Pagination {
     this.start = 1;
     /** total number of items */
     this.total = 0;
-    /** Used as an accessible label (aria-label) for the next button
+    /**
+     * Used as an accessible label (aria-label) for the next button
+     *
      * @default "Next"
      */
     this.textLabelNext = TEXT.nextLabel;
-    /** Used as an accessible label (aria-label) of the previous button
+    /**
+     * Used as an accessible label (aria-label) of the previous button
+     *
      * @default "Previous"
      */
     this.textLabelPrevious = TEXT.previousLabel;

package/dist/collection/components/pagination/resources.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.465
+ * v1.0.0-next.468
  */
 export const CSS = {
   page: "page",

package/dist/collection/components/panel/panel.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.465
+ * v1.0.0-next.468
  */
 import { Component, Element, Event, Method, Prop, Watch, h, Fragment } from "@stencil/core";
 import { CSS, HEADING_LEVEL, ICONS, SLOTS, TEXT } from "./resources";
@@ -130,7 +130,11 @@ export class Panel {
   //  Methods
   //
   // --------------------------------------------------------------------------
-  /** Sets focus on the component. */
+  /**
+   * Sets focus on the component.
+   *
+   * @param focusId
+   */
   async setFocus(focusId) {
     var _a, _b, _c;
     if (focusId === "dismiss-button") {
@@ -143,7 +147,8 @@ export class Panel {
     }
     (_c = this.containerEl) === null || _c === void 0 ? void 0 : _c.focus();
   }
-  /** Scrolls panel content to a particular set of coordinates.
+  /**
+   * Scrolls panel content to a particular set of coordinates.
    *
    * ```
    *   myCalcitePanel.scrollContentTo({
@@ -152,6 +157,8 @@ export class Panel {
    *     behavior: "auto" // Specifies whether the scrolling should animate smoothly (smooth), or happen instantly in a single jump (auto, the default value).
    *   });
    * ```
+   *
+   * @param options
    */
   async scrollContentTo(options) {
     var _a;
@@ -617,7 +624,10 @@ export class Panel {
       "complexType": {
         "signature": "(focusId?: \"dismiss-button\" | \"back-button\") => Promise<void>",
         "parameters": [{
-            "tags": [],
+            "tags": [{
+                "name": "param",
+                "text": "focusId"
+              }],
             "text": ""
           }],
         "references": {
@@ -629,14 +639,20 @@ export class Panel {
       },
       "docs": {
         "text": "Sets focus on the component.",
-        "tags": []
+        "tags": [{
+            "name": "param",
+            "text": "focusId"
+          }]
       }
     },
     "scrollContentTo": {
       "complexType": {
         "signature": "(options?: ScrollToOptions) => Promise<void>",
         "parameters": [{
-            "tags": [],
+            "tags": [{
+                "name": "param",
+                "text": "options"
+              }],
             "text": ""
           }],
         "references": {
@@ -650,8 +666,11 @@ export class Panel {
         "return": "Promise<void>"
       },
       "docs": {
-        "text": "Scrolls panel content to a particular set of coordinates.\n\n```\n myCalcitePanel.scrollContentTo({\n   left: 0, // Specifies the number of pixels along the X axis to scroll the window or element.\n   top: 0, // Specifies the number of pixels along the Y axis to scroll the window or element\n   behavior: \"auto\" // Specifies whether the scrolling should animate smoothly (smooth), or happen instantly in a single jump (auto, the default value).\n });\n```",
-        "tags": []
+        "text": "Scrolls panel content to a particular set of coordinates.\n\n```\n  myCalcitePanel.scrollContentTo({\n    left: 0, // Specifies the number of pixels along the X axis to scroll the window or element.\n    top: 0, // Specifies the number of pixels along the Y axis to scroll the window or element\n    behavior: \"auto\" // Specifies whether the scrolling should animate smoothly (smooth), or happen instantly in a single jump (auto, the default value).\n  });\n```",
+        "tags": [{
+            "name": "param",
+            "text": "options"
+          }]
       }
     }
   }; }

package/dist/collection/components/panel/resources.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.465
+ * v1.0.0-next.468
  */
 export const CSS = {
   backButton: "back-button",

package/dist/collection/components/pick-list/pick-list.js

@@ -1,11 +1,11 @@
 /*!
  * 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.465
+ * v1.0.0-next.468
  */
 import { Component, Element, Event, Listen, Method, Prop, State, h } from "@stencil/core";
 import { ICON_TYPES } from "./resources";
-import { calciteListItemChangeHandler, calciteListItemValueChangeHandler, cleanUpObserver, deselectSiblingItems, deselectRemovedItems, getItemData, handleFilter, calciteListFocusOutHandler, initialize, initializeObserver, mutationObserverCallback, selectSiblings, setUpItems, keyDownHandler, setFocus, removeItem } from "./shared-list-logic";
+import { calciteListItemChangeHandler, calciteInternalListItemValueChangeHandler, cleanUpObserver, deselectSiblingItems, deselectRemovedItems, getItemData, handleFilter, calciteListFocusOutHandler, initialize, initializeObserver, mutationObserverCallback, selectSiblings, setUpItems, keyDownHandler, setFocus, removeItem } from "./shared-list-logic";
 import List from "./shared-list-render";
 import { createObserver } from "../../utils/observers";
 import { updateHostInteraction } from "../../utils/interactive";
@@ -83,12 +83,13 @@ export class PickList {
   calciteListItemChangeHandler(event) {
     calciteListItemChangeHandler.call(this, event);
   }
-  calciteListItemPropsChangeHandler(event) {
+  calciteInternalListItemPropsChangeHandler(event) {
     event.stopPropagation();
     this.setUpFilter();
   }
-  calciteListItemValueChangeHandler(event) {
-    calciteListItemValueChangeHandler.call(this, event);
+  calciteInternalListItemValueChangeHandler(event) {
+    calciteInternalListItemValueChangeHandler.call(this, event);
+    event.stopPropagation();
   }
   calciteListFocusOutHandler(event) {
     calciteListFocusOutHandler.call(this, event);
@@ -115,7 +116,11 @@ export class PickList {
   async getSelectedItems() {
     return this.selectedValues;
   }
-  /** Sets focus on the component. */
+  /**
+   * Sets focus on the component.
+   *
+   * @param focusId
+   */
   async setFocus(focusId) {
     return setFocus.call(this, focusId);
   }
@@ -323,7 +328,10 @@ export class PickList {
       "complexType": {
         "signature": "(focusId?: ListFocusId) => Promise<void>",
         "parameters": [{
-            "tags": [],
+            "tags": [{
+                "name": "param",
+                "text": "focusId"
+              }],
             "text": ""
           }],
         "references": {
@@ -339,7 +347,10 @@ export class PickList {
       },
       "docs": {
         "text": "Sets focus on the component.",
-        "tags": []
+        "tags": [{
+            "name": "param",
+            "text": "focusId"
+          }]
       }
     }
   }; }
@@ -357,14 +368,14 @@ export class PickList {
       "capture": false,
       "passive": false
     }, {
-      "name": "calciteListItemPropsChange",
-      "method": "calciteListItemPropsChangeHandler",
+      "name": "calciteInternalListItemPropsChange",
+      "method": "calciteInternalListItemPropsChangeHandler",
       "target": undefined,
       "capture": false,
       "passive": false
     }, {
-      "name": "calciteListItemValueChange",
-      "method": "calciteListItemValueChangeHandler",
+      "name": "calciteInternalListItemValueChange",
+      "method": "calciteInternalListItemValueChangeHandler",
       "target": undefined,
       "capture": false,
       "passive": false

package/dist/collection/components/pick-list/resources.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.465
+ * v1.0.0-next.468
  */
 export const CSS = {
   sticky: "sticky-pos"

package/dist/collection/components/pick-list/shared-list-logic.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.465
+ * v1.0.0-next.468
  */
 import { debounce } from "lodash-es";
 import { focusElement, getSlotted } from "../../utils/dom";
@@ -63,8 +63,7 @@ export function calciteListItemChangeHandler(event) {
   this.lastSelectedItem = item;
   this.emitCalciteListChange();
 }
-export function calciteListItemValueChangeHandler(event) {
-  event.stopPropagation();
+export function calciteInternalListItemValueChangeHandler(event) {
   const oldValue = event.detail.oldValue;
   const selectedValues = this.selectedValues;
   if (selectedValues.has(oldValue)) {
@@ -72,6 +71,7 @@ export function calciteListItemValueChangeHandler(event) {
     selectedValues.delete(oldValue);
     selectedValues.set(event.detail.newValue, item);
   }
+  event.stopPropagation();
 }
 // --------------------------------------------------------------------------
 //

package/dist/collection/components/pick-list/shared-list-render.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.465
+ * v1.0.0-next.468
  */
 var __rest = (this && this.__rest) || function (s, e) {
   var t = {};

package/dist/collection/components/pick-list-group/pick-list-group.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.465
+ * v1.0.0-next.468
  */
 import { Component, Element, Prop, h, Fragment } from "@stencil/core";
 import { CSS, SLOTS } from "./resources";

package/dist/collection/components/pick-list-group/resources.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.465
+ * v1.0.0-next.468
  */
 export const CSS = {
   heading: "heading",

package/dist/collection/components/pick-list-item/pick-list-item.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.465
+ * v1.0.0-next.468
  */
 import { Component, Element, Event, Fragment, h, Method, Prop, Watch } from "@stencil/core";
 import { CSS, ICONS, SLOTS, TEXT } from "./resources";
@@ -24,11 +24,12 @@ export class PickListItem {
      */
     this.disableDeselect = false;
     /**
-     * @internal When true, the item cannot be selected by user interaction.
+     * @internal
      */
     this.nonInteractive = false;
     /**
      * Determines the icon SVG symbol that will be shown. Options are circle, square, grip or null.
+     *
      * @see [ICON_TYPES](https://github.com/Esri/calcite-components/blob/master/src/components/pick-list/resources.ts#L5)
      */
     this.icon = null;
@@ -42,6 +43,7 @@ export class PickListItem {
     this.selected = false;
     /**
      * Used as an accessible label (aria-label) for the "remove item" action. Only applicable if removable is true.
+     *
      * @default "Remove"
      */
     this.intlRemove = TEXT.remove;
@@ -71,13 +73,13 @@ export class PickListItem {
     };
   }
   descriptionWatchHandler() {
-    this.calciteListItemPropsChange.emit();
+    this.calciteInternalListItemPropsChange.emit();
   }
   labelWatchHandler() {
-    this.calciteListItemPropsChange.emit();
+    this.calciteInternalListItemPropsChange.emit();
   }
   metadataWatchHandler() {
-    this.calciteListItemPropsChange.emit();
+    this.calciteInternalListItemPropsChange.emit();
   }
   selectedWatchHandler() {
     this.calciteListItemChange.emit({
@@ -89,7 +91,7 @@ export class PickListItem {
     this.shiftPressed = false;
   }
   valueWatchHandler(newValue, oldValue) {
-    this.calciteListItemValueChange.emit({ oldValue, newValue });
+    this.calciteInternalListItemValueChange.emit({ oldValue, newValue });
   }
   // --------------------------------------------------------------------------
   //
@@ -113,6 +115,8 @@ export class PickListItem {
   /**
    * 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.
+   *
+   * @param coerce
    */
   async toggleSelected(coerce) {
     this.selected = typeof coerce === "boolean" ? coerce : !this.selected;
@@ -239,7 +243,7 @@ export class PickListItem {
       "docs": {
         "tags": [{
             "name": "internal",
-            "text": "When true, the item cannot be selected by user interaction."
+            "text": undefined
           }],
         "text": ""
       },
@@ -419,8 +423,8 @@ export class PickListItem {
         "references": {}
       }
     }, {
-      "method": "calciteListItemPropsChange",
-      "name": "calciteListItemPropsChange",
+      "method": "calciteInternalListItemPropsChange",
+      "name": "calciteInternalListItemPropsChange",
       "bubbles": true,
       "cancelable": true,
       "composed": true,
@@ -437,8 +441,8 @@ export class PickListItem {
         "references": {}
       }
     }, {
-      "method": "calciteListItemValueChange",
-      "name": "calciteListItemValueChange",
+      "method": "calciteInternalListItemValueChange",
+      "name": "calciteInternalListItemValueChange",
       "bubbles": true,
       "cancelable": true,
       "composed": true,
@@ -460,7 +464,10 @@ export class PickListItem {
       "complexType": {
         "signature": "(coerce?: boolean) => Promise<void>",
         "parameters": [{
-            "tags": [],
+            "tags": [{
+                "name": "param",
+                "text": "coerce"
+              }],
             "text": ""
           }],
         "references": {
@@ -472,7 +479,10 @@ export class PickListItem {
       },
       "docs": {
         "text": "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.",
-        "tags": []
+        "tags": [{
+            "name": "param",
+            "text": "coerce"
+          }]
       }
     },
     "setFocus": {

package/dist/collection/components/pick-list-item/resources.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.465
+ * v1.0.0-next.468
  */
 export const CSS = {
   actions: "actions",

package/dist/collection/components/popover/PopoverManager.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.465
+ * v1.0.0-next.468
  */
 import { queryElementsRoots } from "../../utils/dom";
 export default class PopoverManager {
@@ -23,10 +23,10 @@ export default class PopoverManager {
       const registeredElement = composedPath.find((pathEl) => registeredElements.has(pathEl));
       return registeredElements.get(registeredElement);
     };
-    this.clickHandler = (event) => {
+    this.togglePopovers = (event) => {
       const composedPath = event.composedPath();
       const popover = this.queryPopover(composedPath);
-      if (popover) {
+      if (popover && !popover.triggerDisabled) {
         popover.toggle();
         return;
       }
@@ -34,6 +34,15 @@ export default class PopoverManager {
         .filter((popover) => popover.autoClose && popover.open && !composedPath.includes(popover))
         .forEach((popover) => popover.toggle(false));
     };
+    this.keyHandler = (event) => {
+      if (event.key !== "Enter" && event.key !== " ") {
+        return;
+      }
+      this.togglePopovers(event);
+    };
+    this.clickHandler = (event) => {
+      this.togglePopovers(event);
+    };
   }
   // --------------------------------------------------------------------------
   //
@@ -57,8 +66,10 @@ export default class PopoverManager {
   }
   addListeners() {
     document.addEventListener("pointerdown", this.clickHandler, { capture: true });
+    document.addEventListener("keydown", this.keyHandler, { capture: true });
   }
   removeListeners() {
     document.removeEventListener("pointerdown", this.clickHandler, { capture: true });
+    document.removeEventListener("keydown", this.keyHandler, { capture: true });
   }
 }

package/dist/collection/components/popover/popover.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.465
+ * v1.0.0-next.468
  */
 import { Component, Element, Event, forceUpdate, Host, Method, Prop, State, Watch, h } from "@stencil/core";
 import { CSS, ARIA_CONTROLS, ARIA_EXPANDED, HEADING_LEVEL, TEXT, defaultPopoverPlacement } from "./resources";
@@ -27,6 +27,7 @@ export class Popover {
     this.autoClose = false;
     /**
      * Display a close button within the Popover.
+     *
      * @deprecated use dismissible instead.
      */
     this.closeButton = false;
@@ -44,6 +45,7 @@ export class Popover {
     this.disablePointer = false;
     /**
      * Offset the position of the popover away from the reference element.
+     *
      * @default 6
      */
     this.offsetDistance = defaultOffsetDistance;
@@ -59,10 +61,17 @@ export class Popover {
     this.overlayPositioning = "absolute";
     /**
      * Determines where the component will be positioned relative to the referenceElement.
+     *
      * @see [PopperPlacement](https://github.com/Esri/calcite-components/blob/master/src/utils/popper.ts#L25)
      */
     this.placement = defaultPopoverPlacement;
-    /** Text for close button.
+    /**
+     * Disables automatically toggling a popover when its referenceElement has been triggered. This property can be set to true to manage when a popover is open.
+     */
+    this.triggerDisabled = false;
+    /**
+     * Text for close button.
+     *
      * @default "Close"
      */
     this.intlClose = TEXT.close;
@@ -184,7 +193,11 @@ export class Popover {
       })
       : this.createPopper();
   }
-  /** Sets focus on the component. */
+  /**
+   * Sets focus on the component.
+   *
+   * @param focusId
+   */
   async setFocus(focusId) {
     var _a;
     const { closeButtonEl } = this;
@@ -195,7 +208,11 @@ export class Popover {
     }
     (_a = this.el) === null || _a === void 0 ? void 0 : _a.focus();
   }
-  /** Toggles the popover's open property. */
+  /**
+   * Toggles the popover's open property.
+   *
+   * @param value
+   */
   async toggle(value = !this.open) {
     this.open = value;
   }
@@ -600,6 +617,24 @@ export class Popover {
       "attribute": "reference-element",
       "reflect": false
     },
+    "triggerDisabled": {
+      "type": "boolean",
+      "mutable": false,
+      "complexType": {
+        "original": "boolean",
+        "resolved": "boolean",
+        "references": {}
+      },
+      "required": false,
+      "optional": false,
+      "docs": {
+        "tags": [],
+        "text": "Disables automatically toggling a popover when its referenceElement has been triggered. This property can be set to true to manage when a popover is open."
+      },
+      "attribute": "trigger-disabled",
+      "reflect": true,
+      "defaultValue": "false"
+    },
     "intlClose": {
       "type": "string",
       "mutable": false,
@@ -677,7 +712,10 @@ export class Popover {
       "complexType": {
         "signature": "(focusId?: \"close-button\") => Promise<void>",
         "parameters": [{
-            "tags": [],
+            "tags": [{
+                "name": "param",
+                "text": "focusId"
+              }],
             "text": ""
           }],
         "references": {
@@ -689,14 +727,20 @@ export class Popover {
       },
       "docs": {
         "text": "Sets focus on the component.",
-        "tags": []
+        "tags": [{
+            "name": "param",
+            "text": "focusId"
+          }]
       }
     },
     "toggle": {
       "complexType": {
         "signature": "(value?: boolean) => Promise<void>",
         "parameters": [{
-            "tags": [],
+            "tags": [{
+                "name": "param",
+                "text": "value"
+              }],
             "text": ""
           }],
         "references": {
@@ -708,7 +752,10 @@ export class Popover {
       },
       "docs": {
         "text": "Toggles the popover's open property.",
-        "tags": []
+        "tags": [{
+            "name": "param",
+            "text": "value"
+          }]
       }
     }
   }; }