@arcgis/core 5.2.0-next.160 → 5.2.0-next.161

package/chunks/RibbonLine.glsl.js

@@ -9,7 +9,7 @@ import{sliceDraw as e}from"../views/3d/webgl-engine/core/shaderLibrary/Slice.gls
       }
     `),N.code.add(S`void outputObjectAndLayerIdColor() {
 fragColor = objectAndLayerIdColorVarying;
-}`)):(M.code.add(S`void forwardObjectAndLayerIdColor() {}`),N.code.add(S`void outputObjectAndLayerIdColor() {}`));let $=P&&!F;if($&&k.include(a,O),_(M,O),F&&(G||z)){let e=G?`groundMetersToScreenRatio`:`planarDistanceToScreenRatio`;M.uniforms.add(new b(e,e=>1/(e.screenToPlanarDistanceRatio*(G?e.planarDistanceToGroundRatio:1))))}return G&&!F&&M.uniforms.add(l,u),M.uniforms.add(d,f,p,new x(`miterLimit`,e=>e.join===`miter`?e.miterLimit:0)),M.constants.add(`LARGE_HALF_FLOAT`,`float`,65500),M.constants.add(`EPS`,`float`,.001),M.constants.add(`NUM_JOIN_SUBDIVISIONS`,`float`,O.numJoinSubdivisions),A.add(`textureElementIndex`,`uint`),A.add(`lineParameters`,`vec2`),j.add(`vColor`,`vec4`),j.add(`vpos`,`vec3`,{invariant:!0}),j.add(`vLineDistance`,`float`),j.add(`vLineWidth`,`float`),z||(j.add(`vIsInsideJoin`,`int`),j.add(`vStretchFactor`,`float`),j.add(`vJoinCenterLineSDFs`,`vec2`),j.add(`vSubdivisionFactor`,`float`)),z&&j.add(`vLineSizeInv`,`float`),Y&&j.add(`vLineDistanceNorm`,`float`),q&&(j.add(`vSegmentSDF`,`float`),j.add(`vReverseSegmentSDF`,`float`)),M.code.add(S`vec3 perpendicular(vec3 v) {
+}`)):(M.code.add(S`void forwardObjectAndLayerIdColor() {}`),N.code.add(S`void outputObjectAndLayerIdColor() {}`));let $=P&&!F;if($&&k.include(a,O),_(M,O),F&&(G||z)){let e=G?`groundMetersToScreenRatio`:`planarDistanceToScreenRatio`;M.uniforms.add(new b(e,e=>1/(e.screenToPlanarDistanceRatio*(G?e.planarDistanceToGroundRatio:1))))}return G&&!F&&M.uniforms.add(l,u),M.uniforms.add(d,f,p,new x(`miterLimit`,e=>e.join===`miter`?e.miterLimit:0)),M.constants.add(`LARGE_HALF_FLOAT`,`float`,65500),M.constants.add(`EPS`,`float`,.001),M.constants.add(`NUM_JOIN_SUBDIVISIONS`,`float`,O.numJoinSubdivisions),A.add(`textureElementIndex`,`uint`),A.add(`lineParameters`,`vec2`),j.add(`vColor`,`vec4`),j.add(`vpos`,`vec3`,{invariant:!0}),j.add(`vLineDistance`,`float`),j.add(`vLineWidth`,`float`),j.add(`vIsInsideJoin`,`int`),j.add(`vStretchFactor`,`float`),j.add(`vJoinCenterLineSDFs`,`vec2`),j.add(`vSubdivisionFactor`,`float`),z&&j.add(`vLineSizeInv`,`float`),Y&&j.add(`vLineDistanceNorm`,`float`),q&&(j.add(`vSegmentSDF`,`float`),j.add(`vReverseSegmentSDF`,`float`)),M.code.add(S`vec3 perpendicular(vec3 v) {
 return vec3(v.y, -v.x, 0.0);
 }
 float nearPlaneInterpolationFactor(float nearPlaneDistance, vec4 start, vec4 end) {
@@ -75,7 +75,7 @@ return posNdc;
         }
       }
     }
-  `),v(M),M.constants.add(`aaWidth`,`float`,+!z),M.main.add(S`
+  `),v(M),M.constants.add(`aaWidth`,`float`,1),N.constants.add(`aaWidth`,`float`,1),M.main.add(S`
     vec3 position = ${Q.getTextureAttribute(`position`)};
     float u0 = ${Q.getTextureAttribute(`u0`)};
     ${C(G,S`
@@ -95,8 +95,6 @@ return posNdc;
     vec3 prevPosition = ${Q.getTextureAttribute(`position`,-1)};
     vec3 nextPosition = ${Q.getTextureAttribute(`position`,1)};
 
-    float coverage = 1.0;
-
     // Check for special value of lineParameters.y which is used by the Renderer when graphics are removed before the
     // VBO is recompacted. If this is the case, then we just project outside of clip space.
     if (lineParameters.y == 0.0) {
@@ -157,39 +155,37 @@ pos.xyz += normalize(other.xyz - pos.xyz) * getWorldMarkerSize(pos.xyz) * 0.5;
           }
         }
 
-        ${C(!z,S`
-            // Compute stretch compensation for feathering.
-            if (subdivisionFactor > 0.0) {
-              vIsInsideJoin = 1;
-            }
-            vSubdivisionFactor = isOutside ? subdivisionFactor : 0.5;
-
-            if (miterDisplacementLen > miterLimit * lineWidth) {
-              vec2 leftScreenDir = left.xy;
-              vec2 rightScreenDir = right.xy;
-              float leftScreenLen = length(leftScreenDir);
-              float rightScreenLen = length(rightScreenDir);
-
-              if (leftScreenLen > EPS && rightScreenLen > EPS) {
-                leftScreenDir /= leftScreenLen;
-                rightScreenDir /= rightScreenLen;
-
-                /**
-                 * Feathering AA needs special considerations on join triangles because these can get stretched a lot at acute angles.
-                 * We use the triangle height to determine by how much they get stretched.
-                 */
-                float theta = acos(clamp(dot(leftScreenDir, rightScreenDir), -1.0, 1.0));
-                /**
-                 * The argument of cos here is half the angle of a join triangle.
-                 * We start with one triangle, and every subdivision adds another triangle.
-                 */
-                float subdividedTriangleHeight = (innerDisplacementLen + lineWidth) * cos(theta / (2.0 + 2.0 * NUM_JOIN_SUBDIVISIONS));
-                float bevelTriangleHeight = innerDisplacementLen + lineWidth * cos(theta * 0.5);
-                float triangleHeight = NUM_JOIN_SUBDIVISIONS > 0.0 ? subdividedTriangleHeight : bevelTriangleHeight;
-                vStretchFactor = noPerspectiveWrite(max(triangleHeight / (2.0 * lineWidth), 1.0), perspectiveDivisor);
-              }
-            }
-          `)}
+        // Compute stretch compensation for feathering.
+        if (subdivisionFactor > 0.0) {
+          vIsInsideJoin = 1;
+        }
+        vSubdivisionFactor = isOutside ? subdivisionFactor : 0.5;
+
+        if (miterDisplacementLen > miterLimit * lineWidth) {
+          vec2 leftScreenDir = left.xy;
+          vec2 rightScreenDir = right.xy;
+          float leftScreenLen = length(leftScreenDir);
+          float rightScreenLen = length(rightScreenDir);
+
+          if (leftScreenLen > EPS && rightScreenLen > EPS) {
+            leftScreenDir /= leftScreenLen;
+            rightScreenDir /= rightScreenLen;
+
+            /**
+             * Feathering AA needs special considerations on join triangles because these can get stretched a lot at acute angles.
+             * We use the triangle height to determine by how much they get stretched.
+             */
+            float theta = acos(clamp(dot(leftScreenDir, rightScreenDir), -1.0, 1.0));
+            /**
+             * The argument of cos here is half the angle of a join triangle.
+             * We start with one triangle, and every subdivision adds another triangle.
+             */
+            float subdividedTriangleHeight = (innerDisplacementLen + lineWidth) * cos(theta / (2.0 + 2.0 * NUM_JOIN_SUBDIVISIONS));
+            float bevelTriangleHeight = innerDisplacementLen + lineWidth * cos(theta * 0.5);
+            float triangleHeight = NUM_JOIN_SUBDIVISIONS > 0.0 ? subdividedTriangleHeight : bevelTriangleHeight;
+            vStretchFactor = noPerspectiveWrite(max(triangleHeight / (2.0 * lineWidth), 1.0), perspectiveDivisor);
+          }
+        }
 
         if (isOutside && displacementLen > miterLimit * lineWidth) {
           ${C(O.roundJoins,S`
@@ -244,37 +240,23 @@ pos.xyz += normalize(other.xyz - pos.xyz) * getWorldMarkerSize(pos.xyz) * 0.5;
               float metersPerScreenPixel = max(-clippedPos.z, nearFar[0]) * metersPerRenderUnit * screenPixelSizePerDistance;
               float lineSizeScreen = lineSize / metersPerScreenPixel;
             `)}
-          if (lineSizeScreen < 1.0) {
-            coverage = lineSizeScreen;
-            lineSizeScreen = 1.0;
-          }
-
-          lineSizeScreen += aaWidth;
-          float lineWidth = lineSizeScreen * pixelRatio;
+          float lineWidth = lineSizeScreen * pixelRatio + aaWidth;
         `,S`
-          if (lineSize < 1.0) {
-            coverage = lineSize; // convert sub-pixel coverage to alpha
-            lineSize = 1.0;
-          }
-
-          lineSize += aaWidth;
-          float lineWidth = lineSize * pixelRatio;
+          float lineWidth = lineSize * pixelRatio + aaWidth;
         `)}
 
       vLineWidth = noPerspectiveWrite(lineWidth, pos.w);
