@arcgis/map-components 6.0.0-next.23 → 6.0.0-next.25

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 (61) hide show
  1. package/dist/cdn/{HQXC5XLE.js → 3HI5IZSQ.js} +1 -1
  2. package/dist/cdn/3KAC2MKA.js +2 -0
  3. package/dist/cdn/6GE2WBKV.js +2 -0
  4. package/dist/cdn/{LKKCTKMQ.js → 7U2V3LDM.js} +1 -1
  5. package/dist/cdn/CVLOQWUD.js +2 -0
  6. package/dist/cdn/{NORQIOSX.js → DGXTCH6B.js} +1 -1
  7. package/dist/cdn/E5X5BYWA.js +2 -0
  8. package/dist/cdn/ECF4B24M.js +2 -0
  9. package/dist/cdn/{V7DMA5ZO.js → GZ6UBR6R.js} +1 -1
  10. package/dist/cdn/HADZXZIE.js +2 -0
  11. package/dist/cdn/HTCPPGCR.js +2 -0
  12. package/dist/cdn/LHYI2QBZ.js +2 -0
  13. package/dist/cdn/{4WZ7Y57Q.js → QBRGIFBY.js} +1 -1
  14. package/dist/cdn/QXEOEFF3.js +2 -0
  15. package/dist/cdn/{ZF7NUFAT.js → RT53VCER.js} +1 -1
  16. package/dist/cdn/{AIF4MCBB.js → RXKIZFNQ.js} +1 -1
  17. package/dist/cdn/{TKIWKCDA.js → WU4NDBMC.js} +1 -1
  18. package/dist/cdn/{V3J5GQHD.js → XKGD4N75.js} +1 -1
  19. package/dist/cdn/YITBBUPR.js +2 -0
  20. package/dist/cdn/index.js +1 -1
  21. package/dist/chunks/utils.js +17 -17
  22. package/dist/chunks/utils5.js +2 -2
  23. package/dist/components/arcgis-basemap-gallery/customElement.js +17 -17
  24. package/dist/components/arcgis-basemap-gallery-item/customElement.js +1 -1
  25. package/dist/components/arcgis-coordinate-conversion/customElement.d.ts +5 -0
  26. package/dist/components/arcgis-coordinate-conversion-next/customElement.d.ts +6 -5
  27. package/dist/components/arcgis-scale-bar/customElement.js +11 -11
  28. package/dist/components/arcgis-swipe/customElement.js +43 -43
  29. package/dist/components/arcgis-time-bar/customElement.d.ts +3 -1
  30. package/dist/components/arcgis-time-slider/customElement.d.ts +1 -0
  31. package/dist/components/arcgis-time-slider/customElement.js +8 -7
  32. package/dist/components/arcgis-utility-network-trace-aggregated-geometry-result-item/customElement.d.ts +7 -0
  33. package/dist/components/arcgis-utility-network-trace-aggregated-geometry-result-item/customElement.js +8 -5
  34. package/dist/components/arcgis-utility-network-trace-analysis/customElement.d.ts +3 -0
  35. package/dist/components/arcgis-utility-network-trace-analysis/customElement.js +10 -10
  36. package/dist/components/arcgis-utility-network-trace-configuration-picker/customElement.d.ts +125 -12
  37. package/dist/components/arcgis-utility-network-trace-elements-result-item/customElement.d.ts +9 -2
  38. package/dist/components/arcgis-utility-network-trace-elements-result-item/customElement.js +60 -57
  39. package/dist/components/arcgis-utility-network-trace-functions-result-item/customElement.d.ts +7 -0
  40. package/dist/components/arcgis-utility-network-trace-functions-result-item/customElement.js +12 -9
  41. package/dist/components/arcgis-utility-network-trace-inputs/customElement.d.ts +217 -14
  42. package/dist/components/arcgis-utility-network-trace-inputs/customElement.js +119 -108
  43. package/dist/components/arcgis-utility-network-trace-locations/customElement.d.ts +155 -8
  44. package/dist/components/arcgis-utility-network-trace-results/customElement.d.ts +7 -3
  45. package/dist/components/arcgis-utility-network-trace-results/customElement.js +132 -125
  46. package/dist/docs/api.json +1 -1
  47. package/dist/docs/docs.json +1 -1
  48. package/dist/docs/vscode.html-custom-data.json +1 -1
  49. package/dist/docs/web-types.json +1 -1
  50. package/dist/loader.js +3 -3
  51. package/package.json +6 -6
  52. package/dist/cdn/2WJ53TNR.js +0 -2
  53. package/dist/cdn/5A7LDBDR.js +0 -2
  54. package/dist/cdn/H4BTVLCG.js +0 -2
  55. package/dist/cdn/MNL7ONFB.js +0 -2
  56. package/dist/cdn/NQ3COROI.js +0 -2
  57. package/dist/cdn/QKNHYZYS.js +0 -2
  58. package/dist/cdn/SIT5NBLS.js +0 -2
  59. package/dist/cdn/SLWZHNVT.js +0 -2
  60. package/dist/cdn/SU2SAOBL.js +0 -2
  61. package/dist/cdn/YYCTSS52.js +0 -2
@@ -1,28 +1,27 @@
1
1
  /* COPYRIGHT Esri - https://js.arcgis.com/6.0/LICENSE.txt */
2
- import { c as F } from "../../chunks/runtime.js";
2
+ import { c as b } from "../../chunks/runtime.js";
3
3
  import { ref as E } from "lit/directives/ref.js";
4
4
  import { getOrCreateMapValue as v } from "@arcgis/core/applications/Components/featureUtils.js";
5
5
  import { LitElement as L, createEvent as y } from "@arcgis/lumina";
6
- import { usePropertyChange as T, bypassReadOnly as o } from "@arcgis/lumina/controllers";
6
+ import { usePropertyChange as C, bypassReadOnly as o } from "@arcgis/lumina/controllers";
7
7
  import { log as d, composeMissingPropertyMessage as m } from "@arcgis/toolkit/log";
