@pibbl/core 0.0.1

package/dist/features/physics/lib/2d/runtime/descriptors.js

@@ -0,0 +1,526 @@
+import { Group, isSignal } from "@pibbl/core";
+import {
+  pibblInternalCreatePropAttachment
+} from "@pibbl/core/internal";
+import { transformShape2D } from "../../../2d-geometry.js";
+import { requireShapeRecord2D } from "../shape-records.js";
+import {
+  copyFiniteVector2,
+  requireFiniteNumber,
+  requireNonnegativeNumber,
+  requirePositiveNumber,
+  requireSafeIntegerInRange
+} from "../../shared/validation.js";
+import {
+  pushPhysicsBody2D,
+  requireCurrentPhysicsBody2D,
+  requireCurrentPhysicsWorld2D
+} from "./context.js";
+import {
+  bakeCanvasShapeTransform2D,
+  inferCanvasColliderShape2D
+} from "../canvas/inference.js";
+import {
+  bodyLocalTransformFromPrimitive2D,
+  captureBodyPresentation2D,
+  matrixFromPose,
+  resolveDynamicPresentationTransform2D
+} from "../canvas/presentation.js";
+const bodyFramesByWorld2D = /* @__PURE__ */ new WeakMap();
+const attachmentRecord2DSymbol = /* @__PURE__ */ Symbol("PibblPhysicsAttachment2D");
+const RELATIVE_MATRIX_ROUNDOFF_OPERATIONS = 32;
+function dynamicBody2D(options = {}) {
+  const mass = options.mass ?? "auto";
+  if (mass !== "auto") requirePositiveNumber(mass, "options.mass");
+  const reenableVelocity = options.reenableVelocity ?? "zero";
+  if (reenableVelocity !== "zero" && reenableVelocity !== "preserve") {
+    throw new TypeError(
+      'options.reenableVelocity must be "zero" or "preserve".'
+    );
+  }
+  return createAttachment({
+    kind: "body",
+    bodyType: "dynamic",
+    options: Object.freeze({
+      enabled: options.enabled ?? true,
+      handle: options.handle,
+      linearVelocity: copyFiniteVector2(
+        options.linearVelocity ?? [0, 0],
+        "options.linearVelocity"
+      ),
+      angularVelocityDegreesPerSecond: requireFiniteNumber(
+        options.angularVelocityDegreesPerSecond ?? 0,
+        "options.angularVelocityDegreesPerSecond"
+      ),
+      linearDamping: requireNonnegativeNumber(
+        options.linearDamping ?? 0,
+        "options.linearDamping"
+      ),
+      angularDamping: requireNonnegativeNumber(
+        options.angularDamping ?? 0,
+        "options.angularDamping"
+      ),
+      gravityScale: requireFiniteNumber(
+        options.gravityScale ?? 1,
+        "options.gravityScale"
+      ),
+      mass,
+      fixedRotation: options.fixedRotation ?? false,
+      allowSleep: options.allowSleep ?? true,
+      ccd: options.ccd ?? false,
+      reenableVelocity,
+      collider: normalizeOptionalCollider(options.collider, "options.collider")
+    })
+  });
+}
+function staticBody2D(options = {}) {
+  return createAttachment({
+    kind: "body",
+    bodyType: "static",
+    options: Object.freeze({
+      enabled: options.enabled ?? true,
+      handle: options.handle,
+      collider: normalizeOptionalCollider(options.collider, "options.collider")
+    })
+  });
+}
+function kinematicBody2D(options = {}) {
+  const target = options.target ?? {};
+  if (target.position !== void 0 && !isSignal(target.position)) {
+    throw new TypeError("options.target.position must be a Pibbl signal.");
+  }
+  if (target.rotationDegrees !== void 0 && !isSignal(target.rotationDegrees)) {
+    throw new TypeError("options.target.rotationDegrees must be a Pibbl signal.");
+  }
+  return createAttachment({
+    kind: "body",
+    bodyType: "kinematic",
+    options: Object.freeze({
+      enabled: options.enabled ?? true,
+      handle: options.handle,
+      target: Object.freeze({
+        position: target.position,
+        rotationDegrees: target.rotationDegrees
+      }),
+      allowSleep: options.allowSleep ?? true,
+      collider: normalizeOptionalCollider(options.collider, "options.collider")
+    })
+  });
+}
+function collider2D(options = {}) {
+  return createAttachment({
+    kind: "collider",
+    options: normalizeCollider(options, "options")
+  });
+}
+function requirePhysicsAttachment2DDescriptor(value) {
+  const descriptor = typeof value === "object" && value !== null ? value[attachmentRecord2DSymbol] : void 0;
+  if (descriptor === void 0) {
+    throw new TypeError("Expected a registered Pibbl physics 2D attachment.");
+  }
+  return descriptor;
+}
+function createAttachment(descriptor) {
+  const frozenDescriptor = Object.freeze(descriptor);
+  const value = Object.freeze({
+    [attachmentRecord2DSymbol]: frozenDescriptor
+  });
+  return pibblInternalCreatePropAttachment(
+    "physics",
+    value,
+    () => new MountedPhysicsAttachment2D(value)
+  );
+}
+class MountedPhysicsAttachment2D {
+  descriptor;
+  world;
+  bodyId;
+  releaseBodyScope;
+  cachedShapeInput;
+  cachedShape;
+  cachedSelfShapeKey;
+  cachedSelfShape;
+  cachedBakedSource;
+  cachedBakedTransform;
+  cachedBakedShape;
+  bodyPresentation;
+  // `exit` runs after every traversal, while `dispose` runs only when this
+  // mounted attachment is actually removed. Keep the last ownership key so a
+  // removed keyed body releases its presentation lineage from the long-lived
+  // world's frame map.
+  bodyFrameWorld;
+  bodyFrameId;
+  wasEnabled = false;
+  constructor(value) {
+    this.descriptor = requirePhysicsAttachment2DDescriptor(value);
+  }
+  update(value) {
+    const next = requirePhysicsAttachment2DDescriptor(
+      value
+    );
+    if (this.descriptor.kind === "body" && next.kind !== "body") {
+      this.releaseBodyFrame();
+    }
+    this.descriptor = next;
+  }
+  enter() {
+    const world = requireCurrentPhysicsWorld2D();
+    this.world = world;
+    if (this.descriptor.kind === "body") {
+      const bodyId = world.bodyIdFor(this);
+      if (this.bodyFrameWorld !== void 0 && (this.bodyFrameWorld !== world || this.bodyFrameId !== bodyId)) {
+        this.releaseBodyFrame();
+      }
+      this.bodyId = bodyId;
+      this.releaseBodyScope = pushPhysicsBody2D({ world, bodyId });
+    } else {
+      this.bodyId = requireCurrentPhysicsBody2D().bodyId;
+    }
+  }
+  preparePrimitive(input) {
+    const world = this.world;
+    const bodyId = this.bodyId;
+    if (world === void 0 || bodyId === void 0) {
+      throw new Error(
+        "Physics 2D attachment preparation requires its entered scope."
+      );
+    }
+    if (this.descriptor.kind === "body") {
+      const descriptor = this.descriptor;
+      const simulationParent = world.simulationTransform(
+        input.parentWorldTransform
+      );
+      const enabled = descriptor.options.enabled;
+      const reenabled = !this.wasEnabled && enabled;
+      const local = bodyLocalTransformFromPrimitive2D(
+        input.componentType,
+        input.style
+      );
+      if (this.bodyPresentation === void 0 || reenabled || descriptor.bodyType !== "dynamic") {
+        this.bodyPresentation = captureBodyPresentation2D(
+          simulationParent,
+          local,
+          input.componentName,
+          descriptor.bodyType === "dynamic" && enabled
+        );
+      }
+      const presentation = this.bodyPresentation;
+      let bodyFrames = bodyFramesByWorld2D.get(world);
+      if (!bodyFrames) {
+        bodyFrames = /* @__PURE__ */ new Map();
+        bodyFramesByWorld2D.set(world, bodyFrames);
+      }
+      let presentationTransform2D;
+      let effectiveBodyFrame;
+      if (!enabled || descriptor.bodyType !== "dynamic") {
+        effectiveBodyFrame = world.rootTransform(
+          matrixFromPose(presentation.initialPose)
+        );
+      } else {
+        world.handle.revision.get();
+        const presentedPose = reenabled ? presentation.initialPose : world.presentationPose(bodyId) ?? presentation.initialPose;
+        presentationTransform2D = resolveDynamicPresentationTransform2D(
+          presentation,
+          presentedPose,
+          simulationParent,
+          local,
+          input.componentName
+        );
+        effectiveBodyFrame = input.parentWorldTransform.multiply(
+          presentationTransform2D.multiply(local)
+        );
+      }
+      bodyFrames.set(
+        bodyId,
+        Object.freeze({
+          poseMatrix: effectiveBodyFrame,
+          preBodyLineage: input.presentationTransformLineage,
+          untrackedCanvasTransformCount: (input.presentationTransformLineage?.untrackedCanvasTransformCount ?? 0) + (input.hasUntrackedCanvasTransform ? 1 : 0)
+        })
+      );
+      this.bodyFrameWorld = world;
+      this.bodyFrameId = bodyId;
+      const collider = descriptor.options.collider;
+      const effectiveCollider = collider === false ? false : collider.shape === "self" && input.componentType === Group ? false : withColliderShape(
+        collider,
+        this.bakeShape(
+          collider.shape === "self" ? this.resolveSelfShape(input) : collider.shape,
+          descriptor.bodyType === "dynamic" ? matrixFromPose(presentation.initialPose).inverse().multiply(simulationParent).multiply(local) : relativeColliderTransform2D(
+            effectiveBodyFrame,
+            input.parentWorldTransform
+          ).multiply(local)
+        )
+      );
+      const effectiveDescriptor = effectiveCollider === collider ? descriptor : Object.freeze({
+        ...descriptor,
+        options: Object.freeze({
+          ...descriptor.options,
+          collider: effectiveCollider
+        })
+      });
+      world.collectBody(
+        this,
+        bodyId,
+        effectiveDescriptor,
+        presentation.initialPose
+      );
+      this.wasEnabled = enabled;
+      return presentationTransform2D === void 0 ? void 0 : { presentationTransform2D };
+    } else {
+      const bodyFrame = requireBodyFrame(world, bodyId);
+      const lineageTransform = relativeColliderTransformFromLineage2D(
+        bodyFrame,
+        input
+      );
+      const options = withColliderShape(
+        this.descriptor.options,
+        this.bakeShape(
+          this.descriptor.options.shape === "self" ? this.resolveSelfShape(input) : this.descriptor.options.shape,
+          (lineageTransform ?? relativeColliderTransform2D(
+            bodyFrame.poseMatrix,
+            input.parentWorldTransform
+          )).multiply(
+            bodyLocalTransformFromPrimitive2D(input.componentType, input.style)
+          ),
+          lineageTransform === void 0
+        )
+      );
+      world.collectCollider(this, bodyId, options);
+    }
+  }
+  exit(_success) {
+    try {
+      this.releaseBodyScope?.();
+    } finally {
+      this.releaseBodyScope = void 0;
+      this.bodyId = void 0;
+      this.world = void 0;
+    }
+  }
+  dispose() {
+    try {
+      this.exit(false);
+    } finally {
+      this.releaseBodyFrame();
+    }
+  }
+  releaseBodyFrame() {
+    const world = this.bodyFrameWorld;
+    const bodyId = this.bodyFrameId;
+    if (world !== void 0 && bodyId !== void 0) {
+      const frames = bodyFramesByWorld2D.get(world);
+      frames?.delete(bodyId);
+      if (frames?.size === 0) bodyFramesByWorld2D.delete(world);
+    }
+    this.bodyFrameWorld = void 0;
+    this.bodyFrameId = void 0;
+  }
+  resolveShape(options) {
+    if (this.cachedShapeInput && sameColliderShapeInput(this.cachedShapeInput, options)) {
+      return this.cachedShape;
+    }
+    if (options.shape === "self") {
+      throw new Error(
+        "Self collider inference is not available in this runtime task."
+      );
+    }
+    const transformed = options.offset[0] === 0 && options.offset[1] === 0 && options.rotationDegrees === 0 ? options.shape : transformShape2D(options.shape, {
+      position: options.offset,
+      rotationDegrees: options.rotationDegrees
+    });
+    this.cachedShapeInput = options;
+    this.cachedShape = requireShapeRecord2D(transformed);
+    return this.cachedShape;
+  }
+  resolveSelfShape(input) {
+    const key = `${input.componentName}:${stableGeometryKey(input.style)}`;
+    if (key === this.cachedSelfShapeKey) return this.cachedSelfShape;
+    const shape = inferCanvasColliderShape2D(input);
+    this.cachedSelfShapeKey = key;
+    this.cachedSelfShape = shape;
+    return shape;
+  }
+  bakeShape(shape, transform, stabilizeFallback = true) {
+    const candidate = [
+      transform.a,
+      transform.b,
+      transform.c,
+      transform.d,
+      transform.e,
+      transform.f
+    ];
+    const values = stabilizeFallback && this.cachedBakedSource === shape && this.cachedBakedTransform !== void 0 && sameRelativeTransformWithinCanvasRoundoff(
+      this.cachedBakedTransform,
+      candidate
+    ) ? this.cachedBakedTransform : candidate;
+    if (this.cachedBakedSource === shape && this.cachedBakedTransform?.every(
+      (value, index) => value === values[index]
+    )) {
+      return this.cachedBakedShape;
+    }
+    const baked = bakeCanvasShapeTransform2D(shape, new DOMMatrix([...values]));
+    this.cachedBakedSource = shape;
+    this.cachedBakedTransform = Object.freeze(values);
+    this.cachedBakedShape = baked;
+    return baked;
+  }
+}
+function snapshotPhysicsBodyFrameCountForTest(world) {
+  return bodyFramesByWorld2D.get(world)?.size ?? 0;
+}
+function sameRelativeTransformWithinCanvasRoundoff(previous, candidate) {
+  return previous.every((value, index) => {
+    const next = candidate[index];
+    const tolerance = index < 4 ? linearTransformRoundoffTolerance(value, next) : translationRoundoffTolerance(value, next);
+    return Math.abs(value - next) <= tolerance;
+  });
+}
+function linearTransformRoundoffTolerance(previous, candidate) {
+  const magnitude = Math.max(1, Math.abs(previous), Math.abs(candidate));
+  return RELATIVE_MATRIX_ROUNDOFF_OPERATIONS * Number.EPSILON * magnitude * magnitude;
+}
+function translationRoundoffTolerance(previous, candidate) {
+  return RELATIVE_MATRIX_ROUNDOFF_OPERATIONS * Number.EPSILON * (1 + Math.max(Math.abs(previous), Math.abs(candidate)));
+}
+function relativeColliderTransform2D(bodyFrame, colliderParentFrame) {
+  return sameMatrixExactly2D(bodyFrame, colliderParentFrame) ? new DOMMatrix() : bodyFrame.inverse().multiply(colliderParentFrame);
+}
+function relativeColliderTransformFromLineage2D(bodyFrame, input) {
+  const inputUntrackedCanvasTransformCount = (input.presentationTransformLineage?.untrackedCanvasTransformCount ?? 0) + (input.hasUntrackedCanvasTransform ? 1 : 0);
+  if (inputUntrackedCanvasTransformCount !== bodyFrame.untrackedCanvasTransformCount) {
+    return void 0;
+  }
+  const nodes = [];
+  let cursor = input.presentationTransformLineage;
+  while (cursor !== bodyFrame.preBodyLineage) {
+    if (cursor === void 0) return void 0;
+    nodes.push(cursor.localTransform);
+    cursor = cursor.parent;
+  }
+  nodes.reverse();
+  if (nodes.length === 0) return new DOMMatrix();
+  let relative = new DOMMatrix();
+  for (const transform of nodes.slice(1)) {
+    relative = relative.multiply(transform);
+  }
+  return relative;
+}
+function sameMatrixExactly2D(left, right) {
+  return left.a === right.a && left.b === right.b && left.c === right.c && left.d === right.d && left.e === right.e && left.f === right.f;
+}
+function requireBodyFrame(world, bodyId) {
+  const frame = bodyFramesByWorld2D.get(world)?.get(bodyId);
+  if (!frame)
+    throw new Error("A collider requires its body geometry to prepare first.");
+  return frame;
+}
+function withColliderShape(options, shape) {
+  return Object.freeze({ ...options, shape });
+}
+function stableGeometryKey(style) {
+  return JSON.stringify(style, (key, value) => {
+    if (["fill", "stroke", "opacity", "cursor", "filter", "src"].includes(key)) {
+      return void 0;
+    }
+    if (typeof value === "function") return void 0;
+    if (typeof Path2D !== "undefined" && value instanceof Path2D) {
+      return "[opaque Path2D]";
+    }
+    return value;
+  });
+}
+function normalizeOptionalCollider(value, path) {
+  if (value === false) return false;
+  if (value === void 0) return normalizeCollider({}, path);
+  if (isPhysicsShape2D(value)) return normalizeCollider({ shape: value }, path);
+  return normalizeCollider(value, path);
+}
+function normalizeCollider(options, path) {
+  const shape = options.shape ?? "self";
+  if (shape !== "self") requireShapeRecord2D(shape);
+  const restitution = requireNonnegativeNumber(
+    options.restitution ?? 0,
+    `${path}.restitution`
+  );
+  if (restitution > 1) {
+    throw new RangeError(`${path}.restitution must be from zero through one.`);
+  }
+  const sensor = options.sensor ?? false;
+  return Object.freeze({
+    shape,
+    offset: copyFiniteVector2(options.offset ?? [0, 0], `${path}.offset`),
+    rotationDegrees: requireFiniteNumber(
+      options.rotationDegrees ?? 0,
+      `${path}.rotationDegrees`
+    ),
+    density: requirePositiveNumber(options.density ?? 1, `${path}.density`),
+    friction: requireNonnegativeNumber(
+      options.friction ?? 0.5,
+      `${path}.friction`
+    ),
+    restitution,
+    sensor,
+    contributesToMass: options.contributesToMass ?? !sensor,
+    collisionFilter: normalizeCollisionFilter(options.collisionFilter, path),
+    tag: options.tag,
+    handlers: normalizeHandlers(options, path)
+  });
+}
+function normalizeCollisionFilter(filter, path) {
+  return Object.freeze({
+    category: requireSafeIntegerInRange(
+      filter?.category ?? 1,
+      0,
+      4294967295,
+      `${path}.collisionFilter.category`
+    ),
+    mask: requireSafeIntegerInRange(
+      filter?.mask ?? 4294967295,
+      0,
+      4294967295,
+      `${path}.collisionFilter.mask`
+    ),
+    group: requireSafeIntegerInRange(
+      filter?.group ?? 0,
+      -2147483648,
+      2147483647,
+      `${path}.collisionFilter.group`
+    )
+  });
+}
+function normalizeHandlers(options, path) {
+  const handlers = {
+    onCollisionStart: options.onCollisionStart,
+    onCollisionEnd: options.onCollisionEnd,
+    onHit: options.onHit,
+    onOverlapStart: options.onOverlapStart,
+    onOverlapEnd: options.onOverlapEnd
+  };
+  for (const [name, handler] of Object.entries(handlers)) {
+    if (handler !== void 0 && typeof handler !== "function") {
+      throw new TypeError(`${path}.${name} must be a function.`);
+    }
+  }
+  return Object.freeze(handlers);
+}
+function isPhysicsShape2D(value) {
+  try {
+    requireShapeRecord2D(value);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function sameColliderShapeInput(left, right) {
+  return left.shape === right.shape && left.offset[0] === right.offset[0] && left.offset[1] === right.offset[1] && left.rotationDegrees === right.rotationDegrees;
+}
+export {
+  MountedPhysicsAttachment2D,
+  collider2D,
+  dynamicBody2D,
+  kinematicBody2D,
+  requirePhysicsAttachment2DDescriptor,
+  snapshotPhysicsBodyFrameCountForTest,
+  staticBody2D
+};
+//# sourceMappingURL=descriptors.js.map

package/dist/features/physics/lib/2d/runtime/descriptors.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../src/features/physics/lib/2d/runtime/descriptors.ts"],
+  "sourcesContent": ["import { Group, isSignal } from \"@pibbl/core\";\nimport {\n  pibblInternalCreatePropAttachment,\n  type PibblInternalPrimitiveAttachmentInput,\n  type PibblInternalMountedPropAttachment,\n} from \"@pibbl/core/internal\";\nimport type {\n  PibblPhysicsShape2D,\n  PibblPhysicsVector2,\n} from \"../../../2d-geometry.js\";\nimport { transformShape2D } from \"../../../2d-geometry.js\";\nimport { requireShapeRecord2D, type ShapeRecord2D } from \"../shape-records.js\";\nimport type {\n  PibblPhysicsAttachment2D,\n  PibblPhysicsBodyAttachment2D,\n  PibblPhysicsBodyHandle2D,\n  PibblPhysicsColliderAttachment2D,\n  PibblPhysicsColliderConfiguration2D,\n  PibblPhysicsCollisionFilter,\n  PibblPhysicsDynamicBody2DOptions,\n  PibblPhysicsKinematicBody2DOptions,\n  PibblPhysicsKinematicTarget2D,\n  PibblPhysicsStaticBody2DOptions,\n} from \"../types.js\";\nimport {\n  copyFiniteVector2,\n  requireFiniteNumber,\n  requireNonnegativeNumber,\n  requirePositiveNumber,\n  requireSafeIntegerInRange,\n} from \"../../shared/validation.js\";\nimport {\n  pushPhysicsBody2D,\n  requireCurrentPhysicsBody2D,\n  requireCurrentPhysicsWorld2D,\n} from \"./context.js\";\nimport {\n  bakeCanvasShapeTransform2D,\n  inferCanvasColliderShape2D,\n} from \"../canvas/inference.js\";\nimport {\n  bodyLocalTransformFromPrimitive2D,\n  captureBodyPresentation2D,\n  matrixFromPose,\n  resolveDynamicPresentationTransform2D,\n  type CanvasBodyPresentationCapture2D,\n} from \"../canvas/presentation.js\";\n\nconst bodyFramesByWorld2D = new WeakMap<object, Map<number, BodyFrame2D>>();\n\ninterface BodyFrame2D {\n  readonly poseMatrix: DOMMatrix;\n  readonly preBodyLineage: PibblInternalPrimitiveAttachmentInput[\"presentationTransformLineage\"];\n  readonly untrackedCanvasTransformCount: number;\n}\n\nconst attachmentRecord2DSymbol = Symbol(\"PibblPhysicsAttachment2D\");\n\n// Exact Pibbl presentation anchors preserve authored transforms as doubles. A\n// relative collider frame still performs one inversion and one multiplication,\n// so accept only their bounded IEEE-754 double-operation noise. This is never\n// an authored-geometry epsilon: a post-mount 1e-7 translation or scale change\n// remains observable.\nconst RELATIVE_MATRIX_ROUNDOFF_OPERATIONS = 32;\n\nexport interface NormalizedPhysicsCollisionFilter2D {\n  readonly category: number;\n  readonly mask: number;\n  readonly group: number;\n}\n\nexport interface NormalizedPhysicsColliderConfiguration2D {\n  readonly shape: \"self\" | PibblPhysicsShape2D;\n  readonly offset: PibblPhysicsVector2;\n  readonly rotationDegrees: number;\n  readonly density: number;\n  readonly friction: number;\n  readonly restitution: number;\n  readonly sensor: boolean;\n  readonly contributesToMass: boolean;\n  readonly collisionFilter: NormalizedPhysicsCollisionFilter2D;\n  readonly tag: unknown;\n  readonly handlers: Readonly<{\n    readonly onCollisionStart?: PibblPhysicsColliderConfiguration2D[\"onCollisionStart\"];\n    readonly onCollisionEnd?: PibblPhysicsColliderConfiguration2D[\"onCollisionEnd\"];\n    readonly onHit?: PibblPhysicsColliderConfiguration2D[\"onHit\"];\n    readonly onOverlapStart?: PibblPhysicsColliderConfiguration2D[\"onOverlapStart\"];\n    readonly onOverlapEnd?: PibblPhysicsColliderConfiguration2D[\"onOverlapEnd\"];\n  }>;\n}\n\nexport interface NormalizedPhysicsDynamicBody2DOptions {\n  readonly enabled: boolean;\n  readonly handle: PibblPhysicsBodyHandle2D | undefined;\n  readonly linearVelocity: PibblPhysicsVector2;\n  readonly angularVelocityDegreesPerSecond: number;\n  readonly linearDamping: number;\n  readonly angularDamping: number;\n  readonly gravityScale: number;\n  readonly mass: \"auto\" | number;\n  readonly fixedRotation: boolean;\n  readonly allowSleep: boolean;\n  readonly ccd: boolean;\n  readonly reenableVelocity: \"zero\" | \"preserve\";\n  readonly collider: false | NormalizedPhysicsColliderConfiguration2D;\n}\n\nexport interface NormalizedPhysicsStaticBody2DOptions {\n  readonly enabled: boolean;\n  readonly handle: PibblPhysicsBodyHandle2D | undefined;\n  readonly collider: false | NormalizedPhysicsColliderConfiguration2D;\n}\n\nexport interface NormalizedPhysicsKinematicBody2DOptions {\n  readonly enabled: boolean;\n  readonly handle: PibblPhysicsBodyHandle2D | undefined;\n  readonly target: Readonly<PibblPhysicsKinematicTarget2D>;\n  readonly allowSleep: boolean;\n  readonly collider: false | NormalizedPhysicsColliderConfiguration2D;\n}\n\nexport type PhysicsBodyAttachment2DDescriptor =\n  | Readonly<{\n      readonly kind: \"body\";\n      readonly bodyType: \"dynamic\";\n      readonly options: NormalizedPhysicsDynamicBody2DOptions;\n    }>\n  | Readonly<{\n      readonly kind: \"body\";\n      readonly bodyType: \"static\";\n      readonly options: NormalizedPhysicsStaticBody2DOptions;\n    }>\n  | Readonly<{\n      readonly kind: \"body\";\n      readonly bodyType: \"kinematic\";\n      readonly options: NormalizedPhysicsKinematicBody2DOptions;\n    }>;\n\nexport interface PhysicsColliderAttachment2DDescriptor {\n  readonly kind: \"collider\";\n  readonly options: NormalizedPhysicsColliderConfiguration2D;\n}\n\nexport type PhysicsAttachment2DDescriptor =\n  PhysicsBodyAttachment2DDescriptor | PhysicsColliderAttachment2DDescriptor;\n\ntype RegisteredAttachment2D = Readonly<{\n  readonly [attachmentRecord2DSymbol]: PhysicsAttachment2DDescriptor;\n}>;\n\n/**\n * Creates a declarative body attachment whose motion is advanced by the physics solver.\n *\n * @param options - Dynamic body, collider, and initial motion configuration. See\n * {@link PibblPhysicsDynamicBody2DOptions} .\n * @returns A dynamic-body attachment for a supported primitive's physics prop. See\n * {@link PibblPhysicsBodyAttachment2D} .\n *\n * @see {@link PibblPhysicsDynamicBody2DOptions}\n * @see {@link PibblPhysicsBodyAttachment2D}\n */\nexport function dynamicBody2D(\n  options: PibblPhysicsDynamicBody2DOptions = {},\n): PibblPhysicsBodyAttachment2D {\n  const mass = options.mass ?? \"auto\";\n  if (mass !== \"auto\") requirePositiveNumber(mass, \"options.mass\");\n  const reenableVelocity = options.reenableVelocity ?? \"zero\";\n  if (reenableVelocity !== \"zero\" && reenableVelocity !== \"preserve\") {\n    throw new TypeError(\n      'options.reenableVelocity must be \"zero\" or \"preserve\".',\n    );\n  }\n  return createAttachment({\n    kind: \"body\",\n    bodyType: \"dynamic\",\n    options: Object.freeze({\n      enabled: options.enabled ?? true,\n      handle: options.handle,\n      linearVelocity: copyFiniteVector2(\n        options.linearVelocity ?? [0, 0],\n        \"options.linearVelocity\",\n      ),\n      angularVelocityDegreesPerSecond: requireFiniteNumber(\n        options.angularVelocityDegreesPerSecond ?? 0,\n        \"options.angularVelocityDegreesPerSecond\",\n      ),\n      linearDamping: requireNonnegativeNumber(\n        options.linearDamping ?? 0,\n        \"options.linearDamping\",\n      ),\n      angularDamping: requireNonnegativeNumber(\n        options.angularDamping ?? 0,\n        \"options.angularDamping\",\n      ),\n      gravityScale: requireFiniteNumber(\n        options.gravityScale ?? 1,\n        \"options.gravityScale\",\n      ),\n      mass,\n      fixedRotation: options.fixedRotation ?? false,\n      allowSleep: options.allowSleep ?? true,\n      ccd: options.ccd ?? false,\n      reenableVelocity,\n      collider: normalizeOptionalCollider(options.collider, \"options.collider\"),\n    }),\n  });\n}\n\n/**\n * Creates a declarative body attachment that remains fixed in the simulation.\n *\n * @param options - Static body and collider configuration. See\n * {@link PibblPhysicsStaticBody2DOptions} .\n * @returns A static-body attachment for a supported primitive's physics prop. See\n * {@link PibblPhysicsBodyAttachment2D} .\n *\n * @see {@link PibblPhysicsStaticBody2DOptions}\n * @see {@link PibblPhysicsBodyAttachment2D}\n */\nexport function staticBody2D(\n  options: PibblPhysicsStaticBody2DOptions = {},\n): PibblPhysicsBodyAttachment2D {\n  return createAttachment({\n    kind: \"body\",\n    bodyType: \"static\",\n    options: Object.freeze({\n      enabled: options.enabled ?? true,\n      handle: options.handle,\n      collider: normalizeOptionalCollider(options.collider, \"options.collider\"),\n    }),\n  });\n}\n\n/**\n * Creates a declarative body attachment driven by application-supplied target signals.\n *\n * @param options - Kinematic body, collider, and motion configuration. See\n * {@link PibblPhysicsKinematicBody2DOptions} .\n * @returns A kinematic-body attachment for a supported primitive's physics prop. See\n * {@link PibblPhysicsBodyAttachment2D} .\n *\n * @see {@link PibblPhysicsKinematicBody2DOptions}\n * @see {@link PibblPhysicsBodyAttachment2D}\n */\nexport function kinematicBody2D(\n  options: PibblPhysicsKinematicBody2DOptions = {},\n): PibblPhysicsBodyAttachment2D {\n  const target = options.target ?? {};\n  if (target.position !== undefined && !isSignal(target.position)) {\n    throw new TypeError(\"options.target.position must be a Pibbl signal.\");\n  }\n  if (\n    target.rotationDegrees !== undefined &&\n    !isSignal(target.rotationDegrees)\n  ) {\n    throw new TypeError(\"options.target.rotationDegrees must be a Pibbl signal.\");\n  }\n  return createAttachment({\n    kind: \"body\",\n    bodyType: \"kinematic\",\n    options: Object.freeze({\n      enabled: options.enabled ?? true,\n      handle: options.handle,\n      target: Object.freeze({\n        position: target.position,\n        rotationDegrees: target.rotationDegrees,\n      }),\n      allowSleep: options.allowSleep ?? true,\n      collider: normalizeOptionalCollider(options.collider, \"options.collider\"),\n    }),\n  });\n}\n\n/**\n * Creates a declarative collider attachment for a primitive within a physics body.\n *\n * @param options - Collider shape, material, filtering, and sensor configuration. See\n * {@link PibblPhysicsColliderConfiguration2D} .\n * @returns A collider attachment for a supported primitive's physics prop. See\n * {@link PibblPhysicsColliderAttachment2D} .\n *\n * @see {@link PibblPhysicsColliderConfiguration2D}\n * @see {@link PibblPhysicsColliderAttachment2D}\n */\nexport function collider2D(\n  options: PibblPhysicsColliderConfiguration2D = {},\n): PibblPhysicsColliderAttachment2D {\n  return createAttachment({\n    kind: \"collider\",\n    options: normalizeCollider(options, \"options\"),\n  });\n}\n\nexport function requirePhysicsAttachment2DDescriptor(\n  value: PibblPhysicsAttachment2D,\n): PhysicsAttachment2DDescriptor {\n  const descriptor =\n    typeof value === \"object\" && value !== null\n      ? (value as Partial<RegisteredAttachment2D>)[attachmentRecord2DSymbol]\n      : undefined;\n  if (descriptor === undefined) {\n    throw new TypeError(\"Expected a registered Pibbl physics 2D attachment.\");\n  }\n  return descriptor;\n}\n\nfunction createAttachment<T extends PhysicsAttachment2DDescriptor>(\n  descriptor: T,\n): T[\"kind\"] extends \"body\"\n  ? PibblPhysicsBodyAttachment2D\n  : PibblPhysicsColliderAttachment2D {\n  const frozenDescriptor = Object.freeze(descriptor);\n  const value = Object.freeze({\n    [attachmentRecord2DSymbol]: frozenDescriptor,\n  }) as unknown as RegisteredAttachment2D & PibblPhysicsAttachment2D;\n  return pibblInternalCreatePropAttachment(\n    \"physics\",\n    value,\n    () => new MountedPhysicsAttachment2D(value),\n  ) as never;\n}\n\nexport class MountedPhysicsAttachment2D implements PibblInternalMountedPropAttachment {\n  private descriptor: PhysicsAttachment2DDescriptor;\n  private world: ReturnType<typeof requireCurrentPhysicsWorld2D> | undefined;\n  private bodyId: number | undefined;\n  private releaseBodyScope: (() => void) | undefined;\n  private cachedShapeInput:\n    NormalizedPhysicsColliderConfiguration2D | undefined;\n  private cachedShape: ShapeRecord2D | undefined;\n  private cachedSelfShapeKey: string | undefined;\n  private cachedSelfShape: PibblPhysicsShape2D | undefined;\n  private cachedBakedSource: PibblPhysicsShape2D | undefined;\n  private cachedBakedTransform: readonly number[] | undefined;\n  private cachedBakedShape: PibblPhysicsShape2D | undefined;\n  private bodyPresentation: CanvasBodyPresentationCapture2D | undefined;\n  // `exit` runs after every traversal, while `dispose` runs only when this\n  // mounted attachment is actually removed. Keep the last ownership key so a\n  // removed keyed body releases its presentation lineage from the long-lived\n  // world's frame map.\n  private bodyFrameWorld: object | undefined;\n  private bodyFrameId: number | undefined;\n  private wasEnabled = false;\n\n  constructor(value: PibblPhysicsAttachment2D) {\n    this.descriptor = requirePhysicsAttachment2DDescriptor(value);\n  }\n\n  update(value: unknown): void {\n    const next = requirePhysicsAttachment2DDescriptor(\n      value as PibblPhysicsAttachment2D,\n    );\n    if (this.descriptor.kind === \"body\" && next.kind !== \"body\") {\n      this.releaseBodyFrame();\n    }\n    this.descriptor = next;\n  }\n\n  enter(): void {\n    const world = requireCurrentPhysicsWorld2D();\n    this.world = world;\n    if (this.descriptor.kind === \"body\") {\n      const bodyId = world.bodyIdFor(this);\n      if (\n        this.bodyFrameWorld !== undefined &&\n        (this.bodyFrameWorld !== world || this.bodyFrameId !== bodyId)\n      ) {\n        this.releaseBodyFrame();\n      }\n      this.bodyId = bodyId;\n      this.releaseBodyScope = pushPhysicsBody2D({ world, bodyId });\n    } else {\n      this.bodyId = requireCurrentPhysicsBody2D().bodyId;\n    }\n  }\n\n  preparePrimitive(\n    input: PibblInternalPrimitiveAttachmentInput,\n  ): Readonly<{ readonly presentationTransform2D?: DOMMatrix }> | void {\n    const world = this.world;\n    const bodyId = this.bodyId;\n    if (world === undefined || bodyId === undefined) {\n      throw new Error(\n        \"Physics 2D attachment preparation requires its entered scope.\",\n      );\n    }\n    if (this.descriptor.kind === \"body\") {\n      const descriptor = this.descriptor;\n      const simulationParent = world.simulationTransform(\n        input.parentWorldTransform,\n      );\n      const enabled = descriptor.options.enabled;\n      const reenabled = !this.wasEnabled && enabled;\n      const local = bodyLocalTransformFromPrimitive2D(\n        input.componentType,\n        input.style,\n      );\n      if (\n        this.bodyPresentation === undefined ||\n        reenabled ||\n        descriptor.bodyType !== \"dynamic\"\n      ) {\n        this.bodyPresentation = captureBodyPresentation2D(\n          simulationParent,\n          local,\n          input.componentName,\n          descriptor.bodyType === \"dynamic\" && enabled,\n        );\n      }\n      const presentation = this.bodyPresentation;\n      let bodyFrames = bodyFramesByWorld2D.get(world);\n      if (!bodyFrames) {\n        bodyFrames = new Map();\n        bodyFramesByWorld2D.set(world, bodyFrames);\n      }\n      let presentationTransform2D: DOMMatrix | undefined;\n      let effectiveBodyFrame: DOMMatrix;\n      if (!enabled || descriptor.bodyType !== \"dynamic\") {\n        effectiveBodyFrame = world.rootTransform(\n          matrixFromPose(presentation.initialPose),\n        );\n      } else {\n        world.handle.revision.get();\n        const presentedPose = reenabled\n          ? presentation.initialPose\n          : (world.presentationPose(bodyId) ?? presentation.initialPose);\n        presentationTransform2D = resolveDynamicPresentationTransform2D(\n          presentation,\n          presentedPose,\n          simulationParent,\n          local,\n          input.componentName,\n        );\n        effectiveBodyFrame = input.parentWorldTransform.multiply(\n          presentationTransform2D.multiply(local),\n        );\n      }\n      bodyFrames.set(\n        bodyId,\n        Object.freeze({\n          poseMatrix: effectiveBodyFrame,\n          preBodyLineage: input.presentationTransformLineage,\n          untrackedCanvasTransformCount:\n            (input.presentationTransformLineage\n              ?.untrackedCanvasTransformCount ?? 0) +\n            (input.hasUntrackedCanvasTransform ? 1 : 0),\n        }),\n      );\n      this.bodyFrameWorld = world;\n      this.bodyFrameId = bodyId;\n      const collider = descriptor.options.collider;\n      const effectiveCollider =\n        collider === false\n          ? false\n          : collider.shape === \"self\" && input.componentType === Group\n            ? false\n            : withColliderShape(\n                collider,\n                this.bakeShape(\n                  collider.shape === \"self\"\n                    ? this.resolveSelfShape(input)\n                    : collider.shape,\n                  descriptor.bodyType === \"dynamic\"\n                    ? matrixFromPose(presentation.initialPose)\n                        .inverse()\n                        .multiply(simulationParent)\n                        .multiply(local)\n                    : relativeColliderTransform2D(\n                        effectiveBodyFrame,\n                        input.parentWorldTransform,\n                      ).multiply(local),\n                ),\n              );\n      const effectiveDescriptor =\n        effectiveCollider === collider\n          ? descriptor\n          : (Object.freeze({\n              ...descriptor,\n              options: Object.freeze({\n                ...descriptor.options,\n                collider: effectiveCollider,\n              }),\n            }) as PhysicsBodyAttachment2DDescriptor);\n      world.collectBody(\n        this,\n        bodyId,\n        effectiveDescriptor,\n        presentation.initialPose,\n      );\n      this.wasEnabled = enabled;\n      return presentationTransform2D === undefined\n        ? undefined\n        : { presentationTransform2D };\n    } else {\n      const bodyFrame = requireBodyFrame(world, bodyId);\n      const lineageTransform = relativeColliderTransformFromLineage2D(\n        bodyFrame,\n        input,\n      );\n      const options = withColliderShape(\n        this.descriptor.options,\n        this.bakeShape(\n          this.descriptor.options.shape === \"self\"\n            ? this.resolveSelfShape(input)\n            : this.descriptor.options.shape,\n          (\n            lineageTransform ??\n            relativeColliderTransform2D(\n              bodyFrame.poseMatrix,\n              input.parentWorldTransform,\n            )\n          ).multiply(\n            bodyLocalTransformFromPrimitive2D(input.componentType, input.style),\n          ),\n          lineageTransform === undefined,\n        ),\n      );\n      world.collectCollider(this, bodyId, options);\n    }\n  }\n\n  exit(_success: boolean): void {\n    try {\n      this.releaseBodyScope?.();\n    } finally {\n      this.releaseBodyScope = undefined;\n      this.bodyId = undefined;\n      this.world = undefined;\n    }\n  }\n\n  dispose(): void {\n    try {\n      this.exit(false);\n    } finally {\n      this.releaseBodyFrame();\n    }\n  }\n\n  private releaseBodyFrame(): void {\n    const world = this.bodyFrameWorld;\n    const bodyId = this.bodyFrameId;\n    if (world !== undefined && bodyId !== undefined) {\n      const frames = bodyFramesByWorld2D.get(world);\n      frames?.delete(bodyId);\n      if (frames?.size === 0) bodyFramesByWorld2D.delete(world);\n    }\n    this.bodyFrameWorld = undefined;\n    this.bodyFrameId = undefined;\n  }\n\n  resolveShape(\n    options: NormalizedPhysicsColliderConfiguration2D,\n  ): ShapeRecord2D {\n    if (\n      this.cachedShapeInput &&\n      sameColliderShapeInput(this.cachedShapeInput, options)\n    ) {\n      return this.cachedShape!;\n    }\n    if (options.shape === \"self\") {\n      throw new Error(\n        \"Self collider inference is not available in this runtime task.\",\n      );\n    }\n    const transformed =\n      options.offset[0] === 0 &&\n      options.offset[1] === 0 &&\n      options.rotationDegrees === 0\n        ? options.shape\n        : transformShape2D(options.shape, {\n            position: options.offset,\n            rotationDegrees: options.rotationDegrees,\n          });\n    this.cachedShapeInput = options;\n    this.cachedShape = requireShapeRecord2D(transformed);\n    return this.cachedShape;\n  }\n\n  private resolveSelfShape(\n    input: PibblInternalPrimitiveAttachmentInput,\n  ): PibblPhysicsShape2D {\n    const key = `${input.componentName}:${stableGeometryKey(input.style)}`;\n    if (key === this.cachedSelfShapeKey) return this.cachedSelfShape!;\n    const shape = inferCanvasColliderShape2D(input);\n    this.cachedSelfShapeKey = key;\n    this.cachedSelfShape = shape;\n    return shape;\n  }\n\n  private bakeShape(\n    shape: PibblPhysicsShape2D,\n    transform: DOMMatrixReadOnly,\n    stabilizeFallback = true,\n  ): PibblPhysicsShape2D {\n    const candidate = [\n      transform.a,\n      transform.b,\n      transform.c,\n      transform.d,\n      transform.e,\n      transform.f,\n    ];\n    const values =\n      stabilizeFallback &&\n      this.cachedBakedSource === shape &&\n      this.cachedBakedTransform !== undefined &&\n      sameRelativeTransformWithinCanvasRoundoff(\n        this.cachedBakedTransform,\n        candidate,\n      )\n        ? this.cachedBakedTransform\n        : candidate;\n    if (\n      this.cachedBakedSource === shape &&\n      this.cachedBakedTransform?.every(\n        (value, index) => value === values[index],\n      )\n    ) {\n      return this.cachedBakedShape!;\n    }\n    const baked = bakeCanvasShapeTransform2D(shape, new DOMMatrix([...values]));\n    this.cachedBakedSource = shape;\n    this.cachedBakedTransform = Object.freeze(values);\n    this.cachedBakedShape = baked;\n    return baked;\n  }\n}\n\n/** @internal Test-only ownership observation. */\nexport function snapshotPhysicsBodyFrameCountForTest(world: object): number {\n  return bodyFramesByWorld2D.get(world)?.size ?? 0;\n}\n\nfunction sameRelativeTransformWithinCanvasRoundoff(\n  previous: readonly number[],\n  candidate: readonly number[],\n): boolean {\n  return previous.every((value, index) => {\n    const next = candidate[index]!;\n    const tolerance =\n      index < 4\n        ? linearTransformRoundoffTolerance(value, next)\n        : translationRoundoffTolerance(value, next);\n    return Math.abs(value - next) <= tolerance;\n  });\n}\n\nfunction linearTransformRoundoffTolerance(\n  previous: number,\n  candidate: number,\n): number {\n  const magnitude = Math.max(1, Math.abs(previous), Math.abs(candidate));\n  return (\n    RELATIVE_MATRIX_ROUNDOFF_OPERATIONS * Number.EPSILON * magnitude * magnitude\n  );\n}\n\nfunction translationRoundoffTolerance(\n  previous: number,\n  candidate: number,\n): number {\n  return (\n    RELATIVE_MATRIX_ROUNDOFF_OPERATIONS *\n    Number.EPSILON *\n    (1 + Math.max(Math.abs(previous), Math.abs(candidate)))\n  );\n}\n\nfunction relativeColliderTransform2D(\n  bodyFrame: DOMMatrixReadOnly,\n  colliderParentFrame: DOMMatrixReadOnly,\n): DOMMatrixReadOnly {\n  return sameMatrixExactly2D(bodyFrame, colliderParentFrame)\n    ? new DOMMatrix()\n    : bodyFrame.inverse().multiply(colliderParentFrame);\n}\n\nfunction relativeColliderTransformFromLineage2D(\n  bodyFrame: BodyFrame2D,\n  input: PibblInternalPrimitiveAttachmentInput,\n): DOMMatrix | undefined {\n  const inputUntrackedCanvasTransformCount =\n    (input.presentationTransformLineage?.untrackedCanvasTransformCount ?? 0) +\n    (input.hasUntrackedCanvasTransform ? 1 : 0);\n  if (\n    inputUntrackedCanvasTransformCount !==\n    bodyFrame.untrackedCanvasTransformCount\n  ) {\n    return undefined;\n  }\n  const nodes: DOMMatrix[] = [];\n  let cursor = input.presentationTransformLineage;\n  while (cursor !== bodyFrame.preBodyLineage) {\n    if (cursor === undefined) return undefined;\n    nodes.push(cursor.localTransform);\n    cursor = cursor.parent;\n  }\n  nodes.reverse();\n  if (nodes.length === 0) return new DOMMatrix();\n  let relative = new DOMMatrix();\n  for (const transform of nodes.slice(1)) {\n    relative = relative.multiply(transform);\n  }\n  return relative;\n}\n\nfunction sameMatrixExactly2D(\n  left: DOMMatrixReadOnly,\n  right: DOMMatrixReadOnly,\n): boolean {\n  return (\n    left.a === right.a &&\n    left.b === right.b &&\n    left.c === right.c &&\n    left.d === right.d &&\n    left.e === right.e &&\n    left.f === right.f\n  );\n}\n\nfunction requireBodyFrame(world: object, bodyId: number): BodyFrame2D {\n  const frame = bodyFramesByWorld2D.get(world)?.get(bodyId);\n  if (!frame)\n    throw new Error(\"A collider requires its body geometry to prepare first.\");\n  return frame;\n}\n\nfunction withColliderShape(\n  options: NormalizedPhysicsColliderConfiguration2D,\n  shape: PibblPhysicsShape2D,\n): NormalizedPhysicsColliderConfiguration2D {\n  return Object.freeze({ ...options, shape });\n}\n\nfunction stableGeometryKey(\n  style: Readonly<Record<PropertyKey, unknown>>,\n): string {\n  return JSON.stringify(style, (key, value: unknown) => {\n    if (\n      [\"fill\", \"stroke\", \"opacity\", \"cursor\", \"filter\", \"src\"].includes(key)\n    ) {\n      return undefined;\n    }\n    if (typeof value === \"function\") return undefined;\n    if (typeof Path2D !== \"undefined\" && value instanceof Path2D) {\n      return \"[opaque Path2D]\";\n    }\n    return value;\n  });\n}\n\nfunction normalizeOptionalCollider(\n  value:\n    false | PibblPhysicsColliderConfiguration2D | PibblPhysicsShape2D | undefined,\n  path: string,\n): false | NormalizedPhysicsColliderConfiguration2D {\n  if (value === false) return false;\n  if (value === undefined) return normalizeCollider({}, path);\n  if (isPhysicsShape2D(value)) return normalizeCollider({ shape: value }, path);\n  return normalizeCollider(value, path);\n}\n\nfunction normalizeCollider(\n  options: PibblPhysicsColliderConfiguration2D,\n  path: string,\n): NormalizedPhysicsColliderConfiguration2D {\n  const shape = options.shape ?? \"self\";\n  if (shape !== \"self\") requireShapeRecord2D(shape);\n  const restitution = requireNonnegativeNumber(\n    options.restitution ?? 0,\n    `${path}.restitution`,\n  );\n  if (restitution > 1) {\n    throw new RangeError(`${path}.restitution must be from zero through one.`);\n  }\n  const sensor = options.sensor ?? false;\n  return Object.freeze({\n    shape,\n    offset: copyFiniteVector2(options.offset ?? [0, 0], `${path}.offset`),\n    rotationDegrees: requireFiniteNumber(\n      options.rotationDegrees ?? 0,\n      `${path}.rotationDegrees`,\n    ),\n    density: requirePositiveNumber(options.density ?? 1, `${path}.density`),\n    friction: requireNonnegativeNumber(\n      options.friction ?? 0.5,\n      `${path}.friction`,\n    ),\n    restitution,\n    sensor,\n    contributesToMass: options.contributesToMass ?? !sensor,\n    collisionFilter: normalizeCollisionFilter(options.collisionFilter, path),\n    tag: options.tag,\n    handlers: normalizeHandlers(options, path),\n  });\n}\n\nfunction normalizeCollisionFilter(\n  filter: PibblPhysicsCollisionFilter | undefined,\n  path: string,\n): NormalizedPhysicsCollisionFilter2D {\n  return Object.freeze({\n    category: requireSafeIntegerInRange(\n      filter?.category ?? 1,\n      0,\n      0xffff_ffff,\n      `${path}.collisionFilter.category`,\n    ),\n    mask: requireSafeIntegerInRange(\n      filter?.mask ?? 0xffff_ffff,\n      0,\n      0xffff_ffff,\n      `${path}.collisionFilter.mask`,\n    ),\n    group: requireSafeIntegerInRange(\n      filter?.group ?? 0,\n      -0x8000_0000,\n      0x7fff_ffff,\n      `${path}.collisionFilter.group`,\n    ),\n  });\n}\n\nfunction normalizeHandlers(\n  options: PibblPhysicsColliderConfiguration2D,\n  path: string,\n): NormalizedPhysicsColliderConfiguration2D[\"handlers\"] {\n  const handlers = {\n    onCollisionStart: options.onCollisionStart,\n    onCollisionEnd: options.onCollisionEnd,\n    onHit: options.onHit,\n    onOverlapStart: options.onOverlapStart,\n    onOverlapEnd: options.onOverlapEnd,\n  };\n  for (const [name, handler] of Object.entries(handlers)) {\n    if (handler !== undefined && typeof handler !== \"function\") {\n      throw new TypeError(`${path}.${name} must be a function.`);\n    }\n  }\n  return Object.freeze(handlers);\n}\n\nfunction isPhysicsShape2D(value: object): value is PibblPhysicsShape2D {\n  try {\n    requireShapeRecord2D(value as PibblPhysicsShape2D);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\nfunction sameColliderShapeInput(\n  left: NormalizedPhysicsColliderConfiguration2D,\n  right: NormalizedPhysicsColliderConfiguration2D,\n): boolean {\n  return (\n    left.shape === right.shape &&\n    left.offset[0] === right.offset[0] &&\n    left.offset[1] === right.offset[1] &&\n    left.rotationDegrees === right.rotationDegrees\n  );\n}\n"],
+  "mappings": "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",
+  "names": []
+}

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

@@ -0,0 +1,56 @@
+import type { PibblPhysicsBodyHandle2D, PibblPhysicsBodyStateEvent2D, PibblPhysicsBodyStateHandler2D, PibblPhysicsColliderHandle2D, PibblPhysicsCollisionEvent2D, PibblPhysicsCollisionHandler2D, PibblPhysicsOverlapEvent2D, PibblPhysicsOverlapHandler2D } from "../types.js";
+import type { PhysicsWorld2DController } from "./controller.js";
+export interface PhysicsColliderHandleIdentity2D {
+    readonly controller: PhysicsWorld2DController;
+    readonly index: number;
+    readonly generation: number;
+}
+export interface PhysicsContactEventDelivery2D {
+    readonly kind: 1 | 2 | 3 | 4 | 7;
+    readonly tick: number;
+    readonly firstColliderIndex: number;
+    readonly firstColliderGeneration: number;
+    readonly secondColliderIndex: number;
+    readonly secondColliderGeneration: number;
+    readonly firstBodyIndex: number;
+    readonly firstBodyGeneration: number;
+    readonly secondBodyIndex: number;
+    readonly secondBodyGeneration: number;
+    readonly receiver: "first" | "second";
+    readonly receiverColliderId: number;
+    readonly receiverBodyId: number;
+    readonly handler: PibblPhysicsCollisionHandler2D | PibblPhysicsOverlapHandler2D;
+    readonly selfTag: unknown;
+    readonly otherTag: unknown;
+    readonly normalX: number;
+    readonly normalY: number;
+    readonly points: readonly Readonly<{
+        readonly firstX: number;
+        readonly firstY: number;
+        readonly secondX: number;
+        readonly secondY: number;
+        readonly separation: number;
+    }>[];
+    readonly totalNormalImpulse: number;
+}
+export interface PhysicsBodyEventDelivery2D {
+    readonly kind: 5 | 6;
+    readonly tick: number;
+    readonly bodyIndex: number;
+    readonly bodyGeneration: number;
+    readonly bodyId: number;
+    readonly handler: PibblPhysicsBodyStateHandler2D;
+}
+export type PhysicsEventDelivery2D = PhysicsContactEventDelivery2D | PhysicsBodyEventDelivery2D;
+export declare function isPhysicsBodyEventDelivery2D(delivery: PhysicsEventDelivery2D): delivery is PhysicsBodyEventDelivery2D;
+export interface PhysicsEventHandles2D {
+    readonly body: (index: number, generation: number) => PibblPhysicsBodyHandle2D;
+    readonly collider: (index: number, generation: number) => PibblPhysicsColliderHandle2D;
+}
+export declare function createPhysicsColliderHandle2D(controller: PhysicsWorld2DController, index: number, generation: number): PibblPhysicsColliderHandle2D;
+export declare function physicsColliderHandleIdentity2D(handle: PibblPhysicsColliderHandle2D): PhysicsColliderHandleIdentity2D | undefined;
+export declare function sortPhysicsEventDeliveries2D(deliveries: PhysicsEventDelivery2D[]): readonly PhysicsEventDelivery2D[];
+export declare function materializePhysicsContactEvent2D(fact: PhysicsContactEventDelivery2D, handles: PhysicsEventHandles2D): PibblPhysicsCollisionEvent2D | PibblPhysicsOverlapEvent2D;
+export declare function materializePhysicsBodyEvent2D(fact: PhysicsBodyEventDelivery2D, body: PibblPhysicsBodyHandle2D): PibblPhysicsBodyStateEvent2D;
+export declare function snapshotPhysicsEventMaterializationsForTest(): number;
+export declare function resetPhysicsEventMaterializationsForTest(): void;