@carbonenginejs/runtime-trinity 0.6.0 → 0.7.0

package/dist/eve/spaceObject/EveSpaceObject2.js

@@ -1,6 +1,6 @@
 import { identity as _identity, applyDecs2311 as _applyDecs2311 } from '../../_virtual/_rollupPluginBabelHelpers.js';
 import { io, type, carbon, impl, schema } from '@carbonenginejs/runtime-utils/schema';
-import { EveEntity as _EveEntity } from '../../generated/eve/EveEntity.js';
+import { EveEntity as _EveEntity } from '../EveEntity.js';
 import { EveChildUpdateParams as _EveChildUpdateParams } from '../EveChildUpdateParams.js';
 import { EveChildInheritProperties as _EveChildInheritPrope } from '../child/EveChildInheritProperties.js';
 import { box3 } from '@carbonenginejs/runtime-utils/box3';
@@ -12,12 +12,18 @@ import { vec4 } from '@carbonenginejs/runtime-utils/vec4';
 import { ReflectionMode } from '../../generated/eve/enums.js';
 import { EveComponentType, ShouldReflect } from '../EveComponentTypes.js';
 import { ImpactConfiguration } from '../../generated/include/enums.js';
-import { Tr2Lod, EveLODHelper } from '../EveLODHelper.js';
+import { EveLODHelper } from '../EveLODHelper.js';
 import { TriBatchType } from '@carbonenginejs/runtime-utils/graphics';
-import { Tr2PerObjectData } from '../../trinityCore/Tr2PerObjectData.js';
+import { MatrixCopyFrom3x4 } from '../lights/lightConversion.js';
+import { getBoneList } from '../../trinityCore/Tr2GrannyAnimation.js';
 import { TriRenderBatchAreaBlock, Tr2RenderBatch } from '../../trinityCore/Tr2RenderBatch.js';
+import { RawData } from '../../trinityCore/rawData/RawData.js';
+import { TR2_PICK_TYPE_DEFAULT, Tr2PickType } from '../../trinityCore/Tr2PickType.js';
+import { IEveSpaceObject2ParentData as _IEveSpaceObject2Pare } from './IEveSpaceObject2ParentData.js';
+import { EveCustomMask as _EveCustomMask } from '../EveCustomMask.js';
+import { Tr2Lod } from '@carbonenginejs/runtime-utils/const/trinity';
 
-let _initProto, _initClass, _init_reflectionMode, _init_extra_reflectionMode, _init_effectChildren, _init_extra_effectChildren, _init_children, _init_extra_children, _init_name, _init_extra_name, _init_mute, _init_extra_mute, _init_inheritProperties, _init_extra_inheritProperties, _init_customMasks, _init_extra_customMasks, _init_overlayEffects, _init_extra_overlayEffects, _init_positionDelta, _init_extra_positionDelta, _init_lodLevel, _init_extra_lodLevel, _init_curveSets, _init_extra_curveSets, _init_isPickable, _init_extra_isPickable, _init_estimatedPixelDiameter, _init_extra_estimatedPixelDiameter, _init_estimatedPixelDiameterWithChildren, _init_extra_estimatedPixelDiameterWithChildren, _init_generatedShapeEllipsoidCenter, _init_extra_generatedShapeEllipsoidCenter, _init_generatedShapeEllipsoidRadius, _init_extra_generatedShapeEllipsoidRadius, _init_animationUpdater, _init_extra_animationUpdater, _init_dna, _init_extra_dna, _init_castShadow, _init_extra_castShadow, _init_isAnimated, _init_extra_isAnimated, _init_dynamicBoundingSphereEnabled, _init_extra_dynamicBoundingSphereEnabled, _init_attachments, _init_extra_attachments, _init_decals, _init_extra_decals, _init_lights, _init_extra_lights, _init_externalParameters, _init_extra_externalParameters, _init_controllers, _init_extra_controllers, _init_locators, _init_extra_locators, _init_mesh, _init_extra_mesh, _init_impactOverlay, _init_extra_impactOverlay, _init_clipSphereCenter, _init_extra_clipSphereCenter, _init_clipSphereFactor, _init_extra_clipSphereFactor, _init_clipSphereFactor2, _init_extra_clipSphereFactor2, _init_observers, _init_extra_observers, _init_worldPosition, _init_extra_worldPosition, _init_rotationCurve, _init_extra_rotationCurve, _init_worldRotation, _init_extra_worldRotation, _init_modelScale, _init_extra_modelScale, _init_locatorSets, _init_extra_locatorSets, _init_activationStrength, _init_extra_activationStrength, _init_albedoColor, _init_extra_albedoColor, _init_display, _init_extra_display, _init_update, _init_extra_update, _init_secondaryLightingSphereRadius, _init_extra_secondaryLightingSphereRadius, _init_boundingSphereCenter, _init_extra_boundingSphereCenter, _init_dirtLevel, _init_extra_dirtLevel, _init_customShaderData, _init_extra_customShaderData, _init_lastDamageLocatorHit, _init_extra_lastDamageLocatorHit, _init_boundingSphereRadius, _init_extra_boundingSphereRadius, _init_modelWorldPosition, _init_extra_modelWorldPosition, _init_modelTranslationCurve, _init_extra_modelTranslationCurve, _init_modelRotationCurve, _init_extra_modelRotationCurve, _init_shapeEllipsoidCenter, _init_extra_shapeEllipsoidCenter, _init_shapeEllipsoidRadius, _init_extra_shapeEllipsoidRadius, _init_translationCurve, _init_extra_translationCurve, _init_worldTransform, _init_extra_worldTransform, _init_inverseWorldTransform, _init_extra_inverseWorldTransform, _init_lastWorldTransform, _init_extra_lastWorldTransform, _init_worldVelocity, _init_extra_worldVelocity, _init_audioGeometry, _init_extra_audioGeometry, _init_isVisible, _init_extra_isVisible;
+let _initProto, _initClass, _init_reflectionMode, _init_extra_reflectionMode, _init_effectChildren, _init_extra_effectChildren, _init_children, _init_extra_children, _init_name, _init_extra_name, _init_mute, _init_extra_mute, _init_inheritProperties, _init_extra_inheritProperties, _init_customMasks, _init_extra_customMasks, _init_overlayEffects, _init_extra_overlayEffects, _init_positionDelta, _init_extra_positionDelta, _init_lodLevel, _init_extra_lodLevel, _init_curveSets, _init_extra_curveSets, _init_isPickable, _init_extra_isPickable, _init_estimatedPixelDiameter, _init_extra_estimatedPixelDiameter, _init_estimatedPixelDiameterWithChildren, _init_extra_estimatedPixelDiameterWithChildren, _init_generatedShapeEllipsoidCenter, _init_extra_generatedShapeEllipsoidCenter, _init_generatedShapeEllipsoidRadius, _init_extra_generatedShapeEllipsoidRadius, _init_animationUpdater, _init_extra_animationUpdater, _init_dna, _init_extra_dna, _init_castShadow, _init_extra_castShadow, _init_isAnimated, _init_extra_isAnimated, _init_dynamicBoundingSphereEnabled, _init_extra_dynamicBoundingSphereEnabled, _init_attachments, _init_extra_attachments, _init_decals, _init_extra_decals, _init_lights, _init_extra_lights, _init_externalParameters, _init_extra_externalParameters, _init_controllers, _init_extra_controllers, _init_locators, _init_extra_locators, _init_mesh, _init_extra_mesh, _init_impactOverlay, _init_extra_impactOverlay, _init_clipSphereCenter, _init_extra_clipSphereCenter, _init_clipSphereFactor, _init_extra_clipSphereFactor, _init_clipSphereFactor2, _init_extra_clipSphereFactor2, _init_observers, _init_extra_observers, _init_worldPosition, _init_extra_worldPosition, _init_rotationCurve, _init_extra_rotationCurve, _init_worldRotation, _init_extra_worldRotation, _init_modelScale, _init_extra_modelScale, _init_locatorSets, _init_extra_locatorSets, _init_activationStrength, _init_extra_activationStrength, _init_albedoColor, _init_extra_albedoColor, _init_display, _init_extra_display, _init_update, _init_extra_update, _init_secondaryLightingSphereRadius, _init_extra_secondaryLightingSphereRadius, _init_boundingSphereCenter, _init_extra_boundingSphereCenter, _init_dirtLevel, _init_extra_dirtLevel, _init_customShaderData, _init_extra_customShaderData, _init_spaceObjectShipData, _init_extra_spaceObjectShipData, _init_lastDamageLocatorHit, _init_extra_lastDamageLocatorHit, _init_boundingSphereRadius, _init_extra_boundingSphereRadius, _init_modelWorldPosition, _init_extra_modelWorldPosition, _init_modelTranslationCurve, _init_extra_modelTranslationCurve, _init_modelRotationCurve, _init_extra_modelRotationCurve, _init_shapeEllipsoidCenter, _init_extra_shapeEllipsoidCenter, _init_shapeEllipsoidRadius, _init_extra_shapeEllipsoidRadius, _init_translationCurve, _init_extra_translationCurve, _init_worldTransform, _init_extra_worldTransform, _init_inverseWorldTransform, _init_extra_inverseWorldTransform, _init_lastWorldTransform, _init_extra_lastWorldTransform, _init_worldVelocity, _init_extra_worldVelocity, _init_audioGeometry, _init_extra_audioGeometry, _init_isVisible, _init_extra_isVisible;
 
 // Static scratch for the sorted-transparent area pass (allocation rules: hot
 // per-frame path, copy-into, never allocate per call).
