@arcgis/map-components 4.34.0-next.133 → 4.34.0-next.134

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

@@ -19,41 +19,181 @@ declare const useElevationProfileViewModel: (component: LitElement & Pick<Elevat
  * [Read more...](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-elevation-profile-next/)
  */
 export declare class ArcgisElevationProfileNext extends LitElement {
+    /**
+     * The [ElevationProfileAnalysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-ElevationProfileAnalysis.html)
+     * created or modified by the component.
+     *
+     * When connecting the Elevation Profile component to the [Map](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/)
+     * or [Scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/)
+     * components, it automatically creates an empty analysis and adds it to the
+     * [analyses](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#analyses)
+     * collection. Whenever the component is destroyed, the analysis is automatically removed from the collection.
+     *
+     * Alternatively, a programmatically created analysis can be provided to the component.
+     * Then, the application itself needs to add it to and later remove it from the analyses collection.
+     *
+     * ```js
+     * // Create the analysis.
+     * const analysis = new ElevationProfileAnalysis({
+     *   profiles: [{ type: "ground" }, { type: "scene" }]
+     * });
+     *
+     * // Get the view element and the component and wait until they are ready.
+     * const viewElement = document.querySelector("arcgis-map");
+     * await viewElement.viewOnReady();
+     * const elevationProfileElement = document.querySelector("arcgis-elevation-profile");
+     * await elevationProfileElement.componentOnReady();
+     *
+     * // Add the analysis to the analyses collection.
+     * viewElement.analyses.add(analysis);
+     *
+     * // Connect the analysis to the elevation profile component.
+     * elevationProfileElement.analysis = sliceAnalysis;
+     * ```
+     */
     analysis: __esri.ElevationProfileAnalysis;
+    /**
+     * 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 ArcgisElevationProfileNext component will be associated with a map or scene component rather than using the `view` property.
+     */
     view: __esri.MapView | __esri.SceneView | undefined;
+    /**
+     * If true, the component will not be destroyed automatically when it is
+     * disconnected from the document. This is useful when you want to move the
+     * component to a different place on the page, or temporarily hide it. If this
+     * is set, make sure to call the [destroy](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-elevation-profile-next/#destroy) method when you are done to
+     * prevent memory leaks.
+     *
+     * @default false
+     */
     autoDestroyDisabled: boolean;
+    /**
+     * Units which have been selected according to the magnitude of the elevations and distances that are to be displayed
+     * in the component, according to the selected elevation and distance units or unit systems.
+     */
     readonly effectiveUnits: __esri.ElevationProfileEffectiveUnits | undefined;
+    /** @default false */
     hideChart: boolean;
+    /** @default false */
     hideClearButton: boolean;
+    /** @default false */
     hideLegend: boolean;
+    /** @default false */
     hideSelectButton: boolean;
+    /** @default false */
     hideSettingsButton: boolean;
+    /** @default false */
     hideSketchButton: boolean;
+    /** @default false */
     hideUniformChartScalingToggle: boolean;
+    /** @default false */
     hideUnitSelector: boolean;
+    /** @default false */
     highlightEnabled: boolean;
+    /**
+     * The position, in [0, 1], being hovered in the elevation profile chart.
+     *
+     * [Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-analysis-ElevationProfileAnalysisView3D.html#hoveredPosition)
+     */
     hoveredPosition: number | undefined;
+    /**
+     * Icon which represents the component.
+     * Typically used when the component is controlled by another component (e.g. by the Expand component).
+     *
+     * @see [Calcite Icons](https://developers.arcgis.com/calcite-design-system/icons/)
+     * @default "altitude"
+     */
     icon?: HTMLCalciteIconElement["icon"];
+    /**
+     *
+     * The input path along which elevation will be queried in order to generate an elevation profile. It can be either a
+     * Polyline or a Graphic containing a polyline geometry. If a Graphic is provided, it will not be made editable by the
+     * user as it is assumed to have been selected from the view.
+     *
+     * [Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-ElevationProfileAnalysis.html#input)
+     */
     input: nullish | __esri.Graphic | __esri.Polyline;
+    /** The component's default label. */
     label?: string;
+    /**
+     * Replace localized message strings with your own strings.
+     *
+     * _**Note**: Individual message keys may change between releases._
+     */
     messageOverrides?: typeof this._messages._overrides;
+    /** @deprecated since 4.34, use [`slot`](https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/slot) 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;
-    profiles: __esri.Collection<__esri.ElevationProfileGroundLine | __esri.ElevationProfileInputLine | __esri.ElevationProfileQueryLine | __esri.ElevationProfileSceneLine>;
+    /**
+     * Collection of elevation profile lines which are to be generated and displayed in the component's chart.
+     *
+     * [Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-ElevationProfileAnalysis.html#profiles)
+     */
+    profiles: __esri.Collection<__esri.ElevationProfileLineGround | __esri.ElevationProfileLineInput | __esri.ElevationProfileLineQuery | __esri.ElevationProfileLineScene>;
+    /** The progress, between 0 and 1 of generating all the configured elevation profiles. */
     readonly progress: number;
+    /**
+     * The component's state. The values mean the following:
+     *
+     * * `disabled` -  component is being created
+     * * `ready` - component is ready; no path configured and no interactive operation ongoing
+     * * `creating` - user is creating a new input path
+     * * `created` - input path is configured but no interactive operation is ongoing
+     * * `selecting` - user is selecting an existing input path
+     * * `selected` - user selected an existing input path
+     */
     state: "ready" | "selected" | "disabled" | "created" | "creating" | "selecting";
+    /**
+     * Whether the chart should use a uniform scale for the X and Y axes.
+     *
+     * @default false
+     */
     uniformChartScaling: boolean;
+    /**
+     * The measurement system (imperial, metric) or specific unit (e.g. feet, kilometers) used to display distance values
+     * in the chart, results and legend.
+     */
     unitDistance: __esri.SystemOrLengthUnit | undefined;
+    /**
+     * The measurement system (imperial, metric) or specific unit (e.g. feet, kilometers) used to display elevation values
+     * in the chart, results and legend.
+     */
     unitElevation: __esri.SystemOrLengthUnit | undefined;
+    /**
+     * List of available units and unit systems (imperial, metric) for displaying the distance values. These are the
+     * options displayed in the distance unit selector in the settings popover.
+     */
     unitOptionsDistance: __esri.SystemOrLengthUnit[];
+    /**
+     * List of available units and unit systems (imperial, metric) for displaying the elevation values. These are the
+     * options displayed in the elevation unit selector in the settings popover.
+     */
     unitOptionsElevation: __esri.SystemOrLengthUnit[];
+    /** Permanently destroy the component. */
     destroy(): Promise<void>;
+    /**
+     * Starts an interactive operation to pick a polyline graphic in the view to use as the input for the elevation
+     * profile analysis. The operation will finish when the user presses the escape key.
+     * To cancel the operation, call the `stop()` method.
+     */
     select(): Promise<void>;
+    /**
+     * Starts an interactive operation which allows the user to sketch a new input path in the view.
+     * To cancel the operation, call the `stop()` method.
+     */
     start(): Promise<void>;
+    /** Stops any ongoing interactive operation. */
     stop(): Promise<void>;
+    /** Emitted when the value of a property is changed. Use this to listen to changes to properties. */
     readonly arcgisPropertyChange: TargetedEvent<this, {
         name: "state" | "input" | "progress" | "effectiveUnits";
     }>;
+    /** Emitted when the component associated with a map or scene view is ready to be interacted with. */
     readonly arcgisReady: TargetedEvent<this, void>;
     private _messages;
 }

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

@@ -17,7 +17,7 @@ import { c as U } from "../../chunks/async-utils.js";
 import { createChart as D } from "@arcgis/core/applications/Components/analysisUtils.js";
 /*! 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-next.133 */
+v4.34.0-next.134 */
 const A = C`.esri-widget__heading{color:var(--calcite-color-text-2);margin:0 0 .5rem;font-weight:var(--calcite-font-weight-semibold)}h1.esri-widget__heading{font-size:var(--calcite-font-size-xl)}h2.esri-widget__heading{font-size:var(--calcite-font-size-md)}h3.esri-widget__heading,h4.esri-widget__heading,h5.esri-widget__heading,h6.esri-widget__heading{font-size:var(--calcite-font-size)}.esri-widget{--esri-widget-padding-x: 15px;--esri-widget-padding-y: var(--calcite-spacing-md);--esri-widget-padding: var(--esri-widget-padding-y) var(--esri-widget-padding-x);box-sizing:border-box;color:var(--calcite-color-text-2);background-color:var(--calcite-color-foreground-1);font-size:var(--calcite-font-size);line-height:1.3em}.esri-widget *,.esri-widget :before,.esri-widget :after{box-sizing:inherit}.esri-widget.esri-widget--disabled>*{opacity:.4;pointer-events:none}.esri-widget.esri-widget--compact{--esri-widget-padding-y: 0;--esri-widget-padding-x: 0}.esri-widget__anchor{color:var(--calcite-color-text-2)}.esri-widget__anchor:hover{color:var(--calcite-color-text-3)}.esri-widget__anchor:hover,.esri-widget__anchor:focus{text-decoration:underline}.esri-widget__anchor--disabled{opacity:.4;pointer-events:none}.esri-widget__header{background-color:var(--calcite-color-foreground-1);flex:1 0 100%;justify-content:space-between;align-items:center;width:100%;min-height:48px;padding:12px 0 12px 15px;display:flex}.esri-widget__header .esri-widget__heading{width:calc(100% - 48px);text-align:initial;color:var(--calcite-color-text-1);align-items:center;margin:0;padding:0;display:flex}.esri-widget__header-button{appearance:none;cursor:pointer;color:var(--calcite-color-text-2);background-color:var(--calcite-color-foreground-1);border:none;flex:0 0 48px;justify-content:center;align-self:stretch;align-items:center;width:48px;padding:0;display:flex}.esri-widget__footer{background-color:var(--calcite-color-foreground-1);justify-content:center;align-items:center;width:100%;min-height:48px;display:flex}.esri-widget__footer-pagination{color:var(--calcite-color-text-2);justify-content:space-between;align-items:center;display:flex}.esri-widget__footer-pagination-previous-button,.esri-widget__footer-pagination-next-button{cursor:pointer;background-color:var(--calcite-color-foreground-1);border:0;margin:0 7px;padding:12px 15px;transition:background-color .125s ease-in-out}.esri-widget__footer-pagination-previous-button:hover,.esri-widget__footer-pagination-previous-button:focus,.esri-widget__footer-pagination-next-button:hover,.esri-widget__footer-pagination-next-button:focus{color:var(--calcite-color-text-1);background-color:var(--calcite-color-foreground-1)}.esri-menu{visibility:hidden;z-index:1;background-clip:padding;background-color:var(--calcite-color-foreground-1);background-clip:padding-box;width:100%;max-height:0;margin:2px 0 0;padding:0;font-size:var(--calcite-font-size);line-height:var(--calcite-spacing-xl);position:absolute;top:100%;left:0;overflow:hidden;box-shadow:0 1px 2px #0000004d}.esri-menu .esri-menu__header{color:var(--calcite-color-text-inverse);background-color:var(--calcite-color-inverse);padding:6px 12px}.esri-menu__list{margin:0;padding:0;list-style:none}.esri-menu__list-item{cursor:pointer;border-top:1px solid #adadad4d;border-left:3px solid #0000;padding:.8em 1em}.esri-menu__list-item [class^=esri-icon-],.esri-menu__list-item [class*=" esri-icon-"]{padding-right:2.8px}.esri-menu__list-item:first-child{border-top:none}.esri-menu__list-item--focus,.esri-menu__list-item:hover,.esri-menu__list-item:focus{background-color:#303030}.esri-menu__list-item:active{background-color:#000}.esri-menu__list-item--active,.esri-menu__list-item--active:hover,.esri-menu__list-item--active:focus{background-color:var(--calcite-color-foreground-1);border-left-color:#2493f2}.esri-widget__table{border-collapse:collapse;color:var(--calcite-color-text-1);border:none;width:100%;line-height:1.3em}.esri-widget__table tr:nth-child(odd){background-color:var(--calcite-color-transparent)}.esri-widget__table tr:nth-child(2n){background-color:var(--calcite-color-transparent-press)}.esri-widget__table tr a{color:var(--calcite-color-text-2)}.esri-widget__table tr a:hover,.esri-widget__table tr a:focus{color:var(--calcite-color-text-1)}.esri-widget__table tr td,.esri-widget__table tr th{vertical-align:top;word-break:break-word;padding:.5em .7em;font-size:var(--calcite-font-size-sm);font-weight:var(--calcite-font-weight-regular)}.esri-widget__table tr th{text-align:left;border-right:3px solid #0000000d;width:50%}.esri-widget__table tr td{width:50%}.esri-input{color:var(--calcite-color-text-1);background-color:var(--calcite-color-foreground-1);border:1px solid #959595;font-size:var(--calcite-font-size)}.esri-input::-ms-clear{display:none}.esri-input::placeholder{opacity:1;color:var(--calcite-color-text-2)}.esri-input:placeholder-shown{text-overflow:ellipsis}.esri-input[type=text],.esri-input[type=password],.esri-input[type=number]{height:32px;padding:0 .5em}calcite-combobox.esri-input{border:none}.esri-widget__content--empty{text-align:center;color:var(--calcite-color-border-input);flex-flow:column wrap;align-items:center;padding:18px 22px;display:flex}.esri-widget__content--empty h1.esri-widget__heading,.esri-widget__content--empty h2.esri-widget__heading,.esri-widget__content--empty h3.esri-widget__heading,.esri-widget__content--empty h4.esri-widget__heading,.esri-widget__content--empty h5.esri-widget__heading{font-weight:var(--calcite-font-weight-regular)}.esri-widget__content-illustration--empty{width:128px;padding:1rem 0}.esri-widget__content-icon--empty{width:32px;padding:.5rem 0}.esri-select{appearance:none;cursor:pointer;color:var(--calcite-color-text-2);background:var(--calcite-color-foreground-1) url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='-8 -8 32 32' width='32' height='32'%3E%3Cpath d='M8 11.207l-4-4V5.793l4 4 4-4v1.414z' fill='%23adadad' fillrule='nonzero'/%3E%3C/svg%3E") 100% no-repeat;border:1px solid #959595;border-radius:0;width:100%;height:32px;margin:0;padding:0 .5em;font-family:inherit;font-size:.85em;display:block}.esri-select[disabled]{cursor:auto}.esri-select::-ms-expand{display:none}.esri-disabled a,.esri-disabled [role=menu],.esri-disabled [role=checkbox],.esri-disabled [class^=esri-icon-],.esri-disabled [class*=" esri-icon-"]{color:var(--calcite-color-text-3)}.keynav-mode .esri-widget:focus,.keynav-mode .esri-widget :focus{z-index:1;outline-offset:2px;outline:2px solid #adadad}.esri-widget__loader-animation{border:.15em solid #adadad4d;border-top-color:var(--calcite-color-border-input);border-radius:100%;width:1em;height:1em;font-size:var(--calcite-font-size-md);animation:1.25s linear infinite esri-rotate;display:block;transform:translateZ(0)}:dir(rtl) .esri-widget__table th{text-align:right;border-left:3px solid #0000000d;border-right:none}:dir(rtl) .esri-select{background-position:0}:dir(rtl) .esri-menu__list-item{border-left:none;border-right:3px solid #0000}:dir(rtl) .esri-menu__list-item [class^=esri-icon-],:dir(rtl) .esri-menu__list-item [class*=" esri-icon-"]{padding-left:2px;padding-right:0}:dir(rtl) .esri-menu__list-item--active{border-right-color:var(--calcite-color-brand)}.esri-icon-font-fallback-text{clip:rect(0 0 0 0);width:1px;height:1px;position:absolute;overflow:hidden}.esri-rotating{animation:1.25s linear infinite esri-rotate;transform:translateZ(0)}.esri-clearfix:before,.esri-clearfix:after{content:" ";display:table}.esri-clearfix:after{clear:both}.esri-interactive{cursor:pointer}.esri-hidden{display:none!important}.esri-invisible{visibility:hidden!important}.esri-offscreen{position:absolute;top:-999em;left:-999em}.esri-match-height{flex-direction:column;flex:auto;display:flex;overflow:hidden}.esri-widget--panel{min-width:300px;min-height:32px;padding:var(--esri-widget-padding);transition:max-height .25s ease-in-out;overflow-y:auto}:host{--internal-chart-height: 180px;--internal-gap: var(--calcite-spacing-sm-plus);width:550px;isolation:isolate;padding:var(--esri-widget-padding);position:relative;container-type:inline-size;resize:horizontal}.container{display:flex;flex-direction:column;width:100%;min-width:0;gap:var(--internal-gap)}.header{display:flex;flex-direction:row;align-items:center;justify-content:flex-end;margin-bottom:calc(var(--internal-gap) * -1)}.actions{display:flex;flex-wrap:wrap;align-items:center;justify-content:flex-end;gap:var(--calcite-spacing-xs)}.action-button{width:auto;min-height:32px}.main-container{display:flex;position:relative;flex-flow:column;width:100%;height:var(--internal-chart-height)}.chart-container{position:relative;width:100%;height:100%}.prompt-container{box-sizing:border-box;display:grid;place-content:center;padding-inline:var(--calcite-spacing-md);height:100%;text-align:center}.prompt-message{margin:0;width:100%}.spinner{position:absolute;top:50%;left:50%;transform:translate(-50%,-50%);transition:opacity .15s ease-in-out;transition-delay:0;opacity:0;&.visible{transition-delay:50ms;opacity:1}&.small{inset-inline-start:0;top:-22px;left:unset;transform:none;color:var(--calcite-color-brand)}}@container (max-width: 400px){.esri-widget--panel{height:auto}.actions{flex-direction:column}.action-button{align-self:stretch}}`;
 function F(t) {
   const e = f(t);
@@ -368,7 +368,7 @@ class H extends k {
     this.viewModel.clear();
   }
   _onZoomOutButtonClick() {
-    this._chart?._zoomOut();
+    this._chart?.zoomOut();
   }
   _onChartContainerRef(e) {
     this._chartContainer = e;

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

@@ -11,9 +11,12 @@ import { SystemOrLengthUnit } from '../../support/measurementUtils';
  */
 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[];

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

@@ -4,7 +4,7 @@ import { css as l, html as n } from "lit";
 import { LitElement as r, createEvent as h, nothing as a } 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-next.133 */
+v4.34.0-next.134 */
 const g = l`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 r {
   constructor() {

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

@@ -13,5 +13,5 @@ export declare class ArcgisElevationProfileStatistics extends LitElement {
     messages: ElevationProfileMessages;
     result: ElevationProfileCombinedResult;
     destroy(): Promise<void>;
-    readonly arcgisExpandedToggle: TargetedEvent<this, __esri.ElevationProfileGroundLine | __esri.ElevationProfileInputLine | __esri.ElevationProfileQueryLine | __esri.ElevationProfileSceneLine>;
+    readonly arcgisExpandedToggle: TargetedEvent<this, __esri.ElevationProfileLineGround | __esri.ElevationProfileLineInput | __esri.ElevationProfileLineQuery | __esri.ElevationProfileLineScene>;
 }

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

@@ -4,7 +4,7 @@ import { LitElement as c, createEvent as v } from "@arcgis/lumina";
 import d from "@arcgis/core/applications/Components/QuantityFormatter.js";
 /*! 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-next.133 */
+v4.34.0-next.134 */
 const m = 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 p extends c {
   constructor() {

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

@@ -32,35 +32,186 @@ declare const useExpandViewModel: (component: LitElement & Pick<ExpandViewModel,
  * ```
  */
 export declare class ArcgisExpand extends LitElement {
+    /**
+     * 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 ArcgisExpand 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.
+     *
+     * @default "disabled"
+     */
     readonly state: "ready" | "disabled";
+    /** The component's default label. */
     label?: string;
+    /**
+     * If true, the component will not be destroyed automatically when it is
+     * disconnected from the document. This is useful when you want to move the
+     * component to a different place on the page, or temporarily hide it. If this
+     * is set, make sure to call the [destroy](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-expand/#destroy) method when you are done to
+     * prevent memory leaks.
+     *
+     * @default false
+     */
     autoDestroyDisabled: boolean;
+    /** @deprecated since 4.34, use [`slot`](https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/slot) 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 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 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.
+     *
+     * @example
+     * ```html
+     * <arcgis-expand slot="top-right" close-on-esc="false">
+     *   <arcgis-search></arcgis-search>
+     * </arcgis-expand>
+     * ```
+     * @example
+     * ```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
+     */
     closeOnEscDisabled: boolean | ((event: KeyboardEvent) => boolean);
+    /**
+     * Indicates whether the component is currently expanded or not.
+     *
+     * @default false
+     */
     get expanded(): boolean;
     set expanded(expanded: boolean);
+    /**
+     * 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/)
+     * @default "chevrons-left"
+     */
     get expandIcon(): IconName | nil;
     set expandIcon(value: IconName | nil);
+    /**
+     * Tooltip to display to indicate Expand can be expanded.
+     *
+     * @default "Expand" (English locale)
+     */
     expandTooltip: string;
+    /**
+     * Calcite icon used to style the Expand when it can be collapsed.
+     *
+     * @see [Calcite Icon Search](https://developers.arcgis.com/calcite-design-system/icons/)
+     * @default "chevrons-right"
+     */
     get collapseIcon(): IconName;
     set collapseIcon(value: IconName | nil);
+    /**
+     * Tooltip to display to indicate the Expand can be collapsed.
+     *
+     * @default "Collapse" (English locale)
+     */
     collapseTooltip: string;
+    /**
+     * 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;
+    /**
+     * 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.
+     *
+     * @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.
+     *
+     * @example
+     * ```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 component to indicate the number of, for example, open issues or unread notices.
+     *
+     * ![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 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 component is viewed in a desktop or mobile application. |
+     * | floating     | Use this mode if you wish to always display the component as floating regardless of browser size. |
+     * | drawer       | Use this mode if you wish to always display the component in a panel regardless of browser size. |
+     *
+     * @default "auto"
+     */
     mode: "auto" | "drawer" | "floating";
+    /**
+     * 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"];
+    /**
+     * Replace localized message strings with your own strings.
+     *
+     * _**Note**: Individual message keys may change between releases._
+     */
     messageOverrides?: typeof this.messages._overrides;
+    /** Collapse the component. */
     collapse(): Promise<void>;
+    /** Permanently destroy the component. */
     destroy(): Promise<void>;
+    /** 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;
     readonly _setterTypes: {

package/dist/components/arcgis-expand/customElement.js

@@ -10,7 +10,7 @@ import { m as b } from "../../chunks/useViewModel.js";
 import { LitElement as $, createEvent as y, safeClassMap as i, nothing as C } 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-next.133 */
+v4.34.0-next.134 */
 const E = m`:host{display:flex;pointer-events:auto;--arcgis-expand-icon-number-left: none;--arcgis-expand-icon-number-right: none}arcgis-expand>.arcgis-expand__content--expanded{background-color:var(--calcite-color-background)}.arcgis-expand{--esri-widget-panel-max-height: 95svh;--calcite-sheet-max-height: var(--esri-widget-panel-max-height);--calcite-sheet-height: auto;min-width:32px;min-height:32px}.arcgis-expand__toggle{position:relative}.arcgis-expand__popover-content{flex-direction:column;display:flex;max-height:var(--arcgis-expand-max-height, 95svh);::slotted(*){max-height:var(--arcgis-expand-max-height, 95svh);overflow-y:auto}::slotted(:is(arcgis-area-measurement-2d,arcgis-area-measurement-3d,arcgis-basemap-gallery,arcgis-basemap-layer-list,arcgis-bookmarks,arcgis-building-explorer,arcgis-catalog-layer-list,arcgis-directions,arcgis-direct-line-measurement-3d,arcgis-distance-measurement-2d,arcgis-editor,arcgis-feature-form,arcgis-features,arcgis-layer-list,arcgis-legend,arcgis-line-of-sight,arcgis-print,arcgis-shadow-cast,arcgis-slice,arcgis-table-list,arcgis-utility-network-trace,arcgis-grid-controls)){width:var(--arcgis-internal-panel-width);min-width:var(--calcite-spacing-xxxl);min-height:var(--calcite-spacing-xxxl);transition:max-height .25s ease-in-out}}.arcgis-expand__popover-content .esri-widget--panel{width:300px}.arcgis-expand__panel{max-height:var(--esri-widget-panel-max-height)}.arcgis-expand__panel-content{::slotted(*){width:100%}}.arcgis-expand__panel-content .esri-widget{width:auto}.arcgis-expand__panel-content .esri-widget--panel{flex:auto}.arcgis-map-container-ui__element .arcgis-expand__popover-content .esri-widget,.arcgis-map-container-ui__element .arcgis-expand__popover-content .esri-widget.esri-component,.arcgis-map-container-ui__element .arcgis-expand__panel-content .esri-widget,.arcgis-map-container-ui__element .arcgis-expand__panel-content .esri-widget.esri-component,.arcgis-expand__popover-content .esri-widget,.arcgis-expand__popover-content .esri-widget.esri-component,.arcgis-expand__panel-content .esri-widget,.arcgis-expand__panel-content .esri-widget.esri-component{box-sizing:border-box;box-shadow:none;margin-bottom:0}.arcgis-expand__panel-content,.arcgis-expand__content-container{background-color:var(--calcite-color-foreground-1);flex-direction:column;flex:auto;justify-content:stretch;display:flex}.arcgis-expand__sheet .arcgis-expand__panel-content,.arcgis-expand__sheet .arcgis-expand__content-container{overflow:hidden}.arcgis-expand__panel-icon-number{align-self:center}.arcgis-expand__icon{display:flex}calcite-button:not(:hover) .arcgis-expand__icon:not(calcite-icon){color:var(--calcite-color-text-3)}.arcgis-expand__icon-flip{transform:var(--arcgis-collapse-icon-flip)}.arcgis-expand__icon-number{transform-origin:50%;color:var(--calcite-color-text-inverse);pointer-events:none;background-color:var(--calcite-color-text-3);border-radius:var(--calcite-spacing-xl);justify-content:center;align-items:center;height:var(--calcite-spacing-lg);padding:.125em .333em;font-size:var(--calcite-font-size-sm);line-height:1em;display:flex;position:absolute;top:-6px;left:var(--arcgis-expand-icon-number-left);right:var(--arcgis-expand-icon-number-right)}`, n = "arcgis-expand", a = {
   base: n,
   toggle: `${n}__toggle`,