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

package/dist/trinity/eve/spaceObject/EveSpaceObject2.js

@@ -19,8 +19,14 @@ import { EveLODHelper } from '../EveLODHelper.js';
 import { TriBatchType, ReflectionMode } from '#consts/graphics';
 import { MatrixCopyFrom3x4 } from '../lights/lightConversion.js';
 import { getBoneList } from '../../core/animation/Tr2GrannyAnimation.js';
-import '../../core/rawData/Tr2PerObjectData.js';
-import { TriRenderBatchAreaBlock, Tr2RenderBatch } from '../../core/batch/Tr2RenderBatch.js';
+import '../../core/rawData/perObjectData/Tr2PerObjectData.js';
+import { TriRenderBatchAreaBlock } from '../../core/batch/TriRenderBatch/TriRenderBatchAreaBlock.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 { Tr2RenderReason } from '../../generated/trinityCore/enums.js';
+import '#consts/render-context';
 import { Tr2EffectStateManager as _Tr2EffectStateManage } from '../../shader/Tr2EffectStateManager.js';
 import { CarbonVertexElements } from '../../core/vertex/vertexUsage.js';
 import { RawData } from '../../core/rawData/RawData.js';
@@ -32,7 +38,6 @@ import { EveLocatorSets as _EveLocatorSets, EveGetLocatorPose } from '../locator
 import { Locator as _Locator } from '../locator/Locator.js';
 import { TriPerlinCurve as _TriPerlinCurve } from '../../curves/curve/TriPerlinCurve.js';
 import { withITr2Renderable } from '../../core/ITr2Renderable.js';
-import { Tr2RenderReason } from '../../generated/trinityCore/enums.js';
 import { Tr2Lod } from '#consts/trinity';
 
 var _withIEveInheritPrope;
@@ -48,11 +53,11 @@ const TRANSPARENT_CENTER = vec3.create();
 const OVERLAY_TYPE_OPAQUEONLY = 0;
 const OVERLAY_TYPE_ALL = 1;
 
