@woosh/meep-engine 2.138.19 → 2.139.0

package/src/engine/control/first-person/FirstPersonPlayerController.d.ts

@@ -16,6 +16,21 @@ export class FirstPersonPlayerController {
     state: FirstPersonState;
     pose: FirstPersonPose;
     signals: FirstPersonSignals;
+    /**
+     * Mastery layer — registry of {@link MasteryEvaluator}s and the
+     * telemetry score they feed. Designers register evaluators here;
+     * the controller's system queries them at each decision point.
+     * Empty by default (no mastery effects unless the game adds them).
+     * @type {MasterySet}
+     */
+    mastery: MasterySet;
+    /**
+     * Movement abilities (wall-run, mantle, slide, etc.). Empty by
+     * default — base locomotion is unchanged unless the game adds
+     * abilities here.
+     * @type {AbilitySet}
+     */
+    abilities: AbilitySet;
     /**
      * ID of the entity carrying the eye Transform + Camera. Created by
      * the system on link if -1. Held as a plain number rather than
@@ -29,17 +44,22 @@ export class FirstPersonPlayerController {
             body: {
                 height: number;
                 crouchHeight: number;
+                proneHeight: number;
                 radius: number;
                 mass: number;
+                referenceMass: number;
+                massCouplingStrength: number;
             };
             motion: {
-                walkSpeed: number; /** Hold state — true while jump button is held. @type {boolean} */
+                walkSpeed: number;
                 sprintSpeed: number;
                 crouchSpeed: number;
                 airControl: number;
                 groundAccel: number;
                 groundDecel: number;
                 airAccel: number;
+                backwardSpeedFactor: number;
+                backwardAccelFactor: number;
             };
             jump: {
                 anticipation: {
@@ -50,14 +70,14 @@ export class FirstPersonPlayerController {
                 timeToApex: number;
                 coyoteTime: number;
                 bufferTime: number;
-                fallGravityMult: number;
+                fallGravityMult: number; /** {verticalSpeed:number, kind:"soft"|"hard"} */
                 cutGravityMult: number;
             };
             landing: {
                 recovery: {
                     spring: {
                         halfLife: number;
-                        zeta: number; /** {verticalSpeed:number, kind:"soft"|"hard"} */
+                        zeta: number;
                     };
                     dipPerVy: number;
                     dipMax: number;
@@ -69,6 +89,39 @@ export class FirstPersonPlayerController {
                 transitionTime: number;
                 mode: string;
             };
+            ledgeGrab: {
+                hangOffsetY: number;
+                hangOffsetForward: number;
+                exertionRiseRate: number;
+                minAirborneTime: number;
+                mantleUpUpFactor: number;
+            };
+            mantle: {
+                minHeight: number;
+                maxHeight: number;
+                duration: number;
+                forwardOffsetOnLand: number;
+            };
+            wallRun: {
+                minSpeed: number;
+                minAirborneTime: number;
+                maxDuration: number;
+                gravityFactor: number;
+                cameraRollDeg: number;
+            };
+            wallJump: {
+                outwardImpulse: number;
+                upFactor: number;
+                nearWallMaxDistance: number;
+            };
+            slide: {
+                minEntrySpeed: number;
+                endSpeed: number;
+                friction: number;
+                startupWindow: number;
+                slideJumpUpFactor: number;
+                entryImpactVelocity: number;
+            };
             bob: {
                 stepFreqAtWalk: number;
                 stepFreqExp: number;
@@ -77,6 +130,14 @@ export class FirstPersonPlayerController {
                 ampMassScale: number;
                 rollAtWalkDeg: number;
                 minStepSpeed: number;
+                intensityHalfLife: number;
+                impactSpringHalfLife: number;
+                impactSpringZeta: number;
+                impactKickMultiplier: number;
+                backwardVerticalAmpFactor: number;
+                backwardLateralAmpFactor: number;
+                backwardRollFactor: number;
+                leanCouplingFactor: number;
             };
             breath: {
                 rateRestHz: number;
@@ -86,13 +147,21 @@ export class FirstPersonPlayerController {
                 pitchAmpRestDeg: number;
                 pitchAmpMaxDeg: number;
                 noiseAmount: number;
+                locomotorCouplingMax: number;
+                couplingMinStrideFreqHz: number;
             };
             exertion: {
                 sprintRiseRate: number;
-                jumpRise: number;
                 idleDecayRate: number;
+                jumpRise: number;
+                crouchEnterRise: number;
+                landImpulsePerVy: number;
+                landImpulseMax: number;
                 rateDecayHalfLife: number;
                 ampDecayHalfLife: number;
+                bobLateralBoostAtMax: number;
+                headDroopAtMaxDeg: number;
+                headDroopHalfLife: number;
             };
             lean: {
                 spring: {
@@ -101,6 +170,10 @@ export class FirstPersonPlayerController {
                 };
                 enabled: boolean;
                 maxRollDeg: number;
+                lookLeanEnabled: boolean;
+                lookLeanDegPerRadPerSec: number;
+                lookLeanYawRateClamp: number;
+                crouchLookLeanFactor: number;
             };
             fov: {
                 base: number;
@@ -111,9 +184,12 @@ export class FirstPersonPlayerController {
             look: {
                 pitchMinDeg: number;
                 pitchMaxDeg: number;
-                invertY: boolean; /**
-                 * @param {FirstPersonPlayerController} other
-                 */
+                invertY: boolean;
+            };
+            posture: {
+                sprintForwardPitchDeg: number;
+                sprintForwardPitchHalfLife: number;
+                sprintForwardShiftM: number;
             };
             gravity: {
                 magnitude: number;
@@ -131,6 +207,7 @@ export class FirstPersonPlayerController {
 }
 export namespace FirstPersonPlayerController {
     export { FirstPersonActionState as ActionState };
+    export { FirstPersonLocomotionMode as LocomotionMode };
 }
 import { FirstPersonPlayerControllerConfig } from "./FirstPersonPlayerControllerConfig.js";
 /**
@@ -171,8 +248,8 @@ declare class FirstPersonState {
     speed: number;
     /** [0..1] vs sprint speed — drives bob amp and FOV kick. */
     speedNormalized: number;
-    /** "Idle" | "Walk" | "Sprint" | "Crouch" | "Air" */
-    moveMode: string;
+    /** Horizontal locomotion mode. See {@link FirstPersonLocomotionMode}. */
+    locomotionMode: number;
     verticalSpeed: number;
     airborneTime: number;
     fallDistance: number;
@@ -194,6 +271,15 @@ declare class FirstPersonState {
     crouchBlocked: boolean;
     /** True while in crouch pose (independent of intent — see crouchBlocked). */
     crouchActive: boolean;
+    /**
+     * Body posture. Set each tick by whichever layer owns motion: the
+     * base derives Stand/Crouch from intent; an active ability can
+     * force Prone (slide) or Hang (ledge-grab). See
+     * {@link FirstPersonPosture}. Drives eye-height target and gait
+     * gating (stride, footsteps, bob).
+     * @type {number}
+     */
+    posture: number;
     leanRollRad: number;
 }
 import { FirstPersonPose } from "./pose/FirstPersonPose.js";
@@ -220,8 +306,15 @@ declare class FirstPersonSignals {
     onBreathIn: Signal<any, any, any, any, any, any, any, any>;
     /** {amplitude:number, rateHz:number} fired at peak exhale (phase 0.75). */
     onBreathOut: Signal<any, any, any, any, any, any, any, any>;
+    /** {ledgeHeight:number} — fired when LedgeGrab activates. */
+    onLedgeGrab: Signal<any, any, any, any, any, any, any, any>;
+    /** {reason:"mantle-up"|"drop"|"slip"|"shuffle-off"} */
+    onLedgeRelease: Signal<any, any, any, any, any, any, any, any>;
 }
+import { MasterySet } from "./mastery/MasterySet.js";
+import { AbilitySet } from "./abilities/AbilitySet.js";
 import { FirstPersonActionState } from "./pose/FirstPersonPose.js";
+import { FirstPersonLocomotionMode } from "./pose/FirstPersonPose.js";
 import Vector2 from "../../../core/geom/Vector2.js";
 import Vector3 from "../../../core/geom/Vector3.js";
 import Signal from "../../../core/events/signal/Signal.js";

package/src/engine/control/first-person/FirstPersonPlayerController.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FirstPersonPlayerController.d.ts","sourceRoot":"","sources":["../../../../../src/engine/control/first-person/FirstPersonPlayerController.js"],"names":[],"mappings":"AA6GA;;;;;;;;;;GAUG;AACH;IACI,wBAAgD;IAG5C,0CAAqD;IACrD,0BAAqC;IACrC,wBAAmC;IACnC,sBAAiC;IACjC,4BAAuC;IAEvC;;;;;;OAMG;IACH,WAFU,MAAM,CAEG;IAGvB;;;;;;;;;mCAlHA,mEAAmE;;;;;;;;;;;;;;;;;;;;;;;;sCAuEnE,iDAAiD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kCAqDjD;;mBAEG;;;;;;MAVF;IAED,0BAIC;IAED;;OAEG;IACH,YAFW,2BAA2B,QAKrC;IAED,qCAIC;IAED,4BAGC;IAED,eAGC;CACJ;;;;kDA1KiD,wCAAwC;AAG1F;;;;;;;;GAQG;AACH;IACI,oEAAoE;IACpE,MADyD,OAAO,CACvC;IAEzB;;;;OAIG;IACH,MAFU,OAAO,CAEQ;IAEzB,mEAAmE;IACnE,MADwD,OAAO,CAClD;IAEb,0EAA0E;IAC1E,QAD+D,OAAO,CACvD;IAEf,qEAAqE;IACrE,QAD0D,OAAO,CAClD;CAClB;AAED;;;GAGG;AACH;IACI,kBAAgB;IAChB,0BAAsB;IAEtB,4EAA4E;IAC5E,sBAAoC;IACpC,gBAAkB;IAElB,cAAU;IACV,4DAA4D;IAC5D,wBAAoB;IACpB,oDAAoD;IACpD,iBAAkB;IAElB,sBAAkB;IAClB,qBAAiB;IACjB,qBAAiB;IAEjB,4BAAwB;IACxB,4BAA2B;IAC3B,2BAA0B;IAC1B,2EAA2E;IAC3E,qBAAoB;IAEpB,iBAAa;IACb,oBAAgB;IAChB,qBAAiB;IACjB,yBAAqB;IAErB,oBAAgB;IAChB,kBAAc;IACd,kDAAkD;IAClD,iBAAa;IAEb,kBAAiB;IAEjB,+EAA+E;IAC/E,uBAAsB;IACtB,6EAA6E;IAC7E,sBAAqB;IAErB,oBAAgB;CACnB;gCA9EuD,2BAA2B;AAgFnF;;;GAGG;AACH;IACI,uDAAuD;IACvD,2DAA0B;IAC1B,yEAAyE;IACzE,4DAA2B;IAC3B,kBAAkB;IAClB,2DAA0B;IAC1B,6BAA6B;IAC7B,8DAA6B;IAC7B,iDAAiD;IACjD,uDAAsB;IACtB,8DAA6B;IAC7B,6DAA4B;IAC5B,8DAA6B;IAC7B,6DAA4B;IAC5B,2EAA2E;IAC3E,2DAA0B;IAC1B,2EAA2E;IAC3E,4DAA2B;CAC9B;uCAvGuD,2BAA2B;oBAH/D,+BAA+B;oBAC/B,+BAA+B;mBAFhC,uCAAuC"}
+{"version":3,"file":"FirstPersonPlayerController.d.ts","sourceRoot":"","sources":["../../../../../src/engine/control/first-person/FirstPersonPlayerController.js"],"names":[],"mappings":"AA8HA;;;;;;;;;;GAUG;AACH;IACI,wBAAgD;IAG5C,0CAAqD;IACrD,0BAAqC;IACrC,wBAAmC;IACnC,sBAAiC;IACjC,4BAAuC;IAEvC;;;;;;OAMG;IACH,SAFU,UAAU,CAEW;IAE/B;;;;;OAKG;IACH,WAFU,UAAU,CAEa;IAEjC;;;;;;OAMG;IACH,WAFU,MAAM,CAEG;IAGvB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yCAhEA,iDAAiD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAkEhD;IAED,0BAIC;IAED;;OAEG;IACH,YAFW,2BAA2B,QAKrC;IAED,qCAIC;IAED,4BAGC;IAED,eAGC;CACJ;;;;;kDA3MiD,wCAAwC;AAK1F;;;;;;;;GAQG;AACH;IACI,oEAAoE;IACpE,MADyD,OAAO,CACvC;IAEzB;;;;OAIG;IACH,MAFU,OAAO,CAEQ;IAEzB,mEAAmE;IACnE,MADwD,OAAO,CAClD;IAEb,0EAA0E;IAC1E,QAD+D,OAAO,CACvD;IAEf,qEAAqE;IACrE,QAD0D,OAAO,CAClD;CAClB;AAED;;;GAGG;AACH;IACI,kBAAgB;IAChB,0BAAsB;IAEtB,4EAA4E;IAC5E,sBAAoC;IACpC,gBAAkB;IAElB,cAAU;IACV,4DAA4D;IAC5D,wBAAoB;IACpB,yEAAyE;IACzE,uBAAgD;IAEhD,sBAAkB;IAClB,qBAAiB;IACjB,qBAAiB;IAEjB,4BAAwB;IACxB,4BAA2B;IAC3B,2BAA0B;IAC1B,2EAA2E;IAC3E,qBAAoB;IAEpB,iBAAa;IACb,oBAAgB;IAChB,qBAAiB;IACjB,yBAAqB;IAErB,oBAAgB;IAChB,kBAAc;IACd,kDAAkD;IAClD,iBAAa;IAEb,kBAAiB;IAEjB,+EAA+E;IAC/E,uBAAsB;IACtB,6EAA6E;IAC7E,sBAAqB;IAErB;;;;;;;OAOG;IACH,SAFU,MAAM,CAEmB;IAEnC,oBAAgB;CACnB;gCAzFkF,2BAA2B;AA2F9G;;;GAGG;AACH;IACI,uDAAuD;IACvD,2DAA0B;IAC1B,yEAAyE;IACzE,4DAA2B;IAC3B,kBAAkB;IAClB,2DAA0B;IAC1B,6BAA6B;IAC7B,8DAA6B;IAC7B,iDAAiD;IACjD,uDAAsB;IACtB,8DAA6B;IAC7B,6DAA4B;IAC5B,8DAA6B;IAC7B,6DAA4B;IAC5B,2EAA2E;IAC3E,2DAA0B;IAC1B,2EAA2E;IAC3E,4DAA2B;IAC3B,6DAA6D;IAC7D,4DAA2B;IAC3B,uDAAuD;IACvD,+DAA8B;CACjC;2BAvH0B,yBAAyB;2BAFzB,2BAA2B;uCAG6B,2BAA2B;0CAA3B,2BAA2B;oBAL1F,+BAA+B;oBAC/B,+BAA+B;mBAFhC,uCAAuC"}

package/src/engine/control/first-person/FirstPersonPlayerController.js

@@ -1,8 +1,11 @@
 import Signal from "../../../core/events/signal/Signal.js";
 import Vector2 from "../../../core/geom/Vector2.js";
 import Vector3 from "../../../core/geom/Vector3.js";
+import { AbilitySet } from "./abilities/AbilitySet.js";
 import { FirstPersonPlayerControllerConfig } from "./FirstPersonPlayerControllerConfig.js";
-import { FirstPersonActionState, FirstPersonPose } from "./pose/FirstPersonPose.js";
+import { MasterySet } from "./mastery/MasterySet.js";
+import { FirstPersonActionState, FirstPersonLocomotionMode, FirstPersonPose } from "./pose/FirstPersonPose.js";
+import { FirstPersonPosture } from "./pose/FirstPersonPosture.js";
 
 /**
  * Intent — what the player (or AI) wants the body to do. All fields are
@@ -49,8 +52,8 @@ class FirstPersonState {
     speed = 0;
     /** [0..1] vs sprint speed — drives bob amp and FOV kick. */
     speedNormalized = 0;
-    /** "Idle" | "Walk" | "Sprint" | "Crouch" | "Air" */
-    moveMode = "Idle";
+    /** Horizontal locomotion mode. See {@link FirstPersonLocomotionMode}. */
+    locomotionMode = FirstPersonLocomotionMode.Idle;
 
     verticalSpeed = 0;
     airborneTime = 0;
@@ -79,6 +82,16 @@ class FirstPersonState {
     /** True while in crouch pose (independent of intent — see crouchBlocked). */
     crouchActive = false;
 
+    /**
+     * Body posture. Set each tick by whichever layer owns motion: the
+     * base derives Stand/Crouch from intent; an active ability can
+     * force Prone (slide) or Hang (ledge-grab). See
+     * {@link FirstPersonPosture}. Drives eye-height target and gait
+     * gating (stride, footsteps, bob).
+     * @type {number}
+     */
+    posture = FirstPersonPosture.Stand;
+
     leanRollRad = 0;
 }
 
@@ -105,6 +118,10 @@ class FirstPersonSignals {
     onBreathIn = new Signal();
     /** {amplitude:number, rateHz:number} fired at peak exhale (phase 0.75). */
     onBreathOut = new Signal();
+    /** {ledgeHeight:number} — fired when LedgeGrab activates. */
+    onLedgeGrab = new Signal();
+    /** {reason:"mantle-up"|"drop"|"slip"|"shuffle-off"} */
+    onLedgeRelease = new Signal();
 }
 
 /**
@@ -128,6 +145,23 @@ export class FirstPersonPlayerController {
         this.pose = new FirstPersonPose();
         this.signals = new FirstPersonSignals();
 
+        /**
+         * Mastery layer — registry of {@link MasteryEvaluator}s and the
+         * telemetry score they feed. Designers register evaluators here;
+         * the controller's system queries them at each decision point.
+         * Empty by default (no mastery effects unless the game adds them).
+         * @type {MasterySet}
+         */
+        this.mastery = new MasterySet();
+
+        /**
+         * Movement abilities (wall-run, mantle, slide, etc.). Empty by
+         * default — base locomotion is unchanged unless the game adds
+         * abilities here.
+         * @type {AbilitySet}
+         */
+        this.abilities = new AbilitySet();
+
         /**
          * ID of the entity carrying the eye Transform + Camera. Created by
          * the system on link if -1. Held as a plain number rather than
@@ -174,3 +208,4 @@ export class FirstPersonPlayerController {
 }
 
 FirstPersonPlayerController.ActionState = FirstPersonActionState;
+FirstPersonPlayerController.LocomotionMode = FirstPersonLocomotionMode;