@liveroom-tech/react-immersive 4.3.0 → 5.0.0

package/dist/index.d.mts

@@ -1,62 +1,16 @@
-import * as react_jsx_runtime from 'react/jsx-runtime';
-import { g as ModelViewerProps, B as BindingBuilderProps, M as ModelFormat, V as ViewerAnimationsProps, i as ViewerCameraProps, j as ViewerReadyState, C as CaptureImageOptions } from './publicProps-BST1E8an.mjs';
-export { A as AnimationClipInfo, a as AnimationControls, b as AnimationPlaybackState, c as CinematicConfig, d as CinematicWaypoint, e as CustomObjectBindingDataPanelProps, f as CustomSceneObjectsPanelProps, H as HomeCameraState, O as ObjectTransformSpace, S as StreamingTilesModelProps, T as TileObjectCatalogEntry, U as UseViewerCameraOptions, h as ViewerCameraPreset, X as XRScaleMode, u as useViewerAnimations, k as useViewerCamera } from './publicProps-BST1E8an.mjs';
-import { Object3D } from 'three';
-import { PresetsType } from '@react-three/drei/helpers/environment-assets';
-import { f as ObjectBinding, m as ObjectBindingTarget, k as ObjectBindingPatch, B as BindingEdit, h as ObjectBindingMaterial, o as ObjectBindingTextureSlot, n as ObjectBindingTextureChannel, p as ObjectBindingTransform, v as SceneConfig, x as SceneConfigPatch, y as SceneLight, z as SceneLightAttachment, e as ObjectActionEvent, g as ObjectBindingAction, V as ViewerCameraState } from './objectBinding-CBRYMYk6.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, i as ObjectBindingMaterialBlendingMode, j as ObjectBindingMaterialSide, l as ObjectBindingSelector, q as ObjectBindingsActionEffect, S as SceneAnimationClipConfig, r as SceneAnimationConfig, t as SceneCinematicConfig, u as SceneCinematicWaypoint, w as SceneConfigActionEffect, E as SceneLightType, F as SceneModelRenderer, G as VisibilityActionEffect, H as material, I as patchBindings, J as patchSceneConfig, K as selectBindingKeys, L as selectBindings } from './objectBinding-CBRYMYk6.mjs';
-export { ObjectBindingActionId, ObjectBindingKey, defineObjectBindings } from './utils.mjs';
-import 'react';
+import * as react from 'react';
+import { n as ModelViewerProps, V as ViewerAnimationsProps, u as ViewerCameraProps, v as ViewerReadyState, e as CaptureImageOptions, U as UseViewerCameraOptions } from './ModelViewer-CbbJT85n.mjs';
+export { A as AnimationClipInfo, a as AnimationControls, b as AnimationPlaybackState, c as AnnotationMarker, C as CameraControllerType, d as CameraLimits, f as CinematicConfig, g as CinematicWaypoint, h as CustomObjectBindingDataPanelProps, i as CustomSceneObjectsPanelProps, G as GroupedModelViewerProps, H as HomeCameraState, M as MODEL_VIEWER_PRESETS, j as ModelViewerControlsOptions, k as ModelViewerDecoderOptions, l as ModelViewerPerfOptions, m as ModelViewerPreset, o as ModelViewerTilesOptions, p as ModelViewerToolsOptions, q as ModelViewerUiOptions, r as ModelViewerXrOptions, s as MouseControllerPosition, O as ObjectTransformSpace, P as PerformanceProfile, T as TexturePositioningControls, t as ViewerCameraPreset, X as XRScaleMode, w as useViewerAnimations, x as useViewerCamera } from './ModelViewer-CbbJT85n.mjs';
+import { g as ObjectBinding, q as ObjectBindingTarget, m as ObjectBindingPatch, B as BindingEdit, j as ObjectBindingMaterial, s as ObjectBindingTextureSlot, r as ObjectBindingTextureChannel, t as ObjectBindingTransform, J as SceneConfig, N as SceneConfigPatch, T as SceneLight, U as SceneLightAttachment, h as ObjectBindingAction, f as ObjectActionEvent, a2 as ViewerObjectInfo, a1 as ViewerCameraState } from './objectCatalog-5W8n5xNQ.mjs';
+export { A as AnimationAction, a as AnimationActionEffect, b as AnimationLoopMode, C as CameraAction, c as CameraActionEffect, D as DEFAULT_SCENE_CONFIG, d as DeepPartial, E as EnvironmentPreset, G as GlitchModeName, K as KernelSizeName, M as MATERIAL_BLENDING_MODES, e as MATERIAL_SIDES, O as ObjectActionEffect, i as ObjectBindingCameraState, k as ObjectBindingMaterialBlendingMode, l as ObjectBindingMaterialSide, n as ObjectBindingSelector, o as ObjectBindingStatus, p as ObjectBindingStyle, u as ObjectBindingType, v as ObjectBindingsActionEffect, w as ObjectPointerEvent, R as RampTypeName, S as SceneAnimationClipConfig, x as SceneAnimationConfig, y as SceneAnnotationMarker, z as SceneBackgroundConfig, F as SceneCameraConfig, H as SceneCinematicConfig, I as SceneCinematicWaypoint, L as SceneConfigActionEffect, P as SceneEnvironmentConfig, Q as SceneGroundShadowConfig, V as SceneLightType, W as SceneLightingConfig, X as SceneModelConfig, Y as SceneModelRenderer, Z as ScenePostProcessingConfig, _ as SceneShadowConfig, $ as SceneWireframeConfig, a0 as ViewerCameraConfig, a3 as VisibilityActionEffect, a4 as material, a5 as patchBindings, a6 as patchSceneConfig, a7 as selectBindingKeys, a8 as selectBindings } from './objectCatalog-5W8n5xNQ.mjs';
+import { SceneLightInput } from './utils.mjs';
+export { ACTION_CATALOG, ActionCatalogEntry, ActionHandling, ObjectBindingActionId, ObjectBindingKey, buildBindingsFromNodes, createDefaultBinding, defineObjectBindings, findCatalogAction, inferType, sceneLight } from './utils.mjs';
+import { V as ViewerModelBounds, a as ViewerModelInfo } from './modelInfo-CEmmvVCH.mjs';
+export { M as ModelFormat } from './modelInfo-CEmmvVCH.mjs';
 import '@react-three/drei';