@@ -28,17 +34,24 @@ const TRANSPARENT_CENTER = vec3.create();
 // Carbon EveMeshOverlayEffect::OverlayType (EveMeshOverlayEffect.h:35-41).
 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.
+ */
 let _EveSpaceObject;
 new class extends _identity {
   static [class EveSpaceObject2 extends _EveEntity {
     static {
       ({
-        e: [_init_reflectionMode, _init_extra_reflectionMode, _init_effectChildren, _init_extra_effectChildren, _init_children, _init_extra_children, _init_name, _init_extra_name, _init_mute, _init_extra_mute, _init_inheritProperties, _init_extra_inheritProperties, _init_customMasks, _init_extra_customMasks, _init_overlayEffects, _init_extra_overlayEffects, _init_positionDelta, _init_extra_positionDelta, _init_lodLevel, _init_extra_lodLevel, _init_curveSets, _init_extra_curveSets, _init_isPickable, _init_extra_isPickable, _init_estimatedPixelDiameter, _init_extra_estimatedPixelDiameter, _init_estimatedPixelDiameterWithChildren, _init_extra_estimatedPixelDiameterWithChildren, _init_generatedShapeEllipsoidCenter, _init_extra_generatedShapeEllipsoidCenter, _init_generatedShapeEllipsoidRadius, _init_extra_generatedShapeEllipsoidRadius, _init_animationUpdater, _init_extra_animationUpdater, _init_dna, _init_extra_dna, _init_castShadow, _init_extra_castShadow, _init_isAnimated, _init_extra_isAnimated, _init_dynamicBoundingSphereEnabled, _init_extra_dynamicBoundingSphereEnabled, _init_attachments, _init_extra_attachments, _init_decals, _init_extra_decals, _init_lights, _init_extra_lights, _init_externalParameters, _init_extra_externalParameters, _init_controllers, _init_extra_controllers, _init_locators, _init_extra_locators, _init_mesh, _init_extra_mesh, _init_impactOverlay, _init_extra_impactOverlay, _init_clipSphereCenter, _init_extra_clipSphereCenter, _init_clipSphereFactor, _init_extra_clipSphereFactor, _init_clipSphereFactor2, _init_extra_clipSphereFactor2, _init_observers, _init_extra_observers, _init_worldPosition, _init_extra_worldPosition, _init_rotationCurve, _init_extra_rotationCurve, _init_worldRotation, _init_extra_worldRotation, _init_modelScale, _init_extra_modelScale, _init_locatorSets, _init_extra_locatorSets, _init_activationStrength, _init_extra_activationStrength, _init_albedoColor, _init_extra_albedoColor, _init_display, _init_extra_display, _init_update, _init_extra_update, _init_secondaryLightingSphereRadius, _init_extra_secondaryLightingSphereRadius, _init_boundingSphereCenter, _init_extra_boundingSphereCenter, _init_dirtLevel, _init_extra_dirtLevel, _init_customShaderData, _init_extra_customShaderData, _init_lastDamageLocatorHit, _init_extra_lastDamageLocatorHit, _init_boundingSphereRadius, _init_extra_boundingSphereRadius, _init_modelWorldPosition, _init_extra_modelWorldPosition, _init_modelTranslationCurve, _init_extra_modelTranslationCurve, _init_modelRotationCurve, _init_extra_modelRotationCurve, _init_shapeEllipsoidCenter, _init_extra_shapeEllipsoidCenter, _init_shapeEllipsoidRadius, _init_extra_shapeEllipsoidRadius, _init_translationCurve, _init_extra_translationCurve, _init_worldTransform, _init_extra_worldTransform, _init_inverseWorldTransform, _init_extra_inverseWorldTransform, _init_lastWorldTransform, _init_extra_lastWorldTransform, _init_worldVelocity, _init_extra_worldVelocity, _init_audioGeometry, _init_extra_audioGeometry, _init_isVisible, _init_extra_isVisible, _initProto],
+        e: [_init_reflectionMode, _init_extra_reflectionMode, _init_effectChildren, _init_extra_effectChildren, _init_children, _init_extra_children, _init_name, _init_extra_name, _init_mute, _init_extra_mute, _init_inheritProperties, _init_extra_inheritProperties, _init_customMasks, _init_extra_customMasks, _init_overlayEffects, _init_extra_overlayEffects, _init_positionDelta, _init_extra_positionDelta, _init_lodLevel, _init_extra_lodLevel, _init_curveSets, _init_extra_curveSets, _init_isPickable, _init_extra_isPickable, _init_estimatedPixelDiameter, _init_extra_estimatedPixelDiameter, _init_estimatedPixelDiameterWithChildren, _init_extra_estimatedPixelDiameterWithChildren, _init_generatedShapeEllipsoidCenter, _init_extra_generatedShapeEllipsoidCenter, _init_generatedShapeEllipsoidRadius, _init_extra_generatedShapeEllipsoidRadius, _init_animationUpdater, _init_extra_animationUpdater, _init_dna, _init_extra_dna, _init_castShadow, _init_extra_castShadow, _init_isAnimated, _init_extra_isAnimated, _init_dynamicBoundingSphereEnabled, _init_extra_dynamicBoundingSphereEnabled, _init_attachments, _init_extra_attachments, _init_decals, _init_extra_decals, _init_lights, _init_extra_lights, _init_externalParameters, _init_extra_externalParameters, _init_controllers, _init_extra_controllers, _init_locators, _init_extra_locators, _init_mesh, _init_extra_mesh, _init_impactOverlay, _init_extra_impactOverlay, _init_clipSphereCenter, _init_extra_clipSphereCenter, _init_clipSphereFactor, _init_extra_clipSphereFactor, _init_clipSphereFactor2, _init_extra_clipSphereFactor2, _init_observers, _init_extra_observers, _init_worldPosition, _init_extra_worldPosition, _init_rotationCurve, _init_extra_rotationCurve, _init_worldRotation, _init_extra_worldRotation, _init_modelScale, _init_extra_modelScale, _init_locatorSets, _init_extra_locatorSets, _init_activationStrength, _init_extra_activationStrength, _init_albedoColor, _init_extra_albedoColor, _init_display, _init_extra_display, _init_update, _init_extra_update, _init_secondaryLightingSphereRadius, _init_extra_secondaryLightingSphereRadius, _init_boundingSphereCenter, _init_extra_boundingSphereCenter, _init_dirtLevel, _init_extra_dirtLevel, _init_customShaderData, _init_extra_customShaderData, _init_spaceObjectShipData, _init_extra_spaceObjectShipData, _init_lastDamageLocatorHit, _init_extra_lastDamageLocatorHit, _init_boundingSphereRadius, _init_extra_boundingSphereRadius, _init_modelWorldPosition, _init_extra_modelWorldPosition, _init_modelTranslationCurve, _init_extra_modelTranslationCurve, _init_modelRotationCurve, _init_extra_modelRotationCurve, _init_shapeEllipsoidCenter, _init_extra_shapeEllipsoidCenter, _init_shapeEllipsoidRadius, _init_extra_shapeEllipsoidRadius, _init_translationCurve, _init_extra_translationCurve, _init_worldTransform, _init_extra_worldTransform, _init_inverseWorldTransform, _init_extra_inverseWorldTransform, _init_lastWorldTransform, _init_extra_lastWorldTransform, _init_worldVelocity, _init_extra_worldVelocity, _init_audioGeometry, _init_extra_audioGeometry, _init_isVisible, _init_extra_isVisible, _initProto],
         c: [_EveSpaceObject, _initClass]
       } = _applyDecs2311(this, [type.define({
         className: "EveSpaceObject2",
         family: "eve/spaceObject"
-      })], [[[io, io.notify, io, io.persist, type, type.int32, void 0, schema.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, schema.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.int32], 16, "lastDamageLocatorHit"], [[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.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.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.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("Generated EveMeshOverlayEffect has no method surface yet, so the per-batch-type effect selection reads its fields here until the class is promoted; realized-LOD draw args defer to the engine.")], 18, "GetBatchesFromOverlayVector"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("The overlay HasTransparentArea predicate reads the generated class's transparentEffects field until the class is promoted.")], 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("Persistent VS/PS device buffers are engine-owned; the record carries the object reference the engine serializer consumes.")], 18, "GetPerObjectData"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetShadowPerObjectData"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("The granny bone list (Tr2GrannyAnimationUtils::GetBoneList, cpp:3545-3547) awaits the JS animation seam - (null, 0) is passed, the established EveChildMesh convention.")], 18, "GetLights"], [[carbon, carbon.method, impl, impl.notImplemented], 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, "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, "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, "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, "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, "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"]], 0, void 0, _EveEntity));
+      })], [[[io, io.notify, io, io.persist, type, type.int32, void 0, schema.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, schema.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.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.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("Persistent VS/PS device buffers are engine-owned; the record carries the object reference the engine serializer consumes.")], 18, "GetPerObjectData"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetShadowPerObjectData"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetLights"], [[carbon, carbon.method, impl, impl.notImplemented], 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, "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, "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, "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, "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, "GetShapeEllipsoid"]], 0, void 0, _EveEntity));
     }
     /** m_reflectionMode (EntityComponents::ReflectionMode - enum ReflectionMode) [READWRITE, PERSIST, NOTIFY, ENUM] */
     reflectionMode = (_initProto(this), _init_reflectionMode(this, 3));
