@arcgis/core 6.0.0-next.12 → 6.0.0-next.14

package/layers/raster/datasets/pixelReader.js

@@ -1,2 +1,2 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/6.0/LICENSE.txt */
-import e from"../../../core/Error.js";import{throwIfAborted as t}from"../../../core/promiseUtils.js";import n from"../../../geometry/Extent.js";import r from"../../../geometry/Point.js";import{getByteCount as i}from"../formats/pixelRangeUtils.js";import{convertPixelSize as a,snapToRaster as o,clip as s}from"../functions/clipUtils.js";import{transformPixels as c}from"../functions/pixelTransformUtils.js";import{mapPixelValueToAttribute as l,mosaic as u,pixelIdFieldName as d,convertPixelBlockToFeatures as f,getValidPixels as p,countCategoricalPixels as m}from"../functions/pixelUtils.js";import{load as h,projectPolygon as g}from"../functions/rasterProjectionHelper.js";import{computeBoxStatistics as _,computeStatisticsHistograms as v}from"../functions/stretchUtils.js";import y from"../../support/Field.js";import b from"../../support/PixelBlock.js";import{getBandNames as x}from"../../../renderers/support/rasterRendererHelper.js";import S from"../../../rest/support/ImageIdentifyParameters.js";const C=2**30,w=2048,T=2**20;async function E(e,t){return e.type===`imagery`?await e.generateRasterInfo(e.rasterFunction,t):e.raster.rasterInfo}function D(e){let{rasterInfo:t,geometry:n,pixelSize:i,downsampleOnly:s=!1,maxPixelCountForDownsample:c}=e;if(!i)return!0;if(!s)return!1;let l=a(i,t.spatialReference);if(l.x+l.y<=t.pixelSize.x+t.pixelSize.y)return!0;if(c==null)return!1;let u=n?.type===`polyline`?n.extent:n??t.extent,d=new r({x:t.pixelSize.x,y:t.pixelSize.y,spatialReference:t.spatialReference}),f=o(t,u,d);return f.width*f.height<=c}function O(e){let t=[new y({name:d,alias:`Pixel ID`,type:`oid`})],{pixelType:n}=e,r=n===`f32`?`single`:n===`f64`?`double`:`integer`;return x(e).forEach(e=>{t.push(new y({name:e,alias:e,type:r}))}),t.map(e=>e.toJSON())}async function k(t,n){if(t.spatialReference.equals(n))return t;if(t.type===`polyline`){let{projectExecute:r}=await import(`../../../geometry/operators/projectOperator.js`),i=r(t,n);if(i==null)throw new e(`read-pixels`,`failed to project the geometry into the layer's spatial reference`);return i}if(t.type===`extent`||t.rings[0].length<20){let[{lengthExecute:e},{densifyExecute:r}]=await Promise.all([import(`../../../geometry/operators/lengthOperator.js`),import(`../../../geometry/operators/densifyOperator.js`)]),i=e(t,{unit:`meters`})/100;t=r(t,i,{unit:`meters`}),await h(),t=g(t,n)}return t}async function A(e,t,n=!1){let{spatialReference:i}=e,a=t?.geometry,s=await k(a??e.extent,i),c=s.type===`extent`?s:s.extent,l=a!=null&&(a.type!==`extent`||!a.spatialReference.equals(i))?s:void 0,u=new r({x:e.pixelSize.x,y:e.pixelSize.y,spatialReference:i}),d=!!t?.autoResample,f=d?u:t?.pixelSize??u,{extent:p,width:m,height:h}=o(e,c,f);if(!d)return{extent:p,clipGeometry:l,width:m,height:h,pixelSize:f};let g=e.storageInfo?.pyramidScalingFactor??2,{x:_,y:v}=f,y=t?.maxPixelCount??T;for(;m*h>y&&(!n||Math.max(m,h)>1024);)_*=g,v*=g,m/=g,h/=g;return m=Math.round(m),h=Math.round(h),{extent:p,clipGeometry:l,width:m,height:h,pixelSize:new r({x:_,y:v,spatialReference:i})}}async function*j(e,r,i=!1,a){let{extent:o,clipGeometry:c,width:l,height:u}=r,d=o.width/l,f=o.height/u,p=Math.ceil(l/w),m=Math.ceil(u/w),h=d*w,g=f*w,{xmin:_,xmax:v,ymin:y,ymax:b}=o,x=m*p,S={bandIds:r.bandIds?.length?r.bandIds:void 0,interpolation:`nearest`,...a};for(let r=0;r<m;r++)for(let a=0;a<p;a++){t(S);let l=new n({xmin:_+a*h,xmax:i?Math.min(v,_+(a+1)*h):_+(a+1)*h,ymax:b-r*g,ymin:i?Math.max(y,b-(r+1)*g):b-(r+1)*g,spatialReference:o.spatialReference}),u={row:r,col:a},m=r*p+a+1;if(c&&!l.intersects(c)){yield{extent:l,pixelBlock:null,id:u,total:x,current:m};continue}let C=i?Math.round(l.width/d):w,T=i?Math.round(l.height/f):w,{pixelBlock:E}=await e.fetchPixels(l,C,T,S).catch(()=>({pixelBlock:void 0}));E&&c&&(E=await s(E,l,c)),yield{extent:l,pixelBlock:E,id:u,total:x,current:m}}}async function*M(e,n,r){let i=await E(e,r),a=O(i),o=j(e,await A(i,{...n,geometry:n?.geometry??i.extent}),!0,r),s=i.width;for await(let c of o){if(!c.pixelBlock){yield{...c};continue}let o=J(e),{pixelBlock:l}=c,{statistics:u,histograms:d}=await K({pixelBlock:l,rasterJobHandler:o},r),f=c;f.statistics=u,f.histograms=d;let p=c.id.row*i.width*w+c.id.col*w;t(r),f.featureSet=await q({pixelBlock:l,extent:c.extent,fields:a,skipFactor:n?.skipFactor??1,rasterJobHandler:o,pixelIdOffset:p,imageRowSize:s},r),t(r),yield f}}function N(t,n,r){let a=i(n),{width:o,height:s}=t;if(o*s*a>C)throw new e(`fetch-pixels`,`failed to fetch pixels as pixel byte count exceeds the 1GB limit`);if(r&&o*s>r)throw new e(`fetch-pixels`,`failed to fetch pixels as pixel count exceeds the ${r} limit`)}async function P(t,n,r){if(!n.geometry)throw new e(`fetch-pixels`,`geometry is required to fetch pixel feature set`);let i=await E(t),a=await A(i,n,!0);N(a,i.pixelType);let{extent:o,pixelSize:s}=a,c=Math.round(i.extent.width/s.x),l=O(i),u={fields:l,features:[]},d=u.features,{maxPixelCount:f}=n,p=!!n.autoResample&&f!=null&&a.width*a.height>f,m=p?1:n.skipFactor??1,h=a.width<=w||a.height<=w,g=j(t,a,m===1||h,r);for await(let e of g){if(!e.pixelBlock)continue;let n=J(t),a=Math.floor((i.extent.ymax-e.extent.ymax)/s.y)*c+Math.floor((e.extent.xmin-i.extent.xmin)/s.x),o=await q({pixelBlock:e.pixelBlock,extent:e.extent,fields:l,skipFactor:m,rasterJobHandler:n,pixelIdOffset:a,imageRowSize:c},r);if(o?.features?.length){let{features:e}=o,t=e.length;for(let n=0;n<t;n++){let t=e.pop();d.push(t)}}}if(p&&f){let e=f/(n.skipFactor??1)**2;if(d.length>e){let t=d.length/e,n=[...d],r=d.length-1;d.length=0;for(let i=0,a=0;i<e-1;i++){a+=t;let e=Math.round(a);e<r&&d.push(n[e])}}}return{extent:o,featureSet:u,pixelSize:s}}async function F(e,t,n){let{geometry:r}=t;if(r.type===`multipoint`)return I(e,r,n);if(r.type===`polyline`)return z(e,r,n);let i=await Y(e,{geometry:r},n);return i?_(i):null}async function I(e,t,n){let r=await E(e,n),i=t.points.map((e,n)=>t.getPoint(n)).map(t=>L(e,t,n)),a=(await Promise.all(i)).filter(e=>e!=null);if(a.length<=1)return R(a[0]);let o=a[0].map((e,t)=>a.map(e=>e[t]));return _(new b({pixels:o,pixelType:r.pixelType}))}async function L(e,t,n){if(e.type===`imagery`){let r=await e.identify(new S({geometry:t,returnCatalogItems:!1}),n).catch(()=>null);return r?.value==null||r.value.includes(`NoData`)?null:r.value.replaceAll(`, `,` `).split(` `).map(e=>Number(e))}return(await e.identify(t,n).catch(()=>null))?.value}function R(e){return e?.map(e=>({min:e,max:e,avg:e,median:e,quartile1:e,quartile3:e}))}async function z(e,t,n){let r=await W(e,{geometry:t},n),{bandCount:i,pixelType:a}=await E(e,n),o=Array(i).fill(0).map(()=>b.createEmptyBand(a,r.length)),s=0;for(let e=0;e<r.length;e++){let t=r[e];if(t.value!=null){s++;for(let n=0;n<i;n++)o[n][e]=t.value[n]}}return s!==r.length&&o.forEach((e,t)=>{o[t]=e.subarray(0,s)}),_(new b({pixels:o,pixelType:a}))}async function B(t,n,r){let i=await E(t,r);if(!i.attributeTable)return null;let a=i.attributeTable.clone(),o=a.fields.find(e=>e.name.toLowerCase()===`value`),s=a.fields.find(e=>e.name.toLowerCase()===`count`);if(!o)throw new e(`compute-attribute-table`,`Value field not found in attribute table`);s||(s=new y({name:`Count`,alias:`Count`,type:`double`}),a.fields.push(s),a.features.forEach(e=>{e.attributes[s.name]=0}));let{geometry:c,pixelSize:l,downsampleOnly:u,maxPixelCountForDownsample:d}=n,f=new Map;return await G(t,{geometry:c,pixelSize:D({rasterInfo:i,geometry:c,pixelSize:l,downsampleOnly:u,maxPixelCountForDownsample:d})?void 0:l},(e,t)=>m(e,f),r),a.features.forEach(e=>{let t=e.attributes[o.name];e.attributes[s.name]=f.get(t)??0}),a}async function V(e,t,n){let{geometry:r}=t;if(r.type===`point`)return L(e,r,n);if(r.type===`multipoint`){let t=r.points.map((e,t)=>r.getPoint(t)).map(t=>L(e,t,n)),i=(await Promise.all(t)).filter(e=>e!=null);return i.length===0?null:H(i).map(e=>e/i.length)}let i=(await G(e,{geometry:r},(e,t)=>U(e),n))?.filter(e=>e.count>0);if(!i?.length)return null;let a=H(i.map(e=>e.bandSum)),o=i.map(e=>e.count).reduce((e,t)=>e+t);return a.map(e=>e/o)}function H(e){return e.reduce((e,t)=>e.map((e,n)=>e+t[n]))}function U(e){let{width:t,height:n,pixels:r,mask:i}=e,a=Array(r.length).fill(0),o=0;for(let e=0;e<n;e++)for(let n=0;n<t;n++){let s=e*t+n;if(!i||i[s]){for(let e=0;e<r.length;e++)a[e]+=r[e][s];o++}}return{bandSum:a,count:o}}async function W(e,t,n){return(await G(e,{geometry:t.geometry},p,n))?.flat()??[]}async function G(n,r,i,a){let o=n.spatialReference,{geometry:c}=r;if(c.type===`polyline`&&!c.spatialReference.equals(o)){let{projectExecute:t}=await import(`../../../geometry/operators/projectOperator.js`),n=t(c,o);if(n==null)throw new e(`read-pixels`,`failed to fetch pixels`);c=n}let l=await k(c.type===`polyline`?c.extent:c,o),u=c.type===`polyline`?c:l,d=await A(await E(n,a),{geometry:l,autoResample:!1,pixelSize:r?.pixelSize}),f=[],p=j(n,d,!0,a);for await(let e of p){if(!e.pixelBlock)continue;let{extent:n}=e,r=i(await s(e.pixelBlock,n,u),n);f.push(r),t(a)}return f}async function K(e,t){let{rasterJobHandler:n}=e,{pixelBlock:r}=e,{statistics:i,histograms:a}=n?await n.computeStatisticsHistograms({pixelBlock:r},t):v(r);return{statistics:i,histograms:a}}async function q(e,t){let{extent:n,fields:r,skipFactor:i,rasterJobHandler:a,pixelIdOffset:o,imageRowSize:s}=e,{pixelBlock:c}=e,l=r.map(({name:e})=>e),u=a?await a.convertPixelBlockToFeatures({pixelBlock:c,extent:n,fieldNames:l,skipFactor:i,pixelIdOffset:o,imageRowSize:s},t):f({pixelBlock:c,extent:n,fieldNames:l,skipFactor:i,pixelIdOffset:o,imageRowSize:s});return u?{fields:r,features:u}:void 0}function J(e){return`_rasterJobHandler`in e?e._rasterJobHandler:null}async function Y(e,t,n){let r=await E(e);t={...t,maxPixelCount:t.maxPixelCount??2**28};let i=await A(r,t);i.bandIds=t.bandIds?.length?t.bandIds:void 0,N(i,r.pixelType,t.maxPixelCount);let{width:a,height:o}=i;if(a<=w&&o<=w){let t=i.bandIds?.length?i.bandIds:void 0,{pixelBlock:r}=await e.fetchPixels(i.extent,a,o,{bandIds:t,interpolation:`nearest`,...n});return r}let s=[],c=j(e,i,!1,n);for await(let e of c)s.push(e.pixelBlock);if(!s.some(e=>e!=null))return null;let l=Math.ceil(a/w),d=Math.ceil(o/w),f={width:l*w,height:d*w},p,m=J(e);return p=m?(await m.mosaicAndTransform({srcPixelBlocks:s,srcMosaicSize:f,destDimension:f},{...n,transferPixelsToWorker:!0}))?.pixelBlock:u(s,f),p}async function X(t,n,r){if(!n.geometry)throw new e(`compute-statistics-histograms`,`geometry is required to fetch pixel feature set`);let{pixelSize:i,downsampleOnly:a,maxPixelCountForDownsample:o}=n,s=await E(t,r),u=D({rasterInfo:s,geometry:n.geometry,pixelSize:i,downsampleOnly:a,maxPixelCountForDownsample:o})?void 0:i,d=await Y(t,{...n,pixelSize:u},r);if(!d)throw new e(`compute-statistics-histograms`,`failed to get intersecting pixels`);let{valueAttributeFieldName:f}=n;f&&f.toLowerCase()!==`value`&&(d=l(d,s,f));let p=J(t),{transformType:m}=n;if(m){let e={lambda:n.lambda,shift:n.shift};d=p?await p.transformPixels({pixelBlock:d,transformType:m,transformParameters:e},{...r,transferPixelsToWorker:!0}):c(d,m,e)}let h=n.histogramSize??void 0;return p?await p.computeStatisticsHistograms({pixelBlock:d,histogramSize:h,includeSkewnessKurtosis:!0},{...r,transferPixelsToWorker:!0}):v(d,{histogramSize:h,includeSkewnessKurtosis:!0})}export{F as computeBoxStatistics,B as computeRasterAttributeTable,X as computeStatisticsHistograms,M as createPixelFeatureSetCursor,P as fetchPixelFeatureSet,V as identifyAveragePixelValue,W as readIntersectingPixels};
+import e from"../../../core/Error.js";import{throwIfAborted as t}from"../../../core/promiseUtils.js";import n from"../../../geometry/Extent.js";import r from"../../../geometry/Point.js";import{getByteCount as i}from"../formats/pixelRangeUtils.js";import{convertPixelSize as a,snapToRaster as o,clip as s}from"../functions/clipUtils.js";import{transformPixels as c}from"../functions/pixelTransformUtils.js";import{mapPixelValueToAttribute as l,mosaic as u,pixelIdFieldName as d,convertPixelBlockToFeatures as f,getValidPixels as p,countCategoricalPixels as m}from"../functions/pixelUtils.js";import{load as h,projectPolygon as g}from"../functions/rasterProjectionHelper.js";import{computeBoxStatistics as _,computeStatisticsHistograms as v}from"../functions/stretchUtils.js";import y from"../../support/Field.js";import b from"../../support/PixelBlock.js";import{getBandNames as x}from"../../../renderers/support/rasterRendererHelper.js";import S from"../../../rest/support/ImageIdentifyParameters.js";const C=2**30,w=2048,T=2**20;async function E(e,t){return e.type===`imagery`?await e.generateRasterInfo(e.rasterFunction,t):e.raster.rasterInfo}function D(e){let{rasterInfo:t,geometry:n,pixelSize:i,downsampleOnly:s=!1,maxPixelCountForDownsample:c}=e;if(!i)return!0;if(!s)return!1;let l=a(i,t.spatialReference);if(l.x+l.y<=t.pixelSize.x+t.pixelSize.y)return!0;if(c==null)return!1;let u=n?.type===`polyline`?n.extent:n??t.extent,d=new r({x:t.pixelSize.x,y:t.pixelSize.y,spatialReference:t.spatialReference}),f=o(t,u,d);return f.width*f.height<=c}function O(e){let t=[new y({name:d,alias:`Pixel ID`,type:`oid`})],{pixelType:n}=e,r=n===`f32`?`single`:n===`f64`?`double`:`integer`;return x(e).forEach(e=>{t.push(new y({name:e,alias:e,type:r}))}),t.map(e=>e.toJSON())}async function k(t,n){if(t.spatialReference.equals(n))return t;if(t.type===`polyline`){let{projectExecute:r}=await import(`../../../geometry/operators/projectOperator.js`),i=r(t,n);if(i==null)throw new e(`read-pixels`,`failed to project the geometry into the layer's spatial reference`);return i}if(t.type===`extent`||t.rings[0].length<20){let[{lengthExecute:e},{densifyExecute:r}]=await Promise.all([import(`../../../geometry/operators/lengthOperator.js`),import(`../../../geometry/operators/densifyOperator.js`)]),i=e(t,{unit:`meters`})/100;t=r(t,i,{unit:`meters`}),await h(),t=g(t,n)}return t}async function A(e,t,n=!1){let{spatialReference:i}=e,a=t?.geometry,s=await k(a??e.extent,i),c=s.type===`extent`?s:s.extent,l=a!=null&&(a.type!==`extent`||!a.spatialReference.equals(i))?s:void 0,u=new r({x:e.pixelSize.x,y:e.pixelSize.y,spatialReference:i}),d=!!t?.autoResample,f=d?u:t?.pixelSize??u,{extent:p,width:m,height:h}=o(e,c,f);if(!d)return{extent:p,clipGeometry:l,width:m,height:h,pixelSize:f};let g=e.storageInfo?.pyramidScalingFactor??2,{x:_,y:v}=f,y=t?.maxPixelCount??T;for(;m*h>y&&(!n||Math.max(m,h)>1024);)_*=g,v*=g,m/=g,h/=g;return m=Math.round(m),h=Math.round(h),{extent:p,clipGeometry:l,width:m,height:h,pixelSize:new r({x:_,y:v,spatialReference:i})}}async function*j(e,r,i=!1,a){let{extent:o,clipGeometry:c,width:l,height:u}=r,d=o.width/l,f=o.height/u,p=Math.ceil(l/w),m=Math.ceil(u/w),h=d*w,g=f*w,{xmin:_,xmax:v,ymin:y,ymax:b}=o,x=m*p,S={bandIds:r.bandIds?.length?r.bandIds:void 0,interpolation:`nearest`,...a};for(let a=0;a<m;a++)for(let l=0;l<p;l++){t(S);let u=new n({xmin:_+l*h,xmax:i?Math.min(v,_+(l+1)*h):_+(l+1)*h,ymax:b-a*g,ymin:i?Math.max(y,b-(a+1)*g):b-(a+1)*g,spatialReference:o.spatialReference}),m={row:a,col:l},C=a*p+l+1;if(c&&!u.intersects(c)){yield{extent:u,pixelBlock:null,id:m,total:x,current:C};continue}let T=i?Math.round(u.width/d):w,E=i?Math.round(u.height/f):w,{pixelBlock:D}=await e.fetchPixels(u,T,E,S).catch(()=>({pixelBlock:void 0}));D&&c&&(D=await s(D,u,c,{thinPolyline:r?.thinPolyline??!1})),yield{extent:u,pixelBlock:D,id:m,total:x,current:C}}}async function*M(e,n,r){let i=await E(e,r),a=O(i),o=j(e,await A(i,{...n,geometry:n?.geometry??i.extent}),!0,r),s=i.width;for await(let c of o){if(!c.pixelBlock){yield{...c};continue}let o=J(e),{pixelBlock:l}=c,{statistics:u,histograms:d}=await K({pixelBlock:l,rasterJobHandler:o},r),f=c;f.statistics=u,f.histograms=d;let p=c.id.row*i.width*w+c.id.col*w;t(r),f.featureSet=await q({pixelBlock:l,extent:c.extent,fields:a,skipFactor:n?.skipFactor??1,rasterJobHandler:o,pixelIdOffset:p,imageRowSize:s},r),t(r),yield f}}function N(t,n,r){let a=i(n),{width:o,height:s}=t;if(o*s*a>C)throw new e(`fetch-pixels`,`failed to fetch pixels as pixel byte count exceeds the 1GB limit`);if(r&&o*s>r)throw new e(`fetch-pixels`,`failed to fetch pixels as pixel count exceeds the ${r} limit`)}async function P(t,n,r){if(!n.geometry)throw new e(`fetch-pixels`,`geometry is required to fetch pixel feature set`);let i=await E(t),a=await A(i,n,!0);N(a,i.pixelType);let{extent:o,pixelSize:s}=a,c=Math.round(i.extent.width/s.x),l=O(i),u={fields:l,features:[]},d=u.features,{maxPixelCount:f}=n,p=!!n.autoResample&&f!=null&&a.width*a.height>f,m=p?1:n.skipFactor??1,h=a.width<=w||a.height<=w,g=j(t,a,m===1||h,r);for await(let e of g){if(!e.pixelBlock)continue;let n=J(t),a=Math.floor((i.extent.ymax-e.extent.ymax)/s.y)*c+Math.floor((e.extent.xmin-i.extent.xmin)/s.x),o=await q({pixelBlock:e.pixelBlock,extent:e.extent,fields:l,skipFactor:m,rasterJobHandler:n,pixelIdOffset:a,imageRowSize:c},r);if(o?.features?.length){let{features:e}=o,t=e.length;for(let n=0;n<t;n++){let t=e.pop();d.push(t)}}}if(p&&f){let e=f/(n.skipFactor??1)**2;if(d.length>e){let t=d.length/e,n=[...d],r=d.length-1;d.length=0;for(let i=0,a=0;i<e-1;i++){a+=t;let e=Math.round(a);e<r&&d.push(n[e])}}}return{extent:o,featureSet:u,pixelSize:s}}async function F(e,t,n){let{geometry:r}=t;if(r.type===`multipoint`)return I(e,r,n);if(r.type===`polyline`)return z(e,r,n);let i=await Y(e,{geometry:r},n);return i?_(i):null}async function I(e,t,n){let r=await E(e,n),i=t.points.map((e,n)=>t.getPoint(n)).map(t=>L(e,t,n)),a=(await Promise.all(i)).filter(e=>e!=null);if(a.length<=1)return R(a[0]);let o=a[0].map((e,t)=>a.map(e=>e[t]));return _(new b({pixels:o,pixelType:r.pixelType}))}async function L(e,t,n){if(e.type===`imagery`){let r=await e.identify(new S({geometry:t,returnCatalogItems:!1}),n).catch(()=>null);return r?.value==null||r.value.includes(`NoData`)?null:r.value.replaceAll(`, `,` `).split(` `).map(e=>Number(e))}return(await e.identify(t,n).catch(()=>null))?.value}function R(e){return e?.map(e=>({min:e,max:e,avg:e,median:e,quartile1:e,quartile3:e}))}async function z(e,t,n){let r=await W(e,{geometry:t},n),{bandCount:i,pixelType:a}=await E(e,n),o=Array(i).fill(0).map(()=>b.createEmptyBand(a,r.length)),s=0;for(let e=0;e<r.length;e++){let t=r[e];if(t.value!=null){s++;for(let n=0;n<i;n++)o[n][e]=t.value[n]}}return s!==r.length&&o.forEach((e,t)=>{o[t]=e.subarray(0,s)}),_(new b({pixels:o,pixelType:a}))}async function B(t,n,r){let i=await E(t,r);if(!i.attributeTable)return null;let a=i.attributeTable.clone(),o=a.fields.find(e=>e.name.toLowerCase()===`value`),s=a.fields.find(e=>e.name.toLowerCase()===`count`);if(!o)throw new e(`compute-attribute-table`,`Value field not found in attribute table`);s||(s=new y({name:`Count`,alias:`Count`,type:`double`}),a.fields.push(s),a.features.forEach(e=>{e.attributes[s.name]=0}));let{geometry:c,pixelSize:l,downsampleOnly:u,maxPixelCountForDownsample:d}=n,f=new Map;return await G(t,{geometry:c,pixelSize:D({rasterInfo:i,geometry:c,pixelSize:l,downsampleOnly:u,maxPixelCountForDownsample:d})?void 0:l},(e,t)=>m(e,f),r),a.features.forEach(e=>{let t=e.attributes[o.name];e.attributes[s.name]=f.get(t)??0}),a}async function V(e,t,n){let{geometry:r}=t;if(r.type===`point`)return L(e,r,n);if(r.type===`multipoint`){let t=r.points.map((e,t)=>r.getPoint(t)).map(t=>L(e,t,n)),i=(await Promise.all(t)).filter(e=>e!=null);return i.length===0?null:H(i).map(e=>e/i.length)}let i=(await G(e,{geometry:r},(e,t)=>U(e),n))?.filter(e=>e.count>0);if(!i?.length)return null;let a=H(i.map(e=>e.bandSum)),o=i.map(e=>e.count).reduce((e,t)=>e+t);return a.map(e=>e/o)}function H(e){return e.reduce((e,t)=>e.map((e,n)=>e+t[n]))}function U(e){let{width:t,height:n,pixels:r,mask:i}=e,a=Array(r.length).fill(0),o=0;for(let e=0;e<n;e++)for(let n=0;n<t;n++){let s=e*t+n;if(!i||i[s]){for(let e=0;e<r.length;e++)a[e]+=r[e][s];o++}}return{bandSum:a,count:o}}async function W(e,t,n){return(await G(e,{geometry:t.geometry},p,n))?.flat()??[]}async function G(n,r,i,a){let o=n.spatialReference,{geometry:c}=r;if(c.type===`polyline`&&!c.spatialReference.equals(o)){let{projectExecute:t}=await import(`../../../geometry/operators/projectOperator.js`),n=t(c,o);if(n==null)throw new e(`read-pixels`,`failed to fetch pixels`);c=n}let l=await k(c.type===`polyline`?c.extent:c,o),u=c.type===`polyline`?c:l,d=await A(await E(n,a),{geometry:l,autoResample:!1,pixelSize:r?.pixelSize}),f=[],p=j(n,d,!0,a);for await(let e of p){if(!e.pixelBlock)continue;let{extent:n}=e,r=i(await s(e.pixelBlock,n,u),n);f.push(r),t(a)}return f}async function K(e,t){let{rasterJobHandler:n}=e,{pixelBlock:r}=e,{statistics:i,histograms:a}=n?await n.computeStatisticsHistograms({pixelBlock:r},t):v(r);return{statistics:i,histograms:a}}async function q(e,t){let{extent:n,fields:r,skipFactor:i,rasterJobHandler:a,pixelIdOffset:o,imageRowSize:s}=e,{pixelBlock:c}=e,l=r.map(({name:e})=>e),u=a?await a.convertPixelBlockToFeatures({pixelBlock:c,extent:n,fieldNames:l,skipFactor:i,pixelIdOffset:o,imageRowSize:s},t):f({pixelBlock:c,extent:n,fieldNames:l,skipFactor:i,pixelIdOffset:o,imageRowSize:s});return u?{fields:r,features:u}:void 0}function J(e){return`_rasterJobHandler`in e?e._rasterJobHandler:null}async function Y(e,t,n){let r=await E(e);t={...t,maxPixelCount:t.maxPixelCount??2**28};let i=await A(r,t);i.bandIds=t.bandIds?.length?t.bandIds:void 0,N(i,r.pixelType,t.maxPixelCount);let{width:a,height:o}=i;if(a<=w&&o<=w){let t=i.bandIds?.length?i.bandIds:void 0,{pixelBlock:r}=await e.fetchPixels(i.extent,a,o,{bandIds:t,interpolation:`nearest`,...n});return r}let s=[],c=j(e,i,!1,n);for await(let e of c)s.push(e.pixelBlock);if(!s.some(e=>e!=null))return null;let l=Math.ceil(a/w),d=Math.ceil(o/w),f={width:l*w,height:d*w},p,m=J(e);return p=m?(await m.mosaicAndTransform({srcPixelBlocks:s,srcMosaicSize:f,destDimension:f},{...n,transferPixelsToWorker:!0}))?.pixelBlock:u(s,f),p}async function X(t,n,r){if(!n.geometry)throw new e(`compute-statistics-histograms`,`geometry is required to fetch pixel feature set`);let{pixelSize:i,downsampleOnly:a,maxPixelCountForDownsample:o}=n,s=await E(t,r),u=D({rasterInfo:s,geometry:n.geometry,pixelSize:i,downsampleOnly:a,maxPixelCountForDownsample:o})?void 0:i,d=await Y(t,{...n,pixelSize:u},r);if(!d)throw new e(`compute-statistics-histograms`,`failed to get intersecting pixels`);let{valueAttributeFieldName:f}=n;f&&f.toLowerCase()!==`value`&&(d=l(d,s,f));let p=J(t),{transformType:m}=n;if(m){let e={lambda:n.lambda,shift:n.shift};d=p?await p.transformPixels({pixelBlock:d,transformType:m,transformParameters:e},{...r,transferPixelsToWorker:!0}):c(d,m,e)}let h=n.histogramSize??void 0;return p?await p.computeStatisticsHistograms({pixelBlock:d,histogramSize:h,includeSkewnessKurtosis:!0},{...r,transferPixelsToWorker:!0}):v(d,{histogramSize:h,includeSkewnessKurtosis:!0})}export{F as computeBoxStatistics,B as computeRasterAttributeTable,X as computeStatisticsHistograms,M as createPixelFeatureSetCursor,P as fetchPixelFeatureSet,V as identifyAveragePixelValue,W as readIntersectingPixels};

