@carbonenginejs/runtime-trinity 0.6.0 → 0.7.0

package/dist/trinityCore/ITriRenderBatchAccumulator.js

@@ -7,12 +7,22 @@ import { RenderingMode } from '@carbonenginejs/runtime-utils/graphics';
 // state plus the collect/sort contract. Concrete accumulators
 // (TriRenderBatchAccumulator) implement Commit/Finalize/Get*/TransferFrom. This
 // stays GPU-free; dispatch to the device is the engine adapter's job.
+
+/**
+ * Abstract base for render-batch accumulators: holds the shared rendering mode,
+ * user data and per-object-data store, and declares the collect and sort
+ * contract concrete accumulators implement.
+ */
 class ITriRenderBatchAccumulator {
+  /**
+   * Starts with zero user data, RM_ANY rendering mode and no per-object-data
+   * store bound.
+   */
   constructor() {
     this.userData = 0;
     this.renderingMode = RenderingMode.RM_ANY;
 
-    // The per-object-data store (a RawDataStore), set once from the render
+    // The per-object-data store (a TriPoolAllocator), set once from the render
     // context at scene setup. The engine builds it from its own struct
     // reflection; Trinity never defines a struct here.
     this.rawDataStore = null;
@@ -20,17 +30,30 @@ class ITriRenderBatchAccumulator {
 
   // Bind the per-object-data store (from the render context). Carbon's pool
   // allocator (Tr2Renderer::GetPoolAllocator) relocates onto this store.
-  SetRawDataStore(store) {
+
+  /**
+   * Binds the per-object-data store, normally taken from the render context at
+   * scene setup; returns this for chaining.
+   */
+  SetTriPoolAllocator(store) {
     this.rawDataStore = store;
     return this;
   }
-  GetRawDataStore() {
+
+  /** The bound per-object-data store, or null when none was set. */
+  GetTriPoolAllocator() {
     return this.rawDataStore;
   }
 
   // Lease a transient per-object payload for a registered struct (the pooled
   // per-object-data allocation). Requires a store - there is no fallback; a
   // missing store is a setup error, not a silent tight-pack.
+
+  /**
+   * Leases a transient per-object payload for a registered struct from the bound
+   * store; a missing store throws rather than silently falling back, because it
+   * is a setup error.
+   */
   Alloc(name) {
     if (!this.rawDataStore) {
       throw new Error(`ITriRenderBatchAccumulator: no per-object-data store bound (set it from the render context before Alloc "${name}")`);
@@ -41,39 +64,78 @@ class ITriRenderBatchAccumulator {
   // Carbon pool-allocates per-object data from the accumulator; in JS the GC
   // owns lifetime, so this just constructs the requested object. Retained for
   // the deferred { object: this } sites during the per-object-data migration.
+
+  /**
+   * Constructs the requested per-object-data object; Carbon pool-allocates here,
+   * but in JS the GC owns lifetime, so this only calls the constructor.
+   */
   Allocate(Constructor) {
     return new Constructor();
   }
+
+  /**
+   * Attaches an opaque caller value that every batch collected by this
+   * accumulator carries.
+   */
   SetUserData(userData) {
     this.userData = userData;
   }
+
+  /** Sets the rendering mode that Commit stamps onto every batch collected here. */
   SetRenderingMode(mode) {
     this.renderingMode = mode;
   }
+
+  /** The rendering mode stamped onto collected batches. */
   GetRenderingMode() {
     return this.renderingMode;
   }
+
+  /**
+   * Abstract: concrete accumulators drop every collected batch and reset the
+   * shared state.
+   */
   Clear() {
     throw new Error("ITriRenderBatchAccumulator.Clear is abstract");
   }
+
+  /**
+   * Abstract: concrete accumulators take ownership of a batch and file it for
+   * sorting.
+   */
   Commit(_batch) {
     throw new Error("ITriRenderBatchAccumulator.Commit is abstract");
   }
+
+  /** Abstract: the GDPR-eligible batch vector. */
   GetGdprBatches() {
     throw new Error("ITriRenderBatchAccumulator.GetGdprBatches is abstract");
   }
+
+  /** Abstract: the plain batch vector. */
   GetBatches() {
     throw new Error("ITriRenderBatchAccumulator.GetBatches is abstract");
   }
+
+  /** Abstract: concrete accumulators sort and group-count the collected batches. */
   Finalize() {
     throw new Error("ITriRenderBatchAccumulator.Finalize is abstract");
   }
+
+  /** Abstract: total number of collected batches. */
   GetBatchCount() {
     throw new Error("ITriRenderBatchAccumulator.GetBatchCount is abstract");
   }
+
+  /**
+   * Abstract: whether the collected batches are effect-sorted rather than
+   * order-preserving.
+   */
   IsChainedByEffect() {
     throw new Error("ITriRenderBatchAccumulator.IsChainedByEffect is abstract");
   }
+
+  /** Abstract: folds another accumulator's batches into this one. */
   TransferFrom(_source) {
     throw new Error("ITriRenderBatchAccumulator.TransferFrom is abstract");
   }

package/dist/trinityCore/ITriRenderBatchAccumulator.js.map

@@ -1 +1 @@
-{"version":3,"file":"ITriRenderBatchAccumulator.js","sources":["../../../src/trinityCore/ITriRenderBatchAccumulator.js"],"sourcesContent":["// Ported from CarbonEngine (MIT, (c) 2026 CCP Games) - https://github.com/carbonengine/trinity\n//   trinity/TriRenderBatch.h (ITriRenderBatchAccumulator)\n//\n// Abstract base for render-batch accumulators: shared render-mode / user-data\n// state plus the collect/sort contract. Concrete accumulators\n// (TriRenderBatchAccumulator) implement Commit/Finalize/Get*/TransferFrom. This\n// stays GPU-free; dispatch to the device is the engine adapter's job.\nimport { RenderingMode } from \"@carbonenginejs/runtime-utils/graphics\";\n\n\nexport class ITriRenderBatchAccumulator\n{\n  constructor()\n  {\n    this.userData = 0;\n\n    this.renderingMode = RenderingMode.RM_ANY;\n\n    // The per-object-data store (a RawDataStore), set once from the render\n    // context at scene setup. The engine builds it from its own struct\n    // reflection; Trinity never defines a struct here.\n    this.rawDataStore = null;\n  }\n\n  // Bind the per-object-data store (from the render context). Carbon's pool\n  // allocator (Tr2Renderer::GetPoolAllocator) relocates onto this store.\n  SetRawDataStore(store)\n  {\n    this.rawDataStore = store;\n    return this;\n  }\n\n  GetRawDataStore()\n  {\n    return this.rawDataStore;\n  }\n\n  // Lease a transient per-object payload for a registered struct (the pooled\n  // per-object-data allocation). Requires a store - there is no fallback; a\n  // missing store is a setup error, not a silent tight-pack.\n  Alloc(name)\n  {\n    if (!this.rawDataStore)\n    {\n      throw new Error(`ITriRenderBatchAccumulator: no per-object-data store bound (set it from the render context before Alloc \"${name}\")`);\n    }\n\n    return this.rawDataStore.Alloc(name);\n  }\n\n  // Carbon pool-allocates per-object data from the accumulator; in JS the GC\n  // owns lifetime, so this just constructs the requested object. Retained for\n  // the deferred { object: this } sites during the per-object-data migration.\n  Allocate(Constructor)\n  {\n    return new Constructor();\n  }\n\n  SetUserData(userData)\n  {\n    this.userData = userData;\n  }\n\n  SetRenderingMode(mode)\n  {\n    this.renderingMode = mode;\n  }\n\n  GetRenderingMode()\n  {\n    return this.renderingMode;\n  }\n\n  Clear()\n  {\n    throw new Error(\"ITriRenderBatchAccumulator.Clear is abstract\");\n  }\n\n  Commit(_batch)\n  {\n    throw new Error(\"ITriRenderBatchAccumulator.Commit is abstract\");\n  }\n\n  GetGdprBatches()\n  {\n    throw new Error(\"ITriRenderBatchAccumulator.GetGdprBatches is abstract\");\n  }\n\n  GetBatches()\n  {\n    throw new Error(\"ITriRenderBatchAccumulator.GetBatches is abstract\");\n  }\n\n  Finalize()\n  {\n    throw new Error(\"ITriRenderBatchAccumulator.Finalize is abstract\");\n  }\n\n  GetBatchCount()\n  {\n    throw new Error(\"ITriRenderBatchAccumulator.GetBatchCount is abstract\");\n  }\n\n  IsChainedByEffect()\n  {\n    throw new Error(\"ITriRenderBatchAccumulator.IsChainedByEffect is abstract\");\n  }\n\n  TransferFrom(_source)\n  {\n    throw new Error(\"ITriRenderBatchAccumulator.TransferFrom is abstract\");\n  }\n}\n"],"names":["ITriRenderBatchAccumulator","constructor","userData","renderingMode","RenderingMode","RM_ANY","rawDataStore","SetRawDataStore","store","GetRawDataStore","Alloc","name","Error","Allocate","Constructor","SetUserData","SetRenderingMode","mode","GetRenderingMode","Clear","Commit","_batch","GetGdprBatches","GetBatches","Finalize","GetBatchCount","IsChainedByEffect","TransferFrom","_source"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AAIO,MAAMA,0BAA0B,CACvC;AACEC,EAAAA,WAAWA,GACX;IACE,IAAI,CAACC,QAAQ,GAAG,CAAC;AAEjB,IAAA,IAAI,CAACC,aAAa,GAAGC,aAAa,CAACC,MAAM;;AAEzC;AACA;AACA;IACA,IAAI,CAACC,YAAY,GAAG,IAAI;AAC1B,EAAA;;AAEA;AACA;EACAC,eAAeA,CAACC,KAAK,EACrB;IACE,IAAI,CAACF,YAAY,GAAGE,KAAK;AACzB,IAAA,OAAO,IAAI;AACb,EAAA;AAEAC,EAAAA,eAAeA,GACf;IACE,OAAO,IAAI,CAACH,YAAY;AAC1B,EAAA;;AAEA;AACA;AACA;EACAI,KAAKA,CAACC,IAAI,EACV;AACE,IAAA,IAAI,CAAC,IAAI,CAACL,YAAY,EACtB;AACE,MAAA,MAAM,IAAIM,KAAK,CAAC,CAAA,yGAAA,EAA4GD,IAAI,IAAI,CAAC;AACvI,IAAA;AAEA,IAAA,OAAO,IAAI,CAACL,YAAY,CAACI,KAAK,CAACC,IAAI,CAAC;AACtC,EAAA;;AAEA;AACA;AACA;EACAE,QAAQA,CAACC,WAAW,EACpB;IACE,OAAO,IAAIA,WAAW,EAAE;AAC1B,EAAA;EAEAC,WAAWA,CAACb,QAAQ,EACpB;IACE,IAAI,CAACA,QAAQ,GAAGA,QAAQ;AAC1B,EAAA;EAEAc,gBAAgBA,CAACC,IAAI,EACrB;IACE,IAAI,CAACd,aAAa,GAAGc,IAAI;AAC3B,EAAA;AAEAC,EAAAA,gBAAgBA,GAChB;IACE,OAAO,IAAI,CAACf,aAAa;AAC3B,EAAA;AAEAgB,EAAAA,KAAKA,GACL;AACE,IAAA,MAAM,IAAIP,KAAK,CAAC,8CAA8C,CAAC;AACjE,EAAA;EAEAQ,MAAMA,CAACC,MAAM,EACb;AACE,IAAA,MAAM,IAAIT,KAAK,CAAC,+CAA+C,CAAC;AAClE,EAAA;AAEAU,EAAAA,cAAcA,GACd;AACE,IAAA,MAAM,IAAIV,KAAK,CAAC,uDAAuD,CAAC;AAC1E,EAAA;AAEAW,EAAAA,UAAUA,GACV;AACE,IAAA,MAAM,IAAIX,KAAK,CAAC,mDAAmD,CAAC;AACtE,EAAA;AAEAY,EAAAA,QAAQA,GACR;AACE,IAAA,MAAM,IAAIZ,KAAK,CAAC,iDAAiD,CAAC;AACpE,EAAA;AAEAa,EAAAA,aAAaA,GACb;AACE,IAAA,MAAM,IAAIb,KAAK,CAAC,sDAAsD,CAAC;AACzE,EAAA;AAEAc,EAAAA,iBAAiBA,GACjB;AACE,IAAA,MAAM,IAAId,KAAK,CAAC,0DAA0D,CAAC;AAC7E,EAAA;EAEAe,YAAYA,CAACC,OAAO,EACpB;AACE,IAAA,MAAM,IAAIhB,KAAK,CAAC,qDAAqD,CAAC;AACxE,EAAA;AACF;;;;"}
+{"version":3,"file":"ITriRenderBatchAccumulator.js","sources":["../../../src/trinityCore/ITriRenderBatchAccumulator.js"],"sourcesContent":["// Ported from CarbonEngine (MIT, (c) 2026 CCP Games) - https://github.com/carbonengine/trinity\n//   trinity/TriRenderBatch.h (ITriRenderBatchAccumulator)\n//\n// Abstract base for render-batch accumulators: shared render-mode / user-data\n// state plus the collect/sort contract. Concrete accumulators\n// (TriRenderBatchAccumulator) implement Commit/Finalize/Get*/TransferFrom. This\n// stays GPU-free; dispatch to the device is the engine adapter's job.\nimport { RenderingMode } from \"@carbonenginejs/runtime-utils/graphics\";\n\n\n/**\n * Abstract base for render-batch accumulators: holds the shared rendering mode,\n * user data and per-object-data store, and declares the collect and sort\n * contract concrete accumulators implement.\n */\nexport class ITriRenderBatchAccumulator\n{\n  /**\n   * Starts with zero user data, RM_ANY rendering mode and no per-object-data\n   * store bound.\n   */\n  constructor()\n  {\n    this.userData = 0;\n\n    this.renderingMode = RenderingMode.RM_ANY;\n\n    // The per-object-data store (a TriPoolAllocator), set once from the render\n    // context at scene setup. The engine builds it from its own struct\n    // reflection; Trinity never defines a struct here.\n    this.rawDataStore = null;\n  }\n\n  // Bind the per-object-data store (from the render context). Carbon's pool\n  // allocator (Tr2Renderer::GetPoolAllocator) relocates onto this store.\n\n  /**\n   * Binds the per-object-data store, normally taken from the render context at\n   * scene setup; returns this for chaining.\n   */\n  SetTriPoolAllocator(store)\n  {\n    this.rawDataStore = store;\n    return this;\n  }\n\n  /** The bound per-object-data store, or null when none was set. */\n  GetTriPoolAllocator()\n  {\n    return this.rawDataStore;\n  }\n\n  // Lease a transient per-object payload for a registered struct (the pooled\n  // per-object-data allocation). Requires a store - there is no fallback; a\n  // missing store is a setup error, not a silent tight-pack.\n\n  /**\n   * Leases a transient per-object payload for a registered struct from the bound\n   * store; a missing store throws rather than silently falling back, because it\n   * is a setup error.\n   */\n  Alloc(name)\n  {\n    if (!this.rawDataStore)\n    {\n      throw new Error(`ITriRenderBatchAccumulator: no per-object-data store bound (set it from the render context before Alloc \"${name}\")`);\n    }\n\n    return this.rawDataStore.Alloc(name);\n  }\n\n  // Carbon pool-allocates per-object data from the accumulator; in JS the GC\n  // owns lifetime, so this just constructs the requested object. Retained for\n  // the deferred { object: this } sites during the per-object-data migration.\n\n  /**\n   * Constructs the requested per-object-data object; Carbon pool-allocates here,\n   * but in JS the GC owns lifetime, so this only calls the constructor.\n   */\n  Allocate(Constructor)\n  {\n    return new Constructor();\n  }\n\n  /**\n   * Attaches an opaque caller value that every batch collected by this\n   * accumulator carries.\n   */\n  SetUserData(userData)\n  {\n    this.userData = userData;\n  }\n\n  /** Sets the rendering mode that Commit stamps onto every batch collected here. */\n  SetRenderingMode(mode)\n  {\n    this.renderingMode = mode;\n  }\n\n  /** The rendering mode stamped onto collected batches. */\n  GetRenderingMode()\n  {\n    return this.renderingMode;\n  }\n\n  /**\n   * Abstract: concrete accumulators drop every collected batch and reset the\n   * shared state.\n   */\n  Clear()\n  {\n    throw new Error(\"ITriRenderBatchAccumulator.Clear is abstract\");\n  }\n\n  /**\n   * Abstract: concrete accumulators take ownership of a batch and file it for\n   * sorting.\n   */\n  Commit(_batch)\n  {\n    throw new Error(\"ITriRenderBatchAccumulator.Commit is abstract\");\n  }\n\n  /** Abstract: the GDPR-eligible batch vector. */\n  GetGdprBatches()\n  {\n    throw new Error(\"ITriRenderBatchAccumulator.GetGdprBatches is abstract\");\n  }\n\n  /** Abstract: the plain batch vector. */\n  GetBatches()\n  {\n    throw new Error(\"ITriRenderBatchAccumulator.GetBatches is abstract\");\n  }\n\n  /** Abstract: concrete accumulators sort and group-count the collected batches. */\n  Finalize()\n  {\n    throw new Error(\"ITriRenderBatchAccumulator.Finalize is abstract\");\n  }\n\n  /** Abstract: total number of collected batches. */\n  GetBatchCount()\n  {\n    throw new Error(\"ITriRenderBatchAccumulator.GetBatchCount is abstract\");\n  }\n\n  /**\n   * Abstract: whether the collected batches are effect-sorted rather than\n   * order-preserving.\n   */\n  IsChainedByEffect()\n  {\n    throw new Error(\"ITriRenderBatchAccumulator.IsChainedByEffect is abstract\");\n  }\n\n  /** Abstract: folds another accumulator's batches into this one. */\n  TransferFrom(_source)\n  {\n    throw new Error(\"ITriRenderBatchAccumulator.TransferFrom is abstract\");\n  }\n}\n"],"names":["ITriRenderBatchAccumulator","constructor","userData","renderingMode","RenderingMode","RM_ANY","rawDataStore","SetTriPoolAllocator","store","GetTriPoolAllocator","Alloc","name","Error","Allocate","Constructor","SetUserData","SetRenderingMode","mode","GetRenderingMode","Clear","Commit","_batch","GetGdprBatches","GetBatches","Finalize","GetBatchCount","IsChainedByEffect","TransferFrom","_source"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;;AAIA;AACA;AACA;AACA;AACA;AACO,MAAMA,0BAA0B,CACvC;AACE;AACF;AACA;AACA;AACEC,EAAAA,WAAWA,GACX;IACE,IAAI,CAACC,QAAQ,GAAG,CAAC;AAEjB,IAAA,IAAI,CAACC,aAAa,GAAGC,aAAa,CAACC,MAAM;;AAEzC;AACA;AACA;IACA,IAAI,CAACC,YAAY,GAAG,IAAI;AAC1B,EAAA;;AAEA;AACA;;AAEA;AACF;AACA;AACA;EACEC,mBAAmBA,CAACC,KAAK,EACzB;IACE,IAAI,CAACF,YAAY,GAAGE,KAAK;AACzB,IAAA,OAAO,IAAI;AACb,EAAA;;AAEA;AACAC,EAAAA,mBAAmBA,GACnB;IACE,OAAO,IAAI,CAACH,YAAY;AAC1B,EAAA;;AAEA;AACA;AACA;;AAEA;AACF;AACA;AACA;AACA;EACEI,KAAKA,CAACC,IAAI,EACV;AACE,IAAA,IAAI,CAAC,IAAI,CAACL,YAAY,EACtB;AACE,MAAA,MAAM,IAAIM,KAAK,CAAC,CAAA,yGAAA,EAA4GD,IAAI,IAAI,CAAC;AACvI,IAAA;AAEA,IAAA,OAAO,IAAI,CAACL,YAAY,CAACI,KAAK,CAACC,IAAI,CAAC;AACtC,EAAA;;AAEA;AACA;AACA;;AAEA;AACF;AACA;AACA;EACEE,QAAQA,CAACC,WAAW,EACpB;IACE,OAAO,IAAIA,WAAW,EAAE;AAC1B,EAAA;;AAEA;AACF;AACA;AACA;EACEC,WAAWA,CAACb,QAAQ,EACpB;IACE,IAAI,CAACA,QAAQ,GAAGA,QAAQ;AAC1B,EAAA;;AAEA;EACAc,gBAAgBA,CAACC,IAAI,EACrB;IACE,IAAI,CAACd,aAAa,GAAGc,IAAI;AAC3B,EAAA;;AAEA;AACAC,EAAAA,gBAAgBA,GAChB;IACE,OAAO,IAAI,CAACf,aAAa;AAC3B,EAAA;;AAEA;AACF;AACA;AACA;AACEgB,EAAAA,KAAKA,GACL;AACE,IAAA,MAAM,IAAIP,KAAK,CAAC,8CAA8C,CAAC;AACjE,EAAA;;AAEA;AACF;AACA;AACA;EACEQ,MAAMA,CAACC,MAAM,EACb;AACE,IAAA,MAAM,IAAIT,KAAK,CAAC,+CAA+C,CAAC;AAClE,EAAA;;AAEA;AACAU,EAAAA,cAAcA,GACd;AACE,IAAA,MAAM,IAAIV,KAAK,CAAC,uDAAuD,CAAC;AAC1E,EAAA;;AAEA;AACAW,EAAAA,UAAUA,GACV;AACE,IAAA,MAAM,IAAIX,KAAK,CAAC,mDAAmD,CAAC;AACtE,EAAA;;AAEA;AACAY,EAAAA,QAAQA,GACR;AACE,IAAA,MAAM,IAAIZ,KAAK,CAAC,iDAAiD,CAAC;AACpE,EAAA;;AAEA;AACAa,EAAAA,aAAaA,GACb;AACE,IAAA,MAAM,IAAIb,KAAK,CAAC,sDAAsD,CAAC;AACzE,EAAA;;AAEA;AACF;AACA;AACA;AACEc,EAAAA,iBAAiBA,GACjB;AACE,IAAA,MAAM,IAAId,KAAK,CAAC,0DAA0D,CAAC;AAC7E,EAAA;;AAEA;EACAe,YAAYA,CAACC,OAAO,EACpB;AACE,IAAA,MAAM,IAAIhB,KAAK,CAAC,qDAAqD,CAAC;AACxE,EAAA;AACF;;;;"}

package/dist/trinityCore/Tr2DirectInstanceData.js

@@ -4,6 +4,11 @@ import { CjsModel } from '@carbonenginejs/runtime-utils/model';
 import { io, type, carbon, impl } from '@carbonenginejs/runtime-utils/schema';
 
 let _initProto, _initClass, _init_aabbMax, _init_extra_aabbMax, _init_aabbMin, _init_extra_aabbMin, _init_count, _init_extra_count;
+
+/**
+ * Instance data whose buffer lives entirely on the GPU: Trinity keeps only the
+ * CPU-side layout metadata, stride, instance count and bounds.
+ */
 let _Tr2DirectInstanceDat;
 class Tr2DirectInstanceData extends CjsModel {
   static {
@@ -42,9 +47,16 @@ class Tr2DirectInstanceData extends CjsModel {
     vec3.copy(this.aabbMin, min);
     vec3.copy(this.aabbMax, max);
   }
+
+  /** Number of instances in the GPU-side buffer. */
   GetCount() {
     return this.count;
   }
+
+  /**
+   * Byte stride of one instance, computed by SetLayout as the largest offset
+   * plus element size in the layout.
+   */
   GetStride() {
     return this.#stride;
   }
@@ -67,9 +79,16 @@ class Tr2DirectInstanceData extends CjsModel {
     this.#layout = Object.freeze(layout.slice());
     this.#stride = stride;
   }
+
+  /** The frozen element-descriptor list recorded by SetLayout. */
   GetLayout() {
     return this.#layout;
   }
+
+  /**
+   * A detached copy of the recorded bounds; the buffer index is ignored because
+   * only one stream is modelled.
+   */
   GetInstanceBufferBoundingBox(_bufferIndex = 0) {
     return {
       min: vec3.clone(this.aabbMin),

package/dist/trinityCore/Tr2DirectInstanceData.js.map

@@ -1 +1 @@
-{"version":3,"file":"Tr2DirectInstanceData.js","sources":["../../../src/trinityCore/Tr2DirectInstanceData.js"],"sourcesContent":["// Ported from CarbonEngine (MIT, (c) 2026 CCP Games) - https://github.com/carbonengine/trinity\n//   trinity/trinity/Tr2DirectInstanceData.h\n//   trinity/trinity/Tr2DirectInstanceData.cpp\n//   trinity/trinity/Tr2DirectInstanceData_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@type.define({ className: \"Tr2DirectInstanceData\", family: \"trinityCore\" })\nexport class Tr2DirectInstanceData extends CjsModel\n{\n\n  /** m_aabb.m_max (Vector3) [READ] */\n  @io.read\n  @type.vec3\n  aabbMax = vec3.create();\n\n  /** m_aabb.m_min (Vector3) [READ] */\n  @io.read\n  @type.vec3\n  aabbMin = vec3.create();\n\n  /** GetCount (MAP_PROPERTY_READONLY \"count\") - number of instances. */\n  @io.read\n  @type.uint32\n  count = 0;\n\n  /** m_layout (Tr2VertexDefinition) - CPU metadata for the direct GPU stream. */\n  #layout = Object.freeze([]);\n\n  #stride = 0;\n\n  /**\n   * Assigns the CPU-side instance bounds without realizing a GPU buffer.\n   * Accepts the JavaScript `{ min, max }` box representation; a two-vector\n   * form is retained for consistency with `Tr2RuntimeInstanceData`.\n   */\n  @carbon.method\n  @impl.adapted\n  SetBoundingBox(bounds, maxBounds)\n  {\n    const min = maxBounds === undefined ? bounds?.min ?? bounds?.minBounds : bounds;\n    const max = maxBounds === undefined ? bounds?.max ?? bounds?.maxBounds : maxBounds;\n    if (!min || !max)\n    {\n      throw new TypeError(\"Bounding box requires min and max vectors\");\n    }\n    vec3.copy(this.aabbMin, min);\n    vec3.copy(this.aabbMax, max);\n  }\n\n  @carbon.method\n  @impl.implemented\n  GetCount()\n  {\n    return this.count;\n  }\n\n  @carbon.method\n  @impl.implemented\n  GetStride()\n  {\n    return this.#stride;\n  }\n\n  /**\n   * Records the CPU vertex-layout metadata. Carbon computes the stride as\n   * max(offset + elementSize); the direct GPU buffer itself is realized by\n   * the engine (GetData/UpdateData/DestroyData are engine-owned).\n   */\n  @carbon.method\n  @impl.adapted\n  SetLayout(layout)\n  {\n    if (!Array.isArray(layout))\n    {\n      throw new TypeError(\"Layout must be an array of element descriptors\");\n    }\n    let stride = 0;\n    for (const element of layout)\n    {\n      const offset = Number(element?.offset) || 0;\n      const byteSize = Number(element?.byteSize) || 0;\n      stride = Math.max(stride, offset + byteSize);\n    }\n    this.#layout = Object.freeze(layout.slice());\n    this.#stride = stride;\n  }\n\n  @carbon.method\n  @impl.implemented\n  GetLayout()\n  {\n    return this.#layout;\n  }\n\n  @carbon.method\n  @impl.implemented\n  GetInstanceBufferBoundingBox(_bufferIndex = 0)\n  {\n    return {\n      min: vec3.clone(this.aabbMin),\n      max: vec3.clone(this.aabbMax)\n    };\n  }\n\n}\n"],"names":["_Tr2DirectInstanceDat","Tr2DirectInstanceData","CjsModel","e","_init_aabbMax","_init_extra_aabbMax","_init_aabbMin","_init_extra_aabbMin","_init_count","_init_extra_count","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","read","vec3","uint32","carbon","method","impl","adapted","implemented","aabbMax","create","aabbMin","count","Object","freeze","SetBoundingBox","bounds","maxBounds","min","undefined","minBounds","max","TypeError","copy","GetCount","GetStride","SetLayout","layout","Array","isArray","stride","element","offset","Number","byteSize","Math","slice","GetLayout","GetInstanceBufferBoundingBox","_bufferIndex","clone"],"mappings":";;;;;;AAM8E,IAAAA;AAG9E,MAAAC,qBAAA,SAC2CC,QAAQ,CACnD;AAAA,EAAA;AAAA,IAAA,CAAA;AAAAC,MAAAA,CAAA,EAAA,CAAAC,aAAA,EAAAC,mBAAA,EAAAC,aAAA,EAAAC,mBAAA,EAAAC,WAAA,EAAAC,iBAAA,EAAAC,UAAA,CAAA;MAAAC,CAAA,EAAA,CAAAX,qBAAA,EAAAY,UAAA;AAAA,KAAA,GAAAC,cAAA,CAAA,IAAA,EAAA,CAFCC,IAAI,CAACC,MAAM,CAAC;AAAEC,MAAAA,SAAS,EAAE,uBAAuB;AAAEC,MAAAA,MAAM,EAAE;KAAe,CAAC,CAAA,EAAA,CAAA,CAAA,CAKxEC,EAAE,EAAFA,EAAE,CAACC,IAAI,EACPL,IAAI,EAAJA,IAAI,CAACM,IAAI,CAAA,EAAA,EAAA,EAAA,SAAA,CAAA,EAAA,CAAA,CAITF,EAAE,EAAFA,EAAE,CAACC,IAAI,EACPL,IAAI,EAAJA,IAAI,CAACM,IAAI,CAAA,EAAA,EAAA,EAAA,SAAA,CAAA,EAAA,CAAA,CAITF,EAAE,EAAFA,EAAE,CAACC,IAAI,EACPL,IAAI,EAAJA,IAAI,CAACO,MAAM,CAAA,EAAA,EAAA,EAAA,OAAA,CAAA,EAAA,CAAA,CAaXC,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,OAAO,CAAA,EAAA,EAAA,EAAA,gBAAA,CAAA,EAAA,CAAA,CAaZH,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACE,WAAW,CAAA,EAAA,EAAA,EAAA,UAAA,CAAA,EAAA,CAAA,CAMhBJ,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACE,WAAW,CAAA,EAAA,EAAA,EAAA,WAAA,CAAA,EAAA,CAAA,CAWhBJ,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,OAAO,CAAA,EAAA,EAAA,EAAA,WAAA,CAAA,EAAA,CAAA,CAkBZH,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACE,WAAW,uBAMhBJ,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACE,WAAW,CAAA,EAAA,EAAA,EAAA,8BAAA,CAAA,CAAA,EAAA,CAAA,EAAA,MAAA,EAxFwBxB,QAAQ,CAAA;AAAA;AAGjD;EAGAyB,OAAO,IAAAjB,UAAA,CAAA,IAAA,CAAA,EAAAN,aAAA,OAAGgB,IAAI,CAACQ,MAAM,EAAE,CAAA;;AAEvB;EAGAC,OAAO,IAAAxB,mBAAA,CAAA,IAAA,CAAA,EAAAC,aAAA,OAAGc,IAAI,CAACQ,MAAM,EAAE,CAAA;;AAEvB;AAGAE,EAAAA,KAAK,IAAAvB,mBAAA,CAAA,IAAA,CAAA,EAAAC,WAAA,OAAG,CAAC,CAAA;;AAET;EACA,OAAO,IAAAC,iBAAA,CAAA,IAAA,CAAA,EAAGsB,MAAM,CAACC,MAAM,CAAC,EAAE,CAAC;EAE3B,OAAO,GAAG,CAAC;;AAEX;AACF;AACA;AACA;AACA;AAGEC,EAAAA,cAAcA,CAACC,MAAM,EAAEC,SAAS,EAChC;AACE,IAAA,MAAMC,GAAG,GAAGD,SAAS,KAAKE,SAAS,GAAGH,MAAM,EAAEE,GAAG,IAAIF,MAAM,EAAEI,SAAS,GAAGJ,MAAM;AAC/E,IAAA,MAAMK,GAAG,GAAGJ,SAAS,KAAKE,SAAS,GAAGH,MAAM,EAAEK,GAAG,IAAIL,MAAM,EAAEC,SAAS,GAAGA,SAAS;AAClF,IAAA,IAAI,CAACC,GAAG,IAAI,CAACG,GAAG,EAChB;AACE,MAAA,MAAM,IAAIC,SAAS,CAAC,2CAA2C,CAAC;AAClE,IAAA;IACApB,IAAI,CAACqB,IAAI,CAAC,IAAI,CAACZ,OAAO,EAAEO,GAAG,CAAC;IAC5BhB,IAAI,CAACqB,IAAI,CAAC,IAAI,CAACd,OAAO,EAAEY,GAAG,CAAC;AAC9B,EAAA;AAIAG,EAAAA,QAAQA,GACR;IACE,OAAO,IAAI,CAACZ,KAAK;AACnB,EAAA;AAIAa,EAAAA,SAASA,GACT;IACE,OAAO,IAAI,CAAC,OAAO;AACrB,EAAA;;AAEA;AACF;AACA;AACA;AACA;EAGEC,SAASA,CAACC,MAAM,EAChB;AACE,IAAA,IAAI,CAACC,KAAK,CAACC,OAAO,CAACF,MAAM,CAAC,EAC1B;AACE,MAAA,MAAM,IAAIL,SAAS,CAAC,gDAAgD,CAAC;AACvE,IAAA;IACA,IAAIQ,MAAM,GAAG,CAAC;AACd,IAAA,KAAK,MAAMC,OAAO,IAAIJ,MAAM,EAC5B;MACE,MAAMK,MAAM,GAAGC,MAAM,CAACF,OAAO,EAAEC,MAAM,CAAC,IAAI,CAAC;MAC3C,MAAME,QAAQ,GAAGD,MAAM,CAACF,OAAO,EAAEG,QAAQ,CAAC,IAAI,CAAC;MAC/CJ,MAAM,GAAGK,IAAI,CAACd,GAAG,CAACS,MAAM,EAAEE,MAAM,GAAGE,QAAQ,CAAC;AAC9C,IAAA;AACA,IAAA,IAAI,CAAC,OAAO,GAAGrB,MAAM,CAACC,MAAM,CAACa,MAAM,CAACS,KAAK,EAAE,CAAC;AAC5C,IAAA,IAAI,CAAC,OAAO,GAAGN,MAAM;AACvB,EAAA;AAIAO,EAAAA,SAASA,GACT;IACE,OAAO,IAAI,CAAC,OAAO;AACrB,EAAA;AAIAC,EAAAA,4BAA4BA,CAACC,YAAY,GAAG,CAAC,EAC7C;IACE,OAAO;MACLrB,GAAG,EAAEhB,IAAI,CAACsC,KAAK,CAAC,IAAI,CAAC7B,OAAO,CAAC;AAC7BU,MAAAA,GAAG,EAAEnB,IAAI,CAACsC,KAAK,CAAC,IAAI,CAAC/B,OAAO;KAC7B;AACH,EAAA;AAAC,EAAA;IAAAf,UAAA,EAAA;AAAA;AAEH;;;;"}
+{"version":3,"file":"Tr2DirectInstanceData.js","sources":["../../../src/trinityCore/Tr2DirectInstanceData.js"],"sourcesContent":["// Ported from CarbonEngine (MIT, (c) 2026 CCP Games) - https://github.com/carbonengine/trinity\n//   trinity/trinity/Tr2DirectInstanceData.h\n//   trinity/trinity/Tr2DirectInstanceData.cpp\n//   trinity/trinity/Tr2DirectInstanceData_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 * Instance data whose buffer lives entirely on the GPU: Trinity keeps only the\n * CPU-side layout metadata, stride, instance count and bounds.\n */\n@type.define({ className: \"Tr2DirectInstanceData\", family: \"trinityCore\" })\nexport class Tr2DirectInstanceData extends CjsModel\n{\n\n  /** m_aabb.m_max (Vector3) [READ] */\n  @io.read\n  @type.vec3\n  aabbMax = vec3.create();\n\n  /** m_aabb.m_min (Vector3) [READ] */\n  @io.read\n  @type.vec3\n  aabbMin = vec3.create();\n\n  /** GetCount (MAP_PROPERTY_READONLY \"count\") - number of instances. */\n  @io.read\n  @type.uint32\n  count = 0;\n\n  /** m_layout (Tr2VertexDefinition) - CPU metadata for the direct GPU stream. */\n  #layout = Object.freeze([]);\n\n  #stride = 0;\n\n  /**\n   * Assigns the CPU-side instance bounds without realizing a GPU buffer.\n   * Accepts the JavaScript `{ min, max }` box representation; a two-vector\n   * form is retained for consistency with `Tr2RuntimeInstanceData`.\n   */\n  @carbon.method\n  @impl.adapted\n  SetBoundingBox(bounds, maxBounds)\n  {\n    const min = maxBounds === undefined ? bounds?.min ?? bounds?.minBounds : bounds;\n    const max = maxBounds === undefined ? bounds?.max ?? bounds?.maxBounds : maxBounds;\n    if (!min || !max)\n    {\n      throw new TypeError(\"Bounding box requires min and max vectors\");\n    }\n    vec3.copy(this.aabbMin, min);\n    vec3.copy(this.aabbMax, max);\n  }\n\n  /** Number of instances in the GPU-side buffer. */\n  @carbon.method\n  @impl.implemented\n  GetCount()\n  {\n    return this.count;\n  }\n\n  /**\n   * Byte stride of one instance, computed by SetLayout as the largest offset\n   * plus element size in the layout.\n   */\n  @carbon.method\n  @impl.implemented\n  GetStride()\n  {\n    return this.#stride;\n  }\n\n  /**\n   * Records the CPU vertex-layout metadata. Carbon computes the stride as\n   * max(offset + elementSize); the direct GPU buffer itself is realized by\n   * the engine (GetData/UpdateData/DestroyData are engine-owned).\n   */\n  @carbon.method\n  @impl.adapted\n  SetLayout(layout)\n  {\n    if (!Array.isArray(layout))\n    {\n      throw new TypeError(\"Layout must be an array of element descriptors\");\n    }\n    let stride = 0;\n    for (const element of layout)\n    {\n      const offset = Number(element?.offset) || 0;\n      const byteSize = Number(element?.byteSize) || 0;\n      stride = Math.max(stride, offset + byteSize);\n    }\n    this.#layout = Object.freeze(layout.slice());\n    this.#stride = stride;\n  }\n\n  /** The frozen element-descriptor list recorded by SetLayout. */\n  @carbon.method\n  @impl.implemented\n  GetLayout()\n  {\n    return this.#layout;\n  }\n\n  /**\n   * A detached copy of the recorded bounds; the buffer index is ignored because\n   * only one stream is modelled.\n   */\n  @carbon.method\n  @impl.implemented\n  GetInstanceBufferBoundingBox(_bufferIndex = 0)\n  {\n    return {\n      min: vec3.clone(this.aabbMin),\n      max: vec3.clone(this.aabbMax)\n    };\n  }\n\n}\n"],"names":["_Tr2DirectInstanceDat","Tr2DirectInstanceData","CjsModel","e","_init_aabbMax","_init_extra_aabbMax","_init_aabbMin","_init_extra_aabbMin","_init_count","_init_extra_count","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","read","vec3","uint32","carbon","method","impl","adapted","implemented","aabbMax","create","aabbMin","count","Object","freeze","SetBoundingBox","bounds","maxBounds","min","undefined","minBounds","max","TypeError","copy","GetCount","GetStride","SetLayout","layout","Array","isArray","stride","element","offset","Number","byteSize","Math","slice","GetLayout","GetInstanceBufferBoundingBox","_bufferIndex","clone"],"mappings":"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"}

package/dist/trinityCore/Tr2ExpressionTermInfo.js

@@ -8,6 +8,11 @@ const TermType = Object.freeze({
   FUNCTION: 1,
   STRING_FUNCTION: 2
 });
+
+/**
+ * Describes one term the expression language exposes - a variable, a function or
+ * a string function - with its category, argument names and help text.
+ */
 let _Tr2ExpressionTermInf;
 new class extends _identity {
   static [class Tr2ExpressionTermInfo extends CjsModel {
@@ -34,20 +39,36 @@ new class extends _identity {
     name = (_init_extra_category(this), _init_name(this, ""));
     description = (_init_extra_name(this), _init_description(this, ""));
     #arguments = (_init_extra_description(this), []);
+
+    /** A detached copy of the argument-name list. */
     GetArguments() {
       return this.#arguments.slice();
     }
+
+    /** Builds a VARIABLE term, which takes no arguments. */
     static Variable(category, name, description) {
       return _Tr2ExpressionTermInf.#create(TermType.VARIABLE, category, name, [], description);
     }
+
+    /**
+     * Builds a FUNCTION term where every trailing value but the last is an
+     * argument name and the last is the description.
+     */
     static Function(category, name, ...argumentsAndDescription) {
       const values = argumentsAndDescription.slice();
       const description = values.pop() ?? "";
       return _Tr2ExpressionTermInf.#create(TermType.FUNCTION, category, name, values, description);
     }
+
+    /** Builds a STRING_FUNCTION term taking exactly one argument. */
     static StringFunction(category, name, argument, description) {
       return _Tr2ExpressionTermInf.#create(TermType.STRING_FUNCTION, category, name, [argument], description);
     }
+
+    /**
+     * Constructs and fills a term of the given type, copying the argument list so
+     * the caller's array is not retained.
+     */
   }];
   #create(_0, _1, _2, _3, _4) {
     return _create.apply(this, arguments);

package/dist/trinityCore/Tr2ExpressionTermInfo.js.map

@@ -1 +1 @@
-{"version":3,"file":"Tr2ExpressionTermInfo.js","sources":["../../../src/trinityCore/Tr2ExpressionTermInfo.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Tr2ExpressionTermInfo.h\n// Source: E:\\carbonengine\\trinity\\trinity\\Tr2ExpressionTermInfo.cpp\n// Source: E:\\carbonengine\\trinity\\trinity\\Tr2ExpressionTermInfo_Blue.cpp\nimport { CjsModel } from \"@carbonenginejs/runtime-utils/model\";\nimport { carbon, impl, io, schema, type } from \"@carbonenginejs/runtime-utils/schema\";\n\n\nconst TermType = Object.freeze({\n  VARIABLE: 0,\n  FUNCTION: 1,\n  STRING_FUNCTION: 2\n});\n\n\n@type.define({\n  className: \"Tr2ExpressionTermInfo\",\n  family: \"trinityCore\"\n})\nexport class Tr2ExpressionTermInfo extends CjsModel\n{\n  @io.readwrite\n  @type.int32\n  @schema.enum(\"TermType\")\n  type = TermType.VARIABLE;\n\n  @io.readwrite\n  @type.string\n  category = \"\";\n\n  @io.readwrite\n  @type.string\n  name = \"\";\n\n  @io.readwrite\n  @type.string\n  description = \"\";\n\n  #arguments = [];\n\n  @carbon.method\n  @impl.implemented\n  GetArguments()\n  {\n    return this.#arguments.slice();\n  }\n\n  static Variable(category, name, description)\n  {\n    return Tr2ExpressionTermInfo.#create(TermType.VARIABLE, category, name, [], description);\n  }\n\n  static Function(category, name, ...argumentsAndDescription)\n  {\n    const values = argumentsAndDescription.slice();\n    const description = values.pop() ?? \"\";\n    return Tr2ExpressionTermInfo.#create(TermType.FUNCTION, category, name, values, description);\n  }\n\n  static StringFunction(category, name, argument, description)\n  {\n    return Tr2ExpressionTermInfo.#create(TermType.STRING_FUNCTION, category, name, [argument], description);\n  }\n\n  static #create(termType, category, name, args, description)\n  {\n    const term = new Tr2ExpressionTermInfo();\n    term.type = termType;\n    term.category = category;\n    term.name = name;\n    term.description = description;\n    term.#arguments = args.slice();\n    return term;\n  }\n\n  static TermType = TermType;\n\n}\n"],"names":["TermType","Object","freeze","VARIABLE","FUNCTION","STRING_FUNCTION","_Tr2ExpressionTermInf","_identity","Tr2ExpressionTermInfo","CjsModel","e","_init_type","_init_extra_type","_init_category","_init_extra_category","_init_name","_init_extra_name","_init_description","_init_extra_description","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","readwrite","int32","schema","enum","string","carbon","method","impl","implemented","_create","termType","category","name","args","description","term","slice","GetArguments","Variable","Function","argumentsAndDescription","values","pop","StringFunction","argument","#create","_0","_1","_2","_3","_4","apply","arguments","constructor"],"mappings":"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"}
+{"version":3,"file":"Tr2ExpressionTermInfo.js","sources":["../../../src/trinityCore/Tr2ExpressionTermInfo.js"],"sourcesContent":["// Source: E:\\carbonengine\\trinity\\trinity\\Tr2ExpressionTermInfo.h\n// Source: E:\\carbonengine\\trinity\\trinity\\Tr2ExpressionTermInfo.cpp\n// Source: E:\\carbonengine\\trinity\\trinity\\Tr2ExpressionTermInfo_Blue.cpp\nimport { CjsModel } from \"@carbonenginejs/runtime-utils/model\";\nimport { carbon, impl, io, schema, type } from \"@carbonenginejs/runtime-utils/schema\";\n\n\nconst TermType = Object.freeze({\n  VARIABLE: 0,\n  FUNCTION: 1,\n  STRING_FUNCTION: 2\n});\n\n\n/**\n * Describes one term the expression language exposes - a variable, a function or\n * a string function - with its category, argument names and help text.\n */\n@type.define({\n  className: \"Tr2ExpressionTermInfo\",\n  family: \"trinityCore\"\n})\nexport class Tr2ExpressionTermInfo extends CjsModel\n{\n  @io.readwrite\n  @type.int32\n  @schema.enum(\"TermType\")\n  type = TermType.VARIABLE;\n\n  @io.readwrite\n  @type.string\n  category = \"\";\n\n  @io.readwrite\n  @type.string\n  name = \"\";\n\n  @io.readwrite\n  @type.string\n  description = \"\";\n\n  #arguments = [];\n\n  /** A detached copy of the argument-name list. */\n  @carbon.method\n  @impl.implemented\n  GetArguments()\n  {\n    return this.#arguments.slice();\n  }\n\n  /** Builds a VARIABLE term, which takes no arguments. */\n  static Variable(category, name, description)\n  {\n    return Tr2ExpressionTermInfo.#create(TermType.VARIABLE, category, name, [], description);\n  }\n\n  /**\n   * Builds a FUNCTION term where every trailing value but the last is an\n   * argument name and the last is the description.\n   */\n  static Function(category, name, ...argumentsAndDescription)\n  {\n    const values = argumentsAndDescription.slice();\n    const description = values.pop() ?? \"\";\n    return Tr2ExpressionTermInfo.#create(TermType.FUNCTION, category, name, values, description);\n  }\n\n  /** Builds a STRING_FUNCTION term taking exactly one argument. */\n  static StringFunction(category, name, argument, description)\n  {\n    return Tr2ExpressionTermInfo.#create(TermType.STRING_FUNCTION, category, name, [argument], description);\n  }\n\n  /**\n   * Constructs and fills a term of the given type, copying the argument list so\n   * the caller's array is not retained.\n   */\n  static #create(termType, category, name, args, description)\n  {\n    const term = new Tr2ExpressionTermInfo();\n    term.type = termType;\n    term.category = category;\n    term.name = name;\n    term.description = description;\n    term.#arguments = args.slice();\n    return term;\n  }\n\n  static TermType = TermType;\n\n}\n"],"names":["TermType","Object","freeze","VARIABLE","FUNCTION","STRING_FUNCTION","_Tr2ExpressionTermInf","_identity","Tr2ExpressionTermInfo","CjsModel","e","_init_type","_init_extra_type","_init_category","_init_extra_category","_init_name","_init_extra_name","_init_description","_init_extra_description","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","readwrite","int32","schema","enum","string","carbon","method","impl","implemented","_create","termType","category","name","args","description","term","slice","GetArguments","Variable","Function","argumentsAndDescription","values","pop","StringFunction","argument","#create","_0","_1","_2","_3","_4","apply","arguments","constructor"],"mappings":"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"}

package/dist/trinityCore/Tr2GpuBuffer.js

@@ -30,6 +30,11 @@ new class extends _identity {
 
     /** m_name - debug label; not Blue-exposed. */
     #name = (_init_extra_isValid(this), "");
+
+    /**
+     * Sets the debug label, coercing null to an empty string; Carbon keeps this
+     * private with no getter, so the paired GetName is a JS addition.
+     */
     SetName(name) {
       this.#name = String(name ?? "");
     }

package/dist/trinityCore/Tr2GpuBuffer.js.map

@@ -1 +1 @@
-{"version":3,"file":"Tr2GpuBuffer.js","sources":["../../../src/trinityCore/Tr2GpuBuffer.js"],"sourcesContent":["// Ported from CarbonEngine (MIT, (c) 2026 CCP Games) - https://github.com/carbonengine/trinity\n//   trinity/trinity/Tr2GpuBuffer.h\n// Hand-maintained from Carbon source; runtime-device owns the canonical JS class.\nimport { carbon, impl, io, schema, type } from \"@carbonenginejs/runtime-utils/schema\";\nimport { CjsModel } from \"@carbonenginejs/runtime-utils/model\";\nimport { PixelFormat } from \"@carbonenginejs/runtime-utils/render-context\";\n\n/** Tr2GpuBuffer (trinityCore) - generated from schema shapeHash 7a225a45.... */\n@type.define({ className: \"Tr2GpuBuffer\", family: \"trinityCore\" })\nexport class Tr2GpuBuffer extends CjsModel\n{\n\n  static CreationFlags = Object.freeze({ CPU_WRITABLE: 1, GPU_WRITABLE: 2, DRAW_INDIRECT: 4 });\n\n  /** m_creationFlags (CreationFlags) [READWRITE, PERSIST, NOTIFY] */\n  @io.notify\n  @io.persist\n  @type.uint32\n  creationFlags = 0;\n\n  /** m_format (Tr2RenderContextEnum::PixelFormat - enum PixelFormat) [READWRITE, ENUM, PERSIST, NOTIFY] */\n  @io.notify\n  @io.persist\n  @type.int32\n  @schema.enum(\"PixelFormat\")\n  format = 0;\n\n  /** m_count (uint32_t) [READWRITE, PERSIST, NOTIFY] */\n  @io.notify\n  @io.persist\n  @type.uint32\n  count = 0;\n\n  @io.read\n  @type.boolean\n  isValid = false;\n\n  /** m_name - debug label; not Blue-exposed. */\n  #name = \"\";\n\n  @carbon.method\n  @impl.implemented\n  SetName(name)\n  {\n    this.#name = String(name ?? \"\");\n  }\n\n  /** JS accessor for the debug label; Carbon keeps m_name private with no getter. */\n  GetName()\n  {\n    return this.#name;\n  }\n\n  /** Carbon method __init__ (MAP_METHOD_AND_WRAP_OPTIONAL_ARGS). */\n  @carbon.method\n  @impl.notImplemented\n  __init__(...args)\n  {\n    throw new Error(\"Tr2GpuBuffer.__init__ is not implemented in CarbonEngineJS.\");\n  }\n\n  /** Carbon method DebugGetData -> PyGetData (MAP_METHOD). */\n  @carbon.method\n  @impl.notImplemented\n  DebugGetData(...args)\n  {\n    throw new Error(\"Tr2GpuBuffer.DebugGetData is not implemented in CarbonEngineJS.\");\n  }\n\n  static PixelFormat = PixelFormat;\n\n}\n"],"names":["_Tr2GpuBuffer","_identity","Tr2GpuBuffer","CjsModel","e","_init_creationFlags","_init_extra_creationFlags","_init_format","_init_extra_format","_init_count","_init_extra_count","_init_isValid","_init_extra_isValid","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","notify","persist","uint32","int32","schema","enum","read","boolean","carbon","method","impl","implemented","notImplemented","creationFlags","format","count","isValid","SetName","name","String","GetName","__init__","args","Error","DebugGetData","CreationFlags","Object","freeze","CPU_WRITABLE","GPU_WRITABLE","DRAW_INDIRECT","PixelFormat","constructor"],"mappings":"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"}
+{"version":3,"file":"Tr2GpuBuffer.js","sources":["../../../src/trinityCore/Tr2GpuBuffer.js"],"sourcesContent":["// Ported from CarbonEngine (MIT, (c) 2026 CCP Games) - https://github.com/carbonengine/trinity\n//   trinity/trinity/Tr2GpuBuffer.h\n// Hand-maintained from Carbon source; runtime-device owns the canonical JS class.\nimport { carbon, impl, io, schema, type } from \"@carbonenginejs/runtime-utils/schema\";\nimport { CjsModel } from \"@carbonenginejs/runtime-utils/model\";\nimport { PixelFormat } from \"@carbonenginejs/runtime-utils/render-context\";\n\n/** Tr2GpuBuffer (trinityCore) - generated from schema shapeHash 7a225a45.... */\n@type.define({ className: \"Tr2GpuBuffer\", family: \"trinityCore\" })\nexport class Tr2GpuBuffer extends CjsModel\n{\n\n  static CreationFlags = Object.freeze({ CPU_WRITABLE: 1, GPU_WRITABLE: 2, DRAW_INDIRECT: 4 });\n\n  /** m_creationFlags (CreationFlags) [READWRITE, PERSIST, NOTIFY] */\n  @io.notify\n  @io.persist\n  @type.uint32\n  creationFlags = 0;\n\n  /** m_format (Tr2RenderContextEnum::PixelFormat - enum PixelFormat) [READWRITE, ENUM, PERSIST, NOTIFY] */\n  @io.notify\n  @io.persist\n  @type.int32\n  @schema.enum(\"PixelFormat\")\n  format = 0;\n\n  /** m_count (uint32_t) [READWRITE, PERSIST, NOTIFY] */\n  @io.notify\n  @io.persist\n  @type.uint32\n  count = 0;\n\n  @io.read\n  @type.boolean\n  isValid = false;\n\n  /** m_name - debug label; not Blue-exposed. */\n  #name = \"\";\n\n  /**\n   * Sets the debug label, coercing null to an empty string; Carbon keeps this\n   * private with no getter, so the paired GetName is a JS addition.\n   */\n  @carbon.method\n  @impl.implemented\n  SetName(name)\n  {\n    this.#name = String(name ?? \"\");\n  }\n\n  /** JS accessor for the debug label; Carbon keeps m_name private with no getter. */\n  GetName()\n  {\n    return this.#name;\n  }\n\n  /** Carbon method __init__ (MAP_METHOD_AND_WRAP_OPTIONAL_ARGS). */\n  @carbon.method\n  @impl.notImplemented\n  __init__(...args)\n  {\n    throw new Error(\"Tr2GpuBuffer.__init__ is not implemented in CarbonEngineJS.\");\n  }\n\n  /** Carbon method DebugGetData -> PyGetData (MAP_METHOD). */\n  @carbon.method\n  @impl.notImplemented\n  DebugGetData(...args)\n  {\n    throw new Error(\"Tr2GpuBuffer.DebugGetData is not implemented in CarbonEngineJS.\");\n  }\n\n  static PixelFormat = PixelFormat;\n\n}\n"],"names":["_Tr2GpuBuffer","_identity","Tr2GpuBuffer","CjsModel","e","_init_creationFlags","_init_extra_creationFlags","_init_format","_init_extra_format","_init_count","_init_extra_count","_init_isValid","_init_extra_isValid","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","notify","persist","uint32","int32","schema","enum","read","boolean","carbon","method","impl","implemented","notImplemented","creationFlags","format","count","isValid","SetName","name","String","GetName","__init__","args","Error","DebugGetData","CreationFlags","Object","freeze","CPU_WRITABLE","GPU_WRITABLE","DRAW_INDIRECT","PixelFormat","constructor"],"mappings":"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"}

package/dist/{generated/trinityCore → trinityCore}/Tr2GrannyAnimation.js

@@ -1,12 +1,12 @@
-import { applyDecs2311 as _applyDecs2311 } from '../../_virtual/_rollupPluginBabelHelpers.js';
+import { applyDecs2311 as _applyDecs2311 } from '../_virtual/_rollupPluginBabelHelpers.js';
 import { mat3 } from '@carbonenginejs/runtime-utils/mat3';
 import { mat4 } from '@carbonenginejs/runtime-utils/mat4';
 import { quat } from '@carbonenginejs/runtime-utils/quat';
 import { vec3 } from '@carbonenginejs/runtime-utils/vec3';
 import { io, type, impl, carbon } from '@carbonenginejs/runtime-utils/schema';
 import { CjsModel } from '@carbonenginejs/runtime-utils/model';
-import { CjsGrannyCurves } from '../../curves/CjsGrannyCurves.js';
-import { GrannyBoneOffset as _GrannyBoneOffset } from '../../trinityCore/GrannyBoneOffset.js';
+import { CjsGrannyCurves } from '../curves/CjsGrannyCurves.js';
+import { GrannyBoneOffset as _GrannyBoneOffset } from './GrannyBoneOffset.js';
 
 let _initProto, _initClass, _init_resPath_, _init_extra_resPath_, _init_model_, _init_extra_model_, _init_grannyRes, _init_extra_grannyRes, _init_eventListener, _init_extra_eventListener, _init_animationEnabled, _init_extra_animationEnabled, _init_debugRenderJointNames, _init_extra_debugRenderJointNames, _init_debugRenderSkeleton, _init_extra_debugRenderSkeleton, _init_boneOffset, _init_extra_boneOffset;
 function createLayer(name = "", weight = 1, allBones = false) {
@@ -26,7 +26,39 @@ function getName(value) {
   return String(value?.name ?? value?.Name ?? "");
 }
 
-/** Tr2GrannyAnimation (trinityCore) - generated from schema shapeHash 056bad2a.... */
+/** No bones: the shape every consumer already handles, per Carbon's else branch. */
+const NO_BONES = Object.freeze({
+  bones: null,
+  boneCount: 0
+});
+
+/**
+ * The mesh bone palette of an animation updater, or nulls when it has none.
+ *
+ * Carbon `Tr2GrannyAnimationUtils::GetBoneList` (Tr2GrannyAnimation.cpp:24-33),
+ * which every bone consumer calls before threading `(bones, boneCount)` down.
+ * An uninitialised updater or a zero bone count yields the same shape as no
+ * updater at all, so callers need one branch rather than three.
+ *
+ * The palette is BORROWED - it is the updater's live buffer, rewritten in place
+ * each frame. Do not retain it across frames or mutate it.
+ */
+function getBoneList(animationUpdater) {
+  if (!animationUpdater?.IsInitialized?.()) {
+    return NO_BONES;
+  }
+  const boneCount = animationUpdater.GetMeshBoneCount?.() ?? 0;
+  if (!boneCount) {
+    return NO_BONES;
+  }
+  const bones = animationUpdater.GetMeshBoneMatrixList?.();
+  return bones ? {
+    bones,
+    boneCount
+  } : NO_BONES;
+}
+
+/** Tr2GrannyAnimation (trinityCore) - promoted from generated; shapeHash 056bad2a. */
 let _Tr2GrannyAnimation;
 class Tr2GrannyAnimation extends CjsModel {
   static {
@@ -36,7 +68,7 @@ class Tr2GrannyAnimation extends CjsModel {
     } = _applyDecs2311(this, [type.define({
       className: "Tr2GrannyAnimation",
       family: "trinityCore"
-    })], [[[io, io.persistOnly, type, type.string], 16, "resPath_"], [[io, io.persistOnly, type, type.string], 16, "model_"], [[io, io.read, void 0, type.objectRef("TriGrannyRes")], 16, "grannyRes"], [[io, io.readwrite, void 0, type.objectRef("IBlueEventListener")], 16, "eventListener"], [[io, io.readwrite, type, type.boolean], 16, "animationEnabled"], [[io, io.readwrite, type, type.boolean], 16, "debugRenderJointNames"], [[io, io.readwrite, type, type.boolean], 16, "debugRenderSkeleton"], [[io, io.read, void 0, type.objectRef("GrannyBoneOffset")], 16, "boneOffset"], [[impl, impl.adapted], 18, "Initialize"], [[impl, impl.adapted], 18, "SetGrannyResource"], [[impl, impl.adapted], 18, "RebuildCachedData"], [[impl, impl.adapted], 18, "Update"], [[carbon, carbon.method, impl, impl.adapted], 18, "PlayAnimationEx"], [[carbon, carbon.method, impl, impl.implemented], 18, "AddAnimationLayer"], [[carbon, carbon.method, impl, impl.implemented], 18, "AddAnimationLayerAllBones"], [[carbon, carbon.method, impl, impl.implemented], 18, "AddAnimationLayerBone"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Resource loading stays runtime-resource-owned; registered decoded resources are attached synchronously when available.")], 18, "AddSecondaryResPath"], [[impl, impl.adapted], 18, "SetSecondaryGrannyResource"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("The browser graph retains Carbon's aim request; final IK realization can be refined by an engine adapter.")], 18, "AimBone"], [[carbon, carbon.method, impl, impl.implemented], 18, "ChainAnimation"], [[carbon, carbon.method, impl, impl.implemented], 18, "ChainAnimationEx"], [[carbon, carbon.method, impl, impl.implemented], 18, "ClearAnimations"], [[carbon, carbon.method, impl, impl.implemented], 18, "ClearAnimationLayers"], [[carbon, carbon.method, impl, impl.implemented], 18, "DisableAimBone"], [[carbon, carbon.method, impl, impl.adapted], 18, "EndAnimation"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetAdditiveBlendMode"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetLayerWeight"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetSecondaryAnimationName"], [[carbon, carbon.method, impl, impl.adapted], 18, "PlayAnimation"], [[impl, impl.adapted], 18, "PlayAnimationOnce"], [[carbon, carbon.method, impl, impl.adapted], 18, "PlayLayerAnimation"], [[impl, impl.adapted], 18, "PlayLayerAnimationByName"], [[carbon, carbon.method, impl, impl.implemented], 18, "RemoveAnimationLayerBone"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetAnimationNames"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetAdditiveBlendMode"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetLayerControlParam"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetLayerControlParamSkewRate"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetLayerWeight"], [[carbon, carbon.method, impl, impl.implemented], 18, "TogglePauseAnimations"], [[impl, impl.implemented], 18, "IsInitialized"], [[impl, impl.adapted], 18, "GetMeshBoneMatrixList"], [[impl, impl.implemented], 18, "GetMeshBoneCount"], [[impl, impl.adapted], 18, "GetBoneWorldTransform"], [[impl, impl.adapted], 18, "GetBoneTransform"], [[impl, impl.adapted], 18, "GetBoneMatrix"], [[impl, impl.implemented], 18, "GetAnimationTransforms"], [[impl, impl.implemented], 18, "GetAnimationBoneList"], [[impl, impl.implemented], 18, "GetMorphAnimations"], [[impl, impl.adapted], 18, "GetAimBoneState"]], 0, void 0, CjsModel));
+    })], [[[io, io.persistOnly, type, type.string], 16, "resPath_"], [[io, io.persistOnly, type, type.string], 16, "model_"], [[io, io.read, void 0, type.objectRef("TriGrannyRes")], 16, "grannyRes"], [[io, io.readwrite, void 0, type.objectRef("IBlueEventListener")], 16, "eventListener"], [[io, io.readwrite, type, type.boolean], 16, "animationEnabled"], [[io, io.readwrite, type, type.boolean], 16, "debugRenderJointNames"], [[io, io.readwrite, type, type.boolean], 16, "debugRenderSkeleton"], [[io, io.read, void 0, type.objectRef("GrannyBoneOffset")], 16, "boneOffset"], [[impl, impl.adapted], 18, "Initialize"], [[impl, impl.adapted], 18, "SetGrannyResource"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetSharedGeometryRes"], [[carbon, carbon.method, impl, impl.implemented], 18, "HasMeshBinding"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetUseMeshBinding"], [[impl, impl.adapted], 18, "HasSharedGeometryRes"], [[impl, impl.adapted], 18, "RebuildCachedData"], [[impl, impl.adapted], 18, "Update"], [[carbon, carbon.method, impl, impl.adapted], 18, "PlayAnimationEx"], [[carbon, carbon.method, impl, impl.implemented], 18, "AddAnimationLayer"], [[carbon, carbon.method, impl, impl.implemented], 18, "AddAnimationLayerAllBones"], [[carbon, carbon.method, impl, impl.implemented], 18, "AddAnimationLayerBone"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Resource loading stays runtime-resource-owned; registered decoded resources are attached synchronously when available.")], 18, "AddSecondaryResPath"], [[impl, impl.adapted], 18, "SetSecondaryGrannyResource"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("The browser graph retains Carbon's aim request; final IK realization can be refined by an engine adapter.")], 18, "AimBone"], [[carbon, carbon.method, impl, impl.implemented], 18, "ChainAnimation"], [[carbon, carbon.method, impl, impl.implemented], 18, "ChainAnimationEx"], [[carbon, carbon.method, impl, impl.implemented], 18, "ClearAnimations"], [[carbon, carbon.method, impl, impl.implemented], 18, "ClearAnimationLayers"], [[carbon, carbon.method, impl, impl.implemented], 18, "DisableAimBone"], [[carbon, carbon.method, impl, impl.adapted], 18, "EndAnimation"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetAdditiveBlendMode"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetLayerWeight"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetSecondaryAnimationName"], [[carbon, carbon.method, impl, impl.adapted], 18, "PlayAnimation"], [[impl, impl.adapted], 18, "PlayAnimationOnce"], [[carbon, carbon.method, impl, impl.adapted], 18, "PlayLayerAnimation"], [[impl, impl.adapted], 18, "PlayLayerAnimationByName"], [[carbon, carbon.method, impl, impl.implemented], 18, "RemoveAnimationLayerBone"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetAnimationNames"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetAdditiveBlendMode"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetLayerControlParam"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetLayerControlParamSkewRate"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetLayerWeight"], [[carbon, carbon.method, impl, impl.implemented], 18, "TogglePauseAnimations"], [[impl, impl.implemented], 18, "IsInitialized"], [[impl, impl.adapted], 18, "GetMeshBoneMatrixList"], [[impl, impl.implemented], 18, "GetMeshBoneCount"], [[impl, impl.adapted], 18, "GetBoneWorldTransform"], [[impl, impl.adapted], 18, "GetBoneTransform"], [[impl, impl.adapted], 18, "GetBoneMatrix"], [[impl, impl.implemented], 18, "GetAnimationTransforms"], [[impl, impl.implemented], 18, "GetAnimationBoneList"], [[impl, impl.implemented], 18, "GetMorphAnimations"], [[impl, impl.adapted], 18, "GetAimBoneState"]], 0, void 0, CjsModel));
   }
   constructor(...args) {
     super(...args);
@@ -52,6 +84,18 @@ class Tr2GrannyAnimation extends CjsModel {
   #initialized = false;
   #layers = new Map();
   #meshBoneIndices = [];
+
+  /**
+   * Carbon's `Float4x3* m_meshBoneMatrixList` (Tr2GrannyAnimation.h:208) - one
+   * contiguous palette, stride 12, allocated once and rewritten in place.
+   */
+  #meshBonePalette = null;
+
+  /** Carbon m_useMeshBinding (Tr2GrannyAnimation.cpp:81) - defaults false. */
+  #useMeshBinding = false;
+
+  /** Whether grannyRes was borrowed from the mesh rather than resolved here. */
+  #sharedGeometry = false;
   #morphAnimations = new Map();
   #morphCurveCache = new WeakMap();
   #morphSample = new Float32Array(1);
@@ -94,9 +138,47 @@ class Tr2GrannyAnimation extends CjsModel {
   /** Attaches an already decoded TriGrannyRes-compatible resource. */
   SetGrannyResource(resource) {
     this.grannyRes = resource ?? null;
+    this.#sharedGeometry = false;
+    return this.RebuildCachedData();
+  }
+
+  /**
+   * Binds a geometry resource BORROWED from the mesh this controller animates,
+   * rather than one resolved from its own resPath.
+   *
+   * Carbon `SetSharedGeometryRes` (Tr2GrannyAnimation.h), driven by
+   * `EveChildMesh::InitializeAnimation` when the updater has no authored path
+   * of its own. A null resource clears the binding, which is Carbon's fallback
+   * when the mesh has no geometry yet.
+   */
+  SetSharedGeometryRes(resource) {
+    this.grannyRes = resource ?? null;
+    this.#sharedGeometry = !!resource;
     return this.RebuildCachedData();
   }
 
+  /**
+   * Whether the palette is built from the MESH's bone binding.
+   *
+   * Carbon gates palette construction on this (`m_useMeshBinding`,
+   * Tr2GrannyAnimation.cpp:588, :633) and `EveChildMesh::GetBoneTransforms`
+   * branches on it to choose between this controller's palette and a separate
+   * Tr2AnimationMeshBinding. Defaults false, matching cpp:81.
+   */
+  HasMeshBinding() {
+    return this.#useMeshBinding;
+  }
+
+  /** Carbon `SetUseMeshBinding` (Tr2GrannyAnimation.h:60). */
+  SetUseMeshBinding(enable) {
+    this.#useMeshBinding = !!enable;
+  }
+
+  /** Whether the bound geometry was borrowed from the mesh. */
+  HasSharedGeometryRes() {
+    return this.#sharedGeometry;
+  }
+
   /** Rebuilds browser bone state directly from format-gr2's stable payload. */
   RebuildCachedData() {
     const source = this.#getSource(this.grannyRes);
@@ -357,10 +439,57 @@ class Tr2GrannyAnimation extends CjsModel {
     return this.#initialized;
   }
 
-  /** Returns the mesh-order browser bone matrices expected by Eve objects. */
+  /**
+   * The mesh-order bone palette, in Carbon's storage: ONE contiguous buffer of
+   * Float4x3 entries, stride 12, not an array of matrices.
+   *
+   * Carbon holds `Float4x3* m_meshBoneMatrixList` (Tr2GrannyAnimation.h:208)
+   * and every CPU consumer unpacks it with `TriMatrixCopyFrom3x4`. The JS
+   * consumers already expect that shape - `MatrixCopyFrom3x4` indexes
+   * `boneIndex * 12` for the light sets, bounds and decals - so the palette is
+   * built here rather than converted at each of nine call sites. It is also
+   * what an uploader wants: one block, handed over whole.
+   *
+   * Float4x3 drops the constant fourth column and stores the first three
+   * columns of the 4x4 (Utilities/MatrixUtils.cpp:6-20).
+   */
   GetMeshBoneMatrixList() {
     const bones = this.#runtimeModel?.bones ?? [];
-    return this.#meshBoneIndices.map(index => bones[index]?.offsetTransform ?? mat4.create());
+    const count = this.#meshBoneIndices.length;
+    if (!this.#meshBonePalette || this.#meshBonePalette.length !== count * 12) {
+      this.#meshBonePalette = new Float32Array(count * 12);
+    }
+    const palette = this.#meshBonePalette;
+    for (let index = 0; index < count; index++) {
+      const source = bones[this.#meshBoneIndices[index]]?.offsetTransform;
+      const base = index * 12;
+      if (!source) {
+        // Carbon leaves an unmapped bone at whatever the palette held; identity
+        // is the reproducible stand-in and keeps a missing bone from collapsing
+        // its geometry to the origin.
+        palette[base] = palette[base + 5] = palette[base + 10] = 1;
+        palette[base + 1] = palette[base + 2] = palette[base + 3] = 0;
+        palette[base + 4] = palette[base + 6] = palette[base + 7] = 0;
+        palette[base + 8] = palette[base + 9] = palette[base + 11] = 0;
+        continue;
+      }
+
+      // Columns of the 4x4, which is rows of its transpose. gl-matrix is
+      // column-major, so column c is source[c * 4 + r].
+      palette[base] = source[0];
+      palette[base + 1] = source[4];
+      palette[base + 2] = source[8];
+      palette[base + 3] = source[12];
+      palette[base + 4] = source[1];
+      palette[base + 5] = source[5];
+      palette[base + 6] = source[9];
+      palette[base + 7] = source[13];
+      palette[base + 8] = source[2];
+      palette[base + 9] = source[6];
+      palette[base + 10] = source[10];
+      palette[base + 11] = source[14];
+    }
+    return palette;
   }
   GetMeshBoneCount() {
     return this.#meshBoneIndices.length;
@@ -762,5 +891,5 @@ class Tr2GrannyAnimation extends CjsModel {
   }
 }
 
-export { _Tr2GrannyAnimation as Tr2GrannyAnimation };
+export { _Tr2GrannyAnimation as Tr2GrannyAnimation, getBoneList };
 //# sourceMappingURL=Tr2GrannyAnimation.js.map