@react-three/rapier 1.3.1 → 1.5.0

package/dist/declarations/src/components/AnyCollider.d.ts

@@ -1,7 +1,7 @@
 import { Collider } from "@dimforge/rapier3d-compat";
 import React, { ReactNode } from "react";
-import { ColliderOptions, CuboidArgs, RoundCuboidArgs, BallArgs, CapsuleArgs, HeightfieldArgs, TrimeshArgs, ConeArgs, CylinderArgs, ConvexHullArgs, RoundCylinderArgs } from "../types";
-import { RoundConeArgs } from "../types";
+import { ColliderOptions, CuboidArgs, RoundCuboidArgs, BallArgs, CapsuleArgs, HeightfieldArgs, TrimeshArgs, ConeArgs, CylinderArgs, ConvexHullArgs, RoundCylinderArgs } from "../types.js";
+import { RoundConeArgs } from "../types.js";
 export interface ColliderProps extends ColliderOptions<any> {
     children?: ReactNode;
 }

package/dist/declarations/src/components/InstancedRigidBodies.d.ts

@@ -1,6 +1,6 @@
 import React, { ReactNode } from "react";
-import { RigidBodyProps } from "./RigidBody";
-import { RapierRigidBody } from "../types";
+import { RigidBodyProps } from "./RigidBody.js";
+import { RapierRigidBody } from "../types.js";
 export declare type InstancedRigidBodyProps = RigidBodyProps & {
     key: string | number;
 };

package/dist/declarations/src/components/MeshCollider.d.ts

@@ -1,5 +1,5 @@
 import React, { ReactNode } from "react";
