@nasa-terra/components 0.0.182 → 0.0.183

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

@@ -1,8 +1,8 @@
 import type { DefineComponent } from "vue";
 
 import type { TerraAccordion } from "../../components/accordion/accordion.component.js";
-import type { TerraAlert } from "../../components/alert/alert.component.js";
 import type { TerraAvatar } from "../../components/avatar/avatar.component.js";
+import type { TerraAlert } from "../../components/alert/alert.component.js";
 import type { TerraBadge } from "../../components/badge/badge.component.js";
 import type { TerraBreadcrumb } from "../../components/breadcrumb/breadcrumb.component.js";
 import type { TerraBreadcrumbs } from "../../components/breadcrumbs/breadcrumbs.component.js";
@@ -55,15 +55,15 @@ import type { TerraStepperStep } from "../../components/stepper-step/stepper-ste
 import type { TerraTab } from "../../components/tab/tab.component.js";
 import type { TerraTabPanel } from "../../components/tab-panel/tab-panel.component.js";
 import type { TerraTabs } from "../../components/tabs/tabs.component.js";
-import type { TerraTextarea } from "../../components/textarea/textarea.component.js";
 import type { TerraTag } from "../../components/tag/tag.component.js";
+import type { TerraTextarea } from "../../components/textarea/textarea.component.js";
 import type { TerraTimeAverageMap } from "../../components/time-average-map/time-average-map.component.js";
 import type { TerraTimeSeries, CustomEvent } from "../../components/time-series/time-series.component.js";
 import type { TerraToast } from "../../components/toast/toast.component.js";
 import type { TerraToggle } from "../../components/toggle/toggle.component.js";
-import type { TerraTooltip } from "../../components/tooltip/tooltip.component.js";
 import type { TerraVariableCombobox } from "../../components/variable-combobox/variable-combobox.component.js";
 import type { TerraVariableKeywordSearch } from "../../components/variable-keyword-search/variable-keyword-search.component.js";
