@vgai/engine 0.2.0

package/src/world2d/transform-writer-2d.ts

@@ -0,0 +1,24 @@
+import type { Physics2DRegistry } from './physics2d-registry';
+
+/**
+ * Build the single postPhysics transform writer for world2d — the ~5-line 2D
+ * analog of `createTransformWriter`.
+ *
+ * Rapier 2D reports `translation()` as `{x, y}` and `rotation()` as a SCALAR angle
+ * (radians), so the writeback is simply `display.position.set(x, y)` +
+ * `display.rotation = angle`. Scale is left untouched (Rapier carries no scale).
+ *
+ * Bodies are simulated in world2d pixel space directly (the surface uses a
+ * y-down, pixel-unit world), so no unit conversion is needed; parented entities
+ * are kept flat under the world container by the loader, mirroring the 3D writer's
+ * scene-root fast path.
+ */
+export function createTransformWriter2D(physics: Physics2DRegistry) {
+  return function writeTransforms2D(): void {
+    for (const [display, { body }] of physics.entries()) {
+      const t = body.translation();
+      display.position.set(t.x, t.y);
+      display.rotation = body.rotation();
+    }
+  };
+}

package/src/world2d/types.ts

@@ -0,0 +1,55 @@
+import type RAPIER from '@dimforge/rapier2d-compat';
+import type { Application, Container } from 'pixi.js';
+import type { z } from 'zod';
+import type { createSystemRunner } from '../core/system-runner';
+import type { SystemPhaseName } from '../core/types';
+import type { ComponentManager } from '../ecs/component-manager';
+import type { GameComponent } from '../ecs/game-component';
+import type { Collision2DSystem } from './collision-2d';
+import type { Physics2DRegistry } from './physics2d-registry';
+
+/**
+ * All world2d subsystems, passed to every world2d `setup(ctx)` and to each
+ * `GameComponent<'pixijs'>` lifecycle method — the 2D analog of `GameContext`.
+ *
+ * Raw libraries (call directly, no wrappers): `app` / `stage` (PixiJS),
+ * `rapier2dWorld` / `rapier2d` (Rapier 2D). Engine handles bridge them into the
+ * SAME phase-ordered loop the 3D path uses (`systems` is the very same
+ * `createSystemRunner`, and `PHASE_ORDER` is shared).
+ */
+export interface World2DContext {
+  /** The PixiJS application. Its renderer draws `stage`; auto-ticker is disabled. */
+  app: Application;
+  /** The world2d scene-graph root (the camera/world container under app.stage). */
+  stage: Container;
+  /** The Rapier 2D physics `World`. One shared world per world2d scene. */
+  rapier2dWorld: RAPIER.World;
+  /** The Rapier 2D module namespace (RigidBodyDesc, ColliderDesc, Vector2, …). */
+  rapier2d: typeof RAPIER;
+  /** `Container ↔ Rapier2D body/collider` registry (+ collider→entity reverse index). */
+  physics2d: Physics2DRegistry;
+  /** Rapier 2D collision/trigger event dispatcher; drained each postPhysics. */
+  collisions2d: Collision2DSystem;
+  /** Manager for all live GameComponent instances in this pixi world — the
+   *  unified `ComponentManager` (`ecs/component-manager.ts`, constructed with
+   *  `{ kind: 'pixijs' }`). The world2d-silo-only manager this replaced
+   *  (T7.3) is deleted; every 2D component attaches here, exactly like a
+   *  threejs component attaches onto its world's manager. */
+  components: ComponentManager;
+  /** The phase-ordered system runner (shared with the 3D path). */
+  systems: ReturnType<typeof createSystemRunner>;
+  /** DOM overlay for screen-space React/HUD UI (pointer-events:none by default). */
+  uiContainer: HTMLDivElement;
+}
+
+/** Constructor type for `GameComponent<'pixijs'>` subclasses used in a world2d
+ *  registry (carries static phase/schema) — the 2D-registry analog of
+ *  `GameComponentClass` (`ecs/game-component.ts`), narrowed to the pixijs kind
+ *  so `new Cls()` returns a properly-typed `GameComponent<'pixijs'>` without a cast. */
+export type Pixi2DComponentClass = (new () => GameComponent<'pixijs'>) & {
+  phase?: SystemPhaseName;
+  schema?: z.ZodObject<z.ZodRawShape>;
+};
+
+/** Component registry for world2d — a plain name→class map (the 2D analog). */
+export type Component2DRegistry = Record<string, Pixi2DComponentClass>;