@esri/calcite-components 1.0.0-next.556 → 1.0.0-next.559

package/dist/collection/components/stepper/stepper.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.556
+ * v1.0.0-next.559
  */
 import { Component, Element, Event, h, Listen, Method, Prop } from "@stencil/core";
 import { focusElement } from "../../utils/dom";
@@ -15,13 +15,13 @@ export class Stepper {
     //  Public Properties
     //
     //--------------------------------------------------------------------------
-    /** optionally display a status icon next to the step title */
+    /** When true, displays a status icon in the `calcite-stepper-item` heading. */
     this.icon = false;
-    /** specify the layout of stepper, defaults to horizontal */
+    /** Defines the layout of the component. */
     this.layout = "horizontal";
-    /** optionally display the number next to the step title */
+    /** When true, displays the step number in the `calcite-stepper-item` heading. */
     this.numbered = false;
-    /** specify the scale of stepper, defaults to m */
+    /** Specifies the size of the component. */
     this.scale = "m";
     //--------------------------------------------------------------------------
     //
@@ -123,7 +123,7 @@ export class Stepper {
   //  Public Methods
   //
   //--------------------------------------------------------------------------
-  /** set the next step as active */
+  /** Set the next `calcite-stepper-item` as active. */
   async nextStep() {
     const enabledStepIndex = this.getEnabledStepIndex(this.currentPosition + 1, "next");
     if (typeof enabledStepIndex !== "number") {
@@ -131,7 +131,7 @@ export class Stepper {
     }
     this.updateStep(enabledStepIndex);
   }
-  /** set the previous step as active */
+  /** Set the previous `calcite-stepper-item` as active. */
   async prevStep() {
     const enabledStepIndex = this.getEnabledStepIndex(this.currentPosition - 1, "previous");
     if (typeof enabledStepIndex !== "number") {
@@ -140,7 +140,7 @@ export class Stepper {
     this.updateStep(enabledStepIndex);
   }
   /**
-   * set the requested step as active
+   * Set a specified `calcite-stepper-item` as active.
    *
    * @param step
    */
@@ -150,7 +150,7 @@ export class Stepper {
       this.updateStep(position);
     }
   }
-  /** set the first step as active */
+  /** Set the first `calcite-stepper-item` as active. */
   async startStep() {
     const enabledStepIndex = this.getEnabledStepIndex(0, "next");
     if (typeof enabledStepIndex !== "number") {
@@ -158,7 +158,7 @@ export class Stepper {
     }
     this.updateStep(enabledStepIndex);
   }
-  /** set the last step as active */
+  /** Set the last `calcite-stepper-item` as active. */
   async endStep() {
     const enabledStepIndex = this.getEnabledStepIndex(this.items.length - 1, "previous");
     if (typeof enabledStepIndex !== "number") {
@@ -237,7 +237,7 @@ export class Stepper {
       "optional": false,
       "docs": {
         "tags": [],
-        "text": "optionally display a status icon next to the step title"
+        "text": "When true, displays a status icon in the `calcite-stepper-item` heading."
       },
       "attribute": "icon",
       "reflect": true,
@@ -263,7 +263,7 @@ export class Stepper {
       "optional": false,
       "docs": {
         "tags": [],
-        "text": "specify the layout of stepper, defaults to horizontal"
+        "text": "Defines the layout of the component."
       },
       "attribute": "layout",
       "reflect": true,
@@ -281,7 +281,7 @@ export class Stepper {
       "optional": false,
       "docs": {
         "tags": [],
-        "text": "optionally display the number next to the step title"
+        "text": "When true, displays the step number in the `calcite-stepper-item` heading."
       },
       "attribute": "numbered",
       "reflect": true,
@@ -304,7 +304,7 @@ export class Stepper {
       "optional": false,
       "docs": {
         "tags": [],
-        "text": "specify the scale of stepper, defaults to m"
+        "text": "Specifies the size of the component."
       },
       "attribute": "scale",
       "reflect": true,
@@ -319,7 +319,7 @@ export class Stepper {
       "composed": true,
       "docs": {
         "tags": [],
-        "text": "This event fires when the active stepper item has changed."
+        "text": "Fires when the active `calcite-stepper-item` changes."
       },
       "complexType": {
         "original": "StepperItemChangeEventDetail",
@@ -342,7 +342,7 @@ export class Stepper {
             "name": "internal",
             "text": undefined
           }],
-        "text": "This event fires when the active stepper item has changed."
+        "text": "Fires when the active `calcite-stepper-item` changes."
       },
       "complexType": {
         "original": "StepperItemChangeEventDetail",
@@ -368,7 +368,7 @@ export class Stepper {
         "return": "Promise<void>"
       },
       "docs": {
-        "text": "set the next step as active",
+        "text": "Set the next `calcite-stepper-item` as active.",
         "tags": []
       }
     },
@@ -384,7 +384,7 @@ export class Stepper {
         "return": "Promise<void>"
       },
       "docs": {
-        "text": "set the previous step as active",
+        "text": "Set the previous `calcite-stepper-item` as active.",
         "tags": []
       }
     },
@@ -406,7 +406,7 @@ export class Stepper {
         "return": "Promise<void>"
       },
       "docs": {
-        "text": "set the requested step as active",
+        "text": "Set a specified `calcite-stepper-item` as active.",
         "tags": [{
             "name": "param",
             "text": "step"
@@ -425,7 +425,7 @@ export class Stepper {
         "return": "Promise<void>"
       },
       "docs": {
-        "text": "set the first step as active",
+        "text": "Set the first `calcite-stepper-item` as active.",
         "tags": []
       }
     },
@@ -441,7 +441,7 @@ export class Stepper {
         "return": "Promise<void>"
       },
       "docs": {
-        "text": "set the last step as active",
+        "text": "Set the last `calcite-stepper-item` as active.",
         "tags": []
       }
     }

package/dist/collection/components/stepper-item/stepper-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.556
+ * v1.0.0-next.559
  */
 import { Component, Element, Event, h, Host, Listen, Method, Prop, Watch } from "@stencil/core";
 import { getElementProp, toAriaBoolean } from "../../utils/dom";
@@ -16,25 +16,25 @@ export class StepperItem {
     //  Public Properties
     //
     //--------------------------------------------------------------------------
-    /** is the step active */
+    /** When true, the component is active. */
     this.active = false;
-    /** has the step been completed */
+    /** When true, the component's workflow has been completed. */
     this.complete = false;
-    /** does the step contain an error that needs to be resolved by the user */
+    /** When true, the component contains an error that requires resolution from the user. */
     this.error = false;
-    /** is the step disabled and not navigable to by a user */
+    /** When true, interaction is prevented and the component is displayed with lower opacity. */
     this.disabled = false;
     // internal props inherited from wrapping calcite-stepper
-    /** pass a title for the stepper item */
+    /** Defines the layout of the component. */
     /** @internal */
     this.layout = "horizontal";
-    /** should the items display an icon based on status */
+    /** When true, displays a status icon in the `calcite-stepper-item` heading. */
     /** @internal */
     this.icon = false;
-    /** optionally display the step number next to the title and subtitle */
+    /** When true, displays the step number in the `calcite-stepper-item` heading. */
     /** @internal */
     this.numbered = false;
-    /** the scale of the item */
+    /** Specifies the size of the component. */
     /** @internal */
     this.scale = "m";
     //--------------------------------------------------------------------------
@@ -189,7 +189,7 @@ export class StepperItem {
       "optional": false,
       "docs": {
         "tags": [],
-        "text": "is the step active"
+        "text": "When true, the component is active."
       },
       "attribute": "active",
       "reflect": true,
@@ -207,7 +207,7 @@ export class StepperItem {
       "optional": false,
       "docs": {
         "tags": [],
-        "text": "has the step been completed"
+        "text": "When true, the component's workflow has been completed."
       },
       "attribute": "complete",
       "reflect": true,
@@ -225,7 +225,7 @@ export class StepperItem {
       "optional": false,
       "docs": {
         "tags": [],
-        "text": "does the step contain an error that needs to be resolved by the user"
+        "text": "When true, the component contains an error that requires resolution from the user."
       },
       "attribute": "error",
       "reflect": false,
@@ -243,7 +243,7 @@ export class StepperItem {
       "optional": false,
       "docs": {
         "tags": [],
-        "text": "is the step disabled and not navigable to by a user"
+        "text": "When true, interaction is prevented and the component is displayed with lower opacity."
       },
       "attribute": "disabled",
       "reflect": true,
@@ -262,9 +262,9 @@ export class StepperItem {
       "docs": {
         "tags": [{
             "name": "deprecated",
-            "text": "use heading instead"
+            "text": "use \"heading\" instead."
           }],
-        "text": "pass a title for the stepper item"
+        "text": "The component header text."
       },
       "attribute": "item-title",
       "reflect": false
@@ -281,7 +281,7 @@ export class StepperItem {
       "optional": true,
       "docs": {
         "tags": [],
-        "text": "stepper item heading"
+        "text": "The component header text."
       },
       "attribute": "heading",
       "reflect": false
@@ -299,9 +299,9 @@ export class StepperItem {
       "docs": {
         "tags": [{
             "name": "deprecated",
-            "text": "use description instead"
+            "text": "use \"description\" instead."
           }],
-        "text": "pass a title for the stepper item"
+        "text": "A description for the component. Displays below the header text."
       },
       "attribute": "item-subtitle",
       "reflect": false
@@ -318,7 +318,7 @@ export class StepperItem {
       "optional": false,
       "docs": {
         "tags": [],
-        "text": "stepper item description"
+        "text": "A description for the component. Displays below the header text."
       },
       "attribute": "description",
       "reflect": false

package/dist/collection/components/switch/switch.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.556
+ * v1.0.0-next.559
  */
 import { Component, Element, Event, h, Host, Method, Prop, Watch } from "@stencil/core";
 import { focusElement, toAriaBoolean } from "../../utils/dom";
@@ -16,17 +16,17 @@ export class Switch {
     //  Properties
     //
     //--------------------------------------------------------------------------
-    /** True if the switch is disabled */
+    /** When true, interaction is prevented and the component is displayed with lower opacity. */
     this.disabled = false;
-    /** The scale of the switch */
+    /** Specifies the size of the component. */
     this.scale = "m";
     /**
-     * True if the switch is initially on
+     * When true, the component is checked.
      *
-     * @deprecated use 'checked' instead.
+     * @deprecated use "checked" instead.
      */
     this.switched = false;
-    /** True if the switch is initially on */
+    /** When true, the component is checked. */
     this.checked = false;
     //--------------------------------------------------------------------------
     //
@@ -34,8 +34,7 @@ export class Switch {
     //
     //--------------------------------------------------------------------------
     this.keyDownHandler = (event) => {
-      const { key } = event;
-      if (!this.disabled && isActivationKey(key)) {
+      if (!this.disabled && isActivationKey(event.key)) {
         this.toggle();
         event.preventDefault();
       }
@@ -125,7 +124,7 @@ export class Switch {
       "optional": false,
       "docs": {
         "tags": [],
-        "text": "True if the switch is disabled"
+        "text": "When true, interaction is prevented and the component is displayed with lower opacity."
       },
       "attribute": "disabled",
       "reflect": true,
@@ -143,7 +142,7 @@ export class Switch {
       "optional": true,
       "docs": {
         "tags": [],
-        "text": "Applies to the aria-label attribute on the switch"
+        "text": "Accessible name for the component."
       },
       "attribute": "label",
       "reflect": false
@@ -160,7 +159,7 @@ export class Switch {
       "optional": false,
       "docs": {
         "tags": [],
-        "text": "The name of the switch input"
+        "text": "Specifies the name of the component on form submission."
       },
       "attribute": "name",
       "reflect": true
@@ -182,7 +181,7 @@ export class Switch {
       "optional": false,
       "docs": {
         "tags": [],
-        "text": "The scale of the switch"
+        "text": "Specifies the size of the component."
       },
       "attribute": "scale",
       "reflect": true,
@@ -201,9 +200,9 @@ export class Switch {
       "docs": {
         "tags": [{
             "name": "deprecated",
-            "text": "use 'checked' instead."
+            "text": "use \"checked\" instead."
           }],
-        "text": "True if the switch is initially on"
+        "text": "When true, the component is checked."
       },
       "attribute": "switched",
       "reflect": false,
@@ -221,7 +220,7 @@ export class Switch {
       "optional": false,
       "docs": {
         "tags": [],
-        "text": "True if the switch is initially on"
+        "text": "When true, the component is checked."
       },
       "attribute": "checked",
       "reflect": true,
@@ -239,7 +238,7 @@ export class Switch {
       "optional": false,
       "docs": {
         "tags": [],
-        "text": "The value of the switch input"
+        "text": "The component's value."
       },
       "attribute": "value",
       "reflect": false
@@ -253,7 +252,7 @@ export class Switch {
       "composed": true,
       "docs": {
         "tags": [],
-        "text": "Fires when the checked value has changed.\n\n**Note:** The event payload is deprecated, please use the `checked` property on the component instead"
+        "text": "Fires when the checked value has changed.\n\n**Note:** The event payload is deprecated, use the component's \"checked\" property instead."
       },
       "complexType": {
         "original": "DeprecatedEventPayload",

package/dist/collection/components/tab/interfaces.js

@@ -1,6 +1,6 @@
 /*!
  * 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.556
+ * v1.0.0-next.559
  */
 export {};

package/dist/collection/components/tab/tab.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.556
+ * v1.0.0-next.559
  */
 import { Component, Prop, Element, Listen, Method, Event, h, State, Host, Watch } from "@stencil/core";
 import { guid } from "../../utils/guid";

package/dist/collection/components/tab-nav/tab-nav.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.556
+ * v1.0.0-next.559
  */
 import { Component, Element, Event, h, Host, Listen, Prop, State, Watch } from "@stencil/core";
 import { getElementDir, filterDirectChildren } from "../../utils/dom";

package/dist/collection/components/tab-title/tab-title.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.556
+ * v1.0.0-next.559
  */
 import { Build, Component, Element, Event, h, Host, Listen, Method, Prop, State, Watch } from "@stencil/core";
 import { guid } from "../../utils/guid";

package/dist/collection/components/tabs/interfaces.js

@@ -1,6 +1,6 @@
 /*!
  * 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.556
+ * v1.0.0-next.559
  */
 export {};

package/dist/collection/components/tabs/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.556
+ * v1.0.0-next.559
  */
 export const SLOTS = {
   tabNav: "tab-nav"

package/dist/collection/components/tabs/tabs.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.556
+ * v1.0.0-next.559
  */
 import { Component, Prop, h, Element, Listen, State, Fragment } from "@stencil/core";
 import { SLOTS } from "./resources";

package/dist/collection/components/tile/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.556
+ * v1.0.0-next.559
  */
 export const SLOTS = {
   contentStart: "content-start",

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

package/dist/collection/components/tile-select/interfaces.js

@@ -1,6 +1,6 @@
 /*!
  * 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.556
+ * v1.0.0-next.559
  */
 export {};

package/dist/collection/components/tile-select/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.556
+ * v1.0.0-next.559
  */
 export const CSS = {
   checked: "checked",

package/dist/collection/components/tile-select/tile-select.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.556
+ * v1.0.0-next.559
  */
 import { Component, Element, Event, h, Prop, Listen, Watch, State, Method } from "@stencil/core";
 import { guid } from "../../utils/guid";

package/dist/collection/components/tile-select-group/interfaces.js

@@ -1,6 +1,6 @@
 /*!
  * 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.556
+ * v1.0.0-next.559
  */
 export {};

package/dist/collection/components/tile-select-group/tile-select-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.556
+ * v1.0.0-next.559
  */
 import { Component, h, Prop, Element } from "@stencil/core";
 import { updateHostInteraction } from "../../utils/interactive";

package/dist/collection/components/time-picker/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.556
+ * v1.0.0-next.559
  */
 export const CSS = {
   button: "button",

package/dist/collection/components/time-picker/time-picker.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.556
+ * v1.0.0-next.559
  */
 import { Component, Element, h, Prop, Event, Watch, State, Listen, Method } from "@stencil/core";
 import { isActivationKey, numberKeys } from "../../utils/key";
@@ -448,24 +448,31 @@ export class TimePicker {
     this.calciteInternalTimePickerFocus.emit();
   }
   keyDownHandler(event) {
-    const { key } = event;
+    const { defaultPrevented, key } = event;
+    if (defaultPrevented) {
+      return;
+    }
     switch (this.activeEl) {
       case this.hourEl:
         if (key === "ArrowRight") {
           this.setFocus("minute");
+          event.preventDefault();
         }
         break;
       case this.minuteEl:
         switch (key) {
           case "ArrowLeft":
             this.setFocus("hour");
+            event.preventDefault();
             break;
           case "ArrowRight":
             if (this.step !== 60) {
               this.setFocus("second");
+              event.preventDefault();
             }
             else if (this.hourCycle === "12") {
               this.setFocus("meridiem");
+              event.preventDefault();
             }
             break;
         }
@@ -474,10 +481,12 @@ export class TimePicker {
         switch (key) {
           case "ArrowLeft":
             this.setFocus("minute");
+            event.preventDefault();
             break;
           case "ArrowRight":
             if (this.hourCycle === "12") {
               this.setFocus("meridiem");
+              event.preventDefault();
             }
             break;
         }
@@ -487,9 +496,11 @@ export class TimePicker {
           case "ArrowLeft":
             if (this.step !== 60) {
               this.setFocus("second");
+              event.preventDefault();
             }
             else {
               this.setFocus("minute");
+              event.preventDefault();
             }
             break;
         }

package/dist/collection/components/tip/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.556
+ * v1.0.0-next.559
  */
 import { HEADING_LEVEL as PARENT_HEADING_LEVEL } from "../tip-manager/resources";
 export const CSS = {

package/dist/collection/components/tip/tip.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.556
+ * v1.0.0-next.559
  */
 import { Component, Element, Event, Prop, h, Fragment } from "@stencil/core";
 import { CSS, ICONS, SLOTS, TEXT, HEADING_LEVEL } from "./resources";

package/dist/collection/components/tip-group/tip-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.556
+ * v1.0.0-next.559
  */
 import { Component, Prop, h } from "@stencil/core";
 /**