// Vitest unit coverage for `map/state-binding.ts`. The function // translates a Phase 11 `GameReport` into a renderer-ready `World` // containing one Point primitive per planet across all four kinds // (local / other / uninhabited / unidentified). The tests assert // the world dimensions match the report, the planet ids are the // engine numbers, the kind-specific styles differ, and a zero-planet // report still produces a well-formed empty World. import "@testing-library/jest-dom/vitest"; import { describe, expect, test } from "vitest"; import type { GameReport, ReportPlanet } from "../src/api/game-state"; import { reportToWorld } from "../src/map/state-binding"; function makeReport(overrides: Partial = {}): GameReport { return { turn: 1, mapWidth: 4000, mapHeight: 4000, planetCount: 0, planets: [], race: "", localShipClass: [], routes: [], localPlayerDrive: 0, ...overrides, }; } // makePlanet fills the rich-projection fields the binding does not // inspect with `null`s so the binding-focused tests stay readable. function makePlanet(overrides: Partial): ReportPlanet { return { number: 0, name: "", x: 0, y: 0, kind: "local", owner: null, size: null, resources: null, industryStockpile: null, materialsStockpile: null, industry: null, population: null, colonists: null, production: null, freeIndustry: null, ...overrides, }; } describe("reportToWorld", () => { test("uses report dimensions for the World", () => { const world = reportToWorld(makeReport({ mapWidth: 3200, mapHeight: 1600 })); expect(world.width).toBe(3200); expect(world.height).toBe(1600); }); test("emits one Point primitive per planet across all four kinds", () => { const world = reportToWorld( makeReport({ planets: [ makePlanet({ number: 1, name: "Home", x: 100, y: 100, kind: "local", size: 12, resources: 0.5 }), makePlanet({ number: 2, name: "Alpha", x: 200, y: 100, kind: "other", owner: "Federation", size: 8, resources: 0.3 }), makePlanet({ number: 3, name: "Rock", x: 100, y: 200, kind: "uninhabited", size: 4, resources: 0.1 }), makePlanet({ number: 4, name: "", x: 200, y: 200, kind: "unidentified" }), ], }), ); expect(world.primitives.length).toBe(4); for (const p of world.primitives) { expect(p.kind).toBe("point"); } }); test("propagates planet number as primitive id and coordinates verbatim", () => { const world = reportToWorld( makeReport({ planets: [ makePlanet({ number: 42, name: "Home", x: 123.5, y: 456.25, kind: "local", size: 10, resources: 0.5 }), ], }), ); const [planet] = world.primitives; expect(planet?.id).toBe(42); expect(planet?.kind).toBe("point"); if (planet?.kind === "point") { expect(planet.x).toBe(123.5); expect(planet.y).toBe(456.25); } }); test("uses distinct styles for each planet kind", () => { const world = reportToWorld( makeReport({ planets: [ makePlanet({ number: 1, name: "L", kind: "local", size: 1, resources: 0 }), makePlanet({ number: 2, name: "O", x: 1, kind: "other", owner: "Foe", size: 1, resources: 0 }), makePlanet({ number: 3, name: "U", x: 2, kind: "uninhabited", size: 1, resources: 0 }), makePlanet({ number: 4, name: "?", x: 3, kind: "unidentified" }), ], }), ); const fills = world.primitives.map((p) => p.style.fillColor); const unique = new Set(fills); expect(unique.size).toBe(fills.length); }); test("zero-planet report yields an empty primitive list and well-formed World", () => { const world = reportToWorld(makeReport({ planets: [] })); expect(world.primitives.length).toBe(0); expect(world.width).toBeGreaterThan(0); expect(world.height).toBeGreaterThan(0); }); test("guards against zero / negative dimensions in the report", () => { const world = reportToWorld( makeReport({ mapWidth: 0, mapHeight: -1, planets: [] }), ); // World's constructor rejects non-positive dimensions; the // binding falls back to 1×1 so a malformed report cannot crash // the renderer. expect(world.width).toBeGreaterThan(0); expect(world.height).toBeGreaterThan(0); }); test("local planets carry higher priority than unidentified", () => { const world = reportToWorld( makeReport({ planets: [ makePlanet({ number: 1, name: "Home", kind: "local", size: 1, resources: 0 }), makePlanet({ number: 2, name: "?", kind: "unidentified" }), ], }), ); const local = world.primitives.find((p) => p.id === 1); const unknown = world.primitives.find((p) => p.id === 2); expect(local?.priority ?? 0).toBeGreaterThan(unknown?.priority ?? 0); }); test("cargo routes are NOT inlined into the static world", () => { // As of Phase 16 cargo-route arrows are pushed onto the live // renderer via `setExtraPrimitives` instead of being baked // into `reportToWorld`. The base world stays a clean // representation of the report's planets so the renderer // can rebuild the overlay without disposing Pixi. const world = reportToWorld( makeReport({ planets: [ makePlanet({ number: 1, name: "Earth", x: 100, y: 100, kind: "local", size: 5, resources: 1 }), makePlanet({ number: 2, name: "Mars", x: 300, y: 100, kind: "local", size: 5, resources: 1 }), ], routes: [ { sourcePlanetNumber: 1, entries: [{ loadType: "COL", destinationPlanetNumber: 2 }], }, ], }), ); const lines = world.primitives.filter((p) => p.kind === "line"); expect(lines.length).toBe(0); }); });