@loaders.gl/tile-converter 4.0.0-alpha.4 → 4.0.0-alpha.6

package/dist/i3s-converter/helpers/gltf-attributes.d.ts

@@ -0,0 +1,9 @@
+import type { B3DMContent } from '@loaders.gl/3d-tiles';
+import type { B3DMAttributesData } from '../../i3s-attributes-worker';
+/**
+ * Prepare attributes for conversion to avoid binary data breaking in worker thread.
+ * @param tileContent
+ * @returns
+ */
+export declare function prepareDataForAttributesConversion(tileContent: B3DMContent): B3DMAttributesData;
+//# sourceMappingURL=gltf-attributes.d.ts.map

package/dist/i3s-converter/helpers/gltf-attributes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gltf-attributes.d.ts","sourceRoot":"","sources":["../../../src/i3s-converter/helpers/gltf-attributes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,sBAAsB,CAAC;AAEtD,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,6BAA6B,CAAC;AAsBpE;;;;GAIG;AACH,wBAAgB,kCAAkC,CAAC,WAAW,EAAE,WAAW,GAAG,kBAAkB,CAyC/F"}

package/dist/i3s-converter/helpers/gltf-attributes.js

@@ -0,0 +1,88 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.prepareDataForAttributesConversion = void 0;
+/**
+ * Keep only values for B3DM attributes to pass data to worker thread.
+ * @param attributes
+ */
+function getB3DMAttributesWithoutBufferView(attributes) {
+    const attributesWithoutBufferView = {};
+    for (const attributeName in attributes) {
+        attributesWithoutBufferView[attributeName] = {
+            value: attributes[attributeName].value
+        };
+    }
+    return attributesWithoutBufferView;
+}
+/**
+ * Prepare attributes for conversion to avoid binary data breaking in worker thread.
+ * @param tileContent
+ * @returns
+ */
+function prepareDataForAttributesConversion(tileContent) {
+    let nodes = tileContent.gltf?.scene?.nodes ||
+        tileContent.gltf?.scenes?.[0]?.nodes ||
+        tileContent.gltf?.nodes ||
+        [];
+    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 {
+                data: null,
+                compressed: true
+            };
+        }
+        else {
+            const data = imageObject?.image?.data;
+            const dataCopy = new Uint8Array(data.length);
+            dataCopy.set(data);
+            return {
+                data: dataCopy,
+                compressed: false,
+                height: imageObject.image.height,
+                width: imageObject.image.width,
+                components: imageObject.image.components,
+                mimeType: imageObject.mimeType
+            };
+        }
+    }) || [];
+    prepareNodes(nodes);
+    const cartographicOrigin = tileContent.cartographicOrigin;
+    const cartesianModelMatrix = tileContent.cartesianModelMatrix;
+    return {
+        nodes,
+        images,
+        cartographicOrigin,
+        cartesianModelMatrix
+    };
+}
+exports.prepareDataForAttributesConversion = prepareDataForAttributesConversion;
+/**
+ * Traverse all nodes to replace all sensible data with copy to avoid data corruption in worker.
+ * @param nodes
+ */
+function prepareNodes(nodes) {
+    for (let index = 0; index < nodes.length; index++) {
+        const node = nodes[index];
+        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);
+        }
+    }
+}

package/dist/i3s-converter/helpers/node-debug.d.ts

@@ -0,0 +1,8 @@
+import type { Node3DIndexDocument } from '@loaders.gl/i3s';
+/**
+ * Do validation of bounding volumes for particular node.
+ * Generates special warnings if there are some issues.
+ * @param node
+ */
+export declare function validateNodeBoundingVolumes(node: Node3DIndexDocument): string[];
+//# sourceMappingURL=node-debug.d.ts.map

package/dist/i3s-converter/helpers/node-debug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-debug.d.ts","sourceRoot":"","sources":["../../../src/i3s-converter/helpers/node-debug.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAM,mBAAmB,EAAM,MAAM,iBAAiB,CAAC;AAiBnE;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,mBAAmB,GAAG,MAAM,EAAE,CAW/E"}

package/dist/i3s-converter/helpers/node-debug.js

