@zylem/behaviors 0.4.1 → 0.5.2

package/dist/index.js

@@ -3,47 +3,47 @@ import {
 } from "./chunk-H4TJ7X4O.js";
 import {
   MultidirectionalSpaceShooterCoordinator
-} from "./chunk-FTDZAKZW.js";
+} from "./chunk-NQPYMUDF.js";
 import {
   TopDownShooterCoordinator
-} from "./chunk-ZA43LPRM.js";
+} from "./chunk-KIYUUSPK.js";
 import {
-  fireShooter2DIfRequested,
-  getEntityFacingAngle2D,
-  resolveAim2D
-} from "./chunk-UL6Q5HDP.js";
+  fireShooter2DIfRequested
+} from "./chunk-52FJIDGL.js";
 import {
   ScreenWrapBehavior,
   ScreenWrapEvent,
   ScreenWrapFSM,
   ScreenWrapState
-} from "./chunk-GFARAJV2.js";
+} from "./chunk-2PAHQZZD.js";
 import {
   Shooter2DBehavior,
   createShooter2DStateComponent
-} from "./chunk-5XZWTFGF.js";
+} from "./chunk-PLIXVF7B.js";
 import {
   ThrusterBehavior,
   ThrusterEvent,
   ThrusterFSM,
-  ThrusterState,
-  ThrusterSystem
-} from "./chunk-75FJIUIG.js";
+  ThrusterState
+} from "./chunk-BAXJ7XHJ.js";
 import {
   createThrusterInputComponent,
   createThrusterMovementComponent,
   createThrusterStateComponent
 } from "./chunk-IZJFUAXB.js";
 import {
-  TopDownMovementBehavior,
-  TopDownMovementSystem
-} from "./chunk-A4CA35DQ.js";
+  TopDownMovementBehavior
+} from "./chunk-Y4PHT2HG.js";
 import {
   createTopDownMovementComponent,
   createTopDownMovementInputComponent,
   createTopDownMovementStateComponent
 } from "./chunk-EIWQM6U3.js";
-import "./chunk-Y7YIAWPW.js";
+import {
+  getEntityFacingAngle2D,
+  resolveAim2D
+} from "./chunk-TBUKJKY6.js";
+import "./chunk-SGHIGTVZ.js";
 import {
   WorldBoundary2DBehavior,
   WorldBoundary2DEvent,
@@ -51,7 +51,7 @@ import {
   WorldBoundary2DState,
   computeWorldBoundary2DHits,
   hasAnyWorldBoundary2DHit
-} from "./chunk-VMQHNJJI.js";
+} from "./chunk-7DGXUAPV.js";
 import {
   WorldBoundary3DBehavior,
   WorldBoundary3DEvent,
@@ -59,11 +59,11 @@ import {
   WorldBoundary3DState,
   computeWorldBoundary3DHits,
   hasAnyWorldBoundary3DHit
-} from "./chunk-Z72F2ENM.js";
+} from "./chunk-WU6XXL3D.js";
 import {
   BoundaryRicochetCoordinator
-} from "./chunk-XP3ASVGJ.js";
-import "./chunk-KDY5N6J4.js";
+} from "./chunk-NW4SE5XW.js";
+import "./chunk-OPZ2LVS2.js";
 import {
   BoundaryRicochet3DCoordinator
 } from "./chunk-KFFETUAL.js";
@@ -74,7 +74,7 @@ import {
 import {
   ParticleEmitterBehavior,
   particlePresets
-} from "./chunk-5SM5SH5O.js";
+} from "./chunk-7JLWZXPA.js";
 import {
   particleEffect
 } from "./chunk-7JJEIADR.js";
