@arcgis/map-components 4.34.0-next.99 → 4.34.0

package/dist/components/arcgis-elevation-profile-next/interfaces.d.ts

@@ -0,0 +1,164 @@
+/// <reference types="@arcgis/core/interfaces.d.ts" />
+import { default as ElevationProfileAnalysis } from '@arcgis/core/analysis/ElevationProfileAnalysis.js';
+import { default as Color } from '@arcgis/core/Color.js';
+import { default as Collection } from '@arcgis/core/core/Collection.js';
+import { default as ElevationProfileResult } from '@arcgis/core/views/analysis/ElevationProfile/ElevationProfileResult';
+export type AnalysisViewType = __esri.ElevationProfileAnalysisView2D | __esri.ElevationProfileAnalysisView3D;
+type CollectionType<T> = T extends Collection<infer U> ? U : never;
+export type ElevationProfileLine = CollectionType<ElevationProfileAnalysis["profiles"]>;
+export type ElevationProfileLineType = ElevationProfileLine["type"];
+export type ElevationProfileEffectiveDisplayUnits = AnalysisViewType["effectiveDisplayUnits"];
+export type ElevationProfileSamples = NonNullable<ElevationProfileResult["samples"]>;
+export type ElevationProfileSample = ElevationProfileSamples[number];
+export type ElevationProfileStatistics = NonNullable<AnalysisViewType["statistics"]>;
+declare const messages: (value: {
+    cancelButtonLabel: string;
+    chartTooltip: string;
+    clearProfile: string;
+    componentLabel: string;
+    "creatingPrompt-2d": string;
+    "creatingPrompt-3d": string;
+    doneButtonLabel: string;
+    errors: {
+        invalidGeometry: string;
+        noProfile: string;
+        tooComplex: string;
+        unknown: string;
+    };
+    hideDetails: string;
+    hideProfile: string;
+    hideSettings: string;
+    profiles: {
+        ground: string;
+        input: string;
+        query: string;
+        scene: string;
+    };
+    readyPrompt: string;
+    readyPromptCreateOnly: string;
+    readyPromptSelectOnly: string;
+    selectButtonLabel: string;
+    "selectingPrompt-2d": string;
+    "selectingPrompt-3d": string;
+    showDetails: string;
+    showProfile: string;
+    showSettings: string;
+    sketchButtonLabel: string;
+    statistics: {
+        avgElevation: string;
+        avgSlope: string;
+        gain: string;
+        loss: string;
+        maxDistance: string;
+        maxElevation: string;
+        maxSlope: string;
+        minElevation: string;
+        notAvailable: string;
+    };
+    uniformChartScalingDisable: string;
+    uniformChartScalingEnable: string;
+    uniformChartScalingLabel: string;
+    unitDistanceSelectLabel: string;
+    unitElevationSelectLabel: string;
+    zoomOut: string;
+}) => {
+    cancelButtonLabel: string;
+    chartTooltip: string;
+    clearProfile: string;
+    componentLabel: string;
+    "creatingPrompt-2d": string;
+    "creatingPrompt-3d": string;
+    doneButtonLabel: string;
+    errors: {
+        invalidGeometry: string;
+        noProfile: string;
+        tooComplex: string;
+        unknown: string;
+    };
+    hideDetails: string;
+    hideProfile: string;
+    hideSettings: string;
+    profiles: {
+        ground: string;
+        input: string;
+        query: string;
+        scene: string;
+    };
+    readyPrompt: string;
+    readyPromptCreateOnly: string;
+    readyPromptSelectOnly: string;
+    selectButtonLabel: string;
+    "selectingPrompt-2d": string;
+    "selectingPrompt-3d": string;
+    showDetails: string;
+    showProfile: string;
+    showSettings: string;
+    sketchButtonLabel: string;
+    statistics: {
+        avgElevation: string;
+        avgSlope: string;
+        gain: string;
+        loss: string;
+        maxDistance: string;
+        maxElevation: string;
+        maxSlope: string;
+        minElevation: string;
+        notAvailable: string;
+    };
+    uniformChartScalingDisable: string;
+    uniformChartScalingEnable: string;
+    uniformChartScalingLabel: string;
+    unitDistanceSelectLabel: string;
+    unitElevationSelectLabel: string;
+    zoomOut: string;
+};
+export type ElevationProfileMessages = Partial<ReturnType<typeof messages>>;
+/**
+ * Information needed to render a single elevation profile line in the chart.
+ */
+export interface ElevationProfileLineData {
+    id: string;
+    type: ElevationProfileLineType;
+    title: nullish | string;
+    color: Color;
+    samples: ElevationProfileSamples;
+    progress: number;
+    fillEnabled: boolean;
+    strokeWidth: number;
+    strokeOffsetY: number;
+}
+/**
+ * Information needed to render the elevation profile chart.
+ */
+export interface ChartData {
+    /**
+     * Data used to render each of the elevation profile lines in the chart.
+     */
+    readonly lines: readonly ElevationProfileLineData[];
+    /**
+     * Units effectively picked by the analysis based on the magnitude of the results and the units selected by the user.
+     */
+    readonly effectiveUnits: ElevationProfileEffectiveDisplayUnits;
+    /**
+     * Combined statistics of all the elevation profile results to be displayed in the chart.
+     */
+    readonly statistics: AnalysisViewType["statistics"] | undefined;
+    /**
+     * Whether the profiles have been fully refined/generated.
+     */
+    readonly refined: boolean;
+    /**
+     * Whether the chart should force a minimum ratio between the X and Y axes.
+     */
+    readonly dynamicElevationRange: boolean;
+    /**
+     * Whether the chart should use a uniform scale for the X and Y axes. When a uniform scale is applied, the X axis
+     * will display the same distance units per pixel as the elevation units per pixel displayed in the Y axis.
+     */
+    readonly uniformScaling: boolean;
+}
+/**
+ * Error state of the elevation profile component. We'll display a different error message depending on the error state.
+ */
+export type ElevationProfileErrorState = "invalid-geometry" | "no-available-profiles" | "no-valid-input" | "none" | "too-complex" | "unknown";
+export {};

