@arcgis/core 5.0.0-next.51 → 5.0.0-next.53

package/rest/networks/support/NetworkElement.d.ts

@@ -1,4 +1,83 @@
-import "../../../interfaces";
+import type { JSONSupport, JSONSupportMixinProperties } from "../../../core/JSONSupport.js";
 
-import NetworkElement = __esri.NetworkElement;
-export default NetworkElement;
+export interface NetworkElementProperties extends JSONSupportMixinProperties, Partial<Pick<NetworkElement, "assetGroupCode" | "assetTypeCode" | "globalId" | "networkSourceId" | "objectId" | "positionFrom" | "positionTo" | "terminalId">> {}
+
+/**
+ * The network element is a representation of how the network topology defines its graph. The network topology (or index) work with network elements and thats how the trace traverses those elements.
+ * This class contains basic properties as seen in the network topology. For performance reasons, many utility network functions return network elements and not "full" features.
+ * One feature can have many network elements.
+ *
+ * An example is a tri-state transformer with 3 terminals with High side (H) and two Low sides (X1, X2). The feature globalId could be `g` but it is composed of three network elements, g-H, g-X1 and g-X2.
+ * ```js
+ *      H
+ *
+ *    /   \
+ *
+ * X1       X2
+ * ```
+ * It is worth mentioning that elements in the network topology also have an elementId which is purely internal to the network and not exposed externally. Those elementIds are then converted to matching {@link rest/networks/support/NetworkElement#objectID}/[globalId](https://developers.arcgis.com/javascript/latest/api-reference/esri-rest-networks-support-NetworkElement.html#globalId)`.
+ *
+ * @since 4.20
+ * @see [trace](https://developers.arcgis.com/javascript/latest/api-reference/esri-rest-networks-trace.html)
+ */
+export default class NetworkElement extends JSONSupport {
+  constructor(properties?: NetworkElementProperties);
+  /** The asset group code that this network element represents. */
+  accessor assetGroupCode: number;
+  /** The asset type code discriminator this network element represents. */
+  accessor assetTypeCode: number;
+  /** The globalId of the feature the network element belongs to. */
+  accessor globalId: string;
+  /** The network source Id of the feature the network element belongs to. Note that this is different from [Network#layerId](https://developers.arcgis.com/javascript/latest/api-reference/esri-networks-Network.html#layerId) and you need to use [Network#getLayerIdBySourceId()](https://developers.arcgis.com/javascript/latest/api-reference/esri-networks-Network.html#getLayerIdBySourceId) to get the `layerId`. */
+  accessor networkSourceId: number;
+  /** The objectId of the feature the network element belongs to. */
+  accessor objectId: number;
+  /**
+   * Applicable to edge elements, represents a double value (0 to 1) where this edge element starts.
+   *
+   * @example
+   * Line feature with objectId 100 with 2 midspan junctions (j1,j2). The line feature has 3 edge network elements
+   * F-j1, j1-j2 and j2-T.
+   *
+   *                                        OID=100
+   *                                F------j1------j2------T
+   *
+   * F-j1  (objectId=100, positionFrom=0, positionTo=0.33)
+   * j1-j2 (objectId=100, positionFrom=0.33, positionTo=0.66)
+   * j2-T  (objectId=100, positionFrom=0.66, positionTo=1)
+   */
+  accessor positionFrom: number;
+  /**
+   * Applicable to edge elements, represents a double value (0 to 1) where this edge element ends.
+   *
+   * @example
+   * Line feature with objectId 100 with 2 midspan junctions (j1,j2). The line feature has 3 edge network elements
+   * F-j1, j1-j2 and j2-T.
+   *
+   *                                        OID=100
+   *                                F------j1------j2------T
+   *
+   * F-j1  (objectId=100, positionFrom=0, positionTo=0.33)
+   * j1-j2 (objectId=100, positionFrom=0.33, positionTo=0.66)
+   * j2-T  (objectId=100, positionFrom=0.66, positionTo=1)
+   */
+  accessor positionTo: number | null | undefined;
+  /**
+   * The terminal id defined at the network element.
+   *
+   * @see [Terminal](https://developers.arcgis.com/javascript/latest/api-reference/esri-networks-support-Terminal.html)
+   */
+  accessor terminalId: number;
+  /**
+   * The type of the network element.
+   * This is always `networkElement` unless the object is a
+   * [TelecomNetworkElement](https://developers.arcgis.com/javascript/latest/api-reference/esri-rest-networks-support-TelecomNetworkElement.html) in a telecom domain network.
+   *
+   * > [!WARNING]
+   * >
+   * > Type `telecomNetworkElement` is reserved for telecom domain networks.
+   *
+   * @default "networkElement"
+   */
+  get type(): "networkElement" | "telecomNetworkElement";
+}

