@nasa-terra/components 0.0.91 → 0.0.93

package/cdn/vscode.html-custom-data.json

@@ -2,166 +2,6 @@
   "$schema": "https://raw.githubusercontent.com/microsoft/vscode-html-languageservice/main/docs/customData.schema.json",
   "version": 1.1,
   "tags": [
-    {
-      "name": "terra-button",
-      "description": "Buttons represent actions that are available to the user.\n---\n\n\n### **Methods:**\n - **click()** - Simulates a click on the button.\n- **focus(options: _FocusOptions_)** - Sets focus on the button.\n- **blur()** - Removes focus from the button.\n- **checkValidity()** - Checks for validity but does not show a validation message. Returns `true` when valid and `false` when invalid.\n- **getForm(): _HTMLFormElement | null_** - Gets the associated form, if one exists.\n- **reportValidity()** - Checks for validity and shows the browser's validation message if the control is invalid.\n- **setCustomValidity(message: _string_)** - Sets a custom validation message. Pass an empty string to restore validity.\n\n### **Slots:**\n - _default_ - The button's label.\n- **prefix** - A presentational prefix icon or similar element.\n- **suffix** - A presentational suffix icon or similar element.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **prefix** - The container that wraps the prefix.\n- **label** - The button's label.\n- **suffix** - The container that wraps the suffix.\n- **caret** - The button's caret icon, an `<sl-icon>` element.\n- **spinner** - The spinner that shows when the button is in the loading state.",
-      "attributes": [
-        { "name": "title", "values": [] },
-        {
-          "name": "variant",
-          "description": "The button's theme variant.",
-          "values": [
-            { "name": "" },
-            { "name": "default" },
-            { "name": "primary" },
-            { "name": "success" },
-            { "name": "warning" },
-            { "name": "danger" },
-            { "name": "text" },
-            { "name": "pagelink" }
-          ]
-        },
-        {
-          "name": "size",
-          "description": "The button's size.",
-          "values": [
-            { "name": "small" },
-            { "name": "medium" },
-            { "name": "large" }
-          ]
-        },
-        {
-          "name": "caret",
-          "description": "Draws the button with a caret. Used to indicate that the button triggers a dropdown menu or similar behavior.",
-          "values": []
-        },
-        {
-          "name": "shape",
-          "description": "The button's shape. Used to control the radius edge shape when button is not in a terra-button-group.",
-          "values": [
-            { "name": "square" },
-            { "name": "square-left" },
-            { "name": "square-right" }
-          ]
-        },
-        {
-          "name": "disabled",
-          "description": "Disables the button.",
-          "values": []
-        },
-        {
-          "name": "loading",
-          "description": "Draws the button in a loading state.",
-          "values": []
-        },
-        {
-          "name": "outline",
-          "description": "Draws an outlined button.",
-          "values": []
-        },
-        {
-          "name": "circle",
-          "description": "Draws a circular icon button. When this attribute is present, the button expects a single `<terra-icon>` in the\ndefault slot.",
-          "values": []
-        },
-        {
-          "name": "type",
-          "description": "The type of button. Note that the default value is `button` instead of `submit`, which is opposite of how native\n`<button>` elements behave. When the type is `submit`, the button will submit the surrounding form.",
-          "values": [
-            { "name": "button" },
-            { "name": "submit" },
-            { "name": "reset" }
-          ]
-        },
-        {
-          "name": "name",
-          "description": "The name of the button, submitted as a name/value pair with form data, but only when this button is the submitter.\nThis attribute is ignored when `href` is present.",
-          "values": []
-        },
-        {
-          "name": "value",
-          "description": "The value of the button, submitted as a pair with the button's name as part of the form data, but only when this\nbutton is the submitter. This attribute is ignored when `href` is present.",
-          "values": []
-        },
-        {
-          "name": "href",
-          "description": "When set, the underlying button will be rendered as an `<a>` with this `href` instead of a `<button>`.",
-          "values": []
-        },
-        {
-          "name": "target",
-          "description": "Tells the browser where to open the link. Only used when `href` is present.",
-          "values": [
-            { "name": "_blank" },
-            { "name": "_parent" },
-            { "name": "_self" },
-            { "name": "_top" }
-          ]
-        },
-        {
-          "name": "rel",
-          "description": "When using `href`, this attribute will map to the underlying link's `rel` attribute. Unlike regular links, the\ndefault is `noreferrer noopener` to prevent security exploits. However, if you're using `target` to point to a\nspecific tab/window, this will prevent that from working correctly. You can remove or change the default value by\nsetting the attribute to an empty string or a value of your choice, respectively.",
-          "values": []
-        },
-        {
-          "name": "download",
-          "description": "Tells the browser to download the linked file as this filename. Only used when `href` is present.",
-          "values": []
-        },
-        {
-          "name": "form",
-          "description": "The \"form owner\" to associate the button with. If omitted, the closest containing form will be used instead. The\nvalue of this attribute must be an id of a form in the same document or shadow root as the button.",
-          "values": []
-        },
-        {
-          "name": "formaction",
-          "description": "Used to override the form owner's `action` attribute.",
-          "values": []
-        },
-        {
-          "name": "formenctype",
-          "description": "Used to override the form owner's `enctype` attribute.",
-          "values": [
-            { "name": "" },
-            { "name": "application/x-www-form-urlencoded" },
-            { "name": "multipart/form-data" },
-            { "name": "text/plain" }
-          ]
-        },
-        {
-          "name": "formmethod",
-          "description": "Used to override the form owner's `method` attribute.",
-          "values": [{ "name": "post" }, { "name": "get" }]
-        },
-        {
-          "name": "formnovalidate",
-          "description": "Used to override the form owner's `novalidate` attribute.",
-          "values": []
-        },
-        {
-          "name": "formtarget",
-          "description": "Used to override the form owner's `target` attribute.",
-          "values": [
-            { "name": "" },
-            { "name": "_self" },
-            { "name": "_blank" },
-            { "name": "_parent" },
-            { "name": "_top" }
-          ]
-        },
-        {
-          "name": "for-dialog",
-          "description": "Used to connect this button to a dqialog on the page. Clicking the button will toggle the dialog's visiblity",
-          "values": []
-        }
-      ],
-      "references": [
-        {
-          "name": "Documentation",
-          "url": "https://disc.gsfc.nasa.gov/components/button"
-        }
-      ]
-    },
     {
       "name": "terra-accordion",
       "description": "A collapsible content panel for showing and hiding content.\n---\n\n\n### **Events:**\n - **terra-accordion-toggle** - emitted when the accordion opens or closes\n\n### **Slots:**\n - _default_ - The default slot for accordion content.\n- **summary** - The summary/header for the accordion (optional, overrides summary property)",
@@ -185,26 +25,6 @@
         }
       ]
     },