-      ${z?S`vLineSizeInv = noPerspectiveWrite(1.0 / lineSize, pos.w);`:``}
+      ${z?S`vLineSizeInv = noPerspectiveWrite(1.0 / ${G?`lineSize`:`max(lineSize, 1.0)`}, pos.w);`:``}
   `),X&&M.main.add(S`
       float isEndVertex = float(!isStartVertex);
       vec3 segmentOrigin = mix(pos.xyz, prev.xyz, isEndVertex);
       vec3 segment = mix(right, left, isEndVertex);
       ${q?S`vec3 segmentEnd = mix(next.xyz, pos.xyz, isEndVertex);`:``}
     `),M.main.add(S`
-    ${C(!z,S`
-        vIsInsideJoin = 0;
-        vStretchFactor = 1.0;
-        vSubdivisionFactor = 0.0;
-        vJoinCenterLineSDFs = vec2(LARGE_HALF_FLOAT);
-      `)}
+    vIsInsideJoin = 0;
+    vStretchFactor = 1.0;
+    vSubdivisionFactor = 0.0;
+    vJoinCenterLineSDFs = vec2(LARGE_HALF_FLOAT);
 
     vec2 displacementXY = computeJoinAndCapDisplacement(
       isJoin,
@@ -303,7 +285,7 @@ pos.xyz += normalize(other.xyz - pos.xyz) * getWorldMarkerSize(pos.xyz) * 0.5;
     ${Y?S`vLineDistanceNorm = lineDistNorm;`:``}
 
     pos.xyz += displacement;
-  `),z||M.main.add(S`if (isJoin) {
+  `),M.main.add(S`if (isJoin) {
 vec2 joinCenterToVertex = displacementXY;
 vec2 leftCenterlineDir = left.xy;
 vec2 rightCenterlineDir = right.xy;
@@ -389,7 +371,7 @@ float segmentLengthPseudoScreen = segmentLengthRender * discreteStippleDistanceT
       pos.z = pos.z * pos.w;
 
       vColor = getColor();
-      vColor.a = noPerspectiveWrite(vColor.a * coverage, pos.w);
+      vColor.a = noPerspectiveWrite(vColor.a, pos.w);
 
       ${V&&!F?`pos.z -= EPS * pos.w;`:``}
 
@@ -397,41 +379,45 @@ float segmentLengthPseudoScreen = segmentLengthRender * discreteStippleDistanceT
       vpos = (inverseProjectionMatrix * pos).xyz;
       gl_Position = pos;
       forwardObjectAndLayerIdColor();
-    }`),k.include(E,O),k.include(g),N.include(m),N.include(w),N.include(e,O),N.main.add(`discardBySlice(vpos);`),z||N.code.add(S`float lineFeatheringFactor(float lineWidth, float lineDistance) {
+    }`),k.include(E,O),k.include(g),N.include(m),N.include(w),N.include(e,O),N.main.add(`discardBySlice(vpos);`),N.code.add(S`float lineFeatheringFactor(float lineWidth, float lineDistance) {
 float stretchFactor = vIsInsideJoin == 1 ? noPerspectiveRead(vStretchFactor) : 1.0;
 float featherWidth = 2.0;
-float featherStartDistance = max(lineWidth - featherWidth / stretchFactor, 0.0);
-float straightFeatherStartDistance = max(lineWidth - featherWidth, 0.0);
+float featherStartDistance = lineWidth - featherWidth / stretchFactor;
+float straightFeatherStartDistance = lineWidth - featherWidth;
 float value = abs(lineDistance);
 float feather = (value - featherStartDistance) / (lineWidth - featherStartDistance);
 vec2 joinCenterSDFs = noPerspectiveRead(vJoinCenterLineSDFs);
 float joinCenterDistance = abs(vSubdivisionFactor > 0.5 ? joinCenterSDFs.x : joinCenterSDFs.y);
 float straightFeather = (joinCenterDistance - straightFeatherStartDistance) / (lineWidth - straightFeatherStartDistance);
 feather = vIsInsideJoin == 1 ? max(feather, straightFeather) : feather;
-return 1.0 - clamp(feather, 0.0, 1.0);
+float coverage = min(lineWidth - aaWidth, 1.0);
+return clamp(1.0 - feather, 0.0, coverage);
 }`),N.main.add(S`
     float lineWidth = noPerspectiveRead(vLineWidth);
     float lineDistance = noPerspectiveRead(vLineDistance);
     ${C(Y,S`float lineDistanceNorm = noPerspectiveRead(vLineDistanceNorm);`)}
-  `),V?N.main.add(S`vec4 albedo = vec4(1.0, 0.0, 1.0, 1.0);
-vec4 finalColor = albedo;`):(q&&N.main.add(S`float sdf = noPerspectiveRead(min(vSegmentSDF, vReverseSegmentSDF));
-vec2 fragmentPosition = vec2(min(sdf, 0.0), lineDistance);
-float fragmentRadius = length(fragmentPosition);
-float fragmentCapSDF = (fragmentRadius - lineWidth) * 0.5;
-float capCoverage = clamp(0.5 - fragmentCapSDF, 0.0, 1.0);
-if (capCoverage < alphaCutoff) {
-discard;
-}`),J?N.main.add(S`
-      vec2 stipplePosition = vec2(
-        min(getStippleCapDistance(), 0.0),
-        ${Z?S`lineDistance / lineWidth`:S`lineDistanceNorm`}
-      );
-      float stippleRadius = length(stipplePosition * lineWidth);
-      float stippleCapSDF = (stippleRadius - lineWidth) * 0.5; // Divide by 2 to transform from double pixel scale
-      float stippleCoverage = clamp(0.5 - stippleCapSDF, 0.0, 1.0);
-      float stippleAlpha = step(alphaCutoff, stippleCoverage);
-      `):N.main.add(S`float stippleAlpha = getStippleAlpha(lineWidth);`),L!==11&&N.main.add(S`discardByStippleAlpha(stippleAlpha, alphaCutoff);`),N.uniforms.add(new y(`intrinsicColor`,e=>e.color)).main.add(S`vec4 color = intrinsicColor * vColor;
+  `),J&&N.main.add(S`float nominalLineWidth = lineWidth - aaWidth;`),V?N.main.add(S`vec4 albedo = vec4(1.0, 0.0, 1.0, 1.0);
+vec4 finalColor = albedo;`):(q&&N.main.add(S`
+        float sdf = noPerspectiveRead(min(vSegmentSDF, vReverseSegmentSDF));
+        vec2 fragmentPosition = vec2(min(sdf, 0.0), lineDistance);
+
+        float fragmentRadius = length(fragmentPosition);
+        float fragmentCapSDF = (fragmentRadius - ${J?`nominalLineWidth`:`lineWidth`}) * 0.5; // Divide by 2 to transform from double pixel scale
+        float capCoverage = clamp(0.5 - fragmentCapSDF, 0.0, 1.0);
+
+        if (capCoverage < alphaCutoff) {
+          discard;
+        }
+      `),J?N.main.add(S`vec2 stipplePosition = vec2(
+min(getStippleCapDistance(), 0.0) * nominalLineWidth,
+lineDistance
+);
+float stippleRadius = length(stipplePosition);
+float stippleCapSDF = (stippleRadius - nominalLineWidth) * 0.5;
+float stippleCoverage = clamp(0.5 - stippleCapSDF, 0.0, 1.0);
+float lineCoverage = min(lineFeatheringFactor(lineWidth, lineDistance), capCoverage);
+float stippleAlpha = lineCoverage > 0.0 ? min(stippleCoverage, lineCoverage) / lineCoverage : 0.0;`):N.main.add(S`float stippleAlpha = getStippleAlpha(lineWidth);`),L!==11&&N.main.add(S`discardByStippleAlpha(stippleAlpha, alphaCutoff);`),N.uniforms.add(new y(`intrinsicColor`,e=>e.color)).main.add(S`vec4 color = intrinsicColor * vColor;
 color.a = noPerspectiveRead(color.a);`),H&&N.uniforms.add(new y(`innerColor`,e=>e.innerColor??e.color),new x(`innerWidth`,(e,t)=>e.innerWidth*t.camera.pixelRatio)).main.add(S`float distToInner = abs(lineDistance) - innerWidth;
 float innerAA = clamp(0.5 - distToInner, 0.0, 1.0);
 float innerAlpha = innerColor.a + color.a * (1.0 - innerColor.a);
-color = mix(color, vec4(innerColor.rgb, innerAlpha), innerAA);`),N.main.add(`vec4 albedo = blendStipple(color, stippleAlpha);`),B&&(N.uniforms.add(new x(`falloff`,e=>e.falloff)),N.main.add(S`albedo.a *= pow(max(0.0, 1.0 - abs(lineDistanceNorm)), falloff);`)),z||N.main.add(S`albedo.a *= lineFeatheringFactor(lineWidth, lineDistance);`),U&&(M.main.add(`vec4 animatedAlphaTimeStamps = ${Q.getTextureAttribute(`timeStamps`)};`),k.include(T,O),N.main.add(`albedo.a *= animatedAlpha();`)),I?(j.add(`vnormal`,`vec3`),M.include(o,O),M.main.add(`vnormal = getLocalUp(vpos, localOrigin);`),k.include(n,O),N.main.add(`vec4 finalColor = evaluateSceneLightingFragment(vpos, vnormal, albedo);`)):N.main.add(`vec4 finalColor = albedo;`)),N.main.add(S`outputColorHighlightOLID(applySlice(finalColor, vpos), albedo.rgb);`),k}const A=Object.freeze(Object.defineProperty({__proto__:null,build:k,numRoundJoinSubdivisions:1},Symbol.toStringTag,{value:`Module`}));export{A as R,k as b,O as n};
+color = mix(color, vec4(innerColor.rgb, innerAlpha), innerAA);`),N.main.add(`vec4 albedo = blendStipple(color, stippleAlpha);`),B&&(N.uniforms.add(new x(`falloff`,e=>e.falloff)),N.main.add(S`albedo.a *= pow(max(0.0, 1.0 - abs(lineDistanceNorm)), falloff);`)),N.main.add(S`albedo.a *= ${J?`lineCoverage`:`lineFeatheringFactor(lineWidth, lineDistance)`};`),U&&(M.main.add(`vec4 animatedAlphaTimeStamps = ${Q.getTextureAttribute(`timeStamps`)};`),k.include(T,O),N.main.add(`albedo.a *= animatedAlpha();`)),I?(j.add(`vnormal`,`vec3`),M.include(o,O),M.main.add(`vnormal = getLocalUp(vpos, localOrigin);`),k.include(n,O),N.main.add(`vec4 finalColor = evaluateSceneLightingFragment(vpos, vnormal, albedo);`)):N.main.add(`vec4 finalColor = albedo;`)),N.main.add(S`outputColorHighlightOLID(applySlice(finalColor, vpos), albedo.rgb);`),k}const A=Object.freeze(Object.defineProperty({__proto__:null,build:k,numRoundJoinSubdivisions:1},Symbol.toStringTag,{value:`Module`}));export{A as R,k as b,O as n};

