@zylem/behaviors 0.3.1 → 0.4.1

package/dist/chunk-UIG7MWS2.js

@@ -0,0 +1,518 @@
+import {
+  SyncStateMachine,
+  t
+} from "./chunk-4URF65BR.js";
+import {
+  STAGE_INPUT_BUTTON_JUMP,
+  STAGE_INPUT_BUTTON_RUN,
+  readBehaviorSnapshot
+} from "./chunk-Q75LKHDF.js";
+import {
+  defineBehavior
+} from "./chunk-EZNCCO4L.js";
+
+// src/lib/behaviors/platformer-2d/components.ts
+function createPlatformer2DMovementComponent(options = {}) {
+  return {
+    walkSpeed: options.walkSpeed ?? 8,
+    runSpeed: options.runSpeed ?? 14,
+    jumpForce: options.jumpForce ?? 12,
+    maxJumps: options.maxJumps ?? 1,
+    gravity: options.gravity ?? 20,
+    coyoteTime: options.coyoteTime ?? 0.1,
+    jumpBufferTime: options.jumpBufferTime ?? 0.1,
+    jumpCutMultiplier: options.jumpCutMultiplier ?? 0.5,
+    multiJumpWindowTime: options.multiJumpWindowTime ?? 0.15,
+    slopeClimbAngle: options.slopeClimbAngle ?? 50,
+    slopeSlideAngle: options.slopeSlideAngle ?? 40,
+    autostep: options.autostep ?? { maxHeight: 0.25, minWidth: 0.05 },
+    snapToGroundDistance: options.snapToGroundDistance ?? 0.2,
+    characterOffset: options.characterOffset ?? 0.05
+  };
+}
+function createPlatformer2DInputComponent() {
+  return {
+    moveX: 0,
+    jump: false,
+    run: false
+  };
+}
+function createPlatformer2DStateComponent() {
+  return {
+    grounded: false,
+    jumping: false,
+    falling: false,
+    jumpCount: 0,
+    jumpStartHeight: 0,
+    currentSpeed: 0,
+    lastGroundedY: 0,
+    jumpPressedLastFrame: false,
+    timeSinceGrounded: 0,
+    jumpBuffered: false,
+    jumpBufferTimer: 0,
+    jumpHeld: false,
+    jumpCutApplied: false,
+    jumpReleasedSinceLastJump: true,
+    timeSinceJump: 0,
+    jumpedThisFrame: false,
+    jumpCutRampTimer: 0,
+    verticalVelocity: 0
+  };
+}
+
+// src/lib/behaviors/platformer-2d/platformer-2d-fsm.ts
+var Platformer2DState = /* @__PURE__ */ ((Platformer2DState2) => {
+  Platformer2DState2["Idle"] = "idle";
+  Platformer2DState2["Walking"] = "walking";
+  Platformer2DState2["Running"] = "running";
+  Platformer2DState2["Jumping"] = "jumping";
+  Platformer2DState2["Falling"] = "falling";
+  Platformer2DState2["Landing"] = "landing";
+  return Platformer2DState2;
+})(Platformer2DState || {});
+var Platformer2DEvent = /* @__PURE__ */ ((Platformer2DEvent2) => {
+  Platformer2DEvent2["Walk"] = "walk";
+  Platformer2DEvent2["Run"] = "run";
+  Platformer2DEvent2["Jump"] = "jump";
+  Platformer2DEvent2["Fall"] = "fall";
+  Platformer2DEvent2["Land"] = "land";
+  Platformer2DEvent2["Stop"] = "stop";
+  return Platformer2DEvent2;
+})(Platformer2DEvent || {});
+var Platformer2DFSM = class {
+  constructor(ctx) {
+    this.ctx = ctx;
+    this.machine = new SyncStateMachine(
+      "idle" /* Idle */,
+      [
+        // Idle transitions
+        t("idle" /* Idle */, "walk" /* Walk */, "walking" /* Walking */),
+        t("idle" /* Idle */, "run" /* Run */, "running" /* Running */),
+        t("idle" /* Idle */, "jump" /* Jump */, "jumping" /* Jumping */),
+        t("idle" /* Idle */, "fall" /* Fall */, "falling" /* Falling */),
+        // Walking transitions
+        t("walking" /* Walking */, "run" /* Run */, "running" /* Running */),
+        t("walking" /* Walking */, "jump" /* Jump */, "jumping" /* Jumping */),
+        t("walking" /* Walking */, "stop" /* Stop */, "idle" /* Idle */),
+        t("walking" /* Walking */, "fall" /* Fall */, "falling" /* Falling */),
+        // Running transitions
+        t("running" /* Running */, "walk" /* Walk */, "walking" /* Walking */),
+        t("running" /* Running */, "jump" /* Jump */, "jumping" /* Jumping */),
+        t("running" /* Running */, "stop" /* Stop */, "idle" /* Idle */),
+        t("running" /* Running */, "fall" /* Fall */, "falling" /* Falling */),
+        // Jumping transitions
+        t("jumping" /* Jumping */, "fall" /* Fall */, "falling" /* Falling */),
+        t("jumping" /* Jumping */, "land" /* Land */, "landing" /* Landing */),
+        t("jumping" /* Jumping */, "jump" /* Jump */, "jumping" /* Jumping */),
+        // Multi-jump
+        // Falling transitions
+        t("falling" /* Falling */, "land" /* Land */, "landing" /* Landing */),
+        t("falling" /* Falling */, "jump" /* Jump */, "jumping" /* Jumping */),
+        // Air jump
+        // Landing transitions
+        t("landing" /* Landing */, "walk" /* Walk */, "walking" /* Walking */),
+        t("landing" /* Landing */, "run" /* Run */, "running" /* Running */),
+        t("landing" /* Landing */, "stop" /* Stop */, "idle" /* Idle */),
+        // Self-transitions (no-ops)
+        t("idle" /* Idle */, "stop" /* Stop */, "idle" /* Idle */)
+      ]
+    );
+  }
+  ctx;
+  machine;
+  getState() {
+    return this.machine.getState();
+  }
+  dispatch(event) {
+    if (this.machine.can(event)) {
+      this.machine.syncDispatch(event);
+    }
+  }
+  isGrounded() {
+    const state = this.getState();
+    return state === "idle" /* Idle */ || state === "walking" /* Walking */ || state === "running" /* Running */ || state === "landing" /* Landing */;
+  }
+  getJumpCount() {
+    return this.ctx.state.jumpCount;
+  }
+  /**
+   * Update FSM based on current component state.
+   */
+  update(input, state) {
+    this.ctx.input = input;
+    this.ctx.state = state;
+    const currentState = this.getState();
+    const hasInput = Math.abs(input.moveX) > 0.1;
+    const isRunning = input.run;
+    if (currentState === "falling" /* Falling */ && state.grounded) {
+      this.dispatch("land" /* Land */);
+    }
+    if (state.grounded) {
+      if (hasInput) {
+        if (isRunning) {
+          this.dispatch("run" /* Run */);
+        } else {
+          this.dispatch("walk" /* Walk */);
+        }
+      } else {
+        this.dispatch("stop" /* Stop */);
+      }
+    } else if (state.falling) {
+      this.dispatch("fall" /* Fall */);
+    }
+    if (input.jump && !state.jumpPressedLastFrame) {
+      this.dispatch("jump" /* Jump */);
+    }
+  }
+};
+
+// src/lib/behaviors/platformer-2d/platformer-2d.system.ts
+import { RigidBodyType, QueryFilterFlags } from "@dimforge/rapier3d-compat";
+var JUMP_CUT_RAMP_DURATION = 0.05;
+var GROUND_STICK_SPEED = 2;
+var FALL_VELOCITY_THRESHOLD = -0.1;
+var DEG_TO_RAD = Math.PI / 180;
+var _desired = { x: 0, y: 0, z: 0 };
+var Platformer2DSystem = class {
+  world;
+  /** Per-entity character controllers, keyed by entity uuid. */
+  controllers = /* @__PURE__ */ new Map();
+  /** Spawn-time z per entity; re-pinned every tick to hold the 2D plane. */
+  planeZ = /* @__PURE__ */ new Map();
+  constructor(world) {
+    this.world = world;
+  }
+  /**
+   * 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.
+   */
+  ensurePhysicsConfigured(entity) {
+    const existing = this.controllers.get(entity.uuid);
+    if (existing) return existing;
+    const physicsWorld = this.world?.world;
+    if (!physicsWorld || !entity.body) return null;
+    if (entity.body.bodyType() !== RigidBodyType.KinematicPositionBased) {
+      entity.body.setBodyType(RigidBodyType.KinematicPositionBased, true);
+    }
+    this.planeZ.set(entity.uuid, entity.body.translation().z);
+    const movement = entity.platformer2D;
+    const controller = physicsWorld.createCharacterController(movement.characterOffset);
+    controller.setUp({ x: 0, y: 1, z: 0 });
+    controller.setMaxSlopeClimbAngle(movement.slopeClimbAngle * DEG_TO_RAD);
+    controller.setMinSlopeSlideAngle(movement.slopeSlideAngle * DEG_TO_RAD);
+    if (movement.autostep) {
+      controller.enableAutostep(movement.autostep.maxHeight, movement.autostep.minWidth, true);
+    } else {
+      controller.disableAutostep();
+    }
+    controller.enableSnapToGround(movement.snapToGroundDistance);
+    controller.setApplyImpulsesToDynamicBodies(true);
+    this.controllers.set(entity.uuid, controller);
+    return controller;
+  }
+  /**
+   * Handle jump logic with multi-jump, coyote time, buffering, and jump-cut
+   * ramp. All vertical motion is written to `state.verticalVelocity`.
+   */
+  handleJump(entity, delta) {
+    const input = entity.$platformer2D;
+    const movement = entity.platformer2D;
+    const state = entity.platformer2DState;
+    if (state.jumping || state.falling) {
+      state.timeSinceJump += delta;
+    }
+    if (!input.jump && state.jumpHeld) {
+      state.jumpReleasedSinceLastJump = true;
+    }
+    if (input.jump && !state.jumpPressedLastFrame) {
+      state.jumpBuffered = true;
+      state.jumpBufferTimer = movement.jumpBufferTime;
+    }
+    state.jumpPressedLastFrame = input.jump;
+    state.jumpHeld = input.jump;
+    if (state.jumpBuffered) {
+      state.jumpBufferTimer -= delta;
+      if (state.jumpBufferTimer <= 0) {
+        state.jumpBuffered = false;
+      }
+    }
+    const minTimeBeforeCut = 0.1;
+    const canApplyCut = state.timeSinceJump >= minTimeBeforeCut;
+    if (!input.jump && state.jumping && !state.jumpCutApplied && canApplyCut) {
+      state.jumpCutApplied = true;
+      state.jumpCutRampTimer = JUMP_CUT_RAMP_DURATION;
+    }
+    if (state.jumpCutRampTimer > 0) {
+      if (state.verticalVelocity > 0) {
+        const stepT = Math.min(delta / state.jumpCutRampTimer, 1);
+        const targetY = state.verticalVelocity * movement.jumpCutMultiplier;
+        state.verticalVelocity += (targetY - state.verticalVelocity) * stepT;
+      }
+      state.jumpCutRampTimer = Math.max(0, state.jumpCutRampTimer - delta);
+    }
+    if (!state.jumpBuffered) return;
+    const inCoyoteWindow = !state.grounded && state.timeSinceGrounded <= movement.coyoteTime;
+    const isFirstJump = state.grounded || inCoyoteWindow && state.jumpCount === 0;
+    const hasJumpsRemaining = state.jumpCount < movement.maxJumps;
+    const buttonReleased = state.jumpReleasedSinceLastJump;
+    const inMultiJumpWindow = state.timeSinceJump >= movement.multiJumpWindowTime;
+    const canMultiJump = !state.grounded && hasJumpsRemaining && buttonReleased && inMultiJumpWindow;
+    if (isFirstJump || canMultiJump) {
+      state.jumpBuffered = false;
+      state.jumpCount++;
+      state.jumpReleasedSinceLastJump = false;
+      state.timeSinceJump = 0;
+      state.jumpStartHeight = entity.body.translation().y;
+      state.jumping = true;
+      state.falling = false;
+      state.jumpCutApplied = false;
+      state.jumpCutRampTimer = 0;
+      state.verticalVelocity = movement.jumpForce;
+      state.jumpedThisFrame = true;
+    }
+  }
+  /**
+   * 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.
+   */
+  applyGravity(entity, delta) {
+    const movement = entity.platformer2D;
+    const state = entity.platformer2DState;
+    if (state.jumpedThisFrame) {
+      state.jumpedThisFrame = false;
+      return;
+    }
+    if (state.grounded) {
+      state.verticalVelocity = -GROUND_STICK_SPEED;
+      return;
+    }
+    state.verticalVelocity -= movement.gravity * delta;
+  }
+  /**
+   * Update entity state from the controller's grounded result.
+   */
+  updateState(entity, delta, computedGrounded) {
+    const state = entity.platformer2DState;
+    const wasGrounded = state.grounded;
+    const isAirborne = state.jumping || state.falling;
+    let isGrounded;
+    if (isAirborne) {
+      const canLand = state.falling && !state.jumping;
+      isGrounded = computedGrounded && canLand;
+    } else {
+      isGrounded = computedGrounded;
+    }
+    state.grounded = isGrounded;
+    if (state.grounded) {
+      state.timeSinceGrounded = 0;
+      state.lastGroundedY = entity.body.translation().y;
+    } else {
+      state.timeSinceGrounded += delta;
+    }
+    if (!wasGrounded && state.grounded) {
+      state.jumpCount = 0;
+      state.jumping = false;
+      state.falling = false;
+      state.jumpCutApplied = false;
+      state.jumpCutRampTimer = 0;
+      if (state.verticalVelocity < 0) {
+        state.verticalVelocity = 0;
+      }
+    }
+    if (state.verticalVelocity < FALL_VELOCITY_THRESHOLD && !state.grounded) {
+      if (state.jumping) {
+        state.jumping = false;
+        state.falling = true;
+      } else if (!state.jumping) {
+        state.falling = true;
+      }
+    }
+  }
+  /**
+   * Update one platformer entity. Invoked per linked entity by the
+   * Platformer2DBehaviorSystem adapter.
+   */
+  updateEntity(entity, delta) {
+    if (!entity.platformer2D || !entity.$platformer2D || !entity.platformer2DState) {
+      return;
+    }
+    const controller = this.ensurePhysicsConfigured(entity);
+    const collider = entity.collider;
+    if (!controller || !collider) return;
+    const input = entity.$platformer2D;
+    const movement = entity.platformer2D;
+    const state = entity.platformer2DState;
+    this.handleJump(entity, delta);
+    this.applyGravity(entity, delta);
+    const speed = input.run ? movement.runSpeed : movement.walkSpeed;
+    state.currentSpeed = speed;
+    _desired.x = input.moveX * speed * delta;
+    _desired.y = state.verticalVelocity * delta;
+    _desired.z = 0;
+    controller.computeColliderMovement(collider, _desired, QueryFilterFlags.EXCLUDE_SENSORS);
+    const corrected = controller.computedMovement();
+    if (_desired.y > 1e-9 && corrected.y < _desired.y * 0.5) {
+      state.verticalVelocity = 0;
+    }
+    const translation = entity.body.translation();
+    entity.body.setNextKinematicTranslation({
+      x: translation.x + corrected.x,
+      y: translation.y + corrected.y,
+      z: this.planeZ.get(entity.uuid) ?? translation.z
+    });
+    this.updateState(entity, delta, controller.computedGrounded());
+  }
+  destroy() {
+    const physicsWorld = this.world?.world;
+    if (physicsWorld) {
+      for (const controller of this.controllers.values()) {
+        physicsWorld.removeCharacterController(controller);
+      }
+    }
+    this.controllers.clear();
+    this.planeZ.clear();
+  }
+};
+
+// src/lib/behaviors/platformer-2d/platformer-2d.descriptor.ts
+var FSM_STATE_BY_INDEX = [
+  "idle" /* Idle */,
+  "walking" /* Walking */,
+  "running" /* Running */,
+  "jumping" /* Jumping */,
+  "falling" /* Falling */,
+  "landing" /* Landing */
+];
+var defaultOptions = {
+  walkSpeed: 8,
+  runSpeed: 14,
+  jumpForce: 12,
+  maxJumps: 1,
+  gravity: 20,
+  coyoteTime: 0.1,
+  jumpBufferTime: 0.1,
+  jumpCutMultiplier: 0.5,
+  slopeClimbAngle: 50,
+  slopeSlideAngle: 40,
+  autostep: { maxHeight: 0.25, minWidth: 0.05 },
+  snapToGroundDistance: 0.2,
+  characterOffset: 0.05
+};
+var PLATFORMER_2D_BEHAVIOR_KEY = /* @__PURE__ */ Symbol.for("zylem:behavior:platformer-2d");
+var Platformer2DBehaviorSystem = class {
+  constructor(world, wasmStage, getBehaviorLinks) {
+    this.wasmStage = wasmStage;
+    this.getBehaviorLinks = getBehaviorLinks;
+    this.movementSystem = new Platformer2DSystem(world);
+  }
+  wasmStage;
+  getBehaviorLinks;
+  movementSystem;
+  attachedRuntimeSlots = /* @__PURE__ */ new Set();
+  update(_ecs, delta) {
+    const links = this.getBehaviorLinks?.(PLATFORMER_2D_BEHAVIOR_KEY);
+    if (!links) return;
+    for (const link of links) {
+      const gameEntity = link.entity;
+      const platformerRef = link.ref;
+      const options = platformerRef.options;
+      if (!gameEntity.platformer2D) {
+        gameEntity.platformer2D = createPlatformer2DMovementComponent(options);
+      }
+      if (!gameEntity.$platformer2D) {
+        gameEntity.$platformer2D = createPlatformer2DInputComponent();
+      }
+      if (!gameEntity.platformer2DState) {
+        gameEntity.platformer2DState = createPlatformer2DStateComponent();
+      }
+      const handle = gameEntity.runtimeHandle ?? -1;
+      if (this.wasmStage && handle >= 0) {
+        this.ensureWasmAttached(handle, options);
+        platformerRef.__wasmStage = this.wasmStage;
+        platformerRef.__entity = gameEntity;
+        const input = gameEntity.$platformer2D;
+        if (input) {
+          this.wasmStage.writeInputAxes(handle, input.moveX ?? 0, 0);
+          this.wasmStage.writeInputButton(handle, STAGE_INPUT_BUTTON_JUMP, !!input.jump);
+          this.wasmStage.writeInputButton(handle, STAGE_INPUT_BUTTON_RUN, !!input.run);
+        }
+        continue;
+      }
+      if (!platformerRef.fsm) {
+        platformerRef.fsm = new Platformer2DFSM({
+          input: gameEntity.$platformer2D,
+          state: gameEntity.platformer2DState
+        });
+      }
+      platformerRef.fsm.update(gameEntity.$platformer2D, gameEntity.platformer2DState);
+      if (!gameEntity.body) continue;
+      this.movementSystem.updateEntity(gameEntity, delta);
+    }
+  }
+  ensureWasmAttached(handle, options) {
+    if (!this.wasmStage || this.attachedRuntimeSlots.has(handle)) return;
+    const autostep = options.autostep ?? defaultOptions.autostep;
+    this.wasmStage.attachPlatformer2D(handle, {
+      halfHeight: 0.9,
+      radius: 0.4,
+      walkSpeed: options.walkSpeed ?? defaultOptions.walkSpeed,
+      runSpeed: options.runSpeed ?? defaultOptions.runSpeed,
+      jumpForce: options.jumpForce ?? defaultOptions.jumpForce,
+      maxJumps: options.maxJumps ?? defaultOptions.maxJumps,
+      gravity: options.gravity ?? defaultOptions.gravity,
+      coyoteTime: options.coyoteTime ?? defaultOptions.coyoteTime,
+      jumpBufferTime: options.jumpBufferTime ?? defaultOptions.jumpBufferTime,
+      jumpCutMultiplier: options.jumpCutMultiplier ?? defaultOptions.jumpCutMultiplier,
+      slopeClimbAngle: options.slopeClimbAngle ?? defaultOptions.slopeClimbAngle,
+      slopeSlideAngle: options.slopeSlideAngle ?? defaultOptions.slopeSlideAngle,
+      autostepHeight: autostep ? autostep.maxHeight : 0,
+      autostepMinWidth: autostep ? autostep.minWidth : 0.05,
+      snapToGroundDistance: options.snapToGroundDistance ?? defaultOptions.snapToGroundDistance,
+      characterOffset: options.characterOffset ?? defaultOptions.characterOffset
+    });
+    this.attachedRuntimeSlots.add(handle);
+  }
+  destroy(_ecs) {
+    this.movementSystem.destroy();
+    this.attachedRuntimeSlots.clear();
+  }
+};
+var Platformer2DBehavior = defineBehavior({
+  name: "platformer-2d",
+  defaultOptions,
+  systemFactory: (ctx) => new Platformer2DBehaviorSystem(
+    ctx.world ?? null,
+    ctx.wasmStage ?? null,
+    ctx.getBehaviorLinks
+  ),
+  // On the wasm fast path the handle reads the runtime snapshot buffer
+  // (values are from the end of the previous step — one-frame lag); the TS
+  // FSM only backs the no-wasm fallback path.
+  createHandle: (ref) => ({
+    getState: () => {
+      const snapshot = readBehaviorSnapshot(ref);
+      if (snapshot) return FSM_STATE_BY_INDEX[snapshot.fsmState] ?? "idle" /* Idle */;
+      return ref.fsm?.getState() ?? "idle" /* Idle */;
+    },
+    isGrounded: () => readBehaviorSnapshot(ref)?.grounded ?? ref.fsm?.isGrounded() ?? false,
+    getJumpCount: () => readBehaviorSnapshot(ref)?.jumpCount ?? ref.fsm?.getJumpCount() ?? 0
+  })
+});
+
+export {
+  createPlatformer2DMovementComponent,
+  createPlatformer2DInputComponent,
+  createPlatformer2DStateComponent,
+  Platformer2DState,
+  Platformer2DEvent,
+  Platformer2DFSM,
+  Platformer2DSystem,
+  Platformer2DBehavior
+};
+//# sourceMappingURL=chunk-UIG7MWS2.js.map

