@nasa-terra/components 0.0.75 → 0.0.76

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

@@ -2,6 +2,29 @@
   "$schema": "https://raw.githubusercontent.com/microsoft/vscode-html-languageservice/main/docs/customData.schema.json",
   "version": 1.1,
   "tags": [
+    {
+      "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)",
+      "attributes": [
+        {
+          "name": "summary",
+          "description": "The summary/header for the accordion. Use the property for simple text, or the slot for custom content.",
+          "values": []
+        },
+        {
+          "name": "open",
+          "description": "Whether the accordion is open or not. This property is reflected as an attribute and can be controlled programmatically or by user interaction.",
+          "values": []
+        },
+        { "name": "showArrow", "values": [] }
+      ],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://disc.gsfc.nasa.gov/components/accordion"
+        }
+      ]
+    },
     {
       "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.",
@@ -46,6 +69,58 @@
         }
       ]
     },
+    {
+      "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.",
+      "attributes": [
+        {
+          "name": "label",
+          "description": "Label the combobox with this.",
+          "values": []
+        },
+        {
+          "name": "name",
+          "description": "name the combobox with this.",
+          "values": []
+        },
+        {
+          "name": "placeholder",
+          "description": "Set a placeholder for the combobox with this.\nDefaults to the label's value.",
+          "values": []
+        },
+        {
+          "name": "hide-help",
+          "description": "Hide the combobox's help text.\nWhen hidden, not rendered at all.",
+          "values": []
+        },
+        {
+          "name": "hide-label",
+          "description": "Hide the combobox's label text.\nWhen hidden, still presents to screen readers.",
+          "values": []
+        },
+        {
+          "name": "status",
+          "description": "status of the content",
+          "values": [
+            { "name": "INITIAL" },
+            { "name": "PENDING" },
+            { "name": "COMPLETE" },
+            { "name": "ERROR" }
+          ]
+        },
+        {
+          "name": "content",
+          "description": "content or data of the combobox. This could be of type string | GroupedListItem[] | ListItem[] | undefined",
+          "values": [{ "name": "Content" }]
+        }
+      ],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://disc.gsfc.nasa.gov/components/combobox"
+        }
+      ]
+    },
     {
       "name": "terra-browse-variables",
       "description": "Browse through the NASA CMR or Giovanni catalogs.\n---\n",
@@ -64,6 +139,53 @@
         }
       ]
     },
+    {
+      "name": "terra-data-rods",
+      "description": "A component for visualizing Hydrology Data Rods time series using the GES DISC Giovanni API\n---\n\n\n### **Events:**\n - **terra-date-range-change** - Emitted whenever the date range of the date slider is updated",
+      "attributes": [
+        {
+          "name": "variable-entry-id",
+          "description": "a variable entry ID (ex: GPM_3IMERGHH_06_precipitationCal)",
+          "values": []
+        },
+        {
+          "name": "collection",
+          "description": "a collection entry id (ex: GPM_3IMERGHH_06)\nonly required if you don't include a variableEntryId",
+          "values": []
+        },
+        {
+          "name": "variable",
+          "description": "a variable short name to plot (ex: precipitationCal)\nonly required if you don't include a variableEntryId",
+          "values": []
+        },
+        {
+          "name": "start-date",
+          "description": "The start date for the time series plot. (ex: 2021-01-01)",
+          "values": []
+        },
+        {
+          "name": "end-date",
+          "description": "The end date for the time series plot. (ex: 2021-01-01)",
+          "values": []
+        },
+        {
+          "name": "location",
+          "description": "The point location in \"lat,lon\" format.",
+          "values": []
+        },
+        {
+          "name": "bearer-token",
+          "description": "The token to be used for authentication with remote servers.\nThe component provides the header \"Authorization: Bearer\" (the request header and authentication scheme).\nThe property's value will be inserted after \"Bearer\" (the authentication scheme).",
+          "values": []
+        }
+      ],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://disc.gsfc.nasa.gov/components/data-rods"
+        }
+      ]
+    },
     {
       "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.",
@@ -224,29 +346,6 @@
         }
       ]
     },
