Profiler: real-GPU breakdown by zoom, look and scene, with a baseline (t88 phase 0)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

docs/PROJECT_MAP.md

@@ -20,7 +20,7 @@ src/ui/               the browser shell: input, HUD, build menu, notebook, setti
                       audio, the frame loop
 test/                 headless suites (t_*.js) and their harness; browser tests (play.py,
                       t_smooth.py, t_dev_console.py); run_all.py
-tools/                serve.py (build, serve, rebuild on change), shot.py (screenshots),
+tools/                serve.py (build, serve, rebuild on change), server.py (isolated HTTP), shot.py (screenshots),
                       where.py, map.py, perf.py, playthrough.py, use_venv.py (switches browser
                       scripts to .venv), scenes/ (screenshot setups), experiments/
                       (measurements and reports)
@@ -405,7 +405,7 @@ Screw casing geometry shared by both looks, ghosts and placement previews. smoot
 - functions: diagonalScrewJoins, straightScrewJoins, diagonalScrewShape, diagonalScrewBlock
 - variables: SCREW_CLASS, diagonalJoins, diagonalAcross, diagonalAlong, diagonalCap
 
-### src/render/world.js (404 lines)
+### src/render/world.js (419 lines)
 Scale colour without changing the smooth-look class.
 - functions: fogColor, drawWorld
 
@@ -418,7 +418,7 @@ Other overlays: floating text, rain and snow, flow arrows, filter tags, molds, t
 - functions: spawnFloater, drawRain, drawFlowArrows, drawJoinMark, drawJoinMarks, flowLoaded, drawFlowRates, pingImage, drawPing, drawHoveredVein, drawPingRecharge, drawRunOutline, drawFilterTags, drawFloaters, moldLabel, drawMolds, drawBot, spawnDebris, spawnSpark, spawnSuck, drawParticles
 - variables: PING_SPEED, PING_HOLD, PING_FADE, PING_BANDS, PING_GLINTS, GLINT_MS
 
-### src/render/smooth.js (99 lines)
+### src/render/smooth.js (103 lines)
 Smooth look: WebGL setup, texture uploads, drawing and adaptive resolution.
 - functions: smCompile, smoothAvailable, smUpload, smoothDraw, smoothPace
 - variables: SM, smBytes
@@ -553,7 +553,11 @@ Shared world colours, minimap and full map.
 - functions: resetMap, mapArea, updateMap, drawMap, mapFit, drawFullMap, openMap, zoomMap, zoomMinimap
 - variables: MAP_S, MAP
 
-### src/ui/loop.js (140 lines)
+### src/ui/perf.js (15 lines)
+Browser-only clocks; simulation code stays usable without a browser or a clock.
+- variables: PERF_MARKS, PERF_FRAME, perfMarks, perfTimes, perfLast
+
+### src/ui/loop.js (148 lines)
 The frame loop and boot.
 - functions: scanVisible, frame, boot
 - variables: lastT, acc, lastRender, frameMs, simMs, fpsSm, ambientT
@@ -583,6 +587,7 @@ The frame loop and boot.
 - `test/t_load.js`: Reload wakes nearby areas first, without losing distant water, fire or saved state.
 - `test/t_molds.js`: Molds and furnaces stay usable: ingots drop below and keep their stubs, plugs over molds are cleared, spoiled castings can be knocked out, grains never drop through a grate by teleporting, and slag lets the fire breathe.
 - `test/t_nozzle.js`: Blowing aims within the nozzle's reach, with room for the brush and settling.
+- `test/t_perf.js`: Profiling fixtures start in the same state after previous scenes and warm-up ticks.
 - `test/t_physics.js`: Sand and other powders, molten metal and gases: heaps, sorting, sinking, setting, rising and fading. Water has its own suite (t_water.js). Tall worlds keep geothermal heat out of the way.
 - `test/t_pipes.js`: Pipes, pumps and outlets move liquids; the Grinder grinds waste rock for trace ore.
 - `test/t_racks.js`: Rack intake, FIFO storage, gate, removal and saved-state validation.
@@ -597,10 +602,14 @@ The frame loop and boot.
 - `test/t_weather.js`: Weather: no more springs; steam rises into clouds and rains back; showers; snow when it is freezing.
 - `test/t_world.js`: Trees from acorns, charcoal, brick, density, water/lava/snow/ice, full-bag refunds, drill reach, ballistic blowing, snowy mountains.
 - `tools/map.py`: Regenerate the file and symbol index at the end of docs/PROJECT_MAP.md.
-- `tools/perf.py`: Times the renderer and the simulation in a headless browser: light, drawWorld (with and without light and glow), the pixel upload and blit, and one simulation tick, in ms. Rebuild first.
+- `tools/perf-measure.js`: Temporary wrappers live only in the profiling page, never in the simulation bundle.
+- `tools/perf-scenes.js`: Seeded worlds, no storage round-trip (saves quantize heat and land flying grains).
+- `tools/perf.py`: Profile a seeded world on the real GPU, with isolated HTTP serving. Times are milliseconds.
 - `tools/playthrough.py`: Headless browser run: load the page, start a world, play a little, take screenshots.
 - `tools/serve.py`: Build, serve and rebuild when sources change: python3 tools/serve.py [--port 8000].
+- `tools/server.py`: Serve dist/ with isolation headers; isolated_server() owns a free-port background server.
 - `tools/shot.py`: Screenshot the game in a headless browser, after setting up a scene with JavaScript.
+- `tools/test_perf.py`: Profiler checks: headers, summaries/comparison, and unchanged pixels/simulation with clocks on.
 - `tools/use_venv.py`: Let browser scripts run with plain python3 by switching to the repo's .venv.
 - `tools/where.py`: Turn a line number in dist/index.html into the source file and line it came from.
 - `tools/experiments/cast_sunk_mold.js`: Block-sized bit mold sunk into the ground with a stone furnace built over its funnel.