@esri/calcite-components 1.1.1-next.2 → 1.2.0

package/dist/extras/docs-json.json

@@ -1,5 +1,5 @@
 {
-  "timestamp": "2023-03-23T19:22:46",
+  "timestamp": "2023-03-28T04:05:09",
   "compiler": {
     "name": "@stencil/core",
     "version": "2.22.3",
@@ -1095,7 +1095,19 @@
           "required": false
         }
       ],
-      "methods": [],
+      "methods": [
+        {
+          "name": "setFocus",
+          "returns": {
+            "type": "Promise<void>",
+            "docs": ""
+          },
+          "signature": "setFocus() => Promise<void>",
+          "parameters": [],
+          "docs": "Sets focus on the component's first focusable element.",
+          "docsTags": []
+        }
+      ],
       "events": [],
       "listeners": [],
       "styles": [
@@ -2812,6 +2824,22 @@
           "optional": false,
           "required": false
         },
+        {
+          "name": "form",
+          "type": "string",
+          "mutable": false,
+          "attr": "form",
+          "reflectToAttr": true,
+          "docs": "The ID of the form that will be associated with the component.\n\nWhen not set, the component will be associated with its ancestor `<form>` element, if any.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false
+        },
         {
           "name": "href",
           "type": "string",
@@ -3426,6 +3454,22 @@
           "optional": false,
           "required": false
         },
+        {
+          "name": "form",
+          "type": "string",
+          "mutable": false,
+          "attr": "form",
+          "reflectToAttr": true,
+          "docs": "The ID of the form that will be associated with the component.\n\nWhen not set, the component will be associated with its ancestor `<form>` element, if any.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false
+        },
         {
           "name": "guid",
           "type": "string",
@@ -4712,6 +4756,22 @@
           "optional": false,
           "required": false
         },
+        {
+          "name": "form",
+          "type": "string",
+          "mutable": false,
+          "attr": "form",
+          "reflectToAttr": true,
+          "docs": "The ID of the form that will be associated with the component.\n\nWhen not set, the component will be associated with its ancestor `<form>` element, if any.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false
+        },
         {
           "name": "label",
           "type": "string",
@@ -5725,7 +5785,19 @@
           "required": false
         }
       ],
-      "methods": [],
+      "methods": [
+        {
+          "name": "setFocus",
+          "returns": {
+            "type": "Promise<void>",
+            "docs": ""
+          },
+          "signature": "setFocus() => Promise<void>",
+          "parameters": [],
+          "docs": "Sets focus on the component's first focusable element.",
+          "docsTags": []
+        }
+      ],
       "events": [
         {
           "event": "calciteDatePickerChange",
@@ -6640,6 +6712,17 @@
               "text": "delayed"
             }
           ]
+        },
+        {
+          "name": "setFocus",
+          "returns": {
+            "type": "Promise<void>",
+            "docs": ""
+          },
+          "signature": "setFocus() => Promise<void>",
+          "parameters": [],
+          "docs": "Sets focus on the component's first focusable element.",
+          "docsTags": []
         }
       ],
       "events": [
@@ -8746,6 +8829,22 @@
           "optional": false,
           "required": false
         },
+        {
+          "name": "form",
+          "type": "string",
+          "mutable": false,
+          "attr": "form",
+          "reflectToAttr": true,
+          "docs": "The ID of the form that will be associated with the component.\n\nWhen not set, the component will be associated with its ancestor `<form>` element, if any.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false
+        },
         {
           "name": "groupSeparator",
           "type": "boolean",
@@ -9560,6 +9659,22 @@
           "optional": false,
           "required": false
         },
+        {
+          "name": "form",
+          "type": "string",
+          "mutable": false,
+          "attr": "form",
+          "reflectToAttr": true,
+          "docs": "The ID of the form that will be associated with the component.\n\nWhen not set, the component will be associated with its ancestor `<form>` element, if any.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false
+        },
         {
           "name": "headingLevel",
           "type": "1 | 2 | 3 | 4 | 5 | 6",
@@ -10401,6 +10516,22 @@
           "optional": false,
           "required": false
         },
