@carbonenginejs/runtime 0.1.0-alpha.4 → 0.1.0-alpha.5

package/dist/trinity/eve/attachment/turrets/EveTurretSet.js

@@ -3,7 +3,7 @@ import { edit, type, carbon, impl, CjsSchema } from '#schema';
 import { EveEntity as _EveEntity } from '../../EveEntity.js';
 import { EveComponentType } from '../../EveComponentTypes.js';
 import { EveTurretAiming } from './EveTurretAiming.js';
-import { EveTurretTarget as _EveTurretTarget } from './EveTurretTarget.js';
+import { EveTurretTarget as _EveTurretTarget, EVE_TURRET_RANDOM_DELAY_MAX } from './EveTurretTarget.js';
 import { mat4 } from '#math/mat4';
 import { quat } from '#math/quat';
 import { vec3 } from '#math/vec3';
@@ -19,12 +19,12 @@ import '#consts/render-context';
 import { Tr2Vector4Parameter as _Tr2Vector4Parameter } from '../../../shader/parameter/Tr2Vector4Parameter.js';
 import { ITr2Renderable } from '../../../core/ITr2Renderable.js';
 
-let _initProto, _initClass, _init_impactBehaviour, _init_extra_impactBehaviour, _init_firingEffect, _init_extra_firingEffect, _init_ambientEffect, _init_extra_ambientEffect, _init_name, _init_extra_name, _init_firingEffectResPath, _init_extra_firingEffectResPath, _init_chooseRandomLocator, _init_extra_chooseRandomLocator, _init_boundingSphere, _init_extra_boundingSphere, _init_randomizeExplosionRotation, _init_extra_randomizeExplosionRotation, _init_lodLevel, _init_extra_lodLevel, _init_currentCyclingFiresPos, _init_extra_currentCyclingFiresPos, _init_useRandomFiringDelay, _init_extra_useRandomFiringDelay, _init_bottomClipHeight, _init_extra_bottomClipHeight, _init_geometryResource, _init_extra_geometryResource, _init_maxTrackingTime, _init_extra_maxTrackingTime, _init_visibleCount, _init_extra_visibleCount, _init_trackingInfluence, _init_extra_trackingInfluence, _init_swarmID, _init_extra_swarmID, _init_maxCyclingFirePos, _init_extra_maxCyclingFirePos, _init_playMovementSound, _init_extra_playMovementSound, _init_isOnline, _init_extra_isOnline, _init_target, _init_extra_target, _init_locatorName, _init_extra_locatorName, _init_sysBonePitchFactor, _init_extra_sysBonePitchFactor, _init_sysBonePitchMax, _init_extra_sysBonePitchMax, _init_sysBonePitchMin, _init_extra_sysBonePitchMin, _init_sysBonePitchOffset, _init_extra_sysBonePitchOffset, _init_sysBonePitch01Factor, _init_extra_sysBonePitch01Factor, _init_sysBonePitch01Offset, _init_extra_sysBonePitch01Offset, _init_sysBonePitch02Factor, _init_extra_sysBonePitch02Factor, _init_sysBonePitch02Offset, _init_extra_sysBonePitch02Offset, _init_sysBonePitch03Factor, _init_extra_sysBonePitch03Factor, _init_sysBonePitch03Offset, _init_extra_sysBonePitch03Offset, _init_updatePitchPose, _init_extra_updatePitchPose, _init_geometryResPath, _init_extra_geometryResPath, _init_impactSize, _init_extra_impactSize, _init_state, _init_extra_state, _init_sysBoneHeight, _init_extra_sysBoneHeight, _init_randomFiringDelay, _init_extra_randomFiringDelay, _init_turretEffect, _init_extra_turretEffect, _init_idleToTargetingMovementAudioEvent, _init_extra_idleToTargetingMovementAudioEvent, _init_targetingToIdleMovementAudioEvent, _init_extra_targetingToIdleMovementAudioEvent, _init_generatedDistributedAmbientEffect, _init_extra_generatedDistributedAmbientEffect, _init_cyclingFireGroupCount, _init_extra_cyclingFireGroupCount, _init_turretMovementObserver, _init_extra_turretMovementObserver, _init_slotNumber, _init_extra_slotNumber, _init_ambientEffectEditingMode, _init_extra_ambientEffectEditingMode, _init_displayEffects, _init_extra_displayEffects, _init_display, _init_extra_display, _init_useDynamicBounds, _init_extra_useDynamicBounds, _init_estimatedPixelDiameter, _init_extra_estimatedPixelDiameter, _init_lowLodFiringEffectScale, _init_extra_lowLodFiringEffectScale, _init_lowLodFiringEffectTranslation, _init_extra_lowLodFiringEffectTranslation, _init_lowLodFiringEffectRotation, _init_extra_lowLodFiringEffectRotation, _init_useLowLodFiringTransform, _init_extra_useLowLodFiringTransform, _init_laserMissBehaviour, _init_extra_laserMissBehaviour, _init_projectileMissBehaviour, _init_extra_projectileMissBehaviour;
+let _initProto, _initStatic, _initClass, _init_impactBehaviour, _init_extra_impactBehaviour, _init_firingEffect, _init_extra_firingEffect, _init_ambientEffect, _init_extra_ambientEffect, _init_name, _init_extra_name, _init_firingEffectResPath, _init_extra_firingEffectResPath, _init_chooseRandomLocator, _init_extra_chooseRandomLocator, _init_boundingSphere, _init_extra_boundingSphere, _init_randomizeExplosionRotation, _init_extra_randomizeExplosionRotation, _init_lodLevel, _init_extra_lodLevel, _init_currentCyclingFiresPos, _init_extra_currentCyclingFiresPos, _init_useRandomFiringDelay, _init_extra_useRandomFiringDelay, _init_bottomClipHeight, _init_extra_bottomClipHeight, _init_geometryResource, _init_extra_geometryResource, _init_maxTrackingTime, _init_extra_maxTrackingTime, _init_visibleCount, _init_extra_visibleCount, _init_trackingInfluence, _init_extra_trackingInfluence, _init_swarmID, _init_extra_swarmID, _init_maxCyclingFirePos, _init_extra_maxCyclingFirePos, _init_playMovementSound, _init_extra_playMovementSound, _init_isOnline, _init_extra_isOnline, _init_target, _init_extra_target, _init_locatorName, _init_extra_locatorName, _init_sysBonePitchFactor, _init_extra_sysBonePitchFactor, _init_sysBonePitchMax, _init_extra_sysBonePitchMax, _init_sysBonePitchMin, _init_extra_sysBonePitchMin, _init_sysBonePitchOffset, _init_extra_sysBonePitchOffset, _init_sysBonePitch01Factor, _init_extra_sysBonePitch01Factor, _init_sysBonePitch01Offset, _init_extra_sysBonePitch01Offset, _init_sysBonePitch02Factor, _init_extra_sysBonePitch02Factor, _init_sysBonePitch02Offset, _init_extra_sysBonePitch02Offset, _init_sysBonePitch03Factor, _init_extra_sysBonePitch03Factor, _init_sysBonePitch03Offset, _init_extra_sysBonePitch03Offset, _init_updatePitchPose, _init_extra_updatePitchPose, _init_geometryResPath, _init_extra_geometryResPath, _init_impactSize, _init_extra_impactSize, _init_state, _init_extra_state, _init_sysBoneHeight, _init_extra_sysBoneHeight, _init_randomFiringDelay, _init_extra_randomFiringDelay, _init_turretEffect, _init_extra_turretEffect, _init_idleToTargetingMovementAudioEvent, _init_extra_idleToTargetingMovementAudioEvent, _init_targetingToIdleMovementAudioEvent, _init_extra_targetingToIdleMovementAudioEvent, _init_generatedDistributedAmbientEffect, _init_extra_generatedDistributedAmbientEffect, _init_cyclingFireGroupCount, _init_extra_cyclingFireGroupCount, _init_turretMovementObserver, _init_extra_turretMovementObserver, _init_slotNumber, _init_extra_slotNumber, _init_ambientEffectEditingMode, _init_extra_ambientEffectEditingMode, _init_displayEffects, _init_extra_displayEffects, _init_display, _init_extra_display, _init_useDynamicBounds, _init_extra_useDynamicBounds, _init_estimatedPixelDiameter, _init_extra_estimatedPixelDiameter, _init_lowLodFiringEffectScale, _init_extra_lowLodFiringEffectScale, _init_lowLodFiringEffectTranslation, _init_extra_lowLodFiringEffectTranslation, _init_lowLodFiringEffectRotation, _init_extra_lowLodFiringEffectRotation, _init_useLowLodFiringTransform, _init_extra_useLowLodFiringTransform, _init_laserMissBehaviour, _init_extra_laserMissBehaviour, _init_projectileMissBehaviour, _init_extra_projectileMissBehaviour;
 
