@arcgis/map-components 5.2.0-next.157 → 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.
@@ -20,16 +20,17 @@ import { initializeProjection as W } from "@arcgis/core/applications/Components/
20
20
  import X from "@arcgis/core/support/actions/ActionButton.js";
21
21
  import { createRef as b, ref as w } from "lit/directives/ref.js";
22
22
  import { b as J, a as Q, c as Y } from "../../chunks/keyboard-utils.js";
23
- const ee = R`:host{display:flex;overflow:hidden;flex:1 1 auto}.root{--calcite-color-background: var(--calcite-color-foreground-1);display:flex;overflow:hidden;flex:1 1 auto;flex-direction:column}.root img{image-orientation:from-image}.flow-item-collapsed{--calcite-flow-item-header-border-block-end: none}.container{display:flex;flex:1 1 auto;background-color:var(--calcite-color-foreground-1)}.container calcite-list{width:100%}.container:not(:empty,.content-hidden){padding:var(--arcgis-internal-padding-md, var(--calcite-spacing-md))}.root .arcgis-feature,.root .arcgis-feature-relationship,.root .arcgis-feature-utility-network-associations{background-color:transparent}.heading{word-break:break-word;word-wrap:break-word}.header,.footer{display:flex;align-items:center;justify-content:flex-end;background-color:var(--calcite-color-foreground-1)}.footer{flex:1}.pagination-text{padding-inline:var(--calcite-spacing-sm);color:var(--calcite-color-text-3);font-size:var(--calcite-font-size-sm)}.loader{align-self:center;padding-inline:var(--calcite-spacing-lg)}.pagination-action-bar{flex:1}.pagination-menu-button{padding-inline:var(--calcite-spacing-xxs);border-inline-start:var(--calcite-border-width-sm) solid var(--calcite-color-border-3)}.icon{display:inline-block;flex:0 0 var(--calcite-spacing-lg);width:var(--calcite-spacing-lg);height:var(--calcite-spacing-lg)}.action-image{flex:0 0 var(--calcite-spacing-lg);background-position:50% 50%;background-repeat:no-repeat;background-size:contain;width:var(--calcite-spacing-lg);height:var(--calcite-spacing-lg)}.header{border-block-end:var(--calcite-border-width-sm) solid var(--calcite-color-border-3)}.content-feature{--calcite-flow-item-footer-padding: 0}.feature-menu-observer{position:relative;bottom:var(--calcite-spacing-xxl);z-index:2;text-align:center}.action-exit{transform:scaleX(-1)}`, te = new X({
23
+ import { g as ee } from "../../chunks/async-utils.js";
24
+ const te = R`:host{display:flex;overflow:hidden;flex:1 1 auto}.root{--calcite-color-background: var(--calcite-color-foreground-1);display:flex;overflow:hidden;flex:1 1 auto;flex-direction:column}.root img{image-orientation:from-image}.flow-item-collapsed{--calcite-flow-item-header-border-block-end: none}.container{display:flex;flex:1 1 auto;background-color:var(--calcite-color-foreground-1)}.container calcite-list{width:100%}.container:not(:empty,.content-hidden){padding:var(--arcgis-internal-padding-md, var(--calcite-spacing-md))}.root .arcgis-feature,.root .arcgis-feature-relationship,.root .arcgis-feature-utility-network-associations{background-color:transparent}.heading{word-break:break-word;word-wrap:break-word}.header,.footer{display:flex;align-items:center;justify-content:flex-end;background-color:var(--calcite-color-foreground-1)}.footer{flex:1}.pagination-text{padding-inline:var(--calcite-spacing-sm);color:var(--calcite-color-text-3);font-size:var(--calcite-font-size-sm)}.loader{align-self:center;padding-inline:var(--calcite-spacing-lg)}.pagination-action-bar{flex:1}.pagination-menu-button{padding-inline:var(--calcite-spacing-xxs);border-inline-start:var(--calcite-border-width-sm) solid var(--calcite-color-border-3)}.icon{display:inline-block;flex:0 0 var(--calcite-spacing-lg);width:var(--calcite-spacing-lg);height:var(--calcite-spacing-lg)}.action-image{flex:0 0 var(--calcite-spacing-lg);background-position:50% 50%;background-repeat:no-repeat;background-size:contain;width:var(--calcite-spacing-lg);height:var(--calcite-spacing-lg)}.header{border-block-end:var(--calcite-border-width-sm) solid var(--calcite-color-border-3)}.content-feature{--calcite-flow-item-footer-padding: 0}.feature-menu-observer{position:relative;bottom:var(--calcite-spacing-xxl);z-index:2;text-align:center}.action-exit{transform:scaleX(-1)}`, ie = new X({
24
25
  icon: "magnifying-glass-plus",
25
26
  id: "zoom-to-feature",
26
27
  title: "{messages.zoom}"
27
- }), M = te.clone(), ie = 25;
28
- function se(k) {
28
+ }), M = ie.clone(), se = 25;
29
+ function ne(k) {
29
30
  return k?.declaredClass.startsWith("esri.layers.") ?? !1;
30
31
  }
31
- const ne = U(B);
32
- class oe extends Z {
32
+ const oe = U(B);
33
+ class ae extends Z {
33
34
  constructor() {
34
35
  super(...arguments), this._direction = P(), this._fetchFeaturesController = null, this._featureMenuIntersectionObserverCallback = ([e]) => {
35
36
  e?.isIntersecting && this.viewModel.featurePage != null && this.viewModel.featurePage++;
@@ -38,13 +39,13 @@ class oe extends Z {
38
39
  }), this._featureMenuIntersectionObserverNode = null, this._rootFlowItemNode = b(), this._featureMenuViewportNode = b(), this._actionBarMenuNode = b(), this._flowContainerNode = b(), this.messages = H(), this._selectedFeatureComponent = b(), this._cancelOpenRelatedFeature = () => {
39
40
  const { _openRelatedFeatureAbortController: e } = this;
40
41
  e && e.abort(), this._openRelatedFeatureAbortController = null;
41
- }, this._spinnerVisible = !1, this._spinnerVisibilityTimeout = null, this._openRelatedFeatureAbortController = null, this.flowItems = new E(), this.viewModel = ne(this), this.actions = this.viewModel.actions, this.active = this.viewModel.active, this.autoDestroyDisabled = !1, this.collapsed = !1, this.content = this.viewModel.content, this.defaultPopupTemplateEnabled = this.viewModel.defaultPopupTemplateEnabled, this.featureCount = this.viewModel.featureCount, this.featureMenuOpen = this.viewModel.featureMenuOpen, this.featureMenuTitle = this.viewModel.featureMenuTitle, this.featureNavigationTop = !1, this.features = this.viewModel.features, this.featuresPerPage = this.viewModel.featuresPerPage, this.featureViewModelAbilities = this.viewModel.featureViewModelAbilities, this.goToOverride = this.viewModel.goToOverride, this.headerActions = new E(), this.heading = this.viewModel.title, this.headingLevel = 2, this.hideActionBar = !1, this.hideCloseButton = !1, this.hideFeatureMenuHeading = !1, this.hideFeatureNavigation = !1, this.hideFeatureListLayerTitle = !1, this.hideHeading = !1, this.hideSelectFeature = !1, this.hideSpinner = !1, this.hideContent = !1, this.hideExpressionContent = !1, this.hideLastEditedInfo = !1, this.highlightDisabled = this.viewModel.highlightEnabled, this.includeDefaultActionsDisabled = this.viewModel.includeDefaultActions, this.initialDisplayMode = this.viewModel.initialDisplayMode, this.location = this.viewModel.location, this.map = this.viewModel.map, this.open = this.viewModel.visible, this.promises = this.viewModel.promises, this.responsiveActionsEnabled = !1, this.selectedFeature = this.viewModel.selectedFeature, this.selectedFeatureIndex = this.viewModel.selectedFeatureIndex, this.showCollapseButton = !1, this.spatialReference = this.viewModel.spatialReference, this.state = this.viewModel.state, this.timeZone = this.viewModel.timeZone, this.updateLocationEnabled = this.viewModel.updateLocationEnabled, this.view = this.viewModel.view, this.arcgisPropertyChange = z()("active", "collapsed", "effectiveHeading", "featureCount", "featureMenuOpen", "features", "promises", "selectedDrillInFeature", "selectedFeature", "selectedFeatureComponent", "selectedFeatureIndex", "state", "open"), this.arcgisReady = T(), this.arcgisClose = T(), this.arcgisTriggerAction = T();
42
+ }, this._spinnerVisible = !1, this._spinnerVisibilityTimeout = null, this._openRelatedFeatureAbortController = null, this.flowItems = new E(), this.viewModel = oe(this), this.actions = this.viewModel.actions, this.active = this.viewModel.active, this.autoDestroyDisabled = !1, this.collapsed = !1, this.content = this.viewModel.content, this.defaultPopupTemplateEnabled = this.viewModel.defaultPopupTemplateEnabled, this.featureCount = this.viewModel.featureCount, this.featureMenuOpen = this.viewModel.featureMenuOpen, this.featureMenuTitle = this.viewModel.featureMenuTitle, this.featureNavigationTop = !1, this.features = this.viewModel.features, this.featuresPerPage = this.viewModel.featuresPerPage, this.featureViewModelAbilities = this.viewModel.featureViewModelAbilities, this.goToOverride = this.viewModel.goToOverride, this.headerActions = new E(), this.heading = this.viewModel.title, this.headingLevel = 2, this.hideActionBar = !1, this.hideCloseButton = !1, this.hideFeatureMenuHeading = !1, this.hideFeatureNavigation = !1, this.hideFeatureListLayerTitle = !1, this.hideHeading = !1, this.hideSelectFeature = !1, this.hideSpinner = !1, this.hideContent = !1, this.hideExpressionContent = !1, this.hideLastEditedInfo = !1, this.highlightDisabled = this.viewModel.highlightEnabled, this.includeDefaultActionsDisabled = this.viewModel.includeDefaultActions, this.initialDisplayMode = this.viewModel.initialDisplayMode, this.location = this.viewModel.location, this.map = this.viewModel.map, this.open = this.viewModel.visible, this.promises = this.viewModel.promises, this.responsiveActionsEnabled = !1, this.selectedFeature = this.viewModel.selectedFeature, this.selectedFeatureIndex = this.viewModel.selectedFeatureIndex, this.showCollapseButton = !1, this.spatialReference = this.viewModel.spatialReference, this.state = this.viewModel.state, this.timeZone = this.viewModel.timeZone, this.updateLocationEnabled = this.viewModel.updateLocationEnabled, this.view = this.viewModel.view, this.arcgisPropertyChange = z()("active", "collapsed", "effectiveHeading", "featureCount", "featureMenuOpen", "features", "promises", "selectedDrillInFeature", "selectedFeature", "selectedFeatureComponent", "selectedFeatureIndex", "state", "open"), this.arcgisReady = T(), this.arcgisClose = T(), this.arcgisTriggerAction = T();
42
43
  }
43
44
  static {
44
45
  this.properties = { _openRelatedFeatureAbortController: 16, flowItems: 16, _hideActionText: 16, _featureNavigationVisible: 16, _isCollapsed: 16, _collapseEnabled: 16, _featureFlowItemSelected: 16, viewModel: 0, actions: 0, active: 0, autoDestroyDisabled: 5, collapseDirection: 1, collapsed: 5, content: 1, defaultPopupTemplateEnabled: 5, effectiveHeading: 32, featureCount: 9, featureMenuOpen: 5, featureMenuTitle: 1, featureNavigationTop: 5, features: 0, featuresPerPage: 9, featureViewModelAbilities: 0, goToOverride: 0, headerActions: 0, heading: 1, headingLevel: 9, hideActionBar: 5, hideCloseButton: 5, hideFeatureMenuHeading: 5, hideFeatureNavigation: 5, hideFeatureListLayerTitle: 5, hideHeading: 5, hideSelectFeature: 5, hideSpinner: 5, hideContent: 5, chartAnimationDisabled: 5, hideAttachmentsContent: 5, hideCustomContent: 5, hideExpressionContent: 5, hideFieldsContent: 5, hideMediaContent: 5, hideRelationshipContent: 5, hideTextContent: 5, hideUtilityNetworkContent: 5, hideLastEditedInfo: 5, highlightDisabled: 5, icon: 1, includeDefaultActionsDisabled: 5, initialDisplayMode: 1, label: 1, location: 0, map: 0, messageOverrides: 0, open: 5, referenceElement: 1, promises: 0, responsiveActionsEnabled: 5, selectedDrillInFeature: 32, selectedFeature: 0, selectedFeatureComponent: 32, selectedFeatureIndex: 9, showCollapseButton: 5, spatialReference: 0, state: 32, timeZone: 1, updateLocationEnabled: 5, view: 0 };
45
46
  }
46
47
  static {
47
- this.styles = ee;
48
+ this.styles = te;
48
49
  }
49
50
  get _hideActionText() {
50
51
  if (!this.responsiveActionsEnabled)
@@ -207,7 +208,7 @@ class oe extends Z {
207
208
  const i = s?.graphic;
208
209
  if (!i)
209
210
  return;
210
- const n = q(i), o = se(n) ? n : null, l = t.get(o) ?? [];
211
+ const n = q(i), o = ne(n) ? n : null, l = t.get(o) ?? [];
211
212
  t.set(o, [...l, s]);
212
213
  }), t;
213
214
  }
@@ -330,7 +331,7 @@ class oe extends Z {
330
331
  _getSpinnerTrackLocation() {
331
332
  return !this.hideSpinner && this.viewModel.visible && this.viewModel?.waitingForResult ? this._spinnerVisible ? !0 : (this._spinnerVisibilityTimeout ??= setTimeout(() => {
332
333
  this._spinnerVisibilityTimeout = null, this._spinnerVisible = !0, this._createSpinner();
333
- }, ie), !1) : (this._clearSpinnerVisibilityTimeout(), this._spinnerVisible = !1, !1);
334
+ }, ee(se)), !1) : (this._clearSpinnerVisibilityTimeout(), this._spinnerVisible = !1, !1);
334
335
  }
