@adatechnology/game-weapons-three 0.9.0 → 0.10.1

package/dist/index.global.js

@@ -19681,6 +19681,62 @@ uniform mat4 uNodes[${nodes.length}]; attribute float aNodeIndex; attribute vec3
     return angle === 0 ? q : quat.mul(q, quat.fromAxisAngle([0, 0, 1], angle));
   };
   var clamp = (v, a, b) => Math.max(a, Math.min(b, v));
+  var splinterBox = (inp, box5, limit = inp.maxFragments) => {
+    const { rnd: rnd2 } = inp;
+    const dims = box5.s;
+    const [fmin, fmax] = inp.fragmentSize;
+    const g = inp.grain ?? [0, 1, 2].sort((a2, b2) => dims[b2] - dims[a2])[0];
+    const [a, b] = [0, 1, 2].filter((i) => i !== g);
+    const w = Math.max(fmin * 1.5, 0.01);
+    const c = clamp(Math.round(dims[a] * dims[b] / (w * w)), 3, Math.max(3, Math.floor(limit / 2)));
+    const maxLen = fmax * 4;
+    const cells = bsp(box5, c, [a, b], rnd2);
+    const pieces = [];
+    for (const cell of cells) {
+      const extra = rnd2() < 0.4 ? 1 : 0;
+      const k = Math.max(1, Math.ceil(dims[g] / maxLen)) + extra;
+      for (const p of bsp(cell, k, [g], rnd2)) pieces.push(p);
+    }
+    return pieces.slice(0, limit).map((p) => ({ center: p.c, size: [p.s[g], p.s[a], p.s[b]], q: frame(g, a, b), shape: "splinter", weight: p.s[0] * p.s[1] * p.s[2] }));
+  };
+  var severAt = (inp, root, at3, gap) => {
+    const dims = root.s;
+    const L = [0, 1, 2].sort((x, y) => dims[y] - dims[x])[0];
+    const half = dims[L] / 2;
+    const lo = clamp(at3 - gap / 2, -half, half), hi = clamp(at3 + gap / 2, -half, half);
+    const out = [];
+    const stub = (from, to) => {
+      if (to - from < 0.02) return;
+      const c = [root.c[0], root.c[1], root.c[2]], sz = [dims[0], dims[1], dims[2]];
+      c[L] = (from + to) / 2;
+      sz[L] = to - from;
+      out.push({ center: c, size: sz, q: quat.identity(), shape: "slab", weight: sz[0] * sz[1] * sz[2] });
+    };
+    stub(-half, lo);
+    stub(hi, half);
+    const band = { c: [root.c[0], root.c[1], root.c[2]], s: [dims[0], dims[1], dims[2]] };
+    band.c[L] = (lo + hi) / 2;
+    band.s[L] = Math.max(hi - lo, 0.01);
+    for (const p of splinterBox(inp, band, Math.max(3, inp.maxFragments - out.length))) out.push(p);
+    return out;
+  };
+  var tearStack = (inp, root, t, u, v, n, sheet) => {
+    const { dims, rnd: rnd2, maxFragments } = inp;
+    const layers = clamp(Math.ceil(dims[t] / STACK_LAYER), 2, 4);
+    const per = clamp(n, 3, Math.max(3, Math.floor(maxFragments / layers)));
+    const out = [];
+    for (let k = 0; k < layers; k++) {
+      const off = -dims[t] / 2 + (k + 0.5) * dims[t] / layers;
+      for (const b of bsp(root, per, [u, v], rnd2)) {
+        if (out.length >= maxFragments) return out;
+        const c = [b.c[0], b.c[1], b.c[2]];
+        c[t] = off;
+        out.push({ center: c, size: [b.s[u], b.s[v], sheet], q: frame(u, v, t, (rnd2() - 0.5) * 0.8), shape: "scrap", weight: b.s[u] * b.s[v], inner: out.length % 4 !== 0 });
+      }
+    }
+    return out;
+  };
+  var STACK_LAYER = 0.012;
   var planFragments = (inp) => {
     const { style, dims, rnd: rnd2, maxFragments } = inp;
     const [fmin, fmax] = inp.fragmentSize;
@@ -19702,27 +19758,14 @@ uniform mat4 uNodes[${nodes.length}]; attribute float aNodeIndex; attribute vec3
       return out;
     }
     if (style === "splinter") {
-      const g = inp.grain ?? [0, 1, 2].sort((a2, b2) => dims[b2] - dims[a2])[0];
-      const [a, b] = [0, 1, 2].filter((i) => i !== g);
-      const w = Math.max(fmin * 1.5, 0.01);
-      const c = clamp(Math.round(dims[a] * dims[b] / (w * w)), 3, Math.max(3, Math.floor(maxFragments / 2)));
-      const maxLen = fmax * 4;
-      const cells = bsp(root, c, [a, b], rnd2);
-      const pieces = [];
-      for (const cell of cells) {
-        let list2 = [cell];
-        const extra = rnd2() < 0.4 ? 1 : 0;
-        const k = Math.max(1, Math.ceil(dims[g] / maxLen)) + extra;
-        list2 = bsp(cell, k, [g], rnd2);
-        for (const p of list2) pieces.push(p);
-      }
-      for (const p of pieces.slice(0, maxFragments)) {
-        out.push({ center: p.c, size: [p.s[g], p.s[a], p.s[b]], q: frame(g, a, b), shape: "splinter", weight: p.s[0] * p.s[1] * p.s[2] });
-      }
+      if (inp.cut) return severAt(inp, root, inp.cut.at, inp.cut.gap);
+      for (const p of splinterBox(inp, root)) out.push(p);
       return out;
     }
     if (style === "tear") {
       const n2 = clamp(Math.round(dims[u] * dims[v] / (mean * mean)), 3, maxFragments);
+      const sheet = inp.sheet ?? 0;
+      if (sheet > 0 && dims[t] > sheet * 4) return tearStack(inp, root, t, u, v, n2, sheet);
       const th2 = Math.min(inp.thickness, dims[t]);
       for (const b of bsp(root, n2, [u, v], rnd2)) {
         out.push({ center: [b.c[0], b.c[1], b.c[2]], size: [b.s[u], b.s[v], th2], q: frame(u, v, t), shape: "scrap", weight: b.s[u] * b.s[v] });
@@ -21305,6 +21348,7 @@ uniform mat4 uNodes[${nodes.length}]; attribute float aNodeIndex; attribute vec3
         0.03,
         0.15
       ],
+      sheet: 1e-3,
       damageScale: {
         slash: 3
       },
@@ -21320,7 +21364,8 @@ uniform mat4 uNodes[${nodes.length}]; attribute float aNodeIndex; attribute vec3
         smoke: "grey"
       },
       visual: {
-        charColor: 1709072
+        charColor: 1709072,
+        innerColor: 15524048
       },
       tags: [
         "fabric",
@@ -21702,9 +21747,14 @@ uniform mat4 uNodes[${nodes.length}]; attribute float aNodeIndex; attribute vec3
   var BREACH_AREA = 0.25;
   var BREACH_BLAST_REACH = 0.12;
   var RESIDUAL_CAPACITY = 0.15;
+  var SEVER_BAND = 0.1;
+  var SEVER_ASPECT = 3;
+  var SEVER_BALLISTIC = 2;
   var SUPPORT_TOLERANCE = 0.05;
   var UNIT_FRAGMENT_FACTOR = 4;
   var BREACH_GRID_CAP = 4096;
+  var CHIP_ENERGY = 200;
+  var CHIP_SPLASH = 0.5;
   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));
