@pibbl/core 0.0.1

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/features/physics/lib/2d/math.ts"],
+  "sourcesContent": ["import type {\n  PibblPhysicsAabb2D,\n  PibblPhysicsPose2D,\n  PibblPhysicsVector2,\n} from '../../2d-geometry.js';\nimport { copyFiniteVector2, requireFiniteNumber } from '../shared/validation.js';\nimport { DEGREES_TO_RADIANS, GEOMETRY_EPSILON } from './numeric-policy.js';\n\nexport const CURVE_FLATTENING_TOLERANCE = 0.05;\nexport const CURVE_FLATTENING_MAX_DEPTH = 12;\n\nexport interface InternalPose2D {\n  readonly x: number;\n  readonly y: number;\n  readonly rotationRadians: number;\n}\n\nexport const IDENTITY_POSE_2D: InternalPose2D = Object.freeze({\n  x: 0,\n  y: 0,\n  rotationRadians: 0,\n});\n\nexport function copyPose2D(\n  pose: PibblPhysicsPose2D | undefined,\n  path: string,\n): InternalPose2D {\n  if (pose === undefined) {\n    return IDENTITY_POSE_2D;\n  }\n  const position = copyFiniteVector2(pose.position, `${path}.position`);\n  return Object.freeze({\n    x: position[0],\n    y: position[1],\n    rotationRadians:\n      requireFiniteNumber(pose.rotationDegrees, `${path}.rotationDegrees`) *\n      DEGREES_TO_RADIANS,\n  });\n}\n\n/** Returns outer(inner(point)). */\nexport function composePose2D(\n  outer: InternalPose2D,\n  inner: InternalPose2D,\n): InternalPose2D {\n  const cosine = Math.cos(outer.rotationRadians);\n  const sine = Math.sin(outer.rotationRadians);\n  return Object.freeze({\n    x: outer.x + cosine * inner.x - sine * inner.y,\n    y: outer.y + sine * inner.x + cosine * inner.y,\n    rotationRadians: outer.rotationRadians + inner.rotationRadians,\n  });\n}\n\nexport function transformPointInto(\n  output: Float64Array,\n  outputOffset: number,\n  x: number,\n  y: number,\n  pose: InternalPose2D,\n): void {\n  const cosine = Math.cos(pose.rotationRadians);\n  const sine = Math.sin(pose.rotationRadians);\n  output[outputOffset] = pose.x + cosine * x - sine * y;\n  output[outputOffset + 1] = pose.y + sine * x + cosine * y;\n}\n\nexport function cross2D(\n  ax: number,\n  ay: number,\n  bx: number,\n  by: number,\n  cx: number,\n  cy: number,\n): number {\n  return (bx - ax) * (cy - ay) - (by - ay) * (cx - ax);\n}\n\nexport function canonicalizeContour2D(\n  source: readonly PibblPhysicsVector2[],\n  options: Readonly<{ strictlyConvex: boolean; path: string }>,\n): Float64Array {\n  const copied: [number, number][] = source.map((point, index) => {\n    const owned = copyFiniteVector2(point, `${options.path}[${index}]`);\n    return [owned[0], owned[1]];\n  });\n  if (\n    copied.length > 1 &&\n    copied[0]![0] === copied.at(-1)![0] &&\n    copied[0]![1] === copied.at(-1)![1]\n  ) {\n    copied.pop();\n  }\n  if (copied.length < 3) {\n    throw new RangeError(`${options.path} must contain at least three vertices.`);\n  }\n  const cleaned = options.strictlyConvex\n    ? copied\n    : removeCollinearAndAdjacentDuplicates(copied);\n  for (let first = 0; first < cleaned.length; first += 1) {\n    for (let second = first + 1; second < cleaned.length; second += 1) {\n      if (\n        cleaned[first]![0] === cleaned[second]![0] &&\n        cleaned[first]![1] === cleaned[second]![1]\n      ) {\n        throw new RangeError(`${options.path} must not contain duplicate vertices.`);\n      }\n    }\n  }\n  if (cleaned.length < 3) {\n    throw new RangeError(`${options.path} must enclose a nonzero area.`);\n  }\n  if (hasSelfIntersection(cleaned)) {\n    throw new RangeError(`${options.path} must describe a simple polygon.`);\n  }\n\n  let signedTwiceArea = 0;\n  for (let index = 0; index < cleaned.length; index += 1) {\n    const current = cleaned[index]!;\n    const next = cleaned[(index + 1) % cleaned.length]!;\n    signedTwiceArea += current[0] * next[1] - next[0] * current[1];\n  }\n  if (Math.abs(signedTwiceArea) <= GEOMETRY_EPSILON) {\n    throw new RangeError(`${options.path} must enclose a nonzero area.`);\n  }\n  if (signedTwiceArea < 0) {\n    cleaned.reverse();\n  }\n\n  if (options.strictlyConvex) {\n    for (let index = 0; index < cleaned.length; index += 1) {\n      const previous = cleaned[(index + cleaned.length - 1) % cleaned.length]!;\n      const current = cleaned[index]!;\n      const next = cleaned[(index + 1) % cleaned.length]!;\n      if (\n        cross2D(\n          previous[0],\n          previous[1],\n          current[0],\n          current[1],\n          next[0],\n          next[1],\n        ) <= GEOMETRY_EPSILON\n      ) {\n        throw new RangeError(\n          `${options.path} must describe a strictly convex polygon without collinear vertices.`,\n        );\n      }\n    }\n  }\n\n  let start = 0;\n  for (let index = 1; index < cleaned.length; index += 1) {\n    const candidate = cleaned[index]!;\n    const selected = cleaned[start]!;\n    if (\n      candidate[0] < selected[0] ||\n      (candidate[0] === selected[0] && candidate[1] < selected[1])\n    ) {\n      start = index;\n    }\n  }\n  const result = new Float64Array(cleaned.length * 2);\n  for (let index = 0; index < cleaned.length; index += 1) {\n    const point = cleaned[(start + index) % cleaned.length]!;\n    result[index * 2] = point[0];\n    result[index * 2 + 1] = point[1];\n  }\n  return result;\n}\n\nexport function triangulateContour2D(vertices: Float64Array): readonly Float64Array[] {\n  const count = vertices.length / 2;\n  const remaining = Array.from({ length: count }, (_, index) => index);\n  const triangles: Float64Array[] = [];\n  while (remaining.length > 3) {\n    let selectedPosition = -1;\n    let selectedCanonicalIndex = Number.POSITIVE_INFINITY;\n    for (let position = 0; position < remaining.length; position += 1) {\n      const previous = remaining[(position + remaining.length - 1) % remaining.length]!;\n      const current = remaining[position]!;\n      const next = remaining[(position + 1) % remaining.length]!;\n      const turn = cross2D(\n        vertices[previous * 2]!,\n        vertices[previous * 2 + 1]!,\n        vertices[current * 2]!,\n        vertices[current * 2 + 1]!,\n        vertices[next * 2]!,\n        vertices[next * 2 + 1]!,\n      );\n      if (turn <= GEOMETRY_EPSILON) {\n        continue;\n      }\n      let containsVertex = false;\n      for (const candidate of remaining) {\n        if (candidate === previous || candidate === current || candidate === next) {\n          continue;\n        }\n        if (pointInTriangle(vertices, candidate, previous, current, next)) {\n          containsVertex = true;\n          break;\n        }\n      }\n      if (!containsVertex && current < selectedCanonicalIndex) {\n        selectedPosition = position;\n        selectedCanonicalIndex = current;\n      }\n    }\n    if (selectedPosition < 0) {\n      throw new RangeError('contour could not be triangulated deterministically.');\n    }\n    const previous = remaining[(selectedPosition + remaining.length - 1) % remaining.length]!;\n    const current = remaining[selectedPosition]!;\n    const next = remaining[(selectedPosition + 1) % remaining.length]!;\n    triangles.push(copyTriangle(vertices, previous, current, next));\n    remaining.splice(selectedPosition, 1);\n  }\n  triangles.push(copyTriangle(vertices, remaining[0]!, remaining[1]!, remaining[2]!));\n  return Object.freeze(triangles);\n}\n\nexport function polygonMassData2D(vertices: Float64Array): Readonly<{\n  area: number;\n  centroidX: number;\n  centroidY: number;\n  unitInertia: number;\n}> {\n  let twiceArea = 0;\n  let centroidXTimesSixArea = 0;\n  let centroidYTimesSixArea = 0;\n  let inertiaTimesTwelve = 0;\n  for (let offset = 0; offset < vertices.length; offset += 2) {\n    const nextOffset = (offset + 2) % vertices.length;\n    const x1 = vertices[offset]!;\n    const y1 = vertices[offset + 1]!;\n    const x2 = vertices[nextOffset]!;\n    const y2 = vertices[nextOffset + 1]!;\n    const cross = x1 * y2 - x2 * y1;\n    twiceArea += cross;\n    centroidXTimesSixArea += (x1 + x2) * cross;\n    centroidYTimesSixArea += (y1 + y2) * cross;\n    inertiaTimesTwelve +=\n      cross *\n      (x1 * x1 + x1 * x2 + x2 * x2 + y1 * y1 + y1 * y2 + y2 * y2);\n  }\n  const area = twiceArea / 2;\n  const centroidX = centroidXTimesSixArea / (3 * twiceArea);\n  const centroidY = centroidYTimesSixArea / (3 * twiceArea);\n  const inertiaAboutOrigin = inertiaTimesTwelve / 12;\n  return Object.freeze({\n    area,\n    centroidX,\n    centroidY,\n    unitInertia:\n      inertiaAboutOrigin - area * (centroidX * centroidX + centroidY * centroidY),\n  });\n}\n\nexport function freezeBounds2D(\n  minX: number,\n  minY: number,\n  maxX: number,\n  maxY: number,\n): PibblPhysicsAabb2D {\n  return Object.freeze({\n    min: Object.freeze([cleanZero(minX), cleanZero(minY)] as const),\n    max: Object.freeze([cleanZero(maxX), cleanZero(maxY)] as const),\n  });\n}\n\nexport function cleanZero(value: number): number {\n  return Object.is(value, -0) ? 0 : value;\n}\n\nfunction removeCollinearAndAdjacentDuplicates(\n  source: readonly [number, number][],\n): [number, number][] {\n  const points = source.filter((point, index) => {\n    const previous = source[(index + source.length - 1) % source.length]!;\n    return point[0] !== previous[0] || point[1] !== previous[1];\n  });\n  let removed = true;\n  while (removed && points.length >= 3) {\n    removed = false;\n    for (let index = 0; index < points.length; index += 1) {\n      const previous = points[(index + points.length - 1) % points.length]!;\n      const current = points[index]!;\n      const next = points[(index + 1) % points.length]!;\n      if (\n        Math.abs(\n          cross2D(\n            previous[0],\n            previous[1],\n            current[0],\n            current[1],\n            next[0],\n            next[1],\n          ),\n        ) <= GEOMETRY_EPSILON\n      ) {\n        points.splice(index, 1);\n        removed = true;\n        break;\n      }\n    }\n  }\n  return points;\n}\n\nfunction hasSelfIntersection(points: readonly [number, number][]): boolean {\n  for (let first = 0; first < points.length; first += 1) {\n    const firstNext = (first + 1) % points.length;\n    for (let second = first + 1; second < points.length; second += 1) {\n      const secondNext = (second + 1) % points.length;\n      if (\n        first === second ||\n        firstNext === second ||\n        secondNext === first\n      ) {\n        continue;\n      }\n      if (\n        segmentsIntersect(\n          points[first]!,\n          points[firstNext]!,\n          points[second]!,\n          points[secondNext]!,\n        )\n      ) {\n        return true;\n      }\n    }\n  }\n  return false;\n}\n\nfunction segmentsIntersect(\n  firstStart: readonly [number, number],\n  firstEnd: readonly [number, number],\n  secondStart: readonly [number, number],\n  secondEnd: readonly [number, number],\n): boolean {\n  const firstSide = cross2D(\n    firstStart[0],\n    firstStart[1],\n    firstEnd[0],\n    firstEnd[1],\n    secondStart[0],\n    secondStart[1],\n  );\n  const secondSide = cross2D(\n    firstStart[0],\n    firstStart[1],\n    firstEnd[0],\n    firstEnd[1],\n    secondEnd[0],\n    secondEnd[1],\n  );\n  const thirdSide = cross2D(\n    secondStart[0],\n    secondStart[1],\n    secondEnd[0],\n    secondEnd[1],\n    firstStart[0],\n    firstStart[1],\n  );\n  const fourthSide = cross2D(\n    secondStart[0],\n    secondStart[1],\n    secondEnd[0],\n    secondEnd[1],\n    firstEnd[0],\n    firstEnd[1],\n  );\n  return (\n    Math.sign(firstSide) !== Math.sign(secondSide) &&\n    Math.sign(thirdSide) !== Math.sign(fourthSide)\n  );\n}\n\nfunction pointInTriangle(\n  vertices: Float64Array,\n  point: number,\n  first: number,\n  second: number,\n  third: number,\n): boolean {\n  const px = vertices[point * 2]!;\n  const py = vertices[point * 2 + 1]!;\n  const firstCross = cross2D(vertices[first * 2]!, vertices[first * 2 + 1]!, vertices[second * 2]!, vertices[second * 2 + 1]!, px, py);\n  const secondCross = cross2D(vertices[second * 2]!, vertices[second * 2 + 1]!, vertices[third * 2]!, vertices[third * 2 + 1]!, px, py);\n  const thirdCross = cross2D(vertices[third * 2]!, vertices[third * 2 + 1]!, vertices[first * 2]!, vertices[first * 2 + 1]!, px, py);\n  return (\n    firstCross >= -GEOMETRY_EPSILON &&\n    secondCross >= -GEOMETRY_EPSILON &&\n    thirdCross >= -GEOMETRY_EPSILON\n  );\n}\n\nfunction copyTriangle(\n  vertices: Float64Array,\n  first: number,\n  second: number,\n  third: number,\n): Float64Array {\n  return new Float64Array([\n    vertices[first * 2]!, vertices[first * 2 + 1]!,\n    vertices[second * 2]!, vertices[second * 2 + 1]!,\n    vertices[third * 2]!, vertices[third * 2 + 1]!,\n  ]);\n}\n"],
+  "mappings": "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",
+  "names": ["previous", "current", "next"]
+}

