@adatechnology/game-interactables-three 0.1.14 → 0.2.0

package/dist/index.d.ts

@@ -1,6 +1,22 @@
 import { ActiveEmitter, ObjectSpec, Motion, World } from '@adatechnology/game-interactables';
+import { LightBudget, SourceHandle } from '@adatechnology/game-render-three';
 import * as ThreeNS from 'three';
 import { PropsApi } from '@adatechnology/game-props3d';
+import { catenary } from '@adatechnology/game-shapes-three';
+export { catenary, createCord } from '@adatechnology/game-shapes-three';
+
+/** The kinds of particle pool of the effects, as `effects.ts` draws them. */
+type PoolKind = 'smoke' | 'steam' | 'fire' | 'spark' | 'water';
+/** What `EffectSink.play` of `game-contracts` takes, as a structural type. */
+interface ParticleEffectRequest {
+    readonly effect: string;
+    readonly point: [number, number, number];
+    readonly values: Readonly<Record<string, number>>;
+}
+/** The host's effects world as far as the particles need it (`EffectSink` of `game-contracts` fits). */
+interface ParticleEffects {
+    play(request: ParticleEffectRequest): unknown;
+}
 
 /** The host's `THREE` namespace (or any object with the same classes). Always passed in, never imported at runtime. */
 type ThreeLib = typeof ThreeNS;
