@esri/calcite-components 1.0.0-next.646 → 1.0.0-next.648

package/dist/collection/components/filter/filter.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.646
+ * v1.0.0-next.648
  */
 import { Fragment, h } from "@stencil/core";
 import { debounce } from "lodash-es";
@@ -12,34 +12,6 @@ import { filter } from "../../utils/filter";
 import { setUpLoadableComponent, setComponentLoaded, componentLoaded } from "../../utils/loadable";
 export class Filter {
   constructor() {
-    // --------------------------------------------------------------------------
-    //
-    //  Properties
-    //
-    // --------------------------------------------------------------------------
-    /**
-     * The items to filter through. The filter uses this as the starting point, and returns items
-     * that contain the string entered in the input, using a partial match and recursive search.
-     *
-     * This property is required.
-     */
-    this.items = [];
-    /**
-     * When true, disabled prevents interaction. This state shows items with lower opacity/grayed.
-     */
-    this.disabled = false;
-    /**
-     * The resulting items after filtering.
-     *
-     * @readonly
-     */
-    this.filteredItems = [];
-    /** specify the scale of filter, defaults to m */
-    this.scale = "m";
-    /**
-     * Filter value.
-     */
-    this.value = "";
     // --------------------------------------------------------------------------
     //
     //  Private Methods
@@ -65,6 +37,14 @@ export class Filter {
       this.filter("", true);
       this.setFocus();
     };
+    this.items = [];
+    this.disabled = false;
+    this.filteredItems = [];
+    this.intlClear = undefined;
+    this.intlLabel = undefined;
+    this.placeholder = undefined;
+    this.scale = "m";
+    this.value = "";
   }
   watchItemsHandler() {
     this.filter(this.value);
@@ -141,7 +121,7 @@ export class Filter {
         "optional": false,
         "docs": {
           "tags": [],
-          "text": "The items to filter through. The filter uses this as the starting point, and returns items\nthat contain the string entered in the input, using a partial match and recursive search.\n\nThis property is required."
+          "text": "Defines the items to filter. The component uses the values as the starting point, and returns items\n\nthat contain the string entered in the input, using a partial match and recursive search.\n\nThis property is needed to conduct filtering."
         },
         "defaultValue": "[]"
       },
@@ -157,7 +137,7 @@ export class Filter {
         "optional": false,
         "docs": {
           "tags": [],
-          "text": "When true, disabled prevents interaction. This state shows items with lower opacity/grayed."
+          "text": "When `true`, interaction is prevented and the component is displayed with lower opacity."
         },
         "attribute": "disabled",
         "reflect": true,
@@ -178,7 +158,7 @@ export class Filter {
               "name": "readonly",
               "text": undefined
             }],
-          "text": "The resulting items after filtering."
+          "text": "The component's resulting items after filtering."
         },
         "defaultValue": "[]"
       },
@@ -191,10 +171,10 @@ export class Filter {
           "references": {}
         },
         "required": false,
-        "optional": true,
+        "optional": false,
         "docs": {
           "tags": [],
-          "text": "A text label that will appear on the clear button."
+          "text": "Accessible name for the component's clear button."
         },
         "attribute": "intl-clear",
         "reflect": false
@@ -208,10 +188,10 @@ export class Filter {
           "references": {}
         },
         "required": false,
-        "optional": true,
+        "optional": false,
         "docs": {
           "tags": [],
-          "text": "A text label that will appear next to the input field."
+          "text": "Accessible name for the component."
         },
         "attribute": "intl-label",
         "reflect": false
@@ -225,10 +205,10 @@ export class Filter {
           "references": {}
         },
         "required": false,
-        "optional": true,
+        "optional": false,
         "docs": {
           "tags": [],
-          "text": "Placeholder text for the input element's placeholder attribute"
+          "text": "Specifies placeholder text for the input element."
         },
         "attribute": "placeholder",
         "reflect": false