package/dist/components/arcgis-elevation-profile-settings/customElement.d.ts

@@ -0,0 +1,25 @@
+/// <reference path="../../index.d.ts" />
+import { default as ElevationProfileAnalysis } from '@arcgis/core/analysis/ElevationProfileAnalysis.js';
+import { JsxNode, PublicLitElement as LitElement, TargetedEvent } from '@arcgis/lumina';
+import { ElevationProfileMessages } from '../arcgis-elevation-profile-next/interfaces';
+import { SystemOrLengthUnit } from '../../support/measurementUtils';
+
+/**
+ * Component which displays statistics for a profile line and a checkbox to toggle its visibility in the chart and view.
+ *
+ * @private
+ */
+export declare class ArcgisElevationProfileSettings extends LitElement {
+    analysis: ElevationProfileAnalysis;
+    /** @default false */
+    hideUniformChartScalingToggle: boolean;
+    /** @default false */
+    hideUnitSelector: boolean;
+    messages: ElevationProfileMessages;
+    /** @default false */
+    uniformChartScaling?: boolean;
+    unitOptionsDistance: SystemOrLengthUnit[];
+    unitOptionsElevation: SystemOrLengthUnit[];
+    destroy(): Promise<void>;
+    readonly arcgisElevationProfileSettingsUniformChartScalingChange: TargetedEvent<this, boolean>;
+}

package/dist/components/arcgis-elevation-profile-settings/customElement.js