package/dist/features/physics/lib/2d/numeric-policy.d.ts

@@ -0,0 +1,24 @@
+export declare const GEOMETRY_EPSILON = 1e-9;
+export declare const CONTACT_SLOP = 0.005;
+export declare const MAX_POSITION_CORRECTION = 0.2;
+export declare const RESTITUTION_VELOCITY_THRESHOLD = 1;
+export declare const SLEEP_LINEAR_SPEED = 0.05;
+export declare const SLEEP_ANGULAR_SPEED_DEGREES = 0.5;
+export declare const SLEEP_DURATION_SECONDS = 0.5;
+export declare const FAT_AABB_MARGIN = 0.1;
+export declare const MAX_GJK_ITERATIONS = 24;
+export declare const MAX_EPA_ITERATIONS = 32;
+export declare const MAX_CCD_IMPACTS_PER_TICK = 4;
+export declare const DEGREES_TO_RADIANS: number;
+export declare const RADIANS_TO_DEGREES: number;
+export declare const DEFAULT_GRAVITY: readonly [0, 0];
+export declare const DEFAULT_FIXED_STEP_MILLISECONDS: number;
+export declare const DEFAULT_MAX_CATCH_UP_STEPS = 4;
+export declare const DEFAULT_INTERPOLATION: "linear";
+export declare const DEFAULT_SLEEPING = true;
+export declare const DEFAULT_VELOCITY_ITERATIONS = 4;
+export declare const DEFAULT_POSITION_ITERATIONS = 1;
+export declare const MIN_SOLVER_ITERATIONS = 1;
+export declare const MAX_SOLVER_ITERATIONS = 32;
+export declare const MIN_CATCH_UP_STEPS = 1;
+export declare const MAX_CATCH_UP_STEPS = 16;

