mujoco-react 10.2.1 → 10.4.0

package/dist/spark.d.ts

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as _sparkjsdev_spark from '@sparkjsdev/spark';
-import { n as SplatEnvironmentProps, q as PairedSplatEnvironmentConfig, S as SceneConfig, t as SplatEnvironmentReadiness, o as VisualScenarioConfig } from './types-B-J8fpPP.js';
+import { o as SplatEnvironmentProps, r as PairedSplatEnvironmentConfig, S as SceneConfig, u as SplatEnvironmentReadiness, p as VisualScenarioConfig } from './types-CdFZCYmy.js';
 import 'react';
 import '@react-three/fiber';
 import 'three';

package/dist/spark.js

@@ -1,4 +1,4 @@
-import { useSplatSceneConfig, useSplatEnvironment, SplatEnvironment, CAMERA_FRAME_CAPTURE_RENDER_USER_DATA_KEY } from './chunk-CYDGWNKQ.js';
+import { useSplatSceneConfig, useSplatEnvironment, SplatEnvironment, CAMERA_FRAME_CAPTURE_RENDER_USER_DATA_KEY } from './chunk-FBXXXPLQ.js';
 import { useThree } from '@react-three/fiber';
 import { useMemo, useState, useEffect, useCallback, useRef } from 'react';
 import * as THREE from 'three';
