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

package/dist/trinity/eve/attachment/decal/EveSpaceObjectDecal.js

@@ -3,24 +3,24 @@ import { box3 } from '#math/box3';
 import { mat4 } from '#math/mat4';
 import { quat } from '#math/quat';
 import { vec3 } from '#math/vec3';
+import { vec4 } from '#math/vec4';
 import { CjsModel } from '#model';
-import { io, type, carbon, impl } from '#schema';
-import { IEveSpaceObject2ParentData as _IEveSpaceObject2Pare } from '../../spaceObject/IEveSpaceObject2ParentData.js';
+import { edit, type, carbon, impl } from '#schema';
+import { IEveSpaceObject2ParentData } from '../../spaceObject/IEveSpaceObject2ParentData.js';
 import { TriBatchType } from '#consts/graphics';
-import { withITr2Renderable } from '../../../core/ITr2Renderable.js';
+import { ITr2Renderable } from '../../../core/ITr2Renderable.js';
 import { BuildStaticDecalGeometry, BuildDecalGeometry } from './decalIndices.js';
 
-var _withITr2Renderable;
 let _initProto, _initClass, _init_name, _init_extra_name, _init_batchType, _init_extra_batchType, _init_position, _init_extra_position, _init_minScreenSize, _init_extra_minScreenSize, _init_rotation, _init_extra_rotation, _init_scaling, _init_extra_scaling, _init_parentBoneIndex, _init_extra_parentBoneIndex, _init_decalEffect, _init_extra_decalEffect, _init_display, _init_extra_display, _init_staticIndexBuffers, _init_extra_staticIndexBuffers;
 