package/dist/features/physics/lib/2d/numeric-policy.js

@@ -0,0 +1,51 @@
+const GEOMETRY_EPSILON = 1e-9;
+const CONTACT_SLOP = 5e-3;
+const MAX_POSITION_CORRECTION = 0.2;
+const RESTITUTION_VELOCITY_THRESHOLD = 1;
+const SLEEP_LINEAR_SPEED = 0.05;
+const SLEEP_ANGULAR_SPEED_DEGREES = 0.5;
+const SLEEP_DURATION_SECONDS = 0.5;
+const FAT_AABB_MARGIN = 0.1;
+const MAX_GJK_ITERATIONS = 24;
+const MAX_EPA_ITERATIONS = 32;
+const MAX_CCD_IMPACTS_PER_TICK = 4;
+const DEGREES_TO_RADIANS = Math.PI / 180;
+const RADIANS_TO_DEGREES = 180 / Math.PI;
+const DEFAULT_GRAVITY = Object.freeze([0, 0]);
+const DEFAULT_FIXED_STEP_MILLISECONDS = 1e3 / 60;
+const DEFAULT_MAX_CATCH_UP_STEPS = 4;
+const DEFAULT_INTERPOLATION = "linear";
+const DEFAULT_SLEEPING = true;
+const DEFAULT_VELOCITY_ITERATIONS = 4;
+const DEFAULT_POSITION_ITERATIONS = 1;
+const MIN_SOLVER_ITERATIONS = 1;
+const MAX_SOLVER_ITERATIONS = 32;
+const MIN_CATCH_UP_STEPS = 1;
+const MAX_CATCH_UP_STEPS = 16;
+export {
+  CONTACT_SLOP,
+  DEFAULT_FIXED_STEP_MILLISECONDS,
+  DEFAULT_GRAVITY,
+  DEFAULT_INTERPOLATION,
+  DEFAULT_MAX_CATCH_UP_STEPS,
+  DEFAULT_POSITION_ITERATIONS,
+  DEFAULT_SLEEPING,
+  DEFAULT_VELOCITY_ITERATIONS,
+  DEGREES_TO_RADIANS,
+  FAT_AABB_MARGIN,
+  GEOMETRY_EPSILON,
+  MAX_CATCH_UP_STEPS,
+  MAX_CCD_IMPACTS_PER_TICK,
+  MAX_EPA_ITERATIONS,
+  MAX_GJK_ITERATIONS,
+  MAX_POSITION_CORRECTION,
+  MAX_SOLVER_ITERATIONS,
+  MIN_CATCH_UP_STEPS,
+  MIN_SOLVER_ITERATIONS,
+  RADIANS_TO_DEGREES,
+  RESTITUTION_VELOCITY_THRESHOLD,
+  SLEEP_ANGULAR_SPEED_DEGREES,
+  SLEEP_DURATION_SECONDS,
+  SLEEP_LINEAR_SPEED
+};
+//# sourceMappingURL=numeric-policy.js.map

package/dist/features/physics/lib/2d/numeric-policy.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/features/physics/lib/2d/numeric-policy.ts"],
+  "sourcesContent": ["export const GEOMETRY_EPSILON = 1e-9;\nexport const CONTACT_SLOP = 0.005;\nexport const MAX_POSITION_CORRECTION = 0.2;\nexport const RESTITUTION_VELOCITY_THRESHOLD = 1;\nexport const SLEEP_LINEAR_SPEED = 0.05;\nexport const SLEEP_ANGULAR_SPEED_DEGREES = 0.5;\nexport const SLEEP_DURATION_SECONDS = 0.5;\nexport const FAT_AABB_MARGIN = 0.1;\nexport const MAX_GJK_ITERATIONS = 24;\nexport const MAX_EPA_ITERATIONS = 32;\nexport const MAX_CCD_IMPACTS_PER_TICK = 4;\n\nexport const DEGREES_TO_RADIANS = Math.PI / 180;\nexport const RADIANS_TO_DEGREES = 180 / Math.PI;\n\nexport const DEFAULT_GRAVITY = Object.freeze([0, 0] as const);\nexport const DEFAULT_FIXED_STEP_MILLISECONDS = 1000 / 60;\nexport const DEFAULT_MAX_CATCH_UP_STEPS = 4;\nexport const DEFAULT_INTERPOLATION = \"linear\" as const;\nexport const DEFAULT_SLEEPING = true;\nexport const DEFAULT_VELOCITY_ITERATIONS = 4;\nexport const DEFAULT_POSITION_ITERATIONS = 1;\n\nexport const MIN_SOLVER_ITERATIONS = 1;\nexport const MAX_SOLVER_ITERATIONS = 32;\nexport const MIN_CATCH_UP_STEPS = 1;\nexport const MAX_CATCH_UP_STEPS = 16;\n"],
+  "mappings": "AAAO,MAAM,mBAAmB;AACzB,MAAM,eAAe;AACrB,MAAM,0BAA0B;AAChC,MAAM,iCAAiC;AACvC,MAAM,qBAAqB;AAC3B,MAAM,8BAA8B;AACpC,MAAM,yBAAyB;AAC/B,MAAM,kBAAkB;AACxB,MAAM,qBAAqB;AAC3B,MAAM,qBAAqB;AAC3B,MAAM,2BAA2B;AAEjC,MAAM,qBAAqB,KAAK,KAAK;AACrC,MAAM,qBAAqB,MAAM,KAAK;AAEtC,MAAM,kBAAkB,OAAO,OAAO,CAAC,GAAG,CAAC,CAAU;AACrD,MAAM,kCAAkC,MAAO;AAC/C,MAAM,6BAA6B;AACnC,MAAM,wBAAwB;AAC9B,MAAM,mBAAmB;AACzB,MAAM,8BAA8B;AACpC,MAAM,8BAA8B;AAEpC,MAAM,wBAAwB;AAC9B,MAAM,wBAAwB;AAC9B,MAAM,qBAAqB;AAC3B,MAAM,qBAAqB;",
+  "names": []
+}

package/dist/features/physics/lib/2d/runtime/body-handle.d.ts

