@esri/calcite-components 5.0.0-next.86 → 5.0.0-next.88

package/dist/components/calcite-carousel/customElement.js

@@ -1,6 +1,6 @@
 /* All material copyright ESRI, All Rights Reserved, unless otherwise specified.
 See https://github.com/Esri/calcite-design-system/blob/dev/LICENSE.md for details.
-v5.0.0-next.86 */
+v5.0.0-next.88 */
 import { c as customElement } from "../../chunks/runtime.js";
 import { repeat } from "lit/directives/repeat.js";
 import { css, nothing, html } from "lit";

package/dist/components/calcite-carousel-item/customElement.js

@@ -1,6 +1,6 @@
 /* All material copyright ESRI, All Rights Reserved, unless otherwise specified.
 See https://github.com/Esri/calcite-design-system/blob/dev/LICENSE.md for details.
-v5.0.0-next.86 */
+v5.0.0-next.88 */
 import { c as customElement } from "../../chunks/runtime.js";
 import { css, html } from "lit";
 import { LitElement, setAttribute, safeClassMap } from "@arcgis/lumina";

package/dist/components/calcite-checkbox/customElement.js

@@ -1,6 +1,6 @@
 /* All material copyright ESRI, All Rights Reserved, unless otherwise specified.
 See https://github.com/Esri/calcite-design-system/blob/dev/LICENSE.md for details.
-v5.0.0-next.86 */
+v5.0.0-next.88 */
 import { C as CSS_UTILITY, c as customElement } from "../../chunks/runtime.js";
 import { css, svg, html } from "lit";
 import { createRef, ref } from "lit/directives/ref.js";

package/dist/components/calcite-chip/customElement.js

@@ -1,6 +1,6 @@
 /* All material copyright ESRI, All Rights Reserved, unless otherwise specified.
 See https://github.com/Esri/calcite-design-system/blob/dev/LICENSE.md for details.
-v5.0.0-next.86 */
+v5.0.0-next.88 */
 import { c as customElement } from "../../chunks/runtime.js";
 import { css, isServer, html } from "lit";
 import { createRef, ref } from "lit/directives/ref.js";

package/dist/components/calcite-chip-group/customElement.js

@@ -1,6 +1,6 @@
 /* All material copyright ESRI, All Rights Reserved, unless otherwise specified.
 See https://github.com/Esri/calcite-design-system/blob/dev/LICENSE.md for details.
-v5.0.0-next.86 */
+v5.0.0-next.88 */
 import { c as customElement } from "../../chunks/runtime.js";
 import { css, html } from "lit";
 import { createRef, ref } from "lit/directives/ref.js";

package/dist/components/calcite-color-picker/customElement.js

@@ -1,6 +1,6 @@
 /* All material copyright ESRI, All Rights Reserved, unless otherwise specified.
 See https://github.com/Esri/calcite-design-system/blob/dev/LICENSE.md for details.
-v5.0.0-next.86 */
+v5.0.0-next.88 */
 import { c as customElement } from "../../chunks/runtime.js";
 import { repeat } from "lit/directives/repeat.js";
 import { keyed } from "lit/directives/keyed.js";

package/dist/components/calcite-color-picker-hex-input/customElement.js

@@ -1,6 +1,6 @@
 /* All material copyright ESRI, All Rights Reserved, unless otherwise specified.
 See https://github.com/Esri/calcite-design-system/blob/dev/LICENSE.md for details.
-v5.0.0-next.86 */
+v5.0.0-next.88 */
 import { c as customElement } from "../../chunks/runtime.js";
 import { keyed } from "lit/directives/keyed.js";
 import Color from "color";

package/dist/components/calcite-color-picker-swatch/customElement.js

@@ -1,6 +1,6 @@
 /* All material copyright ESRI, All Rights Reserved, unless otherwise specified.
 See https://github.com/Esri/calcite-design-system/blob/dev/LICENSE.md for details.
-v5.0.0-next.86 */
+v5.0.0-next.88 */
 import { c as customElement } from "../../chunks/runtime.js";
 import { keyed } from "lit/directives/keyed.js";
 import Color from "color";

package/dist/components/calcite-combobox/customElement.d.ts