+        {
+          "name": "form",
+          "type": "string",
+          "mutable": false,
+          "attr": "form",
+          "reflectToAttr": true,
+          "docs": "The ID of the form that will be associated with the component.\n\nWhen not set, the component will be associated with its ancestor `<form>` element, if any.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false
+        },
         {
           "name": "groupSeparator",
           "type": "boolean",
@@ -11174,6 +11305,22 @@
           "optional": false,
           "required": false
         },
+        {
+          "name": "form",
+          "type": "string",
+          "mutable": false,
+          "attr": "form",
+          "reflectToAttr": true,
+          "docs": "The ID of the form that will be associated with the component.\n\nWhen not set, the component will be associated with its ancestor `<form>` element, if any.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false
+        },
         {
           "name": "hidden",
           "type": "boolean",
@@ -11646,6 +11793,22 @@
           "optional": false,
           "required": false
         },
+        {
+          "name": "form",
+          "type": "string",
+          "mutable": false,
+          "attr": "form",
+          "reflectToAttr": true,
+          "docs": "The ID of the form that will be associated with the component.\n\nWhen not set, the component will be associated with its ancestor `<form>` element, if any.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false
+        },
         {
           "name": "messagesOverrides",
           "type": "{ hour?: string; hourDown?: string; hourUp?: string; meridiem?: string; meridiemDown?: string; meridiemUp?: string; minute?: string; minuteDown?: string; minuteUp?: string; second?: string; secondDown?: string; secondUp?: string; }",
@@ -14286,6 +14449,17 @@
           "parameters": [],
           "docs": "Go to the previous page of results.",
           "docsTags": []
+        },
+        {
+          "name": "setFocus",
+          "returns": {
+            "type": "Promise<void>",
+            "docs": ""
+          },
+          "signature": "setFocus() => Promise<void>",
+          "parameters": [],
+          "docs": "Sets focus on the component's first focusable element.",
+          "docsTags": []
         }
       ],
       "events": [
@@ -16102,6 +16276,22 @@
           "optional": false,
           "required": false
         },
+        {
+          "name": "form",
+          "type": "string",
+          "mutable": false,
+          "attr": "form",
+          "reflectToAttr": true,
+          "docs": "The ID of the form that will be associated with the component.\n\nWhen not set, the component will be associated with its ancestor `<form>` element, if any.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false
+        },
         {
           "name": "guid",
           "type": "string",
@@ -16503,6 +16693,22 @@
           "optional": false,
           "required": false
         },
+        {
+          "name": "form",
+          "type": "string",
+          "mutable": false,
+          "attr": "form",
+          "reflectToAttr": true,
+          "docs": "The ID of the form that will be associated with the component.\n\nWhen not set, the component will be associated with its ancestor `<form>` element, if any.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false
+        },
         {
           "name": "messageOverrides",
           "type": "{ rating?: string; stars?: string; }",
@@ -16822,6 +17028,22 @@
           "optional": false,
           "required": false
         },
+        {
+          "name": "form",
+          "type": "string",
+          "mutable": false,
+          "attr": "form",
+          "reflectToAttr": true,
+          "docs": "The ID of the form that will be associated with the component.\n\nWhen not set, the component will be associated with its ancestor `<form>` element, if any.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false
+        },
         {
           "name": "layout",
           "type": "\"grid\" | \"horizontal\" | \"vertical\"",
@@ -17143,6 +17365,22 @@
           "optional": false,
           "required": false
         },
+        {
+          "name": "form",
+          "type": "string",
+          "mutable": false,
+          "attr": "form",
+          "reflectToAttr": true,
+          "docs": "The ID of the form that will be associated with the component.\n\nWhen not set, the component will be associated with its ancestor `<form>` element, if any.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false
+        },
         {
           "name": "label",
           "type": "string",
@@ -17779,6 +18017,22 @@
           "optional": false,
           "required": false
         },
