@nasa-terra/components 0.0.97 → 0.0.99

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

@@ -1,44 +1,40 @@
 import type { DefineComponent } from "vue";
 
-import type { TerraBrowseVariables } from "../../components/browse-variables/browse-variables.component.js";
+import type { TerraAccordion } from "../../components/accordion/accordion.component.js";
 import type { TerraAlert } from "../../components/alert/alert.component.js";
 import type { TerraChip } from "../../components/chip/chip.component.js";
 import type { TerraButton } from "../../components/button/button.component.js";
-import type { TerraDataRods } from "../../components/data-rods/data-rods.component.js";
-import type { TerraAccordion } from "../../components/accordion/accordion.component.js";
+import type { TerraBrowseVariables } from "../../components/browse-variables/browse-variables.component.js";
 import type { TerraCombobox } from "../../components/combobox/combobox.component.js";
+import type { TerraDataRods } from "../../components/data-rods/data-rods.component.js";
 import type { TerraDataSubsetter } from "../../components/data-subsetter/data-subsetter.component.js";
+import type { TerraDataSubsetterHistory } from "../../components/data-subsetter-history/data-subsetter-history.component.js";
 import type { TerraDatePicker } from "../../components/date-picker/date-picker.component.js";
 import type { TerraDateRangeSlider } from "../../components/date-range-slider/date-range-slider.component.js";
-import type { TerraDataSubsetterHistory } from "../../components/data-subsetter-history/data-subsetter-history.component.js";
 import type { TerraDialog } from "../../components/dialog/dialog.component.js";
 import type { TerraIcon } from "../../components/icon/icon.component.js";
 import type { TerraLoader } from "../../components/loader/loader.component.js";
 import type { TerraLogin } from "../../components/login/login.component.js";
-import type { TerraPlot } from "../../components/plot/plot.component.js";
 import type { TerraMap } from "../../components/map/map.component.js";
+import type { TerraPlot } from "../../components/plot/plot.component.js";
 import type { TerraPlotToolbar } from "../../components/plot-toolbar/plot-toolbar.component.js";
 import type { TerraSkeleton } from "../../components/skeleton/skeleton.component.js";
 import type { TerraSpatialPicker } from "../../components/spatial-picker/spatial-picker.component.js";
 import type { TerraTimeAverageMap } from "../../components/time-average-map/time-average-map.component.js";
+import type { TerraVariableCombobox } from "../../components/variable-combobox/variable-combobox.component.js";
 import type { TerraTimeSeries, CustomEvent } from "../../components/time-series/time-series.component.js";
 import type { TerraVariableKeywordSearch } from "../../components/variable-keyword-search/variable-keyword-search.component.js";
-import type { TerraVariableCombobox } from "../../components/variable-combobox/variable-combobox.component.js";
 