335
336
  _createSpinner() {
336
337
  const e = this.referenceElement;
@@ -437,7 +438,7 @@ class oe extends Z {
437
438
  return t ? a`<arcgis-feature .autoDestroyDisabled=${this.autoDestroyDisabled} .chartAnimationDisabled=${this.chartAnimationDisabled} .defaultPopupTemplateEnabled=${this.defaultPopupTemplateEnabled} .flowItems=${this.flowItems} .graphic=${t.graphic} .headingLevel=${this.headingLevel + 1} .hideAttachmentsContent=${this.hideAttachmentsContent} .hideContent=${this.hideContent} .hideCustomContent=${this.hideCustomContent} .hideExpressionContent=${this.hideExpressionContent} .hideFieldsContent=${this.hideFieldsContent} hide-heading .hideLastEditedInfo=${this.hideLastEditedInfo} .hideMediaContent=${this.hideMediaContent} .hideTextContent=${this.hideTextContent} .location=${this.location} .map=${this.map} .messageOverrides=${this.messageOverrides} .referenceElement=${this.referenceElement} .showRelationshipContent=${!this.hideRelationshipContent} .showUtilityNetworkContent=${!this.hideUtilityNetworkContent} .spatialReference=${this.spatialReference} .timeZone=${this.timeZone} ${w(this._selectedFeatureComponent)}></arcgis-feature>` : typeof e == "string" ? D(e, a`<div .innerHTML=${F.sanitize(e) ?? ""}></div>`) : e ?? null;
438
439
  }
439
440
  }
