reze-engine 0.30.1 → 0.30.2

package/README.md

@@ -18,7 +18,7 @@ npm install reze-engine
 - **In-house TS physics** — sequential-impulse rigid bodies for PMX rigs with rest-stable implicit spring-dampers, zero dependencies
 - **Math library** — the shared Vec3/Quat/Mat4 layer of the Reze family: euler orders, swing-twist, shortest-arc, look-rotation, zero-alloc `*Into` variants
 - **VMD animation** — MMD IK with per-chain enable read from the motion, morphs on a GPU compute path, and VMD export
-- **Clip blending & locomotion** — weighted multi-clip pose blending, crossfades, and a game-style character controller (idle/run/sprint speed blend, code-driven root motion) — the [demo](https://reze-engine.vercel.app) is WASD-playable
+- **Clip blending & locomotion** — weighted multi-clip pose blending, crossfades, and a game-style character controller (idle/run/sprint speed blend, code-driven root motion) — the [demo](https://reze.one) is WASD-playable
 - **Interactive editing** — GPU picking, transform gizmo, bone/material selection
 - **Camera** — orbit, bone-follow, or a driven MMD camera VMD; ground + PCF shadows, multi-model scenes
 - **Offline rendering** — frame-accurate stepping (`renderFrame`) at any resolution (`setRenderSize`) for video export; background color, 360° equirect backdrop, ground shadow-catcher

package/dist/physics/physics.d.ts

@@ -12,6 +12,10 @@ export declare class RezePhysics {
     private timeAccum;
     private readonly fixedTimeStep;
     private readonly maxSubSteps;
+    /** EMA of one world.step's CPU cost; drives catch-up load shedding. */
+    private stepCostEmaMs;
+    /** Max ms a single frame may spend catching up physics before shedding. */
+    private readonly stepBudgetMs;
     private prevPositions;
     private prevOrientations;
     private kinTargetPos;

package/dist/physics/physics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"physics.d.ts","sourceRoot":"","sources":["../../src/physics/physics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,SAAS,CAAA;AAC1C,OAAO,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAE/C,OAAO,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAA;AAYvC,qBAAa,WAAW;IACtB,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,KAAK,CAAO;IACpB,OAAO,CAAC,WAAW,CAA0B;IAC7C,OAAO,CAAC,QAAQ,CAAa;IAC7B,OAAO,CAAC,UAAU,CAAO;IACzB,OAAO,CAAC,SAAS,CAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAI;IAMhC,OAAO,CAAC,aAAa,CAAc;IACnC,OAAO,CAAC,gBAAgB,CAAc;IAQtC,OAAO,CAAC,YAAY,CAAc;IAClC,OAAO,CAAC,YAAY,CAAc;IAClC,OAAO,CAAC,YAAY,CAAc;IAClC,OAAO,CAAC,eAAe,CAAc;IAMrC,OAAO,CAAC,OAAO,CAAY;IAE3B,OAAO,CAAC,aAAa,CAAY;IAMjC,OAAO,CAAC,WAAW,CAAY;IAG/B,aAAa,SAAI;gBAEL,WAAW,EAAE,SAAS,EAAE,EAAE,MAAM,GAAE,KAAK,EAAO;IA8B1D,OAAO,CAAC,mBAAmB;IA4B3B,OAAO,CAAC,aAAa;IAKrB,UAAU,CAAC,OAAO,EAAE,IAAI,GAAG,IAAI;IAG/B,UAAU,IAAI,IAAI;IAGlB,cAAc,IAAI,SAAS,EAAE;IAG7B,SAAS,IAAI,KAAK,EAAE;IAGpB,QAAQ,IAAI,cAAc;IAI1B,sBAAsB,IAAI,KAAK,CAAC;QAAE,QAAQ,EAAE,IAAI,CAAC;QAAC,QAAQ,EAAE,IAAI,CAAA;KAAE,CAAC;IAiBnE,KAAK,CAAC,iBAAiB,EAAE,IAAI,EAAE,GAAG,IAAI;IActC,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,iBAAiB,EAAE,IAAI,EAAE,EAAE,uBAAuB,EAAE,YAAY,GAAG,IAAI;IAiExF,OAAO,CAAC,iBAAiB;IAuCzB,OAAO,CAAC,uBAAuB;IAqF/B,OAAO,CAAC,yBAAyB;IAgEjC,OAAO,CAAC,sBAAsB;IAmC9B,OAAO,CAAC,2BAA2B;IA6EnC,OAAO,CAAC,wBAAwB;IA2BhC,OAAO,CAAC,sBAAsB;IAqC9B,OAAO,CAAC,oBAAoB;CA6D7B"}
+{"version":3,"file":"physics.d.ts","sourceRoot":"","sources":["../../src/physics/physics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,SAAS,CAAA;AAC1C,OAAO,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAE/C,OAAO,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAA;AAYvC,qBAAa,WAAW;IACtB,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,KAAK,CAAO;IACpB,OAAO,CAAC,WAAW,CAA0B;IAC7C,OAAO,CAAC,QAAQ,CAAa;IAC7B,OAAO,CAAC,UAAU,CAAO;IACzB,OAAO,CAAC,SAAS,CAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAI;IAChC,uEAAuE;IACvE,OAAO,CAAC,aAAa,CAAM;IAC3B,2EAA2E;IAC3E,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAI;IAMjC,OAAO,CAAC,aAAa,CAAc;IACnC,OAAO,CAAC,gBAAgB,CAAc;IAQtC,OAAO,CAAC,YAAY,CAAc;IAClC,OAAO,CAAC,YAAY,CAAc;IAClC,OAAO,CAAC,YAAY,CAAc;IAClC,OAAO,CAAC,eAAe,CAAc;IAMrC,OAAO,CAAC,OAAO,CAAY;IAE3B,OAAO,CAAC,aAAa,CAAY;IAMjC,OAAO,CAAC,WAAW,CAAY;IAG/B,aAAa,SAAI;gBAEL,WAAW,EAAE,SAAS,EAAE,EAAE,MAAM,GAAE,KAAK,EAAO;IA8B1D,OAAO,CAAC,mBAAmB;IA4B3B,OAAO,CAAC,aAAa;IAKrB,UAAU,CAAC,OAAO,EAAE,IAAI,GAAG,IAAI;IAG/B,UAAU,IAAI,IAAI;IAGlB,cAAc,IAAI,SAAS,EAAE;IAG7B,SAAS,IAAI,KAAK,EAAE;IAGpB,QAAQ,IAAI,cAAc;IAI1B,sBAAsB,IAAI,KAAK,CAAC;QAAE,QAAQ,EAAE,IAAI,CAAC;QAAC,QAAQ,EAAE,IAAI,CAAA;KAAE,CAAC;IAiBnE,KAAK,CAAC,iBAAiB,EAAE,IAAI,EAAE,GAAG,IAAI;IActC,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,iBAAiB,EAAE,IAAI,EAAE,EAAE,uBAAuB,EAAE,YAAY,GAAG,IAAI;IA2ExF,OAAO,CAAC,iBAAiB;IAuCzB,OAAO,CAAC,uBAAuB;IAqF/B,OAAO,CAAC,yBAAyB;IAgEjC,OAAO,CAAC,sBAAsB;IAmC9B,OAAO,CAAC,2BAA2B;IA6EnC,OAAO,CAAC,wBAAwB;IA2BhC,OAAO,CAAC,sBAAsB;IAqC9B,OAAO,CAAC,oBAAoB;CA6D7B"}

package/dist/physics/physics.js

@@ -16,6 +16,10 @@ export class RezePhysics {
         this.timeAccum = 0;
         this.fixedTimeStep = 1 / 60;
         this.maxSubSteps = 6;
+        /** EMA of one world.step's CPU cost; drives catch-up load shedding. */
+        this.stepCostEmaMs = 0.5;
+        /** Max ms a single frame may spend catching up physics before shedding. */
+        this.stepBudgetMs = 8;
         // Debug counter: frames on which a teleport (scrub/jump discontinuity)
         // was detected and settled.
         this.teleportCount = 0;
@@ -164,10 +168,21 @@ export class RezePhysics {
         let nSub = Math.floor(this.timeAccum / this.fixedTimeStep);
         if (nSub > this.maxSubSteps)
             nSub = this.maxSubSteps;
+        // Load shedding: the maxSubSteps cap alone still allows a stable DEGRADED state
+        // on weak/throttled devices — one long frame schedules catch-up substeps, which
+        // lengthen the next frame, which schedules more, and the cap becomes the steady
+        // state (6× step cost every frame; iOS "starts smooth, then stays slow").
+        // Catching up must never cost more than a frame-budget slice: shed the backlog
+        // instead (physics runs fractionally slow-motion for a beat; framerate holds).
+        const affordable = Math.max(1, Math.floor(this.stepBudgetMs / Math.max(0.05, this.stepCostEmaMs)));
+        if (nSub > affordable)
+            nSub = affordable;
         for (let k = 0; k < nSub; k++) {
             this.savePrevState();
             this.advanceKinematicToTargets(1 / (nSub - k));
+            const tStep = performance.now();
             this.world.step(this.store, this.constraints, this.contacts, this.fixedTimeStep);
+            this.stepCostEmaMs += (performance.now() - tStep - this.stepCostEmaMs) * 0.2;
             this.restoreNonFiniteBodies();
             this.timeAccum -= this.fixedTimeStep;
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "reze-engine",
-  "version": "0.30.1",
+  "version": "0.30.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/physics/physics.ts

@@ -24,6 +24,10 @@ export class RezePhysics {
   private timeAccum = 0
   private readonly fixedTimeStep = 1 / 60
   private readonly maxSubSteps = 6
+  /** EMA of one world.step's CPU cost; drives catch-up load shedding. */
+  private stepCostEmaMs = 0.5
+  /** Max ms a single frame may spend catching up physics before shedding. */
+  private readonly stepBudgetMs = 8
 
   // Fixed-timestep render interpolation ("Fix Your Timestep"): the dynamic body pose is
   // rendered as lerp(prev, curr, alpha) between the last two completed substeps, where
@@ -210,10 +214,20 @@ export class RezePhysics {
     this.timeAccum += dt
     let nSub = Math.floor(this.timeAccum / this.fixedTimeStep)
     if (nSub > this.maxSubSteps) nSub = this.maxSubSteps
+    // Load shedding: the maxSubSteps cap alone still allows a stable DEGRADED state
+    // on weak/throttled devices — one long frame schedules catch-up substeps, which
+    // lengthen the next frame, which schedules more, and the cap becomes the steady
+    // state (6× step cost every frame; iOS "starts smooth, then stays slow").
+    // Catching up must never cost more than a frame-budget slice: shed the backlog
+    // instead (physics runs fractionally slow-motion for a beat; framerate holds).
+    const affordable = Math.max(1, Math.floor(this.stepBudgetMs / Math.max(0.05, this.stepCostEmaMs)))
+    if (nSub > affordable) nSub = affordable
     for (let k = 0; k < nSub; k++) {
       this.savePrevState()
       this.advanceKinematicToTargets(1 / (nSub - k))
+      const tStep = performance.now()
       this.world.step(this.store, this.constraints, this.contacts, this.fixedTimeStep)
+      this.stepCostEmaMs += (performance.now() - tStep - this.stepCostEmaMs) * 0.2
       this.restoreNonFiniteBodies()
       this.timeAccum -= this.fixedTimeStep
     }