@arcgis/map-components 4.34.0-next.3 → 4.34.0-next.31

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

@@ -1,27 +1,28 @@
-import { c as s } from "../../chunks/runtime.js";
+import { c as l } from "../../chunks/runtime.js";
 import { usePropertyChange as o } from "@arcgis/lumina/controllers";
-import { reEmitEvent as e } from "@arcgis/lumina/controllers/accessor";
-import l from "@arcgis/core/layers/GraphicsLayer.js";
+import { reEmitEvent as i } from "@arcgis/lumina/controllers/accessor";
+import a from "@arcgis/core/layers/GraphicsLayer.js";
 import n from "@arcgis/core/widgets/Sketch.js";
-import { LitElement as a, createEvent as h, noShadowRoot as d } from "@arcgis/lumina";
-import { m as r } from "../../chunks/useWidget.js";
-import { css as g } from "@lit/reactive-element/css-tag.js";
+import { LitElement as h, createEvent as d, noShadowRoot as r } from "@arcgis/lumina";
+import { m as g } from "../../chunks/useWidget.js";
+import { css as p } from "@lit/reactive-element/css-tag.js";
+import { watch as c } from "@arcgis/core/core/reactiveUtils.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.3 */
-const p = g`@layer{arcgis-sketch{display:block}}`, c = r(n);
-class m extends a {
+v4.34.0-next.31 */
+const m = p`@layer{arcgis-sketch{display:block}}`, y = g(n);
+class w extends h {
   constructor() {
-    super(), this.widget = c(this), this.viewModel = this.widget.viewModel, this.activeTool = this.widget.activeTool, this.autoDestroyDisabled = !1, this.availableCreateTools = this.widget.availableCreateTools, this.createGraphic = this.widget.createGraphic, this.creationMode = this.widget.creationMode, this.defaultCreateOptions = this.widget.defaultCreateOptions, this.defaultGraphicsLayerDisabled = !1, this.defaultUpdateOptions = this.widget.defaultUpdateOptions, this.hideCreateToolsCircle = this.widget.visibleElements.createTools.circle, this.hideCreateToolsPoint = this.widget.visibleElements.createTools.point, this.hideCreateToolsPolygon = this.widget.visibleElements.createTools.polygon, this.hideCreateToolsPolyline = this.widget.visibleElements.createTools.polyline, this.hideCreateToolsRectangle = this.widget.visibleElements.createTools.rectangle, this.hideDuplicateButton = this.widget.visibleElements.duplicateButton, this.hideDeleteButton = this.widget.visibleElements.deleteButton, this.hideSelectionCountLabel = this.widget.visibleElements.selectionCountLabel, this.hideLabelsToggle = this.widget.visibleElements.labelsToggle, this.hideSelectionToolsLassoSelection = this.widget.visibleElements.selectionTools["lasso-selection"], this.hideSelectionToolsRectangleSelection = this.widget.visibleElements.selectionTools["rectangle-selection"], this.hideSettingsMenu = this.widget.visibleElements.settingsMenu, this.hideSnappingControls = this.widget.visibleElements.snappingControls, this.hideSnappingControlsElementsEnabledToggle = this.widget.visibleElements.snappingControlsElements.enabledToggle, this.hideSnappingControlsElementsFeatureEnabledToggle = this.widget.visibleElements.snappingControlsElements.featureEnabledToggle, this.hideSnappingControlsElementsLayerList = this.widget.visibleElements.snappingControlsElements.layerList, this.hideSnappingControlsElementsSelfEnabledToggle = this.widget.visibleElements.snappingControlsElements.selfEnabledToggle, this.hideTooltipsToggle = this.widget.visibleElements.tooltipsToggle, this.hideUndoRedoMenu = this.widget.visibleElements.undoRedoMenu, this.icon = this.widget.icon, this.label = this.widget.label, this.labelOptions = this.widget.labelOptions, this.layer = this.widget.layer, this.layout = this.widget.layout, this.pointSymbol = this.viewModel.pointSymbol, this.polygonSymbol = this.viewModel.polygonSymbol, this.polylineSymbol = this.viewModel.polylineSymbol, this.position = "bottom-left", this.scale = this.widget.scale, this.toolbarKind = this.widget.toolbarKind, this.showSnappingControlsElementsHeader = this.widget.visibleElements.snappingControlsElements.header, this.snappingOptions = this.widget.snappingOptions, this.state = this.widget.state, this.tooltipOptions = this.widget.tooltipOptions, this.updateGraphics = this.widget.updateGraphics, this.arcgisCreate = e(() => this.widget, "create"), this.arcgisDelete = e(() => this.widget, "delete"), this.arcgisPropertyChange = o()("state"), this.arcgisReady = h(), this.arcgisRedo = e(() => this.widget, "redo"), this.arcgisUndo = e(() => this.widget, "undo"), this.arcgisUpdate = e(() => this.widget, "update"), this.widget.layer = new l({ title: "Sketch Layer" }), this.listen("arcgisReady", this._arcgisReadyHandler);
+    super(), this.widget = y(this), this.viewModel = this.widget.viewModel, this._defaultGraphicsLayer = null, this.activeTool = this.widget.activeTool, this.autoDestroyDisabled = !1, this.availableCreateTools = this.widget.availableCreateTools, this.createGraphic = this.widget.createGraphic, this.creationMode = this.widget.creationMode, this.defaultCreateOptions = this.widget.defaultCreateOptions, this.defaultGraphicsLayerDisabled = !1, this.defaultUpdateOptions = this.widget.defaultUpdateOptions, this.hideCreateToolsCircle = this.widget.visibleElements.createTools.circle, this.hideCreateToolsPoint = this.widget.visibleElements.createTools.point, this.hideCreateToolsPolygon = this.widget.visibleElements.createTools.polygon, this.hideCreateToolsPolyline = this.widget.visibleElements.createTools.polyline, this.hideCreateToolsRectangle = this.widget.visibleElements.createTools.rectangle, this.hideDuplicateButton = this.widget.visibleElements.duplicateButton, this.hideDeleteButton = this.widget.visibleElements.deleteButton, this.hideSelectionCountLabel = this.widget.visibleElements.selectionCountLabel, this.hideLabelsToggle = this.widget.visibleElements.labelsToggle, this.hideSelectionToolsLassoSelection = this.widget.visibleElements.selectionTools["lasso-selection"], this.hideSelectionToolsRectangleSelection = this.widget.visibleElements.selectionTools["rectangle-selection"], this.hideSettingsMenu = this.widget.visibleElements.settingsMenu, this.hideSnappingControls = this.widget.visibleElements.snappingControls, this.hideSnappingControlsElementsEnabledToggle = this.widget.visibleElements.snappingControlsElements.enabledToggle, this.hideSnappingControlsElementsFeatureEnabledToggle = this.widget.visibleElements.snappingControlsElements.featureEnabledToggle, this.hideSnappingControlsElementsLayerList = this.widget.visibleElements.snappingControlsElements.layerList, this.hideSnappingControlsElementsSelfEnabledToggle = this.widget.visibleElements.snappingControlsElements.selfEnabledToggle, this.hideTooltipsToggle = this.widget.visibleElements.tooltipsToggle, this.hideUndoRedoMenu = this.widget.visibleElements.undoRedoMenu, this.icon = this.widget.icon, this.label = this.widget.label, this.labelOptions = this.widget.labelOptions, this.layer = this.widget.layer, this.layout = this.widget.layout, this.pointSymbol = this.viewModel.pointSymbol, this.polygonSymbol = this.viewModel.polygonSymbol, this.polylineSymbol = this.viewModel.polylineSymbol, this.position = "bottom-left", this.scale = this.widget.scale, this.toolbarKind = this.widget.toolbarKind, this.showSnappingControlsElementsHeader = this.widget.visibleElements.snappingControlsElements.header, this.snappingOptions = this.widget.snappingOptions, this.state = this.widget.state, this.tooltipOptions = this.widget.tooltipOptions, this.updateGraphics = this.widget.updateGraphics, this.arcgisCreate = i(() => this.widget, "create"), this.arcgisDelete = i(() => this.widget, "delete"), this.arcgisPropertyChange = o()("state"), this.arcgisReady = d(), this.arcgisRedo = i(() => this.widget, "redo"), this.arcgisUndo = i(() => this.widget, "undo"), this.arcgisUpdate = i(() => this.widget, "update"), this.listen("arcgisReady", this._arcgisReadyHandler);
   }
   static {
     this.properties = { activeTool: 3, autoDestroyDisabled: 5, availableCreateTools: 0, createGraphic: 0, creationMode: 1, defaultCreateOptions: 0, defaultGraphicsLayerDisabled: 5, defaultUpdateOptions: 0, hideCreateToolsCircle: 5, hideCreateToolsPoint: 5, hideCreateToolsPolygon: 5, hideCreateToolsPolyline: 5, hideCreateToolsRectangle: 5, hideDuplicateButton: 5, hideDeleteButton: 5, hideSelectionCountLabel: 5, hideLabelsToggle: 5, hideSelectionToolsLassoSelection: 5, hideSelectionToolsRectangleSelection: 5, hideSettingsMenu: 5, hideSnappingControls: 5, hideSnappingControlsElementsEnabledToggle: 5, hideSnappingControlsElementsFeatureEnabledToggle: 5, hideSnappingControlsElementsLayerList: 5, hideSnappingControlsElementsSelfEnabledToggle: 5, hideTooltipsToggle: 5, hideUndoRedoMenu: 5, icon: 1, label: 1, labelOptions: 0, layer: 0, layout: 1, pointSymbol: 0, polygonSymbol: 0, polylineSymbol: 0, position: 1, referenceElement: 1, scale: 1, toolbarKind: 1, showSnappingControlsElementsHeader: 5, snappingOptions: 0, state: 3, tooltipOptions: 0, updateGraphics: 0 };
   }
   static {
-    this.shadowRootOptions = d;
+    this.shadowRootOptions = r;
   }
   static {
-    this.styles = p;
+    this.styles = m;
   }
   async cancel() {
     this.widget?.cancel();
@@ -29,8 +30,8 @@ class m extends a {
   async complete() {
     this.widget?.complete();
   }
-  async create(t, i) {
-    await this.widget?.create(t, i);
+  async create(t, e) {
+    await this.widget?.create(t, e);
   }
   async delete() {
     this.widget?.delete();
@@ -44,17 +45,24 @@ class m extends a {
   async redo() {
     this.widget?.redo();
   }
-  async triggerUpdate(t, i) {
-    this.widget?.update(t, i);
+  async triggerUpdate(t, e) {
+    this.widget?.update(t, e);
   }
   async undo() {
     this.widget?.undo();
   }
   _arcgisReadyHandler() {
-    this.defaultGraphicsLayerDisabled || this.el.view?.map?.add(this.widget.layer);
+    this.defaultGraphicsLayerDisabled || (this._defaultGraphicsLayer = new a({ title: "Sketch Layer" }), this.widget.layer = this._defaultGraphicsLayer, this.el.view?.map?.add(this.widget.layer), this.manager.onLifecycle(() => c(() => this.el.view?.map, (t, e) => {
+      if (this.widget.layer !== this._defaultGraphicsLayer)
+        return;
+      const s = this._defaultGraphicsLayer;
+      e?.allLayers.includes(s) && e.allLayers.remove(s), t?.add(s);
+    })), this.manager.onDestroy(() => {
+      this._defaultGraphicsLayer && this.el.view?.map?.allLayers.includes(this._defaultGraphicsLayer) && this.el.view?.map?.remove(this._defaultGraphicsLayer), this._defaultGraphicsLayer?.destroy(), this._defaultGraphicsLayer = null;
+    }));
   }
 }
-s("arcgis-sketch", m);
+l("arcgis-sketch", w);
 export {
-  m as ArcgisSketch
+  w as ArcgisSketch
 };

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

@@ -8,28 +8,80 @@ import { HeadingLevel } from '../../support/heading';
 
 declare const useSliceViewModel: (component: LitElement & Pick<SliceViewModel, never> & import('../../controllers/useViewModel').ViewModelControllerUses<SliceViewModel>) => SliceViewModel;
 /**
- * The Slice component is a 3D analysis tool that can be used to reveal occluded content in a 3D view. It applies
+ * The Slice component is a 3D analysis tool that can be used to reveal occluded content in a
+ * [Scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/). It applies
  * [slice analysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-SliceAnalysis.html)
  * to any layer type, making it possible to see inside buildings or to explore geological surfaces.
  *
- * The slicing [shape](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-slice/#shape)
+ * [![slice](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/slice.gif)](https://developers.arcgis.com/javascript/latest/sample-code/building-scene-layer-slice/index.html)
+ *
+ * The slicing [shape](#shape)
  * is always a [plane](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-SlicePlane.html).
  * By default, the plane is either horizontal or vertical. To allow a tilt angle for the plane, set
- * [tiltEnabled](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-slice/#tiltEnabled)
+ * [tiltEnabled](#tiltEnabled)
  * to `true`. The slice hides any content in front of the surface. The handles on the sides of the plane can be used to adjust
  * the size, heading, tilt, and position of the slice plane.
  * The [SlicePlane](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-SlicePlane.html)
- * can be set or retrieved using the [shape](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-slice/#shape) property.
+ * can be set or retrieved using the [shape](#shape) property.
  *
  * Once the slice plane is applied, layers can be excluded from the slicing. For example, by excluding the sublayers which include
  * columns and floor slabs, the inner structure of a building can investigated.
  *
+ * [![slice-exclude](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/slice-exclude.png)](https://developers.arcgis.com/javascript/latest/sample-code/building-scene-layer-slice/index.html)
+ *
+ * Holding the `Shift` key while creating a new slice applies it vertically.
+ *
+ * **Known limitation**
+ *
+ * Slice is only supported in a 3D [Scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/) component.
+ *
+ * **See also**
+ *
+ * - [SliceAnalysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-SliceAnalysis.html)
+ * - [Sample - BuildingSceneLayer with Slice component](https://developers.arcgis.com/javascript/latest/sample-code/building-scene-layer-slice/)
+ * - [Sample - Analysis objects](https://developers.arcgis.com/javascript/latest/sample-code/analysis-objects/)
+ *
  * [Read more...](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-slice/)
  */
 export declare class ArcgisSlice extends LitElement {
     /**
-     * The [slice analysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-SliceAnalysis.html)
-     * object being created by the component.
+     * The [SliceAnalysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-SliceAnalysis.html)
+     * created or modified by the component.
+     *
+     * When connecting the Slice component to the [Scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/)
+     * component, it automatically creates an empty analysis and adds it to the Scene's
+     * [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 Scene's analyses collection.
+     *
+     * ```js
+     * // Create the analysis.
+     * const sliceAnalysis = new SliceAnalysis({
+     *    shape: new SlicePlane({
+     *      position: new Point({
+     *        spatialReference: { latestWkid: 3857, wkid: 102100 },
+     *        x: -13624925.727820931,
+     *        y: 4550341.695170021,
+     *        z: 56
+     *      }),
+     *      tilt: 270,
+     *      width: 310,
+     *      height: 190,
+     *      heading: 45
+     *    })
+     * });
+     * // Get the Scene and Slice component and wait until they are ready.
+     * const viewElement = document.querySelector("arcgis-scene");
+     * await viewElement.viewOnReady();
+     * const slice = document.querySelector("arcgis-slice");
+     * await slice.componentOnReady();
+     * // Add the analysis to the Scene component.
+     * viewElement.analyses.add(sliceAnalysis);
+     * // Connect the analysis to the slice component:
+     * slice.analysis = sliceAnalysis;
+     * ```
      */
     analysis: __esri.SliceAnalysis;
     /**
@@ -66,15 +118,26 @@ export declare class ArcgisSlice extends LitElement {
     icon?: HTMLCalciteIconElement["icon"];
     /** The component's default label. */
     label?: string;
-    /** Replace localized message strings with your own strings. **Warning**: individual message keys may change between releases. */
+    /**
+     * Replace localized message strings with your own strings.
+     *
+     * _**Note**: Individual message keys may change between releases._
+     */
     messageOverrides?: typeof this._messages._overrides;
     /** @default "bottom-left" */
     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;
     /**
-     * The shape used to slice elements in a 3D scene. Currently the only supported shape is a plane.
-     * Example:
-     * ```
+     * The shape used to slice elements in a 3D scene. Currently the only supported shape is a
+     * [plane](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-SlicePlane.html).
+     *
+     * @example
+     * ```js
      * // Clone the shape to modify its properties
      * const shape = slice.shape.clone();
      * // Set new values for heading and tilt
@@ -93,7 +156,7 @@ export declare class ArcgisSlice extends LitElement {
      * * `slicing` - currently slicing
      * * `sliced` - finished slicing
      */
-    state: "ready" | "disabled" | "excludingLayer" | "sliced" | "slicing";
+    readonly state: "ready" | "disabled" | "excludingLayer" | "sliced" | "slicing";
     /**
      * Enable tilting the slice shape. If set to true, the slice shape will orient itself as best as
      * possible to the surface under the cursor when first placing the shape. If set to false, the slice shape is
@@ -103,17 +166,13 @@ export declare class ArcgisSlice extends LitElement {
      */
     tiltEnabled: boolean;
     /**
-     * Clear the [shape](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-slice/#shape) of the slice,
-     * effectively removing it from the view. Other properties like [excludedLayers](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-slice/#excludedLayers)
-     * and [excludeGroundSurface](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-slice/#excludeGroundSurface) are not modified.
+     * Clear the [shape](#shape) of the slice, effectively removing it from the view. Other properties like [excludedLayers](#excludedLayers)
+     * and [excludeGroundSurface](#excludeGroundSurface) are not modified.
      */
     clear(): Promise<void>;
     /** Permanently destroy the component. */
     destroy(): Promise<void>;
-    /**
-     * Start the interactive creation of a new slice, clearing the previous
-     * [shape](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-slice/#shape).
-     */
+    /** Start the interactive creation of a new slice, clearing the previous [shape](#shape). */
     start(): Promise<void>;
     /** Emitted when the value of a property is changed. Use this to listen to changes to properties. */
     readonly arcgisPropertyChange: TargetedEvent<this, {

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

@@ -14,7 +14,7 @@ import { g as m } from "../../chunks/globalCss.js";
 import { watch as H } from "@arcgis/core/core/reactiveUtils.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.3 */
+v4.34.0-next.31 */
 const O = E`@layer{arcgis-slice{display:block}.arcgis-slice__container{display:flex;padding:var(--esri-widget-padding-y) var(--esri-widget-padding-x);overflow-y:auto;--layer-item-background: var(--calcite-color-foreground-2)}.arcgis-slice__error{color:var(--calcite-color-status-danger)}.arcgis-slice__container,.arcgis-slice__hint{display:flex;flex-direction:column;gap:var(--calcite-spacing-md)}.arcgis-slice__error,.arcgis-slice__hint{overflow:hidden;animation:arcgis-slice-fade-in .25s ease-in-out}.arcgis-slice__error p,.arcgis-slice__hint p{margin:0;padding:0}.arcgis-slice__hint:not(:has(*)){display:none}.arcgis-slice__layer-item{--calcite-color-foreground-2: var(--layer-item-background);--calcite-color-foreground-1: var(--layer-item-background)}.arcgis-slice__actions{display:flex;flex-flow:column;gap:var(--calcite-spacing-xxs);justify-content:center}.arcgis-slice__actions:not(:has(*)){display:none}@keyframes arcgis-slice-fade-in{0%{opacity:0}25%{opacity:0}to{opacity:1}}}`;
 var B = Object.defineProperty, P = Object.getOwnPropertyDescriptor, o = (e, i, t, u) => {
   for (var c = u > 1 ? void 0 : u ? P(i, t) : i, y = e.length - 1, h; y >= 0; y--)
@@ -134,7 +134,7 @@ class N extends L {
     }, this.analysis = this.viewModel.analysis, this.autoDestroyDisabled = !1, this.excludeGroundSurface = this.viewModel.excludeGroundSurface, this.excludedLayers = this.viewModel.excludedLayers, this.headingLevel = 3, this.icon = "slice", this.position = "bottom-left", this.shape = this.viewModel.shape, this.state = this.viewModel.state, this.tiltEnabled = this.viewModel.tiltEnabled, this.arcgisPropertyChange = $()("analysis", "state"), this.arcgisReady = b();
   }
   static {
-    this.properties = { _hasVoxelLayers: 16, analysis: 0, autoDestroyDisabled: 5, excludeGroundSurface: 5, excludedLayers: 0, headingLevel: 9, icon: 3, label: 1, messageOverrides: 0, position: 1, referenceElement: 1, shape: 0, state: 3, tiltEnabled: 5 };
+    this.properties = { _hasVoxelLayers: 16, analysis: 0, autoDestroyDisabled: 5, excludeGroundSurface: 5, excludedLayers: 0, headingLevel: 9, icon: 3, label: 1, messageOverrides: 0, position: 1, referenceElement: 1, shape: 0, state: 35, tiltEnabled: 5 };
   }
   static {
     this.shadowRootOptions = M;

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

@@ -148,6 +148,11 @@ export declare class ArcgisSlider extends LitElement {
      * @default false
      */
     rangeLabelInputsEnabled: boolean;
+    /**
+     * 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;
     /**
      * The HTML Element nodes representing interactive slider segments.

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

@@ -7,7 +7,7 @@ import { m as g } from "../../chunks/useWidget.js";
 import { css as m } from "@lit/reactive-element/css-tag.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.3 */
+v4.34.0-next.31 */
 const c = m`@layer{arcgis-slider{min-width:200px;min-height:25px}}`, r = g(n);
 class d extends a {
   constructor() {

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

@@ -15,7 +15,7 @@ declare const useSwipeViewModel: (component: LitElement & Pick<SwipeViewModel, n
  * properties to determine what will be compared on either side of the component. If one of these properties
  * is not set, then the Swipe component will overlay the existing map.
  *
- * **Known Limitations**
+ * **Known limitations**
  *
  * - This component is not currently supported within a Scene component.
  *
@@ -74,7 +74,11 @@ export declare class ArcgisSwipe extends LitElement {
     label?: string;
     /** A collection of layers that will show on the left or top side of the Swipe component. */
     leadingLayers: __esri.Collection<__esri.Layer>;
-    /** Replace localized message strings with your own strings. **Warning**: individual message keys may change between releases. */
+    /**
+     * Replace localized message strings with your own strings.
+     *
+     * _**Note**: Individual message keys may change between releases._
+     */
     messageOverrides?: typeof this.messages._overrides;
     /** @default "manual" */
     position: __esri.UIPosition;
@@ -85,6 +89,11 @@ export declare class ArcgisSwipe extends LitElement {
      * @default 25
      */
     swipePosition: number;
+    /**
+     * 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;
     /**
      * The current state of the Swipe.

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

@@ -11,7 +11,7 @@ import { l as b } from "../../chunks/legacyIcon.js";
 import { css as A } from "@lit/reactive-element/css-tag.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.3 */
+v4.34.0-next.31 */
 const H = A`@layer{arcgis-swipe,.arcgis-swipe{position:absolute;margin:0;background:transparent!important;padding:0;width:100%;height:100%;overflow:hidden;user-select:none}.arcgis-swipe,.arcgis-ui .arcgis-swipe{pointer-events:none!important}.arcgis-swipe__container{position:absolute;z-index:1;margin:0;outline:0;border:0;padding:0;overflow:hidden;pointer-events:auto;touch-action:none;outline-color:transparent}.arcgis-swipe--horizontal .arcgis-swipe__container{margin-left:calc(var(--calcite-spacing-xxxl) / 2 * -1);cursor:col-resize;height:100%}.arcgis-swipe--vertical .arcgis-swipe__container{margin-top:calc(var(--calcite-spacing-xxxl) / 2 * -1);cursor:row-resize;width:100%}.arcgis-swipe--disabled .arcgis-swipe__container{cursor:default;pointer-events:none}.arcgis-swipe__divider{position:absolute;background-color:var(--calcite-color-background)}.arcgis-swipe--horizontal .arcgis-swipe__divider{top:0;left:calc(var(--calcite-spacing-xxxl) / 2);margin-left:calc(var(--calcite-border-width-lg) * .5 * -1);border-right:var(--calcite-border-width-sm) solid var(--calcite-color-border-1);border-left:var(--calcite-border-width-sm) solid var(--calcite-color-border-1);width:var(--calcite-border-width-lg);height:100%}.arcgis-swipe--vertical .arcgis-swipe__divider{top:calc(var(--calcite-spacing-xxxl) / 2);left:0;margin-top:calc(var(--calcite-border-width-lg) * .5 * -1);border-top:var(--calcite-border-width-sm) solid var(--calcite-color-border-1);border-bottom:var(--calcite-border-width-sm) solid var(--calcite-color-border-1);width:100%;height:var(--calcite-border-width-lg)}.arcgis-swipe__handle{display:flex;position:relative;align-items:center;justify-content:center;border:var(--calcite-border-width-sm) solid var(--calcite-color-border-1);border-radius:var(--calcite-corner-radius-round);background-color:var(--calcite-color-background);width:var(--calcite-spacing-xxxl);height:var(--calcite-spacing-xxxl);color:var(--calcite-color-border-input)}.arcgis-swipe__handle--hidden{visibility:hidden}.arcgis-swipe--vertical .arcgis-swipe__handle{rotate:90deg}.arcgis-swipe__handle-icon{position:relative;z-index:2}.arcgis-swipe--horizontal .arcgis-swipe__handle{top:calc(50% - calc(var(--calcite-spacing-xxxl) / 2))}.arcgis-swipe--vertical .arcgis-swipe__handle{left:calc(50% - calc(var(--calcite-spacing-xxxl) / 2))}.arcgis-swipe__container:focus .arcgis-swipe__handle,.arcgis-swipe__container:focus .arcgis-swipe__divider{outline:inset 2px var(--calcite-color-focus, var(--calcite-ui-focus-color, var(--calcite-color-brand)))}.arcgis-swipe__container:focus .arcgis-swipe__handle{outline-offset:calc(-2px*(1 - (2*clamp(0,var(--calcite-offset-invert-focus),1))))}}`, l = "arcgis-swipe", n = {
   base: l,
   baseDisabled: `${l}--disabled`,

package/dist/components/arcgis-table-list/customElement.d.ts

@@ -118,6 +118,11 @@ export declare class ArcgisTableList extends LitElement {
     minFilterItems: number;
     /** @default "bottom-left" */
     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;
     /**
      * A collection of selected [ListItem](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-TableList-ListItem.html)s representing table list items

package/dist/components/arcgis-table-list/customElement.js

@@ -8,7 +8,7 @@ import { css as h } from "@lit/reactive-element/css-tag.js";
 import { c as d } from "../../chunks/createCloseEvent.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.3 */
+v4.34.0-next.31 */
 const n = h`@layer{arcgis-table-list{display:block}}`, m = a(s);
 class c extends o {
   constructor() {

package/dist/components/arcgis-time-slider/customElement.d.ts

@@ -108,6 +108,11 @@ export declare class ArcgisTimeSlider extends LitElement {
     playRate: number;
     /** @default "bottom-left" */
     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;
     /**
      * The view model's state.

package/dist/components/arcgis-time-slider/customElement.js

@@ -8,7 +8,7 @@ import { css as d } from "@lit/reactive-element/css-tag.js";
 import { when as r } from "@arcgis/core/core/reactiveUtils.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.3 */
+v4.34.0-next.31 */
 const m = d`@layer{arcgis-time-slider{display:block}}`, c = n(o);
 class g extends a {
   constructor() {

package/dist/components/arcgis-time-zone-label/customElement.d.ts

@@ -49,7 +49,9 @@ export declare class ArcgisTimeZoneLabel extends LitElement {
      */
     expanded: boolean;
     /**
-     * Replace localized message strings with your own strings. **Warning**: individual message keys may change between releases.
+     * Replace localized message strings with your own strings.
+     *
+     * _**Note**: Individual message keys may change between releases._
      *
      * @property
      * ({ reflect: true })

package/dist/components/arcgis-time-zone-label/customElement.js

@@ -10,7 +10,7 @@ import { u as $ } from "../../chunks/useView.js";
 import { when as y, watch as z } from "@arcgis/core/core/reactiveUtils.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.3 */
+v4.34.0-next.31 */
 const D = f`@layer{.arcgis-time-zone-label{display:inline-flex;background-color:var(--calcite-color-foreground-1)}.arcgis-time-zone-label__badge{display:flex;padding-block:var(--calcite-spacing-sm);padding-inline:var(--calcite-spacing-sm);color:var(--calcite-color-text-1)}.arcgis-time-zone-label__badge--disabled{opacity:var(--calcite-opacity-disabled)}.arcgis-time-zone-label__badge--hidden{display:none}.arcgis-time-zone-label__badge-icon{align-self:center}.arcgis-time-zone-label__name{--calcite-color-background: transparent;--calcite-color-border-input: transparent;--calcite-font-weight-medium: normal;pointer-events:none}.arcgis-time-zone-label__name--hidden{display:none}.arcgis-time-zone-label__label{--calcite-label-margin-bottom: 0;align-items:center;padding-inline:var(--calcite-spacing-sm)}.arcgis-time-zone-label__label--disabled{opacity:var(--calcite-opacity-disabled)}.arcgis-time-zone-label__label--hidden{display:none}}`, t = "esri-time-zone-label", i = {
   base: t,
   badge: `${t}__badge`,

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

@@ -7,13 +7,18 @@ import { ArcgisReferenceElement } from '../../utils/component-utils';
 
 declare const useTrackViewModel: (component: LitElement & Pick<TrackViewModel, never> & import('../../controllers/useViewModel').ViewModelControllerUses<TrackViewModel>) => TrackViewModel;
 /**
- * The Track component is a button that animates the map or scene to the user's location when clicked.
- * The view rotates based on device heading.
- * The default heading symbol will display when speed is greater than zero and the browser provides heading information.
+ * The Track component is a button that when activated continuously animates the Map or Scene
+ * to the user's location as the user moves.
+ * The view rotates based on device heading, and the default heading symbol will display
+ * when speed is greater than zero and the browser provides heading information.
  *
- * **Known Limitations**
+ * This component uses the browser's [Geolocation API](https://developer.mozilla.org/en-US/docs/Web/API/Geolocation_API) which is only available in [secure contexts](https://developer.mozilla.org/en-US/docs/Web/Security/Secure_Contexts), such as HTTPS.
+ * Note that localhost is considered "potentially secure" and can be used for easy testing in browsers that support
+ * [Window.isSecureContext](https://developer.mozilla.org/en-US/docs/Web/API/isSecureContext#browser_compatibility).
  *
- * - The heading symbol is not currently supported within a Scene component.
+ * **Known limitations**
+ *
+ * - The heading symbol is not currently supported within a [Scene component](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/).
  *
  * [Read more...](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-track/)
  */
@@ -70,7 +75,11 @@ export declare class ArcgisTrack extends LitElement {
     icon?: string;
     /** The component's default label. */
     label?: string;
-    /** Replace localized message strings with your own strings. **Warning**: individual message keys may change between releases. */
+    /**
+     * Replace localized message strings with your own strings.
+     *
+     * _**Note**: Individual message keys may change between releases._
+     */
     messageOverrides?: typeof this.messages._overrides;
     /** @default "top-left" */
     position: __esri.UIPosition;
@@ -83,6 +92,11 @@ export declare class ArcgisTrack extends LitElement {
      * @default null
      */
     positionFilterFunction: Function | nullish;
+    /**
+     * 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;
     /**
      * Indicates whether the component will automatically rotate to the device heading based on
@@ -104,10 +118,11 @@ export declare class ArcgisTrack extends LitElement {
      */
     scale: number | nullish;
     /**
-     * The current state of the widget.
-     *
-     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Track-TrackViewModel.html#state)
+     * The current state of the component.
      *
+     * @name state
+     * @instance
+     * @type {"disabled" | "ready" | "tracking" | "waiting" | "feature-unsupported" | "error"}
      * @default "disabled"
      */
     readonly state: "ready" | "disabled" | "error" | "tracking" | "waiting" | "feature-unsupported";
@@ -121,7 +136,9 @@ export declare class ArcgisTrack extends LitElement {
     readonly tracking: boolean;
     /** Permanently destroy the component. */
     destroy(): Promise<void>;
+    /** Start tracking the user's location. Only start the component on a user gesture such as a click event. */
     start(): Promise<void>;
+    /** Stop tracking the user's location. */
     stop(): Promise<void>;
     readonly arcgisComplete: TargetedEvent<this, __esri.TrackViewModelTrackEvent>;
     readonly arcgisError: TargetedEvent<this, __esri.TrackViewModelTrackErrorEvent>;

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

@@ -11,7 +11,7 @@ import { g as c } from "../../chunks/globalCss.js";
 import { css as T } from "@lit/reactive-element/css-tag.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.3 */
+v4.34.0-next.31 */
 const y = T`@layer{arcgis-track{display:block}}`, $ = {
   base: "esri-track"
 }, D = b(v);

package/dist/components/arcgis-unit-select/customElement.d.ts

@@ -15,7 +15,11 @@ export declare class ArcgisUnitSelect<Unit extends UnitUnion = UnitUnion> extend
     options: Unit[];
     selectLabel: string;
     value: Unit;
-    /** Replace localized message strings with your own strings. **Warning**: individual message keys may change between releases. */
+    /**
+     * Replace localized message strings with your own strings.
+     *
+     * _**Note**: Individual message keys may change between releases._
+     */
     messageOverrides?: typeof this.messages._overrides;
     label?: string;
     /** Permanently destroy the component. */

package/dist/components/arcgis-unit-select/customElement.js

@@ -6,7 +6,7 @@ import { LitElement as g, createEvent as u, safeClassMap as p } from "@arcgis/lu
 import { css as h } from "@lit/reactive-element/css-tag.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.3 */
+v4.34.0-next.31 */
 const b = h`.arcgis-unit-select{width:100%}.arcgis-unit-select__label{--calcite-label-margin-bottom: 0;width:100%}`, $ = "arcgis-unit-select", d = {
   label: `${$}__label`
 };

package/dist/components/arcgis-utility-network-associations/customElement.d.ts

@@ -32,8 +32,6 @@ declare const useUtilityNetworkAssociationsWidget: (component: LitElement & Pick
  *
  * > The Utility Network Associations component does not support proxied feature services or feature services that utilize stored credentials.
  *
- * Note: Sign in to access the data in this sample, U/P: `viewer01`/`I68VGU^nMurF`
- *
  * [Read more...](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-utility-network-associations/)
  */
 export declare class ArcgisUtilityNetworkAssociations extends LitElement {
@@ -105,6 +103,11 @@ export declare class ArcgisUtilityNetworkAssociations extends LitElement {
     maxAllowableAssociationsSliderStep: number;
     /** @default "bottom-left" */
     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;
     /**
      * Indicates whether to show arrows for connectivity associations.
@@ -140,77 +143,77 @@ export declare class ArcgisUtilityNetworkAssociations extends LitElement {
     /** @default false */
     showConnectivityAssociationsSettingsArrowsToggle: boolean;
     /**
-     * @deprecated since 4.32. Use hideConnectivityAssociationsSettingsArrowsToggle instead
+     * @deprecated since 4.32, use hideConnectivityAssociationsSettingsArrowsToggle instead
      * @default false
      */
     visibleElementsConnectivityAssociationsSettingsArrowsToggle: boolean;
     /** @default false */
     showConnectivityAssociationsSettingsCapSelect: boolean;
     /**
-     * @deprecated since 4.32. Use hideConnectivityAssociationsSettingsCapSelect instead
+     * @deprecated since 4.32, use hideConnectivityAssociationsSettingsCapSelect instead
      * @default false
      */
     visibleElementsConnectivityAssociationsSettingsCapSelect: boolean;
     /** @default false */
     hideConnectivityAssociationsSettingsColorPicker: boolean;
     /**
-     * @deprecated since 4.32. Use hideConnectivityAssociationsSettingsColorPicker instead
+     * @deprecated since 4.32, use hideConnectivityAssociationsSettingsColorPicker instead
      * @default true
      */
     visibleElementsConnectivityAssociationsSettingsColorPicker: boolean;
     /** @default false */
     hideConnectivityAssociationsSettingsStylePicker: boolean;
     /**
-     * @deprecated since 4.32. Use hideConnectivityAssociationsSettingsStylePicker instead
+     * @deprecated since 4.32, use hideConnectivityAssociationsSettingsStylePicker instead
      * @default true
      */
     visibleElementsConnectivityAssociationsSettingsStylePicker: boolean;
     /** @default false */
     hideConnectivityAssociationsSettingsWidthInput: boolean;
     /**
-     * @deprecated since 4.32. Use hideConnectivityAssociationsSettingsWidthInput instead
+     * @deprecated since 4.32, use hideConnectivityAssociationsSettingsWidthInput instead
      * @default true
      */
     visibleElementsConnectivityAssociationsSettingsWidthInput: boolean;
     /** @default false */
     showMaxAllowableAssociationsSlider: boolean;
     /**
-     * @deprecated since 4.32. Use hideMaxAllowableAssociationsSlider instead
+     * @deprecated since 4.32, use hideMaxAllowableAssociationsSlider instead
      * @default false
      */
     visibleElementsMaxAllowableAssociationsSlider: boolean;
     /** @default false */
     showStructuralAttachmentAssociationsSettingsArrowsToggle: boolean;
     /**
-     * @deprecated since 4.32. Use hideStructuralAttachmentAssociationsSettingsArrowsToggle instead
+     * @deprecated since 4.32, use hideStructuralAttachmentAssociationsSettingsArrowsToggle instead
      * @default false
      */
     visibleElementsStructuralAttachmentAssociationsSettingsArrowsToggle: boolean;
     /** @default false */
     showStructuralAttachmentAssociationsSettingsCapSelect: boolean;
     /**
-     * @deprecated since 4.32. Use hideStructuralAttachmentAssociationsSettingsCapSelect instead
+     * @deprecated since 4.32, use hideStructuralAttachmentAssociationsSettingsCapSelect instead
      * @default false
      */
     visibleElementsStructuralAttachmentAssociationsSettingsCapSelect: boolean;
     /** @default false */
     hideStructuralAttachmentAssociationsSettingsColorPicker: boolean;
     /**
-     * @deprecated since 4.32. Use hideStructuralAttachmentAssociationsSettingsColorPicker instead
+     * @deprecated since 4.32, use hideStructuralAttachmentAssociationsSettingsColorPicker instead
      * @default true
      */
     visibleElementsStructuralAttachmentAssociationsSettingsColorPicker: boolean;
     /** @default false */
     hideStructuralAttachmentAssociationsSettingsStylePicker: boolean;
     /**
-     * @deprecated since 4.32. Use hideStructuralAttachmentAssociationsSettingsStylePicker instead
+     * @deprecated since 4.32, use hideStructuralAttachmentAssociationsSettingsStylePicker instead
      * @default true
      */
     visibleElementsStructuralAttachmentAssociationsSettingsStylePicker: boolean;
     /** @default false */
     hideStructuralAttachmentAssociationsSettingsWidthInput: boolean;
     /**
-     * @deprecated since 4.32. Use hideStructuralAttachmentAssociationsSettingsWidthInput instead
+     * @deprecated since 4.32, use hideStructuralAttachmentAssociationsSettingsWidthInput instead
      * @default true
      */
     visibleElementsStructuralAttachmentAssociationsSettingsWidthInput: boolean;