440
- L("arcgis-features", oe);
441
+ L("arcgis-features", ae);
441
442
  export {
442
- oe as ArcgisFeatures
443
+ ae as ArcgisFeatures
443
444
  };
@@ -38,8 +38,14 @@ import type { MapViewOrSceneView } from "@arcgis/core/views/MapViewOrSceneView.j
38
38
  * The Features (next) component should be used if needing to use the Popup functionality outside of the map or scene component. To show a single feature's content without
39
39
  * actions, related records, clustering configuration, etc., then use the [arcgis-feature-next](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-feature-next/) component.
40
40
  *
41
- * @slot [actions-start] - _Since 5.2._ Slot for adding Calcite [actions](https://developers.arcgis.com/calcite-design-system/components/action/) or [action groups](https://developers.arcgis.com/calcite-design-system/components/action-group/) to the start of the action bar. Multiple actions or action groups can be placed in this slot. Slotted actions remain at the start of the action bar and are not automatically grouped if they exceed the available width. To group actions, place them in a Calcite action group. Actions in this slot remain separate from other actions, including default actions (such as "Zoom to" and "Browse features"), [PopupTemplate actions](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/#actions), and [actions](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features-next/#actions).
42
- * @slot [actions-end] - _Since 5.2._ Slot for adding Calcite [actions](https://developers.arcgis.com/calcite-design-system/components/action/) or [action groups](https://developers.arcgis.com/calcite-design-system/components/action-group/) to the end of the action bar. Multiple actions or action groups can be placed in this slot. Slotted actions remain at the end of the action bar and are not automatically grouped if they exceed the available width. To group actions, place them in a Calcite action group. Actions in this slot remain separate from other actions, including default actions (such as "Zoom to" and "Browse features"), [PopupTemplate actions](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/#actions), and [actions](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features-next/#actions).
41
+ * @slot
42
+ * [actions-start] - _Since 5.2._ Slot for adding Calcite [actions](https://developers.arcgis.com/calcite-design-system/components/action/) or [action groups](https://developers.arcgis.com/calcite-design-system/components/action-group/) to the start of the action bar. Multiple actions or action groups can be placed in this slot. Slotted actions remain at the start of the action bar and are not automatically grouped if they exceed the available width. To group actions, place them in a Calcite action group. Actions in this slot remain separate from other actions, including default actions (such as "Zoom to" and "Browse features"), [PopupTemplate actions](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/#actions), and [actions](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features-next/#actions).
43
+ *
44
+ * To display text on the action, use the `text-enabled` attribute of the Calcite [action](https://developers.arcgis.com/calcite-design-system/components/action/#api-reference-properties-textEnabled).
45
+ * @slot
46
+ * [actions-end] - _Since 5.2._ Slot for adding Calcite [actions](https://developers.arcgis.com/calcite-design-system/components/action/) or [action groups](https://developers.arcgis.com/calcite-design-system/components/action-group/) to the end of the action bar. Multiple actions or action groups can be placed in this slot. Slotted actions remain at the end of the action bar and are not automatically grouped if they exceed the available width. To group actions, place them in a Calcite action group. Actions in this slot remain separate from other actions, including default actions (such as "Zoom to" and "Browse features"), [PopupTemplate actions](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/#actions), and [actions](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features-next/#actions).
47
+ *
48
+ * To display text on the action, use the `text-enabled` attribute of the Calcite [action](https://developers.arcgis.com/calcite-design-system/components/action/#api-reference-properties-textEnabled).
43
49
  * @see [PopupTemplate](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/)
44
50
  * @see [arcgis-feature-next](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-feature-next/)
45
51
  * @see [arcgis-popup](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/)
@@ -125,8 +125,14 @@ import type { MapViewOrSceneView } from "@arcgis/core/views/MapViewOrSceneView.j
125
125
  * Custom PopupTemplates may also be assigned directly to a popup by setting [graphics](https://developers.arcgis.com/javascript/latest/references/core/Graphic/) on the
126
126
  * [features](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/#features) property.
127
127
  *
128
- * @slot [actions-start] - _Since 5.2._ Slot for adding Calcite [actions](https://developers.arcgis.com/calcite-design-system/components/action/) or [action groups](https://developers.arcgis.com/calcite-design-system/components/action-group/) to the start of the action bar. Multiple actions or action groups can be placed in this slot. Slotted actions remain at the start of the action bar and are not automatically grouped if they exceed the available width. To group actions, place them in a Calcite action group. Actions in this slot remain separate from other actions, including default actions (such as "Zoom to" and "Browse features"), [PopupTemplate actions](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/#actions), and [actions](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/#actions).
129
- * @slot [actions-end] - _Since 5.2._ Slot for adding Calcite [actions](https://developers.arcgis.com/calcite-design-system/components/action/) or [action groups](https://developers.arcgis.com/calcite-design-system/components/action-group/) to the end of the action bar. Multiple actions or action groups can be placed in this slot. Slotted actions remain at the end of the action bar and are not automatically grouped if they exceed the available width. To group actions, place them in a Calcite action group. Actions in this slot remain separate from other actions, including default actions (such as "Zoom to" and "Browse features"), [PopupTemplate actions](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/#actions), and [actions](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/#actions).
128
+ * @slot
129
+ * [actions-start] - _Since 5.2._ Slot for adding Calcite [actions](https://developers.arcgis.com/calcite-design-system/components/action/) or [action groups](https://developers.arcgis.com/calcite-design-system/components/action-group/) to the start of the action bar. Multiple actions or action groups can be placed in this slot. Slotted actions remain at the start of the action bar and are not automatically grouped if they exceed the available width. To group actions, place them in a Calcite action group. Actions in this slot remain separate from other actions, including default actions (such as "Zoom to" and "Browse features"), [PopupTemplate actions](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/#actions), and [actions](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/#actions).
130
+ *
131
+ * Since the popup component is tied to the view, the actions in this slot will be responsive to the view's size and show/hide the action's text accordingly.
132
+ * @slot
133
+ * [actions-end] - _Since 5.2._ Slot for adding Calcite [actions](https://developers.arcgis.com/calcite-design-system/components/action/) or [action groups](https://developers.arcgis.com/calcite-design-system/components/action-group/) to the end of the action bar. Multiple actions or action groups can be placed in this slot. Slotted actions remain at the end of the action bar and are not automatically grouped if they exceed the available width. To group actions, place them in a Calcite action group. Actions in this slot remain separate from other actions, including default actions (such as "Zoom to" and "Browse features"), [PopupTemplate actions](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/#actions), and [actions](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/#actions).
134
+ *
135
+ * Since the popup component is tied to the view, the actions in this slot will be responsive to the view's size and show/hide the action's text accordingly.
130
136
  * @since 4.34
131
137
  * @beta
132
138
  * @see [PopupTemplate](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/)
@@ -7,11 +7,19 @@ import type SubtypeSublayer from "@arcgis/core/layers/support/SubtypeSublayer.js
7
7
  import type LinkChartView from "@arcgis/core/views/LinkChartView.js";
8
8
  import type { PublicLitElement as LitElement } from "@arcgis/lumina";
9
9
  import type { ArcgisReferenceElement, IconName } from "../types.js";
10
- import type { SupportedRegion } from "./spriteSheetsUtils.js";
11
10
  import type { T9nMeta } from "@arcgis/lumina/controllers";
12
11
 
13
12
  /**
14
- * The Scale Range Slider component allows the user to set a minimum and maximum scale based on named scale ranges. When a layer is provided, the component's minScale and maxScale properties will be set to the scale range of the layer.
13
+ * The supported lowercase [ISO 3166-1 alpha-2 code](https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes)region codes for scale preview thumbnails.
14
+ * The [region](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-slider-scale-range/#region) property also accepts uppercase versions of these codes.
15
+ *
16
+ * @since 5.2
17
+ */
18
+ export type Region = "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";
19
+
20
+ /**
21
+ * The Scale Range Slider component allows the user to set a minimum and maximum scale based on named scale ranges.
22
+ * When a layer is provided, the component's minScale and maxScale properties will be set to the scale range of the layer.
15
23
  *
16
24
  * @since 5.1
17
25
  */
@@ -240,9 +248,9 @@ export abstract class ArcgisSliderScaleRange extends LitElement {
240
248
  /**
241
249
  * The region that the scale thumbnails will focus on.
242
250
  * Each region comes from the [ISO 3166-1 alpha-2 code](https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes).
243
- * See [SupportedRegion](https://developers.arcgis.com/javascript/latest/references/core/widgets/ScaleRangeSlider/types/#SupportedRegion) for the list of regions that are currently supported.
251
+ * Both lowercase and uppercase region codes are supported.
244
252
  */
245
- accessor region: SupportedRegion | undefined;
253
+ accessor region: Region | Uppercase<Region> | undefined;
246
254
  /**
247
255
  * If an [arcgis-scene](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/) is associated with the component and this property
248
256
  * is set to `true`, the current scale indicator will be represented as a highlighted range of the slider track. The width of the indicator will increase
@@ -1,5 +1,10 @@
1
- export type SupportedRegion = LowerCaseRegion | UpperCaseRegion;
1
+ import type { Region } from "./customElement.js";
2
2
 
3
- 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";
3
+ /** @deprecated Use [Region](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-slider-scale-range/#Region) instead. */
4
+ export type LowerCaseRegion = Region;
4
5
 
5
- export type UpperCaseRegion = Uppercase<LowerCaseRegion>;
6
+ /** @deprecated Use `Uppercase<Region>` with [Region](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-slider-scale-range/#Region) instead. */
7
+ export type UpperCaseRegion = Uppercase<LowerCaseRegion>;
8
+
9
+ /** @deprecated Use `Region | Uppercase<Region>` with [Region](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-slider-scale-range/#Region) instead. */
10
+ export type SupportedRegion = LowerCaseRegion | UpperCaseRegion;
@@ -17,11 +17,164 @@ import type { ArcgisUtilityNetworkTraceFunctionsResultItem } from "../arcgis-uti
17
17
  import type { T9nMeta } from "@arcgis/lumina/controllers";
18
18
 
19
19
  /**
20
- * This is a sub-component used by the **ArcgisUtilityNetworkTraceAnalysis** component.
21
- * It displays a subset of trace result types.
20
+ * The Utility Network Trace Results component displays the outcome of a single utility network trace, including its
21
+ * results, an empty result, or an error.
22
22
  *
23
- * @slot - Default slot for adding trace result items or custom content to the component.
23
+ * This component displays results for the following trace result types:
24
+ * [elements](https://developers.arcgis.com/javascript/latest/references/core/rest/networks/support/TraceResult/#elements),
25
+ * [aggregated geometries](https://developers.arcgis.com/javascript/latest/references/core/rest/networks/support/TraceResult/#aggregatedGeometry),
26
+ * and [functions](https://developers.arcgis.com/javascript/latest/references/core/rest/networks/support/TraceResult/#globalFunctionResults).
27
+ *
28
+ * Each result type is displayed by a result item component. By default, this component displays the
29
+ * result items for the result types returned by the trace. To choose which result items are displayed
30
+ * or configure their properties individually, add the
31
+ * [elements result item](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-elements-result-item/),
32
+ * [aggregated geometry result item](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-aggregated-geometry-result-item/), or
33
+ * [functions result item](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-functions-result-item/) to this component's default slot.
34
+ * When the default slot has content, the component displays the slotted content instead of the default result items.
35
+ *
36
+ * ## Use in the trace analysis component's results slot
37
+ *
38
+ * By default, the [arcgis-utility-network-trace-analysis](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-analysis/) component displays aggregated geometry,
39
+ * elements, and functions in its results tab when those result types are returned by the trace.
40
+ * You do not need to slot a results component for this default display configuration. Only slot this component into
41
+ * the trace analysis component's `results` slot when you want to customize the result items in the results tab:
42
+ * choose which items are displayed, configure their properties, or add custom result items.
43
+ *
44
+ * When this component is slotted into the `results` slot of the trace analysis component,
45
+ * the parent trace analysis component sets the
46
+ * [trace result](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-results/#traceResult),
47
+ * [trace error](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-results/#traceError),
48
+ * [utility network](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-results/#utilityNetwork), and
49
+ * [view](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-results/#view) properties.
50
+ *
51
+ * See the [custom result items example](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-results/#custom-result-items-example).
52
+ *
53
+ * ## Use in a custom app outside the trace analysis component
54
+ *
55
+ * To use the component outside of the trace analysis component, slot it into the default slot of
56
+ * [arcgis-utility-network-trace-results-pane](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-results-pane/). This is useful in custom trace workflow applications
57
+ * that display multiple trace results at once or configure each results component independently. Add one trace results
58
+ * component for each trace result and set its properties directly. The pane provides the results container; it does
59
+ * not run traces or synchronize the results components' properties. Your application supplies each component's
60
+ * `traceResult`, `traceError`, `utilityNetwork`, and `view` and manages clearing them.
61
+ *
62
+ * The [view](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-results/#view) property is required for elements and aggregated
63
+ * geometry results. The [utilityNetwork](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-results/#utilityNetwork) property is required
64
+ * to query features for elements results.
65
+ *
66
+ * See the [multiple trace results example](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-results/#multiple-trace-results-example).
67
+ *
68
+ * @slot
69
+ * - Default slot for adding trace result items or custom content.
70
+ * Slotted content replaces the component's default result items.
24
71
  * @since 5.2
72
+ * @example
73
+ * <span id="custom-result-items-example"></span>
74
+ *
75
+ * The following example customizes the display of element results. Other result types are not displayed because the
76
+ * component's default slot contains only an element result item.
77
+ * ```html
78
+ * <arcgis-map item-id="471eb0bf37074b1fbb972b1da70fb310">
79
+ * <arcgis-utility-network-trace-analysis slot="bottom-left">
80
+ * <arcgis-utility-network-trace-results slot="results">
81
+ * <arcgis-utility-network-trace-elements-result-item
82
+ * heading="Feature results"
83
+ * hide-action-bar
84
+ * ></arcgis-utility-network-trace-elements-result-item>
85
+ * </arcgis-utility-network-trace-results>
86
+ * </arcgis-utility-network-trace-analysis>
87
+ * </arcgis-map>
88
+ * ```
89
+ * @example
90
+ * Using the markup above, register these listeners before running a trace to respond to result and error changes and
91
+ * access queried features after all result items finish processing.
92
+ * ```js
93
+ * const results = document.querySelector("arcgis-utility-network-trace-results");
94
+ *
95
+ * results.addEventListener("arcgisPropertyChange", (event) => {
96
+ * if (event.target !== results) {
97
+ * return;
98
+ * }
99
+ *
100
+ * if (event.detail.name === "traceResult") {
101
+ * console.log("Trace result:", results.traceResult);
102
+ * } else if (event.detail.name === "traceError") {
103
+ * if (results.traceError) {
104
+ * console.error("Trace error:", results.traceError);
105
+ * }
106
+ * }
107
+ * });
108
+ *
109
+ * results.addEventListener("arcgisResultsReady", () => {
110
+ * console.log("Result items ready:", results.traceResultFeatures);
111
+ * });
112
+ * ```
113
+ * @example
114
+ * <span id="multiple-trace-results-example"></span>
115
+ *
116
+ * Display two trace results in the default slot of a results pane, without a trace analysis component.
117
+ * Each results component has its own heading and display settings. Unlike the first example, neither component
118
+ * uses `slot="results"` because both are assigned to the pane's default slot.
119
+ * ```html
120
+ * <arcgis-utility-network-trace-results-pane id="trace-results-pane">
121
+ * <arcgis-utility-network-trace-results
122
+ * id="upstream-results"
123
+ * heading="Upstream trace"
124
+ * expandable
125
+ * expanded
126
+ * hide-action-bar
127
+ * ></arcgis-utility-network-trace-results>
128
+ * <arcgis-utility-network-trace-results
129
+ * id="downstream-results"
130
+ * heading="Downstream trace"
131
+ * expandable
132
+ * expanded
133
+ * disable-highlight-feature-results
134
+ * ></arcgis-utility-network-trace-results>
135
+ * </arcgis-utility-network-trace-results-pane>
136
+ * <calcite-button id="clear-trace-results">Clear results</calcite-button>
137
+ * ```
138
+ *
139
+ * In the following JavaScript, `view` is the application's ready MapView, `utilityNetwork` is its loaded utility
140
+ * network, and `upstreamTraceResult` and `downstreamTraceResult` are `TraceResult` objects returned by the application's
141
+ * trace workflow. Set the view and utility network before assigning each trace result.
142
+ * ```js
143
+ * const pane = document.getElementById("trace-results-pane");
144
+ * const upstreamResults = document.getElementById("upstream-results");
145
+ * const downstreamResults = document.getElementById("downstream-results");
146
+ * const resultsComponents = [upstreamResults, downstreamResults];
147
+ *
148
+ * await Promise.all([pane.componentOnReady(), ...resultsComponents.map((results) => results.componentOnReady())]);
149
+ *
150
+ * for (const results of resultsComponents) {
151
+ * results.view = view;
152
+ * results.utilityNetwork = utilityNetwork;
153
+ * }
154
+ *
155
+ * upstreamResults.traceResult = upstreamTraceResult;
156
+ * downstreamResults.traceResult = downstreamTraceResult;
157
+ *
158
+ * document.getElementById("clear-trace-results").addEventListener("click", () => {
159
+ * for (const results of resultsComponents) {
160
+ * results.clearResults();
161
+ * results.traceResult = undefined;
162
+ * results.traceError = undefined;
163
+ * }
164
+ * pane.flowItems.removeAll();
165
+ * });
166
+ * ```
167
+ *
168
+ * If a trace fails, clear the corresponding component's `traceResult` and assign the error to its `traceError`
169
+ * property. The other results component can continue displaying its result. Before displaying a subsequent
170
+ * successful result, reset that component's `traceError` to `undefined`.
171
+ * @see [arcgis-utility-network-trace-analysis](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-analysis/)
172
+ * @see [arcgis-utility-network-trace-results-pane](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-results-pane/)
173
+ * @see [arcgis-utility-network-trace-aggregated-geometry-result-item](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-aggregated-geometry-result-item/)
174
+ * @see [arcgis-utility-network-trace-elements-result-item](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-elements-result-item/)
175
+ * @see [arcgis-utility-network-trace-functions-result-item](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-functions-result-item/)
176
+ * @see [Trace a utility network](https://pro.arcgis.com/en/pro-app/latest/help/data/utility-network/trace-utility-network.htm)
177
+ * @see [Result types](https://pro.arcgis.com/en/pro-app/latest/help/data/utility-network/configure-a-trace.htm#ESRI_SECTION1_9F21343F66554B65B42A3359477D0D2E)
25
178
  */
26
179
  export abstract class ArcgisUtilityNetworkTraceResults extends LitElement {
27
180
  /** @internal */
@@ -77,14 +230,14 @@ export abstract class ArcgisUtilityNetworkTraceResults extends LitElement {
77
230
  * [Color](https://developers.arcgis.com/javascript/latest/references/core/Color/) object.
78
231
  *
79
232
  * Aggregated geometry is only rendered if the trace configuration specifies aggregated geometry as a result type.
80
- *
81
- * Default color is #FFFF00.
233
+ * The default is yellow with 0.6 opacity.
82
234
  */
83
235
  accessor aggregatedGeometryResultsGraphicsColor: Color;
84
236
  /**
85
237
  * The size in points used to render graphics for aggregated geometries in trace results.
86
238
  *
87
239
  * Aggregated geometry is only rendered if the trace configuration specifies aggregated geometry as a result type.
240
+ * The default is `12`.
88
241
  *
89
242
  * @default 12
90
243
  */
@@ -110,37 +263,41 @@ export abstract class ArcgisUtilityNetworkTraceResults extends LitElement {
110
263
  accessor autoDestroyDisabled: boolean;
111
264
  /**
112
265
  * Whether to disable highlighting trace result features on the map.
113
- * If true, the features returned by a trace will not be highlighted on the map.
266
+ *
267
+ * Disabling highlights does not prevent the component from querying features or affect aggregated geometry graphics.
114
268
  *
115
269
  * @default false
116
270
  */
117
271
  accessor disableHighlightFeatureResults: boolean;
118
272
  /**
119
- * When `true`, the component can be expanded and collapsed.
273
+ * Whether the component can be expanded and collapsed.
120
274
  *
121
275
  * @default false
122
276
  */
123
277
  accessor expandable: boolean;
124
278
  /**
125
- * When `true`, expands the component and its contents.
279
+ * Whether the component and its contents are expanded when
280
+ * [expandable](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-results/#expandable) is `true`.
126
281
  *
127
282
  * @default false
128
283
  */
129
284
  accessor expanded: boolean;
130
- /** Specifies the component's heading text. */
285
+ /** The description displayed below the component's localized trace results heading. */
131
286
  accessor heading: string | undefined;
132
287
  /**
133
- * Indicates whether to hide the action bar that holds the feature's
134
- * [arcgis-features-next.actions](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features-next/#actions) when viewing trace result features.
288
+ * Whether to hide the action bar when viewing trace result features.
289
+ * The action bar contains the feature's [actions](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features-next/#actions).
135
290
  *
136
291
  * @default false
137
292
  */
138
293
  accessor hideActionBar: boolean;
139
294
  /**
140
- * Whether to hide feature results.
295
+ * Whether to hide the elements result item and its features list.
141
296
  *
142
- * A message will be displayed in its place indicating that features were returned by the trace, but are not visible in the component.
143
- * This string can be overridden with the [messageOverrides](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-results/#messageOverrides) property.
297
+ * When `true`, the component displays a placeholder instead. Features are still queried and remain available from
298
+ * [traceResultFeatures](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-results/#traceResultFeatures). This property does not disable
299
+ * highlighting; use [disableHighlightFeatureResults](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-results/#disableHighlightFeatureResults) to hide
300
+ * feature highlights.
144
301
  *
145
302
  * @default false
146
303
  */
@@ -149,11 +306,13 @@ export abstract class ArcgisUtilityNetworkTraceResults extends LitElement {
149
306
  * Whether to hide the aggregated geometry [graphics](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-aggregated-geometry-result-item/#geometryGraphics)
150
307
  * from the map when the trace result contains aggregated geometry results.
151
308
  *
309
+ * Hidden graphics remain available from the [arcgis-utility-network-trace-aggregated-geometry-result-item](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-aggregated-geometry-result-item/) component.
310
+ *
152
311
  * @default false
153
312
  */
154
313
  accessor hideGraphics: boolean;
155
314
  /**
156
- * Whether to hide the placeholder string when feature results are hidden.
315
+ * Whether to hide the placeholder shown when feature results are hidden.
157
316
  *
158
317
  * When this property and [hideFeatureResults](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-results/#hideFeatureResults) are both set to `true`,
159
318
  * nothing is rendered for trace result elements. However, features are still queried and are available through
@@ -163,13 +322,21 @@ export abstract class ArcgisUtilityNetworkTraceResults extends LitElement {
163
322
  */
164
323
  accessor hidePlaceholder: boolean;
165
324
  /**
166
- * Indicates whether default actions are disabled (hidden) when viewing trace result features.
167
- * This property must be set to `true` to disable default actions.
325
+ * Whether to hide the default actions when viewing trace result features.
168
326
  *
169
327
  * @default false
170
328
  */
171
329
  accessor includeDefaultActionsDisabled: boolean;
172
- /** The layers and tables used to query trace result features. */
330
+ /**
331
+ * The utility network layers and tables used to query trace result features.
332
+ *
333
+ * When the array is empty, the component uses layers and tables in the map that belong to
334
+ * [utilityNetwork](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-results/#utilityNetwork). Entries that do not belong to that utility
335
+ * network are ignored.
336
+ *
337
+ * Set this property before assigning a trace result. Changing it does not requery the current result or restrict
338
+ * highlighting.
339
+ */
173
340
  accessor layers: Layer[];
174
341
  /**
175
342
  * Replace localized message strings with your own strings.
@@ -196,11 +363,13 @@ export abstract class ArcgisUtilityNetworkTraceResults extends LitElement {
196
363
  traceFailedHeading?: string | undefined;
197
364
  };
198
365
  /**
199
- * The number of unique network element results, including elements that did not match any layer in the map.
366
+ * The number of successfully queried features plus unique trace elements without a matching layer in the map.
200
367
  *
201
- * If multiple slotted instances [arcgis-utility-network-trace-elements-result-item](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-elements-result-item/) exist,
202
- * this property returns the [number of feature results](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-elements-result-item/#numResults)
203
- * for the first instance.
368
+ * If the default slot contains multiple [arcgis-utility-network-trace-elements-result-item](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-elements-result-item/)
369
+ * components, this property returns the
370
+ * [result count](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-elements-result-item/#numResults) from the first one.
371
+ * This value can be lower than the number of elements returned by the trace when feature queries fail or return no
372
+ * matching features.
204
373
  */
205
374
  get numFeatureResults(): number;
206
375
  /**
@@ -210,34 +379,70 @@ export abstract class ArcgisUtilityNetworkTraceResults extends LitElement {
210
379
  */
211
380
  accessor referenceElement: ArcgisReferenceElement | string | undefined;
212
381
  /**
213
- * The current state of the trace results component.
382
+ * The processing state of the component: `"loading"` while result items process a trace result and `"ready"` when no
383
+ * processing is in progress. A `"ready"` state does not necessarily mean that every result item succeeded.
214
384
  *
215
385
  * @default "ready"
216
386
  */
217
387
  get state(): UtilityNetworkTraceResultItemState;
218
- /** The error returned when the trace could not be completed. */
388
+ /**
389
+ * The error returned when the trace could not be completed.
390
+ *
391
+ * When set, the component displays the error instead of [traceResult](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-results/#traceResult).
392
+ * Changes emit [@arcgisPropertyChange](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-results/#event-arcgisPropertyChange).
393
+ */
219
394
  accessor traceError: EsriError<TraceErrorDetails> | undefined;
220
- /** The trace result to display. */
395
+ /**
396
+ * The trace result to display.
397
+ *
398
+ * Assigning a new value clears side effects from the previous result and starts a new processing cycle. It does not
399
+ * emit [@arcgisTraceResultClear](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-results/#event-arcgisTraceResultClear). Changes emit
400
+ * [@arcgisPropertyChange](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-results/#event-arcgisPropertyChange).
401
+ */
221
402
  accessor traceResult: TraceResult | undefined;
222
403
  /**
223
- * The features corresponding to the
224
- * [https://developers.arcgis.com/javascript/latest/references/core/rest/networks/support/TraceResult/#elements](https://developers.arcgis.com/javascript/latest/references/core/rest/networks/support/TraceResult/#elements)
225
- * returned by the trace result.
404
+ * The features successfully queried for the current trace result elements.
405
+ *
406
+ * Read this property after [@arcgisResultsReady](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-results/#event-arcgisResultsReady) fires.
407
+ * Elements without a matching query layer are not included. If the default slot contains multiple
408
+ * [arcgis-utility-network-trace-elements-result-item](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-elements-result-item/) components, this property returns features
409
+ * from the first one.
226
410
  */
227
411
  get traceResultFeatures(): Graphic[];
228
- /** The utility network used to query trace result features. */
412
+ /** The utility network used to resolve trace result elements to features. */
229
413
  accessor utilityNetwork: UtilityNetwork | undefined;
414
+ /** The [MapView](https://developers.arcgis.com/javascript/latest/references/core/views/MapView/) used to display and highlight trace results. */
415
+ accessor view: MapView | undefined;
230
416
  /**
231
- * The view associated with the component.
232
- * > **Note:** The recommended approach is to fully migrate applications to use map and scene components and avoid using MapView and SceneView directly. However, if you are migrating a large application from widgets to components, you might prefer a more gradual transition. To support this use case, the SDK includes this `view` property which connects a component to a MapView or SceneView. Ultimately, once migration is complete, the arcgis-utility-network-trace-results component will be associated with a map or scene component rather than using the `view` property.
417
+ * Clears side effects created by the result items, resets
418
+ * [state](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-results/#state) to `"ready"`, and emits
419
+ * [@arcgisTraceResultClear](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-results/#event-arcgisTraceResultClear).
420
+ *
421
+ * When this component is managed by [arcgis-utility-network-trace-analysis](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-analysis/), using the parent
422
+ * component's clear results action also clears its synchronized
423
+ * [traceResult](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-results/#traceResult) and
424
+ * [traceError](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-results/#traceError) values. Calling this method directly does not
425
+ * change those properties; set them to `undefined` when using this component independently.
233
426
  */
234
- accessor view: MapView | undefined;
235
427
  clearResults(): void;
236
428
  /** Permanently destroy the component. */
237
429
  destroy(): Promise<void>;
238
430
  /** Emitted when the value of a property is changed. Use this to listen to changes to properties. */
239
431
  readonly arcgisPropertyChange: import("@arcgis/lumina").TargetedEvent<this, { name: "aggregatedGeometryResultsGraphicsColor" | "aggregatedGeometryResultsSize" | "hideGraphics" | "state" | "traceError" | "traceResult" | "utilityNetwork" | "view"; }>;
432
+ /**
433
+ * Fires when all participating result items finish processing the current
434
+ * [traceResult](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-results/#traceResult), including when processing produces no results
435
+ * or a result item fails.
436
+ *
437
+ * Calling [clearResults()](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-results/#clearResults) during processing does not emit this
438
+ * event.
439
+ */
240
440
  readonly arcgisResultsReady: import("@arcgis/lumina").TargetedEvent<this, void>;
441
+ /**
442
+ * Fires when [clearResults()](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-results/#clearResults) is called.
443
+ * Replacing or clearing [traceResult](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-utility-network-trace-results/#traceResult) directly does not emit
444
+ * this event.
445
+ */
241
446
  readonly arcgisTraceResultClear: import("@arcgis/lumina").TargetedEvent<this, void>;
242
447
  /** Emitted when an action is triggered on the component. */
243
448
  readonly arcgisTriggerAction: import("@arcgis/lumina").TargetedEvent<this, ActionEvent>;