-    {
-      "name": "terra-chip",
-      "description": "Used for contacts and tags\n---\n\n\n### **Slots:**\n - _default_ - The chip's label.",
-      "attributes": [
-        {
-          "name": "size",
-          "values": [
-            { "name": "small" },
-            { "name": "medium" },
-            { "name": "large" }
-          ]
-        }
-      ],
-      "references": [
-        {
-          "name": "Documentation",
-          "url": "https://disc.gsfc.nasa.gov/components/chip"
-        }
-      ]
-    },
     {
       "name": "terra-alert",
       "description": "Alerts are used to display important messages inline or as toast notifications.\n---\n\n\n### **Events:**\n - **terra-show** - Emitted when the alert opens.\n- **terra-after-show** - Emitted after the alert opens and all animations are complete.\n- **terra-hide** - Emitted when the alert closes.\n- **terra-after-hide** - Emitted after the alert closes and all animations are complete.\n\n### **Methods:**\n - **show()** - Shows the alert.\n- **hide()** - Hides the alert\n- **toast()** - Displays the alert as a toast notification. This will move the alert out of its position in the DOM and, when\ndismissed, it will be removed from the DOM completely. By storing a reference to the alert, you can reuse it by\ncalling this method again. The returned promise will resolve after the alert is hidden.\n\n### **Slots:**\n - _default_ - The alert's main content.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **icon** - The container that wraps the optional icon.\n- **message** - The container that wraps the alert's main content.",
@@ -249,6 +69,26 @@
         }
       ]
     },
+    {
+      "name": "terra-chip",
+      "description": "Used for contacts and tags\n---\n\n\n### **Slots:**\n - _default_ - The chip's label.",
+      "attributes": [
+        {
+          "name": "size",
+          "values": [
+            { "name": "small" },
+            { "name": "medium" },
+            { "name": "large" }
+          ]
+        }
+      ],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://disc.gsfc.nasa.gov/components/chip"
+        }
+      ]
+    },
     {
       "name": "terra-combobox",
       "description": "Fuzzy-search for combobox with list autocomplete.\n---\n\n\n### **CSS Properties:**\n - **--host-height** - The height of the host element. _(default: undefined)_\n- **--help-height** - The height of the search help element. _(default: undefined)_\n- **--label-height** - The height of the input's label element. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - A `search` element, the component's base.\n- **combobox** - An `input` element used for searching.\n- **button** - A `button` used for toggling the listbox's visibility.\n- **listbox** - A `ul` that holds the clickable options.",
@@ -348,22 +188,6 @@
         }
       ]
     },
