npm - @arcgis/core - Versions diffs - 5.2.0-next.156 → 5.2.0-next.158 - Mend

@arcgis/core 5.2.0-next.156 → 5.2.0-next.158

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (417) hide show

package/views/interactive/options/TooltipOptions.d.ts CHANGED Viewed

@@ -90,6 +90,8 @@ export interface TooltipOptionsProperties extends Partial<Pick<TooltipOptions, "
  * `Esc` | Closes the input mode but keeps any applied constraints. |
  * Left-click-drag (on tooltip header) | Allows to change the position of the tooltip in input mode. |
  *
+ * Numeric inputs accept simple math expressions with two values and one operator: `+`, `-`, `*`, or `/`.
+ *
  * @since 5.2
  * @see [LabelOptions](https://developers.arcgis.com/javascript/latest/references/core/views/interactive/options/LabelOptions/)
  * @see [ValueOptions](https://developers.arcgis.com/javascript/latest/references/core/views/interactive/options/ValueOptions/)

package/views/interactive/sketch/SketchTooltipOptions.d.ts CHANGED Viewed

@@ -69,6 +69,8 @@ export interface SketchTooltipOptionsProperties extends TooltipOptionsProperties
  * `Esc` | Closes the input mode but keeps any applied constraints. |
  * Left-click-drag (on tooltip header) | Allows to change the position of the tooltip in input mode. |
  *
+ * Numeric inputs accept simple math expressions with two values and one operator: `+`, `-`, `*`, or `/`.
+ *
  * @deprecated since 5.2. Use [TooltipOptions](https://developers.arcgis.com/javascript/latest/references/core/views/interactive/options/TooltipOptions/) instead.
  * @since 4.24
  * @see [Sketch](https://developers.arcgis.com/javascript/latest/references/core/widgets/Sketch/)

package/views/interactive/snapping/SnappingManagerPool.js CHANGED Viewed

@@ -1,2 +1,2 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import{makeHandle as e}from"../../../core/handleUtils.js";import{nextTick as t}from"../../../core/nextTick.js";import{watch as n,syncAndInitial as r}from"../../../core/reactiveUtils.js";import{makeAllLayerSnappingOptions as i}from"./allLayerSnapping.js";import{SnappingManager as a}from"./SnappingManager.js";import o from"./SnappingOptions.js";const s=new Map;function c(t){if(!s.has(t)){let e=i(t,{distance:10,excludeInternal:!0}),c=new o,l=n(()=>{let n=t.options.snapping,r=e.options,i=n.featureSources;return{...r.toJSON(),...n.toJSON({origin:`service`}),featureSources:n.originOf(`featureSources`)===`defaults`?r.featureSources:i}},e=>c.set(e),r),u=new a({view:t,options:c});s.set(t,{referenceCount:0,snappingManager:u,remove:()=>{l.remove(),e.remove(),u.destroy()}})}let c=s.get(t);c.referenceCount++;let u=e(()=>l(t,c));return{snappingManager:c.snappingManager,...u}}function l(e,n){n.referenceCount--,!(n.referenceCount>0)&&t(()=>{n.referenceCount===0&&(n.remove(),s.delete(e))})}export{c as acquire};
+import{makeHandle as e}from"../../../core/handleUtils.js";import{nextTick as t}from"../../../core/nextTick.js";import{makeAllLayerSnappingOptions as n,makePointPlacementSnappingOptions as r}from"./allLayerSnapping.js";import{SnappingManager as i}from"./SnappingManager.js";const a=new Map,o=new Map;function s(e){return l(e,a,r)}function c(e){return l(e,o,n)}function l(t,n,r){if(!n.has(t)){let e=r(t),a=new i({view:t,options:e.options});n.set(t,{referenceCount:0,snappingManager:a,remove:()=>{e.remove(),a.destroy()}})}let a=n.get(t);return a.referenceCount++,{snappingManager:a.snappingManager,...e(()=>u(t,n,a))}}function u(e,n,r){r.referenceCount--,!(r.referenceCount>0)&&t(()=>{r.referenceCount===0&&(r.remove(),n.delete(e))})}export{s as acquireForFeaturePlacement,c as acquireForViewOptions};

package/views/interactive/snapping/allLayerSnapping.js CHANGED Viewed

@@ -1,2 +1,2 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import e from"../../../core/Collection.js";import{makeHandle as t,destroyHandle as n}from"../../../core/handleUtils.js";import{mapCollection as r}from"../../../core/mapCollectionUtils.js";import{watch as i,syncAndInitial as a}from"../../../core/reactiveUtils.js";import o from"./FeatureSnappingLayerSource.js";import{defaults as s}from"./Settings.js";import c from"./SnappingOptions.js";const l=e.ofType(o);function u(e,u){let d=u?.excludeInternal?()=>e.map?.allLayers.filter(e=>!(`internal`in e)||!e.internal):()=>e.map?.allLayers,f=r(d,e=>new o({layer:e}),{recycleItems:!0,createCollection:()=>new l}),p=new c({enabled:!0,selfEnabled:u?.selfEnabled??!1,featureEnabled:!0,featureSources:f,distance:u?.distance??s.distance,touchSensitivityMultiplier:u?.touchSensitivityMultiplier??s.touchSensitivityMultiplier}),m=new c,h=i(()=>{let t=e.options.snapping;return{...p.toJSON(),...t.toJSON({origin:`service`}),featureSources:t.originOf(`featureSources`)===`defaults`?f:t.featureSources}},e=>m.set(e),a);return{...t(()=>{h.remove(),n(f).remove()}),options:m}}export{u as makeAllLayerSnappingOptions};
+import e from"../../../core/Collection.js";import{makeHandle as t,destroyHandle as n}from"../../../core/handleUtils.js";import{mapCollection as r}from"../../../core/mapCollectionUtils.js";import{watch as i,syncAndInitial as a}from"../../../core/reactiveUtils.js";import o from"../options/SnappingOptions.js";import s from"./FeatureSnappingLayerSource.js";const c=e.ofType(s);function l(e){return f(e)}function u(e){return f(e,{enabled:!0})}function d(e){return f(e,{enabled:!0,selfEnabled:!1,distance:10})}function f(e,l){let u=r(()=>e.map?.allLayers.filter(e=>!(`internal`in e)||!e.internal),e=>new s({layer:e}),{recycleItems:!0,createCollection:()=>new c}),d=l?new o(l):null,f=new o,p=i(()=>{let t=e.options.snapping,n=t.featureSources;return{...d?.toJSON(),...d?t.toJSON({origin:`service`}):t.toJSON(),featureSources:t.originOf(`featureSources`)===`defaults`?u:n}},e=>f.set(e),a);return{...t(()=>{p.remove(),n(u).remove()}),options:f}}export{l as makeAllLayerSnappingOptions,u as makeGeometryAnalysisSnappingOptions,d as makePointPlacementSnappingOptions};

package/views/layers/LineOfSightLayerView.d.ts CHANGED Viewed

@@ -28,23 +28,35 @@ export interface LineOfSightLayerViewProperties extends LayerViewProperties, Par
  * const layerView = await view.whenLayerView(lineOfSightLayer);
  * ```
  *
+ * > [!WARNING]
+ * >
+ * > **Things to consider:**
+ * > * Snapping, tooltips, display units, and input units used during interactive placement and editing are inherited from
+ * [ViewOptions](https://developers.arcgis.com/javascript/latest/references/core/views/interactive/options/ViewOptions/).
+ * >   * Snapping is enabled by default. This can be temporarily disabled by holding the `CTRL` key.
+ * >   * Layer types currently supported for snapping are: [FeatureLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/FeatureLayer/), [GraphicsLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/GraphicsLayer/) (except Mesh geometries),
+ * > [GeoJSONLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/GeoJSONLayer/), [WFSLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/WFSLayer/), [CSVLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/CSVLayer/),
+ * > [3D Object SceneLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/SceneLayer/), and [BuildingSceneLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/BuildingSceneLayer/).
+ *
  * @see [LineOfSightLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/LineOfSightLayer/)
  * @see [LineOfSightAnalysis](https://developers.arcgis.com/javascript/latest/references/core/analysis/LineOfSightAnalysis/)
  * @see [LineOfSightAnalysisTarget](https://developers.arcgis.com/javascript/latest/references/core/analysis/LineOfSightAnalysisTarget/)
  * @see [LineOfSightAnalysisObserver](https://developers.arcgis.com/javascript/latest/references/core/analysis/LineOfSightAnalysisObserver/)
  * @see [LineOfSightAnalysisView3D](https://developers.arcgis.com/javascript/latest/references/core/views/3d/analysis/LineOfSightAnalysisView3D/)
+ * @see [ViewOptions](https://developers.arcgis.com/javascript/latest/references/core/views/interactive/options/ViewOptions/)
  * @see [Line Of Sight component](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-line-of-sight/)
  * @see [Async cancellation with AbortController](https://developers.arcgis.com/javascript/latest/async-cancellation-with-abortcontroller/)
  */
 export default abstract class LineOfSightLayerView extends LayerView {
   /**
-   * Enables interactivity for the [layer](https://developers.arcgis.com/javascript/latest/references/core/views/layers/LineOfSightLayerView/#layer). When set to `true`, manipulators will be displayed,
-   * allowing users to click and drag to edit the layer's
-   * [LineOfSightLayer.analysis](https://developers.arcgis.com/javascript/latest/references/core/layers/LineOfSightLayer/#analysis) if it has a valid
-   * [LineOfSightAnalysis.observer](https://developers.arcgis.com/javascript/latest/references/core/analysis/LineOfSightAnalysis/#observer) and
-   * [LineOfSightAnalysis.targets](https://developers.arcgis.com/javascript/latest/references/core/analysis/LineOfSightAnalysis/#targets). Right-clicking a target will remove it.
+   * Enables interactivity for the [layer](https://developers.arcgis.com/javascript/latest/references/core/views/layers/LineOfSightLayerView/#layer).
+   * When set to `true`, and the layer includes a valid [LineOfSightLayer.observer](https://developers.arcgis.com/javascript/latest/references/core/layers/LineOfSightLayer/#observer) and any
+   * [LineOfSightLayer.targets](https://developers.arcgis.com/javascript/latest/references/core/layers/LineOfSightLayer/#targets), they become selectable and editable and the manipulators will be displayed.
+   *
+   * Targets can be removed by right-clicking on them or with the `Delete` key.
+   * The observer and the last target cannot be deleted interactively.
    *
-   * This property is automatically set to `true` when the analysis is assigned to a
+   * This property is automatically set to `true` when the [LineOfSightLayer.analysis](https://developers.arcgis.com/javascript/latest/references/core/layers/LineOfSightLayer/#analysis) is assigned to a
    * [Line Of Sight component](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-line-of-sight/).
    *
    * @default false
@@ -72,20 +84,26 @@ export default abstract class LineOfSightLayerView extends LayerView {
    */
   get results(): Collection<LineOfSightAnalysisResult | null | undefined>;
   /**
-   * Starts the interactive placement of an observer and/or targets on the [layer](https://developers.arcgis.com/javascript/latest/references/core/views/layers/LineOfSightLayerView/#layer)'s
+   * Starts the interactive placement of an observer and targets on the [layer](https://developers.arcgis.com/javascript/latest/references/core/views/layers/LineOfSightLayerView/#layer)'s
    * [LineOfSightLayer.analysis](https://developers.arcgis.com/javascript/latest/references/core/layers/LineOfSightLayer/#analysis).
    *
-   * If the analysis does not have a valid observer yet, this method will allow placing an observer, which can be followed
-   * by zero or more targets. Otherwise, if it already has a valid observer, it will allow placing targets.
+   * If the layer does not have a valid [LineOfSightLayer.observer](https://developers.arcgis.com/javascript/latest/references/core/layers/LineOfSightLayer/#observer) yet, this method will allow placing an observer,
+   * which can be followed by zero or more targets. Otherwise, if it already has a valid observer, it will allow placing targets.
+   * An observer is valid when it has a position. Placing an observer without any targets is a productive operation.
    *
-   * The placement operation will finish when the user presses the escape key.
+   * The placement operation will finish when the user presses the escape key. Pressing escape after placing an observer
+   * or target finalizes a productive operation. Pressing escape before a valid observer is placed rejects the promise.
    * To stop the placing programmatically, pass an abort signal as an argument when calling the method.
-   * The promise resolves when the operation is productive, i.e. an oberver or any targets were added.
+   * The promise resolves when the operation is productive, i.e. an observer or any targets were added.
    * Otherwise, if nothing was added or signal was aborted, the promise is rejected.
    *
+   * By default, the observer and targets are created at absolute height.
+   * Optionally, by specifying the options of the method,
+   * you can change the [elevation info](https://developers.arcgis.com/javascript/latest/references/core/symbols/support/ElevationInfo/).
+   *
    * Calling this method sets [interactive](https://developers.arcgis.com/javascript/latest/references/core/views/layers/LineOfSightLayerView/#interactive) to `true`.
    *
-   * @param options - Additional placement options, including elevation information and an abort signal.
+   * @param options - An object specifying additional placement options, including elevation information and an abort signal.
    * @returns A promise
    * which resolves when the operation is completed successfully - i.e. the user places an observer and/or target(s),
    * leaving the analysis in a valid state. Otherwise, the promise is rejected.
@@ -94,7 +112,11 @@ export default abstract class LineOfSightLayerView extends LayerView {
    * const abortController = new AbortController();
    *
    * try {
-   *   await layerView.place({ signal: abortController.signal });
+   *  await layerView.place({
+   *     signal: abortController.signal,
+   *     // optional elevation info
+   *     elevationInfo: { mode: "relative-to-ground", offset: 1.5 },
+   *   });
    * } catch (error) {
    *   if (error.name === "AbortError") {
    *     console.log("Placement operation was cancelled.");

package/views/layers/SketchLayerView.d.ts CHANGED Viewed

@@ -10,6 +10,7 @@ import type { LayerViewHighlightOptions } from "./types.js";
  * Represents the view of a [SketchLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/SketchLayer/) in a [MapView](https://developers.arcgis.com/javascript/latest/references/core/views/MapView/).
  *
  * @since 5.2
+ * @beta
  * @see [SketchLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/SketchLayer/)
  */
 export default abstract class SketchLayerView extends LayerView {

package/views/layers/ViewshedLayerView.d.ts CHANGED Viewed

@@ -15,7 +15,7 @@ export interface ViewshedLayerViewProperties extends LayerViewProperties, Partia
  *
  * It allows to create new viewsheds interactively using the [place()](https://developers.arcgis.com/javascript/latest/references/core/views/layers/ViewshedLayerView/#place) method,
  * or to make existing viewsheds selectable and editable by enabling the [interactive](https://developers.arcgis.com/javascript/latest/references/core/views/layers/ViewshedLayerView/#interactive) property.
- * To select a viewshed, hover and click on any of its manipulators.
+ * To select a viewshed, hover and click on its observer.
  *
  * The view for the layer can be retrieved using [SceneView.whenLayerView()](https://developers.arcgis.com/javascript/latest/references/core/views/SceneView/#whenLayerView).
  *
@@ -28,6 +28,16 @@ export interface ViewshedLayerViewProperties extends LayerViewProperties, Partia
  * const layerView = await view.whenLayerView(viewshedLayer);
  * ```
  *
+ * > [!WARNING]
+ * >
+ * > **Things to consider:**
+ * > * Snapping, tooltips, display units, and input units used during interactive placement and editing are inherited from
+ * [ViewOptions](https://developers.arcgis.com/javascript/latest/references/core/views/interactive/options/ViewOptions/).
+ * >   * Snapping is enabled by default. This can be temporarily disabled by holding the `CTRL` key.
+ * >   * Layer types currently supported for snapping are: [FeatureLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/FeatureLayer/), [GraphicsLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/GraphicsLayer/) (except Mesh geometries),
+ * > [GeoJSONLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/GeoJSONLayer/), [WFSLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/WFSLayer/), [CSVLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/CSVLayer/),
+ * > [3D Object SceneLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/SceneLayer/), and [BuildingSceneLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/BuildingSceneLayer/).
+ *
  * @since 4.31
  * @see [ViewshedLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/ViewshedLayer/)
  * @see [Viewshed](https://developers.arcgis.com/javascript/latest/references/core/analysis/Viewshed/)
@@ -39,8 +49,10 @@ export interface ViewshedLayerViewProperties extends LayerViewProperties, Partia
 export default abstract class ViewshedLayerView extends LayerView {
   /**
    * Enables interactivity for the [layer](https://developers.arcgis.com/javascript/latest/references/core/views/layers/ViewshedLayerView/#layer). When set to `true` and the layer's
-   * [ViewshedLayer.source](https://developers.arcgis.com/javascript/latest/references/core/layers/ViewshedLayer/#source) includes any
-   * valid [ViewshedAnalysis.viewsheds](https://developers.arcgis.com/javascript/latest/references/core/analysis/ViewshedAnalysis/#viewsheds), they become selectable and editable.
+   * [ViewshedLayer.source](https://developers.arcgis.com/javascript/latest/references/core/layers/ViewshedLayer/#source) includes any valid [viewsheds](https://developers.arcgis.com/javascript/latest/references/core/analysis/Viewshed/),
+   * they become selectable and editable.
+   *
+   * Viewsheds can be removed with the `Delete` key.
    *
    * @default false
    */
@@ -55,19 +67,23 @@ export default abstract class ViewshedLayerView extends LayerView {
    */
   accessor selectedViewshed: Viewshed | null | undefined;
   /**
-   * Starts the interactive creation of new viewsheds and adds them to the layer
-   * [ViewshedLayer.source](https://developers.arcgis.com/javascript/latest/references/core/layers/ViewshedLayer/#source).
+   * Starts the interactive creation of new viewsheds and adds them to the
+   * [ViewshedLayer.source](https://developers.arcgis.com/javascript/latest/references/core/layers/ViewshedLayer/#source) of the associated [layer](https://developers.arcgis.com/javascript/latest/references/core/views/layers/ViewshedLayerView/#layer).
    *
-   * The first click in the scene places the observer point and the second sets the viewshed's orientation.
+   * The first click in the scene places the observer point and the second sets the viewshed's orientation and distance.
    *
    * The creation process will finish when the user double-clicks the mouse or presses the escape key.
    * To stop the creation programmatically, pass an abort signal as an argument when calling the method.
    *
    * This method is similar to the [place()](https://developers.arcgis.com/javascript/latest/references/core/views/layers/ViewshedLayerView/#place) method, but it allows to create multiple viewsheds in a row.
    *
+   * By default, the observer is created at absolute height.
+   * Optionally, by specifying the options of the method,
+   * you can change the [elevation info](https://developers.arcgis.com/javascript/latest/references/core/symbols/support/ElevationInfo/).
+   *
    * Calling this method sets [interactive](https://developers.arcgis.com/javascript/latest/references/core/views/layers/ViewshedLayerView/#interactive) to `true`.
    *
-   * @param options - Additional placement options, including elevation information and an abort signal.
+   * @param options - An object specifying additional placement options, including elevation information and an abort signal.
    * @returns A promise which resolves when creation is completed successfully or rejected if it is
    * canceled.
    * @example
@@ -86,17 +102,21 @@ export default abstract class ViewshedLayerView extends LayerView {
    */
   createViewsheds(options?: ViewshedPlacementOptions | null | undefined): Promise<void>;
   /**
-   * Starts the interactive placement of a single viewshed, adding it to the [layer](https://developers.arcgis.com/javascript/latest/references/core/views/layers/ViewshedLayerView/#layer)'s
-   * [ViewshedLayer.source](https://developers.arcgis.com/javascript/latest/references/core/layers/ViewshedLayer/#source).
+   * Starts the interactive placement of a single viewshed, adding it to the
+   * [ViewshedLayer.source](https://developers.arcgis.com/javascript/latest/references/core/layers/ViewshedLayer/#source) of the associated [layer](https://developers.arcgis.com/javascript/latest/references/core/views/layers/ViewshedLayerView/#layer).
    *
-   * The first click in the scene places the observer point and the second sets the viewshed's orientation.
+   * The first click in the scene places the observer point and the second sets the viewshed's orientation and distance.
    *
    * The placement operation will finish when the user presses the escape key.
    * To stop the placing programmatically, pass an abort signal as an argument when calling the method.
    *
+   * By default, the observer is created at absolute height.
+   * Optionally, by specifying the options of the method,
+   * you can change the [elevation info](https://developers.arcgis.com/javascript/latest/references/core/symbols/support/ElevationInfo/).
+   *
    * Calling this method sets [interactive](https://developers.arcgis.com/javascript/latest/references/core/views/layers/ViewshedLayerView/#interactive) to `true`.
    *
-   * @param options - Additional placement options, including elevation information and an abort signal.
+   * @param options - An object specifying additional placement options, including elevation information and an abort signal.
    * @returns A promise which
    * resolves when the operation is completed successfully or rejected if it is canceled.
    * @since 4.33
@@ -104,7 +124,11 @@ export default abstract class ViewshedLayerView extends LayerView {
    * const abortController = new AbortController();
    *
    * try {
-   *   await viewshedLayerView.place({ signal: abortController.signal });
+   *  await layerView.place({
+   *     signal: abortController.signal,
+   *     // optional elevation info
+   *     elevationInfo: { mode: "relative-to-ground", offset: 1.5 },
+   *   });
    * } catch (error) {
    *   if (error.name === "AbortError") {
    *     console.log("Placement operation was cancelled.");

package/widgets/AreaMeasurement2D/AreaMeasurement2DViewModel.d.ts CHANGED Viewed

@@ -5,6 +5,7 @@ import type { SystemOrAreaUnit } from "../../core/units.js";
 import type { AreaMeasurement, AreaMeasurementLabel, MeasurementState } from "../types.js";
 import type { SnappingOptionsProperties } from "../../views/interactive/snapping/SnappingOptions.js";
+/** @deprecated since 5.2. Use the [Area Measurement 2D component](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-area-measurement-2d/) directly or [AreaMeasurementAnalysis](https://developers.arcgis.com/javascript/latest/references/core/analysis/AreaMeasurementAnalysis/) instead. */
 export interface AreaMeasurement2DViewModelProperties extends Partial<Pick<AreaMeasurement2DViewModel, "view">> {
   /**
    * The [SnappingOptions](https://developers.arcgis.com/javascript/latest/references/core/views/interactive/snapping/SnappingOptions/) for sketching.
@@ -47,7 +48,7 @@ export interface AreaMeasurement2DViewModelProperties extends Partial<Pick<AreaM
 }
 /**
- * Provides the logic for the [AreaMeasurement2D](https://developers.arcgis.com/javascript/latest/references/core/widgets/AreaMeasurement2D/) widget and [component](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-area-measurement-2d/).
+ * Provides the logic for the [AreaMeasurement2D](https://developers.arcgis.com/javascript/latest/references/core/widgets/AreaMeasurement2D/) widget.
  *
  * @deprecated since version 5.2. Use the [Area Measurement 2D component](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-area-measurement-2d/) directly or [AreaMeasurementAnalysis](https://developers.arcgis.com/javascript/latest/references/core/analysis/AreaMeasurementAnalysis/) instead.
  * @since 4.10

package/widgets/BasemapToggle/BasemapToggleViewModel.d.ts CHANGED Viewed

@@ -3,6 +3,7 @@ import type Accessor from "../../core/Accessor.js";
 import type { BasemapProperties } from "../../Basemap.js";
 import type { MapViewOrSceneView } from "../../views/MapViewOrSceneView.js";
+/** @deprecated since 5.2. Use the Basemap Toggle component's [`nextBasemap`](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-basemap-toggle/#nextBasemap) and [`view`](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-basemap-toggle/#view) properties instead. */
 export interface BasemapToggleViewModelProperties extends Partial<Pick<BasemapToggleViewModel, "view">> {
   /**
    * The next basemap for toggling. One of the following values may be set to this property:
@@ -13,6 +14,7 @@ export interface BasemapToggleViewModelProperties extends Partial<Pick<BasemapTo
   nextBasemap?: BasemapProperties | string | null;
 }
+/** @deprecated since 5.2. Use the Basemap Toggle component's [`state`](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-basemap-toggle/#state) property instead. */
 export type BasemapToggleViewModelState = "ready" | "incompatible-next-basemap" | "loading" | "disabled";
 /**

package/widgets/DistanceMeasurement2D/DistanceMeasurement2DViewModel.d.ts CHANGED Viewed

@@ -5,6 +5,7 @@ import type { SystemOrLengthUnit } from "../../core/units.js";
 import type { LinearMeasurement, MeasurementState } from "../types.js";
 import type { SnappingOptionsProperties } from "../../views/interactive/snapping/SnappingOptions.js";
+/** @deprecated since 5.2. Use the [Distance Measurement 2D component](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-distance-measurement-2d/) directly or [DistanceMeasurementAnalysis](https://developers.arcgis.com/javascript/latest/references/core/analysis/DistanceMeasurementAnalysis/) instead. */
 export interface DistanceMeasurement2DViewModelProperties extends Partial<Pick<DistanceMeasurement2DViewModel, "view">> {
   /**
    * The [SnappingOptions](https://developers.arcgis.com/javascript/latest/references/core/views/interactive/snapping/SnappingOptions/) for sketching.
@@ -47,7 +48,7 @@ export interface DistanceMeasurement2DViewModelProperties extends Partial<Pick<D
 }
 /**
- * Provides the logic for the [DistanceMeasurement2D](https://developers.arcgis.com/javascript/latest/references/core/widgets/DistanceMeasurement2D/) widget and [component](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-distance-measurement-2d/).
+ * Provides the logic for the [DistanceMeasurement2D](https://developers.arcgis.com/javascript/latest/references/core/widgets/DistanceMeasurement2D/) widget.
  *
  * @deprecated since version 5.2. Use the [Distance Measurement 2D component](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-distance-measurement-2d/) directly or [DistanceMeasurementAnalysis](https://developers.arcgis.com/javascript/latest/references/core/analysis/DistanceMeasurementAnalysis/) instead.
  * @since 4.10

package/widgets/Expand/ExpandViewModel.d.ts CHANGED Viewed

@@ -1,8 +1,10 @@
 import type Accessor from "../../core/Accessor.js";
 import type { MapViewOrSceneView } from "../../views/MapViewOrSceneView.js";
+/** @deprecated since 5.2. Use the [Expand component](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-expand/) instead. */
 export interface ExpandViewModelProperties extends Partial<Pick<ExpandViewModel, "autoCollapse" | "expanded" | "group" | "view">> {}
+/** @deprecated since 5.2. Use the Expand component's [`state`](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-expand/#state) property instead. */
 export type ExpandViewModelState = "ready" | "disabled";
 /**

package/widgets/FeatureTable/support/FeatureStore.js CHANGED Viewed

@@ -1,2 +1,2 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import{__decorate as e}from"tslib";import t from"../../../Graphic.js";import n from"../../../core/Accessor.js";import{equals as r,isSome as i}from"../../../core/arrayUtils.js";import{createTask as a}from"../../../core/asyncUtils.js";import o from"../../../core/Collection.js";import s from"../../../core/Error.js";import{clone as c}from"../../../core/lang.js";import l from"../../../core/Logger.js";import{getOrCreateMapValue as u}from"../../../core/MapUtils.js";import{removeMaybe as d,abortMaybe as f}from"../../../core/maybe.js";import{debounce as p,ignoreAbortErrors as m,throwIfAborted as h}from"../../../core/promiseUtils.js";import g from"../../../core/ReactiveMap.js";import{watch as _,when as v,syncAndInitial as y,sync as b}from"../../../core/reactiveUtils.js";import{property as x,subclass as S}from"../../../core/accessorSupport/decorators.js";import{isInEffectiveScaleRange as C}from"../../../geometry/support/scaleUtils.js";import{geometryTypes as w}from"../../../geometry/support/typeUtils.js";import{isFeatureLayer as T,isSubtypeGroupLayer as E,isSubtypeSublayer as D}from"../../../layers/support/layerUtils.js";import{combineTimeExtent as O}from"../../../layers/support/timeSupport.js";import k from"../../../rest/support/AttachmentQuery.js";import A from"../../../rest/support/RelationshipQuery.js";import j from"../../../time/TimeExtent.js";import M from"../../../views/SelectionManager.js";import{temporaryHighlightName as N}from"../../../views/support/HighlightDefaults.js";import{highlightsSupported as P}from"../../../views/support/layerViewUtils.js";import{isSelectableLayerWithObjectIds as F,isSelectableLayer as I}from"../../../views/support/selectionUtils.js";import{isIFeatureTableSupportedLayerWithAttachments as L,isIFeatureTableSupportedLayerWithAttachmentsEditing as R,isIFeatureTableSupportedLayerWithEditing as z,isIFeatureTableSupportedLayerWithRelationships as B,isPageIndexValid as V,findRelatedLayer as H}from"./tableUtils.js";import{ContingentValuesManager as U}from"../../support/ContingentValuesManager.js";let W=class extends n{constructor(e){super(e),this._attachmentsOperationQueue=new o,this._contingentValuesManager=new U,this._defaultOutFields=[`*`],this._editOperationQueue=new o,this.featureTitleMap=new g,this._loaded=!1,this._loadController=null,this._loadDebounced=p(()=>this._load()),this._loadError=!1,this._objectIdCache=new o,this._pendingEditsCache=new g,this._queryOperationInfos=new g,this._refreshDebounced=p(()=>this._refresh()),this._size=0,this._temporaryHighlight=null,this._temporaryHighlightAbortController=null,this.attachmentsEnabled=!1,this.autoSaveEnabled=!0,this.defaultSelectionManager=new M,this.editingEnabled=!1,this.failures=new o,this.filterByViewExtent=!1,this.filterByLayerScaleRange=!1,this.filterGeometry=null,this.highlightEnabled=!0,this.initialSize=null,this.layer=null,this.maxSize=null,this.objectIds=null,this.outFields=null,this.pageCache=new g,this.pageSize=50,this.paginationEnabled=!1,this.relationshipConfig=null,this.relatedRecordsEnabled=!1,this.returnGeometry=!1,this.returnZ=!1,this.returnM=!1,this.selectionManager=null,this.sortOrders=[],this.syncViewSelection=!1,this.temporaryHighlightId=void 0,this.timeExtent=null,this.timeZone=null,this.view=null,this.viewTimeEnabled=!1,this.where=null}initialize(){this.addHandles([_(()=>[this.effectiveTimeExtent,this.effectiveWhere,this.filterGeometry,this.layer,this.objectIds,this.outFields,this.pageSize,this.relationshipConfig,this.returnGeometry,this.returnM,this.returnZ,this.visibleAtCurrentScale],()=>this._reset()),_(()=>this.orderByFields,()=>this._clearCaches(),{equals:r}),v(()=>this.attachmentsEnabled,()=>this._reset()),v(()=>this.relatedRecordsEnabled,()=>this._reset()),_(()=>this._layerWithContingentValues,e=>{let t=this._contingentValuesManager;e&&!t.layers.includes(e)&&t.layers.add(e)}),_(()=>[this.view?.extent,this.view?.stationary,this.filterByViewExtent],([e,t,n])=>{n&&(e?t&&(this.filterGeometry=e):this.filterGeometry=null)},y),_(()=>this.maxSize,(e,t)=>{t===0&&this._reset()}),_(()=>[this.layer,this.view],()=>this.syncSelectionSources(),y),_(()=>this.highlightEnabled,e=>this.defaultSelectionManager.highlightEnabled=e,y),_(()=>this.temporaryHighlightId,e=>{this._temporaryHighlight=d(this._temporaryHighlight?.handle),this._temporaryHighlightAbortController?.abort(),this._temporaryHighlightAbortController=new AbortController;let t=this._syncTemporaryHighlight(e,this._temporaryHighlightAbortController.signal);m(this.view?.addUpdatingPromise(t)??t)},b)])}destroy(){this.layer=null,this.itemCache.destroy(),this.failures.destroy(),this.defaultSelectionManager.destroy(),this._temporaryHighlight=d(this._temporaryHighlight?.handle),this._temporaryHighlightAbortController=f(this._temporaryHighlightAbortController)}get _capabilities(){let{layer:e}=this;return e?.effectiveCapabilities??e?.capabilities}get _canSavePendingEdits(){return this.supportsEditing&&this.hasPendingEdits&&!this.hasInvalidPendingEdits}get _effectiveReturnZ(){return this.returnZ&&this.supportsZ}get _effectiveReturnM(){return this.returnM&&this.supportsM}get _layerWithAttachments(){let{layer:e}=this;return!e||!this._capabilities||!this.attachmentsEnabled||!this.supportsAttachments||!L(e)?null:e}get _layerWithAttachmentsEditing(){let{_layerWithAttachments:e}=this;return!e||!R(e)||!this.supportsEditing?null:e}get _layerWithContingentValues(){let{layer:e}=this;return T(e)||E(e)?e:null}get _layerWithEditing(){let e=this.layer;return z(e)&&this.supportsEditing?e:null}get _layerWithRelationships(){let e=this.layer;return B(e)&&this.supportsQueryRelated?e:null}get _pendingEditsAreInvalid(){let e=this._pendingEditsCache,t=this._layerWithContingentValues;if(!t)return!1;for(let n of e.keys()){let r=e.get(n),i=this._getFeatureWithPendingEdits(n,r);for(let e of r.changes.keys())if(this._contingentValuesManager.getViolationForField(t,i,e))return!0}return!1}get _relatedLayer(){return this.relationshipConfig?.relatedLayer}get _relatedLayerCapabilities(){let{_relatedLayer:e}=this;return e?.effectiveCapabilities??e?.capabilities}get _relatedLayerSupportsCacheHint(){return!!this._relatedLayerCapabilities?.queryRelated?.supportsCacheHint}get _relatedLayerSupportsQuery(){return!!this._relatedLayerCapabilities?.operations.supportsQuery}get _relatedLayerSupportsQueryRelated(){let{_relatedLayerCapabilities:e}=this;return!!e?.queryRelated?.supportsCount&&!!e?.queryRelated?.supportsPagination}get _sortedFieldNames(){return this.sortOrders.map(({fieldName:e})=>e)}get _subtypeCode(){return this.layer?.subtypeCode??null}get _subtypeField(){let{layer:e}=this;return E(e?.parent)?e.subtypeField:null}get _canUseRelatedLayer(){return!!(this._relatedLayerSupportsQuery&&this._relatedLayerSupportsQueryRelated)}get cachedPageCount(){return this.pageCache.size}get canAddRelatedFeature(){let{state:e,relationship:t,supportsAdd:n,supportsEditing:r}=this;if(e!==`loaded`||!t||!n||!r)return!1;let{cardinality:i,role:a}=t,o=this.size>0;return!(i===`one-to-one`&&o||i===`one-to-many`&&a===`origin`&&o)}get effectiveFilterByLayerScaleRange(){return!!(this.view&&this.filterByLayerScaleRange)}get effectiveOutFields(){let{layer:e,outFields:t}=this;if(!e||!t?.length)return this._defaultOutFields;let n=[];t.forEach(t=>{let r=e.fieldsIndex.normalizeFieldName(t);r&&n.push(r)});let{objectIdField:r}=e,i=e.fieldsIndex.normalizeFieldName(r)??r;return i&&!n.includes(i)&&n.unshift(i),n}get effectiveSelectionManager(){let{layer:e,view:t}=this;return e&&this.syncViewSelection&&F(e)&&t?.selectionManager?.sources.includes(e)?t.selectionManager:this.selectionManager??this.defaultSelectionManager}get effectiveSize(){let{_size:e,maxSize:t}=this;return t==null?e:Math.min(t,e)}get effectiveTimeExtent(){let{layer:e,timeExtent:t,view:n,viewTimeEnabled:r}=this;return t||!e?t??void 0:!n||!r?e.timeExtent??void 0:O({datesInUnknownTimezone:e.datesInUnknownTimezone??void 0,timeExtent:e.timeExtent,timeInfo:e.timeInfo,timeOffset:e.timeOffset,useViewTime:e.useViewTime},n.timeExtent,this._get(`effectiveTimeExtent`))??void 0}get effectiveWhere(){let{layer:e,where:t}=this;return t!=null&&t!==``?t:D(e)&&e.parent?.definitionExpression?e.parent.definitionExpression:e?.definitionExpression||`1=1`}get fieldsWithContingentValues(){return this._contingentValuesManager.getFieldsWithContingentValues(this.layer)}get hasContingentValues(){return this.fieldsWithContingentValues.size>0}get hasInvalidPendingEdits(){return this.hasPendingEdits&&this._pendingEditsAreInvalid}get hasPendingEdits(){return this.pendingEditsCount>0}get highlightableLayerView(){let e=this.layerView;return P(e)?e:null}get isQuerying(){return this._queryOperationInfos.size>0}get isSyncing(){return this.isSyncingFeatureEdits||this.isSyncingAttachmentEdits}get isSyncingAttachmentEdits(){return this._attachmentsOperationQueue.length>0}get isSyncingFeatureEdits(){return this._editOperationQueue.length>0}get itemCache(){return new o({items:[...this.pageCache.values()].flat()})}get layerView(){let{layer:e,view:t}=this;if(!e||!t)return null;let n=e.type===`sublayer`||D(e)?e.parent:e;return t.allLayerViews.find(e=>e.layer===n)}get orderByFields(){let{_sortedFieldNames:e,layer:t,sortOrders:n}=this,r=n.filter(({fieldName:t,direction:n},r)=>e.indexOf(t)===r&&n!=null).map(({fieldName:e,direction:t})=>`${e} ${t?.toUpperCase()}`);if(t&&!r.length&&!t.objectIdField&&t.fields?.length){let e=t.fields.find(e=>e.name);if(e){let n=t.fieldsIndex.normalizeFieldName(e.name);n&&r.push(`${n} ASC`)}}return r}get pageCount(){let{effectiveSize:e,pageSize:t}=this;return e===0||t===0?1:Math.ceil(e/t)}get pageIndex(){return this._get(`pageIndex`)||0}set pageIndex(e){let{pageCount:t}=this;V(e,t)&&this._set(`pageIndex`,e)}get pendingEditsCount(){let e=0;return this._pendingEditsCache.forEach(t=>e+=t.changes.size),e}get relationship(){let{relationshipConfig:e}=this;return e?.relationshipId==null?null:this.relationships?.find(t=>t.id===e.relationshipId)}get relationshipIds(){return this.relationships?.map(e=>e.id)??[]}get relationshipInfos(){let{_layerWithRelationships:e,relatedRecordsEnabled:t,relationships:n,view:r}=this,i=[];return!t||!e?.loaded||!r?.map||!n?.length||n.forEach(t=>{let n=H(e,r,t);n&&(n.load().catch(()=>{}),i.push({layer:e,relatedLayer:n,relationshipId:t.id}))}),i}get relationships(){return this._layerWithRelationships?.relationships}get size(){return this._size}get state(){let{layer:e,_loaded:t,_loadError:n}=this;return!e||e.destroyed?`disabled`:n||e.loadError?`error`:this._loadController?`loading`:e.loadStatus===`loaded`&&t?`loaded`:`ready`}get supportsAdd(){return!!this._capabilities?.operations.supportsAdd}get supportsAddAttachments(){return!!(this._layerWithAttachmentsEditing&&(this.supportsAdd||this.supportsUpdate))}get supportsAttachments(){let{_capabilities:e}=this;return!!(e?.data?.supportsAttachment&&e?.operations.supportsQueryAttachments)}get supportsCacheHint(){return!!this._capabilities?.query?.supportsCacheHint}get supportsCacheHintQueryRelated(){return!!this._capabilities?.queryRelated?.supportsCacheHint}get supportsDelete(){return!!this._capabilities?.operations.supportsDelete}get supportsEditing(){return!!this._capabilities?.operations.supportsEditing}get supportsM(){return!!this.layer?.hasM&&!!this._capabilities?.data?.supportsM}get supportsOrderBy(){return!!this._capabilities?.query?.supportsOrderBy}get supportsPagination(){return!!this._capabilities?.query?.supportsPagination}get supportsQuery(){return!!this._capabilities?.operations.supportsQuery}get supportsQueryRelated(){let{_capabilities:e}=this;return!!e?.queryRelated?.supportsCount&&!!e?.queryRelated?.supportsPagination}get supportsResizeAttachments(){let{_capabilities:e}=this;return!!(this.supportsAttachments&&e?.attachment?.supportsResize)}get supportsUpdate(){return!!this._capabilities?.operations.supportsUpdate}get supportsUpdateAttachments(){return!!(this._layerWithAttachmentsEditing&&(this.supportsAdd||this.supportsUpdate))}get supportsZ(){return!!this.layer?.hasZ&&!!this._capabilities?.data?.supportsZ}get visibleAtCurrentScale(){let{layer:e}=this;return!e||!this.effectiveFilterByLayerScaleRange?!1:C(e.effectiveScaleRange,this.view?.scale)}async addAttachment(e,t){let{_layerWithAttachmentsEditing:n}=this;if(!n||!this.supportsAddAttachments)return{};let r=await this._queueAttachmentsOperation(e,()=>n.addAttachment(this._createBaseGraphic(n,e),t));return this._ensureArrayContent(r)}addPendingEdits(e){let t=this._ensureLayerAndUpdateSupport();if(!this.editingEnabled){this._logWarning(`store:editing-disabled`,`Editing is disabled.`);return}this.autoSaveEnabled&&this._logWarning(`store:pending-edit`,`Edit will be cached, but 'autoSaveEnabled' is true.`,!0),this._stashPendingEdits(t,e)}async deleteAttachments(e,t){let{_layerWithAttachmentsEditing:n}=this;if(!n||!this.supportsUpdateAttachments||!t.length)return[];let r=await this._queueAttachmentsOperation(e,()=>n.deleteAttachments(this._createBaseGraphic(n,e),t));return this._ensureArray(r)}async deleteRowsByObjectId(e){let{_layerWithEditing:t}=this;if(!this.supportsDelete||!t)throw new s(`store:delete-error`,`Delete is not supported.`);let n=e.map(e=>this.getItemByObjectId(e)?.feature).filter(i),r=this._queueEditOperation(()=>t.applyEdits({deleteFeatures:n}));return e.forEach(e=>{this.featureTitleMap.delete(e),this._discardPendingEdit({objectId:e})}),r}discardPendingEdits(e){if(e?.length){e.forEach(e=>this._discardPendingEdit(e));return}for(let[e,t]of this._pendingEditsCache){let n=this.getItemByObjectId(e);n&&(n.feature=t.originalFeature)}this._pendingEditsCache.clear(),this._clearOptionsAndViolations()}itemHasInvalidPendingEdits(e,t){if(!this.hasInvalidPendingEdits)return!1;let n=this._layerWithContingentValues,r=this._pendingEditsCache.get(e);if(!n||!r)return!1;let i=this._getFeatureWithPendingEdits(e,r),a=this._contingentValuesManager;return t?!!a.getViolationForField(n,i,t):!!a.getAllViolations(n,i)}itemHasPendingEdits(e,t){let n=this._pendingEditsCache.get(e);return n?!t||n.changes.has(t):!1}async getAttachmentsByObjectId(e,t){let n=this.getItemByObjectId(e)?.attachments??[];return!n.length&&t?(await this._queryAttachments([e]))[e]??[]:n}getCachedFeaturesByPageIndex(e){return this.pageCache.get(e)}getFieldValueOptions(e){return this._contingentValuesManager.getFieldValueOptions(e)}async getFeatureTitle(e,n=!1){let{layer:r}=this,i=this.featureTitleMap.get(e),a=`${e}`;if(!r)return i||a;if(i&&!n)return i;if(!(`getFeatureTitle`in r)||!r.getFeatureTitle)return a;let o=this.getItemByObjectId(e)?.feature;o||=new t({attributes:{[r.objectIdField]:e},origin:r.graphicOrigin});let s=await r.getFeatureTitle(o,{fetchMissingFields:!0,removeHTML:!0});return s?(this.featureTitleMap.set(e,s),s):a}getItemByObjectId(e){for(let t of this.pageCache.values())for(let n of t)if(n.objectId===e)return n}getItemIndexByObjectId(e){let{pageCache:t,pageSize:n}=this,r=t.entries(),i=-1;for(let[t,a]of r)if(a.some((r,a)=>{let o=r.objectId===e;return o&&(i=t*n+a),o}),i>-1)break;return i}async load(){await m(this._loadDebounced())}async queryPage(e){let{layer:t,state:n}=this;if(!t||n!==`loaded`||!this.supportsQuery||this.size===0||this.maxSize===0)return[];let{pageIndex:r}=e;if(!V(r,this.pageCount))return[];let i=e.pageSize??this.pageSize,a=r*i,o=a+i;return await m(this._query({layer:t,start:a,num:o,pageIndex:r,pageSize:i}))??[]}async refresh(){await m(this._refreshDebounced())}reset(){this._reset()}async savePendingEdits(){let e=this._ensureLayerAndUpdateSupport();if(!this.editingEnabled){this._logWarning(`store:editing-disabled`,`Editing is disabled.`);return}if(this.autoSaveEnabled&&this._logWarning(`store:pending-edit`,`Edit will be cached, but 'autoSaveEnabled' is true.`,!0),!this._canSavePendingEdits){this._logError(`store:update-error`,`An error occurred. Unable to save pending edits.`);return}let t=[];for(let[e]of this._pendingEditsCache){let n=this.getItemByObjectId(e);n?.feature&&t.push(n.feature)}(await this._update(e,t,!0)).updateFeatureResults.find(e=>e.error)&&this.discardPendingEdits(),this._clearOptionsAndViolations()}syncSelectionSources(){let{defaultSelectionManager:e,layer:t,view:n}=this;e.view=n,e.sources.removeAll(),I(t)&&(e.sources.items=[t])}async updateAttachment(e,t,n){let{_layerWithAttachmentsEditing:r}=this;if(!r||!this.supportsUpdateAttachments)return{};let i=await this._queueAttachmentsOperation(e,()=>r.updateAttachment(this._createBaseGraphic(r,e),t,n));return this._ensureArrayContent(i)}async updateItem(e){let t=this._ensureLayerAndUpdateSupport();if(!this.editingEnabled){this._logWarning(`store:editing-disabled`,`Editing is disabled.`);return}if(this.hasContingentValues){let t=e.updates.some(e=>this.fieldsWithContingentValues.has(e.fieldName)),n=this.itemHasPendingEdits(e.objectId);if(n||t){let t=this._layerWithContingentValues,r=this.getItemByObjectId(e.objectId)?.feature?.clone();if(r){let i=this._contingentValuesManager.getAllViolations(t,r);if(e.updates.forEach(({fieldName:e,value:n})=>{let i=t.getField(e);i&&(r.attributes[i.name]=n)}),this._contingentValuesManager.validateContingencyConstraints(t,r).length||i.length||n){this._stashPendingEdits(t,[e]),this._contingentValuesManager.resetOptionsForLayer(t);return}}}}if(!this.autoSaveEnabled){this._stashPendingEdits(t,[e]);return}let{_sortedFieldNames:n}=this,r=e.updates.map(({fieldName:e})=>e),i=this._prepareEditsForUpdate([e]);!(await this._update(t,i)).updateFeatureResults.find(e=>e.error)&&r.some(e=>n.includes(e))&&this._clearCaches()}async verifyFeaturesByObjectId(e){let{layer:t,state:n}=this;if(!t||n!==`loaded`)return[];let{objectIdField:r}=t,i=await this._queryFeaturesByObjectId(e);return e.map(e=>i.some(t=>e===(t.getObjectId()??t.attributes[r])))}async _load(){let{layer:e}=this;if(this._reset(),!e)return;let t=new AbortController;this._loadController=t;try{if(await e.load(),e.parent&&E(e.parent)&&await e.parent.loadAll(),await e.when(),t.signal.aborted)return;let n=this.initialSize;if(this.initialSize=null,this.effectiveFilterByLayerScaleRange&&(this.visibleAtCurrentScale||(n=0)),await m(this._refresh(t,n)),t.signal.aborted){this._loadController=null;return}this._loaded=!0,this._loadController=null}catch(e){throw this._reset(),this._loadError=!0,this._logError(`store:load-error`,`An error occurred.`),e}}async _refresh(e,t){this._clearCaches();let n=e?.signal,r=await this._getSize(n,t),i=await this._queryAllObjectIds(n);n?.aborted||(this._size=r,this._objectIdCache.removeAll(),i?.length&&this._objectIdCache.addMany(i),this._syncPendingEdits())}async _queryAllObjectIds(e){return this.supportsPagination?void 0:await this._queryObjectIds(e)}_clearCaches(){this.pageCache.clear(),this._objectIdCache.removeAll()}_createBaseGraphic(e,n){let r=new t({attributes:{[e.objectIdField]:n}});return this._subtypeField&&this._subtypeCode!=null&&(r.attributes[this._subtypeField]=this._subtypeCode),r}_ensureArray(e){return Array.isArray(e)?e:[e]}_ensureArrayContent(e){return Array.isArray(e)?e[0]:e}_getObjectIdsForFeatures(e,t){return e.map(e=>e.getObjectId()??e.attributes[t.objectIdField])}_getObjectIdsForPage(e,t){let n=this._objectIdCache.toArray();return n.length>=e+t?n.slice(e,e+t):n.slice(e)}_logError(e,t){l.getLogger(this).error(e,t)}_logWarning(e,t,n=!1){n?l.getLogger(this).warnOnce(e,t):l.getLogger(this).warn(e,t)}_reset(){this._clearCaches(),this._pendingEditsCache.clear(),this.failures.removeAll(),this._attachmentsOperationQueue.removeAll(),this._editOperationQueue.removeAll(),this.featureTitleMap.clear(),this._loadController=f(this._loadController),this._queryOperationInfos.forEach(e=>e.controller.abort()),this._queryOperationInfos.clear(),this._temporaryHighlight=d(this._temporaryHighlight?.handle),this._temporaryHighlightAbortController=f(this._temporaryHighlightAbortController),this._loaded=!1,this._loadError=!1,this._size=0}async _getSize(e,t){return this.maxSize===0?0:t??await this._queryCount(e)}async _queryFeaturesByObjectId(e){let{layer:t}=this;if(!t||!this.supportsQuery)throw new s(`store:query-error`,`Layer does not support query operation.`);let{effectiveTimeExtent:n,effectiveWhere:r,orderByFields:i,supportsCacheHint:a,supportsOrderBy:o}=this,c=t.createQuery();return c.where=r,c.timeExtent=n,c.returnGeometry=!1,c.objectIds=e.length?e:void 0,c.outFields=[t.objectIdField],o&&(c.orderByFields=i),a&&(c.cacheHint=!0),(await t.queryFeatures(c)).features}async _syncTemporaryHighlight(e,t){let{highlightEnabled:n,highlightableLayerView:r}=this;r&&n&&e!=null&&(h(t),this._temporaryHighlight={id:e,handle:r.highlight(e,{name:N})})}_ensureLayerAndUpdateSupport(){let e=this._layerWithEditing;if(!e||!this.supportsUpdate)throw new s(`store:update-error`,`Update is not supported.`);return e}_stashPendingEdits(e,t){t.forEach(({objectId:t,updates:n})=>{let r=this.getItemByObjectId(t)?.feature;if(!r)throw new s(`store:update-error`,`Feature with provided 'objectId' not found.`);let i=r.clone(),a=u(this._pendingEditsCache,t,()=>({originalFeature:i,changes:new g}));n.forEach(({fieldName:t,value:n})=>{let i=e.getField(t);i?(a.changes.set(i.name,n),r.attributes[i.name]=n):this._logWarning(`store:pending-edit-unknown-field`,`The provided field does not belong to this layer.`)}),a.changes.size>0&&this._pendingEditsCache.set(t,a)})}_syncPendingEdits(){for(let[e,t]of this._pendingEditsCache){let n=this.getItemByObjectId(e)?.feature;if(n){let e=n.clone();for(let[e,r]of t.changes)n.attributes[e]=r;t.originalFeature=e}}}_getFeatureWithPendingEdits(e,t){let n=this.getItemByObjectId(e)?.feature;if(!n){n=t.originalFeature.clone();for(let[e,r]of t.changes)n.attributes[e]=r}return n}_discardPendingEdit({objectId:e,fieldName:t}){let n=this._pendingEditsCache.get(e);if(!n){this._logWarning(`store:pending-edit-not-found`,`Could not find a pending edit with the given information`);return}let r=this.getItemByObjectId(e);t?(r&&(r.feature.attributes[t]=n.originalFeature.attributes[t]),n.changes.delete(t),n.changes.size===0&&this._pendingEditsCache.delete(e)):(r&&(r.feature=n.originalFeature),this._pendingEditsCache.delete(e))}_clearOptionsAndViolations(){let{_layerWithContingentValues:e,_contingentValuesManager:t}=this;e&&(t.resetOptionsForLayer(e),t.resetViolationsForLayer(e))}_prepareEditsForUpdate(e){let n=[];return e.forEach(({objectId:e,updates:r})=>{let i=this.getItemByObjectId(e)?.feature;if(!i)return;let a=c(i.attributes);r.forEach(({fieldName:e,value:t})=>a[e]=t),n.push(new t({attributes:a,sourceLayer:i.sourceLayer}))}),n}_update(e,t,n=!1){let r=e.applyEdits({updateFeatures:t}).then(n=>{let{updateFeatureResults:r}=n,i=r.find(e=>!!e.error);if(i)throw i.error;return t.forEach(t=>{let n=t.getObjectId()??t.attributes[e.objectIdField],r=this.getItemByObjectId(n)?.feature;r&&(r.attributes=t.attributes),this.featureTitleMap.has(n)&&this.getFeatureTitle(n,!0)}),n});return this._queueEditOperation(()=>r,n)}_createFeatureStoreItems(e){let{attachments:t,features:n,layer:r,relatedRecords:i}=e,a=r.objectIdField;return n.map(e=>{let n=e.getObjectId()??e.attributes[a],o=[];!e.layer&&!e.sourceLayer&&(e.layer=r,e.sourceLayer=r);let s=this._pendingEditsCache.get(n);if(s){let t=e.clone(),n=s.changes;for(let[t,r]of n)e.attributes[t]=r;s.originalFeature=t}return i.forEach((e,t)=>{o.push({relationshipId:t,count:e[n]??0})}),{objectId:n,feature:e,attachments:t[n]??null,relatedRecords:o}})}async _query(e){let{pageIndex:t,refresh:n}=e;n===!0&&await this._refresh();let r=this.pageCache.get(t);if(r)return r;let i=this._queryOperationInfos.get(t);if(i)return i.task.promise;let a=new AbortController,o=await this._queryPage(e,a);return a.signal.aborted||this.pageCache.set(t,o),o}_queryAttachments(e,t){let{_layerWithAttachments:n,effectiveWhere:r}=this;return n?e.some(e=>typeof e!=`number`)?Promise.reject(new s(`invalid-object-id`,`Only numeric object ids are valid to query attachments`)):n.queryAttachments(new k({objectIds:e,where:r,returnMetadata:!0}),{signal:t}):Promise.resolve({})}async _queryCount(e){let{_relatedLayerSupportsCacheHint:t,layer:n,relationshipConfig:r,supportsCacheHint:i}=this;if(!n)return 0;if(r&&this._canUseRelatedLayer){let{objectId:n,relatedLayer:i,relationshipId:a}=r;return(await i.queryRelatedFeaturesCount(new A({cacheHint:t,relationshipId:a,objectIds:[n]}),{signal:e}))[n]??0}let{effectiveTimeExtent:a,effectiveWhere:o,filterGeometry:s,objectIds:c}=this,l=n.createQuery();return l.geometry=s,l.returnGeometry=!1,l.where=o,l.timeExtent=a,l.objectIds=c?.length?c:void 0,i&&(l.cacheHint=!0),n.queryFeatureCount(l,{signal:e})}async _queryFeatures(e,t){let{relationshipConfig:n}=this;if(n&&this._canUseRelatedLayer)return this._queryRelatedFeatures(e,n);let{_effectiveReturnM:r,_effectiveReturnZ:i,effectiveOutFields:a,effectiveTimeExtent:o,effectiveWhere:s,filterGeometry:c,objectIds:l,orderByFields:u,pageSize:d,returnGeometry:f,supportsCacheHint:p,supportsOrderBy:m,supportsPagination:h}=this,{layer:g,start:_}=e,v=l?.length,y=g.createQuery();return y.returnGeometry=f,y.outFields=a,y.returnM=r,y.returnZ=i,h?(y.start=_,y.num=d,y.where=s,y.timeExtent=o,y.objectIds=v?l:void 0):y.objectIds=v?l:this._getObjectIdsForPage(_,d??0),m&&(y.orderByFields=u),c&&(y.geometry=c),p&&(y.cacheHint=!0),(await g.queryFeatures(y,{signal:t})).features}_queryObjectIds(e){let{effectiveTimeExtent:t,effectiveWhere:n,filterGeometry:r,layer:i,objectIds:a,orderByFields:o,supportsCacheHint:s,supportsOrderBy:c}=this;if(!i)return Promise.resolve([]);let l=i.createQuery();return l.geometry=r,l.outFields=[i.objectIdField],l.returnGeometry=!1,l.where=n,l.timeExtent=t,l.objectIds=a?.length?a:void 0,c&&(l.orderByFields=o),s&&(l.cacheHint=!0),i.queryObjectIds(l,{signal:e})}async _queryPage(e,t){return this._queueQueryOperation(e.pageIndex,{controller:t,task:a(async()=>this._queryPageData(e,t))})}async _queryPageData(e,t){let{layer:n}=e,{signal:r}=t,i=await this._queryFeatures(e,r);if(r.aborted)return[];let a=this._getObjectIdsForFeatures(i,n),[o,s]=await Promise.all([this._queryAttachments(a,r),this._queryRelatedCounts(a,r)]);return t.signal.aborted?[]:this._createFeatureStoreItems({layer:n,features:i,attachments:o,relatedRecords:s})||[]}async _queryRelatedCounts(e,t){let{_layerWithRelationships:n,relationshipIds:r,supportsCacheHintQueryRelated:i}=this,a=new Map;return!n||!e?.length||!r.length||await Promise.allSettled(r.map(async r=>{let o=await n.queryRelatedFeaturesCount(new A({cacheHint:i,relationshipId:r,objectIds:e}),{signal:t});a.set(r,o)})),a}async _queryRelatedFeatures(e,t){let{_defaultOutFields:n,_effectiveReturnM:r,_effectiveReturnZ:i,orderByFields:a,pageSize:o,returnGeometry:s,supportsCacheHint:c}=this,{layer:l,start:u}=e,{objectId:d,relatedLayer:f,relationshipId:p}=t,m=l.createQuery(),h=new A({cacheHint:c,num:o,objectIds:[d],orderByFields:a,outFields:n,relationshipId:p,returnGeometry:s,returnM:r,returnZ:i,start:u,where:m.where??void 0});return(await f.queryRelatedFeatures(h))[d]?.features||[]}_queueAttachmentsOperation(e,t){return this._attachmentsOperationQueue.push(t),t().then(async n=>{this._attachmentsOperationQueue.remove(t);let r=this._ensureArray(n),i=r.some(e=>e.error),a=this.getItemByObjectId(e);return a&&(!i||r.length>1)&&(a.attachments=(await this._queryAttachments([e]))[e]),n}).catch(async n=>{this._logError(`store:attachment-error`,`An error occurred.`);let r={error:n,retry:()=>{this.failures.remove(r),this._queueAttachmentsOperation(e,t)},cancel:()=>this.failures.remove(r)};throw this.failures.add(r),this._attachmentsOperationQueue.remove(t),n})}_queueEditOperation(e,t=!1){return this._editOperationQueue.push(e),e().then(n=>(this._editOperationQueue.remove(e),t&&this._pendingEditsCache.clear(),n)).catch(t=>{this._logError(`store:edit-error`,`An error occurred.`);let n={error:t,retry:()=>{this.failures.remove(n),this._queueEditOperation(e)},cancel:()=>this.failures.remove(n)};throw this.failures.add(n),this._editOperationQueue.remove(e),t})}async _queueQueryOperation(e,t){this._queryOperationInfos.set(e,t);let n=await t.task.promise;return this._queryOperationInfos.delete(e),n}};e([x()],W.prototype,`_attachmentsOperationQueue`,void 0),e([x({readOnly:!0})],W.prototype,`_capabilities`,null),e([x()],W.prototype,`_canSavePendingEdits`,null),e([x()],W.prototype,`_contingentValuesManager`,void 0),e([x()],W.prototype,`_defaultOutFields`,void 0),e([x()],W.prototype,`_editOperationQueue`,void 0),e([x()],W.prototype,`_effectiveReturnZ`,null),e([x()],W.prototype,`_effectiveReturnM`,null),e([x()],W.prototype,`featureTitleMap`,void 0),e([x({readOnly:!0})],W.prototype,`_layerWithAttachments`,null),e([x({readOnly:!0})],W.prototype,`_layerWithAttachmentsEditing`,null),e([x()],W.prototype,`_layerWithContingentValues`,null),e([x({readOnly:!0})],W.prototype,`_layerWithEditing`,null),e([x({readOnly:!0})],W.prototype,`_layerWithRelationships`,null),e([x()],W.prototype,`_loaded`,void 0),e([x()],W.prototype,`_loadController`,void 0),e([x()],W.prototype,`_loadError`,void 0),e([x()],W.prototype,`_objectIdCache`,void 0),e([x()],W.prototype,`_pendingEditsCache`,void 0),e([x()],W.prototype,`_pendingEditsAreInvalid`,null),e([x()],W.prototype,`_queryOperationInfos`,void 0),e([x({readOnly:!0})],W.prototype,`_relatedLayer`,null),e([x({readOnly:!0})],W.prototype,`_relatedLayerCapabilities`,null),e([x({readOnly:!0})],W.prototype,`_relatedLayerSupportsCacheHint`,null),e([x()],W.prototype,`_relatedLayerSupportsQuery`,null),e([x()],W.prototype,`_relatedLayerSupportsQueryRelated`,null),e([x()],W.prototype,`_size`,void 0),e([x()],W.prototype,`_sortedFieldNames`,null),e([x()],W.prototype,`_subtypeCode`,null),e([x()],W.prototype,`_subtypeField`,null),e([x()],W.prototype,`_canUseRelatedLayer`,null),e([x()],W.prototype,`attachmentsEnabled`,void 0),e([x()],W.prototype,`autoSaveEnabled`,void 0),e([x()],W.prototype,`cachedPageCount`,null),e([x()],W.prototype,`canAddRelatedFeature`,null),e([x()],W.prototype,`defaultSelectionManager`,void 0),e([x()],W.prototype,`editingEnabled`,void 0),e([x()],W.prototype,`effectiveFilterByLayerScaleRange`,null),e([x()],W.prototype,`effectiveOutFields`,null),e([x()],W.prototype,`effectiveSelectionManager`,null),e([x()],W.prototype,`effectiveSize`,null),e([x()],W.prototype,`effectiveTimeExtent`,null),e([x()],W.prototype,`effectiveWhere`,null),e([x({readOnly:!0})],W.prototype,`failures`,void 0),e([x()],W.prototype,`fieldsWithContingentValues`,null),e([x()],W.prototype,`filterByViewExtent`,void 0),e([x()],W.prototype,`filterByLayerScaleRange`,void 0),e([x({types:w})],W.prototype,`filterGeometry`,void 0),e([x()],W.prototype,`hasContingentValues`,null),e([x()],W.prototype,`hasInvalidPendingEdits`,null),e([x()],W.prototype,`hasPendingEdits`,null),e([x()],W.prototype,`highlightEnabled`,void 0),e([x()],W.prototype,`highlightableLayerView`,null),e([x()],W.prototype,`initialSize`,void 0),e([x({readOnly:!0})],W.prototype,`isQuerying`,null),e([x({readOnly:!0})],W.prototype,`isSyncing`,null),e([x({readOnly:!0})],W.prototype,`isSyncingAttachmentEdits`,null),e([x({readOnly:!0})],W.prototype,`isSyncingFeatureEdits`,null),e([x({readOnly:!0})],W.prototype,`itemCache`,null),e([x()],W.prototype,`layer`,void 0),e([x()],W.prototype,`layerView`,null),e([x()],W.prototype,`maxSize`,void 0),e([x()],W.prototype,`objectIds`,void 0),e([x()],W.prototype,`orderByFields`,null),e([x()],W.prototype,`outFields`,void 0),e([x({readOnly:!0})],W.prototype,`pageCache`,void 0),e([x()],W.prototype,`pageCount`,null),e([x()],W.prototype,`pageIndex`,null),e([x()],W.prototype,`pageSize`,void 0),e([x()],W.prototype,`paginationEnabled`,void 0),e([x()],W.prototype,`pendingEditsCount`,null),e([x()],W.prototype,`relationship`,null),e([x()],W.prototype,`relationshipConfig`,void 0),e([x()],W.prototype,`relationshipIds`,null),e([x()],W.prototype,`relationshipInfos`,null),e([x()],W.prototype,`relationships`,null),e([x()],W.prototype,`relatedRecordsEnabled`,void 0),e([x()],W.prototype,`returnGeometry`,void 0),e([x()],W.prototype,`returnZ`,void 0),e([x()],W.prototype,`returnM`,void 0),e([x()],W.prototype,`selectionManager`,void 0),e([x({readOnly:!0})],W.prototype,`size`,null),e([x()],W.prototype,`sortOrders`,void 0),e([x({readOnly:!0})],W.prototype,`state`,null),e([x()],W.prototype,`supportsAdd`,null),e([x()],W.prototype,`supportsAddAttachments`,null),e([x()],W.prototype,`supportsAttachments`,null),e([x()],W.prototype,`supportsCacheHint`,null),e([x()],W.prototype,`supportsCacheHintQueryRelated`,null),e([x()],W.prototype,`supportsDelete`,null),e([x()],W.prototype,`supportsEditing`,null),e([x()],W.prototype,`supportsM`,null),e([x()],W.prototype,`supportsOrderBy`,null),e([x()],W.prototype,`supportsPagination`,null),e([x()],W.prototype,`supportsQuery`,null),e([x()],W.prototype,`supportsQueryRelated`,null),e([x()],W.prototype,`supportsResizeAttachments`,null),e([x()],W.prototype,`supportsUpdate`,null),e([x()],W.prototype,`supportsUpdateAttachments`,null),e([x()],W.prototype,`supportsZ`,null),e([x()],W.prototype,`syncViewSelection`,void 0),e([x()],W.prototype,`temporaryHighlightId`,void 0),e([x({type:j})],W.prototype,`timeExtent`,void 0),e([x()],W.prototype,`timeZone`,void 0),e([x()],W.prototype,`view`,void 0),e([x()],W.prototype,`viewTimeEnabled`,void 0),e([x()],W.prototype,`visibleAtCurrentScale`,null),e([x()],W.prototype,`where`,void 0),W=e([S(`esri.widgets.FeatureTable.support.FeatureStore`)],W);const G=W;export{G as default};
+import{__decorate as e}from"tslib";import t from"../../../Graphic.js";import n from"../../../core/Accessor.js";import{equals as r,isSome as i}from"../../../core/arrayUtils.js";import{createTask as a}from"../../../core/asyncUtils.js";import o from"../../../core/Collection.js";import s from"../../../core/Error.js";import{clone as c}from"../../../core/lang.js";import l from"../../../core/Logger.js";import{getOrCreateMapValue as u}from"../../../core/MapUtils.js";import{removeMaybe as d,abortMaybe as f}from"../../../core/maybe.js";import{debounce as p,ignoreAbortErrors as m,throwIfAborted as h}from"../../../core/promiseUtils.js";import g from"../../../core/ReactiveMap.js";import{watch as _,when as v,syncAndInitial as y,sync as b}from"../../../core/reactiveUtils.js";import{property as x,subclass as S}from"../../../core/accessorSupport/decorators.js";import{isInEffectiveScaleRange as C}from"../../../geometry/support/scaleUtils.js";import{geometryTypes as w}from"../../../geometry/support/typeUtils.js";import{isFeatureLayer as T,isSubtypeGroupLayer as E,isSubtypeSublayer as D}from"../../../layers/support/layerUtils.js";import{combineTimeExtent as O}from"../../../layers/support/timeSupport.js";import k from"../../../rest/support/AttachmentQuery.js";import A from"../../../rest/support/RelationshipQuery.js";import j from"../../../time/TimeExtent.js";import M from"../../../views/SelectionManager.js";import{temporaryHighlightName as N}from"../../../views/support/HighlightDefaults.js";import{highlightsSupported as P}from"../../../views/support/layerViewUtils.js";import{isSelectableLayerWithObjectIds as F,isSelectableLayer as I}from"../../../views/support/selectionUtils.js";import{isIFeatureTableSupportedLayerWithAttachments as L,isIFeatureTableSupportedLayerWithAttachmentsEditing as R,isIFeatureTableSupportedLayerWithEditing as z,isIFeatureTableSupportedLayerWithRelationships as B,isPageIndexValid as V,findRelatedLayer as H}from"./tableUtils.js";import{ContingentValuesManager as U}from"../../support/ContingentValuesManager.js";let W=class extends n{constructor(e){super(e),this._attachmentsOperationQueue=new o,this._contingentValuesManager=new U,this._defaultOutFields=[`*`],this._editOperationQueue=new o,this.featureTitleMap=new g,this._loaded=!1,this._loadController=null,this._loadDebounced=p(()=>this._load()),this._loadError=!1,this._objectIdCache=new o,this._pendingEditsCache=new g,this._queryOperationInfos=new g,this._refreshDebounced=p(()=>this._refresh()),this._size=0,this._temporaryHighlight=null,this._temporaryHighlightAbortController=null,this.attachmentsEnabled=!1,this.autoSaveEnabled=!0,this.defaultSelectionManager=new M,this.editingEnabled=!1,this.failures=new o,this.filterByViewExtent=!1,this.filterByLayerScaleRange=!1,this.filterGeometry=null,this.highlightEnabled=!0,this.initialSize=null,this.layer=null,this.maxSize=null,this.objectIds=null,this.outFields=null,this.pageCache=new g,this.pageSize=50,this.paginationEnabled=!1,this.relationshipConfig=null,this.relatedRecordsEnabled=!1,this.returnGeometry=!1,this.returnZ=!1,this.returnM=!1,this.selectionManager=null,this.sortOrders=[],this.syncViewSelection=!1,this.temporaryHighlightId=void 0,this.timeExtent=null,this.timeZone=null,this.view=null,this.viewTimeEnabled=!1,this.where=null}initialize(){this.addHandles([_(()=>[this.effectiveWhere,this.filterGeometry,this.layer,this.objectIds,this.outFields,this.pageSize,this.relationshipConfig,this.returnGeometry,this.returnM,this.returnZ,this.visibleAtCurrentScale],()=>this._reset()),_(()=>this.orderByFields,()=>this._clearCaches(),{equals:r}),v(()=>this.attachmentsEnabled,()=>this._reset()),v(()=>this.relatedRecordsEnabled,()=>this._reset()),_(()=>this._layerWithContingentValues,e=>{let t=this._contingentValuesManager;e&&!t.layers.includes(e)&&t.layers.add(e)}),_(()=>[this.view?.extent,this.view?.stationary,this.filterByViewExtent],([e,t,n])=>{n&&(e?t&&(this.filterGeometry=e):this.filterGeometry=null)},y),_(()=>this.maxSize,(e,t)=>{t===0&&this._reset()}),_(()=>[this.layer,this.view],()=>this.syncSelectionSources(),y),_(()=>this.highlightEnabled,e=>this.defaultSelectionManager.highlightEnabled=e,y),_(()=>this.temporaryHighlightId,e=>{this._temporaryHighlight=d(this._temporaryHighlight?.handle),this._temporaryHighlightAbortController?.abort(),this._temporaryHighlightAbortController=new AbortController;let t=this._syncTemporaryHighlight(e,this._temporaryHighlightAbortController.signal);m(this.view?.addUpdatingPromise(t)??t)},b)])}destroy(){this.layer=null,this.itemCache.destroy(),this.failures.destroy(),this.defaultSelectionManager.destroy(),this._temporaryHighlight=d(this._temporaryHighlight?.handle),this._temporaryHighlightAbortController=f(this._temporaryHighlightAbortController)}get _capabilities(){let{layer:e}=this;return e?.effectiveCapabilities??e?.capabilities}get _canSavePendingEdits(){return this.supportsEditing&&this.hasPendingEdits&&!this.hasInvalidPendingEdits}get _effectiveReturnZ(){return this.returnZ&&this.supportsZ}get _effectiveReturnM(){return this.returnM&&this.supportsM}get _layerWithAttachments(){let{layer:e}=this;return!e||!this._capabilities||!this.attachmentsEnabled||!this.supportsAttachments||!L(e)?null:e}get _layerWithAttachmentsEditing(){let{_layerWithAttachments:e}=this;return!e||!R(e)||!this.supportsEditing?null:e}get _layerWithContingentValues(){let{layer:e}=this;return T(e)||E(e)?e:null}get _layerWithEditing(){let e=this.layer;return z(e)&&this.supportsEditing?e:null}get _layerWithRelationships(){let e=this.layer;return B(e)&&this.supportsQueryRelated?e:null}get _pendingEditsAreInvalid(){let e=this._pendingEditsCache,t=this._layerWithContingentValues;if(!t)return!1;for(let n of e.keys()){let r=e.get(n),i=this._getFeatureWithPendingEdits(n,r);for(let e of r.changes.keys())if(this._contingentValuesManager.getViolationForField(t,i,e))return!0}return!1}get _relatedLayer(){return this.relationshipConfig?.relatedLayer}get _relatedLayerCapabilities(){let{_relatedLayer:e}=this;return e?.effectiveCapabilities??e?.capabilities}get _relatedLayerSupportsCacheHint(){return!!this._relatedLayerCapabilities?.queryRelated?.supportsCacheHint}get _relatedLayerSupportsQuery(){return!!this._relatedLayerCapabilities?.operations.supportsQuery}get _relatedLayerSupportsQueryRelated(){let{_relatedLayerCapabilities:e}=this;return!!e?.queryRelated?.supportsCount&&!!e?.queryRelated?.supportsPagination}get _sortedFieldNames(){return this.sortOrders.map(({fieldName:e})=>e)}get _subtypeCode(){return this.layer?.subtypeCode??null}get _subtypeField(){let{layer:e}=this;return E(e?.parent)?e.subtypeField:null}get _canUseRelatedLayer(){return!!(this._relatedLayerSupportsQuery&&this._relatedLayerSupportsQueryRelated)}get cachedPageCount(){return this.pageCache.size}get canAddRelatedFeature(){let{state:e,relationship:t,supportsAdd:n,supportsEditing:r}=this;if(e!==`loaded`||!t||!n||!r)return!1;let{cardinality:i,role:a}=t,o=this.size>0;return!(i===`one-to-one`&&o||i===`one-to-many`&&a===`origin`&&o)}get effectiveFilterByLayerScaleRange(){return!!(this.view&&this.filterByLayerScaleRange)}get effectiveOutFields(){let{layer:e,outFields:t}=this;if(!e||!t?.length)return this._defaultOutFields;let n=[];t.forEach(t=>{let r=e.fieldsIndex.normalizeFieldName(t);r&&n.push(r)});let{objectIdField:r}=e,i=e.fieldsIndex.normalizeFieldName(r)??r;return i&&!n.includes(i)&&n.unshift(i),n}get effectiveSelectionManager(){let{layer:e,view:t}=this;return e&&this.syncViewSelection&&F(e)&&t?.selectionManager?.sources.includes(e)?t.selectionManager:this.selectionManager??this.defaultSelectionManager}get effectiveSize(){let{_size:e,maxSize:t}=this;return t==null?e:Math.min(t,e)}get effectiveTimeExtent(){let{layer:e,timeExtent:t,view:n,viewTimeEnabled:r}=this;return t||!e?t??void 0:!n||!r?e.timeExtent??void 0:O({datesInUnknownTimezone:e.datesInUnknownTimezone??void 0,timeExtent:e.timeExtent,timeInfo:e.timeInfo,timeOffset:e.timeOffset,useViewTime:e.useViewTime},n.timeExtent,this._get(`effectiveTimeExtent`))??void 0}get effectiveWhere(){let{layer:e,where:t}=this;return t!=null&&t!==``?t:D(e)&&e.parent?.definitionExpression?e.parent.definitionExpression:e?.definitionExpression||`1=1`}get fieldsWithContingentValues(){return this._contingentValuesManager.getFieldsWithContingentValues(this.layer)}get hasContingentValues(){return this.fieldsWithContingentValues.size>0}get hasInvalidPendingEdits(){return this.hasPendingEdits&&this._pendingEditsAreInvalid}get hasPendingEdits(){return this.pendingEditsCount>0}get highlightableLayerView(){let e=this.layerView;return P(e)?e:null}get isQuerying(){return this._queryOperationInfos.size>0}get isSyncing(){return this.isSyncingFeatureEdits||this.isSyncingAttachmentEdits}get isSyncingAttachmentEdits(){return this._attachmentsOperationQueue.length>0}get isSyncingFeatureEdits(){return this._editOperationQueue.length>0}get itemCache(){return new o({items:[...this.pageCache.values()].flat()})}get layerView(){let{layer:e,view:t}=this;if(!e||!t)return null;let n=e.type===`sublayer`||D(e)?e.parent:e;return t.allLayerViews.find(e=>e.layer===n)}get orderByFields(){let{_sortedFieldNames:e,layer:t,sortOrders:n}=this,r=n.filter(({fieldName:t,direction:n},r)=>e.indexOf(t)===r&&n!=null).map(({fieldName:e,direction:t})=>`${e} ${t?.toUpperCase()}`);if(t&&!r.length&&!t.objectIdField&&t.fields?.length){let e=t.fields.find(e=>e.name);if(e){let n=t.fieldsIndex.normalizeFieldName(e.name);n&&r.push(`${n} ASC`)}}return r}get pageCount(){let{effectiveSize:e,pageSize:t}=this;return e===0||t===0?1:Math.ceil(e/t)}get pageIndex(){return this._get(`pageIndex`)||0}set pageIndex(e){let{pageCount:t}=this;V(e,t)&&this._set(`pageIndex`,e)}get pendingEditsCount(){let e=0;return this._pendingEditsCache.forEach(t=>e+=t.changes.size),e}get relationship(){let{relationshipConfig:e}=this;return e?.relationshipId==null?null:this.relationships?.find(t=>t.id===e.relationshipId)}get relationshipIds(){return this.relationships?.map(e=>e.id)??[]}get relationshipInfos(){let{_layerWithRelationships:e,relatedRecordsEnabled:t,relationships:n,view:r}=this,i=[];return!t||!e?.loaded||!r?.map||!n?.length||n.forEach(t=>{let n=H(e,r,t);n&&(n.load().catch(()=>{}),i.push({layer:e,relatedLayer:n,relationshipId:t.id}))}),i}get relationships(){return this._layerWithRelationships?.relationships}get size(){return this._size}get state(){let{layer:e,_loaded:t,_loadError:n}=this;return!e||e.destroyed?`disabled`:n||e.loadError?`error`:this._loadController?`loading`:e.loadStatus===`loaded`&&t?`loaded`:`ready`}get supportsAdd(){return!!this._capabilities?.operations.supportsAdd}get supportsAddAttachments(){return!!(this._layerWithAttachmentsEditing&&(this.supportsAdd||this.supportsUpdate))}get supportsAttachments(){let{_capabilities:e}=this;return!!(e?.data?.supportsAttachment&&e?.operations.supportsQueryAttachments)}get supportsCacheHint(){return!!this._capabilities?.query?.supportsCacheHint}get supportsCacheHintQueryRelated(){return!!this._capabilities?.queryRelated?.supportsCacheHint}get supportsDelete(){return!!this._capabilities?.operations.supportsDelete}get supportsEditing(){return!!this._capabilities?.operations.supportsEditing}get supportsM(){return!!this.layer?.hasM&&!!this._capabilities?.data?.supportsM}get supportsOrderBy(){return!!this._capabilities?.query?.supportsOrderBy}get supportsPagination(){return!!this._capabilities?.query?.supportsPagination}get supportsQuery(){return!!this._capabilities?.operations.supportsQuery}get supportsQueryRelated(){let{_capabilities:e}=this;return!!e?.queryRelated?.supportsCount&&!!e?.queryRelated?.supportsPagination}get supportsResizeAttachments(){let{_capabilities:e}=this;return!!(this.supportsAttachments&&e?.attachment?.supportsResize)}get supportsUpdate(){return!!this._capabilities?.operations.supportsUpdate}get supportsUpdateAttachments(){return!!(this._layerWithAttachmentsEditing&&(this.supportsAdd||this.supportsUpdate))}get supportsZ(){return!!this.layer?.hasZ&&!!this._capabilities?.data?.supportsZ}get visibleAtCurrentScale(){let{layer:e}=this;return!e||!this.effectiveFilterByLayerScaleRange?!1:C(e.effectiveScaleRange,this.view?.scale)}async addAttachment(e,t){let{_layerWithAttachmentsEditing:n}=this;if(!n||!this.supportsAddAttachments)return{};let r=await this._queueAttachmentsOperation(e,()=>n.addAttachment(this._createBaseGraphic(n,e),t));return this._ensureArrayContent(r)}addPendingEdits(e){let t=this._ensureLayerAndUpdateSupport();if(!this.editingEnabled){this._logWarning(`store:editing-disabled`,`Editing is disabled.`);return}this.autoSaveEnabled&&this._logWarning(`store:pending-edit`,`Edit will be cached, but 'autoSaveEnabled' is true.`,!0),this._stashPendingEdits(t,e)}async deleteAttachments(e,t){let{_layerWithAttachmentsEditing:n}=this;if(!n||!this.supportsUpdateAttachments||!t.length)return[];let r=await this._queueAttachmentsOperation(e,()=>n.deleteAttachments(this._createBaseGraphic(n,e),t));return this._ensureArray(r)}async deleteRowsByObjectId(e){let{_layerWithEditing:t}=this;if(!this.supportsDelete||!t)throw new s(`store:delete-error`,`Delete is not supported.`);let n=e.map(e=>this.getItemByObjectId(e)?.feature).filter(i),r=this._queueEditOperation(()=>t.applyEdits({deleteFeatures:n}));return e.forEach(e=>{this.featureTitleMap.delete(e),this._discardPendingEdit({objectId:e})}),r}discardPendingEdits(e){if(e?.length){e.forEach(e=>this._discardPendingEdit(e));return}for(let[e,t]of this._pendingEditsCache){let n=this.getItemByObjectId(e);n&&(n.feature=t.originalFeature)}this._pendingEditsCache.clear(),this._clearOptionsAndViolations()}itemHasInvalidPendingEdits(e,t){if(!this.hasInvalidPendingEdits)return!1;let n=this._layerWithContingentValues,r=this._pendingEditsCache.get(e);if(!n||!r)return!1;let i=this._getFeatureWithPendingEdits(e,r),a=this._contingentValuesManager;return t?!!a.getViolationForField(n,i,t):!!a.getAllViolations(n,i)}itemHasPendingEdits(e,t){let n=this._pendingEditsCache.get(e);return n?!t||n.changes.has(t):!1}async getAttachmentsByObjectId(e,t){let n=this.getItemByObjectId(e)?.attachments??[];return!n.length&&t?(await this._queryAttachments([e]))[e]??[]:n}getCachedFeaturesByPageIndex(e){return this.pageCache.get(e)}getFieldValueOptions(e){return this._contingentValuesManager.getFieldValueOptions(e)}async getFeatureTitle(e,n=!1){let{layer:r}=this,i=this.featureTitleMap.get(e),a=`${e}`;if(!r)return i||a;if(i&&!n)return i;if(!(`getFeatureTitle`in r)||!r.getFeatureTitle)return a;let o=this.getItemByObjectId(e)?.feature;o||=new t({attributes:{[r.objectIdField]:e},origin:r.graphicOrigin});let s=await r.getFeatureTitle(o,{fetchMissingFields:!0,removeHTML:!0});return s?(this.featureTitleMap.set(e,s),s):a}getItemByObjectId(e){for(let t of this.pageCache.values())for(let n of t)if(n.objectId===e)return n}getItemIndexByObjectId(e){let{pageCache:t,pageSize:n}=this,r=t.entries(),i=-1;for(let[t,a]of r)if(a.some((r,a)=>{let o=r.objectId===e;return o&&(i=t*n+a),o}),i>-1)break;return i}async load(){await m(this._loadDebounced())}async queryPage(e){let{layer:t,state:n}=this;if(!t||n!==`loaded`||!this.supportsQuery||this.size===0||this.maxSize===0)return[];let{pageIndex:r}=e;if(!V(r,this.pageCount))return[];let i=e.pageSize??this.pageSize,a=r*i,o=a+i;return await m(this._query({layer:t,start:a,num:o,pageIndex:r,pageSize:i}))??[]}async refresh(){await m(this._refreshDebounced())}reset(){this._reset()}async savePendingEdits(){let e=this._ensureLayerAndUpdateSupport();if(!this.editingEnabled){this._logWarning(`store:editing-disabled`,`Editing is disabled.`);return}if(this.autoSaveEnabled&&this._logWarning(`store:pending-edit`,`Edit will be cached, but 'autoSaveEnabled' is true.`,!0),!this._canSavePendingEdits){this._logError(`store:update-error`,`An error occurred. Unable to save pending edits.`);return}let t=[];for(let[e]of this._pendingEditsCache){let n=this.getItemByObjectId(e);n?.feature&&t.push(n.feature)}(await this._update(e,t,!0)).updateFeatureResults.find(e=>e.error)&&this.discardPendingEdits(),this._clearOptionsAndViolations()}syncSelectionSources(){let{defaultSelectionManager:e,layer:t,view:n}=this;e.view=n,e.sources.removeAll(),I(t)&&(e.sources.items=[t])}async updateAttachment(e,t,n){let{_layerWithAttachmentsEditing:r}=this;if(!r||!this.supportsUpdateAttachments)return{};let i=await this._queueAttachmentsOperation(e,()=>r.updateAttachment(this._createBaseGraphic(r,e),t,n));return this._ensureArrayContent(i)}async updateItem(e){let t=this._ensureLayerAndUpdateSupport();if(!this.editingEnabled){this._logWarning(`store:editing-disabled`,`Editing is disabled.`);return}if(this.hasContingentValues){let t=e.updates.some(e=>this.fieldsWithContingentValues.has(e.fieldName)),n=this.itemHasPendingEdits(e.objectId);if(n||t){let t=this._layerWithContingentValues,r=this.getItemByObjectId(e.objectId)?.feature?.clone();if(r){let i=this._contingentValuesManager.getAllViolations(t,r);if(e.updates.forEach(({fieldName:e,value:n})=>{let i=t.getField(e);i&&(r.attributes[i.name]=n)}),this._contingentValuesManager.validateContingencyConstraints(t,r).length||i.length||n){this._stashPendingEdits(t,[e]),this._contingentValuesManager.resetOptionsForLayer(t);return}}}}if(!this.autoSaveEnabled){this._stashPendingEdits(t,[e]);return}let{_sortedFieldNames:n}=this,r=e.updates.map(({fieldName:e})=>e),i=this._prepareEditsForUpdate([e]);!(await this._update(t,i)).updateFeatureResults.find(e=>e.error)&&r.some(e=>n.includes(e))&&this._clearCaches()}async verifyFeaturesByObjectId(e){let{layer:t,state:n}=this;if(!t||n!==`loaded`)return[];let{objectIdField:r}=t,i=await this._queryFeaturesByObjectId(e);return e.map(e=>i.some(t=>e===(t.getObjectId()??t.attributes[r])))}async _load(){let{layer:e}=this;if(this._reset(),!e)return;let t=new AbortController;this._loadController=t;try{if(await e.load(),e.parent&&E(e.parent)&&await e.parent.loadAll(),await e.when(),t.signal.aborted)return;let n=this.initialSize;if(this.initialSize=null,this.effectiveFilterByLayerScaleRange&&(this.visibleAtCurrentScale||(n=0)),await m(this._refresh(t,n)),t.signal.aborted){this._loadController=null;return}this._loaded=!0,this._loadController=null}catch(e){throw this._reset(),this._loadError=!0,this._logError(`store:load-error`,`An error occurred.`),e}}async _refresh(e,t){this._clearCaches();let n=e?.signal,r=await this._getSize(n,t),i=await this._queryAllObjectIds(n);n?.aborted||(this._size=r,this._objectIdCache.removeAll(),i?.length&&this._objectIdCache.addMany(i),this._syncPendingEdits())}async _queryAllObjectIds(e){return this.supportsPagination?void 0:await this._queryObjectIds(e)}_clearCaches(){this.pageCache.clear(),this._objectIdCache.removeAll()}_createBaseGraphic(e,n){let r=new t({attributes:{[e.objectIdField]:n}});return this._subtypeField&&this._subtypeCode!=null&&(r.attributes[this._subtypeField]=this._subtypeCode),r}_ensureArray(e){return Array.isArray(e)?e:[e]}_ensureArrayContent(e){return Array.isArray(e)?e[0]:e}_getObjectIdsForFeatures(e,t){return e.map(e=>e.getObjectId()??e.attributes[t.objectIdField])}_getObjectIdsForPage(e,t){let n=this._objectIdCache.toArray();return n.length>=e+t?n.slice(e,e+t):n.slice(e)}_logError(e,t){l.getLogger(this).error(e,t)}_logWarning(e,t,n=!1){n?l.getLogger(this).warnOnce(e,t):l.getLogger(this).warn(e,t)}_reset(){this._clearCaches(),this._pendingEditsCache.clear(),this.failures.removeAll(),this._attachmentsOperationQueue.removeAll(),this._editOperationQueue.removeAll(),this.featureTitleMap.clear(),this._loadController=f(this._loadController),this._queryOperationInfos.forEach(e=>e.controller.abort()),this._queryOperationInfos.clear(),this._temporaryHighlight=d(this._temporaryHighlight?.handle),this._temporaryHighlightAbortController=f(this._temporaryHighlightAbortController),this._loaded=!1,this._loadError=!1,this._size=0}async _getSize(e,t){return this.maxSize===0?0:t??await this._queryCount(e)}async _queryFeaturesByObjectId(e){let{layer:t}=this;if(!t||!this.supportsQuery)throw new s(`store:query-error`,`Layer does not support query operation.`);let{effectiveTimeExtent:n,effectiveWhere:r,orderByFields:i,supportsCacheHint:a,supportsOrderBy:o}=this,c=t.createQuery();return c.where=r,c.timeExtent=n,c.returnGeometry=!1,c.objectIds=e.length?e:void 0,c.outFields=[t.objectIdField],o&&(c.orderByFields=i),a&&(c.cacheHint=!0),(await t.queryFeatures(c)).features}async _syncTemporaryHighlight(e,t){let{highlightEnabled:n,highlightableLayerView:r}=this;r&&n&&e!=null&&(h(t),this._temporaryHighlight={id:e,handle:r.highlight(e,{name:N})})}_ensureLayerAndUpdateSupport(){let e=this._layerWithEditing;if(!e||!this.supportsUpdate)throw new s(`store:update-error`,`Update is not supported.`);return e}_stashPendingEdits(e,t){t.forEach(({objectId:t,updates:n})=>{let r=this.getItemByObjectId(t)?.feature;if(!r)throw new s(`store:update-error`,`Feature with provided 'objectId' not found.`);let i=r.clone(),a=u(this._pendingEditsCache,t,()=>({originalFeature:i,changes:new g}));n.forEach(({fieldName:t,value:n})=>{let i=e.getField(t);i?(a.changes.set(i.name,n),r.attributes[i.name]=n):this._logWarning(`store:pending-edit-unknown-field`,`The provided field does not belong to this layer.`)}),a.changes.size>0&&this._pendingEditsCache.set(t,a)})}_syncPendingEdits(){for(let[e,t]of this._pendingEditsCache){let n=this.getItemByObjectId(e)?.feature;if(n){let e=n.clone();for(let[e,r]of t.changes)n.attributes[e]=r;t.originalFeature=e}}}_getFeatureWithPendingEdits(e,t){let n=this.getItemByObjectId(e)?.feature;if(!n){n=t.originalFeature.clone();for(let[e,r]of t.changes)n.attributes[e]=r}return n}_discardPendingEdit({objectId:e,fieldName:t}){let n=this._pendingEditsCache.get(e);if(!n){this._logWarning(`store:pending-edit-not-found`,`Could not find a pending edit with the given information`);return}let r=this.getItemByObjectId(e);t?(r&&(r.feature.attributes[t]=n.originalFeature.attributes[t]),n.changes.delete(t),n.changes.size===0&&this._pendingEditsCache.delete(e)):(r&&(r.feature=n.originalFeature),this._pendingEditsCache.delete(e))}_clearOptionsAndViolations(){let{_layerWithContingentValues:e,_contingentValuesManager:t}=this;e&&(t.resetOptionsForLayer(e),t.resetViolationsForLayer(e))}_prepareEditsForUpdate(e){let n=[];return e.forEach(({objectId:e,updates:r})=>{let i=this.getItemByObjectId(e)?.feature;if(!i)return;let a=c(i.attributes);r.forEach(({fieldName:e,value:t})=>a[e]=t),n.push(new t({attributes:a,sourceLayer:i.sourceLayer}))}),n}_update(e,t,n=!1){let r=e.applyEdits({updateFeatures:t}).then(n=>{let{updateFeatureResults:r}=n,i=r.find(e=>!!e.error);if(i)throw i.error;return t.forEach(t=>{let n=t.getObjectId()??t.attributes[e.objectIdField],r=this.getItemByObjectId(n)?.feature;r&&(r.attributes=t.attributes),this.featureTitleMap.has(n)&&this.getFeatureTitle(n,!0)}),n});return this._queueEditOperation(()=>r,n)}_createFeatureStoreItems(e){let{attachments:t,features:n,layer:r,relatedRecords:i}=e,a=r.objectIdField;return n.map(e=>{let n=e.getObjectId()??e.attributes[a],o=[];!e.layer&&!e.sourceLayer&&(e.layer=r,e.sourceLayer=r);let s=this._pendingEditsCache.get(n);if(s){let t=e.clone(),n=s.changes;for(let[t,r]of n)e.attributes[t]=r;s.originalFeature=t}return i.forEach((e,t)=>{o.push({relationshipId:t,count:e[n]??0})}),{objectId:n,feature:e,attachments:t[n]??null,relatedRecords:o}})}async _query(e){let{pageIndex:t,refresh:n}=e;n===!0&&await this._refresh();let r=this.pageCache.get(t);if(r)return r;let i=this._queryOperationInfos.get(t);if(i)return i.task.promise;let a=new AbortController,o=await this._queryPage(e,a);return a.signal.aborted||this.pageCache.set(t,o),o}_queryAttachments(e,t){let{_layerWithAttachments:n,effectiveWhere:r}=this;return n?e.some(e=>typeof e!=`number`)?Promise.reject(new s(`invalid-object-id`,`Only numeric object ids are valid to query attachments`)):n.queryAttachments(new k({objectIds:e,where:r,returnMetadata:!0}),{signal:t}):Promise.resolve({})}async _queryCount(e){let{_relatedLayerSupportsCacheHint:t,layer:n,relationshipConfig:r,supportsCacheHint:i}=this;if(!n)return 0;if(r&&this._canUseRelatedLayer){let{objectId:n,relatedLayer:i,relationshipId:a}=r;return(await i.queryRelatedFeaturesCount(new A({cacheHint:t,relationshipId:a,objectIds:[n]}),{signal:e}))[n]??0}let{effectiveTimeExtent:a,effectiveWhere:o,filterGeometry:s,objectIds:c}=this,l=n.createQuery();return l.geometry=s,l.returnGeometry=!1,l.where=o,l.timeExtent=a,l.objectIds=c?.length?c:void 0,i&&(l.cacheHint=!0),n.queryFeatureCount(l,{signal:e})}async _queryFeatures(e,t){let{relationshipConfig:n}=this;if(n&&this._canUseRelatedLayer)return this._queryRelatedFeatures(e,n);let{_effectiveReturnM:r,_effectiveReturnZ:i,effectiveOutFields:a,effectiveTimeExtent:o,effectiveWhere:s,filterGeometry:c,objectIds:l,orderByFields:u,pageSize:d,returnGeometry:f,supportsCacheHint:p,supportsOrderBy:m,supportsPagination:h}=this,{layer:g,start:_}=e,v=l?.length,y=g.createQuery();return y.returnGeometry=f,y.outFields=a,y.returnM=r,y.returnZ=i,h?(y.start=_,y.num=d,y.where=s,y.timeExtent=o,y.objectIds=v?l:void 0):y.objectIds=v?l:this._getObjectIdsForPage(_,d??0),m&&(y.orderByFields=u),c&&(y.geometry=c),p&&(y.cacheHint=!0),(await g.queryFeatures(y,{signal:t})).features}_queryObjectIds(e){let{effectiveTimeExtent:t,effectiveWhere:n,filterGeometry:r,layer:i,objectIds:a,orderByFields:o,supportsCacheHint:s,supportsOrderBy:c}=this;if(!i)return Promise.resolve([]);let l=i.createQuery();return l.geometry=r,l.outFields=[i.objectIdField],l.returnGeometry=!1,l.where=n,l.timeExtent=t,l.objectIds=a?.length?a:void 0,c&&(l.orderByFields=o),s&&(l.cacheHint=!0),i.queryObjectIds(l,{signal:e})}async _queryPage(e,t){return this._queueQueryOperation(e.pageIndex,{controller:t,task:a(async()=>this._queryPageData(e,t))})}async _queryPageData(e,t){let{layer:n}=e,{signal:r}=t,i=await this._queryFeatures(e,r);if(r.aborted)return[];let a=this._getObjectIdsForFeatures(i,n),[o,s]=await Promise.all([this._queryAttachments(a,r),this._queryRelatedCounts(a,r)]);return t.signal.aborted?[]:this._createFeatureStoreItems({layer:n,features:i,attachments:o,relatedRecords:s})||[]}async _queryRelatedCounts(e,t){let{_layerWithRelationships:n,relationshipIds:r,supportsCacheHintQueryRelated:i}=this,a=new Map;return!n||!e?.length||!r.length||await Promise.allSettled(r.map(async r=>{let o=await n.queryRelatedFeaturesCount(new A({cacheHint:i,relationshipId:r,objectIds:e}),{signal:t});a.set(r,o)})),a}async _queryRelatedFeatures(e,t){let{_defaultOutFields:n,_effectiveReturnM:r,_effectiveReturnZ:i,orderByFields:a,pageSize:o,returnGeometry:s,supportsCacheHint:c}=this,{layer:l,start:u}=e,{objectId:d,relatedLayer:f,relationshipId:p}=t,m=l.createQuery(),h=new A({cacheHint:c,num:o,objectIds:[d],orderByFields:a,outFields:n,relationshipId:p,returnGeometry:s,returnM:r,returnZ:i,start:u,where:m.where??void 0});return(await f.queryRelatedFeatures(h))[d]?.features||[]}_queueAttachmentsOperation(e,t){return this._attachmentsOperationQueue.push(t),t().then(async n=>{this._attachmentsOperationQueue.remove(t);let r=this._ensureArray(n),i=r.some(e=>e.error),a=this.getItemByObjectId(e);return a&&(!i||r.length>1)&&(a.attachments=(await this._queryAttachments([e]))[e]),n}).catch(async n=>{this._logError(`store:attachment-error`,`An error occurred.`);let r={error:n,retry:()=>{this.failures.remove(r),this._queueAttachmentsOperation(e,t)},cancel:()=>this.failures.remove(r)};throw this.failures.add(r),this._attachmentsOperationQueue.remove(t),n})}_queueEditOperation(e,t=!1){return this._editOperationQueue.push(e),e().then(n=>(this._editOperationQueue.remove(e),t&&this._pendingEditsCache.clear(),n)).catch(t=>{this._logError(`store:edit-error`,`An error occurred.`);let n={error:t,retry:()=>{this.failures.remove(n),this._queueEditOperation(e)},cancel:()=>this.failures.remove(n)};throw this.failures.add(n),this._editOperationQueue.remove(e),t})}async _queueQueryOperation(e,t){this._queryOperationInfos.set(e,t);let n=await t.task.promise;return this._queryOperationInfos.delete(e),n}};e([x()],W.prototype,`_attachmentsOperationQueue`,void 0),e([x({readOnly:!0})],W.prototype,`_capabilities`,null),e([x()],W.prototype,`_canSavePendingEdits`,null),e([x()],W.prototype,`_contingentValuesManager`,void 0),e([x()],W.prototype,`_defaultOutFields`,void 0),e([x()],W.prototype,`_editOperationQueue`,void 0),e([x()],W.prototype,`_effectiveReturnZ`,null),e([x()],W.prototype,`_effectiveReturnM`,null),e([x()],W.prototype,`featureTitleMap`,void 0),e([x({readOnly:!0})],W.prototype,`_layerWithAttachments`,null),e([x({readOnly:!0})],W.prototype,`_layerWithAttachmentsEditing`,null),e([x()],W.prototype,`_layerWithContingentValues`,null),e([x({readOnly:!0})],W.prototype,`_layerWithEditing`,null),e([x({readOnly:!0})],W.prototype,`_layerWithRelationships`,null),e([x()],W.prototype,`_loaded`,void 0),e([x()],W.prototype,`_loadController`,void 0),e([x()],W.prototype,`_loadError`,void 0),e([x()],W.prototype,`_objectIdCache`,void 0),e([x()],W.prototype,`_pendingEditsCache`,void 0),e([x()],W.prototype,`_pendingEditsAreInvalid`,null),e([x()],W.prototype,`_queryOperationInfos`,void 0),e([x({readOnly:!0})],W.prototype,`_relatedLayer`,null),e([x({readOnly:!0})],W.prototype,`_relatedLayerCapabilities`,null),e([x({readOnly:!0})],W.prototype,`_relatedLayerSupportsCacheHint`,null),e([x()],W.prototype,`_relatedLayerSupportsQuery`,null),e([x()],W.prototype,`_relatedLayerSupportsQueryRelated`,null),e([x()],W.prototype,`_size`,void 0),e([x()],W.prototype,`_sortedFieldNames`,null),e([x()],W.prototype,`_subtypeCode`,null),e([x()],W.prototype,`_subtypeField`,null),e([x()],W.prototype,`_canUseRelatedLayer`,null),e([x()],W.prototype,`attachmentsEnabled`,void 0),e([x()],W.prototype,`autoSaveEnabled`,void 0),e([x()],W.prototype,`cachedPageCount`,null),e([x()],W.prototype,`canAddRelatedFeature`,null),e([x()],W.prototype,`defaultSelectionManager`,void 0),e([x()],W.prototype,`editingEnabled`,void 0),e([x()],W.prototype,`effectiveFilterByLayerScaleRange`,null),e([x()],W.prototype,`effectiveOutFields`,null),e([x()],W.prototype,`effectiveSelectionManager`,null),e([x()],W.prototype,`effectiveSize`,null),e([x()],W.prototype,`effectiveTimeExtent`,null),e([x()],W.prototype,`effectiveWhere`,null),e([x({readOnly:!0})],W.prototype,`failures`,void 0),e([x()],W.prototype,`fieldsWithContingentValues`,null),e([x()],W.prototype,`filterByViewExtent`,void 0),e([x()],W.prototype,`filterByLayerScaleRange`,void 0),e([x({types:w})],W.prototype,`filterGeometry`,void 0),e([x()],W.prototype,`hasContingentValues`,null),e([x()],W.prototype,`hasInvalidPendingEdits`,null),e([x()],W.prototype,`hasPendingEdits`,null),e([x()],W.prototype,`highlightEnabled`,void 0),e([x()],W.prototype,`highlightableLayerView`,null),e([x()],W.prototype,`initialSize`,void 0),e([x({readOnly:!0})],W.prototype,`isQuerying`,null),e([x({readOnly:!0})],W.prototype,`isSyncing`,null),e([x({readOnly:!0})],W.prototype,`isSyncingAttachmentEdits`,null),e([x({readOnly:!0})],W.prototype,`isSyncingFeatureEdits`,null),e([x({readOnly:!0})],W.prototype,`itemCache`,null),e([x()],W.prototype,`layer`,void 0),e([x()],W.prototype,`layerView`,null),e([x()],W.prototype,`maxSize`,void 0),e([x()],W.prototype,`objectIds`,void 0),e([x()],W.prototype,`orderByFields`,null),e([x()],W.prototype,`outFields`,void 0),e([x({readOnly:!0})],W.prototype,`pageCache`,void 0),e([x()],W.prototype,`pageCount`,null),e([x()],W.prototype,`pageIndex`,null),e([x()],W.prototype,`pageSize`,void 0),e([x()],W.prototype,`paginationEnabled`,void 0),e([x()],W.prototype,`pendingEditsCount`,null),e([x()],W.prototype,`relationship`,null),e([x()],W.prototype,`relationshipConfig`,void 0),e([x()],W.prototype,`relationshipIds`,null),e([x()],W.prototype,`relationshipInfos`,null),e([x()],W.prototype,`relationships`,null),e([x()],W.prototype,`relatedRecordsEnabled`,void 0),e([x()],W.prototype,`returnGeometry`,void 0),e([x()],W.prototype,`returnZ`,void 0),e([x()],W.prototype,`returnM`,void 0),e([x()],W.prototype,`selectionManager`,void 0),e([x({readOnly:!0})],W.prototype,`size`,null),e([x()],W.prototype,`sortOrders`,void 0),e([x({readOnly:!0})],W.prototype,`state`,null),e([x()],W.prototype,`supportsAdd`,null),e([x()],W.prototype,`supportsAddAttachments`,null),e([x()],W.prototype,`supportsAttachments`,null),e([x()],W.prototype,`supportsCacheHint`,null),e([x()],W.prototype,`supportsCacheHintQueryRelated`,null),e([x()],W.prototype,`supportsDelete`,null),e([x()],W.prototype,`supportsEditing`,null),e([x()],W.prototype,`supportsM`,null),e([x()],W.prototype,`supportsOrderBy`,null),e([x()],W.prototype,`supportsPagination`,null),e([x()],W.prototype,`supportsQuery`,null),e([x()],W.prototype,`supportsQueryRelated`,null),e([x()],W.prototype,`supportsResizeAttachments`,null),e([x()],W.prototype,`supportsUpdate`,null),e([x()],W.prototype,`supportsUpdateAttachments`,null),e([x()],W.prototype,`supportsZ`,null),e([x()],W.prototype,`syncViewSelection`,void 0),e([x()],W.prototype,`temporaryHighlightId`,void 0),e([x({type:j})],W.prototype,`timeExtent`,void 0),e([x()],W.prototype,`timeZone`,void 0),e([x()],W.prototype,`view`,void 0),e([x()],W.prototype,`viewTimeEnabled`,void 0),e([x()],W.prototype,`visibleAtCurrentScale`,null),e([x()],W.prototype,`where`,void 0),W=e([S(`esri.widgets.FeatureTable.support.FeatureStore`)],W);const G=W;export{G as default};

package/widgets/Fullscreen/FullscreenViewModel.d.ts CHANGED Viewed

@@ -1,17 +1,19 @@
 import type Accessor from "../../core/Accessor.js";
 import type { MapViewOrSceneView } from "../../views/MapViewOrSceneView.js";
+/** @deprecated since 5.2. Use the [Fullscreen component](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-fullscreen/) instead. */
 export interface FullscreenViewModelProperties extends Partial<Pick<FullscreenViewModel, "view">> {
   /** The [HTMLElement](https://developer.mozilla.org/docs/Web/API/HTMLElement) to present in fullscreen mode. */
   element?: HTMLElement | null;
 }
+/** @deprecated since 5.2. Use the Fullscreen component's [`state`](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-fullscreen/#state) property instead. The component uses `"unsupported"` where this type uses `"feature-unsupported"`. */
 export type FullscreenViewModelState = "active" | "disabled" | "feature-unsupported" | "ready";
 /**
  * Provides the logic for the [Fullscreen](https://developers.arcgis.com/javascript/latest/references/core/widgets/Fullscreen/) widget.
  *
- * @deprecated since version 4.33. Use the JavaScript [Fullscreen API](https://developer.mozilla.org/docs/Web/API/Fullscreen_API) directly instead.
+ * @deprecated since version 4.33. Use the JavaScript [Fullscreen API](https://developer.mozilla.org/docs/Web/API/Fullscreen_API) directly or the [Fullscreen component](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-fullscreen/) for map UI instead.
  * @since 4.6
  * @see [Fullscreen](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-fullscreen/) component
  * @see [Fullscreen](https://developers.arcgis.com/javascript/latest/references/core/widgets/Fullscreen/) widget - _Deprecated since 4.32. Use the [Fullscreen component](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-fullscreen/) instead._

package/widgets/Home/HomeViewModel.d.ts CHANGED Viewed

@@ -4,6 +4,7 @@ import type { MapViewOrSceneView } from "../../views/MapViewOrSceneView.js";
 import type { GoTo, GoToProperties } from "../support/GoTo.js";
 import type { ViewpointProperties } from "../../Viewpoint.js";
+/** @deprecated since 5.2. Use the [Home component](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-home/) instead. */
 export interface HomeViewModelProperties extends GoToProperties, Partial<Pick<HomeViewModel, "view">> {
   /**
    * The [Viewpoint](https://developers.arcgis.com/javascript/latest/references/core/Viewpoint/), or point of view, to zoom to when
@@ -26,6 +27,7 @@ export interface HomeViewModelProperties extends GoToProperties, Partial<Pick<Ho
   viewpoint?: ViewpointProperties | null;
 }
+/** @deprecated since 5.2. Use the Home component's [`state`](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-home/#state) property instead. */
 export type HomeViewModelState = "disabled" | "going-home" | "ready";
 /** @deprecated since 5.0. Use the [Home component](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-home/) directly instead. */

package/widgets/ScaleRangeSlider/ScaleRanges.d.ts CHANGED Viewed

@@ -1,6 +1,7 @@
 import type Accessor from "../../core/Accessor.js";
 import type { ScaleRange } from "../../layers/types.js";
+/** @deprecated since 5.2. Use the [arcgis-slider-scale-range](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-slider-scale-range/) component directly instead. */
 export interface ScaleRangesProperties {}
 /** Lists the recommended scales for each named scale range. */
@@ -56,9 +57,11 @@ export interface NamedScaleRange extends ScaleRange {
  * The ScaleRanges class represents the ranges of scales for the
  * [ScaleRangeSlider](https://developers.arcgis.com/javascript/latest/references/core/widgets/ScaleRangeSlider/) widget.
  *
+ * @deprecated since 5.2. Use the [arcgis-slider-scale-range](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-slider-scale-range/) component directly instead.
  * @since 4.13
  * @see [ScaleRangeSlider](https://developers.arcgis.com/javascript/latest/references/core/widgets/ScaleRangeSlider/)
  * @see [ScaleRangeSliderViewModel](https://developers.arcgis.com/javascript/latest/references/core/widgets/ScaleRangeSlider/ScaleRangeSliderViewModel/)
+ * @see [Scale Range Slider component](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-slider-scale-range/)
  */
 export default class ScaleRanges extends Accessor {
   /** The recommended scales at each of the named scale ranges. */

package/widgets/ScaleRangeSlider/types.d.ts CHANGED Viewed

@@ -77,19 +77,19 @@
  * | `VI` | U.S. Virgin Islands|
  * | `ZA` | South Africa|
  *
- * @deprecated since 5.2. Use the [Scale Range Slider](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-slider-scale-range/) component instead.
+ * @deprecated since 5.2. Use the [Scale Range Slider component SupportedRegion](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-slider-scale-range/spriteSheetsUtils/#SupportedRegion) instead.
  * @since 5.0
  */
 export type SupportedRegion = LowerCaseRegion | UpperCaseRegion;
 /**
- * @deprecated since 5.2. Use the [Scale Range Slider](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-slider-scale-range/) component instead.
+ * @deprecated since 5.2. Use the [Scale Range Slider component LowerCaseRegion](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-slider-scale-range/spriteSheetsUtils/#LowerCaseRegion) instead.
  * @since 5.0
  */
 export type LowerCaseRegion = "ae" | "ar" | "at" | "au" | "be" | "bg" | "bo" | "br" | "ca" | "ch" | "ci" | "cl" | "cn" | "co" | "cr" | "cz" | "de" | "dk" | "ee" | "eg" | "es" | "fi" | "fr" | "gb" | "gl" | "gr" | "gt" | "hk" | "id" | "ie" | "il" | "in" | "iq" | "is" | "it" | "jp" | "ke" | "kr" | "kw" | "li" | "lt" | "lu" | "lv" | "ma" | "mg" | "ml" | "mo" | "mx" | "my" | "ni" | "nl" | "no" | "nz" | "pe" | "pl" | "pr" | "pt" | "ro" | "ru" | "rw" | "se" | "sg" | "sk" | "sr" | "sv" | "th" | "tn" | "tw" | "us" | "ve" | "vi" | "za";
 /**
- * @deprecated since 5.2. Use the [Scale Range Slider](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-slider-scale-range/) component instead.
+ * @deprecated since 5.2. Use the [Scale Range Slider component UpperCaseRegion](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-slider-scale-range/spriteSheetsUtils/#UpperCaseRegion) instead.
  * @since 5.0
  */
 export type UpperCaseRegion = Uppercase<LowerCaseRegion>;