@esri/calcite-components 1.0.0-next.282 → 1.0.0-next.283

package/dist/collection/components/calcite-stepper/calcite-stepper.js

@@ -1,5 +1,8 @@
 import { Component, Element, Event, h, Listen, Method, Prop, Watch } from "@stencil/core";
 import { getKey } from "../../utils/key";
+/**
+ * @slot - A slot for adding `calcite-stepper-item`s.
+ */
 export class CalciteStepper {
   constructor() {
     //--------------------------------------------------------------------------

package/dist/collection/components/calcite-stepper-item/calcite-stepper-item.css

@@ -89,13 +89,13 @@
   --calcite-stepper-item-spacing-unit-m: 0.75rem;
   --calcite-stepper-item-spacing-unit-l: 1rem;
   font-size: var(--calcite-font-size--1);
-  line-height: 1.375;
+  line-height: 1rem;
   margin-right: 0.25rem;
 }
 
 :host([scale=s]) .stepper-item-subtitle {
   font-size: var(--calcite-font-size--2);
-  line-height: 1.375;
+  line-height: 1rem;
 }
 
 :host([scale=m]) {
@@ -103,13 +103,13 @@
   --calcite-stepper-item-spacing-unit-m: 1rem;
   --calcite-stepper-item-spacing-unit-l: 1.25rem;
   font-size: var(--calcite-font-size-0);
-  line-height: 1.375;
+  line-height: 1.25rem;
   margin-right: 0.5rem;
 }
 
 :host([scale=m]) .stepper-item-subtitle {
   font-size: var(--calcite-font-size--1);
-  line-height: 1.375;
+  line-height: 1rem;
 }
 
 :host([scale=l]) {
@@ -117,13 +117,13 @@
   --calcite-stepper-item-spacing-unit-m: 1.25rem;
   --calcite-stepper-item-spacing-unit-l: 1.5rem;
   font-size: var(--calcite-font-size-1);
-  line-height: 1.375;
+  line-height: 1.5rem;
   margin-right: 0.75rem;
 }
 
 :host([scale=l]) .stepper-item-subtitle {
   font-size: var(--calcite-font-size-0);
-  line-height: 1.375;
+  line-height: 1.25rem;
 }
 
 :host {
@@ -131,6 +131,7 @@
   flex-grow: 1;
   flex-direction: column;
   position: relative;
+  margin-bottom: var(--calcite-stepper-item-spacing-unit-s);
 }
 
 :host .container {
@@ -354,7 +355,6 @@
   margin-right: 0;
   margin-top: 0;
   padding-left: var(--calcite-stepper-item-spacing-unit-l);
-  margin-bottom: var(--calcite-stepper-item-spacing-unit-s);
 }
 
 :host([layout=vertical]) .container .stepper-item-icon {

package/dist/collection/components/calcite-stepper-item/calcite-stepper-item.js

@@ -2,6 +2,9 @@ import { Component, Element, Event, h, Host, Listen, Prop, Watch } from "@stenci
 import { getElementDir, getElementProp } from "../../utils/dom";
 import { getKey } from "../../utils/key";
 import { CSS_UTILITY } from "../../utils/resources";
+/**
+ * @slot - A slot for adding custom content.
+ */
 export class CalciteStepperItem {
   constructor() {
     //--------------------------------------------------------------------------

package/dist/collection/components/calcite-switch/calcite-switch.css

@@ -194,23 +194,23 @@
   box-shadow: inset 0 0 0 1px var(--calcite-ui-brand);
 }
 
-:host([switched]) .track {
+:host([checked]) .track {
   background-color: var(--calcite-ui-brand);
   border-color: var(--calcite-ui-brand-hover);
 }
 
-:host([switched]) .handle {
+:host([checked]) .handle {
   left: auto;
   border-color: var(--calcite-ui-brand);
   right: -1px;
 }
 
-:host([switched]:hover) .track {
+:host([checked]:hover) .track {
   background-color: var(--calcite-ui-brand);
   border-color: var(--calcite-ui-brand-hover);
 }
 
-:host([switched]:hover) .handle {
+:host([checked]:hover) .handle {
   border-color: var(--calcite-ui-brand-hover);
   box-shadow: inset 0 0 0 1px var(--calcite-ui-brand-hover);
 }
@@ -220,17 +220,17 @@
   right: -1px;
 }
 
-:host([switched]) .calcite--rtl .handle {
+:host([checked]) .calcite--rtl .handle {
   right: auto;
   left: -1px;
 }
 
-:host([switched]:active) .calcite--rtl .handle {
+:host([checked]:active) .calcite--rtl .handle {
   right: auto;
   left: -1px;
 }
 
-:host([switched]:focus) .calcite--rtl .handle {
+:host([checked]:focus) .calcite--rtl .handle {
   right: auto;
   left: -1px;
 }

package/dist/collection/components/calcite-switch/calcite-switch.js

@@ -1,9 +1,10 @@
 import { Component, Element, Event, h, Host, Listen, Method, Prop, State, Watch } from "@stencil/core";
-import { focusElement, getElementDir, hasLabel } from "../../utils/dom";
+import { getElementDir } from "../../utils/dom";
 import { hiddenInputStyle } from "../../utils/form";
 import { guid } from "../../utils/guid";
 import { getKey } from "../../utils/key";
 import { CSS_UTILITY } from "../../utils/resources";
+import { connectLabel, disconnectLabel, getLabelText } from "../../utils/label";
 export class CalciteSwitch {
   constructor() {
     //--------------------------------------------------------------------------
@@ -15,14 +16,27 @@ export class CalciteSwitch {
     this.disabled = false;
     /** The scale of the switch */
     this.scale = "m";
-    /** True if the switch is initially on */
+    /** True if the switch is initially on
+     * @deprecated use 'checked' instead.
+     */
     this.switched = false;
+    /** True if the switch is initially on */
+    this.checked = false;
+    this.inputEl = document.createElement("input");
     //--------------------------------------------------------------------------
     //
-    //  Private Properties
+    //  Private Methods
     //
     //--------------------------------------------------------------------------
-    this.inputEl = document.createElement("input");
+    this.onLabelClick = () => {
+      if (!this.disabled) {
+        this.toggle();
+        this.setFocus();
+      }
+    };
+    this.clickHandler = () => {
+      this.toggle();
+    };
   }
   disabledWatcher(newDisabled) {
     this.inputEl.disabled = newDisabled;
@@ -31,24 +45,23 @@ export class CalciteSwitch {
   nameChanged(newName) {
     this.inputEl.name = newName;
   }
-  switchedWatcher(newSwitched) {
-    this.inputEl.checked = newSwitched;
+  switchedWatcher(switched) {
+    this.checked = switched;
+  }
+  checkedWatcher(checked) {
+    this.inputEl.checked = checked;
   }
   //--------------------------------------------------------------------------
   //
   //  Public Methods
   //
   //--------------------------------------------------------------------------
+  /** Sets focus on the component. */
   async setFocus() {
-    focusElement(this.inputEl);
+    this.el.focus();
   }
-  //--------------------------------------------------------------------------
-  //
-  //  Private Methods
-  //
-  //--------------------------------------------------------------------------
   setupInput() {
-    this.switched && this.inputEl.setAttribute("checked", "");
+    this.checked && this.inputEl.setAttribute("checked", "");
     this.inputEl.disabled = this.disabled;
     this.inputEl.id = `${this.guid}-input`;
     this.inputEl.name = this.name;
@@ -60,9 +73,11 @@ export class CalciteSwitch {
     this.el.appendChild(this.inputEl);
   }
   toggle() {
-    this.switched = !this.switched;
+    this.checked = !this.checked;
     this.calciteSwitchChange.emit({
-      switched: this.switched
+      // todo: We should remove emmitting redudant props in event payload.
+      // https://github.com/Esri/calcite-components/issues/3163
+      switched: this.checked
     });
   }
   //--------------------------------------------------------------------------
@@ -70,24 +85,6 @@ export class CalciteSwitch {
   //  Event Listeners
   //
   //--------------------------------------------------------------------------
-  handleLabelFocus(e) {
-    if (!this.disabled &&
-      !this.el.contains(e.detail.interactedEl) &&
-      hasLabel(e.detail.labelEl, this.el)) {
-      this.el.focus();
-    }
-    else {
-      return;
-    }
-  }
-  onClick(e) {
-    // prevent duplicate click events that occur
-    // when the component is wrapped in a label and checkbox is clicked
-    if ((!this.disabled && this.el.closest("label") && e.target === this.inputEl) ||
-      (!this.el.closest("label") && e.target === this.el)) {
-      this.toggle();
-    }
-  }
   keyDownHandler(e) {
     const key = getKey(e.key);
     if (!this.disabled && (key === " " || key === "Enter")) {
@@ -99,6 +96,12 @@ export class CalciteSwitch {
   //  Lifecycle
   //
   //--------------------------------------------------------------------------
+  connectedCallback() {
+    connectLabel(this);
+  }
+  disconnectedCallback() {
+    disconnectLabel(this);
+  }
   componentWillLoad() {
     this.guid = this.el.id || `calcite-switch-${guid()}`;
     this.tabindex = this.el.getAttribute("tabindex") || this.disabled ? -1 : 0;
@@ -111,8 +114,8 @@ export class CalciteSwitch {
   // --------------------------------------------------------------------------
   render() {
     const dir = getElementDir(this.el);
-    return (h(Host, { tabindex: this.tabindex },
-      h("div", { "aria-checked": this.switched.toString(), class: { container: true, [CSS_UTILITY.rtl]: dir === "rtl" } },
+    return (h(Host, { "aria-checked": this.checked.toString(), "aria-label": getLabelText(this), onClick: this.clickHandler, role: "switch", tabindex: this.tabindex },
+      h("div", { class: { container: true, [CSS_UTILITY.rtl]: dir === "rtl" } },
         h("div", { class: "track" },
           h("div", { class: "handle" })))));
   }
@@ -134,7 +137,7 @@ export class CalciteSwitch {
         "references": {}
       },
       "required": false,
-      "optional": true,
+      "optional": false,
       "docs": {
         "tags": [],
         "text": "True if the switch is disabled"
@@ -143,6 +146,23 @@ export class CalciteSwitch {
       "reflect": true,
       "defaultValue": "false"
     },
+    "label": {
+      "type": "string",
+      "mutable": false,
+      "complexType": {
+        "original": "string",
+        "resolved": "string",
+        "references": {}
+      },
+      "required": false,
+      "optional": true,
+      "docs": {
+        "tags": [],
+        "text": "Applies to the aria-label attribute on the switch"
+      },
+      "attribute": "label",
+      "reflect": false
+    },
     "name": {
       "type": "string",
       "mutable": false,
@@ -184,6 +204,27 @@ export class CalciteSwitch {
       "defaultValue": "\"m\""
     },
     "switched": {
+      "type": "boolean",
+      "mutable": false,
+      "complexType": {
+        "original": "boolean",
+        "resolved": "boolean",
+        "references": {}
+      },
+      "required": false,
+      "optional": false,
+      "docs": {
+        "tags": [{
+            "text": "use 'checked' instead.",
+            "name": "deprecated"
+          }],
+        "text": "True if the switch is initially on"
+      },
+      "attribute": "switched",
+      "reflect": false,
+      "defaultValue": "false"
+    },
+    "checked": {
       "type": "boolean",
       "mutable": true,
       "complexType": {
@@ -197,7 +238,7 @@ export class CalciteSwitch {
         "tags": [],
         "text": "True if the switch is initially on"
       },
-      "attribute": "switched",
+      "attribute": "checked",
       "reflect": true,
       "defaultValue": "false"
     },
@@ -231,7 +272,7 @@ export class CalciteSwitch {
       "composed": true,
       "docs": {
         "tags": [],
-        "text": "Fires when the switched value has changed."
+        "text": "Fires when the checked value has changed."
       },
       "complexType": {
         "original": "any",
@@ -252,7 +293,7 @@ export class CalciteSwitch {
         "return": "Promise<void>"
       },
       "docs": {
-        "text": "",
+        "text": "Sets focus on the component.",
         "tags": []
       }
     }
@@ -267,20 +308,11 @@ export class CalciteSwitch {
     }, {
       "propName": "switched",
       "methodName": "switchedWatcher"
+    }, {
+      "propName": "checked",
+      "methodName": "checkedWatcher"
     }]; }
   static get listeners() { return [{
-      "name": "calciteLabelFocus",
-      "method": "handleLabelFocus",
-      "target": "window",
-      "capture": false,
-      "passive": false
-    }, {
-      "name": "click",
-      "method": "onClick",
-      "target": undefined,
-      "capture": false,
-      "passive": false
-    }, {
       "name": "keydown",
       "method": "keyDownHandler",
       "target": undefined,

package/dist/collection/components/calcite-tab/calcite-tab.css

@@ -90,7 +90,6 @@
 
 :host {
   display: none;
-  z-index: 10;
   color: var(--calcite-ui-text-3);
 }
 

package/dist/collection/components/calcite-tab/calcite-tab.js

@@ -1,6 +1,9 @@
 import { Component, Prop, Element, Listen, Method, Event, h, State, Host } from "@stencil/core";
 import { guid } from "../../utils/guid";
 import { nodeListToArray } from "../../utils/dom";
+/**
+ * @slot - A slot for adding custom content.
+ */
 export class CalciteTab {
   constructor() {
     /**

package/dist/collection/components/calcite-tab-nav/calcite-tab-nav.css

@@ -85,7 +85,6 @@
 }
 
 :host {
-  z-index: 20;
   position: relative;
   display: flex;
 }

package/dist/collection/components/calcite-tab-nav/calcite-tab-nav.js

@@ -1,5 +1,8 @@
 import { Component, Element, Event, h, Host, Listen, Prop, State, Watch } from "@stencil/core";
 import { getElementDir, filterDirectChildren } from "../../utils/dom";
+/**
+ * @slot - A slot for adding `calcite-tab-title`s.
+ */
 export class CalciteTabNav {
   constructor() {
     /** @internal Parent tabs component scale value */
@@ -116,12 +119,9 @@ export class CalciteTabNav {
     e.preventDefault();
   }
   activateTabHandler(e) {
-    if (e.detail.tab) {
-      this.selectedTab = e.detail.tab;
-    }
-    else {
-      this.selectedTab = this.getIndexOfTabTitle(e.target);
-    }
+    this.selectedTab = e.detail.tab
+      ? e.detail.tab
+      : this.getIndexOfTabTitle(e.target);
     e.stopPropagation();
     e.preventDefault();
   }
@@ -301,7 +301,7 @@ export class CalciteTabNav {
         "references": {}
       },
       "required": false,
-      "optional": true,
+      "optional": false,
       "docs": {
         "tags": [{
             "text": "Parent tabs component bordered value when layout is \"inline\"",

package/dist/collection/components/calcite-tab-title/calcite-tab-title.js

@@ -3,6 +3,10 @@ import { guid } from "../../utils/guid";
 import { getElementDir, getElementProp } from "../../utils/dom";
 import { getKey } from "../../utils/key";
 import { CSS_UTILITY } from "../../utils/resources";
+import { createObserver } from "../../utils/observers";
+/**
+ * @slot - A slot for adding text.
+ */
 export class CalciteTabTitle {
   constructor() {
     //--------------------------------------------------------------------------
@@ -16,6 +20,13 @@ export class CalciteTabTitle {
     this.disabled = false;
     /** @internal Parent tabs component bordered value */
     this.bordered = false;
+    //--------------------------------------------------------------------------
+    //
+    //  Private State/Props
+    //
+    //--------------------------------------------------------------------------
+    /** watches for changing text content **/
+    this.mutationObserver = createObserver("mutation", () => this.updateHasText());
     /** determine if there is slotted text for styling purposes */
     this.hasText = false;
     /**
@@ -39,10 +50,10 @@ export class CalciteTabTitle {
     this.parentTabsEl = this.el.closest("calcite-tabs");
   }
   disconnectedCallback() {
-    var _a;
-    this.observer.disconnect();
+    var _a, _b;
+    (_a = this.mutationObserver) === null || _a === void 0 ? void 0 : _a.disconnect();
     // Dispatching to body in order to be listened by other elements that are still connected to the DOM.
-    (_a = document.body) === null || _a === void 0 ? void 0 : _a.dispatchEvent(new CustomEvent("calciteTabTitleUnregister", {
+    (_b = document.body) === null || _b === void 0 ? void 0 : _b.dispatchEvent(new CustomEvent("calciteTabTitleUnregister", {
       detail: this.el
     }));
   }
@@ -159,12 +170,8 @@ export class CalciteTabTitle {
     this.hasText = this.el.textContent.trim().length > 0;
   }
   setupTextContentObserver() {
-    if (Build.isBrowser) {
-      this.observer = new MutationObserver(() => {
-        this.updateHasText();
-      });
-      this.observer.observe(this.el, { childList: true, subtree: true });
-    }
+    var _a;
+    (_a = this.mutationObserver) === null || _a === void 0 ? void 0 : _a.observe(this.el, { childList: true, subtree: true });
   }
   emitActiveTab() {
     if (!this.disabled) {
@@ -358,7 +365,7 @@ export class CalciteTabTitle {
         "references": {}
       },
       "required": false,
-      "optional": true,
+      "optional": false,
       "docs": {
         "tags": [{
             "text": "Parent tabs component bordered value",

package/dist/collection/components/calcite-tabs/calcite-tabs.js

@@ -1,7 +1,8 @@
 import { Component, Prop, h, Element, Listen, State, Fragment } from "@stencil/core";
 import { SLOTS } from "./resources";
 /**
- * @slot tab-nav - a slot for adding a tab navigation component
+ * @slot - A slot for adding `calcite-tab`s.
+ * @slot tab-nav - A slot for adding a tab navigation component.
  */
 export class CalciteTabs {
   constructor() {
@@ -237,7 +238,7 @@ export class CalciteTabs {
         "references": {}
       },
       "required": false,
-      "optional": true,
+      "optional": false,
       "docs": {
         "tags": [],
         "text": "Optionally enable tabs to appear like a folder-style menu when its layout is \"inline\""

package/dist/collection/components/calcite-tile/calcite-tile.css

@@ -113,6 +113,15 @@
   padding: 0;
 }
 
+:host([icon][heading]:not([description])) .icon {
+  display: flex;
+  justify-content: center;
+}
+
+:host([icon][heading]:not([description])) .large-visual {
+  text-align: center;
+}
+
 :host([disabled]) {
   opacity: var(--calcite-ui-opacity-disabled);
   pointer-events: none;

package/dist/collection/components/calcite-tile/calcite-tile.js

@@ -7,6 +7,13 @@ import { getSlotted } from "../../utils/dom";
  */
 export class CalciteTile {
   constructor() {
+    //--------------------------------------------------------------------------
+    //
+    //  Properties
+    //
+    //--------------------------------------------------------------------------
+    /** The active state of the tile. */
+    this.active = false;
     /**
      * When true, prevents interaction.
      */
@@ -15,7 +22,7 @@ export class CalciteTile {
     this.embed = false;
     /**
      * The focused state of the tile.
-     * @private
+     * @internal
      */
     this.focused = false;
     /** The hidden state of the tile. */
@@ -68,13 +75,14 @@ export class CalciteTile {
         "references": {}
       },
       "required": false,
-      "optional": true,
+      "optional": false,
       "docs": {
         "tags": [],
         "text": "The active state of the tile."
       },
       "attribute": "active",
-      "reflect": true
+      "reflect": true,
+      "defaultValue": "false"
     },
     "description": {
       "type": "string",
@@ -142,7 +150,7 @@ export class CalciteTile {
       "docs": {
         "tags": [{
             "text": undefined,
-            "name": "private"
+            "name": "internal"
           }],
         "text": "The focused state of the tile."
       },

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

@@ -2,6 +2,9 @@ import { Component, Element, h, Prop, Listen, Watch, State, Method } from "@sten
 import { getElementDir } from "../../utils/dom";
 import { CSS_UTILITY } from "../../utils/resources";
 import { guid } from "../../utils/guid";
+/**
+ * @slot - A slot for adding custom content.
+ */
 export class CalciteTileSelect {
   constructor() {
     //--------------------------------------------------------------------------
@@ -45,6 +48,7 @@ export class CalciteTileSelect {
   //  Public Methods
   //
   //--------------------------------------------------------------------------
+  /** Sets focus on the component. */
   async setFocus() {
     this.input.setFocus();
   }
@@ -397,7 +401,7 @@ export class CalciteTileSelect {
         "return": "Promise<void>"
       },
       "docs": {
-        "text": "",
+        "text": "Sets focus on the component.",
         "tags": []
       }
     }

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

@@ -1,4 +1,7 @@
 import { Component, h, Prop } from "@stencil/core";
+/**
+ * @slot - A slot for adding `calcite-tile-select`s.
+ */
 export class CalciteTileSelectGroup {
   constructor() {
     //--------------------------------------------------------------------------