@nasa-terra/components 0.0.189 → 0.0.192

package/dist/web-types.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://raw.githubusercontent.com/JetBrains/web-types/master/schema/web-types.json",
   "name": "@nasa-terra/components",
-  "version": "0.0.189",
+  "version": "0.0.192",
   "description-markup": "markdown",
   "contributions": {
     "html": {
@@ -83,14 +83,17 @@
               "name": "variant",
               "description": "The alert's theme variant.",
               "value": {
-                "type": "| 'primary'\n        | 'success'\n        | 'neutral'\n        | 'warning'\n        | 'danger'",
-                "default": "'primary'"
+                "type": "| 'primary'\n        | 'information'\n        | 'success'\n        | 'neutral'\n        | 'warning'\n        | 'danger'",
+                "default": "'information'"
               }
             },
             {
               "name": "appearance",
-              "description": "The alert's appearance style. \"filled\" uses a colored background with white text (HDS default).\n\"white\" uses a white background with a colored top border and dark text.",
-              "value": { "type": "'filled' | 'white'", "default": "'filled'" }
+              "description": "The alert's appearance style. \"filled\" uses a colored background with contrast appropriate text (HDS default).\n\"white\" uses a white background with a colored top border and dark text. \"subtle\" uses muted colored backgrounds\nand matching colored text.",
+              "value": {
+                "type": "'filled' | 'white' | 'subtle'",
+                "default": "'filled'"
+              }
             },
             {
               "name": "duration",
@@ -139,12 +142,12 @@
               {
                 "name": "variant",
                 "description": "The alert's theme variant.",
-                "type": "| 'primary'\n        | 'success'\n        | 'neutral'\n        | 'warning'\n        | 'danger'"
+                "type": "| 'primary'\n        | 'information'\n        | 'success'\n        | 'neutral'\n        | 'warning'\n        | 'danger'"
               },
               {
                 "name": "appearance",
-                "description": "The alert's appearance style. \"filled\" uses a colored background with white text (HDS default).\n\"white\" uses a white background with a colored top border and dark text.",
-                "type": "'filled' | 'white'"
+                "description": "The alert's appearance style. \"filled\" uses a colored background with contrast appropriate text (HDS default).\n\"white\" uses a white background with a colored top border and dark text. \"subtle\" uses muted colored backgrounds\nand matching colored text.",
+                "type": "'filled' | 'white' | 'subtle'"
               },
               {
                 "name": "duration",
@@ -267,8 +270,8 @@
               "name": "variant",
               "description": "The badge's theme variant.",
               "value": {
-                "type": "| 'primary'\n        | 'success'\n        | 'neutral'\n        | 'warning'\n        | 'info'\n        | 'danger'",
-                "default": "'primary'"
+                "type": "| 'primary'\n        | 'information'\n        | 'success'\n        | 'neutral'\n        | 'warning'\n        | 'danger'",
+                "default": "'information'"
               }
             },
             {
@@ -289,7 +292,7 @@
               {
                 "name": "variant",
                 "description": "The badge's theme variant.",
-                "type": "| 'primary'\n        | 'success'\n        | 'neutral'\n        | 'warning'\n        | 'info'\n        | 'danger'"
+                "type": "| 'primary'\n        | 'information'\n        | 'success'\n        | 'neutral'\n        | 'warning'\n        | 'danger'"
               },
               {
                 "name": "pill",
@@ -394,40 +397,6 @@
             ]
           }
         },
-        {
-          "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.",
-          "doc-url": "",
-          "attributes": [
-            {
-              "name": "href",
-              "description": "The URL the breadcrumb points to. When omitted, the breadcrumb is rendered as plain text.",
-              "value": { "type": "string | undefined" }
-            },
-            {
-              "name": "current",
-              "description": "Indicates that this breadcrumb represents the current page.\nWhen set, `aria-current=\"page\"` will be applied to the underlying element.",
-              "value": { "type": "boolean", "default": "false" }
-            }
-          ],
-          "slots": [{ "name": "", "description": "The default slot." }],
-          "events": [],
-          "js": {
-            "properties": [
-              {
-                "name": "href",
-                "description": "The URL the breadcrumb points to. When omitted, the breadcrumb is rendered as plain text.",
-                "type": "string | undefined"
-              },
-              {
-                "name": "current",
-                "description": "Indicates that this breadcrumb represents the current page.\nWhen set, `aria-current=\"page\"` will be applied to the underlying element.",
-                "type": "boolean"
-              }
-            ],
-            "events": []
-          }
-        },
         {
           "name": "terra-breadcrumbs",
           "description": "A collection of breadcrumb items that shows the current page's location in the site hierarchy.\n---\n\n\n### **Slots:**\n - _default_ - The breadcrumb items. Typically `<terra-breadcrumb>` elements.\n\n### **CSS Properties:**\n - **--terra-breadcrumbs-gap** - The space between breadcrumbs. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **nav** - The navigation container.",
@@ -467,6 +436,40 @@
             "events": []
           }
         },
