@loaders.gl/arcgis 5.0.0-alpha.12 → 5.0.0-alpha.13

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@loaders.gl/arcgis",
-  "version": "5.0.0-alpha.12",
+  "version": "5.0.0-alpha.13",
   "description": "ArcGIS REST data sources for geospatial visualization",
   "license": "MIT",
   "type": "module",
@@ -81,16 +81,15 @@
     "README.md"
   ],
   "dependencies": {
-    "@loaders.gl/arrow-geometry": "5.0.0-alpha.12",
-    "@loaders.gl/i3s": "5.0.0-alpha.12",
-    "@loaders.gl/images": "5.0.0-alpha.12",
-    "@loaders.gl/lerc": "5.0.0-alpha.12",
-    "@loaders.gl/loader-utils": "5.0.0-alpha.12",
-    "@loaders.gl/mvt": "5.0.0-alpha.12",
-    "@loaders.gl/schema": "5.0.0-alpha.12"
+    "@loaders.gl/arrow-geometry": "5.0.0-alpha.13",
+    "@loaders.gl/images": "5.0.0-alpha.13",
+    "@loaders.gl/raster": "5.0.0-alpha.13",
+    "@loaders.gl/tiles": "5.0.0-alpha.13",
+    "@loaders.gl/tiles-3d": "5.0.0-alpha.13",
+    "lerc": "^4.2.0"
   },
   "peerDependencies": {
     "@loaders.gl/core": "~5.0.0-alpha.0"
   },
-  "gitHead": "8cbff6cb3e55c4eb1305072743992af27ff0c171"
+  "gitHead": "1464ee8e912521b658a51f96c88c3b2310ceb2cd"
 }

package/src/arcgis/arcgis-capability-graph.ts

@@ -5,7 +5,7 @@
 import {getArcGISServices} from './arcgis-server';
 export {getArcGISServices} from './arcgis-server';
 export type {Service as ArcGISService} from './arcgis-server';
-import type {ServiceCapabilities} from '@loaders.gl/loader-utils';
+import type {ServiceCapabilities} from '@loaders.gl/core/loader-utils';
 import type {Service as ArcGISService} from './arcgis-server';
 
 /** Normalized capabilities discovered from one ArcGIS REST service. */

package/src/arcgis/arcgis-feature-query.ts

@@ -2,7 +2,7 @@
 // SPDX-License-Identifier: MIT
 // Copyright (c) vis.gl contributors
 
