@carbonenginejs/runtime 0.1.0-alpha.0 → 0.1.0-alpha.2

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

@@ -10,18 +10,22 @@ import { vec3 } from '#math/vec3';
 import { vec4 } from '#math/vec4';
 import { TriBatchType } from '#consts/graphics';
 import { Tr2RenderReason } from '../../../generated/trinityCore/enums.js';
-import '../../../core/rawData/Tr2PerObjectData.js';
-import { Tr2RenderBatch } from '../../../core/batch/Tr2RenderBatch.js';
+import '../../../core/rawData/perObjectData/Tr2PerObjectData.js';
+import { Tr2RenderBatch } from '../../../core/batch/TriRenderBatch/Tr2RenderBatch.js';
+import '../../../core/batch/TriRenderBatch/DefaultKeyGenerator.js';
+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';
 
 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);
@@ -215,16 +219,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 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 engine-owned, so this stays empty until
+     * one is supplied and the default count applies.
      */
     #skeletonBoneIndices = [];
 
@@ -285,12 +289,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;
@@ -309,9 +313,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();
@@ -511,9 +515,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();
@@ -529,11 +533,11 @@ 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) {
       this.target ??= new _EveTurretTarget();
@@ -553,17 +557,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));
@@ -571,9 +575,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;
@@ -583,9 +587,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;
@@ -614,19 +618,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);
@@ -636,17 +640,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);
@@ -654,11 +658,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);
@@ -685,12 +689,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);
@@ -754,9 +758,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;
@@ -765,10 +769,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;
@@ -777,9 +781,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();
@@ -790,8 +794,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();
@@ -806,11 +810,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) {
@@ -832,15 +836,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) {
@@ -867,15 +871,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) {
@@ -895,13 +899,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") {
@@ -961,18 +965,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;
@@ -1003,11 +1007,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;
@@ -1058,9 +1062,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;
@@ -1068,10 +1072,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];
@@ -1082,28 +1086,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) {