-    {
-      "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)",
-      "attributes": [
-        {
-          "name": "summary",
-          "description": "The summary/header for the accordion. Use the property for simple text, or the slot for custom content.",
-          "values": []
-        },
-        {
-          "name": "open",
-          "description": "Whether the accordion is open or not. This property is reflected as an attribute and can be controlled programmatically or by user interaction.",
-          "values": []
-        },
-        { "name": "showArrow", "values": [] }
-      ],
-      "references": [
-        {
-          "name": "Documentation",
-          "url": "https://disc.gsfc.nasa.gov/components/accordion"
-        }
-      ]
-    },
     {
       "name": "terra-chip",
       "description": "Used for contacts and tags\n---\n\n\n### **Slots:**\n - _default_ - The chip's label.",
@@ -267,140 +366,6 @@
         }
       ]
     },
-    {
-      "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.",
-      "attributes": [
-        {
-          "name": "label",
-          "description": "Label the combobox with this.",
-          "values": []
-        },
-        {
-          "name": "name",
-          "description": "name the combobox with this.",
-          "values": []
-        },
-        {
-          "name": "placeholder",
-          "description": "Set a placeholder for the combobox with this.\nDefaults to the label's value.",
-          "values": []
-        },
-        {
-          "name": "hide-help",
-          "description": "Hide the combobox's help text.\nWhen hidden, not rendered at all.",
-          "values": []
-        },
-        {
-          "name": "hide-label",
-          "description": "Hide the combobox's label text.\nWhen hidden, still presents to screen readers.",
-          "values": []
-        },
-        {
-          "name": "status",
-          "description": "status of the content",
-          "values": [
-            { "name": "INITIAL" },
-            { "name": "PENDING" },
-            { "name": "COMPLETE" },
-            { "name": "ERROR" }
-          ]
-        },
-        {
-          "name": "content",
-          "description": "content or data of the combobox. This could be of type string | GroupedListItem[] | ListItem[] | undefined",
-          "values": [{ "name": "Content" }]
-        }
-      ],
-      "references": [
-        {
-          "name": "Documentation",
-          "url": "https://disc.gsfc.nasa.gov/components/combobox"
-        }
-      ]
-    },
-    {
-      "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-data-rods",
-      "description": "A component for visualizing Hydrology Data Rods time series using the GES DISC Giovanni API\n---\n\n\n### **Events:**\n - **terra-date-range-change** - Emitted whenever the date range of the date slider is updated",
-      "attributes": [
-        {
-          "name": "variable-entry-id",
-          "description": "a variable entry ID (ex: GPM_3IMERGHH_06_precipitationCal)",
-          "values": []
-        },
-        {
-          "name": "collection",
-          "description": "a collection entry id (ex: GPM_3IMERGHH_06)\nonly required if you don't include a variableEntryId",
-          "values": []
-        },
-        {
-          "name": "variable",
-          "description": "a variable short name to plot (ex: precipitationCal)\nonly required if you don't include a variableEntryId",
-          "values": []
-        },
-        {
-          "name": "start-date",
-          "description": "The start date for the time series plot. (ex: 2021-01-01)",
-          "values": []
-        },
-        {
-          "name": "end-date",
-          "description": "The end date for the time series plot. (ex: 2021-01-01)",
-          "values": []
-        },
-        {
-          "name": "location",
-          "description": "The point location in \"lat,lon\" format.",
-          "values": []
-        },
-        {
-          "name": "bearer-token",
-          "description": "The token to be used for authentication with remote servers.\nThe component provides the header \"Authorization: Bearer\" (the request header and authentication scheme).\nThe property's value will be inserted after \"Bearer\" (the authentication scheme).",
-          "values": []
-        }
-      ],
-      "references": [
-        {
-          "name": "Documentation",
-          "url": "https://disc.gsfc.nasa.gov/components/data-rods"
-        }
-      ]
-    },
-    {
-      "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-picker",
       "description": "A date picker component that supports single date selection or date range selection.\n---\n\n\n### **Slots:**\n - _default_ - The default slot.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **input** - The date input element.",
@@ -440,6 +405,25 @@
         }
       ]
     },
