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

package/dist/trinity/eve/child/EveChildMesh.js

@@ -1,18 +1,23 @@
 import { identity as _identity, applyDecs2311 as _applyDecs2311 } from '../../../_virtual/_rollupPluginBabelHelpers.js';
+import '../../../global/blue/registerTrinityEnums.js';
 import { mat4 } from '#math/mat4';
 import { quat } from '#math/quat';
 import { sph3 } from '#math/sph3';
 import { vec3 } from '#math/vec3';
 import { getBoneList } from '../../core/animation/Tr2GrannyAnimation.js';
 import { vec4 } from '#math/vec4';
-import { io, type, carbon, impl } from '#schema';
+import { edit, type, carbon, impl, CjsSchema } from '#schema';
+import { BLUELISTEVENT } from '#consts/blue';
+import { IListNotify } from '#blue';
+import { EveEntity as _EveEntity } from '../EveEntity.js';
 import { TriBatchType, ReflectionMode } from '#consts/graphics';
 import { EveChildTransform as _EveChildTransform, applyTransformModifiers } from './EveChildTransform.js';
 import { Origin } from '../../generated/eve/child/enums.js';
-import { ShouldReflect, EveComponentType } from '../EveComponentTypes.js';
+import { EveComponentType, ShouldReflect } from '../EveComponentTypes.js';
 import { Tr2RenderReason } from '../../generated/trinityCore/enums.js';
 import { Tr2Lod } from '#consts/trinity';
 import '../../core/rawData/perObjectData/Tr2PerObjectData.js';
+import { IEveSpaceObject2ParentData } from '../spaceObject/IEveSpaceObject2ParentData.js';
 import { TR2_PICK_TYPE_DEFAULT, Tr2PickType } from '../../core/view/Tr2PickType.js';
 import { createChildPerObjectRecords, inheritParentPerObjectData, stampChildTransforms } from '../perObjectData/childPerObjectRecords.js';
 import { Float4x3 as _Float4x } from '../../utilities/Float4x3.js';
@@ -20,9 +25,8 @@ import { EveCollectAreas } from './EveSpaceObjectChild.js';
 import { EveGetLocatorPose } from '../locator/EveLocatorSets.js';
 import { EveDamageOverlay as _EveDamageOverlay } from '../overlays/EveDamageOverlay.js';
 import { CollectOverlayAreaBlocks, EmitDamageOverlayBatches, EmitOverlayBatches } from '../overlays/overlayBatches.js';
-import { withITr2Renderable } from '../../core/ITr2Renderable.js';
+import { ITr2Renderable } from '../../core/ITr2Renderable.js';
 
-var _withITr2Renderable;
 let _initProto, _initClass, _init_ownedLocatorSets, _init_extra_ownedLocatorSets, _init_armorDamageShader, _init_extra_armorDamageShader, _init_reflectionMode, _init_extra_reflectionMode, _init_transformModifiers, _init_extra_transformModifiers, _init_worldTransform, _init_extra_worldTransform, _init_display, _init_extra_display, _init_inheritOverlayEffects, _init_extra_inheritOverlayEffects, _init_overlayEffects, _init_extra_overlayEffects, _init_damageOverlay, _init_extra_damageOverlay, _init_castShadow, _init_extra_castShadow, _init_mesh, _init_extra_mesh, _init_name, _init_extra_name, _init_rotation, _init_extra_rotation, _init_translation, _init_extra_translation, _init_scaling, _init_extra_scaling, _init_localTransform, _init_extra_localTransform, _init_decals, _init_extra_decals, _init_staticTransform, _init_extra_staticTransform, _init_animationUpdater, _init_extra_animationUpdater, _init_attachments, _init_extra_attachments, _init_lights, _init_extra_lights, _init_lowestLodVisible, _init_extra_lowestLodVisible, _init_minScreenSize, _init_extra_minScreenSize, _init_sortValueOffset, _init_extra_sortValueOffset, _init_sortValueScale, _init_extra_sortValueScale, _init_currentScreenSize, _init_extra_currentScreenSize, _init_currentInstanceScreenSize, _init_extra_currentInstanceScreenSize, _init_useSRT, _init_extra_useSRT, _init_updateAnimation, _init_extra_updateAnimation, _init_origin, _init_extra_origin, _init_instanceTransforms, _init_extra_instanceTransforms, _init_sofDna, _init_extra_sofDna, _init_sofParentHullName, _init_extra_sofParentHullName, _init_sofLocatorSetName, _init_extra_sofLocatorSetName, _init_sofLocatorIndex, _init_extra_sofLocatorIndex;
 
 // Module scratch for the hot per-frame visibility/shadow paths (allocation
@@ -45,14 +49,14 @@ const NO_BONE_TRANSFORMS = Object.freeze({
   boneCount: 0
 });
 