@@ -0,0 +1,61 @@
+import { c as s } from "../../chunks/runtime.js";
+import { ref as c } from "lit/directives/ref.js";
+import { css as r, html as a } from "lit";
+import { LitElement as l, createEvent as h, nothing as o } from "@arcgis/lumina";
+/*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
+See https://js.arcgis.com/4.34/esri/copyright.txt for details.
+v4.34.0 */
+const g = r`calcite-popover[calcite-hydrated-hidden]{inset-block-start:-999999px;inset-inline-start:-999999px}.popover-content{display:flex;flex-direction:column;gap:var(--calcite-spacing-md);padding:var(--esri-widget-padding);min-width:180px}.uniform-chart-scaling-label{--calcite-label-margin-bottom: 0}`;
+class p extends l {
+  constructor() {
+    super(...arguments), this._onUniformChartScalingChange = (e) => {
+      this.arcgisElevationProfileSettingsUniformChartScalingChange.emit(e.currentTarget.checked);
+    }, this._onActionRef = (e) => {
+      this._actionElement = e ?? void 0;
+    }, this._popoverIsOpen = !1, this.hideUniformChartScalingToggle = !1, this.hideUnitSelector = !1, this.arcgisElevationProfileSettingsUniformChartScalingChange = h();
+  }
+  static {
+    this.properties = { _popoverIsOpen: 16, _actionElement: 16, analysis: 0, hideUniformChartScalingToggle: 5, hideUnitSelector: 5, messages: 0, uniformChartScaling: 5, unitOptionsDistance: 0, unitOptionsElevation: 0 };
+  }
+  static {
+    this.styles = g;
+  }
+  async destroy() {
+    await this.manager.destroy();
+  }
+  _onPopoverClose() {
+    this._popoverIsOpen = !1;
+  }
+  _onPopoverOpen() {
+    this._popoverIsOpen = !0;
+  }
+  render() {
+    const { messages: e } = this;
+    if (!e || this.hideUnitSelector && this.hideUniformChartScalingToggle)
+      return;
+    const t = (this._popoverIsOpen ? e.hideSettings : e.showSettings) ?? "";
+    return a`<calcite-action appearance=transparent data-testid=settings-button icon=gear scale=s .text=${t} title=${t ?? o} ${c(this._onActionRef)}></calcite-action>${this._actionElement ? a`<calcite-popover auto-close .label=${t} placement=bottom-end .referenceElement=${this._actionElement} @calcitePopoverOpen=${this._onPopoverOpen} @calcitePopoverClose=${this._onPopoverClose}><div class="popover-content">${this._renderUnitSelector()}${this._renderUniformChartScalingToggle()}</div></calcite-popover>` : void 0}`;
+  }
+  _renderUnitSelector() {
+    const { messages: e, hideUnitSelector: t } = this;
+    if (t)
+      return;
+    const i = this.analysis.displayUnits;
+    return a`<arcgis-unit-select .options=${this.unitOptionsDistance} .selectLabel=${e.unitDistanceSelectLabel} .value=${i.distance ?? void 0} @arcgisUnitSelectChange=${(n) => {
+      i.distance = n.detail;
+    }}></arcgis-unit-select><arcgis-unit-select .options=${this.unitOptionsElevation} .selectLabel=${e.unitElevationSelectLabel} .value=${i.elevation ?? void 0} @arcgisUnitSelectChange=${(n) => {
+      i.elevation = n.detail;
+    }}></arcgis-unit-select>`;
+  }
+  _renderUniformChartScalingToggle() {
+    const { messages: e, hideUniformChartScalingToggle: t, uniformChartScaling: i } = this;
+    if (t)
+      return;
+    const n = e?.[i ? "uniformChartScalingDisable" : "uniformChartScalingEnable"] ?? "";
+    return a`<calcite-label class="uniform-chart-scaling-label" layout=inline><calcite-checkbox .checked=${i} class="uniform-chart-scaling-checkbox" title=${n ?? o} @calciteCheckboxChange=${this._onUniformChartScalingChange}></calcite-checkbox>${e?.uniformChartScalingLabel}</calcite-label>`;
+  }
+}
+s("arcgis-elevation-profile-settings", p);
+export {
+  p as ArcgisElevationProfileSettings
+};

package/dist/components/arcgis-elevation-profile-settings/index.d.ts