package/config.d.ts

@@ -236,35 +236,26 @@ export interface Config {
    * An object with properties that control various aspects of [the workers framework](https://developers.arcgis.com/javascript/latest/references/core/core/workers/).
    *
    * @example
-   * // Set the path for the worker's AMD loader configuration
-   * // to a folder called workersFolder.
-   * config.workers.loaderConfig = {
-   *  paths: {
-   *    myWorkers: new URL("./workersFolder", document.baseURI).href
-   *  }
-   * };
-   *
-   * // load myWorkers/Calculator.js in the workers framework
-   * // and invoke its "getMaxNumber" method
-   * workers.open(this, "myWorkers/Calculator")
-   *   .then((connection) => {
-   *     return connection.invoke("getMaxNumber", [0, 1, 2, 3, 4]);
-   *   })
-   *   .then((result) => {
-   *     console.log(result);
-   *   });
+   * // Load an ESM worker module and invoke its "getMaxNumber" function.
+   *
+   * const connection = await workers.open(new URL("./workersFolder/Calculator.js", import.meta.url).href, {
+   *   isESM: true
+   * });
+   *
+   * try {
+   *   // Invoke the worker function and receive its result on the main thread.
+   *   const result = await connection.invoke("getMaxNumber", [0, 1, 2, 3, 4]);
+   *   console.log(result);
+   * } finally {
+   *   connection.close();
+   * }
    *
    * //*********************************************************
-   * // module: workerFolder/Calculator.js
+   * // module: workersFolder/Calculator.js
    * //*********************************************************
-   * define([], () => {
-   *   return {
-   *     // this function can be invoked from the main thread
-   *     getMaxNumber: function (number) {
-   *       return Math.max.apply(null, numbers);
-   *     }
-   *   };
-   * });
+   * export function getMaxNumber(numbers) {
+   *   return Math.max(...numbers);
+   * }
    */
   workers: WorkersConfig;
 }
@@ -294,27 +285,64 @@ export interface ApiKeysScopeConfig {
 }
 
 export interface WorkersConfig {
-  /** The absolute url to the AMD or SystemJS loader used in the worker. The AMD CDN build has a default value for when this property isn't set. This is required when using custom workers. See this [ESM sample](https://github.com/Esri/jsapi-resources/tree/main/templates/geometry-operator-worker). */
+  /**
+   * The absolute URL to the AMD or SystemJS loader used in the worker. The AMD CDN build has a default value for when this property isn't set. This is required when using custom workers.
+   *
+   * @deprecated since version 5.2. AMD/SystemJS worker loading is deprecated. Use ESM worker modules with [workers.open()](https://developers.arcgis.com/javascript/latest/references/core/core/workers/#open) instead. See this [ESM sample](https://github.com/Esri/jsapi-resources/tree/main/templates/geometry-operator-worker).
+   */
   loaderUrl?: string;
   /**
    * This is used by the `@arcgis/core` npm package to control where to load a custom build of the `RemoteClient` from.
-   * By default, `RemoteClient` is loaded from the API's [assets](https://developers.arcgis.com/javascript/latest/working-with-assets/). See this [ESM sample](https://github.com/Esri/jsapi-resources/tree/main/templates/geometry-operator-worker).
+   * By default, `RemoteClient` is loaded from the API's [assets](https://developers.arcgis.com/javascript/latest/working-with-assets/).
+   *
+   * `RemoteClient` is the SDK’s internal worker-side runtime. It loads and instantiates the worker module, then manages communication with the main thread through the worker connection.
+   *
+   * @deprecated since version 5.2. Custom worker runtime paths are deprecated. Use the default worker runtime with ESM worker modules opened via [workers.open()](https://developers.arcgis.com/javascript/latest/references/core/core/workers/#open).
    */
   workerPath?: string;
-  /** The AMD configuration object that is set in each worker. */
+  /**
+   * The AMD configuration object that is set in each worker.
+   *
+   * @deprecated since version 5.2. AMD/SystemJS worker loading is deprecated. Use ESM worker modules with [workers.open()](https://developers.arcgis.com/javascript/latest/references/core/core/workers/#open) instead.
+   */
   loaderConfig?: WorkersLoaderConfig;
 }
 
+/**
+ * Configuration for the legacy AMD worker loader.
+ *
+ * @deprecated since version 5.2. AMD/SystemJS worker loading is deprecated. Use ESM worker modules with [workers.open()](https://developers.arcgis.com/javascript/latest/references/core/core/workers/#open) instead.
+ */
 export interface WorkersLoaderConfig {
-  /** The AMD loader loads all code relative to the baseUrl. */
+  /**
+   * The AMD loader loads all code relative to the baseUrl.
+   *
+   * @deprecated since version 5.2. AMD/SystemJS worker loading is deprecated. Use ESM worker modules with [workers.open()](https://developers.arcgis.com/javascript/latest/references/core/core/workers/#open) instead.
+   */
   baseUrl?: string;
-  /** Determines if the specified feature capabilities are supported. */
+  /**
+   * Determines if the specified feature capabilities are supported.
+   *
+   * @deprecated since version 5.2. AMD/SystemJS worker loading is deprecated. Use ESM worker modules with [workers.open()](https://developers.arcgis.com/javascript/latest/references/core/core/workers/#open) instead.
+   */
   has?: Record<string, any>;
-  /** Map paths in module identifiers to different paths. */
+  /**
+   * Map paths in module identifiers to different paths.
+   *
+   * @deprecated since version 5.2. AMD/SystemJS worker loading is deprecated. Use ESM worker modules with [workers.open()](https://developers.arcgis.com/javascript/latest/references/core/core/workers/#open) instead.
+   */
   map?: Record<string, Record<string, string>>;
-  /** An array of objects which provide the package name and its location. */
+  /**
+   * An array of objects which provide the package name and its location.
+   *
+   * @deprecated since version 5.2. AMD/SystemJS worker loading is deprecated. Use ESM worker modules with [workers.open()](https://developers.arcgis.com/javascript/latest/references/core/core/workers/#open) instead.
+   */
   packages?: object[];
-  /** Map of module id fragments to file paths. */
+  /**
+   * Map of module id fragments to file paths.
+   *
+   * @deprecated since version 5.2. AMD/SystemJS worker loading is deprecated. Use ESM worker modules with [workers.open()](https://developers.arcgis.com/javascript/latest/references/core/core/workers/#open) instead.
+   */
   paths?: Record<string, string>;
 }
 

package/config.js

@@ -1,2 +1,2 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import"./core/has.js";import{deepMerge as e}from"./core/object.js";const t={apiKey:void 0,apiKeys:{scopes:[]},applicationName:``,applicationUrl:globalThis.location?.href,assetsPath:``,fontsUrl:`https://static.arcgis.com/fonts`,geometryServiceUrl:`https://utility.arcgisonline.com/arcgis/rest/services/Geometry/GeometryServer`,geoRSSServiceUrl:`https://utility.arcgis.com/sharing/rss`,kmlServiceUrl:`https://utility.arcgis.com/sharing/kml`,userPrivilegesApplied:!0,portalUrl:`https://www.arcgis.com`,respectPrefersReducedMotion:!0,routeServiceUrl:`https://route-api.arcgis.com/arcgis/rest/services/World/Route/NAServer/Route_World`,workers:{loaderConfig:{has:{},paths:{},map:{},packages:[]}},request:{crossOriginNoCorsDomains:null,httpsDomains:[`arcgis.com`,`arcgisonline.com`,`esrikr.com`,`premiumservices.blackbridge.com`,`esripremium.accuweather.com`,`gbm.digitalglobe.com`,`firstlook.digitalglobe.com`,`msi.digitalglobe.com`],interceptors:[],internalInterceptors:[],maxUrlLength:2e3,priority:`high`,proxyRules:[],proxyUrl:null,timeout:62e3,trustedServers:[],useIdentity:!0},log:{interceptors:[],level:null}};globalThis.esriConfig&&(e(t,globalThis.esriConfig,!0),delete t.has),!t.assetsPath&&(t.assetsPath=`https://cdn.jsdelivr.net/npm/@arcgis/core@5.2.0-next.160/assets`,t.defaultAssetsPath=t.assetsPath);export{t as default};
+import"./core/has.js";import{deepMerge as e}from"./core/object.js";const t={apiKey:void 0,apiKeys:{scopes:[]},applicationName:``,applicationUrl:globalThis.location?.href,assetsPath:``,fontsUrl:`https://static.arcgis.com/fonts`,geometryServiceUrl:`https://utility.arcgisonline.com/arcgis/rest/services/Geometry/GeometryServer`,geoRSSServiceUrl:`https://utility.arcgis.com/sharing/rss`,kmlServiceUrl:`https://utility.arcgis.com/sharing/kml`,userPrivilegesApplied:!0,portalUrl:`https://www.arcgis.com`,respectPrefersReducedMotion:!0,routeServiceUrl:`https://route-api.arcgis.com/arcgis/rest/services/World/Route/NAServer/Route_World`,workers:{loaderConfig:{has:{},paths:{},map:{},packages:[]}},request:{crossOriginNoCorsDomains:null,httpsDomains:[`arcgis.com`,`arcgisonline.com`,`esrikr.com`,`premiumservices.blackbridge.com`,`esripremium.accuweather.com`,`gbm.digitalglobe.com`,`firstlook.digitalglobe.com`,`msi.digitalglobe.com`],interceptors:[],internalInterceptors:[],maxUrlLength:2e3,priority:`high`,proxyRules:[],proxyUrl:null,timeout:62e3,trustedServers:[],useIdentity:!0},log:{interceptors:[],level:null}};globalThis.esriConfig&&(e(t,globalThis.esriConfig,!0),delete t.has),!t.assetsPath&&(t.assetsPath=`https://cdn.jsdelivr.net/npm/@arcgis/core@5.2.0-next.161/assets`,t.defaultAssetsPath=t.assetsPath);export{t as default};

package/core/has.js

@@ -1,2 +1,2 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-const e=globalThis,t={...e.esriConfig?.has};function has(n){return typeof t[n]==`function`?t[n]=t[n](e):t[n]}has.add=(e,n,r,i)=>{(i||t[e]===void 0)&&(t[e]=n),r&&has(e)},has.cache=t,has.add(`big-integer-warning-enabled`,!0),has.add(`esri-deprecation-warnings`,!0),has.add(`esri-tests-disable-screenshots`,!1),has.add(`esri-tests-use-full-window`,!1),has.add(`esri-tests-post-to-influx`,!0),has.add(`esri-cim-animations-enable-status`,`enabled`),has.add(`esri-cim-animations-spotlight`,!1),has.add(`esri-cim-animations-freeze-time`,!1),(()=>{has.add(`host-webworker`,e.WorkerGlobalScope!==void 0&&self instanceof e.WorkerGlobalScope);let t=typeof window<`u`&&typeof location<`u`&&typeof document<`u`&&window.location===location&&window.document===document;if(has.add(`host-browser`,t),has.add(`host-node`,!!(typeof e.process==`object`&&e.process.versions?.node&&e.process.versions.v8)),has.add(`dom`,t),has(`host-browser`)){let e=navigator,t=e.userAgent,n=e.appVersion,r=parseFloat(n);if(has.add(`wp`,parseFloat(t.split(`Windows Phone`)[1])||void 0),has.add(`msapp`,parseFloat(t.split(`MSAppHost/`)[1])||void 0),has.add(`khtml`,n.includes(`Konqueror`)?r:void 0),has.add(`edge`,parseFloat(t.split(`Edge/`)[1])||void 0),has.add(`opr`,parseFloat(t.split(`OPR/`)[1])||void 0),has.add(`webkit`,!has(`wp`)&&!has(`edge`)&&parseFloat(t.split(`WebKit/`)[1])||void 0),has.add(`chrome`,!has(`edge`)&&!has(`opr`)&&parseFloat(t.split(`Chrome/`)[1])||void 0),has.add(`android`,!has(`wp`)&&parseFloat(t.split(`Android `)[1])||void 0),has.add(`safari`,n.includes(`Safari`)&&!has(`wp`)&&!has(`chrome`)&&!has(`android`)&&!has(`edge`)&&!has(`opr`)?parseFloat(n.split(`Version/`)[1]):void 0),has.add(`mac`,n.includes(`Macintosh`)),!has(`wp`)&&/(iPhone|iPod|iPad)/.test(t)){let e=RegExp.$1.replace(/P/,`p`),n=/OS ([\d_]+)/.test(t)?RegExp.$1:`1`,r=parseFloat(n.replace(/_/,`.`).replaceAll(`_`,``));has.add(e,r),has.add(`ios`,r)}has(`webkit`)||(t.includes(`Gecko`)&&!has(`wp`)&&!has(`khtml`)&&!has(`edge`)&&has.add(`mozilla`,r),has(`mozilla`)&&has.add(`ff`,parseFloat(t.split(`Firefox/`)[1]||t.split(`Minefield/`)[1])||void 0))}})(),(()=>{if(e.navigator){let e=navigator.userAgent,t=/Android|webOS|iPhone|iPad|iPod|BlackBerry|Opera Mini|IEMobile/i.test(e),n=/iPhone/i.test(e);t&&has.add(`esri-mobile`,t),n&&has.add(`esri-iPhone`,n),has.add(`esri-geolocation`,!!navigator.geolocation)}has.add(`esri-wasm`,`WebAssembly`in e),has.add(`esri-temporal`,`Temporal`in e),has.add(`esri-performance-mode-frames-between-render`,20),has.add(`esri-force-performance-mode`,!1),has.add(`esri-shared-array-buffer`,()=>{let t=`SharedArrayBuffer`in e,n=e.crossOriginIsolated===!1;return t&&!n}),has.add(`wasm-simd`,()=>WebAssembly.validate(new Uint8Array([0,97,115,109,1,0,0,0,1,5,1,96,0,1,123,3,2,1,0,10,10,1,8,0,65,0,253,15,253,98,11]))),has.add(`esri-atomics`,`Atomics`in e),has.add(`esri-workers`,`Worker`in e),has.add(`web-feat:cache`,`caches`in e),has.add(`esri-workers-arraybuffer-transfer`,!has(`safari`)||Number(has(`safari`))>=12),has.add(`min-workers-pool-size`,2),has.add(`max-workers-pool-size`,has(`esri-mobile`)?3:8),has.add(`featurelayer-simplify-thresholds`,[.5,.5,.5,.5]),has.add(`featurelayer-simplify-payload-size-factors`,[1,1,4]),has.add(`featurelayer-animation-enabled`,!0),has.add(`featurelayer-hybrid-tile-enabled`,!0),has.add(`featurelayer-snapshot-enabled`,!0),has.add(`featurelayer-snapshot-initial-tolerance`,0),has.add(`featurelayer-snapshot-point-min-threshold`,8e4),has.add(`featurelayer-snapshot-point-max-threshold`,4e5),has.add(`featurelayer-snapshot-multipoint-min-threshold`,2e4),has.add(`featurelayer-snapshot-multipoint-max-threshold`,1e5),has.add(`featurelayer-snapshot-polygon-min-threshold`,2e3),has.add(`featurelayer-snapshot-polygon-max-threshold`,2e3),has.add(`featurelayer-snapshot-polyline-min-threshold`,2e3),has.add(`featurelayer-snapshot-polyline-max-threshold`,2e3),has.add(`featurelayer-snapshot-max-vertex-count`,25e4),has.add(`featurelayer-snapshot-non-hosted-exceedslimit-enabled`,!0),has.add(`featurelayer-snapshot-concurrency`,4),has.add(`featurelayer-snapshot-allow-editable`,!1),has.add(`featurelayer-snapshot-coverage`,.1),has.add(`featurelayer-pixel-buffering-enabled`,!0),has.add(`featurelayer-query-max-depth`,4),has.add(`featurelayer-query-max-page-size`,8e3),has.add(`featurelayer-query-pausing-enabled`,!1),has.add(`featurelayer-query-tile-concurrency`,4),has.add(`featurelayer-query-tile-max-features`,6e5),has.add(`featurelayer-advanced-symbols`,!1),has.add(`featurelayer-pbf`,!0),has.add(`featurelayer-pbf-statistics`,!1),has.add(`featurelayer-pbf-true-curves`,!0),has.add(`feature-layers-workers`,!0),has.add(`feature-polyline-generalization-factor`,1),has.add(`featurelayer-relative-time-queries-enabled`,!0),has.add(`featurelayer-relative-time-queries-bin-window-public`,1),has.add(`featurelayer-relative-time-queries-bin-window-private`,60),has.add(`parquetlayer-full-query-feature-count`,5e5),has.add(`parquetlayer-persistence-enabled`,!0),has.add(`parquetlayer-cache-enabled`,!0),has.add(`parquetlayer-legacy-field-overrides-enabled`,!1),has.add(`sketch-layer-enabled`,!1),has.add(`mapview-transitions-duration`,200),has.add(`mapview-essential-goto-duration`,200),has.add(`mapview-srswitch-adjust-rotation-scale-threshold`,24e6),has.add(`mapserver-pbf-version-support`,10.81),has.add(`mapservice-popup-identify-max-tolerance`,20),has.add(`request-queue-concurrency-global`,64),has.add(`request-queue-concurrency-hosted`,16),has.add(`request-queue-concurrency-non-hosted`,16),has.add(`curve-densification-coarse-segments`,128),has.add(`curve-densification-max-segments`,2e3),has.add(`curve-densification-min-segments`,3),has.add(`curve-densification-pixel-deviation`,.5),has.add(`view-readyState-waiting-delay`,1e3),has.add(`gradient-depth-bias`,.01),has.add(`gradient-depth-epsilon`,1e-8),has.add(`enable-feature:esri-compress-textures`,!0),has.add(`enable-feature:im-shading`,!0),has.add(`enable-feature:im-vertex-normals`,!0),!has(`host-webworker`)&&has(`host-browser`)&&(has.add(`esri-csp-restrictions`,()=>{try{Function()}catch{return!0}return!1}),has.add(`esri-url-encodes-apostrophe`,()=>{let e=window.document.createElement(`a`);return e.href=`?'`,e.href.includes(`?%27`)}))})();export{has as default};
+const e=globalThis,t={...e.esriConfig?.has};function has(n){return typeof t[n]==`function`?t[n]=t[n](e):t[n]}has.add=(e,n,r,i)=>{(i||t[e]===void 0)&&(t[e]=n),r&&has(e)},has.cache=t,has.add(`big-integer-warning-enabled`,!0),has.add(`esri-deprecation-warnings`,!0),has.add(`esri-tests-disable-screenshots`,!1),has.add(`esri-tests-use-full-window`,!1),has.add(`esri-tests-post-to-influx`,!0),has.add(`esri-cim-animations-enable-status`,`enabled`),has.add(`esri-cim-animations-spotlight`,!1),has.add(`esri-cim-animations-freeze-time`,!1),(()=>{has.add(`host-webworker`,e.WorkerGlobalScope!==void 0&&self instanceof e.WorkerGlobalScope);let t=typeof window<`u`&&typeof location<`u`&&typeof document<`u`&&window.location===location&&window.document===document;if(has.add(`host-browser`,t),has.add(`host-node`,!!(typeof e.process==`object`&&e.process.versions?.node&&e.process.versions.v8)),has.add(`dom`,t),has(`host-browser`)){let e=navigator,t=e.userAgent,n=e.appVersion,r=parseFloat(n);if(has.add(`wp`,parseFloat(t.split(`Windows Phone`)[1])||void 0),has.add(`msapp`,parseFloat(t.split(`MSAppHost/`)[1])||void 0),has.add(`khtml`,n.includes(`Konqueror`)?r:void 0),has.add(`edge`,parseFloat(t.split(`Edge/`)[1])||void 0),has.add(`opr`,parseFloat(t.split(`OPR/`)[1])||void 0),has.add(`webkit`,!has(`wp`)&&!has(`edge`)&&parseFloat(t.split(`WebKit/`)[1])||void 0),has.add(`chrome`,!has(`edge`)&&!has(`opr`)&&parseFloat(t.split(`Chrome/`)[1])||void 0),has.add(`android`,!has(`wp`)&&parseFloat(t.split(`Android `)[1])||void 0),has.add(`safari`,n.includes(`Safari`)&&!has(`wp`)&&!has(`chrome`)&&!has(`android`)&&!has(`edge`)&&!has(`opr`)?parseFloat(n.split(`Version/`)[1]):void 0),has.add(`mac`,n.includes(`Macintosh`)),!has(`wp`)&&/(iPhone|iPod|iPad)/.test(t)){let e=RegExp.$1.replace(/P/,`p`),n=/OS ([\d_]+)/.test(t)?RegExp.$1:`1`,r=parseFloat(n.replace(/_/,`.`).replaceAll(`_`,``));has.add(e,r),has.add(`ios`,r)}has(`webkit`)||(t.includes(`Gecko`)&&!has(`wp`)&&!has(`khtml`)&&!has(`edge`)&&has.add(`mozilla`,r),has(`mozilla`)&&has.add(`ff`,parseFloat(t.split(`Firefox/`)[1]||t.split(`Minefield/`)[1])||void 0))}})(),(()=>{if(e.navigator){let e=navigator.userAgent,t=/Android|webOS|iPhone|iPad|iPod|BlackBerry|Opera Mini|IEMobile/i.test(e),n=/iPhone/i.test(e);t&&has.add(`esri-mobile`,t),n&&has.add(`esri-iPhone`,n),has.add(`esri-geolocation`,!!navigator.geolocation)}has.add(`esri-wasm`,`WebAssembly`in e),has.add(`esri-temporal`,`Temporal`in e),has.add(`esri-performance-mode-frames-between-render`,20),has.add(`esri-force-performance-mode`,!1),has.add(`esri-shared-array-buffer`,()=>{let t=`SharedArrayBuffer`in e,n=e.crossOriginIsolated===!1;return t&&!n}),has.add(`wasm-simd`,()=>WebAssembly.validate(new Uint8Array([0,97,115,109,1,0,0,0,1,5,1,96,0,1,123,3,2,1,0,10,10,1,8,0,65,0,253,15,253,98,11]))),has.add(`esri-atomics`,`Atomics`in e),has.add(`esri-workers`,`Worker`in e),has.add(`web-feat:cache`,`caches`in e),has.add(`esri-workers-arraybuffer-transfer`,!has(`safari`)||Number(has(`safari`))>=12),has.add(`min-workers-pool-size`,2),has.add(`max-workers-pool-size`,has(`esri-mobile`)?3:8),has.add(`featurelayer-simplify-thresholds`,[.5,.5,.5,.5]),has.add(`featurelayer-simplify-payload-size-factors`,[1,1,4]),has.add(`featurelayer-animation-enabled`,!0),has.add(`featurelayer-hybrid-tile-enabled`,!0),has.add(`featurelayer-snapshot-enabled`,!0),has.add(`featurelayer-snapshot-initial-tolerance`,0),has.add(`featurelayer-snapshot-point-min-threshold`,8e4),has.add(`featurelayer-snapshot-point-max-threshold`,4e5),has.add(`featurelayer-snapshot-multipoint-min-threshold`,2e4),has.add(`featurelayer-snapshot-multipoint-max-threshold`,1e5),has.add(`featurelayer-snapshot-polygon-min-threshold`,2e3),has.add(`featurelayer-snapshot-polygon-max-threshold`,2e3),has.add(`featurelayer-snapshot-polyline-min-threshold`,2e3),has.add(`featurelayer-snapshot-polyline-max-threshold`,2e3),has.add(`featurelayer-snapshot-max-vertex-count`,25e4),has.add(`featurelayer-snapshot-non-hosted-exceedslimit-enabled`,!0),has.add(`featurelayer-snapshot-concurrency`,4),has.add(`featurelayer-snapshot-allow-editable`,!1),has.add(`featurelayer-snapshot-coverage`,.1),has.add(`featurelayer-pixel-buffering-enabled`,!0),has.add(`featurelayer-query-max-depth`,4),has.add(`featurelayer-query-max-page-size`,8e3),has.add(`featurelayer-query-pausing-enabled`,!1),has.add(`featurelayer-query-tile-concurrency`,4),has.add(`featurelayer-query-tile-max-features`,6e5),has.add(`featurelayer-advanced-symbols`,!1),has.add(`featurelayer-pbf`,!0),has.add(`featurelayer-pbf-statistics`,!1),has.add(`featurelayer-pbf-true-curves`,!0),has.add(`feature-layers-workers`,!0),has.add(`feature-polyline-generalization-factor`,1),has.add(`featurelayer-relative-time-queries-enabled`,!0),has.add(`featurelayer-relative-time-queries-bin-window-public`,1),has.add(`featurelayer-relative-time-queries-bin-window-private`,60),has.add(`parquetlayer-full-query-feature-count`,5e5),has.add(`parquetlayer-persistence-enabled`,!0),has.add(`parquetlayer-cache-enabled`,!0),has.add(`parquetlayer-legacy-field-overrides-enabled`,!1),has.add(`sketch-layer-enabled`,!1),has.add(`mapview-transitions-duration`,200),has.add(`mapview-essential-goto-duration`,200),has.add(`mapview-srswitch-adjust-rotation-scale-threshold`,24e6),has.add(`mapserver-pbf-version-support`,10.81),has.add(`mapservice-popup-identify-max-tolerance`,20),has.add(`request-queue-concurrency-global`,64),has.add(`request-queue-concurrency-hosted`,16),has.add(`request-queue-concurrency-non-hosted`,16),has.add(`curve-densification-coarse-segments`,128),has.add(`curve-densification-max-segments`,2e3),has.add(`curve-densification-min-segments`,3),has.add(`curve-densification-pixel-deviation`,.5),has.add(`view-readyState-waiting-delay`,1e3),has.add(`gradient-depth-bias`,.01),has.add(`gradient-depth-epsilon`,1e-8),!has(`host-webworker`)&&has(`host-browser`)&&(has.add(`esri-csp-restrictions`,()=>{try{Function()}catch{return!0}return!1}),has.add(`esri-url-encodes-apostrophe`,()=>{let e=window.document.createElement(`a`);return e.href=`?'`,e.href.includes(`?%27`)}))})();export{has as default};

package/core/mapCollectionUtils.js

@@ -1,2 +1,2 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import{createTask as e}from"./asyncUtils.js";import t from"./Collection.js";import{destroyHandle as n,removeIfHandle as r}from"./handleUtils.js";import{ignoreAbortErrors as i,isAborted as a,createAbortError as o}from"./promiseUtils.js";import{on as s}from"./reactiveUtils.js";function c(e,n,r){let i=r?.createCollection?.()??new t,a=r?.recycleItems?new l:null,o=(e,t=0)=>{if(!e?.length)return;let n=i.splice(t,e.length);a?a.processRemoved(e):n.forEach(d)},c=(e,t=0)=>{if(!e?.length)return;let r=[];for(let t of e){let e=a?.use(t);if(e)r.push(e);else{let e=n(t);a?.register(t,e),r.push(e)}}i.addMany(r,t)},u=s(e,`after-splice`,({added:e,start:t,removed:n})=>{o(n,t),c(e,t)},{sync:!0,onListenerRemove:e=>o(e.items),onListenerAdd:e=>c(e.items)});return i.addHandles(u),i}class l{constructor(){this._originalToMapped=new Map,this._removedItemCandidates=new Set,this._garbageCollectionQueued=!1}processRemoved(e){if(!e?.length)return;let{_removedItemCandidates:t}=this;for(let n of e)this._getItem(n)?.markRemoved()&&(t.add(n),this._queueGarbageCollection())}use(e){let t=this._getItem(e);return t&&(t.removed=!1),t?.item}register(e,t){this._originalToMapped.set(e,new u(t))}_getItem(e){return this._originalToMapped.get(e)}_queueGarbageCollection(){this._garbageCollectionQueued||(this._garbageCollectionQueued=!0,queueMicrotask(()=>this._garbageCollectCandidates()))}_garbageCollectCandidates(){this._garbageCollectionQueued=!1;let{_removedItemCandidates:e}=this,t=Array.from(e);e.clear(),t.forEach(e=>this._garbageCollectIfRemoved(e))}_garbageCollectIfRemoved(e){let{_originalToMapped:t}=this,n=this._getItem(e);n?.removed&&(d(n.item),t.delete(e))}}class u{constructor(e){this.item=e,this.removed=!1}markRemoved(){return this.removed=!0,!0}}function d(e){typeof e==`object`&&e&&(`destroy`in e&&typeof e.destroy==`function`?e.destroy():r(e))}function f(r,s,l){let u=new t,f=c(r,t=>e(async e=>{let n=await s(t,e);if(a(e))throw d(n),o();return n}),l),p=()=>null,m=async e=>{let t=await e.promise,n=f.indexOf(e);n<0||u.splice(n,1,t)};u.addMany(f.items.map(p));for(let e of f)i(m(e));let h=f.on(`after-splice`,({added:e,start:t,deleteCount:n})=>{let r=u.splice(t,n);for(let e of r)d(e);if(e?.length){u.addMany(e.map(p),t);for(let t of e)i(m(t))}});return u.addHandles([n(f),h]),u}export{c as mapCollection,f as mapCollectionAsync};
+import{createTask as e}from"./asyncUtils.js";import t from"./Collection.js";import{destroyHandle as n,removeIfHandle as r}from"./handleUtils.js";import{ignoreAbortErrors as i,isAborted as a,createAbortError as o}from"./promiseUtils.js";import{on as s}from"./reactiveUtils.js";function c(e,n,r){let i=r?.createCollection?.()??new t,a=r?.recycleItems?new l:null,o=(e,t=0)=>{if(!e?.length)return;let n=i.splice(t,e.length);a?a.processRemoved(e):n.forEach(d)},c=(e,t=0)=>{if(!e?.length)return;let r=[];for(let t of e){let e=a?.use(t);if(e)r.push(e);else{let e=n(t);a?.register(t,e),r.push(e)}}i.addMany(r,t)},u=s(e,`after-splice`,({added:e,start:t,removed:n})=>{o(n,t),c(e,t)},{sync:!0,onListenerRemove:e=>o(e.items),onListenerAdd:e=>c(e.items)});return i.addHandles(u),i}class l{constructor(){this._originalToMapped=new Map,this._removedItemCandidates=new Set,this._garbageCollectionQueued=!1}processRemoved(e){if(!e?.length)return;let{_removedItemCandidates:t}=this;for(let n of e)this._getItem(n)?.markRemoved()&&(t.add(n),this._queueGarbageCollection())}use(e){let t=this._getItem(e);return t&&(t.removed=!1),t?.item}register(e,t){this._originalToMapped.set(e,new u(t))}_getItem(e){return this._originalToMapped.get(e)}_queueGarbageCollection(){this._garbageCollectionQueued||(this._garbageCollectionQueued=!0,queueMicrotask(()=>this._garbageCollectCandidates()))}_garbageCollectCandidates(){this._garbageCollectionQueued=!1;let{_removedItemCandidates:e}=this,t=Array.from(e);e.clear(),t.forEach(e=>this._garbageCollectIfRemoved(e))}_garbageCollectIfRemoved(e){let{_originalToMapped:t}=this,n=this._getItem(e);n?.removed&&(d(n.item),t.delete(e))}}class u{constructor(e){this.item=e,this.removed=!1}markRemoved(){return this.removed=!0,!0}}function d(e){typeof e==`object`&&e&&(`destroy`in e&&typeof e.destroy==`function`?e.destroy():r(e))}function f(r,s,l){let u=new t,f=c(r,t=>e(async e=>{let n=await s(t,e);if(a(e))throw d(n),o();return n}),l),p=()=>null,m=async e=>{let t=await e.promise,n=f.indexOf(e);if(n<0){d(t);return}u.splice(n,1,t)};u.addMany(f.items.map(p));for(let e of f)i(m(e));let h=f.on(`after-splice`,({added:e,start:t,deleteCount:n})=>{let r=u.splice(t,n);for(let e of r)d(e);if(e?.length){u.addMany(e.map(p),t);for(let t of e)i(m(t))}});return u.addHandles([n(f),h]),u}export{c as mapCollection,f as mapCollectionAsync};

package/core/workers/Connection.d.ts

@@ -49,30 +49,23 @@ export interface InvokeOptions extends AbortOptions {
  *
  * ```js
  * // Module loaded in main thread
- * export function getSumAsync(numbers) {
- *   let connection = null;
- *
- *   return workers.open("./calculator.js")
- *     .then(function(conn) {
- *       // Keep the connection reference to later close it.
- *       connection = conn;
- *
- *       return connection.invoke("getSum", numbers);
- *     })
- *     .then(function(result) {
- *       // close the connection
- *       connection.close();
- *       connection = null;
- *
- *       return result;
- *     });
+ * import { open } from "@arcgis/core/core/workers.js";
+ *
+ * export async function getSumAsync(numbers) {
+ *   const connection = await open(new URL("./calculator.js", import.meta.url).href, {
+ *     isESM: true
+ *   });
+ *
+ *   try {
+ *     return await connection.invoke("getSum", numbers);
+ *   } finally {
+ *     connection.close();
+ *   }
  * }
  *
  * // Invoke our method.
- * getSumAsync([0, 2, 4, 6, 8])
- *   .then(function(result) {
- *     console.log("Result:", result);
- *   });
+ * const result = await getSumAsync([0, 2, 4, 6, 8]);
+ * console.log("Result:", result);
  * ```
  *
  * <span id="multiple-parameters"></span>
@@ -102,55 +95,37 @@ export interface InvokeOptions extends AbortOptions {
  *
  * ```js
  * // Module loaded in main thread
- * export function mapMultiplyAsync(numbers, factor) {
- *   let connection = null;
- *
- *   return workers.open("./calculator.js")
- *     .then(function(conn) {
- *       // Keep the connection reference to later close it.
- *       connection = conn;
- *
- *        // invoke mapMultiply and pass in object with two key-value pairs.
- *       return connection.invoke("mapMultiply", {
- *         numbers: numbers,
- *         factor: factor
- *       });
- *     })
- *     .then(function(result) {
- *       // close the connection after we are done.
- *       connection.close();
- *       connection = null;
- *
- *       return result;
+ * export async function mapMultiplyAsync(numbers, factor) {
+ *   const connection = await open(new URL("./calculator.js", import.meta.url).href, {
+ *     isESM: true
+ *   });
+ *
+ *   try {
+ *     // Invoke mapMultiply and pass an object with two key-value pairs.
+ *     return await connection.invoke("mapMultiply", {
+ *       numbers: numbers,
+ *       factor: factor
  *     });
+ *   } finally {
+ *     connection.close();
+ *   }
  * }
  *
  * // Invoke the method.
- * mapMultiplyAsync([0, 2, 4, 6, 8], 2)
- *   .then(function(result) {
- *     console.log("Result:", result);
- *   });
+ * const result = await mapMultiplyAsync([0, 2, 4, 6, 8], 2);
+ * console.log("Result:", result);
  * ```
  *
  * <span id="using-transferables"></span>
  * ## Using transferables
  *
- * `Transferable` objects can be used
+ * [Transferable objects](https://developer.mozilla.org/docs/Web/API/Web_Workers_API/Transferable_objects) can be used
  * to transfer data between main and worker thread to avoid copying the data. With this approach,
  * the ownership of the object is transferred to the other context. Use this technique to transfer large
  * chuck of memory with [ArrayBuffers](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/ArrayBuffer),
  * a [MessagePort](https://developer.mozilla.org/docs/Web/API/MessagePort),
  * or an [ImageBitmap](https://developer.mozilla.org/docs/Web/API/ImageBitmap).
  *
- * > [!CAUTION]
- * >
- * > **Note**
- * >
- * > The `Transferable` interface technically no longer exists. The functionality of `Transferable` objects still exists,
- * > however, but is implemented at a more fundamental level
- * > (technically speaking, using the `[Transferable]` [WebIDL](https://developer.mozilla.org/docs/Glossary/WebIDL)
- * > extended attribute). See also [Transferable objects](https://developer.mozilla.org/docs/Web/API/Web_Workers_API/Transferable_objects).
- *
  * To transfer an object to the worker, use the `transferList` parameter of the [invoke()](https://developers.arcgis.com/javascript/latest/references/core/core/workers/Connection/#invoke) method.
  * For the remote method to return or resolve with a transferable object, the result returned must have
  * two properties: `result` and `transferList`, `result` being an object and `transferList` the array
@@ -184,26 +159,19 @@ export interface InvokeOptions extends AbortOptions {
  *
  * ```js
  * // Module loaded in main thread
- * export function mapMultiplyFloat64Async(numbers, factor) {
- *   let connection = null;
- *
- *   return workers.open("./calculator.js")
- *     .then(function(conn) {
- *       // Keep the connection reference to later close it.
- *       connection = conn;
- *
- *       return connection.invoke("mapMultiplyFloat64", {
- *         numbers: numbers,
- *         factor: factor
- *       });
- *     })
- *     .then(function(result) {
- *       // close the connection after we are done.
- *       connection.close();
- *       connection = null;
- *
- *       return result;
+ * export async function mapMultiplyFloat64Async(numbers, factor) {
+ *   const connection = await open(new URL("./calculator.js", import.meta.url).href, {
+ *     isESM: true
+ *   });
+ *
+ *   try {
+ *     return await connection.invoke("mapMultiplyFloat64", {
+ *       numbers: numbers,
+ *       factor: factor
  *     });
+ *   } finally {
+ *     connection.close();
+ *   }
  * }
  *
  * // Invoke our method.
@@ -213,11 +181,9 @@ export interface InvokeOptions extends AbortOptions {
  * floats[2] = 4;
  * floats[3] = 6;
  * floats[4] = 8;
- * mapMultiplyFloat64Async(floats, 2)
- *   .then(function(result) {
- *     let resultFloats = new Float64Array(result);
- *     console.log("Result:", resultFloats);
- *   });
+ * const result = await mapMultiplyFloat64Async(floats, 2);
+ * const resultFloats = new Float64Array(result);
+ * console.log("Result:", resultFloats);
  * ```
  *
  * @since 4.2
@@ -250,16 +216,19 @@ export default abstract class Connection {
    * const controller = new AbortController();
    * const signal = controller.signal;
    *
-   * // invoke a function on a worker thread
-   * connection.invoke("myLongRunningRemoteFunction", { someParameter: 10 }, {
-   *   signal
-   * })
-   * .then((result) => {
-   *   console.log(result);
-   * })
-   * .catch((error) => {
-   *   console.error(error);
-   * });
+   * // Invoke a function on a worker thread.
+   * async function invokeWithTimeout() {
+   *   try {
+   *     const result = await connection.invoke("myLongRunningRemoteFunction", { someParameter: 10 }, {
+   *       signal
+   *     });
+   *     console.log(result);
+   *   } catch (error) {
+   *     console.error(error);
+   *   }
+   * }
+   *
+   * invokeWithTimeout();
    *
    * // if the call it takes more than 10 secs, abort:
    * setTimeout(() => {