@nasa-terra/components 0.0.62 → 0.0.64

package/cdn/utilities/date.js

@@ -3,8 +3,7 @@ import {
   getUTCDate,
   isDateRangeContained,
   isValidDate
-} from "../chunks/chunk.TZ27CWAV.js";
-import "../chunks/chunk.GL52MTKN.js";
+} from "../chunks/chunk.VYOUAAH7.js";
 import "../chunks/chunk.ES5U5CWG.js";
 export {
   formatDate,

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

@@ -25,6 +25,50 @@
         }
       ]
     },
+    {
+      "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.",
+      "attributes": [
+        {
+          "name": "open",
+          "description": "Indicates whether or not the alert is open. You can toggle this attribute to show and hide the alert, or you can\nuse the `show()` and `hide()` methods and this attribute will reflect the alert's open state.",
+          "values": []
+        },
+        {
+          "name": "closable",
+          "description": "Enables a close button that allows the user to dismiss the alert.",
+          "values": []
+        },
+        {
+          "name": "variant",
+          "description": "The alert's theme variant.",
+          "values": [
+            { "name": "" },
+            { "name": "primary" },
+            { "name": "success" },
+            { "name": "neutral" },
+            { "name": "warning" },
+            { "name": "danger" }
+          ]
+        },
+        {
+          "name": "duration",
+          "description": "The length of time, in milliseconds, the alert will show before closing itself. If the user interacts with\nthe alert before it closes (e.g. moves the mouse over it), the timer will restart. Defaults to `Infinity`, meaning\nthe alert will not close on its own.",
+          "values": []
+        },
+        {
+          "name": "countdown",
+          "description": "Enables a countdown that indicates the remaining time the alert will be displayed.\nTypically used to indicate the remaining time before a whole app refresh.",
+          "values": [{ "name": "rtl" }, { "name": "ltr" }]
+        }
+      ],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://disc.gsfc.nasa.gov/components/alert"
+        }
+      ]
+    },
     {
       "name": "terra-browse-variables",
       "description": "Browse through the NASA CMR or Giovanni catalogs.\n---\n",
@@ -203,46 +247,49 @@
       ]
     },
     {
-      "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.",
+      "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": "open",
-          "description": "Indicates whether or not the alert is open. You can toggle this attribute to show and hide the alert, or you can\nuse the `show()` and `hide()` methods and this attribute will reflect the alert's open state.",
+          "name": "variable-entry-id",
+          "description": "a variable entry ID (ex: GPM_3IMERGHH_06_precipitationCal)",
           "values": []
         },
         {
-          "name": "closable",
-          "description": "Enables a close button that allows the user to dismiss the alert.",
+          "name": "collection",
+          "description": "a collection entry id (ex: GPM_3IMERGHH_06)\nonly required if you don't include a variableEntryId",
           "values": []
         },
         {
-          "name": "variant",
-          "description": "The alert's theme variant.",
-          "values": [
-            { "name": "" },
-            { "name": "primary" },
-            { "name": "success" },
-            { "name": "neutral" },
-            { "name": "warning" },
-            { "name": "danger" }
-          ]
+          "name": "variable",
+          "description": "a variable short name to plot (ex: precipitationCal)\nonly required if you don't include a variableEntryId",
+          "values": []
         },
         {
-          "name": "duration",
-          "description": "The length of time, in milliseconds, the alert will show before closing itself. If the user interacts with\nthe alert before it closes (e.g. moves the mouse over it), the timer will restart. Defaults to `Infinity`, meaning\nthe alert will not close on its own.",
+          "name": "start-date",
+          "description": "The start date for the time series plot. (ex: 2021-01-01)",
           "values": []
         },
         {
-          "name": "countdown",
-          "description": "Enables a countdown that indicates the remaining time the alert will be displayed.\nTypically used to indicate the remaining time before a whole app refresh.",
-          "values": [{ "name": "rtl" }, { "name": "ltr" }]
+          "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/alert"
+          "url": "https://disc.gsfc.nasa.gov/components/data-rods"
         }
       ]
     },