-    {
-      "name": "terra-data-subsetter",
-      "description": "Easily allow users to select, subset, and download NASA Earth science data collections with spatial, temporal, and variable filters.\n---\n\n\n### **Events:**\n - **terra-subset-job-complete** - called when a subset job enters a final state (e.g. successful, failed, completed_with_errors)",
-      "attributes": [
-        { "name": "collection-entry-id", "values": [] },
-        { "name": "show-collection-search", "values": [] },
-        { "name": "job-id", "values": [] },
-        { "name": "bearer-token", "values": [] }
-      ],
-      "references": [
-        {
-          "name": "Documentation",
-          "url": "https://disc.gsfc.nasa.gov/components/data-subsetter"
-        }
-      ]
-    },
     {
       "name": "terra-browse-variables",
       "description": "Browse through the NASA CMR or Giovanni catalogs.\n---\n",
@@ -383,44 +207,178 @@
       ]
     },
     {
-      "name": "terra-data-subsetter-history",
-      "description": "Shows a floating panel with a user's recent data subset requests and their status, with quick access to results and re-submission.\n---\n",
+      "name": "terra-button",
+      "description": "Buttons represent actions that are available to the user.\n---\n\n\n### **Methods:**\n - **click()** - Simulates a click on the button.\n- **focus(options: _FocusOptions_)** - Sets focus on the button.\n- **blur()** - Removes focus from the button.\n- **checkValidity()** - Checks for validity but does not show a validation message. Returns `true` when valid and `false` when invalid.\n- **getForm(): _HTMLFormElement | null_** - Gets the associated form, if one exists.\n- **reportValidity()** - Checks for validity and shows the browser's validation message if the control is invalid.\n- **setCustomValidity(message: _string_)** - Sets a custom validation message. Pass an empty string to restore validity.\n\n### **Slots:**\n - _default_ - The button's label.\n- **prefix** - A presentational prefix icon or similar element.\n- **suffix** - A presentational suffix icon or similar element.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **prefix** - The container that wraps the prefix.\n- **label** - The button's label.\n- **suffix** - The container that wraps the suffix.\n- **caret** - The button's caret icon, an `<sl-icon>` element.\n- **spinner** - The spinner that shows when the button is in the loading state.",
       "attributes": [
-        { "name": "label", "values": [] },
-        { "name": "bearer-token", "values": [] },
+        { "name": "title", "values": [] },
         {
-          "name": "always-show",
-          "description": "if a user has never done a subset request, by default they don't see the history panel at all\nthis prop allows you to override that behavior and always show the history panel",
+          "name": "variant",
+          "description": "The button's theme variant.",
+          "values": [
+            { "name": "" },
+            { "name": "default" },
+            { "name": "primary" },
+            { "name": "success" },
+            { "name": "warning" },
+            { "name": "danger" },
+            { "name": "text" },
+            { "name": "pagelink" }
+          ]
+        },
+        {
+          "name": "size",
+          "description": "The button's size.",
+          "values": [
+            { "name": "small" },
+            { "name": "medium" },
+            { "name": "large" }
+          ]
+        },
+        {
+          "name": "caret",
+          "description": "Draws the button with a caret. Used to indicate that the button triggers a dropdown menu or similar behavior.",
+          "values": []
+        },
+        {
+          "name": "shape",
+          "description": "The button's shape. Used to control the radius edge shape when button is not in a terra-button-group.",
+          "values": [
+            { "name": "square" },
+            { "name": "square-left" },
+            { "name": "square-right" }
+          ]
+        },
+        {
+          "name": "disabled",
+          "description": "Disables the button.",
+          "values": []
+        },
+        {
+          "name": "loading",
+          "description": "Draws the button in a loading state.",
+          "values": []
+        },
+        {
+          "name": "outline",
+          "description": "Draws an outlined button.",
+          "values": []
+        },
+        {
+          "name": "circle",
+          "description": "Draws a circular icon button. When this attribute is present, the button expects a single `<terra-icon>` in the\ndefault slot.",
+          "values": []
+        },
+        {
+          "name": "type",
+          "description": "The type of button. Note that the default value is `button` instead of `submit`, which is opposite of how native\n`<button>` elements behave. When the type is `submit`, the button will submit the surrounding form.",
+          "values": [
+            { "name": "button" },
+            { "name": "submit" },
+            { "name": "reset" }
+          ]
+        },
+        {
+          "name": "name",
+          "description": "The name of the button, submitted as a name/value pair with form data, but only when this button is the submitter.\nThis attribute is ignored when `href` is present.",
+          "values": []
+        },
+        {
+          "name": "value",
+          "description": "The value of the button, submitted as a pair with the button's name as part of the form data, but only when this\nbutton is the submitter. This attribute is ignored when `href` is present.",
+          "values": []
+        },
+        {
+          "name": "href",
+          "description": "When set, the underlying button will be rendered as an `<a>` with this `href` instead of a `<button>`.",
+          "values": []
+        },
+        {
+          "name": "target",
+          "description": "Tells the browser where to open the link. Only used when `href` is present.",
+          "values": [
+            { "name": "_blank" },
+            { "name": "_parent" },
+            { "name": "_self" },
+            { "name": "_top" }
+          ]
+        },
+        {
+          "name": "rel",
+          "description": "When using `href`, this attribute will map to the underlying link's `rel` attribute. Unlike regular links, the\ndefault is `noreferrer noopener` to prevent security exploits. However, if you're using `target` to point to a\nspecific tab/window, this will prevent that from working correctly. You can remove or change the default value by\nsetting the attribute to an empty string or a value of your choice, respectively.",
+          "values": []
+        },
+        {
+          "name": "download",
+          "description": "Tells the browser to download the linked file as this filename. Only used when `href` is present.",
+          "values": []
+        },
+        {
+          "name": "form",
+          "description": "The \"form owner\" to associate the button with. If omitted, the closest containing form will be used instead. The\nvalue of this attribute must be an id of a form in the same document or shadow root as the button.",
+          "values": []
+        },
+        {
+          "name": "formaction",
+          "description": "Used to override the form owner's `action` attribute.",
+          "values": []
+        },
+        {
+          "name": "formenctype",
+          "description": "Used to override the form owner's `enctype` attribute.",
+          "values": [
+            { "name": "" },
+            { "name": "application/x-www-form-urlencoded" },
+            { "name": "multipart/form-data" },
+            { "name": "text/plain" }
+          ]
+        },
+        {
+          "name": "formmethod",
+          "description": "Used to override the form owner's `method` attribute.",
+          "values": [{ "name": "post" }, { "name": "get" }]
+        },
+        {
+          "name": "formnovalidate",
+          "description": "Used to override the form owner's `novalidate` attribute.",
+          "values": []
+        },
+        {
+          "name": "formtarget",
+          "description": "Used to override the form owner's `target` attribute.",
+          "values": [
+            { "name": "" },
+            { "name": "_self" },
+            { "name": "_blank" },
+            { "name": "_parent" },
+            { "name": "_top" }
+          ]
+        },
+        {
+          "name": "for-dialog",
+          "description": "Used to connect this button to a dqialog on the page. Clicking the button will toggle the dialog's visiblity",
           "values": []
         }
       ],
       "references": [
         {
           "name": "Documentation",
-          "url": "https://disc.gsfc.nasa.gov/components/data-subsetter-history"
+          "url": "https://disc.gsfc.nasa.gov/components/button"
         }
       ]
     },
     {
-      "name": "terra-date-range-slider",
-      "description": "Short summary of the component's intended use.\n---\n\n\n### **Slots:**\n - _default_ - The default slot.\n- **example** - An example slot.\n\n### **CSS Properties:**\n - **--example** - An example CSS custom property. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
+      "name": "terra-data-subsetter",
+      "description": "Easily allow users to select, subset, and download NASA Earth science data collections with spatial, temporal, and variable filters.\n---\n\n\n### **Events:**\n - **terra-subset-job-complete** - called when a subset job enters a final state (e.g. successful, failed, completed_with_errors)",
       "attributes": [
-        { "name": "time-scale", "values": [{ "name": "TimeScale" }] },
-        { "name": "min-date", "values": [] },
-        { "name": "max-date", "values": [] },
-        {
-          "name": "start-date",
-          "description": "The start date for the time series plot.",
-          "values": []
-        },
-        { "name": "end-date", "values": [] },
-        { "name": "disabled", "values": [] },
-        { "name": "has-pips", "values": [] }
+        { "name": "collection-entry-id", "values": [] },
+        { "name": "show-collection-search", "values": [] },
+        { "name": "job-id", "values": [] },
+        { "name": "bearer-token", "values": [] }
       ],
       "references": [
         {
           "name": "Documentation",
-          "url": "https://disc.gsfc.nasa.gov/components/date-range-slider"
+          "url": "https://disc.gsfc.nasa.gov/components/data-subsetter"
         }
       ]
     },
