@pibbl/core 0.0.1 → 0.0.3-alpha.85.1

package/dist/features/physics/2d-geometry.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/features/physics/2d-geometry.ts"],
-  "sourcesContent": ["import type { boundsOfShape2D, massProperties2D, transformShape2D } from './lib/2d/shapes.js';\nimport type { queryAabb2D, raycast2D } from './2d.js';\nimport type { raycastShape2D, shapeCastAgainstShape2D } from './lib/2d/collision/casts.js';\nimport type { PibblPhysicsCollisionEvent2D, PibblPhysicsQueryHit2D } from './lib/2d/types.js';\nimport type { PibblPhysicsContactInspection2D } from './lib/2d/inspection-types.js';\n/**\n * An x/y pair in the 2D physics coordinate system.\n *\n * @see {@link PibblPhysicsPose2D}\n * @see {@link PibblPhysicsAabb2D}\n * @see {@link PibblPhysicsRay2D}\n */\nexport type PibblPhysicsVector2 = readonly [x: number, y: number];\n\n/**\n * Position and rotation in degrees for a 2D shape or body.\n *\n * @see {@link PibblPhysicsVector2}\n * @see {@link PibblPhysicsTransform2D}\n * @see {@link containsPoint2D}\n */\nexport interface PibblPhysicsPose2D {\n  /** Position of the geometry, source, or selected resize handle. See {@link PibblPhysicsVector2}. */\n  readonly position: PibblPhysicsVector2;\n  /** Rotation in degrees. See {@link PibblPhysicsPose2D}. */\n  readonly rotationDegrees: number;\n}\n\n/**\n * A rigid 2D transform expressed as position and rotation in degrees.\n *\n * @see {@link PibblPhysicsPose2D}\n * @see {@link transformShape2D}\n */\nexport type PibblPhysicsTransform2D = PibblPhysicsPose2D;\n\n/**\n * Axis-aligned bounds expressed as minimum and maximum coordinates.\n *\n * @see {@link PibblPhysicsVector2}\n * @see {@link boundsOfShape2D}\n * @see {@link queryAabb2D}\n */\nexport interface PibblPhysicsAabb2D {\n  /** Lower bound of the coordinate or sampling interval. See {@link PibblPhysicsVector2}. */\n  readonly min: PibblPhysicsVector2;\n  /** Upper bound of the coordinate or sampling interval. See {@link PibblPhysicsVector2}. */\n  readonly max: PibblPhysicsVector2;\n}\n\n/**\n * Origin, direction, and maximum travel distance of a 2D query ray.\n *\n * @see {@link PibblPhysicsVector2}\n * @see {@link raycastShape2D}\n * @see {@link raycast2D}\n */\nexport interface PibblPhysicsRay2D {\n  /** Origin of the transform or geometric query. See {@link PibblPhysicsVector2}. */\n  readonly origin: PibblPhysicsVector2;\n  /** Direction in which this operation proceeds. See {@link PibblPhysicsVector2}. */\n  readonly direction: PibblPhysicsVector2;\n  /** Maximum distance accepted by the query. See {@link PibblPhysicsRay2D}. */\n  readonly maxDistance: number;\n}\n\ndeclare const physicsShape2DBrand: unique symbol;\n/**\n * An immutable branded shape created by the public 2D geometry constructors.\n *\n * @see {@link containsPoint2D}\n * @see {@link distanceBetweenShapes2D}\n * @see {@link overlapShapes2D}\n */\nexport interface PibblPhysicsShape2D {\n  readonly [physicsShape2DBrand]: true;\n}\n\n/**\n * Area, centroid, mass, and rotational inertia derived from a shape and density.\n *\n * @see {@link PibblPhysicsVector2}\n * @see {@link massProperties2D}\n */\nexport interface PibblPhysicsMassProperties2D {\n  /** Area enclosed by the shape. See {@link PibblPhysicsMassProperties2D}. */\n  readonly area: number;\n  /** Area-weighted center of the shape. See {@link PibblPhysicsVector2}. */\n  readonly centroid: PibblPhysicsVector2;\n  /** Mass used by the spring or physics calculation. See {@link PibblPhysicsMassProperties2D}. */\n  readonly mass: number;\n  /** Moment of inertia about the shape's center of mass. See {@link PibblPhysicsMassProperties2D}. */\n  readonly rotationalInertia: number;\n}\n\n/**\n * Signed separation, witness points, and normal between two posed shapes.\n *\n * @see {@link PibblPhysicsVector2}\n * @see {@link distanceBetweenShapes2D}\n */\nexport interface PibblPhysicsDistance2D {\n  /** Signed distance between the witness points. See {@link PibblPhysicsDistance2D}. */\n  readonly separation: number;\n  /** Witness point on the first shape. See {@link PibblPhysicsVector2}. */\n  readonly pointOnFirst: PibblPhysicsVector2;\n  /** Witness point on the second shape. See {@link PibblPhysicsVector2}. */\n  readonly pointOnSecond: PibblPhysicsVector2;\n  /** Direction from the second shape toward the first. */\n  readonly normal: PibblPhysicsVector2;\n}\n\n/**\n * A pair of contact witness points and their signed separation.\n *\n * @see {@link PibblPhysicsVector2}\n * @see {@link PibblPhysicsShapeContact2D}\n * @see {@link PibblPhysicsCollisionEvent2D}\n * @see {@link PibblPhysicsContactInspection2D}\n */\nexport interface PibblPhysicsContactPoint2D {\n  /** Witness point on the first shape. See {@link PibblPhysicsVector2}. */\n  readonly pointOnFirst: PibblPhysicsVector2;\n  /** Witness point on the second shape. See {@link PibblPhysicsVector2}. */\n  readonly pointOnSecond: PibblPhysicsVector2;\n  /** Signed distance between the witness points. See {@link PibblPhysicsContactPoint2D}. */\n  readonly separation: number;\n}\n\n/**\n * Contact normal and witness-point pairs for two overlapping or touching shapes.\n *\n * @see {@link PibblPhysicsVector2}\n * @see {@link PibblPhysicsContactPoint2D}\n * @see {@link contactBetweenShapes2D}\n */\nexport interface PibblPhysicsShapeContact2D {\n  /** Direction from the second shape toward the first. */\n  readonly normal: PibblPhysicsVector2;\n  /**\n   * Points defining the geometry or reported by the contact query. See\n   * {@link PibblPhysicsContactPoint2D}.\n   */\n  readonly points: readonly PibblPhysicsContactPoint2D[];\n}\n\n/**\n * Point, normal, distance, and time of impact returned by a geometry cast.\n *\n * @see {@link PibblPhysicsVector2}\n * @see {@link raycastShape2D}\n * @see {@link shapeCastAgainstShape2D}\n * @see {@link PibblPhysicsQueryHit2D}\n */\nexport interface PibblPhysicsShapeHit2D {\n  /** A point in the operation's coordinate system. See {@link PibblPhysicsVector2}. */\n  readonly point: PibblPhysicsVector2;\n  /** Contact or surface normal returned by this query. See {@link PibblPhysicsVector2}. */\n  readonly normal: PibblPhysicsVector2;\n  /**\n   * Distance measured in this query or guide's coordinate system. See {@link PibblPhysicsShapeHit2D}\n   * .\n   */\n  readonly distance: number;\n  /** Position along the cast at which contact first occurs. See {@link PibblPhysicsShapeHit2D}. */\n  readonly timeOfImpact: number;\n}\n\nexport {\n  arcShape2D,\n  boundsOfShape2D,\n  boxShape2D,\n  capsuleShape2D,\n  chainShape2D,\n  circleShape2D,\n  ellipseShape2D,\n  massProperties2D,\n  polygonShape2D,\n  roundedBoxShape2D,\n  segmentShape2D,\n  transformShape2D,\n  wedgeShape2D,\n} from './lib/2d/shapes.js';\n\nimport {\n  contactBetweenPreparedShapes2D,\n  containsPointInShape2D,\n  distanceBetweenPreparedShapes2D,\n  overlapPreparedShapes2D,\n} from './lib/2d/collision/pairs.js';\nexport {\n  raycastShape2D,\n  shapeCastAgainstShape2D,\n} from './lib/2d/collision/casts.js';\n\n/**\n * Tests whether a point lies within a posed shape without creating a physics world.\n *\n * @param shape - Shape to test. See {@link PibblPhysicsShape2D}.\n * @param pose - Shape pose. See {@link PibblPhysicsPose2D}.\n * @param point - Point in the same coordinate space as the posed shape. See\n * {@link PibblPhysicsVector2} .\n * @returns Whether the posed shape contains the point.\n *\n * @see {@link PibblPhysicsShape2D}\n * @see {@link PibblPhysicsPose2D}\n * @see {@link PibblPhysicsVector2}\n */\nexport function containsPoint2D(\n  shape: PibblPhysicsShape2D,\n  pose: PibblPhysicsPose2D,\n  point: PibblPhysicsVector2,\n): boolean {\n  return containsPointInShape2D(shape, pose, point);\n}\n\n/**\n * Computes signed separation and witness geometry between two posed shapes.\n *\n * @param first - First shape. See {@link PibblPhysicsShape2D}.\n * @param firstPose - Pose of the first shape. See {@link PibblPhysicsPose2D}.\n * @param second - Second shape. See {@link PibblPhysicsShape2D}.\n * @param secondPose - Pose of the second shape. See {@link PibblPhysicsPose2D}.\n * @returns Distance and closest-point information for the two posed shapes. See\n * {@link PibblPhysicsDistance2D} .\n *\n * @see {@link PibblPhysicsShape2D}\n * @see {@link PibblPhysicsPose2D}\n * @see {@link PibblPhysicsDistance2D}\n */\nexport function distanceBetweenShapes2D(\n  first: PibblPhysicsShape2D,\n  firstPose: PibblPhysicsPose2D,\n  second: PibblPhysicsShape2D,\n  secondPose: PibblPhysicsPose2D,\n): PibblPhysicsDistance2D {\n  return distanceBetweenPreparedShapes2D(first, firstPose, second, secondPose);\n}\n\n/**\n * Tests whether two posed shapes overlap without creating a physics world.\n *\n * @param first - First shape. See {@link PibblPhysicsShape2D}.\n * @param firstPose - Pose of the first shape. See {@link PibblPhysicsPose2D}.\n * @param second - Second shape. See {@link PibblPhysicsShape2D}.\n * @param secondPose - Pose of the second shape. See {@link PibblPhysicsPose2D}.\n * @returns Whether the two posed shapes overlap.\n *\n * @see {@link PibblPhysicsShape2D}\n * @see {@link PibblPhysicsPose2D}\n */\nexport function overlapShapes2D(\n  first: PibblPhysicsShape2D,\n  firstPose: PibblPhysicsPose2D,\n  second: PibblPhysicsShape2D,\n  secondPose: PibblPhysicsPose2D,\n): boolean {\n  return overlapPreparedShapes2D(first, firstPose, second, secondPose);\n}\n\n/**\n * Computes contact geometry for two posed shapes, or null when they do not contact.\n *\n * @param first - First shape. See {@link PibblPhysicsShape2D}.\n * @param firstPose - Pose of the first shape. See {@link PibblPhysicsPose2D}.\n * @param second - Second shape. See {@link PibblPhysicsShape2D}.\n * @param secondPose - Pose of the second shape. See {@link PibblPhysicsPose2D}.\n * @returns Contact information, or null when the shapes do not contact. See\n * {@link PibblPhysicsShapeContact2D} .\n *\n * @see {@link PibblPhysicsShape2D}\n * @see {@link PibblPhysicsPose2D}\n * @see {@link PibblPhysicsShapeContact2D}\n */\nexport function contactBetweenShapes2D(\n  first: PibblPhysicsShape2D,\n  firstPose: PibblPhysicsPose2D,\n  second: PibblPhysicsShape2D,\n  secondPose: PibblPhysicsPose2D,\n): PibblPhysicsShapeContact2D | null {\n  return contactBetweenPreparedShapes2D(first, firstPose, second, secondPose);\n}\n"],
+  "sourcesContent": ["import type { boundsOfShape2D, massProperties2D, transformShape2D } from './lib/2d/shapes.js';\nimport type { findAabbMatch2D, raycastClosest2D } from './2d.js';\nimport type { raycastShape2D, shapeCastAgainstShape2D } from './lib/2d/collision/casts.js';\nimport type { PibblPhysicsCollisionEvent2D, PibblPhysicsQueryHit2D } from './lib/2d/types.js';\nimport type { PibblPhysicsContactInspection2D } from './lib/2d/inspection-types.js';\n/**\n * An x/y pair in the 2D physics coordinate system.\n *\n * @see {@link PibblPhysicsPose2D}\n * @see {@link PibblPhysicsAabb2D}\n * @see {@link PibblPhysicsRay2D}\n */\nexport type PibblPhysicsVector2 = readonly [x: number, y: number];\n\n/**\n * Position and rotation in degrees for a 2D shape or body.\n *\n * @see {@link PibblPhysicsVector2}\n * @see {@link PibblPhysicsTransform2D}\n * @see {@link containsPoint2D}\n */\nexport interface PibblPhysicsPose2D {\n  /** Position of the geometry, source, or selected resize handle. See {@link PibblPhysicsVector2}. */\n  readonly position: PibblPhysicsVector2;\n  /** Rotation in degrees. See {@link PibblPhysicsPose2D}. */\n  readonly rotationDegrees: number;\n}\n\n/**\n * A rigid 2D transform expressed as position and rotation in degrees.\n *\n * @see {@link PibblPhysicsPose2D}\n * @see {@link transformShape2D}\n */\nexport type PibblPhysicsTransform2D = PibblPhysicsPose2D;\n\n/**\n * Axis-aligned bounds expressed as minimum and maximum coordinates.\n *\n * @see {@link PibblPhysicsVector2}\n * @see {@link boundsOfShape2D}\n * @see {@link findAabbMatch2D}\n */\nexport interface PibblPhysicsAabb2D {\n  /** Lower bound of the coordinate or sampling interval. See {@link PibblPhysicsVector2}. */\n  readonly min: PibblPhysicsVector2;\n  /** Upper bound of the coordinate or sampling interval. See {@link PibblPhysicsVector2}. */\n  readonly max: PibblPhysicsVector2;\n}\n\n/**\n * Origin, direction, and maximum travel distance of a 2D query ray.\n *\n * @see {@link PibblPhysicsVector2}\n * @see {@link raycastShape2D}\n * @see {@link raycastClosest2D}\n */\nexport interface PibblPhysicsRay2D {\n  /** Origin of the transform or geometric query. See {@link PibblPhysicsVector2}. */\n  readonly origin: PibblPhysicsVector2;\n  /** Direction in which this operation proceeds. See {@link PibblPhysicsVector2}. */\n  readonly direction: PibblPhysicsVector2;\n  /** Maximum distance accepted by the query. See {@link PibblPhysicsRay2D}. */\n  readonly maxDistance: number;\n}\n\ndeclare const physicsShape2DBrand: unique symbol;\n/**\n * An immutable branded shape created by the public 2D geometry constructors.\n *\n * @see {@link containsPoint2D}\n * @see {@link distanceBetweenShapes2D}\n * @see {@link overlapShapes2D}\n */\nexport interface PibblPhysicsShape2D {\n  readonly [physicsShape2DBrand]: true;\n}\n\n/**\n * Area, centroid, mass, and rotational inertia derived from a shape and density.\n *\n * @see {@link PibblPhysicsVector2}\n * @see {@link massProperties2D}\n */\nexport interface PibblPhysicsMassProperties2D {\n  /** Area enclosed by the shape. See {@link PibblPhysicsMassProperties2D}. */\n  readonly area: number;\n  /** Area-weighted center of the shape. See {@link PibblPhysicsVector2}. */\n  readonly centroid: PibblPhysicsVector2;\n  /** Mass used by the spring or physics calculation. See {@link PibblPhysicsMassProperties2D}. */\n  readonly mass: number;\n  /** Moment of inertia about the shape's center of mass. See {@link PibblPhysicsMassProperties2D}. */\n  readonly rotationalInertia: number;\n}\n\n/**\n * Signed separation, witness points, and normal between two posed shapes.\n *\n * @see {@link PibblPhysicsVector2}\n * @see {@link distanceBetweenShapes2D}\n */\nexport interface PibblPhysicsDistance2D {\n  /** Signed distance between the witness points. See {@link PibblPhysicsDistance2D}. */\n  readonly separation: number;\n  /** Witness point on the first shape. See {@link PibblPhysicsVector2}. */\n  readonly pointOnFirst: PibblPhysicsVector2;\n  /** Witness point on the second shape. See {@link PibblPhysicsVector2}. */\n  readonly pointOnSecond: PibblPhysicsVector2;\n  /** Direction from the second shape toward the first. */\n  readonly normal: PibblPhysicsVector2;\n}\n\n/**\n * A pair of contact witness points and their signed separation.\n *\n * @see {@link PibblPhysicsVector2}\n * @see {@link PibblPhysicsShapeContact2D}\n * @see {@link PibblPhysicsCollisionEvent2D}\n * @see {@link PibblPhysicsContactInspection2D}\n */\nexport interface PibblPhysicsContactPoint2D {\n  /** Witness point on the first shape. See {@link PibblPhysicsVector2}. */\n  readonly pointOnFirst: PibblPhysicsVector2;\n  /** Witness point on the second shape. See {@link PibblPhysicsVector2}. */\n  readonly pointOnSecond: PibblPhysicsVector2;\n  /** Signed distance between the witness points. See {@link PibblPhysicsContactPoint2D}. */\n  readonly separation: number;\n}\n\n/**\n * Contact normal and witness-point pairs for two overlapping or touching shapes.\n *\n * @see {@link PibblPhysicsVector2}\n * @see {@link PibblPhysicsContactPoint2D}\n * @see {@link contactBetweenShapes2D}\n */\nexport interface PibblPhysicsShapeContact2D {\n  /** Direction from the second shape toward the first. */\n  readonly normal: PibblPhysicsVector2;\n  /**\n   * Points defining the geometry or reported by the contact query. See\n   * {@link PibblPhysicsContactPoint2D}.\n   */\n  readonly points: readonly PibblPhysicsContactPoint2D[];\n}\n\n/**\n * Point, normal, distance, and time of impact returned by a geometry cast.\n *\n * @see {@link PibblPhysicsVector2}\n * @see {@link raycastShape2D}\n * @see {@link shapeCastAgainstShape2D}\n * @see {@link PibblPhysicsQueryHit2D}\n */\nexport interface PibblPhysicsShapeHit2D {\n  /** A point in the operation's coordinate system. See {@link PibblPhysicsVector2}. */\n  readonly point: PibblPhysicsVector2;\n  /** Contact or surface normal returned by this query. See {@link PibblPhysicsVector2}. */\n  readonly normal: PibblPhysicsVector2;\n  /**\n   * Distance measured in this query or guide's coordinate system. See {@link PibblPhysicsShapeHit2D}\n   * .\n   */\n  readonly distance: number;\n  /** Position along the cast at which contact first occurs. See {@link PibblPhysicsShapeHit2D}. */\n  readonly timeOfImpact: number;\n}\n\nexport {\n  arcShape2D,\n  boundsOfShape2D,\n  boxShape2D,\n  capsuleShape2D,\n  chainShape2D,\n  circleShape2D,\n  ellipseShape2D,\n  massProperties2D,\n  polygonShape2D,\n  roundedBoxShape2D,\n  segmentShape2D,\n  transformShape2D,\n  wedgeShape2D,\n} from './lib/2d/shapes.js';\n\nimport {\n  contactBetweenPreparedShapes2D,\n  containsPointInShape2D,\n  distanceBetweenPreparedShapes2D,\n  overlapPreparedShapes2D,\n} from './lib/2d/collision/pairs.js';\nexport {\n  raycastShape2D,\n  shapeCastAgainstShape2D,\n} from './lib/2d/collision/casts.js';\n\n/**\n * Tests whether a point lies within a posed shape without creating a physics world.\n *\n * @param shape - Shape to test. See {@link PibblPhysicsShape2D}.\n * @param pose - Shape pose. See {@link PibblPhysicsPose2D}.\n * @param point - Point in the same coordinate space as the posed shape. See\n * {@link PibblPhysicsVector2} .\n * @returns Whether the posed shape contains the point.\n *\n * @see {@link PibblPhysicsShape2D}\n * @see {@link PibblPhysicsPose2D}\n * @see {@link PibblPhysicsVector2}\n */\nexport function containsPoint2D(\n  shape: PibblPhysicsShape2D,\n  pose: PibblPhysicsPose2D,\n  point: PibblPhysicsVector2,\n): boolean {\n  return containsPointInShape2D(shape, pose, point);\n}\n\n/**\n * Computes signed separation and witness geometry between two posed shapes.\n *\n * @param first - First shape. See {@link PibblPhysicsShape2D}.\n * @param firstPose - Pose of the first shape. See {@link PibblPhysicsPose2D}.\n * @param second - Second shape. See {@link PibblPhysicsShape2D}.\n * @param secondPose - Pose of the second shape. See {@link PibblPhysicsPose2D}.\n * @returns Distance and closest-point information for the two posed shapes. See\n * {@link PibblPhysicsDistance2D} .\n *\n * @see {@link PibblPhysicsShape2D}\n * @see {@link PibblPhysicsPose2D}\n * @see {@link PibblPhysicsDistance2D}\n */\nexport function distanceBetweenShapes2D(\n  first: PibblPhysicsShape2D,\n  firstPose: PibblPhysicsPose2D,\n  second: PibblPhysicsShape2D,\n  secondPose: PibblPhysicsPose2D,\n): PibblPhysicsDistance2D {\n  return distanceBetweenPreparedShapes2D(first, firstPose, second, secondPose);\n}\n\n/**\n * Tests whether two posed shapes overlap without creating a physics world.\n *\n * @param first - First shape. See {@link PibblPhysicsShape2D}.\n * @param firstPose - Pose of the first shape. See {@link PibblPhysicsPose2D}.\n * @param second - Second shape. See {@link PibblPhysicsShape2D}.\n * @param secondPose - Pose of the second shape. See {@link PibblPhysicsPose2D}.\n * @returns Whether the two posed shapes overlap.\n *\n * @see {@link PibblPhysicsShape2D}\n * @see {@link PibblPhysicsPose2D}\n */\nexport function overlapShapes2D(\n  first: PibblPhysicsShape2D,\n  firstPose: PibblPhysicsPose2D,\n  second: PibblPhysicsShape2D,\n  secondPose: PibblPhysicsPose2D,\n): boolean {\n  return overlapPreparedShapes2D(first, firstPose, second, secondPose);\n}\n\n/**\n * Computes contact geometry for two posed shapes, or null when they do not contact.\n *\n * @param first - First shape. See {@link PibblPhysicsShape2D}.\n * @param firstPose - Pose of the first shape. See {@link PibblPhysicsPose2D}.\n * @param second - Second shape. See {@link PibblPhysicsShape2D}.\n * @param secondPose - Pose of the second shape. See {@link PibblPhysicsPose2D}.\n * @returns Contact information, or null when the shapes do not contact. See\n * {@link PibblPhysicsShapeContact2D} .\n *\n * @see {@link PibblPhysicsShape2D}\n * @see {@link PibblPhysicsPose2D}\n * @see {@link PibblPhysicsShapeContact2D}\n */\nexport function contactBetweenShapes2D(\n  first: PibblPhysicsShape2D,\n  firstPose: PibblPhysicsPose2D,\n  second: PibblPhysicsShape2D,\n  secondPose: PibblPhysicsPose2D,\n): PibblPhysicsShapeContact2D | null {\n  return contactBetweenPreparedShapes2D(first, firstPose, second, secondPose);\n}\n"],
   "mappings": "AAwKA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAEP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP;AAAA,EACE;AAAA,EACA;AAAA,OACK;AAeA,SAAS,gBACd,OACA,MACA,OACS;AACT,SAAO,uBAAuB,OAAO,MAAM,KAAK;AAClD;AAgBO,SAAS,wBACd,OACA,WACA,QACA,YACwB;AACxB,SAAO,gCAAgC,OAAO,WAAW,QAAQ,UAAU;AAC7E;AAcO,SAAS,gBACd,OACA,WACA,QACA,YACS;AACT,SAAO,wBAAwB,OAAO,WAAW,QAAQ,UAAU;AACrE;AAgBO,SAAS,uBACd,OACA,WACA,QACA,YACmC;AACnC,SAAO,+BAA+B,OAAO,WAAW,QAAQ,UAAU;AAC5E;",
   "names": []
 }

