@threlte/rapier 3.0.0-next.1 → 3.0.0-next.11

package/dist/components/Attractor/Attractor.svelte

@@ -1,7 +1,7 @@
 <script lang="ts">import { T, useTask } from '@threlte/core';
 import { Group, Vector3 } from 'three';
 import { useRapier } from '../../hooks/useRapier';
-let { strength = 1, range = 50, gravityType = 'static', gravitationalConstant = 6.673e-11, ref = $bindable(), ...props } = $props();
+let { strength = 1, range = 50, gravityType = 'static', gravitationalConstant = 6.673e-11, ref = $bindable(), children, ...props } = $props();
 const { world, debug } = useRapier();
 const gravitySource = new Vector3();
 const group = new Group();
@@ -37,7 +37,7 @@ useTask(() => {
   bind:ref
   {...props}
 >
-  <slot ref={group} />
+  {@render children?.({ ref: group })}
 
   {#if $debug}
     <T.Mesh>

package/dist/components/Attractor/Attractor.svelte.d.ts

@@ -1,4 +1,4 @@
-import { Props, type Events, type Slots } from '@threlte/core'
+import { Props } from '@threlte/core'
 import { SvelteComponent } from 'svelte'
 import type { Group } from 'three'
 import type { GravityType } from '../../types/types'
@@ -31,12 +31,4 @@ type AttractorProps = Props<Group> & {
   gravitationalConstant?: number
 }
 
-type AttractorEvents = Events<Group>
-
-type AttractorSlots = Slots<Group>
-
-export default class Attractor extends SvelteComponent<
-  AttractorProps,
-  AttractorEvents,
-  AttractorSlots
-> {}
+export default class Attractor extends SvelteComponent<AttractorProps> {}

package/dist/components/Colliders/AutoColliders.svelte

@@ -1,18 +1,18 @@
 <script lang="ts">import { ActiveCollisionTypes, CoefficientCombineRule } from '@dimforge/rapier3d-compat';
-import { SceneGraphObject } from '@threlte/core';
+import { createParentObject3DContext, useParentObject3D, watch } from '@threlte/core';
 import { onDestroy, onMount } from 'svelte';
 import { Group } from 'three';
 import { useCollisionGroups } from '../../hooks/useCollisionGroups';
 import { useRapier } from '../../hooks/useRapier';
 import { useRigidBody } from '../../hooks/useRigidBody';
-import { useCreateEvent } from '../../lib/useCreateEvent';
-import { useParentRigidbodyObject } from '../../lib/rigidBodyObjectContext';
 import { applyColliderActiveEvents } from '../../lib/applyColliderActiveEvents';
 import { createCollidersFromChildren } from '../../lib/createCollidersFromChildren';
 import { eulerToQuaternion } from '../../lib/eulerToQuaternion';
-let { shape = 'convexHull', restitution, restitutionCombineRule, friction, frictionCombineRule, sensor, contactForceEventThreshold, density, mass, centerOfMass, principalAngularInertia, angularInertiaLocalFrame, refresh = $bindable(() => create()), colliders = $bindable(), ...props } = $props();
+import { useParentRigidbodyObject } from '../../lib/rigidBodyObjectContext';
+import { useCreateEvent } from '../../lib/useCreateEvent';
+let { shape = 'convexHull', restitution, restitutionCombineRule, friction, frictionCombineRule, sensor, contactForceEventThreshold, density, mass, centerOfMass, principalAngularInertia, angularInertiaLocalFrame, refresh = $bindable(() => create()), colliders = $bindable(), oncreate, oncollisionenter, oncollisionexit, oncontact, onsensorenter, onsensorexit, children } = $props();
 const group = new Group();
-const { updateRef } = useCreateEvent(props.$$events);
+const { updateRef } = useCreateEvent(oncreate);
 const rigidBody = useRigidBody();
 const rigidBodyParentObject = useParentRigidbodyObject();
 const { world, addColliderToContext, removeColliderFromContext } = useRapier();
@@ -27,13 +27,20 @@ const cleanup = () => {
     });
     colliders.length = 0;
 };
+const events = {
+    oncollisionenter,
+    oncollisionexit,
+    oncontact,
+    onsensorenter,
+    onsensorexit
+};
 const create = () => {
     cleanup();
     colliders = createCollidersFromChildren(group, shape ?? 'convexHull', world, rigidBody, rigidBodyParentObject);
-    colliders.forEach((c) => addColliderToContext(c, group, props.$$events));
+    colliders.forEach((c) => addColliderToContext(c, group, events));
     collisionGroups.registerColliders(colliders);
     colliders.forEach((collider) => {
-        applyColliderActiveEvents(collider, props.$$events, rigidBody?.userData?.events);
+        applyColliderActiveEvents(collider, events, rigidBody?.userData?.events);
         collider.setActiveCollisionTypes(ActiveCollisionTypes.ALL);
         collider.setRestitution(restitution ?? 0);
         collider.setRestitutionCombineRule(restitutionCombineRule ?? CoefficientCombineRule.Average);
@@ -63,11 +70,14 @@ onMount(() => {
  * Cleanup
  */
 onDestroy(cleanup);
+const parent3DObject = useParentObject3D();
+createParentObject3DContext(group);
+watch(parent3DObject, (parent) => {
+    parent?.add(group);
+    return () => {
+        parent?.remove(group);
+    };
+});
 </script>
 
-<SceneGraphObject object={group}>
-  <slot
-    {colliders}
-    {refresh}
-  />
-</SceneGraphObject>
+{@render children?.({ colliders: colliders ?? [], refresh })}

package/dist/components/Colliders/AutoColliders.svelte.d.ts

@@ -1,7 +1,7 @@
 import type { CoefficientCombineRule, Collider } from '@dimforge/rapier3d-compat'
-import { SvelteComponent } from 'svelte'
+import { SvelteComponent, type Snippet } from 'svelte'
 import type { Euler, Vector3 } from 'three'
-import type { AutoCollidersShapes, ColliderEventMap } from '../../types/types'
+import type { AutoCollidersShapes, ColliderEvents } from '../../types/types'
 
 // ------------------ BASE ------------------
 
@@ -14,7 +14,10 @@ type BaseProps = {
   sensor?: boolean
   colliders?: Collider[]
   contactForceEventThreshold?: number
+
   refresh?: () => void
+
+  oncreate?: () => void
 }
 
 // ------------------ MASS ------------------
@@ -64,17 +67,18 @@ type MassProps<TMassDef extends MassDef> = TMassDef extends Density
 
 // ------------------ COLLIDER ------------------
 
-export type AutoCollidersProps<TMassDef extends MassDef> = BaseProps & MassProps<TMassDef>
-
-type AutoCollidersSlots = {
-  default: {
-    colliders: Collider[]
-    refresh: () => void
+export type AutoCollidersProps<TMassDef extends MassDef> = BaseProps &
+  MassProps<TMassDef> & {
+    children?: Snippet<
+      [
+        {
+          colliders: Collider[]
+          refresh: () => void
+        }
+      ]
+    >
   }
-}
 
 export default class AutoColliders<TMassDef extends MassDef> extends SvelteComponent<
-  AutoCollidersProps<TMassDef>,
-  ColliderEventMap,
-  AutoCollidersSlots
+  AutoCollidersProps<TMassDef>
 > {}

package/dist/components/Colliders/Collider.svelte

@@ -1,30 +1,37 @@
 <script lang="ts">import { ActiveCollisionTypes, CoefficientCombineRule, Collider, ColliderDesc } from '@dimforge/rapier3d-compat';
-import { SceneGraphObject, useTask } from '@threlte/core';
+import { createParentObject3DContext, useParentObject3D, useTask, watch } from '@threlte/core';
 import { onDestroy, onMount, tick } from 'svelte';
 import { Object3D, Quaternion, Vector3 } from 'three';
 import { useCollisionGroups } from '../../hooks/useCollisionGroups';
 import { useRapier } from '../../hooks/useRapier';
 import { useRigidBody } from '../../hooks/useRigidBody';
-import { useParentRigidbodyObject } from '../../lib/rigidBodyObjectContext';
-import { useCreateEvent } from '../../lib/useCreateEvent';
 import { applyColliderActiveEvents } from '../../lib/applyColliderActiveEvents';
 import { eulerToQuaternion } from '../../lib/eulerToQuaternion';
 import { getWorldPosition, getWorldQuaternion } from '../../lib/getWorldTransforms';
+import { useParentRigidbodyObject } from '../../lib/rigidBodyObjectContext';
 import { scaleColliderArgs } from '../../lib/scaleColliderArgs';
+import { useCreateEvent } from '../../lib/useCreateEvent';
 let { shape, args, type, restitution, restitutionCombineRule, friction, frictionCombineRule, sensor, contactForceEventThreshold, density, mass, centerOfMass, principalAngularInertia, angularInertiaLocalFrame, collider = $bindable(), refresh = $bindable(() => {
     if (!collider)
         return;
     collider.setTranslation(getWorldPosition(object));
     collider.setRotation(getWorldQuaternion(object));
-}), ...props } = $props();
+}), oncreate, oncollisionenter, oncollisionexit, oncontact, onsensorenter, onsensorexit, children } = $props();
 const object = new Object3D();
-const { updateRef } = useCreateEvent(props.$$events);
+const { updateRef } = useCreateEvent(oncreate);
 const rigidBody = useRigidBody();
 const parentRigidBodyObject = useParentRigidbodyObject();
 const hasRigidBodyParent = !!rigidBody;
 const rapierContext = useRapier();
 const { world } = rapierContext;
 const collisionGroups = useCollisionGroups();
+const events = {
+    oncollisionenter,
+    oncollisionexit,
+    oncontact,
+    onsensorenter,
+    onsensorexit
+};
 /**
  * Actual collider setup happens onMount as only then
  * the transforms are finished.
@@ -41,7 +48,7 @@ onMount(async () => {
     /**
      * Add collider to context
      */
-    rapierContext.addColliderToContext(collider, object, props.$$events);
+    rapierContext.addColliderToContext(collider, object, events);
     /**
      * For use in conjunction with component <CollisionGroups>
      */
@@ -98,7 +105,7 @@ $effect.pre(() => {
 });
 $effect.pre(() => {
     if (collider) {
-        applyColliderActiveEvents(collider, props.$$events, rigidBody?.userData?.events);
+        applyColliderActiveEvents(collider, events, rigidBody?.userData?.events);
     }
 });
 /**
@@ -127,8 +134,14 @@ onDestroy(() => {
     world.removeCollider(collider, true);
     collider = undefined;
 });
+const parent3DObject = useParentObject3D();
+createParentObject3DContext(object);
+watch(parent3DObject, (parent) => {
+    parent?.add(object);
+    return () => {
+        parent?.remove(object);
+    };
+});
 </script>
 
-<SceneGraphObject {object}>
-  <slot {collider} />
-</SceneGraphObject>
+{@render children?.({ collider })}

package/dist/components/Colliders/Collider.svelte.d.ts

@@ -3,9 +3,9 @@ import type {
   Collider as RapierCollider,
   ColliderDesc
 } from '@dimforge/rapier3d-compat'
-import { SvelteComponent } from 'svelte'
+import { SvelteComponent, type Snippet } from 'svelte'
 import type { Euler, Vector3 } from 'three'
-import type { ColliderEventMap } from '../../types/types'
+import type { ColliderEvents } from '../../types/types'
 
 // ------------------ BASE ------------------
 
@@ -97,16 +97,13 @@ type MassProps<TMassDef extends MassDef> = TMassDef extends Density
 // ------------------ COLLIDER ------------------
 
 export type ColliderProps<TShape extends Shape, TMassDef extends MassDef> = BaseProps &
+  ColliderEvents &
   ShapeProps<TShape> &
-  MassProps<TMassDef>
-
-export type ColliderSlots = {
-  default: {
-    collider: RapierCollider
+  MassProps<TMassDef> & {
+    children?: Snippet<[{ collider?: RapierCollider }]>
   }
-}
 
 export default class Collider<
   TShape extends Shape,
   TMassDef extends MassDef
-> extends SvelteComponent<ColliderProps<TShape, TMassDef>, ColliderEventMap, ColliderSlots> {}
+> extends SvelteComponent<ColliderProps<TShape, TMassDef>> {}

package/dist/components/CollisionGroups/CollisionGroups.svelte

@@ -1,10 +1,10 @@
 <script lang="ts">import { setContext } from 'svelte';
 import { writable } from 'svelte/store';
 import { computeBitMask } from '../../lib/computeBitMask';
-let { groups, filter, memberships } = $props();
+let { groups, filter, memberships, children } = $props();
 const store = writable(computeBitMask(groups, filter, memberships));
 $effect.pre(() => store.set(computeBitMask(groups, filter, memberships)));
 setContext('threlte-rapier-collision-group', store);
 </script>
 
-<slot />
+{@render children?.()}

package/dist/components/CollisionGroups/CollisionGroups.svelte.d.ts

@@ -1,4 +1,4 @@
-import { SvelteComponent } from 'svelte'
+import { SvelteComponent, type Snippet } from 'svelte'
 
 type N = 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15
 
@@ -11,6 +11,8 @@ type GroupsProps = {
 
   filter?: never
   memberships?: never
+
+  children?: Snippet
 }
 
 type MembershipsAndFilterProps = {
@@ -18,6 +20,8 @@ type MembershipsAndFilterProps = {
   memberships: N[]
 
   groups?: never
+
+  children?: Snippet
 }
 
 type GroupsDef = GroupsProps | MembershipsAndFilterProps

package/dist/components/RigidBody/RigidBody.svelte

@@ -1,17 +1,23 @@
-<script lang="ts">import { SceneGraphObject } from '@threlte/core';
+<script lang="ts">import { createParentObject3DContext, useParentObject3D, watch } from '@threlte/core';
 import { onDestroy, setContext, tick } from 'svelte';
 import { Object3D, Vector3 } from 'three';
 import { useRapier } from '../../hooks/useRapier';
+import { initializeRigidBodyUserData, setInitialRigidBodyState } from '../../lib/createPhysicsTasks';
 import { getWorldPosition, getWorldQuaternion, getWorldScale } from '../../lib/getWorldTransforms';
 import { parseRigidBodyType } from '../../lib/parseRigidBodyType';
 import { setParentRigidbodyObject } from '../../lib/rigidBodyObjectContext';
 import { useCreateEvent } from '../../lib/useCreateEvent';
+import { overrideTeleportMethods } from './overrideTeleportMethods';
 const { world, rapier, addRigidBodyToContext, removeRigidBodyFromContext } = useRapier();
-let { linearVelocity, angularVelocity, type = 'dynamic', canSleep = true, gravityScale = 1, ccd = false, angularDamping = 0, linearDamping = 0, lockRotations = false, lockTranslations = false, enabledRotations = [true, true, true], enabledTranslations = [true, true, true], dominance = 0, enabled = true, userData = {}, rigidBody = $bindable(), ...props } = $props();
-const { updateRef } = useCreateEvent(props.$$events);
+let { linearVelocity, angularVelocity, type = 'dynamic', canSleep = true, gravityScale = 1, ccd = false, angularDamping = 0, linearDamping = 0, lockRotations = false, lockTranslations = false, enabledRotations = [true, true, true], enabledTranslations = [true, true, true], dominance = 0, enabled = true, userData = {}, rigidBody = $bindable(), oncreate, oncollisionenter, oncollisionexit, oncontact, onsensorenter, onsensorexit, onsleep, onwake, children } = $props();
+/**
+ * Every RigidBody receives and forwards collision-related events
+ */
+const { updateRef } = useCreateEvent(oncreate);
 const object = new Object3D();
+initializeRigidBodyUserData(object);
 /**
- * isSleeping used for events "sleep" and "wake" in `useFrameHandler`
+ * isSleeping used for events "sleep" and "wake" in `createPhysicsTasks`
  */
 object.userData.isSleeping = false;
 /**
@@ -22,6 +28,7 @@ const desc = new rapier.RigidBodyDesc(parseRigidBodyType(type)).setCanSleep(canS
  * Temporary RigidBody init
  */
 let rigidBodyInternal = world.createRigidBody(desc);
+overrideTeleportMethods(rigidBodyInternal, object);
 rigidBody = rigidBodyInternal;
 /**
  * Apply transforms after the parent component added "object" to itself
@@ -33,6 +40,7 @@ const initPosition = async () => {
     const parentWorldScale = object.parent ? getWorldScale(object.parent) : new Vector3(1, 1, 1);
     const worldPosition = getWorldPosition(object).multiply(parentWorldScale);
     const worldQuaternion = getWorldQuaternion(object);
+    setInitialRigidBodyState(object, worldPosition, worldQuaternion);
     rigidBodyInternal.setTranslation(worldPosition, true);
     rigidBodyInternal.setRotation(worldQuaternion, true);
     updateRef(rigidBodyInternal);
@@ -68,7 +76,15 @@ $effect.pre(() => rigidBodyInternal.setEnabled(enabled));
  */
 $effect.pre(() => {
     rigidBodyInternal.userData = {
-        events: props.$$events,
+        events: {
+            oncollisionenter,
+            oncollisionexit,
+            oncontact,
+            onsensorenter,
+            onsensorexit,
+            onsleep,
+            onwake
+        },
         ...userData
     };
 });
@@ -84,7 +100,15 @@ setParentRigidbodyObject(object);
 /**
  * Add the mesh to the context
  */
-addRigidBodyToContext(rigidBodyInternal, object, props.$$events);
+addRigidBodyToContext(rigidBodyInternal, object, {
+    oncollisionenter,
+    oncollisionexit,
+    oncontact,
+    onsensorenter,
+    onsensorexit,
+    onsleep,
+    onwake
+});
 /**
  * cleanup
  */
@@ -92,8 +116,14 @@ onDestroy(() => {
     removeRigidBodyFromContext(rigidBodyInternal);
     world.removeRigidBody(rigidBodyInternal);
 });
+const parent3DObject = useParentObject3D();
+createParentObject3DContext(object);
+watch(parent3DObject, (parent) => {
+    parent?.add(object);
+    return () => {
+        parent?.remove(object);
+    };
+});
 </script>
 
-<SceneGraphObject {object}>
-  <slot rigidBody={rigidBodyInternal} />
-</SceneGraphObject>
+{@render children?.({ rigidBody: rigidBodyInternal })}

package/dist/components/RigidBody/RigidBody.svelte.d.ts

@@ -1,13 +1,13 @@
 import { RigidBody as RapierRigidBody } from '@dimforge/rapier3d-compat'
-import { SvelteComponent } from 'svelte'
+import { SvelteComponent, type Snippet } from 'svelte'
 import type { Euler, Vector3 } from 'three'
 import type { RigidBodyTypeString } from '../../lib/parseRigidBodyType'
-import type { RigidBodyEventMap } from '../../types/types'
+import type { RigidBodyEvents } from '../../types/types'
 
 export type Boolean3Array = [x: boolean, y: boolean, z: boolean]
 
 export type RigidBodyProps = {
-  rigidBody: RapierRigidBody
+  rigidBody?: RapierRigidBody | undefined
 
   /**
    * Specify the type of this rigid body
@@ -95,18 +95,8 @@ export type RigidBodyProps = {
    * An arbitrary user-defined object associated with this rigid-body.
    */
   userData?: Record<string, any>
-}
-
-type RigidBodyEvents = RigidBodyEventMap
 
-type RigidBodySlots = {
-  default: {
-    rigidBody: RapierRigidBody
-  }
+  children?: Snippet<[{ rigidBody: RapierRigidBody }]>
 }
 
-export default class RigidBody extends SvelteComponent<
-  RigidBodyProps,
-  RigidBodyEvents,
-  RigidBodySlots
-> {}
+export default class RigidBody extends SvelteComponent<RigidBodyProps & RigidBodyEvents> {}

package/dist/components/RigidBody/overrideTeleportMethods.d.ts

@@ -0,0 +1,14 @@
+import type { RigidBody } from '@dimforge/rapier3d-compat';
+import type { Object3D } from 'three';
+export type ExtractMethods<ObjectType> = Pick<ObjectType, {
+    [Method in keyof ObjectType]: ObjectType[Method] extends (...args: any[]) => any ? Method : never;
+}[keyof ObjectType]>;
+/**
+ * When using a fixed framerate, Threlte is interpolating the position and
+ * rotation of RigidBody objects. Sometimes, this is not desirable, especially
+ * when using methods on the rigidbody that teleport the object, e.g. should
+ * lead to a sudden change in translation/rotation such as `rb.setTranslation`.
+ * These methods are overridden to reset the physics simulation position and
+ * rotation to the current object position and rotation.
+ */
+export declare const overrideTeleportMethods: (rb: RigidBody, object: Object3D) => void;

package/dist/components/RigidBody/overrideTeleportMethods.js

@@ -0,0 +1,31 @@
+const overrideMethods = {
+    position: ['setTranslation', 'setNextKinematicTranslation'],
+    rotation: ['setRotation', 'setNextKinematicRotation']
+};
+/**
+ * When using a fixed framerate, Threlte is interpolating the position and
+ * rotation of RigidBody objects. Sometimes, this is not desirable, especially
+ * when using methods on the rigidbody that teleport the object, e.g. should
+ * lead to a sudden change in translation/rotation such as `rb.setTranslation`.
+ * These methods are overridden to reset the physics simulation position and
+ * rotation to the current object position and rotation.
+ */
+export const overrideTeleportMethods = (rb, object) => {
+    const originalMethods = {};
+    overrideMethods.position.forEach((method) => {
+        originalMethods[method] = rb[method].bind(rb);
+        const proxy = (...args) => {
+            object.userData.physics.resetPosition = true;
+            return originalMethods[method](...args);
+        };
+        rb[method] = proxy;
+    });
+    overrideMethods.rotation.forEach((method) => {
+        originalMethods[method] = rb[method].bind(rb);
+        const proxy = (...args) => {
+            object.userData.physics.resetRotation = true;
+            return originalMethods[method](...args);
+        };
+        rb[method] = proxy;
+    });
+};

package/dist/components/World/InnerWorld.svelte

@@ -1,19 +1,41 @@
 <script lang="ts">import { onDestroy, setContext, tick } from 'svelte';
-import { useFrameHandler } from '../../hooks/useFrameHandler';
 import { createRapierContext } from '../../lib/createRapierContext';
-let { gravity = [0, -9.81, 0], rawIntegrationParameters, rawIslands, rawBroadPhase, rawNarrowPhase, rawBodies, rawColliders, rawImpulseJoints, rawMultibodyJoints, rawCCDSolver, rawQueryPipeline, rawPhysicsPipeline, rawSerializationPipeline, rawDebugRenderPipeline, stage } = $props();
-const rapierContext = createRapierContext({ x: gravity[0], y: gravity[1], z: gravity[2] }, rawIntegrationParameters, rawIslands, rawBroadPhase, rawNarrowPhase, rawBodies, rawColliders, rawImpulseJoints, rawMultibodyJoints, rawCCDSolver, rawQueryPipeline, rawPhysicsPipeline, rawSerializationPipeline, rawDebugRenderPipeline);
+let { gravity = [0, -9.81, 0], rawIntegrationParameters, rawIslands, rawBroadPhase, rawNarrowPhase, rawBodies, rawColliders, rawImpulseJoints, rawMultibodyJoints, rawCCDSolver, rawQueryPipeline, rawPhysicsPipeline, rawSerializationPipeline, rawDebugRenderPipeline, framerate, autoStart = true, simulationStageOptions, synchronizationStageOptions, children } = $props();
+const rapierContext = createRapierContext([
+    { x: gravity[0], y: gravity[1], z: gravity[2] },
+    rawIntegrationParameters,
+    rawIslands,
+    rawBroadPhase,
+    rawNarrowPhase,
+    rawBodies,
+    rawColliders,
+    rawImpulseJoints,
+    rawMultibodyJoints,
+    rawCCDSolver,
+    rawQueryPipeline,
+    rawPhysicsPipeline,
+    rawSerializationPipeline,
+    rawDebugRenderPipeline
+], {
+    framerate,
+    autoStart,
+    simulationStageOptions,
+    synchronizationStageOptions
+});
 setContext('threlte-rapier-context', rapierContext);
 $effect.pre(() => {
     if (gravity !== undefined) {
         rapierContext.world.gravity = { x: gravity[0], y: gravity[1], z: gravity[2] };
     }
 });
-useFrameHandler(rapierContext, stage);
+$effect.pre(() => {
+    if (framerate !== undefined)
+        rapierContext.framerate.set(framerate);
+});
 onDestroy(async () => {
     await tick();
     rapierContext.world.free();
 });
 </script>
 
-<slot />
+{@render children?.()}

package/dist/components/World/InnerWorld.svelte.d.ts

@@ -1,17 +1,11 @@
 import { SvelteComponent } from "svelte";
 import type { WorldProps } from './World.svelte';
 declare const __propDef: {
-    props: WorldProps & {
-        children?: ((this: void) => typeof import("svelte").SnippetReturn & {
-            _: "functions passed to {@render ...} tags must use the `Snippet` type imported from \"svelte\"";
-        }) | undefined;
-    };
+    props: WorldProps;
     events: {
         [evt: string]: CustomEvent<any>;
     };
-    slots: {
-        default: {};
-    };
+    slots: {};
 };
 export type InnerWorldProps = typeof __propDef.props;
 export type InnerWorldEvents = typeof __propDef.events;

package/dist/components/World/World.svelte

@@ -1,60 +1,12 @@
-<script
-  context="module"
-  lang="ts"
->import RAPIER from '@dimforge/rapier3d-compat';
-import { onMount } from 'svelte';
-import { writable } from 'svelte/store';
-/**
- * RAPIER.init() should only be called once
- */
-const initialized = writable(false);
+<script lang="ts">import { initRapier } from '../../lib/initRapier.svelte';
+import InnerWorld from './InnerWorld.svelte';
+let { fallback, children, ...rest } = $props();
 </script>
 
-<script lang="ts">import InnerWorld from './InnerWorld.svelte';
-let { gravity, rawIntegrationParameters, rawIslands, rawBroadPhase, rawNarrowPhase, rawBodies, rawColliders, rawImpulseJoints, rawMultibodyJoints, rawCCDSolver, rawQueryPipeline, rawPhysicsPipeline, rawSerializationPipeline, rawDebugRenderPipeline, 
-/**
- * This is passed to the useTask handler.
- * Use this to control when the rapier physics engine is updating the scene.
- * @default undefined
- */
-stage } = $props();
-let error = $state(false);
-const init = async () => {
-    if ($initialized)
-        return;
-    try {
-        await RAPIER.init();
-        $initialized = true;
-    }
-    catch (e) {
-        error = true;
-    }
-};
-onMount(init);
-</script>
-
-{#if $initialized}
-  <InnerWorld
-    {gravity}
-    {rawIntegrationParameters}
-    {rawIslands}
-    {rawBroadPhase}
-    {rawNarrowPhase}
-    {rawBodies}
-    {rawColliders}
-    {rawImpulseJoints}
-    {rawMultibodyJoints}
-    {rawCCDSolver}
-    {rawQueryPipeline}
-    {rawPhysicsPipeline}
-    {rawSerializationPipeline}
-    {rawDebugRenderPipeline}
-    {stage}
-  >
-    <slot />
+{#await initRapier() then _}
+  <InnerWorld {...rest}>
+    {@render children?.()}
   </InnerWorld>
-{/if}
-
-{#if error}
-  <slot name="fallback" />
-{/if}
+{:catch error}
+  {@render fallback?.(error)}
+{/await}

package/dist/components/World/World.svelte.d.ts

@@ -13,11 +13,13 @@ import type {
   RawRigidBodySet,
   RawSerializationPipeline
 } from '@dimforge/rapier3d-compat/raw'
-import { SvelteComponent } from 'svelte'
+import { SvelteComponent, type Snippet } from 'svelte'
 import type { Vector3 } from 'three'
 import type { Key, Stage } from '@threlte/core'
 
 export type WorldProps = {
+  framerate?: number | 'varying'
+  autoStart?: boolean
   gravity?: Parameters<Vector3['set']>
   rawIntegrationParameters?: RawIntegrationParameters
   rawIslands?: RawIslandManager
@@ -32,7 +34,16 @@ export type WorldProps = {
   rawPhysicsPipeline?: RawPhysicsPipeline
   rawSerializationPipeline?: RawSerializationPipeline
   rawDebugRenderPipeline?: RawDebugRenderPipeline
-  stage?: Key | Stage
+  simulationStageOptions?: {
+    before?: (Key | Stage) | (Key | Stage)[]
+    after?: (Key | Stage) | (Key | Stage)[]
+  }
+  synchronizationStageOptions?: {
+    before?: (Key | Stage) | (Key | Stage)[]
+    after?: (Key | Stage) | (Key | Stage)[]
+  }
+  children?: Snippet
+  fallback?: Snippet<[error: any]>
 }
 
 export default class World extends SvelteComponent<WorldProps> {}

package/dist/lib/applyColliderActiveEvents.d.ts

@@ -1,2 +1,3 @@
 import { type Collider } from '@dimforge/rapier3d-compat';
-export declare const applyColliderActiveEvents: (collider: Collider, colliderEvents?: Record<string, (arg: unknown) => void>, rigidBodyEvents?: Record<string, (arg: unknown) => void>) => void;
+import type { ColliderEvents, RigidBodyEvents } from '../types/types';
+export declare const applyColliderActiveEvents: (collider: Collider, colliderEvents?: ColliderEvents, rigidBodyEvents?: RigidBodyEvents) => void;