package/rest/networks/support/QueryAssociationsParameters.d.ts

@@ -1,4 +1,102 @@
-import "../../../interfaces";
+import type NetworkElement from "./NetworkElement.js";
+import type { JSONSupport, JSONSupportMixinProperties } from "../../../core/JSONSupport.js";
+import type { AssociationType } from "../../../networks/support/typeUtils.js";
+import type { NetworkElementProperties } from "./NetworkElement.js";
 
-import QueryAssociationsParameters = __esri.QueryAssociationsParameters;
-export default QueryAssociationsParameters;
+export interface QueryAssociationsParametersProperties extends JSONSupportMixinProperties, Partial<Pick<QueryAssociationsParameters, "gdbVersion" | "returnDeletes" | "types">> {
+  /** The [NetworkElements](https://developers.arcgis.com/javascript/latest/api-reference/esri-rest-networks-support-NetworkElement.html) for which the association is queried. */
+  elements?: NetworkElementProperties[];
+  /**
+   * The date/timestamp (in UTC) to execute the function. This could be used to run the function in a moment in the past or in long transaction mode (undo/redo). Applicable to branch versioned datasets only.
+   *
+   * @see [Learn more about branch versioning](https://pro.arcgis.com/en/pro-app/latest/help/data/geodatabases/overview/data-management-strategies.htm#ESRI_SECTION1_6FA2CFB5F9484FF096740D653C674B5D).
+   */
+  moment?: (Date | number | string) | null;
+}
+
+/**
+ * QueryAssociationsParameters describes the parameters required to execute the [queryAssociations](https://developers.arcgis.com/javascript/latest/api-reference/esri-rest-networks-queryAssociations.html) function, which returns a list of [associations](https://developers.arcgis.com/javascript/latest/api-reference/esri-rest-networks-support-Association.html) filtered by the parameters set.
+ *
+ * @since 4.24
+ * @see [Association](https://developers.arcgis.com/javascript/latest/api-reference/esri-rest-networks-support-Association.html)
+ * @see [QueryAssociationsResult](https://developers.arcgis.com/javascript/latest/api-reference/esri-rest-networks-support-QueryAssociationsResult.html)
+ * @see [queryAssociations](https://developers.arcgis.com/javascript/latest/api-reference/esri-rest-networks-queryAssociations.html)
+ * @example
+ * // Define the QueryAssociationsParameters
+ * const queryAssociationsParameters = new QueryAssociationsParameters({
+ *   types: ["containment", "attachment", "junction-edge-from-connectivity"],
+ *   elements: [
+ *     {
+ *       networkSourceId: 2,
+ *       globalId: "{46B3FA19-2237-4D38-A7CF-AA34C3T40420}",
+ *       objectId: 44,
+ *       terminalId: 1,
+ *       assetGroupCode: 1,
+ *       assetTypeCode: 1
+ *     },
+ *     {
+ *       networkSourceId: 9,
+ *       globalId: "{321C0089-1165-42D9-K45B-ED91B1A40500}",
+ *       objectId: 45,
+ *       terminalId: 1,
+ *       assetGroupCode: 13,
+ *       assetTypeCode: 441
+ *     }
+ *  ]
+ * });
+ *
+ * // Query associations, and assign the query result to a variable `associations`
+ * const associations = await queryAssociations(networkServiceUrl, queryAssociationsParameters);
+ *
+ * // Print out the first association
+ * console.log(associations[0]);
+ */
+export default class QueryAssociationsParameters extends JSONSupport {
+  constructor(properties?: QueryAssociationsParametersProperties);
+  /** The [NetworkElements](https://developers.arcgis.com/javascript/latest/api-reference/esri-rest-networks-support-NetworkElement.html) for which the association is queried. */
+  get elements(): NetworkElement[];
+  set elements(value: NetworkElementProperties[]);
+  /** The geodatabase version to execute the function against. Defaults to `SDE.DEFAULT`, if no version is provided. */
+  accessor gdbVersion: string | null | undefined;
+  /**
+   * The date/timestamp (in UTC) to execute the function. This could be used to run the function in a moment in the past or in long transaction mode (undo/redo). Applicable to branch versioned datasets only.
+   *
+   * @see [Learn more about branch versioning](https://pro.arcgis.com/en/pro-app/latest/help/data/geodatabases/overview/data-management-strategies.htm#ESRI_SECTION1_6FA2CFB5F9484FF096740D653C674B5D).
+   */
+  get moment(): Date | null | undefined;
+  set moment(value: (Date | number | string) | null | undefined);
+  /**
+   * If `true`, the response includes associations that have been deleted.
+   *
+   * @default false
+   */
+  accessor returnDeletes: boolean;
+  /**
+   * The association types to query.
+   * Junction-edge connectivity associations are used to establish a relationship between a point feature or junction object and an edge object.
+   * - `Junction-edge from connectivity`
+   * - `Junction-edge midspan connectivity`
+   * - `Junction-edge to connectivity`
+   *
+   * These association types enable connectivity to be established between nonspatial junction and edge objects and provide an additional method to model connectivity between noncoincident point features using an edge object.
+   *
+   * **Possible Values**
+   *
+   * Value | Description |
+   * ----- | ----------- |
+   * connectivity | Allows modeling the connectivity between two features that are not coincident or between spatial features and nonspatial junction and edge objects.
+   * junction-junction-connectivity | Allows modeling the connectivity between two features that are not coincident or between spatial features and nonspatial junction and edge objects.
+   * attachment | Allows the modeling of supporting structures and attachments in a network.
+   * containment | Allows a dense collection of features to be represented by a single feature.
+   * junction-edge-from-connectivity | Junction edge from connectivity.
+   * junction-edge-midspan-connectivity | Junction edge midspan connectivity.
+   * junction-edge-to-connectivity | Junction edge to connectivity.
+   *
+   * > [!WARNING]
+   * >
+   * > The "connectivity" type has been deprecated since version 4.29. Please use "junction-junction-connectivity" instead.
+   *
+   * @see [ArcGIS Pro: Connectivity associations](https://pro.arcgis.com/en/pro-app/latest/help/data/utility-network/connectivity.htm)
+   */
+  accessor types: AssociationType[];
+}