package/dist/features/physics/2d.d.ts

@@ -1,5 +1,5 @@
 import type { PibblPhysicsAabb2D, PibblPhysicsPose2D, PibblPhysicsRay2D, PibblPhysicsShape2D, PibblPhysicsVector2 } from "./2d-geometry.js";
-import type { PibblPhysicsQueryHit2D, PibblPhysicsQueryMatch2D, PibblPhysicsQueryMode, PibblPhysicsQueryOptions2D, PibblPhysicsQueryResult2D, PibblPhysicsBodyHandle2D, PibblPhysicsWorldHandle2D } from "./lib/2d/types.js";
+import type { PibblPhysicsQueryHit2D, PibblPhysicsQueryMatch2D, PibblPhysicsQueryOptions2D, PibblPhysicsBodyHandle2D, PibblPhysicsWorldHandle2D } from "./lib/2d/types.js";
 import { collider2D, dynamicBody2D, kinematicBody2D, staticBody2D } from "./lib/2d/runtime/descriptors.js";
 import { PhysicsWorld2D, pibblPhysicsWorld2D } from "./lib/2d/runtime/world-component.js";
 import { Capsule2D, Chain2D, PhysicsShape2D, Segment2D } from "./lib/2d/canvas/components.js";
@@ -16,96 +16,149 @@ export { pibblPhysicsBody2D };
 export { pibblPhysicsWorld2D };
 export { applyForce2D, applyImpulse2D, applyTorque2D, disableBody2D, enableBody2D, setAngularVelocity2D, setLinearVelocity2D, sleepBody2D, teleportBody2D, wakeBody2D, };
 /**
- * Queries the committed world with a ray using the selected result mode and filters.
+ * Tests whether the committed world has any ray match, stopping at the first match.
  *
  * @param world - World to query. See {@link PibblPhysicsWorldHandle2D}.
  * @param ray - Ray origin, direction, and travel limit. See {@link PibblPhysicsRay2D}.
- * @param options - Result mode and collider filtering. See {@link PibblPhysicsQueryOptions2D}.
- * @returns A boolean for any mode, one hit or null for closest mode, or ordered hits for all mode.
- * See {@link PibblPhysicsQueryResult2D} , {@link PibblPhysicsQueryHit2D} .
+ * @param options - Sensor policy and collider filtering. See {@link PibblPhysicsQueryOptions2D}.
+ * @returns Whether a matching collider exists.
+ */
+export declare function raycastAny2D(world: PibblPhysicsWorldHandle2D, ray: PibblPhysicsRay2D, options?: PibblPhysicsQueryOptions2D): boolean;
+/**
+ * Returns the first ray result ordered by time of impact, distance, then collider identity, or null.
  *
- * @see {@link PibblPhysicsWorldHandle2D}
- * @see {@link PibblPhysicsRay2D}
- * @see {@link PibblPhysicsQueryOptions2D}
- * @see {@link PibblPhysicsQueryResult2D}
- * @see {@link PibblPhysicsQueryHit2D}
- * @see {@link PibblPhysicsQueryMode}
+ * @param world - World to query. See {@link PibblPhysicsWorldHandle2D}.
+ * @param ray - Ray origin, direction, and travel limit. See {@link PibblPhysicsRay2D}.
+ * @param options - Sensor policy and collider filtering. See {@link PibblPhysicsQueryOptions2D}.
+ * @returns One result or null. See {@link PibblPhysicsQueryHit2D}.
  */
