mujoco-react 8.11.0 → 9.1.0

package/src/hooks/useJointState.ts

@@ -59,7 +59,7 @@ export function useJointState(name: Joints): JointStateResult {
     jointIdRef.current = -1;
   }, [name, status, mjModelRef]);
 
-  useAfterPhysicsStep((_model, data) => {
+  useAfterPhysicsStep(({ data }) => {
     if (jointIdRef.current < 0) return;
     const qa = qposAdrRef.current;
     const da = dofAdrRef.current;

package/src/hooks/useKeyboardTeleop.ts

@@ -70,7 +70,7 @@ export function useKeyboardTeleop(config: KeyboardTeleopConfig) {
   }, []);
 
   // Apply bindings each physics frame
-  useBeforePhysicsStep((_model, data) => {
+  useBeforePhysicsStep(({ data }) => {
     if (!enabledRef.current) return;
     const bindings = bindingsRef.current;
     const cache = actuatorCacheRef.current;

package/src/hooks/usePolicy.ts

@@ -28,7 +28,7 @@ export function usePolicy(config: PolicyConfig) {
   configRef.current = config;
   isRunningRef.current = config.enabled ?? isRunningRef.current;
 
-  useBeforePhysicsStep((model, data) => {
+  useBeforePhysicsStep(({ model, data }) => {
     if (!isRunningRef.current) return;
 
     const cfg = configRef.current;

package/src/hooks/useSensor.ts

@@ -39,7 +39,7 @@ export function useSensor(name: Sensors): SensorHandle {
   }, [name, status, mjModelRef]);
 
   // Update every frame after physics step
-  useAfterPhysicsStep((_model, data) => {
+  useAfterPhysicsStep(({ data }) => {
     if (sensorIdRef.current < 0) return;
     const adr = sensorAdrRef.current;
     const dim = sensorDimRef.current;

package/src/hooks/useTrajectoryPlayer.ts

@@ -8,7 +8,7 @@
 import { useCallback, useRef } from 'react';
 import { useFrame } from '@react-three/fiber';
 import { useMujocoContext, useBeforePhysicsStep } from '../core/MujocoSimProvider';
-import type { PlaybackState, TrajectoryFrame, TrajectoryInput } from '../types';
+import type { PlaybackState, TrajectoryStateChangeInput, TrajectoryFrame, TrajectoryInput } from '../types';
 
 export interface TrajectoryPlayerOptions {
   fps?: number;
@@ -16,7 +16,7 @@ export interface TrajectoryPlayerOptions {
   loop?: boolean;
   mode?: 'kinematic' | 'physics';
   onComplete?: () => void;
-  onStateChange?: (state: PlaybackState) => void;
+  onStateChange?: (input: TrajectoryStateChangeInput) => void;
 }
 
 /** Check if input is TrajectoryFrame[] (vs number[][]) */
@@ -74,7 +74,7 @@ export function useTrajectoryPlayer(
   const setState = useCallback((next: PlaybackState) => {
     if (stateRef.current === next) return;
     stateRef.current = next;
-    optionsRef.current.onStateChange?.(next);
+    optionsRef.current.onStateChange?.({ state: next });
   }, []);
 
   const play = useCallback(() => {
@@ -181,7 +181,7 @@ export function useTrajectoryPlayer(
   });
 
   // --- Physics mode: set ctrl values each physics step ---
-  useBeforePhysicsStep((model, data) => {
+  useBeforePhysicsStep(({ model, data }) => {
     if (stateRef.current !== 'playing') return;
     if ((optionsRef.current.mode ?? 'kinematic') !== 'physics') return;
 

package/src/hooks/useTrajectoryRecorder.ts

@@ -22,7 +22,7 @@ export function useTrajectoryRecorder(options: RecorderOptions = {}) {
   const framesRef = useRef<TrajectoryFrame[]>([]);
   const fields = options.fields ?? ['qpos'];
 
-  useAfterPhysicsStep((_model, data) => {
+  useAfterPhysicsStep(({ data }) => {
     if (!recordingRef.current) return;
 
     const frame: TrajectoryFrame = {

package/src/index.ts

@@ -82,15 +82,6 @@ export {
   captureFrameBlob,
   useFrameCapture,
 } from './hooks/useFrameCapture';
-export type {
-  FrameCaptureAPI,
-  FrameCaptureBlobResult,
-  FrameCaptureOptions,
-  FrameCaptureResult,
-  FrameCaptureStatus,
-  FrameCaptureTarget,
-  FrameCaptureTargetRef,
-} from './hooks/useFrameCapture';
 export { useCtrlNoise } from './hooks/useCtrlNoise';
 export { useBodyMeshes } from './hooks/useBodyMeshes';
 export { useSelectionHighlight } from './hooks/useSelectionHighlight';
@@ -110,8 +101,14 @@ export type {
   IkConfig,
   IkContextValue,
   IKSolveFn,
+  IkSolveInput,
   // Callbacks
   PhysicsStepCallback,
+  PhysicsStepInput,
+  ResetCallbackInput,
+  ReadyCallbackInput,
+  StepCallbackInput,
+  SelectionCallbackInput,
   // State management
   StateSnapshot,
   // Model introspection
@@ -155,6 +152,7 @@ export type {
   // Component props
   BodyProps,
   IkGizmoProps,
+  IkGizmoDragInput,
   DragInteractionProps,
   DebugProps,
   SceneLightsProps,
@@ -175,13 +173,24 @@ export type {
   ScenarioMaterialConfig,
   SplatEnvironmentProps,
   VisualScenarioEffectsProps,
+  VisualScenarioMaterialFilterInput,
   TrajectoryPlayerProps,
+  TrajectoryFrameCallbackInput,
+  TrajectoryStateChangeInput,
   ContactListenerProps,
   // API
   MujocoSimAPI,
+  MujocoFrameCaptureOptions,
   MujocoCanvasProps,
   MujocoContextValue,
   // Hook return types
+  FrameCaptureAPI,
+  FrameCaptureBlobResult,
+  FrameCaptureOptions,
+  FrameCaptureResult,
+  FrameCaptureStatus,
+  FrameCaptureTarget,
+  FrameCaptureTargetRef,
   SitePositionResult,
   SensorResult,
   CtrlHandle,

package/src/types.ts

@@ -450,7 +450,7 @@ export interface LoadFromFilesOptions {
   homeJoints?: number[];
   xmlPatches?: XmlPatch[];
   sceneObjects?: SceneObject[];
-  onReset?: (model: MujocoModel, data: MujocoData) => void;
+  onReset?: (input: ResetCallbackInput) => void;
 }
 
 export interface SceneConfig {
@@ -471,7 +471,7 @@ export interface SceneConfig {
   sceneObjects?: SceneObject[];
   homeJoints?: number[];
   xmlPatches?: XmlPatch[];
-  onReset?: (model: MujocoModel, data: MujocoData) => void;
+  onReset?: (input: ResetCallbackInput) => void;
 }
 
 // ---- IK Controller Config ----
@@ -513,7 +513,7 @@ export interface IkContextValue {
   setIkEnabled: (enabled: boolean) => void;
   moveTarget: (pos: THREE.Vector3, duration?: number) => void;
   syncTargetToSite: () => void;
-  solveIK: (pos: THREE.Vector3, quat: THREE.Quaternion, currentQ: number[]) => number[] | null;
+  solveIK: (input: IkSolveInput) => number[] | null;
   getGizmoStats: () => { pos: THREE.Vector3; rot: THREE.Euler } | null;
 }
 
@@ -536,12 +536,16 @@ export interface PhysicsConfig {
 // ---- IK ----
 
 export type IKSolveFn = (
-  pos: THREE.Vector3,
-  quat: THREE.Quaternion,
-  currentQ: number[],
-  context?: IKSolveContext
+  input: IkSolveInput
 ) => number[] | null;
 
+export interface IkSolveInput {
+  position: THREE.Vector3;
+  quaternion: THREE.Quaternion;
+  currentQ: number[];
+  context?: IKSolveContext;
+}
+
 export interface IKSolveContext {
   model: MujocoModel;
   data: MujocoData;
@@ -551,10 +555,29 @@ export interface IKSolveContext {
 
 // ---- Callbacks ----
 
-export type PhysicsStepCallback = (
-  model: MujocoModel,
-  data: MujocoData
-) => void;
+export interface PhysicsStepInput {
+  model: MujocoModel;
+  data: MujocoData;
+}
+
+export interface ResetCallbackInput extends PhysicsStepInput {}
+
+export interface ReadyCallbackInput {
+  api: MujocoSimAPI;
+}
+
+export interface StepCallbackInput {
+  time: number;
+  model: MujocoModel;
+  data: MujocoData;
+}
+
+export interface SelectionCallbackInput {
+  bodyId: number;
+  name: string;
+}
+
+export type PhysicsStepCallback = (input: PhysicsStepInput) => void;
 
 // ---- State Management (spec 4.1) ----
 
@@ -808,7 +831,12 @@ export interface IkGizmoProps {
   controller: IkContextValue;
   siteName?: string;
   scale?: number;
-  onDrag?: (position: THREE.Vector3, quaternion: THREE.Quaternion) => void;
+  onDrag?: (input: IkGizmoDragInput) => void;
+}
+
+export interface IkGizmoDragInput {
+  position: THREE.Vector3;
+  quaternion: THREE.Quaternion;
 }
 
 export interface DragInteractionProps {
@@ -940,7 +968,12 @@ export interface VisualScenarioEffectsProps {
   background?: THREE.ColorRepresentation;
   fogNear?: number;
   fogFar?: number;
-  materialFilter?: (object: THREE.Object3D, material: THREE.Material) => boolean;
+  materialFilter?: (input: VisualScenarioMaterialFilterInput) => boolean;
+}
+
+export interface VisualScenarioMaterialFilterInput {
+  object: THREE.Object3D;
+  material: THREE.Material;
 }
 
 export type TrajectoryInput = TrajectoryFrame[] | number[][];
@@ -952,9 +985,18 @@ export interface TrajectoryPlayerProps {
   loop?: boolean;
   playing?: boolean;
   mode?: 'kinematic' | 'physics';
-  onFrame?: (frameIdx: number) => void;
+  onFrame?: (input: TrajectoryFrameCallbackInput) => void;
   onComplete?: () => void;
-  onStateChange?: (state: PlaybackState) => void;
+  onStateChange?: (input: TrajectoryStateChangeInput) => void;
+}
+
+export interface TrajectoryFrameCallbackInput {
+  frameIndex: number;
+  frame: TrajectoryFrame | number[] | undefined;
+}
+
+export interface TrajectoryStateChangeInput {
+  state: PlaybackState;
 }
 
 export interface SelectionHighlightProps {
@@ -1058,7 +1100,10 @@ export interface MujocoSimAPI {
   recompile(patches?: XmlPatch[]): Promise<void>;
 
   // Canvas
+  getCanvas(): HTMLCanvasElement | null;
   getCanvasSnapshot(width?: number, height?: number, mimeType?: string): string;
+  captureFrame(options?: MujocoFrameCaptureOptions): Promise<FrameCaptureResult>;
+  captureFrameBlob(options?: MujocoFrameCaptureOptions): Promise<FrameCaptureBlobResult>;
   project2DTo3D(
     x: number,
     y: number,
@@ -1076,16 +1121,59 @@ export interface MujocoSimAPI {
   readonly mjDataRef: React.RefObject<MujocoData | null>;
 }
 
+export type FrameCaptureStatus = 'idle' | 'capturing' | 'captured' | 'error';
+
+export type FrameCaptureTarget =
+  | HTMLCanvasElement
+  | HTMLElement
+  | null
+  | undefined;
+
+export type FrameCaptureTargetRef =
+  React.RefObject<HTMLCanvasElement | HTMLElement | null>;
+
+export interface FrameCaptureOptions {
+  target?: FrameCaptureTarget | FrameCaptureTargetRef;
+  type?: string;
+  quality?: number;
+  waitForAnimationFrame?: boolean;
+}
+
+export type MujocoFrameCaptureOptions = Omit<FrameCaptureOptions, 'target'>;
+
+export interface FrameCaptureResult {
+  canvas: HTMLCanvasElement;
+  dataUrl: string;
+  type: string;
+}
+
+export interface FrameCaptureBlobResult {
+  canvas: HTMLCanvasElement;
+  blob: Blob;
+  type: string;
+}
+
+export interface FrameCaptureAPI {
+  status: FrameCaptureStatus;
+  error: Error | null;
+  isCapturing: boolean;
+  capture: (options?: FrameCaptureOptions) => Promise<FrameCaptureResult>;
+  captureBlob: (
+    options?: FrameCaptureOptions
+  ) => Promise<FrameCaptureBlobResult>;
+  reset: () => void;
+}
+
 // ---- Canvas Props ----
 
 export type MujocoCanvasProps = Omit<CanvasProps, 'onError'> & {
   config: SceneConfig;
   /** R3F content rendered while the MuJoCo WASM module is still loading. */
   loadingFallback?: ReactNode;
-  onReady?: (api: MujocoSimAPI) => void;
+  onReady?: (input: ReadyCallbackInput) => void;
   onError?: (error: Error) => void;
-  onStep?: (time: number) => void;
-  onSelection?: (bodyId: number, name: string) => void;
+  onStep?: (input: StepCallbackInput) => void;
+  onSelection?: (input: SelectionCallbackInput) => void;
   // Declarative physics config (spec 1.1)
   gravity?: [number, number, number];
   timestep?: number;

package/dist/chunk-SEWQULWO.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/components/VisualScenario.tsx"],"names":[],"mappings":"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","file":"chunk-SEWQULWO.js","sourcesContent":["/**\n * @license\n * SPDX-License-Identifier: Apache-2.0\n */\n\nimport { useThree } from '@react-three/fiber';\nimport type { ThreeElements } from '@react-three/fiber';\nimport type { ReactNode } from 'react';\nimport { useEffect, useMemo } from 'react';\nimport * as THREE from 'three';\nimport type {\n  PairedSplatEnvironmentConfig,\n  ScenarioMaterialConfig,\n  SceneConfig,\n  SplatCollisionProxyConfig,\n  SplatEnvironmentMetadata,\n  SplatEnvironmentMetadataInput,\n  SplatFormat,\n  SplatRendererKind,\n  SplatSceneInput,\n  ScenarioLightingPreset,\n  ScenarioLightingProps,\n  SplatEnvironmentProps,\n  VisualScenarioConfig,\n  VisualScenarioEffectsProps,\n} from '../types';\n\nconst DEFAULT_BACKGROUND = '#181a1f';\n\nexport function ScenarioLighting({\n  preset = 'studio',\n  castShadow = true,\n  intensity = 1,\n}: ScenarioLightingProps) {\n  if (preset === 'warehouse') {\n    return (\n      <>\n        <ambientLight intensity={0.18 * intensity} />\n        <directionalLight\n          position={[3.5, -2, 5]}\n          intensity={2.2 * intensity}\n          castShadow={castShadow}\n        />\n        <directionalLight position={[-2, 1.5, 2.5]} intensity={0.25 * intensity} />\n      </>\n    );\n  }\n\n  if (preset === 'low-light') {\n    return (\n      <>\n        <ambientLight intensity={0.08 * intensity} />\n        <directionalLight\n          position={[2, -2, 3]}\n          intensity={0.75 * intensity}\n          castShadow={castShadow}\n        />\n        <pointLight position={[-0.5, -0.8, 1.3]} intensity={0.6 * intensity} />\n      </>\n    );\n  }\n\n  if (preset === 'splat') {\n    return (\n      <>\n        <ambientLight intensity={0.42 * intensity} />\n        <directionalLight\n          position={[1.8, -2.4, 3.5]}\n          intensity={1.2 * intensity}\n          castShadow={castShadow}\n        />\n        <pointLight position={[0.4, 0.2, 1.4]} intensity={0.35 * intensity} />\n      </>\n    );\n  }\n\n  return (\n    <>\n      <ambientLight intensity={0.35 * intensity} />\n      <directionalLight\n        position={[2.5, -3, 4]}\n        intensity={1.6 * intensity}\n        castShadow={castShadow}\n      />\n    </>\n  );\n}\n\nexport function getScenarioBackground(\n  preset: ScenarioLightingPreset | undefined,\n  fallback = DEFAULT_BACKGROUND\n) {\n  if (preset === 'warehouse') return '#20242b';\n  if (preset === 'low-light') return '#0f1115';\n  if (preset === 'splat') return '#1b1f24';\n  return fallback;\n}\n\nexport function getScenarioCameraPosition(\n  basePosition: readonly [number, number, number],\n  scenario?: Pick<VisualScenarioConfig, 'camera'>\n): [number, number, number] {\n  const [x, y, z] = basePosition;\n  const jitter = scenario?.camera?.jitter ?? 0;\n\n  return [\n    Number((x + jitter * 0.6).toFixed(3)),\n    Number((y - jitter * 0.4).toFixed(3)),\n    Number((z + jitter * 0.25).toFixed(3)),\n  ];\n}\n\nexport function VisualScenarioEffects(props: VisualScenarioEffectsProps) {\n  useVisualScenarioEffects(props);\n  return null;\n}\n\nexport function useVisualScenarioEffects({\n  scenario,\n  enabled = true,\n  applyBackground = true,\n  applyFog = true,\n  applyRenderer = true,\n  applyMaterials = true,\n  background,\n  fogNear,\n  fogFar,\n  materialFilter,\n}: VisualScenarioEffectsProps) {\n  const { gl, scene, invalidate } = useThree();\n\n  useEffect(() => {\n    if (!enabled || !scenario) {\n      return undefined;\n    }\n\n    const previousExposure = gl.toneMappingExposure;\n    const previousBackground = scene.background;\n    const previousFog = scene.fog;\n    const materialSnapshots = new Map<\n      THREE.Material,\n      {\n        color?: THREE.Color;\n        roughness?: number;\n        metalness?: number;\n      }\n    >();\n\n    if (applyRenderer) {\n      gl.toneMappingExposure = scenario.camera?.exposure ?? 1;\n    }\n\n    if (applyBackground) {\n      scene.background = new THREE.Color(\n        background ?? getScenarioBackground(scenario.lighting)\n      );\n    }\n\n    if (applyFog) {\n      scene.fog = createScenarioFog(scenario, background, fogNear, fogFar);\n    }\n\n    if (applyMaterials && scenario.materials) {\n      applyScenarioMaterials(scene, scenario, materialSnapshots, materialFilter);\n    }\n\n    invalidate();\n\n    return () => {\n      gl.toneMappingExposure = previousExposure;\n      scene.background = previousBackground;\n      scene.fog = previousFog;\n\n      for (const [material, snapshot] of materialSnapshots) {\n        const mutable = getMutableScenarioMaterial(material);\n        if (!mutable) continue;\n        if (snapshot.color) mutable.color.copy(snapshot.color);\n        if (typeof snapshot.roughness === 'number') {\n          mutable.roughness = snapshot.roughness;\n        }\n        if (typeof snapshot.metalness === 'number') {\n          mutable.metalness = snapshot.metalness;\n        }\n        mutable.needsUpdate = true;\n      }\n\n      invalidate();\n    };\n  }, [\n    applyBackground,\n    applyFog,\n    applyMaterials,\n    applyRenderer,\n    background,\n    enabled,\n    fogFar,\n    fogNear,\n    gl,\n    invalidate,\n    materialFilter,\n    scenario,\n    scene,\n  ]);\n}\n\n/**\n * Renderer-agnostic Gaussian splat environment boundary.\n *\n * This component intentionally does not import a specific 3DGS renderer. Pass a\n * Spark/GaussianSplats3D object as `children` once the app chooses a renderer,\n * and pass MuJoCo/MJCF collision proxy visuals via `collisionProxy`.\n */\nexport function SplatEnvironment({\n  environment,\n  scenario,\n  renderer,\n  src,\n  format,\n  collisionProxy,\n  collisionProxyMetadata,\n  children,\n  showPlaceholder = true,\n  ...groupProps\n}: SplatEnvironmentProps) {\n  const metadata = useSplatEnvironment({\n    environment,\n    scenario,\n    renderer,\n    src,\n    format,\n    collisionProxy: collisionProxyMetadata,\n  });\n  const existingUserData =\n    typeof groupProps.userData === 'object' && groupProps.userData !== null\n      ? groupProps.userData\n      : {};\n\n  return (\n    <group\n      {...groupProps}\n      userData={{\n        ...existingUserData,\n        ...metadata.userData,\n      }}\n    >\n      {children}\n      {children || !showPlaceholder ? null : <SplatPlaceholder />}\n      {collisionProxy}\n    </group>\n  );\n}\n\nexport function useSplatEnvironment({\n  environment,\n  scenario,\n  renderer,\n  src,\n  format,\n  collisionProxy,\n}: SplatEnvironmentMetadataInput): SplatEnvironmentMetadata {\n  const scenarioEnvironment = useMemo(\n    () =>\n      environment ??\n      (scenario\n        ? createPairedSplatEnvironment(scenario, { renderer })\n        : undefined),\n    [environment, renderer, scenario]\n  );\n  const resolvedSrc = src ?? scenarioEnvironment?.splat.src ?? scenario?.splat?.src;\n  const resolvedFormat =\n    format ??\n    scenarioEnvironment?.splat.format ??\n    scenario?.splat?.format ??\n    'spz';\n  const resolvedCollisionProxy =\n    collisionProxy ??\n    scenarioEnvironment?.collisionProxy ??\n    scenario?.splat?.collisionProxy ??\n    undefined;\n\n  return useMemo(\n    () => ({\n      src: resolvedSrc,\n      format: resolvedFormat,\n      collisionProxy: resolvedCollisionProxy,\n      userData: createSplatEnvironmentUserData({\n        environment: scenarioEnvironment,\n        src: resolvedSrc,\n        format: resolvedFormat,\n        collisionProxy: resolvedCollisionProxy,\n      }),\n    }),\n    [scenarioEnvironment, resolvedSrc, resolvedFormat, resolvedCollisionProxy]\n  );\n}\n\n/**\n * Convert a generic visual scenario splat block into a paired visual/physics\n * environment config. Returns undefined until both the splat asset and MJCF\n * collision proxy are present.\n */\nexport function createPairedSplatEnvironment(\n  scenario: Pick<VisualScenarioConfig, 'id' | 'label' | 'environment' | 'splat'>,\n  options: {\n    id?: string;\n    label?: string;\n    description?: string;\n    renderer?: SplatRendererKind;\n  } = {}\n): PairedSplatEnvironmentConfig | undefined {\n  const splat = scenario.splat;\n  const collisionProxy = splat?.collisionProxy;\n\n  if (!splat?.enabled || !splat.src || !collisionProxy?.xmlPath) {\n    return undefined;\n  }\n\n  return {\n    id: options.id ?? scenario.id ?? 'splat-environment',\n    label: options.label ?? scenario.label ?? 'Gaussian splat environment',\n    description:\n      options.description ??\n      (scenario.environment\n        ? `Visual ${scenario.environment} splat paired with MJCF collision proxy.`\n        : undefined),\n    splat: {\n      src: splat.src,\n      format: splat.format ?? 'spz',\n      renderer: options.renderer,\n    },\n    collisionProxy: {\n      ...collisionProxy,\n      xmlPath: collisionProxy.xmlPath,\n    },\n  };\n}\n\nfunction isPairedSplatEnvironment(input: SplatSceneInput): input is PairedSplatEnvironmentConfig {\n  return !!input && 'collisionProxy' in input && 'splat' in input;\n}\n\nfunction sceneRelativePath(sceneConfig: SceneConfig, path: string): string {\n  const src = sceneConfig.src;\n  if (!src) return path;\n\n  const base = src.endsWith('/') ? src : src + '/';\n  if (path.startsWith(base)) return path.slice(base.length);\n  return path;\n}\n\nfunction uniquePaths(paths: readonly string[]): string[] {\n  const seen = new Set<string>();\n  const result: string[] = [];\n  for (const path of paths) {\n    if (seen.has(path)) continue;\n    seen.add(path);\n    result.push(path);\n  }\n  return result;\n}\n\n/**\n * Compose a MuJoCo scene config with a paired splat collision proxy.\n *\n * This keeps the common hybrid setup declarative:\n * robot XML remains `sceneFile`, the `.spz` remains a visual-only layer, and\n * the paired MJCF collision proxy is added to `environmentFiles`.\n */\nexport function withSplatEnvironment(\n  sceneConfig: SceneConfig,\n  input: SplatSceneInput,\n  options: { renderer?: SplatRendererKind } = {}\n): SceneConfig {\n  const environment = isPairedSplatEnvironment(input)\n    ? input\n    : input\n      ? createPairedSplatEnvironment(input, options)\n      : undefined;\n  const xmlPath = environment?.collisionProxy.xmlPath;\n  if (!xmlPath) return sceneConfig;\n\n  return {\n    ...sceneConfig,\n    environmentFiles: uniquePaths([\n      ...(sceneConfig.environmentFiles ?? []),\n      sceneRelativePath(sceneConfig, xmlPath),\n    ]),\n  };\n}\n\nexport function createSplatEnvironmentUserData({\n  environment,\n  src,\n  format = 'spz',\n  collisionProxy,\n}: {\n  environment?: PairedSplatEnvironmentConfig;\n  src?: string;\n  format?: SplatFormat;\n  collisionProxy?: SplatCollisionProxyConfig;\n}) {\n  return {\n    role: 'splat-environment',\n    environmentId: environment?.id,\n    environmentLabel: environment?.label,\n    splatSrc: src,\n    splatFormat: format,\n    splatRenderer: environment?.splat.renderer,\n    collisionProxyStatus: collisionProxy?.status ?? 'missing',\n    collisionProxyXmlPath: collisionProxy?.xmlPath,\n    collisionProxyPrimitives: collisionProxy?.primitives ?? [],\n  };\n}\n\nexport function createSparkSplatViewerUrl({\n  viewerUrl,\n  splatSrc,\n}: {\n  viewerUrl: string;\n  splatSrc: string;\n}) {\n  const url = new URL(viewerUrl, 'http://mujoco-react.local');\n  url.searchParams.set('splat', splatSrc);\n  return viewerUrl.startsWith('http') ? url.toString() : `${url.pathname}${url.search}`;\n}\n\nfunction SplatPlaceholder() {\n  return (\n    <group>\n      <mesh position={[0, 0, 1.2]}>\n        <boxGeometry args={[2.4, 2.4, 2.4]} />\n        <meshBasicMaterial\n          color=\"#8b8b8b\"\n          transparent\n          opacity={0.06}\n          wireframe\n          side={THREE.DoubleSide}\n        />\n      </mesh>\n    </group>\n  );\n}\n\nfunction createScenarioFog(\n  scenario: VisualScenarioConfig,\n  background: THREE.ColorRepresentation | undefined,\n  fogNear: number | undefined,\n  fogFar: number | undefined\n) {\n  if (scenario.lighting === 'low-light') {\n    return new THREE.Fog(\n      background ?? getScenarioBackground(scenario.lighting),\n      fogNear ?? 2.5,\n      fogFar ?? 9\n    );\n  }\n\n  if (scenario.lighting === 'warehouse') {\n    return new THREE.Fog(\n      background ?? getScenarioBackground(scenario.lighting),\n      fogNear ?? 5,\n      fogFar ?? 16\n    );\n  }\n\n  return null;\n}\n\nfunction applyScenarioMaterials(\n  scene: THREE.Scene,\n  scenario: VisualScenarioConfig,\n  snapshots: Map<\n    THREE.Material,\n    {\n      color?: THREE.Color;\n      roughness?: number;\n      metalness?: number;\n    }\n  >,\n  materialFilter: VisualScenarioEffectsProps['materialFilter']\n) {\n  const materials = scenario.materials;\n  if (!materials) return;\n\n  scene.traverse((object) => {\n    if (!(object instanceof THREE.Mesh)) {\n      return;\n    }\n\n    for (const material of normalizeMaterials(object.material)) {\n      const mutable = getMutableScenarioMaterial(material);\n      if (!mutable) continue;\n      if (materialFilter && !materialFilter(object, material)) continue;\n\n      if (!snapshots.has(material)) {\n        snapshots.set(material, {\n          color: mutable.color.clone(),\n          roughness: mutable.roughness,\n          metalness: mutable.metalness,\n        });\n      }\n\n      applyScenarioMaterial(mutable, object, scenario, materials);\n    }\n  });\n}\n\nfunction applyScenarioMaterial(\n  material: THREE.MeshStandardMaterial | THREE.MeshPhysicalMaterial,\n  object: THREE.Object3D,\n  scenario: VisualScenarioConfig,\n  materials: ScenarioMaterialConfig\n) {\n  const seed = scenario.seed ?? 0;\n  const objectKey = `${scenario.id ?? 'scenario'}:${object.name}:${material.name}:${seed}`;\n  const variation = hashToUnitInterval(objectKey);\n\n  if (materials.randomizeObjectColors) {\n    material.color.setHSL(variation, 0.38, 0.42);\n  }\n\n  if (materials.randomizeTableMaterial) {\n    material.roughness = clamp01(\n      materials.roughness ?? 0.35 + variation * 0.45\n    );\n    material.metalness = clamp01(\n      materials.metalness ?? variation * 0.12\n    );\n  }\n\n  material.needsUpdate = true;\n}\n\nfunction normalizeMaterials(\n  material: THREE.Material | THREE.Material[]\n): THREE.Material[] {\n  return Array.isArray(material) ? material : [material];\n}\n\nfunction getMutableScenarioMaterial(\n  material: THREE.Material\n): THREE.MeshStandardMaterial | THREE.MeshPhysicalMaterial | null {\n  if (\n    material instanceof THREE.MeshStandardMaterial ||\n    material instanceof THREE.MeshPhysicalMaterial\n  ) {\n    return material;\n  }\n\n  return null;\n}\n\nfunction hashToUnitInterval(value: string) {\n  let hash = 2166136261;\n  for (let index = 0; index < value.length; index += 1) {\n    hash ^= value.charCodeAt(index);\n    hash = Math.imul(hash, 16777619);\n  }\n  return (hash >>> 0) / 4294967295;\n}\n\nfunction clamp01(value: number) {\n  return Math.max(0, Math.min(1, value));\n}\n\nexport type SplatCollisionProxy = ReactNode | ThreeElements['group'];\n"]}