-type TerraBrowseVariablesProps = {
-  /** Allows the user to switch the catalog between different providers
-TODO: add support for CMR catalog and make it the default */
-  catalog?: TerraBrowseVariables["catalog"];
-  /**  */
-  "selected-variable-entry-ids"?: TerraBrowseVariables["selectedVariableEntryIds"];
-  /**  */
-  searchQuery?: TerraBrowseVariables["searchQuery"];
-  /**  */
-  selectedFacets?: TerraBrowseVariables["selectedFacets"];
-  /**  */
-  selectedVariables?: TerraBrowseVariables["selectedVariables"];
+type TerraAccordionProps = {
+  /** The summary/header for the accordion. Use the property for simple text, or the slot for custom content. */
+  summary?: TerraAccordion["summary"];
+  /** Whether the accordion is open or not. This property is reflected as an attribute and can be controlled programmatically or by user interaction. */
+  open?: TerraAccordion["open"];
   /**  */
-  showVariablesBrowse?: TerraBrowseVariables["showVariablesBrowse"];
+  showArrow?: TerraAccordion["showArrow"];
+
+  /** emitted when the accordion opens or closes */
+  onTerraAccordionToggle?: (e: CustomEvent<never>) => void;
 };
 
 type TerraAlertProps = {
@@ -142,43 +138,20 @@ value of this attribute must be an id of a form in the same document or shadow r
   validationMessage?: TerraButton["validationMessage"];
 };
 
-type TerraDataRodsProps = {
-  /** a variable entry ID (ex: GPM_3IMERGHH_06_precipitationCal) */
-  "variable-entry-id"?: TerraDataRods["variableEntryId"];
-  /** a collection entry id (ex: GPM_3IMERGHH_06)
-only required if you don't include a variableEntryId */
-  collection?: TerraDataRods["collection"];
-  /** a variable short name to plot (ex: precipitationCal)
-only required if you don't include a variableEntryId */
-  variable?: TerraDataRods["variable"];
-  /** The start date for the time series plot. (ex: 2021-01-01) */
-  "start-date"?: TerraDataRods["startDate"];
-  /** The end date for the time series plot. (ex: 2021-01-01) */
-  "end-date"?: TerraDataRods["endDate"];
-  /** The point location in "lat,lon" format. */
-  location?: TerraDataRods["location"];
-  /** The token to be used for authentication with remote servers.
-The component provides the header "Authorization: Bearer" (the request header and authentication scheme).
-The property's value will be inserted after "Bearer" (the authentication scheme). */
-  "bearer-token"?: TerraDataRods["bearerToken"];
+type TerraBrowseVariablesProps = {
+  /** Allows the user to switch the catalog between different providers
+TODO: add support for CMR catalog and make it the default */
+  catalog?: TerraBrowseVariables["catalog"];
   /**  */
-  catalogVariable?: TerraDataRods["catalogVariable"];
+  "selected-variable-entry-ids"?: TerraBrowseVariables["selectedVariableEntryIds"];
   /**  */
-  _fetchVariableTask?: TerraDataRods["_fetchVariableTask"];
-  /** Emitted whenever the date range of the date slider is updated */
-  onTerraDateRangeChange?: (e: CustomEvent<never>) => void;
-};
-
-type TerraAccordionProps = {
-  /** The summary/header for the accordion. Use the property for simple text, or the slot for custom content. */
-  summary?: TerraAccordion["summary"];
-  /** Whether the accordion is open or not. This property is reflected as an attribute and can be controlled programmatically or by user interaction. */
-  open?: TerraAccordion["open"];
+  searchQuery?: TerraBrowseVariables["searchQuery"];
   /**  */
-  showArrow?: TerraAccordion["showArrow"];
-
-  /** emitted when the accordion opens or closes */
-  onTerraAccordionToggle?: (e: CustomEvent<never>) => void;
+  selectedFacets?: TerraBrowseVariables["selectedFacets"];
+  /**  */
+  selectedVariables?: TerraBrowseVariables["selectedVariables"];
+  /**  */
+  showVariablesBrowse?: TerraBrowseVariables["showVariablesBrowse"];
 };
 
 type TerraComboboxProps = {
@@ -207,6 +180,33 @@ When hidden, still presents to screen readers. */
   searchResults?: TerraCombobox["searchResults"];
 };
 
+type TerraDataRodsProps = {
+  /** a variable entry ID (ex: GPM_3IMERGHH_06_precipitationCal) */
+  "variable-entry-id"?: TerraDataRods["variableEntryId"];
+  /** a collection entry id (ex: GPM_3IMERGHH_06)
+only required if you don't include a variableEntryId */
+  collection?: TerraDataRods["collection"];
+  /** a variable short name to plot (ex: precipitationCal)
+only required if you don't include a variableEntryId */
+  variable?: TerraDataRods["variable"];
+  /** The start date for the time series plot. (ex: 2021-01-01) */
+  "start-date"?: TerraDataRods["startDate"];
+  /** The end date for the time series plot. (ex: 2021-01-01) */
+  "end-date"?: TerraDataRods["endDate"];
+  /** The point location in "lat,lon" format. */
+  location?: TerraDataRods["location"];
+  /** The token to be used for authentication with remote servers.
+The component provides the header "Authorization: Bearer" (the request header and authentication scheme).
+The property's value will be inserted after "Bearer" (the authentication scheme). */
+  "bearer-token"?: TerraDataRods["bearerToken"];
+  /**  */
+  catalogVariable?: TerraDataRods["catalogVariable"];
+  /**  */
+  _fetchVariableTask?: TerraDataRods["_fetchVariableTask"];
+  /** Emitted whenever the date range of the date slider is updated */
+  onTerraDateRangeChange?: (e: CustomEvent<never>) => void;
+};
+
 type TerraDataSubsetterProps = {
   /**  */
   "collection-entry-id"?: TerraDataSubsetter["collectionEntryId"];
@@ -260,6 +260,26 @@ type TerraDataSubsetterProps = {
   onTerraSubsetJobComplete?: (e: CustomEvent<never>) => void;
 };
 
+type TerraDataSubsetterHistoryProps = {
+  /**  */
+  label?: TerraDataSubsetterHistory["label"];
+  /**  */
+  "bearer-token"?: TerraDataSubsetterHistory["bearerToken"];
+  /** if a user has never done a subset request, by default they don't see the history panel at all
+this prop allows you to override that behavior and always show the history panel */
+  "always-show"?: TerraDataSubsetterHistory["alwaysShow"];
+  /**  */
+  collapsed?: TerraDataSubsetterHistory["collapsed"];
+  /**  */
+  selectedJob?: TerraDataSubsetterHistory["selectedJob"];
+  /**  */
+  hideCancelled?: TerraDataSubsetterHistory["hideCancelled"];
+  /**  */
+  dialog?: TerraDataSubsetterHistory["dialog"];
+  /**  */
+  _authController?: TerraDataSubsetterHistory["_authController"];
+};
+
 type TerraDatePickerProps = {
   /**  */
   id?: TerraDatePicker["id"];
@@ -324,26 +344,6 @@ type TerraDateRangeSliderProps = {
   slider?: TerraDateRangeSlider["slider"];
 };
 
-type TerraDataSubsetterHistoryProps = {
-  /**  */
-  label?: TerraDataSubsetterHistory["label"];
-  /**  */
-  "bearer-token"?: TerraDataSubsetterHistory["bearerToken"];
-  /** if a user has never done a subset request, by default they don't see the history panel at all
-this prop allows you to override that behavior and always show the history panel */
-  "always-show"?: TerraDataSubsetterHistory["alwaysShow"];
-  /**  */
-  collapsed?: TerraDataSubsetterHistory["collapsed"];
-  /**  */
-  selectedJob?: TerraDataSubsetterHistory["selectedJob"];
-  /**  */
-  hideCancelled?: TerraDataSubsetterHistory["hideCancelled"];
-  /**  */
-  dialog?: TerraDataSubsetterHistory["dialog"];
-  /**  */
-  _authController?: TerraDataSubsetterHistory["_authController"];
-};
-
 type TerraDialogProps = {
   /** the ID to be used for accessibility associations */
   id?: TerraDialog["id"];
@@ -405,19 +405,6 @@ type TerraLoginProps = {
   onTerraLogin?: (e: CustomEvent<never>) => void;
 };
 
-type TerraPlotProps = {
-  /**  */
-  plotTitle?: TerraPlot["plotTitle"];
-  /**  */
-  layout?: TerraPlot["layout"];
-  /**  */
-  config?: TerraPlot["config"];
-  /**  */
-  data?: TerraPlot["data"];
-  /**  */
-  base?: TerraPlot["base"];
-};
-
 type TerraMapProps = {
   /** Minimum zoom level of the map. */
   "min-zoom"?: TerraMap["minZoom"];
@@ -449,6 +436,19 @@ type TerraMapProps = {
   _mapController?: TerraMap["_mapController"];
 };
 
+type TerraPlotProps = {
+  /**  */
+  plotTitle?: TerraPlot["plotTitle"];
+  /**  */
+  layout?: TerraPlot["layout"];
+  /**  */
+  config?: TerraPlot["config"];
+  /**  */
+  data?: TerraPlot["data"];
+  /**  */
+  base?: TerraPlot["base"];
+};
+
 type TerraPlotToolbarProps = {
   /**  */
   catalogVariable?: TerraPlotToolbar["catalogVariable"];
@@ -564,6 +564,41 @@ Or the bounding box in "west,south,east,north" format. */
   _fetchVariableTask?: TerraTimeAverageMap["_fetchVariableTask"];
 };
 
+type TerraVariableComboboxProps = {
+  /** Label the combobox with this. */
+  label?: TerraVariableCombobox["label"];
+  /** Set a placeholder for the combobox with this.
+Defaults to the label's value. */
+  placeholder?: TerraVariableCombobox["placeholder"];
+  /** Hide the combobox's help text.
+When hidden, not rendered at all. */
+  "hide-help"?: TerraVariableCombobox["hideHelp"];
+  /** Hide the combobox's label text.
+When hidden, still presents to screen readers. */
+  "hide-label"?: TerraVariableCombobox["hideLabel"];
+  /** Determines if the variable combobox uses tags or plain text to display the query. */
+  "use-tags"?: TerraVariableCombobox["useTags"];
+  /** Represents the EntryID (<collection-name>_<variable-name>) of the selected variable.
+Other components (like the time-series graphing component) will use this. */
+  value?: TerraVariableCombobox["value"];
+  /** The token to be used for authentication with remote servers.
+The component provides the header "Authorization: Bearer" (the request header and authentication scheme).
+The property's value will be inserted after "Bearer" (the authentication scheme). */
+  "bearer-token"?: TerraVariableCombobox["bearerToken"];
+  /**  */
+  isExpanded?: TerraVariableCombobox["isExpanded"];
+  /**  */
+  query?: TerraVariableCombobox["query"];
+  /**  */
+  searchResults?: TerraVariableCombobox["searchResults"];
+  /**  */
+  tags?: TerraVariableCombobox["tags"];
+  /**  */
+  tagContainerWidth?: TerraVariableCombobox["tagContainerWidth"];
+  /** Emitted when an option is selected. */
+  onTerraComboboxChange?: (e: CustomEvent<never>) => void;
+};
+
 type TerraTimeSeriesProps = {
   /** a variable entry ID (ex: GPM_3IMERGHH_06_precipitationCal) */
   "variable-entry-id"?: TerraTimeSeries["variableEntryId"];
@@ -629,48 +664,20 @@ When hidden, still presents to screen readers. */
   onTerraSearch?: (e: CustomEvent<never>) => void;
 };
 
-type TerraVariableComboboxProps = {
-  /** Label the combobox with this. */
-  label?: TerraVariableCombobox["label"];
-  /** Set a placeholder for the combobox with this.
-Defaults to the label's value. */
-  placeholder?: TerraVariableCombobox["placeholder"];
-  /** Hide the combobox's help text.
-When hidden, not rendered at all. */
-  "hide-help"?: TerraVariableCombobox["hideHelp"];
-  /** Hide the combobox's label text.
-When hidden, still presents to screen readers. */
-  "hide-label"?: TerraVariableCombobox["hideLabel"];
-  /** Determines if the variable combobox uses tags or plain text to display the query. */
-  "use-tags"?: TerraVariableCombobox["useTags"];
-  /** Represents the EntryID (<collection-name>_<variable-name>) of the selected variable.
-Other components (like the time-series graphing component) will use this. */
-  value?: TerraVariableCombobox["value"];
-  /** The token to be used for authentication with remote servers.
-The component provides the header "Authorization: Bearer" (the request header and authentication scheme).
-The property's value will be inserted after "Bearer" (the authentication scheme). */
-  "bearer-token"?: TerraVariableCombobox["bearerToken"];
-  /**  */
-  isExpanded?: TerraVariableCombobox["isExpanded"];
-  /**  */
-  query?: TerraVariableCombobox["query"];
-  /**  */
-  searchResults?: TerraVariableCombobox["searchResults"];
-  /**  */
-  tags?: TerraVariableCombobox["tags"];
-  /**  */
-  tagContainerWidth?: TerraVariableCombobox["tagContainerWidth"];
-  /** Emitted when an option is selected. */
-  onTerraComboboxChange?: (e: CustomEvent<never>) => void;
-};
-
 export type CustomElements = {
   /**
-   * Browse through the NASA CMR or Giovanni catalogs.
+   * A collapsible content panel for showing and hiding content.
    * ---
    *
+   *
+   * ### **Events:**
+   *  - **terra-accordion-toggle** - emitted when the accordion opens or closes
+   *
+   * ### **Slots:**
+   *  - _default_ - The default slot for accordion content.
+   * - **summary** - The summary/header for the accordion (optional, overrides summary property)
    */
-  "terra-browse-variables": DefineComponent<TerraBrowseVariablesProps>;
+  "terra-accordion": DefineComponent<TerraAccordionProps>;
 
   /**
    * Alerts are used to display important messages inline or as toast notifications.
@@ -740,28 +747,11 @@ export type CustomElements = {
   "terra-button": DefineComponent<TerraButtonProps>;
 
   /**
-   * A component for visualizing Hydrology Data Rods time series using the GES DISC Giovanni API
+   * Browse through the NASA CMR or Giovanni catalogs.
    * ---
    *
-   *
-   * ### **Events:**
-   *  - **terra-date-range-change** - Emitted whenever the date range of the date slider is updated
    */
-  "terra-data-rods": DefineComponent<TerraDataRodsProps>;
-
-  /**
-   * A collapsible content panel for showing and hiding content.
-   * ---
-   *
-   *
-   * ### **Events:**
-   *  - **terra-accordion-toggle** - emitted when the accordion opens or closes
-   *
-   * ### **Slots:**
-   *  - _default_ - The default slot for accordion content.
-   * - **summary** - The summary/header for the accordion (optional, overrides summary property)
-   */
-  "terra-accordion": DefineComponent<TerraAccordionProps>;
+  "terra-browse-variables": DefineComponent<TerraBrowseVariablesProps>;
 
   /**
    * Fuzzy-search for combobox with list autocomplete.
@@ -781,6 +771,16 @@ export type CustomElements = {
    */
   "terra-combobox": DefineComponent<TerraComboboxProps>;
 
+  /**
+   * A component for visualizing Hydrology Data Rods time series using the GES DISC Giovanni API
+   * ---
+   *
+   *
+   * ### **Events:**
+   *  - **terra-date-range-change** - Emitted whenever the date range of the date slider is updated
+   */
+  "terra-data-rods": DefineComponent<TerraDataRodsProps>;
+
   /**
    * Easily allow users to select, subset, and download NASA Earth science data collections with spatial, temporal, and variable filters.
    * ---
@@ -791,6 +791,13 @@ export type CustomElements = {
    */
   "terra-data-subsetter": DefineComponent<TerraDataSubsetterProps>;
 
+  /**
+   * Shows a floating panel with a user's recent data subset requests and their status, with quick access to results and re-submission.
+   * ---
+   *
+   */
+  "terra-data-subsetter-history": DefineComponent<TerraDataSubsetterHistoryProps>;
+
   /**
    * A date picker component that supports single date selection or date range selection.
    * ---
@@ -822,13 +829,6 @@ export type CustomElements = {
    */
   "terra-date-range-slider": DefineComponent<TerraDateRangeSliderProps>;
 
-  /**
-   * Shows a floating panel with a user's recent data subset requests and their status, with quick access to results and re-submission.
-   * ---
-   *
-   */
-  "terra-data-subsetter-history": DefineComponent<TerraDataSubsetterHistoryProps>;
-
   /**
    * Used to create both modal and non-modal dialog boxes.
    * ---
@@ -881,21 +881,21 @@ export type CustomElements = {
   "terra-login": DefineComponent<TerraLoginProps>;
 
   /**
-   * A web component for interactive graphs using Plotly.js.
+   * A map component for visualizing and selecting coordinates.
    * ---
    *
-   *
-   * ### **CSS Parts:**
-   *  - **base** - The component's base wrapper.
    */
-  "terra-plot": DefineComponent<TerraPlotProps>;
+  "terra-map": DefineComponent<TerraMapProps>;
 
   /**
-   * A map component for visualizing and selecting coordinates.
+   * A web component for interactive graphs using Plotly.js.
    * ---
    *
+   *
+   * ### **CSS Parts:**
+   *  - **base** - The component's base wrapper.
    */
-  "terra-map": DefineComponent<TerraMapProps>;
+  "terra-plot": DefineComponent<TerraPlotProps>;
 
   /**
    * Short summary of the component's intended use.
@@ -936,27 +936,20 @@ export type CustomElements = {
   "terra-time-average-map": DefineComponent<TerraTimeAverageMapProps>;
 
   /**
-   * A component for visualizing time series data using the GES DISC Giovanni API.
+   * Fuzzy-search for dataset variables in combobox with list autocomplete.
    * ---
    *
    *
    * ### **Events:**
-   *  - **terra-date-range-change** - Emitted whenever the date range is modified
-   * - **terra-time-series-data-change** - Emitted whenever time series data has been fetched from Giovanni
-   */
-  "terra-time-series": DefineComponent<TerraTimeSeriesProps>;
-
-  /**
-   * Fuzzy-search for dataset keywords in combobox with list autocomplete.
-   * ---
-   *
+   *  - **terra-combobox-change** - Emitted when an option is selected.
    *
-   * ### **Events:**
-   *  - **terra-variable-keyword-search-change** - Emitted when an option is selected.
-   * - **terra-search** - Emitted when the component is triggering a search (like a form triggering submit).
+   * ### **Methods:**
+   *  - **valueChanged(oldValue: _string_, newValue: _string_)** - This component's value is read by other components.
+   * Internally, the variable metdata has slight differences that require adapting.
    *
    * ### **CSS Properties:**
    *  - **--host-height** - The height of the host element. _(default: undefined)_
+   * - **--help-height** - The height of the search help element. _(default: undefined)_
    * - **--label-height** - The height of the input's label element. _(default: undefined)_
    *
    * ### **CSS Parts:**
@@ -965,23 +958,30 @@ export type CustomElements = {
    * - **button** - A `button` used for toggling the listbox's visibility.
    * - **listbox** - A `ul` that holds the clickable options.
    */
-  "terra-variable-keyword-search": DefineComponent<TerraVariableKeywordSearchProps>;
+  "terra-variable-combobox": DefineComponent<TerraVariableComboboxProps>;
 
   /**
-   * Fuzzy-search for dataset variables in combobox with list autocomplete.
+   * A component for visualizing time series data using the GES DISC Giovanni API.
    * ---
    *
    *
    * ### **Events:**
-   *  - **terra-combobox-change** - Emitted when an option is selected.
+   *  - **terra-date-range-change** - Emitted whenever the date range is modified
+   * - **terra-time-series-data-change** - Emitted whenever time series data has been fetched from Giovanni
+   */
+  "terra-time-series": DefineComponent<TerraTimeSeriesProps>;
+
+  /**
+   * Fuzzy-search for dataset keywords in combobox with list autocomplete.
+   * ---
    *
-   * ### **Methods:**
-   *  - **valueChanged(oldValue: _string_, newValue: _string_)** - This component's value is read by other components.
-   * Internally, the variable metdata has slight differences that require adapting.
+   *
+   * ### **Events:**
+   *  - **terra-variable-keyword-search-change** - Emitted when an option is selected.
+   * - **terra-search** - Emitted when the component is triggering a search (like a form triggering submit).
    *
    * ### **CSS Properties:**
    *  - **--host-height** - The height of the host element. _(default: undefined)_
-   * - **--help-height** - The height of the search help element. _(default: undefined)_
    * - **--label-height** - The height of the input's label element. _(default: undefined)_
    *
    * ### **CSS Parts:**
@@ -990,7 +990,7 @@ export type CustomElements = {
    * - **button** - A `button` used for toggling the listbox's visibility.
    * - **listbox** - A `ul` that holds the clickable options.
    */
-  "terra-variable-combobox": DefineComponent<TerraVariableComboboxProps>;
+  "terra-variable-keyword-search": DefineComponent<TerraVariableKeywordSearchProps>;
 };
 
 declare module "vue" {