package/rest/networks/support/QueryAssociationsResult.d.ts

@@ -1,4 +1,53 @@
-import "../../../interfaces";
+import type Association from "./Association.js";
+import type { JSONSupport, JSONSupportMixinProperties } from "../../../core/JSONSupport.js";
+import type { AssociationProperties } from "./Association.js";
 
-import QueryAssociationsResult = __esri.QueryAssociationsResult;
-export default QueryAssociationsResult;
+export interface QueryAssociationsResultProperties extends JSONSupportMixinProperties {
+  /** List of [associations](https://developers.arcgis.com/javascript/latest/api-reference/esri-rest-networks-support-Association.html) returned filtered based on the input parameters in [QueryAssociationsParameters](https://developers.arcgis.com/javascript/latest/api-reference/esri-rest-networks-support-QueryAssociationsParameters.html). */
+  associations?: AssociationProperties[];
+}
+
+/**
+ * Defines the results of the [queryAssociations](https://developers.arcgis.com/javascript/latest/api-reference/esri-rest-networks-queryAssociations.html) function which takes in [QueryAssociationsParameters](https://developers.arcgis.com/javascript/latest/api-reference/esri-rest-networks-support-QueryAssociationsParameters.html) and returns an [QueryAssociationsResult](https://developers.arcgis.com/javascript/latest/api-reference/esri-rest-networks-support-QueryAssociationsResult.html) of all
+ * [associations](https://developers.arcgis.com/javascript/latest/api-reference/esri-rest-networks-support-Association.html) filtered by the parameters set.
+ *
+ * @since 4.25
+ * @see [Association](https://developers.arcgis.com/javascript/latest/api-reference/esri-rest-networks-support-Association.html)
+ * @see [AggregatedGeometry](https://developers.arcgis.com/javascript/latest/api-reference/esri-rest-networks-support-AggregatedGeometry.html)
+ * @see [queryAssociations](https://developers.arcgis.com/javascript/latest/api-reference/esri-rest-networks-queryAssociations.html)
+ * @example
+ * // Define the QueryAssociationsParameters
+ * const queryAssociationsParameters = new QueryAssociationsParameters({
+ *   types: ["containment", "attachment", "junction-edge-from-connectivity"],
+ *   elements: [
+ *     {
+ *       networkSourceId: 2,
+ *       globalId: "{46B3FA19-2237-4D38-A7CF-AA34C3T40420}",
+ *       objectId: 44,
+ *       terminalId: 1,
+ *       assetGroupCode: 1,
+ *       assetTypeCode: 1
+ *     },
+ *     {
+ *       networkSourceId: 9,
+ *       globalId: "{321C0089-1165-42D9-K45B-ED91B1A40500}",
+ *       objectId: 45,
+ *       terminalId: 1,
+ *       assetGroupCode: 13,
+ *       assetTypeCode: 441
+ *     }
+ *  ]
+ * });
+ *
+ * // Query associations, and assign the query result to a variable `associations`
+ * const associations = await queryAssociations(networkServiceUrl, queryAssociationsParameters);
+ *
+ * // Print out the first association
+ * console.log(associations[0]);
+ */
+export default class QueryAssociationsResult extends JSONSupport {
+  constructor(properties?: QueryAssociationsResultProperties);
+  /** List of [associations](https://developers.arcgis.com/javascript/latest/api-reference/esri-rest-networks-support-Association.html) returned filtered based on the input parameters in [QueryAssociationsParameters](https://developers.arcgis.com/javascript/latest/api-reference/esri-rest-networks-support-QueryAssociationsParameters.html). */
+  get associations(): Association[];
+  set associations(value: AssociationProperties[]);
+}