-import type {Feature, GeoJSONTable} from '@loaders.gl/schema';
+import type {Feature, GeoJSONTable} from '@loaders.gl/core/schema';
 import type {
   ArcGISFeatureExtent,
   ArcGISFeatureObjectIds,

package/src/arcgis/arcgis-feature-server-source-loader-types.ts

@@ -3,7 +3,7 @@
 // Copyright (c) vis.gl contributors
 
 import {ARCGIS_FEATURE_SERVER_SOURCE_LOADER_METADATA} from '../arcgis-source-types';
-import type {CoreAPI, SourceLoader} from '@loaders.gl/loader-utils';
+import type {CoreAPI, SourceLoader} from '@loaders.gl/core/loader-utils';
 import type {ArcGISVectorSource} from './arcgis-feature-server-source-loader';
 import type {ArcGISFeatureServerSourceLoaderOptions} from '../arcgis-source-types';
 

package/src/arcgis/arcgis-feature-server-source-loader.ts

@@ -9,7 +9,7 @@ import type {
   ArcGISFeatureServerSourceLoaderOptions
 } from '../arcgis-source-types';
 
-import type {DataType, Schema} from '@loaders.gl/schema';
+import type {DataType, Schema} from '@loaders.gl/core/schema';
 import {convertFeaturesToWKBArrowTable} from '@loaders.gl/arrow-geometry/feature-collection-to-arrow';
 import {convertGeojsonToBinaryFeatureCollection} from '@loaders.gl/arrow-geometry/legacy-binary';
 import type {
@@ -18,9 +18,9 @@ import type {
   GetFeaturesParameters,
   VectorSource,
   VectorSourceData
-} from '@loaders.gl/loader-utils';
-import type {SourceLoader} from '@loaders.gl/loader-utils';
-import {DataSource} from '@loaders.gl/loader-utils';
+} from '@loaders.gl/core/loader-utils';
+import type {SourceLoader} from '@loaders.gl/core/loader-utils';
+import {DataSource} from '@loaders.gl/core/loader-utils';
 import {buildArcGISResourceURL} from './arcgis-url-utils';
 import {ArcGISFeatureQueryClient} from './arcgis-feature-query';
 import type {

package/src/arcgis/arcgis-image-server-source-loader-types.ts

@@ -3,7 +3,7 @@
 // Copyright (c) vis.gl contributors
 
 import {ARCGIS_IMAGE_SERVER_SOURCE_LOADER_METADATA} from '../arcgis-source-types';
-import type {CoreAPI, SourceLoader} from '@loaders.gl/loader-utils';
+import type {CoreAPI, SourceLoader} from '@loaders.gl/core/loader-utils';
 import type {ArcGISImageSource} from './arcgis-image-server-source-loader';
 import type {ArcGISImageSourceLoaderProps} from '../arcgis-source-types';
 

package/src/arcgis/arcgis-image-server-source-loader.ts

@@ -17,10 +17,10 @@ import type {
   ImageSource,
   ImageSourceMetadata,
   GetImageParameters
-} from '@loaders.gl/loader-utils';
-import {DataSource} from '@loaders.gl/loader-utils';
-import type {LERCData} from '@loaders.gl/lerc';
-import {LERCLoader} from '@loaders.gl/lerc';
+} from '@loaders.gl/core/loader-utils';
+import {DataSource} from '@loaders.gl/core/loader-utils';
+import type {LERCData} from '@loaders.gl/raster';
+import {LERCLoader} from '@loaders.gl/raster';
 import {buildArcGISResourceURL} from './arcgis-url-utils';
 
 /** Runtime service loader for synchronous construction. */

package/src/arcgis/arcgis-image-tile-source-loader-types.ts

@@ -3,7 +3,7 @@
 // Copyright (c) vis.gl contributors
 
 import {ARCGIS_IMAGE_TILE_SOURCE_LOADER_METADATA} from '../arcgis-source-types';
-import type {CoreAPI, SourceLoader} from '@loaders.gl/loader-utils';
+import type {CoreAPI, SourceLoader} from '@loaders.gl/core/loader-utils';
 import type {ArcGISImageTileSource} from './arcgis-image-tile-source-loader';
 import type {ArcGISImageTileSourceLoaderOptions} from '../arcgis-source-types';
 

package/src/arcgis/arcgis-image-tile-source-loader.ts

@@ -15,10 +15,10 @@ import type {
   SourceLoader,
   TileSource,
   TileSourceMetadata
-} from '@loaders.gl/loader-utils';
-import {DataSource} from '@loaders.gl/loader-utils';
-import type {LERCData} from '@loaders.gl/lerc';
-import {LERCLoader} from '@loaders.gl/lerc';
+} from '@loaders.gl/core/loader-utils';
+import {DataSource} from '@loaders.gl/core/loader-utils';
+import type {LERCData} from '@loaders.gl/raster';
+import {LERCLoader} from '@loaders.gl/raster';
 
 /** A tile source that renders ArcGIS ImageServer exports as deck.gl tiles. */
 export class ArcGISImageTileSource
