@zylem/behaviors 0.2.0

package/dist/chunk-YUO6SKJD.js

@@ -0,0 +1,348 @@
+import {
+  createFirstPersonInputComponent,
+  createFirstPersonMovementComponent,
+  createFirstPersonStateComponent
+} from "./chunk-LD5SMIB3.js";
+import {
+  VEC3_ZERO,
+  toThreeVector3
+} from "./chunk-WWVD5DR5.js";
+import {
+  setVelocityIntent
+} from "./chunk-RTVRUNYR.js";
+import {
+  SyncStateMachine,
+  t
+} from "./chunk-4URF65BR.js";
+import {
+  defineBehavior
+} from "./chunk-EZNCCO4L.js";
+
+// src/lib/behaviors/first-person/first-person-fsm.ts
+var FirstPersonState = /* @__PURE__ */ ((FirstPersonState2) => {
+  FirstPersonState2["Idle"] = "idle";
+  FirstPersonState2["Walking"] = "walking";
+  FirstPersonState2["Running"] = "running";
+  return FirstPersonState2;
+})(FirstPersonState || {});
+var FirstPersonEvent = /* @__PURE__ */ ((FirstPersonEvent2) => {
+  FirstPersonEvent2["Walk"] = "walk";
+  FirstPersonEvent2["Run"] = "run";
+  FirstPersonEvent2["Stop"] = "stop";
+  return FirstPersonEvent2;
+})(FirstPersonEvent || {});
+var FirstPersonFSM = 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 */, "stop" /* Stop */, "idle" /* Idle */),
+        // Walking transitions
+        t("walking" /* Walking */, "run" /* Run */, "running" /* Running */),
+        t("walking" /* Walking */, "stop" /* Stop */, "idle" /* Idle */),
+        t("walking" /* Walking */, "walk" /* Walk */, "walking" /* Walking */),
+        // Running transitions
+        t("running" /* Running */, "walk" /* Walk */, "walking" /* Walking */),
+        t("running" /* Running */, "stop" /* Stop */, "idle" /* Idle */),
+        t("running" /* Running */, "run" /* Run */, "running" /* Running */)
+      ]
+    );
+  }
+  ctx;
+  machine;
+  /** Get the current state */
+  getState() {
+    return this.machine.getState();
+  }
+  /** Dispatch an event to the FSM */
+  dispatch(event) {
+    if (this.machine.can(event)) {
+      this.machine.syncDispatch(event);
+    }
+  }
+  /** Get the current yaw from context */
+  getYaw() {
+    return this.ctx.state.yaw;
+  }
+  /** Get the current pitch from context */
+  getPitch() {
+    return this.ctx.state.pitch;
+  }
+  /**
+   * Update FSM based on current input and state.
+   */
+  update(input, state) {
+    this.ctx.input = input;
+    this.ctx.state = state;
+    const hasMovement = Math.abs(input.moveX) > 0.1 || Math.abs(input.moveZ) > 0.1;
+    if (hasMovement) {
+      if (input.sprint) {
+        this.dispatch("run" /* Run */);
+      } else {
+        this.dispatch("walk" /* Walk */);
+      }
+    } else {
+      this.dispatch("stop" /* Stop */);
+    }
+  }
+};
+
+// src/lib/behaviors/first-person/first-person.behavior.ts
+import { Vector3, Quaternion, Euler } from "three";
+var _forward = new Vector3();
+var _right = new Vector3();
+var _up = new Vector3(0, 1, 0);
+var _viewmodelQuat = new Quaternion();
+var _viewmodelLocalQuat = new Quaternion();
+var _viewmodelEuler = new Euler();
+var _offset = new Vector3();
+var FirstPersonControllerBehavior = class {
+  world;
+  perspectives = /* @__PURE__ */ new Map();
+  viewmodels = /* @__PURE__ */ new Map();
+  constructor(world) {
+    this.world = world;
+  }
+  /**
+   * Associate a FirstPersonPerspective with an entity (by uuid).
+   * Called once by the descriptor system when the behavior is initialized.
+   */
+  setPerspective(entityUuid, perspective) {
+    this.perspectives.set(entityUuid, perspective);
+  }
+  hasPerspective(entityUuid) {
+    return this.perspectives.has(entityUuid);
+  }
+  /**
+   * Attach a viewmodel (weapon/item) to an entity.
+   * The viewmodel entity's group will be positioned relative to the camera each frame.
+   */
+  setViewmodel(entityUuid, config) {
+    this.viewmodels.set(entityUuid, config);
+  }
+  hasViewmodel(entityUuid) {
+    return this.viewmodels.has(entityUuid);
+  }
+  /**
+   * Update one first-person entity.
+   */
+  updateEntity(entity, _delta) {
+    const fpEntity = entity;
+    if (!fpEntity.firstPerson || !fpEntity.$fps || !fpEntity.firstPersonState) {
+      return;
+    }
+    const input = fpEntity.$fps;
+    const movement = fpEntity.firstPerson;
+    const state = fpEntity.firstPersonState;
+    const perspective = this.perspectives.get(fpEntity.uuid);
+    if (perspective?.initialPosition && fpEntity.body) {
+      const pos = fpEntity.body.translation();
+      perspective.initialPosition.set(
+        pos.x,
+        pos.y + movement.eyeHeight,
+        pos.z
+      );
+    }
+    if (perspective) {
+      perspective.look(
+        -input.lookX * movement.lookSensitivity,
+        -input.lookY * movement.lookSensitivity
+      );
+      state.yaw = perspective.yaw;
+      state.pitch = perspective.pitch;
+    }
+    const speed = input.sprint ? movement.runSpeed : movement.walkSpeed;
+    state.currentSpeed = speed;
+    const hasMovement = Math.abs(input.moveX) > 0.1 || Math.abs(input.moveZ) > 0.1;
+    if (fpEntity.transformStore) {
+      if (hasMovement) {
+        _forward.set(0, 0, -1).applyAxisAngle(_up, state.yaw);
+        _right.set(1, 0, 0).applyAxisAngle(_up, state.yaw);
+        const vx = _right.x * input.moveX * speed + _forward.x * -input.moveZ * speed;
+        const vz = _right.z * input.moveX * speed + _forward.z * -input.moveZ * speed;
+        setVelocityIntent(
+          fpEntity.transformStore,
+          "first-person",
+          { x: vx, z: vz },
+          { mode: "replace", priority: 10 }
+        );
+      } else {
+        setVelocityIntent(
+          fpEntity.transformStore,
+          "first-person",
+          { x: 0, z: 0 },
+          { mode: "replace", priority: 10 }
+        );
+      }
+    }
+    const vm = this.viewmodels.get(fpEntity.uuid);
+    if (vm && perspective?.initialPosition) {
+      this.positionViewmodel(vm, perspective, state);
+    }
+  }
+  /**
+   * Update all first-person entities.
+   */
+  update(delta) {
+    if (!this.world?.collisionMap) return;
+    for (const [, entity] of this.world.collisionMap) {
+      this.updateEntity(entity, delta);
+    }
+  }
+  /**
+   * Position a viewmodel entity relative to the camera's eye position and rotation.
+   *
+   * The physics transform system overwrites group.position from the rigid body
+   * each frame, so we must also move the body to keep them in sync.
+   */
+  positionViewmodel(vm, perspective, state) {
+    const eyePos = perspective.initialPosition;
+    if (!eyePos) return;
+    _viewmodelQuat.setFromEuler(
+      _viewmodelEuler.set(state.pitch, state.yaw, 0, "YXZ")
+    );
+    if (vm.rotation) {
+      _viewmodelLocalQuat.setFromEuler(vm.rotation);
+      _viewmodelQuat.multiply(_viewmodelLocalQuat);
+    }
+    _offset.copy(vm.offset).applyQuaternion(_viewmodelQuat);
+    const wx = eyePos.x + _offset.x;
+    const wy = eyePos.y + _offset.y;
+    const wz = eyePos.z + _offset.z;
+    const entity = vm.entity;
+    if (entity?.body) {
+      entity.body.setTranslation({ x: wx, y: wy, z: wz }, true);
+      entity.body.setRotation(
+        { x: _viewmodelQuat.x, y: _viewmodelQuat.y, z: _viewmodelQuat.z, w: _viewmodelQuat.w },
+        true
+      );
+    }
+    if (entity?.group) {
+      entity.group.position.set(wx, wy, wz);
+      entity.group.quaternion.copy(_viewmodelQuat);
+    }
+  }
+  /** Cleanup */
+  destroy() {
+    this.perspectives.clear();
+    this.viewmodels.clear();
+  }
+};
+
+// src/lib/behaviors/first-person/first-person.descriptor.ts
+var defaultOptions = {
+  walkSpeed: 8,
+  runSpeed: 16,
+  lookSensitivity: 2,
+  eyeHeight: 1.7
+};
+var FIRST_PERSON_BEHAVIOR_KEY = /* @__PURE__ */ Symbol.for(
+  "zylem:behavior:first-person-controller"
+);
+var FirstPersonControllerSystem = class {
+  constructor(world, wasmStage, getBehaviorLinks) {
+    this.world = world;
+    this.wasmStage = wasmStage;
+    this.getBehaviorLinks = getBehaviorLinks;
+    this.behavior = new FirstPersonControllerBehavior(world);
+  }
+  world;
+  wasmStage;
+  getBehaviorLinks;
+  behavior;
+  attachedRuntimeSlots = /* @__PURE__ */ new Set();
+  update(_ecs, delta) {
+    const links = this.getBehaviorLinks?.(FIRST_PERSON_BEHAVIOR_KEY);
+    if (!links) return;
+    for (const link of links) {
+      const gameEntity = link.entity;
+      const fpsRef = link.ref;
+      const options = fpsRef.options;
+      const handle = gameEntity.runtimeHandle ?? -1;
+      if (this.wasmStage && handle >= 0) {
+        this.ensureWasmAttached(handle, options);
+        const input = gameEntity.$fps;
+        if (input) {
+          this.wasmStage.setFirstPersonInput(handle, {
+            moveX: input.moveX ?? 0,
+            moveZ: input.moveZ ?? 0,
+            lookYawDelta: input.lookX ?? 0,
+            lookPitchDelta: input.lookY ?? 0,
+            run: !!input.sprint
+          });
+        }
+        continue;
+      }
+      if (!gameEntity.firstPerson) {
+        gameEntity.firstPerson = createFirstPersonMovementComponent(options);
+      }
+      if (!gameEntity.$fps) {
+        gameEntity.$fps = createFirstPersonInputComponent();
+      }
+      if (!gameEntity.firstPersonState) {
+        gameEntity.firstPersonState = createFirstPersonStateComponent();
+      }
+      if (options.perspective && !this.behavior.hasPerspective(gameEntity.uuid)) {
+        this.behavior.setPerspective(gameEntity.uuid, options.perspective);
+      }
+      if (options.viewmodel && !this.behavior.hasViewmodel(gameEntity.uuid)) {
+        this.behavior.setViewmodel(gameEntity.uuid, {
+          ...options.viewmodel,
+          offset: toThreeVector3(options.viewmodel.offset, VEC3_ZERO)
+        });
+      }
+      if (!fpsRef.fsm && gameEntity.$fps && gameEntity.firstPersonState) {
+        fpsRef.fsm = new FirstPersonFSM({
+          input: gameEntity.$fps,
+          state: gameEntity.firstPersonState
+        });
+      }
+      if (fpsRef.fsm && gameEntity.$fps && gameEntity.firstPersonState) {
+        fpsRef.fsm.update(gameEntity.$fps, gameEntity.firstPersonState);
+      }
+      this.behavior.updateEntity(gameEntity, delta);
+    }
+  }
+  ensureWasmAttached(handle, options) {
+    if (!this.wasmStage || this.attachedRuntimeSlots.has(handle)) return;
+    this.wasmStage.attachFirstPerson(handle, {
+      walkSpeed: options.walkSpeed ?? defaultOptions.walkSpeed,
+      runSpeed: options.runSpeed ?? defaultOptions.runSpeed,
+      eyeHeight: options.eyeHeight ?? defaultOptions.eyeHeight,
+      lookSensitivity: options.lookSensitivity ?? defaultOptions.lookSensitivity
+    });
+    this.attachedRuntimeSlots.add(handle);
+  }
+  destroy(_ecs) {
+    this.behavior.destroy();
+    this.attachedRuntimeSlots.clear();
+  }
+};
+var FirstPersonController = defineBehavior({
+  name: "first-person-controller",
+  defaultOptions,
+  systemFactory: (ctx) => new FirstPersonControllerSystem(ctx.world, ctx.wasmStage ?? null, ctx.getBehaviorLinks),
+  createHandle: (ref) => ({
+    getState: () => ref.fsm?.getState() ?? "idle" /* Idle */,
+    getYaw: () => ref.fsm?.getYaw() ?? 0,
+    getPitch: () => ref.fsm?.getPitch() ?? 0,
+    attachViewmodel: (entity, offset) => {
+      if (ref.options) {
+        ref.options.viewmodel = { entity, offset };
+      }
+    }
+  })
+});
+
+export {
+  FirstPersonState,
+  FirstPersonEvent,
+  FirstPersonFSM,
+  FirstPersonControllerBehavior,
+  FirstPersonController
+};
+//# sourceMappingURL=chunk-YUO6SKJD.js.map