-/**
- * A decal projected onto a parent hull, owning its oriented projection matrix,
- * optional bone attachment, per-LOD triangle index lists and screen-size
- * visibility ramp.
+/**
+ * A decal projected onto a parent hull, owning its oriented projection matrix,
+ * optional bone attachment, per-LOD triangle index lists and screen-size
+ * visibility ramp.
  */
 let _EveSpaceObjectDecal;
 new class extends _identity {
-  static [class EveSpaceObjectDecal extends (_withITr2Renderable = withITr2Renderable(CjsModel)) {
+  static [class EveSpaceObjectDecal extends CjsModel {
     static {
       ({
         e: [_init_name, _init_extra_name, _init_batchType, _init_extra_batchType, _init_position, _init_extra_position, _init_minScreenSize, _init_extra_minScreenSize, _init_rotation, _init_extra_rotation, _init_scaling, _init_extra_scaling, _init_parentBoneIndex, _init_extra_parentBoneIndex, _init_decalEffect, _init_extra_decalEffect, _init_display, _init_extra_display, _init_staticIndexBuffers, _init_extra_staticIndexBuffers, _initProto],
@@ -28,11 +28,11 @@ new class extends _identity {
       } = _applyDecs2311(this, [type.define({
         className: "EveSpaceObjectDecal",
         family: "eve/attachment/decal"
-      })], [[[io, io.persist, type, type.string], 16, "name"], [[io, io.read, type, type.int32, void 0, type.enum("TriBatchType")], 16, "batchType"], [[io, io.notify, io, io.persist, type, type.vec3], 16, "position"], [[io, io.persist, type, type.float32], 16, "minScreenSize"], [[io, io.notify, io, io.persist, type, type.quat], 16, "rotation"], [[io, io.notify, io, io.persist, type, type.vec3], 16, "scaling"], [[io, io.persist, type, type.int32], 16, "parentBoneIndex"], [[void 0, io.rebuild("packedGeometry"), io, io.persist, void 0, type.objectRef("Tr2Effect")], 16, "decalEffect"], [[io, io.readwrite, type, type.boolean], 16, "display"], [[void 0, io.rebuild("packedGeometry"), io, io.persist, void 0, type.array("unknown")], 16, "staticIndexBuffers"], [[carbon, carbon.method, impl, impl.adapted], 18, "Initialize"], [[carbon, carbon.method, impl, impl.adapted], 18, "OnModified"], [[carbon, carbon.method, impl, impl.adapted], 18, "CopyFrom"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetPosition"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetPosition"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetRotation"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetRotation"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetScaling"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetDecalMatrix"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetInverseDecalMatrix"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetScaling"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetBoneIndex"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetBoneIndex"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetIndices"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetStaticIndexBuffers"], [[carbon, carbon.method, impl, impl.adapted], 18, "HasStaticIndexBuffers"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetDecalPrimitiveCounts"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetMinScreenSize"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetEffect"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetShaderOption"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetBatchType"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetPriority"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetBoneMatrix"], [[carbon, carbon.method, impl, impl.implemented], 18, "UpdateVisibility"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Carbon reads the m_isVisible member directly; JavaScript exposes the private runtime value through an accessor.")], 18, "GetVisibility"], [[carbon, carbon.method, impl, impl.implemented], 18, "HasTransparentBatches"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetSortValue"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetID"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetPerObjectData"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Trinity selects the LOD and builds the index list; the engine owns the device index buffer, so validity is judged on the built list rather than on a GPU allocation.")], 18, "GetRenderables"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetHighDetailDecalState"], [[carbon, carbon.method, impl, impl.notImplemented], 18, "GetBatches"], [[carbon, carbon.method, impl, impl.notImplemented], 18, "GetPickingBatches"]], 0, void 0, _withITr2Renderable));
+      }), carbon.inherit(ITr2Renderable)], [[[edit, edit.persist, type, type.string], 16, "name"], [[edit, edit.read, type, type.int32, void 0, type.enum("TriBatchType")], 16, "batchType"], [[edit, edit.notify, edit, edit.persist, type, type.vec3], 16, "position"], [[edit, edit.persist, type, type.float32], 16, "minScreenSize"], [[edit, edit.notify, edit, edit.persist, type, type.quat], 16, "rotation"], [[edit, edit.notify, edit, edit.persist, type, type.vec3], 16, "scaling"], [[edit, edit.persist, type, type.int32], 16, "parentBoneIndex"], [[edit, edit.persist, void 0, type.objectRef("Tr2Effect")], 16, "decalEffect"], [[edit, edit.readwrite, type, type.boolean], 16, "display"], [[edit, edit.persist, void 0, type.array("unknown")], 16, "staticIndexBuffers"], [[carbon, carbon.method, impl, impl.adapted], 18, "Initialize"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("JS identifies placement members by their exposed names; dynamic geometry remains a class-owned cache."), void 0, impl.invalidates("#decalGeometry")], 18, "OnModified"], [[carbon, carbon.method, impl, impl.adapted], 18, "CopyFrom"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetPosition"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetPosition"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetRotation"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetRotation"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetScaling"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetDecalMatrix"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetInverseDecalMatrix"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetScaling"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetBoneIndex"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetBoneIndex"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetIndices"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetStaticIndexBuffers"], [[carbon, carbon.method, impl, impl.adapted], 18, "HasStaticIndexBuffers"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetDecalPrimitiveCounts"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetMinScreenSize"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetEffect"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetShaderOption"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetBatchType"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetPriority"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetBoneMatrix"], [[carbon, carbon.method, impl, impl.implemented], 18, "UpdateVisibility"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Carbon reads the m_isVisible member directly; JavaScript exposes the private runtime value through an accessor.")], 18, "GetVisibility"], [[carbon, carbon.method, impl, impl.implemented], 18, "HasTransparentBatches"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetSortValue"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetID"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetPerObjectData"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Trinity selects the LOD and builds the index list; the engine owns the device index buffer, so validity is judged on the built list rather than on a GPU allocation.")], 18, "GetRenderables"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetHighDetailDecalState"], [[carbon, carbon.method, impl, impl.notImplemented], 18, "GetBatches"], [[carbon, carbon.method, impl, impl.notImplemented], 18, "GetPickingBatches"]], 0, void 0, CjsModel));
     }
