@liveroom-tech/react-immersive 4.2.7 → 4.2.9

package/dist/index.d.mts

@@ -3,8 +3,8 @@ import { ComponentProps, ReactNode, MutableRefObject } from 'react';
 import { CameraControls } from '@react-three/drei';
 import { Object3D, WebGLRenderer, Scene, Camera, Box3, Material } from 'three';
 import { XRStore } from '@react-three/xr';
-import { x as SceneConfig, f as ObjectBinding, V as ViewerCameraState, e as ObjectActionEvent, u as SceneAnnotationMarker, o as ObjectBindingTarget, m as ObjectBindingPatch, B as BindingEdit, j as ObjectBindingMaterial, q as ObjectBindingTextureSlot, p as ObjectBindingTextureChannel, r as ObjectBindingTransform, z as SceneConfigPatch, E as SceneLight, F as SceneLightAttachment, g as ObjectBindingAction } from './utils-BUwXD_DX.mjs';
-export { A as AnimationAction, a as AnimationActionEffect, b as AnimationLoopMode, C as CameraAction, c as CameraActionEffect, D as DEFAULT_SCENE_CONFIG, M as MATERIAL_BLENDING_MODES, d as MATERIAL_SIDES, O as ObjectActionEffect, h as ObjectBindingActionId, i as ObjectBindingKey, k as ObjectBindingMaterialBlendingMode, l as ObjectBindingMaterialSide, n as ObjectBindingSelector, s as ObjectBindingsActionEffect, S as SceneAnimationClipConfig, t as SceneAnimationConfig, v as SceneCinematicConfig, w as SceneCinematicWaypoint, y as SceneConfigActionEffect, G as SceneLightType, H as SceneModelRenderer, I as VisibilityActionEffect, J as defineObjectBindings, K as material, L as patchBindings, N as patchSceneConfig, P as selectBindingKeys, Q as selectBindings } from './utils-BUwXD_DX.mjs';
+import { x as SceneConfig, f as ObjectBinding, V as ViewerCameraState, e as ObjectActionEvent, u as SceneAnnotationMarker, o as ObjectBindingTarget, m as ObjectBindingPatch, B as BindingEdit, j as ObjectBindingMaterial, q as ObjectBindingTextureSlot, p as ObjectBindingTextureChannel, r as ObjectBindingTransform, z as SceneConfigPatch, E as SceneLight, F as SceneLightAttachment, g as ObjectBindingAction } from './utils-BkdZxLFF.mjs';
+export { A as AnimationAction, a as AnimationActionEffect, b as AnimationLoopMode, C as CameraAction, c as CameraActionEffect, D as DEFAULT_SCENE_CONFIG, M as MATERIAL_BLENDING_MODES, d as MATERIAL_SIDES, O as ObjectActionEffect, h as ObjectBindingActionId, i as ObjectBindingKey, k as ObjectBindingMaterialBlendingMode, l as ObjectBindingMaterialSide, n as ObjectBindingSelector, s as ObjectBindingsActionEffect, S as SceneAnimationClipConfig, t as SceneAnimationConfig, v as SceneCinematicConfig, w as SceneCinematicWaypoint, y as SceneConfigActionEffect, G as SceneLightType, H as SceneModelRenderer, I as VisibilityActionEffect, J as defineObjectBindings, K as material, L as patchBindings, N as patchSceneConfig, P as selectBindingKeys, Q as selectBindings } from './utils-BkdZxLFF.mjs';
 import { Canvas } from '@react-three/fiber';
 import { PresetsType } from '@react-three/drei/helpers/environment-assets';
 
