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

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

@@ -1,5 +1,5 @@
 import { identity as _identity, applyDecs2311 as _applyDecs2311 } from '../../../../_virtual/_rollupPluginBabelHelpers.js';
-import { io, type, carbon, impl } from '#schema';
+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';
@@ -17,15 +17,14 @@ import '../../../core/batch/TriRenderBatch/EffectKeyGenerator.js';
 import '../../../core/batch/TriRenderBatch/ITriRenderBatchAccumulator.js';
 import '#consts/render-context';
 import { Tr2Vector4Parameter as _Tr2Vector4Parameter } from '../../../shader/parameter/Tr2Vector4Parameter.js';
-import { withITr2Renderable } from '../../../core/ITr2Renderable.js';
+import { ITr2Renderable } from '../../../core/ITr2Renderable.js';
 
-var _withITr2Renderable;
 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;
 
-/** 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);
@@ -36,7 +35,7 @@ function BoundingSphereTransform(transform, sphere) {
 /** Owns a hull's instanced turrets and drives their aiming, animation, firing, visibility, batches, shadows, and per-object data. */
 let _EveTurretSet;
 new class extends _identity {
-  static [class EveTurretSet extends (_withITr2Renderable = withITr2Renderable(_EveEntity)) {
+  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],
@@ -44,7 +43,7 @@ new class extends _identity {
       } = _applyDecs2311(this, [type.define({
         className: "EveTurretSet",
         family: "eve/attachment/turrets"
-      })], [[[io, io.notify, io, io.persist, type, type.int32, void 0, type.enum("ImpactBehaviour")], 16, "impactBehaviour"], [type.objectRef("EveTurretFiringFX"), 0, "firingEffect"], [[io, io.persistOnly, void 0, type.model("IEveSpaceObjectChild")], 16, "ambientEffect"], [[io, io.persist, type, type.string], 16, "name"], [[io, io.persist, type, type.string], 16, "firingEffectResPath"], [[io, io.persist, type, type.boolean], 16, "chooseRandomLocator"], [[io, io.persist, type, type.vec4], 16, "boundingSphere"], [[io, io.persist, type, type.boolean], 16, "randomizeExplosionRotation"], [[io, io.read, type, type.int32, void 0, type.enum("LOD")], 16, "lodLevel"], [[io, io.read, type, type.uint32], 16, "currentCyclingFiresPos"], [[io, io.persist, type, type.boolean], 16, "useRandomFiringDelay"], [[io, io.persist, type, type.float32], 16, "bottomClipHeight"], [[io, io.read, void 0, type.objectRef("TriGeometryRes")], 16, "geometryResource"], [[io, io.persist, type, type.float32], 16, "maxTrackingTime"], [[io, io.read, type, type.uint32], 16, "visibleCount"], [[io, io.read, type, type.float32], 16, "trackingInfluence"], [[io, io.readwrite, type, type.uint32], 16, "swarmID"], [[io, io.persist, type, type.uint32], 16, "maxCyclingFirePos"], [[io, io.persist, type, type.boolean], 16, "playMovementSound"], [[io, io.readwrite, type, type.boolean], 16, "isOnline"], [[io, io.read, void 0, type.objectRef("EveTurretTarget")], 16, "target"], [[io, io.persist, type, type.string], 16, "locatorName"], [[io, io.persist, type, type.float32], 16, "sysBonePitchFactor"], [[io, io.persist, type, type.float32], 16, "sysBonePitchMax"], [[io, io.persist, type, type.float32], 16, "sysBonePitchMin"], [[io, io.persist, type, type.float32], 16, "sysBonePitchOffset"], [[io, io.persist, type, type.float32], 16, "sysBonePitch01Factor"], [[io, io.persist, type, type.float32], 16, "sysBonePitch01Offset"], [[io, io.persist, type, type.float32], 16, "sysBonePitch02Factor"], [[io, io.persist, type, type.float32], 16, "sysBonePitch02Offset"], [[io, io.persist, type, type.float32], 16, "sysBonePitch03Factor"], [[io, io.persist, type, type.float32], 16, "sysBonePitch03Offset"], [[io, io.persist, type, type.boolean], 16, "updatePitchPose"], [[io, io.notify, io, io.persist, type, type.string], 16, "geometryResPath"], [[io, io.persist, type, type.float32], 16, "impactSize"], [[io, io.persist, type, type.int32, void 0, type.enum("State")], 16, "state"], [[io, io.persist, type, type.float32], 16, "sysBoneHeight"], [[io, io.read, type, type.float32], 16, "randomFiringDelay"], [[io, io.persist, void 0, type.model("Tr2Effect")], 16, "turretEffect"], [[io, io.persist, type, type.string], 16, "idleToTargetingMovementAudioEvent"], [[io, io.persist, type, type.string], 16, "targetingToIdleMovementAudioEvent"], [[io, io.read, void 0, type.objectRef("EveChildInstanceContainer")], 16, "generatedDistributedAmbientEffect"], [[io, io.persist, type, type.uint32], 16, "cyclingFireGroupCount"], [[io, io.persist, void 0, type.model("TriObserverLocal")], 16, "turretMovementObserver"], [[io, io.readwrite, type, type.int32], 16, "slotNumber"], [[io, io.notify, io, io.readwrite, type, type.boolean], 16, "ambientEffectEditingMode"], [[io, io.readwrite, type, type.boolean], 16, "displayEffects"], [[io, io.readwrite, type, type.boolean], 16, "display"], [[io, io.notify, io, io.persist, type, type.boolean], 16, "useDynamicBounds"], [[io, io.read, type, type.float32], 16, "estimatedPixelDiameter"], [[io, io.persist, type, type.vec3], 16, "lowLodFiringEffectScale"], [[io, io.persist, type, type.vec3], 16, "lowLodFiringEffectTranslation"], [[io, io.persist, type, type.quat], 16, "lowLodFiringEffectRotation"], [[io, io.persist, type, type.boolean], 16, "useLowLodFiringTransform"], [[io, io.persist, type, type.boolean], 16, "laserMissBehaviour"], [[io, io.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 realizing 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 realization remains a runtime-engine responsibility.")], 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("Resource loading and GPU preparation are engine responsibilities; Trinity initializes the target and owned behavior graph.")], 18, "Initialize"], [[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 engine-owned; 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 remain runtime-engine work.")], 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 engine-owned; 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 realized LOD allocations (cpp:2227-2250) are engine-owned; the batch records the geometry source, turret effect, per-object data and the CPU-known instance count for the engine to realize.")], 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 remain engine-owned, while the CPU gate is geometry presence.")], 18, "GetPerObjectData"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetShadowPerObjectData"]], 0, void 0, _withITr2Renderable));
+      }), 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));
     }
     /** m_impactBehaviour (ImpactBehaviour::Type - enum ImpactBehaviour) [READWRITE, NOTIFY, PERSIST, ENUM] */
     impactBehaviour = (_initProto(this), _init_impactBehaviour(this, 0));