@@ -27,22 +27,22 @@ export abstract class Combobox extends LitElement {
    */
   accessor allowCustomValues: boolean;
   /**
-   * When `true`, the value-clearing will be disabled.
+   * When `true`, disables value-clearing.
    *
    * @default false
    */
   accessor clearDisabled: boolean;
   /**
-   * When `true`, interaction is prevented and the component is displayed with lower opacity.
+   * When `true`, prevents interaction and decreases the component's opacity.
    *
    * @default false
    */
   accessor disabled: boolean;
-  /** Specifies the component's filtered items. */
+  /** The component's filtered items. */
   get filteredItems(): HTMLCalciteComboboxItemElement[];
   /** Specifies the properties to match against when filtering. If not set, all properties will be matched (`description`, `label`, `metadata`, `shortHeading`). */
   accessor filterProps: string[];
-  /** Text for the component's filter input field. */
+  /** The component's filter input field text. */
   accessor filterText: string;
   /** Specifies the component's fallback `placement` for slotted content when it's initial or specified `placement` has insufficient space available. */
   accessor flipPlacements: FlipPlacement[];
@@ -97,18 +97,18 @@ export abstract class Combobox extends LitElement {
    * @default "absolute"
    */
   accessor overlayPositioning: OverlayPositioning;
-  /** Specifies the placeholder text for the input. */
+  /** Specifies the input's placeholder text. */
   accessor placeholder: string;
-  /** Specifies the placeholder icon for the input. */
+  /** Specifies the input's placeholder icon. */
   accessor placeholderIcon: IconName;
   /**
-   * When `true`, the icon will be flipped when the element direction is right-to-left (`"rtl"`).
+   * When `true` and the element direction is right-to-left (`"rtl"`), flips the input's `placeholderIcon`.
    *
    * @default false
    */
   accessor placeholderIconFlipRtl: boolean;
   /**
-   * Determines where the component will be positioned relative to the `referenceElement`.
+   * Specifies the component's position relative to the `referenceElement`.
    *
    * @default "bottom-start"
    */
@@ -133,12 +133,12 @@ export abstract class Combobox extends LitElement {
    */
   accessor scale: Scale;
   /**
-   * When `true` and `selectionMode` is `"multiple"` or `"ancestors"`, provides a checkbox for selecting all `calcite-combobox-item`s.
+   * When `true` and `selectionMode` is `"multiple"` or `"ancestors"`, displays a checkbox for selecting all `calcite-combobox-item`s.
    *
    * @default false
    */
   accessor selectAllEnabled: boolean;
-  /** Specifies the component's selected items. */
+  /** The component's selected items. */
   get selectedItems(): HTMLCalciteComboboxItemElement[];
   /**
    * When `selectionMode` is `"ancestors"` or `"multiple"`, specifies the display of multiple `calcite-combobox-item` selections, where:
@@ -167,7 +167,7 @@ export abstract class Combobox extends LitElement {
    */
   accessor selectionMode: Extract<"single" | "single-persist" | "ancestors" | "multiple", SelectionMode>;
   /**
-   * Specifies the status of the input field, which determines message and icons.
+   * Specifies the input field's status, which determines message and icons.
    *
    * @default "idle"
    */
@@ -194,7 +194,7 @@ export abstract class Combobox extends LitElement {
   /** The component's value(s) from the selected `calcite-combobox-item`(s). */
   accessor value: string | string[];
   /**
-   * Updates the position of the component.
+   * Updates the component's position.
    *
    * @param delayed - Reposition the component after a delay
    * @returns Promise

package/dist/components/calcite-combobox/customElement.js

@@ -1,6 +1,6 @@
 /* All material copyright ESRI, All Rights Reserved, unless otherwise specified.
 See https://github.com/Esri/calcite-design-system/blob/dev/LICENSE.md for details.
-v5.0.0-next.86 */
+v5.0.0-next.88 */
 import { D as DEBOUNCE, c as customElement } from "../../chunks/runtime.js";
 import { keyed } from "lit/directives/keyed.js";
 import { live } from "lit/directives/live.js";

package/dist/components/calcite-combobox-item/customElement.d.ts

@@ -7,10 +7,10 @@ import type { IconName } from "../calcite-icon/interfaces.js";
  * @cssproperty [--calcite-combobox-item-border-color] - [Deprecated] Specifies the component's border color.
  * @cssproperty [--calcite-combobox-text-color] - Specifies the component's text and `icon` color.
  * @cssproperty [--calcite-combobox-text-color-hover] - Specifies the component's text and `icon` color when hovered.
- * @cssproperty [--calcite-combobox-item-background-color-active] - Specifies the component's background color when active.
+ * @cssproperty [--calcite-combobox-item-background-color-active] - When `active`, specifies the component's background color.
  * @cssproperty [--calcite-combobox-item-background-color-hover] - Specifies the component's background color when hovered.
  * @cssproperty [--calcite-combobox-item-shadow] - Specifies the component's shadow.
- * @cssproperty [--calcite-combobox-selected-icon-color] - Specifies the component's selected indicator icon color.
+ * @cssproperty [--calcite-combobox-selected-icon-color] - Specifies the component's `selected` indicator icon color.
  * @cssproperty [--calcite-combobox-description-text-color] - Specifies the component's `description` and `shortHeading` text color.
  * @cssproperty [--calcite-combobox-description-text-color-press] - Specifies the component's `description` and `shortHeading` text color when hovered.
  * @cssproperty [--calcite-combobox-heading-text-color] - Specifies the component's `heading` text color.
@@ -25,12 +25,12 @@ export abstract class ComboboxItem extends LitElement {
    * @default false
    */
   accessor active: boolean;
-  /** Specifies the parent and grandparent items, which are set on `calcite-combobox`. */
+  /** Specifies the parent and grandparent `calcite-combobox-item`s, which are set on `calcite-combobox`. */
   accessor ancestors: ComboboxChildElement[];
   /** Specifies a description for the component. Displays below the heading. */
   accessor description: string;
   /**
-   * When `true`, interaction is prevented and the component is displayed with lower opacity.
+   * When `true`, prevents interaction and decreases the component's opacity.
    *
    * @default false
    */
@@ -52,14 +52,14 @@ export abstract class ComboboxItem extends LitElement {
   /** Specifies an icon to display. */
   accessor icon: IconName;
   /**
-   * When `true`, the icon will be flipped when the element direction is right-to-left (`"rtl"`).
+   * When `true` and the element direction is right-to-left (`"rtl"`), flips the component`s `icon`.
    *
    * @default false
    */
   accessor iconFlipRtl: boolean;
   /** Specifies an accessible label for the component. */
   accessor label: any;
-  /** Provides additional metadata to the component used in filtering. */
+  /** Specifies additional metadata to the component for use in filtering. */
   accessor metadata: Record<string, unknown>;
   /**
    * When `true`, the component is selected.
@@ -68,7 +68,7 @@ export abstract class ComboboxItem extends LitElement {
    */
   accessor selected: boolean;
   /**
-   * The component's short heading.
+   * Specifies the component's short heading.
    *
    * When provided, the short heading will be displayed in the component's selection.
    *

package/dist/components/calcite-combobox-item/customElement.js

@@ -1,6 +1,6 @@
 /* All material copyright ESRI, All Rights Reserved, unless otherwise specified.
 See https://github.com/Esri/calcite-design-system/blob/dev/LICENSE.md for details.
-v5.0.0-next.86 */
+v5.0.0-next.88 */
 import { c as customElement } from "../../chunks/runtime.js";
 import { keyed } from "lit/directives/keyed.js";
 import { css, html, nothing } from "lit";

package/dist/components/calcite-combobox-item-group/customElement.d.ts

@@ -3,8 +3,8 @@ import type { PublicLitElement as LitElement } from "@arcgis/lumina";
 import type { ComboboxChildElement } from "../calcite-combobox/interfaces.js";
 
 /**
- * @cssproperty [--calcite-combobox-item-group-text-color] - Specifies the text color of the component.
- * @cssproperty [--calcite-combobox-item-group-border-color] - Specifies the border color of the component.
+ * @cssproperty [--calcite-combobox-item-group-text-color] - Specifies the component's text color.
+ * @cssproperty [--calcite-combobox-item-group-border-color] - Specifies the component's border color.
  * @slot  - A slot for adding `calcite-combobox-item`s.
  */
 export abstract class ComboboxItemGroup extends LitElement {
@@ -17,7 +17,7 @@ export abstract class ComboboxItemGroup extends LitElement {
    */
   accessor label: string;
   /**
-   * Specifies the position of the group in the combobox menu.
+   * Specifies the group's position in the `calcite-combobox` menu.
    *
    * @default 0
    * @internal

package/dist/components/calcite-combobox-item-group/customElement.js

@@ -1,6 +1,6 @@
 /* All material copyright ESRI, All Rights Reserved, unless otherwise specified.
 See https://github.com/Esri/calcite-design-system/blob/dev/LICENSE.md for details.
-v5.0.0-next.86 */
+v5.0.0-next.88 */
 import { c as customElement } from "../../chunks/runtime.js";
 import { css, html } from "lit";
 import { LitElement, safeClassMap, safeStyleMap, nothing } from "@arcgis/lumina";

package/dist/components/calcite-date-picker/customElement.d.ts

@@ -6,37 +6,37 @@ import type { HeadingLevel } from "../functional/Heading.js";
 /**
  * @cssproperty [--calcite-date-picker-border-color] - Specifies the component's border color.
  * @cssproperty [--calcite-date-picker-corner-radius] - Specifies the component's border radius.
- * @cssproperty [--calcite-date-picker-range-calendar-divider-color] - Specifies the divider color between calendar's when `range="true"`.
- * @cssproperty [--calcite-date-picker-week-header-text-color] - Specifies the week header text color.
- * @cssproperty [--calcite-date-picker-header-action-background-color] - Specifies the background color of header action's of the component.
- * @cssproperty [--calcite-date-picker-header-action-background-color-hover] - Specifies the background color of header action's of the component when hovered.
- * @cssproperty [--calcite-date-picker-header-action-background-color-press] - Specifies the background color of header action's of the component when pressed.
- * @cssproperty [--calcite-date-picker-header-action-text-color] - Specifies the text color of header action's of the component.
- * @cssproperty [--calcite-date-picker-header-action-text-color-press] - Specifies the text color of header action's of the component when pressed.
- * @cssproperty [--calcite-date-picker-year-text-color] - Specifies the text color of year & suffix of the component.
- * @cssproperty [--calcite-date-picker-month-select-font-size] - Specifies the font size of month select of the component.
- * @cssproperty [--calcite-date-picker-month-select-text-color] - Specifies the text color of month select of the component.
- * @cssproperty [--calcite-date-picker-month-select-icon-color] - Specifies the icon color of month select of the component.
- * @cssproperty [--calcite-date-picker-month-select-icon-color-hover] - Specifies the icon color of month select of the component when hovered.
- * @cssproperty [--calcite-date-picker-day-background-color] - Specifies the background color of day of the component.
- * @cssproperty [--calcite-date-picker-day-background-color-hover] - Specifies the background color of day of the component when hovered.
- * @cssproperty [--calcite-date-picker-day-text-color] - Specifies the text color of day of the component.
- * @cssproperty [--calcite-date-picker-day-text-color-hover] - Specifies the text color of day of the component when hovered.
- * @cssproperty [--calcite-date-picker-current-day-text-color] - Specifies the text color of current day of the component.
- * @cssproperty [--calcite-date-picker-day-background-color-selected] - Specifies the background color of selected day of the component.
- * @cssproperty [--calcite-date-picker-day-text-color-selected] - Specifies the text color of selected day of the component.
- * @cssproperty [--calcite-date-picker-day-range-text-color] - Specifies the text color of select day range of the component.
- * @cssproperty [--calcite-date-picker-day-range-background-color] - Specifies the background color of select day range of the component.
- * @cssproperty [--calcite-date-picker-day-outside-range-background-color-hover] - Specifies the background color of day's outside current range when hovered.
- * @cssproperty [--calcite-date-picker-day-outside-range-text-color-hover] - Specifies the text color of day's outside current range when hovered.
+ * @cssproperty [--calcite-date-picker-range-calendar-divider-color] - When `range` is `true`, specifies the divider color between the component's calendars.
+ * @cssproperty [--calcite-date-picker-week-header-text-color] - Specifies the text color of the component's week header.
+ * @cssproperty [--calcite-date-picker-header-action-background-color] - Specifies the background color of component`s header actions.
+ * @cssproperty [--calcite-date-picker-header-action-background-color-hover] - Specifies the background color of component`s header actions when hovered.
+ * @cssproperty [--calcite-date-picker-header-action-background-color-press] - Specifies the background color of component`s header actions when pressed.
+ * @cssproperty [--calcite-date-picker-header-action-text-color] - Specifies the text color of the component's header actions.
+ * @cssproperty [--calcite-date-picker-header-action-text-color-press] - Specifies the text color of the component's header actions when pressed.
+ * @cssproperty [--calcite-date-picker-year-text-color] - Specifies the text color of the component's year and suffix.
+ * @cssproperty [--calcite-date-picker-month-select-font-size] - Specifies the font size of the component's month selector.
+ * @cssproperty [--calcite-date-picker-month-select-text-color] - Specifies the text color of the component's month selector.
+ * @cssproperty [--calcite-date-picker-month-select-icon-color] - Specifies the icon color of the component's month selector.
+ * @cssproperty [--calcite-date-picker-month-select-icon-color-hover] - Specifies the icon color of the component's month selector when hovered.
+ * @cssproperty [--calcite-date-picker-day-background-color] - Specifies the background color of the component's day elements.
+ * @cssproperty [--calcite-date-picker-day-background-color-hover] - Specifies the background color of the component's day elements when hovered.
+ * @cssproperty [--calcite-date-picker-day-text-color] - Specifies the text color of the component's day elements.
+ * @cssproperty [--calcite-date-picker-day-text-color-hover] - Specifies the text color of the component's day elements when hovered.
+ * @cssproperty [--calcite-date-picker-current-day-text-color] - Specifies the text color of the component's current day.
+ * @cssproperty [--calcite-date-picker-day-background-color-selected] - Specifies the background color of the component's selected day.
+ * @cssproperty [--calcite-date-picker-day-text-color-selected] - Specifies the text color of the component's selected day elements.
+ * @cssproperty [--calcite-date-picker-day-range-text-color] - Specifies the text color of component's selected day range.
+ * @cssproperty [--calcite-date-picker-day-range-background-color] - Specifies the background color the component's selected day range.
+ * @cssproperty [--calcite-date-picker-day-outside-range-background-color-hover] - Specifies the background color of the component's day elements outside the current range when hovered.
+ * @cssproperty [--calcite-date-picker-day-outside-range-text-color-hover] - Specifies the text color of the component's day elements outside the current range when hovered.
  */
 export abstract class DatePicker extends LitElement {
   /** Specifies the component's active date. */
   accessor activeDate: Date;
-  /** When `range` is true, specifies the active `range`. Where `"start"` specifies the starting range date and `"end"` the ending range date. */
+  /** When `range` is `true`, specifies the active `range`. Where `"start"` specifies the starting range date and `"end"` the ending range date. */
   accessor activeRange: "start" | "end";
   /**
-   * Specifies the number of calendars displayed when `range` is `true`.
+   * When `range` is `true`, specifies the number of calendars displayed.
    *
    * @default 2
    */
@@ -44,7 +44,7 @@ export abstract class DatePicker extends LitElement {
   /** Specifies the heading level number of the component's `heading` for proper document structure, without affecting visual styling. */
   accessor headingLevel: HeadingLevel;
   /**
-   * Defines the layout of the component.
+   * Defines the component's layout.
    *
    * @default "horizontal"
    */
@@ -72,7 +72,7 @@ export abstract class DatePicker extends LitElement {
   /** Specifies the earliest allowed date as a full date object (`new Date("yyyy-mm-dd")`). */
   accessor minAsDate: Date;
   /**
-   * Specifies the monthStyle used by the component.
+   * Specifies the component's month style.
    *
    * @default "wide"
    */

package/dist/components/calcite-date-picker/customElement.js

@@ -1,6 +1,6 @@
 /* All material copyright ESRI, All Rights Reserved, unless otherwise specified.
 See https://github.com/Esri/calcite-design-system/blob/dev/LICENSE.md for details.
-v5.0.0-next.86 */
+v5.0.0-next.88 */
 import { c as customElement } from "../../chunks/runtime.js";
 import { css, isServer, html } from "lit";
 import { LitElement, createEvent, safeClassMap } from "@arcgis/lumina";

package/dist/components/calcite-date-picker-day/customElement.js

@@ -1,6 +1,6 @@
 /* All material copyright ESRI, All Rights Reserved, unless otherwise specified.
 See https://github.com/Esri/calcite-design-system/blob/dev/LICENSE.md for details.
-v5.0.0-next.86 */
+v5.0.0-next.88 */
 import { c as customElement } from "../../chunks/runtime.js";
 import { css, html } from "lit";
 import { LitElement, createEvent, setAttribute, safeClassMap } from "@arcgis/lumina";

package/dist/components/calcite-date-picker-month/customElement.js

@@ -1,6 +1,6 @@
 /* All material copyright ESRI, All Rights Reserved, unless otherwise specified.
 See https://github.com/Esri/calcite-design-system/blob/dev/LICENSE.md for details.
-v5.0.0-next.86 */
+v5.0.0-next.88 */
 import { c as customElement } from "../../chunks/runtime.js";
 import { ref } from "lit/directives/ref.js";
 import { keyed } from "lit/directives/keyed.js";

package/dist/components/calcite-date-picker-month-header/customElement.js

@@ -1,6 +1,6 @@
 /* All material copyright ESRI, All Rights Reserved, unless otherwise specified.
 See https://github.com/Esri/calcite-design-system/blob/dev/LICENSE.md for details.
-v5.0.0-next.86 */
+v5.0.0-next.88 */
 import { c as customElement } from "../../chunks/runtime.js";
 import { live } from "lit/directives/live.js";
 import { h as calciteSpacingXxs, i as calciteSpacingBase, j as calciteSpacingSm } from "../../chunks/global.js";

package/dist/components/calcite-dialog/customElement.d.ts

@@ -9,35 +9,35 @@ import type { DialogPlacement } from "./interfaces.js";
 
 /**
  * @cssproperty [--calcite-dialog-scrim-background-color] - Specifies the background color of the component's scrim.
- * @cssproperty [--calcite-dialog-size-x] - Specifies the width of the component, using `px`, `em`, `rem`, `vw`, or `%`. Does not exceed the viewport's width - applies when `placement="cover"` is set.
- * @cssproperty [--calcite-dialog-min-size-x] - Specifies the minimum width of the component, using `px`, `em`, `rem`, `vw`, or `%`.
- * @cssproperty [--calcite-dialog-max-size-x] - Specifies the maximum width of the component, using `px`, `em`, `rem`, `vw`, or `%`.
- * @cssproperty [--calcite-dialog-size-y] - Specifies the height of the component, using `px`, `em`, `rem`, `vh`, or `%`. Does not exceed the viewport's height - applies when `placement="cover"` is set.
- * @cssproperty [--calcite-dialog-min-size-y] - Specifies the minimum height of the component, using `px`, `em`, `rem`, `vh`, or `%`.
- * @cssproperty [--calcite-dialog-max-size-y] - Specifies the maximum height of the component, using `px`, `em`, `rem`, `vh`, or `%`.
+ * @cssproperty [--calcite-dialog-size-x] - When `placement` is `"cover"`, specifies the component's width, using `px`, `em`, `rem`, `vw`, or `%`. Does not exceed the viewport's width.
+ * @cssproperty [--calcite-dialog-min-size-x] - Specifies the component's minimum width, using `px`, `em`, `rem`, `vw`, or `%`.
+ * @cssproperty [--calcite-dialog-max-size-x] - Specifies the component's maximum width, using `px`, `em`, `rem`, `vw`, or `%`.
+ * @cssproperty [--calcite-dialog-size-y] - When `placement` is `"cover"`, specifies the component's height, using `px`, `em`, `rem`, `vh`, or `%`. Does not exceed the viewport's height.
+ * @cssproperty [--calcite-dialog-min-size-y] - Specifies the component's minimum height, using `px`, `em`, `rem`, `vh`, or `%`.
+ * @cssproperty [--calcite-dialog-max-size-y] - Specifies the component's maximum height, using `px`, `em`, `rem`, `vh`, or `%`.
  * @cssproperty [--calcite-dialog-content-space] - Specifies the padding of the component's content.
  * @cssproperty [--calcite-dialog-footer-space] - Specifies the padding of the component's footer.
  * @cssproperty [--calcite-dialog-border-color] - Specifies the component's border color.
- * @cssproperty [--calcite-dialog-offset-x] - Specifies the horizontal offset of the component.
- * @cssproperty [--calcite-dialog-offset-y] - Specifies the vertical offset of the component.
- * @cssproperty [--calcite-dialog-background-color] - Specifies the background color of the component.
+ * @cssproperty [--calcite-dialog-offset-x] - Specifies the component's horizontal offset.
+ * @cssproperty [--calcite-dialog-offset-y] - Specifies the component's vertical offset.
+ * @cssproperty [--calcite-dialog-background-color] - Specifies the component's background color.
  * @cssproperty [--calcite-dialog-icon-color] - Specifies the color of the component's icon.
- * @cssproperty [--calcite-dialog-accent-color] - Specifies the component's accent color when `kind` is specified.
+ * @cssproperty [--calcite-dialog-accent-color] - When `kind` is specified, specifies the component's accent color.
  * @cssproperty [--calcite-dialog-corner-radius] - Specifies the component's corner radius.
  * @cssproperty [--calcite-dialog-heading-text-color] - Specifies the text color of the component's `heading`.
  * @cssproperty [--calcite-dialog-description-text-color] - Specifies the text color of the component's `description`.
  * @cssproperty [--calcite-dialog-header-background-color] - Specifies the background color of the component's header.
- * @cssproperty [--calcite-dialog-header-action-background-color] - Specifies the background color of Panel's `closable`, `collapsible`, and elements slotted in `header-menu-actions`.
- * @cssproperty [--calcite-dialog-header-action-background-color-hover] - Specifies the background color of Panel's `closable`, `collapsible`, and elements slotted in `header-menu-actions` when hovered.
- * @cssproperty [--calcite-dialog-header-action-background-color-press] - Specifies the background color of Panel's `closable`, `collapsible`, and elements slotted in `header-menu-actions` when pressed.
- * @cssproperty [--calcite-dialog-header-action-text-color] - Specifies the text color of Panel's `closable`, `collapsible`, and elements slotted in `header-menu-actions`.
- * @cssproperty [--calcite-dialog-header-action-text-color-press] - Specifies the text color of Panel's `closable`, `collapsible`, and elements slotted in `header-menu-actions` when pressed or hovered.
+ * @cssproperty [--calcite-dialog-header-action-background-color] - Specifies the background color of the component's `closable`, `collapsible`, and slotted `header-menu-actions` `calcite-action`s.
+ * @cssproperty [--calcite-dialog-header-action-background-color-hover] - Specifies the background color of the component's `closable`, `collapsible`, and slotted `header-menu-actions` `calcite-action`s when hovered.
+ * @cssproperty [--calcite-dialog-header-action-background-color-press] - Specifies the background color of the component's `closable`, `collapsible`, and slotted `header-menu-actions` `calcite-action`s when pressed.
+ * @cssproperty [--calcite-dialog-header-action-text-color] - Specifies the text color of the component's `closable`, `collapsible`, and slotted `header-menu-actions` `calcite-action`s.
+ * @cssproperty [--calcite-dialog-header-action-text-color-press] - Specifies the text color of the component's `closable`, `collapsible`, and slotted `header-menu-actions` `calcite-action`s when pressed or hovered.
  * @cssproperty [--calcite-dialog-footer-background-color] - Specifies the background color of the component's footer.
- * @cssproperty [--calcite-dialog-space] - Specifies the padding of the component's `"unnamed (default)"` slot.
- * @cssproperty [--calcite-dialog-header-content-space] - Specifies the padding of the `"header-content"` slot.
+ * @cssproperty [--calcite-dialog-space] - Specifies the padding of the component's `unnamed (default)` slot.
+ * @cssproperty [--calcite-dialog-header-content-space] - Specifies the padding of the component's `header-content` slot.
  * @cssproperty [--calcite-dialog-action-menu-border-color] - Specifies the border color of the component's internally rendered `calcite-popover`, which is rendered within a `calcite-action` menu when slotted `calcite-action`s are present in the `header-actions-end` slot. Applies to any slotted `calcite-popover`s.
  * @slot  - A slot for adding content.
- * @slot [custom-content] - A slot for displaying custom content. Will prevent the rendering of any default Dialog UI, except for `box-shadow` and `corner-radius`.
+ * @slot [custom-content] - A slot for displaying custom content. Will prevent the rendering of any default component UI, except for `box-shadow` and `corner-radius`.
  * @slot [action-bar] - A slot for adding a `calcite-action-bar` to the component.
  * @slot [alerts] - A slot for adding `calcite-alert`s to the component.
  * @slot [content-bottom] - A slot for adding content below the unnamed (default) slot and - if populated - the `footer` slot.
@@ -47,12 +47,12 @@ import type { DialogPlacement } from "./interfaces.js";
  * @slot [header-content] - A slot for adding custom content to the component's header.
  * @slot [header-menu-actions] - A slot for adding an overflow menu with actions inside a `calcite-dropdown`.
  * @slot [fab] - A slot for adding a `calcite-fab` (floating action button) to perform an action.
- * @slot [footer] - A slot for adding custom content to the component's footer. Should not be used with the `"footer-start"` or `"footer-end"` slots.
- * @slot [footer-end] - A slot for adding a trailing footer custom content. Should not be used with the `"footer"` slot.
- * @slot [footer-start] - A slot for adding a leading footer custom content. Should not be used with the `"footer"` slot.
+ * @slot [footer] - A slot for adding custom content to the component's footer. Should not be used with the `footer-start` or `footer-end` slots.
+ * @slot [footer-end] - A slot for adding a trailing footer custom content. Should not be used with the `footer` slot.
+ * @slot [footer-start] - A slot for adding a leading footer custom content. Should not be used with the `footer` slot.
  */
 export abstract class Dialog extends LitElement {
-  /** Passes a function to run before the component closes. */
+  /** Specifies a function to run before the component closes. */
   accessor beforeClose: () => Promise<void>;
   /**
    * When `true`, disables the component's close button.
@@ -60,7 +60,7 @@ export abstract class Dialog extends LitElement {
    * @default false
    */
   accessor closeDisabled: boolean;
-  /** Specifies a description for the component. */
+  /** Specifies the component's description. */
   accessor description: string;
   /**
    * When `true`, the component is draggable.
@@ -106,12 +106,12 @@ export abstract class Dialog extends LitElement {
   /** Specifies an icon to display. */
   accessor icon: IconName;
   /**
-   * When `true`, the icon will be flipped when the element direction is right-to-left (`"rtl"`).
+   * When `true` and the element direction is right-to-left (`"rtl"`), flips the component`s `icon`.
    *
    * @default false
    */
   accessor iconFlipRtl: boolean;
-  /** Specifies the kind of the component, which will style the top border. */
+  /** Specifies the component's kind, which determines the top border styling. */
   accessor kind: Extract<"brand" | "danger" | "info" | "success" | "warning", Kind>;
   /**
    * When `true`, a busy indicator is displayed.
@@ -160,7 +160,7 @@ export abstract class Dialog extends LitElement {
    */
   accessor overlayPositioning: OverlayPositioning;
   /**
-   * Specifies the placement of the dialog.
+   * Specifies the component's placement.
    *
    * @default "center"
    */
@@ -186,10 +186,10 @@ export abstract class Dialog extends LitElement {
    * @mdn [Top Layer](https://developer.mozilla.org/en-US/docs/Glossary/Top_layer)
    */
   accessor topLayerDisabled: boolean;
-  /** Specifies the width of the component. */
+  /** Specifies the component's width. */
   accessor width: Extract<Width, Scale>;
   /**
-   * Specifies the width of the component.
+   * Specifies the component's width.
    *
    * @deprecated in v3.0.0, removal target v6.0.0 - Use the `width` property instead.
    * @default "m"
@@ -222,15 +222,27 @@ export abstract class Dialog extends LitElement {
    * @param extraContainers - Additional elements to include in the focus trap. This is useful for including elements that may have related parts rendered outside the main focus trapping element.
    */
   updateFocusTrapElements(extraContainers?: FocusTrapOptions["extraContainers"]): Promise<void>;
+  /**
+   * Updates the dialog's inline and/or block size via method call.
+   *
+   * Use this method to programmatically override the dialog's width (inline) and/or height (block).
+   * Pass `null` to clear the override and revert to the default or CSS variable size.
+   *
+   * @param size
+   */
+  updateSize(size: {
+      inline?: number | null;
+      block?: number | null;
+  }): Promise<void>;
   /** Fires when the component is requested to be closed and before the closing transition begins. */
   readonly calciteDialogBeforeClose: import("@arcgis/lumina").TargetedEvent<this, void>;
   /** Fires when the component is added to the DOM but not rendered, and before the opening transition begins. */
   readonly calciteDialogBeforeOpen: import("@arcgis/lumina").TargetedEvent<this, void>;
   /** Fires when the component is closed and animation is complete. */
   readonly calciteDialogClose: import("@arcgis/lumina").TargetedEvent<this, void>;
-  /** Fires when the component is open and animation is complete. */
+  /** Fires when the component is opened and animation is complete. */
   readonly calciteDialogOpen: import("@arcgis/lumina").TargetedEvent<this, void>;
-  /** Fires when the content is scrolled. */
+  /** Fires when the component's content is scrolled. */
   readonly calciteDialogScroll: import("@arcgis/lumina").TargetedEvent<this, void>;
   readonly "@eventTypes": {
     calciteDialogBeforeClose: Dialog["calciteDialogBeforeClose"]["detail"];