@arcgis/core 5.2.0-next.164 → 5.2.0-next.165

package/chunks/GlobalIllumination.glsl.js

@@ -1,5 +1,5 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import{ScreenSpacePass as e}from"../views/3d/webgl-engine/core/shaderLibrary/ScreenSpacePass.glsl.js";import{ReadDepthLastFrame as t}from"../views/3d/webgl-engine/core/shaderLibrary/output/ReadDepthLastFrame.glsl.js";import{Gamma as n}from"../views/3d/webgl-engine/core/shaderLibrary/shading/Gamma.glsl.js";import{mainLightDirection as r}from"../views/3d/webgl-engine/core/shaderLibrary/shading/MainLighting.glsl.js";import{ScreenSpaceRayMarching as i}from"../views/3d/webgl-engine/core/shaderLibrary/shading/ScreenSpaceRayMarching.glsl.js";import{CameraSpace as a}from"../views/3d/webgl-engine/core/shaderLibrary/util/CameraSpace.glsl.js";import{viewMatrix as o}from"../views/3d/webgl-engine/core/shaderLibrary/util/cameraUniforms.js";import{FloatBindUniform as s}from"../views/3d/webgl-engine/core/shaderModules/FloatBindUniform.js";import{FloatPassUniform as c}from"../views/3d/webgl-engine/core/shaderModules/FloatPassUniform.js";import{glsl as l,If as u}from"../views/3d/webgl-engine/core/shaderModules/glsl.js";import{Matrix4BindUniform as d}from"../views/3d/webgl-engine/core/shaderModules/Matrix4BindUniform.js";import{Texture2DBindUniform as f}from"../views/3d/webgl-engine/core/shaderModules/Texture2DBindUniform.js";import{Texture2DPassUniform as p}from"../views/3d/webgl-engine/core/shaderModules/Texture2DPassUniform.js";import{GlobalIlluminationColorQuantization as m}from"../views/3d/webgl-engine/effects/globalIllumination/GlobalIlluminationColorQuantization.glsl.js";import{floatBlendReductionFactor as h}from"../views/3d/webgl-engine/shaders/floatBlendScale.glsl.js";import{ToneMapping as g}from"../views/3d/webgl-engine/shaders/ToneMapping.glsl.js";import{ColorAttachment1 as _,SizedPixelFormat as v}from"../views/webgl/enums.js";import{NoParameters as y}from"../views/webgl/NoParameters.js";import{ShaderBuilder as b}from"../views/webgl/ShaderBuilder.js";const x=2.5,S=0,C=.8,w=25,T=.15,E=.5,D=1,O=1,k=16;class A extends y{constructor(){super(...arguments),this.projScale=1,this.resolutionScale=1,this.accumulatedFrames=0,this.temporalSampleFrame=0,this.glowBoost=0,this.rayMarchMinReach=T,this.rayMarchMaxReach=E,this.rayMarchWorldReach=25,this.rayMarchMinReachEmissionWeight=1,this.rayMarchMaxReachEmissionWeight=1,this.rayMarchMaxSteps=16,this.colorBleedWeight=0,this.highQualityIdleColorBlendStart=.3,this.emissionBoostFactor=x,this.factorDaylightDirectional=C}}function j(y){let x=new b,S=x.fragment;x.include(e),x.include(a),S.include(t),S.include(n),S.include(m),S.include(g),x.include(i,y),S.uniforms.add(r,o,new p(`normalMap`,e=>e.normalTexture),new p(`depthMap`,e=>e.depthTexture),new p(`lastFrameGlobalIlluminationTexture`,(e,t)=>e.globalIllumination??t.globalIllumination?.getTexture()),new p(`lastFrameGlobalIlluminationWeightTexture`,(e,t)=>e.globalIlluminationWeights??t.globalIllumination?.getTexture(_)),new f(`lastFrameColorTexture`,e=>e.reprojection.lastFrameColor?.getTexture()),new f(`lastFrameDepthTexture`,e=>e.reprojection.lastFrameDepth?.attachment),new d(`reprojectionProjectionMatrix`,e=>e.reprojection.lastFrameCamera.projectionMatrix),new d(`reprojectionViewMatrix`,e=>e.reprojection.viewMatrix),new c(`accumulatedFrames`,e=>e.accumulatedFrames),new c(`temporalSampleFrame`,e=>e.temporalSampleFrame),new c(`resolutionScale`,e=>e.resolutionScale)),S.uniforms.add(new c(`rayMarchMinReach`,e=>e.rayMarchMinReach),new c(`rayMarchMaxReach`,e=>e.rayMarchMaxReach),new c(`rayMarchWorldReach`,e=>e.rayMarchWorldReach),new c(`rayMarchMinReachEmissionWeight`,e=>e.rayMarchMinReachEmissionWeight),new c(`rayMarchMaxReachEmissionWeight`,e=>e.rayMarchMaxReachEmissionWeight),new c(`rayMarchMaxSteps`,e=>e.rayMarchMaxSteps),new c(`colorBleedWeight`,e=>e.colorBleedWeight),new c(`highQualityIdleColorBlendStart`,e=>e.highQualityIdleColorBlendStart),new c(`emissionBoostFactor`,e=>e.emissionBoostFactor+e.glowBoost),new c(`factorDaylightDirectional`,e=>e.factorDaylightDirectional));let{hasEmission:C,hasColor:w}=y;return C&&(S.uniforms.add(new s(`inputScale`,e=>e.reprojection.lastFrameEmission?.getTexture()?.descriptor.internalFormat===v.RGBA8?h:1),new f(`lastFrameEmissionTexture`,e=>e.reprojection.lastFrameEmission?.getTexture())),S.code.add(l`bool hasHitReprojectionMismatch(vec3 hit, vec2 hitReprojectedCoordinate, float colorBlendWeight) {
+import{ScreenSpacePass as e}from"../views/3d/webgl-engine/core/shaderLibrary/ScreenSpacePass.glsl.js";import{ReadDepthLastFrame as t}from"../views/3d/webgl-engine/core/shaderLibrary/output/ReadDepthLastFrame.glsl.js";import{mainLightDirection as n}from"../views/3d/webgl-engine/core/shaderLibrary/shading/MainLighting.glsl.js";import{ScreenSpaceRayMarching as r}from"../views/3d/webgl-engine/core/shaderLibrary/shading/ScreenSpaceRayMarching.glsl.js";import{CameraSpace as i}from"../views/3d/webgl-engine/core/shaderLibrary/util/CameraSpace.glsl.js";import{viewMatrix as a}from"../views/3d/webgl-engine/core/shaderLibrary/util/cameraUniforms.js";import{FloatBindUniform as o}from"../views/3d/webgl-engine/core/shaderModules/FloatBindUniform.js";import{FloatPassUniform as s}from"../views/3d/webgl-engine/core/shaderModules/FloatPassUniform.js";import{glsl as c,If as l}from"../views/3d/webgl-engine/core/shaderModules/glsl.js";import{Matrix4BindUniform as u}from"../views/3d/webgl-engine/core/shaderModules/Matrix4BindUniform.js";import{Texture2DBindUniform as d}from"../views/3d/webgl-engine/core/shaderModules/Texture2DBindUniform.js";import{Texture2DPassUniform as f}from"../views/3d/webgl-engine/core/shaderModules/Texture2DPassUniform.js";import{GlobalIlluminationColorQuantization as p}from"../views/3d/webgl-engine/effects/globalIllumination/GlobalIlluminationColorQuantization.glsl.js";import{floatBlendReductionFactor as m}from"../views/3d/webgl-engine/shaders/floatBlendScale.glsl.js";import{ToneMapping as h}from"../views/3d/webgl-engine/shaders/ToneMapping.glsl.js";import{ColorAttachment1 as g,SizedPixelFormat as _}from"../views/webgl/enums.js";import{NoParameters as v}from"../views/webgl/NoParameters.js";import{ShaderBuilder as y}from"../views/webgl/ShaderBuilder.js";class b extends v{constructor(){super(...arguments),this.projScale=1,this.resolutionScale=1,this.accumulatedFrames=0,this.temporalSampleFrame=0,this.glowBoost=0}}function x(v){let b=new y,x=b.fragment;b.include(e),b.include(i),x.include(t),x.include(p),x.include(h),b.include(r,v),x.uniforms.add(n,a,new f(`normalMap`,e=>e.normalTexture),new f(`depthMap`,e=>e.depthTexture),new f(`lastFrameGlobalIlluminationTexture`,(e,t)=>e.globalIllumination??t.globalIllumination?.getTexture()),new f(`lastFrameGlobalIlluminationWeightTexture`,(e,t)=>e.globalIlluminationWeights??t.globalIllumination?.getTexture(g)),new d(`lastFrameDepthTexture`,e=>e.reprojection.lastFrameDepth?.attachment),new u(`reprojectionProjectionMatrix`,e=>e.reprojection.lastFrameCamera.projectionMatrix),new u(`reprojectionViewMatrix`,e=>e.reprojection.viewMatrix),new s(`accumulatedFrames`,e=>e.accumulatedFrames),new s(`temporalSampleFrame`,e=>e.temporalSampleFrame),new s(`resolutionScale`,e=>e.resolutionScale));let{hasColor:S,hasEmission:C}=v;return S&&C&&(x.uniforms.add(new s(`emissionBoostFactor`,e=>2.5+e.glowBoost),new o(`inputScale`,e=>e.reprojection.lastFrameEmission?.getTexture()?.descriptor.internalFormat===_.RGBA8?m:1),new d(`lastFrameEmissionTexture`,e=>e.reprojection.lastFrameEmission?.getTexture())),x.code.add(c`bool hasHitReprojectionMismatch(vec3 hit, vec2 hitReprojectedCoordinate, float colorBlendWeight) {
 if (colorBlendWeight != 1.0) {
 return false;
 }
@@ -19,7 +19,7 @@ hitReprojectedCoordinate
 float relativeDepthMismatch = abs(storedLastFrameDepth - expectedLastFrameDepth) /
 max(max(storedLastFrameDepth, expectedLastFrameDepth), 0.00001);
 return relativeDepthMismatch > reprojectionMismatchThreshold;
-}`)),S.constants.add(`highQualityIdleColorBlendEnd`,`float`,.008),S.constants.add(`highQualityIdleColorBlendFrames`,`float`,150),S.constants.add(`highQualityIdleOcclusionBlendEnd`,`float`,.008),S.constants.add(`highQualityIdleOcclusionBlendExponent`,`float`,2),S.constants.add(`highQualityIdleOcclusionBlendFrames`,`float`,60),S.constants.add(`highQualityIdleOcclusionBlendStart`,`float`,.095),S.constants.add(`fullColorBleedBlendWeight`,`float`,.012),S.constants.add(`accumulationDitherScale`,`float`,.0039),S.constants.add(`lowQualityColorBlendWeight`,`float`,.0028),S.constants.add(`lowQualityColorDitherScale`,`float`,.25),S.constants.add(`lowQualityOcclusionBlendWeight`,`float`,.008),S.constants.add(`reprojectionMismatchThreshold`,`float`,.01),S.constants.add(`reprojectionMismatchColorScale`,`float`,.45),S.constants.add(`stableHistoryColorBlendWeight`,`float`,.008),S.constants.add(`strongHistoryOcclusionThreshold`,`float`,.02),S.constants.add(`weakHistoryOcclusionBlendWeight`,`float`,.1),S.constants.add(`weakHistoryOcclusionThreshold`,`float`,.5),S.constants.add(`storedColorBlendWeightScale`,`float`,6),S.code.add(l`float computeIdleColorBlendWeight(float accumulatedFrames) {
+}`)),x.constants.add(`rayMarchMinReach`,`float`,.15),x.constants.add(`rayMarchMaxReach`,`float`,v.rayMarchMaxReach),x.constants.add(`rayMarchWorldReach`,`float`,25),x.constants.add(`rayMarchMaxSteps`,`float`,v.rayMarchMaxSteps),x.constants.add(`factorDaylightDirectional`,`float`,.8),x.constants.add(`highQualityIdleColorBlendStart`,`float`,.3),x.constants.add(`highQualityIdleColorBlendEnd`,`float`,.008),x.constants.add(`highQualityIdleColorBlendFrames`,`float`,150),x.constants.add(`highQualityIdleOcclusionBlendEnd`,`float`,.008),x.constants.add(`highQualityIdleOcclusionBlendExponent`,`float`,2),x.constants.add(`highQualityIdleOcclusionBlendFrames`,`float`,60),x.constants.add(`highQualityIdleOcclusionBlendStart`,`float`,.095),x.constants.add(`accumulationDitherScale`,`float`,.0039),x.constants.add(`lowQualityColorBlendWeight`,`float`,.0028),x.constants.add(`lowQualityColorDitherScale`,`float`,.25),x.constants.add(`lowQualityOcclusionBlendWeight`,`float`,.008),x.constants.add(`reprojectionMismatchThreshold`,`float`,.01),x.constants.add(`reprojectionMismatchColorScale`,`float`,.45),x.constants.add(`stableHistoryColorBlendWeight`,`float`,.008),x.constants.add(`strongHistoryOcclusionThreshold`,`float`,.02),x.constants.add(`weakHistoryOcclusionBlendWeight`,`float`,.1),x.constants.add(`weakHistoryOcclusionThreshold`,`float`,.5),x.constants.add(`storedColorBlendWeightScale`,`float`,6),x.code.add(c`float computeIdleColorBlendWeight(float accumulatedFrames) {
 float idleColorBlendProgress = clamp(accumulatedFrames / highQualityIdleColorBlendFrames, 0.0, 1.0);
 return mix(highQualityIdleColorBlendStart, highQualityIdleColorBlendEnd, pow(idleColorBlendProgress, 1./5.)
 );
@@ -60,7 +60,7 @@ blueNoiseDitherValue(pixel, frame, vec2(0.25881904, 0.9659258), 0.37),
 blueNoiseDitherValue(pixel, frame, vec2(1.0, 0.0), 0.61)
 );
 return value * 2.0 - 1.0;
-}`),x.outputs.add(`fragGlobalIllumination`,`vec4`,0),x.outputs.add(`fragWeight`,`vec2`,1),S.main.add(l`
+}`),b.outputs.add(`fragGlobalIllumination`,`vec4`,0),b.outputs.add(`fragWeight`,`vec2`,1),x.main.add(c`
     float depth = depthFromTexture(depthMap, uv);
 
     // Early out if depth is out of range, such as in the sky
@@ -162,28 +162,14 @@ return value * 2.0 - 1.0;
         // 0.0 alpha excludes the surface as a receiver (e.g. water), but a valid ray hit still occludes as opaque
         hitOpacity = storedHitOpacity == 0.0 ? 1.0 : storedHitOpacity;
 
-        ${u(w,l`
-          // Emission and color bleed - Reproject the current receiver and sampled hit to estimate bounced color
-          vec3 receiverColor = texture(lastFrameColorTexture, reprojectedCoordinate.xy).rgb;
-
+        ${l(S&&C,c`
+          // Reproject the sampled hit to read emission.
           vec2 hitReprojectedCoordinate = reprojectionCoordinate(hit);
-          vec3 sourceColor = texture(lastFrameColorTexture, hitReprojectedCoordinate).rgb;
-          vec3 sourceColorLinear = linearizeGamma(sourceColor);
-          ${u(C,l`
-            bool rejectReprojectedHitEmission = hasHitReprojectionMismatch(hit, hitReprojectedCoordinate, colorBlendWeight);
-            `)}
-          vec3 sourceEmission = ${u(C,`rejectReprojectedHitEmission
-              ? vec3(0.0)
-              : texture(lastFrameEmissionTexture, hitReprojectedCoordinate).xyz * inputScale`,`vec3(0.0)`)};
-
-          float emissionWeight = mix(
-            rayMarchMinReachEmissionWeight,
-            rayMarchMaxReachEmissionWeight,
-            (rayMarchScreenReach - rayMarchMinReach) / max(rayMarchMaxReach - rayMarchMinReach, 0.00001)
-          );
-          fragGlobalIllumination.rgb += (
-            hitOpacity * (sourceColorLinear * colorBleedWeight) + emissionBoostFactor * sourceEmission * emissionWeight
-          ) * stepSize;
+          bool rejectReprojectedHitEmission = hasHitReprojectionMismatch(hit, hitReprojectedCoordinate, colorBlendWeight);
+          vec3 sourceEmission = rejectReprojectedHitEmission
+            ? vec3(0.0)
+            : texture(lastFrameEmissionTexture, hitReprojectedCoordinate).xyz * inputScale;
+          fragGlobalIllumination.rgb += emissionBoostFactor * sourceEmission * stepSize;
           `)}
       }
 
@@ -205,12 +191,11 @@ return value * 2.0 - 1.0;
       ? receiverOpacity * randomDirectionSample.b * accumulationDitherScale
       : 0.0;
 
-    ${u(w,l`
-      // Accumulate color
-      vec3 lastFrameColor = lastFrameGlobalIllumination.rgb;
+    ${l(S,c`
+      // Accumulate emission
       float colorDitherScale = isScaledGlobalIllumination ? lowQualityColorDitherScale : 1.0;
       fragGlobalIllumination.rgb = mix(
-        lastFrameColor + accumulationDither * colorDitherScale,
+        lastFrameGlobalIllumination.rgb + accumulationDither * colorDitherScale,
         fragGlobalIllumination.rgb,
         colorBlendWeight
       );
@@ -218,7 +203,7 @@ return value * 2.0 - 1.0;
       if (hasReprojectionMismatch) {
         fragGlobalIllumination.rgb *= reprojectionMismatchColorScale;
       }
-      `,l`
+      `,c`
       fragGlobalIllumination.rgb = vec3(0.0);
       `)}
 
@@ -232,4 +217,4 @@ return value * 2.0 - 1.0;
     fragGlobalIllumination = quantizeGlobalIlluminationColor(fragGlobalIllumination);
 
     fragWeight = vec2(occlusionBlendWeight, colorBlendWeight * storedColorBlendWeightScale);
-  `),x}const M=Object.freeze(Object.defineProperty({__proto__:null,GlobalIlluminationPassParameters:A,build:j,defaultColorBleedWeight:0,defaultEmissionBoostFactor:x,defaultFactorDaylightDirectional:C,defaultRayMarchMaxReach:E,defaultRayMarchMaxReachEmissionWeight:1,defaultRayMarchMaxSteps:16,defaultRayMarchMinReach:T,defaultRayMarchMinReachEmissionWeight:1,defaultRayMarchWorldReach:25},Symbol.toStringTag,{value:`Module`}));export{A as G,M as a,k as b,j as c,E as d,S as e,x as f,C as g,O as h,T as i,D as j,w as k};
+  `),b}const S=Object.freeze(Object.defineProperty({__proto__:null,GlobalIlluminationPassParameters:b,build:x},Symbol.toStringTag,{value:`Module`}));export{b as G,S as a,x as b};

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.164/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.165/assets`,t.defaultAssetsPath=t.assetsPath);export{t as default};

package/core/workers/WorkerFallback.js

@@ -1,5 +1,7 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import{nextTick as e}from"../nextTick.js";import t from"./RemoteClient.js";import{MessageType as n,receiveMessage as r}from"./utils.js";class i{constructor(){let e=document.createDocumentFragment();[`addEventListener`,`dispatchEvent`,`removeEventListener`].forEach(t=>{this[t]=(...n)=>e[t](...n)})}}class a{constructor(){this._dispatcher=new i;this._workerPostMessage({type:n.HANDSHAKE})}terminate(){}get onmessage(){return this._onmessageHandler}set onmessage(e){this._onmessageHandler&&this.removeEventListener(`message`,this._onmessageHandler);this._onmessageHandler=e;e&&this.addEventListener(`message`,e)}get onmessageerror(){return this._onmessageerrorHandler}set onmessageerror(e){this._onmessageerrorHandler&&this.removeEventListener(`messageerror`,this._onmessageerrorHandler);this._onmessageerrorHandler=e;e&&this.addEventListener(`messageerror`,e)}get onerror(){return this._onerrorHandler}set onerror(e){this._onerrorHandler&&this.removeEventListener(`error`,this._onerrorHandler);this._onerrorHandler=e;e&&this.addEventListener(`error`,e)}postMessage(t){e(()=>{this._workerMessageHandler(new MessageEvent(`message`,{data:t}))})}dispatchEvent(e){return this._dispatcher.dispatchEvent(e)}addEventListener(e,t,n){this._dispatcher.addEventListener(e,t,n)}removeEventListener(e,t,n){this._dispatcher.removeEventListener(e,t,n)}_workerPostMessage(t){e(()=>{this.dispatchEvent(new MessageEvent(`message`,{data:t}))})}async _workerMessageHandler(e){let i=r(e);if(!i)return;if(i.type===n.OPEN){let{modulePath:e,jobId:r}=i,a=await t.loadWorker(e);a||=await import(
+import{nextTick as e}from"../nextTick.js";import t from"./RemoteClient.js";import{MessageType as n,receiveMessage as r}from"./utils.js";class i{constructor(){let e=document.createDocumentFragment();[`addEventListener`,`dispatchEvent`,`removeEventListener`].forEach(t=>{this[t]=(...n)=>e[t](...n)})}}class a{constructor(){this._dispatcher=new i;this._workerPostMessage({type:n.HANDSHAKE})}terminate(){}get onmessage(){return this._onmessageHandler}set onmessage(e){this._onmessageHandler&&this.removeEventListener(`message`,this._onmessageHandler);this._onmessageHandler=e;e&&this.addEventListener(`message`,e)}get onmessageerror(){return this._onmessageerrorHandler}set onmessageerror(e){this._onmessageerrorHandler&&this.removeEventListener(`messageerror`,this._onmessageerrorHandler);this._onmessageerrorHandler=e;e&&this.addEventListener(`messageerror`,e)}get onerror(){return this._onerrorHandler}set onerror(e){this._onerrorHandler&&this.removeEventListener(`error`,this._onerrorHandler);this._onerrorHandler=e;e&&this.addEventListener(`error`,e)}postMessage(t){e(()=>{this._workerMessageHandler(new MessageEvent(`message`,{data:t}))})}dispatchEvent(e){return this._dispatcher.dispatchEvent(e)}addEventListener(e,t,n){this._dispatcher.addEventListener(e,t,n)}removeEventListener(e,t,n){this._dispatcher.removeEventListener(e,t,n)}_workerPostMessage(t){e(()=>{this.dispatchEvent(new MessageEvent(`message`,{data:t}))})}async _workerMessageHandler(e){let i=r(e);if(!i)return;if(i.type===n.OPEN){let{modulePath:e,jobId:r}=i,a=await t.loadWorker(e);a||=(i.isESM,await import(
 /* @vite-ignore */
 /* webpackIgnore: true */
-e);let o=t.connect(a);this._workerPostMessage({type:n.OPENED,jobId:r,data:o})}}}export{a as default};
+e))/* @vite-ignore */
+/* webpackIgnore: true */
+;let o=t.connect(a);this._workerPostMessage({type:n.OPENED,jobId:r,data:o})}}}export{a as default};

package/core/workers/workerFactory.js

@@ -1,2 +1,2 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import{getAssetUrl as e}from"../../assets.js";import t from"../../config.js";import{getLocale as n}from"../../intl.js";import{fullVersion as r}from"../../kernel.js";import{deprecatedProperty as i}from"../deprecate.js";import has from"../has.js";import a from"../Logger.js";import{notDeepEqual as o}from"../object.js";import{makeAbsolute as s}from"../urlUtils.js";import{loaderConfig as c}from"./loaderConfig.js";import{receiveMessage as l,MessageType as u}from"./utils.js";import d from"./WorkerFallback.js";const f=()=>a.getLogger(`esri.core.workers.workerFactory`),{HANDSHAKE:p}=u;let m,h;const g=`Failed to create Worker. Fallback to execute module in main thread`;async function _(){if(!has(`esri-workers`))return v(new d);if(!m&&!h)try{let e='"use strict";let globalId=0;const outgoing=new Map,configuration={CONFIGURATION};self.esriConfig=configuration.esriConfig;const workerPath=self.esriConfig.workers.workerPath,HANDSHAKE=0,OPEN=1,OPENED=2,RESPONSE=3,INVOKE=4,ABORT=5;function createAbortError(){const e=new Error("Aborted");return e.name="AbortError",e}function receiveMessage(e){return e&&e.data?"string"==typeof e.data?JSON.parse(e.data):e.data:null}self.invokeStaticMessage=(e,o,r)=>{const t=r&&r.signal,n=globalId++;let s=null;return new Promise((r,i)=>{if(t){if(t.aborted)return i(createAbortError());s=()=>{outgoing.get(n)&&(outgoing.delete(n),self.postMessage({type:5,jobId:n}),i(createAbortError()))},t.addEventListener("abort",s)}outgoing.set(n,{resolve:r,reject:i}),self.postMessage({type:4,jobId:n,methodName:e,abortable:null!=t,data:o})}).finally(()=>{t&&t.removeEventListener("abort",s)})};let workerVersionChecked=!1;function checkWorkerVersion(e){if(!workerVersionChecked&&e.kernelInfo){workerVersionChecked=!0;const{fullVersion:o}=configuration.kernelInfo,{fullVersion:r,version:t}=e.kernelInfo;esriConfig.assetsPath!==esriConfig.defaultAssetsPath&&o!==r&&console.warn(`Version mismatch detected between ArcGIS Maps SDK for JavaScript modules and assets. For more information visit https://esriurl.com/using-local-assets.\\nModules version: ${o}\\nAssets version: ${r??t}\\nAssets path: ${esriConfig.assetsPath}`)}}function messageHandler(e){const o=receiveMessage(e);if(!o)return;const r=o.jobId;switch(o.type){case 1:let t;function n(e){const o=t.connect(e);self.postMessage({type:2,jobId:r,data:o},[o])}"function"==typeof define&&define.amd?require([workerPath],e=>{t=e.default||e,checkWorkerVersion(t),t.loadWorker(o.modulePath).then(e=>e||o.isESM&&import(o.modulePath)||new Promise(e=>{require([o.modulePath],e)})).then(n)}):"System"in self&&"function"==typeof System.import?System.import(workerPath).then(e=>(t=e.default,checkWorkerVersion(t),t.loadWorker(o.modulePath))).then(e=>e||o.isESM&&import(o.modulePath)||System.import(o.modulePath)).then(n):esriConfig.workers.useDynamicImport?import(workerPath).then(e=>{t=e.default||e,checkWorkerVersion(t),t.loadWorker(o.modulePath).then(e=>e||import(o.modulePath)).then(n)}):(self.RemoteClient||importScripts(workerPath),t=self.RemoteClient.default||self.RemoteClient,checkWorkerVersion(t),t.loadWorker(o.modulePath).then(e=>e||import(o.modulePath)).then(n));break;case 3:if(outgoing.has(r)){const s=outgoing.get(r);outgoing.delete(r),o.error?s.reject(JSON.parse(o.error)):s.resolve(o.data)}}}self.dojoConfig=configuration.loaderConfig,esriConfig.workers.loaderUrl&&(self.importScripts(esriConfig.workers.loaderUrl),"function"==typeof require&&"function"==typeof require.config&&require.config(configuration.loaderConfig)),self.addEventListener("message",messageHandler),self.postMessage({type:0});'.split(`{CONFIGURATION}`).join(y());m=URL.createObjectURL(new Blob([e],{type:`text/javascript`}))}catch(e){h=e||{}}let e;if(!m)f().warn(g,h),e=new d;else try{e=new Worker(m,{name:`esri-worker-${b++}`})}catch{f().warn(g,h),e=new d}return v(e)}async function v(e){return new Promise(t=>{function n(i){let a=l(i);a&&a.type===p&&(e.removeEventListener(`message`,n),e.removeEventListener(`error`,r),t(e))}function r(t){t.preventDefault(),e.removeEventListener(`message`,n),e.removeEventListener(`error`,r),f().warn(`Failed to create Worker. Fallback to execute module in main thread`,t),e=new d,e.addEventListener(`message`,n),e.addEventListener(`error`,r)}e.addEventListener(`message`,n),e.addEventListener(`error`,r)})}function y(){o(t.workers,{loaderConfig:{has:{},paths:{},map:{},packages:[]}})&&i(a.getLogger(`esri.config`),`workers`,{see:`https://developers.arcgis.com/javascript/latest/references/core/config/#Config-workers`,version:`5.2`,warnOnce:!0});let l;if(t.default!=null){let e={...t};delete e.default,l=JSON.parse(JSON.stringify(e))}else l=JSON.parse(JSON.stringify(t));l.assetsPath=s(l.assetsPath),l.defaultAssetsPath=l.defaultAssetsPath?s(l.defaultAssetsPath):void 0,l.request.interceptors=[],l.log.interceptors=[],l.locale=n(),l.has={"esri-csp-restrictions":has(`esri-csp-restrictions`),"esri-2d-debug":!1,"esri-2d-update-debug":has(`esri-2d-update-debug`),"esri-2d-annotation-dimension-debug":has(`esri-2d-annotation-dimension-debug`),"esri-2d-log-updating":!1,"esri-2d-complex-shaping":has(`esri-2d-complex-shaping`),"esri-2d-force-complex-shaping":has(`esri-2d-force-complex-shaping`),"esri-2d-stabilize-glyphs":has(`esri-2d-stabilize-glyphs`),"featurelayer-pbf":has(`featurelayer-pbf`),"featurelayer-simplify-thresholds":has(`featurelayer-simplify-thresholds`),"featurelayer-simplify-payload-size-factors":has(`featurelayer-simplify-payload-size-factors`),"featurelayer-simplify-mobile-factor":has(`featurelayer-simplify-mobile-factor`),"featurelayer-query-max-depth":has(`featurelayer-query-max-depth`),"featurelayer-query-max-page-size":has(`featurelayer-query-max-page-size`),"featurelayer-query-tile-max-features":has(`featurelayer-query-tile-max-features`),"featurelayer-query-tile-concurrency":has(`featurelayer-query-tile-concurrency`),"featurelayer-query-pausing-enabled":has(`featurelayer-query-pausing-enabled`),"featurelayer-snapshot-concurrency":has(`featurelayer-snapshot-concurrency`),"featurelayer-snapshot-enabled":has(`featurelayer-snapshot-enabled`),"featurelayer-pixel-buffering-enabled":has(`featurelayer-pixel-buffering-enabled`),"parquetlayer-full-query-feature-count":has(`parquetlayer-full-query-feature-count`),"parquetlayer-cache-enabled":has(`parquetlayer-cache-enabled`),"parquetlayer-legacy-field-overrides-enabled":has(`parquetlayer-legacy-field-overrides-enabled`),"esri-atomics":has(`esri-atomics`),"esri-shared-array-buffer":has(`esri-shared-array-buffer`),"esri-tiles-debug":has(`esri-tiles-debug`),"esri-workers-arraybuffer-transfer":has(`esri-workers-arraybuffer-transfer`),"feature-polyline-generalization-factor":has(`feature-polyline-generalization-factor`),"host-webworker":1},l.workers.loaderUrl&&(l.workers.loaderUrl=s(l.workers.loaderUrl)),l.workers.workerPath?l.workers.workerPath=s(l.workers.workerPath):l.workers.workerPath=s(e(`esri/core/workers/RemoteClient.js`)),l.workers.useDynamicImport=has(`esri-esbuild-build`);let u=t.workers.loaderConfig,d=c({baseUrl:u?.baseUrl,locale:n(),has:{"csp-restrictions":1,"dojo-test-sniff":0,"host-webworker":1,...u?.has},map:{...u?.map},paths:{...u?.paths},packages:u?.packages||[]});return JSON.stringify({esriConfig:l,loaderConfig:d,kernelInfo:{fullVersion:r}})}let b=0;export{_ as createWorker};
+import{getAssetUrl as e}from"../../assets.js";import t from"../../config.js";import{getLocale as n}from"../../intl.js";import{fullVersion as r}from"../../kernel.js";import{deprecatedProperty as i}from"../deprecate.js";import has from"../has.js";import a from"../Logger.js";import{notDeepEqual as o}from"../object.js";import{makeAbsolute as s}from"../urlUtils.js";import{loaderConfig as c}from"./loaderConfig.js";import{receiveMessage as l,MessageType as u}from"./utils.js";import d from"./WorkerFallback.js";const f=()=>a.getLogger(`esri.core.workers.workerFactory`),{HANDSHAKE:p}=u;let m,h;const g=`Failed to create Worker. Fallback to execute module in main thread`;async function _(){if(!has(`esri-workers`))return v(new d);if(!m&&!h)try{let e='"use strict";let globalId=0;const outgoing=new Map,configuration={CONFIGURATION};self.esriConfig=configuration.esriConfig;const workerPath=self.esriConfig.workers.workerPath,HANDSHAKE=0,OPEN=1,OPENED=2,RESPONSE=3,INVOKE=4,ABORT=5;function createAbortError(){const e=new Error("Aborted");return e.name="AbortError",e}function receiveMessage(e){return e&&e.data?"string"==typeof e.data?JSON.parse(e.data):e.data:null}self.invokeStaticMessage=(e,o,r)=>{const t=r&&r.signal,n=globalId++;let s=null;return new Promise((r,i)=>{if(t){if(t.aborted)return i(createAbortError());s=()=>{outgoing.get(n)&&(outgoing.delete(n),self.postMessage({type:5,jobId:n}),i(createAbortError()))},t.addEventListener("abort",s)}outgoing.set(n,{resolve:r,reject:i}),self.postMessage({type:4,jobId:n,methodName:e,abortable:null!=t,data:o})}).finally(()=>{t&&t.removeEventListener("abort",s)})};let workerVersionChecked=!1;function checkWorkerVersion(e){if(!workerVersionChecked&&e.kernelInfo){workerVersionChecked=!0;const{fullVersion:o}=configuration.kernelInfo,{fullVersion:r,version:t}=e.kernelInfo;esriConfig.assetsPath!==esriConfig.defaultAssetsPath&&o!==r&&console.warn(`Version mismatch detected between ArcGIS Maps SDK for JavaScript modules and assets. For more information visit https://esriurl.com/using-local-assets.\\nModules version: ${o}\\nAssets version: ${r??t}\\nAssets path: ${esriConfig.assetsPath}`)}}function messageHandler(e){const o=receiveMessage(e);if(!o)return;const r=o.jobId;switch(o.type){case 1:let t;function n(e){const o=t.connect(e);self.postMessage({type:2,jobId:r,data:o},[o])}"function"==typeof define&&define.amd?require([workerPath],e=>{t=e.default||e,checkWorkerVersion(t),t.loadWorker(o.modulePath).then(e=>e||o.isESM&&import(o.modulePath)||new Promise(e=>{require([o.modulePath],e)})).then(n)}):"System"in self&&"function"==typeof System.import?System.import(workerPath).then(e=>(t=e.default,checkWorkerVersion(t),t.loadWorker(o.modulePath))).then(e=>e||o.isESM&&import(o.modulePath)||System.import(o.modulePath)).then(n):esriConfig.workers.useDynamicImport?import(workerPath).then(e=>{t=e.default||e,checkWorkerVersion(t),t.loadWorker(o.modulePath).then(e=>e||import(o.modulePath)).then(n)}):(self.RemoteClient||importScripts(workerPath),t=self.RemoteClient.default||self.RemoteClient,checkWorkerVersion(t),t.loadWorker(o.modulePath).then(e=>e||import(o.modulePath)).then(n));break;case 3:if(outgoing.has(r)){const s=outgoing.get(r);outgoing.delete(r),o.error?s.reject(JSON.parse(o.error)):s.resolve(o.data)}}}self.dojoConfig=configuration.loaderConfig,esriConfig.workers.loaderUrl&&(self.importScripts(esriConfig.workers.loaderUrl),"function"==typeof require&&"function"==typeof require.config&&require.config(configuration.loaderConfig)),self.addEventListener("message",messageHandler),self.postMessage({type:0});'.split(`{CONFIGURATION}`).join(y());m=URL.createObjectURL(new Blob([e],{type:`text/javascript`}))}catch(e){h=e||{}}let e;if(!m)f().warn(g,h),e=new d;else try{e=new Worker(m,{name:`esri-worker-${b++}`})}catch{f().warn(g,h),e=new d}return v(e)}async function v(e){return new Promise(t=>{function n(i){let a=l(i);a&&a.type===p&&(e.removeEventListener(`message`,n),e.removeEventListener(`error`,r),t(e))}function r(t){t.preventDefault(),e.removeEventListener(`message`,n),e.removeEventListener(`error`,r),f().warn(g,t),e=new d,e.addEventListener(`message`,n),e.addEventListener(`error`,r)}e.addEventListener(`message`,n),e.addEventListener(`error`,r)})}function y(){o(t.workers,{loaderConfig:{has:{},paths:{},map:{},packages:[]}})&&i(a.getLogger(`esri.config`),`workers`,{see:`https://developers.arcgis.com/javascript/latest/references/core/config/#Config-workers`,version:`5.2`,warnOnce:!0});let l;if(t.default!=null){let e={...t};delete e.default,l=JSON.parse(JSON.stringify(e))}else l=JSON.parse(JSON.stringify(t));l.assetsPath=s(l.assetsPath),l.defaultAssetsPath=l.defaultAssetsPath?s(l.defaultAssetsPath):void 0,l.request.interceptors=[],l.log.interceptors=[],l.locale=n(),l.has={"esri-csp-restrictions":has(`esri-csp-restrictions`),"esri-2d-debug":!1,"esri-2d-update-debug":has(`esri-2d-update-debug`),"esri-2d-annotation-dimension-debug":has(`esri-2d-annotation-dimension-debug`),"esri-2d-log-updating":!1,"esri-2d-complex-shaping":has(`esri-2d-complex-shaping`),"esri-2d-force-complex-shaping":has(`esri-2d-force-complex-shaping`),"esri-2d-stabilize-glyphs":has(`esri-2d-stabilize-glyphs`),"featurelayer-pbf":has(`featurelayer-pbf`),"featurelayer-simplify-thresholds":has(`featurelayer-simplify-thresholds`),"featurelayer-simplify-payload-size-factors":has(`featurelayer-simplify-payload-size-factors`),"featurelayer-simplify-mobile-factor":has(`featurelayer-simplify-mobile-factor`),"featurelayer-query-max-depth":has(`featurelayer-query-max-depth`),"featurelayer-query-max-page-size":has(`featurelayer-query-max-page-size`),"featurelayer-query-tile-max-features":has(`featurelayer-query-tile-max-features`),"featurelayer-query-tile-concurrency":has(`featurelayer-query-tile-concurrency`),"featurelayer-query-pausing-enabled":has(`featurelayer-query-pausing-enabled`),"featurelayer-snapshot-concurrency":has(`featurelayer-snapshot-concurrency`),"featurelayer-snapshot-enabled":has(`featurelayer-snapshot-enabled`),"featurelayer-pixel-buffering-enabled":has(`featurelayer-pixel-buffering-enabled`),"parquetlayer-full-query-feature-count":has(`parquetlayer-full-query-feature-count`),"parquetlayer-cache-enabled":has(`parquetlayer-cache-enabled`),"parquetlayer-legacy-field-overrides-enabled":has(`parquetlayer-legacy-field-overrides-enabled`),"esri-atomics":has(`esri-atomics`),"esri-shared-array-buffer":has(`esri-shared-array-buffer`),"esri-tiles-debug":has(`esri-tiles-debug`),"esri-workers-arraybuffer-transfer":has(`esri-workers-arraybuffer-transfer`),"feature-polyline-generalization-factor":has(`feature-polyline-generalization-factor`),"host-webworker":1},l.workers.loaderUrl&&(l.workers.loaderUrl=s(l.workers.loaderUrl)),l.workers.workerPath?l.workers.workerPath=s(l.workers.workerPath):l.workers.workerPath=s(e(`esri/core/workers/RemoteClient.js`)),l.workers.useDynamicImport=has(`esri-esbuild-build`);let u=t.workers.loaderConfig,d=c({baseUrl:u?.baseUrl,locale:n(),has:{"csp-restrictions":1,"dojo-test-sniff":0,"host-webworker":1,...u?.has},map:{...u?.map},paths:{...u?.paths},packages:u?.packages||[]});return JSON.stringify({esriConfig:l,loaderConfig:d,kernelInfo:{fullVersion:r}})}let b=0;export{_ as createWorker};

package/core/workers/workers.js

@@ -1,5 +1,7 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import{deprecatedPropertyValue as e}from"../deprecate.js";import t from"../Error.js";import{handlesGroup as n}from"../handleUtils.js";import has from"../has.js";import r from"../Logger.js";import{getOrCreateMapValue as i}from"../MapUtils.js";import{throwIfAborted as a}from"../promiseUtils.js";import o from"./Connection.js";import{register as s}from"./connectionRegistry.js";import{registry as c}from"./registry.js";import l from"./RemoteClient.js";import u from"./WorkerOwner.js";function d(){let e=has(`min-workers-pool-size`)??2,t=has(`max-workers-pool-size`)??8,n=has(`host-browser`)&&navigator.hardwareConcurrency!==void 0?navigator.hardwareConcurrency-1:t;return Math.min(Math.max(e,n),t)}const f=[],p=new Map;let m=d(),h=0;function g(){m=d();h=0;p.clear()}function _(){E()}async function v(e,t={},n){let r=new o,{registryTarget:i,...a}=t;await r.open(e,a,n);i&&s(i,r);return r}async function y(n,a={}){if(typeof n!=`string`)throw new t(`workers:undefined-module`,`modulePath is missing`);let o=a.strategy||`distributed`;has(`host-webworker`)&&!has(`esri-workers`)&&(o=`local`);let s=a.isESM??!1;!s&&!Object.hasOwn(c,n)&&e(r.getLogger(`esri.core.workers`),`isESM`,`false`,{replacement:"Call `open` using the `isESM` option value `true`, and author the worker as an ES module.",see:`https://developers.arcgis.com/javascript/latest/references/core/core/workers/#open`,version:`5.2`,warnOnce:!0});let l=i(p,n,()=>new D(n,s));switch(o){case`local`:return b(l,a);default:return x(l,a)}}async function b({modulePath:e},t){let n=await l.loadWorker(e);n||=await import(
+import{deprecatedPropertyValue as e}from"../deprecate.js";import t from"../Error.js";import{handlesGroup as n}from"../handleUtils.js";import has from"../has.js";import r from"../Logger.js";import{getOrCreateMapValue as i}from"../MapUtils.js";import{throwIfAborted as a}from"../promiseUtils.js";import o from"./Connection.js";import{register as s}from"./connectionRegistry.js";import{registry as c}from"./registry.js";import l from"./RemoteClient.js";import u from"./WorkerOwner.js";function d(){let e=has(`min-workers-pool-size`)??2,t=has(`max-workers-pool-size`)??8,n=has(`host-browser`)&&navigator.hardwareConcurrency!==void 0?navigator.hardwareConcurrency-1:t;return Math.min(Math.max(e,n),t)}const f=[],p=new Map;let m=d(),h=0;function g(){m=d();h=0;p.clear()}function _(){E()}async function v(e,t={},n){let r=new o,{registryTarget:i,...a}=t;await r.open(e,a,n);i&&s(i,r);return r}async function y(n,a={}){if(typeof n!=`string`)throw new t(`workers:undefined-module`,`modulePath is missing`);let o=a.strategy||`distributed`;has(`host-webworker`)&&!has(`esri-workers`)&&(o=`local`);let s=a.isESM??!1;!s&&!Object.hasOwn(c,n)&&e(r.getLogger(`esri.core.workers`),`isESM`,`false`,{replacement:"Call `open` using the `isESM` option value `true`, and author the worker as an ES module.",see:`https://developers.arcgis.com/javascript/latest/references/core/core/workers/#open`,version:`5.2`,warnOnce:!0});let l=i(p,n,()=>new D(n,s));switch(o){case`local`:return b(l,a);default:return x(l,a)}}async function b({modulePath:e},t){let n=await l.loadWorker(e);n||=(t.isESM,await import(
 /* @vite-ignore */
 /* webpackIgnore: true */
-e);a(t.signal);let r=t.client||n;return await v([l.connect(n,t.schedule)],{...t,client:r})}async function x(e,t){await E();a(t.signal);let r=[];return v(S(e,t.strategy===`dedicated`?1:t.maxNumWorkers&&t.maxNumWorkers>0?Math.min(t.maxNumWorkers,m):m,t.signal,r),t,()=>n(r).remove())}function*S(e,t,n,r){let i=new Set;for(let a=0;a<t;a++){let t=e.getNextProxyId(e=>!i.has(e));if(t==null)break;i.add(t);r.push(e.useProxy(t));yield f[t].open(e.modulePath,e.isESM,{signal:n})}}function C(){if(w){T.abort();w=null}for(let e=0;e<f.length;e++)f[e]&&f[e].terminate();f.length=0;g()}let w=null,T;async function E(){if(w)return w;T=new AbortController;let e=[];for(let t=0;t<m;t++){let n=u.create(t).then(e=>{f[t]=e;return e});e.push(n)}w=Promise.all(e);return w}class D{constructor(e,t){this.modulePath=e;this.isESM=t;this._proxyUseCount=new Map}useProxy(e){this._proxyUseCount.set(e,this._getProxyUseCount(e)+1);return{remove:()=>this._unuseProxy(e)}}getNextProxyId(e){let t=Array.from(this._proxyUseCount.keys()),n,r=h;h=(h+1)%m;for(let i=0;i<t.length;i++){let a=t[(r+i)%t.length];if(!e(a))continue;t.length===m&&(n??=a);if(this._getProxyUseCount(a)===0)return a}if(n!=null)return n;for(let t=0;t<m;t++){let n=(t+r)%m;if(e(n)&&!this._proxyUseCount.has(n))return n}}_unuseProxy(e){this._proxyUseCount.set(e,Math.max(0,this._getProxyUseCount(e)-1))}_getProxyUseCount(e){return this._proxyUseCount.get(e)??0}}export{o as Connection,l as RemoteClient,_ as initialize,y as open,v as openWithPorts,C as terminate};
+e))/* @vite-ignore */
+/* webpackIgnore: true */
+;a(t.signal);let r=t.client||n;return await v([l.connect(n,t.schedule)],{...t,client:r})}async function x(e,t){await E();a(t.signal);let r=[];return v(S(e,t.strategy===`dedicated`?1:t.maxNumWorkers&&t.maxNumWorkers>0?Math.min(t.maxNumWorkers,m):m,t.signal,r),t,()=>n(r).remove())}function*S(e,t,n,r){let i=new Set;for(let a=0;a<t;a++){let t=e.getNextProxyId(e=>!i.has(e));if(t==null)break;i.add(t);r.push(e.useProxy(t));yield f[t].open(e.modulePath,e.isESM,{signal:n})}}function C(){if(w){T.abort();w=null}for(let e=0;e<f.length;e++)f[e]&&f[e].terminate();f.length=0;g()}let w=null,T;async function E(){if(w)return w;T=new AbortController;let e=[];for(let t=0;t<m;t++){let n=u.create(t).then(e=>{f[t]=e;return e});e.push(n)}w=Promise.all(e);return w}class D{constructor(e,t){this.modulePath=e;this.isESM=t;this._proxyUseCount=new Map}useProxy(e){this._proxyUseCount.set(e,this._getProxyUseCount(e)+1);return{remove:()=>this._unuseProxy(e)}}getNextProxyId(e){let t=Array.from(this._proxyUseCount.keys()),n,r=h;h=(h+1)%m;for(let i=0;i<t.length;i++){let a=t[(r+i)%t.length];if(!e(a))continue;t.length===m&&(n??=a);if(this._getProxyUseCount(a)===0)return a}if(n!=null)return n;for(let t=0;t<m;t++){let n=(t+r)%m;if(e(n)&&!this._proxyUseCount.has(n))return n}}_unuseProxy(e){this._proxyUseCount.set(e,Math.max(0,this._getProxyUseCount(e)-1))}_getProxyUseCount(e){return this._proxyUseCount.get(e)??0}}export{o as Connection,l as RemoteClient,_ as initialize,y as open,v as openWithPorts,C as terminate};

package/form/elements/inputs.d.ts

@@ -41,6 +41,7 @@
  * }
  * ```
  *
+ * @deprecated since 5.2. Import individual input modules directly instead.
  * @since 4.16
  * @see [FormTemplate](https://developers.arcgis.com/javascript/latest/references/core/form/FormTemplate/)
  * @see [FieldElement](https://developers.arcgis.com/javascript/latest/references/core/form/elements/FieldElement/)
@@ -70,77 +71,177 @@ import type TextAreaInputClass from "./inputs/TextAreaInput.js";
 import type TextBoxInputClass from "./inputs/TextBoxInput.js";
 import type TimePickerInputClass from "./inputs/TimePickerInput.js";
 
-/** Form element input types. */
+/**
+ * Form element input types.
+ *
+ * @deprecated since 5.2. Import [Input](https://developers.arcgis.com/javascript/latest/references/core/form/elements/inputs/Input/) directly instead.
+ */
 export type Input = BarcodeScannerInputClass | ComboBoxInputClass | DatePickerInputClass | DateTimeOffsetPickerInputClass | DateTimePickerInputClass | DynamicChoiceInputClass | MultipleChoiceInputClass | RadioButtonsInputClass | SwitchInputClass | TextAreaInputClass | TextBoxInputClass | TimePickerInputClass;
 
-/** The `BarcodeScannerInput` class defines the desired user interface for a barcode or QR code scanner. If this type is used in an ArcGIS Maps SDK for JavaScript web application, it will default to the [TextBoxInput](https://developers.arcgis.com/javascript/latest/references/core/form/elements/inputs/TextBoxInput/) type as the API does not support bar code scanning as an input type. */
+/**
+ * The `BarcodeScannerInput` class defines the desired user interface for a barcode or QR code scanner. If this type is used in an ArcGIS Maps SDK for JavaScript web application, it will default to the [TextBoxInput](https://developers.arcgis.com/javascript/latest/references/core/form/elements/inputs/TextBoxInput/) type as the API does not support bar code scanning as an input type.
+ *
+ * @deprecated since 5.2. Import [BarcodeScannerInput](https://developers.arcgis.com/javascript/latest/references/core/form/elements/inputs/BarcodeScannerInput/) directly instead.
+ */
 export const BarcodeScannerInput: typeof BarcodeScannerInputClass;
 
-/** The `BarcodeScannerInput` class defines the desired user interface for a barcode or QR code scanner. If this type is used in an ArcGIS Maps SDK for JavaScript web application, it will default to the [TextBoxInput](https://developers.arcgis.com/javascript/latest/references/core/form/elements/inputs/TextBoxInput/) type as the API does not support bar code scanning as an input type. */
+/**
+ * The `BarcodeScannerInput` class defines the desired user interface for a barcode or QR code scanner. If this type is used in an ArcGIS Maps SDK for JavaScript web application, it will default to the [TextBoxInput](https://developers.arcgis.com/javascript/latest/references/core/form/elements/inputs/TextBoxInput/) type as the API does not support bar code scanning as an input type.
+ *
+ * @deprecated since 5.2. Import [BarcodeScannerInput](https://developers.arcgis.com/javascript/latest/references/core/form/elements/inputs/BarcodeScannerInput/) directly instead.
+ */
 export type BarcodeScannerInput = BarcodeScannerInputClass;
 
-/** The `ComboBoxInput` class defines the desired user interface for a combo box group. */
+/**
+ * The `ComboBoxInput` class defines the desired user interface for a combo box group.
+ *
+ * @deprecated since 5.2. Import [ComboBoxInput](https://developers.arcgis.com/javascript/latest/references/core/form/elements/inputs/ComboBoxInput/) directly instead.
+ */
 export const ComboBoxInput: typeof ComboBoxInputClass;
 
-/** The `ComboBoxInput` class defines the desired user interface for a combo box group. */
+/**
+ * The `ComboBoxInput` class defines the desired user interface for a combo box group.
+ *
+ * @deprecated since 5.2. Import [ComboBoxInput](https://developers.arcgis.com/javascript/latest/references/core/form/elements/inputs/ComboBoxInput/) directly instead.
+ */
 export type ComboBoxInput = ComboBoxInputClass;
 
-/** The `DatePickerInput` class defines the desired user interface for working with date-only types. */
+/**
+ * The `DatePickerInput` class defines the desired user interface for working with date-only types.
+ *
+ * @deprecated since 5.2. Import [DatePickerInput](https://developers.arcgis.com/javascript/latest/references/core/form/elements/inputs/DatePickerInput/) directly instead.
+ */
 export const DatePickerInput: typeof DatePickerInputClass;
 
-/** The `DatePickerInput` class defines the desired user interface for working with date-only types. */
+/**
+ * The `DatePickerInput` class defines the desired user interface for working with date-only types.
+ *
+ * @deprecated since 5.2. Import [DatePickerInput](https://developers.arcgis.com/javascript/latest/references/core/form/elements/inputs/DatePickerInput/) directly instead.
+ */
 export type DatePickerInput = DatePickerInputClass;
 
-/** The `DateTimeOffsetPickerInput` class defines the desired user interface for editing date and time fields in a form that also requires the option to include an offset from Coordinated Universal Time (UTC). */
+/**
+ * The `DateTimeOffsetPickerInput` class defines the desired user interface for editing date and time fields in a form that also requires the option to include an offset from Coordinated Universal Time (UTC).
+ *
+ * @deprecated since 5.2. Import [DateTimeOffsetPickerInput](https://developers.arcgis.com/javascript/latest/references/core/form/elements/inputs/DateTimeOffsetPickerInput/) directly instead.
+ */
 export const DateTimeOffsetPickerInput: typeof DateTimeOffsetPickerInputClass;
 
-/** The `DateTimeOffsetPickerInput` class defines the desired user interface for editing date and time fields in a form that also requires the option to include an offset from Coordinated Universal Time (UTC). */
+/**
+ * The `DateTimeOffsetPickerInput` class defines the desired user interface for editing date and time fields in a form that also requires the option to include an offset from Coordinated Universal Time (UTC).
+ *
+ * @deprecated since 5.2. Import [DateTimeOffsetPickerInput](https://developers.arcgis.com/javascript/latest/references/core/form/elements/inputs/DateTimeOffsetPickerInput/) directly instead.
+ */
 export type DateTimeOffsetPickerInput = DateTimeOffsetPickerInputClass;
 
-/** The `DateTimePickerInput` class defines the desired user interface for editing date (including time) fields in a form. */
+/**
+ * The `DateTimePickerInput` class defines the desired user interface for editing date (including time) fields in a form.
+ *
+ * @deprecated since 5.2. Import [DateTimePickerInput](https://developers.arcgis.com/javascript/latest/references/core/form/elements/inputs/DateTimePickerInput/) directly instead.
+ */
 export const DateTimePickerInput: typeof DateTimePickerInputClass;
 
-/** The `DateTimePickerInput` class defines the desired user interface for editing date (including time) fields in a form. */
+/**
+ * The `DateTimePickerInput` class defines the desired user interface for editing date (including time) fields in a form.
+ *
+ * @deprecated since 5.2. Import [DateTimePickerInput](https://developers.arcgis.com/javascript/latest/references/core/form/elements/inputs/DateTimePickerInput/) directly instead.
+ */
 export type DateTimePickerInput = DateTimePickerInputClass;
 
-/** The `DynamicChoiceInput` class defines the desired user interface for a dynamically generated choice group. */
+/**
+ * The `DynamicChoiceInput` class defines the desired user interface for a dynamically generated choice group.
+ *
+ * @deprecated since 5.2. Import [DynamicChoiceInput](https://developers.arcgis.com/javascript/latest/references/core/form/elements/inputs/DynamicChoiceInput/) directly instead.
+ */
 export const DynamicChoiceInput: typeof DynamicChoiceInputClass;
 
-/** The `DynamicChoiceInput` class defines the desired user interface for a dynamically generated choice group. */
+/**
+ * The `DynamicChoiceInput` class defines the desired user interface for a dynamically generated choice group.
+ *
+ * @deprecated since 5.2. Import [DynamicChoiceInput](https://developers.arcgis.com/javascript/latest/references/core/form/elements/inputs/DynamicChoiceInput/) directly instead.
+ */
 export type DynamicChoiceInput = DynamicChoiceInputClass;
 
-/** The `MultipleChoiceInput` class defines the desired user interface for a multiple choice group. */
+/**
+ * The `MultipleChoiceInput` class defines the desired user interface for a multiple choice group.
+ *
+ * @deprecated since 5.2. Import [MultipleChoiceInput](https://developers.arcgis.com/javascript/latest/references/core/form/elements/inputs/MultipleChoiceInput/) directly instead.
+ */
 export const MultipleChoiceInput: typeof MultipleChoiceInputClass;
 
-/** The `MultipleChoiceInput` class defines the desired user interface for a multiple choice group. */
+/**
+ * The `MultipleChoiceInput` class defines the desired user interface for a multiple choice group.
+ *
+ * @deprecated since 5.2. Import [MultipleChoiceInput](https://developers.arcgis.com/javascript/latest/references/core/form/elements/inputs/MultipleChoiceInput/) directly instead.
+ */
 export type MultipleChoiceInput = MultipleChoiceInputClass;
 
-/** The `RadioButtonsInput` class defines the desired user interface for a radio button group. */
+/**
+ * The `RadioButtonsInput` class defines the desired user interface for a radio button group.
+ *
+ * @deprecated since 5.2. Import [RadioButtonsInput](https://developers.arcgis.com/javascript/latest/references/core/form/elements/inputs/RadioButtonsInput/) directly instead.
+ */
 export const RadioButtonsInput: typeof RadioButtonsInputClass;
 
-/** The `RadioButtonsInput` class defines the desired user interface for a radio button group. */
+/**
+ * The `RadioButtonsInput` class defines the desired user interface for a radio button group.
+ *
+ * @deprecated since 5.2. Import [RadioButtonsInput](https://developers.arcgis.com/javascript/latest/references/core/form/elements/inputs/RadioButtonsInput/) directly instead.
+ */
 export type RadioButtonsInput = RadioButtonsInputClass;
 
-/** The `SwitchInput` class defines the desired user interface for a binary switch or toggle. This should be used when selecting between two options in a form. */
+/**
+ * The `SwitchInput` class defines the desired user interface for a binary switch or toggle. This should be used when selecting between two options in a form.
+ *
+ * @deprecated since 5.2. Import [SwitchInput](https://developers.arcgis.com/javascript/latest/references/core/form/elements/inputs/SwitchInput/) directly instead.
+ */
 export const SwitchInput: typeof SwitchInputClass;
 
-/** The `SwitchInput` class defines the desired user interface for a binary switch or toggle. This should be used when selecting between two options in a form. */
+/**
+ * The `SwitchInput` class defines the desired user interface for a binary switch or toggle. This should be used when selecting between two options in a form.
+ *
+ * @deprecated since 5.2. Import [SwitchInput](https://developers.arcgis.com/javascript/latest/references/core/form/elements/inputs/SwitchInput/) directly instead.
+ */
 export type SwitchInput = SwitchInputClass;
 
-/** `TextAreaInput` defines the desired user interface for a multi-line text area. */
+/**
+ * `TextAreaInput` defines the desired user interface for a multi-line text area.
+ *
+ * @deprecated since 5.2. Import [TextAreaInput](https://developers.arcgis.com/javascript/latest/references/core/form/elements/inputs/TextAreaInput/) directly instead.
+ */
 export const TextAreaInput: typeof TextAreaInputClass;
 
-/** `TextAreaInput` defines the desired user interface for a multi-line text area. */
+/**
+ * `TextAreaInput` defines the desired user interface for a multi-line text area.
+ *
+ * @deprecated since 5.2. Import [TextAreaInput](https://developers.arcgis.com/javascript/latest/references/core/form/elements/inputs/TextAreaInput/) directly instead.
+ */
 export type TextAreaInput = TextAreaInputClass;
 
-/** `TextBoxInput` defines the desired user interface for a single-line text box. */
+/**
+ * `TextBoxInput` defines the desired user interface for a single-line text box.
+ *
+ * @deprecated since 5.2. Import [TextBoxInput](https://developers.arcgis.com/javascript/latest/references/core/form/elements/inputs/TextBoxInput/) directly instead.
+ */
 export const TextBoxInput: typeof TextBoxInputClass;
 
-/** `TextBoxInput` defines the desired user interface for a single-line text box. */
+/**
+ * `TextBoxInput` defines the desired user interface for a single-line text box.
+ *
+ * @deprecated since 5.2. Import [TextBoxInput](https://developers.arcgis.com/javascript/latest/references/core/form/elements/inputs/TextBoxInput/) directly instead.
+ */
 export type TextBoxInput = TextBoxInputClass;
 
-/** The `TimePickerInput` class defines the desired user interface for working with time-only types. */
+/**
+ * The `TimePickerInput` class defines the desired user interface for working with time-only types.
+ *
+ * @deprecated since 5.2. Import [TimePickerInput](https://developers.arcgis.com/javascript/latest/references/core/form/elements/inputs/TimePickerInput/) directly instead.
+ */
 export const TimePickerInput: typeof TimePickerInputClass;
 
-/** The `TimePickerInput` class defines the desired user interface for working with time-only types. */
+/**
+ * The `TimePickerInput` class defines the desired user interface for working with time-only types.
+ *
+ * @deprecated since 5.2. Import [TimePickerInput](https://developers.arcgis.com/javascript/latest/references/core/form/elements/inputs/TimePickerInput/) directly instead.
+ */
 export type TimePickerInput = TimePickerInputClass;

package/form/elements/inputs.js

@@ -1,2 +1,2 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import e from"./inputs/BarcodeScannerInput.js";import t from"./inputs/ComboBoxInput.js";import n from"./inputs/DatePickerInput.js";import r from"./inputs/DateTimeOffsetPickerInput.js";import i from"./inputs/DateTimePickerInput.js";import a from"./inputs/DynamicChoiceInput.js";import o from"./inputs/Input.js";import s from"./inputs/MultipleChoiceInput.js";import c from"./inputs/RadioButtonsInput.js";import l from"./inputs/SwitchInput.js";import u from"./inputs/TextAreaInput.js";import d from"./inputs/TextBoxInput.js";import f from"./inputs/TimePickerInput.js";const p=e,m=t,h=n,g=r,_=i,v=a,y=s,b=c,x=l,S=u,C=d,w=f,T={base:o,key:`type`,typeMap:{"barcode-scanner":p,"combo-box":m,"date-picker":h,"datetime-picker":_,"dynamic-choice":v,"multiple-choice":y,"timestampoffset-picker":g,"datetimeoffset-picker":g,"radio-buttons":b,switch:x,"text-area":S,"text-box":C,"time-picker":w}};export{p as BarcodeScannerInput,m as ComboBoxInput,h as DatePickerInput,g as DateTimeOffsetPickerInput,_ as DateTimePickerInput,v as DynamicChoiceInput,y as MultipleChoiceInput,b as RadioButtonsInput,x as SwitchInput,S as TextAreaInput,C as TextBoxInput,w as TimePickerInput,T as types};
+import{deprecatedModule as e}from"../../core/deprecate.js";import t from"../../core/Logger.js";import n from"./inputs/BarcodeScannerInput.js";import r from"./inputs/ComboBoxInput.js";import i from"./inputs/DatePickerInput.js";import a from"./inputs/DateTimeOffsetPickerInput.js";import o from"./inputs/DateTimePickerInput.js";import s from"./inputs/DynamicChoiceInput.js";import c from"./inputs/Input.js";import l from"./inputs/MultipleChoiceInput.js";import u from"./inputs/RadioButtonsInput.js";import d from"./inputs/SwitchInput.js";import f from"./inputs/TextAreaInput.js";import p from"./inputs/TextBoxInput.js";import m from"./inputs/TimePickerInput.js";e(t.getLogger(`esri.form.elements.inputs`),`esri.form.elements.inputs`,{replacement:`Individual input module imports`,version:`5.2`,warnOnce:!0});const h=n,g=r,_=i,v=a,y=o,b=s,x=l,S=u,C=d,w=f,T=p,E=m,D={base:c,key:`type`,typeMap:{"barcode-scanner":h,"combo-box":g,"date-picker":_,"datetime-picker":y,"dynamic-choice":b,"multiple-choice":x,"timestampoffset-picker":v,"datetimeoffset-picker":v,"radio-buttons":S,switch:C,"text-area":w,"text-box":T,"time-picker":E}};export{h as BarcodeScannerInput,g as ComboBoxInput,_ as DatePickerInput,v as DateTimeOffsetPickerInput,y as DateTimePickerInput,b as DynamicChoiceInput,x as MultipleChoiceInput,S as RadioButtonsInput,C as SwitchInput,w as TextAreaInput,T as TextBoxInput,E as TimePickerInput,D as types};

package/form/elements.d.ts

@@ -34,6 +34,7 @@
  * }
  * ```
  *