-/** Carbon BoundingSphereTransform (Utilities/BoundingSphere.cpp:70-81):
- * center = TransformCoord(center, tf); radius *= max of the basis row lengths
- * (|GetX/Y/Z| = gl flat [0..2]/[4..6]/[8..10]). Single-matrix application -
- * NO composition, NO operand swap. Mutates the packed (x, y, z, radius)
+/** Carbon BoundingSphereTransform (Utilities/BoundingSphere.cpp:70-81):
+ * center = TransformCoord(center, tf); radius *= max of the basis row lengths
+ * (|GetX/Y/Z| = gl flat [0..2]/[4..6]/[8..10]). Single-matrix application -
+ * NO composition, NO operand swap. Mutates the packed (x, y, z, radius)
  * sphere in place. */
 function BoundingSphereTransform(transform, sphere) {
   vec3.transformMat4(sphere, sphere, transform);
@@ -38,12 +38,13 @@ new class extends _identity {
   static [class EveTurretSet extends _EveEntity {
     static {
       ({
-        e: [_init_impactBehaviour, _init_extra_impactBehaviour, _init_firingEffect, _init_extra_firingEffect, _init_ambientEffect, _init_extra_ambientEffect, _init_name, _init_extra_name, _init_firingEffectResPath, _init_extra_firingEffectResPath, _init_chooseRandomLocator, _init_extra_chooseRandomLocator, _init_boundingSphere, _init_extra_boundingSphere, _init_randomizeExplosionRotation, _init_extra_randomizeExplosionRotation, _init_lodLevel, _init_extra_lodLevel, _init_currentCyclingFiresPos, _init_extra_currentCyclingFiresPos, _init_useRandomFiringDelay, _init_extra_useRandomFiringDelay, _init_bottomClipHeight, _init_extra_bottomClipHeight, _init_geometryResource, _init_extra_geometryResource, _init_maxTrackingTime, _init_extra_maxTrackingTime, _init_visibleCount, _init_extra_visibleCount, _init_trackingInfluence, _init_extra_trackingInfluence, _init_swarmID, _init_extra_swarmID, _init_maxCyclingFirePos, _init_extra_maxCyclingFirePos, _init_playMovementSound, _init_extra_playMovementSound, _init_isOnline, _init_extra_isOnline, _init_target, _init_extra_target, _init_locatorName, _init_extra_locatorName, _init_sysBonePitchFactor, _init_extra_sysBonePitchFactor, _init_sysBonePitchMax, _init_extra_sysBonePitchMax, _init_sysBonePitchMin, _init_extra_sysBonePitchMin, _init_sysBonePitchOffset, _init_extra_sysBonePitchOffset, _init_sysBonePitch01Factor, _init_extra_sysBonePitch01Factor, _init_sysBonePitch01Offset, _init_extra_sysBonePitch01Offset, _init_sysBonePitch02Factor, _init_extra_sysBonePitch02Factor, _init_sysBonePitch02Offset, _init_extra_sysBonePitch02Offset, _init_sysBonePitch03Factor, _init_extra_sysBonePitch03Factor, _init_sysBonePitch03Offset, _init_extra_sysBonePitch03Offset, _init_updatePitchPose, _init_extra_updatePitchPose, _init_geometryResPath, _init_extra_geometryResPath, _init_impactSize, _init_extra_impactSize, _init_state, _init_extra_state, _init_sysBoneHeight, _init_extra_sysBoneHeight, _init_randomFiringDelay, _init_extra_randomFiringDelay, _init_turretEffect, _init_extra_turretEffect, _init_idleToTargetingMovementAudioEvent, _init_extra_idleToTargetingMovementAudioEvent, _init_targetingToIdleMovementAudioEvent, _init_extra_targetingToIdleMovementAudioEvent, _init_generatedDistributedAmbientEffect, _init_extra_generatedDistributedAmbientEffect, _init_cyclingFireGroupCount, _init_extra_cyclingFireGroupCount, _init_turretMovementObserver, _init_extra_turretMovementObserver, _init_slotNumber, _init_extra_slotNumber, _init_ambientEffectEditingMode, _init_extra_ambientEffectEditingMode, _init_displayEffects, _init_extra_displayEffects, _init_display, _init_extra_display, _init_useDynamicBounds, _init_extra_useDynamicBounds, _init_estimatedPixelDiameter, _init_extra_estimatedPixelDiameter, _init_lowLodFiringEffectScale, _init_extra_lowLodFiringEffectScale, _init_lowLodFiringEffectTranslation, _init_extra_lowLodFiringEffectTranslation, _init_lowLodFiringEffectRotation, _init_extra_lowLodFiringEffectRotation, _init_useLowLodFiringTransform, _init_extra_useLowLodFiringTransform, _init_laserMissBehaviour, _init_extra_laserMissBehaviour, _init_projectileMissBehaviour, _init_extra_projectileMissBehaviour, _initProto],
+        e: [_init_impactBehaviour, _init_extra_impactBehaviour, _init_firingEffect, _init_extra_firingEffect, _init_ambientEffect, _init_extra_ambientEffect, _init_name, _init_extra_name, _init_firingEffectResPath, _init_extra_firingEffectResPath, _init_chooseRandomLocator, _init_extra_chooseRandomLocator, _init_boundingSphere, _init_extra_boundingSphere, _init_randomizeExplosionRotation, _init_extra_randomizeExplosionRotation, _init_lodLevel, _init_extra_lodLevel, _init_currentCyclingFiresPos, _init_extra_currentCyclingFiresPos, _init_useRandomFiringDelay, _init_extra_useRandomFiringDelay, _init_bottomClipHeight, _init_extra_bottomClipHeight, _init_geometryResource, _init_extra_geometryResource, _init_maxTrackingTime, _init_extra_maxTrackingTime, _init_visibleCount, _init_extra_visibleCount, _init_trackingInfluence, _init_extra_trackingInfluence, _init_swarmID, _init_extra_swarmID, _init_maxCyclingFirePos, _init_extra_maxCyclingFirePos, _init_playMovementSound, _init_extra_playMovementSound, _init_isOnline, _init_extra_isOnline, _init_target, _init_extra_target, _init_locatorName, _init_extra_locatorName, _init_sysBonePitchFactor, _init_extra_sysBonePitchFactor, _init_sysBonePitchMax, _init_extra_sysBonePitchMax, _init_sysBonePitchMin, _init_extra_sysBonePitchMin, _init_sysBonePitchOffset, _init_extra_sysBonePitchOffset, _init_sysBonePitch01Factor, _init_extra_sysBonePitch01Factor, _init_sysBonePitch01Offset, _init_extra_sysBonePitch01Offset, _init_sysBonePitch02Factor, _init_extra_sysBonePitch02Factor, _init_sysBonePitch02Offset, _init_extra_sysBonePitch02Offset, _init_sysBonePitch03Factor, _init_extra_sysBonePitch03Factor, _init_sysBonePitch03Offset, _init_extra_sysBonePitch03Offset, _init_updatePitchPose, _init_extra_updatePitchPose, _init_geometryResPath, _init_extra_geometryResPath, _init_impactSize, _init_extra_impactSize, _init_state, _init_extra_state, _init_sysBoneHeight, _init_extra_sysBoneHeight, _init_randomFiringDelay, _init_extra_randomFiringDelay, _init_turretEffect, _init_extra_turretEffect, _init_idleToTargetingMovementAudioEvent, _init_extra_idleToTargetingMovementAudioEvent, _init_targetingToIdleMovementAudioEvent, _init_extra_targetingToIdleMovementAudioEvent, _init_generatedDistributedAmbientEffect, _init_extra_generatedDistributedAmbientEffect, _init_cyclingFireGroupCount, _init_extra_cyclingFireGroupCount, _init_turretMovementObserver, _init_extra_turretMovementObserver, _init_slotNumber, _init_extra_slotNumber, _init_ambientEffectEditingMode, _init_extra_ambientEffectEditingMode, _init_displayEffects, _init_extra_displayEffects, _init_display, _init_extra_display, _init_useDynamicBounds, _init_extra_useDynamicBounds, _init_estimatedPixelDiameter, _init_extra_estimatedPixelDiameter, _init_lowLodFiringEffectScale, _init_extra_lowLodFiringEffectScale, _init_lowLodFiringEffectTranslation, _init_extra_lowLodFiringEffectTranslation, _init_lowLodFiringEffectRotation, _init_extra_lowLodFiringEffectRotation, _init_useLowLodFiringTransform, _init_extra_useLowLodFiringTransform, _init_laserMissBehaviour, _init_extra_laserMissBehaviour, _init_projectileMissBehaviour, _init_extra_projectileMissBehaviour, _initProto, _initStatic],
         c: [_EveTurretSet, _initClass]
       } = _applyDecs2311(this, [type.define({
         className: "EveTurretSet",
         family: "eve/attachment/turrets"
-      }), carbon.inherit(ITr2Renderable)], [[[edit, edit.notify, edit, edit.persist, type, type.int32, void 0, type.enum("ImpactBehaviour")], 16, "impactBehaviour"], [type.objectRef("EveTurretFiringFX"), 0, "firingEffect"], [[edit, edit.persistOnly, void 0, type.model("IEveSpaceObjectChild")], 16, "ambientEffect"], [[edit, edit.persist, type, type.string], 16, "name"], [[edit, edit.persist, type, type.string], 16, "firingEffectResPath"], [[edit, edit.persist, type, type.boolean], 16, "chooseRandomLocator"], [[edit, edit.persist, type, type.vec4], 16, "boundingSphere"], [[edit, edit.persist, type, type.boolean], 16, "randomizeExplosionRotation"], [[edit, edit.read, type, type.int32, void 0, type.enum("LOD")], 16, "lodLevel"], [[edit, edit.read, type, type.uint32], 16, "currentCyclingFiresPos"], [[edit, edit.persist, type, type.boolean], 16, "useRandomFiringDelay"], [[edit, edit.persist, type, type.float32], 16, "bottomClipHeight"], [[edit, edit.read, void 0, type.objectRef("TriGeometryRes")], 16, "geometryResource"], [[edit, edit.persist, type, type.float32], 16, "maxTrackingTime"], [[edit, edit.read, type, type.uint32], 16, "visibleCount"], [[edit, edit.read, type, type.float32], 16, "trackingInfluence"], [[edit, edit.readwrite, type, type.uint32], 16, "swarmID"], [[edit, edit.persist, type, type.uint32], 16, "maxCyclingFirePos"], [[edit, edit.persist, type, type.boolean], 16, "playMovementSound"], [[edit, edit.readwrite, type, type.boolean], 16, "isOnline"], [[edit, edit.read, void 0, type.objectRef("EveTurretTarget")], 16, "target"], [[edit, edit.persist, type, type.string], 16, "locatorName"], [[edit, edit.persist, type, type.float32], 16, "sysBonePitchFactor"], [[edit, edit.persist, type, type.float32], 16, "sysBonePitchMax"], [[edit, edit.persist, type, type.float32], 16, "sysBonePitchMin"], [[edit, edit.persist, type, type.float32], 16, "sysBonePitchOffset"], [[edit, edit.persist, type, type.float32], 16, "sysBonePitch01Factor"], [[edit, edit.persist, type, type.float32], 16, "sysBonePitch01Offset"], [[edit, edit.persist, type, type.float32], 16, "sysBonePitch02Factor"], [[edit, edit.persist, type, type.float32], 16, "sysBonePitch02Offset"], [[edit, edit.persist, type, type.float32], 16, "sysBonePitch03Factor"], [[edit, edit.persist, type, type.float32], 16, "sysBonePitch03Offset"], [[edit, edit.persist, type, type.boolean], 16, "updatePitchPose"], [[edit, edit.notify, edit, edit.persist, type, type.string], 16, "geometryResPath"], [[edit, edit.persist, type, type.float32], 16, "impactSize"], [[edit, edit.persist, type, type.int32, void 0, type.enum("State")], 16, "state"], [[edit, edit.persist, type, type.float32], 16, "sysBoneHeight"], [[edit, edit.read, type, type.float32], 16, "randomFiringDelay"], [[edit, edit.persist, void 0, type.model("Tr2Effect")], 16, "turretEffect"], [[edit, edit.persist, type, type.string], 16, "idleToTargetingMovementAudioEvent"], [[edit, edit.persist, type, type.string], 16, "targetingToIdleMovementAudioEvent"], [[edit, edit.read, void 0, type.objectRef("EveChildInstanceContainer")], 16, "generatedDistributedAmbientEffect"], [[edit, edit.persist, type, type.uint32], 16, "cyclingFireGroupCount"], [[edit, edit.persist, void 0, type.model("TriObserverLocal")], 16, "turretMovementObserver"], [[edit, edit.readwrite, type, type.int32], 16, "slotNumber"], [[edit, edit.notify, edit, edit.readwrite, type, type.boolean], 16, "ambientEffectEditingMode"], [[edit, edit.readwrite, type, type.boolean], 16, "displayEffects"], [[edit, edit.readwrite, type, type.boolean], 16, "display"], [[edit, edit.notify, edit, edit.persist, type, type.boolean], 16, "useDynamicBounds"], [[edit, edit.read, type, type.float32], 16, "estimatedPixelDiameter"], [[edit, edit.persist, type, type.vec3], 16, "lowLodFiringEffectScale"], [[edit, edit.persist, type, type.vec3], 16, "lowLodFiringEffectTranslation"], [[edit, edit.persist, type, type.quat], 16, "lowLodFiringEffectRotation"], [[edit, edit.persist, type, type.boolean], 16, "useLowLodFiringTransform"], [[edit, edit.persist, type, type.boolean], 16, "laserMissBehaviour"], [[edit, edit.persist, type, type.boolean], 16, "projectileMissBehaviour"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Geometry resources are duck-typed; the runtime Trinity layer stores their computed sphere without creating render buffers.")], 18, "RebuildBoundingSphere"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Animation calls are forwarded to hydrated turret/controller objects without Carbon's Granny controller.")], 18, "ForceStateDeactive"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Animation calls are forwarded to hydrated turret/controller objects without Carbon's Granny controller.")], 18, "ForceStateTargeting"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("The graph freezes its LOD state; geometry creation is not ported yet.")], 18, "FreezeHighDetailLOD"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetShader"], [[impl, impl.adapted, void 0, impl.reason("Carbon's by-value embed becomes an accessor because the pose pipeline (the aiming consumer) lives behind the animation seam.")], 18, "GetAiming"], [[impl, impl.custom, void 0, impl.reason("The combined runtime keeps SOF independently importable by putting the nominal Tr2Effect application boundary on the owning turret class.")], 18, "ApplySofTurretMaterial"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetShotTimeVariance"], [[carbon, carbon.method, impl, impl.implemented], 18, "MissQueueSize"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetLastShotTime"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Animation calls are forwarded to hydrated turret/controller objects without Carbon's Granny controller.")], 18, "EnterStateDeactive"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Carbon's geometry/animation selection is represented by portable turret records and controller forwarding.")], 18, "EnterStateFiring"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Animation calls are forwarded to hydrated turret/controller objects without Carbon's Granny controller.")], 18, "EnterStateIdle"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Animation calls are forwarded to hydrated turret/controller objects without Carbon's Granny controller.")], 18, "EnterStateReloading"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Animation calls are forwarded to hydrated turret/controller objects without Carbon's Granny controller.")], 18, "EnterStateTargeting"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Controller ownership is represented by direct firing/ambient child forwarding.")], 18, "HandleControllerEvent"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Portable turret records and duck-typed geometry bone transforms replace Carbon's CMF/Granny split.")], 18, "GetFiringBoneWorldTransform"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Controller ownership is represented by direct firing/ambient child forwarding.")], 18, "SetControllerVariable"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetShotMissed"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Controller ownership is represented by direct firing/ambient child forwarding.")], 18, "StartControllers"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("InitializeGeometryResource and the granny skeleton load are not ported; Carbon calls them from here (cpp:146-165).")], 18, "Initialize"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("JS dispatches the native hook using the exposed member name; existing class-owned rendering/resource adaptations remain unchanged.")], 18, "OnModified"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetFiringEffect"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Carbon QueryInterface target attachment is delegated to EveTurretTarget's browser-compatible target validation.")], 18, "SetTargetObject"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetTargetObject"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetTargetScale"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Carbon builds hidden SingleTurret records from geometry locators; browser hosts may provide equivalent portable records directly.")], 18, "SetTurrets"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Carbon builds hidden SingleTurret records from geometry locators; browser hosts may provide equivalent portable records directly.")], 18, "AddTurret"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetTurrets"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Portable records replace Carbon's CMF/Granny SingleTurretData allocation while retaining its fixed 24-turret limit and scale removal.")], 18, "SetLocalTransform"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetParentTransform"], [[carbon, carbon.method, impl, impl.implemented], 18, "UpdateTurretTransforms"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("The closest portable turret is selected from its world up-axis and the target tracking position.")], 18, "GetClosestTurret"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("This combined browser convenience update runs Carbon's explicit synchronous and asynchronous phases in order.")], 18, "Update"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Animation cleanup and task dispatch are forwarded through portable records; target and firing timing remain source-faithful.")], 18, "UpdateSyncronous"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Skeleton realization is not ported yet; portable turret records may consume the same local-target tracking hook.")], 18, "UpdateAsyncronous"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Renderable collection is backend-neutral; geometry and batch realization are not ported yet.")], 18, "GetRenderables"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Visibility is forwarded through backend-neutral firing and ambient graph contracts.")], 18, "UpdateVisibility"], [[carbon, carbon.method, impl, impl.implemented], 18, "RegisterComponents"], [[carbon, carbon.method, impl, impl.implemented], 18, "UnRegisterComponents"], [[carbon, carbon.method, impl, impl.implemented], 18, "HasTransparentBatches"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Instance stream, vertex declaration and realized LOD allocations are not ported yet; Trinity records their canonical geometry source and instance count.")], 18, "GetBatches"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetSortValue"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("The length-1 out array replaces the float& out-param; the shadow math is ported, including exactly which paths write the out value.")], 18, "IsCastingShadow"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Instance stream, vertex declaration and LOD allocations (cpp:2227-2250) are not ported; the batch records the geometry source, turret effect, per-object data and the CPU-known instance count meanwhile.")], 18, "GetShadowBatches"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Trinity fills the CPU-known EveTurretSet VS/PS RawData fields; bone-palette ring offsets and IsGood/GetMeshCount realization gates are not ported yet, while the CPU gate is geometry presence.")], 18, "GetPerObjectData"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetShadowPerObjectData"]], 0, void 0, _EveEntity));
+      }), carbon.inherit(ITr2Renderable)], [[[edit, edit.notify, edit, edit.persist, type, type.int32, void 0, type.enum("ImpactBehaviour")], 16, "impactBehaviour"], [type.objectRef("EveTurretFiringFX"), 0, "firingEffect"], [[edit, edit.persistOnly, void 0, type.model("IEveSpaceObjectChild")], 16, "ambientEffect"], [[edit, edit.persist, type, type.string], 16, "name"], [[edit, edit.persist, type, type.string], 16, "firingEffectResPath"], [[edit, edit.persist, type, type.boolean], 16, "chooseRandomLocator"], [[edit, edit.persist, type, type.vec4], 16, "boundingSphere"], [[edit, edit.persist, type, type.boolean], 16, "randomizeExplosionRotation"], [[edit, edit.read, type, type.int32, void 0, type.enum("LOD")], 16, "lodLevel"], [[edit, edit.read, type, type.uint32], 16, "currentCyclingFiresPos"], [[edit, edit.persist, type, type.boolean], 16, "useRandomFiringDelay"], [[edit, edit.persist, type, type.float32], 16, "bottomClipHeight"], [[edit, edit.read, void 0, type.objectRef("TriGeometryRes")], 16, "geometryResource"], [[edit, edit.persist, type, type.float32], 16, "maxTrackingTime"], [[edit, edit.read, type, type.uint32], 16, "visibleCount"], [[edit, edit.read, type, type.float32], 16, "trackingInfluence"], [[edit, edit.readwrite, type, type.uint32], 16, "swarmID"], [[edit, edit.persist, type, type.uint32], 16, "maxCyclingFirePos"], [[edit, edit.persist, type, type.boolean], 16, "playMovementSound"], [[edit, edit.readwrite, type, type.boolean], 16, "isOnline"], [[edit, edit.read, void 0, type.objectRef("EveTurretTarget")], 16, "target"], [[edit, edit.persist, type, type.string], 16, "locatorName"], [[edit, edit.persist, type, type.float32], 16, "sysBonePitchFactor"], [[edit, edit.persist, type, type.float32], 16, "sysBonePitchMax"], [[edit, edit.persist, type, type.float32], 16, "sysBonePitchMin"], [[edit, edit.persist, type, type.float32], 16, "sysBonePitchOffset"], [[edit, edit.persist, type, type.float32], 16, "sysBonePitch01Factor"], [[edit, edit.persist, type, type.float32], 16, "sysBonePitch01Offset"], [[edit, edit.persist, type, type.float32], 16, "sysBonePitch02Factor"], [[edit, edit.persist, type, type.float32], 16, "sysBonePitch02Offset"], [[edit, edit.persist, type, type.float32], 16, "sysBonePitch03Factor"], [[edit, edit.persist, type, type.float32], 16, "sysBonePitch03Offset"], [[edit, edit.persist, type, type.boolean], 16, "updatePitchPose"], [[edit, edit.notify, edit, edit.persist, type, type.string], 16, "geometryResPath"], [[edit, edit.persist, type, type.float32], 16, "impactSize"], [[edit, edit.persist, type, type.int32, void 0, type.enum("State")], 16, "state"], [[edit, edit.persist, type, type.float32], 16, "sysBoneHeight"], [[edit, edit.read, type, type.float32], 16, "randomFiringDelay"], [[edit, edit.persist, void 0, type.model("Tr2Effect")], 16, "turretEffect"], [[edit, edit.persist, type, type.string], 16, "idleToTargetingMovementAudioEvent"], [[edit, edit.persist, type, type.string], 16, "targetingToIdleMovementAudioEvent"], [[edit, edit.read, void 0, type.objectRef("EveChildInstanceContainer")], 16, "generatedDistributedAmbientEffect"], [[edit, edit.persist, type, type.uint32], 16, "cyclingFireGroupCount"], [[edit, edit.persist, void 0, type.model("TriObserverLocal")], 16, "turretMovementObserver"], [[edit, edit.readwrite, type, type.int32], 16, "slotNumber"], [[edit, edit.notify, edit, edit.readwrite, type, type.boolean], 16, "ambientEffectEditingMode"], [[edit, edit.readwrite, type, type.boolean], 16, "displayEffects"], [[edit, edit.readwrite, type, type.boolean], 16, "display"], [[edit, edit.notify, edit, edit.persist, type, type.boolean], 16, "useDynamicBounds"], [[edit, edit.read, type, type.float32], 16, "estimatedPixelDiameter"], [[edit, edit.persist, type, type.vec3], 16, "lowLodFiringEffectScale"], [[edit, edit.persist, type, type.vec3], 16, "lowLodFiringEffectTranslation"], [[edit, edit.persist, type, type.quat], 16, "lowLodFiringEffectRotation"], [[edit, edit.persist, type, type.boolean], 16, "useLowLodFiringTransform"], [[edit, edit.persist, type, type.boolean], 16, "laserMissBehaviour"], [[edit, edit.persist, type, type.boolean], 16, "projectileMissBehaviour"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Geometry resources are duck-typed; the runtime Trinity layer stores their computed sphere without creating render buffers.")], 18, "RebuildBoundingSphere"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Animation calls are forwarded to hydrated turret/controller objects without Carbon's Granny controller.")], 18, "ForceStateDeactive"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Animation calls are forwarded to hydrated turret/controller objects without Carbon's Granny controller.")], 18, "ForceStateTargeting"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("The graph freezes its LOD state; geometry creation is not ported yet.")], 18, "FreezeHighDetailLOD"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetShader"], [[impl, impl.adapted, void 0, impl.reason("Carbon's by-value embed becomes an accessor because the pose pipeline (the aiming consumer) lives behind the animation seam.")], 18, "GetAiming"], [[impl, impl.custom, void 0, impl.reason("The combined runtime keeps SOF independently importable by putting the nominal Tr2Effect application boundary on the owning turret class.")], 18, "ApplySofTurretMaterial"], [[impl, impl.custom, void 0, impl.reason("The combined runtime keeps SOF independently importable, so the Tr2Effect half of Carbon's EveSOF helper lives beside the turret classes that own the effects.")], 26, "applyFactionToTurretShader"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetShotTimeVariance"], [[carbon, carbon.method, impl, impl.implemented], 18, "MissQueueSize"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetLastShotTime"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Animation calls are forwarded to hydrated turret/controller objects without Carbon's Granny controller.")], 18, "EnterStateDeactive"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Carbon's geometry/animation selection is represented by portable turret records and controller forwarding.")], 18, "EnterStateFiring"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Animation calls are forwarded to hydrated turret/controller objects without Carbon's Granny controller.")], 18, "EnterStateIdle"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Animation calls are forwarded to hydrated turret/controller objects without Carbon's Granny controller.")], 18, "EnterStateReloading"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Animation calls are forwarded to hydrated turret/controller objects without Carbon's Granny controller.")], 18, "EnterStateTargeting"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Controller ownership is represented by direct firing/ambient child forwarding.")], 18, "HandleControllerEvent"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Portable turret records and duck-typed geometry bone transforms replace Carbon's CMF/Granny split.")], 18, "GetFiringBoneWorldTransform"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Controller ownership is represented by direct firing/ambient child forwarding.")], 18, "SetControllerVariable"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetShotMissed"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Controller ownership is represented by direct firing/ambient child forwarding.")], 18, "StartControllers"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("InitializeGeometryResource and the granny skeleton load are not ported; Carbon calls them from here (cpp:146-165).")], 18, "Initialize"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("JS dispatches the native hook using the exposed member name; existing class-owned rendering/resource adaptations remain unchanged.")], 18, "OnModified"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetFiringEffect"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Carbon QueryInterface target attachment is delegated to EveTurretTarget's browser-compatible target validation.")], 18, "SetTargetObject"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetTargetObject"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetTargetScale"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Carbon builds hidden SingleTurret records from geometry locators; browser hosts may provide equivalent portable records directly.")], 18, "SetTurrets"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Carbon builds hidden SingleTurret records from geometry locators; browser hosts may provide equivalent portable records directly.")], 18, "AddTurret"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetTurrets"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Portable records replace Carbon's CMF/Granny SingleTurretData allocation while retaining its fixed 24-turret limit and scale removal.")], 18, "SetLocalTransform"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetParentTransform"], [[carbon, carbon.method, impl, impl.implemented], 18, "UpdateTurretTransforms"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("The closest portable turret is selected from its world up-axis and the target tracking position.")], 18, "GetClosestTurret"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("This combined browser convenience update runs Carbon's explicit synchronous and asynchronous phases in order.")], 18, "Update"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Animation cleanup and task dispatch are forwarded through portable records; target and firing timing remain source-faithful.")], 18, "UpdateSyncronous"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Skeleton realization is not ported yet; portable turret records may consume the same local-target tracking hook.")], 18, "UpdateAsyncronous"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Renderable collection is backend-neutral; geometry and batch realization are not ported yet.")], 18, "GetRenderables"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Visibility is forwarded through backend-neutral firing and ambient graph contracts.")], 18, "UpdateVisibility"], [[carbon, carbon.method, impl, impl.implemented], 18, "RegisterComponents"], [[carbon, carbon.method, impl, impl.implemented], 18, "UnRegisterComponents"], [[carbon, carbon.method, impl, impl.implemented], 18, "HasTransparentBatches"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Instance stream, vertex declaration and realized LOD allocations are not ported yet; Trinity records their canonical geometry source and instance count.")], 18, "GetBatches"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetSortValue"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("The length-1 out array replaces the float& out-param; the shadow math is ported, including exactly which paths write the out value.")], 18, "IsCastingShadow"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Instance stream, vertex declaration and LOD allocations (cpp:2227-2250) are not ported; the batch records the geometry source, turret effect, per-object data and the CPU-known instance count meanwhile.")], 18, "GetShadowBatches"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Trinity fills the CPU-known EveTurretSet VS/PS RawData fields; bone-palette ring offsets and IsGood/GetMeshCount realization gates are not ported yet, while the CPU gate is geometry presence.")], 18, "GetPerObjectData"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetShadowPerObjectData"]], 0, void 0, _EveEntity));
+      _initStatic(this);
     }
     /** m_impactBehaviour (ImpactBehaviour::Type - enum ImpactBehaviour) [READWRITE, NOTIFY, PERSIST, ENUM] */
     impactBehaviour = (_initProto(this), _init_impactBehaviour(this, 0));
