@esri/calcite-components 1.0.0-beta.91 → 1.0.0-beta.92

package/dist/types/components.d.ts

@@ -1298,6 +1298,7 @@ export namespace Components {
     interface CalciteDropdownItem {
         /**
           * Indicates whether the item is active.
+          * @deprecated Use selected instead.
          */
         "active": boolean;
         /**
@@ -1324,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.
          */
@@ -3043,38 +3048,38 @@ export namespace Components {
     }
     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;
@@ -3083,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;
         /**
@@ -3197,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;
         /**
@@ -3221,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[];
     }
@@ -3265,31 +3270,31 @@ 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;
         /**
@@ -3297,76 +3302,77 @@ export namespace Components {
          */
         "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;
         /**
@@ -3374,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;
         /**
@@ -3431,12 +3441,12 @@ 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;
     }
@@ -6236,6 +6246,7 @@ declare namespace LocalJSX {
     interface CalciteDropdownItem {
         /**
           * Indicates whether the item is active.
+          * @deprecated Use selected instead.
          */
         "active"?: boolean;
         /**
@@ -6262,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
          */
@@ -7837,7 +7852,7 @@ declare namespace LocalJSX {
         /**
           * Fires when the component has changed.
          */
-        "onCalciteRadioButtonGroupChange"?: (event: CalciteRadioButtonGroupCustomEvent<void>) => void;
+        "onCalciteRadioButtonGroupChange"?: (event: CalciteRadioButtonGroupCustomEvent<any>) => void;
         /**
           * When true, the component must have a value on form submission.
          */
@@ -7958,154 +7973,154 @@ declare namespace LocalJSX {
     }
     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;
         /**
@@ -8113,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[];
     }
@@ -8194,35 +8209,35 @@ 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;
         /**
@@ -8230,59 +8245,60 @@ declare namespace LocalJSX {
          */
         "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;
         /**
@@ -8290,64 +8306,68 @@ 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;
     }