package/layers/raster/functions/clipUtils.js

@@ -1,2 +1,2 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/6.0/LICENSE.txt */
-import{getMetersPerUnitForSR as e}from"../../../core/units.js";import t from"../../../geometry/Extent.js";import n from"../../../geometry/Point.js";import r from"../../support/PixelBlock.js";function i(t,n){if(t.spatialReference.equals(n))return t;let r=e(t.spatialReference),i=e(n);if(r===i)return t;let a=r/i;return{x:t.x*a,y:t.y*a}}async function a(e,t,n){if(n.type===`extent`)return l(e,t,n);let{width:i,height:a}=e,s=i*a,c=new Uint8Array(s),{intersectsExecute:d}=await import(`../../../geometry/operators/intersectsOperator.js`);if(!d(t,n))return new r({pixelType:e.pixelType,width:i,height:a,mask:c,maskIsAlpha:!1,pixels:[...e.pixels]});if(n.type===`polyline`)return u(e,t,n);let{containsExecute:f}=await import(`../../../geometry/operators/containsOperator.js`);return f(n,t)?e:o(e,t,n)}function o(e,t,n){if(!e)return e;let{width:i,height:a}=e,o=s({geometry:n,size:[i,a],srcExtent:t,srcMask:e.mask});return new r({pixelType:e.pixelType,width:i,height:a,mask:o,maskIsAlpha:!1,pixels:[...e.pixels]})}function s(e){let{geometry:t,size:n,srcExtent:r,srcMask:i}=e,[a,o]=n,s,l=r.width/a,u=r.height/o,{xmin:d,ymax:f}=r;if(t.type===`extent`){let e=(t.xmin-d)/l,n=(t.xmax-d)/l,r=(f-t.ymax)/u,i=(f-t.ymin)/u;s=[[[e,r],[e,i],[n,i],[n,r],[e,r]]]}else s=t.rings.map(e=>e.map(([e,t])=>[(e-d)/l,(f-t)/u]));return c(s,n,i)}function c(e,t,n){let[r,i]=t,a=new OffscreenCanvas(r,i).getContext(`2d`);a.fillStyle=`#f00`,a.beginPath(),e.forEach(e=>{a.moveTo(e[0][0],e[0][1]);for(let t=0;t<e.length;t++)a.lineTo(e[t][0],e[t][1]);a.closePath()}),a.fill();let o=a.getImageData(0,0,r,i).data,s=r*i,c=new Uint8Array(s),l=!1;for(let e=0;e<s;e++)(!n||n[e])&&(o[e*4+3]>127?c[e]=255:l=!0);return l||n?c:void 0}function l(e,t,n){let{width:i,height:a}=e,o=new Uint8Array(i*a),s=t.width/i,c=t.height/a;if(n.width/s<.5||n.height/c<.5)return new r({pixelType:e.pixelType,width:i,height:a,mask:o,pixels:[...e.pixels]});let{xmin:l,xmax:u,ymin:d,ymax:f}=t,{xmin:p,xmax:m,ymin:h,ymax:g}=n,_=Math.max(l,p),v=Math.min(u,m),y=Math.max(d,h),b=Math.min(f,g),x=s*.5,S=c*.5;if(v-_<x||b-y<S||v<l+x||_>u-x||y>f-S||b<d+S)return new r({pixelType:e.pixelType,width:i,height:a,mask:o,pixels:[...e.pixels]});let C=Math.max(0,(_-l)/s),w=Math.min(i,Math.max(0,(v-l)/s)),T=Math.max(0,(f-b)/c),E=Math.min(a,Math.max(0,(f-y)/c)),D=Math.round(C),O=Math.round(w)-1,k=Math.round(T),A=Math.round(E)-1,j=D===O&&C%1>.5&&w%1<.5,M=k===A&&T%1>.5&&E%1<.5;if(j||M)return new r({pixelType:e.pixelType,width:i,height:a,mask:o,pixels:[...e.pixels]});if(D===0&&k===0&&O===i&&A===a)return e;let N=e.mask;for(let e=k;e<=A;e++)for(let t=D;t<=O;t++){let n=e*i+t;o[n]=N?N[n]:255}return new r({pixelType:e.pixelType,width:i,height:a,mask:o,pixels:[...e.pixels]})}function u(e,t,n){let{width:i,height:a}=e,o=new Uint8Array(i*a),s=t.width/i,c=t.height/a,{xmin:l,ymax:u}=t,{paths:d}=n,f=e.mask;for(let e=0;e<d.length;e++){let t=d[e];for(let e=0;e<t.length-1;e++){let[n,r]=t[e],[d,p]=t[e+1],m=Math.min(r,p),h=Math.max(0,Math.floor((u-Math.max(r,p))/c)),g=Math.min(a-1,Math.floor((u-m)/c));if(!(g<h)){if(h===g){let e=Math.min(n,d),t=Math.max(n,d),r=Math.max(0,Math.floor((e-l)/s)),a=Math.min(i-1,Math.floor((t-l)/s));if(a<r)continue;let c=h*i;for(let e=c+r;e<=c+a;e++)o[e]=f?f[e]:255}else{let e=(d-n)/(p-r),t=(n-l)/s,a=e/s,m=c*a;for(let e=h;e<=g;e++){let n=a*(u-e*c-r)+t,s=Math.max(0,Math.floor(m>0?n-m:n)),l=Math.min(i-1,Math.floor(m>0?n:n-m));if(l<s)continue;let d=e*i;for(let e=d+s;e<=d+l;e++)o[e]=f?f[e]:255}}}}}return new r({pixelType:e.pixelType,width:i,height:a,mask:o,pixels:[...e.pixels]})}function d(e,t){let{extent:r}=f(e,t,new n({x:e.pixelSize.x,y:e.pixelSize.y,spatialReference:e.spatialReference})),{extent:i}=e.extent;if(r.xmax=Math.min(r.xmax,i.xmax),r.ymax=Math.min(r.ymax,i.ymax),r.xmin<r.xmax&&r.ymin<r.ymax){let{x:t,y:n}=e.pixelSize,i=Math.round(r.width/t),a=Math.round(r.height/n);e.extent=r,e.width=i,e.height=a}}function f(e,n,r,a=!0){let{spatialReference:o}=e,{x:s,y:c}=i(r,o),l,u,d,{xmin:f,xmax:p,ymax:m,ymin:h}=n.type===`extent`?n:n.extent,{xmin:g,ymax:_}=e.extent;return a?(f=g+(f>g?s*Math.round((f-g)/s):0),m=_-(m<_?c*Math.round((_-m)/c):0),p=g+(p>g?s*Math.round((p-g)/s):0),h=_-(h<_?c*Math.round((_-h)/c):0),l=new t({xmin:f,ymax:m,xmax:p,ymin:h,spatialReference:o}),u=Math.round(l.width/s),d=Math.round(l.height/c)):(u=Math.floor((p-f)/s+.8),d=Math.floor((m-h)/c+.8),f=g+(f>g?s*Math.floor((f-g)/s+.1):0),m=_-(m<_?c*Math.floor((_-m)/c+.1):0),p=f+u*s,h=m-d*c,l=new t({xmin:f,ymax:m,xmax:p,ymin:h,spatialReference:o})),{extent:l,width:u,height:d}}export{a as clip,d as clipRasterInfo,s as convertGeometryToMask,i as convertPixelSize,f as snapToRaster};
+import{getMetersPerUnitForSR as e}from"../../../core/units.js";import t from"../../../geometry/Extent.js";import n from"../../../geometry/Point.js";import r from"../../support/PixelBlock.js";function i(t,n){if(t.spatialReference.equals(n))return t;let r=e(t.spatialReference),i=e(n);if(r===i)return t;let a=r/i;return{x:t.x*a,y:t.y*a}}async function a(e,t,n,i){if(n.type===`extent`)return l(e,t,n);let{width:a,height:s}=e,c=a*s,d=new Uint8Array(c),{intersectsExecute:p}=await import(`../../../geometry/operators/intersectsOperator.js`);if(!p(t,n))return new r({pixelType:e.pixelType,width:a,height:s,mask:d,maskIsAlpha:!1,pixels:[...e.pixels]});if(n.type===`polyline`)return i?.thinPolyline?f(e,t,n):u(e,t,n);let{containsExecute:m}=await import(`../../../geometry/operators/containsOperator.js`);return m(n,t)?e:o(e,t,n)}function o(e,t,n){if(!e)return e;let{width:i,height:a}=e,o=s({geometry:n,size:[i,a],srcExtent:t,srcMask:e.mask});return new r({pixelType:e.pixelType,width:i,height:a,mask:o,maskIsAlpha:!1,pixels:[...e.pixels]})}function s(e){let{geometry:t,size:n,srcExtent:r,srcMask:i}=e,[a,o]=n,s,l=r.width/a,u=r.height/o,{xmin:d,ymax:f}=r;if(t.type===`extent`){let e=(t.xmin-d)/l,n=(t.xmax-d)/l,r=(f-t.ymax)/u,i=(f-t.ymin)/u;s=[[[e,r],[e,i],[n,i],[n,r],[e,r]]]}else s=t.rings.map(e=>e.map(([e,t])=>[(e-d)/l,(f-t)/u]));return c(s,n,i)}function c(e,t,n){let[r,i]=t,a=new OffscreenCanvas(r,i).getContext(`2d`);a.fillStyle=`#f00`,a.beginPath(),e.forEach(e=>{a.moveTo(e[0][0],e[0][1]);for(let t=0;t<e.length;t++)a.lineTo(e[t][0],e[t][1]);a.closePath()}),a.fill();let o=a.getImageData(0,0,r,i).data,s=r*i,c=new Uint8Array(s),l=!1;for(let e=0;e<s;e++)(!n||n[e])&&(o[e*4+3]>127?c[e]=255:l=!0);return l||n?c:void 0}function l(e,t,n){let{width:i,height:a}=e,o=new Uint8Array(i*a),s=t.width/i,c=t.height/a;if(n.width/s<.5||n.height/c<.5)return new r({pixelType:e.pixelType,width:i,height:a,mask:o,pixels:[...e.pixels]});let{xmin:l,xmax:u,ymin:d,ymax:f}=t,{xmin:p,xmax:m,ymin:h,ymax:g}=n,_=Math.max(l,p),v=Math.min(u,m),y=Math.max(d,h),b=Math.min(f,g),x=s*.5,S=c*.5;if(v-_<x||b-y<S||v<l+x||_>u-x||y>f-S||b<d+S)return new r({pixelType:e.pixelType,width:i,height:a,mask:o,pixels:[...e.pixels]});let C=Math.max(0,(_-l)/s),w=Math.min(i,Math.max(0,(v-l)/s)),T=Math.max(0,(f-b)/c),E=Math.min(a,Math.max(0,(f-y)/c)),D=Math.round(C),O=Math.round(w)-1,k=Math.round(T),A=Math.round(E)-1,j=D===O&&C%1>.5&&w%1<.5,M=k===A&&T%1>.5&&E%1<.5;if(j||M)return new r({pixelType:e.pixelType,width:i,height:a,mask:o,pixels:[...e.pixels]});if(D===0&&k===0&&O===i&&A===a)return e;let N=e.mask;for(let e=k;e<=A;e++)for(let t=D;t<=O;t++){let n=e*i+t;o[n]=N?N[n]:255}return new r({pixelType:e.pixelType,width:i,height:a,mask:o,pixels:[...e.pixels]})}function u(e,t,n){let{width:i,height:a}=e,o=new Uint8Array(i*a),s=t.width/i,c=t.height/a,{xmin:l,ymax:u}=t,{paths:d}=n,f=e.mask;for(let e=0;e<d.length;e++){let t=d[e];for(let e=0;e<t.length-1;e++){let[n,r]=t[e],[d,p]=t[e+1],m=Math.min(r,p),h=Math.max(r,p),g=Math.max(0,Math.floor((u-h)/c)),_=Math.min(a-1,Math.floor((u-m)/c));if(!(_<g)){if(r===p){let e=Math.min(n,d),t=Math.max(n,d),r=Math.max(0,Math.floor((e-l)/s)),a=Math.min(i-1,Math.floor((t-l)/s));if(a<r)continue;let c=g*i;for(let e=c+r;e<=c+a;e++)o[e]=f?f[e]:255}else{let e=(d-n)/(p-r),t=(n-l)/s,a=e/s;for(let e=g;e<=_;e++){let n=Math.min(h,u-e*c),s=Math.max(m,u-(e+1)*c),l=a*(n-r)+t,d=a*(s-r)+t,p=Math.max(0,Math.floor(Math.min(l,d))),g=Math.min(i-1,Math.floor(Math.max(l,d)));if(g<p)continue;let _=e*i;for(let e=_+p;e<=_+g;e++)o[e]=f?f[e]:255}}}}}return new r({pixelType:e.pixelType,width:i,height:a,mask:o,maskIsAlpha:e.maskIsAlpha,pixels:[...e.pixels]})}function d(e){let{size:t,start:n,end:r,outMask:i,srcMask:a}=e,[o,s]=t,[c,l]=n,[u,d]=r;if(Math.max(c,u)<=0||Math.min(c,u)>=o||Math.max(l,d)<=0||Math.min(l,d)>=s)return;let f=Math.abs(u-c),p=Math.abs(d-l);if(f===0&&p===0){let e=Math.floor(c),t=Math.floor(l)*o+e;i[t]=a?a[t]:255;return}let m=p>f;m&&([c,l]=[l,c],[u,d]=[d,u],[f,p]=[p,f],[o,s]=[s,o]),c>u&&([c,u]=[u,c],[l,d]=[d,l]);let h=Math.max(0,Math.floor(c)),g=Math.min(o-1,Math.floor(u)),_=l<=d?1:-1,v=Math.floor(Math.min(l,d)),y=Math.floor(Math.max(l,d)),b=p/f,x=l+(h+.5-c)*_*b,S=_>0?Math.floor(x):Math.ceil(x)-1,C=_>0?x-S:S+1-x;for(let e=h;e<=g;e++){let t=Math.max(v,Math.min(y,S));if(t>=0&&t<s){let n=m?e*s+t:t*o+e;i[n]=a?a[n]:255}C+=b,C>=1&&(S+=_,--C)}}function f(e,t,n){let{width:i,height:a,mask:o}=e,s=new Uint8Array(i*a),c=t.width/i,l=t.height/a,{xmin:u,ymax:f}=t,p=[i,a];for(let e of n.paths)for(let t=0;t<e.length-1;t++){let[n,r]=e[t],[i,a]=e[t+1];d({size:p,start:[(n-u)/c,(f-r)/l],end:[(i-u)/c,(f-a)/l],srcMask:o,outMask:s})}return new r({pixelType:e.pixelType,width:i,height:a,mask:s,maskIsAlpha:e.maskIsAlpha,pixels:[...e.pixels]})}function p(e,t){let{extent:r}=m(e,t,new n({x:e.pixelSize.x,y:e.pixelSize.y,spatialReference:e.spatialReference})),{extent:i}=e.extent;if(r.xmax=Math.min(r.xmax,i.xmax),r.ymax=Math.min(r.ymax,i.ymax),r.xmin<r.xmax&&r.ymin<r.ymax){let{x:t,y:n}=e.pixelSize,i=Math.round(r.width/t),a=Math.round(r.height/n);e.extent=r,e.width=i,e.height=a}}function m(e,n,r,a=!0){let{spatialReference:o}=e,{x:s,y:c}=i(r,o),l,u,d,{xmin:f,xmax:p,ymax:m,ymin:h}=n.type===`extent`?n:n.extent,{xmin:g,ymax:_}=e.extent;return a?(f=g+(f>g?s*Math.round((f-g)/s):0),m=_-(m<_?c*Math.round((_-m)/c):0),p=g+(p>g?s*Math.round((p-g)/s):0),h=_-(h<_?c*Math.round((_-h)/c):0),l=new t({xmin:f,ymax:m,xmax:p,ymin:h,spatialReference:o}),u=Math.round(l.width/s),d=Math.round(l.height/c)):(u=Math.floor((p-f)/s+.8),d=Math.floor((m-h)/c+.8),f=g+(f>g?s*Math.floor((f-g)/s+.1):0),m=_-(m<_?c*Math.floor((_-m)/c+.1):0),p=f+u*s,h=m-d*c,l=new t({xmin:f,ymax:m,xmax:p,ymin:h,spatialReference:o})),{extent:l,width:u,height:d}}export{a as clip,p as clipRasterInfo,s as convertGeometryToMask,i as convertPixelSize,d as rasterizeLineBresenham,m as snapToRaster};

