castle-web-cli 0.4.94 → 0.4.96

package/kits/physics-2d/physics/matterBridge.js

@@ -27,6 +27,13 @@ export const FIXED_STEP_MS = 1000 / 60;
 export const FIXED_STEP_S = FIXED_STEP_MS / 1000;
 export const MAX_STEPS_PER_FRAME = 5;
 
+// Hard cap on a body's speed (px per fixed step) -- a safety net so a constraint
+// blow-up (a stiff joint at a bad angle can inject huge velocity in one step)
+// can't fling a body off screen. Well above any intended motion (a slingshot
+// launch is ~20), so normal gameplay never touches it; it only ever engages to
+// bound a runaway.
+export const MAX_SPEED = 60;
+
 // World gravity in matter's own units. `scale` matches matter's internal
 // default; `y` is what a scene tunes (1 ~= a gentle arcade fall).
 export const DEFAULT_GRAVITY = { x: 0, y: 1, scale: 0.001 };
@@ -73,7 +80,10 @@ function shapeToPart(s) {
     if (part) return part;
     return Matter.Bodies.rectangle((x0 + x1) / 2, (y0 + y1) / 2, Math.max(1, x1 - x0), Math.max(1, y1 - y0));
   }
-  return Matter.Bodies.rectangle(s.cx, s.cy, Math.max(1, s.width), Math.max(1, s.height));
+  // `s.angle` (deg) rotates the box part about its center at creation; the
+  // compound body's Layout.rotation composes on top.
+  const opts = s.angle ? { angle: s.angle * DEG_TO_RAD } : undefined;
+  return Matter.Bodies.rectangle(s.cx, s.cy, Math.max(1, s.width), Math.max(1, s.height), opts);
 }
 
 // Structural signature: when this changes we rebuild the body (shape set / sizes
@@ -87,7 +97,7 @@ export function bodySignature(actor) {
       s.type === 'circle'
         ? `c${Math.round(s.radius)}`
         : s.type === 'box'
-          ? `b${Math.round(s.width)}x${Math.round(s.height)}`
+          ? `b${Math.round(s.width)}x${Math.round(s.height)}@${Math.round(s.angle ?? 0)}`
           : `${s.type[0]}${(s.points ?? []).length}`
     )
     .join(',');
@@ -173,3 +183,13 @@ export function applyAngularDrag(bodies) {
     if (drag > 0 && !body.isStatic) body.angularVelocity *= Math.max(0, 1 - drag * FIXED_STEP_S);
   }
 }
+
+// Safety clamp: bound each body's speed to MAX_SPEED so a constraint blow-up
+// can't fling it off screen. Run right after each Engine.update.
+export function clampSpeeds(bodies) {
+  for (const body of bodies) {
+    if (body.isStatic) continue;
+    const s = Math.hypot(body.velocity.x, body.velocity.y);
+    if (s > MAX_SPEED) Matter.Body.setVelocity(body, { x: (body.velocity.x / s) * MAX_SPEED, y: (body.velocity.y / s) * MAX_SPEED });
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "castle-web-cli",
-  "version": "0.4.94",
+  "version": "0.4.96",
   "type": "module",
   "bin": {
     "castle-web": "./dist/index.js"