@@ -21748,6 +21798,7 @@ uniform mat4 uNodes[${nodes.length}]; attribute float aNodeIndex; attribute vec3
     let windCfg = windOpts ? resolveWind(windOpts) : null;
     const ignitionRules = resolveIgnitionRules(options.ignition);
     const breachBlastFactor = options.breach?.blastFactor ?? BREACH_BLAST_FACTOR;
+    const chipEnergy = options.breach?.chipEnergy ?? CHIP_ENERGY;
     const rng2 = createRng2(options.seed ?? 1);
     const rnd2 = () => rng2.next();
     let time = 0;
@@ -22121,41 +22172,68 @@ uniform mat4 uNodes[${nodes.length}]; attribute float aNodeIndex; attribute vec3
       markDamaged(p);
       if (p.rt.hinge >= flexure.failRotationDeg * Math.PI / 180) hingeDrop(o, p, src);
     };
+    const freeSpan = (p, supports) => {
+      if (supports.length === 0) return Infinity;
+      const d = p.dims;
+      const L = [0, 1, 2].sort((a, b) => d[b] - d[a])[0];
+      const spans = supports.map((k) => contactBox(p, k)).map(([lo, hi]) => [lo[L], hi[L]]);
+      let far = 0;
+      for (let i = 0; i <= 16; i++) {
+        const x = (i / 16 - 0.5) * d[L];
+        let near = Infinity;
+        for (const [lo, hi] of spans) near = Math.min(near, Math.max(lo - x, x - hi, 0));
+        far = Math.max(far, near);
+      }
+      return 2 * far;
+    };
     const solveStructure = (o) => {
       o.maxStress = 0;
       if (!o.hasStructure) return;
       const parts = o.parts;
       const n = parts.length;
       const dist2 = new Array(n).fill(-1);
-      const queue = [];
       const ok = (i) => parts[i].structural && !isLost(parts[i]);
       const isPartition = (i) => parts[i].spec.structure?.role === "partition";
-      for (let i = 0; i < n; i++) if (ok(i) && parts[i].anchored) {
-        dist2[i] = 0;
-        queue.push(i);
-      }
-      for (let h = 0; h < queue.length; h++) {
-        const s = queue[h];
-        if (isPartition(s)) continue;
-        for (const j of o.byPart.get(parts[s].spec.id)) {
-          if (j.st.open || !j.bears) continue;
-          const r = j.ia === s ? j.ib : j.ia;
-          if (dist2[r] >= 0 || !ok(r) || restsOn(o, j, r) !== s) continue;
-          dist2[r] = dist2[s] + 1;
-          queue.push(r);
+      const out = /* @__PURE__ */ new Set();
+      let queue = [];
+      let lowerOf = /* @__PURE__ */ new Map();
+      for (; ; ) {
+        dist2.fill(-1);
+        queue = [];
+        for (let i = 0; i < n; i++) if (ok(i) && !out.has(i) && parts[i].anchored) {
+          dist2[i] = 0;
+          queue.push(i);
+        }
+        for (let h = 0; h < queue.length; h++) {
+          const s = queue[h];
+          if (isPartition(s)) continue;
+          for (const j of o.byPart.get(parts[s].spec.id)) {
+            if (j.st.open || !j.bears) continue;
+            const r = j.ia === s ? j.ib : j.ia;
+            if (dist2[r] >= 0 || !ok(r) || out.has(r) || restsOn(o, j, r) !== s) continue;
+            dist2[r] = dist2[s] + 1;
+            queue.push(r);
+          }
         }
-      }
-      const incoming = new Array(n).fill(0);
-      const lowerOf = /* @__PURE__ */ new Map();
-      for (const i of queue) {
-        const lower = [];
-        for (const j of o.byPart.get(parts[i].spec.id)) {
-          if (j.st.open || !j.bears) continue;
-          const k = restsOn(o, j, i);
-          if (k >= 0 && dist2[k] >= 0 && dist2[k] < dist2[i] && !isPartition(k)) lower.push(k);
+        lowerOf = /* @__PURE__ */ new Map();
+        let dropped = false;
+        for (const i of queue) {
+          const lower = [];
+          for (const j of o.byPart.get(parts[i].spec.id)) {
+            if (j.st.open || !j.bears) continue;
+            const k = restsOn(o, j, i);
+            if (k >= 0 && dist2[k] >= 0 && dist2[k] < dist2[i] && !isPartition(k)) lower.push(k);
+          }
+          lowerOf.set(i, lower);
+          const max2 = parts[i].spec.structure?.maxSpan;
+          if (max2 !== void 0 && !parts[i].anchored && freeSpan(parts[i], lower.map((k) => parts[k])) > max2) {
+            out.add(i);
+            dropped = true;
+          }
         }
-        lowerOf.set(i, lower);
+        if (!dropped) break;
       }
+      const incoming = new Array(n).fill(0);
       const bending = new Array(n).fill(0);
       const through = parts.map(() => []);
       const pass = (k, at3, mass) => {
@@ -22667,6 +22745,7 @@ uniform mat4 uNodes[${nodes.length}]; attribute float aNodeIndex; attribute vec3
           const r = rayPart(o, p, origin, d);
           if (!r || r.t0 < 0 || r.t0 > maxDist) continue;
           if (p.st.opening && insideOpening(o, p, vec.madd(origin, d, r.t0))) continue;
+          if (p.st.chipped && insideChip(p, objLocal(o, vec.madd(origin, d, r.t0)))) continue;
           if (!best || r.t0 < best.distance) best = { object: o.id, part: p.spec.id, point: vec.madd(origin, d, r.t0), normal: r.n, distance: r.t0, pathLen: r.t1 - r.t0 };
         }
       }
@@ -22930,6 +23009,62 @@ uniform mat4 uNodes[${nodes.length}]; attribute float aNodeIndex; attribute vec3
       if (total < (p.spec.breach?.area ?? BREACH_AREA)) return;
       openBreach(o, p, [sum2[0] / total, sum2[1] / total, sum2[2] / total], total, energy, dir, src);
     };
+    const unitGrids = /* @__PURE__ */ new WeakMap();
+    const gridOf = (p) => {
+      let grid = unitGrids.get(p);
+      if (!grid) unitGrids.set(p, grid = unitGrid(p.dims, p.thin, unitsOf2(p), BREACH_GRID_CAP));
+      return grid;
+    };
+    const insideChip = (p, objectPoint) => {
+      const cells = p.st.chipped;
+      if (!cells?.length) return false;
+      const [u, v] = planeAxes(p.thin);
+      const lp = toLocal(p.pos, p.q, objectPoint);
+      return cells.some((c) => Math.abs(lp[u] - c.center[u]) <= c.size[u] / 2 && Math.abs(lp[v] - c.center[v]) <= c.size[v] / 2);
+    };
+    const chipUnits = (o, p, wp, energy, dir, radius, src) => {
+      var _a, _b;
+      if (!p.spec.units || p.spec.reinforcement || !p.staged || chipEnergy <= 0 || energy <= 0 || p.st.stripped || isLost(p) || (p.st.stage ?? 0) >= 2) return;
+      const [u, v] = planeAxes(p.thin);
+      const lp = toLocal(p.pos, p.q, objLocal(o, wp));
+      const grid = gridOf(p);
+      const worn = (_a = p.rt).chips ?? (_a.chips = {});
+      const out = [];
+      for (let i = 0; i < grid.length; i++) {
+        const cell = grid[i];
+        if (worn[i] === -1) continue;
+        const gap = Math.hypot(Math.max(0, Math.abs(lp[u] - cell.center[u]) - cell.size[u] / 2), Math.max(0, Math.abs(lp[v] - cell.center[v]) - cell.size[v] / 2));
+        if (gap > radius) continue;
+        const share = gap === 0 ? 1 : CHIP_SPLASH * (1 - gap / radius);
+        const total = (worn[i] ?? 0) + energy * share;
+        const mass = p.mat.density * cell.size[0] * cell.size[1] * cell.size[2];
+        if (total < chipEnergy * mass) {
+          worn[i] = total;
+          continue;
+        }
+        worn[i] = -1;
+        out.push(cell);
+      }
+      if (out.length === 0) return;
+      const { c, q } = partXf(o, p);
+      const chipped = (_b = p.st).chipped ?? (_b.chipped = []);
+      const holes = localHolesOf(p);
+      for (const cell of out) {
+        const mass = Math.min(p.st.mass, p.mat.density * cell.size[0] * cell.size[1] * cell.size[2]);
+        const center = toWorld(c, q, cell.center);
+        const speed = clamp2(Math.sqrt(2 * energy * 0.05 / Math.max(mass, 0.05)), 0.5, 6);
+        const fragments = cellFragments(o, p, [cell], wp, dir, speed, mass, `c${chipped.length}_`);
+        p.st.holes = p.st.holes.filter((_, k) => marksInBox(cell.center, cell.size, void 0, [holes[k]]).length === 0);
+        chipped.push({ center: [cell.center[0], cell.center[1], cell.center[2]], size: [cell.size[0], cell.size[1], cell.size[2]] });
+        p.st.mass = Math.max(0, p.st.mass - mass);
+        p.rt.removed = (p.rt.removed ?? 0) + mass;
+        markDamaged(p);
+        setStage(o, p, 1, {}, src);
+        emit2({ ...base(o, src), type: "chip", part: p.spec.id, center, size: [cell.size[0], cell.size[1], cell.size[2]], rotation: q, fragments });
+        debris2(o, p, p.mat.breakDebris, center, vec.scale(dir ?? [0, 1, 0], -1), 6, 2, src);
+      }
+      for (const cell of out) addBreach(o, p, toWorld(c, q, cell.center), cell.size[u] * cell.size[v], energy, dir, src);
+    };
     const openBreach = (o, p, center, total, energy, dir, src) => {
       const [u, v] = planeAxes(p.thin);
       const radius = clamp2(Math.sqrt(total / Math.PI), Math.sqrt((p.spec.breach?.area ?? BREACH_AREA) / Math.PI), breachRadius);
@@ -22941,7 +23076,8 @@ uniform mat4 uNodes[${nodes.length}]; attribute float aNodeIndex; attribute vec3
         failPart(o, p, worldCenter, dir, energy, 12, src);
         return;
       }
-      const cells = cellsWithin(unitGrid(p.dims, p.thin, unitsOf2(p), BREACH_GRID_CAP), p.thin, lc, radius);
+      const worn = p.rt.chips;
+      const cells = cellsWithin(gridOf(p).filter((_, i) => worn?.[i] !== -1), p.thin, lc, radius);
       const removed = p.st.mass * cells.reduce((sum2, cell) => sum2 + cell.size[u] * cell.size[v], 0) / (p.dims[u] * p.dims[v]);
       const speed = clamp2(Math.sqrt(2 * energy * 0.1 / Math.max(removed, 0.05)), 0.5, 8);
       const fragments = cellFragments(o, p, cells, worldCenter, dir, speed, removed, "b");
@@ -23025,6 +23161,8 @@ uniform mat4 uNodes[${nodes.length}]; attribute float aNodeIndex; attribute vec3
       const grain = p.spec.grain ? AXIS[p.spec.grain] : void 0;
       const hitLocal = toLocal(c, q, hitW);
       const unitPlan = p.spec.units ? unitFragmentPlan(p, maxFragments * UNIT_FRAGMENT_FACTOR) : [];
+      const axis2 = style === "splinter" ? severAxis(p) : -1;
+      const cutAt2 = axis2 < 0 ? void 0 : p.rt.cutAt ?? (origin ? hitLocal[axis2] : void 0);
       const plan = unitPlan.length > 0 ? unitPlan : planFragments({
         style,
         dims: p.dims,
@@ -23033,7 +23171,9 @@ uniform mat4 uNodes[${nodes.length}]; attribute float aNodeIndex; attribute vec3
         hit: hitLocal,
         fragmentSize: p.mat.fragmentSize ?? [0.04, 0.2],
         maxFragments,
-        rnd: rnd2
+        rnd: rnd2,
+        sheet: p.mat.sheet,
+        ...cutAt2 !== void 0 ? { cut: { at: cutAt2, gap: SEVER_BAND } } : {}
       });
       const holes = p.st.holes.length > 0 ? localHolesOf(p) : [];
       const mass = p.st.mass;
@@ -23057,7 +23197,8 @@ uniform mat4 uNodes[${nodes.length}]; attribute float aNodeIndex; attribute vec3
           velocity: [dv[0] * k, dv[1] * k + 0.5 * rnd2(), dv[2] * k],
           angularVelocity: [(rnd2() - 0.5) * 12, (rnd2() - 0.5) * 12, (rnd2() - 0.5) * 12],
           mass: mass * f.weight / totW,
-          ...marks.length > 0 ? { marks } : {}
+          ...marks.length > 0 ? { marks } : {},
+          ...f.inner ? { inner: true } : {}
         };
       });
       const reinforcement = p.spec.reinforcement;
