Skip to content

A fast 2D and 3D game engine — TypeScript SDK, C++/WebAssembly core, visual editor. Ship one project to web, desktop, WeChat MiniGames, playable ads, and native Android / iOS.

feat(gates): the pixel gates have one list, and something runs it

esenginee96004b753ec
diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml
index b35df1395..7f49db718 100644
--- a/.github/workflows/build.yml
+++ b/.github/workflows/build.yml
@@ -350,163 +350,12 @@ jobs:
fi
- name: Run headless verify scenes
- working-directory: desktop
- env:
- # CI runners can't use the SUID sandbox helper (not root-owned in
- # node_modules); rendering verification doesn't need it.
- ELECTRON_DISABLE_SANDBOX: '1'
- run: |
- run_scene() {
- echo "=== $1"
- shift
- env "$@" xvfb-run -a pnpm exec electron scripts/headless-verify.mjs
- }
- run_scene sprite-default
- # Editor grid on/off pixel diff — guards the custom-draw reflected
- # material path (drawMeshWithMaterial + MaterialConstants UBO).
- run_scene editor-grid ESTELLA_VERIFY_GRID=64 ESTELLA_VERIFY_STEPS=3
- run_scene mesh2d \
- ESTELLA_VERIFY_SCENE=/scenes/mesh2d.esscene \
- ESTELLA_VERIFY_MANIFEST=/scenes/mesh2d.textures.json \
- ESTELLA_VERIFY_W=256 ESTELLA_VERIFY_H=256 ESTELLA_VERIFY_STEPS=4 \
- 'ESTELLA_VERIFY_EXPECT=[{"x":0.30,"y":0.556,"rgb":[255,0,0],"tol":40},{"x":0.70,"y":0.556,"rgb":[0,255,0],"tol":40},{"x":0.30,"y":0.40,"rgb":[255,0,0],"tol":40}]'
- run_scene parallax-shape \
- ESTELLA_VERIFY_SCENE=/scenes/parallax-shape.esscene \
- ESTELLA_VERIFY_MANIFEST=/scenes/parallax-shape.textures.json \
- ESTELLA_VERIFY_STEPS=4 \
- 'ESTELLA_VERIFY_EXPECT=[{"x":0.5,"y":0.5,"rgb":[0,255,0],"tol":40},{"x":0.25,"y":0.5,"rgb":[255,0,0],"tol":40}]'
- run_scene tilemap-flip \
- ESTELLA_VERIFY_SCENE=/scenes/tilemap-flip.esscene \
- ESTELLA_VERIFY_MANIFEST=/scenes/tilemap-flip.textures.json \
- ESTELLA_VERIFY_W=256 ESTELLA_VERIFY_H=256 ESTELLA_VERIFY_STEPS=2 \
- 'ESTELLA_VERIFY_EXPECT=[{"x":0.40,"y":0.36,"rgb":[255,0,0]},{"x":0.60,"y":0.36,"rgb":[0,255,0]},{"x":0.40,"y":0.58,"rgb":[0,0,255]},{"x":0.60,"y":0.58,"rgb":[255,255,0]}]'
- # Tiled tile (GID) object: an object-layer object with a gid renders as a
- # positioned Sprite (bottom-left anchor, tileset UV) — the green tile centered.
- run_scene tilemap-gidobj \
- ESTELLA_VERIFY_SCENE=/scenes/tilemap-gidobj.esscene \
- ESTELLA_VERIFY_MANIFEST=/scenes/tilemap-gidobj.textures.json \
- ESTELLA_VERIFY_W=256 ESTELLA_VERIFY_H=256 ESTELLA_VERIFY_STEPS=10 \
- 'ESTELLA_VERIFY_EXPECT=[{"x":0.5,"y":0.5,"rgb":[0,255,0],"tol":40},{"x":0.5,"y":0.12,"rgb":[0,0,0],"tol":30}]'
- # Parallax on a cached-chunk tilemap: the camera moves while the layer
- # model is untouched, so only the per-frame origin/parallax merge (not a
- # revision-bump rebuild) can place the tiles — guards against baking
- # camera-dependent offsets into the chunk cache.
- run_scene tilemap-parallax \
- ESTELLA_VERIFY_SCENE=/scenes/tilemap-parallax.esscene \
- ESTELLA_VERIFY_MANIFEST=/scenes/tilemap-flip.textures.json \
- ESTELLA_VERIFY_W=256 ESTELLA_VERIFY_H=256 ESTELLA_VERIFY_STEPS=2 \
- 'ESTELLA_VERIFY_MOVE={"component":"Camera","to":[48,-16],"steps":3}' \
- 'ESTELLA_VERIFY_EXPECT=[{"x":0.30,"y":0.40,"rgb":[255,0,0]},{"x":0.10,"y":0.40,"rgb":[0,0,0],"tol":20},{"x":0.50,"y":0.40,"rgb":[0,255,0]}]'
- # BitmapText's first pixel coverage: a 2-glyph synthetic .fnt atlas
- # (red A, green B) pins glyph layout, atlas UV orientation and the
- # one-DrawCommand-per-text path.
- run_scene bitmaptext \
- ESTELLA_VERIFY_SCENE=/scenes/bitmaptext.esscene \
- ESTELLA_VERIFY_W=256 ESTELLA_VERIFY_H=256 ESTELLA_VERIFY_STEPS=3 \
- 'ESTELLA_VERIFY_EXPECT=[{"x":0.40,"y":0.5,"rgb":[255,0,0],"tol":20},{"x":0.60,"y":0.5,"rgb":[0,255,0],"tol":20},{"x":0.5,"y":0.15,"rgb":[0,0,0],"tol":20}]'
- run_scene ui-mask \
- ESTELLA_VERIFY_SCENE=/scenes/ui-list-mask.esscene \
- ESTELLA_VERIFY_MANIFEST=/scenes/ui-list-mask.textures.json \
- ESTELLA_VERIFY_W=800 ESTELLA_VERIFY_H=600 \
- 'ESTELLA_VERIFY_EXPECT=[{"x":0.5,"y":0.5,"rgb":[255,0,0],"tol":60},{"x":0.9,"y":0.5,"rgb":[0,0,255],"tol":60},{"x":0.5,"y":0.85,"rgb":[0,0,255],"tol":60},{"x":0.5,"y":0.15,"rgb":[0,0,255],"tol":60}]'
- # Camera.cullingMask over sorting layers, for world content AND for UI —
- # whose `layer` encodes tree order, so it belongs to its Canvas' layer
- # instead. Layers 1 (the Canvas) and 2 (blue) are cleared from the mask, so
- # only green and yellow survive; unmasked, the full-screen HUD covers both.
- run_scene camera-culling \
- ESTELLA_VERIFY_PLAY=1 \
- ESTELLA_VERIFY_SCENE=/scenes/camera-culling.esscene \
- ESTELLA_VERIFY_MANIFEST=/scenes/camera-culling.textures.json \
- ESTELLA_VERIFY_W=320 ESTELLA_VERIFY_H=180 ESTELLA_VERIFY_STEPS=4 \
- 'ESTELLA_VERIFY_EXPECT=[{"x":0.25,"y":0.5,"rgb":[0,255,0],"tol":30},{"x":0.75,"y":0.5,"rgb":[255,255,0],"tol":30}]'
- # Where the UI layout box SITS. The camera is driven away from the origin
- # at runtime, so the box moves without resizing: the unparented Canvas
- # (a screen root) must travel with it — red/green stay in their quadrants —
- # while the Canvas parented to a world entity must not, landing blue at the
- # anchor's own world position. Before screen roots existed the whole HUD
- # stayed at the origin and this frame came back black.
- run_scene ui-screen-root \
- ESTELLA_VERIFY_PLAY=1 \
- ESTELLA_VERIFY_SCENE=/scenes/ui-screen-root.esscene \
- ESTELLA_VERIFY_MANIFEST=/scenes/ui-screen-root.textures.json \
- ESTELLA_VERIFY_W=640 ESTELLA_VERIFY_H=360 ESTELLA_VERIFY_STEPS=4 \
- 'ESTELLA_VERIFY_MOVE={"component":"Camera","to":[5000,-800],"steps":4}' \
- 'ESTELLA_VERIFY_EXPECT=[{"x":0.25,"y":0.25,"rgb":[255,0,0],"tol":30},{"x":0.75,"y":0.75,"rgb":[0,255,0],"tol":30},{"x":0.75,"y":0.25,"rgb":[0,0,255],"tol":30},{"x":0.25,"y":0.75,"rgb":[0,0,0],"tol":30}]'
- # Y-sort: same scene twice — mask on flips the overlap to the lower
- # (higher-Y-key) entity; mask off preserves submission order. Both
- # asserted so neither path can silently regress.
- run_scene ysort-on \
- ESTELLA_VERIFY_YSORT=1 \
- ESTELLA_VERIFY_SCENE=/scenes/ysort.esscene \
- ESTELLA_VERIFY_MANIFEST=/scenes/ysort.textures.json \
- ESTELLA_VERIFY_W=256 ESTELLA_VERIFY_H=256 ESTELLA_VERIFY_STEPS=2 \
- 'ESTELLA_VERIFY_EXPECT=[{"x":0.5,"y":0.5,"rgb":[0,255,0],"tol":30},{"x":0.5,"y":0.25,"rgb":[255,0,0],"tol":30},{"x":0.5,"y":0.75,"rgb":[0,255,0],"tol":30}]'
- run_scene ysort-off \
- ESTELLA_VERIFY_SCENE=/scenes/ysort.esscene \
- ESTELLA_VERIFY_MANIFEST=/scenes/ysort.textures.json \
- ESTELLA_VERIFY_W=256 ESTELLA_VERIFY_H=256 ESTELLA_VERIFY_STEPS=2 \
- 'ESTELLA_VERIFY_EXPECT=[{"x":0.5,"y":0.5,"rgb":[255,0,0],"tol":30}]'
- # Depth layers (2.5D): same scene twice, one project setting apart. The
- # near sprite is in the LOWER layer and both merge into ONE draw call, so
- # inside the batch the order is fixed by index — no amount of sorting can
- # produce the depth answer, which is what makes the pair discriminating.
- run_scene depth-on \
- ESTELLA_VERIFY_DEPTH_LAYERS=6 \
- ESTELLA_VERIFY_SCENE=/scenes/depth-layers.esscene \
- ESTELLA_VERIFY_MANIFEST=/scenes/depth-layers.textures.json \
- 'ESTELLA_VERIFY_EXPECT=[{"x":0.573,"y":0.5,"rgb":[255,0,0],"tol":60}]'
- run_scene depth-off \
- ESTELLA_VERIFY_SCENE=/scenes/depth-layers.esscene \
- ESTELLA_VERIFY_MANIFEST=/scenes/depth-layers.textures.json \
- 'ESTELLA_VERIFY_EXPECT=[{"x":0.573,"y":0.5,"rgb":[0,0,255],"tol":60}]'
- # Motion trail: move a TrailRenderer entity across the frame in play mode,
- # asserting the ribbon rasterizes as a green band (head/mid/tail) with black
- # above it — the CPU-ribbon-through-the-batch-face path.
- run_scene trail \
- ESTELLA_VERIFY_PLAY=1 \
- ESTELLA_VERIFY_SCENE=/scenes/trail.esscene \
- ESTELLA_VERIFY_MANIFEST=/scenes/trail.textures.json \
- ESTELLA_VERIFY_W=256 ESTELLA_VERIFY_H=256 \
- 'ESTELLA_VERIFY_TRAIL={"from":[-200,0],"to":[200,0],"steps":20}' \
- 'ESTELLA_VERIFY_EXPECT=[{"x":0.80,"y":0.5,"rgb":[0,255,0],"tol":50},{"x":0.5,"y":0.5,"rgb":[0,255,0],"tol":50},{"x":0.25,"y":0.5,"rgb":[0,255,0],"tol":60},{"x":0.5,"y":0.15,"rgb":[0,0,0],"tol":30}]'
- # Linear-light pipeline (colorSpace: 'linear'). The lit falloff moves 52
- # to 125 (perceptually-uniform light); the mid-gray texture must ROUND-TRIP
- # exactly (sRGB store → hw decode → blit encode = identity) — a missing
- # sRGB upload variant would read ~187, so tol 6 is a hard discriminator.
- run_scene linear-lit \
- ESTELLA_VERIFY_COLORSPACE=linear \
- ESTELLA_VERIFY_SCENE=/scenes/mat-lit-point.esscene \
- ESTELLA_VERIFY_MANIFEST=/scenes/mat-lit-point.textures.json \
- ESTELLA_VERIFY_W=256 ESTELLA_VERIFY_H=256 ESTELLA_VERIFY_STEPS=2 \
- 'ESTELLA_VERIFY_EXPECT=[{"x":0.5,"y":0.5,"rgb":[0,254,0],"tol":25},{"x":0.75,"y":0.5,"rgb":[0,125,0],"tol":25}]'
- run_scene linear-midtone \
- ESTELLA_VERIFY_COLORSPACE=linear \
- ESTELLA_VERIFY_SCENE=/scenes/srgb-midtone.esscene \
- ESTELLA_VERIFY_MANIFEST=/scenes/srgb-midtone.textures.json \
- ESTELLA_VERIFY_W=256 ESTELLA_VERIFY_H=256 ESTELLA_VERIFY_STEPS=2 \
- 'ESTELLA_VERIFY_EXPECT=[{"x":0.5,"y":0.5,"rgb":[128,128,128],"tol":6}]'
- # Post-process chain guards — bloom's first CI pixel coverage. The gamma
- # scene pins the LDR multi-pass chain; the linear scene is the HDR
- # discriminator: threshold 1.5 sits above anything an 8-bit chain can
- # store, so glow OUTSIDE the sprite (x=0.64) proves over-range light
- # survived the float intermediates — the same scene blooms NOTHING in
- # gamma mode.
- run_scene bloom-ldr \
- ESTELLA_VERIFY_PLAY=1 \
- ESTELLA_VERIFY_SCENE=/scenes/bloom-ldr.esscene \
- ESTELLA_VERIFY_MANIFEST=/scenes/bloom-ldr.textures.json \
- ESTELLA_VERIFY_W=256 ESTELLA_VERIFY_H=256 ESTELLA_VERIFY_STEPS=10 \
- 'ESTELLA_VERIFY_EXPECT=[{"x":0.61,"y":0.5,"rgb":[0,130,0],"tol":35},{"x":0.70,"y":0.5,"rgb":[0,32,0],"tol":25},{"x":0.85,"y":0.5,"rgb":[0,0,0],"tol":12}]'
- run_scene hdr-bloom \
- ESTELLA_VERIFY_PLAY=1 ESTELLA_VERIFY_COLORSPACE=linear \
- ESTELLA_VERIFY_SCENE=/scenes/hdr-bloom.esscene \
- ESTELLA_VERIFY_MANIFEST=/scenes/hdr-bloom.textures.json \
- ESTELLA_VERIFY_W=256 ESTELLA_VERIFY_H=256 ESTELLA_VERIFY_STEPS=10 \
- 'ESTELLA_VERIFY_EXPECT=[{"x":0.5,"y":0.5,"rgb":[0,255,0],"tol":25},{"x":0.64,"y":0.5,"rgb":[0,255,0],"tol":35},{"x":0.85,"y":0.5,"rgb":[0,0,0],"tol":12}]'
-
- # The MCP surface itself, both hosts: the headless one (scene tools) and the
- # real app (project → scene → entity → save → play → hot reload). Both have
- # existed as scripts somebody ran by hand; nothing ran them.
+ # The list lives in tools/renderScenes.mjs, not here: CI and a developer
+ # ran two lists that had drifted both ways — thirty-two declared gates
+ # nothing ran, five CI scenes with no name to reproduce them by.
+ # --no-build: the renderer bundle is already built two steps up.
+ run: node tools/verify-render.mjs --tier pr --no-build
+
- name: Run MCP end-to-end
working-directory: desktop
env:
@@ -549,82 +398,9 @@ jobs:
# runner verifies the second backend for real: WGSL twins, the reflected
# material path, the editor grid, and the async readback (material preview).
- name: Run headless verify scenes (WebGPU / SwiftShader)
- working-directory: desktop
- env:
- ELECTRON_DISABLE_SANDBOX: '1'
- ESTELLA_VERIFY_BACKEND: webgpu
- ESTELLA_VERIFY_WEBGPU_ADAPTER: swiftshader
- run: |
- run_scene() {
- echo "=== $1"
- shift
- env "$@" xvfb-run -a pnpm exec electron scripts/headless-verify.mjs
- }
- run_scene webgpu-sprite-grid ESTELLA_VERIFY_GRID=64 ESTELLA_VERIFY_STEPS=3
- run_scene webgpu-parallax-shape \
- ESTELLA_VERIFY_SCENE=/scenes/parallax-shape.esscene \
- ESTELLA_VERIFY_MANIFEST=/scenes/parallax-shape.textures.json \
- ESTELLA_VERIFY_STEPS=4 \
- 'ESTELLA_VERIFY_EXPECT=[{"x":0.5,"y":0.5,"rgb":[0,255,0],"tol":40},{"x":0.25,"y":0.5,"rgb":[255,0,0],"tol":40}]'
- # Tolerances tightened after the readback fix (force-color-profile=srgb):
- # capturePage was display-referred, so wide-gamut machines read a fake
- # "R/B bleed" here. Deterministic now — GL and WebGPU read identical.
- run_scene webgpu-mat-lit-point \
- ESTELLA_VERIFY_SCENE=/scenes/mat-lit-point.esscene \
- ESTELLA_VERIFY_MANIFEST=/scenes/mat-lit-point.textures.json \
- ESTELLA_VERIFY_W=256 ESTELLA_VERIFY_H=256 ESTELLA_VERIFY_STEPS=2 \
- 'ESTELLA_VERIFY_EXPECT=[{"x":0.5,"y":0.5,"rgb":[0,253,0],"tol":25},{"x":0.75,"y":0.5,"rgb":[0,52,0],"tol":25}]'
- run_scene webgpu-mat-tint-preview \
- ESTELLA_VERIFY_SCENE=/scenes/mat-tint.esscene \
- ESTELLA_VERIFY_MANIFEST=/scenes/mat-tint.textures.json \
- ESTELLA_VERIFY_W=256 ESTELLA_VERIFY_H=256 ESTELLA_VERIFY_STEPS=2 \
- 'ESTELLA_VERIFY_EXPECT=[{"x":0.5,"y":0.5,"rgb":[255,0,0],"tol":40}]' \
- 'ESTELLA_VERIFY_PREVIEW={"w":64,"h":64,"rgb":[255,0,0],"tol":45}'
- run_scene webgpu-ysort \
- ESTELLA_VERIFY_YSORT=1 \
- ESTELLA_VERIFY_SCENE=/scenes/ysort.esscene \
- ESTELLA_VERIFY_MANIFEST=/scenes/ysort.textures.json \
- ESTELLA_VERIFY_W=256 ESTELLA_VERIFY_H=256 ESTELLA_VERIFY_STEPS=2 \
- 'ESTELLA_VERIFY_EXPECT=[{"x":0.5,"y":0.5,"rgb":[0,255,0],"tol":30},{"x":0.5,"y":0.25,"rgb":[255,0,0],"tol":30},{"x":0.5,"y":0.75,"rgb":[0,255,0],"tol":30}]'
- run_scene webgpu-trail \
- ESTELLA_VERIFY_PLAY=1 \
- ESTELLA_VERIFY_SCENE=/scenes/trail.esscene \
- ESTELLA_VERIFY_MANIFEST=/scenes/trail.textures.json \
- ESTELLA_VERIFY_W=256 ESTELLA_VERIFY_H=256 \
- 'ESTELLA_VERIFY_TRAIL={"from":[-200,0],"to":[200,0],"steps":20}' \
- 'ESTELLA_VERIFY_EXPECT=[{"x":0.80,"y":0.5,"rgb":[0,255,0],"tol":50},{"x":0.5,"y":0.5,"rgb":[0,255,0],"tol":50},{"x":0.25,"y":0.5,"rgb":[0,255,0],"tol":60},{"x":0.5,"y":0.15,"rgb":[0,0,0],"tol":30}]'
- # Linear pipeline on the second backend — same expectations as the GL
- # linear scenes (backends are each other's gold). The mid-gray round-trip
- # additionally proves the ENGINE-SIDE sRGB upload promotion: on WebGPU
- # every texture uploads through rm_createTexture, so a missing SRGB8A8
- # promotion would read ~187 here while GL (raw-GL upload path) stayed 128.
- run_scene webgpu-linear-lit \
- ESTELLA_VERIFY_COLORSPACE=linear \
- ESTELLA_VERIFY_SCENE=/scenes/mat-lit-point.esscene \
- ESTELLA_VERIFY_MANIFEST=/scenes/mat-lit-point.textures.json \
- ESTELLA_VERIFY_W=256 ESTELLA_VERIFY_H=256 ESTELLA_VERIFY_STEPS=2 \
- 'ESTELLA_VERIFY_EXPECT=[{"x":0.5,"y":0.5,"rgb":[0,254,0],"tol":25},{"x":0.75,"y":0.5,"rgb":[0,125,0],"tol":25}]'
- run_scene webgpu-linear-midtone \
- ESTELLA_VERIFY_COLORSPACE=linear \
- ESTELLA_VERIFY_SCENE=/scenes/srgb-midtone.esscene \
- ESTELLA_VERIFY_MANIFEST=/scenes/srgb-midtone.textures.json \
- ESTELLA_VERIFY_W=256 ESTELLA_VERIFY_H=256 ESTELLA_VERIFY_STEPS=2 \
- 'ESTELLA_VERIFY_EXPECT=[{"x":0.5,"y":0.5,"rgb":[128,128,128],"tol":6}]'
- # Bloom on the second backend — measured byte-identical to GL after the
- # bind-group eviction fix (stale-id aliasing silently zeroed the WGSL
- # chain's params); these scenes keep that regression impossible to miss.
- run_scene webgpu-bloom-ldr \
- ESTELLA_VERIFY_PLAY=1 \
- ESTELLA_VERIFY_SCENE=/scenes/bloom-ldr.esscene \
- ESTELLA_VERIFY_MANIFEST=/scenes/bloom-ldr.textures.json \
- ESTELLA_VERIFY_W=256 ESTELLA_VERIFY_H=256 ESTELLA_VERIFY_STEPS=10 \
- 'ESTELLA_VERIFY_EXPECT=[{"x":0.61,"y":0.5,"rgb":[0,130,0],"tol":35},{"x":0.70,"y":0.5,"rgb":[0,32,0],"tol":25},{"x":0.85,"y":0.5,"rgb":[0,0,0],"tol":12}]'
- run_scene webgpu-hdr-bloom \
- ESTELLA_VERIFY_PLAY=1 ESTELLA_VERIFY_COLORSPACE=linear \
- ESTELLA_VERIFY_SCENE=/scenes/hdr-bloom.esscene \
- ESTELLA_VERIFY_MANIFEST=/scenes/hdr-bloom.textures.json \
- ESTELLA_VERIFY_W=256 ESTELLA_VERIFY_H=256 ESTELLA_VERIFY_STEPS=10 \
- 'ESTELLA_VERIFY_EXPECT=[{"x":0.5,"y":0.5,"rgb":[0,255,0],"tol":25},{"x":0.64,"y":0.5,"rgb":[0,255,0],"tol":35},{"x":0.85,"y":0.5,"rgb":[0,0,0],"tol":12}]'
+ # Which scenes run on the second backend, and the two whose tolerances
+ # differ, are declared per scene in tools/renderScenes.mjs.
+ run: node tools/verify-render.mjs --tier pr --backend webgpu --no-build
# The native runtime, judged by pixels on a machine with no GPU.
#
diff --git a/desktop/package.json b/desktop/package.json
index 04055f589..8efb3ce39 100644
--- a/desktop/package.json
+++ b/desktop/package.json
@@ -16,60 +16,61 @@
"typecheck": "tsc --noEmit",
"test": "vitest run",
"test:watch": "vitest",
- "verify:render": "vite build && electron scripts/headless-verify.mjs",
- "verify:render:video": "vite build && ESTELLA_VERIFY_PLAY=1 ESTELLA_VERIFY_SETTLE_MS=2500 ESTELLA_VERIFY_SCENE=/scenes/video-playback.esscene ESTELLA_VERIFY_MANIFEST=/scenes/video-playback.textures.json ESTELLA_VERIFY_W=256 ESTELLA_VERIFY_H=256 ESTELLA_VERIFY_EXPECT=\"[{\\\"x\\\":0.5,\\\"y\\\":0.25,\\\"rgb\\\":[255,0,0],\\\"tol\\\":90},{\\\"x\\\":0.5,\\\"y\\\":0.75,\\\"rgb\\\":[0,0,255],\\\"tol\\\":90}]\" electron scripts/headless-verify.mjs",
- "verify:render:video:ui": "vite build && ESTELLA_VERIFY_PLAY=1 ESTELLA_VERIFY_SETTLE_MS=2500 ESTELLA_VERIFY_SCENE=/scenes/video-ui.esscene ESTELLA_VERIFY_MANIFEST=/scenes/video-ui.textures.json ESTELLA_VERIFY_W=800 ESTELLA_VERIFY_H=600 ESTELLA_VERIFY_EXPECT=\"[{\\\"x\\\":0.5,\\\"y\\\":0.25,\\\"rgb\\\":[255,0,0],\\\"tol\\\":90},{\\\"x\\\":0.5,\\\"y\\\":0.75,\\\"rgb\\\":[0,0,255],\\\"tol\\\":90}]\" electron scripts/headless-verify.mjs",
+ "verify:render": "node ../tools/verify-render.mjs --only sprite-default",
+ "verify:render:video": "node ../tools/verify-render.mjs --only video",
+ "verify:render:video:ui": "node ../tools/verify-render.mjs --only video-ui",
"editor:mcp": "node scripts/editor-mcp.mjs",
"editor:mcp:build": "vite build && node scripts/editor-mcp.mjs",
"editor:mcp:e2e": "vite build && node scripts/editor-mcp-e2e.mjs",
"editor:mcp:editor-e2e": "vite build && node scripts/editor-mcp-editor-e2e.mjs",
"editor:shot": "vite build && electron .",
- "verify:render:spine": "vite build && ESTELLA_VERIFY_SCENE=/scenes/spine-test.esscene ESTELLA_VERIFY_MANIFEST=/scenes/spine-test.textures.json electron scripts/headless-verify.mjs",
- "verify:render:particles": "vite build && ESTELLA_VERIFY_PLAY=1 ESTELLA_VERIFY_SCENE=/scenes/particle-demo.esscene ESTELLA_VERIFY_MANIFEST=/scenes/particle-demo.textures.json ESTELLA_VERIFY_STEPS=90 electron scripts/headless-verify.mjs",
- "verify:render:particles:gradient": "vite build && ESTELLA_VERIFY_PLAY=1 ESTELLA_VERIFY_SCENE=/scenes/particle-gradient.esscene ESTELLA_VERIFY_MANIFEST=/scenes/particle-gradient.textures.json ESTELLA_VERIFY_W=256 ESTELLA_VERIFY_H=256 ESTELLA_VERIFY_STEPS=20 ESTELLA_VERIFY_EXPECT=\"[{\\\"x\\\":0.5,\\\"y\\\":0.5,\\\"rgb\\\":[0,255,0],\\\"tol\\\":90}]\" electron scripts/headless-verify.mjs",
- "verify:render:particles:sizecurve": "vite build && ESTELLA_VERIFY_PLAY=1 ESTELLA_VERIFY_SCENE=/scenes/particle-sizecurve.esscene ESTELLA_VERIFY_MANIFEST=/scenes/particle-sizecurve.textures.json ESTELLA_VERIFY_W=256 ESTELLA_VERIFY_H=256 ESTELLA_VERIFY_STEPS=20 ESTELLA_VERIFY_EXPECT=\"[{\\\"x\\\":0.5,\\\"y\\\":0.5,\\\"rgb\\\":[0,255,0],\\\"tol\\\":110},{\\\"x\\\":0.28,\\\"y\\\":0.5,\\\"rgb\\\":[0,0,0],\\\"tol\\\":50}]\" electron scripts/headless-verify.mjs",
- "verify:render:postprocess": "vite build && ESTELLA_VERIFY_PLAY=1 ESTELLA_VERIFY_SCENE=/scenes/postprocess-effects.esscene ESTELLA_VERIFY_MANIFEST=/scenes/postprocess-effects.textures.json ESTELLA_VERIFY_STEPS=30 electron scripts/headless-verify.mjs",
- "verify:render:text": "vite build && ESTELLA_VERIFY_SCENE=/scenes/ui-text-sdf.esscene ESTELLA_VERIFY_MANIFEST=/scenes/ui-text-sdf.textures.json electron scripts/headless-verify.mjs",
- "verify:render:text:rect": "vite build && ESTELLA_VERIFY_SCENE=/scenes/ui-text-rect.esscene ESTELLA_VERIFY_MANIFEST=/scenes/ui-text-sdf.textures.json electron scripts/headless-verify.mjs",
- "verify:render:uinode": "vite build && ESTELLA_VERIFY_SCENE=/scenes/ui-node-flex.esscene ESTELLA_VERIFY_MANIFEST=/scenes/ui-node-flex.textures.json ESTELLA_VERIFY_W=800 ESTELLA_VERIFY_H=600 electron scripts/headless-verify.mjs",
- "verify:render:ui:screenroot": "vite build && ESTELLA_VERIFY_PLAY=1 ESTELLA_VERIFY_SCENE=/scenes/ui-screen-root.esscene ESTELLA_VERIFY_MANIFEST=/scenes/ui-screen-root.textures.json ESTELLA_VERIFY_W=640 ESTELLA_VERIFY_H=360 ESTELLA_VERIFY_STEPS=4 ESTELLA_VERIFY_MOVE='{\"component\":\"Camera\",\"to\":[5000,-800],\"steps\":4}' ESTELLA_VERIFY_EXPECT='[{\"x\":0.25,\"y\":0.25,\"rgb\":[255,0,0],\"tol\":30},{\"x\":0.75,\"y\":0.75,\"rgb\":[0,255,0],\"tol\":30},{\"x\":0.75,\"y\":0.25,\"rgb\":[0,0,255],\"tol\":30},{\"x\":0.25,\"y\":0.75,\"rgb\":[0,0,0],\"tol\":30}]' electron scripts/headless-verify.mjs",
- "verify:render:culling": "vite build && ESTELLA_VERIFY_PLAY=1 ESTELLA_VERIFY_SCENE=/scenes/camera-culling.esscene ESTELLA_VERIFY_MANIFEST=/scenes/camera-culling.textures.json ESTELLA_VERIFY_W=320 ESTELLA_VERIFY_H=180 ESTELLA_VERIFY_STEPS=4 ESTELLA_VERIFY_EXPECT='[{\"x\":0.25,\"y\":0.5,\"rgb\":[0,255,0],\"tol\":30},{\"x\":0.75,\"y\":0.5,\"rgb\":[255,255,0],\"tol\":30}]' electron scripts/headless-verify.mjs",
- "verify:render:uimask": "vite build && ESTELLA_VERIFY_SCENE=/scenes/ui-list-mask.esscene ESTELLA_VERIFY_MANIFEST=/scenes/ui-list-mask.textures.json ESTELLA_VERIFY_W=800 ESTELLA_VERIFY_H=600 ESTELLA_VERIFY_EXPECT=\"[{\\\"x\\\":0.5,\\\"y\\\":0.5,\\\"rgb\\\":[255,0,0],\\\"tol\\\":60},{\\\"x\\\":0.9,\\\"y\\\":0.5,\\\"rgb\\\":[0,0,255],\\\"tol\\\":60},{\\\"x\\\":0.5,\\\"y\\\":0.85,\\\"rgb\\\":[0,0,255],\\\"tol\\\":60},{\\\"x\\\":0.5,\\\"y\\\":0.15,\\\"rgb\\\":[0,0,255],\\\"tol\\\":60}]\" electron scripts/headless-verify.mjs",
- "verify:render:filled": "vite build && ESTELLA_VERIFY_SCENE=/scenes/ui-visual-filled.esscene ESTELLA_VERIFY_MANIFEST=/scenes/ui-visual-filled.textures.json ESTELLA_VERIFY_W=800 ESTELLA_VERIFY_H=600 ESTELLA_VERIFY_STEPS=2 ESTELLA_VERIFY_EXPECT=\"[{\\\"x\\\":0.18,\\\"y\\\":0.5,\\\"rgb\\\":[0,255,0],\\\"tol\\\":40},{\\\"x\\\":0.40,\\\"y\\\":0.5,\\\"rgb\\\":[255,0,0],\\\"tol\\\":40},{\\\"x\\\":0.58,\\\"y\\\":0.75,\\\"rgb\\\":[0,255,0],\\\"tol\\\":40},{\\\"x\\\":0.58,\\\"y\\\":0.25,\\\"rgb\\\":[255,0,0],\\\"tol\\\":40},{\\\"x\\\":0.30,\\\"y\\\":0.20,\\\"rgb\\\":[0,255,0],\\\"tol\\\":40},{\\\"x\\\":0.20,\\\"y\\\":0.333,\\\"rgb\\\":[255,0,0],\\\"tol\\\":40},{\\\"x\\\":0.30,\\\"y\\\":0.833,\\\"rgb\\\":[0,255,0],\\\"tol\\\":40},{\\\"x\\\":0.20,\\\"y\\\":0.70,\\\"rgb\\\":[255,0,0],\\\"tol\\\":40}]\" electron scripts/headless-verify.mjs",
- "verify:render:tilemap": "vite build && ESTELLA_VERIFY_SCENE=/scenes/tilemap-flip.esscene ESTELLA_VERIFY_MANIFEST=/scenes/tilemap-flip.textures.json ESTELLA_VERIFY_W=256 ESTELLA_VERIFY_H=256 ESTELLA_VERIFY_STEPS=2 ESTELLA_VERIFY_EXPECT=\"[{\\\"x\\\":0.40,\\\"y\\\":0.36,\\\"rgb\\\":[255,0,0]},{\\\"x\\\":0.60,\\\"y\\\":0.36,\\\"rgb\\\":[0,255,0]},{\\\"x\\\":0.40,\\\"y\\\":0.58,\\\"rgb\\\":[0,0,255]},{\\\"x\\\":0.60,\\\"y\\\":0.58,\\\"rgb\\\":[255,255,0]}]\" electron scripts/headless-verify.mjs",
- "verify:render:tilemap:transform": "vite build && ESTELLA_VERIFY_SCENE=/scenes/tilemap-transform.esscene ESTELLA_VERIFY_MANIFEST=/scenes/tilemap-transform.textures.json ESTELLA_VERIFY_W=256 ESTELLA_VERIFY_H=256 ESTELLA_VERIFY_STEPS=2 ESTELLA_VERIFY_EXPECT=\"[{\\\"x\\\":0.40,\\\"y\\\":0.36,\\\"rgb\\\":[255,255,0]},{\\\"x\\\":0.60,\\\"y\\\":0.36,\\\"rgb\\\":[0,255,0]},{\\\"x\\\":0.40,\\\"y\\\":0.58,\\\"rgb\\\":[0,0,255]},{\\\"x\\\":0.60,\\\"y\\\":0.58,\\\"rgb\\\":[255,0,0]}]\" electron scripts/headless-verify.mjs",
- "verify:render:tilemap:multiset": "vite build && ESTELLA_VERIFY_SCENE=/scenes/tilemap-multiset.esscene ESTELLA_VERIFY_MANIFEST=/scenes/tilemap-multiset.textures.json ESTELLA_VERIFY_W=256 ESTELLA_VERIFY_H=256 ESTELLA_VERIFY_STEPS=6 ESTELLA_VERIFY_EXPECT=\"[{\\\"x\\\":0.40,\\\"y\\\":0.36,\\\"rgb\\\":[255,0,0]},{\\\"x\\\":0.60,\\\"y\\\":0.36,\\\"rgb\\\":[0,255,0]},{\\\"x\\\":0.40,\\\"y\\\":0.58,\\\"rgb\\\":[0,0,255]},{\\\"x\\\":0.60,\\\"y\\\":0.58,\\\"rgb\\\":[255,255,0]}]\" electron scripts/headless-verify.mjs",
- "verify:render:tilemap:spacing": "vite build && ESTELLA_VERIFY_SCENE=/scenes/tilemap-spacing.esscene ESTELLA_VERIFY_MANIFEST=/scenes/tilemap-spacing.textures.json ESTELLA_VERIFY_W=256 ESTELLA_VERIFY_H=256 ESTELLA_VERIFY_STEPS=6 ESTELLA_VERIFY_EXPECT=\"[{\\\"x\\\":0.40,\\\"y\\\":0.36,\\\"rgb\\\":[255,0,0]},{\\\"x\\\":0.60,\\\"y\\\":0.36,\\\"rgb\\\":[0,255,0]},{\\\"x\\\":0.40,\\\"y\\\":0.58,\\\"rgb\\\":[0,0,255]},{\\\"x\\\":0.60,\\\"y\\\":0.58,\\\"rgb\\\":[255,255,0]}]\" electron scripts/headless-verify.mjs",
- "verify:render:tilemap:gidobj": "vite build && ESTELLA_VERIFY_SCENE=/scenes/tilemap-gidobj.esscene ESTELLA_VERIFY_MANIFEST=/scenes/tilemap-gidobj.textures.json ESTELLA_VERIFY_W=256 ESTELLA_VERIFY_H=256 ESTELLA_VERIFY_STEPS=10 ESTELLA_VERIFY_EXPECT='[{\"x\":0.5,\"y\":0.5,\"rgb\":[0,255,0],\"tol\":40},{\"x\":0.5,\"y\":0.12,\"rgb\":[0,0,0],\"tol\":30},{\"x\":0.8125,\"y\":0.375,\"rgb\":[0,0,255],\"tol\":40},{\"x\":0.9375,\"y\":0.375,\"rgb\":[255,255,0],\"tol\":40},{\"x\":0.875,\"y\":0.8125,\"rgb\":[0,0,255],\"tol\":40},{\"x\":0.875,\"y\":0.9375,\"rgb\":[255,255,0],\"tol\":40}]' electron scripts/headless-verify.mjs",
- "verify:render:material": "vite build && ESTELLA_VERIFY_SCENE=/scenes/mat-tint.esscene ESTELLA_VERIFY_MANIFEST=/scenes/mat-tint.textures.json ESTELLA_VERIFY_W=256 ESTELLA_VERIFY_H=256 ESTELLA_VERIFY_STEPS=2 ESTELLA_VERIFY_EXPECT=\"[{\\\"x\\\":0.5,\\\"y\\\":0.5,\\\"rgb\\\":[255,0,0],\\\"tol\\\":40}]\" electron scripts/headless-verify.mjs",
- "verify:render:ktx2": "vite build && ESTELLA_VERIFY_SCENE=/scenes/ktx2-sprite.esscene ESTELLA_VERIFY_MANIFEST=/scenes/ktx2-sprite.textures.json ESTELLA_VERIFY_W=256 ESTELLA_VERIFY_H=256 ESTELLA_VERIFY_STEPS=2 ESTELLA_VERIFY_EXPECT=\"[{\\\"x\\\":0.5,\\\"y\\\":0.5,\\\"rgb\\\":[0,180,0],\\\"tol\\\":50}]\" electron scripts/headless-verify.mjs",
+ "verify:render:spine": "node ../tools/verify-render.mjs --only spine",
+ "verify:render:particles": "node ../tools/verify-render.mjs --only particles",
+ "verify:render:particles:gradient": "node ../tools/verify-render.mjs --only particles-gradient",
+ "verify:render:particles:sizecurve": "node ../tools/verify-render.mjs --only particles-sizecurve",
+ "verify:render:postprocess": "node ../tools/verify-render.mjs --only postprocess",
+ "verify:render:text": "node ../tools/verify-render.mjs --only text",
+ "verify:render:text:rect": "node ../tools/verify-render.mjs --only text-rect",
+ "verify:render:uinode": "node ../tools/verify-render.mjs --only uinode",
+ "verify:render:ui:screenroot": "node ../tools/verify-render.mjs --only ui-screen-root",
+ "verify:render:culling": "node ../tools/verify-render.mjs --only camera-culling",
+ "verify:render:uimask": "node ../tools/verify-render.mjs --only ui-mask",
+ "verify:render:filled": "node ../tools/verify-render.mjs --only filled",
+ "verify:render:tilemap": "node ../tools/verify-render.mjs --only tilemap-flip",
+ "verify:render:tilemap:transform": "node ../tools/verify-render.mjs --only tilemap-transform",
+ "verify:render:tilemap:multiset": "node ../tools/verify-render.mjs --only tilemap-multiset",
+ "verify:render:tilemap:spacing": "node ../tools/verify-render.mjs --only tilemap-spacing",
+ "verify:render:tilemap:gidobj": "node ../tools/verify-render.mjs --only tilemap-gidobj",
+ "verify:render:material": "node ../tools/verify-render.mjs --only material",
+ "verify:render:ktx2": "node ../tools/verify-render.mjs --only ktx2",
"verify:render:cooked": "vite build && ESTELLA_COOK_FIXTURE=1 vitest run tests/cooked-verify-fixture.test.ts && electron scripts/headless-cooked-verify.mjs",
"verify:render:hotupdate": "ESTELLA_HOTUPDATE_FIXTURE=1 vitest run tests/hotupdate-verify-fixture.test.ts && electron scripts/headless-hotupdate-verify.mjs",
- "verify:render:material:instance": "vite build && ESTELLA_VERIFY_SCENE=/scenes/mat-instance.esscene ESTELLA_VERIFY_MANIFEST=/scenes/mat-instance.textures.json ESTELLA_VERIFY_W=256 ESTELLA_VERIFY_H=256 ESTELLA_VERIFY_STEPS=2 ESTELLA_VERIFY_EXPECT=\"[{\\\"x\\\":0.5,\\\"y\\\":0.5,\\\"rgb\\\":[0,255,0],\\\"tol\\\":40}]\" electron scripts/headless-verify.mjs",
- "verify:render:material:texture": "vite build && ESTELLA_VERIFY_SCENE=/scenes/mat-tex.esscene ESTELLA_VERIFY_MANIFEST=/scenes/mat-tex.textures.json ESTELLA_VERIFY_W=256 ESTELLA_VERIFY_H=256 ESTELLA_VERIFY_STEPS=2 ESTELLA_VERIFY_EXPECT=\"[{\\\"x\\\":0.5,\\\"y\\\":0.5,\\\"rgb\\\":[0,255,0],\\\"tol\\\":50}]\" electron scripts/headless-verify.mjs",
- "verify:render:material:switch": "vite build && ESTELLA_VERIFY_SCENE=/scenes/mat-sw.esscene ESTELLA_VERIFY_MANIFEST=/scenes/mat-sw.textures.json ESTELLA_VERIFY_W=256 ESTELLA_VERIFY_H=256 ESTELLA_VERIFY_STEPS=2 ESTELLA_VERIFY_EXPECT=\"[{\\\"x\\\":0.25,\\\"y\\\":0.5,\\\"rgb\\\":[255,0,0],\\\"tol\\\":50},{\\\"x\\\":0.75,\\\"y\\\":0.5,\\\"rgb\\\":[0,255,0],\\\"tol\\\":50}]\" electron scripts/headless-verify.mjs",
- "verify:render:material:lit": "vite build && ESTELLA_VERIFY_SCENE=/scenes/mat-lit.esscene ESTELLA_VERIFY_MANIFEST=/scenes/mat-lit.textures.json ESTELLA_VERIFY_W=256 ESTELLA_VERIFY_H=256 ESTELLA_VERIFY_STEPS=2 ESTELLA_VERIFY_EXPECT=\"[{\\\"x\\\":0.5,\\\"y\\\":0.5,\\\"rgb\\\":[0,255,0],\\\"tol\\\":50}]\" electron scripts/headless-verify.mjs",
- "verify:render:material:lit:point": "vite build && ESTELLA_VERIFY_SCENE=/scenes/mat-lit-point.esscene ESTELLA_VERIFY_MANIFEST=/scenes/mat-lit-point.textures.json ESTELLA_VERIFY_W=256 ESTELLA_VERIFY_H=256 ESTELLA_VERIFY_STEPS=2 ESTELLA_VERIFY_EXPECT=\"[{\\\"x\\\":0.5,\\\"y\\\":0.5,\\\"rgb\\\":[0,255,0],\\\"tol\\\":50},{\\\"x\\\":0.75,\\\"y\\\":0.5,\\\"rgb\\\":[0,64,0],\\\"tol\\\":60}]\" electron scripts/headless-verify.mjs",
- "verify:render:material:lit:normal": "vite build && ESTELLA_VERIFY_SCENE=/scenes/mat-lit-normal.esscene ESTELLA_VERIFY_MANIFEST=/scenes/mat-lit-normal.textures.json ESTELLA_VERIFY_W=256 ESTELLA_VERIFY_H=256 ESTELLA_VERIFY_STEPS=2 ESTELLA_VERIFY_EXPECT=\"[{\\\"x\\\":0.333,\\\"y\\\":0.5,\\\"rgb\\\":[0,252,0],\\\"tol\\\":45},{\\\"x\\\":0.667,\\\"y\\\":0.5,\\\"rgb\\\":[0,36,0],\\\"tol\\\":50}]\" electron scripts/headless-verify.mjs",
- "verify:render:material:lit:spot": "vite build && ESTELLA_VERIFY_SCENE=/scenes/mat-lit-spot.esscene ESTELLA_VERIFY_MANIFEST=/scenes/mat-lit-spot.textures.json ESTELLA_VERIFY_W=256 ESTELLA_VERIFY_H=256 ESTELLA_VERIFY_STEPS=2 ESTELLA_VERIFY_EXPECT=\"[{\\\"x\\\":0.5,\\\"y\\\":0.5,\\\"rgb\\\":[0,228,0],\\\"tol\\\":55},{\\\"x\\\":0.75,\\\"y\\\":0.5,\\\"rgb\\\":[0,0,0],\\\"tol\\\":35}]\" electron scripts/headless-verify.mjs",
- "verify:render:material:lit:flatnormal": "vite build && ESTELLA_VERIFY_SCENE=/scenes/mat-lit-flatnormal.esscene ESTELLA_VERIFY_MANIFEST=/scenes/mat-lit-flatnormal.textures.json ESTELLA_VERIFY_W=256 ESTELLA_VERIFY_H=256 ESTELLA_VERIFY_STEPS=2 ESTELLA_VERIFY_EXPECT=\"[{\\\"x\\\":0.5,\\\"y\\\":0.5,\\\"rgb\\\":[0,255,0],\\\"tol\\\":30}]\" electron scripts/headless-verify.mjs",
- "verify:render:sprite:lit": "vite build && ESTELLA_VERIFY_SCENE=/scenes/sprite-lit.esscene ESTELLA_VERIFY_MANIFEST=/scenes/sprite-lit.textures.json ESTELLA_VERIFY_W=256 ESTELLA_VERIFY_H=256 ESTELLA_VERIFY_STEPS=2 ESTELLA_VERIFY_EXPECT=\"[{\\\"x\\\":0.5,\\\"y\\\":0.5,\\\"rgb\\\":[0,255,0],\\\"tol\\\":30}]\" electron scripts/headless-verify.mjs",
- "verify:render:material:builtin:lit": "vite build && ESTELLA_VERIFY_SCENE=/scenes/mat-builtin-lit.esscene ESTELLA_VERIFY_MANIFEST=/scenes/mat-builtin-lit.textures.json ESTELLA_VERIFY_W=256 ESTELLA_VERIFY_H=256 ESTELLA_VERIFY_STEPS=2 ESTELLA_VERIFY_EXPECT=\"[{\\\"x\\\":0.5,\\\"y\\\":0.5,\\\"rgb\\\":[0,255,0],\\\"tol\\\":30}]\" electron scripts/headless-verify.mjs",
- "verify:render:material:dissolve": "vite build && ESTELLA_VERIFY_SCENE=/scenes/mat-dissolve.esscene ESTELLA_VERIFY_MANIFEST=/scenes/mat-dissolve.textures.json ESTELLA_VERIFY_W=256 ESTELLA_VERIFY_H=256 ESTELLA_VERIFY_STEPS=2 ESTELLA_VERIFY_EXPECT=\"[{\\\"x\\\":0.5,\\\"y\\\":0.5,\\\"rgb\\\":[255,0,0],\\\"tol\\\":30}]\" electron scripts/headless-verify.mjs",
- "verify:render:material:graph": "vite build && ESTELLA_VERIFY_SCENE=/scenes/mat-graph.esscene ESTELLA_VERIFY_MANIFEST=/scenes/mat-graph.textures.json ESTELLA_VERIFY_W=256 ESTELLA_VERIFY_H=256 ESTELLA_VERIFY_STEPS=2 ESTELLA_VERIFY_EXPECT=\"[{\\\"x\\\":0.5,\\\"y\\\":0.5,\\\"rgb\\\":[255,0,0],\\\"tol\\\":40}]\" electron scripts/headless-verify.mjs",
- "verify:render:material:preview": "vite build && ESTELLA_VERIFY_SCENE=/scenes/mat-tint.esscene ESTELLA_VERIFY_MANIFEST=/scenes/mat-tint.textures.json ESTELLA_VERIFY_W=256 ESTELLA_VERIFY_H=256 ESTELLA_VERIFY_STEPS=2 ESTELLA_VERIFY_PREVIEW=\"{\\\"w\\\":64,\\\"h\\\":64,\\\"rgb\\\":[255,0,0],\\\"tol\\\":45}\" electron scripts/headless-verify.mjs",
- "verify:render:ysort": "vite build && ESTELLA_VERIFY_YSORT=1 ESTELLA_VERIFY_SCENE=/scenes/ysort.esscene ESTELLA_VERIFY_MANIFEST=/scenes/ysort.textures.json ESTELLA_VERIFY_W=256 ESTELLA_VERIFY_H=256 ESTELLA_VERIFY_STEPS=2 ESTELLA_VERIFY_EXPECT=\"[{\\\"x\\\":0.5,\\\"y\\\":0.5,\\\"rgb\\\":[0,255,0],\\\"tol\\\":30},{\\\"x\\\":0.5,\\\"y\\\":0.25,\\\"rgb\\\":[255,0,0],\\\"tol\\\":30},{\\\"x\\\":0.5,\\\"y\\\":0.75,\\\"rgb\\\":[0,255,0],\\\"tol\\\":30}]\" electron scripts/headless-verify.mjs",
- "verify:render:ysort:off": "vite build && ESTELLA_VERIFY_SCENE=/scenes/ysort.esscene ESTELLA_VERIFY_MANIFEST=/scenes/ysort.textures.json ESTELLA_VERIFY_W=256 ESTELLA_VERIFY_H=256 ESTELLA_VERIFY_STEPS=2 ESTELLA_VERIFY_EXPECT=\"[{\\\"x\\\":0.5,\\\"y\\\":0.5,\\\"rgb\\\":[255,0,0],\\\"tol\\\":30}]\" electron scripts/headless-verify.mjs",
+ "verify:render:material:instance": "node ../tools/verify-render.mjs --only material-instance",
+ "verify:render:material:texture": "node ../tools/verify-render.mjs --only material-texture",
+ "verify:render:material:switch": "node ../tools/verify-render.mjs --only material-switch",
+ "verify:render:material:lit": "node ../tools/verify-render.mjs --only material-lit",
+ "verify:render:material:lit:point": "node ../tools/verify-render.mjs --only material-lit-point",
+ "verify:render:material:lit:normal": "node ../tools/verify-render.mjs --only material-lit-normal",
+ "verify:render:material:lit:spot": "node ../tools/verify-render.mjs --only material-lit-spot",
+ "verify:render:material:lit:flatnormal": "node ../tools/verify-render.mjs --only material-lit-flatnormal",
+ "verify:render:sprite:lit": "node ../tools/verify-render.mjs --only sprite-lit",
+ "verify:render:material:builtin:lit": "node ../tools/verify-render.mjs --only material-builtin-lit",
+ "verify:render:material:dissolve": "node ../tools/verify-render.mjs --only material-dissolve",
+ "verify:render:material:graph": "node ../tools/verify-render.mjs --only material-graph",
+ "verify:render:material:preview": "node ../tools/verify-render.mjs --only material-preview",
+ "verify:render:ysort": "node ../tools/verify-render.mjs --only ysort-on",
+ "verify:render:ysort:off": "node ../tools/verify-render.mjs --only ysort-off",
"verify:editor": "vite build && node scripts/editor-checks/run.mjs",
"verify:smoke": "vite build && electron scripts/headless-smoke.mjs",
- "verify:render:tilemap:hex": "vite build && ESTELLA_VERIFY_SCENE=/scenes/tilemap-hex.esscene ESTELLA_VERIFY_MANIFEST=/scenes/tilemap-hex.textures.json ESTELLA_VERIFY_W=256 ESTELLA_VERIFY_H=256 ESTELLA_VERIFY_STEPS=6 ESTELLA_VERIFY_EXPECT=\"[{\\\"x\\\":0.40,\\\"y\\\":0.40,\\\"rgb\\\":[255,0,0]},{\\\"x\\\":0.60,\\\"y\\\":0.40,\\\"rgb\\\":[0,255,0]},{\\\"x\\\":0.50,\\\"y\\\":0.55,\\\"rgb\\\":[0,0,255]},{\\\"x\\\":0.70,\\\"y\\\":0.55,\\\"rgb\\\":[255,255,0]}]\" electron scripts/headless-verify.mjs",
- "verify:render:mesh2d": "vite build && ESTELLA_VERIFY_SCENE=/scenes/mesh2d.esscene ESTELLA_VERIFY_MANIFEST=/scenes/mesh2d.textures.json ESTELLA_VERIFY_W=256 ESTELLA_VERIFY_H=256 ESTELLA_VERIFY_STEPS=4 ESTELLA_VERIFY_EXPECT='[{\"x\":0.30,\"y\":0.556,\"rgb\":[255,0,0],\"tol\":40},{\"x\":0.70,\"y\":0.556,\"rgb\":[0,255,0],\"tol\":40},{\"x\":0.30,\"y\":0.40,\"rgb\":[255,0,0],\"tol\":40}]' electron scripts/headless-verify.mjs",
- "verify:render:parallax:shape": "vite build && ESTELLA_VERIFY_SCENE=/scenes/parallax-shape.esscene ESTELLA_VERIFY_MANIFEST=/scenes/parallax-shape.textures.json ESTELLA_VERIFY_STEPS=4 ESTELLA_VERIFY_EXPECT=\"[{\\\"x\\\":0.5,\\\"y\\\":0.5,\\\"rgb\\\":[0,255,0],\\\"tol\\\":40},{\\\"x\\\":0.25,\\\"y\\\":0.5,\\\"rgb\\\":[255,0,0],\\\"tol\\\":40}]\" electron scripts/headless-verify.mjs",
- "verify:render:trail": "vite build && ESTELLA_VERIFY_PLAY=1 ESTELLA_VERIFY_SCENE=/scenes/trail.esscene ESTELLA_VERIFY_MANIFEST=/scenes/trail.textures.json ESTELLA_VERIFY_W=256 ESTELLA_VERIFY_H=256 ESTELLA_VERIFY_TRAIL='{\"from\":[-200,0],\"to\":[200,0],\"steps\":20}' ESTELLA_VERIFY_EXPECT='[{\"x\":0.80,\"y\":0.5,\"rgb\":[0,255,0],\"tol\":50},{\"x\":0.5,\"y\":0.5,\"rgb\":[0,255,0],\"tol\":50},{\"x\":0.25,\"y\":0.5,\"rgb\":[0,255,0],\"tol\":60},{\"x\":0.5,\"y\":0.15,\"rgb\":[0,0,0],\"tol\":30}]' electron scripts/headless-verify.mjs",
- "verify:render:postprocess:lut": "vite build && ESTELLA_VERIFY_PLAY=1 ESTELLA_VERIFY_SCENE=/scenes/lut-grade.esscene ESTELLA_VERIFY_MANIFEST=/scenes/lut-grade.textures.json ESTELLA_VERIFY_W=256 ESTELLA_VERIFY_H=256 ESTELLA_VERIFY_STEPS=10 ESTELLA_VERIFY_EXPECT=\"[{\\\"x\\\":0.292,\\\"y\\\":0.5,\\\"rgb\\\":[0,0,255],\\\"tol\\\":40},{\\\"x\\\":0.708,\\\"y\\\":0.5,\\\"rgb\\\":[255,0,0],\\\"tol\\\":40}]\" electron scripts/headless-verify.mjs",
- "verify:render:depth": "vite build && ESTELLA_VERIFY_SCENE=/scenes/depth-layers.esscene ESTELLA_VERIFY_MANIFEST=/scenes/depth-layers.textures.json ESTELLA_VERIFY_DEPTH_LAYERS=6 ESTELLA_VERIFY_EXPECT=\"[{\\\"x\\\":0.573,\\\"y\\\":0.5,\\\"rgb\\\":[255,0,0],\\\"tol\\\":60}]\" electron scripts/headless-verify.mjs",
- "verify:render:depth:off": "vite build && ESTELLA_VERIFY_SCENE=/scenes/depth-layers.esscene ESTELLA_VERIFY_MANIFEST=/scenes/depth-layers.textures.json ESTELLA_VERIFY_EXPECT=\"[{\\\"x\\\":0.573,\\\"y\\\":0.5,\\\"rgb\\\":[0,0,255],\\\"tol\\\":60}]\" electron scripts/headless-verify.mjs",
- "verify:soak": "vite build && node scripts/editor-checks/run.mjs soak"
+ "verify:render:tilemap:hex": "node ../tools/verify-render.mjs --only tilemap-hex",
+ "verify:render:mesh2d": "node ../tools/verify-render.mjs --only mesh2d",
+ "verify:render:parallax:shape": "node ../tools/verify-render.mjs --only parallax-shape",
+ "verify:render:trail": "node ../tools/verify-render.mjs --only trail",
+ "verify:render:postprocess:lut": "node ../tools/verify-render.mjs --only postprocess-lut",
+ "verify:render:depth": "node ../tools/verify-render.mjs --only depth-on",
+ "verify:render:depth:off": "node ../tools/verify-render.mjs --only depth-off",
+ "verify:soak": "vite build && node scripts/editor-checks/run.mjs soak",
+ "verify:render:tier": "node ../tools/verify-render.mjs --tier"
},
"dependencies": {
"@anthropic-ai/sdk": "^0.115.0",
diff --git a/package.json b/package.json
index 10a80ad94..b64324129 100644
--- a/package.json
+++ b/package.json
@@ -17,7 +17,7 @@
"emsdk:setup": "node build-tools/toolchain/setup-emsdk.js",
"asset-meta": "node tools/asset-meta.js",
"migrate-asset-refs": "node tools/migrate-asset-refs.js",
- "verify": "pnpm --filter ./sdk exec tsc --noEmit && pnpm --filter @estella/editor exec tsc --noEmit && node tools/api-surface.mjs --check && node tools/check-cycles.mjs && node tools/check-layers.mjs && node tools/check-project-settings.mjs && node tools/check-workflows.mjs && node tools/check-tool-calls.mjs && node tools/check-inspector-door.mjs && node tools/check-dirty-source.mjs && node tools/check-path-sandbox.mjs && node tools/check-key-codes.mjs && node tools/check-comment-style.mjs && node tools/check-cpp-tests.mjs && node tools/check-verifier-exit.mjs && node tools/check-release-metadata.mjs && node tools/check-golden.mjs && node tools/check-engine-gaps.mjs && node tools/check-minigame-host.mjs && node tools/check-release-gate.mjs && node tools/component-reference.mjs --check",
+ "verify": "pnpm --filter ./sdk exec tsc --noEmit && pnpm --filter @estella/editor exec tsc --noEmit && node tools/api-surface.mjs --check && node tools/check-cycles.mjs && node tools/check-layers.mjs && node tools/check-project-settings.mjs && node tools/check-workflows.mjs && node tools/check-tool-calls.mjs && node tools/check-inspector-door.mjs && node tools/check-dirty-source.mjs && node tools/check-path-sandbox.mjs && node tools/check-key-codes.mjs && node tools/check-comment-style.mjs && node tools/check-cpp-tests.mjs && node tools/check-verifier-exit.mjs && node tools/check-render-scenes.mjs && node tools/check-release-metadata.mjs && node tools/check-golden.mjs && node tools/check-engine-gaps.mjs && node tools/check-minigame-host.mjs && node tools/check-release-gate.mjs && node tools/component-reference.mjs --check",
"perf": "node tools/perf-guard.mjs --check",
"scale": "node tools/perf-budget.mjs",
"stress-project": "node tools/stress-project.mjs",
diff --git a/tools/check-render-scenes.mjs b/tools/check-render-scenes.mjs
new file mode 100644
index 000000000..b8cd6cb33
--- /dev/null
+++ b/tools/check-render-scenes.mjs
@@ -0,0 +1,90 @@
+// SPDX-License-Identifier: Apache-2.0
+// SPDX-FileCopyrightText: Copyright (c) 2024-present ESEngine Team
+/**
+ * @file check-render-scenes.mjs — the pixel gates have one list, and it is run.
+ *
+ * The registry replaced two lists that had drifted both ways. A gate is what
+ * stops a third from growing: a scene declared here must load a scene that
+ * exists, sit in a tier something runs, and be reachable by name — and CI must
+ * get its list from here rather than inlining its own again.
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { TIERS, SCENES, scenesAtTier, sceneFileOf } from './renderScenes.mjs';
+
+const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
+const PUBLIC = path.join(ROOT, 'desktop', 'public');
+const WORKFLOW = path.join(ROOT, '.github', 'workflows', 'build.yml');
+
+const problems = [];
+const fail = (m) => problems.push(m);
+
+const seen = new Set();
+for (const s of SCENES) {
+ if (!s.id || /[^a-z0-9-]/.test(s.id)) fail(`"${s.id}" is not a usable scene id (lower-case, digits, dashes)`);
+ if (seen.has(s.id)) fail(`"${s.id}" is listed twice — --only would run one and mean the other`);
+ seen.add(s.id);
+ if (!TIERS.includes(s.tier)) fail(`"${s.id}" has tier "${s.tier}" (have: ${TIERS.join(', ')})`);
+ if (!s.env || typeof s.env !== 'object') fail(`"${s.id}" has no env — an empty one is {}, not missing`);
+
+ // A scene path that does not resolve is a check that passes by never drawing
+ // the thing it was written for.
+ const file = sceneFileOf(s);
+ if (file && !existsSync(path.join(PUBLIC, file))) {
+ fail(`"${s.id}" loads ${s.env.ESTELLA_VERIFY_SCENE}, which is not under desktop/public`);
+ }
+ const manifest = s.env.ESTELLA_VERIFY_MANIFEST;
+ if (manifest && !existsSync(path.join(PUBLIC, manifest.replace(/^\//, '')))) {
+ fail(`"${s.id}" names manifest ${manifest}, which is not under desktop/public`);
+ }
+ // An expectation is the whole point: a scene with none passes as long as it
+ // renders anything at all. Allowed, as a sentence — the same bargain the
+ // golden corpus strikes with parityGap.
+ const asserts = s.env.ESTELLA_VERIFY_EXPECT || s.env.ESTELLA_VERIFY_GRID || s.env.ESTELLA_VERIFY_PREVIEW
+ || s.env.ESTELLA_VERIFY_DEPTH_LAYERS || s.env.ESTELLA_VERIFY_YSORT || s.id === 'sprite-default';
+ if (!asserts && !s.rendersOnly) {
+ fail(`"${s.id}" asserts nothing — give it an ESTELLA_VERIFY_EXPECT, or say in rendersOnly why it has none`);
+ }
+ if (s.rendersOnly && asserts) fail(`"${s.id}" both probes pixels and says it cannot`);
+ if (s.rendersOnly !== undefined && !(typeof s.rendersOnly === 'string' && s.rendersOnly.trim())) {
+ fail(`"${s.id}" sets rendersOnly without a reason`);
+ }
+}
+
+// CI has to take its list from here. Inlining scene invocations again is exactly
+// how the two lists came to disagree in the first place.
+if (existsSync(WORKFLOW)) {
+ const wf = readFileSync(WORKFLOW, 'utf8');
+ if (!wf.includes('tools/verify-render.mjs')) {
+ fail('build.yml does not run tools/verify-render.mjs — CI would be back to a list of its own');
+ }
+ if (/^\s*run_scene\s+\S/m.test(wf)) {
+ fail('build.yml still inlines run_scene invocations — the registry is the list');
+ }
+}
+
+// The convenience scripts are shims over the registry. Letting one carry its own
+// env again is how desktop/package.json became the second list.
+const pkg = JSON.parse(readFileSync(path.join(ROOT, 'desktop', 'package.json'), 'utf8'));
+for (const [name, body] of Object.entries(pkg.scripts ?? {})) {
+ if (!name.startsWith('verify:render') || !body.includes('headless-verify.mjs')) continue;
+ fail(`desktop script "${name}" invokes headless-verify itself — make it a verify-render.mjs shim`);
+}
+for (const [name, body] of Object.entries(pkg.scripts ?? {})) {
+ const m = /^node \.\.\/tools\/verify-render\.mjs --only (\S+)$/.exec(body ?? '');
+ if (!m) continue;
+ if (!seen.has(m[1])) fail(`desktop script "${name}" names scene "${m[1]}", which the registry does not have`);
+}
+
+if (problems.length) {
+ console.error('check-render-scenes: the pixel gates do not hold up.\n');
+ for (const p of problems) console.error(` ${p}`);
+ process.exit(1);
+}
+
+const byTier = TIERS.map((t) => `${t} ${scenesAtTier(t).length}`).join(' / ');
+const weak = SCENES.filter((s) => s.rendersOnly);
+console.log(`check-render-scenes: ${SCENES.length} pixel gate(s) with a scene CI can find — ok (${byTier})`);
+console.log(` ${SCENES.length - weak.length} probe pixels; ${weak.length} only assert that something drew:`);
+for (const s of weak) console.log(` ${s.id}: ${s.rendersOnly}`);
diff --git a/tools/releaseGate.mjs b/tools/releaseGate.mjs
index b1a628dd4..97b2d90a2 100644
--- a/tools/releaseGate.mjs
+++ b/tools/releaseGate.mjs
@@ -53,6 +53,15 @@ export const CRITERIA = [
'tools/verify-native-boot.mjs',
],
},
+ {
+ id: 'every-pixel-gate-runs',
+ says: 'every declared pixel gate has run, not just the ones CI happens to list',
+ // CI pays for the pr tier on each push. The rest — spine, video, particles,
+ // every material scene, text, ktx2 — was declared and run by nothing at all
+ // until the registry gave the whole set one runner.
+ answeredBy: 'node tools/verify-render.mjs --tier nightly',
+ needs: ['tools/renderScenes.mjs', 'tools/verify-render.mjs'],
+ },
{
id: 'hot-update-lands-or-rolls-back',
says: 'a shipped build takes an update from a CDN, and refuses a broken one whole',
diff --git a/tools/renderScenes.mjs b/tools/renderScenes.mjs
new file mode 100644
index 000000000..f29ada601
--- /dev/null
+++ b/tools/renderScenes.mjs
@@ -0,0 +1,108 @@
+// SPDX-License-Identifier: Apache-2.0
+// SPDX-FileCopyrightText: Copyright (c) 2024-present ESEngine Team
+/**
+ * @file renderScenes.mjs — the pixel gates, as a registry.
+ *
+ * There were two lists. CI inlined twenty scene invocations in build.yml, and
+ * desktop/package.json declared forty-four `verify:render:*` scripts. Neither
+ * was authoritative, so they drifted both ways: thirty-two declared verifiers
+ * were run by nothing at all (spine, video, particles, every material scene,
+ * text, ktx2, four tilemap variants), and five scenes CI runs had no name a
+ * developer could reproduce them by.
+ *
+ * All of them pass — this is not a list of broken checks. It is a list of
+ * checks that could not have caught anything, which is the same problem the
+ * golden corpus exists to refuse: green about the things it happens to run.
+ *
+ * `tier` is the cheapest run that pays for a scene; each tier includes the
+ * cheaper ones. `pr` is exactly what CI ran before this file existed, so
+ * adopting the registry changed no CI cost.
+ */
+
+/** Cheapest tier a scene runs at; tiers are cumulative. */
+export const TIERS = ['pr', 'nightly'];
+
+/**
+ * Every pixel gate. `env` is handed to desktop/scripts/headless-verify.mjs
+ * verbatim — an empty one is the default sprite scene.
+ */
+export const SCENES = [
+ { id: "sprite-default", tier: "pr", env: { } },
+ // Editor grid on/off pixel diff — guards the custom-draw reflected material path (drawMeshWithMaterial + MaterialConstants UBO).
+ { id: "editor-grid", tier: "pr", webgpu: true, env: { ESTELLA_VERIFY_GRID: "64", ESTELLA_VERIFY_STEPS: "3" } },
+ { id: "mesh2d", tier: "pr", env: { ESTELLA_VERIFY_SCENE: "/scenes/mesh2d.esscene", ESTELLA_VERIFY_MANIFEST: "/scenes/mesh2d.textures.json", ESTELLA_VERIFY_W: "256", ESTELLA_VERIFY_H: "256", ESTELLA_VERIFY_STEPS: "4", ESTELLA_VERIFY_EXPECT: "[{\"x\":0.30,\"y\":0.556,\"rgb\":[255,0,0],\"tol\":40},{\"x\":0.70,\"y\":0.556,\"rgb\":[0,255,0],\"tol\":40},{\"x\":0.30,\"y\":0.40,\"rgb\":[255,0,0],\"tol\":40}]" } },
+ { id: "parallax-shape", tier: "pr", webgpu: true, env: { ESTELLA_VERIFY_SCENE: "/scenes/parallax-shape.esscene", ESTELLA_VERIFY_MANIFEST: "/scenes/parallax-shape.textures.json", ESTELLA_VERIFY_STEPS: "4", ESTELLA_VERIFY_EXPECT: "[{\"x\":0.5,\"y\":0.5,\"rgb\":[0,255,0],\"tol\":40},{\"x\":0.25,\"y\":0.5,\"rgb\":[255,0,0],\"tol\":40}]" } },
+ { id: "tilemap-flip", tier: "pr", env: { ESTELLA_VERIFY_SCENE: "/scenes/tilemap-flip.esscene", ESTELLA_VERIFY_MANIFEST: "/scenes/tilemap-flip.textures.json", ESTELLA_VERIFY_W: "256", ESTELLA_VERIFY_H: "256", ESTELLA_VERIFY_STEPS: "2", ESTELLA_VERIFY_EXPECT: "[{\"x\":0.40,\"y\":0.36,\"rgb\":[255,0,0]},{\"x\":0.60,\"y\":0.36,\"rgb\":[0,255,0]},{\"x\":0.40,\"y\":0.58,\"rgb\":[0,0,255]},{\"x\":0.60,\"y\":0.58,\"rgb\":[255,255,0]}]" } },
+ // Parallax on a cached-chunk tilemap: the camera moves while the layer model is untouched, so only the per-frame origin/parallax merge (not a revision-bump rebuild) can place the tiles — guards against baking camera-dependent offsets into the chunk cache.
+ { id: "tilemap-parallax", tier: "pr", env: { ESTELLA_VERIFY_SCENE: "/scenes/tilemap-parallax.esscene", ESTELLA_VERIFY_MANIFEST: "/scenes/tilemap-flip.textures.json", ESTELLA_VERIFY_W: "256", ESTELLA_VERIFY_H: "256", ESTELLA_VERIFY_STEPS: "2", ESTELLA_VERIFY_MOVE: "{\"component\":\"Camera\",\"to\":[48,-16],\"steps\":3}", ESTELLA_VERIFY_EXPECT: "[{\"x\":0.30,\"y\":0.40,\"rgb\":[255,0,0]},{\"x\":0.10,\"y\":0.40,\"rgb\":[0,0,0],\"tol\":20},{\"x\":0.50,\"y\":0.40,\"rgb\":[0,255,0]}]" } },
+ // BitmapText's first pixel coverage: a 2-glyph synthetic .fnt atlas (red A, green B) pins glyph layout, atlas UV orientation and the one-DrawCommand-per-text path.
+ { id: "bitmaptext", tier: "pr", env: { ESTELLA_VERIFY_SCENE: "/scenes/bitmaptext.esscene", ESTELLA_VERIFY_W: "256", ESTELLA_VERIFY_H: "256", ESTELLA_VERIFY_STEPS: "3", ESTELLA_VERIFY_EXPECT: "[{\"x\":0.40,\"y\":0.5,\"rgb\":[255,0,0],\"tol\":20},{\"x\":0.60,\"y\":0.5,\"rgb\":[0,255,0],\"tol\":20},{\"x\":0.5,\"y\":0.15,\"rgb\":[0,0,0],\"tol\":20}]" } },
+ { id: "ui-mask", tier: "pr", env: { ESTELLA_VERIFY_SCENE: "/scenes/ui-list-mask.esscene", ESTELLA_VERIFY_MANIFEST: "/scenes/ui-list-mask.textures.json", ESTELLA_VERIFY_W: "800", ESTELLA_VERIFY_H: "600", ESTELLA_VERIFY_EXPECT: "[{\"x\":0.5,\"y\":0.5,\"rgb\":[255,0,0],\"tol\":60},{\"x\":0.9,\"y\":0.5,\"rgb\":[0,0,255],\"tol\":60},{\"x\":0.5,\"y\":0.85,\"rgb\":[0,0,255],\"tol\":60},{\"x\":0.5,\"y\":0.15,\"rgb\":[0,0,255],\"tol\":60}]" } },
+ // Camera.cullingMask over sorting layers, for world content AND for UI — whose `layer` encodes tree order, so it belongs to its Canvas' layer instead. Layers 1 (the Canvas) and 2 (blue) are cleared from the mask, so only green and yellow survive; unmasked, the full-screen HUD covers both.
+ { id: "camera-culling", tier: "pr", env: { ESTELLA_VERIFY_PLAY: "1", ESTELLA_VERIFY_SCENE: "/scenes/camera-culling.esscene", ESTELLA_VERIFY_MANIFEST: "/scenes/camera-culling.textures.json", ESTELLA_VERIFY_W: "320", ESTELLA_VERIFY_H: "180", ESTELLA_VERIFY_STEPS: "4", ESTELLA_VERIFY_EXPECT: "[{\"x\":0.25,\"y\":0.5,\"rgb\":[0,255,0],\"tol\":30},{\"x\":0.75,\"y\":0.5,\"rgb\":[255,255,0],\"tol\":30}]" } },
+ // Where the UI layout box SITS. The camera is driven away from the origin at runtime, so the box moves without resizing: the unparented Canvas (a screen root) must travel with it — red/green stay in their quadrants — while the Canvas parented to a world entity must not, landing blue at the anchor's own world position. Before screen roots existed the whole HUD stayed at the origin and this frame came back black.
+ { id: "ui-screen-root", tier: "pr", env: { ESTELLA_VERIFY_PLAY: "1", ESTELLA_VERIFY_SCENE: "/scenes/ui-screen-root.esscene", ESTELLA_VERIFY_MANIFEST: "/scenes/ui-screen-root.textures.json", ESTELLA_VERIFY_W: "640", ESTELLA_VERIFY_H: "360", ESTELLA_VERIFY_STEPS: "4", ESTELLA_VERIFY_MOVE: "{\"component\":\"Camera\",\"to\":[5000,-800],\"steps\":4}", ESTELLA_VERIFY_EXPECT: "[{\"x\":0.25,\"y\":0.25,\"rgb\":[255,0,0],\"tol\":30},{\"x\":0.75,\"y\":0.75,\"rgb\":[0,255,0],\"tol\":30},{\"x\":0.75,\"y\":0.25,\"rgb\":[0,0,255],\"tol\":30},{\"x\":0.25,\"y\":0.75,\"rgb\":[0,0,0],\"tol\":30}]" } },
+ // Y-sort: same scene twice — mask on flips the overlap to the lower (higher-Y-key) entity; mask off preserves submission order. Both asserted so neither path can silently regress.
+ { id: "ysort-on", tier: "pr", webgpu: true, env: { ESTELLA_VERIFY_YSORT: "1", ESTELLA_VERIFY_SCENE: "/scenes/ysort.esscene", ESTELLA_VERIFY_MANIFEST: "/scenes/ysort.textures.json", ESTELLA_VERIFY_W: "256", ESTELLA_VERIFY_H: "256", ESTELLA_VERIFY_STEPS: "2", ESTELLA_VERIFY_EXPECT: "[{\"x\":0.5,\"y\":0.5,\"rgb\":[0,255,0],\"tol\":30},{\"x\":0.5,\"y\":0.25,\"rgb\":[255,0,0],\"tol\":30},{\"x\":0.5,\"y\":0.75,\"rgb\":[0,255,0],\"tol\":30}]" } },
+ { id: "ysort-off", tier: "pr", env: { ESTELLA_VERIFY_SCENE: "/scenes/ysort.esscene", ESTELLA_VERIFY_MANIFEST: "/scenes/ysort.textures.json", ESTELLA_VERIFY_W: "256", ESTELLA_VERIFY_H: "256", ESTELLA_VERIFY_STEPS: "2", ESTELLA_VERIFY_EXPECT: "[{\"x\":0.5,\"y\":0.5,\"rgb\":[255,0,0],\"tol\":30}]" } },
+ // Depth layers (2.5D): same scene twice, one project setting apart. The near sprite is in the LOWER layer and both merge into ONE draw call, so inside the batch the order is fixed by index — no amount of sorting can produce the depth answer, which is what makes the pair discriminating.
+ { id: "depth-on", tier: "pr", env: { ESTELLA_VERIFY_DEPTH_LAYERS: "6", ESTELLA_VERIFY_SCENE: "/scenes/depth-layers.esscene", ESTELLA_VERIFY_MANIFEST: "/scenes/depth-layers.textures.json", ESTELLA_VERIFY_EXPECT: "[{\"x\":0.573,\"y\":0.5,\"rgb\":[255,0,0],\"tol\":60}]" } },
+ { id: "depth-off", tier: "pr", env: { ESTELLA_VERIFY_SCENE: "/scenes/depth-layers.esscene", ESTELLA_VERIFY_MANIFEST: "/scenes/depth-layers.textures.json", ESTELLA_VERIFY_EXPECT: "[{\"x\":0.573,\"y\":0.5,\"rgb\":[0,0,255],\"tol\":60}]" } },
+ // Motion trail: move a TrailRenderer entity across the frame in play mode, asserting the ribbon rasterizes as a green band (head/mid/tail) with black above it — the CPU-ribbon-through-the-batch-face path.
+ { id: "trail", tier: "pr", webgpu: true, env: { ESTELLA_VERIFY_PLAY: "1", ESTELLA_VERIFY_SCENE: "/scenes/trail.esscene", ESTELLA_VERIFY_MANIFEST: "/scenes/trail.textures.json", ESTELLA_VERIFY_W: "256", ESTELLA_VERIFY_H: "256", ESTELLA_VERIFY_TRAIL: "{\"from\":[-200,0],\"to\":[200,0],\"steps\":20}", ESTELLA_VERIFY_EXPECT: "[{\"x\":0.80,\"y\":0.5,\"rgb\":[0,255,0],\"tol\":50},{\"x\":0.5,\"y\":0.5,\"rgb\":[0,255,0],\"tol\":50},{\"x\":0.25,\"y\":0.5,\"rgb\":[0,255,0],\"tol\":60},{\"x\":0.5,\"y\":0.15,\"rgb\":[0,0,0],\"tol\":30}]" } },
+ // Linear-light pipeline (colorSpace: 'linear'). The lit falloff moves 52 to 125 (perceptually-uniform light); the mid-gray texture must ROUND-TRIP exactly (sRGB store → hw decode → blit encode = identity) — a missing sRGB upload variant would read ~187, so tol 6 is a hard discriminator.
+ { id: "linear-lit", tier: "pr", webgpu: true, env: { ESTELLA_VERIFY_COLORSPACE: "linear", ESTELLA_VERIFY_SCENE: "/scenes/mat-lit-point.esscene", ESTELLA_VERIFY_MANIFEST: "/scenes/mat-lit-point.textures.json", ESTELLA_VERIFY_W: "256", ESTELLA_VERIFY_H: "256", ESTELLA_VERIFY_STEPS: "2", ESTELLA_VERIFY_EXPECT: "[{\"x\":0.5,\"y\":0.5,\"rgb\":[0,254,0],\"tol\":25},{\"x\":0.75,\"y\":0.5,\"rgb\":[0,125,0],\"tol\":25}]" } },
+ { id: "linear-midtone", tier: "pr", webgpu: true, env: { ESTELLA_VERIFY_COLORSPACE: "linear", ESTELLA_VERIFY_SCENE: "/scenes/srgb-midtone.esscene", ESTELLA_VERIFY_MANIFEST: "/scenes/srgb-midtone.textures.json", ESTELLA_VERIFY_W: "256", ESTELLA_VERIFY_H: "256", ESTELLA_VERIFY_STEPS: "2", ESTELLA_VERIFY_EXPECT: "[{\"x\":0.5,\"y\":0.5,\"rgb\":[128,128,128],\"tol\":6}]" } },
+ // Post-process chain guards — bloom's first CI pixel coverage. The gamma scene pins the LDR multi-pass chain; the linear scene is the HDR discriminator: threshold 1.5 sits above anything an 8-bit chain can store, so glow OUTSIDE the sprite (x=0.64) proves over-range light survived the float intermediates — the same scene blooms NOTHING in gamma mode.
+ { id: "bloom-ldr", tier: "pr", webgpu: true, env: { ESTELLA_VERIFY_PLAY: "1", ESTELLA_VERIFY_SCENE: "/scenes/bloom-ldr.esscene", ESTELLA_VERIFY_MANIFEST: "/scenes/bloom-ldr.textures.json", ESTELLA_VERIFY_W: "256", ESTELLA_VERIFY_H: "256", ESTELLA_VERIFY_STEPS: "10", ESTELLA_VERIFY_EXPECT: "[{\"x\":0.61,\"y\":0.5,\"rgb\":[0,130,0],\"tol\":35},{\"x\":0.70,\"y\":0.5,\"rgb\":[0,32,0],\"tol\":25},{\"x\":0.85,\"y\":0.5,\"rgb\":[0,0,0],\"tol\":12}]" } },
+ { id: "hdr-bloom", tier: "pr", webgpu: true, env: { ESTELLA_VERIFY_PLAY: "1", ESTELLA_VERIFY_COLORSPACE: "linear", ESTELLA_VERIFY_SCENE: "/scenes/hdr-bloom.esscene", ESTELLA_VERIFY_MANIFEST: "/scenes/hdr-bloom.textures.json", ESTELLA_VERIFY_W: "256", ESTELLA_VERIFY_H: "256", ESTELLA_VERIFY_STEPS: "10", ESTELLA_VERIFY_EXPECT: "[{\"x\":0.5,\"y\":0.5,\"rgb\":[0,255,0],\"tol\":25},{\"x\":0.64,\"y\":0.5,\"rgb\":[0,255,0],\"tol\":35},{\"x\":0.85,\"y\":0.5,\"rgb\":[0,0,0],\"tol\":12}]" } },
+ { id: "video", tier: "nightly", env: { ESTELLA_VERIFY_PLAY: "1", ESTELLA_VERIFY_SETTLE_MS: "2500", ESTELLA_VERIFY_SCENE: "/scenes/video-playback.esscene", ESTELLA_VERIFY_MANIFEST: "/scenes/video-playback.textures.json", ESTELLA_VERIFY_W: "256", ESTELLA_VERIFY_H: "256", ESTELLA_VERIFY_EXPECT: "[{\"x\":0.5,\"y\":0.25,\"rgb\":[255,0,0],\"tol\":90},{\"x\":0.5,\"y\":0.75,\"rgb\":[0,0,255],\"tol\":90}]" } },
+ { id: "video-ui", tier: "nightly", env: { ESTELLA_VERIFY_PLAY: "1", ESTELLA_VERIFY_SETTLE_MS: "2500", ESTELLA_VERIFY_SCENE: "/scenes/video-ui.esscene", ESTELLA_VERIFY_MANIFEST: "/scenes/video-ui.textures.json", ESTELLA_VERIFY_W: "800", ESTELLA_VERIFY_H: "600", ESTELLA_VERIFY_EXPECT: "[{\"x\":0.5,\"y\":0.25,\"rgb\":[255,0,0],\"tol\":90},{\"x\":0.5,\"y\":0.75,\"rgb\":[0,0,255],\"tol\":90}]" } },
+ { id: "spine", tier: "nightly", rendersOnly: "a Spine skeleton is drawn; no probe pins which pose, so only a blank frame fails", env: { ESTELLA_VERIFY_SCENE: "/scenes/spine-test.esscene", ESTELLA_VERIFY_MANIFEST: "/scenes/spine-test.textures.json" } },
+ { id: "particles", tier: "nightly", rendersOnly: "the emitter draws; no probe pins where the particles went", env: { ESTELLA_VERIFY_PLAY: "1", ESTELLA_VERIFY_SCENE: "/scenes/particle-demo.esscene", ESTELLA_VERIFY_MANIFEST: "/scenes/particle-demo.textures.json", ESTELLA_VERIFY_STEPS: "90" } },
+ { id: "particles-gradient", tier: "nightly", env: { ESTELLA_VERIFY_PLAY: "1", ESTELLA_VERIFY_SCENE: "/scenes/particle-gradient.esscene", ESTELLA_VERIFY_MANIFEST: "/scenes/particle-gradient.textures.json", ESTELLA_VERIFY_W: "256", ESTELLA_VERIFY_H: "256", ESTELLA_VERIFY_STEPS: "20", ESTELLA_VERIFY_EXPECT: "[{\"x\":0.5,\"y\":0.5,\"rgb\":[0,255,0],\"tol\":90}]" } },
+ { id: "particles-sizecurve", tier: "nightly", env: { ESTELLA_VERIFY_PLAY: "1", ESTELLA_VERIFY_SCENE: "/scenes/particle-sizecurve.esscene", ESTELLA_VERIFY_MANIFEST: "/scenes/particle-sizecurve.textures.json", ESTELLA_VERIFY_W: "256", ESTELLA_VERIFY_H: "256", ESTELLA_VERIFY_STEPS: "20", ESTELLA_VERIFY_EXPECT: "[{\"x\":0.5,\"y\":0.5,\"rgb\":[0,255,0],\"tol\":110},{\"x\":0.28,\"y\":0.5,\"rgb\":[0,0,0],\"tol\":50}]" } },
+ { id: "postprocess", tier: "nightly", rendersOnly: "the chain runs and draws; no probe pins what the effects did to it", env: { ESTELLA_VERIFY_PLAY: "1", ESTELLA_VERIFY_SCENE: "/scenes/postprocess-effects.esscene", ESTELLA_VERIFY_MANIFEST: "/scenes/postprocess-effects.textures.json", ESTELLA_VERIFY_STEPS: "30" } },
+ { id: "text", tier: "nightly", rendersOnly: "SDF text draws; no probe pins glyph placement — bitmaptext is the one that does", env: { ESTELLA_VERIFY_SCENE: "/scenes/ui-text-sdf.esscene", ESTELLA_VERIFY_MANIFEST: "/scenes/ui-text-sdf.textures.json" } },
+ { id: "text-rect", tier: "nightly", rendersOnly: "the rect-bounded variant draws; the same missing probe as text", env: { ESTELLA_VERIFY_SCENE: "/scenes/ui-text-rect.esscene", ESTELLA_VERIFY_MANIFEST: "/scenes/ui-text-sdf.textures.json" } },
+ { id: "uinode", tier: "nightly", rendersOnly: "the flex tree draws; no probe pins where the boxes landed", env: { ESTELLA_VERIFY_SCENE: "/scenes/ui-node-flex.esscene", ESTELLA_VERIFY_MANIFEST: "/scenes/ui-node-flex.textures.json", ESTELLA_VERIFY_W: "800", ESTELLA_VERIFY_H: "600" } },
+ { id: "filled", tier: "nightly", env: { ESTELLA_VERIFY_SCENE: "/scenes/ui-visual-filled.esscene", ESTELLA_VERIFY_MANIFEST: "/scenes/ui-visual-filled.textures.json", ESTELLA_VERIFY_W: "800", ESTELLA_VERIFY_H: "600", ESTELLA_VERIFY_STEPS: "2", ESTELLA_VERIFY_EXPECT: "[{\"x\":0.18,\"y\":0.5,\"rgb\":[0,255,0],\"tol\":40},{\"x\":0.40,\"y\":0.5,\"rgb\":[255,0,0],\"tol\":40},{\"x\":0.58,\"y\":0.75,\"rgb\":[0,255,0],\"tol\":40},{\"x\":0.58,\"y\":0.25,\"rgb\":[255,0,0],\"tol\":40},{\"x\":0.30,\"y\":0.20,\"rgb\":[0,255,0],\"tol\":40},{\"x\":0.20,\"y\":0.333,\"rgb\":[255,0,0],\"tol\":40},{\"x\":0.30,\"y\":0.833,\"rgb\":[0,255,0],\"tol\":40},{\"x\":0.20,\"y\":0.70,\"rgb\":[255,0,0],\"tol\":40}]" } },
+ { id: "tilemap-transform", tier: "nightly", env: { ESTELLA_VERIFY_SCENE: "/scenes/tilemap-transform.esscene", ESTELLA_VERIFY_MANIFEST: "/scenes/tilemap-transform.textures.json", ESTELLA_VERIFY_W: "256", ESTELLA_VERIFY_H: "256", ESTELLA_VERIFY_STEPS: "2", ESTELLA_VERIFY_EXPECT: "[{\"x\":0.40,\"y\":0.36,\"rgb\":[255,255,0]},{\"x\":0.60,\"y\":0.36,\"rgb\":[0,255,0]},{\"x\":0.40,\"y\":0.58,\"rgb\":[0,0,255]},{\"x\":0.60,\"y\":0.58,\"rgb\":[255,0,0]}]" } },
+ { id: "tilemap-multiset", tier: "nightly", env: { ESTELLA_VERIFY_SCENE: "/scenes/tilemap-multiset.esscene", ESTELLA_VERIFY_MANIFEST: "/scenes/tilemap-multiset.textures.json", ESTELLA_VERIFY_W: "256", ESTELLA_VERIFY_H: "256", ESTELLA_VERIFY_STEPS: "6", ESTELLA_VERIFY_EXPECT: "[{\"x\":0.40,\"y\":0.36,\"rgb\":[255,0,0]},{\"x\":0.60,\"y\":0.36,\"rgb\":[0,255,0]},{\"x\":0.40,\"y\":0.58,\"rgb\":[0,0,255]},{\"x\":0.60,\"y\":0.58,\"rgb\":[255,255,0]}]" } },
+ { id: "tilemap-spacing", tier: "nightly", env: { ESTELLA_VERIFY_SCENE: "/scenes/tilemap-spacing.esscene", ESTELLA_VERIFY_MANIFEST: "/scenes/tilemap-spacing.textures.json", ESTELLA_VERIFY_W: "256", ESTELLA_VERIFY_H: "256", ESTELLA_VERIFY_STEPS: "6", ESTELLA_VERIFY_EXPECT: "[{\"x\":0.40,\"y\":0.36,\"rgb\":[255,0,0]},{\"x\":0.60,\"y\":0.36,\"rgb\":[0,255,0]},{\"x\":0.40,\"y\":0.58,\"rgb\":[0,0,255]},{\"x\":0.60,\"y\":0.58,\"rgb\":[255,255,0]}]" } },
+ // Tiled tile (GID) object: an object-layer object with a gid renders as a
+ // positioned Sprite (bottom-left anchor, tileset UV).
+ { id: "tilemap-gidobj", tier: "pr", env: { ESTELLA_VERIFY_SCENE: "/scenes/tilemap-gidobj.esscene", ESTELLA_VERIFY_MANIFEST: "/scenes/tilemap-gidobj.textures.json", ESTELLA_VERIFY_W: "256", ESTELLA_VERIFY_H: "256", ESTELLA_VERIFY_STEPS: "10", ESTELLA_VERIFY_EXPECT: "[{\"x\":0.5,\"y\":0.5,\"rgb\":[0,255,0],\"tol\":40},{\"x\":0.5,\"y\":0.12,\"rgb\":[0,0,0],\"tol\":30},{\"x\":0.8125,\"y\":0.375,\"rgb\":[0,0,255],\"tol\":40},{\"x\":0.9375,\"y\":0.375,\"rgb\":[255,255,0],\"tol\":40},{\"x\":0.875,\"y\":0.8125,\"rgb\":[0,0,255],\"tol\":40},{\"x\":0.875,\"y\":0.9375,\"rgb\":[255,255,0],\"tol\":40}]" } },
+ { id: "material", tier: "nightly", env: { ESTELLA_VERIFY_SCENE: "/scenes/mat-tint.esscene", ESTELLA_VERIFY_MANIFEST: "/scenes/mat-tint.textures.json", ESTELLA_VERIFY_W: "256", ESTELLA_VERIFY_H: "256", ESTELLA_VERIFY_STEPS: "2", ESTELLA_VERIFY_EXPECT: "[{\"x\":0.5,\"y\":0.5,\"rgb\":[255,0,0],\"tol\":40}]" } },
+ { id: "ktx2", tier: "nightly", env: { ESTELLA_VERIFY_SCENE: "/scenes/ktx2-sprite.esscene", ESTELLA_VERIFY_MANIFEST: "/scenes/ktx2-sprite.textures.json", ESTELLA_VERIFY_W: "256", ESTELLA_VERIFY_H: "256", ESTELLA_VERIFY_STEPS: "2", ESTELLA_VERIFY_EXPECT: "[{\"x\":0.5,\"y\":0.5,\"rgb\":[0,180,0],\"tol\":50}]" } },
+ { id: "material-instance", tier: "nightly", env: { ESTELLA_VERIFY_SCENE: "/scenes/mat-instance.esscene", ESTELLA_VERIFY_MANIFEST: "/scenes/mat-instance.textures.json", ESTELLA_VERIFY_W: "256", ESTELLA_VERIFY_H: "256", ESTELLA_VERIFY_STEPS: "2", ESTELLA_VERIFY_EXPECT: "[{\"x\":0.5,\"y\":0.5,\"rgb\":[0,255,0],\"tol\":40}]" } },
+ { id: "material-texture", tier: "nightly", env: { ESTELLA_VERIFY_SCENE: "/scenes/mat-tex.esscene", ESTELLA_VERIFY_MANIFEST: "/scenes/mat-tex.textures.json", ESTELLA_VERIFY_W: "256", ESTELLA_VERIFY_H: "256", ESTELLA_VERIFY_STEPS: "2", ESTELLA_VERIFY_EXPECT: "[{\"x\":0.5,\"y\":0.5,\"rgb\":[0,255,0],\"tol\":50}]" } },
+ { id: "material-switch", tier: "nightly", env: { ESTELLA_VERIFY_SCENE: "/scenes/mat-sw.esscene", ESTELLA_VERIFY_MANIFEST: "/scenes/mat-sw.textures.json", ESTELLA_VERIFY_W: "256", ESTELLA_VERIFY_H: "256", ESTELLA_VERIFY_STEPS: "2", ESTELLA_VERIFY_EXPECT: "[{\"x\":0.25,\"y\":0.5,\"rgb\":[255,0,0],\"tol\":50},{\"x\":0.75,\"y\":0.5,\"rgb\":[0,255,0],\"tol\":50}]" } },
+ { id: "material-lit", tier: "nightly", env: { ESTELLA_VERIFY_SCENE: "/scenes/mat-lit.esscene", ESTELLA_VERIFY_MANIFEST: "/scenes/mat-lit.textures.json", ESTELLA_VERIFY_W: "256", ESTELLA_VERIFY_H: "256", ESTELLA_VERIFY_STEPS: "2", ESTELLA_VERIFY_EXPECT: "[{\"x\":0.5,\"y\":0.5,\"rgb\":[0,255,0],\"tol\":50}]" } },
+ { id: "material-lit-point", tier: "pr", webgpu: { ESTELLA_VERIFY_EXPECT: "[{\"x\":0.5,\"y\":0.5,\"rgb\":[0,253,0],\"tol\":25},{\"x\":0.75,\"y\":0.5,\"rgb\":[0,52,0],\"tol\":25}]" }, env: { ESTELLA_VERIFY_SCENE: "/scenes/mat-lit-point.esscene", ESTELLA_VERIFY_MANIFEST: "/scenes/mat-lit-point.textures.json", ESTELLA_VERIFY_W: "256", ESTELLA_VERIFY_H: "256", ESTELLA_VERIFY_STEPS: "2", ESTELLA_VERIFY_EXPECT: "[{\"x\":0.5,\"y\":0.5,\"rgb\":[0,255,0],\"tol\":50},{\"x\":0.75,\"y\":0.5,\"rgb\":[0,64,0],\"tol\":60}]" } },
+ { id: "material-lit-normal", tier: "nightly", env: { ESTELLA_VERIFY_SCENE: "/scenes/mat-lit-normal.esscene", ESTELLA_VERIFY_MANIFEST: "/scenes/mat-lit-normal.textures.json", ESTELLA_VERIFY_W: "256", ESTELLA_VERIFY_H: "256", ESTELLA_VERIFY_STEPS: "2", ESTELLA_VERIFY_EXPECT: "[{\"x\":0.333,\"y\":0.5,\"rgb\":[0,252,0],\"tol\":45},{\"x\":0.667,\"y\":0.5,\"rgb\":[0,36,0],\"tol\":50}]" } },
+ { id: "material-lit-spot", tier: "nightly", env: { ESTELLA_VERIFY_SCENE: "/scenes/mat-lit-spot.esscene", ESTELLA_VERIFY_MANIFEST: "/scenes/mat-lit-spot.textures.json", ESTELLA_VERIFY_W: "256", ESTELLA_VERIFY_H: "256", ESTELLA_VERIFY_STEPS: "2", ESTELLA_VERIFY_EXPECT: "[{\"x\":0.5,\"y\":0.5,\"rgb\":[0,228,0],\"tol\":55},{\"x\":0.75,\"y\":0.5,\"rgb\":[0,0,0],\"tol\":35}]" } },
+ { id: "material-lit-flatnormal", tier: "nightly", env: { ESTELLA_VERIFY_SCENE: "/scenes/mat-lit-flatnormal.esscene", ESTELLA_VERIFY_MANIFEST: "/scenes/mat-lit-flatnormal.textures.json", ESTELLA_VERIFY_W: "256", ESTELLA_VERIFY_H: "256", ESTELLA_VERIFY_STEPS: "2", ESTELLA_VERIFY_EXPECT: "[{\"x\":0.5,\"y\":0.5,\"rgb\":[0,255,0],\"tol\":30}]" } },
+ { id: "sprite-lit", tier: "nightly", env: { ESTELLA_VERIFY_SCENE: "/scenes/sprite-lit.esscene", ESTELLA_VERIFY_MANIFEST: "/scenes/sprite-lit.textures.json", ESTELLA_VERIFY_W: "256", ESTELLA_VERIFY_H: "256", ESTELLA_VERIFY_STEPS: "2", ESTELLA_VERIFY_EXPECT: "[{\"x\":0.5,\"y\":0.5,\"rgb\":[0,255,0],\"tol\":30}]" } },
+ { id: "material-builtin-lit", tier: "nightly", env: { ESTELLA_VERIFY_SCENE: "/scenes/mat-builtin-lit.esscene", ESTELLA_VERIFY_MANIFEST: "/scenes/mat-builtin-lit.textures.json", ESTELLA_VERIFY_W: "256", ESTELLA_VERIFY_H: "256", ESTELLA_VERIFY_STEPS: "2", ESTELLA_VERIFY_EXPECT: "[{\"x\":0.5,\"y\":0.5,\"rgb\":[0,255,0],\"tol\":30}]" } },
+ { id: "material-dissolve", tier: "nightly", env: { ESTELLA_VERIFY_SCENE: "/scenes/mat-dissolve.esscene", ESTELLA_VERIFY_MANIFEST: "/scenes/mat-dissolve.textures.json", ESTELLA_VERIFY_W: "256", ESTELLA_VERIFY_H: "256", ESTELLA_VERIFY_STEPS: "2", ESTELLA_VERIFY_EXPECT: "[{\"x\":0.5,\"y\":0.5,\"rgb\":[255,0,0],\"tol\":30}]" } },
+ { id: "material-graph", tier: "nightly", env: { ESTELLA_VERIFY_SCENE: "/scenes/mat-graph.esscene", ESTELLA_VERIFY_MANIFEST: "/scenes/mat-graph.textures.json", ESTELLA_VERIFY_W: "256", ESTELLA_VERIFY_H: "256", ESTELLA_VERIFY_STEPS: "2", ESTELLA_VERIFY_EXPECT: "[{\"x\":0.5,\"y\":0.5,\"rgb\":[255,0,0],\"tol\":40}]" } },
+ { id: "material-preview", tier: "pr", webgpu: { ESTELLA_VERIFY_EXPECT: "[{\"x\":0.5,\"y\":0.5,\"rgb\":[255,0,0],\"tol\":40}]" }, env: { ESTELLA_VERIFY_SCENE: "/scenes/mat-tint.esscene", ESTELLA_VERIFY_MANIFEST: "/scenes/mat-tint.textures.json", ESTELLA_VERIFY_W: "256", ESTELLA_VERIFY_H: "256", ESTELLA_VERIFY_STEPS: "2", ESTELLA_VERIFY_PREVIEW: "{\"w\":64,\"h\":64,\"rgb\":[255,0,0],\"tol\":45}" } },
+ { id: "tilemap-hex", tier: "nightly", env: { ESTELLA_VERIFY_SCENE: "/scenes/tilemap-hex.esscene", ESTELLA_VERIFY_MANIFEST: "/scenes/tilemap-hex.textures.json", ESTELLA_VERIFY_W: "256", ESTELLA_VERIFY_H: "256", ESTELLA_VERIFY_STEPS: "6", ESTELLA_VERIFY_EXPECT: "[{\"x\":0.40,\"y\":0.40,\"rgb\":[255,0,0]},{\"x\":0.60,\"y\":0.40,\"rgb\":[0,255,0]},{\"x\":0.50,\"y\":0.55,\"rgb\":[0,0,255]},{\"x\":0.70,\"y\":0.55,\"rgb\":[255,255,0]}]" } },
+ { id: "postprocess-lut", tier: "nightly", env: { ESTELLA_VERIFY_PLAY: "1", ESTELLA_VERIFY_SCENE: "/scenes/lut-grade.esscene", ESTELLA_VERIFY_MANIFEST: "/scenes/lut-grade.textures.json", ESTELLA_VERIFY_W: "256", ESTELLA_VERIFY_H: "256", ESTELLA_VERIFY_STEPS: "10", ESTELLA_VERIFY_EXPECT: "[{\"x\":0.292,\"y\":0.5,\"rgb\":[0,0,255],\"tol\":40},{\"x\":0.708,\"y\":0.5,\"rgb\":[255,0,0],\"tol\":40}]" } },
+];
+
+const rank = (tier) => TIERS.indexOf(tier);
+
+/** Scenes that run at `tier`, cheaper tiers included. */
+export function scenesAtTier(tier) {
+ const want = rank(tier);
+ if (want < 0) throw new Error(`unknown tier "${tier}" (have: ${TIERS.join(', ')})`);
+ return SCENES.filter((s) => rank(s.tier) <= want);
+}
+
+/** The scene file a registry entry loads, or null for the default scene. */
+export function sceneFileOf(s) {
+ const p = s.env.ESTELLA_VERIFY_SCENE;
+ return p ? p.replace(/^\//, '') : null;
+}
diff --git a/tools/verify-render.mjs b/tools/verify-render.mjs
new file mode 100644
index 000000000..2a5ff6b98
--- /dev/null
+++ b/tools/verify-render.mjs
@@ -0,0 +1,105 @@
+// SPDX-License-Identifier: Apache-2.0
+// SPDX-FileCopyrightText: Copyright (c) 2024-present ESEngine Team
+/**
+ * @file verify-render.mjs — run the pixel gates a tier pays for.
+ *
+ * One runner over {@link renderScenes.mjs}, so CI and a developer run the same
+ * list by the same names. Reports the whole matrix rather than stopping at the
+ * first failure: which scenes broke is the useful answer, not which broke first.
+ *
+ * node tools/verify-render.mjs --tier pr
+ * node tools/verify-render.mjs --tier pr --backend webgpu
+ * node tools/verify-render.mjs --tier nightly --only spine,video
+ */
+import { spawnSync } from 'node:child_process';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { TIERS, SCENES, scenesAtTier } from './renderScenes.mjs';
+
+const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
+const DESKTOP = path.join(ROOT, 'desktop');
+
+const argv = process.argv.slice(2);
+const flag = (n, d) => {
+ const i = argv.indexOf(`--${n}`);
+ return i >= 0 && argv[i + 1] && !argv[i + 1].startsWith('--') ? argv[i + 1] : d;
+};
+
+const TIER = flag('tier', 'pr');
+const ONLY = flag('only', '');
+const BACKEND = flag('backend', 'webgl2');
+const NO_BUILD = argv.includes('--no-build');
+// CI runners cannot use the SUID sandbox helper (not root-owned in
+// node_modules), and a pixel check does not need it.
+const XVFB = process.platform === 'linux' && !argv.includes('--no-xvfb');
+
+const only = ONLY ? new Set(ONLY.split(',').map((s) => s.trim())) : null;
+if (only) {
+ const known = new Set(SCENES.map((s) => s.id));
+ const bogus = [...only].filter((id) => !known.has(id));
+ if (bogus.length) {
+ console.error(`verify-render: no such scene(s): ${bogus.join(', ')}`);
+ process.exit(2);
+ }
+}
+if (!TIERS.includes(TIER)) {
+ console.error(`verify-render: unknown tier "${TIER}" (have: ${TIERS.join(', ')})`);
+ process.exit(2);
+}
+
+if (!['webgl2', 'webgpu'].includes(BACKEND)) {
+ console.error(`verify-render: unknown backend "${BACKEND}" (have: webgl2, webgpu)`);
+ process.exit(2);
+}
+// A scene runs on the second backend only where it says so: the two backends
+// agree on most frames and deliberately differ on a couple of tolerances, and
+// guessing that per scene is how the WebGPU list became a third copy.
+const selected = (only ? SCENES.filter((s) => only.has(s.id)) : scenesAtTier(TIER))
+ .filter((s) => (BACKEND === 'webgpu' ? Boolean(s.webgpu) : true));
+const scenes = selected.map((s) => ({
+ id: s.id,
+ env: BACKEND === 'webgpu'
+ ? {
+ ...s.env,
+ ...(typeof s.webgpu === 'object' ? s.webgpu : {}),
+ ESTELLA_VERIFY_BACKEND: 'webgpu',
+ ESTELLA_VERIFY_WEBGPU_ADAPTER: 'swiftshader',
+ }
+ : s.env,
+}));
+console.log(`render ${only ? `${scenes.length} named scene(s)` : `${TIER}: ${scenes.length} scene(s)`} on ${BACKEND}`);
+
+if (!NO_BUILD) {
+ const built = spawnSync('pnpm', ['exec', 'vite', 'build'], { cwd: DESKTOP, encoding: 'utf8' });
+ if (built.status !== 0) {
+ console.error(`verify-render: vite build failed\n${(built.stderr || built.stdout || '').slice(-800)}`);
+ process.exit(1);
+ }
+}
+
+const failed = [];
+for (const scene of scenes) {
+ const args = XVFB
+ ? ['-a', 'pnpm', 'exec', 'electron', 'scripts/headless-verify.mjs']
+ : ['exec', 'electron', 'scripts/headless-verify.mjs'];
+ const r = spawnSync(XVFB ? 'xvfb-run' : 'pnpm', args, {
+ cwd: DESKTOP,
+ encoding: 'utf8',
+ env: { ...process.env, ELECTRON_DISABLE_SANDBOX: '1', ...scene.env },
+ });
+ const verdict = ((r.stdout || '').match(/\[verify:render\][^\n]*/) ?? [''])[0];
+ const ok = r.status === 0;
+ if (!ok) failed.push(scene.id);
+ console.log(`${ok ? '✓' : '✗'} ${scene.id.padEnd(28)} ${verdict.replace('[verify:render] ', '')}`);
+ if (!ok) {
+ for (const l of `${r.stdout || ''}${r.stderr || ''}`.split('\n').slice(-8)) {
+ if (l.trim()) console.log(` ${l}`);
+ }
+ }
+}
+
+console.log(`\nrender ${TIER}: ${scenes.length - failed.length}/${scenes.length} scene(s) drew what they claim`);
+if (failed.length) {
+ for (const id of failed) console.log(` ✗ ${id}`);
+ process.exit(1);
+}