@esri/calcite-components 1.0.0-next.495 → 1.0.0-next.496

package/dist/extras/docs-json.json

@@ -1,5 +1,5 @@
 {
-  "timestamp": "2022-06-15T16:17:28",
+  "timestamp": "2022-06-15T20:24:59",
   "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"
@@ -17076,6 +17182,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 +17232,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 +17255,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 +17277,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"

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.495
+ * v1.0.0-next.496
  */
 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.495
+ * v1.0.0-next.496
  */
 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.495
+ * v1.0.0-next.496
  */
 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.495
+ * v1.0.0-next.496
  */
 (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-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;

package/dist/types/components.d.ts

@@ -64,16 +64,26 @@ export namespace Components {
           * Indicates whether the item is active.
          */
         "active": boolean;
+        /**
+          * accordion item description
+         */
+        "description": string;
+        /**
+          * accordion item heading
+         */
+        "heading"?: string;
         /**
           * optionally pass an icon to display - accepts Calcite UI icon names
          */
         "icon"?: string;
         /**
           * pass a title for the accordion item
+          * @deprecated use description instead
          */
         "itemSubtitle"?: string;
         /**
           * pass a title for the accordion item
+          * @deprecated use heading instead
          */
         "itemTitle"?: string;
     }
@@ -341,6 +351,10 @@ export namespace Components {
           * When true, this block will be collapsible.
          */
         "collapsible": boolean;
+        /**
+          * Block description
+         */
+        "description": string;
         /**
           * When true, disabled prevents interaction. This state shows items with lower opacity/grayed.
          */
@@ -391,6 +405,7 @@ export namespace Components {
         "status"?: Status;
         /**
           * Block summary.
+          * @deprecated use description instead
          */
         "summary": string;
     }
@@ -2164,6 +2179,10 @@ export namespace Components {
           * When provided, this method will be called before it is removed from the parent flow.
          */
         "beforeBack"?: () => Promise<void>;
+        /**
+          * Panel description
+         */
+        "description": string;
         /**
           * When true, disabled prevents interaction. This state shows items with lower opacity/grayed.
          */
@@ -2224,6 +2243,7 @@ export namespace Components {
         "showBackButton": boolean;
         /**
           * Summary text. A description displayed underneath the heading.
+          * @deprecated use description instead
          */
         "summary"?: string;
         /**
@@ -2981,6 +3001,10 @@ export namespace Components {
           * has the step been completed
          */
         "complete": boolean;
+        /**
+          * stepper item description
+         */
+        "description": string;
         /**
           * is the step disabled and not navigable to by a user
          */
@@ -2989,13 +3013,19 @@ export namespace Components {
           * does the step contain an error that needs to be resolved by the user
          */
         "error": boolean;
+        /**
+          * stepper item heading
+         */
+        "heading"?: string;
         "icon": boolean;
         /**
           * pass a title for the stepper item
+          * @deprecated use description instead
          */
         "itemSubtitle"?: string;
         /**
           * pass a title for the stepper item
+          * @deprecated use heading instead
          */
         "itemTitle"?: string;
         "layout"?: string;
@@ -4488,16 +4518,26 @@ declare namespace LocalJSX {
           * Indicates whether the item is active.
          */
         "active"?: boolean;
+        /**
+          * accordion item description
+         */
+        "description"?: string;
+        /**
+          * accordion item heading
+         */
+        "heading"?: string;
         /**
           * optionally pass an icon to display - accepts Calcite UI icon names
          */
         "icon"?: string;
         /**
           * pass a title for the accordion item
+          * @deprecated use description instead
          */
         "itemSubtitle"?: string;
         /**
           * pass a title for the accordion item
+          * @deprecated use heading instead
          */
         "itemTitle"?: string;
     }
@@ -4720,13 +4760,9 @@ declare namespace LocalJSX {
           * Accessible name for the component
          */
         "label": string;
-        /**
-          * Fired when an alert is closed
-         */
+        "onCalciteAlertBeforeClose"?: (event: CalciteAlertCustomEvent<any>) => void;
+        "onCalciteAlertBeforeOpen"?: (event: CalciteAlertCustomEvent<any>) => void;
         "onCalciteAlertClose"?: (event: CalciteAlertCustomEvent<any>) => void;
-        /**
-          * Fired when an alert is opened
-         */
         "onCalciteAlertOpen"?: (event: CalciteAlertCustomEvent<any>) => void;
         /**
           * specify the placement of the alert
@@ -4764,6 +4800,10 @@ declare namespace LocalJSX {
           * When true, this block will be collapsible.
          */
         "collapsible"?: boolean;
+        /**
+          * Block description
+         */
+        "description"?: string;
         /**
           * When true, disabled prevents interaction. This state shows items with lower opacity/grayed.
          */
@@ -4818,6 +4858,7 @@ declare namespace LocalJSX {
         "status"?: Status;
         /**
           * Block summary.
+          * @deprecated use description instead
          */
         "summary"?: string;
     }
@@ -6588,6 +6629,10 @@ declare namespace LocalJSX {
           * When provided, this method will be called before it is removed from the parent flow.
          */
         "beforeBack"?: () => Promise<void>;
+        /**
+          * Panel description
+         */
+        "description"?: string;
         /**
           * When true, disabled prevents interaction. This state shows items with lower opacity/grayed.
          */
@@ -6655,6 +6700,7 @@ declare namespace LocalJSX {
         "showBackButton"?: boolean;
         /**
           * Summary text. A description displayed underneath the heading.
+          * @deprecated use description instead
          */
         "summary"?: string;
         /**
@@ -7383,6 +7429,10 @@ declare namespace LocalJSX {
           * has the step been completed
          */
         "complete"?: boolean;
+        /**
+          * stepper item description
+         */
+        "description"?: string;
         /**
           * is the step disabled and not navigable to by a user
          */
@@ -7391,12 +7441,18 @@ declare namespace LocalJSX {
           * does the step contain an error that needs to be resolved by the user
          */
         "error"?: boolean;
+        /**
+          * stepper item heading
+         */
+        "heading"?: string;
         /**
           * pass a title for the stepper item
+          * @deprecated use description instead
          */
         "itemSubtitle"?: string;
         /**
           * pass a title for the stepper item
+          * @deprecated use heading instead
          */
         "itemTitle"?: string;
     }

package/dist/types/preact.d.ts

@@ -35,8 +35,10 @@ declare module "preact/src/jsx" {
         "oncalciteActionPadToggle"?: (event: CustomEvent<any>) => void;
       }
 
-      "calcite-alert": Omit<JSX.CalciteAlert, "onCalciteAlertClose" | "onCalciteAlertOpen" | "onCalciteInternalAlertSync" | "onCalciteInternalAlertRegister"> & JSXInternal.HTMLAttributes<HTMLCalciteAlertElement> & {
+      "calcite-alert": Omit<JSX.CalciteAlert, "onCalciteAlertBeforeClose" | "onCalciteAlertClose" | "onCalciteAlertBeforeOpen" | "onCalciteAlertOpen" | "onCalciteInternalAlertSync" | "onCalciteInternalAlertRegister"> & JSXInternal.HTMLAttributes<HTMLCalciteAlertElement> & {
+        "oncalciteAlertBeforeClose"?: (event: CustomEvent<any>) => void;
         "oncalciteAlertClose"?: (event: CustomEvent<any>) => void;
+        "oncalciteAlertBeforeOpen"?: (event: CustomEvent<any>) => void;
         "oncalciteAlertOpen"?: (event: CustomEvent<any>) => void;
         "oncalciteInternalAlertSync"?: (event: CustomEvent<any>) => void;
         "oncalciteInternalAlertRegister"?: (event: CustomEvent<any>) => void;