package/dist/chunk-UIG7MWS2.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/lib/behaviors/platformer-2d/components.ts","../src/lib/behaviors/platformer-2d/platformer-2d-fsm.ts","../src/lib/behaviors/platformer-2d/platformer-2d.system.ts","../src/lib/behaviors/platformer-2d/platformer-2d.descriptor.ts"],"sourcesContent":["/**\n * Platformer 2D Components\n *\n * Components for 2D platformer movement on the X/Y plane: walking/running on\n * X, jumping with multi-jump support, and falling/landing states.\n */\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Platformer2DMovementComponent (capability / configuration)\n// ─────────────────────────────────────────────────────────────────────────────\n\nexport interface Platformer2DMovementComponent {\n\t/** Base walking speed */\n\twalkSpeed: number;\n\t/** Sprint/run speed */\n\trunSpeed: number;\n\t/** Initial jump force/velocity */\n\tjumpForce: number;\n\t/** Maximum number of jumps (1 = single jump, 2 = double jump, etc.) */\n\tmaxJumps: number;\n\t/** Gravity force */\n\tgravity: number;\n\t/** Coyote time in seconds (grace period after leaving ground) */\n\tcoyoteTime: number;\n\t/** Jump buffer time in seconds (queue jump input before landing) */\n\tjumpBufferTime: number;\n\t/** Velocity multiplier when releasing jump button early (0-1) */\n\tjumpCutMultiplier: number;\n\t/** Time in seconds before multi-jump becomes available (0 = after button release) */\n\tmultiJumpWindowTime: number;\n\t/** Maximum slope angle (degrees) the character can walk up */\n\tslopeClimbAngle: number;\n\t/** Slope angle (degrees) past which the character slides down */\n\tslopeSlideAngle: number;\n\t/** Autostep configuration for SNES-style step-ups, or false to disable */\n\tautostep: { maxHeight: number; minWidth: number } | false;\n\t/** Snap-to-ground distance (keeps the character glued going downhill) */\n\tsnapToGroundDistance: number;\n\t/** Character controller offset (small gap kept between collider and environment) */\n\tcharacterOffset: number;\n}\n\nexport function createPlatformer2DMovementComponent(\n\toptions: Partial<Platformer2DMovementComponent> = {},\n): Platformer2DMovementComponent {\n\treturn {\n\t\twalkSpeed: options.walkSpeed ?? 8,\n\t\trunSpeed: options.runSpeed ?? 14,\n\t\tjumpForce: options.jumpForce ?? 12,\n\t\tmaxJumps: options.maxJumps ?? 1,\n\t\tgravity: options.gravity ?? 20,\n\t\tcoyoteTime: options.coyoteTime ?? 0.1,\n\t\tjumpBufferTime: options.jumpBufferTime ?? 0.1,\n\t\tjumpCutMultiplier: options.jumpCutMultiplier ?? 0.5,\n\t\tmultiJumpWindowTime: options.multiJumpWindowTime ?? 0.15,\n\t\tslopeClimbAngle: options.slopeClimbAngle ?? 50,\n\t\tslopeSlideAngle: options.slopeSlideAngle ?? 40,\n\t\tautostep: options.autostep ?? { maxHeight: 0.25, minWidth: 0.05 },\n\t\tsnapToGroundDistance: options.snapToGroundDistance ?? 0.2,\n\t\tcharacterOffset: options.characterOffset ?? 0.05,\n\t};\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Platformer2DInputComponent (intent)\n// Written by: Player controller, AI controller\n// Read by: Platformer2DBehavior\n// ─────────────────────────────────────────────────────────────────────────────\n\nexport interface Platformer2DInputComponent {\n\t/** Horizontal movement input (-1 to 1) */\n\tmoveX: number;\n\t/** Jump button pressed */\n\tjump: boolean;\n\t/** Run/sprint button held */\n\trun: boolean;\n}\n\nexport function createPlatformer2DInputComponent(): Platformer2DInputComponent {\n\treturn {\n\t\tmoveX: 0,\n\t\tjump: false,\n\t\trun: false,\n\t};\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Platformer2DStateComponent (runtime state)\n// ─────────────────────────────────────────────────────────────────────────────\n\nexport interface Platformer2DStateComponent {\n\t/** Is the entity on the ground */\n\tgrounded: boolean;\n\t/** Is currently in a jump arc */\n\tjumping: boolean;\n\t/** Is falling (not jumping) */\n\tfalling: boolean;\n\t/** Current jump count (for multi-jump) */\n\tjumpCount: number;\n\t/** Y position when jump started */\n\tjumpStartHeight: number;\n\t/** Current movement speed being applied */\n\tcurrentSpeed: number;\n\t/** Last known ground Y position */\n\tlastGroundedY: number;\n\t/** Was jump button pressed last frame (for edge detection) */\n\tjumpPressedLastFrame: boolean;\n\t/** Time in seconds since last grounded */\n\ttimeSinceGrounded: number;\n\t/** Is a jump allowed due to buffer? */\n\tjumpBuffered: boolean;\n\t/** Time remaining in jump buffer */\n\tjumpBufferTimer: number;\n\t/** Is jump button currently held */\n\tjumpHeld: boolean;\n\t/** Has the jump cut been applied for this jump? */\n\tjumpCutApplied: boolean;\n\t/** Has jump button been released since last jump (required for multi-jump) */\n\tjumpReleasedSinceLastJump: boolean;\n\t/** Time since current jump started (for multi-jump window) */\n\ttimeSinceJump: number;\n\t/** True for the single frame on which a jump impulse was applied; prevents gravity from clobbering jump velocity. */\n\tjumpedThisFrame: boolean;\n\t/** Remaining seconds of jump-cut velocity ramp; while > 0, verticalVelocity lerps toward verticalVelocity * jumpCutMultiplier. */\n\tjumpCutRampTimer: number;\n\t/**\n\t * Controller-owned vertical velocity (units/second).\n\t * The body is kinematic, so `linvel()` is meaningless — this field is the\n\t * single source of truth for jump/gravity motion on the Y axis.\n\t */\n\tverticalVelocity: number;\n}\n\nexport function createPlatformer2DStateComponent(): Platformer2DStateComponent {\n\treturn {\n\t\tgrounded: false,\n\t\tjumping: false,\n\t\tfalling: false,\n\t\tjumpCount: 0,\n\t\tjumpStartHeight: 0,\n\t\tcurrentSpeed: 0,\n\t\tlastGroundedY: 0,\n\t\tjumpPressedLastFrame: false,\n\t\ttimeSinceGrounded: 0,\n\t\tjumpBuffered: false,\n\t\tjumpBufferTimer: 0,\n\t\tjumpHeld: false,\n\t\tjumpCutApplied: false,\n\t\tjumpReleasedSinceLastJump: true,\n\t\ttimeSinceJump: 0,\n\t\tjumpedThisFrame: false,\n\t\tjumpCutRampTimer: 0,\n\t\tverticalVelocity: 0,\n\t};\n}\n","/**\n * Platformer 2D Finite State Machine\n *\n * Manages state transitions for 2D platformer movement:\n * - Idle: Standing still on ground\n * - Walking: Moving on ground (slow)\n * - Running: Moving on ground (fast)\n * - Jumping: Ascending from jump\n * - Falling: Descending (gravity)\n * - Landing: Just touched ground\n */\n\nimport { SyncStateMachine, t } from '../../core/utility/sync-state-machine';\nimport type { Platformer2DInputComponent, Platformer2DStateComponent } from './components';\n\n/**\n * Simplified collision context (normal in the X/Y plane).\n */\nexport interface Platformer2DCollisionContext {\n\tcontact: {\n\t\tnormal: { x: number; y: number };\n\t};\n}\n\nexport enum Platformer2DState {\n\tIdle = 'idle',\n\tWalking = 'walking',\n\tRunning = 'running',\n\tJumping = 'jumping',\n\tFalling = 'falling',\n\tLanding = 'landing',\n}\n\nexport enum Platformer2DEvent {\n\tWalk = 'walk',\n\tRun = 'run',\n\tJump = 'jump',\n\tFall = 'fall',\n\tLand = 'land',\n\tStop = 'stop',\n}\n\nexport interface Platformer2DContext {\n\tinput: Platformer2DInputComponent;\n\tstate: Platformer2DStateComponent;\n}\n\nexport class Platformer2DFSM {\n\tmachine: SyncStateMachine<Platformer2DState, Platformer2DEvent, never>;\n\n\tconstructor(private ctx: Platformer2DContext) {\n\t\tthis.machine = new SyncStateMachine<Platformer2DState, Platformer2DEvent, never>(\n\t\t\tPlatformer2DState.Idle,\n\t\t\t[\n\t\t\t\t// Idle transitions\n\t\t\t\tt(Platformer2DState.Idle, Platformer2DEvent.Walk, Platformer2DState.Walking),\n\t\t\t\tt(Platformer2DState.Idle, Platformer2DEvent.Run, Platformer2DState.Running),\n\t\t\t\tt(Platformer2DState.Idle, Platformer2DEvent.Jump, Platformer2DState.Jumping),\n\t\t\t\tt(Platformer2DState.Idle, Platformer2DEvent.Fall, Platformer2DState.Falling),\n\n\t\t\t\t// Walking transitions\n\t\t\t\tt(Platformer2DState.Walking, Platformer2DEvent.Run, Platformer2DState.Running),\n\t\t\t\tt(Platformer2DState.Walking, Platformer2DEvent.Jump, Platformer2DState.Jumping),\n\t\t\t\tt(Platformer2DState.Walking, Platformer2DEvent.Stop, Platformer2DState.Idle),\n\t\t\t\tt(Platformer2DState.Walking, Platformer2DEvent.Fall, Platformer2DState.Falling),\n\n\t\t\t\t// Running transitions\n\t\t\t\tt(Platformer2DState.Running, Platformer2DEvent.Walk, Platformer2DState.Walking),\n\t\t\t\tt(Platformer2DState.Running, Platformer2DEvent.Jump, Platformer2DState.Jumping),\n\t\t\t\tt(Platformer2DState.Running, Platformer2DEvent.Stop, Platformer2DState.Idle),\n\t\t\t\tt(Platformer2DState.Running, Platformer2DEvent.Fall, Platformer2DState.Falling),\n\n\t\t\t\t// Jumping transitions\n\t\t\t\tt(Platformer2DState.Jumping, Platformer2DEvent.Fall, Platformer2DState.Falling),\n\t\t\t\tt(Platformer2DState.Jumping, Platformer2DEvent.Land, Platformer2DState.Landing),\n\t\t\t\tt(Platformer2DState.Jumping, Platformer2DEvent.Jump, Platformer2DState.Jumping), // Multi-jump\n\n\t\t\t\t// Falling transitions\n\t\t\t\tt(Platformer2DState.Falling, Platformer2DEvent.Land, Platformer2DState.Landing),\n\t\t\t\tt(Platformer2DState.Falling, Platformer2DEvent.Jump, Platformer2DState.Jumping), // Air jump\n\n\t\t\t\t// Landing transitions\n\t\t\t\tt(Platformer2DState.Landing, Platformer2DEvent.Walk, Platformer2DState.Walking),\n\t\t\t\tt(Platformer2DState.Landing, Platformer2DEvent.Run, Platformer2DState.Running),\n\t\t\t\tt(Platformer2DState.Landing, Platformer2DEvent.Stop, Platformer2DState.Idle),\n\n\t\t\t\t// Self-transitions (no-ops)\n\t\t\t\tt(Platformer2DState.Idle, Platformer2DEvent.Stop, Platformer2DState.Idle),\n\t\t\t],\n\t\t);\n\t}\n\n\tgetState(): Platformer2DState {\n\t\treturn this.machine.getState();\n\t}\n\n\tdispatch(event: Platformer2DEvent): void {\n\t\tif (this.machine.can(event)) {\n\t\t\tthis.machine.syncDispatch(event);\n\t\t}\n\t}\n\n\tisGrounded(): boolean {\n\t\tconst state = this.getState();\n\t\treturn (\n\t\t\tstate === Platformer2DState.Idle ||\n\t\t\tstate === Platformer2DState.Walking ||\n\t\t\tstate === Platformer2DState.Running ||\n\t\t\tstate === Platformer2DState.Landing\n\t\t);\n\t}\n\n\tgetJumpCount(): number {\n\t\treturn this.ctx.state.jumpCount;\n\t}\n\n\t/**\n\t * Update FSM based on current component state.\n\t */\n\tupdate(input: Platformer2DInputComponent, state: Platformer2DStateComponent): void {\n\t\tthis.ctx.input = input;\n\t\tthis.ctx.state = state;\n\n\t\tconst currentState = this.getState();\n\t\tconst hasInput = Math.abs(input.moveX) > 0.1;\n\t\tconst isRunning = input.run;\n\n\t\t// Handle landing: if we're in falling state and now grounded, land\n\t\tif (currentState === Platformer2DState.Falling && state.grounded) {\n\t\t\tthis.dispatch(Platformer2DEvent.Land);\n\t\t\t// Don't return - allow immediate transition to movement state\n\t\t}\n\n\t\tif (state.grounded) {\n\t\t\tif (hasInput) {\n\t\t\t\tif (isRunning) {\n\t\t\t\t\tthis.dispatch(Platformer2DEvent.Run);\n\t\t\t\t} else {\n\t\t\t\t\tthis.dispatch(Platformer2DEvent.Walk);\n\t\t\t\t}\n\t\t\t} else {\n\t\t\t\tthis.dispatch(Platformer2DEvent.Stop);\n\t\t\t}\n\t\t} else if (state.falling) {\n\t\t\tthis.dispatch(Platformer2DEvent.Fall);\n\t\t}\n\n\t\t// Handle jump input (edge detection handled in the system)\n\t\tif (input.jump && !state.jumpPressedLastFrame) {\n\t\t\tthis.dispatch(Platformer2DEvent.Jump);\n\t\t}\n\t}\n}\n","/**\n * Platformer 2D System\n *\n * Kinematic character controller (SNES-style) on the X/Y plane: the\n * controller owns all motion and physics is only a collision database.\n *\n * - The entity's body is converted to `KinematicPositionBased` on first\n *   update; Rapier never applies forces to it.\n * - Each tick, desired displacement (X input + integrated vertical velocity,\n *   z locked to 0) is run through Rapier's `KinematicCharacterController`\n *   (collide-and-slide with autostep, slope limits, and snap-to-ground) and\n *   the corrected movement is applied via `setNextKinematicTranslation`. The\n *   z coordinate is re-pinned to its first-seen value every tick so slide\n *   resolution can never drift the entity off the 2D plane.\n * - Grounded comes from `controller.computedGrounded()` — no contact-pair or\n *   raycast probing.\n * - Vertical velocity lives in `state.verticalVelocity` (`linvel()` is\n *   meaningless on kinematic bodies). Jump buffering, coyote time,\n *   multi-jump, and the jump-cut ramp all operate on that field.\n */\n\nimport { RigidBodyType, QueryFilterFlags } from '@dimforge/rapier3d-compat';\nimport type { Collider, KinematicCharacterController, RigidBody } from '@dimforge/rapier3d-compat';\nimport type { ZylemWorld } from '../../collision/world';\nimport type {\n\tPlatformer2DMovementComponent,\n\tPlatformer2DInputComponent,\n\tPlatformer2DStateComponent,\n} from './components';\n\n/**\n * Duration of the jump-cut velocity ramp in seconds.\n * Instead of cutting vertical velocity in a single frame (which produces a\n * visible pop), we lerp toward the cut velocity across roughly 3 physics\n * steps at 60 Hz.\n */\nconst JUMP_CUT_RAMP_DURATION = 0.05;\n\n/**\n * Constant downward speed applied while grounded (units/second). Keeps the\n * controller pressed into the ground so `computedGrounded()` stays engaged on\n * flat ground and going downhill (snap-to-ground handles larger drops).\n */\nconst GROUND_STICK_SPEED = 2;\n\n/** Vertical speed below which the airborne state flips from jumping to falling. */\nconst FALL_VELOCITY_THRESHOLD = -0.1;\n\nconst DEG_TO_RAD = Math.PI / 180;\n\n/**\n * Entity with 2D platformer components\n */\nexport interface Platformer2DEntity {\n\tuuid: string;\n\tbody: RigidBody;\n\tcollider?: Collider | null;\n\tplatformer2D: Platformer2DMovementComponent;\n\t$platformer2D: Platformer2DInputComponent;\n\tplatformer2DState: Platformer2DStateComponent;\n}\n\n/** Scratch vector reused for the desired per-tick displacement. */\nconst _desired = { x: 0, y: 0, z: 0 };\n\n/**\n * Platformer 2D movement system.\n *\n * Core kinematic controller for 2D platformer movement. Requires a live\n * `ZylemWorld` with the raw Rapier `World` exposed on `.world` — without it\n * the system is a no-op.\n */\nexport class Platformer2DSystem {\n\tprivate world: ZylemWorld | null;\n\t/** Per-entity character controllers, keyed by entity uuid. */\n\tprivate controllers = new Map<string, KinematicCharacterController>();\n\t/** Spawn-time z per entity; re-pinned every tick to hold the 2D plane. */\n\tprivate planeZ = new Map<string, number>();\n\n\tconstructor(world: ZylemWorld | null) {\n\t\tthis.world = world;\n\t}\n\n\t/**\n\t * One-time per-entity physics setup: convert the body to a\n\t * position-based kinematic body, record the plane z, and create the\n\t * entity's character controller. Done lazily on the first update because\n\t * the body isn't always available at construction time.\n\t */\n\tprivate ensurePhysicsConfigured(entity: Platformer2DEntity): KinematicCharacterController | null {\n\t\tconst existing = this.controllers.get(entity.uuid);\n\t\tif (existing) return existing;\n\n\t\tconst physicsWorld = this.world?.world;\n\t\tif (!physicsWorld || !entity.body) return null;\n\n\t\tif (entity.body.bodyType() !== RigidBodyType.KinematicPositionBased) {\n\t\t\tentity.body.setBodyType(RigidBodyType.KinematicPositionBased, true);\n\t\t}\n\t\tthis.planeZ.set(entity.uuid, entity.body.translation().z);\n\n\t\tconst movement = entity.platformer2D;\n\t\tconst controller = physicsWorld.createCharacterController(movement.characterOffset);\n\t\tcontroller.setUp({ x: 0, y: 1, z: 0 });\n\t\tcontroller.setMaxSlopeClimbAngle(movement.slopeClimbAngle * DEG_TO_RAD);\n\t\tcontroller.setMinSlopeSlideAngle(movement.slopeSlideAngle * DEG_TO_RAD);\n\t\tif (movement.autostep) {\n\t\t\tcontroller.enableAutostep(movement.autostep.maxHeight, movement.autostep.minWidth, true);\n\t\t} else {\n\t\t\tcontroller.disableAutostep();\n\t\t}\n\t\tcontroller.enableSnapToGround(movement.snapToGroundDistance);\n\t\tcontroller.setApplyImpulsesToDynamicBodies(true);\n\n\t\tthis.controllers.set(entity.uuid, controller);\n\t\treturn controller;\n\t}\n\n\t/**\n\t * Handle jump logic with multi-jump, coyote time, buffering, and jump-cut\n\t * ramp. All vertical motion is written to `state.verticalVelocity`.\n\t */\n\tprivate handleJump(entity: Platformer2DEntity, delta: number): void {\n\t\tconst input = entity.$platformer2D;\n\t\tconst movement = entity.platformer2D;\n\t\tconst state = entity.platformer2DState;\n\n\t\t// Track time since last jump (for multi-jump window)\n\t\tif (state.jumping || state.falling) {\n\t\t\tstate.timeSinceJump += delta;\n\t\t}\n\n\t\t// Track jump button release (required for multi-jump)\n\t\tif (!input.jump && state.jumpHeld) {\n\t\t\tstate.jumpReleasedSinceLastJump = true;\n\t\t}\n\n\t\t// 1. Jump Buffering - queue on new press\n\t\tif (input.jump && !state.jumpPressedLastFrame) {\n\t\t\tstate.jumpBuffered = true;\n\t\t\tstate.jumpBufferTimer = movement.jumpBufferTime;\n\t\t}\n\n\t\tstate.jumpPressedLastFrame = input.jump;\n\t\tstate.jumpHeld = input.jump;\n\n\t\t// Decrement buffer timer\n\t\tif (state.jumpBuffered) {\n\t\t\tstate.jumpBufferTimer -= delta;\n\t\t\tif (state.jumpBufferTimer <= 0) {\n\t\t\t\tstate.jumpBuffered = false;\n\t\t\t}\n\t\t}\n\n\t\t// 2. Variable Jump Height (Jump Cut)\n\t\t// Only trigger a cut if we've been jumping for a bit (prevents cutting multi-jump immediately).\n\t\tconst minTimeBeforeCut = 0.1;\n\t\tconst canApplyCut = state.timeSinceJump >= minTimeBeforeCut;\n\t\tif (!input.jump && state.jumping && !state.jumpCutApplied && canApplyCut) {\n\t\t\tstate.jumpCutApplied = true;\n\t\t\tstate.jumpCutRampTimer = JUMP_CUT_RAMP_DURATION;\n\t\t}\n\n\t\t// 2a. Ramp verticalVelocity toward verticalVelocity * jumpCutMultiplier\n\t\t// across the ramp window so the change isn't a single-frame discontinuity.\n\t\tif (state.jumpCutRampTimer > 0) {\n\t\t\tif (state.verticalVelocity > 0) {\n\t\t\t\tconst stepT = Math.min(delta / state.jumpCutRampTimer, 1);\n\t\t\t\tconst targetY = state.verticalVelocity * movement.jumpCutMultiplier;\n\t\t\t\tstate.verticalVelocity += (targetY - state.verticalVelocity) * stepT;\n\t\t\t}\n\t\t\tstate.jumpCutRampTimer = Math.max(0, state.jumpCutRampTimer - delta);\n\t\t}\n\n\t\t// Execute Jump (if buffered input exists)\n\t\tif (!state.jumpBuffered) return;\n\n\t\t// 3. Jump eligibility check\n\t\tconst inCoyoteWindow = !state.grounded && state.timeSinceGrounded <= movement.coyoteTime;\n\t\tconst isFirstJump = state.grounded || (inCoyoteWindow && state.jumpCount === 0);\n\n\t\t// Multi-jump requirements:\n\t\t// 1. Not grounded\n\t\t// 2. Have jumps remaining\n\t\t// 3. Button was released since last jump (no holding for double jump)\n\t\t// 4. Within the jump window (after multiJumpWindowTime has passed)\n\t\tconst hasJumpsRemaining = state.jumpCount < movement.maxJumps;\n\t\tconst buttonReleased = state.jumpReleasedSinceLastJump;\n\t\tconst inMultiJumpWindow = state.timeSinceJump >= movement.multiJumpWindowTime;\n\t\tconst canMultiJump = !state.grounded && hasJumpsRemaining && buttonReleased && inMultiJumpWindow;\n\n\t\tif (isFirstJump || canMultiJump) {\n\t\t\t// Consume buffered input\n\t\t\tstate.jumpBuffered = false;\n\n\t\t\t// Increment jump count and reset tracking\n\t\t\tstate.jumpCount++;\n\t\t\tstate.jumpReleasedSinceLastJump = false; // Must release again for next jump\n\t\t\tstate.timeSinceJump = 0; // Reset window timer\n\n\t\t\t// Record jump start height\n\t\t\tstate.jumpStartHeight = entity.body.translation().y;\n\n\t\t\t// Apply jump force\n\t\t\tstate.jumping = true;\n\t\t\tstate.falling = false;\n\t\t\tstate.jumpCutApplied = false;\n\t\t\tstate.jumpCutRampTimer = 0;\n\n\t\t\tstate.verticalVelocity = movement.jumpForce;\n\n\t\t\t// Flag this frame so applyGravity skips exactly one grounded\n\t\t\t// clamp/gravity step (the jump velocity is authoritative).\n\t\t\tstate.jumpedThisFrame = true;\n\t\t}\n\t}\n\n\t/**\n\t * Integrate gravity into `state.verticalVelocity`.\n\t *\n\t * While grounded (and not on the jump frame) vertical velocity is held at\n\t * a small constant downward speed so the controller stays pressed into\n\t * the ground. Skipped entirely on the frame a jump was applied — the\n\t * grounded flag is still stale-true then and would clobber the jump.\n\t */\n\tprivate applyGravity(entity: Platformer2DEntity, delta: number): void {\n\t\tconst movement = entity.platformer2D;\n\t\tconst state = entity.platformer2DState;\n\n\t\tif (state.jumpedThisFrame) {\n\t\t\tstate.jumpedThisFrame = false;\n\t\t\treturn;\n\t\t}\n\n\t\tif (state.grounded) {\n\t\t\tstate.verticalVelocity = -GROUND_STICK_SPEED;\n\t\t\treturn;\n\t\t}\n\n\t\tstate.verticalVelocity -= movement.gravity * delta;\n\t}\n\n\t/**\n\t * Update entity state from the controller's grounded result.\n\t */\n\tprivate updateState(entity: Platformer2DEntity, delta: number, computedGrounded: boolean): void {\n\t\tconst state = entity.platformer2DState;\n\t\tconst wasGrounded = state.grounded;\n\n\t\tconst isAirborne = state.jumping || state.falling;\n\t\tlet isGrounded: boolean;\n\t\tif (isAirborne) {\n\t\t\t// Never land while still moving upward in a jump arc.\n\t\t\tconst canLand = state.falling && !state.jumping;\n\t\t\tisGrounded = computedGrounded && canLand;\n\t\t} else {\n\t\t\tisGrounded = computedGrounded;\n\t\t}\n\n\t\tstate.grounded = isGrounded;\n\n\t\tif (state.grounded) {\n\t\t\tstate.timeSinceGrounded = 0;\n\t\t\tstate.lastGroundedY = entity.body.translation().y;\n\t\t} else {\n\t\t\tstate.timeSinceGrounded += delta;\n\t\t}\n\n\t\tif (!wasGrounded && state.grounded) {\n\t\t\tstate.jumpCount = 0;\n\t\t\tstate.jumping = false;\n\t\t\tstate.falling = false;\n\t\t\tstate.jumpCutApplied = false;\n\t\t\tstate.jumpCutRampTimer = 0;\n\t\t\tif (state.verticalVelocity < 0) {\n\t\t\t\tstate.verticalVelocity = 0;\n\t\t\t}\n\t\t}\n\n\t\tif (state.verticalVelocity < FALL_VELOCITY_THRESHOLD && !state.grounded) {\n\t\t\tif (state.jumping) {\n\t\t\t\tstate.jumping = false;\n\t\t\t\tstate.falling = true;\n\t\t\t} else if (!state.jumping) {\n\t\t\t\tstate.falling = true;\n\t\t\t}\n\t\t}\n\t}\n\n\t/**\n\t * Update one platformer entity. Invoked per linked entity by the\n\t * Platformer2DBehaviorSystem adapter.\n\t */\n\tupdateEntity(entity: Platformer2DEntity, delta: number): void {\n\t\tif (!entity.platformer2D || !entity.$platformer2D || !entity.platformer2DState) {\n\t\t\treturn;\n\t\t}\n\n\t\tconst controller = this.ensurePhysicsConfigured(entity);\n\t\tconst collider = entity.collider;\n\t\tif (!controller || !collider) return;\n\n\t\tconst input = entity.$platformer2D;\n\t\tconst movement = entity.platformer2D;\n\t\tconst state = entity.platformer2DState;\n\n\t\t// 1. Jump logic (may set verticalVelocity = jumpForce this frame)\n\t\tthis.handleJump(entity, delta);\n\n\t\t// 2. Gravity / grounded stick on verticalVelocity\n\t\tthis.applyGravity(entity, delta);\n\n\t\t// 3. Desired displacement for this tick (z locked to the plane)\n\t\tconst speed = input.run ? movement.runSpeed : movement.walkSpeed;\n\t\tstate.currentSpeed = speed;\n\t\t_desired.x = input.moveX * speed * delta;\n\t\t_desired.y = state.verticalVelocity * delta;\n\t\t_desired.z = 0;\n\n\t\t// 4. Collide-and-slide\n\t\tcontroller.computeColliderMovement(collider, _desired, QueryFilterFlags.EXCLUDE_SENSORS);\n\t\tconst corrected = controller.computedMovement();\n\n\t\t// Head bump: upward motion was blocked, so kill the remaining ascent\n\t\t// instead of hanging under the ceiling for the rest of the arc.\n\t\tif (_desired.y > 1e-9 && corrected.y < _desired.y * 0.5) {\n\t\t\tstate.verticalVelocity = 0;\n\t\t}\n\n\t\tconst translation = entity.body.translation();\n\t\tentity.body.setNextKinematicTranslation({\n\t\t\tx: translation.x + corrected.x,\n\t\t\ty: translation.y + corrected.y,\n\t\t\tz: this.planeZ.get(entity.uuid) ?? translation.z,\n\t\t});\n\n\t\t// 5. State transitions from the controller's grounded result\n\t\tthis.updateState(entity, delta, controller.computedGrounded());\n\t}\n\n\tdestroy(): void {\n\t\tconst physicsWorld = this.world?.world;\n\t\tif (physicsWorld) {\n\t\t\tfor (const controller of this.controllers.values()) {\n\t\t\t\tphysicsWorld.removeCharacterController(controller);\n\t\t\t}\n\t\t}\n\t\tthis.controllers.clear();\n\t\tthis.planeZ.clear();\n\t}\n}\n","/**\n * Platformer 2D Behavior Descriptor\n *\n * Type-safe descriptor for the platformer 2D behavior system.\n * Provides entity.use() API for 2D platformer movement on the X/Y plane.\n */\n\nimport { defineBehavior } from '../behavior-descriptor';\nimport type { BehaviorEntityLink, BehaviorSystem } from '../behavior-system';\nimport { Platformer2DSystem, Platformer2DEntity } from './platformer-2d.system';\nimport type { ZylemWorld } from '../../collision/world';\nimport { Platformer2DFSM, Platformer2DState } from './platformer-2d-fsm';\nimport {\n\tcreatePlatformer2DMovementComponent,\n\tcreatePlatformer2DInputComponent,\n\tcreatePlatformer2DStateComponent,\n} from './components';\nimport {\n\tSTAGE_INPUT_BUTTON_JUMP,\n\tSTAGE_INPUT_BUTTON_RUN,\n\treadBehaviorSnapshot,\n\ttype WasmStageRuntime,\n} from '../../runtime/wasm-stage-runtime';\n\n/** Rust FSM index → TS state (shared `platformer_3d/fsm.rs` ordering). */\nconst FSM_STATE_BY_INDEX: readonly Platformer2DState[] = [\n\tPlatformer2DState.Idle,\n\tPlatformer2DState.Walking,\n\tPlatformer2DState.Running,\n\tPlatformer2DState.Jumping,\n\tPlatformer2DState.Falling,\n\tPlatformer2DState.Landing,\n];\n\n/**\n * Platformer 2D behavior options (typed for entity.use() autocomplete)\n */\nexport interface Platformer2DBehaviorOptions {\n\t/** Base walking speed (default: 8) */\n\twalkSpeed?: number;\n\t/** Sprint/run speed (default: 14) */\n\trunSpeed?: number;\n\t/** Initial jump force (default: 12) */\n\tjumpForce?: number;\n\t/** Maximum number of jumps (default: 1) */\n\tmaxJumps?: number;\n\t/** Gravity force (default: 20) */\n\tgravity?: number;\n\t/** Coyote time in seconds (default: 0.1) */\n\tcoyoteTime?: number;\n\t/** Jump buffer time in seconds (default: 0.1) */\n\tjumpBufferTime?: number;\n\t/** Velocity multiplier when releasing jump early (default: 0.5) */\n\tjumpCutMultiplier?: number;\n\t/** Maximum slope angle in degrees the character can walk up (default: 50) */\n\tslopeClimbAngle?: number;\n\t/** Slope angle in degrees past which the character slides (default: 40) */\n\tslopeSlideAngle?: number;\n\t/** Autostep over small step-ups, or false to disable (default: { maxHeight: 0.25, minWidth: 0.05 }) */\n\tautostep?: { maxHeight: number; minWidth: number } | false;\n\t/** Snap-to-ground distance for downhill/step-down stability (default: 0.2) */\n\tsnapToGroundDistance?: number;\n\t/** Character controller collision offset (default: 0.05) */\n\tcharacterOffset?: number;\n}\n\nconst defaultOptions: Platformer2DBehaviorOptions = {\n\twalkSpeed: 8,\n\trunSpeed: 14,\n\tjumpForce: 12,\n\tmaxJumps: 1,\n\tgravity: 20,\n\tcoyoteTime: 0.1,\n\tjumpBufferTime: 0.1,\n\tjumpCutMultiplier: 0.5,\n\tslopeClimbAngle: 50,\n\tslopeSlideAngle: 40,\n\tautostep: { maxHeight: 0.25, minWidth: 0.05 },\n\tsnapToGroundDistance: 0.2,\n\tcharacterOffset: 0.05,\n};\n\nconst PLATFORMER_2D_BEHAVIOR_KEY = Symbol.for('zylem:behavior:platformer-2d');\n\n/**\n * Adapter that wraps Platformer2DSystem as a BehaviorSystem.\n *\n * Mirrors the platformer-3d pattern for the wasm fast path: entities with a\n * `runtimeHandle` are attached once to the Stage runtime, receive input via\n * the stage setters each frame, and skip the TS `updateEntity` path.\n */\nclass Platformer2DBehaviorSystem implements BehaviorSystem {\n\tprivate movementSystem: Platformer2DSystem;\n\tprivate attachedRuntimeSlots = new Set<number>();\n\n\tconstructor(\n\t\tworld: ZylemWorld | null,\n\t\tprivate wasmStage: WasmStageRuntime | null,\n\t\tprivate getBehaviorLinks?: (key: symbol) => Iterable<BehaviorEntityLink>,\n\t) {\n\t\tthis.movementSystem = new Platformer2DSystem(world);\n\t}\n\n\tupdate(_ecs: unknown, delta: number): void {\n\t\tconst links = this.getBehaviorLinks?.(PLATFORMER_2D_BEHAVIOR_KEY);\n\t\tif (!links) return;\n\n\t\tfor (const link of links) {\n\t\t\tconst gameEntity = link.entity as any;\n\t\t\tconst platformerRef = link.ref as any;\n\n\t\t\tconst options = platformerRef.options as Platformer2DBehaviorOptions;\n\n\t\t\tif (!gameEntity.platformer2D) {\n\t\t\t\tgameEntity.platformer2D = createPlatformer2DMovementComponent(options);\n\t\t\t}\n\t\t\tif (!gameEntity.$platformer2D) {\n\t\t\t\tgameEntity.$platformer2D = createPlatformer2DInputComponent();\n\t\t\t}\n\t\t\tif (!gameEntity.platformer2DState) {\n\t\t\t\tgameEntity.platformer2DState = createPlatformer2DStateComponent();\n\t\t\t}\n\n\t\t\t// Wasm fast path: forward input into the batched buffer and let\n\t\t\t// handles read the Rust FSM via the snapshot buffer — the TS FSM\n\t\t\t// is never created (single source of truth in the runtime).\n\t\t\tconst handle = (gameEntity.runtimeHandle ?? -1) as number;\n\t\t\tif (this.wasmStage && handle >= 0) {\n\t\t\t\tthis.ensureWasmAttached(handle, options);\n\t\t\t\tplatformerRef.__wasmStage = this.wasmStage;\n\t\t\t\tplatformerRef.__entity = gameEntity;\n\t\t\t\tconst input = gameEntity.$platformer2D;\n\t\t\t\tif (input) {\n\t\t\t\t\tthis.wasmStage.writeInputAxes(handle, input.moveX ?? 0, 0);\n\t\t\t\t\tthis.wasmStage.writeInputButton(handle, STAGE_INPUT_BUTTON_JUMP, !!input.jump);\n\t\t\t\t\tthis.wasmStage.writeInputButton(handle, STAGE_INPUT_BUTTON_RUN, !!input.run);\n\t\t\t\t}\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tif (!platformerRef.fsm) {\n\t\t\t\tplatformerRef.fsm = new Platformer2DFSM({\n\t\t\t\t\tinput: gameEntity.$platformer2D,\n\t\t\t\t\tstate: gameEntity.platformer2DState,\n\t\t\t\t});\n\t\t\t}\n\t\t\tplatformerRef.fsm.update(gameEntity.$platformer2D, gameEntity.platformer2DState);\n\n\t\t\tif (!gameEntity.body) continue;\n\t\t\tthis.movementSystem.updateEntity(gameEntity, delta);\n\t\t}\n\t}\n\n\tprivate ensureWasmAttached(handle: number, options: Platformer2DBehaviorOptions): void {\n\t\tif (!this.wasmStage || this.attachedRuntimeSlots.has(handle)) return;\n\t\tconst autostep = options.autostep ?? defaultOptions.autostep!;\n\t\tthis.wasmStage.attachPlatformer2D(handle, {\n\t\t\thalfHeight: 0.9,\n\t\t\tradius: 0.4,\n\t\t\twalkSpeed: options.walkSpeed ?? defaultOptions.walkSpeed!,\n\t\t\trunSpeed: options.runSpeed ?? defaultOptions.runSpeed!,\n\t\t\tjumpForce: options.jumpForce ?? defaultOptions.jumpForce!,\n\t\t\tmaxJumps: options.maxJumps ?? defaultOptions.maxJumps!,\n\t\t\tgravity: options.gravity ?? defaultOptions.gravity!,\n\t\t\tcoyoteTime: options.coyoteTime ?? defaultOptions.coyoteTime!,\n\t\t\tjumpBufferTime: options.jumpBufferTime ?? defaultOptions.jumpBufferTime!,\n\t\t\tjumpCutMultiplier: options.jumpCutMultiplier ?? defaultOptions.jumpCutMultiplier!,\n\t\t\tslopeClimbAngle: options.slopeClimbAngle ?? defaultOptions.slopeClimbAngle!,\n\t\t\tslopeSlideAngle: options.slopeSlideAngle ?? defaultOptions.slopeSlideAngle!,\n\t\t\tautostepHeight: autostep ? autostep.maxHeight : 0,\n\t\t\tautostepMinWidth: autostep ? autostep.minWidth : 0.05,\n\t\t\tsnapToGroundDistance: options.snapToGroundDistance ?? defaultOptions.snapToGroundDistance!,\n\t\t\tcharacterOffset: options.characterOffset ?? defaultOptions.characterOffset!,\n\t\t});\n\t\tthis.attachedRuntimeSlots.add(handle);\n\t}\n\n\tdestroy(_ecs: unknown): void {\n\t\tthis.movementSystem.destroy();\n\t\tthis.attachedRuntimeSlots.clear();\n\t}\n}\n\n/**\n * Platformer2DBehavior - typed descriptor for 2D platformer movement\n *\n * Provides complete 2D platformer physics on the X/Y plane including:\n * - Walking and running on X\n * - Jumping with buffer, coyote time, multi-jump, and jump-cut\n * - Gravity ownership and falling\n * - Kinematic character controller (collide-and-slide, autostep, snap-to-ground)\n *\n * @example\n * ```typescript\n * import { Platformer2DBehavior } from \"@zylem/behaviors/platformer-2d\";\n *\n * const platformer = player.use(Platformer2DBehavior, {\n *   walkSpeed: 8,\n *   runSpeed: 14,\n *   jumpForce: 12,\n *   maxJumps: 2, // Double jump!\n * });\n *\n * // In update loop\n * player.onUpdate(({ inputs }) => {\n *   player.$platformer2D.moveX = inputs.p1.axes.Horizontal.value;\n *   player.$platformer2D.jump = inputs.p1.buttons.A.held > 0;\n *   player.$platformer2D.run = inputs.p1.shoulders.LTrigger.held > 0;\n *\n *   const state = platformer.getState();\n *   const grounded = platformer.isGrounded();\n * });\n * ```\n */\nexport const Platformer2DBehavior = defineBehavior<\n\tPlatformer2DBehaviorOptions,\n\t{\n\t\tgetState: () => Platformer2DState;\n\t\tisGrounded: () => boolean;\n\t\tgetJumpCount: () => number;\n\t},\n\tPlatformer2DEntity\n>({\n\tname: 'platformer-2d',\n\tdefaultOptions,\n\tsystemFactory: (ctx) =>\n\t\tnew Platformer2DBehaviorSystem(\n\t\t\tctx.world ?? null,\n\t\t\tctx.wasmStage ?? null,\n\t\t\tctx.getBehaviorLinks,\n\t\t),\n\t// On the wasm fast path the handle reads the runtime snapshot buffer\n\t// (values are from the end of the previous step — one-frame lag); the TS\n\t// FSM only backs the no-wasm fallback path.\n\tcreateHandle: (ref) => ({\n\t\tgetState: () => {\n\t\t\tconst snapshot = readBehaviorSnapshot(ref);\n\t\t\tif (snapshot) return FSM_STATE_BY_INDEX[snapshot.fsmState] ?? Platformer2DState.Idle;\n\t\t\treturn ref.fsm?.getState() ?? Platformer2DState.Idle;\n\t\t},\n\t\tisGrounded: () =>\n\t\t\treadBehaviorSnapshot(ref)?.grounded ?? ref.fsm?.isGrounded() ?? false,\n\t\tgetJumpCount: () =>\n\t\t\treadBehaviorSnapshot(ref)?.jumpCount ?? ref.fsm?.getJumpCount() ?? 0,\n\t}),\n});\n"],"mappings":";;;;;;;;;;;;;;AA0CO,SAAS,oCACf,UAAkD,CAAC,GACnB;AAChC,SAAO;AAAA,IACN,WAAW,QAAQ,aAAa;AAAA,IAChC,UAAU,QAAQ,YAAY;AAAA,IAC9B,WAAW,QAAQ,aAAa;AAAA,IAChC,UAAU,QAAQ,YAAY;AAAA,IAC9B,SAAS,QAAQ,WAAW;AAAA,IAC5B,YAAY,QAAQ,cAAc;AAAA,IAClC,gBAAgB,QAAQ,kBAAkB;AAAA,IAC1C,mBAAmB,QAAQ,qBAAqB;AAAA,IAChD,qBAAqB,QAAQ,uBAAuB;AAAA,IACpD,iBAAiB,QAAQ,mBAAmB;AAAA,IAC5C,iBAAiB,QAAQ,mBAAmB;AAAA,IAC5C,UAAU,QAAQ,YAAY,EAAE,WAAW,MAAM,UAAU,KAAK;AAAA,IAChE,sBAAsB,QAAQ,wBAAwB;AAAA,IACtD,iBAAiB,QAAQ,mBAAmB;AAAA,EAC7C;AACD;AAiBO,SAAS,mCAA+D;AAC9E,SAAO;AAAA,IACN,OAAO;AAAA,IACP,MAAM;AAAA,IACN,KAAK;AAAA,EACN;AACD;AAiDO,SAAS,mCAA+D;AAC9E,SAAO;AAAA,IACN,UAAU;AAAA,IACV,SAAS;AAAA,IACT,SAAS;AAAA,IACT,WAAW;AAAA,IACX,iBAAiB;AAAA,IACjB,cAAc;AAAA,IACd,eAAe;AAAA,IACf,sBAAsB;AAAA,IACtB,mBAAmB;AAAA,IACnB,cAAc;AAAA,IACd,iBAAiB;AAAA,IACjB,UAAU;AAAA,IACV,gBAAgB;AAAA,IAChB,2BAA2B;AAAA,IAC3B,eAAe;AAAA,IACf,iBAAiB;AAAA,IACjB,kBAAkB;AAAA,IAClB,kBAAkB;AAAA,EACnB;AACD;;;AClIO,IAAK,oBAAL,kBAAKA,uBAAL;AACN,EAAAA,mBAAA,UAAO;AACP,EAAAA,mBAAA,aAAU;AACV,EAAAA,mBAAA,aAAU;AACV,EAAAA,mBAAA,aAAU;AACV,EAAAA,mBAAA,aAAU;AACV,EAAAA,mBAAA,aAAU;AANC,SAAAA;AAAA,GAAA;AASL,IAAK,oBAAL,kBAAKC,uBAAL;AACN,EAAAA,mBAAA,UAAO;AACP,EAAAA,mBAAA,SAAM;AACN,EAAAA,mBAAA,UAAO;AACP,EAAAA,mBAAA,UAAO;AACP,EAAAA,mBAAA,UAAO;AACP,EAAAA,mBAAA,UAAO;AANI,SAAAA;AAAA,GAAA;AAcL,IAAM,kBAAN,MAAsB;AAAA,EAG5B,YAAoB,KAA0B;AAA1B;AACnB,SAAK,UAAU,IAAI;AAAA,MAClB;AAAA,MACA;AAAA;AAAA,QAEC,EAAE,mBAAwB,mBAAwB,uBAAyB;AAAA,QAC3E,EAAE,mBAAwB,iBAAuB,uBAAyB;AAAA,QAC1E,EAAE,mBAAwB,mBAAwB,uBAAyB;AAAA,QAC3E,EAAE,mBAAwB,mBAAwB,uBAAyB;AAAA;AAAA,QAG3E,EAAE,yBAA2B,iBAAuB,uBAAyB;AAAA,QAC7E,EAAE,yBAA2B,mBAAwB,uBAAyB;AAAA,QAC9E,EAAE,yBAA2B,mBAAwB,iBAAsB;AAAA,QAC3E,EAAE,yBAA2B,mBAAwB,uBAAyB;AAAA;AAAA,QAG9E,EAAE,yBAA2B,mBAAwB,uBAAyB;AAAA,QAC9E,EAAE,yBAA2B,mBAAwB,uBAAyB;AAAA,QAC9E,EAAE,yBAA2B,mBAAwB,iBAAsB;AAAA,QAC3E,EAAE,yBAA2B,mBAAwB,uBAAyB;AAAA;AAAA,QAG9E,EAAE,yBAA2B,mBAAwB,uBAAyB;AAAA,QAC9E,EAAE,yBAA2B,mBAAwB,uBAAyB;AAAA,QAC9E,EAAE,yBAA2B,mBAAwB,uBAAyB;AAAA;AAAA;AAAA,QAG9E,EAAE,yBAA2B,mBAAwB,uBAAyB;AAAA,QAC9E,EAAE,yBAA2B,mBAAwB,uBAAyB;AAAA;AAAA;AAAA,QAG9E,EAAE,yBAA2B,mBAAwB,uBAAyB;AAAA,QAC9E,EAAE,yBAA2B,iBAAuB,uBAAyB;AAAA,QAC7E,EAAE,yBAA2B,mBAAwB,iBAAsB;AAAA;AAAA,QAG3E,EAAE,mBAAwB,mBAAwB,iBAAsB;AAAA,MACzE;AAAA,IACD;AAAA,EACD;AAAA,EAxCoB;AAAA,EAFpB;AAAA,EA4CA,WAA8B;AAC7B,WAAO,KAAK,QAAQ,SAAS;AAAA,EAC9B;AAAA,EAEA,SAAS,OAAgC;AACxC,QAAI,KAAK,QAAQ,IAAI,KAAK,GAAG;AAC5B,WAAK,QAAQ,aAAa,KAAK;AAAA,IAChC;AAAA,EACD;AAAA,EAEA,aAAsB;AACrB,UAAM,QAAQ,KAAK,SAAS;AAC5B,WACC,UAAU,qBACV,UAAU,2BACV,UAAU,2BACV,UAAU;AAAA,EAEZ;AAAA,EAEA,eAAuB;AACtB,WAAO,KAAK,IAAI,MAAM;AAAA,EACvB;AAAA;AAAA;AAAA;AAAA,EAKA,OAAO,OAAmC,OAAyC;AAClF,SAAK,IAAI,QAAQ;AACjB,SAAK,IAAI,QAAQ;AAEjB,UAAM,eAAe,KAAK,SAAS;AACnC,UAAM,WAAW,KAAK,IAAI,MAAM,KAAK,IAAI;AACzC,UAAM,YAAY,MAAM;AAGxB,QAAI,iBAAiB,2BAA6B,MAAM,UAAU;AACjE,WAAK,SAAS,iBAAsB;AAAA,IAErC;AAEA,QAAI,MAAM,UAAU;AACnB,UAAI,UAAU;AACb,YAAI,WAAW;AACd,eAAK,SAAS,eAAqB;AAAA,QACpC,OAAO;AACN,eAAK,SAAS,iBAAsB;AAAA,QACrC;AAAA,MACD,OAAO;AACN,aAAK,SAAS,iBAAsB;AAAA,MACrC;AAAA,IACD,WAAW,MAAM,SAAS;AACzB,WAAK,SAAS,iBAAsB;AAAA,IACrC;AAGA,QAAI,MAAM,QAAQ,CAAC,MAAM,sBAAsB;AAC9C,WAAK,SAAS,iBAAsB;AAAA,IACrC;AAAA,EACD;AACD;;;ACnIA,SAAS,eAAe,wBAAwB;AAehD,IAAM,yBAAyB;AAO/B,IAAM,qBAAqB;AAG3B,IAAM,0BAA0B;AAEhC,IAAM,aAAa,KAAK,KAAK;AAe7B,IAAM,WAAW,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,EAAE;AAS7B,IAAM,qBAAN,MAAyB;AAAA,EACvB;AAAA;AAAA,EAEA,cAAc,oBAAI,IAA0C;AAAA;AAAA,EAE5D,SAAS,oBAAI,IAAoB;AAAA,EAEzC,YAAY,OAA0B;AACrC,SAAK,QAAQ;AAAA,EACd;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQQ,wBAAwB,QAAiE;AAChG,UAAM,WAAW,KAAK,YAAY,IAAI,OAAO,IAAI;AACjD,QAAI,SAAU,QAAO;AAErB,UAAM,eAAe,KAAK,OAAO;AACjC,QAAI,CAAC,gBAAgB,CAAC,OAAO,KAAM,QAAO;AAE1C,QAAI,OAAO,KAAK,SAAS,MAAM,cAAc,wBAAwB;AACpE,aAAO,KAAK,YAAY,cAAc,wBAAwB,IAAI;AAAA,IACnE;AACA,SAAK,OAAO,IAAI,OAAO,MAAM,OAAO,KAAK,YAAY,EAAE,CAAC;AAExD,UAAM,WAAW,OAAO;AACxB,UAAM,aAAa,aAAa,0BAA0B,SAAS,eAAe;AAClF,eAAW,MAAM,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,EAAE,CAAC;AACrC,eAAW,sBAAsB,SAAS,kBAAkB,UAAU;AACtE,eAAW,sBAAsB,SAAS,kBAAkB,UAAU;AACtE,QAAI,SAAS,UAAU;AACtB,iBAAW,eAAe,SAAS,SAAS,WAAW,SAAS,SAAS,UAAU,IAAI;AAAA,IACxF,OAAO;AACN,iBAAW,gBAAgB;AAAA,IAC5B;AACA,eAAW,mBAAmB,SAAS,oBAAoB;AAC3D,eAAW,gCAAgC,IAAI;AAE/C,SAAK,YAAY,IAAI,OAAO,MAAM,UAAU;AAC5C,WAAO;AAAA,EACR;AAAA;AAAA;AAAA;AAAA;AAAA,EAMQ,WAAW,QAA4B,OAAqB;AACnE,UAAM,QAAQ,OAAO;AACrB,UAAM,WAAW,OAAO;AACxB,UAAM,QAAQ,OAAO;AAGrB,QAAI,MAAM,WAAW,MAAM,SAAS;AACnC,YAAM,iBAAiB;AAAA,IACxB;AAGA,QAAI,CAAC,MAAM,QAAQ,MAAM,UAAU;AAClC,YAAM,4BAA4B;AAAA,IACnC;AAGA,QAAI,MAAM,QAAQ,CAAC,MAAM,sBAAsB;AAC9C,YAAM,eAAe;AACrB,YAAM,kBAAkB,SAAS;AAAA,IAClC;AAEA,UAAM,uBAAuB,MAAM;AACnC,UAAM,WAAW,MAAM;AAGvB,QAAI,MAAM,cAAc;AACvB,YAAM,mBAAmB;AACzB,UAAI,MAAM,mBAAmB,GAAG;AAC/B,cAAM,eAAe;AAAA,MACtB;AAAA,IACD;AAIA,UAAM,mBAAmB;AACzB,UAAM,cAAc,MAAM,iBAAiB;AAC3C,QAAI,CAAC,MAAM,QAAQ,MAAM,WAAW,CAAC,MAAM,kBAAkB,aAAa;AACzE,YAAM,iBAAiB;AACvB,YAAM,mBAAmB;AAAA,IAC1B;AAIA,QAAI,MAAM,mBAAmB,GAAG;AAC/B,UAAI,MAAM,mBAAmB,GAAG;AAC/B,cAAM,QAAQ,KAAK,IAAI,QAAQ,MAAM,kBAAkB,CAAC;AACxD,cAAM,UAAU,MAAM,mBAAmB,SAAS;AAClD,cAAM,qBAAqB,UAAU,MAAM,oBAAoB;AAAA,MAChE;AACA,YAAM,mBAAmB,KAAK,IAAI,GAAG,MAAM,mBAAmB,KAAK;AAAA,IACpE;AAGA,QAAI,CAAC,MAAM,aAAc;AAGzB,UAAM,iBAAiB,CAAC,MAAM,YAAY,MAAM,qBAAqB,SAAS;AAC9E,UAAM,cAAc,MAAM,YAAa,kBAAkB,MAAM,cAAc;AAO7E,UAAM,oBAAoB,MAAM,YAAY,SAAS;AACrD,UAAM,iBAAiB,MAAM;AAC7B,UAAM,oBAAoB,MAAM,iBAAiB,SAAS;AAC1D,UAAM,eAAe,CAAC,MAAM,YAAY,qBAAqB,kBAAkB;AAE/E,QAAI,eAAe,cAAc;AAEhC,YAAM,eAAe;AAGrB,YAAM;AACN,YAAM,4BAA4B;AAClC,YAAM,gBAAgB;AAGtB,YAAM,kBAAkB,OAAO,KAAK,YAAY,EAAE;AAGlD,YAAM,UAAU;AAChB,YAAM,UAAU;AAChB,YAAM,iBAAiB;AACvB,YAAM,mBAAmB;AAEzB,YAAM,mBAAmB,SAAS;AAIlC,YAAM,kBAAkB;AAAA,IACzB;AAAA,EACD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUQ,aAAa,QAA4B,OAAqB;AACrE,UAAM,WAAW,OAAO;AACxB,UAAM,QAAQ,OAAO;AAErB,QAAI,MAAM,iBAAiB;AAC1B,YAAM,kBAAkB;AACxB;AAAA,IACD;AAEA,QAAI,MAAM,UAAU;AACnB,YAAM,mBAAmB,CAAC;AAC1B;AAAA,IACD;AAEA,UAAM,oBAAoB,SAAS,UAAU;AAAA,EAC9C;AAAA;AAAA;AAAA;AAAA,EAKQ,YAAY,QAA4B,OAAe,kBAAiC;AAC/F,UAAM,QAAQ,OAAO;AACrB,UAAM,cAAc,MAAM;AAE1B,UAAM,aAAa,MAAM,WAAW,MAAM;AAC1C,QAAI;AACJ,QAAI,YAAY;AAEf,YAAM,UAAU,MAAM,WAAW,CAAC,MAAM;AACxC,mBAAa,oBAAoB;AAAA,IAClC,OAAO;AACN,mBAAa;AAAA,IACd;AAEA,UAAM,WAAW;AAEjB,QAAI,MAAM,UAAU;AACnB,YAAM,oBAAoB;AAC1B,YAAM,gBAAgB,OAAO,KAAK,YAAY,EAAE;AAAA,IACjD,OAAO;AACN,YAAM,qBAAqB;AAAA,IAC5B;AAEA,QAAI,CAAC,eAAe,MAAM,UAAU;AACnC,YAAM,YAAY;AAClB,YAAM,UAAU;AAChB,YAAM,UAAU;AAChB,YAAM,iBAAiB;AACvB,YAAM,mBAAmB;AACzB,UAAI,MAAM,mBAAmB,GAAG;AAC/B,cAAM,mBAAmB;AAAA,MAC1B;AAAA,IACD;AAEA,QAAI,MAAM,mBAAmB,2BAA2B,CAAC,MAAM,UAAU;AACxE,UAAI,MAAM,SAAS;AAClB,cAAM,UAAU;AAChB,cAAM,UAAU;AAAA,MACjB,WAAW,CAAC,MAAM,SAAS;AAC1B,cAAM,UAAU;AAAA,MACjB;AAAA,IACD;AAAA,EACD;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,aAAa,QAA4B,OAAqB;AAC7D,QAAI,CAAC,OAAO,gBAAgB,CAAC,OAAO,iBAAiB,CAAC,OAAO,mBAAmB;AAC/E;AAAA,IACD;AAEA,UAAM,aAAa,KAAK,wBAAwB,MAAM;AACtD,UAAM,WAAW,OAAO;AACxB,QAAI,CAAC,cAAc,CAAC,SAAU;AAE9B,UAAM,QAAQ,OAAO;AACrB,UAAM,WAAW,OAAO;AACxB,UAAM,QAAQ,OAAO;AAGrB,SAAK,WAAW,QAAQ,KAAK;AAG7B,SAAK,aAAa,QAAQ,KAAK;AAG/B,UAAM,QAAQ,MAAM,MAAM,SAAS,WAAW,SAAS;AACvD,UAAM,eAAe;AACrB,aAAS,IAAI,MAAM,QAAQ,QAAQ;AACnC,aAAS,IAAI,MAAM,mBAAmB;AACtC,aAAS,IAAI;AAGb,eAAW,wBAAwB,UAAU,UAAU,iBAAiB,eAAe;AACvF,UAAM,YAAY,WAAW,iBAAiB;AAI9C,QAAI,SAAS,IAAI,QAAQ,UAAU,IAAI,SAAS,IAAI,KAAK;AACxD,YAAM,mBAAmB;AAAA,IAC1B;AAEA,UAAM,cAAc,OAAO,KAAK,YAAY;AAC5C,WAAO,KAAK,4BAA4B;AAAA,MACvC,GAAG,YAAY,IAAI,UAAU;AAAA,MAC7B,GAAG,YAAY,IAAI,UAAU;AAAA,MAC7B,GAAG,KAAK,OAAO,IAAI,OAAO,IAAI,KAAK,YAAY;AAAA,IAChD,CAAC;AAGD,SAAK,YAAY,QAAQ,OAAO,WAAW,iBAAiB,CAAC;AAAA,EAC9D;AAAA,EAEA,UAAgB;AACf,UAAM,eAAe,KAAK,OAAO;AACjC,QAAI,cAAc;AACjB,iBAAW,cAAc,KAAK,YAAY,OAAO,GAAG;AACnD,qBAAa,0BAA0B,UAAU;AAAA,MAClD;AAAA,IACD;AACA,SAAK,YAAY,MAAM;AACvB,SAAK,OAAO,MAAM;AAAA,EACnB;AACD;;;ACrUA,IAAM,qBAAmD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAOzD;AAkCA,IAAM,iBAA8C;AAAA,EACnD,WAAW;AAAA,EACX,UAAU;AAAA,EACV,WAAW;AAAA,EACX,UAAU;AAAA,EACV,SAAS;AAAA,EACT,YAAY;AAAA,EACZ,gBAAgB;AAAA,EAChB,mBAAmB;AAAA,EACnB,iBAAiB;AAAA,EACjB,iBAAiB;AAAA,EACjB,UAAU,EAAE,WAAW,MAAM,UAAU,KAAK;AAAA,EAC5C,sBAAsB;AAAA,EACtB,iBAAiB;AAClB;AAEA,IAAM,6BAA6B,uBAAO,IAAI,8BAA8B;AAS5E,IAAM,6BAAN,MAA2D;AAAA,EAI1D,YACC,OACQ,WACA,kBACP;AAFO;AACA;AAER,SAAK,iBAAiB,IAAI,mBAAmB,KAAK;AAAA,EACnD;AAAA,EAJS;AAAA,EACA;AAAA,EAND;AAAA,EACA,uBAAuB,oBAAI,IAAY;AAAA,EAU/C,OAAO,MAAe,OAAqB;AAC1C,UAAM,QAAQ,KAAK,mBAAmB,0BAA0B;AAChE,QAAI,CAAC,MAAO;AAEZ,eAAW,QAAQ,OAAO;AACzB,YAAM,aAAa,KAAK;AACxB,YAAM,gBAAgB,KAAK;AAE3B,YAAM,UAAU,cAAc;AAE9B,UAAI,CAAC,WAAW,cAAc;AAC7B,mBAAW,eAAe,oCAAoC,OAAO;AAAA,MACtE;AACA,UAAI,CAAC,WAAW,eAAe;AAC9B,mBAAW,gBAAgB,iCAAiC;AAAA,MAC7D;AACA,UAAI,CAAC,WAAW,mBAAmB;AAClC,mBAAW,oBAAoB,iCAAiC;AAAA,MACjE;AAKA,YAAM,SAAU,WAAW,iBAAiB;AAC5C,UAAI,KAAK,aAAa,UAAU,GAAG;AAClC,aAAK,mBAAmB,QAAQ,OAAO;AACvC,sBAAc,cAAc,KAAK;AACjC,sBAAc,WAAW;AACzB,cAAM,QAAQ,WAAW;AACzB,YAAI,OAAO;AACV,eAAK,UAAU,eAAe,QAAQ,MAAM,SAAS,GAAG,CAAC;AACzD,eAAK,UAAU,iBAAiB,QAAQ,yBAAyB,CAAC,CAAC,MAAM,IAAI;AAC7E,eAAK,UAAU,iBAAiB,QAAQ,wBAAwB,CAAC,CAAC,MAAM,GAAG;AAAA,QAC5E;AACA;AAAA,MACD;AAEA,UAAI,CAAC,cAAc,KAAK;AACvB,sBAAc,MAAM,IAAI,gBAAgB;AAAA,UACvC,OAAO,WAAW;AAAA,UAClB,OAAO,WAAW;AAAA,QACnB,CAAC;AAAA,MACF;AACA,oBAAc,IAAI,OAAO,WAAW,eAAe,WAAW,iBAAiB;AAE/E,UAAI,CAAC,WAAW,KAAM;AACtB,WAAK,eAAe,aAAa,YAAY,KAAK;AAAA,IACnD;AAAA,EACD;AAAA,EAEQ,mBAAmB,QAAgB,SAA4C;AACtF,QAAI,CAAC,KAAK,aAAa,KAAK,qBAAqB,IAAI,MAAM,EAAG;AAC9D,UAAM,WAAW,QAAQ,YAAY,eAAe;AACpD,SAAK,UAAU,mBAAmB,QAAQ;AAAA,MACzC,YAAY;AAAA,MACZ,QAAQ;AAAA,MACR,WAAW,QAAQ,aAAa,eAAe;AAAA,MAC/C,UAAU,QAAQ,YAAY,eAAe;AAAA,MAC7C,WAAW,QAAQ,aAAa,eAAe;AAAA,MAC/C,UAAU,QAAQ,YAAY,eAAe;AAAA,MAC7C,SAAS,QAAQ,WAAW,eAAe;AAAA,MAC3C,YAAY,QAAQ,cAAc,eAAe;AAAA,MACjD,gBAAgB,QAAQ,kBAAkB,eAAe;AAAA,MACzD,mBAAmB,QAAQ,qBAAqB,eAAe;AAAA,MAC/D,iBAAiB,QAAQ,mBAAmB,eAAe;AAAA,MAC3D,iBAAiB,QAAQ,mBAAmB,eAAe;AAAA,MAC3D,gBAAgB,WAAW,SAAS,YAAY;AAAA,MAChD,kBAAkB,WAAW,SAAS,WAAW;AAAA,MACjD,sBAAsB,QAAQ,wBAAwB,eAAe;AAAA,MACrE,iBAAiB,QAAQ,mBAAmB,eAAe;AAAA,IAC5D,CAAC;AACD,SAAK,qBAAqB,IAAI,MAAM;AAAA,EACrC;AAAA,EAEA,QAAQ,MAAqB;AAC5B,SAAK,eAAe,QAAQ;AAC5B,SAAK,qBAAqB,MAAM;AAAA,EACjC;AACD;AAiCO,IAAM,uBAAuB,eAQlC;AAAA,EACD,MAAM;AAAA,EACN;AAAA,EACA,eAAe,CAAC,QACf,IAAI;AAAA,IACH,IAAI,SAAS;AAAA,IACb,IAAI,aAAa;AAAA,IACjB,IAAI;AAAA,EACL;AAAA;AAAA;AAAA;AAAA,EAID,cAAc,CAAC,SAAS;AAAA,IACvB,UAAU,MAAM;AACf,YAAM,WAAW,qBAAqB,GAAG;AACzC,UAAI,SAAU,QAAO,mBAAmB,SAAS,QAAQ;AACzD,aAAO,IAAI,KAAK,SAAS;AAAA,IAC1B;AAAA,IACA,YAAY,MACX,qBAAqB,GAAG,GAAG,YAAY,IAAI,KAAK,WAAW,KAAK;AAAA,IACjE,cAAc,MACb,qBAAqB,GAAG,GAAG,aAAa,IAAI,KAAK,aAAa,KAAK;AAAA,EACrE;AACD,CAAC;","names":["Platformer2DState","Platformer2DEvent"]}