+        {
+          "name": "form",
+          "type": "string",
+          "mutable": false,
+          "attr": "form",
+          "reflectToAttr": true,
+          "docs": "The ID of the form that will be associated with the component.\n\nWhen not set, the component will be associated with its ancestor `<form>` element, if any.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false
+        },
         {
           "name": "groupSeparator",
           "type": "boolean",
@@ -18794,7 +19048,19 @@
           "required": false
         }
       ],
-      "methods": [],
+      "methods": [
+        {
+          "name": "setFocus",
+          "returns": {
+            "type": "Promise<void>",
+            "docs": ""
+          },
+          "signature": "setFocus() => Promise<void>",
+          "parameters": [],
+          "docs": "Sets focus on the component's first focusable element.",
+          "docsTags": []
+        }
+      ],
       "events": [
         {
           "event": "calciteSplitButtonPrimaryClick",
@@ -19384,6 +19650,22 @@
           "optional": false,
           "required": false
         },
+        {
+          "name": "form",
+          "type": "string",
+          "mutable": false,
+          "attr": "form",
+          "reflectToAttr": true,
+          "docs": "The ID of the form that will be associated with the component.\n\nWhen not set, the component will be associated with its ancestor `<form>` element, if any.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false
+        },
         {
           "name": "label",
           "type": "string",
@@ -20078,6 +20360,557 @@
         ]
       }
     },
