@carbonenginejs/runtime-trinity 0.6.0 → 0.7.0

package/dist/{generated/eve → eve}/spaceObject/swarm/EveSwarmRenderable.js

@@ -1,17 +1,15 @@
-import { applyDecs2311 as _applyDecs2311 } from '../../../../_virtual/_rollupPluginBabelHelpers.js';
+import { applyDecs2311 as _applyDecs2311 } from '../../../_virtual/_rollupPluginBabelHelpers.js';
 import { type, impl } from '@carbonenginejs/runtime-utils/schema';
 import { EveEntity as _EveEntity } from '../../EveEntity.js';
-import { EveComponentType } from '../../../../eve/EveComponentTypes.js';
+import { EveComponentType } from '../../EveComponentTypes.js';
 import { mat4 } from '@carbonenginejs/runtime-utils/mat4';
-import { vec3 } from '@carbonenginejs/runtime-utils/vec3';
+import '@carbonenginejs/runtime-utils/vec3';
 import { vec4 } from '@carbonenginejs/runtime-utils/vec4';
 import { TriBatchType } from '@carbonenginejs/runtime-utils/graphics';
-import { EveSpaceObjectPSData as _EveSpaceObjectPSData } from '../../../../eve/EveSpaceObjectPSData.js';
-import { EveSpaceObjectVSData as _EveSpaceObjectVSData } from '../../../../eve/EveSpaceObjectVSData.js';
-import { Tr2PerObjectData } from '../../../../trinityCore/Tr2PerObjectData.js';
-import { Tr2RenderReason } from '../../../trinityCore/enums.js';
+import { createChildPerObjectRecords, stampChildTransforms } from '../../perObjectData/childPerObjectRecords.js';
+import { Tr2RenderReason } from '../../../generated/trinityCore/enums.js';
 
-let _initProto, _initClass, _init_mesh, _init_extra_mesh, _init_owner, _init_extra_owner, _init_worldTransform, _init_extra_worldTransform, _init_decals, _init_extra_decals, _init_perObjectDataVs, _init_extra_perObjectDataVs, _init_perObjectDataPs, _init_extra_perObjectDataPs, _init_psData, _init_extra_psData, _init_vsData, _init_extra_vsData;
+let _initProto, _initClass, _init_mesh, _init_extra_mesh, _init_owner, _init_extra_owner, _init_worldTransform, _init_extra_worldTransform, _init_decals, _init_extra_decals, _init_perObjectDataVs, _init_extra_perObjectDataVs, _init_perObjectDataPs, _init_extra_perObjectDataPs;
 
 // Packed (x, y, z, radius) cull-sphere scratch for IsCastingShadow.
 const SPHERE_SCRATCH = vec4.create();
@@ -21,16 +19,12 @@ let _EveSwarmRenderable;
 class EveSwarmRenderable extends _EveEntity {
   static {
     ({
-      e: [_init_mesh, _init_extra_mesh, _init_owner, _init_extra_owner, _init_worldTransform, _init_extra_worldTransform, _init_decals, _init_extra_decals, _init_perObjectDataVs, _init_extra_perObjectDataVs, _init_perObjectDataPs, _init_extra_perObjectDataPs, _init_psData, _init_extra_psData, _init_vsData, _init_extra_vsData, _initProto],
+      e: [_init_mesh, _init_extra_mesh, _init_owner, _init_extra_owner, _init_worldTransform, _init_extra_worldTransform, _init_decals, _init_extra_decals, _init_perObjectDataVs, _init_extra_perObjectDataVs, _init_perObjectDataPs, _init_extra_perObjectDataPs, _initProto],
       c: [_EveSwarmRenderable, _initClass]
     } = _applyDecs2311(this, [type.define({
       className: "EveSwarmRenderable",
       family: "eve/spaceObject/swarm"
-    })], [[type.objectRef("Tr2MeshBase"), 0, "mesh"], [type.objectRef("EveSwarm"), 0, "owner"], [[type, type.mat4], 16, "worldTransform"], [type.list("EveSpaceObjectDecal"), 0, "decals"], [type.rawStruct("Tr2PersistentPerObjectData"), 0, "perObjectDataVs"], [type.rawStruct("Tr2PersistentPerObjectData"), 0, "perObjectDataPs"], [type.rawStruct("EveSpaceObjectPSData"), 0, "psData"], [type.rawStruct("EveSpaceObjectVSData"), 0, "vsData"], [[impl, impl.adapted], 18, "InitializeRenderable"], [[impl, impl.adapted], 18, "SetWorldTransform"], [[impl, impl.implemented], 18, "GetWorldTransform"], [[impl, impl.implemented], 18, "SetBoosterIntensity"], [[impl, impl.adapted], 18, "SetShaderData"], [[impl, impl.adapted], 18, "InitDecals"], [[impl, impl.implemented], 18, "GetID"], [[impl, impl.adapted], 18, "SetShaderOption"], [[impl, impl.adapted, void 0, impl.reason("Carbon's RegisterComponent<IEveShadowCaster> template is expressed as the registry's explicit component-name signature.")], 18, "RegisterComponents"], [[impl, impl.adapted, void 0, impl.reason("The length-1 out array replaces the float& out-param; the shadow math is ported, including exactly which paths write the out value.")], 18, "IsCastingShadow"], [[impl, impl.adapted, void 0, impl.reason("Geometry IsGood/GetMeshLod realization (cpp:276-286) and the shadowPixelSize LOD select are engine-resolved; the delegation structure is ported (EveChildMesh precedent).")], 18, "GetShadowBatches"], [[impl, impl.adapted, void 0, impl.reason("Persistent VS/PS device buffers are engine-owned; the record carries the object reference whose live vsData/psData the engine serializer consumes.")], 18, "GetPerObjectData"], [[impl, impl.implemented], 18, "GetShadowPerObjectData"]], 0, void 0, _EveEntity));
-  }
-  constructor(...args) {
-    super(...args);
-    _init_extra_vsData(this);
+    })], [[type.objectRef("Tr2MeshBase"), 0, "mesh"], [type.objectRef("EveSwarm"), 0, "owner"], [[type, type.mat4], 16, "worldTransform"], [type.list("EveSpaceObjectDecal"), 0, "decals"], [type.rawStruct("Tr2PersistentPerObjectData"), 0, "perObjectDataVs"], [type.rawStruct("Tr2PersistentPerObjectData"), 0, "perObjectDataPs"], [[impl, impl.adapted], 18, "InitializeRenderable"], [[impl, impl.implemented], 18, "SetWorldTransform"], [[impl, impl.implemented], 18, "GetWorldTransform"], [[impl, impl.implemented], 18, "SetBoosterIntensity"], [[impl, impl.implemented], 18, "SetShaderData"], [[impl, impl.adapted], 18, "InitDecals"], [[impl, impl.implemented], 18, "GetID"], [[impl, impl.adapted], 18, "SetShaderOption"], [[impl, impl.adapted, void 0, impl.reason("Carbon's RegisterComponent<IEveShadowCaster> template is expressed as the registry's explicit component-name signature.")], 18, "RegisterComponents"], [[impl, impl.adapted, void 0, impl.reason("The length-1 out array replaces the float& out-param; the shadow math is ported, including exactly which paths write the out value.")], 18, "IsCastingShadow"], [[impl, impl.adapted, void 0, impl.reason("Geometry IsGood/GetMeshLod realization (cpp:276-286) and the shadowPixelSize LOD select are engine-resolved; the delegation structure is ported (EveChildMesh precedent).")], 18, "GetShadowBatches"], [[impl, impl.implemented], 18, "GetPerObjectData"], [[impl, impl.implemented], 18, "GetShadowPerObjectData"]], 0, void 0, _EveEntity));
   }
   /** m_mesh (Tr2MeshBasePtr) */
   mesh = (_initProto(this), _init_mesh(this, null));
