@liveroom-tech/react-immersive 5.1.0 → 5.2.0

package/dist/materialVariants-DnZe9eMC.d.ts

@@ -0,0 +1,309 @@
+/** Built-in viewer text. Override only the keys your application needs. */
+declare const DEFAULT_MODEL_VIEWER_LABELS: {
+    readonly verifyingLicense: "Verifying License";
+    readonly checkingYourLicenseKey: "Checking your license key...";
+    readonly invalidLicense: "Invalid License";
+    readonly licenseHasBeenRevokedOrHasExpired: "License has been revoked or has expired";
+    readonly failedToLoadPleaseContactTheSiteAdministrator: "Failed to load. Please contact the site administrator.";
+    readonly contextRestoringTitle: "Reloading viewer…";
+    readonly contextLostTitle: "3D view interrupted";
+    readonly contextRestoringMessage: "Rebuilding the 3D view. Please wait…";
+    readonly contextLostMessage: "The graphics connection was interrupted. The viewer will rebuild when it returns, or you can reload it now.";
+    readonly reloadViewer: "Reload viewer";
+    readonly texturePositioningHint: "Drag to move · Scroll to zoom · Click elsewhere to finish";
+    readonly texturePositioningStartHint: "Double-click to move or zoom";
+    readonly dismiss: "Dismiss";
+    readonly missingUVsAreShownInMagenta: "Missing UVs are shown in magenta.";
+    readonly viewThisModelInARWithAppleQuickLook: "View this model in AR with Apple Quick Look";
+    readonly viewInAR: "View in AR";
+    readonly openThisExperienceOnAPhoneForAR: "Open this experience on a phone for AR";
+    readonly openOnPhone: "Open on phone";
+    readonly viewThisModelInYourSpace: "View this model in your space";
+    readonly viewThisModelInVR: "View this model in VR";
+    readonly closePhoneHandoff: "Close phone handoff";
+    readonly arScanCode: "Scan the code and choose AR.";
+    readonly qrCodeToOpenThisModelOnAPhone: "QR code to open this model on a phone";
+    readonly disableUVChecker: "Disable UV checker";
+    readonly enableUVChecker: "Enable UV checker";
+    readonly explodedView: "Exploded view";
+    readonly explodeAmount: "Explode amount";
+    readonly removeSectionCut: "Remove section cut";
+    readonly sectionCut: "Section cut";
+    readonly sectionAxis: "Section axis";
+    readonly sectionPosition: "Section position";
+    readonly keepTheOtherSide: "Keep the other side";
+    readonly pauseCinematic: "Pause cinematic";
+    readonly playCinematic: "Play cinematic";
+    readonly stopCinematicAndResetCamera: "Stop cinematic and reset camera";
+    readonly cancel: "Cancel";
+    readonly annotationCategories: "Annotation categories";
+    readonly annotations: "Annotations";
+    readonly all: "All";
+    readonly uncategorized: "Uncategorized";
+    readonly decalDragHint: "Drag the decal on the object. Release to save; Escape to cancel.";
+    readonly showAll: "Show all";
+    readonly materialVariants: "Material variants";
+    readonly startGuidedTour: "Start guided tour";
+    readonly guidedTour: "Guided Tour";
+    readonly previousAnnotation: "Previous annotation";
+    readonly previous: "Prev";
+    readonly stopGuidedTour: "Stop guided tour";
+    readonly nextAnnotation: "Next annotation";
+    readonly next: "Next";
+    readonly exitFullscreen: "Exit fullscreen";
+    readonly enterFullscreen: "Enter fullscreen";
+    readonly resetCameraView: "Reset camera view";
+    readonly orbitControl: "Orbit Control";
+    readonly pointLock: "Point Lock";
+    readonly cameraController: "Camera controller";
+    readonly cameraControllerSettings: "Camera controller settings";
+    readonly downloadGLB: "Download GLB";
+    readonly downloadPNG: "Download PNG";
+    readonly downloadUVLayout: "Download UV Layout";
+    readonly videoFormat: "Video format";
+    readonly auto: "Auto";
+    readonly recordTurntableVideo: "Record turntable video";
+    readonly recordCinematicVideo: "Record cinematic video";
+    readonly videoUnsupported: "Video recording is not supported in this browser.";
+    readonly downloadOptions: "Download options";
+    readonly exporting: "Exporting…";
+    readonly download: "Download";
+    readonly annotationTitlePlaceholder: "Title *";
+    readonly description: "Description";
+    readonly ok: "OK";
+    readonly arRelocate: "Relocate";
+    readonly tapToPlace: "Tap to place";
+    readonly closeAnnotation: "Close annotation";
+    readonly learnMore: "Learn more";
+    readonly stopMeasuring: "Stop measuring";
+    readonly startMeasuring: "Start measuring";
+    readonly toggleBoundingDimensions: "Toggle bounding dimensions";
+    readonly measurementTool: "Measurement tool";
+    readonly distance: "Distance";
+    readonly angle: "Angle";
+    readonly area: "Area";
+    readonly pointToPlane: "Point to plane";
+    readonly measurementSnapping: "Measurement snapping";
+    readonly noSnapping: "No snapping";
+    readonly snapAuto: "Snap: auto";
+    readonly snapVertex: "Snap: vertex";
+    readonly snapEdge: "Snap: edge";
+    readonly undoMeasurementPoint: "Undo measurement point";
+    readonly clearMeasurements: "Clear measurements";
+    readonly finishArea: "Finish area";
+    readonly openSceneObjectsPanel: "Open scene objects panel";
+    readonly sceneObjects: "SCENE OBJECTS";
+    readonly searchNodesLabels: "Search nodes, labels";
+    readonly closeSceneObjectsPanel: "Close scene objects panel";
+    readonly objectNavigator: "Objects in the 3D view";
+    readonly compareBefore: "Before";
+    readonly compareAfter: "After";
+    readonly compareDivider: "Comparison divider";
+    readonly viewIn3D: "View in 3D";
+    readonly objectNavigatorHint: "Arrow keys browse · Enter selects · Esc clears";
+    readonly selectionCleared: "Selection cleared";
+    readonly cameraKeyboardHelp: "3D view. Arrow keys orbit, Shift with Up or Down zooms, and W, A, S, D, Space and C move the camera.";
+    readonly isolate: "Isolate";
+    readonly hide: "Hide";
+    readonly show: "Show";
+    readonly closePanel: "Close panel";
+    readonly actions: "Actions";
+    readonly openPanel: "Open panel";
+    readonly close: "Close";
+    readonly position: "Position";
+    readonly decalNudgeHint: "Click to fine-tune · Hold to move";
+    readonly decalNudgeControls: "Move decal in small steps";
+    readonly text: "Text";
+    readonly yourText: "Your text";
+    readonly textToAdd: "Text to add";
+    readonly textColour: "Text colour";
+    readonly addText: "Add text";
+    readonly image: "Image";
+    readonly chooseImage: "Choose image";
+    readonly imageToAdd: "Image to add";
+    readonly added: "Added";
+    readonly colour: "Colour";
+    readonly size: "Size";
+    readonly turn: "Turn";
+    readonly rotation: "Rotation";
+    readonly dragTheDecalAcrossTheObjectsSurface: "Drag the decal across the object's surface";
+    readonly move: "Move";
+    readonly remove: "Remove";
+    readonly noneAddedYet: "None added yet";
+    readonly done: "Done";
+    readonly moveForward: "Move forward";
+    readonly moveLeft: "Move left";
+    readonly moveRight: "Move right";
+    readonly moveBackward: "Move backward";
+    readonly sceneSettings: "Scene Settings";
+    readonly background: "Background";
+    readonly backgroundColor: "Background Color";
+    readonly environment: "Environment";
+    readonly autoRotate: "Auto Rotate";
+    readonly lighting: "Lighting";
+    readonly exposure: "Exposure";
+    readonly ambientLightIntensity: "Ambient Light Intensity";
+    readonly ambientLightColor: "Ambient Light Color";
+    readonly directLightIntensity: "Direct Light Intensity";
+    readonly directLightColor: "Direct Light Color";
+    readonly searchObjects: "Search objects";
+    readonly uploadedModel: "Uploaded model";
+    readonly clear: "Clear";
+    readonly chooseModel: "Choose model";
+    readonly loadingModel: "Loading model...";
+    readonly releaseToLoadYourModel: "Release to load your model";
+    readonly arFindSurface: "Move your device over a flat surface";
+    readonly arReleaseToPlace: "Release to place";
+    readonly arGestureHint: "Pinch to resize · Twist to rotate";
+    readonly angleFirstArmHint: "Pick the first arm";
+    readonly angleVertexHint: "Pick the angle's vertex";
+    readonly angleSecondArmHint: "Pick the second arm";
+    readonly angleNewHint: "Pick a point to start a new angle";
+    readonly areaNewHint: "Pick a point to start a new area";
+    readonly areaCornersHint: "Pick polygon corners in order, then Finish area";
+    readonly pointToPlaneFaceHint: "Pick the reference face";
+    readonly pointToPlanePointHint: "Pick a point to measure its perpendicular distance";
+    readonly pointToPlaneNewHint: "Pick a face to start a new measurement";
+    readonly distanceHint: "Pick points on the model to measure distances";
+    readonly visibleEntries: "{count} visible entries";
+    readonly objectCount: "{count} objects";
+    readonly annotationMarker: "Annotation {id}: {title}";
+    readonly recordingVideo: "Recording video · {progress}%";
+    readonly isolatedObjects: "Isolated: {count} objects";
+    readonly largeModelWarning: "Very large model ({millions}M triangles) — it may render and move slowly on this device, and click/hover selection on the model is disabled. Use the objects panel to select parts.";
+    readonly preparingLargeModel: "Preparing large model ({millions}M triangles) — the first display can take a while on this device...";
+    readonly enterAR: "Enter AR";
+    readonly enterVR: "Enter VR";
+    readonly decalImage: "Image {index}";
+    readonly decalText: "Text {index}";
+    readonly decalAdded: "{count} added";
+    readonly up: "up";
+    readonly down: "down";
+    readonly left: "left";
+    readonly right: "right";
+    readonly moveDecal: "Move decal {direction}";
+    readonly moveDecalOnSurface: "Move {direction} on the visible surface";
+    readonly showAllObject: "Show all {name}";
+    readonly isolateObject: "Isolate {name}";
+    readonly isolatedObject: "Isolated: {name}";
+    readonly hideObject: "Hide {name}";
+    readonly showObject: "Show {name}";
+    readonly objectSelected: "{name} selected";
+    readonly objectNavigatorPosition: "{position} of {count}";
+    readonly compareDividerValue: "{before} {percent}%, {after} {rest}%";
+    readonly bindingMismatchOne: "1 object binding doesn't match this model";
+    readonly bindingMismatchMany: "{count} object bindings don't match this model";
+    readonly simpleLargeModelWarning: "Very large model detected ({millions}M triangles) — it may render and move slowly on this device, and click/hover selection on the model is disabled. Use the scene objects panel to select parts.";
+    readonly dropModelHint: "Drag and drop {formats} here";
+    readonly loadErrorTitle: "This model couldn't be loaded";
+    readonly loadErrorNotFound: "Nothing was found at this address ({status}). Check that modelUrl points to the file.";
+    readonly loadErrorDenied: "The server refused access to the file ({status}). Check that the file is public, or that a signed URL hasn't expired.";
+    readonly loadErrorStatus: "The server responded with {status} when the file was requested.";
+    readonly loadErrorNetwork: "The download was blocked or failed. Check that the URL is correct and, if the file is on another domain, that its server allows cross-origin requests (CORS) from this site.";
+    readonly loadErrorHtml: "The server sent back a web page instead of a model. There's probably no file at this path: many servers answer a missing file with their index.html.";
+    readonly loadErrorInvalidFile: "The file couldn't be read as {format}. Check that it's a valid {format} file.";
+    readonly loadErrorInvalidExplicitFormat: "The file couldn't be read as {format}. Check that it's a valid {format} file and that modelFormat matches it.";
+    readonly loadErrorMissingFormat: "The file couldn't be read as {format}. The URL has no file extension, so set modelFormat to the file's format.";
+    readonly loadErrorPointCloud: "This PLY file is a point cloud: it has points but no faces, and the viewer shows meshes. Turn it into a mesh first, for example with MeshLab or Blender.";
+    readonly measurementReferenceFaceRequired: "Pick a triangle face to define the reference plane.";
+    readonly measurementTooManyPoints: "Finish or clear this measurement before adding more points.";
+    readonly measurementAngleDistinct: "Pick a point away from the angle's vertex.";
+    readonly areaMinimumPoints: "Pick at least three points to finish the area.";
+    readonly areaDistinctPoints: "Area points must be distinct.";
+    readonly areaStraightLine: "Area points must not lie on one straight line.";
+    readonly areaNotPlanar: "Area points must lie on one plane.";
+    readonly areaEdgesCross: "Area edges must not cross or touch each other.";
+    readonly areaZero: "The polygon has no measurable area.";
+    readonly decalSurfaceMissing: "Could not find a surface on this object for the decal.";
+    readonly decalDirectionMissing: "No visible surface in that direction. Try another arrow or rotate the view.";
+    readonly fullscreenExitFailed: "Could not exit fullscreen. Press Escape to exit.";
+    readonly fullscreenEnterFailed: "Could not enter fullscreen. Check your browser or iframe fullscreen permissions and try again.";
+    readonly uvCoordinatesMissing: "This model does not contain UV coordinates.";
+    readonly uvExportFailed: "Could not create the UV layout archive.";
+    readonly videoExportFailed: "Could not export the video.";
+    readonly videoNotReady: "Viewer not ready for video export.";
+    readonly videoExitXR: "Exit the XR session before recording a video.";
+    readonly videoAlreadyRecording: "A video export is already in progress.";
+    readonly videoPathRequired: "Enable a cinematic camera path before recording it.";
+    readonly videoDurationInvalid: "Video duration must be greater than 0 and at most 300 seconds.";
+    readonly videoFrameRateInvalid: "Video frame rate must be between 1 and 60.";
+    readonly videoBitrateInvalid: "Video bitrate must be a positive number.";
+    readonly videoContextLost: "Video export stopped because the WebGL context was lost.";
+    readonly videoTimedOut: "Video export timed out. Keep the viewer tab visible while recording.";
+    readonly videoEncodingFailed: "The browser could not encode the video.";
+    readonly videoEmpty: "The browser produced an empty video.";
+    readonly videoDidNotStart: "Video recording did not start.";
+    readonly videoWebMUnsupported: "Video recording as WEBM is not supported in this browser.";
+    readonly videoMP4Unsupported: "Video recording as MP4 is not supported in this browser.";
+    readonly videoGIFUnsupported: "Video recording as GIF is not supported in this browser.";
+    readonly videoGifWidthInvalid: "GIF width must be a whole number of pixels from 16 to 4096.";
+    readonly environmentApartment: "apartment";
+    readonly environmentCity: "city";
+    readonly environmentDawn: "dawn";
+    readonly environmentForest: "forest";
+    readonly environmentLobby: "lobby";
+    readonly environmentNight: "night";
+    readonly environmentPark: "park";
+    readonly environmentStudio: "studio";
+    readonly environmentSunset: "sunset";
+    readonly environmentWarehouse: "warehouse";
+    readonly color: "Color";
+    readonly material: "Material";
+    readonly texturePreview: "texture preview";
+    readonly noTextureApplied: "No texture applied";
+    readonly noTextureCoordinates: "This part has no texture coordinates, so an image can't be placed on it.";
+    readonly replaceImage: "Replace image";
+    readonly uploadImage: "Upload image";
+    readonly removeTexture: "Remove texture";
+    readonly texturePosition: "Texture position";
+    readonly offsetX: "Offset X";
+    readonly offsetY: "Offset Y";
+    readonly confirmTexturePosition: "Confirm this texture position and exit positioning mode";
+    readonly donePositioning: "Done positioning";
+    readonly textureOffsetHint: "Double-click the object in the preview to drag its texture directly (scroll to zoom), or edit its offset numerically.";
+    readonly actionToggleLight: "Toggle Light";
+    readonly actionChangeLightColor: "Change Light Color";
+    readonly actionSetBrightness: "Set Brightness";
+    readonly actionChangeColor: "Change Color";
+    readonly actionChangeMaterial: "Change Material";
+    readonly actionToggleVisibility: "Toggle Visibility";
+};
+type ModelViewerLabelKey = keyof typeof DEFAULT_MODEL_VIEWER_LABELS;
+/** Plain-text overrides; dynamic labels use named {placeholders}. */
+type ModelViewerLabels = Partial<Record<ModelViewerLabelKey, string>>;
+
+/**
+ * Whether the viewer cuts motion that starts on its own: `"user"` follows the
+ * visitor's `prefers-reduced-motion` setting, `"always"` and `"never"` override
+ * it.
+ */
+type ReducedMotionSetting = "user" | "always" | "never";
+
+/** One choice in a row of material variants. */
+type MaterialVariantOption = {
+    /** The variant's name, as `sceneConfig.model.activeVariants` lists it. */
+    name: string;
+    /** The name without its group, for display: "Red" for "Paint: Red". */
+    label: string;
+    /**
+     * The colour of the variant's main material, as a CSS colour, when that
+     * material is a plain colour rather than a texture.
+     */
+    swatch?: string;
+};
+/**
+ * Variants that take turns: choosing one replaces the group's other choice.
+ * Variants in different groups combine, like a paint colour and a wheel style.
+ */
+type MaterialVariantGroup = {
+    /** "Paint" for variants named "Paint: Red" or "Paint / Red"; null otherwise. */
+    name: string | null;
+    variants: MaterialVariantOption[];
+};
+/**
+ * The active variants after choosing `name`: it replaces any other variant of
+ * its group, so a paint colour swaps for another while the wheels stay.
+ */
+declare function chooseMaterialVariant(activeVariants: readonly string[], name: string, groups: readonly MaterialVariantGroup[]): string[];
+
+export { DEFAULT_MODEL_VIEWER_LABELS as D, type MaterialVariantGroup as M, type ReducedMotionSetting as R, type MaterialVariantOption as a, type ModelViewerLabelKey as b, type ModelViewerLabels as c, chooseMaterialVariant as d };

