@esri/calcite-components 1.0.0-next.605 → 1.0.0-next.606

package/dist/types/components.d.ts

@@ -378,122 +378,122 @@ export namespace Components {
     }
     interface CalciteBlock {
         /**
-          * When true, this block will be collapsible.
+          * When `true`, the component is collapsible.
          */
         "collapsible": boolean;
         /**
-          * Block description
+          * A description for the component, which displays below the heading.
          */
         "description": string;
         /**
-          * When true, removes padding for the slotted content
+          * When `true`, removes padding for the slotted content.
           * @deprecated Use `--calcite-block-padding` CSS variable instead.
          */
         "disablePadding": boolean;
         /**
-          * When true, disabled prevents interaction. This state shows items with lower opacity/grayed.
+          * When `true`, interaction is prevented and the component is displayed with lower opacity.
          */
         "disabled": boolean;
         /**
-          * When true, displays a drag handle in the header.
+          * When `true`, displays a drag handle in the header.
          */
         "dragHandle": boolean;
         /**
-          * Block heading.
+          * The component header text.
          */
         "heading": string;
         /**
-          * Number at which section headings should start for this component.
+          * Specifies the number at which section headings should start.
          */
         "headingLevel": HeadingLevel;
         /**
-          * Aria-label for collapsing the toggle and tooltip used for the toggle when expanded.
+          * Accessible name for the component's collapse button.
           * @default "Collapse"
          */
         "intlCollapse"?: string;
         /**
-          * Aria-label for expanding the toggle and tooltip used for the toggle when collapsed.
+          * Accessible name for the component's expand button.
           * @default "Expand"
          */
         "intlExpand"?: string;
         /**
-          * string to override English loading text
+          * Accessible name when the component is loading.
           * @default "Loading"
          */
         "intlLoading"?: string;
         /**
-          * Text string used for the actions menu
+          * Accessible name for the component's options button.
           * @default "Options"
          */
         "intlOptions"?: string;
         /**
-          * When true, content is waiting to be loaded. This state shows a busy indicator.
+          * When `true`, a busy indicator is displayed.
          */
         "loading": boolean;
         /**
-          * When true, the block's content will be displayed.
+          * When `true`, expands the component and its contents.
          */
         "open": boolean;
         /**
-          * Block status. Updates or adds icon to show related icon and color.
+          * Displays a status-related indicator icon.
          */
         "status"?: Status;
         /**
-          * Block summary.
-          * @deprecated use description instead
+          * A description for the component, which displays below the heading.
+          * @deprecated use `description` instead
          */
         "summary": string;
     }
     interface CalciteBlockSection {
         /**
-          * Tooltip used for the toggle when expanded.
+          * Accessible name for the component's collapse button.
          */
         "intlCollapse"?: string;
         /**
-          * Tooltip used for the toggle when collapsed.
+          * Accessible name for the component's expand button.
          */
         "intlExpand"?: string;
         /**
-          * When true, the block's section content will be displayed.
+          * When `true`, expands the component and its contents.
          */
         "open": boolean;
         /**
-          * BlockSection status. Adds indicator to show valid or invalid status.
+          * Displays a status-related indicator icon.
          */
         "status"?: Status;
         /**
-          * Text displayed in the button.
+          * The component header text.
          */
         "text": string;
         /**
-          * This property determines the look of the section toggle. If the value is "switch", a toggle-switch will be displayed. If the value is "button", a clickable header is displayed.
+          * Specifies the component's toggle display -  `"button"` (selectable header), or  `"switch"` (toggle switch).
          */
         "toggleDisplay": BlockSectionToggleDisplay;
     }
     interface CalciteButton {
         /**
-          * optionally specify alignment of button elements.
+          * Specifies the alignment of the component's elements.
          */
         "alignment"?: ButtonAlignment;
         /**
-          * specify the appearance style of the button, defaults to solid.
+          * Specifies the appearance style of the component.
          */
         "appearance": ButtonAppearance;
         /**
-          * specify the color of the button, defaults to blue
+          * Specifies the color of the component.
          */
         "color": ButtonColor;
         /**
-          * is the button disabled
+          * When `true`, interaction is prevented and the component is displayed with lower opacity.
          */
         "disabled": boolean;
         /**
-          * The form ID to associate with the component
-          * @deprecated – this property is no longer needed if placed inside a form.
+          * The form ID to associate with the component.
+          * @deprecated – The property is no longer needed if the component is placed inside a form.
          */
         "form"?: string;
         /**
-          * optionally pass a href - used to determine if the component should render as a button or an anchor
+          * Specifies the URL of the linked resource, which can be set as an absolute or relative path.
          */
         "href"?: string;
         /**
@@ -501,7 +501,7 @@ export namespace Components {
          */
         "iconEnd"?: string;
         /**
-          * When true, the icon will be flipped when the element direction is right-to-left (`"rtl"`).
+          * When `true`, the icon will be flipped when the element direction is right-to-left (`"rtl"`).
          */
         "iconFlipRtl"?: FlipContext;
         /**
@@ -509,32 +509,33 @@ export namespace Components {
          */
         "iconStart"?: string;
         /**
-          * string to override English loading text
+          * Accessible name when the component is loading.
           * @default "Loading"
          */
         "intlLoading"?: string;
         /**
-          * Applies to the aria-label attribute on the button or hyperlink
+          * Accessible name for the component.
          */
         "label"?: string;
         /**
-          * optionally add a calcite-loader component to the button, disabling interaction.
+          * When `true`, a busy indicator is displayed and interaction is disabled.
          */
         "loading": boolean;
         /**
-          * The name attribute to apply to the button
+          * Specifies the name of the component on form submission.
          */
         "name"?: string;
         /**
-          * The rel attribute to apply to the hyperlink
+          * Defines the relationship between the `href` value and the current document.
+          * @mdn [rel](https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/rel)
          */
         "rel"?: string;
         /**
-          * optionally add a round style to the button
+          * When `true`, adds a round style to the component.
          */
         "round": boolean;
         /**
-          * specify the scale of the button, defaults to m
+          * Specifies the size of the component.
          */
         "scale": Scale;
         /**
@@ -542,63 +543,68 @@ export namespace Components {
          */
         "setFocus": () => Promise<void>;
         /**
-          * is the button a child of a calcite-split-button
+          * Specifies if the component is a child of a `calcite-split-button`.
          */
         "splitChild"?: "primary" | "secondary" | false;
         /**
-          * The target attribute to apply to the hyperlink
+          * Specifies where to open the linked document defined in the `href` property.
+          * @mdn [target](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/a#attr-target)
          */
         "target"?: string;
         /**
-          * The type attribute to apply to the button
+          * Specifies the default behavior of the button.
+          * @mdn [type](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/button#attr-type)
          */
         "type": string;
         /**
-          * specify the width of the button, defaults to auto
+          * Specifies the width of the component.
          */
         "width": Width;
     }
     interface CalciteCard {
         /**
-          * string to override English deselect text for checkbox when selectable is true
+          * When `selectable` is `true`, the accessible name for the component's checkbox for deselection.
           * @default "Deselect"
          */
         "intlDeselect": string;
         /**
-          * string to override English loading text
+          * Accessible name when the component is loading.
           * @default "Loading"
          */
         "intlLoading"?: string;
         /**
-          * string to override English select text for checkbox when selectable is true
+          * When `selectable` is `true`, the accessible name for the component's checkbox for selection.
           * @default "Select"
          */
         "intlSelect": string;
         /**
-          * When true, the cards content is waiting to be loaded. This state shows a busy indicator.
+          * When `true`, a busy indicator is displayed.
          */
         "loading": boolean;
         /**
-          * Indicates whether the card is selectable.
+          * When `true`, the component is selectable.
          */
         "selectable": boolean;
         /**
-          * Indicates whether the card is selected.
+          * When `true`, the component is selected.
          */
         "selected": boolean;
+        /**
+          * Sets the placement of the thumbnail defined in the `thumbnail` slot.
+         */
         "thumbnailPosition": LogicalFlowPosition;
     }
     interface CalciteCheckbox {
         /**
-          * The checked state of the checkbox.
+          * When `true`, the component is checked.
          */
         "checked": boolean;
         /**
-          * True if the checkbox is disabled
+          * When `true`, interaction is prevented and the component is displayed with lower opacity.
          */
         "disabled": boolean;
         /**
-          * The id attribute of the checkbox.  When omitted, a globally unique identifier is used.
+          * The `id` attribute of the component. When omitted, a globally unique identifier is used.
          */
         "guid": string;
         /**
@@ -606,23 +612,24 @@ export namespace Components {
          */
         "hovered": boolean;
         /**
-          * True if the checkbox is initially indeterminate, which is independent from its checked state https://css-tricks.com/indeterminate-checkboxes/
+          * When `true`, the component is initially indeterminate, which is independent from its `checked` value.  The state is visual only, and can look different across browsers.
+          * @mdn [indeterminate](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input/checkbox#indeterminate_state_checkboxes)
          */
         "indeterminate": boolean;
         /**
-          * The label of the checkbox input
+          * Accessible name for the component.
          */
         "label"?: string;
         /**
-          * The name of the checkbox input
+          * Specifies the name of the component on form submission.
          */
         "name": any;
         /**
-          * When true, the component must have a value in order for the form to submit.
+          * When `true`, the component must have a value in order for the form to submit.
          */
         "required": boolean;
         /**
-          * specify the scale of the checkbox, defaults to m
+          * Specifies the size of the component.
          */
         "scale": Scale;
         /**
@@ -630,35 +637,35 @@ export namespace Components {
          */
         "setFocus": () => Promise<void>;
         /**
-          * The value of the checkbox input
+          * The component's value.
          */
         "value": any;
     }
     interface CalciteChip {
         /**
-          * specify the appearance style of the button, defaults to solid.
+          * Specifies the appearance style of the component.
          */
         "appearance": Extract<"solid" | "clear", Appearance>;
         /**
-          * When true, show abutton user can click to dismiss the chip.
+          * When `true`, a close button is added to the component.
          */
         "closable": boolean;
         /**
-          * When true, hides the chip
+          * When `true`, hides the component.
          */
         "closed": boolean;
         /**
-          * specify the color of the button, defaults to blue
+          * Specifies the color for the component.
          */
         "color": ChipColor;
         /**
-          * Aria label for the "x" button
+          * Accessible name for the component's close button.
           * @default "Close"
          */
         "dismissLabel"?: string;
         /**
-          * Optionally show a button the user can click to dismiss the chip
-          * @deprecated use closable instead
+          * When `true`, a close button is added to the component.
+          * @deprecated use `closable` instead.
          */
         "dismissible": boolean;
         /**
@@ -666,11 +673,11 @@ export namespace Components {
          */
         "icon"?: string;
         /**
-          * When true, the icon will be flipped when the element direction is right-to-left (`"rtl"`).
+          * When `true`, the icon will be flipped when the element direction is right-to-left (`"rtl"`).
          */
         "iconFlipRtl": boolean;
         /**
-          * specify the scale of the chip, defaults to m
+          * Specifies the size of the component.
          */
         "scale": Scale;
         /**
@@ -678,17 +685,17 @@ export namespace Components {
          */
         "setFocus": () => Promise<void>;
         /**
-          * The assigned value for the chip
+          * The component's value.
          */
         "value": any;
     }
     interface CalciteColorPicker {
         /**
-          * When false, empty color (null) will be allowed as a value. Otherwise, a color value is always enforced by the component.  When true, clearing the input and blurring will restore the last valid color set. When false, it will set it to empty.
+          * When `false`, an empty color (`null`) will be allowed as a `value`. Otherwise, a color value is enforced on the component.  When `true`, a color value is enforced, and clearing the input or blurring will restore the last valid `value`. When `false`, an empty color (`null`) will be allowed as a `value`.
          */
         "allowEmpty": boolean;
         /**
-          * specify the appearance - solid (containing border), or minimal (no containing border)
+          * Specifies the appearance style of the component -  `"solid"` (containing border) or `"minimal"` (no containing border).
          */
         "appearance": ColorAppearance;
         /**
@@ -696,118 +703,118 @@ export namespace Components {
          */
         "color": InternalColor | null;
         /**
-          * When true, disabled prevents user interaction.
+          * When `true`, interaction is prevented and the component is displayed with lower opacity.
          */
         "disabled": boolean;
         /**
-          * The format of the value property.  When "auto", the format will be inferred from `value` when set.
+          * The format of `value`.  When `"auto"`, the format will be inferred from `value` when set.
           * @default "auto"
          */
         "format": Format;
         /**
-          * When true, hides the RGB/HSV channel inputs
+          * When `true`, hides the RGB/HSV channel inputs.
          */
         "hideChannels": boolean;
         /**
-          * When true, hides the hex input
+          * When `true`, hides the Hex input.
          */
         "hideHex": boolean;
         /**
-          * When true, hides the saved colors section
+          * When `true`, hides the saved colors section.
          */
         "hideSaved": boolean;
         /**
-          * Label used for the blue channel
+          * Accessible name for the RGB section's blue channel.
           * @default "B"
          */
         "intlB": string;
         /**
-          * Label used for the blue channel description
+          * Accessible name for the RGB section's blue channel description.
           * @default "Blue"
          */
         "intlBlue": string;
         /**
-          * Label used for the delete color button.
+          * Accessible name for the delete color button.
           * @default "Delete color"
          */
         "intlDeleteColor": string;
         /**
-          * Label used for the green channel
+          * Accessible name for the RGB section's green channel.
           * @default "G"
          */
         "intlG": string;
         /**
-          * Label used for the green channel description
+          * Accessible name for the RGB section's green channel description.
           * @default "Green"
          */
         "intlGreen": string;
         /**
-          * Label used for the hue channel
+          * Accessible name for the HSV section's hue channel.
           * @default "H"
          */
         "intlH": string;
         /**
-          * Label used for the hex input
+          * Accessible name for the Hex input.
           * @default "Hex"
          */
         "intlHex": string;
         /**
-          * Label used for the HSV mode
+          * Accessible name for the HSV mode.
           * @default "HSV"
          */
         "intlHsv": string;
         /**
-          * Label used for the hue channel description
+          * Accessible name for the HSV section's hue channel description.
           * @default "Hue"
          */
         "intlHue": string;
         /**
-          * Label used for the hex input when there is no color selected.
+          * Accessible name for the Hex input when there is no color selected.
           * @default "No color"
          */
         "intlNoColor": string;
         /**
-          * Label used for the red channel
+          * Accessible name for the RGB section's red channel.
           * @default "R"
          */
         "intlR": string;
         /**
-          * Label used for the red channel description
+          * Accessible name for the RGB section's red channel description.
           * @default "Red"
          */
         "intlRed": string;
         /**
-          * Label used for the RGB mode
+          * Accessible name for the RGB mode.
           * @default "RGB"
          */
         "intlRgb": string;
         /**
-          * Label used for the saturation channel
+          * Accessible name for the HSV section's saturation channel.
           * @default "S"
          */
         "intlS": string;
         /**
-          * Label used for the saturation channel description
+          * Accessible name for the HSV section's saturation channel description.
           * @default "Saturation"
          */
         "intlSaturation": string;
         /**
-          * Label used for the save color button.
+          * Accessible name for the save color button.
           * @default "Save color"
          */
         "intlSaveColor": string;
         /**
-          * Label used for the saved colors section
+          * Accessible name for the saved colors section.
           * @default "Saved"
          */
         "intlSaved": string;
         /**
-          * Label used for the value channel
+          * Accessible name for the HSV section's value channel.
           * @default "V"
          */
         "intlV": string;
         /**
-          * Label used for the
+          * Accessible name for the HSV section's value channel description.
           * @default "Value"
          */
         "intlValue": string;
@@ -816,7 +823,7 @@ export namespace Components {
          */
         "numberingSystem"?: NumberingSystem;
         /**
-          * The scale of the color picker.
+          * Specifies the size of the component.
          */
         "scale": Scale;
         /**
@@ -824,11 +831,11 @@ export namespace Components {
          */
         "setFocus": () => Promise<void>;
         /**
-          * Storage ID for colors.
+          * Specifies the storage ID for colors.
          */
         "storageId": string;
         /**
-          * The component's value.  This value can be either a CSS color string, a RGB, HSL or HSV object.  The type will be preserved as the color is updated.
+          * The component's value, where the value can be a CSS color string, or a RGB, HSL or HSV object.  The type will be preserved as the color is updated.
           * @default "#007ac2"
           * @see [CSS Color](https://developer.mozilla.org/en-US/docs/Web/CSS/color)
           * @see [ColorValue](https://github.com/Esri/calcite-components/blob/master/src/components/color-picker/interfaces.ts#L10)
@@ -837,16 +844,16 @@ export namespace Components {
     }
     interface CalciteColorPickerHexInput {
         /**
-          * When false, empty color (null) will be allowed as a value. Otherwise, a color value is always enforced by the component.  When true, clearing the input and blurring will restore the last valid color set. When false, it will set it to empty.
+          * When `false`, an empty color (`null`) will be allowed as a `value`. Otherwise, a color value is enforced on the component.  When `true`, a color value is enforced, and clearing the input or blurring will restore the last valid `value`. When `false`, an empty color (`null`) will be allowed as a `value`.
          */
         "allowEmpty": boolean;
         /**
-          * Label used for the hex input.
+          * Accessible name for the Hex input.
           * @default "Hex"
          */
         "intlHex": string;
         /**
-          * Label used for the hex input when there is no color selected.
+          * Accessible name for the Hex input when there is no color selected.
           * @default "No color"
          */
         "intlNoColor": string;
@@ -855,7 +862,7 @@ export namespace Components {
          */
         "numberingSystem"?: NumberingSystem;
         /**
-          * The component's scale.
+          * Specifies the size of the component.
          */
         "scale": Scale;
         /**
@@ -863,13 +870,13 @@ export namespace Components {
          */
         "setFocus": () => Promise<void>;
         /**
-          * The hex value.
+          * The Hex value.
          */
         "value": string;
     }
     interface CalciteColorPickerSwatch {
         /**
-          * Used to display whether the swatch is active or not.
+          * When `true`, the component is active.
          */
         "active": boolean;
         /**
@@ -878,22 +885,22 @@ export namespace Components {
          */
         "color": string;
         /**
-          * The component scale.
+          * Specifies the size of the component.
          */
         "scale": Scale;
     }
     interface CalciteCombobox {
         /**
-          * When true, opens the combobox
-          * @deprecated use open instead
+          * When `true`, displays and positions the component.
+          * @deprecated use `open` instead.
          */
         "active": boolean;
         /**
-          * Allow entry of custom values which are not in the original set of items
+          * When `true`, allows entry of custom values, which are not in the original set of items.
          */
         "allowCustomValues": boolean;
         /**
-          * Disable combobox input
+          * When `true`, interaction is prevented and the component is displayed with lower opacity.
          */
         "disabled": boolean;
         /**
@@ -901,24 +908,24 @@ export namespace Components {
          */
         "flipPlacements"?: EffectivePlacement[];
         /**
-          * string to override the English "Remove tag" text for when an item is selected.
+          * Accessible name for the component's remove tag when a `calcite-combobox-item` is selected.
           * @default "Remove tag"
          */
         "intlRemoveTag": string;
         /**
-          * Aria label for combobox (required)
+          * Accessible name for the component.
          */
         "label": string;
         /**
-          * Specify the maximum number of combobox items (including nested children) to display before showing the scroller
+          * Specifies the maximum number of `calcite-combobox-item`s (including nested children) to display before displaying a scrollbar.
          */
         "maxItems": number;
         /**
-          * The name of the switch input
+          * Specifies the name of the component on form submission.
          */
         "name": string;
         /**
-          * When true, opens the combobox
+          * When `true`, displays and positions the component.
          */
         "open": boolean;
         /**
@@ -926,11 +933,11 @@ export namespace Components {
          */
         "overlayPositioning": OverlayPositioning;
         /**
-          * Placeholder text for input
+          * Specifies the placeholder text for the input.
          */
         "placeholder"?: string;
         /**
-          * Placeholder icon for input
+          * Specifies the placeholder icon for the input.
          */
         "placeholderIcon"?: string;
         /**
@@ -938,15 +945,15 @@ export namespace Components {
          */
         "reposition": () => Promise<void>;
         /**
-          * When true, the component must have a value in order for the form to submit.
+          * When `true`, the component must have a value in order for the form to submit.
          */
         "required": boolean;
         /**
-          * Specify the scale of the combobox, defaults to m
+          * Specifies the size of the component.
          */
         "scale": Scale;
         /**
-          * specify the selection mode - multi: allow any number of selected items (default) - single: only one selection) - ancestors: like multi, but show ancestors of selected items as selected, only deepest children shown in chips
+          * Specifies the selection mode - `"multi"` (allow any number of selected items), `"single"` (allow only one selection), or `"ancestors"` (like `"multi"`, but show ancestors of selected items as selected. Only the deepest children are shown in `calcite-chip`s).
          */
         "selectionMode": ComboboxSelectionMode;
         /**
@@ -954,46 +961,46 @@ export namespace Components {
          */
         "setFocus": () => Promise<void>;
         /**
-          * The value(s) of the selectedItem(s)
+          * The component's value(s) from the selected `calcite-combobox-item`(s).
          */
         "value": string | string[];
     }
     interface CalciteComboboxItem {
         /**
-          * True when item is highlighted either from keyboard or mouse hover
+          * When `true`, the component is active.
          */
         "active": boolean;
         /**
-          * Parent and grandparent combobox items, this is set internally for use from combobox
+          * Specifies the parent and grandparent items, which are set on `calcite-combobox`.
          */
         "ancestors": ComboboxChildElement[];
         /**
-          * Don't filter this item based on the search text
-          * @deprecated use filterDisabled instead
+          * When `true`, omits the component from the `calcite-combobox` filtered search results.
+          * @deprecated use `filterDisabled` instead.
          */
         "constant": boolean;
         /**
-          * When true, the item cannot be clicked and is visually muted.
+          * When `true`, interaction is prevented and the component is displayed with lower opacity.
          */
         "disabled": boolean;
         /**
-          * Do not filter this item based on the search text
+          * When `true`, omits the component from the `calcite-combobox` filtered search results.
          */
         "filterDisabled": boolean;
         /**
-          * Unique identifier, used for accessibility
+          * The `id` attribute of the component. When omitted, a globally unique identifier is used.
          */
         "guid": string;
         /**
-          * Custom icon to display both in combobox chips and next to combobox item text
+          * Specifies an icon to display.
          */
         "icon"?: string;
         /**
-          * Set this to true to pre-select an item. Toggles when an item is checked/unchecked.
+          * When `true`, the component is selected.
          */
         "selected": boolean;
         /**
-          * The main label for this item.
+          * The component's text.
          */
         "textLabel": string;
         /**
@@ -1002,17 +1009,17 @@ export namespace Components {
          */
         "toggleSelected": (coerce?: boolean) => Promise<void>;
         /**
-          * The item's associated value
+          * The component's value.
          */
         "value": any;
     }
     interface CalciteComboboxItemGroup {
         /**
-          * Parent and grandparent combobox items, this is set internally for use from combobox
+          * Specifies the parent and grandparent `calcite-combobox-item`s, which are set on `calcite-combobox`.
          */
         "ancestors": ComboboxChildElement[];
         /**
-          * Title of the group
+          * Specifies the title of the component.
          */
         "label": string;
     }
@@ -1779,12 +1786,12 @@ export namespace Components {
     }
     interface CalciteInputDatePicker {
         /**
-          * When true, the component is active.
+          * When `true`, the component is active.
           * @deprecated use `open` instead.
          */
         "active": boolean;
         /**
-          * When true, interaction is prevented and the component is displayed with lower opacity.
+          * When `true`, interaction is prevented and the component is displayed with lower opacity.
          */
         "disabled": boolean;
         /**
@@ -1855,7 +1862,7 @@ export namespace Components {
          */
         "numberingSystem"?: NumberingSystem;
         /**
-          * When true, displays the `calcite-date-picker` component.
+          * When `true`, displays the `calcite-date-picker` component.
          */
         "open": boolean;
         /**
@@ -1868,15 +1875,15 @@ export namespace Components {
          */
         "placement": MenuPlacement;
         /**
-          * When true, disables the default behavior on the third click of narrowing or extending the range. Instead starts a new range.
+          * When `true`, disables the default behavior on the third click of narrowing or extending the range. Instead starts a new range.
          */
         "proximitySelectionDisabled": boolean;
         /**
-          * When true, activates a range for the component.
+          * When `true`, activates a range for the component.
          */
         "range": boolean;
         /**
-          * When true, the component's value can be read, but controls are not accessible and the value cannot be modified.
+          * When `true`, the component's value can be read, but controls are not accessible and the value cannot be modified.
           * @mdn [readOnly](https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/readonly)
          */
         "readOnly": boolean;
@@ -1885,7 +1892,7 @@ export namespace Components {
          */
         "reposition": () => Promise<void>;
         /**
-          * When true, the component must have a value in order for the form to submit.
+          * When `true`, the component must have a value in order for the form to submit.
          */
         "required": boolean;
         /**
@@ -2286,7 +2293,7 @@ export namespace Components {
          */
         "reposition": () => Promise<void>;
         /**
-          * When true, the component must have a value in order for the form to submit.
+          * When `true`, the component must have a value in order for the form to submit.
          */
         "required": boolean;
         /**
@@ -2848,7 +2855,7 @@ export namespace Components {
     }
     interface CalcitePopover {
         /**
-          * When true and clicking outside of the component, automatically closes open `calcite-popover`s.
+          * When `true`, clicking outside of the component automatically closes open `calcite-popover`s.
          */
         "autoClose": boolean;
         /**
@@ -3909,7 +3916,7 @@ export namespace Components {
          */
         "nonDismissible": boolean;
         /**
-          * When true and if it has a parent `calcite-tip-manager`, the component is selected.  Only one tip can be selected within the `calcite-tip-manager` parent.
+          * When `true`, the component is selected if it has a parent `calcite-tip-manager`.  Only one tip can be selected within the `calcite-tip-manager` parent.
          */
         "selected": boolean;
     }
@@ -5430,130 +5437,130 @@ declare namespace LocalJSX {
     }
     interface CalciteBlock {
         /**
-          * When true, this block will be collapsible.
+          * When `true`, the component is collapsible.
          */
         "collapsible"?: boolean;
         /**
-          * Block description
+          * A description for the component, which displays below the heading.
          */
         "description"?: string;
         /**
-          * When true, removes padding for the slotted content
+          * When `true`, removes padding for the slotted content.
           * @deprecated Use `--calcite-block-padding` CSS variable instead.
          */
         "disablePadding"?: boolean;
         /**
-          * When true, disabled prevents interaction. This state shows items with lower opacity/grayed.
+          * When `true`, interaction is prevented and the component is displayed with lower opacity.
          */
         "disabled"?: boolean;
         /**
-          * When true, displays a drag handle in the header.
+          * When `true`, displays a drag handle in the header.
          */
         "dragHandle"?: boolean;
         /**
-          * Block heading.
+          * The component header text.
          */
         "heading": string;
         /**
-          * Number at which section headings should start for this component.
+          * Specifies the number at which section headings should start.
          */
         "headingLevel"?: HeadingLevel;
         /**
-          * Aria-label for collapsing the toggle and tooltip used for the toggle when expanded.
+          * Accessible name for the component's collapse button.
           * @default "Collapse"
          */
         "intlCollapse"?: string;
         /**
-          * Aria-label for expanding the toggle and tooltip used for the toggle when collapsed.
+          * Accessible name for the component's expand button.
           * @default "Expand"
          */
         "intlExpand"?: string;
         /**
-          * string to override English loading text
+          * Accessible name when the component is loading.
           * @default "Loading"
          */
         "intlLoading"?: string;
         /**
-          * Text string used for the actions menu
+          * Accessible name for the component's options button.
           * @default "Options"
          */
         "intlOptions"?: string;
         /**
-          * When true, content is waiting to be loaded. This state shows a busy indicator.
+          * When `true`, a busy indicator is displayed.
          */
         "loading"?: boolean;
         /**
-          * Emitted when the header has been clicked.
+          * Emits when the component's header is clicked.
          */
         "onCalciteBlockToggle"?: (event: CalciteBlockCustomEvent<void>) => void;
         /**
-          * When true, the block's content will be displayed.
+          * When `true`, expands the component and its contents.
          */
         "open"?: boolean;
         /**
-          * Block status. Updates or adds icon to show related icon and color.
+          * Displays a status-related indicator icon.
          */
         "status"?: Status;
         /**
-          * Block summary.
-          * @deprecated use description instead
+          * A description for the component, which displays below the heading.
+          * @deprecated use `description` instead
          */
         "summary"?: string;
     }
     interface CalciteBlockSection {
         /**
-          * Tooltip used for the toggle when expanded.
+          * Accessible name for the component's collapse button.
          */
         "intlCollapse"?: string;
         /**
-          * Tooltip used for the toggle when collapsed.
+          * Accessible name for the component's expand button.
          */
         "intlExpand"?: string;
         /**
-          * Emitted when the header has been clicked.
+          * Emits when the header has been clicked.
          */
         "onCalciteBlockSectionToggle"?: (event: CalciteBlockSectionCustomEvent<void>) => void;
         /**
-          * When true, the block's section content will be displayed.
+          * When `true`, expands the component and its contents.
          */
         "open"?: boolean;
         /**
-          * BlockSection status. Adds indicator to show valid or invalid status.
+          * Displays a status-related indicator icon.
          */
         "status"?: Status;
         /**
-          * Text displayed in the button.
+          * The component header text.
          */
         "text"?: string;
         /**
-          * This property determines the look of the section toggle. If the value is "switch", a toggle-switch will be displayed. If the value is "button", a clickable header is displayed.
+          * Specifies the component's toggle display -  `"button"` (selectable header), or  `"switch"` (toggle switch).
          */
         "toggleDisplay"?: BlockSectionToggleDisplay;
     }
     interface CalciteButton {
         /**
-          * optionally specify alignment of button elements.
+          * Specifies the alignment of the component's elements.
          */
         "alignment"?: ButtonAlignment;
         /**
-          * specify the appearance style of the button, defaults to solid.
+          * Specifies the appearance style of the component.
          */
         "appearance"?: ButtonAppearance;
         /**
-          * specify the color of the button, defaults to blue
+          * Specifies the color of the component.
          */
         "color"?: ButtonColor;
         /**
-          * is the button disabled
+          * When `true`, interaction is prevented and the component is displayed with lower opacity.
          */
         "disabled"?: boolean;
         /**
-          * The form ID to associate with the component
-          * @deprecated – this property is no longer needed if placed inside a form.
+          * The form ID to associate with the component.
+          * @deprecated – The property is no longer needed if the component is placed inside a form.
          */
         "form"?: string;
         /**
-          * optionally pass a href - used to determine if the component should render as a button or an anchor
+          * Specifies the URL of the linked resource, which can be set as an absolute or relative path.
          */
         "href"?: string;
         /**
@@ -5561,7 +5568,7 @@ declare namespace LocalJSX {
          */
         "iconEnd"?: string;
         /**
-          * When true, the icon will be flipped when the element direction is right-to-left (`"rtl"`).
+          * When `true`, the icon will be flipped when the element direction is right-to-left (`"rtl"`).
          */
         "iconFlipRtl"?: FlipContext;
         /**
@@ -5569,144 +5576,151 @@ declare namespace LocalJSX {
          */
         "iconStart"?: string;
         /**
-          * string to override English loading text
+          * Accessible name when the component is loading.
           * @default "Loading"
          */
         "intlLoading"?: string;
         /**
-          * Applies to the aria-label attribute on the button or hyperlink
+          * Accessible name for the component.
          */
         "label"?: string;
         /**
-          * optionally add a calcite-loader component to the button, disabling interaction.
+          * When `true`, a busy indicator is displayed and interaction is disabled.
          */
         "loading"?: boolean;
         /**
-          * The name attribute to apply to the button
+          * Specifies the name of the component on form submission.
          */
         "name"?: string;
         /**
-          * The rel attribute to apply to the hyperlink
+          * Defines the relationship between the `href` value and the current document.
+          * @mdn [rel](https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/rel)
          */
         "rel"?: string;
         /**
-          * optionally add a round style to the button
+          * When `true`, adds a round style to the component.
          */
         "round"?: boolean;
         /**
-          * specify the scale of the button, defaults to m
+          * Specifies the size of the component.
          */
         "scale"?: Scale;
         /**
-          * is the button a child of a calcite-split-button
+          * Specifies if the component is a child of a `calcite-split-button`.
          */
         "splitChild"?: "primary" | "secondary" | false;
         /**
-          * The target attribute to apply to the hyperlink
+          * Specifies where to open the linked document defined in the `href` property.
+          * @mdn [target](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/a#attr-target)
          */
         "target"?: string;
         /**
-          * The type attribute to apply to the button
+          * Specifies the default behavior of the button.
+          * @mdn [type](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/button#attr-type)
          */
         "type"?: string;
         /**
-          * specify the width of the button, defaults to auto
+          * Specifies the width of the component.
          */
         "width"?: Width;
     }
     interface CalciteCard {
         /**
-          * string to override English deselect text for checkbox when selectable is true
+          * When `selectable` is `true`, the accessible name for the component's checkbox for deselection.
           * @default "Deselect"
          */
         "intlDeselect"?: string;
         /**
-          * string to override English loading text
+          * Accessible name when the component is loading.
           * @default "Loading"
          */
         "intlLoading"?: string;
         /**
-          * string to override English select text for checkbox when selectable is true
+          * When `selectable` is `true`, the accessible name for the component's checkbox for selection.
           * @default "Select"
          */
         "intlSelect"?: string;
         /**
-          * When true, the cards content is waiting to be loaded. This state shows a busy indicator.
+          * When `true`, a busy indicator is displayed.
          */
         "loading"?: boolean;
         /**
-          * Fired when a selectable card is selected
+          * Fires when `selectable` is `true` and the component is selected.
          */
         "onCalciteCardSelect"?: (event: CalciteCardCustomEvent<void>) => void;
         /**
-          * Indicates whether the card is selectable.
+          * When `true`, the component is selectable.
          */
         "selectable"?: boolean;
         /**
-          * Indicates whether the card is selected.
+          * When `true`, the component is selected.
          */
         "selected"?: boolean;
+        /**
+          * Sets the placement of the thumbnail defined in the `thumbnail` slot.
+         */
         "thumbnailPosition"?: LogicalFlowPosition;
     }
     interface CalciteCheckbox {
         /**
-          * The checked state of the checkbox.
+          * When `true`, the component is checked.
          */
         "checked"?: boolean;
         /**
-          * True if the checkbox is disabled
+          * When `true`, interaction is prevented and the component is displayed with lower opacity.
          */
         "disabled"?: boolean;
         /**
-          * The id attribute of the checkbox.  When omitted, a globally unique identifier is used.
+          * The `id` attribute of the component. When omitted, a globally unique identifier is used.
          */
         "guid"?: string;
         /**
-          * True if the checkbox is initially indeterminate, which is independent from its checked state https://css-tricks.com/indeterminate-checkboxes/
+          * When `true`, the component is initially indeterminate, which is independent from its `checked` value.  The state is visual only, and can look different across browsers.
+          * @mdn [indeterminate](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input/checkbox#indeterminate_state_checkboxes)
          */
         "indeterminate"?: boolean;
         /**
-          * The name of the checkbox input
+          * Specifies the name of the component on form submission.
          */
         "name"?: any;
         /**
-          * Emitted when the checkbox checked status changes
+          * Emits when the component's `checked` status changes.
          */
         "onCalciteCheckboxChange"?: (event: CalciteCheckboxCustomEvent<void>) => void;
         /**
-          * specify the scale of the checkbox, defaults to m
+          * Specifies the size of the component.
          */
         "scale"?: Scale;
         /**
-          * The value of the checkbox input
+          * The component's value.
          */
         "value"?: any;
     }
     interface CalciteChip {
         /**
-          * specify the appearance style of the button, defaults to solid.
+          * Specifies the appearance style of the component.
          */
         "appearance"?: Extract<"solid" | "clear", Appearance>;
         /**
-          * When true, show abutton user can click to dismiss the chip.
+          * When `true`, a close button is added to the component.
          */
         "closable"?: boolean;
         /**
-          * When true, hides the chip
+          * When `true`, hides the component.
          */
         "closed"?: boolean;
         /**
-          * specify the color of the button, defaults to blue
+          * Specifies the color for the component.
          */
         "color"?: ChipColor;
         /**
-          * Aria label for the "x" button
+          * Accessible name for the component's close button.
           * @default "Close"
          */
         "dismissLabel"?: string;
         /**
-          * Optionally show a button the user can click to dismiss the chip
-          * @deprecated use closable instead
+          * When `true`, a close button is added to the component.
+          * @deprecated use `closable` instead.
          */
         "dismissible"?: boolean;
         /**
@@ -5714,144 +5728,144 @@ declare namespace LocalJSX {
          */
         "icon"?: string;
         /**
-          * When true, the icon will be flipped when the element direction is right-to-left (`"rtl"`).
+          * When `true`, the icon will be flipped when the element direction is right-to-left (`"rtl"`).
          */
         "iconFlipRtl"?: boolean;
         /**
-          * Emitted when the dismiss button is clicked  **Note:**: The `el` event payload props is deprecated, please use the event's `target`/`currentTarget` instead
+          * Fires when the dismiss button is clicked.  **Note:**: The `el` event payload props is deprecated, please use the event's `target`/`currentTarget` instead.
          */
         "onCalciteChipDismiss"?: (event: CalciteChipCustomEvent<DeprecatedEventPayload>) => void;
         /**
-          * specify the scale of the chip, defaults to m
+          * Specifies the size of the component.
          */
         "scale"?: Scale;
         /**
-          * The assigned value for the chip
+          * The component's value.
          */
         "value": any;
     }
     interface CalciteColorPicker {
         /**
-          * When false, empty color (null) will be allowed as a value. Otherwise, a color value is always enforced by the component.  When true, clearing the input and blurring will restore the last valid color set. When false, it will set it to empty.
+          * When `false`, an empty color (`null`) will be allowed as a `value`. Otherwise, a color value is enforced on the component.  When `true`, a color value is enforced, and clearing the input or blurring will restore the last valid `value`. When `false`, an empty color (`null`) will be allowed as a `value`.
          */
         "allowEmpty"?: boolean;
         /**
-          * specify the appearance - solid (containing border), or minimal (no containing border)
+          * Specifies the appearance style of the component -  `"solid"` (containing border) or `"minimal"` (no containing border).
          */
         "appearance"?: ColorAppearance;
         /**
-          * When true, disabled prevents user interaction.
+          * When `true`, interaction is prevented and the component is displayed with lower opacity.
          */
         "disabled"?: boolean;
         /**
-          * The format of the value property.  When "auto", the format will be inferred from `value` when set.
+          * The format of `value`.  When `"auto"`, the format will be inferred from `value` when set.
           * @default "auto"
          */
         "format"?: Format;
         /**
-          * When true, hides the RGB/HSV channel inputs
+          * When `true`, hides the RGB/HSV channel inputs.
          */
         "hideChannels"?: boolean;
         /**
-          * When true, hides the hex input
+          * When `true`, hides the Hex input.
          */
         "hideHex"?: boolean;
         /**
-          * When true, hides the saved colors section
+          * When `true`, hides the saved colors section.
          */
         "hideSaved"?: boolean;
         /**
-          * Label used for the blue channel
+          * Accessible name for the RGB section's blue channel.
           * @default "B"
          */
         "intlB"?: string;
         /**
-          * Label used for the blue channel description
+          * Accessible name for the RGB section's blue channel description.
           * @default "Blue"
          */
         "intlBlue"?: string;
         /**
-          * Label used for the delete color button.
+          * Accessible name for the delete color button.
           * @default "Delete color"
          */
         "intlDeleteColor"?: string;
         /**
-          * Label used for the green channel
+          * Accessible name for the RGB section's green channel.
           * @default "G"
          */
         "intlG"?: string;
         /**
-          * Label used for the green channel description
+          * Accessible name for the RGB section's green channel description.
           * @default "Green"
          */
         "intlGreen"?: string;
         /**
-          * Label used for the hue channel
+          * Accessible name for the HSV section's hue channel.
           * @default "H"
          */
         "intlH"?: string;
         /**
-          * Label used for the hex input
+          * Accessible name for the Hex input.
           * @default "Hex"
          */
         "intlHex"?: string;
         /**
-          * Label used for the HSV mode
+          * Accessible name for the HSV mode.
           * @default "HSV"
          */
         "intlHsv"?: string;
         /**
-          * Label used for the hue channel description
+          * Accessible name for the HSV section's hue channel description.
           * @default "Hue"
          */
         "intlHue"?: string;
         /**
-          * Label used for the hex input when there is no color selected.
+          * Accessible name for the Hex input when there is no color selected.
           * @default "No color"
          */
         "intlNoColor"?: string;
         /**
-          * Label used for the red channel
+          * Accessible name for the RGB section's red channel.
           * @default "R"
          */
         "intlR"?: string;
         /**
-          * Label used for the red channel description
+          * Accessible name for the RGB section's red channel description.
           * @default "Red"
          */
         "intlRed"?: string;
         /**
-          * Label used for the RGB mode
+          * Accessible name for the RGB mode.
           * @default "RGB"
          */
         "intlRgb"?: string;
         /**
-          * Label used for the saturation channel
+          * Accessible name for the HSV section's saturation channel.
           * @default "S"
          */
         "intlS"?: string;
         /**
-          * Label used for the saturation channel description
+          * Accessible name for the HSV section's saturation channel description.
           * @default "Saturation"
          */
         "intlSaturation"?: string;
         /**
-          * Label used for the save color button.
+          * Accessible name for the save color button.
           * @default "Save color"
          */
         "intlSaveColor"?: string;
         /**
-          * Label used for the saved colors section
+          * Accessible name for the saved colors section.
           * @default "Saved"
          */
         "intlSaved"?: string;
         /**
-          * Label used for the value channel
+          * Accessible name for the HSV section's value channel.
           * @default "V"
          */
         "intlV"?: string;
         /**
-          * Label used for the
+          * Accessible name for the HSV section's value channel description.
           * @default "Value"
          */
         "intlValue"?: string;
@@ -5864,19 +5878,19 @@ declare namespace LocalJSX {
          */
         "onCalciteColorPickerChange"?: (event: CalciteColorPickerCustomEvent<void>) => void;
         /**
-          * Fires as the color value changes.  This is similar to the change event with the exception of dragging. When dragging the color field or hue slider thumb, this event fires as the thumb is moved.
+          * Fires as the color value changes.  Similar to the `calciteColorPickerChange` event with the exception of dragging. When dragging the color field or hue slider thumb, this event fires as the thumb is moved.
          */
         "onCalciteColorPickerInput"?: (event: CalciteColorPickerCustomEvent<void>) => void;
         /**
-          * The scale of the color picker.
+          * Specifies the size of the component.
          */
         "scale"?: Scale;
         /**
-          * Storage ID for colors.
+          * Specifies the storage ID for colors.
          */
         "storageId"?: string;
         /**
-          * The component's value.  This value can be either a CSS color string, a RGB, HSL or HSV object.  The type will be preserved as the color is updated.
+          * The component's value, where the value can be a CSS color string, or a RGB, HSL or HSV object.  The type will be preserved as the color is updated.
           * @default "#007ac2"
           * @see [CSS Color](https://developer.mozilla.org/en-US/docs/Web/CSS/color)
           * @see [ColorValue](https://github.com/Esri/calcite-components/blob/master/src/components/color-picker/interfaces.ts#L10)
@@ -5885,16 +5899,16 @@ declare namespace LocalJSX {
     }
     interface CalciteColorPickerHexInput {
         /**
-          * When false, empty color (null) will be allowed as a value. Otherwise, a color value is always enforced by the component.  When true, clearing the input and blurring will restore the last valid color set. When false, it will set it to empty.
+          * When `false`, an empty color (`null`) will be allowed as a `value`. Otherwise, a color value is enforced on the component.  When `true`, a color value is enforced, and clearing the input or blurring will restore the last valid `value`. When `false`, an empty color (`null`) will be allowed as a `value`.
          */
         "allowEmpty"?: boolean;
         /**
-          * Label used for the hex input.
+          * Accessible name for the Hex input.
           * @default "Hex"
          */
         "intlHex"?: string;
         /**
-          * Label used for the hex input when there is no color selected.
+          * Accessible name for the Hex input when there is no color selected.
           * @default "No color"
          */
         "intlNoColor"?: string;
@@ -5907,17 +5921,17 @@ declare namespace LocalJSX {
          */
         "onCalciteColorPickerHexInputChange"?: (event: CalciteColorPickerHexInputCustomEvent<void>) => void;
         /**
-          * The component's scale.
+          * Specifies the size of the component.
          */
         "scale"?: Scale;
         /**
-          * The hex value.
+          * The Hex value.
          */
         "value"?: string;
     }
     interface CalciteColorPickerSwatch {
         /**
-          * Used to display whether the swatch is active or not.
+          * When `true`, the component is active.
          */
         "active"?: boolean;
         /**
@@ -5926,22 +5940,22 @@ declare namespace LocalJSX {
          */
         "color"?: string;
         /**
-          * The component scale.
+          * Specifies the size of the component.
          */
         "scale"?: Scale;
     }
     interface CalciteCombobox {
         /**
-          * When true, opens the combobox
-          * @deprecated use open instead
+          * When `true`, displays and positions the component.
+          * @deprecated use `open` instead.
          */
         "active"?: boolean;
         /**
-          * Allow entry of custom values which are not in the original set of items
+          * When `true`, allows entry of custom values, which are not in the original set of items.
          */
         "allowCustomValues"?: boolean;
         /**
-          * Disable combobox input
+          * When `true`, interaction is prevented and the component is displayed with lower opacity.
          */
         "disabled"?: boolean;
         /**
@@ -5949,24 +5963,24 @@ declare namespace LocalJSX {
          */
         "flipPlacements"?: EffectivePlacement[];
         /**
-          * string to override the English "Remove tag" text for when an item is selected.
+          * Accessible name for the component's remove tag when a `calcite-combobox-item` is selected.
           * @default "Remove tag"
          */
         "intlRemoveTag"?: string;
         /**
-          * Aria label for combobox (required)
+          * Accessible name for the component.
          */
         "label": string;
         /**
-          * Specify the maximum number of combobox items (including nested children) to display before showing the scroller
+          * Specifies the maximum number of `calcite-combobox-item`s (including nested children) to display before displaying a scrollbar.
          */
         "maxItems"?: number;
         /**
-          * The name of the switch input
+          * Specifies the name of the component on form submission.
          */
         "name"?: string;
         /**
-          * Fires when the component is requested to be closed and before the closing transition begins.
+          * Fires when the component is requested to be closed, and before the closing transition begins.
          */
         "onCalciteComboboxBeforeClose"?: (event: CalciteComboboxCustomEvent<void>) => void;
         /**
@@ -5974,13 +5988,13 @@ declare namespace LocalJSX {
          */
         "onCalciteComboboxBeforeOpen"?: (event: CalciteComboboxCustomEvent<void>) => void;
         /**
-          * Called when the selected item(s) changes.
+          * Fires when the selected item(s) changes.
          */
         "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
+          * Fires when a selected item in the component is dismissed via its `calcite-chip`.  **Note:**: The event payload is deprecated, please use the `value` property on the component to determine the removed value instead.
          */
         "onCalciteComboboxChipDismiss"?: (event: CalciteComboboxCustomEvent<DeprecatedEventPayload>) => void;
         /**
@@ -5988,7 +6002,7 @@ declare namespace LocalJSX {
          */
         "onCalciteComboboxClose"?: (event: CalciteComboboxCustomEvent<void>) => void;
         /**
-          * Called when the user has entered text to filter the options list
+          * Fires when text is added to filter the options list.
          */
         "onCalciteComboboxFilterChange"?: (event: CalciteComboboxCustomEvent<{
     visibleItems: HTMLCalciteComboboxItemElement[];
@@ -5999,12 +6013,12 @@ declare namespace LocalJSX {
          */
         "onCalciteComboboxOpen"?: (event: CalciteComboboxCustomEvent<void>) => void;
         /**
-          * Called when the selected items set changes
-          * @deprecated use calciteComboboxChange instead
+          * Fires when the selected items set changes.
+          * @deprecated use `calciteComboboxChange` instead.
          */
         "onCalciteLookupChange"?: (event: CalciteComboboxCustomEvent<HTMLCalciteComboboxItemElement[]>) => void;
         /**
-          * When true, opens the combobox
+          * When `true`, displays and positions the component.
          */
         "open"?: boolean;
         /**
@@ -6012,80 +6026,80 @@ declare namespace LocalJSX {
          */
         "overlayPositioning"?: OverlayPositioning;
         /**
-          * Placeholder text for input
+          * Specifies the placeholder text for the input.
          */
         "placeholder"?: string;
         /**
-          * Placeholder icon for input
+          * Specifies the placeholder icon for the input.
          */
         "placeholderIcon"?: string;
         /**
-          * Specify the scale of the combobox, defaults to m
+          * Specifies the size of the component.
          */
         "scale"?: Scale;
         /**
-          * specify the selection mode - multi: allow any number of selected items (default) - single: only one selection) - ancestors: like multi, but show ancestors of selected items as selected, only deepest children shown in chips
+          * Specifies the selection mode - `"multi"` (allow any number of selected items), `"single"` (allow only one selection), or `"ancestors"` (like `"multi"`, but show ancestors of selected items as selected. Only the deepest children are shown in `calcite-chip`s).
          */
         "selectionMode"?: ComboboxSelectionMode;
         /**
-          * The value(s) of the selectedItem(s)
+          * The component's value(s) from the selected `calcite-combobox-item`(s).
          */
         "value"?: string | string[];
     }
     interface CalciteComboboxItem {
         /**
-          * True when item is highlighted either from keyboard or mouse hover
+          * When `true`, the component is active.
          */
         "active"?: boolean;
         /**
-          * Parent and grandparent combobox items, this is set internally for use from combobox
+          * Specifies the parent and grandparent items, which are set on `calcite-combobox`.
          */
         "ancestors"?: ComboboxChildElement[];
         /**
-          * Don't filter this item based on the search text
-          * @deprecated use filterDisabled instead
+          * When `true`, omits the component from the `calcite-combobox` filtered search results.
+          * @deprecated use `filterDisabled` instead.
          */
         "constant"?: boolean;
         /**
-          * When true, the item cannot be clicked and is visually muted.
+          * When `true`, interaction is prevented and the component is displayed with lower opacity.
          */
         "disabled"?: boolean;
         /**
-          * Do not filter this item based on the search text
+          * When `true`, omits the component from the `calcite-combobox` filtered search results.
          */
         "filterDisabled"?: boolean;
         /**
-          * Unique identifier, used for accessibility
+          * The `id` attribute of the component. When omitted, a globally unique identifier is used.
          */
         "guid"?: string;
         /**
-          * Custom icon to display both in combobox chips and next to combobox item text
+          * Specifies an icon to display.
          */
         "icon"?: string;
         /**
-          * Emitted whenever the item is selected or unselected.  **Note:**: The event's payload is deprecated, please use the event's `target`/`currentTarget` instead
+          * Emits whenever the component is selected or unselected.  **Note:**: The event's payload is deprecated, please use the event's `target`/`currentTarget` instead
          */
         "onCalciteComboboxItemChange"?: (event: CalciteComboboxItemCustomEvent<DeprecatedEventPayload>) => void;
         /**
-          * Set this to true to pre-select an item. Toggles when an item is checked/unchecked.
+          * When `true`, the component is selected.
          */
         "selected"?: boolean;
         /**
-          * The main label for this item.
+          * The component's text.
          */
         "textLabel": string;
         /**
-          * The item's associated value
+          * The component's value.
          */
         "value": any;
     }
     interface CalciteComboboxItemGroup {
         /**
-          * Parent and grandparent combobox items, this is set internally for use from combobox
+          * Specifies the parent and grandparent `calcite-combobox-item`s, which are set on `calcite-combobox`.
          */
         "ancestors"?: ComboboxChildElement[];
         /**
-          * Title of the group
+          * Specifies the title of the component.
          */
         "label": string;
     }
@@ -6881,12 +6895,12 @@ declare namespace LocalJSX {
     }
     interface CalciteInputDatePicker {
         /**
-          * When true, the component is active.
+          * When `true`, the component is active.
           * @deprecated use `open` instead.
          */
         "active"?: boolean;
         /**
-          * When true, interaction is prevented and the component is displayed with lower opacity.
+          * When `true`, interaction is prevented and the component is displayed with lower opacity.
          */
         "disabled"?: boolean;
         /**
@@ -6988,7 +7002,7 @@ declare namespace LocalJSX {
          */
         "onCalciteInputDatePickerOpen"?: (event: CalciteInputDatePickerCustomEvent<void>) => void;
         /**
-          * When true, displays the `calcite-date-picker` component.
+          * When `true`, displays the `calcite-date-picker` component.
          */
         "open"?: boolean;
         /**
@@ -7001,15 +7015,15 @@ declare namespace LocalJSX {
          */
         "placement"?: MenuPlacement;
         /**
-          * When true, disables the default behavior on the third click of narrowing or extending the range. Instead starts a new range.
+          * When `true`, disables the default behavior on the third click of narrowing or extending the range. Instead starts a new range.
          */
         "proximitySelectionDisabled"?: boolean;
         /**
-          * When true, activates a range for the component.
+          * When `true`, activates a range for the component.
          */
         "range"?: boolean;
         /**
-          * When true, the component's value can be read, but controls are not accessible and the value cannot be modified.
+          * When `true`, the component's value can be read, but controls are not accessible and the value cannot be modified.
           * @mdn [readOnly](https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/readonly)
          */
         "readOnly"?: boolean;
@@ -7956,7 +7970,7 @@ declare namespace LocalJSX {
     }
     interface CalcitePopover {
         /**
-          * When true and clicking outside of the component, automatically closes open `calcite-popover`s.
+          * When `true`, clicking outside of the component automatically closes open `calcite-popover`s.
          */
         "autoClose"?: boolean;
         /**
@@ -8967,7 +8981,7 @@ declare namespace LocalJSX {
          */
         "onCalciteTipDismiss"?: (event: CalciteTipCustomEvent<void>) => void;
         /**
-          * When true and if it has a parent `calcite-tip-manager`, the component is selected.  Only one tip can be selected within the `calcite-tip-manager` parent.
+          * When `true`, the component is selected if it has a parent `calcite-tip-manager`.  Only one tip can be selected within the `calcite-tip-manager` parent.
          */
         "selected"?: boolean;
     }