@loaders.gl/tiles 4.4.0-alpha.14 → 4.4.0-alpha.16

package/dist/dist.dev.js

@@ -5421,10 +5421,33 @@ var __exports__ = (() => {
     const toFixedFrameMatrix = fromFixedFrameMatrix.invert();
     tile.cartographicModelMatrix = toFixedFrameMatrix.multiplyRight(modelMatrix);
     tile.cartographicOrigin = cartographicOrigin;
+    const rootNode = _getRootNode(tile);
+    if (rootNode) {
+      tile.cartesianModelMatrix = new Matrix4(modelMatrix).multiplyRight(rootNode.matrix);
+      tile.cartographicModelMatrix.multiplyRight(rootNode.matrix);
+      rootNode.matrix = Matrix4.IDENTITY;
+    }
     if (!tile.coordinateSystem) {
       tile.modelMatrix = tile.cartographicModelMatrix;
     }
   }
+  var TRANSLATION_LIMIT_SQUARED = 1e6 ** 2;
+  function _getRootNode(tile) {
+    const gltf = tile.gltf;
+    if (!gltf) {
+      return null;
+    }
+    const sceneIndex = typeof gltf.scene === "number" ? gltf.scene : 0;
+    const scene = gltf.scenes?.[sceneIndex];
+    const rootNode = scene?.nodes?.[0];
+    if (!rootNode?.matrix)
+      return null;
+    const m = rootNode.matrix;
+    const translationMagnitude = m[12] * m[12] + m[13] * m[13] + m[14] * m[14];
+    if (translationMagnitude <= TRANSLATION_LIMIT_SQUARED)
+      return null;
+    return rootNode;
+  }
 
   // ../../node_modules/@math.gl/culling/dist/constants.js
   var INTERSECTION = {
@@ -6921,6 +6944,13 @@ var __exports__ = (() => {
     _inRequestVolume = false;
     _lodJudge = null;
     // TODO i3s specific, needs to remove
+    /**
+     * Indicates whether the tile has been drawn by the renderer.
+     * Defaults to true for backwards compatibility — renderers that support
+     * transition hold (e.g. deck.gl 9.3+) should set this to false on tile load,
+     * then back to true after first draw to avoid flashes (see deck.gl #7914).
+     */
+    tileDrawn = true;
     /**
      * @constructs
      * Create a Tile3D instance
@@ -7145,6 +7175,7 @@ var __exports__ = (() => {
       }
       this.header.content = null;
       this.contentState = TILE_CONTENT_STATE.UNLOADED;
+      this.tileDrawn = true;
       return true;
     }
     /**
@@ -7638,6 +7669,8 @@ var __exports__ = (() => {
     onTileError: () => {
     },
     onTraversalComplete: (selectedTiles) => selectedTiles,
+    onUpdate: () => {
+    },
     contentLoader: void 0,
     viewDistanceScale: 1,
     maximumScreenSpaceError: 8,
@@ -7731,6 +7764,8 @@ var __exports__ = (() => {
     _traverser;
     _cache = new TilesetCache();
     _requestScheduler;
+    /** Tile IDs held visible during transitions until replacements have drawn */
+    _heldTiles = /* @__PURE__ */ new Set();
     // Promise tracking
     updatePromise = null;
     tilesetInitializationPromise;
@@ -7943,6 +7978,7 @@ var __exports__ = (() => {
      * Update tiles relying on data from all traversers
      */
     _updateTiles() {
+      const previousSelectedTiles = this.selectedTiles;
       this.selectedTiles = [];
       this._requestedTiles = [];
       this._emptyTiles = [];
@@ -7953,12 +7989,42 @@ var __exports__ = (() => {
         this._emptyTiles = this._emptyTiles.concat(frameStateDataValue._emptyTiles);
       }
       this.selectedTiles = this.options.onTraversalComplete(this.selectedTiles);
+      const selectedIds = new Set(this.selectedTiles.map((t) => t.id));
+      const hasUndrawnTiles = this.selectedTiles.some((t) => !t.tileDrawn);
+      let heldBackCount = 0;
+      if (hasUndrawnTiles) {
+        for (const tileId of selectedIds) {
+          this._heldTiles.add(tileId);
+        }
+        for (const tileId of this._heldTiles) {
+          if (selectedIds.has(tileId))
+            continue;
+          const tile = this._tiles[tileId];
+          if (tile && tile.contentAvailable) {
+            tile._selectedFrame = this._frameNumber;
+            this.selectedTiles.push(tile);
+            heldBackCount++;
+          } else {
+            this._heldTiles.delete(tileId);
+          }
+        }
+      } else {
+        this._heldTiles = selectedIds;
+      }
+      if (heldBackCount > 0) {
+        setTimeout(() => {
+          this.selectTiles();
+        }, 0);
+      }
       for (const tile of this.selectedTiles) {
         this._tiles[tile.id] = tile;
       }
       this._loadTiles();
       this._unloadTiles();
       this._updateStats();
+      if (this._tilesChanged(previousSelectedTiles, this.selectedTiles)) {
+        this.options.onUpdate();
+      }
     }
     _tilesChanged(oldSelectedTiles, selectedTiles) {
       if (oldSelectedTiles.length !== selectedTiles.length) {