+    {
+      "filePath": "./src/components/text-area/text-area.tsx",
+      "encapsulation": "shadow",
+      "tag": "calcite-text-area",
+      "readme": "# calcite-text-area\n",
+      "docs": "",
+      "docsTags": [
+        {
+          "name": "slot",
+          "text": "- A slot for adding text."
+        },
+        {
+          "name": "slot",
+          "text": "footer-start - A slot for adding content to the start of the component's footer."
+        },
+        {
+          "name": "slot",
+          "text": "footer-end - A slot for adding content to the end of the component's footer."
+        }
+      ],
+      "usage": {
+        "Basic": "```html\n<calcite-text-area placeholder=\"Add Notes\"></calcite-text-area>\n```\n",
+        "Exceeding-max-length": "Renders text-area with character limit counter.\n\n```html\n<calcite-text-area placeholder=\"Add Notes\" value=\"Rocky Mountains National Park\" max-length=\"20\"></calcite-text-area>\n```\n"
+      },
+      "props": [
+        {
+          "name": "autofocus",
+          "type": "boolean",
+          "mutable": false,
+          "attr": "autofocus",
+          "reflectToAttr": true,
+          "docs": "When `true`, the component is focused on page load. Only one element can contain `autofocus`. If multiple elements have `autofocus`, the first element will receive focus.",
+          "docsTags": [
+            {
+              "name": "mdn",
+              "text": "[autofocus](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/autofocus)"
+            }
+          ],
+          "default": "false",
+          "values": [
+            {
+              "type": "boolean"
+            }
+          ],
+          "optional": false,
+          "required": false
+        },
+        {
+          "name": "columns",
+          "type": "number",
+          "mutable": false,
+          "attr": "columns",
+          "reflectToAttr": true,
+          "docs": "Specifies the component's number of columns.",
+          "docsTags": [
+            {
+              "name": "mdn",
+              "text": "[cols](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/textarea#attr-cols)"
+            }
+          ],
+          "values": [
+            {
+              "type": "number"
+            }
+          ],
+          "optional": false,
+          "required": false
+        },
+        {
+          "name": "disabled",
+          "type": "boolean",
+          "mutable": false,
+          "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": "boolean"
+            }
+          ],
+          "optional": false,
+          "required": false
+        },
+        {
+          "name": "form",
+          "type": "string",
+          "mutable": false,
+          "attr": "form",
+          "reflectToAttr": true,
+          "docs": "The ID of the form that will be associated with the component.\n\nWhen not set, the component will be associated with its ancestor `<form>` element, if any.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false
+        },
+        {
+          "name": "groupSeparator",
+          "type": "boolean",
+          "mutable": false,
+          "attr": "group-separator",
+          "reflectToAttr": true,
+          "docs": "When `true`, number values are displayed with a group separator corresponding to the language and country format.",
+          "docsTags": [],
+          "default": "false",
+          "values": [
+            {
+              "type": "boolean"
+            }
+          ],
+          "optional": false,
+          "required": false
+        },
+        {
+          "name": "label",
+          "type": "string",
+          "mutable": false,
+          "attr": "label",
+          "reflectToAttr": false,
+          "docs": "Accessible name for the component.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false
+        },
+        {
+          "name": "maxLength",
+          "type": "number",
+          "mutable": false,
+          "attr": "max-length",
+          "reflectToAttr": true,
+          "docs": "Specifies the maximum number of characters allowed.",
+          "docsTags": [
+            {
+              "name": "mdn",
+              "text": "[maxlength](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/textarea#attr-maxlength)"
+            }
+          ],
+          "values": [
+            {
+              "type": "number"
+            }
+          ],
+          "optional": false,
+          "required": false
+        },
+        {
+          "name": "messageOverrides",
+          "type": "{ invalid?: string; tooLong?: string; }",
+          "mutable": true,
+          "reflectToAttr": false,
+          "docs": "Use this property to override individual strings used by the component.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "{ invalid?: string; tooLong?: string; }"
+            }
+          ],
+          "optional": false,
+          "required": false
+        },
+        {
+          "name": "name",
+          "type": "string",
+          "mutable": false,
+          "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/textarea#attr-name)"
+            }
+          ],
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false
+        },
+        {
+          "name": "numberingSystem",
+          "type": "\"arab\" | \"arabext\" | \"bali\" | \"beng\" | \"deva\" | \"fullwide\" | \"gujr\" | \"guru\" | \"hanidec\" | \"khmr\" | \"knda\" | \"laoo\" | \"latn\" | \"limb\" | \"mlym\" | \"mong\" | \"mymr\" | \"orya\" | \"tamldec\" | \"telu\" | \"thai\" | \"tibt\"",
+          "mutable": false,
+          "attr": "numbering-system",
+          "reflectToAttr": false,
+          "docs": "Specifies the Unicode numeral system used by the component for localization.",
+          "docsTags": [],
+          "values": [
+            {
+              "value": "arab",
+              "type": "string"
+            },
+            {
+              "value": "arabext",
+              "type": "string"
+            },
+            {
+              "value": "bali",
+              "type": "string"
+            },
+            {
+              "value": "beng",
+              "type": "string"
+            },
+            {
+              "value": "deva",
+              "type": "string"
+            },
+            {
+              "value": "fullwide",
+              "type": "string"
+            },
+            {
+              "value": "gujr",
+              "type": "string"
+            },
+            {
+              "value": "guru",
+              "type": "string"
+            },
+            {
+              "value": "hanidec",
+              "type": "string"
+            },
+            {
+              "value": "khmr",
+              "type": "string"
+            },
+            {
+              "value": "knda",
+              "type": "string"
+            },
+            {
+              "value": "laoo",
+              "type": "string"
+            },
+            {
+              "value": "latn",
+              "type": "string"
+            },
+            {
+              "value": "limb",
+              "type": "string"
+            },
+            {
+              "value": "mlym",
+              "type": "string"
+            },
+            {
+              "value": "mong",
+              "type": "string"
+            },
+            {
+              "value": "mymr",
+              "type": "string"
+            },
+            {
+              "value": "orya",
+              "type": "string"
+            },
+            {
+              "value": "tamldec",
+              "type": "string"
+            },
+            {
+              "value": "telu",
+              "type": "string"
+            },
+            {
+              "value": "thai",
+              "type": "string"
+            },
+            {
+              "value": "tibt",
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false
+        },
+        {
+          "name": "placeholder",
+          "type": "string",
+          "mutable": false,
+          "attr": "placeholder",
+          "reflectToAttr": false,
+          "docs": "Specifies the placeholder text for the component.",
+          "docsTags": [
+            {
+              "name": "mdn",
+              "text": "[placeholder](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/textarea#attr-placeholder)"
+            }
+          ],
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false
+        },
+        {
+          "name": "readOnly",
+          "type": "boolean",
+          "mutable": false,
+          "attr": "read-only",
+          "reflectToAttr": true,
+          "docs": "When `true`, the component's `value` can be read, but cannot be modified.",
+          "docsTags": [
+            {
+              "name": "readonly"
+            },
+            {
+              "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": true,
+          "docs": "When `true`, the component must have a value in order for the form to submit.",
+          "docsTags": [
+            {
+              "name": "mdn",
+              "text": "[required]https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/required"
+            }
+          ],
+          "default": "false",
+          "values": [
+            {
+              "type": "boolean"
+            }
+          ],
+          "optional": false,
+          "required": false
+        },
+        {
+          "name": "resize",
+          "type": "\"both\" | \"horizontal\" | \"none\" | \"vertical\"",
+          "mutable": false,
+          "attr": "resize",
+          "reflectToAttr": true,
+          "docs": "Specifies if the component is resizable.",
+          "docsTags": [],
+          "default": "\"both\"",
+          "values": [
+            {
+              "value": "both",
+              "type": "string"
+            },
+            {
+              "value": "horizontal",
+              "type": "string"
+            },
+            {
+              "value": "none",
+              "type": "string"
+            },
+            {
+              "value": "vertical",
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false
+        },
+        {
+          "name": "rows",
+          "type": "number",
+          "mutable": false,
+          "attr": "rows",
+          "reflectToAttr": true,
+          "docs": "Specifies the component's number of rows.",
+          "docsTags": [
+            {
+              "name": "mdn",
+              "text": "[rows](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/textarea#attr-rows)"
+            }
+          ],
+          "values": [
+            {
+              "type": "number"
+            }
+          ],
+          "optional": false,
+          "required": false
+        },
+        {
+          "name": "scale",
+          "type": "\"l\" | \"m\" | \"s\"",
+          "mutable": false,
+          "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": "value",
+          "type": "string",
+          "mutable": true,
+          "attr": "value",
+          "reflectToAttr": false,
+          "docs": "The component's value.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false
+        },
+        {
+          "name": "wrap",
+          "type": "\"hard\" | \"soft\"",
+          "mutable": false,
+          "attr": "wrap",
+          "reflectToAttr": true,
+          "docs": "Specifies the wrapping mechanism for the text.",
+          "docsTags": [
+            {
+              "name": "mdn",
+              "text": "[wrap](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/textarea#attr-wrap)"
+            }
+          ],
+          "default": "\"soft\"",
+          "values": [
+            {
+              "value": "hard",
+              "type": "string"
+            },
+            {
+              "value": "soft",
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false
+        }
+      ],
+      "methods": [
+        {
+          "name": "selectText",
+          "returns": {
+            "type": "Promise<void>",
+            "docs": ""
+          },
+          "signature": "selectText() => Promise<void>",
+          "parameters": [],
+          "docs": "Selects the 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": "calciteTextAreaChange",
+          "detail": "void",
+          "bubbles": true,
+          "cancelable": true,
+          "composed": true,
+          "docs": "Fires each time a new `value` is typed and committed.",
+          "docsTags": []
+        },
+        {
+          "event": "calciteTextAreaInput",
+          "detail": "void",
+          "bubbles": true,
+          "cancelable": true,
+          "composed": true,
+          "docs": "Fires each time a new `value` is typed.",
+          "docsTags": []
+        }
+      ],
+      "listeners": [],
+      "styles": [],
+      "slots": [
+        {
+          "name": "",
+          "docs": "A slot for adding text."
+        },
+        {
+          "name": "footer-end",
+          "docs": "A slot for adding content to the end of the component's footer."
+        },
+        {
+          "name": "footer-start",
+          "docs": "A slot for adding content to the start of the component's footer."
+        }
+      ],
+      "parts": [],
+      "dependents": [],
+      "dependencies": [],
+      "dependencyGraph": {}
+    },
     {
       "filePath": "./src/components/tile/tile.tsx",
       "encapsulation": "shadow",