@esri/calcite-components 1.0.0-next.605 → 1.0.0-next.607

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.605
+ * v1.0.0-next.607
  */
 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.605
+ * v1.0.0-next.607
  */
 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.605
+ * v1.0.0-next.607
  */
 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.605
+ * v1.0.0-next.607
  */
 (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/block/block.d.ts

@@ -4,78 +4,80 @@ import { Status } from "../interfaces";
 import { ConditionalSlotComponent } from "../../utils/conditionalSlot";
 import { InteractiveComponent } from "../../utils/interactive";
 /**
- * @slot - A slot for adding content to the block.
- * @slot icon - A slot for adding a leading header icon.
+ * @slot - A slot for adding content to the component.
+ * @slot icon - A slot for adding a leading header icon with `calcite-icon`.
  * @slot control - A slot for adding a single HTML input element in a header.
- * @slot header-menu-actions - a slot for adding an overflow menu with actions inside a dropdown.
+ * @slot header-menu-actions - A slot for adding an overflow menu with `calcite-action`s inside a dropdown.
  */
 export declare class Block implements ConditionalSlotComponent, InteractiveComponent {
   /**
-   * When true, this block will be collapsible.
+   * When `true`, the component is collapsible.
    */
   collapsible: boolean;
   /**
-   * When true, disabled prevents interaction. This state shows items with lower opacity/grayed.
+   * When `true`, interaction is prevented and the component is displayed with lower opacity.
    */
   disabled: boolean;
   /**
-   * When true, displays a drag handle in the header.
+   * When `true`, displays a drag handle in the header.
    */
   dragHandle: boolean;
   /**
-   * Block heading.
+   * The component header text.
    */
   heading: string;
   /**
-   * Number at which section headings should start for this component.
+   * Specifies the number at which section headings should start.
    */
   headingLevel: HeadingLevel;
   /**
-   * Aria-label for collapsing the toggle and tooltip used for the toggle when expanded.
+   * Accessible name for the component's collapse button.
    *
    * @default "Collapse"
    */
   intlCollapse?: string;
   /**
-   * Aria-label for expanding the toggle and tooltip used for the toggle when collapsed.
+   * Accessible name for the component's expand button.
    *
    * @default "Expand"
    */
   intlExpand?: string;
   /**
-   * string to override English loading text
+   * Accessible name when the component is loading.
    *
    * @default "Loading"
    */
   intlLoading?: string;
   /**
-   * Text string used for the actions menu
+   * Accessible name for the component's options button.
    *
    * @default "Options"
    */
   intlOptions?: string;
   /**
-   * When true, content is waiting to be loaded. This state shows a busy indicator.
+   * When `true`, a busy indicator is displayed.
    */
   loading: boolean;
   /**
-   * When true, the block's content will be displayed.
+   * When `true`, expands the component and its contents.
    */
   open: boolean;
   /**
-   * Block status. Updates or adds icon to show related icon and color.
+   * Displays a status-related indicator icon.
    */
   status?: Status;
   /**
-   * Block summary.
+   * A description for the component, which displays below the heading.
    *
-   * @deprecated use description instead
+   * @deprecated use `description` instead
    */
   summary: string;
-  /**Block description */
+  /**
+   * A description for the component, which displays below the heading.
+   */
   description: string;
   /**
-   * When true, removes padding for the slotted content
+   * When `true`, removes padding for the slotted content.
    *
    * @deprecated Use `--calcite-block-padding` CSS variable instead.
    */
@@ -86,7 +88,7 @@ export declare class Block implements ConditionalSlotComponent, InteractiveCompo
   connectedCallback(): void;
   disconnectedCallback(): void;
   /**
-   * Emitted when the header has been clicked.
+   * Emits when the component's header is clicked.
    */
   calciteBlockToggle: EventEmitter<void>;
   onHeaderClick: () => void;

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

@@ -2,39 +2,41 @@ import { EventEmitter, VNode } from "../../stencil-public-runtime";
 import { BlockSectionToggleDisplay } from "./interfaces";
 import { Status } from "../interfaces";
 /**
- * @slot - A slot for adding content to the block section.
+ * @slot - A slot for adding content to the component.
  */
 export declare class BlockSection {
   /**
-   * Tooltip used for the toggle when expanded.
+   * Accessible name for the component's collapse button.
    */
   intlCollapse?: string;
   /**
-   * Tooltip used for the toggle when collapsed.
+   * Accessible name for the component's expand button.
    */
   intlExpand?: string;
   /**
-   * When true, the block's section content will be displayed.
+   * When `true`, expands the component and its contents.
    */
   open: boolean;
   /**
-   * BlockSection status. Adds indicator to show valid or invalid status.
+   * Displays a status-related indicator icon.
    */
   status?: Status;
   /**
-   * Text displayed in the button.
+   * The component header text.
    */
   text: string;
   /**
-   * This property determines the look of the section toggle.
-   * If the value is "switch", a toggle-switch will be displayed.
-   * If the value is "button", a clickable header is displayed.
+   * Specifies the component's toggle display -
+   *
+   * `"button"` (selectable header), or
+   *
+   * `"switch"` (toggle switch).
    */
   toggleDisplay: BlockSectionToggleDisplay;
   el: HTMLCalciteBlockSectionElement;
   private guid;
   /**
-   * Emitted when the header has been clicked.
+   * Emits when the header has been clicked.
    */
   calciteBlockSectionToggle: EventEmitter<void>;
   handleHeaderKeyDown: (event: KeyboardEvent) => void;

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

@@ -10,53 +10,69 @@ import { FormOwner } from "../../utils/form";
 /** @slot - A slot for adding text. */
 export declare class Button implements LabelableComponent, InteractiveComponent, FormOwner {
   el: HTMLCalciteButtonElement;
-  /** optionally specify alignment of button elements. */
+  /** Specifies the alignment of the component's elements. */
   alignment?: ButtonAlignment;
-  /** specify the appearance style of the button, defaults to solid. */
+  /** Specifies the appearance style of the component. */
   appearance: ButtonAppearance;
-  /** Applies to the aria-label attribute on the button or hyperlink */
+  /** Accessible name for the component. */
   label?: string;
-  /** specify the color of the button, defaults to blue */
+  /** Specifies the color of the component. */
   color: ButtonColor;
-  /** is the button disabled  */
+  /**  When `true`, interaction is prevented and the component is displayed with lower opacity. */
   disabled: boolean;
-  /** optionally pass a href - used to determine if the component should render as a button or an anchor */
+  /**
+   * Specifies the URL of the linked resource, which can be set as an absolute or relative path.
+   */
   href?: string;
   /** Specifies an icon to display at the end of the component. */
   iconEnd?: string;
-  /** When true, the icon will be flipped when the element direction is right-to-left (`"rtl"`). */
+  /** When `true`, the icon will be flipped when the element direction is right-to-left (`"rtl"`). */
   iconFlipRtl?: FlipContext;
   /** Specifies an icon to display at the start of the component. */
   iconStart?: string;
   /**
-   * string to override English loading text
+   * Accessible name when the component is loading.
    *
    * @default "Loading"
    */
   intlLoading?: string;
-  /** optionally add a calcite-loader component to the button, disabling interaction.  */
+  /**
+   * When `true`, a busy indicator is displayed and interaction is disabled.
+   */
   loading: boolean;
-  /** The name attribute to apply to the button */
+  /** Specifies the name of the component on form submission. */
   name?: string;
-  /** The rel attribute to apply to the hyperlink */
+  /**
+   * Defines the relationship between the `href` value and the current document.
+   *
+   * @mdn [rel](https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/rel)
+   */
   rel?: string;
   /**
-   * The form ID to associate with the component
+   * The form ID to associate with the component.
    *
-   * @deprecated – this property is no longer needed if placed inside a form.
+   * @deprecated – The property is no longer needed if the component is placed inside a form.
    */
   form?: string;
-  /** optionally add a round style to the button  */
+  /** When `true`, adds a round style to the component. */
   round: boolean;
-  /** specify the scale of the button, defaults to m */
+  /** Specifies the size of the component. */
   scale: Scale;
-  /** is the button a child of a calcite-split-button */
+  /** Specifies if the component is a child of a `calcite-split-button`. */
   splitChild?: "primary" | "secondary" | false;
-  /** The target attribute to apply to the hyperlink */
+  /**
+   * Specifies where to open the linked document defined in the `href` property.
+   *
+   * @mdn [target](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/a#attr-target)
+   */
   target?: string;
-  /** The type attribute to apply to the button */
+  /**
+   * Specifies the default behavior of the button.
+   *
+   * @mdn [type](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/button#attr-type)
+   */
   type: string;
-  /** specify the width of the button, defaults to auto */
+  /** Specifies the width of the component. */
   width: Width;
   loadingChanged(newValue: boolean, oldValue: boolean): void;
   connectedCallback(): void;

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

@@ -7,40 +7,41 @@ import { ConditionalSlotComponent } from "../../utils/conditionalSlot";
  */
 /**
  * @slot - A slot for adding subheader/description content.
- * @slot thumbnail - A slot for adding a thumbnail to the card.
- * @slot title - A slot for adding a card title.
- * @slot subtitle - A slot for adding a card subtitle or short summary.
+ * @slot thumbnail - A slot for adding a thumbnail to the component.
+ * @slot title - A slot for adding a title.
+ * @slot subtitle - A slot for adding a subtitle or short summary.
  * @slot footer-leading - A slot for adding a leading footer.
  * @slot footer-trailing - A slot for adding a trailing footer.
  */
 export declare class Card implements ConditionalSlotComponent {
   el: HTMLCalciteCardElement;
-  /**  When true, the cards content is waiting to be loaded. This state shows a busy indicator.*/
+  /**  When `true`, a busy indicator is displayed. */
   loading: boolean;
-  /** Indicates whether the card is selected. */
+  /** When `true`, the component is selected. */
   selected: boolean;
-  /** Indicates whether the card is selectable. */
+  /** When `true`, the component is selectable. */
   selectable: boolean;
   /**
-   * string to override English loading text
+   * Accessible name when the component is loading.
    *
    * @default "Loading"
    */
   intlLoading?: string;
   /**
-   * string to override English select text for checkbox when selectable is true
+   * When `selectable` is `true`, the accessible name for the component's checkbox for selection.
    *
    * @default "Select"
    */
   intlSelect: string;
   /**
-   * string to override English deselect text for checkbox when selectable is true
+   * When `selectable` is `true`, the accessible name for the component's checkbox for deselection.
    *
    * @default "Deselect"
    */
   intlDeselect: string;
+  /** Sets the placement of the thumbnail defined in the `thumbnail` slot. */
   thumbnailPosition: LogicalFlowPosition;
-  /** Fired when a selectable card is selected */
+  /** Fires when `selectable` is `true` and the component is selected. */
   calciteCardSelect: EventEmitter<void>;
   connectedCallback(): void;
   disonnectedCallback(): void;

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

@@ -5,11 +5,11 @@ import { LabelableComponent } from "../../utils/label";
 import { InteractiveComponent } from "../../utils/interactive";
 export declare class Checkbox implements LabelableComponent, CheckableFormComponent, InteractiveComponent {
   el: HTMLCalciteCheckboxElement;
-  /** The checked state of the checkbox. */
+  /** When `true`, the component is checked. */
   checked: boolean;
-  /** True if the checkbox is disabled */
+  /** When `true`, interaction is prevented and the component is displayed with lower opacity. */
   disabled: boolean;
-  /** The id attribute of the checkbox.  When omitted, a globally unique identifier is used. */
+  /** The `id` attribute of the component. When omitted, a globally unique identifier is used. */
   guid: string;
   /**
    * The hovered state of the checkbox.
@@ -18,28 +18,30 @@ export declare class Checkbox implements LabelableComponent, CheckableFormCompon
    */
   hovered: boolean;
   /**
-   * True if the checkbox is initially indeterminate,
-   * which is independent from its checked state
-   * https://css-tricks.com/indeterminate-checkboxes/
+   * When `true`, the component is initially indeterminate, which is independent from its `checked` value.
+   *
+   * The state is visual only, and can look different across browsers.
+   *
+   * @mdn [indeterminate](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input/checkbox#indeterminate_state_checkboxes)
    */
   indeterminate: boolean;
   /**
-   * The label of the checkbox input
+   * Accessible name for the component.
    *
    * @internal
    */
   label?: string;
-  /** The name of the checkbox input */
+  /** Specifies the name of the component on form submission. */
   name: any;
   /**
-   * When true, the component must have a value in order for the form to submit.
+   * When `true`, the component must have a value in order for the form to submit.
    *
    * @internal
    */
   required: boolean;
-  /** specify the scale of the checkbox, defaults to m */
+  /** Specifies the size of the component. */
   scale: Scale;
-  /** The value of the checkbox input */
+  /** The component's value. */
   value: any;
   readonly checkedPath = "M5.5 12L2 8.689l.637-.636L5.5 10.727l8.022-7.87.637.637z";
   readonly indeterminatePath = "M13 8v1H3V8z";
@@ -55,15 +57,15 @@ export declare class Checkbox implements LabelableComponent, CheckableFormCompon
   keyDownHandler: (event: KeyboardEvent) => void;
   clickHandler: () => void;
   /**
-   * Emitted when the checkbox is blurred
+   * Emits when the component is blurred.
    *
    * @internal
    */
   calciteInternalCheckboxBlur: EventEmitter<boolean>;
-  /** Emitted when the checkbox checked status changes */
+  /** Emits when the component's `checked` status changes. */
   calciteCheckboxChange: EventEmitter<void>;
   /**
-   * Emitted when the checkbox is focused
+   * Emits when the component is focused.
    *
    * @internal
    */

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

@@ -7,35 +7,35 @@ import { ConditionalSlotComponent } from "../../utils/conditionalSlot";
  * @slot image - A slot for adding an image.
  */
 export declare class Chip implements ConditionalSlotComponent {
-  /** specify the appearance style of the button, defaults to solid. */
+  /** Specifies the appearance style of the component. */
   appearance: Extract<"solid" | "clear", Appearance>;
-  /** specify the color of the button, defaults to blue */
+  /** Specifies the color for the component. */
   color: ChipColor;
   /**
-   * Optionally show a button the user can click to dismiss the chip
+   * When `true`, a close button is added to the component.
    *
-   * @deprecated use closable instead
+   * @deprecated use `closable` instead.
    */
   dismissible: boolean;
   handleDismissible(value: boolean): void;
-  /** When true, show abutton user can click to dismiss the chip. */
+  /** When `true`, a close button is added to the component. */
   closable: boolean;
   handleClosable(value: boolean): void;
   /**
-   * Aria label for the "x" button
+   * Accessible name for the component's close button.
    *
    * @default "Close"
    */
   dismissLabel?: string;
   /** Specifies an icon to display. */
   icon?: string;
-  /** When true, the icon will be flipped when the element direction is right-to-left (`"rtl"`). */
+  /** When `true`, the icon will be flipped when the element direction is right-to-left (`"rtl"`). */
   iconFlipRtl: boolean;
-  /** specify the scale of the chip, defaults to m */
+  /** Specifies the size of the component. */
   scale: Scale;
-  /** The assigned value for the chip */
+  /** The component's value. */
   value: any;
-  /** When true, hides the chip  */
+  /** When `true`, hides the component. */
   closed: boolean;
   el: HTMLCalciteChipElement;
   connectedCallback(): void;
@@ -43,9 +43,9 @@ export declare class Chip implements ConditionalSlotComponent {
   /** Sets focus on the component. */
   setFocus(): Promise<void>;
   /**
-   * Emitted when the dismiss button is clicked
+   * Fires when the dismiss button is clicked.
    *
-   * **Note:**: The `el` event payload props is deprecated, please use the event's `target`/`currentTarget` instead
+   * **Note:**: The `el` event payload props is deprecated, please use the event's `target`/`currentTarget` instead.
    */
   calciteChipDismiss: EventEmitter<DeprecatedEventPayload>;
   closeClickHandler: (event: MouseEvent) => void;