@adatechnology/game-test-room 0.1.0 → 0.1.2

package/dist/index.global.js

@@ -126,6 +126,82 @@ var GameTestRoom = (() => {
     }
     return { ok: problems.length === 0, problems };
   };
+  var STRUCTURE_ROLES = ["foundation", "column", "beam", "slab", "wall", "partition", "roof", "stair", "none"];
+  var BEARS = [true, false, "a_on_b", "b_on_a"];
+  var finite = (n) => typeof n === "number" && Number.isFinite(n);
+  var positive = (n) => finite(n) && n > 0;
+  var vec3 = (v) => Array.isArray(v) && v.length === 3 && v.every(finite);
+  var nonNegative = (n) => n === void 0 || finite(n) && n >= 0;
+  var checkSpec = (spec, options = {}) => {
+    const problems = [];
+    const warnings = [];
+    const materials = options.materials ? new Set(options.materials) : null;
+    const parts = Array.isArray(spec?.parts) ? spec.parts : [];
+    if (!Array.isArray(spec?.parts) || parts.length === 0) problems.push("the spec needs at least one part");
+    const ids = /* @__PURE__ */ new Set();
+    for (const p of parts) {
+      const id = String(p?.id ?? "");
+      const label = `part "${id}"`;
+      if (id === "") problems.push("a part has no id");
+      else if (ids.has(id)) problems.push(`duplicate part id "${id}"`);
+      ids.add(id);
+      if (materials && !materials.has(p?.material)) problems.push(`${label} has unknown material "${String(p?.material)}"`);
+      else if (typeof p?.material !== "string" || p.material === "") problems.push(`${label} needs a material`);
+      const s = p?.shape;
+      if (s?.kind === "box") {
+        if (!Array.isArray(s.size) || s.size.length !== 3 || !s.size.every(positive)) problems.push(`${label} box size must be three finite positive numbers`);
+      } else if (s?.kind === "cylinder") {
+        if (!positive(s.radius) || !positive(s.height)) problems.push(`${label} cylinder radius and height must be finite and positive`);
+      } else if (s?.kind === "sphere") {
+        if (!positive(s.radius)) problems.push(`${label} sphere radius must be finite and positive`);
+      } else problems.push(`${label} has an unknown shape`);
+      if (!vec3(p?.position)) problems.push(`${label} needs a finite position [x, y, z]`);
+      if (p?.rotation !== void 0 && !vec3(p.rotation)) problems.push(`${label} has an invalid rotation`);
+      for (const f of ["mass", "hp", "thickness"]) if (!nonNegative(p?.[f])) problems.push(`${label} ${f} must be a finite number >= 0`);
+      if (p?.fill !== void 0 && !(finite(p.fill) && p.fill >= 0 && p.fill <= 1)) problems.push(`${label} fill must be between 0 and 1`);
+      if (p?.structure) {
+        if (!STRUCTURE_ROLES.includes(p.structure.role)) problems.push(`${label} has an invalid structure role "${String(p.structure.role)}"`);
+        if (!nonNegative(p.structure.capacity)) problems.push(`${label} structure capacity must be a finite number >= 0`);
+      }
+      if (p?.contains && !nonNegative(p.contains.liters)) problems.push(`${label} contains.liters must be a finite number >= 0`);
+    }
+    const jointIds = /* @__PURE__ */ new Set();
+    const edges = [];
+    for (const j of spec?.joints ?? []) {
+      const id = j.id ?? `${j.a}~${j.b}`;
+      const label = `joint "${id}"`;
+      if (jointIds.has(id)) problems.push(`duplicate joint id "${id}"`);
+      jointIds.add(id);
+      if (!ids.has(j.a)) problems.push(`${label} references unknown part "${String(j.a)}"`);
+      if (!ids.has(j.b)) problems.push(`${label} references unknown part "${String(j.b)}"`);
+      if (j.a === j.b) problems.push(`${label} joins part "${String(j.a)}" to itself`);
+      if (j.bears !== void 0 && !BEARS.includes(j.bears)) problems.push(`${label} has an invalid bears "${String(j.bears)}"`);
+      if (!nonNegative(j.strength)) problems.push(`${label} strength must be a finite number >= 0`);
+      if (!nonNegative(j.seconds)) problems.push(`${label} seconds must be a finite number >= 0`);
+      if (j.bears !== false && ids.has(j.a) && ids.has(j.b) && j.a !== j.b) edges.push([j.a, j.b]);
+    }
+    const structural = parts.filter((p) => p?.structure && p.structure.role !== "none");
+    if (structural.length && spec.joints) {
+      const anchored = parts.filter((p) => p.anchored || p.structure?.role === "foundation").map((p) => p.id);
+      const adj = /* @__PURE__ */ new Map();
+      for (const [a, b] of edges) {
+        adj.set(a, [...adj.get(a) ?? [], b]);
+        adj.set(b, [...adj.get(b) ?? [], a]);
+      }
+      const seen = new Set(anchored);
+      const queue = [...anchored];
+      while (queue.length) {
+        for (const n of adj.get(queue.pop()) ?? []) {
+          if (seen.has(n)) continue;
+          seen.add(n);
+          queue.push(n);
+        }
+      }
+      const lost = structural.filter((p) => !seen.has(p.id)).map((p) => p.id);
+      if (lost.length) warnings.push(`structural part(s) ${lost.map((i) => `"${i}"`).join(", ")} cannot reach an anchored part, so they will fall`);
+    }
+    return { ok: problems.length === 0, problems, warnings };
+  };
   var finite3 = (v) => Array.isArray(v) && v.length === 3 && v.every((n) => typeof n === "number" && Number.isFinite(n));
   var checkAnimation = (clip, partIds) => {
     const problems = [];
@@ -1251,7 +1327,7 @@ var GameTestRoom = (() => {
     {
       id: "green_wood",
       density: 650,
-      hpPerKg: 120,
+      hpPerKg: 5,
       penetration: 10,
       ductility: 0.5,
       fracture: "splinter",
@@ -1260,7 +1336,8 @@ var GameTestRoom = (() => {
         0.2
       ],
       damageScale: {
-        slash: 1.3
+        slash: 1.3,
+        ballistic: 0.1
       },
       hitDebris: "splinters",
       breakDebris: "leaves",
@@ -1564,9 +1641,20 @@ var GameTestRoom = (() => {
   var DMG_PER_J = 0.02;
   var BLAST_COUPLING = 0.1;
   var FLAMMABLE_FLUIDS = ["gas", "fuel"];
+  var CUT_SLICE = 1;
+  var cutFactorOf = (shape) => clamp2(Math.max(...shapeDims(shape)) / CUT_SLICE, 1, 50);
   var clamp2 = (v, a, b) => Math.max(a, Math.min(b, v));
   var isLost = (p) => p.st.status === "broken" || p.st.status === "melted" || p.st.status === "ashes";
   var clone = (v) => structuredClone(v);
+  var updateBound = (o) => {
+    if (!o.parts.length) return;
+    const c = [0, 0, 0];
+    for (const p of o.parts) for (let k = 0; k < 3; k++) c[k] += p.pos[k] / o.parts.length;
+    let r = 0;
+    for (const p of o.parts) r = Math.max(r, vec.distance(c, p.pos) + p.bound);
+    o.bc = c;
+    o.br = r;
+  };
   var AXIS = { x: 0, y: 1, z: 2 };
   var createDestruction = (options = {}) => {
     const materials = /* @__PURE__ */ new Map();
@@ -1702,10 +1790,12 @@ var GameTestRoom = (() => {
           mat,
           st: pst,
           q: quatFromEuler(...ps.rotation ?? [0, 0, 0]),
+          pos: [ps.position[0], ps.position[1], ps.position[2]],
           mass0,
           fuel0,
           area: shapeArea(ps.shape),
           thickness: partThickness(ps),
+          cutFactor: cutFactorOf(ps.shape),
           dims: shapeDims(ps.shape),
           bound: shapeBound(ps.shape),
           rt: c?.rt ?? { ...freshRuntime(), prevTemp: pst.temperature },
@@ -1740,14 +1830,8 @@ var GameTestRoom = (() => {
         o.byPart.get(r.b).push(j);
         o.st.joints.push(jst);
       }
-      if (o.parts.length) {
-        const c = [0, 0, 0];
-        for (const p of o.parts) for (let k = 0; k < 3; k++) c[k] += p.spec.position[k] / o.parts.length;
-        let r = 0;
-        for (const p of o.parts) r = Math.max(r, vec.distance(c, p.spec.position) + p.bound);
-        o.bc = c;
-        o.br = r;
-      }
+      for (const [jid, c] of carry?.joints ?? []) if (c.st.open && !o.jointMap.has(jid)) o.st.joints.push(c.st);
+      updateBound(o);
       o.anyAnchor = o.parts.some((p) => p.anchored);
       o.unsup = o.parts.map(() => false);
       solveStructure(o);
@@ -1887,7 +1971,7 @@ var GameTestRoom = (() => {
       if (!p) throw new Error(`unknown part "${id}" in object "${o.id}"`);
       return p;
     };
-    const partXf = (o, p) => ({ c: toWorld(o.st.position, o.st.rotation, p.spec.position), q: quat.mul(o.st.rotation, p.q) });
+    const partXf = (o, p) => ({ c: toWorld(o.st.position, o.st.rotation, p.pos), q: quat.mul(o.st.rotation, p.q) });
     const objLocal = (o, w) => toLocal(o.st.position, o.st.rotation, w);
     const objLocalDir = (o, w) => rotateVec(quat.conjugate(o.st.rotation), w);
     const jointWorld = (o, j) => toWorld(o.st.position, o.st.rotation, j.pos);
@@ -1899,14 +1983,14 @@ var GameTestRoom = (() => {
       const { c, q } = partXf(o, p);
       return aabbOf(p.spec.shape, c, q);
     };
-    const rayPartRaw = (pos, rot, spec, pq, origin, d) => {
-      const c = toWorld(pos, rot, spec.position);
+    const rayPartRaw = (pos, rot, spec, pq, origin, d, lp = spec.position) => {
+      const c = toWorld(pos, rot, lp);
       const q = quat.mul(rot, pq);
       const qi = quat.conjugate(q);
       const r = rayShape(spec.shape, rotateVec(qi, vec.sub(origin, c)), rotateVec(qi, d));
       return r ? { t0: r.t0, t1: r.t1, n: rotateVec(q, r.n0) } : null;
     };
-    const rayPart = (o, p, origin, d) => rayPartRaw(o.st.position, o.st.rotation, p.spec, p.q, origin, d);
+    const rayPart = (o, p, origin, d) => rayPartRaw(o.st.position, o.st.rotation, p.spec, p.q, origin, d, p.pos);
     const raySphereMiss = (origin, d, c, r, maxDist) => {
       const oc = vec.sub(origin, c);
       const b = vec.dot(oc, d);
@@ -1931,7 +2015,8 @@ var GameTestRoom = (() => {
       for (const im of impls.values()) {
         for (const ps of im.impl.describe().parts) {
           if (ignore?.has(`${im.impl.id}\0${ps.id}`)) continue;
-          const r = rayPartRaw(im.position, im.rotation, ps, quatFromEuler(...ps.rotation ?? [0, 0, 0]), origin, d);
+          const ov = im.poses.get(ps.id);
+          const r = rayPartRaw(im.position, im.rotation, ps, ov?.q ?? quatFromEuler(...ps.rotation ?? [0, 0, 0]), origin, d, ov?.pos);
           if (!r || r.t0 < 0 || r.t0 > maxDist) continue;
           if (!best || r.t0 < best.distance) best = { object: im.impl.id, part: ps.id, point: vec.madd(origin, d, r.t0), normal: r.n, distance: r.t0, pathLen: r.t1 - r.t0 };
         }
@@ -2066,11 +2151,29 @@ var GameTestRoom = (() => {
       collapseCheck(o, src);
       checkDestroyed(o, src);
     };
-    const wearJoints = (o, p, amount, near, radius = 0.06, src) => {
+    const jointReach = (o, j, point) => {
+      const A = partWorldAabb(o, o.parts[j.ia]), B = partWorldAabb(o, o.parts[j.ib]);
+      let d2 = 0;
+      for (let k = 0; k < 3; k++) {
+        const lo = Math.min(Math.max(A.min[k], B.min[k]), Math.min(A.max[k], B.max[k]));
+        const hi = Math.max(Math.max(A.min[k], B.min[k]), Math.min(A.max[k], B.max[k]));
+        const d = point[k] < lo ? lo - point[k] : point[k] > hi ? point[k] - hi : 0;
+        d2 += d * d;
+      }
+      return Math.sqrt(d2);
+    };
+    const jointReachLimit = (o, j) => {
+      const pa = o.parts[j.ia], pb = o.parts[j.ib];
+      const small = pa.dims[0] * pa.dims[1] * pa.dims[2] <= pb.dims[0] * pb.dims[1] * pb.dims[2] ? pa : pb;
+      return Math.max(0.06, 0.5 * Math.min(small.dims[0], small.dims[1], small.dims[2]));
+    };
+    const wearJoints = (o, p, amount, near, radius = 0.06, src, split = false) => {
       if (amount <= 0) return;
-      for (const j of o.byPart.get(p.spec.id) ?? []) {
+      const mine = (o.byPart.get(p.spec.id) ?? []).filter((j) => !j.st.open);
+      if (split && mine.length) amount /= mine.length;
+      for (const j of mine) {
         if (j.st.open) continue;
-        if (near && vec.distance(jointWorld(o, j), near) > radius) continue;
+        if (near && jointReach(o, j, near) > Math.max(radius, jointReachLimit(o, j))) continue;
         j.st.hp -= amount;
         if (j.st.hp <= 0) {
           j.st.hp = 0;
@@ -2189,7 +2292,7 @@ var GameTestRoom = (() => {
         if (mat.fracture !== "shatter") addHole(o, p, entry, n, caliber / 1e3, false, void 0, src);
       } else addHole(o, p, entry, n, caliber / 1e3, false, void 0, src);
       debris(o, p, mat.hitDebris, entry, n, clamp2(Math.round(E / 60) + 2, 2, 14), clamp2(Math.sqrt(E) / 6, 1, 8), src);
-      wearJoints(o, p, E * 0.2, entry, 0.06, src);
+      wearJoints(o, p, (penetrated ? thr : E) * 0.02, void 0, 0, src, true);
       const dmg = applyDamage(o, p, E * DMG_PER_J * scale2, "ballistic", entry, d, E * 0.1, 12, src);
       return { penetrated, exitEnergy: penetrated ? E - thr : 0, exitPoint, damage: dmg };
     };
@@ -2214,7 +2317,7 @@ var GameTestRoom = (() => {
       if (kind === "blunt") wearJoints(o, p, E * 0.3, void 0, 0, src);
       else wearJoints(o, p, E * 0.3, point, 0.06, src);
       const scale2 = mat.damageScale?.[kind] ?? 1;
-      return applyDamage(o, p, Ec * DMG_PER_J * scale2, kind, point, d, E * 0.1, 12, src);
+      return applyDamage(o, p, Ec * DMG_PER_J * scale2 * (kind === "slash" ? p.cutFactor : 1), kind, point, d, E * 0.1, 12, src);
     };
     const blastObject = (o, point, energy, radius, src) => {
       const start = cur.length;
@@ -2264,8 +2367,9 @@ var GameTestRoom = (() => {
       }
       for (const im of [...impls.values()]) {
         const inRange = im.impl.describe().parts.some((ps) => {
-          const c = toWorld(im.position, im.rotation, ps.position);
-          const q = quat.mul(im.rotation, quatFromEuler(...ps.rotation ?? [0, 0, 0]));
+          const ov = im.poses.get(ps.id);
+          const c = toWorld(im.position, im.rotation, ov?.pos ?? ps.position);
+          const q = quat.mul(im.rotation, ov?.q ?? quatFromEuler(...ps.rotation ?? [0, 0, 0]));
           return distanceToShape(ps.shape, toLocal(c, q, point)) < radius;
         });
         if (inRange) out.push(implHit(im, { type: "explosive", point, energy, radius, ...src !== void 0 ? { source: src } : {} }));
@@ -2517,7 +2621,7 @@ var GameTestRoom = (() => {
     const spread = (sources, dt) => {
       for (const src of sources) {
         if (!src.p.st.burning && !src.p.rt.jet) continue;
-        const sc = toWorld(src.o.st.position, src.o.st.rotation, src.p.spec.position);
+        const sc = toWorld(src.o.st.position, src.o.st.rotation, src.p.pos);
         const A = partWorldAabb(src.o, src.p);
         for (const o of objects.values()) {
           if (o === src.o) continue;
@@ -2563,9 +2667,23 @@ var GameTestRoom = (() => {
       register(impl, opts = {}) {
         const id = opts.id ?? impl.id;
         if (taken(id)) throw new Error(`object "${id}" already exists`);
-        impls.set(id, { impl, position: opts.position ?? [0, 0, 0], rotation: opts.rotation ?? [0, 0, 0, 1] });
+        impls.set(id, { impl, position: opts.position ?? [0, 0, 0], rotation: opts.rotation ?? [0, 0, 0, 1], poses: /* @__PURE__ */ new Map() });
         return id;
       },
+      setPartPose(objectId, partId, position, rotation) {
+        const q = quatFromEuler(...rotation ?? [0, 0, 0]);
+        const im = impls.get(objectId);
+        if (im) {
+          im.impl.setPartPose?.(partId, position, rotation);
+          im.poses.set(partId, { pos: [position[0], position[1], position[2]], q });
+          return;
+        }
+        const o = getObj(objectId);
+        const p = getPart(o, partId);
+        p.pos = [position[0], position[1], position[2]];
+        p.q = q;
+        updateBound(o);
+      },
       remove(id) {
         objects.delete(id);
         impls.delete(id);
@@ -2592,9 +2710,12 @@ var GameTestRoom = (() => {
         const moved = new Set(names);
         const nid = newId ?? nextId();
         if (objects.has(nid)) throw new Error(`object "${nid}" already exists`);
-        const carryFor = (keep) => ({
+        const carryFor = (keep, keepOpen = () => false) => ({
           parts: new Map(o.parts.filter((p) => keep(p.spec.id)).map((p) => [p.spec.id, { st: p.st, rt: p.rt }])),
-          joints: new Map(o.joints.filter((j) => keep(j.spec.a) && keep(j.spec.b)).map((j) => [j.spec.id, { st: j.st, step: j.step }])),
+          joints: new Map([
+            ...o.joints.filter((j) => keep(j.spec.a) && keep(j.spec.b) || j.st.open && keepOpen(j.spec.a, j.spec.b)).map((j) => [j.spec.id, { st: j.st, step: j.step }]),
+            ...o.st.joints.filter((st) => st.open && !o.jointMap.has(st.id) && keepOpen(st.a, st.b)).map((st) => [st.id, { st, step: 0 }])
+          ]),
           collapsed: [...o.collapsed].filter(keep)
         });
         const sub3 = (keep) => {
@@ -2606,8 +2727,8 @@ var GameTestRoom = (() => {
         const inNew = (pid) => moved.has(pid);
         const inOld = (pid) => !moved.has(pid);
         const pos = o.st.position, rot = o.st.rotation;
-        const fresh = build(sub3(inNew), nid, pos, rot, carryFor(inNew));
-        const rest = build(sub3(inOld), id, pos, rot, carryFor(inOld));
+        const fresh = build(sub3(inNew), nid, pos, rot, carryFor(inNew, (a, b) => inNew(a) && inNew(b)));
+        const rest = build(sub3(inOld), id, pos, rot, carryFor(inOld, (a, b) => !(inNew(a) && inNew(b))));
         objects.set(id, rest);
         objects.set(nid, fresh);
         return nid;
@@ -2705,34 +2826,37 @@ var GameTestRoom = (() => {
         }
         return getObj(objectId).joints.filter((j) => !j.st.open && j.spec.tools.includes(tool)).map((j) => j.st);
       },
-      nearestJoint(objectId, point, maxDistance = 0.3) {
+      nearestJoint(objectId, point, maxDistance = 0.3, tool) {
         const im = impls.get(objectId);
+        const cands = [];
         if (im) {
-          let best2 = null;
-          let bd2 = maxDistance;
+          const spec = im.impl.describe();
           for (const js of im.impl.state().joints) {
             if (js.open) continue;
             const pos = implJointPos(im, js.a, js.b);
-            const d = pos ? vec.distance(pos, point) : Infinity;
-            if (d <= bd2) {
-              bd2 = d;
-              best2 = js;
-            }
+            const j = (spec.joints ?? []).find((x) => (x.id ?? `${x.a}~${x.b}`) === js.id);
+            cands.push({ st: js, d: pos ? vec.distance(pos, point) : Infinity, ok: !!j && (j.tools ?? JOINT_DEFAULTS[j.kind].tools).includes(tool) });
           }
-          return best2;
-        }
-        const o = getObj(objectId);
-        let best = null;
-        let bd = maxDistance;
-        for (const j of o.joints) {
-          if (j.st.open) continue;
-          const d = vec.distance(jointWorld(o, j), point);
-          if (d <= bd) {
-            bd = d;
-            best = j.st;
+        } else {
+          const o = getObj(objectId);
+          for (const j of o.joints) {
+            if (j.st.open) continue;
+            cands.push({ st: j.st, d: vec.distance(jointWorld(o, j), point), ok: tool ? j.spec.tools.includes(tool) : true });
           }
         }
-        return best;
+        const pick = (only) => {
+          let best = null;
+          let bd = maxDistance;
+          for (const c of cands) {
+            if (only && !c.ok) continue;
+            if (c.d <= bd) {
+              bd = c.d;
+              best = c.st;
+            }
+          }
+          return best;
+        };
+        return (tool ? pick(true) : null) ?? pick(false);
       },
       extinguish(objectId, partId, coolC = 200) {
         const im = impls.get(objectId);
@@ -2775,6 +2899,10 @@ var GameTestRoom = (() => {
         }).events;
       },
       state: (id) => objects.get(id)?.st ?? impls.get(id)?.impl.state() ?? null,
+      snapshot: (id) => {
+        const st = objects.get(id)?.st ?? impls.get(id)?.impl.state();
+        return st ? clone(st) : null;
+      },
       part: (id, partId) => objects.get(id)?.byId.get(partId)?.st ?? impls.get(id)?.impl.state().parts.find((p) => p.id === partId) ?? null,
       reset(id) {
         const im = impls.get(id);
@@ -3786,6 +3914,8 @@ void main() {
   var SLEEP_AFTER = 0.5;
   var HARD_LANDING = 3;
   var SLOP = 2e-3;
+  var NARROW = 0.3;
+  var TOPPLE = 3;
   var PieceSystem = class {
     constructor(THREE, o) {
       __publicField(this, "THREE", THREE);
@@ -3917,6 +4047,7 @@ void main() {
       let landPoint = [pos[0], pos[1], pos[2]];
       let contactedLast = false;
       let touched = false;
+      let unstable = false;
       for (let s = 0; s < steps; s++) {
         v[1] -= this.o.gravity * h;
         pos[0] += v[0] * h;
@@ -4005,6 +4136,25 @@ void main() {
             }
           }
         }
+        let x0 = Infinity, x1 = -Infinity, z0 = Infinity, z1 = -Infinity, low = 0;
+        for (const r of rs) {
+          x0 = Math.min(x0, r[0]);
+          x1 = Math.max(x1, r[0]);
+          z0 = Math.min(z0, r[2]);
+          z1 = Math.max(z1, r[2]);
+          low = Math.min(low, r[1]);
+        }
+        const height = -low;
+        const wx = x1 - x0;
+        const wz = z1 - z0;
+        unstable = Math.min(wx, wz) < NARROW * height || x0 > 0 || x1 < 0 || z0 > 0 || z1 < 0;
+        if (unstable) {
+          const dirX = x0 + x1 > 0 ? -1 : 1;
+          const dirZ = z0 + z1 > 0 ? -1 : 1;
+          const k = TOPPLE * Math.min(height, 1) * h;
+          if (wx <= wz) w[2] -= dirX * k;
+          else w[0] += dirZ * k;
+        }
         const rd = Math.exp((rs.length >= 3 ? -3 : -1.5) * h);
         w[0] *= rd;
         w[1] *= rd;
@@ -4022,7 +4172,7 @@ void main() {
         b.lastHit = this.time;
         this.o.onHardLanding(b, landPoint, landing);
       }
-      const still = touched && Math.hypot(v[0], v[1], v[2]) < 0.12 && Math.hypot(w[0], w[1], w[2]) < 0.45;
+      const still = touched && !unstable && Math.hypot(v[0], v[1], v[2]) < 0.12 && Math.hypot(w[0], w[1], w[2]) < 0.45;
       if (still) {
         b.still += dt;
         if (b.still >= SLEEP_AFTER) {
@@ -4081,6 +4231,163 @@ void main() {
       }
     }
   };
+  function partHintOf(value) {
+    if (typeof value === "string") return value ? { id: value } : null;
+    if (!value || typeof value !== "object") return null;
+    const v = value;
+    if (typeof v.id !== "string" || !v.id) return null;
+    const str = (x) => typeof x === "string" && x ? x : void 0;
+    return { id: v.id, material: str(v.material), parent: str(v.parent), kind: str(v.kind) };
+  }
+  var METAL = /steel|iron|metal|alumin|copper|brass|bronze|tin|titan|chrome|zinc|lead/i;
+  function sanitizeId(name) {
+    let id = name.trim().replace(/([a-z0-9])([A-Z])/g, "$1_$2").toLowerCase().replace(/[^a-z0-9]+/g, "_").replace(/^_+|_+$/g, "");
+    if (id && /^[0-9]/.test(id)) id = `p_${id}`;
+    return id;
+  }
+  function isMesh(o) {
+    return o.isMesh === true;
+  }
+  function sizeOf(box2) {
+    return [box2.max.x - box2.min.x, box2.max.y - box2.min.y, box2.max.z - box2.min.z];
+  }
+  function specFromObject3D(THREE, root, options = {}) {
+    const fallback = options.fallback ?? "plastic";
+    const minSize = options.minSize ?? 0.015;
+    root.updateMatrixWorld(true);
+    const inv = root.matrixWorld.clone().invert();
+    const entries = [];
+    const byKey = /* @__PURE__ */ new Map();
+    const visit = (o) => {
+      if (!o.visible || o.userData?.destructionIgnore) return;
+      if (isMesh(o) && o.geometry) {
+        const geom = o.geometry;
+        if (!geom.boundingBox) geom.computeBoundingBox();
+        if (geom.boundingBox && !geom.boundingBox.isEmpty()) {
+          const box2 = geom.boundingBox.clone().applyMatrix4(new THREE.Matrix4().multiplyMatrices(inv, o.matrixWorld));
+          const mats = Array.isArray(o.material) ? o.material : [o.material];
+          const matName = mats[0]?.name ?? "";
+          const ud = o.userData ?? {};
+          const hint = partHintOf(ud.destructionPart);
+          const material = options.materialOf?.(o) ?? (typeof ud.destructionMaterial === "string" ? ud.destructionMaterial : void 0) ?? hint?.material ?? guessMaterial(`${o.name} ${matName} ${typeof ud.material === "string" ? ud.material : ""}`) ?? fallback;
+          const explicit = hint?.id ?? null;
+          const hollow = ud.hollow === true || /hollow/i.test(o.name);
+          const fill = options.fillOf?.(o, material);
+          const tags = Array.isArray(ud.destructionTags) ? ud.destructionTags : void 0;
+          const existing = explicit ? byKey.get(explicit) : void 0;
+          if (existing) {
+            const before = sizeOf(existing.box);
+            const bv = before[0] * before[1] * before[2];
+            const ns = sizeOf(box2);
+            existing.box.union(box2);
+            existing.meshes.push(o);
+            if (ns[0] * ns[1] * ns[2] > bv) existing.material = material;
+            existing.hollow = existing.hollow || hollow;
+            if (fill !== void 0) existing.fill = fill;
+          } else {
+            const e = { key: explicit ?? `m${entries.length}`, meshes: [o], box: box2, material, explicitId: explicit, fill, hollow, tags, fixedId: !!explicit, name: o.name, parent: hint?.parent, jointKind: hint?.kind };
+            entries.push(e);
+            if (explicit) byKey.set(explicit, e);
+          }
+        }
+      }
+      for (const c of o.children) visit(c);
+    };
+    visit(root);
+    const eps = 5e-3;
+    const overlapVolume = (a, b) => {
+      const x = Math.min(a.max.x, b.max.x) - Math.max(a.min.x, b.min.x) + eps;
+      const y = Math.min(a.max.y, b.max.y) - Math.max(a.min.y, b.min.y) + eps;
+      const z = Math.min(a.max.z, b.max.z) - Math.max(a.min.z, b.min.z) + eps;
+      return x > 0 && y > 0 && z > 0 ? x * y * z : 0;
+    };
+    const largest = (e) => Math.max(...sizeOf(e.box));
+    const kept = [];
+    const tiny = [];
+    for (const e of entries) (!e.fixedId && largest(e) < minSize ? tiny : kept).push(e);
+    for (const t of tiny) {
+      let best = null;
+      let bestV = 0;
+      for (const k of kept) {
+        const v = overlapVolume(t.box, k.box);
+        if (v > bestV) {
+          bestV = v;
+          best = k;
+        }
+      }
+      if (!best) {
+        let bd = 0.05;
+        for (const k of kept) {
+          const d = k.box.distanceToPoint(t.box.getCenter(new THREE.Vector3()));
+          if (d < bd) {
+            bd = d;
+            best = k;
+          }
+        }
+      }
+      if (best) {
+        best.meshes.push(...t.meshes);
+      } else {
+        kept.push(t);
+      }
+    }
+    const used = /* @__PURE__ */ new Set();
+    const parts = [];
+    const meshesOf = {};
+    let counter = 0;
+    for (const e of kept) {
+      counter++;
+      let base = (e.explicitId ? sanitizeId(e.explicitId) : "") || sanitizeId(e.name) || `part_${counter}`;
+      let id = base;
+      for (let n = 2; used.has(id); n++) id = `${base}_${n}`;
+      used.add(id);
+      base = id;
+      const size = sizeOf(e.box);
+      const center = e.box.getCenter(new THREE.Vector3());
+      const part = {
+        id,
+        material: e.material,
+        shape: { kind: "box", size: [Math.max(size[0], 2e-3), Math.max(size[1], 2e-3), Math.max(size[2], 2e-3)] },
+        position: [center.x, center.y, center.z]
+      };
+      const minSide = Math.min(...size);
+      if (e.fill !== void 0) part.fill = e.fill;
+      else if (e.hollow) part.fill = 0.05;
+      if (minSide < 0.01 && METAL.test(e.material)) {
+        part.fill = e.fill ?? 1;
+        part.thickness = Math.max(minSide, 5e-4);
+      }
+      if (e.tags) part.tags = [...e.tags];
+      const ao = options.anchorBelow ?? -1;
+      if (ao >= 0 && e.box.min.y <= ao) part.anchored = true;
+      parts.push(part);
+      meshesOf[id] = e.meshes;
+    }
+    const spec = { parts };
+    if (options.name !== void 0) spec.name = options.name;
+    else if (root.name) spec.name = root.name;
+    if (options.tags) spec.tags = [...options.tags];
+    spec.joints = options.joints === false ? [] : inferJoints(parts);
+    if (options.joints !== false) {
+      const finalId = /* @__PURE__ */ new Map();
+      kept.forEach((e, i) => finalId.set(e, parts[i].id));
+      const idOf = /* @__PURE__ */ new Map();
+      for (const e of kept) if (e.explicitId) idOf.set(e.explicitId, finalId.get(e));
+      const joints = spec.joints;
+      for (const e of kept) {
+        if (!e.parent) continue;
+        const id = finalId.get(e);
+        const parent = idOf.get(e.parent) ?? (used.has(sanitizeId(e.parent)) ? sanitizeId(e.parent) : null);
+        if (!parent || parent === id) continue;
+        const at = joints.findIndex((j) => j.a === parent && j.b === id || j.a === id && j.b === parent);
+        const kind = e.jointKind ?? (at >= 0 ? joints[at].kind : "resting");
+        const joint2 = { id: `${parent}~${id}`, a: parent, b: id, kind };
+        if (at >= 0) joints[at] = joint2;
+        else joints.push(joint2);
+      }
+    }
+    return { spec, parts: meshesOf };
+  }
   var STOPS = [
     [450, 0],
     [500, 2753536],
@@ -4166,6 +4473,7 @@ void main() {
       __publicField(this, "m4");
       __publicField(this, "box");
       __publicField(this, "decalCount", 0);
+      __publicField(this, "tints", /* @__PURE__ */ new WeakMap());
       this.kit = new DecalKit(THREE);
       this.a = tmpV(THREE);
       this.b = tmpV(THREE);
@@ -4196,10 +4504,33 @@ void main() {
     vertexCount(mv) {
       return mv.mesh.geometry.getAttribute(POS_ATTR)?.count ?? 0;
     }
-    /** Colour of the original material (before any char), `0xRRGGBB`, or -1. */
+    /**
+     * Average vertex colour of a mesh whose material uses `vertexColors` (computed once per mesh, from its original geometry), else null. Fragments
+     * and debris of such a mesh multiply it by `material.color`; without it they come out white.
+     */
+    vertexTint(mv) {
+      if (this.tints.has(mv.mesh)) return this.tints.get(mv.mesh) ?? null;
+      let tint = null;
+      const used = materialsOf(mv.origMaterial).some((m) => m.vertexColors === true);
+      const attr = used ? mv.origGeometry.getAttribute("color") : void 0;
+      if (attr && attr.count > 0 && attr.itemSize >= 3) {
+        let r = 0, g = 0, b = 0;
+        for (let i = 0; i < attr.count; i++) {
+          r += attr.getX(i);
+          g += attr.getY(i);
+          b += attr.getZ(i);
+        }
+        tint = new this.THREE.Color(r / attr.count, g / attr.count, b / attr.count);
+      }
+      this.tints.set(mv.mesh, tint);
+      return tint;
+    }
+    /** Colour of the original material (before any char) times the vertex tint, `0xRRGGBB`, or -1. */
     baseColorHex(mv) {
       const c = mv.baseColors?.[0] ?? colorOf(materialsOf(mv.origMaterial)[0]);
-      return c ? c.getHex() : -1;
+      if (!c) return -1;
+      const tint = this.vertexTint(mv);
+      return tint ? c.clone().multiply(tint).getHex() : c.getHex();
     }
     /** Is the original material transparent? */
     isTransparent(mv) {
@@ -4668,8 +4999,8 @@ void main() {
       } else {
         const leftovers = [];
         for (const m of meshesIn(root)) {
-          const ud = m.userData?.destructionPart;
-          if (typeof ud === "string" && partIds.has(ud)) add2(ud, m);
+          const ud = partHintOf(m.userData?.destructionPart)?.id;
+          if (ud !== void 0 && partIds.has(ud)) add2(ud, m);
           else if (partIds.has(m.name)) add2(m.name, m);
           else leftovers.push(m);
         }
@@ -4979,7 +5310,10 @@ void main() {
       if (!mv) return null;
       const mat = materialsOf2(mv.mesh.material)[0];
       const c = mat?.color;
-      if (c && c.isColor) return c.getHex();
+      if (c && c.isColor) {
+        const tint = this.visuals.vertexTint(mv);
+        return tint ? c.clone().multiply(tint).getHex() : c.getHex();
+      }
       return def ? fallbackColor(def.id, def) : null;
     }
     debrisOptions(kind, objectId, partId) {
@@ -5423,136 +5757,6 @@ void main() {
       this.disposed = true;
     }
   };
-  var METAL = /steel|iron|metal|alumin|copper|brass|bronze|tin|titan|chrome|zinc|lead/i;
-  function sanitizeId(name) {
-    let id = name.trim().replace(/([a-z0-9])([A-Z])/g, "$1_$2").toLowerCase().replace(/[^a-z0-9]+/g, "_").replace(/^_+|_+$/g, "");
-    if (id && /^[0-9]/.test(id)) id = `p_${id}`;
-    return id;
-  }
-  function isMesh(o) {
-    return o.isMesh === true;
-  }
-  function sizeOf(box2) {
-    return [box2.max.x - box2.min.x, box2.max.y - box2.min.y, box2.max.z - box2.min.z];
-  }
-  function specFromObject3D(THREE, root, options = {}) {
-    const fallback = options.fallback ?? "plastic";
-    const minSize = options.minSize ?? 0.015;
-    root.updateMatrixWorld(true);
-    const inv = root.matrixWorld.clone().invert();
-    const entries = [];
-    const byKey = /* @__PURE__ */ new Map();
-    const visit = (o) => {
-      if (!o.visible || o.userData?.destructionIgnore) return;
-      if (isMesh(o) && o.geometry) {
-        const geom = o.geometry;
-        if (!geom.boundingBox) geom.computeBoundingBox();
-        if (geom.boundingBox && !geom.boundingBox.isEmpty()) {
-          const box2 = geom.boundingBox.clone().applyMatrix4(new THREE.Matrix4().multiplyMatrices(inv, o.matrixWorld));
-          const mats = Array.isArray(o.material) ? o.material : [o.material];
-          const matName = mats[0]?.name ?? "";
-          const ud = o.userData ?? {};
-          const material = options.materialOf?.(o) ?? (typeof ud.destructionMaterial === "string" ? ud.destructionMaterial : void 0) ?? guessMaterial(`${o.name} ${matName} ${typeof ud.material === "string" ? ud.material : ""}`) ?? fallback;
-          const explicit = typeof ud.destructionPart === "string" && ud.destructionPart ? ud.destructionPart : null;
-          const hollow = ud.hollow === true || /hollow/i.test(o.name);
-          const fill = options.fillOf?.(o, material);
-          const tags = Array.isArray(ud.destructionTags) ? ud.destructionTags : void 0;
-          const existing = explicit ? byKey.get(explicit) : void 0;
-          if (existing) {
-            const before = sizeOf(existing.box);
-            const bv = before[0] * before[1] * before[2];
-            const ns = sizeOf(box2);
-            existing.box.union(box2);
-            existing.meshes.push(o);
-            if (ns[0] * ns[1] * ns[2] > bv) existing.material = material;
-            existing.hollow = existing.hollow || hollow;
-            if (fill !== void 0) existing.fill = fill;
-          } else {
-            const e = { key: explicit ?? `m${entries.length}`, meshes: [o], box: box2, material, explicitId: explicit, fill, hollow, tags, fixedId: !!explicit, name: o.name };
-            entries.push(e);
-            if (explicit) byKey.set(explicit, e);
-          }
-        }
-      }
-      for (const c of o.children) visit(c);
-    };
-    visit(root);
-    const eps = 5e-3;
-    const overlapVolume = (a, b) => {
-      const x = Math.min(a.max.x, b.max.x) - Math.max(a.min.x, b.min.x) + eps;
-      const y = Math.min(a.max.y, b.max.y) - Math.max(a.min.y, b.min.y) + eps;
-      const z = Math.min(a.max.z, b.max.z) - Math.max(a.min.z, b.min.z) + eps;
-      return x > 0 && y > 0 && z > 0 ? x * y * z : 0;
-    };
-    const largest = (e) => Math.max(...sizeOf(e.box));
-    const kept = [];
-    const tiny = [];
-    for (const e of entries) (!e.fixedId && largest(e) < minSize ? tiny : kept).push(e);
-    for (const t of tiny) {
-      let best = null;
-      let bestV = 0;
-      for (const k of kept) {
-        const v = overlapVolume(t.box, k.box);
-        if (v > bestV) {
-          bestV = v;
-          best = k;
-        }
-      }
-      if (!best) {
-        let bd = 0.05;
-        for (const k of kept) {
-          const d = k.box.distanceToPoint(t.box.getCenter(new THREE.Vector3()));
-          if (d < bd) {
-            bd = d;
-            best = k;
-          }
-        }
-      }
-      if (best) {
-        best.meshes.push(...t.meshes);
-      } else {
-        kept.push(t);
-      }
-    }
-    const used = /* @__PURE__ */ new Set();
-    const parts = [];
-    const meshesOf = {};
-    let counter = 0;
-    for (const e of kept) {
-      counter++;
-      let base = (e.explicitId ? sanitizeId(e.explicitId) : "") || sanitizeId(e.name) || `part_${counter}`;
-      let id = base;
-      for (let n = 2; used.has(id); n++) id = `${base}_${n}`;
-      used.add(id);
-      base = id;
-      const size = sizeOf(e.box);
-      const center = e.box.getCenter(new THREE.Vector3());
-      const part = {
-        id,
-        material: e.material,
-        shape: { kind: "box", size: [Math.max(size[0], 2e-3), Math.max(size[1], 2e-3), Math.max(size[2], 2e-3)] },
-        position: [center.x, center.y, center.z]
-      };
-      const minSide = Math.min(...size);
-      if (e.fill !== void 0) part.fill = e.fill;
-      else if (e.hollow) part.fill = 0.05;
-      if (minSide < 0.01 && METAL.test(e.material)) {
-        part.fill = e.fill ?? 1;
-        part.thickness = Math.max(minSide, 5e-4);
-      }
-      if (e.tags) part.tags = [...e.tags];
-      const ao = options.anchorBelow ?? -1;
-      if (ao >= 0 && e.box.min.y <= ao) part.anchored = true;
-      parts.push(part);
-      meshesOf[id] = e.meshes;
-    }
-    const spec = { parts };
-    if (options.name !== void 0) spec.name = options.name;
-    else if (root.name) spec.name = root.name;
-    if (options.tags) spec.tags = [...options.tags];
-    spec.joints = options.joints === false ? [] : inferJoints(parts);
-    return { spec, parts: meshesOf };
-  }
 
   // ../game-weapons/dist/index.js
   var __defProp3 = Object.defineProperty;
@@ -5739,6 +5943,36 @@ void main() {
         "grab"
       ]
     },
+    {
+      id: "kick",
+      name: "Kick",
+      category: "melee_blunt",
+      action: {
+        kind: "melee",
+        damage: "blunt",
+        energy: 250,
+        radius: 0.08,
+        reach: 1.1,
+        rpm: 60,
+        noise: 8
+      },
+      mass: 0
+    },
+    {
+      id: "shove",
+      name: "Shove",
+      category: "melee_blunt",
+      action: {
+        kind: "melee",
+        damage: "blunt",
+        energy: 80,
+        radius: 0.1,
+        reach: 1.5,
+        rpm: 90,
+        noise: 5
+      },
+      mass: 0
+    },
     {
       id: "pistol_9mm",
       name: "9 mm service pistol",
@@ -6616,6 +6850,8 @@ void main() {
     en: {
       weapons: {
         hand: "Hand",
+        kick: "Kick",
+        shove: "Shove",
         pistol_9mm: "9 mm service pistol",
         pistol_45: ".45 ACP pistol",
         pistol_22: ".22 LR pistol",
@@ -6662,6 +6898,8 @@ void main() {
     "pt-BR": {
       weapons: {
         hand: "m\xE3o",
+        kick: "chute",
+        shove: "empurr\xE3o",
         pistol_9mm: "pistola 9 mm",
         pistol_45: "pistola .45",
         pistol_22: "pistola .22",
@@ -7058,6 +7296,8 @@ void main() {
   var WEAPONS = weapons_default;
   var DEFAULT_LOADOUT = [
     "hand",
+    "kick",
+    "shove",
     "pistol_9mm",
     "revolver_357",
     "shotgun_pump_12",
@@ -7065,6 +7305,8 @@ void main() {
     "rifle_bolt_308",
     "hammer",
     "axe",
+    "machete",
+    "utility_knife",
     "crowbar",
     "lighter",
     "flamethrower",
@@ -10529,6 +10771,9 @@ void main() {
       "mod.destructible_ok": "{name}: destructible contract ok ({parts} parts, hit and state well-formed)",
       "mod.destructible_fail": "{name}: destructible contract broken: {problems}",
       "mod.animation_ok": '{name}: animation "{clip}" ok ({seconds} s)',
+      "mod.spec_ok": "{name}: spec ok ({parts} parts)",
+      "mod.spec_fail": "{name}: spec broken: {problems}",
+      "mod.spec_warn": "{name}: spec warning: {warning}",
       "mod.animation_fail": '{name}: animation "{clip}" broken: {problems}',
       "ui.animations": "Animations",
       "ui.animations_aim": "Aim at an item or hold it to see its animations.",
@@ -10589,6 +10834,7 @@ void main() {
       "ui.filter.event": "events",
       "ui.filter.check": "checks",
       "ui.autoscroll": "autoscroll",
+      "log.export_cancelled": "export cancelled",
       "ui.copy_json": "Copy JSON",
       "ui.download_ndjson": "Download NDJSON",
       "ui.download_txt": "Download TXT",
@@ -10645,6 +10891,8 @@ void main() {
       "sc.shotgun_splinters_crate.check": "12 ga on the crate: {shots} shot(s), {splinters} board(s) splintered, {holes} holes (expected: at least one splintered)",
       "sc.kick_chair_leg": "A kick takes a chair leg off",
       "sc.kick_chair_leg.check": "Chair: {kicks} kick(s), {groups} group(s), loose pieces {before} \u2192 {after}, {leg} (expected: a loose piece appears)",
+      "sc.kick_detaches_leg_via_tool": "The kick tool (hotbar) takes a chair leg off",
+      "sc.kick_detaches_leg_via_tool.check": "Chair, kick tool: {kicks} kick(s), loose pieces {before} \u2192 {after}, {leg} (expected: a loose piece appears)",
       "sc.screwdriver_shelf_board": "Screwdriver takes a screwed shelf board off in about 2.5 s",
       "sc.screwdriver_shelf_board.check": "Screwdriver on the shelf board: took {secs} s, expected about {want} s, the shelf is now in {pieces}",
       "sc.wrong_tool_refused": "The wrong tool is refused",
@@ -10812,6 +11060,9 @@ void main() {
       "mod.destructible_ok": "{name}: contrato de destrui\xE7\xE3o ok ({parts} pe\xE7as, golpe e estado bem formados)",
       "mod.destructible_fail": "{name}: contrato de destrui\xE7\xE3o quebrado: {problems}",
       "mod.animation_ok": '{name}: anima\xE7\xE3o "{clip}" ok ({seconds} s)',
+      "mod.spec_ok": "{name}: spec ok ({parts} pe\xE7as)",
+      "mod.spec_fail": "{name}: spec quebrada: {problems}",
+      "mod.spec_warn": "{name}: aviso na spec: {warning}",
       "mod.animation_fail": '{name}: anima\xE7\xE3o "{clip}" quebrada: {problems}',
       "ui.animations": "Anima\xE7\xF5es",
       "ui.animations_aim": "Mire num item ou segure-o para ver as anima\xE7\xF5es.",
@@ -10872,6 +11123,7 @@ void main() {
       "ui.filter.event": "eventos",
       "ui.filter.check": "testes",
       "ui.autoscroll": "rolar sozinho",
+      "log.export_cancelled": "exporta\xE7\xE3o cancelada",
       "ui.copy_json": "Copiar JSON",
       "ui.download_ndjson": "Baixar NDJSON",
       "ui.download_txt": "Baixar TXT",
@@ -10928,6 +11180,8 @@ void main() {
       "sc.shotgun_splinters_crate.check": "Calibre 12 no caixote: {shots} tiro(s), {splinters} t\xE1bua(s) lascada(s), {holes} furos (esperado: pelo menos uma lascada)",
       "sc.kick_chair_leg": "Um chute solta a perna da cadeira",
       "sc.kick_chair_leg.check": "Cadeira: {kicks} chute(s), {groups} grupo(s), pe\xE7as soltas {before} \u2192 {after}, {leg} (esperado: aparece uma pe\xE7a solta)",
+      "sc.kick_detaches_leg_via_tool": "A ferramenta chute (barra de atalhos) solta a perna da cadeira",
+      "sc.kick_detaches_leg_via_tool.check": "Cadeira, ferramenta chute: {kicks} chute(s), pe\xE7as soltas {before} \u2192 {after}, {leg} (esperado: aparece uma pe\xE7a solta)",
       "sc.screwdriver_shelf_board": "Chave de fenda solta a prateleira parafusada em cerca de 2,5 s",
       "sc.screwdriver_shelf_board.check": "Chave de fenda na prateleira: levou {secs} s, esperado cerca de {want} s, a estante agora est\xE1 em {pieces}",
       "sc.wrong_tool_refused": "A ferramenta errada \xE9 recusada",
@@ -11429,7 +11683,16 @@ void main() {
     const s = t - m * 60;
     return `${pad(m)}:${s.toFixed(2).padStart(5, "0")}`;
   };
-  function createLog() {
+  function createLog(options = {}) {
+    const host = globalThis.claude;
+    let downloadsP = null;
+    if (host && typeof host.use === "function") {
+      try {
+        downloadsP = Promise.resolve(host.use("downloads")).then((d) => d ?? null, () => null);
+      } catch {
+        downloadsP = null;
+      }
+    }
     let list = [];
     let seq = 0;
     let clock = () => 0;
@@ -11495,9 +11758,20 @@ void main() {
       toJSON: () => JSON.stringify(read(), null, 2),
       toNDJSON: () => read().map((e) => JSON.stringify(e)).join("\n") + (list.length ? "\n" : ""),
       toText: () => read().map((e) => `[${formatTime(e.t)}] ${e.channel.padEnd(6)} ${e.text}`).join("\n"),
-      download(format = "ndjson") {
-        if (typeof document === "undefined" || typeof Blob === "undefined" || typeof URL === "undefined" || !URL.createObjectURL) return;
+      async download(format = "ndjson") {
         const body = format === "json" ? log.toJSON() : format === "txt" ? log.toText() : log.toNDJSON();
+        const downloads = downloadsP ? await downloadsP : null;
+        if (downloads) {
+          const filename = format === "ndjson" ? "test-room-log.ndjson.txt" : `test-room-log.${format}`;
+          try {
+            await downloads.save({ filename, data: body });
+          } catch (err) {
+            const code = err?.code;
+            log.add({ channel: "action", type: "export_cancelled", text: options.exportCancelled?.() ?? "export cancelled", data: { format, ...typeof code === "string" ? { code } : {} } });
+          }
+          return;
+        }
+        if (typeof document === "undefined" || typeof Blob === "undefined" || typeof URL === "undefined" || !URL.createObjectURL) return;
         const mime = format === "json" ? "application/json" : "text/plain";
         const url = URL.createObjectURL(new Blob([body], { type: mime }));
         const a = document.createElement("a");
@@ -12242,6 +12516,10 @@ void main() {
         yaw += yawDeg * Math.PI / 180;
         apply();
       },
+      moveBy(dx, dz) {
+        move(dx, dz);
+        apply();
+      },
       walk(forward, right) {
         move(-Math.sin(yaw) * forward + Math.cos(yaw) * right, -Math.cos(yaw) * forward - Math.sin(yaw) * right);
         apply();
@@ -12373,6 +12651,23 @@ void main() {
           { kicks, before, after }
         );
       }),
+      sc("kick_detaches_leg_via_tool", ({ room, step, expect }) => {
+        const id = at(room, "chair", 0, -4);
+        const before = room.renderer.pieces().length;
+        room.setTool("kick");
+        let kicks = 0;
+        for (; kicks < 8 && room.renderer.pieces().length <= before && part(room, id, "leg_1"); kicks++) {
+          const st = room.world.state(id);
+          const leg = toWorld(st.position, st.rotation, [-0.18, 0.2, -0.18]);
+          const side = rotateVec(st.rotation, [-0.8, 0, 0]);
+          look(room, [leg[0] + side[0], leg[1] + side[1], leg[2] + side[2]], leg);
+          room.use();
+          step(1.05);
+        }
+        step(0.5);
+        const after = room.renderer.pieces().length;
+        expect(after > before, t("sc.kick_detaches_leg_via_tool.check", { kicks, before, after, leg: part(room, id, "leg_1") ? t("leg.still") : t("leg.gone") }), { kicks, before, after });
+      }),
       sc("screwdriver_shelf_board", ({ room, step, expect }) => {
         const id = at(room, "shelf", 0, -4);
         room.setTool("screwdriver");
@@ -12703,16 +12998,25 @@ void main() {
     };
     logBtn(t("ui.copy_json"), () => {
       const text = o.log.toJSON();
-      try {
-        void navigator.clipboard.writeText(text);
-      } catch {
+      const select = () => {
         const ta = mk("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";
         document.body.appendChild(ta);
+        ta.focus();
         ta.select();
-        document.execCommand?.("copy");
-        ta.remove();
-      }
+        let copied = false;
+        try {
+          copied = !!document.execCommand?.("copy");
+        } catch {
+          copied = false;
+        }
+        if (copied) ta.remove();
+        else ta.onblur = () => ta.remove();
+      };
+      if (typeof navigator !== "undefined" && navigator.clipboard?.writeText) navigator.clipboard.writeText(text).catch(select);
+      else select();
     });
     logBtn(t("ui.download_ndjson"), () => o.log.download("ndjson"));
     logBtn(t("ui.download_txt"), () => o.log.download("txt"));
@@ -13124,7 +13428,7 @@ void main() {
     const entries = /* @__PURE__ */ new Map();
     const splitOf = /* @__PURE__ */ new Map();
     let simTime = 0;
-    const log = createLog();
+    const log = createLog({ exportCancelled: () => t("log.export_cancelled") });
     log.setClock(() => simTime);
     const renderer = createDestructionRenderer(THREE, {
       scene,
@@ -13498,6 +13802,7 @@ void main() {
       addArena();
       timeScale = 1;
       fastForward = false;
+      walkPlan = null;
     };
     const aimO = [0, 0, 0];
     const aimD = [0, 0, -1];
@@ -13749,11 +14054,11 @@ void main() {
         1
       );
     };
-    const meleeUse = (u) => {
-      const w = toolName();
+    const meleeUse = (u, id = toolId) => {
+      const w = toolName(id);
       const r = rayWorld(u.origin, u.direction, u.reach);
       if (!r) {
-        action("melee", t("act.melee.miss", { weapon: w }), { data: { weapon: toolId } });
+        action("melee", t("act.melee.miss", { weapon: w }), { data: { weapon: id } });
         return;
       }
       world.hitPart(r.object, r.part, { type: u.damage, point: r.point, direction: u.direction, energy: u.energy, radius: u.radius, source: "player" });
@@ -13762,7 +14067,7 @@ void main() {
         objectId: r.object,
         itemId: entryOf(r.object)?.so.itemId,
         part: r.part,
-        data: { weapon: toolId, damage: u.damage, energyJ: u.energy, distanceM: Math.round(r.distance * 100) / 100 }
+        data: { weapon: id, damage: u.damage, energyJ: u.energy, distanceM: Math.round(r.distance * 100) / 100 }
       });
     };
     const toolWork = (u, dt) => {
@@ -13773,7 +14078,7 @@ void main() {
         log.coalesce(`use:${toolId}`, { channel: "action", type: "tool", text: t("act.tool.none", { weapon: w }), data: { weapon: toolId } }, 1);
         return;
       }
-      const j = world.nearestJoint(r.object, r.point, 0.45);
+      const j = world.nearestJoint(r.object, r.point, 0.45, u.tool);
       if (!j) {
         progress = null;
         log.coalesce(`use:${toolId}`, { channel: "action", type: "tool", text: t("act.tool.nojoint", { weapon: w, where: hitWhere(r) }), objectId: r.object, part: r.part }, 1);
@@ -13952,6 +14257,13 @@ void main() {
         }
       }
     };
+    const kick = () => {
+      if (!arsenal.weapons.has("kick")) return;
+      aim();
+      const res = toolState("kick").trigger([aimO[0], aimO[1], aimO[2]], [aimD[0], aimD[1], aimD[2]], 0, false, "player");
+      if (res.status !== "ok") return;
+      for (const u of res.uses) if (u.kind === "melee") meleeUse(u, "kick");
+    };
     const setTool = (id) => {
       if (!arsenal.weapons.has(id)) throw new Error(`game-test-room: unknown weapon "${id}"`);
       tool.release();
@@ -14207,7 +14519,7 @@ void main() {
           break;
         case "KeyV":
           if (heldEntry?.uses[2]) useItem(heldEntry.uses[2]);
-          else toggleTap();
+          else kick();
           break;
         case "KeyT":
           toggleTap();
@@ -14306,8 +14618,19 @@ void main() {
         if (part && part.liters !== void 0 && Math.abs(part.liters - c.liters) > 1e-4) world.setLiters(host.objectId, e.fluidPart, c.liters);
       }
     };
+    let paused = false;
+    let walkPlan = null;
+    const stepWalk = (dt) => {
+      if (!walkPlan) return;
+      const f = walkPlan.remaining <= dt ? 1 : dt / walkPlan.remaining;
+      player.moveBy((walkPlan.x - camera.position.x) * f, (walkPlan.z - camera.position.z) * f);
+      walkPlan.remaining -= dt;
+      if (walkPlan.remaining <= 1e-9) walkPlan = null;
+    };
     const stepSim = (dt) => {
+      if (paused) return;
       simTime += dt;
+      stepWalk(dt);
       const reps = fastForward ? 10 : 1;
       updateAnimations(dt);
       updateItemUse(dt);
@@ -14336,13 +14659,13 @@ void main() {
       if (tiltKey || heldTilt > 0) {
         heldTilt = Math.max(0, Math.min(2.4, heldTilt + (tiltKey ? 2.2 : -3) * dt));
       }
-      if (useHeld) {
+      if (useHeld && !paused) {
         if (tool.def.category === "hand") {
           if (useFirst) grab();
         } else useTool(dt, !useFirst);
         useFirst = false;
       }
-      followHeld(dt);
+      if (!paused) followHeld(dt);
       stepSim(dt * timeScale);
       if (progress && simTime - progress.at > 0.25) progress = null;
       hudAcc += dt;
@@ -14403,6 +14726,16 @@ void main() {
         const pose = poseAt(pl.clip, id === "" ? null : id, pl.t);
         obj.position.set(rest.p[0] + pose.position[0], rest.p[1] + pose.position[1], rest.p[2] + pose.position[2]);
         obj.rotation.set(rest.r[0] + pose.rotation[0], rest.r[1] + pose.rotation[1], rest.r[2] + pose.rotation[2]);
+        const ps = id === "" ? void 0 : specs.get(pl.entry.so.objectId)?.parts.find((p) => p.id === id);
+        if (ps) {
+          const r0 = ps.rotation ?? ZERO;
+          world.setPartPose(
+            pl.entry.so.objectId,
+            id,
+            [ps.position[0] + pose.position[0], ps.position[1] + pose.position[1], ps.position[2] + pose.position[2]],
+            [r0[0] + pose.rotation[0], r0[1] + pose.rotation[1], r0[2] + pose.rotation[2]]
+          );
+        }
       }
     };
     const updateAnimations = (dt) => {
@@ -14490,8 +14823,14 @@ void main() {
             partIds = probe.describe().parts.map((p) => p.id);
             moduleCheck(r.ok, r.ok ? t("mod.destructible_ok", { name: item.name, parts: partIds.length }) : t("mod.destructible_fail", { name: item.name, problems: r.problems.join("; ") }), { ...base, check: "destructible", problems: r.problems }, item.id);
             for (const p of r.problems) fail(`${item.id}: ${p}`);
-          } else {
-            partIds = resolveSpec(item, root).spec.parts.map((p) => p.id);
+          }
+          if (!item.impl || item.spec) {
+            const spec = resolveSpec(item, root).spec;
+            if (!item.impl) partIds = spec.parts.map((p) => p.id);
+            const r = checkSpec(spec, { materials: world.materials.keys() });
+            moduleCheck(r.ok, r.ok ? t("mod.spec_ok", { name: item.name, parts: spec.parts.length }) : t("mod.spec_fail", { name: item.name, problems: r.problems.join("; ") }), { ...base, check: "spec", problems: r.problems, warnings: r.warnings }, item.id);
+            for (const p of r.problems) fail(`${item.id}: ${p}`);
+            for (const w of r.warnings) log.add({ channel: "check", type: "warn", text: `\u26A0 ${t("mod.spec_warn", { name: item.name, warning: w })}`, itemId: item.id, data: { ok: true, ...base, check: "spec", warning: w } });
           }
         } catch (err) {
           const msg = err instanceof Error ? err.message : String(err);
@@ -14530,6 +14869,8 @@ void main() {
       const all = list ?? allScenarios();
       const report = { passed: 0, failed: 0, results: [] };
       scenarioRunning = true;
+      const wasPaused = paused;
+      paused = false;
       try {
         for (const sc of all) {
           hardReset();
@@ -14561,6 +14902,7 @@ void main() {
         }
       } finally {
         scenarioRunning = false;
+        paused = wasPaused;
       }
       return report;
     };
@@ -14623,6 +14965,19 @@ void main() {
         heldTilt = rad;
       },
       toggleTap,
+      pause() {
+        paused = true;
+      },
+      resume() {
+        paused = false;
+      },
+      get paused() {
+        return paused;
+      },
+      walk(to, seconds) {
+        walkPlan = seconds > 0 ? { x: to[0], z: to[2], remaining: seconds } : null;
+        if (!walkPlan) player.moveBy(to[0] - camera.position.x, to[2] - camera.position.z);
+      },
       setSlowMotion(on) {
         timeScale = on ? 0.25 : 1;
       },