8
- import { css as k, html as f } from "lit";
9
- import { u as I } from "../../chunks/useT9n.js";
10
- import { i as g, l as p, t as c, c as A } from "../../chunks/async-utils.js";
11
- import { c as S, q as P, d as w, e as $ } from "../../chunks/layer-utils.js";
8
+ import { css as T, html as f } from "lit";
9
+ import { u as k } from "../../chunks/useT9n.js";
10
+ import { i as g, l as p, t as u, c as I } from "../../chunks/async-utils.js";
11
+ import { c as A, q as P, d as w, e as S } from "../../chunks/layer-utils.js";
12
12
  import { i as R } from "../../chunks/utils5.js";
13
- const C = k`arcgis-features-next{height:100%}.elements-list-item{border:solid 1px var(--calcite-color-border-3);border-radius:var(--calcite-corner-radius-sm)}.features-hidden{color:var(--calcite-color-text-3);font-size:var(--calcite-font-size);overflow-wrap:anywhere}`;
13
+ const $ = T`arcgis-features-next{height:100%}.elements-list-item{border:solid 1px var(--calcite-color-border-3);border-radius:var(--calcite-corner-radius-sm)}.features-hidden{color:var(--calcite-color-text-3);font-size:var(--calcite-font-size);overflow-wrap:anywhere}`;
14
14
  class D extends L {
15
15
  constructor() {
16
- super(...arguments), this._messages = I({ blocking: !0 }), this.#n = !0, this.#i = [], this.#t = [], this.#r = /* @__PURE__ */ new Map(), this.#a = /* @__PURE__ */ new Map(), this.#h = !1, this.#l = /* @__PURE__ */ new Map(), this.#o = /* @__PURE__ */ new Map(), this.#e = [], this._isFeaturesSelected = !1, this.autoDestroyDisabled = !1, this.disableHighlight = !1, this.emitsArcgisResultReady = !0, this.features = [], this.hideActionBar = !1, this.hideFeatureResults = !1, this.hidePlaceholder = !1, this.includeDefaultActionsDisabled = !1, this.layers = [], this.state = "ready", this.arcgisPropertyChange = T()("features", "isFeaturesListShown", "selectedResultFeature", "state"), this.arcgisResultReady = y(), this.arcgisTriggerAction = y();
16
+ super(...arguments), this._messages = k({ blocking: !0 }), this.#o = !0, this.#t = [], this.#i = /* @__PURE__ */ new Map(), this.#r = /* @__PURE__ */ new Map(), this.#n = !1, this.#h = !1, this.#a = /* @__PURE__ */ new Map(), this.#l = /* @__PURE__ */ new Map(), this.#e = [], this._isFeaturesSelected = !1, this.autoDestroyDisabled = !1, this.disableHighlight = !1, this.emitsArcgisResultReady = !0, this.features = [], this.hideActionBar = !1, this.hideFeatureResults = !1, this.hidePlaceholder = !1, this.includeDefaultActionsDisabled = !1, this.layers = [], this.state = "ready", this.arcgisPropertyChange = C()("features", "hasContent", "isFeaturesListShown", "selectedResultFeature", "state"), this.arcgisResultReady = y(), this.arcgisTriggerAction = y();
17
17
  }
18
18
  static {
19
- this.properties = { _featuresComponentElement: 16, _isFeaturesSelected: 16, actions: 0, autoDestroyDisabled: 5, disableHighlight: 5, emitsArcgisResultReady: 32, features: 32, heading: 1, hideActionBar: 5, hideFeatureResults: 5, hidePlaceholder: 5, includeDefaultActionsDisabled: 5, isFeaturesListShown: 32, layers: 0, messageOverrides: 0, numResults: 32, referenceElement: 1, selectedResultFeature: 32, state: 32, traceResult: 32, utilityNetwork: 32, view: 32 };
19
+ this.properties = { _featuresComponentElement: 16, _isFeaturesSelected: 16, actions: 0, autoDestroyDisabled: 5, disableHighlight: 5, emitsArcgisResultReady: 32, features: 32, hasContent: 32, heading: 1, hideActionBar: 5, hideFeatureResults: 5, hidePlaceholder: 5, includeDefaultActionsDisabled: 5, isFeaturesListShown: 32, layers: 0, messageOverrides: 0, numResults: 32, referenceElement: 1, selectedResultFeature: 32, state: 32, traceResult: 32, utilityNetwork: 32, view: 32 };
20
20
  }
21
21
  static {
22
- this.styles = C;
22
+ this.styles = $;
23
23
  }
24
- #n;
25
- #i;
24
+ #o;
26
25
  get #f() {
27
26
  if (!this.traceResult)
28
27
  return !1;
@@ -30,13 +29,14 @@ class D extends L {
30
29
  return e.length > 0 && !t?.length && !s;
31
30
  }
32
31
  #t;
32
+ #i;
33
33
  #r;
34
- #a;
35
34
  #s;
35
+ #n;
36
36
  #h;
37
+ #a;
37
38
  #l;
38
- #o;
39
- get #c() {
39
+ get #u() {
40
40
  const { parentElement: e } = this.el;
41
41
  if (e && R(e))
42
42
  return e;
@@ -45,24 +45,27 @@ class D extends L {
45
45
  return t.host;
46
46
  }
47
47
  #e;
48
+ get hasContent() {
49
+ return this.numResults > 0 && !this.manager.destroyed && !(this.hideFeatureResults && this.hidePlaceholder);
50
+ }
48
51
  get isFeaturesListShown() {
49
- return this._isFeaturesSelected && !this.hideFeatureResults;
52
+ return this._isFeaturesSelected && !this.hideFeatureResults && this.numResults > 0;
50
53
  }
51
54
  get numResults() {
52
- return this.features.length + this.#i.length;
55
+ return this.features.length;
53
56
  }
54
57
  get selectedResultFeature() {
55
58
  return this._featuresComponentElement?.selectedDrillInFeature ?? this._featuresComponentElement?.selectedFeature ?? void 0;
56
59
  }
57
60
  clearResult() {
58
- this._isFeaturesSelected = !1, this.#s?.abort(), this.#m(), o(() => this.features = []), this.#e = [], this.#i = [], this.#r.clear(), this.#a.clear(), this.#o.clear(), this.#l.clear(), o(() => this.state = "ready");
61
+ this._isFeaturesSelected = !1, this.#s?.abort(), this.#m(), o(() => this.features = []), this.#e = [], this.#i.clear(), this.#r.clear(), this.#l.clear(), this.#a.clear(), o(() => this.state = "ready");
59
62
  }
60
63
  async destroy() {
61
64
  this.clearResult(), await this.manager.destroy(), await this._featuresComponentElement?.destroy();
62
65
  }
63
66
  load() {
64
67
  this.manager.onLifecycle(() => {
65
- const e = this.#c;
68
+ const e = this.#u;
66
69
  if (!e) {
67
70
  d("warn", this, "This component must be used as a child of `arcgis-utility-network-trace-results`.");
68
71
  return;
@@ -76,15 +79,17 @@ class D extends L {
76
79
  }), this.traceResult && this.#d();
77
80
  }
78
81
  willUpdate(e) {
79
- e.has("traceResult") && this.#d(), e.has("disableHighlight") && this.#u();
80
- const t = this.isFeaturesListShown;
81
- t !== this.#h && this.arcgisPropertyChange.emit({ name: "isFeaturesListShown" }), this.#h = t;
82
+ e.has("traceResult") && this.#d(), e.has("disableHighlight") && this.#c();
83
+ const t = this.hasContent;
84
+ t !== this.#n && this.el.isConnected && this.arcgisPropertyChange.emit({ name: "hasContent" }), this.#n = t;
85
+ const s = this.isFeaturesListShown;
86
+ s !== this.#h && this.arcgisPropertyChange.emit({ name: "isFeaturesListShown" }), this.#h = s;
82
87
  }
83
88
  loaded() {
84
89
  this.traceResult && (this.traceResult.elements || d("error", this, m("traceResult.elements")), this.utilityNetwork || d("error", this, m("utilityNetwork")));
85
90
  }
86
91
  #y(e) {
87
- if (e.target !== this.#c)
92
+ if (e.target !== this.#u)
88
93
  return;
89
94
  const { target: t } = e;
90
95
  switch (e.detail.name) {
@@ -102,7 +107,7 @@ class D extends L {
102
107
  #m() {
103
108
  this.#t.forEach(({ handle: e }) => e?.remove()), this.#t = [];
104
109
  }
105
- #u() {
110
+ #c() {
106
111
  this.#t.forEach((e) => {
107
112
  this.disableHighlight ? (e.handle?.remove(), e.handle = void 0) : e.handle = e.layerView.highlight(e.objectIds);
108
113
  });
@@ -116,23 +121,23 @@ class D extends L {
116
121
  #w(e) {
117
122
  if (e == null || !this.#e.length)
118
123
  return;
119
- const t = this.#a.get(e);
124
+ const t = this.#r.get(e);
120
125
  if (t)
121
126
  return t;
122
127
  const s = this.#e.find((r) => "layerId" in r && r.layerId === e);
123
- return s && this.#a.set(e, s), s;
128
+ return s && this.#r.set(e, s), s;
124
129
  }
125
130
  #R() {
126
131
  const { traceResult: e, utilityNetwork: t, view: s } = this;
127
132
  if (!t || !e?.elements?.length || !s)
128
133
  return;
129
- const r = (i) => ($(i.layer) || w(i.layer)) && t.isUtilityLayer(i.layer), n = t.getObjectIdsFromElements(e.elements), h = s.allLayerViews.filter(r);
134
+ const r = (i) => (S(i.layer) || w(i.layer)) && t.isUtilityLayer(i.layer), n = t.getObjectIdsFromElements(e.elements), h = s.allLayerViews.filter(r);
130
135
  n.forEach(({ layerUrl: i, objectIds: l }) => {
131
- const a = Number(i.split("/").pop()), u = h.find(({ layer: b }) => b.layerId === a);
132
- u && this.#t.push({ layerView: u, objectIds: l });
133
- }), this.#u();
136
+ const a = Number(i.split("/").pop()), c = h.find(({ layer: F }) => F.layerId === a);
137
+ c && this.#t.push({ layerView: c, objectIds: l });
138
+ }), this.#c();
134
139
  }
135
- async #b(e) {
140
+ async #F(e) {
136
141
  const { layers: t, utilityNetwork: s, view: r } = this;
137
142
  if (!r || !s)
138
143
  return;
@@ -143,11 +148,11 @@ class D extends L {
143
148
  throw i;
144
149
  p(i, this, "Error while loading the selected utility network");
145
150
  }
146
- c(e), this.#e = t.length ? t.filter((i) => s.isUtilityLayer(i)) : S(r, s);
151
+ u(e), this.#e = t.length ? t.filter((i) => s.isUtilityLayer(i)) : A(r, s);
147
152
  const h = this.#e.filter((i) => !i.loaded).map((i) => i.load({ signal: e }));
148
153
  if (h.length > 0) {
149
154
  const i = await Promise.allSettled(h);
150
- c(e), i.forEach((l) => {
155
+ u(e), i.forEach((l) => {
151
156
  l.status === "rejected" && d("error", this, `Failed to load layer. Reason: ${l.reason}`);
152
157
  });
153
158
  }
@@ -156,13 +161,13 @@ class D extends L {
156
161
  this.clearResult(), this._isFeaturesSelected = this.#f;
157
162
  const e = () => {
158
163
  o(() => this.state = "ready"), this.arcgisResultReady.emit();
159
- }, t = A(async (s) => {
164
+ }, t = I(async (s) => {
160
165
  const r = this.traceResult?.elements;
161
166
  if (!r?.length) {
162
167
  e();
163
168
  return;
164
169
  }
165
- o(() => this.state = "loading"), this.#v(r), await this.#b(s), await this.#E(s), c(s), this.#R(), e();
170
+ o(() => this.state = "loading"), this.#v(r), await this.#F(s), await this.#E(s), u(s), this.#R(), e();
166
171
  });
167
172
  this.#s = t;
168
173
  try {
@@ -173,59 +178,57 @@ class D extends L {
173
178
  this.#s === t && (this.#s = void 0, o(() => this.state = "ready"));
174
179
  }
175
180
  }
176
- async #F([e, t], s) {
177
- c(s);
178
- const r = this.utilityNetwork?.getLayerIdBySourceId(e), n = this.#w(r), h = this.#p(t);
179
- if (r == null || !n) {
180
- this.#i.push(...h);
181
+ async #b([e, t], s) {
182
+ u(s);
183
+ const r = this.utilityNetwork?.getLayerIdBySourceId(e), n = this.#w(r);
184
+ if (r == null || !n)
181
185
  return;
182
- }
183
- const i = n.createQuery();
186
+ const h = this.#p(t), i = n.createQuery();
184
187
  i.gdbVersion = this.utilityNetwork?.gdbVersion, i.objectIds = h.map((a) => a.objectId), i.outFields = ["*"];
185
188
  const { features: l } = await P(n, i, { signal: s });
186
- c(s), l.forEach((a) => {
187
- const u = a.layer;
188
- a.getEffectivePopupTemplate(this.#n) || (a.popupTemplate = u.createPopupTemplate());
189
+ u(s), l.forEach((a) => {
190
+ const c = a.layer;
191
+ a.getEffectivePopupTemplate(this.#o) || (a.popupTemplate = c.createPopupTemplate());
189
192
  }), w(n) ? l.forEach((a) => {
190
- v(this.#o, a.layer.subtypeCode, () => []).push(a);
191
- }) : this.#r.set(r, l);
193
+ v(this.#l, a.layer.subtypeCode, () => []).push(a);
194
+ }) : this.#i.set(r, l);
192
195
  }
193
196
  async #E(e) {
194
- const t = Array.from(this.#l.entries());
197
+ const t = Array.from(this.#a.entries());
195
198
  if (!t.length)
196
199
  return;
197
- const s = t.map((i) => this.#F(i, e)), r = await Promise.allSettled(s);
198
- c(e), r.forEach((i, l) => {
200
+ const s = t.map((i) => this.#b(i, e)), r = await Promise.allSettled(s);
201
+ u(e), r.forEach((i, l) => {
199
202
  if (i.status === "rejected") {
200
203
  const [a] = t[l];
201
204
  d("error", this, `Failed to query features for source ${a}. Reason: ${i.reason}`);
202
205
  }
203
206
  });
204
- const n = Array.from(this.#r.values()), h = Array.from(this.#o.values());
207
+ const n = Array.from(this.#i.values()), h = Array.from(this.#l.values());
205
208
  o(() => this.features = n.concat(h).flat());
206
209
  }
207
210
  #v(e) {
208
- this.#l = Map.groupBy(e, ({ networkSourceId: t }) => t);
211
+ this.#a = Map.groupBy(e, ({ networkSourceId: t }) => t);
209
212
  }
210
213
  #L(e) {
211
214
  const { detail: t } = e;
212
215
  (t.name === "selectedDrillInFeature" || t.name === "selectedFeature") && (e.stopPropagation(), this.arcgisPropertyChange.emit({ name: "selectedResultFeature" }));
213
216
  }
214
- #T(e) {
217
+ #C(e) {
215
218
  e.stopPropagation(), this.arcgisTriggerAction.emit(e.detail);
216
219
  }
217
- #k() {
220
+ #T() {
218
221
  return f`<div class="features-hidden">${this._messages.resultFeaturesAreHidden}</div>`;
219
222
  }
220
- #I() {
223
+ #k() {
221
224
  const { heading: e, _messages: t } = this;
222
225
  return f`<calcite-list .label=${t.headings.features}><calcite-list-item class="elements-list-item" .label=${e || t.headings.features} @calciteListItemSelect=${() => this._isFeaturesSelected = !0}><calcite-chip .label=${t.labels.numFeatures} scale=s slot=content-end>${this.numResults}</calcite-chip><calcite-icon flip-rtl icon=chevron-right slot=content-end></calcite-icon></calcite-list-item></calcite-list>`;
223
226
  }
224
227
  render() {
225
- return !this.traceResult?.elements.length || this.manager.destroyed ? null : this.hideFeatureResults ? this.hidePlaceholder ? null : this.#k() : this.isFeaturesListShown ? f`<arcgis-features-next .actions=${this.actions} .autoDestroyDisabled=${this.autoDestroyDisabled} .defaultPopupTemplateEnabled=${this.#n} .features=${this.features} .hideActionBar=${this.hideActionBar} hide-select-feature .includeDefaultActionsDisabled=${this.includeDefaultActionsDisabled} initial-display-mode=list .messageOverrides=${this.messageOverrides} open .referenceElement=${this.referenceElement} .view=${this.view} @arcgisClose=${() => this._isFeaturesSelected = !1} @arcgisPropertyChange=${this.#L} @arcgisTriggerAction=${this.#T} ${E(this.#g)}></arcgis-features-next>` : this.#I();
228
+ return this.hasContent ? this.hideFeatureResults ? this.#T() : this.isFeaturesListShown ? f`<arcgis-features-next .actions=${this.actions} .autoDestroyDisabled=${this.autoDestroyDisabled} .defaultPopupTemplateEnabled=${this.#o} .features=${this.features} .hideActionBar=${this.hideActionBar} hide-select-feature .includeDefaultActionsDisabled=${this.includeDefaultActionsDisabled} initial-display-mode=list .messageOverrides=${this.messageOverrides} open .referenceElement=${this.referenceElement} .view=${this.view} @arcgisClose=${() => this._isFeaturesSelected = !1} @arcgisPropertyChange=${this.#L} @arcgisTriggerAction=${this.#C} ${E(this.#g)}></arcgis-features-next>` : this.#k() : null;
226
229
  }
227
230
  }
228
- F("arcgis-utility-network-trace-elements-result-item", D);
231
+ b("arcgis-utility-network-trace-elements-result-item", D);
229
232
  export {
230
233
  D as ArcgisUtilityNetworkTraceElementsResultItem
231
234
  };
@@ -85,6 +85,13 @@ export abstract class ArcgisUtilityNetworkTraceFunctionsResultItem extends LitEl
85
85
  * @default false
86
86
  */
87
87
  get emitsArcgisResultReady(): true;
88
+ /**
89
+ * Whether the component has content to render.
90
+ *
91
+ * @default false
92
+ * @internal
93
+ */
94
+ get hasContent(): boolean;
88
95
  /**
89
96
  * The heading displayed above the function results table.
90
97
  * If not specified or empty, the component uses its localized default heading.
@@ -1,7 +1,7 @@
1
1
  /* COPYRIGHT Esri - https://js.arcgis.com/6.0/LICENSE.txt */
2
2
  import { c as g } from "../../chunks/runtime.js";
3
3
  import { LitElement as d, createEvent as R } from "@arcgis/lumina";
4
- import { usePropertyChange as f, bypassReadOnly as a } from "@arcgis/lumina/controllers";
4
+ import { usePropertyChange as f, bypassReadOnly as r } from "@arcgis/lumina/controllers";
5
5
  import { log as i, composeEmptyPropertyMessage as p } from "@arcgis/toolkit/log";
6
6
  import { css as b, html as l } from "lit";
7
7
  import { u as y } from "../../chunks/useT9n.js";
@@ -12,7 +12,7 @@ class v extends d {
12
12
  super(...arguments), this._messages = y({ blocking: !0 }), this.autoDestroyDisabled = !1, this.emitsArcgisResultReady = !0, this.state = "ready", this.arcgisPropertyChange = f()("state"), this.arcgisResultReady = R();
13
13
  }
14
14
  static {
15
- this.properties = { autoDestroyDisabled: 5, emitsArcgisResultReady: 32, heading: 1, messageOverrides: 0, state: 32, traceResult: 32 };
15
+ this.properties = { autoDestroyDisabled: 5, emitsArcgisResultReady: 32, hasContent: 32, heading: 1, messageOverrides: 0, state: 32, traceResult: 32 };
16
16
  }
17
17
  static {
18
18
  this.styles = w;
@@ -25,6 +25,9 @@ class v extends d {
25
25
  if (e instanceof ShadowRoot && c(e.host))
26
26
  return e.host;
27
27
  }
28
+ get hasContent() {
29
+ return !!this.traceResult?.globalFunctionResults.length;
30
+ }
28
31
  clearResult() {
29
32
  }
30
33
  async destroy() {
@@ -37,8 +40,8 @@ class v extends d {
37
40
  i("warn", this, "This component must be used as a child of `arcgis-utility-network-trace-results`.");
38
41
  return;
39
42
  }
40
- const e = (r) => this.#s(r);
41
- return t.addEventListener("arcgisPropertyChange", e), a(() => {
43
+ const e = (a) => this.#s(a);
44
+ return t.addEventListener("arcgisPropertyChange", e), r(() => {
42
45
  this.traceResult = t.traceResult;
43
46
  }), () => {
44
47
  t.removeEventListener("arcgisPropertyChange", e);
@@ -55,16 +58,16 @@ class v extends d {
55
58
  if (t.target !== this.#t)
56
59
  return;
57
60
  const { target: e } = t;
58
- t.detail.name === "traceResult" && a(() => this.traceResult = e.traceResult);
61
+ t.detail.name === "traceResult" && r(() => this.traceResult = e.traceResult);
59
62
  }
60
63
  #e() {
61
- a(() => this.state = "ready"), this.arcgisResultReady.emit();
64
+ r(() => this.state = "ready"), this.arcgisResultReady.emit();
62
65
  }
63
66
  render() {
64
- if (!this.traceResult?.globalFunctionResults.length)
67
+ if (!this.hasContent)
65
68
  return null;
66
- const { heading: t, _messages: e } = this, { globalFunctionResults: r } = this.traceResult;
67
- return l`<div class="functions-heading">${t || e.functions}</div><calcite-table .caption=${e.labels.functionResults}>${r.filter((s) => s.networkAttributeName != null && s.result != null && s.functionType != null).map((s) => {
69
+ const { heading: t, _messages: e } = this, { globalFunctionResults: a } = this.traceResult;
70
+ return l`<div class="functions-heading">${t || e.functions}</div><calcite-table .caption=${e.labels.functionResults}>${a.filter((s) => s.networkAttributeName != null && s.result != null && s.functionType != null).map((s) => {
68
71
  const { functionName: o, networkAttributeName: n, functionType: u, result: h } = s, m = o || `${n} ${u}`;
69
72
  return l`<calcite-table-row><calcite-table-cell>${m}</calcite-table-cell><calcite-table-cell>${h}</calcite-table-cell></calcite-table-row>`;
70
73
  })}</calcite-table>`;
@@ -16,10 +16,112 @@ import type { ArcgisUtilityNetworkTraceLocations, SelectStartPayload, TraceLocat
16
16
  import type { T9nMeta } from "@arcgis/lumina/controllers";
17
17
 
18
18
  /**
19
- * This is a sub-component used by the **ArcgisUtilityNetworkTraceAnalysis** component.
20
- * It allows users to select utility networks, trace configurations, and input features for tracing.
19
+ * The Utility Network Trace Inputs component collects the inputs needed to run a utility network trace.
20
+ * These include a utility network and one of its
21
+ * [named trace configurations](https://doc.esri.com/en/arcgis-pro/latest/help/data/utility-network/about-trace-configurations.html),
22
+ * [starting points](https://doc.esri.com/en/arcgis-pro/latest/help/data/utility-network/starting-points.html),
23
+ * [stopping points](https://doc.esri.com/en/arcgis-pro/latest/help/data/utility-network/stopping-points.html)
24
+ * (available for [path](https://doc.esri.com/en/arcgis-pro/latest/help/data/utility-network/utility-network-trace-types.html#3B5)
25
+ * trace configurations), and
26
+ * [barriers](https://doc.esri.com/en/arcgis-pro/latest/help/data/utility-network/barriers.html).
21
27
  *
28
+ * For a [subnetwork trace](https://doc.esri.com/en/arcgis-pro/latest/help/data/utility-network/utility-network-trace-types.html#7A1)
29
+ * configured with a subnetwork name, users select a subnetwork instead of adding starting points.
30
+ *
31
+ * ### Required setup
32
+ *
33
+ * - A [MapView](https://developers.arcgis.com/javascript/latest/references/core/views/MapView/) with a
34
+ * [WebMap](https://developers.arcgis.com/javascript/latest/references/core/WebMap/) that contains a utility network and the utility network's layers.
35
+ * Set [view](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-inputs/#view) to that MapView.
36
+ * - Users must choose a utility network (if the web map contains more than one) and a named trace
37
+ * configuration. The utility network can also be supplied through
38
+ * [selectedUtilityNetwork](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-inputs/#selectedUtilityNetwork).
39
+ *
40
+ * ### Optional inputs
41
+ *
42
+ * When users click the map to select a trace location, the component presents candidate features
43
+ * at that point using the [Features component](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features-next/).
44
+ * Users can inspect the features and add one as a trace location.
45
+ * Customize the actions presented with those features using
46
+ * [actions](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-inputs/#actions),
47
+ * [hideActionBar](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-inputs/#hideActionBar), and
48
+ * [includeDefaultActionsDisabled](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-inputs/#includeDefaultActionsDisabled).
49
+ * Use [beforeMapInteraction](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-inputs/#beforeMapInteraction) to run an asynchronous
50
+ * callback before trace location selection begins, such as closing a popup or canceling another tool.
51
+ *
52
+ * This component does not execute traces or display trace results. Use
53
+ * [selectedUtilityNetwork](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-inputs/#selectedUtilityNetwork),
54
+ * [selectedNamedTraceConfiguration](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-inputs/#selectedNamedTraceConfiguration),
55
+ * [traceConfiguration](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-inputs/#traceConfiguration), and
56
+ * [traceLocations](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-inputs/#traceLocations) to execute a trace with
57
+ * [UtilityNetwork.trace()](https://developers.arcgis.com/javascript/latest/references/core/networks/UtilityNetwork/#trace).
58
+ *
59
+ * @example
60
+ * Display a web map and trace inputs side by side using Calcite Shell and Shell Panel components.
61
+ * Import the map, trace inputs, and Calcite components before running this example.
62
+ * The web map must contain a utility network and its layers, and may require authentication.
63
+ * ```html
64
+ * <calcite-shell>
65
+ * <calcite-shell-panel slot="panel-start">
66
+ * <calcite-panel heading="Trace inputs">
67
+ * <arcgis-utility-network-trace-inputs id="trace-inputs">
68
+ * </arcgis-utility-network-trace-inputs>
69
+ * </calcite-panel>
70
+ * </calcite-shell-panel>
71
+ * <arcgis-map id="trace-map" item-id="471eb0bf37074b1fbb972b1da70fb310"></arcgis-map>
72
+ * </calcite-shell>
73
+ * ```
74
+ *
75
+ * Assign the map's view after it is ready. Close its popup before selecting trace locations,
76
+ * and hide the feature action bar during selection.
77
+ * Call `runTrace()` from the app's trace button handler.
78
+ * The handler reads the component's current values.
79
+ * ```js
80
+ * const mapElement = document.getElementById("trace-map");
81
+ * const inputs = document.getElementById("trace-inputs");
82
+ * await mapElement.viewOnReady();
83
+ *
84
+ * inputs.view = mapElement.view;
85
+ * inputs.hideActionBar = true;
86
+ * inputs.beforeMapInteraction = async () => {
87
+ * mapElement.view.closePopup();
88
+ * };
89
+ *
90
+ * async function runTrace() {
91
+ * try {
92
+ * const {
93
+ * selectedUtilityNetwork: utilityNetwork,
94
+ * selectedNamedTraceConfiguration: namedTraceConfiguration,
95
+ * traceConfiguration,
96
+ * traceLocations,
97
+ * } = inputs;
98
+ *
99
+ * if (!utilityNetwork || !namedTraceConfiguration?.traceType || !traceConfiguration) {
100
+ * throw new Error("Select a utility network and trace configuration first.");
101
+ * }
102
+ *
103
+ * const result = await utilityNetwork.trace({
104
+ * traceType: namedTraceConfiguration.traceType,
105
+ * resultTypes: namedTraceConfiguration.resultTypes,
106
+ * traceConfiguration,
107
+ * traceLocations,
108
+ * });
109
+ *
110
+ * console.log(result);
111
+ * } catch (error) {
112
+ * console.error("Trace failed:", error);
113
+ * }
114
+ * }
115
+ * ```
22
116
  * @since 5.2
117
+ * @see [arcgis-utility-network-picker](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-picker/)
118
+ * @see [arcgis-utility-network-trace-configuration-picker](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-configuration-picker/)
119
+ * @see [arcgis-utility-network-trace-locations](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-locations/)
120
+ * @see [Trace a utility network](https://developers.arcgis.com/javascript/latest/utility-network/tracing/)
121
+ * @see [Named trace configurations](https://doc.esri.com/en/arcgis-pro/latest/help/data/utility-network/about-trace-configurations.html)
122
+ * @see [Starting points](https://doc.esri.com/en/arcgis-pro/latest/help/data/utility-network/starting-points.html)
123
+ * @see [Stopping points](https://doc.esri.com/en/arcgis-pro/latest/help/data/utility-network/stopping-points.html)
124
+ * @see [Barriers](https://doc.esri.com/en/arcgis-pro/latest/help/data/utility-network/barriers.html)
23
125
  */
24
126
  export abstract class ArcgisUtilityNetworkTraceInputs extends LitElement {
25
127
  /** @internal */
@@ -105,24 +207,49 @@ export abstract class ArcgisUtilityNetworkTraceInputs extends LitElement {
105
207
  *
106
208
  */
107
209
  accessor autoDestroyDisabled: boolean;
108
- /** A function to run before trace location selection starts. */
210
+ /**
211
+ * An asynchronous callback invoked before the user selects a trace location.
212
+ * Selection begins after this callback completes. Use this callback to finish or cancel
213
+ * active map tools or interactions that might interfere with selecting a trace location,
214
+ * such as sketching, measurement, or map selection tools, or to close a popup.
215
+ *
216
+ * To prevent selection from starting, call `preventDefault()` on
217
+ * [@arcgisTraceLocationSelectStart](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-inputs/#event-arcgisTraceLocationSelectStart).
218
+ *
219
+ * @example
220
+ * Prevent selecting trace locations while another tool is active.
221
+ * ```js
222
+ * import SketchViewModel from "@arcgis/core/widgets/Sketch/SketchViewModel.js";
223
+ *
224
+ * const inputs = document.querySelector("arcgis-utility-network-trace-inputs");
225
+ * const sketch = new SketchViewModel({ view: inputs.view });
226
+ * inputs.addEventListener("arcgisTraceLocationSelectStart", (event) => {
227
+ * if (sketch.state === "active") {
228
+ * event.preventDefault();
229
+ * }
230
+ * });
231
+ * ```
232
+ */
109
233
  accessor beforeMapInteraction: (() => Promise<void>) | undefined;
110
234
  /**
111
- * Indicates whether to hide the action bar that holds the feature's
112
- * [arcgis-features-next.actions](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features-next/#actions) when selecting trace locations.
235
+ * Whether the action bar that holds the feature's
236
+ * [arcgis-features-next.actions](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features-next/#actions) is hidden when selecting trace locations.
113
237
  *
114
238
  * @default false
239
+ * @see [arcgis-features-next.actions](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features-next/#actions)
240
+ * @see [arcgis-features-next.hideActionBar](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features-next/#hideActionBar)
115
241
  */
116
242
  accessor hideActionBar: boolean;
117
243
  /**
118
- * Indicates whether default actions are disabled (hidden) when selecting trace locations.
244
+ * Whether default actions are disabled (hidden) when selecting trace locations.
119
245
  * This property must be set to `true` to disable default actions.
120
246
  *
121
247
  * @default false
248
+ * @see [arcgis-features-next.includeDefaultActionsDisabled](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features-next/#includeDefaultActionsDisabled)
122
249
  */
123
250
  accessor includeDefaultActionsDisabled: boolean;
124
251
  /**
125
- * Whether a the user has selected a named trace configuration that executes a
252
+ * Whether the user has selected a named trace configuration that executes a
126
253
  * subnetwork trace with a specified subnetwork name.
127
254
  *
128
255
  * @default false
@@ -161,7 +288,15 @@ export abstract class ArcgisUtilityNetworkTraceInputs extends LitElement {
161
288
  } | undefined;
162
289
  warnings?: { exceededDisplayLimit?: string | undefined; } | undefined;
163
290
  };
164
- /** @default "default" */
291
+ /**
292
+ * The current display mode. The component updates this property during trace location selection.
293
+ *
294
+ * - `default`: Displays the network, configuration, and trace location inputs.
295
+ * - `add-spatial-instructions`: Displays instructions for selecting a location on the map.
296
+ * - `add-spatial-feature`: Displays candidate features so the user can choose a trace location.
297
+ *
298
+ * @default "default"
299
+ */
165
300
  accessor mode: UtilityNetworkTraceAnalysisDisplayMode;
166
301
  /**
167
302
  * By assigning the `id` attribute of the Map or Scene component to this property, you can position a child component anywhere in the DOM while still maintaining a connection to the Map or Scene.
@@ -169,12 +304,55 @@ export abstract class ArcgisUtilityNetworkTraceInputs extends LitElement {
169
304
  * @see [Associate components with a Map or Scene component](https://developers.arcgis.com/javascript/latest/programming-patterns/#associate-components-with-a-map-or-scene-component)
170
305
  */
171
306
  accessor referenceElement: ArcgisReferenceElement | string | undefined;
307
+ /**
308
+ * The [named trace configuration](https://doc.esri.com/en/arcgis-pro/latest/help/data/utility-network/about-trace-configurations.html)
309
+ * to use. It determines the trace type and its settings.
310
+ * Users choose one in the component's trace configuration picker.
311
+ */
172
312
  accessor selectedNamedTraceConfiguration: NamedTraceConfiguration | undefined;
313
+ /**
314
+ * The utility network to use for the trace. The component loads it if needed and shows the
315
+ * [named trace configurations](https://doc.esri.com/en/arcgis-pro/latest/help/data/utility-network/about-trace-configurations.html)
316
+ * from that utility network's
317
+ * [sharedNamedTraceConfigurations](https://developers.arcgis.com/javascript/latest/references/core/networks/UtilityNetwork/#sharedNamedTraceConfigurations).
318
+ * Changing the utility network clears any trace locations
319
+ * previously added, such as starting points and barriers, and updates the available named trace configurations.
320
+ */
173
321
  accessor selectedUtilityNetwork: UtilityNetwork | undefined;
174
322
  /**
175
- * A clone of the utility network trace configuration associated with
176
- * the selected named trace configuration. Updates on this object are
177
- * used to reflect the user's changes to the named trace configuration.
323
+ * A clone of the
324
+ * [UNTraceConfiguration](https://developers.arcgis.com/javascript/latest/references/core/networks/support/UNTraceConfiguration/)
325
+ * associated with [selectedNamedTraceConfiguration](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-inputs/#selectedNamedTraceConfiguration).
326
+ * The component updates this clone to reflect changes such as the selected subnetwork name,
327
+ * without modifying the original named trace configuration.
328
+ *
329
+ * This property is read-only, but the returned configuration object is mutable.
330
+ * Pass this object to [UtilityNetwork.trace()](https://developers.arcgis.com/javascript/latest/references/core/networks/UtilityNetwork/#trace)
331
+ * to use the current input settings.
332
+ * It is `undefined` when no configuration is available.
333
+ *
334
+ * @example
335
+ * After selecting a network and configuration and completing the required trace inputs:
336
+ * ```js
337
+ * const inputs = document.querySelector("arcgis-utility-network-trace-inputs");
338
+ *
339
+ * try {
340
+ * const { selectedUtilityNetwork, selectedNamedTraceConfiguration, traceConfiguration } = inputs;
341
+ * if (!selectedUtilityNetwork || !selectedNamedTraceConfiguration?.traceType || !traceConfiguration) {
342
+ * throw new Error("Select a utility network and trace configuration first.");
343
+ * }
344
+ *
345
+ * const result = await selectedUtilityNetwork.trace({
346
+ * traceType: selectedNamedTraceConfiguration.traceType,
347
+ * resultTypes: selectedNamedTraceConfiguration.resultTypes,
348
+ * traceConfiguration,
349
+ * traceLocations: inputs.traceLocations,
350
+ * });
351
+ * console.log(result);
352
+ * } catch (error) {
353
+ * console.error("Trace failed:", error);
354
+ * }
355
+ * ```
178
356
  */
179
357
  get traceConfiguration(): UNTraceConfiguration | undefined;
180
358
  /**
@@ -184,6 +362,25 @@ export abstract class ArcgisUtilityNetworkTraceInputs extends LitElement {
184
362
  * @internal
185
363
  */
186
364
  get traceLocationDetails(): Collection<TraceLocationDetails>;
365
+ /**
366
+ * The trace locations currently added for the trace.
367
+ * Returns a new array of [TraceLocation](https://developers.arcgis.com/javascript/latest/references/core/rest/networks/support/TraceLocation/)
368
+ * objects that can include starting points, stopping points, and barriers.
369
+ * If a trace location has multiple terminals selected, the returned array contains one entry for each selected terminal.
370
+ *
371
+ * The returned location types depend on
372
+ * [selectedNamedTraceConfiguration](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-inputs/#selectedNamedTraceConfiguration).
373
+ * Starting points are excluded for a
374
+ * [subnetwork trace](https://doc.esri.com/en/arcgis-pro/latest/help/data/utility-network/utility-network-trace-types.html#7A1) when
375
+ * the selected named trace configuration specifies a
376
+ * [subnetworkName](https://developers.arcgis.com/javascript/latest/references/core/networks/support/UNTraceConfiguration/#subnetworkName).
377
+ * Stopping points are included only for
378
+ * [path](https://doc.esri.com/en/arcgis-pro/latest/help/data/utility-network/utility-network-trace-types.html#3B5)
379
+ * traces. Barriers are always included.
380
+ *
381
+ * The returned array can be empty or contain locations with missing terminal selections,
382
+ * depending on the user's inputs in the component.
383
+ */
187
384
  get traceLocations(): TraceLocation[];
188
385
  /**
189
386
  * The view associated with the component.
@@ -192,12 +389,18 @@ export abstract class ArcgisUtilityNetworkTraceInputs extends LitElement {
192
389
  accessor view: MapView | undefined;
193
390
  /** Permanently destroy the component. */
194
391
  destroy(): Promise<void>;
392
+ /** Emitted when the value of a property is changed. Use this to listen to changes to properties. */
195
393
  readonly arcgisPropertyChange: import("@arcgis/lumina").TargetedEvent<this, { name: "mode" | "selectedNamedTraceConfiguration" | "selectedUtilityNetwork" | "traceLocations"; }>;
196
- /** Fires when the user completes the selection of a trace location. */
394
+ /**
395
+ * Fires when trace location selection ends, including when selection is canceled.
396
+ * This event does not guarantee that a trace location was added.
397
+ */
197
398
  readonly arcgisTraceLocationSelectEnd: import("@arcgis/lumina").TargetedEvent<this, void>;
198
399
  /**
199
- * Fires when the user begins selection of a trace location.
200
- * Can be prevented to stop the selection.
400
+ * Fires before map interaction begins to select a trace location, after
401
+ * [beforeMapInteraction](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-inputs/#beforeMapInteraction) resolves, if provided.
402
+ * Call `event.preventDefault()` to prevent selection from starting.
403
+ * The event's `detail.cancelSelect` function can be called to cancel the selection after it starts.
201
404
  */
202
405
  readonly arcgisTraceLocationSelectStart: import("@arcgis/lumina").TargetedEvent<this, SelectStartPayload>;
203
406
  /** Emitted when an action is triggered on the component. */