@nasa-terra/components 0.0.185 → 0.0.186

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

@@ -4,6 +4,7 @@ import type { TerraAccordion } from "../../components/accordion/accordion.compon
 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 { TerraBanner } from "../../components/banner/banner.component.js";
 import type { TerraBreadcrumb } from "../../components/breadcrumb/breadcrumb.component.js";
 import type { TerraBreadcrumbs } from "../../components/breadcrumbs/breadcrumbs.component.js";
 import type { TerraBrowseVariables } from "../../components/browse-variables/browse-variables.component.js";
@@ -134,6 +135,28 @@ type TerraBadgeProps = {
   pulse?: TerraBadge["pulse"];
 };
 
+type TerraBannerProps = {
+  /** Indicates whether or not the banner is open. You can toggle this attribute to show and hide the banner, or you can
+use the `show()` and `hide()` methods and this attribute will reflect the banner's open state. */
+  open?: TerraBanner["open"];
+  /** Enables a close button that allows the user to dismiss the banner. */
+  closable?: TerraBanner["closable"];
+  /** The banner's theme variant. */
+  variant?: TerraBanner["variant"];
+  /**  */
+  sticky?: TerraBanner["sticky"];
+  /**  */
+  base?: TerraBanner["base"];
+  /** Emitted when the banner opens. */
+  "onterra-show"?: (e: CustomEvent<never>) => void;
+  /** Emitted after the banner opens and all animations are complete. */
+  "onterra-after-show"?: (e: CustomEvent<never>) => void;
+  /** Emitted when the banner closes. */
+  "onterra-hide"?: (e: CustomEvent<never>) => void;
+  /** Emitted after the banner closes and all animations are complete. */
+  "onterra-after-hide"?: (e: CustomEvent<never>) => void;
+};
+
 type TerraBreadcrumbProps = {
   /** The URL the breadcrumb points to. When omitted, the breadcrumb is rendered as plain text. */
   href?: TerraBreadcrumb["href"];
@@ -551,6 +574,8 @@ this prop allows you to override that behavior and always show the history panel
   /**  */
   subsetter?: TerraDataSubsetterHistory["subsetter"];
   /**  */
+  jobsQuery?: TerraDataSubsetterHistory["jobsQuery"];
+  /**  */
   _authController?: TerraDataSubsetterHistory["_authController"];
 };
 
