@game_engine/physics-adapter 0.1.0-alpha

package/README.md

@@ -0,0 +1,14 @@
+# @game_engine/physics-adapter
+
+Engine-neutral physics adapter contracts for Agent Engine.
+
+This package defines the boundary between Agent Engine ECS/source data and optional physics backends. It does not include a physics engine and must stay free of backend-specific dependencies.
+
+Adapter inputs are plain entities with `Transform`, `Velocity`, `Collider`, `RigidBody`, and `PhysicsMaterial` components. Adapter outputs are deterministic structured snapshots, contacts, grounding hints, and diagnostics.
+
+Use `comparePhysicsStepResults` when comparing optional backends. It summarizes body ids, static body positions, contact pairs, and diagnostic codes so tests can compare adapter health without requiring identical solver floating-point output.
+
+The current Rapier vs Planck evaluation is documented in
+[`docs/physics-adapter-evaluation.md`](../../docs/physics-adapter-evaluation.md).
+
+Default headless runtime behavior is still owned by `@game_engine/core` and its deterministic `KinematicPhysics` placeholder. Real physics adapters must be explicitly constructed by tests or experiments.

package/dist/index.d.ts

@@ -0,0 +1,108 @@
+import { EntityId, ComponentName, ComponentValue, Vector2, Transform, Velocity, Collider, RigidBody, PhysicsMaterial, World } from '@game_engine/core';
+
+type PhysicsAdapterSeverity = "warning" | "error";
+type PhysicsBodyType = "static" | "dynamic" | "kinematic";
+interface PhysicsAdapterDiagnostic {
+    severity: PhysicsAdapterSeverity;
+    code: string;
+    message: string;
+    entityId?: EntityId;
+    path?: string;
+    suggestion?: string;
+}
+type PhysicsAdapterDiagnostics = PhysicsAdapterDiagnostic[];
+interface PhysicsAdapterEntity {
+    id: EntityId;
+    components: Record<ComponentName, ComponentValue>;
+}
+interface PhysicsAdapterWorldInput {
+    entities: PhysicsAdapterEntity[];
+}
+interface PhysicsAdapterCreateOptions {
+    gravity?: Vector2;
+}
+interface PhysicsStepOptions {
+    frame?: number;
+}
+interface PhysicsContactSnapshot {
+    entityId: EntityId;
+    otherEntityId: EntityId;
+    grounded?: boolean;
+}
+interface PhysicsGroundingSnapshot {
+    grounded: boolean;
+    groundEntityId?: EntityId;
+}
+interface PhysicsBodySnapshot {
+    entityId: EntityId;
+    bodyType: PhysicsBodyType;
+    transform?: Pick<Transform, "position" | "rotation">;
+    velocity?: Velocity;
+    grounded?: PhysicsGroundingSnapshot;
+    contacts: PhysicsContactSnapshot[];
+}
+interface PhysicsStepResult {
+    ok: boolean;
+    frame: number;
+    deltaSeconds: number;
+    bodies: PhysicsBodySnapshot[];
+    contacts: PhysicsContactSnapshot[];
+    diagnostics: PhysicsAdapterDiagnostics;
+}
+interface PhysicsAdapterWorld {
+    step(deltaSeconds: number, options?: PhysicsStepOptions): PhysicsStepResult;
+    snapshot(options?: PhysicsStepOptions): PhysicsStepResult;
+    dispose?(): void;
+}
+interface PhysicsAdapter {
+    name: string;
+    createWorld(input: PhysicsAdapterWorldInput, options?: PhysicsAdapterCreateOptions): PhysicsAdapterWorld | Promise<PhysicsAdapterWorld>;
+}
+interface PhysicsComponents {
+    transform?: Transform;
+    velocity?: Velocity;
+    collider?: Collider;
+    rigidBody?: RigidBody;
+    physicsMaterial?: PhysicsMaterial;
+}
+interface PhysicsBackendComparisonInput {
+    backend: string;
+    result: PhysicsStepResult;
+}
+interface PhysicsStaticBodySummary {
+    entityId: EntityId;
+    position?: Vector2;
+}
+interface PhysicsBackendResultSummary {
+    backend: string;
+    ok: boolean;
+    bodyCount: number;
+    bodyIds: EntityId[];
+    staticBodies: PhysicsStaticBodySummary[];
+    diagnosticCodes: string[];
+    contactPairs: string[];
+}
+interface PhysicsBackendComparison {
+    summaries: PhysicsBackendResultSummary[];
+    sameBodyIds: boolean;
+    sameStaticBodyPositions: boolean;
+    diagnosticsShapeCompatible: boolean;
+}
+declare function createPhysicsAdapterInputFromWorld(world: World): PhysicsAdapterWorldInput;
+declare function clonePhysicsAdapterInput(input: PhysicsAdapterWorldInput): PhysicsAdapterWorldInput;
+declare function readPhysicsComponents(entity: PhysicsAdapterEntity): PhysicsComponents;
+declare function resolvePhysicsBodyType(components: PhysicsComponents): PhysicsBodyType;
+declare function sortPhysicsBodySnapshots(bodies: PhysicsBodySnapshot[]): PhysicsBodySnapshot[];
+declare function sortPhysicsContacts(contacts: PhysicsContactSnapshot[]): PhysicsContactSnapshot[];
+declare function createPhysicsStepResult(fields: Omit<PhysicsStepResult, "ok" | "bodies" | "contacts" | "diagnostics"> & {
+    bodies?: PhysicsBodySnapshot[];
+    contacts?: PhysicsContactSnapshot[];
+    diagnostics?: PhysicsAdapterDiagnostics;
+}): PhysicsStepResult;
+declare function createPhysicsDiagnostic(diagnostic: PhysicsAdapterDiagnostic): PhysicsAdapterDiagnostic;
+declare function summarizePhysicsStepResult(backend: string, result: PhysicsStepResult): PhysicsBackendResultSummary;
+declare function comparePhysicsStepResults(inputs: PhysicsBackendComparisonInput[]): PhysicsBackendComparison;
+declare function roundDeterministic(value: number): number;
+declare function roundVector2(value: Vector2): Vector2;
+
+export { type PhysicsAdapter, type PhysicsAdapterCreateOptions, type PhysicsAdapterDiagnostic, type PhysicsAdapterDiagnostics, type PhysicsAdapterEntity, type PhysicsAdapterSeverity, type PhysicsAdapterWorld, type PhysicsAdapterWorldInput, type PhysicsBackendComparison, type PhysicsBackendComparisonInput, type PhysicsBackendResultSummary, type PhysicsBodySnapshot, type PhysicsBodyType, type PhysicsComponents, type PhysicsContactSnapshot, type PhysicsGroundingSnapshot, type PhysicsStaticBodySummary, type PhysicsStepOptions, type PhysicsStepResult, clonePhysicsAdapterInput, comparePhysicsStepResults, createPhysicsAdapterInputFromWorld, createPhysicsDiagnostic, createPhysicsStepResult, readPhysicsComponents, resolvePhysicsBodyType, roundDeterministic, roundVector2, sortPhysicsBodySnapshots, sortPhysicsContacts, summarizePhysicsStepResult };

