@carbonenginejs/runtime-trinity 0.6.0 → 0.7.0

package/dist/shader/support/CjsVariableStore.js.map

@@ -1 +1 @@
-{"version":3,"file":"CjsVariableStore.js","sources":["../../../../src/shader/support/CjsVariableStore.js"],"sourcesContent":["export class CjsVariableStore\n{\n\n  static #global = null;\n\n  #variables = new Map();\n\n  constructor(values = null)\n  {\n    if (values)\n    {\n      this.SetValues(values);\n    }\n  }\n\n  Set(name, value, Type = null)\n  {\n    return this.SetVariable(name, value, Type);\n  }\n\n  Get(name)\n  {\n    return this.GetVariable(name);\n  }\n\n  Has(name)\n  {\n    return this.HasVariable(name);\n  }\n\n  SetValues(values)\n  {\n    const entries = values instanceof Map ? values.entries() : Object.entries(values);\n    for (const [name, value] of entries)\n    {\n      this.SetVariable(name, value);\n    }\n    return this;\n  }\n\n  SetVariable(name, value, Type = null)\n  {\n    const key = String(name);\n    const variable = CjsVariableStore.isVariable(value) ? value : this.CreateVariable(key, value, Type);\n    if (variable && typeof variable === \"object\" && \"name\" in variable && !variable.name)\n    {\n      variable.name = key;\n    }\n    this.#variables.set(key, variable);\n    return variable;\n  }\n\n  CreateVariable(name, value = undefined, Type = null)\n  {\n    if (typeof Type === \"function\")\n    {\n      return new Type(name, value);\n    }\n    return new CjsStoredVariable(name, value, Type);\n  }\n\n  GetVariable(name)\n  {\n    return this.#variables.get(String(name)) ?? null;\n  }\n\n  getVariable(name)\n  {\n    return this.GetVariable(name);\n  }\n\n  HasVariable(name)\n  {\n    return this.#variables.has(String(name));\n  }\n\n  hasVariable(name)\n  {\n    return this.HasVariable(name);\n  }\n\n  DeleteVariable(name)\n  {\n    return this.#variables.delete(String(name));\n  }\n\n  Clear()\n  {\n    this.#variables.clear();\n  }\n\n  GetVariableValue(name, out = undefined)\n  {\n    const variable = this.GetVariable(name);\n    return variable?.GetValue?.(out) ?? variable?.getValue?.(out) ?? variable?.value ?? undefined;\n  }\n\n  getVariableValue(name, out = undefined)\n  {\n    return this.GetVariableValue(name, out);\n  }\n\n  SetVariableValue(name, value, options = undefined)\n  {\n    const variable = this.GetVariable(name) ?? this.SetVariable(name, value);\n    variable?.SetValue?.(value, options) ?? variable?.setValue?.(value, options);\n    if (variable && typeof variable === \"object\" && !variable.SetValue && !variable.setValue)\n    {\n      variable.value = value;\n    }\n    return variable;\n  }\n\n  setVariableValue(name, value, options = undefined)\n  {\n    return this.SetVariableValue(name, value, options);\n  }\n\n  Entries()\n  {\n    return [...this.#variables.entries()];\n  }\n\n  Values()\n  {\n    return [...this.#variables.values()];\n  }\n\n  static isVariable(value)\n  {\n    return !!value && typeof value === \"object\" && (typeof value.GetValue === \"function\" || typeof value.SetValue === \"function\" || typeof value.CopyValueToEffect === \"function\" || typeof value.CopyToResourceSet === \"function\" || typeof value.ApplyUav === \"function\");\n  }\n\n  static GetGlobalStore()\n  {\n    if (!CjsVariableStore.#global)\n    {\n      CjsVariableStore.#global = new CjsVariableStore();\n    }\n    return CjsVariableStore.#global;\n  }\n\n  static SetGlobalStore(store)\n  {\n    CjsVariableStore.#global = store ?? new CjsVariableStore();\n    return CjsVariableStore.#global;\n  }\n\n}\n\n\nexport class CjsStoredVariable\n{\n\n  name = \"\";\n\n  value = undefined;\n\n  type = \"value\";\n\n  constructor(name = \"\", value = undefined, type = null)\n  {\n    this.name = String(name);\n    this.value = value;\n    this.type = type ?? CjsStoredVariable.inferType(value);\n  }\n\n  GetName()\n  {\n    return this.name;\n  }\n\n  GetType()\n  {\n    return this.type;\n  }\n\n  GetValue(out = undefined)\n  {\n    if (out && this.value && typeof this.value.length === \"number\" && typeof out.length === \"number\")\n    {\n      const count = Math.min(out.length, this.value.length);\n      for (let i = 0; i < count; i++)\n      {\n        out[i] = this.value[i];\n      }\n      return out;\n    }\n    return this.value;\n  }\n\n  SetValue(value)\n  {\n    this.value = value;\n    this.type = CjsStoredVariable.inferType(value);\n    return true;\n  }\n\n  CopyValueToEffect(_inputType, destination, size = Number.POSITIVE_INFINITY)\n  {\n    if (!destination || typeof destination.length !== \"number\")\n    {\n      return false;\n    }\n    const source = this.value;\n    if (typeof source === \"number\")\n    {\n      destination[0] = source;\n      return true;\n    }\n    if (!source || typeof source.length !== \"number\")\n    {\n      return false;\n    }\n    const byteLimit = Number.isFinite(size) ? Math.max(0, size) : Infinity;\n    const count = Math.min(destination.length, source.length, Math.floor(byteLimit / 4));\n    for (let i = 0; i < count; i++)\n    {\n      destination[i] = source[i];\n    }\n    return count > 0;\n  }\n\n  static inferType(value)\n  {\n    if (typeof value === \"number\")\n    {\n      return \"float\";\n    }\n    if (typeof value === \"string\")\n    {\n      return \"texture\";\n    }\n    if (value && typeof value.length === \"number\")\n    {\n      return value.length === 16 ? \"matrix4\" : `vector${value.length}`;\n    }\n    return \"value\";\n  }\n\n}\n"],"names":["CjsVariableStore","Map","constructor","values","SetValues","Set","name","value","Type","SetVariable","Get","GetVariable","Has","HasVariable","entries","Object","key","String","variable","isVariable","CreateVariable","set","undefined","CjsStoredVariable","get","getVariable","has","hasVariable","DeleteVariable","delete","Clear","clear","GetVariableValue","out","GetValue","getValue","getVariableValue","SetVariableValue","options","SetValue","setValue","setVariableValue","Entries","Values","CopyValueToEffect","CopyToResourceSet","ApplyUav","GetGlobalStore","SetGlobalStore","store","type","inferType","GetName","GetType","length","count","Math","min","i","_inputType","destination","size","Number","POSITIVE_INFINITY","source","byteLimit","isFinite","max","Infinity","floor"],"mappings":"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"}
+{"version":3,"file":"CjsVariableStore.js","sources":["../../../../src/shader/support/CjsVariableStore.js"],"sourcesContent":["/**\n * A named-variable table that TriVariableParameter values resolve against, plus\n * the lazily created process-wide global instance effects fall back to.\n */\nexport class CjsVariableStore\n{\n\n  static #global = null;\n\n  #variables = new Map();\n\n  /**\n   * Creates an empty store, optionally seeded.\n   * @param values optional name-to-value Map or object routed through SetValues\n   */\n  constructor(values = null)\n  {\n    if (values)\n    {\n      this.SetValues(values);\n    }\n  }\n\n  /** Short alias for SetVariable. */\n  Set(name, value, Type = null)\n  {\n    return this.SetVariable(name, value, Type);\n  }\n\n  /** Short alias for GetVariable - returns the variable object, not its value. */\n  Get(name)\n  {\n    return this.GetVariable(name);\n  }\n\n  /** Short alias for HasVariable. */\n  Has(name)\n  {\n    return this.HasVariable(name);\n  }\n\n  /**\n   * Seeds many variables at once from a Map or plain object; returns this store\n   * for chaining.\n   */\n  SetValues(values)\n  {\n    const entries = values instanceof Map ? values.entries() : Object.entries(values);\n    for (const [name, value] of entries)\n    {\n      this.SetVariable(name, value);\n    }\n    return this;\n  }\n\n  /**\n   * Stores a value under a name, wrapping raw values in a CjsStoredVariable and\n   * naming an unnamed variable object after its key. Values that already\n   * implement the variable protocol are stored by reference, not copied.\n   */\n  SetVariable(name, value, Type = null)\n  {\n    const key = String(name);\n    const variable = CjsVariableStore.isVariable(value) ? value : this.CreateVariable(key, value, Type);\n    if (variable && typeof variable === \"object\" && \"name\" in variable && !variable.name)\n    {\n      variable.name = key;\n    }\n    this.#variables.set(key, variable);\n    return variable;\n  }\n\n  /**\n   * Constructs the wrapper object for a name/value pair, using the supplied\n   * constructor when one is given and CjsStoredVariable otherwise.\n   */\n  CreateVariable(name, value = undefined, Type = null)\n  {\n    if (typeof Type === \"function\")\n    {\n      return new Type(name, value);\n    }\n    return new CjsStoredVariable(name, value, Type);\n  }\n\n  /**\n   * The stored variable object, or null; parameters hold on to this reference\n   * until they re-Initialize.\n   */\n  GetVariable(name)\n  {\n    return this.#variables.get(String(name)) ?? null;\n  }\n\n  /**\n   * camelCase alias for GetVariable, accepted because parameters probe both\n   * spellings.\n   */\n  getVariable(name)\n  {\n    return this.GetVariable(name);\n  }\n\n  /** Whether a variable is stored under this name. */\n  HasVariable(name)\n  {\n    return this.#variables.has(String(name));\n  }\n\n  /** camelCase alias for HasVariable. */\n  hasVariable(name)\n  {\n    return this.HasVariable(name);\n  }\n\n  /**\n   * Removes the named variable; returns whether it was present. Parameters\n   * already holding the variable keep working until they re-Initialize.\n   */\n  DeleteVariable(name)\n  {\n    return this.#variables.delete(String(name));\n  }\n\n  /**\n   * Empties the table; parameters already holding a variable reference keep it\n   * until they re-Initialize.\n   */\n  Clear()\n  {\n    this.#variables.clear();\n  }\n\n  /**\n   * The variable's current value, or undefined when the name is unknown.\n   * @param out optional array the variable may fill in instead of returning its own storage\n   */\n  GetVariableValue(name, out = undefined)\n  {\n    const variable = this.GetVariable(name);\n    return variable?.GetValue?.(out) ?? variable?.getValue?.(out) ?? variable?.value ?? undefined;\n  }\n\n  /** camelCase alias for GetVariableValue. */\n  getVariableValue(name, out = undefined)\n  {\n    return this.GetVariableValue(name, out);\n  }\n\n  /**\n   * Writes a value through the named variable, creating the variable when absent\n   * and assigning `.value` directly for holders with no setter; returns the\n   * variable.\n   */\n  SetVariableValue(name, value, options = undefined)\n  {\n    const variable = this.GetVariable(name) ?? this.SetVariable(name, value);\n    variable?.SetValue?.(value, options) ?? variable?.setValue?.(value, options);\n    if (variable && typeof variable === \"object\" && !variable.SetValue && !variable.setValue)\n    {\n      variable.value = value;\n    }\n    return variable;\n  }\n\n  /** camelCase alias for SetVariableValue. */\n  setVariableValue(name, value, options = undefined)\n  {\n    return this.SetVariableValue(name, value, options);\n  }\n\n  /**\n   * Snapshot array of [name, variable] pairs; mutating the array does not affect\n   * the store.\n   */\n  Entries()\n  {\n    return [...this.#variables.entries()];\n  }\n\n  /**\n   * Snapshot array of the stored variable objects; the objects themselves are\n   * live references.\n   */\n  Values()\n  {\n    return [...this.#variables.values()];\n  }\n\n  /**\n   * Whether a value already implements the variable protocol - any of GetValue,\n   * SetValue, CopyValueToEffect, CopyToResourceSet or ApplyUav - and so should\n   * be stored unwrapped.\n   */\n  static isVariable(value)\n  {\n    return !!value && typeof value === \"object\" && (typeof value.GetValue === \"function\" || typeof value.SetValue === \"function\" || typeof value.CopyValueToEffect === \"function\" || typeof value.CopyToResourceSet === \"function\" || typeof value.ApplyUav === \"function\");\n  }\n\n  /**\n   * The process-wide fallback store, created on first use; effects with no store\n   * of their own read through it.\n   */\n  static GetGlobalStore()\n  {\n    if (!CjsVariableStore.#global)\n    {\n      CjsVariableStore.#global = new CjsVariableStore();\n    }\n    return CjsVariableStore.#global;\n  }\n\n  /**\n   * Replaces the global store, installing a fresh empty one when passed null;\n   * existing effects see the swap because they resolve the global at call time\n   * rather than capturing it.\n   */\n  static SetGlobalStore(store)\n  {\n    CjsVariableStore.#global = store ?? new CjsVariableStore();\n    return CjsVariableStore.#global;\n  }\n\n}\n\n\n/**\n * The default variable wrapper: a name, a value and an inferred type tag, able\n * to copy itself into an effect constant destination.\n */\nexport class CjsStoredVariable\n{\n\n  name = \"\";\n\n  value = undefined;\n\n  type = \"value\";\n\n  /**\n   * Creates a variable holding a raw value.\n   * @param type overrides the type tag that would otherwise be inferred from the value\n   */\n  constructor(name = \"\", value = undefined, type = null)\n  {\n    this.name = String(name);\n    this.value = value;\n    this.type = type ?? CjsStoredVariable.inferType(value);\n  }\n\n  /**\n   * The variable's name, which the store fills in from the key when it was\n   * constructed without one.\n   */\n  GetName()\n  {\n    return this.name;\n  }\n\n  /**\n   * The type tag TriVariableParameter uses to decide whether the name binds to a\n   * shader constant or a shader resource.\n   */\n  GetType()\n  {\n    return this.type;\n  }\n\n  /**\n   * Reads the value.\n   * @param out optional array filled with min(out.length, value.length) components\n   * @returns `out` when it was filled, otherwise the variable's own value by reference\n   */\n  GetValue(out = undefined)\n  {\n    if (out && this.value && typeof this.value.length === \"number\" && typeof out.length === \"number\")\n    {\n      const count = Math.min(out.length, this.value.length);\n      for (let i = 0; i < count; i++)\n      {\n        out[i] = this.value[i];\n      }\n      return out;\n    }\n    return this.value;\n  }\n\n  /**\n   * Replaces the value by reference and re-infers the type tag; always returns\n   * true.\n   */\n  SetValue(value)\n  {\n    this.value = value;\n    this.type = CjsStoredVariable.inferType(value);\n    return true;\n  }\n\n  /**\n   * Copies the value into an effect constant destination, clamped to the destination length, the source length and `size` bytes at four bytes per float; a scalar value writes one component.\n   * @param size byte budget in the destination, not a component count\n   * @returns {boolean} whether anything was written\n   */\n  CopyValueToEffect(_inputType, destination, size = Number.POSITIVE_INFINITY)\n  {\n    if (!destination || typeof destination.length !== \"number\")\n    {\n      return false;\n    }\n    const source = this.value;\n    if (typeof source === \"number\")\n    {\n      destination[0] = source;\n      return true;\n    }\n    if (!source || typeof source.length !== \"number\")\n    {\n      return false;\n    }\n    const byteLimit = Number.isFinite(size) ? Math.max(0, size) : Infinity;\n    const count = Math.min(destination.length, source.length, Math.floor(byteLimit / 4));\n    for (let i = 0; i < count; i++)\n    {\n      destination[i] = source[i];\n    }\n    return count > 0;\n  }\n\n  /**\n   * Derives a type tag from a raw value: numbers are float, strings texture,\n   * 16-length array-likes matrix4, other array-likes vectorN, everything else\n   * value.\n   */\n  static inferType(value)\n  {\n    if (typeof value === \"number\")\n    {\n      return \"float\";\n    }\n    if (typeof value === \"string\")\n    {\n      return \"texture\";\n    }\n    if (value && typeof value.length === \"number\")\n    {\n      return value.length === 16 ? \"matrix4\" : `vector${value.length}`;\n    }\n    return \"value\";\n  }\n\n}\n"],"names":["CjsVariableStore","Map","constructor","values","SetValues","Set","name","value","Type","SetVariable","Get","GetVariable","Has","HasVariable","entries","Object","key","String","variable","isVariable","CreateVariable","set","undefined","CjsStoredVariable","get","getVariable","has","hasVariable","DeleteVariable","delete","Clear","clear","GetVariableValue","out","GetValue","getValue","getVariableValue","SetVariableValue","options","SetValue","setValue","setVariableValue","Entries","Values","CopyValueToEffect","CopyToResourceSet","ApplyUav","GetGlobalStore","SetGlobalStore","store","type","inferType","GetName","GetType","length","count","Math","min","i","_inputType","destination","size","Number","POSITIVE_INFINITY","source","byteLimit","isFinite","max","Infinity","floor"],"mappings":"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"}