package/dist/chunk-YUO6SKJD.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/lib/behaviors/first-person/first-person-fsm.ts","../src/lib/behaviors/first-person/first-person.behavior.ts","../src/lib/behaviors/first-person/first-person.descriptor.ts"],"sourcesContent":["/**\n * First Person Controller Finite State Machine\n *\n * Manages state transitions for first-person movement:\n * - Idle: Standing still\n * - Walking: Moving at walk speed\n * - Running: Moving at run/sprint speed\n */\n\nimport { SyncStateMachine, t } from '../../core/utility/sync-state-machine';\nimport type { FirstPersonInputComponent, FirstPersonStateComponent } from './components';\n\n/**\n * First-person movement states\n */\nexport enum FirstPersonState {\n\tIdle = 'idle',\n\tWalking = 'walking',\n\tRunning = 'running',\n}\n\n/**\n * Events that trigger state transitions\n */\nexport enum FirstPersonEvent {\n\tWalk = 'walk',\n\tRun = 'run',\n\tStop = 'stop',\n}\n\n/**\n * Context for the FSM\n */\nexport interface FirstPersonContext {\n\tinput: FirstPersonInputComponent;\n\tstate: FirstPersonStateComponent;\n}\n\n/**\n * First Person Controller FSM\n */\nexport class FirstPersonFSM {\n\tmachine: SyncStateMachine<FirstPersonState, FirstPersonEvent, never>;\n\n\tconstructor(private ctx: FirstPersonContext) {\n\t\tthis.machine = new SyncStateMachine<FirstPersonState, FirstPersonEvent, never>(\n\t\t\tFirstPersonState.Idle,\n\t\t\t[\n\t\t\t\t// Idle transitions\n\t\t\t\tt(FirstPersonState.Idle, FirstPersonEvent.Walk, FirstPersonState.Walking),\n\t\t\t\tt(FirstPersonState.Idle, FirstPersonEvent.Run, FirstPersonState.Running),\n\t\t\t\tt(FirstPersonState.Idle, FirstPersonEvent.Stop, FirstPersonState.Idle),\n\n\t\t\t\t// Walking transitions\n\t\t\t\tt(FirstPersonState.Walking, FirstPersonEvent.Run, FirstPersonState.Running),\n\t\t\t\tt(FirstPersonState.Walking, FirstPersonEvent.Stop, FirstPersonState.Idle),\n\t\t\t\tt(FirstPersonState.Walking, FirstPersonEvent.Walk, FirstPersonState.Walking),\n\n\t\t\t\t// Running transitions\n\t\t\t\tt(FirstPersonState.Running, FirstPersonEvent.Walk, FirstPersonState.Walking),\n\t\t\t\tt(FirstPersonState.Running, FirstPersonEvent.Stop, FirstPersonState.Idle),\n\t\t\t\tt(FirstPersonState.Running, FirstPersonEvent.Run, FirstPersonState.Running),\n\t\t\t],\n\t\t);\n\t}\n\n\t/** Get the current state */\n\tgetState(): FirstPersonState {\n\t\treturn this.machine.getState();\n\t}\n\n\t/** Dispatch an event to the FSM */\n\tdispatch(event: FirstPersonEvent): void {\n\t\tif (this.machine.can(event)) {\n\t\t\tthis.machine.syncDispatch(event);\n\t\t}\n\t}\n\n\t/** Get the current yaw from context */\n\tgetYaw(): number {\n\t\treturn this.ctx.state.yaw;\n\t}\n\n\t/** Get the current pitch from context */\n\tgetPitch(): number {\n\t\treturn this.ctx.state.pitch;\n\t}\n\n\t/**\n\t * Update FSM based on current input and state.\n\t */\n\tupdate(input: FirstPersonInputComponent, state: FirstPersonStateComponent): void {\n\t\tthis.ctx.input = input;\n\t\tthis.ctx.state = state;\n\n\t\tconst hasMovement = Math.abs(input.moveX) > 0.1 || Math.abs(input.moveZ) > 0.1;\n\n\t\tif (hasMovement) {\n\t\t\tif (input.sprint) {\n\t\t\t\tthis.dispatch(FirstPersonEvent.Run);\n\t\t\t} else {\n\t\t\t\tthis.dispatch(FirstPersonEvent.Walk);\n\t\t\t}\n\t\t} else {\n\t\t\tthis.dispatch(FirstPersonEvent.Stop);\n\t\t}\n\t}\n}\n","/**\n * First Person Controller Behavior System\n *\n * Handles first-person camera control and movement:\n * - Reads input component for WASD movement and mouse look deltas\n * - Drives a FirstPersonPerspective (yaw/pitch accumulation)\n * - Writes velocity to transformStore (physics-based movement)\n * - Syncs camera position from the entity's rigid body each frame\n * - Positions an optional viewmodel entity relative to the camera\n */\n\nimport { Vector3, Quaternion, Euler } from 'three';\nimport type { FirstPersonPerspective } from '../../camera/perspectives/first-person-perspective';\nimport { setVelocityIntent } from '../../actions/capabilities/velocity-intents';\nimport type {\n\tFirstPersonMovementComponent,\n\tFirstPersonInputComponent,\n\tFirstPersonStateComponent,\n} from './components';\n\n/**\n * Viewmodel configuration for an entity that follows the camera.\n */\nexport interface ViewmodelConfig {\n\t/** The entity whose visual group should be positioned relative to the camera. */\n\tentity: any;\n\t/** Offset from the eye position in camera-local space (right, down, forward). */\n\toffset: Vector3;\n\t/** Additional rotation applied to the viewmodel in local space (Euler angles in radians). */\n\trotation?: Euler;\n}\n\n/**\n * Entity interface for first-person controller.\n * Entities with this behavior have these components attached.\n */\nexport interface FirstPersonEntity {\n\tuuid: string;\n\tbody: any;\n\ttransformStore: any;\n\tfirstPerson: FirstPersonMovementComponent;\n\t$fps: FirstPersonInputComponent;\n\tfirstPersonState: FirstPersonStateComponent;\n}\n\n// Reusable temporaries (avoid per-frame allocations)\nconst _forward = new Vector3();\nconst _right = new Vector3();\nconst _up = new Vector3(0, 1, 0);\nconst _viewmodelQuat = new Quaternion();\nconst _viewmodelLocalQuat = new Quaternion();\nconst _viewmodelEuler = new Euler();\nconst _offset = new Vector3();\n\n/**\n * First Person Controller Behavior\n *\n * Core movement + look system for first-person cameras.\n * Reads from entity.$fps input component and drives a FirstPersonPerspective.\n */\nexport class FirstPersonControllerBehavior {\n\tprivate world: any;\n\tprivate perspectives = new Map<string, FirstPersonPerspective>();\n\tprivate viewmodels = new Map<string, ViewmodelConfig>();\n\n\tconstructor(world: any) {\n\t\tthis.world = world;\n\t}\n\n\t/**\n\t * Associate a FirstPersonPerspective with an entity (by uuid).\n\t * Called once by the descriptor system when the behavior is initialized.\n\t */\n\tsetPerspective(entityUuid: string, perspective: FirstPersonPerspective): void {\n\t\tthis.perspectives.set(entityUuid, perspective);\n\t}\n\n\thasPerspective(entityUuid: string): boolean {\n\t\treturn this.perspectives.has(entityUuid);\n\t}\n\n\t/**\n\t * Attach a viewmodel (weapon/item) to an entity.\n\t * The viewmodel entity's group will be positioned relative to the camera each frame.\n\t */\n\tsetViewmodel(entityUuid: string, config: ViewmodelConfig): void {\n\t\tthis.viewmodels.set(entityUuid, config);\n\t}\n\n\thasViewmodel(entityUuid: string): boolean {\n\t\treturn this.viewmodels.has(entityUuid);\n\t}\n\n\t/**\n\t * Update one first-person entity.\n\t */\n\tupdateEntity(entity: any, _delta: number): void {\n\t\tconst fpEntity = entity as any;\n\t\tif (!fpEntity.firstPerson || !fpEntity.$fps || !fpEntity.firstPersonState) {\n\t\t\treturn;\n\t\t}\n\n\t\tconst input: FirstPersonInputComponent = fpEntity.$fps;\n\t\tconst movement: FirstPersonMovementComponent = fpEntity.firstPerson;\n\t\tconst state: FirstPersonStateComponent = fpEntity.firstPersonState;\n\t\tconst perspective = this.perspectives.get(fpEntity.uuid);\n\n\t\t// 1. Sync camera position from physics body\n\t\tif (perspective?.initialPosition && fpEntity.body) {\n\t\t\tconst pos = fpEntity.body.translation();\n\t\t\tperspective.initialPosition.set(\n\t\t\t\tpos.x,\n\t\t\t\tpos.y + movement.eyeHeight,\n\t\t\t\tpos.z,\n\t\t\t);\n\t\t}\n\n\t\t// 2. Apply look\n\t\tif (perspective) {\n\t\t\tperspective.look(\n\t\t\t\t-input.lookX * movement.lookSensitivity,\n\t\t\t\t-input.lookY * movement.lookSensitivity,\n\t\t\t);\n\n\t\t\tstate.yaw = perspective.yaw;\n\t\t\tstate.pitch = perspective.pitch;\n\t\t}\n\n\t\t// 3. Compute velocity-based movement and write to transformStore\n\t\tconst speed = input.sprint ? movement.runSpeed : movement.walkSpeed;\n\t\tstate.currentSpeed = speed;\n\n\t\tconst hasMovement = Math.abs(input.moveX) > 0.1 || Math.abs(input.moveZ) > 0.1;\n\n\t\tif (fpEntity.transformStore) {\n\t\t\tif (hasMovement) {\n\t\t\t\t_forward.set(0, 0, -1).applyAxisAngle(_up, state.yaw);\n\t\t\t\t_right.set(1, 0, 0).applyAxisAngle(_up, state.yaw);\n\n\t\t\t\tconst vx =\n\t\t\t\t\t_right.x * input.moveX * speed +\n\t\t\t\t\t_forward.x * (-input.moveZ) * speed;\n\t\t\t\tconst vz =\n\t\t\t\t\t_right.z * input.moveX * speed +\n\t\t\t\t\t_forward.z * (-input.moveZ) * speed;\n\t\t\t\tsetVelocityIntent(\n\t\t\t\t\tfpEntity.transformStore,\n\t\t\t\t\t'first-person',\n\t\t\t\t\t{ x: vx, z: vz },\n\t\t\t\t\t{ mode: 'replace', priority: 10 },\n\t\t\t\t);\n\t\t\t} else {\n\t\t\t\tsetVelocityIntent(\n\t\t\t\t\tfpEntity.transformStore,\n\t\t\t\t\t'first-person',\n\t\t\t\t\t{ x: 0, z: 0 },\n\t\t\t\t\t{ mode: 'replace', priority: 10 },\n\t\t\t\t);\n\t\t\t}\n\t\t}\n\n\t\t// 4. Position viewmodel\n\t\tconst vm = this.viewmodels.get(fpEntity.uuid);\n\t\tif (vm && perspective?.initialPosition) {\n\t\t\tthis.positionViewmodel(vm, perspective, state);\n\t\t}\n\t}\n\n\t/**\n\t * Update all first-person entities.\n\t */\n\tupdate(delta: number): void {\n\t\tif (!this.world?.collisionMap) return;\n\t\tfor (const [, entity] of this.world.collisionMap) {\n\t\t\tthis.updateEntity(entity, delta);\n\t\t}\n\t}\n\n\t/**\n\t * Position a viewmodel entity relative to the camera's eye position and rotation.\n\t *\n\t * The physics transform system overwrites group.position from the rigid body\n\t * each frame, so we must also move the body to keep them in sync.\n\t */\n\tprivate positionViewmodel(\n\t\tvm: ViewmodelConfig,\n\t\tperspective: FirstPersonPerspective,\n\t\tstate: FirstPersonStateComponent,\n\t): void {\n\t\tconst eyePos = perspective.initialPosition;\n\t\tif (!eyePos) return;\n\n\t\t// Build camera rotation quaternion\n\t\t_viewmodelQuat.setFromEuler(\n\t\t\t_viewmodelEuler.set(state.pitch, state.yaw, 0, 'YXZ'),\n\t\t);\n\n\t\t// Compose with the viewmodel's local rotation (model orientation fix)\n\t\tif (vm.rotation) {\n\t\t\t_viewmodelLocalQuat.setFromEuler(vm.rotation);\n\t\t\t_viewmodelQuat.multiply(_viewmodelLocalQuat);\n\t\t}\n\n\t\t// Transform the local offset into world space (use camera rotation, not the composed one)\n\t\t_offset.copy(vm.offset).applyQuaternion(_viewmodelQuat);\n\n\t\tconst wx = eyePos.x + _offset.x;\n\t\tconst wy = eyePos.y + _offset.y;\n\t\tconst wz = eyePos.z + _offset.z;\n\n\t\tconst entity = vm.entity;\n\n\t\t// Move the physics body so the transform system stays in sync\n\t\tif (entity?.body) {\n\t\t\tentity.body.setTranslation({ x: wx, y: wy, z: wz }, true);\n\t\t\tentity.body.setRotation(\n\t\t\t\t{ x: _viewmodelQuat.x, y: _viewmodelQuat.y, z: _viewmodelQuat.z, w: _viewmodelQuat.w },\n\t\t\t\ttrue,\n\t\t\t);\n\t\t}\n\n\t\t// Also set the group directly for immediate visual update\n\t\tif (entity?.group) {\n\t\t\tentity.group.position.set(wx, wy, wz);\n\t\t\tentity.group.quaternion.copy(_viewmodelQuat);\n\t\t}\n\t}\n\n\t/** Cleanup */\n\tdestroy(): void {\n\t\tthis.perspectives.clear();\n\t\tthis.viewmodels.clear();\n\t}\n}\n","/**\n * First Person Controller Behavior Descriptor\n *\n * Type-safe descriptor for the first-person controller behavior system.\n * Provides entity.use() API for FPS movement and camera control.\n */\n\nimport { Vector3, Euler } from 'three';\nimport { defineBehavior } from '../behavior-descriptor';\nimport type { BehaviorEntityLink, BehaviorSystem } from '../behavior-system';\nimport type { FirstPersonPerspective } from '../../camera/perspectives/first-person-perspective';\nimport { Vec3Input, VEC3_ZERO, toThreeVector3 } from '../../core/vector';\nimport {\n\tFirstPersonControllerBehavior,\n\ttype FirstPersonEntity,\n\ttype ViewmodelConfig,\n} from './first-person.behavior';\nimport { FirstPersonFSM, FirstPersonState } from './first-person-fsm';\nimport {\n\tcreateFirstPersonMovementComponent,\n\tcreateFirstPersonInputComponent,\n\tcreateFirstPersonStateComponent,\n} from './components';\nimport type { WasmStageRuntime } from '../../runtime/wasm-stage-runtime';\n\n/**\n * First-person controller behavior options (typed for entity.use() autocomplete).\n */\nexport interface FirstPersonControllerOptions {\n\t/** Base walking speed (default: 8) */\n\twalkSpeed?: number;\n\t/** Sprint/run speed (default: 16) */\n\trunSpeed?: number;\n\t/** Look sensitivity multiplier (default: 2) */\n\tlookSensitivity?: number;\n\t/** Eye height offset above entity position (default: 1.7) */\n\teyeHeight?: number;\n\t/** The FirstPersonPerspective to drive (from camera.getPerspective()) */\n\tperspective?: FirstPersonPerspective;\n\t/** Optional viewmodel (weapon/item) to position relative to the camera */\n\tviewmodel?: { entity: any; offset: Vec3Input; rotation?: Euler };\n}\n\nconst defaultOptions: FirstPersonControllerOptions = {\n\twalkSpeed: 8,\n\trunSpeed: 16,\n\tlookSensitivity: 2,\n\teyeHeight: 1.7,\n};\n\nconst FIRST_PERSON_BEHAVIOR_KEY = Symbol.for(\n\t'zylem:behavior:first-person-controller',\n);\n\n/**\n * Adapter that wraps FirstPersonControllerBehavior as a BehaviorSystem.\n */\nclass FirstPersonControllerSystem implements BehaviorSystem {\n\tprivate behavior: FirstPersonControllerBehavior;\n\tprivate attachedRuntimeSlots = new Set<number>();\n\n\tconstructor(\n\t\tprivate world: any,\n\t\tprivate wasmStage: WasmStageRuntime | null,\n\t\tprivate getBehaviorLinks?: (key: symbol) => Iterable<BehaviorEntityLink>,\n\t) {\n\t\tthis.behavior = new FirstPersonControllerBehavior(world);\n\t}\n\n\tupdate(_ecs: unknown, delta: number): void {\n\t\tconst links = this.getBehaviorLinks?.(FIRST_PERSON_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 fpsRef = link.ref as any;\n\n\t\t\tconst options = fpsRef.options as FirstPersonControllerOptions;\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\tconst input = gameEntity.$fps;\n\t\t\t\tif (input) {\n\t\t\t\t\tthis.wasmStage.setFirstPersonInput(handle, {\n\t\t\t\t\t\tmoveX: input.moveX ?? 0,\n\t\t\t\t\t\tmoveZ: input.moveZ ?? 0,\n\t\t\t\t\t\tlookYawDelta: input.lookX ?? 0,\n\t\t\t\t\t\tlookPitchDelta: input.lookY ?? 0,\n\t\t\t\t\t\trun: !!input.sprint,\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\t// Initialize components (once)\n\t\t\tif (!gameEntity.firstPerson) {\n\t\t\t\tgameEntity.firstPerson = createFirstPersonMovementComponent(options);\n\t\t\t}\n\n\t\t\tif (!gameEntity.$fps) {\n\t\t\t\tgameEntity.$fps = createFirstPersonInputComponent();\n\t\t\t}\n\n\t\t\tif (!gameEntity.firstPersonState) {\n\t\t\t\tgameEntity.firstPersonState = createFirstPersonStateComponent();\n\t\t\t}\n\n\t\t\t// Wire up perspective (once)\n\t\t\tif (options.perspective && !this.behavior.hasPerspective(gameEntity.uuid)) {\n\t\t\t\tthis.behavior.setPerspective(gameEntity.uuid, options.perspective);\n\t\t\t}\n\n\t\t\t// Wire up viewmodel (once)\n\t\t\tif (options.viewmodel && !this.behavior.hasViewmodel(gameEntity.uuid)) {\n\t\t\t\tthis.behavior.setViewmodel(gameEntity.uuid, {\n\t\t\t\t\t...options.viewmodel,\n\t\t\t\t\toffset: toThreeVector3(options.viewmodel.offset, VEC3_ZERO),\n\t\t\t\t} as ViewmodelConfig);\n\t\t\t}\n\n\t\t\t// Create FSM lazily\n\t\t\tif (!fpsRef.fsm && gameEntity.$fps && gameEntity.firstPersonState) {\n\t\t\t\tfpsRef.fsm = new FirstPersonFSM({\n\t\t\t\t\tinput: gameEntity.$fps,\n\t\t\t\t\tstate: gameEntity.firstPersonState,\n\t\t\t\t});\n\t\t\t}\n\n\t\t\t// Update FSM\n\t\t\tif (fpsRef.fsm && gameEntity.$fps && gameEntity.firstPersonState) {\n\t\t\t\tfpsRef.fsm.update(gameEntity.$fps, gameEntity.firstPersonState);\n\t\t\t}\n\n\t\t\tthis.behavior.updateEntity(gameEntity, delta);\n\t\t}\n\t}\n\n\tprivate ensureWasmAttached(handle: number, options: FirstPersonControllerOptions): void {\n\t\tif (!this.wasmStage || this.attachedRuntimeSlots.has(handle)) return;\n\t\tthis.wasmStage.attachFirstPerson(handle, {\n\t\t\twalkSpeed: options.walkSpeed ?? defaultOptions.walkSpeed!,\n\t\t\trunSpeed: options.runSpeed ?? defaultOptions.runSpeed!,\n\t\t\teyeHeight: options.eyeHeight ?? defaultOptions.eyeHeight!,\n\t\t\tlookSensitivity: options.lookSensitivity ?? defaultOptions.lookSensitivity!,\n\t\t});\n\t\tthis.attachedRuntimeSlots.add(handle);\n\t}\n\n\tdestroy(_ecs: unknown): void {\n\t\tthis.behavior.destroy();\n\t\tthis.attachedRuntimeSlots.clear();\n\t}\n}\n\n/**\n * FirstPersonController - typed descriptor for first-person movement and camera control.\n *\n * Provides complete first-person controller including:\n * - WASD movement relative to camera yaw\n * - Mouse look driving a FirstPersonPerspective\n * - Optional viewmodel positioning (weapon/item following camera)\n * - Walk/run state tracking via FSM\n *\n * @example\n * ```typescript\n * import { FirstPersonController } from \"@zylem/game-lib/behavior\";\n * import { createCamera, Perspectives, FirstPersonPerspective } from \"@zylem/game-lib/core\";\n * import { createActor } from \"@zylem/game-lib/entity\";\n *\n * const fpsCamera = createCamera({ perspective: Perspectives.FirstPerson, ... });\n * const fps = fpsCamera.getPerspective<FirstPersonPerspective>();\n *\n * const player = createActor({ name: 'player', ... });\n * const controller = player.use(FirstPersonController, {\n *   perspective: fps,\n *   walkSpeed: 8,\n *   runSpeed: 16,\n *   lookSensitivity: 2,\n * });\n *\n * // In update loop - write input, behavior handles the rest\n * player.onUpdate(({ inputs }) => {\n *   player.$fps.moveX = inputs.p1.axes.Horizontal.value;\n *   player.$fps.moveZ = inputs.p1.axes.Vertical.value;\n *   player.$fps.lookX = inputs.p1.axes.SecondaryHorizontal.value;\n *   player.$fps.lookY = inputs.p1.axes.SecondaryVertical.value;\n *   player.$fps.sprint = inputs.p1.shoulders.LTrigger.held > 0;\n * });\n * ```\n */\nexport const FirstPersonController = defineBehavior<\n\tFirstPersonControllerOptions,\n\t{\n\t\tgetState: () => FirstPersonState;\n\t\tgetYaw: () => number;\n\t\tgetPitch: () => number;\n\t\tattachViewmodel: (entity: any, offset: Vec3Input) => void;\n\t},\n\tFirstPersonEntity\n>({\n\tname: 'first-person-controller',\n\tdefaultOptions,\n\tsystemFactory: (ctx) =>\n\t\tnew FirstPersonControllerSystem(ctx.world, ctx.wasmStage ?? null, ctx.getBehaviorLinks),\n\tcreateHandle: (ref) => ({\n\t\tgetState: () => ref.fsm?.getState() ?? FirstPersonState.Idle,\n\t\tgetYaw: () => ref.fsm?.getYaw() ?? 0,\n\t\tgetPitch: () => ref.fsm?.getPitch() ?? 0,\n\t\tattachViewmodel: (entity: any, offset: Vec3Input) => {\n\t\t\tif (ref.options) {\n\t\t\t\tref.options.viewmodel = { entity, offset };\n\t\t\t}\n\t\t},\n\t}),\n});\n"],"mappings":"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","names":["FirstPersonState","FirstPersonEvent"]}

package/dist/components--hjBMTnz.d.ts

@@ -0,0 +1,120 @@
+/**
+ * Jumper 3D ECS Components
+ *
+ * Type definitions and factory functions for the 3D jump behavior system.
+ *
+ * - JumpConfig3D:  tunable parameters (stored as the capability component)
+ * - JumpInput3D:   per-tick intent written by the player/AI controller
+ * - JumpContext3D:  per-tick snapshot provided by the system adapter
+ * - JumpState3D:   internal runtime state owned by the behavior
+ */
+interface Vec3Like {
+    x: number;
+    y: number;
+    z: number;
+}
+interface JumpConfig3D {
+    /** Desired peak height in world units */
+    jumpHeight: number;
+    /** Gravity magnitude (positive, e.g. 20) */
+    gravity: number;
+    /** Terminal fall speed magnitude (optional) */
+    maxFallSpeed?: number;
+    /** 1 = single jump, 2 = double, etc. */
+    maxJumps: number;
+    /** Reset jump counter when grounded (usually true) */
+    resetJumpsOnGround: boolean;
+    /** Reset jump counter on wall contact (future wall-jump support) */
+    resetJumpsOnWall?: boolean;
+    /** Grace period after leaving ground where first jump is still allowed (ms) */
+    coyoteTimeMs: number;
+    /** Queue a jump press this many ms before landing (ms) */
+    jumpBufferMs: number;
+    /** Optional cooldown between consecutive jumps (ms) */
+    minTimeBetweenJumpsMs?: number;
+    /** Variable jump height via early release */
+    variableJump?: {
+        enabled: boolean;
+        /** Gravity multiplier applied when jump is released early while ascending */
+        cutGravityMultiplier: number;
+        /** Max hold duration before the cut triggers automatically (ms, optional) */
+        maxHoldMs?: number;
+    };
+    /** Optional planar (XZ) launch / air-control overrides */
+    planar?: {
+        /** One-time planar speed applied at takeoff */
+        launchPlanarSpeed?: number;
+        /** If true, preserve current planar speed instead of replacing it */
+        preservePlanarSpeed?: boolean;
+        airControl?: {
+            maxPlanarSpeed: number;
+            /** Acceleration per second while airborne */
+            acceleration: number;
+            /** Deceleration per second when no input */
+            deceleration: number;
+        };
+    };
+    /** Snappier descent tuning */
+    fall?: {
+        /** Gravity multiplier while falling (e.g. 1.5-2.5) */
+        fallGravityMultiplier: number;
+        /** Additional multiplier when fast-fall input is held */
+        fastFallMultiplier?: number;
+    };
+}
+declare function createJumpConfig3D(options?: Partial<JumpConfig3D>): JumpConfig3D;
+interface JumpInput3D {
+    /** True on the frame the jump button is first pressed (rising edge) */
+    jumpPressed: boolean;
+    /** True while the jump button is held down */
+    jumpHeld: boolean;
+    /** True on the frame the jump button is released (falling edge) */
+    jumpReleased: boolean;
+    /** Desired planar direction in world space (camera-relative), optional */
+    moveDirWorld?: Vec3Like;
+    /** Hold to drop faster (e.g. crouch / down input) */
+    fastFall?: boolean;
+}
+declare function createJumpInput3D(): JumpInput3D;
+interface JumpContext3D {
+    /** Frame delta in seconds */
+    dt: number;
+    /** World up direction (usually 0,1,0) */
+    up: Vec3Like;
+    /** Current vertical (Y) velocity of the entity */
+    velocityY: number;
+    /** Current horizontal velocity of the entity (read from body) */
+    horizontalVelocity: {
+        x: number;
+        z: number;
+    };
+    /** Whether the entity is on the ground */
+    isGrounded: boolean;
+    /** Surface normal at ground contact (optional) */
+    groundNormal?: Vec3Like;
+    /** Time since entity was last grounded (ms) */
+    timeSinceGroundedMs: number;
+    /** Set only the vertical (Y) component of velocity */
+    setVerticalVelocity(y: number): void;
+    /** Set only the horizontal (X/Z) components of velocity */
+    setHorizontalVelocity(x: number, z: number): void;
+}
+interface JumpState3D {
+    /** Number of jumps consumed since last reset */
+    jumpsUsed: number;
+    /** Timestamp (ms) of the most recent jump execution */
+    lastJumpTimeMs: number;
+    /** Remaining ms in the jump-buffer window (counts down) */
+    bufferedJumpMs: number;
+    /** Remaining ms in the coyote-time window (counts down) */
+    coyoteMs: number;
+    /** True while the entity is in a jump arc (ascending phase) */
+    isJumping: boolean;
+    /** Elapsed ms since jump button was first held (for variable jump) */
+    jumpHoldMs: number;
+    /** Whether the variable-jump cut has already been applied this jump */
+    jumpCutApplied: boolean;
+}
+declare function createJumpState3D(): JumpState3D;
+
+export { type JumpConfig3D as J, type Vec3Like as V, type JumpContext3D as a, type JumpInput3D as b, type JumpState3D as c, createJumpConfig3D as d, createJumpInput3D as e, createJumpState3D as f };

package/dist/components-B29WHGQN.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Thruster-specific ECS Components
+ *
+ * These components are specific to the thruster movement system.
+ */
+interface ThrusterMovementComponent {
+    /** Linear thrust force in Newtons (or scaled units) */
+    linearThrust: number;
+    /** Angular thrust torque scalar */
+    angularThrust: number;
+    /** Optional linear damping override */
+    linearDamping?: number;
+    /** Optional angular damping override */
+    angularDamping?: number;
+}
+declare function createThrusterMovementComponent(linearThrust: number, angularThrust: number, options?: {
+    linearDamping?: number;
+    angularDamping?: number;
+}): ThrusterMovementComponent;
+interface ThrusterInputComponent {
+    /** Forward thrust intent: 0..1 */
+    thrust: number;
+    /** Rotation intent: -1..1 */
+    rotate: number;
+    /** World-space X thrust intent: -1..1 */
+    thrustX: number;
+    /** World-space Y thrust intent: -1..1 */
+    thrustY: number;
+}
+declare function createThrusterInputComponent(): ThrusterInputComponent;
+interface ThrusterStateComponent {
+    /** Whether the thruster is enabled */
+    enabled: boolean;
+    /** Current thrust after FSM/gating */
+    currentThrust: number;
+}
+declare function createThrusterStateComponent(): ThrusterStateComponent;
+
+export { type ThrusterInputComponent as T, type ThrusterMovementComponent as a, type ThrusterStateComponent as b, createThrusterInputComponent as c, createThrusterMovementComponent as d, createThrusterStateComponent as e };

package/dist/components-BWG1GkZA.d.ts

@@ -0,0 +1,20 @@
+import { RigidBody } from '@dimforge/rapier3d-compat';
+import { Vector3, Quaternion } from 'three';
+
+/**
+ * Core behavior helper types
+ *
+ * Plain data interfaces shared by movement behaviors and coordinators.
+ */
+
+interface TransformComponent {
+    position: Vector3;
+    rotation: Quaternion;
+}
+declare function createTransformComponent(): TransformComponent;
+interface PhysicsBodyComponent {
+    body: RigidBody;
+}
+declare function createPhysicsBodyComponent(body: RigidBody): PhysicsBodyComponent;
+
+export { type PhysicsBodyComponent as P, type TransformComponent as T, createTransformComponent as a, createPhysicsBodyComponent as c };

package/dist/components-XCpL6IYt.d.ts

@@ -0,0 +1,18 @@
+interface TopDownMovementComponent {
+    moveSpeed: number;
+}
+declare function createTopDownMovementComponent(options?: Partial<TopDownMovementComponent>): TopDownMovementComponent;
+interface TopDownMovementInputComponent {
+    moveX: number;
+    moveY: number;
+    faceX: number;
+    faceY: number;
+}
+declare function createTopDownMovementInputComponent(): TopDownMovementInputComponent;
+interface TopDownMovementStateComponent {
+    facingAngle: number;
+    moving: boolean;
+}
+declare function createTopDownMovementStateComponent(): TopDownMovementStateComponent;
+
+export { type TopDownMovementComponent as T, type TopDownMovementInputComponent as a, type TopDownMovementStateComponent as b, createTopDownMovementComponent as c, createTopDownMovementInputComponent as d, createTopDownMovementStateComponent as e };

package/dist/components-qWwOsvwh.d.ts

@@ -0,0 +1,43 @@
+/**
+ * First Person Controller ECS Components
+ *
+ * Components for first-person movement and camera control:
+ * - Movement configuration (walk/run speed, sensitivity, eye height)
+ * - Input intent (WASD movement + mouse look deltas)
+ * - Runtime state (yaw, pitch, speed)
+ */
+interface FirstPersonMovementComponent {
+    /** Base walking speed (units/sec) */
+    walkSpeed: number;
+    /** Sprint/run speed (units/sec) */
+    runSpeed: number;
+    /** Look sensitivity multiplier applied to raw input deltas */
+    lookSensitivity: number;
+    /** Vertical offset above entity position for eye/camera placement */
+    eyeHeight: number;
+}
+declare function createFirstPersonMovementComponent(options?: Partial<FirstPersonMovementComponent>): FirstPersonMovementComponent;
+interface FirstPersonInputComponent {
+    /** Horizontal movement input (-1 to 1, strafe) */
+    moveX: number;
+    /** Forward/backward movement input (-1 to 1) */
+    moveZ: number;
+    /** Horizontal look delta (mouse/stick, raw value before sensitivity) */
+    lookX: number;
+    /** Vertical look delta (mouse/stick, raw value before sensitivity) */
+    lookY: number;
+    /** Sprint button held */
+    sprint: boolean;
+}
+declare function createFirstPersonInputComponent(): FirstPersonInputComponent;
+interface FirstPersonStateComponent {
+    /** Current yaw in radians */
+    yaw: number;
+    /** Current pitch in radians */
+    pitch: number;
+    /** Current movement speed being applied */
+    currentSpeed: number;
+}
+declare function createFirstPersonStateComponent(): FirstPersonStateComponent;
+
+export { type FirstPersonInputComponent as F, type FirstPersonMovementComponent as a, type FirstPersonStateComponent as b, createFirstPersonInputComponent as c, createFirstPersonMovementComponent as d, createFirstPersonStateComponent as e };