package/dist/modelInfo-BYebMPdZ.d.mts

@@ -0,0 +1,43 @@
+import { M as MaterialVariantGroup } from './materialVariants-DnZe9eMC.mjs';
+
+/**
+ * When a viewer starts its 3D view on its own. `"lazy"` waits until it's on
+ * or near the screen and shares the page's live 3D views with the other lazy
+ * viewers, so a page of viewers stays within the browser's limit. `"eager"`
+ * starts at once and keeps its view.
+ */
+type ViewerLoading = "lazy" | "eager";
+/**
+ * Whether the 3D view starts on its own (`"auto"`) or waits on the poster
+ * until the visitor asks for it with a "View in 3D" button (`"interaction"`).
+ */
+type ViewerReveal = "auto" | "interaction";
+
+type ModelFormat = "glb" | "gltf" | "obj" | "fbx" | "usdz" | "stl" | "ply";
+
+type ViewerModelBounds = {
+    min: [number, number, number];
+    max: [number, number, number];
+    center: [number, number, number];
+    size: [number, number, number];
+};
+/** What `onModelLoaded` reports about a model that finished loading. */
+type ViewerModelInfo = {
+    /** Bounds in world space, where the viewer placed the model. */
+    bounds: ViewerModelBounds;
+    /** Number of meshes in the loaded scene. */
+    objectCount: number;
+    /**
+     * Names of the glTF material variants (KHR_materials_variants) the model
+     * offers, in file order; empty when it has none. Show them by setting
+     * `sceneConfig.model.activeVariants`.
+     */
+    materialVariants: string[];
+    /**
+     * The same variants as option groups, with their display labels and
+     * swatches. One variant from each group can show at once.
+     */
+    materialVariantGroups: MaterialVariantGroup[];
+};
+
+export type { ModelFormat as M, ViewerLoading as V, ViewerModelBounds as a, ViewerModelInfo as b, ViewerReveal as c };

