@nasa-terra/components 0.0.0 → 0.0.1

package/dist/types/vue/index.d.ts

@@ -1,14 +1,14 @@
 import type { DefineComponent } from "vue";
 
 import type { TerraChip } from "../../components/chip/chip.component.js";
+import type { TerraButton } from "../../components/button/button.component.js";
 import type { TerraCombobox } from "../../components/combobox/combobox.component.js";
 import type { TerraDateRangeSlider } from "../../components/date-range-slider/date-range-slider.component.js";
-import type { TerraButton } from "../../components/button/button.component.js";
 import type { TerraIcon } from "../../components/icon/icon.component.js";
 import type { TerraLoader } from "../../components/loader/loader.component.js";
 import type { TerraMap } from "../../components/map/map.component.js";
-import type { TerraSpatialPicker } from "../../components/spatial-picker/spatial-picker.component.js";
 import type { TerraPlot } from "../../components/plot/plot.component.js";
+import type { TerraSpatialPicker } from "../../components/spatial-picker/spatial-picker.component.js";
 import type { TerraTimeSeries } from "../../components/time-series/time-series.component.js";
 import type { TerraVariableCombobox } from "../../components/variable-combobox/variable-combobox.component.js";
 
@@ -17,51 +17,6 @@ type TerraChipProps = {
   size?: TerraChip["size"];
 };
 
-type TerraComboboxProps = {
-  /** Label the combobox with this. */
-  label?: TerraCombobox["label"];
-  /** name the combobox with this. */
-  name?: TerraCombobox["name"];
-  /** Set a placeholder for the combobox with this.
-Defaults to the label's value. */
-  placeholder?: TerraCombobox["placeholder"];
-  /** Hide the combobox's help text.
-When hidden, not rendered at all. */
-  "hide-help"?: TerraCombobox["hideHelp"];
-  /** Hide the combobox's label text.
-When hidden, still presents to screen readers. */
-  "hide-label"?: TerraCombobox["hideLabel"];
-  /** status of the content */
-  status?: TerraCombobox["status"];
-  /** content or data of the combobox. This could be of type string | GroupedListItem[] | ListItem[] | undefined */
-  content?: TerraCombobox["content"];
-  /**  */
-  isExpanded?: TerraCombobox["isExpanded"];
-  /**  */
-  query?: TerraCombobox["query"];
-  /**  */
-  searchResults?: TerraCombobox["searchResults"];
-};
-
-type TerraDateRangeSliderProps = {
-  /**  */
-  "time-scale"?: TerraDateRangeSlider["timeScale"];
-  /**  */
-  "min-date"?: TerraDateRangeSlider["minDate"];
-  /**  */
-  "max-date"?: TerraDateRangeSlider["maxDate"];
-  /** The start date for the time series plot. */
-  "start-date"?: TerraDateRangeSlider["startDate"];
-  /**  */
-  "end-date"?: TerraDateRangeSlider["endDate"];
-  /**  */
-  disabled?: TerraDateRangeSlider["disabled"];
-  /**  */
-  "has-pips"?: TerraDateRangeSlider["hasPips"];
-  /**  */
-  slider?: TerraDateRangeSlider["slider"];
-};
-
 type TerraButtonProps = {
   /**  */
   title?: TerraButton["title"];
@@ -125,6 +80,51 @@ value of this attribute must be an id of a form in the same document or shadow r
   validationMessage?: TerraButton["validationMessage"];
 };
 