@@ -610,6 +635,8 @@ type TerraDatePickerProps = {
   /**  */
   "use-end-of-day"?: TerraDatePicker["useEndOfDay"];
   /**  */
+  closable?: TerraDatePicker["showClose"];
+  /**  */
   isOpen?: TerraDatePicker["isOpen"];
   /**  */
   leftMonth?: TerraDatePicker["leftMonth"];
@@ -1033,9 +1060,7 @@ Format: 'west, south, east, north' */
   /**  */
   shapeLoading?: TerraMap["shapeLoading"];
   /** List of geojson shapes */
-  shapes?: TerraMap["shapes"];
-  /**  */
-  _mapController?: TerraMap["_mapController"];
+  shapesQuery?: TerraMap["shapesQuery"];
 };
 
 type TerraMenuProps = {
@@ -1064,8 +1089,7 @@ type TerraMenuItemProps = {
 
 type TerraOptionProps = {
   /** The option's value. When selected, the containing form control will receive this value. The value must be unique
-from other options in the same group. Values may not contain spaces, as spaces are used as delimiters when listing
-multiple values. */
+from other options in the same group. */
   value?: TerraOption["value"];
   /** Draws the option in a disabled state, preventing selection. */
   disabled?: TerraOption["disabled"];
@@ -1139,6 +1163,8 @@ type TerraPlotToolbarProps = {
   opacity?: TerraPlotToolbar["opacity"];
   /**  */
   "show-citation"?: TerraPlotToolbar["showCitation"];
+  /**  */
+  "show-help"?: TerraPlotToolbar["showHelp"];
   /** if you include an application citation, it will be displayed in the citation panel alongside the dataset citation */
   "application-citation"?: TerraPlotToolbar["applicationCitation"];
   /**  */
@@ -1152,8 +1178,6 @@ type TerraPlotToolbarProps = {
   /**  */
   activeMenuItem?: TerraPlotToolbar["activeMenuItem"];
   /**  */
-  showLocationTooltip?: TerraPlotToolbar["showLocationTooltip"];
-  /**  */
   menu?: TerraPlotToolbar["menu"];
   /**  */
   _authController?: TerraPlotToolbar["_authController"];
@@ -1525,6 +1549,8 @@ Draws a visual overlay on the map and rejects draws outside this area. */
   "url-state"?: TerraSpatialPicker["urlState"];
   /**  */
   "help-text"?: TerraSpatialPicker["helpText"];
+  /** Whether to show a close button in the dropdown header (only applies when inline is false) */
+  closable?: TerraSpatialPicker["showClose"];
   /**  */
   error?: TerraSpatialPicker["error"];
   /**  */
@@ -1714,6 +1740,8 @@ Defaults to false, meaning no caching is performed. */
   /** If provided, skips creating a new Harmony job and instead waits for this existing job ID to complete. */
   "job-id"?: TerraTimeAverageMap["jobId"];
   /**  */
+  "show-help"?: TerraTimeAverageMap["showHelp"];
+  /**  */
   catalogVariable?: TerraTimeAverageMap["catalogVariable"];
   /**  */
   pixelValue?: TerraTimeAverageMap["pixelValue"];
@@ -1768,6 +1796,8 @@ Or the bounding box in "west,south,east,north" format. */
   location?: TerraTimeSeries["location"];
   /**  */
   "show-citation"?: TerraTimeSeries["showCitation"];
+  /**  */
+  "show-help"?: TerraTimeSeries["showHelp"];
   /** if you include an application citation, it will be displayed in the citation panel alongside the dataset citation */
   "application-citation"?: TerraTimeSeries["applicationCitation"];
   /** When true, disables automatic data fetching when the user zooms, pans, or otherwise interacts with the plot.
@@ -2060,6 +2090,31 @@ export type CustomElements = {
    */
   "terra-badge": DefineComponent<TerraBadgeProps>;
 
+  /**
+   * Banners are used to display important messages on top of the header.
+   * ---
+   *
+   *
+   * ### **Events:**
+   *  - **terra-show** - Emitted when the banner opens.
+   * - **terra-after-show** - Emitted after the banner opens and all animations are complete.
+   * - **terra-hide** - Emitted when the banner closes.
+   * - **terra-after-hide** - Emitted after the banner closes and all animations are complete.
+   *
+   * ### **Methods:**
+   *  - **show()** - Shows the banner.
+   * - **hide()** - Hides the banner
+   *
+   * ### **Slots:**
+   *  - _default_ - The banner's main content.
+   *
+   * ### **CSS Parts:**
+   *  - **base** - The component's base wrapper.
+   * - **icon** - The container that wraps the optional icon.
+   * - **message** - The container that wraps the banner's main content.
+   */
+  "terra-banner": DefineComponent<TerraBannerProps>;
+
   /**
    * A single breadcrumb item used inside `terra-breadcrumbs`.
    * ---

package/cdn/utilities/granule.d.ts

@@ -0,0 +1,9 @@
+import type { CmrGranule, CmrGranuleDataGranule } from '../apis/cmr.api.js';
+export declare function getGranuleUrl(granule: CmrGranule): string | undefined;
+export declare function formatGranuleSize(sizeInMB: number): string;
+export declare function calculateMeanGranuleSize(granules: {
+    dataGranule: CmrGranuleDataGranule;
+}[]): number;
+export declare function calculateGranuleSize(granule: {
+    dataGranule: CmrGranuleDataGranule;
+}, unit: 'MB' | 'GB' | 'TB' | 'PB'): number;

package/cdn/utilities/granule.js

@@ -0,0 +1,76 @@
+import {
+  init_buffer,
+  init_dirname,
+  init_process
+} from "../chunks/chunk.ZEOVK2FE.js";
+
+// src/utilities/granule.ts
+init_dirname();
+init_buffer();
+init_process();
+function getGranuleUrl(granule) {
+  const getDataUrl = granule.relatedUrls.find((url) => url.type === "GET DATA");
+  return getDataUrl == null ? void 0 : getDataUrl.url;
+}
+function formatGranuleSize(sizeInMB) {
+  const UNITS = ["MB", "GB", "TB", "PB"];
+  const THRESHOLD = 1e3;
+  let size = sizeInMB;
+  let unitIndex = 0;
+  while (size >= THRESHOLD && unitIndex < UNITS.length - 1) {
+    size /= 1024;
+    unitIndex++;
+  }
+  const decimals = size >= 100 ? 0 : size >= 10 ? 1 : 2;
+  return `${size.toFixed(decimals)} ${UNITS[unitIndex]}`;
+}
+function calculateMeanGranuleSize(granules) {
+  const sizes = granules.map((granule) => calculateGranuleSize(granule, "MB"));
+  return sizes.reduce((a, b) => a + b, 0) / sizes.length;
+}
+function calculateGranuleSize(granule, unit) {
+  const archiveInfo = granule.dataGranule.archiveAndDistributionInformation;
+  if (!archiveInfo || !Array.isArray(archiveInfo)) {
+    return 0;
+  }
+  const BYTES_PER_UNIT = {
+    KB: 1024,
+    MB: 1024 * 1024,
+    GB: 1024 * 1024 * 1024,
+    TB: 1024 * 1024 * 1024 * 1024,
+    PB: 1024 * 1024 * 1024 * 1024 * 1024,
+    NA: 0
+  };
+  let totalBytes = 0;
+  function processItem(item) {
+    if (item.sizeInBytes != null) {
+      return item.sizeInBytes;
+    }
+    if (item.size != null && item.sizeUnit) {
+      const conversionFactor = BYTES_PER_UNIT[item.sizeUnit];
+      if (conversionFactor) {
+        return item.size * conversionFactor;
+      }
+    }
+    return 0;
+  }
+  function processFilePackageOrFile(item) {
+    let itemBytes = processItem(item);
+    if (item.files && Array.isArray(item.files)) {
+      for (const file of item.files) {
+        itemBytes += processItem(file);
+      }
+    }
+    return itemBytes;
+  }
+  for (const item of archiveInfo) {
+    totalBytes += processFilePackageOrFile(item);
+  }
+  return totalBytes / BYTES_PER_UNIT[unit];
+}
+export {
+  calculateGranuleSize,
+  calculateMeanGranuleSize,
+  formatGranuleSize,
+  getGranuleUrl
+};

package/cdn/utilities/harmony.d.ts

@@ -1,5 +1,5 @@
 import type { TemplateResult } from 'lit';
-import type { SubsetJobError } from '../data-services/types.js';
+import type { SubsetJobError } from '../apis/harmony.api.js';
 export interface HarmonyErrorDetails {
     status: number;
     code: string;
@@ -14,7 +14,7 @@ export interface HarmonyError {
 }
 /**
  * Checks if an error indicates a user cancellation by checking the error message
- * and nested error structures (like Apollo's cause/networkError)
+ * and nested error structures
  * @param error - The error to check
  * @returns true if the error indicates a user cancellation
  */

package/cdn/utilities/harmony.js

@@ -2,7 +2,7 @@ import {
   extractHarmonyError,
   formatHarmonyErrorMessage,
   isCancellationError
-} from "../chunks/chunk.3TKV2VNC.js";
+} from "../chunks/chunk.F3PALOOP.js";
 import "../chunks/chunk.RRCYT4LP.js";
 import "../chunks/chunk.JS5TDQ5C.js";
 import "../chunks/chunk.ZEOVK2FE.js";

package/cdn/utilities/icon-library.js

@@ -2,9 +2,9 @@ import "../chunks/chunk.TDO35TAG.js";
 import {
   registerIconLibrary,
   unregisterIconLibrary
-} from "../chunks/chunk.WFSXAREE.js";
-import "../chunks/chunk.BQUO6YX3.js";
+} from "../chunks/chunk.AHX4FQI7.js";
 import "../chunks/chunk.NWENTFAC.js";
+import "../chunks/chunk.BQUO6YX3.js";
 import "../chunks/chunk.ZQVMOVOT.js";
 import "../chunks/chunk.ZEOVK2FE.js";
 export {

package/cdn/utilities/variable-task.d.ts

@@ -0,0 +1,3 @@
+import { Task } from '@lit/task';
+import type { HostWithMaybeProperties } from './variable.js';
+export declare function getFetchVariableTask(host: HostWithMaybeProperties, autoRun?: boolean): Task<readonly [string | undefined, string | undefined, string | undefined, string | undefined], void>;

package/cdn/utilities/variable-task.js

@@ -0,0 +1,17 @@
+import {
+  getFetchVariableTask
+} from "../chunks/chunk.YQXMPDBV.js";
+import "../chunks/chunk.QS6LI65N.js";
+import "../chunks/chunk.BQDEKCXK.js";
+import "../chunks/chunk.TKSEPVAL.js";
+import "../chunks/chunk.KNUKVURG.js";
+import "../chunks/chunk.ND3745YQ.js";
+import "../chunks/chunk.SYQOGYTQ.js";
+import "../chunks/chunk.EYYVMPBZ.js";
+import "../chunks/chunk.7NJYVBGM.js";
+import "../chunks/chunk.5RRKLQ53.js";
+import "../chunks/chunk.JS5TDQ5C.js";
+import "../chunks/chunk.ZEOVK2FE.js";
+export {
+  getFetchVariableTask
+};

package/cdn/utilities/variable.d.ts

@@ -0,0 +1,14 @@
+import type { ReactiveControllerHost } from 'lit';
+import type { Variable } from '../components/browse-variables/browse-variables.types.js';
+export type HostWithMaybeProperties = ReactiveControllerHost & {
+    variableEntryId?: string;
+    variableEntryIds?: string[];
+    collection?: string;
+    variable?: string;
+    startDate?: string;
+    endDate?: string;
+    catalogVariable?: Variable;
+    catalogVariables?: Variable[];
+};
+export declare function getVariableEntryId(host: HostWithMaybeProperties): string | undefined;
+export declare function getVariableEntryIds(host: HostWithMaybeProperties): string[];

package/cdn/utilities/variable.js

@@ -0,0 +1,9 @@
+import {
+  getVariableEntryId,
+  getVariableEntryIds
+} from "../chunks/chunk.QS6LI65N.js";
+import "../chunks/chunk.ZEOVK2FE.js";
+export {
+  getVariableEntryId,
+  getVariableEntryIds
+};

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

@@ -150,6 +150,38 @@
         }
       ]
     },
+    {
+      "name": "terra-banner",
+      "description": "Banners are used to display important messages on top of the header.\n---\n\n\n### **Events:**\n - **terra-show** - Emitted when the banner opens.\n- **terra-after-show** - Emitted after the banner opens and all animations are complete.\n- **terra-hide** - Emitted when the banner closes.\n- **terra-after-hide** - Emitted after the banner closes and all animations are complete.\n\n### **Methods:**\n - **show()** - Shows the banner.\n- **hide()** - Hides the banner\n\n### **Slots:**\n - _default_ - The banner'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 banner's main content.",
+      "attributes": [
+        {
+          "name": "open",
+          "description": "Indicates whether or not the banner is open. You can toggle this attribute to show and hide the banner, or you can\nuse the `show()` and `hide()` methods and this attribute will reflect the banner's open state.",
+          "values": []
+        },
+        {
+          "name": "closable",
+          "description": "Enables a close button that allows the user to dismiss the banner.",
+          "values": []
+        },
+        {
+          "name": "variant",
+          "description": "The banner's theme variant.",
+          "values": [
+            { "name": "primary" },
+            { "name": "neutral" },
+            { "name": "danger" }
+          ]
+        },
+        { "name": "sticky", "values": [] }
+      ],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://terra-ui.netlify.app/components/banner"
+        }
+      ]
+    },
     {
       "name": "terra-breadcrumb",
       "description": "A single breadcrumb item used inside `terra-breadcrumbs`.\n---\n\n\n### **Slots:**\n - _default_ - The default slot.\n\n### **CSS Properties:**\n - **--terra-breadcrumb-color** - The text color of inactive breadcrumbs. _(default: undefined)_\n- **--terra-breadcrumb-color-current** - The text color of the current (last) breadcrumb. _(default: undefined)_\n- **--terra-breadcrumb-color-visited** - The text color of visited breadcrumb links. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **link** - The breadcrumb link element.\n- **label** - The breadcrumb label element when not a link.",
@@ -779,7 +811,8 @@
         },
         { "name": "hideClearAll", "values": [] },
         { "name": "clearAllLabel", "values": [] },