@@ -50,58 +44,103 @@ class EveSwarmRenderable extends _EveEntity {
   /** m_perObjectDataPs (Tr2PersistentPerObjectData<EveSwarmRenderable>) */
   perObjectDataPs = (_init_extra_perObjectDataVs(this), _init_perObjectDataPs(this, null));
 
-  /** m_psData (EveSpaceObjectPSData) */
-  psData = (_init_extra_perObjectDataPs(this), _init_psData(this, new _EveSpaceObjectPSData()));
+  /** m_vsData / m_psData - this renderable PERSISTENT per-object pair. */
+  #perObjectData = (_init_extra_perObjectDataPs(this), createChildPerObjectRecords());
+
+  /** The previous LOGICAL world transform, for worldTransformLast. */
+  #lastWorldTransform = mat4.create();
 
-  /** m_vsData (EveSpaceObjectVSData) */
-  vsData = (_init_extra_psData(this), _init_vsData(this, new _EveSpaceObjectVSData()));
+  /**
+   * Binds this fighter to the swarm that owns it and the mesh it draws with.
+   * @param {Object} owner - the owning swarm; also this renderable's pick ID
+   * @param {Object} mesh - the shared fighter mesh
+   */
   InitializeRenderable(owner, mesh) {
     this.owner = owner ?? null;
     this.mesh = mesh ?? null;
   }
+
+  /**
+   * Carbon EveSwarmRenderable::SetWorldTransform (EveSwarm.cpp:115-125): the
+   * OUTGOING transform becomes worldTransformLast, then the new one is stamped
+   * into both records.
+   */
   SetWorldTransform(transform) {
+    // The previous LOGICAL transform is what stampChildTransforms needs, so it
+    // is kept alongside rather than read back out of the record.
+    mat4.copy(this.#lastWorldTransform, this.worldTransform);
     mat4.copy(this.worldTransform, transform);
-    mat4.copy(this.vsData.worldTransformLast, this.vsData.worldTransform);
-    mat4.transpose(this.vsData.worldTransform, this.worldTransform);
-    if (!mat4.invert(this.vsData.invWorldTransform, this.vsData.worldTransform)) {
-      mat4.identity(this.vsData.invWorldTransform);
-    }
-    mat4.copy(this.psData.worldTransform, this.vsData.worldTransform);
-    mat4.copy(this.psData.worldTransformLast, this.vsData.worldTransformLast);
-    mat4.copy(this.psData.invWorldTransform, this.vsData.invWorldTransform);
+    stampChildTransforms(this.#perObjectData, this.worldTransform, this.#lastWorldTransform);
   }
+
+  /**
+   * This fighter's world placement, as last set by SetWorldTransform.
+   * @returns {Float32Array} the live logical transform, not a copy
+   */
   GetWorldTransform() {
     return this.worldTransform;
   }
+
+  /** Carbon EveSwarm.cpp:132: the booster glow rides in shipData.x. */
   SetBoosterIntensity(intensity) {
-    this.psData.shipData[0] = intensity;
+    const shipData = this.#perObjectData.ps.Get("shipData");
+    shipData[0] = intensity;
   }
+
+  /**
+   * Carbon EveSwarmRenderable::SetShaderData (EveSwarm.cpp:135-152): copies the
+   * hull values a swarm ship shares with its owner. shipData.x is NOT copied -
+   * it is this renderable own booster glow.
+   * @param {RawData} vsData - the owner EveSpaceObjectVSData record
+   * @param {RawData} psData - the owner EveSpaceObjectPSData record
+   */
   SetShaderData(vsData, psData) {
+    const vs = this.#perObjectData.vs;
+    const ps = this.#perObjectData.ps;
     for (const name of ["clipData", "ellpsoidCenter", "ellpsoidRadii", "shipData"]) {
-      vec4.copy(this.vsData[name], vsData[name]);
+      vs.Set(name, vsData.Get(name));
     }
-    vec3.copy(this.psData.clipSphereCenter, psData.clipSphereCenter);
+    ps.Set("clipSphereCenter", psData.Get("clipSphereCenter"));
     for (const name of ["clipRadiusSq", "clipRadius2Sq", "impactDataOffset", "clipSphereFactor2", "clipSphereFactor"]) {
-      this.psData[name] = psData[name];
-    }
-    for (let index = 0; index < this.psData.shLightingCoefficients.length; index++) {
-      vec4.copy(this.psData.shLightingCoefficients[index], psData.shLightingCoefficients[index]);
+      ps.Set(name, psData.Get(name));
     }
-    this.psData.shipData[1] = psData.shipData[1];
-    this.psData.shipData[2] = psData.shipData[2];
-    this.psData.shipData[3] = psData.shipData[3];
+    ps.Set("shLightingCoefficients", psData.Get("shLightingCoefficients"));
+
+    // Carbon copies y/z/w only, leaving x (the booster glow) alone.
+    const shipData = ps.Get("shipData");
+    const owner = psData.Get("shipData");
+    shipData[1] = owner[1];
+    shipData[2] = owner[2];
+    shipData[3] = owner[3];
   }
+
+  /**
+   * Takes this fighter's own copies of the squad's authored decals, so a decal
+   * animating on one ship does not move on the rest.
+   * @param {Array} decals - authored decals; each is cloned when it can be
+   */
   InitDecals(decals) {
     this.decals = decals.map(decal => decal?.Clone?.() ?? decal);
   }
+
+  /**
+   * The pick identity of this fighter, which Carbon reports as its owning swarm.
+   * @returns {Object} the owner, or null before InitializeRenderable
+   */
   GetID() {
     return this.owner;
   }
+
+  /**
+   * Forwards an authored shader option to the fighter mesh, if one is bound.
+   * @param {String} name - option name
+   * @param {String|Number} value - option value
+   */
   SetShaderOption(name, value) {
     this.mesh?.SetShaderOption?.(name, value);
   }
 
-  /** Carbon EveSwarmRenderable::RegisterComponents (EveSwarm.cpp:306-313):
+  /** Carbon EveSwarmRenderable::RegisterComponents (EveSwarm.cpp:306-313):
    * unconditional ShadowCaster leaf self-registration. */
   RegisterComponents() {
     const registry = this.GetComponentRegistry();
@@ -110,15 +149,15 @@ class EveSwarmRenderable extends _EveEntity {
     }
   }
 
-  /** Carbon EveSwarmRenderable::IsCastingShadow (EveSwarm.cpp:242-267): the
-   * owner/reflection early-outs do NOT write the out-param (the scene hoists
-   * the float outside its caster loop, so a stale previous value survives -
-   * contract); the cull sphere is the OWNER's squad-wide sphere
-   * (EveSwarm.cpp:801-808) with its center overwritten by THIS fighter's
-   * world translation (cpp:257 - squad radius centered on the fighter);
-   * threshold is > 15 (the turret uses 5) - so a swarm with 5 < size <= 15
-   * casts volumetric/spot shadows (whose call sites ignore the return and
-   * re-check > 5 themselves) but not cascades. Carbon's float& out-param
+  /** Carbon EveSwarmRenderable::IsCastingShadow (EveSwarm.cpp:242-267): the
+   * owner/reflection early-outs do NOT write the out-param (the scene hoists
+   * the float outside its caster loop, so a stale previous value survives -
+   * contract); the cull sphere is the OWNER's squad-wide sphere
+   * (EveSwarm.cpp:801-808) with its center overwritten by THIS fighter's
+   * world translation (cpp:257 - squad radius centered on the fighter);
+   * threshold is > 15 (the turret uses 5) - so a swarm with 5 < size <= 15
+   * casts volumetric/spot shadows (whose call sites ignore the return and
+   * re-check > 5 themselves) but not cascades. Carbon's float& out-param
    * becomes the optional trailing length-1 array. */
   IsCastingShadow(cameraFrustum, shadowFrustum, renderReason, sizeInShadowOut = null) {
     if (!this.owner) {
@@ -146,12 +185,12 @@ class EveSwarmRenderable extends _EveEntity {
     return sizeInShadow > 15;
   }
 
-  /** Carbon EveSwarmRenderable::GetShadowBatches (EveSwarm.cpp:269-298): the
-   * mesh's OPAQUE areas only, per displayed area via CreateGeometryBatch -
-   * exactly Tr2MeshBase.GetBatches restricted to OPAQUE (no per-area
-   * IsCastingShadows filter; area display double-checked in Carbon). QUIRK:
-   * unlike the turret, shadowPixelSize IS consumed here - it drives the LOD
-   * select (cpp:282), which is engine-resolved at realization. Returns
+  /** Carbon EveSwarmRenderable::GetShadowBatches (EveSwarm.cpp:269-298): the
+   * mesh's OPAQUE areas only, per displayed area via CreateGeometryBatch -
+   * exactly Tr2MeshBase.GetBatches restricted to OPAQUE (no per-area
+   * IsCastingShadows filter; area display double-checked in Carbon). QUIRK:
+   * unlike the turret, shadowPixelSize IS consumed here - it drives the LOD
+   * select (cpp:282), which is engine-resolved at realization. Returns
    * whether any batch was committed (JS addition; Carbon returns void). */
   GetShadowBatches(batches, perObjectData, _shadowPixelSize) {
     if (!this.mesh || this.mesh.display === false) {
@@ -160,20 +199,19 @@ class EveSwarmRenderable extends _EveEntity {
     return this.mesh.GetBatches?.(batches, TriBatchType.TRIBATCHTYPE_OPAQUE, perObjectData) === true;
   }
 
-  /** Carbon EveSwarmRenderable::GetPerObjectData (EveSwarm.cpp:61-71):
-   * allocates Tr2PerObjectDataWithPersistentBuffers over the vsData/psData
-   * blocks this class already maintains CPU-side (SetWorldTransform /
-   * SetShaderData above); the persistent device buffers are engine-owned, so
-   * the GPU-free record carries the live object reference - the engine
-   * serializer reads vsData/psData at realization. No early-outs (unlike the
-   * turret's null-returning geometry gates). */
-  GetPerObjectData(accumulator = null) {
-    const data = typeof accumulator?.Allocate === "function" ? accumulator.Allocate(Tr2PerObjectData) : new Tr2PerObjectData();
-    data.object = this;
-    return data;
+  /**
+   * Carbon EveSwarmRenderable::GetPerObjectData (EveSwarm.cpp:61-71): a handle
+   * over the two PERSISTENT records this class maintains through
+   * SetWorldTransform and SetShaderData. No early-outs, unlike the turret gates.
+   */
+  GetPerObjectData(_accumulator = null) {
+    return {
+      vs: this.#perObjectData.vs,
+      ps: this.#perObjectData.ps
+    };
   }
 
-  /** Carbon EveSwarmRenderable::GetShadowPerObjectData (EveSwarm.cpp:300-303):
+  /** Carbon EveSwarmRenderable::GetShadowPerObjectData (EveSwarm.cpp:300-303):
    * pure forward to GetPerObjectData. */
   GetShadowPerObjectData(accumulator = null) {
     return this.GetPerObjectData(accumulator);

package/dist/eve/spaceObject/swarm/EveSwarmRenderable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EveSwarmRenderable.js","sources":["../../../../../src/eve/spaceObject/swarm/EveSwarmRenderable.js"],"sourcesContent":["// Source: trinity/trinity/Eve/SpaceObject/EveSwarm.h\n// Source: trinity/trinity/Eve/SpaceObject/EveSwarm.cpp\nimport { impl, type } from \"@carbonenginejs/runtime-utils/schema\";\nimport { EveEntity } from \"../../EveEntity.js\";\nimport { EveComponentType } from \"../../EveComponentTypes.js\";\nimport { mat4 } from \"@carbonenginejs/runtime-utils/mat4\";\nimport { vec3 } from \"@carbonenginejs/runtime-utils/vec3\";\nimport { vec4 } from \"@carbonenginejs/runtime-utils/vec4\";\nimport { TriBatchType } from \"@carbonenginejs/runtime-utils/graphics\";\nimport { createChildPerObjectRecords, stampChildTransforms } from \"../../perObjectData/childPerObjectRecords.js\";\nimport { Tr2RenderReason } from \"../../../generated/trinityCore/enums.js\";\n\n// Packed (x, y, z, radius) cull-sphere scratch for IsCastingShadow.\nconst SPHERE_SCRATCH = vec4.create();\n\n/** EveSwarmRenderable (eve/spaceObject/swarm) - generated from schema shapeHash a22c3310.... */\n@type.define({ className: \"EveSwarmRenderable\", family: \"eve/spaceObject/swarm\" })\nexport class EveSwarmRenderable extends EveEntity\n{\n\n  /** m_mesh (Tr2MeshBasePtr) */\n  @type.objectRef(\"Tr2MeshBase\")\n  mesh = null;\n\n  /** m_owner (BlueWeakRef<EveSwarm>) */\n  @type.objectRef(\"EveSwarm\")\n  owner = null;\n\n  /** m_worldTransform (Matrix) */\n  @type.mat4\n  worldTransform = mat4.create();\n\n  /** m_decals (PEveSpaceObjectDecalVector) */\n  @type.list(\"EveSpaceObjectDecal\")\n  decals = [];\n\n  /** m_perObjectDataVs (Tr2PersistentPerObjectData<EveSwarmRenderable>) */\n  @type.rawStruct(\"Tr2PersistentPerObjectData\")\n  perObjectDataVs = null;\n\n  /** m_perObjectDataPs (Tr2PersistentPerObjectData<EveSwarmRenderable>) */\n  @type.rawStruct(\"Tr2PersistentPerObjectData\")\n  perObjectDataPs = null;\n\n  /** m_vsData / m_psData - this renderable PERSISTENT per-object pair. */\n  #perObjectData = createChildPerObjectRecords();\n\n  /** The previous LOGICAL world transform, for worldTransformLast. */\n  #lastWorldTransform = mat4.create();\n\n  /**\n   * Binds this fighter to the swarm that owns it and the mesh it draws with.\n   * @param {Object} owner - the owning swarm; also this renderable's pick ID\n   * @param {Object} mesh - the shared fighter mesh\n   */\n  @impl.adapted\n  InitializeRenderable(owner, mesh)\n  {\n    this.owner = owner ?? null;\n    this.mesh = mesh ?? null;\n  }\n\n  /**\n   * Carbon EveSwarmRenderable::SetWorldTransform (EveSwarm.cpp:115-125): the\n   * OUTGOING transform becomes worldTransformLast, then the new one is stamped\n   * into both records.\n   */\n  @impl.implemented\n  SetWorldTransform(transform)\n  {\n    // The previous LOGICAL transform is what stampChildTransforms needs, so it\n    // is kept alongside rather than read back out of the record.\n    mat4.copy(this.#lastWorldTransform, this.worldTransform);\n    mat4.copy(this.worldTransform, transform);\n    stampChildTransforms(this.#perObjectData, this.worldTransform, this.#lastWorldTransform);\n  }\n\n  /**\n   * This fighter's world placement, as last set by SetWorldTransform.\n   * @returns {Float32Array} the live logical transform, not a copy\n   */\n  @impl.implemented\n  GetWorldTransform()\n  {\n    return this.worldTransform;\n  }\n\n  /** Carbon EveSwarm.cpp:132: the booster glow rides in shipData.x. */\n  @impl.implemented\n  SetBoosterIntensity(intensity)\n  {\n    const shipData = this.#perObjectData.ps.Get(\"shipData\");\n    shipData[0] = intensity;\n  }\n\n  /**\n   * Carbon EveSwarmRenderable::SetShaderData (EveSwarm.cpp:135-152): copies the\n   * hull values a swarm ship shares with its owner. shipData.x is NOT copied -\n   * it is this renderable own booster glow.\n   * @param {RawData} vsData - the owner EveSpaceObjectVSData record\n   * @param {RawData} psData - the owner EveSpaceObjectPSData record\n   */\n  @impl.implemented\n  SetShaderData(vsData, psData)\n  {\n    const vs = this.#perObjectData.vs;\n    const ps = this.#perObjectData.ps;\n\n    for (const name of [ \"clipData\", \"ellpsoidCenter\", \"ellpsoidRadii\", \"shipData\" ])\n    {\n      vs.Set(name, vsData.Get(name));\n    }\n    ps.Set(\"clipSphereCenter\", psData.Get(\"clipSphereCenter\"));\n    for (const name of [ \"clipRadiusSq\", \"clipRadius2Sq\", \"impactDataOffset\", \"clipSphereFactor2\", \"clipSphereFactor\" ])\n    {\n      ps.Set(name, psData.Get(name));\n    }\n    ps.Set(\"shLightingCoefficients\", psData.Get(\"shLightingCoefficients\"));\n\n    // Carbon copies y/z/w only, leaving x (the booster glow) alone.\n    const shipData = ps.Get(\"shipData\");\n    const owner = psData.Get(\"shipData\");\n    shipData[1] = owner[1];\n    shipData[2] = owner[2];\n    shipData[3] = owner[3];\n  }\n\n  /**\n   * Takes this fighter's own copies of the squad's authored decals, so a decal\n   * animating on one ship does not move on the rest.\n   * @param {Array} decals - authored decals; each is cloned when it can be\n   */\n  @impl.adapted\n  InitDecals(decals)\n  {\n    this.decals = decals.map(decal => decal?.Clone?.() ?? decal);\n  }\n\n  /**\n   * The pick identity of this fighter, which Carbon reports as its owning swarm.\n   * @returns {Object} the owner, or null before InitializeRenderable\n   */\n  @impl.implemented\n  GetID()\n  {\n    return this.owner;\n  }\n\n  /**\n   * Forwards an authored shader option to the fighter mesh, if one is bound.\n   * @param {String} name - option name\n   * @param {String|Number} value - option value\n   */\n  @impl.adapted\n  SetShaderOption(name, value)\n  {\n    this.mesh?.SetShaderOption?.(name, value);\n  }\n\n  /** Carbon EveSwarmRenderable::RegisterComponents (EveSwarm.cpp:306-313):\n   * unconditional ShadowCaster leaf self-registration. */\n  @impl.adapted\n  @impl.reason(\"Carbon's RegisterComponent<IEveShadowCaster> template is expressed as the registry's explicit component-name signature.\")\n  RegisterComponents()\n  {\n    const registry = this.GetComponentRegistry();\n    if (registry)\n    {\n      registry.RegisterComponent(EveComponentType.ShadowCaster, this);\n    }\n  }\n\n  /** Carbon EveSwarmRenderable::IsCastingShadow (EveSwarm.cpp:242-267): the\n   * owner/reflection early-outs do NOT write the out-param (the scene hoists\n   * the float outside its caster loop, so a stale previous value survives -\n   * contract); the cull sphere is the OWNER's squad-wide sphere\n   * (EveSwarm.cpp:801-808) with its center overwritten by THIS fighter's\n   * world translation (cpp:257 - squad radius centered on the fighter);\n   * threshold is > 15 (the turret uses 5) - so a swarm with 5 < size <= 15\n   * casts volumetric/spot shadows (whose call sites ignore the return and\n   * re-check > 5 themselves) but not cascades. Carbon's float& out-param\n   * becomes the optional trailing length-1 array. */\n  @impl.adapted\n  @impl.reason(\"The length-1 out array replaces the float& out-param; the shadow math is ported, including exactly which paths write the out value.\")\n  IsCastingShadow(cameraFrustum, shadowFrustum, renderReason, sizeInShadowOut = null)\n  {\n    if (!this.owner)\n    {\n      return false;\n    }\n    if (Number(renderReason ?? Tr2RenderReason.TR2RENDERREASON_NORMAL) === Tr2RenderReason.TR2RENDERREASON_REFLECTION)\n    {\n      return false;\n    }\n    if (this.owner.GetBoundingSphere?.(SPHERE_SCRATCH) !== true)\n    {\n      return false;\n    }\n    SPHERE_SCRATCH[0] = this.worldTransform[12];\n    SPHERE_SCRATCH[1] = this.worldTransform[13];\n    SPHERE_SCRATCH[2] = this.worldTransform[14];\n\n    let sizeInShadow = 0;\n    if (sizeInShadowOut)\n    {\n      sizeInShadowOut[0] = 0;\n    }\n    if (shadowFrustum?.IsVisible?.(cameraFrustum, SPHERE_SCRATCH))\n    {\n      sizeInShadow = shadowFrustum.GetSizeInShadow(SPHERE_SCRATCH);\n      if (sizeInShadowOut)\n      {\n        sizeInShadowOut[0] = sizeInShadow;\n      }\n    }\n    return sizeInShadow > 15;\n  }\n\n  /** Carbon EveSwarmRenderable::GetShadowBatches (EveSwarm.cpp:269-298): the\n   * mesh's OPAQUE areas only, per displayed area via CreateGeometryBatch -\n   * exactly Tr2MeshBase.GetBatches restricted to OPAQUE (no per-area\n   * IsCastingShadows filter; area display double-checked in Carbon). QUIRK:\n   * unlike the turret, shadowPixelSize IS consumed here - it drives the LOD\n   * select (cpp:282), which is engine-resolved at realization. Returns\n   * whether any batch was committed (JS addition; Carbon returns void). */\n  @impl.adapted\n  @impl.reason(\"Geometry IsGood/GetMeshLod realization (cpp:276-286) and the shadowPixelSize LOD select are engine-resolved; the delegation structure is ported (EveChildMesh precedent).\")\n  GetShadowBatches(batches, perObjectData, _shadowPixelSize)\n  {\n    if (!this.mesh || this.mesh.display === false)\n    {\n      return false;\n    }\n    return this.mesh.GetBatches?.(batches, TriBatchType.TRIBATCHTYPE_OPAQUE, perObjectData) === true;\n  }\n\n  /**\n   * Carbon EveSwarmRenderable::GetPerObjectData (EveSwarm.cpp:61-71): a handle\n   * over the two PERSISTENT records this class maintains through\n   * SetWorldTransform and SetShaderData. No early-outs, unlike the turret gates.\n   */\n  @impl.implemented\n  GetPerObjectData(_accumulator = null)\n  {\n    return { vs: this.#perObjectData.vs, ps: this.#perObjectData.ps };\n  }\n\n  /** Carbon EveSwarmRenderable::GetShadowPerObjectData (EveSwarm.cpp:300-303):\n   * pure forward to GetPerObjectData. */\n  @impl.implemented\n  GetShadowPerObjectData(accumulator = null)\n  {\n    return this.GetPerObjectData(accumulator);\n  }\n\n}\n"],"names":["SPHERE_SCRATCH","vec4","create","_EveSwarmRenderable","EveSwarmRenderable","EveEntity","e","_init_mesh","_init_extra_mesh","_init_owner","_init_extra_owner","_init_worldTransform","_init_extra_worldTransform","_init_decals","_init_extra_decals","_init_perObjectDataVs","_init_extra_perObjectDataVs","_init_perObjectDataPs","_init_extra_perObjectDataPs","_initProto","c","_initClass","_applyDecs","type","define","className","family","objectRef","mat4","list","rawStruct","impl","adapted","implemented","reason","mesh","owner","worldTransform","decals","perObjectDataVs","perObjectDataPs","createChildPerObjectRecords","InitializeRenderable","SetWorldTransform","transform","copy","stampChildTransforms","GetWorldTransform","SetBoosterIntensity","intensity","shipData","ps","Get","SetShaderData","vsData","psData","vs","name","Set","InitDecals","map","decal","Clone","GetID","SetShaderOption","value","RegisterComponents","registry","GetComponentRegistry","RegisterComponent","EveComponentType","ShadowCaster","IsCastingShadow","cameraFrustum","shadowFrustum","renderReason","sizeInShadowOut","Number","Tr2RenderReason","TR2RENDERREASON_NORMAL","TR2RENDERREASON_REFLECTION","GetBoundingSphere","sizeInShadow","IsVisible","GetSizeInShadow","GetShadowBatches","batches","perObjectData","_shadowPixelSize","display","GetBatches","TriBatchType","TRIBATCHTYPE_OPAQUE","GetPerObjectData","_accumulator","GetShadowPerObjectData","accumulator"],"mappings":"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"}

package/dist/eve/ui/EveEllipseDefinition.js

@@ -4,6 +4,11 @@ import { CjsModel } from '@carbonenginejs/runtime-utils/model';
 import { io, type } from '@carbonenginejs/runtime-utils/schema';
 
 let _initClass, _init_center, _init_extra_center, _init_planeNormal, _init_extra_planeNormal, _init_rotationDegrees, _init_extra_rotationDegrees, _init_semiMajor, _init_extra_semiMajor, _init_semiMinor, _init_extra_semiMinor;
+
+/**
+ * One authored ellipse of an ellipse set - centre, plane normal, in-plane
+ * rotation in degrees and the two semi-axis lengths.
+ */
 let _EveEllipseDefinition;
 class EveEllipseDefinition extends CjsModel {
   static {
@@ -25,10 +30,20 @@ class EveEllipseDefinition extends CjsModel {
   rotationDegrees = (_init_extra_planeNormal(this), _init_rotationDegrees(this, 0));
   semiMajor = (_init_extra_rotationDegrees(this), _init_semiMajor(this, 1));
   semiMinor = (_init_extra_semiMajor(this), _init_semiMinor(this, 1));
+
+  /**
+   * Invokes the bound dirty callback so the owning set regenerates its geometry
+   * after any authored field changes.
+   */
   OnModified(_value = null) {
     this.#dirtyFlag?.();
     return true;
   }
+
+  /**
+   * Installs the callback invoked whenever this definition is modified; pass
+   * null to unbind, and anything that is neither a function nor null throws.
+   */
   SetDirtyFlag(dirtyFlag) {
     if (dirtyFlag !== null && typeof dirtyFlag !== "function") {
       throw new TypeError("EveEllipseDefinition dirty flag must be a function or null");

package/dist/eve/ui/EveEllipseDefinition.js.map

@@ -1 +1 @@
-{"version":3,"file":"EveEllipseDefinition.js","sources":["../../../../src/eve/ui/EveEllipseDefinition.js"],"sourcesContent":["// Ported from CarbonEngine (MIT, (c) 2026 CCP Games) - https://github.com/carbonengine/trinity\n//   trinity/trinity/Eve/UI/EveEllipseDefinition.h\n//   trinity/trinity/Eve/UI/EveEllipseDefinition.cpp\nimport { vec3 } from \"@carbonenginejs/runtime-utils/vec3\";\nimport { CjsModel } from \"@carbonenginejs/runtime-utils/model\";\nimport { io, type } from \"@carbonenginejs/runtime-utils/schema\";\n\n\n@type.define({ className: \"EveEllipseDefinition\", family: \"eve/ui\" })\nexport class EveEllipseDefinition extends CjsModel\n{\n  #dirtyFlag = null;\n\n  @io.notify\n  @io.persist\n  @type.vec3\n  center = vec3.create();\n\n  @io.notify\n  @io.persist\n  @type.vec3\n  planeNormal = vec3.fromValues(0, 1, 0);\n\n  @io.notify\n  @io.persist\n  @type.float32\n  rotationDegrees = 0;\n\n  @io.notify\n  @io.persist\n  @type.float32\n  semiMajor = 1;\n\n  @io.notify\n  @io.persist\n  @type.float32\n  semiMinor = 1;\n\n  OnModified(_value = null)\n  {\n    this.#dirtyFlag?.();\n    return true;\n  }\n\n  SetDirtyFlag(dirtyFlag)\n  {\n    if (dirtyFlag !== null && typeof dirtyFlag !== \"function\")\n    {\n      throw new TypeError(\"EveEllipseDefinition dirty flag must be a function or null\");\n    }\n    this.#dirtyFlag = dirtyFlag;\n  }\n}\n"],"names":["_EveEllipseDefinition","EveEllipseDefinition","CjsModel","e","_init_center","_init_extra_center","_init_planeNormal","_init_extra_planeNormal","_init_rotationDegrees","_init_extra_rotationDegrees","_init_semiMajor","_init_extra_semiMajor","_init_semiMinor","_init_extra_semiMinor","c","_initClass","_applyDecs","type","define","className","family","io","notify","persist","vec3","float32","constructor","args","center","create","planeNormal","fromValues","rotationDegrees","semiMajor","semiMinor","OnModified","_value","SetDirtyFlag","dirtyFlag","TypeError"],"mappings":";;;;;;AAKgE,IAAAA;AAGhE,MAAAC,oBAAA,SAC0CC,QAAQ,CAClD;AAAA,EAAA;AAAA,IAAA,CAAA;AAAAC,MAAAA,CAAA,GAAAC,YAAA,EAAAC,kBAAA,EAAAC,iBAAA,EAAAC,uBAAA,EAAAC,qBAAA,EAAAC,2BAAA,EAAAC,eAAA,EAAAC,qBAAA,EAAAC,eAAA,EAAAC,qBAAA,CAAA;MAAAC,CAAA,EAAA,CAAAd,qBAAA,EAAAe,UAAA;AAAA,KAAA,GAAAC,cAAA,CAAA,IAAA,EAAA,CAFCC,IAAI,CAACC,MAAM,CAAC;AAAEC,MAAAA,SAAS,EAAE,sBAAsB;AAAEC,MAAAA,MAAM,EAAE;KAAU,CAAC,MAKlEC,EAAE,EAAFA,EAAE,CAACC,MAAM,EACTD,EAAE,EAAFA,EAAE,CAACE,OAAO,EACVN,IAAI,EAAJA,IAAI,CAACO,IAAI,oBAGTH,EAAE,EAAFA,EAAE,CAACC,MAAM,EACTD,EAAE,EAAFA,EAAE,CAACE,OAAO,EACVN,IAAI,EAAJA,IAAI,CAACO,IAAI,yBAGTH,EAAE,EAAFA,EAAE,CAACC,MAAM,EACTD,EAAE,EAAFA,EAAE,CAACE,OAAO,EACVN,IAAI,EAAJA,IAAI,CAACQ,OAAO,6BAGZJ,EAAE,EAAFA,EAAE,CAACC,MAAM,EACTD,EAAE,EAAFA,EAAE,CAACE,OAAO,EACVN,IAAI,EAAJA,IAAI,CAACQ,OAAO,uBAGZJ,EAAE,EAAFA,EAAE,CAACC,MAAM,EACTD,EAAE,EAAFA,EAAE,CAACE,OAAO,EACVN,IAAI,EAAJA,IAAI,CAACQ,OAAO,iCA1B2BvB,QAAQ,CAAA;AAAA;AAAAwB,EAAAA,WAAAA,CAAA,GAAAC,IAAA,EAAA;AAAA,IAAA,KAAA,CAAA,GAAAA,IAAA,CAAA;IAAAd,qBAAA,CAAA,IAAA,CAAA;AAAA,EAAA;EAEhD,UAAU,GAAG,IAAI;AAKjBe,EAAAA,MAAM,GAAAxB,YAAA,CAAA,IAAA,EAAGoB,IAAI,CAACK,MAAM,EAAE,CAAA;AAKtBC,EAAAA,WAAW,IAAAzB,kBAAA,CAAA,IAAA,CAAA,EAAAC,iBAAA,OAAGkB,IAAI,CAACO,UAAU,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;AAKtCC,EAAAA,eAAe,IAAAzB,uBAAA,CAAA,IAAA,CAAA,EAAAC,qBAAA,OAAG,CAAC,CAAA;AAKnByB,EAAAA,SAAS,IAAAxB,2BAAA,CAAA,IAAA,CAAA,EAAAC,eAAA,OAAG,CAAC,CAAA;AAKbwB,EAAAA,SAAS,IAAAvB,qBAAA,CAAA,IAAA,CAAA,EAAAC,eAAA,OAAG,CAAC,CAAA;AAEbuB,EAAAA,UAAUA,CAACC,MAAM,GAAG,IAAI,EACxB;AACE,IAAA,IAAI,CAAC,UAAU,IAAI;AACnB,IAAA,OAAO,IAAI;AACb,EAAA;EAEAC,YAAYA,CAACC,SAAS,EACtB;IACE,IAAIA,SAAS,KAAK,IAAI,IAAI,OAAOA,SAAS,KAAK,UAAU,EACzD;AACE,MAAA,MAAM,IAAIC,SAAS,CAAC,4DAA4D,CAAC;AACnF,IAAA;AACA,IAAA,IAAI,CAAC,UAAU,GAAGD,SAAS;AAC7B,EAAA;AAAC,EAAA;IAAAvB,UAAA,EAAA;AAAA;AACH;;;;"}
+{"version":3,"file":"EveEllipseDefinition.js","sources":["../../../../src/eve/ui/EveEllipseDefinition.js"],"sourcesContent":["// Ported from CarbonEngine (MIT, (c) 2026 CCP Games) - https://github.com/carbonengine/trinity\n//   trinity/trinity/Eve/UI/EveEllipseDefinition.h\n//   trinity/trinity/Eve/UI/EveEllipseDefinition.cpp\nimport { vec3 } from \"@carbonenginejs/runtime-utils/vec3\";\nimport { CjsModel } from \"@carbonenginejs/runtime-utils/model\";\nimport { io, type } from \"@carbonenginejs/runtime-utils/schema\";\n\n\n/**\n * One authored ellipse of an ellipse set - centre, plane normal, in-plane\n * rotation in degrees and the two semi-axis lengths.\n */\n@type.define({ className: \"EveEllipseDefinition\", family: \"eve/ui\" })\nexport class EveEllipseDefinition extends CjsModel\n{\n  #dirtyFlag = null;\n\n  @io.notify\n  @io.persist\n  @type.vec3\n  center = vec3.create();\n\n  @io.notify\n  @io.persist\n  @type.vec3\n  planeNormal = vec3.fromValues(0, 1, 0);\n\n  @io.notify\n  @io.persist\n  @type.float32\n  rotationDegrees = 0;\n\n  @io.notify\n  @io.persist\n  @type.float32\n  semiMajor = 1;\n\n  @io.notify\n  @io.persist\n  @type.float32\n  semiMinor = 1;\n\n  /**\n   * Invokes the bound dirty callback so the owning set regenerates its geometry\n   * after any authored field changes.\n   */\n  OnModified(_value = null)\n  {\n    this.#dirtyFlag?.();\n    return true;\n  }\n\n  /**\n   * Installs the callback invoked whenever this definition is modified; pass\n   * null to unbind, and anything that is neither a function nor null throws.\n   */\n  SetDirtyFlag(dirtyFlag)\n  {\n    if (dirtyFlag !== null && typeof dirtyFlag !== \"function\")\n    {\n      throw new TypeError(\"EveEllipseDefinition dirty flag must be a function or null\");\n    }\n    this.#dirtyFlag = dirtyFlag;\n  }\n}\n"],"names":["_EveEllipseDefinition","EveEllipseDefinition","CjsModel","e","_init_center","_init_extra_center","_init_planeNormal","_init_extra_planeNormal","_init_rotationDegrees","_init_extra_rotationDegrees","_init_semiMajor","_init_extra_semiMajor","_init_semiMinor","_init_extra_semiMinor","c","_initClass","_applyDecs","type","define","className","family","io","notify","persist","vec3","float32","constructor","args","center","create","planeNormal","fromValues","rotationDegrees","semiMajor","semiMinor","OnModified","_value","SetDirtyFlag","dirtyFlag","TypeError"],"mappings":";;;;;;;AAQA;AACA;AACA;AACA;AAHA,IAAAA;AAIA,MAAAC,oBAAA,SAC0CC,QAAQ,CAClD;AAAA,EAAA;AAAA,IAAA,CAAA;AAAAC,MAAAA,CAAA,GAAAC,YAAA,EAAAC,kBAAA,EAAAC,iBAAA,EAAAC,uBAAA,EAAAC,qBAAA,EAAAC,2BAAA,EAAAC,eAAA,EAAAC,qBAAA,EAAAC,eAAA,EAAAC,qBAAA,CAAA;MAAAC,CAAA,EAAA,CAAAd,qBAAA,EAAAe,UAAA;AAAA,KAAA,GAAAC,cAAA,CAAA,IAAA,EAAA,CAFCC,IAAI,CAACC,MAAM,CAAC;AAAEC,MAAAA,SAAS,EAAE,sBAAsB;AAAEC,MAAAA,MAAM,EAAE;KAAU,CAAC,MAKlEC,EAAE,EAAFA,EAAE,CAACC,MAAM,EACTD,EAAE,EAAFA,EAAE,CAACE,OAAO,EACVN,IAAI,EAAJA,IAAI,CAACO,IAAI,oBAGTH,EAAE,EAAFA,EAAE,CAACC,MAAM,EACTD,EAAE,EAAFA,EAAE,CAACE,OAAO,EACVN,IAAI,EAAJA,IAAI,CAACO,IAAI,yBAGTH,EAAE,EAAFA,EAAE,CAACC,MAAM,EACTD,EAAE,EAAFA,EAAE,CAACE,OAAO,EACVN,IAAI,EAAJA,IAAI,CAACQ,OAAO,6BAGZJ,EAAE,EAAFA,EAAE,CAACC,MAAM,EACTD,EAAE,EAAFA,EAAE,CAACE,OAAO,EACVN,IAAI,EAAJA,IAAI,CAACQ,OAAO,uBAGZJ,EAAE,EAAFA,EAAE,CAACC,MAAM,EACTD,EAAE,EAAFA,EAAE,CAACE,OAAO,EACVN,IAAI,EAAJA,IAAI,CAACQ,OAAO,iCA1B2BvB,QAAQ,CAAA;AAAA;AAAAwB,EAAAA,WAAAA,CAAA,GAAAC,IAAA,EAAA;AAAA,IAAA,KAAA,CAAA,GAAAA,IAAA,CAAA;IAAAd,qBAAA,CAAA,IAAA,CAAA;AAAA,EAAA;EAEhD,UAAU,GAAG,IAAI;AAKjBe,EAAAA,MAAM,GAAAxB,YAAA,CAAA,IAAA,EAAGoB,IAAI,CAACK,MAAM,EAAE,CAAA;AAKtBC,EAAAA,WAAW,IAAAzB,kBAAA,CAAA,IAAA,CAAA,EAAAC,iBAAA,OAAGkB,IAAI,CAACO,UAAU,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;AAKtCC,EAAAA,eAAe,IAAAzB,uBAAA,CAAA,IAAA,CAAA,EAAAC,qBAAA,OAAG,CAAC,CAAA;AAKnByB,EAAAA,SAAS,IAAAxB,2BAAA,CAAA,IAAA,CAAA,EAAAC,eAAA,OAAG,CAAC,CAAA;AAKbwB,EAAAA,SAAS,IAAAvB,qBAAA,CAAA,IAAA,CAAA,EAAAC,eAAA,OAAG,CAAC,CAAA;;AAEb;AACF;AACA;AACA;AACEuB,EAAAA,UAAUA,CAACC,MAAM,GAAG,IAAI,EACxB;AACE,IAAA,IAAI,CAAC,UAAU,IAAI;AACnB,IAAA,OAAO,IAAI;AACb,EAAA;;AAEA;AACF;AACA;AACA;EACEC,YAAYA,CAACC,SAAS,EACtB;IACE,IAAIA,SAAS,KAAK,IAAI,IAAI,OAAOA,SAAS,KAAK,UAAU,EACzD;AACE,MAAA,MAAM,IAAIC,SAAS,CAAC,4DAA4D,CAAC;AACnF,IAAA;AACA,IAAA,IAAI,CAAC,UAAU,GAAGD,SAAS;AAC7B,EAAA;AAAC,EAAA;IAAAvB,UAAA,EAAA;AAAA;AACH;;;;"}

package/dist/eve/ui/EveEllipseSet.js

@@ -5,6 +5,11 @@ import { EveChildTransform as _EveChildTransform } from '../child/EveChildTransf
 import { EveEllipseDefinition as _EveEllipseDefinition } from './EveEllipseDefinition.js';
 
 let _initProto, _initClass, _init_ribbonSegmentCount, _init_extra_ribbonSegmentCount, _init_name, _init_extra_name, _init_display, _init_extra_display, _init_enablePicking, _init_extra_enablePicking, _init_depthOffset, _init_extra_depthOffset, _init_ellipses, _init_extra_ellipses, _init_effect, _init_extra_effect;
+
+/**
+ * Transform child that owns a list of ellipse definitions and the effect they
+ * are drawn with, used for the ribbon rings of UI overlays.
+ */
 let _EveEllipseSet;
 class EveEllipseSet extends _EveChildTransform {
   static {
@@ -28,6 +33,16 @@ class EveEllipseSet extends _EveChildTransform {
   depthOffset = (_init_extra_enablePicking(this), _init_depthOffset(this, 0));
   ellipses = (_init_extra_depthOffset(this), _init_ellipses(this, []));
   effect = (_init_extra_ellipses(this), _init_effect(this, null));
+
+  /**
+   * Appends an ellipse to the set, binds its dirty callback and marks the ribbon geometry for rebuild.
+   * @param {vec3} center Centre in the set's local space
+   * @param {Number} semiMajor
+   * @param {Number} semiMinor
+   * @param {vec3} planeNormal Normal of the plane the ellipse lies in
+   * @param {Number} rotationDegrees In-plane rotation, in degrees
+   * @returns {Boolean} Always true
+   */
   AddEllipse(center, semiMajor, semiMinor, planeNormal, rotationDegrees) {
     const ellipse = new _EveEllipseDefinition();
     vec3.copy(ellipse.center, center);
@@ -40,6 +55,12 @@ class EveEllipseSet extends _EveChildTransform {
     this.#MarkGeometryDirty();
     return true;
   }
+
+  /**
+   * Rebinds every persisted ellipse's dirty callback after hydration; unlike
+   * Carbon it does not create the default effect, since resource lookup is left
+   * to the engine layer.
+   */
   __init__() {
     // Carbon creates the configured default effect here. Resource lookup is
     // runtime-resource/engine work; a persisted or caller-assigned effect is
@@ -48,6 +69,12 @@ class EveEllipseSet extends _EveChildTransform {
       this.#BindEllipse(ellipse);
     }
   }
+
+  /**
+   * Removes every ellipse, unbinding their dirty callbacks first so discarded
+   * definitions can no longer invalidate this set, and marks the geometry for
+   * rebuild.
+   */
   ClearEllipses() {
     for (const ellipse of this.ellipses) {
       ellipse?.SetDirtyFlag?.(null);
@@ -55,13 +82,28 @@ class EveEllipseSet extends _EveChildTransform {
     this.ellipses.length = 0;
     this.#MarkGeometryDirty();
   }
+
+  /**
+   * Marks the ribbon geometry for rebuild when a notifying field such as the
+   * segment count changes.
+   */
   OnModified(_value = null) {
     this.#MarkGeometryDirty();
     return true;
   }
+
+  /**
+   * Flags the ribbon geometry as stale so it is regenerated before the next
+   * draw.
+   */
   #MarkGeometryDirty() {
     this.#geometryDirty = true;
   }
+
+  /**
+   * Points an ellipse definition's dirty callback back at this set, so editing
+   * the definition invalidates the set's geometry.
+   */
   #BindEllipse(ellipse) {
     ellipse?.SetDirtyFlag?.(() => this.#MarkGeometryDirty());
   }

package/dist/eve/ui/EveEllipseSet.js.map

@@ -1 +1 @@
-{"version":3,"file":"EveEllipseSet.js","sources":["../../../../src/eve/ui/EveEllipseSet.js"],"sourcesContent":["// Ported from CarbonEngine (MIT, (c) 2026 CCP Games) - https://github.com/carbonengine/trinity\n//   trinity/trinity/Eve/UI/EveEllipseSet.h\n//   trinity/trinity/Eve/UI/EveEllipseSet.cpp\nimport { vec3 } from \"@carbonenginejs/runtime-utils/vec3\";\nimport { carbon, io, type } from \"@carbonenginejs/runtime-utils/schema\";\nimport { EveChildTransform } from \"../child/EveChildTransform.js\";\nimport { EveEllipseDefinition } from \"./EveEllipseDefinition.js\";\n\n\n@type.define({ className: \"EveEllipseSet\", family: \"eve/ui\" })\nexport class EveEllipseSet extends EveChildTransform\n{\n  #geometryDirty = true;\n\n  @io.notify\n  @io.persist\n  @type.uint32\n  ribbonSegmentCount = 128;\n\n  @io.persist\n  @type.string\n  name = \"\";\n\n  @io.persist\n  @type.boolean\n  display = true;\n\n  @io.persist\n  @type.boolean\n  enablePicking = true;\n\n  @io.persist\n  @type.float32\n  depthOffset = 0;\n\n  @io.persist\n  @type.list(\"EveEllipseDefinition\")\n  ellipses = [];\n\n  @io.persist\n  @type.model(\"Tr2Effect\")\n  effect = null;\n\n  @carbon.method\n  AddEllipse(center, semiMajor, semiMinor, planeNormal, rotationDegrees)\n  {\n    const ellipse = new EveEllipseDefinition();\n    vec3.copy(ellipse.center, center);\n    ellipse.semiMajor = semiMajor;\n    ellipse.semiMinor = semiMinor;\n    vec3.copy(ellipse.planeNormal, planeNormal);\n    ellipse.rotationDegrees = rotationDegrees;\n    this.#BindEllipse(ellipse);\n    this.ellipses.push(ellipse);\n    this.#MarkGeometryDirty();\n    return true;\n  }\n\n  @carbon.method\n  __init__()\n  {\n    // Carbon creates the configured default effect here. Resource lookup is\n    // runtime-resource/engine work; a persisted or caller-assigned effect is\n    // retained and the CPU definitions are rebound after hydration.\n    for (const ellipse of this.ellipses)\n    {\n      this.#BindEllipse(ellipse);\n    }\n  }\n\n  @carbon.method\n  ClearEllipses()\n  {\n    for (const ellipse of this.ellipses)\n    {\n      ellipse?.SetDirtyFlag?.(null);\n    }\n    this.ellipses.length = 0;\n    this.#MarkGeometryDirty();\n  }\n\n  OnModified(_value = null)\n  {\n    this.#MarkGeometryDirty();\n    return true;\n  }\n\n  #MarkGeometryDirty()\n  {\n    this.#geometryDirty = true;\n  }\n\n  #BindEllipse(ellipse)\n  {\n    ellipse?.SetDirtyFlag?.(() => this.#MarkGeometryDirty());\n  }\n}\n"],"names":["_EveEllipseSet","EveEllipseSet","EveChildTransform","e","_init_ribbonSegmentCount","_init_extra_ribbonSegmentCount","_init_name","_init_extra_name","_init_display","_init_extra_display","_init_enablePicking","_init_extra_enablePicking","_init_depthOffset","_init_extra_depthOffset","_init_ellipses","_init_extra_ellipses","_init_effect","_init_extra_effect","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","notify","persist","uint32","string","boolean","float32","list","model","carbon","method","constructor","args","ribbonSegmentCount","name","display","enablePicking","depthOffset","ellipses","effect","AddEllipse","center","semiMajor","semiMinor","planeNormal","rotationDegrees","ellipse","EveEllipseDefinition","vec3","copy","push","__init__","ClearEllipses","SetDirtyFlag","length","OnModified","_value","#MarkGeometryDirty","#BindEllipse"],"mappings":"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"}
+{"version":3,"file":"EveEllipseSet.js","sources":["../../../../src/eve/ui/EveEllipseSet.js"],"sourcesContent":["// Ported from CarbonEngine (MIT, (c) 2026 CCP Games) - https://github.com/carbonengine/trinity\n//   trinity/trinity/Eve/UI/EveEllipseSet.h\n//   trinity/trinity/Eve/UI/EveEllipseSet.cpp\nimport { vec3 } from \"@carbonenginejs/runtime-utils/vec3\";\nimport { carbon, io, type } from \"@carbonenginejs/runtime-utils/schema\";\nimport { EveChildTransform } from \"../child/EveChildTransform.js\";\nimport { EveEllipseDefinition } from \"./EveEllipseDefinition.js\";\n\n\n/**\n * Transform child that owns a list of ellipse definitions and the effect they\n * are drawn with, used for the ribbon rings of UI overlays.\n */\n@type.define({ className: \"EveEllipseSet\", family: \"eve/ui\" })\nexport class EveEllipseSet extends EveChildTransform\n{\n  #geometryDirty = true;\n\n  @io.notify\n  @io.persist\n  @type.uint32\n  ribbonSegmentCount = 128;\n\n  @io.persist\n  @type.string\n  name = \"\";\n\n  @io.persist\n  @type.boolean\n  display = true;\n\n  @io.persist\n  @type.boolean\n  enablePicking = true;\n\n  @io.persist\n  @type.float32\n  depthOffset = 0;\n\n  @io.persist\n  @type.list(\"EveEllipseDefinition\")\n  ellipses = [];\n\n  @io.persist\n  @type.model(\"Tr2Effect\")\n  effect = null;\n\n  /**\n   * Appends an ellipse to the set, binds its dirty callback and marks the ribbon geometry for rebuild.\n   * @param {vec3} center Centre in the set's local space\n   * @param {Number} semiMajor\n   * @param {Number} semiMinor\n   * @param {vec3} planeNormal Normal of the plane the ellipse lies in\n   * @param {Number} rotationDegrees In-plane rotation, in degrees\n   * @returns {Boolean} Always true\n   */\n  @carbon.method\n  AddEllipse(center, semiMajor, semiMinor, planeNormal, rotationDegrees)\n  {\n    const ellipse = new EveEllipseDefinition();\n    vec3.copy(ellipse.center, center);\n    ellipse.semiMajor = semiMajor;\n    ellipse.semiMinor = semiMinor;\n    vec3.copy(ellipse.planeNormal, planeNormal);\n    ellipse.rotationDegrees = rotationDegrees;\n    this.#BindEllipse(ellipse);\n    this.ellipses.push(ellipse);\n    this.#MarkGeometryDirty();\n    return true;\n  }\n\n  /**\n   * Rebinds every persisted ellipse's dirty callback after hydration; unlike\n   * Carbon it does not create the default effect, since resource lookup is left\n   * to the engine layer.\n   */\n  @carbon.method\n  __init__()\n  {\n    // Carbon creates the configured default effect here. Resource lookup is\n    // runtime-resource/engine work; a persisted or caller-assigned effect is\n    // retained and the CPU definitions are rebound after hydration.\n    for (const ellipse of this.ellipses)\n    {\n      this.#BindEllipse(ellipse);\n    }\n  }\n\n  /**\n   * Removes every ellipse, unbinding their dirty callbacks first so discarded\n   * definitions can no longer invalidate this set, and marks the geometry for\n   * rebuild.\n   */\n  @carbon.method\n  ClearEllipses()\n  {\n    for (const ellipse of this.ellipses)\n    {\n      ellipse?.SetDirtyFlag?.(null);\n    }\n    this.ellipses.length = 0;\n    this.#MarkGeometryDirty();\n  }\n\n  /**\n   * Marks the ribbon geometry for rebuild when a notifying field such as the\n   * segment count changes.\n   */\n  OnModified(_value = null)\n  {\n    this.#MarkGeometryDirty();\n    return true;\n  }\n\n  /**\n   * Flags the ribbon geometry as stale so it is regenerated before the next\n   * draw.\n   */\n  #MarkGeometryDirty()\n  {\n    this.#geometryDirty = true;\n  }\n\n  /**\n   * Points an ellipse definition's dirty callback back at this set, so editing\n   * the definition invalidates the set's geometry.\n   */\n  #BindEllipse(ellipse)\n  {\n    ellipse?.SetDirtyFlag?.(() => this.#MarkGeometryDirty());\n  }\n}\n"],"names":["_EveEllipseSet","EveEllipseSet","EveChildTransform","e","_init_ribbonSegmentCount","_init_extra_ribbonSegmentCount","_init_name","_init_extra_name","_init_display","_init_extra_display","_init_enablePicking","_init_extra_enablePicking","_init_depthOffset","_init_extra_depthOffset","_init_ellipses","_init_extra_ellipses","_init_effect","_init_extra_effect","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","notify","persist","uint32","string","boolean","float32","list","model","carbon","method","constructor","args","ribbonSegmentCount","name","display","enablePicking","depthOffset","ellipses","effect","AddEllipse","center","semiMajor","semiMinor","planeNormal","rotationDegrees","ellipse","EveEllipseDefinition","vec3","copy","push","__init__","ClearEllipses","SetDirtyFlag","length","OnModified","_value","#MarkGeometryDirty","#BindEllipse"],"mappings":"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"}

package/dist/{generated/eve → eve}/ui/EveSpherePin.js

@@ -1,30 +1,27 @@
-import { applyDecs2311 as _applyDecs2311 } from '../../../_virtual/_rollupPluginBabelHelpers.js';
-import { io, type } from '@carbonenginejs/runtime-utils/schema';
+import { applyDecs2311 as _applyDecs2311 } from '../../_virtual/_rollupPluginBabelHelpers.js';
+import { io, type, carbon, impl } from '@carbonenginejs/runtime-utils/schema';
 import { CjsModel } from '@carbonenginejs/runtime-utils/model';
+import { mat4 } from '@carbonenginejs/runtime-utils/mat4';
 import { quat } from '@carbonenginejs/runtime-utils/quat';
 import { vec3 } from '@carbonenginejs/runtime-utils/vec3';
 import { vec4 } from '@carbonenginejs/runtime-utils/vec4';
 
-let _initClass, _init_primitiveCount, _init_extra_primitiveCount, _init_translation, _init_extra_translation, _init_rotation, _init_extra_rotation, _init_scaling, _init_extra_scaling, _init_display, _init_extra_display, _init_enablePicking, _init_extra_enablePicking, _init_name, _init_extra_name, _init_pinColor, _init_extra_pinColor, _init_color, _init_extra_color, _init_curveSets, _init_extra_curveSets, _init_sortValueMultiplier, _init_extra_sortValueMultiplier, _init_centerNormal, _init_extra_centerNormal, _init_pinMaxRadius, _init_extra_pinMaxRadius, _init_pinRadius, _init_extra_pinRadius, _init_pinEffectResPath, _init_extra_pinEffectResPath, _init_geometryResPath, _init_extra_geometryResPath, _init_pinRotation, _init_extra_pinRotation, _init_pinAlphaThreshold, _init_extra_pinAlphaThreshold, _init_uvAtlasScaleOffset, _init_extra_uvAtlasScaleOffset, _init_pinEffect, _init_extra_pinEffect, _init_pickEffect, _init_extra_pickEffect;
+let _initProto, _initClass, _init_primitiveCount, _init_extra_primitiveCount, _init_translation, _init_extra_translation, _init_rotation, _init_extra_rotation, _init_scaling, _init_extra_scaling, _init_display, _init_extra_display, _init_enablePicking, _init_extra_enablePicking, _init_name, _init_extra_name, _init_pinColor, _init_extra_pinColor, _init_color, _init_extra_color, _init_curveSets, _init_extra_curveSets, _init_sortValueMultiplier, _init_extra_sortValueMultiplier, _init_centerNormal, _init_extra_centerNormal, _init_pinMaxRadius, _init_extra_pinMaxRadius, _init_pinRadius, _init_extra_pinRadius, _init_pinEffectResPath, _init_extra_pinEffectResPath, _init_geometryResPath, _init_extra_geometryResPath, _init_pinRotation, _init_extra_pinRotation, _init_pinAlphaThreshold, _init_extra_pinAlphaThreshold, _init_uvAtlasScaleOffset, _init_extra_uvAtlasScaleOffset, _init_pinEffect, _init_extra_pinEffect, _init_pickEffect, _init_extra_pickEffect;
 
-/** EveSpherePin (eve/ui) - generated from schema shapeHash 3f243d93.... */
+/** A UI sphere pin: authored SRT placement plus the pin constant record. */
 let _EveSpherePin;
 class EveSpherePin extends CjsModel {
   static {
     ({
-      e: [_init_primitiveCount, _init_extra_primitiveCount, _init_translation, _init_extra_translation, _init_rotation, _init_extra_rotation, _init_scaling, _init_extra_scaling, _init_display, _init_extra_display, _init_enablePicking, _init_extra_enablePicking, _init_name, _init_extra_name, _init_pinColor, _init_extra_pinColor, _init_color, _init_extra_color, _init_curveSets, _init_extra_curveSets, _init_sortValueMultiplier, _init_extra_sortValueMultiplier, _init_centerNormal, _init_extra_centerNormal, _init_pinMaxRadius, _init_extra_pinMaxRadius, _init_pinRadius, _init_extra_pinRadius, _init_pinEffectResPath, _init_extra_pinEffectResPath, _init_geometryResPath, _init_extra_geometryResPath, _init_pinRotation, _init_extra_pinRotation, _init_pinAlphaThreshold, _init_extra_pinAlphaThreshold, _init_uvAtlasScaleOffset, _init_extra_uvAtlasScaleOffset, _init_pinEffect, _init_extra_pinEffect, _init_pickEffect, _init_extra_pickEffect],
+      e: [_init_primitiveCount, _init_extra_primitiveCount, _init_translation, _init_extra_translation, _init_rotation, _init_extra_rotation, _init_scaling, _init_extra_scaling, _init_display, _init_extra_display, _init_enablePicking, _init_extra_enablePicking, _init_name, _init_extra_name, _init_pinColor, _init_extra_pinColor, _init_color, _init_extra_color, _init_curveSets, _init_extra_curveSets, _init_sortValueMultiplier, _init_extra_sortValueMultiplier, _init_centerNormal, _init_extra_centerNormal, _init_pinMaxRadius, _init_extra_pinMaxRadius, _init_pinRadius, _init_extra_pinRadius, _init_pinEffectResPath, _init_extra_pinEffectResPath, _init_geometryResPath, _init_extra_geometryResPath, _init_pinRotation, _init_extra_pinRotation, _init_pinAlphaThreshold, _init_extra_pinAlphaThreshold, _init_uvAtlasScaleOffset, _init_extra_uvAtlasScaleOffset, _init_pinEffect, _init_extra_pinEffect, _init_pickEffect, _init_extra_pickEffect, _initProto],
       c: [_EveSpherePin, _initClass]
     } = _applyDecs2311(this, [type.define({
       className: "EveSpherePin",
       family: "eve/ui"
-    })], [[[io, io.read, type, type.int32], 16, "primitiveCount"], [[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.boolean], 16, "display"], [[io, io.persist, type, type.boolean], 16, "enablePicking"], [[io, io.persist, type, type.string], 16, "name"], [[io, io.notify, io, io.persist, type, type.color], 16, "pinColor"], [[io, io.notify, io, io.persist, type, type.color], 16, "color"], [[io, io.persist, void 0, type.list("TriCurveSet")], 16, "curveSets"], [[io, io.persist, type, type.float32], 16, "sortValueMultiplier"], [[io, io.notify, io, io.persist, type, type.vec3], 16, "centerNormal"], [[io, io.notify, io, io.persist, type, type.float32], 16, "pinMaxRadius"], [[io, io.notify, io, io.persist, type, type.float32], 16, "pinRadius"], [[io, io.notify, io, io.persist, type, type.string], 16, "pinEffectResPath"], [[io, io.notify, io, io.persist, type, type.string], 16, "geometryResPath"], [[io, io.notify, io, io.persist, type, type.float32], 16, "pinRotation"], [[io, io.notify, io, io.persist, type, type.float32], 16, "pinAlphaThreshold"], [[io, io.notify, io, io.persist, type, type.vec4], 16, "uvAtlasScaleOffset"], [[io, io.persist, void 0, type.model("Tr2Effect")], 16, "pinEffect"], [[io, io.read, void 0, type.objectRef("Tr2Effect")], 16, "pickEffect"]], 0, void 0, CjsModel));
-  }
-  constructor(...args) {
-    super(...args);
-    _init_extra_pickEffect(this);
+    })], [[[io, io.read, type, type.int32], 16, "primitiveCount"], [[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.boolean], 16, "display"], [[io, io.persist, type, type.boolean], 16, "enablePicking"], [[io, io.persist, type, type.string], 16, "name"], [[io, io.notify, io, io.persist, type, type.color], 16, "pinColor"], [[io, io.notify, io, io.persist, type, type.color], 16, "color"], [[io, io.persist, void 0, type.list("TriCurveSet")], 16, "curveSets"], [[io, io.persist, type, type.float32], 16, "sortValueMultiplier"], [[io, io.notify, io, io.persist, type, type.vec3], 16, "centerNormal"], [[io, io.notify, io, io.persist, type, type.float32], 16, "pinMaxRadius"], [[io, io.notify, io, io.persist, type, type.float32], 16, "pinRadius"], [[io, io.notify, io, io.persist, type, type.string], 16, "pinEffectResPath"], [[io, io.notify, io, io.persist, type, type.string], 16, "geometryResPath"], [[io, io.notify, io, io.persist, type, type.float32], 16, "pinRotation"], [[io, io.notify, io, io.persist, type, type.float32], 16, "pinAlphaThreshold"], [[io, io.notify, io, io.persist, type, type.vec4], 16, "uvAtlasScaleOffset"], [[io, io.persist, void 0, type.model("Tr2Effect")], 16, "pinEffect"], [[io, io.read, void 0, type.objectRef("Tr2Effect")], 16, "pickEffect"], [[carbon, carbon.method, impl, impl.implemented], 18, "HasTransparentBatches"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Carbon reads the Tr2Renderer view-position static; the batch collector supplies the render context explicitly.")], 18, "GetSortValue"], [[carbon, carbon.method, impl, impl.notImplemented], 18, "GetBatches"], [[carbon, carbon.method, impl, impl.notImplemented], 18, "GetPickingBatches"], [[carbon, carbon.method, impl, impl.notImplemented], 18, "GetID"], [[carbon, carbon.method, impl, impl.implemented], 18, "UpdateViewDependentData"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetPerObjectData"]], 0, void 0, CjsModel));
   }
   /** m_primitiveCount (int) [READ] */
-  primitiveCount = _init_primitiveCount(this, 0);
+  primitiveCount = (_initProto(this), _init_primitiveCount(this, 0));
 
   /** m_translation (Vector3) [READWRITE, PERSIST] */
   translation = (_init_extra_primitiveCount(this), _init_translation(this, vec3.create()));
@@ -85,6 +82,74 @@ class EveSpherePin extends CjsModel {
 
   /** m_pickEffect (Tr2EffectPtr) [READ] */
   pickEffect = (_init_extra_pinEffect(this), _init_pickEffect(this, null));
+
+  /** m_worldTransform (EveSpherePin.cpp:46; ctor identity) - runtime state
+   * stamped by UpdateViewDependentData; not persisted. */
+  worldTransform = (_init_extra_pickEffect(this), mat4.create());
+
+  /** m_boundingSphere - runtime state Carbon derives from the pin geometry
+   * resource; zero until a loader/engine stamps it. Not persisted. */
+  boundingSphere = vec4.create();
+
+  /** Carbon EveSpherePin::HasTransparentBatches is always true. */
+  HasTransparentBatches() {
+    return true;
+  }
+
+  /** Carbon EveSpherePin::GetSortValue (cpp:322-332): distance from the view
+   * position to the world-transformed bounding-sphere center, scaled by the
+   * sort-value multiplier. Carbon reads the Tr2Renderer view-position static;
+   * the batch collector supplies the render context instead. */
+  GetSortValue(renderContext = null) {
+    const viewPosition = renderContext?.GetViewPosition?.();
+    if (!viewPosition) {
+      return 0;
+    }
+    const center = vec3.transformMat4(vec3.create(), [this.boundingSphere[0], this.boundingSphere[1], this.boundingSphere[2]], this.worldTransform);
+    return vec3.distance(viewPosition, center) * this.sortValueMultiplier;
+  }
+
+  /** Carbon EveSpherePin::GetBatches submits the pin geometry with the pin effect (GPU-backed). */
+  GetBatches(_accumulator, _batchType, _perObjectData, _reason) {
+    throw new Error("EveSpherePin.GetBatches is not implemented in CarbonEngineJS.");
+  }
+
+  /** Carbon EveSpherePin::GetPickingBatches submits the pick-effect geometry (GPU-backed). */
+  GetPickingBatches(_accumulator, _perObjectData) {
+    throw new Error("EveSpherePin.GetPickingBatches is not implemented in CarbonEngineJS.");
+  }
+
+  /** Carbon ITr2Pickable::GetID - the native picking identity contract. */
+  GetID() {
+    throw new Error("EveSpherePin.GetID is not implemented in CarbonEngineJS.");
+  }
+
+  /** Carbon EveSpherePin::UpdateViewDependentData (cpp:243-251):
+   * m_worldTransform = TransformationMatrix(scaling, rotation, translation) *
+   * parentTransform. Carbon (row-vector): local * parent - local first, so
+   * gl multiply(world, parent, local); Carbon (s, r, t) is gl
+   * fromRotationTranslationScale (r, t, s). The frustum argument is unused
+   * in Carbon's body and kept for signature parity. */
+  UpdateViewDependentData(_frustum, parentTransform) {
+    const local = mat4.fromRotationTranslationScale(mat4.create(), this.rotation, this.translation, this.scaling);
+    mat4.multiply(this.worldTransform, parentTransform, local);
+  }
+
+  /** Carbon EveSpherePin::GetPerObjectData (cpp:336-357). One transient
+   * payload; Set(MATRIX) performs Carbon's `Transpose(m_worldTransform)`.
+   * The struct registers with stages ["vs", "ps"]: the SAME bytes are bound
+   * to both per-object slots (cpp:415-425). */
+  GetPerObjectData(accumulator) {
+    const data = accumulator.Alloc("EveSpherePinPerObjectData");
+    data.SetAndTranspose("worldMatrix", this.worldTransform);
+    data.Set("pinPosition", [this.centerNormal[0], this.centerNormal[1], this.centerNormal[2], this.pinRadius]);
+    data.Set("pinRotation", [this.pinRotation, 0, 0, 0]);
+    data.Set("pinColor", this.pinColor);
+    data.Set("pinThreshold", [this.pinAlphaThreshold, 0, 0, 0]);
+    data.Set("pinRadiusPrecalc", [Math.sin(this.pinRadius), Math.cos(this.pinRadius), Math.sin(this.pinRotation), Math.cos(this.pinRotation)]);
+    data.Set("pinUV", this.uvAtlasScaleOffset);
+    return data;
+  }
   static {
     _initClass();
   }