@carbonenginejs/runtime-trinity 0.5.0 → 0.7.0

package/dist/{generated/eve → eve}/socket/EveSocketParameterVector3.js

@@ -1,6 +1,6 @@
-import { applyDecs2311 as _applyDecs2311 } from '../../../_virtual/_rollupPluginBabelHelpers.js';
-import { vec3 } from '@carbonenginejs/core-math/vec3';
-import { io, type, carbon, impl } from '@carbonenginejs/core-types/schema';
+import { applyDecs2311 as _applyDecs2311 } from '../../_virtual/_rollupPluginBabelHelpers.js';
+import { vec3 } from '@carbonenginejs/runtime-utils/vec3';
+import { io, type, carbon, impl } from '@carbonenginejs/runtime-utils/schema';
 import { EveSocketParameterBindingBase as _EveSocketParameterBi } from './EveSocketParameterBindingBase.js';
 
 let _initProto, _initClass, _init_value, _init_extra_value;
@@ -22,6 +22,11 @@ class EveSocketParameterVector3 extends _EveSocketParameterBi {
 
   /** m_defaults - one default captured per bound external parameter. */
   #defaults = (_init_extra_value(this), []);
+
+  /**
+   * Discards the captured defaults along with the bindings, so nothing can be
+   * restored afterwards.
+   */
   ClearBindings() {
     this.#defaults.length = 0;
     super.ClearBindings();
@@ -35,6 +40,12 @@ class EveSocketParameterVector3 extends _EveSocketParameterBi {
     }
     this.ClearBindings();
   }
+
+  /**
+   * Captures a copy of the external parameter's current value as a default,
+   * keeping it at zero unless the source has at least three components; always
+   * succeeds, so a bind is never refused on its account.
+   */
   ExtractDefault(externalParameter) {
     const value = vec3.create();
     try {
@@ -48,6 +59,11 @@ class EveSocketParameterVector3 extends _EveSocketParameterBi {
     this.#defaults.push(value);
     return true;
   }
+
+  /**
+   * Restores the first captured default into the existing value vector, or
+   * zeroes it when nothing was captured.
+   */
   SetValueToDefault() {
     if (this.#defaults.length) {
       vec3.copy(this.value, this.#defaults[0]);

package/dist/eve/socket/EveSocketParameterVector3.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EveSocketParameterVector3.js","sources":["../../../../src/eve/socket/EveSocketParameterVector3.js"],"sourcesContent":["// Ported from CarbonEngine (MIT, (c) 2026 CCP Games) - https://github.com/carbonengine/trinity\r\n//   trinity/trinity/Eve/SpaceObject/Children/SocketParameters/EveSocketParameter.h\r\n// Hand-authored following the eve/socket generated pattern (SOCKET_PARAM_DECLARE macro family).\r\nimport { vec3 } from \"@carbonenginejs/runtime-utils/vec3\";\r\nimport { carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\r\nimport { EveSocketParameterBindingBase } from \"./EveSocketParameterBindingBase.js\";\r\n\r\n/** EveSocketParameterVector3 (eve/socket) - SOCKET_PARAMETER_DEFINE(Vector3, (0, 0, 0)). */\r\n@type.define({ className: \"EveSocketParameterVector3\", family: \"eve/socket\" })\r\nexport class EveSocketParameterVector3 extends EveSocketParameterBindingBase\r\n{\r\n\r\n  /** m_value (Vector3) */\r\n  @io.persist\r\n  @type.vec3\r\n  value = vec3.create();\r\n\r\n  /** m_defaults - one default captured per bound external parameter. */\r\n  #defaults = [];\r\n\r\n  /**\r\n   * Discards the captured defaults along with the bindings, so nothing can be\r\n   * restored afterwards.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  ClearBindings()\r\n  {\r\n    this.#defaults.length = 0;\r\n    super.ClearBindings();\r\n  }\r\n\r\n  /** Restores every binding's default and copies it out, then clears. */\r\n  @carbon.method\r\n  @impl.implemented\r\n  Reset()\r\n  {\r\n    for (let index = 0; index < this.bindings.length; index++)\r\n    {\r\n      vec3.copy(this.value, this.#defaults[index]);\r\n      this.bindings[index]?.CopyValue?.();\r\n    }\r\n    this.ClearBindings();\r\n  }\r\n\r\n  /**\r\n   * Captures a copy of the external parameter's current value as a default,\r\n   * keeping it at zero unless the source has at least three components; always\r\n   * succeeds, so a bind is never refused on its account.\r\n   */\r\n  ExtractDefault(externalParameter)\r\n  {\r\n    const value = vec3.create();\r\n    try\r\n    {\r\n      const source = externalParameter.GetValue();\r\n      if (source && typeof source.length === \"number\" && source.length >= 3)\r\n      {\r\n        vec3.copy(value, source);\r\n      }\r\n    }\r\n    catch\r\n    {\r\n      vec3.set(value, 0, 0, 0);\r\n    }\r\n    this.#defaults.push(value);\r\n    return true;\r\n  }\r\n\r\n  /**\r\n   * Restores the first captured default into the existing value vector, or\r\n   * zeroes it when nothing was captured.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  SetValueToDefault()\r\n  {\r\n    if (this.#defaults.length)\r\n    {\r\n      vec3.copy(this.value, this.#defaults[0]);\r\n    }\r\n    else\r\n    {\r\n      vec3.set(this.value, 0, 0, 0);\r\n    }\r\n  }\r\n\r\n}\r\n"],"names":["_EveSocketParameterVe","EveSocketParameterVector3","EveSocketParameterBindingBase","e","_init_value","_init_extra_value","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persist","vec3","carbon","method","impl","implemented","value","create","ClearBindings","length","Reset","index","bindings","copy","CopyValue","ExtractDefault","externalParameter","source","GetValue","set","push","SetValueToDefault"],"mappings":"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"}

package/dist/{generated/eve → eve}/socket/EveSocketParameterVector4.js

@@ -1,6 +1,6 @@
-import { applyDecs2311 as _applyDecs2311 } from '../../../_virtual/_rollupPluginBabelHelpers.js';
-import { vec4 } from '@carbonenginejs/core-math/vec4';
-import { io, type, carbon, impl } from '@carbonenginejs/core-types/schema';
+import { applyDecs2311 as _applyDecs2311 } from '../../_virtual/_rollupPluginBabelHelpers.js';
+import { vec4 } from '@carbonenginejs/runtime-utils/vec4';
+import { io, type, carbon, impl } from '@carbonenginejs/runtime-utils/schema';
 import { EveSocketParameterBindingBase as _EveSocketParameterBi } from './EveSocketParameterBindingBase.js';
 
 let _initProto, _initClass, _init_value, _init_extra_value;
@@ -22,6 +22,11 @@ class EveSocketParameterVector4 extends _EveSocketParameterBi {
 
   /** m_defaults - one default captured per bound external parameter. */
   #defaults = (_init_extra_value(this), []);
+
+  /**
+   * Discards the captured defaults along with the bindings, so nothing can be
+   * restored afterwards.
+   */
   ClearBindings() {
     this.#defaults.length = 0;
     super.ClearBindings();
@@ -35,6 +40,12 @@ class EveSocketParameterVector4 extends _EveSocketParameterBi {
     }
     this.ClearBindings();
   }
+
+  /**
+   * Captures a copy of the external parameter's current value as a default,
+   * keeping it at zero unless the source has at least four components; always
+   * succeeds, so a bind is never refused on its account.
+   */
   ExtractDefault(externalParameter) {
     const value = vec4.create();
     try {
@@ -48,6 +59,11 @@ class EveSocketParameterVector4 extends _EveSocketParameterBi {
     this.#defaults.push(value);
     return true;
   }
+
+  /**
+   * Restores the first captured default into the existing value vector, or
+   * zeroes it when nothing was captured.
+   */
   SetValueToDefault() {
     if (this.#defaults.length) {
       vec4.copy(this.value, this.#defaults[0]);

package/dist/eve/socket/EveSocketParameterVector4.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EveSocketParameterVector4.js","sources":["../../../../src/eve/socket/EveSocketParameterVector4.js"],"sourcesContent":["// Ported from CarbonEngine (MIT, (c) 2026 CCP Games) - https://github.com/carbonengine/trinity\r\n//   trinity/trinity/Eve/SpaceObject/Children/SocketParameters/EveSocketParameter.h\r\n// Hand-authored following the eve/socket generated pattern (SOCKET_PARAM_DECLARE macro family).\r\nimport { vec4 } from \"@carbonenginejs/runtime-utils/vec4\";\r\nimport { carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\r\nimport { EveSocketParameterBindingBase } from \"./EveSocketParameterBindingBase.js\";\r\n\r\n/** EveSocketParameterVector4 (eve/socket) - SOCKET_PARAMETER_DEFINE(Vector4, (0, 0, 0, 0)). */\r\n@type.define({ className: \"EveSocketParameterVector4\", family: \"eve/socket\" })\r\nexport class EveSocketParameterVector4 extends EveSocketParameterBindingBase\r\n{\r\n\r\n  /** m_value (Vector4) */\r\n  @io.persist\r\n  @type.vec4\r\n  value = vec4.create();\r\n\r\n  /** m_defaults - one default captured per bound external parameter. */\r\n  #defaults = [];\r\n\r\n  /**\r\n   * Discards the captured defaults along with the bindings, so nothing can be\r\n   * restored afterwards.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  ClearBindings()\r\n  {\r\n    this.#defaults.length = 0;\r\n    super.ClearBindings();\r\n  }\r\n\r\n  /** Restores every binding's default and copies it out, then clears. */\r\n  @carbon.method\r\n  @impl.implemented\r\n  Reset()\r\n  {\r\n    for (let index = 0; index < this.bindings.length; index++)\r\n    {\r\n      vec4.copy(this.value, this.#defaults[index]);\r\n      this.bindings[index]?.CopyValue?.();\r\n    }\r\n    this.ClearBindings();\r\n  }\r\n\r\n  /**\r\n   * Captures a copy of the external parameter's current value as a default,\r\n   * keeping it at zero unless the source has at least four components; always\r\n   * succeeds, so a bind is never refused on its account.\r\n   */\r\n  ExtractDefault(externalParameter)\r\n  {\r\n    const value = vec4.create();\r\n    try\r\n    {\r\n      const source = externalParameter.GetValue();\r\n      if (source && typeof source.length === \"number\" && source.length >= 4)\r\n      {\r\n        vec4.copy(value, source);\r\n      }\r\n    }\r\n    catch\r\n    {\r\n      vec4.set(value, 0, 0, 0, 0);\r\n    }\r\n    this.#defaults.push(value);\r\n    return true;\r\n  }\r\n\r\n  /**\r\n   * Restores the first captured default into the existing value vector, or\r\n   * zeroes it when nothing was captured.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  SetValueToDefault()\r\n  {\r\n    if (this.#defaults.length)\r\n    {\r\n      vec4.copy(this.value, this.#defaults[0]);\r\n    }\r\n    else\r\n    {\r\n      vec4.set(this.value, 0, 0, 0, 0);\r\n    }\r\n  }\r\n\r\n}\r\n"],"names":["_EveSocketParameterVe","EveSocketParameterVector4","EveSocketParameterBindingBase","e","_init_value","_init_extra_value","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persist","vec4","carbon","method","impl","implemented","value","create","ClearBindings","length","Reset","index","bindings","copy","CopyValue","ExtractDefault","externalParameter","source","GetValue","set","push","SetValueToDefault"],"mappings":"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"}

package/dist/eve/spaceObject/EveEffectRoot2.js

@@ -1,18 +1,23 @@
 import { identity as _identity, applyDecs2311 as _applyDecs2311 } from '../../_virtual/_rollupPluginBabelHelpers.js';
-import { mat4 } from '@carbonenginejs/core-math/mat4';
-import { quat } from '@carbonenginejs/core-math/quat';
-import { sph3 } from '@carbonenginejs/core-math/sph3';
-import { vec3 } from '@carbonenginejs/core-math/vec3';
-import { vec4 } from '@carbonenginejs/core-math/vec4';
-import { io, type, impl, carbon, schema } from '@carbonenginejs/core-types/schema';
-import { EveEntity as _EveEntity } from '../../generated/eve/EveEntity.js';
+import { mat4 } from '@carbonenginejs/runtime-utils/mat4';
+import { quat } from '@carbonenginejs/runtime-utils/quat';
+import { sph3 } from '@carbonenginejs/runtime-utils/sph3';
+import { vec3 } from '@carbonenginejs/runtime-utils/vec3';
+import { vec4 } from '@carbonenginejs/runtime-utils/vec4';
+import { io, type, impl, carbon, schema } from '@carbonenginejs/runtime-utils/schema';
+import { EveEntity as _EveEntity } from '../EveEntity.js';
 import { EveChildUpdateParams as _EveChildUpdateParams } from '../EveChildUpdateParams.js';
-import { Tr2Lod } from '../EveLODHelper.js';
-import { EveSpaceObjectPSData as _EveSpaceObjectPSData } from '../EveSpaceObjectPSData.js';
-import { EveSpaceObjectVSData as _EveSpaceObjectVSData } from '../EveSpaceObjectVSData.js';
+import { Tr2Lod } from '@carbonenginejs/runtime-utils/const/trinity';
+import { RawData } from '../../trinityCore/rawData/RawData.js';
 import { EveComponentType } from '../EveComponentTypes.js';
 
 let _initProto, _initClass, _init_effectChildren, _init_extra_effectChildren, _init_estimatedSize, _init_extra_estimatedSize, _init_lodLevel, _init_extra_lodLevel, _init_mute, _init_extra_mute, _init_display, _init_extra_display, _init_name, _init_extra_name, _init_dynamicLOD, _init_extra_dynamicLOD, _init_scaling, _init_extra_scaling, _init_rotation, _init_extra_rotation, _init_translation, _init_extra_translation, _init_duration, _init_extra_duration, _init_secondaryLightingEmissiveColor, _init_extra_secondaryLightingEmissiveColor, _init_curveSets, _init_extra_curveSets, _init_lights, _init_extra_lights, _init_externalParameters, _init_extra_externalParameters, _init_controllers, _init_extra_controllers, _init_observers, _init_extra_observers, _init_rotationCurve, _init_extra_rotationCurve, _init_secondaryLightingSphereRadius, _init_extra_secondaryLightingSphereRadius, _init_boundingSphereCenter, _init_extra_boundingSphereCenter, _init_boundingSphereRadius, _init_extra_boundingSphereRadius, _init_modelTranslationCurve, _init_extra_modelTranslationCurve, _init_modelRotationCurve, _init_extra_modelRotationCurve, _init_translationCurve, _init_extra_translationCurve;
+
+/**
+ * A standalone effect root: curve-driven placement plus the effect children,
+ * lights, controllers, curve sets and observers that make up an effect not
+ * attached to a hull.
+ */
 let _EveEffectRoot;
 new class extends _identity {
   static [class EveEffectRoot2 extends _EveEntity {
@@ -23,7 +28,7 @@ new class extends _identity {
       } = _applyDecs2311(this, [type.define({
         className: "EveEffectRoot2",
         family: "eve/spaceObject"
-      })], [[[io, io.persist, void 0, type.list("IEveSpaceObjectChild")], 16, "effectChildren"], [[io, io.read, type, type.float32], 16, "estimatedSize"], [[io, io.read, type, type.int32, void 0, schema.enum("Tr2Lod")], 16, "lodLevel"], [[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.boolean], 16, "dynamicLOD"], [[io, io.persist, type, type.vec3], 16, "scaling"], [[io, io.persist, type, type.quat], 16, "rotation"], [[io, io.persist, type, type.vec3], 16, "translation"], [[io, io.persist, type, type.float32], 16, "duration"], [[io, io.persist, type, type.color], 16, "secondaryLightingEmissiveColor"], [[io, io.persist, void 0, type.list("TriCurveSet")], 16, "curveSets"], [[io, io.persist, void 0, type.list("Tr2Light")], 16, "lights"], [[io, io.persist, void 0, type.list("Tr2ExternalParameter")], 16, "externalParameters"], [[io, io.persist, void 0, type.list("ITr2Controller")], 16, "controllers"], [[io, io.persist, void 0, type.list("TriObserverLocal")], 16, "observers"], [[io, io.persist, void 0, type.model("ITriQuaternionFunction")], 16, "rotationCurve"], [[io, io.persist, type, type.float32], 16, "secondaryLightingSphereRadius"], [[impl, impl.adapted, void 0, impl.reason("The schema scanner omits MAPFLOATARRAYSIZE; Carbon exposes the three persisted center components separately from radius."), io, io.persist, type, type.vec3], 16, "boundingSphereCenter"], [[io, io.persist, type, type.float32], 16, "boundingSphereRadius"], [[io, io.persist, void 0, type.model("ITriVectorFunction")], 16, "modelTranslationCurve"], [[io, io.persist, void 0, type.model("ITriQuaternionFunction")], 16, "modelRotationCurve"], [[io, io.persist, void 0, type.model("ITriVectorFunction")], 16, "translationCurve"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Blue root locking is represented by the hydrated JavaScript object identity.")], 18, "Initialize"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Plain JavaScript arrays have no Blue IList notifications, so insertion behavior is explicit.")], 18, "AddController"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Plain JavaScript arrays have no Blue IList notifications, so removal behavior is explicit.")], 18, "RemoveController"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Carbon task and lock ownership is omitted; child update parameters retain the source graph contract.")], 18, "UpdateSyncronous"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Controller and child work is forwarded synchronously through the GPU-free graph instead of Carbon task groups.")], 18, "UpdateAsyncronous"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Frustum and threshold state is supplied by the explicit update context rather than renderer globals.")], 18, "UpdateVisibility"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetRenderables"], [[carbon, carbon.method, impl, impl.implemented], 18, "UpdateControllers"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetBoundingSphere"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetBoundingSphereRadius"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Curve outputs use CarbonEngineJS's time-first, output-second convention.")], 18, "UpdateWorldTransform"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("CarbonEngineJS uses an out-last signature for output parameters.")], 18, "UpdateModelCenterWorldPosition"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("CarbonEngineJS uses an out-last signature for output parameters.")], 18, "GetModelCenterWorldPosition"], [[carbon, carbon.method, impl, impl.noop], 18, "GetLocalBoundingBox"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("CarbonEngineJS returns the caller-owned output matrix.")], 18, "GetLocalToWorldTransform"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("The quad renderer is an injected engine-owned capability.")], 18, "RegisterWithQuadRenderer"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("The quad renderer is an injected engine-owned capability.")], 18, "AddQuadsToQuadRenderer"], [[carbon, carbon.method, impl, impl.implemented], 18, "RegisterComponents"], [[carbon, carbon.method, impl, impl.implemented], 18, "UnRegisterComponents"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("The light manager is an injected engine-owned capability.")], 18, "GetLights"], [[carbon, carbon.method, impl, impl.implemented], 18, "AddLight"], [[carbon, carbon.method, impl, impl.implemented], 18, "ClearLights"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Native constant-buffer structs are represented by GPU-free value records.")], 18, "GetPerObjectStructs"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("The SH lighting manager is injected; Trinity owns only the authored source values.")], 18, "RegisterSecondaryLightSource"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("The SH lighting manager is injected; Trinity owns only the authored source values.")], 18, "UnregisterSecondaryLightSource"], [[carbon, carbon.method, impl, impl.implemented], 18, "Start"], [[carbon, carbon.method, impl, impl.implemented], 18, "Stop"], [[carbon, carbon.method, impl, impl.noop], 18, "GetDamageLocatorCount"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("CarbonEngineJS uses output parameters last and returns the targetable validity flag.")], 18, "GetDamageLocatorPosition"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("CarbonEngineJS uses output parameters last and returns the targetable validity flag.")], 18, "GetDamageLocatorDirection"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("CarbonEngineJS uses an out-last signature for output parameters.")], 18, "GetImpactPosition"], [[carbon, carbon.method, impl, impl.noop], 18, "HasImpactConfigurationShield"], [[carbon, carbon.method, impl, impl.noop], 18, "GetClosestDamageLocatorIndex"], [[carbon, carbon.method, impl, impl.noop], 18, "GetGoodDamageLocatorIndex"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetRadius"], [[carbon, carbon.method, impl, impl.noop], 18, "CreateImpact"], [[carbon, carbon.method, impl, impl.noop], 18, "UpdateImpact"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("CarbonEngineJS returns the caller-owned output vector.")], 18, "GetWorldPosition"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("CarbonEngineJS returns the caller-owned output quaternion.")], 18, "GetWorldRotation"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetMissPosition"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetChildren"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetTransform"], [[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, "GetCurveSetDuration"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetRangeDuration"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("The debug renderer/options collection is an injected engine-owned capability.")], 18, "GetDebugOptions"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("The debug renderer is an injected engine-owned capability.")], 18, "RenderDebugInfo"], [[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, "GetEffectChildByName"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Plain JavaScript arrays have no Blue IList notifications, so insertion behavior is explicit.")], 18, "AddToEffectChildrenList"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Plain JavaScript arrays have no Blue IList notifications, so removal behavior is explicit.")], 18, "RemoveFromEffectChildrenList"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetShaderOption"], [[carbon, carbon.method, impl, impl.implemented], 18, "FindSoundEmitter"], [[carbon, carbon.method, impl, impl.implemented], 18, "AddObserver"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("The explicit setter replaces Carbon's Blue field-notify callback.")], 18, "SetMute"], [[carbon, carbon.method, impl, impl.implemented], 18, "FreezeHighDetailMesh"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetProceduralContainerVariable"]], 0, void 0, _EveEntity));
+      })], [[[io, io.persist, void 0, type.list("IEveSpaceObjectChild")], 16, "effectChildren"], [[io, io.read, type, type.float32], 16, "estimatedSize"], [[io, io.read, type, type.int32, void 0, schema.enum("Tr2Lod")], 16, "lodLevel"], [[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.boolean], 16, "dynamicLOD"], [[io, io.persist, type, type.vec3], 16, "scaling"], [[io, io.persist, type, type.quat], 16, "rotation"], [[io, io.persist, type, type.vec3], 16, "translation"], [[io, io.persist, type, type.float32], 16, "duration"], [[io, io.persist, type, type.color], 16, "secondaryLightingEmissiveColor"], [[io, io.persist, void 0, type.list("TriCurveSet")], 16, "curveSets"], [[io, io.persist, void 0, type.list("Tr2Light")], 16, "lights"], [[io, io.persist, void 0, type.list("Tr2ExternalParameter")], 16, "externalParameters"], [[io, io.persist, void 0, type.list("ITr2Controller")], 16, "controllers"], [[io, io.persist, void 0, type.list("TriObserverLocal")], 16, "observers"], [[io, io.persist, void 0, type.model("ITriQuaternionFunction")], 16, "rotationCurve"], [[io, io.persist, type, type.float32], 16, "secondaryLightingSphereRadius"], [[impl, impl.adapted, void 0, impl.reason("The schema scanner omits MAPFLOATARRAYSIZE; Carbon exposes the three persisted center components separately from radius."), io, io.persist, type, type.vec3], 16, "boundingSphereCenter"], [[io, io.persist, type, type.float32], 16, "boundingSphereRadius"], [[io, io.persist, void 0, type.model("ITriVectorFunction")], 16, "modelTranslationCurve"], [[io, io.persist, void 0, type.model("ITriQuaternionFunction")], 16, "modelRotationCurve"], [[io, io.persist, void 0, type.model("ITriVectorFunction")], 16, "translationCurve"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Blue root locking is represented by the hydrated JavaScript object identity.")], 18, "Initialize"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Plain JavaScript arrays have no Blue IList notifications, so insertion behavior is explicit.")], 18, "AddController"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Plain JavaScript arrays have no Blue IList notifications, so removal behavior is explicit.")], 18, "RemoveController"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Carbon task and lock ownership is omitted; child update parameters retain the source graph contract.")], 18, "UpdateSyncronous"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Controller and child work is forwarded synchronously through the GPU-free graph instead of Carbon task groups.")], 18, "UpdateAsyncronous"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Frustum and threshold state is supplied by the explicit update context rather than renderer globals.")], 18, "UpdateVisibility"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetRenderables"], [[carbon, carbon.method, impl, impl.implemented], 18, "UpdateControllers"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetBoundingSphere"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetBoundingSphereRadius"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Curve outputs use CarbonEngineJS's time-first, output-second convention.")], 18, "UpdateWorldTransform"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("CarbonEngineJS uses an out-last signature for output parameters.")], 18, "UpdateModelCenterWorldPosition"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("CarbonEngineJS uses an out-last signature for output parameters.")], 18, "GetModelCenterWorldPosition"], [[carbon, carbon.method, impl, impl.noop], 18, "GetLocalBoundingBox"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("CarbonEngineJS returns the caller-owned output matrix.")], 18, "GetLocalToWorldTransform"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Carbon's protected member access becomes a copying accessor; JS has no protected fields and the live buffer stays private.")], 18, "GetWorldTransform"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("The quad renderer is an injected engine-owned capability.")], 18, "RegisterWithQuadRenderer"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("The quad renderer is an injected engine-owned capability.")], 18, "AddQuadsToQuadRenderer"], [[carbon, carbon.method, impl, impl.implemented], 18, "RegisterComponents"], [[carbon, carbon.method, impl, impl.implemented], 18, "UnRegisterComponents"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("The light manager is an injected engine-owned capability.")], 18, "GetLights"], [[carbon, carbon.method, impl, impl.implemented], 18, "AddLight"], [[carbon, carbon.method, impl, impl.implemented], 18, "ClearLights"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetPerObjectStructs"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("The SH lighting manager is injected; Trinity owns only the authored source values.")], 18, "RegisterSecondaryLightSource"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("The SH lighting manager is injected; Trinity owns only the authored source values.")], 18, "UnregisterSecondaryLightSource"], [[carbon, carbon.method, impl, impl.implemented], 18, "Start"], [[carbon, carbon.method, impl, impl.implemented], 18, "Stop"], [[carbon, carbon.method, impl, impl.noop], 18, "GetDamageLocatorCount"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("CarbonEngineJS uses output parameters last and returns the targetable validity flag.")], 18, "GetDamageLocatorPosition"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("CarbonEngineJS uses output parameters last and returns the targetable validity flag.")], 18, "GetDamageLocatorDirection"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("CarbonEngineJS uses an out-last signature for output parameters.")], 18, "GetImpactPosition"], [[carbon, carbon.method, impl, impl.noop], 18, "HasImpactConfigurationShield"], [[carbon, carbon.method, impl, impl.noop], 18, "GetClosestDamageLocatorIndex"], [[carbon, carbon.method, impl, impl.noop], 18, "GetGoodDamageLocatorIndex"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetRadius"], [[carbon, carbon.method, impl, impl.noop], 18, "CreateImpact"], [[carbon, carbon.method, impl, impl.noop], 18, "UpdateImpact"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("CarbonEngineJS returns the caller-owned output vector.")], 18, "GetWorldPosition"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("CarbonEngineJS returns the caller-owned output quaternion.")], 18, "GetWorldRotation"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetMissPosition"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetChildren"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetTransform"], [[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, "GetCurveSetDuration"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetRangeDuration"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("The debug renderer/options collection is an injected engine-owned capability.")], 18, "GetDebugOptions"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("The debug renderer is an injected engine-owned capability.")], 18, "RenderDebugInfo"], [[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, "GetEffectChildByName"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Plain JavaScript arrays have no Blue IList notifications, so insertion behavior is explicit.")], 18, "AddToEffectChildrenList"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Plain JavaScript arrays have no Blue IList notifications, so removal behavior is explicit.")], 18, "RemoveFromEffectChildrenList"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetShaderOption"], [[carbon, carbon.method, impl, impl.implemented], 18, "FindSoundEmitter"], [[carbon, carbon.method, impl, impl.implemented], 18, "AddObserver"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("The explicit setter replaces Carbon's Blue field-notify callback.")], 18, "SetMute"], [[carbon, carbon.method, impl, impl.implemented], 18, "FreezeHighDetailMesh"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetProceduralContainerVariable"]], 0, void 0, _EveEntity));
     }
     /** m_effectChildren (PIEveSpaceObjectChildVector) [READ, PERSIST] */
     effectChildren = (_initProto(this), _init_effectChildren(this, []));