-export declare function raycast2D<Mode extends PibblPhysicsQueryMode = "closest">(world: PibblPhysicsWorldHandle2D, ray: PibblPhysicsRay2D, options?: PibblPhysicsQueryOptions2D<Mode>): PibblPhysicsQueryResult2D<Mode, PibblPhysicsQueryHit2D>;
+export declare function raycastClosest2D(world: PibblPhysicsWorldHandle2D, ray: PibblPhysicsRay2D, options?: PibblPhysicsQueryOptions2D): PibblPhysicsQueryHit2D | null;
 /**
- * Sweeps a shape through the committed world using the selected result mode and filters.
+ * Returns all ray results ordered by time of impact, distance, then collider identity as a frozen array.
+ *
+ * @param world - World to query. See {@link PibblPhysicsWorldHandle2D}.
+ * @param ray - Ray origin, direction, and travel limit. See {@link PibblPhysicsRay2D}.
+ * @param options - Sensor policy and collider filtering. See {@link PibblPhysicsQueryOptions2D}.
+ * @returns Frozen results, empty when no collider matches. See {@link PibblPhysicsQueryHit2D}.
+ */
+export declare function raycastAll2D(world: PibblPhysicsWorldHandle2D, ray: PibblPhysicsRay2D, options?: PibblPhysicsQueryOptions2D): readonly PibblPhysicsQueryHit2D[];
+/**
+ * Tests whether the committed world has any shape sweep match, stopping at the first match.
  *
  * @param world - World to query. See {@link PibblPhysicsWorldHandle2D}.
  * @param shape - Shape to sweep. See {@link PibblPhysicsShape2D}.
  * @param from - Initial shape pose. See {@link PibblPhysicsPose2D}.
  * @param translation - Translation vector for the sweep. See {@link PibblPhysicsVector2}.
- * @param options - Result mode and collider filtering. See {@link PibblPhysicsQueryOptions2D}.
- * @returns A boolean for any mode, one hit or null for closest mode, or ordered hits for all mode.
- * See {@link PibblPhysicsQueryResult2D} , {@link PibblPhysicsQueryHit2D} .
+ * @param options - Sensor policy and collider filtering. See {@link PibblPhysicsQueryOptions2D}.
+ * @returns Whether a matching collider exists.
+ */
+export declare function shapeCastAny2D(world: PibblPhysicsWorldHandle2D, shape: PibblPhysicsShape2D, from: PibblPhysicsPose2D, translation: PibblPhysicsVector2, options?: PibblPhysicsQueryOptions2D): boolean;
+/**
+ * Returns the first shape sweep result ordered by time of impact, distance, then collider identity, or null.
  *
- * @see {@link PibblPhysicsWorldHandle2D}
- * @see {@link PibblPhysicsShape2D}
- * @see {@link PibblPhysicsPose2D}
- * @see {@link PibblPhysicsVector2}
- * @see {@link PibblPhysicsQueryOptions2D}
- * @see {@link PibblPhysicsQueryResult2D}
- * @see {@link PibblPhysicsQueryHit2D}
- * @see {@link PibblPhysicsQueryMode}
+ * @param world - World to query. See {@link PibblPhysicsWorldHandle2D}.
+ * @param shape - Shape to sweep. See {@link PibblPhysicsShape2D}.
+ * @param from - Initial shape pose. See {@link PibblPhysicsPose2D}.
+ * @param translation - Translation vector for the sweep. See {@link PibblPhysicsVector2}.
+ * @param options - Sensor policy and collider filtering. See {@link PibblPhysicsQueryOptions2D}.
+ * @returns One result or null. See {@link PibblPhysicsQueryHit2D}.
+ */
+export declare function shapeCastClosest2D(world: PibblPhysicsWorldHandle2D, shape: PibblPhysicsShape2D, from: PibblPhysicsPose2D, translation: PibblPhysicsVector2, options?: PibblPhysicsQueryOptions2D): PibblPhysicsQueryHit2D | null;
+/**
+ * Returns all shape sweep results ordered by time of impact, distance, then collider identity as a frozen array.
+ *
+ * @param world - World to query. See {@link PibblPhysicsWorldHandle2D}.
+ * @param shape - Shape to sweep. See {@link PibblPhysicsShape2D}.
+ * @param from - Initial shape pose. See {@link PibblPhysicsPose2D}.
+ * @param translation - Translation vector for the sweep. See {@link PibblPhysicsVector2}.
+ * @param options - Sensor policy and collider filtering. See {@link PibblPhysicsQueryOptions2D}.
+ * @returns Frozen results, empty when no collider matches. See {@link PibblPhysicsQueryHit2D}.
+ */
+export declare function shapeCastAll2D(world: PibblPhysicsWorldHandle2D, shape: PibblPhysicsShape2D, from: PibblPhysicsPose2D, translation: PibblPhysicsVector2, options?: PibblPhysicsQueryOptions2D): readonly PibblPhysicsQueryHit2D[];
+/**
+ * Tests whether the committed world has any shape overlap match, stopping at the first match.
+ *
+ * @param world - World to query. See {@link PibblPhysicsWorldHandle2D}.
+ * @param shape - Shape to test. See {@link PibblPhysicsShape2D}.
+ * @param pose - Shape pose. See {@link PibblPhysicsPose2D}.
+ * @param options - Sensor policy and collider filtering. See {@link PibblPhysicsQueryOptions2D}.
+ * @returns Whether a matching collider exists.
  */
-export declare function shapeCast2D<Mode extends PibblPhysicsQueryMode = "closest">(world: PibblPhysicsWorldHandle2D, shape: PibblPhysicsShape2D, from: PibblPhysicsPose2D, translation: PibblPhysicsVector2, options?: PibblPhysicsQueryOptions2D<Mode>): PibblPhysicsQueryResult2D<Mode, PibblPhysicsQueryHit2D>;
+export declare function hasShapeOverlap2D(world: PibblPhysicsWorldHandle2D, shape: PibblPhysicsShape2D, pose: PibblPhysicsPose2D, options?: PibblPhysicsQueryOptions2D): boolean;
 /**
- * Queries committed world colliders overlapping a posed shape.
+ * Returns the first shape overlap result ordered by collider index, then generation, or null.
  *
  * @param world - World to query. See {@link PibblPhysicsWorldHandle2D}.
- * @param shape - Shape to test for overlaps. See {@link PibblPhysicsShape2D}.
+ * @param shape - Shape to test. See {@link PibblPhysicsShape2D}.
  * @param pose - Shape pose. See {@link PibblPhysicsPose2D}.
- * @param options - Result mode and collider filtering. See {@link PibblPhysicsQueryOptions2D}.
- * @returns A boolean for any mode, one match or null for closest mode, or matches for all mode.
- * See {@link PibblPhysicsQueryResult2D} , {@link PibblPhysicsQueryMatch2D} .
+ * @param options - Sensor policy and collider filtering. See {@link PibblPhysicsQueryOptions2D}.
+ * @returns One result or null. See {@link PibblPhysicsQueryMatch2D}.
+ */
+export declare function findShapeOverlap2D(world: PibblPhysicsWorldHandle2D, shape: PibblPhysicsShape2D, pose: PibblPhysicsPose2D, options?: PibblPhysicsQueryOptions2D): PibblPhysicsQueryMatch2D | null;
+/**
+ * Returns all shape overlap results ordered by collider index, then generation as a frozen array.
  *
- * @see {@link PibblPhysicsWorldHandle2D}
- * @see {@link PibblPhysicsShape2D}
- * @see {@link PibblPhysicsPose2D}
- * @see {@link PibblPhysicsQueryOptions2D}
- * @see {@link PibblPhysicsQueryResult2D}
- * @see {@link PibblPhysicsQueryMatch2D}
- * @see {@link PibblPhysicsQueryMode}
+ * @param world - World to query. See {@link PibblPhysicsWorldHandle2D}.
+ * @param shape - Shape to test. See {@link PibblPhysicsShape2D}.
+ * @param pose - Shape pose. See {@link PibblPhysicsPose2D}.
+ * @param options - Sensor policy and collider filtering. See {@link PibblPhysicsQueryOptions2D}.
+ * @returns Frozen results, empty when no collider matches. See {@link PibblPhysicsQueryMatch2D}.
  */
