@liveroom-tech/react-immersive 4.0.0 → 4.0.1

package/README.md

@@ -38,6 +38,7 @@ It also exports types for `ObjectBinding`, `ObjectBindingMaterial`, `ObjectBindi
 `ModelViewer` provides:
 
 - GLB/GLTF, OBJ/MTL, FBX, and USDZ model rendering through `@react-three/fiber`
+- camera-driven 3D Tiles streaming through `tilesetUrl`, with configurable screen-space error and bounded tile cache
 - orbit/pan/zoom camera controls via `CameraControls`
 - auto-fits the model on load, and re-fits when the canvas is resized (window resize, device rotation, or a panel opening/closing), toggleable through `refitOnResize` to instead preserve the user's orbit/zoom
 - optional custom scene lighting through a `lights` prop
@@ -648,12 +649,38 @@ configuration as the viewers:
 ```ts
 type BindingBuilderProps = {
   licenseKey: string;
+  licenseValidationUrl?: string;
   dracoDecoderPath?: string | false;
   ktx2TranscoderPath?: string | false;
   meshopt?: boolean;
+  project?: BindingBuilderProject | null;
+  onProjectChange?: (snapshot: BindingBuilderProjectSnapshot, origin: "local" | "remote") => void;
+  projectChangeDebounceMs?: number;
+  onModelUpload?: (file: File) => Promise<BindingBuilderProjectModel>;
+  onEditLeaseChange?: (featureId: string, editing: boolean) => void;
 };
 ```
 
+Pass `tilesetUrl` to `ModelViewer` for a processed 3D Tiles asset. The original
+`modelUrl` remains the durable source/fallback URL, but is not downloaded by the
+viewer while a tileset is present:
+
+```tsx
+<ModelViewer
+  modelUrl="https://assets.example.com/source/building.glb"
+  tilesetUrl="https://assets.example.com/tiles/building/tileset.json"
+  tilesErrorTarget={8}
+  tilesCacheSize={800}
+  licenseKey="your-license-key"
+  objectBindings={{}}
+/>
+```
+
+Tiles are a dynamic level-of-detail scene, so automatic mesh binding generation
+is intentionally disabled in streamed `BindingBuilder` projects. Scene settings
+remain editable. Per-part editing requires the conversion pipeline to provide a
+stable CAD/object catalog that can be mapped to tile feature metadata.
+
 `licenseKey` is validated the same way as `ModelViewer`'s (see [`licenseKey`](#licensekey) below). While the key is being checked, `BindingBuilder` renders a "Verifying license…" placeholder; if it's invalid, it renders an error message instead of the editor.
 
 Current behavior, Object tab: