@nasa-terra/components 0.0.179 → 0.0.182

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

@@ -26,6 +26,7 @@ import type { TerraDivider } from "../../components/divider/divider.component.js
 import type { TerraDropdown } from "../../components/dropdown/dropdown.component.js";
 import type { TerraEarthdataLogin } from "../../components/earthdata-login/earthdata-login.component.js";
 import type { TerraFileUpload } from "../../components/file-upload/file-upload.component.js";
+import type { TerraHarmonyHistory } from "../../components/harmony-history/harmony-history.component.js";
 import type { TerraIcon } from "../../components/icon/icon.component.js";
 import type { TerraInput } from "../../components/input/input.component.js";
 import type { TerraLoader } from "../../components/loader/loader.component.js";
@@ -54,8 +55,8 @@ 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 { TerraTag } from "../../components/tag/tag.component.js";
 import type { TerraTextarea } from "../../components/textarea/textarea.component.js";
+import type { TerraTag } from "../../components/tag/tag.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";
@@ -809,6 +810,31 @@ type TerraFileUploadProps = {
   "onterra-blur"?: (e: CustomEvent<never>) => void;
 };
 
+type TerraHarmonyHistoryProps = {
+  /**  */
+  "bearer-token"?: TerraHarmonyHistory["bearerToken"];
+  /**  */
+  limit?: TerraHarmonyHistory["limit"];
+  /**  */
+  "filter-by-labels"?: TerraHarmonyHistory["filterByLabels"];
+  /** When true and `filter-by-labels` is set, clicking the delete button on a thumbnail
+will call the Harmony /labels DELETE endpoint to remove the active filter labels from
+that job (causing it to disappear from the filtered list). When false, a
+`terra-harmony-job-delete` event is emitted instead and the consumer handles deletion. */
+  "remove-labels-on-delete"?: TerraHarmonyHistory["removeLabelsOnDelete"];
+  /**  */
+  _authController?: TerraHarmonyHistory["_authController"];
+  /**  */
+  _removeLabelsOnDeleteMutation?: TerraHarmonyHistory["_removeLabelsOnDeleteMutation"];
+  /** Page 1 is always managed by this QueryController (includes polling for non-final jobs).
+Other pages are fetched imperatively via _fetchPage(). */
+  jobsQuery?: TerraHarmonyHistory["jobsQuery"];
+  /** Emitted when a thumbnail is clicked. */
+  "onterra-harmony-job-select"?: (e: CustomEvent<{ job: SubsetJobStatus }>) => void;
+  /** Emitted when the delete button on a thumbnail is clicked (only when `removeLabelsOnDelete` is false). */
+  "onterra-harmony-job-delete"?: (e: CustomEvent<{ jobId: string }>) => void;
+};
+
 type TerraIconProps = {
   /** The name of the icon to draw. Available names depend on the icon library being used. */
   name?: TerraIcon["name"];
@@ -1584,26 +1610,6 @@ 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"];
@@ -1661,6 +1667,26 @@ 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"];
@@ -1680,6 +1706,12 @@ type TerraTimeAverageMapProps = {
   "color-map-name"?: TerraTimeAverageMap["colorMapName"];
   /**  */
   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"];
   /**  */
   catalogVariable?: TerraTimeAverageMap["catalogVariable"];
   /**  */
@@ -1750,6 +1782,12 @@ The property's value will be inserted after "Bearer" (the authentication scheme)
   "hide-toolbar"?: TerraTimeSeries["hideToolbar"];
   /**  */
   "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"];
   /**  */
   plot?: TerraTimeSeries["plot"];
   /**  */
@@ -1863,6 +1901,9 @@ programmatically. */
 `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"];
   /**  */
@@ -2462,6 +2503,24 @@ export type CustomElements = {
    */
   "terra-file-upload": DefineComponent<TerraFileUploadProps>;
 
+  /**
+   * Displays a horizontal scrolling strip of a user's recent Harmony job requests,
+   * fetching additional pages on demand as the user scrolls.
+   * ---
+   *
+   *
+   * ### **Events:**
+   *  - **terra-harmony-job-select** - Emitted when a thumbnail is clicked.
+   * - **terra-harmony-job-delete** - Emitted when the delete button on a thumbnail is clicked (only when `removeLabelsOnDelete` is false).
+   *
+   * ### **CSS Parts:**
+   *  - **nav-button** - The left/right navigation arrow buttons.
+   * - **viewport** - The overflow-hidden container that clips the thumbnail track.
+   * - **track** - The inner flex container that translates to implement scrolling.
+   * - **thumbnail** - Each individual job thumbnail wrapper.
+   */
+  "terra-harmony-history": DefineComponent<TerraHarmonyHistoryProps>;
+
   /**
    * Icons are symbols that can be used to represent various options within an application.
    * ---
@@ -3049,6 +3108,35 @@ 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.
    * ---
@@ -3094,38 +3182,14 @@ 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>;
-
-  /**
-   *
-   * ---
-   *
+   *  - **captureMapThumbnail(thumbWidth, thumbHeight): _Promise<Blob | undefined>_** - Captures the current map view as a thumbnail Blob (JPEG, 200×200).
+   * Composites all OpenLayers canvas layers without text overlay or legend.
+   * Returns undefined if the map is not ready.
    */
   "terra-time-average-map": DefineComponent<TerraTimeAverageMapProps>;
 

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

@@ -2,29 +2,6 @@
   "$schema": "https://raw.githubusercontent.com/microsoft/vscode-html-languageservice/main/docs/customData.schema.json",
   "version": 1.1,
   "tags": [
-    {
-      "name": "terra-accordion",
-      "description": "A collapsible content panel for showing and hiding content.\n---\n\n\n### **Events:**\n - **terra-accordion-toggle** - emitted when the accordion opens or closes\n\n### **Slots:**\n - _default_ - The default slot for accordion content.\n- **summary** - The summary/header for the accordion (optional, overrides summary property)",
-      "attributes": [
-        {
-          "name": "summary",
-          "description": "The summary/header for the accordion. Use the property for simple text, or the slot for custom content.",
-          "values": []
-        },
-        {
-          "name": "open",
-          "description": "Whether the accordion is open or not. This property is reflected as an attribute and can be controlled programmatically or by user interaction.",
-          "values": []
-        },
-        { "name": "showArrow", "values": [] }
-      ],
-      "references": [
-        {
-          "name": "Documentation",
-          "url": "https://terra-ui.netlify.app/components/accordion"
-        }
-      ]
-    },
     {
       "name": "terra-alert",
       "description": "Alerts are used to display important messages inline or as toast notifications.\n---\n\n\n### **Events:**\n - **terra-show** - Emitted when the alert opens.\n- **terra-after-show** - Emitted after the alert opens and all animations are complete.\n- **terra-hide** - Emitted when the alert closes.\n- **terra-after-hide** - Emitted after the alert closes and all animations are complete.\n\n### **Methods:**\n - **show()** - Shows the alert.\n- **hide()** - Hides the alert\n- **toast()** - Displays the alert as a toast notification. This will move the alert out of its position in the DOM and, when\ndismissed, it will be removed from the DOM completely. By storing a reference to the alert, you can reuse it by\ncalling this method again. The returned promise will resolve after the alert is hidden.\n\n### **Slots:**\n - _default_ - The alert's main content.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **icon** - The container that wraps the optional icon.\n- **message** - The container that wraps the alert's main content.",
@@ -74,6 +51,29 @@
         }
       ]
     },
+    {
+      "name": "terra-accordion",
+      "description": "A collapsible content panel for showing and hiding content.\n---\n\n\n### **Events:**\n - **terra-accordion-toggle** - emitted when the accordion opens or closes\n\n### **Slots:**\n - _default_ - The default slot for accordion content.\n- **summary** - The summary/header for the accordion (optional, overrides summary property)",
+      "attributes": [
+        {
+          "name": "summary",
+          "description": "The summary/header for the accordion. Use the property for simple text, or the slot for custom content.",
+          "values": []
+        },
+        {
+          "name": "open",
+          "description": "Whether the accordion is open or not. This property is reflected as an attribute and can be controlled programmatically or by user interaction.",
+          "values": []
+        },
+        { "name": "showArrow", "values": [] }
+      ],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://terra-ui.netlify.app/components/accordion"
+        }
+      ]
+    },
     {
       "name": "terra-avatar",
       "description": "Avatars are used to represent a person or object.\n---\n\n\n### **Events:**\n - **terra-error** - The image could not be loaded. This may because of an invalid URL, a temporary network condition, or some unknown cause.\n\n### **Slots:**\n - **icon** - The default icon to use when no image or initials are present. Works best with `<terra-icon>`.\n\n### **CSS Properties:**\n - **--size** - The size of the avatar. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **icon** - The container that wraps the avatar's icon.\n- **initials** - The container that wraps the avatar's initials.\n- **image** - The avatar image. Only shown when the `image` attribute is set.",
@@ -1014,6 +1014,26 @@
         }
       ]
     },
+    {
+      "name": "terra-harmony-history",
+      "description": "Displays a horizontal scrolling strip of a user's recent Harmony job requests,\nfetching additional pages on demand as the user scrolls.\n---\n\n\n### **Events:**\n - **terra-harmony-job-select** - Emitted when a thumbnail is clicked.\n- **terra-harmony-job-delete** - Emitted when the delete button on a thumbnail is clicked (only when `removeLabelsOnDelete` is false).\n\n### **CSS Parts:**\n - **nav-button** - The left/right navigation arrow buttons.\n- **viewport** - The overflow-hidden container that clips the thumbnail track.\n- **track** - The inner flex container that translates to implement scrolling.\n- **thumbnail** - Each individual job thumbnail wrapper.",
+      "attributes": [
+        { "name": "bearer-token", "values": [] },
+        { "name": "limit", "values": [] },
+        { "name": "filter-by-labels", "values": [] },
+        {
+          "name": "remove-labels-on-delete",
+          "description": "When true and `filter-by-labels` is set, clicking the delete button on a thumbnail\nwill call the Harmony /labels DELETE endpoint to remove the active filter labels from\nthat job (causing it to disappear from the filtered list). When false, a\n`terra-harmony-job-delete` event is emitted instead and the consumer handles deletion.",
+          "values": []
+        }
+      ],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://terra-ui.netlify.app/components/harmony-history"
+        }
+      ]
+    },
     {
       "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.",
@@ -2340,7 +2360,7 @@
     },
     {
       "name": "terra-time-average-map",
-      "description": "\n---\n",
+      "description": "\n---\n\n\n### **Methods:**\n - **captureMapThumbnail(thumbWidth, thumbHeight): _Promise<Blob | undefined>_** - Captures the current map view as a thumbnail Blob (JPEG, 200×200).\nComposites all OpenLayers canvas layers without text overlay or legend.\nReturns undefined if the map is not ready.",
       "attributes": [
         { "name": "collection", "values": [] },
         { "name": "variable", "values": [] },
@@ -2350,7 +2370,17 @@
         { "name": "bearer-token", "values": [] },
         { "name": "long_name", "values": [] },
         { "name": "color-map-name", "values": [] },
-        { "name": "opacity", "values": [] }
+        { "name": "opacity", "values": [] },
+        {
+          "name": "application-id",
+          "description": "the application ID is used for tracking purposes and will be included in the labels of Harmony jobs created by this component",
+          "values": []
+        },
+        {
+          "name": "no-cache",
+          "description": "When true, disables IndexedDB caching entirely — data will not be read from or written to the local cache.\nHarmony history is still checked before creating a new request.\nUseful for applications that always want a fresh server-side request (e.g., Giovanni).",
+          "values": []
+        }
       ],
       "references": [
         {
@@ -2416,7 +2446,17 @@
         },
         { "name": "mobile-view", "values": [] },
         { "name": "hide-toolbar", "values": [] },
-        { "name": "product-label", "values": [] }
+        { "name": "product-label", "values": [] },
+        {
+          "name": "application-id",
+          "description": "the application ID is used for tracking purposes and will be included in the labels of Harmony jobs created by this component",
+          "values": []
+        },
+        {
+          "name": "no-cache",
+          "description": "When true, disables IndexedDB caching entirely — data will not be read from or written to the local cache.\nHarmony history is still checked before creating a new request.\nUseful for applications that always want a fresh server-side request (e.g., Giovanni).",
+          "values": []
+        }
       ],
       "references": [
         {
@@ -2583,6 +2623,11 @@
           "name": "hoist",
           "description": "Enable this option to prevent the tooltip from being clipped when the component is placed inside a container with\n`overflow: auto|hidden|scroll`. Hoisting uses a fixed positioning strategy that works in many, but not all,\nscenarios.",
           "values": []
+        },
+        {
+          "name": "interactive",
+          "description": "Allows text inside the tooltip to be selected and copied. Also enables pointer events on the tooltip body\nso the user can interact with its content.",
+          "values": []
         }
       ],
       "references": [