package/rest/networks/support/QueryNamedTraceConfigurationsParameters.d.ts

@@ -0,0 +1,14 @@
+import type { JSONSupport, JSONSupportMixinProperties } from "../../../core/JSONSupport.js";
+
+export interface QueryNamedTraceConfigurationsParametersProperties extends JSONSupportMixinProperties, Partial<Pick<QueryNamedTraceConfigurationsParameters, "creators" | "globalIds" | "names" | "tags">> {}
+
+export default abstract class QueryNamedTraceConfigurationsParameters extends JSONSupport {
+  /** An array of the named trace configuration creators to be queried. */
+  accessor creators: string[];
+  /** An array of named trace configuration globalIds (UUID) to be queried. */
+  accessor globalIds: string[];
+  /** An array of named trace configuration names to be queried. */
+  accessor names: string[];
+  /** An array of named trace configuration user tags to be queried. */
+  accessor tags: string[];
+}

package/rest/networks/support/SynthesizeAssociationGeometriesParameters.d.ts

@@ -1,4 +1,66 @@
-import "../../../interfaces";
+import type Extent from "../../../geometry/Extent.js";
+import type SpatialReference from "../../../geometry/SpatialReference.js";
+import type { JSONSupport, JSONSupportMixinProperties } from "../../../core/JSONSupport.js";
+import type { ExtentProperties } from "../../../geometry/Extent.js";
+import type { SpatialReferenceProperties } from "../../../geometry/SpatialReference.js";
 