-        { "name": "use-end-of-day", "values": [] }
+        { "name": "use-end-of-day", "values": [] },
+        { "name": "closable", "values": [] }
       ],
       "references": [
         {
@@ -1352,7 +1385,7 @@
       "attributes": [
         {
           "name": "value",
-          "description": "The option's value. When selected, the containing form control will receive this value. The value must be unique\nfrom other options in the same group. Values may not contain spaces, as spaces are used as delimiters when listing\nmultiple values.",
+          "description": "The option's value. When selected, the containing form control will receive this value. The value must be unique\nfrom other options in the same group.",
           "values": []
         },
         {
@@ -1446,6 +1479,7 @@
         { "name": "color-map-name", "values": [] },
         { "name": "opacity", "values": [] },
         { "name": "show-citation", "values": [] },
+        { "name": "show-help", "values": [] },
         {
           "name": "application-citation",
           "description": "if you include an application citation, it will be displayed in the citation panel alongside the dataset citation",
@@ -1616,6 +1650,46 @@
         }
       ]
     },
+    {
+      "name": "terra-progress-bar",
+      "description": "Progress bars are used to show the status of an ongoing operation.\n---\n\n\n### **Slots:**\n - _default_ - A label to show inside the progress indicator.\n\n### **CSS Properties:**\n - **--height** - The progress bar's height. _(default: undefined)_\n- **--track-color** - The color of the track. _(default: undefined)_\n- **--indicator-color** - The color of the indicator. _(default: undefined)_\n- **--label-color** - The color of the label. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **indicator** - The progress bar's indicator.\n- **label** - The progress bar's label.",
+      "attributes": [
+        {
+          "name": "value",
+          "description": "The current progress as a percentage, 0 to 100.",
+          "values": []
+        },
+        {
+          "name": "indeterminate",
+          "description": "When true, percentage is ignored, the label is hidden, and the progress bar is drawn in an indeterminate state.",
+          "values": []
+        },
+        {
+          "name": "label",
+          "description": "A custom label for assistive devices.",
+          "values": []
+        },
+        {
+          "name": "variant",
+          "description": "The progress bar's theme variant.",
+          "values": [
+            { "name": "" },
+            { "name": "default" },
+            { "name": "primary" },
+            { "name": "success" },
+            { "name": "warning" },
+            { "name": "danger" }
+          ]
+        },
+        { "name": "title", "values": [] }
+      ],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://terra-ui.netlify.app/components/progress-bar"
+        }
+      ]
+    },
     {
       "name": "terra-radio",
       "description": "Radio buttons are a form field used when only a single selection can be made from a list.\n---\n\n\n### **Events:**\n - **terra-blur** - Emitted when the radio loses focus.\n- **terra-change** - Emitted when the checked state changes.\n- **terra-focus** - Emitted when the radio gains focus.\n- **terra-input** - Emitted when the radio receives input.\n- **terra-invalid** - Emitted when the form control has been checked for validity and its constraints aren't satisfied.\n\n### **Methods:**\n - **click()** - Simulates a click on the radio.\n- **focus(options: _FocusOptions_)** - Sets focus on the radio.\n- **blur()** - Removes focus from the radio.\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. The value provided will be shown to the user when the form is submitted. To clear\nthe custom validation message, call this method with an empty string.\n\n### **Slots:**\n - _default_ - The radio's label.\n\n### **CSS Properties:**\n - **--terra-radio-*** - All radio design tokens from horizon.css are supported. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **control** - The circular container that wraps the radio's checked state.\n- **control--checked** - The radio control when the radio is checked.\n- **checked-icon** - The checked icon, an SVG element.\n- **label** - The container that wraps the radio's label.",
@@ -1668,46 +1742,6 @@
         }
       ]
     },