@@ -48,6 +64,11 @@ interface EffectsOptions {
     maxStreams?: number;
     /** Most gas flame rings drawn at once (all rings share one draw call). Default 16. */
     maxFlames?: number;
+    /**
+     * The host's effects world, read at each particle. With one, smoke, steam, fire and sparks go through it and its one budget (`maxParticles` then only caps water);
+     * without one every kind is drawn here with its own cap (deprecated, removed in the next major).
+     */
+    effects?: () => ParticleEffects | undefined;
 }
 /** What the effects read from a camera. */
 interface PerspectiveLike {
@@ -60,7 +81,7 @@ interface EffectsStats {
     capacity: number;
     byKind: Record<PoolKind, number>;
 }
-type PoolKind = 'smoke' | 'steam' | 'fire' | 'water' | 'spark';
+
 interface Effects {
     /**
      * Spawns for the active emitters and advances every particle by `dt` seconds, sizing the sprites for the camera given to
@@ -91,15 +112,6 @@ declare function createEffects(THREE: ThreeLib, options: EffectsOptions): Effect
 /** @deprecated Pass `{ scene, camera, ... }` as the one options argument. */
 declare function createEffects(THREE: ThreeLib, scene: ThreeNS.Object3D, options?: Partial<EffectsOptions>): Effects;
 
-/**
- * Points of a hanging cord between `a` and `b` (n points including both ends, n >= 2). The deepest point sits `sag` meters below
- * the straight line between the ends, on a real catenary (y = a cosh(x/a)); when the ends differ in height the curve is
- * measured against the straight line between them.
- */
-declare function catenary(a: Vec3, b: Vec3, sag: number, n?: number): Vec3[];
-/** A thin tube through `points` (Catmull-Rom smoothed) for wires, cords and conduits. */
-declare function createCord(THREE: ThreeLib, points: readonly Vec3[], radius: number, material: ThreeNS.Material, radialSegments?: number): ThreeNS.Mesh;
-
 type MaterialMap = Partial<Record<MaterialKey, ThreeNS.Material>>;
 interface MeshApiOptions {
     /** Materials per key. Missing keys get a default (vertex-colored) material. */
@@ -123,14 +135,21 @@ interface MeshApiOptions {
      * clothes) keep what you return, including its `onBeforeCompile`, `customProgramCacheKey`, `defines` and `userData`.
      */
     materialFor?: (key: MaterialKey, partId: string | null) => ThreeNS.Material | undefined;
+    /**
+     * The host's light budget: each `api.light` becomes a source of it (it competes for a slot by distance, and following its bulb) instead of a `PointLight` of its own, so lamps coming and going
+     * never change the lit materials' program key. Without it the lamps are real lights (deprecated, removed in the next major).
+     */
+    lights?: LightBudget;
 }
 interface MeshResult {
     /** Root group: static meshes (one per material) plus one child group per part (merged parts share one group, see `mergeParts`). */
     group: ThreeNS.Group;
     /** Part groups by id. Origin at the pivot, rotated by the part's `ry`; `userData.rest` holds the rest pose. A merged part maps to the shared group (`userData.merged`). */
     parts: Record<string, ThreeNS.Group>;
-    /** Real lights requested by the builders (already children of their group). */
+    /** Real lights requested by the builders (already children of their group). Empty with `MeshApiOptions.lights`. */
     lights: ThreeNS.Light[];
+    /** With `MeshApiOptions.lights`: the lamps as sources of the budget (`remove()` one when its lamp breaks or the object goes). Empty without it. */
+    sources: SourceHandle[];
 }
 interface FinishOptions {
     /** Same as `MeshApiOptions.materialFor`; wins over it for this call. */
@@ -337,6 +356,8 @@ interface ThreeAdapterOptions {
     /** `Reflector` and env map for `createMirrors`. */
     Reflector?: MirrorOptions['Reflector'];
     envMap?: MirrorOptions['envMap'];
+    /** The host's light budget: the lamps of every mesh api this adapter makes become sources of it (see `MeshApiOptions.lights`). */
+    lights?: LightBudget;
 }
 /** The package functions with `THREE` and the common options already bound. */
 interface ThreeAdapter {
@@ -395,4 +416,4 @@ type MergedGroup = ThreeNS.Group & {
  */
 declare function mergeParts(THREE: ThreeLib, root: ThreeNS.Group, parts: Record<string, ThreeNS.Group>, spec: ObjectSpec, options?: MergeOptions): void;
 
-export { type CanvasFactory, type Effects, type EffectsOptions, type EffectsStats, type FinishOptions, type HouseholdApi, MATERIAL_KEYS, type MaterialKey, type MaterialMap, type MergeOptions, type MergedGroup, type MeshApi, type MeshApiOptions, type MeshResult, type MirrorCandidate, type MirrorOptions, type Mirrors, type PerspectiveLike, type PoolKind, type Pose, type PoseBatch, type Quality, type ReflectorConstructor, type Screen, type ScreenOptions, type SwayBatch, type SwayHandle, type SwayOptions, type SwayUniforms, type SyncOptions, type ThreeAdapter, type ThreeAdapterOptions, type ThreeLib, type Vec3, applyPose, attachSway, catenary, createCord, createDefaultMaterials, createEffects, createMeshApi, createMirrors, createScreen, createThreeAdapter, mergeParts, patchSwayShader, poseOf, rememberRest, swayMaterial, syncObject };
+export { type CanvasFactory, type Effects, type EffectsOptions, type EffectsStats, type FinishOptions, type HouseholdApi, MATERIAL_KEYS, type MaterialKey, type MaterialMap, type MergeOptions, type MergedGroup, type MeshApi, type MeshApiOptions, type MeshResult, type MirrorCandidate, type MirrorOptions, type Mirrors, type PerspectiveLike, type PoolKind, type Pose, type PoseBatch, type Quality, type ReflectorConstructor, type Screen, type ScreenOptions, type SwayBatch, type SwayHandle, type SwayOptions, type SwayUniforms, type SyncOptions, type ThreeAdapter, type ThreeAdapterOptions, type ThreeLib, type Vec3, applyPose, attachSway, createDefaultMaterials, createEffects, createMeshApi, createMirrors, createScreen, createThreeAdapter, mergeParts, patchSwayShader, poseOf, rememberRest, swayMaterial, syncObject };

package/dist/index.global.js

@@ -40,6 +40,117 @@ var GameInteractablesThree = (() => {
     syncObject: () => syncObject
   });
 
+  // ../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" }
+  };
+  var WARNED_KEY = /* @__PURE__ */ Symbol.for("@adatechnology/game-contracts.warned");
+  var warnedKeys = () => {
+    const holder = globalThis;
+    return holder[WARNED_KEY] ?? (holder[WARNED_KEY] = /* @__PURE__ */ new Set());
+  };
+  var isProduction = () => {
+    try {
+      return process.env.NODE_ENV === "production";
+    } catch {
+      return false;
+    }
+  };
+  var isQuiet = () => globalThis.__GAME_KIT_QUIET__ === true;
+  var warnOnce = (key, message) => {
+    if (isQuiet() || isProduction()) return;
+    const seen = warnedKeys();
+    if (seen.has(key)) return;
+    seen.add(key);
+    console.warn(`[game-kit] ${message}`);
+  };
+  var KIT_ORIGIN_KEY = "kitOrigin";
+  function markKitOrigin(object2, origin) {
+    const node = object2;
+    node.userData = node.userData ?? {};
+    node.userData[KIT_ORIGIN_KEY] = { ...origin };
+    return object2;
+  }
+  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/routed-particles.ts
+  var channel = (value) => Math.round(Math.min(1, Math.max(0, value)) * 255);
+  var rgb = (red, green, blue) => channel(red) << 16 | channel(green) << 8 | channel(blue);
+  var EFFECT_OF = { smoke: "particle_puff", steam: "particle_puff", fire: "particle_glow", spark: "particle_streak" };
+  var isRoutedKind = (kind) => EFFECT_OF[kind] !== void 0;
+  function routedParticleRequest(particle) {
+    const { kind, flag, tint } = particle;
+    const look = lookOf(kind, flag, tint);
+    return {
+      effect: EFFECT_OF[kind],
+      point: particle.position,
+      values: {
+        vx: particle.velocity[0],
+        vy: particle.velocity[1],
+        vz: particle.velocity[2],
+        life: particle.life,
+        size: particle.startSize,
+        grow: particle.endSize / particle.startSize,
+        color: look.color,
+        alpha: look.alpha,
+        gravity: 0,
+        drag: 0
+      }
+    };
+  }
+  function lookOf(kind, flag, tint) {
+    if (kind === "smoke") return { color: rgb(tint, tint, tint), alpha: 0.55 };
+    if (kind === "steam") return { color: rgb(tint, tint, tint), alpha: 0.4 };
+    if (kind === "spark") return { color: rgb(1, 0.75, 0.3), alpha: 1 };
+    if (flag) return { color: rgb(0.25 + 0.15 * tint, 0.5 + 0.2 * tint, 1), alpha: 0.95 };
+    return { color: rgb(1, Math.max(0.15, 0.85 - tint * 0.1), 0.25), alpha: 0.8 };
+  }
+
   // src/effects.ts
   var POOLS = ["smoke", "steam", "fire", "water", "spark"];
   var WEIGHT = { smoke: 0.27, steam: 0.15, fire: 0.2, water: 0.28, spark: 0.1 };
@@ -214,6 +325,12 @@ void main() {
     let stamp = 0;
     let clock = 0;
     const spawn = (p, x, y, z, vx, vy, vz, life, s0, s1, tint, flag = 0, ground = -1e9) => {
+      const sink = isRoutedKind(p.kind) ? options.effects?.() : void 0;
+      if (sink) {
+        sink.play(routedParticleRequest({ kind: p.kind, flag, position: [x, y, z], velocity: [vx, vy, vz], life, startSize: s0, endSize: s1, tint }));
+        return;
+      }
+      if (isRoutedKind(p.kind)) warnOnce("game-interactables-three.own-particles", "game-interactables-three drew its smoke, steam, fire and sparks with pools of its own because the host lent no effects world (options.effects); pass the host effects so the particles share one budget");
       if (p.count >= p.cap) return;
       const i = p.count++;
       p.pos[i * 3] = x;
@@ -704,51 +821,7 @@ void main() {
     };
   }
 
-  // src/cord.ts
-  function catenary(a, b, sag, n = 12) {
-    const count = Math.max(2, Math.floor(n));
-    const span = Math.hypot(b[0] - a[0], b[2] - a[2]) || Math.hypot(b[0] - a[0], b[1] - a[1], b[2] - a[2]);
-    const depth = Math.max(0, sag);
-    const out = [];
-    let shape = () => 0;
-    if (depth > 1e-6 && span > 1e-6) {
-      let lo = 1e-4;
-      let hi = span * 1e3;
-      for (let i = 0; i < 80; i++) {
-        const c2 = (lo + hi) / 2;
-        const d = c2 * (Math.cosh(span / (2 * c2)) - 1);
-        if (d > depth) lo = c2;
-        else hi = c2;
-      }
-      const c = (lo + hi) / 2;
-      shape = (s) => c * (Math.cosh((s - 0.5) * span / c) - Math.cosh(span / (2 * c)));
-    }
-    for (let i = 0; i < count; i++) {
-      const s = i / (count - 1);
-      out.push([a[0] + (b[0] - a[0]) * s, a[1] + (b[1] - a[1]) * s + shape(s), a[2] + (b[2] - a[2]) * s]);
-    }
-    return out;
-  }
-  function createCord(THREE, points, radius, material, radialSegments = 5) {
-    if (points.length < 2) throw new Error("createCord needs at least two points");
-    const curve = new THREE.CatmullRomCurve3(points.map((p) => new THREE.Vector3(p[0], p[1], p[2])), false, "centripetal");
-    const segments = Math.max(4, (points.length - 1) * 4);
-    const mesh2 = new THREE.Mesh(new THREE.TubeGeometry(curve, segments, radius, radialSegments, false), material);
-    mesh2.name = "cord";
-    mesh2.castShadow = true;
-    return mesh2;
-  }
-
-  // ../game-contracts/dist/index.js
-  var KIT_ORIGIN_KEY = "kitOrigin";
-  function markKitOrigin(object2, origin) {
-    const node = object2;
-    node.userData = node.userData ?? {};
-    node.userData[KIT_ORIGIN_KEY] = { ...origin };
-    return object2;
-  }
-
-  // ../game-shapes/dist/chunk-R4RY23RH.js
+  // ../game-shapes/dist/chunk-IFXQIDSA.js
   var __defProp2 = Object.defineProperty;
   var __defNormalProp = (obj, key, value) => key in obj ? __defProp2(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
   var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
@@ -2230,8 +2303,20 @@ void main() {
     };
   }
   var streamFor = (seed, generator, path) => mulberry32(parseInt(hash64(`${String(seed)}\0${generator}\0${path}`).slice(0, 8), 16));
-  var generators = /* @__PURE__ */ new Map();
-  var getGenerator = (name) => generators.get(name);
+  var GENERATOR_NAME = /^[a-zA-Z][\w.:-]*$/;
+  var generatorsOver = (generators) => ({
+    register(name, generator) {
+      if (!GENERATOR_NAME.test(name)) throw new Error(`game-shapes: generator name "${name}" must start with a letter and use letters, digits, ".", ":", "-" or "_"`);
+      generators.set(name, generator);
+    },
+    unregister: (name) => generators.delete(name),
+    get: (name) => generators.get(name),
+    list: () => [...generators.keys()].sort(),
+    record: () => Object.fromEntries(generators)
+  });
+  var defaultGenerators;
+  var defaultShapeGenerators = () => defaultGenerators ?? (defaultGenerators = generatorsOver(/* @__PURE__ */ new Map()));
+  var getGenerator = (name) => defaultShapeGenerators().get(name);
   var num = (v) => typeof v === "number" && Number.isFinite(v) ? null : "expected a finite number";
   var bool = (v) => typeof v === "boolean" ? null : "expected a boolean";
   var str = (v) => typeof v === "string" ? null : "expected a string";
@@ -2457,7 +2542,7 @@ void main() {
       __publicField(this, "vertices", 0);
     }
   };
-  function bake(acc, t, world, rgb, u, indexed) {
+  function bake(acc, t, world, rgb2, u, indexed) {
     const e = world;
     const nm = normalMatrix(world);
     const affine = isAffine(world);
@@ -2468,7 +2553,7 @@ void main() {
     acc.positions.reserve(emitted * 3);
     acc.normals.reserve(emitted * 3);
     acc.uvs.reserve(emitted * 2);
-    if (rgb) acc.colors.reserve(emitted * 3);
+    if (rgb2) acc.colors.reserve(emitted * 3);
     const P = acc.positions.array;
     const N = acc.normals.array;
     const U = acc.uvs.array;
@@ -2508,10 +2593,10 @@ void main() {
       N[ni++] = vz * s;
       U[ui++] = u.u0 + tu[i * 2] * du;
       U[ui++] = u.v0 + tu[i * 2 + 1] * dv;
-      if (rgb) {
-        C[ci++] = rgb[0];
-        C[ci++] = rgb[1];
-        C[ci++] = rgb[2];
+      if (rgb2) {
+        C[ci++] = rgb2[0];
+        C[ci++] = rgb2[1];
+        C[ci++] = rgb2[2];
       }
     }
     acc.positions.length = pi;
@@ -2567,7 +2652,7 @@ void main() {
     return r * Math.max(sx, sy, sz);
   };
   function expandCustom(node, settings, detail, path) {
-    const generator = settings.generators?.[node.generator] ?? getGenerator(node.generator);
+    const generator = settings.generators?.[node.generator] ?? (settings.isolatedGenerators ? void 0 : getGenerator(node.generator));
     if (!generator) throw new Error(`game-shapes: no generator "${node.generator}" (register it with registerGenerator, in the worker too) at ${path}`);
     const generated = generator(node.params, { random: streamFor(settings.seed, node.generator, path), seed: settings.seed, detail, path });
     const { kind: _kind, generator: _generator, params: _params, ...common } = node;
@@ -2749,9 +2834,9 @@ void main() {
     for (const group of autoGroups.values()) {
       const template = buildPrimitive(group.node, level);
       const n = group.matrices.length / 16;
-      const rgb = colorChannels(group.color, space ?? "srgb");
+      const rgb2 = colorChannels(group.color, space ?? "srgb");
       const colors = new Float32Array(n * 3);
-      for (let i = 0; i < n; i++) colors.set(rgb, i * 3);
+      for (let i = 0; i < n; i++) colors.set(rgb2, i * 3);
       instanced.push({
         material: group.material,
         part: null,
@@ -2775,6 +2860,7 @@ void main() {
       ...options.materialAlias ? { alias: options.materialAlias } : {},
       seed: options.seed ?? 0,
       ...options.generators ? { generators: options.generators } : {},
+      ...options.isolatedGenerators ? { isolatedGenerators: true } : {},
       ...options.instancing ? { autoMin: Math.max(2, options.instancing.minCount) } : {}
     };
     const specs = [{ distance: 0, detail: 1, index: 0 }, ...(schema.lod ?? []).map((rule, index) => ({ ...rule, index: index + 1 }))];
@@ -2807,6 +2893,56 @@ void main() {
     };
   }
 
+  // ../game-shapes-three/dist/index.js
+  function catenary(a, b, sag, n = 12) {
+    const count = Math.max(2, Math.floor(n));
+    const span = Math.hypot(b[0] - a[0], b[2] - a[2]) || Math.hypot(b[0] - a[0], b[1] - a[1], b[2] - a[2]);
+    const depth = Math.max(0, sag);
+    const out = [];
+    let shape = () => 0;
+    if (depth > 1e-6 && span > 1e-6) {
+      let lo = 1e-4;
+      let hi = span * 1e3;
+      for (let i = 0; i < 80; i++) {
+        const c2 = (lo + hi) / 2;
+        const d = c2 * (Math.cosh(span / (2 * c2)) - 1);
+        if (d > depth) lo = c2;
+        else hi = c2;
+      }
+      const c = (lo + hi) / 2;
+      shape = (s) => c * (Math.cosh((s - 0.5) * span / c) - Math.cosh(span / (2 * c)));
+    }
+    for (let i = 0; i < count; i++) {
+      const s = i / (count - 1);
+      out.push([a[0] + (b[0] - a[0]) * s, a[1] + (b[1] - a[1]) * s + shape(s), a[2] + (b[2] - a[2]) * s]);
+    }
+    return out;
+  }
+  function createCord(THREE, points, radius, material, radialSegments = 5) {
+    if (points.length < 2) throw new Error("createCord needs at least two points");
+    const curve = new THREE.CatmullRomCurve3(points.map((p) => new THREE.Vector3(p[0], p[1], p[2])), false, "centripetal");
+    const segments = Math.max(4, (points.length - 1) * 4);
+    const mesh2 = new THREE.Mesh(new THREE.TubeGeometry(curve, segments, radius, radialSegments, false), material);
+    mesh2.name = "cord";
+    mesh2.castShadow = true;
+    return mesh2;
+  }
+
+  // ../game-render-three/dist/index.js
+  var DEFAULT_ANGLE = Math.PI / 3;
+  var LIGHT_PRIORITY = {
+    blast: 900,
+    rocket: 800,
+    muzzle: 750,
+    fire: 600,
+    flare: 500,
+    headlight: 400,
+    weaponLight: 400,
+    lamp: 200,
+    street: 150
+  };
+  var EFFECT_STEP_SECONDS = 1 / 50;
+
   // ../game-props3d/dist/index.js
   var T = (id, interior, w, d, h, y, solid, group) => ({ id, interior, w, d, h, y, solid, group });
   var TYPE_DEFS = [
@@ -3390,6 +3526,7 @@ ${QROT}${shader.vertexShader}`;
       if (first !== k) materialAlias[k] = first;
     }
     const lightsOut = [];
+    const sourcesOut = [];
     const build = (batches, points, id, into, materialFor) => {
       for (const batch of batches) {
         const g = new THREE.BufferGeometry();
@@ -3411,6 +3548,14 @@ ${QROT}${shader.vertexShader}`;
       }
       for (const point of points) {
         const l = point.data;
+        if (options.lights) {
+          const bulb = new THREE.Object3D();
+          bulb.name = "lamp";
+          bulb.position.set(point.position[0], point.position[1], point.position[2]);
+          into.add(bulb);
+          sourcesOut.push(options.lights.addSource({ owner: "interactables.lamp", priority: LIGHT_PRIORITY.lamp, color: l.color, intensity: 1, distance: l.range, position: [0, 0, 0], follow: bulb }));
+          continue;
+        }
         const light = new THREE.PointLight(l.color, 1, l.range);
         light.position.set(point.position[0], point.position[1], point.position[2]);
         into.add(light);
@@ -3454,7 +3599,7 @@ ${QROT}${shader.vertexShader}`;
         }
         if (spec && (options.mergeParts ?? quality === "game")) mergeParts(THREE, group, parts, spec, { swayAmplitude: options.swayAmplitude });
         if (spec) tagDestruction(group, parts, spec);
-        return { group, parts, lights: lightsOut };
+        return { group, parts, lights: lightsOut, sources: sourcesOut };
       }
     };
   }
@@ -3646,7 +3791,7 @@ ${QROT}${shader.vertexShader}`;
       emissiveIntensity: 0
     });
     let on = false;
-    let channel = 0;
+    let channel2 = 0;
     let clock = 0;
     let acc = 0;
     const fill = (style, x, y, rw, rh) => {
@@ -3656,7 +3801,7 @@ ${QROT}${shader.vertexShader}`;
     };
     const drawBars = () => {
       const n = BARS.length;
-      for (let i = 0; i < n; i++) fill(BARS[(i + channel) % n], Math.floor(i * w / n), 0, Math.ceil(w / n), Math.floor(h * 0.75));
+      for (let i = 0; i < n; i++) fill(BARS[(i + channel2) % n], Math.floor(i * w / n), 0, Math.ceil(w / n), Math.floor(h * 0.75));
       fill("#101010", 0, Math.floor(h * 0.75), w, h - Math.floor(h * 0.75));
       const x = clock * 20 % (w + 12) - 12;
       fill("#ffffff", x, Math.floor(h * 0.8), 12, Math.floor(h * 0.1));
@@ -3671,7 +3816,7 @@ ${QROT}${shader.vertexShader}`;
       }
     };
     const drawScene = () => {
-      const hue = channel * 40 % 360;
+      const hue = channel2 * 40 % 360;
       fill(`hsl(${(200 + hue) % 360},60%,${55 + 10 * Math.sin(clock * 0.3)}%)`, 0, 0, w, Math.floor(h * 0.65));
       fill(`hsl(${(110 + hue) % 360},40%,32%)`, 0, Math.floor(h * 0.65), w, h - Math.floor(h * 0.65));
       const sx = (0.5 + 0.4 * Math.sin(clock * 0.5)) * w;
@@ -3683,9 +3828,9 @@ ${QROT}${shader.vertexShader}`;
     const draw = () => {
       if (!on) {
         fill("#000000", 0, 0, w, h);
-      } else if (channel % 3 === 0) {
+      } else if (channel2 % 3 === 0) {
         drawBars();
-      } else if (channel % 3 === 1) {
+      } else if (channel2 % 3 === 1) {
         drawNoise();
       } else {
         drawScene();
@@ -3706,7 +3851,7 @@ ${QROT}${shader.vertexShader}`;
         return on;
       },
       get channel() {
-        return channel;
+        return channel2;
       },
       setOn(value) {
         on = !!value;
@@ -3714,7 +3859,7 @@ ${QROT}${shader.vertexShader}`;
         apply();
       },
       setChannel(n) {
-        channel = Math.max(0, Math.floor(n));
+        channel2 = Math.max(0, Math.floor(n));
         if (on) draw();
       },
       update(dt) {
@@ -3813,7 +3958,7 @@ uniform float swayAmplitude;
   function createThreeAdapter(THREE, options = {}) {
     return {
       THREE,
-      createMeshApi: (o = {}) => createMeshApi(THREE, { quality: options.quality, materials: options.materials, ...o }),
+      createMeshApi: (o = {}) => createMeshApi(THREE, { quality: options.quality, materials: options.materials, ...options.lights ? { lights: options.lights } : {}, ...o }),
       applyPose: (group, motion, t) => applyPose(THREE, group, motion, t),
       syncObject: (world, objectId, parts, o) => syncObject(THREE, world, objectId, parts, o),
       swayMaterial: (base, o) => swayMaterial(THREE, base, o),