@loaders.gl/tile-converter 5.0.0-alpha.11 → 5.0.0-alpha.14

package/src/v4/i3s-converter/helpers/geometry-converter.ts

@@ -1,12 +1,15 @@
+import {getConversionMaterials} from './conversion-gltf';
+import type {
+  ConversionAccessor,
+  ConversionMaterial,
+  ConversionNode,
+  ConversionPrimitive,
+  ConversionMesh,
+  ConversionTexture
+} from './conversion-gltf';
 /* eslint-disable camelcase */
-import type {FeatureTableJson, Tiles3DTileContent} from '@loaders.gl/3d-tiles';
+import type {FeatureTableJson, Tiles3DTileContent} from '@loaders.gl/tiles-3d/3d-tiles';
 import type {
-  GLTFAccessorPostprocessed,
-  GLTFMaterialPostprocessed,
-  GLTFNodePostprocessed,
-  GLTFMeshPrimitivePostprocessed,
-  GLTFMeshPostprocessed,
-  GLTFTexturePostprocessed,
   GLTF_EXT_feature_metadata_GLTF,
   GLTF_EXT_feature_metadata_FeatureTable,
   GLTF_EXT_feature_metadata_FeatureTexture,
@@ -23,15 +26,15 @@ import {createRequire} from 'node:module';
 /* @ts-expect-error TS2732: Cannot find module 'node:module' or its corresponding type declarations. */
 
 import {DracoWriterWorker} from '@loaders.gl/draco';
-import {assert, encode} from '@loaders.gl/core';
+import {encode, assert} from '@loaders.gl/core';
 import {
   concatenateArrayBuffers,
   concatenateTypedArrays,
   NumberArray,
   TypedArray
-} from '@loaders.gl/loader-utils';
-import md5 from 'md5';
-import {v4 as uuidv4} from 'uuid';
+} from '@loaders.gl/core/loader-utils';
+import {hashString} from '../../lib/utils/hash-string';
+import {randomUUID} from 'node:crypto';
 import {generateAttributes} from './geometry-attributes';
 import {encodeStringAttribute} from './encode-string-attribute';
 import {createBoundingVolumesFromGeometry} from './coordinate-converter';
@@ -47,21 +50,21 @@ import {
   I3SMaterialDefinition,
   MaterialDefinitionInfo,
   TextureDefinitionInfo
-} from '@loaders.gl/i3s';
-import {Geoid} from '@math.gl/geoid';
+} from '@loaders.gl/tiles-3d/i3s';
+import {Geoid} from '@math.gl/earth/geoid';
 import {prepareDataForAttributesConversion} from './gltf-attributes';
 import {getTextureByMetadataClass, handleBatchIdsExtensions} from './batch-ids-extensions';
 import {checkPropertiesLength, flattenPropertyTableByFeatureIds} from './feature-attributes';
-import {GL} from '@math.gl/geometry-utils';
+import {GL} from '@math.gl/geometry/utils';
 
 /*
-  At the moment of writing the type TypedArrayConstructor is not exported in '@math.gl/types'.
+  At the moment of writing the type TypedArrayConstructor is not exported in '@math.gl/core/types'.
   So the following import is replaced with the local import
-  import type {TypedArrayConstructor} from '@math.gl/types'; 
+  import type {TypedArrayConstructor} from '@math.gl/core/types';
 */
-import type {GLTFAttributesData, TextureImageProperties, TypedArrayConstructor} from '../types';
+import type {GLTFAttributesData, TextureImageProperties} from '../types';
 import {generateSyntheticIndices} from '../../lib/utils/geometry-utils';
-import {BoundingSphere, OrientedBoundingBox} from '@math.gl/culling';
+import {BoundingSphere, OrientedBoundingBox} from '@math.gl/geometry/culling';
 
 import {EXT_FEATURE_METADATA, EXT_STRUCTURAL_METADATA} from '@loaders.gl/gltf';
 
