@loaders.gl/tiles 5.0.0-alpha.7 → 5.0.0-alpha.9

package/README.md

@@ -38,6 +38,32 @@ The shared `Tileset3DSource` contract owns:
 
 `Tileset3D` remains responsible for traversal, culling, request scheduling, selection, and cache management.
 
+### Camera-independent content traversal
+
+Conversion and inspection jobs can visit the complete dataset without creating a viewport:
+
+```ts
+import {traverseTilesetContents} from '@loaders.gl/tiles';
+
+for await (const {tile, contents} of traverseTilesetContents(tileset, {signal})) {
+  // `contents` preserves the tile's declared content order.
+  processTile(tile, contents);
+}
+```
+
+The traversal follows declared placements in depth-first order, resolves lazy 3D Tiles subtrees and
+I3S child headers through their source, and visits nested tilesets before descending into them.
+Repeated resource URLs remain separate visits when they appear at different placements, since each
+placement can have its own transform. By default, the caller owns loaded-content lifetime and
+should unload or destroy the tileset when processing completes.
+
+Pass `{signal, unloadContent: true}` with a runtime dedicated to traversal to unload newly read
+content when the iterator advances or closes, including on cancellation and errors. Preloaded
+content is retained. Finish processing each placement before requesting the next one; do not retain
+payloads or concurrently update the runtime. Tile placements and children remain available, and the
+caller still owns tileset destruction and source/archive lifetimes. This limits content retention,
+not decoder allocations, source caches, or the full dataset's metadata.
+
 For broader documentation please visit the [website](https://loaders.gl).
 
 ## Tileset2D