@@ -23091,10 +23232,33 @@ uniform mat4 uNodes[${nodes.length}]; attribute float aNodeIndex; attribute vec3
       emit2({ ...base(o, src), type: "primed", part: p.spec.id, point: partXf(o, p).c, trigger, delay });
     };
     const CHAIN_TRIGGER_OF = { ballistic: "shot", explosive: "explosion" };
+    const severAxis = (p) => {
+      if (p.mat.fracture !== "splinter" || p.spec.shape.kind !== "box") return -1;
+      const d = p.dims;
+      const order = [0, 1, 2].sort((a, b) => d[b] - d[a]);
+      return d[order[0]] >= SEVER_ASPECT * d[order[1]] && d[order[0]] >= 3 * SEVER_BAND ? order[0] : -1;
+    };
+    const bandOf = (o, p, axis2, origin) => {
+      const { c, q } = partXf(o, p);
+      const along = toLocal(c, q, origin)[axis2];
+      const L = p.dims[axis2];
+      return clamp2(Math.floor((along + L / 2) / SEVER_BAND), 0, Math.ceil(L / SEVER_BAND) - 1);
+    };
     const applyDamage = (o, p, amount, type, origin, dir, fragEnergy, cap, src) => {
+      var _a;
       if (isLost(p) || amount <= 0) return 0;
       const prev = p.st.hp;
       p.st.hp -= amount;
+      const axis2 = origin && type !== "fire" && type !== "heat" ? severAxis(p) : -1;
+      if (axis2 >= 0 && p.st.hp > 0) {
+        const band = bandOf(o, p, axis2, origin);
+        const cuts = (_a = p.rt).cuts ?? (_a.cuts = {});
+        cuts[band] = (cuts[band] ?? 0) + amount * (type === "ballistic" ? SEVER_BALLISTIC : 1);
+        if (cuts[band] >= p.st.maxHp * SEVER_BAND / p.dims[axis2]) {
+          p.rt.cutAt = -p.dims[axis2] / 2 + (band + 0.5) * SEVER_BAND;
+          p.st.hp = 0;
+        }
+      }
       markDamaged(p);
       const trigger = CHAIN_TRIGGER_OF[type];
       const chained = trigger !== void 0 && chainDelayOf(p.spec, trigger) !== void 0;
@@ -23133,7 +23297,7 @@ uniform mat4 uNodes[${nodes.length}]; attribute float aNodeIndex; attribute vec3
     const ballistic = (o, p, entry2, n, d, E, caliber, pathLen, src, round5 = {}) => {
       const mat = p.mat;
       const piercing = round5.piercing ?? 1;
-      if (p.st.stripped || p.st.opening && insideOpening(o, p, objLocal(o, entry2))) {
+      if (p.st.stripped || p.st.opening && insideOpening(o, p, objLocal(o, entry2)) || insideChip(p, objLocal(o, entry2))) {
         return { penetrated: true, exitEnergy: E, exitPoint: vec.madd(entry2, d, Math.min(pathLen, p.thickness)), damage: 0 };
       }
       const sin2 = Math.min(1, Math.abs(vec.dot(d, n)));
@@ -23192,6 +23356,7 @@ uniform mat4 uNodes[${nodes.length}]; attribute float aNodeIndex; attribute vec3
       debris2(o, p, mat.hitDebris, entry2, n, clamp2(Math.round(E / 60) + 2, 2, 14), clamp2(Math.sqrt(E) / 6, 1, 8), src);
       wearJoints(o, p, (penetrated ? thr : E) * 0.02, void 0, 0, src, true);
       const dmg = applyDamage(o, p, E * DMG_PER_J * scale, "ballistic", entry2, d, E * 0.1, 12, src);
+      chipUnits(o, p, entry2, penetrated ? Math.min(E, Math.max(thr, E * 0.5)) : E, d, Math.max(0.05, caliber / 1e3 * 8), src);
       return { penetrated, exitEnergy: penetrated ? penMm !== void 0 ? E * (1 - thr / Ep) : E - thr / (hard ? piercing : 1) : 0, exitPoint, damage: dmg };
     };
     const melee = (o, p, kind, E, point, n, d, contactR, src) => {
@@ -23219,6 +23384,7 @@ uniform mat4 uNodes[${nodes.length}]; attribute float aNodeIndex; attribute vec3
       const scale = mat.damageScale?.[kind] ?? 1;
       const done = applyDamage(o, p, Ec * DMG_PER_J * scale * (kind === "slash" ? p.cutFactor : 1), kind, point, d, E * 0.1, 12, src);
       addBreach(o, p, point, breachAreaOf(p, done, false), E, d, src);
+      if (kind === "blunt") chipUnits(o, p, point, E, d, Math.max(contactR, 0.03), src);
       return done;
     };
     const blastPart = (o, p, point, energy, radius, src, res, reachAt) => {
@@ -33237,12 +33403,12 @@ uniform mat4 uNodes[${nodes.length}]; attribute float aNodeIndex; attribute vec3
       A.invalidate = () => {
         for (let i = 0; i < NS; i++) PL[i].shadow.needsUpdate = true;
       };
-      A.update = function(houses, focus, op) {
+      A.update = function(houses2, focus, op) {
         op = op || {};
-        houses = (Array.isArray(houses) ? houses : [houses]).filter(Boolean);
+        houses2 = (Array.isArray(houses2) ? houses2 : [houses2]).filter(Boolean);
         _f.set(focus.x, focus.y, focus.z);
         const rooms = [], exterior = [];
-        for (const house of houses) {
+        for (const house of houses2) {
           if (house.group && !house.group.visible) continue;
           house.house.updateMatrixWorld(true);
           const M = house.house.matrixWorld, by = /* @__PURE__ */ new Map();
@@ -33621,7 +33787,12 @@ uniform mat4 uNodes[${nodes.length}]; attribute float aNodeIndex; attribute vec3
         }
         return null;
       };
-      function courses(part, units, opening, paint2) {
+      const local2 = (p) => {
+        house.updateMatrixWorld(true);
+        const v = house.worldToLocal(tmp.p.set(p[0], p[1], p[2]));
+        return [v.x, v.y, v.z];
+      };
+      function courses(part, units, opening, chips2, paint2) {
         const [u0, v0, u1, v1] = part.aabb;
         const alongU = u1 - u0 >= v1 - v0;
         const len = alongU ? u1 - u0 : v1 - v0;
@@ -33645,23 +33816,39 @@ uniform mat4 uNodes[${nodes.length}]; attribute float aNodeIndex; attribute vec3
             const x = alongU ? u0 + mid : (u0 + u1) / 2;
             const z = alongU ? (v0 + v1) / 2 : v0 + mid;
             const y = part.y0 + (r + 0.5) * rowH;
-            const d = Math.hypot(x - opening.center[0], y - opening.center[1], z - opening.center[2]);
-            if (d < opening.radius) continue;
-            list2.push({ x, y, z, sx: alongU ? b - a : thick, sy: rowH, sz: alongU ? thick : b - a, colour: d < opening.radius + 0.25 || paint2 === null ? edge : paint2 });
+            const d = opening ? Math.hypot(x - opening.center[0], y - opening.center[1], z - opening.center[2]) : Infinity;
+            if (opening && d < opening.radius) continue;
+            const gone = (c) => Math.abs(c[1] - y) <= rowH / 2 && (alongU ? c[0] >= u0 + a && c[0] <= u0 + b : c[2] >= v0 + a && c[2] <= v0 + b);
+            if (chips2.some(gone)) continue;
+            const near = opening && d < opening.radius + 0.25 || chips2.some((c) => Math.hypot(c[0] - x, c[1] - y, c[2] - z) < 0.15);
+            list2.push({ x, y, z, sx: alongU ? b - a : thick, sy: rowH, sz: alongU ? thick : b - a, colour: near || paint2 === null ? edge : paint2 });
           }
         }
         return list2;
       }
-      function open(event) {
-        if (lod !== 0 || views.has(event.part) || !event.opening) return false;
-        const part = structure.byId.get(event.part);
-        const spec = opts.spec()?.parts?.find((q) => q.id === event.part);
+      function draw2(partId, change) {
+        if (lod !== 0) return false;
+        const part = structure.byId.get(partId);
+        const spec = opts.spec()?.parts?.find((q) => q.id === partId);
         if (!part || !spec || !spec.units) return false;
-        const items = structure.meshesOf(event.part).filter((it) => it.mesh);
-        if (!items.length) return false;
-        const list2 = courses(part, spec.units, event.opening, wallColour(items));
+        let view = views.get(partId);
+        if (!view) {
+          const items = structure.meshesOf(partId).filter((it) => it.mesh);
+          if (!items.length) return false;
+          view = { mesh: null, saved: null, items, paint: wallColour(items), units: 0, opening: null, chips: [] };
+        }
+        if (change.opening) {
+          if (view.opening) return false;
+          view.opening = { center: local2(change.opening.center), radius: change.opening.radius };
+        }
+        if (change.chip) view.chips.push(local2(change.chip));
+        const list2 = courses(part, spec.units, view.opening, view.chips, view.paint);
+        if (view.mesh) {
+          view.mesh.removeFromParent();
+          view.mesh.dispose();
+        }
         const mesh3 = new THREE.InstancedMesh(unitGeometry, unitMaterial, Math.max(1, list2.length));
-        mesh3.name = "breach:" + event.part;
+        mesh3.name = "breach:" + partId;
         list2.forEach((u, i) => {
           tmp.m.compose(tmp.p.set(u.x, u.y, u.z), tmp.q.identity(), tmp.s.set(u.sx, u.sy, u.sz));
           mesh3.setMatrixAt(i, tmp.m);
@@ -33673,8 +33860,10 @@ uniform mat4 uNodes[${nodes.length}]; attribute float aNodeIndex; attribute vec3
         mesh3.castShadow = true;
         mesh3.receiveShadow = true;
         house.add(mesh3);
-        const saved = items.map((it) => ({ it, v0: it.v0, data: collapseRange(it.mesh, it.v0, it.v1) }));
-        views.set(event.part, { mesh: mesh3, saved, units: list2.length, opening: event.opening });
+        if (!view.saved) view.saved = view.items.map((it) => ({ it, v0: it.v0, data: collapseRange(it.mesh, it.v0, it.v1) }));
+        view.mesh = mesh3;
+        view.units = list2.length;
+        views.set(partId, view);
         invalidate();
         invalidateShadow();
         return true;
@@ -33688,7 +33877,11 @@ uniform mat4 uNodes[${nodes.length}]; attribute float aNodeIndex; attribute vec3
       return {
         /** Handles a `stage` event of the house's object. Returns true when the wall was redrawn as courses. */
         stage(event) {
-          return event.stage === 2 ? open(event) : false;
+          return event.stage === 2 && !!event.opening ? draw2(event.part, { opening: event.opening }) : false;
+        },
+        /** Handles a `chip` event: the unit that came out leaves a gap in the courses. Returns true when the wall was redrawn. */
+        chip(event) {
+          return draw2(event.part, { chip: event.center });
         },
         /** The part broke or fell: the courses go (the plain range stays collapsed, the renderer hides the part). */
         drop(partId) {
@@ -33918,6 +34111,9 @@ uniform mat4 uNodes[${nodes.length}]; attribute float aNodeIndex; attribute vec3
           case "stage":
             breach.stage(e);
             break;
+          case "chip":
+            breach.chip(e);
+            break;
           case "collapse":
             for (const id of e.parts) {
               breach.drop(id);
@@ -33972,6 +34168,32 @@ uniform mat4 uNodes[${nodes.length}]; attribute float aNodeIndex; attribute vec3
         if (D.active && D.world.has(D.id)) D.world.remove(D.id);
         D.active = false;
       };
+      D.follow = (world, id, spec) => {
+        D.spec = spec;
+        const offFollow = world.on("*", (e) => {
+          if (e.object !== id) return;
+          switch (e.type) {
+            case "stage":
+              breach.stage(e);
+              break;
+            case "chip":
+              breach.chip(e);
+              break;
+            case "fracture":
+              breach.drop(e.part);
+              break;
+            case "collapse":
+              for (const p of e.parts) breach.drop(p);
+              break;
+            default:
+              break;
+          }
+        });
+        return { restore: () => breach.restore(), dispose: () => {
+          offFollow();
+          breach.restore();
+        } };
+      };
       D.piece = (id) => D.active ? D.world.part(D.id, id) : null;
       D.state = () => D.active ? D.world.state(D.id) : null;
       D.reset = () => {
@@ -34694,6 +34916,20 @@ uniform mat4 uNodes[${nodes.length}]; attribute float aNodeIndex; attribute vec3
     return buildApi(K, shared);
   }
   var WOOD_THIN = 0.035;
+  var SHELF_SPAN = 1.5;
+  var SHELVING = /shelf|bookcase|rack/;
+  function carcass(parts, drawn) {
+    const all = [...drawn.values()];
+    const width = Math.max(...all.map((p) => p.max[0])) - Math.min(...all.map((p) => p.min[0]));
+    for (const part of parts) {
+      if (LOOSE.has(part.material) || part.shape.kind !== "box" || part.rotation) continue;
+      const [x, y, z] = part.shape.size;
+      if (y >= x && y >= z) {
+        if (z < x && x >= 0.6 * width) continue;
+        part.structure = { role: "column" };
+      } else if (y <= x && y <= z) part.structure = { role: "beam", maxSpan: SHELF_SPAN * Math.max(x, z) };
+    }
+  }
   var FLOOR_TOUCH = 5e-3;
   var LOOSE = /* @__PURE__ */ new Set(["paper"]);
   var BASE_MATERIAL = {
@@ -34809,6 +35045,7 @@ uniform mat4 uNodes[${nodes.length}]; attribute float aNodeIndex; attribute vec3
       if (area3 < 0.6 * footprint || p.max[1] < 0.2) continue;
       if (!top || p.max[1] > top.y + 1e-6) top = { part: p.id, y: p.max[1] };
     }
+    if (opts.carcass) carcass(parts, byId);
     const spec = { name, parts, joints, tags: ["furniture"] };
     const colors = new Map(drawn.map((p) => [p.id, p.color]));
     const build = (T3) => {
@@ -34852,7 +35089,7 @@ uniform mat4 uNodes[${nodes.length}]; attribute float aNodeIndex; attribute vec3
     if (w === void 0 || d === void 0 || h === void 0) throw new Error(`game-floorplan-three: furniture type "${type}" is not in the catalogue, so give w, d and h`);
     const o = opts.options ?? {};
     const seed = Math.round(opts.seed ?? 1);
-    const plain2 = /shelf|bookcase|rack/.test(type) ? "paper" : "plastic";
+    const plain2 = SHELVING.test(type) ? "paper" : "plastic";
     const root = { x: seed, z: 0, ry: 0, w, d, h, y: 0, base: 0, palette: o.palette, seed: `furniture_${type}_${seed}` };
     const { K, shared } = renderer.internals;
     const before = K.PARTS.length;
@@ -34871,7 +35108,7 @@ uniform mat4 uNodes[${nodes.length}]; attribute float aNodeIndex; attribute vec3
           shared.ctx = saved.ctx;
         }
       },
-      { materials: { plain: plain2, ...o.materials }, chairs: o.chairs }
+      { materials: { plain: plain2, ...o.materials }, chairs: o.chairs, carcass: SHELVING.test(type) }
     );
     const spouts = K.PARTS.slice(before).filter((p) => p.type === "water_tap").map((p) => [p.pos[0] - root.x, p.pos[1], p.pos[2] - root.z]);
     K.PARTS.length = before;
@@ -37811,6 +38048,8 @@ uniform mat4 uNodes[${nodes.length}]; attribute float aNodeIndex; attribute vec3
     /** Closure of the fingers on a grip and on a forend (0 open, 1 closed). */
     closed: 0.9,
     forend: 0.6,
+    /** How far the shooting hand slides on its grip so the thumb reaches the safety lever. */
+    thumbReach: 0.02,
     /** How fast the supporting hand goes to the magazine and back, per second. */
     magRate: 7,
     /** The hands shrink with the tool: a tool drawn at scale `s` takes hands at `s ** handScaleExponent`. */
@@ -48497,9 +48736,14 @@ uniform mat4 uNodes[${nodes.length}]; attribute float aNodeIndex; attribute vec3
     );
     return [misfire, ...stopped];
   }
+  var SAFETY_MOTION = { cant: 0.22, lift: 0.012, in: 0.14, flickAt: 0.16, flick: 0.1, outAt: 0.32, out: 0.16, lever: 0.6 };
   function safetyClips(context) {
-    if (!context.parts.safety) return [];
-    return [composeClip("safety_on", [turn("safety", "z", 0, 0.12, 0, -0.6)]), composeClip("safety_off", [turn("safety", "z", 0, 0.12, -0.6, 0)]), composeClip("mode", [turn("safety", "z", 0, 0.07, 0, 0.4), turn("safety", "z", 0.07, 0.07, 0.4, 0)])];
+    const { cant, lift, in: rise, flickAt, flick, outAt, out, lever } = SAFETY_MOTION;
+    const carry = () => [turn(ROOT, "x", 0, rise, 0, cant), move(ROOT, "y", 0, rise, 0, lift), turn(ROOT, "x", outAt, out, cant, 0), move(ROOT, "y", outAt, out, lift, 0)];
+    const flickTo = (from, to) => context.parts.safety ? [turn("safety", "z", flickAt, flick, from, to)] : [];
+    const clips = [composeClip("safety_on", [...carry(), ...flickTo(0, -lever)]), composeClip("safety_off", [...carry(), ...flickTo(-lever, 0)])];
+    if (context.parts.safety) clips.push(composeClip("mode", [turn("safety", "z", 0, 0.07, 0, 0.4), turn("safety", "z", 0.07, 0.07, 0.4, 0)]));
+    return clips;
   }
   var drawClip = () => composeClip("draw", [move(ROOT, "y", 0, 0.35, -0.1, 0), turn(ROOT, "z", 0, 0.35, -0.6, 0)]);
 
@@ -58270,8 +58514,169 @@ void main(){vec2 d=gl_PointCoord-.5;float r=length(d)*2.;if(r>1.)discard;float a
         hand: "L",
         anchor: "cylinder_side",
         merge: 1
+      },
+      {
+        family: "pistol",
+        clips: [
+          "safety_on",
+          "safety_off"
+        ],
+        hand: "R",
+        anchor: "thumb_safety",
+        whole: true,
+        lead: 0.3,
+        tail: 0.3
+      },
+      {
+        family: "revolver",
+        clips: [
+          "safety_on",
+          "safety_off"
+        ],
+        hand: "R",
+        anchor: "thumb_safety",
+        whole: true,
+        lead: 0.3,
+        tail: 0.3
+      },
+      {
+        family: "rifle",
+        clips: [
+          "safety_on",
+          "safety_off"
+        ],
+        hand: "R",
+        anchor: "thumb_safety",
+        whole: true,
+        lead: 0.3,
+        tail: 0.3,
+        style: "ar"
+      },
+      {
+        family: "p90",
+        clips: [
+          "safety_on",
+          "safety_off"
+        ],
+        hand: "R",
+        anchor: "thumb_safety",
+        whole: true,
+        lead: 0.3,
+        tail: 0.3
+      },
+      {
+        family: "pump",
+        clips: [
+          "safety_on",
+          "safety_off"
+        ],
+        hand: "R",
+        anchor: "thumb_safety",
+        whole: true,
+        lead: 0.3,
+        tail: 0.3
+      },
+      {
+        family: "semi12",
+        clips: [
+          "safety_on",
+          "safety_off"
+        ],
+        hand: "R",
+        anchor: "thumb_safety",
+        whole: true,
+        lead: 0.3,
+        tail: 0.3
+      },
+      {
+        family: "semiint",
+        clips: [
+          "safety_on",
+          "safety_off"
+        ],
+        hand: "R",
+        anchor: "thumb_safety",
+        whole: true,
+        lead: 0.3,
+        tail: 0.3
+      },
+      {
+        family: "break",
+        clips: [
+          "safety_on",
+          "safety_off"
+        ],
+        hand: "R",
+        anchor: "thumb_safety",
+        whole: true,
+        lead: 0.3,
+        tail: 0.3
+      },
+      {
+        family: "bolt",
+        clips: [
+          "safety_on",
+          "safety_off"
+        ],
+        hand: "R",
+        anchor: "thumb_safety",
+        whole: true,
+        lead: 0.3,
+        tail: 0.3
+      },
+      {
+        family: "boltmag",
+        clips: [
+          "safety_on",
+          "safety_off"
+        ],
+        hand: "R",
+        anchor: "thumb_safety",
+        whole: true,
+        lead: 0.3,
+        tail: 0.3
+      },
+      {
+        family: "lever",
+        clips: [
+          "safety_on",
+          "safety_off"
+        ],
+        hand: "R",
+        anchor: "thumb_safety",
+        whole: true,
+        lead: 0.3,
+        tail: 0.3
+      },
+      {
+        family: "belt",
+        clips: [
+          "safety_on",
+          "safety_off"
+        ],
+        hand: "R",
+        anchor: "thumb_safety",
+        whole: true,
+        lead: 0.3,
+        tail: 0.3
+      },
+      {
+        family: "rifle",
+        clips: [
+          "safety_on",
+          "safety_off"
+        ],
+        hand: "L",
+        anchor: "lever_right",
+        style: "ak",
+        whole: true,
+        lead: 0.3,
+        tail: 0.3
       }
-    ]
+    ],
+    safety: {
+      comment: "Safety on and off (B): the shooting hand slides up its grip so the thumb flicks the lever while the clip cants the weapon; an AK-style rifle (akCharge) has its big lever on the right, pushed by the support hand over the top."
+    }
   };
 
   // src/fx/hand-work.ts
@@ -58299,6 +58704,18 @@ void main(){vec2 d=gl_PointCoord-.5;float r=length(d)*2.;if(r>1.)discard;float a
         if (!right || !parts.slide) return null;
         return { part: right.part, offset: right.offset.clone().add(V2(THREE, 0, 0.012, 0)), quaternion: right.quaternion };
       }
+      if (kind === "thumb_safety") {
+        if (!right) return null;
+        const toward2 = parts.safety ? right.part.worldToLocal(parts.safety.getWorldPosition(V2(THREE, 0, 0, 0))).sub(right.offset) : V2(THREE, 0, HAND_HOLD.thumbReach, 0);
+        return { part: right.part, offset: right.offset.clone().add(toward2.clampLength(0, HAND_HOLD.thumbReach)), quaternion: right.quaternion };
+      }
+      if (kind === "lever_right") {
+        const receiver = parts.bolt ?? parts.boltHandle;
+        if (!receiver) return null;
+        const b2 = boxIn(THREE, root, receiver);
+        const x = parts.trigger ? root.worldToLocal(parts.trigger.getWorldPosition(V2(THREE, 0, 0, 0))).x : b2.min.x;
+        return anchorAt(receiver, V2(THREE, x, b2.getCenter(V2(THREE, 0, 0, 0)).y, b2.max.z + palm), handFrame(THREE, V2(THREE, 1, 0, 0), V2(THREE, 0, 0, 1)));
+      }
       if (!part) return null;
       const b = boxIn(THREE, root, part);
       const c = b.getCenter(V2(THREE, 0, 0, 0));