@@ -76,6 +76,7 @@ export class ArcGISImageTileSource
     parameters: GetTileParameters,
     signal?: AbortSignal
   ): Promise<ImageType | LERCData | null> {
+    signal ||= parameters.signal;
     const response = await this.fetch(this.getTileURL(parameters), signal ? {signal} : undefined);
     if (!response.ok) {
       throw new Error(
@@ -92,7 +93,10 @@ export class ArcGISImageTileSource
 
   /** Fetches a tile using the deck.gl-compatible request shape. */
   async getTileData(parameters: GetTileDataParameters): Promise<ImageType | LERCData | null> {
-    return this.getTile(parameters.index, parameters.signal);
+    return this.getTile(
+      {...parameters.index, tileMatrix: parameters.tileMatrix, signal: parameters.signal},
+      parameters.signal
+    );
   }
 
   /** Updates parameters applied to subsequent ImageServer export requests. */
@@ -102,6 +106,9 @@ export class ArcGISImageTileSource
 
   /** Builds an ImageServer exportImage URL for one web-mercator tile. */
   getTileURL(parameters: GetTileParameters, tileSize?: number): string {
+    if (parameters.tileMatrix !== undefined && parameters.tileMatrix !== String(parameters.z)) {
+      throw new Error('ArcGIS ImageServer export requires a matching XYZ zoom');
+    }
     const options = this.options['arcgis-image-server-tiles'] || {};
     const resolvedTileSize = tileSize || options.tileSize || 256;
     const [west, south, east, north] = getWebMercatorTileBounds(parameters);

package/src/arcgis/arcgis-map-tile-source-loader-types.ts

@@ -3,7 +3,7 @@
 // Copyright (c) vis.gl contributors
 
 import {ARCGIS_MAP_TILE_SOURCE_LOADER_METADATA} from '../arcgis-source-types';
-import type {CoreAPI, SourceLoader} from '@loaders.gl/loader-utils';
+import type {CoreAPI, SourceLoader} from '@loaders.gl/core/loader-utils';
 import type {ArcGISMapTileSource} from './arcgis-map-tile-source-loader';
 import type {ArcGISMapTileSourceLoaderOptions} from '../arcgis-source-types';
 

package/src/arcgis/arcgis-map-tile-source-loader.ts

@@ -19,8 +19,9 @@ import type {
   SourceLoader,
   TileSource,
   TileSourceMetadata
-} from '@loaders.gl/loader-utils';
-import {DataSource} from '@loaders.gl/loader-utils';
+} from '@loaders.gl/core/loader-utils';
+import {DataSource, getTileGridMatrixId} from '@loaders.gl/core/loader-utils';
+import {createArcGISTileGrid} from './arcgis-tile-grid';
 
 /** ArcGIS MapServer source for cached `/tile/{z}/{y}/{x}` image tiles. */
 export class ArcGISMapTileSource
@@ -59,7 +60,9 @@ export class ArcGISMapTileSource
       title: metadata.name || '',
       abstract: metadata.description || metadata.serviceDescription || '',
       attributions: metadata.copyrightText ? [metadata.copyrightText] : undefined,
-      minZoom: 0,
+      minZoom: metadata.tileInfo?.lods?.length
+        ? Math.min(...metadata.tileInfo.lods.map(level => level.level))
+        : 0,
       maxZoom: metadata.tileInfo?.lods?.length
         ? Math.max(...metadata.tileInfo.lods.map(lod => lod.level))
         : undefined,
@@ -74,21 +77,7 @@ export class ArcGISMapTileSource
         srs: spatialReferenceWkid ? [`EPSG:${spatialReferenceWkid}`] : [],
         layers: []
       },
-      tileGrid: metadata.tileInfo
-        ? {
-            crs: (metadata.tileInfo.spatialReference as {wkid?: number} | undefined)?.wkid
-              ? `EPSG:${(metadata.tileInfo.spatialReference as {wkid: number}).wkid}`
-              : undefined,
-            tileSize:
-              metadata.tileInfo.rows && metadata.tileInfo.cols
-                ? [metadata.tileInfo.cols, metadata.tileInfo.rows]
-                : undefined,
-            origin: metadata.tileInfo.origin
-              ? [metadata.tileInfo.origin.x, metadata.tileInfo.origin.y]
-              : undefined,
-            matrixIds: metadata.tileInfo.lods?.map(lod => String(lod.level))
-          }
-        : undefined
+      tileGrid: createArcGISTileGrid(metadata.tileInfo, spatialReference)
     };
   }
 
@@ -116,23 +105,32 @@ export class ArcGISMapTileSource
 
   /** Fetches a tile using the deck.gl-compatible request shape. */
   async getTileData(parameters: GetTileDataParameters): Promise<ImageType | null> {
-    return this.getTile(parameters.index, parameters.signal);
+    return this.getTile(
+      {...parameters.index, tileMatrix: parameters.tileMatrix, signal: parameters.signal},
+      parameters.signal
+    );
   }
 
   /** Builds the standard ArcGIS cached tile URL. */
   getTileURL(parameters: GetTileParameters): string {
+    const metadata = this.options['arcgis-map-server']?.metadata || this._metadata;
+    const matrixId = getTileGridMatrixId(
+      createArcGISTileGrid(metadata?.tileInfo, metadata?.spatialReference),
+      parameters
+    );
     const template = this.options['arcgis-map-server']?.urlTemplate;
     if (template) {
       const templateURL = new URL(
         template
-          .replaceAll('{z}', String(parameters.z))
+          .replaceAll('{z}', encodeURIComponent(matrixId))
+          .replaceAll('{tileMatrix}', encodeURIComponent(matrixId))
           .replaceAll('{y}', String(parameters.y))
           .replaceAll('{x}', String(parameters.x))
       );
       return templateURL.toString();
     }
     const url = new URL(this.getServiceURL(parameters));
-    url.pathname = `${url.pathname.replace(/\/$/, '')}/tile/${parameters.z}/${parameters.y}/${parameters.x}`;
+    url.pathname = `${url.pathname.replace(/\/$/, '')}/tile/${encodeURIComponent(matrixId)}/${parameters.y}/${parameters.x}`;
     return url.toString();
   }
 
