@carbonenginejs/runtime-trinity 0.6.0 → 0.8.0

package/dist/eve/AudioGameObject.js

@@ -7,6 +7,12 @@ import { CjsModel } from '@carbonenginejs/runtime-utils/model';
 import { io, type, carbon, impl, CjsSchema } from '@carbonenginejs/runtime-utils/schema';
 
 let _initProto, _initClass, _init_audioEmitter, _init_extra_audioEmitter, _init_translationCurve, _init_extra_translationCurve, _init_rotationCurve, _init_extra_rotationCurve, _init_externalParameters, _init_extra_externalParameters, _init_rotation, _init_extra_rotation, _init_translation, _init_extra_translation, _init_mute, _init_extra_mute, _init_name, _init_extra_name, _init_display, _init_extra_display;
+
+/**
+ * A freely placed audio emitter driven by its own translation and rotation
+ * curves, so a sound can sit anywhere in a scene without being attached to an
+ * asset.
+ */
 let _AudioGameObject;
 new class extends _identity {
   static [class AudioGameObject extends CjsModel {
@@ -17,7 +23,7 @@ new class extends _identity {
       } = _applyDecs2311(this, [type.define({
         className: "AudioGameObject",
         family: "eve"
-      })], [[[io, io.persist, void 0, type.objectRef("ITr2AudEmitter")], 16, "audioEmitter"], [[io, io.persist, void 0, type.model("ITriVectorFunction")], 16, "translationCurve"], [[io, io.persist, void 0, type.model("ITriQuaternionFunction")], 16, "rotationCurve"], [[io, io.persist, void 0, type.list("Tr2ExternalParameter")], 16, "externalParameters"], [[io, io.persist, type, type.quat], 16, "rotation"], [[io, io.persist, type, type.vec3], 16, "translation"], [[io, io.notify, io, io.readwrite, type, type.boolean], 16, "mute"], [[io, io.persist, type, type.string], 16, "name"], [[io, io.readwrite, type, type.boolean], 16, "display"], [[carbon, carbon.method, impl, impl.adapted], 18, "__init__"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetAudioEmitter"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetEmitterName"], [[carbon, carbon.method, impl, impl.implemented], 18, "PlayAudioEvent"]], 0, void 0, CjsModel));
+      })], [[[io, io.persist, void 0, type.objectRef("ITr2AudEmitter")], 16, "audioEmitter"], [[io, io.persist, void 0, type.model("ITriVectorFunction")], 16, "translationCurve"], [[io, io.persist, void 0, type.model("ITriQuaternionFunction")], 16, "rotationCurve"], [[io, io.persist, void 0, type.list("Tr2ExternalParameter")], 16, "externalParameters"], [[io, io.persist, type, type.quat], 16, "rotation"], [[io, io.persist, type, type.vec3], 16, "translation"], [[io, io.notify, io, io.readwrite, type, type.boolean], 16, "mute"], [[io, io.persist, type, type.string], 16, "name"], [[io, io.readwrite, type, type.boolean], 16, "display"], [[carbon, carbon.method, impl, impl.adapted], 18, "__init__"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetAudioEmitter"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetEmitterName"], [[carbon, carbon.method, impl, impl.implemented], 18, "PlayAudioEvent"], [[carbon, carbon.method, impl, impl.noop], 18, "GetPerObjectStructs"]], 0, void 0, CjsModel));
     }
     constructor(...args) {
       super(...args);
@@ -33,6 +39,12 @@ new class extends _identity {
     mute = (_init_extra_translation(this), _init_mute(this, false));
     name = (_init_extra_mute(this), _init_name(this, ""));
     display = (_init_extra_name(this), _init_display(this, true));
+
+    /**
+     * Creates the emitter from the registered AudEmitter class if there is not one
+     * already, places it at the object's current world position, and reports
+     * whether the emitter accepted initialization.
+     */
     Initialize() {
       if (this.audioEmitter) return true;
       const Emitter = CjsSchema.GetConstructor("AudEmitter");
@@ -44,19 +56,35 @@ new class extends _identity {
       this.#SetEmitterPosition(position);
       return initialized !== false;
     }
+
+    /** Post-hydration hook; runs Initialize. */
     __init__() {
       return this.Initialize();
     }
+
+    /** The emitter this object drives, or null before Initialize has run. */
     GetAudioEmitter() {
       return this.audioEmitter;
     }
+
+    /**
+     * Renames the underlying emitter without touching this object's own name
+     * field.
+     */
     SetEmitterName(name) {
       this.audioEmitter?.SetName?.(String(name));
     }
+
+    /**
+     * Sends a named event to the emitter and returns the identifier it hands back,
+     * or 0 when there is no emitter or no event name.
+     */
     PlayAudioEvent(eventName) {
       if (!this.audioEmitter || !eventName) return 0;
       return this.audioEmitter.SendEvent?.(String(eventName)) ?? 0;
     }
+
+    /** Applies a changed mute flag or name to the emitter after a model update. */
     OnModified(value = null) {
       if (value === "mute" || value === this.mute) {
         this.audioEmitter?.[this.mute ? "Mute" : "Unmute"]?.();
@@ -66,6 +94,11 @@ new class extends _identity {
       }
       return true;
     }
+
+    /**
+     * Re-evaluates the transform curves for the frame and pushes the resulting
+     * position and orientation to the emitter, unless the object is muted.
+     */
     UpdateSyncronous(updateContext = null) {
       const time = updateContext?.GetTime?.() ?? updateContext?.time ?? 0;
       this.UpdateWorldTransform(time);
@@ -73,28 +106,70 @@ new class extends _identity {
         this.#SetEmitterPosition(this.GetWorldPosition(vec3.create()));
       }
     }
+
+    /**
+     * IEveSpaceObject2 asynchronous phase; the object does all of its work
+     * synchronously.
+     */
     UpdateAsyncronous(_updateContext = null) {}
+
+    /** IEveSpaceObject2 hook; an audio object has nothing to cull. */
     UpdateVisibility(_updateContext, _parentTransform) {}
+
+    /** IEveSpaceObject2 hook; an audio object contributes no renderables. */
     GetRenderables(_renderables, _impostors = null) {}
+
+    /**
+     * Reports a unit sphere at the object's world position, so scene traversal has something to place it by.
+     * @param {Array} out - caller-owned packed (x, y, z, radius), overwritten
+     */
     GetBoundingSphere(out = vec4.create()) {
       const position = this.GetWorldPosition(vec3.create());
       vec4.set(out, position[0], position[1], position[2], 1);
       return true;
     }
+
+    /**
+     * Copies the transform stamped by the last UpdateWorldTransform.
+     * @param {Array} [out] - caller-owned mat4; a fresh matrix is allocated when omitted
+     * @returns {Array} out
+     */
     GetLocalToWorldTransform(out = mat4.create()) {
       return mat4.copy(out, this.#worldTransform);
     }
+
+    /**
+     * Copies the translation of the transform stamped by the last UpdateWorldTransform.
+     * @param {Array} [out] - caller-owned vec3; a fresh vector is allocated when omitted
+     * @returns {Array} out
+     */
     GetWorldPosition(out = vec3.create()) {
       return mat4.getTranslation(out, this.#worldTransform);
     }
+
+    /**
+     * Copies the normalized rotation of the transform stamped by the last UpdateWorldTransform.
+     * @param {Array} [out] - caller-owned quat; a fresh quaternion is allocated when omitted
+     * @returns {Array} out
+     */
     GetWorldRotation(out = quat.create()) {
       return quat.normalize(out, mat4.getRotation(out, this.#worldTransform));
     }
+
+    /**
+     * Reports a fixed unit cube; the object has no geometry, but scene code
+     * expects a box.
+     */
     GetLocalBoundingBox(outMin, outMax) {
       vec3.set(outMin, -1, -1, -1);
       vec3.set(outMax, 1, 1, 1);
       return true;
     }
+
+    /**
+     * Rebuilds the world transform from the authored translation and rotation after letting the transform curves overwrite them at the given time.
+     * @returns {Array} the object's own matrix, valid only until the next call
+     */
     UpdateWorldTransform(time) {
       const translation = vec3.clone(this.translation);
       const rotation = quat.clone(this.rotation);
@@ -103,6 +178,19 @@ new class extends _identity {
       mat4.fromRotationTranslation(this.#worldTransform, rotation, translation);
       return this.#worldTransform;
     }
+
+    /**
+     * IEveSpaceObject2 hook (AudioGameObject.cpp:91-93): an audio game object is
+     * not rendered, so it contributes nothing to a child's per-object records and
+     * Carbon's body is empty. Present so a child parented to one can call it.
+     */
+    GetPerObjectStructs(_vsData, _psData) {}
+
+    /**
+     * Pushes a position to the emitter together with the object's front and top
+     * axes rotated into world space, which is what gives the sound its
+     * orientation.
+     */
     #SetEmitterPosition(position) {
       const rotation = this.GetWorldRotation(quat.create());
       const front = vec3.transformQuat(vec3.create(), _AudioGameObject.FRONT, rotation);

package/dist/eve/AudioGameObject.js.map

@@ -1 +1 @@
-{"version":3,"file":"AudioGameObject.js","sources":["../../../src/eve/AudioGameObject.js"],"sourcesContent":["// Ported/adapted from CarbonEngine (MIT, (c) 2026 CCP Games) - https://github.com/carbonengine/trinity\n//   trinity/trinity/Eve/AudioGameObject.h\n//   trinity/trinity/Eve/AudioGameObject.cpp\nimport { mat4 } from \"@carbonenginejs/runtime-utils/mat4\";\nimport { quat } from \"@carbonenginejs/runtime-utils/quat\";\nimport { vec3 } from \"@carbonenginejs/runtime-utils/vec3\";\nimport { vec4 } from \"@carbonenginejs/runtime-utils/vec4\";\nimport { CjsModel } from \"@carbonenginejs/runtime-utils/model\";\nimport { carbon, CjsSchema, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\n\n\n@type.define({ className: \"AudioGameObject\", family: \"eve\" })\nexport class AudioGameObject extends CjsModel\n{\n  #worldTransform = mat4.create();\n\n  @io.persist\n  @type.objectRef(\"ITr2AudEmitter\")\n  audioEmitter = null;\n\n  @io.persist\n  @type.model(\"ITriVectorFunction\")\n  translationCurve = null;\n\n  @io.persist\n  @type.model(\"ITriQuaternionFunction\")\n  rotationCurve = null;\n\n  @io.persist\n  @type.list(\"Tr2ExternalParameter\")\n  externalParameters = [];\n\n  @io.persist\n  @type.quat\n  rotation = quat.create();\n\n  @io.persist\n  @type.vec3\n  translation = vec3.create();\n\n  @io.notify\n  @io.readwrite\n  @type.boolean\n  mute = false;\n\n  @io.persist\n  @type.string\n  name = \"\";\n\n  @io.readwrite\n  @type.boolean\n  display = true;\n\n  Initialize()\n  {\n    if (this.audioEmitter) return true;\n    const Emitter = CjsSchema.GetConstructor(\"AudEmitter\");\n    if (!Emitter) return false;\n    this.audioEmitter = new Emitter();\n    this.UpdateWorldTransform(0);\n    const position = this.GetWorldPosition(vec3.create());\n    const initialized = this.audioEmitter.Initialize?.(this.name || \"audio_object\", \"\", position);\n    this.#SetEmitterPosition(position);\n    return initialized !== false;\n  }\n\n  @carbon.method\n  @impl.adapted\n  __init__()\n  {\n    return this.Initialize();\n  }\n\n  @carbon.method\n  @impl.implemented\n  GetAudioEmitter()\n  {\n    return this.audioEmitter;\n  }\n\n  @carbon.method\n  @impl.implemented\n  SetEmitterName(name)\n  {\n    this.audioEmitter?.SetName?.(String(name));\n  }\n\n  @carbon.method\n  @impl.implemented\n  PlayAudioEvent(eventName)\n  {\n    if (!this.audioEmitter || !eventName) return 0;\n    return this.audioEmitter.SendEvent?.(String(eventName)) ?? 0;\n  }\n\n  OnModified(value = null)\n  {\n    if (value === \"mute\" || value === this.mute)\n    {\n      this.audioEmitter?.[this.mute ? \"Mute\" : \"Unmute\"]?.();\n    }\n    if (value === \"name\" || value === this.name)\n    {\n      this.SetEmitterName(this.name || \"audio_object\");\n    }\n    return true;\n  }\n\n  UpdateSyncronous(updateContext = null)\n  {\n    const time = updateContext?.GetTime?.() ?? updateContext?.time ?? 0;\n    this.UpdateWorldTransform(time);\n    if (this.audioEmitter && !this.mute)\n    {\n      this.#SetEmitterPosition(this.GetWorldPosition(vec3.create()));\n    }\n  }\n\n  UpdateAsyncronous(_updateContext = null)\n  {\n  }\n\n  UpdateVisibility(_updateContext, _parentTransform)\n  {\n  }\n\n  GetRenderables(_renderables, _impostors = null)\n  {\n  }\n\n  GetBoundingSphere(out = vec4.create())\n  {\n    const position = this.GetWorldPosition(vec3.create());\n    vec4.set(out, position[0], position[1], position[2], 1);\n    return true;\n  }\n\n  GetLocalToWorldTransform(out = mat4.create())\n  {\n    return mat4.copy(out, this.#worldTransform);\n  }\n\n  GetWorldPosition(out = vec3.create())\n  {\n    return mat4.getTranslation(out, this.#worldTransform);\n  }\n\n  GetWorldRotation(out = quat.create())\n  {\n    return quat.normalize(out, mat4.getRotation(out, this.#worldTransform));\n  }\n\n  GetLocalBoundingBox(outMin, outMax)\n  {\n    vec3.set(outMin, -1, -1, -1);\n    vec3.set(outMax, 1, 1, 1);\n    return true;\n  }\n\n  UpdateWorldTransform(time)\n  {\n    const translation = vec3.clone(this.translation);\n    const rotation = quat.clone(this.rotation);\n    this.translationCurve?.Update?.(translation, time);\n    this.rotationCurve?.Update?.(rotation, time);\n    mat4.fromRotationTranslation(this.#worldTransform, rotation, translation);\n    return this.#worldTransform;\n  }\n\n  #SetEmitterPosition(position)\n  {\n    const rotation = this.GetWorldRotation(quat.create());\n    const front = vec3.transformQuat(vec3.create(), AudioGameObject.FRONT, rotation);\n    const top = vec3.transformQuat(vec3.create(), AudioGameObject.TOP, rotation);\n    this.audioEmitter?.SetPosition?.(front, top, position);\n  }\n\n  static FRONT = Object.freeze([0, 1, 0]);\n  static TOP = Object.freeze([0, 0, 1]);\n}\n"],"names":["_AudioGameObject","_identity","AudioGameObject","CjsModel","e","_init_audioEmitter","_init_extra_audioEmitter","_init_translationCurve","_init_extra_translationCurve","_init_rotationCurve","_init_extra_rotationCurve","_init_externalParameters","_init_extra_externalParameters","_init_rotation","_init_extra_rotation","_init_translation","_init_extra_translation","_init_mute","_init_extra_mute","_init_name","_init_extra_name","_init_display","_init_extra_display","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persist","objectRef","model","list","quat","vec3","notify","readwrite","boolean","string","carbon","method","impl","adapted","implemented","constructor","args","mat4","create","audioEmitter","translationCurve","rotationCurve","externalParameters","rotation","translation","mute","name","display","Initialize","Emitter","CjsSchema","GetConstructor","UpdateWorldTransform","position","GetWorldPosition","initialized","__init__","GetAudioEmitter","SetEmitterName","SetName","String","PlayAudioEvent","eventName","SendEvent","OnModified","value","UpdateSyncronous","updateContext","time","GetTime","UpdateAsyncronous","_updateContext","UpdateVisibility","_parentTransform","GetRenderables","_renderables","_impostors","GetBoundingSphere","out","vec4","set","GetLocalToWorldTransform","copy","getTranslation","GetWorldRotation","normalize","getRotation","GetLocalBoundingBox","outMin","outMax","clone","Update","fromRotationTranslation","#SetEmitterPosition","front","transformQuat","FRONT","top","TOP","SetPosition","Object","freeze"],"mappings":"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"}
+{"version":3,"file":"AudioGameObject.js","sources":["../../../src/eve/AudioGameObject.js"],"sourcesContent":["// Ported/adapted from CarbonEngine (MIT, (c) 2026 CCP Games) - https://github.com/carbonengine/trinity\n//   trinity/trinity/Eve/AudioGameObject.h\n//   trinity/trinity/Eve/AudioGameObject.cpp\nimport { mat4 } from \"@carbonenginejs/runtime-utils/mat4\";\nimport { quat } from \"@carbonenginejs/runtime-utils/quat\";\nimport { vec3 } from \"@carbonenginejs/runtime-utils/vec3\";\nimport { vec4 } from \"@carbonenginejs/runtime-utils/vec4\";\nimport { CjsModel } from \"@carbonenginejs/runtime-utils/model\";\nimport { carbon, CjsSchema, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\n\n\n/**\n * A freely placed audio emitter driven by its own translation and rotation\n * curves, so a sound can sit anywhere in a scene without being attached to an\n * asset.\n */\n@type.define({ className: \"AudioGameObject\", family: \"eve\" })\nexport class AudioGameObject extends CjsModel\n{\n  #worldTransform = mat4.create();\n\n  @io.persist\n  @type.objectRef(\"ITr2AudEmitter\")\n  audioEmitter = null;\n\n  @io.persist\n  @type.model(\"ITriVectorFunction\")\n  translationCurve = null;\n\n  @io.persist\n  @type.model(\"ITriQuaternionFunction\")\n  rotationCurve = null;\n\n  @io.persist\n  @type.list(\"Tr2ExternalParameter\")\n  externalParameters = [];\n\n  @io.persist\n  @type.quat\n  rotation = quat.create();\n\n  @io.persist\n  @type.vec3\n  translation = vec3.create();\n\n  @io.notify\n  @io.readwrite\n  @type.boolean\n  mute = false;\n\n  @io.persist\n  @type.string\n  name = \"\";\n\n  @io.readwrite\n  @type.boolean\n  display = true;\n\n  /**\n   * Creates the emitter from the registered AudEmitter class if there is not one\n   * already, places it at the object's current world position, and reports\n   * whether the emitter accepted initialization.\n   */\n  Initialize()\n  {\n    if (this.audioEmitter) return true;\n    const Emitter = CjsSchema.GetConstructor(\"AudEmitter\");\n    if (!Emitter) return false;\n    this.audioEmitter = new Emitter();\n    this.UpdateWorldTransform(0);\n    const position = this.GetWorldPosition(vec3.create());\n    const initialized = this.audioEmitter.Initialize?.(this.name || \"audio_object\", \"\", position);\n    this.#SetEmitterPosition(position);\n    return initialized !== false;\n  }\n\n  /** Post-hydration hook; runs Initialize. */\n  @carbon.method\n  @impl.adapted\n  __init__()\n  {\n    return this.Initialize();\n  }\n\n  /** The emitter this object drives, or null before Initialize has run. */\n  @carbon.method\n  @impl.implemented\n  GetAudioEmitter()\n  {\n    return this.audioEmitter;\n  }\n\n  /**\n   * Renames the underlying emitter without touching this object's own name\n   * field.\n   */\n  @carbon.method\n  @impl.implemented\n  SetEmitterName(name)\n  {\n    this.audioEmitter?.SetName?.(String(name));\n  }\n\n  /**\n   * Sends a named event to the emitter and returns the identifier it hands back,\n   * or 0 when there is no emitter or no event name.\n   */\n  @carbon.method\n  @impl.implemented\n  PlayAudioEvent(eventName)\n  {\n    if (!this.audioEmitter || !eventName) return 0;\n    return this.audioEmitter.SendEvent?.(String(eventName)) ?? 0;\n  }\n\n  /** Applies a changed mute flag or name to the emitter after a model update. */\n  OnModified(value = null)\n  {\n    if (value === \"mute\" || value === this.mute)\n    {\n      this.audioEmitter?.[this.mute ? \"Mute\" : \"Unmute\"]?.();\n    }\n    if (value === \"name\" || value === this.name)\n    {\n      this.SetEmitterName(this.name || \"audio_object\");\n    }\n    return true;\n  }\n\n  /**\n   * Re-evaluates the transform curves for the frame and pushes the resulting\n   * position and orientation to the emitter, unless the object is muted.\n   */\n  UpdateSyncronous(updateContext = null)\n  {\n    const time = updateContext?.GetTime?.() ?? updateContext?.time ?? 0;\n    this.UpdateWorldTransform(time);\n    if (this.audioEmitter && !this.mute)\n    {\n      this.#SetEmitterPosition(this.GetWorldPosition(vec3.create()));\n    }\n  }\n\n  /**\n   * IEveSpaceObject2 asynchronous phase; the object does all of its work\n   * synchronously.\n   */\n  UpdateAsyncronous(_updateContext = null)\n  {\n  }\n\n  /** IEveSpaceObject2 hook; an audio object has nothing to cull. */\n  UpdateVisibility(_updateContext, _parentTransform)\n  {\n  }\n\n  /** IEveSpaceObject2 hook; an audio object contributes no renderables. */\n  GetRenderables(_renderables, _impostors = null)\n  {\n  }\n\n  /**\n   * Reports a unit sphere at the object's world position, so scene traversal has something to place it by.\n   * @param {Array} out - caller-owned packed (x, y, z, radius), overwritten\n   */\n  GetBoundingSphere(out = vec4.create())\n  {\n    const position = this.GetWorldPosition(vec3.create());\n    vec4.set(out, position[0], position[1], position[2], 1);\n    return true;\n  }\n\n  /**\n   * Copies the transform stamped by the last UpdateWorldTransform.\n   * @param {Array} [out] - caller-owned mat4; a fresh matrix is allocated when omitted\n   * @returns {Array} out\n   */\n  GetLocalToWorldTransform(out = mat4.create())\n  {\n    return mat4.copy(out, this.#worldTransform);\n  }\n\n  /**\n   * Copies the translation of the transform stamped by the last UpdateWorldTransform.\n   * @param {Array} [out] - caller-owned vec3; a fresh vector is allocated when omitted\n   * @returns {Array} out\n   */\n  GetWorldPosition(out = vec3.create())\n  {\n    return mat4.getTranslation(out, this.#worldTransform);\n  }\n\n  /**\n   * Copies the normalized rotation of the transform stamped by the last UpdateWorldTransform.\n   * @param {Array} [out] - caller-owned quat; a fresh quaternion is allocated when omitted\n   * @returns {Array} out\n   */\n  GetWorldRotation(out = quat.create())\n  {\n    return quat.normalize(out, mat4.getRotation(out, this.#worldTransform));\n  }\n\n  /**\n   * Reports a fixed unit cube; the object has no geometry, but scene code\n   * expects a box.\n   */\n  GetLocalBoundingBox(outMin, outMax)\n  {\n    vec3.set(outMin, -1, -1, -1);\n    vec3.set(outMax, 1, 1, 1);\n    return true;\n  }\n\n  /**\n   * Rebuilds the world transform from the authored translation and rotation after letting the transform curves overwrite them at the given time.\n   * @returns {Array} the object's own matrix, valid only until the next call\n   */\n  UpdateWorldTransform(time)\n  {\n    const translation = vec3.clone(this.translation);\n    const rotation = quat.clone(this.rotation);\n    this.translationCurve?.Update?.(translation, time);\n    this.rotationCurve?.Update?.(rotation, time);\n    mat4.fromRotationTranslation(this.#worldTransform, rotation, translation);\n    return this.#worldTransform;\n  }\n\n  /**\n   * IEveSpaceObject2 hook (AudioGameObject.cpp:91-93): an audio game object is\n   * not rendered, so it contributes nothing to a child's per-object records and\n   * Carbon's body is empty. Present so a child parented to one can call it.\n   */\n  @carbon.method\n  @impl.noop\n  GetPerObjectStructs(_vsData, _psData)\n  {\n  }\n\n  /**\n   * Pushes a position to the emitter together with the object's front and top\n   * axes rotated into world space, which is what gives the sound its\n   * orientation.\n   */\n  #SetEmitterPosition(position)\n  {\n    const rotation = this.GetWorldRotation(quat.create());\n    const front = vec3.transformQuat(vec3.create(), AudioGameObject.FRONT, rotation);\n    const top = vec3.transformQuat(vec3.create(), AudioGameObject.TOP, rotation);\n    this.audioEmitter?.SetPosition?.(front, top, position);\n  }\n\n  static FRONT = Object.freeze([0, 1, 0]);\n  static TOP = Object.freeze([0, 0, 1]);\n}\n"],"names":["_AudioGameObject","_identity","AudioGameObject","CjsModel","e","_init_audioEmitter","_init_extra_audioEmitter","_init_translationCurve","_init_extra_translationCurve","_init_rotationCurve","_init_extra_rotationCurve","_init_externalParameters","_init_extra_externalParameters","_init_rotation","_init_extra_rotation","_init_translation","_init_extra_translation","_init_mute","_init_extra_mute","_init_name","_init_extra_name","_init_display","_init_extra_display","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persist","objectRef","model","list","quat","vec3","notify","readwrite","boolean","string","carbon","method","impl","adapted","implemented","noop","constructor","args","mat4","create","audioEmitter","translationCurve","rotationCurve","externalParameters","rotation","translation","mute","name","display","Initialize","Emitter","CjsSchema","GetConstructor","UpdateWorldTransform","position","GetWorldPosition","initialized","__init__","GetAudioEmitter","SetEmitterName","SetName","String","PlayAudioEvent","eventName","SendEvent","OnModified","value","UpdateSyncronous","updateContext","time","GetTime","UpdateAsyncronous","_updateContext","UpdateVisibility","_parentTransform","GetRenderables","_renderables","_impostors","GetBoundingSphere","out","vec4","set","GetLocalToWorldTransform","copy","getTranslation","GetWorldRotation","normalize","getRotation","GetLocalBoundingBox","outMin","outMax","clone","Update","fromRotationTranslation","GetPerObjectStructs","_vsData","_psData","#SetEmitterPosition","front","transformQuat","FRONT","top","TOP","SetPosition","Object","freeze"],"mappings":"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"}

package/dist/eve/BackAndForthData.js

@@ -4,6 +4,13 @@ import { CjsModel } from '@carbonenginejs/runtime-utils/model';
 import { type } from '@carbonenginejs/runtime-utils/schema';
 
 let _initClass, _init_locatorTarget, _init_extra_locatorTarget, _init_locatorDirection, _init_extra_locatorDirection, _init_locatorIndex, _init_extra_locatorIndex, _init_seek, _init_extra_seek, _init_deliver, _init_extra_deliver, _init_arrived, _init_extra_arrived, _init_timePassed, _init_extra_timePassed;
+
+/**
+ * Per-agent scratch for the BackAndForth child behaviour: the locator the agent
+ * is travelling to, the direction it approaches from, and how far through the
+ * trip it is. The behaviour allocates one record per agent and rewrites it on
+ * every behaviour update.
+ */
 let _BackAndForthData;
 class BackAndForthData extends CjsModel {
   static {

package/dist/eve/BackAndForthData.js.map

@@ -1 +1 @@
-{"version":3,"file":"BackAndForthData.js","sources":["../../../src/eve/BackAndForthData.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\SpaceObject\\Children\\Behaviors\\BackAndForth.h\nimport { vec3 } from \"@carbonenginejs/runtime-utils/vec3\";\nimport { CjsModel } from \"@carbonenginejs/runtime-utils/model\";\nimport { type } from \"@carbonenginejs/runtime-utils/schema\";\n\n\n@type.define({\n  className: \"BackAndForthData\",\n  family: \"eve/child/behaviors\"\n})\nexport class BackAndForthData extends CjsModel\n{\n  @type.vec3\n  locatorTarget = vec3.create();\n\n  @type.vec3\n  locatorDirection = vec3.create();\n\n  @type.int32\n  locatorIndex = -1;\n\n  @type.boolean\n  seek = true;\n\n  @type.boolean\n  deliver = false;\n\n  @type.boolean\n  arrived = true;\n\n  @type.float32\n  timePassed = 0;\n}\n"],"names":["_BackAndForthData","BackAndForthData","CjsModel","e","_init_locatorTarget","_init_extra_locatorTarget","_init_locatorDirection","_init_extra_locatorDirection","_init_locatorIndex","_init_extra_locatorIndex","_init_seek","_init_extra_seek","_init_deliver","_init_extra_deliver","_init_arrived","_init_extra_arrived","_init_timePassed","_init_extra_timePassed","c","_initClass","_applyDecs","type","define","className","family","vec3","int32","boolean","float32","constructor","args","locatorTarget","create","locatorDirection","locatorIndex","seek","deliver","arrived","timePassed"],"mappings":";;;;;;AAG4D,IAAAA;AAG5D,MAAAC,gBAAA,SAIsCC,QAAQ,CAC9C;AAAA,EAAA;AAAA,IAAA,CAAA;MAAAC,CAAA,EAAA,CAAAC,mBAAA,EAAAC,yBAAA,EAAAC,sBAAA,EAAAC,4BAAA,EAAAC,kBAAA,EAAAC,wBAAA,EAAAC,UAAA,EAAAC,gBAAA,EAAAC,aAAA,EAAAC,mBAAA,EAAAC,aAAA,EAAAC,mBAAA,EAAAC,gBAAA,EAAAC,sBAAA,CAAA;MAAAC,CAAA,EAAA,CAAAlB,iBAAA,EAAAmB,UAAA;AAAA,KAAA,GAAAC,cAAA,CAAA,IAAA,EAAA,CALCC,IAAI,CAACC,MAAM,CAAC;AACXC,MAAAA,SAAS,EAAE,kBAAkB;AAC7BC,MAAAA,MAAM,EAAE;KACT,CAAC,MAGCH,IAAI,EAAJA,IAAI,CAACI,IAAI,2BAGTJ,IAAI,EAAJA,IAAI,CAACI,IAAI,8BAGTJ,IAAI,EAAJA,IAAI,CAACK,KAAK,0BAGVL,IAAI,EAAJA,IAAI,CAACM,OAAO,kBAGZN,IAAI,EAAJA,IAAI,CAACM,OAAO,qBAGZN,IAAI,EAAJA,IAAI,CAACM,OAAO,qBAGZN,IAAI,EAAJA,IAAI,CAACO,OAAO,kCApBuB1B,QAAQ,CAAA;AAAA;AAAA2B,EAAAA,WAAAA,CAAA,GAAAC,IAAA,EAAA;AAAA,IAAA,KAAA,CAAA,GAAAA,IAAA,CAAA;IAAAb,sBAAA,CAAA,IAAA,CAAA;AAAA,EAAA;AAG5Cc,EAAAA,aAAa,GAAA3B,mBAAA,CAAA,IAAA,EAAGqB,IAAI,CAACO,MAAM,EAAE,CAAA;EAG7BC,gBAAgB,IAAA5B,yBAAA,CAAA,IAAA,CAAA,EAAAC,sBAAA,OAAGmB,IAAI,CAACO,MAAM,EAAE,CAAA;AAGhCE,EAAAA,YAAY,IAAA3B,4BAAA,CAAA,IAAA,CAAA,EAAAC,kBAAA,CAAA,IAAA,EAAG,EAAE,CAAA;AAGjB2B,EAAAA,IAAI,IAAA1B,wBAAA,CAAA,IAAA,CAAA,EAAAC,UAAA,OAAG,IAAI,CAAA;AAGX0B,EAAAA,OAAO,IAAAzB,gBAAA,CAAA,IAAA,CAAA,EAAAC,aAAA,OAAG,KAAK,CAAA;AAGfyB,EAAAA,OAAO,IAAAxB,mBAAA,CAAA,IAAA,CAAA,EAAAC,aAAA,OAAG,IAAI,CAAA;AAGdwB,EAAAA,UAAU,IAAAvB,mBAAA,CAAA,IAAA,CAAA,EAAAC,gBAAA,OAAG,CAAC,CAAA;AAAC,EAAA;IAAAG,UAAA,EAAA;AAAA;AACjB;;;;"}
+{"version":3,"file":"BackAndForthData.js","sources":["../../../src/eve/BackAndForthData.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\SpaceObject\\Children\\Behaviors\\BackAndForth.h\nimport { vec3 } from \"@carbonenginejs/runtime-utils/vec3\";\nimport { CjsModel } from \"@carbonenginejs/runtime-utils/model\";\nimport { type } from \"@carbonenginejs/runtime-utils/schema\";\n\n\n/**\n * Per-agent scratch for the BackAndForth child behaviour: the locator the agent\n * is travelling to, the direction it approaches from, and how far through the\n * trip it is. The behaviour allocates one record per agent and rewrites it on\n * every behaviour update.\n */\n@type.define({\n  className: \"BackAndForthData\",\n  family: \"eve/child/behaviors\"\n})\nexport class BackAndForthData extends CjsModel\n{\n  @type.vec3\n  locatorTarget = vec3.create();\n\n  @type.vec3\n  locatorDirection = vec3.create();\n\n  @type.int32\n  locatorIndex = -1;\n\n  @type.boolean\n  seek = true;\n\n  @type.boolean\n  deliver = false;\n\n  @type.boolean\n  arrived = true;\n\n  @type.float32\n  timePassed = 0;\n}\n"],"names":["_BackAndForthData","BackAndForthData","CjsModel","e","_init_locatorTarget","_init_extra_locatorTarget","_init_locatorDirection","_init_extra_locatorDirection","_init_locatorIndex","_init_extra_locatorIndex","_init_seek","_init_extra_seek","_init_deliver","_init_extra_deliver","_init_arrived","_init_extra_arrived","_init_timePassed","_init_extra_timePassed","c","_initClass","_applyDecs","type","define","className","family","vec3","int32","boolean","float32","constructor","args","locatorTarget","create","locatorDirection","locatorIndex","seek","deliver","arrived","timePassed"],"mappings":";;;;;;;AAMA;AACA;AACA;AACA;AACA;AACA;AALA,IAAAA;AAMA,MAAAC,gBAAA,SAIsCC,QAAQ,CAC9C;AAAA,EAAA;AAAA,IAAA,CAAA;MAAAC,CAAA,EAAA,CAAAC,mBAAA,EAAAC,yBAAA,EAAAC,sBAAA,EAAAC,4BAAA,EAAAC,kBAAA,EAAAC,wBAAA,EAAAC,UAAA,EAAAC,gBAAA,EAAAC,aAAA,EAAAC,mBAAA,EAAAC,aAAA,EAAAC,mBAAA,EAAAC,gBAAA,EAAAC,sBAAA,CAAA;MAAAC,CAAA,EAAA,CAAAlB,iBAAA,EAAAmB,UAAA;AAAA,KAAA,GAAAC,cAAA,CAAA,IAAA,EAAA,CALCC,IAAI,CAACC,MAAM,CAAC;AACXC,MAAAA,SAAS,EAAE,kBAAkB;AAC7BC,MAAAA,MAAM,EAAE;KACT,CAAC,MAGCH,IAAI,EAAJA,IAAI,CAACI,IAAI,2BAGTJ,IAAI,EAAJA,IAAI,CAACI,IAAI,8BAGTJ,IAAI,EAAJA,IAAI,CAACK,KAAK,0BAGVL,IAAI,EAAJA,IAAI,CAACM,OAAO,kBAGZN,IAAI,EAAJA,IAAI,CAACM,OAAO,qBAGZN,IAAI,EAAJA,IAAI,CAACM,OAAO,qBAGZN,IAAI,EAAJA,IAAI,CAACO,OAAO,kCApBuB1B,QAAQ,CAAA;AAAA;AAAA2B,EAAAA,WAAAA,CAAA,GAAAC,IAAA,EAAA;AAAA,IAAA,KAAA,CAAA,GAAAA,IAAA,CAAA;IAAAb,sBAAA,CAAA,IAAA,CAAA;AAAA,EAAA;AAG5Cc,EAAAA,aAAa,GAAA3B,mBAAA,CAAA,IAAA,EAAGqB,IAAI,CAACO,MAAM,EAAE,CAAA;EAG7BC,gBAAgB,IAAA5B,yBAAA,CAAA,IAAA,CAAA,EAAAC,sBAAA,OAAGmB,IAAI,CAACO,MAAM,EAAE,CAAA;AAGhCE,EAAAA,YAAY,IAAA3B,4BAAA,CAAA,IAAA,CAAA,EAAAC,kBAAA,CAAA,IAAA,EAAG,EAAE,CAAA;AAGjB2B,EAAAA,IAAI,IAAA1B,wBAAA,CAAA,IAAA,CAAA,EAAAC,UAAA,OAAG,IAAI,CAAA;AAGX0B,EAAAA,OAAO,IAAAzB,gBAAA,CAAA,IAAA,CAAA,EAAAC,aAAA,OAAG,KAAK,CAAA;AAGfyB,EAAAA,OAAO,IAAAxB,mBAAA,CAAA,IAAA,CAAA,EAAAC,aAAA,OAAG,IAAI,CAAA;AAGdwB,EAAAA,UAAU,IAAAvB,mBAAA,CAAA,IAAA,CAAA,EAAAC,gBAAA,OAAG,CAAC,CAAA;AAAC,EAAA;IAAAG,UAAA,EAAA;AAAA;AACjB;;;;"}

package/dist/eve/CjsDistributionRandom.js

@@ -15,6 +15,12 @@ function createMinStdRandom(seed) {
     return (state - 1) / (modulus - 1);
   };
 }
+
+/**
+ * Seed for a placement's random stream: the placement's own unique ID when the
+ * distribution wants a result that is stable across runs, otherwise the time
+ * seed shifted left by that ID.
+ */
 function getDistributionSeed(uniqueID, timeSeed, consistentRandom) {
   const id = Number(uniqueID) >>> 0;
   return consistentRandom ? id : Number(timeSeed) << id % 11 >>> 0;

package/dist/eve/CjsDistributionRandom.js.map

@@ -1 +1 @@
-{"version":3,"file":"CjsDistributionRandom.js","sources":["../../../src/eve/CjsDistributionRandom.js"],"sourcesContent":["/**\n * Carbon distribution helpers shared by the generated placement modifiers.\n * std::minstd_rand is Park-Miller with multiplier 48271 and modulus 2^31 - 1.\n */\nexport function createMinStdRandom(seed)\n{\n  const modulus = 2147483647;\n  let state = Math.trunc(seed) % modulus;\n  if (state === 0)\n  {\n    state = 1;\n  }\n  else if (state < 0)\n  {\n    state += modulus;\n  }\n\n  return function next()\n  {\n    state = state * 48271 % modulus;\n    return (state - 1) / (modulus - 1);\n  };\n}\n\n\nexport function getDistributionSeed(uniqueID, timeSeed, consistentRandom)\n{\n  const id = Number(uniqueID) >>> 0;\n  return consistentRandom ? id : (Number(timeSeed) << (id % 11)) >>> 0;\n}\n\n\n/** Carbon math::RotationQuaternion(yaw, pitch, roll), with radian inputs. */\nexport function setYawPitchRoll(out, yaw, pitch, roll)\n{\n  const sinYaw = Math.sin(yaw / 2);\n  const cosYaw = Math.cos(yaw / 2);\n  const sinPitch = Math.sin(pitch / 2);\n  const cosPitch = Math.cos(pitch / 2);\n  const sinRoll = Math.sin(roll / 2);\n  const cosRoll = Math.cos(roll / 2);\n\n  out[0] = sinYaw * cosPitch * sinRoll + cosYaw * sinPitch * cosRoll;\n  out[1] = sinYaw * cosPitch * cosRoll - cosYaw * sinPitch * sinRoll;\n  out[2] = cosYaw * cosPitch * sinRoll - sinYaw * sinPitch * cosRoll;\n  out[3] = cosYaw * cosPitch * cosRoll + sinYaw * sinPitch * sinRoll;\n  return out;\n}\n"],"names":["createMinStdRandom","seed","modulus","state","Math","trunc","next","getDistributionSeed","uniqueID","timeSeed","consistentRandom","id","Number","setYawPitchRoll","out","yaw","pitch","roll","sinYaw","sin","cosYaw","cos","sinPitch","cosPitch","sinRoll","cosRoll"],"mappings":"AAAA;AACA;AACA;AACA;AACO,SAASA,kBAAkBA,CAACC,IAAI,EACvC;EACE,MAAMC,OAAO,GAAG,UAAU;EAC1B,IAAIC,KAAK,GAAGC,IAAI,CAACC,KAAK,CAACJ,IAAI,CAAC,GAAGC,OAAO;EACtC,IAAIC,KAAK,KAAK,CAAC,EACf;AACEA,IAAAA,KAAK,GAAG,CAAC;AACX,EAAA,CAAC,MACI,IAAIA,KAAK,GAAG,CAAC,EAClB;AACEA,IAAAA,KAAK,IAAID,OAAO;AAClB,EAAA;EAEA,OAAO,SAASI,IAAIA,GACpB;AACEH,IAAAA,KAAK,GAAGA,KAAK,GAAG,KAAK,GAAGD,OAAO;IAC/B,OAAO,CAACC,KAAK,GAAG,CAAC,KAAKD,OAAO,GAAG,CAAC,CAAC;EACpC,CAAC;AACH;AAGO,SAASK,mBAAmBA,CAACC,QAAQ,EAAEC,QAAQ,EAAEC,gBAAgB,EACxE;AACE,EAAA,MAAMC,EAAE,GAAGC,MAAM,CAACJ,QAAQ,CAAC,KAAK,CAAC;AACjC,EAAA,OAAOE,gBAAgB,GAAGC,EAAE,GAAIC,MAAM,CAACH,QAAQ,CAAC,IAAKE,EAAE,GAAG,EAAG,KAAM,CAAC;AACtE;;AAGA;AACO,SAASE,eAAeA,CAACC,GAAG,EAAEC,GAAG,EAAEC,KAAK,EAAEC,IAAI,EACrD;EACE,MAAMC,MAAM,GAAGd,IAAI,CAACe,GAAG,CAACJ,GAAG,GAAG,CAAC,CAAC;EAChC,MAAMK,MAAM,GAAGhB,IAAI,CAACiB,GAAG,CAACN,GAAG,GAAG,CAAC,CAAC;EAChC,MAAMO,QAAQ,GAAGlB,IAAI,CAACe,GAAG,CAACH,KAAK,GAAG,CAAC,CAAC;EACpC,MAAMO,QAAQ,GAAGnB,IAAI,CAACiB,GAAG,CAACL,KAAK,GAAG,CAAC,CAAC;EACpC,MAAMQ,OAAO,GAAGpB,IAAI,CAACe,GAAG,CAACF,IAAI,GAAG,CAAC,CAAC;EAClC,MAAMQ,OAAO,GAAGrB,IAAI,CAACiB,GAAG,CAACJ,IAAI,GAAG,CAAC,CAAC;AAElCH,EAAAA,GAAG,CAAC,CAAC,CAAC,GAAGI,MAAM,GAAGK,QAAQ,GAAGC,OAAO,GAAGJ,MAAM,GAAGE,QAAQ,GAAGG,OAAO;AAClEX,EAAAA,GAAG,CAAC,CAAC,CAAC,GAAGI,MAAM,GAAGK,QAAQ,GAAGE,OAAO,GAAGL,MAAM,GAAGE,QAAQ,GAAGE,OAAO;AAClEV,EAAAA,GAAG,CAAC,CAAC,CAAC,GAAGM,MAAM,GAAGG,QAAQ,GAAGC,OAAO,GAAGN,MAAM,GAAGI,QAAQ,GAAGG,OAAO;AAClEX,EAAAA,GAAG,CAAC,CAAC,CAAC,GAAGM,MAAM,GAAGG,QAAQ,GAAGE,OAAO,GAAGP,MAAM,GAAGI,QAAQ,GAAGE,OAAO;AAClE,EAAA,OAAOV,GAAG;AACZ;;;;"}
+{"version":3,"file":"CjsDistributionRandom.js","sources":["../../../src/eve/CjsDistributionRandom.js"],"sourcesContent":["/**\n * Carbon distribution helpers shared by the generated placement modifiers.\n * std::minstd_rand is Park-Miller with multiplier 48271 and modulus 2^31 - 1.\n */\nexport function createMinStdRandom(seed)\n{\n  const modulus = 2147483647;\n  let state = Math.trunc(seed) % modulus;\n  if (state === 0)\n  {\n    state = 1;\n  }\n  else if (state < 0)\n  {\n    state += modulus;\n  }\n\n  return function next()\n  {\n    state = state * 48271 % modulus;\n    return (state - 1) / (modulus - 1);\n  };\n}\n\n\n/**\n * Seed for a placement's random stream: the placement's own unique ID when the\n * distribution wants a result that is stable across runs, otherwise the time\n * seed shifted left by that ID.\n */\nexport function getDistributionSeed(uniqueID, timeSeed, consistentRandom)\n{\n  const id = Number(uniqueID) >>> 0;\n  return consistentRandom ? id : (Number(timeSeed) << (id % 11)) >>> 0;\n}\n\n\n/** Carbon math::RotationQuaternion(yaw, pitch, roll), with radian inputs. */\nexport function setYawPitchRoll(out, yaw, pitch, roll)\n{\n  const sinYaw = Math.sin(yaw / 2);\n  const cosYaw = Math.cos(yaw / 2);\n  const sinPitch = Math.sin(pitch / 2);\n  const cosPitch = Math.cos(pitch / 2);\n  const sinRoll = Math.sin(roll / 2);\n  const cosRoll = Math.cos(roll / 2);\n\n  out[0] = sinYaw * cosPitch * sinRoll + cosYaw * sinPitch * cosRoll;\n  out[1] = sinYaw * cosPitch * cosRoll - cosYaw * sinPitch * sinRoll;\n  out[2] = cosYaw * cosPitch * sinRoll - sinYaw * sinPitch * cosRoll;\n  out[3] = cosYaw * cosPitch * cosRoll + sinYaw * sinPitch * sinRoll;\n  return out;\n}\n"],"names":["createMinStdRandom","seed","modulus","state","Math","trunc","next","getDistributionSeed","uniqueID","timeSeed","consistentRandom","id","Number","setYawPitchRoll","out","yaw","pitch","roll","sinYaw","sin","cosYaw","cos","sinPitch","cosPitch","sinRoll","cosRoll"],"mappings":"AAAA;AACA;AACA;AACA;AACO,SAASA,kBAAkBA,CAACC,IAAI,EACvC;EACE,MAAMC,OAAO,GAAG,UAAU;EAC1B,IAAIC,KAAK,GAAGC,IAAI,CAACC,KAAK,CAACJ,IAAI,CAAC,GAAGC,OAAO;EACtC,IAAIC,KAAK,KAAK,CAAC,EACf;AACEA,IAAAA,KAAK,GAAG,CAAC;AACX,EAAA,CAAC,MACI,IAAIA,KAAK,GAAG,CAAC,EAClB;AACEA,IAAAA,KAAK,IAAID,OAAO;AAClB,EAAA;EAEA,OAAO,SAASI,IAAIA,GACpB;AACEH,IAAAA,KAAK,GAAGA,KAAK,GAAG,KAAK,GAAGD,OAAO;IAC/B,OAAO,CAACC,KAAK,GAAG,CAAC,KAAKD,OAAO,GAAG,CAAC,CAAC;EACpC,CAAC;AACH;;AAGA;AACA;AACA;AACA;AACA;AACO,SAASK,mBAAmBA,CAACC,QAAQ,EAAEC,QAAQ,EAAEC,gBAAgB,EACxE;AACE,EAAA,MAAMC,EAAE,GAAGC,MAAM,CAACJ,QAAQ,CAAC,KAAK,CAAC;AACjC,EAAA,OAAOE,gBAAgB,GAAGC,EAAE,GAAIC,MAAM,CAACH,QAAQ,CAAC,IAAKE,EAAE,GAAG,EAAG,KAAM,CAAC;AACtE;;AAGA;AACO,SAASE,eAAeA,CAACC,GAAG,EAAEC,GAAG,EAAEC,KAAK,EAAEC,IAAI,EACrD;EACE,MAAMC,MAAM,GAAGd,IAAI,CAACe,GAAG,CAACJ,GAAG,GAAG,CAAC,CAAC;EAChC,MAAMK,MAAM,GAAGhB,IAAI,CAACiB,GAAG,CAACN,GAAG,GAAG,CAAC,CAAC;EAChC,MAAMO,QAAQ,GAAGlB,IAAI,CAACe,GAAG,CAACH,KAAK,GAAG,CAAC,CAAC;EACpC,MAAMO,QAAQ,GAAGnB,IAAI,CAACiB,GAAG,CAACL,KAAK,GAAG,CAAC,CAAC;EACpC,MAAMQ,OAAO,GAAGpB,IAAI,CAACe,GAAG,CAACF,IAAI,GAAG,CAAC,CAAC;EAClC,MAAMQ,OAAO,GAAGrB,IAAI,CAACiB,GAAG,CAACJ,IAAI,GAAG,CAAC,CAAC;AAElCH,EAAAA,GAAG,CAAC,CAAC,CAAC,GAAGI,MAAM,GAAGK,QAAQ,GAAGC,OAAO,GAAGJ,MAAM,GAAGE,QAAQ,GAAGG,OAAO;AAClEX,EAAAA,GAAG,CAAC,CAAC,CAAC,GAAGI,MAAM,GAAGK,QAAQ,GAAGE,OAAO,GAAGL,MAAM,GAAGE,QAAQ,GAAGE,OAAO;AAClEV,EAAAA,GAAG,CAAC,CAAC,CAAC,GAAGM,MAAM,GAAGG,QAAQ,GAAGC,OAAO,GAAGN,MAAM,GAAGI,QAAQ,GAAGG,OAAO;AAClEX,EAAAA,GAAG,CAAC,CAAC,CAAC,GAAGM,MAAM,GAAGG,QAAQ,GAAGE,OAAO,GAAGP,MAAM,GAAGI,QAAQ,GAAGE,OAAO;AAClE,EAAA,OAAOV,GAAG;AACZ;;;;"}

package/dist/eve/CjsEveThrottleableState.js

@@ -1,7 +1,18 @@
 // Source: E:\carbonengine\trinity\trinity\Eve\SpaceObject\Utils\EveThrottleable.cpp
 
+/**
+ * The next-update clock behind EveThrottleable, held outside the schema so
+ * throttling state is never serialized or exported.
+ */
 class CjsEveThrottleableState {
   #nextUpdateTime = 0;
+
+  /**
+   * Reports whether the host should skip this update; when it should not, the host's update frequency is recomputed from the detail level and the next allowed time is scheduled.
+   * @param {Object} host - the EveThrottleable supplying updateThrottle and the min/max frequency bounds, and receiving currentUpdateFrequency
+   * @param {Number} [normalizedUpdateFrequency] - 0..1 detail level interpolating between the host's min and max frequency
+   * @returns {Boolean} true to skip this update
+   */
   ShouldSkipUpdate(host, normalizedUpdateFrequency = 0.5, currentTime) {
     if (!host.updateThrottle) {
       return false;

package/dist/eve/CjsEveThrottleableState.js.map

@@ -1 +1 @@
-{"version":3,"file":"CjsEveThrottleableState.js","sources":["../../../src/eve/CjsEveThrottleableState.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\SpaceObject\\Utils\\EveThrottleable.cpp\n\nexport class CjsEveThrottleableState\n{\n  #nextUpdateTime = 0;\n\n  ShouldSkipUpdate(host, normalizedUpdateFrequency = 0.5, currentTime)\n  {\n    if (!host.updateThrottle)\n    {\n      return false;\n    }\n    if (currentTime < this.#nextUpdateTime)\n    {\n      return true;\n    }\n    const updateFrequency = normalizedUpdateFrequency * (host.maxUpdateFrequency - host.minUpdateFrequency) + host.minUpdateFrequency;\n    host.currentUpdateFrequency = Math.max(updateFrequency, 0.1);\n    this.#nextUpdateTime = currentTime + 1 / host.currentUpdateFrequency;\n    return false;\n  }\n}\n"],"names":["CjsEveThrottleableState","ShouldSkipUpdate","host","normalizedUpdateFrequency","currentTime","updateThrottle","updateFrequency","maxUpdateFrequency","minUpdateFrequency","currentUpdateFrequency","Math","max"],"mappings":"AAAA;;AAEO,MAAMA,uBAAuB,CACpC;EACE,eAAe,GAAG,CAAC;EAEnBC,gBAAgBA,CAACC,IAAI,EAAEC,yBAAyB,GAAG,GAAG,EAAEC,WAAW,EACnE;AACE,IAAA,IAAI,CAACF,IAAI,CAACG,cAAc,EACxB;AACE,MAAA,OAAO,KAAK;AACd,IAAA;AACA,IAAA,IAAID,WAAW,GAAG,IAAI,CAAC,eAAe,EACtC;AACE,MAAA,OAAO,IAAI;AACb,IAAA;AACA,IAAA,MAAME,eAAe,GAAGH,yBAAyB,IAAID,IAAI,CAACK,kBAAkB,GAAGL,IAAI,CAACM,kBAAkB,CAAC,GAAGN,IAAI,CAACM,kBAAkB;IACjIN,IAAI,CAACO,sBAAsB,GAAGC,IAAI,CAACC,GAAG,CAACL,eAAe,EAAE,GAAG,CAAC;IAC5D,IAAI,CAAC,eAAe,GAAGF,WAAW,GAAG,CAAC,GAAGF,IAAI,CAACO,sBAAsB;AACpE,IAAA,OAAO,KAAK;AACd,EAAA;AACF;;;;"}
+{"version":3,"file":"CjsEveThrottleableState.js","sources":["../../../src/eve/CjsEveThrottleableState.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\SpaceObject\\Utils\\EveThrottleable.cpp\n\n/**\n * The next-update clock behind EveThrottleable, held outside the schema so\n * throttling state is never serialized or exported.\n */\nexport class CjsEveThrottleableState\n{\n  #nextUpdateTime = 0;\n\n  /**\n   * Reports whether the host should skip this update; when it should not, the host's update frequency is recomputed from the detail level and the next allowed time is scheduled.\n   * @param {Object} host - the EveThrottleable supplying updateThrottle and the min/max frequency bounds, and receiving currentUpdateFrequency\n   * @param {Number} [normalizedUpdateFrequency] - 0..1 detail level interpolating between the host's min and max frequency\n   * @returns {Boolean} true to skip this update\n   */\n  ShouldSkipUpdate(host, normalizedUpdateFrequency = 0.5, currentTime)\n  {\n    if (!host.updateThrottle)\n    {\n      return false;\n    }\n    if (currentTime < this.#nextUpdateTime)\n    {\n      return true;\n    }\n    const updateFrequency = normalizedUpdateFrequency * (host.maxUpdateFrequency - host.minUpdateFrequency) + host.minUpdateFrequency;\n    host.currentUpdateFrequency = Math.max(updateFrequency, 0.1);\n    this.#nextUpdateTime = currentTime + 1 / host.currentUpdateFrequency;\n    return false;\n  }\n}\n"],"names":["CjsEveThrottleableState","ShouldSkipUpdate","host","normalizedUpdateFrequency","currentTime","updateThrottle","updateFrequency","maxUpdateFrequency","minUpdateFrequency","currentUpdateFrequency","Math","max"],"mappings":"AAAA;;AAEA;AACA;AACA;AACA;AACO,MAAMA,uBAAuB,CACpC;EACE,eAAe,GAAG,CAAC;;AAEnB;AACF;AACA;AACA;AACA;AACA;EACEC,gBAAgBA,CAACC,IAAI,EAAEC,yBAAyB,GAAG,GAAG,EAAEC,WAAW,EACnE;AACE,IAAA,IAAI,CAACF,IAAI,CAACG,cAAc,EACxB;AACE,MAAA,OAAO,KAAK;AACd,IAAA;AACA,IAAA,IAAID,WAAW,GAAG,IAAI,CAAC,eAAe,EACtC;AACE,MAAA,OAAO,IAAI;AACb,IAAA;AACA,IAAA,MAAME,eAAe,GAAGH,yBAAyB,IAAID,IAAI,CAACK,kBAAkB,GAAGL,IAAI,CAACM,kBAAkB,CAAC,GAAGN,IAAI,CAACM,kBAAkB;IACjIN,IAAI,CAACO,sBAAsB,GAAGC,IAAI,CAACC,GAAG,CAACL,eAAe,EAAE,GAAG,CAAC;IAC5D,IAAI,CAAC,eAAe,GAAGF,WAAW,GAAG,CAAC,GAAGF,IAAI,CAACO,sBAAsB;AACpE,IAAA,OAAO,KAAK;AACd,EAAA;AACF;;;;"}

package/dist/eve/EveChildUpdateParams.js

@@ -5,6 +5,13 @@ import { CjsModel } from '@carbonenginejs/runtime-utils/model';
 import { type } from '@carbonenginejs/runtime-utils/schema';
 
 let _initClass, _init_spaceObjectParent, _init_extra_spaceObjectParent, _init_childParent, _init_extra_childParent, _init_boneCount, _init_extra_boneCount, _init_bones, _init_extra_bones, _init_ownerMaxSpeed, _init_extra_ownerMaxSpeed, _init_activationStrength, _init_extra_activationStrength, _init_controllerUpdateFrequency, _init_extra_controllerUpdateFrequency, _init_isVisible, _init_extra_isVisible, _init_localToWorldTransform, _init_extra_localToWorldTransform, _init_worldVelocity, _init_extra_worldVelocity;
+
+/**
+ * The parameter block a parent passes down when updating a space-object child:
+ * the parent references, the parent's bone array, the child's world placement,
+ * and the owner's motion and activation state. Rebuilt by the parent for each
+ * child update, so nothing in it survives the call.
+ */
 let _EveChildUpdateParams;
 class EveChildUpdateParams extends CjsModel {
   static {

package/dist/eve/EveChildUpdateParams.js.map

@@ -1 +1 @@
-{"version":3,"file":"EveChildUpdateParams.js","sources":["../../../src/eve/EveChildUpdateParams.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\SpaceObject\\Children\\IEveSpaceObjectChild.h\nimport { mat4 } from \"@carbonenginejs/runtime-utils/mat4\";\nimport { vec3 } from \"@carbonenginejs/runtime-utils/vec3\";\nimport { CjsModel } from \"@carbonenginejs/runtime-utils/model\";\nimport { type } from \"@carbonenginejs/runtime-utils/schema\";\n\n\n@type.define({\n  className: \"EveChildUpdateParams\",\n  family: \"eve/child\"\n})\nexport class EveChildUpdateParams extends CjsModel\n{\n  @type.objectRef(\"IEveSpaceObject2\")\n  spaceObjectParent = null;\n\n  @type.objectRef(\"IEveSpaceObjectChild\")\n  childParent = null;\n\n  @type.uint64\n  boneCount = 0;\n\n  @type.objectRef(\"Float4x3\")\n  bones = null;\n\n  @type.float32\n  ownerMaxSpeed = 0;\n\n  @type.float32\n  activationStrength = 1;\n\n  @type.float32\n  controllerUpdateFrequency = 0.5;\n\n  @type.boolean\n  isVisible = true;\n\n  @type.mat4\n  localToWorldTransform = mat4.create();\n\n  @type.vec3\n  worldVelocity = vec3.create();\n}\n"],"names":["_EveChildUpdateParams","EveChildUpdateParams","CjsModel","e","_init_spaceObjectParent","_init_extra_spaceObjectParent","_init_childParent","_init_extra_childParent","_init_boneCount","_init_extra_boneCount","_init_bones","_init_extra_bones","_init_ownerMaxSpeed","_init_extra_ownerMaxSpeed","_init_activationStrength","_init_extra_activationStrength","_init_controllerUpdateFrequency","_init_extra_controllerUpdateFrequency","_init_isVisible","_init_extra_isVisible","_init_localToWorldTransform","_init_extra_localToWorldTransform","_init_worldVelocity","_init_extra_worldVelocity","c","_initClass","_applyDecs","type","define","className","family","objectRef","uint64","float32","boolean","mat4","vec3","constructor","args","spaceObjectParent","childParent","boneCount","bones","ownerMaxSpeed","activationStrength","controllerUpdateFrequency","isVisible","localToWorldTransform","create","worldVelocity"],"mappings":"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"}
+{"version":3,"file":"EveChildUpdateParams.js","sources":["../../../src/eve/EveChildUpdateParams.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\SpaceObject\\Children\\IEveSpaceObjectChild.h\nimport { mat4 } from \"@carbonenginejs/runtime-utils/mat4\";\nimport { vec3 } from \"@carbonenginejs/runtime-utils/vec3\";\nimport { CjsModel } from \"@carbonenginejs/runtime-utils/model\";\nimport { type } from \"@carbonenginejs/runtime-utils/schema\";\n\n\n/**\n * The parameter block a parent passes down when updating a space-object child:\n * the parent references, the parent's bone array, the child's world placement,\n * and the owner's motion and activation state. Rebuilt by the parent for each\n * child update, so nothing in it survives the call.\n */\n@type.define({\n  className: \"EveChildUpdateParams\",\n  family: \"eve/child\"\n})\nexport class EveChildUpdateParams extends CjsModel\n{\n  @type.objectRef(\"IEveSpaceObject2\")\n  spaceObjectParent = null;\n\n  @type.objectRef(\"IEveSpaceObjectChild\")\n  childParent = null;\n\n  @type.uint64\n  boneCount = 0;\n\n  @type.objectRef(\"Float4x3\")\n  bones = null;\n\n  @type.float32\n  ownerMaxSpeed = 0;\n\n  @type.float32\n  activationStrength = 1;\n\n  @type.float32\n  controllerUpdateFrequency = 0.5;\n\n  @type.boolean\n  isVisible = true;\n\n  @type.mat4\n  localToWorldTransform = mat4.create();\n\n  @type.vec3\n  worldVelocity = vec3.create();\n}\n"],"names":["_EveChildUpdateParams","EveChildUpdateParams","CjsModel","e","_init_spaceObjectParent","_init_extra_spaceObjectParent","_init_childParent","_init_extra_childParent","_init_boneCount","_init_extra_boneCount","_init_bones","_init_extra_bones","_init_ownerMaxSpeed","_init_extra_ownerMaxSpeed","_init_activationStrength","_init_extra_activationStrength","_init_controllerUpdateFrequency","_init_extra_controllerUpdateFrequency","_init_isVisible","_init_extra_isVisible","_init_localToWorldTransform","_init_extra_localToWorldTransform","_init_worldVelocity","_init_extra_worldVelocity","c","_initClass","_applyDecs","type","define","className","family","objectRef","uint64","float32","boolean","mat4","vec3","constructor","args","spaceObjectParent","childParent","boneCount","bones","ownerMaxSpeed","activationStrength","controllerUpdateFrequency","isVisible","localToWorldTransform","create","worldVelocity"],"mappings":"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"}

package/dist/eve/EveComponentTypes.js.map

@@ -1 +1 @@
-{"version":3,"file":"EveComponentTypes.js","sources":["../../../src/eve/EveComponentTypes.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\EveEntity.h\n// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\EveEntity.cpp\n// Shared component-name vocabulary for the EveComponentRegistry. Carbon binds\n// each registry collection to a compile-time interface through\n// REGISTER_COMPONENT_TYPE(name, interface); JavaScript has no template\n// specialization, so the verbatim name strings are the load-bearing contract.\nimport { ReflectionMode, ReflectionSetting } from \"../generated/eve/enums.js\";\n\nexport { ReflectionMode, ReflectionSetting };\n\n/**\n * The nine Carbon component-name strings (VERBATIM). Each entry cites the\n * REGISTER_COMPONENT_TYPE declaration that binds the name to its interface.\n */\nexport const EveComponentType = Object.freeze({\n  /** ITr2Renderable (ITr2Renderable.h:58). */\n  ReflectionRenderable: \"ReflectionRenderable\",\n  /** ITr2VolumetricRenderable (ITr2VolumetricRenderable.h:55). */\n  VolumetricRenderable: \"VolumetricRenderable\",\n  /** ITr2MeshMorph (ITr2MeshMorph.h:14). */\n  MeshMorph: \"MeshMorph\",\n  /** ITr2PostProcessOwner (PostProcess/ITr2PostProcessOwner.h:15). */\n  PostProcessOwner: \"PostProcessOwner\",\n  /** IEveInstanceMeshProvider (Eve/EveInstancedMeshManager.h:273). */\n  InstancedMeshProvider: \"InstancedMeshProvider\",\n  /** ITr2LightOwner (Lights/ITr2LightOwner.h:18). */\n  LightOwner: \"LightOwner\",\n  /** ITr2FroxelFogSettings (Tr2VolumetricsRenderer.h:57). */\n  FroxelFogSettings: \"FroxelFogSettings\",\n  /** IEveShadowCaster (Eve/IEveShadowCaster.h:164). */\n  ShadowCaster: \"ShadowCaster\",\n  /** IEveLightingOverride (EveChildLightingOverride.h:35). */\n  EveLightingOverride: \"EveLightingOverride\"\n});\n\n/**\n * Required duck methods per component name: each Carbon interface's\n * pure-virtual surface (methods Carbon gives default implementations - e.g.\n * ITr2Renderable::IsVisible, ITr2LightOwner::AddLight/ClearLights,\n * IEveShadowCaster::PushRtGeometry/MarkRtDirty/IsShadowCastingDirty and the\n * sphere-overload IsCastingShadow - are not required). Consumed fail-closed by\n * EveComponentRegistry.RegisterComponent.\n */\nexport const EveComponentRequiredMethods = Object.freeze({\n  /** ITr2Renderable.h:47-57 pure virtuals. */\n  ReflectionRenderable: Object.freeze([\"GetBatches\", \"HasTransparentBatches\", \"GetSortValue\", \"GetPerObjectData\"]),\n  /** ITr2VolumetricRenderable.h:44-51 pure virtuals. */\n  VolumetricRenderable: Object.freeze([\n    \"GetSortValue\",\n    \"GetVolumetricBatches\",\n    \"UpdateVolumetricLightmap\",\n    \"SetSceneInformation\",\n    \"GetVolumetricShadowBatches\",\n    \"GetVolumetricShadowInfo\",\n    \"PrepareCloudShadowMap\",\n    \"SetCloudShadowMapHandle\"\n  ]),\n  /** ITr2MeshMorph.h:11. */\n  MeshMorph: Object.freeze([\"UpdateMeshMorphs\"]),\n  /** PostProcess/ITr2PostProcessOwner.h:12. */\n  PostProcessOwner: Object.freeze([\"GetPostProcessAttributes\"]),\n  /** Eve/EveInstancedMeshManager.h:270. */\n  InstancedMeshProvider: Object.freeze([\"AddMeshesToManager\"]),\n  /** Lights/ITr2LightOwner.h:13. */\n  LightOwner: Object.freeze([\"GetLights\"]),\n  /** Tr2VolumetricsRenderer.h:55. */\n  FroxelFogSettings: Object.freeze([\"GetFroxelFogSettings\"]),\n  /** Eve/IEveShadowCaster.h:143-149 pure virtuals. */\n  ShadowCaster: Object.freeze([\"IsCastingShadow\", \"GetShadowBatches\", \"GetShadowPerObjectData\"]),\n  /** EveChildLightingOverride.h:31. */\n  EveLightingOverride: Object.freeze([\"GetOverrides\"])\n});\n\n// Carbon's global reflection knob g_eveReflectionMode (scene setting\n// \"eveReflectionSetting\"). CARBON QUIRK: EveSpaceScene.cpp:112 initializes the\n// global with the WRONG enum - EntityComponents::REFLECT_NEVER (== 3), which\n// read as a ReflectionSetting is REFLECTION_SETTING_HIGH - so Carbon's shipped\n// default is effectively HIGH. The port keeps the shipped behavior by\n// defaulting to REFLECTION_SETTING_HIGH directly.\nlet eveReflectionSetting = ReflectionSetting.REFLECTION_SETTING_HIGH;\n\n/**\n * Reads the module-level reflection setting (Carbon g_eveReflectionMode).\n * @returns {Number} a ReflectionSetting value\n */\nexport function GetReflectionSetting()\n{\n  return eveReflectionSetting;\n}\n\n/**\n * Stamps the module-level reflection setting (Carbon TRI_REGISTER_SETTING\n * \"eveReflectionSetting\", EveSpaceScene.cpp:113).\n * @param {Number} setting - a ReflectionSetting value\n */\nexport function SetReflectionSetting(setting)\n{\n  eveReflectionSetting = setting;\n}\n\n/**\n * Carbon EntityComponents::ShouldReflect (EveEntity.cpp:13-33): whether an\n * entity with the given per-entity ReflectionMode registers as\n * \"ReflectionRenderable\" under the current global ReflectionSetting.\n * @param {Number} mode - a ReflectionMode value\n * @returns {Boolean}\n */\nexport function ShouldReflect(mode)\n{\n  if (eveReflectionSetting === ReflectionSetting.REFLECTION_SETTING_OFF)\n  {\n    return false;\n  }\n\n  switch (mode)\n  {\n    case ReflectionMode.REFLECT_NEVER:\n      return false;\n    case ReflectionMode.REFLECT_LOW_MEDIUM_HIGH:\n      return true;\n    case ReflectionMode.REFLECT_MEDIUM_AND_HIGH:\n      // Carbon: \"we have either medium, high or highest settings\".\n      return eveReflectionSetting !== ReflectionSetting.REFLECTION_SETTING_LOW;\n    case ReflectionMode.REFLECT_HIGH:\n      return eveReflectionSetting === ReflectionSetting.REFLECTION_SETTING_HIGH ||\n        eveReflectionSetting === ReflectionSetting.REFLECTION_SETTING_ULTRA;\n    default:\n      return false;\n  }\n}\n"],"names":["EveComponentType","Object","freeze","ReflectionRenderable","VolumetricRenderable","MeshMorph","PostProcessOwner","InstancedMeshProvider","LightOwner","FroxelFogSettings","ShadowCaster","EveLightingOverride","EveComponentRequiredMethods","eveReflectionSetting","ReflectionSetting","REFLECTION_SETTING_HIGH","GetReflectionSetting","SetReflectionSetting","setting","ShouldReflect","mode","REFLECTION_SETTING_OFF","ReflectionMode","REFLECT_NEVER","REFLECT_LOW_MEDIUM_HIGH","REFLECT_MEDIUM_AND_HIGH","REFLECTION_SETTING_LOW","REFLECT_HIGH","REFLECTION_SETTING_ULTRA"],"mappings":"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"}
+{"version":3,"file":"EveComponentTypes.js","sources":["../../../src/eve/EveComponentTypes.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\EveEntity.h\n// Source: E:\\carbonengine\\trinity\\trinity\\Eve\\EveEntity.cpp\n// Shared component-name vocabulary for the EveComponentRegistry. Carbon binds\n// each registry collection to a compile-time interface through\n// REGISTER_COMPONENT_TYPE(name, interface); JavaScript has no template\n// specialization, so the verbatim name strings are the load-bearing contract.\nimport { ReflectionMode, ReflectionSetting } from \"../generated/eve/enums.js\";\n\nexport { ReflectionMode, ReflectionSetting };\n\n/**\n * The nine Carbon component-name strings (VERBATIM). Each entry cites the\n * REGISTER_COMPONENT_TYPE declaration that binds the name to its interface.\n */\nexport const EveComponentType = Object.freeze({\n  /** ITr2Renderable (ITr2Renderable.h:58). */\n  ReflectionRenderable: \"ReflectionRenderable\",\n\n  /** ITr2VolumetricRenderable (ITr2VolumetricRenderable.h:55). */\n  VolumetricRenderable: \"VolumetricRenderable\",\n\n  /** ITr2MeshMorph (ITr2MeshMorph.h:14). */\n  MeshMorph: \"MeshMorph\",\n\n  /** ITr2PostProcessOwner (PostProcess/ITr2PostProcessOwner.h:15). */\n  PostProcessOwner: \"PostProcessOwner\",\n\n  /** IEveInstanceMeshProvider (Eve/EveInstancedMeshManager.h:273). */\n  InstancedMeshProvider: \"InstancedMeshProvider\",\n\n  /** ITr2LightOwner (Lights/ITr2LightOwner.h:18). */\n  LightOwner: \"LightOwner\",\n\n  /** ITr2FroxelFogSettings (Tr2VolumetricsRenderer.h:57). */\n  FroxelFogSettings: \"FroxelFogSettings\",\n\n  /** IEveShadowCaster (Eve/IEveShadowCaster.h:164). */\n  ShadowCaster: \"ShadowCaster\",\n\n  /** IEveLightingOverride (EveChildLightingOverride.h:35). */\n  EveLightingOverride: \"EveLightingOverride\"\n});\n\n/**\n * Required duck methods per component name: each Carbon interface's\n * pure-virtual surface (methods Carbon gives default implementations - e.g.\n * ITr2Renderable::IsVisible, ITr2LightOwner::AddLight/ClearLights,\n * IEveShadowCaster::PushRtGeometry/MarkRtDirty/IsShadowCastingDirty and the\n * sphere-overload IsCastingShadow - are not required). Consumed fail-closed by\n * EveComponentRegistry.RegisterComponent.\n */\nexport const EveComponentRequiredMethods = Object.freeze({\n  /** ITr2Renderable.h:47-57 pure virtuals. */\n  ReflectionRenderable: Object.freeze([\"GetBatches\", \"HasTransparentBatches\", \"GetSortValue\", \"GetPerObjectData\"]),\n\n  /** ITr2VolumetricRenderable.h:44-51 pure virtuals. */\n  VolumetricRenderable: Object.freeze([\n    \"GetSortValue\",\n    \"GetVolumetricBatches\",\n    \"UpdateVolumetricLightmap\",\n    \"SetSceneInformation\",\n    \"GetVolumetricShadowBatches\",\n    \"GetVolumetricShadowInfo\",\n    \"PrepareCloudShadowMap\",\n    \"SetCloudShadowMapHandle\"\n  ]),\n\n  /** ITr2MeshMorph.h:11. */\n  MeshMorph: Object.freeze([\"UpdateMeshMorphs\"]),\n\n  /** PostProcess/ITr2PostProcessOwner.h:12. */\n  PostProcessOwner: Object.freeze([\"GetPostProcessAttributes\"]),\n\n  /** Eve/EveInstancedMeshManager.h:270. */\n  InstancedMeshProvider: Object.freeze([\"AddMeshesToManager\"]),\n\n  /** Lights/ITr2LightOwner.h:13. */\n  LightOwner: Object.freeze([\"GetLights\"]),\n\n  /** Tr2VolumetricsRenderer.h:55. */\n  FroxelFogSettings: Object.freeze([\"GetFroxelFogSettings\"]),\n\n  /** Eve/IEveShadowCaster.h:143-149 pure virtuals. */\n  ShadowCaster: Object.freeze([\"IsCastingShadow\", \"GetShadowBatches\", \"GetShadowPerObjectData\"]),\n\n  /** EveChildLightingOverride.h:31. */\n  EveLightingOverride: Object.freeze([\"GetOverrides\"])\n});\n\n// Carbon's global reflection knob g_eveReflectionMode (scene setting\n// \"eveReflectionSetting\"). CARBON QUIRK: EveSpaceScene.cpp:112 initializes the\n// global with the WRONG enum - EntityComponents::REFLECT_NEVER (== 3), which\n// read as a ReflectionSetting is REFLECTION_SETTING_HIGH - so Carbon's shipped\n// default is effectively HIGH. The port keeps the shipped behavior by\n// defaulting to REFLECTION_SETTING_HIGH directly.\nlet eveReflectionSetting = ReflectionSetting.REFLECTION_SETTING_HIGH;\n\n/**\n * Reads the module-level reflection setting (Carbon g_eveReflectionMode).\n * @returns {Number} a ReflectionSetting value\n */\nexport function GetReflectionSetting()\n{\n  return eveReflectionSetting;\n}\n\n/**\n * Stamps the module-level reflection setting (Carbon TRI_REGISTER_SETTING\n * \"eveReflectionSetting\", EveSpaceScene.cpp:113).\n * @param {Number} setting - a ReflectionSetting value\n */\nexport function SetReflectionSetting(setting)\n{\n  eveReflectionSetting = setting;\n}\n\n/**\n * Carbon EntityComponents::ShouldReflect (EveEntity.cpp:13-33): whether an\n * entity with the given per-entity ReflectionMode registers as\n * \"ReflectionRenderable\" under the current global ReflectionSetting.\n * @param {Number} mode - a ReflectionMode value\n * @returns {Boolean}\n */\nexport function ShouldReflect(mode)\n{\n  if (eveReflectionSetting === ReflectionSetting.REFLECTION_SETTING_OFF)\n  {\n    return false;\n  }\n\n  switch (mode)\n  {\n    case ReflectionMode.REFLECT_NEVER:\n      return false;\n    case ReflectionMode.REFLECT_LOW_MEDIUM_HIGH:\n      return true;\n    case ReflectionMode.REFLECT_MEDIUM_AND_HIGH:\n      // Carbon: \"we have either medium, high or highest settings\".\n      return eveReflectionSetting !== ReflectionSetting.REFLECTION_SETTING_LOW;\n    case ReflectionMode.REFLECT_HIGH:\n      return eveReflectionSetting === ReflectionSetting.REFLECTION_SETTING_HIGH ||\n        eveReflectionSetting === ReflectionSetting.REFLECTION_SETTING_ULTRA;\n    default:\n      return false;\n  }\n}\n"],"names":["EveComponentType","Object","freeze","ReflectionRenderable","VolumetricRenderable","MeshMorph","PostProcessOwner","InstancedMeshProvider","LightOwner","FroxelFogSettings","ShadowCaster","EveLightingOverride","EveComponentRequiredMethods","eveReflectionSetting","ReflectionSetting","REFLECTION_SETTING_HIGH","GetReflectionSetting","SetReflectionSetting","setting","ShouldReflect","mode","REFLECTION_SETTING_OFF","ReflectionMode","REFLECT_NEVER","REFLECT_LOW_MEDIUM_HIGH","REFLECT_MEDIUM_AND_HIGH","REFLECTION_SETTING_LOW","REFLECT_HIGH","REFLECTION_SETTING_ULTRA"],"mappings":"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"}

package/dist/eve/EveCustomMask.js

@@ -7,6 +7,11 @@ import { CjsModel } from '@carbonenginejs/runtime-utils/model';
 import { io, type, carbon, impl } from '@carbonenginejs/runtime-utils/schema';
 
 let _initProto, _initStatic, _initClass, _init_clampU, _init_extra_clampU, _init_clampV, _init_extra_clampV, _init_position, _init_extra_position, _init_scaling, _init_extra_scaling, _init_rotation, _init_extra_rotation, _init_materialIndex, _init_extra_materialIndex, _init_isMirrored, _init_extra_isMirrored, _init_targetMaterials, _init_extra_targetMaterials;
+
+/**
+ * One oriented box projected onto a hull that replaces a source material with a
+ * chosen blend of target materials inside it.
+ */
 let _EveCustomMask;
 new class extends _identity {
   static [class EveCustomMask extends CjsModel {
@@ -32,6 +37,12 @@ new class extends _identity {
     materialIndex = (_init_extra_rotation(this), _init_materialIndex(this, 0));
     isMirrored = (_init_extra_materialIndex(this), _init_isMirrored(this, false));
     targetMaterials = (_init_extra_isMirrored(this), _init_targetMaterials(this, vec4.fromValues(1, 1, 1, 1)));
+
+    /**
+     * Assigns the mask's placement, mirroring, UV clamping, source material index
+     * and target material weights in one call, substituting neutral defaults for
+     * any argument that is missing.
+     */
     Setup(position, scaling, rotation, isMirrored, clampU, clampV, sourceMaterialID, targets) {
       vec3.copy(this.position, position || _EveCustomMask.#zero);
       vec3.copy(this.scaling, scaling || _EveCustomMask.#one);
@@ -43,60 +54,80 @@ new class extends _identity {
       vec4.copy(this.targetMaterials, targets || _EveCustomMask.#one4);
       return true;
     }
+
+    /**
+     * Builds the box to draw when visualising this mask: the mask placement with its extents scaled by the owner's radius and flattened along X.
+     * @param {Array} [out] - caller-owned mat4; a fresh matrix is allocated when omitted
+     * @returns {Array} out
+     */
     GetDebugDrawMatrix(out = mat4.create(), objectRadius = 0) {
       const radius = Number(objectRadius) || 0;
       const scale = vec3.fromValues(0.1 * radius, this.scaling[1] * radius, this.scaling[2] * radius);
       return mat4.fromRotationTranslationScale(out, this.rotation, this.position, scale);
     }
+
+    /**
+     * Writes this mask into one of the two custom-mask slots of the per-object value structs: the transposed inverse placement plus the enable and mirror flags for the vertex stage, and the source material ID, target weights and UV clamps for the pixel stage. These are CPU-side value records; nothing is uploaded here.
+     * @param {Number} index - custom-mask slot, 0 or 1
+     * @returns {Boolean} false for an out-of-range slot, a missing struct, or a placement that cannot be inverted
+     */
     FillPerObjectData(index, vsData, psData) {
       if (!_EveCustomMask.#isValidSlot(index) || !vsData || !psData) {
         return false;
       }
+      // Carbon TransformationMatrix(scaling, rotation, position); gl takes
+      // (rotation, translation, scale) - the same matrix, different argument order.
       const transform = mat4.fromRotationTranslationScale(mat4.create(), this.rotation, this.position, this.scaling);
       const inverse = mat4.invert(mat4.create(), transform);
       if (!inverse) {
         return false;
       }
-      mat4.transpose(_EveCustomMask.#mat4Slot(vsData.customMaskMatrix, index), inverse);
-      vec4.set(_EveCustomMask.#vec4Slot(vsData.customMaskData, index), 1, this.isMirrored ? 1 : 0, 0, 0);
-      vec4.set(_EveCustomMask.#vec4Slot(psData.customMaskMaterialIDs, index), this.materialIndex, 0, 0, 0);
-      vec4.copy(_EveCustomMask.#vec4Slot(psData.customMaskTargets, index), this.targetMaterials);
-      if (!psData.customMaskClamps || psData.customMaskClamps.length !== 4) {
-        psData.customMaskClamps = vec4.create();
-      }
-      psData.customMaskClamps[index * 2] = this.clampU ? 1 : 0;
-      psData.customMaskClamps[index * 2 + 1] = this.clampV ? 1 : 0;
+      // Carbon stores Transpose(invCustomMaskTransform); SetAndTranspose performs
+      // that, so the LOGICAL inverse is what gets passed.
+      vsData.SetAndTransposeIndex("customMaskMatrix", index, inverse);
+      vsData.SetIndex("customMaskData", index, [1, this.isMirrored ? 1 : 0, 0, 0]);
+      psData.SetIndex("customMaskMaterialIDs", index, [this.materialIndex, 0, 0, 0]);
+      psData.SetIndex("customMaskTargets", index, this.targetMaterials);
+
+      // customMaskClamps is ONE vec4 shared by both slots: slot n owns lanes
+      // 2n and 2n+1 (EveCustomMask.cpp:80-81).
+      const clamps = psData.Get("customMaskClamps");
+      clamps[index * 2] = this.clampU ? 1 : 0;
+      clamps[index * 2 + 1] = this.clampV ? 1 : 0;
       return true;
     }
+
+    /**
+     * Clears a custom-mask slot in the per-object value structs so the slot contributes nothing; the UV clamp values are left as they were.
+     * @param {Number} index - custom-mask slot, 0 or 1
+     * @returns {Boolean} false for an out-of-range slot or a missing struct
+     */
     static ZeroPerObjectData(index, vsData, psData) {
       if (!_EveCustomMask.#isValidSlot(index) || !vsData || !psData) {
         return false;
       }
-      mat4.identity(_EveCustomMask.#mat4Slot(vsData.customMaskMatrix, index));
-      vec4.set(_EveCustomMask.#vec4Slot(vsData.customMaskData, index), 0, 0, 0, 0);
-      vec4.set(_EveCustomMask.#vec4Slot(psData.customMaskMaterialIDs, index), 0, 0, 0, 0);
-      vec4.set(_EveCustomMask.#vec4Slot(psData.customMaskTargets, index), 0, 0, 0, 0);
+      // Carbon quirk (EveCustomMask.cpp:88-93): the zeroing path clears the
+      // matrix, data, material IDs and targets but NOT customMaskClamps, so a
+      // slot that stops being filled keeps its last clamp lanes. Reproduced.
+      vsData.SetAndTransposeIndex("customMaskMatrix", index, _EveCustomMask.#identity);
+      vsData.SetIndex("customMaskData", index, _EveCustomMask.#zero4);
+      psData.SetIndex("customMaskMaterialIDs", index, _EveCustomMask.#zero4);
+      psData.SetIndex("customMaskTargets", index, _EveCustomMask.#zero4);
       return true;
     }
+
+    /** Whether an index addresses one of the two custom-mask slots. */
+
+    /** A zeroed vec4, for the slot-clearing writes. */
+
+    /** Identity, for the cleared custom-mask matrix slot. */
   }];
   CUSTOM_MASK_COUNT = 2;
   #isValidSlot(index) {
     return Number.isInteger(index) && index >= 0 && index < _EveCustomMask.CUSTOM_MASK_COUNT;
   }
-  #mat4Slot(slots, index) {
-    if (!Array.isArray(slots)) {
-      throw new TypeError("EveCustomMask requires a fixed customMaskMatrix array");
-    }
-    if (!slots[index] || slots[index].length !== 16) slots[index] = mat4.create();
-    return slots[index];
-  }
-  #vec4Slot(slots, index) {
-    if (!Array.isArray(slots)) {
-      throw new TypeError("EveCustomMask requires a fixed custom-mask vec4 array");
-    }
-    if (!slots[index] || slots[index].length !== 4) slots[index] = vec4.create();
-    return slots[index];
-  }
+  #zero4 = vec4.create();
+  #identity = mat4.create();
   #zero = vec3.create();
   #one = vec3.fromValues(1, 1, 1);
   #identityRotation = quat.create();