-import SynthesizeAssociationGeometriesParameters = __esri.SynthesizeAssociationGeometriesParameters;
-export default SynthesizeAssociationGeometriesParameters;
+export interface SynthesizeAssociationGeometriesParametersProperties extends JSONSupportMixinProperties, Partial<Pick<SynthesizeAssociationGeometriesParameters, "gdbVersion" | "maxGeometryCount" | "returnAttachmentAssociations" | "returnConnectivityAssociations" | "returnContainmentAssociations">> {
+  /** The extent within which to synthesize association geometries. */
+  extent?: ExtentProperties | null;
+  /**
+   * The date/timestamp (in UTC) to execute the function. This could be used to run the function in a moment in the past or in long transaction mode (undo/redo). Applicable to branch versioned datasets only.
+   *
+   * @see [Learn more about branch versioning](https://pro.arcgis.com/en/pro-app/latest/help/data/geodatabases/overview/data-management-strategies.htm#ESRI_SECTION1_6FA2CFB5F9484FF096740D653C674B5D).
+   */
+  moment?: (Date | number | string) | null;
+  /** The spatial reference of the returned geometry. If not specified, the geometry is returned in the spatial reference of the feature service. */
+  outSpatialReference?: SpatialReferenceProperties | null;
+}
+
+/**
+ * This class describes the parameters required to execute the synthesizeAssociationGeometries function which synthesizes and returns the associations geometries in a given extent.
+ *
+ * @since 4.20
+ * @see [synthesizeAssociationGeometries](https://developers.arcgis.com/javascript/latest/api-reference/esri-rest-networks-synthesizeAssociationGeometries.html)
+ */
+export default class SynthesizeAssociationGeometriesParameters extends JSONSupport {
+  constructor(properties?: SynthesizeAssociationGeometriesParametersProperties);
+  /** The extent within which to synthesize association geometries. */
+  get extent(): Extent | null | undefined;
+  set extent(value: ExtentProperties | null | undefined);
+  /** The geodatabase version to execute the function against. Defaults to `SDE.DEFAULT`, if no version is provided. */
+  accessor gdbVersion: string | null | undefined;
+  /**
+   * A number that indicates the maximum associations that should be synthesized after which the operation should immediately return.
+   * Useful to avoid slowing down the operation in case many associations need to be rendered. When this count is exceeded, `synthesizeAssociationGeometries` will set a `MaxGeometryCountExceeded` to `true` in the result.
+   */
+  accessor maxGeometryCount: number | null | undefined;
+  /**
+   * The date/timestamp (in UTC) to execute the function. This could be used to run the function in a moment in the past or in long transaction mode (undo/redo). Applicable to branch versioned datasets only.
+   *
+   * @see [Learn more about branch versioning](https://pro.arcgis.com/en/pro-app/latest/help/data/geodatabases/overview/data-management-strategies.htm#ESRI_SECTION1_6FA2CFB5F9484FF096740D653C674B5D).
+   */
+  get moment(): Date | null | undefined;
+  set moment(value: (Date | number | string) | null | undefined);
+  /** The spatial reference of the returned geometry. If not specified, the geometry is returned in the spatial reference of the feature service. */
+  get outSpatialReference(): SpatialReference | null | undefined;
+  set outSpatialReference(value: SpatialReferenceProperties | null | undefined);
+  /**
+   * If `true`, attachment associations will be included in the results.
+   *
+   * @default false
+   */
+  accessor returnAttachmentAssociations: boolean;
+  /**
+   * If `true`, connectivity associations will be included in the results.
+   *
+   * @default false
+   */
+  accessor returnConnectivityAssociations: boolean;
+  /**
+   * Indicates whether to synthesize and return containment associations. Containment associations can be created between polygons, as a result the centroid of that polygon is used as anchor to synthesize the association geometry.
+   *
+   * @default false
+   */
+  accessor returnContainmentAssociations: boolean;
+}

package/rest/networks/support/TelecomNetworkElement.d.ts

@@ -1,4 +1,25 @@
-import "../../../interfaces";
+import type NetworkElement from "./NetworkElement.js";
+import type { NetworkElementProperties } from "./NetworkElement.js";
 
-import TelecomNetworkElement = __esri.TelecomNetworkElement;
-export default TelecomNetworkElement;
+export interface TelecomNetworkElementProperties extends NetworkElementProperties, Partial<Pick<TelecomNetworkElement, "firstUnit" | "numUnits">> {}
+
+/**
+ * TelecomNetworkElement inherits from [NetworkElement](https://developers.arcgis.com/javascript/latest/api-reference/esri-rest-networks-support-NetworkElement.html) and adds two new properties:
+ * [firstUnit](https://developers.arcgis.com/javascript/latest/api-reference/esri-rest-networks-support-TelecomNetworkElement.html#firstUnit) and [numUnits](https://developers.arcgis.com/javascript/latest/api-reference/esri-rest-networks-support-TelecomNetworkElement.html#numUnits). This class is used to represent network elements in a telecom domain network.
+ *
+ * @beta
+ * @since 4.34
+ */
+export default class TelecomNetworkElement extends NetworkElement {
+  constructor(properties?: TelecomNetworkElementProperties);
+  /** The unit offset in a grouped object in a telecom domain network. */
+  accessor firstUnit: number | null;
+  /** The number of logically grouped objects the element represents in a telecom domain network. */
+  accessor numUnits: number | null;
+  /**
+   * The type of the network element.
+   *
+   * @default "telecomNetworkElement"
+   */
+  get type(): "networkElement" | "telecomNetworkElement";
+}

package/rest/networks/support/TraceLocation.d.ts

@@ -1,4 +1,85 @@
-import "../../../interfaces";
+import type { ClonableMixin, ClonableMixinProperties } from "../../../core/Clonable.js";
+import type { JSONSupport, JSONSupportMixinProperties } from "../../../core/JSONSupport.js";
+import type { TraceLocationType } from "../../../networks/support/typeUtils.js";
 