@@ -83,33 +83,31 @@ import {
   Platformer2DEvent,
   Platformer2DFSM,
   Platformer2DState,
-  Platformer2DSystem,
   createPlatformer2DInputComponent,
   createPlatformer2DMovementComponent,
   createPlatformer2DStateComponent
-} from "./chunk-UIG7MWS2.js";
+} from "./chunk-4MZ57HPD.js";
 import {
   Platformer3DBehavior,
   Platformer3DEvent,
   Platformer3DFSM,
   Platformer3DState,
-  Platformer3DSystem,
   createPlatformer3DInputComponent,
   createPlatformer3DMovementComponent,
   createPlatformer3DStateComponent
-} from "./chunk-67XLJ26X.js";
+} from "./chunk-4LLK2FJI.js";
 import {
   Ricochet2DBehavior,
   Ricochet2DEvent,
   Ricochet2DFSM,
   Ricochet2DState
-} from "./chunk-QDCJLJUV.js";
+} from "./chunk-7W3KY55G.js";
 import {
   Ricochet3DBehavior,
   Ricochet3DEvent,
   Ricochet3DFSM,
   Ricochet3DState
-} from "./chunk-27UPCP5B.js";
+} from "./chunk-QS3VXWVO.js";
 import {
   ScreenVisibilityBehavior,
   ScreenVisibilityFSM
@@ -118,7 +116,7 @@ import {
   createPhysicsBodyComponent,
   createTransformComponent,
   useBehavior
-} from "./chunk-UYFOLI2X.js";
+} from "./chunk-5A5AYP2C.js";
 import {
   CooldownBehavior,
   fireCooldown,
@@ -127,57 +125,52 @@ import {
   registerCooldown,
   resetCooldown,
   tickCooldowns
-} from "./chunk-ZRQWSURL.js";
+} from "./chunk-5XPPLTC7.js";
 import {
   Destructible3DBehavior,
   DestructibleMesh,
   FractureOptions
-} from "./chunk-BXP4K7RF.js";
+} from "./chunk-JVADRLWX.js";
 import "./chunk-HZMY3TT4.js";
 import {
   FirstPersonBehavior,
   FirstPersonEvent,
   FirstPersonFSM,
-  FirstPersonState,
-  FirstPersonSystem
-} from "./chunk-4L36OPY2.js";
+  FirstPersonPresentation,
+  FirstPersonState
+} from "./chunk-G2KUXVU6.js";
 import {
   createFirstPersonInputComponent,
   createFirstPersonMovementComponent,
   createFirstPersonStateComponent
 } from "./chunk-QVCMJ4Q2.js";
-import "./chunk-WWVD5DR5.js";
+import "./chunk-M3QDKKDF.js";
 import {
   Jumper2DBehavior,
   Jumper2DEvent,
   Jumper2DFSM,
   Jumper2DState,
-  Jumper2DSystem,
-  Jumper2DTickEvent,
   createJumpConfig2D,
   createJumpInput2D,
   createJumpState2D
-} from "./chunk-F72WX4MH.js";
+} from "./chunk-4CEW64HO.js";
 import {
   Jumper3DBehavior,
   Jumper3DEvent,
   Jumper3DFSM,
-  Jumper3DState,
-  Jumper3DSystem,
-  JumperTickEvent
-} from "./chunk-RDHSHEZM.js";
+  Jumper3DState
+} from "./chunk-LZIHSJZR.js";
 import {
   createJumpConfig3D,
   createJumpInput3D,
   createJumpState3D
 } from "./chunk-4WH2ZN7P.js";
-import "./chunk-JXMF4NUI.js";
-import "./chunk-OTLSUYQQ.js";
-import "./chunk-4URF65BR.js";
-import "./chunk-Q75LKHDF.js";
+import "./chunk-AS3HR7AS.js";
+import "./chunk-DZ4LLQON.js";
 import {
   defineBehavior
 } from "./chunk-EZNCCO4L.js";
