@liveroom-tech/react-immersive 6.2.0 → 6.2.1

package/dist/modelViewerProps-Ch6pIZIE.d.ts

@@ -1,2159 +0,0 @@
-import { Object3D, Material } from 'three';
-import { e as ViewerModelBounds, R as ReducedMotionSetting, C as CameraLimits, d as ModelViewerLabels, V as ViewerLoading, g as ViewerReveal, b as ModelFormat, f as ViewerModelInfo } from './modelFileResolver-ChKYsF21.js';
-import { ReactNode } from 'react';
-import { CameraControls } from '@react-three/drei';
-
-type ViewerCameraState = {
-    position: [number, number, number];
-    target: [number, number, number];
-    fov: number | null;
-    zoom: number;
-    /**
-     * The camera's orbit angles, in radians, captured so setCameraState can
-     * restore the exact rotation (position and target alone are ambiguous
-     * straight above or below the target). Pass the state back as-is; to move
-     * the camera to angles you choose, use orbitTo, which takes degrees.
-     */
-    azimuthAngle?: number;
-    polarAngle?: number;
-};
-/** Where ModelViewer's camera starts. Setting it skips the automatic fit. */
-type ViewerCameraConfig = {
-    position?: [number, number, number];
-    /** Vertical field of view in degrees. */
-    fov?: number;
-    near?: number;
-    far?: number;
-    zoom?: number;
-};
-
-type DeepPartial<T> = T extends readonly unknown[] ? T : T extends object ? {
-    [K in keyof T]?: DeepPartial<T[K]>;
-} : T;
-
-type ObjectBindingSelector = {
-    group: string;
-} | {
-    tag: string;
-} | {
-    type: ObjectBindingType;
-};
-type ObjectBindingTarget = string | readonly string[] | ObjectBindingSelector;
-/**
- * Resolves IDs and selectors to binding-map keys in stable record order.
- * Explicit ID arrays keep their supplied order. Duplicate matches are removed.
- */
-declare function selectBindingKeys(bindings: Record<string, ObjectBinding>, target: ObjectBindingTarget): string[];
-/** Selects bindings by ID, group, tag, or binding type. */
-declare function selectBindings(bindings: Record<string, ObjectBinding>, target: ObjectBindingTarget): ObjectBinding[];
-
-type ObjectBindingPatch = DeepPartial<ObjectBinding>;
-type BindingEdit = {
-    ids: ObjectBindingTarget;
-    patch: ObjectBindingPatch;
-};
-/**
- * Applies field-level patches to object bindings and returns the updated
- * record. Pure — nothing is mutated, and the original reference comes back
- * untouched when no id matched, so React can skip the re-render.
- *
- * Ids resolve the same way everywhere else in the library: binding key first,
- * then `binding.id`, then `binding.modelObjectId`.
- */
-declare function patchBindings(bindings: Record<string, ObjectBinding>, target: ObjectBindingTarget, patch: ObjectBindingPatch): Record<string, ObjectBinding>;
-declare function patchBindings(bindings: Record<string, ObjectBinding>, edits: BindingEdit[]): Record<string, ObjectBinding>;
-/** Shorthand for the common `{ style: { material: … } }` nesting. */
-declare function material(value: ObjectBindingMaterial): ObjectBindingPatch;
-
-type SequenceVector3 = [number, number, number];
-type SequenceEasing = "linear" | "ease-in" | "ease-out" | "ease-in-out" | "step";
-type SequenceCameraView = {
-    position: SequenceVector3;
-    target: SequenceVector3;
-    fov: number | null;
-    zoom: number;
-};
-type SequenceValue = number | boolean | string | SequenceVector3 | SequenceCameraView;
-type SequenceKeyframe = {
-    id: string;
-    /** Seconds on the sequence timeline. */
-    time: number;
-    value: SequenceValue;
-    /** Interpolation from this keyframe to the next. Default ease-in-out. */
-    easing?: SequenceEasing;
-};
-type SequenceObjectProperty = "position" | "rotation" | "scale" | "visible" | "baseColor" | "emissive" | "opacity" | "roughness" | "metalness" | "emissiveIntensity";
-type SequenceTarget = {
-    kind: "object";
-    objectId: string;
-    property: SequenceObjectProperty;
-} | {
-    kind: "camera";
-} | {
-    kind: "clip";
-    clip: string;
-};
-type SequenceTrack = {
-    id: string;
-    name: string;
-    target: SequenceTarget;
-    muted?: boolean;
-    keyframes: SequenceKeyframe[];
-};
-/** All object/clip ids are scoped to the model that owns this scene config. */
-type SceneSequence = {
-    id: string;
-    name: string;
-    duration: number;
-    loop: boolean;
-    autoPlay: boolean;
-    tracks: SequenceTrack[];
-};
-type SequencePlaybackState = {
-    sequenceId: string | null;
-    time: number;
-    duration: number;
-    status: "stopped" | "playing" | "paused" | "finished";
-    previewing: boolean;
-    ready: boolean;
-    issues: string[];
-};
-type SequenceControls = {
-    /** Stable snapshot for useSyncExternalStore. UI updates are throttled during playback. */
-    getState: () => SequencePlaybackState;
-    subscribe: (listener: () => void) => () => void;
-    select: (sequenceId: string) => boolean;
-    play: (sequenceId?: string) => boolean;
-    pause: () => void;
-    /** Restore the authored object, material, clip and camera state. */
-    stop: () => void;
-    /** Deterministic scrubbing, including backwards, without changing authored bindings. */
-    seek: (time: number) => boolean;
-    /** Read the live value for capture in the authoring UI. */
-    capture: (target: SequenceTarget) => SequenceValue | null;
-};
-
-type MeasurementUnit = "m" | "cm" | "mm" | "in" | "ft";
-type MeasurementTool = "distance" | "angle" | "area" | "pointToPlane" | "wrap" | "wrapHorizontal";
-type MeasurementPosition = [number, number, number];
-type MeasurementSettings = {
-    /** Authored model units. Default metres. Changing this should clear calibration. */
-    sourceUnit?: MeasurementUnit;
-    /** Unit used for lengths and areas. Default metres (or measurementUnit). */
-    displayUnit?: MeasurementUnit;
-    /** Calibration override: metres represented by one model unit. */
-    metersPerUnit?: number;
-};
-type MeasurementAnchor = {
-    nodeId: string;
-    localPosition: MeasurementPosition;
-    localNormal?: MeasurementPosition;
-    localFaceVertices?: MeasurementPosition[];
-    instanceId?: number;
-    /** Deterministic fingerprint of source geometry, independent of rigid transforms. */
-    geometrySignature: string;
-    /** Posed measurements are snapshots; a different pose requires remeasurement. */
-    poseSignature: string;
-};
-type MeasurementPoint = {
-    id: number;
-    position: MeasurementPosition;
-    normal?: MeasurementPosition;
-    faceVertices?: MeasurementPosition[];
-    snapped?: "vertex" | "edge";
-    anchor?: MeasurementAnchor;
-};
-type SavedMeasurement = {
-    id: string;
-    name: string;
-    /** Stable model identity; defaults to the canonical model URL. */
-    modelId: string;
-    tilesetUrl?: string | null;
-    tool: MeasurementTool;
-    points: MeasurementPoint[];
-    createdAt: string;
-    visible?: boolean;
-    /** Streamed geometry may represent a coarser LOD than the source model. */
-    approximate?: boolean;
-};
-/** Stored with sceneConfig, JSON exports, and shareable configurations. */
-type MeasurementCollection = {
-    settings: MeasurementSettings;
-    items: SavedMeasurement[];
-};
-type MeasurementStatus = "ready" | "approximate" | "model-changed" | "missing-object" | "geometry-changed" | "pose-changed" | "hidden-object" | "invalid";
-type MeasurementResult = {
-    id: string;
-    status: MeasurementStatus;
-    rawValue: number | null;
-    value: number | null;
-    unit: string;
-};
-
-type SceneSelectionSet = {
-    id: string;
-    name: string;
-    /** Stable modelObjectId values, scoped to this model. */
-    objectIds: string[];
-};
-/** Validate saved selections from scene JSON, shared state, or browser storage. */
-declare function parseSelectionSets(input: unknown): SceneSelectionSet[];
-
-type ProductSelections = Record<string, string | null>;
-type ProductOptionRef = {
-    groupId: string;
-    optionId: string;
-};
-type ProductAppearance = {
-    target: ObjectBindingTarget;
-    material?: ObjectBindingMaterial;
-    visible?: boolean;
-};
-type ProductOption = {
-    id: string;
-    label: string;
-    sku?: string;
-    /** Shown under the label. */
-    description?: string;
-    /** A hex color, shown as this option's swatch. */
-    swatch?: string;
-    /** Added to the price, in the currency's smallest unit. Can be negative. */
-    priceDeltaMinor?: number;
-    appearance?: ProductAppearance[];
-    variants?: string[];
-};
-/** Single-choice group. Optional groups may have no selected option. */
-type ProductOptionGroup = {
-    id: string;
-    label: string;
-    required?: boolean;
-    defaultOptionId?: string;
-    display?: ProductGroupDisplay;
-    options: ProductOption[];
-};
-type ProductGroupDisplay = "list" | "chips" | "swatches";
-/** A price worked out from the definition, for products without a pricing service. */
-type ProductPricing = {
-    currency: string;
-    basePriceMinor: number;
-};
-/**
- * A link to buy this configuration, with no code. The URL can use {sku},
- * {quantity}, {productId}, {revision} and {selections}.
- */
-type ProductCheckoutLink = {
-    urlTemplate: string;
-    label?: string;
-};
-type ProductOptionRule = {
-    id: string;
-    when: ProductOptionRef;
-    requires?: ProductOptionRef[];
-    excludes?: ProductOptionRef[];
-    message?: string;
-};
-/** Exact combination-to-SKU mapping, including null for unselected optional groups. */
-type ProductSku = {
-    sku: string;
-    selections: ProductSelections;
-};
-type ProductDefinition = {
-    id: string;
-    label: string;
-    revision: string;
-    groups: ProductOptionGroup[];
-    pricing?: ProductPricing;
-    checkout?: ProductCheckoutLink;
-    rules?: ProductOptionRule[];
-    skus?: ProductSku[];
-};
-type SceneProductConfig = {
-    definition: ProductDefinition;
-    selections: ProductSelections;
-};
-type ProductConfigurationIssue = {
-    code: "required" | "unknown-group" | "unknown-option" | "requires" | "excludes" | "sku";
-    message: string;
-    groupIds: string[];
-    ruleId?: string;
-};
-type ProductConfiguration = {
-    version: 1;
-    productId: string;
-    revision: string;
-    /** Canonical JSON identity of product, revision, quantity, and sorted selections. */
-    key: string;
-    quantity: number;
-    selections: ProductSelections;
-    sku: string | null;
-    items: Array<{
-        groupId: string;
-        optionId: string;
-        label: string;
-        sku?: string;
-    }>;
-    valid: boolean;
-    issues: ProductConfigurationIssue[];
-};
-type ProductOptionState = {
-    groupId: string;
-    optionId: string;
-    selected: boolean;
-    available: boolean;
-    reasons: string[];
-    /** For a choice blocked by a rule: the other choices that would have to change to allow it. */
-    fix?: ProductOptionRef[];
-};
-/** Something in a definition that won't work as its author expects. */
-type ProductDefinitionWarning = {
-    code: "missing-sku" | "no-objects" | "missing-variant" | "invalid-default" | "unreachable" | "nothing-changes";
-    message: string;
-    groupId?: string;
-    optionId?: string;
-};
-type ProductAvailability = {
-    available: boolean;
-    message?: string;
-    options?: Array<ProductOptionRef & {
-        available: boolean;
-        reason?: string;
-    }>;
-};
-/** Display-only price supplied by the host's pricing service. */
-type ProductPrice = {
-    amountMinor: number;
-    currency: string;
-    expiresAt?: string;
-    label?: string;
-};
-type ProductCommerceResult = {
-    id?: string;
-    message?: string;
-};
-type ProductCommerceContext = {
-    signal: AbortSignal;
-};
-type ProductCheckoutContext = ProductCommerceContext & {
-    idempotencyKey: string;
-    price: ProductPrice | null;
-};
-/** Implement these methods in your application; validate/reprice again on your server. */
-type ProductCommerceAdapter = {
-    /** Stable backend/pricing-context identity; change when provider, currency, or customer context changes. */
-    key: string;
-    resolveSku?: (configuration: ProductConfiguration, context: ProductCommerceContext) => string | null | Promise<string | null>;
-    getAvailability?: (configuration: ProductConfiguration, context: ProductCommerceContext) => ProductAvailability | Promise<ProductAvailability>;
-    getPrice?: (configuration: ProductConfiguration, context: ProductCommerceContext) => ProductPrice | Promise<ProductPrice>;
-    addToCart?: (configuration: ProductConfiguration, context: ProductCheckoutContext) => ProductCommerceResult | Promise<ProductCommerceResult>;
-    requestQuote?: (configuration: ProductConfiguration, context: ProductCheckoutContext) => ProductCommerceResult | Promise<ProductCommerceResult>;
-};
-
-declare const LIGHT_TYPES: readonly ["none", "directional", "point", "spot", "hemisphere"];
-type SceneLightType = (typeof LIGHT_TYPES)[number];
-type SceneLightAttachment = {
-    /** Binding key, binding id, modelObjectId, or raw model node name. */
-    objectId: string;
-    /** Local-space offset from the attached model object. */
-    offset: [number, number, number];
-};
-type SceneLight = {
-    id: string;
-    type: SceneLightType;
-    color: string;
-    intensity: number;
-    position: [number, number, number];
-    rotation?: [number, number, number];
-    /** Point-light range. Zero means no distance limit. */
-    distance?: number;
-    /** Point-light physically correct decay. */
-    decay?: number;
-    angle?: number;
-    penumbra?: number;
-    /** Spot/directional aim point; unset aims at the origin (model centre with shadows). */
-    target?: [number, number, number];
-    attachedToCamera: boolean;
-    /** Follow a model object instead of using the world-space position. */
-    attachment?: SceneLightAttachment;
-    castShadow: boolean;
-    shadowBias: number;
-    visible: boolean;
-};
-type SceneLightingConfig = {
-    ambient: {
-        intensity: number;
-        color: string;
-    };
-    lights: SceneLight[];
-};
-declare const SCENE_MODEL_RENDERERS: readonly ["pbr", "matcap", "uv-checker"];
-type SceneModelRenderer = (typeof SCENE_MODEL_RENDERERS)[number];
-type SceneModelConfig = {
-    rotation: [number, number, number];
-    showAdvancedRotation: boolean;
-    renderer: SceneModelRenderer;
-    shading: "lit" | "unlit" | "normals";
-    autoRotate?: boolean;
-    autoRotateSpeed?: number;
-    /**
-     * 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.
-     */
-    activeVariants?: string[];
-};
-type SceneCameraConfig = {
-    fieldOfView: number;
-    showAdvancedSettings: boolean;
-};
-type SceneShadowConfig = {
-    enabled: boolean;
-    mapSize: number;
-    bias: number;
-    normalBias: number;
-    radius: number;
-};
-declare const ENVIRONMENT_PRESETS: readonly ["apartment", "city", "dawn", "forest", "lobby", "night", "park", "studio", "sunset", "warehouse"];
-type EnvironmentPreset = (typeof ENVIRONMENT_PRESETS)[number];
-type SceneEnvironmentConfig = {
-    source: "preset" | "custom";
-    preset: EnvironmentPreset;
-    customEnvironmentUrl: string;
-    intensity: number;
-    rotation: number;
-    shadowLight: {
-        enabled: boolean;
-        intensity: number;
-        bias: number;
-    };
-};
-type SceneWireframeConfig = {
-    enabled: boolean;
-    color: string;
-    opacity: number;
-};
-type SceneBackgroundConfig = {
-    enabled: boolean;
-    type: "environment" | "image" | "color";
-    color: string;
-    imageUrl: string;
-};
-type SceneGroundShadowConfig = {
-    enabled: boolean;
-    mode: "shadowCatcher" | "bakedAO";
-    intensity: number;
-    borderFade: number;
-    height: number;
-    size: number;
-};
-declare const ANIMATION_LOOP_MODES: readonly ["repeat", "once", "ping-pong"];
-type AnimationLoopMode = (typeof ANIMATION_LOOP_MODES)[number];
-type SceneAnimationClipConfig = {
-    sourceName: string;
-    displayName: string;
-    hidden: boolean;
-    loopMode: AnimationLoopMode;
-    speed: number;
-};
-type SceneAnimationConfig = {
-    clips: SceneAnimationClipConfig[];
-    autoplayClip: string | null;
-};
-declare const GLITCH_MODES: readonly ["sporadic", "constantMild", "constantWild"];
-type GlitchModeName = (typeof GLITCH_MODES)[number];
-declare const RAMP_TYPES: readonly ["linear", "radial", "mirroredLinear"];
-type RampTypeName = (typeof RAMP_TYPES)[number];
-declare const KERNEL_SIZE_NAMES: readonly ["verySmall", "small", "medium", "large", "veryLarge", "huge"];
-type KernelSizeName = (typeof KERNEL_SIZE_NAMES)[number];
-type ScenePostProcessingConfig = {
-    autofocus: {
-        enabled: boolean;
-        focusDistance: number;
-        focusRange: number;
-        focalLength: number;
-        bokehScale: number;
-        target: [number, number, number];
-        mouse: boolean;
-        debug: number;
-        manual: boolean;
-        smoothTime: number;
-    };
-    toneMapping: {
-        enabled: boolean;
-        mode: "linear" | "reinhard" | "aces";
-        exposure: number;
-        resolution: number;
-        whitePoint: number;
-        middleGrey: number;
-        minLuminance: number;
-        averageLuminance: number;
-        adaptationRate: number;
-    };
-    brightnessContrast: {
-        enabled: boolean;
-        brightness: number;
-        contrast: number;
-    };
-    hueSaturation: {
-        enabled: boolean;
-        hue: number;
-        saturation: number;
-    };
-    colorAverage: {
-        enabled: boolean;
-    };
-    dotScreen: {
-        enabled: boolean;
-        angle: number;
-        scale: number;
-    };
-    glitch: {
-        enabled: boolean;
-        mode: GlitchModeName;
-        delay: [number, number];
-        duration: [number, number];
-        strength: [number, number];
-        chromaticAberrationOffset: [number, number];
-        columns: number;
-        ratio: number;
-    };
-    ssao: {
-        enabled: boolean;
-        samples: number;
-        rings: number;
-        intensity: number;
-        radius: number;
-        bias: number;
-        luminanceInfluence: number;
-        fade: number;
-        minRadiusScale: number;
-        worldDistanceThreshold: number;
-        worldDistanceFalloff: number;
-        worldProximityThreshold: number;
-        worldProximityFalloff: number;
-    };
-    bloom: {
-        enabled: boolean;
-        intensity: number;
-        luminanceThreshold: number;
-        luminanceSmoothing: number;
-        mipmapBlur: boolean;
-        radius: number;
-        levels: number;
-    };
-    godRays: {
-        enabled: boolean;
-        sunPosition: [number, number, number];
-        samples: number;
-        density: number;
-        decay: number;
-        weight: number;
-        exposure: number;
-        clampMax: number;
-        blur: boolean;
-        kernelSize: KernelSizeName;
-    };
-    grid: {
-        enabled: boolean;
-        scale: number;
-        lineWidth: number;
-    };
-    noise: {
-        enabled: boolean;
-        opacity: number;
-        premultiply: boolean;
-    };
-    depthOfField: {
-        enabled: boolean;
-        focusDistance: number;
-        focusRange: number;
-        focalLength: number;
-        bokehScale: number;
-    };
-    chromaticAberration: {
-        enabled: boolean;
-        offsetX: number;
-        offsetY: number;
-        radialModulation: boolean;
-        modulationOffset: number;
-    };
-    lensflare: {
-        enabled: boolean;
-        lensPosition: [number, number, number];
-        smoothTime: number;
-        glareSize: number;
-        flareSize: number;
-        flareSpeed: number;
-        flareShape: number;
-        animated: boolean;
-        anamorphic: boolean;
-        colorGain: string;
-        haloScale: number;
-        secondaryGhosts: boolean;
-        aditionalStreaks: boolean;
-        ghostScale: number;
-        opacity: number;
-        starBurst: boolean;
-    };
-    vignette: {
-        enabled: boolean;
-        offset: number;
-        darkness: number;
-        eskil: boolean;
-    };
-    smaa: {
-        enabled: boolean;
-    };
-    sepia: {
-        enabled: boolean;
-        intensity: number;
-    };
-    scanline: {
-        enabled: boolean;
-        density: number;
-    };
-    pixelation: {
-        enabled: boolean;
-        granularity: number;
-    };
-    outline: {
-        enabled: boolean;
-        selectionLayer: number;
-        edgeStrength: number;
-        pulseSpeed: number;
-        visibleEdgeColor: string;
-        hiddenEdgeColor: string;
-        kernelSize: KernelSizeName;
-        blur: boolean;
-        xRay: boolean;
-    };
-    selectiveBloom: {
-        enabled: boolean;
-        selectionLayer: number;
-        intensity: number;
-        luminanceThreshold: number;
-        luminanceSmoothing: number;
-        kernelSize: KernelSizeName;
-        mipmapBlur: boolean;
-        inverted: boolean;
-        ignoreBackground: boolean;
-    };
-    ramp: {
-        enabled: boolean;
-        rampType: RampTypeName;
-        rampStart: [number, number];
-        rampEnd: [number, number];
-        startColor: string;
-        endColor: string;
-        opacity?: number;
-        rampBias: number;
-        rampGain: number;
-        rampMask: boolean;
-        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];
-    localPosition: [number, number, number];
-    worldNormal?: [number, number, number];
-    anchorNodeName?: string;
-    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];
-    target: [number, number, number];
-    /**
-     * Orbit angles in radians, captured with the view in BindingBuilder. They
-     * keep the rotation when position and target are vertically aligned; older
-     * scene configs without them still work.
-     */
-    azimuthAngle?: number;
-    polarAngle?: number;
-    segmentDuration?: number;
-};
-type SceneCinematicConfig = {
-    enabled: boolean;
-    waypoints: SceneCinematicWaypoint[];
-    duration?: number;
-    loop: boolean;
-    autoPlay: boolean;
-};
-declare const SECTION_AXES: readonly ["x", "y", "z"];
-type SceneSectionAxis = (typeof SECTION_AXES)[number];
-type SceneSectionPlane = {
-    id: string;
-    name: string;
-    enabled: boolean;
-    axis: SceneSectionAxis;
-    position: number;
-    flip: boolean;
-    /** Optional world-space normal; normalized when used. Overrides axis. */
-    normal?: [number, number, number];
-};
-type SceneSectionSettings = {
-    enabled: boolean;
-    /** The world axis the cut runs across; `"y"` gives a floor-plan cut. */
-    axis: SceneSectionAxis;
-    /**
-     * Where the cut is along the axis, as a share of the model's size: 0 at
-     * its minimum, 1 at its maximum.
-     */
-    position: number;
-    /**
-     * Keep the part above the cut (the higher side along the axis) instead of
-     * the part below it.
-     */
-    flip: boolean;
-    /** Default: the original single plane. */
-    mode?: "plane" | "planes" | "box";
-    /** Up to six independently enabled cuts. */
-    planes?: SceneSectionPlane[];
-    activePlaneId?: string;
-    /** Custom normal for the single plane. */
-    normal?: [number, number, number];
-    /** Normalized bounds within the model bounds. Default: the full model. */
-    box?: {
-        min: [number, number, number];
-        max: [number, number, number];
-    };
-    /** Keep the outside of a section box instead of its inside. */
-    invertBox?: boolean;
-};
-type SceneSectionPreset = {
-    id: string;
-    name: string;
-    settings: SceneSectionSettings;
-};
-type SceneSectionConfig = SceneSectionSettings & {
-    presets?: SceneSectionPreset[];
-};
-declare const DEFAULT_SECTION_CONFIG: SceneSectionConfig;
-/**
- * What an object's data must look like for a rule to apply to it. A list
- * applies when every condition in it matches.
- */
-type SceneStyleCondition = {
-    /** A key of `binding.metrics`. */
-    metric: string;
-    /** Applies when the value is greater than this. */
-    above?: number;
-    /** Applies when the value is less than this. */
-    below?: number;
-} | {
-    status: ObjectBindingStatus | ObjectBindingStatus[];
-} | {
-    /** A key of `binding.metadata`; dots reach into nested objects. */
-    metadata: string;
-    equals: string | number | boolean | null;
-};
-type SceneStyleColorScale = {
-    /** A key of `binding.metrics`. */
-    metric: string;
-    /**
-     * `[value, "#rrggbb"]` pairs. Values between two stops blend their colours;
-     * values outside the stops take the nearest one.
-     */
-    stops: [number, string][];
-    /** The material colour it sets. Default `"baseColor"`. */
-    channel?: "baseColor" | "emissive";
-};
-type SceneStylePulse = {
-    /** The glow colour at the pulse's peak. Default `"#ff3b30"`. */
-    color?: string;
-    /** Pulses per second. Default `1`. */
-    speed?: number;
-};
-type SceneStyleRule = {
-    id: string;
-    label?: string;
-    /** The objects the rule considers; every bound object when left out. */
-    target?: ObjectBindingTarget;
-    /** When the rule applies; always, when left out. */
-    when?: SceneStyleCondition | SceneStyleCondition[];
-    /** Material overrides, over the object's own `style.material`. */
-    material?: ObjectBindingMaterial;
-    /** A colour taken from a metric's value. */
-    colorScale?: SceneStyleColorScale;
-    /** A glow that fades in and out, to draw attention. */
-    pulse?: boolean | SceneStylePulse;
-};
-type SceneConfig = {
-    model: SceneModelConfig;
-    camera: SceneCameraConfig;
-    lighting: SceneLightingConfig;
-    wireframe: SceneWireframeConfig;
-    shadows: SceneShadowConfig;
-    environment: SceneEnvironmentConfig;
-    background: SceneBackgroundConfig;
-    groundShadows: SceneGroundShadowConfig;
-    postProcessing: ScenePostProcessingConfig;
-    animations: SceneAnimationConfig;
-    annotations: SceneAnnotationMarker[];
-    cinematic?: SceneCinematicConfig;
-    /**
-     * Data-driven looks for bound objects, applied in order, so a later rule
-     * wins over an earlier one where both set something.
-     */
-    styleRules?: SceneStyleRule[];
-    /** A cut-away view across the model. Off when left out. */
-    section?: SceneSectionConfig;
-    /** Named measurements and model-unit calibration, owned by this model. */
-    measurements?: MeasurementCollection;
-    /** Named object selections scoped to this model's stable object ids. */
-    selectionSets?: SceneSelectionSet[];
-    /** Product choices, constraints, appearance overrides, and selected options for this model. */
-    product?: SceneProductConfig;
-    /** Authored timed camera, object, appearance and clip tracks. Model-local IDs. */
-    sequences?: SceneSequence[];
-};
-declare const DEFAULT_SCENE_CONFIG: SceneConfig;
-
-type SceneConfigPatch = DeepPartial<SceneConfig>;
-/**
- * Applies a nested scene-config patch without mutating either input. Objects
- * are merged recursively, while arrays and tuples are replaced wholesale.
- */
-declare function patchSceneConfig(sceneConfig: SceneConfig, patch: SceneConfigPatch): SceneConfig;
-
-type AnimationClipInfo = {
-    sourceName: string;
-    duration: number;
-};
-/** How `play` starts a clip. */
-type AnimationPlayOptions = {
-    /**
-     * Keep the clips already playing, instead of stopping them, so several
-     * clips run at once (a left and a right door, say). Default `false`.
-     */
-    alongside?: boolean;
-    /**
-     * Seconds to fade the clip in, and to fade out the clips it replaces, for a
-     * smooth blend between them. Default `0`.
-     */
-    fade?: number;
-    /**
-     * Play backwards, from wherever the clip is, or from its end. Plays a
-     * "door opens" clip as the door closing. Default `false`.
-     */
-    reverse?: boolean;
-};
-/**
- * `"finished"`: a play-once clip that reached its end and holds its last pose
- * until it's stopped or played again.
- */
-type AnimationClipStatus = "playing" | "paused" | "finished";
-/** One clip that is playing, paused, or holding its finished pose. */
-type AnimationClipState = {
-    clip: string;
-    status: AnimationClipStatus;
-    /** Position in the clip, in seconds. */
-    time: number;
-    /** Length of the clip, in seconds. */
-    duration: number;
-    speed: number;
-    reverse: boolean;
-};
-type AnimationPlaybackState = {
-    /** Playback intent is preserved while offscreen rendering is suspended. */
-    isRenderPaused?: boolean;
-    /** The clip played most recently, while it's active. */
-    currentClip: string | null;
-    /** Whether any clip is playing. */
-    isPlaying: boolean;
-    speed: number;
-    time: number;
-    duration: number;
-    /** Every active clip, most recently played last. */
-    active: AnimationClipState[];
-};
-/**
- * Leave out `clip` to act on every active clip; pass one to act on that clip
- * alone.
- */
-type AnimationControls = {
-    clips: string[];
-    clipDetails?: AnimationClipInfo[];
-    play: (clipName: string, options?: AnimationPlayOptions) => void;
-    pause: (clipName?: string) => void;
-    /** Stops and resets the pose. */
-    stop: (clipName?: string) => void;
-    /** Without a clip, also the speed of clips played later without their own. */
-    setSpeed: (speed: number, clipName?: string) => void;
-    seek?: (time: number, clipName?: string) => void;
-    getState?: () => AnimationPlaybackState;
-    subscribe?: (listener: (state: AnimationPlaybackState) => void) => () => void;
-};
-type ViewerAnimationsProps = {
-    isRenderPaused: boolean;
-    clips: string[];
-    clipDetails: AnimationClipInfo[];
-    currentClip: string | null;
-    isPlaying: boolean;
-    speed: number;
-    time: number;
-    duration: number;
-    /** Every active clip, most recently played last. */
-    active: AnimationClipState[];
-    play: (clipName: string, options?: AnimationPlayOptions) => void;
-    pause: (clipName?: string) => void;
-    stop: (clipName?: string) => void;
-    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;
-
-/** A glow cycling on one object, from its style rules. */
-type StyledObjectPulse = {
-    color: string;
-    /** Pulses per second. */
-    speed: number;
-};
-type StyledObjectBindings = {
-    /**
-     * The bindings as the rules style them. A binding no rule changed is the
-     * same object as the one passed in.
-     */
-    bindings: Record<string, ObjectBinding>;
-    /** Pulsing objects, by binding key. */
-    pulses: Record<string, StyledObjectPulse>;
-    /** The binding a styled one came from (itself when no rule changed it). */
-    sourceOf: (binding: ObjectBinding) => ObjectBinding;
-};
-/**
- * The colour a colour scale gives a value: a blend of the two stops around it,
- * or the nearest stop outside them. Null when there's no usable stop.
- */
-declare function colorScaleValue(stops: SceneStyleColorScale["stops"], value: number): string | null;
-/**
- * Styles bindings with scene style rules, for rendering. Rules apply in order
- * over each object's own `style.material`, so a later rule wins where two set
- * the same thing. The bindings passed in are never changed.
- */
-declare function applyStyleRules(bindings: Record<string, ObjectBinding>, rules: readonly SceneStyleRule[] | undefined): StyledObjectBindings;
-
-/**
- * Objects to focus on. Everything else is ghosted (drawn faintly) or hidden
- * until the isolation is cleared, without changing any binding.
- */
-type ViewerIsolation = {
-    /** The objects that stay: an id, a list of ids, `{ group }`, `{ tag }`, or `{ type }`. */
-    target: ObjectBindingTarget;
-    /** What happens to everything else. Default `"ghost"`. */
-    mode?: "ghost" | "hide";
-    /** How visible ghosted objects are, 0–1. Default `0.12`. */
-    ghostOpacity?: number;
-};
-type IsolatedObjectBindings = StyledObjectBindings & {
-    /** Binding keys that are ghosted or hidden. Pointer picking ignores them. */
-    setAside: Set<string>;
-};
-/** The binding keys an isolation keeps; empty when it keeps nothing. */
-declare function isolatedBindingKeys(bindings: Record<string, ObjectBinding>, isolation: ViewerIsolation | null | undefined): Set<string>;
-/**
- * Ghosts or hides every object an isolation doesn't keep, for rendering. The
- * bindings passed in are never changed. An isolation that keeps nothing (a
- * target matching no object) changes nothing either, rather than fading out
- * the whole model.
- */
-declare function applyIsolation(styled: StyledObjectBindings, isolation: ViewerIsolation | null | undefined): IsolatedObjectBindings;
-
-type ObjectBindingsActionEffect = {
-    target: ObjectBindingTarget;
-    objectBindings: ObjectBindingPatch;
-};
-type SceneConfigActionEffect = {
-    sceneConfig: SceneConfigPatch;
-};
-type VisibilityActionEffect = {
-    target: ObjectBindingTarget;
-    visibility: "show" | "hide" | "toggle";
-};
-type CameraAction = {
-    type: "focus-object";
-    objectId?: string;
-} | {
-    type: "fit-scene";
-} | {
-    type: "reset";
-} | {
-    type: "set-target";
-    target: [number, number, number];
-    transition?: boolean;
-} | {
-    type: "set-state";
-    state: ViewerCameraState;
-    transition?: boolean;
-};
-type CameraActionEffect = {
-    camera: CameraAction;
-};
-/**
- * `play` replaces the clips already playing unless `alongside` is set. The
- * others act on `clip`, or on every active clip when it's left out.
- */
-type AnimationAction = ({
-    type: "play";
-    clip: string;
-} & AnimationPlayOptions) | {
-    type: "pause";
-    clip?: string;
-} | {
-    type: "stop";
-    clip?: string;
-} | {
-    type: "set-speed";
-    speed: number;
-    clip?: string;
-} | {
-    type: "seek";
-    time: number;
-    clip?: string;
-};
-type AnimationActionEffect = {
-    animation: AnimationAction;
-};
-/** Isolates objects, or with `null` shows everything again. */
-type IsolationActionEffect = {
-    isolation: ViewerIsolation | null;
-};
-type ObjectActionEffect = IsolationActionEffect | ObjectBindingsActionEffect | SceneConfigActionEffect | VisibilityActionEffect | CameraActionEffect | AnimationActionEffect;
-
-type ObjectBindingAction = {
-    id: "change-color" | "change-material" | "toggle-visibility" | string;
-    label: string;
-    type: "command";
-    effects?: ObjectActionEffect[];
-};
-/**
- * What kind of object a binding is, for grouping and filtering. The listed
- * values are suggestions; any string works.
- */
-type ObjectBindingType = "body" | "other" | "glass" | "windshield" | "rear-windshield" | "window" | "sunroof" | "wheel" | "rim" | "tire" | "brake-caliper" | "brake-disc" | "suspension" | "spring" | "shock-absorber" | "axle" | "control-arm" | "interior" | "seat" | "headrest" | "seatbelt" | "dashboard" | "steering-wheel" | "gear-shift" | "center-console" | "armrest" | "door-panel" | "carpet" | "headliner" | "sun-visor" | "pedal" | "instrument-cluster" | "infotainment" | "glove-box" | "engine" | "gearbox" | "radiator" | "battery" | "fuel-tank" | "air-filter" | "intercooler" | "alternator" | "turbo" | "light" | "headlight" | "taillight" | "fog-light" | "indicator" | "daytime-running-light" | "interior-light" | "ambient-light" | "floor" | "floor-tile" | "floor-board" | "floor-mat" | "ceiling" | "ceiling-tile" | "wall" | "wall-tile" | "wall-panel" | "wall-trim" | "baseboard" | "crown-molding" | "column" | "pillar" | "beam" | "arch" | "stairs" | "step" | "railing" | "balustrade" | "window-frame" | "window-sill" | "blind" | "curtain" | "shutter" | "door" | "door-frame" | "door-knob" | "furniture" | "sofa" | "armchair" | "ottoman" | "bed" | "headboard" | "mattress" | "nightstand" | "dresser" | "wardrobe" | "closet" | "shelf" | "bookcase" | "desk" | "office-chair" | "dining-table" | "dining-chair" | "bar-stool" | "bench" | "cabinet" | "sideboard" | "coffee-table" | "side-table" | "tv-stand" | "kitchen-island" | "countertop" | "sink" | "bathtub" | "shower" | "toilet" | "vanity" | "decor" | "rug" | "cushion" | "throw" | "curtain-rod" | "artwork" | "mirror" | "vase" | "plant" | "pot" | "candle" | "frame" | "sculpture" | "clock" | "lamp" | "floor-lamp" | "table-lamp" | "pendant-light" | "chandelier" | "sconce" | "ceiling-fan" | "electronics" | "tv" | "monitor" | "speaker" | "soundbar" | "projector" | "remote" | "console" | "router" | "smart-hub" | "thermostat" | "appliance" | "refrigerator" | "oven" | "microwave" | "dishwasher" | "washing-machine" | "dryer" | "air-conditioner" | "heater" | "ventilation" | "root" | "bone" | "joint" | "socket" | "pivot" | "head" | "face" | "eye" | "eyelid" | "eyebrow" | "mouth" | "teeth" | "tongue" | "ear" | "nose" | "hair" | "beard" | "neck" | "torso" | "chest" | "abdomen" | "back" | "shoulder" | "upper-arm" | "forearm" | "hand" | "finger" | "thumb" | "hip" | "thigh" | "shin" | "foot" | "toe" | "tail" | "wing" | "tentacle" | "clothing" | "hat" | "helmet" | "visor" | "mask" | "goggles" | "glasses" | "jacket" | "shirt" | "pants" | "skirt" | "shoes" | "boots" | "gloves" | "belt" | "watch" | "bag" | "backpack" | "jewelry" | "necklace" | "ring" | "armor" | "chest-plate" | "pauldron" | "gauntlet" | "greave" | "shield" | "weapon" | "blade" | "edge" | "tip" | "guard" | "grip" | "pommel" | "barrel" | "stock" | "scope" | "trigger" | "magazine" | "muzzle" | "gear" | "piston" | "lever" | "valve" | "pump" | "motor" | "rotor" | "blade-prop" | "nozzle" | "pipe" | "tube" | "cable" | "wire" | "connector" | "panel" | "hatch" | "vent" | "antenna" | "sensor" | "camera" | "screen" | "dial" | "button" | "knob" | "switch" | "gauge" | "terrain" | "ground" | "rock" | "cliff" | "water" | "ocean" | "river" | "lake" | "wave" | "foam" | "sky" | "cloud" | "sun" | "moon" | "star" | "fog" | "foliage" | "tree" | "branch" | "leaf" | "grass" | "bush" | "flower" | "soil" | "sand" | "snow" | "ice" | "facade" | "foundation" | "roof-structure" | "chimney" | "balcony" | "porch" | "pathway" | "fence" | "gate" | "wall-exterior" | (string & {});
-type ObjectBindingStatus = "normal" | "hidden" | "selected" | "disabled";
-type ObjectBindingTextureSlot = {
-    path: string;
-    /** UV position offset [u, v]. */
-    offset?: [number, number];
-    /** UV zoom scale. 1 = default, >1 = zoom in, <1 = zoom out. */
-    scale?: number;
-    rotation?: number;
-};
-type ObjectBindingTextureChannel = "baseColor" | "metalness" | "roughness" | "emissive" | "alpha" | "normal" | "bump" | "ao" | "displacement" | "clearcoat" | "clearcoatRoughness" | "clearcoatNormal" | "anisotropy" | "transmission" | "thickness" | "sheenColor" | "sheenRoughness" | "specularIntensity" | "specularColor";
-type ObjectBindingTransform = {
-    /** 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];
-declare const MATERIAL_BLENDING_MODES: readonly ["normal", "additive"];
-type ObjectBindingMaterialBlendingMode = (typeof MATERIAL_BLENDING_MODES)[number];
-type ObjectBindingMaterial = {
-    texture?: ObjectBindingTextureSlot;
-    baseColor?: string;
-    metalness?: number;
-    metalnessMap?: ObjectBindingTextureSlot;
-    roughness?: number;
-    roughnessMap?: ObjectBindingTextureSlot;
-    emissive?: string;
-    emissiveIntensity?: number;
-    emissiveMap?: ObjectBindingTextureSlot;
-    opacity?: number;
-    alphaMap?: ObjectBindingTextureSlot;
-    alphaTest?: number;
-    alphaHash?: boolean;
-    dithering?: boolean;
-    blendingMode?: ObjectBindingMaterialBlendingMode;
-    side?: ObjectBindingMaterialSide;
-    normalMap?: ObjectBindingTextureSlot;
-    normalScale?: number;
-    flipNormalY?: boolean;
-    bumpMap?: ObjectBindingTextureSlot;
-    bumpScale?: number;
-    aoMap?: ObjectBindingTextureSlot;
-    aoMapIntensity?: number;
-    displacementMap?: ObjectBindingTextureSlot;
-    displacementScale?: number;
-    displacementBias?: number;
-    clearcoat?: number;
-    clearcoatMap?: ObjectBindingTextureSlot;
-    clearcoatRoughness?: number;
-    clearcoatRoughnessMap?: ObjectBindingTextureSlot;
-    clearcoatNormalMap?: ObjectBindingTextureSlot;
-    clearcoatNormalScale?: number;
-    flipClearcoatNormalY?: boolean;
-    sheen?: number;
-    sheenColor?: string;
-    sheenColorMap?: ObjectBindingTextureSlot;
-    sheenRoughness?: number;
-    sheenRoughnessMap?: ObjectBindingTextureSlot;
-    anisotropy?: number;
-    anisotropyRotation?: number;
-    anisotropyMap?: ObjectBindingTextureSlot;
-    transmission?: number;
-    transmissionMap?: ObjectBindingTextureSlot;
-    thickness?: number;
-    thicknessMap?: ObjectBindingTextureSlot;
-    attenuationColor?: string;
-    attenuationDistance?: number;
-    reflectivity?: number;
-    specularIntensity?: number;
-    specularIntensityMap?: ObjectBindingTextureSlot;
-    specularColor?: string;
-    specularColorMap?: ObjectBindingTextureSlot;
-};
-type ObjectBindingCameraState = {
-    position?: [number, number, number];
-    target?: [number, number, number];
-    fov?: number;
-    zoom?: number;
-};
-/**
- * An image or a line of text printed onto the object's surface: a logo, a
- * label, a personalisation.
- */
-type ObjectBindingDecal = {
-    id: string;
-    /** The image to show: a URL or public path. */
-    image?: string;
-    /** Text to show, when there's no image. */
-    text?: string;
-    /** Text colour. Default `"#ffffff"`. */
-    color?: string;
-    /** CSS font family for the text. Default `"sans-serif"`. */
-    fontFamily?: string;
-    /** Default `"bold"`. */
-    fontWeight?: "normal" | "bold";
-    /** Where it sits on the object, in the object's own (local) space. */
-    position: [number, number, number];
-    /** The way the surface faces there, in the object's own space. */
-    normal: [number, number, number];
-    /** Width, in model units; the height follows the image or text's shape. */
-    size: number;
-    /** A turn around the surface normal, in radians. Default `0`. */
-    rotation?: number;
-    /** 0–1. Default `1`. */
-    opacity?: number;
-};
-type ObjectBindingStyle = {
-    material?: ObjectBindingMaterial;
-};
-type ObjectBinding = {
-    id: string;
-    /** Defaults to `"other"`. */
-    type?: ObjectBindingType;
-    modelObjectId: string;
-    label?: string;
-    group?: string;
-    tags?: string[];
-    status?: ObjectBindingStatus;
-    removed?: boolean;
-    visible?: boolean;
-    selectable?: boolean;
-    hoverable?: boolean;
-    transform?: ObjectBindingTransform;
-    style?: ObjectBindingStyle;
-    /** Images and text printed on the object's surface. */
-    decals?: ObjectBindingDecal[];
-    actions?: ObjectBindingAction[];
-    metrics?: Record<string, number>;
-    metadata?: Record<string, unknown>;
-    cameraState?: ObjectBindingCameraState;
-};
-type ObjectActionEvent = {
-    objectId: string;
-    action: ObjectBindingAction;
-    binding?: ObjectBinding;
-    screenX?: number;
-    screenY?: number;
-};
-/** A point on an object's surface, in the object's own (local) space. */
-type ObjectSurfacePoint = {
-    position: [number, number, number];
-    /** The way the surface faces at that point. */
-    normal: [number, number, number];
-};
-/** A double-click, right-click, or long-press on a model object. */
-type ObjectPointerEvent = {
-    binding: ObjectBinding;
-    /** Viewport coordinates, e.g. to place a menu with `position: fixed`. */
-    clientX: number;
-    clientY: number;
-    /** `"mouse"`, `"pen"`, or `"touch"`. */
-    pointerType: string;
-    /**
-     * Where on the object the pointer was, e.g. to place a decal there. Not
-     * reported for streamed (3D Tiles) models.
-     */
-    surface?: ObjectSurfacePoint;
-};
-
-type LicenseStatus = "checking" | "valid" | "invalid";
-interface LicenseResult {
-    status: LicenseStatus;
-    reason?: string;
-    environment?: "development" | "production";
-    tier?: string;
-    isLocalDomain: boolean;
-}
-
-type ViewerProductOptions = {
-    /** Connects your own pricing, stock, cart and quote services. */
-    adapter?: ProductCommerceAdapter;
-    /** Keep the choices in this URL parameter, so a link reopens the same configuration. */
-    urlParam?: string;
-    /** Start with the panel closed. On small screens it always starts closed. */
-    defaultClosed?: boolean;
-    onConfigurationChange?: (configuration: ProductConfiguration, checkoutUrl: string | null) => void;
-};
-
-type ComparisonCategory = "identity" | "appearance" | "transform" | "visibility" | "data" | "behavior" | "scene";
-type ComparisonStatus = "added" | "removed" | "modified" | "unchanged" | "ambiguous";
-type ConfigurationComparisonInput = {
-    objectBindings: Record<string, ObjectBinding>;
-    sceneConfig?: SceneConfig;
-};
-type SemanticComparisonOptions = {
-    /** Default: modelObjectId. Metadata matching is exact and never guesses duplicates. */
-    matchBy?: "modelObjectId" | "id" | {
-        metadataKey: string;
-    };
-    /** Explicit binding-key pairs, before key -> after key. Must be one-to-one. */
-    mapping?: Record<string, string>;
-    /** Absolute tolerance for numeric properties. Default: 0.000001. */
-    tolerance?: number;
-    ignoreMetadataKeys?: string[];
-};
-type ComparisonChange = {
-    path: string;
-    category: ComparisonCategory;
-    before?: unknown;
-    after?: unknown;
-};
-type ComparisonObject = {
-    id: string;
-    identity: string;
-    label: string;
-    status: ComparisonStatus;
-    beforeKey?: string;
-    afterKey?: string;
-    beforeObjectId?: string;
-    afterObjectId?: string;
-    changes: ComparisonChange[];
-    message?: string;
-};
-type ConfigurationComparisonReport = {
-    version: 1;
-    objects: ComparisonObject[];
-    counts: Record<ComparisonStatus, number>;
-    sceneChanges: ComparisonChange[];
-};
-type ComparisonHighlight = {
-    objectId: string;
-    color: string;
-};
-/** Compare authored configuration data. Does not infer geometry changes from meshes or URLs. */
-declare function compareViewerConfigurations(before: ConfigurationComparisonInput, after: ConfigurationComparisonInput, options?: SemanticComparisonOptions): ConfigurationComparisonReport;
-
-/** Serializable, controlled viewer props. Assets stay at their durable URLs. */
-type ViewerConfiguration = Pick<ModelViewerProps, "activeModelId" | "modelUrl" | "modelFormat" | "tilesetUrl" | "models" | "mergeModels" | "sceneConfig" | "isolation" | "multiSelectedKeys" | "activeAnnotation" | "annotationCategories" | "backgroundColor" | "shadows" | "cinematic" | "cameraControllerType" | "objectTransformSpace" | "arScaleMode" | "usdzUrl" | "measurements" | "measurementSettings" | "measurementUnit" | "measurementModelId">;
-/** Unversioned camera/visibility/selection links remain readable. */
-type ShareableViewerState = {
-    version?: 1;
-    camera?: ViewerCameraState;
-    hidden?: string[];
-    selected?: string | null;
-    /** Full bindings, including materials, decals, transforms and metadata. */
-    objectBindings?: Record<string, ObjectBinding>;
-    configuration?: ViewerConfiguration;
-};
-/** Application-owned persistence. load may return parsed data or saved JSON. */
-type ViewerStateStorage = {
-    save: (state: ShareableViewerState) => Promise<string>;
-    load: (id: string) => Promise<unknown>;
-};
-declare const MAX_VIEWER_STATE_BYTES: number;
-/** JSON suitable for a file, database or application-owned storage adapter. */
-declare function serializeViewerState(state: ShareableViewerState, baseUrl?: string): string;
-/** Validate portable data. For live blob images use prepareViewerState first. */
-declare function parseViewerState(input: unknown, baseUrl?: string): ShareableViewerState;
-/**
- * Capture live texture/decal/image blobs as data URLs. Models stay at their
- * original durable URLs; no upload service or network asset scraping is used.
- */
-declare function prepareViewerState(input: unknown, baseUrl?: string): Promise<ShareableViewerState>;
-
-type ARSnapshotSource = {
-    scene: Object3D;
-    instanceId?: string;
-    objectBindings?: NonNullable<ShareableViewerState["objectBindings"]>;
-    materialOverrides?: Record<string, Material | Material[]>;
-    /** Authored autoplay clips and sequences to include in Quick Look. */
-    sceneConfig?: Pick<SceneConfig, "animations" | "sequences">;
-};
-type ARExportOptions = {
-    scaleMode?: "normalized" | "real-world";
-    /** Longest texture dimension, default 2048; from 256 to 4096. */
-    maxTextureSize?: number;
-    signal?: AbortSignal;
-};
-type ARSnapshot = {
-    blob: Blob;
-    meshCount: number;
-    triangleCount: number;
-    /** Applied scale after centering horizontally and resting on Y=0. */
-    scale: number;
-    warnings: string[];
-};
-type ARHandoffRequest = {
-    /** Stable key for this configuration and application-supplied asset version. */
-    configurationKey: string;
-    /** Detached live data. Local model URLs may still be temporary. */
-    state: ShareableViewerState;
-    signal: AbortSignal;
-    /** Exports the current geometry and supported authored animation to USDZ. */
-    exportUSDZ: () => Promise<ARSnapshot>;
-};
-type ARHandoffStatus = "idle" | "preparing" | "ready" | "error" | "stale";
-type ARHandoffOptions = {
-    /** Change this when replacing an asset at the same URL, or after direct scene mutations. */
-    assetVersion?: string;
-    maxTextureSize?: number;
-    /** Store large phone configurations using the same adapter in the receiving viewer. */
-    storage?: ViewerStateStorage;
-    /** Read this feature's configuration hash on arrival. Default true. */
-    autoRestore?: boolean;
-    /** Application-owned conversion/cache for assets unsupported by the local exporter. */
-    createUSDZ?: (request: ARHandoffRequest) => Promise<Blob | string>;
-    /** Application-owned upload/sharing path, including support for local model files. */
-    createMobileUrl?: (request: ARHandoffRequest) => Promise<string>;
-    onStatusChange?: (status: ARHandoffStatus) => void;
-    onError?: (error: Error) => void;
-};
-
-/** Whole-instance placement, outside the asset's authored transforms. Radians, source scene units. */
-type AssetTransform = {
-    position?: [number, number, number];
-    rotation?: [number, number, number];
-    scale?: [number, number, number];
-};
-type AssetPlacement = AssetTransform & {
-    label?: string;
-    visible?: boolean;
-    deleted?: boolean;
-};
-/** Standalone editor placement state, keyed by persistent model identity. */
-type SceneComposition = {
-    version: 1;
-    placements: Record<string, AssetPlacement>;
-    gridSize: number;
-};
-declare function parseAssetTransform(value: unknown): AssetTransform;
-/** Snap the instance origin on the shared X/Z plane. */
-declare function snapAssetToGrid(transform: AssetTransform, size: number): AssetTransform;
-/** Place the transformed asset's lowest bound on the Y=0 ground plane. */
-declare function groundAsset(transform: AssetTransform, bounds: {
-    min: [number, number, number];
-    max: [number, number, number];
-}): AssetTransform;
-
-type PerformanceProfile = "auto" | "high" | "low";
-
-type AssetDiagnosticIssue = {
-    code: string;
-    severity: "info" | "warning" | "error";
-    title: string;
-    detail: string;
-    suggestion: string;
-    count?: number;
-    /** At most twenty names, even when a large asset has thousands of affected objects. */
-    objects?: string[];
-};
-type AssetDiagnosticsSource = {
-    format?: string;
-    name?: string;
-    sourceBytes?: number | null;
-    loadDurationMs?: number | null;
-    extensionsUsed?: string[];
-    extensionsRequired?: string[];
-    failedResources?: string[];
-};
-type AssetTextureDiagnostic = {
-    name: string;
-    width: number | null;
-    height: number | null;
-    compressed: boolean;
-    /** RGBA8 with mipmaps for ordinary textures; actual mip bytes for compressed textures. */
-    estimatedBytes: number | null;
-};
-type AssetDiagnosticsReport = {
-    version: 1;
-    status: "ready" | "failed";
-    scope: "asset" | "resident-tiles";
-    source: AssetDiagnosticsSource;
-    /** A format convention, not verification of the model author's physical scale. */
-    units: "meters (glTF convention)" | "unknown";
-    bounds: ViewerModelBounds | null;
-    statistics: {
-        meshes: number;
-        instances: number;
-        geometries: number;
-        materials: number;
-        textures: number;
-        /** Unique geometry data, not repeated instances or per-frame rendered triangles. */
-        vertices: number;
-        triangles: number;
-        geometryBytes: number;
-        estimatedTextureBytes: number;
-        unknownTextureSizes: number;
-        meshesWithoutUvs: number;
-        meshesWithoutNormals: number;
-    } | null;
-    textures: AssetTextureDiagnostic[];
-    extensions: {
-        name: string;
-        required: boolean;
-        recognized: boolean;
-    }[];
-    issues: AssetDiagnosticIssue[];
-};
-type InspectAssetOptions = {
-    source?: AssetDiagnosticsSource;
-    scope?: AssetDiagnosticsReport["scope"];
-};
-type StreamingDiagnostics = {
-    cachedBytes: number | null;
-    budgetBytes: number;
-    cachedTiles: number | null;
-    downloading: number;
-    parsing: number;
-    cacheFull: boolean;
-    /** Existing memory-pressure adaptation's multiplier; 1 is the requested detail. */
-    detailFactor: number;
-    errorTarget: number;
-};
-type ViewerRuntimeStats = {
-    sampledAt: string;
-    renderer: "webgl" | "webgpu";
-    /** Last completed renderer pass; may be a post-processing or shadow pass. */
-    drawCalls: number | null;
-    triangles: number | null;
-    geometries: number | null;
-    textures: number | null;
-    /** Spacing of consecutive active frame callbacks, not CPU/GPU execution time. */
-    frameIntervalMs: number | null;
-    fps: number | null;
-    frameSamples: number;
-    renderMode: "always" | "demand" | "never";
-    quality: {
-        profile: PerformanceProfile;
-        reducedGpuLoad: boolean;
-        dpr: number;
-        shadows: boolean;
-        /** Whether the quality profile/backend permits the post-processing stack. */
-        postProcessing: boolean;
-    };
-    streaming: StreamingDiagnostics | null;
-};
-
-/** Engagement from deliberate viewer interactions, with model/session context. */
-type ViewerEngagementEvent = {
-    /** Ephemeral identifier for this viewer/model session; no persistent storage. */
-    sessionId: string;
-    /** ISO timestamp of the event. */
-    timestamp: string;
-    /** Milliseconds since tracking started for this model. */
-    elapsedMs: number;
-    modelUrl: string;
-    tilesetUrl: string | null;
-} & ({
-    type: "part-viewed";
-    objectId: string;
-    objectKey: string;
-    label?: string;
-    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";
-} | {
-    type: "ar-ended";
-    durationMs: number;
-    reason: "session-ended" | "interrupted";
-} | {
-    type: "ar-launch-requested";
-    channel: "quick-look" | "mobile-handoff";
-} | {
-    type: "tour-started";
-    annotationCount: number;
-} | {
-    type: "tour-completed";
-    annotationCount: number;
-    durationMs: number;
-} | {
-    type: "tour-stopped";
-    annotationCount: number;
-    durationMs: number;
-    reason: "stopped" | "restarted" | "annotations-changed" | "interrupted";
-});
-
-type MouseControllerPosition = 'bottom-left' | 'bottom-right' | 'top-left' | 'top-right' | 'center' | 'center-bottom' | 'center-top';
-
-type XRScaleMode = "normalized" | "real-world";
-
-/** A starting set of ModelViewer props for a common kind of page. */
-type ModelViewerPreset = "minimal" | "showcase" | "configurator" | "inspector";
-type ModelViewerUiOptions = {
-    /** The left panel for the selected object. Default `true`. */
-    objectPanel?: boolean;
-    /** The right panel listing the model's objects. Default `true`. */
-    sceneObjects?: boolean;
-    /** The download button; a string also sets the file name. Default `true`. */
-    download?: boolean | string;
-    /** The reset-view button. Default `true`. */
-    reset?: boolean;
-    /** The viewer fullscreen toggle in the action bar. Default `false`. */
-    fullscreen?: boolean;
-    /** The loading overlay and load-error message. Default `true`. */
-    loadingOverlay?: boolean;
-    /** The axis gizmo in the top-right corner. Default `false`. */
-    viewGizmo?: boolean;
-    /** The on-screen movement pad; an object also places it. Default `false`. */
-    mouseController?: boolean | {
-        position?: MouseControllerPosition;
-        opacity?: number;
-    };
-    /** Previous/Stop/Next controls for annotation tours. Default `true`. */
-    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;
-    /** 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
- * out keep the viewer's own behavior, which reads and writes the binding.
- */
-type TexturePositioningControls = {
-    /** Shown in the Offset fields instead of the binding's offset. */
-    offset?: [number, number];
-    /** Shown in the Rotation field instead of the binding's, in degrees (0–360). */
-    rotationDegrees?: number;
-    /** Replaces the viewer's write when an Offset field changes. */
-    onOffsetChange?: (objectId: string, axisIndex: 0 | 1, value: number) => void;
-    /** Replaces the viewer's write when the Rotation field changes. */
-    onRotationChange?: (objectId: string, degrees: number) => void;
-    /** Whether to show "Done positioning" rather than the hint. */
-    isPositioning?: boolean;
-    /** Called after "Done positioning" ends Move/Zoom mode. */
-    onEndPositioning?: () => void;
-};
-type ModelViewerToolsOptions = {
-    /** Distance and dimension tools; an object also sets the unit. Default `false`. */
-    measure?: boolean | {
-        unit?: string;
-    };
-    /** The UV checker toggle. Default `false`. */
-    uvChecker?: boolean;
-    /** The exploded-view slider. Default `false`. */
-    explode?: boolean;
-    /** The section-cut tool, to cut the model open along an axis. Default `false`. */
-    section?: boolean;
-    /** A compact player for authored scene sequences. Default true. */
-    sequences?: boolean;
-    /** Isolate buttons in the scene objects panel, and a "Show all" pill. Default `false`. */
-    isolate?: boolean;
-    /** Texture offset, rotation and Move/Zoom for textured objects. Default `false`. */
-    texturePositioning?: boolean | TexturePositioningControls;
-};
-type ModelViewerControlsOptions = {
-    /** Orbit, pan and zoom with the pointer. Default `true`. */
-    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, 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;
-    /** Movement pad speed. Default `0.08`. */
-    moveSensitivity?: number;
-    /** Movement pad zoom speed. Default `1`. */
-    zoomSensitivity?: number;
-};
-type ModelViewerPerfOptions = {
-    /** `"demand"` draws only when something changes. Default `"demand"`. */
-    renderMode?: "always" | "demand";
-    /** Highest device pixel ratio to render at. Default `2`. */
-    maxDpr?: number;
-    /** `"low"` trades quality for speed on weak devices. Default `"auto"`. */
-    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. */
-    url?: string | null;
-    /** Screen-space error target; lower is sharper. Default `8`. */
-    errorTarget?: number;
-    /** Most parsed tiles kept in memory. Default `800`. */
-    cacheSize?: number;
-};
-type ModelViewerXrOptions = {
-    /** "View in your space" (AR) and "Enter VR". Default `false`. */
-    enabled?: boolean;
-    /** A USDZ file for iOS AR Quick Look. */
-    usdzUrl?: string;
-    /** How the model is sized in AR. Default `"normalized"`. */
-    scaleMode?: XRScaleMode;
-    /** The page the desktop QR code opens on a phone. Default: the current page. */
-    mobileHandoffUrl?: string;
-    /** Prepare the edited configuration for USDZ and phone handoff. Opt-in. */
-    arHandoff?: boolean | ARHandoffOptions;
-};
-type ModelViewerDecoderOptions = {
-    /** Directory of the DRACO decoder files, or `false`. */
-    draco?: string | false;
-    /** Directory of the Basis/KTX2 transcoder files, or `false`. */
-    ktx2?: string | false;
-    /** Enable the bundled Meshopt decoder. Default `true`. */
-    meshopt?: boolean;
-};
-type GroupedModelViewerProps = {
-    /**
-     * A starting set of props for a common kind of page. Anything else you pass
-     * overrides it.
-     */
-    preset?: ModelViewerPreset;
-    ui?: ModelViewerUiOptions;
-    tools?: ModelViewerToolsOptions;
-    controls?: ModelViewerControlsOptions;
-    perf?: ModelViewerPerfOptions;
-    tiles?: ModelViewerTilesOptions;
-    xr?: ModelViewerXrOptions;
-    decoders?: ModelViewerDecoderOptions;
-};
-/** What each preset sets. Props that aren't listed keep their defaults. */
-declare const MODEL_VIEWER_PRESETS: Readonly<Record<ModelViewerPreset, Readonly<Partial<ModelViewerProps>>>>;
-
-type DecalMoveTarget = {
-    objectId: string;
-    decal: ObjectBindingDecal;
-    onCommit: (surface: ObjectSurfacePoint) => void;
-    onCancel: () => void;
-};
-
-type CameraControllerType = "orbit" | "pointerLock";
-
-/** One bindable object in a model, as reported by `onObjectCatalog`. */
-type ViewerObjectInfo = {
-    /** The node identifier bindings are keyed by. */
-    name: string;
-    triangles: number;
-    /**
-     * Axis-aligned bounds in the model's own units, in Z-up coordinates (the 3D
-     * Tiles convention): a glTF point (x, y, z) is (x, -z, y) here.
-     */
-    minimum: [number, number, number];
-    maximum: [number, number, number];
-};
-
-type CinematicWaypoint = {
-    position: [number, number, number];
-    target: [number, number, number];
-    /**
-     * Orbit angles in radians, as BindingBuilder captures them: position and
-     * target alone can't represent the rotation straight above or below the
-     * target. Leave them out when writing waypoints by hand.
-     */
-    azimuthAngle?: number;
-    polarAngle?: number;
-    segmentDuration?: number;
-};
-type CinematicConfig = {
-    waypoints?: CinematicWaypoint[];
-    duration?: number;
-    loop?: boolean;
-    autoPlay?: boolean;
-};
-
-/** Which three.js renderer draws a viewer. */
-type RendererBackend = "webgl" | "webgpu";
-
-type CaptureImageOptions = {
-    width?: number;
-    height?: number;
-    transparent?: boolean;
-    type?: "image/png" | "image/jpeg";
-    quality?: number;
-};
-
-type CaptureVideoOptions = {
-    /** Defaults to cinematic when a path is enabled, otherwise turntable. */
-    mode?: "cinematic" | "turntable";
-    /**
-     * 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 (15 for a GIF). */
-    fps?: number;
-    /** 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;
-};
-
-type ViewerCameraPreset = {
-    position: [number, number, number];
-    target: [number, number, number];
-    fov?: number | null;
-    zoom?: number;
-    azimuthAngle?: number;
-    polarAngle?: number;
-};
-type UseViewerCameraOptions = {
-    /** Camera position applied once when each model becomes ready. */
-    initialPosition?: [number, number, number];
-    /** Orbit target applied once when each model becomes ready. */
-    initialTarget?: [number, number, number];
-    /** Whether the initial position/target should animate. Defaults to false. */
-    initialTransition?: boolean;
-    /** Initial named views, read once. Use setCameraPresets to load later edits. */
-    presets?: Record<string, ViewerCameraPreset>;
-};
-type HomeCameraState = {
-    position: [number, number, number];
-    target: [number, number, number];
-};
-type ViewerReadyState = {
-    objectBindings: Record<string, ObjectBinding>;
-    homeCameraState: HomeCameraState | null;
-    captureImage: (options?: CaptureImageOptions) => Promise<string>;
-    /** Whether a streamed model is still fetching tiles for the current view. */
-    isLoadingTiles: () => boolean;
-    /** 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
-     * libraries' own and can change with them.
-     */
-    raw: {
-        controls: CameraControls;
-        scene: Object3D | null;
-        /** Model nodes by binding key and node name. */
-        nodes: Record<string, Object3D>;
-    };
-};
-type ViewerCameraProps = {
-    /**
-     * Rendering is suspended because the viewer is offscreen. Camera commands
-     * still complete: they jump straight to their end instead of animating.
-     */
-    isRenderPaused: boolean;
-    cameraState: ViewerCameraState | null;
-    cameraPresets: Record<string, ViewerCameraPreset>;
-    /** Replace named views after loading or editing them; does not move the camera. */
-    setCameraPresets: (presets: Record<string, ViewerCameraPreset>) => void;
-    resetView: () => Promise<boolean>;
-    focusObject: (objectId: string) => Promise<boolean>;
-    fitScene: () => Promise<boolean>;
-    setCameraTarget: (target: [number, number, number], enableTransition?: boolean) => Promise<boolean>;
-    setCameraState: (state: ViewerCameraState, enableTransition?: boolean) => Promise<boolean>;
-    lookAt: (position: [number, number, number], target: [number, number, number], enableTransition?: boolean) => Promise<boolean>;
-    /**
-     * Orbits the camera around its target to the given angles, in degrees.
-     * Azimuth is the horizontal angle (0 is the front, +Z; 90 the right, +X);
-     * polar is the vertical angle (0 straight down, 90 level, 180 straight up).
-     */
-    orbitTo: (azimuthDegrees: number, polarDegrees: number, enableTransition?: boolean) => Promise<boolean>;
-    dollyTo: (distance: number, enableTransition?: boolean) => Promise<boolean>;
-    savePreset: (name: string) => ViewerCameraState | null;
-    goToPreset: (name: string, enableTransition?: boolean) => Promise<boolean>;
-    handleCameraChange: (state: ViewerCameraState) => void;
-    handleViewerReady: (viewer: ViewerReadyState) => void;
-};
-declare function useViewerCamera(options?: UseViewerCameraOptions): ViewerCameraProps;
-
-type ObjectTransformSpace = "local" | "world";
-
-type ModelMergeSource = {
-    url: string;
-    namePrefix: string;
-};
-
-type AnnotationMarker = SceneAnnotationMarker & {
-    markerId?: string;
-};
-type CustomObjectBindingDataPanelProps = {
-    isOpen: boolean;
-    selectedObject: ObjectBinding | null;
-    currentAction: ObjectActionEvent | null;
-    onClose: () => void;
-    onAction: (event: ObjectActionEvent) => void;
-};
-type CustomSceneObjectsPanelProps = {
-    objectBindings: Record<string, ObjectBinding>;
-    onAction?: (event: ObjectActionEvent) => void;
-    onFocus?: (binding: ObjectBinding) => void;
-    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. */
-    tilesErrorTarget?: number;
-    /** Maximum number of parsed tiles retained by the client cache. */
-    tilesCacheSize?: number;
-    /**
-     * Every bindable object in the model: each named mesh, under the identifier
-     * bindings are keyed by. Reported each time a model loads; for a streamed
-     * model it comes from the catalog beside `tileset.json`, before the tiles
-     * that contain those objects have necessarily loaded.
-     */
-    onObjectCatalog?: (objects: ViewerObjectInfo[]) => void;
-    /** Explicit format for extensionless or signed model URLs. */
-    modelFormat?: ModelFormat;
-    licenseKey: string;
-    /** License state for application-owned loading and error interfaces. */
-    onLicenseStatusChange?: (result: LicenseResult) => void;
-    hideLicenseCheckingOverlay?: boolean;
-    /**
-     * The model's interactive objects, keyed by node name. Defaults to `"auto"`:
-     * a default binding for every mesh, generated when the model loads and
-     * reported through `onObjectBindingsChange`.
-     */
-    objectBindings?: Record<string, ObjectBinding> | "auto";
-    /**
-     * The selected object's binding (an `ObjectBinding`, not a three.js
-     * `Object3D`). Pass `null` to control selection with nothing selected.
-     */
-    selectedObject?: ObjectBinding | null;
-    /** Transient bounds outlines for semantic comparison; never modify authored materials. */
-    comparisonHighlights?: readonly ComparisonHighlight[];
-    /**
-     * 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;
-    onObjectHover?: (binding: ObjectBinding | null) => void;
-    /**
-     * An object was double-clicked. Return `true` to skip the viewer's own
-     * double-click behavior: moving the orbit point to that spot, or starting
-     * 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.
-     */
-    onObjectContextMenu?: (event: ObjectPointerEvent) => void;
-    /** Editor preview: grab this decal and drag it over its object's surface. */
-    decalMove?: DecalMoveTarget | null;
-    /** The model finished loading: its bounds and mesh count. */
-    onModelLoaded?: (model: ViewerModelInfo) => void;
-    /** Opt-in inspection of the active loaded asset, including its merged nodes. */
-    onAssetDiagnostics?: (report: AssetDiagnosticsReport) => void;
-    /** Opt-in sampled statistics for this viewer's entire canvas. Does not force frames. */
-    onRuntimeStats?: (stats: ViewerRuntimeStats) => void;
-    /** Runtime sampling interval, clamped to 250–10000 ms; default 1000 ms. */
-    runtimeStatsIntervalMs?: number;
-    onLoadError?: (error: unknown) => void;
-    onProgress?: (event: ProgressEvent) => void;
-    onCameraControllerChange?: (controller: CameraControllerType) => void;
-    cameraControllerType?: CameraControllerType;
-    onAction?: (event: ObjectActionEvent) => void;
-    onHiddenObjectsChange?: (next: Record<string, boolean>) => void;
-    /** Opt-in interaction analytics; no telemetry is sent by the viewer. */
-    onEngagement?: (event: ViewerEngagementEvent) => void | Promise<void>;
-    /** Log engagement events in the developer console. Default `false`. */
-    debugEngagement?: boolean;
-    /** The camera moved. Fires often while the user orbits, pans or zooms. */
-    onCameraChange?: (state: ViewerCameraState) => void;
-    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;
-    camera?: ViewerCameraConfig;
-    cameraLimits?: CameraLimits;
-    backgroundColor?: string;
-    shadows?: boolean;
-    showObjectBindingDataPanel?: boolean;
-    customObjectBindingDataPanel?: (props: CustomObjectBindingDataPanelProps) => ReactNode;
-    customSceneObjectsPanel?: (props: CustomSceneObjectsPanelProps) => ReactNode;
-    showSceneObjectsPanel?: boolean;
-    showDownloadButton?: boolean;
-    downloadFilename?: string;
-    showResetButton?: boolean;
-    /** Fullscreen action button; grouped form: `ui.fullscreen`. Default `false`. */
-    showFullscreenButton?: boolean;
-    showLoadingOverlay?: boolean;
-    showMouseController?: boolean;
-    mouseControllerPosition?: MouseControllerPosition;
-    mouseControllerOpacity?: number;
-    moveSensitivity?: number;
-    zoomSensitivity?: number;
-    sceneConfig?: SceneConfig;
-    disableZoom?: boolean;
-    zoomOnSelected?: boolean;
-    highlightOnHover?: boolean;
-    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;
-    meshopt?: boolean;
-    showMeasureTools?: boolean;
-    showUvCheckerButton?: boolean;
-    showExplodeControls?: boolean;
-    isolation?: ViewerIsolation | null;
-    onIsolationChange?: (isolation: ViewerIsolation | null) => void;
-    showIsolateControls?: boolean;
-    showSectionTools?: boolean;
-    /**
-     * Lets visitors choose from `sceneConfig.product`, in a panel over the model.
-     * `true` uses the defaults; an object connects services, links and callbacks.
-     */
-    productOptions?: boolean | ViewerProductOptions;
-    showMaterialVariants?: boolean;
-    showObjectNavigator?: boolean;
-    cinematic?: boolean | CinematicConfig;
-    measurementUnit?: string;
-    /** Controlled named measurements; otherwise sceneConfig.measurements or local state. */
-    measurements?: SavedMeasurement[];
-    onMeasurementsChange?: (measurements: SavedMeasurement[]) => void;
-    /** Authored/display units and optional metres-per-unit calibration. */
-    measurementSettings?: MeasurementSettings;
-    /** Stable asset id for measurements when uploaded files receive new blob URLs. */
-    measurementModelId?: string;
-    onMeasurementSettingsChange?: (settings: MeasurementSettings) => void;
-    enableXR?: boolean;
-    usdzUrl?: string;
-    arScaleMode?: XRScaleMode;
-    mobileHandoffUrl?: string;
-    /** Prepare the edited configuration for USDZ and phone handoff. Opt-in. */
-    arHandoff?: boolean | ARHandoffOptions;
-    /** Receive sequence controls on load, or null when disconnected. */
-    onSequencesReady?: (controls: SequenceControls | null) => void;
-    /** Show a compact player when sceneConfig contains sequences. Default true. */
-    showSequenceControls?: boolean;
-    /** Honor sequence autoPlay flags. Default true; reduced motion disables autoplay. */
-    sequenceAutoPlay?: boolean;
-    showAnnotationNavigation?: boolean;
-    showAnnotationOnHover?: boolean;
-    showAnnotationFilters?: boolean;
-    annotationCategories?: string[] | null;
-    onAnnotationCategoriesChange?: (categories: string[] | null) => void;
-    onSceneConfigChange?: (config: SceneConfig) => void;
-    showViewGizmo?: boolean;
-    /**
-     * Your own UI over the 3D view: badges, HUDs, custom panels. It sits above
-     * the model and below the viewer's toolbars. The layer lets pointer events
-     * through to the model; its direct children receive them, so position them
-     * yourself (for example `position: "absolute"`).
-     */
-    overlay?: ReactNode;
-    /**
-     * react-three-fiber elements rendered inside the scene, for anything the
-     * viewer can't do itself. They work with three.js directly, so they're
-     * outside the viewer's own API and can break when three.js or
-     * react-three-fiber change.
-     */
-    unsafe_sceneChildren?: ReactNode;
-    autoRotate?: boolean;
-    autoRotateSpeed?: number;
-    /**
-     * Texture positioning for objects with an uploaded texture: Offset and
-     * Rotation fields in the Change Material panel, and Move/Zoom mode on
-     * double-click (drag to move, scroll to scale). Off by default. Pass `true`,
-     * or an object to take over parts of it; changes are written to the
-     * 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 instance (id ?? url). */
-    models?: ModelViewerModelEntry[];
-    /** Select an explicit instance ID, allowing several entries to reuse one URL. */
-    activeModelId?: string;
-    /** Instance switcher callback; preferred over onModelChange in ID mode. */
-    onActiveModelChange?: (id: string) => void;
-    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;
-    /** Stable unique instance identity. Required when URLs repeat. Object IDs stay local to each instance. */
-    id?: string;
-    /** Whole-asset placement; independent of node transforms and scene model rotation. */
-    transform?: AssetTransform;
-    /** Hide this whole instance without changing its object bindings. */
-    visible?: boolean;
-    /** 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 { MATERIAL_SIDES as $, type ARExportOptions as A, type BindingEdit as B, type CameraAction as C, type ComparisonCategory as D, type ComparisonChange as E, type ComparisonHighlight as F, type ComparisonObject as G, type ComparisonStatus as H, type ConfigurationComparisonInput as I, type ConfigurationComparisonReport as J, type CustomObjectBindingDataPanelProps as K, type CustomSceneObjectsPanelProps as L, DEFAULT_SCENE_CONFIG as M, DEFAULT_SECTION_CONFIG as N, type DecalMoveTarget as O, type DeepPartial as P, type EnvironmentPreset as Q, type GlitchModeName as R, type GroupedModelViewerProps as S, type HomeCameraState as T, type InspectAssetOptions as U, type IsolatedObjectBindings as V, type IsolationActionEffect as W, type KernelSizeName as X, type LicenseResult as Y, type LicenseStatus as Z, MATERIAL_BLENDING_MODES as _, type ARHandoffOptions as a, type ProductPrice as a$, MAX_VIEWER_STATE_BYTES as a0, MODEL_VIEWER_PRESETS as a1, type MeasurementAnchor as a2, type MeasurementCollection as a3, type MeasurementPoint as a4, type MeasurementPosition as a5, type MeasurementResult as a6, type MeasurementSettings as a7, type MeasurementStatus as a8, type MeasurementTool as a9, type ObjectBindingTarget as aA, type ObjectBindingTextureChannel as aB, type ObjectBindingTextureSlot as aC, type ObjectBindingTransform as aD, type ObjectBindingType as aE, type ObjectBindingsActionEffect as aF, type ObjectPointerEvent as aG, type ObjectSurfacePoint as aH, type ObjectTransformSpace as aI, type PerformanceProfile as aJ, type ProductAppearance as aK, type ProductAvailability as aL, type ProductCheckoutContext as aM, type ProductCheckoutLink as aN, type ProductCommerceAdapter as aO, type ProductCommerceContext as aP, type ProductCommerceResult as aQ, type ProductConfiguration as aR, type ProductConfigurationIssue as aS, type ProductDefinition as aT, type ProductDefinitionWarning as aU, type ProductGroupDisplay as aV, type ProductOption as aW, type ProductOptionGroup as aX, type ProductOptionRef as aY, type ProductOptionRule as aZ, type ProductOptionState as a_, type MeasurementUnit as aa, type ModelMergeSource as ab, type ModelViewerControlsOptions as ac, type ModelViewerDecoderOptions as ad, type ModelViewerModelEntry as ae, type ModelViewerPerfOptions as af, type ModelViewerPreset as ag, type ModelViewerProps as ah, type ModelViewerTilesOptions as ai, type ModelViewerToolsOptions as aj, type ModelViewerUiOptions as ak, type ModelViewerXrOptions as al, type MouseControllerPosition as am, type ObjectActionEffect as an, type ObjectActionEvent as ao, type ObjectBinding as ap, type ObjectBindingAction as aq, type ObjectBindingCameraState as ar, type ObjectBindingDecal as as, type ObjectBindingMaterial as at, type ObjectBindingMaterialBlendingMode as au, type ObjectBindingMaterialSide as av, type ObjectBindingPatch as aw, type ObjectBindingSelector as ax, type ObjectBindingStatus as ay, type ObjectBindingStyle as az, type ARHandoffRequest as b, type ViewerCameraProps as b$, type ProductPricing as b0, type ProductSelections as b1, type ProductSku as b2, type RampTypeName as b3, type RendererBackend as b4, type SavedMeasurement as b5, type SceneAnimationClipConfig as b6, type SceneAnimationConfig as b7, type SceneAnnotationCameraView as b8, type SceneAnnotationImage as b9, type SceneSequence as bA, type SceneShadowConfig as bB, type SceneStyleColorScale as bC, type SceneStyleCondition as bD, type SceneStylePulse as bE, type SceneStyleRule as bF, type SceneWireframeConfig as bG, type SemanticComparisonOptions as bH, type SequenceCameraView as bI, type SequenceControls as bJ, type SequenceEasing as bK, type SequenceKeyframe as bL, type SequenceObjectProperty as bM, type SequencePlaybackState as bN, type SequenceTarget as bO, type SequenceTrack as bP, type SequenceValue as bQ, type SequenceVector3 as bR, type ShareableViewerState as bS, type StreamingDiagnostics as bT, type StyledObjectBindings as bU, type StyledObjectPulse as bV, type TexturePositioningControls as bW, type UseViewerCameraOptions as bX, type ViewerAnimationsProps as bY, type ViewerCameraConfig as bZ, type ViewerCameraPreset as b_, type SceneAnnotationLink as ba, type SceneAnnotationMarker as bb, type SceneBackgroundConfig as bc, type SceneCameraConfig as bd, type SceneCinematicConfig as be, type SceneCinematicWaypoint as bf, type SceneComposition as bg, type SceneConfig as bh, type SceneConfigActionEffect as bi, type SceneConfigPatch as bj, type SceneEnvironmentConfig as bk, type SceneGroundShadowConfig as bl, type SceneLight as bm, type SceneLightAttachment as bn, type SceneLightType as bo, type SceneLightingConfig as bp, type SceneModelConfig as bq, type SceneModelRenderer as br, type ScenePostProcessingConfig as bs, type SceneProductConfig as bt, type SceneSectionAxis as bu, type SceneSectionConfig as bv, type SceneSectionPlane as bw, type SceneSectionPreset as bx, type SceneSectionSettings as by, type SceneSelectionSet as bz, type ARHandoffStatus as c, type ViewerCameraState as c0, type ViewerConfiguration as c1, type ViewerEngagementEvent as c2, type ViewerIsolation as c3, type ViewerObjectInfo as c4, type ViewerProductOptions as c5, type ViewerReadyState as c6, type ViewerRuntimeStats as c7, type ViewerStateStorage as c8, type VisibilityActionEffect as c9, type XRScaleMode as ca, applyIsolation as cb, applyStyleRules as cc, colorScaleValue as cd, compareViewerConfigurations as ce, groundAsset as cf, isolatedBindingKeys as cg, material as ch, parseAssetTransform as ci, parseSelectionSets as cj, parseViewerState as ck, patchBindings as cl, patchSceneConfig as cm, prepareViewerState as cn, selectBindingKeys as co, selectBindings as cp, serializeViewerState as cq, snapAssetToGrid as cr, useViewerAnimations as cs, useViewerCamera as ct, type ARSnapshot as d, type ARSnapshotSource as e, type AnimationAction as f, type AnimationActionEffect as g, type AnimationClipInfo as h, type AnimationClipState as i, type AnimationClipStatus as j, type AnimationControls as k, type AnimationLoopMode as l, type AnimationPlayOptions as m, type AnimationPlaybackState as n, type AnnotationMarker as o, type AssetDiagnosticIssue as p, type AssetDiagnosticsReport as q, type AssetDiagnosticsSource as r, type AssetTextureDiagnostic as s, type AssetTransform as t, type CameraActionEffect as u, type CameraControllerType as v, type CaptureImageOptions as w, type CaptureVideoOptions as x, type CinematicConfig as y, type CinematicWaypoint as z };