-export declare function overlapShape2D<Mode extends PibblPhysicsQueryMode = "closest">(world: PibblPhysicsWorldHandle2D, shape: PibblPhysicsShape2D, pose: PibblPhysicsPose2D, options?: PibblPhysicsQueryOptions2D<Mode>): PibblPhysicsQueryResult2D<Mode, PibblPhysicsQueryMatch2D>;
+export declare function findAllShapeOverlaps2D(world: PibblPhysicsWorldHandle2D, shape: PibblPhysicsShape2D, pose: PibblPhysicsPose2D, options?: PibblPhysicsQueryOptions2D): readonly PibblPhysicsQueryMatch2D[];
 /**
- * Queries committed world colliders intersecting an axis-aligned region.
+ * Tests whether the committed world has any bounds intersection match, stopping at the first match.
  *
  * @param world - World to query. See {@link PibblPhysicsWorldHandle2D}.
- * @param bounds - Axis-aligned query bounds in public coordinates. See {@link PibblPhysicsAabb2D}.
- * @param options - Result mode and collider filtering. See {@link PibblPhysicsQueryOptions2D}.
- * @returns A boolean for any mode, one match or null for closest mode, or matches for all mode.
- * See {@link PibblPhysicsQueryResult2D} , {@link PibblPhysicsQueryMatch2D} .
+ * @param bounds - Axis-aligned query bounds. See {@link PibblPhysicsAabb2D}.
+ * @param options - Sensor policy and collider filtering. See {@link PibblPhysicsQueryOptions2D}.
+ * @returns Whether a matching collider exists.
+ */
+export declare function hasAabbMatch2D(world: PibblPhysicsWorldHandle2D, bounds: PibblPhysicsAabb2D, options?: PibblPhysicsQueryOptions2D): boolean;
+/**
+ * Returns the first bounds intersection result ordered by collider index, then generation, or null.
  *
- * @see {@link PibblPhysicsWorldHandle2D}
- * @see {@link PibblPhysicsAabb2D}
- * @see {@link PibblPhysicsQueryOptions2D}
- * @see {@link PibblPhysicsQueryResult2D}
- * @see {@link PibblPhysicsQueryMatch2D}
- * @see {@link PibblPhysicsQueryMode}
+ * @param world - World to query. See {@link PibblPhysicsWorldHandle2D}.
+ * @param bounds - Axis-aligned query bounds. See {@link PibblPhysicsAabb2D}.
+ * @param options - Sensor policy and collider filtering. See {@link PibblPhysicsQueryOptions2D}.
+ * @returns One result or null. See {@link PibblPhysicsQueryMatch2D}.
  */
-export declare function queryAabb2D<Mode extends PibblPhysicsQueryMode = "closest">(world: PibblPhysicsWorldHandle2D, bounds: PibblPhysicsAabb2D, options?: PibblPhysicsQueryOptions2D<Mode>): PibblPhysicsQueryResult2D<Mode, PibblPhysicsQueryMatch2D>;
+export declare function findAabbMatch2D(world: PibblPhysicsWorldHandle2D, bounds: PibblPhysicsAabb2D, options?: PibblPhysicsQueryOptions2D): PibblPhysicsQueryMatch2D | null;
 /**
- * Queries committed world colliders containing a point.
+ * Returns all bounds intersection results ordered by collider index, then generation as a frozen array.
  *
  * @param world - World to query. See {@link PibblPhysicsWorldHandle2D}.
- * @param point - Point in public coordinates. See {@link PibblPhysicsVector2}.
- * @param options - Result mode and collider filtering. See {@link PibblPhysicsQueryOptions2D}.
- * @returns A boolean for any mode, one match or null for closest mode, or matches for all mode.
- * See {@link PibblPhysicsQueryResult2D} , {@link PibblPhysicsQueryMatch2D} .
+ * @param bounds - Axis-aligned query bounds. See {@link PibblPhysicsAabb2D}.
+ * @param options - Sensor policy and collider filtering. See {@link PibblPhysicsQueryOptions2D}.
+ * @returns Frozen results, empty when no collider matches. See {@link PibblPhysicsQueryMatch2D}.
+ */
+export declare function findAllAabbMatches2D(world: PibblPhysicsWorldHandle2D, bounds: PibblPhysicsAabb2D, options?: PibblPhysicsQueryOptions2D): readonly PibblPhysicsQueryMatch2D[];
+/**
+ * Tests whether the committed world has any point containment match, stopping at the first match.
  *
- * @see {@link PibblPhysicsWorldHandle2D}
- * @see {@link PibblPhysicsVector2}
- * @see {@link PibblPhysicsQueryOptions2D}
- * @see {@link PibblPhysicsQueryResult2D}
- * @see {@link PibblPhysicsQueryMatch2D}
- * @see {@link PibblPhysicsQueryMode}
+ * @param world - World to query. See {@link PibblPhysicsWorldHandle2D}.
+ * @param point - Point in simulation coordinates. See {@link PibblPhysicsVector2}.
+ * @param options - Sensor policy and collider filtering. See {@link PibblPhysicsQueryOptions2D}.
+ * @returns Whether a matching collider exists.
+ */
+export declare function hasPointMatch2D(world: PibblPhysicsWorldHandle2D, point: PibblPhysicsVector2, options?: PibblPhysicsQueryOptions2D): boolean;
+/**
+ * Returns the first point containment result ordered by collider index, then generation, or null.
+ *
+ * @param world - World to query. See {@link PibblPhysicsWorldHandle2D}.
+ * @param point - Point in simulation coordinates. See {@link PibblPhysicsVector2}.
+ * @param options - Sensor policy and collider filtering. See {@link PibblPhysicsQueryOptions2D}.
+ * @returns One result or null. See {@link PibblPhysicsQueryMatch2D}.
+ */
+export declare function findPointMatch2D(world: PibblPhysicsWorldHandle2D, point: PibblPhysicsVector2, options?: PibblPhysicsQueryOptions2D): PibblPhysicsQueryMatch2D | null;
+/**
+ * Returns all point containment results ordered by collider index, then generation as a frozen array.
+ *
+ * @param world - World to query. See {@link PibblPhysicsWorldHandle2D}.
+ * @param point - Point in simulation coordinates. See {@link PibblPhysicsVector2}.
+ * @param options - Sensor policy and collider filtering. See {@link PibblPhysicsQueryOptions2D}.
+ * @returns Frozen results, empty when no collider matches. See {@link PibblPhysicsQueryMatch2D}.
  */
