@adatechnology/game-vehicles-three 0.3.6 → 0.4.0

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { Damageable, VehicleContext, VehicleKit } from '@adatechnology/game-vehicles';
+import { Damageable, VehicleContext, VehicleKit, CabinSource } from '@adatechnology/game-vehicles';
 import { FleetDims } from '@adatechnology/game-vehicles-fleet';
 import { EffectSink, Vec3, TestableModule } from '@adatechnology/game-contracts';
 
@@ -53,6 +53,27 @@ interface VehiclesThreeOptions {
  */
 declare function createVehiclesThree(THREE: any, options: VehiclesThreeOptions): VehiclesThree;
 
+/**
+ * Keeps the host's effects told where the cabins of the vehicles are and how open they are (`EffectSink.enclose`), so the smoke, dust and steam
+ * do not pass through a shut car: they go round it and get in only through an open door, a broken window or a bullet hole. `sync` every frame;
+ * a vehicle whose object left the scene is forgotten and its cabin ended.
+ */
+interface CabinSmoke {
+    /** Follows the cabin of a vehicle by its object id; `frame` is the object the host placed it in (the destructible's `frame`). */
+    track(id: string, source: CabinSource, frame: {
+        readonly parent: unknown | null;
+    }): void;
+    /** Ends the cabin of one vehicle now. */
+    untrack(id: string, effects: EffectSink | undefined): void;
+    /** Tells `effects` where every cabin is now. A host without `enclose` lets the smoke through, as before. */
+    sync(effects: EffectSink | undefined): void;
+    /** Ends every cabin (the module leaves). */
+    clear(effects: EffectSink | undefined): void;
+    /** The ids followed now. */
+    ids(): string[];
+}
+declare function createCabinSmoke(): CabinSmoke;
+
 /**
  * The light mode of the team's Frota Leve (frota-leve.js 14202-14310): a built vehicle fused into six meshes, one per class of material,
  * with the meshes nobody sees from outside left out. A literal port: the classes, the thresholds (3 cm prune, 0.99 opacity, 0.5 metalness,
@@ -223,4 +244,4 @@ declare const VEHICLE_SCENARIO_IDS: readonly string[];
 declare const PAGE_SCENARIO_ALIASES: Readonly<Record<string, string>>;
 declare const PAGE_ITEM_ALIASES: Readonly<Record<string, string>>;
 
-export { type BuildVehicleOptions, type BuiltVehicle, DEFAULT_TEST_VEHICLES, DEFAULT_TEST_WRECKS, type DocumentLike, type EffectsLike, LITE_CLASSES, type LiteClass, type LiteFusion, type ModuleRoomLike, PAGE_ITEM_ALIASES, PAGE_SCENARIO_ALIASES, PRUNE_BELOW, VEHICLES_AREA_ID, VEHICLE_SCENARIO_IDS, type VehicleEffectIds, type VehicleQuality, type VehicleSoundIds, type VehicleWreck, type VehiclesContext, type VehiclesRoom, type VehiclesTestOptions, type VehiclesThree, type VehiclesThreeOptions, classColor, classify, createVehiclesTestModule, createVehiclesThree, defaultEffectIds, defaultSoundIds, fuse, liteMaterials, liteMeshes, loadVehiclesTestModule };
+export { type BuildVehicleOptions, type BuiltVehicle, type CabinSmoke, DEFAULT_TEST_VEHICLES, DEFAULT_TEST_WRECKS, type DocumentLike, type EffectsLike, LITE_CLASSES, type LiteClass, type LiteFusion, type ModuleRoomLike, PAGE_ITEM_ALIASES, PAGE_SCENARIO_ALIASES, PRUNE_BELOW, VEHICLES_AREA_ID, VEHICLE_SCENARIO_IDS, type VehicleEffectIds, type VehicleQuality, type VehicleSoundIds, type VehicleWreck, type VehiclesContext, type VehiclesRoom, type VehiclesTestOptions, type VehiclesThree, type VehiclesThreeOptions, classColor, classify, createCabinSmoke, createVehiclesTestModule, createVehiclesThree, defaultEffectIds, defaultSoundIds, fuse, liteMaterials, liteMeshes, loadVehiclesTestModule };

package/dist/index.global.js

@@ -31,6 +31,7 @@ var GameVehiclesThree = (() => {
     VEHICLE_SCENARIO_IDS: () => VEHICLE_SCENARIO_IDS,
     classColor: () => classColor,
     classify: () => classify,
+    createCabinSmoke: () => createCabinSmoke,
     createVehiclesTestModule: () => createVehiclesTestModule,
     createVehiclesThree: () => createVehiclesThree,
     defaultEffectIds: () => defaultEffectIds,
@@ -3745,11 +3746,11 @@ var GameVehiclesThree = (() => {
   function installBoatsExtra(fx) {
     const kit = fx.kit;
     const THREE = kit.THREE;
-    const shared = fx.shared;
+    const shared2 = fx.shared;
     const trl = fx.t;
     const lbl = fx.label;
-    if (!kit || !shared.EA) return;
-    const V3 = kit.V3, PI = Math.PI, MT = kit.materials, CM = kit.makeMaterial, _G = kit.geo, DS = THREE.DoubleSide, EA = shared.EA, tb = EA.tab;
+    if (!kit || !shared2.EA) return;
+    const V3 = kit.V3, PI = Math.PI, MT = kit.materials, CM = kit.makeMaterial, _G = kit.geo, DS = THREE.DoubleSide, EA = shared2.EA, tb = EA.tab;
     function sailGeo(T, Hd, C, cam, o) {
       o = o || {};
       const nu = o.nu || 10, nv = o.nv || 16, pos = [], idx = [], roach = o.roach || 0;
@@ -9617,11 +9618,11 @@ var GameVehiclesThree = (() => {
   function installHelicoptersExtra(fx) {
     const kit = fx.kit;
     const THREE = kit.THREE;
-    const shared = fx.shared;
+    const shared2 = fx.shared;
     const trl = fx.t;
     const lbl = fx.label;
     const V3 = kit.V3, PI = Math.PI, MT = kit.materials, CM = kit.makeMaterial, G2 = kit.geo;
-    const GH = shared.GH;
+    const GH = shared2.GH;
     function skids(c, o) {
       const mat = o.mat || MT.steel, z = o.z, y = o.y || 0.07, out = [];
       [1, -1].forEach(function(s) {
@@ -9768,7 +9769,7 @@ var GameVehiclesThree = (() => {
         hood: false
       },
       function(c) {
-        const EA = shared.EA, col = "#1f4f8a", blue = c.paint(col), white = c.paint("#e9e7e0"), blk = CM("#1c1d1f", { roughness: 0.6 });
+        const EA = shared2.EA, col = "#1f4f8a", blue = c.paint(col), white = c.paint("#e9e7e0"), blk = CM("#1c1d1f", { roughness: 0.6 });
         const ST = [
           [1.6, 0.84, 0.92, 0.06, 2],
           [1.5, 0.64, 1.22, 0.66, 2.2],
@@ -10103,7 +10104,7 @@ var GameVehiclesThree = (() => {
         hood: false
       },
       function(c) {
-        const EA = shared.EA, wcol = "#eeece6", white = c.paint(wcol), mar = c.paint("#7a1e22"), gold = c.paint("#c49a3a"), blk = CM("#1c1d1f", { roughness: 0.6 });
+        const EA = shared2.EA, wcol = "#eeece6", white = c.paint(wcol), mar = c.paint("#7a1e22"), gold = c.paint("#c49a3a"), blk = CM("#1c1d1f", { roughness: 0.6 });
         const ST = [
           [2.62, 0.95, 1.06, 0.08, 2],
           [2.48, 0.7, 1.45, 0.86, 2.2],
@@ -10488,7 +10489,7 @@ var GameVehiclesThree = (() => {
         hood: false
       },
       function(c) {
-        const EA = shared.EA, navyC = "#1b2c52", navy = c.paint(navyC), white = c.paint("#ecebe6"), yel = c.paint("#d7b23a"), blk = CM("#1c1d1f", { roughness: 0.6 });
+        const EA = shared2.EA, navyC = "#1b2c52", navy = c.paint(navyC), white = c.paint("#ecebe6"), yel = c.paint("#d7b23a"), blk = CM("#1c1d1f", { roughness: 0.6 });
         const ST = [
           [3.36, 1, 1.12, 0.08, 2],
           [3.22, 0.76, 1.56, 0.96, 2.4],
@@ -10932,7 +10933,7 @@ var GameVehiclesThree = (() => {
         hood: false
       },
       function(c) {
-        const EA = shared.EA, blk = CM("#1a1b1d", { roughness: 0.6 });
+        const EA = shared2.EA, blk = CM("#1a1b1d", { roughness: 0.6 });
         c.meta.matte = true;
         const cA = new THREE.Color("#3a4430"), cB = new THREE.Color("#66603f"), cC = new THREE.Color("#55613f"), cL = new THREE.Color("#8d958c");
         function camo(x, y, z, under) {
@@ -19988,7 +19989,7 @@ var GameVehiclesThree = (() => {
   function installPlanesExtra(fx) {
     const kit = fx.kit;
     const THREE = kit.THREE;
-    const shared = fx.shared;
+    const shared2 = fx.shared;
     const trl = fx.t;
     const lbl = fx.label;
     const V3 = kit.V3, PI = Math.PI, MT = kit.materials, CM = kit.makeMaterial, _G = kit.geo, _DS = THREE.DoubleSide;
@@ -20140,7 +20141,7 @@ var GameVehiclesThree = (() => {
       m.rotation.y += -s * Math.atan2(a - b, w);
       return m;
     }
-    shared.GH = {
+    shared2.GH = {
       pose3,
       starDecal,
       rrect,
@@ -20174,7 +20175,7 @@ var GameVehiclesThree = (() => {
         hood: false
       },
       function(c) {
-        const EA = shared.EA, yel = "#f0bd22";
+        const EA = shared2.EA, yel = "#f0bd22";
         const Q = pose3([1.62, -0.78], 0.25, [-3.24, -0.27], 0.075), P = Q.P, TH = Q.TH;
         const grp = new THREE.Group();
         grp.position.set(0, Q.Y0, 0);
@@ -20486,7 +20487,7 @@ var GameVehiclesThree = (() => {
           });
           const pd = pod(
             c2,
-            shared.EA,
+            shared2.EA,
             P(1.4, -0.6).x,
             P(-1.2, -0.45).x,
             P(0.1, -0.66).y,
@@ -20523,7 +20524,7 @@ var GameVehiclesThree = (() => {
         hood: false
       },
       function(c) {
-        const EA = shared.EA, wcol = "#ecebe6", white = c.paint(wcol), blue = c.paint("#1d4f8c"), grey = c.paint("#8e959a"), blk = CM("#1c1d1f", { roughness: 0.6 });
+        const EA = shared2.EA, wcol = "#ecebe6", white = c.paint(wcol), blue = c.paint("#1d4f8c"), grey = c.paint("#8e959a"), blk = CM("#1c1d1f", { roughness: 0.6 });
         const ST = [
           [7.58, 1.5, 1.62, 0.08, 2],
           [7.35, 1.3, 1.82, 0.56, 2.2],
@@ -20911,7 +20912,7 @@ var GameVehiclesThree = (() => {
         hood: false
       },
       function(c) {
-        const EA = shared.EA, wcol = "#eceae3", white = c.paint(wcol), navy = c.paint("#1e2f55"), gold = c.paint("#c99a2e"), blk = CM("#1c1d1f", { roughness: 0.6 });
+        const EA = shared2.EA, wcol = "#eceae3", white = c.paint(wcol), navy = c.paint("#1e2f55"), gold = c.paint("#c99a2e"), blk = CM("#1c1d1f", { roughness: 0.6 });
         const ST = [
           [5, 2.26, 2.86, 0.62, 2.2],
           [4.75, 2.08, 3, 0.98, 2.6],
@@ -21326,7 +21327,7 @@ var GameVehiclesThree = (() => {
         hood: false
       },
       function(c) {
-        const EA = shared.EA, wcol = "#efeeea", white = c.paint(wcol), silver = c.paint("#7d868e", { metalness: 0.45, roughness: 0.35 }), navy = c.paint("#23324f"), blk = CM("#15161a", { roughness: 0.5 });
+        const EA = shared2.EA, wcol = "#efeeea", white = c.paint(wcol), silver = c.paint("#7d868e", { metalness: 0.45, roughness: 0.35 }), navy = c.paint("#23324f"), blk = CM("#15161a", { roughness: 0.5 });
         const ST = [
           [6.3, 1.13, 1.2, 0.06, 2],
           [6, 0.92, 1.44, 0.6, 2.1],
@@ -21707,7 +21708,7 @@ var GameVehiclesThree = (() => {
         hood: false
       },
       function(c) {
-        const EA = shared.EA, blk = CM("#1a1b1d", { roughness: 0.6 });
+        const EA = shared2.EA, blk = CM("#1a1b1d", { roughness: 0.6 });
         c.meta.matte = true;
         const cA = new THREE.Color("#323f2b"), cB = new THREE.Color("#5f6d45"), cC = new THREE.Color("#7f8466"), cL = new THREE.Color("#a3abad");
         function camo(x, z, y, under) {
@@ -24365,7 +24366,7 @@ var GameVehiclesThree = (() => {
   function installWaterAir(fx) {
     const kit = fx.kit;
     const THREE = kit.THREE;
-    const shared = fx.shared;
+    const shared2 = fx.shared;
     const trl = fx.t;
     const lbl = fx.label;
     const V3 = kit.V3, PI = Math.PI, MT = kit.materials, CM = kit.makeMaterial, _paintCol = kit.paintColor, G2 = kit.geo, DS = THREE.DoubleSide, clamp3 = kit.clamp;
@@ -25040,7 +25041,7 @@ var GameVehiclesThree = (() => {
       t.rotation.y += s > 0 ? -Math.atan(m) : Math.atan(m);
       return t;
     }
-    shared.EA = {
+    shared2.EA = {
       colorize,
       tab,
       tabL,
@@ -25099,7 +25100,7 @@ var GameVehiclesThree = (() => {
         hood: false
       },
       function(c) {
-        const EA = shared.EA, tb = EA.tab, alu = CM("#9aa1a6", { metalness: 0.65, roughness: 0.38, side: DS }), aluD = CM("#7d8489", { metalness: 0.6, roughness: 0.45, side: DS });
+        const EA = shared2.EA, tb = EA.tab, alu = CM("#9aa1a6", { metalness: 0.65, roughness: 0.38, side: DS }), aluD = CM("#7d8489", { metalness: 0.6, roughness: 0.45, side: DS });
         const L = 5, x0 = -2.5;
         const H = EA.boatHull({
           x0,
@@ -25251,7 +25252,7 @@ var GameVehiclesThree = (() => {
         hood: false
       },
       function(c) {
-        const EA = shared.EA, tb = EA.tab, L = 7.26, x0 = -3.63;
+        const EA = shared2.EA, tb = EA.tab, L = 7.26, x0 = -3.63;
         const white = c.paint("#ecebe5", { roughness: 0.3, metalness: 0.1 }), navy = c.paint("#1f2f4a", { roughness: 0.3, metalness: 0.1 }), vinyl = CM("#e3ddd0", { roughness: 0.65 }), _vinylD = CM("#3c4a5c", { roughness: 0.65 }), teak = CM("#8a6a45", { roughness: 0.8 });
         const H = EA.boatHull({
           x0,
@@ -25498,7 +25499,7 @@ var GameVehiclesThree = (() => {
         hood: false
       },
       function(c) {
-        const EA = shared.EA, tb = EA.tab, L = 11, x0 = -5.5;
+        const EA = shared2.EA, tb = EA.tab, L = 11, x0 = -5.5;
         const blue = c.paint("#2f5e86", { roughness: 0.7, metalness: 0.05 }), wht = c.paint("#e6e3da", { roughness: 0.7, metalness: 0.05 }), redP = c.paint("#7a2219", { roughness: 0.8, metalness: 0.05 }), wood = CM("#6b4a2e", { roughness: 0.85 }), deckW = CM("#8a6e4c", { roughness: 0.9, side: DS });
         const H = EA.boatHull({
           x0,
@@ -25802,7 +25803,7 @@ var GameVehiclesThree = (() => {
         hood: false
       },
       function(c) {
-        const EA = shared.EA, white = "#ecebe6";
+        const EA = shared2.EA, white = "#ecebe6";
         const paintW = c.paint(white);
         const ST = [
           [2.3, 0.98, 1.46, 0.7, 2.4],
@@ -26131,7 +26132,7 @@ var GameVehiclesThree = (() => {
         hood: false
       },
       function(c) {
-        const EA = shared.EA, TH = 0.19, X0 = 0.3, Y0 = 1, cs = Math.cos(TH), sn = Math.sin(TH);
+        const EA = shared2.EA, TH = 0.19, X0 = 0.3, Y0 = 1, cs = Math.cos(TH), sn = Math.sin(TH);
         function P(x, y, z) {
           return new V3(x * cs - y * sn + X0, x * sn + y * cs + Y0, z || 0);
         }
@@ -26488,7 +26489,7 @@ var GameVehiclesThree = (() => {
         hood: false
       },
       function(c) {
-        const EA = shared.EA, red = c.paint("#a9241e"), white = c.paint("#e9e7e0"), blk = CM("#1c1d1f", { roughness: 0.6 });
+        const EA = shared2.EA, red = c.paint("#a9241e"), white = c.paint("#e9e7e0"), blk = CM("#1c1d1f", { roughness: 0.6 });
         const ST = [
           [1.96, 0.96, 1.06, 0.06, 2],
           [1.85, 0.76, 1.4, 0.76, 2.2],
@@ -26814,7 +26815,7 @@ var GameVehiclesThree = (() => {
         hood: false
       },
       function(c) {
-        const EA = shared.EA, org = c.paint("#d0531e"), white = c.paint("#e8e6df"), blk = CM("#1c1d1f", { roughness: 0.6 });
+        const EA = shared2.EA, org = c.paint("#d0531e"), white = c.paint("#e8e6df"), blk = CM("#1c1d1f", { roughness: 0.6 });
         const ST = [
           [3.34, 1, 1.12, 0.1, 2],
           [3.2, 0.82, 1.48, 0.95, 2.2],
@@ -27176,11 +27177,11 @@ var GameVehiclesThree = (() => {
     const groups = new Set(options.groups || fleetGroupIds);
     const only = options.vehicles ? new Set(options.vehicles) : null;
     const skip = new Set(options.exclude || []);
-    const shared = {};
+    const shared2 = {};
     const t = (key, vars) => kit.t("fleet." + key, vars);
     return {
       kit,
-      shared,
+      shared: shared2,
       t,
       label: (key) => ({ key, label: t("labels." + key) }),
       register(spec, build) {
@@ -29507,6 +29508,90 @@ var GameVehiclesThree = (() => {
     shims.add(result);
     return result;
   }
+  var isTexture = (v) => !!v && typeof v === "object" && v.isTexture === true;
+  function texturesOf(material, out) {
+    for (const value of Object.values(material)) if (isTexture(value)) out.add(value);
+    const uniforms = material.uniforms;
+    if (uniforms) {
+      for (const u of Object.values(uniforms)) if (isTexture(u?.value)) out.add(u.value);
+    }
+  }
+  function collect(roots) {
+    const geometries = /* @__PURE__ */ new Set();
+    const materials = /* @__PURE__ */ new Set();
+    const textures = /* @__PURE__ */ new Set();
+    const skeletons = /* @__PURE__ */ new Set();
+    for (const root of roots) {
+      root.traverse((object2) => {
+        const o = object2;
+        if (o.geometry && typeof o.geometry.dispose === "function") geometries.add(o.geometry);
+        if (o.skeleton && typeof o.skeleton.dispose === "function") skeletons.add(o.skeleton);
+        const list2 = Array.isArray(o.material) ? o.material : o.material ? [o.material] : [];
+        for (const m of list2) {
+          if (!m || typeof m.dispose !== "function") continue;
+          materials.add(m);
+          texturesOf(m, textures);
+        }
+      });
+    }
+    return { geometries, materials, textures, skeletons };
+  }
+  var marked = /* @__PURE__ */ new WeakSet();
+  var shared = (r) => r.userData?.shared === true || marked.has(r);
+  function releaseObject3D(roots, options = {}) {
+    const list2 = Array.isArray(roots) ? roots : [roots];
+    const report = { geometries: 0, materials: 0, textures: 0 };
+    if (list2.length === 0) return report;
+    const found = collect(list2);
+    const keepRoots = options.keep === void 0 ? [] : Array.isArray(options.keep) ? options.keep : [options.keep];
+    const releasing = new Set(list2);
+    for (const keep of keepRoots) {
+      const walk = (o) => {
+        if (releasing.has(o)) return;
+        const owner = o;
+        if (owner.geometry) found.geometries.delete(owner.geometry);
+        if (owner.skeleton) found.skeletons.delete(owner.skeleton);
+        const mats = Array.isArray(owner.material) ? owner.material : owner.material ? [owner.material] : [];
+        for (const m of mats) {
+          if (!m) continue;
+          found.materials.delete(m);
+          const t = /* @__PURE__ */ new Set();
+          texturesOf(m, t);
+          for (const x of t) found.textures.delete(x);
+        }
+        for (const c of o.children) walk(c);
+      };
+      walk(keep);
+    }
+    for (const g of found.geometries) {
+      if (shared(g)) continue;
+      g.dispose();
+      report.geometries++;
+    }
+    for (const m of found.materials) {
+      if (shared(m)) continue;
+      m.dispose();
+      report.materials++;
+    }
+    for (const t of found.textures) {
+      if (shared(t)) continue;
+      t.dispose();
+      report.textures++;
+    }
+    for (const s of found.skeletons) s.dispose();
+    return report;
+  }
+  function discardObject3D(objects, options = {}) {
+    const list2 = Array.isArray(objects) ? objects : [objects];
+    const keep = options.keep === void 0 ? [] : Array.isArray(options.keep) ? [...options.keep] : [options.keep];
+    for (const object2 of list2) {
+      let top = object2;
+      while (top.parent) top = top.parent;
+      object2.removeFromParent();
+      if (top !== object2 && !keep.includes(top)) keep.push(top);
+    }
+    return releaseObject3D(list2, { keep });
+  }
 
   // ../game-vehicles/dist/index.js
   var __defProp2 = Object.defineProperty;