-import TraceLocation = __esri.TraceLocation;
-export default TraceLocation;
+export interface TraceLocationProperties extends JSONSupportMixinProperties, ClonableMixinProperties, Partial<Pick<TraceLocation, "firstUnit" | "globalId" | "isFilterBarrier" | "networkSourceId" | "numUnits" | "percentAlong" | "terminalId" | "type">> {}
+
+/**
+ * To perform the trace analytic, users can optionally supply a list of locations in forms of globalIds (UUID) and terminals. These locations indicate where should the trace start (also known as starting points) and where should it end (barriers)
+ * Starting locations can be applied to all network sources.
+ *
+ * @since 4.20
+ * @see [trace](https://developers.arcgis.com/javascript/latest/api-reference/esri-rest-networks-trace.html)
+ */
+export default class TraceLocation extends TraceLocationSuperclass {
+  constructor(properties?: TraceLocationProperties);
+  /**
+   * The unit offset in a grouped object for the trace location. Used in Telecom domain networks.
+   *
+   * @beta
+   * @since 4.34
+   */
+  accessor firstUnit: number | null | undefined;
+  /** The globalId (UUID) of the feature to start or stop the trace. */
+  accessor globalId: string;
+  /**
+   * This indicates whether this barrier starting location should be skipped (filtered) when a trace attempts to find upstream controllers. Setting this to `false` will stop the trace if it encounters this barrier. When to set to `true`, the trace will momenterily skip the barrier to find any upstream controllers and will filter out the output accordingly. Applicable subnetwork-based trace types only.
+   *
+   * @default false
+   */
+  accessor isFilterBarrier: boolean;
+  /**
+   * The ID of the network source the trace location belongs to.
+   * This is returned when a circuit trace returns a path with start and stop locations.
+   *
+   * @beta
+   */
+  accessor networkSourceId: number | null | undefined;
+  /**
+   * The number of logically grouped objects for the trace location. Used in Telecom domain networks.
+   *
+   * @beta
+   * @since 4.34
+   */
+  accessor numUnits: number | null | undefined;
+  /**
+   * This double parameter of value of 0-1 indicates a percentage along the line of where the trace location is placed. Applicable to line features only.
+   *
+   * @example
+   * Line feature with objectId 100 with 2 midspan junctions (j1,j2). The line feature has 3 edge network elements
+   * F-j1, j1-j2 and j2-T.
+   *
+   *                                        OID=100
+   *                                F------j1------j2------T
+   *
+   * F-j1  (objectId=100, positionFrom=0, positionTo=0.33)
+   * j1-j2 (objectId=100, positionFrom=0.33, positionTo=0.66)
+   * j2-T  (objectId=100, positionFrom=0.66, positionTo=1)
+   *
+   * When percentAlong is 0.5 (50%) the starting location will be placed on the middle edge (j1-j2)
+   *
+   *                                        OID=100
+   *                                F------j1---x--j2------T
+   *
+   * When percentAlong is 0.1 (10%) the starting location will be placed on the first edge (F-j1)
+   *
+   *                                        OID=100
+   *                                F-x----j1------j2------T
+   */
+  accessor percentAlong: number;
+  /**
+   * The terminal Id to place the starting location at. Applicable for junction/device sources only. Users can use `getTerminalConfiguration()` in [UtilityNetwork](https://developers.arcgis.com/javascript/latest/api-reference/esri-networks-UtilityNetwork.html) to get the terminal.
+   *
+   * @see [Terminal](https://developers.arcgis.com/javascript/latest/api-reference/esri-networks-support-Terminal.html)
+   */
+  accessor terminalId: number;
+  /**
+   * The type of the trace location; `starting-point` defines where the trace should start and `barrier` defines where the trace should stop.
+   *
+   * > [!WARNING]
+   * >
+   * > The `stopping-point` type is reserved for future use.
+   */
+  accessor type: TraceLocationType;
+}
+declare const TraceLocationSuperclass: typeof JSONSupport & typeof ClonableMixin

package/rest/networks/support/TraceParameters.d.ts

