@arcgis/map-components 5.0.0-next.1 → 5.0.0-next.100

package/dist/chunks/AnalysisViewModel.js

@@ -1,235 +1,253 @@
-import { forceInteractive as u } from "@arcgis/core/applications/Components/analysisUtils.js";
-import d 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 V, watch as p, on as m, whenOnce as A } from "@arcgis/core/core/reactiveUtils.js";
-import { c as y, t as b, i as g, a as O } from "./async-utils.js";
-import { a as l, r as _ } from "./maybe.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 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.1 */
-var U = Object.defineProperty, T = Object.getOwnPropertyDescriptor, i = (s, t, n, r) => {
-  for (var o = r > 1 ? void 0 : r ? T(t, n) : t, c = s.length - 1, h; c >= 0; c--)
-    (h = s[c]) && (o = (r ? h(t, n, o) : h(o)) || o);
-  return r && o && U(t, n, o), o;
+v5.0.0-next.100 */
+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;
 };
-let e = class extends d {
-  // 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.
+const y = Symbol("interactiveHandle");
+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._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([
-      V(
+      m(
         () => this.view?.ready && !this.supported,
         () => {
-          this._loggedUnsupportedErrorMessage || console.error(this.unsupportedErrorMessage);
+          this._loggedUnsupportedErrorMessage || p("error", this, this.unsupportedErrorMessage);
         },
         { sync: !0, initial: !0 }
       ),
-      p(() => [this.analysis, this._viewHasAnalysis], s, { sync: !0 }),
-      m(
+      w(() => [this.analysis, this._viewHasAnalysis], s, { sync: !0 }),
+      A(
         () => this.view,
         "analysis-view-destroy",
-        (t) => {
-          t.analysis === this.analysis && s();
+        (e) => {
+          e.analysis === this.analysis && s();
         }
       ),
-      p(
+      w(
         () => ({
           view: this.view,
           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.clearAnalysis(), this._startUserOperation = l(this._startUserOperation);
+    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) {
-      console.warn("Cannot start analysis when not visible");
+    if (this.hideVisualization) {
+      p("warn", this, "Cannot start analysis when not visible");
       return;
     }
-    s?.clear === !0 && this.clear();
-    const t = {
+    s?.clear !== !1 && this.clear();
+    const e = {
       task: null,
       abort: null,
-      state: 0
-      /* PENDING */
-    }, n = y(async (r) => {
-      if (t.state = 1, await A(() => 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
   /**
-   * 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.
+   * 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() {
+  }
+  /**
+   * 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 = y(async (t) => {
+    this._reconnectViewTask = h(this._reconnectViewTask);
+    const s = u(async (e) => {
       try {
-        await this._reconnectView(t);
-      } catch (n) {
-        if (b(t), !g(n)) {
-          console.warn("Failed to use analysis in view model", 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 = w(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, O(s)) {
-      this._startUserOperation = w(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._forceInteractiveHandle = u(o), this.addHandles(this._forceInteractiveHandle), 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.analysis.clear(), s.analyses.remove(this.analysis)), this.onDisconnectFromAnalysisView(), this._forceInteractiveHandle = _(this._forceInteractiveHandle), 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._forceInteractiveHandle = _(this._forceInteractiveHandle)), 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, "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, "_forceInteractiveHandle", 2);
-i([
-  a()
-], e.prototype, "_operationState", 2);
-i([
-  a()
-], e.prototype, "operationState", 1);
-e = i([
-  v("esri.components.support.AnalysisViewModel")
-], e);
-function w(s) {
-  return s != null && s.state >= 2 ? (s.abort(), null) : s;
+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")
+], 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

@@ -1,97 +1,89 @@
 import "@arcgis/lumina";
 import "lit/static-html.js";
 import "@arcgis/core/intl.js";
-import f from "@arcgis/core/support/actions/ActionButton.js";
-import b from "@arcgis/core/support/actions/ActionToggle.js";
-import { i as y } from "./async-utils.js";
-import { g as d } from "./feature-utils.js";
-import { isZoomScreenSize as z } from "@arcgis/core/applications/Components/actionUtils.js";
+import l from "@arcgis/core/support/actions/ActionButton.js";
+import p from "@arcgis/core/support/actions/ActionToggle.js";
+import { a as d } from "./async-utils.js";
+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.1 */
-const s = new f({
+v5.0.0-next.100 */
+const n = new l({
   icon: "magnifying-glass-plus",
   id: "zoom-to-feature",
   title: "{messages.zoom}"
-}), v = new f({
+}), h = new l({
   icon: "trash",
   id: "remove-selected-feature",
   title: "{messages.remove}"
-}), c = new f({
+}), s = new l({
   icon: "magnifying-glass-plus",
   id: "zoom-to-clustered-features",
   title: "{messages.zoom}"
-}), E = new b({
+}), z = new p({
   icon: "table",
   id: "browse-clustered-features",
   title: "{messages.browseClusteredFeatures}",
   value: !1
 });
-function Z(e) {
+function P(e) {
   if (e.icon)
     return e.icon;
   if (!("image" in e && e.image) && !e.className)
     return "question";
 }
-function k(e) {
+function Q(e) {
   return e ? {
     backgroundImage: `url(${e})`
   } : {};
 }
-function C(e) {
+function E(e) {
   const { selectedFeature: t, location: a, view: o } = e;
   return o ? t ?? a ?? null : null;
 }
-async function F(e, t) {
+async function C(e, t) {
   const { location: a, selectedFeature: o, view: r, zoomFactor: i } = e;
   await t?.viewModel?.updateGeometry();
-  const n = t?.graphic, m = n?.geometry ? n : C(e);
-  if (!r || !m) {
-    const l = "zoom-to:invalid-target-or-view: Cannot zoom to location without a target and view.", g = new Error(l);
-    throw console.error(l, {
-      target: m,
-      view: r
-    }), g;
-  }
-  const p = r.scale / i, u = n?.geometry ?? e.selectedFeature?.geometry ?? a, w = u != null && u.type === "point" && await z(n ?? o, r);
-  s.active = !0, s.disabled = !0;
+  const c = t?.graphic, g = c?.geometry ? c : E(e);
+  if (!r || !g)
+    throw new Error("Cannot zoom to location without a target and view.");
+  const w = r.scale / i, u = c?.geometry ?? e.selectedFeature?.geometry ?? a, f = u?.type === "point" && await b(c ?? o, r);
+  n.active = !0, n.disabled = !0;
   try {
     await e.zoomTo({
       target: {
-        target: m,
-        scale: w ? p : void 0
+        target: g,
+        scale: f ? w : void 0
       }
     });
-  } catch (l) {
-    if (y(l))
+  } catch (y) {
+    if (d(y))
       return;
-    const g = "zoom-to:invalid-graphic: Could not zoom to the location of the graphic.", h = new Error(g);
-    throw console.error(g, {
-      graphic: n ?? o
-    }), h;
+    throw new Error("Could not zoom to the location of the graphic.");
   } finally {
-    s.active = !1, s.disabled = !1, w && e.location !== u && (e.location = u);
+    n.active = !1, n.disabled = !1, f && e.location !== u && (e.location = u);
   }
 }
-function T(e) {
-  return !!e && e.isAggregate && d(e)?.featureReduction?.type === "cluster";
+function v(e) {
+  return !!e && e.isAggregate && m(e)?.featureReduction?.type === "cluster";
 }
-async function A(e, t) {
-  const a = await e.whenLayerView(d(t)), o = a.createQuery(), r = t.getObjectId();
+async function F(e, t) {
+  const a = await e.whenLayerView(m(t)), o = a.createQuery(), r = t.getObjectId();
   return o.aggregateIds = r != null ? [r] : [], [a, o];
 }
-async function S(e) {
+async function T(e) {
   const { selectedFeature: t, view: a } = e;
   if (a?.type !== "2d")
     throw new Error("zoomToCluster:invalid-view: View must be 2d MapView.");
-  if (!t || !T(t))
+  if (!t || !v(t))
     throw new Error("zoomToCluster:invalid-selectedFeature: Selected feature must represent an aggregate/cluster graphic.");
-  const [o, r] = await A(a, t);
-  c.active = !0, c.disabled = !0;
+  const [o, r] = await F(a, t);
+  s.active = !0, s.disabled = !0;
   const { extent: i } = await o.queryExtent(r);
-  i && await e.zoomTo({ target: i }), c.active = !1, c.disabled = !1;
+  i && await e.zoomTo({ target: i }), s.active = !1, s.disabled = !1;
 }
-const B = async (e, t) => {
+const Z = async (e, t) => {
   if (!e)
     throw new Error("trigger-action:missing-arguments: Event has no action");
   const { disabled: a, id: o } = e;
@@ -99,30 +91,30 @@ const B = async (e, t) => {
     throw new Error("trigger-action:invalid-action: action.id is missing");
   if (a)
     throw new Error("trigger-action:invalid-action: Action is disabled");
-  if (o === s.id)
-    return await F(t).catch((r) => {
-      if (!y(r))
+  if (o === n.id)
+    return await C(t).catch((r) => {
+      if (!d(r))
         throw r;
     });
-  if (o === c.id)
-    return await S(t);
-  if (o === E.id) {
+  if (o === s.id)
+    return await T(t);
+  if (o === z.id) {
     t.browseClusterEnabled = !t.browseClusterEnabled, t.featureMenuOpen = t.browseClusterEnabled;
     return;
   }
-  if (o === v.id) {
+  if (o === h.id) {
     t.visible = !1;
     const { selectedFeature: r } = t;
     if (!r)
       throw new Error("trigger-action:missing-selected-feature: Cannot remove selected feature without a selected feature.");
-    const i = d(r);
+    const i = m(r);
     i ? i.remove(r) : t.view?.graphics.remove(r);
   }
 };
 export {
-  k as a,
-  F as b,
-  Z as g,
-  B as t,
-  s as z
+  Q as a,
+  C as b,
+  P as g,
+  Z as t,
+  n as z
 };