@@ -36,6 +36,19 @@ declare function Viewer({ children, camera, backgroundColor, shadows, sceneConfi
 
 type PerformanceProfile = "auto" | "high" | "low";
 
+type CameraLimits = {
+    minDistance?: number;
+    maxDistance?: number;
+    minPolarAngle?: number;
+    maxPolarAngle?: number;
+    minAzimuthAngle?: number;
+    maxAzimuthAngle?: number;
+    panBoundary?: [min: [number, number, number], max: [number, number, number]];
+    boundaryEnclosesCamera?: boolean;
+    boundaryFriction?: number;
+};
+type CameraControllerType = "orbit" | "pointerLock";
+
 type GltfDecoderConfig = {
     dracoDecoderPath?: string | false;
     ktx2TranscoderPath?: string | false;
@@ -268,6 +281,9 @@ type ModelViewerProps = {
     onObjectEditLeaseChange?: (binding: ObjectBinding, editing: boolean) => void;
     onModelLoaded?: (scene: Object3D) => void;
     onLoadError?: (error: unknown) => void;
+    onProgress?: (event: ProgressEvent) => void;
+    onCameraControllerChange?: (controller: CameraControllerType) => void;
+    cameraControllerType?: CameraControllerType;
     onAction?: (event: ObjectActionEvent) => void;
     onHiddenObjectsChange?: (next: Record<string, boolean>) => void;
     onCameraChange?: (camera: Camera, controls: CameraControls) => void;
@@ -279,6 +295,7 @@ type ModelViewerProps = {
     onActiveAnnotationChange?: (annotation: AnnotationMarker | null) => void;
     lights?: ReactNode;
     camera?: ViewerCamera;
+    cameraLimits?: CameraLimits;
     backgroundColor?: string;
     shadows?: boolean;
     showObjectBindingDataPanel?: boolean;
@@ -326,8 +343,10 @@ type ModelViewerProps = {
     showAnnotationOnHover?: boolean;
     onSceneConfigChange?: (config: SceneConfig) => void;
     showViewGizmo?: boolean;
+    autoRotate?: boolean;
+    autoRotateSpeed?: number;
 };
-declare function ModelViewer({ modelUrl, tilesetUrl, tilesErrorTarget, tilesCacheSize, onObjectCatalog, modelFormat, licenseKey, licenseValidationUrl, objectBindings, selectedObject, panelHoveredObject, onObjectBindingsChange, onObjectSelect, onObjectHover, onObjectEditLeaseChange, onModelLoaded, onLoadError, onAction, onHiddenObjectsChange, onCameraChange, onViewerReady, onTextureUpload, onAnimationsReady, onAnnotationsChange, activeAnnotation: controlledActiveAnnotation, onActiveAnnotationChange, lights, camera, backgroundColor, shadows, showObjectBindingDataPanel, customObjectBindingDataPanel, customSceneObjectsPanel, showSceneObjectsPanel, showDownloadButton, downloadFilename, showResetButton, showLoadingOverlay, showMouseController, mouseControllerPosition, mouseControllerOpacity, moveSensitivity, zoomSensitivity, sceneConfig, onSceneConfigChange, disableZoom, zoomOnSelected, highlightOnHover, enableCameraControls, onAutoFit, refitOnResize, renderMode, maxDpr, preserveDrawingBuffer, performanceProfile, dracoDecoderPath, ktx2TranscoderPath, meshopt, showMeasureTools, showUvCheckerButton, showExplodeControls, cinematic, measurementUnit, enableXR, usdzUrl, arScaleMode, mobileHandoffUrl, showAnnotationNavigation, showAnnotationOnHover, moveModeEnabled, objectTransformSpace, enableKeyboardNavigation, showViewGizmo, }: ModelViewerProps): react_jsx_runtime.JSX.Element;
+declare function ModelViewer({ modelUrl, tilesetUrl, tilesErrorTarget, tilesCacheSize, onObjectCatalog, modelFormat, licenseKey, licenseValidationUrl, objectBindings, selectedObject, panelHoveredObject, onObjectBindingsChange, onObjectSelect, onObjectHover, onObjectEditLeaseChange, onModelLoaded, onLoadError, onProgress, onCameraControllerChange, cameraControllerType, onAction, onHiddenObjectsChange, onCameraChange, onViewerReady, onTextureUpload, onAnimationsReady, onAnnotationsChange, activeAnnotation: controlledActiveAnnotation, onActiveAnnotationChange, lights, camera, cameraLimits, backgroundColor, shadows, showObjectBindingDataPanel, customObjectBindingDataPanel, customSceneObjectsPanel, showSceneObjectsPanel, showDownloadButton, downloadFilename, showResetButton, showLoadingOverlay, showMouseController, mouseControllerPosition, mouseControllerOpacity, moveSensitivity, zoomSensitivity, sceneConfig, onSceneConfigChange, disableZoom, zoomOnSelected, highlightOnHover, enableCameraControls, onAutoFit, refitOnResize, renderMode, maxDpr, preserveDrawingBuffer, performanceProfile, dracoDecoderPath, ktx2TranscoderPath, meshopt, showMeasureTools, showUvCheckerButton, showExplodeControls, cinematic, measurementUnit, enableXR, usdzUrl, arScaleMode, mobileHandoffUrl, showAnnotationNavigation, showAnnotationOnHover, moveModeEnabled, objectTransformSpace, enableKeyboardNavigation, showViewGizmo, autoRotate, autoRotateSpeed, }: ModelViewerProps): react_jsx_runtime.JSX.Element;
 
 type BindingBuilderProjectModel = {
     url: string;

package/dist/index.d.ts

@@ -3,8 +3,8 @@ import { ComponentProps, ReactNode, MutableRefObject } from 'react';
 import { CameraControls } from '@react-three/drei';
 import { Object3D, WebGLRenderer, Scene, Camera, Box3, Material } from 'three';
 import { XRStore } from '@react-three/xr';
-import { x as SceneConfig, f as ObjectBinding, V as ViewerCameraState, e as ObjectActionEvent, u as SceneAnnotationMarker, o as ObjectBindingTarget, m as ObjectBindingPatch, B as BindingEdit, j as ObjectBindingMaterial, q as ObjectBindingTextureSlot, p as ObjectBindingTextureChannel, r as ObjectBindingTransform, z as SceneConfigPatch, E as SceneLight, F as SceneLightAttachment, g as ObjectBindingAction } from './utils-BUwXD_DX.js';
-export { A as AnimationAction, a as AnimationActionEffect, b as AnimationLoopMode, C as CameraAction, c as CameraActionEffect, D as DEFAULT_SCENE_CONFIG, M as MATERIAL_BLENDING_MODES, d as MATERIAL_SIDES, O as ObjectActionEffect, h as ObjectBindingActionId, i as ObjectBindingKey, k as ObjectBindingMaterialBlendingMode, l as ObjectBindingMaterialSide, n as ObjectBindingSelector, s as ObjectBindingsActionEffect, S as SceneAnimationClipConfig, t as SceneAnimationConfig, v as SceneCinematicConfig, w as SceneCinematicWaypoint, y as SceneConfigActionEffect, G as SceneLightType, H as SceneModelRenderer, I as VisibilityActionEffect, J as defineObjectBindings, K as material, L as patchBindings, N as patchSceneConfig, P as selectBindingKeys, Q as selectBindings } from './utils-BUwXD_DX.js';
+import { x as SceneConfig, f as ObjectBinding, V as ViewerCameraState, e as ObjectActionEvent, u as SceneAnnotationMarker, o as ObjectBindingTarget, m as ObjectBindingPatch, B as BindingEdit, j as ObjectBindingMaterial, q as ObjectBindingTextureSlot, p as ObjectBindingTextureChannel, r as ObjectBindingTransform, z as SceneConfigPatch, E as SceneLight, F as SceneLightAttachment, g as ObjectBindingAction } from './utils-BkdZxLFF.js';
+export { A as AnimationAction, a as AnimationActionEffect, b as AnimationLoopMode, C as CameraAction, c as CameraActionEffect, D as DEFAULT_SCENE_CONFIG, M as MATERIAL_BLENDING_MODES, d as MATERIAL_SIDES, O as ObjectActionEffect, h as ObjectBindingActionId, i as ObjectBindingKey, k as ObjectBindingMaterialBlendingMode, l as ObjectBindingMaterialSide, n as ObjectBindingSelector, s as ObjectBindingsActionEffect, S as SceneAnimationClipConfig, t as SceneAnimationConfig, v as SceneCinematicConfig, w as SceneCinematicWaypoint, y as SceneConfigActionEffect, G as SceneLightType, H as SceneModelRenderer, I as VisibilityActionEffect, J as defineObjectBindings, K as material, L as patchBindings, N as patchSceneConfig, P as selectBindingKeys, Q as selectBindings } from './utils-BkdZxLFF.js';
 import { Canvas } from '@react-three/fiber';
 import { PresetsType } from '@react-three/drei/helpers/environment-assets';
 
@@ -36,6 +36,19 @@ declare function Viewer({ children, camera, backgroundColor, shadows, sceneConfi
 
 type PerformanceProfile = "auto" | "high" | "low";
 
+type CameraLimits = {
+    minDistance?: number;
+    maxDistance?: number;
+    minPolarAngle?: number;
+    maxPolarAngle?: number;
+    minAzimuthAngle?: number;
+    maxAzimuthAngle?: number;
+    panBoundary?: [min: [number, number, number], max: [number, number, number]];
+    boundaryEnclosesCamera?: boolean;
+    boundaryFriction?: number;
+};
+type CameraControllerType = "orbit" | "pointerLock";
+
 type GltfDecoderConfig = {
     dracoDecoderPath?: string | false;
     ktx2TranscoderPath?: string | false;
@@ -268,6 +281,9 @@ type ModelViewerProps = {
     onObjectEditLeaseChange?: (binding: ObjectBinding, editing: boolean) => void;
     onModelLoaded?: (scene: Object3D) => void;
     onLoadError?: (error: unknown) => void;
+    onProgress?: (event: ProgressEvent) => void;
+    onCameraControllerChange?: (controller: CameraControllerType) => void;
+    cameraControllerType?: CameraControllerType;
     onAction?: (event: ObjectActionEvent) => void;
     onHiddenObjectsChange?: (next: Record<string, boolean>) => void;
     onCameraChange?: (camera: Camera, controls: CameraControls) => void;
@@ -279,6 +295,7 @@ type ModelViewerProps = {
     onActiveAnnotationChange?: (annotation: AnnotationMarker | null) => void;
     lights?: ReactNode;
     camera?: ViewerCamera;
+    cameraLimits?: CameraLimits;
     backgroundColor?: string;
     shadows?: boolean;
     showObjectBindingDataPanel?: boolean;
@@ -326,8 +343,10 @@ type ModelViewerProps = {
     showAnnotationOnHover?: boolean;
     onSceneConfigChange?: (config: SceneConfig) => void;
     showViewGizmo?: boolean;
+    autoRotate?: boolean;
+    autoRotateSpeed?: number;
 };
-declare function ModelViewer({ modelUrl, tilesetUrl, tilesErrorTarget, tilesCacheSize, onObjectCatalog, modelFormat, licenseKey, licenseValidationUrl, objectBindings, selectedObject, panelHoveredObject, onObjectBindingsChange, onObjectSelect, onObjectHover, onObjectEditLeaseChange, onModelLoaded, onLoadError, onAction, onHiddenObjectsChange, onCameraChange, onViewerReady, onTextureUpload, onAnimationsReady, onAnnotationsChange, activeAnnotation: controlledActiveAnnotation, onActiveAnnotationChange, lights, camera, backgroundColor, shadows, showObjectBindingDataPanel, customObjectBindingDataPanel, customSceneObjectsPanel, showSceneObjectsPanel, showDownloadButton, downloadFilename, showResetButton, showLoadingOverlay, showMouseController, mouseControllerPosition, mouseControllerOpacity, moveSensitivity, zoomSensitivity, sceneConfig, onSceneConfigChange, disableZoom, zoomOnSelected, highlightOnHover, enableCameraControls, onAutoFit, refitOnResize, renderMode, maxDpr, preserveDrawingBuffer, performanceProfile, dracoDecoderPath, ktx2TranscoderPath, meshopt, showMeasureTools, showUvCheckerButton, showExplodeControls, cinematic, measurementUnit, enableXR, usdzUrl, arScaleMode, mobileHandoffUrl, showAnnotationNavigation, showAnnotationOnHover, moveModeEnabled, objectTransformSpace, enableKeyboardNavigation, showViewGizmo, }: ModelViewerProps): react_jsx_runtime.JSX.Element;
+declare function ModelViewer({ modelUrl, tilesetUrl, tilesErrorTarget, tilesCacheSize, onObjectCatalog, modelFormat, licenseKey, licenseValidationUrl, objectBindings, selectedObject, panelHoveredObject, onObjectBindingsChange, onObjectSelect, onObjectHover, onObjectEditLeaseChange, onModelLoaded, onLoadError, onProgress, onCameraControllerChange, cameraControllerType, onAction, onHiddenObjectsChange, onCameraChange, onViewerReady, onTextureUpload, onAnimationsReady, onAnnotationsChange, activeAnnotation: controlledActiveAnnotation, onActiveAnnotationChange, lights, camera, cameraLimits, backgroundColor, shadows, showObjectBindingDataPanel, customObjectBindingDataPanel, customSceneObjectsPanel, showSceneObjectsPanel, showDownloadButton, downloadFilename, showResetButton, showLoadingOverlay, showMouseController, mouseControllerPosition, mouseControllerOpacity, moveSensitivity, zoomSensitivity, sceneConfig, onSceneConfigChange, disableZoom, zoomOnSelected, highlightOnHover, enableCameraControls, onAutoFit, refitOnResize, renderMode, maxDpr, preserveDrawingBuffer, performanceProfile, dracoDecoderPath, ktx2TranscoderPath, meshopt, showMeasureTools, showUvCheckerButton, showExplodeControls, cinematic, measurementUnit, enableXR, usdzUrl, arScaleMode, mobileHandoffUrl, showAnnotationNavigation, showAnnotationOnHover, moveModeEnabled, objectTransformSpace, enableKeyboardNavigation, showViewGizmo, autoRotate, autoRotateSpeed, }: ModelViewerProps): react_jsx_runtime.JSX.Element;
 
 type BindingBuilderProjectModel = {
     url: string;