@esri/calcite-components 1.0.0-beta.90 → 1.0.0-beta.93

package/dist/types/components.d.ts

@@ -20,8 +20,8 @@ import { ComboboxChildElement, ComboboxSelectionMode } from "./components/combob
 import { DateRangeChange } from "./components/date-picker/interfaces";
 import { DateLocaleData } from "./components/date-picker/utils";
 import { HoverRange } from "./utils/date";
+import { ItemKeyboardEvent, Selection } from "./components/dropdown/interfaces";
 import { RequestedItem as RequestedItem2, SelectionMode } from "./components/dropdown-group/interfaces";
-import { ItemKeyboardEvent } from "./components/dropdown/interfaces";
 import { ColorStop, DataSeries } from "./components/graph/interfaces";
 import { InputPlacement } from "./components/input/interfaces";
 import { InputPlacement as InputPlacement1 } from "./components/input-number/interfaces";
@@ -240,7 +240,7 @@ export namespace Components {
          */
         "open": boolean;
         /**
-          * Determines the type of positioning to use for the overlaid content. If your element is in a fixed container, use the "fixed" value.
+          * 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".
          */
         "overlayPositioning": OverlayPositioning;
         /**
@@ -294,7 +294,8 @@ export namespace Components {
     }
     interface CalciteAlert {
         /**
-          * When true, the component is active.
+          * When true, opens the combobox
+          * @deprecated use open instead
          */
         "active": boolean;
         /**
@@ -322,6 +323,10 @@ export namespace Components {
           * Specifies an accessible name for the component.
          */
         "label": string;
+        /**
+          * When true, opens the dropdown
+         */
+        "open": boolean;
         /**
           * Specifies the placement of the component
          */
@@ -669,7 +674,7 @@ export namespace Components {
          */
         "allowEmpty": boolean;
         /**
-          * specify the appearance - default (containing border), or minimal (no containing border)
+          * specify the appearance - solid (containing border), or minimal (no containing border)
          */
         "appearance": ColorAppearance;
         /**
@@ -902,7 +907,7 @@ export namespace Components {
          */
         "open": boolean;
         /**
-          * Describes the type of positioning to use for the overlaid content. If your element is in a fixed container, use the 'fixed' value.
+          * 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".
          */
         "overlayPositioning": OverlayPositioning;
         /**
@@ -1246,7 +1251,7 @@ export namespace Components {
          */
         "open": boolean;
         /**
-          * Describes the type of positioning to use for the overlaid content. If your element is in a fixed container, use the 'fixed' value.
+          * 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".
          */
         "overlayPositioning": OverlayPositioning;
         /**
@@ -1293,6 +1298,7 @@ export namespace Components {
     interface CalciteDropdownItem {
         /**
           * Indicates whether the item is active.
+          * @deprecated Use selected instead.
          */
         "active": boolean;
         /**
@@ -1319,6 +1325,10 @@ export namespace Components {
           * The rel attribute to apply to the hyperlink
          */
         "rel"?: string;
+        /**
+          * When true, item is selected
+         */
+        "selected": boolean;
         /**
           * Sets focus on the component.
          */
@@ -1660,21 +1670,21 @@ export namespace Components {
         /**
           * Specifies the component type.  Note that the following types add type-specific icons by default: "date", "email", "password", "search", "tel", "time".
          */
-        "type": | "color"
-    | "date"
-    | "datetime-local"
-    | "email"
-    | "file"
-    | "image"
-    | "month"
-    | "number"
-    | "password"
-    | "search"
-    | "tel"
-    | "text"
-    | "textarea"
-    | "time"
-    | "url"
+        "type": | "color"
+    | "date"
+    | "datetime-local"
+    | "email"
+    | "file"
+    | "image"
+    | "month"
+    | "number"
+    | "password"
+    | "search"
+    | "tel"
+    | "text"
+    | "textarea"
+    | "time"
+    | "url"
     | "week";
         /**
           * The component's value.
@@ -1757,7 +1767,7 @@ export namespace Components {
          */
         "open": boolean;
         /**
-          * Describes the type of positioning to use for the overlaid content. If your element is in a fixed container, use the 'fixed' value.
+          * 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".
          */
         "overlayPositioning": OverlayPositioning;
         /**
@@ -1980,6 +1990,114 @@ export namespace Components {
          */
         "value": string;
     }
+    interface CalciteInputText {
+        /**
+          * Specifies the text alignment of the component's value.
+         */
+        "alignment": Position;
+        /**
+          * When true, the component is focused on page load.
+          * @mdn [autofocus](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/autofocus)
+         */
+        "autofocus": boolean;
+        /**
+          * When true, a clear button is displayed when the component has a value.
+         */
+        "clearable": boolean;
+        /**
+          * When true, interaction is prevented and the component is displayed with lower opacity.
+          * @mdn [disabled](https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/disabled)
+         */
+        "disabled": boolean;
+        "editingEnabled": boolean;
+        /**
+          * When true, the component will not be visible.
+          * @mdn [hidden](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/hidden)
+         */
+        "hidden": boolean;
+        /**
+          * When true, shows a default recommended icon. Alternatively, pass a Calcite UI Icon name to display a specific icon.
+         */
+        "icon": string | boolean;
+        /**
+          * When true, the icon is flipped in RTL.
+         */
+        "iconFlipRtl": boolean;
+        /**
+          * A text label that will appear on the clear button for screen readers.
+         */
+        "intlClear"?: string;
+        /**
+          * Accessible name that will appear while loading.
+          * @default "Loading"
+         */
+        "intlLoading"?: string;
+        /**
+          * Accessible name for the component's button or hyperlink.
+         */
+        "label"?: string;
+        /**
+          * When true, the component is in the loading state and `calcite-progress` is displayed.
+         */
+        "loading": boolean;
+        /**
+          * Specifies the maximum length of text for the component's value.
+          * @mdn [maxlength](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#maxlength)
+         */
+        "maxLength"?: number;
+        /**
+          * Specifies the minimum length of text for the component's value.
+          * @mdn [minlength](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#minlength)
+         */
+        "minLength"?: number;
+        /**
+          * Specifies the name of the component.
+          * @mdn [name](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#name)
+         */
+        "name": string;
+        /**
+          * Specifies placeholder text for the component.
+          * @mdn [placeholder](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#placeholder)
+         */
+        "placeholder": string;
+        /**
+          * Adds text to the start of the component.
+         */
+        "prefixText"?: string;
+        /**
+          * When true, the value cannot be modified.
+          * @mdn [readOnly](https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/readonly)
+         */
+        "readOnly": boolean;
+        /**
+          * When true, the component must have a value in order for the form to submit.
+         */
+        "required": boolean;
+        /**
+          * Specifies the size of the component.
+         */
+        "scale": Scale;
+        /**
+          * Selects all text of the component's `value`.
+         */
+        "selectText": () => Promise<void>;
+        /**
+          * Sets focus on the component.
+         */
+        "setFocus": () => Promise<void>;
+        /**
+          * Specifies the status of the input field, which determines message and icons.
+         */
+        "status": Status;
+        /**
+          * Adds text to the end of the component.
+         */
+        "suffixText"?: string;
+        /**
+          * The component's value.
+         */
+        "value": string;
+    }
     interface CalciteInputTimePicker {
         /**
           * The active state of the time input
@@ -2670,7 +2788,7 @@ export namespace Components {
          */
         "open": boolean;
         /**
-          * Describes the positioning type to use for the overlaid content. If the element is in a fixed container, use the "fixed" value.
+          * 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".
          */
         "overlayPositioning": OverlayPositioning;
         /**
@@ -2736,44 +2854,44 @@ export namespace Components {
     }
     interface CalciteRadioButton {
         /**
-          * The checked state of the radio button.
+          * When true, the component is checked.
          */
         "checked": boolean;
         /**
-          * The disabled state of the radio button.
+          * When true, interaction is prevented and the component is displayed with lower opacity.
          */
         "disabled": boolean;
         "emitCheckedChange": () => Promise<void>;
         /**
-          * The focused state of the radio button.
+          * The focused state of the component.
          */
         "focused": boolean;
         /**
-          * The id attribute of the radio button.  When omitted, a globally unique identifier is used.
+          * The id attribute of the component. When omitted, a globally unique identifier is used.
          */
         "guid": string;
         /**
-          * The radio button's hidden status.  When a radio button is hidden it is not focusable or checkable.
+          * When true, the component is not displayed and is not focusable or checkable.
          */
         "hidden": boolean;
         /**
-          * The hovered state of the radio button.
+          * The hovered state of the component.
          */
         "hovered": boolean;
         /**
-          * The label of the radio input
+          * Accessible name for the component.
          */
         "label"?: string;
         /**
-          * The name of the radio button. `name` is passed as a property automatically from `calcite-radio-button-group`.
+          * Specifies the name of the component, passed from the `calcite-radio-button-group` on form submission.
          */
         "name": string;
         /**
-          * Requires that a value is selected for the radio button group before the parent form will submit.
+          * When true, the component must have a value selected from the `calcite-radio-button-group` on form submission.
          */
         "required": boolean;
         /**
-          * The scale (size) of the radio button. `scale` is passed as a property automatically from `calcite-radio-button-group`.
+          * Specifies the size of the component inherited from the `calcite-radio-button-group`.
          */
         "scale": Scale;
         /**
@@ -2781,63 +2899,63 @@ export namespace Components {
          */
         "setFocus": () => Promise<void>;
         /**
-          * The value of the radio button.
+          * The component's value.
          */
         "value": any;
     }
     interface CalciteRadioButtonGroup {
         /**
-          * The disabled state of the radio button group.
+          * When true, interaction is prevented and the component is displayed with lower opacity.
          */
         "disabled": boolean;
         /**
-          * The radio button group's hidden status.  When a radio button group is hidden none of its options are focusable or checkable.
+          * When true, the component is not displayed and its `calcite-radio-button`s are not focusable or checkable.
          */
         "hidden": boolean;
         /**
-          * The layout direction of the radio buttons in a group.
+          * Defines the layout of the component.
          */
         "layout": Layout;
         /**
-          * The name of the radio button group. `name` must be unique to other radio button group instances.
+          * Specifies the name of the component on form submission. Must be unique to other component instances.
          */
         "name": string;
         /**
-          * Requires that a value is selected for the radio button group before the parent form will submit.
+          * When true, the component must have a value on form submission.
          */
         "required": boolean;
         /**
-          * The scale (size) of the radio button group.
+          * Specifies the size of the component.
          */
         "scale": Scale;
     }
     interface CalciteRadioGroup {
         /**
-          * specify the appearance style of the radio group, defaults to solid.
+          * Specifies the appearance style of the component.
          */
         "appearance": RadioAppearance;
         /**
-          * is the radio group disabled
+          * When true, interaction is prevented and the component is displayed with lower opacity.
          */
         "disabled": boolean;
         /**
-          * specify the layout of the radio group, defaults to horizontal
+          * Defines the layout of the component.
          */
         "layout": Layout;
         /**
-          * The group's name. Gets submitted with the form.
+          * Specifies the name of the component on form submission.
          */
         "name": string;
         /**
-          * When true, makes the component required for form-submission.
+          * When true, the component must have a value on form submission.
          */
         "required": boolean;
         /**
-          * The scale of the radio group
+          * Specifies the size of the component.
          */
         "scale": Scale;
         /**
-          * The group's selected item.
+          * The component's selected item `HTMLElement`.
           * @readonly
          */
         "selectedItem": HTMLCalciteRadioGroupItemElement;
@@ -2846,73 +2964,73 @@ export namespace Components {
          */
         "setFocus": () => Promise<void>;
         /**
-          * The value of the selectedItem
+          * The component's "selectedItem" value.
          */
         "value": string;
         /**
-          * specify the width of the group, defaults to auto
+          * Specifies the width of the component.
          */
         "width": Extract<"auto" | "full", Width>;
     }
     interface CalciteRadioGroupItem {
         /**
-          * Indicates whether the control is checked.
+          * When true, the component is checked.
          */
         "checked": boolean;
         /**
-          * optionally pass an icon to display - accepts Calcite UI icon names
+          * Specifies an icon to display - accepts Calcite UI icon names.
          */
         "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;
         /**
-          * optionally used with icon, select where to position the icon
+          * When used with "icon", specifies its position.
          */
         "iconPosition"?: Position;
         /**
-          * The control's value.
+          * The component's value.
          */
         "value": any | null;
     }
     interface CalciteRating {
         /**
-          * optionally pass a cumulative average rating to display
+          * Specifies a cumulative average from previous ratings to display.
          */
         "average"?: number;
         /**
-          * optionally pass a number of previous ratings to display
+          * Specifies the number of previous ratings to display.
          */
         "count"?: number;
         /**
-          * is the rating component in a selectable mode
+          * When true, interaction is prevented and the component is displayed with lower opacity.
          */
         "disabled": boolean;
         /**
-          * Localized string for "Rating" (used for aria label)
+          * Accessible name for the component.
           * @default "Rating"
          */
         "intlRating"?: string;
         /**
-          * Localized string for labelling each star, `${num}` in the string will be replaced by the number
+          * Accessible name for each star. The `${num}` in the string will be replaced by the number.
           * @default "Stars: ${num}"
          */
         "intlStars"?: string;
         /**
-          * The name of the rating
+          * Specifies the name of the component on form submission.
          */
         "name": string;
         /**
-          * is the rating component in a selectable mode
+          * When true, the component's value can be read, but cannot be modified.
          */
         "readOnly": boolean;
         /**
-          * When true, makes the component required for form-submission.
+          * When true, the component must have a value on form submission.
          */
         "required": boolean;
         /**
-          * specify the scale of the component, defaults to m
+          * Specifies the size of the component.
          */
         "scale": Scale;
         /**
@@ -2920,48 +3038,48 @@ export namespace Components {
          */
         "setFocus": () => Promise<void>;
         /**
-          * Show average and count data summary chip (if available)
+          * When true, and if available, displays the "average" and/or "count" data summary in a `calcite-chip`.
          */
         "showChip": boolean;
         /**
-          * the value of the rating component
+          * The component's value.
          */
         "value": number;
     }
     interface CalciteScrim {
         /**
-          * string to override English loading text
+          * Accessible name when the component is loading.
           * @default "Loading"
          */
         "intlLoading"?: string;
         /**
-          * Determines if the component will have the loader overlay. Otherwise, will render opaque disabled state.
+          * When true, a busy indicator is displayed.
          */
         "loading": boolean;
     }
     interface CalciteSelect {
         /**
-          * When true, it prevents the option from being selected.
+          * When true, interaction is prevented and the component is displayed with lower opacity.
          */
         "disabled": boolean;
         /**
-          * The component's label. This is required for accessibility purposes.
+          * Accessible name for the component.
          */
         "label": string;
         /**
-          * The select's name. Gets submitted with the form.
+          * Specifies the name of the component on form submission.
          */
         "name": string;
         /**
-          * When true, makes the component required for form-submission.
+          * When true, the component must have a value on form submission.
          */
         "required": boolean;
         /**
-          * The component scale.
+          * Specifies the size of the component.
          */
         "scale": Scale;
         /**
-          * The currently selected option.
+          * The component's selected option `HTMLElement`.
           * @readonly
          */
         "selectedOption": HTMLCalciteOptionElement;
@@ -2970,113 +3088,113 @@ export namespace Components {
          */
         "setFocus": () => Promise<void>;
         /**
-          * The value of the selectedOption
+          * The component's "selectedOption" value.
          */
         "value": string;
         /**
-          * The component width.
+          * Specifies the width of the component.
          */
         "width": Width;
     }
     interface CalciteShell {
         /**
-          * Positions the center content behind any calcite-shell-panels.
+          * Positions the center content behind any `calcite-shell-panel`s.
          */
         "contentBehind": boolean;
     }
     interface CalciteShellCenterRow {
         /**
-          * This property makes the content area appear like a "floating" panel.
+          * When true, the content area displays like a floating panel.
          */
         "detached": boolean;
         /**
-          * Specifies the maximum height of the row.
+          * Specifies the maximum height of the component.
          */
         "heightScale": Scale;
         /**
-          * Arranges the component depending on the elements 'dir' property.
+          * Specifies the component's position. Will be flipped when the element direction is right-to-left ("rtl").
          */
         "position": Position;
     }
     interface CalciteShellPanel {
         /**
-          * Hide the content panel.
+          * When true, hides the component's content area.
          */
         "collapsed": boolean;
         /**
-          * This property makes the content area appear like a "floating" panel.
+          * When true, the content area displays like a floating panel.
          */
         "detached": boolean;
         /**
-          * Specifies the maximum height of the contents when detached.
+          * When "detached", specifies the maximum height of the component.
          */
         "detachedHeightScale": Scale;
         /**
-          * Accessible label for resize separator.
+          * Accessible name for the resize separator.
           * @default "Resize"
          */
         "intlResize": string;
         /**
-          * Arranges the component depending on the elements 'dir' property.
+          * Specifies the component's position. Will be flipped when the element direction is right-to-left ("rtl").
          */
         "position": Position;
         /**
-          * This property makes the content area resizable if the calcite-shell-panel is not 'detached'.
+          * When true and not "detached", the component's content area is resizable.
          */
         "resizable": boolean;
         /**
-          * This sets width of the content area.
+          * Specifies the width of the component's content area.
          */
         "widthScale": Scale;
     }
     interface CalciteSlider {
         /**
-          * Disable and gray out the slider
+          * When true, interaction is prevented and the component is displayed with lower opacity.
          */
         "disabled": boolean;
         /**
-          * Indicates if a histogram is present
+          * When true, indicates a histogram is present.
          */
         "hasHistogram": boolean;
         /**
-          * List of x,y coordinates within the slider's min and max, displays above the slider track.
+          * A list of the histogram's x,y coordinates within the component's "min" and "max". Displays above the component's track.
           * @see [DataSeries](https://github.com/Esri/calcite-components/blob/master/src/components/graph/interfaces.ts#L5)
          */
         "histogram"?: DataSeries;
         /**
-          * Array of values describing a single color stop, sorted by offset ascending.
+          * A set of single color stops for a histogram, sorted by offset ascending.
          */
         "histogramStops": ColorStop[];
         /**
-          * Label handles with their numeric value
+          * When true, displays label handles with their numeric value.
          */
         "labelHandles": boolean;
         /**
-          * Label tick marks with their numeric value.
+          * When true and "ticks" is specified, displays label tick marks with their numeric value.
          */
         "labelTicks": boolean;
         /**
-          * Maximum selectable value
+          * The component's maximum selectable value.
          */
         "max": number;
         /**
-          * Used as an accessible label (aria-label) for second handle if needed (ex. "Temperature, upper bound")
+          * For multiple selections, the accessible name for the second handle, such as "Temperature, upper bound".
          */
         "maxLabel"?: string;
         /**
-          * Currently selected upper number (if multi-select)
+          * For multiple selections, the component's upper value.
          */
         "maxValue"?: number;
         /**
-          * Minimum selectable value
+          * The component's minimum selectable value.
          */
         "min": number;
         /**
-          * Used as an accessible label (aria-label) for first (or only) handle (ex. "Temperature, lower bound")
+          * Accessible name for first (or only) handle, such as "Temperature, lower bound".
          */
         "minLabel": string;
         /**
-          * Currently selected lower number (if multi-select)
+          * For multiple selections, the component's lower value.
          */
         "minValue"?: number;
         /**
@@ -3084,23 +3202,23 @@ export namespace Components {
          */
         "mirrored": boolean;
         /**
-          * The name of the slider
+          * Specifies the name of the component on form submission.
          */
         "name": string;
         /**
-          * Interval to move on page up/page down keys
+          * Specifies the interval to move with the page up, or page down keys.
          */
         "pageStep"?: number;
         /**
-          * Use finer point for handles
+          * When true, sets a finer point for handles.
          */
         "precise": boolean;
         /**
-          * When true, makes the component required for form-submission.
+          * When true, the component must have a value on form submission.
          */
         "required": boolean;
         /**
-          * Specify the scale of the slider, defaults to m
+          * Specifies the size of the component.
          */
         "scale": Scale;
         /**
@@ -3108,19 +3226,19 @@ export namespace Components {
          */
         "setFocus": () => Promise<void>;
         /**
-          * When true, enables snap selection along the step interval
+          * When true, enables snap selection in coordination with "step" via a mouse.
          */
         "snap": boolean;
         /**
-          * Interval to move on up/down keys
+          * Specifies the interval to move with the up, or down keys.
          */
         "step"?: number;
         /**
-          * Show tick marks on the number line at provided interval
+          * Displays tick marks on the number line at a specified interval.
          */
         "ticks"?: number;
         /**
-          * Currently selected number (if single select)
+          * The component's value.
          */
         "value": null | number | number[];
     }
@@ -3152,108 +3270,109 @@ export namespace Components {
     }
     interface CalciteSplitButton {
         /**
-          * Is the dropdown currently active or not
+          * When true, the component is active.
          */
         "active": boolean;
         /**
-          * specify the appearance style of the button, defaults to solid.
+          * Specifies the appearance style of the component.
          */
         "appearance": ButtonAppearance;
         /**
-          * specify the color of the control, defaults to blue
+          * Specifies the color of the component.
          */
         "color": ButtonColor;
         /**
-          * is the control disabled
+          * When true, interaction is prevented and the component is displayed with lower opacity.
          */
         "disabled": boolean;
         /**
-          * specify the icon used for the dropdown menu, defaults to chevron
+          * Specifies the icon used for the dropdown menu.
          */
         "dropdownIconType": DropdownIconType;
         /**
-          * aria label for overflow button
+          * Accessible name for the dropdown menu.
          */
         "dropdownLabel"?: string;
         /**
-          * optionally add a calcite-loader component to the control, disabling interaction. with the primary button
+          * When true, a busy indicator is displayed on the primary button.
          */
         "loading": boolean;
         /**
-          * Describes the type of positioning to use for the dropdown. If your element is in a fixed container, use the 'fixed' value.
+          * 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".
          */
         "overlayPositioning": OverlayPositioning;
         /**
-          * optionally pass 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 - accepts Calcite UI icon names.
          */
         "primaryIconEnd"?: string;
         /**
-          * flip the primary icon(s) in rtl
+          * When true, the primary button icon will be flipped when the element direction is right-to-left ("rtl").
          */
         "primaryIconFlipRtl"?: FlipContext;
         /**
-          * optionally pass 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 - accepts Calcite UI icon names.
          */
         "primaryIconStart"?: string;
         /**
-          * optionally pass an aria-label for the primary button
+          * Accessible name for the primary button.
          */
         "primaryLabel"?: string;
         /**
-          * text for primary action button
+          * Text displayed in the primary button.
          */
         "primaryText": string;
         /**
-          * specify the scale of the control, defaults to m
+          * Specifies the size of the component.
          */
         "scale": Scale;
         /**
-          * specify the width of the button, defaults to auto
+          * Specifies the width of the component.
          */
         "width": Width;
     }
     interface CalciteStepper {
         /**
-          * set the last step as active
+          * Set the last `calcite-stepper-item` as active.
          */
         "endStep": () => Promise<void>;
         /**
-          * set the requested step as active
+          * Set a specified `calcite-stepper-item` as active.
           * @param step
          */
         "goToStep": (step: number) => Promise<void>;
         /**
-          * optionally display a status icon next to the step title
+          * When true, displays a status icon in the `calcite-stepper-item` heading.
          */
         "icon": boolean;
         /**
-          * specify the layout of stepper, defaults to horizontal
+          * Defines the layout of the component.
          */
         "layout": Extract<"horizontal" | "vertical", Layout>;
         /**
-          * set the next step as active
+          * Set the next `calcite-stepper-item` as active.
          */
         "nextStep": () => Promise<void>;
         /**
-          * optionally display the number next to the step title
+          * When true, displays the step number in the `calcite-stepper-item` heading.
          */
         "numbered": boolean;
         /**
-          * set the previous step as active
+          * Set the previous `calcite-stepper-item` as active.
          */
         "prevStep": () => Promise<void>;
         /**
-          * specify the scale of stepper, defaults to m
+          * Specifies the size of the component.
          */
         "scale": Scale;
         /**
-          * set the first step as active
+          * Set the first `calcite-stepper-item` as active.
          */
         "startStep": () => Promise<void>;
     }
     interface CalciteStepperItem {
         /**
           * is the step active
+          * @deprecated Use selected instead.
          */
         "active": boolean;
         /**
@@ -3261,56 +3380,60 @@ export namespace Components {
          */
         "complete": boolean;
         /**
-          * stepper item description
+          * A description for the component. Displays below the header text.
          */
         "description": string;
         /**
-          * is the step disabled and not navigable to by a user
+          * When true, interaction is prevented and the component is displayed with lower opacity.
          */
         "disabled": boolean;
         /**
-          * does the step contain an error that needs to be resolved by the user
+          * When true, the component contains an error that requires resolution from the user.
          */
         "error": boolean;
         /**
-          * stepper item heading
+          * The component header text.
          */
         "heading"?: string;
         "icon": boolean;
         /**
-          * pass a title for the stepper item
-          * @deprecated use description instead
+          * A description for the component. Displays below the header text.
+          * @deprecated use "description" instead.
          */
         "itemSubtitle"?: string;
         /**
-          * pass a title for the stepper item
-          * @deprecated use heading instead
+          * The component header text.
+          * @deprecated use "heading" instead.
          */
         "itemTitle"?: string;
         "layout"?: Extract<"horizontal" | "vertical", Layout>;
         "numbered": boolean;
         "scale": Scale;
+        /**
+          * When true, step is selected
+         */
+        "selected": boolean;
         "setFocus": () => Promise<void>;
     }
     interface CalciteSwitch {
         /**
-          * True if the switch is initially on
+          * When true, the component is checked.
          */
         "checked": boolean;
         /**
-          * True if the switch is disabled
+          * When true, interaction is prevented and the component is displayed with lower opacity.
          */
         "disabled": boolean;
         /**
-          * Applies to the aria-label attribute on the switch
+          * Accessible name for the component.
          */
         "label"?: string;
         /**
-          * The name of the switch input
+          * Specifies the name of the component on form submission.
          */
         "name": string;
         /**
-          * The scale of the switch
+          * Specifies the size of the component.
          */
         "scale": Scale;
         /**
@@ -3318,18 +3441,19 @@ export namespace Components {
          */
         "setFocus": () => Promise<void>;
         /**
-          * True if the switch is initially on
-          * @deprecated use 'checked' instead.
+          * When true, the component is checked.
+          * @deprecated use "checked" instead.
          */
         "switched": boolean;
         /**
-          * The value of the switch input
+          * The component's value.
          */
         "value": any;
     }
     interface CalciteTab {
         /**
           * Show this tab
+          * @deprecated Use selected instead.
          */
         "active": boolean;
         /**
@@ -3337,6 +3461,10 @@ export namespace Components {
          */
         "getTabIndex": () => Promise<number>;
         "scale": Scale;
+        /**
+          * When true, display this tab.
+         */
+        "selected": boolean;
         /**
           * Optionally include a unique name for this tab, be sure to also set this name on the associated title.
          */
@@ -3366,6 +3494,7 @@ export namespace Components {
     interface CalciteTabTitle {
         /**
           * Show this tab title as selected
+          * @deprecated Use selected instead.
          */
         "active": boolean;
         "bordered": boolean;
@@ -3393,6 +3522,10 @@ export namespace Components {
         "layout": TabLayout;
         "position": TabPosition;
         "scale": Scale;
+        /**
+          * When true, display this tab title as selected.
+         */
+        "selected": boolean;
         /**
           * Optionally include a unique name for the tab title, be sure to also set this name on the associated tab.
          */
@@ -3699,7 +3832,7 @@ export namespace Components {
          */
         "open": boolean;
         /**
-          * Describes the positioning type to use for the overlaid content. If the `referenceElement` is in a fixed container, use the "fixed" value.
+          * 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".
          */
         "overlayPositioning": OverlayPositioning;
         /**
@@ -3996,6 +4129,10 @@ export interface CalciteInputNumberCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLCalciteInputNumberElement;
 }
+export interface CalciteInputTextCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLCalciteInputTextElement;
+}
 export interface CalciteInputTimePickerCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLCalciteInputTimePickerElement;
@@ -4371,6 +4508,12 @@ declare global {
         prototype: HTMLCalciteInputNumberElement;
         new (): HTMLCalciteInputNumberElement;
     };
+    interface HTMLCalciteInputTextElement extends Components.CalciteInputText, HTMLStencilElement {
+    }
+    var HTMLCalciteInputTextElement: {
+        prototype: HTMLCalciteInputTextElement;
+        new (): HTMLCalciteInputTextElement;
+    };
     interface HTMLCalciteInputTimePickerElement extends Components.CalciteInputTimePicker, HTMLStencilElement {
     }
     var HTMLCalciteInputTimePickerElement: {
@@ -4723,6 +4866,7 @@ declare global {
         "calcite-input-date-picker": HTMLCalciteInputDatePickerElement;
         "calcite-input-message": HTMLCalciteInputMessageElement;
         "calcite-input-number": HTMLCalciteInputNumberElement;
+        "calcite-input-text": HTMLCalciteInputTextElement;
         "calcite-input-time-picker": HTMLCalciteInputTimePickerElement;
         "calcite-label": HTMLCalciteLabelElement;
         "calcite-link": HTMLCalciteLinkElement;
@@ -4979,7 +5123,7 @@ declare namespace LocalJSX {
          */
         "open"?: boolean;
         /**
-          * Determines the type of positioning to use for the overlaid content. If your element is in a fixed container, use the "fixed" value.
+          * 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".
          */
         "overlayPositioning"?: OverlayPositioning;
         /**
@@ -5028,7 +5172,8 @@ declare namespace LocalJSX {
     }
     interface CalciteAlert {
         /**
-          * When true, the component is active.
+          * When true, opens the combobox
+          * @deprecated use open instead
          */
         "active"?: boolean;
         /**
@@ -5072,6 +5217,10 @@ declare namespace LocalJSX {
           * Fires when the component is open and animation is complete.
          */
         "onCalciteAlertOpen"?: (event: CalciteAlertCustomEvent<void>) => void;
+        /**
+          * When true, opens the dropdown
+         */
+        "open"?: boolean;
         /**
           * Specifies the placement of the component
          */
@@ -5411,7 +5560,7 @@ declare namespace LocalJSX {
          */
         "allowEmpty"?: boolean;
         /**
-          * specify the appearance - default (containing border), or minimal (no containing border)
+          * specify the appearance - solid (containing border), or minimal (no containing border)
          */
         "appearance"?: ColorAppearance;
         /**
@@ -5650,7 +5799,9 @@ declare namespace LocalJSX {
         /**
           * Called when the selected item(s) changes.
          */
-        "onCalciteComboboxChange"?: (event: CalciteComboboxCustomEvent<{ selectedItems: HTMLCalciteComboboxItemElement[] }>) => void;
+        "onCalciteComboboxChange"?: (event: CalciteComboboxCustomEvent<{
+    selectedItems: HTMLCalciteComboboxItemElement[];
+  }>) => void;
         /**
           * Called when a selected item in the combobox is dismissed via its chip  **Note:**: The event payload is deprecated, please use the `value` property on the component to determine removed value instead
          */
@@ -5662,9 +5813,9 @@ declare namespace LocalJSX {
         /**
           * Called when the user has entered text to filter the options list
          */
-        "onCalciteComboboxFilterChange"?: (event: CalciteComboboxCustomEvent<{
-    visibleItems: HTMLCalciteComboboxItemElement[];
-    text: string;
+        "onCalciteComboboxFilterChange"?: (event: CalciteComboboxCustomEvent<{
+    visibleItems: HTMLCalciteComboboxItemElement[];
+    text: string;
   }>) => void;
         /**
           * Fires when the component is open and animation is complete.
@@ -5680,7 +5831,7 @@ declare namespace LocalJSX {
          */
         "open"?: boolean;
         /**
-          * Describes the type of positioning to use for the overlaid content. If your element is in a fixed container, use the 'fixed' value.
+          * 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".
          */
         "overlayPositioning"?: OverlayPositioning;
         /**
@@ -6046,13 +6197,13 @@ declare namespace LocalJSX {
         /**
           * fires when a dropdown item has been selected or deselected
          */
-        "onCalciteDropdownSelect"?: (event: CalciteDropdownCustomEvent<void>) => void;
+        "onCalciteDropdownSelect"?: (event: CalciteDropdownCustomEvent<Selection>) => void;
         /**
           * When true, opens the dropdown
          */
         "open"?: boolean;
         /**
-          * Describes the type of positioning to use for the overlaid content. If your element is in a fixed container, use the 'fixed' value.
+          * 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".
          */
         "overlayPositioning"?: OverlayPositioning;
         /**
@@ -6095,6 +6246,7 @@ declare namespace LocalJSX {
     interface CalciteDropdownItem {
         /**
           * Indicates whether the item is active.
+          * @deprecated Use selected instead.
          */
         "active"?: boolean;
         /**
@@ -6121,6 +6273,10 @@ declare namespace LocalJSX {
           * The rel attribute to apply to the hyperlink
          */
         "rel"?: string;
+        /**
+          * When true, item is selected
+         */
+        "selected"?: boolean;
         /**
           * The target attribute to apply to the hyperlink
          */
@@ -6234,7 +6390,7 @@ declare namespace LocalJSX {
     }
     interface CalciteHandle {
         /**
-          * Emitted when the 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;
         /**
@@ -6451,21 +6607,21 @@ declare namespace LocalJSX {
         /**
           * Specifies the component type.  Note that the following types add type-specific icons by default: "date", "email", "password", "search", "tel", "time".
          */
-        "type"?: | "color"
-    | "date"
-    | "datetime-local"
-    | "email"
-    | "file"
-    | "image"
-    | "month"
-    | "number"
-    | "password"
-    | "search"
-    | "tel"
-    | "text"
-    | "textarea"
-    | "time"
-    | "url"
+        "type"?: | "color"
+    | "date"
+    | "datetime-local"
+    | "email"
+    | "file"
+    | "image"
+    | "month"
+    | "number"
+    | "password"
+    | "search"
+    | "tel"
+    | "text"
+    | "textarea"
+    | "time"
+    | "url"
     | "week";
         /**
           * The component's value.
@@ -6579,7 +6735,7 @@ declare namespace LocalJSX {
          */
         "open"?: boolean;
         /**
-          * Describes the type of positioning to use for the overlaid content. If your element is in a fixed container, use the 'fixed' value.
+          * 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".
          */
         "overlayPositioning"?: OverlayPositioning;
         /**
@@ -6785,6 +6941,117 @@ declare namespace LocalJSX {
          */
         "value"?: string;
     }
+    interface CalciteInputText {
+        /**
+          * Specifies the text alignment of the component's value.
+         */
+        "alignment"?: Position;
+        /**
+          * When true, the component is focused on page load.
+          * @mdn [autofocus](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/autofocus)
+         */
+        "autofocus"?: boolean;
+        /**
+          * When true, a clear button is displayed when the component has a value.
+         */
+        "clearable"?: boolean;
+        /**
+          * When true, interaction is prevented and the component is displayed with lower opacity.
+          * @mdn [disabled](https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/disabled)
+         */
+        "disabled"?: boolean;
+        /**
+          * When true, the component will not be visible.
+          * @mdn [hidden](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/hidden)
+         */
+        "hidden"?: boolean;
+        /**
+          * When true, shows a default recommended icon. Alternatively, pass a Calcite UI Icon name to display a specific icon.
+         */
+        "icon"?: string | boolean;
+        /**
+          * When true, the icon is flipped in RTL.
+         */
+        "iconFlipRtl"?: boolean;
+        /**
+          * A text label that will appear on the clear button for screen readers.
+         */
+        "intlClear"?: string;
+        /**
+          * Accessible name that will appear while loading.
+          * @default "Loading"
+         */
+        "intlLoading"?: string;
+        /**
+          * Accessible name for the component's button or hyperlink.
+         */
+        "label"?: string;
+        /**
+          * When true, the component is in the loading state and `calcite-progress` is displayed.
+         */
+        "loading"?: boolean;
+        /**
+          * Specifies the maximum length of text for the component's value.
+          * @mdn [maxlength](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#maxlength)
+         */
+        "maxLength"?: number;
+        /**
+          * Specifies the minimum length of text for the component's value.
+          * @mdn [minlength](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#minlength)
+         */
+        "minLength"?: number;
+        /**
+          * Specifies the name of the component.
+          * @mdn [name](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#name)
+         */
+        "name"?: string;
+        /**
+          * Fires each time a new value is typed and committed.
+         */
+        "onCalciteInputTextChange"?: (event: CalciteInputTextCustomEvent<void>) => void;
+        /**
+          * Fires each time a new value is typed.
+         */
+        "onCalciteInputTextInput"?: (event: CalciteInputTextCustomEvent<{
+    element: HTMLInputElement;
+    nativeEvent: MouseEvent | KeyboardEvent | InputEvent;
+    value: string;
+  }>) => void;
+        /**
+          * Specifies placeholder text for the component.
+          * @mdn [placeholder](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#placeholder)
+         */
+        "placeholder"?: string;
+        /**
+          * Adds text to the start of the component.
+         */
+        "prefixText"?: string;
+        /**
+          * When true, the value cannot be modified.
+          * @mdn [readOnly](https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/readonly)
+         */
+        "readOnly"?: boolean;
+        /**
+          * When true, the component must have a value in order for the form to submit.
+         */
+        "required"?: boolean;
+        /**
+          * Specifies the size of the component.
+         */
+        "scale"?: Scale;
+        /**
+          * Specifies the status of the input field, which determines message and icons.
+         */
+        "status"?: Status;
+        /**
+          * Adds text to the end of the component.
+         */
+        "suffixText"?: string;
+        /**
+          * The component's value.
+         */
+        "value"?: string;
+    }
     interface CalciteInputTimePicker {
         /**
           * The active state of the time input
@@ -7376,11 +7643,11 @@ declare namespace LocalJSX {
         /**
           * Fires when the component is selected or unselected.
          */
-        "onCalciteListItemChange"?: (event: CalcitePickListItemCustomEvent<{
-    item: HTMLCalcitePickListItemElement;
-    value: any;
-    selected: boolean;
-    shiftPressed: boolean;
+        "onCalciteListItemChange"?: (event: CalcitePickListItemCustomEvent<{
+    item: HTMLCalcitePickListItemElement;
+    value: any;
+    selected: boolean;
+    shiftPressed: boolean;
   }>) => void;
         /**
           * Fires when the remove button is pressed.
@@ -7477,7 +7744,7 @@ declare namespace LocalJSX {
          */
         "open"?: boolean;
         /**
-          * Describes the positioning type to use for the overlaid content. If the element is in a fixed container, use the "fixed" value.
+          * 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".
          */
         "overlayPositioning"?: OverlayPositioning;
         /**
@@ -7529,23 +7796,23 @@ declare namespace LocalJSX {
     }
     interface CalciteRadioButton {
         /**
-          * The checked state of the radio button.
+          * When true, the component is checked.
          */
         "checked"?: boolean;
         /**
-          * The disabled state of the radio button.
+          * When true, interaction is prevented and the component is displayed with lower opacity.
          */
         "disabled"?: boolean;
         /**
-          * The id attribute of the radio button.  When omitted, a globally unique identifier is used.
+          * The id attribute of the component. When omitted, a globally unique identifier is used.
          */
         "guid"?: string;
         /**
-          * The radio button's hidden status.  When a radio button is hidden it is not focusable or checkable.
+          * When true, the component is not displayed and is not focusable or checkable.
          */
         "hidden"?: boolean;
         /**
-          * The name of the radio button. `name` is passed as a property automatically from `calcite-radio-button-group`.
+          * Specifies the name of the component, passed from the `calcite-radio-button-group` on form submission.
          */
         "name"?: string;
         /**
@@ -7553,307 +7820,307 @@ declare namespace LocalJSX {
          */
         "onCalciteRadioButtonChange"?: (event: CalciteRadioButtonCustomEvent<void>) => void;
         /**
-          * Requires that a value is selected for the radio button group before the parent form will submit.
+          * When true, the component must have a value selected from the `calcite-radio-button-group` on form submission.
          */
         "required"?: boolean;
         /**
-          * The scale (size) of the radio button. `scale` is passed as a property automatically from `calcite-radio-button-group`.
+          * Specifies the size of the component inherited from the `calcite-radio-button-group`.
          */
         "scale"?: Scale;
         /**
-          * The value of the radio button.
+          * The component's value.
          */
         "value": any;
     }
     interface CalciteRadioButtonGroup {
         /**
-          * The disabled state of the radio button group.
+          * When true, interaction is prevented and the component is displayed with lower opacity.
          */
         "disabled"?: boolean;
         /**
-          * The radio button group's hidden status.  When a radio button group is hidden none of its options are focusable or checkable.
+          * When true, the component is not displayed and its `calcite-radio-button`s are not focusable or checkable.
          */
         "hidden"?: boolean;
         /**
-          * The layout direction of the radio buttons in a group.
+          * Defines the layout of the component.
          */
         "layout"?: Layout;
         /**
-          * The name of the radio button group. `name` must be unique to other radio button group instances.
+          * Specifies the name of the component on form submission. Must be unique to other component instances.
          */
         "name": string;
         /**
-          * Emitted when the radio button group has changed.
+          * Fires when the component has changed.
          */
-        "onCalciteRadioButtonGroupChange"?: (event: CalciteRadioButtonGroupCustomEvent<void>) => void;
+        "onCalciteRadioButtonGroupChange"?: (event: CalciteRadioButtonGroupCustomEvent<any>) => void;
         /**
-          * Requires that a value is selected for the radio button group before the parent form will submit.
+          * When true, the component must have a value on form submission.
          */
         "required"?: boolean;
         /**
-          * The scale (size) of the radio button group.
+          * Specifies the size of the component.
          */
         "scale"?: Scale;
     }
     interface CalciteRadioGroup {
         /**
-          * specify the appearance style of the radio group, defaults to solid.
+          * Specifies the appearance style of the component.
          */
         "appearance"?: RadioAppearance;
         /**
-          * is the radio group disabled
+          * When true, interaction is prevented and the component is displayed with lower opacity.
          */
         "disabled"?: boolean;
         /**
-          * specify the layout of the radio group, defaults to horizontal
+          * Defines the layout of the component.
          */
         "layout"?: Layout;
         /**
-          * The group's name. Gets submitted with the form.
+          * Specifies the name of the component on form submission.
          */
         "name"?: string;
         /**
-          * Fired when the selected option changes, event detail is the new value
+          * Fires when the selected option changes, where the event detail is the new value.
          */
         "onCalciteRadioGroupChange"?: (event: CalciteRadioGroupCustomEvent<string>) => void;
         /**
-          * The scale of the radio group
+          * Specifies the size of the component.
          */
         "scale"?: Scale;
         /**
-          * The group's selected item.
+          * The component's selected item `HTMLElement`.
           * @readonly
          */
         "selectedItem"?: HTMLCalciteRadioGroupItemElement;
         /**
-          * The value of the selectedItem
+          * The component's "selectedItem" value.
          */
         "value"?: string;
         /**
-          * specify the width of the group, defaults to auto
+          * Specifies the width of the component.
          */
         "width"?: Extract<"auto" | "full", Width>;
     }
     interface CalciteRadioGroupItem {
         /**
-          * Indicates whether the control is checked.
+          * When true, the component is checked.
          */
         "checked"?: boolean;
         /**
-          * optionally pass an icon to display - accepts Calcite UI icon names
+          * Specifies an icon to display - accepts Calcite UI icon names.
          */
         "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;
         /**
-          * optionally used with icon, select where to position the icon
+          * When used with "icon", specifies its position.
          */
         "iconPosition"?: Position;
         /**
-          * The control's value.
+          * The component's value.
          */
         "value"?: any | null;
     }
     interface CalciteRating {
         /**
-          * optionally pass a cumulative average rating to display
+          * Specifies a cumulative average from previous ratings to display.
          */
         "average"?: number;
         /**
-          * optionally pass a number of previous ratings to display
+          * Specifies the number of previous ratings to display.
          */
         "count"?: number;
         /**
-          * is the rating component in a selectable mode
+          * When true, interaction is prevented and the component is displayed with lower opacity.
          */
         "disabled"?: boolean;
         /**
-          * Localized string for "Rating" (used for aria label)
+          * Accessible name for the component.
           * @default "Rating"
          */
         "intlRating"?: string;
         /**
-          * Localized string for labelling each star, `${num}` in the string will be replaced by the number
+          * Accessible name for each star. The `${num}` in the string will be replaced by the number.
           * @default "Stars: ${num}"
          */
         "intlStars"?: string;
         /**
-          * The name of the rating
+          * Specifies the name of the component on form submission.
          */
         "name"?: string;
         /**
-          * Fires when the rating value has changed.
+          * Fires when the component's value changes.
          */
         "onCalciteRatingChange"?: (event: CalciteRatingCustomEvent<{ value: number }>) => void;
         /**
-          * is the rating component in a selectable mode
+          * When true, the component's value can be read, but cannot be modified.
          */
         "readOnly"?: boolean;
         /**
-          * specify the scale of the component, defaults to m
+          * Specifies the size of the component.
          */
         "scale"?: Scale;
         /**
-          * Show average and count data summary chip (if available)
+          * When true, and if available, displays the "average" and/or "count" data summary in a `calcite-chip`.
          */
         "showChip"?: boolean;
         /**
-          * the value of the rating component
+          * The component's value.
          */
         "value"?: number;
     }
     interface CalciteScrim {
         /**
-          * string to override English loading text
+          * Accessible name when the component is loading.
           * @default "Loading"
          */
         "intlLoading"?: string;
         /**
-          * Determines if the component will have the loader overlay. Otherwise, will render opaque disabled state.
+          * When true, a busy indicator is displayed.
          */
         "loading"?: boolean;
     }
     interface CalciteSelect {
         /**
-          * When true, it prevents the option from being selected.
+          * When true, interaction is prevented and the component is displayed with lower opacity.
          */
         "disabled"?: boolean;
         /**
-          * The component's label. This is required for accessibility purposes.
+          * Accessible name for the component.
          */
         "label": string;
         /**
-          * The select's name. Gets submitted with the form.
+          * Specifies the name of the component on form submission.
          */
         "name"?: string;
         /**
-          * This event will fire whenever the selected option changes.
+          * Fires when the selected option changes.
          */
         "onCalciteSelectChange"?: (event: CalciteSelectCustomEvent<void>) => void;
         /**
-          * The component scale.
+          * Specifies the size of the component.
          */
         "scale"?: Scale;
         /**
-          * The currently selected option.
+          * The component's selected option `HTMLElement`.
           * @readonly
          */
         "selectedOption"?: HTMLCalciteOptionElement;
         /**
-          * The value of the selectedOption
+          * The component's "selectedOption" value.
          */
         "value"?: string;
         /**
-          * The component width.
+          * Specifies the width of the component.
          */
         "width"?: Width;
     }
     interface CalciteShell {
         /**
-          * Positions the center content behind any calcite-shell-panels.
+          * Positions the center content behind any `calcite-shell-panel`s.
          */
         "contentBehind"?: boolean;
     }
     interface CalciteShellCenterRow {
         /**
-          * This property makes the content area appear like a "floating" panel.
+          * When true, the content area displays like a floating panel.
          */
         "detached"?: boolean;
         /**
-          * Specifies the maximum height of the row.
+          * Specifies the maximum height of the component.
          */
         "heightScale"?: Scale;
         /**
-          * Arranges the component depending on the elements 'dir' property.
+          * Specifies the component's position. Will be flipped when the element direction is right-to-left ("rtl").
          */
         "position"?: Position;
     }
     interface CalciteShellPanel {
         /**
-          * Hide the content panel.
+          * When true, hides the component's content area.
          */
         "collapsed"?: boolean;
         /**
-          * This property makes the content area appear like a "floating" panel.
+          * When true, the content area displays like a floating panel.
          */
         "detached"?: boolean;
         /**
-          * Specifies the maximum height of the contents when detached.
+          * When "detached", specifies the maximum height of the component.
          */
         "detachedHeightScale"?: Scale;
         /**
-          * Accessible label for resize separator.
+          * Accessible name for the resize separator.
           * @default "Resize"
          */
         "intlResize"?: string;
         /**
           * Emitted when collapse has been toggled.
-          * @deprecated use a resizeObserver on the shell-panel to listen for changes to its size.
+          * @deprecated use a resizeObserver on the component to listen for changes to its size.
          */
         "onCalciteShellPanelToggle"?: (event: CalciteShellPanelCustomEvent<void>) => void;
         /**
-          * Arranges the component depending on the elements 'dir' property.
+          * Specifies the component's position. Will be flipped when the element direction is right-to-left ("rtl").
          */
         "position"?: Position;
         /**
-          * This property makes the content area resizable if the calcite-shell-panel is not 'detached'.
+          * When true and not "detached", the component's content area is resizable.
          */
         "resizable"?: boolean;
         /**
-          * This sets width of the content area.
+          * Specifies the width of the component's content area.
          */
         "widthScale"?: Scale;
     }
     interface CalciteSlider {
         /**
-          * Disable and gray out the slider
+          * When true, interaction is prevented and the component is displayed with lower opacity.
          */
         "disabled"?: boolean;
         /**
-          * Indicates if a histogram is present
+          * When true, indicates a histogram is present.
          */
         "hasHistogram"?: boolean;
         /**
-          * List of x,y coordinates within the slider's min and max, displays above the slider track.
+          * A list of the histogram's x,y coordinates within the component's "min" and "max". Displays above the component's track.
           * @see [DataSeries](https://github.com/Esri/calcite-components/blob/master/src/components/graph/interfaces.ts#L5)
          */
         "histogram"?: DataSeries;
         /**
-          * Array of values describing a single color stop, sorted by offset ascending.
+          * A set of single color stops for a histogram, sorted by offset ascending.
          */
         "histogramStops"?: ColorStop[];
         /**
-          * Label handles with their numeric value
+          * When true, displays label handles with their numeric value.
          */
         "labelHandles"?: boolean;
         /**
-          * Label tick marks with their numeric value.
+          * When true and "ticks" is specified, displays label tick marks with their numeric value.
          */
         "labelTicks"?: boolean;
         /**
-          * Maximum selectable value
+          * The component's maximum selectable value.
          */
         "max"?: number;
         /**
-          * Used as an accessible label (aria-label) for second handle if needed (ex. "Temperature, upper bound")
+          * For multiple selections, the accessible name for the second handle, such as "Temperature, upper bound".
          */
         "maxLabel"?: string;
         /**
-          * Currently selected upper number (if multi-select)
+          * For multiple selections, the component's upper value.
          */
         "maxValue"?: number;
         /**
-          * Minimum selectable value
+          * The component's minimum selectable value.
          */
         "min"?: number;
         /**
-          * Used as an accessible label (aria-label) for first (or only) handle (ex. "Temperature, lower bound")
+          * Accessible name for first (or only) handle, such as "Temperature, lower bound".
          */
         "minLabel"?: string;
         /**
-          * Currently selected lower number (if multi-select)
+          * For multiple selections, the component's lower value.
          */
         "minValue"?: number;
         /**
@@ -7861,52 +8128,52 @@ declare namespace LocalJSX {
          */
         "mirrored"?: boolean;
         /**
-          * The name of the slider
+          * Specifies the name of the component on form submission.
          */
         "name"?: string;
         /**
-          * Fires on when the thumb is released on slider If you need to constantly listen to the drag event, please 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;
         /**
-          * Fires on all updates to the slider. :warning: 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.
+          * 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.
          */
         "onCalciteSliderInput"?: (event: CalciteSliderCustomEvent<void>) => void;
         /**
-          * Fires on all updates to the slider. :warning: 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
+          * 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.
          */
         "onCalciteSliderUpdate"?: (event: CalciteSliderCustomEvent<void>) => void;
         /**
-          * Interval to move on page up/page down keys
+          * Specifies the interval to move with the page up, or page down keys.
          */
         "pageStep"?: number;
         /**
-          * Use finer point for handles
+          * When true, sets a finer point for handles.
          */
         "precise"?: boolean;
         /**
-          * When true, makes the component required for form-submission.
+          * When true, the component must have a value on form submission.
          */
         "required"?: boolean;
         /**
-          * Specify the scale of the slider, defaults to m
+          * Specifies the size of the component.
          */
         "scale"?: Scale;
         /**
-          * When true, enables snap selection along the step interval
+          * When true, enables snap selection in coordination with "step" via a mouse.
          */
         "snap"?: boolean;
         /**
-          * Interval to move on up/down keys
+          * Specifies the interval to move with the up, or down keys.
          */
         "step"?: number;
         /**
-          * Show tick marks on the number line at provided interval
+          * Displays tick marks on the number line at a specified interval.
          */
         "ticks"?: number;
         /**
-          * Currently selected number (if single select)
+          * The component's value.
          */
         "value"?: null | number | number[];
     }
@@ -7942,95 +8209,96 @@ declare namespace LocalJSX {
     }
     interface CalciteSplitButton {
         /**
-          * specify the appearance style of the button, defaults to solid.
+          * Specifies the appearance style of the component.
          */
         "appearance"?: ButtonAppearance;
         /**
-          * specify the color of the control, defaults to blue
+          * Specifies the color of the component.
          */
         "color"?: ButtonColor;
         /**
-          * is the control disabled
+          * When true, interaction is prevented and the component is displayed with lower opacity.
          */
         "disabled"?: boolean;
         /**
-          * specify the icon used for the dropdown menu, defaults to chevron
+          * Specifies the icon used for the dropdown menu.
          */
         "dropdownIconType"?: DropdownIconType;
         /**
-          * aria label for overflow button
+          * Accessible name for the dropdown menu.
          */
         "dropdownLabel"?: string;
         /**
-          * optionally add a calcite-loader component to the control, disabling interaction. with the primary button
+          * When true, a busy indicator is displayed on the primary button.
          */
         "loading"?: boolean;
         /**
-          * fired when the primary button is clicked  **Note:** The event payload is deprecated, please use separate mouse event listeners to get info about click.
+          * Fires when the primary button is clicked.  **Note:** The event payload is deprecated, use separate mouse event listeners to get info about click.
          */
         "onCalciteSplitButtonPrimaryClick"?: (event: CalciteSplitButtonCustomEvent<DeprecatedEventPayload>) => void;
         /**
-          * fired when the secondary button is clicked  **Note:** The event payload is deprecated, please use separate mouse event listeners to get info about click.
+          * Fires when the dropdown menu is clicked.  **Note:** The event payload is deprecated, use separate mouse event listeners to get info about click.
          */
         "onCalciteSplitButtonSecondaryClick"?: (event: CalciteSplitButtonCustomEvent<DeprecatedEventPayload>) => void;
         /**
-          * Describes the type of positioning to use for the dropdown. If your element is in a fixed container, use the 'fixed' value.
+          * 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".
          */
         "overlayPositioning"?: OverlayPositioning;
         /**
-          * optionally pass 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 - accepts Calcite UI icon names.
          */
         "primaryIconEnd"?: string;
         /**
-          * flip the primary icon(s) in rtl
+          * When true, the primary button icon will be flipped when the element direction is right-to-left ("rtl").
          */
         "primaryIconFlipRtl"?: FlipContext;
         /**
-          * optionally pass 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 - accepts Calcite UI icon names.
          */
         "primaryIconStart"?: string;
         /**
-          * optionally pass an aria-label for the primary button
+          * Accessible name for the primary button.
          */
         "primaryLabel"?: string;
         /**
-          * text for primary action button
+          * Text displayed in the primary button.
          */
         "primaryText"?: string;
         /**
-          * specify the scale of the control, defaults to m
+          * Specifies the size of the component.
          */
         "scale"?: Scale;
         /**
-          * specify the width of the button, defaults to auto
+          * Specifies the width of the component.
          */
         "width"?: Width;
     }
     interface CalciteStepper {
         /**
-          * optionally display a status icon next to the step title
+          * When true, displays a status icon in the `calcite-stepper-item` heading.
          */
         "icon"?: boolean;
         /**
-          * specify the layout of stepper, defaults to horizontal
+          * Defines the layout of the component.
          */
         "layout"?: Extract<"horizontal" | "vertical", Layout>;
         /**
-          * optionally display the number next to the step title
+          * When true, displays the step number in the `calcite-stepper-item` heading.
          */
         "numbered"?: boolean;
         /**
-          * This event fires when the active stepper item has changed.
+          * Fires when the active `calcite-stepper-item` changes.
          */
         "onCalciteStepperItemChange"?: (event: CalciteStepperCustomEvent<StepperItemChangeEventDetail>) => void;
         /**
-          * specify the scale of stepper, defaults to m
+          * Specifies the size of the component.
          */
         "scale"?: Scale;
     }
     interface CalciteStepperItem {
         /**
           * is the step active
+          * @deprecated Use selected instead.
          */
         "active"?: boolean;
         /**
@@ -8038,72 +8306,81 @@ declare namespace LocalJSX {
          */
         "complete"?: boolean;
         /**
-          * stepper item description
+          * A description for the component. Displays below the header text.
          */
         "description"?: string;
         /**
-          * is the step disabled and not navigable to by a user
+          * When true, interaction is prevented and the component is displayed with lower opacity.
          */
         "disabled"?: boolean;
         /**
-          * does the step contain an error that needs to be resolved by the user
+          * When true, the component contains an error that requires resolution from the user.
          */
         "error"?: boolean;
         /**
-          * stepper item heading
+          * The component header text.
          */
         "heading"?: string;
         /**
-          * pass a title for the stepper item
-          * @deprecated use description instead
+          * A description for the component. Displays below the header text.
+          * @deprecated use "description" instead.
          */
         "itemSubtitle"?: string;
         /**
-          * pass a title for the stepper item
-          * @deprecated use heading instead
+          * The component header text.
+          * @deprecated use "heading" instead.
          */
         "itemTitle"?: string;
+        /**
+          * When true, step is selected
+         */
+        "selected"?: boolean;
     }
     interface CalciteSwitch {
         /**
-          * True if the switch is initially on
+          * When true, the component is checked.
          */
         "checked"?: boolean;
         /**
-          * True if the switch is disabled
+          * When true, interaction is prevented and the component is displayed with lower opacity.
          */
         "disabled"?: boolean;
         /**
-          * Applies to the aria-label attribute on the switch
+          * Accessible name for the component.
          */
         "label"?: string;
         /**
-          * The name of the switch input
+          * Specifies the name of the component on form submission.
          */
         "name"?: string;
         /**
-          * Fires when the checked value has changed.  **Note:** The event payload is deprecated, please use the `checked` property on the component instead
+          * Fires when the checked value has changed.  **Note:** The event payload is deprecated, use the component's "checked" property instead.
          */
         "onCalciteSwitchChange"?: (event: CalciteSwitchCustomEvent<DeprecatedEventPayload>) => void;
         /**
-          * The scale of the switch
+          * Specifies the size of the component.
          */
         "scale"?: Scale;
         /**
-          * True if the switch is initially on
-          * @deprecated use 'checked' instead.
+          * When true, the component is checked.
+          * @deprecated use "checked" instead.
          */
         "switched"?: boolean;
         /**
-          * The value of the switch input
+          * The component's value.
          */
         "value"?: any;
     }
     interface CalciteTab {
         /**
           * Show this tab
+          * @deprecated Use selected instead.
          */
         "active"?: boolean;
+        /**
+          * When true, display this tab.
+         */
+        "selected"?: boolean;
         /**
           * Optionally include a unique name for this tab, be sure to also set this name on the associated title.
          */
@@ -8127,6 +8404,7 @@ declare namespace LocalJSX {
     interface CalciteTabTitle {
         /**
           * Show this tab title as selected
+          * @deprecated Use selected instead.
          */
         "active"?: boolean;
         /**
@@ -8150,6 +8428,10 @@ declare namespace LocalJSX {
           * @see [TabChangeEventDetail](https://github.com/Esri/calcite-components/blob/master/src/components/tab/interfaces.ts#L1)
          */
         "onCalciteTabsActivate"?: (event: CalciteTabTitleCustomEvent<TabChangeEventDetail>) => void;
+        /**
+          * When true, display this tab title as selected.
+         */
+        "selected"?: boolean;
         /**
           * Optionally include a unique name for the tab title, be sure to also set this name on the associated tab.
          */
@@ -8443,7 +8725,7 @@ declare namespace LocalJSX {
          */
         "open"?: boolean;
         /**
-          * Describes the positioning type to use for the overlaid content. If the `referenceElement` is in a fixed container, use the "fixed" value.
+          * 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".
          */
         "overlayPositioning"?: OverlayPositioning;
         /**
@@ -8640,6 +8922,7 @@ declare namespace LocalJSX {
         "calcite-input-date-picker": CalciteInputDatePicker;
         "calcite-input-message": CalciteInputMessage;
         "calcite-input-number": CalciteInputNumber;
+        "calcite-input-text": CalciteInputText;
         "calcite-input-time-picker": CalciteInputTimePicker;
         "calcite-label": CalciteLabel;
         "calcite-link": CalciteLink;
@@ -8737,6 +9020,7 @@ declare module "@stencil/core" {
             "calcite-input-date-picker": LocalJSX.CalciteInputDatePicker & JSXBase.HTMLAttributes<HTMLCalciteInputDatePickerElement>;
             "calcite-input-message": LocalJSX.CalciteInputMessage & JSXBase.HTMLAttributes<HTMLCalciteInputMessageElement>;
             "calcite-input-number": LocalJSX.CalciteInputNumber & JSXBase.HTMLAttributes<HTMLCalciteInputNumberElement>;
+            "calcite-input-text": LocalJSX.CalciteInputText & JSXBase.HTMLAttributes<HTMLCalciteInputTextElement>;
             "calcite-input-time-picker": LocalJSX.CalciteInputTimePicker & JSXBase.HTMLAttributes<HTMLCalciteInputTimePickerElement>;
             "calcite-label": LocalJSX.CalciteLabel & JSXBase.HTMLAttributes<HTMLCalciteLabelElement>;
             "calcite-link": LocalJSX.CalciteLink & JSXBase.HTMLAttributes<HTMLCalciteLinkElement>;