-/**
- * Space-object child that draws one mesh under its own transform, owning its
- * decals, lights, attachments, morph weights, world bounds and screen-size LOD
- * state.
+/**
+ * Space-object child that draws one mesh under its own transform, owning its
+ * decals, lights, attachments, morph weights, world bounds and screen-size LOD
+ * state.
  */
 let _EveChildMesh;
 new class extends _identity {
-  static [class EveChildMesh extends (_withITr2Renderable = withITr2Renderable(_EveChildTransform)) {
+  static [class EveChildMesh extends _EveChildTransform {
     static {
       ({
         e: [_init_ownedLocatorSets, _init_extra_ownedLocatorSets, _init_armorDamageShader, _init_extra_armorDamageShader, _init_reflectionMode, _init_extra_reflectionMode, _init_transformModifiers, _init_extra_transformModifiers, _init_worldTransform, _init_extra_worldTransform, _init_display, _init_extra_display, _init_inheritOverlayEffects, _init_extra_inheritOverlayEffects, _init_overlayEffects, _init_extra_overlayEffects, _init_damageOverlay, _init_extra_damageOverlay, _init_castShadow, _init_extra_castShadow, _init_mesh, _init_extra_mesh, _init_name, _init_extra_name, _init_rotation, _init_extra_rotation, _init_translation, _init_extra_translation, _init_scaling, _init_extra_scaling, _init_localTransform, _init_extra_localTransform, _init_decals, _init_extra_decals, _init_staticTransform, _init_extra_staticTransform, _init_animationUpdater, _init_extra_animationUpdater, _init_attachments, _init_extra_attachments, _init_lights, _init_extra_lights, _init_lowestLodVisible, _init_extra_lowestLodVisible, _init_minScreenSize, _init_extra_minScreenSize, _init_sortValueOffset, _init_extra_sortValueOffset, _init_sortValueScale, _init_extra_sortValueScale, _init_currentScreenSize, _init_extra_currentScreenSize, _init_currentInstanceScreenSize, _init_extra_currentInstanceScreenSize, _init_useSRT, _init_extra_useSRT, _init_updateAnimation, _init_extra_updateAnimation, _init_origin, _init_extra_origin, _init_instanceTransforms, _init_extra_instanceTransforms, _init_sofDna, _init_extra_sofDna, _init_sofParentHullName, _init_extra_sofParentHullName, _init_sofLocatorSetName, _init_extra_sofLocatorSetName, _init_sofLocatorIndex, _init_extra_sofLocatorIndex, _initProto],
@@ -60,7 +64,7 @@ new class extends _identity {
       } = _applyDecs2311(this, [type.define({
         className: "EveChildMesh",
         family: "eve/child"
-      })], [[[io, io.persist, void 0, type.list("EveLocatorSets")], 16, "ownedLocatorSets"], [[io, io.persist, void 0, type.objectRef("Tr2Effect")], 16, "armorDamageShader"], [[io, io.notify, io, io.persist, type, type.int32, void 0, type.enum("ReflectionMode")], 16, "reflectionMode"], [[io, io.persist, void 0, type.list("IEveChildTransformModifier")], 16, "transformModifiers"], [[io, io.read, type, type.mat4], 16, "worldTransform"], [[io, io.notify, io, io.persist, type, type.boolean], 16, "display"], [[io, io.persist, type, type.boolean], 16, "inheritOverlayEffects"], [[io, io.persist, void 0, type.list("EveMeshOverlayEffect")], 16, "overlayEffects"], [[io, io.persist, void 0, type.objectRef("EveDamageOverlay")], 16, "damageOverlay"], [[io, io.notify, io, io.persist, type, type.boolean], 16, "castShadow"], [[io, io.notify, io, io.persist, void 0, type.objectRef("Tr2MeshBase")], 16, "mesh"], [[io, io.persist, type, type.string], 16, "name"], [[io, io.persist, type, type.quat], 16, "rotation"], [[io, io.persist, type, type.vec3], 16, "translation"], [[io, io.persist, type, type.vec3], 16, "scaling"], [[io, io.persist, type, type.mat4], 16, "localTransform"], [[io, io.persist, void 0, type.list("EveSpaceObjectDecal")], 16, "decals"], [[io, io.persist, type, type.boolean], 16, "staticTransform"], [[io, io.notify, io, io.persist, void 0, type.objectRef("Tr2GrannyAnimation")], 16, "animationUpdater"], [[io, io.persist, void 0, type.list("IEveSpaceObjectAttachment")], 16, "attachments"], [[io, io.persist, void 0, type.list("Tr2Light")], 16, "lights"], [[io, io.persist, type, type.int32, void 0, type.enum("Tr2Lod")], 16, "lowestLodVisible"], [[io, io.persist, type, type.float32], 16, "minScreenSize"], [[io, io.persist, type, type.float32], 16, "sortValueOffset"], [[io, io.persist, type, type.float32], 16, "sortValueScale"], [[io, io.read, type, type.float32], 16, "currentScreenSize"], [[io, io.read, type, type.float32], 16, "currentInstanceScreenSize"], [[io, io.persist, type, type.boolean], 16, "useSRT"], [[io, io.persist, type, type.boolean], 16, "updateAnimation"], [[io, io.persist, type, type.int32, void 0, type.enum("Origin")], 16, "origin"], [[void 0, io.rebuild("instanceBuffer"), io, io.persist, void 0, type.array("mat4")], 16, "instanceTransforms"], [[io, io.persist, type, type.string], 16, "sofDna"], [[io, io.persist, type, type.string], 16, "sofParentHullName"], [[io, io.persist, type, type.string], 16, "sofLocatorSetName"], [[io, io.persist, type, type.string], 16, "sofLocatorIndex"], [[carbon, carbon.method, impl, impl.adapted], 18, "Initialize"], [[carbon, carbon.method, impl, impl.implemented], 18, "Setup"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetInstanceTransforms"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetInstanceTransforms"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetMesh"], [[carbon, carbon.method, impl, impl.implemented], 18, "AddOverlayEffect"], [[carbon, carbon.method, impl, impl.implemented], 18, "RemoveOverlayEffect"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetOverlayEffectByName"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetOrigin"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetScale"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetReflectionMode"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetCastShadow"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetMinScreenSize"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetLocalToWorldTransform"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetName"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetName"], [[carbon, carbon.method, impl, impl.implemented], 18, "AddTransformModifier"], [[carbon, carbon.method, impl, impl.implemented], 18, "AddDecal"], [[carbon, carbon.method, impl, impl.implemented], 18, "AddAttachment"], [[carbon, carbon.method, impl, impl.implemented], 18, "ClearAttachments"], [[carbon, carbon.method, impl, impl.implemented], 18, "AddLight"], [[carbon, carbon.method, impl, impl.implemented], 18, "ClearLights"], [[carbon, carbon.method, impl, impl.implemented], 18, "IsAlwaysOn"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetShaderOption"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetMorphTargetNames"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetMorphTargetWeight"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetMorphTargetWeight"], [[impl, impl.adapted], 18, "UpdateMorphAnimationBuffer"], [[impl, impl.adapted], 18, "GetMorphTargets"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetSofSourceLocator"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Audio-geometry registration is engine-owned and the animationUpdater branches await the JS animation seam; nothing else remains in Carbon's body.")], 18, "UpdateSyncronous"], [[carbon, carbon.method, void 0, carbon.contextual(["camera"]), impl, impl.adapted], 18, "UpdateAsyncronous"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Tr2AnimationMeshBinding remains unported; Carbon's identity rest-pose fallback is used when neither live palette source is available.")], 18, "GetBoneTransforms"], [[impl, impl.implemented], 18, "GetRestPoseBoneTransforms"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Bone-fed decal bounds still await the decal seam and the raytracing refresh is engine-owned; the LOD/screen-size math and the bone-fed attachment pass are ported.")], 18, "UpdateVisibility"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("The decal mesh cache is engine-owned (null placeholder); collection structure is ported.")], 18, "GetRenderables"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetBoundingSphere"], [[carbon, carbon.method, impl, impl.implemented], 18, "HasTransparentBatches"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Frustum and threshold arrive via the duck-typed update context instead of renderer state.")], 18, "IsVisible"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetBatches"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetBatchesFromOverlayVector"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetShadowBatches"], [[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.implemented], 18, "GetShadowPerObjectData"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("GPU ring-buffer offsets have no CPU derivation and keep their defaults; every CPU-known field is filled.")], 18, "GetPerObjectData"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Overload dispatch by argument shape and a length-1 out array replace C++ overloading and the float& out-param; the shadow math is ported.")], 18, "IsCastingShadow"], [[carbon, carbon.method, impl, impl.implemented], 18, "ChangeLOD"], [[carbon, carbon.method, impl, impl.implemented], 18, "RegisterComponents"], [[carbon, carbon.method, impl, impl.implemented], 18, "UnRegisterComponents"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetLights"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetID"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetOwner"], [[carbon, carbon.method, impl, impl.adapted], 18, "CollectOwnedLocatorSets"], [[carbon, carbon.method, impl, impl.implemented], 18, "CollectOwnedGeometry"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetOwnedLocatorSets"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetDamageOverlay"], [[carbon, carbon.method, impl, impl.implemented], 18, "EnsureDamageOverlay"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetArmorDamageShaderEffect"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetArmorDamageShaderEffect"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetOwnedDamageLocators"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetDamageLocatorBindPositionLocal"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetDamageLocatorAnimatedLocal"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetPickingBatches"], [[carbon, carbon.method, impl, impl.implemented], 18, "InitializeAnimation"], [[carbon, carbon.method, impl, impl.notImplemented], 18, "BakeMorphs"], [[carbon, carbon.method, impl, impl.notImplemented], 18, "UnbakeMorphs"], [[carbon, carbon.method, impl, impl.notImplemented], 18, "IsMeshBaked"]], 0, void 0, _withITr2Renderable));
+      }), carbon.inherit(ITr2Renderable), carbon.inherit(IListNotify)], [[[edit, edit.persist, void 0, type.list("EveLocatorSets")], 16, "ownedLocatorSets"], [[edit, edit.persist, void 0, type.objectRef("Tr2Effect")], 16, "armorDamageShader"], [[edit, edit.notify, edit, edit.persist, type, type.int32, void 0, type.enum("trinity.EntityComponents.ReflectionMode")], 16, "reflectionMode"], [[edit, edit.persist, void 0, type.list("IEveChildTransformModifier")], 16, "transformModifiers"], [[edit, edit.read, type, type.mat4], 16, "worldTransform"], [[edit, edit.notify, edit, edit.persist, type, type.boolean], 16, "display"], [[edit, edit.persist, type, type.boolean], 16, "inheritOverlayEffects"], [[edit, edit.persist, void 0, type.list("EveMeshOverlayEffect")], 16, "overlayEffects"], [[edit, edit.persist, void 0, type.objectRef("EveDamageOverlay")], 16, "damageOverlay"], [[edit, edit.notify, edit, edit.persist, type, type.boolean], 16, "castShadow"], [[edit, edit.notify, edit, edit.persist, void 0, type.objectRef("Tr2MeshBase")], 16, "mesh"], [[edit, edit.persist, type, type.string], 16, "name"], [[edit, edit.notify, edit, edit.persist, type, type.quat], 16, "rotation"], [[edit, edit.notify, edit, edit.persist, type, type.vec3], 16, "translation"], [[edit, edit.notify, edit, edit.persist, type, type.vec3], 16, "scaling"], [[edit, edit.notify, edit, edit.persist, type, type.mat4], 16, "localTransform"], [[edit, edit.persist, void 0, type.list("EveSpaceObjectDecal")], 16, "decals"], [[edit, edit.persist, type, type.boolean], 16, "staticTransform"], [[edit, edit.notify, edit, edit.persist, void 0, type.objectRef("Tr2GrannyAnimation")], 16, "animationUpdater"], [[edit, edit.persist, void 0, type.list("IEveSpaceObjectAttachment")], 16, "attachments"], [[edit, edit.persist, void 0, type.list("Tr2Light")], 16, "lights"], [[edit, edit.persist, type, type.int32, void 0, type.enum("trinity.Tr2Lod")], 16, "lowestLodVisible"], [[edit, edit.persist, type, type.float32], 16, "minScreenSize"], [[edit, edit.persist, type, type.float32], 16, "sortValueOffset"], [[edit, edit.persist, type, type.float32], 16, "sortValueScale"], [[edit, edit.read, type, type.float32], 16, "currentScreenSize"], [[edit, edit.read, type, type.float32], 16, "currentInstanceScreenSize"], [[edit, edit.persist, type, type.boolean], 16, "useSRT"], [[edit, edit.persist, type, type.boolean], 16, "updateAnimation"], [[edit, edit.persist, type, type.int32, void 0, type.enum("Origin")], 16, "origin"], [[edit, edit.persist, void 0, type.array("mat4")], 16, "instanceTransforms"], [[edit, edit.persist, type, type.string], 16, "sofDna"], [[edit, edit.persist, type, type.string], 16, "sofParentHullName"], [[edit, edit.persist, type, type.string], 16, "sofLocatorSetName"], [[edit, edit.persist, type, type.string], 16, "sofLocatorIndex"], [[carbon, carbon.method, impl, impl.adapted], 18, "Initialize"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("JS arrays use the shared list mutation entry points; component interface IDs use the existing EveComponentType map.")], 18, "OnListModified"], [[carbon, carbon.method, impl, impl.implemented], 18, "Setup"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetInstanceTransforms"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetInstanceTransforms"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetMesh"], [[carbon, carbon.method, impl, impl.implemented], 18, "AddOverlayEffect"], [[carbon, carbon.method, impl, impl.implemented], 18, "RemoveOverlayEffect"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetOverlayEffectByName"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetOrigin"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetScale"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetReflectionMode"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetCastShadow"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetMinScreenSize"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetLocalToWorldTransform"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetName"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetName"], [[carbon, carbon.method, impl, impl.implemented], 18, "AddTransformModifier"], [[carbon, carbon.method, impl, impl.implemented], 18, "AddDecal"], [[carbon, carbon.method, impl, impl.implemented], 18, "AddAttachment"], [[carbon, carbon.method, impl, impl.implemented], 18, "ClearAttachments"], [[carbon, carbon.method, impl, impl.implemented], 18, "AddLight"], [[carbon, carbon.method, impl, impl.implemented], 18, "ClearLights"], [[carbon, carbon.method, impl, impl.implemented], 18, "IsAlwaysOn"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetShaderOption"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetMorphTargetNames"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetMorphTargetWeight"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetMorphTargetWeight"], [[impl, impl.adapted], 18, "UpdateMorphAnimationBuffer"], [[impl, impl.adapted], 18, "GetMorphTargets"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetSofSourceLocator"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Audio-geometry registration is not ported yet and the animationUpdater branches await the JS animation seam; nothing else remains in Carbon's body.")], 18, "UpdateSyncronous"], [[carbon, carbon.method, void 0, carbon.contextual(["camera"]), impl, impl.adapted], 18, "UpdateAsyncronous"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Tr2AnimationMeshBinding remains unported; Carbon's identity rest-pose fallback is used when neither live palette source is available.")], 18, "GetBoneTransforms"], [[impl, impl.implemented], 18, "GetRestPoseBoneTransforms"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Bone-fed decal bounds still await the decal seam and the raytracing refresh is not ported yet; the LOD/screen-size math and the bone-fed attachment pass are ported.")], 18, "UpdateVisibility"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("The decal mesh cache is not ported yet (null placeholder); collection structure is ported.")], 18, "GetRenderables"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetBoundingSphere"], [[carbon, carbon.method, impl, impl.implemented], 18, "HasTransparentBatches"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Frustum and threshold arrive via the duck-typed update context instead of renderer state.")], 18, "IsVisible"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetBatches"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetBatchesFromOverlayVector"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetShadowBatches"], [[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.implemented], 18, "GetShadowPerObjectData"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("GPU ring-buffer offsets have no CPU derivation and keep their defaults; every CPU-known field is filled.")], 18, "GetPerObjectData"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Overload dispatch by argument shape and a length-1 out array replace C++ overloading and the float& out-param; the shadow math is ported.")], 18, "IsCastingShadow"], [[carbon, carbon.method, impl, impl.implemented], 18, "ChangeLOD"], [[carbon, carbon.method, impl, impl.implemented], 18, "RegisterComponents"], [[carbon, carbon.method, impl, impl.implemented], 18, "UnRegisterComponents"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetLights"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetID"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("JS identifies Carbon's changed member address by its exposed property name; the instanced-mesh cast is performed where that interface is used.")], 18, "OnModified"], [[carbon, carbon.method, impl, impl.implemented], 18, "InvalidateOwnerMergedLocators"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetOwner"], [[carbon, carbon.method, impl, impl.adapted], 18, "CollectOwnedLocatorSets"], [[carbon, carbon.method, impl, impl.implemented], 18, "CollectOwnedGeometry"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetOwnedLocatorSets"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetDamageOverlay"], [[carbon, carbon.method, impl, impl.implemented], 18, "EnsureDamageOverlay"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetArmorDamageShaderEffect"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetArmorDamageShaderEffect"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetOwnedDamageLocators"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetDamageLocatorBindPositionLocal"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetDamageLocatorAnimatedLocal"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetPickingBatches"], [[carbon, carbon.method, impl, impl.implemented], 18, "InitializeAnimation"], [[carbon, carbon.method, impl, impl.notImplemented], 18, "BakeMorphs"], [[carbon, carbon.method, impl, impl.notImplemented], 18, "UnbakeMorphs"], [[carbon, carbon.method, impl, impl.notImplemented], 18, "IsMeshBaked"]], 0, void 0, _EveChildTransform));
     }
     constructor(...args) {
       super(...args);
@@ -100,6 +104,10 @@ new class extends _identity {
     /** Identity rest-pose palette for skinned shaders without live animation. */
     #restPoseBoneTransforms = null;
     #parentOverlayEffects = null;
+
+    /** m_parentData (IEveSpaceObject2::ParentData) - refreshed from the space
+     * object parent in UpdateSyncronous and handed to the decals (cpp:1015, 450). */
+    #parentData = new IEveSpaceObject2ParentData();
     #overlayAreaBlocks = [[], []];
     #overlayAreaBlocksBuilt = false;
 
@@ -108,13 +116,13 @@ new class extends _identity {
     ownedLocatorSets = _init_ownedLocatorSets(this, []);
     armorDamageShader = (_init_extra_ownedLocatorSets(this), _init_armorDamageShader(this, null));
 
-    /**
-     * Clears the private visibility state for a derived child whose own Carbon
-     * cull rejects it before EveChildMesh::UpdateVisibility runs.
-     *
-     * EveChildInstanceMeshRenderer owns exactly that two-stage cull. Keeping the
-     * mutation here preserves one state owner instead of shadowing the four
-     * private values in the subclass.
+    /**
+     * Clears the private visibility state for a derived child whose own Carbon
+     * cull rejects it before EveChildMesh::UpdateVisibility runs.
+     *
+     * EveChildInstanceMeshRenderer owns exactly that two-stage cull. Keeping the
+     * mutation here preserves one state owner instead of shadowing the four
+     * private values in the subclass.
      */
     _ResetVisibilityState() {
       this.#isVisible = false;
@@ -164,9 +172,9 @@ new class extends _identity {
     sofLocatorSetName = (_init_extra_sofParentHullName(this), _init_sofLocatorSetName(this, ""));
     sofLocatorIndex = (_init_extra_sofLocatorSetName(this), _init_sofLocatorIndex(this, ""));
 
-    /**
-     * Rebuilds the local transform up front when the child is marked
-     * staticTransform, since UpdateTransform will not rebuild it on later frames.
+    /**
+     * Rebuilds the local transform up front when the child is marked
+     * staticTransform, since UpdateTransform will not rebuild it on later frames.
      */
     Initialize() {
       if (this.staticTransform) {
@@ -175,13 +183,56 @@ new class extends _identity {
 
       // cpp:84 - bind the updater to this mesh's geometry.
       this.InitializeAnimation();
+      for (let index = 0; index < this.decals.length; index++) this.decals[index].SetPriority(index);
       return true;
     }
 
-    /**
-     * Applies the authored scale/rotation/translation and, when supplied, the
-     * lowest LOD level at which the child stays visible; returns the rebuilt local
-     * transform.
+    /** Carbon owner-list consequences (EveChildMesh.cpp:103–194). */
+    OnListModified(event, key, key2, value, list) {
+      const kind = event & BLUELISTEVENT.BELIST_EVENTMASK;
+      if (list === this.decals) {
+        if (kind === BLUELISTEVENT.BELIST_INSERTED || kind === BLUELISTEVENT.BELIST_REMOVED) {
+          // Carbon quirk: Blue append may report size rather than size - 1.
+          // EveChildMesh.cpp:107–111 retains that off-by-one workaround.
+          const first = kind === BLUELISTEVENT.BELIST_INSERTED && key === this.decals.length ? key - 1 : key;
+          for (let index = first; index < this.decals.length; index++) this.decals[index].SetPriority(index);
+        } else if (kind === BLUELISTEVENT.BELIST_SWAPPED) {
+          this.decals[key].SetPriority(key);
+          this.decals[key2].SetPriority(key2);
+        } else if (kind === BLUELISTEVENT.BELIST_MOVED) {
+          for (let index = Math.min(key, key2); index <= Math.max(key, key2); index++) this.decals[index].SetPriority(index);
+        }
+      }
+      if (list === this.lights) {
+        const registry = this.GetComponentRegistry();
+        if (registry) {
+          if (kind === BLUELISTEVENT.BELIST_UNLOADSTART || kind === BLUELISTEVENT.BELIST_REMOVED && !this.lights.length) {
+            registry.UnRegisterComponent(EveComponentType.LightOwner, this);
+          } else if (kind === BLUELISTEVENT.BELIST_INSERTED && this.lights.length === 1) {
+            registry.RegisterComponent(EveComponentType.LightOwner, this);
+          }
+        }
+      }
+      if (list === this.attachments && !(event & BLUELISTEVENT.BELIST_LOADING) && this.IsInRegistry()) {
+        const registry = this.GetComponentRegistry();
+        if (kind === BLUELISTEVENT.BELIST_INSERTED || kind === BLUELISTEVENT.BELIST_REMOVED) {
+          const entity = CjsSchema.cast(value, _EveEntity);
+          if (entity) {
+            if (kind === BLUELISTEVENT.BELIST_INSERTED) entity.Register(registry);else entity.UnRegister(registry);
+          }
+        } else if (kind === BLUELISTEVENT.BELIST_UNLOADSTART) {
+          for (const attachment of this.attachments) {
+            const entity = CjsSchema.cast(attachment, _EveEntity);
+            if (entity) entity.UnRegister(registry);
+          }
+        }
+      }
+    }
+
+    /**
+     * Applies the authored scale/rotation/translation and, when supplied, the
+     * lowest LOD level at which the child stays visible; returns the rebuilt local
+     * transform.
      */
     Setup(scale = null, rotation = null, translation = null, lowestLodVisible = null) {
       super.Setup(scale, rotation, translation, lowestLodVisible);
@@ -191,10 +242,10 @@ new class extends _identity {
       return this.localTransform;
     }
 
-    /**
-     * Replaces the instance placement list with clones of the supplied matrices, so later caller mutations do not reach the child.
-     * @param {Iterable<Float32Array>} instances - 16-value matrices; a wrongly sized entry throws TypeError
-     * @returns {Array<Float32Array>} the stored list
+    /**
+     * Replaces the instance placement list with clones of the supplied matrices, so later caller mutations do not reach the child.
+     * @param {Iterable<Float32Array>} instances - 16-value matrices; a wrongly sized entry throws TypeError
+     * @returns {Array<Float32Array>} the stored list
      */
     SetInstanceTransforms(instances) {
       const next = [];
@@ -208,18 +259,18 @@ new class extends _identity {
       return this.instanceTransforms;
     }
 
-    /**
-     * Returns the live instance transform list, not a copy - mutating it changes
-     * what the child renders.
+    /**
+     * Returns the live instance transform list, not a copy - mutating it changes
+     * what the child renders.
      */
     GetInstanceTransforms() {
       return this.instanceTransforms;
     }
 
-    /**
-     * Assigns the Tr2MeshBase this child draws; a nullish value clears it, which
-     * also makes the child permanently invisible (UpdateVisibility requires a
-     * mesh).
+    /**
+     * Assigns the Tr2MeshBase this child draws; a nullish value clears it, which
+     * also makes the child permanently invisible (UpdateVisibility requires a
+     * mesh).
      */
     SetMesh(mesh) {
       this.mesh = mesh ?? null;
@@ -244,48 +295,48 @@ new class extends _identity {
       return this.overlayEffects.find(effect => effect.name === String(name)) ?? null;
     }
 
-    /**
-     * Records whether this child's placement was authored in space or by SOF (the
-     * Origin enum).
+    /**
+     * Records whether this child's placement was authored in space or by SOF (the
+     * Origin enum).
      */
     SetOrigin(origin) {
       this.origin = Number(origin) | 0;
     }
 
-    /**
-     * Copies the given scale into the child's SRT scaling; it reaches the world
-     * transform on the next local-transform rebuild.
+    /**
+     * Copies the given scale into the child's SRT scaling; it reaches the world
+     * transform on the next local-transform rebuild.
      */
     SetScale(scale) {
       vec3.copy(this.scaling, scale);
     }
 
-    /**
-     * Sets the reflection mode, which decides whether the child registers as a
-     * ReflectionRenderable and whether it casts shadows during reflection passes.
+    /**
+     * Sets the reflection mode, which decides whether the child registers as a
+     * ReflectionRenderable and whether it casts shadows during reflection passes.
      */
     SetReflectionMode(mode) {
       this.reflectionMode = Number(mode) | 0;
     }
 
-    /**
-     * Sets whether the child registers as a shadow caster and contributes opaque
-     * shadow batches.
+    /**
+     * Sets whether the child registers as a shadow caster and contributes opaque
+     * shadow batches.
      */
     SetCastShadow(castShadow) {
       this.castShadow = !!castShadow;
     }
 
-    /**
-     * Sets the minimum screen size, in pixels across, that the child's world
-     * bounding sphere must reach - after the frame's inverse LOD factor scaling -
-     * before UpdateVisibility marks it visible.
+    /**
+     * Sets the minimum screen size, in pixels across, that the child's world
+     * bounding sphere must reach - after the frame's inverse LOD factor scaling -
+     * before UpdateVisibility marks it visible.
      */
     SetMinScreenSize(minScreenSize) {
       this.minScreenSize = Number(minScreenSize);
     }
 
-    /** Carbon EveChildMesh::GetLocalToWorldTransform (cpp:1047-1050); the
+    /** Carbon EveChildMesh::GetLocalToWorldTransform (cpp:1047-1050); the
      * optional out follows the EveChildInstancedMeshes copy-out shape. */
     GetLocalToWorldTransform(out = null) {
       if (out) {
@@ -294,9 +345,9 @@ new class extends _identity {
       return this.worldTransform;
     }
 
-    /**
-     * The authored name, persisted with the child and used to identify it in the
-     * parent graph.
+    /**
+     * The authored name, persisted with the child and used to identify it in the
+     * parent graph.
      */
     GetName() {
       return this.name;
@@ -307,50 +358,50 @@ new class extends _identity {
       this.name = String(name ?? "");
     }
 
-    /**
-     * Appends a transform modifier; modifiers fold over the child's world
-     * transform in insertion order on each async update.
+    /**
+     * Appends a transform modifier; modifiers fold over the child's world
+     * transform in insertion order on each async update.
      */
     AddTransformModifier(modifier) {
       this.transformModifiers.push(modifier);
     }
 
-    /**
-     * Appends a decal; decals refresh their visibility only while the child itself
-     * is visible, and ride along in GetRenderables when the mesh has a geometry
-     * resource.
+    /**
+     * Appends a decal; decals refresh their visibility only while the child itself
+     * is visible, and ride along in GetRenderables when the mesh has a geometry
+     * resource.
      */
     AddDecal(decal) {
       this.decals.push(decal);
     }
 
-    /**
-     * Appends an attachment; attachments refresh their lights and visibility every
-     * frame regardless of the child's own visibility.
+    /**
+     * Appends an attachment; attachments refresh their lights and visibility every
+     * frame regardless of the child's own visibility.
      */
     AddAttachment(attachment) {
       this.attachments.push(attachment);
     }
 
-    /**
-     * Drops every attachment, removing their lights, batches and visibility
-     * updates from this child.
+    /**
+     * Drops every attachment, removing their lights, batches and visibility
+     * updates from this child.
      */
     ClearAttachments() {
       this.attachments.length = 0;
     }
 
-    /**
-     * Appends a light, submitted to the light manager from the child's world
-     * transform while the child displays.
+    /**
+     * Appends a light, submitted to the light manager from the child's world
+     * transform while the child displays.
      */
     AddLight(light) {
       this.lights.push(light);
     }
 
-    /**
-     * Drops every light, which also stops the child registering as a LightOwner on
-     * the next component registration.
+    /**
+     * Drops every light, which also stops the child registering as a LightOwner on
+     * the next component registration.
      */
     ClearLights() {
       this.lights.length = 0;
@@ -373,27 +424,27 @@ new class extends _identity {
       }
     }
 
-    /**
-     * Names of the mesh's morph targets in index order, or an empty array when the
-     * mesh exposes none; the indices line up with the records GetMorphTargets
-     * returns.
+    /**
+     * Names of the mesh's morph targets in index order, or an empty array when the
+     * mesh exposes none; the indices line up with the records GetMorphTargets
+     * returns.
      */
     GetMorphTargetNames() {
       return this.mesh?.GetMorphTargetNames?.() ?? [];
     }
 
-    /**
-     * Writes a named morph weight on the mesh; it only reaches the render path
-     * after the next UpdateMorphAnimationBuffer pass re-sorts the indexed buffer.
+    /**
+     * Writes a named morph weight on the mesh; it only reaches the render path
+     * after the next UpdateMorphAnimationBuffer pass re-sorts the indexed buffer.
      */
     SetMorphTargetWeight(name, weight) {
       this.mesh?.SetMorphTargetWeight?.(name, weight);
     }
 
-    /**
-     * Reads a named morph weight straight from the mesh (0 when it has no such
-     * target), bypassing any animation-driven value the morph buffer may have
-     * applied.
+    /**
+     * Reads a named morph weight straight from the mesh (0 when it has no such
+     * target), bypassing any animation-driven value the morph buffer may have
+     * applied.
      */
     GetMorphTargetWeight(name) {
       return this.mesh?.GetMorphTargetWeight?.(name) ?? 0;
@@ -467,22 +518,22 @@ new class extends _identity {
       }));
     }
 
-    /**
-     * Always returns null: a child mesh exposes no packed area-id lookup, since
-     * its SOF identity lives directly on its
-     * sofParentHullName/sofLocatorSetName/sofLocatorIndex fields.
+    /**
+     * Always returns null: a child mesh exposes no packed area-id lookup, since
+     * its SOF identity lives directly on its
+     * sofParentHullName/sofLocatorSetName/sofLocatorIndex fields.
      */
     GetSofSourceLocator() {
       return null;
     }
 
-    /**
-     * Sync-side frame update (Carbon EveChildMesh::UpdateSyncronous,
-     * cpp:1002-1045). Carbon's body is entirely audio-geometry registration
-     * (cpp:1004-1010, 1044 - engine/audio-owned, omitted) plus animationUpdater
-     * re-binding and PrePhysicsAnimation stepping (cpp:1011-1042 - skipped: the
-     * JS animation seam is absent, there is no Tr2GrannyAnimation runtime), so
-     * the port is a documented frame-contract no-op.
+    /**
+     * Sync-side frame update (Carbon EveChildMesh::UpdateSyncronous,
+     * cpp:1002-1045). Carbon's body is entirely audio-geometry registration
+     * (cpp:1004-1010, 1044 - engine/audio-owned, omitted) plus animationUpdater
+     * re-binding and PrePhysicsAnimation stepping (cpp:1011-1042 - skipped: the
+     * JS animation seam is absent, there is no Tr2GrannyAnimation runtime), so
+     * the port is a documented frame-contract no-op.
      */
     UpdateSyncronous(updateContext, _params) {
       if (this.damageOverlay) this.damageOverlay.UpdateSyncronous(updateContext);
@@ -490,17 +541,17 @@ new class extends _identity {
       for (const overlay of this.overlayEffects) overlay.Update(time, time);
     }
 
-    /**
-     * Per-frame async update (Carbon EveChildMesh::UpdateAsyncronous,
-     * cpp:903-1000): rebuild the world transform from the parent, fold the
-     * transform modifiers over it, store the activation strength, refresh the
-     * attachment lights, the morph buffer, and the world bounds. The GPU ring
-     * buffer advance/per-object-data invalidation (cpp:905-909), audio geometry
-     * (cpp:920-930), parent VS/PS struct refresh (cpp:932-960), and the skinned
-     * GetBounds overload are not modelled, hence @impl.adapted.
-     * @param {Object} updateContext - frame context (EveUpdateContext), threaded to modifiers
-     * @param {EveChildUpdateParams} params - localToWorldTransform + boneCount/bones
-     * @returns {Float32Array} worldTransform
+    /**
+     * Per-frame async update (Carbon EveChildMesh::UpdateAsyncronous,
+     * cpp:903-1000): rebuild the world transform from the parent, fold the
+     * transform modifiers over it, store the activation strength, refresh the
+     * attachment lights, the morph buffer, and the world bounds. The GPU ring
+     * buffer advance/per-object-data invalidation (cpp:905-909), audio geometry
+     * (cpp:920-930), parent VS/PS struct refresh (cpp:932-960), and the skinned
+     * GetBounds overload are not modelled, hence @impl.adapted.
+     * @param {Object} updateContext - frame context (EveUpdateContext), threaded to modifiers
+     * @param {EveChildUpdateParams} params - localToWorldTransform + boneCount/bones
+     * @returns {Float32Array} worldTransform
      */
     UpdateAsyncronous(updateContext, params) {
       const parentTransform = params?.localToWorldTransform;
@@ -516,6 +567,9 @@ new class extends _identity {
       // data by this child's translation, then stamp our own transforms.
       const parent = params?.spaceObjectParent ?? null;
       inheritParentPerObjectData(this.#perObjectData, parent, this.translation);
+      // Carbon cpp:1015: the decals' parent data comes from the space object
+      // parent, then is made relevant to this child below.
+      if (parent) parent.GetParentData(this.#parentData);
       this.#parentOverlayEffects = this.inheritOverlayEffects && Array.isArray(parent?.overlayEffects) ? parent.overlayEffects : null;
       if (parent && !this.inheritOverlayEffects) {
         this.#perObjectData.vs.Set("clipData", [0, 0, 0, 0]);
@@ -523,7 +577,14 @@ new class extends _identity {
         this.#perObjectData.ps.Set("clipRadius2Sq", [0]);
         this.#perObjectData.ps.Set("clipSphereFactor", [0]);
         this.#perObjectData.ps.Set("clipSphereFactor2", [0]);
+        // cpp:1033-1036: the decals lose the inherited clip sphere too.
+        this.#parentData.clipRadiusSq = 0;
+        this.#parentData.clipRadius2Sq = 0;
+        this.#parentData.clipFactor = 0;
+        this.#parentData.clipFactor2 = 0;
       }
+      // cpp:1044: the decals are placed by this child's world transform.
+      if (parent) mat4.copy(this.#parentData.transform, this.worldTransform);
       stampChildTransforms(this.#perObjectData, this.worldTransform, this.#lastWorldTransform);
       this.#activationStrength = Number(params?.activationStrength ?? 1);
       if (this.damageOverlay) {
@@ -584,30 +645,30 @@ new class extends _identity {
       return this.worldTransform;
     }
 
-    /**
-     * Frame visibility + LOD state (Carbon EveChildMesh::UpdateVisibility,
-     * cpp:366-463): screen size via the frustum, invLodFactor scaling, the
-     * minScreenSize/lowestLodVisible gates, the per-instance visibility gate,
-     * and the attachment/decal visibility fan-out. Carbon recomputes the local
-     * mesh bounds here (cpp:380-394) but consumes only the world sphere/box
-     * computed in UpdateAsyncronous, so the dead recompute is skipped. The
-     * raytracing branch (cpp:450-462) is engine-owned and omitted.
-     * @param {Object} updateContext - frame context (frustum + invLodFactor ducks)
-     * @param {Float32Array} _parentTransform
-     * @param {Number} parentLod - parent Tr2Lod level
-     * @returns {Boolean} isVisible
+    /**
+     * Frame visibility + LOD state (Carbon EveChildMesh::UpdateVisibility,
+     * cpp:366-463): screen size via the frustum, invLodFactor scaling, the
+     * minScreenSize/lowestLodVisible gates, the per-instance visibility gate,
+     * and the attachment/decal visibility fan-out. Carbon recomputes the local
+     * mesh bounds here (cpp:380-394) but consumes only the world sphere/box
+     * computed in UpdateAsyncronous, so the dead recompute is skipped. The
+     * raytracing branch (cpp:450-462) is not ported yet and omitted.
+     * @param {Object} updateContext - frame context (frustum + invLodFactor ducks)
+     * @param {Float32Array} _parentTransform
+     * @param {Number} parentLod - parent Tr2Lod level
+     * @returns {Boolean} isVisible
      */
-    /**
-     * The mesh's bone palette, as a borrowed Float4x3 buffer and its bone count.
-     *
-     * Carbon `EveChildMesh::GetBoneTransforms` (cpp:1285-1307). Carbon branches:
-     * the updater's own palette when it has a mesh binding, otherwise a separate
-     * `Tr2AnimationMeshBinding` palette. Only the first branch exists here -
-     * `Tr2AnimationMeshBinding` is unported - so a mesh relying on the second
-     * gets no bones rather than the wrong ones.
-     *
-     * Carbon also assigns `accumulatedTransforms` and never reads it; that dead
-     * local is not reproduced.
+    /**
+     * The mesh's bone palette, as a borrowed Float4x3 buffer and its bone count.
+     *
+     * Carbon `EveChildMesh::GetBoneTransforms` (cpp:1285-1307). Carbon branches:
+     * the updater's own palette when it has a mesh binding, otherwise a separate
+     * `Tr2AnimationMeshBinding` palette. Only the first branch exists here -
+     * `Tr2AnimationMeshBinding` is unported - so a mesh relying on the second
+     * gets no bones rather than the wrong ones.
+     *
+     * Carbon also assigns `accumulatedTransforms` and never reads it; that dead
+     * local is not reproduced.
      */
     GetBoneTransforms() {
       const updater = this.animationUpdater;
@@ -625,9 +686,9 @@ new class extends _identity {
       return this.GetRestPoseBoneTransforms();
     }
 
-    /**
-     * Builds Carbon's identity Float4x3 rest-pose palette. Geometry with no bone
-     * bindings still receives one identity because skinned shaders read bone 0.
+    /**
+     * Builds Carbon's identity Float4x3 rest-pose palette. Geometry with no bone
+     * bindings still receives one identity because skinned shaders read bone 0.
      */
     GetRestPoseBoneTransforms() {
       const geometry = this.mesh ? this.mesh.GetGeometryResource() : null;
@@ -650,10 +711,10 @@ new class extends _identity {
       };
     }
 
-    /**
-     * Resolves this child's visibility for the frame from its world bounding
-     * sphere, the parent LOD, and the authored screen-size thresholds, recording
-     * the mesh and per-instance screen sizes the batch path then draws at.
+    /**
+     * Resolves this child's visibility for the frame from its world bounding
+     * sphere, the parent LOD, and the authored screen-size thresholds, recording
+     * the mesh and per-instance screen sizes the batch path then draws at.
      */
     UpdateVisibility(updateContext, _parentTransform = null, parentLod = Tr2Lod.TR2_LOD_HIGH) {
       this.#isVisible = false;
@@ -721,20 +782,19 @@ new class extends _identity {
         for (const decal of this.decals) {
           // Carbon (cpp:441-446) feeds animated bone matrices to the decal first
           // - skipped until the JS animation seam exists. Carbon passes
-          // &m_parentData (per-object shading struct, GPU seam); the owning
-          // child stands in as the duck-typed parent.
-          decal?.UpdateVisibility(updateContext, this);
+          // &m_parentData (cpp:450), refreshed in UpdateSyncronous.
+          decal?.UpdateVisibility(updateContext, this.#parentData);
         }
       }
       return this.#isVisible;
     }
 
-    /**
-     * Collects this child (and its decals) as renderables (Carbon
-     * EveChildMesh::GetRenderables, cpp:571-616): instanced meshes contribute
-     * only while the per-instance gate passed; decals ride along through their
-     * duck-typed renderable collectors (mesh cache is engine-owned, passed null
-     * as in EveSpaceObject2.GetRenderables).
+    /**
+     * Collects this child (and its decals) as renderables (Carbon
+     * EveChildMesh::GetRenderables, cpp:571-616): instanced meshes contribute
+     * only while the per-instance gate passed; decals ride along through their
+     * duck-typed renderable collectors (mesh cache is not ported yet, passed null
+     * as in EveSpaceObject2.GetRenderables).
      */
     GetRenderables(out = []) {
       if (!this.#isVisible) {
@@ -762,7 +822,7 @@ new class extends _identity {
       return out;
     }
 
-    /** Carbon EveChildMesh::GetBoundingSphere (cpp:618-627): the realized world
+    /** Carbon EveChildMesh::GetBoundingSphere (cpp:618-627): the realized world
      * sphere, valid only after an update produced bounds (radius > 0). */
     GetBoundingSphere(out = vec4.create(), _query = 0) {
       if (this.#worldBoundingSphere[3] > 0) {
@@ -786,7 +846,7 @@ new class extends _identity {
       return false;
     }
 
-    /** Carbon EveChildMesh::IsVisible (cpp:639-650): sphere-in-frustum plus the
+    /** Carbon EveChildMesh::IsVisible (cpp:639-650): sphere-in-frustum plus the
      * estimated pixel size against the context visibility threshold. */
     IsVisible(updateContext) {
       if (this.#worldBoundingSphere[3] > 0) {
@@ -801,13 +861,13 @@ new class extends _identity {
       return false;
     }
 
-    /** Carbon EveChildMesh::GetBatches (cpp:652-670): the mesh delegates per
-     * batch type and activated attachments recurse, at
-     * min(currentInstanceScreenSize, currentScreenSize) and with a reverse-winding
-     * flag from Determinant(m_worldTransform) < 0 - a negative determinant means
-     * the transform mirrors, which flips triangle facing. A determinant is
-     * transpose-invariant, so the row-vector/column-vector difference does not
-     * apply to this test. Returns whether any batch was committed (JS addition;
+    /** Carbon EveChildMesh::GetBatches (cpp:652-670): the mesh delegates per
+     * batch type and activated attachments recurse, at
+     * min(currentInstanceScreenSize, currentScreenSize) and with a reverse-winding
+     * flag from Determinant(m_worldTransform) < 0 - a negative determinant means
+     * the transform mirrors, which flips triangle facing. A determinant is
+     * transpose-invariant, so the row-vector/column-vector difference does not
+     * apply to this test. Returns whether any batch was committed (JS addition;
      * Carbon returns void). */
     GetBatches(batches, batchType, perObjectData, reason = Tr2RenderReason.TR2RENDERREASON_NORMAL) {
       if (!this.display) {
@@ -853,9 +913,9 @@ new class extends _identity {
       return committed;
     }
 
-    /** Carbon EveChildMesh::GetShadowBatches (cpp:672-681): the OPAQUE areas
-     * only, gated on display/mesh/hasUpdated, at the caller's shadow pixel size
-     * rather than the child's own screen size. Returns whether any batch was
+    /** Carbon EveChildMesh::GetShadowBatches (cpp:672-681): the OPAQUE areas
+     * only, gated on display/mesh/hasUpdated, at the caller's shadow pixel size
+     * rather than the child's own screen size. Returns whether any batch was
      * committed (JS addition; Carbon returns void). */
     GetShadowBatches(batches, perObjectData, shadowPixelSize = Infinity) {
       if (this.display && this.mesh && this.#hasUpdated) {
@@ -864,7 +924,7 @@ new class extends _identity {
       return false;
     }
 
-    /** Carbon EveChildMesh::GetSortValue (cpp:787-792): view distance scaled by
+    /** Carbon EveChildMesh::GetSortValue (cpp:787-792): view distance scaled by
      * sortValueScale plus sortValueOffset. */
     GetSortValue(renderContext = null) {
       const viewPosition = renderContext?.GetViewPosition();
@@ -874,21 +934,21 @@ new class extends _identity {
       return Math.hypot(x, y, z) * this.sortValueScale + this.sortValueOffset;
     }
 
-    /** Carbon EveChildMesh::GetShadowPerObjectData (cpp:794-797) forwards the
+    /** Carbon EveChildMesh::GetShadowPerObjectData (cpp:794-797) forwards the
      * shadow pass to the same per-object record. */
     GetShadowPerObjectData(accumulator = null) {
       return this.GetPerObjectData(accumulator);
     }
 
-    /**
-     * Carbon EveChildMesh::GetPerObjectData (cpp:799-843): resets the morph
-     * counters, uploads the bone and morph rings, then hands back a handle over
-     * this child's two PERSISTENT buffers.
-     *
-     * The ring OFFSETS (`boneOffsets[0..1]`, `morphTargetAnimationDataOffset`,
-     * `morphTargetVertexDataOffset`, `bakedMorphTargetVertexDataOffset`) are GPU
-     * addresses with no CPU derivation, so they keep their defaults; the counts,
-     * which are CPU-known, are written.
+    /**
+     * Carbon EveChildMesh::GetPerObjectData (cpp:799-843): resets the morph
+     * counters, uploads the bone and morph rings, then hands back a handle over
+     * this child's two PERSISTENT buffers.
+     *
+     * The ring OFFSETS (`boneOffsets[0..1]`, `morphTargetAnimationDataOffset`,
+     * `morphTargetVertexDataOffset`, `bakedMorphTargetVertexDataOffset`) are GPU
+     * addresses with no CPU derivation, so they keep their defaults; the counts,
+     * which are CPU-known, are written.
      */
     GetPerObjectData(_accumulator = null) {
       this.#perObjectData.vs.Set("activeMorphTargetsCount", [0]);
@@ -904,17 +964,17 @@ new class extends _identity {
       };
     }
 
-    /**
-     * Carbon's two IsCastingShadow overloads, dispatched on the second argument:
-     * a position vector (length >= 3) selects the sphere-overlap overload
-     * (cpp:338-364); anything else is the shadow-frustum overload (cpp:295-336),
-     * whose Carbon out-param float& sizeInShadow becomes the optional trailing
-     * length-1 array (out-params last).
-     * @param {Object} cameraFrustum
-     * @param {Object|Float32Array} shadowFrustumOrPosition
-     * @param {Number} renderReasonOrRadius
-     * @param {Array|Number} sizeInShadowOutOrRenderReason
-     * @returns {Boolean}
+    /**
+     * Carbon's two IsCastingShadow overloads, dispatched on the second argument:
+     * a position vector (length >= 3) selects the sphere-overlap overload
+     * (cpp:338-364); anything else is the shadow-frustum overload (cpp:295-336),
+     * whose Carbon out-param float& sizeInShadow becomes the optional trailing
+     * length-1 array (out-params last).
+     * @param {Object} cameraFrustum
+     * @param {Object|Float32Array} shadowFrustumOrPosition
+     * @param {Number} renderReasonOrRadius
+     * @param {Array|Number} sizeInShadowOutOrRenderReason
+     * @returns {Boolean}
      */
     IsCastingShadow(cameraFrustum, shadowFrustumOrPosition, renderReasonOrRadius, sizeInShadowOutOrRenderReason = null) {
       if (!this.display || !this.castShadow || !this.#hasUpdated) {
@@ -982,12 +1042,12 @@ new class extends _identity {
     /** Carbon EveChildMesh::ChangeLOD (cpp:1052-1054) is an intentional no-op. */
     ChangeLOD(_lod) {}
 
-    /** Carbon EveChildMesh::RegisterComponents (cpp:239-269): LightOwner when
-     * lights are authored; ReflectionRenderable (ShouldReflect) and ShadowCaster
-     * (castShadow) only when a mesh is present; then forwards the attachments.
-     * Gate m_display. "MeshMorph" stays OUT-OF-BAND: Carbon registers it at
-     * baked-morph need inside BakeMorphs (cpp:1404-1409), not here - the JS
-     * BakeMorphs stub is the site that would register it when the GPU morph
+    /** Carbon EveChildMesh::RegisterComponents (cpp:239-269): LightOwner when
+     * lights are authored; ReflectionRenderable (ShouldReflect) and ShadowCaster
+     * (castShadow) only when a mesh is present; then forwards the attachments.
+     * Gate m_display. "MeshMorph" stays OUT-OF-BAND: Carbon registers it at
+     * baked-morph need inside BakeMorphs (cpp:1404-1409), not here - the JS
+     * BakeMorphs stub is the site that would register it when the GPU morph
      * bake is ported. */
     RegisterComponents() {
       const registry = this.GetComponentRegistry();
@@ -1009,9 +1069,9 @@ new class extends _identity {
       }
     }
 
-    /** Carbon EveChildMesh::UnRegisterComponents (cpp:275-290): forwards the
-     * attachments only (own components were already removed by
-     * EveEntity::UnRegister, EveEntity.cpp:90); no display re-check.
+    /** Carbon EveChildMesh::UnRegisterComponents (cpp:275-290): forwards the
+     * attachments only (own components were already removed by
+     * EveEntity::UnRegister, EveEntity.cpp:90); no display re-check.
      * UnregisterAudioGeometry (cpp:277) is audio-engine-owned and unported. */
     UnRegisterComponents() {
       const registry = this.GetComponentRegistry();
@@ -1022,12 +1082,12 @@ new class extends _identity {
       }
     }
 
-    /** Carbon EveChildMesh::GetLights (cpp:1638-1652): BOTH gates (empty
-     * lights and display, cpp:1640 - unlike EveSpaceObject2's display-only),
-     * then per light AddLight(manager, worldTransform, 1, bones, boneCount)
-     * FOLLOWED by SetBrightnessMultiplier(m_activationStrength) - the
-     * one-frame-lag order is contract (the submission uses the multiplier
-     * stamped on the previous pass; the first pass uses the Tr2Light default
+    /** Carbon EveChildMesh::GetLights (cpp:1638-1652): BOTH gates (empty
+     * lights and display, cpp:1640 - unlike EveSpaceObject2's display-only),
+     * then per light AddLight(manager, worldTransform, 1, bones, boneCount)
+     * FOLLOWED by SetBrightnessMultiplier(m_activationStrength) - the
+     * one-frame-lag order is contract (the submission uses the multiplier
+     * stamped on the previous pass; the first pass uses the Tr2Light default
      * 1). */
     GetLights(lightManager) {
       if (!this.lights.length || !this.display) {
@@ -1050,13 +1110,39 @@ new class extends _identity {
       return this;
     }
 
+    /**
+     * Carbon OnModified (EveChildMesh.cpp:197-216): three independent tests, not
+     * a chain - a mesh change satisfies the first two, and the third only runs
+     * for a child that owns locator sets.
+     */
+    OnModified(propertyName) {
+      if (propertyName === "reflectionMode" || propertyName === "display" || propertyName === "mesh" || propertyName === "castShadow") {
+        this.ReRegister();
+      }
+      if (propertyName === "mesh" || propertyName === "animationUpdater") {
+        this.InitializeAnimation();
+      }
+      if (this.ownedLocatorSets.length && (propertyName === "scaling" || propertyName === "rotation" || propertyName === "translation" || propertyName === "localTransform")) {
+        this.InvalidateOwnerMergedLocators("partMoved");
+      }
+      return true;
+    }
+
+    /**
+     * Carbon InvalidateOwnerMergedLocators (EveChildMesh.cpp:1330-1336): tell the
+     * owner its merged locator sets are stale, and why.
+     */
+    InvalidateOwnerMergedLocators(reason = "structure") {
+      this.GetOwner()?.InvalidateMergedLocators(reason);
+    }
+
     /** Invalidates merged locators on both the old and new owner. */
     SetOwner(owner) {
       if (this.GetOwner() === owner) return;
-      const oldOwner = this.GetOwner();
-      if (oldOwner) oldOwner.InvalidateMergedLocators("structure");
+      // Carbon cpp:1894-1896: the same helper on both sides of the move.
+      this.InvalidateOwnerMergedLocators("structure");
       super.SetOwner(owner);
-      if (owner) owner.InvalidateMergedLocators("structure");
+      this.InvalidateOwnerMergedLocators("structure");
     }
 
     /** Contributes child-owned locator sets with the child-to-object transform. */
@@ -1074,10 +1160,10 @@ new class extends _identity {
       }
     }
 
-    /**
-     * Contributes this child's geometry to the owner's merged raycast set
-     * (Carbon EveChildMesh.cpp:2061-2077): one record per mesh, its areas
-     * appended to the shared pool by batch type.
+    /**
+     * Contributes this child's geometry to the owner's merged raycast set
+     * (Carbon EveChildMesh.cpp:2061-2077): one record per mesh, its areas
+     * appended to the shared pool by batch type.
      */
     CollectOwnedGeometry(type, parentTransform, out, areaPool) {
       const geometry = this.mesh ? this.mesh.GetGeometryResource() : null;
@@ -1123,9 +1209,9 @@ new class extends _identity {
       return this.armorDamageShader;
     }
 
-    /**
-     * Returns the locator list of this child's own damage set, or null when the
-     * child owns no damage locators (Carbon EveChildMesh.cpp:2117-2127).
+    /**
+     * Returns the locator list of this child's own damage set, or null when the
+     * child owns no damage locators (Carbon EveChildMesh.cpp:2117-2127).
      */
     GetOwnedDamageLocators() {
       for (const set of this.ownedLocatorSets) {
@@ -1134,10 +1220,10 @@ new class extends _identity {
       return null;
     }
 
-    /**
-     * Resolves one damage locator's BIND-pose position in the child's local
-     * space - no bone transform, the stable overlay seed position (Carbon
-     * EveChildMesh.cpp:2129-2139).
+    /**
+     * Resolves one damage locator's BIND-pose position in the child's local
+     * space - no bone transform, the stable overlay seed position (Carbon
+     * EveChildMesh.cpp:2129-2139).
      */
     GetDamageLocatorBindPositionLocal(index, out = vec3.create()) {
       const locators = this.GetOwnedDamageLocators();
@@ -1147,10 +1233,10 @@ new class extends _identity {
       return true;
     }
 
-    /**
-     * Resolves one damage locator's animated position and direction in the
-     * child's local space, posed by this child's own animation updater (Carbon
-     * EveChildMesh.cpp:2141-2151).
+    /**
+     * Resolves one damage locator's animated position and direction in the
+     * child's local space, posed by this child's own animation updater (Carbon
+     * EveChildMesh.cpp:2141-2151).
      */
     GetDamageLocatorAnimatedLocal(index, outPosition, outDirection) {
       const locators = this.GetOwnedDamageLocators();
@@ -1160,14 +1246,14 @@ new class extends _identity {
       return true;
     }
 
-    /**
-     * Carbon EveChildMesh::GetPickingBatches (cpp:862-889): collects the geometry
-     * a pick pass should test, by mask. Unlike the hull's version this one has no
-     * overlay effects to pull in.
-     *
-     * @param {Object} batches - the picking accumulator
-     * @param {Number} pickTypes - a Tr2PickType mask
-     * @param {Object} perObjectData - this child's per-object record
+    /**
+     * Carbon EveChildMesh::GetPickingBatches (cpp:862-889): collects the geometry
+     * a pick pass should test, by mask. Unlike the hull's version this one has no
+     * overlay effects to pull in.
+     *
+     * @param {Object} batches - the picking accumulator
+     * @param {Number} pickTypes - a Tr2PickType mask
+     * @param {Object} perObjectData - this child's per-object record
      */
     GetPickingBatches(batches, pickTypes = TR2_PICK_TYPE_DEFAULT, perObjectData = null) {
       if (pickTypes & Tr2PickType.PICK_TYPE_PICKING) {
@@ -1193,14 +1279,14 @@ new class extends _identity {
       return true;
     }
 
-    /**
-     * Binds the animation updater to this mesh's geometry, so a child with no
-     * animation resource of its own animates from the mesh's own bone binding.
-     *
-     * Carbon `EveChildMesh::InitializeAnimation` (cpp:217-232). Only runs when
-     * the updater has no authored resPath - one that does keeps its own
-     * resource. When the mesh has no geometry yet the shared binding is cleared
-     * rather than left stale, so a later mesh swap rebinds cleanly.
+    /**
+     * Binds the animation updater to this mesh's geometry, so a child with no
+     * animation resource of its own animates from the mesh's own bone binding.
+     *
+     * Carbon `EveChildMesh::InitializeAnimation` (cpp:217-232). Only runs when
+     * the updater has no authored resPath - one that does keeps its own
+     * resource. When the mesh has no geometry yet the shared binding is cleared
+     * rather than left stale, so a later mesh swap rebinds cleanly.
      */
     InitializeAnimation() {
       const updater = this.animationUpdater;