package/dist/shader/support/Tr2ShaderBuffer.js

@@ -32,12 +32,27 @@ class Tr2ShaderBuffer extends CjsModel {
     this.data = _Tr2ShaderBuffer.copyBytes(data, byteSize);
     this.size = byteSize;
   }
+
+  /**
+   * Sets which shader stage this buffer belongs to; a non-numeric value becomes
+   * 0.
+   */
   SetShaderType(shaderType) {
     this.shaderType = Number(shaderType) || 0;
   }
+
+  /**
+   * Always false - binding the buffer to a device is outside this GPU-free
+   * package.
+   */
   ApplyBuffer() {
     return false;
   }
+
+  /**
+   * Copies up to `size` bytes out of an ArrayBuffer, typed-array view, latin-1
+   * string or array-like into a new zero-padded Uint8Array the caller owns.
+   */
   static copyBytes(data, size) {
     const out = new Uint8Array(size);
     if (data instanceof ArrayBuffer) {

package/dist/shader/support/Tr2ShaderBuffer.js.map

@@ -1 +1 @@
-{"version":3,"file":"Tr2ShaderBuffer.js","sources":["../../../../src/shader/support/Tr2ShaderBuffer.js"],"sourcesContent":["// Ported from CarbonEngine (MIT, (c) 2026 CCP Games) - https://github.com/carbonengine/trinity\n//   trinity/trinity/Shader/Tr2ShaderBuffer.h\n// Generated by format-carbon carbon-class --emit. Verify against shader/Tr2ShaderBuffer.json.\nimport { carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\nimport { CjsModel } from \"@carbonenginejs/runtime-utils/model\";\n\n/** Tr2ShaderBuffer (shader) - generated from schema shapeHash 977c582f.... */\n@type.define({ className: \"Tr2ShaderBuffer\", family: \"shader\" })\nexport class Tr2ShaderBuffer extends CjsModel\n{\n\n  /** m_size (int) [READ] */\n  @io.read\n  @type.int32\n  size = 0;\n\n  data = null;\n\n  shaderType = 1;\n\n  /** Carbon method SetData -> SetDataFromScript (MAP_METHOD_AND_WRAP). */\n  @carbon.method\n  @impl.implemented\n  SetData(data, size = data?.byteLength ?? data?.length ?? 0)\n  {\n    const byteSize = Math.max(0, Number(size) || 0);\n    if (!byteSize)\n    {\n      this.data = null;\n      this.size = 0;\n      return;\n    }\n    this.data = Tr2ShaderBuffer.copyBytes(data, byteSize);\n    this.size = byteSize;\n  }\n\n  SetShaderType(shaderType)\n  {\n    this.shaderType = Number(shaderType) || 0;\n  }\n\n  ApplyBuffer()\n  {\n    return false;\n  }\n\n  static copyBytes(data, size)\n  {\n    const out = new Uint8Array(size);\n    if (data instanceof ArrayBuffer)\n    {\n      out.set(new Uint8Array(data, 0, Math.min(size, data.byteLength)));\n    }\n    else if (ArrayBuffer.isView(data))\n    {\n      out.set(new Uint8Array(data.buffer, data.byteOffset, Math.min(size, data.byteLength)));\n    }\n    else if (typeof data === \"string\")\n    {\n      for (let i = 0; i < Math.min(size, data.length); i++)\n      {\n        out[i] = data.charCodeAt(i) & 0xff;\n      }\n    }\n    else if (data && typeof data.length === \"number\")\n    {\n      out.set(Array.from(data).slice(0, size));\n    }\n    return out;\n  }\n\n}\n"],"names":["_Tr2ShaderBuffer","Tr2ShaderBuffer","CjsModel","e","_init_size","_init_extra_size","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","read","int32","carbon","method","impl","implemented","size","data","shaderType","SetData","byteLength","length","byteSize","Math","max","Number","copyBytes","SetShaderType","ApplyBuffer","out","Uint8Array","ArrayBuffer","set","min","isView","buffer","byteOffset","i","charCodeAt","Array","from","slice"],"mappings":"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"}
+{"version":3,"file":"Tr2ShaderBuffer.js","sources":["../../../../src/shader/support/Tr2ShaderBuffer.js"],"sourcesContent":["// Ported from CarbonEngine (MIT, (c) 2026 CCP Games) - https://github.com/carbonengine/trinity\n//   trinity/trinity/Shader/Tr2ShaderBuffer.h\n// Generated by format-carbon carbon-class --emit. Verify against shader/Tr2ShaderBuffer.json.\nimport { carbon, impl, io, type } from \"@carbonenginejs/runtime-utils/schema\";\nimport { CjsModel } from \"@carbonenginejs/runtime-utils/model\";\n\n/** Tr2ShaderBuffer (shader) - generated from schema shapeHash 977c582f.... */\n@type.define({ className: \"Tr2ShaderBuffer\", family: \"shader\" })\nexport class Tr2ShaderBuffer extends CjsModel\n{\n\n  /** m_size (int) [READ] */\n  @io.read\n  @type.int32\n  size = 0;\n\n  data = null;\n\n  shaderType = 1;\n\n  /** Carbon method SetData -> SetDataFromScript (MAP_METHOD_AND_WRAP). */\n  @carbon.method\n  @impl.implemented\n  SetData(data, size = data?.byteLength ?? data?.length ?? 0)\n  {\n    const byteSize = Math.max(0, Number(size) || 0);\n    if (!byteSize)\n    {\n      this.data = null;\n      this.size = 0;\n      return;\n    }\n    this.data = Tr2ShaderBuffer.copyBytes(data, byteSize);\n    this.size = byteSize;\n  }\n\n  /**\n   * Sets which shader stage this buffer belongs to; a non-numeric value becomes\n   * 0.\n   */\n  SetShaderType(shaderType)\n  {\n    this.shaderType = Number(shaderType) || 0;\n  }\n\n  /**\n   * Always false - binding the buffer to a device is outside this GPU-free\n   * package.\n   */\n  ApplyBuffer()\n  {\n    return false;\n  }\n\n  /**\n   * Copies up to `size` bytes out of an ArrayBuffer, typed-array view, latin-1\n   * string or array-like into a new zero-padded Uint8Array the caller owns.\n   */\n  static copyBytes(data, size)\n  {\n    const out = new Uint8Array(size);\n    if (data instanceof ArrayBuffer)\n    {\n      out.set(new Uint8Array(data, 0, Math.min(size, data.byteLength)));\n    }\n    else if (ArrayBuffer.isView(data))\n    {\n      out.set(new Uint8Array(data.buffer, data.byteOffset, Math.min(size, data.byteLength)));\n    }\n    else if (typeof data === \"string\")\n    {\n      for (let i = 0; i < Math.min(size, data.length); i++)\n      {\n        out[i] = data.charCodeAt(i) & 0xff;\n      }\n    }\n    else if (data && typeof data.length === \"number\")\n    {\n      out.set(Array.from(data).slice(0, size));\n    }\n    return out;\n  }\n\n}\n"],"names":["_Tr2ShaderBuffer","Tr2ShaderBuffer","CjsModel","e","_init_size","_init_extra_size","_initProto","c","_initClass","_applyDecs","type","define","className","family","io","read","int32","carbon","method","impl","implemented","size","data","shaderType","SetData","byteLength","length","byteSize","Math","max","Number","copyBytes","SetShaderType","ApplyBuffer","out","Uint8Array","ArrayBuffer","set","min","isView","buffer","byteOffset","i","charCodeAt","Array","from","slice"],"mappings":"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"}

package/dist/trinityCore/CjsBatchManager.js

@@ -22,6 +22,12 @@ const DEFAULT_BATCH_TYPES = [TriBatchType.TRIBATCHTYPE_OPAQUE, TriBatchType.TRIB
 function fail(message) {
   throw new Error(`CjsBatchManager: ${message}`);
 }
+
+/**
+ * Owns the per-library render-batch producer and collector registry and drives
+ * the GPU-free per-frame flow of realize, build, finalize into one accumulator
+ * per batch type.
+ */
 class CjsBatchManager {
   #producers = new Map();
   #collectors = new Map();
@@ -35,6 +41,12 @@ class CjsBatchManager {
   // producer type names that MUST be registered before Initialize succeeds.
   // createAccumulator: optional (batchType) => accumulator factory forwarded to
   // the TriRenderBatchMap (e.g. an order-preserving accumulator for TRANSPARENT).
+
+  /**
+   * Configures which TriBatchType values are collected, which producer types
+   * Initialize must find registered, and an optional per-batch-type accumulator
+   * factory.
+   */
   constructor({
     batchTypes = DEFAULT_BATCH_TYPES,
     requiredTypes = [],
@@ -49,6 +61,12 @@ class CjsBatchManager {
   // batchMap, perObjectData, reason) emits data batches; Realize(renderable) is
   // the engine's pull-realization (consumes __state.rebuild tokens, fast-exits
   // when current). Registration is closed once Initialize has run.
+
+  /**
+   * Registers producer hooks given as { type, Build, Realize? } entries,
+   * rejecting duplicates and malformed entries; registration closes once
+   * Initialize has run. Returns this for chaining.
+   */
   Register(entries) {
     if (this.#initialized) fail("Register must be called before Initialize");
     if (!Array.isArray(entries)) fail("Register expects an array of { type, Build, Realize? } entries");
@@ -71,6 +89,11 @@ class CjsBatchManager {
   // Registers a scene-global collector (e.g. the quad or instanced-mesh family):
   // Collect(renderables, batchMap, reason) runs once per frame after the
   // per-renderable pass (Carbon precedent: Tr2QuadRenderer, EveInstancedMeshManager).
+
+  /**
+   * Registers a scene-global collector whose Collect runs once per frame after
+   * the per-renderable pass; must also be called before Initialize.
+   */
   RegisterCollector(name, collector) {
     if (this.#initialized) fail("RegisterCollector must be called before Initialize");
     if (typeof name !== "string" || !name) fail("collector requires a non-empty string name");
@@ -82,6 +105,11 @@ class CjsBatchManager {
 
   // Fail-closed gate: throws if a required producer type has no registration.
   // Creates the per-TriBatchType accumulator map and closes the registry.
+
+  /**
+   * Fail-closed gate: throws when any required producer type is unregistered,
+   * then creates the per-batch-type accumulator map and closes the registry.
+   */
   Initialize() {
     if (this.#initialized) fail("Initialize was already called");
     const missing = this.#requiredTypes.filter(type => !this.#producers.has(type));
@@ -92,6 +120,8 @@ class CjsBatchManager {
     this.#initialized = true;
     return this;
   }
+
+  /** Whether Initialize has run and the batch map exists. */
   IsInitialized() {
     return this.#initialized;
   }
@@ -113,6 +143,13 @@ class CjsBatchManager {
   // Scene-global collectors run after; Finalize sorts/group-counts every
   // accumulator. renderContext supplies the relocated view position (Carbon
   // reads a renderer global). Returns the finalized batch map.
+
+  /**
+   * Runs the per-frame CPU collection over pre-culled renderables - realize,
+   * per-renderable build into every non-transparent type, then a back-to-front
+   * transparent pass, then the scene-global collectors - and returns the
+   * finalized batch map.
+   */
   Collect(renderables, reason = Tr2RenderReason.TR2RENDERREASON_NORMAL, renderContext = null) {
     if (!this.#initialized) fail("Collect requires Initialize");
     const TRANSPARENT = TriBatchType.TRIBATCHTYPE_TRANSPARENT;
@@ -122,8 +159,8 @@ class CjsBatchManager {
     // Bind the per-object-data store from the render context (built once from
     // the engine at scene setup). GetPerObjectData Allocs pooled records from
     // it; without a store, an eager-fill renderable throws (setup error).
-    const store = renderContext?.GetRawDataStore?.();
-    if (store) batchMap.SetRawDataStore(store);
+    const store = renderContext?.GetTriPoolAllocator?.();
+    if (store) batchMap.SetTriPoolAllocator(store);
     const collectsTransparent = this.#batchTypes.includes(TRANSPARENT);
     const transparents = [];
     if (renderables) {
@@ -164,12 +201,18 @@ class CjsBatchManager {
     batchMap.Finalize();
     return batchMap;
   }
+
+  /** The batch map created by Initialize, or null before it has run. */
   GetBatchMap() {
     return this.#batchMap;
   }
+
+  /** The accumulator for one batch type, or null when that type is not collected. */
   GetAccumulator(batchType) {
     return this.#batchMap?.GetAccumulator(batchType) ?? null;
   }
+
+  /** A copy of the collected batch-type list. */
   GetBatchTypes() {
     return Array.from(this.#batchTypes);
   }
@@ -177,6 +220,12 @@ class CjsBatchManager {
   // A renderable DECLARES its producer type (method or plain property); it never
   // owns builder code. Returns null when undeclared (duck-typed GetBatches
   // fallback applies).
+
+  /**
+   * Looks up the producer a renderable declares through GetBatchProducerType or
+   * a batchProducerType property; null means the duck-typed GetBatches fallback
+   * applies.
+   */
   #ProducerFor(renderable) {
     const type = renderable.GetBatchProducerType?.() ?? renderable.batchProducerType ?? null;
     return type ? this.#producers.get(type) ?? null : null;
@@ -185,6 +234,11 @@ class CjsBatchManager {
   // True when the object advertises pending scheduled GPU work via the shared
   // __state.rebuild token set (kb section 8). Realizers use this (plus their own
   // per-token checks) to fast-exit when current.
+
+  /**
+   * Whether an object advertises pending scheduled GPU work through its shared
+   * __state.rebuild token set.
+   */
   static HasRebuildWork(object) {
     return (object?.__state?.rebuild?.size ?? 0) > 0;
   }
@@ -195,6 +249,12 @@ class CjsBatchManager {
   // child tokens alongside the owner's - no upward token copying is performed.
   // This helper answers "does the owner or any child advertise work"; the
   // realizer still clears each consumed token where it lives.
+
+  /**
+   * Whether the owner or any listed child advertises rebuild work; child tokens
+   * stay where they live, and the realizer still clears each consumed token
+   * there.
+   */
   static AnyRebuildWork(object, children = null) {
     if (CjsBatchManager.HasRebuildWork(object)) return true;
     if (!children) return false;

package/dist/trinityCore/CjsBatchManager.js.map

@@ -1 +1 @@
-{"version":3,"file":"CjsBatchManager.js","sources":["../../../src/trinityCore/CjsBatchManager.js"],"sourcesContent":["// CarbonEngineJS composition class (no Carbon counterpart) - see\n// .agents/BATCH-PIPELINE-PLAN.md and DECISIONS.md 2026-07-23.\n//\n// Library-level batch orchestrator: one per backend/CjsLibrary, GPU-free. Owns\n// the producer registry ({ type -> { Build, Realize } } plus scene-global\n// collectors) and the neutral per-frame collection flow:\n//\n//   realize-if-stale -> build data batches -> finalize -> expose accumulators\n//\n// The engine registers its concrete hooks at composition time (fail-closed via\n// Initialize). Realizers own GPU state and the staleness policy (they consume\n// __state.rebuild tokens and fast-exit when current); Build hooks emit neutral\n// Tr2RenderBatch DATA into the per-TriBatchType accumulators; dispatch of the\n// finalized accumulators is engine work and never lives here. The manager holds\n// a reference DOWN to the engine hooks - it is not a device member, and no GPU\n// handle ever enters this class.\nimport { TriBatchType } from \"@carbonenginejs/runtime-utils/graphics\";\nimport { Tr2RenderReason } from \"../generated/trinityCore/enums.js\";\nimport { TriRenderBatchMap } from \"./TriRenderBatchMap.js\";\n\nconst DEFAULT_BATCH_TYPES = [\n  TriBatchType.TRIBATCHTYPE_OPAQUE,\n  TriBatchType.TRIBATCHTYPE_DECAL,\n  TriBatchType.TRIBATCHTYPE_TRANSPARENT,\n  TriBatchType.TRIBATCHTYPE_ADDITIVE,\n  TriBatchType.TRIBATCHTYPE_DEPTH\n];\n\nfunction fail(message)\n{\n  throw new Error(`CjsBatchManager: ${message}`);\n}\n\nexport class CjsBatchManager\n{\n  #producers = new Map();\n\n  #collectors = new Map();\n\n  #batchTypes;\n\n  #requiredTypes;\n\n  #createAccumulator;\n\n  #batchMap = null;\n\n  #initialized = false;\n\n  // batchTypes: TriBatchType values collected each frame. requiredTypes:\n  // producer type names that MUST be registered before Initialize succeeds.\n  // createAccumulator: optional (batchType) => accumulator factory forwarded to\n  // the TriRenderBatchMap (e.g. an order-preserving accumulator for TRANSPARENT).\n  constructor({ batchTypes = DEFAULT_BATCH_TYPES, requiredTypes = [], createAccumulator = null } = {})\n  {\n    this.#batchTypes = Array.from(batchTypes);\n    this.#requiredTypes = Array.from(requiredTypes);\n    this.#createAccumulator = createAccumulator;\n  }\n\n  // Registers producer hooks: [{ type, Build, Realize? }]. Build(renderable,\n  // batchMap, perObjectData, reason) emits data batches; Realize(renderable) is\n  // the engine's pull-realization (consumes __state.rebuild tokens, fast-exits\n  // when current). Registration is closed once Initialize has run.\n  Register(entries)\n  {\n    if (this.#initialized) fail(\"Register must be called before Initialize\");\n    if (!Array.isArray(entries)) fail(\"Register expects an array of { type, Build, Realize? } entries\");\n\n    for (const entry of entries)\n    {\n      const type = entry?.type;\n      if (typeof type !== \"string\" || !type) fail(\"producer entry requires a non-empty string type\");\n      if (this.#producers.has(type)) fail(`producer type \"${type}\" is already registered`);\n      if (typeof entry.Build !== \"function\") fail(`producer \"${type}\" requires a Build function`);\n      if (entry.Realize !== undefined && typeof entry.Realize !== \"function\")\n      {\n        fail(`producer \"${type}\" Realize must be a function when provided`);\n      }\n      this.#producers.set(type, { Build: entry.Build, Realize: entry.Realize ?? null });\n    }\n    return this;\n  }\n\n  // Registers a scene-global collector (e.g. the quad or instanced-mesh family):\n  // Collect(renderables, batchMap, reason) runs once per frame after the\n  // per-renderable pass (Carbon precedent: Tr2QuadRenderer, EveInstancedMeshManager).\n  RegisterCollector(name, collector)\n  {\n    if (this.#initialized) fail(\"RegisterCollector must be called before Initialize\");\n    if (typeof name !== \"string\" || !name) fail(\"collector requires a non-empty string name\");\n    if (this.#collectors.has(name)) fail(`collector \"${name}\" is already registered`);\n    if (typeof collector?.Collect !== \"function\") fail(`collector \"${name}\" requires a Collect function`);\n    this.#collectors.set(name, collector);\n    return this;\n  }\n\n  // Fail-closed gate: throws if a required producer type has no registration.\n  // Creates the per-TriBatchType accumulator map and closes the registry.\n  Initialize()\n  {\n    if (this.#initialized) fail(\"Initialize was already called\");\n\n    const missing = this.#requiredTypes.filter(type => !this.#producers.has(type));\n    if (missing.length)\n    {\n      fail(`required producer type(s) not registered: ${missing.join(\", \")}`);\n    }\n\n    this.#batchMap = new TriRenderBatchMap(this.#batchTypes, this.#createAccumulator);\n    this.#initialized = true;\n    return this;\n  }\n\n  IsInitialized()\n  {\n    return this.#initialized;\n  }\n\n  // The neutral per-frame CPU collection. Renderables are expected pre-culled\n  // (visibility is a scene concern). Faithful to Carbon's two-phase flow\n  // (EveSpaceScene.cpp GetBatchesFromRenderables + PrepareTransparentBatch):\n  //\n  // 1. Per renderable: run the engine's Realize hook when its producer\n  //    registered one (the realizer fast-exits when current), obtain per-object\n  //    data once (pool = OPAQUE accumulator), then dispatch the registered Build\n  //    hook or fall back to the duck-typed GetBatches per NON-TRANSPARENT batch\n  //    type. Renderables reporting HasTransparentBatches are gathered with\n  //    their GetSortValue distance.\n  // 2. Transparent pass: sort front-to-back, iterate back-to-front, allocating\n  //    fresh per-object data from the TRANSPARENT accumulator per renderable -\n  //    insertion order IS the draw order (order-preserving accumulator).\n  //\n  // Scene-global collectors run after; Finalize sorts/group-counts every\n  // accumulator. renderContext supplies the relocated view position (Carbon\n  // reads a renderer global). Returns the finalized batch map.\n  Collect(renderables, reason = Tr2RenderReason.TR2RENDERREASON_NORMAL, renderContext = null)\n  {\n    if (!this.#initialized) fail(\"Collect requires Initialize\");\n\n    const TRANSPARENT = TriBatchType.TRIBATCHTYPE_TRANSPARENT;\n    const batchMap = this.#batchMap;\n    batchMap.Clear();\n\n    // Bind the per-object-data store from the render context (built once from\n    // the engine at scene setup). GetPerObjectData Allocs pooled records from\n    // it; without a store, an eager-fill renderable throws (setup error).\n    const store = renderContext?.GetRawDataStore?.();\n    if (store) batchMap.SetRawDataStore(store);\n\n    const collectsTransparent = this.#batchTypes.includes(TRANSPARENT);\n    const transparents = [];\n\n    if (renderables)\n    {\n      const poolAccumulator = batchMap.GetAccumulator(TriBatchType.TRIBATCHTYPE_OPAQUE)\n        ?? batchMap.GetAccumulator(this.#batchTypes[0]);\n\n      for (const renderable of renderables)\n      {\n        if (!renderable) continue;\n\n        const producer = this.#ProducerFor(renderable);\n        if (producer?.Realize) producer.Realize(renderable);\n\n        const perObjectData = renderable.GetPerObjectData?.(poolAccumulator) ?? null;\n\n        if (producer)\n        {\n          producer.Build(renderable, batchMap, perObjectData, reason);\n        }\n        else if (typeof renderable.GetBatches === \"function\")\n        {\n          for (const batchType of this.#batchTypes)\n          {\n            if (batchType === TRANSPARENT) continue;\n            renderable.GetBatches(\n              batchMap.GetAccumulator(batchType), batchType, perObjectData, reason, renderContext);\n          }\n        }\n\n        if (collectsTransparent && renderable.HasTransparentBatches?.())\n        {\n          transparents.push({\n            renderable,\n            distance: renderable.GetSortValue?.(renderContext) ?? 0\n          });\n        }\n      }\n    }\n\n    if (transparents.length)\n    {\n      const transparentAccumulator = batchMap.GetAccumulator(TRANSPARENT);\n      transparents.sort((a, b) => a.distance - b.distance);\n      for (let index = transparents.length - 1; index >= 0; index--)\n      {\n        const renderable = transparents[index].renderable;\n        const perObjectData = renderable.GetPerObjectData?.(transparentAccumulator) ?? null;\n        renderable.GetBatches?.(transparentAccumulator, TRANSPARENT, perObjectData, reason, renderContext);\n      }\n    }\n\n    for (const collector of this.#collectors.values())\n    {\n      collector.Collect(renderables ?? [], batchMap, reason);\n    }\n\n    batchMap.Finalize();\n    return batchMap;\n  }\n\n  GetBatchMap()\n  {\n    return this.#batchMap;\n  }\n\n  GetAccumulator(batchType)\n  {\n    return this.#batchMap?.GetAccumulator(batchType) ?? null;\n  }\n\n  GetBatchTypes()\n  {\n    return Array.from(this.#batchTypes);\n  }\n\n  // A renderable DECLARES its producer type (method or plain property); it never\n  // owns builder code. Returns null when undeclared (duck-typed GetBatches\n  // fallback applies).\n  #ProducerFor(renderable)\n  {\n    const type = renderable.GetBatchProducerType?.() ?? renderable.batchProducerType ?? null;\n    return type ? this.#producers.get(type) ?? null : null;\n  }\n\n  // True when the object advertises pending scheduled GPU work via the shared\n  // __state.rebuild token set (kb section 8). Realizers use this (plus their own\n  // per-token checks) to fast-exit when current.\n  static HasRebuildWork(object)\n  {\n    return (object?.__state?.rebuild?.size ?? 0) > 0;\n  }\n\n  // Owner-propagation convention (BATCH-PIPELINE-PLAN / runtime-trinity\n  // DECORATOR-TODOS): child records (mesh areas, set items, effect children)\n  // carry their OWN declared rebuild tokens, and the OWNING realizer consumes\n  // child tokens alongside the owner's - no upward token copying is performed.\n  // This helper answers \"does the owner or any child advertise work\"; the\n  // realizer still clears each consumed token where it lives.\n  static AnyRebuildWork(object, children = null)\n  {\n    if (CjsBatchManager.HasRebuildWork(object)) return true;\n    if (!children) return false;\n    for (const child of children)\n    {\n      if (CjsBatchManager.HasRebuildWork(child)) return true;\n    }\n    return false;\n  }\n}\n"],"names":["DEFAULT_BATCH_TYPES","TriBatchType","TRIBATCHTYPE_OPAQUE","TRIBATCHTYPE_DECAL","TRIBATCHTYPE_TRANSPARENT","TRIBATCHTYPE_ADDITIVE","TRIBATCHTYPE_DEPTH","fail","message","Error","CjsBatchManager","Map","constructor","batchTypes","requiredTypes","createAccumulator","Array","from","Register","entries","isArray","entry","type","has","Build","Realize","undefined","set","RegisterCollector","name","collector","Collect","Initialize","missing","filter","length","join","TriRenderBatchMap","IsInitialized","renderables","reason","Tr2RenderReason","TR2RENDERREASON_NORMAL","renderContext","TRANSPARENT","batchMap","Clear","store","GetRawDataStore","SetRawDataStore","collectsTransparent","includes","transparents","poolAccumulator","GetAccumulator","renderable","producer","perObjectData","GetPerObjectData","GetBatches","batchType","HasTransparentBatches","push","distance","GetSortValue","transparentAccumulator","sort","a","b","index","values","Finalize","GetBatchMap","GetBatchTypes","#ProducerFor","GetBatchProducerType","batchProducerType","get","HasRebuildWork","object","__state","rebuild","size","AnyRebuildWork","children","child"],"mappings":"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"}
+{"version":3,"file":"CjsBatchManager.js","sources":["../../../src/trinityCore/CjsBatchManager.js"],"sourcesContent":["// CarbonEngineJS composition class (no Carbon counterpart) - see\n// .agents/BATCH-PIPELINE-PLAN.md and DECISIONS.md 2026-07-23.\n//\n// Library-level batch orchestrator: one per backend/CjsLibrary, GPU-free. Owns\n// the producer registry ({ type -> { Build, Realize } } plus scene-global\n// collectors) and the neutral per-frame collection flow:\n//\n//   realize-if-stale -> build data batches -> finalize -> expose accumulators\n//\n// The engine registers its concrete hooks at composition time (fail-closed via\n// Initialize). Realizers own GPU state and the staleness policy (they consume\n// __state.rebuild tokens and fast-exit when current); Build hooks emit neutral\n// Tr2RenderBatch DATA into the per-TriBatchType accumulators; dispatch of the\n// finalized accumulators is engine work and never lives here. The manager holds\n// a reference DOWN to the engine hooks - it is not a device member, and no GPU\n// handle ever enters this class.\nimport { TriBatchType } from \"@carbonenginejs/runtime-utils/graphics\";\nimport { Tr2RenderReason } from \"../generated/trinityCore/enums.js\";\nimport { TriRenderBatchMap } from \"./TriRenderBatchMap.js\";\n\nconst DEFAULT_BATCH_TYPES = [\n  TriBatchType.TRIBATCHTYPE_OPAQUE,\n  TriBatchType.TRIBATCHTYPE_DECAL,\n  TriBatchType.TRIBATCHTYPE_TRANSPARENT,\n  TriBatchType.TRIBATCHTYPE_ADDITIVE,\n  TriBatchType.TRIBATCHTYPE_DEPTH\n];\n\nfunction fail(message)\n{\n  throw new Error(`CjsBatchManager: ${message}`);\n}\n\n/**\n * Owns the per-library render-batch producer and collector registry and drives\n * the GPU-free per-frame flow of realize, build, finalize into one accumulator\n * per batch type.\n */\nexport class CjsBatchManager\n{\n  #producers = new Map();\n\n  #collectors = new Map();\n\n  #batchTypes;\n\n  #requiredTypes;\n\n  #createAccumulator;\n\n  #batchMap = null;\n\n  #initialized = false;\n\n  // batchTypes: TriBatchType values collected each frame. requiredTypes:\n  // producer type names that MUST be registered before Initialize succeeds.\n  // createAccumulator: optional (batchType) => accumulator factory forwarded to\n  // the TriRenderBatchMap (e.g. an order-preserving accumulator for TRANSPARENT).\n\n  /**\n   * Configures which TriBatchType values are collected, which producer types\n   * Initialize must find registered, and an optional per-batch-type accumulator\n   * factory.\n   */\n  constructor({ batchTypes = DEFAULT_BATCH_TYPES, requiredTypes = [], createAccumulator = null } = {})\n  {\n    this.#batchTypes = Array.from(batchTypes);\n    this.#requiredTypes = Array.from(requiredTypes);\n    this.#createAccumulator = createAccumulator;\n  }\n\n  // Registers producer hooks: [{ type, Build, Realize? }]. Build(renderable,\n  // batchMap, perObjectData, reason) emits data batches; Realize(renderable) is\n  // the engine's pull-realization (consumes __state.rebuild tokens, fast-exits\n  // when current). Registration is closed once Initialize has run.\n\n  /**\n   * Registers producer hooks given as { type, Build, Realize? } entries,\n   * rejecting duplicates and malformed entries; registration closes once\n   * Initialize has run. Returns this for chaining.\n   */\n  Register(entries)\n  {\n    if (this.#initialized) fail(\"Register must be called before Initialize\");\n    if (!Array.isArray(entries)) fail(\"Register expects an array of { type, Build, Realize? } entries\");\n\n    for (const entry of entries)\n    {\n      const type = entry?.type;\n      if (typeof type !== \"string\" || !type) fail(\"producer entry requires a non-empty string type\");\n      if (this.#producers.has(type)) fail(`producer type \"${type}\" is already registered`);\n      if (typeof entry.Build !== \"function\") fail(`producer \"${type}\" requires a Build function`);\n      if (entry.Realize !== undefined && typeof entry.Realize !== \"function\")\n      {\n        fail(`producer \"${type}\" Realize must be a function when provided`);\n      }\n      this.#producers.set(type, { Build: entry.Build, Realize: entry.Realize ?? null });\n    }\n    return this;\n  }\n\n  // Registers a scene-global collector (e.g. the quad or instanced-mesh family):\n  // Collect(renderables, batchMap, reason) runs once per frame after the\n  // per-renderable pass (Carbon precedent: Tr2QuadRenderer, EveInstancedMeshManager).\n\n  /**\n   * Registers a scene-global collector whose Collect runs once per frame after\n   * the per-renderable pass; must also be called before Initialize.\n   */\n  RegisterCollector(name, collector)\n  {\n    if (this.#initialized) fail(\"RegisterCollector must be called before Initialize\");\n    if (typeof name !== \"string\" || !name) fail(\"collector requires a non-empty string name\");\n    if (this.#collectors.has(name)) fail(`collector \"${name}\" is already registered`);\n    if (typeof collector?.Collect !== \"function\") fail(`collector \"${name}\" requires a Collect function`);\n    this.#collectors.set(name, collector);\n    return this;\n  }\n\n  // Fail-closed gate: throws if a required producer type has no registration.\n  // Creates the per-TriBatchType accumulator map and closes the registry.\n\n  /**\n   * Fail-closed gate: throws when any required producer type is unregistered,\n   * then creates the per-batch-type accumulator map and closes the registry.\n   */\n  Initialize()\n  {\n    if (this.#initialized) fail(\"Initialize was already called\");\n\n    const missing = this.#requiredTypes.filter(type => !this.#producers.has(type));\n    if (missing.length)\n    {\n      fail(`required producer type(s) not registered: ${missing.join(\", \")}`);\n    }\n\n    this.#batchMap = new TriRenderBatchMap(this.#batchTypes, this.#createAccumulator);\n    this.#initialized = true;\n    return this;\n  }\n\n  /** Whether Initialize has run and the batch map exists. */\n  IsInitialized()\n  {\n    return this.#initialized;\n  }\n\n  // The neutral per-frame CPU collection. Renderables are expected pre-culled\n  // (visibility is a scene concern). Faithful to Carbon's two-phase flow\n  // (EveSpaceScene.cpp GetBatchesFromRenderables + PrepareTransparentBatch):\n  //\n  // 1. Per renderable: run the engine's Realize hook when its producer\n  //    registered one (the realizer fast-exits when current), obtain per-object\n  //    data once (pool = OPAQUE accumulator), then dispatch the registered Build\n  //    hook or fall back to the duck-typed GetBatches per NON-TRANSPARENT batch\n  //    type. Renderables reporting HasTransparentBatches are gathered with\n  //    their GetSortValue distance.\n  // 2. Transparent pass: sort front-to-back, iterate back-to-front, allocating\n  //    fresh per-object data from the TRANSPARENT accumulator per renderable -\n  //    insertion order IS the draw order (order-preserving accumulator).\n  //\n  // Scene-global collectors run after; Finalize sorts/group-counts every\n  // accumulator. renderContext supplies the relocated view position (Carbon\n  // reads a renderer global). Returns the finalized batch map.\n\n  /**\n   * Runs the per-frame CPU collection over pre-culled renderables - realize,\n   * per-renderable build into every non-transparent type, then a back-to-front\n   * transparent pass, then the scene-global collectors - and returns the\n   * finalized batch map.\n   */\n  Collect(renderables, reason = Tr2RenderReason.TR2RENDERREASON_NORMAL, renderContext = null)\n  {\n    if (!this.#initialized) fail(\"Collect requires Initialize\");\n\n    const TRANSPARENT = TriBatchType.TRIBATCHTYPE_TRANSPARENT;\n    const batchMap = this.#batchMap;\n    batchMap.Clear();\n\n    // Bind the per-object-data store from the render context (built once from\n    // the engine at scene setup). GetPerObjectData Allocs pooled records from\n    // it; without a store, an eager-fill renderable throws (setup error).\n    const store = renderContext?.GetTriPoolAllocator?.();\n    if (store) batchMap.SetTriPoolAllocator(store);\n\n    const collectsTransparent = this.#batchTypes.includes(TRANSPARENT);\n    const transparents = [];\n\n    if (renderables)\n    {\n      const poolAccumulator = batchMap.GetAccumulator(TriBatchType.TRIBATCHTYPE_OPAQUE)\n        ?? batchMap.GetAccumulator(this.#batchTypes[0]);\n\n      for (const renderable of renderables)\n      {\n        if (!renderable) continue;\n\n        const producer = this.#ProducerFor(renderable);\n        if (producer?.Realize) producer.Realize(renderable);\n\n        const perObjectData = renderable.GetPerObjectData?.(poolAccumulator) ?? null;\n\n        if (producer)\n        {\n          producer.Build(renderable, batchMap, perObjectData, reason);\n        }\n        else if (typeof renderable.GetBatches === \"function\")\n        {\n          for (const batchType of this.#batchTypes)\n          {\n            if (batchType === TRANSPARENT) continue;\n            renderable.GetBatches(\n              batchMap.GetAccumulator(batchType), batchType, perObjectData, reason, renderContext);\n          }\n        }\n\n        if (collectsTransparent && renderable.HasTransparentBatches?.())\n        {\n          transparents.push({\n            renderable,\n            distance: renderable.GetSortValue?.(renderContext) ?? 0\n          });\n        }\n      }\n    }\n\n    if (transparents.length)\n    {\n      const transparentAccumulator = batchMap.GetAccumulator(TRANSPARENT);\n      transparents.sort((a, b) => a.distance - b.distance);\n      for (let index = transparents.length - 1; index >= 0; index--)\n      {\n        const renderable = transparents[index].renderable;\n        const perObjectData = renderable.GetPerObjectData?.(transparentAccumulator) ?? null;\n        renderable.GetBatches?.(transparentAccumulator, TRANSPARENT, perObjectData, reason, renderContext);\n      }\n    }\n\n    for (const collector of this.#collectors.values())\n    {\n      collector.Collect(renderables ?? [], batchMap, reason);\n    }\n\n    batchMap.Finalize();\n    return batchMap;\n  }\n\n  /** The batch map created by Initialize, or null before it has run. */\n  GetBatchMap()\n  {\n    return this.#batchMap;\n  }\n\n  /** The accumulator for one batch type, or null when that type is not collected. */\n  GetAccumulator(batchType)\n  {\n    return this.#batchMap?.GetAccumulator(batchType) ?? null;\n  }\n\n  /** A copy of the collected batch-type list. */\n  GetBatchTypes()\n  {\n    return Array.from(this.#batchTypes);\n  }\n\n  // A renderable DECLARES its producer type (method or plain property); it never\n  // owns builder code. Returns null when undeclared (duck-typed GetBatches\n  // fallback applies).\n\n  /**\n   * Looks up the producer a renderable declares through GetBatchProducerType or\n   * a batchProducerType property; null means the duck-typed GetBatches fallback\n   * applies.\n   */\n  #ProducerFor(renderable)\n  {\n    const type = renderable.GetBatchProducerType?.() ?? renderable.batchProducerType ?? null;\n    return type ? this.#producers.get(type) ?? null : null;\n  }\n\n  // True when the object advertises pending scheduled GPU work via the shared\n  // __state.rebuild token set (kb section 8). Realizers use this (plus their own\n  // per-token checks) to fast-exit when current.\n\n  /**\n   * Whether an object advertises pending scheduled GPU work through its shared\n   * __state.rebuild token set.\n   */\n  static HasRebuildWork(object)\n  {\n    return (object?.__state?.rebuild?.size ?? 0) > 0;\n  }\n\n  // Owner-propagation convention (BATCH-PIPELINE-PLAN / runtime-trinity\n  // DECORATOR-TODOS): child records (mesh areas, set items, effect children)\n  // carry their OWN declared rebuild tokens, and the OWNING realizer consumes\n  // child tokens alongside the owner's - no upward token copying is performed.\n  // This helper answers \"does the owner or any child advertise work\"; the\n  // realizer still clears each consumed token where it lives.\n\n  /**\n   * Whether the owner or any listed child advertises rebuild work; child tokens\n   * stay where they live, and the realizer still clears each consumed token\n   * there.\n   */\n  static AnyRebuildWork(object, children = null)\n  {\n    if (CjsBatchManager.HasRebuildWork(object)) return true;\n    if (!children) return false;\n    for (const child of children)\n    {\n      if (CjsBatchManager.HasRebuildWork(child)) return true;\n    }\n    return false;\n  }\n}\n"],"names":["DEFAULT_BATCH_TYPES","TriBatchType","TRIBATCHTYPE_OPAQUE","TRIBATCHTYPE_DECAL","TRIBATCHTYPE_TRANSPARENT","TRIBATCHTYPE_ADDITIVE","TRIBATCHTYPE_DEPTH","fail","message","Error","CjsBatchManager","Map","constructor","batchTypes","requiredTypes","createAccumulator","Array","from","Register","entries","isArray","entry","type","has","Build","Realize","undefined","set","RegisterCollector","name","collector","Collect","Initialize","missing","filter","length","join","TriRenderBatchMap","IsInitialized","renderables","reason","Tr2RenderReason","TR2RENDERREASON_NORMAL","renderContext","TRANSPARENT","batchMap","Clear","store","GetTriPoolAllocator","SetTriPoolAllocator","collectsTransparent","includes","transparents","poolAccumulator","GetAccumulator","renderable","producer","perObjectData","GetPerObjectData","GetBatches","batchType","HasTransparentBatches","push","distance","GetSortValue","transparentAccumulator","sort","a","b","index","values","Finalize","GetBatchMap","GetBatchTypes","#ProducerFor","GetBatchProducerType","batchProducerType","get","HasRebuildWork","object","__state","rebuild","size","AnyRebuildWork","children","child"],"mappings":"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"}

package/dist/trinityCore/GrannyBoneOffset.js

@@ -6,6 +6,11 @@ import { CjsModel } from '@carbonenginejs/runtime-utils/model';
 import { carbon, impl, type } from '@carbonenginejs/runtime-utils/schema';
 
 let _initProto, _initClass;
+
+/**
+ * Per-bone rotation and translation offsets layered on top of an animated rig,
+ * keyed by bone name until bound into the rig's joint order.
+ */
 let _GrannyBoneOffset;
 class GrannyBoneOffset extends CjsModel {
   static {
@@ -19,28 +24,55 @@ class GrannyBoneOffset extends CjsModel {
   }
   #transforms = (_initProto(this), new Map());
   #riggedTransforms = [];
+
+  /** Nothing to prepare; always succeeds. */
   Initialize() {
     return true;
   }
+
+  /** Whether any bone offset has been set. */
   HaveTransforms() {
     return this.#transforms.size !== 0;
   }
+
+  /**
+   * True when offsets exist but the cached rig binding does not cover the given
+   * bone count, so BindToRig must run again.
+   */
   NeedRebind(numBones) {
     return this.HaveTransforms() && this.#riggedTransforms.length !== numBones;
   }
+
+  /**
+   * Drops the joint-order cache, forcing the next BindToRig to rebuild it; the
+   * named offsets are kept.
+   */
   ClearRigBindings() {
     this.#riggedTransforms.length = 0;
   }
+
+  /** Drops every named bone offset along with the rig binding. */
   ClearTransforms() {
     this.#transforms.clear();
     this.ClearRigBindings();
   }
+
+  /**
+   * Replaces a bone's offset with one built from the quaternion components,
+   * discarding any translation previously set for that bone, and invalidates the
+   * rig binding.
+   */
   SetRotation(bone, r, i, j, k) {
     if (!bone) return;
     const transform = mat4.fromQuat(mat4.create(), quat.fromValues(r, i, j, k));
     this.#transforms.set(String(bone), transform);
     this.ClearRigBindings();
   }
+
+  /**
+   * Sets a bone's offset translation in place, keeping any rotation already
+   * stored for it, and invalidates the rig binding.
+   */
   SetOffset(bone, x, y, z) {
     if (!bone) return;
     const key = String(bone);
@@ -51,12 +83,25 @@ class GrannyBoneOffset extends CjsModel {
     this.#transforms.set(key, transform);
     this.ClearRigBindings();
   }
+
+  /**
+   * Caches the named offsets in the rig's bone order so Apply can index them by
+   * joint; bones with no offset get a null slot.
+   */
   BindToRig(bones, numBones = bones?.length ?? 0) {
     if (!bones || !numBones) return;
     this.#riggedTransforms = Array.from({
       length: numBones
     }, (_, index) => this.#transforms.get(String(bones[index])) ?? null);
   }
+
+  /**
+   * Composes the joint's offset into its bone transform and multiplies by the
+   * parent, writing the result into out; returns false when that joint has no
+   * offset. Carbon's row-vector `(offset * bone) * parent` becomes `parent *
+   * (bone * offset)` here, and the translation is added component-wise rather
+   * than transformed.
+   */
   Apply(out, joint, boneMatrix, parentMatrix) {
     const offset = this.#riggedTransforms[joint];
     if (!offset) return false;
@@ -71,6 +116,12 @@ class GrannyBoneOffset extends CjsModel {
     mat4.multiply(out, parentMatrix, local);
     return true;
   }
+
+  /**
+   * Applies the joint's offset to a local rotation and position in place -
+   * offset rotation composed first, translation added - and returns false when
+   * that joint has no offset.
+   */
   ApplyToLocal(joint, rotation, position) {
     const offset = this.#riggedTransforms[joint];
     if (!offset) return false;

package/dist/trinityCore/GrannyBoneOffset.js.map

@@ -1 +1 @@
-{"version":3,"file":"GrannyBoneOffset.js","sources":["../../../src/trinityCore/GrannyBoneOffset.js"],"sourcesContent":["// Ported/adapted from CarbonEngine (MIT, (c) 2026 CCP Games) - https://github.com/carbonengine/trinity\n//   trinity/trinity/GrannyBoneOffset.h\n//   trinity/trinity/GrannyBoneOffset.cpp\nimport { mat4 } from \"@carbonenginejs/runtime-utils/mat4\";\nimport { quat } from \"@carbonenginejs/runtime-utils/quat\";\nimport { vec3 } from \"@carbonenginejs/runtime-utils/vec3\";\nimport { CjsModel } from \"@carbonenginejs/runtime-utils/model\";\nimport { carbon, impl, type } from \"@carbonenginejs/runtime-utils/schema\";\n\n\n@type.define({ className: \"GrannyBoneOffset\", family: \"trinityCore\" })\nexport class GrannyBoneOffset extends CjsModel\n{\n  #transforms = new Map();\n  #riggedTransforms = [];\n\n  Initialize()\n  {\n    return true;\n  }\n\n  HaveTransforms()\n  {\n    return this.#transforms.size !== 0;\n  }\n\n  NeedRebind(numBones)\n  {\n    return this.HaveTransforms() && this.#riggedTransforms.length !== numBones;\n  }\n\n  ClearRigBindings()\n  {\n    this.#riggedTransforms.length = 0;\n  }\n\n  @carbon.method\n  @impl.implemented\n  ClearTransforms()\n  {\n    this.#transforms.clear();\n    this.ClearRigBindings();\n  }\n\n  @carbon.method\n  @impl.adapted\n  SetRotation(bone, r, i, j, k)\n  {\n    if (!bone) return;\n    const transform = mat4.fromQuat(mat4.create(), quat.fromValues(r, i, j, k));\n    this.#transforms.set(String(bone), transform);\n    this.ClearRigBindings();\n  }\n\n  @carbon.method\n  @impl.implemented\n  SetOffset(bone, x, y, z)\n  {\n    if (!bone) return;\n    const key = String(bone);\n    const transform = this.#transforms.get(key) ?? mat4.create();\n    transform[12] = x;\n    transform[13] = y;\n    transform[14] = z;\n    this.#transforms.set(key, transform);\n    this.ClearRigBindings();\n  }\n\n  BindToRig(bones, numBones = bones?.length ?? 0)\n  {\n    if (!bones || !numBones) return;\n    this.#riggedTransforms = Array.from({ length: numBones }, (_, index) =>\n      this.#transforms.get(String(bones[index])) ?? null);\n  }\n\n  Apply(out, joint, boneMatrix, parentMatrix)\n  {\n    const offset = this.#riggedTransforms[joint];\n    if (!offset) return false;\n\n    // Carbon stores row-major matrices. Runtime matrices are column-major, so\n    // Carbon's `(offset * bone) * parent` becomes `parent * (bone * offset)`.\n    const local = mat4.multiply(mat4.create(), boneMatrix, offset);\n    local[12] = boneMatrix[12] + offset[12];\n    local[13] = boneMatrix[13] + offset[13];\n    local[14] = boneMatrix[14] + offset[14];\n    local[15] = 1;\n    mat4.multiply(out, parentMatrix, local);\n    return true;\n  }\n\n  ApplyToLocal(joint, rotation, position)\n  {\n    const offset = this.#riggedTransforms[joint];\n    if (!offset) return false;\n    const offsetRotation = mat4.getRotation(quat.create(), offset);\n    // Carbon (row-vector): rotation = offsetRotation * rotation - offset first.\n    quat.multiply(rotation, rotation, offsetRotation);\n    vec3.add(position, position, mat4.getTranslation(vec3.create(), offset));\n    return true;\n  }\n}\n"],"names":["_GrannyBoneOffset","GrannyBoneOffset","CjsModel","e","_initProto","c","_initClass","_applyDecs","type","define","className","family","carbon","method","impl","implemented","adapted","Map","Initialize","HaveTransforms","size","NeedRebind","numBones","length","ClearRigBindings","ClearTransforms","clear","SetRotation","bone","r","i","j","k","transform","mat4","fromQuat","create","quat","fromValues","set","String","SetOffset","x","y","z","key","get","BindToRig","bones","Array","from","_","index","Apply","out","joint","boneMatrix","parentMatrix","offset","local","multiply","ApplyToLocal","rotation","position","offsetRotation","getRotation","vec3","add","getTranslation"],"mappings":";;;;;;;;AAO0E,IAAAA;AAG1E,MAAAC,gBAAA,SACsCC,QAAQ,CAC9C;AAAA,EAAA;AAAA,IAAA,CAAA;AAAAC,MAAAA,CAAA,GAAAC,UAAA,CAAA;MAAAC,CAAA,EAAA,CAAAL,iBAAA,EAAAM,UAAA;AAAA,KAAA,GAAAC,cAAA,CAAA,IAAA,EAAA,CAFCC,IAAI,CAACC,MAAM,CAAC;AAAEC,MAAAA,SAAS,EAAE,kBAAkB;AAAEC,MAAAA,MAAM,EAAE;AAAc,KAAC,CAAC,CAAA,EAAA,CAAA,CAAA,CA0BnEC,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,WAAW,6BAOhBH,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACE,OAAO,CAAA,EAAA,EAAA,EAAA,aAAA,CAAA,EAAA,CAAA,CASZJ,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,WAAW,iCA5CmBb,QAAQ,CAAA;AAAA;AAE5C,EAAA,WAAW,IAAAE,UAAA,QAAG,IAAIa,GAAG,EAAE;EACvB,iBAAiB,GAAG,EAAE;AAEtBC,EAAAA,UAAUA,GACV;AACE,IAAA,OAAO,IAAI;AACb,EAAA;AAEAC,EAAAA,cAAcA,GACd;AACE,IAAA,OAAO,IAAI,CAAC,WAAW,CAACC,IAAI,KAAK,CAAC;AACpC,EAAA;EAEAC,UAAUA,CAACC,QAAQ,EACnB;AACE,IAAA,OAAO,IAAI,CAACH,cAAc,EAAE,IAAI,IAAI,CAAC,iBAAiB,CAACI,MAAM,KAAKD,QAAQ;AAC5E,EAAA;AAEAE,EAAAA,gBAAgBA,GAChB;AACE,IAAA,IAAI,CAAC,iBAAiB,CAACD,MAAM,GAAG,CAAC;AACnC,EAAA;AAIAE,EAAAA,eAAeA,GACf;AACE,IAAA,IAAI,CAAC,WAAW,CAACC,KAAK,EAAE;IACxB,IAAI,CAACF,gBAAgB,EAAE;AACzB,EAAA;EAIAG,WAAWA,CAACC,IAAI,EAAEC,CAAC,EAAEC,CAAC,EAAEC,CAAC,EAAEC,CAAC,EAC5B;IACE,IAAI,CAACJ,IAAI,EAAE;IACX,MAAMK,SAAS,GAAGC,IAAI,CAACC,QAAQ,CAACD,IAAI,CAACE,MAAM,EAAE,EAAEC,IAAI,CAACC,UAAU,CAACT,CAAC,EAAEC,CAAC,EAAEC,CAAC,EAAEC,CAAC,CAAC,CAAC;AAC3E,IAAA,IAAI,CAAC,WAAW,CAACO,GAAG,CAACC,MAAM,CAACZ,IAAI,CAAC,EAAEK,SAAS,CAAC;IAC7C,IAAI,CAACT,gBAAgB,EAAE;AACzB,EAAA;EAIAiB,SAASA,CAACb,IAAI,EAAEc,CAAC,EAAEC,CAAC,EAAEC,CAAC,EACvB;IACE,IAAI,CAAChB,IAAI,EAAE;AACX,IAAA,MAAMiB,GAAG,GAAGL,MAAM,CAACZ,IAAI,CAAC;AACxB,IAAA,MAAMK,SAAS,GAAG,IAAI,CAAC,WAAW,CAACa,GAAG,CAACD,GAAG,CAAC,IAAIX,IAAI,CAACE,MAAM,EAAE;AAC5DH,IAAAA,SAAS,CAAC,EAAE,CAAC,GAAGS,CAAC;AACjBT,IAAAA,SAAS,CAAC,EAAE,CAAC,GAAGU,CAAC;AACjBV,IAAAA,SAAS,CAAC,EAAE,CAAC,GAAGW,CAAC;IACjB,IAAI,CAAC,WAAW,CAACL,GAAG,CAACM,GAAG,EAAEZ,SAAS,CAAC;IACpC,IAAI,CAACT,gBAAgB,EAAE;AACzB,EAAA;EAEAuB,SAASA,CAACC,KAAK,EAAE1B,QAAQ,GAAG0B,KAAK,EAAEzB,MAAM,IAAI,CAAC,EAC9C;AACE,IAAA,IAAI,CAACyB,KAAK,IAAI,CAAC1B,QAAQ,EAAE;AACzB,IAAA,IAAI,CAAC,iBAAiB,GAAG2B,KAAK,CAACC,IAAI,CAAC;AAAE3B,MAAAA,MAAM,EAAED;KAAU,EAAE,CAAC6B,CAAC,EAAEC,KAAK,KACjE,IAAI,CAAC,WAAW,CAACN,GAAG,CAACN,MAAM,CAACQ,KAAK,CAACI,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;AACvD,EAAA;EAEAC,KAAKA,CAACC,GAAG,EAAEC,KAAK,EAAEC,UAAU,EAAEC,YAAY,EAC1C;IACE,MAAMC,MAAM,GAAG,IAAI,CAAC,iBAAiB,CAACH,KAAK,CAAC;AAC5C,IAAA,IAAI,CAACG,MAAM,EAAE,OAAO,KAAK;;AAEzB;AACA;AACA,IAAA,MAAMC,KAAK,GAAGzB,IAAI,CAAC0B,QAAQ,CAAC1B,IAAI,CAACE,MAAM,EAAE,EAAEoB,UAAU,EAAEE,MAAM,CAAC;AAC9DC,IAAAA,KAAK,CAAC,EAAE,CAAC,GAAGH,UAAU,CAAC,EAAE,CAAC,GAAGE,MAAM,CAAC,EAAE,CAAC;AACvCC,IAAAA,KAAK,CAAC,EAAE,CAAC,GAAGH,UAAU,CAAC,EAAE,CAAC,GAAGE,MAAM,CAAC,EAAE,CAAC;AACvCC,IAAAA,KAAK,CAAC,EAAE,CAAC,GAAGH,UAAU,CAAC,EAAE,CAAC,GAAGE,MAAM,CAAC,EAAE,CAAC;AACvCC,IAAAA,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC;IACbzB,IAAI,CAAC0B,QAAQ,CAACN,GAAG,EAAEG,YAAY,EAAEE,KAAK,CAAC;AACvC,IAAA,OAAO,IAAI;AACb,EAAA;AAEAE,EAAAA,YAAYA,CAACN,KAAK,EAAEO,QAAQ,EAAEC,QAAQ,EACtC;IACE,MAAML,MAAM,GAAG,IAAI,CAAC,iBAAiB,CAACH,KAAK,CAAC;AAC5C,IAAA,IAAI,CAACG,MAAM,EAAE,OAAO,KAAK;AACzB,IAAA,MAAMM,cAAc,GAAG9B,IAAI,CAAC+B,WAAW,CAAC5B,IAAI,CAACD,MAAM,EAAE,EAAEsB,MAAM,CAAC;AAC9D;IACArB,IAAI,CAACuB,QAAQ,CAACE,QAAQ,EAAEA,QAAQ,EAAEE,cAAc,CAAC;AACjDE,IAAAA,IAAI,CAACC,GAAG,CAACJ,QAAQ,EAAEA,QAAQ,EAAE7B,IAAI,CAACkC,cAAc,CAACF,IAAI,CAAC9B,MAAM,EAAE,EAAEsB,MAAM,CAAC,CAAC;AACxE,IAAA,OAAO,IAAI;AACb,EAAA;AAAC,EAAA;IAAApD,UAAA,EAAA;AAAA;AACH;;;;"}
+{"version":3,"file":"GrannyBoneOffset.js","sources":["../../../src/trinityCore/GrannyBoneOffset.js"],"sourcesContent":["// Ported/adapted from CarbonEngine (MIT, (c) 2026 CCP Games) - https://github.com/carbonengine/trinity\n//   trinity/trinity/GrannyBoneOffset.h\n//   trinity/trinity/GrannyBoneOffset.cpp\nimport { mat4 } from \"@carbonenginejs/runtime-utils/mat4\";\nimport { quat } from \"@carbonenginejs/runtime-utils/quat\";\nimport { vec3 } from \"@carbonenginejs/runtime-utils/vec3\";\nimport { CjsModel } from \"@carbonenginejs/runtime-utils/model\";\nimport { carbon, impl, type } from \"@carbonenginejs/runtime-utils/schema\";\n\n\n/**\n * Per-bone rotation and translation offsets layered on top of an animated rig,\n * keyed by bone name until bound into the rig's joint order.\n */\n@type.define({ className: \"GrannyBoneOffset\", family: \"trinityCore\" })\nexport class GrannyBoneOffset extends CjsModel\n{\n  #transforms = new Map();\n  #riggedTransforms = [];\n\n  /** Nothing to prepare; always succeeds. */\n  Initialize()\n  {\n    return true;\n  }\n\n  /** Whether any bone offset has been set. */\n  HaveTransforms()\n  {\n    return this.#transforms.size !== 0;\n  }\n\n  /**\n   * True when offsets exist but the cached rig binding does not cover the given\n   * bone count, so BindToRig must run again.\n   */\n  NeedRebind(numBones)\n  {\n    return this.HaveTransforms() && this.#riggedTransforms.length !== numBones;\n  }\n\n  /**\n   * Drops the joint-order cache, forcing the next BindToRig to rebuild it; the\n   * named offsets are kept.\n   */\n  ClearRigBindings()\n  {\n    this.#riggedTransforms.length = 0;\n  }\n\n  /** Drops every named bone offset along with the rig binding. */\n  @carbon.method\n  @impl.implemented\n  ClearTransforms()\n  {\n    this.#transforms.clear();\n    this.ClearRigBindings();\n  }\n\n  /**\n   * Replaces a bone's offset with one built from the quaternion components,\n   * discarding any translation previously set for that bone, and invalidates the\n   * rig binding.\n   */\n  @carbon.method\n  @impl.adapted\n  SetRotation(bone, r, i, j, k)\n  {\n    if (!bone) return;\n    const transform = mat4.fromQuat(mat4.create(), quat.fromValues(r, i, j, k));\n    this.#transforms.set(String(bone), transform);\n    this.ClearRigBindings();\n  }\n\n  /**\n   * Sets a bone's offset translation in place, keeping any rotation already\n   * stored for it, and invalidates the rig binding.\n   */\n  @carbon.method\n  @impl.implemented\n  SetOffset(bone, x, y, z)\n  {\n    if (!bone) return;\n    const key = String(bone);\n    const transform = this.#transforms.get(key) ?? mat4.create();\n    transform[12] = x;\n    transform[13] = y;\n    transform[14] = z;\n    this.#transforms.set(key, transform);\n    this.ClearRigBindings();\n  }\n\n  /**\n   * Caches the named offsets in the rig's bone order so Apply can index them by\n   * joint; bones with no offset get a null slot.\n   */\n  BindToRig(bones, numBones = bones?.length ?? 0)\n  {\n    if (!bones || !numBones) return;\n    this.#riggedTransforms = Array.from({ length: numBones }, (_, index) =>\n      this.#transforms.get(String(bones[index])) ?? null);\n  }\n\n  /**\n   * Composes the joint's offset into its bone transform and multiplies by the\n   * parent, writing the result into out; returns false when that joint has no\n   * offset. Carbon's row-vector `(offset * bone) * parent` becomes `parent *\n   * (bone * offset)` here, and the translation is added component-wise rather\n   * than transformed.\n   */\n  Apply(out, joint, boneMatrix, parentMatrix)\n  {\n    const offset = this.#riggedTransforms[joint];\n    if (!offset) return false;\n\n    // Carbon stores row-major matrices. Runtime matrices are column-major, so\n    // Carbon's `(offset * bone) * parent` becomes `parent * (bone * offset)`.\n    const local = mat4.multiply(mat4.create(), boneMatrix, offset);\n    local[12] = boneMatrix[12] + offset[12];\n    local[13] = boneMatrix[13] + offset[13];\n    local[14] = boneMatrix[14] + offset[14];\n    local[15] = 1;\n    mat4.multiply(out, parentMatrix, local);\n    return true;\n  }\n\n  /**\n   * Applies the joint's offset to a local rotation and position in place -\n   * offset rotation composed first, translation added - and returns false when\n   * that joint has no offset.\n   */\n  ApplyToLocal(joint, rotation, position)\n  {\n    const offset = this.#riggedTransforms[joint];\n    if (!offset) return false;\n    const offsetRotation = mat4.getRotation(quat.create(), offset);\n    // Carbon (row-vector): rotation = offsetRotation * rotation - offset first.\n    quat.multiply(rotation, rotation, offsetRotation);\n    vec3.add(position, position, mat4.getTranslation(vec3.create(), offset));\n    return true;\n  }\n}\n"],"names":["_GrannyBoneOffset","GrannyBoneOffset","CjsModel","e","_initProto","c","_initClass","_applyDecs","type","define","className","family","carbon","method","impl","implemented","adapted","Map","Initialize","HaveTransforms","size","NeedRebind","numBones","length","ClearRigBindings","ClearTransforms","clear","SetRotation","bone","r","i","j","k","transform","mat4","fromQuat","create","quat","fromValues","set","String","SetOffset","x","y","z","key","get","BindToRig","bones","Array","from","_","index","Apply","out","joint","boneMatrix","parentMatrix","offset","local","multiply","ApplyToLocal","rotation","position","offsetRotation","getRotation","vec3","add","getTranslation"],"mappings":"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"}