@adatechnology/game-test-room 0.2.0 → 0.3.0

package/dist/index.global.js

@@ -29,7 +29,9 @@ var GameTestRoom = (() => {
     buildFromSpec: () => buildFromSpec,
     createLog: () => createLog,
     createTestRoom: () => createTestRoom,
+    decodeBenchState: () => decodeBenchState,
     demoItems: () => demoItems,
+    encodeBenchState: () => encodeBenchState,
     locales: () => locales4,
     makeScenarios: () => makeScenarios,
     resolveStrings: () => resolveStrings4,
@@ -240,6 +242,47 @@ var GameTestRoom = (() => {
     });
     return { ok: problems.length === 0, problems };
   };
+  var SNAKE_CASE = /^[a-z][a-z0-9_]*$/;
+  var finite2 = (n) => typeof n === "number" && Number.isFinite(n);
+  function checkControl(control, problems) {
+    const label = `control "${control.id}"`;
+    if (control.kind === "number") {
+      if (!finite2(control.min) || !finite2(control.max) || control.min >= control.max) problems.push(`${label} needs min < max`);
+      if (control.step !== void 0 && !(finite2(control.step) && control.step > 0)) problems.push(`${label} needs a step > 0`);
+      if (!finite2(control.default) || control.default < control.min || control.default > control.max) problems.push(`${label} default ${String(control.default)} is outside ${control.min}..${control.max}`);
+      return;
+    }
+    if (control.kind !== "choice") return;
+    if (control.options.length === 0) {
+      problems.push(`${label} needs at least one option`);
+      return;
+    }
+    const seen = /* @__PURE__ */ new Set();
+    for (const option of control.options) {
+      if (seen.has(option.id)) problems.push(`${label} repeats option "${option.id}"`);
+      seen.add(option.id);
+    }
+    if (!seen.has(control.default)) problems.push(`${label} default "${control.default}" is not among its options`);
+  }
+  function checkBench(declared) {
+    const problems = [];
+    const ids = /* @__PURE__ */ new Set();
+    const claim = (kind, id) => {
+      if (!SNAKE_CASE.test(id)) problems.push(`${kind} id "${id}" must be snake_case`);
+      if (ids.has(id)) problems.push(`duplicate id "${id}" across controls, layers and metrics`);
+      ids.add(id);
+    };
+    for (const control of declared.controls ?? []) {
+      claim("control", control.id);
+      checkControl(control, problems);
+    }
+    for (const layer of declared.layers ?? []) claim("layer", layer.id);
+    for (const metric of declared.metrics ?? []) {
+      claim("metric", metric.id);
+      if (metric.max !== void 0 && !(finite2(metric.max) && metric.max > 0)) problems.push(`metric "${metric.id}" needs a max > 0`);
+    }
+    return { ok: problems.length === 0, problems };
+  }
 
   // ../game-destruction/dist/index.js
   var EPS = 1e-9;
@@ -2940,13 +2983,13 @@ var GameTestRoom = (() => {
           ...impls.size ? { impls: [...impls.values()].map((im) => ({ id: im.impl.id, position: [...im.position], rotation: [...im.rotation], data: im.impl.serialize?.() })) } : {}
         };
       },
-      load(snap) {
-        if (snap.version !== 1) throw new Error(`unsupported snapshot version ${String(snap.version)}`);
+      load(snap2) {
+        if (snap2.version !== 1) throw new Error(`unsupported snapshot version ${String(snap2.version)}`);
         objects.clear();
-        time = snap.time;
-        rng.set(snap.rng);
-        counter = snap.counter ?? 0;
-        for (const e of snap.objects) {
+        time = snap2.time;
+        rng.set(snap2.rng);
+        counter = snap2.counter ?? 0;
+        for (const e of snap2.objects) {
           const state = clone(e.state);
           const carry = {
             parts: new Map(
@@ -2957,7 +3000,7 @@ var GameTestRoom = (() => {
           };
           objects.set(e.id, build(clone(e.spec), e.id, state.position, state.rotation, carry));
         }
-        for (const e of snap.impls ?? []) {
+        for (const e of snap2.impls ?? []) {
           const im = impls.get(e.id);
           if (!im) continue;
           im.position = [e.position[0], e.position[1], e.position[2]];
@@ -3644,6 +3687,8 @@ void main() {
       __publicField(this, "alphaMul");
       __publicField(this, "tag");
       __publicField(this, "colorHex");
+      __publicField(this, "rgbStart");
+      __publicField(this, "rgbEnd");
       __publicField(this, "bounced");
       const n = Math.max(1, capacity);
       this.pos = new Float32Array(n * 3);
@@ -3660,6 +3705,8 @@ void main() {
       this.alphaMul = new Float32Array(n);
       this.tag = new Int32Array(n);
       this.colorHex = new Int32Array(n);
+      this.rgbStart = new Float32Array(n * 3);
+      this.rgbEnd = new Float32Array(n * 3);
       this.bounced = new Uint8Array(n);
       this.geometry = new THREE.BufferGeometry();
       const attr = (a, size) => {
@@ -3707,6 +3754,8 @@ void main() {
       this.alphaMul[i] = o?.alpha ?? 1;
       this.tag[i] = o?.tag ?? 0;
       this.colorHex[i] = o?.color ?? -1;
+      this.rgbStart.set(hexToRgb(o?.color ?? def.c0), i * 3);
+      this.rgbEnd.set(hexToRgb(o?.color ?? def.c1), i * 3);
       this.bounced[i] = 0;
       this.siz[i] = this.size0[i];
       this.alp[i] = 0;
@@ -3800,13 +3849,9 @@ void main() {
         this.pos[i3 + 1] = y;
         this.pos[i3 + 2] = z;
         this.siz[i] = this.size0[i] * lerp(1, def.grow, t);
-        const c0 = this.colorHex[i] >= 0 ? this.colorHex[i] : def.c0;
-        const c1 = this.colorHex[i] >= 0 ? this.colorHex[i] : def.c1;
-        const a = hexToRgb(c0);
-        const b = hexToRgb(c1);
-        this.col[i3] = lerp(a[0], b[0], t);
-        this.col[i3 + 1] = lerp(a[1], b[1], t);
-        this.col[i3 + 2] = lerp(a[2], b[2], t);
+        this.col[i3] = lerp(this.rgbStart[i3], this.rgbEnd[i3], t);
+        this.col[i3 + 1] = lerp(this.rgbStart[i3 + 1], this.rgbEnd[i3 + 1], t);
+        this.col[i3 + 2] = lerp(this.rgbStart[i3 + 2], this.rgbEnd[i3 + 2], t);
         let env = t < def.fadeIn ? t / def.fadeIn : 1 - (t - def.fadeIn) / (1 - def.fadeIn);
         if (def.flicker) env *= 1 - def.flicker * (0.5 + 0.5 * Math.sin(age * 38 + this.seed[i] * 50));
         this.alp[i] = clamp3(env, 0, 1) * def.alpha * this.alphaMul[i];
@@ -6078,6 +6123,9 @@ void main() {
     emit(kind, point, normal, count, speed) {
       this.particles.burst(kind, point, normal, count, speed ?? DEFAULT_SPEED[kind] ?? 1, kind === "smoke" ? { color: SMOKE_TONES.grey } : void 0);
     }
+    explode(point, energy, radius) {
+      this.onExplode({ type: "explode", object: "", part: "", time: this.time, point, energy, radius });
+    }
     restore(objectId) {
       const homes = /* @__PURE__ */ new Set([objectId]);
       const self = this.bounds.get(objectId);
@@ -9275,22 +9323,22 @@ void main() {
         return snapshot;
       },
       load(input) {
-        const snap = clone2(input);
-        if (!snap || snap.version !== 1) throw new Error("game-fluids: unsupported snapshot");
-        time = snap.time;
+        const snap2 = clone2(input);
+        if (!snap2 || snap2.version !== 1) throw new Error("game-fluids: unsupported snapshot");
+        time = snap2.time;
         rng = new Rng(0);
-        rng.state = snap.rng;
-        counters.container = snap.counters.container;
-        counters.stream = snap.counters.stream;
-        counters.stain = snap.counters.stain;
+        rng.state = snap2.rng;
+        counters.container = snap2.counters.container;
+        counters.stream = snap2.counters.stream;
+        counters.stain = snap2.counters.stain;
         containers = /* @__PURE__ */ new Map();
-        for (const raw of snap.containers) containers.set(raw.id, { ...raw, cols: makeColumns(raw.spec.shape) });
+        for (const raw of snap2.containers) containers.set(raw.id, { ...raw, cols: makeColumns(raw.spec.shape) });
         surfaces = /* @__PURE__ */ new Map();
-        for (const s of snap.surfaces) world.addSurface(s);
-        counters.tap = snap.counters.tap ?? 0;
-        streams = new Map(snap.streams.map((s) => [s.id, s]));
-        taps = new Map((snap.taps ?? []).map((t) => [t.id, t]));
-        stains = new Map(snap.stains.map((s) => [s.id, s]));
+        for (const s of snap2.surfaces) world.addSurface(s);
+        counters.tap = snap2.counters.tap ?? 0;
+        streams = new Map(snap2.streams.map((s) => [s.id, s]));
+        taps = new Map((snap2.taps ?? []).map((t) => [t.id, t]));
+        stains = new Map(snap2.stains.map((s) => [s.id, s]));
         queue = [];
       }
     };
@@ -11170,6 +11218,21 @@ void main() {
       "ui.animations": "Animations",
       "ui.animations_aim": "Aim at an item or hold it to see its animations.",
       "ui.animations_none": "This item brings no animations.",
+      "mod.bench_ok": "{name}: bench ok ({controls} controls, {layers} layers, {metrics} metrics)",
+      "mod.bench_fail": "{name}: bench broken: {problems}",
+      "mod.metric_failed": '{name}: metric "{metric}" threw and shows n/a: {error}',
+      "mod.listener_failed": "{name}: a bench listener threw: {error}",
+      "ui.bench": "Bench",
+      "ui.layers": "Layers",
+      "ui.metrics": "Counters",
+      "metric.fps": "FPS",
+      "metric.frame_ms": "ms/frame",
+      "metric.draw_calls": "Draw calls",
+      "metric.triangles": "Triangles",
+      "metric.objects": "Objects",
+      "metric.fragments": "Fragments",
+      "metric.particles": "Particles",
+      "metric.decals": "Decals",
       "act.spawn": "Spawned {name} at x {x} \xB7 z {z}",
       "act.clear": "Cleared the room",
       "act.reset": "Repaired every object",
@@ -11462,6 +11525,21 @@ void main() {
       "ui.animations": "Anima\xE7\xF5es",
       "ui.animations_aim": "Mire num item ou segure-o para ver as anima\xE7\xF5es.",
       "ui.animations_none": "Este item n\xE3o traz anima\xE7\xF5es.",
+      "mod.bench_ok": "{name}: bancada ok ({controls} controles, {layers} camadas, {metrics} contadores)",
+      "mod.bench_fail": "{name}: bancada quebrada: {problems}",
+      "mod.metric_failed": '{name}: o contador "{metric}" lan\xE7ou erro e mostra n/a: {error}',
+      "mod.listener_failed": "{name}: um ouvinte da bancada lan\xE7ou erro: {error}",
+      "ui.bench": "Bancada",
+      "ui.layers": "Camadas",
+      "ui.metrics": "Contadores",
+      "metric.fps": "FPS",
+      "metric.frame_ms": "ms/quadro",
+      "metric.draw_calls": "Chamadas de desenho",
+      "metric.triangles": "Tri\xE2ngulos",
+      "metric.objects": "Objetos",
+      "metric.fragments": "Fragmentos",
+      "metric.particles": "Part\xEDculas",
+      "metric.decals": "Decalques",
       "act.spawn": "Criou {name} em x {x} \xB7 z {z}",
       "act.clear": "Limpou a sala",
       "act.reset": "Consertou todos os objetos",
@@ -12073,6 +12151,154 @@ void main() {
     };
   }
 
+  // src/bench.ts
+  var snap = (control, value) => {
+    const clamped = Math.min(control.max, Math.max(control.min, value));
+    if (!control.step) return clamped;
+    const stepped = control.min + Math.round((clamped - control.min) / control.step) * control.step;
+    return Number(Math.min(control.max, stepped).toFixed(10));
+  };
+  function fitValue(control, value) {
+    if (control.kind === "number") return typeof value === "number" && Number.isFinite(value) ? snap(control, value) : void 0;
+    if (control.kind === "boolean") return typeof value === "boolean" ? value : void 0;
+    if (control.kind === "choice") return typeof value === "string" && control.options.some((option) => option.id === value) ? value : void 0;
+    return void 0;
+  }
+  var fromText = (control, text) => {
+    if (control.kind === "number") return text.trim() === "" ? Number.NaN : Number(text);
+    if (control.kind === "boolean") return text === "1" ? true : text === "0" ? false : void 0;
+    return text;
+  };
+  var toText = (value) => typeof value === "boolean" ? value ? "1" : "0" : String(value);
+  function encodeBenchState(controls, layers) {
+    const pairs = [];
+    for (const control of controls) if (control.value !== void 0) pairs.push(`${control.id}=${encodeURIComponent(toText(control.value))}`);
+    for (const layer of layers) pairs.push(`${layer.id}=${layer.on ? "1" : "0"}`);
+    return pairs.join(";");
+  }
+  function decodeBenchState(encoded, controls, layers) {
+    const out = /* @__PURE__ */ new Map();
+    for (const pair of encoded.split(";")) {
+      const at = pair.indexOf("=");
+      if (at <= 0) continue;
+      const id = pair.slice(0, at);
+      let text;
+      try {
+        text = decodeURIComponent(pair.slice(at + 1));
+      } catch {
+        continue;
+      }
+      const control = controls.find((c) => c.id === id);
+      if (control) {
+        const value = fitValue(control, fromText(control, text));
+        if (value !== void 0) out.set(id, value);
+        continue;
+      }
+      if (layers.some((layer) => layer.id === id) && (text === "1" || text === "0")) out.set(id, text === "1");
+    }
+    return out;
+  }
+  function createBenchStore(module, locale, onListenerError) {
+    const declared = { controls: module.controls?.(locale) ?? [], layers: module.layers?.(locale) ?? [], metrics: module.metrics?.(locale) ?? [] };
+    const controls = declared.controls.map((control) => ({ ...control, disabled: false }));
+    const values = /* @__PURE__ */ new Map();
+    for (const control of controls) if (control.kind !== "action") values.set(control.id, control.default);
+    const layers = new Map(declared.layers.map((layer) => [layer.id, layer.default !== false]));
+    const listeners = /* @__PURE__ */ new Set();
+    const watchers = /* @__PURE__ */ new Set();
+    const emit = (change) => {
+      for (const listener of listeners) {
+        try {
+          listener(change);
+        } catch (error) {
+          onListenerError?.(error);
+        }
+      }
+    };
+    const changed = () => {
+      for (const watcher of watchers) watcher();
+    };
+    const controlOf = (id) => controls.find((control) => control.id === id);
+    const store = {
+      moduleId: module.id,
+      metrics: declared.metrics,
+      declared,
+      controls: () => controls.map((control) => ({ ...control, value: values.get(control.id) })),
+      layers: () => declared.layers.map((layer) => ({ ...layer, on: layers.get(layer.id) === true })),
+      value: (id) => values.get(id),
+      layer: (id) => layers.get(id) === true,
+      set(id, value) {
+        const control = controlOf(id);
+        if (!control || control.disabled) return false;
+        const fitted = fitValue(control, value);
+        if (fitted === void 0) return false;
+        values.set(id, fitted);
+        emit({ kind: "control", id, value: fitted });
+        changed();
+        return true;
+      },
+      setLayer(id, on) {
+        if (!layers.has(id)) return false;
+        layers.set(id, on);
+        emit({ kind: "layer", id, on });
+        changed();
+        return true;
+      },
+      act(id) {
+        const control = controlOf(id);
+        if (!control || control.kind !== "action" || control.disabled) return false;
+        emit({ kind: "action", id });
+        return true;
+      },
+      encode: () => encodeBenchState(store.controls(), store.layers()),
+      onChange(listener) {
+        listeners.add(listener);
+        return () => listeners.delete(listener);
+      },
+      watch(listener) {
+        watchers.add(listener);
+        return () => watchers.delete(listener);
+      },
+      patch(id, patch) {
+        const index = controls.findIndex((control2) => control2.id === id);
+        if (index < 0) return;
+        let control = controls[index];
+        if (patch.hidden !== void 0) control = { ...control, hidden: patch.hidden };
+        if (patch.disabled !== void 0) control = { ...control, disabled: patch.disabled };
+        if (patch.options && control.kind === "choice" && patch.options.length > 0) {
+          control = { ...control, options: [...patch.options] };
+          const offered = control.options;
+          if (!offered.some((option) => option.id === values.get(id))) values.set(id, offered[0].id);
+        }
+        controls[index] = control;
+        if (patch.value !== void 0) {
+          const fitted = fitValue(control, patch.value);
+          if (fitted !== void 0) values.set(id, fitted);
+        }
+        changed();
+      },
+      sendInitial() {
+        for (const control of controls) {
+          const value = values.get(control.id);
+          if (value !== void 0) emit({ kind: "control", id: control.id, value });
+        }
+        for (const layer of declared.layers) emit({ kind: "layer", id: layer.id, on: layers.get(layer.id) === true });
+        changed();
+      },
+      restore(encoded) {
+        for (const [id, value] of decodeBenchState(encoded, controls, declared.layers)) {
+          if (typeof value === "boolean" && layers.has(id)) layers.set(id, value);
+          else values.set(id, value);
+        }
+      },
+      dispose() {
+        listeners.clear();
+        watchers.clear();
+      }
+    };
+    return store;
+  }
+
   // src/log.ts
   var MAX_ENTRIES = 5e3;
   var pad = (n, w = 2) => String(n).padStart(w, "0");
@@ -12201,6 +12427,56 @@ void main() {
     return log;
   }
 
+  // src/metrics.ts
+  var ROOM_METRICS = ["fps", "frame_ms", "draw_calls", "triangles", "objects", "fragments", "particles", "decals"];
+  var WINDOW_S = 0.5;
+  function createRoomMetrics(sources) {
+    const wanted = new Set(sources.ids);
+    const gl = sources.gl;
+    let windowS = 0;
+    let frames = 0;
+    let fps;
+    let frameMs;
+    let calls;
+    let triangles;
+    let ownsRender = false;
+    return {
+      frame(dt) {
+        frames++;
+        windowS += dt;
+        if (windowS < WINDOW_S) return;
+        fps = frames / windowS;
+        frameMs = windowS / frames * 1e3;
+        frames = 0;
+        windowS = 0;
+      },
+      rendered() {
+        ownsRender = true;
+        calls = gl.info?.render?.calls;
+        triangles = gl.info?.render?.triangles;
+      },
+      sample() {
+        const out = {};
+        const put = (id, value) => {
+          if (wanted.has(id) && value !== void 0) out[id] = value;
+        };
+        put("fps", fps);
+        put("frame_ms", frameMs);
+        const render = ownsRender ? { calls, triangles } : gl.info?.render;
+        put("draw_calls", render?.calls);
+        put("triangles", render?.triangles);
+        if (!["objects", "fragments", "particles", "decals"].some((id) => wanted.has(id))) return out;
+        const destruction = sources.destruction.stats();
+        const fluids = sources.fluids.stats();
+        put("objects", destruction.pieces);
+        put("fragments", destruction.fragments);
+        put("particles", destruction.particles + fluids.particles);
+        put("decals", destruction.decals + fluids.stains);
+        return out;
+      }
+    };
+  }
+
   // src/narrate.ts
   var SKIP_DAMAGE = /* @__PURE__ */ new Set(["fire", "heat"]);
   function createNarrator(c) {
@@ -13270,6 +13546,209 @@ void main() {
   }
   var SCENARIOS = scenariosFor("en");
 
+  // src/bench-panel.ts
+  var SEGMENTED_MAX = 4;
+  var mk = (tag, cls, text) => {
+    const e = document.createElement(tag);
+    if (cls) e.className = cls;
+    if (text !== void 0) e.textContent = text;
+    return e;
+  };
+  var shapeOf = (view) => JSON.stringify([view.title, view.controls.map((c) => ({ ...c, value: void 0 })), view.layers.map((l) => [l.id, l.name])]);
+  function createBenchPanel(o) {
+    const { t } = o;
+    const element = mk("div", "tr-panel tr-bench");
+    element.style.display = "none";
+    element.addEventListener("keydown", (e) => e.stopPropagation());
+    const roomLine = mk("div", "sub tr-bench-room");
+    const body = mk("div");
+    const metricTitle = mk("div", "sub", t("ui.metrics"));
+    metricTitle.style.display = "none";
+    const metricList = mk("dl", "tr-metrics");
+    element.append(mk("h3", void 0, t("ui.bench")), roomLine, body, metricTitle, metricList);
+    let shape = "";
+    let hasRoom = false;
+    let hasBench = false;
+    const refreshers = [];
+    const metricNodes = /* @__PURE__ */ new Map();
+    let metricKey = "";
+    const syncDisplay = () => {
+      element.style.display = hasRoom || hasBench ? "" : "none";
+    };
+    const numberControl = (control) => {
+      const wrap = mk("label", "tr-ctl");
+      const input = mk("input");
+      input.type = "range";
+      input.min = String(control.min);
+      input.max = String(control.max);
+      input.step = control.step ? String(control.step) : "any";
+      input.disabled = control.disabled;
+      const reading = mk("output");
+      input.oninput = () => o.onControl(control.id, Number(input.value));
+      wrap.append(mk("span", void 0, control.name), input, reading);
+      refreshers.push((view) => {
+        const value = view.controls.find((c) => c.id === control.id)?.value;
+        if (typeof value !== "number") return;
+        if (Number(input.value) !== value) input.value = String(value);
+        reading.textContent = `${o.num(value, control.step && control.step >= 1 ? 0 : 2)}${control.unit ? ` ${control.unit}` : ""}`;
+      });
+      return wrap;
+    };
+    const booleanControl = (control) => {
+      const wrap = mk("label", "tr-ctl");
+      const box2 = mk("input");
+      box2.type = "checkbox";
+      box2.disabled = control.disabled;
+      box2.onchange = () => o.onControl(control.id, box2.checked);
+      wrap.append(box2, document.createTextNode(` ${control.name}`));
+      refreshers.push((view) => {
+        box2.checked = view.controls.find((c) => c.id === control.id)?.value === true;
+      });
+      return wrap;
+    };
+    const choiceControl = (control) => {
+      const wrap = mk("div", "tr-ctl");
+      wrap.appendChild(mk("span", void 0, control.name));
+      if (control.options.length <= SEGMENTED_MAX) {
+        const group = mk("div", "tr-seg");
+        group.setAttribute("role", "group");
+        const buttons = control.options.map((option) => {
+          const b = mk("button", "tr-btn", option.name);
+          b.type = "button";
+          b.disabled = control.disabled;
+          b.onclick = () => o.onControl(control.id, option.id);
+          group.appendChild(b);
+          return { b, id: option.id };
+        });
+        wrap.appendChild(group);
+        refreshers.push((view) => {
+          const value = view.controls.find((c) => c.id === control.id)?.value;
+          for (const { b, id } of buttons) {
+            b.setAttribute("aria-pressed", String(id === value));
+            b.classList.toggle("on", id === value);
+          }
+        });
+        return wrap;
+      }
+      const select = mk("select");
+      select.disabled = control.disabled;
+      for (const option of control.options) {
+        const op = mk("option", void 0, option.name);
+        op.value = option.id;
+        select.appendChild(op);
+      }
+      select.onchange = () => o.onControl(control.id, select.value);
+      wrap.appendChild(select);
+      refreshers.push((view) => {
+        const value = view.controls.find((c) => c.id === control.id)?.value;
+        if (typeof value === "string") select.value = value;
+      });
+      return wrap;
+    };
+    const actionControl = (control) => {
+      const b = mk("button", "tr-btn", control.name);
+      b.type = "button";
+      b.disabled = control.disabled;
+      b.onclick = () => o.onAction(control.id);
+      return b;
+    };
+    const controlElement = (control) => {
+      const el = control.kind === "number" ? numberControl(control) : control.kind === "boolean" ? booleanControl(control) : control.kind === "choice" ? choiceControl(control) : actionControl(control);
+      if (control.hint) el.title = control.hint;
+      return el;
+    };
+    const layerList = (layers) => {
+      const wrap = mk("div", "tr-layers");
+      wrap.appendChild(mk("div", "sub", t("ui.layers")));
+      for (const layer of layers) {
+        const label = mk("label", "tr-ctl");
+        const box2 = mk("input");
+        box2.type = "checkbox";
+        box2.onchange = () => o.onLayer(layer.id, box2.checked);
+        label.append(box2, document.createTextNode(` ${layer.name}`));
+        wrap.appendChild(label);
+        refreshers.push((view) => {
+          box2.checked = view.layers.find((l) => l.id === layer.id)?.on === true;
+        });
+      }
+      return wrap;
+    };
+    const rebuild = (view) => {
+      body.textContent = "";
+      refreshers.length = 0;
+      body.appendChild(mk("div", "sub", view.title));
+      const list = mk("div", "tr-ctls");
+      for (const control of view.controls) if (!control.hidden) list.appendChild(controlElement(control));
+      body.appendChild(list);
+      if (view.layers.length) body.appendChild(layerList(view.layers));
+    };
+    const renderMetrics = (rows) => {
+      metricList.textContent = "";
+      metricNodes.clear();
+      metricTitle.style.display = rows.length ? "" : "none";
+      for (const row of rows) {
+        const dd = mk("dd");
+        const text = mk("span", void 0, row.text);
+        dd.appendChild(text);
+        let bar = null;
+        if (row.ratio !== void 0) {
+          bar = mk("div", "tr-bar");
+          bar.appendChild(mk("i"));
+          dd.appendChild(bar);
+        }
+        metricList.append(mk("dt", void 0, row.name), dd);
+        metricNodes.set(row.id, { text, bar });
+      }
+    };
+    const fillBar = (bar, ratio) => {
+      bar.className = `tr-bar${ratio > 1 ? " bad" : ratio >= 0.8 ? " warn" : ""}`;
+      const fill = bar.firstElementChild;
+      fill.style.width = `${Math.round(Math.max(0, Math.min(1, ratio)) * 100)}%`;
+    };
+    return {
+      element,
+      show(view) {
+        hasBench = view !== null;
+        syncDisplay();
+        if (!view) {
+          shape = "";
+          body.textContent = "";
+          refreshers.length = 0;
+          renderMetrics([]);
+          metricKey = "";
+          return;
+        }
+        const next = shapeOf(view);
+        if (next !== shape) {
+          shape = next;
+          rebuild(view);
+        }
+        for (const refresh of refreshers) refresh(view);
+      },
+      metrics(rows) {
+        hasRoom = rows.room.length > 0;
+        syncDisplay();
+        roomLine.textContent = rows.room.map((row) => `${row.name} ${row.text}`).join(" \xB7 ");
+        const key = rows.module.map((row) => `${row.id}:${row.ratio !== void 0}`).join("|");
+        if (key !== metricKey) {
+          metricKey = key;
+          renderMetrics(rows.module);
+        }
+        for (const row of rows.module) {
+          const node = metricNodes.get(row.id);
+          if (!node) continue;
+          node.text.textContent = row.text;
+          if (node.bar && row.ratio !== void 0) fillBar(node.bar, row.ratio);
+        }
+      },
+      get visible() {
+        if (element.style.display === "none") return false;
+        const parent = element.parentElement;
+        return !parent || getComputedStyle(parent).display !== "none";
+      }
+    };
+  }
+
   // src/ui.ts
   var CSS = `
 .tr-root{position:absolute;inset:0;pointer-events:none;font:12px/1.35 system-ui,-apple-system,"Segoe UI",Roboto,sans-serif;color:#e8eaee;overflow:hidden}
@@ -13322,6 +13801,13 @@ void main() {
 .tr-cat{flex:0 1 auto;max-height:40%}
 .tr-anim{flex:0 0 auto;max-height:18%}
 .tr-anim .list{display:flex;flex-wrap:wrap;gap:4px}.tr-anim .sub{color:#9aa3b2;margin-bottom:4px}
+.tr-bench{flex:0 1 auto;max-height:34%}
+.tr-bench .sub{color:#9aa3b2;margin-bottom:4px}
+.tr-ctls{display:flex;flex-direction:column;gap:5px}
+.tr-ctl{display:flex;flex-wrap:wrap;align-items:center;gap:6px}.tr-ctl input[type=range]{flex:1;min-width:90px}.tr-ctl output{min-width:48px;text-align:right;color:#cfd3da}
+.tr-seg{display:inline-flex;flex-wrap:wrap;gap:2px}
+.tr-layers{margin-top:6px;display:flex;flex-direction:column;gap:2px}
+.tr-metrics{display:grid;grid-template-columns:auto 1fr;gap:2px 8px;margin:6px 0 0}.tr-metrics dt{color:#9aa3b2}.tr-metrics dd{margin:0}
 .tr-tests{flex:1 1 auto;min-height:100px}
 .tr-tests .list{display:flex;flex-direction:column;gap:3px;margin-top:6px}.tr-tests .list .tr-btn{text-align:left}
 .tr-row{display:flex;flex-wrap:wrap;gap:4px;margin-top:6px;align-items:center}
@@ -13330,7 +13816,7 @@ void main() {
 @media (max-width:980px){.tr-left,.tr-right{display:none}.tr-root.open .tr-left,.tr-root.open .tr-right{display:flex}.tr-toggle{display:block;pointer-events:auto}.tr-root.open .tr-toggle{right:min(310px,34vw)}.tr-left{width:min(400px,46vw)}.tr-help{display:none}}
 `;
   var fold = (text) => text.normalize("NFD").replace(/[\u0300-\u036f]/g, "").toLowerCase();
-  var mk = (tag, cls, text) => {
+  var mk2 = (tag, cls, text) => {
     const e = document.createElement(tag);
     if (cls) e.className = cls;
     if (text !== void 0) e.textContent = text;
@@ -13338,42 +13824,42 @@ void main() {
   };
   function createUi(o) {
     const { t } = o;
-    const style = mk("style");
+    const style = mk2("style");
     style.textContent = CSS;
-    const root = mk("div", "tr-root");
+    const root = mk2("div", "tr-root");
     const pos = getComputedStyle?.(o.container)?.position;
     if (!pos || pos === "static") o.container.style.position = "relative";
     root.appendChild(style);
     o.container.appendChild(root);
-    const cross4 = mk("div", "tr-cross");
-    cross4.appendChild(mk("i"));
-    const top = mk("div", "tr-top");
-    const toolBox = mk("div", "tr-tool");
-    const status = mk("div", "tr-status");
-    const prog = mk("div", "tr-prog");
-    const progLabel = mk("b");
-    const progBar = mk("div", "tr-bar");
-    const progFill = mk("i");
+    const cross4 = mk2("div", "tr-cross");
+    cross4.appendChild(mk2("i"));
+    const top = mk2("div", "tr-top");
+    const toolBox = mk2("div", "tr-tool");
+    const status = mk2("div", "tr-status");
+    const prog = mk2("div", "tr-prog");
+    const progLabel = mk2("b");
+    const progBar = mk2("div", "tr-bar");
+    const progFill = mk2("i");
     progBar.appendChild(progFill);
     prog.append(progLabel, progBar);
     top.append(toolBox, status, prog);
-    const bottom = mk("div", "tr-bottom");
-    const held = mk("div", "tr-held");
-    const hotbar = mk("div", "tr-hotbar");
+    const bottom = mk2("div", "tr-bottom");
+    const held = mk2("div", "tr-held");
+    const hotbar = mk2("div", "tr-hotbar");
     bottom.append(held, hotbar);
-    const help = mk("div", "tr-help");
+    const help = mk2("div", "tr-help");
     help.textContent = t("ui.help");
-    const left = mk("div", "tr-left");
-    const insp = mk("div", "tr-panel tr-insp");
-    const logPanel = mk("div", "tr-panel tr-log");
+    const left = mk2("div", "tr-left");
+    const insp = mk2("div", "tr-panel tr-insp");
+    const logPanel = mk2("div", "tr-panel tr-log");
     left.append(insp, logPanel);
-    const logTitle = mk("h3", void 0, t("ui.log"));
-    const logBar = mk("div", "tr-logbar");
-    const logBody = mk("div", "tr-logbody");
+    const logTitle = mk2("h3", void 0, t("ui.log"));
+    const logBar = mk2("div", "tr-logbar");
+    const logBody = mk2("div", "tr-logbody");
     const filters = { action: true, event: true, check: true };
     const filterBtns = [];
     for (const ch of ["action", "event", "check"]) {
-      const b = mk("button", "tr-btn on", t(`ui.filter.${ch}`));
+      const b = mk2("button", "tr-btn on", t(`ui.filter.${ch}`));
       b.type = "button";
       b.onclick = () => {
         filters[ch] = !filters[ch];
@@ -13384,8 +13870,8 @@ void main() {
       logBar.appendChild(b);
     }
     let autoscroll = true;
-    const asLabel = mk("label");
-    const asBox = mk("input");
+    const asLabel = mk2("label");
+    const asBox = mk2("input");
     asBox.type = "checkbox";
     asBox.checked = true;
     asBox.onchange = () => {
@@ -13394,7 +13880,7 @@ void main() {
     asLabel.append(asBox, document.createTextNode(" " + t("ui.autoscroll")));
     logBar.appendChild(asLabel);
     const logBtn = (label, fn) => {
-      const b = mk("button", "tr-btn", label);
+      const b = mk2("button", "tr-btn", label);
       b.type = "button";
       b.onclick = fn;
       logBar.appendChild(b);
@@ -13402,7 +13888,7 @@ void main() {
     logBtn(t("ui.copy_json"), () => {
       const text = o.log.toJSON();
       const select = () => {
-        const ta = mk("textarea");
+        const ta = mk2("textarea");
         ta.value = text;
         ta.setAttribute("readonly", "");
         ta.style.cssText = "position:fixed;left:8px;bottom:8px;width:min(480px,80vw);height:120px;z-index:99999";
@@ -13436,12 +13922,12 @@ void main() {
     const fill = (n, e) => {
       n.className = lineClass(e);
       n.textContent = "";
-      const tm = mk("time", void 0, fmtTime(e.t));
+      const tm = mk2("time", void 0, fmtTime(e.t));
       n.append(tm, document.createTextNode(e.text));
     };
     const addNode = (e) => {
       if (!filters[e.channel]) return;
-      const n = mk("div");
+      const n = mk2("div");
       fill(n, e);
       nodes.set(e.seq, n);
       logBody.appendChild(n);
@@ -13463,17 +13949,18 @@ void main() {
         if (n) fill(n, e);
       } else addNode(e);
     });
-    const right = mk("div", "tr-right");
-    const cat = mk("div", "tr-panel tr-cat");
-    const anim = mk("div", "tr-panel tr-anim");
-    const tests = mk("div", "tr-panel tr-tests");
-    right.append(cat, anim, tests);
-    cat.appendChild(mk("h3", void 0, t("ui.catalog")));
-    const itemSearch = mk("input", "tr-search");
+    const right = mk2("div", "tr-right");
+    const cat = mk2("div", "tr-panel tr-cat");
+    const anim = mk2("div", "tr-panel tr-anim");
+    const tests = mk2("div", "tr-panel tr-tests");
+    const benchPanel = createBenchPanel({ t, num: (n, d) => num(n, d), onControl: o.onControl, onLayer: o.onLayer, onAction: o.onAction });
+    right.append(cat, anim, benchPanel.element, tests);
+    cat.appendChild(mk2("h3", void 0, t("ui.catalog")));
+    const itemSearch = mk2("input", "tr-search");
     itemSearch.type = "search";
     itemSearch.placeholder = t("ui.search_items");
-    const tabs = mk("div", "tr-tabs");
-    const items = mk("div", "tr-items");
+    const tabs = mk2("div", "tr-tabs");
+    const items = mk2("div", "tr-items");
     cat.append(itemSearch, tabs, items);
     let activeGroup = "";
     const visibleItems = () => {
@@ -13485,17 +13972,17 @@ void main() {
       items.textContent = "";
       const searching = itemSearch.value.trim() !== "";
       const found = visibleItems();
-      if (!found.length) items.appendChild(mk("div", "tr-empty", t("ui.no_results")));
+      if (!found.length) items.appendChild(mk2("div", "tr-empty", t("ui.no_results")));
       for (const { item: it, group } of found) {
-        const wrap = mk("div", "tr-item");
-        const b = mk("button", "tr-btn", it.name);
-        if (searching) b.appendChild(mk("small", void 0, group));
+        const wrap = mk2("div", "tr-item");
+        const b = mk2("button", "tr-btn", it.name);
+        if (searching) b.appendChild(mk2("small", void 0, group));
         b.type = "button";
         b.title = it.note ?? it.name;
         b.onclick = () => o.onSpawn(it.id);
         wrap.appendChild(b);
         if (it.weapon) {
-          const w = mk("button", "tr-btn", "\u2694");
+          const w = mk2("button", "tr-btn", "\u2694");
           w.type = "button";
           w.title = t("ui.equip");
           w.onclick = () => o.onEquip(it.id);
@@ -13509,7 +13996,7 @@ void main() {
       const groupNames = [...o.groups().keys()];
       if (!groupNames.includes(activeGroup)) activeGroup = groupNames[0] ?? "";
       for (const g of groupNames) {
-        const b = mk("button", g === activeGroup ? "tr-btn on" : "tr-btn", g);
+        const b = mk2("button", g === activeGroup ? "tr-btn on" : "tr-btn", g);
         b.type = "button";
         b.onclick = () => {
           activeGroup = g;
@@ -13522,9 +14009,9 @@ void main() {
     renderTabs();
     itemSearch.oninput = renderItems;
     for (const box2 of [itemSearch]) box2.addEventListener("keydown", (e) => e.stopPropagation());
-    const controls = mk("div", "tr-row");
+    const controls = mk2("div", "tr-row");
     const ctl = (label, fn) => {
-      const b = mk("button", "tr-btn", label);
+      const b = mk2("button", "tr-btn", label);
       b.type = "button";
       b.onclick = () => fn(b);
       controls.appendChild(b);
@@ -13545,29 +14032,29 @@ void main() {
       o.onFast(fast);
     });
     const tapBtn = ctl(t("ui.tap"), () => o.onTap());
-    const qSel = mk("select");
+    const qSel = mk2("select");
     for (const q of ["low", "medium", "high"]) {
-      const op = mk("option", void 0, t(`ui.quality.${q}`));
+      const op = mk2("option", void 0, t(`ui.quality.${q}`));
       op.value = q;
       qSel.appendChild(op);
     }
     qSel.value = o.quality;
     qSel.onchange = () => o.onQuality(qSel.value);
-    const qLabel = mk("label", void 0, t("ui.quality") + " ");
+    const qLabel = mk2("label", void 0, t("ui.quality") + " ");
     qLabel.appendChild(qSel);
     controls.appendChild(qLabel);
-    const count = mk("span");
+    const count = mk2("span");
     controls.appendChild(count);
     cat.appendChild(controls);
-    tests.appendChild(mk("h3", void 0, t("ui.tests")));
-    const runAll = mk("button", "tr-btn", t("ui.run_all"));
+    tests.appendChild(mk2("h3", void 0, t("ui.tests")));
+    const runAll = mk2("button", "tr-btn", t("ui.run_all"));
     runAll.type = "button";
-    const summary = mk("div", "tr-summary");
-    const testSearch = mk("input", "tr-search");
+    const summary = mk2("div", "tr-summary");
+    const testSearch = mk2("input", "tr-search");
     testSearch.type = "search";
     testSearch.placeholder = t("ui.search_tests");
     testSearch.addEventListener("keydown", (e) => e.stopPropagation());
-    const list = mk("div", "list");
+    const list = mk2("div", "list");
     tests.append(runAll, summary, testSearch, list);
     testSearch.oninput = () => {
       const term = fold(testSearch.value.trim());
@@ -13590,7 +14077,7 @@ void main() {
       list.textContent = "";
       scBtns.clear();
       for (const s of o.scenarios()) {
-        const b = mk("button", "tr-btn", s.name);
+        const b = mk2("button", "tr-btn", s.name);
         b.type = "button";
         b.onclick = async () => {
           if (busy) return;
@@ -13616,7 +14103,7 @@ void main() {
         busy = false;
       }
     };
-    const toggle = mk("button", "tr-btn tr-toggle", t("ui.panel"));
+    const toggle = mk2("button", "tr-btn tr-toggle", t("ui.panel"));
     toggle.type = "button";
     const togglePanels = () => {
       root.classList.toggle("open");
@@ -13625,15 +14112,15 @@ void main() {
     toggle.onclick = togglePanels;
     root.append(cross4, top, bottom, help, left, right, toggle);
     const bar = (value, max, cls) => {
-      const b = mk("div", `tr-bar ${cls}`);
-      const i = mk("i");
+      const b = mk2("div", `tr-bar ${cls}`);
+      const i = mk2("i");
       i.style.width = `${Math.max(0, Math.min(100, value / Math.max(1e-9, max) * 100))}%`;
       b.appendChild(i);
       return b;
     };
     const row = (k, v) => {
-      const r = mk("div", "r");
-      r.append(mk("span", void 0, k), mk("span", void 0, v));
+      const r = mk2("div", "r");
+      r.append(mk2("span", void 0, k), mk2("span", void 0, v));
       return r;
     };
     const num = (n, d = 1) => {
@@ -13642,12 +14129,12 @@ void main() {
     };
     const renderInspector = (i) => {
       insp.textContent = "";
-      insp.appendChild(mk("h3", void 0, t("ui.inspector")));
+      insp.appendChild(mk2("h3", void 0, t("ui.inspector")));
       if (!i) {
-        insp.appendChild(mk("div", void 0, t("ui.aim_at_something")));
+        insp.appendChild(mk2("div", void 0, t("ui.aim_at_something")));
         return;
       }
-      insp.appendChild(mk("div", "t", `${i.object} \u203A ${i.part}`));
+      insp.appendChild(mk2("div", "t", `${i.object} \u203A ${i.part}`));
       insp.appendChild(row(t("ins.material"), i.material));
       insp.appendChild(row(t("ins.status"), i.status + (i.burning ? ` \xB7 ${t("ins.burning")}` : "")));
       insp.appendChild(row(t("ins.hp"), `${num(i.hp, 0)} / ${num(i.maxHp, 0)}`));
@@ -13666,30 +14153,30 @@ void main() {
         insp.appendChild(bar(Math.min(i.stress, 1.2), 1.2, i.stress > 1 ? "bad" : i.stress > 0.7 ? "warn" : "hp"));
       }
       if (i.joints.length) {
-        insp.appendChild(mk("div", void 0, t("ins.joints") + ":"));
+        insp.appendChild(mk2("div", void 0, t("ins.joints") + ":"));
         for (const j of i.joints) {
           const tools = j.tools.length ? j.tools.join(", ") : t("tool.none");
-          insp.appendChild(mk("div", void 0, `\u2022 ${j.kind} (${j.id})${j.open ? ` \xB7 ${t("ins.open")}` : ` \u2192 ${tools}`}`));
+          insp.appendChild(mk2("div", void 0, `\u2022 ${j.kind} (${j.id})${j.open ? ` \xB7 ${t("ins.open")}` : ` \u2192 ${tools}`}`));
         }
       }
-      if (i.note) insp.appendChild(mk("div", void 0, i.note));
+      if (i.note) insp.appendChild(mk2("div", void 0, i.note));
     };
     let lastAnim = "";
     const renderAnimations = (a) => {
       anim.textContent = "";
-      anim.appendChild(mk("h3", void 0, t("ui.animations")));
+      anim.appendChild(mk2("h3", void 0, t("ui.animations")));
       if (!a) {
-        anim.appendChild(mk("div", "sub", t("ui.animations_aim")));
+        anim.appendChild(mk2("div", "sub", t("ui.animations_aim")));
         return;
       }
-      anim.appendChild(mk("div", "sub", a.name));
+      anim.appendChild(mk2("div", "sub", a.name));
       if (a.clips.length === 0) {
-        anim.appendChild(mk("div", "sub", t("ui.animations_none")));
+        anim.appendChild(mk2("div", "sub", t("ui.animations_none")));
         return;
       }
-      const l = mk("div", "list");
+      const l = mk2("div", "list");
       for (const c of a.clips) {
-        const b = mk("button", a.playing === c.id ? "tr-btn on" : "tr-btn", `\u25B6 ${t(`anim.${c.id}`) === `anim.${c.id}` ? c.id : t(`anim.${c.id}`)} (${num(c.duration, 1)} s)`);
+        const b = mk2("button", a.playing === c.id ? "tr-btn on" : "tr-btn", `\u25B6 ${t(`anim.${c.id}`) === `anim.${c.id}` ? c.id : t(`anim.${c.id}`)} (${num(c.duration, 1)} s)`);
         b.type = "button";
         b.onclick = () => o.onPlay(a.objectId, c.id);
         l.appendChild(b);
@@ -13706,7 +14193,7 @@ void main() {
       hud(s) {
         toolBox.textContent = "";
         toolBox.append(document.createTextNode(s.toolName));
-        if (s.ammo) toolBox.append(mk("small", void 0, s.ammo));
+        if (s.ammo) toolBox.append(mk2("small", void 0, s.ammo));
         if (s.status) status.textContent = s.status;
         else if (!toastTimer) status.textContent = "";
         if (s.progress) {
@@ -13727,7 +14214,7 @@ void main() {
           ];
           if (s.held.weapon) keys.push(["H", t("hud.equip", { weapon: s.held.weapon })]);
           for (const [k, label] of keys) {
-            held.append(mk("kbd", void 0, k), document.createTextNode(` ${label}  `));
+            held.append(mk2("kbd", void 0, k), document.createTextNode(` ${label}  `));
           }
         } else held.style.display = "none";
         const key = s.slots.join("|") + s.page;
@@ -13737,9 +14224,9 @@ void main() {
           slotsEl.length = 0;
           hudPage = s.page - 1;
           s.slots.forEach((name, i) => {
-            const b = mk("button", "tr-slot");
+            const b = mk2("button", "tr-slot");
             b.type = "button";
-            b.append(mk("b", void 0, String((i + 1) % 10)), document.createTextNode(name));
+            b.append(mk2("b", void 0, String((i + 1) % 10)), document.createTextNode(name));
             b.title = name;
             b.onclick = () => o.onTool(hudPage * 10 + i);
             hotbar.appendChild(b);
@@ -13777,6 +14264,11 @@ void main() {
         renderTabs();
       },
       togglePanels,
+      bench: benchPanel.show,
+      metrics: benchPanel.metrics,
+      get benchVisible() {
+        return benchPanel.visible;
+      },
       dispose() {
         offLog();
         if (toastTimer) clearTimeout(toastTimer);
@@ -13789,6 +14281,7 @@ void main() {
 
   // src/room.ts
   var FIXED_DT = 1 / 60;
+  var METRICS_INTERVAL_S = 0.25;
   var v3 = (v) => [v.x, v.y, v.z];
   var dist3 = (a, b) => Math.hypot(a[0] - b[0], a[1] - b[1], a[2] - b[2]);
   function createTestRoom(options) {
@@ -14420,7 +14913,7 @@ void main() {
         }
       });
       player.kick(recoil[0], recoil[1]);
-      emitHost({ type: "shot", weapon: toolId, shots: shots.length, recoil });
+      emitHost({ type: "shot", weapon: toolId, shots: shots.length, recoil, rounds: shots.filter((s) => s.pellet === 0).length, mode: tool.mode });
       const f = first;
       const d = f ? num(f.distance, 1) : "";
       let text;
@@ -14602,6 +15095,7 @@ void main() {
     const detonate = (p, at, impact) => {
       const w = toolName(p.weapon);
       const results = world.explode(at, p.energy, p.radius, "player");
+      renderer.explode(at, p.energy, p.radius);
       action("explode", t("act.explode", { weapon: w, energy: num(p.energy, 0), radius: num(p.radius, 1), n: results.length }), { data: { weapon: p.weapon, energyJ: p.energy, radius: p.radius, point: at } });
       if (p.fire) {
         fluids.splash("fuel", [at[0], Math.max(at[1], groundAt(at[0], at[2])), at[2]], 0.5);
@@ -14945,9 +15439,12 @@ void main() {
             say(t("hud.reloading"));
           }
           break;
-        case "KeyQ":
-          tool.cycleMode();
+        case "KeyQ": {
+          const before = tool.mode;
+          const mode = tool.cycleMode();
+          if (mode !== before) emitHost({ type: "mode", weapon: toolId, mode });
           break;
+        }
         case "KeyZ":
           tiltKey = 1;
           break;
@@ -15035,6 +15532,10 @@ void main() {
     let timeScale = 1;
     let fastForward = false;
     let hudAcc = 1;
+    let metricsAcc = 0;
+    let ownsLoop = false;
+    const roomMetricIds = options.metrics === false ? [] : options.metrics ?? ROOM_METRICS;
+    const roomMetrics = createRoomMetrics({ gl, destruction: renderer, fluids: fluidView, ids: roomMetricIds });
     let qualityName = quality;
     const syncContainers = (sdt) => {
       for (const e of entries.values()) {
@@ -15098,6 +15599,7 @@ void main() {
       flush();
     };
     const update = (dt) => {
+      if (!ownsLoop) roomMetrics.frame(dt);
       player.update(dt);
       if (tiltKey || heldTilt > 0) {
         heldTilt = Math.max(0, Math.min(2.4, heldTilt + (tiltKey ? 2.2 : -3) * dt));
@@ -15116,6 +15618,11 @@ void main() {
         hudAcc = 0;
         ui.hud(hudState());
       }
+      metricsAcc += dt;
+      if (metricsAcc >= METRICS_INTERVAL_S && ui) {
+        metricsAcc = 0;
+        if (ui.benchVisible) ui.metrics(metricRows());
+      }
     };
     const hudState = () => {
       const page = Math.floor(toolIndex / 10);
@@ -15231,7 +15738,57 @@ void main() {
       log.add({ channel: "check", type: ok ? "pass" : "fail", text: `${ok ? "\u2713" : "\u2717"} ${text}`, itemId, data: { ok, ...data } });
     };
     const modules = /* @__PURE__ */ new Map();
-    const detachers = [];
+    const detachers = /* @__PURE__ */ new Map();
+    const benches = /* @__PURE__ */ new Map();
+    let activeBench = null;
+    const lastBench = () => [...benches.keys()].pop() ?? null;
+    const benchView = () => {
+      const store = activeBench ? benches.get(activeBench) : void 0;
+      if (!store) return null;
+      return { title: modules.get(store.moduleId)?.name ?? store.moduleId, controls: store.controls(), layers: store.layers() };
+    };
+    const METRIC_UNAVAILABLE = "n/a";
+    const metricText = (value, digits, unit) => typeof value === "number" ? `${num(value, digits)}${unit ? ` ${unit}` : ""}` : value ?? METRIC_UNAVAILABLE;
+    const reportedFailures = /* @__PURE__ */ new Set();
+    const reportOnce = (key, text) => {
+      if (reportedFailures.has(key)) return;
+      reportedFailures.add(key);
+      host.log(text);
+    };
+    const failureText = (error) => error instanceof Error ? error.message : String(error);
+    const moduleMetrics = () => {
+      const store = activeBench ? benches.get(activeBench) : void 0;
+      const out = {};
+      for (const metric of store?.metrics ?? []) {
+        try {
+          out[metric.id] = metric.read();
+        } catch (error) {
+          out[metric.id] = METRIC_UNAVAILABLE;
+          reportOnce(`${store?.moduleId}:metric:${metric.id}`, t("mod.metric_failed", { name: modules.get(store?.moduleId ?? "")?.name ?? "", metric: metric.id, error: failureText(error) }));
+        }
+      }
+      return out;
+    };
+    const metricRows = () => {
+      const sampled = roomMetrics.sample();
+      const room2 = roomMetricIds.flatMap((id) => {
+        const value = sampled[id];
+        return value === void 0 ? [] : [{ id, name: t(`metric.${id}`), text: num(value, id === "frame_ms" ? 1 : 0) }];
+      });
+      const values = moduleMetrics();
+      const declared = (activeBench ? benches.get(activeBench)?.metrics : void 0) ?? [];
+      const module = declared.map((metric) => {
+        const value = values[metric.id];
+        const ratio = metric.max && typeof value === "number" ? value / metric.max : void 0;
+        return { id: metric.id, name: metric.name, text: metricText(value, metric.digits ?? 0, metric.unit), ...ratio === void 0 ? {} : { ratio } };
+      });
+      return { room: room2, module };
+    };
+    const showBench = () => {
+      if (!ui) return;
+      ui.bench(benchView());
+      ui.metrics(metricRows());
+    };
     const hostListeners = /* @__PURE__ */ new Set();
     const frameListeners = /* @__PURE__ */ new Set();
     let reloadingSeen = false;
@@ -15247,7 +15804,7 @@ void main() {
       camera,
       locale,
       groundAt,
-      tool: () => ({ weapon: toolId, category: tool.def.category, ammo: tool.ammo, capacity: tool.capacity, reserve: tool.reserve, reloading: tool.reloading }),
+      tool: () => ({ weapon: toolId, category: tool.def.category, ammo: tool.ammo, capacity: tool.capacity, reserve: tool.reserve, reloading: tool.reloading, mode: tool.mode }),
       on(listener) {
         hostListeners.add(listener);
         return () => hostListeners.delete(listener);
@@ -15260,6 +15817,23 @@ void main() {
         action("module_note", text, { data });
       }
     };
+    const lendBench = (store) => ({
+      value: store.value,
+      layer: store.layer,
+      onChange: store.onChange,
+      patch: store.patch,
+      look: (eye, target) => room.look(eye, target)
+    });
+    const checkModuleBench = (mod, fail) => {
+      const store = createBenchStore(mod, locale, (error) => reportOnce(`${mod.id}:listener`, t("mod.listener_failed", { name: mod.name, error: failureText(error) })));
+      const { controls, layers, metrics } = store.declared;
+      if (controls.length + layers.length + metrics.length === 0) return null;
+      const r = checkBench(store.declared);
+      const text = r.ok ? t("mod.bench_ok", { name: mod.name, controls: controls.length, layers: layers.length, metrics: metrics.length }) : t("mod.bench_fail", { name: mod.name, problems: r.problems.join("; ") });
+      moduleCheck(r.ok, text, { module: mod.id, check: "bench", problems: r.problems });
+      for (const p of r.problems) fail(`bench: ${p}`);
+      return r.ok ? store : null;
+    };
     const loadModule = (mod) => {
       const report = { module: mod.id, items: [], scenarios: [], ok: true, problems: [] };
       const fail = (problem) => {
@@ -15324,8 +15898,29 @@ void main() {
         report.scenarios.push(sc.id);
       }
       action("module", t("act.module_loaded", { name: mod.name, items: report.items.length, scenarios: report.scenarios.length, result: t(report.ok ? "mod.all_ok" : "mod.some_failed") }), { data: { module: mod.id, items: report.items, scenarios: report.scenarios, ok: report.ok } });
+      const bench = checkModuleBench(mod, fail);
+      detachers.get(mod.id)?.();
+      detachers.delete(mod.id);
+      const previous = benches.get(mod.id);
+      const kept = previous?.encode();
+      previous?.dispose();
+      benches.delete(mod.id);
+      for (const key of [...reportedFailures]) if (key.startsWith(`${mod.id}:`)) reportedFailures.delete(key);
       modules.set(mod.id, mod);
-      if (mod.attach) detachers.push(mod.attach(host));
+      if (bench) {
+        const seed = options.bench?.state?.[mod.id];
+        const restored = kept ?? (typeof seed === "string" ? seed : void 0);
+        if (restored !== void 0) bench.restore(restored);
+        benches.set(mod.id, bench);
+        bench.watch(() => {
+          options.bench?.onChange?.(mod.id, bench.encode());
+          if (activeBench === mod.id) ui?.bench(benchView());
+        });
+        if (!activeBench || !benches.has(activeBench)) activeBench = mod.id;
+      } else if (activeBench === mod.id) activeBench = lastBench();
+      if (mod.attach) detachers.set(mod.id, mod.attach(bench ? { ...host, bench: lendBench(bench) } : host));
+      bench?.sendInitial();
+      showBench();
       ui?.refresh();
       return report;
     };
@@ -15404,6 +15999,8 @@ void main() {
       const mod = [...modules.values()].find((m) => m.id === area || m.group === area);
       const label = mod?.group ?? S.groups[area] ?? area;
       ui?.showGroup(label);
+      activeBench = mod && benches.has(mod.id) ? mod.id : lastBench();
+      showBench();
       const layout = mod?.area?.(locale);
       if (layout) return layArea(layout);
       const items = catalog.filter((item) => item.group === label);
@@ -15495,8 +16092,18 @@ void main() {
       loadModule,
       animations: animationsOf,
       playAnimation,
+      bench(moduleId) {
+        const id = moduleId ?? activeBench;
+        return (id ? benches.get(id) : void 0) ?? null;
+      },
+      metrics() {
+        return { room: roomMetrics.sample(), module: moduleMetrics() };
+      },
       dispose() {
-        for (const detach of detachers.splice(0)) detach();
+        for (const detach of detachers.values()) detach();
+        detachers.clear();
+        for (const store of benches.values()) store.dispose();
+        benches.clear();
         cancelAnimationFrame?.(raf);
         window.removeEventListener("resize", onResize);
         player.dispose();
@@ -15567,19 +16174,33 @@ void main() {
         onPlay: (objectId, clipId) => {
           playAnimation(clipId, objectId);
         },
-        onResize: resize
+        onResize: resize,
+        onControl: (id, value) => {
+          if (activeBench) benches.get(activeBench)?.set(id, value);
+        },
+        onLayer: (id, on) => {
+          if (activeBench) benches.get(activeBench)?.setLayer(id, on);
+        },
+        onAction: (id) => {
+          if (activeBench) benches.get(activeBench)?.act(id);
+        }
       });
       ui.hud(hudState());
+      showBench();
     }
     let raf = 0;
     if (ownRenderer && typeof requestAnimationFrame === "function") {
       let last = performance.now();
+      ownsLoop = true;
       const loop = (now) => {
         raf = requestAnimationFrame(loop);
-        const dt = Math.min(0.05, (now - last) / 1e3);
+        const realDelta = (now - last) / 1e3;
+        roomMetrics.frame(realDelta);
+        const dt = Math.min(0.05, realDelta);
         last = now;
         if (!scenarioRunning) update(dt);
         gl.render(scene, camera);
+        roomMetrics.rendered();
       };
       raf = requestAnimationFrame(loop);
     }