@arcgis/map-components 5.0.0-next.93 → 5.0.0-next.95

package/dist/chunks/AnalysisViewModel.js

@@ -1,32 +1,32 @@
-import { forceInteractive as d } from "@arcgis/core/applications/Components/analysisUtils.js";
-import v from "@arcgis/core/core/Accessor.js";
-import { property as a, subclass as V } from "@arcgis/core/core/accessorSupport/decorators.js";
-import { ignoreAbortErrors as f } from "@arcgis/core/core/promiseUtils.js";
-import { when as m, watch as w, on as A, whenOnce as b } from "@arcgis/core/core/reactiveUtils.js";
+import { forceInteractive as _ } from "@arcgis/core/applications/Components/analysisUtils.js";
+import f from "@arcgis/core/core/Accessor.js";
+import { property as r, subclass as V } from "@arcgis/core/core/accessorSupport/decorators.js";
+import { ignoreAbortErrors as v } from "@arcgis/core/core/promiseUtils.js";
+import { when as m, watch as w, on as A, whenOnce as g } from "@arcgis/core/core/reactiveUtils.js";
 import { log as p } from "@arcgis/toolkit/log";
-import { c as _, t as g, a as O, b as U } from "./async-utils.js";
-import { a as l } from "./maybe.js";
+import { c as u, t as O, a as I, b } from "./async-utils.js";
+import { a as h } from "./maybe.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/5.0/esri/copyright.txt for details.
-v5.0.0-next.93 */
-var F = Object.defineProperty, T = Object.getOwnPropertyDescriptor, i = (s, t, n, r) => {
-  for (var o = r > 1 ? void 0 : r ? T(t, n) : t, h = s.length - 1, c; h >= 0; h--)
-    (c = s[h]) && (o = (r ? c(t, n, o) : c(o)) || o);
-  return r && o && F(t, n, o), o;
+v5.0.0-next.95 */
+var F = Object.defineProperty, T = Object.getOwnPropertyDescriptor, a = (s, e, i, n) => {
+  for (var o = n > 1 ? void 0 : n ? T(e, i) : e, c = s.length - 1, l; c >= 0; c--)
+    (l = s[c]) && (o = (n ? l(e, i, o) : l(o)) || o);
+  return n && o && F(e, i, o), o;
 };
 const y = Symbol("interactiveHandle");
-let e = class extends v {
-  // No properties are set in the constructor. The component should support assignments at any time and component
-  // properties are only assigned after the view models is constructed.
+let t = class extends f {
+  // #region Lifecycle
+  // Intentionally keep constructor side-effect free: callers may set properties in any order after instantiation.
   constructor() {
-    super({}), this.shouldForceInteractive = !0, this._ownsAnalysis = !1, this._operationState = "inactive", this._loggedUnsupportedErrorMessage = !1, this._changeFromReconnect = !1, this._startUserOperation = null;
+    super({}), this.operationState = "inactive", this._ownsAnalysis = !1, this.shouldForceInteractive = !0, this._changeFromReconnect = !1, this._userOperationInfo = null, this._loggedUnsupportedErrorMessage = !1;
   }
   initialize() {
     this._set("analysis", this.constructAnalysis()), this._ownsAnalysis = !0;
     const s = () => {
       !this._changeFromReconnect && !this._viewHasAnalysis && (this._ownsAnalysis = !1);
-      const t = !this._changeFromReconnect;
-      this._changeFromReconnect = !1, t && this._scheduleViewReconnect();
+      const e = !this._changeFromReconnect;
+      this._changeFromReconnect = !1, e && this._scheduleViewReconnect();
     };
     this.addHandles([
       m(
@@ -40,8 +40,8 @@ let e = class extends v {
       A(
         () => this.view,
         "analysis-view-destroy",
-        (t) => {
-          t.analysis === this.analysis && s();
+        (e) => {
+          e.analysis === this.analysis && s();
         }
       ),
       w(
@@ -50,193 +50,204 @@ let e = class extends v {
           ready: !!this.view?.ready,
           supported: this.supported
         }),
-        ({ view: t }, n) => {
-          const r = n?.view;
-          t !== r && (this._startUserOperation = l(this._startUserOperation), this._disconnectFromView(r)), this._scheduleViewReconnect();
+        ({ view: e }, i) => {
+          const n = i?.view;
+          e !== n && (this._userOperationInfo = h(this._userOperationInfo), this._disconnectFromView(n)), this._scheduleViewReconnect();
         },
         { sync: !0, initial: !0 }
       )
     ]);
   }
   destroy() {
-    this._reconnectViewTask = l(this._reconnectViewTask), this._startUserOperation = l(this._startUserOperation), this._analysisView != null && (this._analysisView.visible = void 0), this._disconnectFromView(this.view), this._set("view", null), this._ownsAnalysis && this.analysis?.destroy();
+    this._reconnectViewTask = h(this._reconnectViewTask), this._userOperationInfo = h(this._userOperationInfo), this.analysisView != null && (this.analysisView.visible = void 0), this._disconnectFromView(this.view), this._set("view", null), this._ownsAnalysis && this.analysis?.destroy();
   }
-  get supported() {
-    return this.view == null || this.supportedViewType === "both" || this.view.type === this.supportedViewType;
+  get active() {
+    return this._userOperationInfo?.state === "running";
   }
-  set visible(s) {
-    this._set("visible", s), this._analysisView != null && (this._analysisView.visible = s);
+  set analysis(s) {
+    s !== this._get("analysis") && (this._userOperationInfo = h(this._userOperationInfo), this._disconnectFromView(this.view), this._setExternalAnalysis(s), this._scheduleViewReconnect());
   }
-  get active() {
-    return this._startUserOperation?.state === 2;
+  get connectingToView() {
+    return !!this._reconnectViewTask;
   }
   get disabled() {
     return !this.view?.ready || !this.supported;
   }
-  set analysis(s) {
-    s !== this._get("analysis") && (this._startUserOperation = l(this._startUserOperation), this._disconnectFromView(this.view), this._setExternalAnalysis(s), this._scheduleViewReconnect());
-  }
-  get analysisView() {
-    return this._analysisView;
+  set hideVisualization(s) {
+    this._set("hideVisualization", s), this.analysisView && (this.analysisView.visible = !s);
   }
   get ready() {
-    return this._analysisView != null && !this.connectingToView;
+    return !!this.analysisView && !this.connectingToView;
   }
-  get connectingToView() {
-    return this._reconnectViewTask != null;
+  get supported() {
+    return !this.view || this.supportedViewType === "both" || this.view.type === this.supportedViewType;
   }
   get _viewHasAnalysis() {
     const { view: s } = this;
     return s?.analyses.includes(this.analysis) === !0;
   }
-  get operationState() {
-    return this._operationState;
-  }
+  // #endregion
+  // #region Public Methods
   /**
-   * Removes the tool and clears the analysis by resetting its inputs.
+   * Reset analysis inputs and cancel any active user operation.
    */
   clear() {
-    this._startUserOperation = l(this._startUserOperation), this.clearAnalysis();
-  }
-  place(s) {
-    throw new Error("place() not implemented for this analysis view model");
+    this._userOperationInfo = h(this._userOperationInfo), this.clearAnalysis();
   }
   /**
-   * If analysis has unset inputs, start() will kick off the user operation to specify those inputs.
+   * Start the user operation.
+   *
+   * If the required analysis inputs are missing, this calls `place()` once the view is ready. You can provide a custom
+   * `operation` to override the default behavior. Set `clear: false` to retain existing analysis inputs.
    */
   async start(s) {
-    if (!this.visible) {
+    if (this.hideVisualization) {
       p("warn", this, "Cannot start analysis when not visible");
       return;
     }
     s?.clear !== !1 && this.clear();
-    const t = {
+    const e = {
       task: null,
       abort: null,
-      state: 0
-      /* PENDING */
-    }, n = _(async (r) => {
-      if (t.state = 1, await b(() => this.ready, r), t.state = 2, this._analysisView == null || this.view == null)
+      state: "pending"
+    }, i = u(async (n) => {
+      if (e.state = "wait-for-view-ready", await g(() => this.ready, n), e.state = "running", !this.analysisView || !this.view)
         return;
-      this._operationState = "active";
-      const o = s?.operation?.({ signal: r }) ?? this.place({ signal: r });
-      await f(o);
+      this.operationState = "active";
+      const o = s?.operation?.({ signal: n }) ?? this.place({ signal: n });
+      await v(o);
     });
-    return n.promise.finally(() => {
-      (this._startUserOperation === t || this._startUserOperation == null) && (this._operationState = "inactive");
-    }), t.task = n, t.abort = () => n.abort(), this._startUserOperation = t, await n.promise;
+    return i.promise.finally(() => {
+      (this._userOperationInfo === e || !this._userOperationInfo) && (this.operationState = "inactive");
+    }), e.task = i, e.abort = () => i.abort(), this._userOperationInfo = e, await i.promise;
   }
+  /**
+   * Stop the active user operation, if any.
+   */
   stop() {
-    this._startUserOperation = l(this._startUserOperation);
+    this._userOperationInfo = h(this._userOperationInfo);
   }
+  // #endregion
+  // #region Private/Protected Methods
+  /**
+   * Define the interactive placement workflow for the analysis.
+   * Implement in subclasses to collect required inputs. Honor `AbortSignal`.
+   */
+  place(s) {
+    throw new Error("place() not implemented for this analysis view model");
+  }
+  /**
+   * Hook for subclasses to clear analysis inputs when `clear()` is called.
+   */
   clearAnalysis() {
   }
   /**
-   * A callback used by view models that manage an analysis belonging to an Layer.
-   *
-   * The function will be called each time the view becomes ready, the internal Layer of
-   * the view model has been added to the map and the analysis view of the analysis has been created.
+   * Hook for subclasses managing an analysis that belongs to a layer.
+   * Called when the view is ready and the `analysisView` is created.
    */
   onConnectToAnalysisView(s) {
   }
   /**
-   * A callback used by view models that manage an analysis.
-   *
-   * The function will be called each time the view becomes unready and the internal analysis
-   * has been removed the map or analyses.
+   * Hook for subclasses to react when the view becomes unready and the
+   * internal analysis is removed from the map/analyses.
    */
   onDisconnectFromAnalysisView() {
   }
   _scheduleViewReconnect() {
-    this._reconnectViewTask = l(this._reconnectViewTask);
-    const s = _(async (t) => {
+    this._reconnectViewTask = h(this._reconnectViewTask);
+    const s = u(async (e) => {
       try {
-        await this._reconnectView(t);
-      } catch (n) {
-        if (g(t), !O(n)) {
-          p("warn", this, `Failed to use analysis in view model. ${String(n)}`);
+        await this._reconnectView(e);
+      } catch (i) {
+        if (O(e), !I(i)) {
+          p("warn", this, `Failed to use analysis in view model. ${String(i)}`);
           return;
         }
-        throw n;
+        throw i;
       } finally {
         s === this._reconnectViewTask && (this._reconnectViewTask = void 0);
       }
     });
     this._reconnectViewTask = s;
   }
+  /**
+   * Reconnect the analysis to the current view, obtaining an `analysisView` when supported and ready.
+   * Aborts active operations that are past the "waiting for view" phase.
+   */
   async _reconnectView(s) {
-    const { view: t } = this, n = t?.ready && this.supported, r = this.analysis;
-    if (this._startUserOperation = u(this._startUserOperation), this._disconnectFromView(t), !n || t == null || r == null)
+    const { view: e } = this, i = e?.ready && this.supported, n = this.analysis;
+    if (this._userOperationInfo = d(this._userOperationInfo), this._disconnectFromView(e), !i || !e || !n)
       return;
-    this._ownsAnalysis && (this._changeFromReconnect = !0, t.analyses.add(r));
-    const o = await t.whenAnalysisView(r);
-    if (this._analysisView = o, U(s)) {
-      this._startUserOperation = u(this._startUserOperation);
+    this._ownsAnalysis && (this._changeFromReconnect = !0, e.analyses.add(n));
+    const o = await e.whenAnalysisView(n);
+    if (this.analysisView = o, b(s)) {
+      this._userOperationInfo = d(this._userOperationInfo);
       return;
     }
-    o.visible = this.visible, this.shouldForceInteractive && this.addHandles(d(o), y), this.onConnectToAnalysisView(o);
+    o.visible = !this.hideVisualization, this.shouldForceInteractive && this.addHandles(_(o), y), this.onConnectToAnalysisView(o);
   }
+  /**
+   * Disconnect the analysis from the given view.
+   */
   _disconnectFromView(s) {
-    s != null && this._ownsAnalysis && s.analyses.includes(this.analysis) && (this._changeFromReconnect = !0, this.clearAnalysis(), s.analyses.remove(this.analysis)), this.onDisconnectFromAnalysisView(), this.removeHandles(y), this._analysisView = void 0;
+    this._ownsAnalysis && s?.analyses.includes(this.analysis) && (this._changeFromReconnect = !0, this.clearAnalysis(), s.analyses.remove(this.analysis)), this.onDisconnectFromAnalysisView(), this.removeHandles(y), this.analysisView = void 0;
   }
+  /**
+   * Set an externally owned analysis.
+   */
   _setExternalAnalysis(s) {
-    this._analysisView != null && !this._ownsAnalysis && (this._analysisView.visible = void 0, this.removeHandles(y)), this._analysisView = void 0, this._ownsAnalysis = !1, this._set("analysis", s), this._changeFromReconnect = !1;
+    this.analysisView && !this._ownsAnalysis && (this.analysisView.visible = void 0, this.removeHandles(y)), this.analysisView = void 0, this._ownsAnalysis = !1, this._set("analysis", s), this._changeFromReconnect = !1;
   }
+  // #endregion
 };
-i([
-  a()
-], e.prototype, "supported", 1);
-i([
-  a()
-], e.prototype, "view", 2);
-i([
-  a({ type: Boolean, value: !0 })
-], e.prototype, "visible", 1);
-i([
-  a()
-], e.prototype, "active", 1);
-i([
-  a()
-], e.prototype, "disabled", 1);
-i([
-  a()
-], e.prototype, "analysis", 1);
-i([
-  a()
-], e.prototype, "_analysisView", 2);
-i([
-  a()
-], e.prototype, "shouldForceInteractive", 2);
-i([
-  a()
-], e.prototype, "analysisView", 1);
-i([
-  a()
-], e.prototype, "ready", 1);
-i([
-  a()
-], e.prototype, "connectingToView", 1);
-i([
-  a()
-], e.prototype, "_ownsAnalysis", 2);
-i([
-  a()
-], e.prototype, "_viewHasAnalysis", 1);
-i([
-  a()
-], e.prototype, "_reconnectViewTask", 2);
-i([
-  a()
-], e.prototype, "_operationState", 2);
-i([
-  a()
-], e.prototype, "operationState", 1);
-e = i([
+a([
+  r()
+], t.prototype, "active", 1);
+a([
+  r()
+], t.prototype, "analysis", 1);
+a([
+  r()
+], t.prototype, "connectingToView", 1);
+a([
+  r()
+], t.prototype, "disabled", 1);
+a([
+  r()
+], t.prototype, "hideVisualization", 1);
+a([
+  r()
+], t.prototype, "operationState", 2);
+a([
+  r()
+], t.prototype, "ready", 1);
+a([
+  r()
+], t.prototype, "supported", 1);
+a([
+  r()
+], t.prototype, "view", 2);
+a([
+  r()
+], t.prototype, "_ownsAnalysis", 2);
+a([
+  r()
+], t.prototype, "_viewHasAnalysis", 1);
+a([
+  r()
+], t.prototype, "_reconnectViewTask", 2);
+a([
+  r()
+], t.prototype, "analysisView", 2);
+a([
+  r()
+], t.prototype, "shouldForceInteractive", 2);
+t = a([
   V("esri.components.support.AnalysisViewModel")
-], e);
-function u(s) {
-  return s != null && s.state >= 2 ? (s.abort(), null) : s;
+], t);
+function d(s) {
+  return s?.state === "running" ? (s.abort(), null) : s;
 }
 export {
-  e as A
+  t as A
 };

package/dist/chunks/action-utils.js

@@ -8,7 +8,7 @@ import { g as m } from "./feature-utils.js";
 import { isZoomScreenSize as b } from "@arcgis/core/applications/Components/actionUtils.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/5.0/esri/copyright.txt for details.
-v5.0.0-next.93 */
+v5.0.0-next.95 */
 const n = new l({
   icon: "magnifying-glass-plus",
   id: "zoom-to-feature",

package/dist/chunks/async-utils.js

@@ -4,7 +4,7 @@ import d from "@arcgis/core/core/Error.js";
 import { a as h, r as p } from "./maybe.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/5.0/esri/copyright.txt for details.
-v5.0.0-next.93 */
+v5.0.0-next.95 */
 var m = Object.defineProperty, w = Object.getOwnPropertyDescriptor, s = (r, t, o, e) => {
   for (var n = e > 1 ? void 0 : e ? w(t, o) : t, l = r.length - 1, u; l >= 0; l--)
     (u = r[l]) && (n = (e ? u(t, o, n) : u(n)) || n);

package/dist/chunks/basemap-gallery-resources.js

@@ -1,6 +1,6 @@
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/5.0/esri/copyright.txt for details.
-v5.0.0-next.93 */
+v5.0.0-next.95 */
 const e = "basemap-gallery", t = {
   base: e,
   sourceLoading: `${e}--source-loading`,

package/dist/chunks/chart-utils.js

@@ -2,7 +2,7 @@ import { Root as m, addLicense as e } from "@amcharts/amcharts5/index.js";
 import { getLocale as n, getLocaleLanguage as a } from "@arcgis/core/intl.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/5.0/esri/copyright.txt for details.
-v5.0.0-next.93 */
+v5.0.0-next.95 */
 e("AM5C241025748");
 const p = "en-US", r = /* @__PURE__ */ new Map([
   ["ar", () => import("@amcharts/amcharts5/locales/ar.js")],

package/dist/chunks/chartCommon.js

@@ -1,7 +1,7 @@
 import { color as r } from "@amcharts/amcharts5/index.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/5.0/esri/copyright.txt for details.
-v5.0.0-next.93 */
+v5.0.0-next.95 */
 const t = [
   "#2888B8",
   "#EB7028",

package/dist/chunks/component-utils.js

@@ -1,7 +1,7 @@
 import "@arcgis/toolkit/log";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/5.0/esri/copyright.txt for details.
-v5.0.0-next.93 */
+v5.0.0-next.95 */
 const u = {
   "top-left": "top-left",
   "top-right": "top-right",

package/dist/chunks/constants.js

@@ -1,7 +1,7 @@
 import { c as o } from "./time-utils.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/5.0/esri/copyright.txt for details.
-v5.0.0-next.93 */
+v5.0.0-next.95 */
 const n = Math.round(o(1, "minutes", "milliseconds")), r = Math.round(o(1, "hours", "milliseconds")), t = Math.round(o(0.5, "hours", "milliseconds"));
 export {
   r as a,

package/dist/chunks/createCloseEvent.js

@@ -2,7 +2,7 @@ import { makeGenericController as l } from "@arcgis/lumina/controllers";
 import { createEvent as s } from "@arcgis/lumina";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/5.0/esri/copyright.txt for details.
-v5.0.0-next.93 */
+v5.0.0-next.95 */
 const a = l((e, r) => (r.onLoaded(() => {
   const t = e.el;
   e.listenOn(t.childElem, "calciteFlowItemClose", () => {