belowjs 1.6.0 → 1.7.0

package/CHANGELOG.md

@@ -5,6 +5,21 @@ All notable changes to BelowJS will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.7.0] - 2026-02-15
+
+### Added
+- BelowJS support for Cesium 3D Tiles loading via the NASA-AMMOS 3DTilesRendererJS library, including tiled models exported from Agisoft Metashape.
+- `tileset` example configured with the Denton Holme and Macedon 2023 dataset.
+- `examples/tileset/convert-3tz.sh` conversion script for Agisoft Metashape `.3tz` exports, producing a web-hostable tileset folder with root `tileset.json`.
+
+### Changed
+- Examples docs describe six production-ready viewers.
+
+### Fixed
+- Removed ARCore lint warnings from unused catch variables.
+
+---
+
 ## [1.6.0] - 2026-02-15
 
 ### Added
@@ -35,6 +50,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - `stereo()` console command for enabling/disabling stereo mode and adjusting eye separation
 - Z key to toggle between dive mode and studio mode
 - H key to take screenshot
+- Experimental 3D Tiles streaming loader for massive datasets
+- New `tileset` example (`npm run dev:tileset`) with a NASA-AMMOS sample dataset default and URL override support
 
 ### Changed
 - Material conversion upgraded from MeshLambertMaterial to MeshStandardMaterial with shipwreck-appropriate PBR defaults (roughness 0.8, metalness 0.3)
@@ -46,6 +63,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - VR button visibility management with fly mode controls
 - Support for deprecated KHR_materials_pbrSpecularGlossiness GLTF extension by converting to standard PBR materials
 - Support for logarithmicDepthBuffer renderer option (suppresses ConfigValidator warning)
+- 3D Tiles auto-centering and auto-framing when streaming tiles are not fully available on first bounds pass
 
 ---
 

package/README.md

@@ -6,7 +6,7 @@
 
 📖 **[Full Documentation & Examples](https://patrick-morrison.github.io/belowjs/)**
 
-> **Current Version:** `1.6.0` - Comfort-mode APIs, per-model measurability controls, and stronger recovery after context interruptions.
+> **Current Version:** `1.7.0` - Tiled-model workflow documentation and tileset example refinements.
 
 **Dive Shipwrecks in Virtual Reality**
 
@@ -60,11 +60,11 @@ This gives you a complete VR-ready 3D viewer with dive lighting, measurement too
     {
         "imports": {
             "three": "https://cdn.jsdelivr.net/npm/three@0.179.1/+esm",
-            "belowjs": "https://cdn.jsdelivr.net/npm/belowjs@1.6.0/dist/belowjs.js"
+            "belowjs": "https://cdn.jsdelivr.net/npm/belowjs@1.7.0/dist/belowjs.js"
         }
     }
     </script>
-  <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/belowjs@1.6.0/dist/belowjs.css">
+  <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/belowjs@1.7.0/dist/belowjs.css">
     <style>
         body, html { margin: 0; padding: 0; overflow: hidden; }
     </style>
@@ -99,7 +99,7 @@ This gives you a complete VR-ready 3D viewer with dive lighting, measurement too
 
 ## Examples
 
-Three different examples are included:
+Examples are included:
 
 ```bash
 git clone https://github.com/patrick-morrison/belowjs
@@ -110,12 +110,14 @@ npm install && npm run build
 - `npm run dev` — Full-featured viewer with model selection and all systems enabled
 - `npm run dev:dragdrop` — File loader with drag-and-drop GLB support and custom UI elements
 - `npm run dev:embed` — Lightweight viewer designed for iframe embedding
+- `npm run dev:tileset` — 3D Tiles streaming example for large datasets
 
 ### Live Examples
 
 - [Basic Viewer](https://patrick-morrison.github.io/belowjs/examples/basic/) — Full-featured multi-model viewer
 - [Drag & Drop](https://patrick-morrison.github.io/belowjs/examples/dragdrop/) — File loader with custom UI; recommended path for Meta Quest Link desktop streaming
 - [Embed Viewer](https://patrick-morrison.github.io/belowjs/examples/embed/) — Lightweight iframe-ready viewer
+- [Tileset Viewer](https://patrick-morrison.github.io/belowjs/examples/tileset/) — 3D Tiles streaming example
 
 ## Installation
 
@@ -209,6 +211,25 @@ new ModelViewer(document.body, {
 
 Enable `enableScreenshot` to add a button that captures the scene without UI overlays.
 
+### 3D Tiles (Experimental)
+BelowJS can stream 3D Tiles datasets for large environments. Tilesets still require a `tileset.json` root plus streamed tile content hosted alongside it. Point a model at the `tileset.json` and set `type: 'tileset'`:
+
+```javascript
+new ModelViewer('#container', {
+  models: {
+    'site': {
+      url: 'https://example.com/tiles/site/tileset.json',
+      type: 'tileset',
+      name: 'Survey Site',
+      autoCenter: true,
+      maxTriangles: 1000000, // adaptive LOD target for VR
+      errorTarget: 16,
+      optimizedLoadStrategy: true
+    }
+  }
+});
+```
+
 ### URL Parameter Integration
 The embed example supports URL parameters for dynamic configuration: