@adatechnology/game-weather-three 0.4.3 → 0.5.0

package/dist/index.global.js

@@ -42,7 +42,7 @@ var GameWeatherThree = (() => {
     WEATHER_LAYERS: () => WEATHER_LAYERS,
     ZONE_FOG_DEFAULTS: () => ZONE_FOG_DEFAULTS,
     ZONE_LIGHT: () => ZONE_LIGHT,
-    createFog: () => createFog,
+    createFog: () => createFog2,
     createHeadlights: () => createHeadlights,
     createHeatHaze: () => createHeatHaze,
     createLightning: () => createLightning,
@@ -59,6 +59,77 @@ var GameWeatherThree = (() => {
     weatherVisualTextOf: () => weatherVisualTextOf
   });
 
+  // ../game-render-three/dist/index.js
+  var DEFAULT_ANGLE = Math.PI / 3;
+  var NEUTRAL_FOG_NEAR = 6e4;
+  var NEUTRAL_FOG_FAR = 64e3;
+  function isLinearFog(fog) {
+    return fog?.isFog === true;
+  }
+  function isExp2Fog(fog) {
+    return fog?.isFogExp2 === true;
+  }
+  function createFog(THREE, scene, options = {}) {
+    const original = scene.fog;
+    const hostLinear = isLinearFog(original) ? { color: original.color.getHex(), near: original.near, far: original.far } : void 0;
+    const resting = hostLinear ?? { color: options.color ?? 0, near: NEUTRAL_FOG_NEAR, far: NEUTRAL_FOG_FAR };
+    return {
+      useLinear(color, near, far) {
+        const current = scene.fog;
+        if (isLinearFog(current)) {
+          current.color.set(color);
+          current.near = near;
+          current.far = far;
+          return current;
+        }
+        const fog = new THREE.Fog(color, near, far);
+        scene.fog = fog;
+        return fog;
+      },
+      useExp2(color, density) {
+        const current = scene.fog;
+        if (isExp2Fog(current)) {
+          current.color.set(color);
+          current.density = density;
+          return current;
+        }
+        const fog = new THREE.FogExp2(color, density);
+        scene.fog = fog;
+        return fog;
+      },
+      clear() {
+        if (options.stable !== true) {
+          scene.fog = original;
+          return;
+        }
+        const current = scene.fog;
+        if (isLinearFog(current)) {
+          current.color.set(resting.color);
+          current.near = resting.near;
+          current.far = resting.far;
+          return;
+        }
+        scene.fog = new THREE.Fog(resting.color, resting.near, resting.far);
+      }
+    };
+  }
+  var LIGHT_PRIORITY = {
+    blast: 900,
+    rocket: 800,
+    muzzle: 750,
+    fire: 600,
+    flare: 500,
+    headlight: 400,
+    weaponLight: 400,
+    lamp: 200,
+    street: 150
+  };
+  function isLightBudget(value) {
+    const candidate = value;
+    return typeof candidate === "object" && candidate !== null && typeof candidate.acquire === "function" && typeof candidate.addSource === "function" && typeof candidate.lease === "function" && typeof candidate.present === "function";
+  }
+  var EFFECT_STEP_SECONDS = 1 / 50;
+
   // src/sky.ts
   var SKY_NIGHT = 724760;
   var SKY_DAY = 8885926;
@@ -98,7 +169,8 @@ var GameWeatherThree = (() => {
     if (sample.fogDensity >= expFrom) return { mode: "exp2", density: sample.fogDensity + (densityForFar(zoneFar) - sample.fogDensity) * weight };
     return { mode: "linear", near: FOG_NEAR + (FOG_ZONE_NEAR - FOG_NEAR) * weight, far: sample.fogFar + (zoneFar - sample.fogFar) * weight };
   }
-  function createFog(THREE, scene, options = {}) {
+  function createFog2(THREE, scene, options = {}) {
+    if (options.stable) return stableFog(THREE, scene, options);
     const original = scene.fog;
     const kept = original && original.isFog ? original.clone() : original;
     return {
@@ -123,6 +195,18 @@ var GameWeatherThree = (() => {
       }
     };
   }
+  function stableFog(THREE, scene, options) {
+    const controller = createFog(THREE, scene, { stable: true });
+    return {
+      update(sample, sky, zone) {
+        const values = fogOf(sample, zone, options.expFrom);
+        if (values.mode === "linear") controller.useLinear(sky.getHex(), values.near, values.far);
+        else controller.useExp2(sky.getHex(), values.density);
+        scene.fog.color.copy(sky);
+      },
+      clear: () => controller.clear()
+    };
+  }
   var MIST = { box: { x: [-14, 10], y: [0.2, 1.1], z: [-3, 8] }, drift: [0.15, 0.35], life: [9, 13], size: [3, 5], grow: 1.4, color: 8227488, alpha: 0.13, fadeIn: 0.35 };
   var ASH = { box: { x: [-10, 8], y: [4, 6], z: [-3, 7] }, fall: -0.35, life: [8, 12], size: [0.025, 0.04], color: 10525328, alpha: 0.75, fadeIn: 0.1 };
   function emitAirborne(engine, sample, dt, camera2) {
@@ -181,18 +265,37 @@ var GameWeatherThree = (() => {
     const aimWorld = new THREE.Vector3();
     const forward = new THREE.Vector3();
     const rule = rules.lit ?? defaultHeadlightRule;
-    const range = rules.lightRange ?? HEADLIGHTS.lightRange;
+    const range2 = rules.lightRange ?? HEADLIGHTS.lightRange;
+    const lights = rules.lights;
+    const forwardAxis = new THREE.Vector3(0, 0, -1);
+    function lampSource(side, car, targets) {
+      const lamp = new THREE.Object3D();
+      lamp.position.set(side * HEADLIGHTS.lamp[0], HEADLIGHTS.lamp[1], HEADLIGHTS.lamp[2]);
+      const aim = new THREE.Vector3(side * HEADLIGHTS.aim[0], HEADLIGHTS.aim[1], HEADLIGHTS.aim[2]).sub(lamp.position).normalize();
+      lamp.quaternion.setFromUnitVectors(forwardAxis, aim);
+      car.add(lamp);
+      targets.push(lamp);
+      const spot = HEADLIGHTS.spot;
+      return lights.addSource({ owner: "weather.headlight", kind: "spot", priority: LIGHT_PRIORITY.headlight, color: spot.color, intensity: 0, distance: spot.distance, decay: spot.decay, angle: spot.angle, penumbra: spot.penumbra, position: [0, 0, 0], follow: lamp });
+    }
+    function legacySpot(side, car, targets) {
+      const spot = new THREE.SpotLight(HEADLIGHTS.spot.color, 0, HEADLIGHTS.spot.distance, HEADLIGHTS.spot.angle, HEADLIGHTS.spot.penumbra, HEADLIGHTS.spot.decay);
+      spot.position.set(side * HEADLIGHTS.lamp[0], HEADLIGHTS.lamp[1], HEADLIGHTS.lamp[2]);
+      const target = new THREE.Object3D();
+      target.position.set(side * HEADLIGHTS.aim[0], HEADLIGHTS.aim[1], HEADLIGHTS.aim[2]);
+      car.add(spot, target);
+      spot.target = target;
+      targets.push(target);
+      return spot;
+    }
     function attach(car, lens2) {
       const spots = [];
       const cones = [];
       const targets = [];
+      const sources = [];
       for (const side of [-1, 1]) {
-        const spot = new THREE.SpotLight(HEADLIGHTS.spot.color, 0, HEADLIGHTS.spot.distance, HEADLIGHTS.spot.angle, HEADLIGHTS.spot.penumbra, HEADLIGHTS.spot.decay);
-        spot.position.set(side * HEADLIGHTS.lamp[0], HEADLIGHTS.lamp[1], HEADLIGHTS.lamp[2]);
-        const target = new THREE.Object3D();
-        target.position.set(side * HEADLIGHTS.aim[0], HEADLIGHTS.aim[1], HEADLIGHTS.aim[2]);
-        car.add(spot, target);
-        spot.target = target;
+        if (lights) sources.push(lampSource(side, car, targets));
+        else spots.push(legacySpot(side, car, targets));
         const geometry = new THREE.ConeGeometry(cone.radius, cone.length, cone.segments, 1, true);
         geometry.translate(0, -cone.length / 2, 0);
         geometry.rotateX(-Math.PI / 2);
@@ -201,11 +304,9 @@ var GameWeatherThree = (() => {
         beam.position.set(side * HEADLIGHTS.lamp[0], HEADLIGHTS.lamp[1], HEADLIGHTS.lamp[2]);
         beam.visible = false;
         car.add(beam);
-        spots.push(spot);
         cones.push(beam);
-        targets.push(target);
       }
-      const rig = { car, spots, cones, lens: lens2, targets };
+      const rig = { car, spots, sources, cones, lens: lens2, targets };
       rigs.add(rig);
       return () => {
         rigs.delete(rig);
@@ -215,6 +316,7 @@ var GameWeatherThree = (() => {
           beam.material.dispose();
         }
         for (const spot of spots) spot.dispose();
+        for (const source of sources) source.remove();
         lens2?.color.setHex(HEADLIGHTS.lens.off);
       };
     }
@@ -226,8 +328,9 @@ var GameWeatherThree = (() => {
         for (const rig of rigs) {
           rig.car.updateWorldMatrix(true, false);
           lampWorld.set(0, HEADLIGHTS.lamp[1], HEADLIGHTS.lamp[2]).applyMatrix4(rig.car.matrixWorld);
-          const near = Math.hypot(lampWorld.x - camera2[0], lampWorld.z - camera2[2]) <= range;
+          const near = Math.hypot(lampWorld.x - camera2[0], lampWorld.z - camera2[2]) <= range2;
           for (const spot of rig.spots) spot.intensity = on && near ? HEADLIGHTS.spot.intensity : 0;
+          for (const source of rig.sources) source.update({ intensity: on && near ? HEADLIGHTS.spot.intensity : 0 });
           for (const beam of rig.cones) beam.visible = on;
           rig.lens?.color.setHex(on ? HEADLIGHTS.lens.on : HEADLIGHTS.lens.off);
           if (!on || !engine || sample.rain <= 0 || !near) {
@@ -261,6 +364,7 @@ var GameWeatherThree = (() => {
         for (const rig of [...rigs]) {
           rigs.delete(rig);
           for (const object of [...rig.spots, ...rig.cones, ...rig.targets]) rig.car.remove(object);
+          for (const source of rig.sources) source.remove();
         }
       }
     };
@@ -294,10 +398,13 @@ var GameWeatherThree = (() => {
 
   // src/lightning.ts
   var LIGHTNING = { light: 3.2, background: [0.25, 0.27, 0.32], white: 0.12, skyColor: 3820650, groundColor: 723724 };
-  function createLightning(THREE, scene, vfx) {
-    const light = new THREE.HemisphereLight(LIGHTNING.skyColor, LIGHTNING.groundColor, 0);
+  function createLightning(THREE, scene, vfx, options = {}) {
+    const leased = options.lights?.leaseHemisphere("weather.lightning") ?? null;
+    const light = leased ?? new THREE.HemisphereLight(LIGHTNING.skyColor, LIGHTNING.groundColor, 0);
     light.name = "weather-lightning";
-    scene.add(light);
+    light.color.setHex(LIGHTNING.skyColor);
+    light.groundColor.setHex(LIGHTNING.groundColor);
+    if (!options.lights) scene.add(light);
     return {
       light,
       update(sample, background) {
@@ -313,6 +420,8 @@ var GameWeatherThree = (() => {
         if (screen2) screen2.white = Math.max(screen2.white, flash2 * LIGHTNING.white);
       },
       dispose() {
+        light.intensity = 0;
+        if (options.lights) return;
         scene.remove(light);
         light.dispose();
       }
@@ -988,10 +1097,10 @@ var GameWeatherThree = (() => {
       )
     ]
   };
-  function normalized(vector) {
-    const length = Math.sqrt(vector[0] * vector[0] + vector[1] * vector[1] + vector[2] * vector[2]) || 1;
+  function normalized(vector2) {
+    const length = Math.sqrt(vector2[0] * vector2[0] + vector2[1] * vector2[1] + vector2[2] * vector2[2]) || 1;
     const inverse = 1 / length;
-    return [vector[0] * inverse, vector[1] * inverse, vector[2] * inverse];
+    return [vector2[0] * inverse, vector2[1] * inverse, vector2[2] * inverse];
   }
   var FRAME_DUST = normalized([0, -0.3, 1]);
   var SPLINTER_DIRECTION = normalized([0, 0.3, 1]);
@@ -2189,9 +2298,32 @@ var GameWeatherThree = (() => {
     /** The leak caught fire (an incendiary or tracer round, a spark, a fire near): the page's whole sequence, the fire running along the pool to the tank and the blast. */
     aliasOf(FUEL_LEAK, "vehicle_leak_ignited", {})
   ];
+  var vector = [variable("vx"), variable("vy"), variable("vz")];
+  var range = (name) => [variable(name), variable(name)];
+  var singleParticle = (id, system) => ({
+    id,
+    pageId: `particle:${id}`,
+    team: "world",
+    budget: { particles: 1, lights: 0 },
+    loop: 1e-3,
+    timeline: [
+      spawn(system, {
+        p: [0, 0, 0],
+        v: vector,
+        life: range("life"),
+        size: range("size"),
+        grow: variable("grow"),
+        c0: variable("color"),
+        a: variable("alpha"),
+        g: variable("gravity"),
+        drag: variable("drag")
+      })
+    ]
+  });
+  var SINGLE_PARTICLE_EFFECTS = [singleParticle("particle_puff", "normal"), singleParticle("particle_glow", "add"), singleParticle("particle_streak", "streak")];
   var ALL_EFFECTS = [BLOOD_HIT, HEADSHOT, DISMEMBER, BLOATER_CLOUD, SCREAMER_SHRIEK, CORPSE_DECAY, REANIMATION, EYES_IN_FOG, MUZZLE_FLASH, IMPACT_BY_MATERIAL, PENETRATION, CASINGS_AND_MAGAZINE, MOLOTOV, GRENADE, EXPLOSIVE_BARREL, SHOPFRONT_GLASS, DOOR_STAGES, BUILDING_COLLAPSE, BLOCK_WALL, METAL_DOOR_EFFECT, IRON_RAILING, WOODEN_FENCE, HIT_POINT_BREAKAGE, PRESSURE_CYLINDERS, BUILDING_FIRE, RAIN_AND_PUDDLES, FOG_AND_ASH, SCRAPING_SPARKS, ENGINE_SMOKE, FUEL_LEAK, CAR_EXPLOSION, WINDSHIELD, HEADLIGHTS_IN_RAIN, DAMAGE_AND_BITE, INFECTION_PHASES, PANIC, BLOATER_BLINDNESS, CAMPFIRE, COUGH_AND_BREATH];
   var WORKSHOP_EFFECTS = Object.fromEntries(ALL_EFFECTS.map((effect) => [effect.id, effect]));
-  var GAME_EFFECTS = { ...WORKSHOP_EFFECTS, ...Object.fromEntries([...EVENT_EFFECTS, ...VIEWMODEL_EFFECTS, ...VEHICLE_EFFECTS].map((effect) => [effect.id, effect])) };
+  var GAME_EFFECTS = { ...WORKSHOP_EFFECTS, ...Object.fromEntries([...EVENT_EFFECTS, ...VIEWMODEL_EFFECTS, ...VEHICLE_EFFECTS, ...SINGLE_PARTICLE_EFFECTS].map((effect) => [effect.id, effect])) };
   var QUARTER_TURN2 = Math.PI / 2;
   var SCRATCH = createVec3();
   var QUARTER_TURN3 = Math.PI / 2;
@@ -2281,9 +2413,9 @@ var GameWeatherThree = (() => {
     const haze = createHeatHaze(THREE);
     group.add(curtain.object, haze.object);
     const sky = createSky(THREE, scene);
-    const fog = createFog(THREE, scene);
-    const lightning = createLightning(THREE, scene, vfx);
-    const headlights = createHeadlights(THREE, options.headlights);
+    const fog = createFog2(THREE, scene, { stable: options.lights !== void 0 });
+    const lightning = createLightning(THREE, scene, vfx, options.lights ? { lights: options.lights } : {});
+    const headlights = createHeadlights(THREE, options.lights ? { ...options.headlights, lights: options.lights } : options.headlights);
     const nearRain = createNearRain(vfx, { ...options.puddles ? { puddles: options.puddles } : {}, ...options.puddleAt ? { puddleAt: options.puddleAt } : {} });
     const on = new Map(WEATHER_LAYERS.map((id) => [id, options.layers?.[id] ?? true]));
     let zone = options.zone;
@@ -2349,6 +2481,19 @@ var GameWeatherThree = (() => {
   }
 
   // ../game-contracts/dist/index.js
+  var DEFAULT_COST_ALLOCATION_BYTES = 1024 * 1024;
+  var DEFERRED_QUEUE_ID = {
+    DESTRUCTION_EVENTS: "destruction.events",
+    BREACH_PAINT: "floorplan.breach-paint",
+    AUDIO_VOICES: "audio.voices",
+    VEHICLE_CREASE: "vehicles.crease"
+  };
+  var DEFERRED_PRIORITY = {
+    [DEFERRED_QUEUE_ID.DESTRUCTION_EVENTS]: { priority: 300, phase: "present" },
+    [DEFERRED_QUEUE_ID.BREACH_PAINT]: { priority: 250, phase: "present" },
+    [DEFERRED_QUEUE_ID.AUDIO_VOICES]: { priority: 200, phase: "idle", reserveMs: 1 },
+    [DEFERRED_QUEUE_ID.VEHICLE_CREASE]: { priority: 100, phase: "idle" }
+  };
   function footprintBlocker(object, footprint) {
     return (x, z, radius) => {
       const o = typeof object === "function" ? object() : object;
@@ -2365,6 +2510,42 @@ var GameWeatherThree = (() => {
       return lx > fp.minX - radius && lx < fp.maxX + radius && lz > fp.minZ - radius && lz < fp.maxZ + radius;
     };
   }
+  var SURFACE_IDS = ["concrete", "asphalt", "wood", "tile", "dirt", "grass", "gravel", "sand", "metal", "water", "glass", "carpet"];
+  var GAIT_IDS = ["walk", "run"];
+  var LANDING_IDS = ["light", "heavy"];
+  var BODY_SOUND_IDS = [
+    "jump",
+    "cloth_rustle",
+    "body_fall",
+    "fall_damage",
+    "player_hurt",
+    "player_breath_run",
+    "player_death",
+    "bite",
+    "grab",
+    "punch_swing",
+    "punch_hit_body",
+    "punch_hit_face",
+    "punch_hit_object",
+    "kick_swing",
+    "kick_hit",
+    "kick_hit_object",
+    "shove_two_hands",
+    "knife_swing",
+    "knife_stab",
+    "knife_slash",
+    "knife_hit_object",
+    "blunt_swing",
+    "blunt_hit",
+    "blunt_hit_object",
+    "axe_swing",
+    "axe_chop",
+    "axe_hit_object"
+  ];
+  var footstepSoundId = (surface, gait) => `footstep_${surface}_${gait}`;
+  var FOOTSTEP_SOUND_IDS = SURFACE_IDS.flatMap((surface) => GAIT_IDS.map((gait) => footstepSoundId(surface, gait)));
+  var LAND_SOUND_IDS = SURFACE_IDS.flatMap((surface) => LANDING_IDS.map((landing) => `land_${surface}_${landing}`));
+  var BODY_FOLEY_IDS = [...FOOTSTEP_SOUND_IDS, ...LAND_SOUND_IDS, ...BODY_SOUND_IDS];
 
   // src/bench/text.ts
   var TEXTS = {
@@ -2413,7 +2594,8 @@ var GameWeatherThree = (() => {
           ...options.puddles ? { puddles: options.puddles } : {},
           ...options.puddleAt ? { puddleAt: options.puddleAt } : {},
           ...options.headlights ? { headlights: options.headlights } : {},
-          ...options.layers ? { layers: options.layers } : {}
+          ...options.layers ? { layers: options.layers } : {},
+          ...isLightBudget(host.lights) ? { lights: host.lights } : {}
         });
         const item = options.rigItem && host.addObject ? options.rigItem : void 0;
         return attachRig(THREE, host, renderer, options.rig === void 0 ? RIG_DEFAULT : options.rig, item ? void 0 : options.vehicles?.(THREE), options.rigVehicle ?? RIG_VEHICLE, item);