@@ -213,22 +212,25 @@ new class extends _identity {
 
     /** m_projectileMissBehaviour (bool) [READWRITE, PERSIST] */
     projectileMissBehaviour = (_init_extra_laserMissBehaviour(this), _init_projectileMissBehaviour(this, false));
+
+    /** Values the OnModified chain compares against; null until first snapshot. */
+
     #turrets = (_init_extra_projectileMissBehaviour(this), []);
     #parentTransform = mat4.create();
 
     /** 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 engine-owned, 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 = [];
 
@@ -289,12 +291,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: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.
      */
     GetAiming() {
       const aiming = this.#aiming;
@@ -313,9 +315,9 @@ 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();
@@ -337,7 +339,13 @@ new class extends _identity {
         return true;
       }
       for (const parameter of effect.parameters) {
-        if (!(parameter instanceof _Tr2Vector4Parameter)) {
+        // Picking the vec4 entries out of a mixed parameter list. This names a
+        // LEAF CLASS because the family has no declared contract to ask for:
+        // Carbon derives it from ITriEffectParameter and ITriReroutable
+        // (Tr2Vector4Parameter.h:13-16) and our port put the shared behaviour on
+        // an invented CjsParameter instead. See
+        // .agents/parameter-family-missing-contracts.md.
+        if (!CjsSchema.cast(parameter, _Tr2Vector4Parameter)) {
           continue;
         }
         const value = resolveParameter(parameter.GetParameterName());
@@ -515,29 +523,54 @@ 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();
-      this.target.SetBehaviour?.(this.laserMissBehaviour, this.projectileMissBehaviour, this.impactSize, this.impactBehaviour);
+      this.target.SetBehaviour(this.laserMissBehaviour, this.projectileMissBehaviour, this.impactSize, this.impactBehaviour);
       this.firingEffect?.Initialize();
       this.#ambientEffect()?.Initialize();
       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.
+     */
+    OnModified(propertyName) {
+      if (propertyName === "display") {
+        this.ReRegister();
+      } else if (propertyName === "geometryResPath") {
+        this.ReRegister();
+        // Carbon reloads here (cpp:177, "new gr2 file specified -> reload!").
+        // InitializeGeometryResource is unported: it asks BeResMan for the
+        // geometry and re-attaches the notify target (cpp:252-290).
+      } else if (propertyName === "ambientEffectEditingMode") ; else if (propertyName === "laserMissBehaviour" || propertyName === "projectileMissBehaviour" || propertyName === "impactSize" || propertyName === "impactBehaviour") {
+        this.target.SetBehaviour(this.laserMissBehaviour, this.projectileMissBehaviour, this.impactSize, this.impactBehaviour);
+      } else ;
+      return true;
+    }
+
     /** Attaches the firing effect and initializes it immediately. */
     SetFiringEffect(effect) {
       this.firingEffect = effect ?? null;
       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) {
       this.target ??= new _EveTurretTarget();
@@ -557,17 +590,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));
@@ -575,9 +608,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;
@@ -587,9 +620,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;
@@ -618,19 +651,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);
@@ -640,17 +673,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);
@@ -658,11 +691,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);
@@ -689,12 +722,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);
@@ -758,9 +791,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;
@@ -769,10 +802,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;
@@ -781,9 +814,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();
@@ -794,8 +827,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();
@@ -810,11 +843,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) {
@@ -836,15 +869,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) {
@@ -871,15 +904,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) {
@@ -899,13 +932,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") {
@@ -965,18 +998,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;
@@ -1007,11 +1040,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;
@@ -1062,9 +1095,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;
@@ -1072,10 +1105,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];
@@ -1086,28 +1119,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) {