@pibbl/core 0.0.1 → 0.0.3-alpha.109.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-testing.d.ts

@@ -5,7 +5,7 @@
  * host frames; a physics world may run zero, one, or several fixed ticks in a
  * host frame according to its public fixed-step configuration.
  */
-import { type PibblNode } from "@pibbl/core";
+import type { PibblNode } from "@pibbl/core";
 /**
  * Caller-owned canvas, root factory, and observation callback for deterministic physics testing.
  *

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

@@ -1,4 +1,4 @@
-import { pibbl } from "@pibbl/core";
+import { pibblSync } from "../../sync.js";
 import {
   PibblInternalManualSchedulerDriver,
   pibblInternalInstallTestSchedulerDriver,
@@ -119,7 +119,7 @@ function createPhysicsTestHarness2D(options) {
   }
 }
 function mountRoot(options) {
-  return pibbl(options.canvas, options.root());
+  return pibblSync(options.canvas, options.root());
 }
 function requireFrameCount(count) {
   if (!Number.isSafeInteger(count) || count < 0) {

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/features/physics/2d-testing.ts"],
-  "sourcesContent": ["/**\n * Deterministic test support for public 2D physics compositions.\n *\n * The harness drives Pibbl's existing realm scheduler. `advanceFrames()` advances\n * host frames; a physics world may run zero, one, or several fixed ticks in a\n * host frame according to its public fixed-step configuration.\n */\nimport { pibbl, type PibblController, type PibblNode } from \"@pibbl/core\";\nimport {\n  PibblInternalManualSchedulerDriver,\n  pibblInternalInstallTestSchedulerDriver,\n  pibblInternalSnapshotRealmScheduler,\n} from \"@pibbl/core/internal\";\n\n/**\n * Caller-owned canvas, root factory, and observation callback for deterministic physics testing.\n *\n * @see {@link PibblNode}\n * @see {@link createPhysicsTestHarness2D}\n */\nexport interface PibblPhysicsTestHarness2DOptions<Observation> {\n  /** The caller owns this canvas; disposing the harness never removes it. */\n  readonly canvas: HTMLCanvasElement;\n  /**\n   * Creates a new public Pibbl root for the initial mount and each reset.\n   * @returns The Pibbl root tree mounted by the test harness. See {@link PibblNode}.\n   */\n  readonly root: () => PibblNode;\n  /**\n   * Reads application state after a frame or action.\n   * @returns The semantic state to expose through the harness's observe method.\n   */\n  readonly observe: () => Observation;\n}\n\n/**\n * A disposable test mount with explicit host-frame advancement and public-state observations.\n *\n * @see {@link createPhysicsTestHarness2D}\n */\nexport interface PibblPhysicsTestHarness2D<Observation> {\n  /** Number of host callbacks currently requested by Pibbl (zero or one). */\n  readonly pendingFrames: number;\n  /**\n   * Delivers one already-requested host frame at the current host time.\n   * @returns Whether a pending frame was flushed.\n   */\n  flush(): boolean;\n  /**\n   * Advances up to `count` requested host frames by `milliseconds` each.\n   * This advances the host clock, not a guaranteed count of physics fixed ticks.\n   * @param count - Number of frames to advance.\n   * @param milliseconds - Duration of each frame in milliseconds.\n   * @returns The number of frames advanced.\n   */\n  advanceFrames(count: number, milliseconds?: number): number;\n  /**\n   * Runs an application action and delivers one resulting frame at the current time.\n   * @param callback - Action to run within the harness's deterministic scheduling context.\n   * @returns The action's return value.\n   */\n  act<Result>(callback: () => Result): Result;\n  /**\n   * Reads the caller-provided public observation without scheduling work.\n   * @returns The current observation from the configured observer.\n   */\n  observe(): Observation;\n  /** Disposes the mounted root and mounts a new one without moving host time backward. */\n  reset(): void;\n  /** Disposes the root and restores the previous realm scheduler driver. */\n  dispose(): void;\n}\n\nconst DEFAULT_FRAME_MILLISECONDS = 1000 / 60;\n\n/**\n * Creates an isolated manual-clock test mount for one Pibbl 2D physics composition.\n *\n * It refuses a realm with an existing root because a Pibbl realm deliberately has\n * one scheduler. Use ordinary browser tests when a test needs multiple roots.\n *\n * @param options - Caller-owned canvas, root factory, and semantic state observer. See\n * {@link PibblPhysicsTestHarness2DOptions} .\n * @returns A harness owning the test mount and scheduler lifetime; dispose it after use. See\n * {@link PibblPhysicsTestHarness2D} .\n *\n * @see {@link PibblPhysicsTestHarness2DOptions}\n * @see {@link PibblPhysicsTestHarness2D}\n */\nexport function createPhysicsTestHarness2D<Observation>(\n  options: PibblPhysicsTestHarness2DOptions<Observation>,\n): PibblPhysicsTestHarness2D<Observation> {\n  const before = pibblInternalSnapshotRealmScheduler();\n  if (before.registeredRoots !== 0) {\n    throw new Error(\n      \"createPhysicsTestHarness2D() requires an isolated Pibbl realm; dispose existing Pibbl roots before creating the harness.\",\n    );\n  }\n  if (before.phase !== \"idle\" || before.pendingHostFrames !== 0) {\n    throw new Error(\n      \"createPhysicsTestHarness2D() cannot replace the Pibbl clock while realm work is active.\",\n    );\n  }\n\n  const driver = new PibblInternalManualSchedulerDriver();\n  let restoreDriver: (() => void) | undefined;\n  let controller: PibblController | undefined;\n  let disposed = false;\n  let hostTime = 0;\n\n  try {\n    restoreDriver = pibblInternalInstallTestSchedulerDriver(driver);\n    controller = mountRoot(options);\n  } catch (error) {\n    try {\n      controller?.dispose();\n    } finally {\n      controller = undefined;\n      restoreSchedulerDriver();\n    }\n    throw error;\n  }\n\n  const requireLive = (): void => {\n    if (disposed) {\n      throw new Error(\"This Pibbl physics 2D test harness has been disposed.\");\n    }\n  };\n  const flush = (): boolean => {\n    requireLive();\n    if (driver.pendingHostFrames === 0) return false;\n    driver.flush(hostTime);\n    return true;\n  };\n\n  return Object.freeze({\n    get pendingFrames(): number {\n      return driver.pendingHostFrames;\n    },\n    flush,\n    advanceFrames(\n      count: number,\n      milliseconds = DEFAULT_FRAME_MILLISECONDS,\n    ): number {\n      requireLive();\n      requireFrameCount(count);\n      requireMilliseconds(milliseconds);\n      let advanced = 0;\n      for (let index = 0; index < count; index++) {\n        if (driver.pendingHostFrames === 0) break;\n        const nextHostTime = hostTime + milliseconds;\n        if (!Number.isFinite(nextHostTime)) {\n          throw new RangeError(\n            \"advanceFrames() cannot advance the host clock beyond a finite time.\",\n          );\n        }\n        hostTime = nextHostTime;\n        driver.flush(hostTime);\n        advanced++;\n      }\n      return advanced;\n    },\n    act<Result>(callback: () => Result): Result {\n      requireLive();\n      const result = callback();\n      flush();\n      return result;\n    },\n    observe(): Observation {\n      requireLive();\n      return options.observe();\n    },\n    reset(): void {\n      requireLive();\n      const previousController = controller;\n      controller = undefined;\n      try {\n        previousController?.dispose();\n        controller = mountRoot(options);\n      } catch (error) {\n        disposed = true;\n        try {\n          restoreSchedulerDriver();\n        } catch (restoreError) {\n          throw new AggregateError(\n            [error, restoreError],\n            \"Pibbl physics 2D test harness reset failed and could not restore the scheduler driver.\",\n            { cause: restoreError },\n          );\n        }\n        throw error;\n      }\n    },\n    dispose(): void {\n      if (disposed) return;\n      disposed = true;\n      const currentController = controller;\n      controller = undefined;\n      try {\n        currentController?.dispose();\n      } finally {\n        restoreSchedulerDriver();\n      }\n    },\n  });\n\n  function restoreSchedulerDriver(): void {\n    const restore = restoreDriver;\n    restoreDriver = undefined;\n    restore?.();\n  }\n}\n\nfunction mountRoot<Observation>(\n  options: PibblPhysicsTestHarness2DOptions<Observation>,\n): PibblController {\n  return pibbl(options.canvas, options.root());\n}\n\nfunction requireFrameCount(count: number): void {\n  if (!Number.isSafeInteger(count) || count < 0) {\n    throw new RangeError(\n      \"advanceFrames(count) requires a non-negative safe integer.\",\n    );\n  }\n}\n\nfunction requireMilliseconds(milliseconds: number): void {\n  if (!Number.isFinite(milliseconds) || milliseconds < 0) {\n    throw new RangeError(\n      \"advanceFrames(milliseconds) requires a finite non-negative number.\",\n    );\n  }\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["/**\n * Deterministic test support for public 2D physics compositions.\n *\n * The harness drives Pibbl's existing realm scheduler. `advanceFrames()` advances\n * host frames; a physics world may run zero, one, or several fixed ticks in a\n * host frame according to its public fixed-step configuration.\n */\nimport type { PibblController, PibblNode } from \"@pibbl/core\";\nimport { pibblSync } from \"../../sync.js\";\nimport {\n  PibblInternalManualSchedulerDriver,\n  pibblInternalInstallTestSchedulerDriver,\n  pibblInternalSnapshotRealmScheduler,\n} from \"@pibbl/core/internal\";\n\n/**\n * Caller-owned canvas, root factory, and observation callback for deterministic physics testing.\n *\n * @see {@link PibblNode}\n * @see {@link createPhysicsTestHarness2D}\n */\nexport interface PibblPhysicsTestHarness2DOptions<Observation> {\n  /** The caller owns this canvas; disposing the harness never removes it. */\n  readonly canvas: HTMLCanvasElement;\n  /**\n   * Creates a new public Pibbl root for the initial mount and each reset.\n   * @returns The Pibbl root tree mounted by the test harness. See {@link PibblNode}.\n   */\n  readonly root: () => PibblNode;\n  /**\n   * Reads application state after a frame or action.\n   * @returns The semantic state to expose through the harness's observe method.\n   */\n  readonly observe: () => Observation;\n}\n\n/**\n * A disposable test mount with explicit host-frame advancement and public-state observations.\n *\n * @see {@link createPhysicsTestHarness2D}\n */\nexport interface PibblPhysicsTestHarness2D<Observation> {\n  /** Number of host callbacks currently requested by Pibbl (zero or one). */\n  readonly pendingFrames: number;\n  /**\n   * Delivers one already-requested host frame at the current host time.\n   * @returns Whether a pending frame was flushed.\n   */\n  flush(): boolean;\n  /**\n   * Advances up to `count` requested host frames by `milliseconds` each.\n   * This advances the host clock, not a guaranteed count of physics fixed ticks.\n   * @param count - Number of frames to advance.\n   * @param milliseconds - Duration of each frame in milliseconds.\n   * @returns The number of frames advanced.\n   */\n  advanceFrames(count: number, milliseconds?: number): number;\n  /**\n   * Runs an application action and delivers one resulting frame at the current time.\n   * @param callback - Action to run within the harness's deterministic scheduling context.\n   * @returns The action's return value.\n   */\n  act<Result>(callback: () => Result): Result;\n  /**\n   * Reads the caller-provided public observation without scheduling work.\n   * @returns The current observation from the configured observer.\n   */\n  observe(): Observation;\n  /** Disposes the mounted root and mounts a new one without moving host time backward. */\n  reset(): void;\n  /** Disposes the root and restores the previous realm scheduler driver. */\n  dispose(): void;\n}\n\nconst DEFAULT_FRAME_MILLISECONDS = 1000 / 60;\n\n/**\n * Creates an isolated manual-clock test mount for one Pibbl 2D physics composition.\n *\n * It refuses a realm with an existing root because a Pibbl realm deliberately has\n * one scheduler. Use ordinary browser tests when a test needs multiple roots.\n *\n * @param options - Caller-owned canvas, root factory, and semantic state observer. See\n * {@link PibblPhysicsTestHarness2DOptions} .\n * @returns A harness owning the test mount and scheduler lifetime; dispose it after use. See\n * {@link PibblPhysicsTestHarness2D} .\n *\n * @see {@link PibblPhysicsTestHarness2DOptions}\n * @see {@link PibblPhysicsTestHarness2D}\n */\nexport function createPhysicsTestHarness2D<Observation>(\n  options: PibblPhysicsTestHarness2DOptions<Observation>,\n): PibblPhysicsTestHarness2D<Observation> {\n  const before = pibblInternalSnapshotRealmScheduler();\n  if (before.registeredRoots !== 0) {\n    throw new Error(\n      \"createPhysicsTestHarness2D() requires an isolated Pibbl realm; dispose existing Pibbl roots before creating the harness.\",\n    );\n  }\n  if (before.phase !== \"idle\" || before.pendingHostFrames !== 0) {\n    throw new Error(\n      \"createPhysicsTestHarness2D() cannot replace the Pibbl clock while realm work is active.\",\n    );\n  }\n\n  const driver = new PibblInternalManualSchedulerDriver();\n  let restoreDriver: (() => void) | undefined;\n  let controller: PibblController | undefined;\n  let disposed = false;\n  let hostTime = 0;\n\n  try {\n    restoreDriver = pibblInternalInstallTestSchedulerDriver(driver);\n    controller = mountRoot(options);\n  } catch (error) {\n    try {\n      controller?.dispose();\n    } finally {\n      controller = undefined;\n      restoreSchedulerDriver();\n    }\n    throw error;\n  }\n\n  const requireLive = (): void => {\n    if (disposed) {\n      throw new Error(\"This Pibbl physics 2D test harness has been disposed.\");\n    }\n  };\n  const flush = (): boolean => {\n    requireLive();\n    if (driver.pendingHostFrames === 0) return false;\n    driver.flush(hostTime);\n    return true;\n  };\n\n  return Object.freeze({\n    get pendingFrames(): number {\n      return driver.pendingHostFrames;\n    },\n    flush,\n    advanceFrames(\n      count: number,\n      milliseconds = DEFAULT_FRAME_MILLISECONDS,\n    ): number {\n      requireLive();\n      requireFrameCount(count);\n      requireMilliseconds(milliseconds);\n      let advanced = 0;\n      for (let index = 0; index < count; index++) {\n        if (driver.pendingHostFrames === 0) break;\n        const nextHostTime = hostTime + milliseconds;\n        if (!Number.isFinite(nextHostTime)) {\n          throw new RangeError(\n            \"advanceFrames() cannot advance the host clock beyond a finite time.\",\n          );\n        }\n        hostTime = nextHostTime;\n        driver.flush(hostTime);\n        advanced++;\n      }\n      return advanced;\n    },\n    act<Result>(callback: () => Result): Result {\n      requireLive();\n      const result = callback();\n      flush();\n      return result;\n    },\n    observe(): Observation {\n      requireLive();\n      return options.observe();\n    },\n    reset(): void {\n      requireLive();\n      const previousController = controller;\n      controller = undefined;\n      try {\n        previousController?.dispose();\n        controller = mountRoot(options);\n      } catch (error) {\n        disposed = true;\n        try {\n          restoreSchedulerDriver();\n        } catch (restoreError) {\n          throw new AggregateError(\n            [error, restoreError],\n            \"Pibbl physics 2D test harness reset failed and could not restore the scheduler driver.\",\n            { cause: restoreError },\n          );\n        }\n        throw error;\n      }\n    },\n    dispose(): void {\n      if (disposed) return;\n      disposed = true;\n      const currentController = controller;\n      controller = undefined;\n      try {\n        currentController?.dispose();\n      } finally {\n        restoreSchedulerDriver();\n      }\n    },\n  });\n\n  function restoreSchedulerDriver(): void {\n    const restore = restoreDriver;\n    restoreDriver = undefined;\n    restore?.();\n  }\n}\n\nfunction mountRoot<Observation>(\n  options: PibblPhysicsTestHarness2DOptions<Observation>,\n): PibblController {\n  return pibblSync(options.canvas, options.root());\n}\n\nfunction requireFrameCount(count: number): void {\n  if (!Number.isSafeInteger(count) || count < 0) {\n    throw new RangeError(\n      \"advanceFrames(count) requires a non-negative safe integer.\",\n    );\n  }\n}\n\nfunction requireMilliseconds(milliseconds: number): void {\n  if (!Number.isFinite(milliseconds) || milliseconds < 0) {\n    throw new RangeError(\n      \"advanceFrames(milliseconds) requires a finite non-negative number.\",\n    );\n  }\n}\n"],
+  "mappings": "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",
   "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": "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",
   "names": []
 }