+import "./chunk-5WRI5ZAA.js";
 export {
   BoundaryRicochet3DCoordinator,
   BoundaryRicochetCoordinator,
@@ -187,34 +180,28 @@ export {
   FirstPersonBehavior,
   FirstPersonEvent,
   FirstPersonFSM,
+  FirstPersonPresentation,
   FirstPersonShooterCoordinator,
   FirstPersonState,
-  FirstPersonSystem,
   FractureOptions,
   Jumper2DBehavior,
   Jumper2DEvent,
   Jumper2DFSM,
   Jumper2DState,
-  Jumper2DSystem,
-  Jumper2DTickEvent,
   Jumper3DBehavior,
   Jumper3DEvent,
   Jumper3DFSM,
   Jumper3DState,
-  Jumper3DSystem,
-  JumperTickEvent,
   MultidirectionalSpaceShooterCoordinator,
   ParticleEmitterBehavior,
   Platformer2DBehavior,
   Platformer2DEvent,
   Platformer2DFSM,
   Platformer2DState,
-  Platformer2DSystem,
   Platformer3DBehavior,
   Platformer3DEvent,
   Platformer3DFSM,
   Platformer3DState,
-  Platformer3DSystem,
   Ricochet2DBehavior,
   Ricochet2DEvent,
   Ricochet2DFSM,
@@ -234,9 +221,7 @@ export {
   ThrusterEvent,
   ThrusterFSM,
   ThrusterState,
-  ThrusterSystem,
   TopDownMovementBehavior,
-  TopDownMovementSystem,
   TopDownShooterCoordinator,
   WorldBoundary2DBehavior,
   WorldBoundary2DEvent,

package/dist/jumper-2d.d.ts

@@ -1,7 +1,7 @@
 import { S as SyncStateMachine } from './sync-state-machine-CZyspBpj.js';
-import * as _dimforge_rapier3d_compat from '@dimforge/rapier3d-compat';
-import { a as BehaviorDescriptor, T as TransformState } from './behavior-system-y8SGrGWy.js';
+import { a as BehaviorDescriptor, Z as TransformState } from './behavior-system-CldqNUgr.js';
 import 'typescript-fsm';
+import '@zylem/runtime';
 
 interface JumpConfig2D {
     jumpHeight: number;
@@ -44,19 +44,6 @@ interface JumpState2D {
 }
 declare function createJumpState2D(): JumpState2D;
 
-declare enum Jumper2DTickEvent {
-    None = "none",
-    Jump = "jump",
-    Fall = "fall",
-    Land = "land"
-}
-interface Jumper2DTickResult {
-    event: Jumper2DTickEvent;
-}
-declare class Jumper2DSystem {
-    tick(config: JumpConfig2D, input: JumpInput2D, ctx: JumpContext2D, state: JumpState2D): Jumper2DTickResult;
-}
-
 declare enum Jumper2DState {
     Grounded = "grounded",
     Jumping = "jumping",
@@ -98,7 +85,6 @@ interface Jumper2DBehaviorOptions {
 }
 interface Jumper2DEntity {
     uuid: string;
-    body: _dimforge_rapier3d_compat.RigidBody | null;
     transformStore: TransformState;
     jumper2d: JumpConfig2D;
     $jumper2d: JumpInput2D;
@@ -111,4 +97,4 @@ declare const Jumper2DBehavior: BehaviorDescriptor<Jumper2DBehaviorOptions, {
     getJumpsRemaining: () => number;
 }, Jumper2DEntity>;
 
-export { type JumpConfig2D, type JumpContext2D, type JumpInput2D, type JumpState2D, Jumper2DBehavior, type Jumper2DBehaviorOptions, type Jumper2DEntity, Jumper2DEvent, Jumper2DFSM, Jumper2DState, Jumper2DSystem, Jumper2DTickEvent, type Jumper2DTickResult, createJumpConfig2D, createJumpInput2D, createJumpState2D };
+export { type JumpConfig2D, type JumpContext2D, type JumpInput2D, type JumpState2D, Jumper2DBehavior, type Jumper2DBehaviorOptions, type Jumper2DEntity, Jumper2DEvent, Jumper2DFSM, Jumper2DState, createJumpConfig2D, createJumpInput2D, createJumpState2D };

package/dist/jumper-2d.js

@@ -3,24 +3,19 @@ import {
   Jumper2DEvent,
   Jumper2DFSM,
   Jumper2DState,
-  Jumper2DSystem,
-  Jumper2DTickEvent,
   createJumpConfig2D,
   createJumpInput2D,
   createJumpState2D
-} from "./chunk-F72WX4MH.js";
-import "./chunk-JXMF4NUI.js";
-import "./chunk-OTLSUYQQ.js";
-import "./chunk-4URF65BR.js";
-import "./chunk-Q75LKHDF.js";
+} from "./chunk-4CEW64HO.js";
+import "./chunk-AS3HR7AS.js";
+import "./chunk-DZ4LLQON.js";
 import "./chunk-EZNCCO4L.js";
+import "./chunk-5WRI5ZAA.js";
 export {
   Jumper2DBehavior,
   Jumper2DEvent,
   Jumper2DFSM,
   Jumper2DState,
-  Jumper2DSystem,
-  Jumper2DTickEvent,
   createJumpConfig2D,
   createJumpInput2D,
   createJumpState2D

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

@@ -1,42 +1,9 @@
-import { J as JumpConfig3D, b as JumpInput3D, a as JumpContext3D, c as JumpState3D } from './components--hjBMTnz.js';
-export { V as Vec3Like, d as createJumpConfig3D, e as createJumpInput3D, f as createJumpState3D } from './components--hjBMTnz.js';
+import { c as JumpState3D, J as JumpConfig3D, b as JumpInput3D } from './components--hjBMTnz.js';
+export { a as JumpContext3D, V as Vec3Like, d as createJumpConfig3D, e as createJumpInput3D, f as createJumpState3D } from './components--hjBMTnz.js';
 import { S as SyncStateMachine } from './sync-state-machine-CZyspBpj.js';
-import * as _dimforge_rapier3d_compat from '@dimforge/rapier3d-compat';
-import { a as BehaviorDescriptor, T as TransformState } from './behavior-system-y8SGrGWy.js';
+import { a as BehaviorDescriptor, Z as TransformState } from './behavior-system-CldqNUgr.js';
 import 'typescript-fsm';
-
-/**
- * Jumper 3D Behavior — Pure Jump Physics
- *
- * A stateless tick function that receives configuration, input, context, and
- * state, then applies jump physics through the context's velocity helpers.
- *
- * Vertical velocity (Y) is owned exclusively by this behavior.
- * Horizontal velocity (X/Z) is only touched when airborne planar control
- * is configured; otherwise the movement controller owns X/Z.
- */
-
-declare class Jumper3DSystem {
-    /**
-     * Advance the jump system by one frame.
-     *
-     * Call order within a frame:
-     *   1. Movement controller writes X/Z via transformStore.dirty.velocityX/Z.
-     *   2. `tick()` writes Y via ctx.setVerticalVelocity().
-     *      (Optionally writes X/Z when airborne planar control is active.)
-     */
-    tick(config: JumpConfig3D, input: JumpInput3D, ctx: JumpContext3D, state: JumpState3D): JumperTickResult;
-}
-/** Events emitted by a single tick (used by FSM). */
-declare enum JumperTickEvent {
-    None = "none",
-    Jump = "jump",
-    Fall = "fall",
-    Land = "land"
-}
-interface JumperTickResult {
-    event: JumperTickEvent;
-}
+import '@zylem/runtime';
 
 /**
  * Jumper 3D Finite State Machine
@@ -117,7 +84,6 @@ interface Jumper3DBehaviorOptions {
 }
 interface Jumper3DEntity {
     uuid: string;
-    body: _dimforge_rapier3d_compat.RigidBody | null;
     transformStore: TransformState;
     jumper: JumpConfig3D;
     $jumper: JumpInput3D;
@@ -162,4 +128,4 @@ declare const Jumper3DBehavior: BehaviorDescriptor<Jumper3DBehaviorOptions, {
     getJumpsRemaining: () => number;
 }, Jumper3DEntity>;
 
-export { JumpConfig3D, JumpContext3D, JumpInput3D, JumpState3D, Jumper3DBehavior, type Jumper3DBehaviorOptions, type Jumper3DEntity, Jumper3DEvent, Jumper3DFSM, Jumper3DState, Jumper3DSystem, JumperTickEvent, type JumperTickResult };
+export { JumpConfig3D, JumpInput3D, JumpState3D, Jumper3DBehavior, type Jumper3DBehaviorOptions, type Jumper3DEntity, Jumper3DEvent, Jumper3DFSM, Jumper3DState };

package/dist/jumper-3d.js

@@ -2,27 +2,22 @@ import {
   Jumper3DBehavior,
   Jumper3DEvent,
   Jumper3DFSM,
-  Jumper3DState,
-  Jumper3DSystem,
-  JumperTickEvent
-} from "./chunk-RDHSHEZM.js";
+  Jumper3DState
+} from "./chunk-LZIHSJZR.js";
 import {
   createJumpConfig3D,
   createJumpInput3D,
   createJumpState3D
 } from "./chunk-4WH2ZN7P.js";
-import "./chunk-JXMF4NUI.js";
-import "./chunk-OTLSUYQQ.js";
-import "./chunk-4URF65BR.js";
-import "./chunk-Q75LKHDF.js";
+import "./chunk-AS3HR7AS.js";
+import "./chunk-DZ4LLQON.js";
 import "./chunk-EZNCCO4L.js";
+import "./chunk-5WRI5ZAA.js";
 export {
   Jumper3DBehavior,
   Jumper3DEvent,
   Jumper3DFSM,
   Jumper3DState,
-  Jumper3DSystem,
-  JumperTickEvent,
   createJumpConfig3D,
   createJumpInput3D,
   createJumpState3D

package/dist/{moveable-Cl9h-_w7.d.ts → moveable-rdIvWiak.d.ts}

@@ -1,9 +1,26 @@
 import { Vector3 } from 'three';
-import { RigidBody, Vector } from '@dimforge/rapier3d-compat';
-import { T as TransformState } from './behavior-system-y8SGrGWy.js';
+import { Z as TransformState } from './behavior-system-CldqNUgr.js';
 
+/** Plain `{ x, y, z }` vector returned by pose/velocity reads. */
+interface Vector {
+    x: number;
+    y: number;
+    z: number;
+}
+/**
+ * Structural slice of the host body reference used by the direct-body helpers
+ * below (`getPosition`, `setPosition`, `resetVelocity`, ...). The host's
+ * runtime-backed body proxy satisfies this shape.
+ */
+interface MoveableBodyLike {
+    translation(): Vector;
+    linvel(): Vector;
+    setTranslation(translation: Vector, wakeUp: boolean): void;
+    setLinvel(velocity: Vector, wakeUp: boolean): void;
+    setLinearDamping(damping: number): void;
+}
 interface EntityWithBody {
-    body: RigidBody | null;
+    body: MoveableBodyLike | null;
     transformStore?: TransformState;
 }
 /**
@@ -97,4 +114,4 @@ interface MoveableEntity extends EntityWithBody {
  */
 declare function makeMoveable<T extends EntityWithBody>(entity: T): T & MoveableEntity;
 
-export { type EntityWithBody as E, type MoveableEntity as M, getVelocity as a, move as b, moveForwardXY as c, moveX as d, moveXY as e, moveXZ as f, getPosition as g, moveY as h, moveZ as i, setPositionX as j, setPositionY as k, setPositionZ as l, makeMoveable as m, wrapAroundXY as n, resetVelocity as r, setPosition as s, wrapAround3D as w };
+export { type EntityWithBody as E, type MoveableBodyLike as M, type Vector as V, type MoveableEntity as a, getVelocity as b, move as c, moveForwardXY as d, moveX as e, moveXY as f, getPosition as g, moveXZ as h, moveY as i, moveZ as j, setPositionX as k, setPositionY as l, makeMoveable as m, setPositionZ as n, wrapAroundXY as o, resetVelocity as r, setPosition as s, wrapAround3D as w };

package/dist/particle-emitter/presets.js

@@ -5,6 +5,7 @@ import {
   magicPresets,
   waterPresets
 } from "../chunk-7JJEIADR.js";
+import "../chunk-5WRI5ZAA.js";
 export {
   electricityPresets,
   firePresets,

package/dist/particle-emitter.d.ts

@@ -1,9 +1,9 @@
-import { a as BehaviorDescriptor } from './behavior-system-y8SGrGWy.js';
-import { i as Vec3Input } from './vector-Bm65-FOG.js';
+import { a as BehaviorDescriptor } from './behavior-system-CldqNUgr.js';
+import { i as Vec3Input } from './vector-DjhLUrak.js';
 import { h as ParticlePresetMaterialOptions, P as ParticleEffectDefinition, C as spark, o as ember, p as flamelet, l as blaze, A as smolder, t as mist, E as spray, D as splash, n as drizzle, H as torrent, I as vapor, z as smoke, q as haze, w as plume, s as miasma, B as spark$1, j as arc, G as surge, y as pulse, F as storm, k as arcane, r as holy, m as corrupted, u as nature, J as voidMagic, x as psychic, i as Particles } from './spark-Dx3cJbTW.js';
 export { a as ParticleMagicAgency, b as ParticleMagicAlignment, c as ParticleMagicModifierInput, d as ParticleMagicModifierOptions, e as ParticleMagicOrder, f as ParticleMagicRealityEffect, g as ParticleMagicTemperament, S as SemanticParticlePresetOptions, v as particleEffect } from './spark-Dx3cJbTW.js';
 import { ColorRepresentation } from 'three';
-import '@dimforge/rapier3d-compat';
+import '@zylem/runtime';
 import 'three/webgpu';
 
 interface BurstParticlePresetOptions extends ParticlePresetMaterialOptions {

package/dist/particle-emitter.js

@@ -1,12 +1,13 @@
 import {
   ParticleEmitterBehavior,
   particlePresets
-} from "./chunk-5SM5SH5O.js";
+} from "./chunk-7JLWZXPA.js";
 import {
   particleEffect
 } from "./chunk-7JJEIADR.js";
-import "./chunk-WWVD5DR5.js";
+import "./chunk-M3QDKKDF.js";
 import "./chunk-EZNCCO4L.js";
+import "./chunk-5WRI5ZAA.js";
 export {
   ParticleEmitterBehavior,
   particleEffect,

package/dist/platformer-2d.d.ts

@@ -1,7 +1,7 @@
 import { S as SyncStateMachine } from './sync-state-machine-CZyspBpj.js';
-import { RigidBody, Collider } from '@dimforge/rapier3d-compat';
-import { Z as ZylemWorld, a as BehaviorDescriptor } from './behavior-system-y8SGrGWy.js';
+import { a as BehaviorDescriptor } from './behavior-system-CldqNUgr.js';
 import 'typescript-fsm';
+import '@zylem/runtime';
 
 /**
  * Platformer 2D Components
@@ -153,85 +153,6 @@ declare class Platformer2DFSM {
     update(input: Platformer2DInputComponent, state: Platformer2DStateComponent): void;
 }
 
-/**
- * Platformer 2D System
- *
- * Kinematic character controller (SNES-style) on the X/Y plane: the
- * controller owns all motion and physics is only a collision database.
- *
- * - The entity's body is converted to `KinematicPositionBased` on first
- *   update; Rapier never applies forces to it.
- * - Each tick, desired displacement (X input + integrated vertical velocity,
- *   z locked to 0) is run through Rapier's `KinematicCharacterController`
- *   (collide-and-slide with autostep, slope limits, and snap-to-ground) and
- *   the corrected movement is applied via `setNextKinematicTranslation`. The
- *   z coordinate is re-pinned to its first-seen value every tick so slide
- *   resolution can never drift the entity off the 2D plane.
- * - Grounded comes from `controller.computedGrounded()` — no contact-pair or
- *   raycast probing.
- * - Vertical velocity lives in `state.verticalVelocity` (`linvel()` is
- *   meaningless on kinematic bodies). Jump buffering, coyote time,
- *   multi-jump, and the jump-cut ramp all operate on that field.
- */
-
-/**
- * Entity with 2D platformer components
- */
-interface Platformer2DEntity {
-    uuid: string;
-    body: RigidBody;
-    collider?: Collider | null;
-    platformer2D: Platformer2DMovementComponent;
-    $platformer2D: Platformer2DInputComponent;
-    platformer2DState: Platformer2DStateComponent;
-}
-/**
- * Platformer 2D movement system.
- *
- * Core kinematic controller for 2D platformer movement. Requires a live
- * `ZylemWorld` with the raw Rapier `World` exposed on `.world` — without it
- * the system is a no-op.
- */
-declare class Platformer2DSystem {
-    private world;
-    /** Per-entity character controllers, keyed by entity uuid. */
-    private controllers;
-    /** Spawn-time z per entity; re-pinned every tick to hold the 2D plane. */
-    private planeZ;
-    constructor(world: ZylemWorld | null);
-    /**
-     * One-time per-entity physics setup: convert the body to a
-     * position-based kinematic body, record the plane z, and create the
-     * entity's character controller. Done lazily on the first update because
-     * the body isn't always available at construction time.
-     */
-    private ensurePhysicsConfigured;
-    /**
-     * Handle jump logic with multi-jump, coyote time, buffering, and jump-cut
-     * ramp. All vertical motion is written to `state.verticalVelocity`.
-     */
-    private handleJump;
-    /**
-     * Integrate gravity into `state.verticalVelocity`.
-     *
-     * While grounded (and not on the jump frame) vertical velocity is held at
-     * a small constant downward speed so the controller stays pressed into
-     * the ground. Skipped entirely on the frame a jump was applied — the
-     * grounded flag is still stale-true then and would clobber the jump.
-     */
-    private applyGravity;
-    /**
-     * Update entity state from the controller's grounded result.
-     */
-    private updateState;
-    /**
-     * Update one platformer entity. Invoked per linked entity by the
-     * Platformer2DBehaviorSystem adapter.
-     */
-    updateEntity(entity: Platformer2DEntity, delta: number): void;
-    destroy(): void;
-}
-
 /**
  * Platformer 2D behavior options (typed for entity.use() autocomplete)
  */
@@ -265,6 +186,24 @@ interface Platformer2DBehaviorOptions {
     snapToGroundDistance?: number;
     /** Character controller collision offset (default: 0.05) */
     characterOffset?: number;
+    /** Explicit KCC capsule override (requires `useAttachedCollider: false`). */
+    shape?: {
+        halfHeight: number;
+        radius: number;
+        offset?: [number, number, number];
+    };
+    /** When true (default), KCC reads shape + offset from the attached Rapier collider. */
+    useAttachedCollider?: boolean;
+}
+/**
+ * Entity with 2D platformer components (input written by the game; the wasm
+ * runtime owns the kinematic character controller and FSM).
+ */
+interface Platformer2DEntity {
+    uuid: string;
+    platformer2D: Platformer2DMovementComponent;
+    $platformer2D: Platformer2DInputComponent;
+    platformer2DState: Platformer2DStateComponent;
 }
 /**
  * Platformer2DBehavior - typed descriptor for 2D platformer movement
@@ -303,4 +242,4 @@ declare const Platformer2DBehavior: BehaviorDescriptor<Platformer2DBehaviorOptio
     getJumpCount: () => number;
 }, Platformer2DEntity>;
 
-export { Platformer2DBehavior, type Platformer2DBehaviorOptions, type Platformer2DCollisionContext, type Platformer2DContext, type Platformer2DEntity, Platformer2DEvent, Platformer2DFSM, type Platformer2DInputComponent, type Platformer2DMovementComponent, Platformer2DState, type Platformer2DStateComponent, Platformer2DSystem, createPlatformer2DInputComponent, createPlatformer2DMovementComponent, createPlatformer2DStateComponent };
+export { Platformer2DBehavior, type Platformer2DBehaviorOptions, type Platformer2DCollisionContext, type Platformer2DContext, type Platformer2DEntity, Platformer2DEvent, Platformer2DFSM, type Platformer2DInputComponent, type Platformer2DMovementComponent, Platformer2DState, type Platformer2DStateComponent, createPlatformer2DInputComponent, createPlatformer2DMovementComponent, createPlatformer2DStateComponent };

package/dist/platformer-2d.js

@@ -3,20 +3,19 @@ import {
   Platformer2DEvent,
   Platformer2DFSM,
   Platformer2DState,
-  Platformer2DSystem,
   createPlatformer2DInputComponent,
   createPlatformer2DMovementComponent,
   createPlatformer2DStateComponent
-} from "./chunk-UIG7MWS2.js";
-import "./chunk-4URF65BR.js";
-import "./chunk-Q75LKHDF.js";
+} from "./chunk-4MZ57HPD.js";
+import "./chunk-AS3HR7AS.js";
+import "./chunk-DZ4LLQON.js";
 import "./chunk-EZNCCO4L.js";
+import "./chunk-5WRI5ZAA.js";
 export {
   Platformer2DBehavior,
   Platformer2DEvent,
   Platformer2DFSM,
   Platformer2DState,
-  Platformer2DSystem,
   createPlatformer2DInputComponent,
   createPlatformer2DMovementComponent,
   createPlatformer2DStateComponent