@@ -299,49 +346,22 @@
       ]
     },
     {
-      "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",
+      "name": "terra-chip",
+      "description": "Used for contacts and tags\n---\n\n\n### **Slots:**\n - _default_ - The chip's label.",
       "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": []
+          "name": "size",
+          "values": [
+            { "name": "small" },
+            { "name": "medium" },
+            { "name": "large" }
+          ]
         }
       ],
       "references": [
         {
           "name": "Documentation",
-          "url": "https://disc.gsfc.nasa.gov/components/data-rods"
+          "url": "https://disc.gsfc.nasa.gov/components/chip"
         }
       ]
     },
@@ -361,6 +381,29 @@
         }
       ]
     },
+    {
+      "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-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",
@@ -419,49 +462,6 @@
         }
       ]
     },
-    {
-      "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-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-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",
@@ -578,30 +578,6 @@
         }
       ]
     },
-    {
-      "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.",
-      "attributes": [
-        { "name": "catalogVariable", "values": [{ "name": "Variable" }] },
-        { "name": "variableEntryId", "values": [] },
-        { "name": "plot", "values": [{ "name": "TerraPlot" }] },
-        {
-          "name": "timeSeriesData",
-          "values": [{ "name": "Partial<Data>[]" }, { "name": "Blob" }]
-        },
-        { "name": "location", "values": [] },
-        { "name": "startDate", "values": [] },
-        { "name": "endDate", "values": [] },
-        { "name": "cacheKey", "values": [] },
-        { "name": "dataType", "values": [{ "name": "DataType" }] }
-      ],
-      "references": [
-        {
-          "name": "Documentation",
-          "url": "https://disc.gsfc.nasa.gov/components/plot-toolbar"
-        }
-      ]
-    },
     {
       "name": "terra-map",
       "description": "A map component for visualizing and selecting coordinates.\n---\n",
@@ -647,6 +623,22 @@
         }
       ]
     },
+    {
+      "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.",
+      "attributes": [
+        { "name": "plotTitle", "values": [] },
+        { "name": "layout", "values": [{ "name": "Partial<Layout>" }] },
+        { "name": "config", "values": [{ "name": "Partial<Config>" }] },
+        { "name": "data", "values": [{ "name": "Array<Partial<Data>>" }] }
+      ],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://disc.gsfc.nasa.gov/components/plot"
+        }
+      ]
+    },
     {
       "name": "terra-skeleton",
       "description": "Skeletons are loading indicators to represent where content will eventually be drawn.\n---\n",
@@ -669,6 +661,30 @@
         }
       ]
     },
+    {
+      "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.",
+      "attributes": [
+        { "name": "catalogVariable", "values": [{ "name": "Variable" }] },
+        { "name": "variableEntryId", "values": [] },
+        { "name": "plot", "values": [{ "name": "TerraPlot" }] },
+        {
+          "name": "timeSeriesData",
+          "values": [{ "name": "Partial<Data>[]" }, { "name": "Blob" }]
+        },
+        { "name": "location", "values": [] },
+        { "name": "startDate", "values": [] },
+        { "name": "endDate", "values": [] },
+        { "name": "cacheKey", "values": [] },
+        { "name": "dataType", "values": [{ "name": "DataType" }] }
+      ],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://disc.gsfc.nasa.gov/components/plot-toolbar"
+        }
+      ]
+    },
     {
       "name": "terra-spatial-picker",
       "description": "A component that allows input of coordinates and rendering of map.\n---\n",
@@ -744,22 +760,6 @@
         }
       ]
     },