@@ -143,6 +141,11 @@ export class ArcGISMapTileSource
 
   /** Builds a dynamic MapServer `export` request for one web-mercator tile. */
   getExportTileURL(parameters: GetTileParameters, tileSize?: number): string {
+    if (parameters.tileMatrix !== undefined && parameters.tileMatrix !== String(parameters.z)) {
+      throw new Error(
+        'ArcGIS dynamic export requires a matching XYZ zoom; use cached mode for native matrices'
+      );
+    }
     const options = this.options['arcgis-map-server'] || {};
     const resolvedTileSize = tileSize || options.tileSize || 256;
     const [west, south, east, north] = getWebMercatorTileBounds(parameters);

package/src/arcgis/arcgis-scene-server-source-loader-types.ts

@@ -3,7 +3,7 @@
 // Copyright (c) vis.gl contributors
 
 import {ARCGIS_SCENE_SERVER_SOURCE_LOADER_METADATA} from '../arcgis-source-types';
-import type {CoreAPI, SourceLoader} from '@loaders.gl/loader-utils';
+import type {CoreAPI, SourceLoader} from '@loaders.gl/core/loader-utils';
 import type {ArcGISSceneServerSource} from './arcgis-scene-server-source-loader';
 import type {ArcGISSceneServerSourceOptions} from '../arcgis-source-types';
 

package/src/arcgis/arcgis-scene-server-source-loader.ts

@@ -10,14 +10,14 @@ import type {
   ArcGISSceneServerSourceOptions
 } from '../arcgis-source-types';
 
-import type {CoreAPI, DataSourceOptions, SourceLoader} from '@loaders.gl/loader-utils';
-import {DataSource} from '@loaders.gl/loader-utils';
+import type {CoreAPI, DataSourceOptions, SourceLoader} from '@loaders.gl/core/loader-utils';
+import {DataSource} from '@loaders.gl/core/loader-utils';
 import {
   createI3SLayerSource,
   normalizeI3SServiceMetadata,
   parseI3SSceneLayerMetadata
-} from '@loaders.gl/i3s';
-import type {I3SLayerSource, I3SServiceMetadata, SceneLayer3D} from '@loaders.gl/i3s';
+} from '@loaders.gl/tiles-3d/i3s';
+import type {I3SLayerSource, I3SServiceMetadata, SceneLayer3D} from '@loaders.gl/tiles-3d/i3s';
 import {buildArcGISResourceURL} from './arcgis-url-utils';
 
 /** Error raised when a SceneServer query cannot be completed or decoded. */

package/src/arcgis/arcgis-tile-grid.ts

@@ -0,0 +1,55 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+
+import {createTileGrid, createTileGridMatrix} from '@loaders.gl/core/loader-utils';
+import type {TileGrid} from '@loaders.gl/core/loader-utils';
+import type {ArcGISMapServerMetadata} from '../arcgis-source-types';
+
+/** Normalizes advertised ArcGIS LODs without inventing dimensions from service coverage. */
+export function createArcGISTileGrid(
+  tileInfo: ArcGISMapServerMetadata['tileInfo'],
+  spatialReference?: unknown
+): TileGrid | undefined {
+  if (!tileInfo) return undefined;
+  const reference = (tileInfo.spatialReference || spatialReference) as
+    | {wkid?: number; latestWkid?: number; wkt?: string}
+    | undefined;
+  const identifier = reference?.latestWkid ?? reference?.wkid;
+  const crs =
+    identifier === 102100 || identifier === 102113
+      ? 'EPSG:3857'
+      : identifier !== undefined
+        ? `EPSG:${identifier}`
+        : reference?.wkt;
+  const levels = tileInfo.lods || [];
+  if (
+    levels.some(level => !Number.isSafeInteger(level.level) || level.level < 0) ||
+    new Set(levels.map(level => level.level)).size !== levels.length
+  ) {
+    throw new Error('ArcGIS tile levels require unique nonnegative integer identifiers');
+  }
+  const matrices = levels.map(level =>
+    createTileGridMatrix({
+      id: String(level.level),
+      resolution: level.resolution,
+      point: tileInfo.origin ? [tileInfo.origin.x, tileInfo.origin.y] : undefined,
+      swapAxes: false,
+      tileWidth: tileInfo.cols,
+      tileHeight: tileInfo.rows
+    })
+  );
+  const grid = createTileGrid(crs, matrices);
+  // A service may advertise its grid header without any LODs.
+  if (!matrices.length) {
+    delete grid.matrices;
+    delete grid.matrixIds;
+    delete grid.matrixSizes;
+    grid.origin = tileInfo.origin ? [tileInfo.origin.x, tileInfo.origin.y] : undefined;
+    grid.tileSize =
+      tileInfo.cols !== undefined && tileInfo.rows !== undefined
+        ? [tileInfo.cols, tileInfo.rows]
+        : undefined;
+  }
+  return grid;
+}