-/**
- * The hull of an EVE space object - its mesh, locators, locator sets, decals,
- * attachments, lights, effect children, overlay effects, impact overlay and
- * controllers - together with the curve-driven world transform, visibility, LOD
- * and batch submission that drive them each frame.
+/**
+ * The hull of an EVE space object - its mesh, locators, locator sets, decals,
+ * attachments, lights, effect children, overlay effects, impact overlay and
+ * controllers - together with the curve-driven world transform, visibility, LOD
+ * and batch submission that drive them each frame.
  */
 let _EveSpaceObject;
 new class extends _identity {
@@ -64,7 +69,7 @@ new class extends _identity {
       } = _applyDecs2311(this, [type.define({
         className: "EveSpaceObject2",
         family: "eve/spaceObject"
-      })], [[[io, io.notify, io, io.persist, type, type.int32, void 0, type.enum("ReflectionMode")], 16, "reflectionMode"], [[io, io.persist, void 0, type.list("IEveSpaceObjectChild")], 16, "effectChildren"], [[io, io.persist, void 0, type.list("IEveTransform")], 16, "children"], [[io, io.notify, io, io.persist, type, type.string], 16, "name"], [[io, io.notify, io, io.readwrite, type, type.boolean], 16, "mute"], [[io, io.readwrite, void 0, type.objectRef("EveChildInheritProperties")], 16, "inheritProperties"], [[io, io.persist, void 0, type.list("EveCustomMask")], 16, "customMasks"], [[io, io.persist, void 0, type.list("EveMeshOverlayEffect")], 16, "overlayEffects"], [[io, io.read, void 0, type.objectRef("Tr2BindingVector3")], 16, "positionDelta"], [[io, io.read, type, type.int32, void 0, type.enum("Tr2Lod")], 16, "lodLevel"], [[io, io.persist, void 0, type.list("TriCurveSet")], 16, "curveSets"], [[io, io.readwrite, type, type.boolean], 16, "isPickable"], [[io, io.read, type, type.float32], 16, "estimatedPixelDiameter"], [[io, io.read, type, type.float32], 16, "estimatedPixelDiameterWithChildren"], [[io, io.read, type, type.vec3], 16, "generatedShapeEllipsoidCenter"], [[io, io.read, type, type.vec3], 16, "generatedShapeEllipsoidRadius"], [[io, io.read, void 0, type.objectRef("Tr2GrannyAnimation")], 16, "animationUpdater"], [[io, io.persist, type, type.string], 16, "dna"], [[io, io.notify, io, io.persist, type, type.boolean], 16, "castShadow"], [[io, io.persist, type, type.boolean], 16, "isAnimated"], [[io, io.persist, type, type.boolean], 16, "dynamicBoundingSphereEnabled"], [[io, io.persist, void 0, type.list("IEveSpaceObjectAttachment")], 16, "attachments"], [[io, io.persist, void 0, type.list("EveSpaceObjectDecal")], 16, "decals"], [[io, io.notify, io, io.persist, void 0, type.list("Tr2Light")], 16, "lights"], [[io, io.persist, void 0, type.list("Tr2ExternalParameter")], 16, "externalParameters"], [[io, io.persist, void 0, type.list("ITr2Controller")], 16, "controllers"], [[io, io.persist, void 0, type.list("EveLocator2")], 16, "locators"], [[io, io.persist, void 0, type.objectRef("Tr2MeshBase")], 16, "mesh"], [[io, io.persist, void 0, type.objectRef("EveImpactOverlay")], 16, "impactOverlay"], [[io, io.persist, type, type.vec3], 16, "clipSphereCenter"], [[io, io.notify, io, io.readwrite, type, type.float32], 16, "clipSphereFactor2"], [[io, io.notify, io, io.readwrite, type, type.float32], 16, "clipSphereFactor"], [[io, io.persist, void 0, type.list("TriObserverLocal")], 16, "observers"], [[io, io.read, type, type.vec3], 16, "worldPosition"], [[io, io.persist, void 0, type.objectRef("ITriQuaternionFunction")], 16, "rotationCurve"], [[io, io.read, type, type.quat], 16, "worldRotation"], [[io, io.persist, type, type.float32], 16, "modelScale"], [[io, io.persist, void 0, type.list("EveLocatorSets")], 16, "locatorSets"], [[io, io.readwrite, type, type.float32], 16, "activationStrength"], [[io, io.readwrite, type, type.color], 16, "albedoColor"], [[io, io.notify, io, io.persist, type, type.boolean], 16, "display"], [[io, io.persist, type, type.boolean], 16, "update"], [[io, io.read, type, type.float32], 16, "secondaryLightingSphereRadius"], [[io, io.persist, type, type.vec3], 16, "boundingSphereCenter"], [[io, io.notify, io, io.readwrite, type, type.float32], 16, "dirtLevel"], [[io, io.readwrite, type, type.vec4], 16, "customShaderData"], [[io, io.read, type, type.vec4], 16, "spaceObjectShipData"], [[io, io.read, type, type.int32], 16, "lastDamageLocatorHit"], [[io, io.notify, io, io.readwrite, type, type.boolean], 16, "damageLocatorAutoFilterEnabled"], [[io, io.persist, type, type.float32], 16, "boundingSphereRadius"], [[io, io.read, type, type.vec3], 16, "modelWorldPosition"], [[io, io.persist, void 0, type.objectRef("ITriVectorFunction")], 16, "modelTranslationCurve"], [[io, io.persist, void 0, type.objectRef("ITriQuaternionFunction")], 16, "modelRotationCurve"], [[io, io.persist, type, type.vec3], 16, "shapeEllipsoidCenter"], [[io, io.persist, type, type.vec3], 16, "shapeEllipsoidRadius"], [[io, io.persist, void 0, type.objectRef("ITriVectorFunction")], 16, "translationCurve"], [[io, io.read, type, type.mat4], 16, "worldTransform"], [[io, io.read, type, type.mat4], 16, "inverseWorldTransform"], [[io, io.read, type, type.mat4], 16, "lastWorldTransform"], [[io, io.read, type, type.vec3], 16, "worldVelocity"], [[io, io.readwrite, void 0, type.objectRef("ITr2AudGeometry")], 16, "audioGeometry"], [[type, type.boolean], 16, "isVisible"], [[carbon, carbon.method, impl, impl.adapted], 18, "Initialize"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetMesh"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetMesh"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetOverlayEffects"], [[carbon, carbon.method, impl, impl.adapted], 18, "AddController"], [[carbon, carbon.method, impl, impl.implemented], 18, "AddObserver"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetInheritProperties"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetEffectChildByName"], [[carbon, carbon.method, impl, impl.adapted], 18, "AddToEffectChildrenList"], [[carbon, carbon.method, impl, impl.implemented], 18, "AddLight"], [[carbon, carbon.method, impl, impl.implemented], 18, "ClearLights"], [[carbon, carbon.method, impl, impl.implemented], 18, "RemoveFromEffectChildrenList"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetModelRotationCurve"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetModelRotationCurve"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetModelTranslationCurve"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetModelTranslationCurve"], [[carbon, carbon.method, impl, impl.adapted], 18, "UpdateWorldTransform"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("The browser runtime refreshes the cache with world-transform updates instead of Carbon's renderer-side PrepareShaderData pass.")], 18, "UpdateWorldBounds"], [[carbon, carbon.method, impl, impl.implemented], 18, "PrepareShaderData"], [[carbon, carbon.method, impl, impl.implemented], 18, "UpdateShLighting"], [[carbon, carbon.method, impl, impl.implemented], 18, "ClearShLighting"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetParentData"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetPerObjectStructs"], [[carbon, carbon.method, impl, impl.adapted], 18, "UpdateSyncronous"], [[carbon, carbon.method, impl, impl.adapted], 18, "UpdateAsyncronous"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Native impostor, raytracing, and audio-emitter realization remain engine-owned; graph visibility and LOD state are preserved.")], 18, "UpdateVisibility"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Impostor submission and decal mesh caches are engine-owned; Trinity returns the backend-neutral renderable graph.")], 18, "GetRenderables"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Overlay area-block batches are deferred; the view position arrives via the appended render-context argument instead of Carbon's renderer global.")], 18, "GetBatches"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Carbon rebuilds from the geometry-resource notify callback; the GPU-free port rebuilds lazily on first batch use from the mesh areas alone.")], 18, "RebuildCachedData"], [[carbon, carbon.method, impl, impl.implemented], 18, "ReleaseCachedData"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetPickingBatches"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetID"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Realized-LOD draw args are engine-resolved from the geometry source descriptor; primitive-count gating happens at realization.")], 18, "GetShadowBatches"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Overlay selection is fully represented in the CPU graph; realized-LOD draw arguments remain engine-owned.")], 18, "GetBatchesFromOverlayVector"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Portable mesh area access replaces Carbon's native mesh-area vectors.")], 18, "HasTransparentBatches"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Carbon reads the Tr2Renderer view-position global; the relocated camera state arrives via the threaded render context.")], 18, "GetSortValue"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Trinity retains and fills persistent VS/PS RawData; the engine owns device buffers, GPU-derived offsets, upload, and binding.")], 18, "GetPerObjectData"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetShadowPerObjectData"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetLights"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("The optional length-one array replaces Carbon's float& sizeInShadow out-parameter.")], 18, "IsCastingShadow"], [[carbon, carbon.method, impl, impl.implemented], 18, "RegisterComponents"], [[carbon, carbon.method, impl, impl.implemented], 18, "UnRegisterComponents"], [[carbon, carbon.method, impl, impl.implemented], 18, "DisplayChildren"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetObserverTransform"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetLocalToWorldTransform"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetModelCenterWorldPosition"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetWorldPosition"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetWorldRotation"], [[carbon, carbon.method, impl, impl.implemented], 18, "FindSoundEmitter"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetMute"], [[carbon, carbon.method, impl, impl.adapted], 18, "PlayAnimationEx"], [[carbon, carbon.method, impl, impl.adapted], 18, "CalculateSkinnedBoundingBoxFromTransform"], [[carbon, carbon.method, impl, impl.adapted], 18, "CalculateSkinnedBoundingSphere"], [[carbon, carbon.method, impl, impl.implemented], 18, "InvalidateMergedLocators"], [[carbon, carbon.method, impl, impl.adapted], 18, "EnsureChildLocatorMerged"], [[carbon, carbon.method, impl, impl.implemented], 18, "UpdateDamageLocatorFilter"], [[carbon, carbon.method, impl, impl.implemented], 18, "RunDamageLocatorFilter"], [[carbon, carbon.method, impl, impl.implemented], 18, "ClearImpactDamage"], [[carbon, carbon.method, impl, impl.implemented], 18, "ClearAnimations"], [[carbon, carbon.method, impl, impl.implemented], 18, "CreateImpactFromPosition"], [[carbon, carbon.method, impl, impl.adapted], 18, "CreateImpact"], [[carbon, carbon.method, impl, impl.implemented], 18, "EndAnimation"], [[carbon, carbon.method, impl, impl.implemented], 18, "FreezeHighDetailMesh"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetDamageLocatorCount"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetLocatorCount"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetLocatorsForSet"], [[carbon, carbon.method, impl, impl.implemented], 18, "MergeToLocatorSet"], [[carbon, carbon.method, impl, impl.implemented], 18, "AddLocatorSet"], [[carbon, carbon.method, impl, impl.implemented], 18, "ClearLocatorSets"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetCloseLocatorIndex"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetGoodLocatorIndex"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetDamageLocatorDirection"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("CarbonEngineJS keeps output parameters last and returns a validity flag for targetable callers.")], 18, "GetDamageLocatorPosition"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetDamageLocatorBindPosition"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetClosestDamageLocatorIndex"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("TriRand is represented by Math.random; all locator scoring remains source-faithful.")], 18, "GetGoodDamageLocatorIndex"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetRadius"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetMissPosition"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetImpactConfiguration"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetImpactOverlay"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetImpactOverlay"], [[carbon, carbon.method, impl, impl.implemented], 18, "HasImpactConfigurationShield"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("CarbonEngineJS uses an out-last signature; the ellipsoid intersection is otherwise source-faithful CPU math.")], 18, "GetImpactPosition"], [[carbon, carbon.method, impl, impl.implemented], 18, "UpdateImpact"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetDamageLocator"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetTransformedDamageLocator"], [[carbon, carbon.method, impl, impl.adapted], 18, "IsImpostor"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetLocatorPositionFromSet"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetLocatorRotationFromSet"], [[carbon, carbon.method, impl, impl.implemented], 18, "HandleControllerEvent"], [[carbon, carbon.method, impl, impl.adapted], 18, "PlayAnimation"], [[carbon, carbon.method, impl, impl.implemented], 18, "ChainAnimation"], [[carbon, carbon.method, impl, impl.implemented], 18, "ChainAnimationEx"], [[carbon, carbon.method, impl, impl.adapted], 18, "RebuildBoundingSphereInformation"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Carbon's CcpMath::Sphere is represented by core-math sph3; object-shaped center/radius input is accepted at adapter boundaries.")], 18, "SetBoundingSphereInformation"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetControllerVariables"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Geometry resources without multi-LOD support expose their sole browser LOD as index zero.")], 18, "GetLastUsedMeshLod"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetLocatorTransform"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetLocalBoundingBox"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetWorldBoundingBox"], [[carbon, carbon.method, impl, impl.implemented], 18, "IsBoundingBoxReady"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetBoundingSphere"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("TriFrustum is supplied structurally by the active engine; both exact and estimated browser frustum methods are supported.")], 18, "EstimatePixelDiameter"], [[carbon, carbon.method, impl, impl.implemented], 18, "IsInFrustum"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetBoundingSphereCenter"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetBoundingSphereRadius"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetBoneCount"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetImpactDamageState"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetImpactAnimation"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetControllerVariable"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetProceduralContainerVariable"], [[carbon, carbon.method, impl, impl.implemented], 18, "StartControllers"], [[carbon, carbon.method, impl, impl.adapted], 18, "TransformLocators"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetLocatorInObjectSpace"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetShapeEllipsoid"]], 0, void 0, _withIEveInheritPrope));
+      })], [[[io, io.notify, io, io.persist, type, type.int32, void 0, type.enum("ReflectionMode")], 16, "reflectionMode"], [[io, io.persist, void 0, type.list("IEveSpaceObjectChild")], 16, "effectChildren"], [[io, io.persist, void 0, type.list("IEveTransform")], 16, "children"], [[io, io.notify, io, io.persist, type, type.string], 16, "name"], [[io, io.notify, io, io.readwrite, type, type.boolean], 16, "mute"], [[io, io.readwrite, void 0, type.objectRef("EveChildInheritProperties")], 16, "inheritProperties"], [[io, io.persist, void 0, type.list("EveCustomMask")], 16, "customMasks"], [[io, io.persist, void 0, type.list("EveMeshOverlayEffect")], 16, "overlayEffects"], [[io, io.read, void 0, type.objectRef("Tr2BindingVector3")], 16, "positionDelta"], [[io, io.read, type, type.int32, void 0, type.enum("Tr2Lod")], 16, "lodLevel"], [[io, io.persist, void 0, type.list("TriCurveSet")], 16, "curveSets"], [[io, io.readwrite, type, type.boolean], 16, "isPickable"], [[io, io.read, type, type.float32], 16, "estimatedPixelDiameter"], [[io, io.read, type, type.float32], 16, "estimatedPixelDiameterWithChildren"], [[io, io.read, type, type.vec3], 16, "generatedShapeEllipsoidCenter"], [[io, io.read, type, type.vec3], 16, "generatedShapeEllipsoidRadius"], [[io, io.read, void 0, type.objectRef("Tr2GrannyAnimation")], 16, "animationUpdater"], [[io, io.persist, type, type.string], 16, "dna"], [[io, io.notify, io, io.persist, type, type.boolean], 16, "castShadow"], [[io, io.persist, type, type.boolean], 16, "isAnimated"], [[io, io.persist, type, type.boolean], 16, "dynamicBoundingSphereEnabled"], [[io, io.persist, void 0, type.list("IEveSpaceObjectAttachment")], 16, "attachments"], [[io, io.persist, void 0, type.list("EveSpaceObjectDecal")], 16, "decals"], [[io, io.notify, io, io.persist, void 0, type.list("Tr2Light")], 16, "lights"], [[io, io.persist, void 0, type.list("Tr2ExternalParameter")], 16, "externalParameters"], [[io, io.persist, void 0, type.list("ITr2Controller")], 16, "controllers"], [[io, io.persist, void 0, type.list("EveLocator2")], 16, "locators"], [[io, io.persist, void 0, type.objectRef("Tr2MeshBase")], 16, "mesh"], [[io, io.persist, void 0, type.objectRef("EveImpactOverlay")], 16, "impactOverlay"], [[io, io.persist, type, type.vec3], 16, "clipSphereCenter"], [[io, io.notify, io, io.readwrite, type, type.float32], 16, "clipSphereFactor2"], [[io, io.notify, io, io.readwrite, type, type.float32], 16, "clipSphereFactor"], [[io, io.persist, void 0, type.list("TriObserverLocal")], 16, "observers"], [[io, io.read, type, type.vec3], 16, "worldPosition"], [[io, io.persist, void 0, type.objectRef("ITriQuaternionFunction")], 16, "rotationCurve"], [[io, io.read, type, type.quat], 16, "worldRotation"], [[io, io.persist, type, type.float32], 16, "modelScale"], [[io, io.persist, void 0, type.list("EveLocatorSets")], 16, "locatorSets"], [[io, io.readwrite, type, type.float32], 16, "activationStrength"], [[io, io.readwrite, type, type.color], 16, "albedoColor"], [[io, io.notify, io, io.persist, type, type.boolean], 16, "display"], [[io, io.persist, type, type.boolean], 16, "update"], [[io, io.read, type, type.float32], 16, "secondaryLightingSphereRadius"], [[io, io.persist, type, type.vec3], 16, "boundingSphereCenter"], [[io, io.notify, io, io.readwrite, type, type.float32], 16, "dirtLevel"], [[io, io.readwrite, type, type.vec4], 16, "customShaderData"], [[io, io.read, type, type.vec4], 16, "spaceObjectShipData"], [[io, io.read, type, type.int32], 16, "lastDamageLocatorHit"], [[io, io.notify, io, io.readwrite, type, type.boolean], 16, "damageLocatorAutoFilterEnabled"], [[io, io.persist, type, type.float32], 16, "boundingSphereRadius"], [[io, io.read, type, type.vec3], 16, "modelWorldPosition"], [[io, io.persist, void 0, type.objectRef("ITriVectorFunction")], 16, "modelTranslationCurve"], [[io, io.persist, void 0, type.objectRef("ITriQuaternionFunction")], 16, "modelRotationCurve"], [[io, io.persist, type, type.vec3], 16, "shapeEllipsoidCenter"], [[io, io.persist, type, type.vec3], 16, "shapeEllipsoidRadius"], [[io, io.persist, void 0, type.objectRef("ITriVectorFunction")], 16, "translationCurve"], [[io, io.read, type, type.mat4], 16, "worldTransform"], [[io, io.read, type, type.mat4], 16, "inverseWorldTransform"], [[io, io.read, type, type.mat4], 16, "lastWorldTransform"], [[io, io.read, type, type.vec3], 16, "worldVelocity"], [[io, io.readwrite, void 0, type.objectRef("ITr2AudGeometry")], 16, "audioGeometry"], [[type, type.boolean], 16, "isVisible"], [[carbon, carbon.method, impl, impl.adapted], 18, "Initialize"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetMesh"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetMesh"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetOverlayEffects"], [[carbon, carbon.method, impl, impl.adapted], 18, "AddController"], [[carbon, carbon.method, impl, impl.implemented], 18, "AddObserver"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetInheritProperties"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetEffectChildByName"], [[carbon, carbon.method, impl, impl.adapted], 18, "AddToEffectChildrenList"], [[carbon, carbon.method, impl, impl.implemented], 18, "AddLight"], [[carbon, carbon.method, impl, impl.implemented], 18, "ClearLights"], [[carbon, carbon.method, impl, impl.implemented], 18, "RemoveFromEffectChildrenList"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetModelRotationCurve"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetModelRotationCurve"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetModelTranslationCurve"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetModelTranslationCurve"], [[carbon, carbon.method, impl, impl.adapted], 18, "UpdateWorldTransform"], [[carbon, carbon.method, impl, impl.implemented], 18, "UpdateWorldBounds"], [[carbon, carbon.method, impl, impl.implemented], 18, "PrepareShaderData"], [[carbon, carbon.method, impl, impl.implemented], 18, "UpdateShLighting"], [[carbon, carbon.method, impl, impl.implemented], 18, "ClearShLighting"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetParentData"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetPerObjectStructs"], [[carbon, carbon.method, impl, impl.adapted], 18, "UpdateSyncronous"], [[carbon, carbon.method, impl, impl.adapted], 18, "UpdateAsyncronous"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Native impostor, raytracing, and audio-emitter realization remain engine-owned; graph visibility and LOD state are preserved.")], 18, "UpdateVisibility"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Impostor submission and decal mesh caches are engine-owned; Trinity returns the backend-neutral renderable graph.")], 18, "GetRenderables"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Overlay area-block batches are deferred; the view position arrives via the appended render-context argument instead of Carbon's renderer global.")], 18, "GetBatches"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Carbon rebuilds from the geometry-resource notify callback; the GPU-free port rebuilds lazily on first batch use from the mesh areas alone.")], 18, "RebuildCachedData"], [[carbon, carbon.method, impl, impl.implemented], 18, "ReleaseCachedData"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetPickingBatches"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetID"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Realized-LOD draw args are engine-resolved from the geometry source descriptor; primitive-count gating happens at realization.")], 18, "GetShadowBatches"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Overlay selection is fully represented in the CPU graph; realized-LOD draw arguments remain engine-owned.")], 18, "GetBatchesFromOverlayVector"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Portable mesh area access replaces Carbon's native mesh-area vectors.")], 18, "HasTransparentBatches"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Carbon reads the Tr2Renderer view-position global; the relocated camera state arrives via the threaded render context.")], 18, "GetSortValue"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Trinity retains and fills persistent VS/PS RawData; the engine owns device buffers, GPU-derived offsets, upload, and binding.")], 18, "GetPerObjectData"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetShadowPerObjectData"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetLights"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("The optional length-one array replaces Carbon's float& sizeInShadow out-parameter.")], 18, "IsCastingShadow"], [[carbon, carbon.method, impl, impl.implemented], 18, "RegisterComponents"], [[carbon, carbon.method, impl, impl.implemented], 18, "UnRegisterComponents"], [[carbon, carbon.method, impl, impl.implemented], 18, "DisplayChildren"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetObserverTransform"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetLocalToWorldTransform"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetModelCenterWorldPosition"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetWorldPosition"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetWorldRotation"], [[carbon, carbon.method, impl, impl.implemented], 18, "FindSoundEmitter"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetMute"], [[carbon, carbon.method, impl, impl.adapted], 18, "PlayAnimationEx"], [[carbon, carbon.method, impl, impl.adapted], 18, "CalculateSkinnedBoundingBoxFromTransform"], [[carbon, carbon.method, impl, impl.adapted], 18, "CalculateSkinnedBoundingSphere"], [[carbon, carbon.method, impl, impl.implemented], 18, "InvalidateMergedLocators"], [[carbon, carbon.method, impl, impl.adapted], 18, "EnsureChildLocatorMerged"], [[carbon, carbon.method, impl, impl.implemented], 18, "UpdateDamageLocatorFilter"], [[carbon, carbon.method, impl, impl.implemented], 18, "RunDamageLocatorFilter"], [[carbon, carbon.method, impl, impl.implemented], 18, "ClearImpactDamage"], [[carbon, carbon.method, impl, impl.implemented], 18, "ClearAnimations"], [[carbon, carbon.method, impl, impl.implemented], 18, "CreateImpactFromPosition"], [[carbon, carbon.method, impl, impl.adapted], 18, "CreateImpact"], [[carbon, carbon.method, impl, impl.implemented], 18, "EndAnimation"], [[carbon, carbon.method, impl, impl.implemented], 18, "FreezeHighDetailMesh"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetDamageLocatorCount"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetLocatorCount"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetLocatorsForSet"], [[carbon, carbon.method, impl, impl.implemented], 18, "MergeToLocatorSet"], [[carbon, carbon.method, impl, impl.implemented], 18, "AddLocatorSet"], [[carbon, carbon.method, impl, impl.implemented], 18, "ClearLocatorSets"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetCloseLocatorIndex"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetGoodLocatorIndex"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetDamageLocatorDirection"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("CarbonEngineJS keeps output parameters last and returns a validity flag for targetable callers.")], 18, "GetDamageLocatorPosition"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetDamageLocatorBindPosition"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetClosestDamageLocatorIndex"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("TriRand is represented by Math.random; all locator scoring remains source-faithful.")], 18, "GetGoodDamageLocatorIndex"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetRadius"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetMissPosition"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetImpactConfiguration"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetImpactOverlay"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetImpactOverlay"], [[carbon, carbon.method, impl, impl.implemented], 18, "HasImpactConfigurationShield"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("CarbonEngineJS uses an out-last signature; the ellipsoid intersection is otherwise source-faithful CPU math.")], 18, "GetImpactPosition"], [[carbon, carbon.method, impl, impl.implemented], 18, "UpdateImpact"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetDamageLocator"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetTransformedDamageLocator"], [[carbon, carbon.method, impl, impl.adapted], 18, "IsImpostor"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetLocatorPositionFromSet"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetLocatorRotationFromSet"], [[carbon, carbon.method, impl, impl.implemented], 18, "HandleControllerEvent"], [[carbon, carbon.method, impl, impl.adapted], 18, "PlayAnimation"], [[carbon, carbon.method, impl, impl.implemented], 18, "ChainAnimation"], [[carbon, carbon.method, impl, impl.implemented], 18, "ChainAnimationEx"], [[carbon, carbon.method, impl, impl.adapted], 18, "RebuildBoundingSphereInformation"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Carbon's CcpMath::Sphere is represented by core-math sph3; object-shaped center/radius input is accepted at adapter boundaries.")], 18, "SetBoundingSphereInformation"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetControllerVariables"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Geometry resources without multi-LOD support expose their sole browser LOD as index zero.")], 18, "GetLastUsedMeshLod"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetLocatorTransform"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetLocalBoundingBox"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetWorldBoundingBox"], [[carbon, carbon.method, impl, impl.implemented], 18, "IsBoundingBoxReady"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetBoundingSphere"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("TriFrustum is supplied structurally by the active engine; both exact and estimated browser frustum methods are supported.")], 18, "EstimatePixelDiameter"], [[carbon, carbon.method, impl, impl.implemented], 18, "IsInFrustum"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetBoundingSphereCenter"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetBoundingSphereRadius"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetBoneCount"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetImpactDamageState"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetImpactAnimation"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetControllerVariable"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetProceduralContainerVariable"], [[carbon, carbon.method, impl, impl.implemented], 18, "StartControllers"], [[carbon, carbon.method, impl, impl.adapted], 18, "TransformLocators"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetLocatorInObjectSpace"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetShapeEllipsoid"]], 0, void 0, _withIEveInheritPrope));
     }
     /** m_reflectionMode (EntityComponents::ReflectionMode - enum ReflectionMode) [READWRITE, PERSIST, NOTIFY, ENUM] */
     reflectionMode = (_initProto(this), _init_reflectionMode(this, 3));