@@ -1,88 +1,120 @@
-import { OrientedBoundingBox, BoundingSphere } from '@math.gl/culling';
-import { CubeGeometry } from '@luma.gl/engine';
-import { Vector3 } from '@math.gl/core';
-import { Ellipsoid } from '@math.gl/geospatial';
-export function validateNodeBoundingVolumes(node) {
-  if (!node.parentNode.obb || !node.parentNode.mbs) {
-    return null;
-  }
-
-  const tileWarnings = [];
-  validateObb(tileWarnings, node);
-  validateMbs(tileWarnings, node);
-  return tileWarnings;
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateNodeBoundingVolumes = void 0;
+const culling_1 = require("@math.gl/culling");
+const core_1 = require("@math.gl/core");
+const geospatial_1 = require("@math.gl/geospatial");
+// prettier-ignore
+const CUBE_POSITIONS = new Float32Array([
+    -1, -1, 1, 1, -1, 1, 1, 1, 1, -1, 1, 1,
+    -1, -1, -1, -1, 1, -1, 1, 1, -1, 1, -1, -1,
+    -1, 1, -1, -1, 1, 1, 1, 1, 1, 1, 1, -1,
+    -1, -1, -1, 1, -1, -1, 1, -1, 1, -1, -1, 1,
+    1, -1, -1, 1, 1, -1, 1, 1, 1, 1, -1, 1,
+    -1, -1, -1, -1, -1, 1, -1, 1, 1, -1, 1, -1
+]);
+// TODO Unite Tile validation logic in i3s-17-and-debug with this code.
+/**
+ * Do validation of bounding volumes for particular node.
+ * Generates special warnings if there are some issues.
+ * @param node
+ */
+function validateNodeBoundingVolumes(node) {
+    if (!node?.parentNode?.obb || !node?.parentNode?.mbs) {
+        return [];
+    }
+    const tileWarnings = [];
+    validateObb(tileWarnings, node);
+    validateMbs(tileWarnings, node);
+    return tileWarnings;
 }
-
+exports.validateNodeBoundingVolumes = validateNodeBoundingVolumes;
+/**
+ * Check if child Obb fit into parent Obb.
+ * @param tileWarnings
+ * @param node
+ */
 function validateObb(tileWarnings, node) {
-  const parentObb = createBoundingBoxFromTileObb(node.parentNode.obb);
-  const tileVertices = getTileObbVertices(node);
-  const isTileObbInsideParentObb = isAllVerticesInsideBoundingVolume(parentObb, tileVertices);
-
-  if (isTileObbInsideParentObb) {
-    return;
-  }
-
-  const title = "OBB of Tile (".concat(node.id, ") doesn't fit into Parent (").concat(node.parentNode.id, ") tile OBB");
-  tileWarnings.push(title);
+    // @ts-expect-error
+    const parentObb = createBoundingBoxFromTileObb(node.parentNode.obb);
+    const tileVertices = getTileObbVertices(node);
+    const isTileObbInsideParentObb = isAllVerticesInsideBoundingVolume(parentObb, tileVertices);
+    if (isTileObbInsideParentObb) {
+        return;
+    }
+    const title = `OBB of Tile (${node.id}) doesn't fit into Parent (${node.parentNode?.id}) tile OBB`;
+    tileWarnings.push(title);
 }
-
+/**
+ * Check if child Mbs fit into parent Mbs.
+ * @param tileWarnings
+ * @param node
+ */
 function validateMbs(tileWarnings, node) {
-  const tileMbs = createBoundingSphereFromTileMbs(node.mbs);
-  const parentMbs = createBoundingSphereFromTileMbs(node.parentNode.mbs);
-  const distanceBetweenCenters = tileMbs.center.distanceTo(parentMbs.center);
-
-  if (distanceBetweenCenters + tileMbs.radius > parentMbs.radius) {
-    const title = "MBS of Tile (".concat(node.id, ") doesn't fit into Parent (").concat(node.parentNode.id, ") tile MBS");
-    tileWarnings.push(title);
-  }
+    // @ts-expect-error
+    const tileMbs = createBoundingSphereFromTileMbs(node.mbs);
+    // @ts-expect-error
+    const parentMbs = createBoundingSphereFromTileMbs(node.parentNode.mbs);
+    const distanceBetweenCenters = tileMbs.center.distanceTo(parentMbs.center);
+    if (distanceBetweenCenters + tileMbs.radius > parentMbs.radius) {
+        const title = `MBS of Tile (${node.id}) doesn't fit into Parent (${node.parentNode?.id}) tile MBS`;
+        tileWarnings.push(title);
+    }
 }
-
+/**
+ * Generates bounding sphere from mbs
+ * @param mbs
+ */
 function createBoundingSphereFromTileMbs(mbs) {
-  return new BoundingSphere([mbs[0], mbs[1], mbs[2]], mbs[3]);
+    return new culling_1.BoundingSphere([mbs[0], mbs[1], mbs[2]], mbs[3]);
 }
-
+/**
+ * Generates oriented bounding box from tile obb
+ * @param obb
+ * @returns
+ */
 function createBoundingBoxFromTileObb(obb) {
-  const {
-    center,
-    halfSize,
-    quaternion
-  } = obb;
-  return new OrientedBoundingBox().fromCenterHalfSizeQuaternion(center, halfSize, quaternion);
+    const { center, halfSize, quaternion } = obb;
+    return new culling_1.OrientedBoundingBox().fromCenterHalfSizeQuaternion(center, halfSize, quaternion);
 }
-
+/**
+ * Get vertices fromnode obb
+ * TODO check if Obb generates properly
+ * @param node
+ */
 function getTileObbVertices(node) {
-  const geometry = new CubeGeometry();
-  const halfSize = node.obb.halfSize;
-  const {
-    attributes
-  } = geometry;
-  const positions = new Float32Array(attributes.POSITION.value);
-  const obbCenterCartesian = Ellipsoid.WGS84.cartographicToCartesian(node.obb.center);
-  let vertices = [];
-
-  for (let i = 0; i < positions.length; i += 3) {
-    const positionsVector = new Vector3(positions[i] *= halfSize[0], positions[i + 1] *= halfSize[1], positions[i + 2] *= halfSize[2]);
-    const rotatedPositions = positionsVector.transformByQuaternion(node.obb.quaternion).add(obbCenterCartesian);
-    vertices = vertices.concat(rotatedPositions);
-  }
-
-  return vertices;
+    // @ts-expect-error
+    const halfSize = node.obb.halfSize;
+    const positions = CUBE_POSITIONS;
+    // @ts-expect-error
+    const obbCenterCartesian = geospatial_1.Ellipsoid.WGS84.cartographicToCartesian(node.obb.center);
+    let vertices = [];
+    for (let i = 0; i < positions.length; i += 3) {
+        const positionsVector = new core_1.Vector3((positions[i] *= halfSize[0]), (positions[i + 1] *= halfSize[1]), (positions[i + 2] *= halfSize[2]));
+        const rotatedPositions = positionsVector
+            // @ts-expect-error
+            .transformByQuaternion(node.obb.quaternion)
+            .add(obbCenterCartesian);
+        // @ts-expect-error
+        vertices = vertices.concat(rotatedPositions);
+    }
+    return vertices;
 }
-
+/**
+ * Check if all vertices inside bounding volume
+ * @param boundingVolume
+ * @param positions
+ */
 function isAllVerticesInsideBoundingVolume(boundingVolume, positions) {
-  let isVerticesInsideObb = true;
-
-  for (let index = 0; index < positions.length / 3; index += 3) {
-    const point = [positions[index], positions[index + 1], positions[index + 2]];
-    const cartographicPoint = Ellipsoid.WGS84.cartesianToCartographic(point);
-    const distance = boundingVolume.distanceTo(cartographicPoint);
-
-    if (distance > 0) {
-      isVerticesInsideObb = false;
-      break;
+    let isVerticesInsideObb = true;
+    for (let index = 0; index < positions.length / 3; index += 3) {
+        const point = [positions[index], positions[index + 1], positions[index + 2]];
+        const cartographicPoint = geospatial_1.Ellipsoid.WGS84.cartesianToCartographic(point);
+        const distance = boundingVolume.distanceTo(cartographicPoint);
+        if (distance > 0) {
+            isVerticesInsideObb = false;
+            break;
+        }
     }
-  }
-
-  return isVerticesInsideObb;
+    return isVerticesInsideObb;
 }
-//# sourceMappingURL=node-debug.js.map

package/dist/i3s-converter/helpers/node-index-document.d.ts

@@ -0,0 +1,95 @@
+import { BoundingVolumes, LodSelection, Node3DIndexDocument, NodeInPage } from '@loaders.gl/i3s';
+import I3SConverter from '../i3s-converter';
+import { I3SConvertedResources } from '../types';
+/**
+ * Wrapper for https://github.com/Esri/i3s-spec/blob/master/docs/1.7/3DNodeIndexDocument.cmn.md data
+ * The class allows working with 3DNodeIndexDocument in 2 modes:
+ * in memory: the data is stored in `data` field
+ * on disk: the data is written on disk in a file. The file can be rewritten when new childrend or neighbors have to be added
+ */
+export declare class NodeIndexDocument {
+    /** Node id */
+    id: string;
+    /** Id in node pages */
+    inPageId: number;
+    /** 3DNodeIndexDocument data */
+    data: Node3DIndexDocument | null;
+    /** children */
+    children: NodeIndexDocument[];
+    /** converter instance */
+    private converter;
+    /**
+     * Constructor
+     * @param id - id of the node in node pages
+     * @param converter - converter instance
+     */
+    constructor(id: number, converter: I3SConverter);
+    /**
+     * Add Node3DIndexDocument data to the node
+     * @param data Node3DIndexDocument data
+     * @returns this NodeIndexDocument instance (to recurring with constructor)
+     */
+    addData(data: Node3DIndexDocument): Promise<NodeIndexDocument>;
+    /**
+     * Add child node references
+     * @param childNodes - child NodeIndexDocument instances
+     */
+    addChildren(childNodes: NodeIndexDocument[]): Promise<void>;
+    /**
+     * Add neighbors to child nodes of this node
+     */
+    addNeighbors(): Promise<void>;
+    /** Save 3DNodeIndexDocument in file on disk */
+    save(): Promise<void>;
+    /**
+     * Write 3DNodeIndexDocument https://github.com/Esri/i3s-spec/blob/master/docs/1.7/3DNodeIndexDocument.cmn.md
+     * @param node - Node3DIndexDocument object
+     */
+    private write;
+    /**
+     * Load 3DNodeIndexDocument data from file on disk
+     * @returns 3DNodeIndexDocument object
+     */
+    private load;
+    /**
+     * Unload the Node data
+     */
+    private flush;
+    /**
+     * Create root node of the tree
+     * @param boundingVolumes - MBS and OOB bounding volumes data
+     * @param converter - I3SConverter instance
+     * @returns instance of NodeIndexDocument
+     */
+    static createRootNode(boundingVolumes: BoundingVolumes, converter: I3SConverter): Promise<NodeIndexDocument>;
+    /**
+     * Create NodeIndexDocument instance
+     * @param parentNode - parent NodeIndexDocument
+     * @param boundingVolumes - MBS and OOB bounding volumes data
+     * @param lodSelection - LOD metrics data
+     * @param nodeInPage - node data in node pages
+     * @param resources - resources extracted from gltf/b3dm file
+     * @param converter - I3SConverter instance
+     * @returns NodeIndexDocument instance
+     */
+    static createNode(parentNode: NodeIndexDocument, boundingVolumes: BoundingVolumes, lodSelection: LodSelection[], nodeInPage: NodeInPage, resources: I3SConvertedResources, converter: I3SConverter): Promise<NodeIndexDocument>;
+    /**
+     * Form 3DNodeIndexDocument data for the root node
+     * @param boundingVolumes - mbs and obb data about node's bounding volume
+     * @return 3DNodeIndexDocument data https://github.com/Esri/i3s-spec/blob/master/docs/1.7/3DNodeIndexDocument.cmn.md
+     */
+    static createRootNodeIndexDocument(boundingVolumes: BoundingVolumes): Node3DIndexDocument;
+    /**
+     * Create a new Node3DIndexDocument
+     * @param parentNode - 3DNodeIndexDocument https://github.com/Esri/i3s-spec/blob/master/docs/1.7/3DNodeIndexDocument.cmn.md object of the parent node
+     * @param boundingVolumes - Bounding volumes
+     * @param lodSelection - Level of Details (LOD) metrics
+     * @param nodeInPage - corresponding node object in a node page
+     * @param resources - the node resources data
+     * @param resources.texture - texture image
+     * @param resources.attributes - feature attributes
+     * @return 3DNodeIndexDocument https://github.com/Esri/i3s-spec/blob/master/docs/1.7/3DNodeIndexDocument.cmn.md object
+     */
+    static createNodeIndexDocument(parentNode: NodeIndexDocument, boundingVolumes: BoundingVolumes, lodSelection: LodSelection[], nodeInPage: NodeInPage, resources: I3SConvertedResources): Promise<Node3DIndexDocument>;
+}
+//# sourceMappingURL=node-index-document.d.ts.map

package/dist/i3s-converter/helpers/node-index-document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-index-document.d.ts","sourceRoot":"","sources":["../../../src/i3s-converter/helpers/node-index-document.ts"],"names":[],"mappings":"AACA,OAAO,EACL,eAAe,EACf,YAAY,EACZ,mBAAmB,EACnB,UAAU,EAEX,MAAM,iBAAiB,CAAC;AAIzB,OAAO,YAAY,MAAM,kBAAkB,CAAC;AAE5C,OAAO,EAAC,qBAAqB,EAAC,MAAM,UAAU,CAAC;AAE/C;;;;;GAKG;AACH,qBAAa,iBAAiB;IAC5B,cAAc;IACP,EAAE,EAAE,MAAM,CAAC;IAClB,uBAAuB;IAChB,QAAQ,EAAE,MAAM,CAAC;IACxB,+BAA+B;IACxB,IAAI,EAAE,mBAAmB,GAAG,IAAI,CAAQ;IAC/C,eAAe;IACR,QAAQ,EAAE,iBAAiB,EAAE,CAAM;IAC1C,yBAAyB;IACzB,OAAO,CAAC,SAAS,CAAe;IAEhC;;;;OAIG;gBACS,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,YAAY;IAM/C;;;;OAIG;IACU,OAAO,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAS3E;;;OAGG;IACU,WAAW,CAAC,UAAU,EAAE,iBAAiB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA0BxE;;OAEG;IACU,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAgC1C,+CAA+C;IAClC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAMlC;;;OAGG;YACW,KAAK;IAyBnB;;;OAGG;YACW,IAAI;IAalB;;OAEG;IACH,OAAO,CAAC,KAAK;IAIb;;;;;OAKG;WACU,cAAc,CACzB,eAAe,EAAE,eAAe,EAChC,SAAS,EAAE,YAAY,GACtB,OAAO,CAAC,iBAAiB,CAAC;IAM7B;;;;;;;;;OASG;WACU,UAAU,CACrB,UAAU,EAAE,iBAAiB,EAC7B,eAAe,EAAE,eAAe,EAChC,YAAY,EAAE,YAAY,EAAE,EAC5B,UAAU,EAAE,UAAU,EACtB,SAAS,EAAE,qBAAqB,EAChC,SAAS,EAAE,YAAY,GACtB,OAAO,CAAC,iBAAiB,CAAC;IAY7B;;;;OAIG;IACH,MAAM,CAAC,2BAA2B,CAAC,eAAe,EAAE,eAAe,GAAG,mBAAmB;IAqBzF;;;;;;;;;;OAUG;WACU,uBAAuB,CAClC,UAAU,EAAE,iBAAiB,EAC7B,eAAe,EAAE,eAAe,EAChC,YAAY,EAAE,YAAY,EAAE,EAC5B,UAAU,EAAE,UAAU,EACtB,SAAS,EAAE,qBAAqB,GAC/B,OAAO,CAAC,mBAAmB,CAAC;CA4ChC"}

package/dist/i3s-converter/helpers/node-index-document.js

@@ -0,0 +1,250 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NodeIndexDocument = void 0;
+const path_1 = require("path");
+const json_map_transform_1 = __importDefault(require("json-map-transform"));
+const uuid_1 = require("uuid");
+const file_utils_1 = require("../../lib/utils/file-utils");
+const node_1 = require("../json-templates/node");
+/**
+ * Wrapper for https://github.com/Esri/i3s-spec/blob/master/docs/1.7/3DNodeIndexDocument.cmn.md data
+ * The class allows working with 3DNodeIndexDocument in 2 modes:
+ * in memory: the data is stored in `data` field
+ * on disk: the data is written on disk in a file. The file can be rewritten when new childrend or neighbors have to be added
+ */
+class NodeIndexDocument {
+    /**
+     * Constructor
+     * @param id - id of the node in node pages
+     * @param converter - converter instance
+     */
+    constructor(id, converter) {
+        /** 3DNodeIndexDocument data */
+        this.data = null;
+        /** children */
+        this.children = [];
+        this.inPageId = id;
+        this.id = id === 0 ? 'root' : id.toString();
+        this.converter = converter;
+    }
+    /**
+     * Add Node3DIndexDocument data to the node
+     * @param data Node3DIndexDocument data
+     * @returns this NodeIndexDocument instance (to recurring with constructor)
+     */
+    async addData(data) {
+        if (this.converter.options.instantNodeWriting) {
+            await this.write(data);
+        }
+        else {
+            this.data = data;
+        }
+        return this;
+    }
+    /**
+     * Add child node references
+     * @param childNodes - child NodeIndexDocument instances
+     */
+    async addChildren(childNodes) {
+        const newChildren = [];
+        for (const node of childNodes) {
+            const nodeData = await node.load();
+            newChildren.push({
+                id: node.id,
+                href: `../${node.id}`,
+                obb: nodeData.obb,
+                mbs: nodeData.mbs
+            });
+        }
+        this.children = this.children.concat(childNodes);
+        let data = this.data;
+        if (this.converter.options.instantNodeWriting) {
+            data = (await this.load());
+        }
+        if (data) {
+            data.children = data.children ?? [];
+            data.children = data.children.concat(newChildren);
+        }
+        if (this.converter.options.instantNodeWriting && data) {
+            await this.write(data);
+        }
+    }
+    /**
+     * Add neighbors to child nodes of this node
+     */
+    async addNeighbors() {
+        const nodeData = await this.load();
+        for (const childNode of this.children) {
+            const childNodeData = await childNode.load();
+            childNodeData.neighbors = childNodeData.neighbors ?? [];
+            // Don't do large amount of "neightbors" to avoid big memory consumption
+            if (Number(nodeData?.children?.length) < 1000) {
+                for (const neighbor of nodeData.children || []) {
+                    if (childNode.id === neighbor.id) {
+                        continue; // eslint-disable-line
+                    }
+                    childNodeData.neighbors.push({ ...neighbor });
+                }
+            }
+            else {
+                // eslint-disable-next-line no-console, no-undef
+                console.warn(`Node ${childNode.id}: neighbors attribute is omited because of large number of neigbors`);
+                delete childNodeData.neighbors;
+            }
+            if (this.converter.options.instantNodeWriting && childNodeData) {
+                await childNode.write(childNodeData);
+            }
+            await childNode.save();
+            // The save after adding neighbors is the last one. Flush the the node
+            childNode.flush();
+        }
+    }
+    /** Save 3DNodeIndexDocument in file on disk */
+    async save() {
+        if (this.data) {
+            await this.write(this.data);
+        }
+    }
+    /**
+     * Write 3DNodeIndexDocument https://github.com/Esri/i3s-spec/blob/master/docs/1.7/3DNodeIndexDocument.cmn.md
+     * @param node - Node3DIndexDocument object
+     */
+    async write(node) {
+        const path = (0, path_1.join)(this.converter.layers0Path, 'nodes', this.id);
+        if (this.converter.options.slpk) {
+            await this.converter.writeQueue.enqueue({
+                archiveKey: `nodes/${this.id}/3dNodeIndexDocument.json.gz`,
+                writePromise: () => (0, file_utils_1.writeFileForSlpk)(path, JSON.stringify(node), '3dNodeIndexDocument.json', true, this.converter.compressList)
+            }, true);
+        }
+        else {
+            await this.converter.writeQueue.enqueue({ writePromise: () => (0, file_utils_1.writeFile)(path, JSON.stringify(node)) }, true);
+        }
+    }
+    /**
+     * Load 3DNodeIndexDocument data from file on disk
+     * @returns 3DNodeIndexDocument object
+     */
+    async load() {
+        if (this.data) {
+            return this.data;
+        }
+        const path = this.id;
+        const parentNodePath = (0, path_1.join)(this.converter.layers0Path, 'nodes', path);
+        let parentNodeFileName = 'index.json';
+        if (this.converter.options.slpk) {
+            parentNodeFileName = '3dNodeIndexDocument.json';
+        }
+        return (await (0, file_utils_1.openJson)(parentNodePath, parentNodeFileName));
+    }
+    /**
+     * Unload the Node data
+     */
+    flush() {
+        this.data = null;
+    }
+    /**
+     * Create root node of the tree
+     * @param boundingVolumes - MBS and OOB bounding volumes data
+     * @param converter - I3SConverter instance
+     * @returns instance of NodeIndexDocument
+     */
+    static async createRootNode(boundingVolumes, converter) {
+        const rootData = NodeIndexDocument.createRootNodeIndexDocument(boundingVolumes);
+        const rootNode = await new NodeIndexDocument(0, converter).addData(rootData);
+        return rootNode;
+    }
+    /**
+     * Create NodeIndexDocument instance
+     * @param parentNode - parent NodeIndexDocument
+     * @param boundingVolumes - MBS and OOB bounding volumes data
+     * @param lodSelection - LOD metrics data
+     * @param nodeInPage - node data in node pages
+     * @param resources - resources extracted from gltf/b3dm file
+     * @param converter - I3SConverter instance
+     * @returns NodeIndexDocument instance
+     */
+    static async createNode(parentNode, boundingVolumes, lodSelection, nodeInPage, resources, converter) {
+        const data = await NodeIndexDocument.createNodeIndexDocument(parentNode, boundingVolumes, lodSelection, nodeInPage, resources);
+        const node = await new NodeIndexDocument(nodeInPage.index, converter).addData(data);
+        return node;
+    }
+    /**
+     * Form 3DNodeIndexDocument data for the root node
+     * @param boundingVolumes - mbs and obb data about node's bounding volume
+     * @return 3DNodeIndexDocument data https://github.com/Esri/i3s-spec/blob/master/docs/1.7/3DNodeIndexDocument.cmn.md
+     */
+    static createRootNodeIndexDocument(boundingVolumes) {
+        const root0data = {
+            version: `{${(0, uuid_1.v4)().toUpperCase()}}`,
+            id: 'root',
+            level: 0,
+            lodSelection: [
+                {
+                    metricType: 'maxScreenThresholdSQ',
+                    maxError: 0
+                },
+                {
+                    metricType: 'maxScreenThreshold',
+                    maxError: 0
+                }
+            ],
+            ...boundingVolumes,
+            children: []
+        };
+        return (0, json_map_transform_1.default)(root0data, (0, node_1.NODE)());
+    }
+    /**
+     * Create a new Node3DIndexDocument
+     * @param parentNode - 3DNodeIndexDocument https://github.com/Esri/i3s-spec/blob/master/docs/1.7/3DNodeIndexDocument.cmn.md object of the parent node
+     * @param boundingVolumes - Bounding volumes
+     * @param lodSelection - Level of Details (LOD) metrics
+     * @param nodeInPage - corresponding node object in a node page
+     * @param resources - the node resources data
+     * @param resources.texture - texture image
+     * @param resources.attributes - feature attributes
+     * @return 3DNodeIndexDocument https://github.com/Esri/i3s-spec/blob/master/docs/1.7/3DNodeIndexDocument.cmn.md object
+     */
+    static async createNodeIndexDocument(parentNode, boundingVolumes, lodSelection, nodeInPage, resources) {
+        const { texture, attributes } = resources;
+        const nodeId = nodeInPage.index;
+        const parentNodeData = await parentNode.load();
+        const nodeData = {
+            version: parentNodeData.version,
+            id: nodeId.toString(),
+            level: parentNodeData.level + 1,
+            ...boundingVolumes,
+            lodSelection,
+            parentNode: {
+                id: parentNode.id,
+                href: `../${parentNode.id}`,
+                mbs: parentNodeData.mbs,
+                obb: parentNodeData.obb
+            },
+            children: [],
+            neighbors: []
+        };
+        const node = (0, json_map_transform_1.default)(nodeData, (0, node_1.NODE)());
+        if (nodeInPage.mesh) {
+            node.geometryData = [{ href: './geometries/0' }];
+            node.sharedResource = { href: './shared' };
+            if (texture) {
+                node.textureData = [{ href: './textures/0' }, { href: './textures/1' }];
+            }
+            if (attributes &&
+                attributes.length &&
+                parentNode.converter.layers0?.attributeStorageInfo?.length) {
+                node.attributeData = [];
+                for (let index = 0; index < attributes.length; index++) {
+                    const folderName = parentNode.converter.layers0.attributeStorageInfo[index].key;
+                    node.attributeData.push({ href: `./attributes/${folderName}/0` });
+                }
+            }
+        }
+        return node;
+    }
+}
+exports.NodeIndexDocument = NodeIndexDocument;