+        {
+          "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-text-default** - The text color of inactive breadcrumbs. _(default: undefined)_\n- **--terra-breadcrumb-text-current** - The text color of the current (last) breadcrumb. _(default: undefined)_\n- **--terra-breadcrumb-text-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.",
+          "doc-url": "",
+          "attributes": [
+            {
+              "name": "href",
+              "description": "The URL the breadcrumb points to. When omitted, the breadcrumb is rendered as plain text.",
+              "value": { "type": "string | undefined" }
+            },
+            {
+              "name": "current",
+              "description": "Indicates that this breadcrumb represents the current page.\nWhen set, `aria-current=\"page\"` will be applied to the underlying element.",
+              "value": { "type": "boolean", "default": "false" }
+            }
+          ],
+          "slots": [{ "name": "", "description": "The default slot." }],
+          "events": [],
+          "js": {
+            "properties": [
+              {
+                "name": "href",
+                "description": "The URL the breadcrumb points to. When omitted, the breadcrumb is rendered as plain text.",
+                "type": "string | undefined"
+              },
+              {
+                "name": "current",
+                "description": "Indicates that this breadcrumb represents the current page.\nWhen set, `aria-current=\"page\"` will be applied to the underlying element.",
+                "type": "boolean"
+              }
+            ],
+            "events": []
+          }
+        },
         {
           "name": "terra-browse-variables",
           "description": "Browse through the NASA CMR or Giovanni catalogs.\n---\n",
@@ -512,7 +515,7 @@
               "name": "variant",
               "description": "The button's theme variant.",
               "value": {
-                "type": "| 'default'\n        | 'primary'\n        | 'success'\n        | 'warning'\n        | 'danger'\n        | 'text'\n        | 'pagelink'",
+                "type": "| 'default'\n        | 'primary'\n        | 'cta'\n        | 'success'\n        | 'warning'\n        | 'danger'\n        | 'text'\n        | 'pagelink'",
                 "default": "'primary'"
               }
             },
@@ -669,7 +672,7 @@
               {
                 "name": "variant",
                 "description": "The button's theme variant.",
-                "type": "| 'default'\n        | 'primary'\n        | 'success'\n        | 'warning'\n        | 'danger'\n        | 'text'\n        | 'pagelink'"
+                "type": "| 'default'\n        | 'primary'\n        | 'cta'\n        | 'success'\n        | 'warning'\n        | 'danger'\n        | 'text'\n        | 'pagelink'"
               },
               {
                 "name": "size",
@@ -838,20 +841,6 @@
             "events": []
           }
         },
-        {
-          "name": "terra-caption",
-          "description": "Captions are small text blocks that describe photos, provide additional context and information, and give credit to photographers and other content owners and creators.\n---\n\n\n### **Slots:**\n - _default_ - The caption content. Use a `<span class=\"credit\">` element for credits, which will be displayed with higher contrast.\n\n### **CSS Properties:**\n - **--terra-caption-font-family** - The font family for the caption. _(default: undefined)_\n- **--terra-caption-font-size** - The font size for the caption. _(default: undefined)_\n- **--terra-caption-font-weight** - The font weight for the caption. _(default: undefined)_\n- **--terra-caption-line-height** - The line height for the caption. _(default: undefined)_\n- **--terra-caption-color** - The text color for the caption. _(default: undefined)_\n- **--terra-caption-credit-color** - The text color for credits within the caption. _(default: undefined)_",
-          "doc-url": "",
-          "attributes": [],
-          "slots": [
-            {
-              "name": "",
-              "description": "The caption content. Use a `<span class=\"credit\">` element for credits, which will be displayed with higher contrast."
-            }
-          ],
-          "events": [],
-          "js": { "properties": [], "events": [] }
-        },
         {
           "name": "terra-card",
           "description": "Cards can be used to group related subjects in a container.\n---\n\n\n### **Slots:**\n - _default_ - The card's main content.\n- **header** - An optional header for the card.\n- **footer** - An optional footer for the card.\n- **image** - An optional image to render at the start of the card.\n\n### **CSS Properties:**\n - **--border-color** - The card's border color, including borders that occur inside the card. _(default: undefined)_\n- **--border-radius** - The border radius for the card's edges. _(default: undefined)_\n- **--border-width** - The width of the card's borders. _(default: undefined)_\n- **--padding** - The padding to use for the card's sections. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **image** - The container that wraps the card's image.\n- **header** - The container that wraps the card's header.\n- **body** - The container that wraps the card's main content.\n- **footer** - The container that wraps the card's footer.",
@@ -875,6 +864,20 @@
           "events": [],
           "js": { "properties": [], "events": [] }
         },