+type TerraComboboxProps = {
+  /** Label the combobox with this. */
+  label?: TerraCombobox["label"];
+  /** name the combobox with this. */
+  name?: TerraCombobox["name"];
+  /** Set a placeholder for the combobox with this.
+Defaults to the label's value. */
+  placeholder?: TerraCombobox["placeholder"];
+  /** Hide the combobox's help text.
+When hidden, not rendered at all. */
+  "hide-help"?: TerraCombobox["hideHelp"];
+  /** Hide the combobox's label text.
+When hidden, still presents to screen readers. */
+  "hide-label"?: TerraCombobox["hideLabel"];
+  /** status of the content */
+  status?: TerraCombobox["status"];
+  /** content or data of the combobox. This could be of type string | GroupedListItem[] | ListItem[] | undefined */
+  content?: TerraCombobox["content"];
+  /**  */
+  isExpanded?: TerraCombobox["isExpanded"];
+  /**  */
+  query?: TerraCombobox["query"];
+  /**  */
+  searchResults?: TerraCombobox["searchResults"];
+};
+
+type TerraDateRangeSliderProps = {
+  /**  */
+  "time-scale"?: TerraDateRangeSlider["timeScale"];
+  /**  */
+  "min-date"?: TerraDateRangeSlider["minDate"];
+  /**  */
+  "max-date"?: TerraDateRangeSlider["maxDate"];
+  /** The start date for the time series plot. */
+  "start-date"?: TerraDateRangeSlider["startDate"];
+  /**  */
+  "end-date"?: TerraDateRangeSlider["endDate"];
+  /**  */
+  disabled?: TerraDateRangeSlider["disabled"];
+  /**  */
+  "has-pips"?: TerraDateRangeSlider["hasPips"];
+  /**  */
+  slider?: TerraDateRangeSlider["slider"];
+};
+
 type TerraIconProps = {
   /** The name of the icon to draw. Available names depend on the icon library being used. */
   name?: TerraIcon["name"];
@@ -186,6 +186,21 @@ type TerraMapProps = {
   _mapController?: TerraMap["_mapController"];
 };
 
+type TerraPlotProps = {
+  /**  */
+  plotTitle?: TerraPlot["plotTitle"];
+  /**  */
+  layout?: TerraPlot["layout"];
+  /**  */
+  config?: TerraPlot["config"];
+  /**  */
+  data?: TerraPlot["data"];
+  /**  */
+  plotData?: TerraPlot["plotData"];
+  /**  */
+  base?: TerraPlot["base"];
+};
+
 type TerraSpatialPickerProps = {
   /** Minimum zoom level of the map. */
   "min-zoom"?: TerraSpatialPicker["minZoom"];
@@ -214,21 +229,6 @@ When hidden, still presents to screen readers. */
   spatialInput?: TerraSpatialPicker["spatialInput"];
 };
 
-type TerraPlotProps = {
-  /**  */
-  plotTitle?: TerraPlot["plotTitle"];
-  /**  */
-  layout?: TerraPlot["layout"];
-  /**  */
-  config?: TerraPlot["config"];
-  /**  */
-  data?: TerraPlot["data"];
-  /**  */
-  plotData?: TerraPlot["plotData"];
-  /**  */
-  base?: TerraPlot["base"];
-};
-
 type TerraTimeSeriesProps = {
   /** a collection entry id (ex: GPM_3IMERGHH_06) */
   collection?: TerraTimeSeries["collection"];
@@ -291,6 +291,35 @@ export type CustomElements = {
    */
   "terra-chip": DefineComponent<TerraChipProps>;
 
+  /**
+   * Buttons represent actions that are available to the user.
+   * ---
+   *
+   *
+   * ### **Methods:**
+   *  - **click()** - Simulates a click on the button.
+   * - **focus(options: _FocusOptions_)** - Sets focus on the button.
+   * - **blur()** - Removes focus from the button.
+   * - **checkValidity()** - Checks for validity but does not show a validation message. Returns `true` when valid and `false` when invalid.
+   * - **getForm(): _HTMLFormElement | null_** - Gets the associated form, if one exists.
+   * - **reportValidity()** - Checks for validity and shows the browser's validation message if the control is invalid.
+   * - **setCustomValidity(message: _string_)** - Sets a custom validation message. Pass an empty string to restore validity.
+   *
+   * ### **Slots:**
+   *  - _default_ - The button's label.
+   * - **prefix** - A presentational prefix icon or similar element.
+   * - **suffix** - A presentational suffix icon or similar element.
+   *
+   * ### **CSS Parts:**
+   *  - **base** - The component's base wrapper.
+   * - **prefix** - The container that wraps the prefix.
+   * - **label** - The button's label.
+   * - **suffix** - The container that wraps the suffix.
+   * - **caret** - The button's caret icon, an `<sl-icon>` element.
+   * - **spinner** - The spinner that shows when the button is in the loading state.
+   */
+  "terra-button": DefineComponent<TerraButtonProps>;
+
   /**
    * Fuzzy-search for combobox with list autocomplete.
    * ---
@@ -326,35 +355,6 @@ export type CustomElements = {
    */
   "terra-date-range-slider": DefineComponent<TerraDateRangeSliderProps>;
 
-  /**
-   * Buttons represent actions that are available to the user.
-   * ---
-   *
-   *
-   * ### **Methods:**
-   *  - **click()** - Simulates a click on the button.
-   * - **focus(options: _FocusOptions_)** - Sets focus on the button.
-   * - **blur()** - Removes focus from the button.
-   * - **checkValidity()** - Checks for validity but does not show a validation message. Returns `true` when valid and `false` when invalid.
-   * - **getForm(): _HTMLFormElement | null_** - Gets the associated form, if one exists.
-   * - **reportValidity()** - Checks for validity and shows the browser's validation message if the control is invalid.
-   * - **setCustomValidity(message: _string_)** - Sets a custom validation message. Pass an empty string to restore validity.
-   *
-   * ### **Slots:**
-   *  - _default_ - The button's label.
-   * - **prefix** - A presentational prefix icon or similar element.
-   * - **suffix** - A presentational suffix icon or similar element.
-   *
-   * ### **CSS Parts:**
-   *  - **base** - The component's base wrapper.
-   * - **prefix** - The container that wraps the prefix.
-   * - **label** - The button's label.
-   * - **suffix** - The container that wraps the suffix.
-   * - **caret** - The button's caret icon, an `<sl-icon>` element.
-   * - **spinner** - The spinner that shows when the button is in the loading state.
-   */
-  "terra-button": DefineComponent<TerraButtonProps>;
-
   /**
    * Icons are symbols that can be used to represent various options within an application.
    * ---
@@ -389,13 +389,6 @@ export type CustomElements = {
    */
   "terra-map": DefineComponent<TerraMapProps>;
 
-  /**
-   * A component that allows input of coordinates and rendering of map.
-   * ---
-   *
-   */
-  "terra-spatial-picker": DefineComponent<TerraSpatialPickerProps>;
-
   /**
    * A web component for interactive graphs using Plotly.js.
    * ---
@@ -406,6 +399,13 @@ export type CustomElements = {
    */
   "terra-plot": DefineComponent<TerraPlotProps>;
 
+  /**
+   * A component that allows input of coordinates and rendering of map.
+   * ---
+   *
+   */
+  "terra-spatial-picker": DefineComponent<TerraSpatialPickerProps>;
+
   /**
    * A component for visualizing time series data using the GES DISC Giovanni API.
    * ---

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

@@ -2,101 +2,6 @@
   "$schema": "https://raw.githubusercontent.com/microsoft/vscode-html-languageservice/main/docs/customData.schema.json",
   "version": 1.1,
   "tags": [
-    {
-      "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.",
-      "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-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-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.",
@@ -248,6 +153,101 @@
         }
       ]
     },
+    {
+      "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.",
+      "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-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-icon",
       "description": "Icons are symbols that can be used to represent various options within an application.\n---\n\n\n### **Events:**\n - **terra-load** - Emitted when the icon has loaded.\n- **terra-error** - Emitted when the icon fails to load due to an error.\n\n### **CSS Parts:**\n - **svg** - The internal SVG element.",
@@ -370,6 +370,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-spatial-picker",
       "description": "A component that allows input of coordinates and rendering of map.\n---\n",
@@ -423,22 +439,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-series",
       "description": "A component for visualizing time series data using the GES DISC Giovanni API.\n---\n",