@codexo/exojs-physics 0.15.2 → 0.16.0

package/dist/esm/math.js

@@ -1,62 +1,60 @@
-// Internal rigid-transform and angle helpers. Physics stores rotations as a
-// precomputed `sin`/`cos` pair so the hot collision paths never call the
-// trigonometric functions per vertex. `Mutable2D` is a tiny `{ x, y }` sink to
-// keep the rotate/transform helpers allocation-free at their call sites.
+//#region src/math.ts
 /** Create a transform from a position and angle (radians). */
 const createTransform = (x = 0, y = 0, angle = 0) => ({
-    x,
-    y,
-    angle,
-    sin: Math.sin(angle),
-    cos: Math.cos(angle),
+	x,
+	y,
+	angle,
+	sin: Math.sin(angle),
+	cos: Math.cos(angle)
 });
 /** Set a transform in place, refreshing sin/cos only when the angle changes. */
 const setTransform = (transform, x, y, angle) => {
-    transform.x = x;
-    transform.y = y;
-    if (transform.angle !== angle) {
-        transform.angle = angle;
-        transform.sin = Math.sin(angle);
-        transform.cos = Math.cos(angle);
-    }
-    return transform;
+	transform.x = x;
+	transform.y = y;
+	if (transform.angle !== angle) {
+		transform.angle = angle;
+		transform.sin = Math.sin(angle);
+		transform.cos = Math.cos(angle);
+	}
+	return transform;
 };
 /** Rotate and translate a local point by `transform`, writing into `out`. */
 const applyTransform = (transform, x, y, out) => {
-    out.x = transform.cos * x - transform.sin * y + transform.x;
-    out.y = transform.sin * x + transform.cos * y + transform.y;
-    return out;
+	out.x = transform.cos * x - transform.sin * y + transform.x;
+	out.y = transform.sin * x + transform.cos * y + transform.y;
+	return out;
 };
 /** Rotate a local direction by `transform` (no translation), writing into `out`. */
 const applyRotation = (transform, x, y, out) => {
-    out.x = transform.cos * x - transform.sin * y;
-    out.y = transform.sin * x + transform.cos * y;
-    return out;
+	out.x = transform.cos * x - transform.sin * y;
+	out.y = transform.sin * x + transform.cos * y;
+	return out;
 };
 /** Map a world point into `transform`'s local frame, writing into `out`. */
 const applyInverseTransform = (transform, x, y, out) => {
-    const dx = x - transform.x;
-    const dy = y - transform.y;
-    out.x = transform.cos * dx + transform.sin * dy;
-    out.y = -transform.sin * dx + transform.cos * dy;
-    return out;
+	const dx = x - transform.x;
+	const dy = y - transform.y;
+	out.x = transform.cos * dx + transform.sin * dy;
+	out.y = -transform.sin * dx + transform.cos * dy;
+	return out;
 };
 /** Map a world direction into `transform`'s local frame, writing into `out`. */
 const applyInverseRotation = (transform, x, y, out) => {
-    out.x = transform.cos * x + transform.sin * y;
-    out.y = -transform.sin * x + transform.cos * y;
-    return out;
+	out.x = transform.cos * x + transform.sin * y;
+	out.y = -transform.sin * x + transform.cos * y;
+	return out;
 };
 /**
- * Compose `world = body ∘ local` into `out`. The local transform is expressed
- * in the body frame (a collider's offset + local rotation); the result is the
- * collider's world transform.
- */
+* Compose `world = body ∘ local` into `out`. The local transform is expressed
+* in the body frame (a collider's offset + local rotation); the result is the
+* collider's world transform.
+*/
 const composeTransforms = (body, local, out) => {
-    const x = body.cos * local.x - body.sin * local.y + body.x;
-    const y = body.sin * local.x + body.cos * local.y + body.y;
-    return setTransform(out, x, y, body.angle + local.angle);
+	const x = body.cos * local.x - body.sin * local.y + body.x;
+	const y = body.sin * local.x + body.cos * local.y + body.y;
+	return setTransform(out, x, y, body.angle + local.angle);
 };
 
+//#endregion
 export { applyInverseRotation, applyInverseTransform, applyRotation, applyTransform, composeTransforms, createTransform, setTransform };
-//# sourceMappingURL=math.js.map
+//# sourceMappingURL=math.js.map

package/dist/esm/math.js.map

@@ -1 +1 @@
-{"version":3,"file":"math.js","sources":["../../../src/math.ts"],"sourcesContent":[null],"names":[],"mappings":"AAAA;AACA;AACA;AACA;AAkBA;AACO,MAAM,eAAe,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,MAAiB;IACtE,CAAC;IACD,CAAC;IACD,KAAK;AACL,IAAA,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC;AACpB,IAAA,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC;AACrB,CAAA;AAED;AACO,MAAM,YAAY,GAAG,CAAC,SAAoB,EAAE,CAAS,EAAE,CAAS,EAAE,KAAa,KAAe;AACnG,IAAA,SAAS,CAAC,CAAC,GAAG,CAAC;AACf,IAAA,SAAS,CAAC,CAAC,GAAG,CAAC;AAEf,IAAA,IAAI,SAAS,CAAC,KAAK,KAAK,KAAK,EAAE;AAC7B,QAAA,SAAS,CAAC,KAAK,GAAG,KAAK;QACvB,SAAS,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC;QAC/B,SAAS,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC;IACjC;AAEA,IAAA,OAAO,SAAS;AAClB;AAEA;AACO,MAAM,cAAc,GAAG,CAAC,SAAoB,EAAE,CAAS,EAAE,CAAS,EAAE,GAAc,KAAe;AACtG,IAAA,GAAG,CAAC,CAAC,GAAG,SAAS,CAAC,GAAG,GAAG,CAAC,GAAG,SAAS,CAAC,GAAG,GAAG,CAAC,GAAG,SAAS,CAAC,CAAC;AAC3D,IAAA,GAAG,CAAC,CAAC,GAAG,SAAS,CAAC,GAAG,GAAG,CAAC,GAAG,SAAS,CAAC,GAAG,GAAG,CAAC,GAAG,SAAS,CAAC,CAAC;AAE3D,IAAA,OAAO,GAAG;AACZ;AAEA;AACO,MAAM,aAAa,GAAG,CAAC,SAAoB,EAAE,CAAS,EAAE,CAAS,EAAE,GAAc,KAAe;AACrG,IAAA,GAAG,CAAC,CAAC,GAAG,SAAS,CAAC,GAAG,GAAG,CAAC,GAAG,SAAS,CAAC,GAAG,GAAG,CAAC;AAC7C,IAAA,GAAG,CAAC,CAAC,GAAG,SAAS,CAAC,GAAG,GAAG,CAAC,GAAG,SAAS,CAAC,GAAG,GAAG,CAAC;AAE7C,IAAA,OAAO,GAAG;AACZ;AAEA;AACO,MAAM,qBAAqB,GAAG,CAAC,SAAoB,EAAE,CAAS,EAAE,CAAS,EAAE,GAAc,KAAe;AAC7G,IAAA,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,CAAC,CAAC;AAC1B,IAAA,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,CAAC,CAAC;AAE1B,IAAA,GAAG,CAAC,CAAC,GAAG,SAAS,CAAC,GAAG,GAAG,EAAE,GAAG,SAAS,CAAC,GAAG,GAAG,EAAE;AAC/C,IAAA,GAAG,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,GAAG,EAAE,GAAG,SAAS,CAAC,GAAG,GAAG,EAAE;AAEhD,IAAA,OAAO,GAAG;AACZ;AAEA;AACO,MAAM,oBAAoB,GAAG,CAAC,SAAoB,EAAE,CAAS,EAAE,CAAS,EAAE,GAAc,KAAe;AAC5G,IAAA,GAAG,CAAC,CAAC,GAAG,SAAS,CAAC,GAAG,GAAG,CAAC,GAAG,SAAS,CAAC,GAAG,GAAG,CAAC;AAC7C,IAAA,GAAG,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,GAAG,CAAC,GAAG,SAAS,CAAC,GAAG,GAAG,CAAC;AAE9C,IAAA,OAAO,GAAG;AACZ;AAEA;;;;AAIG;AACI,MAAM,iBAAiB,GAAG,CAAC,IAAe,EAAE,KAAgB,EAAE,GAAc,KAAe;IAChG,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,GAAG,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,GAAG,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAC1D,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,GAAG,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,GAAG,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;AAE1D,IAAA,OAAO,YAAY,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;AAC1D;;;;"}
+{"version":3,"file":"math.js","names":[],"sources":["../../src/math.ts"],"sourcesContent":["// Internal rigid-transform and angle helpers. Physics stores rotations as a\n// precomputed `sin`/`cos` pair so the hot collision paths never call the\n// trigonometric functions per vertex. The rotate/transform helpers write into a\n// caller-supplied `PointLike` sink so they allocate nothing at their call sites.\n\nimport type { PointLike } from '@codexo/exojs';\n\n/** A rigid 2D transform: translation plus the precomputed sin/cos of `angle`. */\nexport interface Transform {\n  x: number;\n  y: number;\n  /** Rotation in radians. */\n  angle: number;\n  sin: number;\n  cos: number;\n}\n\n/** Create a transform from a position and angle (radians). */\nexport const createTransform = (x = 0, y = 0, angle = 0): Transform => ({\n  x,\n  y,\n  angle,\n  sin: Math.sin(angle),\n  cos: Math.cos(angle),\n});\n\n/** Set a transform in place, refreshing sin/cos only when the angle changes. */\nexport const setTransform = (transform: Transform, x: number, y: number, angle: number): Transform => {\n  transform.x = x;\n  transform.y = y;\n\n  if (transform.angle !== angle) {\n    transform.angle = angle;\n    transform.sin = Math.sin(angle);\n    transform.cos = Math.cos(angle);\n  }\n\n  return transform;\n};\n\n/** Rotate and translate a local point by `transform`, writing into `out`. */\nexport const applyTransform = (transform: Transform, x: number, y: number, out: PointLike): PointLike => {\n  out.x = transform.cos * x - transform.sin * y + transform.x;\n  out.y = transform.sin * x + transform.cos * y + transform.y;\n\n  return out;\n};\n\n/** Rotate a local direction by `transform` (no translation), writing into `out`. */\nexport const applyRotation = (transform: Transform, x: number, y: number, out: PointLike): PointLike => {\n  out.x = transform.cos * x - transform.sin * y;\n  out.y = transform.sin * x + transform.cos * y;\n\n  return out;\n};\n\n/** Map a world point into `transform`'s local frame, writing into `out`. */\nexport const applyInverseTransform = (transform: Transform, x: number, y: number, out: PointLike): PointLike => {\n  const dx = x - transform.x;\n  const dy = y - transform.y;\n\n  out.x = transform.cos * dx + transform.sin * dy;\n  out.y = -transform.sin * dx + transform.cos * dy;\n\n  return out;\n};\n\n/** Map a world direction into `transform`'s local frame, writing into `out`. */\nexport const applyInverseRotation = (transform: Transform, x: number, y: number, out: PointLike): PointLike => {\n  out.x = transform.cos * x + transform.sin * y;\n  out.y = -transform.sin * x + transform.cos * y;\n\n  return out;\n};\n\n/**\n * Compose `world = body ∘ local` into `out`. The local transform is expressed\n * in the body frame (a collider's offset + local rotation); the result is the\n * collider's world transform.\n */\nexport const composeTransforms = (body: Transform, local: Transform, out: Transform): Transform => {\n  const x = body.cos * local.x - body.sin * local.y + body.x;\n  const y = body.sin * local.x + body.cos * local.y + body.y;\n\n  return setTransform(out, x, y, body.angle + local.angle);\n};\n"],"mappings":";;AAkBA,MAAa,mBAAmB,IAAI,GAAG,IAAI,GAAG,QAAQ,OAAkB;CACtE;CACA;CACA;CACA,KAAK,KAAK,IAAI,KAAK;CACnB,KAAK,KAAK,IAAI,KAAK;AACrB;;AAGA,MAAa,gBAAgB,WAAsB,GAAW,GAAW,UAA6B;CACpG,UAAU,IAAI;CACd,UAAU,IAAI;CAEd,IAAI,UAAU,UAAU,OAAO;EAC7B,UAAU,QAAQ;EAClB,UAAU,MAAM,KAAK,IAAI,KAAK;EAC9B,UAAU,MAAM,KAAK,IAAI,KAAK;CAChC;CAEA,OAAO;AACT;;AAGA,MAAa,kBAAkB,WAAsB,GAAW,GAAW,QAA8B;CACvG,IAAI,IAAI,UAAU,MAAM,IAAI,UAAU,MAAM,IAAI,UAAU;CAC1D,IAAI,IAAI,UAAU,MAAM,IAAI,UAAU,MAAM,IAAI,UAAU;CAE1D,OAAO;AACT;;AAGA,MAAa,iBAAiB,WAAsB,GAAW,GAAW,QAA8B;CACtG,IAAI,IAAI,UAAU,MAAM,IAAI,UAAU,MAAM;CAC5C,IAAI,IAAI,UAAU,MAAM,IAAI,UAAU,MAAM;CAE5C,OAAO;AACT;;AAGA,MAAa,yBAAyB,WAAsB,GAAW,GAAW,QAA8B;CAC9G,MAAM,KAAK,IAAI,UAAU;CACzB,MAAM,KAAK,IAAI,UAAU;CAEzB,IAAI,IAAI,UAAU,MAAM,KAAK,UAAU,MAAM;CAC7C,IAAI,IAAI,CAAC,UAAU,MAAM,KAAK,UAAU,MAAM;CAE9C,OAAO;AACT;;AAGA,MAAa,wBAAwB,WAAsB,GAAW,GAAW,QAA8B;CAC7G,IAAI,IAAI,UAAU,MAAM,IAAI,UAAU,MAAM;CAC5C,IAAI,IAAI,CAAC,UAAU,MAAM,IAAI,UAAU,MAAM;CAE7C,OAAO;AACT;;;;;;AAOA,MAAa,qBAAqB,MAAiB,OAAkB,QAA8B;CACjG,MAAM,IAAI,KAAK,MAAM,MAAM,IAAI,KAAK,MAAM,MAAM,IAAI,KAAK;CACzD,MAAM,IAAI,KAAK,MAAM,MAAM,IAAI,KAAK,MAAM,MAAM,IAAI,KAAK;CAEzD,OAAO,aAAa,KAAK,GAAG,GAAG,KAAK,QAAQ,MAAM,KAAK;AACzD"}

package/dist/esm/physicsBuildInfo.d.ts

@@ -13,3 +13,4 @@ export interface PhysicsBuildInfo {
     readonly development: boolean;
 }
 export declare const physicsBuildInfo: PhysicsBuildInfo;
+//# sourceMappingURL=physicsBuildInfo.d.ts.map

package/dist/esm/physicsBuildInfo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"physicsBuildInfo.d.ts","sourceRoot":"","sources":["../../src/physicsBuildInfo.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;CAC/B;AAED,eAAO,MAAM,gBAAgB,EAAE,gBAI7B,CAAC"}

package/dist/esm/physicsBuildInfo.js

@@ -1,8 +1,10 @@
+//#region src/physicsBuildInfo.ts
 const physicsBuildInfo = Object.freeze({
-    version: "0.15.2",
-    revision: "e3df957",
-    development: false,
+	version: "0.16.0",
+	revision: "3a59179",
+	development: false
 });
 
+//#endregion
 export { physicsBuildInfo };
-//# sourceMappingURL=physicsBuildInfo.js.map
+//# sourceMappingURL=physicsBuildInfo.js.map

package/dist/esm/physicsBuildInfo.js.map

@@ -1 +1 @@
-{"version":3,"file":"physicsBuildInfo.js","sources":["../../../src/physicsBuildInfo.ts"],"sourcesContent":[null],"names":[],"mappings":"AAeO,MAAM,gBAAgB,GAAqB,MAAM,CAAC,MAAM,CAAC;AAC9D,IAAA,OAAO,EAAE,QAAW;AACpB,IAAA,QAAQ,EAAE,SAAY;AACtB,IAAA,WAAW,EAAE,KAAO;AACrB,CAAA;;;;"}
+{"version":3,"file":"physicsBuildInfo.js","names":[],"sources":["../../src/physicsBuildInfo.ts"],"sourcesContent":["/**\n * Immutable compile-time build metadata for `@codexo/exojs-physics`.\n *\n * `development` mirrors the `__DEV__` compile-time constant and is statically\n * replaced before tree shaking. `version` is the exact `package.json` version\n * of the Physics package at build time. `revision` is the short source-control\n * revision (appended with `-dirty` when uncommitted changes are present) or\n * `\"unknown\"` when no revision information is available.\n */\nexport interface PhysicsBuildInfo {\n  readonly version: string;\n  readonly revision: string;\n  readonly development: boolean;\n}\n\nexport const physicsBuildInfo: PhysicsBuildInfo = Object.freeze({\n  version: __VERSION__,\n  revision: __REVISION__,\n  development: __DEV__,\n});\n"],"mappings":";AAeA,MAAa,mBAAqC,OAAO,OAAO;CAC9D;CACA;CACA;AACF,CAAC"}

package/dist/esm/public.d.ts

@@ -1,7 +1,7 @@
-export type { Aabb } from './Aabb';
 export { PhysicsBinding } from './binding/PhysicsBinding';
 export type { ColliderOptions } from './Collider';
 export { Collider } from './Collider';
+export type { ContactModifier, ContactModifierContext } from './ContactModifier';
 export type { CollisionEvent, ContactPoint, SensorEvent } from './events';
 export { DistanceJoint, type DistanceJointOptions } from './joints/DistanceJoint';
 export { Joint } from './joints/Joint';
@@ -18,11 +18,16 @@ export { PhysicsWorld } from './PhysicsWorld';
 export type { QueryFilter, RayHit } from './query/QueryEngine';
 export type { AnyShape } from './shapes/AnyShape';
 export { BoxShape } from './shapes/BoxShape';
+export { CapsuleShape } from './shapes/CapsuleShape';
+export { ChainShape, type ChainShapeOptions } from './shapes/ChainShape';
 export { CircleShape } from './shapes/CircleShape';
+export { toConvexPolygonShapes } from './shapes/convexParts';
 export { PolygonShape } from './shapes/PolygonShape';
-export type { ShapeType } from './shapes/Shape';
+export { SegmentShape } from './shapes/SegmentShape';
+export type { ShapeMassProperties, ShapeType } from './shapes/Shape';
 export { Shape } from './shapes/Shape';
 export type { TimeStepperOptions } from './TimeStepper';
 export { TimeStepper } from './TimeStepper';
-export type { BodyType, CollisionFilter, VectorLike } from './types';
+export type { BodyType, CollisionFilter } from './types';
 export { defaultFilter, shouldCollide } from './types';
+//# sourceMappingURL=public.d.ts.map

package/dist/esm/public.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"public.d.ts","sourceRoot":"","sources":["../../src/public.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,YAAY,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AACjF,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAClF,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AACrF,OAAO,EAAE,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAClF,OAAO,EAAE,SAAS,EAAE,KAAK,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtE,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACzE,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,KAAK,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC7E,YAAY,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC/D,YAAY,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,YAAY,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AACrE,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,YAAY,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,YAAY,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC"}

package/dist/esm/query/QueryEngine.d.ts

@@ -1,8 +1,8 @@
-import type { Aabb } from '../Aabb';
+import type { AabbLike, PointLike } from '@codexo/exojs';
 import type { Collider } from '../Collider';
 import type { PhysicsBody } from '../PhysicsBody';
 import type { AnyShape } from '../shapes/AnyShape';
-import type { VectorLike } from '../types';
+import type { SpatialIndex } from './SpatialIndex';
 /** A category/mask/group filter applied to a query. Omitting it matches everything. */
 export type QueryFilter = Partial<{
     category: number;
@@ -31,21 +31,65 @@ export interface RayHit {
  * reference to the world's collider array (kept world-synchronised on every
  * body move), so queries always see current placements. Array-returning queries
  * follow the three explicit allocation forms: fresh array, caller-owned `out`,
- * or an allocation-free callback — never a hidden shared buffer.
+ * or an allocation-free callback - never a hidden shared buffer.
+ *
+ * The engine scans the geometry the broad phase holds, which for a chain
+ * collider is its per-edge proxies. Every result is reported as the authored
+ * collider, and an overlap query reports a chain once however many of its edges
+ * it touches. A ray still reports one hit per edge it crosses, because those are
+ * distinct intersections.
  */
 export declare class QueryEngine {
     private readonly _colliders;
-    constructor(colliders: readonly Collider[]);
+    private readonly _spatialIndex;
+    private readonly _scratchHits;
+    private readonly _scratchHitsForEach;
+    /** Chains already reported by the running `forEachAabbHit`, so one chain is one callback. */
+    private readonly _scratchSeenForEach;
+    private readonly _scratchAabb;
+    constructor(colliders: readonly Collider[], spatialIndex?: SpatialIndex);
+    /**
+     * Colliders to scan for a query over `bounds` - the spatial index's narrowed
+     * result if one is wired, else every live collider. `sync` is called first so
+     * colliders added/moved since the index's last detection pass (including
+     * before the world's very first `step()`) are still found.
+     *
+     * `buffer` is the scratch array the spatial index writes candidates into
+     * (cleared and refilled in place). Callers whose per-candidate loop can
+     * re-enter `_candidatesFor` - directly or via caller-supplied callback code -
+     * must pass a buffer dedicated to them, so a nested call refilling its own
+     * buffer can't truncate/corrupt an outer call's still-live iteration.
+     */
+    private _candidatesFor;
     /** Colliders containing `point`. Allocates a fresh array. */
-    queryPoint(point: VectorLike, filter?: QueryFilter): Collider[];
+    queryPoint(point: Readonly<PointLike>, filter?: QueryFilter): Collider[];
     /** Colliders whose AABB overlaps `bounds`. Writes into `out` (cleared first) when given, else a fresh array. */
-    queryAabb(bounds: Aabb, filter?: QueryFilter, out?: Collider[]): Collider[];
-    /** Invoke `callback` for each collider whose AABB overlaps `bounds`. Allocation-free. */
-    forEachAabbHit(bounds: Aabb, filter: QueryFilter | undefined, callback: (collider: Collider) => void): void;
+    queryAabb(bounds: AabbLike, filter?: QueryFilter, out?: Collider[]): Collider[];
+    /**
+     * Invoke `callback` for each collider whose AABB overlaps `bounds`. Allocation-free.
+     *
+     * NOT re-entrant on itself: `callback` runs mid-traversal over a scratch
+     * buffer dedicated to this method, so it may safely call `queryPoint`,
+     * `queryAabb`, or `overlapShape` on this same `PhysicsWorld`/`QueryEngine`
+     * (they use a separate buffer and never invoke caller code mid-loop). It
+     * must NOT call `forEachAabbHit` again - directly or indirectly - on the
+     * same instance: the nested call would refill the same shared buffer this
+     * traversal is still iterating, silently truncating/corrupting it. This
+     * mirrors `DynamicAabbTree.query()`'s own non-reentrancy contract.
+     */
+    forEachAabbHit(bounds: AabbLike, filter: QueryFilter | undefined, callback: (collider: Collider) => void): void;
     /** Nearest collider hit by the ray from `origin` along `direction`, or `null`. */
-    rayCast(origin: VectorLike, direction: VectorLike, filter?: QueryFilter, maxDistance?: number): RayHit | null;
+    rayCast(origin: Readonly<PointLike>, direction: Readonly<PointLike>, filter?: QueryFilter, maxDistance?: number): RayHit | null;
     /** All collider hits along the ray, sorted by distance. Writes into `out` (cleared first) when given. */
-    rayCastAll(origin: VectorLike, direction: VectorLike, filter?: QueryFilter, out?: RayHit[], maxDistance?: number): RayHit[];
-    /** Colliders overlapping `shape` placed at `position`/`angle`. Allocates a fresh array. */
-    overlapShape(shape: AnyShape, position: VectorLike, filter?: QueryFilter, angle?: number): Collider[];
+    rayCastAll(origin: Readonly<PointLike>, direction: Readonly<PointLike>, filter?: QueryFilter, out?: RayHit[], maxDistance?: number): RayHit[];
+    /**
+     * Colliders overlapping `shape` placed at `position`/`angle`. Allocates a
+     * fresh array.
+     *
+     * A chain query shape is tested edge by edge, exactly as a chain collider is
+     * solved. Two boundaries have no overlap volume, so a chain - like a segment -
+     * never reports another chain or segment.
+     */
+    overlapShape(shape: AnyShape, position: Readonly<PointLike>, filter?: QueryFilter, angle?: number): Collider[];
 }
+//# sourceMappingURL=QueryEngine.d.ts.map

package/dist/esm/query/QueryEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"QueryEngine.d.ts","sourceRoot":"","sources":["../../../src/query/QueryEngine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAGzD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAM5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAGnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAQnD,uFAAuF;AACvF,MAAM,MAAM,WAAW,GAAG,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAErF,sCAAsC;AACtC,MAAM,WAAW,MAAM;IACrB,QAAQ,EAAE,QAAQ,CAAC;IACnB,IAAI,EAAE,WAAW,CAAC;IAClB,gCAAgC;IAChC,KAAK,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAChC,6EAA6E;IAC7E,MAAM,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACjC,qEAAqE;IACrE,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAsB;IACjD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA2B;IACzD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAkB;IAC/C,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAkB;IACtD,6FAA6F;IAC7F,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAkB;IACtD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA0B;gBAEpC,SAAS,EAAE,SAAS,QAAQ,EAAE,EAAE,YAAY,CAAC,EAAE,YAAY;IAK9E;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,cAAc;IAUtB,6DAA6D;IACtD,UAAU,CAAC,KAAK,EAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,QAAQ,EAAE;IAyB/E,gHAAgH;IACzG,SAAS,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,WAAW,EAAE,GAAG,CAAC,EAAE,QAAQ,EAAE,GAAG,QAAQ,EAAE;IAoBtF;;;;;;;;;;;OAWG;IACI,cAAc,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,GAAG,SAAS,EAAE,QAAQ,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,IAAI,GAAG,IAAI;IAyBtH,kFAAkF;IAC3E,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,EAAE,WAAW,EAAE,WAAW,SAAW,GAAG,MAAM,GAAG,IAAI;IAuCxI,yGAAyG;IAClG,UAAU,CAAC,MAAM,EAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,EAAE,WAAW,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,EAAE,WAAW,SAAW,GAAG,MAAM,EAAE;IAyCtJ;;;;;;;OAOG;IACI,YAAY,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,EAAE,WAAW,EAAE,KAAK,SAAI,GAAG,QAAQ,EAAE;CA2BjH"}