@@ -463,6 +421,48 @@
         }
       ]
     },
+    {
+      "name": "terra-data-subsetter-history",
+      "description": "Shows a floating panel with a user's recent data subset requests and their status, with quick access to results and re-submission.\n---\n",
+      "attributes": [
+        { "name": "label", "values": [] },
+        { "name": "bearer-token", "values": [] },
+        {
+          "name": "always-show",
+          "description": "if a user has never done a subset request, by default they don't see the history panel at all\nthis prop allows you to override that behavior and always show the history panel",
+          "values": []
+        }
+      ],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://disc.gsfc.nasa.gov/components/data-subsetter-history"
+        }
+      ]
+    },
+    {
+      "name": "terra-date-range-slider",
+      "description": "Short summary of the component's intended use.\n---\n\n\n### **Slots:**\n - _default_ - The default slot.\n- **example** - An example slot.\n\n### **CSS Properties:**\n - **--example** - An example CSS custom property. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
+      "attributes": [
+        { "name": "time-scale", "values": [{ "name": "TimeScale" }] },
+        { "name": "min-date", "values": [] },
+        { "name": "max-date", "values": [] },
+        {
+          "name": "start-date",
+          "description": "The start date for the time series plot.",
+          "values": []
+        },
+        { "name": "end-date", "values": [] },
+        { "name": "disabled", "values": [] },
+        { "name": "has-pips", "values": [] }
+      ],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://disc.gsfc.nasa.gov/components/date-range-slider"
+        }
+      ]
+    },
     {
       "name": "terra-dialog",
       "description": "Used to create both modal and non-modal dialog boxes.\n---\n\n\n### **Events:**\n - **terra-dialog-show** - Emitted when the dialog opens.\n- **terra-dialog-hide** - Emitted when the dialog closes.\n\n### **Slots:**\n - _default_ - The dialog's main content",
@@ -477,6 +477,11 @@
           "description": "the width of the dialog",
           "values": []
         },