@@ -221,16 +222,16 @@ new class extends _identity {
     /** m_shipTransformPrev - last frame's parent transform, for motion vectors. */
     #shipTransformPrev = mat4.create();
 
-    /**
-     * m_parentData - the hull values an attachment renders with, refreshed by the
-     * parent through IEveSpaceObject2::GetParentData.
+    /**
+     * m_parentData - the hull values an attachment renders with, refreshed by the
+     * parent through IEveSpaceObject2::GetParentData.
      */
     #parentData = {};
 
-    /**
-     * m_skeletonBoneIndices - the shader's bone mapping, shared by every turret
-     * of the set. Skeleton realization is not ported yet, so this stays empty until
-     * one is supplied and the default count applies.
+    /**
+     * m_skeletonBoneIndices - the shader's bone mapping, shared by every turret
+     * of the set. Skeleton realization is not ported yet, so this stays empty until
+     * one is supplied and the default count applies.
      */
     #skeletonBoneIndices = [];
 
@@ -291,12 +292,12 @@ new class extends _identity {
       return this.turretEffect;
     }
 
-    /**
-     * The shared sysbone aiming math, synced from this set's flat tuning
-     * fields. Carbon embeds EveTurretAiming by value (EveTurretSet.h:425) and
-     * re-exposes its members as these flat Blue attributes; pose-owning
-     * consumers of the UpdateTrackingPose seam use THIS object so both hosts
-     * run identical math.
+    /**
+     * The shared sysbone aiming math, synced from this set's flat tuning
+     * fields. Carbon embeds EveTurretAiming by value (EveTurretSet.h:423) and
+     * re-exposes its members as these flat Blue attributes; pose-owning
+     * consumers of the UpdateTrackingPose seam use THIS object so both hosts
+     * run identical math.
      */
     GetAiming() {
       const aiming = this.#aiming;
@@ -315,15 +316,29 @@ new class extends _identity {
     }
     #aiming = new EveTurretAiming();
 
-    /**
-     * Applies resolved SOF vec4 values to the turret effect's constant path, or
-     * to its nominal vector-parameter path when no constants are authored.
+    /**
+     * Applies resolved SOF vec4 values to the turret effect's constant path, or
+     * to its nominal vector-parameter path when no constants are authored.
      */
     ApplySofTurretMaterial(resolveParameter) {
       const effect = this.GetShader();
       if (!effect) {
         return false;
       }
+      return _EveTurretSet.applyFactionToTurretShader(effect, resolveParameter);
+    }
+
+    /**
+     * The effect-walking half of Carbon's private EveSOF::ApplyFactionToTurretShader
+     * (EveSOF.cpp:4201-4254): overwrites a turret effect's constants, or its
+     * vec4 parameters when no constants are authored, with resolved SOF values.
+     * Shared by the ship turret set and EveChildTurret; the value resolution
+     * stays in SOF, which cannot import this layer.
+     * @param {Object} effect - a Tr2Effect
+     * @param {Function} resolveParameter - parameter name -> vec4 or null
+     * @returns {Boolean} true
+     */
+    static applyFactionToTurretShader(effect, resolveParameter) {
       if (effect.constParameters.length) {
         effect.StartUpdate();
         try {
@@ -356,19 +371,19 @@ new class extends _identity {
       return true;
     }
 
-    /** Carbon method GetShotTimeVariance (MAP_METHOD_AND_WRAP). */
+    /** Carbon method GetShotTimeVariance (EveTurretSet.h:223-226). */
     GetShotTimeVariance() {
-      return 0.6;
+      return EVE_TURRET_RANDOM_DELAY_MAX;
     }
 
-    /** Carbon method MissQueueSize (MAP_METHOD_AND_WRAP). */
+    /** Carbon method MissQueueSize (EveTurretSet.cpp:3597-3600). */
     MissQueueSize() {
-      return this.target?.MissQueueSize?.() ?? 0;
+      return this.target.MissQueueSize();
     }
 
-    /** Carbon method GetLastShotTime (MAP_METHOD_AND_WRAP). */
+    /** Carbon method GetLastShotTime (EveTurretSet.cpp:3606-3609). */
     GetLastShotTime() {
-      return this.target?.GetLastShotTime?.() ?? 0;
+      return this.target.GetLastShotTime();
     }
 
     /** Carbon method EnterStateDeactive (MAP_METHOD_AND_WRAP). */
@@ -523,9 +538,9 @@ new class extends _identity {
       this.#ambientEffect()?.StartControllers();
     }
 
-    /**
-     * Creates the target when absent, pushes the authored miss and impact
-     * behaviour into it, and initializes the firing and ambient effects.
+    /**
+     * Creates the target when absent, pushes the authored miss and impact
+     * behaviour into it, and initializes the firing and ambient effects.
      */
     Initialize() {
       this.target ??= new _EveTurretTarget();
@@ -535,16 +550,16 @@ new class extends _identity {
       return true;
     }
 
-    /**
-     * Carbon OnModified (EveTurretSet.cpp:167-201). FIVE arms, and they are an
-     * `else if` CHAIN: Carbon is notified once per changed member, so exactly one
-     * arm runs per notification.
-     *
-     * Our settle reports a whole write instead, so the chain is evaluated against
-     * the values last seen rather than against a Be::Var pointer - one arm per
-     * settle, in the donor's order. Every arm stays present even where its body
-     * is unported, because removing one would let a change fall through to the
-     * next arm and run work the donor would not have run.
+    /**
+     * Carbon OnModified (EveTurretSet.cpp:167-201). FIVE arms, and they are an
+     * `else if` CHAIN: Carbon is notified once per changed member, so exactly one
+     * arm runs per notification.
+     *
+     * Our settle reports a whole write instead, so the chain is evaluated against
+     * the values last seen rather than against a Be::Var pointer - one arm per
+     * settle, in the donor's order. Every arm stays present even where its body
+     * is unported, because removing one would let a change fall through to the
+     * next arm and run work the donor would not have run.
      */
     OnModified(propertyName) {
       if (propertyName === "display") {
@@ -566,13 +581,16 @@ new class extends _identity {
       this.firingEffect?.Initialize();
     }
 
-    /**
-     * Offers an object to the target for validation; on acceptance it sends the
-     * idle-to-targeting movement audio event when coming from idle or switching
-     * targets, and rescales the firing effect to the new target's radius. Returns
-     * whether the object was accepted.
+    /**
+     * Offers an object to the target for validation; on acceptance it sends the
+     * idle-to-targeting movement audio event when coming from idle or switching
+     * targets, and rescales the firing effect to the new target's radius. Returns
+     * whether the object was accepted.
      */
     SetTargetObject(object) {
+      // Carbon EveTurretSet.cpp:3630-3633: the ship set cannot clear its target;
+      // only EveChildTurret passes null through to EveTurretTarget.
+      if (!object) return false;
       this.target ??= new _EveTurretTarget();
       const previous = this.target.GetTargetable?.();
       const accepted = this.target.SetTargetable(object);
@@ -590,17 +608,17 @@ new class extends _identity {
       return this.target?.GetTargetable?.() ?? null;
     }
 
-    /**
-     * Rescales the firing effect from the target's radius, passing -1 when there
-     * is no target.
+    /**
+     * Rescales the firing effect from the target's radius, passing -1 when there
+     * is no target.
      */
     SetTargetScale() {
       this.firingEffect?.SetScaleByRadius?.(this.target?.GetRadius?.() ?? -1);
     }
 
-    /**
-     * Replaces the turret records, truncated to the fixed 24-turret limit,
-     * normalizing each into the record shape and resetting visibleCount.
+    /**
+     * Replaces the turret records, truncated to the fixed 24-turret limit,
+     * normalizing each into the record shape and resetting visibleCount.
      */
     SetTurrets(turrets = []) {
       this.#turrets = Array.from(turrets).slice(0, _EveTurretSet.MAX_TURRETS_PER_SET).map(turret => this.#normalizeTurret(turret));
@@ -608,9 +626,9 @@ new class extends _identity {
       return this.#turrets;
     }
 
-    /**
-     * Appends one normalized turret record and returns it, or null once the fixed
-     * 24-turret limit is reached.
+    /**
+     * Appends one normalized turret record and returns it, or null once the fixed
+     * 24-turret limit is reached.
      */
     AddTurret(turret) {
       if (this.#turrets.length >= _EveTurretSet.MAX_TURRETS_PER_SET) return null;
@@ -620,9 +638,9 @@ new class extends _identity {
       return value;
     }
 
-    /**
-     * The live turret record list; the records are mutated in place by
-     * UpdateTurretTransforms, so this is not a snapshot.
+    /**
+     * The live turret record list; the records are mutated in place by
+     * UpdateTurretTransforms, so this is not a snapshot.
      */
     GetTurrets() {
       return this.#turrets;
@@ -651,19 +669,19 @@ new class extends _identity {
       return true;
     }
 
-    /**
-     * Stores the hull transform and immediately recomputes every turret's world
-     * matrix from it.
+    /**
+     * Stores the hull transform and immediately recomputes every turret's world
+     * matrix from it.
      */
     SetParentTransform(transform) {
       mat4.copy(this.#parentTransform, transform);
       this.UpdateTurretTransforms(transform);
     }
 
-    /**
-     * Recomputes each turret's world matrix as the parent transform applied to its
-     * local matrix and marks the record valid; defaults to the stored parent
-     * transform.
+    /**
+     * Recomputes each turret's world matrix as the parent transform applied to its
+     * local matrix and marks the record valid; defaults to the stored parent
+     * transform.
      */
     UpdateTurretTransforms(parentTransform = this.#parentTransform) {
       mat4.copy(this.#parentTransform, parentTransform);
@@ -673,17 +691,17 @@ new class extends _identity {
       }
     }
 
-    /**
-     * The index of the turret whose world up axis points most directly at its
-     * nearest damage locator, or 0 when no valid turret is found.
+    /**
+     * The index of the turret whose world up axis points most directly at its
+     * nearest damage locator, or 0 when no valid turret is found.
      */
     GetClosestTurret() {
       return this.#getClosestTurretAndLocator().turret;
     }
 
-    /**
-     * Convenience update that runs the synchronous then asynchronous phase against
-     * the stored parent transform.
+    /**
+     * Convenience update that runs the synchronous then asynchronous phase against
+     * the stored parent transform.
      */
     Update(context) {
       this.UpdateSyncronous(context);
@@ -691,11 +709,11 @@ new class extends _identity {
       return true;
     }
 
-    /**
-     * Runs the synchronous phase: while a looping effect fires it re-picks the
-     * turret and locator every two seconds, then updates the firing effect, feeds
-     * the target the current muzzle start position, and updates the ambient effect
-     * and movement observer from the first turret.
+    /**
+     * Runs the synchronous phase: while a looping effect fires it re-picks the
+     * turret and locator every two seconds, then updates the firing effect, feeds
+     * the target the current muzzle start position, and updates the ambient effect
+     * and movement observer from the first turret.
      */
     UpdateSyncronous(context, parentTransform = this.#parentTransform) {
       const deltaTime = Number(context?.GetDeltaT?.() ?? context?.deltaTime ?? context?.deltaT ?? 0);
@@ -722,12 +740,12 @@ new class extends _identity {
       return true;
     }
 
-    /**
-     * Runs the asynchronous phase: recomputes the turret world matrices, ramps the
-     * tracking influence through its fade-in and fade-out delays, pushes the
-     * target position into each valid turret's tracking pose in that turret's
-     * local space, then hands the firing effect its end position and per-muzzle
-     * world transforms.
+    /**
+     * Runs the asynchronous phase: recomputes the turret world matrices, ramps the
+     * tracking influence through its fade-in and fade-out delays, pushes the
+     * target position into each valid turret's tracking pose in that turret's
+     * local space, then hands the firing effect its end position and per-muzzle
+     * world transforms.
      */
     UpdateAsyncronous(context, parentData = this.#parentTransform) {
       const deltaTime = Number(context?.GetDeltaT?.() ?? context?.deltaTime ?? context?.deltaT ?? 0);
@@ -791,9 +809,9 @@ new class extends _identity {
       return true;
     }
 
-    /**
-     * Appends the firing and ambient effect renderables to out; gated on display,
-     * and each contribution additionally on displayEffects.
+    /**
+     * Appends the firing and ambient effect renderables to out; gated on display,
+     * and each contribution additionally on displayEffects.
      */
     GetRenderables(out = []) {
       if (!this.display) return out;
@@ -802,10 +820,10 @@ new class extends _identity {
       return out;
     }
 
-    /**
-     * Forwards visibility to the firing and ambient effects; gated on display and,
-     * per effect, on displayEffects. The turret geometry itself is not culled
-     * here.
+    /**
+     * Forwards visibility to the firing and ambient effects; gated on display and,
+     * per effect, on displayEffects. The turret geometry itself is not culled
+     * here.
      */
     UpdateVisibility(context) {
       if (!this.display) return false;
@@ -814,9 +832,9 @@ new class extends _identity {
       return true;
     }
 
-    /** Carbon EveTurretSet::RegisterComponents (cpp:238-256): ShadowCaster leaf
-     * self-registration, then forwards the firing effect and the ambient effect
-     * (GetAmbientEffectOrGeneratedEffect, mirrored by #ambientEffect). Gate
+    /** Carbon EveTurretSet::RegisterComponents (cpp:238-256): ShadowCaster leaf
+     * self-registration, then forwards the firing effect and the ambient effect
+     * (GetAmbientEffectOrGeneratedEffect, mirrored by #ambientEffect). Gate
      * m_display. */
     RegisterComponents() {
       const registry = this.GetComponentRegistry();
@@ -827,8 +845,8 @@ new class extends _identity {
       }
     }
 
-    /** Carbon EveTurretSet::UnRegisterComponents (cpp:258-274): forwards the
-     * firing and ambient effects only (own components were already removed by
+    /** Carbon EveTurretSet::UnRegisterComponents (cpp:258-274): forwards the
+     * firing and ambient effects only (own components were already removed by
      * EveEntity::UnRegister, EveEntity.cpp:90); no display re-check. */
     UnRegisterComponents() {
       const registry = this.GetComponentRegistry();
@@ -843,11 +861,11 @@ new class extends _identity {
       return false;
     }
 
-    /**
-     * Emits Carbon's single opaque instanced turret batch. The geometry source
-     * and instance count are portable; the engine resolves allocations and the
-     * instance stream during realization.
-     * @returns {Boolean} whether the batch was committed
+    /**
+     * Emits Carbon's single opaque instanced turret batch. The geometry source
+     * and instance count are portable; the engine resolves allocations and the
+     * instance stream during realization.
+     * @returns {Boolean} whether the batch was committed
      */
     GetBatches(batches, batchType, perObjectData, _reason) {
       if (batchType !== TriBatchType.TRIBATCHTYPE_OPAQUE || !this.display || !this.visibleCount || !this.geometryResource) {
@@ -869,15 +887,15 @@ new class extends _identity {
       return 1;
     }
 
-    /** Carbon EveTurretSet::IsCastingShadow (cpp:2022-2051): after the
-     * display/geometry (cpp:2024) and reflection-reason (cpp:2029) early-outs -
-     * which do NOT write the out-param, so a stale previous-caster value
-     * survives at the scene call sites (EveSpaceScene.cpp:2391/2517) - the
-     * SET-level bounding sphere is transformed by EVERY turret's world matrix
-     * (including invisible ones - no per-turret visibility gate, unlike
-     * UpdateVisibility cpp:2070-2088), gated on transformed radius > 0, culled
-     * with shadowFrustum.IsVisible, and the MAX GetSizeInShadow accumulates.
-     * Returns sizeInShadow > 5 (the swarm uses 15). Carbon's float& out-param
+    /** Carbon EveTurretSet::IsCastingShadow (cpp:2022-2051): after the
+     * display/geometry (cpp:2024) and reflection-reason (cpp:2029) early-outs -
+     * which do NOT write the out-param, so a stale previous-caster value
+     * survives at the scene call sites (EveSpaceScene.cpp:2391/2517) - the
+     * SET-level bounding sphere is transformed by EVERY turret's world matrix
+     * (including invisible ones - no per-turret visibility gate, unlike
+     * UpdateVisibility cpp:2070-2088), gated on transformed radius > 0, culled
+     * with shadowFrustum.IsVisible, and the MAX GetSizeInShadow accumulates.
+     * Returns sizeInShadow > 5 (the swarm uses 15). Carbon's float& out-param
      * becomes the optional trailing length-1 array (out-params last). */
     IsCastingShadow(cameraFrustum, shadowFrustum, renderReason, sizeInShadowOut = null) {
       if (!this.display || !this.geometryResource) {
@@ -904,15 +922,15 @@ new class extends _identity {
       return sizeInShadow > 5;
     }
 
-    /** Carbon EveTurretSet::GetShadowBatches (cpp:2221-2254): one instanced
-     * batch for the whole turret geometry - material m_turretEffect, instance
-     * count m_visibleCount, mesh 0 at the lowest LOD. QUIRK: shadowPixelSize is
-     * completely IGNORED (always GetMeshLod(0, 0), cpp:2235) - the swarm uses
-     * it for LOD, the turret does not. The shadow path commits without the
-     * normal path's validity check (cpp:2253 vs 2211) - equivalent here because
-     * Commit drops invalid batches. Returns whether the batch was committed
-     * (JS addition; Carbon returns void). NOTE: JS visibleCount is currently
-     * the total turret count (the adapted UpdateVisibility does no per-turret
+    /** Carbon EveTurretSet::GetShadowBatches (cpp:2221-2254): one instanced
+     * batch for the whole turret geometry - material m_turretEffect, instance
+     * count m_visibleCount, mesh 0 at the lowest LOD. QUIRK: shadowPixelSize is
+     * completely IGNORED (always GetMeshLod(0, 0), cpp:2235) - the swarm uses
+     * it for LOD, the turret does not. The shadow path commits without the
+     * normal path's validity check (cpp:2253 vs 2211) - equivalent here because
+     * Commit drops invalid batches. Returns whether the batch was committed
+     * (JS addition; Carbon returns void). NOTE: JS visibleCount is currently
+     * the total turret count (the adapted UpdateVisibility does no per-turret
      * frustum cull), a pre-existing adaptation. */
     GetShadowBatches(batches, perObjectData, _shadowPixelSize) {
       if (!this.display || !this.visibleCount) {
@@ -932,13 +950,13 @@ new class extends _identity {
       return batches.Commit(batch);
     }
 
-    /** Carbon EveTurretSet::GetPerObjectData (cpp:2275-2518): early-outs on a
-     * missing/bad geometry resource RETURN NULL - and the cascade path stores
-     * that null and still calls GetShadowBatches with it (EveSpaceScene.cpp:
-     * 717/727), so a null per-object record on a batch is legal. The
-     * EveTurretSetPerObjectData fill includes the ship matrices, compacted
-     * per-visible turret SRT arrays, and the SH/clip PS block (cpp:2300-2511).
-     * Trinity fills every CPU-known field in canonical RawData. Only the bone
+    /** Carbon EveTurretSet::GetPerObjectData (cpp:2275-2518): early-outs on a
+     * missing/bad geometry resource RETURN NULL - and the cascade path stores
+     * that null and still calls GetShadowBatches with it (EveSpaceScene.cpp:
+     * 717/727), so a null per-object record on a batch is legal. The
+     * EveTurretSetPerObjectData fill includes the ship matrices, compacted
+     * per-visible turret SRT arrays, and the SH/clip PS block (cpp:2300-2511).
+     * Trinity fills every CPU-known field in canonical RawData. Only the bone
      * palette's GPU ring-buffer offsets remain engine-supplied. */
     GetPerObjectData(accumulator = null) {
       if (!this.geometryResource || typeof accumulator?.Alloc !== "function") {
@@ -998,18 +1016,18 @@ new class extends _identity {
       };
     }
 
-    /** Carbon EveTurretSet::GetShadowPerObjectData (cpp:2520-2523): pure
+    /** Carbon EveTurretSet::GetShadowPerObjectData (cpp:2520-2523): pure
      * forward to GetPerObjectData. */
     GetShadowPerObjectData(accumulator = null) {
       return this.GetPerObjectData(accumulator);
     }
 
-    /**
-     * Establishes everything one shot needs: the firing turret and locator, the
-     * advanced cycling fire position, the random firing delay, the fire animation
-     * on the chosen turret, the target's impact timing derived from the effect's
-     * duration and peak time, and the ambient controller's turret state. Returns
-     * false when deactivated or untargeted.
+    /**
+     * Establishes everything one shot needs: the firing turret and locator, the
+     * advanced cycling fire position, the random firing delay, the fire animation
+     * on the chosen turret, the target's impact timing derived from the effect's
+     * duration and peak time, and the ambient controller's turret state. Returns
+     * false when deactivated or untargeted.
      */
     #setupFiringState() {
       if (this.state === _EveTurretSet.State.STATE_DEACTIVE || !this.target) return false;
@@ -1040,11 +1058,11 @@ new class extends _identity {
       return true;
     }
 
-    /**
-     * Picks the turret whose world up axis best aligns with its nearest damage
-     * locator and, when chooseRandomLocator is set, re-picks the turret against a
-     * random valid locator instead; falls back to turret 0. Returns the shared
-     * pair record, valid only until the next call.
+    /**
+     * Picks the turret whose world up axis best aligns with its nearest damage
+     * locator and, when chooseRandomLocator is set, re-picks the turret against a
+     * random valid locator instead; falls back to turret 0. Returns the shared
+     * pair record, valid only until the next call.
      */
     #getClosestTurretAndLocator() {
       const pair = _EveTurretSet.#closestPair;
@@ -1095,9 +1113,9 @@ new class extends _identity {
       return pair;
     }
 
-    /**
-     * Plays an animation on every turret and returns the longest duration
-     * reported.
+    /**
+     * Plays an animation on every turret and returns the longest duration
+     * reported.
      */
     #playAll(animation, loop, delay) {
       let duration = 0;
@@ -1105,10 +1123,10 @@ new class extends _identity {
       return duration;
     }
 
-    /**
-     * Plays an animation on one turret through the record's own hook or its
-     * controller, returning the reported duration, or 0 when the turret or the
-     * hook is absent.
+    /**
+     * Plays an animation on one turret through the record's own hook or its
+     * controller, returning the reported duration, or 0 when the turret or the
+     * hook is absent.
      */
     #playTurret(index, animation, loop, delay) {
       const turret = this.#turrets[index];
@@ -1119,28 +1137,28 @@ new class extends _identity {
       }) ?? 0);
     }
 
-    /**
-     * The ambient effect in force: the authored one while in ambient-effect
-     * editing mode, otherwise the generated distributed instance container when
-     * one exists.
+    /**
+     * The ambient effect in force: the authored one while in ambient-effect
+     * editing mode, otherwise the generated distributed instance container when
+     * one exists.
      */
     #ambientEffect() {
       return this.ambientEffectEditingMode ? this.ambientEffect : this.generatedDistributedAmbientEffect ?? this.ambientEffect;
     }
 
-    /**
-     * Pushes the current state onto the ambient effect's TurretState controller
-     * variable.
+    /**
+     * Pushes the current state onto the ambient effect's TurretState controller
+     * variable.
      */
     #setAmbientState() {
       this.#ambientEffect()?.SetControllerVariable("TurretState", this.state);
     }
 
-    /**
-     * Coerces a caller-supplied turret into the record shape - local and world
-     * matrices, local quaternion and position, valid and display flags - reusing
-     * the object in place when it already carries a local matrix, and otherwise
-     * wrapping it as the record's source.
+    /**
+     * Coerces a caller-supplied turret into the record shape - local and world
+     * matrices, local quaternion and position, valid and display flags - reusing
+     * the object in place when it already carries a local matrix, and otherwise
+     * wrapping it as the record's source.
      */
     #normalizeTurret(turret) {
       if (turret?.localMatrix?.length === 16) {