@@ -1,4 +1,70 @@
-import "../../../interfaces";
+import type SpatialReference from "../../../geometry/SpatialReference.js";
+import type UNTraceConfiguration from "../../../networks/support/UNTraceConfiguration.js";
+import type TraceLocation from "./TraceLocation.js";
+import type { JSONSupport, JSONSupportMixinProperties } from "../../../core/JSONSupport.js";
+import type { ResultType } from "../../../networks/support/jsonTypes.js";
+import type { TraceType } from "../../../networks/support/typeUtils.js";
+import type { TraceLocationProperties } from "./TraceLocation.js";
+import type { SpatialReferenceProperties } from "../../../geometry/SpatialReference.js";
+import type { UNTraceConfigurationProperties } from "../../../networks/support/UNTraceConfiguration.js";
 
-import TraceParameters = __esri.TraceParameters;
-export default TraceParameters;
+export interface TraceParametersProperties extends JSONSupportMixinProperties, Partial<Pick<TraceParameters, "gdbVersion" | "namedTraceConfigurationGlobalId" | "resultTypes" | "traceType">> {
+  /**
+   * The date/timestamp (in UTC) to execute the function at a given time. This could be used to run the function in a moment in the past or in long transaction mode (undo/redo). Applicable to branch versioned datasets only.
+   *
+   * @see [Learn more about branch versioning](https://pro.arcgis.com/en/pro-app/latest/help/data/geodatabases/overview/data-management-strategies.htm#ESRI_SECTION1_6FA2CFB5F9484FF096740D653C674B5D)
+   */
+  moment?: (Date | number | string) | null;
+  /** The spatial reference that should be used to project the [aggregated geometries](https://developers.arcgis.com/javascript/latest/api-reference/esri-rest-networks-support-AggregatedGeometry.html) returned by the trace (if applicable). */
+  outSpatialReference?: SpatialReferenceProperties | null;
+  /** Defines the properties of a trace. */
+  traceConfiguration?: UNTraceConfigurationProperties | null;
+  /**
+   * The list of starting points and barriers that will define where the trace starts and stops.
+   * This parameter can be optional (defaults to empty array) if [NamedTraceConfiguration#minStartingPoints](https://developers.arcgis.com/javascript/latest/api-reference/esri-networks-support-NamedTraceConfiguration.html#minStartingPoints) in `NamedTraceConfiguration` is set to `none`.
+   */
+  traceLocations?: TraceLocationProperties[];
+}
+
+/**
+ * The list of parameters that are needed to determine how the trace analytic will be executed. This includes trace locations, type, trace configurations, result types, output, and many other parameters.
+ *
+ * @since 4.20
+ * @see [trace](https://developers.arcgis.com/javascript/latest/api-reference/esri-rest-networks-trace.html)
+ */
+export default class TraceParameters extends JSONSupport {
+  constructor(properties?: TraceParametersProperties);
+  /** The geodatabase version to execute the function against. Defaults to `SDE.DEFAULT` when no version is provided. */
+  accessor gdbVersion: string | null | undefined;
+  /**
+   * The date/timestamp (in UTC) to execute the function at a given time. This could be used to run the function in a moment in the past or in long transaction mode (undo/redo). Applicable to branch versioned datasets only.
+   *
+   * @see [Learn more about branch versioning](https://pro.arcgis.com/en/pro-app/latest/help/data/geodatabases/overview/data-management-strategies.htm#ESRI_SECTION1_6FA2CFB5F9484FF096740D653C674B5D)
+   */
+  get moment(): Date | null | undefined;
+  set moment(value: (Date | number | string) | null | undefined);
+  /** The globalId (UUID) of the named trace configuration persisted in the network. */
+  accessor namedTraceConfigurationGlobalId: string | null | undefined;
+  /** The spatial reference that should be used to project the [aggregated geometries](https://developers.arcgis.com/javascript/latest/api-reference/esri-rest-networks-support-AggregatedGeometry.html) returned by the trace (if applicable). */
+  get outSpatialReference(): SpatialReference | null | undefined;
+  set outSpatialReference(value: SpatialReferenceProperties | null | undefined);
+  /** Parameter specifying the types of results to return after running a trace. */
+  accessor resultTypes: ResultType[] | null | undefined;
+  /** Defines the properties of a trace. */
+  get traceConfiguration(): UNTraceConfiguration | null | undefined;
+  set traceConfiguration(value: UNTraceConfigurationProperties | null | undefined);
+  /**
+   * The list of starting points and barriers that will define where the trace starts and stops.
+   * This parameter can be optional (defaults to empty array) if [NamedTraceConfiguration#minStartingPoints](https://developers.arcgis.com/javascript/latest/api-reference/esri-networks-support-NamedTraceConfiguration.html#minStartingPoints) in `NamedTraceConfiguration` is set to `none`.
+   */
+  get traceLocations(): TraceLocation[];
+  set traceLocations(value: TraceLocationProperties[]);
+  /**
+   * The [traceType](https://developers.arcgis.com/javascript/latest/api-reference/esri-rest-networks-support-TraceParameters.html#traceType) defined in this trace configuration.
+   *
+   * > [!WARNING]
+   * >
+   * > The `path` and `circuit` types are reserved for future use.
+   */
+  accessor traceType: TraceType | null | undefined;
+}