@@ -190,6 +190,9 @@ function SparkSplatEnvironment({
   const onErrorRef = useRef(onError);
   const [status, setStatus] = useState("idle");
   const { gl, invalidate } = useThree();
+  onStatusChangeRef.current = onStatusChange;
+  onLoadRef.current = onLoad;
+  onErrorRef.current = onError;
   const metadata = useSplatEnvironment({
     environment,
     scenario,
@@ -221,15 +224,6 @@ function SparkSplatEnvironment({
       lod
     ]
   );
-  useEffect(() => {
-    onStatusChangeRef.current = onStatusChange;
-  }, [onStatusChange]);
-  useEffect(() => {
-    onLoadRef.current = onLoad;
-  }, [onLoad]);
-  useEffect(() => {
-    onErrorRef.current = onError;
-  }, [onError]);
   useEffect(() => {
     let disposed = false;
     ensureSparkDisposeRejectionHandler();

package/dist/spark.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/spark.tsx"],"names":[],"mappings":"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","file":"spark.js","sourcesContent":["/**\n * @license\n * SPDX-License-Identifier: Apache-2.0\n */\n\nimport { useThree } from '@react-three/fiber';\nimport {\n  useCallback,\n  useEffect,\n  useMemo,\n  useRef,\n  useState,\n} from 'react';\nimport * as THREE from 'three';\nimport {\n  SplatEnvironment,\n  useSplatEnvironment,\n  useSplatSceneConfig,\n} from './components/VisualScenario';\nimport {\n  CAMERA_FRAME_CAPTURE_RENDER_USER_DATA_KEY,\n} from './rendering/cameraFrameCapture';\nimport type {\n  CameraFrameCaptureRenderInput,\n  CameraFrameCaptureRenderResult,\n} from './rendering/cameraFrameCapture';\nimport type {\n  PairedSplatEnvironmentConfig,\n  SceneConfig,\n  SplatEnvironmentProps,\n  SplatEnvironmentReadiness,\n  VisualScenarioConfig,\n} from './types';\n\ntype SparkModule = typeof import('@sparkjsdev/spark');\ntype SparkRendererInstance = InstanceType<SparkModule['SparkRenderer']>;\ntype SparkSplatMeshInstance = InstanceType<SparkModule['SplatMesh']>;\ntype SparkDisposable = {\n  dispose?: () => unknown;\n};\ntype SparkCaptureRenderer = {\n  renderer: SparkRendererInstance;\n  width: number;\n  height: number;\n};\ntype SparkWorkerMessage = {\n  reject?: (error: unknown) => void;\n};\ntype SparkWorkerLike = {\n  messages?: Record<string, SparkWorkerMessage>;\n};\ntype SparkResourceWithWorkers = SparkDisposable & {\n  worker?: SparkWorkerLike;\n  sortWorker?: SparkWorkerLike;\n  lodWorker?: SparkWorkerLike;\n};\n\nexport type SparkSplatStatus = 'idle' | 'loading' | 'ready' | 'error';\n\nlet sparkDisposeRejectionHandlerRegistered = false;\n\nexport interface SparkSplatRenderTuning {\n  /** Scale Spark's LoD splat budget for the live viewport. */\n  lodSplatScale?: number;\n  /** Minimum rendered LoD splat size. Higher values trade detail for speed. */\n  lodRenderScale?: number;\n  /** Minimum delay between Spark sort passes for the live viewport. */\n  minSortIntervalMs?: number;\n}\n\nexport interface SparkSplatCaptureTuning extends SparkSplatRenderTuning {\n  /** Maximum animation frames to wait for first-capture Spark warm-up. Default: 4. */\n  maxWarmupFrames?: number;\n  /** Number of pixels sampled when deciding whether a capture is blank. Default: 512. */\n  blankSampleCount?: number;\n  /** Alpha threshold used by the blank-capture detector. Default: 8. */\n  blankAlphaThreshold?: number;\n  /** Minimum visible sampled-pixel ratio before retrying capture. Default: 0.02. */\n  blankVisibleRatio?: number;\n  /** Minimum average sampled RGB sum before retrying capture. Default: 3. */\n  blankAverageColor?: number;\n}\n\ntype ResolvedSparkSplatCaptureTuning = Required<\n  Pick<\n    SparkSplatCaptureTuning,\n    | 'maxWarmupFrames'\n    | 'blankSampleCount'\n    | 'blankAlphaThreshold'\n    | 'blankVisibleRatio'\n    | 'blankAverageColor'\n  >\n> &\n  SparkSplatRenderTuning;\n\nfunction getDefaultLiveRenderTuning(\n  lod: SparkSplatEnvironmentProps['lod']\n): SparkSplatRenderTuning {\n  return {\n    lodSplatScale: lod === false ? undefined : lod === 'quality' ? 1 : 0.6,\n    lodRenderScale: lod === false || lod === 'quality' ? undefined : 1.2,\n    minSortIntervalMs: lod === false ? 0 : lod === 'quality' ? 32 : 80,\n  };\n}\n\nfunction getDefaultCaptureTuning(\n  lod: SparkSplatEnvironmentProps['lod']\n): ResolvedSparkSplatCaptureTuning {\n  return {\n    lodSplatScale: lod === false ? undefined : lod === 'quality' ? 1.25 : 1.15,\n    lodRenderScale: lod === false ? undefined : 0.6,\n    minSortIntervalMs: 0,\n    maxWarmupFrames: 4,\n    blankSampleCount: 512,\n    blankAlphaThreshold: 8,\n    blankVisibleRatio: 0.02,\n    blankAverageColor: 3,\n  };\n}\n\nfunction resolveRenderTuning(\n  defaults: SparkSplatRenderTuning,\n  tuning: SparkSplatRenderTuning | undefined\n): SparkSplatRenderTuning {\n  return {\n    lodSplatScale: tuning?.lodSplatScale ?? defaults.lodSplatScale,\n    lodRenderScale: tuning?.lodRenderScale ?? defaults.lodRenderScale,\n    minSortIntervalMs: tuning?.minSortIntervalMs ?? defaults.minSortIntervalMs,\n  };\n}\n\nfunction resolveCaptureTuning(\n  lod: SparkSplatEnvironmentProps['lod'],\n  tuning: SparkSplatCaptureTuning | undefined\n): ResolvedSparkSplatCaptureTuning {\n  const defaults = getDefaultCaptureTuning(lod);\n  return {\n    ...resolveRenderTuning(defaults, tuning),\n    maxWarmupFrames: tuning?.maxWarmupFrames ?? defaults.maxWarmupFrames,\n    blankSampleCount: tuning?.blankSampleCount ?? defaults.blankSampleCount,\n    blankAlphaThreshold:\n      tuning?.blankAlphaThreshold ?? defaults.blankAlphaThreshold,\n    blankVisibleRatio: tuning?.blankVisibleRatio ?? defaults.blankVisibleRatio,\n    blankAverageColor: tuning?.blankAverageColor ?? defaults.blankAverageColor,\n  };\n}\n\nfunction waitForNextAnimationFrame() {\n  return new Promise<void>((resolve) => {\n    requestAnimationFrame(() => resolve());\n  });\n}\n\nfunction isMostlyBlankCapture(\n  pixels: Uint8Array,\n  tuning: ResolvedSparkSplatCaptureTuning\n) {\n  const sampleCount = Math.max(1, Math.floor(tuning.blankSampleCount));\n  const stride = Math.max(4, Math.floor(pixels.length / sampleCount / 4) * 4);\n  let sampled = 0;\n  let visible = 0;\n  let colorTotal = 0;\n\n  for (let i = 0; i < pixels.length; i += stride) {\n    const alpha = pixels[i + 3];\n    const color = pixels[i] + pixels[i + 1] + pixels[i + 2];\n    sampled += 1;\n    if (alpha > tuning.blankAlphaThreshold) visible += 1;\n    colorTotal += color;\n  }\n\n  if (sampled === 0) return true;\n  return (\n    visible / sampled < tuning.blankVisibleRatio ||\n    colorTotal / sampled < tuning.blankAverageColor\n  );\n}\n\nexport interface SparkSplatLifecycle {\n  status: SparkSplatStatus;\n  error: Error | null;\n  isLoading: boolean;\n  isReady: boolean;\n  isError: boolean;\n  props: Pick<SparkSplatEnvironmentProps, 'onStatusChange' | 'onError'>;\n  reset: () => void;\n}\n\nexport interface SparkSplatEnvironmentState {\n  environment: PairedSplatEnvironmentConfig | undefined;\n  sceneConfig: SceneConfig;\n  readiness: SplatEnvironmentReadiness;\n  lifecycle: SparkSplatLifecycle;\n  props: Pick<\n    SparkSplatEnvironmentProps,\n    'environment' | 'scenario' | 'src' | 'format' | 'onStatusChange' | 'onError'\n  >;\n  enabled: boolean;\n}\n\nexport interface SparkSplatEnvironmentProps extends SplatEnvironmentProps {\n  /** Enable Spark LoD handling for large splat assets. Default: true. */\n  lod?: boolean | 'quality';\n  /** Tune Spark's live viewport renderer. Defaults favor interactive FPS. */\n  renderTuning?: SparkSplatRenderTuning;\n  /** Tune Spark camera-frame capture. Defaults favor sharper snapshots. */\n  captureTuning?: SparkSplatCaptureTuning;\n  /**\n   * Hide meshes whose names include floor, ground, or plane while the splat is\n   * active. This mirrors the common hybrid-rendering setup where MJCF keeps\n   * collision geometry but the splat owns the visual environment.\n   */\n  hideGroundMeshes?: boolean;\n  onStatusChange?: (status: SparkSplatStatus) => void;\n  onLoad?: (mesh: SparkSplatMeshInstance) => void;\n  onError?: (error: Error) => void;\n}\n\n/**\n * Resolve a visual scenario's paired splat environment, compose its MJCF\n * collision proxy into the MuJoCo scene config, and expose Spark lifecycle\n * props for `<SparkSplatEnvironment />`.\n */\nexport function useSparkSplatEnvironment({\n  sceneConfig,\n  scenario,\n  environment,\n  enabled = true,\n  renderer = 'spark',\n  onError,\n  onStatusChange,\n}: {\n  sceneConfig: SceneConfig;\n  scenario?: VisualScenarioConfig;\n  environment?: PairedSplatEnvironmentConfig;\n  enabled?: boolean;\n  renderer?: 'spark';\n  onError?: (error: Error) => void;\n  onStatusChange?: (status: SparkSplatStatus) => void;\n}): SparkSplatEnvironmentState {\n  const splatScene = useSplatSceneConfig({\n    sceneConfig,\n    scenario,\n    environment,\n    enabled,\n    renderer,\n  });\n  const metadata = useSplatEnvironment({\n    scenario,\n    environment: splatScene.environment,\n    renderer,\n  });\n  const renderEnabled = enabled && Boolean(metadata.src);\n  const readiness = enabled ? metadata.readiness : splatScene.readiness;\n  const lifecycle = useSparkSplatLifecycle({\n    enabled: renderEnabled,\n    onError,\n    onStatusChange,\n  });\n\n  return useMemo(\n    () => ({\n      environment: splatScene.environment,\n      sceneConfig: splatScene.sceneConfig,\n      readiness,\n      lifecycle,\n      props: {\n        environment: splatScene.environment,\n        scenario: enabled ? scenario : undefined,\n        src: enabled ? metadata.src : undefined,\n        format: metadata.format,\n        ...lifecycle.props,\n      },\n      enabled: renderEnabled,\n    }),\n    [enabled, lifecycle, metadata, readiness, renderEnabled, scenario, splatScene]\n  );\n}\n\n/**\n * Tracks Spark 3DGS loading state for UI that wraps `SparkSplatEnvironment`.\n *\n * Use the returned `props` with `<SparkSplatEnvironment {...lifecycle.props} />`\n * to avoid repeating status/error state in app code.\n */\nexport function useSparkSplatLifecycle({\n  enabled = true,\n  initialStatus,\n  onError,\n  onStatusChange,\n}: {\n  enabled?: boolean;\n  initialStatus?: SparkSplatStatus;\n  onError?: (error: Error) => void;\n  onStatusChange?: (status: SparkSplatStatus) => void;\n} = {}): SparkSplatLifecycle {\n  const [status, setStatus] = useState<SparkSplatStatus>(\n    initialStatus ?? (enabled ? 'loading' : 'idle')\n  );\n  const [error, setError] = useState<Error | null>(null);\n\n  useEffect(() => {\n    setStatus(enabled ? initialStatus ?? 'loading' : 'idle');\n    setError(null);\n  }, [enabled, initialStatus]);\n\n  const handleStatusChange = useCallback(\n    (nextStatus: SparkSplatStatus) => {\n      setStatus(nextStatus);\n      if (nextStatus !== 'error') {\n        setError(null);\n      }\n      onStatusChange?.(nextStatus);\n    },\n    [onStatusChange]\n  );\n\n  const handleError = useCallback(\n    (nextError: Error) => {\n      setError(nextError);\n      setStatus('error');\n      onError?.(nextError);\n    },\n    [onError]\n  );\n\n  const reset = useCallback(() => {\n    setStatus(enabled ? initialStatus ?? 'loading' : 'idle');\n    setError(null);\n  }, [enabled, initialStatus]);\n\n  return useMemo(\n    () => ({\n      status,\n      error,\n      isLoading: status === 'loading',\n      isReady: status === 'ready',\n      isError: status === 'error',\n      props: {\n        onStatusChange: handleStatusChange,\n        onError: handleError,\n      },\n      reset,\n    }),\n    [error, handleError, handleStatusChange, reset, status]\n  );\n}\n\n/**\n * Optional SparkJS-backed Gaussian splat renderer for React Three Fiber scenes.\n *\n * Import from `mujoco-react/spark` and install `@sparkjsdev/spark` in the app\n * that uses it. The core `mujoco-react` entrypoint does not depend on Spark.\n */\nexport function SparkSplatEnvironment({\n  environment,\n  scenario,\n  renderer = 'spark',\n  src,\n  format,\n  collisionProxy,\n  collisionProxyMetadata,\n  showPlaceholder,\n  children,\n  lod = true,\n  renderTuning,\n  captureTuning,\n  hideGroundMeshes = false,\n  onStatusChange,\n  onLoad,\n  onError,\n  ...groupProps\n}: SparkSplatEnvironmentProps) {\n  const groupRef = useRef<THREE.Group>(null);\n  const sparkRef = useRef<SparkRendererInstance | null>(null);\n  const captureSparkRef = useRef<SparkCaptureRenderer | null>(null);\n  const meshRef = useRef<SparkSplatMeshInstance | null>(null);\n  const hiddenMeshesRef = useRef<THREE.Mesh[]>([]);\n  const onStatusChangeRef = useRef(onStatusChange);\n  const onLoadRef = useRef(onLoad);\n  const onErrorRef = useRef(onError);\n  const [status, setStatus] = useState<SparkSplatStatus>('idle');\n  const { gl, invalidate } = useThree();\n  const metadata = useSplatEnvironment({\n    environment,\n    scenario,\n    renderer,\n    src,\n    format,\n    collisionProxy: collisionProxyMetadata,\n  });\n  const resolvedRenderTuning = useMemo(\n    () => resolveRenderTuning(getDefaultLiveRenderTuning(lod), renderTuning),\n    [\n      lod,\n      renderTuning?.lodRenderScale,\n      renderTuning?.lodSplatScale,\n      renderTuning?.minSortIntervalMs,\n    ]\n  );\n  const resolvedCaptureTuning = useMemo(\n    () => resolveCaptureTuning(lod, captureTuning),\n    [\n      captureTuning?.blankAlphaThreshold,\n      captureTuning?.blankAverageColor,\n      captureTuning?.blankSampleCount,\n      captureTuning?.blankVisibleRatio,\n      captureTuning?.lodRenderScale,\n      captureTuning?.lodSplatScale,\n      captureTuning?.maxWarmupFrames,\n      captureTuning?.minSortIntervalMs,\n      lod,\n    ]\n  );\n\n  useEffect(() => {\n    onStatusChangeRef.current = onStatusChange;\n  }, [onStatusChange]);\n\n  useEffect(() => {\n    onLoadRef.current = onLoad;\n  }, [onLoad]);\n\n  useEffect(() => {\n    onErrorRef.current = onError;\n  }, [onError]);\n\n  useEffect(() => {\n    let disposed = false;\n    ensureSparkDisposeRejectionHandler();\n\n    function setLifecycleStatus(nextStatus: SparkSplatStatus) {\n      setStatus(nextStatus);\n      onStatusChangeRef.current?.(nextStatus);\n    }\n\n    function restoreHiddenMeshes() {\n      for (const mesh of hiddenMeshesRef.current) {\n        mesh.visible = true;\n      }\n      hiddenMeshesRef.current = [];\n    }\n\n    function disposeCaptureSpark() {\n      safelyDisposeSparkResource(captureSparkRef.current?.renderer);\n      captureSparkRef.current = null;\n    }\n\n    async function loadSplat() {\n      if (!metadata.src) {\n        setLifecycleStatus('idle');\n        return;\n      }\n\n      if (metadata.format !== 'spz') {\n        const unsupportedFormatError = new Error(\n          `SparkSplatEnvironment only supports .spz assets; received \"${metadata.format}\".`\n        );\n        setLifecycleStatus('error');\n        onErrorRef.current?.(unsupportedFormatError);\n        return;\n      }\n\n      setLifecycleStatus('loading');\n\n      try {\n        const sparkModule = await import('@sparkjsdev/spark');\n        if (disposed || !groupRef.current) return;\n\n        const spark = new sparkModule.SparkRenderer({\n          renderer: gl,\n          onDirty: invalidate,\n          ...resolvedRenderTuning,\n        });\n        spark.userData[CAMERA_FRAME_CAPTURE_RENDER_USER_DATA_KEY] = async ({\n          scene,\n          camera,\n          width,\n          height,\n        }: CameraFrameCaptureRenderInput): Promise<CameraFrameCaptureRenderResult> => {\n          let captureSpark = captureSparkRef.current;\n          if (\n            !captureSpark ||\n            captureSpark.width !== width ||\n            captureSpark.height !== height\n          ) {\n            disposeCaptureSpark();\n            captureSpark = {\n              renderer: new sparkModule.SparkRenderer({\n                renderer: gl,\n                autoUpdate: false,\n                lodSplatScale: resolvedCaptureTuning.lodSplatScale,\n                lodRenderScale: resolvedCaptureTuning.lodRenderScale,\n                minSortIntervalMs: resolvedCaptureTuning.minSortIntervalMs,\n                target: {\n                  width,\n                  height,\n                },\n              }),\n              width,\n              height,\n            };\n            captureSparkRef.current = captureSpark;\n          }\n\n          const captureRenderer = captureSpark.renderer;\n          const maxWarmupFrames = Math.max(\n            1,\n            Math.floor(resolvedCaptureTuning.maxWarmupFrames)\n          );\n          let pixels: Uint8Array | undefined;\n          for (let attempt = 0; attempt < maxWarmupFrames; attempt += 1) {\n            captureRenderer.renderSize.set(width, height);\n            await captureRenderer.update({ scene, camera });\n            pixels = await captureRenderer.renderReadTarget({\n              scene,\n              camera,\n            });\n            if (\n              captureRenderer.activeSplats > 0 &&\n              !isMostlyBlankCapture(pixels, resolvedCaptureTuning)\n            ) {\n              break;\n            }\n            if (attempt < maxWarmupFrames - 1) {\n              await waitForNextAnimationFrame();\n            }\n          }\n          if (!pixels) {\n            throw new Error('Spark camera frame capture did not produce pixels.');\n          }\n          return { pixels, width, height, flipY: true };\n        };\n        const mesh = new sparkModule.SplatMesh({\n          url: metadata.src,\n          lod,\n        });\n        mesh.name = 'GaussianSplatMesh';\n\n        groupRef.current.add(spark);\n        groupRef.current.add(mesh);\n        sparkRef.current = spark;\n        meshRef.current = mesh;\n\n        if (hideGroundMeshes && groupRef.current.parent) {\n          groupRef.current.parent.traverse((object) => {\n            if (\n              !(object instanceof THREE.Mesh) ||\n              object === (mesh as unknown as THREE.Object3D)\n            ) {\n              return;\n            }\n            const name = object.name.toLowerCase();\n            if (\n              name.includes('floor') ||\n              name.includes('ground') ||\n              name.includes('plane')\n            ) {\n              object.visible = false;\n              hiddenMeshesRef.current.push(object);\n            }\n          });\n        }\n\n        await mesh.initialized;\n        if (disposed) return;\n        setLifecycleStatus('ready');\n        onLoadRef.current?.(mesh);\n        invalidate();\n      } catch (error) {\n        const normalizedError =\n          error instanceof Error ? error : new Error(String(error));\n        setLifecycleStatus('error');\n        onErrorRef.current?.(normalizedError);\n      }\n    }\n\n    void loadSplat();\n\n    return () => {\n      disposed = true;\n      restoreHiddenMeshes();\n\n      if (meshRef.current) {\n        groupRef.current?.remove(meshRef.current);\n        safelyDisposeSparkResource(meshRef.current);\n        meshRef.current = null;\n      }\n\n      if (sparkRef.current) {\n        groupRef.current?.remove(sparkRef.current);\n        safelyDisposeSparkResource(sparkRef.current);\n        sparkRef.current = null;\n      }\n\n      disposeCaptureSpark();\n    };\n  }, [\n    gl,\n    hideGroundMeshes,\n    invalidate,\n    lod,\n    metadata.format,\n    metadata.src,\n    resolvedCaptureTuning.blankAlphaThreshold,\n    resolvedCaptureTuning.blankAverageColor,\n    resolvedCaptureTuning.blankSampleCount,\n    resolvedCaptureTuning.blankVisibleRatio,\n    resolvedCaptureTuning.lodRenderScale,\n    resolvedCaptureTuning.lodSplatScale,\n    resolvedCaptureTuning.maxWarmupFrames,\n    resolvedCaptureTuning.minSortIntervalMs,\n    resolvedRenderTuning.lodRenderScale,\n    resolvedRenderTuning.lodSplatScale,\n    resolvedRenderTuning.minSortIntervalMs,\n  ]);\n\n  return (\n    <SplatEnvironment\n      {...groupProps}\n      environment={environment}\n      scenario={scenario}\n      renderer={renderer}\n      src={metadata.src}\n      format={metadata.format}\n      collisionProxyMetadata={metadata.collisionProxy}\n      collisionProxy={collisionProxy}\n      showPlaceholder={showPlaceholder ?? status !== 'ready'}\n    >\n      <group ref={groupRef} />\n      {children}\n    </SplatEnvironment>\n  );\n}\n\nfunction safelyDisposeSparkResource(\n  resource: SparkDisposable | null | undefined\n) {\n  if (!resource) return;\n  try {\n    silenceSparkWorkerTerminateRejections(resource);\n    const result = resource.dispose?.();\n    if (isPromiseLike(result)) {\n      void Promise.resolve(result).catch(handleSparkDisposeError);\n    }\n  } catch (error) {\n    handleSparkDisposeError(error);\n  }\n}\n\nfunction isPromiseLike(value: unknown): value is PromiseLike<unknown> {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    'then' in value &&\n    typeof (value as { then?: unknown }).then === 'function'\n  );\n}\n\nfunction silenceSparkWorkerTerminateRejections(resource: SparkDisposable) {\n  const workers = getSparkWorkers(resource);\n  for (const worker of workers) {\n    if (!worker.messages) continue;\n\n    for (const message of Object.values(worker.messages)) {\n      const reject = message.reject;\n      if (!reject) continue;\n\n      message.reject = (error: unknown) => {\n        if (!isSparkWorkerTerminateError(error)) {\n          reject(error);\n        }\n      };\n    }\n  }\n}\n\nfunction getSparkWorkers(resource: SparkDisposable): SparkWorkerLike[] {\n  const sparkResource = resource as SparkResourceWithWorkers;\n  return [\n    sparkResource.worker,\n    sparkResource.sortWorker,\n    sparkResource.lodWorker,\n  ].filter((worker): worker is SparkWorkerLike => Boolean(worker));\n}\n\nfunction handleSparkDisposeError(error: unknown) {\n  if (\n    error instanceof Error &&\n    error.message.toLowerCase().includes('worker terminate')\n  ) {\n    return;\n  }\n\n  console.warn('[mujoco-react] Spark resource disposal failed.', error);\n}\n\nfunction ensureSparkDisposeRejectionHandler() {\n  if (\n    sparkDisposeRejectionHandlerRegistered ||\n    typeof window === 'undefined' ||\n    typeof window.addEventListener !== 'function'\n  ) {\n    return;\n  }\n\n  sparkDisposeRejectionHandlerRegistered = true;\n  window.addEventListener('unhandledrejection', (event) => {\n    if (isSparkWorkerTerminateError(event.reason)) {\n      event.preventDefault();\n    }\n  });\n}\n\nfunction isSparkWorkerTerminateError(reason: unknown) {\n  return (\n    reason instanceof Error &&\n    reason.message.toLowerCase().includes('worker terminate')\n  );\n}\n"]}
+{"version":3,"sources":["../src/spark.tsx"],"names":[],"mappings":"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","file":"spark.js","sourcesContent":["/**\n * @license\n * SPDX-License-Identifier: Apache-2.0\n */\n\nimport { useThree } from '@react-three/fiber';\nimport {\n  useCallback,\n  useEffect,\n  useMemo,\n  useRef,\n  useState,\n} from 'react';\nimport * as THREE from 'three';\nimport {\n  SplatEnvironment,\n  useSplatEnvironment,\n  useSplatSceneConfig,\n} from './components/VisualScenario';\nimport {\n  CAMERA_FRAME_CAPTURE_RENDER_USER_DATA_KEY,\n} from './rendering/cameraFrameCapture';\nimport type {\n  CameraFrameCaptureRenderInput,\n  CameraFrameCaptureRenderResult,\n} from './rendering/cameraFrameCapture';\nimport type {\n  PairedSplatEnvironmentConfig,\n  SceneConfig,\n  SplatEnvironmentProps,\n  SplatEnvironmentReadiness,\n  VisualScenarioConfig,\n} from './types';\n\ntype SparkModule = typeof import('@sparkjsdev/spark');\ntype SparkRendererInstance = InstanceType<SparkModule['SparkRenderer']>;\ntype SparkSplatMeshInstance = InstanceType<SparkModule['SplatMesh']>;\ntype SparkDisposable = {\n  dispose?: () => unknown;\n};\ntype SparkCaptureRenderer = {\n  renderer: SparkRendererInstance;\n  width: number;\n  height: number;\n};\ntype SparkWorkerMessage = {\n  reject?: (error: unknown) => void;\n};\ntype SparkWorkerLike = {\n  messages?: Record<string, SparkWorkerMessage>;\n};\ntype SparkResourceWithWorkers = SparkDisposable & {\n  worker?: SparkWorkerLike;\n  sortWorker?: SparkWorkerLike;\n  lodWorker?: SparkWorkerLike;\n};\n\nexport type SparkSplatStatus = 'idle' | 'loading' | 'ready' | 'error';\n\nlet sparkDisposeRejectionHandlerRegistered = false;\n\nexport interface SparkSplatRenderTuning {\n  /** Scale Spark's LoD splat budget for the live viewport. */\n  lodSplatScale?: number;\n  /** Minimum rendered LoD splat size. Higher values trade detail for speed. */\n  lodRenderScale?: number;\n  /** Minimum delay between Spark sort passes for the live viewport. */\n  minSortIntervalMs?: number;\n}\n\nexport interface SparkSplatCaptureTuning extends SparkSplatRenderTuning {\n  /** Maximum animation frames to wait for first-capture Spark warm-up. Default: 4. */\n  maxWarmupFrames?: number;\n  /** Number of pixels sampled when deciding whether a capture is blank. Default: 512. */\n  blankSampleCount?: number;\n  /** Alpha threshold used by the blank-capture detector. Default: 8. */\n  blankAlphaThreshold?: number;\n  /** Minimum visible sampled-pixel ratio before retrying capture. Default: 0.02. */\n  blankVisibleRatio?: number;\n  /** Minimum average sampled RGB sum before retrying capture. Default: 3. */\n  blankAverageColor?: number;\n}\n\ntype ResolvedSparkSplatCaptureTuning = Required<\n  Pick<\n    SparkSplatCaptureTuning,\n    | 'maxWarmupFrames'\n    | 'blankSampleCount'\n    | 'blankAlphaThreshold'\n    | 'blankVisibleRatio'\n    | 'blankAverageColor'\n  >\n> &\n  SparkSplatRenderTuning;\n\nfunction getDefaultLiveRenderTuning(\n  lod: SparkSplatEnvironmentProps['lod']\n): SparkSplatRenderTuning {\n  return {\n    lodSplatScale: lod === false ? undefined : lod === 'quality' ? 1 : 0.6,\n    lodRenderScale: lod === false || lod === 'quality' ? undefined : 1.2,\n    minSortIntervalMs: lod === false ? 0 : lod === 'quality' ? 32 : 80,\n  };\n}\n\nfunction getDefaultCaptureTuning(\n  lod: SparkSplatEnvironmentProps['lod']\n): ResolvedSparkSplatCaptureTuning {\n  return {\n    lodSplatScale: lod === false ? undefined : lod === 'quality' ? 1.25 : 1.15,\n    lodRenderScale: lod === false ? undefined : 0.6,\n    minSortIntervalMs: 0,\n    maxWarmupFrames: 4,\n    blankSampleCount: 512,\n    blankAlphaThreshold: 8,\n    blankVisibleRatio: 0.02,\n    blankAverageColor: 3,\n  };\n}\n\nfunction resolveRenderTuning(\n  defaults: SparkSplatRenderTuning,\n  tuning: SparkSplatRenderTuning | undefined\n): SparkSplatRenderTuning {\n  return {\n    lodSplatScale: tuning?.lodSplatScale ?? defaults.lodSplatScale,\n    lodRenderScale: tuning?.lodRenderScale ?? defaults.lodRenderScale,\n    minSortIntervalMs: tuning?.minSortIntervalMs ?? defaults.minSortIntervalMs,\n  };\n}\n\nfunction resolveCaptureTuning(\n  lod: SparkSplatEnvironmentProps['lod'],\n  tuning: SparkSplatCaptureTuning | undefined\n): ResolvedSparkSplatCaptureTuning {\n  const defaults = getDefaultCaptureTuning(lod);\n  return {\n    ...resolveRenderTuning(defaults, tuning),\n    maxWarmupFrames: tuning?.maxWarmupFrames ?? defaults.maxWarmupFrames,\n    blankSampleCount: tuning?.blankSampleCount ?? defaults.blankSampleCount,\n    blankAlphaThreshold:\n      tuning?.blankAlphaThreshold ?? defaults.blankAlphaThreshold,\n    blankVisibleRatio: tuning?.blankVisibleRatio ?? defaults.blankVisibleRatio,\n    blankAverageColor: tuning?.blankAverageColor ?? defaults.blankAverageColor,\n  };\n}\n\nfunction waitForNextAnimationFrame() {\n  return new Promise<void>((resolve) => {\n    requestAnimationFrame(() => resolve());\n  });\n}\n\nfunction isMostlyBlankCapture(\n  pixels: Uint8Array,\n  tuning: ResolvedSparkSplatCaptureTuning\n) {\n  const sampleCount = Math.max(1, Math.floor(tuning.blankSampleCount));\n  const stride = Math.max(4, Math.floor(pixels.length / sampleCount / 4) * 4);\n  let sampled = 0;\n  let visible = 0;\n  let colorTotal = 0;\n\n  for (let i = 0; i < pixels.length; i += stride) {\n    const alpha = pixels[i + 3];\n    const color = pixels[i] + pixels[i + 1] + pixels[i + 2];\n    sampled += 1;\n    if (alpha > tuning.blankAlphaThreshold) visible += 1;\n    colorTotal += color;\n  }\n\n  if (sampled === 0) return true;\n  return (\n    visible / sampled < tuning.blankVisibleRatio ||\n    colorTotal / sampled < tuning.blankAverageColor\n  );\n}\n\nexport interface SparkSplatLifecycle {\n  status: SparkSplatStatus;\n  error: Error | null;\n  isLoading: boolean;\n  isReady: boolean;\n  isError: boolean;\n  props: Pick<SparkSplatEnvironmentProps, 'onStatusChange' | 'onError'>;\n  reset: () => void;\n}\n\nexport interface SparkSplatEnvironmentState {\n  environment: PairedSplatEnvironmentConfig | undefined;\n  sceneConfig: SceneConfig;\n  readiness: SplatEnvironmentReadiness;\n  lifecycle: SparkSplatLifecycle;\n  props: Pick<\n    SparkSplatEnvironmentProps,\n    'environment' | 'scenario' | 'src' | 'format' | 'onStatusChange' | 'onError'\n  >;\n  enabled: boolean;\n}\n\nexport interface SparkSplatEnvironmentProps extends SplatEnvironmentProps {\n  /** Enable Spark LoD handling for large splat assets. Default: true. */\n  lod?: boolean | 'quality';\n  /** Tune Spark's live viewport renderer. Defaults favor interactive FPS. */\n  renderTuning?: SparkSplatRenderTuning;\n  /** Tune Spark camera-frame capture. Defaults favor sharper snapshots. */\n  captureTuning?: SparkSplatCaptureTuning;\n  /**\n   * Hide meshes whose names include floor, ground, or plane while the splat is\n   * active. This mirrors the common hybrid-rendering setup where MJCF keeps\n   * collision geometry but the splat owns the visual environment.\n   */\n  hideGroundMeshes?: boolean;\n  onStatusChange?: (status: SparkSplatStatus) => void;\n  onLoad?: (mesh: SparkSplatMeshInstance) => void;\n  onError?: (error: Error) => void;\n}\n\n/**\n * Resolve a visual scenario's paired splat environment, compose its MJCF\n * collision proxy into the MuJoCo scene config, and expose Spark lifecycle\n * props for `<SparkSplatEnvironment />`.\n */\nexport function useSparkSplatEnvironment({\n  sceneConfig,\n  scenario,\n  environment,\n  enabled = true,\n  renderer = 'spark',\n  onError,\n  onStatusChange,\n}: {\n  sceneConfig: SceneConfig;\n  scenario?: VisualScenarioConfig;\n  environment?: PairedSplatEnvironmentConfig;\n  enabled?: boolean;\n  renderer?: 'spark';\n  onError?: (error: Error) => void;\n  onStatusChange?: (status: SparkSplatStatus) => void;\n}): SparkSplatEnvironmentState {\n  const splatScene = useSplatSceneConfig({\n    sceneConfig,\n    scenario,\n    environment,\n    enabled,\n    renderer,\n  });\n  const metadata = useSplatEnvironment({\n    scenario,\n    environment: splatScene.environment,\n    renderer,\n  });\n  const renderEnabled = enabled && Boolean(metadata.src);\n  const readiness = enabled ? metadata.readiness : splatScene.readiness;\n  const lifecycle = useSparkSplatLifecycle({\n    enabled: renderEnabled,\n    onError,\n    onStatusChange,\n  });\n\n  return useMemo(\n    () => ({\n      environment: splatScene.environment,\n      sceneConfig: splatScene.sceneConfig,\n      readiness,\n      lifecycle,\n      props: {\n        environment: splatScene.environment,\n        scenario: enabled ? scenario : undefined,\n        src: enabled ? metadata.src : undefined,\n        format: metadata.format,\n        ...lifecycle.props,\n      },\n      enabled: renderEnabled,\n    }),\n    [enabled, lifecycle, metadata, readiness, renderEnabled, scenario, splatScene]\n  );\n}\n\n/**\n * Tracks Spark 3DGS loading state for UI that wraps `SparkSplatEnvironment`.\n *\n * Use the returned `props` with `<SparkSplatEnvironment {...lifecycle.props} />`\n * to avoid repeating status/error state in app code.\n */\nexport function useSparkSplatLifecycle({\n  enabled = true,\n  initialStatus,\n  onError,\n  onStatusChange,\n}: {\n  enabled?: boolean;\n  initialStatus?: SparkSplatStatus;\n  onError?: (error: Error) => void;\n  onStatusChange?: (status: SparkSplatStatus) => void;\n} = {}): SparkSplatLifecycle {\n  const [status, setStatus] = useState<SparkSplatStatus>(\n    initialStatus ?? (enabled ? 'loading' : 'idle')\n  );\n  const [error, setError] = useState<Error | null>(null);\n\n  useEffect(() => {\n    setStatus(enabled ? initialStatus ?? 'loading' : 'idle');\n    setError(null);\n  }, [enabled, initialStatus]);\n\n  const handleStatusChange = useCallback(\n    (nextStatus: SparkSplatStatus) => {\n      setStatus(nextStatus);\n      if (nextStatus !== 'error') {\n        setError(null);\n      }\n      onStatusChange?.(nextStatus);\n    },\n    [onStatusChange]\n  );\n\n  const handleError = useCallback(\n    (nextError: Error) => {\n      setError(nextError);\n      setStatus('error');\n      onError?.(nextError);\n    },\n    [onError]\n  );\n\n  const reset = useCallback(() => {\n    setStatus(enabled ? initialStatus ?? 'loading' : 'idle');\n    setError(null);\n  }, [enabled, initialStatus]);\n\n  return useMemo(\n    () => ({\n      status,\n      error,\n      isLoading: status === 'loading',\n      isReady: status === 'ready',\n      isError: status === 'error',\n      props: {\n        onStatusChange: handleStatusChange,\n        onError: handleError,\n      },\n      reset,\n    }),\n    [error, handleError, handleStatusChange, reset, status]\n  );\n}\n\n/**\n * Optional SparkJS-backed Gaussian splat renderer for React Three Fiber scenes.\n *\n * Import from `mujoco-react/spark` and install `@sparkjsdev/spark` in the app\n * that uses it. The core `mujoco-react` entrypoint does not depend on Spark.\n */\nexport function SparkSplatEnvironment({\n  environment,\n  scenario,\n  renderer = 'spark',\n  src,\n  format,\n  collisionProxy,\n  collisionProxyMetadata,\n  showPlaceholder,\n  children,\n  lod = true,\n  renderTuning,\n  captureTuning,\n  hideGroundMeshes = false,\n  onStatusChange,\n  onLoad,\n  onError,\n  ...groupProps\n}: SparkSplatEnvironmentProps) {\n  const groupRef = useRef<THREE.Group>(null);\n  const sparkRef = useRef<SparkRendererInstance | null>(null);\n  const captureSparkRef = useRef<SparkCaptureRenderer | null>(null);\n  const meshRef = useRef<SparkSplatMeshInstance | null>(null);\n  const hiddenMeshesRef = useRef<THREE.Mesh[]>([]);\n  const onStatusChangeRef = useRef(onStatusChange);\n  const onLoadRef = useRef(onLoad);\n  const onErrorRef = useRef(onError);\n  const [status, setStatus] = useState<SparkSplatStatus>('idle');\n  const { gl, invalidate } = useThree();\n  onStatusChangeRef.current = onStatusChange;\n  onLoadRef.current = onLoad;\n  onErrorRef.current = onError;\n\n  const metadata = useSplatEnvironment({\n    environment,\n    scenario,\n    renderer,\n    src,\n    format,\n    collisionProxy: collisionProxyMetadata,\n  });\n  const resolvedRenderTuning = useMemo(\n    () => resolveRenderTuning(getDefaultLiveRenderTuning(lod), renderTuning),\n    [\n      lod,\n      renderTuning?.lodRenderScale,\n      renderTuning?.lodSplatScale,\n      renderTuning?.minSortIntervalMs,\n    ]\n  );\n  const resolvedCaptureTuning = useMemo(\n    () => resolveCaptureTuning(lod, captureTuning),\n    [\n      captureTuning?.blankAlphaThreshold,\n      captureTuning?.blankAverageColor,\n      captureTuning?.blankSampleCount,\n      captureTuning?.blankVisibleRatio,\n      captureTuning?.lodRenderScale,\n      captureTuning?.lodSplatScale,\n      captureTuning?.maxWarmupFrames,\n      captureTuning?.minSortIntervalMs,\n      lod,\n    ]\n  );\n\n  useEffect(() => {\n    let disposed = false;\n    ensureSparkDisposeRejectionHandler();\n\n    function setLifecycleStatus(nextStatus: SparkSplatStatus) {\n      setStatus(nextStatus);\n      onStatusChangeRef.current?.(nextStatus);\n    }\n\n    function restoreHiddenMeshes() {\n      for (const mesh of hiddenMeshesRef.current) {\n        mesh.visible = true;\n      }\n      hiddenMeshesRef.current = [];\n    }\n\n    function disposeCaptureSpark() {\n      safelyDisposeSparkResource(captureSparkRef.current?.renderer);\n      captureSparkRef.current = null;\n    }\n\n    async function loadSplat() {\n      if (!metadata.src) {\n        setLifecycleStatus('idle');\n        return;\n      }\n\n      if (metadata.format !== 'spz') {\n        const unsupportedFormatError = new Error(\n          `SparkSplatEnvironment only supports .spz assets; received \"${metadata.format}\".`\n        );\n        setLifecycleStatus('error');\n        onErrorRef.current?.(unsupportedFormatError);\n        return;\n      }\n\n      setLifecycleStatus('loading');\n\n      try {\n        const sparkModule = await import('@sparkjsdev/spark');\n        if (disposed || !groupRef.current) return;\n\n        const spark = new sparkModule.SparkRenderer({\n          renderer: gl,\n          onDirty: invalidate,\n          ...resolvedRenderTuning,\n        });\n        spark.userData[CAMERA_FRAME_CAPTURE_RENDER_USER_DATA_KEY] = async ({\n          scene,\n          camera,\n          width,\n          height,\n        }: CameraFrameCaptureRenderInput): Promise<CameraFrameCaptureRenderResult> => {\n          let captureSpark = captureSparkRef.current;\n          if (\n            !captureSpark ||\n            captureSpark.width !== width ||\n            captureSpark.height !== height\n          ) {\n            disposeCaptureSpark();\n            captureSpark = {\n              renderer: new sparkModule.SparkRenderer({\n                renderer: gl,\n                autoUpdate: false,\n                lodSplatScale: resolvedCaptureTuning.lodSplatScale,\n                lodRenderScale: resolvedCaptureTuning.lodRenderScale,\n                minSortIntervalMs: resolvedCaptureTuning.minSortIntervalMs,\n                target: {\n                  width,\n                  height,\n                },\n              }),\n              width,\n              height,\n            };\n            captureSparkRef.current = captureSpark;\n          }\n\n          const captureRenderer = captureSpark.renderer;\n          const maxWarmupFrames = Math.max(\n            1,\n            Math.floor(resolvedCaptureTuning.maxWarmupFrames)\n          );\n          let pixels: Uint8Array | undefined;\n          for (let attempt = 0; attempt < maxWarmupFrames; attempt += 1) {\n            captureRenderer.renderSize.set(width, height);\n            await captureRenderer.update({ scene, camera });\n            pixels = await captureRenderer.renderReadTarget({\n              scene,\n              camera,\n            });\n            if (\n              captureRenderer.activeSplats > 0 &&\n              !isMostlyBlankCapture(pixels, resolvedCaptureTuning)\n            ) {\n              break;\n            }\n            if (attempt < maxWarmupFrames - 1) {\n              await waitForNextAnimationFrame();\n            }\n          }\n          if (!pixels) {\n            throw new Error('Spark camera frame capture did not produce pixels.');\n          }\n          return { pixels, width, height, flipY: true };\n        };\n        const mesh = new sparkModule.SplatMesh({\n          url: metadata.src,\n          lod,\n        });\n        mesh.name = 'GaussianSplatMesh';\n\n        groupRef.current.add(spark);\n        groupRef.current.add(mesh);\n        sparkRef.current = spark;\n        meshRef.current = mesh;\n\n        if (hideGroundMeshes && groupRef.current.parent) {\n          groupRef.current.parent.traverse((object) => {\n            if (\n              !(object instanceof THREE.Mesh) ||\n              object === (mesh as unknown as THREE.Object3D)\n            ) {\n              return;\n            }\n            const name = object.name.toLowerCase();\n            if (\n              name.includes('floor') ||\n              name.includes('ground') ||\n              name.includes('plane')\n            ) {\n              object.visible = false;\n              hiddenMeshesRef.current.push(object);\n            }\n          });\n        }\n\n        await mesh.initialized;\n        if (disposed) return;\n        setLifecycleStatus('ready');\n        onLoadRef.current?.(mesh);\n        invalidate();\n      } catch (error) {\n        const normalizedError =\n          error instanceof Error ? error : new Error(String(error));\n        setLifecycleStatus('error');\n        onErrorRef.current?.(normalizedError);\n      }\n    }\n\n    void loadSplat();\n\n    return () => {\n      disposed = true;\n      restoreHiddenMeshes();\n\n      if (meshRef.current) {\n        groupRef.current?.remove(meshRef.current);\n        safelyDisposeSparkResource(meshRef.current);\n        meshRef.current = null;\n      }\n\n      if (sparkRef.current) {\n        groupRef.current?.remove(sparkRef.current);\n        safelyDisposeSparkResource(sparkRef.current);\n        sparkRef.current = null;\n      }\n\n      disposeCaptureSpark();\n    };\n  }, [\n    gl,\n    hideGroundMeshes,\n    invalidate,\n    lod,\n    metadata.format,\n    metadata.src,\n    resolvedCaptureTuning.blankAlphaThreshold,\n    resolvedCaptureTuning.blankAverageColor,\n    resolvedCaptureTuning.blankSampleCount,\n    resolvedCaptureTuning.blankVisibleRatio,\n    resolvedCaptureTuning.lodRenderScale,\n    resolvedCaptureTuning.lodSplatScale,\n    resolvedCaptureTuning.maxWarmupFrames,\n    resolvedCaptureTuning.minSortIntervalMs,\n    resolvedRenderTuning.lodRenderScale,\n    resolvedRenderTuning.lodSplatScale,\n    resolvedRenderTuning.minSortIntervalMs,\n  ]);\n\n  return (\n    <SplatEnvironment\n      {...groupProps}\n      environment={environment}\n      scenario={scenario}\n      renderer={renderer}\n      src={metadata.src}\n      format={metadata.format}\n      collisionProxyMetadata={metadata.collisionProxy}\n      collisionProxy={collisionProxy}\n      showPlaceholder={showPlaceholder ?? status !== 'ready'}\n    >\n      <group ref={groupRef} />\n      {children}\n    </SplatEnvironment>\n  );\n}\n\nfunction safelyDisposeSparkResource(\n  resource: SparkDisposable | null | undefined\n) {\n  if (!resource) return;\n  try {\n    silenceSparkWorkerTerminateRejections(resource);\n    const result = resource.dispose?.();\n    if (isPromiseLike(result)) {\n      void Promise.resolve(result).catch(handleSparkDisposeError);\n    }\n  } catch (error) {\n    handleSparkDisposeError(error);\n  }\n}\n\nfunction isPromiseLike(value: unknown): value is PromiseLike<unknown> {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    'then' in value &&\n    typeof (value as { then?: unknown }).then === 'function'\n  );\n}\n\nfunction silenceSparkWorkerTerminateRejections(resource: SparkDisposable) {\n  const workers = getSparkWorkers(resource);\n  for (const worker of workers) {\n    if (!worker.messages) continue;\n\n    for (const message of Object.values(worker.messages)) {\n      const reject = message.reject;\n      if (!reject) continue;\n\n      message.reject = (error: unknown) => {\n        if (!isSparkWorkerTerminateError(error)) {\n          reject(error);\n        }\n      };\n    }\n  }\n}\n\nfunction getSparkWorkers(resource: SparkDisposable): SparkWorkerLike[] {\n  const sparkResource = resource as SparkResourceWithWorkers;\n  return [\n    sparkResource.worker,\n    sparkResource.sortWorker,\n    sparkResource.lodWorker,\n  ].filter((worker): worker is SparkWorkerLike => Boolean(worker));\n}\n\nfunction handleSparkDisposeError(error: unknown) {\n  if (\n    error instanceof Error &&\n    error.message.toLowerCase().includes('worker terminate')\n  ) {\n    return;\n  }\n\n  console.warn('[mujoco-react] Spark resource disposal failed.', error);\n}\n\nfunction ensureSparkDisposeRejectionHandler() {\n  if (\n    sparkDisposeRejectionHandlerRegistered ||\n    typeof window === 'undefined' ||\n    typeof window.addEventListener !== 'function'\n  ) {\n    return;\n  }\n\n  sparkDisposeRejectionHandlerRegistered = true;\n  window.addEventListener('unhandledrejection', (event) => {\n    if (isSparkWorkerTerminateError(event.reason)) {\n      event.preventDefault();\n    }\n  });\n}\n\nfunction isSparkWorkerTerminateError(reason: unknown) {\n  return (\n    reason instanceof Error &&\n    reason.message.toLowerCase().includes('worker terminate')\n  );\n}\n"]}

package/dist/{types-B-J8fpPP.d.ts → types-CdFZCYmy.d.ts}

@@ -223,6 +223,9 @@ interface MujocoModel {
     cam_pos?: Float64Array;
     cam_quat?: Float64Array;
     cam_fovy?: Float64Array;
+    cam_intrinsic?: Float64Array;
+    cam_resolution?: Int32Array;
+    cam_sensorsize?: Float64Array;
     ten_wrapadr: Int32Array;
     ten_wrapnum: Int32Array;
     ten_range: Float64Array;
@@ -556,6 +559,9 @@ interface CameraInfo {
     name: string;
     bodyId: number;
     fov: number | null;
+    resolution: [number, number] | null;
+    sensorSize: [number, number] | null;
+    intrinsic: [number, number, number, number] | null;
     position: [number, number, number] | null;
     quaternion: [number, number, number, number] | null;
 }
@@ -795,11 +801,27 @@ interface ObservationHandle {
     /** Read just the vector values for policy inference. */
     readValues(): Float32Array | Float64Array;
 }
+interface DebugVirtualCamera {
+    name?: string;
+    position?: CameraFrameCaptureVector3;
+    lookAt?: CameraFrameCaptureVector3;
+    up?: CameraFrameCaptureVector3;
+    quaternion?: THREE.Quaternion | readonly [number, number, number, number];
+    fov?: number;
+    width?: number;
+    height?: number;
+    frustumDepth?: number;
+    markerScale?: number;
+    color?: THREE.ColorRepresentation;
+    aimColor?: THREE.ColorRepresentation;
+}
 interface DebugProps {
     showGeoms?: boolean;
     showSites?: boolean;
     showJoints?: boolean;
     showCameras?: boolean;
+    /** Additional explicit virtual camera poses to visualize alongside MuJoCo XML cameras. */
+    virtualCameras?: readonly DebugVirtualCamera[];
     showContacts?: boolean;
     showCOM?: boolean;
     showInertia?: boolean;
@@ -1162,6 +1184,49 @@ interface FrameCaptureAPI {
 }
 type CameraFrameCaptureVector3 = THREE.Vector3 | readonly [number, number, number];
 type CameraFrameCaptureQuaternion = THREE.Quaternion | readonly [number, number, number, number];
+interface CameraFrameVisualOverrides {
+    /**
+     * Override `scene.background` for this capture only.
+     * Use `null` or `false` to render without the viewer scene background.
+     */
+    sceneBackground?: THREE.Scene['background'] | THREE.ColorRepresentation | null | false;
+    /**
+     * Override `scene.environment` for this capture only.
+     * Use `null` or `false` to remove viewer environment lighting/maps.
+     */
+    sceneEnvironment?: THREE.Scene['environment'] | null | false;
+    /**
+     * Override `scene.fog` for this capture only.
+     * Use `null` or `false` to remove viewer fog.
+     */
+    sceneFog?: THREE.Scene['fog'] | null | false;
+    /** Override `renderer.shadowMap.enabled` while capturing. */
+    shadows?: boolean;
+    /** Override renderer tone mapping while capturing. */
+    toneMapping?: THREE.WebGLRenderer['toneMapping'];
+    /** Override renderer output color space while capturing. */
+    outputColorSpace?: THREE.WebGLRenderer['outputColorSpace'];
+}
+interface CameraFrameRenderIsolationOptions {
+    /**
+     * Use an independent offscreen WebGLRenderer for this capture.
+     *
+     * This prevents viewer renderer settings such as antialiasing, shadow-map
+     * configuration, tone mapping, and environment setup from leaking into
+     * policy/training images. Leave unset for the historical shared-renderer path.
+     */
+    enabled?: boolean;
+    /** Offscreen renderer antialiasing. Defaults to false for deterministic policy captures. */
+    antialias?: boolean;
+    /** Offscreen renderer alpha buffer. Defaults to false, matching Three.js WebGLRenderer. */
+    alpha?: boolean;
+    /** Offscreen renderer preserveDrawingBuffer flag. Defaults to false. */
+    preserveDrawingBuffer?: boolean;
+    /** Offscreen renderer power preference. Defaults to the browser's renderer default. */
+    powerPreference?: WebGLPowerPreference;
+    /** Reuse an offscreen renderer for matching capture dimensions/options. Defaults to true. */
+    cache?: boolean;
+}
 interface CameraFrameCaptureOptions {
     /** Existing Three camera to clone before applying pose overrides. */
     camera?: THREE.Camera;
@@ -1186,8 +1251,36 @@ interface CameraFrameCaptureOptions {
     fov?: number;
     near?: number;
     far?: number;
+    /**
+     * Explicit projection matrix for offscreen capture. This is useful when a
+     * MuJoCo camera has calibrated intrinsics that cannot be represented by a
+     * symmetric Three.js PerspectiveCamera fov alone.
+     */
+    projectionMatrix?: THREE.Matrix4 | readonly number[];
     /** Provenance for the camera pose used by the capture. Usually set by the MuJoCo provider. */
     source?: CameraFrameCaptureSource;
+    /**
+     * When resolving a named MuJoCo camera, derive Three capture settings from
+     * MuJoCo camera metadata where available: cam_resolution, cam_fovy,
+     * cam_intrinsic/cam_sensorsize, and visual map near/far clipping.
+     */
+    mujocoCameraCompatibility?: boolean | {
+        useResolution?: boolean;
+        useIntrinsics?: boolean;
+        useClipping?: boolean;
+        /**
+         * When a MuJoCo camera has `resolution` metadata and the caller supplies
+         * only width or only height, derive the missing dimension from the MuJoCo
+         * camera aspect ratio.
+         */
+        preserveAspect?: boolean;
+        /**
+         * Prefer the MuJoCo camera's configured resolution over width/height
+         * provided by the caller. Leave false when a policy wants fixed-size
+         * payloads while still preserving the camera aspect ratio.
+         */
+        preferResolution?: boolean;
+    };
     /** Hide rendered Three objects whose MuJoCo geom group is in this list. */
     hiddenGeomGroups?: readonly number[];
     /** When provided, only rendered Three objects whose MuJoCo geom group is in this list are visible. */
@@ -1198,6 +1291,15 @@ interface CameraFrameCaptureOptions {
     background?: THREE.ColorRepresentation;
     /** Optional clear alpha for this capture only. Defaults to the renderer's current clear alpha. */
     backgroundAlpha?: number;
+    /** Temporary scene/renderer visual overrides applied only for this offscreen capture. */
+    visualOverrides?: CameraFrameVisualOverrides;
+    /**
+     * Render this capture with a separate offscreen WebGLRenderer.
+     *
+     * This is useful for policy or training captures that should remain canonical
+     * while the interactive viewer uses richer visual effects.
+     */
+    renderIsolation?: boolean | CameraFrameRenderIsolationOptions;
     /** Mirror the captured image horizontally after rendering. Useful when matching policy datasets with mirrored camera frames. */
     flipX?: boolean;
 }
@@ -1307,6 +1409,17 @@ interface CameraFrameSequenceRecorderAPI {
     record: (options: CameraFrameSequenceOptions) => Promise<CameraFrameSequenceResult>;
     reset: () => void;
 }
+type MujocoMeshNormalSmoothing = boolean | {
+    /** Vertex merge tolerance used before recomputing mesh normals. Defaults to `1e-4`. */
+    tolerance?: number;
+};
+interface MujocoRenderOptions {
+    /**
+     * Smooth mesh normals by welding duplicate vertices before recomputing normals.
+     * Useful for faceted STL visuals; keep off for exact policy-render parity.
+     */
+    meshNormalSmoothing?: MujocoMeshNormalSmoothing;
+}
 type MujocoCanvasProps = Omit<CanvasProps, 'onError'> & {
     config: SceneConfig;
     /** R3F content rendered while the MuJoCo WASM module is still loading. */
@@ -1321,6 +1434,7 @@ type MujocoCanvasProps = Omit<CanvasProps, 'onError'> & {
     paused?: boolean;
     speed?: number;
     interpolate?: boolean;
+    renderOptions?: MujocoRenderOptions;
 };
 interface SitePositionResult {
     position: React__default.RefObject<THREE.Vector3>;
@@ -1384,4 +1498,4 @@ interface ArrayJointStateResult {
     velocity: React__default.RefObject<Float64Array>;
 }
 
-export { type ArrayJointStateResult as $, type ActuatedJointInfo as A, type BodyProps as B, type ControlGroupInfo as C, type DragInteractionProps as D, type ScenarioLightingPreset as E, type SplatEnvironmentMetadataInput as F, type SplatEnvironmentMetadata as G, type SplatSceneInput as H, type IkConfig as I, type DebugProps as J, type GeomInfo as K, type ContactListenerProps as L, type MujocoContextValue as M, type ActuatorInfo as N, type ObservationConfig as O, type PhysicsStepCallback as P, type Sites as Q, type ReadyCallbackInput as R, type SceneConfig as S, type TrajectoryPlayerProps as T, type SitePositionResult as U, type VisualScenarioEffectsProps as V, type Sensors as W, type SensorHandle as X, type SensorInfo as Y, type Joints as Z, type ScalarJointStateResult as _, type MujocoCanvasProps as a, ModelActuators as a$, type JointStateOptions as a0, type JointStateResult as a1, type Bodies as a2, type BodyStateResult as a3, type Geoms as a4, type Actuators as a5, type CtrlHandle as a6, type ContactInfo as a7, type KeyboardTeleopConfig as a8, type KeyboardIkTargetConfig as a9, type CameraFrameSequenceRecorderAPI as aA, type CameraFrameCaptureResult as aB, type CameraFrameCaptureBlobResult as aC, type ImagePointCoordinateSpace as aD, type ImagePointProjectionOptions as aE, type ImagePointProjectionResult as aF, type PolicyVector as aG, type BodyInfo as aH, type CameraFrameCaptureQuaternion as aI, type CameraFrameCaptureVector3 as aJ, type CameraFrameSequenceCameraSummary as aK, type CameraFrameSequenceFrame as aL, type CameraFrameSequenceSampleInput as aM, type CameraFrameSequenceStepInput as aN, type CameraInfo as aO, type ControlJointInfo as aP, type FrameCaptureTarget as aQ, type FrameCaptureTargetRef as aR, type IKSolveFn as aS, type IkGizmoDragInput as aT, type IkSolveInput as aU, type JointInfo as aV, type JointStateKind as aW, type KeyBinding as aX, type KeyboardIkTargetAction as aY, type KeyboardIkTargetBinding as aZ, type Keyframes as a_, type PolicyConfig as aa, type PolicyAPI as ab, type RemotePolicyConfig as ac, type RemotePolicyAPI as ad, type ObservationHandle as ae, type ObservationOutput as af, type TrajectoryInput as ag, type TrajectoryStateChangeInput as ah, type PlaybackState as ai, type TrajectoryFrame as aj, type FrameCaptureOptions as ak, type FrameCaptureResult as al, type FrameCaptureBlobResult as am, type FrameCaptureAPI as an, type CameraFrameCaptureOptions as ao, type CameraFrameCaptureAPI as ap, type Cameras as aq, type CameraFrameSequenceCamera as ar, type CameraFrameCaptureSource as as, type CameraFrameSequenceOptions as at, type CameraFrameSequenceResult as au, type PolicyCameraFrameStream as av, type PolicyCameraFrameCaptureOptions as aw, type PolicyCameraFrameCaptureResult as ax, type FrameCaptureStatus as ay, type PolicyCameraFrameCaptureAPI as az, type MujocoSimAPI as b, ModelBodies as b0, ModelCameras as b1, ModelGeoms as b2, ModelJoints as b3, ModelKeyframes as b4, type ModelOptions as b5, type ModelResource as b6, ModelResources as b7, ModelSensors as b8, ModelSites as b9, type SceneMarker as bA, type SceneObject as bB, type SensorResult as bC, type SiteInfo as bD, type SplatAssetConfig as bE, type SplatScenarioConfig as bF, type StateSnapshot as bG, type TrajectoryData as bH, type TrajectoryFrameCallbackInput as bI, type VisualScenarioMaterialFilterInput as bJ, type XmlPatch as bK, getContact as bL, registerModelResources as bM, type Models as ba, type MujocoContact as bb, type MujocoContactArray as bc, type MujocoFrameCaptureOptions as bd, type ObservationLayoutItem as be, type PhysicsConfig as bf, type PhysicsStepInput as bg, type PolicyActionChunk as bh, type PolicyActionInput as bi, type PolicyInferenceInput as bj, type PolicyInferenceOutput as bk, type PolicyInferenceResult as bl, type PolicyObservationInput as bm, type RayHit as bn, type Register as bo, type RegisteredModelMap as bp, type RemotePolicyRequestInfo as bq, type RemotePolicyRequestInput as br, type RemotePolicyResponseInfo as bs, type RemotePolicyStatus as bt, type ResetCallbackInput as bu, type ResolvedScenarioCameraConfig as bv, type ResolvedScenarioMaterialConfig as bw, type ResourceSelector as bx, type ScenarioCameraConfig as by, type ScenarioMaterialConfig as bz, type StepCallbackInput as c, type SelectionCallbackInput as d, type MujocoModule as e, type MujocoModel as f, type MujocoData as g, type ControlGroupSelector as h, type ObservationResult as i, type IkContextValue as j, type IkGizmoProps as k, type SceneLightsProps as l, type ScenarioLightingProps as m, type SplatEnvironmentProps as n, type VisualScenarioConfig as o, type SplatRendererKind as p, type PairedSplatEnvironmentConfig as q, type SplatFormat as r, type SplatCollisionProxyConfig as s, type SplatEnvironmentReadiness as t, type SplatCollisionPrimitive as u, SplatEnvironmentReadinessStatus as v, type SplatSceneConfigInput as w, type SplatSceneConfigState as x, type VisualScenarioExecutionContextInput as y, type VisualScenarioExecutionContext as z };
+export { type ScalarJointStateResult as $, type ActuatedJointInfo as A, type BodyProps as B, type ControlGroupInfo as C, type DragInteractionProps as D, type VisualScenarioExecutionContext as E, type ScenarioLightingPreset as F, type SplatEnvironmentMetadataInput as G, type SplatEnvironmentMetadata as H, type IkConfig as I, type SplatSceneInput as J, type DebugProps as K, type GeomInfo as L, type MujocoContextValue as M, type ContactListenerProps as N, type ObservationConfig as O, type PhysicsStepCallback as P, type ActuatorInfo as Q, type ReadyCallbackInput as R, type SceneConfig as S, type TrajectoryPlayerProps as T, type Sites as U, type VisualScenarioEffectsProps as V, type SitePositionResult as W, type Sensors as X, type SensorHandle as Y, type SensorInfo as Z, type Joints as _, type MujocoCanvasProps as a, type KeyboardIkTargetBinding as a$, type ArrayJointStateResult as a0, type JointStateOptions as a1, type JointStateResult as a2, type Bodies as a3, type BodyStateResult as a4, type Geoms as a5, type Actuators as a6, type CtrlHandle as a7, type ContactInfo as a8, type KeyboardTeleopConfig as a9, type PolicyCameraFrameCaptureAPI as aA, type CameraFrameSequenceRecorderAPI as aB, type CameraFrameCaptureResult as aC, type CameraFrameCaptureBlobResult as aD, type ImagePointCoordinateSpace as aE, type ImagePointProjectionOptions as aF, type ImagePointProjectionResult as aG, type PolicyVector as aH, type BodyInfo as aI, type CameraFrameCaptureQuaternion as aJ, type CameraFrameCaptureVector3 as aK, type CameraFrameSequenceCameraSummary as aL, type CameraFrameSequenceFrame as aM, type CameraFrameSequenceSampleInput as aN, type CameraFrameSequenceStepInput as aO, type CameraInfo as aP, type ControlJointInfo as aQ, type DebugVirtualCamera as aR, type FrameCaptureTarget as aS, type FrameCaptureTargetRef as aT, type IKSolveFn as aU, type IkGizmoDragInput as aV, type IkSolveInput as aW, type JointInfo as aX, type JointStateKind as aY, type KeyBinding as aZ, type KeyboardIkTargetAction as a_, type KeyboardIkTargetConfig as aa, type PolicyConfig as ab, type PolicyAPI as ac, type RemotePolicyConfig as ad, type RemotePolicyAPI as ae, type ObservationHandle as af, type ObservationOutput as ag, type TrajectoryInput as ah, type TrajectoryStateChangeInput as ai, type PlaybackState as aj, type TrajectoryFrame as ak, type FrameCaptureOptions as al, type FrameCaptureResult as am, type FrameCaptureBlobResult as an, type FrameCaptureAPI as ao, type CameraFrameCaptureOptions as ap, type CameraFrameCaptureAPI as aq, type Cameras as ar, type CameraFrameSequenceCamera as as, type CameraFrameCaptureSource as at, type CameraFrameSequenceOptions as au, type CameraFrameSequenceResult as av, type PolicyCameraFrameStream as aw, type PolicyCameraFrameCaptureOptions as ax, type PolicyCameraFrameCaptureResult as ay, type FrameCaptureStatus as az, type MujocoSimAPI as b, type Keyframes as b0, ModelActuators as b1, ModelBodies as b2, ModelCameras as b3, ModelGeoms as b4, ModelJoints as b5, ModelKeyframes as b6, type ModelOptions as b7, type ModelResource as b8, ModelResources as b9, type ScenarioCameraConfig as bA, type ScenarioMaterialConfig as bB, type SceneMarker as bC, type SceneObject as bD, type SensorResult as bE, type SiteInfo as bF, type SplatAssetConfig as bG, type SplatScenarioConfig as bH, type StateSnapshot as bI, type TrajectoryData as bJ, type TrajectoryFrameCallbackInput as bK, type VisualScenarioMaterialFilterInput as bL, type XmlPatch as bM, getContact as bN, registerModelResources as bO, ModelSensors as ba, ModelSites as bb, type Models as bc, type MujocoContact as bd, type MujocoContactArray as be, type MujocoFrameCaptureOptions as bf, type ObservationLayoutItem as bg, type PhysicsConfig as bh, type PhysicsStepInput as bi, type PolicyActionChunk as bj, type PolicyActionInput as bk, type PolicyInferenceInput as bl, type PolicyInferenceOutput as bm, type PolicyInferenceResult as bn, type PolicyObservationInput as bo, type RayHit as bp, type Register as bq, type RegisteredModelMap as br, type RemotePolicyRequestInfo as bs, type RemotePolicyRequestInput as bt, type RemotePolicyResponseInfo as bu, type RemotePolicyStatus as bv, type ResetCallbackInput as bw, type ResolvedScenarioCameraConfig as bx, type ResolvedScenarioMaterialConfig as by, type ResourceSelector as bz, type StepCallbackInput as c, type SelectionCallbackInput as d, type MujocoModule as e, type MujocoRenderOptions as f, type MujocoModel as g, type MujocoData as h, type ControlGroupSelector as i, type ObservationResult as j, type IkContextValue as k, type IkGizmoProps as l, type SceneLightsProps as m, type ScenarioLightingProps as n, type SplatEnvironmentProps as o, type VisualScenarioConfig as p, type SplatRendererKind as q, type PairedSplatEnvironmentConfig as r, type SplatFormat as s, type SplatCollisionProxyConfig as t, type SplatEnvironmentReadiness as u, type SplatCollisionPrimitive as v, SplatEnvironmentReadinessStatus as w, type SplatSceneConfigInput as x, type SplatSceneConfigState as y, type VisualScenarioExecutionContextInput as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mujoco-react",
-  "version": "10.2.1",
+  "version": "10.4.0",
   "description": "Composable React Three Fiber building blocks for MuJoCo WASM simulations",
   "type": "module",
   "main": "./dist/index.js",

package/src/components/Debug.tsx

@@ -13,7 +13,7 @@ import { useMujocoContext } from '../core/MujocoSimProvider';
 import { getName } from '../core/SceneLoader';
 import { CAPTURE_EXCLUDE_KEY } from '../rendering/cameraFrameCapture';
 import { getContact, withContacts } from '../types';
-import type { DebugProps } from '../types';
+import type { CameraFrameCaptureVector3, DebugProps, DebugVirtualCamera } from '../types';
 
 const JOINT_COLORS: Record<number, number> = {
   0: 0xff0000, // free - red
@@ -41,6 +41,170 @@ type CameraDebugObject = THREE.Group & {
   };
 };
 
+function toVector3(
+  value: CameraFrameCaptureVector3 | undefined,
+  fallback: THREE.Vector3
+) {
+  if (!value) return fallback.clone();
+  return value instanceof THREE.Vector3
+    ? value.clone()
+    : new THREE.Vector3(value[0], value[1], value[2]);
+}
+
+function createCameraLabel(text: string, color: THREE.ColorRepresentation) {
+  const canvas = document.createElement('canvas');
+  canvas.width = 256;
+  canvas.height = 64;
+  const ctx = canvas.getContext('2d')!;
+  ctx.fillStyle = new THREE.Color(color).getStyle();
+  ctx.font = 'bold 32px monospace';
+  ctx.textAlign = 'center';
+  ctx.fillText(text, 128, 42);
+  const texture = new THREE.CanvasTexture(canvas);
+  const sprite = new THREE.Sprite(
+    new THREE.SpriteMaterial({
+      map: texture,
+      depthTest: false,
+      transparent: true,
+    })
+  );
+  sprite.position.set(0, 0.014, 0.01);
+  sprite.scale.set(0.05, 0.012, 1);
+  sprite.renderOrder = 999;
+  return sprite;
+}
+
+function createVirtualCameraDebugObject(
+  camera: DebugVirtualCamera,
+  index: number
+) {
+  const color = camera.color ?? '#ff3d71';
+  const aimColor = camera.aimColor ?? '#38bdf8';
+  const markerScale = camera.markerScale ?? 1;
+  const cameraPosition = toVector3(camera.position, new THREE.Vector3());
+  const configuredUp = toVector3(camera.up, new THREE.Vector3(0, 0, 1)).normalize();
+  const cameraQuaternion = new THREE.Quaternion();
+  const forward = new THREE.Vector3();
+
+  if (camera.quaternion) {
+    if (camera.quaternion instanceof THREE.Quaternion) {
+      cameraQuaternion.copy(camera.quaternion);
+    } else {
+      cameraQuaternion.set(
+        camera.quaternion[0],
+        camera.quaternion[1],
+        camera.quaternion[2],
+        camera.quaternion[3]
+      );
+    }
+    forward.set(0, 0, -1).applyQuaternion(cameraQuaternion).normalize();
+  } else {
+    const target = toVector3(
+      camera.lookAt,
+      cameraPosition.clone().add(new THREE.Vector3(0, 0, -1))
+    );
+    forward.copy(target).sub(cameraPosition);
+    if (forward.lengthSq() < 1e-8) forward.set(0, 0, -1);
+    forward.normalize();
+    cameraQuaternion.setFromRotationMatrix(
+      new THREE.Matrix4().lookAt(cameraPosition, target, configuredUp)
+    );
+  }
+
+  const target = camera.lookAt
+    ? toVector3(camera.lookAt, cameraPosition.clone().add(forward))
+    : cameraPosition.clone().addScaledVector(forward, 0.4);
+  const distanceToTarget = Math.max(target.distanceTo(cameraPosition), 0.001);
+  const depth = camera.frustumDepth ?? Math.min(Math.max(distanceToTarget * 0.42, 0.16), 0.45);
+  const fov = camera.fov ?? 50;
+  const aspect = (camera.width ?? 640) / (camera.height ?? 480);
+
+  const right = forward.clone().cross(configuredUp);
+  if (right.lengthSq() < 1e-8) right.set(1, 0, 0);
+  right.normalize();
+  const orthogonalUp = right.clone().cross(forward).normalize();
+  const frustumHeight = 2 * Math.tan(THREE.MathUtils.degToRad(fov) / 2) * depth;
+  const frustumWidth = frustumHeight * aspect;
+  const center = cameraPosition.clone().addScaledVector(forward, depth);
+  const halfRight = right.clone().multiplyScalar(frustumWidth / 2);
+  const halfUp = orthogonalUp.clone().multiplyScalar(frustumHeight / 2);
+
+  const topLeft = center.clone().sub(halfRight).add(halfUp);
+  const topRight = center.clone().add(halfRight).add(halfUp);
+  const bottomRight = center.clone().add(halfRight).sub(halfUp);
+  const bottomLeft = center.clone().sub(halfRight).sub(halfUp);
+  const frustumPoints = [
+    cameraPosition, topLeft,
+    cameraPosition, topRight,
+    cameraPosition, bottomRight,
+    cameraPosition, bottomLeft,
+    topLeft, topRight,
+    topRight, bottomRight,
+    bottomRight, bottomLeft,
+    bottomLeft, topLeft,
+  ];
+
+  const group = new THREE.Group();
+  group.name = camera.name ?? `virtual-camera-${index}`;
+  group.renderOrder = 999;
+  group.frustumCulled = false;
+
+  const frustum = new THREE.LineSegments(
+    new THREE.BufferGeometry().setFromPoints(frustumPoints),
+    new THREE.LineBasicMaterial({
+      color,
+      transparent: true,
+      opacity: 0.9,
+      depthTest: false,
+    })
+  );
+  frustum.renderOrder = 999;
+  frustum.frustumCulled = false;
+  group.add(frustum);
+
+  const aim = new THREE.LineSegments(
+    new THREE.BufferGeometry().setFromPoints([cameraPosition, target]),
+    new THREE.LineBasicMaterial({
+      color: aimColor,
+      transparent: true,
+      opacity: 0.95,
+      depthTest: false,
+    })
+  );
+  aim.renderOrder = 999;
+  aim.frustumCulled = false;
+  group.add(aim);
+
+  const markerGroup = new THREE.Group();
+  markerGroup.position.copy(cameraPosition);
+  markerGroup.quaternion.copy(cameraQuaternion);
+  markerGroup.renderOrder = 999;
+  markerGroup.frustumCulled = false;
+  markerGroup.add(new THREE.Mesh(
+    new THREE.BoxGeometry(0.045 * markerScale, 0.028 * markerScale, 0.022 * markerScale),
+    new THREE.MeshBasicMaterial({ color, depthTest: false })
+  ));
+  const lens = new THREE.Mesh(
+    new THREE.BoxGeometry(0.025 * markerScale, 0.018 * markerScale, 0.014 * markerScale),
+    new THREE.MeshBasicMaterial({ color: aimColor, depthTest: false })
+  );
+  lens.position.set(0, 0, -0.021 * markerScale);
+  markerGroup.add(lens);
+  if (camera.name) markerGroup.add(createCameraLabel(camera.name, color));
+  group.add(markerGroup);
+
+  const targetMarker = new THREE.Mesh(
+    new THREE.SphereGeometry(0.018 * markerScale, 16, 10),
+    new THREE.MeshBasicMaterial({ color: aimColor, depthTest: false })
+  );
+  targetMarker.position.copy(target);
+  targetMarker.renderOrder = 999;
+  targetMarker.frustumCulled = false;
+  group.add(targetMarker);
+
+  return group;
+}
+
 /**
  * Declarative debug visualization component.
  * Renders wireframe geoms, site markers, joint axes, contact forces, COM markers, etc.
@@ -50,6 +214,7 @@ export function Debug({
   showSites = false,
   showJoints = false,
   showCameras = false,
+  virtualCameras = [],
   showContacts = false,
   showCOM = false,
   showInertia = false,
@@ -69,6 +234,7 @@ export function Debug({
     const sites: THREE.Object3D[] = [];
     const joints: THREE.Object3D[] = [];
     const cameras: CameraDebugObject[] = [];
+    const virtualCameraObjects: THREE.Object3D[] = [];
     const comMarkers: THREE.Object3D[] = [];
 
     // Wireframe geoms
@@ -270,6 +436,10 @@ export function Debug({
       }
     }
 
+    for (let i = 0; i < virtualCameras.length; i += 1) {
+      virtualCameraObjects.push(createVirtualCameraDebugObject(virtualCameras[i], i));
+    }
+
     // COM markers
     if (showCOM) {
       for (let i = 1; i < model.nbody; i++) {
@@ -281,8 +451,8 @@ export function Debug({
       }
     }
 
-    return { geoms, sites, joints, cameras, comMarkers };
-  }, [status, mjModelRef, showGeoms, showSites, showJoints, showCameras, showCOM]);
+    return { geoms, sites, joints, cameras, virtualCameraObjects, comMarkers };
+  }, [status, mjModelRef, showGeoms, showSites, showJoints, showCameras, virtualCameras, showCOM]);
 
   // Add/remove debug objects from scene
   useEffect(() => {
@@ -294,6 +464,7 @@ export function Debug({
       ...debugGeometry.sites,
       ...debugGeometry.joints,
       ...debugGeometry.cameras,
+      ...debugGeometry.virtualCameraObjects,
       ...debugGeometry.comMarkers,
     ];
     for (const obj of allObjects) group.add(obj);