From 43d13ddaeaee0d249292e877f8f18d80afcfbd6a Mon Sep 17 00:00:00 2001 From: Leo Date: Fri, 6 Nov 2026 14:54:49 +0100 Subject: [PATCH 1/3] test(e2e): add browser e2e tests for 2D and 3D games Two small client-only test games (graphics-2d, graphics-3d forced on WebGL) run in Chromium through Playwright. Each is checked for: booting without errors, input changing game state, pixels at known spots, and a reference screenshot (compared on Linux only, 1% tolerance). Bumps the loader to 1.6.0: with 1.5.1 the loading screen stays on top of the running game. --- .github/workflows/tests.yml | 31 +++++ .gitignore | 4 +- .prettierignore | 3 + e2e/game-2d/.gitignore | 1 + e2e/game-2d/apps/client/nanoforge.config.ts | 5 + e2e/game-2d/apps/client/package.json | 14 +++ e2e/game-2d/apps/client/src/main.ts | 60 +++++++++ e2e/game-2d/nanoforge.config.ts | 6 + e2e/game-2d/package.json | 19 +++ e2e/game-2d/tsconfig.json | 6 + e2e/game-3d/.gitignore | 1 + e2e/game-3d/apps/client/nanoforge.config.ts | 5 + e2e/game-3d/apps/client/package.json | 16 +++ e2e/game-3d/apps/client/src/main.ts | 82 +++++++++++++ e2e/game-3d/nanoforge.config.ts | 6 + e2e/game-3d/package.json | 19 +++ e2e/game-3d/tsconfig.json | 6 + e2e/graphics/game-2d.spec.ts | 43 +++++++ e2e/graphics/game-3d.spec.ts | 44 +++++++ e2e/graphics/helpers.ts | 64 ++++++++++ package.json | 2 + playwright.config.ts | 36 ++++++ pnpm-lock.yaml | 127 ++++++++++++++++++-- pnpm-workspace.yaml | 3 + 24 files changed, 590 insertions(+), 13 deletions(-) create mode 100644 e2e/game-2d/.gitignore create mode 100644 e2e/game-2d/apps/client/nanoforge.config.ts create mode 100644 e2e/game-2d/apps/client/package.json create mode 100644 e2e/game-2d/apps/client/src/main.ts create mode 100644 e2e/game-2d/nanoforge.config.ts create mode 100644 e2e/game-2d/package.json create mode 100644 e2e/game-2d/tsconfig.json create mode 100644 e2e/game-3d/.gitignore create mode 100644 e2e/game-3d/apps/client/nanoforge.config.ts create mode 100644 e2e/game-3d/apps/client/package.json create mode 100644 e2e/game-3d/apps/client/src/main.ts create mode 100644 e2e/game-3d/nanoforge.config.ts create mode 100644 e2e/game-3d/package.json create mode 100644 e2e/game-3d/tsconfig.json create mode 100644 e2e/graphics/game-2d.spec.ts create mode 100644 e2e/graphics/game-3d.spec.ts create mode 100644 e2e/graphics/helpers.ts create mode 100644 playwright.config.ts diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml index 76ee7bfe..4a3c222d 100644 --- a/.github/workflows/tests.yml +++ b/.github/workflows/tests.yml @@ -8,6 +8,11 @@ on: branches: - main workflow_dispatch: + inputs: + update-snapshots: + description: Regenerate the graphics e2e reference screenshots (uploaded as the graphics-e2e artifact) + type: boolean + default: false jobs: tests: @@ -24,3 +29,29 @@ jobs: - name: "Run linter" run: pnpm lint + + graphics: + # Pinned: the reference screenshots are rendered by this OS's Chromium and SwiftShader. + runs-on: ubuntu-24.04 + steps: + - name: Checkout repository + uses: actions/checkout@v7 + + - name: Prepare + uses: ./.github/actions/prepare + + - name: Install Chromium + run: pnpm exec playwright install --with-deps chromium + + - name: Run graphics e2e tests + run: pnpm test:e2e:graphics ${{ inputs.update-snapshots && '--update-snapshots' || '' }} + + - name: Upload report and screenshots + if: always() + uses: actions/upload-artifact@v7 + with: + name: graphics-e2e + path: | + playwright-report/ + test-results/ + e2e/graphics/*-snapshots/ diff --git a/.gitignore b/.gitignore index a9ed69d0..2e38979d 100644 --- a/.gitignore +++ b/.gitignore @@ -242,4 +242,6 @@ emsdk-cache/ references/ .direnv -packages/old-core/ \ No newline at end of file +packages/old-core/ +playwright-report/ +test-results/ diff --git a/.prettierignore b/.prettierignore index 98eca11c..316374a7 100644 --- a/.prettierignore +++ b/.prettierignore @@ -21,3 +21,6 @@ CHANGELOG.md emsdk-cache/ docs/api + +playwright-report/ +test-results/ diff --git a/e2e/game-2d/.gitignore b/e2e/game-2d/.gitignore new file mode 100644 index 00000000..6016b4b4 --- /dev/null +++ b/e2e/game-2d/.gitignore @@ -0,0 +1 @@ +.nanoforge/ diff --git a/e2e/game-2d/apps/client/nanoforge.config.ts b/e2e/game-2d/apps/client/nanoforge.config.ts new file mode 100644 index 00000000..77607cbd --- /dev/null +++ b/e2e/game-2d/apps/client/nanoforge.config.ts @@ -0,0 +1,5 @@ +import { defineConfig } from "@nanoforge-dev/config"; + +export default defineConfig({ + type: "client", +}); diff --git a/e2e/game-2d/apps/client/package.json b/e2e/game-2d/apps/client/package.json new file mode 100644 index 00000000..0c1782d9 --- /dev/null +++ b/e2e/game-2d/apps/client/package.json @@ -0,0 +1,14 @@ +{ + "name": "e2e-game-2d-client", + "version": "0.0.0", + "type": "module", + "devDependencies": { + "@nanoforge-dev/common": "workspace:*", + "@nanoforge-dev/core": "workspace:*", + "@nanoforge-dev/ecs": "workspace:*", + "@nanoforge-dev/graphics-2d": "workspace:*", + "@nanoforge-dev/input": "workspace:*", + "typescript": "catalog:core" + }, + "private": true +} diff --git a/e2e/game-2d/apps/client/src/main.ts b/e2e/game-2d/apps/client/src/main.ts new file mode 100644 index 00000000..c1945e4c --- /dev/null +++ b/e2e/game-2d/apps/client/src/main.ts @@ -0,0 +1,60 @@ +import type { ClientRunOptions, Context } from "@nanoforge-dev/common"; +import { NanoforgeFactory } from "@nanoforge-dev/core"; +import { EcsLibrary, type Registry } from "@nanoforge-dev/ecs/client"; +import { Circle, Graphics2DLibrary, Rect } from "@nanoforge-dev/graphics-2d"; +import { InputEnum, InputLibrary } from "@nanoforge-dev/input"; + +/** Read by the Playwright tests in `e2e/graphics`. */ +export interface E2EState { + tick: number; + player: { x: number; y: number }; +} + +class Player { + name = "Player"; + + constructor(public shape: Rect) {} +} + +// Fixed step per tick, not per second: screenshots and positions must not depend on frame timing. +const SPEED = 5; + +export const main = async (options: ClientRunOptions): Promise => { + const app = NanoforgeFactory.createClient({ + tickRate: 60, + viewport: { width: 800, height: 600, fit: "contain" }, + }); + const graphics = new Graphics2DLibrary(); + const ecs = new EcsLibrary(); + const input = new InputLibrary(); + app.use(graphics); + app.use(ecs); + app.use(input); + + await app.init(options); + + const layer = graphics.baseLayer; + layer.add(new Rect({ x: 0, y: 0, width: 800, height: 600, fill: "#1e1e2e" })); + layer.add(new Circle({ x: 600, y: 300, radius: 80, fill: "#00ff00" })); + const square = new Rect({ x: 100, y: 250, width: 100, height: 100, fill: "#ff0000" }); + layer.add(square); + + const registry = ecs.registry; + registry.addComponent(registry.spawnEntity(), new Player(square)); + + const state: E2EState = { tick: 0, player: { x: square.x(), y: square.y() } }; + (window as unknown as { __e2e: E2EState }).__e2e = state; + + registry.addSystem((registry: Registry, ctx: Context) => { + registry.getZipper([Player]).forEach(({ Player }) => { + const dx = + (ctx.input.isKeyPressed(InputEnum.ArrowRight) ? SPEED : 0) - + (ctx.input.isKeyPressed(InputEnum.ArrowLeft) ? SPEED : 0); + Player.shape.x(Player.shape.x() + dx); + state.player = { x: Player.shape.x(), y: Player.shape.y() }; + }); + state.tick++; + }); + + await app.run(); +}; diff --git a/e2e/game-2d/nanoforge.config.ts b/e2e/game-2d/nanoforge.config.ts new file mode 100644 index 00000000..99f24783 --- /dev/null +++ b/e2e/game-2d/nanoforge.config.ts @@ -0,0 +1,6 @@ +import { defineConfig } from "@nanoforge-dev/config"; + +export default defineConfig({ + type: "workspace", + packages: ["apps/*"], +}); diff --git a/e2e/game-2d/package.json b/e2e/game-2d/package.json new file mode 100644 index 00000000..603c7f09 --- /dev/null +++ b/e2e/game-2d/package.json @@ -0,0 +1,19 @@ +{ + "$schema": "https://json.schemastore.org/package.json", + "name": "@nanoforge-dev/e2e-game-2d", + "version": "0.0.0", + "description": "NanoForge Engine - End-to-End test game for graphics-2d", + "type": "module", + "scripts": { + "start": "nf start" + }, + "devDependencies": { + "@nanoforge-dev/cli": "^2.3.0", + "@nanoforge-dev/config": "catalog:config", + "typescript": "catalog:core" + }, + "private": true, + "engines": { + "node": "26" + } +} diff --git a/e2e/game-2d/tsconfig.json b/e2e/game-2d/tsconfig.json new file mode 100644 index 00000000..7d6533b9 --- /dev/null +++ b/e2e/game-2d/tsconfig.json @@ -0,0 +1,6 @@ +{ + "$schema": "https://json.schemastore.org/tsconfig.json", + "extends": "../../tsconfig.json", + "include": ["apps/*/src/**/*.ts"], + "exclude": ["node_modules", "**/dist", ".nanoforge"] +} diff --git a/e2e/game-3d/.gitignore b/e2e/game-3d/.gitignore new file mode 100644 index 00000000..6016b4b4 --- /dev/null +++ b/e2e/game-3d/.gitignore @@ -0,0 +1 @@ +.nanoforge/ diff --git a/e2e/game-3d/apps/client/nanoforge.config.ts b/e2e/game-3d/apps/client/nanoforge.config.ts new file mode 100644 index 00000000..77607cbd --- /dev/null +++ b/e2e/game-3d/apps/client/nanoforge.config.ts @@ -0,0 +1,5 @@ +import { defineConfig } from "@nanoforge-dev/config"; + +export default defineConfig({ + type: "client", +}); diff --git a/e2e/game-3d/apps/client/package.json b/e2e/game-3d/apps/client/package.json new file mode 100644 index 00000000..60c65bce --- /dev/null +++ b/e2e/game-3d/apps/client/package.json @@ -0,0 +1,16 @@ +{ + "name": "e2e-game-3d-client", + "version": "0.0.0", + "type": "module", + "devDependencies": { + "@nanoforge-dev/common": "workspace:*", + "@nanoforge-dev/core": "workspace:*", + "@nanoforge-dev/ecs": "workspace:*", + "@nanoforge-dev/graphics-3d": "workspace:*", + "@nanoforge-dev/input": "workspace:*", + "@types/three": "catalog:graphics", + "three": "catalog:graphics", + "typescript": "catalog:core" + }, + "private": true +} diff --git a/e2e/game-3d/apps/client/src/main.ts b/e2e/game-3d/apps/client/src/main.ts new file mode 100644 index 00000000..a327a7b9 --- /dev/null +++ b/e2e/game-3d/apps/client/src/main.ts @@ -0,0 +1,82 @@ +import type { ClientRunOptions, Context } from "@nanoforge-dev/common"; +import { NanoforgeFactory } from "@nanoforge-dev/core"; +import { EcsLibrary, type Registry } from "@nanoforge-dev/ecs/client"; +import { type Graphics3DBackend, Graphics3DLibrary } from "@nanoforge-dev/graphics-3d"; +import { + BoxGeometry, + Color, + DirectionalLight, + HemisphereLight, + Mesh, + MeshStandardMaterial, + type Object3D, +} from "@nanoforge-dev/graphics-3d/three"; +import { InputEnum, InputLibrary } from "@nanoforge-dev/input"; + +/** Read by the Playwright tests in `e2e/graphics`. */ +export interface E2EState { + tick: number; + backend: Graphics3DBackend; + cube: { rotationY: number }; +} + +class Model { + name = "Model"; + + constructor(public object: Object3D) {} +} + +// Fixed step per tick, not per second: screenshots and rotations must not depend on frame timing. +const TURN = 0.05; + +export const main = async (options: ClientRunOptions): Promise => { + const app = NanoforgeFactory.createClient({ + tickRate: 60, + viewport: { width: 800, height: 600, fit: "contain" }, + }); + // CI browsers have no GPU: WebGL2 runs on SwiftShader there, WebGPU does not run reliably. + const graphics = new Graphics3DLibrary({ forceWebGL: true }); + const ecs = new EcsLibrary(); + const input = new InputLibrary(); + app.use(graphics); + app.use(ecs); + app.use(input); + + await app.init(options); + + const { scene, camera } = graphics; + scene.background = new Color("#20232a"); + camera.position.set(0, 1.5, 4); + camera.lookAt(0, 0, 0); + + const sun = new DirectionalLight("white", 3); + sun.position.set(3, 5, 4); + scene.add(new HemisphereLight("white", "#445566", 1), sun); + + const mesh = new Mesh(new BoxGeometry(1, 1, 1), new MeshStandardMaterial({ color: "#44aa88" })); + mesh.rotation.set(0.4, 0.6, 0); + scene.add(mesh); + + const registry = ecs.registry; + registry.addComponent(registry.spawnEntity(), new Model(mesh)); + + const state: E2EState = { + tick: 0, + backend: graphics.backend, + cube: { rotationY: mesh.rotation.y }, + }; + (window as unknown as { __e2e: E2EState }).__e2e = state; + + registry.addSystem((registry: Registry, ctx: Context) => { + registry.getZipper([Model]).forEach(({ Model }) => { + const turn = + (ctx.input.isKeyPressed(InputEnum.ArrowRight) ? TURN : 0) - + (ctx.input.isKeyPressed(InputEnum.ArrowLeft) ? TURN : 0); + Model.object.rotation.y += turn; + state.cube = { rotationY: Model.object.rotation.y }; + }); + state.tick++; + }); + + await app.run(); +}; diff --git a/e2e/game-3d/nanoforge.config.ts b/e2e/game-3d/nanoforge.config.ts new file mode 100644 index 00000000..99f24783 --- /dev/null +++ b/e2e/game-3d/nanoforge.config.ts @@ -0,0 +1,6 @@ +import { defineConfig } from "@nanoforge-dev/config"; + +export default defineConfig({ + type: "workspace", + packages: ["apps/*"], +}); diff --git a/e2e/game-3d/package.json b/e2e/game-3d/package.json new file mode 100644 index 00000000..4ea60046 --- /dev/null +++ b/e2e/game-3d/package.json @@ -0,0 +1,19 @@ +{ + "$schema": "https://json.schemastore.org/package.json", + "name": "@nanoforge-dev/e2e-game-3d", + "version": "0.0.0", + "description": "NanoForge Engine - End-to-End test game for graphics-3d", + "type": "module", + "scripts": { + "start": "nf start" + }, + "devDependencies": { + "@nanoforge-dev/cli": "^2.3.0", + "@nanoforge-dev/config": "catalog:config", + "typescript": "catalog:core" + }, + "private": true, + "engines": { + "node": "26" + } +} diff --git a/e2e/game-3d/tsconfig.json b/e2e/game-3d/tsconfig.json new file mode 100644 index 00000000..7d6533b9 --- /dev/null +++ b/e2e/game-3d/tsconfig.json @@ -0,0 +1,6 @@ +{ + "$schema": "https://json.schemastore.org/tsconfig.json", + "extends": "../../tsconfig.json", + "include": ["apps/*/src/**/*.ts"], + "exclude": ["node_modules", "**/dist", ".nanoforge"] +} diff --git a/e2e/graphics/game-2d.spec.ts b/e2e/graphics/game-2d.spec.ts new file mode 100644 index 00000000..96e99dcc --- /dev/null +++ b/e2e/graphics/game-2d.spec.ts @@ -0,0 +1,43 @@ +import { expect, test } from "@playwright/test"; + +import type { E2EState } from "../game-2d/apps/client/src/main"; +import { expectColor, gameArea, openGame, pixelAt, readState, waitTicks } from "./helpers"; + +test("boots without errors and keeps ticking", async ({ page }) => { + const errors = await openGame(page); + await waitTicks(page, 30); + await expect(gameArea(page).locator("canvas").first()).toBeVisible(); + expect(errors).toEqual([]); +}); + +test("moves the player while an arrow key is held", async ({ page }) => { + await openGame(page); + await waitTicks(page, 1); + const before = (await readState(page)).player; + + await page.keyboard.down("ArrowRight"); + await waitTicks(page, 10); + await page.keyboard.up("ArrowRight"); + await waitTicks(page, 2); + const after = (await readState(page)).player; + expect(after.x).toBeGreaterThan(before.x); + expect(after.y).toBe(before.y); + + await waitTicks(page, 10); + expect((await readState(page)).player).toEqual(after); +}); + +test("draws the shapes at their positions", async ({ page }) => { + await openGame(page); + await waitTicks(page, 5); + const png = await gameArea(page).screenshot(); + expectColor(await pixelAt(page, png, 20, 20), [0x1e, 0x1e, 0x2e]); // background + expectColor(await pixelAt(page, png, 150, 300), [0xff, 0x00, 0x00]); // player square + expectColor(await pixelAt(page, png, 600, 300), [0x00, 0xff, 0x00]); // circle +}); + +test("matches the reference screenshot", async ({ page }) => { + await openGame(page); + await waitTicks(page, 5); + await expect(gameArea(page)).toHaveScreenshot("scene.png"); +}); diff --git a/e2e/graphics/game-3d.spec.ts b/e2e/graphics/game-3d.spec.ts new file mode 100644 index 00000000..71cf0bc0 --- /dev/null +++ b/e2e/graphics/game-3d.spec.ts @@ -0,0 +1,44 @@ +import { expect, test } from "@playwright/test"; + +import type { E2EState } from "../game-3d/apps/client/src/main"; +import { expectColor, gameArea, openGame, pixelAt, readState, waitTicks } from "./helpers"; + +test("boots on WebGL without errors and keeps ticking", async ({ page }) => { + const errors = await openGame(page); + await waitTicks(page, 30); + await expect(gameArea(page).locator("canvas")).toBeVisible(); + expect((await readState(page)).backend).toBe("webgl"); + expect(errors).toEqual([]); +}); + +test("turns the cube while an arrow key is held", async ({ page }) => { + await openGame(page); + await waitTicks(page, 1); + const before = (await readState(page)).cube.rotationY; + + await page.keyboard.down("ArrowRight"); + await waitTicks(page, 10); + await page.keyboard.up("ArrowRight"); + await waitTicks(page, 2); + const after = (await readState(page)).cube.rotationY; + expect(after).toBeGreaterThan(before); + + await waitTicks(page, 10); + expect((await readState(page)).cube.rotationY).toBe(after); +}); + +test("draws the cube over the background", async ({ page }) => { + await openGame(page); + await waitTicks(page, 5); + const png = await gameArea(page).screenshot(); + expectColor(await pixelAt(page, png, 20, 20), [0x20, 0x23, 0x2a]); // background + const [r, g, b] = await pixelAt(page, png, 400, 300); // lit cube: exact shade depends on lighting + expect(g!).toBeGreaterThan(r! + 40); + expect(g!).toBeGreaterThan(b!); +}); + +test("matches the reference screenshot", async ({ page }) => { + await openGame(page); + await waitTicks(page, 5); + await expect(gameArea(page)).toHaveScreenshot("scene.png"); +}); diff --git a/e2e/graphics/helpers.ts b/e2e/graphics/helpers.ts new file mode 100644 index 00000000..4cc3b4af --- /dev/null +++ b/e2e/graphics/helpers.ts @@ -0,0 +1,64 @@ +import { type Page, expect } from "@playwright/test"; + +import type { E2EState as State2D } from "../game-2d/apps/client/src/main"; +import type { E2EState as State3D } from "../game-3d/apps/client/src/main"; + +type E2EState = State2D | State3D; + +declare global { + interface Window { + /** Set by the test games' `main`, updated every tick. */ + __e2e?: E2EState; + } +} + +/** + * Opens the game and waits until the loader screen fades out, so the game is what the player sees. + * Returns the page errors and console errors collected for the smoke checks. + */ +export const openGame = async (page: Page): Promise => { + const errors: string[] = []; + page.on("pageerror", (error) => errors.push(error.message)); + page.on("console", (message) => { + if (message.type() === "error") errors.push(message.text()); + }); + await page.goto("/"); + await expect(page.locator("#nanoforge-loader")).toBeHidden(); + return errors; +}; + +export const readState = (page: Page): Promise => + page.evaluate(() => window.__e2e as T); + +/** Waits until the game has run `ticks` more ticks than when called. */ +export const waitTicks = async (page: Page, ticks: number): Promise => { + await page.waitForFunction(() => window.__e2e !== undefined); + const { tick } = await readState(page); + await page.waitForFunction((target) => window.__e2e!.tick >= target, tick + ticks); +}; + +/** The game area as the browser composites it: what a player sees. */ +export const gameArea = (page: Page) => page.locator("#nanoforge-container"); + +/** Reads an RGB pixel from a screenshot by decoding it in the page: no PNG library needed. */ +export const pixelAt = (page: Page, png: Buffer, x: number, y: number): Promise => + page.evaluate( + async ({ src, x, y }) => { + const image = new Image(); + image.src = src; + await image.decode(); + const canvas = new OffscreenCanvas(image.width, image.height); + const context = canvas.getContext("2d")!; + context.drawImage(image, 0, 0); + return Array.from(context.getImageData(x, y, 1, 1).data.slice(0, 3)); + }, + { src: `data:image/png;base64,${png.toString("base64")}`, x, y }, + ); + +export const expectColor = (actual: number[], expected: number[], tolerance = 8): void => { + for (const [i, channel] of expected.entries()) + expect( + Math.abs(actual[i]! - channel), + `channel ${i} of ${actual} vs ${expected}`, + ).toBeLessThanOrEqual(tolerance); +}; diff --git a/package.json b/package.json index 5c271ccc..86affa18 100644 --- a/package.json +++ b/package.json @@ -26,6 +26,7 @@ "test": "pnpm run test:unit && pnpm run test:e2e", "test:unit": "turbo run test:unit --concurrency=5", "test:e2e": "vitest run --config vitest.config.e2e.ts", + "test:e2e:graphics": "playwright test", "prepare": "husky", "docs": "turbo run docs --concurrency=5 && ./scripts/sync-docs-references.sh" }, @@ -36,6 +37,7 @@ "@nanoforge-dev/actions": "catalog:ci", "@nanoforge-dev/utils-eslint-config": "workspace:*", "@nanoforge-dev/utils-prettier-config": "workspace:*", + "@playwright/test": "catalog:test", "@trivago/prettier-plugin-sort-imports": "catalog:lint", "@types/node": "catalog:core", "@vitest/coverage-v8": "catalog:test", diff --git a/playwright.config.ts b/playwright.config.ts new file mode 100644 index 00000000..40600b27 --- /dev/null +++ b/playwright.config.ts @@ -0,0 +1,36 @@ +import { defineConfig } from "@playwright/test"; + +/** Each test game (`e2e/`) is served by its own `nf start` and tested by `e2e/graphics/.spec.ts`. */ +const GAME_PORTS = { "game-2d": 3101, "game-3d": 3102 }; + +export default defineConfig({ + testDir: "e2e/graphics", + forbidOnly: !!process.env.CI, + reporter: process.env.CI ? [["github"], ["html", { open: "never" }]] : "list", + // Reference screenshots come from CI's Linux Chromium; other platforms render different pixels. + ignoreSnapshots: process.platform !== "linux", + expect: { + // Absorbs antialiasing and rasterization noise; a missing mesh or wrong camera changes far more. + toHaveScreenshot: { maxDiffPixelRatio: 0.01 }, + }, + use: { + browserName: "chromium", + viewport: { width: 800, height: 600 }, + deviceScaleFactor: 1, + // Same software WebGL as CI, so local runs exercise the same rendering path. + launchOptions: { args: ["--use-angle=swiftshader", "--enable-unsafe-swiftshader"] }, + trace: "retain-on-failure", + }, + projects: Object.entries(GAME_PORTS).map(([game, port]) => ({ + name: game, + testMatch: `${game}.spec.ts`, + use: { baseURL: `http://localhost:${port}` }, + })), + webServer: Object.entries(GAME_PORTS).map(([game, port]) => ({ + command: `pnpm exec nf build && pnpm exec nf start -p ${port}`, + cwd: `e2e/${game}`, + url: `http://localhost:${port}`, + reuseExistingServer: !process.env.CI, + timeout: 180_000, + })), +}); diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml index c9de8ad1..db659c60 100644 --- a/pnpm-lock.yaml +++ b/pnpm-lock.yaml @@ -209,6 +209,9 @@ catalogs: specifier: ^0.33.4 version: 0.33.4 test: + '@playwright/test': + specifier: 1.64.1 + version: 1.64.1 '@vitest/coverage-v8': specifier: ^4.1.11 version: 4.1.11 @@ -238,6 +241,9 @@ importers: '@nanoforge-dev/utils-prettier-config': specifier: workspace:* version: link:utils/prettier-config + '@playwright/test': + specifier: catalog:test + version: 1.64.1 '@trivago/prettier-plugin-sort-imports': specifier: catalog:lint version: 6.0.2(prettier@3.9.6)(supports-color@10.2.2) @@ -299,6 +305,78 @@ importers: specifier: catalog:core version: 6.0.3 + e2e/game-2d: + devDependencies: + '@nanoforge-dev/cli': + specifier: ^2.3.0 + version: 2.3.0(@types/node@26.4.0)(synckit@0.11.13) + '@nanoforge-dev/config': + specifier: catalog:config + version: 2.3.0(synckit@0.11.13) + typescript: + specifier: catalog:core + version: 6.0.3 + + e2e/game-2d/apps/client: + devDependencies: + '@nanoforge-dev/common': + specifier: workspace:* + version: link:../../../../packages/common + '@nanoforge-dev/core': + specifier: workspace:* + version: link:../../../../packages/core + '@nanoforge-dev/ecs': + specifier: workspace:* + version: link:../../../../modules/ecs + '@nanoforge-dev/graphics-2d': + specifier: workspace:* + version: link:../../../../modules/graphics-2d + '@nanoforge-dev/input': + specifier: workspace:* + version: link:../../../../modules/input + typescript: + specifier: catalog:core + version: 6.0.3 + + e2e/game-3d: + devDependencies: + '@nanoforge-dev/cli': + specifier: ^2.3.0 + version: 2.3.0(@types/node@26.4.0)(synckit@0.11.13) + '@nanoforge-dev/config': + specifier: catalog:config + version: 2.3.0(synckit@0.11.13) + typescript: + specifier: catalog:core + version: 6.0.3 + + e2e/game-3d/apps/client: + devDependencies: + '@nanoforge-dev/common': + specifier: workspace:* + version: link:../../../../packages/common + '@nanoforge-dev/core': + specifier: workspace:* + version: link:../../../../packages/core + '@nanoforge-dev/ecs': + specifier: workspace:* + version: link:../../../../modules/ecs + '@nanoforge-dev/graphics-3d': + specifier: workspace:* + version: link:../../../../modules/graphics-3d + '@nanoforge-dev/input': + specifier: workspace:* + version: link:../../../../modules/input + '@types/three': + specifier: catalog:graphics + version: 0.187.0 + three: + specifier: catalog:graphics + version: 0.187.0 + typescript: + specifier: catalog:core + version: 6.0.3 + e2e/game/apps/client: devDependencies: '@nanoforge-dev/asset': @@ -1738,16 +1816,16 @@ packages: resolution: {integrity: sha512-bqbrH8ulFSiZz1iisJHtHeEzj1RV/70uErCYHeW4DIhVPsWbBfWKFvg/ghAbmPk5vsj0YnhDX6DSpik4S1QoiQ==} engines: {node: '25'} - '@nanoforge-dev/loader-client@1.5.1': - resolution: {integrity: sha512-1PueGpj8DbjRcZTVVCKAkKi4A8gyBaFTkfp78fFrW47J0HZcfS8pq+AaNaBjEUOozn0E7L+U8zGf/5laxTRe1A==} + '@nanoforge-dev/loader-client@1.6.0': + resolution: {integrity: sha512-hW4jz6QSVuF9wC6CIJfE2cmHGFCXNZFEy6dBYicaRFNZ/USF7FJBjyQvwyI5MoWdjwo0A7U/zPUfRe/3TuHzgA==} engines: {node: '26'} - '@nanoforge-dev/loader-server@1.5.1': - resolution: {integrity: sha512-RNqA0zpEhUXENKu5chJ+vQOhr8qK+a7z6XePmiCJygpSScJ8p1dlWquFYNwu9dBLHBP8BhK9dSFvXjPvHAYBxQ==} + '@nanoforge-dev/loader-server@1.6.0': + resolution: {integrity: sha512-Jnc9WHUMfCo8R11qPlIFPJ0COuwX6BJ8HkSTpyTMugNKvN9dcUIwiJ72NydLDGWeTbqqXGIcpFkIkX8APYP+WQ==} engines: {node: '26'} - '@nanoforge-dev/loader-website@1.5.1': - resolution: {integrity: sha512-Ugu5CvfbsCK2wG8RXBHkkVlNHkSlXz2xXxfqglID7Cb4E8PHO0p1hbE6e7+1fWXAdFhEivGQHSI1POIvgyP1Qg==} + '@nanoforge-dev/loader-website@1.6.0': + resolution: {integrity: sha512-szo3/jPBFqUvgYeyHIN6LfzyK0GFxkgTtPJaNcqyFKEkSytUxRdplE4r+WykcMVIk7LlUwbZ56wai7RS38cPfg==} engines: {node: '26'} '@nanoforge-dev/schematics@2.3.0': @@ -2050,6 +2128,11 @@ packages: resolution: {integrity: sha512-SEeaJLb3qBNF/OaXnaR1NmmBbFYk1zC0ZH/52fATcRPLFg/p791YrcyFFy44Bo9sLaGuSuLp5Q6axbb/O+v/RA==} engines: {node: ^14.18.0 || >=16.0.0} + '@playwright/test@1.64.1': + resolution: {integrity: sha512-IaYGml/nSOiZWROfPtuIL7neuu9qDOZ3TNvNljUIrhDMxiGTgPjzj/g9p9RxpS2tSepPDRY+UwAaEeiKtUvIAg==} + engines: {node: '>=20'} + hasBin: true + '@quansync/fs@1.0.0': resolution: {integrity: sha512-4TJ3DFtlf1L5LDMaM6CanJ/0lckGNtJcMjQ1NAV6zDmA0tEHKZtxNKin8EgPaVX1YzljbxckyT2tJrpQKAtngQ==} @@ -3797,6 +3880,16 @@ packages: resolution: {integrity: sha512-qcJu88Q2IWqJsDD529JKMdwGm/dvInW4HvQnRwiH9JtihJvzGOscDtHE3x1pBKeUOTysQ8kVmLnJ2kJu7yhcGA==} engines: {node: '>=12'} + playwright-core@1.64.1: + resolution: {integrity: sha512-BC4s8y6SEVA6Q1rSxZTto8hI1KUI3xXlHGZgvGqP4IqPdI/a6FX9H29IDNz7vKo9l21b6LfYosScPL6M3xxyDQ==} + engines: {node: '>=20'} + hasBin: true + + playwright@1.64.1: + resolution: {integrity: sha512-HCrVhHr5QQuwYoswEUGTb7gGp522yflbv/ST8nF4sFWGuLjQCt17Q/EubpGGSNKYn1tsTCPZxqHhHCfVURu7UA==} + engines: {node: '>=20'} + hasBin: true + plur@5.1.0: resolution: {integrity: sha512-VP/72JeXqak2KiOzjgKtQen5y3IZHn+9GOuLDafPv0eXa47xq0At93XahYBs26MsifCQ4enGKwbjBTKgb9QJXg==} engines: {node: ^12.20.0 || ^14.13.1 || >=16.0.0} @@ -4907,8 +5000,8 @@ snapshots: '@inquirer/prompts': 8.7.2(@types/node@26.4.0) '@nanoforge-dev/config': 2.3.0(synckit@0.11.13) '@nanoforge-dev/editor': 0.1.4 - '@nanoforge-dev/loader-client': 1.5.1 - '@nanoforge-dev/loader-server': 1.5.1 + '@nanoforge-dev/loader-client': 1.6.0 + '@nanoforge-dev/loader-server': 1.6.0 '@nanoforge-dev/schematics': 2.3.0(chokidar@5.0.0) ansis: 4.4.0 bun: 1.4.2 @@ -4943,18 +5036,18 @@ snapshots: tar: 7.5.22 typescript: 6.0.3 - '@nanoforge-dev/loader-client@1.5.1': + '@nanoforge-dev/loader-client@1.6.0': dependencies: - '@nanoforge-dev/loader-website': 1.5.1 + '@nanoforge-dev/loader-website': 1.6.0 bun: 1.4.2 commander: 15.0.0 - '@nanoforge-dev/loader-server@1.5.1': + '@nanoforge-dev/loader-server@1.6.0': dependencies: bun: 1.4.2 commander: 15.0.0 - '@nanoforge-dev/loader-website@1.5.1': {} + '@nanoforge-dev/loader-website@1.6.0': {} '@nanoforge-dev/schematics@2.3.0(chokidar@5.0.0)': dependencies: @@ -5153,6 +5246,10 @@ snapshots: '@pkgr/core@0.3.6': {} + '@playwright/test@1.64.1': + dependencies: + playwright: 1.64.1 + '@quansync/fs@1.0.0': dependencies: quansync: 1.0.0 @@ -6751,6 +6848,12 @@ snapshots: picomatch@4.0.7: {} + playwright-core@1.64.1: {} + + playwright@1.64.1: + dependencies: + playwright-core: 1.64.1 + plur@5.1.0: dependencies: irregular-plurals: 3.5.0 diff --git a/pnpm-workspace.yaml b/pnpm-workspace.yaml index 56f30e61..832bb414 100644 --- a/pnpm-workspace.yaml +++ b/pnpm-workspace.yaml @@ -3,6 +3,8 @@ packages: - modules/* - utils/* - e2e/game/** + - e2e/game-2d/** + - e2e/game-3d/** - example/** allowBuilds: @@ -55,6 +57,7 @@ catalogs: network: node-datachannel: ^0.33.4 test: + '@playwright/test': 1.64.1 '@vitest/coverage-v8': ^4.1.11 vitest: ^4.1.11 From da5f8abcf8724e122bcd7af6f90144f6fd47efcc Mon Sep 17 00:00:00 2001 From: Leo Date: Fri, 6 Nov 2026 14:59:18 +0100 Subject: [PATCH 2/3] test(e2e): give software-rendered screenshots time on CI --- playwright.config.ts | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/playwright.config.ts b/playwright.config.ts index 40600b27..77755712 100644 --- a/playwright.config.ts +++ b/playwright.config.ts @@ -6,12 +6,15 @@ const GAME_PORTS = { "game-2d": 3101, "game-3d": 3102 }; export default defineConfig({ testDir: "e2e/graphics", forbidOnly: !!process.env.CI, + // CI runners render WebGL on the CPU (SwiftShader): parallel games starve each other. + workers: process.env.CI ? 1 : undefined, reporter: process.env.CI ? [["github"], ["html", { open: "never" }]] : "list", // Reference screenshots come from CI's Linux Chromium; other platforms render different pixels. ignoreSnapshots: process.platform !== "linux", expect: { // Absorbs antialiasing and rasterization noise; a missing mesh or wrong camera changes far more. - toHaveScreenshot: { maxDiffPixelRatio: 0.01 }, + // The timeout covers slow software-rendered captures: one 3D capture can take seconds on CI. + toHaveScreenshot: { maxDiffPixelRatio: 0.01, timeout: 30_000 }, }, use: { browserName: "chromium", From 05040c7c1fe9ee2d0079466d5ff395e0a4893f39 Mon Sep 17 00:00:00 2001 From: Leo Date: Fri, 6 Nov 2026 15:02:22 +0100 Subject: [PATCH 3/3] test(e2e): add reference screenshots rendered by CI's Chromium --- .../scene-game-2d-linux.png | Bin 0 -> 6220 bytes .../scene-game-3d-linux.png | Bin 0 -> 5989 bytes 2 files changed, 0 insertions(+), 0 deletions(-) create mode 100644 e2e/graphics/game-2d.spec.ts-snapshots/scene-game-2d-linux.png create mode 100644 e2e/graphics/game-3d.spec.ts-snapshots/scene-game-3d-linux.png diff --git a/e2e/graphics/game-2d.spec.ts-snapshots/scene-game-2d-linux.png b/e2e/graphics/game-2d.spec.ts-snapshots/scene-game-2d-linux.png new file mode 100644 index 0000000000000000000000000000000000000000..61e31530d97b373a283adb0f888c5b632c67eeee GIT binary patch literal 6220 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 NrMcCSJTq#<{{Y;kIhX(d literal 0 HcmV?d00001