@@ -250,7 +230,7 @@ export class Filter {
         "optional": false,
         "docs": {
           "tags": [],
-          "text": "specify the scale of filter, defaults to m"
+          "text": "Specifies the size of the component."
         },
         "attribute": "scale",
         "reflect": true,
@@ -268,7 +248,7 @@ export class Filter {
         "optional": false,
         "docs": {
           "tags": [],
-          "text": "Filter value."
+          "text": "The component's value."
         },
         "attribute": "value",
         "reflect": false,
@@ -285,7 +265,7 @@ export class Filter {
         "composed": true,
         "docs": {
           "tags": [],
-          "text": "This event fires when the filter text changes."
+          "text": "Fires when the component's text changes."
         },
         "complexType": {
           "original": "void",

package/dist/collection/components/filter/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.646
+ * v1.0.0-next.648
  */
 export const CSS = {
   container: "container",

package/dist/collection/components/flow/flow.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.646
+ * v1.0.0-next.648
  */
 import { h } from "@stencil/core";
 import { CSS } from "./resources";
@@ -11,9 +11,6 @@ import { createObserver } from "../../utils/observers";
  */
 export class Flow {
   constructor() {
-    this.flowDirection = null;
-    this.itemCount = 0;
-    this.items = [];
     this.itemMutationObserver = createObserver("mutation", () => this.updateFlowProps());
     this.getFlowDirection = (oldFlowItemCount, newFlowItemCount) => {
       const allowRetreatingDirection = oldFlowItemCount > 1;
@@ -46,6 +43,9 @@ export class Flow {
         this.flowDirection = flowDirection;
       }
     };
+    this.flowDirection = null;
+    this.itemCount = 0;
+    this.items = [];
   }
   // --------------------------------------------------------------------------
   //

package/dist/collection/components/flow/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.646
+ * v1.0.0-next.648
  */
 export const CSS = {
   frame: "frame",

package/dist/collection/components/flow-item/flow-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.646
+ * v1.0.0-next.648
  */
 import { h, Host } from "@stencil/core";
 import { getElementDir } from "../../utils/dom";
@@ -11,41 +11,16 @@ import { updateHostInteraction } from "../../utils/interactive";
 import { setUpLoadableComponent, setComponentLoaded, componentLoaded } from "../../utils/loadable";
 /**
  * @slot - A slot for adding custom content.
- * @slot header-actions-start - A slot for adding actions or content to the start side of the header.
- * @slot header-actions-end - A slot for adding actions or content to the end side of the header.
- * @slot header-content - A slot for adding custom content to the header.
- * @slot header-menu-actions - A slot for adding an overflow menu with actions inside a `calcite-dropdown`.
+ * @slot header-actions-start - A slot for adding `calcite-action`s or content to the start side of the component's header.
+ * @slot header-actions-end - A slot for adding `calcite-action`s or content to the end side of the component's header.
+ * @slot header-content - A slot for adding custom content to the component's header.
+ * @slot header-menu-actions - A slot for adding an overflow menu with `calcite-action`s inside a `calcite-dropdown`.
  * @slot fab - A slot for adding a `calcite-fab` (floating action button) to perform an action.
- * @slot footer-actions - A slot for adding buttons to the footer.
- * @slot footer - A slot for adding custom content to the footer.
+ * @slot footer-actions - A slot for adding `calcite-button`s to the component's footer.
+ * @slot footer - A slot for adding custom content to the component's footer.
  */
 export class FlowItem {
   constructor() {
-    // --------------------------------------------------------------------------
-    //
-    //  Properties
-    //
-    // --------------------------------------------------------------------------
-    /** When true, displays a close button in the trailing side of the header */
-    this.closable = false;
-    /** When true, flow-item will be hidden */
-    this.closed = false;
-    /**
-     *  When true, interaction is prevented and the component is displayed with lower opacity.
-     */
-    this.disabled = false;
-    /**
-     * When true, a busy indicator is displayed.
-     */
-    this.loading = false;
-    /**
-     * When true, the action menu items in the `header-menu-actions` slot are open.
-     */
-    this.menuOpen = false;
-    /**
-     * When true, displays a back button in the header.
-     */
-    this.showBackButton = false;
     // --------------------------------------------------------------------------
     //
     //  Private Methods
@@ -71,6 +46,22 @@ export class FlowItem {
     this.getBackLabel = () => {
       return this.intlBack || TEXT.back;
     };
+    this.closable = false;
+    this.closed = false;
+    this.beforeBack = undefined;
+    this.description = undefined;
+    this.disabled = false;
+    this.heading = undefined;
+    this.headingLevel = undefined;
+    this.heightScale = undefined;
+    this.intlBack = undefined;
+    this.intlClose = undefined;
+    this.intlOptions = undefined;
+    this.loading = false;
+    this.menuOpen = false;
+    this.showBackButton = false;
+    this.widthScale = undefined;
+    this.backButtonEl = undefined;
   }
   //--------------------------------------------------------------------------
   //
@@ -162,7 +153,7 @@ export class FlowItem {
         "optional": false,
         "docs": {
           "tags": [],
-          "text": "When true, displays a close button in the trailing side of the header"
+          "text": "When `true`, displays a close button in the trailing side of the component's header."
         },
         "attribute": "closable",
         "reflect": true,
@@ -180,7 +171,7 @@ export class FlowItem {
         "optional": false,
         "docs": {
           "tags": [],
-          "text": "When true, flow-item will be hidden"
+          "text": "When `true`, the component will be hidden."
         },
         "attribute": "closed",
         "reflect": true,
@@ -199,10 +190,10 @@ export class FlowItem {
           }
         },
         "required": false,
-        "optional": true,
+        "optional": false,
         "docs": {
           "tags": [],
-          "text": "When provided, this method will be called before it is removed from the parent flow."
+          "text": "When provided, the method will be called before it is removed from its parent `calcite-flow`."
         }
       },
       "description": {
@@ -234,7 +225,7 @@ export class FlowItem {
         "optional": false,
         "docs": {
           "tags": [],
-          "text": "When true, interaction is prevented and the component is displayed with lower opacity."
+          "text": "When `true`, interaction is prevented and the component is displayed with lower opacity."
         },
         "attribute": "disabled",
         "reflect": true,
@@ -249,7 +240,7 @@ export class FlowItem {
           "references": {}
         },
         "required": false,
-        "optional": true,
+        "optional": false,
         "docs": {
           "tags": [],
           "text": "The component header text."
@@ -293,7 +284,7 @@ export class FlowItem {
           }
         },
         "required": false,
-        "optional": true,
+        "optional": false,
         "docs": {
           "tags": [],
           "text": "Specifies the maximum height of the component."
@@ -310,10 +301,10 @@ export class FlowItem {
           "references": {}
         },
         "required": false,
-        "optional": true,
+        "optional": false,
         "docs": {
           "tags": [],
-          "text": "Accessible name for the component's back button. The back button will only be shown when 'showBackButton' is true."
+          "text": "When `showBackButton` is `true`, the accessible name for the component's back button."
         },
         "attribute": "intl-back",
         "reflect": false
@@ -327,10 +318,10 @@ export class FlowItem {
           "references": {}
         },
         "required": false,
-        "optional": true,
+        "optional": false,
         "docs": {
           "tags": [],
-          "text": "Accessible name for the component's close button. The close button will only be shown when 'closable' is true."
+          "text": "When `closable` is `true`, the accessible name for the component's close button."
         },
         "attribute": "intl-close",
         "reflect": false
@@ -344,7 +335,7 @@ export class FlowItem {
           "references": {}
         },
         "required": false,
-        "optional": true,
+        "optional": false,
         "docs": {
           "tags": [],
           "text": "Accessible name for the component's actions menu."
@@ -364,7 +355,7 @@ export class FlowItem {
         "optional": false,
         "docs": {
           "tags": [],
-          "text": "When true, a busy indicator is displayed."
+          "text": "When `true`, a busy indicator is displayed."
         },
         "attribute": "loading",
         "reflect": true,
@@ -382,7 +373,7 @@ export class FlowItem {
         "optional": false,
         "docs": {
           "tags": [],
-          "text": "When true, the action menu items in the `header-menu-actions` slot are open."
+          "text": "When `true`, the action menu items in the `header-menu-actions` slot are open."
         },
         "attribute": "menu-open",
         "reflect": true,
@@ -400,7 +391,7 @@ export class FlowItem {
         "optional": false,
         "docs": {
           "tags": [],
-          "text": "When true, displays a back button in the header."
+          "text": "When `true`, displays a back button in the component's header."
         },
         "attribute": "show-back-button",
         "reflect": true,
@@ -420,7 +411,7 @@ export class FlowItem {
           }
         },
         "required": false,
-        "optional": true,
+        "optional": false,
         "docs": {
           "tags": [],
           "text": "Specifies the width of the component."

package/dist/collection/components/flow-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.646
+ * v1.0.0-next.648
  */
 export const CSS = {
   backButton: "back-button"

package/dist/collection/components/functional/ExpandToggle.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.646
+ * v1.0.0-next.648
  */
 import { h } from "@stencil/core";
 import { getElementDir } from "../../utils/dom";

package/dist/collection/components/functional/Heading.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.646
+ * v1.0.0-next.648
  */
 import { h } from "@stencil/core";
 export function constrainHeadingLevel(level) {

package/dist/collection/components/graph/graph.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.646
+ * v1.0.0-next.648
  */
 import { h, forceUpdate } from "@stencil/core";
 import { guid } from "../../utils/guid";
@@ -9,16 +9,6 @@ import { area, range, translate } from "./util";
 import { createObserver } from "../../utils/observers";
 export class Graph {
   constructor() {
-    //--------------------------------------------------------------------------
-    //
-    //  Properties
-    //
-    //--------------------------------------------------------------------------
-    /**
-     * Array of tuples describing a single data point ([x, y])
-     * These data points should be sorted by x-axis value
-     */
-    this.data = [];
     //--------------------------------------------------------------------------
     //
     //  Private State/Props
@@ -26,6 +16,12 @@ export class Graph {
     //--------------------------------------------------------------------------
     this.graphId = `calcite-graph-${guid()}`;
     this.resizeObserver = createObserver("resize", () => forceUpdate(this));
+    this.data = [];
+    this.colorStops = undefined;
+    this.highlightMin = undefined;
+    this.highlightMax = undefined;
+    this.min = undefined;
+    this.max = undefined;
   }
   //--------------------------------------------------------------------------
   //

package/dist/collection/components/graph/util.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.646
+ * v1.0.0-next.648
  */
 /**
  * Calculate slope of the tangents

package/dist/collection/components/handle/handle.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.646
+ * v1.0.0-next.648
  */
 import { h } from "@stencil/core";
 import { toAriaBoolean } from "../../utils/dom";
@@ -9,19 +9,6 @@ import { CSS, ICONS } from "./resources";
 import { setUpLoadableComponent, setComponentLoaded, componentLoaded } from "../../utils/loadable";
 export class Handle {
   constructor() {
-    // --------------------------------------------------------------------------
-    //
-    //  Properties
-    //
-    // --------------------------------------------------------------------------
-    /**
-     * @internal
-     */
-    this.activated = false;
-    /**
-     * Value for the button title attribute
-     */
-    this.textTitle = "handle";
     // --------------------------------------------------------------------------
     //
     //  Private Methods
@@ -47,6 +34,8 @@ export class Handle {
     this.handleBlur = () => {
       this.activated = false;
     };
+    this.activated = false;
+    this.textTitle = "handle";
   }
   //--------------------------------------------------------------------------
   //

package/dist/collection/components/handle/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.646
+ * v1.0.0-next.648
  */
 export const CSS = {
   handle: "handle",

package/dist/collection/components/icon/icon.css

@@ -88,7 +88,7 @@
 *
 * These properties can be overridden using the component's tag as selector.
 *
-* @prop --calcite-ui-icon-color: the color of the icon. Defaults to 'currentColor'.
+* @prop --calcite-ui-icon-color: The component's color. Defaults to `currentColor`.
 */
 :host {
   display: inline-flex;

package/dist/collection/components/icon/icon.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.646
+ * v1.0.0-next.648
  */
 import { Build, h, Host } from "@stencil/core";
 import { CSS } from "./resources";
@@ -10,23 +10,11 @@ import { fetchIcon, scaleToPx } from "./utils";
 import { createObserver } from "../../utils/observers";
 export class Icon {
   constructor() {
-    //--------------------------------------------------------------------------
-    //
-    //  Properties
-    //
-    //--------------------------------------------------------------------------
-    /**
-     * The name of the icon to display. The value of this property must match the icon name from https://esri.github.io/calcite-ui-icons/.
-     */
     this.icon = null;
-    /**
-     * When true, the icon will be flipped when the element direction is 'rtl'.
-     */
     this.flipRtl = false;
-    /**
-     * Icon scale.
-     */
     this.scale = "m";
+    this.textLabel = undefined;
+    this.pathData = undefined;
     this.visible = false;
   }
   //--------------------------------------------------------------------------
@@ -113,8 +101,11 @@ export class Icon {
         "required": false,
         "optional": false,
         "docs": {
-          "tags": [],
-          "text": "The name of the icon to display. The value of this property must match the icon name from https://esri.github.io/calcite-ui-icons/."
+          "tags": [{
+              "name": "see",
+              "text": "[Icons](https://esri.github.io/calcite-ui-icons)"
+            }],
+          "text": "Displays a specific icon."
         },
         "attribute": "icon",
         "reflect": true,
@@ -132,7 +123,7 @@ export class Icon {
         "optional": false,
         "docs": {
           "tags": [],
-          "text": "When true, the icon will be flipped when the element direction is 'rtl'."
+          "text": "When `true`, the icon will be flipped when the element direction is right-to-left (`\"rtl\"`)."
         },
         "attribute": "flip-rtl",
         "reflect": true,
@@ -155,7 +146,7 @@ export class Icon {
         "optional": false,
         "docs": {
           "tags": [],
-          "text": "Icon scale."
+          "text": "Specifies the size of the component."
         },
         "attribute": "scale",
         "reflect": true,
@@ -173,7 +164,7 @@ export class Icon {
         "optional": false,
         "docs": {
           "tags": [],
-          "text": "The icon label.\n\nIt is recommended to set this value if your icon is semantic."
+          "text": "Accessible name for the component.\n\nIt is recommended to set this value if your icon is semantic."
         },
         "attribute": "text-label",
         "reflect": false

package/dist/collection/components/icon/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.646
+ * v1.0.0-next.648
  */
 export const CSS = {
   icon: "icon",

package/dist/collection/components/icon/utils.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.646
+ * v1.0.0-next.648
  */
 import { getAssetPath } from "@stencil/core";
 /**