@@ -0,0 +1,6 @@
+import "@esri/calcite-components/components/calcite-action";
+import "@esri/calcite-components/components/calcite-popover";
+import "../arcgis-unit-select/index.js";
+import "@esri/calcite-components/components/calcite-label";
+import "@esri/calcite-components/components/calcite-checkbox";
+export * from "./customElement.js";

package/dist/components/arcgis-elevation-profile-settings/index.js

@@ -0,0 +1,6 @@
+import "@esri/calcite-components/components/calcite-action";
+import "@esri/calcite-components/components/calcite-popover";
+import "../arcgis-unit-select/index.js";
+import "@esri/calcite-components/components/calcite-label";
+import "@esri/calcite-components/components/calcite-checkbox";
+export * from "./customElement.js";

package/dist/components/arcgis-elevation-profile-statistics/customElement.d.ts

@@ -0,0 +1,18 @@
+/// <reference types="@arcgis/core/interfaces.d.ts" />
+/// <reference path="../../index.d.ts" />
+import { default as ElevationProfileResult } from '@arcgis/core/views/analysis/ElevationProfile/ElevationProfileResult';
+import { JsxNode, PublicLitElement as LitElement, TargetedEvent } from '@arcgis/lumina';
+import { ElevationProfileEffectiveDisplayUnits, ElevationProfileMessages } from '../arcgis-elevation-profile-next/interfaces';
+
+/**
+ * Component which displays statistics for a profile line and a checkbox to toggle its visibility in the chart and view.
+ *
+ * @private
+ */
+export declare class ArcgisElevationProfileStatistics extends LitElement {
+    effectiveDisplayUnits?: ElevationProfileEffectiveDisplayUnits;
+    messages: ElevationProfileMessages;
+    result?: ElevationProfileResult;
+    destroy(): Promise<void>;
+    readonly arcgisExpandedToggle: TargetedEvent<this, __esri.ElevationProfileLineGround | __esri.ElevationProfileLineInput | __esri.ElevationProfileLineQuery | __esri.ElevationProfileLineScene>;
+}

package/dist/components/arcgis-elevation-profile-statistics/customElement.js

