@zylem/behaviors 0.5.2 → 0.5.7

package/dist/{chunk-NQPYMUDF.js → chunk-UKGBQTHL.js}

@@ -1,13 +1,13 @@
 import {
   fireShooter2DIfRequested
-} from "./chunk-52FJIDGL.js";
+} from "./chunk-LAN7U3AK.js";
 import {
   createThrusterInputComponent
-} from "./chunk-IZJFUAXB.js";
+} from "./chunk-2HLZBWGD.js";
 import {
   getEntityFacingAngle2D,
   resolveAim2D
-} from "./chunk-TBUKJKY6.js";
+} from "./chunk-VJ3UA6OD.js";
 
 // src/lib/coordinators/multidirectional-space-shooter.coordinator.ts
 var MultidirectionalSpaceShooterCoordinator = class {
@@ -42,4 +42,3 @@ var MultidirectionalSpaceShooterCoordinator = class {
 export {
   MultidirectionalSpaceShooterCoordinator
 };
-//# sourceMappingURL=chunk-NQPYMUDF.js.map

package/dist/{chunk-5XPPLTC7.js → chunk-UUMH3DC3.js}

@@ -1,6 +1,6 @@
 import {
   defineBehavior
-} from "./chunk-EZNCCO4L.js";
+} from "./chunk-YDLO5M7S.js";
 
 // src/lib/behaviors/cooldown/cooldown-store.ts
 import { proxy } from "valtio/vanilla";
@@ -115,4 +115,3 @@ export {
   getCooldownStore,
   CooldownBehavior
 };
-//# sourceMappingURL=chunk-5XPPLTC7.js.map

package/dist/{chunk-TBUKJKY6.js → chunk-VJ3UA6OD.js}

@@ -3,7 +3,7 @@ import {
   directionFromAngle2D,
   getRotationAngle2D,
   normalizeDirection2D
-} from "./chunk-SGHIGTVZ.js";
+} from "./chunk-3X3CL24Z.js";
 
 // src/lib/coordinators/shared/top-down-aim.ts
 function getEntityFacingAngle2D(entity) {
@@ -35,4 +35,3 @@ export {
   getEntityFacingAngle2D,
   resolveAim2D
 };
-//# sourceMappingURL=chunk-TBUKJKY6.js.map

package/dist/{chunk-OHCPV2NT.js → chunk-WHKPWIQO.js}

@@ -83,4 +83,3 @@ export {
   clampPointToBounds3D,
   getBounds3DNormalFromHits
 };
-//# sourceMappingURL=chunk-OHCPV2NT.js.map

package/dist/{chunk-EZNCCO4L.js → chunk-YDLO5M7S.js}

@@ -11,4 +11,3 @@ function defineBehavior(config) {
 export {
   defineBehavior
 };
-//# sourceMappingURL=chunk-EZNCCO4L.js.map

package/dist/{components-BmievOxF.d.ts → components-JZQoO2sU.d.ts}

@@ -1,4 +1,4 @@
-import { G as GameEntity, a as BehaviorDescriptor } from './behavior-system-CldqNUgr.js';
+import { G as GameEntity, a as BehaviorDescriptor } from './behavior-system-HEt67el5.js';
 import { Vector3, Quaternion } from 'three';
 
 /**

package/dist/cooldown.d.ts

@@ -1,4 +1,4 @@
-import { a as BehaviorDescriptor } from './behavior-system-CldqNUgr.js';
+import { a as BehaviorDescriptor } from './behavior-system-HEt67el5.js';
 import '@zylem/runtime';
 
 /**

package/dist/cooldown.js

@@ -6,9 +6,9 @@ import {
   registerCooldown,
   resetCooldown,
   tickCooldowns
-} from "./chunk-5XPPLTC7.js";
-import "./chunk-EZNCCO4L.js";
-import "./chunk-5WRI5ZAA.js";
+} from "./chunk-UUMH3DC3.js";
+import "./chunk-YDLO5M7S.js";
+import "./chunk-JSBRDJBE.js";
 export {
   CooldownBehavior,
   fireCooldown,
@@ -18,4 +18,3 @@ export {
   resetCooldown,
   tickCooldowns
 };
-//# sourceMappingURL=cooldown.js.map

package/dist/coordinators/boundary-ricochet-3d.d.ts

@@ -1,9 +1,9 @@
-import { a as MoveableEntity } from '../moveable-rdIvWiak.js';
+import { a as MoveableEntity } from '../moveable-BdFmI3s1.js';
 import { B as BaseEntityInterface } from '../entity-types-DhfsZbSK.js';
 import { Ricochet3DHandle } from '../ricochet-3d.js';
 import { WorldBoundary3DHandle } from '../world-boundary-3d.js';
 import 'three';
-import '../behavior-system-CldqNUgr.js';
+import '../behavior-system-HEt67el5.js';
 import '@zylem/runtime';
 import '../sync-state-machine-CZyspBpj.js';
 import 'typescript-fsm';

package/dist/coordinators/boundary-ricochet-3d.js

@@ -1,10 +1,9 @@
 import {
   BoundaryRicochet3DCoordinator
-} from "../chunk-KFFETUAL.js";
-import "../chunk-OHCPV2NT.js";
-import "../chunk-LL4FLHIY.js";
-import "../chunk-5WRI5ZAA.js";
+} from "../chunk-RR3XNDKG.js";
+import "../chunk-WHKPWIQO.js";
+import "../chunk-2YF7J3H4.js";
+import "../chunk-JSBRDJBE.js";
 export {
   BoundaryRicochet3DCoordinator
 };
-//# sourceMappingURL=boundary-ricochet-3d.js.map

package/dist/coordinators/boundary-ricochet.d.ts

@@ -1,10 +1,10 @@
 import { Ricochet2DHandle } from '../ricochet-2d.js';
 import { WorldBoundary2DHandle } from '../world-boundary-2d.js';
-import { a as MoveableEntity } from '../moveable-rdIvWiak.js';
+import { a as MoveableEntity } from '../moveable-BdFmI3s1.js';
 import { B as BaseEntityInterface } from '../entity-types-DhfsZbSK.js';
 import '../sync-state-machine-CZyspBpj.js';
 import 'typescript-fsm';
-import '../behavior-system-CldqNUgr.js';
+import '../behavior-system-HEt67el5.js';
 import '@zylem/runtime';
 import 'three';
 

package/dist/coordinators/boundary-ricochet.js

@@ -1,10 +1,9 @@
 import {
   BoundaryRicochetCoordinator
-} from "../chunk-NW4SE5XW.js";
-import "../chunk-OPZ2LVS2.js";
-import "../chunk-LL4FLHIY.js";
-import "../chunk-5WRI5ZAA.js";
+} from "../chunk-DD4U42FG.js";
+import "../chunk-TZQQYJYK.js";
+import "../chunk-2YF7J3H4.js";
+import "../chunk-JSBRDJBE.js";
 export {
   BoundaryRicochetCoordinator
 };
-//# sourceMappingURL=boundary-ricochet.js.map

package/dist/coordinators/first-person-shooter.js

@@ -1,10 +1,9 @@
 import {
   FirstPersonShooterCoordinator
-} from "../chunk-H4TJ7X4O.js";
-import "../chunk-QVCMJ4Q2.js";
-import "../chunk-4WH2ZN7P.js";
-import "../chunk-5WRI5ZAA.js";
+} from "../chunk-QU6GQ657.js";
+import "../chunk-4EWASZHB.js";
+import "../chunk-F7E23E26.js";
+import "../chunk-JSBRDJBE.js";
 export {
   FirstPersonShooterCoordinator
 };
-//# sourceMappingURL=first-person-shooter.js.map

package/dist/coordinators/multidirectional-space-shooter.d.ts

@@ -1,7 +1,7 @@
 import { T as ThrusterInputComponent } from '../components-B29WHGQN.js';
 import { Shooter2DSourceEntity, Shooter2DHandle, Shooter2DStageLike } from '../shooter-2d.js';
 import { S as Shooter2DAimFireInput } from '../shooter-fire-DGripl0z.js';
-import '../behavior-system-CldqNUgr.js';
+import '../behavior-system-HEt67el5.js';
 import '@zylem/runtime';
 import '../vector-DjhLUrak.js';
 import 'three';

package/dist/coordinators/multidirectional-space-shooter.js

@@ -1,12 +1,11 @@
 import {
   MultidirectionalSpaceShooterCoordinator
-} from "../chunk-NQPYMUDF.js";
-import "../chunk-52FJIDGL.js";
-import "../chunk-IZJFUAXB.js";
-import "../chunk-TBUKJKY6.js";
-import "../chunk-SGHIGTVZ.js";
-import "../chunk-5WRI5ZAA.js";
+} from "../chunk-UKGBQTHL.js";
+import "../chunk-LAN7U3AK.js";
+import "../chunk-2HLZBWGD.js";
+import "../chunk-VJ3UA6OD.js";
+import "../chunk-3X3CL24Z.js";
+import "../chunk-JSBRDJBE.js";
 export {
   MultidirectionalSpaceShooterCoordinator
 };
-//# sourceMappingURL=multidirectional-space-shooter.js.map

package/dist/coordinators/top-down-shooter.d.ts

@@ -1,7 +1,7 @@
 import { a as TopDownMovementInputComponent } from '../components-XCpL6IYt.js';
 import { Shooter2DSourceEntity, Shooter2DHandle, Shooter2DStageLike } from '../shooter-2d.js';
 import { S as Shooter2DAimFireInput } from '../shooter-fire-DGripl0z.js';
-import '../behavior-system-CldqNUgr.js';
+import '../behavior-system-HEt67el5.js';
 import '@zylem/runtime';
 import '../vector-DjhLUrak.js';
 import 'three';

package/dist/coordinators/top-down-shooter.js

@@ -1,12 +1,11 @@
 import {
   TopDownShooterCoordinator
-} from "../chunk-KIYUUSPK.js";
-import "../chunk-52FJIDGL.js";
-import "../chunk-EIWQM6U3.js";
-import "../chunk-TBUKJKY6.js";
-import "../chunk-SGHIGTVZ.js";
-import "../chunk-5WRI5ZAA.js";
+} from "../chunk-OSPQFWQF.js";
+import "../chunk-LAN7U3AK.js";
+import "../chunk-2HKY6WF7.js";
+import "../chunk-VJ3UA6OD.js";
+import "../chunk-3X3CL24Z.js";
+import "../chunk-JSBRDJBE.js";
 export {
   TopDownShooterCoordinator
 };
-//# sourceMappingURL=top-down-shooter.js.map

package/dist/core.d.ts

@@ -1,10 +1,10 @@
-import { $ as VelocityIntentMode, Z as TransformState, e as BehaviorRuntime, J as StagePose, l as StageBehaviorSnapshot, U as StageThrusterOptions, V as StageTopDownOptions, T as StageShooter2DOptions, R as StageScreenWrapOptions, r as StageBoundaryDimValue, Y as StageWorldBoundaryOptions, N as StageRicochetDimValue, O as StageRicochetOptions, H as StagePlatformer3DOptions, F as StagePlatformer2DOptions, z as StageFirstPersonOptions, y as StageFirstPersonInput, A as StageJumper2DOptions, E as StageJumper3DOptions, a1 as WasmStageRuntime, a2 as WasmStageRuntimeOptions, p as StageBodyKindValue, t as StageColliderShape, L as StageRenderSlot, K as StageRaycastHit, n as StageBodyInfo, u as StageDebugRender } from './behavior-system-CldqNUgr.js';
-export { B as BaseBehaviorHandle, a as BehaviorDescriptor, b as BehaviorEntityLink, c as BehaviorHandle, d as BehaviorRef, f as BehaviorSystem, g as BehaviorSystemContext, h as BehaviorSystemFactory, C as CreateEntityFn, D as DefineBehaviorConfig, G as GameEntity, i as GameEntityOptions, S as STAGE_INPUT_BUTTON_JUMP, j as STAGE_INPUT_BUTTON_RUN, k as STAGE_INVALID_SLOT, m as StageBodyConfig, o as StageBodyKind, q as StageBoundaryDim, s as StageColliderConfig, v as StageEvent, w as StageEventType, x as StageEventTypeValue, I as StagePlatformerShapeSource, M as StageRicochetDim, P as StageRicochetReflection, Q as StageRicochetReflectionValue, W as StageTopDownPlane, X as StageTopDownPlaneValue, _ as VelocityIntent, a0 as WasmSnapshotBackref, a3 as createTransformStore, a4 as createWasmStageRuntime, a5 as defineBehavior, a6 as readBehaviorSnapshot, a7 as readStageRenderSlot } from './behavior-system-CldqNUgr.js';
-export { P as PhysicsBodyComponent, T as TransformComponent, c as createPhysicsBodyComponent, a as createTransformComponent, u as useBehavior } from './components-BmievOxF.js';
-export { E as EntityWithBody, M as MoveableBodyLike, a as MoveableEntity, V as Vector, g as getPosition, b as getVelocity, m as makeMoveable, c as move, d as moveForwardXY, e as moveX, f as moveXY, h as moveXZ, i as moveY, j as moveZ, r as resetVelocity, s as setPosition, k as setPositionX, l as setPositionY, n as setPositionZ, w as wrapAround3D, o as wrapAroundXY } from './moveable-rdIvWiak.js';
+import { $ as VelocityIntentMode, Z as TransformState, e as BehaviorRuntime, J as StagePose, l as StageBehaviorSnapshot, U as StageThrusterOptions, V as StageTopDownOptions, T as StageShooter2DOptions, R as StageScreenWrapOptions, r as StageBoundaryDimValue, Y as StageWorldBoundaryOptions, N as StageRicochetDimValue, O as StageRicochetOptions, H as StagePlatformer3DOptions, F as StagePlatformer2DOptions, z as StageFirstPersonOptions, y as StageFirstPersonInput, A as StageJumper2DOptions, E as StageJumper3DOptions, a1 as WasmStageRuntime, a2 as WasmStageRuntimeOptions, p as StageBodyKindValue, t as StageColliderShape, L as StageRenderSlot, K as StageRaycastHit, n as StageBodyInfo, u as StageDebugRender } from './behavior-system-HEt67el5.js';
+export { B as BaseBehaviorHandle, a as BehaviorDescriptor, b as BehaviorEntityLink, c as BehaviorHandle, d as BehaviorRef, f as BehaviorSystem, g as BehaviorSystemContext, h as BehaviorSystemFactory, C as CreateEntityFn, D as DefineBehaviorConfig, G as GameEntity, i as GameEntityOptions, S as STAGE_INPUT_BUTTON_JUMP, j as STAGE_INPUT_BUTTON_RUN, k as STAGE_INVALID_SLOT, m as StageBodyConfig, o as StageBodyKind, q as StageBoundaryDim, s as StageColliderConfig, v as StageEvent, w as StageEventType, x as StageEventTypeValue, I as StagePlatformerShapeSource, M as StageRicochetDim, P as StageRicochetReflection, Q as StageRicochetReflectionValue, W as StageTopDownPlane, X as StageTopDownPlaneValue, _ as VelocityIntent, a0 as WasmSnapshotBackref, a3 as createTransformStore, a4 as createWasmStageRuntime, a5 as defineBehavior, a6 as readBehaviorSnapshot, a7 as readStageRenderSlot } from './behavior-system-HEt67el5.js';
+export { P as PhysicsBodyComponent, T as TransformComponent, c as createPhysicsBodyComponent, a as createTransformComponent, u as useBehavior } from './components-JZQoO2sU.js';
+export { E as EntityWithBody, M as MoveableBodyLike, a as MoveableEntity, V as Vector, g as getPosition, b as getVelocity, m as makeMoveable, c as move, d as moveForwardXY, e as moveX, f as moveXY, h as moveXZ, i as moveY, j as moveZ, r as resetVelocity, s as setPosition, k as setPositionX, l as setPositionY, n as setPositionZ, w as wrapAround3D, o as wrapAroundXY } from './moveable-BdFmI3s1.js';
 export { V as VEC2_ONE, a as VEC2_ZERO, b as VEC3_ONE, c as VEC3_ZERO, d as Vec2, e as Vec2Components, f as Vec2Input, g as Vec3, h as Vec3Components, i as Vec3Input, j as isVec2Input, k as isVec3Input, n as normalizeVec2, l as normalizeVec3, t as toThreeVector2, m as toThreeVector3 } from './vector-DjhLUrak.js';
 export { S as SyncStateMachine } from './sync-state-machine-CZyspBpj.js';
-export { F as FirstPersonPerspective } from './first-person-perspective-C9Mptl0-.js';
+export { F as FirstPersonPerspective } from './first-person-perspective-BxFHgFln.js';
 export { ILogger, ITransition, SyncCallback, t } from 'typescript-fsm';
 export { STAGE_EVENT_STRIDE, STAGE_INPUT_STRIDE, STAGE_RENDER_STRIDE, STAGE_SNAPSHOT_STRIDE, StageWasmExports } from '@zylem/runtime';
 import 'three';
@@ -233,8 +233,20 @@ interface SimulationFrame {
 interface SimulationOptions extends WasmStageRuntimeOptions {
     /** Fixed physics timestep in seconds (default 1/60). */
     fixedTimestep?: number;
-    /** Max fixed steps per `update()` to avoid death spirals (default 4). */
+    /** Max fixed steps per `update()` to avoid death spirals (default 2). */
     maxSubSteps?: number;
+    /**
+     * Rapier contact solver iterations (default 4; auto-drops to 2 when a
+     * stage has 512+ dynamic bodies). Lower = faster, less stable stacks.
+     */
+    solverIterations?: number;
+    /**
+     * Sleep activation overrides applied after create. Defaults match the
+     * aggressive canSleep policy on newly attached bodies.
+     */
+    sleepLinearThreshold?: number;
+    sleepAngularThreshold?: number;
+    timeUntilSleep?: number;
 }
 /**
  * The behavior world. Construct via {@link createSimulation}.
@@ -294,6 +306,9 @@ declare class Simulation {
     readPreviousRenderSlot(handle: EntityHandle, out?: StageRenderSlot): StageRenderSlot | null;
     readSnapshot(handle: EntityHandle, out?: StageBehaviorSnapshot): StageBehaviorSnapshot | null;
     setGravity(x: number, y: number, z: number): void;
+    setSolverIterations(iterations: number): void;
+    setSleepThresholds(normalizedLinearThreshold: number, angularThreshold: number, timeUntilSleep: number): void;
+    awakeDynamicCount(): number;
     /** Physics raycast; the hit's slot is resolved to an entity handle. */
     castRay(origin: readonly [number, number, number], dir: readonly [number, number, number], maxDistance: number, solidOnly?: boolean): (Omit<StageRaycastHit, 'slot'> & {
         entity: EntityHandle | null;

package/dist/core.js

@@ -2,7 +2,7 @@ import {
   createPhysicsBodyComponent,
   createTransformComponent,
   useBehavior
-} from "./chunk-5A5AYP2C.js";
+} from "./chunk-K6CWKFHL.js";
 import {
   VEC2_ONE,
   VEC2_ZERO,
@@ -14,11 +14,11 @@ import {
   normalizeVec3,
   toThreeVector2,
   toThreeVector3
-} from "./chunk-M3QDKKDF.js";
+} from "./chunk-LWM346FW.js";
 import {
   SyncStateMachine,
   import_typescript_fsm
-} from "./chunk-AS3HR7AS.js";
+} from "./chunk-OBF6BIA2.js";
 import {
   STAGE_EVENT_STRIDE,
   STAGE_INPUT_BUTTON_JUMP,
@@ -38,11 +38,11 @@ import {
   createWasmStageRuntime,
   readBehaviorSnapshot,
   readStageRenderSlot
-} from "./chunk-DZ4LLQON.js";
+} from "./chunk-GZ3DQIIZ.js";
 import {
   defineBehavior
-} from "./chunk-EZNCCO4L.js";
-import "./chunk-5WRI5ZAA.js";
+} from "./chunk-YDLO5M7S.js";
+import "./chunk-JSBRDJBE.js";
 
 // src/lib/capabilities/transform-store.ts
 import { proxy } from "valtio/vanilla";