-import { RigidBodyAutoCollider } from "../types";
+import { RigidBodyAutoCollider } from "../types.js";
 export interface MeshColliderProps {
     children: ReactNode;
     type: RigidBodyAutoCollider;
@@ -8,4 +8,4 @@ export interface MeshColliderProps {
  * A mesh collider is a collider that is automatically generated from the geometry of the children.
  * @category Colliders
  */
-export declare const MeshCollider: React.MemoExoticComponent<(props: MeshColliderProps) => JSX.Element>;
+export declare const MeshCollider: React.MemoExoticComponent<(props: MeshColliderProps) => import("react/jsx-runtime").JSX.Element>;

package/dist/declarations/src/components/Physics.d.ts

@@ -2,7 +2,7 @@ import type Rapier from "@dimforge/rapier3d-compat";
 import { Collider, ColliderHandle, RigidBody, RigidBodyHandle, World } from "@dimforge/rapier3d-compat";
 import React, { FC, ReactNode } from "react";
 import { Matrix4, Object3D, Vector3 } from "three";
-import { CollisionEnterHandler, CollisionExitHandler, ContactForceHandler, IntersectionEnterHandler, IntersectionExitHandler, RigidBodyAutoCollider, Vector3Tuple } from "../types";
+import { CollisionEnterHandler, CollisionExitHandler, ContactForceHandler, IntersectionEnterHandler, IntersectionExitHandler, RigidBodyAutoCollider, Vector3Tuple } from "../types.js";
 export interface RigidBodyState {
     meshType: "instancedMesh" | "mesh";
     rigidBody: RigidBody;
@@ -197,11 +197,24 @@ export interface PhysicsProps {
      */
     maxCcdSubsteps?: number;
     /**
-     * The Error Reduction Parameter in between 0 and 1, is the proportion of the positional error to be corrected at each time step.
+     * Directly affects the `erp` (Error Reduction Parameter) which is the proportion (0 to 1) of the positional error to be corrected at each time step.
+     * The higher this value is, the more the physics engine will try to correct errors.
      *
-     * @defaultValue 0.8
+     * This prop is currently undocumented in the Rapier documentation.
+     *
+     * @see https://github.com/dimforge/rapier/pull/651 where this change was made to Rapier
+     * @defaultValue 30
+     */
+    contactNaturalFrequency?: number;
+    /**
+     * The approximate size of most dynamic objects in the scene.
+     *
+     * This value is used internally to estimate some length-based tolerance.
+     * This value can be understood as the number of units-per-meter in your physical world compared to a human-sized world in meter.
+     *
+     * @defaultValue 1
      */
-    erp?: number;
+    lengthUnit?: number;
     /**
      * Set the base automatic colliders for this physics world
      * All Meshes inside RigidBodies will generate a collider

package/dist/declarations/src/components/RigidBody.d.ts

@@ -1,7 +1,7 @@
 import React, { MutableRefObject, RefObject } from "react";
 import { ReactNode } from "react";
 import { Object3D } from "three";
-import { RapierRigidBody, RigidBodyOptions } from "../types";
+import { RapierRigidBody, RigidBodyOptions } from "../types.js";
 export declare const RigidBodyContext: React.Context<{
     ref: RefObject<Object3D> | MutableRefObject<Object3D>;
     getRigidBody: () => RapierRigidBody;

package/dist/declarations/src/hooks/hooks.d.ts

@@ -1,7 +1,7 @@
 import React, { MutableRefObject } from "react";
-import { RapierContext, WorldStepCallback } from "../components/Physics";
+import { RapierContext, WorldStepCallback } from "../components/Physics.js";
 import { Object3D } from "three";
-import { ColliderProps, RigidBodyProps } from "..";
+import { ColliderProps, RigidBodyProps } from "../index.js";
 /**
  * Exposes the Rapier context, and world
  * @category Hooks
@@ -20,4 +20,4 @@ export declare const useAfterPhysicsStep: (callback: WorldStepCallback) => void;
 /**
  * @internal
  */
-export declare const useChildColliderProps: <O extends Object3D<import("three").Event>>(ref: React.MutableRefObject<O | null | undefined>, options: RigidBodyProps, ignoreMeshColliders?: boolean) => ColliderProps[];
+export declare const useChildColliderProps: <O extends Object3D<import("three").Object3DEventMap>>(ref: React.MutableRefObject<O | null | undefined>, options: RigidBodyProps, ignoreMeshColliders?: boolean) => ColliderProps[];

package/dist/declarations/src/hooks/joints.d.ts

@@ -1,6 +1,6 @@
 import { FixedImpulseJoint, ImpulseJoint, PrismaticImpulseJoint, RevoluteImpulseJoint, RopeImpulseJoint, SphericalImpulseJoint, SpringImpulseJoint } from "@dimforge/rapier3d-compat";
 import { RefObject } from "react";
-import { FixedJointParams, PrismaticJointParams, RapierRigidBody, RevoluteJointParams, RopeJointParams, SphericalJointParams, SpringJointParams, UseImpulseJoint } from "..";
+import { FixedJointParams, PrismaticJointParams, RapierRigidBody, RevoluteJointParams, RopeJointParams, SphericalJointParams, SpringJointParams, UseImpulseJoint } from "../index.js";
 import type Rapier from "@dimforge/rapier3d-compat";
 /**
  * @internal

package/dist/declarations/src/index.d.ts

@@ -1,15 +1,15 @@
-export * from "./types";
-export type { RigidBodyProps } from "./components/RigidBody";
-export type { InstancedRigidBodiesProps, InstancedRigidBodyProps } from "./components/InstancedRigidBodies";
-export type { CylinderColliderProps, BallColliderProps, CapsuleColliderProps, ConeColliderProps, ConvexHullColliderProps, CuboidColliderProps, HeightfieldColliderProps, RoundCuboidColliderProps, TrimeshColliderProps, ColliderOptionsRequiredArgs } from "./components/AnyCollider";
-export type { PhysicsProps, RapierContext, WorldStepCallback } from "./components/Physics";
-export type { MeshColliderProps } from "./components/MeshCollider";
-export { Physics } from "./components/Physics";
-export { RigidBody } from "./components/RigidBody";
-export { MeshCollider } from "./components/MeshCollider";
-export { InstancedRigidBodies } from "./components/InstancedRigidBodies";
-export * from "./components/AnyCollider";
-export * from "./hooks/joints";
-export { useRapier, useBeforePhysicsStep, useAfterPhysicsStep } from "./hooks/hooks";
-export * from "./utils/interaction-groups";
-export * from "./utils/three-object-helpers";
+export * from "./types.js";
+export type { RigidBodyProps } from "./components/RigidBody.js";
+export type { InstancedRigidBodiesProps, InstancedRigidBodyProps } from "./components/InstancedRigidBodies.js";
+export type { CylinderColliderProps, BallColliderProps, CapsuleColliderProps, ConeColliderProps, ConvexHullColliderProps, CuboidColliderProps, HeightfieldColliderProps, RoundCuboidColliderProps, TrimeshColliderProps, ColliderOptionsRequiredArgs } from "./components/AnyCollider.js";
+export type { PhysicsProps, RapierContext, WorldStepCallback } from "./components/Physics.js";
+export type { MeshColliderProps } from "./components/MeshCollider.js";
+export { Physics } from "./components/Physics.js";
+export { RigidBody } from "./components/RigidBody.js";
+export { MeshCollider } from "./components/MeshCollider.js";
+export { InstancedRigidBodies } from "./components/InstancedRigidBodies.js";
+export * from "./components/AnyCollider.js";
+export * from "./hooks/joints.js";
+export { useRapier, useBeforePhysicsStep, useAfterPhysicsStep } from "./hooks/hooks.js";
+export * from "./utils/interaction-groups.js";
+export * from "./utils/three-object-helpers.js";

package/dist/declarations/src/types.d.ts

@@ -1,12 +1,12 @@
 import { MutableRefObject, RefObject } from "react";
-import { CoefficientCombineRule, Collider as RapierCollider, ImpulseJoint, InteractionGroups, RigidBody as RapierRigidBody, TempContactManifold } from "@dimforge/rapier3d-compat";
+import { ActiveCollisionTypes, CoefficientCombineRule, ImpulseJoint, InteractionGroups, Collider as RapierCollider, RigidBody as RapierRigidBody, TempContactManifold } from "@dimforge/rapier3d-compat";
 import { Rotation, Vector } from "@dimforge/rapier3d-compat/math";
-import { Object3DProps, Vector3, Quaternion } from "@react-three/fiber";
+import { Object3DProps, Quaternion, Vector3 } from "@react-three/fiber";
 import { Object3D } from "three";
-import { ColliderProps } from ".";
-import { RigidBodyState } from "./components/Physics";
+import { ColliderProps } from "./index.js";
+import { RigidBodyState } from "./components/Physics.js";
 export { CoefficientCombineRule as CoefficientCombineRule } from "@dimforge/rapier3d-compat";
-export { RapierRigidBody, RapierCollider };
+export { RapierCollider, RapierRigidBody };
 export declare type RefGetter<T> = MutableRefObject<() => T | undefined>;
 export declare type RigidBodyAutoCollider = "ball" | "cuboid" | "hull" | "trimesh" | false;
 export declare type CuboidArgs = [
@@ -139,7 +139,7 @@ export interface ColliderOptions<ColliderArgs extends Array<unknown>> {
      */
     scale?: Object3DProps["scale"];
     /**
-     * Callback when this collider collides with another collider.
+     * Callback when this collider collideas with another collider.
      */
     onCollisionEnter?: CollisionEnterHandler;
     /**
@@ -166,6 +166,15 @@ export interface ColliderOptions<ColliderArgs extends Array<unknown>> {
      * The bit mask configuring the groups and mask for solver handling.
      */
     solverGroups?: InteractionGroups;
+    /**
+     * The collision types active for this collider.
+     *
+     * Use `ActiveCollisionTypes` to specify which collision types should be active for this collider.
+     *
+     * @see https://rapier.rs/javascript3d/classes/Collider.html#setActiveCollisionTypes
+     * @see https://rapier.rs/javascript3d/enums/ActiveCollisionTypes.html
+     */
+    activeCollisionTypes?: ActiveCollisionTypes;
     /**
      * Sets the uniform density of this collider.
      * If this is set, other mass-properties like the angular inertia tensor are computed
@@ -192,6 +201,18 @@ export interface ColliderOptions<ColliderArgs extends Array<unknown>> {
         principalAngularInertia: Vector;
         angularInertiaLocalFrame: Rotation;
     };
+    /**
+     * The contact skin of the collider.
+     *
+     * The contact skin acts as if the collider was enlarged with a skin of width contactSkin around it, keeping objects further apart when colliding.
+     *
+     * A non-zero contact skin can increase performance, and in some cases, stability.
+     * However it creates a small gap between colliding object (equal to the sum of their skin).
+     * If the skin is sufficiently small, this might not be visually significant or can be hidden by the rendering assets.
+     *
+     * @defaultValue 0
+     */
+    contactSkin?: number;
     /**
      * Sets whether or not this collider is a sensor.
      */
@@ -277,6 +298,20 @@ export interface RigidBodyOptions extends ColliderProps {
      * @defaultValue false
      */
     ccd?: boolean;
+    /**
+     * The maximum prediction distance Soft Continuous Collision-Detection.
+     *
+     * When set to 0, soft-CCD is disabled.
+     *
+     * Soft-CCD helps prevent tunneling especially of slow-but-thin to moderately fast objects.
+     * The soft CCD prediction distance indicates how far in the object’s path the CCD algorithm is allowed to inspect.
+     * Large values can impact performance badly by increasing the work needed from the broad-phase.
+     *
+     * It is a generally cheaper variant of regular CCD since it relies on predictive constraints instead of shape-cast and substeps.
+     *
+     * @defaultValue 0
+     */
+    softCcdPrediction?: number;
     /**
      * Initial position of the RigidBody
      */
@@ -325,6 +360,16 @@ export interface RigidBodyOptions extends ColliderProps {
      * Can be customized per-collider.
      */
     solverGroups?: InteractionGroups;
+    /**
+     * The default active collision types for all colliders in this rigid body.
+     * Can be customized per-collider.
+     *
+     * Use `ActiveCollisionTypes` to specify which collision types should be active for this collider.
+     *
+     * @see https://rapier.rs/javascript3d/classes/Collider.html#setActiveCollisionTypes
+     * @see https://rapier.rs/javascript3d/enums/ActiveCollisionTypes.html
+     */
+    activeCollisionTypes?: ActiveCollisionTypes;
     onSleep?(): void;
     onWake?(): void;
     /**
@@ -357,10 +402,7 @@ export interface RigidBodyOptions extends ColliderProps {
      */
     transformState?: (state: RigidBodyState) => RigidBodyState;
 }
-export declare type SphericalJointParams = [
-    body1Anchor: Vector3,
-    body2Anchor: Vector3
-];
+export declare type SphericalJointParams = [body1Anchor: Vector3, body2Anchor: Vector3];
 export declare type FixedJointParams = [
     body1Anchor: Vector3,
     body1LocalFrame: Quaternion,

package/dist/declarations/src/utils/interaction-groups.d.ts

@@ -31,4 +31,4 @@ import { InteractionGroups } from "@dimforge/rapier3d-compat";
  * @param filters Groups the interaction group should filter against. (Values can range from 0 to 15.)
  * @returns An InteractionGroup bitmask.
  */
-export declare const interactionGroups: (memberships: number | number[], filters?: number | number[]) => InteractionGroups;
+export declare const interactionGroups: (memberships: number | number[], filters?: number | number[] | undefined) => InteractionGroups;

package/dist/react-three-rapier.cjs.d.ts

@@ -1 +1,2 @@
 export * from "./declarations/src/index";
+//# sourceMappingURL=data:application/json;charset=utf-8;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicmVhY3QtdGhyZWUtcmFwaWVyLmNqcy5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi9kZWNsYXJhdGlvbnMvc3JjL2luZGV4LmQudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEifQ==