@carbonenginejs/runtime-trinity 0.4.3 → 0.5.0

package/dist/eve/child/EveChildContainer.js

@@ -8,6 +8,7 @@ import { io, type, carbon, impl, schema } from '@carbonenginejs/core-types/schem
 import { EveChildTransform as _EveChildTransform, applyTransformModifiers } from './EveChildTransform.js';
 import { EveChildInheritProperties as _EveChildInheritPrope } from './EveChildInheritProperties.js';
 import { EveChildUpdateParams as _EveChildUpdateParams } from '../EveChildUpdateParams.js';
+import { EveComponentType } from '../EveComponentTypes.js';
 import { Origin } from '../../generated/eve/child/enums.js';
 import { Tr2RenderReason, TR2SHADERMODEL } from '../../generated/trinityCore/enums.js';
 import { Tr2Lod } from '../EveLODHelper.js';
@@ -28,7 +29,7 @@ new class extends _identity {
       } = _applyDecs2311(this, [type.define({
         className: "EveChildContainer",
         family: "eve/child"
-      })], [[[io, io.notify, io, io.persist, type, type.int32, void 0, schema.enum("DisplayQualityModifier")], 16, "displayFilter"], [[io, io.persist, void 0, type.list("IEveSpaceObjectChild")], 16, "objects"], [[io, io.persist, void 0, type.list("IEveChildTransformModifier")], 16, "transformModifiers"], [[io, io.persist, void 0, type.list("TriCurveSet")], 16, "curveSets"], [[io, io.read, type, type.mat4], 16, "worldTransform"], [[io, io.notify, io, io.readwrite, type, type.boolean], 16, "mute"], [[io, io.notify, io, io.persist, type, type.boolean], 16, "display"], [[io, io.persist, type, type.string], 16, "name"], [[io, io.persist, type, type.vec3], 16, "translation"], [[io, io.persist, type, type.quat], 16, "rotation"], [[io, io.persist, type, type.vec3], 16, "scaling"], [[io, io.persist, type, type.mat4], 16, "localTransform"], [[io, io.persist, type, type.boolean], 16, "staticTransform"], [[io, io.persist, type, type.boolean], 16, "alwaysOn"], [[io, io.persist, type, type.boolean], 16, "updateOnDisplay"], [[io, io.persist, void 0, type.list("IEveSpaceObjectAttachment")], 16, "attachments"], [[io, io.persist, void 0, type.list("TriObserverLocal")], 16, "observers"], [[io, io.persist, void 0, type.list("IEveFxAttribute")], 16, "fxAttributes"], [[io, io.persist, void 0, type.list("Tr2Light")], 16, "lights"], [[io, io.persist, void 0, type.list("ITr2Controller")], 16, "controllers"], [[io, io.persist, void 0, type.objectRef("EveChildInheritProperties")], 16, "inheritProperties"], [[io, io.persist, type, type.boolean], 16, "useSRT"], [[io, io.persist, type, type.boolean], 16, "useStaticRotation"], [[io, io.persist, type, type.boolean], 16, "useStaticScale"], [[io, io.persist, void 0, type.objectRef("ITr2GrannyAnimationOwner")], 16, "animationOwner"], [[io, io.persist, type, type.int32, void 0, schema.enum("Origin")], 16, "origin"], [[io, io.persist, type, type.boolean], 16, "isPlacementRoot"], [[carbon, carbon.method, impl, impl.adapted], 18, "Initialize"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Registry re-registration on display/displayFilter changes is engine-owned; the mute fan-out side effect is ported.")], 18, "OnModified"], [[carbon, carbon.method, impl, impl.implemented], 18, "Setup"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetName"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetName"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetOrigin"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetAlwaysOn"], [[carbon, carbon.method, impl, impl.implemented], 18, "IsAlwaysOn"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetDisplayQualityModifier"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetMute"], [[carbon, carbon.method, impl, impl.implemented], 18, "MuteChildren"], [[carbon, carbon.method, impl, impl.implemented], 18, "AddTransformModifier"], [[carbon, carbon.method, impl, impl.implemented], 18, "AddObserver"], [[carbon, carbon.method, impl, impl.adapted], 18, "AddController"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetControllerVariable"], [[carbon, carbon.method, impl, impl.implemented], 18, "HandleControllerEvent"], [[carbon, carbon.method, impl, impl.implemented], 18, "StartControllers"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetProceduralContainerVariable"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetEffectChildByName"], [[carbon, carbon.method, impl, impl.adapted], 18, "AddToEffectChildrenList"], [[carbon, carbon.method, impl, impl.implemented], 18, "RemoveFromEffectChildrenList"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetShaderOption"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetAnimationOwner"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetIsPlacementRoot"], [[carbon, carbon.method, impl, impl.implemented], 18, "AddAttachment"], [[carbon, carbon.method, impl, impl.implemented], 18, "ClearAttachments"], [[carbon, carbon.method, impl, impl.implemented], 18, "Empty"], [[carbon, carbon.method, impl, impl.implemented], 18, "UpdateSyncronous"], [[carbon, carbon.method, void 0, carbon.contextual(["camera"]), impl, impl.adapted, void 0, impl.reason("The GPU bone ring buffer, task-group dispatch, per-object VS/PS struct refresh, and the Granny bone-list override are engine/animation seams; the CPU update fan-out is ported.")], 18, "UpdateAsyncronous"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("The animationOwner bone list for attachments awaits the animation seam (bones pass as null); the visibility fan-out is ported.")], 18, "UpdateVisibility"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetRenderables"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetBoundingSphere"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetLocalToWorldTransform"], [[carbon, carbon.method, impl, impl.implemented], 18, "ChangeLOD"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetLights"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetBatches"], [[carbon, carbon.method, impl, impl.implemented], 18, "HasTransparentBatches"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetSortValue"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Persistent VS/PS device buffers and the bone ring upload are engine-owned; the record carries the object reference the engine serializer consumes.")], 18, "GetPerObjectData"], [[carbon, carbon.method, impl, impl.implemented], 18, "HasRenderables"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Carbon reads the Tr2Renderer shader-model global; the browser runtime stamps EveChildContainer.shaderModel (default TR2SM_3_0_DEPTH, the DX11 depth path EVE ships).")], 18, "IsRendering"], [[carbon, carbon.method, impl, impl.implemented], 18, "IsUpdating"], [[carbon, carbon.method, impl, impl.implemented], 18, "PlayCurveSet"], [[carbon, carbon.method, impl, impl.implemented], 18, "StopCurveSet"], [[carbon, carbon.method, impl, impl.implemented], 18, "UpdateCurveSet"], [[carbon, carbon.method, impl, impl.implemented], 18, "PlayAllCurveSets"], [[carbon, carbon.method, impl, impl.implemented], 18, "StopAllCurveSets"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetCurveSetDuration"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetRangeDuration"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("The bool + float& out-param pair collapses to value-or-null in JS.")], 18, "GetControllerValueByName"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetWorldVelocity"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetOwnerMaxSpeed"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetInheritProperties"], [[carbon, carbon.method, impl, impl.implemented], 18, "FindSoundEmitter"]], 0, void 0, _EveChildTransform));
+      })], [[[io, io.notify, io, io.persist, type, type.int32, void 0, schema.enum("DisplayQualityModifier")], 16, "displayFilter"], [[io, io.persist, void 0, type.list("IEveSpaceObjectChild")], 16, "objects"], [[io, io.persist, void 0, type.list("IEveChildTransformModifier")], 16, "transformModifiers"], [[io, io.persist, void 0, type.list("TriCurveSet")], 16, "curveSets"], [[io, io.read, type, type.mat4], 16, "worldTransform"], [[io, io.notify, io, io.readwrite, type, type.boolean], 16, "mute"], [[io, io.notify, io, io.persist, type, type.boolean], 16, "display"], [[io, io.persist, type, type.string], 16, "name"], [[io, io.persist, type, type.vec3], 16, "translation"], [[io, io.persist, type, type.quat], 16, "rotation"], [[io, io.persist, type, type.vec3], 16, "scaling"], [[io, io.persist, type, type.mat4], 16, "localTransform"], [[io, io.persist, type, type.boolean], 16, "staticTransform"], [[io, io.persist, type, type.boolean], 16, "alwaysOn"], [[io, io.persist, type, type.boolean], 16, "updateOnDisplay"], [[io, io.persist, void 0, type.list("IEveSpaceObjectAttachment")], 16, "attachments"], [[io, io.persist, void 0, type.list("TriObserverLocal")], 16, "observers"], [[io, io.persist, void 0, type.list("IEveFxAttribute")], 16, "fxAttributes"], [[io, io.persist, void 0, type.list("Tr2Light")], 16, "lights"], [[io, io.persist, void 0, type.list("ITr2Controller")], 16, "controllers"], [[io, io.persist, void 0, type.objectRef("EveChildInheritProperties")], 16, "inheritProperties"], [[io, io.persist, type, type.boolean], 16, "useSRT"], [[io, io.persist, type, type.boolean], 16, "useStaticRotation"], [[io, io.persist, type, type.boolean], 16, "useStaticScale"], [[io, io.persist, void 0, type.objectRef("ITr2GrannyAnimationOwner")], 16, "animationOwner"], [[io, io.persist, type, type.int32, void 0, schema.enum("Origin")], 16, "origin"], [[io, io.persist, type, type.boolean], 16, "isPlacementRoot"], [[carbon, carbon.method, impl, impl.adapted], 18, "Initialize"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Registry re-registration on display/displayFilter changes is engine-owned; the mute fan-out side effect is ported.")], 18, "OnModified"], [[carbon, carbon.method, impl, impl.implemented], 18, "Setup"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetName"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetName"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetOrigin"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetAlwaysOn"], [[carbon, carbon.method, impl, impl.implemented], 18, "IsAlwaysOn"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetDisplayQualityModifier"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetMute"], [[carbon, carbon.method, impl, impl.implemented], 18, "MuteChildren"], [[carbon, carbon.method, impl, impl.implemented], 18, "AddTransformModifier"], [[carbon, carbon.method, impl, impl.implemented], 18, "AddObserver"], [[carbon, carbon.method, impl, impl.adapted], 18, "AddController"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetControllerVariable"], [[carbon, carbon.method, impl, impl.implemented], 18, "HandleControllerEvent"], [[carbon, carbon.method, impl, impl.implemented], 18, "StartControllers"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetProceduralContainerVariable"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetEffectChildByName"], [[carbon, carbon.method, impl, impl.adapted], 18, "AddToEffectChildrenList"], [[carbon, carbon.method, impl, impl.implemented], 18, "RemoveFromEffectChildrenList"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetShaderOption"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetAnimationOwner"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetIsPlacementRoot"], [[carbon, carbon.method, impl, impl.implemented], 18, "AddAttachment"], [[carbon, carbon.method, impl, impl.implemented], 18, "ClearAttachments"], [[carbon, carbon.method, impl, impl.implemented], 18, "Empty"], [[carbon, carbon.method, impl, impl.implemented], 18, "UpdateSyncronous"], [[carbon, carbon.method, void 0, carbon.contextual(["camera"]), impl, impl.adapted, void 0, impl.reason("The GPU bone ring buffer, task-group dispatch, per-object VS/PS struct refresh, and the Granny bone-list override are engine/animation seams; the CPU update fan-out is ported.")], 18, "UpdateAsyncronous"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("The animationOwner bone list for attachments awaits the animation seam (bones pass as null); the visibility fan-out is ported.")], 18, "UpdateVisibility"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetRenderables"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetBoundingSphere"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetLocalToWorldTransform"], [[carbon, carbon.method, impl, impl.implemented], 18, "ChangeLOD"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetLights"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetBatches"], [[carbon, carbon.method, impl, impl.implemented], 18, "HasTransparentBatches"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetSortValue"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Persistent VS/PS device buffers and the bone ring upload are engine-owned; the record carries the object reference the engine serializer consumes.")], 18, "GetPerObjectData"], [[carbon, carbon.method, impl, impl.implemented], 18, "HasRenderables"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Carbon reads the Tr2Renderer shader-model global; the browser runtime stamps EveChildContainer.shaderModel (default TR2SM_3_0_DEPTH, the DX11 depth path EVE ships).")], 18, "IsRendering"], [[carbon, carbon.method, impl, impl.implemented], 18, "IsUpdating"], [[carbon, carbon.method, impl, impl.implemented], 18, "RegisterComponents"], [[carbon, carbon.method, impl, impl.implemented], 18, "UnRegisterComponents"], [[carbon, carbon.method, impl, impl.implemented], 18, "PlayCurveSet"], [[carbon, carbon.method, impl, impl.implemented], 18, "StopCurveSet"], [[carbon, carbon.method, impl, impl.implemented], 18, "UpdateCurveSet"], [[carbon, carbon.method, impl, impl.implemented], 18, "PlayAllCurveSets"], [[carbon, carbon.method, impl, impl.implemented], 18, "StopAllCurveSets"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetCurveSetDuration"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetRangeDuration"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("The bool + float& out-param pair collapses to value-or-null in JS.")], 18, "GetControllerValueByName"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetWorldVelocity"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetOwnerMaxSpeed"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetInheritProperties"], [[carbon, carbon.method, impl, impl.implemented], 18, "FindSoundEmitter"]], 0, void 0, _EveChildTransform));
     }
     displayFilter = (_initProto(this), _init_displayFilter(this, 5));
     objects = (_init_extra_displayFilter(this), _init_objects(this, []));