+        {
+          "name": "terra-caption",
+          "description": "Captions are small text blocks that describe photos, provide additional context and information, and give credit to photographers and other content owners and creators.\n---\n\n\n### **Slots:**\n - _default_ - The caption content. Use a `<span class=\"credit\">` element for credits, which will be displayed with higher contrast.\n\n### **CSS Properties:**\n - **--terra-caption-font-family** - The font family for the caption. _(default: undefined)_\n- **--terra-caption-font-size** - The font size for the caption. _(default: undefined)_\n- **--terra-caption-font-weight** - The font weight for the caption. _(default: undefined)_\n- **--terra-caption-line-height** - The line height for the caption. _(default: undefined)_\n- **--terra-caption-color** - The text color for the caption. _(default: undefined)_\n- **--terra-caption-credit-color** - The text color for credits within the caption. _(default: undefined)_",
+          "doc-url": "",
+          "attributes": [],
+          "slots": [
+            {
+              "name": "",
+              "description": "The caption content. Use a `<span class=\"credit\">` element for credits, which will be displayed with higher contrast."
+            }
+          ],
+          "events": [],
+          "js": { "properties": [], "events": [] }
+        },
         {
           "name": "terra-checkbox",
           "description": "Checkboxes are a form field used when there are multiple options to select from a list.\n---\n\n\n### **Events:**\n - **terra-blur** - Emitted when the checkbox loses focus.\n- **terra-change** - Emitted when the checked state changes.\n- **terra-focus** - Emitted when the checkbox gains focus.\n- **terra-input** - Emitted when the checkbox 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 checkbox.\n- **focus(options: _FocusOptions_)** - Sets focus on the checkbox.\n- **blur()** - Removes focus from the checkbox.\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 checkbox's label.\n- **help-text** - Text that describes how to use the checkbox. Alternatively, you can use the `help-text` attribute.\n\n### **CSS Properties:**\n - **--terra-checkbox-*** - All checkbox design tokens from horizon.css are supported. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **control** - The square container that wraps the checkbox's checked state.\n- **control--checked** - Matches the control part when the checkbox is checked.\n- **control--indeterminate** - Matches the control part when the checkbox is indeterminate.\n- **checked-icon** - The checked icon, an `<terra-icon>` element.\n- **indeterminate-icon** - The indeterminate icon, an `<terra-icon>` element.\n- **label** - The container that wraps the checkbox's label.\n- **form-control-help-text** - The help text's wrapper.",
@@ -1586,6 +1589,8 @@
                 "name": "spatialSelection",
                 "type": "LatLng | LatLngBounds | undefined"
               },
+              { "name": "shapeGeoJson", "type": "object | undefined" },
+              { "name": "spatialLabel", "type": "string | undefined" },
               {
                 "name": "selectedDateRange",
                 "type": "{ startDate: string | null; endDate: string | null }"
@@ -1773,6 +1778,16 @@
             {
               "name": "closable",
               "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "timezone",
+              "description": "IANA timezone identifier for display (e.g. 'America/New_York'). Affects time display only; internal values remain UTC.",
+              "value": { "type": "string | undefined" }
+            },
+            {
+              "name": "twelve-hour",
+              "description": "Display time in 12-hour format with AM/PM. Requires enable-time. Internal values remain UTC.",
+              "value": { "type": "boolean", "default": "false" }
             }
           ],
           "slots": [{ "name": "", "description": "The default slot." }],
@@ -1820,6 +1835,16 @@
               { "name": "clearAllLabel", "type": "string" },
               { "name": "useEndOfDay", "type": "boolean" },
               { "name": "showClose", "type": "boolean" },
+              {
+                "name": "timezone",
+                "description": "IANA timezone identifier for display (e.g. 'America/New_York'). Affects time display only; internal values remain UTC.",
+                "type": "string | undefined"
+              },
+              {
+                "name": "twelveHour",
+                "description": "Display time in 12-hour format with AM/PM. Requires enable-time. Internal values remain UTC.",
+                "type": "boolean"
+              },
               { "name": "isOpen", "type": "boolean" },
               { "name": "leftMonth", "type": "Date" },
               { "name": "rightMonth", "type": "Date" },