package/src/arcgis/arcgis-vector-tile-server-source-loader-types.ts

@@ -3,7 +3,7 @@
 // Copyright (c) vis.gl contributors
 
 import {ARCGIS_VECTOR_TILE_SERVER_SOURCE_LOADER_METADATA} from '../arcgis-source-types';
-import type {CoreAPI, SourceLoader} from '@loaders.gl/loader-utils';
+import type {CoreAPI, SourceLoader} from '@loaders.gl/core/loader-utils';
 import type {ArcGISVectorTileServerSource} from './arcgis-vector-tile-server-source-loader';
 import type {ArcGISVectorTileServerSourceLoaderOptions} from '../arcgis-source-types';
 

package/src/arcgis/arcgis-vector-tile-server-source-loader.ts

@@ -15,12 +15,14 @@ import type {
   GetTileParameters,
   SourceLoader,
   TileSourceMetadata,
+  TileGrid,
   VectorTile,
   VectorTileSource
-} from '@loaders.gl/loader-utils';
-import {DataSource} from '@loaders.gl/loader-utils';
-import {MVTLoader, type MVTLoaderOptions} from '@loaders.gl/mvt';
-import type {Schema} from '@loaders.gl/schema';
+} from '@loaders.gl/core/loader-utils';
+import {DataSource, getTileGridMatrixId} from '@loaders.gl/core/loader-utils';
+import {createArcGISTileGrid} from './arcgis-tile-grid';
+import {MVTLoader, type MVTLoaderOptions} from '@loaders.gl/tiles/mvt';
+import type {Schema} from '@loaders.gl/core/schema';
 
 /** A source for ArcGIS VectorTileServer metadata and PBF tiles. */
 export class ArcGISVectorTileServerSource
@@ -33,6 +35,8 @@ export class ArcGISVectorTileServerSource
   readonly localCoordinates = false;
   /** Cached service metadata request. */
   private serviceMetadata: Promise<ArcGISVectorTileServiceMetadata> | null = null;
+  /** Advertised grid, available after metadata loads. */
+  private tileGrid: TileGrid | undefined;
   /** Query parameters supplied with the service URL, such as an access token. */
   private readonly serviceQueryParameters: URLSearchParams;
 
@@ -58,14 +62,16 @@ export class ArcGISVectorTileServerSource
     const metadata = await this.getServiceMetadata();
     const tileInfo = metadata.tileInfo;
     const lods = tileInfo?.lods || [];