-import '@react-three/xr';
-import '@react-three/fiber';
+import 'three';
 
-declare function ModelViewer(props: ModelViewerProps): react_jsx_runtime.JSX.Element;
-
-declare function BindingBuilder(props: BindingBuilderProps): react_jsx_runtime.JSX.Element;
-
-type SimpleModelViewerProps = {
-    modelUrl: string;
-    /** Explicit format for extensionless or signed model URLs. */
-    modelFormat?: ModelFormat;
-    /** Directory containing the DRACO decoder files, or false. */
-    dracoDecoderPath?: string | false;
-    /** Directory containing the Basis/KTX2 transcoder files, or false. */
-    ktx2TranscoderPath?: string | false;
-    /** Enable the bundled Meshopt decoder. Defaults to true. */
-    meshopt?: boolean;
-    backgroundColor?: string;
-    showSceneObjectsPanel?: boolean;
-    showSceneSettingsPanel?: boolean;
-    enableModelUpload?: boolean;
-    zoomOnSelected?: boolean;
-    highlightOnHover?: boolean;
-    showLoadingOverlay?: boolean;
-    refitOnResize?: boolean;
-    backgroundEnabled?: boolean;
-    autoRotate?: boolean;
-    envPreset?: PresetsType;
-    exposure?: number;
-    ambientIntensity?: number;
-    ambientColor?: string;
-    directionalIntensity?: number;
-    directionalColor?: string;
-    onModelLoaded?: (scene: Object3D) => void;
-    onLoadError?: (error: unknown) => void;
-};
-declare function SimpleModelViewer({ modelUrl, modelFormat, dracoDecoderPath, ktx2TranscoderPath, meshopt, backgroundColor, showSceneObjectsPanel, showSceneSettingsPanel, enableModelUpload, zoomOnSelected, highlightOnHover, showLoadingOverlay, refitOnResize, backgroundEnabled, autoRotate, envPreset, exposure, ambientIntensity, ambientColor, directionalIntensity, directionalColor, onModelLoaded, onLoadError, }: SimpleModelViewerProps): react_jsx_runtime.JSX.Element;
-
-type ViewerSelectionProps = {
-    selectedObjectBinding: ObjectBinding | null;
-    setSelectedObjectBinding: (binding: ObjectBinding | null) => void;
-    handleObjectSelect: (binding: ObjectBinding | null) => void;
-    clearSelection: () => void;
-};
-declare function useViewerSelection(initialSelectedObjectBinding?: ObjectBinding | null): ViewerSelectionProps;
-
-declare function useObjectBinding(objectBindings: Record<string, ObjectBinding>, objectId: string | null | undefined): ObjectBinding | null;
-
-declare function useObjectBindingIds(objectBindings: Record<string, ObjectBinding>): string[];
+declare function PublicModelViewer(props: ModelViewerProps): react.JSX.Element;
 
 type HiddenObjectsState = Record<string, boolean>;
 type ObjectBindingsController = {
@@ -103,7 +57,6 @@ type SceneConfigController = {
     resetSceneConfig: () => void;
     lights: SceneLightsController;
 };
-type SceneLightInput = Pick<SceneLight, "id"> & Partial<Omit<SceneLight, "id">>;
 type SceneLightPatch = Partial<Omit<SceneLight, "id">>;
 type SceneLightsController = {
     items: SceneLight[];
@@ -125,30 +78,6 @@ type SceneLightsController = {
  */
 declare function useSceneConfig(initialSceneConfig: SceneConfig | (() => SceneConfig)): SceneConfigController;
 
-type ViewerHoverProps = {
-    hoveredObjectBinding: ObjectBinding | null;
-    handleHoveredObject: (binding: ObjectBinding | null) => void;
-};
-declare function useViewerHover(): ViewerHoverProps;
-
-type ViewerModelBounds = {
-    min: [number, number, number];
-    max: [number, number, number];
-    center: [number, number, number];
-    size: [number, number, number];
-};
-type ViewerModelProps = {
-    isLoading: boolean;
-    isReady: boolean;
-    error: unknown;
-    bounds: ViewerModelBounds | null;
-    objectCount: number;
-    handleModelLoaded: (scene: Object3D) => void;
-    handleLoadError: (error: unknown) => void;
-    resetModelState: () => void;
-};
-declare function useViewerModel(): ViewerModelProps;
-
 type ViewerActionBindingsController = Pick<ObjectBindingsController, "objectBindings" | "updateObjectBindings" | "showObject" | "hideObject" | "toggleObjectVisibility">;
 type ViewerActionSceneController = Pick<SceneConfigController, "updateSceneConfig">;
 type ViewerActionCameraController = Pick<ViewerCameraProps, "focusObject" | "fitScene" | "resetView" | "setCameraTarget" | "setCameraState">;
@@ -314,6 +243,95 @@ type ViewerEffectsController = {
  */
 declare function useViewerEffects(options?: UseViewerEffectsOptions): ViewerEffectsController;
 
+type ViewerHoverProps = {
+    hoveredObjectBinding: ObjectBinding | null;
+    handleHoveredObject: (binding: ObjectBinding | null) => void;
+};
+declare function useViewerHover(): ViewerHoverProps;
+
+type ViewerModelProps = {
+    isLoading: boolean;
+    isReady: boolean;
+    error: unknown;
+    bounds: ViewerModelBounds | null;
+    objectCount: number;
+    /**
+     * Every bindable object in the model (see `ViewerObjectInfo`). Filled by
+     * `handleObjectCatalog`, so pass that to `ModelViewer`'s `onObjectCatalog`.
+     */
+    objects: ViewerObjectInfo[];
+    handleModelLoaded: (model: ViewerModelInfo) => void;
+    handleObjectCatalog: (objects: ViewerObjectInfo[]) => void;
+    handleLoadError: (error: unknown) => void;
+    resetModelState: () => void;
+};
+declare function useViewerModel(): ViewerModelProps;
+
+type ViewerSelectionProps = {
+    selectedObjectBinding: ObjectBinding | null;
+    setSelectedObjectBinding: (binding: ObjectBinding | null) => void;
+    handleObjectSelect: (binding: ObjectBinding | null) => void;
+    clearSelection: () => void;
+};
+declare function useViewerSelection(initialSelectedObjectBinding?: ObjectBinding | null): ViewerSelectionProps;
+
+type UseViewerOptions = {
+    /**
+     * The starting bindings. Defaults to `"auto"`: a binding for every mesh,
+     * generated when the model loads.
+     */
+    bindings?: Record<string, ObjectBinding> | (() => Record<string, ObjectBinding>) | "auto";
+    /** The starting scene config (lighting, environment, post-processing, ...). */
+    sceneConfig?: SceneConfig | (() => SceneConfig);
+    /** Initial camera position, target and named presets. */
+    camera?: UseViewerCameraOptions;
+    /** Called for every action button, after built-in behavior and effects. */
+    onAction?: (event: ObjectActionEvent) => void | Promise<void>;
+    onObjectSelect?: (binding: ObjectBinding | null) => void;
+    onObjectHover?: (binding: ObjectBinding | null) => void;
+    onLoadError?: (error: unknown) => void;
+};
+/** The ModelViewer props that connect it to `useViewer`; spread them onto it. */
+type UseViewerProps = Required<Pick<ModelViewerProps, "onObjectBindingsChange" | "selectedObject" | "onObjectSelect" | "onObjectHover" | "onCameraChange" | "onViewerReady" | "onModelLoaded" | "onLoadError" | "onObjectCatalog" | "onAnimationsReady" | "onAction">> & {
+    objectBindings: Record<string, ObjectBinding>;
+    sceneConfig?: SceneConfig;
+    onSceneConfigChange: (config: SceneConfig) => void;
+};
+type UseViewerResult = {
+    /** Spread onto ModelViewer: `<ModelViewer {...viewer.props} />`. */
+    props: UseViewerProps;
+    bindings: ObjectBindingsController;
+    selection: ViewerSelectionProps;
+    hover: ViewerHoverProps;
+    camera: ViewerCameraProps;
+    model: ViewerModelProps;
+    animations: ViewerAnimationsProps;
+    actions: ViewerActionsProps;
+    scene: SceneConfigController;
+    effects: ViewerEffectsController;
+    /** The live viewer, image capture and redraw requests. */
+    connection: ViewerConnectionController;
+};
+/**
+ * All of the viewer hooks in one, already connected to each other and to
+ * ModelViewer:
+ *
+ * ```tsx
+ * const viewer = useViewer();
+ * <ModelViewer modelUrl="/car.glb" licenseKey={key} {...viewer.props} />;
+ * viewer.bindings.setBaseColor({ group: "paint" }, "#b91c1c");
+ * ```
+ *
+ * Each part is the result of the hook it's named after (`viewer.camera` is
+ * `useViewerCamera()`'s result, and so on), so everything those hooks offer is
+ * available here too.
+ */
+declare function useViewer(options?: UseViewerOptions): UseViewerResult;
+
+declare function useObjectBinding(objectBindings: Record<string, ObjectBinding>, objectId: string | null | undefined): ObjectBinding | null;
+
+declare function useObjectBindingIds(objectBindings: Record<string, ObjectBinding>): string[];
+
 type UseShareableViewerStateOptions = {
     cameraState: ViewerCameraState | null;
     setCameraState: (state: ViewerCameraState, enableTransition?: boolean) => Promise<boolean>;
@@ -332,4 +350,10 @@ type ShareableViewerStateProps = {
 };
 declare function useShareableViewerState({ cameraState, setCameraState, objectBindings, onObjectBindingsChange, selectedObjectBinding, setSelectedObjectBinding, paramKey, debounceMs, autoSync, }: UseShareableViewerStateOptions): ShareableViewerStateProps;
 
-export { BindingBuilder, BindingBuilderProps, BindingEdit, CaptureImageOptions, type HiddenObjectsState, ModelFormat, ModelViewer, ModelViewerProps, ObjectActionEvent, ObjectBinding, ObjectBindingAction, ObjectBindingMaterial, ObjectBindingPatch, ObjectBindingTarget, ObjectBindingTextureChannel, ObjectBindingTextureSlot, ObjectBindingTransform, type ObjectBindingsController, type RuntimeMaterialPatch, type RuntimeMaterialRanges, type RuntimePointLightOptions, type RuntimePointLightPatch, type RuntimeTransformPatch, type RuntimeTransformRanges, SceneConfig, type SceneConfigController, SceneConfigPatch, type SceneConfigUpdate, SceneLight, SceneLightAttachment, type SceneLightInput, type SceneLightPatch, type SceneLightsController, SimpleModelViewer, type SimpleModelViewerProps, type UseViewerEffectsOptions, type ViewerActionAnimationController, type ViewerActionBindingsController, type ViewerActionCameraController, type ViewerActionSceneController, type ViewerActionsOptions, type ViewerActionsProps, ViewerAnimationsProps, ViewerCameraProps, ViewerCameraState, type ViewerConnectionController, type ViewerEffectChannels, type ViewerEffectEasing, type ViewerEffectRange, type ViewerEffectTarget, type ViewerEffectsController, type ViewerFlickerOptions, type ViewerLightEffectChannel, type ViewerMaterialEffectChannel, type ViewerModelBounds, type ViewerModelProps, type ViewerPulseOptions, type ViewerReadyConsumer, type ViewerReadyHandler, ViewerReadyState, type ViewerSelectionProps, type ViewerTimelineOptions, type ViewerTimelineStep, type ViewerTransformEffectChannel, type ViewerTransitionOptions, type ViewerVector3, useObjectBinding, useObjectBindingIds, useObjectBindings, useSceneConfig, useShareableViewerState, useViewerActions, useViewerConnection, useViewerEffects, useViewerHover, useViewerModel, useViewerSelection };
+/**
+ * One entry of the object catalog the processor writes beside `tileset.json`.
+ * @deprecated Use `ViewerObjectInfo`, which every model now reports.
+ */
+type TileObjectCatalogEntry = ViewerObjectInfo;
+
+export { BindingEdit, CaptureImageOptions, type HiddenObjectsState, PublicModelViewer as ModelViewer, ModelViewerProps, ObjectActionEvent, ObjectBinding, ObjectBindingAction, ObjectBindingMaterial, ObjectBindingPatch, ObjectBindingTarget, ObjectBindingTextureChannel, ObjectBindingTextureSlot, ObjectBindingTransform, type ObjectBindingsController, type RuntimeMaterialPatch, type RuntimeMaterialRanges, type RuntimePointLightOptions, type RuntimePointLightPatch, type RuntimeTransformPatch, type RuntimeTransformRanges, SceneConfig, type SceneConfigController, SceneConfigPatch, type SceneConfigUpdate, SceneLight, SceneLightAttachment, SceneLightInput, type SceneLightPatch, type SceneLightsController, type ShareableViewerStateProps, type TileObjectCatalogEntry, type UseShareableViewerStateOptions, UseViewerCameraOptions, type UseViewerEffectsOptions, type UseViewerOptions, type UseViewerProps, type UseViewerResult, type ViewerActionAnimationController, type ViewerActionBindingsController, type ViewerActionCameraController, type ViewerActionSceneController, type ViewerActionsOptions, type ViewerActionsProps, ViewerAnimationsProps, ViewerCameraProps, ViewerCameraState, type ViewerConnectionController, type ViewerEffectChannels, type ViewerEffectEasing, type ViewerEffectRange, type ViewerEffectTarget, type ViewerEffectsController, type ViewerFlickerOptions, type ViewerHoverProps, type ViewerLightEffectChannel, type ViewerMaterialEffectChannel, ViewerModelBounds, ViewerModelInfo, type ViewerModelProps, ViewerObjectInfo, type ViewerPulseOptions, type ViewerReadyConsumer, type ViewerReadyHandler, ViewerReadyState, type ViewerSelectionProps, type ViewerTimelineOptions, type ViewerTimelineStep, type ViewerTransformEffectChannel, type ViewerTransitionOptions, type ViewerVector3, useObjectBinding, useObjectBindingIds, useObjectBindings, useSceneConfig, useShareableViewerState, useViewer, useViewerActions, useViewerConnection, useViewerEffects, useViewerHover, useViewerModel, useViewerSelection };

package/dist/index.d.ts

@@ -1,62 +1,16 @@
-import * as react_jsx_runtime from 'react/jsx-runtime';
-import { g as ModelViewerProps, B as BindingBuilderProps, M as ModelFormat, V as ViewerAnimationsProps, i as ViewerCameraProps, j as ViewerReadyState, C as CaptureImageOptions } from './publicProps-Bv3_PCP0.js';
-export { A as AnimationClipInfo, a as AnimationControls, b as AnimationPlaybackState, c as CinematicConfig, d as CinematicWaypoint, e as CustomObjectBindingDataPanelProps, f as CustomSceneObjectsPanelProps, H as HomeCameraState, O as ObjectTransformSpace, S as StreamingTilesModelProps, T as TileObjectCatalogEntry, U as UseViewerCameraOptions, h as ViewerCameraPreset, X as XRScaleMode, u as useViewerAnimations, k as useViewerCamera } from './publicProps-Bv3_PCP0.js';
-import { Object3D } from 'three';
-import { PresetsType } from '@react-three/drei/helpers/environment-assets';
-import { f as ObjectBinding, m as ObjectBindingTarget, k as ObjectBindingPatch, B as BindingEdit, h as ObjectBindingMaterial, o as ObjectBindingTextureSlot, n as ObjectBindingTextureChannel, p as ObjectBindingTransform, v as SceneConfig, x as SceneConfigPatch, y as SceneLight, z as SceneLightAttachment, e as ObjectActionEvent, g as ObjectBindingAction, V as ViewerCameraState } from './objectBinding-CBRYMYk6.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, i as ObjectBindingMaterialBlendingMode, j as ObjectBindingMaterialSide, l as ObjectBindingSelector, q as ObjectBindingsActionEffect, S as SceneAnimationClipConfig, r as SceneAnimationConfig, t as SceneCinematicConfig, u as SceneCinematicWaypoint, w as SceneConfigActionEffect, E as SceneLightType, F as SceneModelRenderer, G as VisibilityActionEffect, H as material, I as patchBindings, J as patchSceneConfig, K as selectBindingKeys, L as selectBindings } from './objectBinding-CBRYMYk6.js';
-export { ObjectBindingActionId, ObjectBindingKey, defineObjectBindings } from './utils.js';
-import 'react';
+import * as react from 'react';
+import { n as ModelViewerProps, V as ViewerAnimationsProps, u as ViewerCameraProps, v as ViewerReadyState, e as CaptureImageOptions, U as UseViewerCameraOptions } from './ModelViewer-DOexHkJC.js';
+export { A as AnimationClipInfo, a as AnimationControls, b as AnimationPlaybackState, c as AnnotationMarker, C as CameraControllerType, d as CameraLimits, f as CinematicConfig, g as CinematicWaypoint, h as CustomObjectBindingDataPanelProps, i as CustomSceneObjectsPanelProps, G as GroupedModelViewerProps, H as HomeCameraState, M as MODEL_VIEWER_PRESETS, j as ModelViewerControlsOptions, k as ModelViewerDecoderOptions, l as ModelViewerPerfOptions, m as ModelViewerPreset, o as ModelViewerTilesOptions, p as ModelViewerToolsOptions, q as ModelViewerUiOptions, r as ModelViewerXrOptions, s as MouseControllerPosition, O as ObjectTransformSpace, P as PerformanceProfile, T as TexturePositioningControls, t as ViewerCameraPreset, X as XRScaleMode, w as useViewerAnimations, x as useViewerCamera } from './ModelViewer-DOexHkJC.js';
+import { g as ObjectBinding, q as ObjectBindingTarget, m as ObjectBindingPatch, B as BindingEdit, j as ObjectBindingMaterial, s as ObjectBindingTextureSlot, r as ObjectBindingTextureChannel, t as ObjectBindingTransform, J as SceneConfig, N as SceneConfigPatch, T as SceneLight, U as SceneLightAttachment, h as ObjectBindingAction, f as ObjectActionEvent, a2 as ViewerObjectInfo, a1 as ViewerCameraState } from './objectCatalog-5W8n5xNQ.js';
+export { A as AnimationAction, a as AnimationActionEffect, b as AnimationLoopMode, C as CameraAction, c as CameraActionEffect, D as DEFAULT_SCENE_CONFIG, d as DeepPartial, E as EnvironmentPreset, G as GlitchModeName, K as KernelSizeName, M as MATERIAL_BLENDING_MODES, e as MATERIAL_SIDES, O as ObjectActionEffect, i as ObjectBindingCameraState, k as ObjectBindingMaterialBlendingMode, l as ObjectBindingMaterialSide, n as ObjectBindingSelector, o as ObjectBindingStatus, p as ObjectBindingStyle, u as ObjectBindingType, v as ObjectBindingsActionEffect, w as ObjectPointerEvent, R as RampTypeName, S as SceneAnimationClipConfig, x as SceneAnimationConfig, y as SceneAnnotationMarker, z as SceneBackgroundConfig, F as SceneCameraConfig, H as SceneCinematicConfig, I as SceneCinematicWaypoint, L as SceneConfigActionEffect, P as SceneEnvironmentConfig, Q as SceneGroundShadowConfig, V as SceneLightType, W as SceneLightingConfig, X as SceneModelConfig, Y as SceneModelRenderer, Z as ScenePostProcessingConfig, _ as SceneShadowConfig, $ as SceneWireframeConfig, a0 as ViewerCameraConfig, a3 as VisibilityActionEffect, a4 as material, a5 as patchBindings, a6 as patchSceneConfig, a7 as selectBindingKeys, a8 as selectBindings } from './objectCatalog-5W8n5xNQ.js';
+import { SceneLightInput } from './utils.js';
+export { ACTION_CATALOG, ActionCatalogEntry, ActionHandling, ObjectBindingActionId, ObjectBindingKey, buildBindingsFromNodes, createDefaultBinding, defineObjectBindings, findCatalogAction, inferType, sceneLight } from './utils.js';
+import { V as ViewerModelBounds, a as ViewerModelInfo } from './modelInfo-CEmmvVCH.js';
+export { M as ModelFormat } from './modelInfo-CEmmvVCH.js';
 import '@react-three/drei';
-import '@react-three/xr';
-import '@react-three/fiber';
+import 'three';
 
-declare function ModelViewer(props: ModelViewerProps): react_jsx_runtime.JSX.Element;
-
-declare function BindingBuilder(props: BindingBuilderProps): react_jsx_runtime.JSX.Element;
-
-type SimpleModelViewerProps = {
-    modelUrl: string;
-    /** Explicit format for extensionless or signed model URLs. */
-    modelFormat?: ModelFormat;
-    /** Directory containing the DRACO decoder files, or false. */
-    dracoDecoderPath?: string | false;
-    /** Directory containing the Basis/KTX2 transcoder files, or false. */
-    ktx2TranscoderPath?: string | false;
-    /** Enable the bundled Meshopt decoder. Defaults to true. */
-    meshopt?: boolean;
-    backgroundColor?: string;
-    showSceneObjectsPanel?: boolean;
-    showSceneSettingsPanel?: boolean;
-    enableModelUpload?: boolean;
-    zoomOnSelected?: boolean;
-    highlightOnHover?: boolean;
-    showLoadingOverlay?: boolean;
-    refitOnResize?: boolean;
-    backgroundEnabled?: boolean;
-    autoRotate?: boolean;
-    envPreset?: PresetsType;
-    exposure?: number;
-    ambientIntensity?: number;
-    ambientColor?: string;
-    directionalIntensity?: number;
-    directionalColor?: string;
-    onModelLoaded?: (scene: Object3D) => void;
-    onLoadError?: (error: unknown) => void;
-};
-declare function SimpleModelViewer({ modelUrl, modelFormat, dracoDecoderPath, ktx2TranscoderPath, meshopt, backgroundColor, showSceneObjectsPanel, showSceneSettingsPanel, enableModelUpload, zoomOnSelected, highlightOnHover, showLoadingOverlay, refitOnResize, backgroundEnabled, autoRotate, envPreset, exposure, ambientIntensity, ambientColor, directionalIntensity, directionalColor, onModelLoaded, onLoadError, }: SimpleModelViewerProps): react_jsx_runtime.JSX.Element;
-
-type ViewerSelectionProps = {
-    selectedObjectBinding: ObjectBinding | null;
-    setSelectedObjectBinding: (binding: ObjectBinding | null) => void;
-    handleObjectSelect: (binding: ObjectBinding | null) => void;
-    clearSelection: () => void;
-};
-declare function useViewerSelection(initialSelectedObjectBinding?: ObjectBinding | null): ViewerSelectionProps;
-
-declare function useObjectBinding(objectBindings: Record<string, ObjectBinding>, objectId: string | null | undefined): ObjectBinding | null;
-
-declare function useObjectBindingIds(objectBindings: Record<string, ObjectBinding>): string[];
+declare function PublicModelViewer(props: ModelViewerProps): react.JSX.Element;
 
 type HiddenObjectsState = Record<string, boolean>;
 type ObjectBindingsController = {
@@ -103,7 +57,6 @@ type SceneConfigController = {
     resetSceneConfig: () => void;
     lights: SceneLightsController;
 };
-type SceneLightInput = Pick<SceneLight, "id"> & Partial<Omit<SceneLight, "id">>;
 type SceneLightPatch = Partial<Omit<SceneLight, "id">>;
 type SceneLightsController = {
     items: SceneLight[];
@@ -125,30 +78,6 @@ type SceneLightsController = {
  */
 declare function useSceneConfig(initialSceneConfig: SceneConfig | (() => SceneConfig)): SceneConfigController;
 
-type ViewerHoverProps = {
-    hoveredObjectBinding: ObjectBinding | null;
-    handleHoveredObject: (binding: ObjectBinding | null) => void;
-};
-declare function useViewerHover(): ViewerHoverProps;
-
-type ViewerModelBounds = {
-    min: [number, number, number];
-    max: [number, number, number];
-    center: [number, number, number];
-    size: [number, number, number];
-};
-type ViewerModelProps = {
-    isLoading: boolean;
-    isReady: boolean;
-    error: unknown;
-    bounds: ViewerModelBounds | null;
-    objectCount: number;
-    handleModelLoaded: (scene: Object3D) => void;
-    handleLoadError: (error: unknown) => void;
-    resetModelState: () => void;
-};
-declare function useViewerModel(): ViewerModelProps;
-
 type ViewerActionBindingsController = Pick<ObjectBindingsController, "objectBindings" | "updateObjectBindings" | "showObject" | "hideObject" | "toggleObjectVisibility">;
 type ViewerActionSceneController = Pick<SceneConfigController, "updateSceneConfig">;
 type ViewerActionCameraController = Pick<ViewerCameraProps, "focusObject" | "fitScene" | "resetView" | "setCameraTarget" | "setCameraState">;
@@ -314,6 +243,95 @@ type ViewerEffectsController = {
  */
 declare function useViewerEffects(options?: UseViewerEffectsOptions): ViewerEffectsController;
 
+type ViewerHoverProps = {
+    hoveredObjectBinding: ObjectBinding | null;
+    handleHoveredObject: (binding: ObjectBinding | null) => void;
+};
+declare function useViewerHover(): ViewerHoverProps;
+
+type ViewerModelProps = {
+    isLoading: boolean;
+    isReady: boolean;
+    error: unknown;
+    bounds: ViewerModelBounds | null;
+    objectCount: number;
+    /**
+     * Every bindable object in the model (see `ViewerObjectInfo`). Filled by
+     * `handleObjectCatalog`, so pass that to `ModelViewer`'s `onObjectCatalog`.
+     */
+    objects: ViewerObjectInfo[];
+    handleModelLoaded: (model: ViewerModelInfo) => void;
+    handleObjectCatalog: (objects: ViewerObjectInfo[]) => void;
+    handleLoadError: (error: unknown) => void;
+    resetModelState: () => void;
+};
+declare function useViewerModel(): ViewerModelProps;
+
+type ViewerSelectionProps = {
+    selectedObjectBinding: ObjectBinding | null;
+    setSelectedObjectBinding: (binding: ObjectBinding | null) => void;
+    handleObjectSelect: (binding: ObjectBinding | null) => void;
+    clearSelection: () => void;
+};
+declare function useViewerSelection(initialSelectedObjectBinding?: ObjectBinding | null): ViewerSelectionProps;
+
+type UseViewerOptions = {
+    /**
+     * The starting bindings. Defaults to `"auto"`: a binding for every mesh,
+     * generated when the model loads.
+     */
+    bindings?: Record<string, ObjectBinding> | (() => Record<string, ObjectBinding>) | "auto";
+    /** The starting scene config (lighting, environment, post-processing, ...). */
+    sceneConfig?: SceneConfig | (() => SceneConfig);
+    /** Initial camera position, target and named presets. */
+    camera?: UseViewerCameraOptions;
+    /** Called for every action button, after built-in behavior and effects. */
+    onAction?: (event: ObjectActionEvent) => void | Promise<void>;
+    onObjectSelect?: (binding: ObjectBinding | null) => void;
+    onObjectHover?: (binding: ObjectBinding | null) => void;
+    onLoadError?: (error: unknown) => void;
+};
+/** The ModelViewer props that connect it to `useViewer`; spread them onto it. */
+type UseViewerProps = Required<Pick<ModelViewerProps, "onObjectBindingsChange" | "selectedObject" | "onObjectSelect" | "onObjectHover" | "onCameraChange" | "onViewerReady" | "onModelLoaded" | "onLoadError" | "onObjectCatalog" | "onAnimationsReady" | "onAction">> & {
+    objectBindings: Record<string, ObjectBinding>;
+    sceneConfig?: SceneConfig;
+    onSceneConfigChange: (config: SceneConfig) => void;
+};
+type UseViewerResult = {
+    /** Spread onto ModelViewer: `<ModelViewer {...viewer.props} />`. */
+    props: UseViewerProps;
+    bindings: ObjectBindingsController;
+    selection: ViewerSelectionProps;
+    hover: ViewerHoverProps;
+    camera: ViewerCameraProps;
+    model: ViewerModelProps;
+    animations: ViewerAnimationsProps;
+    actions: ViewerActionsProps;
+    scene: SceneConfigController;
+    effects: ViewerEffectsController;
+    /** The live viewer, image capture and redraw requests. */
+    connection: ViewerConnectionController;
+};
+/**
+ * All of the viewer hooks in one, already connected to each other and to
+ * ModelViewer:
+ *
+ * ```tsx
+ * const viewer = useViewer();
+ * <ModelViewer modelUrl="/car.glb" licenseKey={key} {...viewer.props} />;
+ * viewer.bindings.setBaseColor({ group: "paint" }, "#b91c1c");
+ * ```
+ *
+ * Each part is the result of the hook it's named after (`viewer.camera` is
+ * `useViewerCamera()`'s result, and so on), so everything those hooks offer is
+ * available here too.
+ */
+declare function useViewer(options?: UseViewerOptions): UseViewerResult;
+
+declare function useObjectBinding(objectBindings: Record<string, ObjectBinding>, objectId: string | null | undefined): ObjectBinding | null;
+
+declare function useObjectBindingIds(objectBindings: Record<string, ObjectBinding>): string[];
+
 type UseShareableViewerStateOptions = {
     cameraState: ViewerCameraState | null;
     setCameraState: (state: ViewerCameraState, enableTransition?: boolean) => Promise<boolean>;
@@ -332,4 +350,10 @@ type ShareableViewerStateProps = {
 };
 declare function useShareableViewerState({ cameraState, setCameraState, objectBindings, onObjectBindingsChange, selectedObjectBinding, setSelectedObjectBinding, paramKey, debounceMs, autoSync, }: UseShareableViewerStateOptions): ShareableViewerStateProps;
 
-export { BindingBuilder, BindingBuilderProps, BindingEdit, CaptureImageOptions, type HiddenObjectsState, ModelFormat, ModelViewer, ModelViewerProps, ObjectActionEvent, ObjectBinding, ObjectBindingAction, ObjectBindingMaterial, ObjectBindingPatch, ObjectBindingTarget, ObjectBindingTextureChannel, ObjectBindingTextureSlot, ObjectBindingTransform, type ObjectBindingsController, type RuntimeMaterialPatch, type RuntimeMaterialRanges, type RuntimePointLightOptions, type RuntimePointLightPatch, type RuntimeTransformPatch, type RuntimeTransformRanges, SceneConfig, type SceneConfigController, SceneConfigPatch, type SceneConfigUpdate, SceneLight, SceneLightAttachment, type SceneLightInput, type SceneLightPatch, type SceneLightsController, SimpleModelViewer, type SimpleModelViewerProps, type UseViewerEffectsOptions, type ViewerActionAnimationController, type ViewerActionBindingsController, type ViewerActionCameraController, type ViewerActionSceneController, type ViewerActionsOptions, type ViewerActionsProps, ViewerAnimationsProps, ViewerCameraProps, ViewerCameraState, type ViewerConnectionController, type ViewerEffectChannels, type ViewerEffectEasing, type ViewerEffectRange, type ViewerEffectTarget, type ViewerEffectsController, type ViewerFlickerOptions, type ViewerLightEffectChannel, type ViewerMaterialEffectChannel, type ViewerModelBounds, type ViewerModelProps, type ViewerPulseOptions, type ViewerReadyConsumer, type ViewerReadyHandler, ViewerReadyState, type ViewerSelectionProps, type ViewerTimelineOptions, type ViewerTimelineStep, type ViewerTransformEffectChannel, type ViewerTransitionOptions, type ViewerVector3, useObjectBinding, useObjectBindingIds, useObjectBindings, useSceneConfig, useShareableViewerState, useViewerActions, useViewerConnection, useViewerEffects, useViewerHover, useViewerModel, useViewerSelection };
+/**
+ * One entry of the object catalog the processor writes beside `tileset.json`.
+ * @deprecated Use `ViewerObjectInfo`, which every model now reports.
+ */
+type TileObjectCatalogEntry = ViewerObjectInfo;
+
+export { BindingEdit, CaptureImageOptions, type HiddenObjectsState, PublicModelViewer as ModelViewer, ModelViewerProps, ObjectActionEvent, ObjectBinding, ObjectBindingAction, ObjectBindingMaterial, ObjectBindingPatch, ObjectBindingTarget, ObjectBindingTextureChannel, ObjectBindingTextureSlot, ObjectBindingTransform, type ObjectBindingsController, type RuntimeMaterialPatch, type RuntimeMaterialRanges, type RuntimePointLightOptions, type RuntimePointLightPatch, type RuntimeTransformPatch, type RuntimeTransformRanges, SceneConfig, type SceneConfigController, SceneConfigPatch, type SceneConfigUpdate, SceneLight, SceneLightAttachment, SceneLightInput, type SceneLightPatch, type SceneLightsController, type ShareableViewerStateProps, type TileObjectCatalogEntry, type UseShareableViewerStateOptions, UseViewerCameraOptions, type UseViewerEffectsOptions, type UseViewerOptions, type UseViewerProps, type UseViewerResult, type ViewerActionAnimationController, type ViewerActionBindingsController, type ViewerActionCameraController, type ViewerActionSceneController, type ViewerActionsOptions, type ViewerActionsProps, ViewerAnimationsProps, ViewerCameraProps, ViewerCameraState, type ViewerConnectionController, type ViewerEffectChannels, type ViewerEffectEasing, type ViewerEffectRange, type ViewerEffectTarget, type ViewerEffectsController, type ViewerFlickerOptions, type ViewerHoverProps, type ViewerLightEffectChannel, type ViewerMaterialEffectChannel, ViewerModelBounds, ViewerModelInfo, type ViewerModelProps, ViewerObjectInfo, type ViewerPulseOptions, type ViewerReadyConsumer, type ViewerReadyHandler, ViewerReadyState, type ViewerSelectionProps, type ViewerTimelineOptions, type ViewerTimelineStep, type ViewerTransformEffectChannel, type ViewerTransitionOptions, type ViewerVector3, useObjectBinding, useObjectBindingIds, useObjectBindings, useSceneConfig, useShareableViewerState, useViewer, useViewerActions, useViewerConnection, useViewerEffects, useViewerHover, useViewerModel, useViewerSelection };