@esri/calcite-components 1.0.0-next.540 → 1.0.0-next.543

package/dist/extras/docs-json.json

@@ -1,5 +1,5 @@
 {
-  "timestamp": "2022-07-26T17:27:05",
+  "timestamp": "2022-07-27T20:34:51",
   "compiler": {
     "name": "@stencil/core",
     "version": "2.16.1",
@@ -1388,10 +1388,10 @@
       ],
       "listeners": [
         {
-          "event": "click",
+          "event": "pointerdown",
           "target": "window",
           "capture": false,
-          "passive": false
+          "passive": true
         }
       ],
       "styles": [],
@@ -1710,9 +1710,15 @@
           "mutable": true,
           "attr": "active",
           "reflectToAttr": true,
-          "docs": "When true, the component is active.",
-          "docsTags": [],
+          "docs": "When true, opens the combobox",
+          "docsTags": [
+            {
+              "name": "deprecated",
+              "text": "use open instead"
+            }
+          ],
           "default": "false",
+          "deprecation": "use open instead",
           "values": [
             {
               "type": "boolean"
@@ -1851,6 +1857,23 @@
           "optional": false,
           "required": true
         },
+        {
+          "name": "open",
+          "type": "boolean",
+          "mutable": true,
+          "attr": "open",
+          "reflectToAttr": true,
+          "docs": "When true, opens the dropdown",
+          "docsTags": [],
+          "default": "false",
+          "values": [
+            {
+              "type": "boolean"
+            }
+          ],
+          "optional": false,
+          "required": false
+        },
         {
           "name": "placement",
           "type": "\"bottom\" | \"bottom-end\" | \"bottom-start\" | \"top\" | \"top-end\" | \"top-start\"",
@@ -8406,6 +8429,7 @@
         "calcite-input-date-picker",
         "calcite-input-message",
         "calcite-input-number",
+        "calcite-input-text",
         "calcite-link",
         "calcite-modal",
         "calcite-notice",
@@ -8476,6 +8500,9 @@
         "calcite-input-number": [
           "calcite-icon"
         ],
+        "calcite-input-text": [
+          "calcite-icon"
+        ],
         "calcite-link": [
           "calcite-icon"
         ],
@@ -11119,41 +11146,54 @@
       }
     },
     {
-      "filePath": "./src/components/input-time-picker/input-time-picker.tsx",
+      "filePath": "./src/components/input-text/input-text.tsx",
       "encapsulation": "shadow",
-      "tag": "calcite-input-time-picker",
-      "readme": "# calcite-input-time-picker\n",
+      "tag": "calcite-input-text",
+      "readme": "# calcite-input-text\n",
       "docs": "",
-      "docsTags": [],
-      "usage": {
-        "Basic": "```html\n<calcite-input-time-picker\n  hour-display-format=\"12\"\n  name=\"light\"\n  scale=\"m\"\n  step=\"1\"\n  value=\"12:21\"\n></calcite-input-time-picker>\n```\n"
-      },
+      "docsTags": [
+        {
+          "name": "slot",
+          "text": "action - A slot for positioning a button next to the component."
+        }
+      ],
+      "usage": {},
       "props": [
         {
-          "name": "active",
-          "type": "boolean",
-          "mutable": true,
-          "attr": "active",
+          "name": "alignment",
+          "type": "\"end\" | \"start\"",
+          "mutable": false,
+          "attr": "alignment",
           "reflectToAttr": true,
-          "docs": "The active state of the time input",
+          "docs": "Specifies the text alignment of the component's value.",
           "docsTags": [],
-          "default": "false",
+          "default": "\"start\"",
           "values": [
             {
-              "type": "boolean"
+              "value": "end",
+              "type": "string"
+            },
+            {
+              "value": "start",
+              "type": "string"
             }
           ],
           "optional": false,
           "required": false
         },
         {
-          "name": "disabled",
+          "name": "autofocus",
           "type": "boolean",
           "mutable": false,
-          "attr": "disabled",
-          "reflectToAttr": true,
-          "docs": "The disabled state of the time input",
-          "docsTags": [],
+          "attr": "autofocus",
+          "reflectToAttr": false,
+          "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": [
             {
@@ -11164,92 +11204,109 @@
           "required": false
         },
         {
-          "name": "intlHour",
-          "type": "string",
+          "name": "clearable",
+          "type": "boolean",
           "mutable": false,
-          "attr": "intl-hour",
-          "reflectToAttr": false,
-          "docs": "aria-label for the hour input",
+          "attr": "clearable",
+          "reflectToAttr": true,
+          "docs": "When true, a clear button is displayed when the component has a value.",
           "docsTags": [],
+          "default": "false",
           "values": [
             {
-              "type": "string"
+              "type": "boolean"
             }
           ],
-          "optional": true,
+          "optional": false,
           "required": false
         },
         {
-          "name": "intlHourDown",
-          "type": "string",
+          "name": "disabled",
+          "type": "boolean",
           "mutable": false,
-          "attr": "intl-hour-down",
-          "reflectToAttr": false,
-          "docs": "aria-label for the hour down button",
-          "docsTags": [],
+          "attr": "disabled",
+          "reflectToAttr": true,
+          "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": [
             {
-              "type": "string"
+              "type": "boolean"
             }
           ],
-          "optional": true,
+          "optional": false,
           "required": false
         },
         {
-          "name": "intlHourUp",
-          "type": "string",
+          "name": "hidden",
+          "type": "boolean",
           "mutable": false,
-          "attr": "intl-hour-up",
+          "attr": "hidden",
           "reflectToAttr": false,
-          "docs": "aria-label for the hour up button",
-          "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": [
             {
-              "type": "string"
+              "type": "boolean"
             }
           ],
-          "optional": true,
+          "optional": false,
           "required": false
         },
         {
-          "name": "intlMeridiem",
-          "type": "string",
+          "name": "icon",
+          "type": "boolean | string",
           "mutable": false,
-          "attr": "intl-meridiem",
-          "reflectToAttr": false,
-          "docs": "aria-label for the meridiem (am/pm) input",
+          "attr": "icon",
+          "reflectToAttr": true,
+          "docs": "When true, shows a default recommended icon. Alternatively, pass a Calcite UI Icon name to display a specific icon.",
           "docsTags": [],
           "values": [
+            {
+              "type": "boolean"
+            },
             {
               "type": "string"
             }
           ],
-          "optional": true,
+          "optional": false,
           "required": false
         },
         {
-          "name": "intlMeridiemDown",
-          "type": "string",
+          "name": "iconFlipRtl",
+          "type": "boolean",
           "mutable": false,
-          "attr": "intl-meridiem-down",
-          "reflectToAttr": false,
-          "docs": "aria-label for the meridiem (am/pm) down button",
+          "attr": "icon-flip-rtl",
+          "reflectToAttr": true,
+          "docs": "When true, the icon is flipped in RTL.",
           "docsTags": [],
+          "default": "false",
           "values": [
             {
-              "type": "string"
+              "type": "boolean"
             }
           ],
-          "optional": true,
+          "optional": false,
           "required": false
         },
         {
-          "name": "intlMeridiemUp",
+          "name": "intlClear",
           "type": "string",
           "mutable": false,
-          "attr": "intl-meridiem-up",
+          "attr": "intl-clear",
           "reflectToAttr": false,
-          "docs": "aria-label for the meridiem (am/pm) up button",
+          "docs": "A text label that will appear on the clear button for screen readers.",
           "docsTags": [],
           "values": [
             {
@@ -11260,13 +11317,19 @@
           "required": false
         },
         {
-          "name": "intlMinute",
+          "name": "intlLoading",
           "type": "string",
           "mutable": false,
-          "attr": "intl-minute",
+          "attr": "intl-loading",
           "reflectToAttr": false,
-          "docs": "aria-label for the minute input",
-          "docsTags": [],
+          "docs": "Accessible name that will appear while loading.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "\"Loading\""
+            }
+          ],
+          "default": "COMMON_TEXT.loading",
           "values": [
             {
               "type": "string"
@@ -11276,12 +11339,12 @@
           "required": false
         },
         {
-          "name": "intlMinuteDown",
+          "name": "label",
           "type": "string",
           "mutable": false,
-          "attr": "intl-minute-down",
+          "attr": "label",
           "reflectToAttr": false,
-          "docs": "aria-label for the minute down button",
+          "docs": "Accessible name for the component's button or hyperlink.",
           "docsTags": [],
           "values": [
             {
@@ -11292,64 +11355,544 @@
           "required": false
         },
         {
-          "name": "intlMinuteUp",
-          "type": "string",
+          "name": "loading",
+          "type": "boolean",
           "mutable": false,
-          "attr": "intl-minute-up",
-          "reflectToAttr": false,
-          "docs": "aria-label for the minute up button",
+          "attr": "loading",
+          "reflectToAttr": true,
+          "docs": "When true, the component is in the loading state and `calcite-progress` is displayed.",
           "docsTags": [],
+          "default": "false",
           "values": [
             {
-              "type": "string"
+              "type": "boolean"
             }
           ],
-          "optional": true,
+          "optional": false,
           "required": false
         },
         {
-          "name": "intlSecond",
-          "type": "string",
+          "name": "maxLength",
+          "type": "number",
           "mutable": false,
-          "attr": "intl-second",
-          "reflectToAttr": false,
-          "docs": "aria-label for the second input",
-          "docsTags": [],
+          "attr": "max-length",
+          "reflectToAttr": true,
+          "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": "string"
+              "type": "number"
             }
           ],
           "optional": true,
           "required": false
         },
         {
-          "name": "intlSecondDown",
-          "type": "string",
+          "name": "minLength",
+          "type": "number",
           "mutable": false,
-          "attr": "intl-second-down",
-          "reflectToAttr": false,
-          "docs": "aria-label for the second down button",
-          "docsTags": [],
+          "attr": "min-length",
+          "reflectToAttr": true,
+          "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": "string"
+              "type": "number"
             }
           ],
           "optional": true,
           "required": false
         },
         {
-          "name": "intlSecondUp",
+          "name": "name",
           "type": "string",
           "mutable": false,
-          "attr": "intl-second-up",
-          "reflectToAttr": false,
-          "docs": "aria-label for the second up button",
-          "docsTags": [],
-          "values": [
-            {
-              "type": "string"
+          "attr": "name",
+          "reflectToAttr": true,
+          "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"
+            }
+          ],
+          "optional": false,
+          "required": false
+        },
+        {
+          "name": "placeholder",
+          "type": "string",
+          "mutable": false,
+          "attr": "placeholder",
+          "reflectToAttr": false,
+          "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"
+            }
+          ],
+          "optional": false,
+          "required": false
+        },
+        {
+          "name": "prefixText",
+          "type": "string",
+          "mutable": false,
+          "attr": "prefix-text",
+          "reflectToAttr": false,
+          "docs": "Adds text to the start of the component.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": true,
+          "required": false
+        },
+        {
+          "name": "readOnly",
+          "type": "boolean",
+          "mutable": false,
+          "attr": "read-only",
+          "reflectToAttr": false,
+          "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": [
+            {
+              "type": "boolean"
+            }
+          ],
+          "optional": false,
+          "required": false
+        },
+        {
+          "name": "required",
+          "type": "boolean",
+          "mutable": false,
+          "attr": "required",
+          "reflectToAttr": false,
+          "docs": "When true, the component must have a value in order for the form to submit.",
+          "docsTags": [],
+          "default": "false",
+          "values": [
+            {
+              "type": "boolean"
+            }
+          ],
+          "optional": false,
+          "required": false
+        },
+        {
+          "name": "scale",
+          "type": "\"l\" | \"m\" | \"s\"",
+          "mutable": true,
+          "attr": "scale",
+          "reflectToAttr": true,
+          "docs": "Specifies the size of the component.",
+          "docsTags": [],
+          "default": "\"m\"",
+          "values": [
+            {
+              "value": "l",
+              "type": "string"
+            },
+            {
+              "value": "m",
+              "type": "string"
+            },
+            {
+              "value": "s",
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false
+        },
+        {
+          "name": "status",
+          "type": "\"idle\" | \"invalid\" | \"valid\"",
+          "mutable": true,
+          "attr": "status",
+          "reflectToAttr": true,
+          "docs": "Specifies the status of the input field, which determines message and icons.",
+          "docsTags": [],
+          "default": "\"idle\"",
+          "values": [
+            {
+              "value": "idle",
+              "type": "string"
+            },
+            {
+              "value": "invalid",
+              "type": "string"
+            },
+            {
+              "value": "valid",
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false
+        },
+        {
+          "name": "suffixText",
+          "type": "string",
+          "mutable": false,
+          "attr": "suffix-text",
+          "reflectToAttr": false,
+          "docs": "Adds text to the end of the component.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": true,
+          "required": false
+        },
+        {
+          "name": "value",
+          "type": "string",
+          "mutable": true,
+          "attr": "value",
+          "reflectToAttr": false,
+          "docs": "The component's value.",
+          "docsTags": [],
+          "default": "\"\"",
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false
+        }
+      ],
+      "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": {
+            "type": "Promise<void>",
+            "docs": ""
+          },
+          "signature": "setFocus() => Promise<void>",
+          "parameters": [],
+          "docs": "Sets focus on the component.",
+          "docsTags": []
+        }
+      ],
+      "events": [
+        {
+          "event": "calciteInputTextChange",
+          "detail": "void",
+          "bubbles": true,
+          "cancelable": true,
+          "composed": true,
+          "docs": "Fires each time a new value is typed and committed.",
+          "docsTags": []
+        },
+        {
+          "event": "calciteInputTextInput",
+          "detail": "{ element: HTMLInputElement; nativeEvent: MouseEvent | KeyboardEvent | InputEvent; value: string; }",
+          "bubbles": true,
+          "cancelable": true,
+          "composed": true,
+          "docs": "Fires each time a new value is typed.",
+          "docsTags": []
+        }
+      ],
+      "listeners": [],
+      "styles": [],
+      "slots": [
+        {
+          "name": "action",
+          "docs": "A slot for positioning a button next to the component."
+        }
+      ],
+      "parts": [],
+      "dependents": [],
+      "dependencies": [
+        "calcite-progress",
+        "calcite-icon"
+      ],
+      "dependencyGraph": {
+        "calcite-input-text": [
+          "calcite-progress",
+          "calcite-icon"
+        ]
+      }
+    },
+    {
+      "filePath": "./src/components/input-time-picker/input-time-picker.tsx",
+      "encapsulation": "shadow",
+      "tag": "calcite-input-time-picker",
+      "readme": "# calcite-input-time-picker\n",
+      "docs": "",
+      "docsTags": [],
+      "usage": {
+        "Basic": "```html\n<calcite-input-time-picker\n  hour-display-format=\"12\"\n  name=\"light\"\n  scale=\"m\"\n  step=\"1\"\n  value=\"12:21\"\n></calcite-input-time-picker>\n```\n"
+      },
+      "props": [
+        {
+          "name": "active",
+          "type": "boolean",
+          "mutable": true,
+          "attr": "active",
+          "reflectToAttr": true,
+          "docs": "The active state of the time input",
+          "docsTags": [],
+          "default": "false",
+          "values": [
+            {
+              "type": "boolean"
+            }
+          ],
+          "optional": false,
+          "required": false
+        },
+        {
+          "name": "disabled",
+          "type": "boolean",
+          "mutable": false,
+          "attr": "disabled",
+          "reflectToAttr": true,
+          "docs": "The disabled state of the time input",
+          "docsTags": [],
+          "default": "false",
+          "values": [
+            {
+              "type": "boolean"
+            }
+          ],
+          "optional": false,
+          "required": false
+        },
+        {
+          "name": "intlHour",
+          "type": "string",
+          "mutable": false,
+          "attr": "intl-hour",
+          "reflectToAttr": false,
+          "docs": "aria-label for the hour input",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": true,
+          "required": false
+        },
+        {
+          "name": "intlHourDown",
+          "type": "string",
+          "mutable": false,
+          "attr": "intl-hour-down",
+          "reflectToAttr": false,
+          "docs": "aria-label for the hour down button",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": true,
+          "required": false
+        },
+        {
+          "name": "intlHourUp",
+          "type": "string",
+          "mutable": false,
+          "attr": "intl-hour-up",
+          "reflectToAttr": false,
+          "docs": "aria-label for the hour up button",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": true,
+          "required": false
+        },
+        {
+          "name": "intlMeridiem",
+          "type": "string",
+          "mutable": false,
+          "attr": "intl-meridiem",
+          "reflectToAttr": false,
+          "docs": "aria-label for the meridiem (am/pm) input",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": true,
+          "required": false
+        },
+        {
+          "name": "intlMeridiemDown",
+          "type": "string",
+          "mutable": false,
+          "attr": "intl-meridiem-down",
+          "reflectToAttr": false,
+          "docs": "aria-label for the meridiem (am/pm) down button",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": true,
+          "required": false
+        },
+        {
+          "name": "intlMeridiemUp",
+          "type": "string",
+          "mutable": false,
+          "attr": "intl-meridiem-up",
+          "reflectToAttr": false,
+          "docs": "aria-label for the meridiem (am/pm) up button",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": true,
+          "required": false
+        },
+        {
+          "name": "intlMinute",
+          "type": "string",
+          "mutable": false,
+          "attr": "intl-minute",
+          "reflectToAttr": false,
+          "docs": "aria-label for the minute input",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": true,
+          "required": false
+        },
+        {
+          "name": "intlMinuteDown",
+          "type": "string",
+          "mutable": false,
+          "attr": "intl-minute-down",
+          "reflectToAttr": false,
+          "docs": "aria-label for the minute down button",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": true,
+          "required": false
+        },
+        {
+          "name": "intlMinuteUp",
+          "type": "string",
+          "mutable": false,
+          "attr": "intl-minute-up",
+          "reflectToAttr": false,
+          "docs": "aria-label for the minute up button",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": true,
+          "required": false
+        },
+        {
+          "name": "intlSecond",
+          "type": "string",
+          "mutable": false,
+          "attr": "intl-second",
+          "reflectToAttr": false,
+          "docs": "aria-label for the second input",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": true,
+          "required": false
+        },
+        {
+          "name": "intlSecondDown",
+          "type": "string",
+          "mutable": false,
+          "attr": "intl-second-down",
+          "reflectToAttr": false,
+          "docs": "aria-label for the second down button",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": true,
+          "required": false
+        },
+        {
+          "name": "intlSecondUp",
+          "type": "string",
+          "mutable": false,
+          "attr": "intl-second-up",
+          "reflectToAttr": false,
+          "docs": "aria-label for the second up button",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
             }
           ],
           "optional": true,
@@ -15538,7 +16081,8 @@
       "parts": [],
       "dependents": [
         "calcite-input",
-        "calcite-input-number"
+        "calcite-input-number",
+        "calcite-input-text"
       ],
       "dependencies": [],
       "dependencyGraph": {
@@ -15547,6 +16091,9 @@
         ],
         "calcite-input-number": [
           "calcite-progress"
+        ],
+        "calcite-input-text": [
+          "calcite-progress"
         ]
       }
     },