package/rest/networks/support/TraceResult.d.ts

@@ -1,4 +1,67 @@
-import "../../../interfaces";
+import type CircuitPath from "../../../networks/support/CircuitPath.js";
+import type CircuitTraceResult from "../circuits/support/CircuitTraceResult.js";
+import type AggregatedGeometry from "./AggregatedGeometry.js";
+import type FunctionResult from "./FunctionResult.js";
+import type NetworkElement from "./NetworkElement.js";
+import type { JSONSupport, JSONSupportMixinProperties } from "../../../core/JSONSupport.js";
 
-import TraceResult = __esri.TraceResult;
-export default TraceResult;
+export interface TraceResultProperties extends JSONSupportMixinProperties {}
+
+/**
+ * This class defines the collection of results returned from the trace function. The trace can return [network elements](https://developers.arcgis.com/javascript/latest/api-reference/esri-rest-networks-support-NetworkElement.html), [aggregated geometries](https://developers.arcgis.com/javascript/latest/api-reference/esri-rest-networks-support-AggregatedGeometry.html),
+ * and [functions](https://developers.arcgis.com/javascript/latest/api-reference/esri-rest-networks-support-FunctionResult.html).
+ *
+ * @since 4.20
+ * @see [trace](https://developers.arcgis.com/javascript/latest/api-reference/esri-rest-networks-trace.html)
+ */
+export default class TraceResult extends JSONSupport {
+  constructor(properties?: TraceResultProperties);
+  /**
+   * This property defines an aggregation of geometries returned by the trace. The aggregated geometries will only include geometries that belong to features with `assetgroups/assettypes` specified in the trace output.
+   * This is returned only if the aggregated geometries results type is defined in the trace configuration.
+   */
+  get aggregatedGeometry(): AggregatedGeometry | null | undefined;
+  /**
+   * An array of circuits returned by the trace. Used in the telecom domain network.
+   * This is returned only if the "circuits" result type is defined in the trace configuration.
+   *
+   * @beta
+   * @since 4.34
+   */
+  get circuits(): CircuitTraceResult[] | null | undefined;
+  /**
+   * An array of network elements returned by the trace. The network element is a representation of how the network topology defines its graph.
+   * This is returned only if the elements results type is defined in the trace configuration.
+   * > [!WARNING]
+   * >
+   * > The elements property returning a [TelecomNetworkElement](https://developers.arcgis.com/javascript/latest/api-reference/esri-rest-networks-support-TelecomNetworkElement.html) is in beta and is reserved for
+   * > future use in a telecom domain network.
+   *
+   * @see [NetworkElement](https://developers.arcgis.com/javascript/latest/api-reference/esri-rest-networks-support-NetworkElement.html)
+   * @see [TelecomNetworkElement](https://developers.arcgis.com/javascript/latest/api-reference/esri-rest-networks-support-TelecomNetworkElement.html)
+   */
+  get elements(): NetworkElement[];
+  /** Returns an array of function aggregation results. */
+  get globalFunctionResults(): FunctionResult[];
+  /**
+   * This parameter is specific to the K-Nearest Neighbors Algorithm, when the nearest filter is provided in the trace configuration. It returns `true` if any neighbors were found.
+   *
+   * @default false
+   */
+  get kFeaturesForKNNFound(): boolean;
+  /**
+   * The paths returned by a path trace.
+   *
+   * @beta
+   * @since 4.34
+   */
+  get paths(): CircuitPath[] | null | undefined;
+  /**
+   * Returns `true` if the starting points in the network trace operation are ignored.
+   *
+   * @default false
+   */
+  get startingPointsIgnored(): boolean;
+  /** Returns any warnings encountered by the trace operation. */
+  get warnings(): string[] | null | undefined;
+}