@loaders.gl/i3s 4.0.0-alpha.17 → 4.0.0-alpha.18

package/dist/i3s-content-worker.js

@@ -32,6 +32,12 @@
     }
   });
 
+  // (disabled):../core/src/lib/fetch/fetch-file.node
+  var require_fetch_file = __commonJS({
+    "(disabled):../core/src/lib/fetch/fetch-file.node"() {
+    }
+  });
+
   // ../loader-utils/src/lib/env-utils/assert.ts
   function assert(condition, message) {
     if (!condition) {
@@ -55,7 +61,7 @@
   var nodeVersion = matches && parseFloat(matches[1]) || 0;
 
   // ../worker-utils/src/lib/env-utils/version.ts
-  var VERSION = true ? "4.0.0-alpha.17" : DEFAULT_VERSION;
+  var VERSION = true ? "4.0.0-alpha.18" : DEFAULT_VERSION;
   if (false) {
     console.error("loaders.gl: The __VERSION__ variable is not injected using babel plugin. Latest unstable workers would be fetched from the CDN.");
   }
@@ -587,8 +593,7 @@
   }
   async function loadLibraryFromFile(libraryUrl) {
     if (libraryUrl.endsWith("wasm")) {
-      const response2 = await fetch(libraryUrl);
-      return await response2.arrayBuffer();
+      return await loadAsArrayBuffer(libraryUrl);
     }
     if (!isBrowser2) {
       try {
@@ -600,8 +605,7 @@
     if (isWorker) {
       return importScripts(libraryUrl);
     }
-    const response = await fetch(libraryUrl);
-    const scriptSource = await response.text();
+    const scriptSource = await loadAsText(libraryUrl);
     return loadLibraryFromString(scriptSource, libraryUrl);
   }
   function loadLibraryFromString(scriptSource, id) {
@@ -622,6 +626,20 @@
     document.body.appendChild(script);
     return null;
   }
+  async function loadAsArrayBuffer(url) {
+    if (!node.readFileAsArrayBuffer || url.startsWith("http")) {
+      const response = await fetch(url);
+      return await response.arrayBuffer();
+    }
+    return await node.readFileAsArrayBuffer(url);
+  }
+  async function loadAsText(url) {
+    if (!node.readFileAsText || url.startsWith("http")) {
+      const response = await fetch(url);
+      return await response.text();
+    }
+    return await node.readFileAsText(url);
+  }
 
   // ../loader-utils/src/lib/worker-loader-utils/create-loader-worker.ts
   var requestId = 0;
@@ -1191,9 +1209,22 @@
   }
 
   // ../core/src/lib/fetch/fetch-file.ts
+  var node3 = __toModule(require_fetch_file());
+  function isNodePath(url) {
+    return !isRequestURL(url) && !isDataURL(url);
+  }
+  function isRequestURL(url) {
+    return url.startsWith("http:") || url.startsWith("https:");
+  }
+  function isDataURL(url) {
+    return url.startsWith("data:");
+  }
   async function fetchFile(urlOrData, fetchOptions) {
     if (typeof urlOrData === "string") {
       const url = resolvePath(urlOrData);
+      if (isNodePath(url) && node3?.fetchFileNode) {
+        return node3.fetchFileNode(url, fetchOptions);
+      }
       return await fetch(url, fetchOptions);
     }
     return await makeResponse(urlOrData);
@@ -1230,7 +1261,7 @@
   var navigator_ = globalThis.navigator || {};
 
   // ../../node_modules/@probe.gl/log/node_modules/@probe.gl/env/dist/utils/globals.js
-  var VERSION3 = true ? "4.0.0-alpha.17" : "untranspiled source";
+  var VERSION3 = true ? "4.0.0-alpha.18" : "untranspiled source";
   var isBrowser4 = isBrowser3();
 
   // ../../node_modules/@probe.gl/log/dist/utils/local-storage.js
@@ -4578,7 +4609,7 @@
   _defineProperty(Ellipsoid, "WGS84", new Ellipsoid(WGS84_RADIUS_X, WGS84_RADIUS_Y, WGS84_RADIUS_Z));
 
   // ../images/src/lib/utils/version.ts
-  var VERSION4 = true ? "4.0.0-alpha.17" : "latest";
+  var VERSION4 = true ? "4.0.0-alpha.18" : "latest";
 
   // ../images/src/lib/category-api/image-type.ts
   var { _parseImageNode } = globalThis;
@@ -4975,7 +5006,7 @@
   };
 
   // ../draco/src/lib/utils/version.ts
-  var VERSION5 = true ? "4.0.0-alpha.17" : "latest";
+  var VERSION5 = true ? "4.0.0-alpha.18" : "latest";
 
   // ../draco/src/draco-loader.ts
   var DEFAULT_DRACO_OPTIONS = {
@@ -5520,22 +5551,22 @@
   }
 
   // ../textures/src/lib/utils/version.ts
-  var VERSION6 = true ? "4.0.0-alpha.17" : "beta";
+  var VERSION6 = true ? "4.0.0-alpha.18" : "beta";
 
   // ../textures/src/lib/parsers/basis-module-loader.ts
-  var VERSION7 = true ? "4.0.0-alpha.17" : "beta";
+  var VERSION7 = true ? "4.0.0-alpha.18" : "beta";
   var BASIS_CDN_ENCODER_WASM = `https://unpkg.com/@loaders.gl/textures@${VERSION7}/dist/libs/basis_encoder.wasm`;
   var BASIS_CDN_ENCODER_JS = `https://unpkg.com/@loaders.gl/textures@${VERSION7}/dist/libs/basis_encoder.js`;
   var loadBasisTranscoderPromise;
-  async function loadBasisTrascoderModule(options) {
+  async function loadBasisTranscoderModule(options) {
     const modules = options.modules || {};
     if (modules.basis) {
       return modules.basis;
     }
-    loadBasisTranscoderPromise = loadBasisTranscoderPromise || loadBasisTrascoder(options);
+    loadBasisTranscoderPromise = loadBasisTranscoderPromise || loadBasisTranscoder(options);
     return await loadBasisTranscoderPromise;
   }
-  async function loadBasisTrascoder(options) {
+  async function loadBasisTranscoder(options) {
     let BASIS = null;
     let wasmBinary = null;
     [BASIS, wasmBinary] = await Promise.all([
@@ -5543,9 +5574,9 @@
       await loadLibrary("basis_transcoder.wasm", "textures", options)
     ]);
     BASIS = BASIS || globalThis.BASIS;
-    return await initializeBasisTrascoderModule(BASIS, wasmBinary);
+    return await initializeBasisTranscoderModule(BASIS, wasmBinary);
   }
-  function initializeBasisTrascoderModule(BasisModule, wasmBinary) {
+  function initializeBasisTranscoderModule(BasisModule, wasmBinary) {
     const options = {};
     if (wasmBinary) {
       options.wasmBinary = wasmBinary;
@@ -5981,7 +6012,7 @@
         const fileConstructors = await loadBasisEncoderModule(options);
         return parseKTX2File(fileConstructors.KTX2File, data, options);
       }
-      const { BasisFile } = await loadBasisTrascoderModule(options);
+      const { BasisFile } = await loadBasisTranscoderModule(options);
       return parseBasisFile(BasisFile, data, options);
     }
     switch (options.basis.module) {
@@ -5996,7 +6027,7 @@
         }
       case "transcoder":
       default:
-        const { BasisFile } = await loadBasisTrascoderModule(options);
+        const { BasisFile } = await loadBasisTranscoderModule(options);
         return parseBasisFile(BasisFile, data, options);
     }
   }
@@ -7209,7 +7240,7 @@
   }
 
   // src/i3s-attribute-loader.ts
-  var VERSION8 = true ? "4.0.0-alpha.17" : "latest";
+  var VERSION8 = true ? "4.0.0-alpha.18" : "latest";
   var I3SAttributeLoader = {
     name: "I3S Attribute",
     id: "i3s-attribute",
@@ -7672,7 +7703,7 @@
   }
 
   // src/i3s-content-loader.ts
-  var VERSION9 = true ? "4.0.0-alpha.17" : "beta";
+  var VERSION9 = true ? "4.0.0-alpha.18" : "beta";
   var I3SContentLoader = {
     name: "I3S Content (Indexed Scene Layers)",
     id: "i3s-content",

package/dist/i3s-loader.js

@@ -82,10 +82,8 @@ async function parseTileset(data, options, context) {
     if (tilesetJson?.layerType === POINT_CLOUD) {
         throw new Error('Point Cloud layers currently are not supported by I3SLoader');
     }
-    // eslint-disable-next-line no-use-before-define
-    tilesetJson.loader = exports.I3SLoader;
-    await (0, parse_i3s_1.normalizeTilesetData)(tilesetJson, options, context);
-    return tilesetJson;
+    const tilesetPostprocessed = await (0, parse_i3s_1.normalizeTilesetData)(tilesetJson, options, context);
+    return tilesetPostprocessed;
 }
 async function parseTile(data, context) {
     data = JSON.parse(new TextDecoder().decode(data));

package/dist/index.d.ts

@@ -1,5 +1,6 @@
-export type { BoundingVolumes, Mbs, Obb, SceneLayer3D, AttributeStorageInfo, Field, ESRIField, PopupInfo, Node3DIndexDocument, LodSelection, NodeReference, Resource, MaxScreenThresholdSQ, NodeInPage, SharedResources, Attribute, Extent, FeatureAttribute, FieldInfo, I3SMaterialDefinition, TextureDefinitionInfo, MaterialDefinitionInfo, FullExtent, StatisticsInfo, StatsInfo, Histogram, ValueCount, BuildingSceneSublayer, OperationalLayer, TextureSetDefinitionFormats } from './types';
+export type { BoundingVolumes, Mbs, Obb, I3STilesetHeader, I3STileContent, I3STileHeader, SceneLayer3D, AttributeStorageInfo, Field, ESRIField, PopupInfo, Node3DIndexDocument, LodSelection, NodeReference, Resource, MaxScreenThresholdSQ, NodeInPage, SharedResources, Attribute, Extent, FeatureAttribute, FieldInfo, I3SMaterialDefinition, TextureDefinitionInfo, MaterialDefinitionInfo, FullExtent, StatisticsInfo, StatsInfo, Histogram, ValueCount, BuildingSceneSublayer, OperationalLayer, TextureSetDefinitionFormats } from './types';
 export type { FileProvider } from './lib/parsers/parse-zip/file-provider';
+export type { I3SLoaderOptions } from './i3s-loader';
 export { COORDINATE_SYSTEM } from './lib/parsers/constants';
 export { I3SLoader } from './i3s-loader';
 export { SLPKLoader } from './i3s-slpk-loader';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,YAAY,EACV,eAAe,EACf,GAAG,EACH,GAAG,EACH,YAAY,EACZ,oBAAoB,EACpB,KAAK,EACL,SAAS,EACT,SAAS,EACT,mBAAmB,EACnB,YAAY,EACZ,aAAa,EACb,QAAQ,EACR,oBAAoB,EACpB,UAAU,EACV,eAAe,EACf,SAAS,EACT,MAAM,EACN,gBAAgB,EAChB,SAAS,EACT,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,EACtB,UAAU,EACV,cAAc,EACd,SAAS,EACT,SAAS,EACT,UAAU,EACV,qBAAqB,EACrB,gBAAgB,EAChB,2BAA2B,EAC5B,MAAM,SAAS,CAAC;AACjB,YAAY,EAAC,YAAY,EAAC,MAAM,uCAAuC,CAAC;AAExE,OAAO,EAAC,iBAAiB,EAAC,MAAM,yBAAyB,CAAC;AAE1D,OAAO,EAAC,SAAS,EAAC,MAAM,cAAc,CAAC;AACvC,OAAO,EAAC,UAAU,EAAC,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAC,gBAAgB,EAAC,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAC,kBAAkB,EAAE,qBAAqB,EAAC,MAAM,wBAAwB,CAAC;AACjF,OAAO,EAAC,2BAA2B,EAAC,MAAM,mCAAmC,CAAC;AAC9E,OAAO,EAAC,iBAAiB,EAAC,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAC,oBAAoB,EAAC,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAC,uBAAuB,EAAC,MAAM,2CAA2C,CAAC;AAClF,OAAO,EAAC,SAAS,EAAC,MAAM,qCAAqC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,YAAY,EACV,eAAe,EACf,GAAG,EACH,GAAG,EACH,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,YAAY,EACZ,oBAAoB,EACpB,KAAK,EACL,SAAS,EACT,SAAS,EACT,mBAAmB,EACnB,YAAY,EACZ,aAAa,EACb,QAAQ,EACR,oBAAoB,EACpB,UAAU,EACV,eAAe,EACf,SAAS,EACT,MAAM,EACN,gBAAgB,EAChB,SAAS,EACT,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,EACtB,UAAU,EACV,cAAc,EACd,SAAS,EACT,SAAS,EACT,UAAU,EACV,qBAAqB,EACrB,gBAAgB,EAChB,2BAA2B,EAC5B,MAAM,SAAS,CAAC;AACjB,YAAY,EAAC,YAAY,EAAC,MAAM,uCAAuC,CAAC;AACxE,YAAY,EAAC,gBAAgB,EAAC,MAAM,cAAc,CAAC;AAEnD,OAAO,EAAC,iBAAiB,EAAC,MAAM,yBAAyB,CAAC;AAE1D,OAAO,EAAC,SAAS,EAAC,MAAM,cAAc,CAAC;AACvC,OAAO,EAAC,UAAU,EAAC,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAC,gBAAgB,EAAC,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAC,kBAAkB,EAAE,qBAAqB,EAAC,MAAM,wBAAwB,CAAC;AACjF,OAAO,EAAC,2BAA2B,EAAC,MAAM,mCAAmC,CAAC;AAC9E,OAAO,EAAC,iBAAiB,EAAC,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAC,oBAAoB,EAAC,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAC,uBAAuB,EAAC,MAAM,2CAA2C,CAAC;AAClF,OAAO,EAAC,SAAS,EAAC,MAAM,qCAAqC,CAAC"}

package/dist/lib/helpers/i3s-nodepages-tiles.d.ts

@@ -1,10 +1,10 @@
 import type { LoaderOptions } from '@loaders.gl/loader-utils';
-import { I3STilesetHeader, NodePage, NodeInPage, I3STextureFormat, I3STileHeader } from '../../types';
+import { NodePage, NodeInPage, I3STextureFormat, I3STileHeader, SceneLayer3D } from '../../types';
 /**
  * class I3SNodePagesTiles - loads nodePages and form i3s tiles from them
  */
 export default class I3SNodePagesTiles {
-    tileset: I3STilesetHeader;
+    tileset: SceneLayer3D;
     nodePages: NodePage[];
     pendingNodePages: {
         promise: Promise<NodePage>;
@@ -18,14 +18,16 @@ export default class I3SNodePagesTiles {
         name: string;
     } | null)[];
     nodesInNodePages: number;
+    url: string;
     private textureLoaderOptions;
     /**
      * @constructs
      * Create a I3SNodePagesTiles instance.
      * @param tileset - i3s tileset header ('layers/0')
+     * @param url - tileset url
      * @param options - i3s loader options
      */
-    constructor(tileset: I3STilesetHeader, options: LoaderOptions);
+    constructor(tileset: SceneLayer3D, url: string | undefined, options: LoaderOptions);
     /**
      * Loads some nodePage and return a particular node from it
      * @param id - id of node through all node pages

package/dist/lib/helpers/i3s-nodepages-tiles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"i3s-nodepages-tiles.d.ts","sourceRoot":"","sources":["../../../src/lib/helpers/i3s-nodepages-tiles.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EACL,gBAAgB,EAEhB,QAAQ,EACR,UAAU,EAIV,gBAAgB,EAEhB,aAAa,EACd,MAAM,aAAa,CAAC;AAErB;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,iBAAiB;IACpC,OAAO,EAAE,gBAAgB,CAAC;IAC1B,SAAS,EAAE,QAAQ,EAAE,CAAM;IAC3B,gBAAgB,EAAE;QAAC,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;QAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAAA;KAAC,EAAE,CAAM;IAClF,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,aAAa,CAAC;IACvB,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,iCAAiC,EAAE,CAAC;QAAC,MAAM,EAAE,gBAAgB,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAC,GAAG,IAAI,CAAC,EAAE,CAAM;IAC5F,gBAAgB,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,oBAAoB,CAA4B;IAExD;;;;;OAKG;gBACS,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,aAAa;IAU7D;;;OAGG;IACG,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAuBlD;;;OAGG;IAEG,qBAAqB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IA4D/D;;;;;;OAMG;IACH,OAAO,CAAC,aAAa;IA8BrB;;;;OAIG;IACH,OAAO,CAAC,eAAe;IAiBvB;;;;;;;OAOG;IACH,OAAO,CAAC,0BAA0B;IAuBlC;;;;OAIG;IACH,OAAO,CAAC,wCAAwC;IA2BhD;;;OAGG;IACH,OAAO,CAAC,0BAA0B;CAwBnC"}
+{"version":3,"file":"i3s-nodepages-tiles.d.ts","sourceRoot":"","sources":["../../../src/lib/helpers/i3s-nodepages-tiles.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAEL,QAAQ,EACR,UAAU,EAIV,gBAAgB,EAEhB,aAAa,EACb,YAAY,EACb,MAAM,aAAa,CAAC;AAErB;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,iBAAiB;IACpC,OAAO,EAAE,YAAY,CAAC;IACtB,SAAS,EAAE,QAAQ,EAAE,CAAM;IAC3B,gBAAgB,EAAE;QAAC,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;QAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAAA;KAAC,EAAE,CAAM;IAClF,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,aAAa,CAAC;IACvB,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,iCAAiC,EAAE,CAAC;QAAC,MAAM,EAAE,gBAAgB,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAC,GAAG,IAAI,CAAC,EAAE,CAAM;IAC5F,gBAAgB,EAAE,MAAM,CAAC;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,oBAAoB,CAA4B;IAExD;;;;;;OAMG;gBACS,OAAO,EAAE,YAAY,EAAE,GAAG,oBAAa,EAAE,OAAO,EAAE,aAAa;IAW3E;;;OAGG;IACG,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAuBlD;;;OAGG;IAEG,qBAAqB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAgE/D;;;;;;OAMG;IACH,OAAO,CAAC,aAAa;IA8BrB;;;;OAIG;IACH,OAAO,CAAC,eAAe;IAiBvB;;;;;;;OAOG;IACH,OAAO,CAAC,0BAA0B;IAuBlC;;;;OAIG;IACH,OAAO,CAAC,wCAAwC;IA2BhD;;;OAGG;IACH,OAAO,CAAC,0BAA0B;CAwBnC"}

package/dist/lib/helpers/i3s-nodepages-tiles.js

@@ -13,14 +13,16 @@ class I3SNodePagesTiles {
      * @constructs
      * Create a I3SNodePagesTiles instance.
      * @param tileset - i3s tileset header ('layers/0')
+     * @param url - tileset url
      * @param options - i3s loader options
      */
-    constructor(tileset, options) {
+    constructor(tileset, url = '', options) {
         this.nodePages = [];
         this.pendingNodePages = [];
         this.textureDefinitionsSelectedFormats = [];
         this.textureLoaderOptions = {};
         this.tileset = { ...tileset }; // spread the tileset to avoid circular reference
+        this.url = url;
         this.nodesPerPage = tileset.nodePages?.nodesPerPage || 64;
         this.lodSelectionMetricType = tileset.nodePages?.lodSelectionMetricType;
         this.options = options;
@@ -34,7 +36,7 @@ class I3SNodePagesTiles {
     async getNodeById(id) {
         const pageIndex = Math.floor(id / this.nodesPerPage);
         if (!this.nodePages[pageIndex] && !this.pendingNodePages[pageIndex]) {
-            const nodePageUrl = (0, url_utils_1.getUrlWithToken)(`${this.tileset.url}/nodepages/${pageIndex}`, 
+            const nodePageUrl = (0, url_utils_1.getUrlWithToken)(`${this.url}/nodepages/${pageIndex}`, 
             // @ts-expect-error this.options is not properly typed
             this.options.i3s?.token);
             this.pendingNodePages[pageIndex] = {
@@ -86,10 +88,10 @@ class I3SNodePagesTiles {
             materialDefinition = nodeMaterialDefinition;
             textureFormat = textureData.format || textureFormat;
             if (textureData.name) {
-                textureUrl = `${this.tileset.url}/nodes/${node.mesh.material.resource}/textures/${textureData.name}`;
+                textureUrl = `${this.url}/nodes/${node.mesh.material.resource}/textures/${textureData.name}`;
             }
             if (this.tileset.attributeStorageInfo) {
-                attributeUrls = (0, url_utils_1.generateTilesetAttributeUrls)(this.tileset, node.mesh.attribute.resource);
+                attributeUrls = (0, url_utils_1.generateTilesetAttributeUrls)(this.tileset, this.url, node.mesh.attribute.resource);
             }
         }
         const lodSelection = this.getLodSelection(node);
@@ -131,7 +133,7 @@ class I3SNodePagesTiles {
         if (geometryIndex !== -1) {
             const isDracoGeometry = Boolean(geometryDefinition.geometryBuffers[geometryIndex].compressedAttributes);
             result = {
-                url: `${this.tileset.url}/nodes/${meshGeometryData.resource}/geometries/${geometryIndex}`,
+                url: `${this.url}/nodes/${meshGeometryData.resource}/geometries/${geometryIndex}`,
                 isDracoGeometry
             };
         }

package/dist/lib/parsers/parse-i3s.d.ts

@@ -1,6 +1,6 @@
-import { I3STilesetHeader, I3STileHeader, I3SMinimalNodeData, Node3DIndexDocument } from '../../types';
+import { I3STilesetHeader, I3STileHeader, I3SMinimalNodeData, Node3DIndexDocument, SceneLayer3D } from '../../types';
 import type { LoaderOptions, LoaderContext } from '@loaders.gl/loader-utils';
 export declare function normalizeTileData(tile: Node3DIndexDocument, context: LoaderContext): I3STileHeader;
 export declare function normalizeTileNonUrlData(tile: I3SMinimalNodeData): I3STileHeader;
-export declare function normalizeTilesetData(tileset: I3STilesetHeader, options: LoaderOptions, context: LoaderContext): Promise<void>;
+export declare function normalizeTilesetData(tileset: SceneLayer3D, options: LoaderOptions, context: LoaderContext): Promise<I3STilesetHeader>;
 //# sourceMappingURL=parse-i3s.d.ts.map

package/dist/lib/parsers/parse-i3s.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parse-i3s.d.ts","sourceRoot":"","sources":["../../../src/lib/parsers/parse-i3s.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,gBAAgB,EAChB,aAAa,EAEb,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAC,aAAa,EAAE,aAAa,EAAC,MAAM,0BAA0B,CAAC;AAE3E,wBAAgB,iBAAiB,CAAC,IAAI,EAAG,mBAAmB,EAAE,OAAO,EAAE,aAAa,GAAG,aAAa,CAyBnG;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAG,kBAAkB,GAAG,aAAa,CAmChF;AAED,wBAAsB,oBAAoB,CAAC,OAAO,EAAG,gBAAgB,EAAE,OAAO,EAAG,aAAa,EAAE,OAAO,EAAE,aAAa,iBA0BrH"}
+{"version":3,"file":"parse-i3s.d.ts","sourceRoot":"","sources":["../../../src/lib/parsers/parse-i3s.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,gBAAgB,EAChB,aAAa,EAEb,kBAAkB,EAClB,mBAAmB,EACnB,YAAY,EACb,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAC,aAAa,EAAE,aAAa,EAAC,MAAM,0BAA0B,CAAC;AAG3E,wBAAgB,iBAAiB,CAAC,IAAI,EAAG,mBAAmB,EAAE,OAAO,EAAE,aAAa,GAAG,aAAa,CA6BnG;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAG,kBAAkB,GAAG,aAAa,CAkChF;AAED,wBAAsB,oBAAoB,CAAC,OAAO,EAAG,YAAY,EAAE,OAAO,EAAG,aAAa,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA8B7I"}

package/dist/lib/parsers/parse-i3s.js

@@ -10,6 +10,7 @@ const core_1 = require("@loaders.gl/core");
 const tiles_1 = require("@loaders.gl/tiles");
 const i3s_nodepages_tiles_1 = __importDefault(require("../helpers/i3s-nodepages-tiles"));
 const url_utils_1 = require("../utils/url-utils");
+const i3s_loader_1 = require("../../i3s-loader");
 function normalizeTileData(tile, context) {
     const url = context.url || '';
     let contentUrl;
@@ -24,11 +25,14 @@ function normalizeTileData(tile, context) {
     if (tile.attributeData) {
         attributeUrls = (0, url_utils_1.generateTileAttributeUrls)(url, tile);
     }
+    const children = tile.children || [];
     return normalizeTileNonUrlData({
         ...tile,
+        children,
         url,
         contentUrl,
         textureUrl,
+        textureFormat: 'jpg',
         attributeUrls,
         isDracoGeometry: false
     });
@@ -57,26 +61,27 @@ function normalizeTileNonUrlData(tile) {
     }
     const lodMetricType = tile.lodSelection?.[0].metricType;
     const lodMetricValue = tile.lodSelection?.[0].maxError;
-    const transformMatrix = tile.transform;
     const type = tiles_1.TILE_TYPE.MESH;
     /**
      * I3S specification supports only REPLACE
      */
     const refine = tiles_1.TILE_REFINEMENT.REPLACE;
-    return { ...tile, mbs, boundingVolume, lodMetricType, lodMetricValue, transformMatrix, type, refine };
+    return { ...tile, mbs, boundingVolume, lodMetricType, lodMetricValue, type, refine };
 }
 exports.normalizeTileNonUrlData = normalizeTileNonUrlData;
 async function normalizeTilesetData(tileset, options, context) {
-    tileset.url = context.url;
+    const url = context.url;
+    let nodePagesTile;
+    let root;
     if (tileset.nodePages) {
-        tileset.nodePagesTile = new i3s_nodepages_tiles_1.default(tileset, options);
-        tileset.root = tileset.nodePagesTile.formTileFromNodePages(0);
+        nodePagesTile = new i3s_nodepages_tiles_1.default(tileset, url, options);
+        root = await nodePagesTile.formTileFromNodePages(0);
     }
     else {
         // @ts-expect-error options is not properly typed
         const rootNodeUrl = (0, url_utils_1.getUrlWithToken)(`${tileset.url}/nodes/root`, options.i3s?.token);
         // eslint-disable-next-line no-use-before-define
-        tileset.root = await (0, core_1.load)(rootNodeUrl, tileset.loader, {
+        root = await (0, core_1.load)(rootNodeUrl, i3s_loader_1.I3SLoader, {
             ...options,
             i3s: {
                 // @ts-expect-error options is not properly typed
@@ -85,11 +90,15 @@ async function normalizeTilesetData(tileset, options, context) {
             }
         });
     }
-    // base path that non-absolute paths in tileset are relative to.
-    tileset.basePath = tileset.url;
-    tileset.type = tiles_1.TILESET_TYPE.I3S;
-    // populate from root node
-    tileset.lodMetricType = tileset.root.lodMetricType;
-    tileset.lodMetricValue = tileset.root.lodMetricValue;
+    return {
+        ...tileset,
+        url,
+        basePath: url,
+        type: tiles_1.TILESET_TYPE.I3S,
+        nodePagesTile,
+        root,
+        lodMetricType: root.lodMetricType,
+        lodMetricValue: root.lodMetricValue
+    };
 }
 exports.normalizeTilesetData = normalizeTilesetData;

package/dist/lib/utils/url-utils.d.ts

@@ -1,4 +1,4 @@
-import { Node3DIndexDocument } from '../../types';
+import { Node3DIndexDocument, SceneLayer3D } from '../../types';
 /**
  * Generates url with token if it is exists.
  * @param url
@@ -14,9 +14,10 @@ export declare function getUrlWithToken(url: string, token?: string | null): str
 export declare function generateTileAttributeUrls(url: string, tile: Node3DIndexDocument): string[];
 /**
  * Generates attribute urls for tileset based on tileset and resource
- * @param {Object} tileset
- * @param {number} resource
+ * @param tileset - tileset metadata
+ * @param url - tileset base url
+ * @param resource - resource id per I3S spec
  * @returns {Array}
  */
-export declare function generateTilesetAttributeUrls(tileset: any, resource: any): string[];
+export declare function generateTilesetAttributeUrls(tileset: SceneLayer3D, url: string, resource: number): string[];
 //# sourceMappingURL=url-utils.d.ts.map

package/dist/lib/utils/url-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"url-utils.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/url-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,mBAAmB,EAAC,MAAM,aAAa,CAAC;AAEhD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,GAAE,MAAM,GAAG,IAAW,GAAG,MAAM,CAEhF;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,mBAAmB,GAAG,MAAM,EAAE,CAU1F;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,KAAA,EAAE,QAAQ,KAAA,YAU7D"}
+{"version":3,"file":"url-utils.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/url-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,mBAAmB,EAAE,YAAY,EAAC,MAAM,aAAa,CAAC;AAE9D;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,GAAE,MAAM,GAAG,IAAW,GAAG,MAAM,CAEhF;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,mBAAmB,GAAG,MAAM,EAAE,CAU1F;AAED;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,YAUhG"}

package/dist/lib/utils/url-utils.js

@@ -28,13 +28,14 @@ function generateTileAttributeUrls(url, tile) {
 exports.generateTileAttributeUrls = generateTileAttributeUrls;
 /**
  * Generates attribute urls for tileset based on tileset and resource
- * @param {Object} tileset
- * @param {number} resource
+ * @param tileset - tileset metadata
+ * @param url - tileset base url
+ * @param resource - resource id per I3S spec
  * @returns {Array}
  */
-function generateTilesetAttributeUrls(tileset, resource) {
+function generateTilesetAttributeUrls(tileset, url, resource) {
     const attributeUrls = [];
-    const { attributeStorageInfo, url } = tileset;
+    const { attributeStorageInfo = [] } = tileset;
     for (let index = 0; index < attributeStorageInfo.length; index++) {
         const fileName = attributeStorageInfo[index].key;
         attributeUrls.push(`${url}/nodes/${resource}/attributes/${fileName}/0`);

package/dist/types.d.ts

@@ -1,14 +1,26 @@
 import type { Matrix4, Quaternion, Vector3 } from '@math.gl/core';
 import type { TypedArray, MeshAttribute, TextureLevel } from '@loaders.gl/schema';
-import { Tile3D, Tileset3D } from '@loaders.gl/tiles';
+import { TILESET_TYPE, TILE_REFINEMENT, TILE_TYPE, Tile3D, Tileset3D } from '@loaders.gl/tiles';
+import I3SNodePagesTiles from './lib/helpers/i3s-nodepages-tiles';
 export type COLOR = [number, number, number, number];
 /**
- * spec - https://github.com/Esri/i3s-spec/blob/master/docs/1.8/3DSceneLayer.cmn.md
+ * Extension of SceneLayer3D JSON with postprocessed loader data
  */
 export interface I3STilesetHeader extends SceneLayer3D {
     /** Not in spec, but is necessary for woking */
     url?: string;
-    [key: string]: any;
+    /** Base path that non-absolute paths in tileset are relative to. */
+    basePath?: string;
+    /** root node metadata */
+    root: I3STileHeader;
+    /** instance of the NodePages to tiles loader */
+    nodePagesTile?: I3SNodePagesTiles;
+    /** Type of the tileset */
+    type: TILESET_TYPE.I3S;
+    /** LOD metric type per I3S spec*/
+    lodMetricType?: string;
+    /** LOD metric value */
+    lodMetricValue?: number;
 }
 /** https://github.com/Esri/i3s-spec/blob/master/docs/1.8/nodePage.cmn.md */
 export type NodePage = {
@@ -53,18 +65,64 @@ type meshAttribute = {
     /** The resource identifier to be used to locate attribute resources of this mesh. i.e. layers/0/nodes/<resource id>/attributes/... */
     resource: number;
 };
+/**
+ * Texture format
+ * @see https://github.com/Esri/i3s-spec/blob/master/docs/1.7/textureSetDefinitionFormat.cmn.md
+ */
 export type I3STextureFormat = 'jpg' | 'png' | 'ktx-etc2' | 'dds' | 'ktx2';
-export type I3STileHeader = {
-    isDracoGeometry: boolean;
-    textureUrl?: string;
-    url?: string;
-    textureFormat?: I3STextureFormat;
-    textureLoaderOptions?: any;
-    materialDefinition?: I3SMaterialDefinition;
+/** Postprocessed I3S Node */
+export type I3STileHeader = I3SMinimalNodeData & {
+    /** MBS per I3S spec */
     mbs: Mbs;
-    obb?: Obb;
+    /** Material definition from the layer metadata per I3S spec */
+    materialDefinition?: I3SMaterialDefinition;
+    /** Bounding volume converted to 3DTiles format. It is generic for `tile` module */
+    boundingVolume: {
+        box?: number[];
+        sphere?: number[];
+    };
+    /** LOD metric selected for usage */
+    lodMetricType?: string;
+    /** LOD metric value */
+    lodMetricValue?: number;
+    /** Tile content type */
+    type: TILE_TYPE.MESH;
+    /** Tile refinement type. I3S supports only `REPLACE` */
+    refine: TILE_REFINEMENT.REPLACE;
+};
+/**
+ * Minimal I3S node data is needed for loading
+ * These data can come from 3DNodeIndexDocument (I3S spec) or from `I3SNodePagesTiles` instance
+ * @see https://github.com/Esri/i3s-spec/blob/master/docs/1.7/3DNodeIndexDocument.cmn.md
+ */
+export type I3SMinimalNodeData = {
+    /** Node ID */
+    id: string;
+    /** Node base path */
+    url?: string;
+    /** LOD selection metrics  */
     lodSelection?: LodSelection[];
-    [key: string]: any;
+    obb?: Obb;
+    /** MBS per I3S spec */
+    mbs?: Mbs;
+    /** Geometry content URL */
+    contentUrl?: string;
+    /** Texture image URL */
+    textureUrl?: string;
+    /** Feature attributes URLs */
+    attributeUrls?: string[];
+    /** Material definition from I3S layer metadata */
+    materialDefinition?: I3SMaterialDefinition;
+    /** Texture format per I3S spec */
+    textureFormat: I3STextureFormat;
+    /** Loader options for texture loader. The loader might be `CompressedTextureLoader` for `dds`, BasisLoader for `ktx2` or ImageLoader for `jpg`and `png` */
+    textureLoaderOptions?: {
+        [key: string]: any;
+    };
+    /** Child Nodes references  */
+    children: NodeReference[];
+    /** Is the node has Draco compressed geometry */
+    isDracoGeometry: boolean;
 };
 export type I3SParseOptions = {
     /** ArcGIS access token */
@@ -89,13 +147,20 @@ export type I3SParseOptions = {
      * Supported coordinate systems: METER_OFFSETS, LNGLAT_OFFSETS
      */
     coordinateSystem?: number;
+    /** Options to colorize 3DObjects by attribute value */
     colorsByAttribute?: {
+        /** Feature attribute name */
         attributeName: string;
+        /** Minimum attribute value */
         minValue: number;
+        /** Maximum attribute value */
         maxValue: number;
+        /** Minimum color. 3DObject will be colorized with gradient from `minColor to `maxColor` */
         minColor: COLOR;
+        /** Maximum color. 3DObject will be colorized with gradient from `minColor to `maxColor` */
         maxColor: COLOR;
-        mode: string;
+        /** Colorization mode. `replace` - replace vertex colors with a new colors, `multiply` - multiply vertex colors with new colors */
+        mode: 'multiply' | 'replace';
     };
     /** @deprecated */
     tile?: Tile3D | I3STileOptions;
@@ -139,11 +204,19 @@ export type BoundingVolumes = {
     mbs: Mbs;
     obb: Obb;
 };
+/**
+ * Oriented bounding box per I3S spec
+ * @see https://github.com/Esri/i3s-spec/blob/master/docs/1.7/obb.cmn.md
+ */
 export type Obb = {
     center: number[] | Vector3;
     halfSize: number[] | Vector3;
     quaternion: number[] | Quaternion;
 };
+/**
+ * Minimum bounding sphere per I3S spec
+ * @see https://github.com/Esri/i3s-spec/blob/master/docs/1.7/3DNodeIndexDocument.cmn.md#properties
+ */
 export type Mbs = [number, number, number, number];
 /** SceneLayer3D based on I3S specification - https://github.com/Esri/i3s-spec/blob/master/docs/1.8/3DSceneLayer.cmn.md */
 export type SceneLayer3D = {
@@ -345,36 +418,31 @@ export type Node3DIndexDocument = {
     expires?: string;
 };
 /**
- * Minimal I3S node data is needed for loading
+ * LOD selection metrics per I3S spec
+ * @see https://github.com/Esri/i3s-spec/blob/master/docs/1.7/lodSelection.cmn.md
  */
-export type I3SMinimalNodeData = {
-    id: string;
-    url?: string;
-    transform?: number[];
-    lodSelection?: LodSelection[];
-    obb?: Obb;
-    mbs?: Mbs;
-    contentUrl?: string;
-    textureUrl?: string;
-    attributeUrls?: string[];
-    materialDefinition?: I3SMaterialDefinition;
-    textureFormat?: I3STextureFormat;
-    textureLoaderOptions?: {
-        [key: string]: any;
-    };
-    children?: NodeReference[];
-    isDracoGeometry: boolean;
-};
 export type LodSelection = {
+    /**  */
     metricType?: string;
     maxError: number;
 };
+/**
+ * Node reference per I3S spec
+ * @see https://github.com/Esri/i3s-spec/blob/master/docs/1.7/nodeReference.cmn.md
+ */
 export type NodeReference = {
+    /** Tree Key ID of the referenced node represented as string. */
     id: string;
+    /** Version (store update session ID) of the referenced node. */
     version?: string;
+    /** An array of four doubles, corresponding to x, y, z and radius of the minimum bounding sphere of a node. */
     mbs?: Mbs;
+    /** Describes oriented bounding box. */
     obb?: Obb;
+    /** Number of values per element. */
     href?: string;
+    /** Number of features in the referenced node and its descendants, down to the leaf nodes. */
+    featureCount?: number;
 };
 export type Resource = {
     href: string;
@@ -716,7 +784,7 @@ type TextureSetDefinition = {
 };
 /** Spec - https://github.com/Esri/i3s-spec/blob/master/docs/1.8/geometryDefinition.cmn.md */
 type GeometryDefinition = {
-    topology: 'triangle' | string;
+    topology?: 'triangle';
     geometryBuffers: GeometryBuffer[];
 };
 /** Spec - https://github.com/Esri/i3s-spec/blob/master/docs/1.8/geometryBuffer.cmn.md */
@@ -738,7 +806,7 @@ type GeometryBufferItem = {
     type: string;
     component: number;
     encoding?: string;
-    binding: string;
+    binding?: string;
 };
 type AttributeValue = {
     valueType: string;