@carbonenginejs/runtime-trinity 0.5.0 → 0.7.0

package/dist/trinityCore/TriObserverLocal.js

@@ -1,9 +1,14 @@
 import { identity as _identity, applyDecs2311 as _applyDecs2311 } from '../_virtual/_rollupPluginBabelHelpers.js';
-import { vec3 } from '@carbonenginejs/core-math/vec3';
-import { CjsModel } from '@carbonenginejs/core-types/model';
-import { io, type, carbon, impl } from '@carbonenginejs/core-types/schema';
+import { vec3 } from '@carbonenginejs/runtime-utils/vec3';
+import { CjsModel } from '@carbonenginejs/runtime-utils/model';
+import { io, type, carbon, impl } from '@carbonenginejs/runtime-utils/schema';
 
 let _initProto, _initClass, _init_name, _init_extra_name, _init_position, _init_extra_position, _init_front, _init_extra_front, _init_observer, _init_extra_observer, _init_mute, _init_extra_mute;
+
+/**
+ * Holds an audio or placement observer at a fixed local position and facing
+ * inside an object, and republishes it in world space as the object moves.
+ */
 let _TriObserverLocal;
 new class extends _identity {
   static [class TriObserverLocal extends CjsModel {
@@ -25,6 +30,13 @@ new class extends _identity {
     front = (_init_extra_position(this), _init_front(this, vec3.fromValues(0, 0, 1)));
     observer = (_init_extra_front(this), _init_observer(this, null));
     mute = (_init_extra_observer(this), _init_mute(this, false));
+
+    /**
+     * Transforms the local position and front vector by the given world transform
+     * and pushes the resulting placement to the observer; a degenerate front falls
+     * back to +Z with +Y up. Returns false when no observer supporting
+     * UpdatePlacement is bound.
+     */
     Update(worldTransform) {
       if (!this.observer?.UpdatePlacement) {
         return false;
@@ -41,21 +53,45 @@ new class extends _identity {
       this.observer.UpdatePlacement(front, up, position);
       return true;
     }
+
+    /** The bound placement observer, or null. */
     GetObserver() {
       return this.observer;
     }
+
+    /**
+     * Binds the placement observer that Update drives; the mute state is not
+     * reapplied to the new observer.
+     */
     SetObserver(observer) {
       this.observer = observer ?? null;
     }
+
+    /**
+     * Copies the observer's object-local position; the caller's vector is not
+     * retained.
+     */
     SetPosition(position) {
       vec3.copy(this.position, position);
     }
+
+    /**
+     * Copies the observer's object-local facing direction; the caller's vector is
+     * not retained.
+     */
     SetFront(front) {
       vec3.copy(this.front, front);
     }
+
+    /** Whether the observer is currently muted. */
     GetMute() {
       return this.mute;
     }
+
+    /**
+     * Mutes or unmutes the bound observer, doing nothing and returning false when
+     * the state is already what was asked for.
+     */
     SetMute(mute) {
       const next = !!mute;
       if (next === this.mute) {
@@ -69,9 +105,16 @@ new class extends _identity {
       }
       return true;
     }
+
+    /** Nothing to recompute; the placement is rebuilt on the next Update. */
     OnModified() {
       return true;
     }
+
+    /**
+     * Transforms a direction by the transform's upper 3x3, ignoring translation,
+     * and writes it into out.
+     */
   }];
   #TransformNormal(out, value, transform) {
     const x = value[0];

package/dist/trinityCore/TriObserverLocal.js.map

@@ -1 +1 @@
-{"version":3,"file":"TriObserverLocal.js","sources":["../../../src/trinityCore/TriObserverLocal.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\TriObserverLocal.h\n// Source: E:\\carbonengine\\trinity\\trinity\\TriObserverLocal.cpp\n// Source: E:\\carbonengine\\trinity\\trinity\\TriObserverLocal_Blue.cpp\nimport { vec3 } from \"@carbonenginejs/core-math/vec3\";\nimport { CjsModel } from \"@carbonenginejs/core-types/model\";\nimport { carbon, impl, io, type } from \"@carbonenginejs/core-types/schema\";\n\n\n@type.define({ className: \"TriObserverLocal\", family: \"trinityCore\" })\nexport class TriObserverLocal extends CjsModel\n{\n  @io.persist\n  @type.string\n  name = \"\";\n\n  @io.persist\n  @type.vec3\n  position = vec3.create();\n\n  @io.persist\n  @type.vec3\n  front = vec3.fromValues(0, 0, 1);\n\n  @io.persist\n  @type.objectRef(\"IBluePlacementObserver\")\n  observer = null;\n\n  @type.boolean\n  mute = false;\n\n  @carbon.method\n  @impl.implemented\n  Update(worldTransform)\n  {\n    if (!this.observer?.UpdatePlacement)\n    {\n      return false;\n    }\n\n    const position = vec3.transformMat4(vec3.create(), this.position, worldTransform);\n    const front = TriObserverLocal.#TransformNormal(vec3.create(), this.front, worldTransform);\n    const up = vec3.create();\n\n    if (vec3.squaredLength(front) < 1e-10)\n    {\n      vec3.set(front, 0, 0, 1);\n      vec3.set(up, 0, 1, 0);\n    }\n    else\n    {\n      TriObserverLocal.#TransformNormal(up, TriObserverLocal.#up, worldTransform);\n    }\n\n    this.observer.UpdatePlacement(front, up, position);\n    return true;\n  }\n\n  @carbon.method\n  @impl.implemented\n  GetObserver()\n  {\n    return this.observer;\n  }\n\n  @carbon.method\n  @impl.implemented\n  SetObserver(observer)\n  {\n    this.observer = observer ?? null;\n  }\n\n  @carbon.method\n  @impl.implemented\n  SetPosition(position)\n  {\n    vec3.copy(this.position, position);\n  }\n\n  @carbon.method\n  @impl.implemented\n  SetFront(front)\n  {\n    vec3.copy(this.front, front);\n  }\n\n  @carbon.method\n  @impl.implemented\n  GetMute()\n  {\n    return this.mute;\n  }\n\n  @carbon.method\n  @impl.adapted\n  SetMute(mute)\n  {\n    const next = !!mute;\n    if (next === this.mute)\n    {\n      return false;\n    }\n\n    this.mute = next;\n    if (next)\n    {\n      this.observer?.Mute?.();\n    }\n    else\n    {\n      this.observer?.Unmute?.();\n    }\n    return true;\n  }\n\n  @carbon.method\n  @impl.implemented\n  OnModified()\n  {\n    return true;\n  }\n\n  static #TransformNormal(out, value, transform)\n  {\n    const x = value[0];\n    const y = value[1];\n    const z = value[2];\n    out[0] = transform[0] * x + transform[4] * y + transform[8] * z;\n    out[1] = transform[1] * x + transform[5] * y + transform[9] * z;\n    out[2] = transform[2] * x + transform[6] * y + transform[10] * z;\n    return out;\n  }\n\n  static #up = Object.freeze([0, 1, 0]);\n}\n\n/**\n * Sends an audio event to an observer's emitter when the observed object\n * quacks like an audio emitter (Carbon dynamic_casts to ITr2AudEmitter).\n */\nexport function SendEventToAudEmitter(observer, audioEvent)\n{\n  const emitter = observer?.GetObserver?.();\n  if (typeof emitter?.SendEvent === \"function\")\n  {\n    emitter.SendEvent(audioEvent);\n  }\n}\n"],"names":["_TriObserverLocal","_identity","TriObserverLocal","CjsModel","e","_init_name","_init_extra_name","_init_position","_init_extra_position","_init_front","_init_extra_front","_init_observer","_init_extra_observer","_init_mute","_init_extra_mute","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persist","string","vec3","objectRef","boolean","carbon","method","impl","implemented","adapted","constructor","args","name","position","create","front","fromValues","observer","mute","Update","worldTransform","UpdatePlacement","transformMat4","up","squaredLength","set","GetObserver","SetObserver","SetPosition","copy","SetFront","GetMute","SetMute","next","Mute","Unmute","OnModified","#TransformNormal","out","value","transform","x","y","z","Object","freeze","SendEventToAudEmitter","audioEvent","emitter","SendEvent"],"mappings":"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"}
+{"version":3,"file":"TriObserverLocal.js","sources":["../../../src/trinityCore/TriObserverLocal.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\TriObserverLocal.h\n// Source: E:\\carbonengine\\trinity\\trinity\\TriObserverLocal.cpp\n// Source: E:\\carbonengine\\trinity\\trinity\\TriObserverLocal_Blue.cpp\nimport { vec3 } from \"@carbonenginejs/runtime-utils/vec3\";\nimport { CjsModel } from \"@carbonenginejs/runtime-utils/model\";\nimport { carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\n\n\n/**\n * Holds an audio or placement observer at a fixed local position and facing\n * inside an object, and republishes it in world space as the object moves.\n */\n@type.define({ className: \"TriObserverLocal\", family: \"trinityCore\" })\nexport class TriObserverLocal extends CjsModel\n{\n  @io.persist\n  @type.string\n  name = \"\";\n\n  @io.persist\n  @type.vec3\n  position = vec3.create();\n\n  @io.persist\n  @type.vec3\n  front = vec3.fromValues(0, 0, 1);\n\n  @io.persist\n  @type.objectRef(\"IBluePlacementObserver\")\n  observer = null;\n\n  @type.boolean\n  mute = false;\n\n  /**\n   * Transforms the local position and front vector by the given world transform\n   * and pushes the resulting placement to the observer; a degenerate front falls\n   * back to +Z with +Y up. Returns false when no observer supporting\n   * UpdatePlacement is bound.\n   */\n  @carbon.method\n  @impl.implemented\n  Update(worldTransform)\n  {\n    if (!this.observer?.UpdatePlacement)\n    {\n      return false;\n    }\n\n    const position = vec3.transformMat4(vec3.create(), this.position, worldTransform);\n    const front = TriObserverLocal.#TransformNormal(vec3.create(), this.front, worldTransform);\n    const up = vec3.create();\n\n    if (vec3.squaredLength(front) < 1e-10)\n    {\n      vec3.set(front, 0, 0, 1);\n      vec3.set(up, 0, 1, 0);\n    }\n    else\n    {\n      TriObserverLocal.#TransformNormal(up, TriObserverLocal.#up, worldTransform);\n    }\n\n    this.observer.UpdatePlacement(front, up, position);\n    return true;\n  }\n\n  /** The bound placement observer, or null. */\n  @carbon.method\n  @impl.implemented\n  GetObserver()\n  {\n    return this.observer;\n  }\n\n  /**\n   * Binds the placement observer that Update drives; the mute state is not\n   * reapplied to the new observer.\n   */\n  @carbon.method\n  @impl.implemented\n  SetObserver(observer)\n  {\n    this.observer = observer ?? null;\n  }\n\n  /**\n   * Copies the observer's object-local position; the caller's vector is not\n   * retained.\n   */\n  @carbon.method\n  @impl.implemented\n  SetPosition(position)\n  {\n    vec3.copy(this.position, position);\n  }\n\n  /**\n   * Copies the observer's object-local facing direction; the caller's vector is\n   * not retained.\n   */\n  @carbon.method\n  @impl.implemented\n  SetFront(front)\n  {\n    vec3.copy(this.front, front);\n  }\n\n  /** Whether the observer is currently muted. */\n  @carbon.method\n  @impl.implemented\n  GetMute()\n  {\n    return this.mute;\n  }\n\n  /**\n   * Mutes or unmutes the bound observer, doing nothing and returning false when\n   * the state is already what was asked for.\n   */\n  @carbon.method\n  @impl.adapted\n  SetMute(mute)\n  {\n    const next = !!mute;\n    if (next === this.mute)\n    {\n      return false;\n    }\n\n    this.mute = next;\n    if (next)\n    {\n      this.observer?.Mute?.();\n    }\n    else\n    {\n      this.observer?.Unmute?.();\n    }\n    return true;\n  }\n\n  /** Nothing to recompute; the placement is rebuilt on the next Update. */\n  @carbon.method\n  @impl.implemented\n  OnModified()\n  {\n    return true;\n  }\n\n  /**\n   * Transforms a direction by the transform's upper 3x3, ignoring translation,\n   * and writes it into out.\n   */\n  static #TransformNormal(out, value, transform)\n  {\n    const x = value[0];\n    const y = value[1];\n    const z = value[2];\n    out[0] = transform[0] * x + transform[4] * y + transform[8] * z;\n    out[1] = transform[1] * x + transform[5] * y + transform[9] * z;\n    out[2] = transform[2] * x + transform[6] * y + transform[10] * z;\n    return out;\n  }\n\n  static #up = Object.freeze([0, 1, 0]);\n}\n\n/**\n * Sends an audio event to an observer's emitter when the observed object\n * quacks like an audio emitter (Carbon dynamic_casts to ITr2AudEmitter).\n */\nexport function SendEventToAudEmitter(observer, audioEvent)\n{\n  const emitter = observer?.GetObserver?.();\n  if (typeof emitter?.SendEvent === \"function\")\n  {\n    emitter.SendEvent(audioEvent);\n  }\n}\n"],"names":["_TriObserverLocal","_identity","TriObserverLocal","CjsModel","e","_init_name","_init_extra_name","_init_position","_init_extra_position","_init_front","_init_extra_front","_init_observer","_init_extra_observer","_init_mute","_init_extra_mute","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persist","string","vec3","objectRef","boolean","carbon","method","impl","implemented","adapted","constructor","args","name","position","create","front","fromValues","observer","mute","Update","worldTransform","UpdatePlacement","transformMat4","up","squaredLength","set","GetObserver","SetObserver","SetPosition","copy","SetFront","GetMute","SetMute","next","Mute","Unmute","OnModified","#TransformNormal","out","value","transform","x","y","z","Object","freeze","SendEventToAudEmitter","audioEvent","emitter","SendEvent"],"mappings":"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"}

package/dist/trinityCore/TriProjection.js

@@ -1,44 +1,59 @@
 import { identity as _identity, applyDecs2311 as _applyDecs2311 } from '../_virtual/_rollupPluginBabelHelpers.js';
-import { mat4 } from '@carbonenginejs/core-math/mat4';
-import { CjsModel } from '@carbonenginejs/core-types/model';
-import { type, io, carbon, impl } from '@carbonenginejs/core-types/schema';
+import { mat4 } from '@carbonenginejs/runtime-utils/mat4';
+import { CjsModel } from '@carbonenginejs/runtime-utils/model';
+import { io, type, carbon, impl } from '@carbonenginejs/runtime-utils/schema';
 
-let _initProto, _initClass, _init_projectionType, _init_extra_projectionType, _init_fov, _init_extra_fov, _init_aspect, _init_extra_aspect, _init_left, _init_extra_left, _init_right, _init_extra_right, _init_bottom, _init_extra_bottom, _init_top, _init_extra_top, _init_zn, _init_extra_zn, _init_zf, _init_extra_zf, _init_customTransform, _init_extra_customTransform, _init_transform, _init_extra_transform;
+let _initProto, _initClass, _init_transform, _init_extra_transform;
+
+/**
+ * The camera projection: the selected projection mode with its parameters, plus
+ * the 4x4 matrix built from them.
+ */
 let _TriProjection;
 new class extends _identity {
   static [class TriProjection extends CjsModel {
     static {
       ({
-        e: [_init_projectionType, _init_extra_projectionType, _init_fov, _init_extra_fov, _init_aspect, _init_extra_aspect, _init_left, _init_extra_left, _init_right, _init_extra_right, _init_bottom, _init_extra_bottom, _init_top, _init_extra_top, _init_zn, _init_extra_zn, _init_zf, _init_extra_zf, _init_customTransform, _init_extra_customTransform, _init_transform, _init_extra_transform, _initProto],
+        e: [_init_transform, _init_extra_transform, _initProto],
         c: [_TriProjection, _initClass]
       } = _applyDecs2311(this, [type.define({
         className: "TriProjection",
         family: "trinityCore"
-      })], [[[type, type.int8], 16, "projectionType"], [[type, type.float32], 16, "fov"], [[type, type.float32], 16, "aspect"], [[type, type.float32], 16, "left"], [[type, type.float32], 16, "right"], [[type, type.float32], 16, "bottom"], [[type, type.float32], 16, "top"], [[type, type.float32], 16, "zn"], [[type, type.float32], 16, "zf"], [[type, type.mat4], 16, "customTransform"], [[io, io.read, type, type.mat4], 16, "transform"], [[carbon, carbon.method, impl, impl.implemented], 18, "PerspectiveFov"], [[carbon, carbon.method, impl, impl.implemented], 18, "PerspectiveOffCenter"], [[carbon, carbon.method, impl, impl.implemented], 18, "PerspectiveOrthographic"], [[carbon, carbon.method, impl, impl.adapted], 18, "CustomProjection"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetProjectionType"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetMatrixWithoutViewAdjustment"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetTransform"]], 0, void 0, CjsModel));
+      })], [[[io, io.read, type, type.mat4], 16, "transform"], [[carbon, carbon.method, impl, impl.implemented], 18, "PerspectiveFov"], [[carbon, carbon.method, impl, impl.implemented], 18, "PerspectiveOffCenter"], [[carbon, carbon.method, impl, impl.implemented], 18, "PerspectiveOrthographic"], [[carbon, carbon.method, impl, impl.adapted], 18, "CustomProjection"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetProjectionType"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetMatrixWithoutViewAdjustment"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetTransform"]], 0, void 0, CjsModel));
     }
     constructor(...args) {
       super(...args);
       _init_extra_transform(this);
     }
-    projectionType = (_initProto(this), _init_projectionType(this, 0));
-    fov = (_init_extra_projectionType(this), _init_fov(this, 0));
-    aspect = (_init_extra_fov(this), _init_aspect(this, 0));
-    left = (_init_extra_aspect(this), _init_left(this, 0));
-    right = (_init_extra_left(this), _init_right(this, 0));
-    bottom = (_init_extra_right(this), _init_bottom(this, 0));
-    top = (_init_extra_bottom(this), _init_top(this, 0));
-    zn = (_init_extra_top(this), _init_zn(this, 0));
-    zf = (_init_extra_zn(this), _init_zf(this, 0));
-    customTransform = (_init_extra_zf(this), _init_customTransform(this, mat4.create()));
-    transform = (_init_extra_customTransform(this), _init_transform(this, mat4.create()));
+    projectionType = (_initProto(this), 0);
+    fov = 0;
+    aspect = 0;
+    left = 0;
+    right = 0;
+    bottom = 0;
+    top = 0;
+    zn = 0;
+    zf = 0;
+    customTransform = mat4.create();
+    transform = _init_transform(this, mat4.create());
+
+    /**
+     * Selects the field-of-view perspective mode, storing fov (in radians), aspect
+     * and the near/far planes, and rebuilds the transform.
+     */
     PerspectiveFov(fov, aspect, zn, zf) {
       this.projectionType = _TriProjection.FOV;
       this.fov = fov;
       this.aspect = aspect;
       this.zn = zn;
       this.zf = zf;
-      _TriProjection.#perspectiveFovLH(this.transform, fov, aspect, zn, zf);
+      _TriProjection.#perspectiveFov(this.transform, fov, aspect, zn, zf);
     }
+
+    /**
+     * Selects the off-centre perspective mode from explicit frustum edges measured
+     * at the near plane, and rebuilds the transform.
+     */
     PerspectiveOffCenter(left, right, bottom, top, zn, zf) {
       this.projectionType = _TriProjection.OFF_CENTER;
       this.left = left;
@@ -47,74 +62,113 @@ new class extends _identity {
       this.top = top;
       this.zn = zn;
       this.zf = zf;
-      _TriProjection.#perspectiveOffCenterLH(this.transform, left, right, bottom, top, zn, zf);
+      _TriProjection.#perspectiveOffCenter(this.transform, left, right, bottom, top, zn, zf);
     }
+
+    /**
+     * Selects the orthographic mode; width and height are stored in the left and
+     * top slots and front/back in the near and far slots.
+     */
     PerspectiveOrthographic(width, height, front, back) {
       this.projectionType = _TriProjection.ORTHO;
       this.left = width;
       this.top = height;
       this.zn = front;
       this.zf = back;
-      _TriProjection.#orthoLH(this.transform, width, height, front, back);
+      _TriProjection.#ortho(this.transform, width, height, front, back);
     }
+
+    /**
+     * Adopts a caller-supplied matrix verbatim as the projection, copying it
+     * rather than retaining the caller's buffer.
+     */
     CustomProjection(value) {
       this.projectionType = _TriProjection.CUSTOM;
       mat4.copy(this.customTransform, value);
       mat4.copy(this.transform, value);
     }
+
+    /** The active mode, one of the FOV, OFF_CENTER, ORTHO or CUSTOM constants. */
     GetProjectionType() {
       return this.projectionType;
     }
+
+    /**
+     * Rebuilds the projection matrix from the stored parameters, without any view-dependent adjustment; an unset projection type yields identity.
+     * @param {mat4} [out] Caller-owned destination; a new matrix is allocated when omitted.
+     * @returns {mat4} The destination matrix.
+     */
     GetMatrixWithoutViewAdjustment(out = mat4.create()) {
       switch (this.projectionType) {
         case _TriProjection.FOV:
-          return _TriProjection.#perspectiveFovLH(out, this.fov, this.aspect, this.zn, this.zf);
+          return _TriProjection.#perspectiveFov(out, this.fov, this.aspect, this.zn, this.zf);
         case _TriProjection.OFF_CENTER:
-          return _TriProjection.#perspectiveOffCenterLH(out, this.left, this.right, this.bottom, this.top, this.zn, this.zf);
+          return _TriProjection.#perspectiveOffCenter(out, this.left, this.right, this.bottom, this.top, this.zn, this.zf);
         case _TriProjection.ORTHO:
-          return _TriProjection.#orthoLH(out, this.left, this.top, this.zn, this.zf);
+          return _TriProjection.#ortho(out, this.left, this.top, this.zn, this.zf);
         case _TriProjection.CUSTOM:
           return mat4.copy(out, this.customTransform);
         default:
           return mat4.identity(out);
       }
     }
+
+    /**
+     * Rebuilds the cached transform field from the current parameters, then copies
+     * it into out (a fresh matrix when omitted) and returns it.
+     */
     GetTransform(out = mat4.create()) {
       this.GetMatrixWithoutViewAdjustment(this.transform);
       return mat4.copy(out, this.transform);
     }
+
+    /**
+     * Builds the right-handed field-of-view perspective matrix with a zero-to-one
+     * depth range (w takes -z).
+     */
+
+    /**
+     * Builds the right-handed off-centre perspective matrix from the near-plane
+     * frustum edges; the vertical terms follow Carbon's top-above-bottom
+     * convention and so carry the opposite sign to the usual form.
+     */
+
+    /**
+     * Builds the orthographic matrix from width, height and the near/far planes,
+     * with a zero-to-one depth range.
+     */
   }];
   FOV = 1;
   OFF_CENTER = 2;
   ORTHO = 3;
   CUSTOM = 4;
-  #perspectiveFovLH(out, fov, aspect, zn, zf) {
+  #perspectiveFov(out, fov, aspect, zn, zf) {
     const yScale = 1 / Math.tan(fov * 0.5);
     const xScale = yScale / aspect;
     out.fill(0);
     out[0] = xScale;
     out[5] = yScale;
-    out[10] = zf / (zf - zn);
-    out[11] = 1;
+    out[10] = zf / (zn - zf);
+    out[11] = -1;
     out[14] = zn * zf / (zn - zf);
     return out;
   }
-  #perspectiveOffCenterLH(out, left, right, bottom, top, zn, zf) {
+  #perspectiveOffCenter(out, left, right, bottom, top, zn, zf) {
     out.fill(0);
     out[0] = 2 * zn / (right - left);
-    out[5] = 2 * zn / (top - bottom);
-    out[8] = (left + right) / (left - right);
-    out[9] = (top + bottom) / (bottom - top);
-    out[10] = zf / (zf - zn);
-    out[11] = 1;
+    out[5] = -2 * zn / (bottom - top);
+    out[8] = 1 + 2 * left / (right - left);
+    out[9] = -1 - 2 * top / (bottom - top);
+    out[10] = zf / (zn - zf);
+    out[11] = -1;
     out[14] = zn * zf / (zn - zf);
     return out;
   }
-  #orthoLH(out, width, height, zn, zf) {
+  #ortho(out, width, height, zn, zf) {
     mat4.identity(out);
     out[0] = 2 / width;
     out[5] = 2 / height;
-    out[10] = 1 / (zf - zn);
+    out[10] = 1 / (zn - zf);
     out[14] = zn / (zn - zf);
     return out;
   }

package/dist/trinityCore/TriProjection.js.map

@@ -1 +1 @@
-{"version":3,"file":"TriProjection.js","sources":["../../../src/trinityCore/TriProjection.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\TriProjection.h\n// Source: E:\\carbonengine\\trinity\\trinity\\TriProjection.cpp\n// Source: E:\\carbonengine\\trinity\\trinity\\TriProjection_Blue.cpp\nimport { mat4 } from \"@carbonenginejs/core-math/mat4\";\nimport { CjsModel } from \"@carbonenginejs/core-types/model\";\nimport { carbon, impl, io, type } from \"@carbonenginejs/core-types/schema\";\n\n\n@type.define({\n  className: \"TriProjection\",\n  family: \"trinityCore\"\n})\nexport class TriProjection extends CjsModel\n{\n  static FOV = 1;\n\n  static OFF_CENTER = 2;\n\n  static ORTHO = 3;\n\n  static CUSTOM = 4;\n\n  @type.int8\n  projectionType = 0;\n\n  @type.float32\n  fov = 0;\n\n  @type.float32\n  aspect = 0;\n\n  @type.float32\n  left = 0;\n\n  @type.float32\n  right = 0;\n\n  @type.float32\n  bottom = 0;\n\n  @type.float32\n  top = 0;\n\n  @type.float32\n  zn = 0;\n\n  @type.float32\n  zf = 0;\n\n  @type.mat4\n  customTransform = mat4.create();\n\n  @io.read\n  @type.mat4\n  transform = mat4.create();\n\n  @carbon.method\n  @impl.implemented\n  PerspectiveFov(fov, aspect, zn, zf)\n  {\n    this.projectionType = TriProjection.FOV;\n    this.fov = fov;\n    this.aspect = aspect;\n    this.zn = zn;\n    this.zf = zf;\n    TriProjection.#perspectiveFovLH(this.transform, fov, aspect, zn, zf);\n  }\n\n  @carbon.method\n  @impl.implemented\n  PerspectiveOffCenter(left, right, bottom, top, zn, zf)\n  {\n    this.projectionType = TriProjection.OFF_CENTER;\n    this.left = left;\n    this.right = right;\n    this.bottom = bottom;\n    this.top = top;\n    this.zn = zn;\n    this.zf = zf;\n    TriProjection.#perspectiveOffCenterLH(this.transform, left, right, bottom, top, zn, zf);\n  }\n\n  @carbon.method\n  @impl.implemented\n  PerspectiveOrthographic(width, height, front, back)\n  {\n    this.projectionType = TriProjection.ORTHO;\n    this.left = width;\n    this.top = height;\n    this.zn = front;\n    this.zf = back;\n    TriProjection.#orthoLH(this.transform, width, height, front, back);\n  }\n\n  @carbon.method\n  @impl.adapted\n  CustomProjection(value)\n  {\n    this.projectionType = TriProjection.CUSTOM;\n    mat4.copy(this.customTransform, value);\n    mat4.copy(this.transform, value);\n  }\n\n  @carbon.method\n  @impl.implemented\n  GetProjectionType()\n  {\n    return this.projectionType;\n  }\n\n  @carbon.method\n  @impl.adapted\n  GetMatrixWithoutViewAdjustment(out = mat4.create())\n  {\n    switch (this.projectionType)\n    {\n      case TriProjection.FOV:\n        return TriProjection.#perspectiveFovLH(out, this.fov, this.aspect, this.zn, this.zf);\n      case TriProjection.OFF_CENTER:\n        return TriProjection.#perspectiveOffCenterLH(out, this.left, this.right, this.bottom, this.top, this.zn, this.zf);\n      case TriProjection.ORTHO:\n        return TriProjection.#orthoLH(out, this.left, this.top, this.zn, this.zf);\n      case TriProjection.CUSTOM:\n        return mat4.copy(out, this.customTransform);\n      default:\n        return mat4.identity(out);\n    }\n  }\n\n  @carbon.method\n  @impl.adapted\n  GetTransform(out = mat4.create())\n  {\n    this.GetMatrixWithoutViewAdjustment(this.transform);\n    return mat4.copy(out, this.transform);\n  }\n\n  static #perspectiveFovLH(out, fov, aspect, zn, zf)\n  {\n    const yScale = 1 / Math.tan(fov * 0.5);\n    const xScale = yScale / aspect;\n    out.fill(0);\n    out[0] = xScale;\n    out[5] = yScale;\n    out[10] = zf / (zf - zn);\n    out[11] = 1;\n    out[14] = zn * zf / (zn - zf);\n    return out;\n  }\n\n  static #perspectiveOffCenterLH(out, left, right, bottom, top, zn, zf)\n  {\n    out.fill(0);\n    out[0] = 2 * zn / (right - left);\n    out[5] = 2 * zn / (top - bottom);\n    out[8] = (left + right) / (left - right);\n    out[9] = (top + bottom) / (bottom - top);\n    out[10] = zf / (zf - zn);\n    out[11] = 1;\n    out[14] = zn * zf / (zn - zf);\n    return out;\n  }\n\n  static #orthoLH(out, width, height, zn, zf)\n  {\n    mat4.identity(out);\n    out[0] = 2 / width;\n    out[5] = 2 / height;\n    out[10] = 1 / (zf - zn);\n    out[14] = zn / (zn - zf);\n    return out;\n  }\n}\n"],"names":["_TriProjection","_identity","TriProjection","CjsModel","e","_init_projectionType","_init_extra_projectionType","_init_fov","_init_extra_fov","_init_aspect","_init_extra_aspect","_init_left","_init_extra_left","_init_right","_init_extra_right","_init_bottom","_init_extra_bottom","_init_top","_init_extra_top","_init_zn","_init_extra_zn","_init_zf","_init_extra_zf","_init_customTransform","_init_extra_customTransform","_init_transform","_init_extra_transform","_initProto","c","_initClass","_applyDecs","type","define","className","family","int8","float32","mat4","io","read","carbon","method","impl","implemented","adapted","constructor","args","projectionType","fov","aspect","left","right","bottom","top","zn","zf","customTransform","create","transform","PerspectiveFov","FOV","PerspectiveOffCenter","OFF_CENTER","PerspectiveOrthographic","width","height","front","back","ORTHO","CustomProjection","value","CUSTOM","copy","GetProjectionType","GetMatrixWithoutViewAdjustment","out","identity","GetTransform","#perspectiveFovLH","yScale","Math","tan","xScale","fill","#perspectiveOffCenterLH","#orthoLH"],"mappings":"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"}
+{"version":3,"file":"TriProjection.js","sources":["../../../src/trinityCore/TriProjection.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\TriProjection.h\r\n// Source: E:\\carbonengine\\trinity\\trinity\\TriProjection.cpp\r\n// Source: E:\\carbonengine\\trinity\\trinity\\TriProjection_Blue.cpp\r\nimport { mat4 } from \"@carbonenginejs/runtime-utils/mat4\";\r\nimport { CjsModel } from \"@carbonenginejs/runtime-utils/model\";\r\nimport { carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\r\n\r\n\r\n/**\r\n * The camera projection: the selected projection mode with its parameters, plus\r\n * the 4x4 matrix built from them.\r\n */\r\n@type.define({\r\n  className: \"TriProjection\",\r\n  family: \"trinityCore\"\r\n})\r\nexport class TriProjection extends CjsModel\r\n{\r\n  static FOV = 1;\r\n\r\n  static OFF_CENTER = 2;\r\n\r\n  static ORTHO = 3;\r\n\r\n  static CUSTOM = 4;\r\n\r\n  projectionType = 0;\r\n\r\n  fov = 0;\r\n\r\n  aspect = 0;\r\n\r\n  left = 0;\r\n\r\n  right = 0;\r\n\r\n  bottom = 0;\r\n\r\n  top = 0;\r\n\r\n  zn = 0;\r\n\r\n  zf = 0;\r\n\r\n  customTransform = mat4.create();\r\n\r\n  @io.read\r\n  @type.mat4\r\n  transform = mat4.create();\r\n\r\n  /**\r\n   * Selects the field-of-view perspective mode, storing fov (in radians), aspect\r\n   * and the near/far planes, and rebuilds the transform.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  PerspectiveFov(fov, aspect, zn, zf)\r\n  {\r\n    this.projectionType = TriProjection.FOV;\r\n    this.fov = fov;\r\n    this.aspect = aspect;\r\n    this.zn = zn;\r\n    this.zf = zf;\r\n    TriProjection.#perspectiveFov(this.transform, fov, aspect, zn, zf);\r\n  }\r\n\r\n  /**\r\n   * Selects the off-centre perspective mode from explicit frustum edges measured\r\n   * at the near plane, and rebuilds the transform.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  PerspectiveOffCenter(left, right, bottom, top, zn, zf)\r\n  {\r\n    this.projectionType = TriProjection.OFF_CENTER;\r\n    this.left = left;\r\n    this.right = right;\r\n    this.bottom = bottom;\r\n    this.top = top;\r\n    this.zn = zn;\r\n    this.zf = zf;\r\n    TriProjection.#perspectiveOffCenter(this.transform, left, right, bottom, top, zn, zf);\r\n  }\r\n\r\n  /**\r\n   * Selects the orthographic mode; width and height are stored in the left and\r\n   * top slots and front/back in the near and far slots.\r\n   */\r\n  @carbon.method\r\n  @impl.implemented\r\n  PerspectiveOrthographic(width, height, front, back)\r\n  {\r\n    this.projectionType = TriProjection.ORTHO;\r\n    this.left = width;\r\n    this.top = height;\r\n    this.zn = front;\r\n    this.zf = back;\r\n    TriProjection.#ortho(this.transform, width, height, front, back);\r\n  }\r\n\r\n  /**\r\n   * Adopts a caller-supplied matrix verbatim as the projection, copying it\r\n   * rather than retaining the caller's buffer.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  CustomProjection(value)\r\n  {\r\n    this.projectionType = TriProjection.CUSTOM;\r\n    mat4.copy(this.customTransform, value);\r\n    mat4.copy(this.transform, value);\r\n  }\r\n\r\n  /** The active mode, one of the FOV, OFF_CENTER, ORTHO or CUSTOM constants. */\r\n  @carbon.method\r\n  @impl.implemented\r\n  GetProjectionType()\r\n  {\r\n    return this.projectionType;\r\n  }\r\n\r\n  /**\r\n   * Rebuilds the projection matrix from the stored parameters, without any view-dependent adjustment; an unset projection type yields identity.\r\n   * @param {mat4} [out] Caller-owned destination; a new matrix is allocated when omitted.\r\n   * @returns {mat4} The destination matrix.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  GetMatrixWithoutViewAdjustment(out = mat4.create())\r\n  {\r\n    switch (this.projectionType)\r\n    {\r\n      case TriProjection.FOV:\r\n        return TriProjection.#perspectiveFov(out, this.fov, this.aspect, this.zn, this.zf);\r\n      case TriProjection.OFF_CENTER:\r\n        return TriProjection.#perspectiveOffCenter(out, this.left, this.right, this.bottom, this.top, this.zn, this.zf);\r\n      case TriProjection.ORTHO:\r\n        return TriProjection.#ortho(out, this.left, this.top, this.zn, this.zf);\r\n      case TriProjection.CUSTOM:\r\n        return mat4.copy(out, this.customTransform);\r\n      default:\r\n        return mat4.identity(out);\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Rebuilds the cached transform field from the current parameters, then copies\r\n   * it into out (a fresh matrix when omitted) and returns it.\r\n   */\r\n  @carbon.method\r\n  @impl.adapted\r\n  GetTransform(out = mat4.create())\r\n  {\r\n    this.GetMatrixWithoutViewAdjustment(this.transform);\r\n    return mat4.copy(out, this.transform);\r\n  }\r\n\r\n  /**\r\n   * Builds the right-handed field-of-view perspective matrix with a zero-to-one\r\n   * depth range (w takes -z).\r\n   */\r\n  static #perspectiveFov(out, fov, aspect, zn, zf)\r\n  {\r\n    const yScale = 1 / Math.tan(fov * 0.5);\r\n    const xScale = yScale / aspect;\r\n    out.fill(0);\r\n    out[0] = xScale;\r\n    out[5] = yScale;\r\n    out[10] = zf / (zn - zf);\r\n    out[11] = -1;\r\n    out[14] = zn * zf / (zn - zf);\r\n    return out;\r\n  }\r\n\r\n  /**\r\n   * Builds the right-handed off-centre perspective matrix from the near-plane\r\n   * frustum edges; the vertical terms follow Carbon's top-above-bottom\r\n   * convention and so carry the opposite sign to the usual form.\r\n   */\r\n  static #perspectiveOffCenter(out, left, right, bottom, top, zn, zf)\r\n  {\r\n    out.fill(0);\r\n    out[0] = 2 * zn / (right - left);\r\n    out[5] = -2 * zn / (bottom - top);\r\n    out[8] = 1 + 2 * left / (right - left);\r\n    out[9] = -1 - 2 * top / (bottom - top);\r\n    out[10] = zf / (zn - zf);\r\n    out[11] = -1;\r\n    out[14] = zn * zf / (zn - zf);\r\n    return out;\r\n  }\r\n\r\n  /**\r\n   * Builds the orthographic matrix from width, height and the near/far planes,\r\n   * with a zero-to-one depth range.\r\n   */\r\n  static #ortho(out, width, height, zn, zf)\r\n  {\r\n    mat4.identity(out);\r\n    out[0] = 2 / width;\r\n    out[5] = 2 / height;\r\n    out[10] = 1 / (zn - zf);\r\n    out[14] = zn / (zn - zf);\r\n    return out;\r\n  }\r\n}\r\n"],"names":["_TriProjection","_identity","TriProjection","CjsModel","e","_init_transform","_init_extra_transform","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","read","mat4","carbon","method","impl","implemented","adapted","constructor","args","projectionType","fov","aspect","left","right","bottom","top","zn","zf","customTransform","create","transform","PerspectiveFov","FOV","PerspectiveOffCenter","OFF_CENTER","PerspectiveOrthographic","width","height","front","back","ORTHO","CustomProjection","value","CUSTOM","copy","GetProjectionType","GetMatrixWithoutViewAdjustment","out","identity","GetTransform","#perspectiveFov","yScale","Math","tan","xScale","fill","#perspectiveOffCenter","#ortho"],"mappings":"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"}

package/dist/trinityCore/TriRect.js

@@ -1,8 +1,10 @@
 import { applyDecs2311 as _applyDecs2311 } from '../_virtual/_rollupPluginBabelHelpers.js';
-import { CjsModel } from '@carbonenginejs/core-types/model';
-import { io, type, carbon, impl } from '@carbonenginejs/core-types/schema';
+import { CjsModel } from '@carbonenginejs/runtime-utils/model';
+import { io, type, carbon, impl } from '@carbonenginejs/runtime-utils/schema';
 
 let _initProto, _initClass, _init_left, _init_extra_left, _init_top, _init_extra_top, _init_right, _init_extra_right, _init_bottom, _init_extra_bottom;
+
+/** An integer screen rectangle given by its left, top, right and bottom edges. */
 let _TriRect;
 class TriRect extends CjsModel {
   static {
@@ -22,12 +24,22 @@ class TriRect extends CjsModel {
   top = (_init_extra_left(this), _init_top(this, 0));
   right = (_init_extra_top(this), _init_right(this, 0));
   bottom = (_init_extra_right(this), _init_bottom(this, 0));
+
+  /**
+   * Python-style constructor hook; assigns all four edges, each defaulting to
+   * zero.
+   */
   __init__(left = 0, top = 0, right = 0, bottom = 0) {
     this.left = left;
     this.top = top;
     this.right = right;
     this.bottom = bottom;
   }
+
+  /**
+   * Assigns the supplied edges, leaving any edge passed as undefined at its
+   * current value.
+   */
   SetRect(left, top, right, bottom) {
     if (left !== undefined) {
       this.left = left;

package/dist/trinityCore/TriRect.js.map

@@ -1 +1 @@
-{"version":3,"file":"TriRect.js","sources":["../../../src/trinityCore/TriRect.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\TriRect.h\n// Source: E:\\carbonengine\\trinity\\trinity\\TriRect.cpp\n// Source: E:\\carbonengine\\trinity\\trinity\\TriRect_Blue.cpp\nimport { CjsModel } from \"@carbonenginejs/core-types/model\";\nimport { carbon, impl, io, type } from \"@carbonenginejs/core-types/schema\";\n\n\n@type.define({\n  className: \"TriRect\",\n  family: \"trinityCore\"\n})\nexport class TriRect extends CjsModel\n{\n  @io.persist\n  @type.int32\n  left = 0;\n\n  @io.persist\n  @type.int32\n  top = 0;\n\n  @io.persist\n  @type.int32\n  right = 0;\n\n  @io.persist\n  @type.int32\n  bottom = 0;\n\n  @carbon.method\n  @impl.adapted\n  __init__(left = 0, top = 0, right = 0, bottom = 0)\n  {\n    this.left = left;\n    this.top = top;\n    this.right = right;\n    this.bottom = bottom;\n  }\n\n  @carbon.method\n  @impl.adapted\n  SetRect(left, top, right, bottom)\n  {\n    if (left !== undefined)\n    {\n      this.left = left;\n    }\n    if (top !== undefined)\n    {\n      this.top = top;\n    }\n    if (right !== undefined)\n    {\n      this.right = right;\n    }\n    if (bottom !== undefined)\n    {\n      this.bottom = bottom;\n    }\n  }\n}\n"],"names":["_TriRect","TriRect","CjsModel","e","_init_left","_init_extra_left","_init_top","_init_extra_top","_init_right","_init_extra_right","_init_bottom","_init_extra_bottom","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persist","int32","carbon","method","impl","adapted","constructor","args","left","top","right","bottom","__init__","SetRect","undefined"],"mappings":"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"}
+{"version":3,"file":"TriRect.js","sources":["../../../src/trinityCore/TriRect.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\TriRect.h\n// Source: E:\\carbonengine\\trinity\\trinity\\TriRect.cpp\n// Source: E:\\carbonengine\\trinity\\trinity\\TriRect_Blue.cpp\nimport { CjsModel } from \"@carbonenginejs/runtime-utils/model\";\nimport { carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\n\n\n/** An integer screen rectangle given by its left, top, right and bottom edges. */\n@type.define({\n  className: \"TriRect\",\n  family: \"trinityCore\"\n})\nexport class TriRect extends CjsModel\n{\n  @io.persist\n  @type.int32\n  left = 0;\n\n  @io.persist\n  @type.int32\n  top = 0;\n\n  @io.persist\n  @type.int32\n  right = 0;\n\n  @io.persist\n  @type.int32\n  bottom = 0;\n\n  /**\n   * Python-style constructor hook; assigns all four edges, each defaulting to\n   * zero.\n   */\n  @carbon.method\n  @impl.adapted\n  __init__(left = 0, top = 0, right = 0, bottom = 0)\n  {\n    this.left = left;\n    this.top = top;\n    this.right = right;\n    this.bottom = bottom;\n  }\n\n  /**\n   * Assigns the supplied edges, leaving any edge passed as undefined at its\n   * current value.\n   */\n  @carbon.method\n  @impl.adapted\n  SetRect(left, top, right, bottom)\n  {\n    if (left !== undefined)\n    {\n      this.left = left;\n    }\n    if (top !== undefined)\n    {\n      this.top = top;\n    }\n    if (right !== undefined)\n    {\n      this.right = right;\n    }\n    if (bottom !== undefined)\n    {\n      this.bottom = bottom;\n    }\n  }\n}\n"],"names":["_TriRect","TriRect","CjsModel","e","_init_left","_init_extra_left","_init_top","_init_extra_top","_init_right","_init_extra_right","_init_bottom","_init_extra_bottom","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","persist","int32","carbon","method","impl","adapted","constructor","args","left","top","right","bottom","__init__","SetRect","undefined"],"mappings":"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"}

package/dist/trinityCore/TriRenderBatchAccumulator.js

@@ -1,5 +1,5 @@
-import { RenderingMode } from '@carbonenginejs/runtime-const/graphics';
-import { D3dPrimitiveTopology } from '@carbonenginejs/runtime-const/d3d';
+import { RenderingMode } from '@carbonenginejs/runtime-utils/graphics';
+import { D3dPrimitiveTopology } from '@carbonenginejs/runtime-utils/d3d';
 import { RenderBatchSortType } from '../generated/trinityCore/enums.js';
 import { ITriRenderBatchAccumulator } from './ITriRenderBatchAccumulator.js';
 import { OrderOf, Tr2GdprBatchFullPartition } from './Tr2RenderBatch.js';
@@ -38,13 +38,28 @@ const EffectKeyGenerator = {
     return RenderBatchSortType.RENDERBATCHSORTTYPE_SORT;
   }
 };
+
+/**
+ * Concrete GPU-free batch accumulator: collects committed batches into a
+ * GDPR-eligible and a plain vector, then sorts and group-counts them on
+ * Finalize.
+ */
 class TriRenderBatchAccumulator extends ITriRenderBatchAccumulator {
+  /**
+   * Creates an empty accumulator whose key generator decides sorting and GDPR
+   * eligibility, defaulting to the effect-sorted one.
+   */
   constructor(keyGenerator = EffectKeyGenerator) {
     super();
     this.keyGenerator = keyGenerator;
     this.gdprBatches = [];
     this.batches = [];
   }
+
+  /**
+   * Drops both batch vectors and resets user data and rendering mode to their
+   * defaults.
+   */
   Clear() {
     this.userData = 0;
     this.renderingMode = RenderingMode.RM_ANY;
@@ -58,6 +73,14 @@ class TriRenderBatchAccumulator extends ITriRenderBatchAccumulator {
   // batch's rendering mode is overwritten with the accumulator's mode (faithful
   // to Carbon). Commit takes ownership of the batch; do not reuse it afterwards.
   // Returns whether the batch was accepted (JS addition; Carbon returns void).
+
+  /**
+   * Collects a batch, dropping invalid ones and routing GDPR-eligible batches
+   * (allowed by the key generator, GDR-compatible material, triangle list,
+   * indexed) to the GDPR vector; the batch's rendering mode is overwritten with
+   * the accumulator's and ownership passes here, so the caller must not reuse
+   * the batch. Returns whether it was accepted.
+   */
   Commit(batch) {
     if (!batch.IsValid()) return false;
     if (this.keyGenerator.ALLOW_GDPR && batch.material?.CompatibleWithGdr?.() && batch.topology === D3dPrimitiveTopology.TRIANGLELIST && batch.indexBuffer) {
@@ -71,6 +94,12 @@ class TriRenderBatchAccumulator extends ITriRenderBatchAccumulator {
 
   // Folds another accumulator's batches into this one, then clears the source.
   // Mirrors Carbon TransferFrom (per-thread accumulator merge).
+
+  /**
+   * Folds another accumulator's batches into this one and clears the source; the
+   * source's GDPR batches land in the plain vector when this accumulator does
+   * not allow GDPR.
+   */
   TransferFrom(source) {
     const sourceGdpr = source.GetGdprBatches();
     const sourceBatches = source.GetBatches();
@@ -82,9 +111,13 @@ class TriRenderBatchAccumulator extends ITriRenderBatchAccumulator {
     for (const batch of sourceBatches) this.batches.push(batch);
     source.Clear();
   }
+
+  /** The live GDPR-eligible batch vector, not a copy. */
   GetGdprBatches() {
     return this.gdprBatches;
   }
+
+  /** The live plain batch vector, not a copy. */
   GetBatches() {
     return this.batches;
   }
@@ -92,6 +125,12 @@ class TriRenderBatchAccumulator extends ITriRenderBatchAccumulator {
   // Sorts and group-counts the collected batches. No-op for the order-preserving
   // key generator; effect/GDPR generators sort both vectors and stamp each
   // bin-run's length onto its leading batch's groupCount.
+
+  /**
+   * Sorts and group-counts the collected batches: a no-op for the
+   * order-preserving key generator, a full bin partition of both vectors for
+   * GDPR-enabled ones, and a plain comparator sort otherwise.
+   */
   Finalize() {
     const sortType = this.keyGenerator.GetSortType();
     if (sortType === RenderBatchSortType.RENDERBATCHSORTTYPE_NONE) return;
@@ -107,9 +146,16 @@ class TriRenderBatchAccumulator extends ITriRenderBatchAccumulator {
       return 0;
     });
   }
+
+  /** Total batches across both vectors. */
   GetBatchCount() {
     return this.gdprBatches.length + this.batches.length;
   }
+
+  /**
+   * Whether the batches are effect-sorted, so consecutive batches can share one
+   * state-set, rather than order-preserving.
+   */
   IsChainedByEffect() {
     return this.keyGenerator.GetSortType() !== RenderBatchSortType.RENDERBATCHSORTTYPE_NONE;
   }

package/dist/trinityCore/TriRenderBatchAccumulator.js.map

@@ -1 +1 @@
-{"version":3,"file":"TriRenderBatchAccumulator.js","sources":["../../../src/trinityCore/TriRenderBatchAccumulator.js"],"sourcesContent":["// Ported from CarbonEngine (MIT, (c) 2026 CCP Games) - https://github.com/carbonengine/trinity\n//   trinity/TriRenderBatch.h (TriRenderBatchAccumulator<KeyGenerator>,\n//                             DefaultKeyGenerator, EffectKeyGenerator)\n//\n// GPU-free render-batch accumulator: collects committed batches into two vectors\n// (GDPR-eligible and plain), then sorts / group-counts them on Finalize. The\n// engine adapter reads GetGdprBatches()/GetBatches()/IsChainedByEffect() from a\n// finalized accumulator and issues the actual draws.\nimport { RenderingMode } from \"@carbonenginejs/runtime-const/graphics\";\nimport { D3dPrimitiveTopology } from \"@carbonenginejs/runtime-const/d3d\";\nimport { RenderBatchSortType } from \"../generated/trinityCore/enums.js\";\nimport { ITriRenderBatchAccumulator } from \"./ITriRenderBatchAccumulator.js\";\nimport { CanBeBinned, OrderOf, Tr2GdprBatchFullPartition } from \"./Tr2RenderBatch.js\";\n\n\n// Unsorted, order-preserving, single vector, no GDPR. Used for transparent /\n// order-dependent passes (which are pre-sorted by object distance CPU-side).\nexport const DefaultKeyGenerator = {\n  ALLOW_GDPR: false,\n\n  Less(_batch1, _batch2)\n  {\n    return false;\n  },\n\n  GetSortType()\n  {\n    return RenderBatchSortType.RENDERBATCHSORTTYPE_NONE;\n  }\n};\n\n// Effect-sorted (shader, then vertex declaration); GDPR-enabled. Used for\n// opaque / decal / depth / additive / shadow passes.\nexport const EffectKeyGenerator = {\n  ALLOW_GDPR: true,\n\n  Less(batch1, batch2)\n  {\n    const shaderOrder = OrderOf(batch1.shader) - OrderOf(batch2.shader);\n    if (shaderOrder !== 0) return shaderOrder < 0;\n    return batch1.vertexDeclaration < batch2.vertexDeclaration;\n  },\n\n  GetSortType()\n  {\n    return RenderBatchSortType.RENDERBATCHSORTTYPE_SORT;\n  }\n};\n\nexport class TriRenderBatchAccumulator extends ITriRenderBatchAccumulator\n{\n  constructor(keyGenerator = EffectKeyGenerator)\n  {\n    super();\n    this.keyGenerator = keyGenerator;\n\n    this.gdprBatches = [];\n\n    this.batches = [];\n  }\n\n  Clear()\n  {\n    this.userData = 0;\n    this.renderingMode = RenderingMode.RM_ANY;\n    this.gdprBatches.length = 0;\n    this.batches.length = 0;\n  }\n\n  // Collects a batch. Invalid batches (no shader) are dropped. GDPR-eligible\n  // batches (allowed by the key generator, GDR-compatible material, triangle\n  // topology, indexed) go to the GDPR vector; the rest to the plain vector. The\n  // batch's rendering mode is overwritten with the accumulator's mode (faithful\n  // to Carbon). Commit takes ownership of the batch; do not reuse it afterwards.\n  // Returns whether the batch was accepted (JS addition; Carbon returns void).\n  Commit(batch)\n  {\n    if (!batch.IsValid()) return false;\n\n    if (this.keyGenerator.ALLOW_GDPR\n      && batch.material?.CompatibleWithGdr?.()\n      && batch.topology === D3dPrimitiveTopology.TRIANGLELIST\n      && batch.indexBuffer)\n    {\n      this.gdprBatches.push(batch);\n    }\n    else\n    {\n      this.batches.push(batch);\n    }\n    batch.renderingMode = this.renderingMode;\n    return true;\n  }\n\n  // Folds another accumulator's batches into this one, then clears the source.\n  // Mirrors Carbon TransferFrom (per-thread accumulator merge).\n  TransferFrom(source)\n  {\n    const sourceGdpr = source.GetGdprBatches();\n    const sourceBatches = source.GetBatches();\n\n    if (this.keyGenerator.ALLOW_GDPR)\n    {\n      for (const batch of sourceGdpr) this.gdprBatches.push(batch);\n    }\n    else\n    {\n      for (const batch of sourceGdpr) this.batches.push(batch);\n    }\n    for (const batch of sourceBatches) this.batches.push(batch);\n\n    source.Clear();\n  }\n\n  GetGdprBatches()\n  {\n    return this.gdprBatches;\n  }\n\n  GetBatches()\n  {\n    return this.batches;\n  }\n\n  // Sorts and group-counts the collected batches. No-op for the order-preserving\n  // key generator; effect/GDPR generators sort both vectors and stamp each\n  // bin-run's length onto its leading batch's groupCount.\n  Finalize()\n  {\n    const sortType = this.keyGenerator.GetSortType();\n    if (sortType === RenderBatchSortType.RENDERBATCHSORTTYPE_NONE) return;\n\n    if (this.keyGenerator.ALLOW_GDPR)\n    {\n      Tr2GdprBatchFullPartition(this.gdprBatches);\n      Tr2GdprBatchFullPartition(this.batches);\n      return;\n    }\n\n    const keyGenerator = this.keyGenerator;\n    this.batches.sort((batch1, batch2) =>\n    {\n      if (keyGenerator.Less(batch1, batch2)) return -1;\n      if (keyGenerator.Less(batch2, batch1)) return 1;\n      return 0;\n    });\n  }\n\n  GetBatchCount()\n  {\n    return this.gdprBatches.length + this.batches.length;\n  }\n\n  IsChainedByEffect()\n  {\n    return this.keyGenerator.GetSortType() !== RenderBatchSortType.RENDERBATCHSORTTYPE_NONE;\n  }\n}\n"],"names":["DefaultKeyGenerator","ALLOW_GDPR","Less","_batch1","_batch2","GetSortType","RenderBatchSortType","RENDERBATCHSORTTYPE_NONE","EffectKeyGenerator","batch1","batch2","shaderOrder","OrderOf","shader","vertexDeclaration","RENDERBATCHSORTTYPE_SORT","TriRenderBatchAccumulator","ITriRenderBatchAccumulator","constructor","keyGenerator","gdprBatches","batches","Clear","userData","renderingMode","RenderingMode","RM_ANY","length","Commit","batch","IsValid","material","CompatibleWithGdr","topology","D3dPrimitiveTopology","TRIANGLELIST","indexBuffer","push","TransferFrom","source","sourceGdpr","GetGdprBatches","sourceBatches","GetBatches","Finalize","sortType","Tr2GdprBatchFullPartition","sort","GetBatchCount","IsChainedByEffect"],"mappings":"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"}
+{"version":3,"file":"TriRenderBatchAccumulator.js","sources":["../../../src/trinityCore/TriRenderBatchAccumulator.js"],"sourcesContent":["// Ported from CarbonEngine (MIT, (c) 2026 CCP Games) - https://github.com/carbonengine/trinity\n//   trinity/TriRenderBatch.h (TriRenderBatchAccumulator<KeyGenerator>,\n//                             DefaultKeyGenerator, EffectKeyGenerator)\n//\n// GPU-free render-batch accumulator: collects committed batches into two vectors\n// (GDPR-eligible and plain), then sorts / group-counts them on Finalize. The\n// engine adapter reads GetGdprBatches()/GetBatches()/IsChainedByEffect() from a\n// finalized accumulator and issues the actual draws.\nimport { RenderingMode } from \"@carbonenginejs/runtime-utils/graphics\";\nimport { D3dPrimitiveTopology } from \"@carbonenginejs/runtime-utils/d3d\";\nimport { RenderBatchSortType } from \"../generated/trinityCore/enums.js\";\nimport { ITriRenderBatchAccumulator } from \"./ITriRenderBatchAccumulator.js\";\nimport { CanBeBinned, OrderOf, Tr2GdprBatchFullPartition } from \"./Tr2RenderBatch.js\";\n\n\n// Unsorted, order-preserving, single vector, no GDPR. Used for transparent /\n// order-dependent passes (which are pre-sorted by object distance CPU-side).\nexport const DefaultKeyGenerator = {\n  ALLOW_GDPR: false,\n\n  Less(_batch1, _batch2)\n  {\n    return false;\n  },\n\n  GetSortType()\n  {\n    return RenderBatchSortType.RENDERBATCHSORTTYPE_NONE;\n  }\n};\n\n// Effect-sorted (shader, then vertex declaration); GDPR-enabled. Used for\n// opaque / decal / depth / additive / shadow passes.\nexport const EffectKeyGenerator = {\n  ALLOW_GDPR: true,\n\n  Less(batch1, batch2)\n  {\n    const shaderOrder = OrderOf(batch1.shader) - OrderOf(batch2.shader);\n    if (shaderOrder !== 0) return shaderOrder < 0;\n    return batch1.vertexDeclaration < batch2.vertexDeclaration;\n  },\n\n  GetSortType()\n  {\n    return RenderBatchSortType.RENDERBATCHSORTTYPE_SORT;\n  }\n};\n\n/**\n * Concrete GPU-free batch accumulator: collects committed batches into a\n * GDPR-eligible and a plain vector, then sorts and group-counts them on\n * Finalize.\n */\nexport class TriRenderBatchAccumulator extends ITriRenderBatchAccumulator\n{\n  /**\n   * Creates an empty accumulator whose key generator decides sorting and GDPR\n   * eligibility, defaulting to the effect-sorted one.\n   */\n  constructor(keyGenerator = EffectKeyGenerator)\n  {\n    super();\n    this.keyGenerator = keyGenerator;\n\n    this.gdprBatches = [];\n\n    this.batches = [];\n  }\n\n  /**\n   * Drops both batch vectors and resets user data and rendering mode to their\n   * defaults.\n   */\n  Clear()\n  {\n    this.userData = 0;\n    this.renderingMode = RenderingMode.RM_ANY;\n    this.gdprBatches.length = 0;\n    this.batches.length = 0;\n  }\n\n  // Collects a batch. Invalid batches (no shader) are dropped. GDPR-eligible\n  // batches (allowed by the key generator, GDR-compatible material, triangle\n  // topology, indexed) go to the GDPR vector; the rest to the plain vector. The\n  // batch's rendering mode is overwritten with the accumulator's mode (faithful\n  // to Carbon). Commit takes ownership of the batch; do not reuse it afterwards.\n  // Returns whether the batch was accepted (JS addition; Carbon returns void).\n\n  /**\n   * Collects a batch, dropping invalid ones and routing GDPR-eligible batches\n   * (allowed by the key generator, GDR-compatible material, triangle list,\n   * indexed) to the GDPR vector; the batch's rendering mode is overwritten with\n   * the accumulator's and ownership passes here, so the caller must not reuse\n   * the batch. Returns whether it was accepted.\n   */\n  Commit(batch)\n  {\n    if (!batch.IsValid()) return false;\n\n    if (this.keyGenerator.ALLOW_GDPR\n      && batch.material?.CompatibleWithGdr?.()\n      && batch.topology === D3dPrimitiveTopology.TRIANGLELIST\n      && batch.indexBuffer)\n    {\n      this.gdprBatches.push(batch);\n    }\n    else\n    {\n      this.batches.push(batch);\n    }\n    batch.renderingMode = this.renderingMode;\n    return true;\n  }\n\n  // Folds another accumulator's batches into this one, then clears the source.\n  // Mirrors Carbon TransferFrom (per-thread accumulator merge).\n\n  /**\n   * Folds another accumulator's batches into this one and clears the source; the\n   * source's GDPR batches land in the plain vector when this accumulator does\n   * not allow GDPR.\n   */\n  TransferFrom(source)\n  {\n    const sourceGdpr = source.GetGdprBatches();\n    const sourceBatches = source.GetBatches();\n\n    if (this.keyGenerator.ALLOW_GDPR)\n    {\n      for (const batch of sourceGdpr) this.gdprBatches.push(batch);\n    }\n    else\n    {\n      for (const batch of sourceGdpr) this.batches.push(batch);\n    }\n    for (const batch of sourceBatches) this.batches.push(batch);\n\n    source.Clear();\n  }\n\n  /** The live GDPR-eligible batch vector, not a copy. */\n  GetGdprBatches()\n  {\n    return this.gdprBatches;\n  }\n\n  /** The live plain batch vector, not a copy. */\n  GetBatches()\n  {\n    return this.batches;\n  }\n\n  // Sorts and group-counts the collected batches. No-op for the order-preserving\n  // key generator; effect/GDPR generators sort both vectors and stamp each\n  // bin-run's length onto its leading batch's groupCount.\n\n  /**\n   * Sorts and group-counts the collected batches: a no-op for the\n   * order-preserving key generator, a full bin partition of both vectors for\n   * GDPR-enabled ones, and a plain comparator sort otherwise.\n   */\n  Finalize()\n  {\n    const sortType = this.keyGenerator.GetSortType();\n    if (sortType === RenderBatchSortType.RENDERBATCHSORTTYPE_NONE) return;\n\n    if (this.keyGenerator.ALLOW_GDPR)\n    {\n      Tr2GdprBatchFullPartition(this.gdprBatches);\n      Tr2GdprBatchFullPartition(this.batches);\n      return;\n    }\n\n    const keyGenerator = this.keyGenerator;\n    this.batches.sort((batch1, batch2) =>\n    {\n      if (keyGenerator.Less(batch1, batch2)) return -1;\n      if (keyGenerator.Less(batch2, batch1)) return 1;\n      return 0;\n    });\n  }\n\n  /** Total batches across both vectors. */\n  GetBatchCount()\n  {\n    return this.gdprBatches.length + this.batches.length;\n  }\n\n  /**\n   * Whether the batches are effect-sorted, so consecutive batches can share one\n   * state-set, rather than order-preserving.\n   */\n  IsChainedByEffect()\n  {\n    return this.keyGenerator.GetSortType() !== RenderBatchSortType.RENDERBATCHSORTTYPE_NONE;\n  }\n}\n"],"names":["DefaultKeyGenerator","ALLOW_GDPR","Less","_batch1","_batch2","GetSortType","RenderBatchSortType","RENDERBATCHSORTTYPE_NONE","EffectKeyGenerator","batch1","batch2","shaderOrder","OrderOf","shader","vertexDeclaration","RENDERBATCHSORTTYPE_SORT","TriRenderBatchAccumulator","ITriRenderBatchAccumulator","constructor","keyGenerator","gdprBatches","batches","Clear","userData","renderingMode","RenderingMode","RM_ANY","length","Commit","batch","IsValid","material","CompatibleWithGdr","topology","D3dPrimitiveTopology","TRIANGLELIST","indexBuffer","push","TransferFrom","source","sourceGdpr","GetGdprBatches","sourceBatches","GetBatches","Finalize","sortType","Tr2GdprBatchFullPartition","sort","GetBatchCount","IsChainedByEffect"],"mappings":"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"}