@@ -0,0 +1,65 @@
+import { c as l } from "../../chunks/runtime.js";
+import { css as o, html as n } from "lit";
+import c from "@arcgis/core/applications/Components/QuantityFormatter.js";
+import { LitElement as v, createEvent as d } from "@arcgis/lumina";
+/*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
+See https://js.arcgis.com/4.34/esri/copyright.txt for details.
+v4.34.0 */
+const p = o`:host{--internal-block-spacing: var(--calcite-spacing-sm-plus);--internal-inline-spacing: var(--calcite-spacing-md);--internal-columns: 1;--internal-icon-size: 16px;container-type:inline-size}.container{display:grid;isolation:isolate;grid-template-columns:repeat(var(--internal-columns, 1),1fr);gap:var(--calcite-spacing-xxs) var(--calcite-spacing-md)}.statistic{display:block;width:max-content;text-align:start;white-space:nowrap}.statistic-label,.statistic-value,.slope-values{font-size:var(--calcite-font-size-xs);font-weight:var(--calcite-font-weight-bold)}.statistic-label{font-weight:var(--calcite-font-weight-regular)}.statistic-value{margin-top:-.15em}.slope-values{display:flex;align-items:center;calcite-icon{width:var(--internal-icon-size);height:var(--internal-icon-size)}}@container (width > 200px){.container{--internal-columns: 2}}@container (width > 400px){.container{--internal-columns: 4}}@container (width > 800px){.container{--internal-columns: 8}}`;
+class m extends v {
+  constructor() {
+    super(...arguments), this._formatter = new c(), this.arcgisExpandedToggle = d();
+  }
+  static {
+    this.properties = { effectiveDisplayUnits: 0, messages: 0, result: 0 };
+  }
+  static {
+    this.styles = p;
+  }
+  async destroy() {
+    await this.manager.destroy();
+  }
+  async load() {
+    await this._formatter.when();
+  }
+  render() {
+    const t = this.messages?.statistics;
+    if (t)
+      return n`<div class="container">${this._renderDistance("maxDistance", t.maxDistance)}${this._renderElevation("elevationGain", t.gain)}${this._renderElevation("elevationLoss", t.loss)}${this._renderElevation("minElevation", t.minElevation)}${this._renderElevation("maxElevation", t.maxElevation)}${this._renderElevation("avgElevation", t.avgElevation)}${this._renderSlope("maxPositiveSlope", "maxNegativeSlope", t.maxSlope)}${this._renderSlope("avgPositiveSlope", "avgNegativeSlope", t.avgSlope)}</div>`;
+  }
+  _renderDistance(t, i) {
+    const a = this._renderValue(t, (e) => {
+      const s = this.effectiveDisplayUnits?.distance;
+      return s ? this._formatter.formatLength({ type: "length", value: e, unit: s }, r) : "";
+    });
+    return this._renderStatistic(i, a);
+  }
+  _renderElevation(t, i) {
+    const a = this._renderValue(t, (e) => {
+      const s = this.effectiveDisplayUnits?.elevation;
+      return s ? this._formatter.formatVerticalLength({ type: "length", value: e, unit: s }, r) : "";
+    });
+    return this._renderStatistic(i, a);
+  }
+  _renderSlope(t, i, a) {
+    return this._renderStatistic(a, n`<div class="slope-values"><calcite-icon icon=arrow-up scale=s></calcite-icon>${this._renderValue(t, (e) => (
+      // unitFormatUtils.formatAngleDegrees(v, "degrees", "geographic", "geographic", formatPrecision)
+      e.toFixed(1)
+    ))}<calcite-icon icon=arrow-down scale=s></calcite-icon>${this._renderValue(i, (e) => (
+      // unitFormatUtils.formatAngleDegrees(v, "degrees", "geographic", "geographic", formatPrecision),
+      e.toFixed(1)
+    ))}</div>`);
+  }
+  _renderStatistic(t, i) {
+    return n`<div class="statistic"><label class="statistic-label">${t}</label><div class="statistic-value">${i}</div></div>`;
+  }
+  _renderValue(t, i) {
+    const { result: a } = this, e = a?.progress === 1 ? a.statistics?.[t] : void 0;
+    return e == null ? " ― " : i(e);
+  }
+}
+const r = 1;
+l("arcgis-elevation-profile-statistics", m);
+export {
+  m as ArcgisElevationProfileStatistics
+};

package/dist/components/arcgis-elevation-profile-statistics/index.d.ts

@@ -0,0 +1,2 @@
+import "@esri/calcite-components/components/calcite-icon";
+export * from "./customElement.js";

package/dist/components/arcgis-elevation-profile-statistics/index.js

@@ -0,0 +1,2 @@
+import "@esri/calcite-components/components/calcite-icon";
+export * from "./customElement.js";

package/dist/components/arcgis-expand/customElement.d.ts

@@ -3,22 +3,44 @@
 import { ArcgisReferenceElement } from '../../utils/component-utils';
 import { default as ExpandViewModel } from '@arcgis/core/widgets/Expand/ExpandViewModel.js';
 import { Use } from '@arcgis/lumina/controllers';
-import { EventEmitter, JsxNode, PublicLitElement as LitElement, TargetedEvent } from '@arcgis/lumina';
+import { JsxNode, PublicLitElement as LitElement, TargetedEvent } from '@arcgis/lumina';
 import { nil } from '@arcgis/toolkit/type';
 
 type HTMLElementWithIcon = HTMLElement & {
     icon?: IconName;
 };
-type ContentSource = HTMLElement | HTMLElementWithIcon | string;
+type WidgetWithIcon = HTMLElement & {
+    widget?: HTMLElementWithIcon;
+};
+type ContentSource = HTMLElement | HTMLElementWithIcon | WidgetWithIcon | string;
 type IconName = HTMLCalciteIconElement["icon"];
 declare const useExpandViewModel: (component: LitElement & Pick<ExpandViewModel, never> & import('../../controllers/useViewModel').ViewModelControllerUses<ExpandViewModel>) => ExpandViewModel;