+import type { TerraTooltip } from "../../components/tooltip/tooltip.component.js";
 
 type TerraAccordionProps = {
   /** The summary/header for the accordion. Use the property for simple text, or the slot for custom content. */
@@ -77,6 +77,22 @@ type TerraAccordionProps = {
   "onterra-accordion-toggle"?: (e: CustomEvent<never>) => void;
 };
 
+type TerraAvatarProps = {
+  /** The image source to use for the avatar. */
+  image?: TerraAvatar["image"];
+  /** A label to use to describe the avatar to assistive devices. */
+  label?: TerraAvatar["label"];
+  /** Initials to use as a fallback when no image is available (1-2 characters max recommended). */
+  initials?: TerraAvatar["initials"];
+  /** Indicates how the browser should load the image. */
+  loading?: TerraAvatar["loading"];
+  /** The shape of the avatar. */
+  shape?: TerraAvatar["shape"];
+
+  /** The image could not be loaded. This may because of an invalid URL, a temporary network condition, or some unknown cause. */
+  "onterra-error"?: (e: CustomEvent<never>) => void;
+};
+
 type TerraAlertProps = {
   /** Indicates whether or not the alert is open. You can toggle this attribute to show and hide the alert, or you can
 use the `show()` and `hide()` methods and this attribute will reflect the alert's open state. */
@@ -109,22 +125,6 @@ Typically used to indicate the remaining time before a whole app refresh. */
   "onterra-after-hide"?: (e: CustomEvent<never>) => void;
 };
 
-type TerraAvatarProps = {
-  /** The image source to use for the avatar. */
-  image?: TerraAvatar["image"];
-  /** A label to use to describe the avatar to assistive devices. */
-  label?: TerraAvatar["label"];
-  /** Initials to use as a fallback when no image is available (1-2 characters max recommended). */
-  initials?: TerraAvatar["initials"];
-  /** Indicates how the browser should load the image. */
-  loading?: TerraAvatar["loading"];
-  /** The shape of the avatar. */
-  shape?: TerraAvatar["shape"];
-
-  /** The image could not be loaded. This may because of an invalid URL, a temporary network condition, or some unknown cause. */
-  "onterra-error"?: (e: CustomEvent<never>) => void;
-};
-
 type TerraBadgeProps = {
   /** The badge's theme variant. */
   variant?: TerraBadge["variant"];
@@ -1610,6 +1610,26 @@ manual, the tab will receive focus but will not show until the user presses spac
   "onterra-tab-hide"?: (e: CustomEvent<{ name: String }>) => void;
 };
 
+type TerraTagProps = {
+  /** The tag variant. Determines the styling and behavior. */
+  variant?: TerraTag["variant"];
+  /** The size of the tag. */
+  size?: TerraTag["size"];
+  /** The icon name for content tags. Used with the default icon library. */
+  icon?: TerraTag["icon"];
+  /** The icon library to use for content tags. */
+  iconLibrary?: TerraTag["iconLibrary"];
+  /** When true, tags will stack vertically instead of sitting side by side. */
+  stack?: TerraTag["stack"];
+  /** When true, forces dark mode styles regardless of system preference. Useful when placing the component on a dark background. */
+  dark?: TerraTag["dark"];
+  /** The href for topic tags. If provided, the tag will be rendered as a link. */
+  href?: TerraTag["href"];
+
+  /** Emitted when a topic tag is clicked (unless href is provided). */
+  "onterra-click"?: (e: CustomEvent<never>) => void;
+};
+
 type TerraTextareaProps = {
   /**  */
   name?: TerraTextarea["name"];
@@ -1667,26 +1687,6 @@ the same document or shadow root for this to work. */
   "onterra-invalid"?: (e: CustomEvent<never>) => void;
 };
 
-type TerraTagProps = {
-  /** The tag variant. Determines the styling and behavior. */
-  variant?: TerraTag["variant"];
-  /** The size of the tag. */
-  size?: TerraTag["size"];
-  /** The icon name for content tags. Used with the default icon library. */
-  icon?: TerraTag["icon"];
-  /** The icon library to use for content tags. */
-  iconLibrary?: TerraTag["iconLibrary"];
-  /** When true, tags will stack vertically instead of sitting side by side. */
-  stack?: TerraTag["stack"];
-  /** When true, forces dark mode styles regardless of system preference. Useful when placing the component on a dark background. */
-  dark?: TerraTag["dark"];
-  /** The href for topic tags. If provided, the tag will be rendered as a link. */
-  href?: TerraTag["href"];
-
-  /** Emitted when a topic tag is clicked (unless href is provided). */
-  "onterra-click"?: (e: CustomEvent<never>) => void;
-};
-
 type TerraTimeAverageMapProps = {
   /**  */
   collection?: TerraTimeAverageMap["collection"];
@@ -1708,10 +1708,11 @@ type TerraTimeAverageMapProps = {
   opacity?: TerraTimeAverageMap["opacity"];
   /** the application ID is used for tracking purposes and will be included in the labels of Harmony jobs created by this component */
   "application-id"?: TerraTimeAverageMap["applicationId"];
-  /** When true, disables IndexedDB caching entirely — data will not be read from or written to the local cache.
-Harmony history is still checked before creating a new request.
-Useful for applications that always want a fresh server-side request (e.g., Giovanni). */
-  "no-cache"?: TerraTimeAverageMap["noCache"];
+  /** When true, enables IndexedDB caching — data will be read from and written to the local cache.
+Defaults to false, meaning no caching is performed. */
+  cache?: TerraTimeAverageMap["cache"];
+  /** If provided, skips creating a new Harmony job and instead waits for this existing job ID to complete. */
+  "job-id"?: TerraTimeAverageMap["jobId"];
   /**  */
   catalogVariable?: TerraTimeAverageMap["catalogVariable"];
   /**  */
@@ -1784,10 +1785,11 @@ The property's value will be inserted after "Bearer" (the authentication scheme)
   "product-label"?: TerraTimeSeries["productLabel"];
   /** the application ID is used for tracking purposes and will be included in the labels of Harmony jobs created by this component */
   "application-id"?: TerraTimeSeries["applicationId"];
-  /** When true, disables IndexedDB caching entirely — data will not be read from or written to the local cache.
-Harmony history is still checked before creating a new request.
-Useful for applications that always want a fresh server-side request (e.g., Giovanni). */
-  "no-cache"?: TerraTimeSeries["noCache"];
+  /** When true, enables IndexedDB caching — data will be read from and written to the local cache.
+Defaults to false, meaning no caching is performed. */
+  cache?: TerraTimeSeries["cache"];
+  /** If provided, skips creating a new Harmony job and instead waits for this existing job ID to complete. */
+  "job-id"?: TerraTimeSeries["jobId"];
   /**  */
   plot?: TerraTimeSeries["plot"];
   /**  */
@@ -1876,50 +1878,6 @@ the same document or shadow root for this to work. */
   "onterra-invalid"?: (e: CustomEvent<never>) => void;
 };
 
-type TerraTooltipProps = {
-  /** The tooltip or popover content. If you need to display HTML, use the `content` slot instead. */
-  content?: TerraTooltip["content"];
-  /** The variant of the component. `tooltip` shows compact inline help, while `popover` shows a larger card-style panel
-that can contain images and links. */
-  variant?: TerraTooltip["variant"];
-  /** The preferred placement of the tooltip. Note that the actual placement may vary as needed to keep the tooltip
-inside of the viewport. */
-  placement?: TerraTooltip["placement"];
-  /** Disables the tooltip so it won't show when triggered. */
-  disabled?: TerraTooltip["disabled"];
-  /** The distance in pixels from which to offset the tooltip or popover away from its target. */
-  distance?: TerraTooltip["distance"];
-  /** Indicates whether or not the tooltip or popover is open. You can use this in lieu of the show/hide methods. */
-  open?: TerraTooltip["open"];
-  /** The distance in pixels from which to offset the tooltip along its target. */
-  skidding?: TerraTooltip["skidding"];
-  /** Controls how the tooltip or popover is activated. Possible options include `click`, `hover`, `focus`, and `manual`. Multiple
-options can be passed by separating them with a space. When manual is used, the tooltip must be activated
-programmatically. */
-  trigger?: TerraTooltip["trigger"];
-  /** Enable this option to prevent the tooltip from being clipped when the component is placed inside a container with
-`overflow: auto|hidden|scroll`. Hoisting uses a fixed positioning strategy that works in many, but not all,
-scenarios. */
-  hoist?: TerraTooltip["hoist"];
-  /** Allows text inside the tooltip to be selected and copied. Also enables pointer events on the tooltip body
-so the user can interact with its content. */
-  interactive?: TerraTooltip["interactive"];
-  /**  */
-  defaultSlot?: TerraTooltip["defaultSlot"];
-  /**  */
-  body?: TerraTooltip["body"];
-  /**  */
-  popup?: TerraTooltip["popup"];
-  /** Emitted when the tooltip or popover begins to show. */
-  "onterra-show"?: (e: CustomEvent<never>) => void;
-  /** Emitted after it has shown and all animations are complete. */
-  "onterra-after-show"?: (e: CustomEvent<never>) => void;
-  /** Emitted when the tooltip or popover begins to hide. */
-  "onterra-hide"?: (e: CustomEvent<never>) => void;
-  /** Emitted after it has hidden and all animations are complete. */
-  "onterra-after-hide"?: (e: CustomEvent<never>) => void;
-};
-
 type TerraVariableComboboxProps = {
   /** Label the combobox with this. */
   label?: TerraVariableCombobox["label"];
@@ -1980,6 +1938,50 @@ When hidden, still presents to screen readers. */
   "onterra-search"?: (e: CustomEvent<never>) => void;
 };
 
+type TerraTooltipProps = {
+  /** The tooltip or popover content. If you need to display HTML, use the `content` slot instead. */
+  content?: TerraTooltip["content"];
+  /** The variant of the component. `tooltip` shows compact inline help, while `popover` shows a larger card-style panel
+that can contain images and links. */
+  variant?: TerraTooltip["variant"];
+  /** The preferred placement of the tooltip. Note that the actual placement may vary as needed to keep the tooltip
+inside of the viewport. */
+  placement?: TerraTooltip["placement"];
+  /** Disables the tooltip so it won't show when triggered. */
+  disabled?: TerraTooltip["disabled"];
+  /** The distance in pixels from which to offset the tooltip or popover away from its target. */
+  distance?: TerraTooltip["distance"];
+  /** Indicates whether or not the tooltip or popover is open. You can use this in lieu of the show/hide methods. */
+  open?: TerraTooltip["open"];
+  /** The distance in pixels from which to offset the tooltip along its target. */
+  skidding?: TerraTooltip["skidding"];
+  /** Controls how the tooltip or popover is activated. Possible options include `click`, `hover`, `focus`, and `manual`. Multiple
+options can be passed by separating them with a space. When manual is used, the tooltip must be activated
+programmatically. */
+  trigger?: TerraTooltip["trigger"];
+  /** Enable this option to prevent the tooltip from being clipped when the component is placed inside a container with
+`overflow: auto|hidden|scroll`. Hoisting uses a fixed positioning strategy that works in many, but not all,
+scenarios. */
+  hoist?: TerraTooltip["hoist"];
+  /** Allows text inside the tooltip to be selected and copied. Also enables pointer events on the tooltip body
+so the user can interact with its content. */
+  interactive?: TerraTooltip["interactive"];
+  /**  */
+  defaultSlot?: TerraTooltip["defaultSlot"];
+  /**  */
+  body?: TerraTooltip["body"];
+  /**  */
+  popup?: TerraTooltip["popup"];
+  /** Emitted when the tooltip or popover begins to show. */
+  "onterra-show"?: (e: CustomEvent<never>) => void;
+  /** Emitted after it has shown and all animations are complete. */
+  "onterra-after-show"?: (e: CustomEvent<never>) => void;
+  /** Emitted when the tooltip or popover begins to hide. */
+  "onterra-hide"?: (e: CustomEvent<never>) => void;
+  /** Emitted after it has hidden and all animations are complete. */
+  "onterra-after-hide"?: (e: CustomEvent<never>) => void;
+};
+
 export type CustomElements = {
   /**
    * A collapsible content panel for showing and hiding content.
@@ -1995,6 +1997,28 @@ export type CustomElements = {
    */
   "terra-accordion": DefineComponent<TerraAccordionProps>;
 
+  /**
+   * Avatars are used to represent a person or object.
+   * ---
+   *
+   *
+   * ### **Events:**
+   *  - **terra-error** - The image could not be loaded. This may because of an invalid URL, a temporary network condition, or some unknown cause.
+   *
+   * ### **Slots:**
+   *  - **icon** - The default icon to use when no image or initials are present. Works best with `<terra-icon>`.
+   *
+   * ### **CSS Properties:**
+   *  - **--size** - The size of the avatar. _(default: undefined)_
+   *
+   * ### **CSS Parts:**
+   *  - **base** - The component's base wrapper.
+   * - **icon** - The container that wraps the avatar's icon.
+   * - **initials** - The container that wraps the avatar's initials.
+   * - **image** - The avatar image. Only shown when the `image` attribute is set.
+   */
+  "terra-avatar": DefineComponent<TerraAvatarProps>;
+
   /**
    * Alerts are used to display important messages inline or as toast notifications.
    * ---
@@ -2023,28 +2047,6 @@ export type CustomElements = {
    */
   "terra-alert": DefineComponent<TerraAlertProps>;
 
-  /**
-   * Avatars are used to represent a person or object.
-   * ---
-   *
-   *
-   * ### **Events:**
-   *  - **terra-error** - The image could not be loaded. This may because of an invalid URL, a temporary network condition, or some unknown cause.
-   *
-   * ### **Slots:**
-   *  - **icon** - The default icon to use when no image or initials are present. Works best with `<terra-icon>`.
-   *
-   * ### **CSS Properties:**
-   *  - **--size** - The size of the avatar. _(default: undefined)_
-   *
-   * ### **CSS Parts:**
-   *  - **base** - The component's base wrapper.
-   * - **icon** - The container that wraps the avatar's icon.
-   * - **initials** - The container that wraps the avatar's initials.
-   * - **image** - The avatar image. Only shown when the `image` attribute is set.
-   */
-  "terra-avatar": DefineComponent<TerraAvatarProps>;
-
   /**
    * Badges are used to draw attention and display statuses or counts.
    * ---
@@ -3108,35 +3110,6 @@ export type CustomElements = {
    */
   "terra-tabs": DefineComponent<TerraTabsProps>;
 
-  /**
-   * A textarea component with consistent styling across the design system.
-   * ---
-   *
-   *
-   * ### **Events:**
-   *  - **terra-input** - Emitted when the textarea receives input.
-   * - **terra-change** - Emitted when an alteration to the control's value is committed by the user.
-   * - **terra-focus** - Emitted when the textarea gains focus.
-   * - **terra-blur** - Emitted when the textarea loses focus.
-   * - **terra-invalid** - Emitted when the form control has been checked for validity and its constraints aren't satisfied.
-   *
-   * ### **Methods:**
-   *  - **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. The value provided will be shown to the user when the form is submitted. To clear
-   * the custom validation message, call this method with an empty string.
-   *
-   * ### **Slots:**
-   *  - **help-text** - Text that describes how to use the textarea. Alternatively, you can use the `help-text` attribute.
-   *
-   * ### **CSS Parts:**
-   *  - **base** - The component's base wrapper.
-   * - **textarea** - The internal textarea control.
-   * - **form-control-help-text** - The help text's wrapper.
-   */
-  "terra-textarea": DefineComponent<TerraTextareaProps>;
-
   /**
    * Tags are simple labels that help categorize items.
    * ---
@@ -3181,6 +3154,35 @@ export type CustomElements = {
    */
   "terra-tag": DefineComponent<TerraTagProps>;
 
+  /**
+   * A textarea component with consistent styling across the design system.
+   * ---
+   *
+   *
+   * ### **Events:**
+   *  - **terra-input** - Emitted when the textarea receives input.
+   * - **terra-change** - Emitted when an alteration to the control's value is committed by the user.
+   * - **terra-focus** - Emitted when the textarea gains focus.
+   * - **terra-blur** - Emitted when the textarea loses focus.
+   * - **terra-invalid** - Emitted when the form control has been checked for validity and its constraints aren't satisfied.
+   *
+   * ### **Methods:**
+   *  - **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. The value provided will be shown to the user when the form is submitted. To clear
+   * the custom validation message, call this method with an empty string.
+   *
+   * ### **Slots:**
+   *  - **help-text** - Text that describes how to use the textarea. Alternatively, you can use the `help-text` attribute.
+   *
+   * ### **CSS Parts:**
+   *  - **base** - The component's base wrapper.
+   * - **textarea** - The internal textarea control.
+   * - **form-control-help-text** - The help text's wrapper.
+   */
+  "terra-textarea": DefineComponent<TerraTextareaProps>;
+
   /**
    *
    * ---
@@ -3276,39 +3278,6 @@ export type CustomElements = {
    */
   "terra-toggle": DefineComponent<TerraToggleProps>;
 
-  /**
-   * Tooltips display brief, contextual help on hover or focus. Popovers show richer supporting content.
-   * ---
-   *
-   *
-   * ### **Events:**
-   *  - **terra-show** - Emitted when the tooltip or popover begins to show.
-   * - **terra-after-show** - Emitted after it has shown and all animations are complete.
-   * - **terra-hide** - Emitted when the tooltip or popover begins to hide.
-   * - **terra-after-hide** - Emitted after it has hidden and all animations are complete.
-   *
-   * ### **Methods:**
-   *  - **show()** - Shows the tooltip or popover.
-   * - **hide()** - Hides the tooltip or popover.
-   *
-   * ### **Slots:**
-   *  - _default_ - The tooltip or popover target element. Avoid slotting in more than one element, as subsequent ones will be ignored.
-   * - **content** - The content to render in the tooltip or popover. Alternatively, you can use the `content` attribute.
-   * - **image** - Optional image slot for popovers. When provided, the image will span the full width of the popover.
-   *
-   * ### **CSS Properties:**
-   *  - **--max-width** - The maximum width of the tooltip before its content will wrap. _(default: undefined)_
-   * - **--hide-delay** - The amount of time to wait before hiding the tooltip when hovering. _(default: undefined)_
-   * - **--show-delay** - The amount of time to wait before showing the tooltip when hovering. _(default: undefined)_
-   *
-   * ### **CSS Parts:**
-   *  - **base** - The component's base wrapper, an `<terra-popup>` element.
-   * - **base__popup** - The popup's exported `popup` part. Use this to target the tooltip's popup container.
-   * - **base__arrow** - The popup's exported `arrow` part. Use this to target the tooltip's arrow.
-   * - **body** - The tooltip or popover body where its content is rendered.
-   */
-  "terra-tooltip": DefineComponent<TerraTooltipProps>;
-
   /**
    * Fuzzy-search for dataset variables in combobox with list autocomplete.
    * ---
@@ -3354,6 +3323,39 @@ export type CustomElements = {
    * - **listbox** - A `ul` that holds the clickable options.
    */
   "terra-variable-keyword-search": DefineComponent<TerraVariableKeywordSearchProps>;
+
+  /**
+   * Tooltips display brief, contextual help on hover or focus. Popovers show richer supporting content.
+   * ---
+   *
+   *
+   * ### **Events:**
+   *  - **terra-show** - Emitted when the tooltip or popover begins to show.
+   * - **terra-after-show** - Emitted after it has shown and all animations are complete.
+   * - **terra-hide** - Emitted when the tooltip or popover begins to hide.
+   * - **terra-after-hide** - Emitted after it has hidden and all animations are complete.
+   *
+   * ### **Methods:**
+   *  - **show()** - Shows the tooltip or popover.
+   * - **hide()** - Hides the tooltip or popover.
+   *
+   * ### **Slots:**
+   *  - _default_ - The tooltip or popover target element. Avoid slotting in more than one element, as subsequent ones will be ignored.
+   * - **content** - The content to render in the tooltip or popover. Alternatively, you can use the `content` attribute.
+   * - **image** - Optional image slot for popovers. When provided, the image will span the full width of the popover.
+   *
+   * ### **CSS Properties:**
+   *  - **--max-width** - The maximum width of the tooltip before its content will wrap. _(default: undefined)_
+   * - **--hide-delay** - The amount of time to wait before hiding the tooltip when hovering. _(default: undefined)_
+   * - **--show-delay** - The amount of time to wait before showing the tooltip when hovering. _(default: undefined)_
+   *
+   * ### **CSS Parts:**
+   *  - **base** - The component's base wrapper, an `<terra-popup>` element.
+   * - **base__popup** - The popup's exported `popup` part. Use this to target the tooltip's popup container.
+   * - **base__arrow** - The popup's exported `arrow` part. Use this to target the tooltip's arrow.
+   * - **body** - The tooltip or popover body where its content is rendered.
+   */
+  "terra-tooltip": DefineComponent<TerraTooltipProps>;
 };
 
 declare module "vue" {