package/dist/modelInfo-XfUQO7C_.d.ts

@@ -0,0 +1,43 @@
+import { M as MaterialVariantGroup } from './materialVariants-DnZe9eMC.js';
+
+/**
+ * When a viewer starts its 3D view on its own. `"lazy"` waits until it's on
+ * or near the screen and shares the page's live 3D views with the other lazy
+ * viewers, so a page of viewers stays within the browser's limit. `"eager"`
+ * starts at once and keeps its view.
+ */
+type ViewerLoading = "lazy" | "eager";
+/**
+ * Whether the 3D view starts on its own (`"auto"`) or waits on the poster
+ * until the visitor asks for it with a "View in 3D" button (`"interaction"`).
+ */
+type ViewerReveal = "auto" | "interaction";
+
+type ModelFormat = "glb" | "gltf" | "obj" | "fbx" | "usdz" | "stl" | "ply";
+
+type ViewerModelBounds = {
+    min: [number, number, number];
+    max: [number, number, number];
+    center: [number, number, number];
+    size: [number, number, number];
+};
+/** What `onModelLoaded` reports about a model that finished loading. */
+type ViewerModelInfo = {
+    /** Bounds in world space, where the viewer placed the model. */
+    bounds: ViewerModelBounds;
+    /** Number of meshes in the loaded scene. */
+    objectCount: number;
+    /**
+     * Names of the glTF material variants (KHR_materials_variants) the model
+     * offers, in file order; empty when it has none. Show them by setting
+     * `sceneConfig.model.activeVariants`.
+     */
+    materialVariants: string[];
+    /**
+     * The same variants as option groups, with their display labels and
+     * swatches. One variant from each group can show at once.
+     */
+    materialVariantGroups: MaterialVariantGroup[];
+};
+
+export type { ModelFormat as M, ViewerLoading as V, ViewerModelBounds as a, ViewerModelInfo as b, ViewerReveal as c };

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

@@ -1,6 +1,7 @@
 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 { R as ReducedMotionSetting, c as ModelViewerLabels } from './materialVariants-DnZe9eMC.js';
+import { V as ViewerLoading, c as ViewerReveal, M as ModelFormat, b as ViewerModelInfo } from './modelInfo-XfUQO7C_.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-QwMzISTn.js';
 import { CameraControls } from '@react-three/drei';
 import { Object3D } from 'three';
 
@@ -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
@@ -351,7 +391,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. */
@@ -442,10 +502,18 @@ type ModelViewerProps = GroupedModelViewerProps & {
     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 +526,7 @@ type ModelViewerProps = GroupedModelViewerProps & {
     showIsolateControls?: boolean;
     showSectionTools?: boolean;
     showMaterialVariants?: boolean;
+    showObjectNavigator?: boolean;
     cinematic?: boolean | CinematicConfig;
     measurementUnit?: string;
     enableXR?: boolean;
@@ -466,6 +535,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;
     /**