@carbonenginejs/runtime-trinity 0.6.0 → 0.8.0

package/dist/{generated/eve/scene → eve/scene/components}/EveComponentRegistry.js

@@ -2,11 +2,11 @@ import { applyDecs2311 as _applyDecs2311 } from '../../../_virtual/_rollupPlugin
 import { impl, carbon, type } from '@carbonenginejs/runtime-utils/schema';
 import { CjsModel } from '@carbonenginejs/runtime-utils/model';
 import { EveComponentCollection as _EveComponentCollecti } from './EveComponentCollection.js';
-import { EveComponentRequiredMethods } from '../../../eve/EveComponentTypes.js';
+import { EveComponentRequiredMethods } from '../../EveComponentTypes.js';
 
 let _initProto, _initClass, _init_componentCollectionLoopGuard, _init_extra_componentCollectionLoopGuard, _init_registeredEntities, _init_extra_registeredEntities;
 
-/** EveComponentRegistry (eve/scene) - generated from schema shapeHash abca1458.... */
+/** Indexes Eve entities and their component collections for scene processing. */
 let _EveComponentRegistry;
 class EveComponentRegistry extends CjsModel {
   static {
@@ -29,6 +29,11 @@ class EveComponentRegistry extends CjsModel {
 
   /** m_registeredEntities (std::vector<EveEntity*>) */
   registeredEntities = (_init_extra_componentCollectionLoopGuard(this), _init_registeredEntities(this, []));
+
+  /**
+   * Empties every component collection and detaches all registered entities,
+   * resetting their registry link and component state.
+   */
   Clear() {
     for (const collection of this.#componentCollections) {
       collection.Clear();
@@ -42,10 +47,20 @@ class EveComponentRegistry extends CjsModel {
     }
     this.registeredEntities.length = 0;
   }
+
+  /**
+   * Removes the entity from this registry and adds it back, moving it to the end
+   * of the registration order.
+   */
   ReRegister(entity) {
     entity.UnRegister(this);
     entity.Register(this);
   }
+
+  /**
+   * Adds an entity to the registry and records its index, returning false if the
+   * entity is already registered anywhere.
+   */
   Register(entity) {
     if (entity.indexInRegistry !== -1) {
       return false;
@@ -55,6 +70,12 @@ class EveComponentRegistry extends CjsModel {
     this.registeredEntities.push(entity);
     return true;
   }
+
+  /**
+   * Removes an entity by swapping the last registered entity into its slot,
+   * keeping the entity list dense, and returns false if the entity is not
+   * registered here.
+   */
   UnRegister(entity) {
     const index = entity.indexInRegistry;
     if (entity.registry !== this || index < 0 || index >= this.registeredEntities.length) {
@@ -71,14 +92,31 @@ class EveComponentRegistry extends CjsModel {
     entity.indexInRegistry = -1;
     return true;
   }
+
+  /**
+   * Drops the entity from every component collection while leaving it registered
+   * in the entity list.
+   */
   UnRegisterAllComponents(entity) {
     for (const collection of this.#componentCollections) {
       this.RemoveFromCollection(collection, entity);
     }
   }
+
+  /**
+   * Returns the collection for a component name, or null when no collection has
+   * been created for it yet.
+   */
   GetComponentCollection(componentName) {
     return this.#componentCollections.find(collection => collection.name === componentName) ?? null;
   }
+
+  /**
+   * Adds an entity to the named component's collection, creating the collection
+   * on demand, and throws if the entity is missing any method the component
+   * interface requires - the fail-closed stand-in for Carbon's compile-time
+   * RegisterComponent<T> constraint.
+   */
   RegisterComponent(componentName, entity) {
     // Fail-closed duck assertion: Carbon's RegisterComponent<T> cannot compile
     // for an entity that does not implement T; the JS port asserts the
@@ -96,10 +134,21 @@ class EveComponentRegistry extends CjsModel {
     }
     return this.AddToCollection(collection, entity);
   }
+
+  /**
+   * Removes an entity from the named component's collection, returning false
+   * when no such collection exists.
+   */
   UnRegisterComponent(componentName, entity) {
     const collection = this.GetComponentCollection(componentName);
     return collection ? this.RemoveFromCollection(collection, entity) : false;
   }
+
+  /**
+   * Creates a collection for a component name and assigns it the next free bit;
+   * throws once 32 collections exist because the entity component mask is 32
+   * bits wide.
+   */
   AddCollection(componentName) {
     if (this.#componentCollections.length >= 32) {
       throw new RangeError("EveComponentRegistry supports at most 32 component collections.");
@@ -110,6 +159,12 @@ class EveComponentRegistry extends CjsModel {
     this.#componentCollections.push(collection);
     return collection;
   }
+
+  /**
+   * Appends an entity to a collection and stores the resulting index on the
+   * entity under the collection's bit, returning false if it is already a
+   * member.
+   */
   AddToCollection(collection, entity) {
     if (entity.GetComponentIndex(collection.GetBit()) !== undefined) {
       return false;
@@ -118,6 +173,12 @@ class EveComponentRegistry extends CjsModel {
     entity.SetComponentState(collection.GetBit(), index);
     return true;
   }
+
+  /**
+   * Removes an entity from a collection by swapping the back element into its
+   * slot and fixing up the moved entity's stored index, returning false if it
+   * was not a member.
+   */
   RemoveFromCollection(collection, entity) {
     const bit = collection.GetBit();
     const index = entity.GetComponentIndex(bit);
@@ -131,9 +192,20 @@ class EveComponentRegistry extends CjsModel {
     entity.RemoveComponentState(bit);
     return true;
   }
+
+  /**
+   * Returns the live entity array backing the named component collection, or an
+   * empty array when the collection does not exist; the array is borrowed and
+   * changes as entities register.
+   */
   GetComponents(componentName) {
     return this.GetComponentCollection(componentName)?.collection ?? [];
   }
+
+  /**
+   * Returns how many entities are in the named component collection, or 0 when
+   * the collection does not exist.
+   */
   ComponentCount(componentName) {
     return this.GetComponentCollection(componentName)?.Size() ?? 0;
   }

package/dist/eve/scene/components/EveComponentRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EveComponentRegistry.js","sources":["../../../../../src/eve/scene/components/EveComponentRegistry.js"],"sourcesContent":["// Ported from CarbonEngine (MIT, (c) 2026 CCP Games) - https://github.com/carbonengine/trinity\r\n// Source: trinity/trinity/Eve/EveComponentRegistry.h\r\n// Source: trinity/trinity/Eve/EveComponentRegistry.cpp\r\n// Hand-maintained after promotion from generated schema intake.\r\nimport { carbon, impl, type } from \"@carbonenginejs/runtime-utils/schema\";\r\nimport { CjsModel } from \"@carbonenginejs/runtime-utils/model\";\r\nimport { EveComponentCollection } from \"./EveComponentCollection.js\";\r\nimport { EveComponentRequiredMethods } from \"../../EveComponentTypes.js\";\r\n\r\n/** Indexes Eve entities and their component collections for scene processing. */\r\n@type.define({ className: \"EveComponentRegistry\", family: \"eve/scene\" })\r\nexport class EveComponentRegistry extends CjsModel\r\n{\r\n\r\n  #componentCollections = [];\r\n\r\n  /** m_componentCollectionLoopGuard (mutable std::shared_mutex) */\r\n  @type.rawStruct(\"std::shared_mutex\")\r\n  componentCollectionLoopGuard = null;\r\n\r\n  /** m_registeredEntities (std::vector<EveEntity*>) */\r\n  @type.list(\"EveEntity\")\r\n  registeredEntities = [];\r\n\r\n  /**\r\n   * Empties every component collection and detaches all registered entities,\r\n   * resetting their registry link and component state.\r\n   */\r\n  @impl.implemented\r\n  Clear()\r\n  {\r\n    for (const collection of this.#componentCollections)\r\n    {\r\n      collection.Clear();\r\n    }\r\n    for (const entity of this.registeredEntities)\r\n    {\r\n      if (entity.registry === this)\r\n      {\r\n        entity.registry = null;\r\n        entity.indexInRegistry = -1;\r\n        entity.ClearComponentState();\r\n      }\r\n    }\r\n    this.registeredEntities.length = 0;\r\n  }\r\n\r\n  /**\r\n   * Removes the entity from this registry and adds it back, moving it to the end\r\n   * of the registration order.\r\n   */\r\n  @impl.implemented\r\n  ReRegister(entity)\r\n  {\r\n    entity.UnRegister(this);\r\n    entity.Register(this);\r\n  }\r\n\r\n  /**\r\n   * Adds an entity to the registry and records its index, returning false if the\r\n   * entity is already registered anywhere.\r\n   */\r\n  @impl.implemented\r\n  Register(entity)\r\n  {\r\n    if (entity.indexInRegistry !== -1)\r\n    {\r\n      return false;\r\n    }\r\n    entity.registry = this;\r\n    entity.indexInRegistry = this.registeredEntities.length;\r\n    this.registeredEntities.push(entity);\r\n    return true;\r\n  }\r\n\r\n  /**\r\n   * Removes an entity by swapping the last registered entity into its slot,\r\n   * keeping the entity list dense, and returns false if the entity is not\r\n   * registered here.\r\n   */\r\n  @impl.implemented\r\n  UnRegister(entity)\r\n  {\r\n    const index = entity.indexInRegistry;\r\n    if (entity.registry !== this || index < 0 || index >= this.registeredEntities.length)\r\n    {\r\n      return false;\r\n    }\r\n    const lastIndex = this.registeredEntities.length - 1;\r\n    if (index !== lastIndex)\r\n    {\r\n      const swappedEntity = this.registeredEntities[lastIndex];\r\n      swappedEntity.indexInRegistry = index;\r\n      this.registeredEntities[index] = swappedEntity;\r\n    }\r\n    this.registeredEntities.pop();\r\n    entity.registry = null;\r\n    entity.indexInRegistry = -1;\r\n    return true;\r\n  }\r\n\r\n  /**\r\n   * Drops the entity from every component collection while leaving it registered\r\n   * in the entity list.\r\n   */\r\n  @impl.implemented\r\n  UnRegisterAllComponents(entity)\r\n  {\r\n    for (const collection of this.#componentCollections)\r\n    {\r\n      this.RemoveFromCollection(collection, entity);\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Returns the collection for a component name, or null when no collection has\r\n   * been created for it yet.\r\n   */\r\n  @impl.implemented\r\n  GetComponentCollection(componentName)\r\n  {\r\n    return this.#componentCollections.find(collection => collection.name === componentName) ?? null;\r\n  }\r\n\r\n  /**\r\n   * Adds an entity to the named component's collection, creating the collection\r\n   * on demand, and throws if the entity is missing any method the component\r\n   * interface requires - the fail-closed stand-in for Carbon's compile-time\r\n   * RegisterComponent<T> constraint.\r\n   */\r\n  @impl.adapted\r\n  @impl.reason(\"JavaScript passes Carbon's compile-time component name explicitly because it has no C++ template specialization.\")\r\n  RegisterComponent(componentName, entity)\r\n  {\r\n    // Fail-closed duck assertion: Carbon's RegisterComponent<T> cannot compile\r\n    // for an entity that does not implement T; the JS port asserts the\r\n    // interface's pure-virtual surface (EveComponentRequiredMethods) instead.\r\n    if (Object.hasOwn(EveComponentRequiredMethods, componentName))\r\n    {\r\n      for (const method of EveComponentRequiredMethods[componentName])\r\n      {\r\n        if (typeof entity?.[method] !== \"function\")\r\n        {\r\n          throw new TypeError(\r\n            `EveComponentRegistry.RegisterComponent(\"${componentName}\"): entity `\r\n            + `${entity?.constructor?.name ?? typeof entity} is missing required method ${method}().`);\r\n        }\r\n      }\r\n    }\r\n    let collection = this.GetComponentCollection(componentName);\r\n    if (!collection)\r\n    {\r\n      collection = this.AddCollection(componentName);\r\n    }\r\n    return this.AddToCollection(collection, entity);\r\n  }\r\n\r\n  /**\r\n   * Removes an entity from the named component's collection, returning false\r\n   * when no such collection exists.\r\n   */\r\n  @impl.adapted\r\n  @impl.reason(\"JavaScript passes Carbon's compile-time component name explicitly because it has no C++ template specialization.\")\r\n  UnRegisterComponent(componentName, entity)\r\n  {\r\n    const collection = this.GetComponentCollection(componentName);\r\n    return collection ? this.RemoveFromCollection(collection, entity) : false;\r\n  }\r\n\r\n  /**\r\n   * Creates a collection for a component name and assigns it the next free bit;\r\n   * throws once 32 collections exist because the entity component mask is 32\r\n   * bits wide.\r\n   */\r\n  @impl.implemented\r\n  AddCollection(componentName)\r\n  {\r\n    if (this.#componentCollections.length >= 32)\r\n    {\r\n      throw new RangeError(\"EveComponentRegistry supports at most 32 component collections.\");\r\n    }\r\n    const collection = new EveComponentCollection();\r\n    collection.name = String(componentName);\r\n    collection.bit = 2 ** this.#componentCollections.length;\r\n    this.#componentCollections.push(collection);\r\n    return collection;\r\n  }\r\n\r\n  /**\r\n   * Appends an entity to a collection and stores the resulting index on the\r\n   * entity under the collection's bit, returning false if it is already a\r\n   * member.\r\n   */\r\n  @impl.implemented\r\n  AddToCollection(collection, entity)\r\n  {\r\n    if (entity.GetComponentIndex(collection.GetBit()) !== undefined)\r\n    {\r\n      return false;\r\n    }\r\n    const index = collection.Add(entity);\r\n    entity.SetComponentState(collection.GetBit(), index);\r\n    return true;\r\n  }\r\n\r\n  /**\r\n   * Removes an entity from a collection by swapping the back element into its\r\n   * slot and fixing up the moved entity's stored index, returning false if it\r\n   * was not a member.\r\n   */\r\n  @impl.implemented\r\n  RemoveFromCollection(collection, entity)\r\n  {\r\n    const bit = collection.GetBit();\r\n    const index = entity.GetComponentIndex(bit);\r\n    if (index === undefined)\r\n    {\r\n      return false;\r\n    }\r\n    const swappedEntity = collection.SwapWithBack(index);\r\n    if (swappedEntity)\r\n    {\r\n      swappedEntity.SetComponentState(bit, index);\r\n    }\r\n    entity.RemoveComponentState(bit);\r\n    return true;\r\n  }\r\n\r\n  /**\r\n   * Returns the live entity array backing the named component collection, or an\r\n   * empty array when the collection does not exist; the array is borrowed and\r\n   * changes as entities register.\r\n   */\r\n  @impl.implemented\r\n  GetComponents(componentName)\r\n  {\r\n    return this.GetComponentCollection(componentName)?.collection ?? [];\r\n  }\r\n\r\n  /**\r\n   * Returns how many entities are in the named component collection, or 0 when\r\n   * the collection does not exist.\r\n   */\r\n  @impl.implemented\r\n  ComponentCount(componentName)\r\n  {\r\n    return this.GetComponentCollection(componentName)?.Size() ?? 0;\r\n  }\r\n\r\n  /** Carbon method GetComponentInfo (MAP_METHOD_AND_WRAP). */\r\n  @carbon.method\r\n  @impl.adapted\r\n  @impl.reason(\"Returns Carbon's vector of name/count pairs as JavaScript tuple arrays.\")\r\n  GetComponentInfo()\r\n  {\r\n    return this.#componentCollections.map(collection => [collection.name, collection.Size()]);\r\n  }\r\n\r\n}\r\n"],"names":["_EveComponentRegistry","EveComponentRegistry","CjsModel","e","_init_componentCollectionLoopGuard","_init_extra_componentCollectionLoopGuard","_init_registeredEntities","_init_extra_registeredEntities","_initProto","c","_initClass","_applyDecs","type","define","className","family","rawStruct","list","impl","implemented","adapted","reason","carbon","method","constructor","args","componentCollectionLoopGuard","registeredEntities","Clear","collection","entity","registry","indexInRegistry","ClearComponentState","length","ReRegister","UnRegister","Register","push","index","lastIndex","swappedEntity","pop","UnRegisterAllComponents","RemoveFromCollection","GetComponentCollection","componentName","find","name","RegisterComponent","Object","hasOwn","EveComponentRequiredMethods","TypeError","AddCollection","AddToCollection","UnRegisterComponent","RangeError","EveComponentCollection","String","bit","GetComponentIndex","GetBit","undefined","Add","SetComponentState","SwapWithBack","RemoveComponentState","GetComponents","ComponentCount","Size","GetComponentInfo","map"],"mappings":"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"}

package/dist/eve/scene/picking/EvePickingContext.js

@@ -0,0 +1,61 @@
+import { applyDecs2311 as _applyDecs2311 } from '../../../_virtual/_rollupPluginBabelHelpers.js';
+import { CjsModel } from '@carbonenginejs/runtime-utils/model';
+import { type, carbon, impl } from '@carbonenginejs/runtime-utils/schema';
+
+let _initProto, _initClass, _init_readbacks, _init_extra_readbacks, _init_lastPickedX, _init_extra_lastPickedX, _init_lastPickedY, _init_extra_lastPickedY, _init_lastPickedObject, _init_extra_lastPickedObject, _init_lastPickedArea, _init_extra_lastPickedArea;
+
+/**
+ * Holds the outstanding picking readbacks and the most recent pick result -
+ * screen coordinates, hit object and hit area - for a scene.
+ */
+let _EvePickingContext;
+class EvePickingContext extends CjsModel {
+  static {
+    ({
+      e: [_init_readbacks, _init_extra_readbacks, _init_lastPickedX, _init_extra_lastPickedX, _init_lastPickedY, _init_extra_lastPickedY, _init_lastPickedObject, _init_extra_lastPickedObject, _init_lastPickedArea, _init_extra_lastPickedArea, _initProto],
+      c: [_EvePickingContext, _initClass]
+    } = _applyDecs2311(this, [type.define({
+      className: "EvePickingContext",
+      family: "eve/scene"
+    })], [[type.list("EvePendingPickingReadback"), 0, "readbacks"], [[type, type.uint32], 16, "lastPickedX"], [[type, type.uint32], 16, "lastPickedY"], [type.objectRef("IRoot"), 0, "lastPickedObject"], [[type, type.uint32], 16, "lastPickedArea"], [[carbon, carbon.method, impl, impl.implemented], 18, "UpdateResult"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetObject"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetArea"]], 0, void 0, CjsModel));
+  }
+  constructor(...args) {
+    super(...args);
+    _init_extra_lastPickedArea(this);
+  }
+  readbacks = (_initProto(this), _init_readbacks(this, []));
+  lastPickedX = (_init_extra_readbacks(this), _init_lastPickedX(this, 0));
+  lastPickedY = (_init_extra_lastPickedX(this), _init_lastPickedY(this, 0));
+  lastPickedObject = (_init_extra_lastPickedY(this), _init_lastPickedObject(this, null));
+  lastPickedArea = (_init_extra_lastPickedObject(this), _init_lastPickedArea(this, 0));
+
+  /**
+   * Records the outcome of a resolved pick: the sampled screen coordinates, the
+   * object hit (null for none) and its area index.
+   */
+  UpdateResult(x, y, object, area) {
+    this.lastPickedX = Number(x) >>> 0;
+    this.lastPickedY = Number(y) >>> 0;
+    this.lastPickedObject = object ?? null;
+    this.lastPickedArea = Number(area) >>> 0;
+  }
+
+  /**
+   * Returns the object from the last resolved pick, or null if nothing was hit;
+   * the reference is borrowed and replaced by the next pick.
+   */
+  GetObject() {
+    return this.lastPickedObject;
+  }
+
+  /** Returns the area index from the last resolved pick. */
+  GetArea() {
+    return this.lastPickedArea;
+  }
+  static {
+    _initClass();
+  }
+}
+
+export { _EvePickingContext as EvePickingContext };
+//# sourceMappingURL=EvePickingContext.js.map

package/dist/eve/scene/picking/EvePickingContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EvePickingContext.js","sources":["../../../../../src/eve/scene/picking/EvePickingContext.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\EvePicking.h\r\n// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\EvePicking.cpp\r\n// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\EvePicking_Blue.cpp\r\nimport { CjsModel } from \"@carbonenginejs/runtime-utils/model\";\r\nimport { carbon, impl, type } from \"@carbonenginejs/runtime-utils/schema\";\r\n\r\n/**\r\n * Holds the outstanding picking readbacks and the most recent pick result -\r\n * screen coordinates, hit object and hit area - for a scene.\r\n */\r\n@type.define({ className: \"EvePickingContext\", family: \"eve/scene\" })\r\nexport class EvePickingContext extends CjsModel\r\n{\r\n  @type.list(\"EvePendingPickingReadback\")\r\n  readbacks = [];\r\n\r\n  @type.uint32\r\n  lastPickedX = 0;\r\n\r\n  @type.uint32\r\n  lastPickedY = 0;\r\n\r\n  @type.objectRef(\"IRoot\")\r\n  lastPickedObject = null;\r\n\r\n  @type.uint32\r\n  lastPickedArea = 0;\r\n\r\n  /**\r\n   * Records the outcome of a resolved pick: the sampled screen coordinates, the\r\n   * object hit (null for none) and its area index.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  UpdateResult(x, y, object, area)\r\n  {\r\n    this.lastPickedX = Number(x) >>> 0;\r\n    this.lastPickedY = Number(y) >>> 0;\r\n    this.lastPickedObject = object ?? null;\r\n    this.lastPickedArea = Number(area) >>> 0;\r\n  }\r\n\r\n  /**\r\n   * Returns the object from the last resolved pick, or null if nothing was hit;\r\n   * the reference is borrowed and replaced by the next pick.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  GetObject()\r\n  {\r\n    return this.lastPickedObject;\r\n  }\r\n\r\n  /** Returns the area index from the last resolved pick. */\r\n  @carbon.method\r\n  @impl.implemented\r\n  GetArea()\r\n  {\r\n    return this.lastPickedArea;\r\n  }\r\n}\r\n"],"names":["_EvePickingContext","EvePickingContext","CjsModel","e","_init_readbacks","_init_extra_readbacks","_init_lastPickedX","_init_extra_lastPickedX","_init_lastPickedY","_init_extra_lastPickedY","_init_lastPickedObject","_init_extra_lastPickedObject","_init_lastPickedArea","_init_extra_lastPickedArea","_initProto","c","_initClass","_applyDecs","type","define","className","family","list","uint32","objectRef","carbon","method","impl","implemented","constructor","args","readbacks","lastPickedX","lastPickedY","lastPickedObject","lastPickedArea","UpdateResult","x","y","object","area","Number","GetObject","GetArea"],"mappings":"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"}

package/dist/eve/scene/shadows/TriShadowFrustum.js

@@ -0,0 +1,70 @@
+import { vec3 } from '@carbonenginejs/runtime-utils/vec3';
+import { TriFrustumTestResult } from '../../../generated/trinityCore/enums.js';
+
+// Ported from CarbonEngine (MIT, (c) 2026 CCP Games) - https://github.com/carbonengine/trinity
+//   trinity/trinity/Eve/IEveShadowCaster.h
+// Methods implemented from IEveShadowCaster.h:107-135 (TriShadowFrustum, the
+// perspective IEveShadowFrustum adapter). Transient per-shadow-pass CPU cull
+// adapter - NOT a registry component and never a scene member
+// (ECS-VISIBILITY-SPEC-2026-07-23 "Shadow frustums"). The shadow member is a
+// TriFrustum held by reference (Carbon copies by value into the transient).
+
+/** Carbon's native perspective-shadow frustum adapter. */
+class TriShadowFrustum {
+  /** m_shadow (TriFrustum) */
+  shadow = null;
+
+  /**
+   * Carbon's constructor (h:112-115); optional to keep the shell
+   * default-constructible.
+   * @param {Object|null} [shadow] - TriFrustum
+   */
+  constructor(shadow = null) {
+    this.shadow = shadow ?? null;
+  }
+
+  /**
+   * Carbon TriShadowFrustum::IsVisible (h:116-121) - the shadow frustum's own
+   * sphere test; Carbon leaves camera-based culling as a TODO ("do something
+   * smart to cull the shadowcasting sphere using the camera frustum").
+   * @param {Object} _camera - TriFrustum duck (unused, Carbon parity)
+   * @param {Float32Array} boundingSphere - packed (x, y, z, radius)
+   * @returns {Boolean}
+   */
+  IsVisible(_camera, boundingSphere) {
+    return !!this.shadow?.IsSphereVisible(boundingSphere);
+  }
+
+  /**
+   * Carbon TriShadowFrustum::GetSizeInShadow (h:122-125).
+   * @param {Float32Array} boundingSphere - packed (x, y, z, radius)
+   * @returns {Number}
+   */
+  GetSizeInShadow(boundingSphere) {
+    return this.shadow ? this.shadow.GetPixelSizeAccross(boundingSphere) : 0;
+  }
+
+  /**
+   * Carbon TriShadowFrustum::GetEyePos (h:126-129) - the shadow frustum's
+   * m_viewPos.
+   * @returns {Float32Array}
+   */
+  GetEyePos() {
+    return this.shadow ? this.shadow.viewPos : TriShadowFrustum.#zeroEyePos;
+  }
+
+  /**
+   * Carbon TriShadowFrustum::SphereTest (h:131-134) - delegates to the shadow
+   * frustum's six-plane classification (camera unused, Carbon parity).
+   * @param {Object} _camera - TriFrustum duck (unused)
+   * @param {Object|Float32Array} sphere - { center, radius } or packed vec4
+   * @returns {Number} TriFrustumTestResult
+   */
+  SphereTest(_camera, sphere) {
+    return this.shadow ? this.shadow.SphereTest(sphere) : TriFrustumTestResult.Outside;
+  }
+  static #zeroEyePos = vec3.create();
+}
+
+export { TriShadowFrustum };
+//# sourceMappingURL=TriShadowFrustum.js.map

package/dist/eve/scene/shadows/TriShadowFrustum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TriShadowFrustum.js","sources":["../../../../../src/eve/scene/shadows/TriShadowFrustum.js"],"sourcesContent":["// Ported from CarbonEngine (MIT, (c) 2026 CCP Games) - https://github.com/carbonengine/trinity\r\n//   trinity/trinity/Eve/IEveShadowCaster.h\r\n// Methods implemented from IEveShadowCaster.h:107-135 (TriShadowFrustum, the\r\n// perspective IEveShadowFrustum adapter). Transient per-shadow-pass CPU cull\r\n// adapter - NOT a registry component and never a scene member\r\n// (ECS-VISIBILITY-SPEC-2026-07-23 \"Shadow frustums\"). The shadow member is a\r\n// TriFrustum held by reference (Carbon copies by value into the transient).\r\nimport { vec3 } from \"@carbonenginejs/runtime-utils/vec3\";\r\nimport { TriFrustumTestResult } from \"../../../generated/trinityCore/enums.js\";\r\n\r\n/** Carbon's native perspective-shadow frustum adapter. */\r\nexport class TriShadowFrustum\r\n{\r\n\r\n  /** m_shadow (TriFrustum) */\r\n  shadow = null;\r\n\r\n  /**\r\n   * Carbon's constructor (h:112-115); optional to keep the shell\r\n   * default-constructible.\r\n   * @param {Object|null} [shadow] - TriFrustum\r\n   */\r\n  constructor(shadow = null)\r\n  {\r\n    this.shadow = shadow ?? null;\r\n  }\r\n\r\n  /**\r\n   * Carbon TriShadowFrustum::IsVisible (h:116-121) - the shadow frustum's own\r\n   * sphere test; Carbon leaves camera-based culling as a TODO (\"do something\r\n   * smart to cull the shadowcasting sphere using the camera frustum\").\r\n   * @param {Object} _camera - TriFrustum duck (unused, Carbon parity)\r\n   * @param {Float32Array} boundingSphere - packed (x, y, z, radius)\r\n   * @returns {Boolean}\r\n   */\r\n  IsVisible(_camera, boundingSphere)\r\n  {\r\n    return !!this.shadow?.IsSphereVisible(boundingSphere);\r\n  }\r\n\r\n  /**\r\n   * Carbon TriShadowFrustum::GetSizeInShadow (h:122-125).\r\n   * @param {Float32Array} boundingSphere - packed (x, y, z, radius)\r\n   * @returns {Number}\r\n   */\r\n  GetSizeInShadow(boundingSphere)\r\n  {\r\n    return this.shadow ? this.shadow.GetPixelSizeAccross(boundingSphere) : 0;\r\n  }\r\n\r\n  /**\r\n   * Carbon TriShadowFrustum::GetEyePos (h:126-129) - the shadow frustum's\r\n   * m_viewPos.\r\n   * @returns {Float32Array}\r\n   */\r\n  GetEyePos()\r\n  {\r\n    return this.shadow ? this.shadow.viewPos : TriShadowFrustum.#zeroEyePos;\r\n  }\r\n\r\n  /**\r\n   * Carbon TriShadowFrustum::SphereTest (h:131-134) - delegates to the shadow\r\n   * frustum's six-plane classification (camera unused, Carbon parity).\r\n   * @param {Object} _camera - TriFrustum duck (unused)\r\n   * @param {Object|Float32Array} sphere - { center, radius } or packed vec4\r\n   * @returns {Number} TriFrustumTestResult\r\n   */\r\n  SphereTest(_camera, sphere)\r\n  {\r\n    return this.shadow ? this.shadow.SphereTest(sphere) : TriFrustumTestResult.Outside;\r\n  }\r\n\r\n  static #zeroEyePos = vec3.create();\r\n\r\n}\r\n"],"names":["TriShadowFrustum","shadow","constructor","IsVisible","_camera","boundingSphere","IsSphereVisible","GetSizeInShadow","GetPixelSizeAccross","GetEyePos","viewPos","SphereTest","sphere","TriFrustumTestResult","Outside","vec3","create"],"mappings":";;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;;AAIA;AACO,MAAMA,gBAAgB,CAC7B;AAEE;AACAC,EAAAA,MAAM,GAAG,IAAI;;AAEb;AACF;AACA;AACA;AACA;AACEC,EAAAA,WAAWA,CAACD,MAAM,GAAG,IAAI,EACzB;AACE,IAAA,IAAI,CAACA,MAAM,GAAGA,MAAM,IAAI,IAAI;AAC9B,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACEE,EAAAA,SAASA,CAACC,OAAO,EAAEC,cAAc,EACjC;IACE,OAAO,CAAC,CAAC,IAAI,CAACJ,MAAM,EAAEK,eAAe,CAACD,cAAc,CAAC;AACvD,EAAA;;AAEA;AACF;AACA;AACA;AACA;EACEE,eAAeA,CAACF,cAAc,EAC9B;AACE,IAAA,OAAO,IAAI,CAACJ,MAAM,GAAG,IAAI,CAACA,MAAM,CAACO,mBAAmB,CAACH,cAAc,CAAC,GAAG,CAAC;AAC1E,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACEI,EAAAA,SAASA,GACT;AACE,IAAA,OAAO,IAAI,CAACR,MAAM,GAAG,IAAI,CAACA,MAAM,CAACS,OAAO,GAAGV,gBAAgB,CAAC,WAAW;AACzE,EAAA;;AAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACEW,EAAAA,UAAUA,CAACP,OAAO,EAAEQ,MAAM,EAC1B;AACE,IAAA,OAAO,IAAI,CAACX,MAAM,GAAG,IAAI,CAACA,MAAM,CAACU,UAAU,CAACC,MAAM,CAAC,GAAGC,oBAAoB,CAACC,OAAO;AACpF,EAAA;AAEA,EAAA,OAAO,WAAW,GAAGC,IAAI,CAACC,MAAM,EAAE;AAEpC;;;;"}

package/dist/eve/scene/shadows/TriShadowOrthoFrustum.js

@@ -0,0 +1,129 @@
+import { vec3 } from '@carbonenginejs/runtime-utils/vec3';
+import { PlaneDotNormal, PlaneDotCoord } from '../../../trinityCore/TriFrustum.js';
+import { TriFrustumTestResult } from '../../../generated/trinityCore/enums.js';
+
+// Ported from CarbonEngine (MIT, (c) 2026 CCP Games) - https://github.com/carbonengine/trinity
+//   trinity/trinity/Eve/IEveShadowCaster.h
+// Methods implemented from IEveShadowCaster.h:28-105 (TriShadowOrthoFrustum,
+// the cascaded-shadow-map IEveShadowFrustum adapter). Transient per-shadow-pass
+// CPU cull adapter - NOT a registry component and never a scene member
+// (ECS-VISIBILITY-SPEC-2026-07-23 "Shadow frustums"). The camera argument is a
+// TriFrustum duck (world-space planes array); the shadow member is a
+// TriFrustumOrtho held by reference (Carbon copies by value into the
+// transient).
+
+/** Carbon's native orthographic-shadow frustum adapter. */
+class TriShadowOrthoFrustum {
+  /** m_shadow (TriFrustumOrtho) */
+  shadow = null;
+
+  /** m_shadowMapSize (uint32_t) */
+  shadowMapSize = 0;
+
+  /** m_sunDir (Vector3) */
+  sunDir = vec3.create();
+
+  /**
+   * Carbon's argument constructor (h:42-47); all arguments optional to keep
+   * the default-constructible shell contract (h:35-40).
+   * @param {Object|null} [shadow] - TriFrustumOrtho
+   * @param {Number} [shadowMapSize]
+   * @param {Float32Array|null} [sunDir]
+   */
+  constructor(shadow = null, shadowMapSize = 0, sunDir = null) {
+    this.shadow = shadow ?? null;
+    this.shadowMapSize = Number(shadowMapSize) >>> 0;
+    if (sunDir) {
+      vec3.copy(this.sunDir, sunDir);
+    }
+  }
+
+  /**
+   * Carbon TriShadowOrthoFrustum::IsVisible (h:48-69): the sphere must be
+   * visible in the ortho shadow frustum (far plane ignored), and for every
+   * camera plane facing away from the sun (DotNormal(plane, sunDir) < 0) the
+   * sphere must not be entirely behind that plane. (Carbon's unused local
+   * `val` on the negated center is dead code and is omitted.)
+   * @param {Object} camera - TriFrustum duck ({ planes })
+   * @param {Float32Array} boundingSphere - packed (x, y, z, radius)
+   * @returns {Boolean}
+   */
+  IsVisible(camera, boundingSphere) {
+    if (!this.shadow) {
+      return false;
+    }
+    const sphereIsVisible = this.shadow.IsSphereVisibleIgnoreFarPlane(boundingSphere, boundingSphere[3]);
+    if (sphereIsVisible) {
+      const planes = camera?.planes ?? [];
+      for (let j = 0; j < 6; ++j) {
+        // first check if sun direction is perpendicular of the plane
+        const d = PlaneDotNormal(planes[j], this.sunDir);
+        // if it's not perpendicular then check if the object is "behind" the plane
+        if (d < 0) {
+          if (PlaneDotCoord(planes[j], boundingSphere) < -boundingSphere[3]) {
+            return false;
+          }
+        }
+      }
+    }
+    return sphereIsVisible;
+  }
+
+  /**
+   * Carbon TriShadowOrthoFrustum::GetSizeInShadow (h:70-73) - shadow-map pixel
+   * coverage via TriFrustumOrtho.GetPixelSize.
+   * @param {Float32Array} boundingSphere - packed (x, y, z, radius)
+   * @returns {Number}
+   */
+  GetSizeInShadow(boundingSphere) {
+    return this.shadow ? this.shadow.GetPixelSize(boundingSphere, this.shadowMapSize) : 0;
+  }
+
+  /**
+   * Carbon TriShadowOrthoFrustum::GetEyePos (h:74-77).
+   * @returns {Float32Array}
+   */
+  GetEyePos() {
+    return this.shadow ? this.shadow.GetEyePos() : TriShadowOrthoFrustum.#zeroEyePos;
+  }
+
+  /**
+   * Carbon TriShadowOrthoFrustum::SphereTest (h:79-104): the ortho
+   * classification (far plane ignored), demoted per sun-facing camera plane -
+   * Outside when fully behind one, Intersect when straddling one.
+   * @param {Object} camera - TriFrustum duck ({ planes })
+   * @param {Object|Float32Array} sphere - { center, radius } or packed vec4
+   * @returns {Number} TriFrustumTestResult
+   */
+  SphereTest(camera, sphere) {
+    if (!this.shadow) {
+      return TriFrustumTestResult.Outside;
+    }
+    let orthoResult = this.shadow.SphereTestIgnoreFarPlane(sphere);
+    if (orthoResult !== TriFrustumTestResult.Outside) {
+      const packed = typeof sphere?.length === "number" && sphere.length >= 4;
+      const center = packed ? sphere : sphere.center;
+      const radius = packed ? sphere[3] : sphere.radius;
+      const planes = camera?.planes ?? [];
+      for (let j = 0; j < 6; ++j) {
+        // first check if sun direction is perpendicular of the plane
+        const d = PlaneDotNormal(planes[j], this.sunDir);
+        // if it's not perpendicular then check if the object is "behind" the plane
+        if (d < 0) {
+          const val = PlaneDotCoord(planes[j], center);
+          if (val < -radius) {
+            return TriFrustumTestResult.Outside;
+          }
+          if (val < radius) {
+            orthoResult = TriFrustumTestResult.Intersect;
+          }
+        }
+      }
+    }
+    return orthoResult;
+  }
+  static #zeroEyePos = vec3.create();
+}
+
+export { TriShadowOrthoFrustum };
+//# sourceMappingURL=TriShadowOrthoFrustum.js.map

package/dist/eve/scene/shadows/TriShadowOrthoFrustum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TriShadowOrthoFrustum.js","sources":["../../../../../src/eve/scene/shadows/TriShadowOrthoFrustum.js"],"sourcesContent":["// Ported from CarbonEngine (MIT, (c) 2026 CCP Games) - https://github.com/carbonengine/trinity\r\n//   trinity/trinity/Eve/IEveShadowCaster.h\r\n// Methods implemented from IEveShadowCaster.h:28-105 (TriShadowOrthoFrustum,\r\n// the cascaded-shadow-map IEveShadowFrustum adapter). Transient per-shadow-pass\r\n// CPU cull adapter - NOT a registry component and never a scene member\r\n// (ECS-VISIBILITY-SPEC-2026-07-23 \"Shadow frustums\"). The camera argument is a\r\n// TriFrustum duck (world-space planes array); the shadow member is a\r\n// TriFrustumOrtho held by reference (Carbon copies by value into the\r\n// transient).\r\nimport { vec3 } from \"@carbonenginejs/runtime-utils/vec3\";\r\nimport { PlaneDotCoord, PlaneDotNormal } from \"../../../trinityCore/TriFrustum.js\";\r\nimport { TriFrustumTestResult } from \"../../../generated/trinityCore/enums.js\";\r\n\r\n/** Carbon's native orthographic-shadow frustum adapter. */\r\nexport class TriShadowOrthoFrustum\r\n{\r\n\r\n  /** m_shadow (TriFrustumOrtho) */\r\n  shadow = null;\r\n\r\n  /** m_shadowMapSize (uint32_t) */\r\n  shadowMapSize = 0;\r\n\r\n  /** m_sunDir (Vector3) */\r\n  sunDir = vec3.create();\r\n\r\n  /**\r\n   * Carbon's argument constructor (h:42-47); all arguments optional to keep\r\n   * the default-constructible shell contract (h:35-40).\r\n   * @param {Object|null} [shadow] - TriFrustumOrtho\r\n   * @param {Number} [shadowMapSize]\r\n   * @param {Float32Array|null} [sunDir]\r\n   */\r\n  constructor(shadow = null, shadowMapSize = 0, sunDir = null)\r\n  {\r\n    this.shadow = shadow ?? null;\r\n    this.shadowMapSize = Number(shadowMapSize) >>> 0;\r\n    if (sunDir)\r\n    {\r\n      vec3.copy(this.sunDir, sunDir);\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Carbon TriShadowOrthoFrustum::IsVisible (h:48-69): the sphere must be\r\n   * visible in the ortho shadow frustum (far plane ignored), and for every\r\n   * camera plane facing away from the sun (DotNormal(plane, sunDir) < 0) the\r\n   * sphere must not be entirely behind that plane. (Carbon's unused local\r\n   * `val` on the negated center is dead code and is omitted.)\r\n   * @param {Object} camera - TriFrustum duck ({ planes })\r\n   * @param {Float32Array} boundingSphere - packed (x, y, z, radius)\r\n   * @returns {Boolean}\r\n   */\r\n  IsVisible(camera, boundingSphere)\r\n  {\r\n    if (!this.shadow)\r\n    {\r\n      return false;\r\n    }\r\n    const sphereIsVisible = this.shadow.IsSphereVisibleIgnoreFarPlane(boundingSphere, boundingSphere[3]);\r\n    if (sphereIsVisible)\r\n    {\r\n      const planes = camera?.planes ?? [];\r\n      for (let j = 0; j < 6; ++j)\r\n      {\r\n        // first check if sun direction is perpendicular of the plane\r\n        const d = PlaneDotNormal(planes[j], this.sunDir);\r\n        // if it's not perpendicular then check if the object is \"behind\" the plane\r\n        if (d < 0)\r\n        {\r\n          if (PlaneDotCoord(planes[j], boundingSphere) < -boundingSphere[3])\r\n          {\r\n            return false;\r\n          }\r\n        }\r\n      }\r\n    }\r\n    return sphereIsVisible;\r\n  }\r\n\r\n  /**\r\n   * Carbon TriShadowOrthoFrustum::GetSizeInShadow (h:70-73) - shadow-map pixel\r\n   * coverage via TriFrustumOrtho.GetPixelSize.\r\n   * @param {Float32Array} boundingSphere - packed (x, y, z, radius)\r\n   * @returns {Number}\r\n   */\r\n  GetSizeInShadow(boundingSphere)\r\n  {\r\n    return this.shadow ? this.shadow.GetPixelSize(boundingSphere, this.shadowMapSize) : 0;\r\n  }\r\n\r\n  /**\r\n   * Carbon TriShadowOrthoFrustum::GetEyePos (h:74-77).\r\n   * @returns {Float32Array}\r\n   */\r\n  GetEyePos()\r\n  {\r\n    return this.shadow ? this.shadow.GetEyePos() : TriShadowOrthoFrustum.#zeroEyePos;\r\n  }\r\n\r\n  /**\r\n   * Carbon TriShadowOrthoFrustum::SphereTest (h:79-104): the ortho\r\n   * classification (far plane ignored), demoted per sun-facing camera plane -\r\n   * Outside when fully behind one, Intersect when straddling one.\r\n   * @param {Object} camera - TriFrustum duck ({ planes })\r\n   * @param {Object|Float32Array} sphere - { center, radius } or packed vec4\r\n   * @returns {Number} TriFrustumTestResult\r\n   */\r\n  SphereTest(camera, sphere)\r\n  {\r\n    if (!this.shadow)\r\n    {\r\n      return TriFrustumTestResult.Outside;\r\n    }\r\n    let orthoResult = this.shadow.SphereTestIgnoreFarPlane(sphere);\r\n    if (orthoResult !== TriFrustumTestResult.Outside)\r\n    {\r\n      const packed = typeof sphere?.length === \"number\" && sphere.length >= 4;\r\n      const center = packed ? sphere : sphere.center;\r\n      const radius = packed ? sphere[3] : sphere.radius;\r\n      const planes = camera?.planes ?? [];\r\n      for (let j = 0; j < 6; ++j)\r\n      {\r\n        // first check if sun direction is perpendicular of the plane\r\n        const d = PlaneDotNormal(planes[j], this.sunDir);\r\n        // if it's not perpendicular then check if the object is \"behind\" the plane\r\n        if (d < 0)\r\n        {\r\n          const val = PlaneDotCoord(planes[j], center);\r\n          if (val < -radius)\r\n          {\r\n            return TriFrustumTestResult.Outside;\r\n          }\r\n          if (val < radius)\r\n          {\r\n            orthoResult = TriFrustumTestResult.Intersect;\r\n          }\r\n        }\r\n      }\r\n    }\r\n    return orthoResult;\r\n  }\r\n\r\n  static #zeroEyePos = vec3.create();\r\n\r\n}\r\n"],"names":["TriShadowOrthoFrustum","shadow","shadowMapSize","sunDir","vec3","create","constructor","Number","copy","IsVisible","camera","boundingSphere","sphereIsVisible","IsSphereVisibleIgnoreFarPlane","planes","j","d","PlaneDotNormal","PlaneDotCoord","GetSizeInShadow","GetPixelSize","GetEyePos","SphereTest","sphere","TriFrustumTestResult","Outside","orthoResult","SphereTestIgnoreFarPlane","packed","length","center","radius","val","Intersect"],"mappings":"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"}

package/dist/{generated/eve → eve}/smartLights/attributeModifiers/EveSmartLightAttributeModifierBucket.js

@@ -1,4 +1,4 @@
-import { applyDecs2311 as _applyDecs2311 } from '../../../../_virtual/_rollupPluginBabelHelpers.js';
+import { applyDecs2311 as _applyDecs2311 } from '../../../_virtual/_rollupPluginBabelHelpers.js';
 import { io, type, carbon, impl } from '@carbonenginejs/runtime-utils/schema';
 import { EveSmartLightBaseAttributeModifier as _EveSmartLightBaseAtt } from './EveSmartLightBaseAttributeModifier.js';
 
@@ -26,9 +26,9 @@ class EveSmartLightAttributeModifierBucket extends _EveSmartLightBaseAtt {
   /** m_name (std::string) [READWRITE, PERSIST] */
   name = (_init_extra_attributeModifiers(this), _init_name(this, "bucket"));
 
-  /**
-   * Toggles the bucket, resetting the children only on an actual state change
-   * (EveSmartLightAttributeModifierBucket.cpp:13-21).
+  /**
+   * Toggles the bucket, resetting the children only on an actual state change
+   * (EveSmartLightAttributeModifierBucket.cpp:13-21).
    */
   SetActive(isActive) {
     this.isChangingActivation = isActive !== this.active;
@@ -39,10 +39,10 @@ class EveSmartLightAttributeModifierBucket extends _EveSmartLightBaseAtt {
     this.lastAppliedActive = isActive;
   }
 
-  /**
-   * Bucket override: resetting play time cascades to the children instead of
-   * touching the bucket's own timers
-   * (EveSmartLightAttributeModifierBucket.cpp:23-26).
+  /**
+   * Bucket override: resetting play time cascades to the children instead of
+   * touching the bucket's own timers
+   * (EveSmartLightAttributeModifierBucket.cpp:23-26).
    */
   ResetPlayTime(active) {
     this.ResetChildren(active);
@@ -55,9 +55,9 @@ class EveSmartLightAttributeModifierBucket extends _EveSmartLightBaseAtt {
     }
   }
 
-  /**
-   * Advances the bucket's crossfade, then updates the children with the
-   * compounded multiplier (EveSmartLightAttributeModifierBucket.cpp:36-45).
+  /**
+   * Advances the bucket's crossfade, then updates the children with the
+   * compounded multiplier (EveSmartLightAttributeModifierBucket.cpp:36-45).
    */
   UpdateSyncronous(updateContext, params, activationMultiplier) {
     this.UpdateActivationStrength(activationMultiplier, updateContext?.GetDeltaT?.() ?? 0);
@@ -67,9 +67,9 @@ class EveSmartLightAttributeModifierBucket extends _EveSmartLightBaseAtt {
     }
   }
 
-  /**
-   * Runs the child modifiers with the bucket's per-placement activation
-   * strength folded in (EveSmartLightAttributeModifierBucket.cpp:47-55).
+  /**
+   * Runs the child modifiers with the bucket's per-placement activation
+   * strength folded in (EveSmartLightAttributeModifierBucket.cpp:47-55).
    */
   ProcessAttributeModifier(attribute, placement, entityPosition, entityDirection, modifierStrength) {
     const activationStrength = this.GetActivationStrength(placement) * modifierStrength;
@@ -78,11 +78,11 @@ class EveSmartLightAttributeModifierBucket extends _EveSmartLightBaseAtt {
     }
   }
 
-  /**
-   * Resets every child's play time; a child only becomes active when both the
-   * parent request and the bucket state agree
-   * (EveSmartLightAttributeModifierBucket.cpp:57-67). Carbon BlueCasts to
-   * EveSmartLightBaseAttributeModifier; the JS children are duck-typed.
+  /**
+   * Resets every child's play time; a child only becomes active when both the
+   * parent request and the bucket state agree
+   * (EveSmartLightAttributeModifierBucket.cpp:57-67). Carbon BlueCasts to
+   * EveSmartLightBaseAttributeModifier; the JS children are duck-typed.
    */
   ResetChildren(parentActive = true) {
     const isActive = parentActive && this.active;

package/dist/eve/smartLights/attributeModifiers/EveSmartLightAttributeModifierBucket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EveSmartLightAttributeModifierBucket.js","sources":["../../../../../src/eve/smartLights/attributeModifiers/EveSmartLightAttributeModifierBucket.js"],"sourcesContent":["// Ported from CarbonEngine (MIT, (c) 2026 CCP Games) - https://github.com/carbonengine/trinity\r\n//   trinity/trinity/Eve/SpaceObject/Children/SmartLightSets/attributeModifiers/EveSmartLightAttributeModifierBucket.h\r\n// Generated by format-carbon carbon-class --emit. Verify against eve/smartLights/attributeModifiers/EveSmartLightAttributeModifierBucket.json.\r\nimport { carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\r\nimport { EveSmartLightBaseAttributeModifier } from \"./EveSmartLightBaseAttributeModifier.js\";\r\n\r\n/** EveSmartLightAttributeModifierBucket (eve/smartLights/attributeModifiers) - generated from schema shapeHash cade668b.... */\r\n@type.define({ className: \"EveSmartLightAttributeModifierBucket\", family: \"eve/smartLights/attributeModifiers\" })\r\nexport class EveSmartLightAttributeModifierBucket extends EveSmartLightBaseAttributeModifier\r\n{\r\n\r\n  /** m_attributeModifiers (PIEveSmartLightGroupAttributeModifierVector) [READ, PERSIST, NOTIFY] */\r\n  @io.notify\r\n  @io.persist\r\n  @type.list(\"IEveSmartLightGroupAttributeModifier\")\r\n  attributeModifiers = [];\r\n\r\n  /** m_name (std::string) [READWRITE, PERSIST] */\r\n  @io.persist\r\n  @type.string\r\n  name = \"bucket\";\r\n\r\n  /**\r\n   * Toggles the bucket, resetting the children only on an actual state change\r\n   * (EveSmartLightAttributeModifierBucket.cpp:13-21).\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  SetActive(isActive)\r\n  {\r\n    this.isChangingActivation = isActive !== this.active;\r\n    if (this.isChangingActivation)\r\n    {\r\n      this.ResetPlayTime(isActive);\r\n    }\r\n    this.active = isActive;\r\n    this.lastAppliedActive = isActive;\r\n  }\r\n\r\n  /**\r\n   * Bucket override: resetting play time cascades to the children instead of\r\n   * touching the bucket's own timers\r\n   * (EveSmartLightAttributeModifierBucket.cpp:23-26).\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  ResetPlayTime(active)\r\n  {\r\n    this.ResetChildren(active);\r\n  }\r\n\r\n  /** Fans the inherited color set out to the child modifiers (EveSmartLightAttributeModifierBucket.cpp:28-34). */\r\n  @carbon.method\r\n  @impl.implemented\r\n  SetInheritProperties(colorSet)\r\n  {\r\n    for (const attributeModifier of this.attributeModifiers)\r\n    {\r\n      attributeModifier?.SetInheritProperties?.(colorSet);\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Advances the bucket's crossfade, then updates the children with the\r\n   * compounded multiplier (EveSmartLightAttributeModifierBucket.cpp:36-45).\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  UpdateSyncronous(updateContext, params, activationMultiplier)\r\n  {\r\n    this.UpdateActivationStrength(activationMultiplier, updateContext?.GetDeltaT?.() ?? 0);\r\n    const childMultiplier = activationMultiplier * this.finalAttributeMultiplier;\r\n\r\n    for (const attributeModifier of this.attributeModifiers)\r\n    {\r\n      attributeModifier?.UpdateSyncronous?.(updateContext, params, childMultiplier);\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Runs the child modifiers with the bucket's per-placement activation\r\n   * strength folded in (EveSmartLightAttributeModifierBucket.cpp:47-55).\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  ProcessAttributeModifier(attribute, placement, entityPosition, entityDirection, modifierStrength)\r\n  {\r\n    const activationStrength = this.GetActivationStrength(placement) * modifierStrength;\r\n\r\n    for (const attributeModifier of this.attributeModifiers)\r\n    {\r\n      attributeModifier?.ProcessAttributeModifier?.(attribute, placement, entityPosition, entityDirection, activationStrength);\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Resets every child's play time; a child only becomes active when both the\r\n   * parent request and the bucket state agree\r\n   * (EveSmartLightAttributeModifierBucket.cpp:57-67). Carbon BlueCasts to\r\n   * EveSmartLightBaseAttributeModifier; the JS children are duck-typed.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  ResetChildren(parentActive = true)\r\n  {\r\n    const isActive = parentActive && this.active;\r\n    for (const attributeModifier of this.attributeModifiers)\r\n    {\r\n      attributeModifier?.ResetPlayTime?.(isActive);\r\n    }\r\n  }\r\n\r\n}\r\n"],"names":["_EveSmartLightAttribu","EveSmartLightAttributeModifierBucket","EveSmartLightBaseAttributeModifier","e","_init_attributeModifiers","_init_extra_attributeModifiers","_init_name","_init_extra_name","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","notify","persist","list","string","carbon","method","impl","implemented","constructor","args","attributeModifiers","name","SetActive","isActive","isChangingActivation","active","ResetPlayTime","lastAppliedActive","ResetChildren","SetInheritProperties","colorSet","attributeModifier","UpdateSyncronous","updateContext","params","activationMultiplier","UpdateActivationStrength","GetDeltaT","childMultiplier","finalAttributeMultiplier","ProcessAttributeModifier","attribute","placement","entityPosition","entityDirection","modifierStrength","activationStrength","GetActivationStrength","parentActive"],"mappings":"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"}