+    {
+      "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.",
@@ -463,6 +447,22 @@
         }
       ]
     },
+    {
+      "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-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",
@@ -568,17 +568,6 @@
         }
       ]
     },
-    {
-      "name": "terra-login",
-      "description": "A form that logs in to Earthdata Login (EDL) and returns a bearer token.\n---\n\n\n### **Events:**\n - **terra-login** - Emitted when a bearer token has been received from EDL.",
-      "attributes": [{ "name": "button-label", "values": [] }],
-      "references": [
-        {
-          "name": "Documentation",
-          "url": "https://disc.gsfc.nasa.gov/components/login"
-        }
-      ]
-    },
     {
       "name": "terra-map",
       "description": "A map component for visualizing and selecting coordinates.\n---\n",
@@ -624,6 +613,17 @@
         }
       ]
     },
+    {
+      "name": "terra-login",
+      "description": "A form that logs in to Earthdata Login (EDL) and returns a bearer token.\n---\n\n\n### **Events:**\n - **terra-login** - Emitted when a bearer token has been received from EDL.",
+      "attributes": [{ "name": "button-label", "values": [] }],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://disc.gsfc.nasa.gov/components/login"
+        }
+      ]
+    },
     {
       "name": "terra-plot",
       "description": "A web component for interactive graphs using Plotly.js.\n---\n\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
@@ -761,6 +761,32 @@
         }
       ]
     },
+    {
+      "name": "terra-time-average-map",
+      "description": "\n---\n",
+      "attributes": [
+        {
+          "name": "collection",
+          "description": "a collection entry id (ex: GPM_3IMERGHH_06)",
+          "values": []
+        },
+        { "name": "variable", "values": [] },
+        { "name": "start-date", "values": [] },
+        { "name": "end-date", "values": [] },
+        {
+          "name": "location",
+          "description": "The point location in \"lat,lon\" format.\nOr the bounding box in \"west,south,east,north\" format.",
+          "values": []
+        },
+        { "name": "long_name", "values": [] }
+      ],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://disc.gsfc.nasa.gov/components/time-average-map"
+        }
+      ]
+    },
     {
       "name": "terra-time-series",
       "description": "A component for visualizing time series data using the GES DISC Giovanni API.\n---\n\n\n### **Events:**\n - **terra-date-range-change** - Emitted whenever the date range is modified\n- **terra-time-series-data-change** - Emitted whenever time series data has been fetched from Giovanni",
@@ -808,37 +834,6 @@
         }
       ]
     },
-    {
-      "name": "terra-time-average-map",
-      "description": "\n---\n",
-      "attributes": [
-        {
-          "name": "collection",
-          "description": "a collection entry id (ex: GPM_3IMERGHH_06)",
-          "values": []
-        },
-        { "name": "variable", "values": [] },
-        { "name": "start-date", "values": [] },
-        { "name": "end-date", "values": [] },
-        {
-          "name": "location",
-          "description": "The point location in \"lat,lon\" format.\nOr the bounding box in \"west,south,east,north\" format.",
-          "values": []
-        },
-        {
-          "name": "bearer-token",
-          "description": "The token to be used for authentication with remote servers.\nThe component provides the header \"Authorization: Bearer\" (the request header and authentication scheme).\nThe property's value will be inserted after \"Bearer\" (the authentication scheme).",
-          "values": []
-        },
-        { "name": "long_name", "values": [] }
-      ],
-      "references": [
-        {
-          "name": "Documentation",
-          "url": "https://disc.gsfc.nasa.gov/components/time-average-map"
-        }
-      ]
-    },
     {
       "name": "terra-variable-combobox",
       "description": "Fuzzy-search for dataset variables in combobox with list autocomplete.\n---\n\n\n### **Events:**\n - **terra-combobox-change** - Emitted when an option is selected.\n\n### **Methods:**\n - **valueChanged(oldValue: _string_, newValue: _string_)** - This component's value is read by other components.\nInternally, the variable metdata has slight differences that require adapting.\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.",