@loaders.gl/tiles 4.4.0-alpha.13 → 4.4.0-alpha.15

package/dist/index.cjs

@@ -1169,6 +1169,13 @@ var Tile3D = class {
   _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
@@ -1388,6 +1395,7 @@ var Tile3D = class {
     }
     this.header.content = null;
     this.contentState = TILE_CONTENT_STATE.UNLOADED;
+    this.tileDrawn = true;
     return true;
   }
   /**
@@ -1848,6 +1856,8 @@ var DEFAULT_PROPS2 = {
   onTileError: () => {
   },
   onTraversalComplete: (selectedTiles) => selectedTiles,
+  onUpdate: () => {
+  },
   contentLoader: void 0,
   viewDistanceScale: 1,
   maximumScreenSpaceError: 8,
@@ -1941,6 +1951,8 @@ var Tileset3D = class {
   _traverser;
   _cache = new TilesetCache();
   _requestScheduler;
+  /** Tile IDs held visible during transitions until replacements have drawn */
+  _heldTiles = /* @__PURE__ */ new Set();
   // Promise tracking
   updatePromise = null;
   tilesetInitializationPromise;
@@ -2146,6 +2158,7 @@ var Tileset3D = class {
    * Update tiles relying on data from all traversers
    */
   _updateTiles() {
+    const previousSelectedTiles = this.selectedTiles;
     this.selectedTiles = [];
     this._requestedTiles = [];
     this._emptyTiles = [];
@@ -2156,12 +2169,42 @@ var Tileset3D = class {
       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) {