@nasa-terra/components 0.0.152 → 0.0.154

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

@@ -1,9 +1,9 @@
 import type { DefineComponent } from "vue";
 
 import type { TerraAccordion } from "../../components/accordion/accordion.component.js";
+import type { TerraAlert } from "../../components/alert/alert.component.js";
 import type { TerraAvatar } from "../../components/avatar/avatar.component.js";
 import type { TerraBadge } from "../../components/badge/badge.component.js";
-import type { TerraAlert } from "../../components/alert/alert.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";
@@ -23,8 +23,8 @@ import type { TerraDatePicker } from "../../components/date-picker/date-picker.c
 import type { TerraDateRangeSlider } from "../../components/date-range-slider/date-range-slider.component.js";
 import type { TerraDialog } from "../../components/dialog/dialog.component.js";
 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 { TerraDropdown } from "../../components/dropdown/dropdown.component.js";
 import type { TerraFileUpload } from "../../components/file-upload/file-upload.component.js";
 import type { TerraIcon } from "../../components/icon/icon.component.js";
 import type { TerraInput } from "../../components/input/input.component.js";
@@ -33,20 +33,20 @@ import type { TerraLogin } from "../../components/login/login.component.js";
 import type { TerraMap } from "../../components/map/map.component.js";
 import type { TerraMenu } from "../../components/menu/menu.component.js";
 import type { TerraMenuItem } from "../../components/menu-item/menu-item.component.js";
+import type { TerraOption } from "../../components/option/option.component.js";
 import type { TerraPagination } from "../../components/pagination/pagination.component.js";
 import type { TerraPlot } from "../../components/plot/plot.component.js";
-import type { TerraOption } from "../../components/option/option.component.js";
 import type { TerraPlotToolbar } from "../../components/plot-toolbar/plot-toolbar.component.js";
 import type { TerraPopup } from "../../components/popup/popup.component.js";
 import type { TerraProgressBar } from "../../components/progress-bar/progress-bar.component.js";
 import type { TerraRadio } from "../../components/radio/radio.component.js";
-import type { TerraSelect } from "../../components/select/select.component.js";
 import type { TerraRadioGroup } from "../../components/radio-group/radio-group.component.js";
 import type { TerraScrollHint } from "../../components/scroll-hint/scroll-hint.component.js";
+import type { TerraSelect } from "../../components/select/select.component.js";
 import type { TerraSiteHeader } from "../../components/site-header/site-header.component.js";
+import type { TerraSiteNavigation } from "../../components/site-navigation/site-navigation.component.js";
 import type { TerraSkeleton } from "../../components/skeleton/skeleton.component.js";
 import type { TerraSlider } from "../../components/slider/slider.component.js";
-import type { TerraSiteNavigation } from "../../components/site-navigation/site-navigation.component.js";
 import type { TerraSpatialPicker } from "../../components/spatial-picker/spatial-picker.component.js";
 import type { TerraStatusIndicator } from "../../components/status-indicator/status-indicator.component.js";
 import type { TerraStepper } from "../../components/stepper/stepper.component.js";
@@ -76,31 +76,6 @@ type TerraAccordionProps = {
   onTerraAccordionToggle?: (e: CustomEvent<never>) => void;
 };
 
-type TerraAvatarProps = {
-  /** The image source to use for the avatar. */
-  image?: TerraAvatar["image"];
-  /** A label to use to describe the avatar to assistive devices. */
-  label?: TerraAvatar["label"];
-  /** Initials to use as a fallback when no image is available (1-2 characters max recommended). */
-  initials?: TerraAvatar["initials"];
-  /** Indicates how the browser should load the image. */
-  loading?: TerraAvatar["loading"];
-  /** The shape of the avatar. */
-  shape?: TerraAvatar["shape"];
-
-  /** The image could not be loaded. This may because of an invalid URL, a temporary network condition, or some unknown cause. */
-  onTerraError?: (e: CustomEvent<never>) => void;
-};
-
-type TerraBadgeProps = {
-  /** The badge's theme variant. */
-  variant?: TerraBadge["variant"];
-  /** Draws a pill-style badge with rounded edges. */
-  pill?: TerraBadge["pill"];
-  /** Makes the badge pulsate to draw attention. */
-  pulse?: TerraBadge["pulse"];
-};
-
 type TerraAlertProps = {
   /** Indicates whether or not the alert is open. You can toggle this attribute to show and hide the alert, or you can
 use the `show()` and `hide()` methods and this attribute will reflect the alert's open state. */
@@ -133,6 +108,31 @@ Typically used to indicate the remaining time before a whole app refresh. */
   onTerraAfterHide?: (e: CustomEvent<never>) => void;
 };
 
