@woosh/meep-engine 3.6.0 → 3.8.0

package/src/engine/physics/queries/shape_cast.d.ts

@@ -30,10 +30,12 @@
  *     refinement which the broadphase-only architecture doesn't have
  *     wired up yet.
  *   - `result.normal` — target surface's outward normal at the kiss
- *     point (unit length), computed by running GJK + EPA against the
- *     just-overlapping configuration at the TOI. Falls back to
- *     `-ray.direction` on the rare case EPA degenerates (NaN / zero
- *     depth) — see comment near the EPA call.
+ *     point (unit length), recovered by running MPR against the
+ *     just-overlapping configuration at the TOI. A pair that is exactly
+ *     tangent there carries no MTV to read, so a second probe nudged
+ *     toward the target's centre supplies one; `-ray.direction` remains
+ *     the last-resort fallback if both degenerate. See the
+ *     contact-normal recovery block near the end of the function.
  *   - `result.entity` / `result.body_id` — the hit body.
  *
  * Output on miss: untouched; same convention as `raycast`.
@@ -52,12 +54,15 @@
  *   distinguishes bodies when colliders live on child entities)
  * @param {boolean} [skip_initial_overlaps=false] how a candidate ALREADY
  *   overlapping the swept shape at `t = 0` is treated. `false` (kinematic
- *   "can I move?" semantics): the cast is blocked where it stands — report a
- *   hit at `t = 0`. `true` (CCD semantics): such a candidate is a resting /
- *   sliding contact the discrete solver already owns, NOT a tunnelling
- *   threat — skip it and keep scanning the remaining candidates for real
- *   blockers along the sweep. Without the skip, one resting contact at the
- *   start of the sweep would blind the cast to every other obstacle.
+ *   "can I move?" semantics): targets are solid, so the cast is blocked where
+ *   it stands — report a hit at `t = 0`. The one exception is a convex target
+ *   the shape merely TOUCHES (no depth beyond {@link CONTACT_EPSILON}): a
+ *   tangency blocks only a sweep driving into it, and otherwise steps aside so
+ *   the scan can reach real blockers. `true` (CCD semantics): such a candidate
+ *   is a resting / sliding contact the discrete solver already owns, NOT a
+ *   tunnelling threat — skip it and keep scanning the remaining candidates for
+ *   real blockers along the sweep. Either way, one contact at the start of the
+ *   sweep must never blind the cast to every other obstacle.
  * @returns {boolean}
  */
 export function shape_cast(system: PhysicsSystem, ray: any, shape: AbstractShape3D, rotation: {

package/src/engine/physics/queries/shape_cast.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shape_cast.d.ts","sourceRoot":"","sources":["../../../../../src/engine/physics/queries/shape_cast.js"],"names":[],"mappings":"AAyEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6DG;AACH,8FAhBW;IAAC,CAAC,EAAC,MAAM,CAAC;IAAA,CAAC,EAAC,MAAM,CAAC;IAAA,CAAC,EAAC,MAAM,CAAC;IAAA,CAAC,EAAC,MAAM,CAAA;CAAC,iDAE7B,MAAM,+BAA6B,MAAM,KAAG,OAAO,0BAI3D,OAAO,GAQL,OAAO,CA2RnB"}
+{"version":3,"file":"shape_cast.d.ts","sourceRoot":"","sources":["../../../../../src/engine/physics/queries/shape_cast.js"],"names":[],"mappings":"AAoPA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkEG;AACH,8FAnBW;IAAC,CAAC,EAAC,MAAM,CAAC;IAAA,CAAC,EAAC,MAAM,CAAC;IAAA,CAAC,EAAC,MAAM,CAAC;IAAA,CAAC,EAAC,MAAM,CAAA;CAAC,iDAE7B,MAAM,+BAA6B,MAAM,KAAG,OAAO,0BAI3D,OAAO,GAWL,OAAO,CAsTnB"}