@@ -261,6 +266,15 @@ new class extends _identity {
       return mat4.copy(out, this.#lastUpdateMatrix);
     }
 
+    /** Protected-equivalent read of Carbon's m_worldTransform
+     * (EveEffectRoot2.h:219, protected) - the detached root transform
+     * UpdateWorldTransform evaluates, WITHOUT the local SRT composition that
+     * GetLocalToWorldTransform's #lastUpdateMatrix carries. EvePlanet reads the
+     * member directly for the z-only depth-prepass drive (EvePlanet.cpp:137). */
+    GetWorldTransform(out = mat4.create()) {
+      return mat4.copy(out, this.#worldTransform);
+    }
+
     /** Registers every child with an injected quad renderer. */
     RegisterWithQuadRenderer(quadRenderer) {
       for (const child of this.effectChildren) child?.RegisterWithQuadRenderer?.(quadRenderer);
@@ -272,7 +286,7 @@ new class extends _identity {
       for (const child of this.effectChildren) child?.AddQuadsToQuadRenderer?.(frustum, quadRenderer);
     }
 
-    /** Carbon EveEffectRoot2::RegisterComponents (cpp:496-513): LightOwner when
+    /** Carbon EveEffectRoot2::RegisterComponents (cpp:496-513): LightOwner when
      * lights are authored, then forwards the effect children. Gate m_display. */
     RegisterComponents() {
       const registry = this.GetComponentRegistry();
@@ -286,8 +300,8 @@ new class extends _identity {
       }
     }
 
-    /** Carbon EveEffectRoot2::UnRegisterComponents (cpp:515-528): forwards the
-     * effect children only (own components were already removed by
+    /** Carbon EveEffectRoot2::UnRegisterComponents (cpp:515-528): forwards the
+     * effect children only (own components were already removed by
      * EveEntity::UnRegister, EveEntity.cpp:90); no display re-check. */
     UnRegisterComponents() {
       const registry = this.GetComponentRegistry();
@@ -317,17 +331,21 @@ new class extends _identity {
       this.lights.length = 0;
     }
 
-    /** Initializes the portable child-facing space-object records. */
-    GetPerObjectStructs(vsData = new _EveSpaceObjectVSData(), psData = new _EveSpaceObjectPSData()) {
-      _EveEffectRoot.#ZeroNumericRecord(vsData);
-      _EveEffectRoot.#ZeroNumericRecord(psData);
-      vsData.shipData[1] = 1;
-      vsData.shipData[3] = 1;
-      psData.shipData[1] = 1;
-      psData.shipData[3] = 1;
+    /**
+     * Carbon EveEffectRoot2::GetPerObjectStructs (cpp:463-478): zeroes both
+     * records, then sets activation strength and bounding-sphere radius to 1. An
+     * effect root carries no hull values of its own, so a child parented to one
+     * inherits neutral data rather than nothing.
+     * @returns {{vs: RawData, ps: RawData}}
+     */
+    GetPerObjectStructs(vsData = RawData.create("EveSpaceObjectVSData"), psData = RawData.create("EveSpaceObjectPSData")) {
+      vsData.Zero();
+      psData.Zero();
+      vsData.Set("shipData", _EveEffectRoot.#neutralShipData);
+      psData.Set("shipData", _EveEffectRoot.#neutralShipData);
       return {
-        vsData,
-        psData
+        vs: vsData,
+        ps: psData
       };
     }
 
@@ -622,6 +640,12 @@ new class extends _identity {
     SetProceduralContainerVariable(name, value) {
       for (const child of this.effectChildren) child?.SetProceduralContainerVariable?.(name, value);
     }
+
+    /**
+     * Builds the per-frame child update parameters naming this root as the
+     * space-object parent, carrying its display state and a copy of the current
+     * root matrix.
+     */
     #CreateChildUpdateParams() {
       const params = new _EveChildUpdateParams();
       params.spaceObjectParent = this;
@@ -629,6 +653,26 @@ new class extends _identity {
       mat4.copy(params.localToWorldTransform, this.#lastUpdateMatrix);
       return params;
     }
+
+    /**
+     * Replays every stored controller variable onto a newly added controller or
+     * effect child through the named setter, so late additions start with the same
+     * state.
+     */
+
+    /**
+     * Reads a numeric value from the update context, preferring a getter method
+     * and falling back to the named properties, and yields 0 when nothing supplies
+     * it.
+     */
+
+    /**
+     * Samples a curve into out through whichever of Update or GetValueAt it
+     * exposes, writing the fallback when there is no curve and copying back curves
+     * that return a new array instead of filling out.
+     */
+
+    /** Carbon's neutral hull data: full activation, unit bounding radius. */
   }];
   #ApplyControllerVariables(target, variables, methodName) {
     const setter = target?.[methodName];
@@ -657,15 +701,7 @@ new class extends _identity {
     }
     return out;
   }
-  #ZeroNumericRecord(record) {
-    for (const [name, value] of Object.entries(record)) {
-      if (typeof value === "number") record[name] = 0;else if (ArrayBuffer.isView(value)) value.fill(0);else if (Array.isArray(value)) {
-        for (let index = 0; index < value.length; index++) {
-          if (typeof value[index] === "number") value[index] = 0;else if (ArrayBuffer.isView(value[index])) value[index].fill(0);
-        }
-      }
-    }
-  }
+  #neutralShipData = Object.freeze([0, 1, 0, 1]);
   #identity = mat4.create();
   #centerTransform = mat4.create();
   #localSphere = vec4.create();