-/** [Read more...](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-expand/) */
+/**
+ * Expand acts as a clickable button for displaying interactive content, most commonly other components.
+ *
+ * [Read more...](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-expand/)
+ *
+ * @see [Samples with the Expand component](https://developers.arcgis.com/javascript/latest/sample-code/?tagged=arcgis-expand)
+ * @since 4.28
+ * @example
+ * ```html
+ * <arcgis-map item-id="45b3b2fb35e94ab09381d0caa0da5946">
+ *  <arcgis-expand slot="top-right">
+ *   <arcgis-layer-list></arcgis-layer-list>
+ *  </arcgis-expand>
+ * </arcgis-map>
+ * ```
+ */
 export declare class ArcgisExpand extends LitElement {
     /**
-     * The view model's state.
-     *
-     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Expand-ExpandViewModel.html#state)
+     * The view associated with the component.
+     *   > **Note:** The recommended approach is to fully migrate applications to use map and scene components and avoid using MapView and SceneView directly. However, if you are migrating a large application from widgets to components, you might prefer a more gradual transition. To support this use case, the SDK includes this `view` property which connects a component to a MapView or SceneView. Ultimately, once migration is complete, the Expand component will be associated with a map or scene component rather than using the `view` property.
+     */
+    view?: __esri.MapView | __esri.SceneView | nullish;
+    /**
+     * The current state of the component.
      *
+     * @since 4.34
      * @default "disabled"
      */
     readonly state: "ready" | "disabled";
@@ -34,146 +56,163 @@ export declare class ArcgisExpand extends LitElement {
      * @default false
      */
     autoDestroyDisabled: boolean;
-    /** @deprecated since 4.34, use [`slot`](https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/slot) instead. */
+    /** @deprecated since 4.34, use [`slot`](https://developers.arcgis.com/javascript/latest/building-your-ui/#slots) instead. */
     position?: __esri.UIPosition;
+    /**
+     * By assigning the `id` attribute of the Map or Scene component to this property, you can position a child component anywhere in the DOM while still maintaining a connection to the Map or Scene.
+     *
+     * @see [Associate components with a Map or Scene component](https://developers.arcgis.com/javascript/latest/programming-patterns/#associate-components-with-a-map-or-scene-component)
+     */
     referenceElement?: ArcgisReferenceElement | string;
     /**
-     * Automatically collapses the expand widget instance when the view's
+     * Automatically collapses the Expand component when the
      * [viewpoint](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-View.html#viewpoint) updates.
      *
      * @default false
      */
     autoCollapse: boolean;
     /**
-     * When true, the Expand widget will close after the Escape key is pressed when the keyboard focus is within its content.
-     * This property can also be set to a function that returns a boolean, allowing for more customization for when to allow the Expand widget
-     * to be closed from the `esc` key.
+     * When `true`, the Expand component will not close itself if the Escape key is pressed while its content has keyboard focus.
+     * This property can also be set to a function that returns a boolean, allowing for more customization for when to allow the
+     * Expand component to be closed via the Escape key.
      *
+     * @since 4.34
      * @example
-     * let expand = new Expand({
-     *    view: view,
-     *    content: search,
-     *    // widget will not be able to be closed from the ESC key
-     *    closeOnEsc: false
-     * });
+     * ```html
+     * <arcgis-expand slot="top-right" close-on-esc-disabled>
+     *   <arcgis-search></arcgis-search>
+     * </arcgis-expand>
+     * ```
      * @example
-     * let expand = new Expand({
-     *    view: view,
-     *    content: search,
-     *    // widget will close on ESC when Search has no active menu
-     *    closeOnEsc: function() {
-     *      return search.activeMenu === "none"
-     *    }
-     * });
-     * @default true
+     * ```html
+     * <arcgis-expand slot="top-right">
+     *   <arcgis-search></arcgis-search>
+     * </arcgis-expand>
+     *
+     * <script>
+     *  const expandElement = document.querySelector("arcgis-expand");
+     *  const searchElement = document.querySelector("arcgis-search");
+     *  // don't close the expand if the search is active
+     *  expandElement.closeOnEscDisabled = () => searchElement.activeMenu !== "none";
+     * </script>
+     * ```
+     * @default false
      */
-    closeOnEsc: boolean | ((event: KeyboardEvent) => boolean);
+    closeOnEscDisabled: boolean | ((event: KeyboardEvent) => boolean);
     /**
-     * Indicates whether the widget is currently expanded or not.
+     * Indicates whether the component is currently expanded or not.
      *
      * @default false
      */
-    expanded: boolean;
+    get expanded(): boolean;
+    set expanded(expanded: boolean);
     /**
-     * Calcite icon used when the widget is collapsed.
-     * Will automatically use the [content's](#content) icon if it has one.
+     * Calcite icon used to style the Expand when it can be expanded.
+     * The component will automatically use the icon of the component placed within the Expand if it has one.
      *
      * @see [Calcite Icon Search](https://developers.arcgis.com/calcite-design-system/icons/)
-     * @since 4.27
      * @default "chevrons-left"
      */
     get expandIcon(): IconName | nil;
     set expandIcon(value: IconName | nil);
     /**
-     * Tooltip to display to indicate Expand widget can be expanded.
+     * Tooltip to display to indicate Expand can be expanded.
      *
      * @default "Expand" (English locale)
      */
     expandTooltip: string;
     /**
-     * Calcite icon used to style the Expand button when the [content](#content) can be collapsed.
+     * Calcite icon used to style the Expand when it can be collapsed.
      *
      * @see [Calcite Icon Search](https://developers.arcgis.com/calcite-design-system/icons/)
-     * @since 4.27
      * @default "chevrons-right"
      */
     get collapseIcon(): IconName;
     set collapseIcon(value: IconName | nil);
     /**
-     * Tooltip to display to indicate Expand widget can be collapsed.
+     * Tooltip to display to indicate the Expand can be collapsed.
      *
      * @default "Collapse" (English locale)
      */
     collapseTooltip: string;
     /**
-     * TODO: [MIGRATION] rename to focusTrapEnabled to match the name the wrapped widget had
+     * Whether the user's keyboard focus should be trapped in the expanded panel state. If `true`, tabbing
+     * forward or backward will cycle through elements only within the panel content.
      *
      * @default false
      */
     focusTrapDisabled: boolean;
     /**
-     * This value associates two or more Expand widget instances with each other, allowing one
-     * instance to auto collapse when another instance in the same group is expanded. For auto collapsing
-     * to take effect, all instances of the group must be included in the view's `ui` property.
+     * Whether the user's keyboard focus should be trapped in the expanded panel state. If `true`, tabbing
+     * forward or backward will cycle through elements only within the panel content.
      *
-     * For example, if you place multiple Expand instances in the top-left of the view's ui, you can assign them to a
-     * group called `top-left`. If one Expand instance is expanded and the user clicks on a different instance in the
-     * `top-left` group, then the first instance is collapsed, allowing the content of the second instance to be
+     * @deprecated since 4.33, use [`focusTrapDisabled`](#focusTrapDisabled) instead.
+     * @default false
+     */
+    focusTrapEnabled: boolean;
+    /**
+     * This value associates two or more Expand components with each other, allowing one
+     * component to auto collapse when another in the same group is expanded. For auto collapsing
+     * to take effect, all components in the group must be included in the same Map, Scene, or Link Chart component.
+     *
+     * For example, if you place multiple Expand components in the `top-left` slot of the Map, you can assign them to a
+     * group called `top-left`. If one Expand component is expanded and the user clicks on a different component in the
+     * `top-left` group, then the first component is collapsed, allowing the content of the second component to be
      * fully visible.
      *
-     * @since 4.6
      * @example
-     * let expand1 = new Expand({
-     *   view: view,
-     *   content: document.getElementById("bg-gallery"),
-     *   expandIcon: "basemap",
-     *   group: "bottom-right"
-     * });
-     * let expand2 = new Expand({
-     *   view: view,
-     *   content: document.getElementById("legend"),
-     *   expandIcon: "key",
-     *   group: "bottom-right"
-     * });
-     *
-     * view.ui.add([expand1, expand2], "bottom-right");
+     * ```html
+     * <arcgis-map basemap="topo-vector">
+     *   <arcgis-expand slot="top-left" group="top-left" expanded>
+     *     <arcgis-layer-list></arcgis-layer-list>
+     *   </arcgis-expand>
+     *   <arcgis-expand slot="top-left" group="top-left">
+     *     <arcgis-basemap-gallery></arcgis-basemap-gallery>
+     *   </arcgis-expand>
+     * </arcgis-map>
      */
     group: string | nullish;
     /**
-     * A number to display at the corner of the widget to indicate the number of, for example, open issues or unread notices.
+     * A number to display at the corner of the component to indicate the number of, for example, open issues or unread notices.
      *
-     * ![expand widget icon number](../assets/img/apiref/widgets/expand-with-iconnumber.png)
+     * ![expand component icon number](https://developers.arcgis.com/javascript/latest//assets/img/apiref/widgets/expand-with-iconnumber.png)
      *
      * @default 0
      */
     iconNumber: number;
     /**
-     * The mode in which the widget displays. These modes are listed below.
+     * The mode in which the component displays. These modes are listed below:
      *
-     * mode | description
-     * ---------------|------------
-     * auto | This is the default mode. It is responsive to browser size changes and will update based on whether the widget is viewed in a desktop or mobile application.
-     * floating | Use this mode if you wish to always display the widget as floating regardless of browser size.
-     * drawer | Use this mode if you wish to always display the widget in a panel regardless of browser size.
+     * - `auto`: This is the default mode. It is responsive to browser size changes and will update based on whether the component is viewed in a desktop or mobile application.
+     * - `floating`: Use this mode if you wish to always display the component as floating in a [Calcite Popover component](https://developers.arcgis.com/calcite-design-system/components/popover/) regardless of browser size.
+     * - `drawer`: Use this mode if you wish to always display the component in a [Calcite Sheet component](https://developers.arcgis.com/calcite-design-system/components/sheet/) regardless of browser size.
      *
-     * @since 4.7
      * @default "auto"
      */
     mode: "auto" | "drawer" | "floating";
     /**
-     * The placement used by the [calcite popover](https://developers.arcgis.com/calcite-design-system/components/popover/) when the widget is expanded.
-     *
-     * @since 4.30
+     * The placement used by the [Calcite Popover](https://developers.arcgis.com/calcite-design-system/components/popover/) when the component is expanded.
+     * This property has no effect when the component is in `drawer` mode.
      */
     placement?: HTMLCalcitePanelElement["menuPlacement"];
-    /** Overwrite localized strings for this component */
+    /**
+     * Replace localized message strings with your own strings.
+     *
+     * _**Note**: Individual message keys may change between releases._
+     *
+     * @since 4.34
+     */
     messageOverrides?: typeof this.messages._overrides;
-    /** Collapse the widget. */
+    /** Collapse the component. */
     collapse(): Promise<void>;
     /** Permanently destroy the component. */
     destroy(): Promise<void>;
-    /** Expand the widget. */
+    /** Expand the component. */
     expand(): Promise<void>;
+    /** Emitted when the value of a property is changed. Use this to listen to changes to properties. */
+    readonly arcgisPropertyChange: TargetedEvent<this, {
+        name: "expanded";
+    }>;
     /** Emitted when the component associated with a map or scene view is ready to be interacted with. */
     readonly arcgisReady: TargetedEvent<this, void>;
     private messages;