@esri/calcite-components 1.0.0-beta.83 → 1.0.0-beta.86

package/dist/collection/components/notice/notice.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-beta.83
+ * v1.0.0-beta.86
  */
 import { Component, Element, Event, h, Method, Prop, Watch } from "@stencil/core";
 import { CSS, SLOTS, TEXT } from "./resources";
@@ -15,10 +15,10 @@ import { connectConditionalSlotComponent, disconnectConditionalSlotComponent } f
  * to display a notice on page load and set the "active" attribute as needed to contextually provide inline messaging to users.
  */
 /**
- * @slot title - A slot for adding the title (optional).
+ * @slot title - A slot for adding the title.
  * @slot message - A slot for adding the message.
- * @slot link - A slot for adding actions to take, such as: undo, try again, link to page, etc. (optional).
- * @slot actions-end - A slot for adding actions to the end of the `calcite-notice` (optional). It is recommended to use two or less actions.
+ * @slot link - A slot for adding actions to take, such as: undo, try again, link to page, etc.
+ * @slot actions-end - A slot for adding actions to the end of the component. It is recommended to use two or less actions.
  */
 export class Notice {
   constructor() {
@@ -27,21 +27,27 @@ export class Notice {
     //  Properties
     //
     //---------------------------------------------------------------------------
-    /** When true, the `calcite-notice` is active. */
+    /** When true, the component is active. */
     this.active = false;
-    /** The color for the `calcite-notice`. Color will apply to top border and icon. */
+    /** The color for the component's top border and icon. */
     this.color = "blue";
-    /** Shows a button the user can click to dismiss the `calcite-notice`. */
+    /**
+     * When true, a close button is added to the component.
+     *
+     * @deprecated use closable instead
+     */
     this.dismissible = false;
+    /** When true, displays a button user can click to dismiss the `calcite-notice` */
+    this.closable = false;
     /**
-     * Accessible label for the close button.
+     * Accessible name for the close button.
      *
      * @default "Close"
      */
     this.intlClose = TEXT.close;
-    /** Specify the scale of `calcite-notice`. */
+    /** Specifies the size of the component. */
     this.scale = "m";
-    /** Specify the width of the `calcite-notice`. */
+    /** Specifies the width of the component. */
     this.width = "auto";
     //--------------------------------------------------------------------------
     //
@@ -84,14 +90,14 @@ export class Notice {
         h("slot", { name: SLOTS.link })),
       hasActionEnd ? (h("div", { class: CSS.actionsEnd },
         h("slot", { name: SLOTS.actionsEnd }))) : null,
-      this.dismissible ? closeButton : null));
+      this.closable || this.dismissible ? closeButton : null));
   }
   //--------------------------------------------------------------------------
   //
   //  Public Methods
   //
   //--------------------------------------------------------------------------