package/layers/support/FeatureFilter.d.ts

@@ -323,7 +323,7 @@ export default class FeatureFilter extends JSONSupport {
    * Creates [Query](https://developers.arcgis.com/javascript/latest/references/core/rest/support/Query/) parameters that can be used to fetch features that
    * satisfy the layer's current filters and definitions.
    *
-   * @returns The query object representing the layer's filters
+   * @returns The query parameter object representing the layer's filters
    * and other definitions.
    * @example
    * // Get a query object from the filter's current configuration

package/layers/support/SubtypeSublayer.d.ts

@@ -784,7 +784,7 @@ export default class SubtypeSublayer extends SubtypeSublayerSuperclass {
    * Creates query parameters that can be used to fetch features that
    * satisfy the layer's current filters, and definitions.
    *
-   * @returns The query object representing the layer's definition expression
+   * @returns The query parameter object representing the layer's definition expression
    * and other configurations.
    * @example
    * // this snippet shows the query parameter object that is returned

package/layers/support/{TimeSeriesCalculation.d.ts → TimeSeriesCalculationMethod.d.ts}

@@ -1,7 +1,7 @@
 import type { ClonableMixin } from "../../core/Clonable.js";
 import type { JSONSupport } from "../../core/JSONSupport.js";
 
-export interface TimeSeriesCalculationProperties extends Partial<Pick<TimeSeriesCalculation, "name" | "title" | "type">> {}
+export interface TimeSeriesCalculationMethodProperties extends Partial<Pick<TimeSeriesCalculationMethod, "name" | "title" | "type">> {}
 
 /**
  * The calculation method by which to derive a data value for a time series. By default,
@@ -9,15 +9,15 @@ export interface TimeSeriesCalculationProperties extends Partial<Pick<TimeSeries
  *
  * @since 5.2
  */
-export type TimeSeriesCalculationMethod = "change-from-average" | "change-from-first" | "change-from-previous" | "percent-change-from-average" | "percent-change-from-first" | "percent-change-from-previous";
+export type TimeSeriesCalculationMethodType = "change-from-average" | "change-from-first" | "change-from-previous" | "percent-change-from-average" | "percent-change-from-first" | "percent-change-from-previous";
 
 /**
  * Defines a calculation method that can be used to derive data values for a time series.
  *
  * @since 5.2
  */
-export default class TimeSeriesCalculation extends TimeSeriesCalculationSuperclass {
-  constructor(properties?: TimeSeriesCalculationProperties);
+export default class TimeSeriesCalculationMethod extends TimeSeriesCalculationMethodSuperclass {
+  constructor(properties?: TimeSeriesCalculationMethodProperties);
   /**
    * A unique identifier for the calculation method within the time series.
    *
@@ -27,6 +27,6 @@ export default class TimeSeriesCalculation extends TimeSeriesCalculationSupercla
   /** A user-friendly name for the calculation method. */
   accessor title: string | null | undefined;
   /** The method by which to calculate a time series data value. */
-  accessor type: TimeSeriesCalculationMethod | null | undefined;
+  accessor type: TimeSeriesCalculationMethodType | null | undefined;
 }
-declare const TimeSeriesCalculationSuperclass: typeof JSONSupport & typeof ClonableMixin
+declare const TimeSeriesCalculationMethodSuperclass: typeof JSONSupport & typeof ClonableMixin

package/layers/support/{TimeSeriesCalculation.js → TimeSeriesCalculationMethod.js}

@@ -1,2 +1,2 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/6.0/LICENSE.txt */
-import{__decorate as e}from"tslib";import{ClonableMixin as t}from"../../core/Clonable.js";import{JSONSupport as n}from"../../core/JSONSupport.js";import{property as r,subclass as i}from"../../core/accessorSupport/decorators.js";let a=class extends t(n){constructor(e){super(e),this.name=null,this.type=null,this.title=null}};e([r({type:String,json:{write:{isRequired:!0}}})],a.prototype,`name`,void 0),e([r({type:[`change-from-average`,`change-from-first`,`change-from-previous`,`percent-change-from-average`,`percent-change-from-first`,`percent-change-from-previous`],json:{write:{isRequired:!0}}})],a.prototype,`type`,void 0),e([r({type:String,json:{write:!0}})],a.prototype,`title`,void 0),a=e([i(`esri.layers.support.TimeSeriesCalculation`)],a);const o=a;export{o as default};
+import{__decorate as e}from"tslib";import{ClonableMixin as t}from"../../core/Clonable.js";import{JSONSupport as n}from"../../core/JSONSupport.js";import{property as r,subclass as i}from"../../core/accessorSupport/decorators.js";let a=class extends t(n){constructor(e){super(e),this.name=null,this.type=null,this.title=null}};e([r({type:String,json:{write:{isRequired:!0}}})],a.prototype,`name`,void 0),e([r({type:[`change-from-average`,`change-from-first`,`change-from-previous`,`percent-change-from-average`,`percent-change-from-first`,`percent-change-from-previous`],json:{write:{isRequired:!0}}})],a.prototype,`type`,void 0),e([r({type:String,json:{write:!0}})],a.prototype,`title`,void 0),a=e([i(`esri.layers.support.TimeSeriesCalculationMethod`)],a);const o=a;export{o as default};

package/layers/support/TimeSeriesInfo.d.ts

@@ -1,11 +1,11 @@
-import type TimeSeriesCalculation from "./TimeSeriesCalculation.js";
+import type TimeSeriesCalculationMethod from "./TimeSeriesCalculationMethod.js";
 import type TimeSeriesFieldTimeMapping from "./TimeSeriesFieldTimeMapping.js";
 import type TimeExtent from "../../time/TimeExtent.js";
 import type { ClonableMixin } from "../../core/Clonable.js";
 import type { JSONSupport } from "../../core/JSONSupport.js";
 import type { TimeSeriesFieldTimeMappingProperties } from "./TimeSeriesFieldTimeMapping.js";
 import type { TimeExtentProperties } from "../../time/TimeExtent.js";
-import type { TimeSeriesCalculationProperties } from "./TimeSeriesCalculation.js";
+import type { TimeSeriesCalculationMethodProperties } from "./TimeSeriesCalculationMethod.js";
 
 /** @since 5.1 */
 export interface TimeSeriesInfoProperties extends Partial<Pick<TimeSeriesInfo, "name" | "timeInterval" | "timeIntervalUnits" | "timeValueUnits" | "title">> {
@@ -16,7 +16,7 @@ export interface TimeSeriesInfoProperties extends Partial<Pick<TimeSeriesInfo, "
    * @default null
    * @since 5.2
    */
-  calculationMethods?: TimeSeriesCalculationProperties[] | null;
+  calculationMethods?: TimeSeriesCalculationMethodProperties[] | null;
   /** The mapping between field names and time values for the time series configuration. */
   fieldTimeMappings?: TimeSeriesFieldTimeMappingProperties[] | null;
   /**
@@ -113,8 +113,8 @@ export default class TimeSeriesInfo extends TimeSeriesInfoSuperclass {
    * @default null
    * @since 5.2
    */
-  get calculationMethods(): TimeSeriesCalculation[] | null | undefined;
-  set calculationMethods(value: TimeSeriesCalculationProperties[] | null | undefined);
+  get calculationMethods(): TimeSeriesCalculationMethod[] | null | undefined;
+  set calculationMethods(value: TimeSeriesCalculationMethodProperties[] | null | undefined);
   /** The mapping between field names and time values for the time series configuration. */
   get fieldTimeMappings(): TimeSeriesFieldTimeMapping[] | null | undefined;
   set fieldTimeMappings(value: TimeSeriesFieldTimeMappingProperties[] | null | undefined);

package/layers/support/TimeSeriesInfo.js

@@ -1,2 +1,2 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/6.0/LICENSE.txt */
-import{__decorate as e}from"tslib";import{ClonableMixin as t}from"../../core/Clonable.js";import{JSONSupport as n}from"../../core/JSONSupport.js";import{property as r,subclass as i}from"../../core/accessorSupport/decorators.js";import a from"./TimeSeriesCalculation.js";import o from"./TimeSeriesFieldTimeMapping.js";import s from"../../time/TimeExtent.js";let c=class extends t(n){constructor(e){super(e),this.name=null,this.fieldTimeMappings=null,this.timeExtent=null,this.timeInterval=null,this.timeIntervalUnits=null,this.timeValueUnits=null,this.title=null,this.calculationMethods=null,this.type=`time-series-fields`}};e([r({type:String,json:{write:{isRequired:!0}}})],c.prototype,`name`,void 0),e([r({type:[o],json:{write:{isRequired:!0}}})],c.prototype,`fieldTimeMappings`,void 0),e([r({type:s,json:{write:!0}})],c.prototype,`timeExtent`,void 0),e([r({type:Number,json:{write:{isRequired:!0}}})],c.prototype,`timeInterval`,void 0),e([r({type:String,json:{write:{isRequired:!0}}})],c.prototype,`timeIntervalUnits`,void 0),e([r({type:String,json:{write:{isRequired:!0}}})],c.prototype,`timeValueUnits`,void 0),e([r({type:String,json:{write:!0}})],c.prototype,`title`,void 0),e([r({type:[a],json:{write:!0}})],c.prototype,`calculationMethods`,void 0),e([r({type:String,readOnly:!0,json:{write:{isRequired:!0}}})],c.prototype,`type`,void 0),c=e([i(`esri.layers.support.TimeSeriesInfo`)],c);export{c as default};
+import{__decorate as e}from"tslib";import{ClonableMixin as t}from"../../core/Clonable.js";import{JSONSupport as n}from"../../core/JSONSupport.js";import{property as r,subclass as i}from"../../core/accessorSupport/decorators.js";import a from"./TimeSeriesCalculationMethod.js";import o from"./TimeSeriesFieldTimeMapping.js";import s from"../../time/TimeExtent.js";let c=class extends t(n){constructor(e){super(e),this.name=null,this.fieldTimeMappings=null,this.timeExtent=null,this.timeInterval=null,this.timeIntervalUnits=null,this.timeValueUnits=null,this.title=null,this.calculationMethods=null,this.type=`time-series-fields`}};e([r({type:String,json:{write:{isRequired:!0}}})],c.prototype,`name`,void 0),e([r({type:[o],json:{write:{isRequired:!0}}})],c.prototype,`fieldTimeMappings`,void 0),e([r({type:s,json:{write:!0}})],c.prototype,`timeExtent`,void 0),e([r({type:Number,json:{write:{isRequired:!0}}})],c.prototype,`timeInterval`,void 0),e([r({type:String,json:{write:{isRequired:!0}}})],c.prototype,`timeIntervalUnits`,void 0),e([r({type:String,json:{write:{isRequired:!0}}})],c.prototype,`timeValueUnits`,void 0),e([r({type:String,json:{write:!0}})],c.prototype,`title`,void 0),e([r({type:[a],json:{write:!0}})],c.prototype,`calculationMethods`,void 0),e([r({type:String,readOnly:!0,json:{write:{isRequired:!0}}})],c.prototype,`type`,void 0),c=e([i(`esri.layers.support.TimeSeriesInfo`)],c);export{c as default};

package/layers/support/fieldUtils.js

@@ -1,2 +1,2 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/6.0/LICENSE.txt */
-import e from"../../core/Error.js";import{getDeepValue as t,setDeepValue as n}from"../../core/object.js";import{union as r}from"../../core/SetUtils.js";import{parseWhereClause as i}from"../../core/sql.js";import{DomainValidationError as a,getDomainRange as o}from"./domainUtils.js";import{getFieldNameFromSimpleExpression as s}from"../../support/arcadeExpressionUtils.js";import{isStringOrNull as ee,isString as te}from"../../support/guards.js";import{loadArcade as ne}from"../../support/loadArcade.js";const re=/^([0-9_])/,ie=/[^a-z0-9_\u0080-\uffff]+/gi;function c(e){return e==null?null:e.trim().replaceAll(ie,`_`).replace(re,`F$1`)||null}const l=[`field`,`field2`,`field3`,`normalizationField`,`rotationInfo.field`,`proportionalSymbolInfo.field`,`proportionalSymbolInfo.normalizationField`,`colorInfo.field`,`colorInfo.normalizationField`],u=[`field`,`normalizationField`];function ae(e,t){if(e!=null&&t!=null){for(let n of Array.isArray(e)?e:[e])if(d(l,n,t),`visualVariables`in n&&n.visualVariables)for(let e of n.visualVariables)d(u,e,t)}}function d(e,r,i){if(e)for(let a of e){let e=t(a,r),o=e&&typeof e!=`function`&&i.get(e);o&&n(a,o.name,r)}}function oe(e,t){if(e!=null&&t?.fields?.length){if(`startField`in e){let n=t.get(e.startField),r=t.get(e.endField);e.startField=n?.name??null,e.endField=r?.name??null}else{let n=t.get(e.startTimeField),r=t.get(e.endTimeField);e.startTimeField=n?.name??null,e.endTimeField=r?.name??null}e.trackIdField=t.get(e.trackIdField)?.name??null}}const f=new Set;function p(e,t){return!e||!t?[]:(f.clear(),m(f,e,t),Array.from(f).sort())}function m(e,t,n){if(n){if(!t?.fields?.length){if(n.includes(`*`)){e.clear(),e.add(`*`);return}for(let t of n)t!=null&&e.add(t)}else if(n.includes(`*`))for(let{name:n}of t.fields)e.add(n);else for(let r of n)h(e,t,r)}}function h(e,t,n){if(typeof n==`string`){if(t){let r=t.get(n);r&&e.add(r.name)}else e.add(n)}}function se(e,t){return t==null||e==null?[]:t.includes(`*`)?(e.fields??[]).map(e=>e.name):t}function ce(e,t,n=1){if(!t||!e)return[];if(t.includes(`*`))return[`*`];let r=p(e,t);return r.length/e.fields.length>=n?[`*`]:r}async function g(e,t,n,r){if(!r)return;let i=s(r);if(i)h(e,t,i);else{let{arcadeUtils:i}=await ne(),a=i.extractFieldNames(r,n?.partitions??t?.fields?.map(e=>e.name));for(let r of a)h(e,n?.index??t,r)}}async function _(t,n,r){if(r&&r!==`1=1`){let a=await i(r,n);if(!a.isStandardized)throw new e(`fieldUtils:collectFilterFields`,`Where clause is not standardized`,{where:r});m(t,n,a.fieldNames)}}function le({displayField:e,fields:t}){return e||(t?.length?v(t):null)}function v(e){return y(e,`name-or-title`)||y(e,`unique-identifier`)||y(e,`type-or-category`)||ue(e)}function ue(e){for(let t of e){if(!t?.name)continue;let e=t.name.toLowerCase();if(e.includes(`name`)||e.includes(`title`))return t.name}return null}function y(e,t){for(let n of e)if(n?.valueType&&n.valueType===t)return n.name;return null}async function de(e){if(!e)return[];let t=new Set;return await b(t,e),Array.from(t).sort()}async function b(e,t){if(!t)return;let n=t.elevationInfo?.featureExpressionInfo;if(n)return n.collectRequiredFields(e,t.fieldsIndex)}function fe(e,t,n){n.onStatisticExpression?g(e,t,null,n.onStatisticExpression.expression):e.add(n.onStatisticField)}async function pe(e,t,n){if(!t||!n||!(`fields`in n))return;let r=[],i=n.popupTemplate;r.push(x(e,t,i)),n.fields&&r.push(...n.fields.map(async n=>fe(e,t.fieldsIndex,n))),await Promise.all(r)}async function me(e,t){let{fieldsIndex:n,trackInfo:r}=t;if(!t||!r||!n)return;let i=[r.latestObservations.renderer?.collectRequiredFields(e,n),r.previousObservations.renderer?.collectRequiredFields(e,n),r.trackLines.renderer?.collectRequiredFields(e,n)];r.popupTemplate&&i.push(x(e,t,r.popupTemplate));for(let t of[r.latestObservations.labelingInfo,r.previousObservations.labelingInfo,r.trackLines.labelingInfo])if(t)for(let r of t)i.push(O(e,n,r));await Promise.all(i)}async function x(e,t,n){let r=[];n?.expressionInfos&&r.push(...n.expressionInfos.map(n=>g(e,t.fieldsIndex,null,n.expression)));let i=n?.content;if(Array.isArray(i))for(let n of i)n.type===`expression`&&n.expressionInfo&&r.push(g(e,t.fieldsIndex,null,n.expressionInfo.expression));await Promise.all(r)}async function he(e,t,n){t&&(t.timeInfo&&n?.timeExtent&&m(e,t.fieldsIndex,[t.timeInfo.startField,t.timeInfo.endField]),t.floorInfo&&m(e,t.fieldsIndex,[t.floorInfo.floorField]),n?.where!=null&&await _(e,t.fieldsIndex,n.where))}async function ge(e,t,n){t&&n&&await Promise.all(n.map(n=>_e(e,t,n)))}async function _e(e,t,n){t&&n&&(n.valueExpression?await g(e,t.fieldsIndex,null,n.valueExpression):n.field&&h(e,t.fieldsIndex,n.field))}async function ve(e){if(!e)return[];let t=`timeInfo`in e&&e.timeInfo;return t?p(e.fieldsIndex,[e.trackIdField,t.startField,t.endField]):[]}function ye(e){return e?p(e.fieldsIndex,w(e)):[]}function S(e){if(!e)return[];let t=e.geometryFieldsInfo;return t?p(e.fieldsIndex,[t.shapeAreaField,t.shapeLengthField]):[]}async function be(e,t,n){if(!t||!n)return;let r=t.fieldsIndex;await Promise.all(n.filters.map(t=>_(e,r,t.where)))}const xe=new Set([`oid`,`global-id`,`guid`]),Se=new Set([`oid`,`global-id`]),Ce=[/^fnode_$/i,/^tnode_$/i,/^lpoly_$/i,/^rpoly_$/i,/^poly_$/i,/^shape$/i,/^shape_$/i,/^subclass$/i,/^subclass_$/i,/^rings_ok$/i,/^rings_nok$/i,/objectid/i,/^perimeter_/i,/_perimeter$/i,/_i$/i];function C(e){let t=new Set;T(e).forEach(e=>t.add(e)),S(e).forEach(e=>t.add(e.toLowerCase()));let n=e&&`infoFor3D`in e?e.infoFor3D:void 0;return n&&(Object.values(n.assetMapFieldRoles).forEach(e=>t.add(e.toLowerCase())),Object.values(n.transformFieldRoles).forEach(e=>t.add(e.toLowerCase()))),Array.from(t)}function w(e){if(!e)return[];let t=`editFieldsInfo`in e&&e.editFieldsInfo;if(!t)return[];let{creationDateField:n,creatorField:r,editDateField:i,editorField:a}=t;return[n,r,i,a].filter(Boolean)}function T(e){return w(e).map(e=>e.toLowerCase())}function E(e){return!!e.type}function we(e,t){return!!e.editable&&E(e)&&!xe.has(e.type)&&!T(t).includes(e.name?.toLowerCase()??``)}function Te(e,t){let n=e.name?.toLowerCase()??``;return(t?.objectIdField==null||n!==t.objectIdField.toLowerCase())&&(t?.globalIdField==null||n!==t.globalIdField.toLowerCase())&&!C(t).includes(n)&&!Se.has(e.type)&&!Ce.some(e=>e.test(n))}async function Ee(e){if(!e)return[];let t=new Set;return await D(t,e),Array.from(t).sort()}async function D(e,t){let{labelingInfo:n,fieldsIndex:r}=t;n?.length&&await Promise.all(n.map(t=>O(e,r,t)))}async function O(e,t,n){if(!n)return;let r=n.getLabelExpression(),i=n.where;if(r.type===`arcade`)await g(e,t,null,r.expression);else{let n=r.expression.match(/{[^}]*}/g);n&&n.forEach(n=>{h(e,t,n.slice(1,-1))})}await _(e,t,i)}function De(e){let t=e.defaultValue;if(t!==void 0&&A(e,t))return t;if(e.nullable)return null}function Oe(e){let t=typeof e==`string`?{type:e}:e;if(L(t))return 255;if(t.type===`esriFieldTypeDate`||t.type===`date`)return 8}function k(e){return typeof e==`number`&&!isNaN(e)&&isFinite(e)}function ke(e){return e===null||k(e)}function Ae(e){return e===null||Number.isInteger(e)}function je(){return!0}function A(e,t){let n;switch(e.type){case`date`:case`integer`:case`long`:case`small-integer`:case`big-integer`:case`esriFieldTypeDate`:case`esriFieldTypeInteger`:case`esriFieldTypeLong`:case`esriFieldTypeSmallInteger`:case`esriFieldTypeBigInteger`:n=e.nullable?Ae:Number.isInteger;break;case`double`:case`single`:case`esriFieldTypeSingle`:case`esriFieldTypeDouble`:n=e.nullable?ke:k;break;case`string`:case`esriFieldTypeString`:n=e.nullable?ee:te;break;default:n=je}return arguments.length===1?n:n(t)}const j=[`integer`,`small-integer`,`big-integer`,`long`],M=[`single`,`double`],Me=[...j,...M],N=[`esriFieldTypeInteger`,`esriFieldTypeSmallInteger`,`esriFieldTypeLong`,`esriFieldTypeBigInteger`],P=[`esriFieldTypeSingle`,`esriFieldTypeDouble`],F=new Set([...j,...N]),Ne=new Set([...M,...P]),Pe=r(F,Ne);function Fe(e){return e!=null&&F.has(e.type)}function I(e){return e!=null&&Pe.has(e.type)}function L(e){return e!=null&&(e.type===`string`||e.type===`esriFieldTypeString`)}function R(e){return e!=null&&(e.type===`date`||e.type===`esriFieldTypeDate`)}function Ie(e){return e!=null&&(e.type===`date-only`||e.type===`esriFieldTypeDateOnly`)}function Le(e){return e!=null&&(e.type===`timestamp-offset`||e.type===`esriFieldTypeTimestampOffset`)}function Re(e){return e!=null&&(e.type===`time-only`||e.type===`esriFieldTypeTimeOnly`)}function ze(e){return e!=null&&(e.type===`date`||e.type===`date-only`||e.type===`time-only`||e.type===`timestamp-offset`)}function Be(e){return e!=null&&(e.type===`oid`||e.type===`esriFieldTypeOID`)}function Ve(e){return e!=null&&(e.type===`global-id`||e.type===`esriFieldTypeGlobalID`)}function He(e,t){return V(e,t)===null}const z={OUT_OF_RANGE:`numeric-range-validation-error::out-of-range`},B={INVALID_TYPE:`type-validation-error::invalid-type`};function Ue(e){return e==null||typeof e==`number`&&isNaN(e)?null:e}function We(e){return parseFloat(e.replaceAll(`_`,``))}function V(e,t){return e==null||e.nullable&&t===null?null:A(e,t)?I(e)&&!H(e.type,Number(t))?z.OUT_OF_RANGE:null:B.INVALID_TYPE}function H(e,t){let n=typeof e==`string`?U(e):e;if(!n)return!1;let r=n.min,i=n.max;return n.isInteger?Number.isInteger(t)&&t>=r&&t<=i:t>=r&&t<=i}function Ge(e,t){let n=o(e,t);if(n)return n;if(I(e))return U(e.type)}function U(e){switch(e){case`esriFieldTypeSmallInteger`:case`small-integer`:return W;case`esriFieldTypeInteger`:case`esriFieldTypeLong`:case`integer`:case`long`:return q;case`esriFieldTypeBigInteger`:case`big-integer`:return J;case`esriFieldTypeSingle`:case`single`:return X;case`esriFieldTypeDouble`:case`double`:return Z}}function Ke(e){if(!k(e))return null;if(Number.isInteger(e)){if(e>=W.min&&e<=W.max)return`esriFieldTypeSmallInteger`;if(e>=q.min&&e<=q.max)return`esriFieldTypeInteger`;if(e>=J.min&&e<=J.max)return`esriFieldTypeBigInteger`}return e>=X.min&&e<=X.max?`esriFieldTypeSingle`:`esriFieldTypeDouble`}const W={min:-32768,max:32767,isInteger:!0,rawMin:-32768,rawMax:32767},G=-2147483648,K=2**31-1,q={min:G,max:K,isInteger:!0,rawMin:G,rawMax:K},J={min:-(2**53-1),max:2**53-1,isInteger:!0,rawMin:-(2**53-1),rawMax:2**53-1},Y=(2-2**-23)*2**127,X={min:-Y,max:Y,isInteger:!1,rawMin:-Y,rawMax:Y},Z={min:-Number.MAX_VALUE,max:Number.MAX_VALUE,isInteger:!1,rawMin:-Number.MAX_VALUE,rawMax:Number.MAX_VALUE};function qe(e,t,n){switch(e){case a.INVALID_CODED_VALUE:return`Value ${n} is not in the coded domain - field: ${t.name}, domain: ${JSON.stringify(t.domain)}`;case a.VALUE_OUT_OF_RANGE:return`Value ${n} is out of the range of valid values - field: ${t.name}, domain: ${JSON.stringify(t.domain)}`;case B.INVALID_TYPE:return`Value ${n} is not a valid value for the field type - field: ${t.name}, type: ${t.type}, nullable: ${t.nullable}`;case z.OUT_OF_RANGE:{let{min:e,max:r}=U(t.type);return`Value ${n} is out of range for the number type - field: ${t.name}, type: ${t.type}, value range is ${e} to ${r}`}}}function Je(e,t){return!Q(e,t,null)}function Q(e,t,n){if(!e?.attributes||!t){if(n!=null)for(let e of t??[])n.add(e);return!0}let r=new Set(Object.keys(e.attributes)),i=!1;for(let e of t)if(!r.has(e)){if(i=!0,n!=null)n.add(e);else break}return i}async function Ye(e,t){let n=new Set;for(let r of t)await g(n,e.fieldsIndex,null,r);return Array.from(n).sort()}function Xe(e){return e?[`raster.itempixelvalue`,`raster.servicepixelvalue`].some(t=>e.toLowerCase().startsWith(t)):!1}async function Ze(e,t){let n=new Set;return e?.collectRequiredFields&&await e.collectRequiredFields(n,t),Array.from(n).sort()}function Qe(e){let t=e?.match(/{[^}]+}/g);return t?t.map(e=>e.slice(1,-1).split(`:`)[0].trim()):[]}function $e(e,t){let{statisticType:n,onStatisticField:r,onStatisticExpression:i}=e,a=t.get(r),o=I(a),s=i?.returnType;switch(n){case`avg`:case`avg_angle`:return a?o||R(a)?`double`:null:s&&s===`number`?`double`:null;case`count`:return`integer`;case`min`:case`max`:return a?o||ze(a)?a?.type??null:null:s&&s===`number`?`double`:null;case`sum`:return a?o?a?.type??null:null:s&&s===`number`?`double`:null;case`mode`:return a?a?.type??null:s?s===`number`?`double`:`string`:null;default:return null}}function et(e){let{fieldName:t,fieldsMap:n,normalizedFieldsMap:r}=e;if(!t)return;let i=n.get(t);return i||(i=n.get(tt(t))??r.get($(t)),i&&n.set(t,i),i)}function tt(e){return e.trim().toLowerCase()}function $(e){return c(e)?.toLowerCase()??``}export{z as NumericRangeValidationError,B as TypeValidationError,tt as applyLowerCaseFieldName,J as bigIntegerRange,g as collectArcadeFieldNames,be as collectDisplayFilterFields,b as collectElevationFields,pe as collectFeatureReductionFields,h as collectField,m as collectFields,he as collectFilterFields,D as collectLabelingFields,ge as collectOrderByInfos,x as collectPopupTemplateFields,_ as collectSQLFieldNames,me as collectTrackInfoFields,Z as doubleRange,Qe as extractSubstitutionTemplatesFromString,Je as featureHasFields,p as fixFields,ae as fixRendererFields,oe as fixTimeInfoFields,P as floatJSONTypes,M as floatTypes,$e as getAggregateFieldType,le as getDisplayFieldName,v as getDisplayFieldNameFromFields,w as getEditTrackingFields,de as getElevationFields,Ye as getExpressionFields,ye as getFeatureEditFields,S as getFeatureGeometryFields,Oe as getFieldDefaultLength,De as getFieldDefaultValue,et as getFieldFromIndex,Ge as getFieldRange,Ee as getLabelingFields,C as getLowerCaseDefaultHiddenFields,T as getLowerCaseEditTrackingFields,Ke as getNumericTypeForValue,Ze as getRendererFields,ve as getTimeFields,N as integerJSONTypes,q as integerRange,j as integerTypes,R as isDateField,Ie as isDateOnlyField,we as isFieldEditable,Te as isFieldVisibleByDefault,E as isFieldWithType,Ve as isGlobalIDField,Fe as isIntegerField,H as isNumberInRange,I as isNumericField,Be as isObjectIDField,Xe as isRasterPixelValueField,L as isStringField,Re as isTimeOnlyField,Le as isTimestampOffsetField,He as isValidFieldValue,A as isValueMatchingFieldType,$ as lowerCaseNormalizedFieldName,c as normalizeFieldName,Me as numericTypes,ce as packFields,Q as populateMissingFields,l as rendererFields,Ue as sanitizeNullFieldValue,We as sanitizedParseFloat,X as singleRange,W as smallIntegerRange,se as unpackFieldNames,V as validateFieldValue,qe as validationErrorToString,u as visualVariableFields};
+import e from"../../core/Error.js";import{getDeepValue as t,setDeepValue as n}from"../../core/object.js";import{union as r}from"../../core/SetUtils.js";import{parseWhereClause as i}from"../../core/sql.js";import{DomainValidationError as a,getDomainRange as o}from"./domainUtils.js";import{getFieldNameFromSimpleExpression as s}from"../../support/arcadeExpressionUtils.js";import{isStringOrNull as ee,isString as te}from"../../support/guards.js";import{loadArcade as ne}from"../../support/loadArcade.js";const re=/^([0-9_])/,ie=/[^a-z0-9_\u0080-\uffff]+/gi;function c(e){return e==null?null:e.trim().replaceAll(ie,`_`).replace(re,`F$1`)||null}const l=[`field`,`field2`,`field3`,`normalizationField`,`rotationInfo.field`,`proportionalSymbolInfo.field`,`proportionalSymbolInfo.normalizationField`,`colorInfo.field`,`colorInfo.normalizationField`],u=[`field`,`normalizationField`];function ae(e,t){if(e!=null&&t!=null){for(let n of Array.isArray(e)?e:[e])if(d(l,n,t),`visualVariables`in n&&n.visualVariables)for(let e of n.visualVariables)d(u,e,t)}}function d(e,r,i){if(e)for(let a of e){let e=t(a,r),o=e&&typeof e!=`function`&&i.get(e);o&&n(a,o.name,r)}}function oe(e,t){if(e!=null&&t?.fields?.length){if(`startField`in e){let n=t.get(e.startField),r=t.get(e.endField);e.startField=n?.name??null,e.endField=r?.name??null}else{let n=t.get(e.startTimeField),r=t.get(e.endTimeField);e.startTimeField=n?.name??null,e.endTimeField=r?.name??null}e.trackIdField=t.get(e.trackIdField)?.name??null}}const f=new Set;function p(e,t){return!e||!t?[]:(f.clear(),m(f,e,t),Array.from(f).sort())}function m(e,t,n){if(n){if(!t?.fields?.length){if(n.includes(`*`)){e.clear(),e.add(`*`);return}for(let t of n)t!=null&&e.add(t)}else if(n.includes(`*`))for(let{name:n}of t.fields)e.add(n);else for(let r of n)h(e,t,r)}}function h(e,t,n){if(typeof n==`string`){if(t){let r=t.get(n);r&&e.add(r.name)}else e.add(n)}}function se(e,t){return t==null||e==null?[]:t.includes(`*`)?(e.fields??[]).map(e=>e.name):t}function ce(e,t,n=1){if(!t||!e)return[];if(t.includes(`*`))return[`*`];let r=p(e,t);return r.length/e.fields.length>=n?[`*`]:r}async function g(e,t,n,r){if(!r)return;let i=s(r);if(i)h(e,t,i);else{let{arcadeUtils:i}=await ne(),a=i.extractFieldNames(r,n?.partitions??t?.fields?.map(e=>e.name));for(let r of a)h(e,n?.index??t,r)}}async function _(t,n,r){if(r&&r!==`1=1`){let a=await i(r,n);if(!a.isStandardized)throw new e(`fieldUtils:collectFilterFields`,`Where clause is not standardized`,{where:r});m(t,n,a.fieldNames)}}function le({displayField:e,fields:t}){return e||(t?.length?v(t):null)}function v(e){return y(e,`name-or-title`)||y(e,`unique-identifier`)||y(e,`type-or-category`)||ue(e)}function ue(e){for(let t of e){if(!t?.name)continue;let e=t.name.toLowerCase();if(e.includes(`name`)||e.includes(`title`))return t.name}return null}function y(e,t){for(let n of e)if(n?.valueType&&n.valueType===t)return n.name;return null}async function de(e){if(!e)return[];let t=new Set;return await b(t,e),Array.from(t).sort()}async function b(e,t){if(!t)return;let n=t.elevationInfo?.featureExpressionInfo;if(n)return n.collectRequiredFields(e,t.fieldsIndex)}function fe(e,t,n){n.onStatisticExpression?g(e,t,null,n.onStatisticExpression.expression):e.add(n.onStatisticField)}async function pe(e,t,n){if(!t||!n||!(`fields`in n))return;let r=[],i=n.popupTemplate;r.push(x(e,t,i)),n.fields&&r.push(...n.fields.map(async n=>fe(e,t.fieldsIndex,n))),await Promise.all(r)}async function me(e,t){let{fieldsIndex:n,trackInfo:r}=t;if(!t||!r||!n)return;let i=[r.latestObservations.renderer?.collectRequiredFields(e,n),r.previousObservations.renderer?.collectRequiredFields(e,n),r.trackLines.renderer?.collectRequiredFields(e,n)];r.popupTemplate&&i.push(x(e,t,r.popupTemplate));for(let t of[r.latestObservations.labelingInfo,r.previousObservations.labelingInfo,r.trackLines.labelingInfo])if(t)for(let r of t)i.push(O(e,n,r));await Promise.all(i)}async function x(e,t,n){let r=[];n?.expressionInfos&&r.push(...n.expressionInfos.map(n=>g(e,t.fieldsIndex,null,n.expression)));let i=n?.content;if(Array.isArray(i))for(let n of i)n.type===`expression`&&n.expressionInfo&&r.push(g(e,t.fieldsIndex,null,n.expressionInfo.expression));await Promise.all(r)}async function he(e,t,n){t&&(t.timeInfo&&n?.timeExtent&&m(e,t.fieldsIndex,[t.timeInfo.startField,t.timeInfo.endField]),t.floorInfo&&m(e,t.fieldsIndex,[t.floorInfo.floorField]),n?.where!=null&&await _(e,t.fieldsIndex,n.where))}async function ge(e,t,n){t&&n&&await Promise.all(n.map(n=>_e(e,t,n)))}async function _e(e,t,n){t&&n&&(n.valueExpression?await g(e,t.fieldsIndex,null,n.valueExpression):n.field&&h(e,t.fieldsIndex,n.field))}async function ve(e){if(!e)return[];let t=`timeInfo`in e&&e.timeInfo;return t?p(e.fieldsIndex,[e.trackIdField,t.startField,t.endField]):[]}function ye(e){return e?p(e.fieldsIndex,w(e)):[]}function S(e){if(!e)return[];let t=e.geometryFieldsInfo;return t?p(e.fieldsIndex,[t.shapeAreaField,t.shapeLengthField]):[]}async function be(e,t,n){if(!t||!n)return;let r=t.fieldsIndex;await Promise.all(n.filters.map(t=>_(e,r,t.where)))}const xe=new Set([`oid`,`global-id`,`guid`]),Se=new Set([`oid`,`global-id`]),Ce=[/^fnode_$/i,/^tnode_$/i,/^lpoly_$/i,/^rpoly_$/i,/^poly_$/i,/^shape$/i,/^shape_$/i,/^subclass$/i,/^subclass_$/i,/^rings_ok$/i,/^rings_nok$/i,/objectid/i,/^perimeter_/i,/_perimeter$/i,/_i$/i];function C(e){let t=new Set;T(e).forEach(e=>t.add(e)),S(e).forEach(e=>t.add(e.toLowerCase()));let n=e&&`infoFor3D`in e?e.infoFor3D:void 0;return n&&(Object.values(n.assetMapFieldRoles).forEach(e=>t.add(e.toLowerCase())),Object.values(n.transformFieldRoles).forEach(e=>t.add(e.toLowerCase()))),Array.from(t)}function w(e){if(!e)return[];let t=`editFieldsInfo`in e&&e.editFieldsInfo;if(!t)return[];let{creationDateField:n,creatorField:r,editDateField:i,editorField:a}=t;return[n,r,i,a].filter(Boolean)}function T(e){return w(e).map(e=>e.toLowerCase())}function E(e){return!!e.type}function we(e,t){return!!e.editable&&E(e)&&!xe.has(e.type)&&!T(t).includes(e.name?.toLowerCase()??``)}function Te(e,t){let n=e.name?.toLowerCase()??``;return(t?.objectIdField==null||n!==t.objectIdField.toLowerCase())&&(t?.globalIdField==null||n!==t.globalIdField.toLowerCase())&&!C(t).includes(n)&&!Se.has(e.type)&&!Ce.some(e=>e.test(n))}async function Ee(e){if(!e)return[];let t=new Set;return await D(t,e),Array.from(t).sort()}async function D(e,t){let{labelingInfo:n,fieldsIndex:r}=t;n?.length&&await Promise.all(n.map(t=>O(e,r,t)))}async function O(e,t,n){if(!n)return;let r=n.getLabelExpression(),i=n.where;if(r.type===`arcade`)await g(e,t,null,r.expression);else{let n=r.expression.match(/{[^}]*}/g);n&&n.forEach(n=>{h(e,t,n.slice(1,-1))})}await _(e,t,i)}function De(e){let t=e.defaultValue;if(t!==void 0&&A(e,t))return t;if(e.nullable)return null}function Oe(e){let t=typeof e==`string`?{type:e}:e;if(L(t))return 255;if(t.type===`esriFieldTypeDate`||t.type===`date`)return 8}function k(e){return typeof e==`number`&&!isNaN(e)&&isFinite(e)}function ke(e){return e===null||k(e)}function Ae(e){return e===null||Number.isInteger(e)}function je(){return!0}function A(e,t){let n;switch(e.type){case`date`:case`integer`:case`long`:case`small-integer`:case`big-integer`:case`esriFieldTypeDate`:case`esriFieldTypeInteger`:case`esriFieldTypeLong`:case`esriFieldTypeSmallInteger`:case`esriFieldTypeBigInteger`:n=e.nullable?Ae:Number.isInteger;break;case`double`:case`single`:case`esriFieldTypeSingle`:case`esriFieldTypeDouble`:n=e.nullable?ke:k;break;case`string`:case`esriFieldTypeString`:n=e.nullable?ee:te;break;default:n=je}return arguments.length===1?n:n(t)}const j=[`integer`,`small-integer`,`big-integer`,`long`],M=[`single`,`double`],Me=[...j,...M],N=[`esriFieldTypeInteger`,`esriFieldTypeSmallInteger`,`esriFieldTypeLong`,`esriFieldTypeBigInteger`],P=[`esriFieldTypeSingle`,`esriFieldTypeDouble`],F=new Set([...j,...N]),Ne=new Set([...M,...P]),Pe=r(F,Ne);function Fe(e){return e!=null&&F.has(e.type)}function I(e){return e!=null&&Pe.has(e.type)}function L(e){return e!=null&&(e.type===`string`||e.type===`esriFieldTypeString`)}function R(e){return e!=null&&(e.type===`date`||e.type===`esriFieldTypeDate`)}function Ie(e){return e!=null&&(e.type===`date-only`||e.type===`esriFieldTypeDateOnly`)}function Le(e){return e!=null&&(e.type===`guid`||e.type===`esriFieldTypeGUID`)}function Re(e){return e!=null&&(e.type===`timestamp-offset`||e.type===`esriFieldTypeTimestampOffset`)}function ze(e){return e!=null&&(e.type===`time-only`||e.type===`esriFieldTypeTimeOnly`)}function Be(e){return e!=null&&(e.type===`date`||e.type===`date-only`||e.type===`time-only`||e.type===`timestamp-offset`)}function Ve(e){return e!=null&&(e.type===`oid`||e.type===`esriFieldTypeOID`)}function He(e){return e!=null&&(e.type===`global-id`||e.type===`esriFieldTypeGlobalID`)}function Ue(e,t){return V(e,t)===null}const z={OUT_OF_RANGE:`numeric-range-validation-error::out-of-range`},B={INVALID_TYPE:`type-validation-error::invalid-type`};function We(e){return e==null||typeof e==`number`&&isNaN(e)?null:e}function Ge(e){return parseFloat(e.replaceAll(`_`,``))}function V(e,t){return e==null||e.nullable&&t===null?null:A(e,t)?I(e)&&!H(e.type,Number(t))?z.OUT_OF_RANGE:null:B.INVALID_TYPE}function H(e,t){let n=typeof e==`string`?U(e):e;if(!n)return!1;let r=n.min,i=n.max;return n.isInteger?Number.isInteger(t)&&t>=r&&t<=i:t>=r&&t<=i}function Ke(e,t){let n=o(e,t);if(n)return n;if(I(e))return U(e.type)}function U(e){switch(e){case`esriFieldTypeSmallInteger`:case`small-integer`:return W;case`esriFieldTypeInteger`:case`esriFieldTypeLong`:case`integer`:case`long`:return q;case`esriFieldTypeBigInteger`:case`big-integer`:return J;case`esriFieldTypeSingle`:case`single`:return X;case`esriFieldTypeDouble`:case`double`:return Z}}function qe(e){if(!k(e))return null;if(Number.isInteger(e)){if(e>=W.min&&e<=W.max)return`esriFieldTypeSmallInteger`;if(e>=q.min&&e<=q.max)return`esriFieldTypeInteger`;if(e>=J.min&&e<=J.max)return`esriFieldTypeBigInteger`}return e>=X.min&&e<=X.max?`esriFieldTypeSingle`:`esriFieldTypeDouble`}const W={min:-32768,max:32767,isInteger:!0,rawMin:-32768,rawMax:32767},G=-2147483648,K=2**31-1,q={min:G,max:K,isInteger:!0,rawMin:G,rawMax:K},J={min:-(2**53-1),max:2**53-1,isInteger:!0,rawMin:-(2**53-1),rawMax:2**53-1},Y=(2-2**-23)*2**127,X={min:-Y,max:Y,isInteger:!1,rawMin:-Y,rawMax:Y},Z={min:-Number.MAX_VALUE,max:Number.MAX_VALUE,isInteger:!1,rawMin:-Number.MAX_VALUE,rawMax:Number.MAX_VALUE};function Je(e,t,n){switch(e){case a.INVALID_CODED_VALUE:return`Value ${n} is not in the coded domain - field: ${t.name}, domain: ${JSON.stringify(t.domain)}`;case a.VALUE_OUT_OF_RANGE:return`Value ${n} is out of the range of valid values - field: ${t.name}, domain: ${JSON.stringify(t.domain)}`;case B.INVALID_TYPE:return`Value ${n} is not a valid value for the field type - field: ${t.name}, type: ${t.type}, nullable: ${t.nullable}`;case z.OUT_OF_RANGE:{let{min:e,max:r}=U(t.type);return`Value ${n} is out of range for the number type - field: ${t.name}, type: ${t.type}, value range is ${e} to ${r}`}}}function Ye(e,t){return!Q(e,t,null)}function Q(e,t,n){if(!e?.attributes||!t){if(n!=null)for(let e of t??[])n.add(e);return!0}let r=new Set(Object.keys(e.attributes)),i=!1;for(let e of t)if(!r.has(e)){if(i=!0,n!=null)n.add(e);else break}return i}async function Xe(e,t){let n=new Set;for(let r of t)await g(n,e.fieldsIndex,null,r);return Array.from(n).sort()}function Ze(e){return e?[`raster.itempixelvalue`,`raster.servicepixelvalue`].some(t=>e.toLowerCase().startsWith(t)):!1}async function Qe(e,t){let n=new Set;return e?.collectRequiredFields&&await e.collectRequiredFields(n,t),Array.from(n).sort()}function $e(e){let t=e?.match(/{[^}]+}/g);return t?t.map(e=>e.slice(1,-1).split(`:`)[0].trim()):[]}function et(e,t){let{statisticType:n,onStatisticField:r,onStatisticExpression:i}=e,a=t.get(r),o=I(a),s=i?.returnType;switch(n){case`avg`:case`avg_angle`:return a?o||R(a)?`double`:null:s&&s===`number`?`double`:null;case`count`:return`integer`;case`min`:case`max`:return a?o||Be(a)?a?.type??null:null:s&&s===`number`?`double`:null;case`sum`:return a?o?a?.type??null:null:s&&s===`number`?`double`:null;case`mode`:return a?a?.type??null:s?s===`number`?`double`:`string`:null;default:return null}}function tt(e){let{fieldName:t,fieldsMap:n,normalizedFieldsMap:r}=e;if(!t)return;let i=n.get(t);return i||(i=n.get($(t))??r.get(nt(t)),i&&n.set(t,i),i)}function $(e){return e.trim().toLowerCase()}function nt(e){return c(e)?.toLowerCase()??``}export{z as NumericRangeValidationError,B as TypeValidationError,$ as applyLowerCaseFieldName,J as bigIntegerRange,g as collectArcadeFieldNames,be as collectDisplayFilterFields,b as collectElevationFields,pe as collectFeatureReductionFields,h as collectField,m as collectFields,he as collectFilterFields,D as collectLabelingFields,ge as collectOrderByInfos,x as collectPopupTemplateFields,_ as collectSQLFieldNames,me as collectTrackInfoFields,Z as doubleRange,$e as extractSubstitutionTemplatesFromString,Ye as featureHasFields,p as fixFields,ae as fixRendererFields,oe as fixTimeInfoFields,P as floatJSONTypes,M as floatTypes,et as getAggregateFieldType,le as getDisplayFieldName,v as getDisplayFieldNameFromFields,w as getEditTrackingFields,de as getElevationFields,Xe as getExpressionFields,ye as getFeatureEditFields,S as getFeatureGeometryFields,Oe as getFieldDefaultLength,De as getFieldDefaultValue,tt as getFieldFromIndex,Ke as getFieldRange,Ee as getLabelingFields,C as getLowerCaseDefaultHiddenFields,T as getLowerCaseEditTrackingFields,qe as getNumericTypeForValue,Qe as getRendererFields,ve as getTimeFields,N as integerJSONTypes,q as integerRange,j as integerTypes,R as isDateField,Ie as isDateOnlyField,we as isFieldEditable,Te as isFieldVisibleByDefault,E as isFieldWithType,He as isGlobalIDField,Le as isGuidField,Fe as isIntegerField,H as isNumberInRange,I as isNumericField,Ve as isObjectIDField,Ze as isRasterPixelValueField,L as isStringField,ze as isTimeOnlyField,Re as isTimestampOffsetField,Ue as isValidFieldValue,A as isValueMatchingFieldType,nt as lowerCaseNormalizedFieldName,c as normalizeFieldName,Me as numericTypes,ce as packFields,Q as populateMissingFields,l as rendererFields,We as sanitizeNullFieldValue,Ge as sanitizedParseFloat,X as singleRange,W as smallIntegerRange,se as unpackFieldNames,V as validateFieldValue,Je as validationErrorToString,u as visualVariableFields};

package/layers/support/timeSeriesUtils.d.ts

@@ -5,13 +5,17 @@
  * @since 5.1
  */
 import type TimeSeriesInfo from "./TimeSeriesInfo.js";
+import type { TimeSeriesCalculationMethodType } from "./TimeSeriesCalculationMethod.js";
 
 /**
  * Options for creating a time series Arcade expression.
  *
  * @since 5.2
  */
-export interface CreateTimeSeriesExpressionOptions {}
+export interface CreateTimeSeriesExpressionOptions {
+  /** The calculation method used to derive a time series data value. */
+  calculationMethodType?: TimeSeriesCalculationMethodType;
+}
 
 /**
  * Creates an [Arcade expression](https://developers.arcgis.com/javascript/latest/arcade/) that resolves values from a time series data series using the
@@ -35,7 +39,7 @@ export interface CreateTimeSeriesExpressionOptions {}
  *   timeValueUnits: "years",
  * });
  *
- * const expression = createTimeSeriesExpression(info, { calculationMethod: "change-from-previous" });
+ * const expression = createTimeSeriesExpression(info, { calculationMethodType: "change-from-previous" });
  * ```
  */
 export function createTimeSeriesExpression(dataSeriesInfo: TimeSeriesInfo, options?: CreateTimeSeriesExpressionOptions): string;

package/layers/support/timeSeriesUtils.js

@@ -1,5 +1,5 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/6.0/LICENSE.txt */
-function e(e,n){let{calculationMethod:r}=n??{},i=e.fieldTimeMappings??[];if(!i.length)return`return null;`;let a=t(e.timeValueUnits??`years`);if(!r){let e=i.map(({fieldName:e,timeValue:t})=>`  "${t}", $feature.${e},`);return`var timeFormat = "${a}";
+function e(e,n){let{calculationMethodType:r}=n??{},i=e.fieldTimeMappings??[];if(!i.length)return`return null;`;let a=t(e.timeValueUnits??`years`);if(!r){let e=i.map(({fieldName:e,timeValue:t})=>`  "${t}", $feature.${e},`);return`var timeFormat = "${a}";
 
 var hasCurrentStart = HasValue($view, ["timeProperties", "currentStart"]);
 var hasCurrentEnd = HasValue($view, ["timeProperties", "currentEnd"]);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arcgis/core",
-  "version": "6.0.0-next.12",
+  "version": "6.0.0-next.14",
   "description": "ArcGIS Maps SDK for JavaScript: A complete 2D and 3D mapping and data visualization API",
   "keywords": [
     "ArcGIS",
@@ -19,12 +19,12 @@
   "type": "module",
   "license": "SEE LICENSE IN LICENSE.md",
   "dependencies": {
-    "@amcharts/amcharts5": "~5.21.0",
-    "@arcgis/toolkit": "6.0.0-next.12",
+    "@amcharts/amcharts5": "~5.21.2",
+    "@arcgis/toolkit": "6.0.0-next.14",
     "@esri/arcgis-html-sanitizer": "~4.2.0-next.2",
     "@esri/calcite-components": "^5.2.0-next.89",
     "@vaadin/grid": "~25.3.2",
-    "@zip.js/zip.js": "~2.23.0",
+    "@zip.js/zip.js": "~2.24.0",
     "luxon": "~3.7.2",
     "marked": "~18.1.0",
     "tslib": "^2.8.1"