@esri/calcite-components 1.0.0-next.505 → 1.0.0-next.508

package/dist/extras/docs-json.json

@@ -1,5 +1,5 @@
 {
-  "timestamp": "2022-06-30T16:18:47",
+  "timestamp": "2022-07-07T05:57:12",
   "compiler": {
     "name": "@stencil/core",
     "version": "2.17.0",
@@ -8650,7 +8650,7 @@
       "docsTags": [
         {
           "name": "slot",
-          "text": "action - A slot for positioning a button next to an input"
+          "text": "action - A slot for positioning a button next to the component."
         }
       ],
       "usage": {
@@ -8667,7 +8667,7 @@
           "mutable": false,
           "attr": "alignment",
           "reflectToAttr": true,
-          "docs": "specify the alignment of the value of the input",
+          "docs": "Specifies the text alignment of the component's value.",
           "docsTags": [],
           "default": "\"start\"",
           "values": [
@@ -8689,8 +8689,13 @@
           "mutable": false,
           "attr": "autofocus",
           "reflectToAttr": false,
-          "docs": "should the input autofocus",
-          "docsTags": [],
+          "docs": "When true, the component is focused on page load.",
+          "docsTags": [
+            {
+              "name": "mdn",
+              "text": "[autofocus](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/autofocus)"
+            }
+          ],
           "default": "false",
           "values": [
             {
@@ -8706,7 +8711,7 @@
           "mutable": false,
           "attr": "clearable",
           "reflectToAttr": true,
-          "docs": "optionally display a clear button that displays when field has a value\nshows by default for search, time, date\nwill not display for type=\"textarea\"",
+          "docs": "When true, a clear button is displayed when the component has a value. The clear button shows by default for \"search\", \"time\", and \"date\" types, and will not display for the \"textarea\" type.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -8723,8 +8728,13 @@
           "mutable": false,
           "attr": "disabled",
           "reflectToAttr": true,
-          "docs": "is the input disabled",
-          "docsTags": [],
+          "docs": "When true, interaction is prevented and the component is displayed with lower opacity.",
+          "docsTags": [
+            {
+              "name": "mdn",
+              "text": "[disabled](https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/disabled)"
+            }
+          ],
           "default": "false",
           "values": [
             {
@@ -8740,7 +8750,7 @@
           "mutable": false,
           "attr": "group-separator",
           "reflectToAttr": false,
-          "docs": "for number values, displays the locale's group separator",
+          "docs": "When true, number values are displayed with the locale's group separator.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -8757,8 +8767,13 @@
           "mutable": false,
           "attr": "hidden",
           "reflectToAttr": false,
-          "docs": "when true, the component will not be visible",
-          "docsTags": [],
+          "docs": "When true, the component will not be visible.",
+          "docsTags": [
+            {
+              "name": "mdn",
+              "text": "[hidden](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/hidden)"
+            }
+          ],
           "default": "false",
           "values": [
             {
@@ -8774,7 +8789,7 @@
           "mutable": false,
           "attr": "icon",
           "reflectToAttr": true,
-          "docs": "when used as a boolean set to true, show a default recommended icon for certain\ninput types (tel, password, email, date, time, search). You can also pass a\ncalcite-ui-icon name to this prop to display a requested icon for any input type",
+          "docs": "When true, shows a default recommended icon. Alternatively, pass a Calcite UI Icon name to display a specific icon.",
           "docsTags": [],
           "values": [
             {
@@ -8793,7 +8808,7 @@
           "mutable": false,
           "attr": "icon-flip-rtl",
           "reflectToAttr": true,
-          "docs": "flip the icon in rtl",
+          "docs": "When true, the icon is flipped in RTL.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -8826,7 +8841,7 @@
           "mutable": false,
           "attr": "intl-loading",
           "reflectToAttr": false,
-          "docs": "string to override English loading text",
+          "docs": "Accessible name that will appear while loading.",
           "docsTags": [
             {
               "name": "default",
@@ -8848,7 +8863,7 @@
           "mutable": false,
           "attr": "label",
           "reflectToAttr": false,
-          "docs": "Applies to the aria-label attribute on the button or hyperlink",
+          "docs": "Accessible name for the component's button or hyperlink.",
           "docsTags": [],
           "values": [
             {
@@ -8864,7 +8879,7 @@
           "mutable": false,
           "attr": "loading",
           "reflectToAttr": true,
-          "docs": "specify if the input is in loading state",
+          "docs": "When true, the component is in the loading state and `calcite-progress` is displayed.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -8881,7 +8896,7 @@
           "mutable": false,
           "attr": "locale",
           "reflectToAttr": false,
-          "docs": "BCP 47 language tag for desired language and country format",
+          "docs": "Specifies the BCP 47 language tag for the desired language and country format.",
           "docsTags": [],
           "default": "document.documentElement.lang || \"en\"",
           "values": [
@@ -8898,8 +8913,13 @@
           "mutable": false,
           "attr": "max",
           "reflectToAttr": true,
-          "docs": "input max",
-          "docsTags": [],
+          "docs": "Specifies the maximum value for type \"number\".",
+          "docsTags": [
+            {
+              "name": "mdn",
+              "text": "[max](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#max)"
+            }
+          ],
           "values": [
             {
               "type": "number"
@@ -8914,8 +8934,13 @@
           "mutable": false,
           "attr": "max-length",
           "reflectToAttr": true,
-          "docs": "Maximum length of the input value",
-          "docsTags": [],
+          "docs": "Specifies the maximum length of text for the component's value.",
+          "docsTags": [
+            {
+              "name": "mdn",
+              "text": "[maxlength](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#maxlength)"
+            }
+          ],
           "values": [
             {
               "type": "number"
@@ -8930,7 +8955,7 @@
           "mutable": false,
           "attr": "maxlength",
           "reflectToAttr": true,
-          "docs": "Maximum length of text input.",
+          "docs": "Specifies the maximum length of text for the component's value.",
           "docsTags": [
             {
               "name": "deprecated",
@@ -8952,8 +8977,13 @@
           "mutable": false,
           "attr": "min",
           "reflectToAttr": true,
-          "docs": "input min",
-          "docsTags": [],
+          "docs": "Specifies the minimum value for type \"number\".",
+          "docsTags": [
+            {
+              "name": "mdn",
+              "text": "[min](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#min)"
+            }
+          ],
           "values": [
             {
               "type": "number"
@@ -8968,8 +8998,13 @@
           "mutable": false,
           "attr": "min-length",
           "reflectToAttr": true,
-          "docs": "Minimum length of the text input",
-          "docsTags": [],
+          "docs": "Specifies the minimum length of text for the component's value.",
+          "docsTags": [
+            {
+              "name": "mdn",
+              "text": "[minlength](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#minlength)"
+            }
+          ],
           "values": [
             {
               "type": "number"
@@ -8984,8 +9019,13 @@
           "mutable": false,
           "attr": "name",
           "reflectToAttr": true,
-          "docs": "The name of the input",
-          "docsTags": [],
+          "docs": "Specifies the name of the component.",
+          "docsTags": [
+            {
+              "name": "mdn",
+              "text": "[name](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#name)"
+            }
+          ],
           "values": [
             {
               "type": "string"
@@ -9000,7 +9040,7 @@
           "mutable": false,
           "attr": "number-button-type",
           "reflectToAttr": true,
-          "docs": "specify the placement of the number buttons",
+          "docs": "Specifies the placement of the buttons for type \"number\".",
           "docsTags": [],
           "default": "\"vertical\"",
           "values": [
@@ -9026,8 +9066,13 @@
           "mutable": false,
           "attr": "numbering-system",
           "reflectToAttr": false,
-          "docs": "standard UniCode numeral system tag for localization",
-          "docsTags": [],
+          "docs": "Specifies the Unicode numeral system used by the component for localization.",
+          "docsTags": [
+            {
+              "name": "mdn",
+              "text": "[numberingSystem](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/Locale/numberingSystem)"
+            }
+          ],
           "values": [
             {
               "type": "string"
@@ -9042,8 +9087,13 @@
           "mutable": false,
           "attr": "placeholder",
           "reflectToAttr": false,
-          "docs": "explicitly whitelist placeholder attribute",
-          "docsTags": [],
+          "docs": "Specifies placeholder text for the component.",
+          "docsTags": [
+            {
+              "name": "mdn",
+              "text": "[placeholder](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#placeholder)"
+            }
+          ],
           "values": [
             {
               "type": "string"
@@ -9058,7 +9108,7 @@
           "mutable": false,
           "attr": "prefix-text",
           "reflectToAttr": false,
-          "docs": "optionally add prefix",
+          "docs": "Adds text to the start of the component.",
           "docsTags": [],
           "values": [
             {
@@ -9074,8 +9124,13 @@
           "mutable": false,
           "attr": "read-only",
           "reflectToAttr": false,
-          "docs": "When true, a field cannot be modified.",
-          "docsTags": [],
+          "docs": "When true, the value cannot be modified.",
+          "docsTags": [
+            {
+              "name": "mdn",
+              "text": "[readOnly](https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/readonly)"
+            }
+          ],
           "default": "false",
           "values": [
             {
@@ -9091,7 +9146,7 @@
           "mutable": false,
           "attr": "required",
           "reflectToAttr": false,
-          "docs": "is the input required",
+          "docs": "When true, the component must have a value in order for the form to submit.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -9108,7 +9163,7 @@
           "mutable": true,
           "attr": "scale",
           "reflectToAttr": true,
-          "docs": "specify the scale of the input, defaults to m",
+          "docs": "Specifies the size of the component.",
           "docsTags": [],
           "default": "\"m\"",
           "values": [
@@ -9134,7 +9189,7 @@
           "mutable": true,
           "attr": "status",
           "reflectToAttr": true,
-          "docs": "specify the status of the input field, determines message and icons",
+          "docs": "Specifies the status of the input field, which determines message and icons.",
           "docsTags": [],
           "default": "\"idle\"",
           "values": [
@@ -9160,8 +9215,13 @@
           "mutable": false,
           "attr": "step",
           "reflectToAttr": true,
-          "docs": "input step",
-          "docsTags": [],
+          "docs": "Specifies the granularity that the component's value must adhere to.",
+          "docsTags": [
+            {
+              "name": "mdn",
+              "text": "[step](https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/step)"
+            }
+          ],
           "values": [
             {
               "value": "any",
@@ -9180,7 +9240,7 @@
           "mutable": false,
           "attr": "suffix-text",
           "reflectToAttr": false,
-          "docs": "optionally add suffix",
+          "docs": "Adds text to the end of the component.",
           "docsTags": [],
           "values": [
             {
@@ -9196,7 +9256,7 @@
           "mutable": false,
           "attr": "type",
           "reflectToAttr": true,
-          "docs": "specify the input type\n\nNote that the following types add type-specific icons by default: `date`, `email`, `password`, `search`, `tel`, `time`",
+          "docs": "Specifies the component type.\n\nNote that the following types add type-specific icons by default: \"date\", \"email\", \"password\", \"search\", \"tel\", \"time\".",
           "docsTags": [],
           "default": "\"text\"",
           "values": [
@@ -9274,7 +9334,7 @@
           "mutable": true,
           "attr": "value",
           "reflectToAttr": false,
-          "docs": "input value",
+          "docs": "The component's value.",
           "docsTags": [],
           "default": "\"\"",
           "values": [
@@ -9287,6 +9347,17 @@
         }
       ],
       "methods": [
+        {
+          "name": "selectText",
+          "returns": {
+            "type": "Promise<void>",
+            "docs": ""
+          },
+          "signature": "selectText() => Promise<void>",
+          "parameters": [],
+          "docs": "Selects all text of the component's `value`.",
+          "docsTags": []
+        },
         {
           "name": "setFocus",
           "returns": {
@@ -9306,7 +9377,7 @@
           "bubbles": true,
           "cancelable": true,
           "composed": true,
-          "docs": "This event fires each time a new value is typed and committed.",
+          "docs": "Fires each time a new value is typed and committed.",
           "docsTags": []
         },
         {
@@ -9315,7 +9386,7 @@
           "bubbles": true,
           "cancelable": true,
           "composed": true,
-          "docs": "This event fires each time a new value is typed.",
+          "docs": "Fires each time a new value is typed.",
           "docsTags": []
         }
       ],
@@ -9324,7 +9395,7 @@
       "slots": [
         {
           "name": "action",
-          "docs": "A slot for positioning a button next to an input"
+          "docs": "A slot for positioning a button next to the component."
         }
       ],
       "parts": [],
@@ -14872,7 +14943,11 @@
           "mutable": true,
           "reflectToAttr": false,
           "docs": "The group's selected item.",
-          "docsTags": [],
+          "docsTags": [
+            {
+              "name": "readonly"
+            }
+          ],
           "values": [
             {
               "type": "HTMLCalciteRadioGroupItemElement"

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.505
+ * v1.0.0-next.508
  */
 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.505
+ * v1.0.0-next.508
  */
 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.505
+ * v1.0.0-next.508
  */
 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.505
+ * v1.0.0-next.508
  */
 (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/checkbox/checkbox.d.ts

@@ -45,6 +45,7 @@ export declare class Checkbox implements LabelableComponent, CheckableFormCompom
   readonly indeterminatePath = "M13 8v1H3V8z";
   labelEl: HTMLCalciteLabelElement;
   formEl: HTMLFormElement;
+  defaultChecked: boolean;
   defaultValue: Checkbox["checked"];
   toggleEl: HTMLDivElement;
   /** Sets focus on the component. */

package/dist/types/components/color-picker/color-picker.d.ts

@@ -263,6 +263,7 @@ export declare class ColorPicker implements InteractiveComponent {
   private setCanvasContextSize;
   private captureColorFieldColor;
   private initColorFieldAndSlider;
+  private updateCanvasSize;
   private containsPoint;
   private drawActiveColorFieldColor;
   private drawThumb;

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

@@ -7,6 +7,7 @@ import { ComboboxSelectionMode, ComboboxChildElement } from "./interfaces";
 import { LabelableComponent } from "../../utils/label";
 import { FormComponent } from "../../utils/form";
 import { InteractiveComponent } from "../../utils/interactive";
+import { OpenCloseComponent } from "../../utils/openCloseComponent";
 interface ItemData {
   label: string;
   value: string;
@@ -14,7 +15,7 @@ interface ItemData {
 /**
  * @slot - A slot for adding `calcite-combobox-item`s.
  */
-export declare class Combobox implements LabelableComponent, FormComponent, InteractiveComponent {
+export declare class Combobox implements LabelableComponent, FormComponent, InteractiveComponent, OpenCloseComponent {
   el: HTMLCalciteComboboxElement;
   /** Opens or closes the combobox */
   active: boolean;
@@ -144,10 +145,13 @@ export declare class Combobox implements LabelableComponent, FormComponent, Inte
   keydownHandler: (event: KeyboardEvent) => void;
   private toggleCloseEnd;
   private toggleOpenEnd;
+  onBeforeOpen(): void;
+  onOpen(): void;
+  onBeforeClose(): void;
+  onClose(): void;
   transitionEnd: (event: TransitionEvent) => void;
   transitionRunHandler: (event: TransitionEvent) => void;
-  private emitOpenCloseEvent;
-  setMaxScrollerHeight: () => void;
+  setMaxScrollerHeight: () => Promise<void>;
   calciteChipDismissHandler: (event: CustomEvent<HTMLCalciteChipElement>, comboboxItem: HTMLCalciteComboboxItemElement) => void;
   clickHandler: (event: MouseEvent) => void;
   setInactiveIfNotContained: (event: Event) => void;

package/dist/types/components/date-picker/utils.d.ts

@@ -4,7 +4,7 @@
  * @private
  */
 export interface DateLocaleData {
-  "default-calendar": "gregorian";
+  "default-calendar": "gregorian" | "buddhist";
   separator: string;
   unitOrder: string;
   weekStart: number;

package/dist/types/components/date-picker-month-header/date-picker-month-header.d.ts

@@ -45,6 +45,8 @@ export declare class DatePickerMonthHeader {
    * @param e
    */
   private onYearKey;
+  private formatCalendarYear;
+  private parseCalendarYear;
   private onYearChange;
   private onYearInput;
   private prevMonthClick;

package/dist/types/components/date-picker-month-header/resources.d.ts

@@ -0,0 +1 @@
+export declare const BUDDHIST_CALENDAR_YEAR_OFFSET = 543;

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

@@ -4,6 +4,13 @@ import { FlowDirection } from "./interfaces";
  * @slot - A slot for adding `calcite-panel`s to the flow.
  */
 export declare class Flow {
+  /**
+   * todo: document and finalize property name.
+   *
+   * @internal
+   */
+  allowDescendantPanels: boolean;
+  handleallowDescendantPanelsChange(): void;
   /**
    * Removes the currently active `calcite-panel`.
    */
@@ -12,8 +19,13 @@ export declare class Flow {
   panelCount: number;
   flowDirection: FlowDirection;
   panels: HTMLCalcitePanelElement[];
+  panelItemMutationObserver: MutationObserver;
+  connectedCallback(): void;
+  disconnectedCallback(): void;
   handleCalcitePanelBackClick(): void;
   getFlowDirection: (oldPanelCount: number, newPanelCount: number) => FlowDirection | null;
-  updateFlowProps: (event: Event) => void;
+  handleMutationObserverChange: () => void;
+  handleDefaultSlotChange: (event: Event) => void;
+  updateFlowProps: (newPanels: HTMLCalcitePanelElement[]) => void;
   render(): VNode;
 }