@@ -34509,8 +34594,15 @@ var GameVehiclesThree = (() => {
       x.arc(cx, cy, 26 * s, 0, PI * 2);
       x.fill();
     }
+    const NO_CANVAS = new Proxy(function() {
+    }, { get: () => NO_CANVAS, apply: () => NO_CANVAS, set: () => true });
     function crackGlass(c, msh, p, force, sc) {
       const G2 = msh.userData.glass;
+      if (G2.cracksFreed) {
+        drawWeb(NO_CANVAS, 0, 0, sc != null ? sc : 0.6 + force * 0.5, Math.max(0.4, G2.aspect || 1), c.rand);
+        G2.hits++;
+        return;
+      }
       if (!G2.cv) {
         G2.cv = document2.createElement("canvas");
         G2.cv.width = G2.cv.height = 256;
@@ -34593,6 +34685,14 @@ var GameVehiclesThree = (() => {
       const G2 = msh.userData.glass;
       if (G2.broken) return;
       G2.broken = true;
+      const freeCracks = function() {
+        if (!G2.tex) return;
+        if (msh.material !== MATERIALS.glassEdge && msh.material?.map === G2.tex) msh.material.dispose();
+        G2.tex.dispose();
+        G2.tex = null;
+        G2.cv = null;
+        G2.cracksFreed = true;
+      };
       const cubesAt = [];
       if (G2.outline && G2.T !== void 0) {
         const out = G2.outline;
@@ -34626,6 +34726,7 @@ var GameVehiclesThree = (() => {
         geo.computeVertexNormals();
         msh.geometry.dispose();
         msh.geometry = geo;
+        freeCracks();
         msh.material = MATERIALS.glassEdge;
         let minx = 1e9;
         let maxx = -1e9;
@@ -34649,8 +34750,12 @@ var GameVehiclesThree = (() => {
         if (rim) {
           msh.geometry.dispose();
           msh.geometry = rim;
+          freeCracks();
           msh.material = MATERIALS.glassEdge;
-        } else msh.visible = false;
+        } else {
+          freeCracks();
+          msh.visible = false;
+        }
         for (let j = 0; j < 36; j++)
           cubesAt.push(
             new V3(
@@ -40153,13 +40258,13 @@ var GameVehiclesThree = (() => {
       return c;
     }
     kit.dispose = function(c) {
-      const shared = Object.values(I.PARTICLE_GEOMETRIES);
+      const shared2 = Object.values(I.PARTICLE_GEOMETRIES);
       c.root.traverse(function(o) {
         if (o.isSprite) {
           if (o.material && o.material.userData.dis) o.material.dispose();
           return;
         }
-        if (o.geometry && !shared.includes(o.geometry)) o.geometry.dispose();
+        if (o.geometry && !shared2.includes(o.geometry)) o.geometry.dispose();
       });
     };
     kit.registerLegacySeeds = registerLegacySeeds;
@@ -42090,8 +42195,8 @@ var GameVehiclesThree = (() => {
     const buildState = () => {
       const parts = model.parts.map((d) => {
         const p = ps.get(d.id);
-        const marked = p.dents.length > 0 || p.holes.length > 0 || p.cracks.length > 0;
-        const status = p.lost ? p.status : p.hp < p.def.hp || marked ? "damaged" : "intact";
+        const marked2 = p.dents.length > 0 || p.holes.length > 0 || p.cracks.length > 0;
+        const status = p.lost ? p.status : p.hp < p.def.hp || marked2 ? "damaged" : "intact";
         return {
           id: d.id,
           material: d.material,
@@ -42291,6 +42396,123 @@ var GameVehiclesThree = (() => {
     root.userData.vehicle = vehicle;
     return { root, vehicle };
   }
+  var CABIN_LEAK = 0.02;
+  var HOLE_RATE_PER_AREA = 3e3;
+  var CRACK_GAP_PER_METRE = 0.5;
+  var THROUGH = 0.18;
+  var HOLE_PATCH = 0.12;
+  var FULL_SWING = 1.15;
+  var SHELL_ROLES = /* @__PURE__ */ new Set(["door", "glass", "roof", "lid", "panel", "pillar"]);
+  var GONE = /* @__PURE__ */ new Set(["broken", "melted", "ashes"]);
+  function cabinBoxOf(vehicle) {
+    const cabin = vehicle.meta.cabin;
+    if (!cabin || !(cabin.x1 > cabin.x0) || !(cabin.y1 > cabin.y0) || !(cabin.z > 0)) return null;
+    return cabin;
+  }
+  function swingOf(vehicle, partId) {
+    const pivot = vehicle.vehicle?.getObjectByName?.(partId);
+    const q = pivot?.quaternion;
+    if (!q) return 0;
+    const angle = 2 * Math.acos(Math.min(1, Math.abs(q.w)));
+    return Math.min(1, angle / FULL_SWING);
+  }
+  var overlaps = (b, c, margin) => Math.abs(b.center[0] - (c.x0 + c.x1) / 2) <= b.size[0] / 2 + (c.x1 - c.x0) / 2 + margin && Math.abs(b.center[1] - (c.y0 + c.y1) / 2) <= b.size[1] / 2 + (c.y1 - c.y0) / 2 + margin && Math.abs(b.center[2]) <= b.size[2] / 2 + c.z + margin;
+  function cabinEnclosure(source, options = {}) {
+    const c = source.vehicle;
+    const cabin = cabinBoxOf(c);
+    const node = c.vehicle;
+    if (!cabin || !node?.localToWorld) return null;
+    const state = source.state();
+    if (state.destroyed) return null;
+    const V3 = node.position.constructor;
+    const Quat = node.quaternion.constructor;
+    const mid = [(cabin.x0 + cabin.x1) / 2, (cabin.y0 + cabin.y1) / 2, 0];
+    const half = [(cabin.x1 - cabin.x0) / 2, (cabin.y1 - cabin.y0) / 2, cabin.z];
+    const ajar = options.ajar ?? 0.06;
+    const byId = new Map(state.parts.map((p) => [p.id, p]));
+    const mainGroup = state.groups[0] ? new Set(state.groups[0]) : null;
+    const openings = [];
+    let crackLength = 0;
+    const toCabin = (b) => ({
+      center: [b.center[0] - mid[0], b.center[1] - mid[1], b.center[2] - mid[2]],
+      halfSize: [b.size[0] / 2 + THROUGH, b.size[1] / 2 + THROUGH, b.size[2] / 2 + THROUGH]
+    });
+    node.updateWorldMatrix?.(true, false);
+    const frame = options.frame ?? c.root;
+    frame?.updateWorldMatrix?.(true, false);
+    const inverse = node.matrixWorld.clone().invert();
+    for (const def of source.model.parts) {
+      if (!SHELL_ROLES.has(def.role) || !overlaps(def.box, cabin, 0.12)) continue;
+      const part = byId.get(def.id);
+      if (!part) continue;
+      const gone = GONE.has(part.status) || mainGroup !== null && !mainGroup.has(def.id);
+      const swung = (def.role === "door" || def.role === "lid") && swingOf(c, def.id) > ajar;
+      if (gone || swung) {
+        openings.push(toCabin(def.box));
+        continue;
+      }
+      for (const hole of part.holes) {
+        if (!hole.through && def.material !== "glass") continue;
+        const area3 = Math.PI * (hole.diameter / 2) ** 2;
+        const p = new V3(hole.point[0], hole.point[1], hole.point[2]);
+        if (frame?.localToWorld) frame.localToWorld(p);
+        p.applyMatrix4(inverse);
+        openings.push({
+          center: [p.x - mid[0], p.y - mid[1], p.z - mid[2]],
+          halfSize: [HOLE_PATCH, HOLE_PATCH, HOLE_PATCH],
+          // the patch is far bigger than the hole: only a share of what crosses it passes, more for a bigger hole
+          rate: Math.min(4, area3 * HOLE_RATE_PER_AREA)
+        });
+      }
+      for (const crack of part.cracks) crackLength += crack.length;
+    }
+    const center = node.localToWorld(new V3(mid[0], mid[1], mid[2]));
+    const q = node.getWorldQuaternion(new Quat());
+    const scale = node.getWorldScale(new V3());
+    const leak = (options.leak ?? CABIN_LEAK) * (1 + crackLength * CRACK_GAP_PER_METRE);
+    return {
+      center: [center.x, center.y, center.z],
+      halfSize: [half[0] * Math.abs(scale.x), half[1] * Math.abs(scale.y), half[2] * Math.abs(scale.z)],
+      orientation: [q.x, q.y, q.z, q.w],
+      openings: openings.map((o) => ({ ...o, center: [o.center[0] * scale.x, o.center[1] * scale.y, o.center[2] * scale.z], halfSize: [o.halfSize[0] * Math.abs(scale.x), o.halfSize[1] * Math.abs(scale.y), o.halfSize[2] * Math.abs(scale.z)] })),
+      leak
+    };
+  }
+
+  // src/cabin-smoke.ts
+  function createCabinSmoke() {
+    const tracked = /* @__PURE__ */ new Map();
+    const end = (id, entry, effects) => {
+      if (entry.declared) effects?.enclose?.(id, null);
+      tracked.delete(id);
+    };
+    return {
+      track(id, source, frame) {
+        tracked.set(id, { source, frame, declared: false, placed: false });
+      },
+      untrack(id, effects) {
+        const entry = tracked.get(id);
+        if (entry) end(id, entry, effects);
+      },
+      sync(effects) {
+        if (!effects?.enclose) return;
+        for (const [id, entry] of tracked) {
+          if (!entry.frame.parent) {
+            if (entry.placed) end(id, entry, effects);
+            continue;
+          }
+          entry.placed = true;
+          const enclosure = cabinEnclosure(entry.source, { frame: entry.frame });
+          if (enclosure || entry.declared) effects.enclose(id, enclosure);
+          entry.declared = enclosure !== null;
+        }
+      },
+      clear(effects) {
+        for (const [id, entry] of [...tracked]) end(id, entry, effects);
+      },
+      ids: () => [...tracked.keys()]
+    };
+  }
 
   // ../game-vehicles-driving/dist/index.js
   var defaultArcadeSpec = {
@@ -43352,6 +43574,7 @@ var GameVehiclesThree = (() => {
     const settings = { quality: "high", paint: false, seed: 1, palette: "auto", driving: "arcade", surface: "dry_asphalt" };
     const kits = /* @__PURE__ */ new WeakMap();
     const placed = /* @__PURE__ */ new Map();
+    const cabins = createCabinSmoke();
     let host = null;
     let three = null;
     let counter = 0;
@@ -43416,6 +43639,7 @@ var GameVehiclesThree = (() => {
         const kit = r.userData.kit;
         const d = createVehicleDestructible(kit, r.userData.vehicle, { id, frame: root, name: text.items[itemKey] ?? key });
         tapEffects(d);
+        cabins.track(id, d, root);
         r.userData.destructible = d;
         return d;
       },
@@ -43491,10 +43715,10 @@ var GameVehiclesThree = (() => {
     };
     const clearHelpers = () => {
       for (const entry of placed.values()) {
-        for (const helper of entry.helpers) helper.parent?.remove(helper);
+        discardObject3D(entry.helpers);
         entry.helpers = [];
       }
-      for (const axis of axes) axis.parent?.remove(axis);
+      discardObject3D(axes);
       axes = [];
       helpersShown = "";
     };
@@ -43671,6 +43895,7 @@ var GameVehiclesThree = (() => {
       }
       if (host?.bench && boxKey() !== helpersShown && (host.bench.layer("damageables") || host.bench.layer("zones") || helpersShown !== "")) refreshLayers();
       lane?.step(dt);
+      cabins.sync(effects());
     };
     const count2 = () => {
       let drawCalls = 0;
@@ -43771,6 +43996,7 @@ var GameVehiclesThree = (() => {
           stopChange?.();
           stopFrame();
           stopBlocker?.();
+          cabins.clear(effects());
           clearHelpers();
           clearLane();
           host = null;