mujoco-react 0.2.0 → 1.0.0

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { CanvasProps } from '@react-three/fiber';
+import { CanvasProps, ThreeElements } from '@react-three/fiber';
 import * as THREE from 'three';
 import * as react from 'react';
 
@@ -8,6 +8,28 @@ import * as react from 'react';
  * SPDX-License-Identifier: Apache-2.0
  */
 
+/**
+ * A single MuJoCo contact from the WASM module.
+ * Accessed via `data.contact.get(i)`.
+ */
+interface MujocoContact {
+    geom1: number;
+    geom2: number;
+    pos: Float64Array;
+    frame: Float64Array;
+    dist: number;
+}
+/**
+ * WASM contact array — supports indexed access via `.get(i)`.
+ */
+interface MujocoContactArray {
+    get(i: number): MujocoContact | undefined;
+}
+/**
+ * Read a single contact from the WASM contact array.
+ * Returns undefined if the access fails (WASM heap issue, bad index, etc.).
+ */
+declare function getContact(data: MujocoData, i: number): MujocoContact | undefined;
 /**
  * Minimal interface for MuJoCo Model to avoid 'any'.
  */
@@ -45,11 +67,14 @@ interface MujocoModel {
     body_geomnum: Int32Array;
     body_geomadr: Int32Array;
     body_inertia: Float64Array;
+    qpos0: Float64Array;
     jnt_qposadr: Int32Array;
     jnt_dofadr: Int32Array;
     jnt_type: Int32Array;
     jnt_range: Float64Array;
     jnt_bodyid: Int32Array;
+    jnt_pos: Float64Array;
+    jnt_axis: Float64Array;
     jnt_limited: Uint8Array;
     geom_group: Int32Array;
     geom_type: Int32Array;
@@ -135,7 +160,7 @@ interface MujocoData {
     site_xmat: Float64Array;
     sensordata: Float64Array;
     ncon: number;
-    contact: unknown;
+    contact: MujocoContactArray;
     cvel: Float64Array;
     cfrc_ext: Float64Array;
     ten_length: Float64Array;
@@ -212,13 +237,22 @@ interface SceneConfig {
     sceneFile: string;
     baseUrl?: string;
     sceneObjects?: SceneObject[];
-    tcpSiteName?: string;
-    gripperActuatorName?: string;
-    numArmJoints?: number;
     homeJoints?: number[];
     xmlPatches?: XmlPatch[];
     onReset?: (model: MujocoModel, data: MujocoData) => void;
 }
+interface IkConfig {
+    /** MuJoCo site name for IK target. */
+    siteName: string;
+    /** Number of joints to solve for. */
+    numJoints: number;
+    /** Custom IK solver. When omitted, uses built-in Damped Least-Squares solver. */
+    ikSolveFn?: IKSolveFn;
+    /** DLS damping. Default: 0.01. */
+    damping?: number;
+    /** Max solver iterations. Default: 50. */
+    maxIterations?: number;
+}
 interface SceneMarker {
     id: number;
     position: THREE.Vector3;
@@ -230,7 +264,6 @@ interface PhysicsConfig {
     substeps?: number;
     paused?: boolean;
     speed?: number;
-    interpolate?: boolean;
 }
 type IKSolveFn = (pos: THREE.Vector3, quat: THREE.Quaternion, currentQ: number[]) => number[] | null;
 type PhysicsStepCallback = (model: MujocoModel, data: MujocoData) => void;
@@ -407,14 +440,6 @@ interface MujocoSimAPI {
     getKeyframeNames(): string[];
     getKeyframeCount(): number;
     loadScene(newConfig: SceneConfig): Promise<void>;
-    setIkEnabled(enabled: boolean): void;
-    moveTarget(pos: THREE.Vector3, duration?: number): void;
-    syncTargetToSite(): void;
-    solveIK(pos: THREE.Vector3, quat: THREE.Quaternion, currentQ: number[]): number[] | null;
-    getGizmoStats(): {
-        pos: THREE.Vector3;
-        rot: THREE.Euler;
-    } | null;
     getCanvasSnapshot(width?: number, height?: number, mimeType?: string): string;
     project2DTo3D(x: number, y: number, cameraPos: THREE.Vector3, lookAt: THREE.Vector3): {
         point: THREE.Vector3;
@@ -424,11 +449,6 @@ interface MujocoSimAPI {
     setBodyMass(name: string, mass: number): void;
     setGeomFriction(name: string, friction: [number, number, number]): void;
     setGeomSize(name: string, size: [number, number, number]): void;
-    getCameraState(): {
-        position: THREE.Vector3;
-        target: THREE.Vector3;
-    };
-    moveCameraTo(position: THREE.Vector3, target: THREE.Vector3, durationMs: number): Promise<void>;
     readonly mjModelRef: React.RefObject<MujocoModel | null>;
     readonly mjDataRef: React.RefObject<MujocoData | null>;
 }
@@ -443,9 +463,6 @@ type MujocoCanvasProps = Omit<CanvasProps, 'onError'> & {
     substeps?: number;
     paused?: boolean;
     speed?: number;
-    interpolate?: boolean;
-    gravityCompensation?: boolean;
-    mjcfLights?: boolean;
 };
 interface SitePositionResult {
     position: React.RefObject<THREE.Vector3>;
@@ -477,6 +494,8 @@ interface JointStateResult {
 declare function useMujoco(): MujocoContextValue;
 interface MujocoProviderProps {
     wasmUrl?: string;
+    /** Timeout in ms for WASM module load. Default: 30000. */
+    timeout?: number;
     children: React.ReactNode;
     onError?: (error: Error) => void;
 }
@@ -484,7 +503,7 @@ interface MujocoProviderProps {
  * MujocoProvider — WASM / module lifecycle.
  * Loads the MuJoCo WASM module on mount and provides it to children via context.
  */
-declare function MujocoProvider({ wasmUrl, children, onError }: MujocoProviderProps): react_jsx_runtime.JSX.Element;
+declare function MujocoProvider({ wasmUrl, timeout, children, onError }: MujocoProviderProps): react_jsx_runtime.JSX.Element;
 
 /**
  * MujocoCanvas — thin R3F Canvas wrapper for MuJoCo scenes.
@@ -495,41 +514,49 @@ declare function MujocoProvider({ wasmUrl, children, onError }: MujocoProviderPr
  */
 declare const MujocoCanvas: react.ForwardRefExoticComponent<Omit<MujocoCanvasProps, "ref"> & react.RefAttributes<MujocoSimAPI>>;
 
-/**
- * @license
- * SPDX-License-Identifier: Apache-2.0
- */
-
-interface GenericIKOptions {
-    maxIterations: number;
-    damping: number;
-    tolerance: number;
-    epsilon: number;
-    posWeight: number;
-    rotWeight: number;
+interface MujocoPhysicsProps {
+    /** Scene/robot configuration. */
+    config: SceneConfig;
+    /** Fires when model is loaded and API is ready. */
+    onReady?: (api: MujocoSimAPI) => void;
+    /** Fires on scene load failure. */
+    onError?: (error: Error) => void;
+    /** Called each physics step. */
+    onStep?: (time: number) => void;
+    /** Called on body double-click selection. */
+    onSelection?: (bodyId: number, name: string) => void;
+    /** Override model gravity. */
+    gravity?: [number, number, number];
+    /** Override model.opt.timestep. */
+    timestep?: number;
+    /** mj_step calls per frame. */
+    substeps?: number;
+    /** Declarative pause. */
+    paused?: boolean;
+    /** Simulation speed multiplier. */
+    speed?: number;
+    children: React.ReactNode;
 }
 /**
- * Generic Damped Least-Squares IK solver.
- * Uses finite-difference Jacobian via MuJoCo's mj_forward.
- * Works for any MuJoCo model — no robot-specific parameters.
- */
-declare class GenericIK {
-    private mujoco;
-    constructor(mujoco: MujocoModule);
-    /**
-     * Solve IK for a target 6-DOF pose.
-     * @param model       MuJoCo model
-     * @param data        MuJoCo data (qpos will be temporarily modified, then restored)
-     * @param siteId      Index of the end-effector site to control
-     * @param numJoints   Number of arm joints (assumes qpos[0..numJoints-1])
-     * @param targetPos   Target position in world frame
-     * @param targetQuat  Target orientation in world frame
-     * @param currentQ    Current joint angles (length = numJoints)
-     * @param opts        Optional solver parameters
-     * @returns Joint angles array, or null if solver diverged
-     */
-    solve(model: MujocoModel, data: MujocoData, siteId: number, numJoints: number, targetPos: THREE.Vector3, targetQuat: THREE.Quaternion, currentQ: number[], opts?: Partial<GenericIKOptions>): number[] | null;
-}
+ * MujocoPhysics — physics provider for use inside a user-owned R3F Canvas.
+ *
+ * This is the R3F-idiomatic alternative to MujocoCanvas. Instead of wrapping
+ * the Canvas, place this inside your own <Canvas>:
+ *
+ * ```tsx
+ * <MujocoProvider>
+ *   <Canvas shadows camera={...}>
+ *     <MujocoPhysics config={config} paused={paused}>
+ *       <SceneRenderer />
+ *       <OrbitControls />
+ *     </MujocoPhysics>
+ *   </Canvas>
+ * </MujocoProvider>
+ * ```
+ *
+ * Forward ref exposes MujocoSimAPI.
+ */
+declare const MujocoPhysics: react.ForwardRefExoticComponent<MujocoPhysicsProps & react.RefAttributes<MujocoSimAPI>>;
 
 interface MujocoSimContextValue {
     api: MujocoSimAPI;
@@ -537,41 +564,13 @@ interface MujocoSimContextValue {
     mjDataRef: React.RefObject<MujocoData | null>;
     mujocoRef: React.RefObject<MujocoModule>;
     configRef: React.RefObject<SceneConfig>;
-    siteIdRef: React.RefObject<number>;
-    gripperIdRef: React.RefObject<number>;
-    ikEnabledRef: React.RefObject<boolean>;
-    ikCalculatingRef: React.RefObject<boolean>;
     pausedRef: React.RefObject<boolean>;
     speedRef: React.RefObject<number>;
     substepsRef: React.RefObject<number>;
-    ikTargetRef: React.RefObject<THREE.Group>;
-    genericIkRef: React.RefObject<GenericIK>;
-    ikSolveFnRef: React.RefObject<IKSolveFn>;
-    firstIkEnableRef: React.RefObject<boolean>;
-    gizmoAnimRef: React.RefObject<{
-        active: boolean;
-        startPos: THREE.Vector3;
-        endPos: THREE.Vector3;
-        startRot: THREE.Quaternion;
-        endRot: THREE.Quaternion;
-        startTime: number;
-        duration: number;
-    }>;
-    cameraAnimRef: React.RefObject<{
-        active: boolean;
-        startPos: THREE.Vector3;
-        endPos: THREE.Vector3;
-        startRot: THREE.Quaternion;
-        endRot: THREE.Quaternion;
-        startTarget: THREE.Vector3;
-        endTarget: THREE.Vector3;
-        startTime: number;
-        duration: number;
-        resolve: (() => void) | null;
-    }>;
     onSelectionRef: React.RefObject<((bodyId: number, name: string) => void) | undefined>;
     beforeStepCallbacks: React.RefObject<Set<PhysicsStepCallback>>;
     afterStepCallbacks: React.RefObject<Set<PhysicsStepCallback>>;
+    resetCallbacks: React.RefObject<Set<() => void>>;
     status: 'loading' | 'ready' | 'error';
 }
 declare function useMujocoSim(): MujocoSimContextValue;
@@ -590,10 +589,9 @@ interface MujocoSimProviderProps {
     substeps?: number;
     paused?: boolean;
     speed?: number;
-    interpolate?: boolean;
     children: React.ReactNode;
 }
-declare function MujocoSimProvider({ mujoco, config, apiRef: externalApiRef, onReady, onError, onStep, onSelection, gravity, timestep, substeps, paused, speed, interpolate, children, }: MujocoSimProviderProps): react_jsx_runtime.JSX.Element;
+declare function MujocoSimProvider({ mujoco, config, apiRef: externalApiRef, onReady, onError, onStep, onSelection, gravity, timestep, substeps, paused, speed, children, }: MujocoSimProviderProps): react_jsx_runtime.JSX.Element;
 
 /**
  * @license
@@ -639,8 +637,6 @@ declare function findTendonByName(mjModel: MujocoModel, name: string): number;
 interface LoadResult {
     mjModel: MujocoModel;
     mjData: MujocoData;
-    siteId: number;
-    gripperId: number;
 }
 /**
  * Config-driven scene loader — replaces the old RobotLoader + patchSingleRobot approach.
@@ -650,52 +646,109 @@ declare function loadScene(mujoco: MujocoModule, config: SceneConfig, onProgress
 /**
  * @license
  * SPDX-License-Identifier: Apache-2.0
+ *
+ * createController — typed factory for BYOC (Bring Your Own Controller) plugins.
  */
+interface ControllerOptions<TConfig> {
+    /** Unique name for this controller (used as displayName). */
+    name: string;
+    /** Default values merged under user-supplied config. */
+    defaultConfig?: Partial<TConfig>;
+}
+type ControllerComponent<TConfig> = React.FC<{
+    config?: Partial<TConfig>;
+    children?: React.ReactNode;
+}> & {
+    controllerName: string;
+    defaultConfig: Partial<TConfig>;
+};
+/**
+ * Factory that produces a typed controller component.
+ *
+ * Controllers are React components that plug into the MuJoCo simulation tree.
+ * Inside `Impl`, use any hooks (`useMujocoSim`, `useBeforePhysicsStep`, etc.)
+ * to interact with the physics engine.
+ *
+ * @example
+ * ```tsx
+ * const MyController = createController<{ speed: number }>(
+ *   { name: 'my-controller', defaultConfig: { speed: 1.0 } },
+ *   function MyControllerImpl({ config }) {
+ *     useBeforePhysicsStep((_model, data) => {
+ *       data.ctrl[0] = config.speed;
+ *     });
+ *     return null;
+ *   },
+ * );
+ *
+ * // Usage:
+ * <MyController config={{ speed: 2.0 }} />
+ * ```
+ */
+declare function createController<TConfig>(options: ControllerOptions<TConfig>, Impl: React.FC<{
+    config: TConfig;
+    children?: React.ReactNode;
+}>): ControllerComponent<TConfig>;
+
+declare const IkController: ControllerComponent<IkConfig>;
+
+interface IkContextValue {
+    ikEnabledRef: React.RefObject<boolean>;
+    ikCalculatingRef: React.RefObject<boolean>;
+    ikTargetRef: React.RefObject<THREE.Group>;
+    siteIdRef: React.RefObject<number>;
+    setIkEnabled(enabled: boolean): void;
+    moveTarget(pos: THREE.Vector3, duration?: number): void;
+    syncTargetToSite(): void;
+    solveIK(pos: THREE.Vector3, quat: THREE.Quaternion, currentQ: number[]): number[] | null;
+    getGizmoStats(): {
+        pos: THREE.Vector3;
+        rot: THREE.Euler;
+    } | null;
+}
+/**
+ * Access the IK controller context.
+ *
+ * - `useIk()` — throws if no `<IkController>` ancestor (use inside `<IkController>`)
+ * - `useIk({ optional: true })` — returns `null` if no ancestor (use in components
+ *   that optionally interact with IK, e.g. keyboard controllers that disable IK)
+ */
+declare function useIk(): IkContextValue;
+declare function useIk(options: {
+    optional: true;
+}): IkContextValue | null;
+
 /**
  * SceneRenderer — creates and syncs MuJoCo body meshes every frame.
- * Replaces RenderSystem.initScene() + RenderSystem.update() body loop.
+ * Accepts standard R3F group props (position, rotation, scale, visible, etc.).
  */
-declare function SceneRenderer(): react_jsx_runtime.JSX.Element;
+declare function SceneRenderer(props: Omit<ThreeElements['group'], 'ref'>): react_jsx_runtime.JSX.Element;
 
 /**
  * IkGizmo — drei PivotControls that tracks a MuJoCo site.
  *
+ * Must be rendered inside an `<IkController>`.
+ *
  * Props:
- * - `siteName` — MuJoCo site to track. Defaults to `SceneConfig.tcpSiteName`.
+ * - `siteName` — MuJoCo site to track. Defaults to the IkController's configured site.
  * - `scale` — Gizmo handle scale. Default: 0.18.
  * - `onDrag` — Custom drag callback `(pos, quat) => void`.
- *   When omitted, dragging enables IK and writes to the provider's IK target.
+ *   When omitted, dragging enables IK and writes to the IK target.
  *   When provided, the consumer handles what happens during drag.
- *
- * Multiple gizmos can be rendered — each tracks its own site.
- * Zero gizmos is fine — programmatic IK control works via the provider API.
- *
- * Uses a tiny invisible mesh as child instead of axesHelper — PivotControls
- * computes an anchor offset from children's bounding box, and axesHelper's
- * (0→0.15) bounds would shift the handles away from the TCP origin.
  */
 declare function IkGizmo({ siteName, scale, onDrag }: IkGizmoProps): react_jsx_runtime.JSX.Element | null;
 
-/**
- * @license
- * SPDX-License-Identifier: Apache-2.0
- *
- * ContactMarkers — instanced sphere visualization of MuJoCo contacts (spec 6.2)
- *
- * Fixed from original: reads data.ncon first, accesses contact via .get(i),
- * limits to maxContacts to avoid WASM heap OOM.
- */
 interface ContactMarkersProps {
     /** Maximum contacts to render. Default: 100. */
     maxContacts?: number;
-    /** Sphere radius. Default: 0.005. */
+    /** Sphere radius. Default: 0.008. */
     radius?: number;
-    /** Color. Default: '#4f46e5'. */
+    /** Color. Default: '#22d3ee'. */
     color?: string;
     /** Show markers. Default: true. */
     visible?: boolean;
 }
-declare function ContactMarkers({ maxContacts, radius, color, visible, }?: ContactMarkersProps): react_jsx_runtime.JSX.Element | null;
+declare function ContactMarkers({ maxContacts, radius, color, visible, ...groupProps }?: ContactMarkersProps & Omit<ThreeElements['group'], 'ref' | 'visible'>): react_jsx_runtime.JSX.Element | null;
 
 /**
  * DragInteraction — Ctrl/Cmd+click-drag to apply spring forces to MuJoCo bodies.
@@ -710,7 +763,7 @@ declare function ContactMarkers({ maxContacts, radius, color, visible, }?: Conta
  * Forces compose with useGravityCompensation — the provider zeros
  * qfrc_applied each frame, then all consumers add to it.
  */
-declare function DragInteraction({ stiffness, showArrow, }: DragInteractionProps): react_jsx_runtime.JSX.Element | null;
+declare function DragInteraction({ stiffness, showArrow, ...groupProps }: DragInteractionProps & Omit<ThreeElements['group'], 'ref'>): react_jsx_runtime.JSX.Element | null;
 
 /**
  * @license
@@ -732,33 +785,15 @@ declare function SceneLights({ intensity }: SceneLightsProps): null;
  * Declarative debug visualization component.
  * Renders wireframe geoms, site markers, joint axes, contact forces, COM markers, etc.
  */
-declare function Debug({ showGeoms, showSites, showJoints, showContacts, showCOM, showInertia, showTendons, }: DebugProps): react_jsx_runtime.JSX.Element | null;
+declare function Debug({ showGeoms, showSites, showJoints, showContacts, showCOM, showInertia, showTendons, ...groupProps }: DebugProps & Omit<ThreeElements['group'], 'ref'>): react_jsx_runtime.JSX.Element | null;
 
-/**
- * @license
- * SPDX-License-Identifier: Apache-2.0
- *
- * TendonRenderer — render tendons as tube geometries (spec 6.4)
- *
- * WASM fields used: model.ntendon, model.ten_wrapadr, model.ten_wrapnum
- * data.wrap_xpos, data.ten_wrapadr (runtime)
- *
- * Note: ten_rgba and ten_width are NOT available in mujoco-js 0.0.7.
- * Tendons use a default color and width.
- */
-declare function TendonRenderer(): react_jsx_runtime.JSX.Element | null;
+declare function TendonRenderer(props: Omit<ThreeElements['group'], 'ref'>): react_jsx_runtime.JSX.Element | null;
 
-/**
- * @license
- * SPDX-License-Identifier: Apache-2.0
- *
- * FlexRenderer — render deformable flex bodies (spec 6.4)
- */
 /**
  * Renders MuJoCo flex (deformable) bodies as dynamic meshes.
  * Vertices are updated every frame from flexvert_xpos.
  */
-declare function FlexRenderer(): react_jsx_runtime.JSX.Element | null;
+declare function FlexRenderer(props: Omit<ThreeElements['group'], 'ref'>): react_jsx_runtime.JSX.Element | null;
 
 /**
  * @license
@@ -1080,4 +1115,49 @@ interface CtrlNoiseConfig {
  */
 declare function useCtrlNoise(config?: CtrlNoiseConfig): void;
 
-export { type ActuatorInfo, type BodyInfo, type BodyStateResult, type ContactInfo, ContactListener, type ContactListenerProps, ContactMarkers, Debug, type DebugProps, DragInteraction, type DragInteractionProps, FlexRenderer, type GeomInfo, type IKSolveFn, IkGizmo, type IkGizmoProps, type JointInfo, type JointStateResult, type KeyBinding, type KeyboardTeleopConfig, type ModelOptions, MujocoCanvas, type MujocoCanvasProps, type MujocoContextValue, type MujocoData, type MujocoModel, type MujocoModule, MujocoProvider, type MujocoSimAPI, MujocoSimProvider, type PhysicsConfig, type PhysicsStepCallback, type PolicyConfig, type RayHit, type SceneConfig, SceneLights, type SceneLightsProps, type SceneMarker, type SceneObject, SceneRenderer, SelectionHighlight, type SelectionHighlightProps, type SensorInfo, type SensorResult, type SiteInfo, type SitePositionResult, type StateSnapshot, TendonRenderer, type TrajectoryData, type TrajectoryFrame, TrajectoryPlayer, type TrajectoryPlayerProps, type XmlPatch, findActuatorByName, findBodyByName, findGeomByName, findJointByName, findKeyframeByName, findSensorByName, findSiteByName, findTendonByName, getName, loadScene, useActuators, useAfterPhysicsStep, useBeforePhysicsStep, useBodyState, useContactEvents, useContacts, useCtrl, useCtrlNoise, useGamepad, useGravityCompensation, useJointState, useKeyboardTeleop, useMujoco, useMujocoSim, usePolicy, useSensor, useSensors, useSitePosition, useTrajectoryPlayer, useTrajectoryRecorder, useVideoRecorder };
+/**
+ * @license
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * useSelectionHighlight — hook form of SelectionHighlight (spec 6.5)
+ *
+ * Applies emissive highlight to all meshes belonging to a body.
+ * Restores original emissive when bodyId changes or hook unmounts.
+ */
+declare function useSelectionHighlight(bodyId: number | null, options?: {
+    color?: string;
+    emissiveIntensity?: number;
+}): void;
+
+/**
+ * @license
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * useSceneLights — hook form of SceneLights (spec 6.3)
+ *
+ * Auto-creates Three.js lights from MJCF <light> elements.
+ */
+declare function useSceneLights(intensity?: number): void;
+
+/**
+ * @license
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * useCameraAnimation — composable camera animation hook.
+ */
+
+interface CameraAnimationAPI {
+    getCameraState(): {
+        position: THREE.Vector3;
+        target: THREE.Vector3;
+    };
+    moveCameraTo(position: THREE.Vector3, target: THREE.Vector3, durationMs: number): Promise<void>;
+}
+/**
+ * Standalone hook for animated camera transitions.
+ *
+ * Manages its own `useFrame` callback — drop it into any component inside `<Canvas>`.
+ */
+declare function useCameraAnimation(): CameraAnimationAPI;
+
+export { type ActuatorInfo, type BodyInfo, type BodyStateResult, type CameraAnimationAPI, type ContactInfo, ContactListener, type ContactListenerProps, ContactMarkers, type ControllerComponent, type ControllerOptions, Debug, type DebugProps, DragInteraction, type DragInteractionProps, FlexRenderer, type GeomInfo, type IKSolveFn, type IkConfig, type IkContextValue, IkController, IkGizmo, type IkGizmoProps, type JointInfo, type JointStateResult, type KeyBinding, type KeyboardTeleopConfig, type ModelOptions, MujocoCanvas, type MujocoCanvasProps, type MujocoContact, type MujocoContactArray, type MujocoContextValue, type MujocoData, type MujocoModel, type MujocoModule, MujocoPhysics, type MujocoPhysicsProps, MujocoProvider, type MujocoSimAPI, MujocoSimProvider, type PhysicsConfig, type PhysicsStepCallback, type PolicyConfig, type RayHit, type SceneConfig, SceneLights, type SceneLightsProps, type SceneMarker, type SceneObject, SceneRenderer, SelectionHighlight, type SelectionHighlightProps, type SensorInfo, type SensorResult, type SiteInfo, type SitePositionResult, type StateSnapshot, TendonRenderer, type TrajectoryData, type TrajectoryFrame, TrajectoryPlayer, type TrajectoryPlayerProps, type XmlPatch, createController, findActuatorByName, findBodyByName, findGeomByName, findJointByName, findKeyframeByName, findSensorByName, findSiteByName, findTendonByName, getContact, getName, loadScene, useActuators, useAfterPhysicsStep, useBeforePhysicsStep, useBodyState, useCameraAnimation, useContactEvents, useContacts, useCtrl, useCtrlNoise, useGamepad, useGravityCompensation, useIk, useJointState, useKeyboardTeleop, useMujoco, useMujocoSim, usePolicy, useSceneLights, useSelectionHighlight, useSensor, useSensors, useSitePosition, useTrajectoryPlayer, useTrajectoryRecorder, useVideoRecorder };