@arcgis/map-components 4.33.0-next.98 → 4.34.0-next.0

package/dist/components/arcgis-track/customElement.js

@@ -10,8 +10,8 @@ import { m as b } from "../../chunks/useViewModel.js";
 import { g as c } from "../../chunks/globalCss.js";
 import { css as T } from "@lit/reactive-element/css-tag.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
-See https://js.arcgis.com/4.33/esri/copyright.txt for details.
-v4.33.0-next.98 */
+See https://js.arcgis.com/4.34/esri/copyright.txt for details.
+v4.34.0-next.0 */
 const y = T`@layer{arcgis-track{display:block}}`, $ = {
   base: "esri-track"
 }, D = b(v);
@@ -20,7 +20,7 @@ class O extends w {
     super(...arguments), this.messages = E(), this.viewModel = D(this), this.autoDestroyDisabled = !1, this.error = this.viewModel.error, this.geolocationOptions = this.viewModel.geolocationOptions, this.goToOverride = this.viewModel.goToOverride, this.goToLocationDisabled = this.viewModel.goToLocationEnabled, this.graphic = this.viewModel.graphic, this.icon = "compass-north-circle", this.position = "top-left", this.positionFilterFunction = this.viewModel.positionFilterFunction, this.rotationDisabled = this.viewModel.rotationEnabled, this.scale = this.viewModel.scale, this.state = this.viewModel.state, this.tracking = this.viewModel.tracking, this.arcgisComplete = a(() => this.viewModel, "track"), this.arcgisError = a(() => this.viewModel, "track-error"), this.arcgisPropertyChange = m()("state"), this.arcgisReady = f();
   }
   static {
-    this.properties = { autoDestroyDisabled: 5, error: 1, geolocationOptions: 1, goToOverride: 0, goToLocationDisabled: 7, graphic: 0, icon: 3, label: 1, messageOverrides: 0, position: 3, positionFilterFunction: 0, referenceElement: 1, rotationDisabled: 5, scale: 9, state: 0, tracking: 4 };
+    this.properties = { autoDestroyDisabled: 5, error: 1, geolocationOptions: 1, goToOverride: 0, goToLocationDisabled: 7, graphic: 0, icon: 1, label: 1, messageOverrides: 0, position: 3, positionFilterFunction: 0, referenceElement: 1, rotationDisabled: 5, scale: 9, state: 3, tracking: 4 };
   }
   static {
     this.shadowRootOptions = M;
@@ -28,9 +28,6 @@ class O extends w {
   static {
     this.styles = y;
   }
-  //#endregion
-  //#region Public Methods
-  /** Permanently destroy the component */
   async destroy() {
     await this.manager.destroy();
   }
@@ -40,8 +37,6 @@ class O extends w {
   async stop() {
     this.viewModel.stop();
   }
-  //#endregion
-  //#region Private Methods
   _localizeError(t) {
     if (t instanceof GeolocationPositionError)
       return t.code === GeolocationPositionError.PERMISSION_DENIED ? this.messages?.permissionError : t.code === GeolocationPositionError.TIMEOUT ? this.messages?.timeoutError : this.messages?.positionUnavailable;
@@ -60,8 +55,6 @@ class O extends w {
       this.viewModel.start();
     }
   }
-  //#endregion
-  //#region Rendering
   render() {
     const { viewModel: t, messages: o, icon: l } = this, i = t?.state, d = i === "tracking", s = this._localizeError(this.viewModel?.error), r = (d ? o?.stopTracking : o?.startTracking) ?? "", h = i === "feature-unsupported", g = (i === "tracking" ? "pause" : void 0) ?? l ?? void 0;
     return e`<div class=${n(u($.base, c.widget))}>${!h && e`<calcite-button class=${n(c.widgetButton)} .disabled=${i === "disabled"} .iconStart=${g} kind=neutral .label=${r} .loading=${i === "waiting"} @click=${this._toggleTracking} title=${r ?? k}></calcite-button>` || ""}${s ? e`<calcite-tooltip open overlay-positioning=fixed .referenceElement=${this.el}>${s}</calcite-tooltip>` : null}</div>`;

package/dist/components/arcgis-unit-select/customElement.d.ts

@@ -0,0 +1,26 @@
+/// <reference types="@arcgis/core/interfaces.d.ts" />
+/// <reference types="../../index.d.ts" />
+import { JsxNode, PublicLitElement as LitElement, TargetedEvent } from '@arcgis/lumina';
+
+type SystemOrLengthUnit = __esri.LengthUnit | __esri.MeasurementSystem;
+type SystemOrAreaUnit = __esri.AreaUnit | __esri.MeasurementSystem;
+type UnitUnion = SystemOrAreaUnit | SystemOrLengthUnit;
+/**
+ * Component which displays a select component with a list of units or systems of units.
+ * Used by all the measurement components.
+ *
+ * @private
+ */
+export declare class ArcgisUnitSelect<Unit extends UnitUnion = UnitUnion> extends LitElement {
+    options: Unit[];
+    selectLabel: string;
+    value: Unit;
+    /** Replace localized message strings with your own strings. **Warning**: individual message keys may change between releases. */
+    messageOverrides?: typeof this.messages._overrides;
+    label?: string;
+    /** Permanently destroy the component. */
+    destroy(): Promise<void>;
+    readonly arcgisUnitSelectChange: TargetedEvent<this, Unit>;
+    private messages;
+}
+export {};

package/dist/components/arcgis-unit-select/customElement.js

@@ -0,0 +1,39 @@
+import { c as n } from "../../chunks/runtime.js";
+import { repeat as m } from "lit-html/directives/repeat.js";
+import { html as c } from "lit-html";
+import { u as o } from "../../chunks/useT9n.js";
+import { LitElement as g, createEvent as u, safeClassMap as p } from "@arcgis/lumina";
+import { css as h } from "@lit/reactive-element/css-tag.js";
+/*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
+See https://js.arcgis.com/4.34/esri/copyright.txt for details.
+v4.34.0-next.0 */
+const b = h`.arcgis-unit-select{width:100%}.arcgis-unit-select__label{--calcite-label-margin-bottom: 0;width:100%}`, $ = "arcgis-unit-select", d = {
+  label: `${$}__label`
+};
+class f extends g {
+  constructor() {
+    super(...arguments), this.messages = o({}), this.options = [], this.arcgisUnitSelectChange = u();
+  }
+  static {
+    this.properties = { options: 0, selectLabel: 1, value: 0, messageOverrides: 0, label: 1 };
+  }
+  static {
+    this.styles = b;
+  }
+  async destroy() {
+    await this.manager.destroy();
+  }
+  render() {
+    const { messages: s, options: l, selectLabel: a, value: i, arcgisUnitSelectChange: r } = this;
+    return c`<calcite-label class=${p(d.label)}>${a}<calcite-select .label=${a} @calciteSelectChange=${(e) => {
+      r.emit(e.target.value);
+    }}>${m(l, (e) => e, (e) => c`<calcite-option .selected=${e === i} .value=${e}>${y(e) ? s.systems?.[e] : s.units?.[e]?.pluralCapitalized}</calcite-option>`)}</calcite-select></calcite-label>`;
+  }
+}
+function y(t) {
+  return t === "imperial" || t === "metric";
+}
+n("arcgis-unit-select", f);
+export {
+  f as ArcgisUnitSelect
+};

package/dist/components/arcgis-unit-select/index.d.ts

@@ -0,0 +1,4 @@
+import "@esri/calcite-components/components/calcite-label";
+import "@esri/calcite-components/components/calcite-select";
+import "@esri/calcite-components/components/calcite-option";
+export * from "./customElement.js";

package/dist/components/arcgis-unit-select/index.js

@@ -0,0 +1,4 @@
+import "@esri/calcite-components/components/calcite-label";
+import "@esri/calcite-components/components/calcite-select";
+import "@esri/calcite-components/components/calcite-option";
+export * from "./customElement.js";

package/dist/components/arcgis-utility-network-associations/customElement.d.ts

@@ -1,19 +1,18 @@
 /// <reference types="@arcgis/core/interfaces.d.ts" />
 /// <reference types="../../index.d.ts" />
 import { Use } from '@arcgis/lumina/controllers';
-import { Nil } from '@arcgis/components-utils';
 import { default as UtilityNetworkAssociations } from '@arcgis/core/widgets/UtilityNetworkAssociations.js';
 import { ToElement, PublicLitElement as LitElement, TargetedEvent } from '@arcgis/lumina';
 import { PropertyValues } from 'lit';
 import { ArcgisReferenceElement } from '../../utils/component-utils';
 
-export type UtilityNetworkAssociationsWidget = InstanceType<typeof UtilityNetworkAssociations>;
-declare const useUtilityNetworkAssociationsWidget: (component: LitElement & Pick<UtilityNetworkAssociations, never> & {
+declare const useUtilityNetworkAssociationsWidget: (component: LitElement & Pick<UtilityNetworkAssociations, "icon" | "label" | "viewModel" | "utilityNetwork" | "connectivityAssociationsLineSymbol" | "maxAllowableAssociations" | "maxAllowableAssociationsSliderMax" | "maxAllowableAssociationsSliderMin" | "maxAllowableAssociationsSliderStep" | "showArrowsConnectivity" | "showArrowsStructuralAttachment" | "showAssociationsEnabled" | "structuralAttachmentAssociationsLineSymbol"> & {
     state?: unknown;
     viewModel?: __esri.UtilityNetworkAssociationsViewModel | undefined;
-    icon: Nil | string;
-    label: Nil | string;
-    referenceElement: ArcgisReferenceElement | Nil | string;
+    closed?: boolean;
+    icon: import('@arcgis/components-utils').Nil | string;
+    label: import('@arcgis/components-utils').Nil | string;
+    referenceElement?: ArcgisReferenceElement | string;
     position: __esri.UIPosition;
     arcgisReady: import('@arcgis/lumina').EventEmitter;
     arcgisPropertyChange: import('@arcgis/lumina').EventEmitter<{
@@ -23,90 +22,214 @@ declare const useUtilityNetworkAssociationsWidget: (component: LitElement & Pick
         childElem?: HTMLElement & {
             ownedBy?: HTMLElement;
         };
-        view?: __esri.MapView | __esri.SceneView | Nil;
+        view?: __esri.LinkChartView | __esri.MapView | __esri.SceneView;
     };
     autoDestroyDisabled: boolean;
     destroy: () => Promise<void>;
-}, options?: {
-    editConstructorProperties(props: __esri.UtilityNetworkAssociationsProperties | undefined): __esri.UtilityNetworkAssociationsProperties | Promise<__esri.UtilityNetworkAssociationsProperties | undefined> | undefined;
-} | undefined) => UtilityNetworkAssociations;
+}) => UtilityNetworkAssociations;
 /**
- * The UtilityNetworkAssociations component offers an intuitive user interface, reducing the complexity of working with utility network associations.
+ * The Utility Network Associations component offers an intuitive user interface, reducing the complexity of working with utility network associations.
  *
- * > The UtilityNetworkAssociations Component does not support proxied feature services or feature services that utilize stored credentials.
+ * > The Utility Network Associations component does not support proxied feature services or feature services that utilize stored credentials.
  *
  * Note: Sign in to access the data in this sample, U/P: `viewer01`/`I68VGU^nMurF`
+ *
+ * [Read more...](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-utility-network-associations/)
  */
 export declare class ArcgisUtilityNetworkAssociations extends LitElement {
     /**
      * If true, the component will not be destroyed automatically when it is
      * disconnected from the document. This is useful when you want to move the
      * component to a different place on the page, or temporarily hide it. If this
-     * is set, make sure to call the \`destroy\` method when you are done to prevent
-     * memory leaks.
+     * is set, make sure to call the [destroy](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-utility-network-associations/#destroy) method when you are done to
+     * prevent memory leaks.
+     *
+     * @default false
      */
     autoDestroyDisabled: boolean;
-    /** @default false */
+    /**
+     * Indicates whether to show a toggle to automatically show associations every time the map
+     * extent changes, or an action button to show associations within the current map extent on demand.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-UtilityNetworkAssociations.html#autoRefreshAssociations)
+     *
+     * @default false
+     */
     autoRefreshAssociationsDisabled: boolean;
+    /**
+     * A [SimpleLineSymbol](https://developers.arcgis.com/javascript/latest/api-reference/esri-symbols-SimpleLineSymbol.html) used for representing the polyline geometry that is being
+     * drawn for connectivity associations.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-UtilityNetworkAssociations.html#connectivityAssociationsLineSymbol)
+     */
     connectivityAssociationsLineSymbol: __esri.SimpleLineSymbol;
-    /** @default false */
+    /**
+     * Indicates whether to query and display connectivity associations.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-UtilityNetworkAssociations.html#includeConnectivityAssociations)
+     *
+     * @default false
+     */
     includeConnectivityAssociationsDisabled: boolean;
-    /** @default false */
+    /**
+     * Indicates whether to query and display structural attachment associations.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-UtilityNetworkAssociations.html#includeStructuralAttachmentAssociations)
+     *
+     * @default false
+     */
     includeStructuralAttachmentAssociationsDisabled: boolean;
+    /**
+     * The maximum number of associations that can be returned from the server.
+     *
+     * @default 250
+     */
     maxAllowableAssociations: number;
+    /**
+     * The maximum value or upper bound of the Maximum allowable associations slider.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-UtilityNetworkAssociations.html#maxAllowableAssociationsSliderMax)
+     */
     maxAllowableAssociationsSliderMax: number;
+    /**
+     * The minimum value or lower bound of the Maximum allowable associations slider.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-UtilityNetworkAssociations.html#maxAllowableAssociationsSliderMin)
+     */
     maxAllowableAssociationsSliderMin: number;
+    /**
+     * Specifies the interval to move the maximum allowable associations slider with the up, or down keys.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-UtilityNetworkAssociations.html#maxAllowableAssociationsSliderStep)
+     */
     maxAllowableAssociationsSliderStep: number;
+    /** @default "bottom-left" */
     position: __esri.UIPosition;
-    referenceElement: ArcgisReferenceElement | Nil | string;
+    referenceElement?: ArcgisReferenceElement | string;
+    /**
+     * Indicates whether to show arrows for connectivity associations.
+     *
+     * @default false
+     */
     showArrowsConnectivity: boolean;
+    /**
+     * Indicates whether to show arrows for structural attachment associations.
+     *
+     * @default false
+     */
     showArrowsStructuralAttachment: boolean;
+    /**
+     * When `autoRefreshAssociations` is `true`, indicates whether to automatically show associations
+     * every time the current map extent changes.
+     *
+     * @default false
+     */
     showAssociationsEnabled: boolean;
+    /**
+     * A [SimpleLineSymbol](https://developers.arcgis.com/javascript/latest/api-reference/esri-symbols-SimpleLineSymbol.html) used for representing the polyline geometry that is being drawn for structural attachment associations.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-UtilityNetworkAssociations.html#structuralAttachmentAssociationsLineSymbol)
+     */
     structuralAttachmentAssociationsLineSymbol: __esri.SimpleLineSymbol;
+    /**
+     * Determines the utility network to use.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-UtilityNetworkAssociations.html#utilityNetwork)
+     */
     utilityNetwork: nullish | __esri.UtilityNetwork;
+    /** @default false */
     showConnectivityAssociationsSettingsArrowsToggle: boolean;
-    /** @deprecated **Deprecated** since 4.32. Use hideConnectivityAssociationsSettingsArrowsToggle instead */
+    /**
+     * @deprecated since 4.32. Use hideConnectivityAssociationsSettingsArrowsToggle instead
+     * @default false
+     */
     visibleElementsConnectivityAssociationsSettingsArrowsToggle: boolean;
+    /** @default false */
     showConnectivityAssociationsSettingsCapSelect: boolean;
-    /** @deprecated **Deprecated** since 4.32. Use hideConnectivityAssociationsSettingsCapSelect instead */
+    /**
+     * @deprecated since 4.32. Use hideConnectivityAssociationsSettingsCapSelect instead
+     * @default false
+     */
     visibleElementsConnectivityAssociationsSettingsCapSelect: boolean;
+    /** @default false */
     hideConnectivityAssociationsSettingsColorPicker: boolean;
-    /** @deprecated **Deprecated** since 4.32. Use hideConnectivityAssociationsSettingsColorPicker instead */
+    /**
+     * @deprecated since 4.32. Use hideConnectivityAssociationsSettingsColorPicker instead
+     * @default true
+     */
     visibleElementsConnectivityAssociationsSettingsColorPicker: boolean;
+    /** @default false */
     hideConnectivityAssociationsSettingsStylePicker: boolean;
-    /** @deprecated **Deprecated** since 4.32. Use hideConnectivityAssociationsSettingsStylePicker instead */
+    /**
+     * @deprecated since 4.32. Use hideConnectivityAssociationsSettingsStylePicker instead
+     * @default true
+     */
     visibleElementsConnectivityAssociationsSettingsStylePicker: boolean;
+    /** @default false */
     hideConnectivityAssociationsSettingsWidthInput: boolean;
-    /** @deprecated **Deprecated** since 4.32. Use hideConnectivityAssociationsSettingsWidthInput instead */
+    /**
+     * @deprecated since 4.32. Use hideConnectivityAssociationsSettingsWidthInput instead
+     * @default true
+     */
     visibleElementsConnectivityAssociationsSettingsWidthInput: boolean;
+    /** @default false */
     showMaxAllowableAssociationsSlider: boolean;
-    /** @deprecated **Deprecated** since 4.32. Use hideMaxAllowableAssociationsSlider instead */
+    /**
+     * @deprecated since 4.32. Use hideMaxAllowableAssociationsSlider instead
+     * @default false
+     */
     visibleElementsMaxAllowableAssociationsSlider: boolean;
+    /** @default false */
     showStructuralAttachmentAssociationsSettingsArrowsToggle: boolean;
-    /** @deprecated **Deprecated** since 4.32. Use hideStructuralAttachmentAssociationsSettingsArrowsToggle instead */
+    /**
+     * @deprecated since 4.32. Use hideStructuralAttachmentAssociationsSettingsArrowsToggle instead
+     * @default false
+     */
     visibleElementsStructuralAttachmentAssociationsSettingsArrowsToggle: boolean;
+    /** @default false */
     showStructuralAttachmentAssociationsSettingsCapSelect: boolean;
-    /** @deprecated **Deprecated** since 4.32. Use hideStructuralAttachmentAssociationsSettingsCapSelect instead */
+    /**
+     * @deprecated since 4.32. Use hideStructuralAttachmentAssociationsSettingsCapSelect instead
+     * @default false
+     */
     visibleElementsStructuralAttachmentAssociationsSettingsCapSelect: boolean;
+    /** @default false */
     hideStructuralAttachmentAssociationsSettingsColorPicker: boolean;
-    /** @deprecated **Deprecated** since 4.32. Use hideStructuralAttachmentAssociationsSettingsColorPicker instead */
+    /**
+     * @deprecated since 4.32. Use hideStructuralAttachmentAssociationsSettingsColorPicker instead
+     * @default true
+     */
     visibleElementsStructuralAttachmentAssociationsSettingsColorPicker: boolean;
+    /** @default false */
     hideStructuralAttachmentAssociationsSettingsStylePicker: boolean;
-    /** @deprecated **Deprecated** since 4.32. Use hideStructuralAttachmentAssociationsSettingsStylePicker instead */
+    /**
+     * @deprecated since 4.32. Use hideStructuralAttachmentAssociationsSettingsStylePicker instead
+     * @default true
+     */
     visibleElementsStructuralAttachmentAssociationsSettingsStylePicker: boolean;
+    /** @default false */
     hideStructuralAttachmentAssociationsSettingsWidthInput: boolean;
-    /** @deprecated **Deprecated** since 4.32. Use hideStructuralAttachmentAssociationsSettingsWidthInput instead */
+    /**
+     * @deprecated since 4.32. Use hideStructuralAttachmentAssociationsSettingsWidthInput instead
+     * @default true
+     */
     visibleElementsStructuralAttachmentAssociationsSettingsWidthInput: boolean;
     /**
-     * Icon which represents the component.
-     * Typically used when the component is controlled by another component (e.g. by the Expand component).
-     * Search [Calcite Icons](https://developers.arcgis.com/calcite-design-system/icons/) for possible values.
+     * Icon displayed in the widget's button.
+     *
+     * @see [Calcite Icons](https://developers.arcgis.com/calcite-design-system/icons/)
+     * @default "view-associations"
      */
     icon: string;
-    /** The component's default label. */
+    /**
+     * The widget's default label.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-UtilityNetworkAssociations.html#label)
+     */
     label: string;
-    /** Permanently destroy the component */
+    /** Permanently destroy the component. */
     destroy(): Promise<void>;
-    readonly arcgisReady: TargetedEvent<this, undefined>;
+    /** Emitted when the component associated with a map or scene view is is ready to be interacted with. */
+    readonly arcgisReady: TargetedEvent<this, void>;
 }
 export {};

package/dist/components/arcgis-utility-network-associations/customElement.js

@@ -3,8 +3,8 @@ import a from "@arcgis/core/widgets/UtilityNetworkAssociations.js";
 import { LitElement as c, createEvent as r, noShadowRoot as h } from "@arcgis/lumina";
 import { m as A } from "../../chunks/useWidget.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
-See https://js.arcgis.com/4.33/esri/copyright.txt for details.
-v4.33.0-next.98 */
+See https://js.arcgis.com/4.34/esri/copyright.txt for details.
+v4.34.0-next.0 */
 const S = A(a);
 class g extends c {
   constructor() {
@@ -16,14 +16,9 @@ class g extends c {
   static {
     this.shadowRootOptions = h;
   }
-  //#endregion
-  //#region Public Methods
-  /** Permanently destroy the component */
   async destroy() {
     await this.manager.destroy();
   }
-  //#endregion
-  //#region Lifecycle
   async load() {
     if (this.el.view?.map && this.el.view.map.portalItem) {
       await this.el.view.map.load();
@@ -34,8 +29,6 @@ class g extends c {
   willUpdate(t) {
     this._handleVisibilityChange(t, "ConnectivityAssociationsSettingsArrowsToggle"), this._handleVisibilityChange(t, "ConnectivityAssociationsSettingsCapSelect"), this._handleVisibilityChange(t, "ConnectivityAssociationsSettingsColorPicker"), this._handleVisibilityChange(t, "ConnectivityAssociationsSettingsStylePicker"), this._handleVisibilityChange(t, "ConnectivityAssociationsSettingsWidthInput"), this._handleVisibilityChange(t, "MaxAllowableAssociationsSlider"), this._handleVisibilityChange(t, "StructuralAttachmentAssociationsSettingsArrowsToggle"), this._handleVisibilityChange(t, "StructuralAttachmentAssociationsSettingsCapSelect"), this._handleVisibilityChange(t, "StructuralAttachmentAssociationsSettingsStylePicker"), this._handleVisibilityChange(t, "StructuralAttachmentAssociationsSettingsWidthInput");
   }
-  //#endregion
-  //#region Private Methods
   _handleVisibilityChange(t, n) {
     const s = `show${n}`, o = `hide${n}`, e = `visibleElements${n}`, i = this;
     t.has(s) ? i[e] = !!i[s] : t.has(o) ? i[e] = !i[o] : t.has(e) && (console.warn(`${this.el.tagName.toLowerCase()}: The property ${e} is deprecated. Use ${s in i ? s : o} instead.`), s in i ? i[s] = !!i[e] : o in i && (i[o] = !i[e]));

package/dist/components/arcgis-utility-network-trace/customElement.d.ts

@@ -2,17 +2,16 @@
 /// <reference types="../../index.d.ts" />
 import { Use } from '@arcgis/lumina/controllers';
 import { default as UtilityNetworkTrace } from '@arcgis/core/widgets/UtilityNetworkTrace.js';
-import { Nil } from '@arcgis/components-utils';
 import { PublicLitElement as LitElement, TargetedEvent } from '@arcgis/lumina';
 import { ArcgisReferenceElement } from '../../utils/component-utils';
 
-export type UtilityNetworkTraceWidget = InstanceType<typeof UtilityNetworkTrace>;
-declare const useUtilityNetworkTraceWidget: (component: LitElement & Pick<UtilityNetworkTrace, never> & {
+declare const useUtilityNetworkTraceWidget: (component: LitElement & Pick<UtilityNetworkTrace, "icon" | "label" | "viewModel" | "defaultGraphicColor" | "disabled" | "enableResultArea" | "flags" | "gdbVersion" | "inputSettings" | "resultAreaProperties" | "selectedTraces"> & {
     state?: unknown;
     viewModel?: __esri.UtilityNetworkTraceViewModel | undefined;
-    icon: Nil | string;
-    label: Nil | string;
-    referenceElement: ArcgisReferenceElement | Nil | string;
+    closed?: boolean;
+    icon: import('@arcgis/components-utils').Nil | string;
+    label: import('@arcgis/components-utils').Nil | string;
+    referenceElement?: ArcgisReferenceElement | string;
     position: __esri.UIPosition;
     arcgisReady: import('@arcgis/lumina').EventEmitter;
     arcgisPropertyChange: import('@arcgis/lumina').EventEmitter<{
@@ -22,61 +21,161 @@ declare const useUtilityNetworkTraceWidget: (component: LitElement & Pick<Utilit
         childElem?: HTMLElement & {
             ownedBy?: HTMLElement;
         };
-        view?: __esri.MapView | __esri.SceneView | Nil;
+        view?: __esri.LinkChartView | __esri.MapView | __esri.SceneView;
     };
     autoDestroyDisabled: boolean;
     destroy: () => Promise<void>;
-}, options?: {
-    editConstructorProperties(props: __esri.UtilityNetworkTraceProperties | undefined): __esri.UtilityNetworkTraceProperties | Promise<__esri.UtilityNetworkTraceProperties | undefined> | undefined;
-} | undefined) => UtilityNetworkTrace;
-/** UtilityNetworkTrace component provides a way to run traces in a Utility Network based on connectivity or traversability from set input flags. Input flags (starting points and barriers) can be set by clicking the view.
-
-> The UtilityNetworkTrace Component does not support proxied feature services or feature services that utilize stored credentials.
-
-Note: Sign in to access the data in this sample, U/P: `viewer01`/`I68VGU^nMurF`
+}) => UtilityNetworkTrace;
+/**
+ * Utility Network Trace component provides a way to run traces in a Utility Network based on connectivity or traversability from set input flags. Input flags (starting points and barriers) can be set by clicking the view.
+ *
+ * > The Utility Network Trace component does not support proxied feature services or feature services that utilize stored credentials.
+ *
+ * Note: Sign in to access the data in this sample, U/P: `viewer01`/`I68VGU^nMurF`
+ *
+ * [Read more...](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-utility-network-trace/)
  */
 export declare class ArcgisUtilityNetworkTrace extends LitElement {
     /**
      * If true, the component will not be destroyed automatically when it is
      * disconnected from the document. This is useful when you want to move the
      * component to a different place on the page, or temporarily hide it. If this
-     * is set, make sure to call the \`destroy\` method when you are done to prevent
-     * memory leaks.
+     * is set, make sure to call the [destroy](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-utility-network-trace/#destroy) method when you are done to
+     * prevent memory leaks.
+     *
+     * @default false
      */
     autoDestroyDisabled: boolean;
+    /**
+     * The default color to assign the aggregated geometry of a trace result.
+     *
+     * @default
+     * {
+     * color: [255, 255, 0, 0.6],
+     * haloOpacity: 0.9,
+     * fillOpacity: 0.2,
+     * hex: "#FFFF00"
+     * }
+     */
     defaultGraphicColor: __esri.GraphicColor;
+    /**
+     * When true, the widget is visually withdrawn and cannot be interacted with.
+     *
+     * @default true
+     */
     disabled: boolean;
+    /**
+     * When `true`, provides the ability to show the convex hull or buffer.
+     *
+     * @default false
+     */
     enableResultArea: boolean;
+    /**
+     * An array of map points to load into the widget to lookup flags.
+     *
+     * @default []
+     */
     flags: __esri.FlagProperty[];
+    /**
+     * The Geodatabase version to pass into the trace.
+     *
+     * @deprecated since version 4.31, gdbVersion will be removed and the gdbVersion of the {@link module :esri/networks/UtilityNetwork} will be consumed directly.
+     * @default "sde.DEFAULT"
+     */
     gdbVersion: string;
     /**
-     * Icon displayed in the component's button.
-     * Search [Calcite Icons](https://developers.arcgis.com/calcite-design-system/icons/) for possible values.
+     * Icon displayed in the widget's button.
+     *
+     * @see [Calcite Icons](https://developers.arcgis.com/calcite-design-system/icons/)
+     * @default "utility-network-trace"
      */
     icon: string;
-    inputSettings: UtilityNetworkTraceWidget["inputSettings"];
-    /** The component's default label. */
+    /**
+     * Custom labels, descriptions, and symbol for the input [flags](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-UtilityNetworkTrace.html#flags).
+     *
+     * @default []
+     */
+    inputSettings: __esri.InputSetting[];
+    /**
+     * The widget's default label.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-UtilityNetworkTrace.html#label)
+     */
     label: string;
+    /** @default "top-right" */
     position: __esri.UIPosition;
-    referenceElement: ArcgisReferenceElement | Nil | string;
-    resultAreaProperties?: UtilityNetworkTraceWidget["resultAreaProperties"];
+    referenceElement?: ArcgisReferenceElement | string;
+    /**
+     * The properties to determine the size and color of the result area convex hull or buffer, and determines if it displays on the map when the trace completes.
+     *
+     * @default
+     * {
+     * type: "convexhull",
+     * distance: 10,
+     * unit: "meters",
+     * areaUnit: "square-meters",
+     * color: {
+     * color: [255, 165, 0, 0.5],
+     * haloOpacity: 0.9,
+     * fillOpacity: 0.2,
+     * hex: "#ffa500"
+     * },
+     * show: false
+     * }
+     */
+    resultAreaProperties: __esri.ResultAreaPropertiesExtend;
+    /**
+     * When true, the utility network elements are selected in the view when traces are completed.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-UtilityNetworkTrace.html#selectOnComplete)
+     *
+     * @default true
+     */
     selectOnCompleteDisabled: boolean;
-    selectedTraces: UtilityNetworkTraceWidget["selectedTraces"];
+    /**
+     * A list of global Ids of traces to select on load.
+     *
+     * @default []
+     */
+    selectedTraces: string[];
+    /**
+     * When true, a graphic layer is added to the view to highlight the utility network elements when traces are completed.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-UtilityNetworkTrace.html#showGraphicsOnComplete)
+     *
+     * @default true
+     */
     showGraphicsOnCompleteDisabled: boolean;
+    /**
+     * Determines whether to show list of selection attributes.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-UtilityNetworkTrace.html#showSelectionAttributes)
+     *
+     * @default true
+     */
     showSelectionAttributesDisabled: boolean;
+    /**
+     * The view model's state.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-UtilityNetworkTrace-UtilityNetworkTraceViewModel.html#state)
+     *
+     * @default "ready"
+     */
     readonly state: "ready" | "loading";
     checkCanTrace(): Promise<void>;
     confirmReset(): Promise<void>;
-    /** Permanently destroy the component */
+    /** Permanently destroy the component. */
     destroy(): Promise<void>;
     readonly arcgisAddFlag: TargetedEvent<this, __esri.UtilityNetworkTraceAddFlagEvent>;
     readonly arcgisAddFlagComplete: TargetedEvent<this, __esri.UtilityNetworkTraceAddFlagCompleteEvent>;
     readonly arcgisAddFlagError: TargetedEvent<this, __esri.UtilityNetworkTraceAddFlagErrorEvent>;
     readonly arcgisAddResultArea: TargetedEvent<this, __esri.UtilityNetworkTraceAddResultAreaEvent>;
+    /** Emitted when the value of a property is changed. Use this to listen to changes to properties. */
     readonly arcgisPropertyChange: TargetedEvent<this, {
         name: "state";
     }>;
-    readonly arcgisReady: TargetedEvent<this, undefined>;
+    /** Emitted when the component associated with a map or scene view is is ready to be interacted with. */
+    readonly arcgisReady: TargetedEvent<this, void>;
     readonly arcgisRemoveResultArea: TargetedEvent<this, __esri.UtilityNetworkTraceRemoveResultAreaEvent>;
 }
 export {};