-export declare function queryPoint2D<Mode extends PibblPhysicsQueryMode = "closest">(world: PibblPhysicsWorldHandle2D, point: PibblPhysicsVector2, options?: PibblPhysicsQueryOptions2D<Mode>): PibblPhysicsQueryResult2D<Mode, PibblPhysicsQueryMatch2D>;
+export declare function findAllPointMatches2D(world: PibblPhysicsWorldHandle2D, point: PibblPhysicsVector2, options?: PibblPhysicsQueryOptions2D): readonly PibblPhysicsQueryMatch2D[];
 /**
  * Converts root-logical pointer coordinates to this world's simulation space.
  *

package/dist/features/physics/2d.js

@@ -37,29 +37,50 @@ import {
   shapeCastAgainstShape2D
 } from "./lib/2d/collision/casts.js";
 export * from "./lib/2d/types.js";
-function raycast2D(world, ray, options) {
-  return requirePhysicsWorld2DController(world).raycast(ray, options);
-}
-function shapeCast2D(world, shape, from, translation, options) {
-  return requirePhysicsWorld2DController(world).shapeCast(
-    shape,
-    from,
-    translation,
-    options
-  );
-}
-function overlapShape2D(world, shape, pose, options) {
-  return requirePhysicsWorld2DController(world).overlapShape(
-    shape,
-    pose,
-    options
-  );
-}
-function queryAabb2D(world, bounds, options) {
-  return requirePhysicsWorld2DController(world).queryAabb(bounds, options);
-}
-function queryPoint2D(world, point, options) {
-  return requirePhysicsWorld2DController(world).queryPoint(point, options);
+function raycastAny2D(world, ray, options) {
+  return requirePhysicsWorld2DController(world).raycast(ray, { ...options, mode: "any" });
+}
+function raycastClosest2D(world, ray, options) {
+  return requirePhysicsWorld2DController(world).raycast(ray, { ...options, mode: "closest" });
+}
+function raycastAll2D(world, ray, options) {
+  return requirePhysicsWorld2DController(world).raycast(ray, { ...options, mode: "all" });
+}
+function shapeCastAny2D(world, shape, from, translation, options) {
+  return requirePhysicsWorld2DController(world).shapeCast(shape, from, translation, { ...options, mode: "any" });
+}
+function shapeCastClosest2D(world, shape, from, translation, options) {
+  return requirePhysicsWorld2DController(world).shapeCast(shape, from, translation, { ...options, mode: "closest" });
+}
+function shapeCastAll2D(world, shape, from, translation, options) {
+  return requirePhysicsWorld2DController(world).shapeCast(shape, from, translation, { ...options, mode: "all" });
+}
+function hasShapeOverlap2D(world, shape, pose, options) {
+  return requirePhysicsWorld2DController(world).overlapShape(shape, pose, { ...options, mode: "any" });
+}
+function findShapeOverlap2D(world, shape, pose, options) {
+  return requirePhysicsWorld2DController(world).overlapShape(shape, pose, { ...options, mode: "closest" });
+}
+function findAllShapeOverlaps2D(world, shape, pose, options) {
+  return requirePhysicsWorld2DController(world).overlapShape(shape, pose, { ...options, mode: "all" });
+}
+function hasAabbMatch2D(world, bounds, options) {
+  return requirePhysicsWorld2DController(world).queryAabb(bounds, { ...options, mode: "any" });
+}
+function findAabbMatch2D(world, bounds, options) {
+  return requirePhysicsWorld2DController(world).queryAabb(bounds, { ...options, mode: "closest" });
+}
+function findAllAabbMatches2D(world, bounds, options) {
+  return requirePhysicsWorld2DController(world).queryAabb(bounds, { ...options, mode: "all" });
+}
+function hasPointMatch2D(world, point, options) {
+  return requirePhysicsWorld2DController(world).queryPoint(point, { ...options, mode: "any" });
+}
+function findPointMatch2D(world, point, options) {
+  return requirePhysicsWorld2DController(world).queryPoint(point, { ...options, mode: "closest" });
+}
+function findAllPointMatches2D(world, point, options) {
+  return requirePhysicsWorld2DController(world).queryPoint(point, { ...options, mode: "all" });
 }
 function toPhysicsPoint2D(world, point) {
   return requirePhysicsWorld2DController(world).convertPoint(point, false);
@@ -94,21 +115,31 @@ export {
   disableBody2D,
   dynamicBody2D,
   enableBody2D,
+  findAabbMatch2D,
+  findAllAabbMatches2D,
+  findAllPointMatches2D,
+  findAllShapeOverlaps2D,
+  findPointMatch2D,
+  findShapeOverlap2D,
   fromPhysicsPoint2D,
+  hasAabbMatch2D,
+  hasPointMatch2D,
+  hasShapeOverlap2D,
   inspectPhysics2D,
   kinematicBody2D,
-  overlapShape2D,
   physicsObstacles2D,
   pibblPhysicsBody2D,
   pibblPhysicsWorld2D,
-  queryAabb2D,
-  queryPoint2D,
-  raycast2D,
+  raycastAll2D,
+  raycastAny2D,
+  raycastClosest2D,
   raycastShape2D,
   setAngularVelocity2D,
   setLinearVelocity2D,
-  shapeCast2D,
   shapeCastAgainstShape2D,
+  shapeCastAll2D,
+  shapeCastAny2D,
+  shapeCastClosest2D,
   sleepBody2D,
   staticBody2D,
   teleportBody2D,

package/dist/features/physics/2d.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/features/physics/2d.ts"],
-  "sourcesContent": ["import type { PibblPhysicsInspection2D, PibblPhysicsBodyInspection2D } from \"./lib/2d/inspection-types.js\";\nimport type {\n  PibblPhysicsAabb2D,\n  PibblPhysicsPose2D,\n  PibblPhysicsRay2D,\n  PibblPhysicsShape2D,\n  PibblPhysicsVector2,\n} from \"./2d-geometry.js\";\nimport type {\n  PibblPhysicsQueryHit2D,\n  PibblPhysicsQueryMatch2D,\n  PibblPhysicsQueryMode,\n  PibblPhysicsQueryOptions2D,\n  PibblPhysicsQueryResult2D,\n  PibblPhysicsBodyHandle2D,\n  PibblPhysicsWorldHandle2D,\n} from \"./lib/2d/types.js\";\nimport {\n  collider2D,\n  dynamicBody2D,\n  kinematicBody2D,\n  staticBody2D,\n} from \"./lib/2d/runtime/descriptors.js\";\nimport {\n  PhysicsWorld2D,\n  pibblPhysicsWorld2D,\n} from \"./lib/2d/runtime/world-component.js\";\nimport {\n  Capsule2D,\n  Chain2D,\n  PhysicsShape2D,\n  Segment2D,\n} from \"./lib/2d/canvas/components.js\";\nimport { withPhysicsShape2D } from \"./lib/2d/canvas/custom.js\";\nimport {\n  applyForce2D,\n  applyImpulse2D,\n  applyTorque2D,\n  pibblPhysicsBody2D,\n  disableBody2D,\n  enableBody2D,\n  isPhysicsBodyHandle2D,\n  physicsBodyHandleBinding2D,\n  setAngularVelocity2D,\n  setLinearVelocity2D,\n  sleepBody2D,\n  teleportBody2D,\n  wakeBody2D,\n} from \"./lib/2d/runtime/body-handle.js\";\nimport { requirePhysicsWorld2DController } from \"./lib/2d/runtime/controller.js\";\n\nexport * from \"./2d-geometry.js\";\nexport {\n  raycastShape2D,\n  shapeCastAgainstShape2D,\n} from \"./lib/2d/collision/casts.js\";\nexport * from \"./lib/2d/types.js\";\n\nexport { PhysicsWorld2D };\nexport { PhysicsShape2D, Capsule2D, Segment2D, Chain2D };\n\nexport { collider2D, dynamicBody2D, kinematicBody2D, staticBody2D };\nexport { withPhysicsShape2D };\n\nexport { pibblPhysicsBody2D };\n\nexport { pibblPhysicsWorld2D };\n\nexport {\n  applyForce2D,\n  applyImpulse2D,\n  applyTorque2D,\n  disableBody2D,\n  enableBody2D,\n  setAngularVelocity2D,\n  setLinearVelocity2D,\n  sleepBody2D,\n  teleportBody2D,\n  wakeBody2D,\n};\n\n/**\n * Queries the committed world with a ray using the selected result mode and filters.\n *\n * @param world - World to query. See {@link PibblPhysicsWorldHandle2D}.\n * @param ray - Ray origin, direction, and travel limit. See {@link PibblPhysicsRay2D}.\n * @param options - Result mode and collider filtering. See {@link PibblPhysicsQueryOptions2D}.\n * @returns A boolean for any mode, one hit or null for closest mode, or ordered hits for all mode.\n * See {@link PibblPhysicsQueryResult2D} , {@link PibblPhysicsQueryHit2D} .\n *\n * @see {@link PibblPhysicsWorldHandle2D}\n * @see {@link PibblPhysicsRay2D}\n * @see {@link PibblPhysicsQueryOptions2D}\n * @see {@link PibblPhysicsQueryResult2D}\n * @see {@link PibblPhysicsQueryHit2D}\n * @see {@link PibblPhysicsQueryMode}\n */\nexport function raycast2D<Mode extends PibblPhysicsQueryMode = \"closest\">(\n  world: PibblPhysicsWorldHandle2D,\n  ray: PibblPhysicsRay2D,\n  options?: PibblPhysicsQueryOptions2D<Mode>,\n): PibblPhysicsQueryResult2D<Mode, PibblPhysicsQueryHit2D> {\n  return requirePhysicsWorld2DController(world).raycast(ray, options);\n}\n\n/**\n * Sweeps a shape through the committed world using the selected result mode and filters.\n *\n * @param world - World to query. See {@link PibblPhysicsWorldHandle2D}.\n * @param shape - Shape to sweep. See {@link PibblPhysicsShape2D}.\n * @param from - Initial shape pose. See {@link PibblPhysicsPose2D}.\n * @param translation - Translation vector for the sweep. See {@link PibblPhysicsVector2}.\n * @param options - Result mode and collider filtering. See {@link PibblPhysicsQueryOptions2D}.\n * @returns A boolean for any mode, one hit or null for closest mode, or ordered hits for all mode.\n * See {@link PibblPhysicsQueryResult2D} , {@link PibblPhysicsQueryHit2D} .\n *\n * @see {@link PibblPhysicsWorldHandle2D}\n * @see {@link PibblPhysicsShape2D}\n * @see {@link PibblPhysicsPose2D}\n * @see {@link PibblPhysicsVector2}\n * @see {@link PibblPhysicsQueryOptions2D}\n * @see {@link PibblPhysicsQueryResult2D}\n * @see {@link PibblPhysicsQueryHit2D}\n * @see {@link PibblPhysicsQueryMode}\n */\nexport function shapeCast2D<Mode extends PibblPhysicsQueryMode = \"closest\">(\n  world: PibblPhysicsWorldHandle2D,\n  shape: PibblPhysicsShape2D,\n  from: PibblPhysicsPose2D,\n  translation: PibblPhysicsVector2,\n  options?: PibblPhysicsQueryOptions2D<Mode>,\n): PibblPhysicsQueryResult2D<Mode, PibblPhysicsQueryHit2D> {\n  return requirePhysicsWorld2DController(world).shapeCast(\n    shape,\n    from,\n    translation,\n    options,\n  );\n}\n\n/**\n * Queries committed world colliders overlapping a posed shape.\n *\n * @param world - World to query. See {@link PibblPhysicsWorldHandle2D}.\n * @param shape - Shape to test for overlaps. See {@link PibblPhysicsShape2D}.\n * @param pose - Shape pose. See {@link PibblPhysicsPose2D}.\n * @param options - Result mode and collider filtering. See {@link PibblPhysicsQueryOptions2D}.\n * @returns A boolean for any mode, one match or null for closest mode, or matches for all mode.\n * See {@link PibblPhysicsQueryResult2D} , {@link PibblPhysicsQueryMatch2D} .\n *\n * @see {@link PibblPhysicsWorldHandle2D}\n * @see {@link PibblPhysicsShape2D}\n * @see {@link PibblPhysicsPose2D}\n * @see {@link PibblPhysicsQueryOptions2D}\n * @see {@link PibblPhysicsQueryResult2D}\n * @see {@link PibblPhysicsQueryMatch2D}\n * @see {@link PibblPhysicsQueryMode}\n */\nexport function overlapShape2D<Mode extends PibblPhysicsQueryMode = \"closest\">(\n  world: PibblPhysicsWorldHandle2D,\n  shape: PibblPhysicsShape2D,\n  pose: PibblPhysicsPose2D,\n  options?: PibblPhysicsQueryOptions2D<Mode>,\n): PibblPhysicsQueryResult2D<Mode, PibblPhysicsQueryMatch2D> {\n  return requirePhysicsWorld2DController(world).overlapShape(\n    shape,\n    pose,\n    options,\n  );\n}\n\n/**\n * Queries committed world colliders intersecting an axis-aligned region.\n *\n * @param world - World to query. See {@link PibblPhysicsWorldHandle2D}.\n * @param bounds - Axis-aligned query bounds in public coordinates. See {@link PibblPhysicsAabb2D}.\n * @param options - Result mode and collider filtering. See {@link PibblPhysicsQueryOptions2D}.\n * @returns A boolean for any mode, one match or null for closest mode, or matches for all mode.\n * See {@link PibblPhysicsQueryResult2D} , {@link PibblPhysicsQueryMatch2D} .\n *\n * @see {@link PibblPhysicsWorldHandle2D}\n * @see {@link PibblPhysicsAabb2D}\n * @see {@link PibblPhysicsQueryOptions2D}\n * @see {@link PibblPhysicsQueryResult2D}\n * @see {@link PibblPhysicsQueryMatch2D}\n * @see {@link PibblPhysicsQueryMode}\n */\nexport function queryAabb2D<Mode extends PibblPhysicsQueryMode = \"closest\">(\n  world: PibblPhysicsWorldHandle2D,\n  bounds: PibblPhysicsAabb2D,\n  options?: PibblPhysicsQueryOptions2D<Mode>,\n): PibblPhysicsQueryResult2D<Mode, PibblPhysicsQueryMatch2D> {\n  return requirePhysicsWorld2DController(world).queryAabb(bounds, options);\n}\n\n/**\n * Queries committed world colliders containing a point.\n *\n * @param world - World to query. See {@link PibblPhysicsWorldHandle2D}.\n * @param point - Point in public coordinates. See {@link PibblPhysicsVector2}.\n * @param options - Result mode and collider filtering. See {@link PibblPhysicsQueryOptions2D}.\n * @returns A boolean for any mode, one match or null for closest mode, or matches for all mode.\n * See {@link PibblPhysicsQueryResult2D} , {@link PibblPhysicsQueryMatch2D} .\n *\n * @see {@link PibblPhysicsWorldHandle2D}\n * @see {@link PibblPhysicsVector2}\n * @see {@link PibblPhysicsQueryOptions2D}\n * @see {@link PibblPhysicsQueryResult2D}\n * @see {@link PibblPhysicsQueryMatch2D}\n * @see {@link PibblPhysicsQueryMode}\n */\nexport function queryPoint2D<Mode extends PibblPhysicsQueryMode = \"closest\">(\n  world: PibblPhysicsWorldHandle2D,\n  point: PibblPhysicsVector2,\n  options?: PibblPhysicsQueryOptions2D<Mode>,\n): PibblPhysicsQueryResult2D<Mode, PibblPhysicsQueryMatch2D> {\n  return requirePhysicsWorld2DController(world).queryPoint(point, options);\n}\n\n/**\n * Converts root-logical pointer coordinates to this world's simulation space.\n *\n * @param world - World providing unit and coordinate conversion. See\n * {@link PibblPhysicsWorldHandle2D} .\n * @param point - Point in public Canvas coordinates. See {@link PibblPhysicsVector2}.\n * @returns The equivalent point in this world's local simulation space. See\n * {@link PibblPhysicsVector2} .\n *\n * @see {@link PibblPhysicsWorldHandle2D}\n * @see {@link PibblPhysicsVector2}\n */\nexport function toPhysicsPoint2D(\n  world: PibblPhysicsWorldHandle2D,\n  point: PibblPhysicsVector2,\n): PibblPhysicsVector2 {\n  return requirePhysicsWorld2DController(world).convertPoint(point, false);\n}\n\n/**\n * Converts a simulation-space point to root-logical Canvas coordinates.\n *\n * @param world - World providing unit and coordinate conversion. See\n * {@link PibblPhysicsWorldHandle2D} .\n * @param point - Point in this world's local simulation space. See {@link PibblPhysicsVector2}.\n * @returns The equivalent point in public Canvas coordinates. See {@link PibblPhysicsVector2}.\n *\n * @see {@link PibblPhysicsWorldHandle2D}\n * @see {@link PibblPhysicsVector2}\n */\nexport function fromPhysicsPoint2D(\n  world: PibblPhysicsWorldHandle2D,\n  point: PibblPhysicsVector2,\n): PibblPhysicsVector2 {\n  return requirePhysicsWorld2DController(world).convertPoint(point, true);\n}\n\nexport type {\n  PibblPhysicsInspection2D,\n  PibblPhysicsBodyInspection2D,\n  PibblPhysicsColliderInspection2D,\n  PibblPhysicsContactInspection2D,\n} from \"./lib/2d/inspection-types.js\";\n\n/**\n * Returns immutable JSON-safe observations without advancing the simulation. See\n * {@link PibblPhysicsWorldHandle2D}.\n * @param world - World to inspect. See {@link PibblPhysicsWorldHandle2D}.\n * @returns Current world simulation and ownership diagnostics.\n */\nexport function inspectPhysics2D(\n  world: PibblPhysicsWorldHandle2D,\n): import(\"./lib/2d/inspection-types.js\").PibblPhysicsInspection2D;\n\n/**\n * Returns the immutable observation for this currently bound body, if any. See\n * {@link PibblPhysicsBodyHandle2D}.\n * @param body - Body to inspect. See {@link PibblPhysicsBodyHandle2D}.\n * @returns Current body diagnostics, or undefined when the handle has no live body.\n */\nexport function inspectPhysics2D(\n  body: PibblPhysicsBodyHandle2D,\n): import(\"./lib/2d/inspection-types.js\").PibblPhysicsBodyInspection2D | undefined;\n/**\n * Returns a diagnostic snapshot of a live world or body, or undefined when unavailable.\n *\n * @param target - World or body handle to inspect. See {@link PibblPhysicsWorldHandle2D} ,\n * {@link PibblPhysicsBodyHandle2D} .\n * @returns The corresponding diagnostics, or undefined for an unmounted body.\n *\n * @see {@link PibblPhysicsWorldHandle2D}\n * @see {@link PibblPhysicsBodyHandle2D}\n * @see {@link PibblPhysicsInspection2D}\n * @see {@link PibblPhysicsBodyInspection2D}\n */\nexport function inspectPhysics2D(\n  target: PibblPhysicsWorldHandle2D | PibblPhysicsBodyHandle2D,\n):\n  | import(\"./lib/2d/inspection-types.js\").PibblPhysicsInspection2D\n  | import(\"./lib/2d/inspection-types.js\").PibblPhysicsBodyInspection2D\n  | undefined {\n  if (isPhysicsBodyHandle2D(target)) {\n    const binding = physicsBodyHandleBinding2D(target);\n    return binding?.controller.inspectBody(binding.bodyId);\n  }\n  return requirePhysicsWorld2DController(target).inspect();\n}\n\nexport {\n  PhysicsDebug2D,\n  type PibblPhysicsDebug2DProps,\n} from \"./lib/2d/canvas/debug.js\";\n\n/**\n * A borrowed committed solid batch, structurally compatible with a flow obstacle source.\n *\n * @param world - World supplying collider geometry. See {@link PibblPhysicsWorldHandle2D}.\n * @returns An obstacle source whose read method returns the current revision and packed geometry.\n *\n * @see {@link PibblPhysicsWorldHandle2D}\n */\nexport function physicsObstacles2D(world: PibblPhysicsWorldHandle2D): Readonly<{\n  read(): Readonly<{ revision: number; boxes: Float64Array; ellipses: Float64Array; polygons: Float64Array }>;\n}> {\n  return requirePhysicsWorld2DController(world).getObstacleSource();\n}\n"],
-  "mappings": "AAiBA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP;AAAA,EACE;AAAA,EACA;AAAA,OACK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,0BAA0B;AACnC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,uCAAuC;AAEhD,cAAc;AACd;AAAA,EACE;AAAA,EACA;AAAA,OACK;AACP,cAAc;AAyCP,SAAS,UACd,OACA,KACA,SACyD;AACzD,SAAO,gCAAgC,KAAK,EAAE,QAAQ,KAAK,OAAO;AACpE;AAsBO,SAAS,YACd,OACA,OACA,MACA,aACA,SACyD;AACzD,SAAO,gCAAgC,KAAK,EAAE;AAAA,IAC5C;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;AAoBO,SAAS,eACd,OACA,OACA,MACA,SAC2D;AAC3D,SAAO,gCAAgC,KAAK,EAAE;AAAA,IAC5C;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;AAkBO,SAAS,YACd,OACA,QACA,SAC2D;AAC3D,SAAO,gCAAgC,KAAK,EAAE,UAAU,QAAQ,OAAO;AACzE;AAkBO,SAAS,aACd,OACA,OACA,SAC2D;AAC3D,SAAO,gCAAgC,KAAK,EAAE,WAAW,OAAO,OAAO;AACzE;AAcO,SAAS,iBACd,OACA,OACqB;AACrB,SAAO,gCAAgC,KAAK,EAAE,aAAa,OAAO,KAAK;AACzE;AAaO,SAAS,mBACd,OACA,OACqB;AACrB,SAAO,gCAAgC,KAAK,EAAE,aAAa,OAAO,IAAI;AACxE;AAwCO,SAAS,iBACd,QAIY;AACZ,MAAI,sBAAsB,MAAM,GAAG;AACjC,UAAM,UAAU,2BAA2B,MAAM;AACjD,WAAO,SAAS,WAAW,YAAY,QAAQ,MAAM;AAAA,EACvD;AACA,SAAO,gCAAgC,MAAM,EAAE,QAAQ;AACzD;AAEA;AAAA,EACE;AAAA,OAEK;AAUA,SAAS,mBAAmB,OAEhC;AACD,SAAO,gCAAgC,KAAK,EAAE,kBAAkB;AAClE;",
+  "sourcesContent": ["import type { PibblPhysicsInspection2D, PibblPhysicsBodyInspection2D } from \"./lib/2d/inspection-types.js\";\nimport type {\n  PibblPhysicsAabb2D,\n  PibblPhysicsPose2D,\n  PibblPhysicsRay2D,\n  PibblPhysicsShape2D,\n  PibblPhysicsVector2,\n} from \"./2d-geometry.js\";\nimport type {\n  PibblPhysicsQueryHit2D,\n  PibblPhysicsQueryMatch2D,\n  PibblPhysicsQueryOptions2D,\n  PibblPhysicsBodyHandle2D,\n  PibblPhysicsWorldHandle2D,\n} from \"./lib/2d/types.js\";\nimport {\n  collider2D,\n  dynamicBody2D,\n  kinematicBody2D,\n  staticBody2D,\n} from \"./lib/2d/runtime/descriptors.js\";\nimport {\n  PhysicsWorld2D,\n  pibblPhysicsWorld2D,\n} from \"./lib/2d/runtime/world-component.js\";\nimport {\n  Capsule2D,\n  Chain2D,\n  PhysicsShape2D,\n  Segment2D,\n} from \"./lib/2d/canvas/components.js\";\nimport { withPhysicsShape2D } from \"./lib/2d/canvas/custom.js\";\nimport {\n  applyForce2D,\n  applyImpulse2D,\n  applyTorque2D,\n  pibblPhysicsBody2D,\n  disableBody2D,\n  enableBody2D,\n  isPhysicsBodyHandle2D,\n  physicsBodyHandleBinding2D,\n  setAngularVelocity2D,\n  setLinearVelocity2D,\n  sleepBody2D,\n  teleportBody2D,\n  wakeBody2D,\n} from \"./lib/2d/runtime/body-handle.js\";\nimport { requirePhysicsWorld2DController } from \"./lib/2d/runtime/controller.js\";\n\nexport * from \"./2d-geometry.js\";\nexport {\n  raycastShape2D,\n  shapeCastAgainstShape2D,\n} from \"./lib/2d/collision/casts.js\";\nexport * from \"./lib/2d/types.js\";\n\nexport { PhysicsWorld2D };\nexport { PhysicsShape2D, Capsule2D, Segment2D, Chain2D };\n\nexport { collider2D, dynamicBody2D, kinematicBody2D, staticBody2D };\nexport { withPhysicsShape2D };\n\nexport { pibblPhysicsBody2D };\n\nexport { pibblPhysicsWorld2D };\n\nexport {\n  applyForce2D,\n  applyImpulse2D,\n  applyTorque2D,\n  disableBody2D,\n  enableBody2D,\n  setAngularVelocity2D,\n  setLinearVelocity2D,\n  sleepBody2D,\n  teleportBody2D,\n  wakeBody2D,\n};\n\n/**\n * Tests whether the committed world has any ray match, stopping at the first match.\n *\n * @param world - World to query. See {@link PibblPhysicsWorldHandle2D}.\n * @param ray - Ray origin, direction, and travel limit. See {@link PibblPhysicsRay2D}.\n * @param options - Sensor policy and collider filtering. See {@link PibblPhysicsQueryOptions2D}.\n * @returns Whether a matching collider exists.\n */\nexport function raycastAny2D(\n  world: PibblPhysicsWorldHandle2D,\n  ray: PibblPhysicsRay2D,\n  options?: PibblPhysicsQueryOptions2D,\n): boolean {\n  return requirePhysicsWorld2DController(world).raycast(ray, { ...options, mode: \"any\" });\n}\n\n/**\n * Returns the first ray result ordered by time of impact, distance, then collider identity, or null.\n *\n * @param world - World to query. See {@link PibblPhysicsWorldHandle2D}.\n * @param ray - Ray origin, direction, and travel limit. See {@link PibblPhysicsRay2D}.\n * @param options - Sensor policy and collider filtering. See {@link PibblPhysicsQueryOptions2D}.\n * @returns One result or null. See {@link PibblPhysicsQueryHit2D}.\n */\nexport function raycastClosest2D(\n  world: PibblPhysicsWorldHandle2D,\n  ray: PibblPhysicsRay2D,\n  options?: PibblPhysicsQueryOptions2D,\n): PibblPhysicsQueryHit2D | null {\n  return requirePhysicsWorld2DController(world).raycast(ray, { ...options, mode: \"closest\" });\n}\n\n/**\n * Returns all ray results ordered by time of impact, distance, then collider identity as a frozen array.\n *\n * @param world - World to query. See {@link PibblPhysicsWorldHandle2D}.\n * @param ray - Ray origin, direction, and travel limit. See {@link PibblPhysicsRay2D}.\n * @param options - Sensor policy and collider filtering. See {@link PibblPhysicsQueryOptions2D}.\n * @returns Frozen results, empty when no collider matches. See {@link PibblPhysicsQueryHit2D}.\n */\nexport function raycastAll2D(\n  world: PibblPhysicsWorldHandle2D,\n  ray: PibblPhysicsRay2D,\n  options?: PibblPhysicsQueryOptions2D,\n): readonly PibblPhysicsQueryHit2D[] {\n  return requirePhysicsWorld2DController(world).raycast(ray, { ...options, mode: \"all\" });\n}\n\n/**\n * Tests whether the committed world has any shape sweep match, stopping at the first match.\n *\n * @param world - World to query. See {@link PibblPhysicsWorldHandle2D}.\n * @param shape - Shape to sweep. See {@link PibblPhysicsShape2D}.\n * @param from - Initial shape pose. See {@link PibblPhysicsPose2D}.\n * @param translation - Translation vector for the sweep. See {@link PibblPhysicsVector2}.\n * @param options - Sensor policy and collider filtering. See {@link PibblPhysicsQueryOptions2D}.\n * @returns Whether a matching collider exists.\n */\nexport function shapeCastAny2D(\n  world: PibblPhysicsWorldHandle2D,\n  shape: PibblPhysicsShape2D,\n  from: PibblPhysicsPose2D,\n  translation: PibblPhysicsVector2,\n  options?: PibblPhysicsQueryOptions2D,\n): boolean {\n  return requirePhysicsWorld2DController(world).shapeCast(shape, from, translation, { ...options, mode: \"any\" });\n}\n\n/**\n * Returns the first shape sweep result ordered by time of impact, distance, then collider identity, or null.\n *\n * @param world - World to query. See {@link PibblPhysicsWorldHandle2D}.\n * @param shape - Shape to sweep. See {@link PibblPhysicsShape2D}.\n * @param from - Initial shape pose. See {@link PibblPhysicsPose2D}.\n * @param translation - Translation vector for the sweep. See {@link PibblPhysicsVector2}.\n * @param options - Sensor policy and collider filtering. See {@link PibblPhysicsQueryOptions2D}.\n * @returns One result or null. See {@link PibblPhysicsQueryHit2D}.\n */\nexport function shapeCastClosest2D(\n  world: PibblPhysicsWorldHandle2D,\n  shape: PibblPhysicsShape2D,\n  from: PibblPhysicsPose2D,\n  translation: PibblPhysicsVector2,\n  options?: PibblPhysicsQueryOptions2D,\n): PibblPhysicsQueryHit2D | null {\n  return requirePhysicsWorld2DController(world).shapeCast(shape, from, translation, { ...options, mode: \"closest\" });\n}\n\n/**\n * Returns all shape sweep results ordered by time of impact, distance, then collider identity as a frozen array.\n *\n * @param world - World to query. See {@link PibblPhysicsWorldHandle2D}.\n * @param shape - Shape to sweep. See {@link PibblPhysicsShape2D}.\n * @param from - Initial shape pose. See {@link PibblPhysicsPose2D}.\n * @param translation - Translation vector for the sweep. See {@link PibblPhysicsVector2}.\n * @param options - Sensor policy and collider filtering. See {@link PibblPhysicsQueryOptions2D}.\n * @returns Frozen results, empty when no collider matches. See {@link PibblPhysicsQueryHit2D}.\n */\nexport function shapeCastAll2D(\n  world: PibblPhysicsWorldHandle2D,\n  shape: PibblPhysicsShape2D,\n  from: PibblPhysicsPose2D,\n  translation: PibblPhysicsVector2,\n  options?: PibblPhysicsQueryOptions2D,\n): readonly PibblPhysicsQueryHit2D[] {\n  return requirePhysicsWorld2DController(world).shapeCast(shape, from, translation, { ...options, mode: \"all\" });\n}\n\n/**\n * Tests whether the committed world has any shape overlap match, stopping at the first match.\n *\n * @param world - World to query. See {@link PibblPhysicsWorldHandle2D}.\n * @param shape - Shape to test. See {@link PibblPhysicsShape2D}.\n * @param pose - Shape pose. See {@link PibblPhysicsPose2D}.\n * @param options - Sensor policy and collider filtering. See {@link PibblPhysicsQueryOptions2D}.\n * @returns Whether a matching collider exists.\n */\nexport function hasShapeOverlap2D(\n  world: PibblPhysicsWorldHandle2D,\n  shape: PibblPhysicsShape2D,\n  pose: PibblPhysicsPose2D,\n  options?: PibblPhysicsQueryOptions2D,\n): boolean {\n  return requirePhysicsWorld2DController(world).overlapShape(shape, pose, { ...options, mode: \"any\" });\n}\n\n/**\n * Returns the first shape overlap result ordered by collider index, then generation, or null.\n *\n * @param world - World to query. See {@link PibblPhysicsWorldHandle2D}.\n * @param shape - Shape to test. See {@link PibblPhysicsShape2D}.\n * @param pose - Shape pose. See {@link PibblPhysicsPose2D}.\n * @param options - Sensor policy and collider filtering. See {@link PibblPhysicsQueryOptions2D}.\n * @returns One result or null. See {@link PibblPhysicsQueryMatch2D}.\n */\nexport function findShapeOverlap2D(\n  world: PibblPhysicsWorldHandle2D,\n  shape: PibblPhysicsShape2D,\n  pose: PibblPhysicsPose2D,\n  options?: PibblPhysicsQueryOptions2D,\n): PibblPhysicsQueryMatch2D | null {\n  return requirePhysicsWorld2DController(world).overlapShape(shape, pose, { ...options, mode: \"closest\" });\n}\n\n/**\n * Returns all shape overlap results ordered by collider index, then generation as a frozen array.\n *\n * @param world - World to query. See {@link PibblPhysicsWorldHandle2D}.\n * @param shape - Shape to test. See {@link PibblPhysicsShape2D}.\n * @param pose - Shape pose. See {@link PibblPhysicsPose2D}.\n * @param options - Sensor policy and collider filtering. See {@link PibblPhysicsQueryOptions2D}.\n * @returns Frozen results, empty when no collider matches. See {@link PibblPhysicsQueryMatch2D}.\n */\nexport function findAllShapeOverlaps2D(\n  world: PibblPhysicsWorldHandle2D,\n  shape: PibblPhysicsShape2D,\n  pose: PibblPhysicsPose2D,\n  options?: PibblPhysicsQueryOptions2D,\n): readonly PibblPhysicsQueryMatch2D[] {\n  return requirePhysicsWorld2DController(world).overlapShape(shape, pose, { ...options, mode: \"all\" });\n}\n\n/**\n * Tests whether the committed world has any bounds intersection match, stopping at the first match.\n *\n * @param world - World to query. See {@link PibblPhysicsWorldHandle2D}.\n * @param bounds - Axis-aligned query bounds. See {@link PibblPhysicsAabb2D}.\n * @param options - Sensor policy and collider filtering. See {@link PibblPhysicsQueryOptions2D}.\n * @returns Whether a matching collider exists.\n */\nexport function hasAabbMatch2D(\n  world: PibblPhysicsWorldHandle2D,\n  bounds: PibblPhysicsAabb2D,\n  options?: PibblPhysicsQueryOptions2D,\n): boolean {\n  return requirePhysicsWorld2DController(world).queryAabb(bounds, { ...options, mode: \"any\" });\n}\n\n/**\n * Returns the first bounds intersection result ordered by collider index, then generation, or null.\n *\n * @param world - World to query. See {@link PibblPhysicsWorldHandle2D}.\n * @param bounds - Axis-aligned query bounds. See {@link PibblPhysicsAabb2D}.\n * @param options - Sensor policy and collider filtering. See {@link PibblPhysicsQueryOptions2D}.\n * @returns One result or null. See {@link PibblPhysicsQueryMatch2D}.\n */\nexport function findAabbMatch2D(\n  world: PibblPhysicsWorldHandle2D,\n  bounds: PibblPhysicsAabb2D,\n  options?: PibblPhysicsQueryOptions2D,\n): PibblPhysicsQueryMatch2D | null {\n  return requirePhysicsWorld2DController(world).queryAabb(bounds, { ...options, mode: \"closest\" });\n}\n\n/**\n * Returns all bounds intersection results ordered by collider index, then generation as a frozen array.\n *\n * @param world - World to query. See {@link PibblPhysicsWorldHandle2D}.\n * @param bounds - Axis-aligned query bounds. See {@link PibblPhysicsAabb2D}.\n * @param options - Sensor policy and collider filtering. See {@link PibblPhysicsQueryOptions2D}.\n * @returns Frozen results, empty when no collider matches. See {@link PibblPhysicsQueryMatch2D}.\n */\nexport function findAllAabbMatches2D(\n  world: PibblPhysicsWorldHandle2D,\n  bounds: PibblPhysicsAabb2D,\n  options?: PibblPhysicsQueryOptions2D,\n): readonly PibblPhysicsQueryMatch2D[] {\n  return requirePhysicsWorld2DController(world).queryAabb(bounds, { ...options, mode: \"all\" });\n}\n\n/**\n * Tests whether the committed world has any point containment match, stopping at the first match.\n *\n * @param world - World to query. See {@link PibblPhysicsWorldHandle2D}.\n * @param point - Point in simulation coordinates. See {@link PibblPhysicsVector2}.\n * @param options - Sensor policy and collider filtering. See {@link PibblPhysicsQueryOptions2D}.\n * @returns Whether a matching collider exists.\n */\nexport function hasPointMatch2D(\n  world: PibblPhysicsWorldHandle2D,\n  point: PibblPhysicsVector2,\n  options?: PibblPhysicsQueryOptions2D,\n): boolean {\n  return requirePhysicsWorld2DController(world).queryPoint(point, { ...options, mode: \"any\" });\n}\n\n/**\n * Returns the first point containment result ordered by collider index, then generation, or null.\n *\n * @param world - World to query. See {@link PibblPhysicsWorldHandle2D}.\n * @param point - Point in simulation coordinates. See {@link PibblPhysicsVector2}.\n * @param options - Sensor policy and collider filtering. See {@link PibblPhysicsQueryOptions2D}.\n * @returns One result or null. See {@link PibblPhysicsQueryMatch2D}.\n */\nexport function findPointMatch2D(\n  world: PibblPhysicsWorldHandle2D,\n  point: PibblPhysicsVector2,\n  options?: PibblPhysicsQueryOptions2D,\n): PibblPhysicsQueryMatch2D | null {\n  return requirePhysicsWorld2DController(world).queryPoint(point, { ...options, mode: \"closest\" });\n}\n\n/**\n * Returns all point containment results ordered by collider index, then generation as a frozen array.\n *\n * @param world - World to query. See {@link PibblPhysicsWorldHandle2D}.\n * @param point - Point in simulation coordinates. See {@link PibblPhysicsVector2}.\n * @param options - Sensor policy and collider filtering. See {@link PibblPhysicsQueryOptions2D}.\n * @returns Frozen results, empty when no collider matches. See {@link PibblPhysicsQueryMatch2D}.\n */\nexport function findAllPointMatches2D(\n  world: PibblPhysicsWorldHandle2D,\n  point: PibblPhysicsVector2,\n  options?: PibblPhysicsQueryOptions2D,\n): readonly PibblPhysicsQueryMatch2D[] {\n  return requirePhysicsWorld2DController(world).queryPoint(point, { ...options, mode: \"all\" });\n}\n\n/**\n * Converts root-logical pointer coordinates to this world's simulation space.\n *\n * @param world - World providing unit and coordinate conversion. See\n * {@link PibblPhysicsWorldHandle2D} .\n * @param point - Point in public Canvas coordinates. See {@link PibblPhysicsVector2}.\n * @returns The equivalent point in this world's local simulation space. See\n * {@link PibblPhysicsVector2} .\n *\n * @see {@link PibblPhysicsWorldHandle2D}\n * @see {@link PibblPhysicsVector2}\n */\nexport function toPhysicsPoint2D(\n  world: PibblPhysicsWorldHandle2D,\n  point: PibblPhysicsVector2,\n): PibblPhysicsVector2 {\n  return requirePhysicsWorld2DController(world).convertPoint(point, false);\n}\n\n/**\n * Converts a simulation-space point to root-logical Canvas coordinates.\n *\n * @param world - World providing unit and coordinate conversion. See\n * {@link PibblPhysicsWorldHandle2D} .\n * @param point - Point in this world's local simulation space. See {@link PibblPhysicsVector2}.\n * @returns The equivalent point in public Canvas coordinates. See {@link PibblPhysicsVector2}.\n *\n * @see {@link PibblPhysicsWorldHandle2D}\n * @see {@link PibblPhysicsVector2}\n */\nexport function fromPhysicsPoint2D(\n  world: PibblPhysicsWorldHandle2D,\n  point: PibblPhysicsVector2,\n): PibblPhysicsVector2 {\n  return requirePhysicsWorld2DController(world).convertPoint(point, true);\n}\n\nexport type {\n  PibblPhysicsInspection2D,\n  PibblPhysicsBodyInspection2D,\n  PibblPhysicsColliderInspection2D,\n  PibblPhysicsContactInspection2D,\n} from \"./lib/2d/inspection-types.js\";\n\n/**\n * Returns immutable JSON-safe observations without advancing the simulation. See\n * {@link PibblPhysicsWorldHandle2D}.\n * @param world - World to inspect. See {@link PibblPhysicsWorldHandle2D}.\n * @returns Current world simulation and ownership diagnostics.\n */\nexport function inspectPhysics2D(\n  world: PibblPhysicsWorldHandle2D,\n): import(\"./lib/2d/inspection-types.js\").PibblPhysicsInspection2D;\n\n/**\n * Returns the immutable observation for this currently bound body, if any. See\n * {@link PibblPhysicsBodyHandle2D}.\n * @param body - Body to inspect. See {@link PibblPhysicsBodyHandle2D}.\n * @returns Current body diagnostics, or undefined when the handle has no live body.\n */\nexport function inspectPhysics2D(\n  body: PibblPhysicsBodyHandle2D,\n): import(\"./lib/2d/inspection-types.js\").PibblPhysicsBodyInspection2D | undefined;\n/**\n * Returns a diagnostic snapshot of a live world or body, or undefined when unavailable.\n *\n * @param target - World or body handle to inspect. See {@link PibblPhysicsWorldHandle2D} ,\n * {@link PibblPhysicsBodyHandle2D} .\n * @returns The corresponding diagnostics, or undefined for an unmounted body.\n *\n * @see {@link PibblPhysicsWorldHandle2D}\n * @see {@link PibblPhysicsBodyHandle2D}\n * @see {@link PibblPhysicsInspection2D}\n * @see {@link PibblPhysicsBodyInspection2D}\n */\nexport function inspectPhysics2D(\n  target: PibblPhysicsWorldHandle2D | PibblPhysicsBodyHandle2D,\n):\n  | import(\"./lib/2d/inspection-types.js\").PibblPhysicsInspection2D\n  | import(\"./lib/2d/inspection-types.js\").PibblPhysicsBodyInspection2D\n  | undefined {\n  if (isPhysicsBodyHandle2D(target)) {\n    const binding = physicsBodyHandleBinding2D(target);\n    return binding?.controller.inspectBody(binding.bodyId);\n  }\n  return requirePhysicsWorld2DController(target).inspect();\n}\n\nexport {\n  PhysicsDebug2D,\n  type PibblPhysicsDebug2DProps,\n} from \"./lib/2d/canvas/debug.js\";\n\n/**\n * A borrowed committed solid batch, structurally compatible with a flow obstacle source.\n *\n * @param world - World supplying collider geometry. See {@link PibblPhysicsWorldHandle2D}.\n * @returns An obstacle source whose read method returns the current revision and packed geometry.\n *\n * @see {@link PibblPhysicsWorldHandle2D}\n */\nexport function physicsObstacles2D(world: PibblPhysicsWorldHandle2D): Readonly<{\n  read(): Readonly<{ revision: number; boxes: Float64Array; ellipses: Float64Array; polygons: Float64Array }>;\n}> {\n  return requirePhysicsWorld2DController(world).getObstacleSource();\n}\n"],
+  "mappings": "AAeA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP;AAAA,EACE;AAAA,EACA;AAAA,OACK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,0BAA0B;AACnC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,uCAAuC;AAEhD,cAAc;AACd;AAAA,EACE;AAAA,EACA;AAAA,OACK;AACP,cAAc;AAiCP,SAAS,aACd,OACA,KACA,SACS;AACT,SAAO,gCAAgC,KAAK,EAAE,QAAQ,KAAK,EAAE,GAAG,SAAS,MAAM,MAAM,CAAC;AACxF;AAUO,SAAS,iBACd,OACA,KACA,SAC+B;AAC/B,SAAO,gCAAgC,KAAK,EAAE,QAAQ,KAAK,EAAE,GAAG,SAAS,MAAM,UAAU,CAAC;AAC5F;AAUO,SAAS,aACd,OACA,KACA,SACmC;AACnC,SAAO,gCAAgC,KAAK,EAAE,QAAQ,KAAK,EAAE,GAAG,SAAS,MAAM,MAAM,CAAC;AACxF;AAYO,SAAS,eACd,OACA,OACA,MACA,aACA,SACS;AACT,SAAO,gCAAgC,KAAK,EAAE,UAAU,OAAO,MAAM,aAAa,EAAE,GAAG,SAAS,MAAM,MAAM,CAAC;AAC/G;AAYO,SAAS,mBACd,OACA,OACA,MACA,aACA,SAC+B;AAC/B,SAAO,gCAAgC,KAAK,EAAE,UAAU,OAAO,MAAM,aAAa,EAAE,GAAG,SAAS,MAAM,UAAU,CAAC;AACnH;AAYO,SAAS,eACd,OACA,OACA,MACA,aACA,SACmC;AACnC,SAAO,gCAAgC,KAAK,EAAE,UAAU,OAAO,MAAM,aAAa,EAAE,GAAG,SAAS,MAAM,MAAM,CAAC;AAC/G;AAWO,SAAS,kBACd,OACA,OACA,MACA,SACS;AACT,SAAO,gCAAgC,KAAK,EAAE,aAAa,OAAO,MAAM,EAAE,GAAG,SAAS,MAAM,MAAM,CAAC;AACrG;AAWO,SAAS,mBACd,OACA,OACA,MACA,SACiC;AACjC,SAAO,gCAAgC,KAAK,EAAE,aAAa,OAAO,MAAM,EAAE,GAAG,SAAS,MAAM,UAAU,CAAC;AACzG;AAWO,SAAS,uBACd,OACA,OACA,MACA,SACqC;AACrC,SAAO,gCAAgC,KAAK,EAAE,aAAa,OAAO,MAAM,EAAE,GAAG,SAAS,MAAM,MAAM,CAAC;AACrG;AAUO,SAAS,eACd,OACA,QACA,SACS;AACT,SAAO,gCAAgC,KAAK,EAAE,UAAU,QAAQ,EAAE,GAAG,SAAS,MAAM,MAAM,CAAC;AAC7F;AAUO,SAAS,gBACd,OACA,QACA,SACiC;AACjC,SAAO,gCAAgC,KAAK,EAAE,UAAU,QAAQ,EAAE,GAAG,SAAS,MAAM,UAAU,CAAC;AACjG;AAUO,SAAS,qBACd,OACA,QACA,SACqC;AACrC,SAAO,gCAAgC,KAAK,EAAE,UAAU,QAAQ,EAAE,GAAG,SAAS,MAAM,MAAM,CAAC;AAC7F;AAUO,SAAS,gBACd,OACA,OACA,SACS;AACT,SAAO,gCAAgC,KAAK,EAAE,WAAW,OAAO,EAAE,GAAG,SAAS,MAAM,MAAM,CAAC;AAC7F;AAUO,SAAS,iBACd,OACA,OACA,SACiC;AACjC,SAAO,gCAAgC,KAAK,EAAE,WAAW,OAAO,EAAE,GAAG,SAAS,MAAM,UAAU,CAAC;AACjG;AAUO,SAAS,sBACd,OACA,OACA,SACqC;AACrC,SAAO,gCAAgC,KAAK,EAAE,WAAW,OAAO,EAAE,GAAG,SAAS,MAAM,MAAM,CAAC;AAC7F;AAcO,SAAS,iBACd,OACA,OACqB;AACrB,SAAO,gCAAgC,KAAK,EAAE,aAAa,OAAO,KAAK;AACzE;AAaO,SAAS,mBACd,OACA,OACqB;AACrB,SAAO,gCAAgC,KAAK,EAAE,aAAa,OAAO,IAAI;AACxE;AAwCO,SAAS,iBACd,QAIY;AACZ,MAAI,sBAAsB,MAAM,GAAG;AACjC,UAAM,UAAU,2BAA2B,MAAM;AACjD,WAAO,SAAS,WAAW,YAAY,QAAQ,MAAM;AAAA,EACvD;AACA,SAAO,gCAAgC,MAAM,EAAE,QAAQ;AACzD;AAEA;AAAA,EACE;AAAA,OAEK;AAUA,SAAS,mBAAmB,OAEhC;AACD,SAAO,gCAAgC,KAAK,EAAE,kBAAkB;AAClE;",
   "names": []
 }

