@esri/calcite-components 1.0.0-beta.72 → 1.0.0-beta.76

package/dist/extras/docs-json.json

@@ -1,8 +1,8 @@
 {
-  "timestamp": "2021-12-21T21:29:22",
+  "timestamp": "2022-02-01T01:47:54",
   "compiler": {
     "name": "@stencil/core",
-    "version": "2.12.0",
+    "version": "2.13.0",
     "typescriptVersion": "4.3.5"
   },
   "components": [
@@ -15,7 +15,7 @@
       "docsTags": [
         {
           "name": "slot",
-          "text": "- A slot for adding `calcite-accordion-item`s."
+          "text": "- A slot for adding `calcite-accordion-item`s. `calcite-accordion` cannot be nested, however calcite-accordion-item`s can."
         }
       ],
       "usage": {
@@ -172,7 +172,7 @@
       "slots": [
         {
           "name": "",
-          "docs": "A slot for adding `calcite-accordion-item`s."
+          "docs": "A slot for adding `calcite-accordion-item`s. `calcite-accordion` cannot be nested, however calcite-accordion-item`s can."
         }
       ],
       "parts": [],
@@ -189,7 +189,7 @@
       "docsTags": [
         {
           "name": "slot",
-          "text": "- A slot for adding custom content."
+          "text": "- A slot for adding custom content, including nested `calcite-accordion-item`s."
         }
       ],
       "usage": {},
@@ -279,7 +279,7 @@
       "slots": [
         {
           "name": "",
-          "docs": "A slot for adding custom content."
+          "docs": "A slot for adding custom content, including nested `calcite-accordion-item`s."
         }
       ],
       "parts": [],
@@ -1740,13 +1740,51 @@
           "optional": false,
           "required": true
         },
+        {
+          "name": "placement",
+          "type": "\"bottom\" | \"bottom-end\" | \"bottom-start\" | \"top\" | \"top-end\" | \"top-start\"",
+          "mutable": false,
+          "attr": "placement",
+          "reflectToAttr": false,
+          "docs": "specify the placement of the alert",
+          "docsTags": [],
+          "default": "\"bottom\"",
+          "values": [
+            {
+              "value": "bottom",
+              "type": "string"
+            },
+            {
+              "value": "bottom-end",
+              "type": "string"
+            },
+            {
+              "value": "bottom-start",
+              "type": "string"
+            },
+            {
+              "value": "top",
+              "type": "string"
+            },
+            {
+              "value": "top-end",
+              "type": "string"
+            },
+            {
+              "value": "top-start",
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false
+        },
         {
           "name": "scale",
           "type": "\"l\" | \"m\" | \"s\"",
           "mutable": false,
           "attr": "scale",
           "reflectToAttr": true,
-          "docs": "specify the scale of the button, defaults to m",
+          "docs": "specify the scale of the alert, defaults to m",
           "docsTags": [],
           "default": "\"m\"",
           "values": [
@@ -4728,6 +4766,28 @@
           "optional": false,
           "required": false
         },
+        {
+          "name": "intlRemoveTag",
+          "type": "string",
+          "mutable": false,
+          "attr": "intl-remove-tag",
+          "reflectToAttr": false,
+          "docs": "string to override the English \"Remove tag\" text for when an item is selected.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "\"Remove tag\""
+            }
+          ],
+          "default": "TEXT.removeTag",
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false
+        },
         {
           "name": "label",
           "type": "string",
@@ -4915,7 +4975,7 @@
       "events": [
         {
           "event": "calciteComboboxChange",
-          "detail": "{ selectedItems: any[]; }",
+          "detail": "{ selectedItems: HTMLCalciteComboboxItemElement[]; }",
           "bubbles": true,
           "cancelable": true,
           "composed": true,
@@ -4933,7 +4993,7 @@
         },
         {
           "event": "calciteComboboxFilterChange",
-          "detail": "{ visibleItems: any[]; text: string; }",
+          "detail": "{ visibleItems: HTMLCalciteComboboxItemElement[]; text: string; }",
           "bubbles": true,
           "cancelable": true,
           "composed": true,
@@ -4942,7 +5002,7 @@
         },
         {
           "event": "calciteLookupChange",
-          "detail": "any[]",
+          "detail": "HTMLCalciteComboboxItemElement[]",
           "bubbles": true,
           "cancelable": true,
           "composed": true,
@@ -5031,14 +5091,14 @@
         },
         {
           "name": "ancestors",
-          "type": "any[]",
+          "type": "ComboboxChildElement[]",
           "mutable": true,
           "reflectToAttr": false,
           "docs": "Parent and grandparent combobox items, this is set internally for use from combobox",
           "docsTags": [],
           "values": [
             {
-              "type": "any[]"
+              "type": "ComboboxChildElement[]"
             }
           ],
           "optional": false,
@@ -5219,14 +5279,14 @@
       "props": [
         {
           "name": "ancestors",
-          "type": "any[]",
+          "type": "ComboboxChildElement[]",
           "mutable": true,
           "reflectToAttr": false,
           "docs": "Parent and grandparent combobox items, this is set internally for use from combobox",
           "docsTags": [],
           "values": [
             {
-              "type": "any[]"
+              "type": "ComboboxChildElement[]"
             }
           ],
           "optional": false,
@@ -6610,7 +6670,7 @@
         },
         {
           "name": "selectedItems",
-          "type": "any[]",
+          "type": "HTMLCalciteDropdownItemElement[]",
           "mutable": true,
           "reflectToAttr": false,
           "docs": "**read-only** The currently selected items",
@@ -6622,7 +6682,7 @@
           "default": "[]",
           "values": [
             {
-              "type": "any[]"
+              "type": "HTMLCalciteDropdownItemElement[]"
             }
           ],
           "optional": false,
@@ -7526,7 +7586,7 @@
         {
           "name": "back",
           "returns": {
-            "type": "Promise<any>",
+            "type": "Promise<HTMLCalcitePanelElement>",
             "docs": ""
           },
           "signature": "back() => Promise<HTMLCalcitePanelElement>",
@@ -7595,23 +7655,6 @@
           "optional": false,
           "required": false
         },
-        {
-          "name": "height",
-          "type": "number",
-          "mutable": false,
-          "attr": "height",
-          "reflectToAttr": false,
-          "docs": "Width of graph in pixels",
-          "docsTags": [],
-          "default": "100",
-          "values": [
-            {
-              "type": "number"
-            }
-          ],
-          "optional": false,
-          "required": false
-        },
         {
           "name": "highlightMax",
           "type": "number",
@@ -7675,23 +7718,6 @@
           ],
           "optional": false,
           "required": true
-        },
-        {
-          "name": "width",
-          "type": "number",
-          "mutable": false,
-          "attr": "width",
-          "reflectToAttr": false,
-          "docs": "Width of graph in pixels",
-          "docsTags": [],
-          "default": "300",
-          "values": [
-            {
-              "type": "number"
-            }
-          ],
-          "optional": false,
-          "required": false
         }
       ],
       "methods": [],
@@ -7871,7 +7897,13 @@
       "methods": [],
       "events": [],
       "listeners": [],
-      "styles": [],
+      "styles": [
+        {
+          "name": "--calcite-ui-icon-color",
+          "annotation": "prop",
+          "docs": "the color of the icon. Defaults to 'currentColor'."
+        }
+      ],
       "slots": [],
       "parts": [],
       "dependents": [
@@ -8218,7 +8250,26 @@
           "docsTags": []
         }
       ],
-      "events": [],
+      "events": [
+        {
+          "event": "calciteInlineEditableEditCancel",
+          "detail": "void",
+          "bubbles": true,
+          "cancelable": true,
+          "composed": true,
+          "docs": "Emitted when the cancel button gets clicked.",
+          "docsTags": []
+        },
+        {
+          "event": "calciteInlineEditableEditConfirm",
+          "detail": "void",
+          "bubbles": true,
+          "cancelable": true,
+          "composed": true,
+          "docs": "Emitted when the check button gets clicked.",
+          "docsTags": []
+        }
+      ],
       "listeners": [
         {
           "event": "calciteInputBlur",
@@ -9439,7 +9490,13 @@
           "cancelable": true,
           "composed": true,
           "docs": "Trigger calcite date change when a user changes the date.",
-          "docsTags": []
+          "docsTags": [
+            {
+              "name": "deprecated",
+              "text": "use `calciteInputDatePickerChange` instead."
+            }
+          ],
+          "deprecation": "use `calciteInputDatePickerChange` instead."
         },
         {
           "event": "calciteDatePickerRangeChange",
@@ -9452,11 +9509,35 @@
             {
               "name": "see",
               "text": " [DateRangeChange](https://github.com/Esri/calcite-components/blob/master/src/components/calcite-date-picker/interfaces.ts#L1)"
+            },
+            {
+              "name": "deprecated",
+              "text": "use `calciteInputDatePickerChange` instead."
             }
-          ]
+          ],
+          "deprecation": "use `calciteInputDatePickerChange` instead."
+        },
+        {
+          "event": "calciteInputDatePickerChange",
+          "detail": "void",
+          "bubbles": true,
+          "cancelable": true,
+          "composed": true,
+          "docs": "This event fires when the input date picker value changes.",
+          "docsTags": []
         }
       ],
       "listeners": [
+        {
+          "event": "calciteDatePickerChange",
+          "capture": false,
+          "passive": false
+        },
+        {
+          "event": "calciteDatePickerRangeChange",
+          "capture": false,
+          "passive": false
+        },
         {
           "event": "calciteDaySelect",
           "capture": false,
@@ -9951,7 +10032,7 @@
           "mutable": true,
           "attr": "value",
           "reflectToAttr": false,
-          "docs": "The selected time (always 24-hour format)",
+          "docs": "The selected time in UTC (always 24-hour format)",
           "docsTags": [],
           "default": "null",
           "values": [
@@ -10193,8 +10274,14 @@
           "attr": "status",
           "reflectToAttr": true,
           "docs": "specify the status of the label and any child input / input messages",
-          "docsTags": [],
+          "docsTags": [
+            {
+              "name": "deprecated",
+              "text": "set directly on child element instead"
+            }
+          ],
           "default": "\"idle\"",
+          "deprecation": "set directly on child element instead",
           "values": [
             {
               "value": "idle",
@@ -10268,6 +10355,26 @@
           "optional": false,
           "required": false
         },
+        {
+          "name": "download",
+          "type": "boolean | string",
+          "mutable": false,
+          "attr": "download",
+          "reflectToAttr": true,
+          "docs": "Prompts the user to save the linked URL instead of navigating to it. Can be used with or without a value:\nWithout a value, the browser will suggest a filename/extension\nSee: https://developer.mozilla.org/en-US/docs/Web/HTML/Element/a#attr-download",
+          "docsTags": [],
+          "default": "false",
+          "values": [
+            {
+              "type": "boolean"
+            },
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false
+        },
         {
           "name": "href",
           "type": "string",
@@ -12307,6 +12414,17 @@
         }
       ],
       "methods": [
+        {
+          "name": "scrollContentTo",
+          "returns": {
+            "type": "Promise<void>",
+            "docs": ""
+          },
+          "signature": "scrollContentTo(options?: ScrollToOptions) => Promise<void>",
+          "parameters": [],
+          "docs": "Scrolls panel content to a particular set of coordinates.\n\n```\n myCalcitePanel.scrollContentTo({\n   left: 0, // Specifies the number of pixels along the X axis to scroll the window or element.\n   top: 0, // Specifies the number of pixels along the Y axis to scroll the window or element\n   behavior: \"auto\" // Specifies whether the scrolling should animate smoothly (smooth), or happen instantly in a single jump (auto, the default value).\n });\n```",
+          "docsTags": []
+        },
         {
           "name": "setFocus",
           "returns": {
@@ -12596,7 +12714,7 @@
         {
           "name": "getSelectedItems",
           "returns": {
-            "type": "Promise<Map<string, any>>",
+            "type": "Promise<Map<string, HTMLCalcitePickListItemElement>>",
             "docs": ""
           },
           "signature": "getSelectedItems() => Promise<Map<string, HTMLCalcitePickListItemElement>>",
@@ -12619,7 +12737,7 @@
       "events": [
         {
           "event": "calciteListChange",
-          "detail": "any",
+          "detail": "Map<string, HTMLCalcitePickListItemElement>",
           "bubbles": true,
           "cancelable": true,
           "composed": true,
@@ -13000,7 +13118,7 @@
       "events": [
         {
           "event": "calciteListItemChange",
-          "detail": "{ item: any; value: any; selected: boolean; shiftPressed: boolean; }",
+          "detail": "{ item: HTMLCalcitePickListItemElement; value: any; selected: boolean; shiftPressed: boolean; }",
           "bubbles": true,
           "cancelable": true,
           "composed": true,
@@ -14145,15 +14263,14 @@
         },
         {
           "name": "selectedItem",
-          "type": "any",
+          "type": "HTMLCalciteRadioGroupItemElement",
           "mutable": true,
-          "attr": "selected-item",
           "reflectToAttr": false,
           "docs": "The group's selected item.",
           "docsTags": [],
           "values": [
             {
-              "type": "any"
+              "type": "HTMLCalciteRadioGroupItemElement"
             }
           ],
           "optional": false,
@@ -14815,9 +14932,8 @@
         },
         {
           "name": "selectedOption",
-          "type": "any",
+          "type": "HTMLCalciteOptionElement",
           "mutable": true,
-          "attr": "selected-option",
           "reflectToAttr": false,
           "docs": "The currently selected option.",
           "docsTags": [
@@ -14827,7 +14943,7 @@
           ],
           "values": [
             {
-              "type": "any"
+              "type": "HTMLCalciteOptionElement"
             }
           ],
           "optional": false,
@@ -18285,7 +18401,7 @@
           "mutable": false,
           "attr": "step",
           "reflectToAttr": false,
-          "docs": "number that specifies the granularity that the value must adhere to",
+          "docs": "number (seconds) that specifies the granularity that the value must adhere to",
           "docsTags": [],
           "default": "60",
           "values": [
@@ -18302,7 +18418,7 @@
           "mutable": true,
           "attr": "value",
           "reflectToAttr": false,
-          "docs": "The selected time in UTC",
+          "docs": "The selected time in UTC (always 24-hour format)",
           "docsTags": [],
           "default": "null",
           "values": [
@@ -18849,7 +18965,7 @@
           "mutable": false,
           "attr": "offset-distance",
           "reflectToAttr": true,
-          "docs": "Offset the position of the popover away from the reference element.",
+          "docs": "Offset the position of the tooltip away from the reference element.",
           "docsTags": [
             {
               "name": "default",
@@ -18871,7 +18987,7 @@
           "mutable": false,
           "attr": "offset-skidding",
           "reflectToAttr": true,
-          "docs": "Offset the position of the popover along the reference element.",
+          "docs": "Offset the position of the tooltip along the reference element.",
           "docsTags": [],
           "default": "0",
           "values": [
@@ -19518,7 +19634,7 @@
         {
           "name": "getSelectedItems",
           "returns": {
-            "type": "Promise<Map<string, any>>",
+            "type": "Promise<Map<string, HTMLCalciteValueListItemElement>>",
             "docs": ""
           },
           "signature": "getSelectedItems() => Promise<Map<string, HTMLCalciteValueListItemElement>>",
@@ -19541,7 +19657,7 @@
       "events": [
         {
           "event": "calciteListChange",
-          "detail": "any",
+          "detail": "Map<string, HTMLCalciteValueListItemElement>",
           "bubbles": true,
           "cancelable": true,
           "composed": true,
@@ -19550,7 +19666,7 @@
         },
         {
           "event": "calciteListOrderChange",
-          "detail": "any",
+          "detail": "any[]",
           "bubbles": true,
           "cancelable": true,
           "composed": true,

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

@@ -0,0 +1,42 @@
+import { EventEmitter, VNode } from "../../stencil-public-runtime";
+import { AccordionAppearance } from "./interfaces";
+import { Position, Scale } from "../interfaces";
+/**
+ * @slot - A slot for adding `calcite-accordion-item`s. `calcite-accordion` cannot be nested, however calcite-accordion-item`s can.
+ */
+export declare class CalciteAccordion {
+  el: HTMLCalciteAccordionElement;
+  /** specify the appearance - default (containing border), or minimal (no containing border), defaults to default */
+  appearance: AccordionAppearance;
+  /** specify the placement of the icon in the header, defaults to end */
+  iconPosition: Position;
+  /** specify the type of the icon in the header, defaults to chevron */
+  iconType: "chevron" | "caret" | "plus-minus";
+  /** specify the scale of accordion, defaults to m */
+  scale: Scale;
+  /** specify the selection mode - multi (allow any number of open items), single (allow one open item),
+   * or single-persist (allow and require one open item), defaults to multi */
+  selectionMode: "multi" | "single" | "single-persist";
+  /**
+   * @internal
+   */
+  calciteAccordionChange: EventEmitter;
+  componentDidLoad(): void;
+  render(): VNode;
+  calciteAccordionItemKeyEvent(e: CustomEvent): void;
+  registerCalciteAccordionItem(e: CustomEvent): void;
+  updateActiveItemOnChange(event: CustomEvent): void;
+  /** created list of Accordion items */
+  private items;
+  /** keep track of whether the items have been sorted so we don't re-sort */
+  private sorted;
+  /** keep track of the requested item for multi mode */
+  private requestedAccordionItem;
+  private focusFirstItem;
+  private focusLastItem;
+  private focusNextItem;
+  private focusPrevItem;
+  private itemIndex;
+  private focusElement;
+  private sortItems;
+}

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

@@ -0,0 +1,53 @@
+import { EventEmitter, VNode } from "../../stencil-public-runtime";
+/**
+ * @slot - A slot for adding custom content, including nested `calcite-accordion-item`s.
+ */
+export declare class CalciteAccordionItem {
+  el: HTMLCalciteAccordionItemElement;
+  /** Indicates whether the item is active. */
+  active: boolean;
+  /** pass a title for the accordion item */
+  itemTitle?: string;
+  /** pass a title for the accordion item */
+  itemSubtitle?: string;
+  /** optionally pass an icon to display - accepts Calcite UI icon names  */
+  icon?: string;
+  /**
+   * @internal
+   */
+  calciteAccordionItemKeyEvent: EventEmitter;
+  /**
+   * @internal
+   */
+  calciteAccordionItemSelect: EventEmitter;
+  /**
+   * @internal
+   */
+  calciteAccordionItemClose: EventEmitter;
+  /**
+   * @internal
+   */
+  calciteAccordionItemRegister: EventEmitter;
+  connectedCallback(): void;
+  componentDidLoad(): void;
+  render(): VNode;
+  keyDownHandler(e: KeyboardEvent): void;
+  updateActiveItemOnChange(event: CustomEvent): void;
+  /** the containing accordion element */
+  private parent;
+  /** position within parent */
+  private itemPosition;
+  /** the latest requested item */
+  private requestedAccordionItem;
+  /** what selection mode is the parent accordion in */
+  private selectionMode;
+  /** what icon position does the parent accordion specify */
+  private iconPosition;
+  /** what icon type does the parent accordion specify */
+  private iconType;
+  /** handle clicks on item header */
+  private itemHeaderClickHandler;
+  private determineActiveItem;
+  private emitRequestedItem;
+  private getItemPosition;
+}