@@ -136,7 +139,7 @@ export default async function convertB3dmToI3sGeometry({
 }): Promise<I3SConvertedResources[] | null> {
   const useCartesianPositions = generateBoundingVolumes;
   const materialAndTextureList: I3SMaterialWithTexture[] = await convertMaterials(
-    tileContent.gltf?.materials,
+    tileContent.gltf ? getConversionMaterials(tileContent.gltf) : [],
     shouldMergeMaterials
   );
 
@@ -339,7 +342,10 @@ async function _makeNodeResources({
     compressedGeometry,
     texture,
     hasUvRegions: Boolean(uvRegions.length),
-    sharedResources: getSharedResources(tileContent.gltf?.materials || [], nodeId),
+    sharedResources: getSharedResources(
+      tileContent.gltf ? getConversionMaterials(tileContent.gltf) : [],
+      nodeId
+    ),
     meshMaterial: material,
     vertexCount,
     attributes,
@@ -437,7 +443,7 @@ function convertNodes({
   matrix = new Matrix4([1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1]),
   featureTexture
 }: {
-  nodes: GLTFNodePostprocessed[];
+  nodes: ConversionNode[];
   images: (TextureImageProperties | null)[];
   cartographicOrigin: Vector3;
   cartesianModelMatrix: Matrix4;
@@ -468,7 +474,7 @@ function convertNodes({
  * @param node
  * @param matrix
  */
-function getCompositeTransformationMatrix(node: GLTFNodePostprocessed, matrix: Matrix4) {
+function getCompositeTransformationMatrix(node: ConversionNode, matrix: Matrix4) {
   let transformationMatrix = matrix;
 
   const {matrix: nodeMatrix, rotation, scale, translation} = node;
@@ -515,7 +521,7 @@ function convertNode({
   matrix = new Matrix4([1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1]),
   featureTexture
 }: {
-  node: GLTFNodePostprocessed;
+  node: ConversionNode;
   images: (TextureImageProperties | null)[];
   cartographicOrigin: Vector3;
   cartesianModelMatrix: Matrix4;
@@ -578,7 +584,7 @@ function convertMeshToTable({
   matrix,
   featureTexture
 }: {
-  mesh: GLTFMeshPostprocessed;
+  mesh: ConversionMesh;
   images: (TextureImageProperties | null)[];
   cartographicOrigin: Vector3;
   cartesianModelMatrix: Matrix4;
@@ -604,7 +610,8 @@ function convertMeshToTable({
     assert(
       primitive.mode === undefined ||
         primitive.mode === GL.TRIANGLES ||
-        primitive.mode === GL.TRIANGLE_STRIP,
+        primitive.mode === GL.TRIANGLE_STRIP ||
+        primitive.mode === GL.TRIANGLE_FAN,
       `Primitive - unsupported mode ${primitive.mode}`
     );
     const attributes = primitive.attributes;
@@ -661,44 +668,32 @@ function convertMeshToTable({
   }
 }
 /**
- * Converts TRIANGLE-STRIPS to independent TRIANGLES
+ * Converts triangle strips and fans to independent triangles
  * @param primitive - the primitive to get the indices from
  * @returns indices of vertices of the independent triangles
  */
-function normalizeIndices(primitive: GLTFMeshPrimitivePostprocessed): TypedArray {
-  let indices: TypedArray | undefined = primitive.indices?.value;
-  if (!indices) {
-    const positions = primitive.attributes.POSITION.value;
-    return generateSyntheticIndices(positions.length / VALUES_PER_VERTEX);
-  }
-
-  if (indices && primitive.mode === GL.TRIANGLE_STRIP) {
-    /*
-    TRIANGLE_STRIP geometry contains n+2 vertices for n triangles;
-    TRIANGLE geometry contains n*3 vertices for n triangles.
-    The conversion from TRIANGLE_STRIP to TRIANGLE implies duplicating adjacent vertices.
-    */
-    const TypedArrayConstructor = indices.constructor as TypedArrayConstructor;
-    const newIndices = new TypedArrayConstructor((indices.length - 2) * 3);
-
-    // Copy the first triangle indices with no modification like [i0, i1, i2, ...] -> [i0, i1, i2, ...]
-    let triangleIndex = 0;
-    let currentTriangle = indices.slice(0, 3);
-    newIndices.set(currentTriangle, 0);
-
-    // The rest triangle indices are being taken from strips using the following logic:
-    // [i1, i2, i3, i4, i5, i6, ...] -> [i3, i2, i1,   i2, i3, i4,   i5, i4, i3,   i4, i5, i6, ...]
-    for (let i = 1; i + 2 < indices.length; i++) {
-      triangleIndex += 3;
-      currentTriangle = indices.slice(i, i + 3);
-      if (i % 2 === 0) {
-        newIndices.set(currentTriangle, triangleIndex);
-      } else {
-        // The following "reverce" is necessary to calculate normals correctly
-        newIndices.set(currentTriangle.reverse(), triangleIndex);
-      }
-    }
-    indices = newIndices;
+function normalizeIndices(primitive: ConversionPrimitive): TypedArray {
+  const source = primitive.indices?.value;
+  const vertexCount = primitive.attributes.POSITION.value.length / VALUES_PER_VERTEX;
+  const count = source?.length ?? vertexCount;
+  if (primitive.mode !== GL.TRIANGLE_STRIP && primitive.mode !== GL.TRIANGLE_FAN) {
+    return source || generateSyntheticIndices(vertexCount);
+  }
+  const indices = new Uint32Array(Math.max(0, count - 2) * 3);
+  for (let triangleIndex = 0; triangleIndex + 2 < count; triangleIndex++) {
+    const first = primitive.mode === GL.TRIANGLE_FAN ? 0 : triangleIndex;
+    const second =
+      primitive.mode === GL.TRIANGLE_FAN
+        ? triangleIndex + 1
+        : triangleIndex + 1 + (triangleIndex % 2);
+    const third =
+      primitive.mode === GL.TRIANGLE_FAN
+        ? triangleIndex + 2
+        : triangleIndex + 2 - (triangleIndex % 2);
+    indices.set(
+      [source?.[first] ?? first, source?.[second] ?? second, source?.[third] ?? third],
+      triangleIndex * 3
+    );
   }
   return indices;
 }
@@ -822,10 +817,7 @@ function flattenTexCoords(texCoords: TypedArray, indices: TypedArray): Float32Ar
  * @param indices - gltf primitive indices
  * @returns flattened colors attribute
  */
-function flattenColors(
-  colorsAttribute: GLTFAccessorPostprocessed,
-  indices: TypedArray
-): Uint8Array {
+function flattenColors(colorsAttribute: ConversionAccessor, indices: TypedArray): Uint8Array {
   const components = colorsAttribute?.components || VALUES_PER_COLOR_ELEMENT;
   const newColors = new Uint8Array(indices.length * components);
   if (!colorsAttribute) {
@@ -888,9 +880,9 @@ function flattenBatchIds(batchedIds: NumberArray, indices: TypedArray): number[]
  */
 function getBatchIds(
   attributes: {
-    [key: string]: GLTFAccessorPostprocessed;
+    [key: string]: ConversionAccessor;
   },
-  primitive: GLTFMeshPrimitivePostprocessed,
+  primitive: ConversionPrimitive,
   images: (TextureImageProperties | null)[],
   featureTexture: string | null
 ): NumberArray {
@@ -926,7 +918,7 @@ function getBatchIds(
  * @returns Array of Couples I3SMaterialDefinition + texture content
  */
 async function convertMaterials(
-  sourceMaterials: GLTFMaterialPostprocessed[] = [],
+  sourceMaterials: ConversionMaterial[] = [],
   shouldMergeMaterials: boolean
 ): Promise<I3SMaterialWithTexture[]> {
   let materials: I3SMaterialWithTexture[] = [];
@@ -1059,7 +1051,7 @@ async function mergeMaterials(
  * @param sourceMaterial - material object
  * @returns I3S material definition and texture
  */
-export function convertMaterial(sourceMaterial: GLTFMaterialPostprocessed): I3SMaterialWithTexture {
+export function convertMaterial(sourceMaterial: ConversionMaterial): I3SMaterialWithTexture {
   const material: I3SMaterialDefinition = {
     doubleSided: sourceMaterial.doubleSided,
     emissiveFactor: sourceMaterial.emissiveFactor?.map(c => Math.round(c * 255)) as [
@@ -1092,7 +1084,7 @@ export function convertMaterial(sourceMaterial: GLTFMaterialPostprocessed): I3SM
     };
   }
 
-  sourceMaterial.id = Number.isFinite(sourceMaterial.id) ? sourceMaterial.id : uuidv4();
+  sourceMaterial.id ||= randomUUID();
   const mergedMaterials: MergedMaterial[] = [{originalMaterialId: sourceMaterial.id}];
   if (!texture) {
     // Should use default baseColorFactor if it is not present in source material
@@ -1156,7 +1148,7 @@ function getDefaultMaterial(): I3SMaterialDefinition {
  * 2 arrays in format of i3s sharedResources data https://github.com/Esri/i3s-spec/blob/master/docs/1.7/sharedResource.cmn.md
  */
 function getSharedResources(
-  gltfMaterials: GLTFMaterialPostprocessed[],
+  gltfMaterials: ConversionMaterial[],
   nodeId: number
 ): SharedResourcesArrays {
   const i3sResources: SharedResourcesArrays = {};
@@ -1187,7 +1179,7 @@ function getSharedResources(
  * @returns - Couple {materialDefinitionInfo, textureDefinitionInfo} extracted from gltf material data
  */
 function convertGLTFMaterialToI3sSharedResources(
-  gltfMaterial: GLTFMaterialPostprocessed,
+  gltfMaterial: ConversionMaterial,
   nodeId: number
 ): {
   materialDefinitionInfo: MaterialDefinitionInfo;
@@ -1270,7 +1262,7 @@ function extractSharedResourcesMaterialInfo(
  * @returns texture definition infor for shared resource
  */
 function extractSharedResourcesTextureInfo(
-  texture: GLTFTexturePostprocessed,
+  texture: ConversionTexture,
   nodeId: number
 ): TextureDefinitionInfo {
   return {
@@ -1294,7 +1286,7 @@ function extractSharedResourcesTextureInfo(
  * @param nodeId - I3S node ID
  * @returns calculate image ID according to the spec
  */
-function generateImageId(texture: GLTFTexturePostprocessed, nodeId: number) {
+function generateImageId(texture: ConversionTexture, nodeId: number) {
   const {width, height} = texture.source?.image || {};
   if (!width || !height) {
     return '';
@@ -1386,7 +1378,7 @@ function getOrCreateUniqueFeatureId(
   featuresHashArray: any[]
 ): number {
   const batchTableStr = generateStringFromBatchTableByIndex(batchTable, index);
-  const hash = md5(batchTableStr);
+  const hash = hashString(batchTableStr);
 
   if (featuresHashArray.includes(hash)) {
     return featuresHashArray.indexOf(hash);
@@ -1797,14 +1789,14 @@ function getPropertyTableExtension(tileContent: Tiles3DTileContent): {
   extension: string | GLTF_EXT_feature_metadata_GLTF | GLTF_EXT_structural_metadata_GLTF | null;
 } {
   const extensionsWithPropertyTables = [EXT_FEATURE_METADATA, EXT_STRUCTURAL_METADATA];
-  const extensionsUsed = tileContent?.gltf?.extensionsUsed;
+  const extensionsUsed = tileContent?.gltf?.json.extensionsUsed;
 
   if (!extensionsUsed) {
     return {extensionName: null, extension: null};
   }
 
   let extensionName: string = '';
-  for (const extensionItem of tileContent?.gltf?.extensionsUsed || []) {
+  for (const extensionItem of tileContent?.gltf?.json.extensionsUsed || []) {
     if (extensionsWithPropertyTables.includes(extensionItem)) {
       extensionName = extensionItem;
       /*
@@ -1821,7 +1813,7 @@ function getPropertyTableExtension(tileContent: Tiles3DTileContent): {
     return {extensionName: null, extension: null};
   }
 
-  const extension = tileContent?.gltf?.extensions?.[extensionName] as
+  const extension = tileContent?.gltf?.json.extensions?.[extensionName] as
     | string // EXT_mesh_features doesn't have global metadata
     | GLTF_EXT_feature_metadata_GLTF
     | GLTF_EXT_structural_metadata_GLTF;

package/src/v4/i3s-converter/helpers/gltf-attributes.ts

@@ -1,7 +1,9 @@
-import type {Tiles3DTileContent} from '@loaders.gl/3d-tiles';
-import type {GLTFAccessorPostprocessed, GLTFNodePostprocessed} from '@loaders.gl/gltf';
-import {Matrix4, TypedArray, Vector3} from '@math.gl/core';
-import {BoundingSphere, OrientedBoundingBox} from '@math.gl/culling';
+import {getConversionAccessor} from './conversion-gltf';
+import type {GLTFWithBuffers} from '@loaders.gl/gltf';
+import type {ConversionNode} from './conversion-gltf';
+import type {Tiles3DTileContent} from '@loaders.gl/tiles-3d/3d-tiles';
+import {Matrix4, Vector3} from '@math.gl/core';
+import {BoundingSphere, OrientedBoundingBox} from '@math.gl/geometry/culling';
 import {getImageData} from '@loaders.gl/images';
 import {Ellipsoid} from '@math.gl/geospatial';
 import {GLTFAttributesData} from '../types';
@@ -19,32 +21,26 @@ export function prepareDataForAttributesConversion(
   tileTransform: Matrix4,
   boundingVolume: OrientedBoundingBox | BoundingSphere
 ): GLTFAttributesData {
-  const nodes =
-    tileContent.gltf?.scene?.nodes ||
-    tileContent.gltf?.scenes?.[0]?.nodes ||
-    tileContent.gltf?.nodes ||
+  const gltf = tileContent.gltf;
+  const json = gltf?.json;
+  const roots =
+    (json?.scene === undefined ? undefined : json.scenes?.[json.scene]?.nodes) ||
+    json?.scenes?.[0]?.nodes ||
+    json?.nodes?.map((_, index) => index) ||
     [];
-
-  const images =
-    tileContent.gltf?.images?.map(imageObject => {
-      // Need data only for uncompressed images because we can't get batchIds from compressed textures.
-      if (imageObject?.image?.compressed) {
-        return null;
-      }
-      const {data, width, height} = getImageData(imageObject.image);
-      const dataCopy = new Uint8Array(data.length);
-      dataCopy.set(data);
-      return {
-        data: dataCopy,
-        compressed: false,
-        height,
-        width,
-        components: data.length / (width * height),
-        mimeType: imageObject.mimeType
-      };
-    }) || [];
-
-  prepareNodes(nodes);
+  const nodes = gltf ? prepareNodes(gltf, roots) : [];
+  const images = (gltf?.images || []).map((image, index) => {
+    if (!image || (image as any).compressed) return null;
+    const {data, width, height} = getImageData(image);
+    return {
+      data: Uint8Array.from(data),
+      compressed: false,
+      height,
+      width,
+      components: data.length / (width * height),
+      mimeType: json?.images?.[index]?.mimeType
+    };
+  });
 
   const {cartographicOrigin, modelMatrix: cartesianModelMatrix} = calculateTransformProps(
     tileContent,
@@ -60,25 +56,6 @@ export function prepareDataForAttributesConversion(
   };
 }
 
-/**
- * Keep only values for glTF attributes to pass data to worker thread.
- * @param attributes - geometry attributes
- * @returns attributes with only `value` item
- */
-function getB3DMAttributesWithoutBufferView(
-  attributes: Record<string, GLTFAccessorPostprocessed>
-): Record<string, {value: TypedArray}> {
-  const attributesWithoutBufferView: Record<string, {value: TypedArray}> = {};
-
-  for (const attributeName in attributes) {
-    attributesWithoutBufferView[attributeName] = {
-      value: attributes[attributeName].value
-    };
-  }
-
-  return attributesWithoutBufferView;
-}
-
 /**
  * Calculate transformation properties to transform vertex attributes (POSITION, NORMAL, etc.)
  * from METER_OFFSET coorditantes to LNGLAT_OFFSET coordinates
@@ -133,30 +110,37 @@ export function calculateTransformProps(
  * Traverse all nodes to replace all sensible data with copy to avoid data corruption in worker.
  * @param nodes
  */
-function prepareNodes(nodes: GLTFNodePostprocessed[]): void {
-  for (let index = 0; index < nodes.length; index++) {
-    const node = nodes[index] as any;
-
-    if (node.mesh) {
-      nodes[index] = {
-        ...node,
-        mesh: {
-          ...node.mesh,
-          primitives: node.mesh?.primitives.map(primitive => ({
-            ...primitive,
-            indices: {value: primitive?.indices?.value},
-            attributes: getB3DMAttributesWithoutBufferView(primitive.attributes),
-            material: {
-              id: primitive?.material?.id,
-              uniqueId: primitive?.material?.uniqueId
-            }
-          }))
-        }
-      };
-    }
-
-    if (node.children) {
-      prepareNodes(node.children);
-    }
-  }
+function prepareNodes(
+  gltf: GLTFWithBuffers,
+  indices: number[],
+  ancestors = new Set<number>()
+): ConversionNode[] {
+  return indices.map(index => {
+    if (ancestors.has(index)) throw new Error('Cyclic glTF node hierarchy');
+    const node = gltf.json.nodes![index];
+    const mesh = node.mesh === undefined ? undefined : gltf.json.meshes?.[node.mesh];
+    return {
+      ...node,
+      mesh: mesh
+        ? {
+            primitives: mesh.primitives.map(primitive => ({
+              ...primitive,
+              indices:
+                primitive.indices === undefined
+                  ? undefined
+                  : getConversionAccessor(gltf, primitive.indices),
+              attributes: Object.fromEntries(
+                Object.entries(primitive.attributes).map(([name, reference]) => [
+                  name,
+                  getConversionAccessor(gltf, reference)
+                ])
+              ),
+              material:
+                primitive.material === undefined ? undefined : {id: String(primitive.material)}
+            }))
+          }
+        : undefined,
+      children: prepareNodes(gltf, node.children || [], new Set([...ancestors, index]))
+    };
+  });
 }

package/src/v4/i3s-converter/helpers/load-3d-tiles.ts

@@ -3,20 +3,12 @@ import type {
   Tiles3DTileContent,
   Tiles3DTileJSONPostprocessed,
   Tiles3DTilesetJSONPostprocessed
-} from '@loaders.gl/3d-tiles';
-import {Tiles3DArchive} from '@loaders.gl/3d-tiles';
+} from '@loaders.gl/tiles-3d/3d-tiles';
+import {parse3DTilesArchive} from '@loaders.gl/tiles-3d/3d-tiles';
 import {LoaderWithParser, load} from '@loaders.gl/core';
-import type {ReadableFile} from '@loaders.gl/loader-utils';
-import {HttpFile, NodeFile, isBrowser} from '@loaders.gl/loader-utils';
-import {
-  CD_HEADER_SIGNATURE,
-  ZipFileSystem,
-  parseHashTable,
-  parseZipCDFileHeader,
-  parseZipLocalFileHeader,
-  searchFromTheEnd,
-  readRange
-} from '@loaders.gl/zip';
+import type {ReadableFile} from '@loaders.gl/core/loader-utils';
+import {HttpFile, NodeFile, isBrowser} from '@loaders.gl/core/loader-utils';
+import {ZipFileSystem} from '@loaders.gl/archives/zip';
 
 /**
  * Load nested 3DTiles tileset. If the sourceTile is not nested tileset - do nothing
@@ -116,8 +108,7 @@ export async function loadFromArchive(
   if (filename) {
     const tz3Path = `${tz3UrlParts[0]}.3tz`;
     const fileProvider = createReadableFile(tz3Path);
-    const hashTable = await loadHashTable(fileProvider);
-    const archive = new Tiles3DArchive(fileProvider, hashTable, tz3Path);
+    const archive = await parse3DTilesArchive(fileProvider, undefined, tz3Path);
     const fileSystem = new ZipFileSystem(archive);
     const archiveLoadOptions = {
       ...loadOptions,
@@ -145,42 +136,3 @@ function createReadableFile(path: string): ReadableFile {
   }
   return isBrowser ? new HttpFile(path) : new NodeFile(path);
 }
-
-/**
- * Load hash file from 3TZ
- * @param fileProvider - binary reader of 3TZ
- * @returns hash table of the 3TZ file content or undefined if the hash file is not presented inside
- */
-async function loadHashTable(
-  fileProvider: ReadableFile
-): Promise<undefined | Record<string, bigint>> {
-  let hashTable: undefined | Record<string, bigint>;
-
-  const hashCDOffset = await searchFromTheEnd(fileProvider, CD_HEADER_SIGNATURE);
-
-  const cdFileHeader = await parseZipCDFileHeader(hashCDOffset, fileProvider);
-
-  // '@3dtilesIndex1@' is index file that must be the last in the archive. It allows
-  // to improve load and read performance when the archive contains a very large number
-  // of files.
-  if (cdFileHeader?.fileName === '@3dtilesIndex1@') {
-    const localFileHeader = await parseZipLocalFileHeader(
-      cdFileHeader.localHeaderOffset,
-      fileProvider
-    );
-    if (!localFileHeader) {
-      throw new Error('corrupted 3tz');
-    }
-
-    const fileDataOffset = localFileHeader.fileDataOffset;
-    const hashFile = await readRange(
-      fileProvider,
-      fileDataOffset,
-      fileDataOffset + localFileHeader.compressedSize
-    );
-
-    hashTable = parseHashTable(hashFile);
-  }
-
-  return hashTable;
-}

package/src/v4/i3s-converter/helpers/node-debug.ts

@@ -1,5 +1,9 @@
-import type {Mbs, Node3DIndexDocument, Obb} from '@loaders.gl/i3s';
-import {OrientedBoundingBox, BoundingSphere} from '@math.gl/culling';
+import type {Mbs, Node3DIndexDocument, Obb} from '@loaders.gl/tiles-3d/i3s';
+import {
+  OrientedBoundingBox,
+  BoundingSphere,
+  makeOrientedBoundingBoxFromQuaternion
+} from '@math.gl/geometry/culling';
 import {Vector3} from '@math.gl/core';
 import {Ellipsoid} from '@math.gl/geospatial';
 
@@ -85,7 +89,7 @@ function createBoundingSphereFromTileMbs(mbs: Mbs): BoundingSphere {
  */
 function createBoundingBoxFromTileObb(obb: Obb): OrientedBoundingBox {
   const {center, halfSize, quaternion} = obb;
-  return new OrientedBoundingBox().fromCenterHalfSizeQuaternion(center, halfSize, quaternion);
+  return makeOrientedBoundingBoxFromQuaternion(center, halfSize, quaternion);
 }
 
 /**

package/src/v4/i3s-converter/helpers/node-index-document.ts

@@ -5,12 +5,11 @@ import {
   Node3DIndexDocument,
   NodeInPage,
   NodeReference
-} from '@loaders.gl/i3s';
-import transform from 'json-map-transform';
-import {v4 as uuidv4} from 'uuid';
+} from '@loaders.gl/tiles-3d/i3s';
+import {randomUUID} from 'node:crypto';
 import {openJson, writeFileForSlpk} from '../../lib/utils/file-utils';
 import I3SConverter from '../i3s-converter';
-import {NODE as nodeTemplate} from '../json-templates/node';
+import {createNode} from '../json-templates/node';
 import {I3SConvertedResources} from '../types';
 import {DumpMetadata} from '../../lib/utils/conversion-dump';
 
@@ -97,7 +96,7 @@ export class NodeIndexDocument {
   }
 
   /**
-   * Add neighbors to child nodes of this node
+   * Add neighbors, save leaf documents and children, then release finalized child data.
    */
   public async addNeighbors(): Promise<void> {
     if (this.finalized) {
@@ -130,7 +129,10 @@ export class NodeIndexDocument {
       }
       await childNode.save();
     }
-    // The save after adding neighbors is the last one. Finalize the the node
+    // Internal documents were saved during child traversal. A root mesh leaf has no such traversal.
+    if (!this.children.length) {
+      await this.save();
+    }
     this.finalize();
   }
 
@@ -250,7 +252,7 @@ export class NodeIndexDocument {
    */
   static createRootNodeIndexDocument(boundingVolumes: BoundingVolumes): Node3DIndexDocument {
     const root0data = {
-      version: `{${uuidv4().toUpperCase()}}`,
+      version: `{${randomUUID().toUpperCase()}}`,
       id: 'root',
       level: 0,
       lodSelection: [
@@ -266,7 +268,7 @@ export class NodeIndexDocument {
       ...boundingVolumes,
       children: []
     };
-    return transform(root0data, nodeTemplate());
+    return createNode(root0data);
   }
 
   /**
@@ -305,7 +307,7 @@ export class NodeIndexDocument {
       children: [],
       neighbors: []
     };
-    const node = transform(nodeData, nodeTemplate());
+    const node = createNode(nodeData);
 
     if (nodeInPage.mesh) {
       node.geometryData = [{href: './geometries/0'}];

package/src/v4/i3s-converter/helpers/node-pages.ts

@@ -1,7 +1,6 @@
 import {join} from 'path';
-import transform from 'json-map-transform';
-import {METADATA as metadataTemplate} from '../json-templates/metadata';
-import {NodeInPage} from '@loaders.gl/i3s';
+import {createMetadata} from '../json-templates/metadata';
+import {NodeInPage} from '@loaders.gl/tiles-3d/i3s';
 import {isFileExists, openJson} from '../../lib/utils/file-utils';
 import I3SConverter from '../i3s-converter';
 
@@ -197,7 +196,7 @@ export default class NodePages {
    * Save metadata file (for slpk only)
    */
   async saveMetadata(): Promise<void> {
-    const metadata = transform({nodeCount: this.nodesCounter}, metadataTemplate());
+    const metadata = createMetadata({nodeCount: this.nodesCounter});
     const compress = false;
     await this.converter.writeQueue.enqueue({
       archiveKey: 'metadata.json',