@@ -178,8 +191,15 @@ 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.
+     */
+    spaceObjectShipData = (_init_extra_customShaderData(this), _init_spaceObjectShipData(this, vec4.create()));
+
     /** m_lastDamageLocatorHit (int) [READ] */
-    lastDamageLocatorHit = (_init_extra_customShaderData(this), _init_lastDamageLocatorHit(this, -1));
+    lastDamageLocatorHit = (_init_extra_spaceObjectShipData(this), _init_lastDamageLocatorHit(this, -1));
 
     /** m_boundingSphereRadius (float) [READWRITE, PERSIST] */
     boundingSphereRadius = (_init_extra_lastDamageLocatorHit(this), _init_boundingSphereRadius(this, -1));
@@ -241,12 +261,43 @@ new class extends _identity {
 
     // Carbon m_impostorMode: the impostor system that raises it is unported.
     #impostorMode = false;
+
+    /** 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.
+     */
+
+    /** Scratch for the per-frame shader-data fill; never allocate in it. */
+
+    // Carbon m_vsData / m_psData: the PERSISTENT per-object records. They are
+    // owner-held members across frames rather than pool leases, because the
+    // object fills them during update and reads them back afterwards
+    // (cpp:3747 takes the world translation out of the STORED transposed matrix).
+    // Carbon's paired m_perObjectDataVs/m_perObjectDataPs GPU buffers are the
+    // engine's business; Invalidate on these records carries the same signal.
+    #vsData = RawData.create("EveSpaceObjectVSData");
+    #psData = RawData.create("EveSpaceObjectPSData");
+
+    /** Alias for the mesh property; reads and writes go straight to mesh. */
     get meshLod() {
       return this.mesh;
     }
+
+    /** Alias for the mesh property; reads and writes go straight to mesh. */
     set meshLod(mesh) {
       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.
+     */
     Initialize() {
       for (const controller of this.controllers) {
         if (!controller?.IsLinked?.()) {
@@ -271,12 +322,24 @@ new class extends _identity {
       }
       return true;
     }
+
+    /** Returns the hull mesh, or null when none is attached. */
     GetMesh() {
       return this.mesh;
     }
+
+    /**
+     * Replaces the hull mesh; the cached area blocks are only rebuilt on the next
+     * batch call.
+     */
     SetMesh(mesh) {
       this.mesh = mesh ?? null;
     }
+
+    /**
+     * 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);
       if (!controller?.IsLinked?.()) {
@@ -285,10 +348,22 @@ new class extends _identity {
       _EveSpaceObject.#ApplyControllerVariables(controller, this.#controllerVariables, "SetVariable");
       return controller;
     }
+
+    /**
+     * 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.
+     */
     SetInheritProperties(colorSet) {
       if (!this.inheritProperties) {
         this.inheritProperties = new _EveChildInheritPrope();
@@ -296,6 +371,8 @@ new class extends _identity {
       this.inheritProperties.SetProperties(colorSet);
       this.#PropagateInheritProperties();
     }
+
+    /** Pushes the current inherited properties to every effect child and light. */
     #PropagateInheritProperties() {
       const properties = this.inheritProperties.GetProperties();
       for (const child of this.effectChildren) {
@@ -305,6 +382,11 @@ new class extends _identity {
         light?.SetInheritProperties?.(properties);
       }
     }
+
+    /**
+     * Returns the first effect child with the given name, or null when none
+     * matches.
+     */
     GetEffectChildByName(name) {
       const target = String(name ?? "");
       for (const child of this.effectChildren) {
@@ -314,6 +396,12 @@ 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.
+     */
     AddToEffectChildrenList(child) {
       if (this.inheritProperties) {
         child?.SetInheritProperties?.(this.inheritProperties.GetProperties());
@@ -322,15 +410,27 @@ new class extends _identity {
       _EveSpaceObject.#ApplyControllerVariables(child, this.#controllerVariables, "SetControllerVariable");
       return child;
     }
+
+    /** Appends a light, first giving it the hull's inherited properties. */
     AddLight(light) {
       if (this.inheritProperties) {
         light?.SetInheritProperties?.(this.inheritProperties.GetProperties());
       }
       this.lights.push(light);
     }
+
+    /**
+     * 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.
+     */
     RemoveFromEffectChildrenList(child) {
       const index = this.effectChildren.indexOf(child);
       if (index === -1) {
@@ -339,18 +439,38 @@ new class extends _identity {
       this.effectChildren.splice(index, 1);
       return true;
     }
+
+    /**
+     * 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;
     }
+
+    /** Returns the model rotation curve, or null when none is set. */
     GetModelRotationCurve() {
       return this.modelRotationCurve;
     }
+
+    /**
+     * 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;
     }
+
+    /** Returns the model translation curve, or null when none is set. */
     GetModelTranslationCurve() {
       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.
+     */
     UpdateWorldTransform(time) {
       const nextTime = Number(time) || 0;
       if (this.#lastUpdateTransformTime === nextTime) {
@@ -358,6 +478,10 @@ new class extends _identity {
       }
       this.#lastUpdateTransformTime = nextTime;
       mat4.copy(this.lastWorldTransform, this.worldTransform);
+      // Carbon cpp:2675-2676: the OUTGOING transform becomes worldTransformLast,
+      // stored transposed in both records, before the new one is built.
+      this.#vsData.SetAndTranspose("worldTransformLast", this.lastWorldTransform);
+      this.#psData.SetAndTranspose("worldTransformLast", this.lastWorldTransform);
       _EveSpaceObject.#UpdateCurve(this.translationCurve, nextTime, this.worldPosition, _EveSpaceObject.#zero);
       if (this.translationCurve?.GetValueDotAt) {
         this.translationCurve.GetValueDotAt(nextTime, this.worldVelocity);
@@ -400,9 +524,9 @@ new class extends _identity {
       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;
@@ -421,6 +545,114 @@ new class extends _identity {
       }
       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.
+     */
+    PrepareShaderData(updateContext = null) {
+      this.UpdateWorldBounds();
+
+      // An impact overlay may damp the activation strength; otherwise full on.
+      this.spaceObjectShipData[1] = this.impactOverlay ? this.impactOverlay.GetActivationStrength?.(updateContext) ?? 1 : 1;
+      this.spaceObjectShipData[3] = this.GetBoundingSphereRadius();
+      this.spaceObjectShipData[2] = this.dirtLevel;
+
+      // clipSphereFactor runs 0 (fully visible) to 1 (invisible); the shader gets
+      // a signed squared radius rather than the factor itself.
+      let normalizedBoundingRadius = this.GetBoundingSphereRadius() / (this.modelScale === 0 ? 1 : this.modelScale);
+      const clipOffset = vec3.length(this.clipSphereCenter);
+      normalizedBoundingRadius += clipOffset;
+      const insideSpherePercentage = Math.min(1, clipOffset / normalizedBoundingRadius);
+      const dissolveRadius = this.clipSphereFactor * normalizedBoundingRadius * (1 + insideSpherePercentage);
+      const center = this.GetBoundingSphereCenter();
+      const clipSphereCenter = _EveSpaceObject.#clipSphereCenterScratch;
+      vec3.add(clipSphereCenter, this.clipSphereCenter, center);
+      const clipRadiusSq = Math.sign(dissolveRadius) * dissolveRadius * dissolveRadius;
+      this.#psData.Set("clipSphereCenter", clipSphereCenter);
+      this.#psData.Set("clipRadiusSq", [clipRadiusSq]);
+      this.#vsData.Set("clipData", [clipSphereCenter[0], clipSphereCenter[1], clipSphereCenter[2], clipRadiusSq]);
+      const dissolveRadius2 = this.clipSphereFactor2 * normalizedBoundingRadius * (1 + insideSpherePercentage);
+      this.#psData.Set("clipRadius2Sq", [Math.sign(dissolveRadius2) * dissolveRadius2 * dissolveRadius2]);
+      this.#psData.Set("clipSphereFactor", [this.clipSphereFactor]);
+      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
+     */
+    UpdateShLighting(manager, updateContext = null) {
+      const coefficients = this.#psData.Get("shLightingCoefficients");
+      coefficients.fill(0);
+      const lowThreshold = _EveSpaceObject.#GetContextValue(updateContext, "GetLowDetailThreshold", "lowDetailThreshold");
+      if (!(this.estimatedPixelDiameterWithChildren > lowThreshold) || typeof manager?.GetLighting !== "function") {
+        return false;
+      }
+      const mediumThreshold = _EveSpaceObject.#GetContextValue(updateContext, "GetMediumDetailThreshold", "mediumDetailThreshold");
+      const intensityFadeRadius = (mediumThreshold - lowThreshold) * 0.25;
+      const intensity = Math.min(Math.max((this.estimatedPixelDiameterWithChildren - lowThreshold) / intensityFadeRadius, 0), 1);
+      manager.GetLighting(this.worldPosition, intensity, this.boundingSphereRadius * _EveSpaceObject.SECONDARY_LIGHTING_RADIUS_CUTOFF_FACTOR, coefficients);
+      return true;
+    }
+
+    /**
+     * 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
+     */
+    GetParentData(out = new _IEveSpaceObject2Pare()) {
+      mat4.copy(out.transform, this.worldTransform);
+      // Carbon memsets the record and never assigns killCount on this path.
+      out.killCount = 0;
+      vec4.copy(out.shipData, this.spaceObjectShipData);
+      vec3.copy(out.clipSphereCenter, this.#psData.Get("clipSphereCenter"));
+      out.clipRadiusSq = this.#psData.Get("clipRadiusSq")[0];
+      out.clipRadius2Sq = this.#psData.Get("clipRadius2Sq")[0];
+      out.clipFactor = this.#psData.Get("clipSphereFactor")[0];
+      out.clipFactor2 = this.#psData.Get("clipSphereFactor2")[0];
+      out.shLighting = this.#psData.Get("shLightingCoefficients");
+      vec4.copy(out.customData, this.#psData.Get("customData"));
+      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
+     */
+    GetPerObjectStructs(vsData = RawData.create("EveSpaceObjectVSData"), psData = RawData.create("EveSpaceObjectPSData")) {
+      vsData.CopyFrom(this.#vsData);
+      psData.CopyFrom(this.#psData);
+      vsData.Set("customData", this.#psData.Get("customData"));
+      return {
+        vs: vsData,
+        ps: psData
+      };
+    }
+
+    /**
+     * 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");
       this.UpdateWorldTransform(time);
@@ -457,6 +689,11 @@ new class extends _identity {
       this.impactOverlay?.UpdateSyncronous?.(updateContext, this);
       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.
+     */
     UpdateAsyncronous(updateContext = null) {
       if (!this.update) {
         return 0;
@@ -467,6 +704,42 @@ new class extends _identity {
         controller?.Update?.(frequency);
       }
 
+      // Carbon cpp:626-663: the persistent buffers are invalidated once per
+      // frame, then the shader data is prepared and copied into both records.
+      this.#vsData.Invalidate();
+      this.#psData.Invalidate();
+      const previousActivationStrength = this.spaceObjectShipData[1];
+      this.PrepareShaderData(updateContext);
+      if (previousActivationStrength !== this.spaceObjectShipData[1]) {
+        this.SetControllerVariable?.("ActivationStrength", this.spaceObjectShipData[1]);
+      }
+      this.#psData.Set("shipData", this.spaceObjectShipData);
+      this.#vsData.Set("shipData", this.spaceObjectShipData);
+      // m_psData.customData is script/SOF-driven; the model field is its author.
+      this.#psData.Set("customData", this.customShaderData);
+      // Both records carry the same two matrices; each is written from the
+      // LOGICAL transform, which produces the bytes Carbon's `m_psData.x =
+      // m_vsData.x` copy of the already-transposed value produces.
+      this.#vsData.SetAndTranspose("worldTransform", this.worldTransform);
+      this.#vsData.SetAndTranspose("invWorldTransform", this.inverseWorldTransform);
+      this.#psData.SetAndTranspose("worldTransform", this.worldTransform);
+      this.#psData.SetAndTranspose("invWorldTransform", this.inverseWorldTransform);
+      const shapeCenter = _EveSpaceObject.#shapeCenterScratch;
+      const shapeRadius = _EveSpaceObject.#shapeRadiusScratch;
+      this.GetShapeEllipsoid(shapeCenter, shapeRadius);
+      this.#vsData.Set("ellpsoidRadii", [shapeRadius[0], shapeRadius[1], shapeRadius[2], 0]);
+      this.#vsData.Set("ellpsoidCenter", [shapeCenter[0], shapeCenter[1], shapeCenter[2], 0]);
+      if (this.impactOverlay) {
+        this.#psData.Set("impactDataOffset", [this.impactOverlay.GetDataTextureOffset?.() ?? 0]);
+      }
+      for (let slot = 0; slot < _EveSpaceObject.CUSTOM_MASK_MAX; slot++) {
+        if (this.customMasks.length > slot) {
+          this.customMasks[slot]?.FillPerObjectData?.(slot, this.#vsData, this.#psData);
+        } else {
+          _EveCustomMask.ZeroPerObjectData(slot, this.#vsData, this.#psData);
+        }
+      }
+
       // Object-level curve sets update only on frames the sync-side LOD gate
       // stamped, receiving the context time as BOTH realTime and simTime
       // (Carbon EveSpaceObject2::UpdateAsyncronous: if (m_lastCurveUpdateTime ==
@@ -496,9 +769,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;
@@ -523,8 +796,15 @@ new class extends _identity {
           this.#isMeshVisible = true;
         }
       }
+
+      // Bones so a bone-parented attachment's bounds follow its bone, which is
+      // what drives the per-bone AABB union (Carbon BoundingBox.cpp:815-833).
+      const {
+        bones,
+        boneCount
+      } = getBoneList(this.animationUpdater);
       for (const attachment of this.attachments) {
-        if (attachment?.UpdateVisibility?.(updateContext, this.worldTransform, null, 0)) {
+        if (attachment?.UpdateVisibility?.(updateContext, this.worldTransform, bones, boneCount)) {
           this.#isMeshVisible = true;
           this.isVisible = true;
         }
@@ -587,10 +867,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;
@@ -625,6 +905,13 @@ new class extends _identity {
     // order into the order-preserving TRANSPARENT accumulator. Bounding boxes come
     // 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.
+     */
     #GetSortedTransparentBatches(areas, batches, perObjectData, renderContext) {
       const geometry = this.mesh.GetGeometryResource?.() ?? null;
       const viewPosition = renderContext?.GetViewPosition?.();
@@ -655,10 +942,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();
@@ -677,6 +964,11 @@ 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.
+     */
     ReleaseCachedData() {
       for (const blocks of this.#overlayMeshAreaBlocks) {
         blocks.length = 0;
@@ -684,14 +976,68 @@ new class extends _identity {
       this.#shadowMeshOpaqueAreas.length = 0;
       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.
+     */
     #EnsureCachedAreaBlocks() {
       if (!this.#cachedAreaBlocksBuilt && this.mesh) this.RebuildCachedData();
     }
 
-    /** 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 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) {
+        this.GetBatches(batches, TriBatchType.TRIBATCHTYPE_PICKING, perObjectData);
+      }
+      if (pickTypes & Tr2PickType.PICK_TYPE_OPAQUE) {
+        this.GetBatches(batches, TriBatchType.TRIBATCHTYPE_OPAQUE, perObjectData);
+        this.GetBatches(batches, TriBatchType.TRIBATCHTYPE_DECAL, perObjectData);
+        this.GetBatchesFromOverlayVector(batches, perObjectData, TriBatchType.TRIBATCHTYPE_TRANSPARENT, this.mesh);
+        this.GetBatchesFromOverlayVector(batches, perObjectData, TriBatchType.TRIBATCHTYPE_ADDITIVE, this.mesh);
+      }
+      if (pickTypes & Tr2PickType.PICK_TYPE_TRANSPARENT) {
+        // Carbon takes the mesh's OWN areas here rather than going through
+        // GetBatches, and returns early when the mesh is absent or hidden - so a
+        // hidden mesh suppresses the transparent pass only, not the ones above.
+        if (!this.mesh || this.mesh.display === false) {
+          return true;
+        }
+        for (const batchType of [TriBatchType.TRIBATCHTYPE_TRANSPARENT, TriBatchType.TRIBATCHTYPE_ADDITIVE]) {
+          const areas = this.mesh.GetAreas?.(batchType);
+          if (areas) {
+            this.mesh.GetBatches?.(batches, areas, perObjectData);
+          }
+        }
+      }
+      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
+     */
+    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
      * until engine LOD selection consumes it. */
     GetShadowBatches(batches, perObjectData, _shadowPixelSize) {
       if (!this.mesh || this.mesh.display === false) return false;
@@ -714,10 +1060,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;
@@ -735,7 +1081,7 @@ new class extends _identity {
       for (const overlay of this.overlayEffects) {
         const effects = this.#OverlayEffectsFor(overlay, batchType);
         if (!effects) continue;
-        const overlayType = batchType === TriBatchType.TRIBATCHTYPE_OPAQUE ? OVERLAY_TYPE_OPAQUEONLY : OVERLAY_TYPE_ALL;
+        const overlayType = overlay.GetType(batchType);
         const blocks = this.#overlayMeshAreaBlocks[overlayType];
         for (const effect of effects) {
           for (const block of blocks) {
@@ -745,6 +1091,12 @@ 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.
+     */
     #CommitBlockBatch(batches, material, geometry, meshIndex, block, perObjectData, priority) {
       const batch = new Tr2RenderBatch();
       batch.SetMaterial(material);
@@ -755,35 +1107,34 @@ new class extends _identity {
       batches.Commit(batch);
     }
 
-    // EveMeshOverlayEffect::GetEffects (display-gated, per batch type). Prefers a
-    // promoted method surface; falls back to the generated class's fields.
+    // 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.
+     */
     #OverlayEffectsFor(overlay, batchType) {
-      if (!overlay) return null;
-      if (typeof overlay.GetEffects === "function") return overlay.GetEffects(batchType) ?? null;
-      if (overlay.display === false) return null;
-      switch (batchType) {
-        case TriBatchType.TRIBATCHTYPE_OPAQUE:
-          return overlay.opaqueEffects ?? null;
-        case TriBatchType.TRIBATCHTYPE_DECAL:
-          return overlay.decalEffects ?? null;
-        case TriBatchType.TRIBATCHTYPE_TRANSPARENT:
-          return overlay.transparentEffects ?? null;
-        case TriBatchType.TRIBATCHTYPE_ADDITIVE:
-          return overlay.additiveEffects ?? null;
-        case TriBatchType.TRIBATCHTYPE_DISTORTION:
-          return overlay.distortionEffects ?? null;
-        default:
-          return null;
-      }
+      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.
+     */
     HasTransparentBatches() {
       if (!this.mesh) return false;
       if ((this.mesh.GetAreas?.(TriBatchType.TRIBATCHTYPE_TRANSPARENT)?.length ?? 0) > 0) return true;
       for (const overlay of this.overlayEffects) {
-        if (overlay?.HasTransparentArea?.() ?? (overlay?.transparentEffects?.length ?? 0) > 0) return true;
+        if (overlay?.HasTransparentArea?.()) return true;
       }
       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.
+     */
     GetSortValue(renderContext = null) {
       const viewPosition = renderContext?.GetViewPosition?.();
       const x = (viewPosition?.[0] ?? 0) - this.worldTransform[12];
@@ -792,14 +1143,25 @@ new class extends _identity {
       return Math.hypot(x, y, z);
     }
 
-    /** Carbon allocates Tr2PerObjectDataWithPersistentBuffers<EveSpaceObject2>,
-     * which calls back into the object at upload time; the GPU-free record carries
-     * the same live object reference for the engine serializer (the space-object
+    /** Carbon allocates Tr2PerObjectDataWithPersistentBuffers<EveSpaceObject2>,
+     * which calls back into the object at upload time; the GPU-free record carries
+     * the same live object reference for the engine serializer (the space-object
      * Main profile) to pull current values at realization. */
-    GetPerObjectData(accumulator = null) {
-      const data = typeof accumulator?.Allocate === "function" ? accumulator.Allocate(Tr2PerObjectData) : new Tr2PerObjectData();
-      data.object = this;
-      return data;
+    GetPerObjectData(_accumulator = null) {
+      // Carbon cpp:1437-1445: the bone ring is uploaded and its OFFSETS stamped
+      // into the record, then a pooled handle referencing the two persistent
+      // buffers is returned. The offsets are GPU addresses with no CPU
+      // derivation, so they stay at their zero default here; the bone count is
+      // CPU-known and is written.
+      const boneCount = this.animationUpdater?.IsInitialized?.() ? this.animationUpdater.GetMeshBoneCount?.() ?? 0 : null;
+      if (boneCount !== null) {
+        this.#vsData.SetIndex("boneOffsets", 2, [boneCount]);
+      }
+      this.#vsData.Set("customData", this.#psData.Get("customData"));
+      return {
+        vs: this.#vsData,
+        ps: this.#psData
+      };
     }
 
     /** Carbon forwards the shadow pass to the same per-object record. */
@@ -807,34 +1169,41 @@ 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) {
         return;
       }
+
+      // cpp:3545-3547 - Tr2GrannyAnimationUtils::GetBoneList, so a bone-parented
+      // light is placed by its bone rather than by the object transform alone.
+      const {
+        bones,
+        boneCount
+      } = getBoneList(this.animationUpdater);
       for (const light of this.lights) {
-        light?.AddLight?.(lightManager, this.worldTransform, 1, null, 0);
+        light?.AddLight?.(lightManager, this.worldTransform, 1, bones, boneCount);
         light?.SetBrightnessMultiplier?.(this.activationStrength);
       }
     }
 
-    /** Carbon EveSpaceObject2::IsCastingShadow (cpp:1940-1990) culls against the
-     * camera/shadow frustums; awaits the TriFrustum port (visibility pass).
+    /** Carbon EveSpaceObject2::IsCastingShadow (cpp:1940-1990) culls against the
+     * camera/shadow frustums; awaits the TriFrustum port (visibility pass).
      * Presence satisfies the "ShadowCaster" duck contract. */
     IsCastingShadow(..._args) {
       throw new Error("EveSpaceObject2.IsCastingShadow is not implemented in CarbonEngineJS.");
     }
 
-    /** 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();
@@ -857,10 +1226,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();
@@ -873,21 +1242,57 @@ 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.
+     */
     DisplayChildren() {
       return true;
     }
+
+    /**
+     * 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.
+     */
     GetLocalToWorldTransform() {
       return this.worldTransform;
     }
+
+    /** Carbon's non-updating model-center query. */
+    GetModelCenterWorldPosition(out) {
+      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.
+     */
     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.
+     */
     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.
+     */
     FindSoundEmitter(name) {
       const target = String(name ?? "");
       for (const observer of this.observers) {
@@ -903,6 +1308,11 @@ new class extends _identity {
       }
       return null;
     }
+
+    /**
+     * Sets the mute flag and pushes it to every effect child and placement
+     * observer.
+     */
     SetMute(mute) {
       this.mute = !!mute;
       for (const child of this.effectChildren) {
@@ -913,19 +1323,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);
@@ -949,10 +1359,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?.()) {
@@ -962,30 +1372,30 @@ new class extends _identity {
       return vec4.set(out, 0, 0, 0, -1);
     }
 
-    /**
-     * Clears all impact and damage effects on the impact overlay.
+    /**
+     * Clears all impact and damage effects on the impact overlay.
      */
     ClearImpactDamage() {
       this.impactOverlay?.Clear?.();
     }
 
-    /**
-     * 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) {
@@ -994,16 +1404,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;
@@ -1012,31 +1422,31 @@ 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);
     }
 
-    /**
-     * 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);
@@ -1059,19 +1469,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";
@@ -1191,7 +1601,7 @@ new class extends _identity {
       vec3.transformMat4(_EveSpaceObject.#rayOrigin, posPrev, this.inverseWorldTransform);
       vec3.transformMat4(_EveSpaceObject.#rayEnd, posNow, this.inverseWorldTransform);
       vec3.subtract(_EveSpaceObject.#rayDirection, _EveSpaceObject.#rayEnd, _EveSpaceObject.#rayOrigin);
-      this.#GetShapeEllipsoid(_EveSpaceObject.#ellipsoidCenter, _EveSpaceObject.#ellipsoidRadii);
+      this.GetShapeEllipsoid(_EveSpaceObject.#ellipsoidCenter, _EveSpaceObject.#ellipsoidRadii);
       const t = _EveSpaceObject.#IntersectEllipsoidRay(out, _EveSpaceObject.#ellipsoidCenter, _EveSpaceObject.#ellipsoidRadii, _EveSpaceObject.#rayOrigin, _EveSpaceObject.#rayDirection);
       if (t !== null && t >= -1 && t <= 1) {
         vec3.transformMat4(out, out, this.worldTransform);
@@ -1209,9 +1619,9 @@ new class extends _identity {
       return this.impactOverlay?.UpdateImpact?.(out, direction, impactIndex) ?? 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);
@@ -1223,9 +1633,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);
@@ -1237,18 +1647,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);
@@ -1266,9 +1676,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);
@@ -1282,6 +1692,11 @@ 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.
+     */
     HandleControllerEvent(name) {
       const eventName = String(name ?? "");
       for (const controller of this.controllers) {
@@ -1295,24 +1710,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);
@@ -1321,13 +1736,18 @@ new class extends _identity {
     // Carbon EveSpaceObject2::PlayAnimation: every playback wrapper funnels
     // 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.
+     */
     #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;
@@ -1357,6 +1777,11 @@ new class extends _identity {
       this.UpdateWorldBounds();
       return this;
     }
+
+    /**
+     * Returns a plain-object snapshot of the controller variables currently
+     * stamped on this hull.
+     */
     GetControllerVariables() {
       return Object.fromEntries(this.#controllerVariables);
     }
@@ -1369,11 +1794,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 ?? "");
@@ -1393,11 +1818,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();
@@ -1429,7 +1854,7 @@ new class extends _identity {
     /** Gets Carbon's cached local box transformed into a world-axis-aligned box. */
     GetWorldBoundingBox(minBounds, maxBounds) {
       box3.fromBounds(_EveSpaceObject.#localBox, this.#localAabbMin, this.#localAabbMax);
-      _EveSpaceObject.#TransformBox(_EveSpaceObject.#worldBox, _EveSpaceObject.#localBox, this.worldTransform);
+      box3.transformMat4(_EveSpaceObject.#worldBox, _EveSpaceObject.#localBox, this.worldTransform);
       const min = minBounds ?? vec3.create();
       const max = maxBounds ?? vec3.create();
       vec3.set(min, _EveSpaceObject.#worldBox[0], _EveSpaceObject.#worldBox[1], _EveSpaceObject.#worldBox[2]);
@@ -1446,9 +1871,9 @@ new class extends _identity {
       return !!geometryResource?.IsGood?.();
     }
 
-    /**
-     * 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;
@@ -1484,9 +1909,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) {
@@ -1495,9 +1920,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) {
@@ -1506,9 +1931,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;
@@ -1523,6 +1948,12 @@ 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.
+     */
     SetImpactDamageState(shield, armor, hull, doCreateArmorImpacts = true) {
       this.impactOverlay?.SetDamageState?.(shield, armor, hull, doCreateArmorImpacts);
       this.SetControllerVariable("ShieldDamage", shield);
@@ -1530,12 +1961,18 @@ 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) {
       this.impactOverlay?.ToggleEffect?.(name, enable, duration);
     }
+
+    /**
+     * 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 ?? "");
       const next = Number(value);
@@ -1550,11 +1987,21 @@ new class extends _identity {
         overlay?.SetControllerVariable?.(key, next);
       }
     }
+
+    /**
+     * Forwards a procedural-container variable to every effect child; the hull
+     * itself keeps no copy.
+     */
     SetProceduralContainerVariable(name, value) {
       for (const child of this.effectChildren) {
         child?.SetProceduralContainerVariable?.(name, value);
       }
     }
+
+    /**
+     * Starts this hull's controllers and those of its effect children and overlay
+     * effects.
+     */
     StartControllers() {
       for (const controller of this.controllers) {
         controller?.Start?.();
@@ -1567,13 +2014,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 = [];
@@ -1601,6 +2048,12 @@ 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.
+     */
     #TransformLocator(position, rotation, boneIndex) {
       const updater = this.animationUpdater;
       if (boneIndex <= 0 || !updater?.IsInitialized?.()) {
@@ -1618,6 +2071,12 @@ new class extends _identity {
     // Carbon Blue ApplyModelTransform samples both curves at the Be::Time()
     // 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.
+     */
     #ApplyModelTransform(position, rotation) {
       if (this.modelTranslationCurve) {
         const translation = vec3.create();
@@ -1633,6 +2092,11 @@ 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.
+     */
     #GetLocatorsForSet(locatorSetName) {
       const target = String(locatorSetName ?? "");
       for (const set of this.locatorSets) {
@@ -1647,6 +2111,13 @@ new class extends _identity {
     // authored quaternion; bone-attached locators additionally apply the mesh
     // bone matrix. Carbon leaves the outputs untouched (caller-uninitialized)
     // when bone data is missing; CarbonEngineJS keeps the unskinned values.
+
+    /**
+     * Writes a locator's object-space position and its direction, which is +Y
+     * rotated by the authored quaternion, applying the mesh bone matrix for
+     * bone-attached locators; where Carbon leaves the outputs untouched when bone
+     * data is missing, this keeps the unskinned values.
+     */
     #GetLocatorInObjectSpace(outPosition, outDirection, locator) {
       vec3.transformQuat(outDirection, _EveSpaceObject.#unitY, locator.direction);
       vec3.copy(outPosition, locator.position);
@@ -1665,6 +2136,12 @@ 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.
+     */
     #GetClosestLocatorIndex(position, locatorSetName) {
       const locators = this.#GetLocatorsForSet(locatorSetName);
       if (!locators) {
@@ -1688,7 +2165,16 @@ new class extends _identity {
       }
       return closestIndex;
     }
-    #GetShapeEllipsoid(outCenter, outRadii) {
+
+    /**
+     * 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. */
+
+    /** Carbon's authored-or-derived local shape ellipsoid query. */
+    GetShapeEllipsoid(outCenter, outRadii) {
       if (this.shapeEllipsoidRadius[0] > 0) {
         vec3.copy(outCenter, this.shapeEllipsoidCenter);
         vec3.copy(outRadii, this.shapeEllipsoidRadius);
@@ -1706,12 +2192,67 @@ 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.
+     */
+
+    /**
+     * 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. */
+
     // Mesh bone matrices come from the animation updater; only mat4-shaped
     // entries are usable.
 
-    // Avoid box3.transformMat4's legacy all-components-sum empty sentinel: a
-    // valid symmetric box such as [-1,-1,-1,1,1,1] has that same sum.
+    /**
+     * 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.
+     */
+
+    /**
+     * 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.
+     */
+
+    /**
+     * 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.
+     */
+
+    /** Writes a center and radius into a caller-owned sph3. */
   }];
+  CUSTOM_MASK_MAX = _EveCustomMask.CUSTOM_MASK_COUNT;
+  SECONDARY_LIGHTING_RADIUS_CUTOFF_FACTOR = 0.3;
+  #clipSphereCenterScratch = vec3.create();
+  #shapeCenterScratch = vec3.create();
+  #shapeRadiusScratch = vec3.create();
   #IsLocatorFacingPosition(locatorDirection, posInObjectSpace) {
     const moved = vec3.subtract(vec3.create(), posInObjectSpace, locatorDirection);
     return vec3.squaredLength(moved) < vec3.squaredLength(posInObjectSpace);
@@ -1756,8 +2297,10 @@ new class extends _identity {
   }
   #GetBoneMatrix(updater, boneIndex) {
     const bones = updater.GetMeshBoneMatrixList?.();
-    const bone = bones?.[boneIndex];
-    return bone && bone.length >= 16 ? bone : null;
+    if (!bones || boneIndex < 0 || (boneIndex + 1) * 12 > bones.length) {
+      return null;
+    }
+    return MatrixCopyFrom3x4(mat4.create(), bones, boneIndex);
   }
   #ApplyControllerVariables(target, variables, methodName) {
     const setter = target?.[methodName];
@@ -1811,21 +2354,6 @@ new class extends _identity {
   #SetSphere(out, center, radius) {
     return sph3.set(out, center[0], center[1], center[2], radius);
   }
-  #TransformBox(out, bounds, transform) {
-    out[0] = out[1] = out[2] = Infinity;
-    out[3] = out[4] = out[5] = -Infinity;
-    for (let index = 0; index < 8; index++) {
-      vec3.set(_EveSpaceObject.#boxCorner, index & 1 ? bounds[3] : bounds[0], index & 2 ? bounds[4] : bounds[1], index & 4 ? bounds[5] : bounds[2]);
-      vec3.transformMat4(_EveSpaceObject.#boxCorner, _EveSpaceObject.#boxCorner, transform);
-      out[0] = Math.min(out[0], _EveSpaceObject.#boxCorner[0]);
-      out[1] = Math.min(out[1], _EveSpaceObject.#boxCorner[1]);
-      out[2] = Math.min(out[2], _EveSpaceObject.#boxCorner[2]);
-      out[3] = Math.max(out[3], _EveSpaceObject.#boxCorner[0]);
-      out[4] = Math.max(out[4], _EveSpaceObject.#boxCorner[1]);
-      out[5] = Math.max(out[5], _EveSpaceObject.#boxCorner[2]);
-    }
-    return out;
-  }
   #zero = Object.freeze([0, 0, 0]);
   #unitY = Object.freeze([0, 1, 0]);
   #locatorDirection = vec3.create();
@@ -1846,7 +2374,6 @@ new class extends _identity {
   #worldSphere = sph3.create();
   #localBox = box3.create();
   #worldBox = box3.create();
-  #boxCorner = vec3.create();
   #identityRotation = Object.freeze([0, 0, 0, 1]);
   #identityTransform = mat4.create();
   #damageLocatorSetName = "damage";