@@ -0,0 +1,148 @@
+import { type PibblInternalSignalBatch, type PibblInternalSimulationOwner } from "@pibbl/core/internal";
+import type { PibblPhysicsPose2D, PibblPhysicsVector2 } from "../../../2d-geometry.js";
+import type { PibblPhysicsBodyHandle2D } from "../types.js";
+import type { PhysicsWorld2DController } from "./controller.js";
+export type PhysicsBodyHandleField2D = "position" | "rotationDegrees" | "linearVelocity" | "angularVelocityDegreesPerSecond" | "sleeping" | "enabled" | "generation";
+export interface PhysicsBodyHandleBinding2D {
+    readonly controller: PhysicsWorld2DController;
+    readonly bodyId: number;
+    readonly bindingGeneration: number;
+}
+interface BodyFieldValue2D {
+    readonly position: PibblPhysicsVector2;
+    readonly rotationDegrees: number;
+    readonly linearVelocity: PibblPhysicsVector2;
+    readonly angularVelocityDegreesPerSecond: number;
+    readonly sleeping: boolean;
+    readonly enabled: boolean;
+    readonly generation: number;
+}
+export interface PhysicsBodyHandleValues2D extends BodyFieldValue2D {
+}
+/**
+ * Returns one stable, component-owned 2D body endpoint for this hook slot.
+ *
+ * @returns A stable body handle that can be attached to a physics body. See
+ * {@link PibblPhysicsBodyHandle2D} .
+ *
+ * @see {@link PibblPhysicsBodyHandle2D}
+ */
+export declare function pibblPhysicsBody2D(): PibblPhysicsBodyHandle2D;
+/**
+ * Queues a force on a body, optionally at a world point and with wake-up control.
+ *
+ * @param body - Body receiving the force. See {@link PibblPhysicsBodyHandle2D}.
+ * @param force - Force vector in the world's public coordinate system. See
+ * {@link PibblPhysicsVector2} .
+ * @param options - Optional application point and wake policy. See {@link PibblPhysicsVector2}.
+ *
+ * @see {@link PibblPhysicsBodyHandle2D}
+ * @see {@link PibblPhysicsVector2}
+ */
+export declare function applyForce2D(body: PibblPhysicsBodyHandle2D, force: PibblPhysicsVector2, options?: Readonly<{
+    at?: PibblPhysicsVector2;
+    wake?: boolean;
+}>): void;
+/**
+ * Queues an instantaneous momentum change, optionally at a world point and with wake-up control.
+ *
+ * @param body - Body receiving the impulse. See {@link PibblPhysicsBodyHandle2D}.
+ * @param impulse - Impulse vector in the world's public coordinate system. See
+ * {@link PibblPhysicsVector2} .
+ * @param options - Optional application point and wake policy. See {@link PibblPhysicsVector2}.
+ *
+ * @see {@link PibblPhysicsBodyHandle2D}
+ * @see {@link PibblPhysicsVector2}
+ */
+export declare function applyImpulse2D(body: PibblPhysicsBodyHandle2D, impulse: PibblPhysicsVector2, options?: Readonly<{
+    at?: PibblPhysicsVector2;
+    wake?: boolean;
+}>): void;
+/**
+ * Queues torque on a dynamic body through the shared scheduler.
+ *
+ * @param body - Body receiving the torque. See {@link PibblPhysicsBodyHandle2D}.
+ * @param torque - Torque to apply in the world's public units.
+ *
+ * @see {@link PibblPhysicsBodyHandle2D}
+ */
+export declare function applyTorque2D(body: PibblPhysicsBodyHandle2D, torque: number): void;
+/**
+ * Queues a body's linear velocity in physics units per second.
+ *
+ * @param body - Body whose linear velocity changes. See {@link PibblPhysicsBodyHandle2D}.
+ * @param velocity - Velocity vector in public distance units per second. See
+ * {@link PibblPhysicsVector2} .
+ *
+ * @see {@link PibblPhysicsBodyHandle2D}
+ * @see {@link PibblPhysicsVector2}
+ */
+export declare function setLinearVelocity2D(body: PibblPhysicsBodyHandle2D, velocity: PibblPhysicsVector2): void;
+/**
+ * Queues a body's angular velocity in degrees per second.
+ *
+ * @param body - Body whose angular velocity changes. See {@link PibblPhysicsBodyHandle2D}.
+ * @param degreesPerSecond - Angular speed in degrees per second.
+ *
+ * @see {@link PibblPhysicsBodyHandle2D}
+ */
+export declare function setAngularVelocity2D(body: PibblPhysicsBodyHandle2D, degreesPerSecond: number): void;
+/**
+ * Queues an immediate pose change for a body at the next admitted simulation command phase.
+ *
+ * @param body - Body to reposition. See {@link PibblPhysicsBodyHandle2D}.
+ * @param pose - Destination position and rotation in public coordinates. See
+ * {@link PibblPhysicsPose2D} .
+ *
+ * @see {@link PibblPhysicsBodyHandle2D}
+ * @see {@link PibblPhysicsPose2D}
+ */
+export declare function teleportBody2D(body: PibblPhysicsBodyHandle2D, pose: PibblPhysicsPose2D): void;
+/**
+ * Queues a request to wake a sleeping body.
+ *
+ * @param body - Body to wake. See {@link PibblPhysicsBodyHandle2D}.
+ *
+ * @see {@link PibblPhysicsBodyHandle2D}
+ */
+export declare function wakeBody2D(body: PibblPhysicsBodyHandle2D): void;
+/**
+ * Queues a request to put a body to sleep.
+ *
+ * @param body - Body to put to sleep. See {@link PibblPhysicsBodyHandle2D}.
+ *
+ * @see {@link PibblPhysicsBodyHandle2D}
+ */
+export declare function sleepBody2D(body: PibblPhysicsBodyHandle2D): void;
+/**
+ * Queues re-enabling a body with the requested velocity-preservation policy.
+ *
+ * @param body - Body to re-enable. See {@link PibblPhysicsBodyHandle2D}.
+ * @param options - Whether to zero or preserve velocity when enabling.
+ *
+ * @see {@link PibblPhysicsBodyHandle2D}
+ */
+export declare function enableBody2D(body: PibblPhysicsBodyHandle2D, options?: Readonly<{
+    velocity?: "zero" | "preserve";
+}>): void;
+/**
+ * Queues removal of a body's active participation in the simulation.
+ *
+ * @param body - Body to disable. See {@link PibblPhysicsBodyHandle2D}.
+ *
+ * @see {@link PibblPhysicsBodyHandle2D}
+ */
+export declare function disableBody2D(body: PibblPhysicsBodyHandle2D): void;
+export declare function createPhysicsBodyHandle2D(owner: PibblInternalSimulationOwner): PibblPhysicsBodyHandle2D;
+export declare function bindPhysicsBodyHandle2D(handle: PibblPhysicsBodyHandle2D, controller: PhysicsWorld2DController, bodyId: number): number;
+export declare function unbindPhysicsBodyHandle2D(handle: PibblPhysicsBodyHandle2D, controller: PhysicsWorld2DController, bodyId: number, bindingGeneration: number): void;
+export declare function physicsBodyHandleBinding2D(handle: PibblPhysicsBodyHandle2D): PhysicsBodyHandleBinding2D | undefined;
+export declare function isPhysicsBodyHandle2D(value: unknown): value is PibblPhysicsBodyHandle2D;
+export declare function physicsBodyHandleOwner2D(handle: PibblPhysicsBodyHandle2D): PibblInternalSimulationOwner;
+export declare function stagePhysicsBodyHandle2D(batch: PibblInternalSignalBatch, handle: PibblPhysicsBodyHandle2D, values: PhysicsBodyHandleValues2D, writer: object): void;
+export declare function snapshotPhysicsBodyHandle2DForTest(handle: PibblPhysicsBodyHandle2D): Readonly<{
+    readonly bound: boolean;
+    readonly bindingGeneration: number;
+    readonly materializedFields: readonly PhysicsBodyHandleField2D[];
+}>;
+export {};

package/dist/features/physics/lib/2d/runtime/body-handle.js