@@ -442,6 +442,16 @@ var Simulation = class {
     this.adapter = adapter;
     this.fixedTimestep = options.fixedTimestep ?? DEFAULT_FIXED_TIMESTEP;
     this.maxSubSteps = Math.max(1, options.maxSubSteps ?? DEFAULT_MAX_SUB_STEPS);
+    if (options.solverIterations !== void 0) {
+      this.adapter.setSolverIterations(options.solverIterations);
+    }
+    if (options.sleepLinearThreshold !== void 0 || options.sleepAngularThreshold !== void 0 || options.timeUntilSleep !== void 0) {
+      this.adapter.setSleepThresholds(
+        options.sleepLinearThreshold ?? 0.8,
+        options.sleepAngularThreshold ?? 1,
+        options.timeUntilSleep ?? 0.5
+      );
+    }
   }
   // ─── Entity lifecycle ───────────────────────────────────────────────
   /**
@@ -634,6 +644,19 @@ var Simulation = class {
   setGravity(x, y, z) {
     this.adapter.setGravity(x, y, z);
   }
+  setSolverIterations(iterations) {
+    this.adapter.setSolverIterations(iterations);
+  }
+  setSleepThresholds(normalizedLinearThreshold, angularThreshold, timeUntilSleep) {
+    this.adapter.setSleepThresholds(
+      normalizedLinearThreshold,
+      angularThreshold,
+      timeUntilSleep
+    );
+  }
+  awakeDynamicCount() {
+    return this.adapter.awakeDynamicCount();
+  }
   /** Physics raycast; the hit's slot is resolved to an entity handle. */
   castRay(origin, dir, maxDistance, solidOnly = true) {
     const hit = this.adapter.castRay(origin, dir, maxDistance, solidOnly);
@@ -790,4 +813,3 @@ export {
   wrapAround3D,
   wrapAroundXY
 };
-//# sourceMappingURL=core.js.map

package/dist/destructible-3d.d.ts

@@ -1,4 +1,4 @@
-import { a as BehaviorDescriptor } from './behavior-system-CldqNUgr.js';
+import { a as BehaviorDescriptor } from './behavior-system-HEt67el5.js';
 import { Material } from 'three';
 import { FractureOptions, DestructibleMesh } from '@dgreenheck/three-pinata';
 export { DestructibleMesh, FractureOptions, VoronoiOptions } from '@dgreenheck/three-pinata';

package/dist/destructible-3d.js

@@ -2,13 +2,12 @@ import {
   Destructible3DBehavior,
   DestructibleMesh,
   FractureOptions
-} from "./chunk-JVADRLWX.js";
-import "./chunk-HZMY3TT4.js";
-import "./chunk-EZNCCO4L.js";
-import "./chunk-5WRI5ZAA.js";
+} from "./chunk-SHZZ2QRV.js";
+import "./chunk-4DVDFCVY.js";
+import "./chunk-YDLO5M7S.js";
+import "./chunk-JSBRDJBE.js";
 export {
   Destructible3DBehavior,
   DestructibleMesh,
   FractureOptions
 };
