@esri/calcite-components 1.0.0-next.596 → 1.0.0-next.597

package/dist/types/components.d.ts

@@ -10,6 +10,7 @@ import { Alignment, Appearance, Columns, DeprecatedEventPayload, FlipContext, La
 import { ItemKeyEvent, RegistryEntry, RequestedItem as RequestedItem1 } from "./components/accordion-item/interfaces";
 import { EffectivePlacement, LogicalPlacement, MenuPlacement, OverlayPositioning, ReferenceElement } from "./utils/floating-ui";
 import { AlertDuration, AlertPlacement, StatusColor, Sync } from "./components/alert/interfaces";
+import { NumberingSystem } from "./utils/locale";
 import { HeadingLevel } from "./components/functional/Heading";
 import { BlockSectionToggleDisplay } from "./components/block-section/interfaces";
 import { ButtonAlignment, ButtonAppearance, ButtonColor, DropdownIconType } from "./components/button/interfaces";
@@ -80,16 +81,16 @@ export namespace Components {
          */
         "heading"?: string;
         /**
-          * Specifies an icon to display - accepts Calcite UI icon names.
-          * @deprecated use `iconStart` or `iconEnd` properties instead
+          * Specifies an icon to display.
+          * @deprecated use `iconStart` or `iconEnd` instead.
          */
         "icon"?: string;
         /**
-          * Specified an icon to display at the end - accepts Calcite UI icon names.
+          * Specifies an icon to display at the end of the component.
          */
         "iconEnd"?: string;
         /**
-          * Specified an icon to display at the start - accepts Calcite UI icon names.
+          * Specifies an icon to display at the start of the component.
          */
         "iconStart"?: string;
         /**
@@ -125,7 +126,7 @@ export namespace Components {
          */
         "disabled": boolean;
         /**
-          * Specifies an icon to display - accepts Calcite UI icon names.
+          * Specifies an icon to display.
          */
         "icon"?: string;
         /**
@@ -249,7 +250,7 @@ export namespace Components {
          */
         "open": boolean;
         /**
-          * Determines the type of positioning to use for the overlaid content.  Using the "absolute" value will work for most cases. The component will be positioned inside of overflowing parent containers and will affect the container's layout. The "fixed" value should be used to escape an overflowing parent container, or when the reference element's `position` CSS property is "fixed".
+          * Determines the type of positioning to use for the overlaid content.  Using `"absolute"` will work for most cases. The component will be positioned inside of overflowing parent containers and will affect the container's layout. `"fixed"` should be used to escape an overflowing parent container, or when the reference element's `position` CSS property is `"fixed"`.
          */
         "overlayPositioning": OverlayPositioning;
         /**
@@ -332,6 +333,10 @@ export namespace Components {
           * Specifies an accessible name for the component.
          */
         "label": string;
+        /**
+          * Specifies the Unicode numeral system used by the component for localization.
+         */
+        "numberingSystem"?: NumberingSystem;
         /**
           * When true, opens the dropdown
          */
@@ -492,15 +497,15 @@ export namespace Components {
          */
         "href"?: string;
         /**
-          * optionally pass an icon to display at the end of a button - accepts calcite ui icon names
+          * Specifies an icon to display at the end of the component.
          */
         "iconEnd"?: string;
         /**
-          * flip the icon(s) in rtl
+          * When true, the icon will be flipped when the element direction is right-to-left (`"rtl"`).
          */
         "iconFlipRtl"?: FlipContext;
         /**
-          * optionally pass an icon to display at the start of a button - accepts calcite ui icon names
+          * Specifies an icon to display at the start of the component.
          */
         "iconStart"?: string;
         /**
@@ -613,7 +618,7 @@ export namespace Components {
          */
         "name": any;
         /**
-          * When true, makes the component required for form-submission.
+          * When true, the component must have a value in order for the form to submit.
          */
         "required": boolean;
         /**
@@ -657,11 +662,11 @@ export namespace Components {
          */
         "dismissible": boolean;
         /**
-          * optionally pass an icon to display - accepts Calcite UI icon names
+          * Specifies an icon to display.
          */
         "icon"?: string;
         /**
-          * flip the icon in rtl
+          * When true, the icon will be flipped when the element direction is right-to-left (`"rtl"`).
          */
         "iconFlipRtl": boolean;
         /**
@@ -807,9 +812,9 @@ export namespace Components {
          */
         "intlValue": string;
         /**
-          * standard UniCode numeral system tag for localization
+          * Specifies the Unicode numeral system used by the component for localization.
          */
-        "numberingSystem"?: string;
+        "numberingSystem"?: NumberingSystem;
         /**
           * The scale of the color picker.
          */
@@ -846,9 +851,9 @@ export namespace Components {
          */
         "intlNoColor": string;
         /**
-          * standard UniCode numeral system tag for localization
+          * Specifies the Unicode numeral system used by the component for localization.
          */
-        "numberingSystem"?: string;
+        "numberingSystem"?: NumberingSystem;
         /**
           * The component's scale.
          */
@@ -917,7 +922,7 @@ export namespace Components {
          */
         "open": boolean;
         /**
-          * Determines the type of positioning to use for the overlaid content.  Using the "absolute" value will work for most cases. The component will be positioned inside of overflowing parent containers and will affect the container's layout. The "fixed" value should be used to escape an overflowing parent container, or when the reference element's `position` CSS property is "fixed".
+          * Determines the type of positioning to use for the overlaid content.  Using `"absolute"` will work for most cases. The component will be positioned inside of overflowing parent containers and will affect the container's layout.  `"fixed"` should be used to escape an overflowing parent container, or when the reference element's `position` CSS property is `"fixed"`.
          */
         "overlayPositioning": OverlayPositioning;
         /**
@@ -933,7 +938,7 @@ export namespace Components {
          */
         "reposition": () => Promise<void>;
         /**
-          * When true, makes the component required for form-submission.
+          * When true, the component must have a value in order for the form to submit.
          */
         "required": boolean;
         /**
@@ -1046,7 +1051,7 @@ export namespace Components {
          */
         "intlYear"?: string;
         /**
-          * BCP 47 language tag for desired language and country format
+          * Specifies the BCP 47 language tag for the desired language and country format.
           * @deprecated set the global `lang` attribute on the element instead.
           * @mdn [lang](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/lang)
          */
@@ -1259,7 +1264,7 @@ export namespace Components {
          */
         "open": boolean;
         /**
-          * Determines the type of positioning to use for the overlaid content.  Using the "absolute" value will work for most cases. The component will be positioned inside of overflowing parent containers and will affect the container's layout. The "fixed" value should be used to escape an overflowing parent container, or when the reference element's `position` CSS property is "fixed".
+          * Determines the type of positioning to use for the overlaid content.  Using `"absolute"` will work for most cases. The component will be positioned inside of overflowing parent containers and will affect the container's layout.  `"fixed"` should be used to escape an overflowing parent container, or when the reference element's `position` CSS property is `"fixed"`.
          */
         "overlayPositioning": OverlayPositioning;
         /**
@@ -1314,15 +1319,15 @@ export namespace Components {
          */
         "href"?: string;
         /**
-          * optionally pass an icon to display at the end of an item - accepts calcite ui icon names
+          * Specifies an icon to display at the end of the component.
          */
         "iconEnd"?: string;
         /**
-          * flip the icon(s) in rtl
+          * When true, the icon will be flipped when the element direction is right-to-left (`"rtl"`).
          */
         "iconFlipRtl"?: FlipContext;
         /**
-          * optionally pass an icon to display at the start of an item - accepts calcite ui icon names
+          * Specifies an icon to display at the start of the component.
          */
         "iconStart"?: string;
         /**
@@ -1360,7 +1365,7 @@ export namespace Components {
          */
         "disabled": boolean;
         /**
-          * The name of the icon to display. The value of this property must match the icon name from https://esri.github.io/calcite-ui-icons/.
+          * Specifies an icon to display.
           * @default "plus"
          */
         "icon"?: string;
@@ -1488,7 +1493,8 @@ export namespace Components {
          */
         "menuOpen": boolean;
         /**
-          * Scrolls the component's content to a specified set of coordinates.  ```   myCalciteFlowItem.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.
+          * @example myCalciteFlowItem.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>;
@@ -1613,7 +1619,7 @@ export namespace Components {
          */
         "autofocus": boolean;
         /**
-          * When true, a clear button is displayed when the component has a value. The clear button shows by default for "search", "time", and "date" types, and will not display for the "textarea" type.
+          * When true, a clear button is displayed when the component has a value. The clear button shows by default for `"search"`, `"time"`, and `"date"` types, and will not display for the `"textarea"` type.
          */
         "clearable": boolean;
         /**
@@ -1636,24 +1642,24 @@ export namespace Components {
          */
         "icon": string | boolean;
         /**
-          * When true, the icon is flipped in RTL.
+          * When true, the icon will be flipped when the element direction is right-to-left (`"rtl"`).
          */
         "iconFlipRtl": boolean;
         /**
-          * A text label that will appear on the clear button for screen readers.
+          * Accessible name for the component's clear button.
          */
         "intlClear"?: string;
         /**
-          * Accessible name that will appear while loading.
+          * Accessible name when the component is loading.
           * @default "Loading"
          */
         "intlLoading"?: string;
         /**
-          * Accessible name for the component's button or hyperlink.
+          * Accessible name for the component.
          */
         "label"?: string;
         /**
-          * When true, the component is in the loading state and `calcite-progress` is displayed.
+          * When true, a busy indicator is displayed.
          */
         "loading": boolean;
         /**
@@ -1663,7 +1669,7 @@ export namespace Components {
          */
         "locale": string;
         /**
-          * Toggles locale formatting for numbers.
+          * When true, uses locale formatting for numbers.
          */
         "localeFormat": boolean;
         /**
@@ -1678,11 +1684,11 @@ export namespace Components {
         "maxLength"?: number;
         /**
           * Specifies the maximum length of text for the component's value.
-          * @deprecated use maxLength instead
+          * @deprecated use `maxLength` instead.
          */
         "maxlength"?: number;
         /**
-          * Specifies the minimum value for type "number".
+          * Specifies the minimum value for `type="number"`.
           * @mdn [min](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#min)
          */
         "min"?: number;
@@ -1692,19 +1698,18 @@ export namespace Components {
          */
         "minLength"?: number;
         /**
-          * Specifies the name of the component.
+          * Specifies the name of the component on form submission.
           * @mdn [name](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#name)
          */
         "name": string;
         /**
-          * Specifies the placement of the buttons for type "number".
+          * Specifies the placement of the buttons for `type="number"`.
          */
         "numberButtonType"?: InputPlacement;
         /**
           * Specifies the Unicode numeral system used by the component for localization.
-          * @mdn [numberingSystem](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/Locale/numberingSystem)
          */
-        "numberingSystem"?: string;
+        "numberingSystem"?: NumberingSystem;
         /**
           * Specifies placeholder text for the component.
           * @mdn [placeholder](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#placeholder)
@@ -1715,7 +1720,7 @@ export namespace Components {
          */
         "prefixText"?: string;
         /**
-          * When true, the value cannot be modified.
+          * When true, the component's value can be read, but cannot be modified.
           * @mdn [readOnly](https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/readonly)
          */
         "readOnly": boolean;
@@ -1740,7 +1745,7 @@ export namespace Components {
          */
         "status": Status;
         /**
-          * Specifies the granularity that the component's value must adhere to.
+          * Specifies the granularity the component's value must adhere to.
           * @mdn [step](https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/step)
          */
         "step"?: number | "any";
@@ -1749,7 +1754,7 @@ export namespace Components {
          */
         "suffixText"?: string;
         /**
-          * Specifies the component type.  Note that the following types add type-specific icons by default: "date", "email", "password", "search", "tel", "time".
+          * Specifies the component type.  Note that the following `type`s add type-specific icons by default: `"date"`, `"email"`, `"password"`, `"search"`, `"tel"`, `"time"`.
          */
         "type": | "color"
     | "date"
@@ -1774,22 +1779,22 @@ export namespace Components {
     }
     interface CalciteInputDatePicker {
         /**
-          * Expand or collapse when calendar does not have input
-          * @deprecated use open instead
+          * When true, the component is active.
+          * @deprecated use `open` instead.
          */
         "active": boolean;
         /**
-          * When false, the component won't be interactive.
+          * When true, interaction is prevented and the component is displayed with lower opacity.
          */
         "disabled": boolean;
         /**
-          * Selected end date
-          * @deprecated use value instead
+          * The component's end date.
+          * @deprecated use `value` instead.
          */
         "end"?: string;
         /**
-          * Selected end date as full date object
-          * @deprecated use valueAsDate instead
+          * The component's end date as a full date object.
+          * @deprecated use `valueAsDate` instead.
          */
         "endAsDate"?: Date;
         /**
@@ -1797,77 +1802,77 @@ export namespace Components {
          */
         "flipPlacements"?: EffectivePlacement[];
         /**
-          * Number at which section headings should start for this component.
+          * Specifies the number at which section headings should start.
          */
         "headingLevel": HeadingLevel;
         /**
-          * Localized string for "next month" (used for aria label)
+          * Accessible name for the component's next month button.
           * @default "Next month"
          */
         "intlNextMonth"?: string;
         /**
-          * Localized string for "previous month" (used for aria label)
+          * Accessible name for the component's previous month button.
           * @default "Previous month"
          */
         "intlPrevMonth"?: string;
         /**
-          * Localized string for "year" (used for aria label)
+          * Accessible name for the component's year input.
           * @default "Year"
          */
         "intlYear"?: string;
         /**
-          * Layout
+          * Defines the layout of the component.
          */
         "layout": "horizontal" | "vertical";
         /**
-          * BCP 47 language tag for desired language and country format
+          * Specifies the BCP 47 language tag for the desired language and country format.
           * @deprecated set the global `lang` attribute on the element instead.
           * @mdn [lang](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/lang)
          */
         "locale"?: string;
         /**
-          * Latest allowed date ("yyyy-mm-dd")
+          * Specifies the latest allowed date ("yyyy-mm-dd").
          */
         "max"?: string;
         /**
-          * Latest allowed date as full date object
+          * Specifies the latest allowed date as a full date object.
          */
         "maxAsDate"?: Date;
         /**
-          * Earliest allowed date ("yyyy-mm-dd")
+          * Specifies the earliest allowed date ("yyyy-mm-dd").
          */
         "min"?: string;
         /**
-          * Earliest allowed date as full date object
+          * Specifies the earliest allowed date as a full date object.
          */
         "minAsDate"?: Date;
         /**
-          * The picker's name. Gets submitted with the form.
+          * Specifies the name of the component on form submission.
          */
         "name": string;
         /**
-          * Expand or collapse when calendar does not have input
+          * When true, displays the `calcite-date-picker` component.
          */
         "open": boolean;
         /**
-          * Determines the type of positioning to use for the overlaid content.  Using the "absolute" value will work for most cases. The component will be positioned inside of overflowing parent containers and will affect the container's layout. The "fixed" value should be used to escape an overflowing parent container, or when the reference element's `position` CSS property is "fixed".
+          * Determines the type of positioning to use for the overlaid content.  Using `"absolute"` will work for most cases. The component will be positioned inside of overflowing parent containers and will affect the container's layout.  `"fixed"` should be used to escape an overflowing parent container, or when the reference element's `position` CSS property is `"fixed"`.
          */
         "overlayPositioning": OverlayPositioning;
         /**
-          * Determines where the date-picker component will be positioned relative to the input.
+          * Specifies the placement of the `calcite-date-picker` relative to the component.
           * @default "bottom-start"
          */
         "placement": MenuPlacement;
         /**
-          * Disables the default behaviour on the third click of narrowing or extending the range and instead starts a new range.
+          * When true, disables the default behavior on the third click of narrowing or extending the range. Instead starts a new range.
          */
         "proximitySelectionDisabled": boolean;
         /**
-          * Range mode activation
+          * When true, activates a range for the component.
          */
         "range": boolean;
         /**
-          * When true, still focusable but controls are gone and the value cannot be modified.
+          * When true, the component's value can be read, but controls are not accessible and the value cannot be modified.
           * @mdn [readOnly](https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/readonly)
          */
         "readOnly": boolean;
@@ -1876,56 +1881,56 @@ export namespace Components {
          */
         "reposition": () => Promise<void>;
         /**
-          * When true, makes the component required for form-submission.
+          * When true, the component must have a value in order for the form to submit.
          */
         "required": boolean;
         /**
-          * specify the scale of the date picker
+          * Specifies the size of the component.
          */
         "scale": "s" | "m" | "l";
         /**
-          * Updates the position of the component.
+          * Sets focus on the component.
          */
         "setFocus": () => Promise<void>;
         /**
-          * Selected start date
-          * @deprecated use value instead
+          * The component's start date.
+          * @deprecated use `value` instead.
          */
         "start"?: string;
         /**
-          * Selected start date as full date object
-          * @deprecated use valueAsDate instead
+          * The component's start date as a full date object.
+          * @deprecated use `valueAsDate` instead.
          */
         "startAsDate"?: Date;
         /**
-          * Selected date
+          * The component's value.
          */
         "value": string | string[];
         /**
-          * Selected date as full date object
+          * The component's value as a full date object.
          */
         "valueAsDate"?: Date | Date[];
     }
     interface CalciteInputMessage {
         /**
-          * Indicates whether the message is displayed.
+          * When true, the component is active.
          */
         "active": boolean;
         /**
-          * when used as a boolean set to true, show a default icon based on status. You can also pass a calcite-ui-icon name to this prop to display a custom icon
+          * Specifies an icon to display.
          */
         "icon": boolean | string;
         /**
-          * specify the scale of the input, defaults to m
+          * Specifies the size of the component.
          */
         "scale": Scale;
         /**
-          * specify the status of the input field, determines message and icons
+          * Specifies the status of the input field, which determines message and icons.
          */
         "status": Status;
         /**
-          * specify the appearance of any slotted message - default (displayed under input), or floating (positioned absolutely under input)
-          * @deprecated "floating" type is no longer supported
+          * Specifies the appearance of a slotted message - `"default"` (displayed under the component), or `"floating"` (positioned absolutely under the component).
+          * @deprecated The `"floating"` type is no longer supported.
          */
         "type": "default";
     }
@@ -1963,7 +1968,7 @@ export namespace Components {
          */
         "icon": string | boolean;
         /**
-          * When true, the icon is flipped in RTL.
+          * When true, the icon will be flipped when the element direction is right-to-left (`"rtl"`).
          */
         "iconFlipRtl": boolean;
         /**
@@ -2024,9 +2029,8 @@ export namespace Components {
         "numberButtonType"?: InputPlacement1;
         /**
           * Specifies the Unicode numeral system used by the component for localization.
-          * @mdn [numberingSystem](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/Locale/numberingSystem)
          */
-        "numberingSystem"?: string;
+        "numberingSystem"?: NumberingSystem;
         /**
           * Specifies placeholder text for the component.
           * @mdn [placeholder](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#placeholder)
@@ -2037,7 +2041,7 @@ export namespace Components {
          */
         "prefixText"?: string;
         /**
-          * When true, the value cannot be modified.
+          * When true, the component's value can be read, but cannot be modified.
           * @mdn [readOnly](https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/readonly)
          */
         "readOnly": boolean;
@@ -2105,7 +2109,7 @@ export namespace Components {
          */
         "icon": string | boolean;
         /**
-          * When true, the icon is flipped in RTL.
+          * When true, the icon will be flipped when the element direction is right-to-left (`"rtl"`).
          */
         "iconFlipRtl": boolean;
         /**
@@ -2150,7 +2154,7 @@ export namespace Components {
          */
         "prefixText"?: string;
         /**
-          * When true, the value cannot be modified.
+          * When true, the component's value can be read, but cannot be modified.
           * @mdn [readOnly](https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/readonly)
          */
         "readOnly": boolean;
@@ -2185,70 +2189,70 @@ export namespace Components {
     }
     interface CalciteInputTimePicker {
         /**
-          * The active state of the time input
-          * @deprecated Use open instead.
+          * When true, the component is active.
+          * @deprecated Use `open` instead.
          */
         "active": boolean;
         /**
-          * The disabled state of the time input
+          * When true, interaction is prevented and the component is displayed with lower opacity.
          */
         "disabled": boolean;
         /**
-          * aria-label for the hour input
+          * Accessible name for the component's hour input.
          */
         "intlHour"?: string;
         /**
-          * aria-label for the hour down button
+          * Accessible name for the component's hour down button.
          */
         "intlHourDown"?: string;
         /**
-          * aria-label for the hour up button
+          * Accessible name for the component's hour up button.
          */
         "intlHourUp"?: string;
         /**
-          * aria-label for the meridiem (am/pm) input
+          * Accessible name for the component's meridiem (am/pm) input.
          */
         "intlMeridiem"?: string;
         /**
-          * aria-label for the meridiem (am/pm) down button
+          * Accessible name for the component's meridiem (am/pm) down button.
          */
         "intlMeridiemDown"?: string;
         /**
-          * aria-label for the meridiem (am/pm) up button
+          * Accessible name for the component's meridiem (am/pm) up button.
          */
         "intlMeridiemUp"?: string;
         /**
-          * aria-label for the minute input
+          * Accessible name for the component's minute input.
          */
         "intlMinute"?: string;
         /**
-          * aria-label for the minute down button
+          * Accessible name for the component's minute down button.
          */
         "intlMinuteDown"?: string;
         /**
-          * aria-label for the minute up button
+          * Accessible name for the component's minute up button.
          */
         "intlMinuteUp"?: string;
         /**
-          * aria-label for the second input
+          * Accessible name for the component's second input.
          */
         "intlSecond"?: string;
         /**
-          * aria-label for the second down button
+          * Accessible name for the component's second down button.
          */
         "intlSecondDown"?: string;
         /**
-          * aria-label for the second up button
+          * Accessible name for the component's second up button.
          */
         "intlSecondUp"?: string;
         /**
-          * BCP 47 language tag for desired language and country format
+          * BCP 47 language tag for desired language and country format.
           * @deprecated set the global `lang` attribute on the element instead.
           * @mdn [lang](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/lang)
          */
         "locale": string;
         /**
-          * The name of the time input
+          * Specifies the name of the component on form submission.
          */
         "name": string;
         /**
@@ -2256,7 +2260,7 @@ export namespace Components {
          */
         "open": boolean;
         /**
-          * Determines the type of positioning to use for the overlaid content.  Using the "absolute" value will work for most cases. The component will be positioned inside of overflowing parent containers and will affect the container's layout. The "fixed" value should be used to escape an overflowing parent container, or when the reference element's `position` CSS property is "fixed".
+          * Determines the type of positioning to use for the overlaid content.  Using `"absolute"` will work for most cases. The component will be positioned inside of overflowing parent containers and will affect the container's layout.  `"fixed"` should be used to escape an overflowing parent container, or when the reference element's `position` CSS property is `"fixed"`.
          */
         "overlayPositioning": OverlayPositioning;
         /**
@@ -2265,7 +2269,7 @@ export namespace Components {
          */
         "placement": LogicalPlacement;
         /**
-          * When true, still focusable but controls are gone and the value cannot be modified.
+          * When true, the component's value can be read, but controls are not accessible and the value cannot be modified.
           * @mdn [readOnly](https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/readonly)
          */
         "readOnly": boolean;
@@ -2274,11 +2278,11 @@ export namespace Components {
          */
         "reposition": () => Promise<void>;
         /**
-          * When true, makes the component required for form-submission.
+          * When true, the component must have a value in order for the form to submit.
          */
         "required": boolean;
         /**
-          * The scale (size) of the time input
+          * Specifies the size of the component.
          */
         "scale": Scale;
         /**
@@ -2286,74 +2290,74 @@ export namespace Components {
          */
         "setFocus": () => Promise<void>;
         /**
-          * number (seconds) that specifies the granularity that the value must adhere to
+          * Specifies the granularity the component's `value` must adhere to (in seconds).
          */
         "step": number;
         /**
-          * The selected time in UTC (always 24-hour format)
+          * The component's value in UTC (always 24-hour format).
          */
         "value": string;
     }
     interface CalciteLabel {
         /**
-          * specify the text alignment of the label
+          * Specifies the text alignment of the component.
          */
         "alignment": Alignment;
         /**
-          * eliminates any space around the label
-          * @deprecated set the --calcite-label-margin-bottom css variable to 0 instead
+          * When true, disables the component's spacing.
+          * @deprecated Set the `--calcite-label-margin-bottom` css variable to `0` instead.
          */
         "disableSpacing": boolean;
         /**
-          * is the label disabled
-          * @deprecated use the `disabled` property on the interactive components instead
+          * When true, interaction is prevented and the component is displayed with lower opacity.
+          * @deprecated Use the `disabled` property on the component the label is bound to instead.
          */
         "disabled": boolean;
         /**
-          * The id of the input associated with the label
+          * Specifies the `id` of the component the label is bound to. Use when the component the label is bound to does not reside within the component.
          */
         "for": string;
         /**
-          * is the wrapped element positioned inline with the label slotted text
+          * Defines the layout of the label in relation to the component. Use `"inline"` positions to wrap the label and component on the same line.
          */
         "layout": "inline" | "inline-space-between" | "default";
         /**
-          * specify the scale of the label, defaults to m
+          * Specifies the size of the component.
          */
         "scale": Scale;
         /**
-          * specify the status of the label and any child input / input messages
-          * @deprecated set directly on child element instead
+          * Specifies the status of the component and any child input, or input messages.
+          * @deprecated Set directly on the component the label is bound to instead.
          */
         "status": Status;
     }
     interface CalciteLink {
         /**
-          * is the link disabled
+          * When true, interaction is prevented and the component is displayed with lower opacity.
          */
         "disabled": boolean;
         /**
-          * Prompts the user to save the linked URL instead of navigating to it. Can be used with or without a value: Without a value, the browser will suggest a filename/extension See: https://developer.mozilla.org/en-US/docs/Web/HTML/Element/a#attr-download
+          * Prompts the user to save the linked URL instead of navigating to it. Can be used with or without a value: Without a value, the browser will suggest a filename/extension See https://developer.mozilla.org/en-US/docs/Web/HTML/Element/a#attr-download.
          */
         "download": string | boolean;
         /**
-          * optionally pass a href - used to determine if the component should render as a link or an anchor
+          * Specifies the URL of the linked resource, which can be set as an absolute or relative path.
          */
         "href"?: string;
         /**
-          * optionally pass an icon to display at the end of a button - accepts calcite ui icon names
+          * Specifies an icon to display at the end of the component.
          */
         "iconEnd"?: string;
         /**
-          * flip the icon(s) in rtl
+          * When true, the icon will be flipped when the element direction is right-to-left (`"rtl"`).
          */
         "iconFlipRtl"?: FlipContext;
         /**
-          * optionally pass an icon to display at the start of a button - accepts calcite ui icon names
+          * Specifies an icon to display at the start of the component.
          */
         "iconStart"?: string;
         /**
-          * The rel attribute to apply to the hyperlink
+          * Specifies the relationship to the linked document defined in `href`.
          */
         "rel"?: string;
         /**
@@ -2361,7 +2365,7 @@ export namespace Components {
          */
         "setFocus": () => Promise<void>;
         /**
-          * The target attribute to apply to the hyperlink
+          * Specifies the frame or window to open the linked document.
          */
         "target"?: string;
     }
@@ -2543,7 +2547,7 @@ export namespace Components {
          */
         "dismissible"?: boolean;
         /**
-          * When present, shows a default recommended icon. You can also pass a calcite-ui-icon name to display a requested icon.
+          * When true, shows a default recommended icon. Alternatively, pass a Calcite UI Icon name to display a specific icon.
          */
         "icon": string | boolean;
         /**
@@ -2611,9 +2615,8 @@ export namespace Components {
         "num": number;
         /**
           * Specifies the Unicode numeral system used by the component for localization.
-          * @mdn [numberingSystem](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/Locale/numberingSystem)
          */
-        "numberingSystem"?: string;
+        "numberingSystem"?: NumberingSystem;
         /**
           * Go to the previous page of results.
          */
@@ -2707,7 +2710,8 @@ export namespace Components {
          */
         "menuOpen": boolean;
         /**
-          * 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).   }); ```
+          * Scrolls the component's content to a specified set of coordinates.
+          * @example myCalciteFlowItem.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>;
@@ -2896,7 +2900,7 @@ export namespace Components {
          */
         "open": boolean;
         /**
-          * Determines the type of positioning to use for the overlaid content.  Using the "absolute" value will work for most cases. The component will be positioned inside of overflowing parent containers and will affect the container's layout. The "fixed" value should be used to escape an overflowing parent container, or when the reference element's `position` CSS property is "fixed".
+          * Determines the type of positioning to use for the overlaid content.  Using `"absolute"` will work for most cases. The component will be positioned inside of overflowing parent containers and will affect the container's layout.  `"fixed"` value should be used to escape an overflowing parent container, or when the reference element's `position` CSS property is `"fixed"`.
          */
         "overlayPositioning": OverlayPositioning;
         /**
@@ -2995,7 +2999,7 @@ export namespace Components {
          */
         "name": string;
         /**
-          * When true, the component must have a value selected from the `calcite-radio-button-group` on form submission.
+          * When true, the component must have a value selected from the `calcite-radio-button-group` in order for the form to submit.
          */
         "required": boolean;
         /**
@@ -3029,7 +3033,7 @@ export namespace Components {
          */
         "name": string;
         /**
-          * When true, the component must have a value on form submission.
+          * When true, the component must have a value in order for the form to submit.
          */
         "required": boolean;
         /**
@@ -3055,7 +3059,7 @@ export namespace Components {
          */
         "name": string;
         /**
-          * When true, the component must have a value on form submission.
+          * When true, the component must have a value in order for the form to submit.
          */
         "required": boolean;
         /**
@@ -3086,25 +3090,25 @@ export namespace Components {
          */
         "checked": boolean;
         /**
-          * Optionally pass an icon to display - accepts Calcite UI icon names
-          * @deprecated Use either iconStart or iconEnd but do not combine them with icon & iconPosition.
+          * Specifies an icon to display.
+          * @deprecated Use either `iconStart` or `iconEnd` but do not combine them with `icon` and `iconPosition`.
          */
         "icon"?: string;
         /**
-          * Optionally pass an icon to display at the end - accepts Calcite UI icon names
+          * Specifies an icon to display at the end of the component.
          */
         "iconEnd"?: string;
         /**
-          * When true, the icon will be flipped when the element direction is right-to-left ("rtl").
+          * When true, the icon will be flipped when the element direction is right-to-left (`"rtl"`).
          */
         "iconFlipRtl": boolean;
         /**
-          * Optionally used with icon, select where to position the icon
-          * @deprecated Use either iconStart or iconEnd but do not combine them with icon & iconPosition.
+          * Specifies the placement of the icon.
+          * @deprecated Use either `iconStart` or `iconEnd` but do not combine them with `icon` and `iconPosition`.
          */
         "iconPosition"?: Position;
         /**
-          * Optionally pass an icon to display at the start - accepts Calcite UI icon names
+          * Specifies an icon to display at the start of the component.
          */
         "iconStart"?: string;
         /**
@@ -3144,7 +3148,7 @@ export namespace Components {
          */
         "readOnly": boolean;
         /**
-          * When true, the component must have a value on form submission.
+          * When true, the component must have a value in order for the form to submit.
          */
         "required": boolean;
         /**
@@ -3189,7 +3193,7 @@ export namespace Components {
          */
         "name": string;
         /**
-          * When true, the component must have a value on form submission.
+          * When true, the component must have a value in order for the form to submit.
          */
         "required": boolean;
         /**
@@ -3230,7 +3234,7 @@ export namespace Components {
          */
         "heightScale": Scale;
         /**
-          * Specifies the component's position. Will be flipped when the element direction is right-to-left ("rtl").
+          * Specifies the component's position. Will be flipped when the element direction is right-to-left (`"rtl"`).
          */
         "position": Position;
     }
@@ -3253,7 +3257,7 @@ export namespace Components {
          */
         "intlResize": string;
         /**
-          * Specifies the component's position. Will be flipped when the element direction is right-to-left ("rtl").
+          * Specifies the component's position. Will be flipped when the element direction is right-to-left (`"rtl"`).
          */
         "position": Position;
         /**
@@ -3329,9 +3333,8 @@ export namespace Components {
         "name": string;
         /**
           * Specifies the Unicode numeral system used by the component for localization.
-          * @mdn [numberingSystem](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/Locale/numberingSystem)
          */
-        "numberingSystem"?: string;
+        "numberingSystem"?: NumberingSystem;
         /**
           * Specifies the interval to move with the page up, or page down keys.
          */
@@ -3341,7 +3344,7 @@ export namespace Components {
          */
         "precise": boolean;
         /**
-          * When true, the component must have a value on form submission.
+          * When true, the component must have a value in order for the form to submit.
          */
         "required": boolean;
         /**
@@ -3425,19 +3428,19 @@ export namespace Components {
          */
         "loading": boolean;
         /**
-          * Determines the type of positioning to use for the overlaid content.  Using the "absolute" value will work for most cases. The component will be positioned inside of overflowing parent containers and will affect the container's layout. The "fixed" value should be used to escape an overflowing parent container, or when the reference element's `position` CSS property is "fixed".
+          * Determines the type of positioning to use for the overlaid content.  Using `"absolute"` will work for most cases. The component will be positioned inside of overflowing parent containers and will affect the container's layout.  `"fixed"` should be used to escape an overflowing parent container, or when the reference element's `position` CSS property is `"fixed"`.
          */
         "overlayPositioning": OverlayPositioning;
         /**
-          * Specifies an icon to display at the end of the primary button - accepts Calcite UI icon names.
+          * Specifies an icon to display at the end of the primary button.
          */
         "primaryIconEnd"?: string;
         /**
-          * When true, the primary button icon will be flipped when the element direction is right-to-left ("rtl").
+          * When true, the primary button icon will be flipped when the element direction is right-to-left (`"rtl"`).
          */
         "primaryIconFlipRtl"?: FlipContext;
         /**
-          * Specifies an icon to display at the start of the primary button - accepts Calcite UI icon names.
+          * Specifies an icon to display at the start of the primary button.
          */
         "primaryIconStart"?: string;
         /**
@@ -3525,12 +3528,12 @@ export namespace Components {
         "icon": boolean;
         /**
           * A description for the component. Displays below the header text.
-          * @deprecated use "description" instead.
+          * @deprecated use `description` instead.
          */
         "itemSubtitle"?: string;
         /**
           * The component header text.
-          * @deprecated use "heading" instead.
+          * @deprecated use `heading` instead.
          */
         "itemTitle"?: string;
         "layout"?: Extract<"horizontal" | "vertical", Layout>;
@@ -3569,7 +3572,7 @@ export namespace Components {
         "setFocus": () => Promise<void>;
         /**
           * When true, the component is checked.
-          * @deprecated use "checked" instead.
+          * @deprecated use `checked` instead.
          */
         "switched": boolean;
         /**
@@ -3580,7 +3583,7 @@ export namespace Components {
     interface CalciteTab {
         /**
           * When true, the component's contents are selected.  Only one tab can be selected within the `calcite-tabs` parent.
-          * @deprecated Use "selected" instead.
+          * @deprecated Use `selected` instead.
          */
         "active": boolean;
         /**
@@ -3621,7 +3624,7 @@ export namespace Components {
     interface CalciteTabTitle {
         /**
           * When true, the component and its respective `calcite-tab` contents are selected.  Only one tab can be selected within the `calcite-tabs` parent.
-          * @deprecated Use "selected" instead.
+          * @deprecated Use `selected` instead.
          */
         "active": boolean;
         "bordered": boolean;
@@ -3635,15 +3638,15 @@ export namespace Components {
          */
         "getTabIndex": () => Promise<number>;
         /**
-          * Specifies an icon to display at the end of the component - accepts Calcite UI icon names.
+          * Specifies an icon to display at the end of the component.
          */
         "iconEnd"?: string;
         /**
-          * When true, the icon will be flipped when the element direction is right-to-left ("rtl").
+          * When true, the icon will be flipped when the element direction is right-to-left (`"rtl"`).
          */
         "iconFlipRtl"?: FlipContext;
         /**
-          * Specifies an icon to display at the start of the component - accepts Calcite UI icon names.
+          * Specifies an icon to display at the start of the component.
          */
         "iconStart"?: string;
         "layout": TabLayout;
@@ -3779,7 +3782,7 @@ export namespace Components {
          */
         "disabled": boolean;
         /**
-          * Defines the layout of the component.  Use "horizontal" for rows, and "vertical" for a single column.
+          * Defines the layout of the component.  Use `"horizontal"` for rows, and `"vertical"` for a single column.
          */
         "layout"?: TileSelectGroupLayout;
     }
@@ -3961,7 +3964,7 @@ export namespace Components {
          */
         "open": boolean;
         /**
-          * Determines the type of positioning to use for the overlaid content.  Using the "absolute" value will work for most cases. The component will be positioned inside of overflowing parent containers and will affect the container's layout. The "fixed" value should be used to escape an overflowing parent container, or when the reference element's `position` CSS property is "fixed".
+          * Determines the type of positioning to use for the overlaid content.  Using `"absolute"` will work for most cases. The component will be positioned inside of overflowing parent containers and will affect the container's layout.  The `"fixed"` value should be used to escape an overflowing parent container, or when the reference element's `position` CSS property is `"fixed"`.
          */
         "overlayPositioning": OverlayPositioning;
         /**
@@ -3989,7 +3992,7 @@ export namespace Components {
         "child": boolean;
         /**
           * Display input
-          * @deprecated Use "ancestors" selection-mode for checkbox input.
+          * @deprecated Use `selectionMode="ancestors"` for checkbox input.
          */
         "inputEnabled": boolean;
         /**
@@ -4009,6 +4012,10 @@ export namespace Components {
     }
     interface CalciteTreeItem {
         "depth": number;
+        /**
+          * When true, interaction is prevented and the component is displayed with lower opacity.
+         */
+        "disabled": boolean;
         /**
           * When true, the component is expanded.
          */
@@ -4020,7 +4027,7 @@ export namespace Components {
         "indeterminate": boolean;
         /**
           * Displays checkboxes (set on parent).
-          * @deprecated Use "ancestors" selection-mode on parent for checkbox input.
+          * @deprecated Use `selectionMode="ancestors"` for checkbox input.
          */
         "inputEnabled": boolean;
         "lines": boolean;
@@ -5103,16 +5110,16 @@ declare namespace LocalJSX {
          */
         "heading"?: string;
         /**
-          * Specifies an icon to display - accepts Calcite UI icon names.
-          * @deprecated use `iconStart` or `iconEnd` properties instead
+          * Specifies an icon to display.
+          * @deprecated use `iconStart` or `iconEnd` instead.
          */
         "icon"?: string;
         /**
-          * Specified an icon to display at the end - accepts Calcite UI icon names.
+          * Specifies an icon to display at the end of the component.
          */
         "iconEnd"?: string;
         /**
-          * Specified an icon to display at the start - accepts Calcite UI icon names.
+          * Specifies an icon to display at the start of the component.
          */
         "iconStart"?: string;
         /**
@@ -5148,7 +5155,7 @@ declare namespace LocalJSX {
          */
         "disabled"?: boolean;
         /**
-          * Specifies an icon to display - accepts Calcite UI icon names.
+          * Specifies an icon to display.
          */
         "icon"?: string;
         /**
@@ -5272,7 +5279,7 @@ declare namespace LocalJSX {
          */
         "open"?: boolean;
         /**
-          * Determines the type of positioning to use for the overlaid content.  Using the "absolute" value will work for most cases. The component will be positioned inside of overflowing parent containers and will affect the container's layout. The "fixed" value should be used to escape an overflowing parent container, or when the reference element's `position` CSS property is "fixed".
+          * Determines the type of positioning to use for the overlaid content.  Using `"absolute"` will work for most cases. The component will be positioned inside of overflowing parent containers and will affect the container's layout. `"fixed"` should be used to escape an overflowing parent container, or when the reference element's `position` CSS property is `"fixed"`.
          */
         "overlayPositioning"?: OverlayPositioning;
         /**
@@ -5350,6 +5357,10 @@ declare namespace LocalJSX {
           * Specifies an accessible name for the component.
          */
         "label": string;
+        /**
+          * Specifies the Unicode numeral system used by the component for localization.
+         */
+        "numberingSystem"?: NumberingSystem;
         /**
           * Fires when the component is requested to be closed and before the closing transition begins.
          */
@@ -5530,15 +5541,15 @@ declare namespace LocalJSX {
          */
         "href"?: string;
         /**
-          * optionally pass an icon to display at the end of a button - accepts calcite ui icon names
+          * Specifies an icon to display at the end of the component.
          */
         "iconEnd"?: string;
         /**
-          * flip the icon(s) in rtl
+          * When true, the icon will be flipped when the element direction is right-to-left (`"rtl"`).
          */
         "iconFlipRtl"?: FlipContext;
         /**
-          * optionally pass an icon to display at the start of a button - accepts calcite ui icon names
+          * Specifies an icon to display at the start of the component.
          */
         "iconStart"?: string;
         /**
@@ -5683,15 +5694,15 @@ declare namespace LocalJSX {
          */
         "dismissible"?: boolean;
         /**
-          * optionally pass an icon to display - accepts Calcite UI icon names
+          * Specifies an icon to display.
          */
         "icon"?: string;
         /**
-          * flip the icon in rtl
+          * When true, the icon will be flipped when the element direction is right-to-left (`"rtl"`).
          */
         "iconFlipRtl"?: boolean;
         /**
-          * Emitted when the dismiss button is clicked  **Note:**: The `el` event payload props is deprecated, please use the event's target/currentTarget instead
+          * Emitted when the dismiss button is clicked  **Note:**: The `el` event payload props is deprecated, please use the event's `target`/`currentTarget` instead
          */
         "onCalciteChipDismiss"?: (event: CalciteChipCustomEvent<DeprecatedEventPayload>) => void;
         /**
@@ -5829,9 +5840,9 @@ declare namespace LocalJSX {
          */
         "intlValue"?: string;
         /**
-          * standard UniCode numeral system tag for localization
+          * Specifies the Unicode numeral system used by the component for localization.
          */
-        "numberingSystem"?: string;
+        "numberingSystem"?: NumberingSystem;
         /**
           * Fires when the color value has changed.
          */
@@ -5872,9 +5883,9 @@ declare namespace LocalJSX {
          */
         "intlNoColor"?: string;
         /**
-          * standard UniCode numeral system tag for localization
+          * Specifies the Unicode numeral system used by the component for localization.
          */
-        "numberingSystem"?: string;
+        "numberingSystem"?: NumberingSystem;
         /**
           * Emitted when the hex value changes.
          */
@@ -5981,7 +5992,7 @@ declare namespace LocalJSX {
          */
         "open"?: boolean;
         /**
-          * Determines the type of positioning to use for the overlaid content.  Using the "absolute" value will work for most cases. The component will be positioned inside of overflowing parent containers and will affect the container's layout. The "fixed" value should be used to escape an overflowing parent container, or when the reference element's `position` CSS property is "fixed".
+          * Determines the type of positioning to use for the overlaid content.  Using `"absolute"` will work for most cases. The component will be positioned inside of overflowing parent containers and will affect the container's layout.  `"fixed"` should be used to escape an overflowing parent container, or when the reference element's `position` CSS property is `"fixed"`.
          */
         "overlayPositioning"?: OverlayPositioning;
         /**
@@ -6036,7 +6047,7 @@ declare namespace LocalJSX {
          */
         "icon"?: string;
         /**
-          * Emitted whenever the item is selected or unselected.  **Note:**: The event's payload is deprecated, please use the event's target/currentTarget instead
+          * Emitted whenever the item is selected or unselected.  **Note:**: The event's payload is deprecated, please use the event's `target`/`currentTarget` instead
          */
         "onCalciteComboboxItemChange"?: (event: CalciteComboboxItemCustomEvent<DeprecatedEventPayload>) => void;
         /**
@@ -6097,7 +6108,7 @@ declare namespace LocalJSX {
          */
         "intlYear"?: string;
         /**
-          * BCP 47 language tag for desired language and country format
+          * Specifies the BCP 47 language tag for the desired language and country format.
           * @deprecated set the global `lang` attribute on the element instead.
           * @mdn [lang](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/lang)
          */
@@ -6351,7 +6362,7 @@ declare namespace LocalJSX {
          */
         "open"?: boolean;
         /**
-          * Determines the type of positioning to use for the overlaid content.  Using the "absolute" value will work for most cases. The component will be positioned inside of overflowing parent containers and will affect the container's layout. The "fixed" value should be used to escape an overflowing parent container, or when the reference element's `position` CSS property is "fixed".
+          * Determines the type of positioning to use for the overlaid content.  Using `"absolute"` will work for most cases. The component will be positioned inside of overflowing parent containers and will affect the container's layout.  `"fixed"` should be used to escape an overflowing parent container, or when the reference element's `position` CSS property is `"fixed"`.
          */
         "overlayPositioning"?: OverlayPositioning;
         /**
@@ -6402,15 +6413,15 @@ declare namespace LocalJSX {
          */
         "href"?: string;
         /**
-          * optionally pass an icon to display at the end of an item - accepts calcite ui icon names
+          * Specifies an icon to display at the end of the component.
          */
         "iconEnd"?: string;
         /**
-          * flip the icon(s) in rtl
+          * When true, the icon will be flipped when the element direction is right-to-left (`"rtl"`).
          */
         "iconFlipRtl"?: FlipContext;
         /**
-          * optionally pass an icon to display at the start of an item - accepts calcite ui icon names
+          * Specifies an icon to display at the start of the component.
          */
         "iconStart"?: string;
         /**
@@ -6444,7 +6455,7 @@ declare namespace LocalJSX {
          */
         "disabled"?: boolean;
         /**
-          * The name of the icon to display. The value of this property must match the icon name from https://esri.github.io/calcite-ui-icons/.
+          * Specifies an icon to display.
           * @default "plus"
          */
         "icon"?: string;
@@ -6613,7 +6624,7 @@ declare namespace LocalJSX {
     }
     interface CalciteHandle {
         /**
-          * Emitted when the handle is activated and the up or down arrow key is pressed.  **Note:**: The `handle` event payload prop is deprecated, please use the event's target/currentTarget instead
+          * Emitted when the handle is activated and the up or down arrow key is pressed.  **Note:**: The `handle` event payload prop is deprecated, please use the event's `target`/`currentTarget` instead
          */
         "onCalciteHandleNudge"?: (event: CalciteHandleCustomEvent<DeprecatedEventPayload>) => void;
         /**
@@ -6699,7 +6710,7 @@ declare namespace LocalJSX {
          */
         "autofocus"?: boolean;
         /**
-          * When true, a clear button is displayed when the component has a value. The clear button shows by default for "search", "time", and "date" types, and will not display for the "textarea" type.
+          * When true, a clear button is displayed when the component has a value. The clear button shows by default for `"search"`, `"time"`, and `"date"` types, and will not display for the `"textarea"` type.
          */
         "clearable"?: boolean;
         /**
@@ -6721,24 +6732,24 @@ declare namespace LocalJSX {
          */
         "icon"?: string | boolean;
         /**
-          * When true, the icon is flipped in RTL.
+          * When true, the icon will be flipped when the element direction is right-to-left (`"rtl"`).
          */
         "iconFlipRtl"?: boolean;
         /**
-          * A text label that will appear on the clear button for screen readers.
+          * Accessible name for the component's clear button.
          */
         "intlClear"?: string;
         /**
-          * Accessible name that will appear while loading.
+          * Accessible name when the component is loading.
           * @default "Loading"
          */
         "intlLoading"?: string;
         /**
-          * Accessible name for the component's button or hyperlink.
+          * Accessible name for the component.
          */
         "label"?: string;
         /**
-          * When true, the component is in the loading state and `calcite-progress` is displayed.
+          * When true, a busy indicator is displayed.
          */
         "loading"?: boolean;
         /**
@@ -6759,11 +6770,11 @@ declare namespace LocalJSX {
         "maxLength"?: number;
         /**
           * Specifies the maximum length of text for the component's value.
-          * @deprecated use maxLength instead
+          * @deprecated use `maxLength` instead.
          */
         "maxlength"?: number;
         /**
-          * Specifies the minimum value for type "number".
+          * Specifies the minimum value for `type="number"`.
           * @mdn [min](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#min)
          */
         "min"?: number;
@@ -6773,25 +6784,24 @@ declare namespace LocalJSX {
          */
         "minLength"?: number;
         /**
-          * Specifies the name of the component.
+          * Specifies the name of the component on form submission.
           * @mdn [name](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#name)
          */
         "name"?: string;
         /**
-          * Specifies the placement of the buttons for type "number".
+          * Specifies the placement of the buttons for `type="number"`.
          */
         "numberButtonType"?: InputPlacement;
         /**
           * Specifies the Unicode numeral system used by the component for localization.
-          * @mdn [numberingSystem](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/Locale/numberingSystem)
          */
-        "numberingSystem"?: string;
+        "numberingSystem"?: NumberingSystem;
         /**
-          * Fires each time a new value is typed and committed.
+          * Fires each time a new `value` is typed and committed.
          */
         "onCalciteInputChange"?: (event: CalciteInputCustomEvent<void>) => void;
         /**
-          * Fires each time a new value is typed.  **Note:**: The `el` and `value` event payload props are deprecated, please use the event's target/currentTarget instead
+          * Fires each time a new `value` is typed.  **Note:**: The `el` and `value` event payload properties are deprecated, use the event's `target`/`currentTarget` instead.
          */
         "onCalciteInputInput"?: (event: CalciteInputCustomEvent<DeprecatedEventPayload>) => void;
         /**
@@ -6804,7 +6814,7 @@ declare namespace LocalJSX {
          */
         "prefixText"?: string;
         /**
-          * When true, the value cannot be modified.
+          * When true, the component's value can be read, but cannot be modified.
           * @mdn [readOnly](https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/readonly)
          */
         "readOnly"?: boolean;
@@ -6821,7 +6831,7 @@ declare namespace LocalJSX {
          */
         "status"?: Status;
         /**
-          * Specifies the granularity that the component's value must adhere to.
+          * Specifies the granularity the component's value must adhere to.
           * @mdn [step](https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/step)
          */
         "step"?: number | "any";
@@ -6830,7 +6840,7 @@ declare namespace LocalJSX {
          */
         "suffixText"?: string;
         /**
-          * Specifies the component type.  Note that the following types add type-specific icons by default: "date", "email", "password", "search", "tel", "time".
+          * Specifies the component type.  Note that the following `type`s add type-specific icons by default: `"date"`, `"email"`, `"password"`, `"search"`, `"tel"`, `"time"`.
          */
         "type"?: | "color"
     | "date"
@@ -6855,22 +6865,22 @@ declare namespace LocalJSX {
     }
     interface CalciteInputDatePicker {
         /**
-          * Expand or collapse when calendar does not have input
-          * @deprecated use open instead
+          * When true, the component is active.
+          * @deprecated use `open` instead.
          */
         "active"?: boolean;
         /**
-          * When false, the component won't be interactive.
+          * When true, interaction is prevented and the component is displayed with lower opacity.
          */
         "disabled"?: boolean;
         /**
-          * Selected end date
-          * @deprecated use value instead
+          * The component's end date.
+          * @deprecated use `value` instead.
          */
         "end"?: string;
         /**
-          * Selected end date as full date object
-          * @deprecated use valueAsDate instead
+          * The component's end date as a full date object.
+          * @deprecated use `valueAsDate` instead.
          */
         "endAsDate"?: Date;
         /**
@@ -6878,62 +6888,62 @@ declare namespace LocalJSX {
          */
         "flipPlacements"?: EffectivePlacement[];
         /**
-          * Number at which section headings should start for this component.
+          * Specifies the number at which section headings should start.
          */
         "headingLevel"?: HeadingLevel;
         /**
-          * Localized string for "next month" (used for aria label)
+          * Accessible name for the component's next month button.
           * @default "Next month"
          */
         "intlNextMonth"?: string;
         /**
-          * Localized string for "previous month" (used for aria label)
+          * Accessible name for the component's previous month button.
           * @default "Previous month"
          */
         "intlPrevMonth"?: string;
         /**
-          * Localized string for "year" (used for aria label)
+          * Accessible name for the component's year input.
           * @default "Year"
          */
         "intlYear"?: string;
         /**
-          * Layout
+          * Defines the layout of the component.
          */
         "layout"?: "horizontal" | "vertical";
         /**
-          * BCP 47 language tag for desired language and country format
+          * Specifies the BCP 47 language tag for the desired language and country format.
           * @deprecated set the global `lang` attribute on the element instead.
           * @mdn [lang](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/lang)
          */
         "locale"?: string;
         /**
-          * Latest allowed date ("yyyy-mm-dd")
+          * Specifies the latest allowed date ("yyyy-mm-dd").
          */
         "max"?: string;
         /**
-          * Latest allowed date as full date object
+          * Specifies the latest allowed date as a full date object.
          */
         "maxAsDate"?: Date;
         /**
-          * Earliest allowed date ("yyyy-mm-dd")
+          * Specifies the earliest allowed date ("yyyy-mm-dd").
          */
         "min"?: string;
         /**
-          * Earliest allowed date as full date object
+          * Specifies the earliest allowed date as a full date object.
          */
         "minAsDate"?: Date;
         /**
-          * The picker's name. Gets submitted with the form.
+          * Specifies the name of the component on form submission.
          */
         "name"?: string;
         /**
-          * Trigger calcite date change when a user changes the date.
+          * Fires when a user changes the date.
           * @deprecated use `calciteInputDatePickerChange` instead.
          */
         "onCalciteDatePickerChange"?: (event: CalciteInputDatePickerCustomEvent<Date>) => void;
         /**
-          * Trigger calcite date change when a user changes the date range.
-          * @see [DateRangeChange](https://github.com/Esri/calcite-components/blob/master/src/components/calcite-date-picker/interfaces.ts#L1)
+          * Fires when a user changes the date range.
+          * @see [DateRangeChange](https://github.com/Esri/calcite-components/blob/master/src/components/date-picker/interfaces.ts#L1)
           * @deprecated use `calciteInputDatePickerChange` instead.
          */
         "onCalciteDatePickerRangeChange"?: (event: CalciteInputDatePickerCustomEvent<DateRangeChange>) => void;
@@ -6946,7 +6956,7 @@ declare namespace LocalJSX {
          */
         "onCalciteInputDatePickerBeforeOpen"?: (event: CalciteInputDatePickerCustomEvent<void>) => void;
         /**
-          * This event fires when the input date picker value changes.
+          * Fires when the component's value changes.
          */
         "onCalciteInputDatePickerChange"?: (event: CalciteInputDatePickerCustomEvent<void>) => void;
         /**
@@ -6958,74 +6968,74 @@ declare namespace LocalJSX {
          */
         "onCalciteInputDatePickerOpen"?: (event: CalciteInputDatePickerCustomEvent<void>) => void;
         /**
-          * Expand or collapse when calendar does not have input
+          * When true, displays the `calcite-date-picker` component.
          */
         "open"?: boolean;
         /**
-          * Determines the type of positioning to use for the overlaid content.  Using the "absolute" value will work for most cases. The component will be positioned inside of overflowing parent containers and will affect the container's layout. The "fixed" value should be used to escape an overflowing parent container, or when the reference element's `position` CSS property is "fixed".
+          * Determines the type of positioning to use for the overlaid content.  Using `"absolute"` will work for most cases. The component will be positioned inside of overflowing parent containers and will affect the container's layout.  `"fixed"` should be used to escape an overflowing parent container, or when the reference element's `position` CSS property is `"fixed"`.
          */
         "overlayPositioning"?: OverlayPositioning;
         /**
-          * Determines where the date-picker component will be positioned relative to the input.
+          * Specifies the placement of the `calcite-date-picker` relative to the component.
           * @default "bottom-start"
          */
         "placement"?: MenuPlacement;
         /**
-          * Disables the default behaviour on the third click of narrowing or extending the range and instead starts a new range.
+          * When true, disables the default behavior on the third click of narrowing or extending the range. Instead starts a new range.
          */
         "proximitySelectionDisabled"?: boolean;
         /**
-          * Range mode activation
+          * When true, activates a range for the component.
          */
         "range"?: boolean;
         /**
-          * When true, still focusable but controls are gone and the value cannot be modified.
+          * When true, the component's value can be read, but controls are not accessible and the value cannot be modified.
           * @mdn [readOnly](https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/readonly)
          */
         "readOnly"?: boolean;
         /**
-          * specify the scale of the date picker
+          * Specifies the size of the component.
          */
         "scale"?: "s" | "m" | "l";
         /**
-          * Selected start date
-          * @deprecated use value instead
+          * The component's start date.
+          * @deprecated use `value` instead.
          */
         "start"?: string;
         /**
-          * Selected start date as full date object
-          * @deprecated use valueAsDate instead
+          * The component's start date as a full date object.
+          * @deprecated use `valueAsDate` instead.
          */
         "startAsDate"?: Date;
         /**
-          * Selected date
+          * The component's value.
          */
         "value"?: string | string[];
         /**
-          * Selected date as full date object
+          * The component's value as a full date object.
          */
         "valueAsDate"?: Date | Date[];
     }
     interface CalciteInputMessage {
         /**
-          * Indicates whether the message is displayed.
+          * When true, the component is active.
          */
         "active"?: boolean;
         /**
-          * when used as a boolean set to true, show a default icon based on status. You can also pass a calcite-ui-icon name to this prop to display a custom icon
+          * Specifies an icon to display.
          */
         "icon"?: boolean | string;
         /**
-          * specify the scale of the input, defaults to m
+          * Specifies the size of the component.
          */
         "scale"?: Scale;
         /**
-          * specify the status of the input field, determines message and icons
+          * Specifies the status of the input field, which determines message and icons.
          */
         "status"?: Status;
         /**
-          * specify the appearance of any slotted message - default (displayed under input), or floating (positioned absolutely under input)
-          * @deprecated "floating" type is no longer supported
+          * Specifies the appearance of a slotted message - `"default"` (displayed under the component), or `"floating"` (positioned absolutely under the component).
+          * @deprecated The `"floating"` type is no longer supported.
          */
         "type"?: "default";
     }
@@ -7062,7 +7072,7 @@ declare namespace LocalJSX {
          */
         "icon"?: string | boolean;
         /**
-          * When true, the icon is flipped in RTL.
+          * When true, the icon will be flipped when the element direction is right-to-left (`"rtl"`).
          */
         "iconFlipRtl"?: boolean;
         /**
@@ -7119,15 +7129,14 @@ declare namespace LocalJSX {
         "numberButtonType"?: InputPlacement1;
         /**
           * Specifies the Unicode numeral system used by the component for localization.
-          * @mdn [numberingSystem](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/Locale/numberingSystem)
          */
-        "numberingSystem"?: string;
+        "numberingSystem"?: NumberingSystem;
         /**
           * Fires each time a new value is typed and committed.
          */
         "onCalciteInputNumberChange"?: (event: CalciteInputNumberCustomEvent<void>) => void;
         /**
-          * Fires each time a new value is typed.  **Note:**: The `el` and `value` event payload props are deprecated, please use the event's target/currentTarget instead
+          * Fires each time a new value is typed.  **Note:**: The `el` and `value` event payload props are deprecated, please use the event's `target`/`currentTarget` instead
          */
         "onCalciteInputNumberInput"?: (event: CalciteInputNumberCustomEvent<DeprecatedEventPayload>) => void;
         /**
@@ -7140,7 +7149,7 @@ declare namespace LocalJSX {
          */
         "prefixText"?: string;
         /**
-          * When true, the value cannot be modified.
+          * When true, the component's value can be read, but cannot be modified.
           * @mdn [readOnly](https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/readonly)
          */
         "readOnly"?: boolean;
@@ -7199,7 +7208,7 @@ declare namespace LocalJSX {
          */
         "icon"?: string | boolean;
         /**
-          * When true, the icon is flipped in RTL.
+          * When true, the icon will be flipped when the element direction is right-to-left (`"rtl"`).
          */
         "iconFlipRtl"?: boolean;
         /**
@@ -7256,7 +7265,7 @@ declare namespace LocalJSX {
          */
         "prefixText"?: string;
         /**
-          * When true, the value cannot be modified.
+          * When true, the component's value can be read, but cannot be modified.
           * @mdn [readOnly](https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/readonly)
          */
         "readOnly"?: boolean;
@@ -7283,64 +7292,64 @@ declare namespace LocalJSX {
     }
     interface CalciteInputTimePicker {
         /**
-          * The active state of the time input
-          * @deprecated Use open instead.
+          * When true, the component is active.
+          * @deprecated Use `open` instead.
          */
         "active"?: boolean;
         /**
-          * The disabled state of the time input
+          * When true, interaction is prevented and the component is displayed with lower opacity.
          */
         "disabled"?: boolean;
         /**
-          * aria-label for the hour input
+          * Accessible name for the component's hour input.
          */
         "intlHour"?: string;
         /**
-          * aria-label for the hour down button
+          * Accessible name for the component's hour down button.
          */
         "intlHourDown"?: string;
         /**
-          * aria-label for the hour up button
+          * Accessible name for the component's hour up button.
          */
         "intlHourUp"?: string;
         /**
-          * aria-label for the meridiem (am/pm) input
+          * Accessible name for the component's meridiem (am/pm) input.
          */
         "intlMeridiem"?: string;
         /**
-          * aria-label for the meridiem (am/pm) down button
+          * Accessible name for the component's meridiem (am/pm) down button.
          */
         "intlMeridiemDown"?: string;
         /**
-          * aria-label for the meridiem (am/pm) up button
+          * Accessible name for the component's meridiem (am/pm) up button.
          */
         "intlMeridiemUp"?: string;
         /**
-          * aria-label for the minute input
+          * Accessible name for the component's minute input.
          */
         "intlMinute"?: string;
         /**
-          * aria-label for the minute down button
+          * Accessible name for the component's minute down button.
          */
         "intlMinuteDown"?: string;
         /**
-          * aria-label for the minute up button
+          * Accessible name for the component's minute up button.
          */
         "intlMinuteUp"?: string;
         /**
-          * aria-label for the second input
+          * Accessible name for the component's second input.
          */
         "intlSecond"?: string;
         /**
-          * aria-label for the second down button
+          * Accessible name for the component's second down button.
          */
         "intlSecondDown"?: string;
         /**
-          * aria-label for the second up button
+          * Accessible name for the component's second up button.
          */
         "intlSecondUp"?: string;
         /**
-          * The name of the time input
+          * Specifies the name of the component on form submission.
          */
         "name"?: string;
         /**
@@ -7352,7 +7361,7 @@ declare namespace LocalJSX {
          */
         "open"?: boolean;
         /**
-          * Determines the type of positioning to use for the overlaid content.  Using the "absolute" value will work for most cases. The component will be positioned inside of overflowing parent containers and will affect the container's layout. The "fixed" value should be used to escape an overflowing parent container, or when the reference element's `position` CSS property is "fixed".
+          * Determines the type of positioning to use for the overlaid content.  Using `"absolute"` will work for most cases. The component will be positioned inside of overflowing parent containers and will affect the container's layout.  `"fixed"` should be used to escape an overflowing parent container, or when the reference element's `position` CSS property is `"fixed"`.
          */
         "overlayPositioning"?: OverlayPositioning;
         /**
@@ -7361,87 +7370,87 @@ declare namespace LocalJSX {
          */
         "placement"?: LogicalPlacement;
         /**
-          * When true, still focusable but controls are gone and the value cannot be modified.
+          * When true, the component's value can be read, but controls are not accessible and the value cannot be modified.
           * @mdn [readOnly](https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/readonly)
          */
         "readOnly"?: boolean;
         /**
-          * The scale (size) of the time input
+          * Specifies the size of the component.
          */
         "scale"?: Scale;
         /**
-          * number (seconds) that specifies the granularity that the value must adhere to
+          * Specifies the granularity the component's `value` must adhere to (in seconds).
          */
         "step"?: number;
         /**
-          * The selected time in UTC (always 24-hour format)
+          * The component's value in UTC (always 24-hour format).
          */
         "value"?: string;
     }
     interface CalciteLabel {
         /**
-          * specify the text alignment of the label
+          * Specifies the text alignment of the component.
          */
         "alignment"?: Alignment;
         /**
-          * eliminates any space around the label
-          * @deprecated set the --calcite-label-margin-bottom css variable to 0 instead
+          * When true, disables the component's spacing.
+          * @deprecated Set the `--calcite-label-margin-bottom` css variable to `0` instead.
          */
         "disableSpacing"?: boolean;
         /**
-          * is the label disabled
-          * @deprecated use the `disabled` property on the interactive components instead
+          * When true, interaction is prevented and the component is displayed with lower opacity.
+          * @deprecated Use the `disabled` property on the component the label is bound to instead.
          */
         "disabled"?: boolean;
         /**
-          * The id of the input associated with the label
+          * Specifies the `id` of the component the label is bound to. Use when the component the label is bound to does not reside within the component.
          */
         "for"?: string;
         /**
-          * is the wrapped element positioned inline with the label slotted text
+          * Defines the layout of the label in relation to the component. Use `"inline"` positions to wrap the label and component on the same line.
          */
         "layout"?: "inline" | "inline-space-between" | "default";
         /**
-          * specify the scale of the label, defaults to m
+          * Specifies the size of the component.
          */
         "scale"?: Scale;
         /**
-          * specify the status of the label and any child input / input messages
-          * @deprecated set directly on child element instead
+          * Specifies the status of the component and any child input, or input messages.
+          * @deprecated Set directly on the component the label is bound to instead.
          */
         "status"?: Status;
     }
     interface CalciteLink {
         /**
-          * is the link disabled
+          * When true, interaction is prevented and the component is displayed with lower opacity.
          */
         "disabled"?: boolean;
         /**
-          * Prompts the user to save the linked URL instead of navigating to it. Can be used with or without a value: Without a value, the browser will suggest a filename/extension See: https://developer.mozilla.org/en-US/docs/Web/HTML/Element/a#attr-download
+          * Prompts the user to save the linked URL instead of navigating to it. Can be used with or without a value: Without a value, the browser will suggest a filename/extension See https://developer.mozilla.org/en-US/docs/Web/HTML/Element/a#attr-download.
          */
         "download"?: string | boolean;
         /**
-          * optionally pass a href - used to determine if the component should render as a link or an anchor
+          * Specifies the URL of the linked resource, which can be set as an absolute or relative path.
          */
         "href"?: string;
         /**
-          * optionally pass an icon to display at the end of a button - accepts calcite ui icon names
+          * Specifies an icon to display at the end of the component.
          */
         "iconEnd"?: string;
         /**
-          * flip the icon(s) in rtl
+          * When true, the icon will be flipped when the element direction is right-to-left (`"rtl"`).
          */
         "iconFlipRtl"?: FlipContext;
         /**
-          * optionally pass an icon to display at the start of a button - accepts calcite ui icon names
+          * Specifies an icon to display at the start of the component.
          */
         "iconStart"?: string;
         /**
-          * The rel attribute to apply to the hyperlink
+          * Specifies the relationship to the linked document defined in `href`.
          */
         "rel"?: string;
         /**
-          * The target attribute to apply to the hyperlink
+          * Specifies the frame or window to open the linked document.
          */
         "target"?: string;
     }
@@ -7614,7 +7623,7 @@ declare namespace LocalJSX {
          */
         "dismissible"?: boolean;
         /**
-          * When present, shows a default recommended icon. You can also pass a calcite-ui-icon name to display a requested icon.
+          * When true, shows a default recommended icon. Alternatively, pass a Calcite UI Icon name to display a specific icon.
          */
         "icon"?: string | boolean;
         /**
@@ -7682,9 +7691,8 @@ declare namespace LocalJSX {
         "num"?: number;
         /**
           * Specifies the Unicode numeral system used by the component for localization.
-          * @mdn [numberingSystem](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/Locale/numberingSystem)
          */
-        "numberingSystem"?: string;
+        "numberingSystem"?: NumberingSystem;
         /**
           * Emits when the selected page changes.
           * @see [PaginationDetail](https://github.com/Esri/calcite-components/blob/master/src/components/pagination/pagination.tsx#L23)
@@ -8000,7 +8008,7 @@ declare namespace LocalJSX {
          */
         "open"?: boolean;
         /**
-          * Determines the type of positioning to use for the overlaid content.  Using the "absolute" value will work for most cases. The component will be positioned inside of overflowing parent containers and will affect the container's layout. The "fixed" value should be used to escape an overflowing parent container, or when the reference element's `position` CSS property is "fixed".
+          * Determines the type of positioning to use for the overlaid content.  Using `"absolute"` will work for most cases. The component will be positioned inside of overflowing parent containers and will affect the container's layout.  `"fixed"` value should be used to escape an overflowing parent container, or when the reference element's `position` CSS property is `"fixed"`.
          */
         "overlayPositioning"?: OverlayPositioning;
         /**
@@ -8076,7 +8084,7 @@ declare namespace LocalJSX {
          */
         "onCalciteRadioButtonChange"?: (event: CalciteRadioButtonCustomEvent<void>) => void;
         /**
-          * When true, the component must have a value selected from the `calcite-radio-button-group` on form submission.
+          * When true, the component must have a value selected from the `calcite-radio-button-group` in order for the form to submit.
          */
         "required"?: boolean;
         /**
@@ -8110,7 +8118,7 @@ declare namespace LocalJSX {
          */
         "onCalciteRadioButtonGroupChange"?: (event: CalciteRadioButtonGroupCustomEvent<any>) => void;
         /**
-          * When true, the component must have a value on form submission.
+          * When true, the component must have a value in order for the form to submit.
          */
         "required"?: boolean;
         /**
@@ -8163,25 +8171,25 @@ declare namespace LocalJSX {
          */
         "checked"?: boolean;
         /**
-          * Optionally pass an icon to display - accepts Calcite UI icon names
-          * @deprecated Use either iconStart or iconEnd but do not combine them with icon & iconPosition.
+          * Specifies an icon to display.
+          * @deprecated Use either `iconStart` or `iconEnd` but do not combine them with `icon` and `iconPosition`.
          */
         "icon"?: string;
         /**
-          * Optionally pass an icon to display at the end - accepts Calcite UI icon names
+          * Specifies an icon to display at the end of the component.
          */
         "iconEnd"?: string;
         /**
-          * When true, the icon will be flipped when the element direction is right-to-left ("rtl").
+          * When true, the icon will be flipped when the element direction is right-to-left (`"rtl"`).
          */
         "iconFlipRtl"?: boolean;
         /**
-          * Optionally used with icon, select where to position the icon
-          * @deprecated Use either iconStart or iconEnd but do not combine them with icon & iconPosition.
+          * Specifies the placement of the icon.
+          * @deprecated Use either `iconStart` or `iconEnd` but do not combine them with `icon` and `iconPosition`.
          */
         "iconPosition"?: Position;
         /**
-          * Optionally pass an icon to display at the start - accepts Calcite UI icon names
+          * Specifies an icon to display at the start of the component.
          */
         "iconStart"?: string;
         /**
@@ -8299,7 +8307,7 @@ declare namespace LocalJSX {
          */
         "heightScale"?: Scale;
         /**
-          * Specifies the component's position. Will be flipped when the element direction is right-to-left ("rtl").
+          * Specifies the component's position. Will be flipped when the element direction is right-to-left (`"rtl"`).
          */
         "position"?: Position;
     }
@@ -8327,7 +8335,7 @@ declare namespace LocalJSX {
          */
         "onCalciteShellPanelToggle"?: (event: CalciteShellPanelCustomEvent<void>) => void;
         /**
-          * Specifies the component's position. Will be flipped when the element direction is right-to-left ("rtl").
+          * Specifies the component's position. Will be flipped when the element direction is right-to-left (`"rtl"`).
          */
         "position"?: Position;
         /**
@@ -8403,11 +8411,10 @@ declare namespace LocalJSX {
         "name"?: string;
         /**
           * Specifies the Unicode numeral system used by the component for localization.
-          * @mdn [numberingSystem](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/Locale/numberingSystem)
          */
-        "numberingSystem"?: string;
+        "numberingSystem"?: NumberingSystem;
         /**
-          * Fires when the thumb is released on the component.  **Note:** If you need to constantly listen to the drag event, use "calciteSliderInput" instead.
+          * Fires when the thumb is released on the component.  **Note:** If you need to constantly listen to the drag event, use `calciteSliderInput` instead.
          */
         "onCalciteSliderChange"?: (event: CalciteSliderCustomEvent<void>) => void;
         /**
@@ -8416,7 +8423,7 @@ declare namespace LocalJSX {
         "onCalciteSliderInput"?: (event: CalciteSliderCustomEvent<void>) => void;
         /**
           * Fires on all updates to the component.  **Note:** Will be fired frequently during drag. If you are performing any expensive operations consider using a debounce or throttle to avoid locking up the main thread.
-          * @deprecated use "calciteSliderInput" instead.
+          * @deprecated use `calciteSliderInput` instead.
          */
         "onCalciteSliderUpdate"?: (event: CalciteSliderCustomEvent<void>) => void;
         /**
@@ -8428,7 +8435,7 @@ declare namespace LocalJSX {
          */
         "precise"?: boolean;
         /**
-          * When true, the component must have a value on form submission.
+          * When true, the component must have a value in order for the form to submit.
          */
         "required"?: boolean;
         /**
@@ -8516,19 +8523,19 @@ declare namespace LocalJSX {
          */
         "onCalciteSplitButtonSecondaryClick"?: (event: CalciteSplitButtonCustomEvent<DeprecatedEventPayload>) => void;
         /**
-          * Determines the type of positioning to use for the overlaid content.  Using the "absolute" value will work for most cases. The component will be positioned inside of overflowing parent containers and will affect the container's layout. The "fixed" value should be used to escape an overflowing parent container, or when the reference element's `position` CSS property is "fixed".
+          * Determines the type of positioning to use for the overlaid content.  Using `"absolute"` will work for most cases. The component will be positioned inside of overflowing parent containers and will affect the container's layout.  `"fixed"` should be used to escape an overflowing parent container, or when the reference element's `position` CSS property is `"fixed"`.
          */
         "overlayPositioning"?: OverlayPositioning;
         /**
-          * Specifies an icon to display at the end of the primary button - accepts Calcite UI icon names.
+          * Specifies an icon to display at the end of the primary button.
          */
         "primaryIconEnd"?: string;
         /**
-          * When true, the primary button icon will be flipped when the element direction is right-to-left ("rtl").
+          * When true, the primary button icon will be flipped when the element direction is right-to-left (`"rtl"`).
          */
         "primaryIconFlipRtl"?: FlipContext;
         /**
-          * Specifies an icon to display at the start of the primary button - accepts Calcite UI icon names.
+          * Specifies an icon to display at the start of the primary button.
          */
         "primaryIconStart"?: string;
         /**
@@ -8598,12 +8605,12 @@ declare namespace LocalJSX {
         "heading"?: string;
         /**
           * A description for the component. Displays below the header text.
-          * @deprecated use "description" instead.
+          * @deprecated use `description` instead.
          */
         "itemSubtitle"?: string;
         /**
           * The component header text.
-          * @deprecated use "heading" instead.
+          * @deprecated use `heading` instead.
          */
         "itemTitle"?: string;
         /**
@@ -8638,7 +8645,7 @@ declare namespace LocalJSX {
         "scale"?: Scale;
         /**
           * When true, the component is checked.
-          * @deprecated use "checked" instead.
+          * @deprecated use `checked` instead.
          */
         "switched"?: boolean;
         /**
@@ -8649,7 +8656,7 @@ declare namespace LocalJSX {
     interface CalciteTab {
         /**
           * When true, the component's contents are selected.  Only one tab can be selected within the `calcite-tabs` parent.
-          * @deprecated Use "selected" instead.
+          * @deprecated Use `selected` instead.
          */
         "active"?: boolean;
         /**
@@ -8679,7 +8686,7 @@ declare namespace LocalJSX {
     interface CalciteTabTitle {
         /**
           * When true, the component and its respective `calcite-tab` contents are selected.  Only one tab can be selected within the `calcite-tabs` parent.
-          * @deprecated Use "selected" instead.
+          * @deprecated Use `selected` instead.
          */
         "active"?: boolean;
         /**
@@ -8687,15 +8694,15 @@ declare namespace LocalJSX {
          */
         "disabled"?: boolean;
         /**
-          * Specifies an icon to display at the end of the component - accepts Calcite UI icon names.
+          * Specifies an icon to display at the end of the component.
          */
         "iconEnd"?: string;
         /**
-          * When true, the icon will be flipped when the element direction is right-to-left ("rtl").
+          * When true, the icon will be flipped when the element direction is right-to-left (`"rtl"`).
          */
         "iconFlipRtl"?: FlipContext;
         /**
-          * Specifies an icon to display at the start of the component - accepts Calcite UI icon names.
+          * Specifies an icon to display at the start of the component.
          */
         "iconStart"?: string;
         /**
@@ -8824,7 +8831,7 @@ declare namespace LocalJSX {
          */
         "disabled"?: boolean;
         /**
-          * Defines the layout of the component.  Use "horizontal" for rows, and "vertical" for a single column.
+          * Defines the layout of the component.  Use `"horizontal"` for rows, and `"vertical"` for a single column.
          */
         "layout"?: TileSelectGroupLayout;
     }
@@ -8973,7 +8980,7 @@ declare namespace LocalJSX {
         "onCalciteTipManagerClose"?: (event: CalciteTipManagerCustomEvent<void>) => void;
         /**
           * Emits when the component has been open or closed.
-          * @deprecated use "calciteTipManagerClose" instead.
+          * @deprecated use `calciteTipManagerClose` instead.
          */
         "onCalciteTipManagerToggle"?: (event: CalciteTipManagerCustomEvent<void>) => void;
     }
@@ -9000,7 +9007,7 @@ declare namespace LocalJSX {
          */
         "open"?: boolean;
         /**
-          * Determines the type of positioning to use for the overlaid content.  Using the "absolute" value will work for most cases. The component will be positioned inside of overflowing parent containers and will affect the container's layout. The "fixed" value should be used to escape an overflowing parent container, or when the reference element's `position` CSS property is "fixed".
+          * Determines the type of positioning to use for the overlaid content.  Using `"absolute"` will work for most cases. The component will be positioned inside of overflowing parent containers and will affect the container's layout.  The `"fixed"` value should be used to escape an overflowing parent container, or when the reference element's `position` CSS property is `"fixed"`.
          */
         "overlayPositioning"?: OverlayPositioning;
         /**
@@ -9023,7 +9030,7 @@ declare namespace LocalJSX {
     interface CalciteTree {
         /**
           * Display input
-          * @deprecated Use "ancestors" selection-mode for checkbox input.
+          * @deprecated Use `selectionMode="ancestors"` for checkbox input.
          */
         "inputEnabled"?: boolean;
         /**
@@ -9047,6 +9054,10 @@ declare namespace LocalJSX {
         "selectionMode"?: TreeSelectionMode;
     }
     interface CalciteTreeItem {
+        /**
+          * When true, interaction is prevented and the component is displayed with lower opacity.
+         */
+        "disabled"?: boolean;
         /**
           * When true, the component is expanded.
          */