@liveroom-tech/react-immersive 1.1.0 → 1.1.2

package/README.md

@@ -431,7 +431,7 @@ runAction("car-body", "toggle-visibility");
 Current note:
 
 - visibility-style actions (`toggle-visibility`) update binding data through `onObjectBindingsChange`
-- color/material actions still rely on `ModelViewer`'s built-in UI popovers, so `runAction` dispatches those events but does not open the internal color picker or texture upload popover by itself
+- color/material actions still rely on `ModelViewer`'s built-in UI, so `runAction` dispatches those events but does not open the built-in color picker or texture upload panel by itself
 
 ## `BindingBuilder`
 
@@ -1727,7 +1727,7 @@ Notes:
 - each `style.material` group also accepts a texture-map slot (`metalnessMap`, `roughnessMap`, `normalMap`, `aoMap`, `clearcoatMap`, etc.); color maps are decoded as sRGB and data maps as linear automatically
 - `BindingBuilder` intentionally omits exact Sketchfab glossiness, cavity, and subsurface-scattering workflows; those require preprocessing or a different material pipeline
 - `cameraState` stores a saved camera view for the object; when both `position` and `target` are set, the viewer uses that view when the object is focused or selected instead of falling back to `fitToBox`
-- `metrics` and `metadata` are displayed in the side panel JSON preview
+- `metrics` and `metadata` are displayed in the side panel as nested key/value fields (objects expand into indented child labels)
 - `ObjectBindingType` is a large union covering vehicles, rooms, furniture, characters, weapons, environment, and more
 
 ## Supported Built-In Actions
@@ -1739,9 +1739,9 @@ Action handling is currently hardcoded in `ModelViewer`.
 - `toggle-visibility`
   Hides or shows the selected mesh by setting `binding.visible` and calling `onObjectBindingsChange`
 - `change-color`
-  Opens the color picker; the chosen hex is applied as a live preview while dragging and committed into `binding.style.material.baseColor` via `onObjectBindingsChange` when the picker closes
+  Opens the color picker inline beneath the action; the chosen hex is applied as a live preview while dragging and committed into `binding.style.material.baseColor` via `onObjectBindingsChange` when the picker closes
 - `change-material`
-  Opens the texture upload popup for JPG, PNG, and WebP files; if `onTextureUpload` is provided, the file is passed to it and the returned URL is stored in `binding.style.material.texture.path`; otherwise a session-scoped blob URL is used as the fallback
+  Opens the texture upload panel inline beneath the action for JPG, PNG, and WebP files; if `onTextureUpload` is provided, the file is passed to it and the returned URL is stored in `binding.style.material.texture.path`; otherwise a session-scoped blob URL is used as the fallback
 
 ## How Rendering Works
 
@@ -1774,10 +1774,10 @@ Pass `shadows={false}` to disable shadow rendering entirely, or pass a custom `l
 The current component includes its own UI shell:
 
 - a viewer layout that fills its parent container
-- a sliding left side panel about `280px` wide
+- a sliding left side panel about `280px` wide (collapses to half-width on narrow screens so the canvas keeps its other half)
 - a canvas area that fills the remaining width
-- a floating color picker popover
-- a floating texture upload popover
+- a color picker that expands inline beneath the **Change Color** action
+- a texture upload panel that expands inline beneath the **Change Material** action
 - a right scene objects panel with search and per-object visibility toggles
 
 Because of that, it works best when mounted in a container with an explicit height.