@liveroom-tech/react-immersive 4.0.0 → 4.0.2

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:
@@ -955,6 +982,24 @@ ending in `.glb`, `.gltf`, `.obj`, `.fbx`, or `.usdz` are detected automatically
 
 License key for the library. Required.
 
+### `licenseValidationUrl`
+
+Optional. Points license validation at a different endpoint, for first-party or
+self-hosted consoles that proxy validation through their own origin instead of
+calling `react-immersive.liveroom.dev` cross-origin.
+
+This is not a way to self-approve a license. When this prop is set, a successful
+response is only accepted if it carries an `offlineGrant` signed by the React
+Immersive license service, verified against the ECDSA public key pinned in this
+package — and the resulting `environment` and `tier` are read from that signed
+grant, not from the surrounding JSON body. An endpoint that returns
+`{"valid": true}` without a valid grant is treated as a broken license server:
+the SDK falls back to a previously verified grant if one is cached, and
+otherwise fails closed.
+
+In practice the endpoint must be a deployment of the official validation route
+configured with `LICENSE_GRANT_PRIVATE_KEY`.
+
 ### `objectBindings`
 
 A map keyed by the model node name. Each key should match a mesh name from the GLB/GLTF file.