+type TerraAvatarProps = {
+  /** The image source to use for the avatar. */
+  image?: TerraAvatar["image"];
+  /** A label to use to describe the avatar to assistive devices. */
+  label?: TerraAvatar["label"];
+  /** Initials to use as a fallback when no image is available (1-2 characters max recommended). */
+  initials?: TerraAvatar["initials"];
+  /** Indicates how the browser should load the image. */
+  loading?: TerraAvatar["loading"];
+  /** The shape of the avatar. */
+  shape?: TerraAvatar["shape"];
+
+  /** The image could not be loaded. This may because of an invalid URL, a temporary network condition, or some unknown cause. */
+  onTerraError?: (e: CustomEvent<never>) => void;
+};
+
+type TerraBadgeProps = {
+  /** The badge's theme variant. */
+  variant?: TerraBadge["variant"];
+  /** Draws a pill-style badge with rounded edges. */
+  pill?: TerraBadge["pill"];
+  /** Makes the badge pulsate to draw attention. */
+  pulse?: TerraBadge["pulse"];
+};
+
 type TerraBreadcrumbProps = {
   /** The URL the breadcrumb points to. When omitted, the breadcrumb is rendered as plain text. */
   href?: TerraBreadcrumb["href"];
@@ -676,6 +676,38 @@ type TerraDividerProps = {
   vertical?: TerraDivider["vertical"];
 };
 
+type TerraEarthdataLoginProps = {
+  /** The message to show when the user is logged in
+You can use the following placeholders:
+{username} - The username of the user
+{first_name} - The first name of the user
+{last_name} - The last name of the user */
+  "logged-in-message"?: TerraEarthdataLogin["loggedInMessage"];
+  /**  */
+  "logged-out-message"?: TerraEarthdataLogin["loggedOutMessage"];
+  /**  */
+  "loading-message"?: TerraEarthdataLogin["loadingMessage"];
+  /**  */
+  username?: TerraEarthdataLogin["username"];
+  /**  */
+  password?: TerraEarthdataLogin["password"];
+  /**  */
+  "hide-password-toggle"?: TerraEarthdataLogin["hidePasswordToggle"];
+  /** if true and the user has passed in a username and password, we will automatically log them in
+this is useful for Jupyter Notebooks where we may want to automatically log the user in when the component is rendered */
+  "auto-login"?: TerraEarthdataLogin["autoLogin"];
+  /**  */
+  usernameError?: TerraEarthdataLogin["usernameError"];
+  /**  */
+  passwordError?: TerraEarthdataLogin["passwordError"];
+  /**  */
+  usernameInput?: TerraEarthdataLogin["usernameInput"];
+  /**  */
+  passwordInput?: TerraEarthdataLogin["passwordInput"];
+  /** Emitted when a bearer token has been received from EDL. */
+  onTerraLogin?: (e: CustomEvent<never>) => void;
+};
+
 type TerraDropdownProps = {
   /** Indicates whether or not the dropdown is open. You can toggle this attribute to show and hide the dropdown, or you
 can use the `show()` and `hide()` methods and this attribute will reflect the dropdown's open state. */
@@ -718,38 +750,6 @@ components that use a dropdown internally. */
   onTerraAfterHide?: (e: CustomEvent<never>) => void;
 };
 
-type TerraEarthdataLoginProps = {
-  /** The message to show when the user is logged in
-You can use the following placeholders:
-{username} - The username of the user
-{first_name} - The first name of the user
-{last_name} - The last name of the user */
-  "logged-in-message"?: TerraEarthdataLogin["loggedInMessage"];
-  /**  */
-  "logged-out-message"?: TerraEarthdataLogin["loggedOutMessage"];
-  /**  */
-  "loading-message"?: TerraEarthdataLogin["loadingMessage"];
-  /**  */
-  username?: TerraEarthdataLogin["username"];
-  /**  */
-  password?: TerraEarthdataLogin["password"];
-  /**  */
-  "hide-password-toggle"?: TerraEarthdataLogin["hidePasswordToggle"];
-  /** if true and the user has passed in a username and password, we will automatically log them in
-this is useful for Jupyter Notebooks where we may want to automatically log the user in when the component is rendered */
-  "auto-login"?: TerraEarthdataLogin["autoLogin"];
-  /**  */
-  usernameError?: TerraEarthdataLogin["usernameError"];
-  /**  */
-  passwordError?: TerraEarthdataLogin["passwordError"];
-  /**  */
-  usernameInput?: TerraEarthdataLogin["usernameInput"];
-  /**  */
-  passwordInput?: TerraEarthdataLogin["passwordInput"];
-  /** Emitted when a bearer token has been received from EDL. */
-  onTerraLogin?: (e: CustomEvent<never>) => void;
-};
-
 type TerraFileUploadProps = {
   /** The file upload's label. */
   label?: TerraFileUpload["label"];
@@ -992,6 +992,23 @@ type TerraMenuItemProps = {
   menuItem?: TerraMenuItem["menuItem"];
 };
 
+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. */
+  value?: TerraOption["value"];
+  /** Draws the option in a disabled state, preventing selection. */
+  disabled?: TerraOption["disabled"];
+  /**  */
+  defaultSlot?: TerraOption["defaultSlot"];
+  /**  */
+  current?: TerraOption["current"];
+  /**  */
+  selected?: TerraOption["selected"];
+  /**  */
+  hasHover?: TerraOption["hasHover"];
+};
+
 type TerraPaginationProps = {
   /** The current page number (1-indexed). */
   current?: TerraPagination["current"];
@@ -1021,23 +1038,6 @@ type TerraPlotProps = {
   base?: TerraPlot["base"];
 };
 
-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. */
-  value?: TerraOption["value"];
-  /** Draws the option in a disabled state, preventing selection. */
-  disabled?: TerraOption["disabled"];
-  /**  */
-  defaultSlot?: TerraOption["defaultSlot"];
-  /**  */
-  current?: TerraOption["current"];
-  /**  */
-  selected?: TerraOption["selected"];
-  /**  */
-  hasHover?: TerraOption["hasHover"];
-};
-
 type TerraPlotToolbarProps = {
   /**  */
   catalogVariable?: TerraPlotToolbar["catalogVariable"];
@@ -1217,6 +1217,54 @@ the same document or shadow root for this to work. */
   onTerraInvalid?: (e: CustomEvent<never>) => void;
 };
 
+type TerraRadioGroupProps = {
+  /** The radio group's label. Required for proper accessibility. If you need to display HTML, use the `label` slot
+instead. */
+  label?: TerraRadioGroup["label"];
+  /** The radio groups's help text. If you need to display HTML, use the `help-text` slot instead. */
+  "help-text"?: TerraRadioGroup["helpText"];
+  /** The name of the radio group, submitted as a name/value pair with form data. */
+  name?: TerraRadioGroup["name"];
+  /** The current value of the radio group, submitted as a name/value pair with form data. */
+  value?: TerraRadioGroup["value"];
+  /** The radio group's size. This size will be applied to all child radios and radio buttons. */
+  size?: TerraRadioGroup["size"];
+  /** By default, form controls are associated with the nearest containing `<form>` element. This attribute allows you
+to place the form control outside of a form and associate it with the form that has this `id`. The form must be in
+the same document or shadow root for this to work. */
+  form?: TerraRadioGroup["form"];
+  /** Ensures a child radio is checked before allowing the containing form to submit. */
+  required?: TerraRadioGroup["required"];
+  /**  */
+  defaultSlot?: TerraRadioGroup["defaultSlot"];
+  /**  */
+  validationInput?: TerraRadioGroup["validationInput"];
+  /**  */
+  defaultValue?: TerraRadioGroup["defaultValue"];
+  /** Gets the validity state object */
+  validity?: TerraRadioGroup["validity"];
+  /** Gets the validation message */
+  validationMessage?: TerraRadioGroup["validationMessage"];
+  /** Emitted when the radio group's selected value changes. */
+  onTerraChange?: (e: CustomEvent<never>) => void;
+  /** Emitted when the radio group receives user input. */
+  onTerraInput?: (e: CustomEvent<never>) => void;
+  /** Emitted when the form control has been checked for validity and its constraints aren't satisfied. */
+  onTerraInvalid?: (e: CustomEvent<never>) => void;
+};
+
+type TerraScrollHintProps = {
+  /** When true, the component will be positioned inline in the DOM flow instead of fixed to the viewport. */
+  inline?: TerraScrollHint["inline"];
+  /** When true, forces dark mode styles regardless of system preference. Useful when placing the component on a dark background. */
+  dark?: TerraScrollHint["dark"];
+  /** The delay in milliseconds before showing the scroll hint after inactivity. Defaults to 3000ms (3 seconds). */
+  inactivityDelay?: TerraScrollHint["inactivityDelay"];
+
+  /** Emitted when the scroll hint is clicked and scrolling begins. */
+  onTerraScroll?: (e: CustomEvent<never>) => void;
+};
+
 type TerraSelectProps = {
   /** The name of the select, submitted as a name/value pair with form data. */
   name?: TerraSelect["name"];
@@ -1308,61 +1356,18 @@ be an array. **For this reason, values must not contain spaces.** */
   onTerraInvalid?: (e: CustomEvent<never>) => void;
 };
 
-type TerraRadioGroupProps = {
-  /** The radio group's label. Required for proper accessibility. If you need to display HTML, use the `label` slot
-instead. */
-  label?: TerraRadioGroup["label"];
-  /** The radio groups's help text. If you need to display HTML, use the `help-text` slot instead. */
-  "help-text"?: TerraRadioGroup["helpText"];
-  /** The name of the radio group, submitted as a name/value pair with form data. */
-  name?: TerraRadioGroup["name"];
-  /** The current value of the radio group, submitted as a name/value pair with form data. */
-  value?: TerraRadioGroup["value"];
-  /** The radio group's size. This size will be applied to all child radios and radio buttons. */
-  size?: TerraRadioGroup["size"];
-  /** By default, form controls are associated with the nearest containing `<form>` element. This attribute allows you
-to place the form control outside of a form and associate it with the form that has this `id`. The form must be in
-the same document or shadow root for this to work. */
-  form?: TerraRadioGroup["form"];
-  /** Ensures a child radio is checked before allowing the containing form to submit. */
-  required?: TerraRadioGroup["required"];
-  /**  */
-  defaultSlot?: TerraRadioGroup["defaultSlot"];
-  /**  */
-  validationInput?: TerraRadioGroup["validationInput"];
-  /**  */
-  defaultValue?: TerraRadioGroup["defaultValue"];
-  /** Gets the validity state object */
-  validity?: TerraRadioGroup["validity"];
-  /** Gets the validation message */
-  validationMessage?: TerraRadioGroup["validationMessage"];
-  /** Emitted when the radio group's selected value changes. */
-  onTerraChange?: (e: CustomEvent<never>) => void;
-  /** Emitted when the radio group receives user input. */
-  onTerraInput?: (e: CustomEvent<never>) => void;
-  /** Emitted when the form control has been checked for validity and its constraints aren't satisfied. */
-  onTerraInvalid?: (e: CustomEvent<never>) => void;
-};
-
-type TerraScrollHintProps = {
-  /** When true, the component will be positioned inline in the DOM flow instead of fixed to the viewport. */
-  inline?: TerraScrollHint["inline"];
-  /** When true, forces dark mode styles regardless of system preference. Useful when placing the component on a dark background. */
-  dark?: TerraScrollHint["dark"];
-  /** The delay in milliseconds before showing the scroll hint after inactivity. Defaults to 3000ms (3 seconds). */
-  inactivityDelay?: TerraScrollHint["inactivityDelay"];
-
-  /** Emitted when the scroll hint is clicked and scrolling begins. */
-  onTerraScroll?: (e: CustomEvent<never>) => void;
-};
-
 type TerraSiteHeaderProps = {
   /** The default site name displayed in the title slot if no content is provided. */
   "site-name"?: TerraSiteHeader["siteName"];
 };
 
-type TerraSkeletonProps = {
-  /**  */
+type TerraSiteNavigationProps = {
+  /** When true, dropdowns use full-width panels instead of normal list-based navigation. */
+  "full-width"?: TerraSiteNavigation["fullWidth"];
+};
+
+type TerraSkeletonProps = {
+  /**  */
   rows?: TerraSkeleton["rows"];
   /**  */
   effect?: TerraSkeleton["effect"];
@@ -1403,11 +1408,6 @@ When hidden, still presents to screen readers. */
   slider?: TerraSlider["slider"];
 };
 
-type TerraSiteNavigationProps = {
-  /** When true, dropdowns use full-width panels instead of normal list-based navigation. */
-  "full-width"?: TerraSiteNavigation["fullWidth"];
-};
-
 type TerraSpatialPickerProps = {
   /** Minimum zoom level of the map. */
   "min-zoom"?: TerraSpatialPicker["minZoom"];
@@ -1899,6 +1899,34 @@ export type CustomElements = {
    */
   "terra-accordion": DefineComponent<TerraAccordionProps>;
 
+  /**
+   * Alerts are used to display important messages inline or as toast notifications.
+   * ---
+   *
+   *
+   * ### **Events:**
+   *  - **terra-show** - Emitted when the alert opens.
+   * - **terra-after-show** - Emitted after the alert opens and all animations are complete.
+   * - **terra-hide** - Emitted when the alert closes.
+   * - **terra-after-hide** - Emitted after the alert closes and all animations are complete.
+   *
+   * ### **Methods:**
+   *  - **show()** - Shows the alert.
+   * - **hide()** - Hides the alert
+   * - **toast()** - Displays the alert as a toast notification. This will move the alert out of its position in the DOM and, when
+   * dismissed, it will be removed from the DOM completely. By storing a reference to the alert, you can reuse it by
+   * calling this method again. The returned promise will resolve after the alert is hidden.
+   *
+   * ### **Slots:**
+   *  - _default_ - The alert'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 alert's main content.
+   */
+  "terra-alert": DefineComponent<TerraAlertProps>;
+
   /**
    * Avatars are used to represent a person or object.
    * ---
@@ -1934,34 +1962,6 @@ export type CustomElements = {
    */
   "terra-badge": DefineComponent<TerraBadgeProps>;
 
-  /**
-   * Alerts are used to display important messages inline or as toast notifications.
-   * ---
-   *
-   *
-   * ### **Events:**
-   *  - **terra-show** - Emitted when the alert opens.
-   * - **terra-after-show** - Emitted after the alert opens and all animations are complete.
-   * - **terra-hide** - Emitted when the alert closes.
-   * - **terra-after-hide** - Emitted after the alert closes and all animations are complete.
-   *
-   * ### **Methods:**
-   *  - **show()** - Shows the alert.
-   * - **hide()** - Hides the alert
-   * - **toast()** - Displays the alert as a toast notification. This will move the alert out of its position in the DOM and, when
-   * dismissed, it will be removed from the DOM completely. By storing a reference to the alert, you can reuse it by
-   * calling this method again. The returned promise will resolve after the alert is hidden.
-   *
-   * ### **Slots:**
-   *  - _default_ - The alert'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 alert's main content.
-   */
-  "terra-alert": DefineComponent<TerraAlertProps>;
-
   /**
    * A single breadcrumb item used inside `terra-breadcrumbs`.
    * ---
@@ -2333,6 +2333,16 @@ export type CustomElements = {
    */
   "terra-divider": DefineComponent<TerraDividerProps>;
 
+  /**
+   * A form that logs in to Earthdata Login (EDL)
+   * ---
+   *
+   *
+   * ### **Events:**
+   *  - **terra-login** - Emitted when a bearer token has been received from EDL.
+   */
+  "terra-earthdata-login": DefineComponent<TerraEarthdataLoginProps>;
+
   /**
    * Dropdowns expose additional content that "drops down" in a panel.
    * ---
@@ -2362,16 +2372,6 @@ export type CustomElements = {
    */
   "terra-dropdown": DefineComponent<TerraDropdownProps>;
 
-  /**
-   * A form that logs in to Earthdata Login (EDL)
-   * ---
-   *
-   *
-   * ### **Events:**
-   *  - **terra-login** - Emitted when a bearer token has been received from EDL.
-   */
-  "terra-earthdata-login": DefineComponent<TerraEarthdataLoginProps>;
-
   /**
    * File upload fields allow visitors to attach one or multiple files to be submitted with a form.
    * ---
@@ -2534,6 +2534,31 @@ export type CustomElements = {
    */
   "terra-menu-item": DefineComponent<TerraMenuItemProps>;
 
+  /**
+   * Options define the selectable items within various form controls such as [select](/components/select).
+   * ---
+   *
+   *
+   * ### **Methods:**
+   *  - **getTextLabel()** - Returns a plain text label based on the option's content.
+   *
+   * ### **Slots:**
+   *  - _default_ - The option's label.
+   * - **prefix** - Used to prepend an icon or similar element to the menu item.
+   * - **suffix** - Used to append an icon or similar element to the menu item.
+   *
+   * ### **CSS Properties:**
+   *  - **--terra-option-*** - All option design tokens from horizon.css are supported. _(default: undefined)_
+   *
+   * ### **CSS Parts:**
+   *  - **checked-icon** - The checked icon, an `<terra-icon>` element.
+   * - **base** - The component's base wrapper.
+   * - **label** - The option's label.
+   * - **prefix** - The container that wraps the prefix.
+   * - **suffix** - The container that wraps the suffix.
+   */
+  "terra-option": DefineComponent<TerraOptionProps>;
+
   /**
    * Pagination is a navigational element that allows users to navigate between content or pages.
    * ---
@@ -2575,31 +2600,6 @@ export type CustomElements = {
    */
   "terra-plot": DefineComponent<TerraPlotProps>;
 
-  /**
-   * Options define the selectable items within various form controls such as [select](/components/select).
-   * ---
-   *
-   *
-   * ### **Methods:**
-   *  - **getTextLabel()** - Returns a plain text label based on the option's content.
-   *
-   * ### **Slots:**
-   *  - _default_ - The option's label.
-   * - **prefix** - Used to prepend an icon or similar element to the menu item.
-   * - **suffix** - Used to append an icon or similar element to the menu item.
-   *
-   * ### **CSS Properties:**
-   *  - **--terra-option-*** - All option design tokens from horizon.css are supported. _(default: undefined)_
-   *
-   * ### **CSS Parts:**
-   *  - **checked-icon** - The checked icon, an `<terra-icon>` element.
-   * - **base** - The component's base wrapper.
-   * - **label** - The option's label.
-   * - **prefix** - The container that wraps the prefix.
-   * - **suffix** - The container that wraps the suffix.
-   */
-  "terra-option": DefineComponent<TerraOptionProps>;
-
   /**
    * Short summary of the component's intended use.
    * ---
@@ -2703,62 +2703,6 @@ export type CustomElements = {
    */
   "terra-radio": DefineComponent<TerraRadioProps>;
 
-  /**
-   * Select fields are a form field used to select one option from a list.
-   * ---
-   *
-   *
-   * ### **Events:**
-   *  - **terra-change** - Emitted when the control's value changes.
-   * - **terra-clear** - Emitted when the control's value is cleared.
-   * - **terra-input** - Emitted when the control receives input.
-   * - **terra-focus** - Emitted when the control gains focus.
-   * - **terra-blur** - Emitted when the control loses focus.
-   * - **terra-show** - Emitted when the select's menu opens.
-   * - **terra-after-show** - Emitted after the select's menu opens and all animations are complete.
-   * - **terra-hide** - Emitted when the select's menu closes.
-   * - **terra-after-hide** - Emitted after the select's menu closes and all animations are complete.
-   * - **terra-invalid** - Emitted when the form control has been checked for validity and its constraints aren't satisfied.
-   *
-   * ### **Methods:**
-   *  - **show()** - Shows the listbox.
-   * - **hide()** - Hides the listbox.
-   * - **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. Pass an empty string to restore validity.
-   * - **focus(options: _FocusOptions_)** - Sets focus on the control.
-   * - **blur()** - Removes focus from the control.
-   *
-   * ### **Slots:**
-   *  - _default_ - The listbox options. Must be `<terra-option>` elements.
-   * - **label** - The input's label. Alternatively, you can use the `label` attribute.
-   * - **prefix** - Used to prepend a presentational icon or similar element to the combobox.
-   * - **suffix** - Used to append a presentational icon or similar element to the combobox.
-   * - **clear-icon** - An icon to use in lieu of the default clear icon.
-   * - **expand-icon** - The icon to show when the control is expanded and collapsed. Rotates on open and close.
-   * - **help-text** - Text that describes how to use the input. Alternatively, you can use the `help-text` attribute.
-   *
-   * ### **CSS Properties:**
-   *  - **--terra-select-*** - All select design tokens from horizon.css are supported. _(default: undefined)_
-   *
-   * ### **CSS Parts:**
-   *  - **form-control** - The form control that wraps the label, input, and help text.
-   * - **form-control-label** - The label's wrapper.
-   * - **form-control-input** - The select's wrapper.
-   * - **form-control-help-text** - The help text's wrapper.
-   * - **combobox** - The container the wraps the prefix, suffix, combobox, clear icon, and expand button.
-   * - **prefix** - The container that wraps the prefix slot.
-   * - **suffix** - The container that wraps the suffix slot.
-   * - **display-input** - The element that displays the selected option's label, an `<input>` element.
-   * - **listbox** - The listbox container where options are slotted.
-   * - **tags** - The container that houses option tags when `multiple` is used.
-   * - **tag** - The individual tags that represent each multiselect option.
-   * - **clear-button** - The clear button.
-   * - **expand-icon** - The container that wraps the expand icon.
-   */
-  "terra-select": DefineComponent<TerraSelectProps>;
-
   /**
    * Radio groups are used to group multiple radio buttons so they function as a single form control.
    * ---
@@ -2816,6 +2760,62 @@ export type CustomElements = {
    */
   "terra-scroll-hint": DefineComponent<TerraScrollHintProps>;
 
+  /**
+   * Select fields are a form field used to select one option from a list.
+   * ---
+   *
+   *
+   * ### **Events:**
+   *  - **terra-change** - Emitted when the control's value changes.
+   * - **terra-clear** - Emitted when the control's value is cleared.
+   * - **terra-input** - Emitted when the control receives input.
+   * - **terra-focus** - Emitted when the control gains focus.
+   * - **terra-blur** - Emitted when the control loses focus.
+   * - **terra-show** - Emitted when the select's menu opens.
+   * - **terra-after-show** - Emitted after the select's menu opens and all animations are complete.
+   * - **terra-hide** - Emitted when the select's menu closes.
+   * - **terra-after-hide** - Emitted after the select's menu closes and all animations are complete.
+   * - **terra-invalid** - Emitted when the form control has been checked for validity and its constraints aren't satisfied.
+   *
+   * ### **Methods:**
+   *  - **show()** - Shows the listbox.
+   * - **hide()** - Hides the listbox.
+   * - **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. Pass an empty string to restore validity.
+   * - **focus(options: _FocusOptions_)** - Sets focus on the control.
+   * - **blur()** - Removes focus from the control.
+   *
+   * ### **Slots:**
+   *  - _default_ - The listbox options. Must be `<terra-option>` elements.
+   * - **label** - The input's label. Alternatively, you can use the `label` attribute.
+   * - **prefix** - Used to prepend a presentational icon or similar element to the combobox.
+   * - **suffix** - Used to append a presentational icon or similar element to the combobox.
+   * - **clear-icon** - An icon to use in lieu of the default clear icon.
+   * - **expand-icon** - The icon to show when the control is expanded and collapsed. Rotates on open and close.
+   * - **help-text** - Text that describes how to use the input. Alternatively, you can use the `help-text` attribute.
+   *
+   * ### **CSS Properties:**
+   *  - **--terra-select-*** - All select design tokens from horizon.css are supported. _(default: undefined)_
+   *
+   * ### **CSS Parts:**
+   *  - **form-control** - The form control that wraps the label, input, and help text.
+   * - **form-control-label** - The label's wrapper.
+   * - **form-control-input** - The select's wrapper.
+   * - **form-control-help-text** - The help text's wrapper.
+   * - **combobox** - The container the wraps the prefix, suffix, combobox, clear icon, and expand button.
+   * - **prefix** - The container that wraps the prefix slot.
+   * - **suffix** - The container that wraps the suffix slot.
+   * - **display-input** - The element that displays the selected option's label, an `<input>` element.
+   * - **listbox** - The listbox container where options are slotted.
+   * - **tags** - The container that houses option tags when `multiple` is used.
+   * - **tag** - The individual tags that represent each multiselect option.
+   * - **clear-button** - The clear button.
+   * - **expand-icon** - The container that wraps the expand icon.
+   */
+  "terra-select": DefineComponent<TerraSelectProps>;
+
   /**
    * Site headers provide a consistent navigation structure at the top of pages.
    * ---
@@ -2836,31 +2836,31 @@ export type CustomElements = {
   "terra-site-header": DefineComponent<TerraSiteHeaderProps>;
 
   /**
-   * Skeletons are loading indicators to represent where content will eventually be drawn.
+   * Site navigation provides a flexible navigation structure with dropdown menus.
    * ---
    *
+   *
+   * ### **Slots:**
+   *  - _default_ - Navigation items. Can contain `<terra-dropdown>` elements or any custom navigation content.
+   *
+   * ### **CSS Parts:**
+   *  - **base** - The component's base wrapper.
    */
-  "terra-skeleton": DefineComponent<TerraSkeletonProps>;
+  "terra-site-navigation": DefineComponent<TerraSiteNavigationProps>;
 
   /**
-   *
+   * Skeletons are loading indicators to represent where content will eventually be drawn.
    * ---
    *
    */
-  "terra-slider": DefineComponent<TerraSliderProps>;
+  "terra-skeleton": DefineComponent<TerraSkeletonProps>;
 
   /**
-   * Site navigation provides a flexible navigation structure with dropdown menus.
-   * ---
    *
+   * ---
    *
-   * ### **Slots:**
-   *  - _default_ - Navigation items. Can contain `<terra-dropdown>` elements or any custom navigation content.
-   *
-   * ### **CSS Parts:**
-   *  - **base** - The component's base wrapper.
    */
-  "terra-site-navigation": DefineComponent<TerraSiteNavigationProps>;
+  "terra-slider": DefineComponent<TerraSliderProps>;
 
   /**
    * A component that allows input of coordinates and rendering of map.