-//# sourceMappingURL=destructible-3d.js.map

package/dist/destructible-prebake.js

@@ -8,8 +8,8 @@ import {
   plainFractureOptionsToPinata,
   plainToBufferGeometry,
   plainWorkerResultToTemplateParts
-} from "./chunk-HZMY3TT4.js";
-import "./chunk-5WRI5ZAA.js";
+} from "./chunk-4DVDFCVY.js";
+import "./chunk-JSBRDJBE.js";
 export {
   bufferGeometryToPlain,
   buildFractureGeometryCacheKey,
@@ -21,4 +21,3 @@ export {
   plainToBufferGeometry,
   plainWorkerResultToTemplateParts
 };
-//# sourceMappingURL=destructible-prebake.js.map

package/dist/{first-person-perspective-C9Mptl0-.d.ts → first-person-perspective-BxFHgFln.d.ts}

@@ -18,6 +18,8 @@ interface FirstPersonPerspective {
     look(deltaYaw: number, deltaPitch: number): void;
     /** Set absolute yaw and pitch. */
     setLook?(yaw: number, pitch: number): void;
+    /** Set eye height above the followed target. */
+    setEyeHeight?(height: number): void;
 }
 
 export type { FirstPersonPerspective as F };

package/dist/first-person.d.ts

@@ -1,9 +1,9 @@
 import { F as FirstPersonInputComponent, b as FirstPersonStateComponent, a as FirstPersonMovementComponent } from './components-qWwOsvwh.js';
 export { c as createFirstPersonInputComponent, d as createFirstPersonMovementComponent, e as createFirstPersonStateComponent } from './components-qWwOsvwh.js';
 import { S as SyncStateMachine } from './sync-state-machine-CZyspBpj.js';
-import { Vector3, Euler } from 'three';
-import { F as FirstPersonPerspective } from './first-person-perspective-C9Mptl0-.js';
-import { Z as TransformState, e as BehaviorRuntime, a as BehaviorDescriptor } from './behavior-system-CldqNUgr.js';
+import { Vector3, Euler, Object3D } from 'three';
+import { F as FirstPersonPerspective } from './first-person-perspective-BxFHgFln.js';
+import { Z as TransformState, e as BehaviorRuntime, a as BehaviorDescriptor } from './behavior-system-HEt67el5.js';
 import { i as Vec3Input } from './vector-DjhLUrak.js';
 import 'typescript-fsm';
 import '@zylem/runtime';
@@ -95,6 +95,12 @@ interface ViewmodelConfig {
     offset: Vector3;
     /** Additional rotation applied to the viewmodel in local space (Euler angles in radians). */
     rotation?: Euler;
+    /**
+     * When set, the viewmodel group is parented to this Object3D (typically the
+     * Three.js camera) and kept at the local offset/rotation. This avoids
+     * world-space teleport jitter from physics pose sync fighting the camera.
+     */
+    cameraObject?: Object3D;
 }
 /**
  * Presentation system driven by runtime pose + snapshot reads.
@@ -120,6 +126,7 @@ declare class FirstPersonPresentation {
     syncEntity(entityUuid: string, runtime: BehaviorRuntime, handle: number, movement: FirstPersonMovementComponent, state: FirstPersonStateComponent | undefined): void;
     /**
      * Position a viewmodel entity relative to the camera's eye position and rotation.
+     * Prefer `cameraObject` parenting for jitter-free follow during movement.
      */
     private positionViewmodel;
     /** Cleanup */
@@ -145,6 +152,8 @@ interface FirstPersonBehaviorOptions {
         entity: any;
         offset: Vec3Input;
         rotation?: Euler;
+        /** Parent the viewmodel to this Object3D (e.g. the Three.js camera) for jitter-free follow. */
+        cameraObject?: Object3D;
     };
 }
 /**

package/dist/first-person.js

@@ -4,17 +4,17 @@ import {
   FirstPersonFSM,
   FirstPersonPresentation,
   FirstPersonState
-} from "./chunk-G2KUXVU6.js";
+} from "./chunk-CTSYM56P.js";
 import {
   createFirstPersonInputComponent,
   createFirstPersonMovementComponent,
   createFirstPersonStateComponent
-} from "./chunk-QVCMJ4Q2.js";
-import "./chunk-M3QDKKDF.js";
-import "./chunk-AS3HR7AS.js";
-import "./chunk-DZ4LLQON.js";
-import "./chunk-EZNCCO4L.js";
-import "./chunk-5WRI5ZAA.js";
+} from "./chunk-4EWASZHB.js";
+import "./chunk-LWM346FW.js";
+import "./chunk-OBF6BIA2.js";
+import "./chunk-GZ3DQIIZ.js";
+import "./chunk-YDLO5M7S.js";
+import "./chunk-JSBRDJBE.js";
 export {
   FirstPersonBehavior,
   FirstPersonEvent,
@@ -25,4 +25,3 @@ export {
   createFirstPersonMovementComponent,
   createFirstPersonStateComponent
 };
-//# sourceMappingURL=first-person.js.map

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-export { a as BehaviorDescriptor, c as BehaviorHandle, d as BehaviorRef, f as BehaviorSystem, h as BehaviorSystemFactory, D as DefineBehaviorConfig, a5 as defineBehavior } from './behavior-system-CldqNUgr.js';
-export { P as PhysicsBodyComponent, T as TransformComponent, c as createPhysicsBodyComponent, a as createTransformComponent, u as useBehavior } from './components-BmievOxF.js';
+export { a as BehaviorDescriptor, c as BehaviorHandle, d as BehaviorRef, f as BehaviorSystem, h as BehaviorSystemFactory, D as DefineBehaviorConfig, a5 as defineBehavior } from './behavior-system-HEt67el5.js';
+export { P as PhysicsBodyComponent, T as TransformComponent, c as createPhysicsBodyComponent, a as createTransformComponent, u as useBehavior } from './components-JZQoO2sU.js';
 export { T as ThrusterInputComponent, a as ThrusterMovementComponent, b as ThrusterStateComponent, c as createThrusterInputComponent, d as createThrusterMovementComponent, e as createThrusterStateComponent } from './components-B29WHGQN.js';
 export { PlayerInput, ThrusterBehavior, ThrusterBehaviorOptions, ThrusterEntity, ThrusterEvent, ThrusterFSM, ThrusterFSMContext, ThrusterState } from './thruster.js';
 export { T as TopDownMovementComponent, a as TopDownMovementInputComponent, b as TopDownMovementStateComponent, c as createTopDownMovementComponent, d as createTopDownMovementInputComponent, e as createTopDownMovementStateComponent } from './components-XCpL6IYt.js';
@@ -29,15 +29,15 @@ export { FirstPersonShooterCoordinator, FirstPersonShooterEntity, FirstPersonSho
 export { TopDownShooterCoordinator, TopDownShooterEntity, TopDownShooterInput } from './coordinators/top-down-shooter.js';
 export { MultidirectionalSpaceShooterCoordinator, MultidirectionalSpaceShooterEntity, MultidirectionalSpaceShooterInput } from './coordinators/multidirectional-space-shooter.js';
 export { F as FacingAngle2DEntity, R as ResolvedAim2D, S as Shooter2DAimFireInput, f as fireShooter2DIfRequested, g as getEntityFacingAngle2D, r as resolveAim2D } from './shooter-fire-DGripl0z.js';
-export { P as ParticleEffectDefinition, a as ParticleMagicAgency, b as ParticleMagicAlignment, c as ParticleMagicModifierInput, d as ParticleMagicModifierOptions, e as ParticleMagicOrder, f as ParticleMagicRealityEffect, g as ParticleMagicTemperament, h as ParticlePresetMaterialOptions, S as SemanticParticlePresetOptions, v as particleEffect } from './spark-Dx3cJbTW.js';
+export { P as ParticleEffectDefinition, a as ParticleMagicAgency, b as ParticleMagicAlignment, c as ParticleMagicModifierInput, d as ParticleMagicModifierOptions, e as ParticleMagicOrder, f as ParticleMagicRealityEffect, g as ParticleMagicTemperament, h as ParticlePresetMaterialOptions, S as SemanticParticlePresetOptions, v as particleEffect } from './spark-C4Tp-52_.js';
 import '@zylem/runtime';
 import 'three';
 import './sync-state-machine-CZyspBpj.js';
 import 'typescript-fsm';
 import './vector-DjhLUrak.js';
 import './entity-types-DhfsZbSK.js';
-import './first-person-perspective-C9Mptl0-.js';
-import './moveable-rdIvWiak.js';
+import './first-person-perspective-BxFHgFln.js';
+import './moveable-BdFmI3s1.js';
 import 'three/webgpu';
 
 /**