@@ -0,0 +1,305 @@
+import { signal } from "@pibbl/core";
+import {
+  pibblInternalCurrentSimulationOwner,
+  pibblInternalQueueSimulationBegin,
+  useInternalHookSlot
+} from "@pibbl/core/internal";
+import {
+  copyFiniteVector2,
+  requireFiniteNumber
+} from "../../shared/validation.js";
+const states = /* @__PURE__ */ new WeakMap();
+const externalBindings = /* @__PURE__ */ new WeakMap();
+function pibblPhysicsBody2D() {
+  const owner = pibblInternalCurrentSimulationOwner();
+  const slot = useInternalHookSlot("physicsBody2DHandle", (teardowns) => {
+    const handle = createPhysicsBodyHandle2D(owner);
+    teardowns.add(() => disposePhysicsBodyHandle2D(handle));
+    return handle;
+  });
+  return slot.value;
+}
+function applyForce2D(body, force, options = {}) {
+  const copied = copyFiniteVector2(force, "force");
+  const point = options.at === void 0 ? void 0 : copyFiniteVector2(options.at, "options.at");
+  queueBodyCommand(body, {
+    kind: "apply-force",
+    bodyId: 0,
+    forceX: copied[0],
+    forceY: copied[1],
+    pointX: point?.[0],
+    pointY: point?.[1],
+    wake: requireBoolean(options.wake ?? true, "options.wake")
+  });
+}
+function applyImpulse2D(body, impulse, options = {}) {
+  const copied = copyFiniteVector2(impulse, "impulse");
+  const point = options.at === void 0 ? void 0 : copyFiniteVector2(options.at, "options.at");
+  queueBodyCommand(body, {
+    kind: "apply-impulse",
+    bodyId: 0,
+    impulseX: copied[0],
+    impulseY: copied[1],
+    pointX: point?.[0],
+    pointY: point?.[1],
+    wake: requireBoolean(options.wake ?? true, "options.wake")
+  });
+}
+function applyTorque2D(body, torque) {
+  queueBodyCommand(body, {
+    kind: "apply-torque",
+    bodyId: 0,
+    torque: requireFiniteNumber(torque, "torque")
+  });
+}
+function setLinearVelocity2D(body, velocity) {
+  const copied = copyFiniteVector2(velocity, "velocity");
+  queueBodyCommand(body, {
+    kind: "set-linear-velocity",
+    bodyId: 0,
+    linearVelocityX: copied[0],
+    linearVelocityY: copied[1]
+  });
+}
+function setAngularVelocity2D(body, degreesPerSecond) {
+  queueBodyCommand(body, {
+    kind: "set-angular-velocity",
+    bodyId: 0,
+    angularVelocityDegrees: requireFiniteNumber(
+      degreesPerSecond,
+      "degreesPerSecond"
+    )
+  });
+}
+function teleportBody2D(body, pose) {
+  queueBodyCommand(body, {
+    kind: "set-pose",
+    bodyId: 0,
+    pose: Object.freeze({
+      position: copyFiniteVector2(pose.position, "pose.position"),
+      rotationDegrees: requireFiniteNumber(
+        pose.rotationDegrees,
+        "pose.rotationDegrees"
+      )
+    })
+  });
+}
+function wakeBody2D(body) {
+  queueBodyCommand(body, { kind: "wake", bodyId: 0 });
+}
+function sleepBody2D(body) {
+  queueBodyCommand(body, { kind: "sleep", bodyId: 0 });
+}
+function enableBody2D(body, options = {}) {
+  const velocity = options.velocity ?? "zero";
+  if (velocity !== "zero" && velocity !== "preserve") {
+    throw new TypeError('options.velocity must be "zero" or "preserve".');
+  }
+  queueBodyCommand(body, { kind: "enable", bodyId: 0, velocity });
+}
+function disableBody2D(body) {
+  queueBodyCommand(body, { kind: "disable", bodyId: 0 });
+}
+function createPhysicsBodyHandle2D(owner) {
+  const target = {};
+  const state = {
+    owner,
+    signals: {},
+    binding: void 0,
+    nextBindingGeneration: 0,
+    active: true
+  };
+  for (const field of BODY_FIELDS_2D) {
+    Object.defineProperty(target, field, {
+      enumerable: true,
+      get: () => materializeSignal(state, field).asReadonly()
+    });
+  }
+  const handle = Object.freeze(target);
+  states.set(handle, state);
+  return handle;
+}
+function bindPhysicsBodyHandle2D(handle, controller, bodyId) {
+  const state = states.get(handle);
+  if (state === void 0) {
+    if (typeof handle !== "object" || handle === null) {
+      throw new TypeError("Expected a live Pibbl physics 2D body handle.");
+    }
+    let external = externalBindings.get(handle);
+    if (external?.binding !== void 0) {
+      if (external.binding.controller === controller && external.binding.bodyId === bodyId) {
+        return external.binding.bindingGeneration;
+      }
+      throw new Error(
+        "A Pibbl physics 2D body handle may bind to at most one live body."
+      );
+    }
+    external ??= { binding: void 0, nextBindingGeneration: 0 };
+    const bindingGeneration2 = ++external.nextBindingGeneration;
+    external.binding = Object.freeze({ controller, bodyId, bindingGeneration: bindingGeneration2 });
+    externalBindings.set(handle, external);
+    return bindingGeneration2;
+  }
+  const current = state.binding;
+  if (current !== void 0) {
+    if (current.controller === controller && current.bodyId === bodyId) {
+      return current.bindingGeneration;
+    }
+    throw new Error(
+      "A Pibbl physics 2D body handle may bind to at most one live body."
+    );
+  }
+  const bindingGeneration = ++state.nextBindingGeneration;
+  state.binding = Object.freeze({ controller, bodyId, bindingGeneration });
+  return bindingGeneration;
+}
+function unbindPhysicsBodyHandle2D(handle, controller, bodyId, bindingGeneration) {
+  const state = states.get(handle);
+  if (state === void 0) {
+    const external = externalBindings.get(handle);
+    const binding2 = external?.binding;
+    if (binding2?.controller === controller && binding2.bodyId === bodyId && binding2.bindingGeneration === bindingGeneration) {
+      external.binding = void 0;
+    }
+    return;
+  }
+  const binding = state?.binding;
+  if (binding?.controller === controller && binding.bodyId === bodyId && binding.bindingGeneration === bindingGeneration) {
+    state.binding = void 0;
+  }
+}
+function physicsBodyHandleBinding2D(handle) {
+  return states.get(handle)?.binding ?? externalBindings.get(handle)?.binding;
+}
+function isPhysicsBodyHandle2D(value) {
+  return typeof value === "object" && value !== null && (states.has(value) || externalBindings.has(value));
+}
+function physicsBodyHandleOwner2D(handle) {
+  return requireState(handle).owner;
+}
+function stagePhysicsBodyHandle2D(batch, handle, values, writer) {
+  const state = states.get(handle);
+  if (state === void 0) {
+    stageLegacyHandle(batch, handle, values, writer);
+    return;
+  }
+  for (const field of BODY_FIELDS_2D) {
+    const target = state.signals[field];
+    if (target !== void 0) batch.stage(target, values[field], writer);
+  }
+}
+function snapshotPhysicsBodyHandle2DForTest(handle) {
+  const state = requireState(handle);
+  return Object.freeze({
+    bound: state.binding !== void 0,
+    bindingGeneration: state.binding?.bindingGeneration ?? 0,
+    materializedFields: Object.freeze(
+      BODY_FIELDS_2D.filter((field) => state.signals[field] !== void 0)
+    )
+  });
+}
+function disposePhysicsBodyHandle2D(handle) {
+  const state = states.get(handle);
+  if (state === void 0 || !state.active) return;
+  state.active = false;
+  state.binding = void 0;
+}
+function queueBodyCommand(handle, command) {
+  const state = requireState(handle);
+  const captured = state.binding;
+  pibblInternalQueueSimulationBegin(state.owner, () => {
+    const current = state.binding;
+    if (captured === void 0 || current === void 0 || current.bindingGeneration !== captured.bindingGeneration || current.controller !== captured.controller || current.bodyId !== captured.bodyId) {
+      traceStaleCommand(command.kind, captured?.bindingGeneration ?? 0);
+      return;
+    }
+    if (!current.controller.acceptBodyHandleCommand(
+      handle,
+      current.bindingGeneration,
+      Object.freeze({
+        ...command,
+        bodyId: current.bodyId
+      })
+    )) {
+      traceStaleCommand(command.kind, current.bindingGeneration);
+    }
+  });
+}
+function traceStaleCommand(kind, generation) {
+  const runtime = globalThis;
+  if (runtime.process?.env?.NODE_ENV === "production") return;
+  console.warn(
+    `[Pibbl physics] Ignored stale ${kind} command for body handle generation ${String(generation)}.`
+  );
+}
+function requireBoolean(value, path) {
+  if (typeof value !== "boolean")
+    throw new TypeError(`${path} must be boolean.`);
+  return value;
+}
+function requireState(handle) {
+  const state = typeof handle === "object" && handle !== null ? states.get(handle) : void 0;
+  if (state === void 0 || !state.active) {
+    throw new TypeError("Expected a live Pibbl physics 2D body handle.");
+  }
+  return state;
+}
+function materializeSignal(state, field) {
+  let target = state.signals[field];
+  if (target === void 0) {
+    const binding = state.binding;
+    const current = binding === void 0 ? void 0 : binding.controller.bodyHandleValues(binding.bodyId);
+    target = signal(current?.[field] ?? INITIAL_VALUES_2D[field], {
+      debugName: `PhysicsBody2D.${field}`
+    });
+    state.signals[field] = target;
+  }
+  return target;
+}
+function stageLegacyHandle(batch, handle, values, writer) {
+  for (const field of BODY_FIELDS_2D) {
+    const target = handle[field];
+    batch.stage(target, values[field], writer);
+  }
+}
+const ZERO_VECTOR_2D = Object.freeze([0, 0]);
+const INITIAL_VALUES_2D = Object.freeze({
+  position: ZERO_VECTOR_2D,
+  rotationDegrees: 0,
+  linearVelocity: ZERO_VECTOR_2D,
+  angularVelocityDegreesPerSecond: 0,
+  sleeping: false,
+  enabled: false,
+  generation: 0
+});
+const BODY_FIELDS_2D = Object.freeze([
+  "position",
+  "rotationDegrees",
+  "linearVelocity",
+  "angularVelocityDegreesPerSecond",
+  "sleeping",
+  "enabled",
+  "generation"
+]);
+export {
+  applyForce2D,
+  applyImpulse2D,
+  applyTorque2D,
+  bindPhysicsBodyHandle2D,
+  createPhysicsBodyHandle2D,
+  disableBody2D,
+  enableBody2D,
+  isPhysicsBodyHandle2D,
+  physicsBodyHandleBinding2D,
+  physicsBodyHandleOwner2D,
+  pibblPhysicsBody2D,
+  setAngularVelocity2D,
+  setLinearVelocity2D,
+  sleepBody2D,
+  snapshotPhysicsBodyHandle2DForTest,
+  stagePhysicsBodyHandle2D,
+  teleportBody2D,
+  unbindPhysicsBodyHandle2D,
+  wakeBody2D
+};
+//# sourceMappingURL=body-handle.js.map