package/dist/features/physics/lib/2d/query-types.d.ts

@@ -0,0 +1,6 @@
+import type { PibblPhysicsQueryOptions2D } from './types.js';
+export type QueryMode = 'closest' | 'any' | 'all';
+export interface QueryOptions<Mode extends QueryMode = 'closest'> extends PibblPhysicsQueryOptions2D {
+    readonly mode?: Mode;
+}
+export type QueryResult<Mode extends QueryMode, Result> = Mode extends 'any' ? boolean : Mode extends 'all' ? readonly Result[] : Result | null;

package/dist/features/physics/lib/2d/runtime/controller.d.ts

@@ -1,7 +1,8 @@
+import type { QueryMode, QueryOptions, QueryResult } from '../query-types.js';
 import type { PibblPhysicsBodyInspection2D, PibblPhysicsInspection2D } from "../inspection-types.js";
 import { type PibblInternalSimulationOwner } from "@pibbl/core/internal";
 import type { PibblPhysicsAabb2D, PibblPhysicsPose2D, PibblPhysicsRay2D, PibblPhysicsShape2D, PibblPhysicsVector2 } from "../../../2d-geometry.js";
-import type { PibblPhysicsBodyHandle2D, PibblPhysicsQueryHit2D, PibblPhysicsQueryMatch2D, PibblPhysicsQueryMode, PibblPhysicsQueryOptions2D, PibblPhysicsQueryResult2D, PibblPhysicsWorldHandle2D } from "../types.js";
+import type { PibblPhysicsBodyHandle2D, PibblPhysicsQueryHit2D, PibblPhysicsQueryMatch2D, PibblPhysicsWorldHandle2D } from "../types.js";
 import type { PibblResolvedPhysicsWorld2DProps } from "./world-props.js";
 import { PhysicsWorld2DKernel, type PhysicsBodyCommand2D, type PhysicsCommand2D } from "../world/world.js";
 import { type PhysicsBodyHandleValues2D } from "./body-handle.js";
