reze-engine 0.32.1 → 0.32.2

package/dist/locomotion.d.ts

@@ -90,6 +90,10 @@ export interface LocomotionOptions {
     turnTimeScale?: number;
     /** Playback rate for stop clips (default 1.25) — same reasoning. */
     stopTimeScale?: number;
+    /** Seconds a heading must be held before a release earns an authored stop
+     *  (default 0.5). Below it, weaving direction changes blend to idle instead
+     *  of skidding metres along the last-held heading. */
+    stopCommitTime?: number;
     /** Tank-mode steering rate, radians/second (default 2.5 ≈ 143°/s). */
     steerRate?: number;
     /** Backpedal speed as a fraction of run speed in tank mode (default 0.5). */
@@ -123,11 +127,15 @@ export declare class LocomotionController {
     private readonly turnClipMinAngle;
     private readonly turnTimeScale;
     private readonly stopTimeScale;
+    private readonly stopCommitTime;
     private turning;
     private runTurning;
     /** An interrupted authored clip fading out OVER resumed locomotion, so breaking
      *  out of a stop is instantly responsive without a pose pop. */
     private exitGhost;
+    private headingHold;
+    private headingDirX;
+    private headingDirY;
     private stopping;
     private readonly turnEntries;
     private readonly yawOffset;

package/dist/locomotion.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"locomotion.d.ts","sourceRoot":"","sources":["../src/locomotion.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"locomotion.d.ts","sourceRoot":"","sources":["../src/locomotion.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAC/B,OAAO,EAAO,KAAK,UAAU,EAAE,MAAM,aAAa,CAAA;AAClD,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AAEnC,MAAM,WAAW,eAAe;IAC9B,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAA;IACZ,kGAAkG;IAClG,KAAK,EAAE,MAAM,CAAA;IACb,kGAAkG;IAClG,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,aAAa;IAC5B,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAA;IACZ,8EAA8E;IAC9E,KAAK,EAAE,MAAM,CAAA;IACb,oFAAoF;IACpF,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAA;IACZ,gFAAgF;IAChF,KAAK,EAAE,MAAM,CAAA;IACb,6EAA6E;IAC7E,QAAQ,EAAE,MAAM,CAAA;IAChB;qFACiF;IACjF,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,IAAI,EAAE,KAAK,GAAG,QAAQ,CAAA;IACtB,IAAI,EAAE,GAAG,GAAG,GAAG,CAAA;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAA;IACZ,gFAAgF;IAChF,QAAQ,EAAE,MAAM,CAAA;IAChB;8EAC0E;IAC1E,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,IAAI,EAAE,KAAK,GAAG,QAAQ,CAAA;IACtB,IAAI,EAAE,GAAG,GAAG,GAAG,CAAA;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;kEAC8D;IAC9D,SAAS,CAAC,EAAE,eAAe,EAAE,CAAA;IAC7B,YAAY,CAAC,EAAE,eAAe,EAAE,CAAA;IAChC;;mFAE+E;IAC/E,WAAW,CAAC,EAAE,aAAa,EAAE,CAAA;IAC7B;;;qCAGiC;IACjC,OAAO,CAAC,EAAE,gBAAgB,EAAE,CAAA;IAC5B;;wEAEoE;IACpE,IAAI,CAAC,EAAE,aAAa,EAAE,CAAA;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC;;oEAEgE;IAChE,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB;;qDAEiD;IACjD,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,iFAAiF;IACjF,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,sFAAsF;IACtF,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,uEAAuE;IACvE,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB;iFAC6E;IAC7E,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAC7B;+EAC2E;IAC3E,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB;2CACuC;IACvC,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,oEAAoE;IACpE,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB;;0DAEsD;IACtD,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,6EAA6E;IAC7E,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB;qEACiE;IACjE,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;iEAEiE;AACjE,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,IAAI,CAAA;IACd,wDAAwD;IACxD,GAAG,EAAE,MAAM,CAAA;IACX,uEAAuE;IACvE,QAAQ,EAAE,IAAI,CAAA;IACd,qDAAqD;IACrD,UAAU,EAAE,MAAM,CAAA;CACnB;AAaD,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAO;IAC7B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAiB;IACvC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAQ;IACjC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAQ;IACpC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAQ;IACtC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAQ;IACrC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAQ;IACzC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAQ;IACzC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAQ;IACtC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAQ;IACtC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAQ;IACvC,OAAO,CAAC,OAAO,CAAsD;IACrE,OAAO,CAAC,UAAU,CAOH;IACf;oEACgE;IAChE,OAAO,CAAC,SAAS,CAAmE;IACpF,OAAO,CAAC,WAAW,CAAI;IACvB,OAAO,CAAC,WAAW,CAAI;IACvB,OAAO,CAAC,WAAW,CAAI;IACvB,OAAO,CAAC,QAAQ,CAkBD;IACf,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAC1C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAQ;IAElC,OAAO,CAAC,MAAM,CAAI;IAClB,OAAO,CAAC,MAAM,CAAI;IAClB,OAAO,CAAC,WAAW,CAAQ;IAE3B,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,YAAY,CAAI;IACxB,OAAO,CAAC,UAAU,CAAI;IACtB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAQ;IAClC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAQ;IAEvC,OAAO,CAAC,UAAU,CAAI;IACtB;;4EAEwE;IACxE,OAAO,CAAC,WAAW,CAAI;IACvB,OAAO,CAAC,GAAG,CAAI;IAIf,OAAO,CAAC,IAAI,CAAI;IAChB,OAAO,CAAC,IAAI,CAAI;IAChB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoB;IAC7C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAuB;IAChD,OAAO,CAAC,QAAQ,CAAI;IACpB,OAAO,CAAC,SAAS,CAAI;IAErB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAc;IACtC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAgB;IAErC,OAAO,CAAC,SAAS,CAAsB;IACvC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA0B;IACpD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA0B;IACvD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAc;gBAEhC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,iBAAiB;IAmC7E;;yDAEqD;IACrD,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,UAAQ,GAAG,IAAI;IAYnD;;;2EAGuE;IACvE,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,UAAQ,GAAG,IAAI;IAO9D,sDAAsD;IACtD,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,SAAI,GAAG,IAAI;IAKxD;;iEAE6D;IAC7D,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAInC,WAAW,IAAI,IAAI;IAInB,4FAA4F;IAC5F,MAAM,IAAI,IAAI;IAKd;gFAC4E;IAC5E,eAAe,IAAI,UAAU,EAAE,GAAG,IAAI;IAItC,OAAO,CAAC,IAAI;IAKZ,OAAO,CAAC,YAAY;IAKpB;+EAC2E;IAC3E,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc;IAkPlC;+EAC2E;IAC3E,OAAO,CAAC,QAAQ;IAYhB;;mFAE+E;IAC/E,OAAO,CAAC,YAAY;IA2FpB;;;4EAGwE;IACxE,OAAO,CAAC,cAAc;IA6CtB;;wDAEoD;IACpD,OAAO,CAAC,UAAU;IA4ElB,4EAA4E;IAC5E,OAAO,CAAC,MAAM,CAAC,SAAS;IAQxB;;;kEAG8D;IAC9D,OAAO,CAAC,aAAa;CAkDtB"}

package/dist/locomotion.js

@@ -23,6 +23,9 @@ export class LocomotionController {
         /** An interrupted authored clip fading out OVER resumed locomotion, so breaking
          *  out of a stop is instantly responsive without a pose pop. */
         this.exitGhost = null;
+        this.headingHold = 0;
+        this.headingDirX = 0;
+        this.headingDirY = 0;
         this.stopping = null;
         this.inputX = 0;
         this.inputY = 0;
@@ -59,6 +62,7 @@ export class LocomotionController {
         this.turnClipMinAngle = options?.turnClipMinAngle ?? (100 * Math.PI) / 180;
         this.turnTimeScale = options?.turnTimeScale ?? 1.4;
         this.stopTimeScale = options?.stopTimeScale ?? 1.25;
+        this.stopCommitTime = options?.stopCommitTime ?? 0.5;
         this.turnEntries = [
             { name: clips.idle, time: 0, weight: 0 },
             { name: clips.idle, time: 0, weight: 1 },
@@ -176,12 +180,30 @@ export class LocomotionController {
             const m = Math.hypot(this.inputX, this.inputY);
             moving = m > 0.05;
             this.recentSpeed = Math.max(this.speedLevel, this.recentSpeed - dt * 1.5);
+            // How long the CURRENT heading has been held. An authored skid is the
+            // ending of a committed run; weaving through directions (D, then S+D,
+            // then S) rebuilds throttle in each new heading but earns no such
+            // ending — playing one there slides her metres along whichever way she
+            // happened to face last, which reads as drift.
+            if (moving) {
+                const dx = this.inputX / m;
+                const dy = this.inputY / m;
+                this.headingHold =
+                    this.headingDirX * dx + this.headingDirY * dy > 0.94 ? this.headingHold + dt : 0;
+                this.headingDirX = dx;
+                this.headingDirY = dy;
+            }
             // Release at speed: play the authored stop instead of blending to idle.
             const stops = this.clips.stop;
             // Gate on the peak-hold speed: the release decay (throttle/analog) drains the
             // instantaneous level below any threshold before `moving` goes false. The
             // small floor on the actual level keeps standstill taps from faking a skid.
-            if (!moving && stops && stops.length > 0 && this.recentSpeed >= 0.7 && this.speedLevel >= 0.35) {
+            if (!moving &&
+                stops &&
+                stops.length > 0 &&
+                this.recentSpeed >= 0.7 &&
+                this.speedLevel >= 0.35 &&
+                this.headingHold >= this.stopCommitTime) {
                 const gear = this.recentSpeed > 1.4 ? "sprint" : "run";
                 const foot = this.gaitPhase < 0.5 ? "L" : "R";
                 // Gear must match exactly: supplying stops for only one gear means the
@@ -207,6 +229,13 @@ export class LocomotionController {
                         dirX: this.dirX,
                         dirZ: this.dirZ,
                         startLevel: Math.min(this.recentSpeed, 2),
+                        // How much of the authored skid this stop has earned. Each profile
+                        // was captured at ITS gear's full speed (run = level 1, sprint =
+                        // level 2), so compare like with like. Entering slower — or moments
+                        // after a direction change, when the peak-hold still remembers the
+                        // PREVIOUS heading's sprint — must not replay the full slide.
+                        // Floored so a stop always still reads as a stop.
+                        scale: Math.max(0.3, Math.min(1, this.speedLevel / (best.gear === "sprint" ? 2 : 1))),
                         fromIdleW: Math.max(0, 1 - this.speedLevel),
                         fromClip,
                         fromTime: this.gaitPhase * this.clipDuration(fromClip),
@@ -512,7 +541,7 @@ export class LocomotionController {
         }
         t.time += dt * this.stopTimeScale;
         const clipT = Math.min(t.time, entry.exitTime);
-        const fwd = LocomotionController.profileAt(entry.forward, clipT / entry.exitTime);
+        const fwd = LocomotionController.profileAt(entry.forward, clipT / entry.exitTime) * t.scale;
         this.position.x = t.startX + t.dirX * fwd;
         this.position.z = t.startZ + t.dirZ * fwd;
         this.speedLevel = t.startLevel * Math.max(0, 1 - t.time / entry.exitTime);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "reze-engine",
-  "version": "0.32.1",
+  "version": "0.32.2",
   "description": "A lightweight WebGPU engine for real-time 3D MMD/PMX model rendering",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

package/src/locomotion.ts

@@ -102,6 +102,10 @@ export interface LocomotionOptions {
   turnTimeScale?: number
   /** Playback rate for stop clips (default 1.25) — same reasoning. */
   stopTimeScale?: number
+  /** Seconds a heading must be held before a release earns an authored stop
+   *  (default 0.5). Below it, weaving direction changes blend to idle instead
+   *  of skidding metres along the last-held heading. */
+  stopCommitTime?: number
   /** Tank-mode steering rate, radians/second (default 2.5 ≈ 143°/s). */
   steerRate?: number
   /** Backpedal speed as a fraction of run speed in tank mode (default 0.5). */
@@ -148,6 +152,7 @@ export class LocomotionController {
   private readonly turnClipMinAngle: number
   private readonly turnTimeScale: number
   private readonly stopTimeScale: number
+  private readonly stopCommitTime: number
   private turning: { entry: TurnClipEntry; time: number } | null = null
   private runTurning: {
     entry: RunTurnClipEntry
@@ -160,6 +165,9 @@ export class LocomotionController {
   /** An interrupted authored clip fading out OVER resumed locomotion, so breaking
    *  out of a stop is instantly responsive without a pose pop. */
   private exitGhost: { clip: string; clipTime: number; elapsed: number } | null = null
+  private headingHold = 0
+  private headingDirX = 0
+  private headingDirY = 0
   private stopping: {
     entry: StopClipEntry
     time: number
@@ -168,6 +176,8 @@ export class LocomotionController {
     dirX: number
     dirZ: number
     startLevel: number
+    /** Fraction of the authored deceleration distance this stop travels. */
+    scale: number
     /** Idle's share of the blend at release (level < 1 shows part idle) — the
      *  crossfade source keeps this exact mix or the first stop frame snaps. */
     fromIdleW: number
@@ -226,6 +236,7 @@ export class LocomotionController {
     this.turnClipMinAngle = options?.turnClipMinAngle ?? (100 * Math.PI) / 180
     this.turnTimeScale = options?.turnTimeScale ?? 1.4
     this.stopTimeScale = options?.stopTimeScale ?? 1.25
+    this.stopCommitTime = options?.stopCommitTime ?? 0.5
     this.turnEntries = [
       { name: clips.idle, time: 0, weight: 0 },
       { name: clips.idle, time: 0, weight: 1 },
@@ -353,12 +364,32 @@ export class LocomotionController {
       const m = Math.hypot(this.inputX, this.inputY)
       moving = m > 0.05
       this.recentSpeed = Math.max(this.speedLevel, this.recentSpeed - dt * 1.5)
+      // How long the CURRENT heading has been held. An authored skid is the
+      // ending of a committed run; weaving through directions (D, then S+D,
+      // then S) rebuilds throttle in each new heading but earns no such
+      // ending — playing one there slides her metres along whichever way she
+      // happened to face last, which reads as drift.
+      if (moving) {
+        const dx = this.inputX / m
+        const dy = this.inputY / m
+        this.headingHold =
+          this.headingDirX * dx + this.headingDirY * dy > 0.94 ? this.headingHold + dt : 0
+        this.headingDirX = dx
+        this.headingDirY = dy
+      }
       // Release at speed: play the authored stop instead of blending to idle.
       const stops = this.clips.stop
       // Gate on the peak-hold speed: the release decay (throttle/analog) drains the
       // instantaneous level below any threshold before `moving` goes false. The
       // small floor on the actual level keeps standstill taps from faking a skid.
-      if (!moving && stops && stops.length > 0 && this.recentSpeed >= 0.7 && this.speedLevel >= 0.35) {
+      if (
+        !moving &&
+        stops &&
+        stops.length > 0 &&
+        this.recentSpeed >= 0.7 &&
+        this.speedLevel >= 0.35 &&
+        this.headingHold >= this.stopCommitTime
+      ) {
         const gear = this.recentSpeed > 1.4 ? "sprint" : "run"
         const foot = this.gaitPhase < 0.5 ? "L" : "R"
         // Gear must match exactly: supplying stops for only one gear means the
@@ -383,6 +414,13 @@ export class LocomotionController {
             dirX: this.dirX,
             dirZ: this.dirZ,
             startLevel: Math.min(this.recentSpeed, 2),
+            // How much of the authored skid this stop has earned. Each profile
+            // was captured at ITS gear's full speed (run = level 1, sprint =
+            // level 2), so compare like with like. Entering slower — or moments
+            // after a direction change, when the peak-hold still remembers the
+            // PREVIOUS heading's sprint — must not replay the full slide.
+            // Floored so a stop always still reads as a stop.
+            scale: Math.max(0.3, Math.min(1, this.speedLevel / (best.gear === "sprint" ? 2 : 1))),
             fromIdleW: Math.max(0, 1 - this.speedLevel),
             fromClip,
             fromTime: this.gaitPhase * this.clipDuration(fromClip),
@@ -707,7 +745,7 @@ export class LocomotionController {
 
     t.time += dt * this.stopTimeScale
     const clipT = Math.min(t.time, entry.exitTime)
-    const fwd = LocomotionController.profileAt(entry.forward, clipT / entry.exitTime)
+    const fwd = LocomotionController.profileAt(entry.forward, clipT / entry.exitTime) * t.scale
     this.position.x = t.startX + t.dirX * fwd
     this.position.z = t.startZ + t.dirZ * fwd