package/dist/index.js

@@ -0,0 +1,204 @@
+// src/index.ts
+function createPhysicsAdapterInputFromWorld(world) {
+  return {
+    entities: world.listEntities().map((entity) => cloneAdapterEntity(entity))
+  };
+}
+function clonePhysicsAdapterInput(input) {
+  return {
+    entities: input.entities.map((entity) => cloneAdapterEntity(entity))
+  };
+}
+function readPhysicsComponents(entity) {
+  return {
+    transform: readTransform(entity.components.Transform),
+    velocity: readVelocity(entity.components.Velocity),
+    collider: readCollider(entity.components.Collider),
+    rigidBody: readRigidBody(entity.components.RigidBody),
+    physicsMaterial: readPhysicsMaterial(entity.components.PhysicsMaterial)
+  };
+}
+function resolvePhysicsBodyType(components) {
+  if (components.rigidBody) {
+    return components.rigidBody.type;
+  }
+  return components.collider?.static ? "static" : "dynamic";
+}
+function sortPhysicsBodySnapshots(bodies) {
+  return [...bodies].sort((left, right) => left.entityId.localeCompare(right.entityId));
+}
+function sortPhysicsContacts(contacts) {
+  return [...contacts].sort((left, right) => {
+    const entityOrder = left.entityId.localeCompare(right.entityId);
+    return entityOrder !== 0 ? entityOrder : left.otherEntityId.localeCompare(right.otherEntityId);
+  });
+}
+function createPhysicsStepResult(fields) {
+  const bodies = sortPhysicsBodySnapshots(fields.bodies ?? []);
+  const contacts = sortPhysicsContacts(fields.contacts ?? []);
+  const diagnostics = sortDiagnostics(fields.diagnostics ?? []);
+  return {
+    ok: !diagnostics.some((diagnostic) => diagnostic.severity === "error"),
+    frame: fields.frame,
+    deltaSeconds: roundDeterministic(fields.deltaSeconds),
+    bodies,
+    contacts,
+    diagnostics
+  };
+}
+function createPhysicsDiagnostic(diagnostic) {
+  return { ...diagnostic };
+}
+function summarizePhysicsStepResult(backend, result) {
+  return {
+    backend,
+    ok: result.ok,
+    bodyCount: result.bodies.length,
+    bodyIds: result.bodies.map((body) => body.entityId).sort(),
+    staticBodies: result.bodies.filter((body) => body.bodyType === "static").map((body) => ({
+      entityId: body.entityId,
+      ...body.transform?.position ? { position: roundVector2(body.transform.position) } : {}
+    })).sort((left, right) => left.entityId.localeCompare(right.entityId)),
+    diagnosticCodes: result.diagnostics.map((diagnostic) => diagnostic.code).sort(),
+    contactPairs: result.contacts.map((contact) => `${contact.entityId}->${contact.otherEntityId}`).sort()
+  };
+}
+function comparePhysicsStepResults(inputs) {
+  const summaries = inputs.map((input) => summarizePhysicsStepResult(input.backend, input.result)).sort((left, right) => left.backend.localeCompare(right.backend));
+  const [baseline] = summaries;
+  return {
+    summaries,
+    sameBodyIds: baseline ? summaries.every((summary) => arraysEqual(summary.bodyIds, baseline.bodyIds)) : true,
+    sameStaticBodyPositions: baseline ? summaries.every((summary) => staticBodySummariesEqual(summary.staticBodies, baseline.staticBodies)) : true,
+    diagnosticsShapeCompatible: baseline ? summaries.every((summary) => arraysEqual(summary.diagnosticCodes, baseline.diagnosticCodes)) : true
+  };
+}
+function roundDeterministic(value) {
+  const rounded = Number(value.toFixed(12));
+  const nearestInteger = Math.round(rounded);
+  return Math.abs(rounded - nearestInteger) < 1e-9 ? nearestInteger : rounded;
+}
+function roundVector2(value) {
+  return [roundDeterministic(value[0]), roundDeterministic(value[1])];
+}
+function cloneAdapterEntity(entity) {
+  return {
+    id: entity.id,
+    components: cloneComponents(entity.components)
+  };
+}
+function cloneComponents(components) {
+  return Object.fromEntries(Object.entries(components).map(([name, value]) => [name, cloneValue(value)]));
+}
+function cloneValue(value) {
+  if (value === void 0) {
+    return void 0;
+  }
+  return JSON.parse(JSON.stringify(value));
+}
+function sortDiagnostics(diagnostics) {
+  return [...diagnostics].sort((left, right) => {
+    const entityOrder = (left.entityId ?? "").localeCompare(right.entityId ?? "");
+    if (entityOrder !== 0) {
+      return entityOrder;
+    }
+    const pathOrder = (left.path ?? "").localeCompare(right.path ?? "");
+    return pathOrder !== 0 ? pathOrder : left.code.localeCompare(right.code);
+  });
+}
+function readTransform(value) {
+  if (!isRecord(value)) {
+    return void 0;
+  }
+  const position = readVector2(value.position);
+  const scale = readVector2(value.scale);
+  const rotation = typeof value.rotation === "number" && Number.isFinite(value.rotation) ? value.rotation : void 0;
+  return position && scale && rotation !== void 0 ? {
+    position,
+    rotation,
+    scale
+  } : void 0;
+}
+function readVelocity(value) {
+  if (!isRecord(value)) {
+    return void 0;
+  }
+  const linear = readVector2(value.linear);
+  return linear ? { linear } : void 0;
+}
+function readCollider(value) {
+  if (!isRecord(value) || value.shape !== "box" || typeof value.static !== "boolean") {
+    return void 0;
+  }
+  const size = readVector2(value.size);
+  if (!size) {
+    return void 0;
+  }
+  return {
+    shape: "box",
+    size,
+    static: value.static,
+    ...typeof value.sensor === "boolean" ? { sensor: value.sensor } : {}
+  };
+}
+function readRigidBody(value) {
+  if (!isRecord(value) || !["static", "dynamic", "kinematic"].includes(String(value.type))) {
+    return void 0;
+  }
+  return {
+    type: value.type,
+    ...typeof value.gravityScale === "number" ? { gravityScale: value.gravityScale } : {},
+    ...typeof value.lockedRotation === "boolean" ? { lockedRotation: value.lockedRotation } : {}
+  };
+}
+function readPhysicsMaterial(value) {
+  if (!isRecord(value) || typeof value.friction !== "number" || typeof value.restitution !== "number") {
+    return void 0;
+  }
+  return {
+    friction: value.friction,
+    restitution: value.restitution
+  };
+}
+function readVector2(value) {
+  if (!Array.isArray(value) || value.length !== 2 || typeof value[0] !== "number" || typeof value[1] !== "number" || !Number.isFinite(value[0]) || !Number.isFinite(value[1])) {
+    return void 0;
+  }
+  return [value[0], value[1]];
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function arraysEqual(left, right) {
+  return left.length === right.length && left.every((value, index) => value === right[index]);
+}
+function staticBodySummariesEqual(left, right) {
+  if (left.length !== right.length) {
+    return false;
+  }
+  return left.every((leftSummary, index) => {
+    const rightSummary = right[index];
+    if (!rightSummary || leftSummary.entityId !== rightSummary.entityId) {
+      return false;
+    }
+    if (!leftSummary.position || !rightSummary.position) {
+      return leftSummary.position === rightSummary.position;
+    }
+    return leftSummary.position[0] === rightSummary.position[0] && leftSummary.position[1] === rightSummary.position[1];
+  });
+}
+export {
+  clonePhysicsAdapterInput,
+  comparePhysicsStepResults,
+  createPhysicsAdapterInputFromWorld,
+  createPhysicsDiagnostic,
+  createPhysicsStepResult,
+  readPhysicsComponents,
+  resolvePhysicsBodyType,
+  roundDeterministic,
+  roundVector2,
+  sortPhysicsBodySnapshots,
+  sortPhysicsContacts,
+  summarizePhysicsStepResult
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import type {\n  Collider,\n  ComponentName,\n  ComponentValue,\n  EntityId,\n  EntityRecord,\n  PhysicsMaterial,\n  RigidBody,\n  Transform,\n  Vector2,\n  Velocity,\n  World\n} from \"@game_engine/core\";\n\nexport type PhysicsAdapterSeverity = \"warning\" | \"error\";\nexport type PhysicsBodyType = \"static\" | \"dynamic\" | \"kinematic\";\n\nexport interface PhysicsAdapterDiagnostic {\n  severity: PhysicsAdapterSeverity;\n  code: string;\n  message: string;\n  entityId?: EntityId;\n  path?: string;\n  suggestion?: string;\n}\n\nexport type PhysicsAdapterDiagnostics = PhysicsAdapterDiagnostic[];\n\nexport interface PhysicsAdapterEntity {\n  id: EntityId;\n  components: Record<ComponentName, ComponentValue>;\n}\n\nexport interface PhysicsAdapterWorldInput {\n  entities: PhysicsAdapterEntity[];\n}\n\nexport interface PhysicsAdapterCreateOptions {\n  gravity?: Vector2;\n}\n\nexport interface PhysicsStepOptions {\n  frame?: number;\n}\n\nexport interface PhysicsContactSnapshot {\n  entityId: EntityId;\n  otherEntityId: EntityId;\n  grounded?: boolean;\n}\n\nexport interface PhysicsGroundingSnapshot {\n  grounded: boolean;\n  groundEntityId?: EntityId;\n}\n\nexport interface PhysicsBodySnapshot {\n  entityId: EntityId;\n  bodyType: PhysicsBodyType;\n  transform?: Pick<Transform, \"position\" | \"rotation\">;\n  velocity?: Velocity;\n  grounded?: PhysicsGroundingSnapshot;\n  contacts: PhysicsContactSnapshot[];\n}\n\nexport interface PhysicsStepResult {\n  ok: boolean;\n  frame: number;\n  deltaSeconds: number;\n  bodies: PhysicsBodySnapshot[];\n  contacts: PhysicsContactSnapshot[];\n  diagnostics: PhysicsAdapterDiagnostics;\n}\n\nexport interface PhysicsAdapterWorld {\n  step(deltaSeconds: number, options?: PhysicsStepOptions): PhysicsStepResult;\n  snapshot(options?: PhysicsStepOptions): PhysicsStepResult;\n  dispose?(): void;\n}\n\nexport interface PhysicsAdapter {\n  name: string;\n  createWorld(\n    input: PhysicsAdapterWorldInput,\n    options?: PhysicsAdapterCreateOptions\n  ): PhysicsAdapterWorld | Promise<PhysicsAdapterWorld>;\n}\n\nexport interface PhysicsComponents {\n  transform?: Transform;\n  velocity?: Velocity;\n  collider?: Collider;\n  rigidBody?: RigidBody;\n  physicsMaterial?: PhysicsMaterial;\n}\n\nexport interface PhysicsBackendComparisonInput {\n  backend: string;\n  result: PhysicsStepResult;\n}\n\nexport interface PhysicsStaticBodySummary {\n  entityId: EntityId;\n  position?: Vector2;\n}\n\nexport interface PhysicsBackendResultSummary {\n  backend: string;\n  ok: boolean;\n  bodyCount: number;\n  bodyIds: EntityId[];\n  staticBodies: PhysicsStaticBodySummary[];\n  diagnosticCodes: string[];\n  contactPairs: string[];\n}\n\nexport interface PhysicsBackendComparison {\n  summaries: PhysicsBackendResultSummary[];\n  sameBodyIds: boolean;\n  sameStaticBodyPositions: boolean;\n  diagnosticsShapeCompatible: boolean;\n}\n\nexport function createPhysicsAdapterInputFromWorld(world: World): PhysicsAdapterWorldInput {\n  return {\n    entities: world.listEntities().map((entity) => cloneAdapterEntity(entity))\n  };\n}\n\nexport function clonePhysicsAdapterInput(input: PhysicsAdapterWorldInput): PhysicsAdapterWorldInput {\n  return {\n    entities: input.entities.map((entity) => cloneAdapterEntity(entity))\n  };\n}\n\nexport function readPhysicsComponents(entity: PhysicsAdapterEntity): PhysicsComponents {\n  return {\n    transform: readTransform(entity.components.Transform),\n    velocity: readVelocity(entity.components.Velocity),\n    collider: readCollider(entity.components.Collider),\n    rigidBody: readRigidBody(entity.components.RigidBody),\n    physicsMaterial: readPhysicsMaterial(entity.components.PhysicsMaterial)\n  };\n}\n\nexport function resolvePhysicsBodyType(components: PhysicsComponents): PhysicsBodyType {\n  if (components.rigidBody) {\n    return components.rigidBody.type;\n  }\n\n  return components.collider?.static ? \"static\" : \"dynamic\";\n}\n\nexport function sortPhysicsBodySnapshots(bodies: PhysicsBodySnapshot[]): PhysicsBodySnapshot[] {\n  return [...bodies].sort((left, right) => left.entityId.localeCompare(right.entityId));\n}\n\nexport function sortPhysicsContacts(contacts: PhysicsContactSnapshot[]): PhysicsContactSnapshot[] {\n  return [...contacts].sort((left, right) => {\n    const entityOrder = left.entityId.localeCompare(right.entityId);\n    return entityOrder !== 0 ? entityOrder : left.otherEntityId.localeCompare(right.otherEntityId);\n  });\n}\n\nexport function createPhysicsStepResult(\n  fields: Omit<PhysicsStepResult, \"ok\" | \"bodies\" | \"contacts\" | \"diagnostics\"> & {\n    bodies?: PhysicsBodySnapshot[];\n    contacts?: PhysicsContactSnapshot[];\n    diagnostics?: PhysicsAdapterDiagnostics;\n  }\n): PhysicsStepResult {\n  const bodies = sortPhysicsBodySnapshots(fields.bodies ?? []);\n  const contacts = sortPhysicsContacts(fields.contacts ?? []);\n  const diagnostics = sortDiagnostics(fields.diagnostics ?? []);\n\n  return {\n    ok: !diagnostics.some((diagnostic) => diagnostic.severity === \"error\"),\n    frame: fields.frame,\n    deltaSeconds: roundDeterministic(fields.deltaSeconds),\n    bodies,\n    contacts,\n    diagnostics\n  };\n}\n\nexport function createPhysicsDiagnostic(\n  diagnostic: PhysicsAdapterDiagnostic\n): PhysicsAdapterDiagnostic {\n  return { ...diagnostic };\n}\n\nexport function summarizePhysicsStepResult(\n  backend: string,\n  result: PhysicsStepResult\n): PhysicsBackendResultSummary {\n  return {\n    backend,\n    ok: result.ok,\n    bodyCount: result.bodies.length,\n    bodyIds: result.bodies.map((body) => body.entityId).sort(),\n    staticBodies: result.bodies\n      .filter((body) => body.bodyType === \"static\")\n      .map((body) => ({\n        entityId: body.entityId,\n        ...(body.transform?.position ? { position: roundVector2(body.transform.position) } : {})\n      }))\n      .sort((left, right) => left.entityId.localeCompare(right.entityId)),\n    diagnosticCodes: result.diagnostics.map((diagnostic) => diagnostic.code).sort(),\n    contactPairs: result.contacts\n      .map((contact) => `${contact.entityId}->${contact.otherEntityId}`)\n      .sort()\n  };\n}\n\nexport function comparePhysicsStepResults(\n  inputs: PhysicsBackendComparisonInput[]\n): PhysicsBackendComparison {\n  const summaries = inputs\n    .map((input) => summarizePhysicsStepResult(input.backend, input.result))\n    .sort((left, right) => left.backend.localeCompare(right.backend));\n  const [baseline] = summaries;\n\n  return {\n    summaries,\n    sameBodyIds: baseline ? summaries.every((summary) => arraysEqual(summary.bodyIds, baseline.bodyIds)) : true,\n    sameStaticBodyPositions: baseline\n      ? summaries.every((summary) => staticBodySummariesEqual(summary.staticBodies, baseline.staticBodies))\n      : true,\n    diagnosticsShapeCompatible: baseline\n      ? summaries.every((summary) => arraysEqual(summary.diagnosticCodes, baseline.diagnosticCodes))\n      : true\n  };\n}\n\nexport function roundDeterministic(value: number): number {\n  const rounded = Number(value.toFixed(12));\n  const nearestInteger = Math.round(rounded);\n  return Math.abs(rounded - nearestInteger) < 1e-9 ? nearestInteger : rounded;\n}\n\nexport function roundVector2(value: Vector2): Vector2 {\n  return [roundDeterministic(value[0]), roundDeterministic(value[1])];\n}\n\nfunction cloneAdapterEntity(entity: EntityRecord | PhysicsAdapterEntity): PhysicsAdapterEntity {\n  return {\n    id: entity.id,\n    components: cloneComponents(entity.components)\n  };\n}\n\nfunction cloneComponents(components: Record<ComponentName, ComponentValue>): Record<ComponentName, ComponentValue> {\n  return Object.fromEntries(Object.entries(components).map(([name, value]) => [name, cloneValue(value)]));\n}\n\nfunction cloneValue(value: ComponentValue): ComponentValue {\n  if (value === undefined) {\n    return undefined;\n  }\n\n  return JSON.parse(JSON.stringify(value));\n}\n\nfunction sortDiagnostics(diagnostics: PhysicsAdapterDiagnostics): PhysicsAdapterDiagnostics {\n  return [...diagnostics].sort((left, right) => {\n    const entityOrder = (left.entityId ?? \"\").localeCompare(right.entityId ?? \"\");\n    if (entityOrder !== 0) {\n      return entityOrder;\n    }\n\n    const pathOrder = (left.path ?? \"\").localeCompare(right.path ?? \"\");\n    return pathOrder !== 0 ? pathOrder : left.code.localeCompare(right.code);\n  });\n}\n\nfunction readTransform(value: ComponentValue): Transform | undefined {\n  if (!isRecord(value)) {\n    return undefined;\n  }\n\n  const position = readVector2(value.position);\n  const scale = readVector2(value.scale);\n  const rotation = typeof value.rotation === \"number\" && Number.isFinite(value.rotation) ? value.rotation : undefined;\n\n  return position && scale && rotation !== undefined\n    ? {\n        position,\n        rotation,\n        scale\n      }\n    : undefined;\n}\n\nfunction readVelocity(value: ComponentValue): Velocity | undefined {\n  if (!isRecord(value)) {\n    return undefined;\n  }\n\n  const linear = readVector2(value.linear);\n  return linear ? { linear } : undefined;\n}\n\nfunction readCollider(value: ComponentValue): Collider | undefined {\n  if (!isRecord(value) || value.shape !== \"box\" || typeof value.static !== \"boolean\") {\n    return undefined;\n  }\n\n  const size = readVector2(value.size);\n  if (!size) {\n    return undefined;\n  }\n\n  return {\n    shape: \"box\",\n    size,\n    static: value.static,\n    ...(typeof value.sensor === \"boolean\" ? { sensor: value.sensor } : {})\n  };\n}\n\nfunction readRigidBody(value: ComponentValue): RigidBody | undefined {\n  if (!isRecord(value) || ![\"static\", \"dynamic\", \"kinematic\"].includes(String(value.type))) {\n    return undefined;\n  }\n\n  return {\n    type: value.type as RigidBody[\"type\"],\n    ...(typeof value.gravityScale === \"number\" ? { gravityScale: value.gravityScale } : {}),\n    ...(typeof value.lockedRotation === \"boolean\" ? { lockedRotation: value.lockedRotation } : {})\n  };\n}\n\nfunction readPhysicsMaterial(value: ComponentValue): PhysicsMaterial | undefined {\n  if (!isRecord(value) || typeof value.friction !== \"number\" || typeof value.restitution !== \"number\") {\n    return undefined;\n  }\n\n  return {\n    friction: value.friction,\n    restitution: value.restitution\n  };\n}\n\nfunction readVector2(value: unknown): Vector2 | undefined {\n  if (\n    !Array.isArray(value) ||\n    value.length !== 2 ||\n    typeof value[0] !== \"number\" ||\n    typeof value[1] !== \"number\" ||\n    !Number.isFinite(value[0]) ||\n    !Number.isFinite(value[1])\n  ) {\n    return undefined;\n  }\n\n  return [value[0], value[1]];\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction arraysEqual(left: readonly string[], right: readonly string[]): boolean {\n  return left.length === right.length && left.every((value, index) => value === right[index]);\n}\n\nfunction staticBodySummariesEqual(\n  left: readonly PhysicsStaticBodySummary[],\n  right: readonly PhysicsStaticBodySummary[]\n): boolean {\n  if (left.length !== right.length) {\n    return false;\n  }\n\n  return left.every((leftSummary, index) => {\n    const rightSummary = right[index];\n    if (!rightSummary || leftSummary.entityId !== rightSummary.entityId) {\n      return false;\n    }\n\n    if (!leftSummary.position || !rightSummary.position) {\n      return leftSummary.position === rightSummary.position;\n    }\n\n    return leftSummary.position[0] === rightSummary.position[0] && leftSummary.position[1] === rightSummary.position[1];\n  });\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@game_engine/physics-adapter",
+  "version": "0.1.0-alpha",
+  "description": "Backend-neutral physics adapter contracts for Agent Engine experiments.",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/rktkdduq01/game_engine.git",
+    "directory": "packages/physics-adapter"
+  },
+  "keywords": [
+    "agent-engine",
+    "game-engine",
+    "ai-agent",
+    "physics",
+    "adapter"
+  ],
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --dts --sourcemap --clean"
+  },
+  "dependencies": {
+    "@game_engine/core": "workspace:*"
+  },
+  "devDependencies": {
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.8"
+  }
+}