@@ -67,11 +68,11 @@ export declare class PhysicsWorld2DController {
     queueCommands(commands: readonly PhysicsCommand2D[]): void;
     acceptBodyHandleCommand(handle: PibblPhysicsBodyHandle2D, bindingGeneration: number, command: PhysicsBodyCommand2D): boolean;
     presentationPose(bodyId: number): PibblPhysicsPose2D | undefined;
-    raycast<Mode extends PibblPhysicsQueryMode = "closest">(ray: PibblPhysicsRay2D, options?: PibblPhysicsQueryOptions2D<Mode>): PibblPhysicsQueryResult2D<Mode, PibblPhysicsQueryHit2D>;
-    shapeCast<Mode extends PibblPhysicsQueryMode = "closest">(shape: PibblPhysicsShape2D, from: PibblPhysicsPose2D, translation: PibblPhysicsVector2, options?: PibblPhysicsQueryOptions2D<Mode>): PibblPhysicsQueryResult2D<Mode, PibblPhysicsQueryHit2D>;
-    overlapShape<Mode extends PibblPhysicsQueryMode = "closest">(shape: PibblPhysicsShape2D, pose: PibblPhysicsPose2D, options?: PibblPhysicsQueryOptions2D<Mode>): PibblPhysicsQueryResult2D<Mode, PibblPhysicsQueryMatch2D>;
-    queryAabb<Mode extends PibblPhysicsQueryMode = "closest">(bounds: PibblPhysicsAabb2D, options?: PibblPhysicsQueryOptions2D<Mode>): PibblPhysicsQueryResult2D<Mode, PibblPhysicsQueryMatch2D>;
-    queryPoint<Mode extends PibblPhysicsQueryMode = "closest">(point: PibblPhysicsVector2, options?: PibblPhysicsQueryOptions2D<Mode>): PibblPhysicsQueryResult2D<Mode, PibblPhysicsQueryMatch2D>;
+    raycast<Mode extends QueryMode = "closest">(ray: PibblPhysicsRay2D, options?: QueryOptions<Mode>): QueryResult<Mode, PibblPhysicsQueryHit2D>;
+    shapeCast<Mode extends QueryMode = "closest">(shape: PibblPhysicsShape2D, from: PibblPhysicsPose2D, translation: PibblPhysicsVector2, options?: QueryOptions<Mode>): QueryResult<Mode, PibblPhysicsQueryHit2D>;
+    overlapShape<Mode extends QueryMode = "closest">(shape: PibblPhysicsShape2D, pose: PibblPhysicsPose2D, options?: QueryOptions<Mode>): QueryResult<Mode, PibblPhysicsQueryMatch2D>;
+    queryAabb<Mode extends QueryMode = "closest">(bounds: PibblPhysicsAabb2D, options?: QueryOptions<Mode>): QueryResult<Mode, PibblPhysicsQueryMatch2D>;
+    queryPoint<Mode extends QueryMode = "closest">(point: PibblPhysicsVector2, options?: QueryOptions<Mode>): QueryResult<Mode, PibblPhysicsQueryMatch2D>;
     bodyHandleValues(bodyId: number): PhysicsBodyHandleValues2D | undefined;
     inspectBody(bodyId: number): PibblPhysicsBodyInspection2D | undefined;
     dispose(): void;