-    {
-      "name": "terra-progress-bar",
-      "description": "Progress bars are used to show the status of an ongoing operation.\n---\n\n\n### **Slots:**\n - _default_ - A label to show inside the progress indicator.\n\n### **CSS Properties:**\n - **--height** - The progress bar's height. _(default: undefined)_\n- **--track-color** - The color of the track. _(default: undefined)_\n- **--indicator-color** - The color of the indicator. _(default: undefined)_\n- **--label-color** - The color of the label. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **indicator** - The progress bar's indicator.\n- **label** - The progress bar's label.",
-      "attributes": [
-        {
-          "name": "value",
-          "description": "The current progress as a percentage, 0 to 100.",
-          "values": []
-        },
-        {
-          "name": "indeterminate",
-          "description": "When true, percentage is ignored, the label is hidden, and the progress bar is drawn in an indeterminate state.",
-          "values": []
-        },
-        {
-          "name": "label",
-          "description": "A custom label for assistive devices.",
-          "values": []
-        },
-        {
-          "name": "variant",
-          "description": "The progress bar's theme variant.",
-          "values": [
-            { "name": "" },
-            { "name": "default" },
-            { "name": "primary" },
-            { "name": "success" },
-            { "name": "warning" },
-            { "name": "danger" }
-          ]
-        },
-        { "name": "title", "values": [] }
-      ],
-      "references": [
-        {
-          "name": "Documentation",
-          "url": "https://terra-ui.netlify.app/components/progress-bar"
-        }
-      ]
-    },
     {
       "name": "terra-radio-group",
       "description": "Radio groups are used to group multiple radio buttons so they function as a single form control.\n---\n\n\n### **Events:**\n - **terra-change** - Emitted when the radio group's selected value changes.\n- **terra-input** - Emitted when the radio group receives user input.\n- **terra-invalid** - Emitted when the form control has been checked for validity and its constraints aren't satisfied.\n\n### **Methods:**\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(): _boolean_** - Checks for validity and shows the browser's validation message if the control is invalid.\n- **setCustomValidity(message)** - Sets a custom validation message. Pass an empty string to restore validity.\n- **focus(options: _FocusOptions_)** - Sets focus on the radio-group.\n\n### **Slots:**\n - _default_ - The default slot where `<terra-radio>` elements are placed.\n- **label** - The radio group's label. Required for proper accessibility. Alternatively, you can use the `label` attribute.\n- **help-text** - Text that describes how to use the radio group. Alternatively, you can use the `help-text` attribute.\n\n### **CSS Properties:**\n - **--terra-radio-group-*** - All radio group design tokens from horizon.css are supported. _(default: undefined)_\n\n### **CSS Parts:**\n - **form-control** - The form control that wraps the label, input, and help text.\n- **form-control-label** - The label's wrapper.\n- **form-control-input** - The input's wrapper.\n- **form-control-help-text** - The help text's wrapper.",
@@ -2077,7 +2111,12 @@
         { "name": "inline", "values": [] },
         { "name": "show-map-on-focus", "values": [] },
         { "name": "url-state", "values": [] },
-        { "name": "help-text", "values": [] }
+        { "name": "help-text", "values": [] },
+        {
+          "name": "closable",
+          "description": "Whether to show a close button in the dropdown header (only applies when inline is false)",
+          "values": []
+        }
       ],
       "references": [
         {
@@ -2385,7 +2424,8 @@
           "name": "job-id",
           "description": "If provided, skips creating a new Harmony job and instead waits for this existing job ID to complete.",
           "values": []
-        }
+        },
+        { "name": "show-help", "values": [] }
       ],
       "references": [
         {
@@ -2434,6 +2474,7 @@
           "values": []
         },
         { "name": "show-citation", "values": [] },
+        { "name": "show-help", "values": [] },
         {
           "name": "application-citation",
           "description": "if you include an application citation, it will be displayed in the citation panel alongside the dataset citation",