-    {
-      "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.",
-      "attributes": [
-        { "name": "plotTitle", "values": [] },
-        { "name": "layout", "values": [{ "name": "Partial<Layout>" }] },
-        { "name": "config", "values": [{ "name": "Partial<Config>" }] },
-        { "name": "data", "values": [{ "name": "Array<Partial<Data>>" }] }
-      ],
-      "references": [
-        {
-          "name": "Documentation",
-          "url": "https://disc.gsfc.nasa.gov/components/plot"
-        }
-      ]
-    },
     {
       "name": "terra-time-average-map",
       "description": "\n---\n",
@@ -792,37 +792,37 @@
       ]
     },
     {
-      "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",
+      "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.",
       "attributes": [
         {
-          "name": "variable-entry-id",
-          "description": "a variable entry ID (ex: GPM_3IMERGHH_06_precipitationCal)",
+          "name": "label",
+          "description": "Label the combobox with this.",
           "values": []
         },
         {
-          "name": "collection",
-          "description": "a collection entry id (ex: GPM_3IMERGHH_06)\nonly required if you don't include a variableEntryId",
+          "name": "placeholder",
+          "description": "Set a placeholder for the combobox with this.\nDefaults to the label's value.",
           "values": []
         },
         {
-          "name": "variable",
-          "description": "a variable short name to plot (ex: precipitationCal)\nonly required if you don't include a variableEntryId",
+          "name": "hide-help",
+          "description": "Hide the combobox's help text.\nWhen hidden, not rendered at all.",
           "values": []
         },
         {
-          "name": "start-date",
-          "description": "The start date for the time series plot. (ex: 2021-01-01)",
+          "name": "hide-label",
+          "description": "Hide the combobox's label text.\nWhen hidden, still presents to screen readers.",
           "values": []
         },
         {
-          "name": "end-date",
-          "description": "The end date for the time series plot. (ex: 2021-01-01)",
+          "name": "use-tags",
+          "description": "Determines if the variable combobox uses tags or plain text to display the query.",
           "values": []
         },
         {
-          "name": "location",
-          "description": "The point location in \"lat,lon\" format.\nOr the bounding box in \"west,south,east,north\" format.",
+          "name": "value",
+          "description": "Represents the EntryID (<collection-name>_<variable-name>) of the selected variable.\nOther components (like the time-series graphing component) will use this.",
           "values": []
         },
         {
@@ -834,42 +834,42 @@
       "references": [
         {
           "name": "Documentation",
-          "url": "https://disc.gsfc.nasa.gov/components/time-series"
+          "url": "https://disc.gsfc.nasa.gov/components/variable-combobox"
         }
       ]
     },
     {
-      "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.",
+      "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",
       "attributes": [
         {
-          "name": "label",
-          "description": "Label the combobox with this.",
+          "name": "variable-entry-id",
+          "description": "a variable entry ID (ex: GPM_3IMERGHH_06_precipitationCal)",
           "values": []
         },
         {
-          "name": "placeholder",
-          "description": "Set a placeholder for the combobox with this.\nDefaults to the label's value.",
+          "name": "collection",
+          "description": "a collection entry id (ex: GPM_3IMERGHH_06)\nonly required if you don't include a variableEntryId",
           "values": []
         },
         {
-          "name": "hide-help",
-          "description": "Hide the combobox's help text.\nWhen hidden, not rendered at all.",
+          "name": "variable",
+          "description": "a variable short name to plot (ex: precipitationCal)\nonly required if you don't include a variableEntryId",
           "values": []
         },
         {
-          "name": "hide-label",
-          "description": "Hide the combobox's label text.\nWhen hidden, still presents to screen readers.",
+          "name": "start-date",
+          "description": "The start date for the time series plot. (ex: 2021-01-01)",
           "values": []
         },
         {
-          "name": "use-tags",
-          "description": "Determines if the variable combobox uses tags or plain text to display the query.",
+          "name": "end-date",
+          "description": "The end date for the time series plot. (ex: 2021-01-01)",
           "values": []
         },
         {
-          "name": "value",
-          "description": "Represents the EntryID (<collection-name>_<variable-name>) of the selected variable.\nOther components (like the time-series graphing component) will use this.",
+          "name": "location",
+          "description": "The point location in \"lat,lon\" format.\nOr the bounding box in \"west,south,east,north\" format.",
           "values": []
         },
         {
@@ -881,7 +881,7 @@
       "references": [
         {
           "name": "Documentation",
-          "url": "https://disc.gsfc.nasa.gov/components/variable-combobox"
+          "url": "https://disc.gsfc.nasa.gov/components/time-series"
         }
       ]
     },