@liveroom-tech/react-immersive 5.1.0 → 5.3.0

package/dist/{ModelViewer-Bj-KjiDL.d.mts → modelViewerProps-BalkRDni.d.ts}

@@ -1,8 +1,9 @@
 import { ReactNode } from 'react';
-import { r as ObjectBindingDecal, Q as ObjectSurfacePoint, o as ObjectBinding, al as ViewerCameraState, U as SceneAnnotationMarker, n as ObjectActionEvent, an as ViewerObjectInfo, P as ObjectPointerEvent, e as AnimationControls, ak as ViewerCameraConfig, Z as SceneConfig, am as ViewerIsolation } from './objectCatalog-BIeXURoq.mjs';
-import { M as ModelFormat, a as ViewerModelInfo } from './modelInfo-DnkmTGMd.mjs';
-import { CameraControls } from '@react-three/drei';
 import { Object3D } from 'three';
+import { R as ReducedMotionSetting, c as ModelViewerLabels } from './materialVariants-DjTuiWmN.js';
+import { V as ViewerLoading, c as ViewerReveal, M as ModelFormat, b as ViewerModelInfo } from './modelInfo-BQ5UZu95.js';
+import { r as ObjectBindingDecal, Q as ObjectSurfacePoint, o as ObjectBinding, S as RendererBackend, ap as ViewerCameraState, Y as SceneAnnotationMarker, ar as ViewerObjectInfo, P as ObjectPointerEvent, n as ObjectActionEvent, e as AnimationControls, ao as ViewerCameraConfig, a1 as SceneConfig, aq as ViewerIsolation } from './rendererBackend-C_Jb4_Jy.js';
+import { CameraControls } from '@react-three/drei';
 
 /** Engagement from deliberate viewer interactions, with model/session context. */
 type ViewerEngagementEvent = {
@@ -19,11 +20,15 @@ type ViewerEngagementEvent = {
     objectId: string;
     objectKey: string;
     label?: string;
-    source: "canvas" | "panel";
+    source: "canvas" | "panel" | "keyboard";
 } | {
     type: "variant-chosen";
+    /** The variant chosen; null when a group's choice was cleared. */
     variant: string | null;
+    /** The group's previous choice. */
     previousVariant: string | null;
+    /** The option group's name; null for a group without one. */
+    group: string | null;
 } | {
     type: "ar-started";
 } | {
@@ -107,10 +112,17 @@ type ModelViewerUiOptions = {
     annotationNavigation?: boolean;
     /** Show an annotation's details when its marker is hovered. Default `false`. */
     annotationOnHover?: boolean;
+    /** Category filter chips. Default `true` when annotations have categories. */
+    annotationFilters?: boolean;
     /** Highlight objects under the pointer. Default `true`. */
     highlightOnHover?: boolean;
-    /** Buttons for the model's glTF material variants, when it has more than one. Default `true`. */
+    /** Swatch rows for the model's glTF material variants, one per option group. Default `true`. */
     materialVariants?: boolean;
+    /**
+     * A tab stop for moving through and selecting objects with the keyboard,
+     * shown only while it has focus. Default `true`.
+     */
+    objectNavigator?: boolean;
 };
 /**
  * Takes over parts of texture positioning (`texturePositioning`). Fields left
@@ -151,13 +163,19 @@ type ModelViewerControlsOptions = {
     enabled?: boolean;
     /** Move the camera with the keyboard while the canvas has focus. Default `false`. */
     keyboard?: boolean;
+    /**
+     * Cut motion the viewer starts on its own (auto-rotate, cinematic autoplay,
+     * camera glides). `"user"` follows the visitor's reduced-motion setting.
+     * Default `"user"`.
+     */
+    reducedMotion?: ReducedMotionSetting;
     /** Allow zooming. Default `true`. */
     zoom?: boolean;
     /** Zoom to an object when it's selected. Default `true`. */
     zoomOnSelect?: boolean;
     /** Turn the model slowly; a number sets the speed (1 is normal). Default `false`. */
     autoRotate?: boolean | number;
-    /** Re-frame the model when the viewer is resized. Default `true`. */
+    /** Re-frame the model, or the selected object it zoomed to, when the viewer is resized. Default `true`. */
     refitOnResize?: boolean;
     /** Distance, angle and pan limits for the camera. */
     limits?: CameraLimits;
@@ -175,6 +193,12 @@ type ModelViewerPerfOptions = {
     profile?: PerformanceProfile;
     /** Needed for Download PNG and captureImage; costs GPU time. Default `false`. */
     preserveDrawingBuffer?: boolean;
+    /**
+     * Draw with three's WebGPU renderer where the browser has WebGPU, WebGL
+     * elsewhere. Leaves out post-processing effects, contact shadows and WebXR.
+     * Default `false`.
+     */
+    webgpu?: boolean;
 };
 type ModelViewerTilesOptions = {
     /** A 3D Tiles `tileset.json` to stream instead of loading `modelUrl` whole. */
@@ -256,14 +280,25 @@ type CaptureImageOptions = {
 type CaptureVideoOptions = {
     /** Defaults to cinematic when a path is enabled, otherwise turntable. */
     mode?: "cinematic" | "turntable";
-    /** Auto prefers WebM, then MP4. Explicit formats reject if unsupported. */
-    format?: "auto" | "webm" | "mp4";
-    /** Seconds per pass, in (0, 300]. Defaults to path timing or a 24s orbit. */
+    /**
+     * Auto prefers WebM, then MP4. `"gif"` makes an animated GIF that loops
+     * forever. Explicit formats reject if unsupported.
+     */
+    format?: "auto" | "webm" | "mp4" | "gif";
+    /**
+     * Seconds per pass, in (0, 300]. Defaults to path timing, or an orbit of
+     * 24s (8s for a GIF).
+     */
     duration?: number;
-    /** Capture frame rate, from 1 to 60. Default 30. */
+    /** Capture frame rate, from 1 to 60. Default 30 (15 for a GIF). */
     fps?: number;
-    /** Encoder target bitrate in bits per second. Default 8,000,000. */
+    /** Encoder target bitrate in bits per second. Default 8,000,000. Not used for GIFs. */
     videoBitsPerSecond?: number;
+    /**
+     * GIF width in pixels, from 16 to 4096; the height follows the canvas. Never
+     * wider than the canvas. Default 480.
+     */
+    gifWidth?: number;
     /** Aborting discards the recording and restores the viewer. */
     signal?: AbortSignal;
 };
@@ -297,6 +332,11 @@ type ViewerReadyState = {
     /** Records one cinematic pass or turntable revolution as a video Blob. */
     captureVideo: (options?: CaptureVideoOptions) => Promise<Blob>;
     invalidate: () => void;
+    /**
+     * The renderer drawing the viewer: "webgpu" only when ModelViewer's
+     * `webgpu` asked for it and the browser has WebGPU.
+     */
+    rendererBackend: RendererBackend;
     /**
      * The live three.js scene, camera-controls instance, and model nodes, for
      * integrations the rest of the API doesn't cover. Their shapes are those
@@ -334,6 +374,11 @@ declare function useViewerCamera(options?: UseViewerCameraOptions): ViewerCamera
 
 type ObjectTransformSpace = "local" | "world";
 
+type ModelMergeSource = {
+    url: string;
+    namePrefix: string;
+};
+
 type AnnotationMarker = SceneAnnotationMarker & {
     markerId?: string;
 };
@@ -351,7 +396,27 @@ type CustomSceneObjectsPanelProps = {
     onHover?: (binding: ObjectBinding | null) => void;
 };
 type ModelViewerProps = GroupedModelViewerProps & {
+    /** Plain-text overrides for built-in UI labels. Missing keys use English. */
+    labels?: ModelViewerLabels;
     modelUrl: string;
+    /**
+     * An image shown in the viewer's place until its 3D view is drawn: a render
+     * or photo of the model, best framed as the viewer frames it. Fitted inside
+     * the viewer; set the CSS variable `--ri-poster-fit: cover` to fill it.
+     */
+    poster?: string;
+    /**
+     * `"lazy"` (default) starts the 3D view when the viewer is on or near the
+     * screen. When the page needs room for viewers in view, one scrolled away
+     * from goes back to a picture of itself, and comes back as it was. `"eager"`
+     * starts at once and keeps its view.
+     */
+    loading?: ViewerLoading;
+    /**
+     * `"interaction"` keeps the poster, with a "View in 3D" button, until the
+     * visitor asks for the 3D view. Default `"auto"`.
+     */
+    reveal?: ViewerReveal;
     /** Optional 3D Tiles manifest used instead of loading `modelUrl` monolithically. */
     tilesetUrl?: string | null;
     /** Screen-space error target for streamed 3D Tiles. Lower is sharper. */
@@ -375,6 +440,15 @@ type ModelViewerProps = GroupedModelViewerProps & {
      */
     objectBindings?: Record<string, ObjectBinding> | "auto";
     selectedObject?: ObjectBinding | null;
+    /**
+     * Binding keys of several selected objects. Each is outlined in green.
+     * While set, the single-selection (blue) outline is hidden.
+     */
+    multiSelectedKeys?: readonly string[];
+    /** Explicit nodes to outline together, overriding multiSelectedKeys. */
+    selectedObjectRefs?: Object3D[] | null;
+    /** Color of the multi-selection outlines. Defaults to green. */
+    selectedObjectOutlineColor?: string;
     panelHoveredObject?: ObjectBinding | null;
     onObjectBindingsChange?: (next: Record<string, ObjectBinding>) => void;
     onObjectSelect?: (binding: ObjectBinding | null) => void;
@@ -385,6 +459,8 @@ type ModelViewerProps = GroupedModelViewerProps & {
      * texture positioning when that's enabled.
      */
     onObjectDoubleClick?: (event: ObjectPointerEvent) => boolean | void;
+    /** A decal on the model was double-clicked (the editor uses this to enable Move). */
+    onDecalDoubleClick?: (binding: ObjectBinding, decalId: string) => void;
     /**
      * An object was right-clicked or, on touch screens, long-pressed. Use it to
      * open your own menu at `clientX`/`clientY`. A right-drag still pans.
@@ -409,6 +485,7 @@ type ModelViewerProps = GroupedModelViewerProps & {
     onViewerReady?: (viewer: ViewerReadyState) => void;
     onTextureUpload?: (file: File, objectId: string) => Promise<string>;
     onAnimationsReady?: (controls: AnimationControls) => void;
+    onModelAnimationsReady?: (url: string, controls: AnimationControls) => void;
     onAnnotationsChange?: (annotations: AnnotationMarker[]) => void;
     activeAnnotation?: AnnotationMarker | null;
     onActiveAnnotationChange?: (annotation: AnnotationMarker | null) => void;
@@ -438,14 +515,24 @@ type ModelViewerProps = GroupedModelViewerProps & {
     onAutoFit?: () => Promise<boolean>;
     enableCameraControls?: boolean;
     moveModeEnabled?: boolean;
+    /** Shows a draggable corner handle to resize the selected object, independently of moveModeEnabled. */
+    scaleModeEnabled?: boolean;
     /** Aligns PivotControls to the scene or to the selected object. */
     objectTransformSpace?: ObjectTransformSpace;
     /** Enables canvas-focused camera shortcuts. Disabled by default. */
     enableKeyboardNavigation?: boolean;
+    /**
+     * Cuts motion the viewer starts on its own: auto-rotate and cinematic
+     * autoplay don't start, and camera moves jump instead of gliding. `"user"`
+     * (default) follows the visitor's `prefers-reduced-motion` setting;
+     * `"always"` and `"never"` override it.
+     */
+    reducedMotion?: ReducedMotionSetting;
     refitOnResize?: boolean;
     renderMode?: "always" | "demand";
     maxDpr?: number;
     preserveDrawingBuffer?: boolean;
+    webgpu?: boolean;
     performanceProfile?: PerformanceProfile;
     dracoDecoderPath?: string | false;
     ktx2TranscoderPath?: string | false;
@@ -458,6 +545,7 @@ type ModelViewerProps = GroupedModelViewerProps & {
     showIsolateControls?: boolean;
     showSectionTools?: boolean;
     showMaterialVariants?: boolean;
+    showObjectNavigator?: boolean;
     cinematic?: boolean | CinematicConfig;
     measurementUnit?: string;
     enableXR?: boolean;
@@ -466,6 +554,9 @@ type ModelViewerProps = GroupedModelViewerProps & {
     mobileHandoffUrl?: string;
     showAnnotationNavigation?: boolean;
     showAnnotationOnHover?: boolean;
+    showAnnotationFilters?: boolean;
+    annotationCategories?: string[] | null;
+    onAnnotationCategoriesChange?: (categories: string[] | null) => void;
     onSceneConfigChange?: (config: SceneConfig) => void;
     showViewGizmo?: boolean;
     /**
@@ -492,6 +583,36 @@ type ModelViewerProps = GroupedModelViewerProps & {
      * binding's `style.material.texture`.
      */
     texturePositioning?: boolean | TexturePositioningControls;
+    extraModelUrls?: string[];
+    onExtraModelError?: (url: string, error: unknown) => void;
+    onExtraModelLoaded?: (url: string, scene: Object3D) => void;
+    originalNodePoses?: Record<string, {
+        position: [number, number, number];
+        rotation?: [number, number, number];
+        scale?: [number, number, number];
+    }>;
+    /** Each entry supplies its own bindings. Uncontrolled edits are kept per URL. */
+    models?: ModelViewerModelEntry[];
+    mergeModels?: ModelMergeSource[];
+    onMergeModelLoaded?: (url: string, mergedRoot: Object3D) => void;
+    onMergeModelError?: (url: string, error: unknown) => void;
+    /** Selects a model from the switcher. The switcher is hidden when omitted. */
+    onModelChange?: (url: string) => void;
+};
+type ModelViewerModelEntry = {
+    url: string;
+    /** Display name for the model switcher; falls back to the URL's filename. */
+    label?: string;
+    /** Bindings for this model; used in preference to top-level objectBindings. */
+    objectBindings: Record<string, ObjectBinding>;
+    originalNodePoses?: Record<string, {
+        position: [number, number, number];
+        rotation?: [number, number, number];
+        scale?: [number, number, number];
+    }>;
+    mergeModels?: ModelMergeSource[];
+    /** Scene settings for this slot while parked; the active slot uses the viewer's sceneConfig. */
+    sceneConfig?: SceneConfig;
 };
 
-export { type AnnotationMarker as A, type CameraControllerType as C, type DecalMoveTarget as D, type GroupedModelViewerProps as G, type HomeCameraState as H, MODEL_VIEWER_PRESETS as M, type ObjectTransformSpace as O, type PerformanceProfile as P, type TexturePositioningControls as T, type UseViewerCameraOptions as U, type ViewerCameraPreset as V, type XRScaleMode as X, type CameraLimits as a, type CaptureImageOptions as b, type CaptureVideoOptions as c, type CinematicConfig as d, type CinematicWaypoint as e, type CustomObjectBindingDataPanelProps as f, type CustomSceneObjectsPanelProps as g, type ModelViewerControlsOptions as h, type ModelViewerDecoderOptions as i, type ModelViewerPerfOptions as j, type ModelViewerPreset as k, type ModelViewerProps as l, type ModelViewerTilesOptions as m, type ModelViewerToolsOptions as n, type ModelViewerUiOptions as o, type ModelViewerXrOptions as p, type MouseControllerPosition as q, type ViewerCameraProps as r, type ViewerEngagementEvent as s, type ViewerReadyState as t, useViewerCamera as u };
+export { type AnnotationMarker as A, type CameraControllerType as C, type DecalMoveTarget as D, type GroupedModelViewerProps as G, type HomeCameraState as H, MODEL_VIEWER_PRESETS as M, type ObjectTransformSpace as O, type PerformanceProfile as P, type TexturePositioningControls as T, type UseViewerCameraOptions as U, type ViewerCameraPreset as V, type XRScaleMode as X, type CameraLimits as a, type CaptureImageOptions as b, type CaptureVideoOptions as c, type CinematicConfig as d, type CinematicWaypoint as e, type CustomObjectBindingDataPanelProps as f, type CustomSceneObjectsPanelProps as g, type ModelMergeSource as h, type ModelViewerControlsOptions as i, type ModelViewerDecoderOptions as j, type ModelViewerModelEntry as k, type ModelViewerPerfOptions as l, type ModelViewerPreset as m, type ModelViewerProps as n, type ModelViewerTilesOptions as o, type ModelViewerToolsOptions as p, type ModelViewerUiOptions as q, type ModelViewerXrOptions as r, type MouseControllerPosition as s, type ViewerCameraProps as t, type ViewerEngagementEvent as u, type ViewerReadyState as v, useViewerCamera as w };

package/dist/{ModelViewer-BkQ73y6N.d.ts → modelViewerProps-DdsJDRB7.d.mts}

@@ -1,8 +1,9 @@
 import { ReactNode } from 'react';
-import { r as ObjectBindingDecal, Q as ObjectSurfacePoint, o as ObjectBinding, al as ViewerCameraState, U as SceneAnnotationMarker, n as ObjectActionEvent, an as ViewerObjectInfo, P as ObjectPointerEvent, e as AnimationControls, ak as ViewerCameraConfig, Z as SceneConfig, am as ViewerIsolation } from './objectCatalog-BIeXURoq.js';
-import { M as ModelFormat, a as ViewerModelInfo } from './modelInfo-DnkmTGMd.js';
-import { CameraControls } from '@react-three/drei';
 import { Object3D } from 'three';
+import { R as ReducedMotionSetting, c as ModelViewerLabels } from './materialVariants-DjTuiWmN.mjs';
+import { V as ViewerLoading, c as ViewerReveal, M as ModelFormat, b as ViewerModelInfo } from './modelInfo-CcYpydB7.mjs';
+import { r as ObjectBindingDecal, Q as ObjectSurfacePoint, o as ObjectBinding, S as RendererBackend, ap as ViewerCameraState, Y as SceneAnnotationMarker, ar as ViewerObjectInfo, P as ObjectPointerEvent, n as ObjectActionEvent, e as AnimationControls, ao as ViewerCameraConfig, a1 as SceneConfig, aq as ViewerIsolation } from './rendererBackend-C_Jb4_Jy.mjs';
+import { CameraControls } from '@react-three/drei';
 
 /** Engagement from deliberate viewer interactions, with model/session context. */
 type ViewerEngagementEvent = {
@@ -19,11 +20,15 @@ type ViewerEngagementEvent = {
     objectId: string;
     objectKey: string;
     label?: string;
-    source: "canvas" | "panel";
+    source: "canvas" | "panel" | "keyboard";
 } | {
     type: "variant-chosen";
+    /** The variant chosen; null when a group's choice was cleared. */
     variant: string | null;
+    /** The group's previous choice. */
     previousVariant: string | null;
+    /** The option group's name; null for a group without one. */
+    group: string | null;
 } | {
     type: "ar-started";
 } | {
@@ -107,10 +112,17 @@ type ModelViewerUiOptions = {
     annotationNavigation?: boolean;
     /** Show an annotation's details when its marker is hovered. Default `false`. */
     annotationOnHover?: boolean;
+    /** Category filter chips. Default `true` when annotations have categories. */
+    annotationFilters?: boolean;
     /** Highlight objects under the pointer. Default `true`. */
     highlightOnHover?: boolean;
-    /** Buttons for the model's glTF material variants, when it has more than one. Default `true`. */
+    /** Swatch rows for the model's glTF material variants, one per option group. Default `true`. */
     materialVariants?: boolean;
+    /**
+     * A tab stop for moving through and selecting objects with the keyboard,
+     * shown only while it has focus. Default `true`.
+     */
+    objectNavigator?: boolean;
 };
 /**
  * Takes over parts of texture positioning (`texturePositioning`). Fields left
@@ -151,13 +163,19 @@ type ModelViewerControlsOptions = {
     enabled?: boolean;
     /** Move the camera with the keyboard while the canvas has focus. Default `false`. */
     keyboard?: boolean;
+    /**
+     * Cut motion the viewer starts on its own (auto-rotate, cinematic autoplay,
+     * camera glides). `"user"` follows the visitor's reduced-motion setting.
+     * Default `"user"`.
+     */
+    reducedMotion?: ReducedMotionSetting;
     /** Allow zooming. Default `true`. */
     zoom?: boolean;
     /** Zoom to an object when it's selected. Default `true`. */
     zoomOnSelect?: boolean;
     /** Turn the model slowly; a number sets the speed (1 is normal). Default `false`. */
     autoRotate?: boolean | number;
-    /** Re-frame the model when the viewer is resized. Default `true`. */
+    /** Re-frame the model, or the selected object it zoomed to, when the viewer is resized. Default `true`. */
     refitOnResize?: boolean;
     /** Distance, angle and pan limits for the camera. */
     limits?: CameraLimits;
@@ -175,6 +193,12 @@ type ModelViewerPerfOptions = {
     profile?: PerformanceProfile;
     /** Needed for Download PNG and captureImage; costs GPU time. Default `false`. */
     preserveDrawingBuffer?: boolean;
+    /**
+     * Draw with three's WebGPU renderer where the browser has WebGPU, WebGL
+     * elsewhere. Leaves out post-processing effects, contact shadows and WebXR.
+     * Default `false`.
+     */
+    webgpu?: boolean;
 };
 type ModelViewerTilesOptions = {
     /** A 3D Tiles `tileset.json` to stream instead of loading `modelUrl` whole. */
@@ -256,14 +280,25 @@ type CaptureImageOptions = {
 type CaptureVideoOptions = {
     /** Defaults to cinematic when a path is enabled, otherwise turntable. */
     mode?: "cinematic" | "turntable";
-    /** Auto prefers WebM, then MP4. Explicit formats reject if unsupported. */
-    format?: "auto" | "webm" | "mp4";
-    /** Seconds per pass, in (0, 300]. Defaults to path timing or a 24s orbit. */
+    /**
+     * Auto prefers WebM, then MP4. `"gif"` makes an animated GIF that loops
+     * forever. Explicit formats reject if unsupported.
+     */
+    format?: "auto" | "webm" | "mp4" | "gif";
+    /**
+     * Seconds per pass, in (0, 300]. Defaults to path timing, or an orbit of
+     * 24s (8s for a GIF).
+     */
     duration?: number;
-    /** Capture frame rate, from 1 to 60. Default 30. */
+    /** Capture frame rate, from 1 to 60. Default 30 (15 for a GIF). */
     fps?: number;
-    /** Encoder target bitrate in bits per second. Default 8,000,000. */
+    /** Encoder target bitrate in bits per second. Default 8,000,000. Not used for GIFs. */
     videoBitsPerSecond?: number;
+    /**
+     * GIF width in pixels, from 16 to 4096; the height follows the canvas. Never
+     * wider than the canvas. Default 480.
+     */
+    gifWidth?: number;
     /** Aborting discards the recording and restores the viewer. */
     signal?: AbortSignal;
 };
@@ -297,6 +332,11 @@ type ViewerReadyState = {
     /** Records one cinematic pass or turntable revolution as a video Blob. */
     captureVideo: (options?: CaptureVideoOptions) => Promise<Blob>;
     invalidate: () => void;
+    /**
+     * The renderer drawing the viewer: "webgpu" only when ModelViewer's
+     * `webgpu` asked for it and the browser has WebGPU.
+     */
+    rendererBackend: RendererBackend;
     /**
      * The live three.js scene, camera-controls instance, and model nodes, for
      * integrations the rest of the API doesn't cover. Their shapes are those
@@ -334,6 +374,11 @@ declare function useViewerCamera(options?: UseViewerCameraOptions): ViewerCamera
 
 type ObjectTransformSpace = "local" | "world";
 
+type ModelMergeSource = {
+    url: string;
+    namePrefix: string;
+};
+
 type AnnotationMarker = SceneAnnotationMarker & {
     markerId?: string;
 };
@@ -351,7 +396,27 @@ type CustomSceneObjectsPanelProps = {
     onHover?: (binding: ObjectBinding | null) => void;
 };
 type ModelViewerProps = GroupedModelViewerProps & {
+    /** Plain-text overrides for built-in UI labels. Missing keys use English. */
+    labels?: ModelViewerLabels;
     modelUrl: string;
+    /**
+     * An image shown in the viewer's place until its 3D view is drawn: a render
+     * or photo of the model, best framed as the viewer frames it. Fitted inside
+     * the viewer; set the CSS variable `--ri-poster-fit: cover` to fill it.
+     */
+    poster?: string;
+    /**
+     * `"lazy"` (default) starts the 3D view when the viewer is on or near the
+     * screen. When the page needs room for viewers in view, one scrolled away
+     * from goes back to a picture of itself, and comes back as it was. `"eager"`
+     * starts at once and keeps its view.
+     */
+    loading?: ViewerLoading;
+    /**
+     * `"interaction"` keeps the poster, with a "View in 3D" button, until the
+     * visitor asks for the 3D view. Default `"auto"`.
+     */
+    reveal?: ViewerReveal;
     /** Optional 3D Tiles manifest used instead of loading `modelUrl` monolithically. */
     tilesetUrl?: string | null;
     /** Screen-space error target for streamed 3D Tiles. Lower is sharper. */
@@ -375,6 +440,15 @@ type ModelViewerProps = GroupedModelViewerProps & {
      */
     objectBindings?: Record<string, ObjectBinding> | "auto";
     selectedObject?: ObjectBinding | null;
+    /**
+     * Binding keys of several selected objects. Each is outlined in green.
+     * While set, the single-selection (blue) outline is hidden.
+     */
+    multiSelectedKeys?: readonly string[];
+    /** Explicit nodes to outline together, overriding multiSelectedKeys. */
+    selectedObjectRefs?: Object3D[] | null;
+    /** Color of the multi-selection outlines. Defaults to green. */
+    selectedObjectOutlineColor?: string;
     panelHoveredObject?: ObjectBinding | null;
     onObjectBindingsChange?: (next: Record<string, ObjectBinding>) => void;
     onObjectSelect?: (binding: ObjectBinding | null) => void;
@@ -385,6 +459,8 @@ type ModelViewerProps = GroupedModelViewerProps & {
      * texture positioning when that's enabled.
      */
     onObjectDoubleClick?: (event: ObjectPointerEvent) => boolean | void;
+    /** A decal on the model was double-clicked (the editor uses this to enable Move). */
+    onDecalDoubleClick?: (binding: ObjectBinding, decalId: string) => void;
     /**
      * An object was right-clicked or, on touch screens, long-pressed. Use it to
      * open your own menu at `clientX`/`clientY`. A right-drag still pans.
@@ -409,6 +485,7 @@ type ModelViewerProps = GroupedModelViewerProps & {
     onViewerReady?: (viewer: ViewerReadyState) => void;
     onTextureUpload?: (file: File, objectId: string) => Promise<string>;
     onAnimationsReady?: (controls: AnimationControls) => void;
+    onModelAnimationsReady?: (url: string, controls: AnimationControls) => void;
     onAnnotationsChange?: (annotations: AnnotationMarker[]) => void;
     activeAnnotation?: AnnotationMarker | null;
     onActiveAnnotationChange?: (annotation: AnnotationMarker | null) => void;
@@ -438,14 +515,24 @@ type ModelViewerProps = GroupedModelViewerProps & {
     onAutoFit?: () => Promise<boolean>;
     enableCameraControls?: boolean;
     moveModeEnabled?: boolean;
+    /** Shows a draggable corner handle to resize the selected object, independently of moveModeEnabled. */
+    scaleModeEnabled?: boolean;
     /** Aligns PivotControls to the scene or to the selected object. */
     objectTransformSpace?: ObjectTransformSpace;
     /** Enables canvas-focused camera shortcuts. Disabled by default. */
     enableKeyboardNavigation?: boolean;
+    /**
+     * Cuts motion the viewer starts on its own: auto-rotate and cinematic
+     * autoplay don't start, and camera moves jump instead of gliding. `"user"`
+     * (default) follows the visitor's `prefers-reduced-motion` setting;
+     * `"always"` and `"never"` override it.
+     */
+    reducedMotion?: ReducedMotionSetting;
     refitOnResize?: boolean;
     renderMode?: "always" | "demand";
     maxDpr?: number;
     preserveDrawingBuffer?: boolean;
+    webgpu?: boolean;
     performanceProfile?: PerformanceProfile;
     dracoDecoderPath?: string | false;
     ktx2TranscoderPath?: string | false;
@@ -458,6 +545,7 @@ type ModelViewerProps = GroupedModelViewerProps & {
     showIsolateControls?: boolean;
     showSectionTools?: boolean;
     showMaterialVariants?: boolean;
+    showObjectNavigator?: boolean;
     cinematic?: boolean | CinematicConfig;
     measurementUnit?: string;
     enableXR?: boolean;
@@ -466,6 +554,9 @@ type ModelViewerProps = GroupedModelViewerProps & {
     mobileHandoffUrl?: string;
     showAnnotationNavigation?: boolean;
     showAnnotationOnHover?: boolean;
+    showAnnotationFilters?: boolean;
+    annotationCategories?: string[] | null;
+    onAnnotationCategoriesChange?: (categories: string[] | null) => void;
     onSceneConfigChange?: (config: SceneConfig) => void;
     showViewGizmo?: boolean;
     /**
@@ -492,6 +583,36 @@ type ModelViewerProps = GroupedModelViewerProps & {
      * binding's `style.material.texture`.
      */
     texturePositioning?: boolean | TexturePositioningControls;
+    extraModelUrls?: string[];
+    onExtraModelError?: (url: string, error: unknown) => void;
+    onExtraModelLoaded?: (url: string, scene: Object3D) => void;
+    originalNodePoses?: Record<string, {
+        position: [number, number, number];
+        rotation?: [number, number, number];
+        scale?: [number, number, number];
+    }>;
+    /** Each entry supplies its own bindings. Uncontrolled edits are kept per URL. */
+    models?: ModelViewerModelEntry[];
+    mergeModels?: ModelMergeSource[];
+    onMergeModelLoaded?: (url: string, mergedRoot: Object3D) => void;
+    onMergeModelError?: (url: string, error: unknown) => void;
+    /** Selects a model from the switcher. The switcher is hidden when omitted. */
+    onModelChange?: (url: string) => void;
+};
+type ModelViewerModelEntry = {
+    url: string;
+    /** Display name for the model switcher; falls back to the URL's filename. */
+    label?: string;
+    /** Bindings for this model; used in preference to top-level objectBindings. */
+    objectBindings: Record<string, ObjectBinding>;
+    originalNodePoses?: Record<string, {
+        position: [number, number, number];
+        rotation?: [number, number, number];
+        scale?: [number, number, number];
+    }>;
+    mergeModels?: ModelMergeSource[];
+    /** Scene settings for this slot while parked; the active slot uses the viewer's sceneConfig. */
+    sceneConfig?: SceneConfig;
 };
 
-export { type AnnotationMarker as A, type CameraControllerType as C, type DecalMoveTarget as D, type GroupedModelViewerProps as G, type HomeCameraState as H, MODEL_VIEWER_PRESETS as M, type ObjectTransformSpace as O, type PerformanceProfile as P, type TexturePositioningControls as T, type UseViewerCameraOptions as U, type ViewerCameraPreset as V, type XRScaleMode as X, type CameraLimits as a, type CaptureImageOptions as b, type CaptureVideoOptions as c, type CinematicConfig as d, type CinematicWaypoint as e, type CustomObjectBindingDataPanelProps as f, type CustomSceneObjectsPanelProps as g, type ModelViewerControlsOptions as h, type ModelViewerDecoderOptions as i, type ModelViewerPerfOptions as j, type ModelViewerPreset as k, type ModelViewerProps as l, type ModelViewerTilesOptions as m, type ModelViewerToolsOptions as n, type ModelViewerUiOptions as o, type ModelViewerXrOptions as p, type MouseControllerPosition as q, type ViewerCameraProps as r, type ViewerEngagementEvent as s, type ViewerReadyState as t, useViewerCamera as u };
+export { type AnnotationMarker as A, type CameraControllerType as C, type DecalMoveTarget as D, type GroupedModelViewerProps as G, type HomeCameraState as H, MODEL_VIEWER_PRESETS as M, type ObjectTransformSpace as O, type PerformanceProfile as P, type TexturePositioningControls as T, type UseViewerCameraOptions as U, type ViewerCameraPreset as V, type XRScaleMode as X, type CameraLimits as a, type CaptureImageOptions as b, type CaptureVideoOptions as c, type CinematicConfig as d, type CinematicWaypoint as e, type CustomObjectBindingDataPanelProps as f, type CustomSceneObjectsPanelProps as g, type ModelMergeSource as h, type ModelViewerControlsOptions as i, type ModelViewerDecoderOptions as j, type ModelViewerModelEntry as k, type ModelViewerPerfOptions as l, type ModelViewerPreset as m, type ModelViewerProps as n, type ModelViewerTilesOptions as o, type ModelViewerToolsOptions as p, type ModelViewerUiOptions as q, type ModelViewerXrOptions as r, type MouseControllerPosition as s, type ViewerCameraProps as t, type ViewerEngagementEvent as u, type ViewerReadyState as v, useViewerCamera as w };

package/dist/{objectCatalog-BIeXURoq.d.ts → rendererBackend-C_Jb4_Jy.d.mts}

@@ -105,10 +105,11 @@ type SceneModelConfig = {
     autoRotate?: boolean;
     autoRotateSpeed?: number;
     /**
-     * The glTF material variant (KHR_materials_variants) to show, by name, or
-     * null for the model's default materials.
+     * The glTF material variants (KHR_materials_variants) to show, by name: at
+     * most one from each option group (see `MaterialVariantGroup`). Empty, or
+     * left out, for the model's default materials.
      */
-    materialVariant?: string | null;
+    activeVariants?: string[];
 };
 type SceneCameraConfig = {
     fieldOfView: number;
@@ -360,6 +361,22 @@ type ScenePostProcessingConfig = {
         rampInvert: boolean;
     };
 };
+type SceneAnnotationCameraView = {
+    position: [number, number, number];
+    target: [number, number, number];
+    azimuthAngle?: number;
+    polarAngle?: number;
+    fov?: number | null;
+    zoom?: number;
+};
+type SceneAnnotationImage = {
+    src: string;
+    alt?: string;
+};
+type SceneAnnotationLink = {
+    href: string;
+    label: string;
+};
 type SceneAnnotationMarker = {
     id: number;
     worldPosition: [number, number, number];
@@ -369,6 +386,14 @@ type SceneAnnotationMarker = {
     anchorLocalPosition?: [number, number, number];
     title: string;
     description: string;
+    /** World-space camera framing restored on selection and during tours. */
+    cameraView?: SceneAnnotationCameraView;
+    images?: SceneAnnotationImage[];
+    links?: SceneAnnotationLink[];
+    category?: string;
+    /** Inclusive camera-to-marker distance bounds, in scene units. */
+    minDistance?: number;
+    maxDistance?: number;
 };
 type SceneCinematicWaypoint = {
     position: [number, number, number];
@@ -568,6 +593,8 @@ type ViewerAnimationsProps = {
     setSpeed: (speed: number, clipName?: string) => void;
     seek: (time: number, clipName?: string) => void;
     handleAnimationsReady: (controls: AnimationControls) => void;
+    /** Disconnect the previous model while the next one is loading. */
+    clearAnimations: () => void;
 };
 declare function useViewerAnimations(): ViewerAnimationsProps;
 
@@ -709,12 +736,23 @@ type ObjectBindingTextureSlot = {
 };
 type ObjectBindingTextureChannel = "baseColor" | "metalness" | "roughness" | "emissive" | "alpha" | "normal" | "bump" | "ao" | "displacement" | "clearcoat" | "clearcoatRoughness" | "clearcoatNormal" | "anisotropy" | "transmission" | "thickness" | "sheenColor" | "sheenRoughness" | "specularIntensity" | "specularColor";
 type ObjectBindingTransform = {
-    /** Local-space position in model units. */
+    /** Local xy/xz/yz shear, applied between rotation and scale. Preserves rigid world edits under non-uniform parents. */
+    shear?: [number, number, number];
+    /** Local-space node-origin position, or the reference-pose position when pivot is set. */
     position?: [number, number, number];
     /** Local-space Euler rotation in radians. */
     rotation?: [number, number, number];
     /** Local-space scale. */
     scale?: [number, number, number];
+    /**
+     * Opt-in centered editing. Legacy transforms without this field remain direct
+     * local P/R/S. The reference offset keeps position independent of later
+     * rotation/scale edits: rendered origin = position + offset - R * H * S * point (H is shear).
+     */
+    pivot?: {
+        point: [number, number, number];
+        offset: [number, number, number];
+    };
 };
 declare const MATERIAL_SIDES: readonly ["front", "back", "double"];
 type ObjectBindingMaterialSide = (typeof MATERIAL_SIDES)[number];
@@ -819,6 +857,7 @@ type ObjectBinding = {
     group?: string;
     tags?: string[];
     status?: ObjectBindingStatus;
+    removed?: boolean;
     visible?: boolean;
     selectable?: boolean;
     hoverable?: boolean;
@@ -872,4 +911,7 @@ type ViewerObjectInfo = {
     maximum: [number, number, number];
 };
 
-export { type SceneConfigPatch as $, type AnimationAction as A, type BindingEdit as B, type CameraAction as C, DEFAULT_SCENE_CONFIG as D, type EnvironmentPreset as E, type ObjectBindingTextureChannel as F, type GlitchModeName as G, type ObjectBindingTextureSlot as H, type IsolatedObjectBindings as I, type ObjectBindingTransform as J, type KernelSizeName as K, type ObjectBindingType as L, MATERIAL_BLENDING_MODES as M, type ObjectBindingsActionEffect as N, type ObjectActionEffect as O, type ObjectPointerEvent as P, type ObjectSurfacePoint as Q, type RampTypeName as R, type SceneAnimationClipConfig as S, type SceneAnimationConfig as T, type SceneAnnotationMarker as U, type SceneBackgroundConfig as V, type SceneCameraConfig as W, type SceneCinematicConfig as X, type SceneCinematicWaypoint as Y, type SceneConfig as Z, type SceneConfigActionEffect as _, type AnimationActionEffect as a, type SceneEnvironmentConfig as a0, type SceneGroundShadowConfig as a1, type SceneLight as a2, type SceneLightAttachment as a3, type SceneLightType as a4, type SceneLightingConfig as a5, type SceneModelConfig as a6, type SceneModelRenderer as a7, type ScenePostProcessingConfig as a8, type SceneSectionAxis as a9, type SceneSectionConfig as aa, type SceneShadowConfig as ab, type SceneStyleColorScale as ac, type SceneStyleCondition as ad, type SceneStylePulse as ae, type SceneStyleRule as af, type SceneWireframeConfig as ag, type StyledObjectBindings as ah, type StyledObjectPulse as ai, type ViewerAnimationsProps as aj, type ViewerCameraConfig as ak, type ViewerCameraState as al, type ViewerIsolation as am, type ViewerObjectInfo as an, type VisibilityActionEffect as ao, applyIsolation as ap, applyStyleRules as aq, colorScaleValue as ar, isolatedBindingKeys as as, material as at, patchBindings as au, patchSceneConfig as av, selectBindingKeys as aw, selectBindings as ax, useViewerAnimations as ay, type AnimationClipInfo as b, type AnimationClipState as c, type AnimationClipStatus as d, type AnimationControls as e, type AnimationLoopMode as f, type AnimationPlayOptions as g, type AnimationPlaybackState as h, type CameraActionEffect as i, DEFAULT_SECTION_CONFIG as j, type DeepPartial as k, type IsolationActionEffect as l, MATERIAL_SIDES as m, type ObjectActionEvent as n, type ObjectBinding as o, type ObjectBindingAction as p, type ObjectBindingCameraState as q, type ObjectBindingDecal as r, type ObjectBindingMaterial as s, type ObjectBindingMaterialBlendingMode as t, type ObjectBindingMaterialSide as u, type ObjectBindingPatch as v, type ObjectBindingSelector as w, type ObjectBindingStatus as x, type ObjectBindingStyle as y, type ObjectBindingTarget as z };
+/** Which three.js renderer draws a viewer. */
+type RendererBackend = "webgl" | "webgpu";
+
+export { type SceneCinematicConfig as $, type AnimationAction as A, type BindingEdit as B, type CameraAction as C, DEFAULT_SCENE_CONFIG as D, type EnvironmentPreset as E, type ObjectBindingTextureChannel as F, type GlitchModeName as G, type ObjectBindingTextureSlot as H, type IsolatedObjectBindings as I, type ObjectBindingTransform as J, type KernelSizeName as K, type ObjectBindingType as L, MATERIAL_BLENDING_MODES as M, type ObjectBindingsActionEffect as N, type ObjectActionEffect as O, type ObjectPointerEvent as P, type ObjectSurfacePoint as Q, type RampTypeName as R, type RendererBackend as S, type SceneAnimationClipConfig as T, type SceneAnimationConfig as U, type SceneAnnotationCameraView as V, type SceneAnnotationImage as W, type SceneAnnotationLink as X, type SceneAnnotationMarker as Y, type SceneBackgroundConfig as Z, type SceneCameraConfig as _, type AnimationActionEffect as a, type SceneCinematicWaypoint as a0, type SceneConfig as a1, type SceneConfigActionEffect as a2, type SceneConfigPatch as a3, type SceneEnvironmentConfig as a4, type SceneGroundShadowConfig as a5, type SceneLight as a6, type SceneLightAttachment as a7, type SceneLightType as a8, type SceneLightingConfig as a9, selectBindingKeys as aA, selectBindings as aB, useViewerAnimations as aC, type SceneModelConfig as aa, type SceneModelRenderer as ab, type ScenePostProcessingConfig as ac, type SceneSectionAxis as ad, type SceneSectionConfig as ae, type SceneShadowConfig as af, type SceneStyleColorScale as ag, type SceneStyleCondition as ah, type SceneStylePulse as ai, type SceneStyleRule as aj, type SceneWireframeConfig as ak, type StyledObjectBindings as al, type StyledObjectPulse as am, type ViewerAnimationsProps as an, type ViewerCameraConfig as ao, type ViewerCameraState as ap, type ViewerIsolation as aq, type ViewerObjectInfo as ar, type VisibilityActionEffect as as, applyIsolation as at, applyStyleRules as au, colorScaleValue as av, isolatedBindingKeys as aw, material as ax, patchBindings as ay, patchSceneConfig as az, type AnimationClipInfo as b, type AnimationClipState as c, type AnimationClipStatus as d, type AnimationControls as e, type AnimationLoopMode as f, type AnimationPlayOptions as g, type AnimationPlaybackState as h, type CameraActionEffect as i, DEFAULT_SECTION_CONFIG as j, type DeepPartial as k, type IsolationActionEffect as l, MATERIAL_SIDES as m, type ObjectActionEvent as n, type ObjectBinding as o, type ObjectBindingAction as p, type ObjectBindingCameraState as q, type ObjectBindingDecal as r, type ObjectBindingMaterial as s, type ObjectBindingMaterialBlendingMode as t, type ObjectBindingMaterialSide as u, type ObjectBindingPatch as v, type ObjectBindingSelector as w, type ObjectBindingStatus as x, type ObjectBindingStyle as y, type ObjectBindingTarget as z };