package/dist/features/physics/lib/2d/runtime/body-handle.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../src/features/physics/lib/2d/runtime/body-handle.ts"],
+  "sourcesContent": ["import { signal, type WritableSignal } from \"@pibbl/core\";\nimport {\n  pibblInternalCurrentSimulationOwner,\n  pibblInternalQueueSimulationBegin,\n  useInternalHookSlot,\n  type PibblInternalSignalBatch,\n  type PibblInternalSimulationOwner,\n} from \"@pibbl/core/internal\";\nimport type {\n  PibblPhysicsPose2D,\n  PibblPhysicsVector2,\n} from \"../../../2d-geometry.js\";\nimport type { PibblPhysicsBodyHandle2D } from \"../types.js\";\nimport type { PhysicsBodyCommand2D } from \"../world/world.js\";\nimport {\n  copyFiniteVector2,\n  requireFiniteNumber,\n} from \"../../shared/validation.js\";\nimport type { PhysicsWorld2DController } from \"./controller.js\";\n\nexport type PhysicsBodyHandleField2D =\n  | \"position\"\n  | \"rotationDegrees\"\n  | \"linearVelocity\"\n  | \"angularVelocityDegreesPerSecond\"\n  | \"sleeping\"\n  | \"enabled\"\n  | \"generation\";\n\nexport interface PhysicsBodyHandleBinding2D {\n  readonly controller: PhysicsWorld2DController;\n  readonly bodyId: number;\n  readonly bindingGeneration: number;\n}\n\ninterface PhysicsBodyHandleState2D {\n  readonly owner: PibblInternalSimulationOwner;\n  readonly signals: Partial<{\n    [Field in PhysicsBodyHandleField2D]: WritableSignal<\n      BodyFieldValue2D[Field]\n    >;\n  }>;\n  binding: PhysicsBodyHandleBinding2D | undefined;\n  nextBindingGeneration: number;\n  active: boolean;\n}\n\ninterface BodyFieldValue2D {\n  readonly position: PibblPhysicsVector2;\n  readonly rotationDegrees: number;\n  readonly linearVelocity: PibblPhysicsVector2;\n  readonly angularVelocityDegreesPerSecond: number;\n  readonly sleeping: boolean;\n  readonly enabled: boolean;\n  readonly generation: number;\n}\n\nexport interface PhysicsBodyHandleValues2D extends BodyFieldValue2D {}\n\nconst states = new WeakMap<object, PhysicsBodyHandleState2D>();\nconst externalBindings = new WeakMap<\n  object,\n  {\n    binding: PhysicsBodyHandleBinding2D | undefined;\n    nextBindingGeneration: number;\n  }\n>();\n\n/**\n * Returns one stable, component-owned 2D body endpoint for this hook slot.\n *\n * @returns A stable body handle that can be attached to a physics body. See\n * {@link PibblPhysicsBodyHandle2D} .\n *\n * @see {@link PibblPhysicsBodyHandle2D}\n */\nexport function pibblPhysicsBody2D(): PibblPhysicsBodyHandle2D {\n  const owner = pibblInternalCurrentSimulationOwner();\n  const slot = useInternalHookSlot(\"physicsBody2DHandle\", (teardowns) => {\n    const handle = createPhysicsBodyHandle2D(owner);\n    teardowns.add(() => disposePhysicsBodyHandle2D(handle));\n    return handle;\n  });\n  return slot.value;\n}\n\n/**\n * Queues a force on a body, optionally at a world point and with wake-up control.\n *\n * @param body - Body receiving the force. See {@link PibblPhysicsBodyHandle2D}.\n * @param force - Force vector in the world's public coordinate system. See\n * {@link PibblPhysicsVector2} .\n * @param options - Optional application point and wake policy. See {@link PibblPhysicsVector2}.\n *\n * @see {@link PibblPhysicsBodyHandle2D}\n * @see {@link PibblPhysicsVector2}\n */\nexport function applyForce2D(\n  body: PibblPhysicsBodyHandle2D,\n  force: PibblPhysicsVector2,\n  options: Readonly<{ at?: PibblPhysicsVector2; wake?: boolean }> = {},\n): void {\n  const copied = copyFiniteVector2(force, \"force\");\n  const point =\n    options.at === undefined\n      ? undefined\n      : copyFiniteVector2(options.at, \"options.at\");\n  queueBodyCommand(body, {\n    kind: \"apply-force\",\n    bodyId: 0,\n    forceX: copied[0],\n    forceY: copied[1],\n    pointX: point?.[0],\n    pointY: point?.[1],\n    wake: requireBoolean(options.wake ?? true, \"options.wake\"),\n  });\n}\n\n/**\n * Queues an instantaneous momentum change, optionally at a world point and with wake-up control.\n *\n * @param body - Body receiving the impulse. See {@link PibblPhysicsBodyHandle2D}.\n * @param impulse - Impulse vector in the world's public coordinate system. See\n * {@link PibblPhysicsVector2} .\n * @param options - Optional application point and wake policy. See {@link PibblPhysicsVector2}.\n *\n * @see {@link PibblPhysicsBodyHandle2D}\n * @see {@link PibblPhysicsVector2}\n */\nexport function applyImpulse2D(\n  body: PibblPhysicsBodyHandle2D,\n  impulse: PibblPhysicsVector2,\n  options: Readonly<{ at?: PibblPhysicsVector2; wake?: boolean }> = {},\n): void {\n  const copied = copyFiniteVector2(impulse, \"impulse\");\n  const point =\n    options.at === undefined\n      ? undefined\n      : copyFiniteVector2(options.at, \"options.at\");\n  queueBodyCommand(body, {\n    kind: \"apply-impulse\",\n    bodyId: 0,\n    impulseX: copied[0],\n    impulseY: copied[1],\n    pointX: point?.[0],\n    pointY: point?.[1],\n    wake: requireBoolean(options.wake ?? true, \"options.wake\"),\n  });\n}\n\n/**\n * Queues torque on a dynamic body through the shared scheduler.\n *\n * @param body - Body receiving the torque. See {@link PibblPhysicsBodyHandle2D}.\n * @param torque - Torque to apply in the world's public units.\n *\n * @see {@link PibblPhysicsBodyHandle2D}\n */\nexport function applyTorque2D(\n  body: PibblPhysicsBodyHandle2D,\n  torque: number,\n): void {\n  queueBodyCommand(body, {\n    kind: \"apply-torque\",\n    bodyId: 0,\n    torque: requireFiniteNumber(torque, \"torque\"),\n  });\n}\n\n/**\n * Queues a body's linear velocity in physics units per second.\n *\n * @param body - Body whose linear velocity changes. See {@link PibblPhysicsBodyHandle2D}.\n * @param velocity - Velocity vector in public distance units per second. See\n * {@link PibblPhysicsVector2} .\n *\n * @see {@link PibblPhysicsBodyHandle2D}\n * @see {@link PibblPhysicsVector2}\n */\nexport function setLinearVelocity2D(\n  body: PibblPhysicsBodyHandle2D,\n  velocity: PibblPhysicsVector2,\n): void {\n  const copied = copyFiniteVector2(velocity, \"velocity\");\n  queueBodyCommand(body, {\n    kind: \"set-linear-velocity\",\n    bodyId: 0,\n    linearVelocityX: copied[0],\n    linearVelocityY: copied[1],\n  });\n}\n\n/**\n * Queues a body's angular velocity in degrees per second.\n *\n * @param body - Body whose angular velocity changes. See {@link PibblPhysicsBodyHandle2D}.\n * @param degreesPerSecond - Angular speed in degrees per second.\n *\n * @see {@link PibblPhysicsBodyHandle2D}\n */\nexport function setAngularVelocity2D(\n  body: PibblPhysicsBodyHandle2D,\n  degreesPerSecond: number,\n): void {\n  queueBodyCommand(body, {\n    kind: \"set-angular-velocity\",\n    bodyId: 0,\n    angularVelocityDegrees: requireFiniteNumber(\n      degreesPerSecond,\n      \"degreesPerSecond\",\n    ),\n  });\n}\n\n/**\n * Queues an immediate pose change for a body at the next admitted simulation command phase.\n *\n * @param body - Body to reposition. See {@link PibblPhysicsBodyHandle2D}.\n * @param pose - Destination position and rotation in public coordinates. See\n * {@link PibblPhysicsPose2D} .\n *\n * @see {@link PibblPhysicsBodyHandle2D}\n * @see {@link PibblPhysicsPose2D}\n */\nexport function teleportBody2D(\n  body: PibblPhysicsBodyHandle2D,\n  pose: PibblPhysicsPose2D,\n): void {\n  queueBodyCommand(body, {\n    kind: \"set-pose\",\n    bodyId: 0,\n    pose: Object.freeze({\n      position: copyFiniteVector2(pose.position, \"pose.position\"),\n      rotationDegrees: requireFiniteNumber(\n        pose.rotationDegrees,\n        \"pose.rotationDegrees\",\n      ),\n    }),\n  });\n}\n\n/**\n * Queues a request to wake a sleeping body.\n *\n * @param body - Body to wake. See {@link PibblPhysicsBodyHandle2D}.\n *\n * @see {@link PibblPhysicsBodyHandle2D}\n */\nexport function wakeBody2D(body: PibblPhysicsBodyHandle2D): void {\n  queueBodyCommand(body, { kind: \"wake\", bodyId: 0 });\n}\n\n/**\n * Queues a request to put a body to sleep.\n *\n * @param body - Body to put to sleep. See {@link PibblPhysicsBodyHandle2D}.\n *\n * @see {@link PibblPhysicsBodyHandle2D}\n */\nexport function sleepBody2D(body: PibblPhysicsBodyHandle2D): void {\n  queueBodyCommand(body, { kind: \"sleep\", bodyId: 0 });\n}\n\n/**\n * Queues re-enabling a body with the requested velocity-preservation policy.\n *\n * @param body - Body to re-enable. See {@link PibblPhysicsBodyHandle2D}.\n * @param options - Whether to zero or preserve velocity when enabling.\n *\n * @see {@link PibblPhysicsBodyHandle2D}\n */\nexport function enableBody2D(\n  body: PibblPhysicsBodyHandle2D,\n  options: Readonly<{ velocity?: \"zero\" | \"preserve\" }> = {},\n): void {\n  const velocity = options.velocity ?? \"zero\";\n  if (velocity !== \"zero\" && velocity !== \"preserve\") {\n    throw new TypeError('options.velocity must be \"zero\" or \"preserve\".');\n  }\n  queueBodyCommand(body, { kind: \"enable\", bodyId: 0, velocity });\n}\n\n/**\n * Queues removal of a body's active participation in the simulation.\n *\n * @param body - Body to disable. See {@link PibblPhysicsBodyHandle2D}.\n *\n * @see {@link PibblPhysicsBodyHandle2D}\n */\nexport function disableBody2D(body: PibblPhysicsBodyHandle2D): void {\n  queueBodyCommand(body, { kind: \"disable\", bodyId: 0 });\n}\n\nexport function createPhysicsBodyHandle2D(\n  owner: PibblInternalSimulationOwner,\n): PibblPhysicsBodyHandle2D {\n  const target = {} as Record<PropertyKey, unknown>;\n  const state: PhysicsBodyHandleState2D = {\n    owner,\n    signals: {},\n    binding: undefined,\n    nextBindingGeneration: 0,\n    active: true,\n  };\n  for (const field of BODY_FIELDS_2D) {\n    Object.defineProperty(target, field, {\n      enumerable: true,\n      get: () => materializeSignal(state, field).asReadonly(),\n    });\n  }\n  const handle = Object.freeze(target) as unknown as PibblPhysicsBodyHandle2D;\n  states.set(handle, state);\n  return handle;\n}\n\nexport function bindPhysicsBodyHandle2D(\n  handle: PibblPhysicsBodyHandle2D,\n  controller: PhysicsWorld2DController,\n  bodyId: number,\n): number {\n  const state = states.get(handle as object);\n  if (state === undefined) {\n    if (typeof handle !== \"object\" || handle === null) {\n      throw new TypeError(\"Expected a live Pibbl physics 2D body handle.\");\n    }\n    let external = externalBindings.get(handle as object);\n    if (external?.binding !== undefined) {\n      if (\n        external.binding.controller === controller &&\n        external.binding.bodyId === bodyId\n      ) {\n        return external.binding.bindingGeneration;\n      }\n      throw new Error(\n        \"A Pibbl physics 2D body handle may bind to at most one live body.\",\n      );\n    }\n    external ??= { binding: undefined, nextBindingGeneration: 0 };\n    const bindingGeneration = ++external.nextBindingGeneration;\n    external.binding = Object.freeze({ controller, bodyId, bindingGeneration });\n    externalBindings.set(handle as object, external);\n    return bindingGeneration;\n  }\n  const current = state.binding;\n  if (current !== undefined) {\n    if (current.controller === controller && current.bodyId === bodyId) {\n      return current.bindingGeneration;\n    }\n    throw new Error(\n      \"A Pibbl physics 2D body handle may bind to at most one live body.\",\n    );\n  }\n  const bindingGeneration = ++state.nextBindingGeneration;\n  state.binding = Object.freeze({ controller, bodyId, bindingGeneration });\n  return bindingGeneration;\n}\n\nexport function unbindPhysicsBodyHandle2D(\n  handle: PibblPhysicsBodyHandle2D,\n  controller: PhysicsWorld2DController,\n  bodyId: number,\n  bindingGeneration: number,\n): void {\n  const state = states.get(handle as object);\n  if (state === undefined) {\n    const external = externalBindings.get(handle as object);\n    const binding = external?.binding;\n    if (\n      binding?.controller === controller &&\n      binding.bodyId === bodyId &&\n      binding.bindingGeneration === bindingGeneration\n    ) {\n      external!.binding = undefined;\n    }\n    return;\n  }\n  const binding = state?.binding;\n  if (\n    binding?.controller === controller &&\n    binding.bodyId === bodyId &&\n    binding.bindingGeneration === bindingGeneration\n  ) {\n    state!.binding = undefined;\n  }\n}\n\nexport function physicsBodyHandleBinding2D(\n  handle: PibblPhysicsBodyHandle2D,\n): PhysicsBodyHandleBinding2D | undefined {\n  return (\n    states.get(handle as object)?.binding ??\n    externalBindings.get(handle as object)?.binding\n  );\n}\n\nexport function isPhysicsBodyHandle2D(\n  value: unknown,\n): value is PibblPhysicsBodyHandle2D {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    (states.has(value) || externalBindings.has(value))\n  );\n}\n\nexport function physicsBodyHandleOwner2D(\n  handle: PibblPhysicsBodyHandle2D,\n): PibblInternalSimulationOwner {\n  return requireState(handle).owner;\n}\n\nexport function stagePhysicsBodyHandle2D(\n  batch: PibblInternalSignalBatch,\n  handle: PibblPhysicsBodyHandle2D,\n  values: PhysicsBodyHandleValues2D,\n  writer: object,\n): void {\n  const state = states.get(handle as object);\n  if (state === undefined) {\n    stageLegacyHandle(batch, handle, values, writer);\n    return;\n  }\n  for (const field of BODY_FIELDS_2D) {\n    const target = state.signals[field] as\n      WritableSignal<BodyFieldValue2D[typeof field]> | undefined;\n    if (target !== undefined) batch.stage(target, values[field], writer);\n  }\n}\n\nexport function snapshotPhysicsBodyHandle2DForTest(\n  handle: PibblPhysicsBodyHandle2D,\n): Readonly<{\n  readonly bound: boolean;\n  readonly bindingGeneration: number;\n  readonly materializedFields: readonly PhysicsBodyHandleField2D[];\n}> {\n  const state = requireState(handle);\n  return Object.freeze({\n    bound: state.binding !== undefined,\n    bindingGeneration: state.binding?.bindingGeneration ?? 0,\n    materializedFields: Object.freeze(\n      BODY_FIELDS_2D.filter((field) => state.signals[field] !== undefined),\n    ),\n  });\n}\n\nfunction disposePhysicsBodyHandle2D(handle: PibblPhysicsBodyHandle2D): void {\n  const state = states.get(handle as object);\n  if (state === undefined || !state.active) return;\n  state.active = false;\n  state.binding = undefined;\n}\n\nfunction queueBodyCommand(\n  handle: PibblPhysicsBodyHandle2D,\n  command: PhysicsBodyCommand2D,\n): void {\n  const state = requireState(handle);\n  const captured = state.binding;\n  pibblInternalQueueSimulationBegin(state.owner, () => {\n    const current = state.binding;\n    if (\n      captured === undefined ||\n      current === undefined ||\n      current.bindingGeneration !== captured.bindingGeneration ||\n      current.controller !== captured.controller ||\n      current.bodyId !== captured.bodyId\n    ) {\n      traceStaleCommand(command.kind, captured?.bindingGeneration ?? 0);\n      return;\n    }\n    if (\n      !current.controller.acceptBodyHandleCommand(\n        handle,\n        current.bindingGeneration,\n        Object.freeze({\n          ...command,\n          bodyId: current.bodyId,\n        }) as PhysicsBodyCommand2D,\n      )\n    ) {\n      traceStaleCommand(command.kind, current.bindingGeneration);\n    }\n  });\n}\n\nfunction traceStaleCommand(\n  kind: PhysicsBodyCommand2D[\"kind\"],\n  generation: number,\n): void {\n  const runtime = globalThis as typeof globalThis & {\n    readonly process?: Readonly<{\n      readonly env?: Readonly<{ readonly NODE_ENV?: string }>;\n    }>;\n  };\n  if (runtime.process?.env?.NODE_ENV === \"production\") return;\n  console.warn(\n    `[Pibbl physics] Ignored stale ${kind} command for body handle generation ${String(generation)}.`,\n  );\n}\n\nfunction requireBoolean(value: boolean, path: string): boolean {\n  if (typeof value !== \"boolean\")\n    throw new TypeError(`${path} must be boolean.`);\n  return value;\n}\n\nfunction requireState(\n  handle: PibblPhysicsBodyHandle2D,\n): PhysicsBodyHandleState2D {\n  const state =\n    typeof handle === \"object\" && handle !== null\n      ? states.get(handle as object)\n      : undefined;\n  if (state === undefined || !state.active) {\n    throw new TypeError(\"Expected a live Pibbl physics 2D body handle.\");\n  }\n  return state;\n}\n\nfunction materializeSignal<Field extends PhysicsBodyHandleField2D>(\n  state: PhysicsBodyHandleState2D,\n  field: Field,\n): WritableSignal<BodyFieldValue2D[Field]> {\n  let target = state.signals[field] as\n    WritableSignal<BodyFieldValue2D[Field]> | undefined;\n  if (target === undefined) {\n    const binding = state.binding;\n    const current =\n      binding === undefined\n        ? undefined\n        : binding.controller.bodyHandleValues(binding.bodyId);\n    target = signal(current?.[field] ?? INITIAL_VALUES_2D[field], {\n      debugName: `PhysicsBody2D.${field}`,\n    });\n    state.signals[field] = target as never;\n  }\n  return target;\n}\n\nfunction stageLegacyHandle(\n  batch: PibblInternalSignalBatch,\n  handle: PibblPhysicsBodyHandle2D,\n  values: PhysicsBodyHandleValues2D,\n  writer: object,\n): void {\n  for (const field of BODY_FIELDS_2D) {\n    const target = handle[field] as WritableSignal<\n      BodyFieldValue2D[typeof field]\n    >;\n    batch.stage(target, values[field], writer);\n  }\n}\n\nconst ZERO_VECTOR_2D = Object.freeze([0, 0] as const);\n\nconst INITIAL_VALUES_2D: BodyFieldValue2D = Object.freeze({\n  position: ZERO_VECTOR_2D,\n  rotationDegrees: 0,\n  linearVelocity: ZERO_VECTOR_2D,\n  angularVelocityDegreesPerSecond: 0,\n  sleeping: false,\n  enabled: false,\n  generation: 0,\n});\n\nconst BODY_FIELDS_2D = Object.freeze([\n  \"position\",\n  \"rotationDegrees\",\n  \"linearVelocity\",\n  \"angularVelocityDegreesPerSecond\",\n  \"sleeping\",\n  \"enabled\",\n  \"generation\",\n] as const);\n"],
+  "mappings": "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",
+  "names": ["bindingGeneration", "binding"]
+}

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

@@ -0,0 +1,9 @@
+import type { PhysicsWorld2DController } from "./controller.js";
+export interface PhysicsBodyScope2D {
+    readonly world: PhysicsWorld2DController;
+    readonly bodyId: number;
+}
+export declare function pushPhysicsWorld2D(world: PhysicsWorld2DController): () => void;
+export declare function requireCurrentPhysicsWorld2D(): PhysicsWorld2DController;
+export declare function pushPhysicsBody2D(scope: PhysicsBodyScope2D): () => void;
+export declare function requireCurrentPhysicsBody2D(): PhysicsBodyScope2D;