-  /** Sets focus on the `calcite-notice`. */
+  /** Sets focus on the component. */
   async setFocus() {
     const noticeLinkEl = this.el.querySelector("calcite-link");
     if (!this.closeButton && !noticeLinkEl) {
@@ -125,7 +131,7 @@ export class Notice {
       "optional": false,
       "docs": {
         "tags": [],
-        "text": "When true, the `calcite-notice` is active."
+        "text": "When true, the component is active."
       },
       "attribute": "active",
       "reflect": true,
@@ -148,7 +154,7 @@ export class Notice {
       "optional": false,
       "docs": {
         "tags": [],
-        "text": "The color for the `calcite-notice`. Color will apply to top border and icon."
+        "text": "The color for the component's top border and icon."
       },
       "attribute": "color",
       "reflect": true,
@@ -165,13 +171,34 @@ export class Notice {
       "required": false,
       "optional": true,
       "docs": {
-        "tags": [],
-        "text": "Shows a button the user can click to dismiss the `calcite-notice`."
+        "tags": [{
+            "name": "deprecated",
+            "text": "use closable instead"
+          }],
+        "text": "When true, a close button is added to the component."
       },
       "attribute": "dismissible",
       "reflect": true,
       "defaultValue": "false"
     },
+    "closable": {
+      "type": "boolean",
+      "mutable": false,
+      "complexType": {
+        "original": "boolean",
+        "resolved": "boolean",
+        "references": {}
+      },
+      "required": false,
+      "optional": true,
+      "docs": {
+        "tags": [],
+        "text": "When true, displays a button user can click to dismiss the `calcite-notice`"
+      },
+      "attribute": "closable",
+      "reflect": true,
+      "defaultValue": "false"
+    },
     "icon": {
       "type": "any",
       "mutable": false,
@@ -204,7 +231,7 @@ export class Notice {
             "name": "default",
             "text": "\"Close\""
           }],
-        "text": "Accessible label for the close button."
+        "text": "Accessible name for the close button."
       },
       "attribute": "intl-close",
       "reflect": false,
@@ -227,7 +254,7 @@ export class Notice {
       "optional": false,
       "docs": {
         "tags": [],
-        "text": "Specify the scale of `calcite-notice`."
+        "text": "Specifies the size of the component."
       },
       "attribute": "scale",
       "reflect": true,
@@ -250,7 +277,7 @@ export class Notice {
       "optional": false,
       "docs": {
         "tags": [],
-        "text": "Specify the width of the `calcite-notice`."
+        "text": "Specifies the width of the component."
       },
       "attribute": "width",
       "reflect": true,
@@ -265,7 +292,7 @@ export class Notice {
       "composed": true,
       "docs": {
         "tags": [],
-        "text": "Fired when `calcite-notice` is closed."
+        "text": "Fired when the component is closed."
       },
       "complexType": {
         "original": "any",
@@ -280,7 +307,7 @@ export class Notice {
       "composed": true,
       "docs": {
         "tags": [],
-        "text": "Fired when `calcite-notice` is opened."
+        "text": "Fired when the component is opened."
       },
       "complexType": {
         "original": "any",
@@ -301,7 +328,7 @@ export class Notice {
         "return": "Promise<void>"
       },
       "docs": {
-        "text": "Sets focus on the `calcite-notice`.",
+        "text": "Sets focus on the component.",
         "tags": []
       }
     }

package/dist/collection/components/notice/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-beta.83
+ * v1.0.0-beta.86
  */
 export const TEXT = {
   close: "Close"

package/dist/collection/components/option/option.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-beta.83
+ * v1.0.0-beta.86
  */
 import { Component, h, Prop, Element, Event, Watch } from "@stencil/core";
 import { createObserver } from "../../utils/observers";
@@ -13,7 +13,7 @@ export class Option {
     //
     //--------------------------------------------------------------------------
     /**
-     * When true, it prevents the option from being selected.
+     * When true, interaction is prevented and the component is displayed with lower opacity.
      */
     this.disabled = false;
     this.mutationObserver = createObserver("mutation", () => {
@@ -91,7 +91,7 @@ export class Option {
       "optional": false,
       "docs": {
         "tags": [],
-        "text": "When true, it prevents the option from being selected."
+        "text": "When true, interaction is prevented and the component is displayed with lower opacity."
       },
       "attribute": "disabled",
       "reflect": true,
@@ -109,7 +109,7 @@ export class Option {
       "optional": false,
       "docs": {
         "tags": [],
-        "text": "The option label."
+        "text": "Accessible name for the component."
       },
       "attribute": "label",
       "reflect": false
@@ -126,7 +126,7 @@ export class Option {
       "optional": false,
       "docs": {
         "tags": [],
-        "text": "When true, this option is selected. Otherwise, false."
+        "text": "When true, the component is selected."
       },
       "attribute": "selected",
       "reflect": true
@@ -143,7 +143,7 @@ export class Option {
       "optional": false,
       "docs": {
         "tags": [],
-        "text": "The value associated with this option."
+        "text": "The component's value."
       },
       "attribute": "value",
       "reflect": false

package/dist/collection/components/option-group/option-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-beta.83
+ * v1.0.0-beta.86
  */
 import { Component, h, Prop, Watch, Event, Fragment } from "@stencil/core";
 /**
@@ -15,7 +15,7 @@ export class OptionGroup {
     //
     //--------------------------------------------------------------------------
     /**
-     * When true, it prevents selection from any of its associated options.
+     * When true, interaction is prevented and the component is displayed with lower opacity.
      */
     this.disabled = false;
   }
@@ -53,7 +53,7 @@ export class OptionGroup {
       "optional": false,
       "docs": {
         "tags": [],
-        "text": "When true, it prevents selection from any of its associated options."
+        "text": "When true, interaction is prevented and the component is displayed with lower opacity."
       },
       "attribute": "disabled",
       "reflect": true,
@@ -71,7 +71,7 @@ export class OptionGroup {
       "optional": false,
       "docs": {
         "tags": [],
-        "text": "The group label. This property is required."
+        "text": "Accessible name for the component."
       },
       "attribute": "label",
       "reflect": false

package/dist/collection/components/pagination/pagination.css

@@ -83,17 +83,18 @@
 *
 * These properties can be overridden using the component's tag as selector.
 *
-* @prop --calcite-pagination-spacing: the amount of padding around each pagination item
+* @prop --calcite-pagination-spacing: The amount of padding around each pagination item.
 */
 :host([scale=s]) {
   --calcite-pagination-spacing: 0.25rem 0.5rem;
 }
-:host([scale=s]) .previous, :host([scale=s]) .next, :host([scale=s]) .page {
+:host([scale=s]) .previous,  :host([scale=s]) .next,  :host([scale=s]) .page {
   height: 1.5rem;
   font-size: var(--calcite-font-size--2);
   line-height: 1rem;
 }
-:host([scale=s]) .previous, :host([scale=s]) .next {
+:host([scale=s]) .previous, 
+:host([scale=s]) .next {
   padding-left: 0.25rem;
   padding-right: 0.25rem;
 }
@@ -101,12 +102,13 @@
 :host([scale=m]) {
   --calcite-pagination-spacing: 0.5rem 0.75rem;
 }
-:host([scale=m]) .previous, :host([scale=m]) .next, :host([scale=m]) .page {
+:host([scale=m]) .previous,  :host([scale=m]) .next,  :host([scale=m]) .page {
   height: 2rem;
   font-size: var(--calcite-font-size--1);
   line-height: 1rem;
 }
-:host([scale=m]) .previous, :host([scale=m]) .next {
+:host([scale=m]) .previous, 
+:host([scale=m]) .next {
   padding-left: 0.5rem;
   padding-right: 0.5rem;
 }
@@ -114,12 +116,13 @@
 :host([scale=l]) {
   --calcite-pagination-spacing: 0.75rem 1rem;
 }
-:host([scale=l]) .previous, :host([scale=l]) .next, :host([scale=l]) .page {
+:host([scale=l]) .previous,  :host([scale=l]) .next,  :host([scale=l]) .page {
   height: 2.75rem;
   font-size: var(--calcite-font-size-0);
   line-height: 1.25rem;
 }
-:host([scale=l]) .previous, :host([scale=l]) .next {
+:host([scale=l]) .previous, 
+:host([scale=l]) .next {
   padding-left: 1rem;
   padding-right: 1rem;
 }
@@ -137,7 +140,9 @@
   outline-offset: -2px;
 }
 
-.previous, .next, .page {
+.previous, 
+.next, 
+.page {
   box-sizing: border-box;
   display: flex;
   cursor: pointer;
@@ -152,7 +157,9 @@
   border-top: 2px solid transparent;
   border-bottom: 2px solid transparent;
 }
-.previous:hover, .next:hover, .page:hover {
+.previous:hover, 
+.next:hover, 
+.page:hover {
   color: var(--calcite-ui-text-1);
   transition: all var(--calcite-animation-timing) ease-in-out 0s, outline 0s, outline-offset 0s;
 }
@@ -166,18 +173,22 @@
   border-bottom-color: var(--calcite-ui-brand);
 }
 
-.previous:hover, .next:hover {
+.previous:hover, 
+.next:hover {
   background-color: var(--calcite-ui-foreground-2);
   color: var(--calcite-ui-brand);
 }
-.previous:active, .next:active {
+.previous:active, 
+.next:active {
   background-color: var(--calcite-ui-foreground-3);
 }
-.previous.is-disabled, .next.is-disabled {
+.previous.is-disabled, 
+.next.is-disabled {
   pointer-events: none;
   background-color: transparent;
 }
-.previous.is-disabled > calcite-icon, .next.is-disabled > calcite-icon {
+.previous.is-disabled > calcite-icon, 
+.next.is-disabled > calcite-icon {
   opacity: var(--calcite-ui-opacity-disabled);
 }
 

package/dist/collection/components/pagination/pagination.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-beta.83
+ * v1.0.0-beta.86
  */
 import { Component, Element, Event, h, Prop, Method, Fragment, State } from "@stencil/core";
 import { unwatchGlobalAttributes, watchGlobalAttributes } from "../../utils/globalAttributes";
@@ -15,25 +15,25 @@ export class Pagination {
     //  Public Properties
     //
     //--------------------------------------------------------------------------
-    /** number of items per page */
+    /** Specifies the number of items per page. */
     this.num = 20;
-    /** index of item that should begin the page */
+    /** Specifies the starting item number. */
     this.start = 1;
-    /** total number of items */
+    /** Specifies the total number of items. */
     this.total = 0;
     /**
-     * Used as an accessible label (aria-label) for the next button
+     * Accessible name for the component's next button.
      *
      * @default "Next"
      */
     this.textLabelNext = TEXT.nextLabel;
     /**
-     * Used as an accessible label (aria-label) of the previous button
+     * Accessible name for the component's previous button.
      *
      * @default "Previous"
      */
     this.textLabelPrevious = TEXT.previousLabel;
-    /** The scale of the pagination */
+    /** Specifies the size of the component. */
     this.scale = "m";
     //--------------------------------------------------------------------------
     //
@@ -66,11 +66,11 @@ export class Pagination {
   //  Public Methods
   //
   // --------------------------------------------------------------------------
-  /** Go to the next page of results */
+  /** Go to the next page of results. */
   async nextPage() {
     this.start = Math.min(this.getLastStart(), this.start + this.num);
   }
-  /** Go to the previous page of results */
+  /** Go to the previous page of results. */
   async previousPage() {
     this.start = Math.max(1, this.start - this.num);
   }
@@ -201,7 +201,7 @@ export class Pagination {
       "optional": false,
       "docs": {
         "tags": [],
-        "text": "number of items per page"
+        "text": "Specifies the number of items per page."
       },
       "attribute": "num",
       "reflect": false,
@@ -219,7 +219,7 @@ export class Pagination {
       "optional": false,
       "docs": {
         "tags": [],
-        "text": "index of item that should begin the page"
+        "text": "Specifies the starting item number."
       },
       "attribute": "start",
       "reflect": false,
@@ -237,7 +237,7 @@ export class Pagination {
       "optional": false,
       "docs": {
         "tags": [],
-        "text": "total number of items"
+        "text": "Specifies the total number of items."
       },
       "attribute": "total",
       "reflect": false,
@@ -258,7 +258,7 @@ export class Pagination {
             "name": "default",
             "text": "\"Next\""
           }],
-        "text": "Used as an accessible label (aria-label) for the next button"
+        "text": "Accessible name for the component's next button."
       },
       "attribute": "text-label-next",
       "reflect": false,
@@ -279,7 +279,7 @@ export class Pagination {
             "name": "default",
             "text": "\"Previous\""
           }],
-        "text": "Used as an accessible label (aria-label) of the previous button"
+        "text": "Accessible name for the component's previous button."
       },
       "attribute": "text-label-previous",
       "reflect": false,
@@ -302,7 +302,7 @@ export class Pagination {
       "optional": false,
       "docs": {
         "tags": [],
-        "text": "The scale of the pagination"
+        "text": "Specifies the size of the component."
       },
       "attribute": "scale",
       "reflect": true,
@@ -323,7 +323,7 @@ export class Pagination {
             "name": "deprecated",
             "text": "use calcitePaginationChange instead"
           }],
-        "text": "Emitted whenever the selected page changes."
+        "text": "Emits when the selected page changes."
       },
       "complexType": {
         "original": "PaginationDetail",
@@ -343,9 +343,9 @@ export class Pagination {
       "docs": {
         "tags": [{
             "name": "see",
-            "text": "[PaginationDetail](https://github.com/Esri/calcite-components/blob/master/src/components/pagination/calcite-pagination.tsx#L18)"
+            "text": "[PaginationDetail](https://github.com/Esri/calcite-components/blob/master/src/components/pagination/pagination.tsx#L23)"
           }],
-        "text": "Emitted whenever the selected page changes."
+        "text": "Emits when the selected page changes."
       },
       "complexType": {
         "original": "PaginationDetail",
@@ -370,7 +370,7 @@ export class Pagination {
         "return": "Promise<void>"
       },
       "docs": {
-        "text": "Go to the next page of results",
+        "text": "Go to the next page of results.",
         "tags": []
       }
     },
@@ -386,7 +386,7 @@ export class Pagination {
         "return": "Promise<void>"
       },
       "docs": {
-        "text": "Go to the previous page of results",
+        "text": "Go to the previous page of results.",
         "tags": []
       }
     }

package/dist/collection/components/pagination/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-beta.83
+ * v1.0.0-beta.86
  */
 export const CSS = {
   page: "page",

package/dist/collection/components/panel/panel.css

@@ -94,9 +94,9 @@
 *
 * These properties can be overridden using the component's tag as selector.
 *
-* @prop --calcite-panel-max-height: the maximum height of the panel
-* @prop --calcite-panel-max-width: the maximum width of the panel
-* @prop --calcite-panel-min-width: the minimum width of the panel
+* @prop --calcite-panel-max-height: The maximum height of the component.
+* @prop --calcite-panel-max-width: The maximum width of the component.
+* @prop --calcite-panel-min-width: The minimum width of the component.
 */
 :host {
   position: relative;
@@ -160,7 +160,8 @@ h3.heading {
   line-height: 1.25rem;
 }
 
-h4.heading, h5.heading {
+h4.heading, 
+h5.heading {
   font-size: var(--calcite-font-size--1);
   line-height: 1rem;
 }
@@ -215,7 +216,8 @@ h4.heading, h5.heading {
   display: none;
 }
 
-:host([loading]) .container, :host([disabled]) .container {
+:host([loading]) .container, 
+:host([disabled]) .container {
   position: relative;
   z-index: 1;
 }
@@ -243,7 +245,8 @@ h4.heading, h5.heading {
   padding-bottom: 0.875rem;
   margin-inline-end: auto;
 }
-.header-content .heading, .header-content .summary {
+.header-content .heading, 
+.header-content .description {
   display: block;
   overflow-wrap: break-word;
   padding: 0px;
@@ -260,7 +263,7 @@ h4.heading, h5.heading {
 .header-content .heading:only-child {
   margin-bottom: 0px;
 }
-.header-content .summary {
+.header-content .description {
   font-size: var(--calcite-font-size--1);
   line-height: 1rem;
   color: var(--calcite-ui-text-2);