@esri/calcite-components 1.0.0-next.451 → 1.0.0-next.454

package/dist/extras/docs-json.json

@@ -1,5 +1,5 @@
 {
-  "timestamp": "2022-04-26T16:09:41",
+  "timestamp": "2022-05-04T03:44:23",
   "compiler": {
     "name": "@stencil/core",
     "version": "2.15.1",
@@ -2140,8 +2140,9 @@
           "mutable": false,
           "attr": "intl-collapse",
           "reflectToAttr": false,
-          "docs": "Tooltip used for the toggle when expanded.",
+          "docs": "Aria-label for collapsing the toggle and tooltip used for the toggle when expanded.",
           "docsTags": [],
+          "default": "TEXT.collapse",
           "values": [
             {
               "type": "string"
@@ -2156,8 +2157,9 @@
           "mutable": false,
           "attr": "intl-expand",
           "reflectToAttr": false,
-          "docs": "Tooltip used for the toggle when collapsed.",
+          "docs": "Aria-label for expanding the toggle and tooltip used for the toggle when collapsed.",
           "docsTags": [],
+          "default": "TEXT.expand",
           "values": [
             {
               "type": "string"
@@ -7606,13 +7608,11 @@
         "calcite-value-list"
       ],
       "dependencies": [
-        "calcite-input",
-        "calcite-icon"
+        "calcite-input"
       ],
       "dependencyGraph": {
         "calcite-filter": [
-          "calcite-input",
-          "calcite-icon"
+          "calcite-input"
         ],
         "calcite-input": [
           "calcite-progress",
@@ -7980,7 +7980,6 @@
         "calcite-combobox-item",
         "calcite-date-picker-month-header",
         "calcite-dropdown-item",
-        "calcite-filter",
         "calcite-handle",
         "calcite-input",
         "calcite-input-date-picker",
@@ -8040,9 +8039,6 @@
         "calcite-dropdown-item": [
           "calcite-icon"
         ],
-        "calcite-filter": [
-          "calcite-icon"
-        ],
         "calcite-handle": [
           "calcite-icon"
         ],
@@ -8523,6 +8519,22 @@
           "optional": false,
           "required": false
         },
+        {
+          "name": "intlClear",
+          "type": "string",
+          "mutable": false,
+          "attr": "intl-clear",
+          "reflectToAttr": false,
+          "docs": "A text label that will appear on the clear button for screen readers.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": true,
+          "required": false
+        },
         {
           "name": "intlLoading",
           "type": "string",
@@ -8536,7 +8548,7 @@
               "text": "\"Loading\""
             }
           ],
-          "default": "TEXT.loading",
+          "default": "COMMON_TEXT.loading",
           "values": [
             {
               "type": "string"
@@ -13006,8 +13018,7 @@
           "calcite-scrim"
         ],
         "calcite-filter": [
-          "calcite-input",
-          "calcite-icon"
+          "calcite-input"
         ],
         "calcite-input": [
           "calcite-progress",
@@ -19707,11 +19718,11 @@
       "docsTags": [
         {
           "name": "slot",
-          "text": "- A slot for adding `calcite-value-list-item` elements. Items are displayed as a vertical list."
+          "text": "- A slot for adding calcite-value-list-item elements. List items are displayed as a vertical list."
         },
         {
           "name": "slot",
-          "text": "menu-actions - A slot for adding a button + menu combo for performing actions like sorting."
+          "text": "menu-actions - A slot for adding a button and menu combination for performing actions, such as sorting."
         }
       ],
       "usage": {
@@ -19726,7 +19737,7 @@
           "mutable": false,
           "attr": "disabled",
           "reflectToAttr": true,
-          "docs": "When true, disabled prevents interaction. This state shows items with lower opacity/grayed.",
+          "docs": "When true, prevents user interaction. This state shows list items grayed out and with lower opacity.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -19743,7 +19754,7 @@
           "mutable": false,
           "attr": "drag-enabled",
           "reflectToAttr": true,
-          "docs": "When true, the items will be sortable via drag and drop.",
+          "docs": "When true, list items are sortable via a draggable button.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -19760,7 +19771,7 @@
           "mutable": false,
           "attr": "filter-enabled",
           "reflectToAttr": true,
-          "docs": "When true, an input appears at the top of the list that can be used by end users to filter items in the list.",
+          "docs": "When true, an input appears at the top of the list that can be used by end users to filter list items.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -19777,7 +19788,7 @@
           "mutable": false,
           "attr": "filter-placeholder",
           "reflectToAttr": true,
-          "docs": "Placeholder text for the filter input field.",
+          "docs": "Placeholder text for the filter's input field.",
           "docsTags": [],
           "values": [
             {
@@ -19826,7 +19837,7 @@
           "mutable": false,
           "attr": "multiple",
           "reflectToAttr": true,
-          "docs": "Multiple Works similar to standard radio buttons and checkboxes.\nWhen true, a user can select multiple items at a time.\nWhen false, only a single item can be selected at a time\nand selecting a new item will deselect any other selected items.",
+          "docs": "Similar to standard radio buttons and checkboxes.\nWhen true, a user can select multiple list items at a time.\nWhen false, only a single list item can be selected at a time,\nand selecting a new list item will deselect any other selected list items.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -19843,7 +19854,7 @@
           "mutable": false,
           "attr": "selection-follows-focus",
           "reflectToAttr": false,
-          "docs": "When true and single-selection is enabled, the selection will change when navigating items via the keyboard.",
+          "docs": "When true and single-selection is enabled, the selection changes when navigating list items via the keyboard.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -19886,7 +19897,7 @@
           "bubbles": true,
           "cancelable": true,
           "composed": true,
-          "docs": "Emitted when any of the item selections have changed.",
+          "docs": "Emits when any of the list item selections have changed.",
           "docsTags": []
         },
         {
@@ -19895,7 +19906,7 @@
           "bubbles": true,
           "cancelable": true,
           "composed": true,
-          "docs": "Emitted when the order of the list has changed.",
+          "docs": "Emits when the order of the list has changed.",
           "docsTags": []
         }
       ],
@@ -19930,11 +19941,11 @@
       "slots": [
         {
           "name": "",
-          "docs": "A slot for adding `calcite-value-list-item` elements. Items are displayed as a vertical list."
+          "docs": "A slot for adding calcite-value-list-item elements. List items are displayed as a vertical list."
         },
         {
           "name": "menu-actions",
-          "docs": "A slot for adding a button + menu combo for performing actions like sorting."
+          "docs": "A slot for adding a button and menu combination for performing actions, such as sorting."
         }
       ],
       "parts": [],
@@ -19949,8 +19960,7 @@
           "calcite-scrim"
         ],
         "calcite-filter": [
-          "calcite-input",
-          "calcite-icon"
+          "calcite-input"
         ],
         "calcite-input": [
           "calcite-progress",
@@ -19985,7 +19995,7 @@
           "mutable": false,
           "attr": "description",
           "reflectToAttr": true,
-          "docs": "An optional description for this item. Will appear below the label text.",
+          "docs": "An optional description for the list item that displays below the label text.",
           "docsTags": [],
           "values": [
             {
@@ -20001,7 +20011,7 @@
           "mutable": false,
           "attr": "disabled",
           "reflectToAttr": true,
-          "docs": "When true, the item cannot be clicked and is visually muted",
+          "docs": "When true, the list item cannot be clicked and is visually muted.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -20046,7 +20056,7 @@
           "mutable": false,
           "attr": "label",
           "reflectToAttr": true,
-          "docs": "The main label for this item. Appears next to the icon.",
+          "docs": "The main label for the list item. Appears next to the icon.",
           "docsTags": [],
           "values": [
             {
@@ -20061,7 +20071,7 @@
           "type": "{ [x: string]: unknown; }",
           "mutable": false,
           "reflectToAttr": false,
-          "docs": "Used to provide additional metadata to an item, primarily used when the parent list has a filter.",
+          "docs": "Provides additional metadata to a list item. Primary use is for a filter on the parent list.",
           "docsTags": [],
           "values": [
             {
@@ -20094,7 +20104,7 @@
           "mutable": false,
           "attr": "removable",
           "reflectToAttr": true,
-          "docs": "Set this to true to display a remove action that removes the item from the list.",
+          "docs": "When true, adds an action to remove the list item.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -20111,7 +20121,7 @@
           "mutable": true,
           "attr": "selected",
           "reflectToAttr": true,
-          "docs": "Set this to true to pre-select an item. Toggles when an item is checked/unchecked.",
+          "docs": "When true, preselects the list item. Toggles when an item is checked/unchecked.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -20128,7 +20138,7 @@
           "mutable": false,
           "attr": "value",
           "reflectToAttr": false,
-          "docs": "The item's associated value.",
+          "docs": "The list item's associated value.",
           "docsTags": [],
           "values": [
             {
@@ -20148,7 +20158,7 @@
           },
           "signature": "setFocus() => Promise<void>",
           "parameters": [],
-          "docs": "Sets focus on the component.",
+          "docs": "Set focus on the component.",
           "docsTags": []
         },
         {
@@ -20159,7 +20169,7 @@
           },
           "signature": "toggleSelected(coerce?: boolean) => Promise<void>",
           "parameters": [],
-          "docs": "Used to toggle the selection state. By default this won't trigger an event.\nThe first argument allows the value to be coerced, rather than swapping values.",
+          "docs": "Toggle the selection state. By default this won't trigger an event.\nThe first argument allows the value to be coerced, rather than swapping values.",
           "docsTags": []
         }
       ],
@@ -20170,7 +20180,7 @@
           "bubbles": true,
           "cancelable": true,
           "composed": true,
-          "docs": "Emitted whenever the remove button is pressed.",
+          "docs": "Emits when the remove button is pressed.",
           "docsTags": []
         }
       ],

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.451
+ * v1.0.0-next.454
  */
 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.451
+ * v1.0.0-next.454
  */
 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.451
+ * v1.0.0-next.454
  */
 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.451
+ * v1.0.0-next.454
  */
 (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

@@ -31,11 +31,11 @@ export declare class Block implements ConditionalSlotComponent, InteractiveCompo
    */
   headingLevel: HeadingLevel;
   /**
-   * Tooltip used for the toggle when expanded.
+   * Aria-label for collapsing the toggle and tooltip used for the toggle when expanded.
    */
   intlCollapse?: string;
   /**
-   * Tooltip used for the toggle when collapsed.
+   * Aria-label for expanding the toggle and tooltip used for the toggle when collapsed.
    */
   intlExpand?: string;
   /** string to override English loading text

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

@@ -1,7 +1,6 @@
 export declare const CSS: {
   container: string;
   searchIcon: string;
-  clearButton: string;
 };
 export declare const TEXT: {
   filterLabel: string;

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

@@ -30,6 +30,10 @@ export declare class Input implements LabelableComponent, FormComponent, Interac
    * input types (tel, password, email, date, time, search). You can also pass a
    * calcite-ui-icon name to this prop to display a requested icon for any input type */
   icon: string | boolean;
+  /**
+   * A text label that will appear on the clear button for screen readers.
+   */
+  intlClear?: string;
   /**
    * string to override English loading text
    * @default "Loading"

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

@@ -25,3 +25,6 @@ export declare const INPUT_TYPE_ICONS: {
 export declare const SLOTS: {
   action: string;
 };
+export declare const TEXT: {
+  clear: string;
+};

package/dist/types/components/value-list/value-list.d.ts

@@ -4,24 +4,24 @@ import { ICON_TYPES } from "./resources";
 import { ListFocusId, ItemData } from "../pick-list/shared-list-logic";
 import { InteractiveComponent } from "../../utils/interactive";
 /**
- * @slot - A slot for adding `calcite-value-list-item` elements. Items are displayed as a vertical list.
- * @slot menu-actions - A slot for adding a button + menu combo for performing actions like sorting.
+ * @slot - A slot for adding calcite-value-list-item elements. List items are displayed as a vertical list.
+ * @slot menu-actions - A slot for adding a button and menu combination for performing actions, such as sorting.
  */
 export declare class ValueList<ItemElement extends HTMLCalciteValueListItemElement = HTMLCalciteValueListItemElement> implements InteractiveComponent {
   /**
-   * When true, disabled prevents interaction. This state shows items with lower opacity/grayed.
+   * When true, prevents user interaction. This state shows list items grayed out and with lower opacity.
    */
   disabled: boolean;
   /**
-   * When true, the items will be sortable via drag and drop.
+   * When true, list items are sortable via a draggable button.
    */
   dragEnabled: boolean;
   /**
-   * When true, an input appears at the top of the list that can be used by end users to filter items in the list.
+   * When true, an input appears at the top of the list that can be used by end users to filter list items.
    */
   filterEnabled: boolean;
   /**
-   * Placeholder text for the filter input field.
+   * Placeholder text for the filter's input field.
    */
   filterPlaceholder: string;
   /**
@@ -35,14 +35,14 @@ export declare class ValueList<ItemElement extends HTMLCalciteValueListItemEleme
    */
   loading: boolean;
   /**
-   * Multiple Works similar to standard radio buttons and checkboxes.
-   * When true, a user can select multiple items at a time.
-   * When false, only a single item can be selected at a time
-   * and selecting a new item will deselect any other selected items.
+   * Similar to standard radio buttons and checkboxes.
+   * When true, a user can select multiple list items at a time.
+   * When false, only a single list item can be selected at a time,
+   * and selecting a new list item will deselect any other selected list items.
    */
   multiple: boolean;
   /**
-   * When true and single-selection is enabled, the selection will change when navigating items via the keyboard.
+   * When true and single-selection is enabled, the selection changes when navigating list items via the keyboard.
    */
   selectionFollowsFocus: boolean;
   selectedValues: Map<string, ItemElement>;
@@ -59,11 +59,11 @@ export declare class ValueList<ItemElement extends HTMLCalciteValueListItemEleme
   componentDidRender(): void;
   disconnectedCallback(): void;
   /**
-   * Emitted when any of the item selections have changed.
+   * Emits when any of the list item selections have changed.
    */
   calciteListChange: EventEmitter<Map<string, HTMLCalciteValueListItemElement>>;
   /**
-   * Emitted when the order of the list has changed.
+   * Emits when the order of the list has changed.
    */
   calciteListOrderChange: EventEmitter<any[]>;
   calciteListFocusOutHandler(event: FocusEvent): void;

package/dist/types/components/value-list-item/value-list-item.d.ts

@@ -8,15 +8,15 @@ import { InteractiveComponent } from "../../utils/interactive";
  */
 export declare class ValueListItem implements ConditionalSlotComponent, InteractiveComponent {
   /**
-   * An optional description for this item. Will appear below the label text.
+   * An optional description for the list item that displays below the label text.
    */
   description?: string;
   /**
-   * When true, the item cannot be clicked and is visually muted
+   * When true, the list item cannot be clicked and is visually muted.
    */
   disabled: boolean;
   /**
-   * @internal When false, the item cannot be deselected by user interaction.
+   * @internal When false, the list item cannot be deselected by user interaction.
    */
   disableDeselect: boolean;
   /**
@@ -24,7 +24,7 @@ export declare class ValueListItem implements ConditionalSlotComponent, Interact
    */
   nonInteractive: boolean;
   /**
-   * @internal - stores the activated state of the drag handle.
+   * @internal - Stores the activated state of the drag handle.
    */
   handleActivated?: boolean;
   /**
@@ -33,23 +33,23 @@ export declare class ValueListItem implements ConditionalSlotComponent, Interact
    */
   icon?: ICON_TYPES | null;
   /**
-   * The main label for this item. Appears next to the icon.
+   * The main label for the list item. Appears next to the icon.
    */
   label: string;
   /**
-   * Used to provide additional metadata to an item, primarily used when the parent list has a filter.
+   * Provides additional metadata to a list item. Primary use is for a filter on the parent list.
    */
   metadata?: Record<string, unknown>;
   /**
-   * Set this to true to display a remove action that removes the item from the list.
+   * When true, adds an action to remove the list item.
    */
   removable: boolean;
   /**
-   * Set this to true to pre-select an item. Toggles when an item is checked/unchecked.
+   * When true, preselects the list item. Toggles when an item is checked/unchecked.
    */
   selected: boolean;
   /**
-   * The item's associated value.
+   * The list item's associated value.
    */
   value: any;
   el: HTMLCalciteValueListItemElement;
@@ -59,14 +59,14 @@ export declare class ValueListItem implements ConditionalSlotComponent, Interact
   disconnectedCallback(): void;
   componentDidRender(): void;
   /**
-   * Used to toggle the selection state. By default this won't trigger an event.
+   * Toggle the selection state. By default this won't trigger an event.
    * The first argument allows the value to be coerced, rather than swapping values.
    */
   toggleSelected(coerce?: boolean): Promise<void>;
-  /** Sets focus on the component. */
+  /** Set focus on the component. */
   setFocus(): Promise<void>;
   /**
-   * Emitted whenever the remove button is pressed.
+   * Emits when the remove button is pressed.
    */
   calciteListItemRemove: EventEmitter<void>;
   calciteListItemChangeHandler(event: CustomEvent): void;