+        {
+          "name": "open",
+          "description": "used to set the dialog's open state",
+          "values": []
+        },
         {
           "name": "click-outside-to-close",
           "description": "allow closing the dialog when clicking outside of it",
@@ -641,6 +646,28 @@
         }
       ]
     },
+    {
+      "name": "terra-skeleton",
+      "description": "Skeletons are loading indicators to represent where content will eventually be drawn.\n---\n",
+      "attributes": [
+        { "name": "rows", "values": [] },
+        {
+          "name": "effect",
+          "values": [
+            { "name": "pulse" },
+            { "name": "sheen" },
+            { "name": "none" }
+          ]
+        },
+        { "name": "variableWidths", "values": [] }
+      ],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://disc.gsfc.nasa.gov/components/skeleton"
+        }
+      ]
+    },
     {
       "name": "terra-plot-toolbar",
       "description": "Short summary of the component's intended use.\n---\n\n\n### **Slots:**\n - _default_ - The default slot.\n- **example** - An example slot.\n\n### **CSS Properties:**\n - **--example** - An example CSS custom property. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
@@ -666,28 +693,6 @@
         }
       ]
     },
-    {
-      "name": "terra-skeleton",
-      "description": "Skeletons are loading indicators to represent where content will eventually be drawn.\n---\n",
-      "attributes": [
-        { "name": "rows", "values": [] },
-        {
-          "name": "effect",
-          "values": [
-            { "name": "pulse" },
-            { "name": "sheen" },
-            { "name": "none" }
-          ]
-        },
-        { "name": "variableWidths", "values": [] }
-      ],
-      "references": [
-        {
-          "name": "Documentation",
-          "url": "https://disc.gsfc.nasa.gov/components/skeleton"
-        }
-      ]
-    },
     {
       "name": "terra-spatial-picker",
       "description": "A component that allows input of coordinates and rendering of map.\n---\n",