@@ -3215,7 +3240,7 @@
         },
         {
           "name": "terra-option",
-          "description": "Options define the selectable items within various form controls such as [select](/components/select).\n---\n\n\n### **Methods:**\n - **getTextLabel()** - Returns a plain text label based on the option's content.\n\n### **Slots:**\n - _default_ - The option's label.\n- **prefix** - Used to prepend an icon or similar element to the menu item.\n- **suffix** - Used to append an icon or similar element to the menu item.\n\n### **CSS Properties:**\n - **--terra-option-*** - All option design tokens from horizon.css are supported. _(default: undefined)_\n\n### **CSS Parts:**\n - **checked-icon** - The checked icon, an `<terra-icon>` element.\n- **base** - The component's base wrapper.\n- **label** - The option's label.\n- **prefix** - The container that wraps the prefix.\n- **suffix** - The container that wraps the suffix.",
+          "description": "Options define the selectable items within various form controls such as [select](/components/select).\n---\n\n\n### **Methods:**\n - **getTextLabel()** - Returns a plain text label based on the option's content.\n\n### **Slots:**\n - _default_ - The option's label.\n- **prefix** - Used to prepend an icon or similar element to the menu item.\n- **suffix** - Used to append an icon or similar element to the menu item.\n\n### **CSS Properties:**\n - **--terra-option-*** - All option design tokens from horizon.css are supported. _(default: undefined)_\n- **--terra-options-item-text** - The text color of the option. _(default: undefined)_\n- **--terra-options-item-text-hover** - The text color of the option on hover. _(default: undefined)_\n- **--terra-options-item-text-active** - The text color of the option when active. _(default: undefined)_\n- **--terra-options-item-background-hover** - The background color of the option on hover. _(default: undefined)_\n- **--terra-options-item-background-active** - The background color of the option when active. _(default: undefined)_\n\n### **CSS Parts:**\n - **checked-icon** - The checked icon, an `<terra-icon>` element.\n- **base** - The component's base wrapper.\n- **label** - The option's label.\n- **prefix** - The container that wraps the prefix.\n- **suffix** - The container that wraps the suffix.",
           "doc-url": "",
           "attributes": [
             {
@@ -3389,6 +3414,109 @@
             "events": []
           }
         },
+        {
+          "name": "terra-plot-toolbar",
+          "description": "Short summary of the component's intended use.\n---\n\n\n### **Slots:**\n - _default_ - The default slot.\n- **example** - An example slot.\n\n### **CSS Properties:**\n - **--terra-plot-toolbar-help-menu-display** - Controls the display of the help menu button. Set to `none` to hide it. Defaults to `flex`. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
+          "doc-url": "",
+          "attributes": [
+            { "name": "catalogVariable", "value": { "type": "Variable" } },
+            { "name": "variableEntryId", "value": { "type": "string" } },
+            { "name": "plot", "value": { "type": "TerraPlot | undefined" } },
+            {
+              "name": "timeSeriesData",
+              "value": { "type": "Partial<Plotly.Data>[] | Blob | undefined" }
+            },
+            { "name": "location", "value": { "type": "string" } },
+            { "name": "startDate", "value": { "type": "string" } },
+            { "name": "endDate", "value": { "type": "string" } },
+            { "name": "cacheKey", "value": { "type": "string" } },
+            { "name": "dataType", "value": { "type": "DataType" } },
+            {
+              "name": "show-location",
+              "value": { "type": "boolean", "default": "true" }
+            },
+            { "name": "show-date-range", "value": { "type": "boolean" } },
+            {
+              "name": "colormaps",
+              "value": { "type": "string[]", "default": "[]" }
+            },
+            {
+              "name": "color-map-name",
+              "value": { "type": "string", "default": "'viridis'" }
+            },
+            {
+              "name": "opacity",
+              "value": { "type": "number", "default": "1" }
+            },
+            {
+              "name": "show-citation",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "show-help",
+              "value": { "type": "boolean", "default": "true" }
+            },
+            {
+              "name": "application-citation",
+              "description": "if you include an application citation, it will be displayed in the citation panel alongside the dataset citation",
+              "value": { "type": "string | undefined" }
+            },
+            {
+              "name": "mobileView",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "productLabel",
+              "value": { "type": "string | undefined" }
+            },
+            {
+              "name": "bottomSheetDragY",
+              "value": { "type": "number", "default": "0" }
+            }
+          ],
+          "slots": [
+            { "name": "", "description": "The default slot." },
+            { "name": "example", "description": "An example slot." }
+          ],
+          "events": [],
+          "js": {
+            "properties": [
+              { "name": "catalogVariable", "type": "Variable" },
+              { "name": "variableEntryId", "type": "string" },
+              { "name": "plot", "type": "TerraPlot | undefined" },
+              {
+                "name": "timeSeriesData",
+                "type": "Partial<Plotly.Data>[] | Blob | undefined"
+              },
+              { "name": "location", "type": "string" },
+              { "name": "startDate", "type": "string" },
+              { "name": "endDate", "type": "string" },
+              { "name": "cacheKey", "type": "string" },
+              { "name": "dataType", "type": "DataType" },
+              { "name": "showLocation", "type": "boolean" },
+              { "name": "showDateRange", "type": "boolean" },
+              { "name": "colormaps", "type": "string[]" },
+              { "name": "colorMapName", "type": "string" },
+              { "name": "opacity", "type": "number" },
+              { "name": "showCitation", "type": "boolean" },
+              { "name": "showHelp", "type": "boolean" },
+              {
+                "name": "applicationCitation",
+                "description": "if you include an application citation, it will be displayed in the citation panel alongside the dataset citation",
+                "type": "string | undefined"
+              },
+              { "name": "mobileView", "type": "boolean" },
+              { "name": "productLabel", "type": "string | undefined" },
+              { "name": "bottomSheetDragY", "type": "number" },
+              { "name": "hideTitle", "type": "boolean" },
+              { "name": "activeMenuItem", "type": "MenuNames" },
+              { "name": "menu", "type": "HTMLMenuElement" },
+              { "name": "_authController" },
+              { "name": "metadata", "type": "TimeSeriesMetadata" }
+            ],
+            "events": []
+          }
+        },
         {
           "name": "terra-popup",
           "description": "Popup is a utility that lets you declaratively anchor \"popup\" containers to another element.\n---\n\n\n### **Events:**\n - **terra-reposition** - Emitted when the popup is repositioned. This event can fire a lot, so avoid putting expensive operations in your listener or consider debouncing it.\n\n### **Methods:**\n - **reposition()** - Forces the popup to recalculate and reposition itself.\n\n### **Slots:**\n - _default_ - The popup's content.\n- **anchor** - The element the popup will be anchored to. If the anchor lives outside of the popup, you can use the `anchor` attribute or property instead.\n\n### **CSS Properties:**\n - **--arrow-size** - The size of the arrow. Note that an arrow won't be shown unless the `arrow` attribute is used. _(default: 6px)_\n- **--arrow-color** - The color of the arrow. _(default: var(--terra-color-carbon-black))_\n- **--auto-size-available-width** - A read-only custom property that determines the amount of width the popup can be before overflowing. Useful for positioning child elements that need to overflow. This property is only available when using `auto-size`. _(default: undefined)_\n- **--auto-size-available-height** - A read-only custom property that determines the amount of height the popup can be before overflowing. Useful for positioning child elements that need to overflow. This property is only available when using `auto-size`. _(default: undefined)_\n\n### **CSS Parts:**\n - **arrow** - The arrow's container. Avoid setting `top|bottom|left|right` properties, as these values are assigned dynamically as the popup moves. This is most useful for applying a background color to match the popup, and maybe a border or box shadow.\n- **popup** - The popup's container. Useful for setting a background color, box shadow, etc.\n- **hover-bridge** - The hover bridge element. Only available when the `hover-bridge` option is enabled.",
@@ -3656,109 +3784,6 @@
             ]
           }
         },