package/dist/{chunk-6C6NXNEW.js → chunk-UL6Q5HDP.js}

@@ -3,7 +3,7 @@ import {
   directionFromAngle2D,
   getRotationAngle2D,
   normalizeDirection2D
-} from "./chunk-ID5QJYF5.js";
+} from "./chunk-Y7YIAWPW.js";
 
 // src/lib/coordinators/shared/top-down-aim.ts
 function getEntityFacingAngle2D(entity) {
@@ -31,8 +31,30 @@ function resolveAim2D(aimX, aimY, fallbackAngle) {
   };
 }
 
+// src/lib/coordinators/shared/shooter-fire.ts
+function fireShooter2DIfRequested(entity, shooter, stage, input, aim) {
+  if (!input.shootPressed && !input.shootHeld) {
+    return false;
+  }
+  const sourcePosition = entity.body?.translation();
+  if (!sourcePosition) {
+    return false;
+  }
+  const resolved = aim ?? resolveAim2D(input.aimX, input.aimY, getEntityFacingAngle2D(entity));
+  void shooter.fire({
+    source: entity,
+    stage,
+    target: {
+      x: sourcePosition.x + resolved.direction.x,
+      y: sourcePosition.y + resolved.direction.y
+    }
+  });
+  return true;
+}
+
 export {
   getEntityFacingAngle2D,
-  resolveAim2D
+  resolveAim2D,
+  fireShooter2DIfRequested
 };
-//# sourceMappingURL=chunk-6C6NXNEW.js.map
+//# sourceMappingURL=chunk-UL6Q5HDP.js.map