@esri/calcite-components 1.0.0-next.509 → 1.0.0-next.511

package/dist/types/components.d.ts

@@ -1962,11 +1962,11 @@ export namespace Components {
     }
     interface CalciteList {
         /**
-          * When true, prevents user interaction.
+          * When true, interaction is prevented and the component is displayed with lower opacity.
          */
         "disabled": boolean;
         /**
-          * Number at which section headings should start for the list.
+          * Specifies the number at which section headings should start.
          */
         "headingLevel": HeadingLevel;
         /**
@@ -1976,19 +1976,19 @@ export namespace Components {
     }
     interface CalciteListItem {
         /**
-          * An optional description for the list item. Displays below the label text.
+          * A description for the component. Displays below the label text.
          */
-        "description": string;
+        "description"?: string;
         /**
-          * When true, prevents user interaction.
+          * When true, interaction is prevented and the component is displayed with lower opacity.
          */
         "disabled": boolean;
         /**
-          * The label text of the list item. Displays above the description text.
+          * The label text of the component. Displays above the description text.
          */
         "label": string;
         /**
-          * When true, prevents the content of the list item from user interaction.
+          * When true, prevents the content of the component from user interaction.
          */
         "nonInteractive": boolean;
         /**
@@ -1998,17 +1998,17 @@ export namespace Components {
     }
     interface CalciteListItemGroup {
         /**
-          * The title for all nested `calcite-list-item` rows.
+          * The header text for all nested `calcite-list-item` rows.
          */
         "heading": string;
         /**
-          * Number at which section headings should start for the group.
+          * Specifies the number at which section headings should start.
          */
         "headingLevel": HeadingLevel;
     }
     interface CalciteLoader {
         /**
-          * When true, the loader is active.
+          * When true, the component is active.
          */
         "active": boolean;
         /**
@@ -2016,19 +2016,19 @@ export namespace Components {
          */
         "inline": boolean;
         /**
-          * Accessible name for the loader.
+          * Accessible name for the component.
          */
         "label": string;
         /**
-          * Disables spacing around the loader.
+          * Disables spacing around the component.
          */
         "noPadding": boolean;
         /**
-          * Specify the scale of the loader.
+          * Specifies the size of the component.
          */
         "scale": Scale;
         /**
-          * Text that displays under the loading indicator.
+          * Text that displays under the component's indicator.
          */
         "text"?: string;
         /**
@@ -2036,29 +2036,29 @@ export namespace Components {
          */
         "type": "indeterminate" | "determinate";
         /**
-          * Valid only for determinate indicators. Percent complete of 100.
+          * The component's value. Valid only for determinate indicators. Percent complete of 100.
          */
         "value": number;
     }
     interface CalciteModal {
         /**
-          * When true, the `calcite-modal` is active.
+          * When true, the component is active.
          */
         "active": boolean;
         /**
-          * Sets the background color of `calcite-modal` content.
+          * Sets the background color of the component's content.
          */
         "backgroundColor": ModalBackgroundColor;
         /**
-          * Passes a function to run before the `calcite-modal` closes.
+          * Passes a function to run before the component closes.
          */
         "beforeClose"?: (el: HTMLElement) => Promise<void>;
         /**
-          * Adds a color bar to the top of `calcite-modal` for visual impact. Use color to add importance to destructive or workflow dialogs.
+          * Adds a color bar to the top of component for visual impact. Use color to add importance to destructive or workflow dialogs.
          */
         "color"?: "red" | "blue";
         /**
-          * When true, disables the close button within the `calcite-modal`.
+          * When true, disables the component's close button.
          */
         "disableCloseButton": boolean;
         /**
@@ -2066,11 +2066,11 @@ export namespace Components {
          */
         "disableEscape": boolean;
         /**
-          * When true, disables the closing of the `calcite-modal` when clicked outside.
+          * When true, disables the closing of the component when clicked outside.
          */
         "disableOutsideClose": boolean;
         /**
-          * When true, prevents the `calcite-modal` from expanding to the entire screen on mobile devices.
+          * When true, prevents the component from expanding to the entire screen on mobile devices.
          */
         "docked": boolean;
         /**
@@ -2080,11 +2080,11 @@ export namespace Components {
          */
         "focusElement": (el?: HTMLElement) => Promise<void>;
         /**
-          * Set the `calcite-modal` to always be fullscreen (overrides width).
+          * Sets the component to always be fullscreen (overrides width).
          */
         "fullscreen": boolean;
         /**
-          * Accessible label for the close button.
+          * Accessible name for the component's close button.
          */
         "intlClose": string;
         /**
@@ -2092,11 +2092,11 @@ export namespace Components {
          */
         "noPadding": boolean;
         /**
-          * Specify the scale of `calcite-modal`.
+          * Specifies the size of the component.
          */
         "scale": Scale;
         /**
-          * Set the scroll top of the `calcite-modal` content.
+          * Sets the scroll top of the component's content.
           * @param top
           * @param left
          */
@@ -2107,106 +2107,106 @@ export namespace Components {
          */
         "setFocus": (focusId?: "close-button") => Promise<void>;
         /**
-          * Set the width of the `calcite-modal`. Can use scale sizes or pass a number (displays in pixels).
+          * Specifies the width of the component. Can use scale sizes or pass a number (displays in pixels).
          */
         "width": Scale | number;
     }
     interface CalciteNotice {
         /**
-          * When true, the `calcite-notice` is active.
+          * When true, the component is active.
          */
         "active": boolean;
         /**
-          * The color for the `calcite-notice`. Color will apply to top border and icon.
+          * The color for the component's top border and icon.
          */
         "color": StatusColor;
         /**
-          * Shows a button the user can click to dismiss the `calcite-notice`.
+          * When true, a close button is added to the component.
          */
         "dismissible"?: boolean;
         /**
-          * When present, shows a default recommended icon. You can also pass a calcite-ui-icon name to display a requested icon.
+          * Specifies an icon to display - accepts Calcite UI icon names.
          */
         "icon": string | boolean;
         /**
-          * Accessible label for the close button.
+          * Accessible name for the close button.
           * @default "Close"
          */
         "intlClose": string;
         /**
-          * Specify the scale of `calcite-notice`.
+          * Specifies the size of the component.
          */
         "scale": Scale;
         /**
-          * Sets focus on the `calcite-notice`.
+          * Sets focus on the component.
          */
         "setFocus": () => Promise<void>;
         /**
-          * Specify the width of the `calcite-notice`.
+          * Specifies the width of the component.
          */
         "width": Width;
     }
     interface CalciteOption {
         /**
-          * When true, it prevents the option from being selected.
+          * When true, interaction is prevented and the component is displayed with lower opacity.
          */
         "disabled": boolean;
         /**
-          * The option label.
+          * Accessible name for the component.
          */
         "label": string;
         /**
-          * When true, this option is selected. Otherwise, false.
+          * When true, the component is selected.
          */
         "selected": boolean;
         /**
-          * The value associated with this option.
+          * The component's value.
          */
         "value": any;
     }
     interface CalciteOptionGroup {
         /**
-          * When true, it prevents selection from any of its associated options.
+          * When true, interaction is prevented and the component is displayed with lower opacity.
          */
         "disabled": boolean;
         /**
-          * The group label. This property is required.
+          * Accessible name for the component.
          */
         "label": string;
     }
     interface CalcitePagination {
         /**
-          * Go to the next page of results
+          * Go to the next page of results.
          */
         "nextPage": () => Promise<void>;
         /**
-          * number of items per page
+          * Specifies the number of items per page.
          */
         "num": number;
         /**
-          * Go to the previous page of results
+          * Go to the previous page of results.
          */
         "previousPage": () => Promise<void>;
         /**
-          * The scale of the pagination
+          * Specifies the size of the component.
          */
         "scale": Scale;
         /**
-          * index of item that should begin the page
+          * Specifies the starting item number.
          */
         "start": number;
         /**
-          * Used as an accessible label (aria-label) for the next button
+          * Accessible name for the component's next button.
           * @default "Next"
          */
         "textLabelNext": string;
         /**
-          * Used as an accessible label (aria-label) of the previous button
+          * Accessible name for the component's previous button.
           * @default "Previous"
          */
         "textLabelPrevious": string;
         /**
-          * total number of items
+          * Specifies the total number of items.
          */
         "total": number;
     }
@@ -2216,55 +2216,55 @@ export namespace Components {
          */
         "beforeBack"?: () => Promise<void>;
         /**
-          * Panel description
+          * A description for the component.
          */
         "description": string;
         /**
-          * When true, disabled prevents interaction. This state shows items with lower opacity/grayed.
+          * When true, interaction is prevented and the component is displayed with lower opacity.
          */
         "disabled": boolean;
         /**
-          * Hides the panel.
+          * When true, hides the component.
          */
         "dismissed": boolean;
         /**
-          * Displays a close button in the trailing side of the header.
+          * When true, a close button is added to the component.
          */
         "dismissible": boolean;
         /**
-          * Heading text.
+          * The component header text.
          */
         "heading"?: string;
         /**
-          * Number at which section headings should start for this component.
+          * Specifies the number at which section headings should start.
          */
         "headingLevel": HeadingLevel;
         /**
-          * Specifies the maximum height of the panel.
+          * Specifies the maximum height of the component.
          */
         "heightScale"?: Scale;
         /**
-          * 'Back' text string.
+          * Accessible name for the component's back button. The back button will only be shown when 'showBackButton' is true.
          */
         "intlBack"?: string;
         /**
-          * 'Close' text string for the close button. The close button will only be shown when 'dismissible' is true.
+          * Accessible name for the component's close button. The close button will only be shown when 'dismissible' is true.
          */
         "intlClose"?: string;
         /**
-          * 'Options' text string for the actions menu.
+          * Accessible name for the component's actions menu.
          */
         "intlOptions"?: string;
         /**
-          * When true, content is waiting to be loaded. This state shows a busy indicator.
+          * When true, a busy indicator is displayed.
          */
         "loading": boolean;
         /**
-          * Opens the action menu.
+          * When true, the action menu items in the `header-menu-actions` slot are open.
          */
         "menuOpen": boolean;
         /**
-          * Scrolls panel content to a particular set of coordinates.  ```   myCalcitePanel.scrollContentTo({     left: 0, // Specifies the number of pixels along the X axis to scroll the window or element.     top: 0, // Specifies the number of pixels along the Y axis to scroll the window or element     behavior: "auto" // Specifies whether the scrolling should animate smoothly (smooth), or happen instantly in a single jump (auto, the default value).   }); ```
+          * Scrolls the component's content to a specified set of coordinates.  ```   myCalcitePanel.scrollContentTo({     left: 0, // Specifies the number of pixels along the X axis to scroll the window or element.     top: 0, // Specifies the number of pixels along the Y axis to scroll the window or element     behavior: "auto" // Specifies whether the scrolling should animate smoothly (smooth), or happen instantly in a single jump (auto, the default value).   }); ```
           * @param options
          */
         "scrollContentTo": (options?: ScrollToOptions) => Promise<void>;
@@ -2274,7 +2274,7 @@ export namespace Components {
          */
         "setFocus": (focusId?: "dismiss-button" | "back-button") => Promise<void>;
         /**
-          * Shows a back button in the header.
+          * When true, displays a back button in the header.
          */
         "showBackButton": boolean;
         /**
@@ -2283,13 +2283,13 @@ export namespace Components {
          */
         "summary"?: string;
         /**
-          * This sets width of the panel.
+          * Specifies the width of the component.
          */
         "widthScale"?: Scale;
     }
     interface CalcitePickList {
         /**
-          * When true, disabled prevents interaction. This state shows items with lower opacity/grayed.
+          * When true, interaction is prevented and the component is displayed with lower opacity.
          */
         "disabled": boolean;
         /**
@@ -2301,23 +2301,23 @@ export namespace Components {
          */
         "filterPlaceholder": string;
         /**
-          * Returns the currently selected items
+          * Returns the component's selected `calcite-pick-list-item`s.
          */
         "getSelectedItems": () => Promise<Map<string, HTMLCalcitePickListItemElement>>;
         /**
-          * Number at which section headings should start for this component.
+          * Specifies the number at which section headings should start.
          */
         "headingLevel": HeadingLevel;
         /**
-          * When true, content is waiting to be loaded. This state shows a busy indicator.
+          * When true, a busy indicator is displayed.
          */
         "loading": boolean;
         /**
-          * Multiple works similar to standard radio buttons and checkboxes. When true, a user can select multiple items at a time. When false, only a single item can be selected at a time and selecting a new item will deselect any other selected items.
+          * Similar to standard radio buttons and checkboxes. When true, a user can select multiple `calcite-pick-list-item`s at a time. When false, only a single `calcite-pick-list-item` can be selected at a time, and a new selection will deselect previous selections.
          */
         "multiple": boolean;
         /**
-          * When true and single-selection is enabled, the selection will change when navigating items via the keyboard.
+          * When true and single-selection is enabled, the selection changes when navigating `calcite-pick-list-item`s via keyboard.
          */
         "selectionFollowsFocus": boolean;
         /**
@@ -2328,25 +2328,25 @@ export namespace Components {
     }
     interface CalcitePickListGroup {
         /**
-          * The title used for all nested `calcite-pick-list` rows.
+          * Specifies the title for all nested `calcite-pick-list-item`s.
          */
         "groupTitle": string;
         /**
-          * Number at which section headings should start for this component.
+          * Specifies the number at which section headings should start.
          */
         "headingLevel": HeadingLevel;
     }
     interface CalcitePickListItem {
         /**
-          * An optional description for this item.  This will appear below the label text.
+          * A description for the component that displays below the label text.
          */
         "description"?: string;
         /**
-          * When false, the item cannot be deselected by user interaction.
+          * When false, the component cannot be deselected by user interaction.
          */
         "disableDeselect": boolean;
         /**
-          * When true, the item cannot be clicked and is visually muted.
+          * When true, interaction is prevented and the component is displayed with lower opacity.
          */
         "disabled": boolean;
         /**
@@ -2355,25 +2355,25 @@ export namespace Components {
          */
         "icon"?: ICON_TYPES | null;
         /**
-          * Used as an accessible label (aria-label) for the "remove item" action. Only applicable if removable is true.
+          * Accessible name for the component's remove button. Only applicable if removable is "true".
           * @default "Remove"
          */
         "intlRemove": string;
         /**
-          * The main label for this item. This will appear next to the icon.
+          * Label and accessible name for the component. Appears next to the icon.
          */
         "label": string;
         /**
-          * Used to provide additional metadata to an item, primarily used when the parent list has a filter.
+          * Provides additional metadata to the component. Primary use is for a filter on the parent list.
          */
         "metadata"?: Record<string, unknown>;
         "nonInteractive": boolean;
         /**
-          * Set this to true to display a remove action that removes the item from the list.
+          * When true, displays a remove action that removes the item from the list.
          */
         "removable"?: boolean;
         /**
-          * Set this to true to pre-select an item. Toggles when an item is checked/unchecked.
+          * When true, selects an item. Toggles when an item is checked/unchecked.
          */
         "selected": boolean;
         /**
@@ -2381,35 +2381,35 @@ export namespace Components {
          */
         "setFocus": () => Promise<void>;
         /**
-          * Used to toggle the selection state. By default this won't trigger an event. The first argument allows the value to be coerced, rather than swapping values.
+          * Toggles the selection state. By default this won't trigger an event. The first argument allows the value to be coerced, rather than swapping values.
           * @param coerce
          */
         "toggleSelected": (coerce?: boolean) => Promise<void>;
         /**
-          * The item's associated value.
+          * The component's value.
          */
         "value": any;
     }
     interface CalcitePopover {
         /**
-          * Automatically closes any currently open popovers when clicking outside of a popover.
+          * When true and clicking outside of the component, automatically closes open `calcite-popover`s.
          */
         "autoClose": boolean;
         /**
-          * Display a close button within the Popover.
+          * When true, a close button is added to the component.
           * @deprecated use dismissible instead.
          */
         "closeButton": boolean;
         /**
-          * Prevents flipping the popover's placement when it starts to overlap its reference element.
+          * When true, prevents flipping the component's placement when overlapping its `referenceElement`.
          */
         "disableFlip": boolean;
         /**
-          * Removes the caret pointer.
+          * When true, removes the caret pointer.
          */
         "disablePointer": boolean;
         /**
-          * Display a close button within the Popover.
+          * When true, a close button is added to the component.
          */
         "dismissible": boolean;
         /**
@@ -2417,46 +2417,46 @@ export namespace Components {
          */
         "flipPlacements"?: ComputedPlacement[];
         /**
-          * Heading text.
+          * The component header text.
          */
         "heading"?: string;
         /**
-          * Number at which section headings should start for this component.
+          * Specifies the number at which section headings should start.
          */
         "headingLevel": HeadingLevel;
         /**
-          * Text for close button.
+          * Accessible name for the component's close button.
           * @default "Close"
          */
         "intlClose": string;
         /**
-          * Accessible name for the component
+          * Accessible name for the component.
          */
         "label": string;
         /**
-          * Offset the position of the popover away from the reference element.
+          * Offsets the position of the popover away from the `referenceElement`.
           * @default 6
          */
         "offsetDistance": number;
         /**
-          * Offset the position of the popover along the reference element.
+          * Offsets the position of the popover along the `referenceElement`.
          */
         "offsetSkidding": number;
         /**
-          * Display and position the component.
+          * When true, displays and positions the component.
          */
         "open": boolean;
         /**
-          * Describes the type of positioning to use for the overlaid content. If your element is in a fixed container, use the 'fixed' value.
+          * Describes the positioning type to use for the overlaid content. If the element is in a fixed container, use the "fixed" value.
          */
         "overlayPositioning": OverlayPositioning;
         /**
-          * Determines where the component will be positioned relative to the referenceElement.
+          * Determines where the component will be positioned relative to the `referenceElement`.
           * @see [PopperPlacement](https://github.com/Esri/calcite-components/blob/master/src/utils/popper.ts#L25)
          */
         "placement": PopperPlacement;
         /**
-          * Reference HTMLElement used to position this component according to the placement property. As a convenience, a string ID of the reference element can be used. However, setting this property to use an HTMLElement is preferred so that the component does not need to query the DOM for the referenceElement.
+          * The `referenceElement` used to position the component according to its "placement" value. Setting to an `HTMLElement` is preferred so the component does not need to query the DOM. However, a string `id` of the reference element can also be used.
          */
         "referenceElement": ReferenceElement | string;
         /**
@@ -2469,12 +2469,12 @@ export namespace Components {
          */
         "setFocus": (focusId?: "close-button") => Promise<void>;
         /**
-          * Toggles the popover's open property.
+          * Toggles the component's open property.
           * @param value
          */
         "toggle": (value?: boolean) => Promise<void>;
         /**
-          * Disables automatically toggling a popover when its referenceElement has been triggered. This property can be set to true to manage when a popover is open.
+          * When true, disables automatically toggling the component when its `referenceElement` has been triggered. This property can be set to "true" to manage when a popover is open.
          */
         "triggerDisabled": boolean;
     }
@@ -2491,23 +2491,23 @@ export namespace Components {
     }
     interface CalciteProgress {
         /**
-          * Label for the progress indicator
+          * Accessible name for the component.
          */
         "label": string;
         /**
-          * For indeterminate progress bars, reverse the animation direction
+          * When true and for indeterminate progress bars, reverses the animation direction.
          */
         "reversed": boolean;
         /**
-          * Text to display for the progress indicator
+          * Text that displays under the component's indicator.
          */
         "text": string;
         /**
-          * Use indeterminate if finding actual progress value is impossible
+          * Use indeterminate if finding actual progress value is impossible.
          */
         "type": "indeterminate" | "determinate";
         /**
-          * Fraction completed, in the range of 0 - 1.0
+          * The component's progress value, with a range of 0.0 - 1.0.
          */
         "value": number;
     }
@@ -3455,24 +3455,24 @@ export namespace Components {
     }
     interface CalciteTooltip {
         /**
-          * Closes the `calcite-tooltip` when the `referenceElement` is clicked.
+          * Closes the component when the `referenceElement` is clicked.
          */
         "closeOnClick": boolean;
         /**
-          * Accessible name for the `calcite-tooltip`.
+          * Accessible name for the component.
          */
         "label": string;
         /**
-          * Offset the position of the `calcite-tooltip` away from the `referenceElement`.
+          * Offset the position of the component away from the `referenceElement`.
           * @default 6
          */
         "offsetDistance": number;
         /**
-          * Offset the position of the `calcite-tooltip` along the `referenceElement`.
+          * Offset the position of the component along the `referenceElement`.
          */
         "offsetSkidding": number;
         /**
-          * When true, the `calcite-tooltip` is open.
+          * When true, the component is open.
          */
         "open": boolean;
         /**
@@ -3485,7 +3485,7 @@ export namespace Components {
          */
         "placement": PopperPlacement;
         /**
-          * The `referenceElement` to position `calcite-tooltip` according to its "placement" value. Setting to the `HTMLElement` is preferred so `calcite-tooltip` does not need to query the DOM for the `referenceElement`. However, a string ID of the reference element can be used.
+          * The `referenceElement` to position the component according to its "placement" value. Setting to the `HTMLElement` is preferred so the component does not need to query the DOM for the `referenceElement`. However, a string ID of the reference element can be used.
          */
         "referenceElement": ReferenceElement | string;
         /**
@@ -3508,15 +3508,15 @@ export namespace Components {
          */
         "inputEnabled": boolean;
         /**
-          * Display indentation guide lines.
+          * Displays indentation guide lines.
          */
         "lines": boolean;
         /**
-          * Specify the scale of the tree.
+          * Specifies the size of the component.
          */
         "scale": Scale;
         /**
-          * Customize how tree selection works.
+          * Customize how the component's selection works.
           * @default "single"
           * @see [TreeSelectionMode](https://github.com/Esri/calcite-components/blob/master/src/components/tree/interfaces.ts#L5)
          */
@@ -3525,7 +3525,7 @@ export namespace Components {
     interface CalciteTreeItem {
         "depth": number;
         /**
-          * Expanded state of the item.
+          * When true, the component is expanded.
          */
         "expanded": boolean;
         "hasChildren": boolean;
@@ -3542,22 +3542,22 @@ export namespace Components {
         "parentExpanded": boolean;
         "scale": Scale;
         /**
-          * Selected state of the item.
+          * When true, the component is selected.
          */
         "selected": boolean;
         "selectionMode": TreeSelectionMode;
     }
     interface CalciteValueList {
         /**
-          * When true, prevents user interaction. This state shows list items grayed out and with lower opacity.
+          * When true, interaction is prevented and the component is displayed with lower opacity.
          */
         "disabled": boolean;
         /**
-          * When true, list items are sortable via a draggable button.
+          * When true, `calcite-value-list-item`s are sortable via a draggable button.
          */
         "dragEnabled": boolean;
         /**
-          * When true, an input appears at the top of the list that can be used by end users to filter list items.
+          * When true, an input appears at the top of the component that can be used by end users to filter list items.
          */
         "filterEnabled": boolean;
         /**
@@ -3569,19 +3569,19 @@ export namespace Components {
          */
         "getSelectedItems": () => Promise<Map<string, HTMLCalciteValueListItemElement>>;
         /**
-          * The list's group identifier.  To drag elements from one list into another, both lists must have the same group value.
+          * The component's group identifier.  To drag elements from one list into another, both lists must have the same group value.
          */
         "group"?: string;
         /**
-          * When true, content is waiting to be loaded. This state shows a busy indicator.
+          * When true, a busy indicator is displayed.
          */
         "loading": boolean;
         /**
-          * Similar to standard radio buttons and checkboxes. When true, a user can select multiple list items at a time. When false, only a single list item can be selected at a time, and selecting a new list item will deselect any other selected list items.
+          * Similar to standard radio buttons and checkboxes. When true, a user can select multiple `calcite-value-list-item`s at a time. When false, only a single `calcite-value-list-item` can be selected at a time, and a new selection will deselect previous selections.
          */
         "multiple": boolean;
         /**
-          * When true and single-selection is enabled, the selection changes when navigating list items via the keyboard.
+          * When true and single-selection is enabled, the selection changes when navigating `calcite-value-list-item`s via keyboard.
          */
         "selectionFollowsFocus": boolean;
         /**
@@ -3592,12 +3592,12 @@ export namespace Components {
     }
     interface CalciteValueListItem {
         /**
-          * An optional description for the list item that displays below the label text.
+          * A description for the component that displays below the label text.
          */
         "description"?: string;
         "disableDeselect": boolean;
         /**
-          * When true, the list item cannot be clicked and is visually muted.
+          * When true, interaction is prevented and the component is displayed with lower opacity.
          */
         "disabled": boolean;
         "handleActivated"?: boolean;
@@ -3607,23 +3607,23 @@ export namespace Components {
          */
         "icon"?: ICON_TYPES | null;
         /**
-          * The main label for the list item. Appears next to the icon.
+          * Label and accessible name for the component. Appears next to the icon.
          */
         "label": string;
         /**
-          * Provides additional metadata to a list item. Primary use is for a filter on the parent list.
+          * Provides additional metadata to the component. Primary use is for a filter on the parent list.
          */
         "metadata"?: Record<string, unknown>;
         /**
-          * When true, prevents the content of the list item from user interaction.
+          * When true, prevents the content of the component from user interaction.
          */
         "nonInteractive": boolean;
         /**
-          * When true, adds an action to remove the list item.
+          * When true, adds an action to remove the component.
          */
         "removable": boolean;
         /**
-          * When true, preselects the list item. Toggles when an item is checked/unchecked.
+          * When true, the component is selected.
          */
         "selected": boolean;
         /**
@@ -3636,7 +3636,7 @@ export namespace Components {
          */
         "toggleSelected": (coerce?: boolean) => Promise<void>;
         /**
-          * The list item's associated value.
+          * The component's value.
          */
         "value": any;
     }
@@ -6464,45 +6464,45 @@ declare namespace LocalJSX {
     }
     interface CalciteList {
         /**
-          * When true, prevents user interaction.
+          * When true, interaction is prevented and the component is displayed with lower opacity.
          */
         "disabled"?: boolean;
         /**
-          * Number at which section headings should start for the list.
+          * Specifies the number at which section headings should start.
          */
         "headingLevel"?: HeadingLevel;
     }
     interface CalciteListItem {
         /**
-          * An optional description for the list item. Displays below the label text.
+          * A description for the component. Displays below the label text.
          */
         "description"?: string;
         /**
-          * When true, prevents user interaction.
+          * When true, interaction is prevented and the component is displayed with lower opacity.
          */
         "disabled"?: boolean;
         /**
-          * The label text of the list item. Displays above the description text.
+          * The label text of the component. Displays above the description text.
          */
         "label"?: string;
         /**
-          * When true, prevents the content of the list item from user interaction.
+          * When true, prevents the content of the component from user interaction.
          */
         "nonInteractive"?: boolean;
     }
     interface CalciteListItemGroup {
         /**
-          * The title for all nested `calcite-list-item` rows.
+          * The header text for all nested `calcite-list-item` rows.
          */
         "heading"?: string;
         /**
-          * Number at which section headings should start for the group.
+          * Specifies the number at which section headings should start.
          */
         "headingLevel"?: HeadingLevel;
     }
     interface CalciteLoader {
         /**
-          * When true, the loader is active.
+          * When true, the component is active.
          */
         "active"?: boolean;
         /**
@@ -6510,19 +6510,19 @@ declare namespace LocalJSX {
          */
         "inline"?: boolean;
         /**
-          * Accessible name for the loader.
+          * Accessible name for the component.
          */
         "label": string;
         /**
-          * Disables spacing around the loader.
+          * Disables spacing around the component.
          */
         "noPadding"?: boolean;
         /**
-          * Specify the scale of the loader.
+          * Specifies the size of the component.
          */
         "scale"?: Scale;
         /**
-          * Text that displays under the loading indicator.
+          * Text that displays under the component's indicator.
          */
         "text"?: string;
         /**
@@ -6530,29 +6530,29 @@ declare namespace LocalJSX {
          */
         "type"?: "indeterminate" | "determinate";
         /**
-          * Valid only for determinate indicators. Percent complete of 100.
+          * The component's value. Valid only for determinate indicators. Percent complete of 100.
          */
         "value"?: number;
     }
     interface CalciteModal {
         /**
-          * When true, the `calcite-modal` is active.
+          * When true, the component is active.
          */
         "active"?: boolean;
         /**
-          * Sets the background color of `calcite-modal` content.
+          * Sets the background color of the component's content.
          */
         "backgroundColor"?: ModalBackgroundColor;
         /**
-          * Passes a function to run before the `calcite-modal` closes.
+          * Passes a function to run before the component closes.
          */
         "beforeClose"?: (el: HTMLElement) => Promise<void>;
         /**
-          * Adds a color bar to the top of `calcite-modal` for visual impact. Use color to add importance to destructive or workflow dialogs.
+          * Adds a color bar to the top of component for visual impact. Use color to add importance to destructive or workflow dialogs.
          */
         "color"?: "red" | "blue";
         /**
-          * When true, disables the close button within the `calcite-modal`.
+          * When true, disables the component's close button.
          */
         "disableCloseButton"?: boolean;
         /**
@@ -6560,19 +6560,19 @@ declare namespace LocalJSX {
          */
         "disableEscape"?: boolean;
         /**
-          * When true, disables the closing of the `calcite-modal` when clicked outside.
+          * When true, disables the closing of the component when clicked outside.
          */
         "disableOutsideClose"?: boolean;
         /**
-          * When true, prevents the `calcite-modal` from expanding to the entire screen on mobile devices.
+          * When true, prevents the component from expanding to the entire screen on mobile devices.
          */
         "docked"?: boolean;
         /**
-          * Set the `calcite-modal` to always be fullscreen (overrides width).
+          * Sets the component to always be fullscreen (overrides width).
          */
         "fullscreen"?: boolean;
         /**
-          * Accessible label for the close button.
+          * Accessible name for the component's close button.
          */
         "intlClose"?: string;
         /**
@@ -6580,124 +6580,124 @@ declare namespace LocalJSX {
          */
         "noPadding"?: boolean;
         /**
-          * Emits when `calcite-modal` finishes the close animation.
+          * Emits when the component finishes the close animation.
          */
         "onCalciteModalClose"?: (event: CalciteModalCustomEvent<any>) => void;
         /**
-          * Emits when `calcite-modal` finishes the open animation.
+          * Emits when the component finishes the open animation.
          */
         "onCalciteModalOpen"?: (event: CalciteModalCustomEvent<any>) => void;
         /**
-          * Specify the scale of `calcite-modal`.
+          * Specifies the size of the component.
          */
         "scale"?: Scale;
         /**
-          * Set the width of the `calcite-modal`. Can use scale sizes or pass a number (displays in pixels).
+          * Specifies the width of the component. Can use scale sizes or pass a number (displays in pixels).
          */
         "width"?: Scale | number;
     }
     interface CalciteNotice {
         /**
-          * When true, the `calcite-notice` is active.
+          * When true, the component is active.
          */
         "active"?: boolean;
         /**
-          * The color for the `calcite-notice`. Color will apply to top border and icon.
+          * The color for the component's top border and icon.
          */
         "color"?: StatusColor;
         /**
-          * Shows a button the user can click to dismiss the `calcite-notice`.
+          * When true, a close button is added to the component.
          */
         "dismissible"?: boolean;
         /**
-          * When present, shows a default recommended icon. You can also pass a calcite-ui-icon name to display a requested icon.
+          * Specifies an icon to display - accepts Calcite UI icon names.
          */
         "icon"?: string | boolean;
         /**
-          * Accessible label for the close button.
+          * Accessible name for the close button.
           * @default "Close"
          */
         "intlClose"?: string;
         /**
-          * Fired when `calcite-notice` is closed.
+          * Fired when the component is closed.
          */
         "onCalciteNoticeClose"?: (event: CalciteNoticeCustomEvent<any>) => void;
         /**
-          * Fired when `calcite-notice` is opened.
+          * Fired when the component is opened.
          */
         "onCalciteNoticeOpen"?: (event: CalciteNoticeCustomEvent<any>) => void;
         /**
-          * Specify the scale of `calcite-notice`.
+          * Specifies the size of the component.
          */
         "scale"?: Scale;
         /**
-          * Specify the width of the `calcite-notice`.
+          * Specifies the width of the component.
          */
         "width"?: Width;
     }
     interface CalciteOption {
         /**
-          * When true, it prevents the option from being selected.
+          * When true, interaction is prevented and the component is displayed with lower opacity.
          */
         "disabled"?: boolean;
         /**
-          * The option label.
+          * Accessible name for the component.
          */
         "label"?: string;
         /**
-          * When true, this option is selected. Otherwise, false.
+          * When true, the component is selected.
          */
         "selected"?: boolean;
         /**
-          * The value associated with this option.
+          * The component's value.
          */
         "value"?: any;
     }
     interface CalciteOptionGroup {
         /**
-          * When true, it prevents selection from any of its associated options.
+          * When true, interaction is prevented and the component is displayed with lower opacity.
          */
         "disabled"?: boolean;
         /**
-          * The group label. This property is required.
+          * Accessible name for the component.
          */
         "label": string;
     }
     interface CalcitePagination {
         /**
-          * number of items per page
+          * Specifies the number of items per page.
          */
         "num"?: number;
         /**
-          * Emitted whenever the selected page changes.
-          * @see [PaginationDetail](https://github.com/Esri/calcite-components/blob/master/src/components/pagination/calcite-pagination.tsx#L18)
+          * Emits when the selected page changes.
+          * @see [PaginationDetail](https://github.com/Esri/calcite-components/blob/master/src/components/pagination/pagination.tsx#L23)
          */
         "onCalcitePaginationChange"?: (event: CalcitePaginationCustomEvent<PaginationDetail>) => void;
         /**
-          * Emitted whenever the selected page changes.
+          * Emits when the selected page changes.
           * @deprecated use calcitePaginationChange instead
          */
         "onCalcitePaginationUpdate"?: (event: CalcitePaginationCustomEvent<PaginationDetail>) => void;
         /**
-          * The scale of the pagination
+          * Specifies the size of the component.
          */
         "scale"?: Scale;
         /**
-          * index of item that should begin the page
+          * Specifies the starting item number.
          */
         "start"?: number;
         /**
-          * Used as an accessible label (aria-label) for the next button
+          * Accessible name for the component's next button.
           * @default "Next"
          */
         "textLabelNext"?: string;
         /**
-          * Used as an accessible label (aria-label) of the previous button
+          * Accessible name for the component's previous button.
           * @default "Previous"
          */
         "textLabelPrevious"?: string;
         /**
-          * total number of items
+          * Specifies the total number of items.
          */
         "total"?: number;
     }
@@ -6707,72 +6707,72 @@ declare namespace LocalJSX {
          */
         "beforeBack"?: () => Promise<void>;
         /**
-          * Panel description
+          * A description for the component.
          */
         "description"?: string;
         /**
-          * When true, disabled prevents interaction. This state shows items with lower opacity/grayed.
+          * When true, interaction is prevented and the component is displayed with lower opacity.
          */
         "disabled"?: boolean;
         /**
-          * Hides the panel.
+          * When true, hides the component.
          */
         "dismissed"?: boolean;
         /**
-          * Displays a close button in the trailing side of the header.
+          * When true, a close button is added to the component.
          */
         "dismissible"?: boolean;
         /**
-          * Heading text.
+          * The component header text.
          */
         "heading"?: string;
         /**
-          * Number at which section headings should start for this component.
+          * Specifies the number at which section headings should start.
          */
         "headingLevel"?: HeadingLevel;
         /**
-          * Specifies the maximum height of the panel.
+          * Specifies the maximum height of the component.
          */
         "heightScale"?: Scale;
         /**
-          * 'Back' text string.
+          * Accessible name for the component's back button. The back button will only be shown when 'showBackButton' is true.
          */
         "intlBack"?: string;
         /**
-          * 'Close' text string for the close button. The close button will only be shown when 'dismissible' is true.
+          * Accessible name for the component's close button. The close button will only be shown when 'dismissible' is true.
          */
         "intlClose"?: string;
         /**
-          * 'Options' text string for the actions menu.
+          * Accessible name for the component's actions menu.
          */
         "intlOptions"?: string;
         /**
-          * When true, content is waiting to be loaded. This state shows a busy indicator.
+          * When true, a busy indicator is displayed.
          */
         "loading"?: boolean;
         /**
-          * Opens the action menu.
+          * When true, the action menu items in the `header-menu-actions` slot are open.
          */
         "menuOpen"?: boolean;
         /**
-          * Emitted when the back button has been clicked.
+          * Fires when the back button is clicked.
          */
         "onCalcitePanelBackClick"?: (event: CalcitePanelCustomEvent<any>) => void;
         /**
-          * Emitted when the close button has been clicked.
+          * Fires when the close button is clicked.
          */
         "onCalcitePanelDismiss"?: (event: CalcitePanelCustomEvent<any>) => void;
         /**
-          * Emitted when the close button has been clicked.
+          * Fires when the close button is clicked.
           * @deprecated use calcitePanelDismiss instead.
          */
         "onCalcitePanelDismissedChange"?: (event: CalcitePanelCustomEvent<any>) => void;
         /**
-          * Emitted when the content has been scrolled.
+          * Fires when the content is scrolled.
          */
         "onCalcitePanelScroll"?: (event: CalcitePanelCustomEvent<any>) => void;
         /**
-          * Shows a back button in the header.
+          * When true, displays a back button in the header.
          */
         "showBackButton"?: boolean;
         /**
@@ -6781,13 +6781,13 @@ declare namespace LocalJSX {
          */
         "summary"?: string;
         /**
-          * This sets width of the panel.
+          * Specifies the width of the component.
          */
         "widthScale"?: Scale;
     }
     interface CalcitePickList {
         /**
-          * When true, disabled prevents interaction. This state shows items with lower opacity/grayed.
+          * When true, interaction is prevented and the component is displayed with lower opacity.
          */
         "disabled"?: boolean;
         /**
@@ -6799,47 +6799,47 @@ declare namespace LocalJSX {
          */
         "filterPlaceholder"?: string;
         /**
-          * Number at which section headings should start for this component.
+          * Specifies the number at which section headings should start.
          */
         "headingLevel"?: HeadingLevel;
         /**
-          * When true, content is waiting to be loaded. This state shows a busy indicator.
+          * When true, a busy indicator is displayed.
          */
         "loading"?: boolean;
         /**
-          * Multiple works similar to standard radio buttons and checkboxes. When true, a user can select multiple items at a time. When false, only a single item can be selected at a time and selecting a new item will deselect any other selected items.
+          * Similar to standard radio buttons and checkboxes. When true, a user can select multiple `calcite-pick-list-item`s at a time. When false, only a single `calcite-pick-list-item` can be selected at a time, and a new selection will deselect previous selections.
          */
         "multiple"?: boolean;
         /**
-          * Emitted when any of the item selections have changed.
+          * Emits when any of the `calcite-pick-list-item` selections have changed.
          */
         "onCalciteListChange"?: (event: CalcitePickListCustomEvent<Map<string, HTMLCalcitePickListItemElement>>) => void;
         /**
-          * When true and single-selection is enabled, the selection will change when navigating items via the keyboard.
+          * When true and single-selection is enabled, the selection changes when navigating `calcite-pick-list-item`s via keyboard.
          */
         "selectionFollowsFocus"?: boolean;
     }
     interface CalcitePickListGroup {
         /**
-          * The title used for all nested `calcite-pick-list` rows.
+          * Specifies the title for all nested `calcite-pick-list-item`s.
          */
         "groupTitle"?: string;
         /**
-          * Number at which section headings should start for this component.
+          * Specifies the number at which section headings should start.
          */
         "headingLevel"?: HeadingLevel;
     }
     interface CalcitePickListItem {
         /**
-          * An optional description for this item.  This will appear below the label text.
+          * A description for the component that displays below the label text.
          */
         "description"?: string;
         /**
-          * When false, the item cannot be deselected by user interaction.
+          * When false, the component cannot be deselected by user interaction.
          */
         "disableDeselect"?: boolean;
         /**
-          * When true, the item cannot be clicked and is visually muted.
+          * When true, interaction is prevented and the component is displayed with lower opacity.
          */
         "disabled"?: boolean;
         /**
@@ -6848,20 +6848,20 @@ declare namespace LocalJSX {
          */
         "icon"?: ICON_TYPES | null;
         /**
-          * Used as an accessible label (aria-label) for the "remove item" action. Only applicable if removable is true.
+          * Accessible name for the component's remove button. Only applicable if removable is "true".
           * @default "Remove"
          */
         "intlRemove"?: string;
         /**
-          * The main label for this item. This will appear next to the icon.
+          * Label and accessible name for the component. Appears next to the icon.
          */
         "label"?: string;
         /**
-          * Used to provide additional metadata to an item, primarily used when the parent list has a filter.
+          * Provides additional metadata to the component. Primary use is for a filter on the parent list.
          */
         "metadata"?: Record<string, unknown>;
         /**
-          * Emitted whenever the item is selected or unselected.
+          * Fires when the component is selected or unselected.
          */
         "onCalciteListItemChange"?: (event: CalcitePickListItemCustomEvent<{
     item: HTMLCalcitePickListItemElement;
@@ -6870,42 +6870,42 @@ declare namespace LocalJSX {
     shiftPressed: boolean;
   }>) => void;
         /**
-          * Emitted whenever the remove button is pressed.
+          * Fires when the remove button is pressed.
          */
         "onCalciteListItemRemove"?: (event: CalcitePickListItemCustomEvent<void>) => void;
         /**
-          * Set this to true to display a remove action that removes the item from the list.
+          * When true, displays a remove action that removes the item from the list.
          */
         "removable"?: boolean;
         /**
-          * Set this to true to pre-select an item. Toggles when an item is checked/unchecked.
+          * When true, selects an item. Toggles when an item is checked/unchecked.
          */
         "selected"?: boolean;
         /**
-          * The item's associated value.
+          * The component's value.
          */
         "value": any;
     }
     interface CalcitePopover {
         /**
-          * Automatically closes any currently open popovers when clicking outside of a popover.
+          * When true and clicking outside of the component, automatically closes open `calcite-popover`s.
          */
         "autoClose"?: boolean;
         /**
-          * Display a close button within the Popover.
+          * When true, a close button is added to the component.
           * @deprecated use dismissible instead.
          */
         "closeButton"?: boolean;
         /**
-          * Prevents flipping the popover's placement when it starts to overlap its reference element.
+          * When true, prevents flipping the component's placement when overlapping its `referenceElement`.
          */
         "disableFlip"?: boolean;
         /**
-          * Removes the caret pointer.
+          * When true, removes the caret pointer.
          */
         "disablePointer"?: boolean;
         /**
-          * Display a close button within the Popover.
+          * When true, a close button is added to the component.
          */
         "dismissible"?: boolean;
         /**
@@ -6913,58 +6913,58 @@ declare namespace LocalJSX {
          */
         "flipPlacements"?: ComputedPlacement[];
         /**
-          * Heading text.
+          * The component header text.
          */
         "heading"?: string;
         /**
-          * Number at which section headings should start for this component.
+          * Specifies the number at which section headings should start.
          */
         "headingLevel"?: HeadingLevel;
         /**
-          * Text for close button.
+          * Accessible name for the component's close button.
           * @default "Close"
          */
         "intlClose"?: string;
         /**
-          * Accessible name for the component
+          * Accessible name for the component.
          */
         "label": string;
         /**
-          * Offset the position of the popover away from the reference element.
+          * Offsets the position of the popover away from the `referenceElement`.
           * @default 6
          */
         "offsetDistance"?: number;
         /**
-          * Offset the position of the popover along the reference element.
+          * Offsets the position of the popover along the `referenceElement`.
          */
         "offsetSkidding"?: number;
         /**
-          * Fired when the popover is closed
+          * Fired when the component is closed.
          */
         "onCalcitePopoverClose"?: (event: CalcitePopoverCustomEvent<any>) => void;
         /**
-          * Fired when the popover is opened
+          * Fired when the component is opened.
          */
         "onCalcitePopoverOpen"?: (event: CalcitePopoverCustomEvent<any>) => void;
         /**
-          * Display and position the component.
+          * When true, displays and positions the component.
          */
         "open"?: boolean;
         /**
-          * Describes the type of positioning to use for the overlaid content. If your element is in a fixed container, use the 'fixed' value.
+          * Describes the positioning type to use for the overlaid content. If the element is in a fixed container, use the "fixed" value.
          */
         "overlayPositioning"?: OverlayPositioning;
         /**
-          * Determines where the component will be positioned relative to the referenceElement.
+          * Determines where the component will be positioned relative to the `referenceElement`.
           * @see [PopperPlacement](https://github.com/Esri/calcite-components/blob/master/src/utils/popper.ts#L25)
          */
         "placement"?: PopperPlacement;
         /**
-          * Reference HTMLElement used to position this component according to the placement property. As a convenience, a string ID of the reference element can be used. However, setting this property to use an HTMLElement is preferred so that the component does not need to query the DOM for the referenceElement.
+          * The `referenceElement` used to position the component according to its "placement" value. Setting to an `HTMLElement` is preferred so the component does not need to query the DOM. However, a string `id` of the reference element can also be used.
          */
         "referenceElement": ReferenceElement | string;
         /**
-          * Disables automatically toggling a popover when its referenceElement has been triggered. This property can be set to true to manage when a popover is open.
+          * When true, disables automatically toggling the component when its `referenceElement` has been triggered. This property can be set to "true" to manage when a popover is open.
          */
         "triggerDisabled"?: boolean;
     }
@@ -6981,23 +6981,23 @@ declare namespace LocalJSX {
     }
     interface CalciteProgress {
         /**
-          * Label for the progress indicator
+          * Accessible name for the component.
          */
         "label"?: string;
         /**
-          * For indeterminate progress bars, reverse the animation direction
+          * When true and for indeterminate progress bars, reverses the animation direction.
          */
         "reversed"?: boolean;
         /**
-          * Text to display for the progress indicator
+          * Text that displays under the component's indicator.
          */
         "text"?: string;
         /**
-          * Use indeterminate if finding actual progress value is impossible
+          * Use indeterminate if finding actual progress value is impossible.
          */
         "type"?: "indeterminate" | "determinate";
         /**
-          * Fraction completed, in the range of 0 - 1.0
+          * The component's progress value, with a range of 0.0 - 1.0.
          */
         "value"?: number;
     }
@@ -7896,24 +7896,24 @@ declare namespace LocalJSX {
     }
     interface CalciteTooltip {
         /**
-          * Closes the `calcite-tooltip` when the `referenceElement` is clicked.
+          * Closes the component when the `referenceElement` is clicked.
          */
         "closeOnClick"?: boolean;
         /**
-          * Accessible name for the `calcite-tooltip`.
+          * Accessible name for the component.
          */
         "label": string;
         /**
-          * Offset the position of the `calcite-tooltip` away from the `referenceElement`.
+          * Offset the position of the component away from the `referenceElement`.
           * @default 6
          */
         "offsetDistance"?: number;
         /**
-          * Offset the position of the `calcite-tooltip` along the `referenceElement`.
+          * Offset the position of the component along the `referenceElement`.
          */
         "offsetSkidding"?: number;
         /**
-          * When true, the `calcite-tooltip` is open.
+          * When true, the component is open.
          */
         "open"?: boolean;
         /**
@@ -7926,7 +7926,7 @@ declare namespace LocalJSX {
          */
         "placement"?: PopperPlacement;
         /**
-          * The `referenceElement` to position `calcite-tooltip` according to its "placement" value. Setting to the `HTMLElement` is preferred so `calcite-tooltip` does not need to query the DOM for the `referenceElement`. However, a string ID of the reference element can be used.
+          * The `referenceElement` to position the component according to its "placement" value. Setting to the `HTMLElement` is preferred so the component does not need to query the DOM for the `referenceElement`. However, a string ID of the reference element can be used.
          */
         "referenceElement"?: ReferenceElement | string;
     }
@@ -7944,20 +7944,20 @@ declare namespace LocalJSX {
          */
         "inputEnabled"?: boolean;
         /**
-          * Display indentation guide lines.
+          * Displays indentation guide lines.
          */
         "lines"?: boolean;
         /**
-          * Emits when the user selects/deselects tree items. An object including an array of selected items will be passed in the event's "detail" property.
+          * Fires when the user selects/deselects `calcite-tree-items`. An object including an array of selected items will be passed in the event's "detail" property.
           * @see [TreeSelectDetail](https://github.com/Esri/calcite-components/blob/master/src/components/tree/interfaces.ts#L1)
          */
         "onCalciteTreeSelect"?: (event: CalciteTreeCustomEvent<TreeSelectDetail>) => void;
         /**
-          * Specify the scale of the tree.
+          * Specifies the size of the component.
          */
         "scale"?: Scale;
         /**
-          * Customize how tree selection works.
+          * Customize how the component's selection works.
           * @default "single"
           * @see [TreeSelectionMode](https://github.com/Esri/calcite-components/blob/master/src/components/tree/interfaces.ts#L5)
          */
@@ -7965,25 +7965,25 @@ declare namespace LocalJSX {
     }
     interface CalciteTreeItem {
         /**
-          * Expanded state of the item.
+          * When true, the component is expanded.
          */
         "expanded"?: boolean;
         /**
-          * Selected state of the item.
+          * When true, the component is selected.
          */
         "selected"?: boolean;
     }
     interface CalciteValueList {
         /**
-          * When true, prevents user interaction. This state shows list items grayed out and with lower opacity.
+          * When true, interaction is prevented and the component is displayed with lower opacity.
          */
         "disabled"?: boolean;
         /**
-          * When true, list items are sortable via a draggable button.
+          * When true, `calcite-value-list-item`s are sortable via a draggable button.
          */
         "dragEnabled"?: boolean;
         /**
-          * When true, an input appears at the top of the list that can be used by end users to filter list items.
+          * When true, an input appears at the top of the component that can be used by end users to filter list items.
          */
         "filterEnabled"?: boolean;
         /**
@@ -7991,15 +7991,15 @@ declare namespace LocalJSX {
          */
         "filterPlaceholder"?: string;
         /**
-          * The list's group identifier.  To drag elements from one list into another, both lists must have the same group value.
+          * The component's group identifier.  To drag elements from one list into another, both lists must have the same group value.
          */
         "group"?: string;
         /**
-          * When true, content is waiting to be loaded. This state shows a busy indicator.
+          * When true, a busy indicator is displayed.
          */
         "loading"?: boolean;
         /**
-          * Similar to standard radio buttons and checkboxes. When true, a user can select multiple list items at a time. When false, only a single list item can be selected at a time, and selecting a new list item will deselect any other selected list items.
+          * Similar to standard radio buttons and checkboxes. When true, a user can select multiple `calcite-value-list-item`s at a time. When false, only a single `calcite-value-list-item` can be selected at a time, and a new selection will deselect previous selections.
          */
         "multiple"?: boolean;
         /**
@@ -8011,17 +8011,17 @@ declare namespace LocalJSX {
          */
         "onCalciteListOrderChange"?: (event: CalciteValueListCustomEvent<any[]>) => void;
         /**
-          * When true and single-selection is enabled, the selection changes when navigating list items via the keyboard.
+          * When true and single-selection is enabled, the selection changes when navigating `calcite-value-list-item`s via keyboard.
          */
         "selectionFollowsFocus"?: boolean;
     }
     interface CalciteValueListItem {
         /**
-          * An optional description for the list item that displays below the label text.
+          * A description for the component that displays below the label text.
          */
         "description"?: string;
         /**
-          * When true, the list item cannot be clicked and is visually muted.
+          * When true, interaction is prevented and the component is displayed with lower opacity.
          */
         "disabled"?: boolean;
         /**
@@ -8030,31 +8030,31 @@ declare namespace LocalJSX {
          */
         "icon"?: ICON_TYPES | null;
         /**
-          * The main label for the list item. Appears next to the icon.
+          * Label and accessible name for the component. Appears next to the icon.
          */
         "label": string;
         /**
-          * Provides additional metadata to a list item. Primary use is for a filter on the parent list.
+          * Provides additional metadata to the component. Primary use is for a filter on the parent list.
          */
         "metadata"?: Record<string, unknown>;
         /**
-          * When true, prevents the content of the list item from user interaction.
+          * When true, prevents the content of the component from user interaction.
          */
         "nonInteractive"?: boolean;
         /**
-          * Emits when the remove button is pressed.
+          * Fires when the remove button is pressed.
          */
         "onCalciteListItemRemove"?: (event: CalciteValueListItemCustomEvent<void>) => void;
         /**
-          * When true, adds an action to remove the list item.
+          * When true, adds an action to remove the component.
          */
         "removable"?: boolean;
         /**
-          * When true, preselects the list item. Toggles when an item is checked/unchecked.
+          * When true, the component is selected.
          */
         "selected"?: boolean;
         /**
-          * The list item's associated value.
+          * The component's value.
          */
         "value": any;
     }