-    /**
-     * Establishes Carbon's opaque decal batch type after schema initialization,
-     * because the schema's legacy TriBatchType default is 0.
+    /**
+     * Establishes Carbon's opaque decal batch type after schema initialization,
+     * because the schema's legacy TriBatchType default is 0.
      */
     constructor() {
       super();
@@ -52,6 +52,7 @@ new class extends _identity {
 
     // SOF-authored per-LOD triangle indices; persisted so the values
     // interchange reproduces Carbon's hidden decal geometry selection.
+
     staticIndexBuffers = (_init_extra_display(this), _init_staticIndexBuffers(this, []));
     #decalMatrix = (_init_extra_staticIndexBuffers(this), mat4.create());
     #inverseDecalMatrix = mat4.create();
@@ -69,65 +70,68 @@ new class extends _identity {
     /** m_isGeometryFrozen (bool) - pins the decal to LOD 0. */
     #isGeometryFrozen = false;
 
-    /** m_parentData (EveSpaceObjectDecal.h:178) - copied by value from the
-     * owning space object each frame; zeroed with an identity transform by
+    /** m_parentData (EveSpaceObjectDecal.h:178) - copied by value from the
+     * owning space object each frame; zeroed with an identity transform by
      * Carbon's constructor (cpp:56-57). Runtime state, never persisted. */
-    #parentData = new _IEveSpaceObject2Pare();
+    #parentData = new IEveSpaceObject2ParentData();
 
-    /** m_parentBoneMatrix (h:190) - the animated parent bone this decal rides,
+    /** m_parentBoneMatrix (h:190) - the animated parent bone this decal rides,
      * identity until SetBoneMatrix supplies one. */
     #parentBoneMatrix = mat4.create();
 
-    /** m_isVisible (h:204) - a float, not a bool: the non-LOD paths set exactly
+    /** m_isVisible (h:204) - a float, not a bool: the non-LOD paths set exactly
      * 0 or 1 while the LOD path writes a 0..1 fade ramp (cpp:119-176). */
     #isVisible = 0;
 
-    /** m_minBounds / m_maxBounds (h:215) - the geometry mesh bounds an instanced
+    /** m_minBounds / m_maxBounds (h:215) - the geometry mesh bounds an instanced
      * decal measures instead of the unit cube. Stamped by the loader. */
     #minBounds = vec3.create();
     #maxBounds = vec3.create();
 
-    /** m_instanceData (h:212) - non-null selects the instanced visibility path.
-     * The instance buffer itself is engine-owned; the graph only needs to know
+    /** m_instanceData (h:212) - non-null selects the instanced visibility path.
+     * The instance buffer itself is not ported yet; the graph only needs to know
      * whether one is attached. */
     #instanceData = null;
 
-    /** Carbon m_invParentBoneMatrix (h:191) is declared but never assigned; the
-     * value the shader sees is recomputed per fill (cpp:366), so this port keeps
+    /** Carbon m_invParentBoneMatrix (h:191) is declared but never assigned; the
+     * value the shader sees is recomputed per fill (cpp:366), so this port keeps
      * no member for it. */
     #inverseParentBoneMatrix = mat4.create();
-    #shLightingScratch = new Float32Array(_IEveSpaceObject2Pare.SH_COEFFICIENT_COUNT * 4);
+    #shLightingScratch = new Float32Array(IEveSpaceObject2ParentData.SH_COEFFICIENT_COUNT * 4);
 
-    /**
-     * Property form of HasStaticIndexBuffers: whether any LOD carries decal
-     * triangle indices.
+    /**
+     * Property form of HasStaticIndexBuffers: whether any LOD carries decal
+     * triangle indices.
      */
     get hasStaticIndexBuffers() {
       return this.HasStaticIndexBuffers();
     }
 
-    /**
-     * Builds the decal matrix and its inverse from the authored position, rotation
-     * and scaling; returns false when the composed matrix is not invertible.
+    /**
+     * Builds the decal matrix and its inverse from the authored position, rotation
+     * and scaling; returns false when the composed matrix is not invertible.
      */
     Initialize() {
       return this.#updateDecalMatrix();
     }
 
-    /**
-     * Rebuilds the decal matrix and its inverse after an authored placement
-     * change.
+    /**
+     * Rebuilds the decal matrix and its inverse after an authored placement
+     * change.
      */
-    OnModified(_options = {}) {
-      this.#updateDecalMatrix();
+    OnModified(propertyName) {
+      if (propertyName === "position" || propertyName === "rotation" || propertyName === "scaling") {
+        this.#updateDecalMatrix();
+        if (!this.HasStaticIndexBuffers()) this.#decalGeometry = null;
+      }
       return true;
     }
 
-    /**
-     * Copies another decal's authored description - name, display, placement, bone
-     * index, minimum screen size, effect and batch type - and rebuilds the decal
-     * matrix; the per-LOD index buffers are not copied. Returns false when source
-     * is missing.
+    /**
+     * Copies another decal's authored description - name, display, placement, bone
+     * index, minimum screen size, effect and batch type - and rebuilds the decal
+     * matrix; the per-LOD index buffers are not copied. Returns false when source
+     * is missing.
      */
     CopyFrom(source) {
       if (!source) return false;
@@ -143,110 +147,110 @@ new class extends _identity {
       return this.#updateDecalMatrix();
     }
 
-    /**
-     * Copies the authored decal position into the caller-owned out vector and
-     * returns it.
+    /**
+     * Copies the authored decal position into the caller-owned out vector and
+     * returns it.
      */
     GetPosition(out = vec3.create()) {
       return vec3.copy(out, this.position);
     }
 
-    /**
-     * Sets the authored decal position and rebuilds the decal matrix; a missing
-     * value is taken as the origin.
+    /**
+     * Sets the authored decal position and rebuilds the decal matrix; a missing
+     * value is taken as the origin.
      */
     SetPosition(value) {
       vec3.copy(this.position, value || _EveSpaceObjectDecal.#zero);
       return this.#updateDecalMatrix();
     }
 
-    /**
-     * Copies the authored decal rotation into the caller-owned out quaternion and
-     * returns it.
+    /**
+     * Copies the authored decal rotation into the caller-owned out quaternion and
+     * returns it.
      */
     GetRotation(out = quat.create()) {
       return quat.copy(out, this.rotation);
     }
 
-    /**
-     * Sets the authored decal rotation and rebuilds the decal matrix; a missing
-     * value is taken as the identity rotation.
+    /**
+     * Sets the authored decal rotation and rebuilds the decal matrix; a missing
+     * value is taken as the identity rotation.
      */
     SetRotation(value) {
       quat.copy(this.rotation, value || _EveSpaceObjectDecal.#identityRotation);
       return this.#updateDecalMatrix();
     }
 
-    /**
-     * Copies the authored decal scaling into the caller-owned out vector and
-     * returns it.
+    /**
+     * Copies the authored decal scaling into the caller-owned out vector and
+     * returns it.
      */
     GetScaling(out = vec3.create()) {
       return vec3.copy(out, this.scaling);
     }
 
-    /**
-     * Copies the decal's projection matrix into out; the value is only current as
-     * of the last Initialize, OnModified or placement setter.
+    /**
+     * Copies the decal's projection matrix into out; the value is only current as
+     * of the last Initialize, OnModified or placement setter.
      */
     GetDecalMatrix(out = mat4.create()) {
       return mat4.copy(out, this.#decalMatrix);
     }
 
-    /**
-     * Copies the inverse of the decal's projection matrix into out, which is what
-     * maps hull-space positions into the decal's unit cube.
+    /**
+     * Copies the inverse of the decal's projection matrix into out, which is what
+     * maps hull-space positions into the decal's unit cube.
      */
     GetInverseDecalMatrix(out = mat4.create()) {
       return mat4.copy(out, this.#inverseDecalMatrix);
     }
 
-    /**
-     * Sets the authored decal scaling and rebuilds the decal matrix; a missing
-     * value is taken as unit scale.
+    /**
+     * Sets the authored decal scaling and rebuilds the decal matrix; a missing
+     * value is taken as unit scale.
      */
     SetScaling(value) {
       vec3.copy(this.scaling, value || _EveSpaceObjectDecal.#one);
       return this.#updateDecalMatrix();
     }
 
-    /**
-     * The parent mesh bone the decal rides, or -1 when it rides the hull transform
-     * directly.
+    /**
+     * The parent mesh bone the decal rides, or -1 when it rides the hull transform
+     * directly.
      */
     GetBoneIndex() {
       return this.parentBoneIndex;
     }
 
-    /**
-     * Sets the parent mesh bone the decal rides; the bone matrix itself is only
-     * picked up on the next SetBoneMatrix.
+    /**
+     * Sets the parent mesh bone the decal rides; the bone matrix itself is only
+     * picked up on the next SetBoneMatrix.
      */
     SetBoneIndex(index) {
       this.parentBoneIndex = Number(index) | 0;
       return true;
     }
 
-    /**
-     * Replaces the SOF-authored triangle index lists, one array per LOD, coercing
-     * each entry to an unsigned integer.
+    /**
+     * Replaces the SOF-authored triangle index lists, one array per LOD, coercing
+     * each entry to an unsigned integer.
      */
     SetIndices(indices) {
       this.staticIndexBuffers = Array.from(indices || [], lod => Array.from(lod || [], value => Number(value) >>> 0));
       return true;
     }
 
-    /**
-     * The per-LOD triangle index lists as fresh copies, so a caller cannot mutate
-     * the stored buffers.
+    /**
+     * The per-LOD triangle index lists as fresh copies, so a caller cannot mutate
+     * the stored buffers.
      */
     GetStaticIndexBuffers() {
       return this.staticIndexBuffers.map(lod => lod.slice());
     }
 
-    /**
-     * Whether any LOD carries triangle indices; a decal without them has no
-     * geometry to draw.
+    /**
+     * Whether any LOD carries triangle indices; a decal without them has no
+     * geometry to draw.
      */
     HasStaticIndexBuffers() {
       return this.staticIndexBuffers.some(lod => lod.length > 0);
@@ -257,9 +261,9 @@ new class extends _identity {
       return this.staticIndexBuffers.map(lod => Math.trunc(lod.length / 3));
     }
 
-    /**
-     * Sets the LOD threshold in screen pixels below which UpdateVisibility culls
-     * the decal; zero disables the test and makes the decal always visible.
+    /**
+     * Sets the LOD threshold in screen pixels below which UpdateVisibility culls
+     * the decal; zero disables the test and makes the decal always visible.
      */
     SetMinScreenSize(value) {
       this.minScreenSize = Number(value) || 0;
@@ -272,9 +276,9 @@ new class extends _identity {
       return true;
     }
 
-    /**
-     * Sets a shader option on the decal effect; returns false when no effect that
-     * accepts options is attached.
+    /**
+     * Sets a shader option on the decal effect; returns false when no effect that
+     * accepts options is attached.
      */
     SetShaderOption(name, value) {
       if (!this.decalEffect?.SetOption) return false;
@@ -282,26 +286,26 @@ new class extends _identity {
       return true;
     }
 
-    /**
-     * Sets the TriBatchType the decal submits under, overriding the opaque default
-     * the constructor establishes.
+    /**
+     * Sets the TriBatchType the decal submits under, overriding the opaque default
+     * the constructor establishes.
      */
     SetBatchType(value) {
       this.batchType = Number(value) | 0;
       return true;
     }
 
-    /**
-     * Sets the draw priority the engine sorts decals on; the value is runtime-only
-     * and never persisted.
+    /**
+     * Sets the draw priority the engine sorts decals on; the value is runtime-only
+     * and never persisted.
      */
     SetPriority(value) {
       this.#priority = Number(value) >>> 0;
       return true;
     }
 
-    /** Carbon EveSpaceObjectDecal::SetBoneMatrix (cpp:475-491): expands the
-     * parent's Float4x3 mesh bone at m_parentBoneIndex into the 4x4 bone matrix.
+    /** Carbon EveSpaceObjectDecal::SetBoneMatrix (cpp:475-491): expands the
+     * parent's Float4x3 mesh bone at m_parentBoneIndex into the 4x4 bone matrix.
      * A -1 index or an out-of-range index leaves the identity in place. */
     SetBoneMatrix(boneMatrices, boneMatrixCount) {
       if (this.parentBoneIndex === -1 || this.parentBoneIndex >= boneMatrixCount) {
@@ -328,25 +332,35 @@ new class extends _identity {
       return true;
     }
 
-    /** Carbon copies the parent data by value at the two points UpdateVisibility
-     * accepts the decal (cpp:145, cpp:178). shLighting is a borrowed pointer into
-     * the parent's own PS data, so it is carried by reference exactly as Carbon
-     * carries the pointer. */
+    /** Carbon copies the parent data by value at the two points UpdateVisibility
+     * accepts the decal (cpp:145, cpp:178): `m_parentData = *parentData`. Member
+     * by member is that struct copy - no export, no allocation, on a per-decal
+     * per-frame path. shLighting is a borrowed pointer into the parent's own PS
+     * data, so it is carried by reference exactly as Carbon carries the pointer. */
     #CopyParentData(parentData) {
-      if (this.#parentData.SetValues) this.#parentData.SetValues(parentData);else Object.assign(this.#parentData, parentData);
-      this.#parentData.shLighting = parentData.shLighting ?? null;
-    }
-
-    /**
-     * Carbon EveSpaceObjectDecal::UpdateVisibility (cpp:117-179).
-     *
-     * `m_isVisible` is a FLOAT: zero when culled, one when no minimum screen
-     * size is authored, otherwise a 0..1 fade ramp that reaches the shader as
-     * displayData.y. The ramp has no lower clamp because the below-minimum case
-     * already returned.
-     *
-     * On every cull path Carbon leaves m_parentData STALE - only the visibility
-     * is cleared - so the copy happens solely on the accept paths.
+      const own = this.#parentData;
+      mat4.copy(own.transform, parentData.transform);
+      own.killCount = parentData.killCount;
+      vec4.copy(own.shipData, parentData.shipData);
+      vec3.copy(own.clipSphereCenter, parentData.clipSphereCenter);
+      own.clipRadiusSq = parentData.clipRadiusSq;
+      own.clipRadius2Sq = parentData.clipRadius2Sq;
+      own.clipFactor = parentData.clipFactor;
+      own.clipFactor2 = parentData.clipFactor2;
+      own.shLighting = parentData.shLighting;
+      vec4.copy(own.customData, parentData.customData);
+    }
+
+    /**
+     * Carbon EveSpaceObjectDecal::UpdateVisibility (cpp:117-179).
+     *
+     * `m_isVisible` is a FLOAT: zero when culled, one when no minimum screen
+     * size is authored, otherwise a 0..1 fade ramp that reaches the shader as
+     * displayData.y. The ramp has no lower clamp because the below-minimum case
+     * already returned.
+     *
+     * On every cull path Carbon leaves m_parentData STALE - only the visibility
+     * is cleared - so the copy happens solely on the accept paths.
      */
     UpdateVisibility(updateContext, parentData) {
       this.#isVisible = 0;
@@ -426,23 +440,23 @@ new class extends _identity {
       return 1;
     }
 
-    /** Carbon ITr2Pickable::GetID is inline on the decal (h:113-116) and returns
+    /** Carbon ITr2Pickable::GetID is inline on the decal (h:113-116) and returns
      * the object itself; the area id selects nothing on this class. */
     GetID(_areaId) {
       return this;
     }
 
-    /**
-     * Carbon EveSpaceObjectDecal::GetPerObjectData (cpp:346-386): the
-     * EveDecalPerObjectData composite - a DecalVSPerObjectData +
-     * DecalPSPerObjectData pair uploaded as TWO constant buffers (cpp:975-976).
-     * Here that is two Allocs returned as a { vs, ps } record.
-     *
-     * SetAndTranspose performs Carbon's Transpose. Carbon computes the two
-     * inverses FROM the already-transposed matrices; because Inverse(M-transpose)
-     * equals Inverse(M)-transpose (carbon-math-conventions F2), inverting the
-     * logical matrix and letting the encoder transpose produces byte-identical
-     * output with one transpose less work.
+    /**
+     * Carbon EveSpaceObjectDecal::GetPerObjectData (cpp:346-386): the
+     * EveDecalPerObjectData composite - a DecalVSPerObjectData +
+     * DecalPSPerObjectData pair uploaded as TWO constant buffers (cpp:975-976).
+     * Here that is two Allocs returned as a { vs, ps } record.
+     *
+     * SetAndTranspose performs Carbon's Transpose. Carbon computes the two
+     * inverses FROM the already-transposed matrices; because Inverse(M-transpose)
+     * equals Inverse(M)-transpose (carbon-math-conventions F2), inverting the
+     * logical matrix and letting the encoder transpose produces byte-identical
+     * output with one transpose less work.
      */
     GetPerObjectData(accumulator) {
       const vs = accumulator.Alloc("DecalVSPerObjectData");
@@ -487,24 +501,24 @@ new class extends _identity {
       };
     }
 
-    /**
-     * Adds this decal to the renderable list once its geometry is ready.
-     *
-     * Carbon EveSpaceObjectDecal::GetRenderables (cpp:182-225). EveSpaceObject2
-     * already calls this per decal with the hull's geometry resource and mesh
-     * screen size (cpp:1578-1591); ours does the same.
-     *
-     * The decal is a RENDERABLE, not a batch source the parent drains: it puts
-     * itself in the list and the renderer asks it for batches later, which is why
-     * everything expensive happens here and GetBatches only submits.
-     *
-     * @param {Array} out Renderable list.
-     * @param {object} _meshCache Carbon's DecalMeshCache, only used by the
-     *   selection path to avoid re-mapping hull buffers; unused here because a
-     *   decoded payload is already CPU-side.
-     * @param {object} geometryResource The hull's geometry.
-     * @param {number} screenSize The parent's mesh screen size, for LOD choice.
-     * @returns {boolean} Whether the decal was added.
+    /**
+     * Adds this decal to the renderable list once its geometry is ready.
+     *
+     * Carbon EveSpaceObjectDecal::GetRenderables (cpp:182-225). EveSpaceObject2
+     * already calls this per decal with the hull's geometry resource and mesh
+     * screen size (cpp:1578-1591); ours does the same.
+     *
+     * The decal is a RENDERABLE, not a batch source the parent drains: it puts
+     * itself in the list and the renderer asks it for batches later, which is why
+     * everything expensive happens here and GetBatches only submits.
+     *
+     * @param {Array} out Renderable list.
+     * @param {object} _meshCache Carbon's DecalMeshCache, only used by the
+     *   selection path to avoid re-mapping hull buffers; unused here because a
+     *   decoded payload is already CPU-side.
+     * @param {object} geometryResource The hull's geometry.
+     * @param {number} screenSize The parent's mesh screen size, for LOD choice.
+     * @returns {boolean} Whether the decal was added.
      */
     GetRenderables(out = [], _meshCache = null, geometryResource = null, screenSize = Infinity) {
       if (this.#isVisible <= 0 || !geometryResource) return false;
@@ -531,15 +545,15 @@ new class extends _identity {
       return true;
     }
 
-    /**
-     * Builds the decal's index list for the hull it is attached to.
-     *
-     * The static lists win when present, exactly as Carbon orders it: every decal
-     * on a shipped hull arrives with them, and triangle selection sits behind the
-     * g_buildDecalBuffers global for decals placed at runtime (cpp:196-207).
-     *
-     * @param {object} mesh Decoded mesh data.
-     * @returns {object|null} Built geometry, or null when there is nothing to draw.
+    /**
+     * Builds the decal's index list for the hull it is attached to.
+     *
+     * The static lists win when present, exactly as Carbon orders it: every decal
+     * on a shipped hull arrives with them, and triangle selection sits behind the
+     * g_buildDecalBuffers global for decals placed at runtime (cpp:196-207).
+     *
+     * @param {object} mesh Decoded mesh data.
+     * @returns {object|null} Built geometry, or null when there is nothing to draw.
      */
     #BuildGeometry(mesh) {
       if (!mesh) return null;
@@ -559,21 +573,21 @@ new class extends _identity {
       return true;
     }
 
-    /** Carbon EveSpaceObjectDecal::GetBatches (cpp:250-331) submits the packed
+    /** Carbon EveSpaceObjectDecal::GetBatches (cpp:250-331) submits the packed
      * decal index buffers against the device geometry resource. */
     GetBatches(_batches, _batchType, _perObjectData, _reason) {
       throw new Error("EveSpaceObjectDecal.GetBatches is not implemented in CarbonEngineJS.");
     }
 
-    /** Carbon EveSpaceObjectDecal::GetPickingBatches (cpp:919-926) forwards to
+    /** Carbon EveSpaceObjectDecal::GetPickingBatches (cpp:919-926) forwards to
      * GetBatches once the attachment pick-type mask passes. */
     GetPickingBatches(_batches, _pickTypes, _perObjectData) {
       throw new Error("EveSpaceObjectDecal.GetPickingBatches is not implemented in CarbonEngineJS.");
     }
 
-    /**
-     * Recomposes the decal matrix from the authored rotation, position and scaling
-     * and inverts it; returns whether the inverse existed.
+    /**
+     * Recomposes the decal matrix from the authored rotation, position and scaling
+     * and inverts it; returns whether the inverse existed.
      */
     #updateDecalMatrix() {
       mat4.fromRotationTranslationScale(this.#decalMatrix, this.rotation, this.position, this.scaling);