-        {
-          "name": "terra-plot-toolbar",
-          "description": "Short summary of the component's intended use.\n---\n\n\n### **Slots:**\n - _default_ - The default slot.\n- **example** - An example slot.\n\n### **CSS Properties:**\n - **--terra-plot-toolbar-help-menu-display** - Controls the display of the help menu button. Set to `none` to hide it. Defaults to `flex`. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
-          "doc-url": "",
-          "attributes": [
-            { "name": "catalogVariable", "value": { "type": "Variable" } },
-            { "name": "variableEntryId", "value": { "type": "string" } },
-            { "name": "plot", "value": { "type": "TerraPlot | undefined" } },
-            {
-              "name": "timeSeriesData",
-              "value": { "type": "Partial<Plotly.Data>[] | Blob | undefined" }
-            },
-            { "name": "location", "value": { "type": "string" } },
-            { "name": "startDate", "value": { "type": "string" } },
-            { "name": "endDate", "value": { "type": "string" } },
-            { "name": "cacheKey", "value": { "type": "string" } },
-            { "name": "dataType", "value": { "type": "DataType" } },
-            {
-              "name": "show-location",
-              "value": { "type": "boolean", "default": "true" }
-            },
-            { "name": "show-date-range", "value": { "type": "boolean" } },
-            {
-              "name": "colormaps",
-              "value": { "type": "string[]", "default": "[]" }
-            },
-            {
-              "name": "color-map-name",
-              "value": { "type": "string", "default": "'viridis'" }
-            },
-            {
-              "name": "opacity",
-              "value": { "type": "number", "default": "1" }
-            },
-            {
-              "name": "show-citation",
-              "value": { "type": "boolean", "default": "false" }
-            },
-            {
-              "name": "show-help",
-              "value": { "type": "boolean", "default": "true" }
-            },
-            {
-              "name": "application-citation",
-              "description": "if you include an application citation, it will be displayed in the citation panel alongside the dataset citation",
-              "value": { "type": "string | undefined" }
-            },
-            {
-              "name": "mobileView",
-              "value": { "type": "boolean", "default": "false" }
-            },
-            {
-              "name": "productLabel",
-              "value": { "type": "string | undefined" }
-            },
-            {
-              "name": "bottomSheetDragY",
-              "value": { "type": "number", "default": "0" }
-            }
-          ],
-          "slots": [
-            { "name": "", "description": "The default slot." },
-            { "name": "example", "description": "An example slot." }
-          ],
-          "events": [],
-          "js": {
-            "properties": [
-              { "name": "catalogVariable", "type": "Variable" },
-              { "name": "variableEntryId", "type": "string" },
-              { "name": "plot", "type": "TerraPlot | undefined" },
-              {
-                "name": "timeSeriesData",
-                "type": "Partial<Plotly.Data>[] | Blob | undefined"
-              },
-              { "name": "location", "type": "string" },
-              { "name": "startDate", "type": "string" },
-              { "name": "endDate", "type": "string" },
-              { "name": "cacheKey", "type": "string" },
-              { "name": "dataType", "type": "DataType" },
-              { "name": "showLocation", "type": "boolean" },
-              { "name": "showDateRange", "type": "boolean" },
-              { "name": "colormaps", "type": "string[]" },
-              { "name": "colorMapName", "type": "string" },
-              { "name": "opacity", "type": "number" },
-              { "name": "showCitation", "type": "boolean" },
-              { "name": "showHelp", "type": "boolean" },
-              {
-                "name": "applicationCitation",
-                "description": "if you include an application citation, it will be displayed in the citation panel alongside the dataset citation",
-                "type": "string | undefined"
-              },
-              { "name": "mobileView", "type": "boolean" },
-              { "name": "productLabel", "type": "string | undefined" },
-              { "name": "bottomSheetDragY", "type": "number" },
-              { "name": "hideTitle", "type": "boolean" },
-              { "name": "activeMenuItem", "type": "MenuNames" },
-              { "name": "menu", "type": "HTMLMenuElement" },
-              { "name": "_authController" },
-              { "name": "metadata", "type": "TimeSeriesMetadata" }
-            ],
-            "events": []
-          }
-        },
         {
           "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.",
@@ -4107,7 +4132,7 @@
         },
         {
           "name": "terra-scroll-hint",
-          "description": "Scroll hint is an animated button that prompts visitors to scroll.\n---\n\n\n### **Events:**\n - **terra-scroll** - Emitted when the scroll hint is clicked and scrolling begins.\n\n### **CSS Properties:**\n - **--terra-scroll-hint-icon-background-color** - The background color of the icon circle. _(default: undefined)_\n- **--terra-scroll-hint-icon-color** - The color of the chevron icon. _(default: undefined)_\n- **--terra-scroll-hint-text-color** - The color of the text. _(default: undefined)_\n- **--terra-scroll-hint-ring-color** - The color of the pulsing ring. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **button** - The clickable button element.\n- **icon-container** - The container for the icon and pulsing ring.\n- **icon** - The chevron icon.\n- **ring** - The pulsing ring around the icon.\n- **text** - The \"SCROLL TO CONTINUE\" text.",
+          "description": "Scroll hint is an animated button that prompts visitors to scroll.\n---\n\n\n### **Events:**\n - **terra-scroll** - Emitted when the scroll hint is clicked and scrolling begins.\n\n### **CSS Properties:**\n - **--terra-scroll-hint-icon-background-color** - The background color of the icon circle. _(default: undefined)_\n- **--terra-scroll-hint-icon-color** - The color of the chevron icon. _(default: undefined)_\n- **--terra-scroll-hint-text-color** - The color of the text. _(default: undefined)_\n- **--terra-scroll-hint-ring-color** - The color of the pulsing ring. _(default: undefined)_\n- **--terra-scroll-hint-inverse-background-color** - The background color of the icon circle in inverse mode. _(default: undefined)_\n- **--terra-scroll-hint-inverse-icon-color** - The color of the chevron icon in inverse mode. _(default: undefined)_\n- **--terra-scroll-hint-inverse-text-color** - The color of the text in inverse mode. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **button** - The clickable button element.\n- **icon-container** - The container for the icon and pulsing ring.\n- **icon** - The chevron icon.\n- **ring** - The pulsing ring around the icon.\n- **text** - The \"SCROLL TO CONTINUE\" text.",
           "doc-url": "",
           "attributes": [
             {
@@ -4116,8 +4141,8 @@
               "value": { "type": "boolean", "default": "false" }
             },
             {
-              "name": "dark",
-              "description": "When true, forces dark mode styles regardless of system preference. Useful when placing the component on a dark background.",
+              "name": "inverse",
+              "description": "When true, forces inverse mode styles regardless of system preference. Useful when placing the component on a dark background.",
               "value": { "type": "boolean", "default": "false" }
             },
             {
@@ -4140,8 +4165,8 @@
                 "type": "boolean"
               },
               {
-                "name": "dark",
-                "description": "When true, forces dark mode styles regardless of system preference. Useful when placing the component on a dark background.",
+                "name": "inverse",
+                "description": "When true, forces inverse mode styles regardless of system preference. Useful when placing the component on a dark background.",
                 "type": "boolean"
               },
               {
@@ -4765,6 +4790,11 @@
               "description": "Whether bounding box selection is allowed via the draw toolbar.\nMirrors the terra-map attribute name for consistency.",
               "value": { "type": "boolean", "default": "true" }
             },
+            {
+              "name": "show-polygon-selection",
+              "description": "Whether polygon selection is allowed via the draw toolbar.\nMirrors the terra-map attribute name for consistency.",
+              "value": { "type": "boolean", "default": "false" }
+            },
             {
               "name": "hide-bounding-box-selection",
               "value": { "type": "string" }
@@ -4840,6 +4870,11 @@
                 "description": "Whether bounding box selection is allowed via the draw toolbar.\nMirrors the terra-map attribute name for consistency.",
                 "type": "boolean"
               },
+              {
+                "name": "showPolygonSelection",
+                "description": "Whether polygon selection is allowed via the draw toolbar.\nMirrors the terra-map attribute name for consistency.",
+                "type": "boolean"
+              },
               { "name": "hideBoundingBoxSelection" },
               {
                 "name": "showPointSelection",
@@ -5116,7 +5151,7 @@
         },
         {
           "name": "terra-tabs",
-          "description": "Tabs organize content into a container that shows one section at a time.\n---\n\n\n### **Events:**\n - **terra-tab-show** - Emitted when a tab is shown.\n- **terra-tab-hide** - Emitted when a tab is hidden.\n\n### **Methods:**\n - **show(panel: _string_)** - Shows the specified tab panel.\n\n### **Slots:**\n - _default_ - Used for grouping tab panels in the tabs component. Must be `<terra-tab-panel>` elements.\n- **nav** - Used for grouping tabs in the tabs component. Must be `<terra-tab>` elements.\n\n### **CSS Properties:**\n - **--terra-tabs-indicator-color** - The color of the active tab indicator. _(default: undefined)_\n- **--terra-tabs-track-color** - The color of the indicator's track (the line that separates tabs from panels). _(default: undefined)_\n- **--terra-tabs-track-width** - The width of the indicator's track (the line that separates tabs from panels). _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **nav** - The tabs' navigation container where tabs are slotted in.\n- **tabs** - The container that wraps the tabs.\n- **active-tab-indicator** - The line that highlights the currently selected tab.\n- **body** - The tabs' body where tab panels are slotted in.\n- **scroll-button** - The previous/next scroll buttons that show when tabs are scrollable.\n- **scroll-button--start** - The starting scroll button.\n- **scroll-button--end** - The ending scroll button.",
+          "description": "Tabs organize content into a container that shows one section at a time.\n---\n\n\n### **Events:**\n - **terra-tab-show** - Emitted when a tab is shown.\n- **terra-tab-hide** - Emitted when a tab is hidden.\n\n### **Methods:**\n - **show(panel: _string_)** - Shows the specified tab panel.\n\n### **Slots:**\n - _default_ - Used for grouping tab panels in the tabs component. Must be `<terra-tab-panel>` elements.\n- **nav** - Used for grouping tabs in the tabs component. Must be `<terra-tab>` elements.\n\n### **CSS Properties:**\n - **--terra-tab-indicator-selected** - The color of the active tab indicator. _(default: undefined)_\n- **--terra-tab-track-color** - The color of the indicator's track (the line that separates tabs from panels). _(default: undefined)_\n- **--terra-tabs-track-width** - The width of the indicator's track (the line that separates tabs from panels). _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **nav** - The tabs' navigation container where tabs are slotted in.\n- **tabs** - The container that wraps the tabs.\n- **active-tab-indicator** - The line that highlights the currently selected tab.\n- **body** - The tabs' body where tab panels are slotted in.\n- **scroll-button** - The previous/next scroll buttons that show when tabs are scrollable.\n- **scroll-button--start** - The starting scroll button.\n- **scroll-button--end** - The ending scroll button.",
           "doc-url": "",
           "attributes": [
             {
@@ -5782,15 +5817,15 @@
         },
         {
           "name": "terra-toast",
-          "description": "Toasts are used to display brief, non-intrusive notifications that appear temporarily.\n---\n\n\n### **Events:**\n - **terra-show** - Emitted when the toast opens.\n- **terra-after-show** - Emitted after the toast opens and all animations are complete.\n- **terra-hide** - Emitted when the toast closes.\n- **terra-after-hide** - Emitted after the toast closes and all animations are complete.\n\n### **Methods:**\n - **toast()** - Displays the toast as a notification. This will move the toast out of its position in the DOM and, when\ndismissed, it will be removed from the DOM completely. By storing a reference to the toast, you can reuse it by\ncalling this method again. The returned promise will resolve after the toast is hidden.\n- **show()** - Shows the toast.\n- **hide()** - Hides the toast.\n- **notify(message: _string_, variant: _'primary' | 'success' | 'neutral' | 'warning' | 'danger'_, icon: _string_, duration): __** - Creates a toast notification imperatively. This is a convenience method that creates a toast, appends it to the\nbody, and displays it as a notification.\n\n### **Slots:**\n - _default_ - The toast's main content.\n- **icon** - An icon to show in the toast. Works best with `<terra-icon>`.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper, an `<terra-alert>` element.\n- **base__base** - The alert's exported `base` part.\n- **base__icon** - The alert's exported `icon` part.\n- **base__message** - The alert's exported `message` part.",
+          "description": "Toasts are used to display brief, non-intrusive notifications that appear temporarily.\n---\n\n\n### **Events:**\n - **terra-show** - Emitted when the toast opens.\n- **terra-after-show** - Emitted after the toast opens and all animations are complete.\n- **terra-hide** - Emitted when the toast closes.\n- **terra-after-hide** - Emitted after the toast closes and all animations are complete.\n\n### **Methods:**\n - **toast()** - Displays the toast as a notification. This will move the toast out of its position in the DOM and, when\ndismissed, it will be removed from the DOM completely. By storing a reference to the toast, you can reuse it by\ncalling this method again. The returned promise will resolve after the toast is hidden.\n- **show()** - Shows the toast.\n- **hide()** - Hides the toast.\n- **notify(message: _string_, variant: _| 'primary'\n            | 'information'\n            | 'success'\n            | 'neutral'\n            | 'warning'\n            | 'danger'_, icon: _string_, duration): __** - Creates a toast notification imperatively. This is a convenience method that creates a toast, appends it to the\nbody, and displays it as a notification.\n\n### **Slots:**\n - _default_ - The toast's main content.\n- **icon** - An icon to show in the toast. Works best with `<terra-icon>`.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper, an `<terra-alert>` element.\n- **base__base** - The alert's exported `base` part.\n- **base__icon** - The alert's exported `icon` part.\n- **base__message** - The alert's exported `message` part.",
           "doc-url": "",
           "attributes": [
             {
               "name": "variant",
               "description": "The toast's theme variant.",
               "value": {
-                "type": "| 'primary'\n        | 'success'\n        | 'neutral'\n        | 'warning'\n        | 'danger'",
-                "default": "'primary'"
+                "type": "| 'primary'\n        | 'information'\n        | 'success'\n        | 'neutral'\n        | 'warning'\n        | 'danger'",
+                "default": "'information'"
               }
             },
             {
@@ -5840,7 +5875,7 @@
               {
                 "name": "variant",
                 "description": "The toast's theme variant.",
-                "type": "| 'primary'\n        | 'success'\n        | 'neutral'\n        | 'warning'\n        | 'danger'"
+                "type": "| 'primary'\n        | 'information'\n        | 'success'\n        | 'neutral'\n        | 'warning'\n        | 'danger'"
               },
               {
                 "name": "duration",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nasa-terra/components",
   "description": "A collection of NASA Earthdata components",
-  "version": "0.0.189",
+  "version": "0.0.192",
   "homepage": "https://github.com/nasa/terra-ui-components",
   "author": "NASA GES DISC <https://disc.gsfc.nasa.gov>",
   "license": "MIT",
@@ -46,6 +46,8 @@
     "start:python": "./.venv/bin/jupyter lab",
     "serve": "node scripts/build.js --serve",
     "build": "node scripts/build.js",
+    "prebuild": "npm run token-docs",
+    "token-docs": "node scripts/generate-token-docs.js",
     "build:python": "hatch build",
     "publish:python": "hatch publish",
     "verify": "npm run prettier && npm run build && echo 'should run tests here'",
@@ -74,6 +76,7 @@
     "@lit/task": "^1.0.0",
     "@tanstack/query-core": "^5.96.0",
     "@tanstack/query-persist-client-core": "^5.96.0",
+    "@turf/turf": "^7.3.5",
     "ag-grid-community": "^34.2.0",
     "colormap": "^2.3.2",
     "composed-offset-position": "^0.0.6",