@@ -204,10 +209,10 @@ new class extends _identity {
     /** m_psData.customData (Vector4) [READWRITE] - script/SOF-driven custom shader data. */
     customShaderData = (_init_extra_dirtLevel(this), _init_customShaderData(this, vec4.create()));
 
-    /**
-     * m_spaceObjectShipData (Vector4) [READ] - the packed shader ship data:
-     * .y activation strength, .z dirt level, .w bounding-sphere radius
-     * (PrepareShaderData, cpp:734-744). .x is authored elsewhere and left alone.
+    /**
+     * m_spaceObjectShipData (Vector4) [READ] - the packed shader ship data:
+     * .y activation strength, .z dirt level, .w bounding-sphere radius
+     * (PrepareShaderData, cpp:734-744). .x is authored elsewhere and left alone.
      */
     spaceObjectShipData = (_init_extra_customShaderData(this), _init_spaceObjectShipData(this, vec4.create()));
 
@@ -253,7 +258,8 @@ new class extends _identity {
     #dynamicBoundingSphere = sph3.set(sph3.create(), 0, 0, 0, -1);
 
     // Carbon keeps the realized world sphere separate from the authored local
-    // sphere. It is refreshed by UpdateWorldBounds after transform changes.
+    // sphere. UpdateWorldBounds refreshes it from PrepareShaderData, which is
+    // Carbon's only refresh point - so a reader sees one value for a whole frame.
     #boundingSphereWorldRadius = -1;
 
     // Carbon visibility and mesh LOD state are runtime-only renderer results.
@@ -293,10 +299,10 @@ new class extends _identity {
 
     /** EVE_SPACEOBJECT_CUSTOWMASK_MAX (EveSpaceObject2.h:49) - custom-mask slots. */
 
-    /**
-     * Carbon g_secondaryLightingRadiusCutoffFactor (cpp:52), a registered engine
-     * setting defaulting to 0.3. It scales this hull's bounding radius into the
-     * cutoff below which a secondary light source is too small to matter.
+    /**
+     * Carbon g_secondaryLightingRadiusCutoffFactor (cpp:52), a registered engine
+     * setting defaulting to 0.3. It scales this hull's bounding radius into the
+     * cutoff below which a secondary light source is too small to matter.
      */
 
     /** Scratch for the per-frame shader-data fill; never allocate in it. */
@@ -320,12 +326,12 @@ new class extends _identity {
       this.mesh = mesh ?? null;
     }
 
-    /**
-     * Links the authored controllers, pushes authored inherit properties down to
-     * the effect children and lights, and derives the impact overlay's damage
-     * locator count from the "damage" locator set - which Carbon does at build
-     * time - so a field-populated graph reaches the same live state as the
-     * authoring path.
+    /**
+     * Links the authored controllers, pushes authored inherit properties down to
+     * the effect children and lights, and derives the impact overlay's damage
+     * locator count from the "damage" locator set - which Carbon does at build
+     * time - so a field-populated graph reaches the same live state as the
+     * authoring path.
      */
     Initialize() {
       for (const controller of this.controllers) {
@@ -356,9 +362,9 @@ new class extends _identity {
       return this.mesh;
     }
 
-    /**
-     * Replaces the hull mesh; the cached area blocks are only rebuilt on the next
-     * batch call.
+    /**
+     * Replaces the hull mesh; the cached area blocks are only rebuilt on the next
+     * batch call.
      */
     SetMesh(mesh) {
       this.mesh = mesh ?? null;
@@ -369,9 +375,9 @@ new class extends _identity {
       return this.overlayEffects;
     }
 
-    /**
-     * Appends a controller, links it to this object when it is not already linked,
-     * and replays the current controller variables onto it.
+    /**
+     * Appends a controller, links it to this object when it is not already linked,
+     * and replays the current controller variables onto it.
      */
     AddController(controller) {
       this.controllers.push(controller);
@@ -382,20 +388,20 @@ new class extends _identity {
       return controller;
     }
 
-    /**
-     * Appends a placement observer, which is repositioned from the observer
-     * transform on every synchronous update; the observer is returned for
-     * chaining.
+    /**
+     * Appends a placement observer, which is repositioned from the observer
+     * transform on every synchronous update; the observer is returned for
+     * chaining.
      */
     AddObserver(observer) {
       this.observers.push(observer);
       return observer;
     }
 
-    /**
-     * Sets the colour set that effect children and lights inherit, creating the
-     * inherit-properties holder on first use, and pushes it to the existing
-     * children and lights.
+    /**
+     * Sets the colour set that effect children and lights inherit, creating the
+     * inherit-properties holder on first use, and pushes it to the existing
+     * children and lights.
      */
     SetInheritProperties(colorSet) {
       if (!this.inheritProperties) {
@@ -416,9 +422,9 @@ new class extends _identity {
       }
     }
 
-    /**
-     * Returns the first effect child with the given name, or null when none
-     * matches.
+    /**
+     * Returns the first effect child with the given name, or null when none
+     * matches.
      */
     GetEffectChildByName(name) {
       const target = String(name ?? "");
@@ -430,10 +436,10 @@ new class extends _identity {
       return null;
     }
 
-    /**
-     * Appends an effect child, first giving it the hull's inherited properties and
-     * then replaying the current controller variables onto it, so a late addition
-     * starts in the same state as the rest.
+    /**
+     * Appends an effect child, first giving it the hull's inherited properties and
+     * then replaying the current controller variables onto it, so a late addition
+     * starts in the same state as the rest.
      */
     AddToEffectChildrenList(child) {
       if (this.inheritProperties) {
@@ -454,17 +460,17 @@ new class extends _identity {
       this.lights.push(light);
     }
 
-    /**
-     * Drops every light from the hull; component registration is not revisited
-     * here.
+    /**
+     * Drops every light from the hull; component registration is not revisited
+     * here.
      */
     ClearLights() {
       this.lights.length = 0;
     }
 
-    /**
-     * Removes an effect child, returning false when it is not attached to this
-     * hull.
+    /**
+     * Removes an effect child, returning false when it is not attached to this
+     * hull.
      */
     RemoveFromEffectChildrenList(child) {
       const index = this.effectChildren.indexOf(child);
@@ -477,9 +483,9 @@ new class extends _identity {
       return true;
     }
 
-    /**
-     * Sets the curve that rotates the model within the hull's ball rotation, or
-     * clears it when passed nothing.
+    /**
+     * Sets the curve that rotates the model within the hull's ball rotation, or
+     * clears it when passed nothing.
      */
     SetModelRotationCurve(curve) {
       this.modelRotationCurve = curve ?? null;
@@ -490,9 +496,9 @@ new class extends _identity {
       return this.modelRotationCurve;
     }
 
-    /**
-     * Sets the curve that offsets the model within the hull's ball position, or
-     * clears it when passed nothing.
+    /**
+     * Sets the curve that offsets the model within the hull's ball position, or
+     * clears it when passed nothing.
      */
     SetModelTranslationCurve(curve) {
       this.modelTranslationCurve = curve ?? null;
@@ -503,10 +509,10 @@ new class extends _identity {
       return this.modelTranslationCurve;
     }
 
-    /**
-     * Rebuilds the hull world transform for a frame from the ball position and rotation curves plus the optional model translation and rotation curves, applies modelScale as a uniform scale, then refreshes the inverse transform and the world bounds; the previous world transform is kept for motion vectors and the world velocity comes from the position curve's derivative.
-     * @param {number} time Frame time; repeating the previous call's time is a no-op.
-     * @returns {boolean} False when the transform had already been built for this time.
+    /**
+     * Rebuilds the hull world transform for a frame from the ball position and rotation curves plus the optional model translation and rotation curves, applies modelScale as a uniform scale, then refreshes the inverse transform and the world bounds; the previous world transform is kept for motion vectors and the world velocity comes from the position curve's derivative.
+     * @param {number} time Frame time; repeating the previous call's time is a no-op.
+     * @returns {boolean} False when the transform had already been built for this time.
      */
     UpdateWorldTransform(time) {
       const nextTime = Number(time) || 0;
@@ -557,13 +563,12 @@ new class extends _identity {
       if (!mat4.invert(this.inverseWorldTransform, this.worldTransform)) {
         mat4.identity(this.inverseWorldTransform);
       }
-      this.UpdateWorldBounds();
       return true;
     }
 
-    /**
-     * Refreshes Carbon's realized world-space sphere from the dynamic skinned
-     * sphere when available, otherwise from the authored local sphere.
+    /**
+     * Refreshes Carbon's realized world-space sphere from the dynamic skinned
+     * sphere when available, otherwise from the authored local sphere.
      */
     UpdateWorldBounds() {
       const updater = this.animationUpdater;
@@ -572,21 +577,19 @@ new class extends _identity {
         if (this.#dynamicBoundingSphere[3] > 0) {
           vec3.transformMat4(this.modelWorldPosition, this.#dynamicBoundingSphere, this.worldTransform);
           this.#boundingSphereWorldRadius = this.modelScale * this.#dynamicBoundingSphere[3];
-          return true;
+          return;
         }
       }
       if (this.boundingSphereRadius > 0) {
         vec3.transformMat4(this.modelWorldPosition, this.boundingSphereCenter, this.worldTransform);
         this.#boundingSphereWorldRadius = this.modelScale * this.boundingSphereRadius;
-        return true;
       }
-      return false;
     }
 
-    /**
-     * Carbon EveSpaceObject2::PrepareShaderData (cpp:734-763): refreshes the
-     * world bounds, packs the ship data, and derives the clip-sphere dissolve
-     * values into the persistent per-object records.
+    /**
+     * Carbon EveSpaceObject2::PrepareShaderData (cpp:734-763): refreshes the
+     * world bounds, packs the ship data, and derives the clip-sphere dissolve
+     * values into the persistent per-object records.
      */
     PrepareShaderData(updateContext = null) {
       this.UpdateWorldBounds();
@@ -616,14 +619,14 @@ new class extends _identity {
       this.#psData.Set("clipSphereFactor2", [this.clipSphereFactor2]);
     }
 
-    /**
-     * Carbon EveSpaceObject2::UpdateShLighting (cpp:1411-1421): asks the scene's
-     * SH lighting manager for this hull's secondary-lighting coefficients, faded
-     * in across the low-detail threshold so a hull entering that range does not
-     * pop. The coefficients are cleared first, which is also what leaves the
-     * unwritten tail zero on the L1 path.
-     * @param {Object} manager - Tr2ShLightingManager
-     * @param {Object} [updateContext] - frame context, for the detail thresholds
+    /**
+     * Carbon EveSpaceObject2::UpdateShLighting (cpp:1411-1421): asks the scene's
+     * SH lighting manager for this hull's secondary-lighting coefficients, faded
+     * in across the low-detail threshold so a hull entering that range does not
+     * pop. The coefficients are cleared first, which is also what leaves the
+     * unwritten tail zero on the L1 path.
+     * @param {Object} manager - Tr2ShLightingManager
+     * @param {Object} [updateContext] - frame context, for the detail thresholds
      */
     UpdateShLighting(manager, updateContext = null) {
       const coefficients = this.#psData.Get("shLightingCoefficients");
@@ -639,21 +642,21 @@ new class extends _identity {
       return true;
     }
 
-    /**
-     * Carbon EveSpaceObject2::ClearShLighting (cpp:1423-1426): drops this hull's
-     * secondary-lighting contribution back to nothing.
+    /**
+     * Carbon EveSpaceObject2::ClearShLighting (cpp:1423-1426): drops this hull's
+     * secondary-lighting contribution back to nothing.
      */
     ClearShLighting() {
       this.#psData.Get("shLightingCoefficients").fill(0);
       return true;
     }
 
-    /**
-     * Carbon EveSpaceObject2::GetParentData (cpp:1872-1885): the values an
-     * attachment needs from its hull. `shLighting` is a LIVE view into the PS
-     * record, exactly as Carbon hands out a raw pointer into m_psData - an
-     * attachment reading it sees the hull's current coefficients.
-     * @param {Object} [out] - caller-owned record, refreshed in place
+    /**
+     * Carbon EveSpaceObject2::GetParentData (cpp:1872-1885): the values an
+     * attachment needs from its hull. `shLighting` is a LIVE view into the PS
+     * record, exactly as Carbon hands out a raw pointer into m_psData - an
+     * attachment reading it sees the hull's current coefficients.
+     * @param {Object} [out] - caller-owned record, refreshed in place
      */
     GetParentData(out = new _IEveSpaceObject2Pare()) {
       mat4.copy(out.transform, this.worldTransform);
@@ -670,11 +673,11 @@ new class extends _identity {
       return out;
     }
 
-    /**
-     * Carbon EveSpaceObject2::GetPerObjectStructs (cpp:1485-1490): hands a copy
-     * of both records to a caller, with the VS record's customData taken from the
-     * PS record as Carbon does.
-     * @returns {{vs: RawData, ps: RawData}} independent copies, not live records
+    /**
+     * Carbon EveSpaceObject2::GetPerObjectStructs (cpp:1485-1490): hands a copy
+     * of both records to a caller, with the VS record's customData taken from the
+     * PS record as Carbon does.
+     * @returns {{vs: RawData, ps: RawData}} independent copies, not live records
      */
     GetPerObjectStructs(vsData = RawData.create("EveSpaceObjectVSData"), psData = RawData.create("EveSpaceObjectPSData")) {
       vsData.CopyFrom(this.#vsData);
@@ -686,9 +689,9 @@ new class extends _identity {
       };
     }
 
-    /**
-     * Refreshes the world transform, then - when the update flag is on - places the observers, stamps the LOD-gated curve clock while advancing the overlay effects, runs the effect children's synchronous pass with the current placement, and updates the impact overlay; the overlay effects receive the context time as both clocks, as Carbon does.
-     * @returns {boolean} False when the update flag is off; the world transform is refreshed either way.
+    /**
+     * Refreshes the world transform, then - when the update flag is on - places the observers, stamps the LOD-gated curve clock while advancing the overlay effects, runs the effect children's synchronous pass with the current placement, and updates the impact overlay; the overlay effects receive the context time as both clocks, as Carbon does.
+     * @returns {boolean} False when the update flag is off; the world transform is refreshed either way.
      */
     UpdateSyncronous(updateContext = null) {
       const time = _EveSpaceObject.#GetContextValue(updateContext, "GetTime", "currentTime", "time");
@@ -729,9 +732,9 @@ new class extends _identity {
       return true;
     }
 
-    /**
-     * Runs the controllers at a frequency derived from the hull's estimated pixel diameter against the context's high-detail threshold, advances the object curve sets only on frames the synchronous LOD gate stamped, then updates the transform children, the effect children and the impact overlay.
-     * @returns {number} The controller update frequency in 0..1, which is also handed to the effect children; 0 when the hull is not visible or the update flag is off.
+    /**
+     * Runs the controllers at a frequency derived from the hull's estimated pixel diameter against the context's high-detail threshold, advances the object curve sets only on frames the synchronous LOD gate stamped, then updates the transform children, the effect children and the impact overlay.
+     * @returns {number} The controller update frequency in 0..1, which is also handed to the effect children; 0 when the hull is not visible or the update flag is off.
      */
     UpdateAsyncronous(updateContext = null) {
       if (!this.update) {
@@ -808,9 +811,9 @@ new class extends _identity {
       return frequency;
     }
 
-    /**
-     * Updates Carbon's visibility, pixel-size, and mesh-LOD state, then forwards
-     * visibility to the explicitly owned visual branches.
+    /**
+     * Updates Carbon's visibility, pixel-size, and mesh-LOD state, then forwards
+     * visibility to the explicitly owned visual branches.
      */
     UpdateVisibility(updateContext = null, _parentTransform = _EveSpaceObject.#identityTransform) {
       this.isVisible = false;
@@ -819,7 +822,6 @@ new class extends _identity {
       if (!this.display) {
         return false;
       }
-      this.UpdateWorldBounds();
       this.lodLevel = Tr2Lod.TR2_LOD_LOW;
       this.#lodLevelWithChildren = Tr2Lod.TR2_LOD_LOW;
       this.#impostorMode = false;
@@ -910,10 +912,10 @@ new class extends _identity {
       return out;
     }
 
-    /** Carbon ITr2Renderable contract (EveSpaceObject2.cpp:1097-1140): activated
-     * attachments recurse, the impact overlay contributes, the hull mesh delegates
-     * per batch type, and TRANSPARENT routes through the distance-sorted area
-     * path. GetBatchesFromOverlayVector (precomputed overlay area blocks) is
+    /** Carbon ITr2Renderable contract (EveSpaceObject2.cpp:1097-1140): activated
+     * attachments recurse, the impact overlay contributes, the hull mesh delegates
+     * per batch type, and TRANSPARENT routes through the distance-sorted area
+     * path. GetBatchesFromOverlayVector (precomputed overlay area blocks) is
      * deferred with the overlay realization work. */
     GetBatches(batches, batchType, perObjectData, reason, renderContext = null) {
       if (!this.mesh) return false;
@@ -953,11 +955,11 @@ new class extends _identity {
     // from the geometry resource when it exposes them; a failed lookup keeps
     // Carbon's origin-center fallback.
 
-    /**
-     * Commits the mesh's transparent areas back-to-front, ordering them by the
-     * squared distance from the view position to each area's world-space
-     * bounding-box center and falling back to the object origin when the geometry
-     * resource cannot supply a box.
+    /**
+     * Commits the mesh's transparent areas back-to-front, ordering them by the
+     * squared distance from the view position to each area's world-space
+     * bounding-box center and falling back to the object origin when the geometry
+     * resource cannot supply a box.
      */
     #GetSortedTransparentBatches(areas, batches, perObjectData, renderContext) {
       const geometry = this.mesh.GetGeometryResource() ?? null;
@@ -995,10 +997,10 @@ new class extends _identity {
       }
     }
 
-    /** Rebuilds the cached overlay/shadow area-block lists from the current mesh
-     * (Carbon RebuildCachedData, EveSpaceObject2.cpp:2077-2097, triggered there by
-     * the geometry-resource load callback). TYPE_ALL = shadow-casting OPAQUE +
-     * TRANSPARENT + DECAL areas; TYPE_OPAQUEONLY = shadow-casting OPAQUE; the
+    /** Rebuilds the cached overlay/shadow area-block lists from the current mesh
+     * (Carbon RebuildCachedData, EveSpaceObject2.cpp:2077-2097, triggered there by
+     * the geometry-resource load callback). TYPE_ALL = shadow-casting OPAQUE +
+     * TRANSPARENT + DECAL areas; TYPE_OPAQUEONLY = shadow-casting OPAQUE; the
      * shadow list groups OPAQUE areas by shared material. All coalesced. */
     RebuildCachedData() {
       this.ReleaseCachedData();
@@ -1018,9 +1020,9 @@ new class extends _identity {
       this.#cachedAreaBlocksBuilt = true;
     }
 
-    /**
-     * Drops the cached overlay and shadow area-block lists so the next batch call
-     * rebuilds them from the current mesh.
+    /**
+     * Drops the cached overlay and shadow area-block lists so the next batch call
+     * rebuilds them from the current mesh.
      */
     ReleaseCachedData() {
       for (const blocks of this.#overlayMeshAreaBlocks) {
@@ -1030,25 +1032,25 @@ new class extends _identity {
       this.#cachedAreaBlocksBuilt = false;
     }
 
-    /**
-     * Rebuilds the cached area blocks on first use when a mesh is attached; Carbon
-     * instead rebuilds them from the geometry-resource load callback.
+    /**
+     * Rebuilds the cached area blocks on first use when a mesh is attached; Carbon
+     * instead rebuilds them from the geometry-resource load callback.
      */
     #EnsureCachedAreaBlocks() {
       if (!this.#cachedAreaBlocksBuilt && this.mesh) this.RebuildCachedData();
     }
 
-    /**
-     * Carbon EveSpaceObject2::GetPickingBatches (cpp:3645-3675): collects the
-     * geometry a pick pass should test, by mask. It is ordinary batch collection
-     * - the pick itself is an engine pass that renders these and reads IDs back.
-     *
-     * The OPAQUE bit deliberately pulls in the transparent and additive OVERLAY
-     * effects too, so a cloaking hull stays pickable.
-     *
-     * @param {Object} batches - the picking accumulator
-     * @param {Number} pickTypes - a Tr2PickType mask
-     * @param {Object} perObjectData - this hull's per-object record
+    /**
+     * Carbon EveSpaceObject2::GetPickingBatches (cpp:3645-3675): collects the
+     * geometry a pick pass should test, by mask. It is ordinary batch collection
+     * - the pick itself is an engine pass that renders these and reads IDs back.
+     *
+     * The OPAQUE bit deliberately pulls in the transparent and additive OVERLAY
+     * effects too, so a cloaking hull stays pickable.
+     *
+     * @param {Object} batches - the picking accumulator
+     * @param {Number} pickTypes - a Tr2PickType mask
+     * @param {Object} perObjectData - this hull's per-object record
      */
     GetPickingBatches(batches, pickTypes = TR2_PICK_TYPE_DEFAULT, perObjectData = null) {
       if (pickTypes & Tr2PickType.PICK_TYPE_PICKING) {
@@ -1077,20 +1079,20 @@ new class extends _identity {
       return true;
     }
 
-    /**
-     * Carbon EveSpaceObject2::GetID (cpp:3640-3643): a picked area resolves to
-     * the hull itself, so the area index is deliberately ignored.
-     * @param {Number} [_areaID] - the picked area, unused by this class
-     * @returns {EveSpaceObject2} this
+    /**
+     * Carbon EveSpaceObject2::GetID (cpp:3640-3643): a picked area resolves to
+     * the hull itself, so the area index is deliberately ignored.
+     * @param {Number} [_areaID] - the picked area, unused by this class
+     * @returns {EveSpaceObject2} this
      */
     GetID(_areaID = 0) {
       return this;
     }
 
-    /** Carbon GetShadowBatches (EveSpaceObject2.cpp:1143-1184): one batch per
-     * cached shared-material OPAQUE area block, using the area's own material.
-     * Carbon bakes realized-LOD draw args; the GPU-free port defers them to the
-     * engine via the geometry source descriptor, so shadowPixelSize travels unused
+    /** Carbon GetShadowBatches (EveSpaceObject2.cpp:1143-1184): one batch per
+     * cached shared-material OPAQUE area block, using the area's own material.
+     * Carbon bakes realized-LOD draw args; the GPU-free port defers them to the
+     * engine via the geometry source descriptor, so shadowPixelSize travels unused
      * until engine LOD selection consumes it. */
     GetShadowBatches(batches, perObjectData, _shadowPixelSize) {
       if (!this.mesh || this.mesh.display === false) return false;
@@ -1113,10 +1115,10 @@ new class extends _identity {
       return committed;
     }
 
-    /** Carbon GetBatchesFromOverlayVector (EveSpaceObject2.cpp:1199-1285): the
-     * impact overlay's armor-damage shader draws over the TYPE_ALL blocks at
-     * maximum priority; each displayed overlay effect draws its per-batch-type
-     * effects over its overlay-type blocks (OPAQUE -> TYPE_OPAQUEONLY, everything
+    /** Carbon GetBatchesFromOverlayVector (EveSpaceObject2.cpp:1199-1285): the
+     * impact overlay's armor-damage shader draws over the TYPE_ALL blocks at
+     * maximum priority; each displayed overlay effect draws its per-batch-type
+     * effects over its overlay-type blocks (OPAQUE -> TYPE_OPAQUEONLY, everything
      * else -> TYPE_ALL). */
     GetBatchesFromOverlayVector(batches, perObjectData, batchType, mesh) {
       const impactEffect = this.impactOverlay?.GetArmorDamageShader?.(batchType) ?? null;
@@ -1161,10 +1163,10 @@ new class extends _identity {
       return (batches.GetBatchCount?.() ?? 0) > committedBefore;
     }
 
-    /**
-     * Builds and commits one render batch drawing a single cached area block with
-     * the given material and optional priority, skipping the block when the
-     * material yields no valid batch.
+    /**
+     * Builds and commits one render batch drawing a single cached area block with
+     * the given material and optional priority, skipping the block when the
+     * material yields no valid batch.
      */
     #CommitBlockBatch(batches, material, geometry, meshIndex, block, perObjectData, priority, lod, vertexDeclaration) {
       const batch = new Tr2RenderBatch();
@@ -1182,18 +1184,18 @@ new class extends _identity {
 
     // EveMeshOverlayEffect::GetEffects (display-gated, per batch type).
 
-    /**
-     * Returns an overlay effect's display-gated effect list for a batch type, or
-     * null when it contributes none.
+    /**
+     * Returns an overlay effect's display-gated effect list for a batch type, or
+     * null when it contributes none.
      */
     #OverlayEffectsFor(overlay, batchType) {
       return overlay?.GetEffects?.(batchType) ?? null;
     }
 
-    /**
-     * Reports whether the hull mesh has transparent areas or any overlay effect
-     * does, which tells the renderer to route this object through the sorted
-     * transparent pass.
+    /**
+     * Reports whether the hull mesh has transparent areas or any overlay effect
+     * does, which tells the renderer to route this object through the sorted
+     * transparent pass.
      */
     HasTransparentBatches() {
       if (!this.mesh) return false;
@@ -1204,9 +1206,9 @@ new class extends _identity {
       return false;
     }
 
-    /**
-     * Returns the distance from the render context's view position to the hull
-     * world translation, used to order transparent renderables back-to-front.
+    /**
+     * Returns the distance from the render context's view position to the hull
+     * world translation, used to order transparent renderables back-to-front.
      */
     GetSortValue(renderContext = null) {
       const viewPosition = renderContext?.GetViewPosition();
@@ -1216,9 +1218,9 @@ new class extends _identity {
       return Math.hypot(x, y, z);
     }
 
-    /** Carbon allocates Tr2PerObjectDataWithPersistentBuffers<EveSpaceObject2>.
-     * This port retains persistent VS/PS RawData and returns those records
-     * directly. GPU-derived bone-ring offsets remain at their CPU defaults until
+    /** Carbon allocates Tr2PerObjectDataWithPersistentBuffers<EveSpaceObject2>.
+     * This port retains persistent VS/PS RawData and returns those records
+     * directly. GPU-derived bone-ring offsets remain at their CPU defaults until
      * an engine supplies them; other CPU-known values are already encoded. */
     GetPerObjectData(_accumulator = null) {
       // Carbon cpp:1437-1445: the bone ring is uploaded and its OFFSETS stamped
@@ -1242,13 +1244,13 @@ new class extends _identity {
       return this.GetPerObjectData(accumulator);
     }
 
-    /** Carbon EveSpaceObject2::GetLights (cpp:3536-3555): display gate only
-     * (no lights-empty early-out, unlike EveChildMesh), then per light
-     * AddLight(manager, worldTransform, 1, bones, boneCount) FOLLOWED by
-     * SetBrightnessMultiplier(m_activationStrength) - the order is contract:
-     * the submission uses the multiplier stamped on the PREVIOUS pass (first
-     * pass uses the Tr2Light default 1) - one frame of activation-strength
-     * lag, preserved verbatim. cpp:3554's dead `DisplayChildren()` local is
+    /** Carbon EveSpaceObject2::GetLights (cpp:3536-3555): display gate only
+     * (no lights-empty early-out, unlike EveChildMesh), then per light
+     * AddLight(manager, worldTransform, 1, bones, boneCount) FOLLOWED by
+     * SetBrightnessMultiplier(m_activationStrength) - the order is contract:
+     * the submission uses the multiplier stamped on the PREVIOUS pass (first
+     * pass uses the Tr2Light default 1) - one frame of activation-strength
+     * lag, preserved verbatim. cpp:3554's dead `DisplayChildren()` local is
      * not ported. */
     GetLights(lightManager) {
       if (!this.display) {
@@ -1267,11 +1269,11 @@ new class extends _identity {
       }
     }
 
-    /**
-     * Carbon EveSpaceObject2::IsCastingShadow (cpp:2252-2274): applies the
-     * display, world-sphere and reflection gates, then tests the realized sphere
-     * against the supplied shadow frustum. Carbon's float& result is represented
-     * by an optional length-one array.
+    /**
+     * Carbon EveSpaceObject2::IsCastingShadow (cpp:2252-2274): applies the
+     * display, world-sphere and reflection gates, then tests the realized sphere
+     * against the supplied shadow frustum. Carbon's float& result is represented
+     * by an optional length-one array.
      */
     IsCastingShadow(cameraFrustum, shadowFrustum, renderReason, sizeInShadowOut = null) {
       if (!this.display || this.#boundingSphereWorldRadius <= 0) {
@@ -1294,9 +1296,9 @@ new class extends _identity {
       return sizeInShadow > 15;
     }
 
-    /** Carbon EveSpaceObject2::RegisterComponents (cpp:3568-3609): registers its
-     * own components and its children with the scene registration container "so
-     * we don't have to traverse the tree every frame". RegisterAudioGeometry
+    /** Carbon EveSpaceObject2::RegisterComponents (cpp:3568-3609): registers its
+     * own components and its children with the scene registration container "so
+     * we don't have to traverse the tree every frame". RegisterAudioGeometry
      * (cpp:3572-3575) is audio-engine-owned and unported. Gate m_display. */
     RegisterComponents() {
       const registry = this.GetComponentRegistry();
@@ -1319,10 +1321,10 @@ new class extends _identity {
       }
     }
 
-    /** Carbon EveSpaceObject2::UnRegisterComponents (cpp:3615-3638): forwards
-     * the un-registration to the children only - EveEntity::UnRegister already
-     * called UnRegisterAllComponents(this) first (EveEntity.cpp:90) - and does
-     * not re-check display. UnregisterAudioGeometry (cpp:3617) is
+    /** Carbon EveSpaceObject2::UnRegisterComponents (cpp:3615-3638): forwards
+     * the un-registration to the children only - EveEntity::UnRegister already
+     * called UnRegisterAllComponents(this) first (EveEntity.cpp:90) - and does
+     * not re-check display. UnregisterAudioGeometry (cpp:3617) is
      * audio-engine-owned and unported. */
     UnRegisterComponents() {
       const registry = this.GetComponentRegistry();
@@ -1336,25 +1338,25 @@ new class extends _identity {
       }
     }
 
-    /**
-     * Reports whether children and effect children should be shown; always true on
-     * the base hull, subclasses gate it on activation state.
+    /**
+     * Reports whether children and effect children should be shown; always true on
+     * the base hull, subclasses gate it on activation state.
      */
     DisplayChildren() {
       return true;
     }
 
-    /**
-     * Returns the transform placement observers are attached to - the live hull
-     * world transform.
+    /**
+     * Returns the transform placement observers are attached to - the live hull
+     * world transform.
      */
     GetObserverTransform() {
       return this.worldTransform;
     }
 
-    /**
-     * Returns the transform effect children are placed against - the live hull
-     * world transform, not a copy.
+    /**
+     * Returns the transform effect children are placed against - the live hull
+     * world transform, not a copy.
      */
     GetLocalToWorldTransform() {
       return this.worldTransform;
@@ -1365,26 +1367,26 @@ new class extends _identity {
       vec3.transformMat4(out, this.boundingSphereCenter, this.worldTransform);
     }
 
-    /**
-     * Returns the live curve-sampled ball position; the array is the object's own
-     * field and is rewritten by the next transform update.
+    /**
+     * Returns the live curve-sampled ball position; the array is the object's own
+     * field and is rewritten by the next transform update.
      */
     GetWorldPosition() {
       return this.worldPosition;
     }
 
-    /**
-     * Returns the live curve-sampled ball rotation, which excludes the model
-     * rotation curve; the quaternion is the object's own field and is rewritten by
-     * the next transform update.
+    /**
+     * Returns the live curve-sampled ball rotation, which excludes the model
+     * rotation curve; the quaternion is the object's own field and is rewritten by
+     * the next transform update.
      */
     GetWorldRotation() {
       return this.worldRotation;
     }
 
-    /**
-     * Finds a sound emitter by observer name on this hull and then recursively in
-     * the effect children, returning null when no emitter carries the name.
+    /**
+     * Finds a sound emitter by observer name on this hull and then recursively in
+     * the effect children, returning null when no emitter carries the name.
      */
     FindSoundEmitter(name) {
       const target = String(name ?? "");
@@ -1402,9 +1404,9 @@ new class extends _identity {
       return null;
     }
 
-    /**
-     * Sets the mute flag and pushes it to every effect child and placement
-     * observer.
+    /**
+     * Sets the mute flag and pushes it to every effect child and placement
+     * observer.
      */
     SetMute(mute) {
       this.mute = !!mute;
@@ -1416,19 +1418,19 @@ new class extends _identity {
       }
     }
 
-    /**
-     * Plays an animation with explicit loop, start, and speed settings
-     * (Carbon PlayAnimationEx, MAP_METHOD_AND_WRAP_OPTIONAL_ARGS).
+    /**
+     * Plays an animation with explicit loop, start, and speed settings
+     * (Carbon PlayAnimationEx, MAP_METHOD_AND_WRAP_OPTIONAL_ARGS).
      */
     PlayAnimationEx(animName, loopCount, start, speed, clearWhenDone = true) {
       this.#PlayAnimation(animName, true, loopCount, start, speed, clearWhenDone);
     }
 
-    /**
-     * Calculates the skinned bounding box under a transform (CMF path: the
-     * local box corners transformed with perspective divide). The granny path
-     * is unported. Returns an inverted-empty { min, max } box when dynamic
-     * bounds are disabled, as Carbon's BoundingBoxInitialize does.
+    /**
+     * Calculates the skinned bounding box under a transform (CMF path: the
+     * local box corners transformed with perspective divide). The granny path
+     * is unported. Returns an inverted-empty { min, max } box when dynamic
+     * bounds are disabled, as Carbon's BoundingBoxInitialize does.
      */
     CalculateSkinnedBoundingBoxFromTransform(transform) {
       const min = vec3.fromValues(Infinity, Infinity, Infinity);
@@ -1452,10 +1454,10 @@ new class extends _identity {
       };
     }
 
-    /**
-     * Calculates the skinned bounding sphere (CMF path: the current bounding
-     * sphere; granny path unported). Returns (0,0,0,-1) when dynamic bounds
-     * are disabled.
+    /**
+     * Calculates the skinned bounding sphere (CMF path: the current bounding
+     * sphere; granny path unported). Returns (0,0,0,-1) when dynamic bounds
+     * are disabled.
      */
     CalculateSkinnedBoundingSphere(out = vec4.create()) {
       if (this.dynamicBoundingSphereEnabled && this.mesh?.GetGeometryResource()?.IsUsingCMF?.()) {
@@ -1474,9 +1476,9 @@ new class extends _identity {
       }
     }
 
-    /**
-     * Rebuilds the locator sets visible on this object from its own authored sets
-     * plus the sets owned by child meshes and nested child containers.
+    /**
+     * Rebuilds the locator sets visible on this object from its own authored sets
+     * plus the sets owned by child meshes and nested child containers.
      */
     EnsureChildLocatorMerged() {
       if (!this.#mergedLocatorSetsDirty) return;
@@ -1540,11 +1542,11 @@ new class extends _identity {
       this.#damageFilterAreas.length = 0;
     }
 
-    /**
-     * Collects prepared hull and child geometry and opens raycast sessions
-     * (Carbon CollectOccluders, EveSpaceObject2.cpp:1960-2028): occluders carry
-     * areaStart/areaCount ranges into the shared #damageFilterAreas pool, and
-     * records with no matching areas are skipped rather than raycast whole.
+    /**
+     * Collects prepared hull and child geometry and opens raycast sessions
+     * (Carbon CollectOccluders, EveSpaceObject2.cpp:1960-2028): occluders carry
+     * areaStart/areaCount ranges into the shared #damageFilterAreas pool, and
+     * records with no matching areas are skipped rather than raycast whole.
      */
     #CollectDamageFilterOccluders() {
       this.#damageFilterOccluders.length = 0;
@@ -1691,8 +1693,8 @@ new class extends _identity {
       if (this.#damageFilterState === 0) this.#damageFilterState = 1;
     }
 
-    /**
-     * Clears all impact and damage effects on the impact overlay.
+    /**
+     * Clears all impact and damage effects on the impact overlay.
      */
     ClearImpactDamage() {
       if (this.impactOverlay) this.impactOverlay.Clear();
@@ -1703,23 +1705,23 @@ new class extends _identity {
       }
     }
 
-    /**
-     * Clears all animations on the animation updater.
+    /**
+     * Clears all animations on the animation updater.
      */
     ClearAnimations() {
       this.animationUpdater?.ClearAnimations?.();
     }
 
-    /**
-     * Creates an impact facing a position on the closest facing damage locator.
+    /**
+     * Creates an impact facing a position on the closest facing damage locator.
      */
     CreateImpactFromPosition(position, direction, lifeTime, size) {
       const closestDamageLocator = this.#GetClosestLocatorIndex(position, _EveSpaceObject.#damageLocatorSetName);
       return this.CreateImpact(closestDamageLocator, direction, lifeTime, size);
     }
 
-    /**
-     * Creates an impact effect on a damage locator through the impact overlay.
+    /**
+     * Creates an impact effect on a damage locator through the impact overlay.
      */
     CreateImpact(damageLocatorIndex, direction, lifeTime, size) {
       if (this.impactOverlay) {
@@ -1736,16 +1738,16 @@ new class extends _identity {
       return -1;
     }
 
-    /**
-     * Ends the current animation on the animation updater.
+    /**
+     * Ends the current animation on the animation updater.
      */
     EndAnimation() {
       this.animationUpdater?.EndAnimation?.();
     }
 
-    /**
-     * Freezes LOD selection at the current mesh and marks decal geometry
-     * frozen.
+    /**
+     * Freezes LOD selection at the current mesh and marks decal geometry
+     * frozen.
      */
     FreezeHighDetailMesh() {
       this.#allowLodSelection = false;
@@ -1754,23 +1756,23 @@ new class extends _identity {
       }
     }
 
-    /**
-     * Gets the number of damage locators on this object.
+    /**
+     * Gets the number of damage locators on this object.
      */
     GetDamageLocatorCount() {
       return this.GetLocatorCount(_EveSpaceObject.#damageLocatorSetName);
     }
 
-    /**
-     * Gets the number of locators in a named locator set.
+    /**
+     * Gets the number of locators in a named locator set.
      */
     GetLocatorCount(locatorSetName) {
       return this.#GetLocatorsForSet(locatorSetName)?.length ?? 0;
     }
 
-    /**
-     * Gets the first locator list whose set has the requested Carbon name.
-     * The returned list remains owned by the locator set.
+    /**
+     * Gets the first locator list whose set has the requested Carbon name.
+     * The returned list remains owned by the locator set.
      */
     GetLocatorsForSet(locatorSetName) {
       return this.#GetLocatorsForSet(locatorSetName);
@@ -1804,9 +1806,9 @@ new class extends _identity {
       this.InvalidateMergedLocators("structure");
     }
 
-    /**
-     * Gets the closest locator in a set to a world position, ignoring locator
-     * facing. Returns -1 when the set is missing or empty.
+    /**
+     * Gets the closest locator in a set to a world position, ignoring locator
+     * facing. Returns -1 when the set is missing or empty.
      */
     GetCloseLocatorIndex(position, locatorSetName) {
       const locators = this.#GetLocatorsForSet(locatorSetName);
@@ -1830,19 +1832,19 @@ new class extends _identity {
       return closestIndex;
     }
 
-    /**
-     * Carbon's script surface maps GetGoodLocatorIndex to GetCloseLocatorIndex
-     * (EveSpaceObject2_Blue.cpp); the internal randomized fit heuristic is not
-     * script-exposed.
+    /**
+     * Carbon's script surface maps GetGoodLocatorIndex to GetCloseLocatorIndex
+     * (EveSpaceObject2_Blue.cpp); the internal randomized fit heuristic is not
+     * script-exposed.
      */
     GetGoodLocatorIndex(position, locatorSetName) {
       return this.GetCloseLocatorIndex(position, locatorSetName);
     }
 
-    /**
-     * Gets the local direction of an indexed damage locator, (0,0,0) for
-     * indices out of range (Carbon script GetDamageLocatorDirection maps to
-     * GetDamageLocatorDirectionLocal).
+    /**
+     * Gets the local direction of an indexed damage locator, (0,0,0) for
+     * indices out of range (Carbon script GetDamageLocatorDirection maps to
+     * GetDamageLocatorDirectionLocal).
      */
     GetDamageLocatorDirection(index, inWorldSpaceOrOut = vec3.create(), out = vec3.create()) {
       const targetableCall = typeof inWorldSpaceOrOut === "boolean";
@@ -1871,10 +1873,10 @@ new class extends _identity {
       return true;
     }
 
-    /**
-     * Gets a damage locator's BIND position in object space - the merged set's
-     * authored position, no animation (Carbon EveSpaceObject2.cpp:2785-2796).
-     * Impact overlays seed decals here so they stay put on animated parts.
+    /**
+     * Gets a damage locator's BIND position in object space - the merged set's
+     * authored position, no animation (Carbon EveSpaceObject2.cpp:2785-2796).
+     * Impact overlays seed decals here so they stay put on animated parts.
      */
     GetDamageLocatorBindPosition(index, out = vec3.create()) {
       const locators = this.#GetLocatorsForSet(_EveSpaceObject.#damageLocatorSetName);
@@ -2015,9 +2017,9 @@ new class extends _identity {
       return false;
     }
 
-    /**
-     * Gets the local position of an indexed damage locator, (0,0,0) for
-     * indices out of range.
+    /**
+     * Gets the local position of an indexed damage locator, (0,0,0) for
+     * indices out of range.
      */
     GetDamageLocator(index, out = vec3.create()) {
       const locators = this.#GetLocatorsForSet(_EveSpaceObject.#damageLocatorSetName);
@@ -2029,9 +2031,9 @@ new class extends _identity {
       return out;
     }
 
-    /**
-     * Gets the world-space position of an indexed damage locator, (0,0,0) for
-     * indices out of range (returned untransformed, as Carbon does).
+    /**
+     * Gets the world-space position of an indexed damage locator, (0,0,0) for
+     * indices out of range (returned untransformed, as Carbon does).
      */
     GetTransformedDamageLocator(index, out = vec3.create()) {
       const locators = this.#GetLocatorsForSet(_EveSpaceObject.#damageLocatorSetName);
@@ -2043,18 +2045,18 @@ new class extends _identity {
       return vec3.transformMat4(out, out, this.worldTransform);
     }
 
-    /**
-     * Checks whether this object is in impostor mode. The impostor system that
-     * raises the flag is unported, so this reports the default until then.
+    /**
+     * Checks whether this object is in impostor mode. The impostor system that
+     * raises the flag is unported, so this reports the default until then.
      */
     IsImpostor() {
       return this.#impostorMode;
     }
 
-    /**
-     * Gets a locator position from a named set. Out-of-range or missing-set
-     * queries return the world translation in world space and (0,0,0) in
-     * object space, as Carbon does.
+    /**
+     * Gets a locator position from a named set. Out-of-range or missing-set
+     * queries return the world translation in world space and (0,0,0) in
+     * object space, as Carbon does.
      */
     GetLocatorPositionFromSet(index, inWorldSpace, locatorSetName, out = vec3.create()) {
       const locators = this.#GetLocatorsForSet(locatorSetName);
@@ -2072,9 +2074,9 @@ new class extends _identity {
       return out;
     }
 
-    /**
-     * Gets a locator direction from a named set. Out-of-range or missing-set
-     * queries return (0,1,0), as Carbon does.
+    /**
+     * Gets a locator direction from a named set. Out-of-range or missing-set
+     * queries return (0,1,0), as Carbon does.
      */
     GetLocatorRotationFromSet(index, inWorldSpace, locatorSetName, out = vec3.create()) {
       const locators = this.#GetLocatorsForSet(locatorSetName);
@@ -2089,9 +2091,9 @@ new class extends _identity {
       return out;
     }
 
-    /**
-     * Raises a named controller event on this hull's controllers and forwards it
-     * to the effect children and overlay effects.
+    /**
+     * Raises a named controller event on this hull's controllers and forwards it
+     * to the effect children and overlay effects.
      */
     HandleControllerEvent(name) {
       const eventName = String(name ?? "");
@@ -2106,24 +2108,24 @@ new class extends _identity {
       }
     }
 
-    /**
-     * Plays an animation once, replacing the current one
-     * (Carbon script PlayAnimation maps to PlayAnimationOnce).
+    /**
+     * Plays an animation once, replacing the current one
+     * (Carbon script PlayAnimation maps to PlayAnimationOnce).
      */
     PlayAnimation(animName) {
       this.#PlayAnimation(animName, true, 1, 0, 1, true);
     }
 
-    /**
-     * Chains an animation once after the current one (Carbon ChainAnimation).
+    /**
+     * Chains an animation once after the current one (Carbon ChainAnimation).
      */
     ChainAnimation(animName) {
       this.#PlayAnimation(animName, false, 1, 0, 1, true);
     }
 
-    /**
-     * Chains an animation with explicit loop, start, and speed settings
-     * (Carbon ChainAnimationEx).
+    /**
+     * Chains an animation with explicit loop, start, and speed settings
+     * (Carbon ChainAnimationEx).
      */
     ChainAnimationEx(animName, loopCount, start, speed) {
       this.#PlayAnimation(animName, false, loopCount, start, speed, true);
@@ -2133,17 +2135,17 @@ new class extends _identity {
     // into the animation updater, which owns playback state; a missing updater
     // is a Carbon-faithful no-op.
 
-    /**
-     * Forwards a playback request to the animation updater, which owns all
-     * animation state; a hull without an updater does nothing, as in Carbon.
+    /**
+     * Forwards a playback request to the animation updater, which owns all
+     * animation state; a hull without an updater does nothing, as in Carbon.
      */
     #PlayAnimation(animName, replace, loopCount, delay, speed, clearWhenDone) {
       this.animationUpdater?.PlayAnimation?.(String(animName ?? ""), replace, loopCount, delay, speed, clearWhenDone);
     }
 
-    /**
-     * Recalculates the authored bounding sphere from the mesh geometry
-     * resource. Fails when no mesh or ready geometry resource is attached.
+    /**
+     * Recalculates the authored bounding sphere from the mesh geometry
+     * resource. Fails when no mesh or ready geometry resource is attached.
      */
     RebuildBoundingSphereInformation() {
       const mesh = this.mesh;
@@ -2170,13 +2172,12 @@ new class extends _identity {
       } else {
         this.boundingSphereRadius = sph3.extract(sphere, this.boundingSphereCenter);
       }
-      this.UpdateWorldBounds();
       return this;
     }
 
-    /**
-     * Returns a plain-object snapshot of the controller variables currently
-     * stamped on this hull.
+    /**
+     * Returns a plain-object snapshot of the controller variables currently
+     * stamped on this hull.
      */
     GetControllerVariables() {
       return Object.fromEntries(this.#controllerVariables);
@@ -2190,11 +2191,11 @@ new class extends _identity {
       return geometryResource.GetLodIndexForScreenSize?.(this.mesh?.GetMeshIndex?.() ?? 0, this.#meshScreenSize) ?? 0;
     }
 
-    /**
-     * Gets a named locator's transform (Carbon script GetLocatorTransform maps
-     * to GetEveLocatorTransform): the identity for unknown names, the animated
-     * bone world transform when the animation updater resolves the name, else
-     * the authored locator transform.
+    /**
+     * Gets a named locator's transform (Carbon script GetLocatorTransform maps
+     * to GetEveLocatorTransform): the identity for unknown names, the animated
+     * bone world transform when the animation updater resolves the name, else
+     * the authored locator transform.
      */
     GetLocatorTransform(name, out = mat4.create()) {
       const target = String(name ?? "");
@@ -2214,11 +2215,11 @@ new class extends _identity {
       return mat4.copy(out, locator.GetTransform());
     }
 
-    /**
-     * Gets the local axis-aligned bounding box: dynamic skinned bounds when
-     * enabled, else the mesh box, else the cached box (at worst it lags one
-     * frame). With out arguments it fills them and returns true; without, it
-     * returns { min, max }.
+    /**
+     * Gets the local axis-aligned bounding box: dynamic skinned bounds when
+     * enabled, else the mesh box, else the cached box (at worst it lags one
+     * frame). With out arguments it fills them and returns true; without, it
+     * returns { min, max }.
      */
     GetLocalBoundingBox(minBounds, maxBounds) {
       const min = vec3.create();
@@ -2268,12 +2269,12 @@ new class extends _identity {
       return geometryResource ? geometryResource.IsGood() : false;
     }
 
-    /**
-     * Gets Carbon's realized world sphere, optionally accumulated with transform
-     * and effect children when query is EVE_BOUNDS_WITH_CHILDREN.
+    /**
+     * Gets Carbon's realized world sphere, optionally accumulated with transform
+     * and effect children when query is EVE_BOUNDS_WITH_CHILDREN.
      */
     GetBoundingSphere(out = sph3.create(), query = 0) {
-      if (!this.UpdateWorldBounds()) return false;
+      if (this.boundingSphereRadius <= 0 && this.#dynamicBoundingSphere[3] <= 0) return false;
       _EveSpaceObject.#SetSphere(out, this.modelWorldPosition, this.#boundingSphereWorldRadius);
       if (!query || !this.DisplayChildren()) return true;
       for (const child of this.children) {
@@ -2306,9 +2307,9 @@ new class extends _identity {
       return this.#isInFrustum;
     }
 
-    /**
-     * Gets the bounding sphere center, preferring the dynamic skinned sphere
-     * when one is published.
+    /**
+     * Gets the bounding sphere center, preferring the dynamic skinned sphere
+     * when one is published.
      */
     GetBoundingSphereCenter(out = vec3.create()) {
       if (this.#dynamicBoundingSphere[3] !== -1) {
@@ -2317,9 +2318,9 @@ new class extends _identity {
       return vec3.copy(out, this.boundingSphereCenter);
     }
 
-    /**
-     * Gets the model-scaled bounding sphere radius, preferring the dynamic
-     * skinned sphere when one is published.
+    /**
+     * Gets the model-scaled bounding sphere radius, preferring the dynamic
+     * skinned sphere when one is published.
      */
     GetBoundingSphereRadius() {
       if (this.#dynamicBoundingSphere[3] !== -1) {
@@ -2328,9 +2329,9 @@ new class extends _identity {
       return this.modelScale * this.boundingSphereRadius;
     }
 
-    /**
-     * Gets the number of mesh-bound bones. Carbon dereferences the animation
-     * updater unchecked; CarbonEngineJS reports 0 when none is attached.
+    /**
+     * Gets the number of mesh-bound bones. Carbon dereferences the animation
+     * updater unchecked; CarbonEngineJS reports 0 when none is attached.
      */
     GetBoneCount() {
       const updater = this.animationUpdater;
@@ -2346,10 +2347,10 @@ new class extends _identity {
       return updater.GetMeshBindingBoneCount?.() ?? 0;
     }
 
-    /**
-     * Pushes shield, armor and hull damage levels to the impact overlay and
-     * mirrors them into the ShieldDamage, ArmorDamage and HullDamage controller
-     * variables so bound effects follow.
+    /**
+     * Pushes shield, armor and hull damage levels to the impact overlay and
+     * mirrors them into the ShieldDamage, ArmorDamage and HullDamage controller
+     * variables so bound effects follow.
      */
     SetImpactDamageState(shield, armor, hull, doCreateArmorImpacts = true) {
       if (this.impactOverlay) {
@@ -2365,8 +2366,8 @@ new class extends _identity {
       this.SetControllerVariable("HullDamage", hull);
     }
 
-    /**
-     * Toggles a named impact-overlay animation (boosters, hardeners, ...).
+    /**
+     * Toggles a named impact-overlay animation (boosters, hardeners, ...).
      */
     SetImpactAnimation(name, enable, duration) {
       if (!this.impactOverlay) return;
@@ -2398,10 +2399,10 @@ new class extends _identity {
       return overlay;
     }
 
-    /**
-     * Stores a controller variable on the hull and pushes it to the controllers,
-     * effect children and overlay effects; the stored value is replayed onto
-     * controllers and children added later.
+    /**
+     * Stores a controller variable on the hull and pushes it to the controllers,
+     * effect children and overlay effects; the stored value is replayed onto
+     * controllers and children added later.
      */
     SetControllerVariable(name, value) {
       const key = String(name ?? "");
@@ -2418,9 +2419,9 @@ new class extends _identity {
       }
     }
 
-    /**
-     * Forwards a procedural-container variable to every effect child; the hull
-     * itself keeps no copy.
+    /**
+     * Forwards a procedural-container variable to every effect child; the hull
+     * itself keeps no copy.
      */
     SetProceduralContainerVariable(name, value) {
       for (const child of this.effectChildren) {
@@ -2428,9 +2429,9 @@ new class extends _identity {
       }
     }
 
-    /**
-     * Starts this hull's controllers and those of its effect children and overlay
-     * effects.
+    /**
+     * Starts this hull's controllers and those of its effect children and overlay
+     * effects.
      */
     StartControllers() {
       for (const controller of this.controllers) {
@@ -2444,13 +2445,13 @@ new class extends _identity {
       }
     }
 
-    /**
-     * Applies bone and model transforms to locators and returns
-     * [position, rotation, boneIndex] tuples, as the Carbon script surface
-     * does (TransformLocators maps to PyTransformLocators). Accepts either
-     * locator records ({ position, direction, boneIndex }, Carbon's
-     * LocatorStructureList shape) or the same [position, rotation, boneIndex]
-     * tuple shape it returns.
+    /**
+     * Applies bone and model transforms to locators and returns
+     * [position, rotation, boneIndex] tuples, as the Carbon script surface
+     * does (TransformLocators maps to PyTransformLocators). Accepts either
+     * locator records ({ position, direction, boneIndex }, Carbon's
+     * LocatorStructureList shape) or the same [position, rotation, boneIndex]
+     * tuple shape it returns.
      */
     TransformLocators(locators = []) {
       const result = [];
@@ -2479,10 +2480,10 @@ new class extends _identity {
     // Carbon Blue TransformLocator: bone-attached records pick up the mesh
     // bone matrix; without bone data the authored values pass through.
 
-    /**
-     * Applies the mesh bone matrix to a locator position and rotation for
-     * bone-attached locators; the authored values pass through unchanged when
-     * there is no usable bone data.
+    /**
+     * Applies the mesh bone matrix to a locator position and rotation for
+     * bone-attached locators; the authored values pass through unchanged when
+     * there is no usable bone data.
      */
     #TransformLocator(position, rotation, boneIndex) {
       const updater = this.animationUpdater;
@@ -2502,10 +2503,10 @@ new class extends _identity {
     // origin (pure GetValueAt, no playback advance): translation adds, model
     // rotation rotates the position and pre-multiplies.
 
-    /**
-     * Applies the model translation and rotation curves sampled at time 0 to a
-     * locator position and rotation, matching Carbon's Blue locator surface, which
-     * reads the curves without advancing playback.
+    /**
+     * Applies the model translation and rotation curves sampled at time 0 to a
+     * locator position and rotation, matching Carbon's Blue locator surface, which
+     * reads the curves without advancing playback.
      */
     #ApplyModelTransform(position, rotation) {
       if (this.modelTranslationCurve) {
@@ -2523,9 +2524,9 @@ new class extends _identity {
 
     // Carbon GetLocatorsForSet: first set matching the name wins.
 
-    /**
-     * Returns the locator list of the first locator set carrying the name, or null
-     * when no set matches; the list stays owned by the locator set.
+    /**
+     * Returns the locator list of the first locator set carrying the name, or null
+     * when no set matches; the list stays owned by the locator set.
      */
     #GetLocatorsForSet(locatorSetName) {
       const target = String(locatorSetName ?? "");
@@ -2538,19 +2539,19 @@ new class extends _identity {
       return null;
     }
 
-    /**
-     * Writes a locator's object-space position and direction (Carbon
-     * EveSpaceObject2.cpp:3751-3772, rewritten upstream by 3d988b1d).
-     *
-     * A merged damage locator (mergedDamageIndex >= 0, indexing the merged
-     * damage set) delegates to the owning child's animated pose - the locator's
-     * boneIndex addresses the CHILD's skeleton, never this object's - then
-     * lifts the result through the range's childToObject transform; Carbon
-     * normalizes the direction HERE but not in EveGetLocatorPose, and that
-     * asymmetry is preserved. Every other locator resolves against this
-     * object's own animation updater.
-     *
-     * Overridable on purpose: Carbon's EveSwarm overrides this.
+    /**
+     * Writes a locator's object-space position and direction (Carbon
+     * EveSpaceObject2.cpp:3751-3772, rewritten upstream by 3d988b1d).
+     *
+     * A merged damage locator (mergedDamageIndex >= 0, indexing the merged
+     * damage set) delegates to the owning child's animated pose - the locator's
+     * boneIndex addresses the CHILD's skeleton, never this object's - then
+     * lifts the result through the range's childToObject transform; Carbon
+     * normalizes the direction HERE but not in EveGetLocatorPose, and that
+     * asymmetry is preserved. Every other locator resolves against this
+     * object's own animation updater.
+     *
+     * Overridable on purpose: Carbon's EveSwarm overrides this.
      */
     GetLocatorInObjectSpace(outPosition, outDirection, locator, mergedDamageIndex = -1) {
       if (mergedDamageIndex >= 0) {
@@ -2573,10 +2574,10 @@ new class extends _identity {
     // Carbon GetClosestLocatorIndex: facing-gated closest search; 0 when the
     // set is missing, -1 when no locator faces the position.
 
-    /**
-     * Returns the index of the nearest locator in a named set that faces the given
-     * world position - 0 when the set is missing, -1 when no locator faces the
-     * position.
+    /**
+     * Returns the index of the nearest locator in a named set that faces the given
+     * world position - 0 when the set is missing, -1 when no locator faces the
+     * position.
      */
     #GetClosestLocatorIndex(position, locatorSetName) {
       const locators = this.#GetLocatorsForSet(locatorSetName);
@@ -2603,9 +2604,9 @@ new class extends _identity {
       return closestIndex;
     }
 
-    /**
-     * Reports whether a locator faces a position, by testing that stepping the
-     * object-space position back along the locator direction shortens it.
+    /**
+     * Reports whether a locator faces a position, by testing that stepping the
+     * object-space position back along the locator direction shortens it.
      */
 
     /** Rotates a direction by a matrix's rotation basis, ignoring its translation. */
@@ -2629,15 +2630,15 @@ new class extends _identity {
       vec3.copy(this.generatedShapeEllipsoidRadius, outRadii);
     }
 
-    /**
-     * Maps the negated dot product of a locator direction and an offset direction
-     * onto Carbon's square-root fit score, the ranking used to pick a varied
-     * damage locator.
+    /**
+     * Maps the negated dot product of a locator direction and an offset direction
+     * onto Carbon's square-root fit score, the ranking used to pick a varied
+     * damage locator.
      */
 
-    /**
-     * Intersects a ray with an axis-aligned ellipsoid in the ellipsoid's own space and writes the hit point into out.
-     * @returns {number|null} The ray parameter at the hit, or null when the ray is degenerate or misses.
+    /**
+     * Intersects a ray with an axis-aligned ellipsoid in the ellipsoid's own space and writes the hit point into out.
+     * @returns {number|null} The ray parameter at the hit, or null when the ray is degenerate or misses.
      */
 
     /** Reports whether a point lies inside an axis-aligned ellipsoid. */
@@ -2645,42 +2646,42 @@ new class extends _identity {
     // Mesh bone matrices come from the animation updater; only mat4-shaped
     // entries are usable.
 
-    /**
-     * Unpacks one bone from the updater's palette into a mat4, or null when the
-     * index is out of range.
-     *
-     * The palette is Carbon's storage - one contiguous Float4x3 buffer, stride
-     * 12 - so a bone is expanded rather than borrowed. Carbon does the same at
-     * every read site with TriMatrixCopyFrom3x4.
+    /**
+     * Unpacks one bone from the updater's palette into a mat4, or null when the
+     * index is out of range.
+     *
+     * The palette is Carbon's storage - one contiguous Float4x3 buffer, stride
+     * 12 - so a bone is expanded rather than borrowed. Carbon does the same at
+     * every read site with TriMatrixCopyFrom3x4.
      */
 
-    /**
-     * Replays every stored controller variable onto a newly added controller or
-     * effect child through the named setter, so late additions start with the same
-     * state.
+    /**
+     * Replays every stored controller variable onto a newly added controller or
+     * effect child through the named setter, so late additions start with the same
+     * state.
      */
 
-    /**
-     * Samples a curve into out through whichever of Update or GetValueAt it
-     * exposes, writing the fallback when there is no curve and copying back curves
-     * that return a new array instead of filling out.
+    /**
+     * Samples a curve into out through whichever of Update or GetValueAt it
+     * exposes, writing the fallback when there is no curve and copying back curves
+     * that return a new array instead of filling out.
      */
 
-    /**
-     * Reads a numeric value from the update context, preferring a getter method
-     * and falling back to the named properties, and yields 0 when nothing supplies
-     * it.
+    /**
+     * Reads a numeric value from the update context, preferring a getter method
+     * and falling back to the named properties, and yields 0 when nothing supplies
+     * it.
      */
 
-    /**
-     * Returns a world sphere's on-screen diameter in pixels from the frustum's
-     * exact query, or 0 when the frustum does not expose it.
+    /**
+     * Returns a world sphere's on-screen diameter in pixels from the frustum's
+     * exact query, or 0 when the frustum does not expose it.
      */
 
-    /**
-     * Returns a world sphere's on-screen diameter in pixels, preferring the
-     * frustum's cheaper estimated query and falling back to the exact one, or 0
-     * when the frustum exposes neither.
+    /**
+     * Returns a world sphere's on-screen diameter in pixels, preferring the
+     * frustum's cheaper estimated query and falling back to the exact one, or 0
+     * when the frustum exposes neither.
      */
 
     /** Writes a center and radius into a caller-owned sph3. */