@esri/calcite-components 1.0.0-next.493 → 1.0.0-next.497

package/dist/extras/docs-json.json

@@ -1,5 +1,5 @@
 {
-  "timestamp": "2022-06-14T02:51:48",
+  "timestamp": "2022-06-16T00:30:44",
   "compiler": {
     "name": "@stencil/core",
     "version": "2.16.1",
@@ -211,6 +211,38 @@
           "optional": false,
           "required": false
         },
+        {
+          "name": "description",
+          "type": "string",
+          "mutable": false,
+          "attr": "description",
+          "reflectToAttr": false,
+          "docs": "accordion item description",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false
+        },
+        {
+          "name": "heading",
+          "type": "string",
+          "mutable": false,
+          "attr": "heading",
+          "reflectToAttr": false,
+          "docs": "accordion item heading",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": true,
+          "required": false
+        },
         {
           "name": "icon",
           "type": "string",
@@ -234,7 +266,13 @@
           "attr": "item-subtitle",
           "reflectToAttr": false,
           "docs": "pass a title for the accordion item",
-          "docsTags": [],
+          "docsTags": [
+            {
+              "name": "deprecated",
+              "text": "use description instead"
+            }
+          ],
+          "deprecation": "use description instead",
           "values": [
             {
               "type": "string"
@@ -250,7 +288,13 @@
           "attr": "item-title",
           "reflectToAttr": false,
           "docs": "pass a title for the accordion item",
-          "docsTags": [],
+          "docsTags": [
+            {
+              "name": "deprecated",
+              "text": "use heading instead"
+            }
+          ],
+          "deprecation": "use heading instead",
           "values": [
             {
               "type": "string"
@@ -1826,13 +1870,31 @@
         }
       ],
       "events": [
+        {
+          "event": "calciteAlertBeforeClose",
+          "detail": "any",
+          "bubbles": true,
+          "cancelable": true,
+          "composed": true,
+          "docs": "",
+          "docsTags": []
+        },
+        {
+          "event": "calciteAlertBeforeOpen",
+          "detail": "any",
+          "bubbles": true,
+          "cancelable": true,
+          "composed": true,
+          "docs": "",
+          "docsTags": []
+        },
         {
           "event": "calciteAlertClose",
           "detail": "any",
           "bubbles": true,
           "cancelable": true,
           "composed": true,
-          "docs": "Fired when an alert is closed",
+          "docs": "",
           "docsTags": []
         },
         {
@@ -1841,7 +1903,7 @@
           "bubbles": true,
           "cancelable": true,
           "composed": true,
-          "docs": "Fired when an alert is opened",
+          "docs": "",
           "docsTags": []
         }
       ],
@@ -2063,6 +2125,22 @@
           "optional": false,
           "required": false
         },
+        {
+          "name": "description",
+          "type": "string",
+          "mutable": false,
+          "attr": "description",
+          "reflectToAttr": false,
+          "docs": "Block description",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false
+        },
         {
           "name": "disabled",
           "type": "boolean",
@@ -2304,7 +2382,13 @@
           "attr": "summary",
           "reflectToAttr": false,
           "docs": "Block summary.",
-          "docsTags": [],
+          "docsTags": [
+            {
+              "name": "deprecated",
+              "text": "use description instead"
+            }
+          ],
+          "deprecation": "use description instead",
           "values": [
             {
               "type": "string"
@@ -12442,6 +12526,22 @@
           "optional": true,
           "required": false
         },
+        {
+          "name": "description",
+          "type": "string",
+          "mutable": false,
+          "attr": "description",
+          "reflectToAttr": false,
+          "docs": "Panel description",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false
+        },
         {
           "name": "disabled",
           "type": "boolean",
@@ -12677,7 +12777,13 @@
           "attr": "summary",
           "reflectToAttr": false,
           "docs": "Summary text. A description displayed underneath the heading.",
-          "docsTags": [],
+          "docsTags": [
+            {
+              "name": "deprecated",
+              "text": "use description instead"
+            }
+          ],
+          "deprecation": "use description instead",
           "values": [
             {
               "type": "string"
@@ -16998,7 +17104,17 @@
           "docsTags": []
         }
       ],
-      "events": [],
+      "events": [
+        {
+          "event": "calciteStepperItemChange",
+          "detail": "StepperItemChangeEventDetail",
+          "bubbles": true,
+          "cancelable": true,
+          "composed": true,
+          "docs": "This event fires when the active stepper item has changed.",
+          "docsTags": []
+        }
+      ],
       "listeners": [
         {
           "event": "calciteInternalStepperItemKeyEvent",
@@ -17014,6 +17130,11 @@
           "event": "calciteInternalStepperItemSelect",
           "capture": false,
           "passive": false
+        },
+        {
+          "event": "calciteInternalUserRequestedStepperItemSelect",
+          "capture": false,
+          "passive": false
         }
       ],
       "styles": [],
@@ -17076,6 +17197,22 @@
           "optional": false,
           "required": false
         },
+        {
+          "name": "description",
+          "type": "string",
+          "mutable": false,
+          "attr": "description",
+          "reflectToAttr": false,
+          "docs": "stepper item description",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false
+        },
         {
           "name": "disabled",
           "type": "boolean",
@@ -17110,6 +17247,22 @@
           "optional": false,
           "required": false
         },
+        {
+          "name": "heading",
+          "type": "string",
+          "mutable": false,
+          "attr": "heading",
+          "reflectToAttr": false,
+          "docs": "stepper item heading",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": true,
+          "required": false
+        },
         {
           "name": "itemSubtitle",
           "type": "string",
@@ -17117,7 +17270,13 @@
           "attr": "item-subtitle",
           "reflectToAttr": false,
           "docs": "pass a title for the stepper item",
-          "docsTags": [],
+          "docsTags": [
+            {
+              "name": "deprecated",
+              "text": "use description instead"
+            }
+          ],
+          "deprecation": "use description instead",
           "values": [
             {
               "type": "string"
@@ -17133,7 +17292,13 @@
           "attr": "item-title",
           "reflectToAttr": false,
           "docs": "pass a title for the stepper item",
-          "docsTags": [],
+          "docsTags": [
+            {
+              "name": "deprecated",
+              "text": "use heading instead"
+            }
+          ],
+          "deprecation": "use heading instead",
           "values": [
             {
               "type": "string"
@@ -17813,13 +17978,13 @@
         },
         {
           "name": "position",
-          "type": "\"above\" | \"below\"",
+          "type": "\"above\" | \"below\" | \"bottom\" | \"top\"",
           "mutable": false,
           "attr": "position",
           "reflectToAttr": true,
-          "docs": "Display the tabs above (default) or below the tab content",
+          "docs": "Display the tabs top (default) or bottom of the tab content. above and below are deprecated.",
           "docsTags": [],
-          "default": "\"above\"",
+          "default": "\"top\"",
           "values": [
             {
               "value": "above",
@@ -17828,6 +17993,14 @@
             {
               "value": "below",
               "type": "string"
+            },
+            {
+              "value": "bottom",
+              "type": "string"
+            },
+            {
+              "value": "top",
+              "type": "string"
             }
           ],
           "optional": false,

package/dist/loader/cdn.js

@@ -1,7 +1,7 @@
 /*!
  * All material copyright ESRI, All Rights Reserved, unless otherwise specified.
  * See https://github.com/Esri/calcite-components/blob/master/LICENSE.md for details.
- * v1.0.0-next.493
+ * v1.0.0-next.497
  */
 module.exports = require('../cjs/loader.cjs.js');
 module.exports.applyPolyfills = function() { return Promise.resolve() };

package/dist/loader/index.cjs.js

@@ -1,7 +1,7 @@
 /*!
  * All material copyright ESRI, All Rights Reserved, unless otherwise specified.
  * See https://github.com/Esri/calcite-components/blob/master/LICENSE.md for details.
- * v1.0.0-next.493
+ * v1.0.0-next.497
  */
 module.exports = require('../cjs/loader.cjs.js');
 module.exports.applyPolyfills = function() { return Promise.resolve() };

package/dist/loader/index.es2017.js

@@ -1,7 +1,7 @@
 /*!
  * All material copyright ESRI, All Rights Reserved, unless otherwise specified.
  * See https://github.com/Esri/calcite-components/blob/master/LICENSE.md for details.
- * v1.0.0-next.493
+ * v1.0.0-next.497
  */
 export * from '../esm/polyfills/index.js';
 export * from '../esm/loader.js';

package/dist/loader/index.js

@@ -1,7 +1,7 @@
 /*!
  * All material copyright ESRI, All Rights Reserved, unless otherwise specified.
  * See https://github.com/Esri/calcite-components/blob/master/LICENSE.md for details.
- * v1.0.0-next.493
+ * v1.0.0-next.497
  */
 (function(){if("undefined"!==typeof window&&void 0!==window.Reflect&&void 0!==window.customElements){var a=HTMLElement;window.HTMLElement=function(){return Reflect.construct(a,[],this.constructor)};HTMLElement.prototype=a.prototype;HTMLElement.prototype.constructor=HTMLElement;Object.setPrototypeOf(HTMLElement,a)}})();
 export * from '../esm/polyfills/index.js';

package/dist/types/components/accordion-item/accordion-item.d.ts

@@ -6,10 +6,24 @@ export declare class AccordionItem {
   el: HTMLCalciteAccordionItemElement;
   /** Indicates whether the item is active. */
   active: boolean;
-  /** pass a title for the accordion item */
+  /**
+   * pass a title for the accordion item
+   *
+   * @deprecated use heading instead
+   */
   itemTitle?: string;
-  /** pass a title for the accordion item */
+  /** accordion item heading */
+  heading?: string;
+  /**
+   * pass a title for the accordion item
+   *
+   * @deprecated use description instead
+   */
   itemSubtitle?: string;
+  /**
+   * accordion item description
+   */
+  description: string;
   /** optionally pass an icon to display - accepts Calcite UI icon names  */
   icon?: string;
   /**

package/dist/types/components/alert/alert.d.ts

@@ -44,9 +44,9 @@ export declare class Alert {
   componentWillLoad(): void;
   disconnectedCallback(): void;
   render(): VNode;
-  /** Fired when an alert is closed */
+  calciteAlertBeforeClose: EventEmitter;
   calciteAlertClose: EventEmitter;
-  /** Fired when an alert is opened */
+  calciteAlertBeforeOpen: EventEmitter;
   calciteAlertOpen: EventEmitter;
   /**
    * Fired to sync queue when opened or closed
@@ -70,6 +70,8 @@ export declare class Alert {
   queueLength: number;
   /** is the alert queued */
   queued: boolean;
+  private containerDiv;
+  private setContainerDiv;
   /** the close button element */
   private closeButton?;
   private autoDismissTimeoutId;
@@ -80,9 +82,11 @@ export declare class Alert {
   private activeTransitionProp;
   /** determine which alert is active */
   private determineActiveAlert;
-  /** close and emit the closed alert and the queue */
+  /** close and emit calciteInternalAlertSync event with the updated queue payload */
   private closeAlert;
+  onTransitionRun: (event: TransitionEvent) => void;
   transitionEnd: (event: TransitionEvent) => void;
-  /** emit the opened alert and the queue */
+  /** remove queued class after animation completes */
   private openAlert;
+  private openCloseEventEmitter;
 }

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

@@ -11,3 +11,6 @@ export declare const SLOTS: {
   message: string;
   link: string;
 };
+export declare const CSS: {
+  container: string;
+};

package/dist/types/components/block/block.d.ts

@@ -68,8 +68,12 @@ export declare class Block implements ConditionalSlotComponent, InteractiveCompo
   status?: Status;
   /**
    * Block summary.
+   *
+   * @deprecated use description instead
    */
   summary: string;
+  /**Block description */
+  description: string;
   componentDidRender(): void;
   el: HTMLCalciteBlockElement;
   private guid;

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

@@ -11,6 +11,7 @@ export declare const CSS: {
   header: string;
   button: string;
   summary: string;
+  description: string;
   controlContainer: string;
   valid: string;
   invalid: string;

package/dist/types/components/panel/panel.d.ts

@@ -69,8 +69,12 @@ export declare class Panel implements ConditionalSlotComponent, InteractiveCompo
   heading?: string;
   /**
    * Summary text. A description displayed underneath the heading.
+   *
+   * @deprecated use description instead
    */
   summary?: string;
+  /** Panel description */
+  description: string;
   /**
    * Opens the action menu.
    */

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

@@ -4,6 +4,7 @@ export declare const CSS: {
   header: string;
   heading: string;
   summary: string;
+  description: string;
   headerContent: string;
   headerActions: string;
   headerActionsEnd: string;

package/dist/types/components/stepper/stepper.d.ts

@@ -17,6 +17,11 @@ export declare class Stepper {
   /** @internal */
   requestedContent: Node[];
   contentWatcher(): void;
+  /**
+   * This event fires when the active stepper item has changed.
+   *
+   */
+  calciteStepperItemChange: EventEmitter<StepperItemChangeEventDetail>;
   /**
    * This event fires when the active stepper item has changed.
    *
@@ -29,6 +34,7 @@ export declare class Stepper {
   calciteInternalStepperItemKeyEvent(e: CustomEvent<StepperItemKeyEventDetail>): void;
   registerItem(event: CustomEvent<StepperItemEventDetail>): void;
   updateItem(event: CustomEvent<StepperItemEventDetail>): void;
+  handleUserRequestedStepperItemSelect(event: CustomEvent<StepperItemChangeEventDetail>): void;
   /** set the next step as active */
   nextStep(): Promise<void>;
   /** set the previous step as active */

package/dist/types/components/stepper-item/stepper-item.d.ts

@@ -15,10 +15,22 @@ export declare class StepperItem implements InteractiveComponent {
   error: boolean;
   /** is the step disabled and not navigable to by a user */
   disabled: boolean;
-  /** pass a title for the stepper item */
+  /**
+   * pass a title for the stepper item
+   *
+   * @deprecated use heading instead
+   */
   itemTitle?: string;
-  /** pass a title for the stepper item */
+  /** stepper item heading */
+  heading?: string;
+  /**
+   * pass a title for the stepper item
+   *
+   * @deprecated use description instead
+   */
   itemSubtitle?: string;
+  /** stepper item description */
+  description: string;
   /** pass a title for the stepper item */
   /** @internal */
   layout?: string;
@@ -40,6 +52,10 @@ export declare class StepperItem implements InteractiveComponent {
    * @internal
    */
   calciteInternalStepperItemSelect: EventEmitter<StepperItemEventDetail>;
+  /**
+   * @internal
+   */
+  calciteInternalUserRequestedStepperItemSelect: EventEmitter<StepperItemChangeEventDetail>;
   /**
    * @internal
    */
@@ -60,6 +76,7 @@ export declare class StepperItem implements InteractiveComponent {
   private renderIcon;
   private determineActiveItem;
   private registerStepperItem;
+  private emitUserRequestedItem;
   private emitRequestedItem;
   private setItemContent;
   private getItemPosition;

package/dist/types/components/tabs/interfaces.d.ts

@@ -1,3 +1,3 @@
 export declare type TabID = string | number;
-export declare type TabPosition = "above" | "below";
+export declare type TabPosition = "above" | "below" | "top" | "bottom";
 export declare type TabLayout = "center" | "inline";

package/dist/types/components/tabs/tabs.d.ts

@@ -12,7 +12,8 @@ export declare class Tabs {
    */
   layout: TabLayout;
   /**
-   * Display the tabs above (default) or below the tab content
+   * Display the tabs top (default) or bottom of the tab content. above and below are deprecated.
+   *
    */
   position: TabPosition;
   /**