@react-three/rapier 0.9.0 → 0.10.0

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

@@ -0,0 +1,51 @@
+import { InteractionGroups, RigidBody } from "@dimforge/rapier3d-compat";
+import { FC } from "react";
+import { Object3D } from "three";
+import { Object3DProps } from "@react-three/fiber";
+declare type GravityType = "static" | "linear" | "newtonian";
+interface AttractorProps {
+    /**
+     * The relative position of this attractor
+     */
+    position?: Object3DProps["position"];
+    /**
+     * The strength of the attractor.
+     * Positive values attract, negative values repel.
+     *
+     * @default 1
+     */
+    strength?: number;
+    /**
+     * The range of the attractor. Will not affect objects outside of this range.
+     *
+     * @default 10
+     * @min 0
+     */
+    range?: number;
+    /**
+     * The type of gravity to use.
+     * - static: The gravity is constant and does not change over time.
+     * - linear: The gravity is linearly interpolated the closer the object is to the attractor.
+     * - newtonian: The gravity is calculated using the newtonian gravity formula.
+     * @default "static"
+     */
+    type?: GravityType;
+    /**
+     * The mass of the attractor. Used when type is `newtonian`.
+     * @default 6.673e-11
+     */
+    gravitationalConstant?: number;
+    /**
+     * The collision groups that this attractor will apply effects to. If a RigidBody contains one or more colliders that are in one of the mask group, it will be affected by this attractor.
+     * If not specified, the attractor will apply effects to all RigidBodies.
+     */
+    collisionGroups?: InteractionGroups;
+}
+export interface AttractorState extends Required<Omit<AttractorProps, "position" | "collisionGroups">> {
+    object: Object3D;
+    collisionGroups?: InteractionGroups;
+}
+export declare type AttractorStateMap = Map<Object3D["uuid"], AttractorState>;
+export declare const applyAttractorForceOnRigidBody: (rigidBody: RigidBody, { object, strength, range, gravitationalConstant, collisionGroups, type }: AttractorState) => void;
+export declare const Attractor: FC<AttractorProps>;
+export {};

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

@@ -4,5 +4,8 @@ interface MeshColliderProps {
     children: ReactNode;
     type: RigidBodyAutoCollider;
 }
-export declare const MeshCollider: (props: MeshColliderProps) => JSX.Element;
+export declare const MeshCollider: {
+    (props: MeshColliderProps): JSX.Element;
+    displayName: string;
+};
 export {};

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

@@ -3,6 +3,7 @@ import { Collider, ColliderHandle, RigidBody, RigidBodyHandle } from "@dimforge/
 import React, { FC, ReactNode } from "react";
 import { Matrix4, Object3D, Vector3 } from "three";
 import { CollisionEnterHandler, CollisionExitHandler, ContactForceHandler, IntersectionEnterHandler, IntersectionExitHandler, RigidBodyAutoCollider, Vector3Array, WorldApi } from "./types";
+import { AttractorStateMap } from "./Attractor";
 export interface RigidBodyState {
     rigidBody: RigidBody;
     object: Object3D;
@@ -21,25 +22,52 @@ export interface ColliderState {
     object: Object3D;
     /**
      * The parent of which this collider needs to base its
-     * world position on
+     * world position on, can be empty
      */
-    worldParent: Object3D;
+    worldParent?: Object3D;
 }
 export declare type ColliderStateMap = Map<Collider["handle"], ColliderState>;
 export interface RapierContext {
     rapier: typeof Rapier;
     world: WorldApi;
+    /**
+     * @internal
+     */
     rigidBodyStates: RigidBodyStateMap;
+    /**
+     * @internal
+     */
     colliderStates: ColliderStateMap;
+    /**
+     * @internal
+     */
     rigidBodyEvents: EventMap;
+    /**
+     * @internal
+     */
     colliderEvents: EventMap;
+    /**
+     * @internal
+     */
+    attractorStates: AttractorStateMap;
     physicsOptions: {
         colliders: RigidBodyAutoCollider;
     };
     isPaused: boolean;
+    /**
+     * Step the physics world one step
+     *
+     * @param deltaTime The delta time to step the world with
+     *
+     * @example
+     * ```
+     * step(1/60)
+     * ```
+     */
+    step: (deltaTime: number) => void;
 }
 export declare const RapierContext: React.Context<RapierContext | undefined>;
-export declare type EventMap = Map<ColliderHandle | RigidBodyHandle, {
+export declare type EventMapValue = {
     onSleep?(): void;
     onWake?(): void;
     onCollisionEnter?: CollisionEnterHandler;
@@ -47,7 +75,8 @@ export declare type EventMap = Map<ColliderHandle | RigidBodyHandle, {
     onIntersectionEnter?: IntersectionEnterHandler;
     onIntersectionExit?: IntersectionExitHandler;
     onContactForce?: ContactForceHandler;
-}>;
+};
+export declare type EventMap = Map<ColliderHandle | RigidBodyHandle, EventMapValue>;
 interface RapierWorldProps {
     children: ReactNode;
     /**

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

@@ -9,5 +9,6 @@ export { MeshCollider } from "./MeshCollider";
 export { Debug } from "./Debug";
 export { InstancedRigidBodies } from "./InstancedRigidBodies";
 export * from "./AnyCollider";
+export { Attractor } from "./Attractor";
 export * from "./hooks";
-export * from "./bitmasks";
+export * from "./interaction-groups";

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

@@ -183,20 +183,34 @@ export interface UseColliderOptions<ColliderArgs extends Array<unknown>> {
      */
     sensor?: boolean;
 }
-export declare type BaseCollisionPayload = {
+export declare type CollisionTarget = {
     rigidBody?: RapierRigidBody;
     collider: RapierCollider;
     rigidBodyObject?: Object3D;
     colliderObject?: Object3D;
 };
-export declare type CollisionEnterPayload = BaseCollisionPayload & {
+export declare type CollisionPayload = {
+    /** the object firing the event */
+    target: CollisionTarget;
+    /** the other object involved in the event */
+    other: CollisionTarget;
+    /** deprecated use `payload.other.rigidBody` instead */
+    rigidBody?: RapierRigidBody;
+    /** deprecated use `payload.other.collider` instead */
+    collider: RapierCollider;
+    /** deprecated use `payload.other.rigidBodyObject` instead */
+    rigidBodyObject?: Object3D;
+    /** deprecated use `payload.other.colliderObject` instead */
+    colliderObject?: Object3D;
+};
+export declare type CollisionEnterPayload = CollisionPayload & {
     manifold: TempContactManifold;
     flipped: boolean;
 };
-export declare type CollisionExitPayload = BaseCollisionPayload;
-export declare type IntersectionEnterPayload = BaseCollisionPayload;
-export declare type IntersectionExitPayload = BaseCollisionPayload;
-export declare type ContactForcePayload = BaseCollisionPayload & {
+export declare type CollisionExitPayload = CollisionPayload;
+export declare type IntersectionEnterPayload = CollisionPayload;
+export declare type IntersectionExitPayload = CollisionPayload;
+export declare type ContactForcePayload = CollisionPayload & {
     totalForce: Vector;
     totalForceMagnitude: number;
     maxForceDirection: Vector;