+    this.tileGrid = createArcGISTileGrid(tileInfo);
     const extent = metadata.fullExtent || metadata.initialExtent;
     return {
       name: metadata.mapName || this.url.split('/').pop() || '',
       title: metadata.mapName,
       abstract: metadata.serviceDescription,
       format: 'application/vnd.mapbox-vector-tile',
-      minZoom: lods[0]?.level,
-      maxZoom: lods.at(-1)?.level,
+      minZoom: lods.length ? Math.min(...lods.map(level => level.level)) : undefined,
+      maxZoom: lods.length ? Math.max(...lods.map(level => level.level)) : undefined,
+      tileGrid: this.tileGrid,
       boundingBox: extent
         ? [
             [extent.xmin, extent.ymin],
@@ -102,6 +108,12 @@ export class ArcGISVectorTileServerSource
 
   /** Fetches and decodes one ArcGIS vector tile to geographic coordinates. */
   async getVectorTile(parameters: GetTileParameters): Promise<VectorTile | null> {
+    const matrixId = getTileGridMatrixId(this.tileGrid, parameters);
+    if (matrixId !== String(parameters.z)) {
+      throw new Error(
+        'ArcGIS geographic vector decoding requires a matching XYZ zoom; use getTile for native matrix bytes'
+      );
+    }
     const arrayBuffer = await this.getTile(parameters, parameters.signal);
     if (!arrayBuffer) {
       return null;
@@ -123,12 +135,19 @@ export class ArcGISVectorTileServerSource
 
   /** Provides decoded vector tiles through the deck.gl source interface. */
   async getTileData(parameters: GetTileDataParameters): Promise<VectorTile | null> {
-    return this.getVectorTile({...parameters.index, signal: parameters.signal});
+    return this.getVectorTile({
+      ...parameters.index,
+      tileMatrix: parameters.tileMatrix,
+      signal: parameters.signal
+    });
   }
 
   /** Builds the ArcGIS cached vector tile URL. */
   getTileURL(parameters: GetTileParameters): string {
-    return this.getResourceURL(`/tile/${parameters.z}/${parameters.y}/${parameters.x}.pbf`);
+    const matrixId = getTileGridMatrixId(this.tileGrid, parameters);
+    return this.getResourceURL(
+      `/tile/${encodeURIComponent(matrixId)}/${parameters.y}/${parameters.x}.pbf`
+    );
   }
 
   /** Returns the service metadata URL. */

package/src/arcgis-feature-query-types.ts

@@ -2,8 +2,8 @@
 // SPDX-License-Identifier: MIT
 // Copyright (c) vis.gl contributors
 
-import type {GeoJSONTable} from '@loaders.gl/schema';
-import type {GetFeaturesParameters} from '@loaders.gl/loader-utils';
+import type {GeoJSONTable} from '@loaders.gl/core/schema';
+import type {GetFeaturesParameters} from '@loaders.gl/core/loader-utils';
 import type {ArcGISFeatureServiceQueryOptions} from './arcgis-source-types';
 
 /** Parameters shared by feature, table and MapServer layer queries. */

package/src/arcgis-items.ts

@@ -2,7 +2,7 @@
 // SPDX-License-Identifier: MIT
 // Copyright (c) vis.gl contributors
 
-import type {FetchLike} from '@loaders.gl/loader-utils';
+import type {FetchLike} from '@loaders.gl/core/loader-utils';
 
 /** A supported service-backed portal item, retaining the original portal metadata. */
 export type ArcGISItem = {

package/src/arcgis-source-types.ts

@@ -2,9 +2,9 @@
 // SPDX-License-Identifier: MIT
 // Copyright (c) vis.gl contributors
 
-import type {DataSourceOptions, SourceLoader} from '@loaders.gl/loader-utils';
+import type {DataSourceOptions, SourceLoader} from '@loaders.gl/core/loader-utils';
 import type {ImageLoaderOptions} from '@loaders.gl/images';
-import type {MVTLoaderOptions} from '@loaders.gl/mvt';
+import type {MVTLoaderOptions} from '@loaders.gl/tiles/mvt';
 
 /** Static source metadata shared by lazy descriptors and runtime loaders. */
 type ArcGISSourceMetadata = Omit<SourceLoader, 'dataType' | 'batchType' | 'createDataSource'>;
@@ -155,7 +155,15 @@ export type ArcGISMapServerMetadata = {
   fullExtent?: {xmin: number; ymin: number; xmax: number; ymax: number; spatialReference?: unknown};
   spatialReference?: unknown;
   tileInfo?: {
-    lods?: {level: number}[];
+    /** Advertised level identifiers and coordinate units per pixel. */
+    lods?: {
+      /** Native cache level identifier. */
+      level: number;
+      /** Coordinate units per pixel. */
+      resolution?: number;
+      /** Advertised scale denominator, retained as service metadata. */
+      scale?: number;
+    }[];
     rows?: number;
     cols?: number;
     format?: string;

package/src/authentication.ts

@@ -7,12 +7,12 @@ import type {
   FetchLike,
   RequestCredential,
   TokenValue
-} from '@loaders.gl/loader-utils';
+} from '@loaders.gl/core/loader-utils';
 import {
   TokenAuthentication,
   createAuthenticatedFetch,
   createQueryParameterCredential
-} from '@loaders.gl/loader-utils';
+} from '@loaders.gl/core/loader-utils';
 
 /** Maximum JSON error bytes retained by the authentication detector. */
 const MAXIMUM_AUTHENTICATION_ERROR_BYTES = 16384;