+ * @deprecated since 5.2. Import individual element modules directly instead.
  * @since 4.16
  * @see [FormTemplate](https://developers.arcgis.com/javascript/latest/references/core/form/FormTemplate/)
  * @see [AttachmentElement](https://developers.arcgis.com/javascript/latest/references/core/form/elements/AttachmentElement/)

package/graphic/AnnotationFeatureGraphicOrigin.d.ts

@@ -4,23 +4,63 @@ import type AnnotationFeatureSublayer from "../layers/support/AnnotationFeatureS
 
 /**
  * Provides information about the [AnnotationFeatureLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/AnnotationFeatureLayer/) from which a graphic originates.
+ * The [layer](https://developers.arcgis.com/javascript/latest/references/core/graphic/AnnotationFeatureGraphicOrigin/#layer) property references the AnnotationFeatureLayer, and the
+ * [sublayer](https://developers.arcgis.com/javascript/latest/references/core/graphic/AnnotationFeatureGraphicOrigin/#sublayer) property references the [AnnotationFeatureSublayer](https://developers.arcgis.com/javascript/latest/references/core/layers/support/AnnotationFeatureSublayer/) that contains the graphic, when available.
+ * The sublayer is `null` when no annotation sublayer information is available.
  * The [origin](https://developers.arcgis.com/javascript/latest/references/core/Graphic/#origin) information may be available when a graphic is returned from methods such as
  * [hitTest()](https://developers.arcgis.com/javascript/latest/references/core/views/MapView/#hitTest) or [queryFeatures()](https://developers.arcgis.com/javascript/latest/references/core/layers/AnnotationFeatureLayer/#queryFeatures).
  *
+ * Before accessing the layer properties, use [isAnnotationFeatureGraphicOrigin](https://developers.arcgis.com/javascript/latest/references/core/graphic/isAnnotationFeatureGraphicOrigin/) to check
+ * whether the graphic's origin is an AnnotationFeatureGraphicOrigin.
+ *
+ * Use [getGraphicOriginTitle](https://developers.arcgis.com/javascript/latest/references/core/graphic/getGraphicOriginTitle/) to get the sublayer's title, or the layer's title when the sublayer is `null`.
+ * To get the popup template applicable to the graphic, call [Graphic.getEffectivePopupTemplate()](https://developers.arcgis.com/javascript/latest/references/core/Graphic/#getEffectivePopupTemplate) on the graphic
+ * instead of accessing the AnnotationFeatureLayer's template directly.
+ *
  * @since 5.1
  * @see [MapView.hitTest()](https://developers.arcgis.com/javascript/latest/references/core/views/MapView/#hitTest)
  * @see [SceneView.hitTest()](https://developers.arcgis.com/javascript/latest/references/core/views/SceneView/#hitTest)
  * @see [AnnotationFeatureLayer.queryFeatures()](https://developers.arcgis.com/javascript/latest/references/core/layers/AnnotationFeatureLayer/#queryFeatures)
  * @example
- * // get a point from view's click event
- *  view.on("click", async (event) => {
- *    // Search for all features only on included layer at the clicked location
- *    const response = await view.hitTest(event, {include: layer});
- *    // if graphics are returned from layer, get the layer id from graphic origin
- *    if (response.results.length > 0) {
- *      const originId = response.results[0].graphic?.origin?.layer?.id;
- *    }
- *  });
+ * Access the layer and sublayer of a graphic that originated from a MapImageLayer.
+ * ```js
+ * import { isMapImageGraphicOrigin } from "@arcgis/core/graphic/isMapImageGraphicOrigin.js";
+ *
+ * const origin = graphic.origin;
+ *
+ * // Check whether the graphic came from a MapImageLayer
+ * if (isMapImageGraphicOrigin(origin)) {
+ *   console.log(origin.layer.title);
+ *   console.log(origin.sublayer.title);
+ * }
+ * ```
+ * @example
+ * Access the vector tile style layer associated with a graphic returned by hitTest().
+ * ```js
+ * import { isVectorTileGraphicOrigin } from "@arcgis/core/graphic/isVectorTileGraphicOrigin.js";
+ *
+ * viewElement.addEventListener("arcgisViewClick", async (event) => {
+ *   // Get hit-test results from the VectorTileLayer at the clicked location
+ *   const response = await view.hitTest(event.detail, { include: vectorTileLayer });
+ *
+ *   for (const result of response.results) {
+ *     // Only graphic results contain a graphic with origin information
+ *     if (result.type !== "graphic") {
+ *       continue;
+ *     }
+ *
+ *     const graphic = result.graphic;
+ *     const origin = graphic.origin;
+ *
+ *     // Check whether the graphic came from a VectorTileLayer
+ *     if (isVectorTileGraphicOrigin(origin)) {
+ *       // layerId identifies a style layer within the VectorTileLayer
+ *       const styleLayer = origin.layer.getStyleLayer(origin.layerId);
+ *       console.log(styleLayer);
+ *     }
+ *   }
+ * });
+ * ```
  */
 export default class AnnotationFeatureGraphicOrigin extends GraphicOrigin {
   constructor(layer: AnnotationFeatureLayer, sublayer: AnnotationFeatureSublayer | null);

package/graphic/BuildingGraphicOrigin.d.ts

@@ -4,12 +4,61 @@ import type BuildingComponentSublayer from "../layers/buildingSublayers/Building
 
 /**
  * Provides information about the [BuildingSceneLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/BuildingSceneLayer/) from which a graphic originates.
+ * The [layer](https://developers.arcgis.com/javascript/latest/references/core/graphic/BuildingGraphicOrigin/#layer) property references the BuildingSceneLayer, and the
+ * [sublayer](https://developers.arcgis.com/javascript/latest/references/core/graphic/BuildingGraphicOrigin/#sublayer) property references the [BuildingComponentSublayer](https://developers.arcgis.com/javascript/latest/references/core/layers/buildingSublayers/BuildingComponentSublayer/) that contains the graphic.
  * The [origin](https://developers.arcgis.com/javascript/latest/references/core/Graphic/#origin) information may be available when a graphic is returned from methods such as
  * [hitTest()](https://developers.arcgis.com/javascript/latest/references/core/views/SceneView/#hitTest).
  *
+ * Before accessing the layer properties, use [isBuildingGraphicOrigin](https://developers.arcgis.com/javascript/latest/references/core/graphic/isBuildingGraphicOrigin/) to check
+ * whether the graphic's origin is a BuildingGraphicOrigin.
+ *
+ * If you only need the title of the originating component sublayer, use [getGraphicOriginTitle](https://developers.arcgis.com/javascript/latest/references/core/graphic/getGraphicOriginTitle/).
+ * To get the popup template applicable to the graphic, call [Graphic.getEffectivePopupTemplate()](https://developers.arcgis.com/javascript/latest/references/core/Graphic/#getEffectivePopupTemplate) on the graphic
+ * instead of accessing the component sublayer's template directly.
+ *
  * @since 5.0
  * @see [SceneView.hitTest()](https://developers.arcgis.com/javascript/latest/references/core/views/SceneView/#hitTest)
  * @see [Scene component hitTest()](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/#hitTest)
+ * @example
+ * Access the layer and sublayer of a graphic that originated from a MapImageLayer.
+ * ```js
+ * import { isMapImageGraphicOrigin } from "@arcgis/core/graphic/isMapImageGraphicOrigin.js";
+ *
+ * const origin = graphic.origin;
+ *
+ * // Check whether the graphic came from a MapImageLayer
+ * if (isMapImageGraphicOrigin(origin)) {
+ *   console.log(origin.layer.title);
+ *   console.log(origin.sublayer.title);
+ * }
+ * ```
+ * @example
+ * Access the vector tile style layer associated with a graphic returned by hitTest().
+ * ```js
+ * import { isVectorTileGraphicOrigin } from "@arcgis/core/graphic/isVectorTileGraphicOrigin.js";
+ *
+ * viewElement.addEventListener("arcgisViewClick", async (event) => {
+ *   // Get hit-test results from the VectorTileLayer at the clicked location
+ *   const response = await view.hitTest(event.detail, { include: vectorTileLayer });
+ *
+ *   for (const result of response.results) {
+ *     // Only graphic results contain a graphic with origin information
+ *     if (result.type !== "graphic") {
+ *       continue;
+ *     }
+ *
+ *     const graphic = result.graphic;
+ *     const origin = graphic.origin;
+ *
+ *     // Check whether the graphic came from a VectorTileLayer
+ *     if (isVectorTileGraphicOrigin(origin)) {
+ *       // layerId identifies a style layer within the VectorTileLayer
+ *       const styleLayer = origin.layer.getStyleLayer(origin.layerId);
+ *       console.log(styleLayer);
+ *     }
+ *   }
+ * });
+ * ```
  */
 export default class BuildingGraphicOrigin extends GraphicOrigin {
   constructor(sublayer: BuildingComponentSublayer);