@@ -78,9 +79,9 @@ new class extends _identity {
       return true;
     }
 
-    /** Carbon EveChildContainer::OnModified (cpp:76-88): display/displayFilter
-     * changes re-register with the scene component registry (engine-owned,
-     * omitted); a mute change fans out to children and observers. The value
+    /** Carbon EveChildContainer::OnModified (cpp:76-88): display/displayFilter
+     * changes re-register with the scene component registry (engine-owned,
+     * omitted); a mute change fans out to children and observers. The value
      * argument follows the repo's OnModified duck (field name or field value). */
     OnModified(value = null) {
       if (value === "mute" || value === this.mute) {
@@ -218,13 +219,13 @@ new class extends _identity {
       return this.objects.length === 0 && this.lights.length === 0 && this.attachments.length === 0 && this.controllers.length === 0 && this.curveSets.length === 0 && this.transformModifiers.length === 0 && this.observers.length === 0;
     }
 
-    /**
-     * Sync-side frame update (Carbon EveChildContainer::UpdateSyncronous,
-     * cpp:496-518): gate on IsUpdating, remember the owner max speed, then
-     * recurse into the children with childParent params rebased onto this
-     * container's world transform, and refresh the local observers.
-     * @param {Object} updateContext - frame context (EveUpdateContext)
-     * @param {EveChildUpdateParams} params
+    /**
+     * Sync-side frame update (Carbon EveChildContainer::UpdateSyncronous,
+     * cpp:496-518): gate on IsUpdating, remember the owner max speed, then
+     * recurse into the children with childParent params rebased onto this
+     * container's world transform, and refresh the local observers.
+     * @param {Object} updateContext - frame context (EveUpdateContext)
+     * @param {EveChildUpdateParams} params
      */
     UpdateSyncronous(updateContext, params) {
       if (!this.IsUpdating()) {
@@ -243,18 +244,18 @@ new class extends _identity {
       }
     }
 
-    /**
-     * Per-frame async update (Carbon EveChildContainer::UpdateAsyncronous +
-     * DoUpdateAsyncronous, cpp:520-641): rebuild the world transform from the
-     * parent, tick the controllers, fold the transform modifiers, then recurse
-     * into the children with childParent params, update the curve sets and fx
-     * attributes, and refresh light/attachment bone state. Carbon's wrapper
-     * advances the GPU bone ring buffer and may dispatch the body onto the
-     * placement task group (cpp:522-538) - both engine-owned, so the JS port
-     * runs the DoUpdateAsyncronous body inline behind the same IsUpdating gate.
-     * @param {Object} updateContext - frame context (EveUpdateContext), threaded to modifiers
-     * @param {EveChildUpdateParams} params - localToWorldTransform + boneCount/bones
-     * @returns {Float32Array} worldTransform
+    /**
+     * Per-frame async update (Carbon EveChildContainer::UpdateAsyncronous +
+     * DoUpdateAsyncronous, cpp:520-641): rebuild the world transform from the
+     * parent, tick the controllers, fold the transform modifiers, then recurse
+     * into the children with childParent params, update the curve sets and fx
+     * attributes, and refresh light/attachment bone state. Carbon's wrapper
+     * advances the GPU bone ring buffer and may dispatch the body onto the
+     * placement task group (cpp:522-538) - both engine-owned, so the JS port
+     * runs the DoUpdateAsyncronous body inline behind the same IsUpdating gate.
+     * @param {Object} updateContext - frame context (EveUpdateContext), threaded to modifiers
+     * @param {EveChildUpdateParams} params - localToWorldTransform + boneCount/bones
+     * @returns {Float32Array} worldTransform
      */
     UpdateAsyncronous(updateContext, params) {
       if (!this.IsUpdating()) {
@@ -329,15 +330,15 @@ new class extends _identity {
       return this.worldTransform;
     }
 
-    /**
-     * Frame visibility fan-out (Carbon EveChildContainer::UpdateVisibility,
-     * cpp:379-410): gate on display/IsUpdating, recurse into the children with
-     * the unchanged parent transform/LOD, then refresh attachment visibility
-     * against this container's world transform.
-     * @param {Object} updateContext - frame context (frustum ducks)
-     * @param {Float32Array} parentTransform
-     * @param {Number} parentLod - parent Tr2Lod level
-     * @returns {Boolean} whether the fan-out ran
+    /**
+     * Frame visibility fan-out (Carbon EveChildContainer::UpdateVisibility,
+     * cpp:379-410): gate on display/IsUpdating, recurse into the children with
+     * the unchanged parent transform/LOD, then refresh attachment visibility
+     * against this container's world transform.
+     * @param {Object} updateContext - frame context (frustum ducks)
+     * @param {Float32Array} parentTransform
+     * @param {Number} parentLod - parent Tr2Lod level
+     * @returns {Boolean} whether the fan-out ran
      */
     UpdateVisibility(updateContext, parentTransform = null, parentLod = Tr2Lod.TR2_LOD_HIGH) {
       if (!this.display) {
@@ -357,7 +358,7 @@ new class extends _identity {
       return true;
     }
 
-    /** Carbon EveChildContainer::GetRenderables (cpp:412-432): the container
+    /** Carbon EveChildContainer::GetRenderables (cpp:412-432): the container
      * itself renders only when it owns attachments; children always recurse. */
     GetRenderables(out = []) {
       if (!this.display || !this.#hasUpdated) {
@@ -375,10 +376,10 @@ new class extends _identity {
       return out;
     }
 
-    /** Carbon EveChildContainer::GetBoundingSphere (cpp:434-452): the union of
-     * the children's spheres (BoundingSphereSetOrUpdate -> sph3.union). The
-     * child sphere is a per-call local rather than module scratch because
-     * containers nest - a shared scratch would be clobbered between recursion
+    /** Carbon EveChildContainer::GetBoundingSphere (cpp:434-452): the union of
+     * the children's spheres (BoundingSphereSetOrUpdate -> sph3.union). The
+     * child sphere is a per-call local rather than module scratch because
+     * containers nest - a shared scratch would be clobbered between recursion
      * levels; this is a bounds query, not the per-frame update hot path. */
     GetBoundingSphere(out = vec4.create(), _query = 0) {
       if (!this.IsUpdating()) {
@@ -399,7 +400,7 @@ new class extends _identity {
       return success;
     }
 
-    /** Carbon EveChildContainer::GetLocalToWorldTransform (cpp:644-647); the
+    /** Carbon EveChildContainer::GetLocalToWorldTransform (cpp:644-647); the
      * optional out follows the EveChildInstancedMeshes copy-out shape. */
     GetLocalToWorldTransform(out = null) {
       if (out) {
@@ -415,9 +416,9 @@ new class extends _identity {
       }
     }
 
-    /** Carbon EveChildContainer::GetLights (cpp:657-675): each light is added
-     * with the container world transform and the average basis-length scaling
-     * ((|X| + |Y| + |Z|) / 3 of the world basis rows - single-matrix reads, no
+    /** Carbon EveChildContainer::GetLights (cpp:657-675): each light is added
+     * with the container world transform and the average basis-length scaling
+     * ((|X| + |Y| + |Z|) / 3 of the world basis rows - single-matrix reads, no
      * composition). The light manager is duck-typed. */
     GetLights(lightManager) {
       if (!this.display || !this.#hasUpdated) {
@@ -433,9 +434,9 @@ new class extends _identity {
       }
     }
 
-    /** Carbon EveChildContainer::GetBatches (cpp:1134-1143): attachments only,
-     * gated on display, the NORMAL render reason, and a non-zero activation
-     * strength. Returns whether any batch was committed (JS addition; Carbon
+    /** Carbon EveChildContainer::GetBatches (cpp:1134-1143): attachments only,
+     * gated on display, the NORMAL render reason, and a non-zero activation
+     * strength. Returns whether any batch was committed (JS addition; Carbon
      * returns void). */
     GetBatches(batches, batchType, perObjectData, reason = Tr2RenderReason.TR2RENDERREASON_NORMAL) {
       if (!this.display || reason !== Tr2RenderReason.TR2RENDERREASON_NORMAL || this.#activationStrength === 0) {
@@ -458,10 +459,10 @@ new class extends _identity {
       return 0;
     }
 
-    /** Carbon EveChildContainer::GetPerObjectData (cpp:1180-1203) uploads the
-     * animationOwner bone palette into the GPU ring buffer and allocates
-     * Tr2PerObjectDataWithPersistentBuffers; both are GPU seams, so the GPU-free
-     * record carries the live object reference for the engine serializer
+    /** Carbon EveChildContainer::GetPerObjectData (cpp:1180-1203) uploads the
+     * animationOwner bone palette into the GPU ring buffer and allocates
+     * Tr2PerObjectDataWithPersistentBuffers; both are GPU seams, so the GPU-free
+     * record carries the live object reference for the engine serializer
      * (mirrors EveSpaceObject2.GetPerObjectData). */
     GetPerObjectData(accumulator = null) {
       const data = typeof accumulator?.Allocate === "function" ? accumulator.Allocate(Tr2PerObjectData) : new Tr2PerObjectData();
@@ -469,13 +470,13 @@ new class extends _identity {
       return data;
     }
 
-    /** Carbon EveChildContainer::HasRenderables (cpp:1129-1132): the container
+    /** Carbon EveChildContainer::HasRenderables (cpp:1129-1132): the container
      * renders only for its attachments. */
     HasRenderables() {
       return this.attachments.length > 0;
     }
 
-    /** Carbon EveChildContainer::IsRendering (cpp:334-362): whether the current
+    /** Carbon EveChildContainer::IsRendering (cpp:334-362): whether the current
      * shader model passes this container's display filter. */
     IsRendering() {
       const settings = _EveChildContainer.shaderModel;
@@ -507,7 +508,41 @@ new class extends _identity {
       return (this.display || !this.updateOnDisplay) && (this.IsRendering() || this.displayFilter === _EveChildContainer.DisplayQualityModifier.ONLY_REFLECTIONS);
     }
 
-    /** Carbon EveChildContainer::PlayCurveSet (cpp:682-712): named own sets play
+    /** Carbon EveChildContainer::RegisterComponents (cpp:258-284): LightOwner
+     * when lights are authored, then forwards the contained objects and the
+     * attachments. Gate m_display && IsUpdating(). */
+    RegisterComponents() {
+      const registry = this.GetComponentRegistry();
+      if (registry && this.display && this.IsUpdating()) {
+        if (this.lights.length) {
+          registry.RegisterComponent(EveComponentType.LightOwner, this);
+        }
+        for (const object of this.objects) {
+          object?.Register?.(registry);
+        }
+        for (const attachment of this.attachments) {
+          attachment?.Register?.(registry);
+        }
+      }
+    }
+
+    /** Carbon EveChildContainer::UnRegisterComponents (cpp:290-311): forwards
+     * the contained objects and attachments only (own components were already
+     * removed by EveEntity::UnRegister, EveEntity.cpp:90); no display/IsUpdating
+     * re-check. */
+    UnRegisterComponents() {
+      const registry = this.GetComponentRegistry();
+      if (registry) {
+        for (const object of this.objects) {
+          object?.UnRegister?.(registry);
+        }
+        for (const attachment of this.attachments) {
+          attachment?.UnRegister?.(registry);
+        }
+      }
+    }
+
+    /** Carbon EveChildContainer::PlayCurveSet (cpp:682-712): named own sets play
      * (or play a named range); children recurse via the curve-set-owner duck. */
     PlayCurveSet(name, rangeName = "") {
       if (!this.IsUpdating()) {
@@ -546,7 +581,7 @@ new class extends _identity {
       }
     }
 
-    /** Carbon EveChildContainer::UpdateCurveSet (cpp:770-786): samples matching
+    /** Carbon EveChildContainer::UpdateCurveSet (cpp:770-786): samples matching
      * own and child sets at an explicit time (both clocks, as Carbon does). */
     UpdateCurveSet(name, time) {
       const target = String(name ?? "");
@@ -560,7 +595,7 @@ new class extends _identity {
       }
     }
 
-    /** Carbon EveChildContainer::PlayAllCurveSets (cpp:714-728): children
+    /** Carbon EveChildContainer::PlayAllCurveSets (cpp:714-728): children
      * first, then every own set. */
     PlayAllCurveSets() {
       for (const child of this.objects) {
@@ -581,7 +616,7 @@ new class extends _identity {
       }
     }
 
-    /** Carbon EveChildContainer::GetCurveSetDuration (cpp:788-813): maximum
+    /** Carbon EveChildContainer::GetCurveSetDuration (cpp:788-813): maximum
      * GetMaxCurveDuration over matching own and child sets. */
     GetCurveSetDuration(name) {
       if (!this.IsUpdating()) {
@@ -600,7 +635,7 @@ new class extends _identity {
       return duration;
     }
 
-    /** Carbon EveChildContainer::GetRangeDuration (cpp:815-840): maximum named
+    /** Carbon EveChildContainer::GetRangeDuration (cpp:815-840): maximum named
      * range duration over matching own and child sets. */
     GetRangeDuration(name, rangeName) {
       if (!this.IsUpdating()) {
@@ -619,8 +654,8 @@ new class extends _identity {
       return duration;
     }
 
-    /** Carbon EveChildContainer::GetControllerValueByName (cpp:1083-1098):
-     * Carbon returns bool with a float& out; the JS port returns the value or
+    /** Carbon EveChildContainer::GetControllerValueByName (cpp:1083-1098):
+     * Carbon returns bool with a float& out; the JS port returns the value or
      * null when no controller exposes the named float variable. */
     GetControllerValueByName(name) {
       const key = String(name ?? "");
@@ -643,8 +678,8 @@ new class extends _identity {
       return this.#ownerMaxSpeed;
     }
 
-    /** Carbon EveChildContainer::SetInheritProperties (cpp:1017-1040): lazily
-     * creates the property holder, then fans the color set out to children and
+    /** Carbon EveChildContainer::SetInheritProperties (cpp:1017-1040): lazily
+     * creates the property holder, then fans the color set out to children and
      * lights. */
     SetInheritProperties(colorSet) {
       if (!this.inheritProperties) {
@@ -659,7 +694,7 @@ new class extends _identity {
       }
     }
 
-    /** Carbon EveChildContainer::FindSoundEmitter (cpp:1042-1066): named local
+    /** Carbon EveChildContainer::FindSoundEmitter (cpp:1042-1066): named local
      * observers first, then duck-typed recursion into the children. */
     FindSoundEmitter(name) {
       const target = String(name ?? "");