@carbonenginejs/runtime 0.1.0-alpha.0 → 0.1.0-alpha.1

package/dist/trinity/core/Tr2Renderer.js

@@ -1,5 +1,7 @@
 import { identity as _identity, applyDecs2311 as _applyDecs2311 } from '../../_virtual/_rollupPluginBabelHelpers.js';
 import { carbon, impl, type } from '#schema';
+import { Tr2Blitter } from './Tr2Blitter.js';
+import { AdjustTextureCoordsToViewport } from './Tr2RenderUtils.js';
 
 let _initProto, _initClass;
 
@@ -56,7 +58,7 @@ new class extends _identity {
       } = _applyDecs2311(this, [type.define({
         className: "Tr2Renderer",
         family: "trinityCore"
-      })], [[[carbon, carbon.method, impl, impl.implemented], 18, "GetPerFrameVSStartRegister"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetPerFramePSStartRegister"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetPerObjectVSStartRegister"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetPerObjectPSStartRegister"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetPerObjectRTVertexBufferDataRegister"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetPerObjectVSGUIStartRegister"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetPerObjectStartRegister"]]));
+      })], [[[carbon, carbon.method, impl, impl.implemented], 18, "GetPerFrameVSStartRegister"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetPerFramePSStartRegister"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetPerObjectVSStartRegister"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetPerObjectPSStartRegister"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetPerObjectRTVertexBufferDataRegister"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetPerObjectVSGUIStartRegister"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetPerObjectStartRegister"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Carbon also allocates the quad vertex and index buffers and the debug line set here; only the blitter is ported.")], 18, "PrepareDeviceResources"], [[carbon, carbon.method, impl, impl.implemented], 18, "DrawScreenQuad"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Carbon distinguishes this from the material form by overload; JavaScript has none, so the rectangle form carries its own name.")], 18, "DrawScreenQuadRect"], [[carbon, carbon.method, impl, impl.implemented], 18, "DrawCameraSpaceScreenQuad"], [[carbon, carbon.method, impl, impl.implemented], 18, "DrawFullScreenWithShader"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Carbon's four overloads differ only in an optional material and optional coordinates, which are defaults here.")], 18, "DrawTexture"]]));
     }
     // Carbon's header calls these the defaults "for the currently set shader
     // model" and they are mutable statics, but nothing ever reassigns them, so
@@ -149,6 +151,149 @@ new class extends _identity {
       return shaderType === _Tr2Renderer.PIXEL_SHADER ? this.GetPerObjectPSStartRegister() : this.GetPerObjectVSStartRegister();
     }
 
+    /**
+     * Carbon's `s_blitter`: the blitter every screen-space draw runs through.
+     *
+     * An INSTANCE field rather than Carbon's module global, for the reason this
+     * whole class is an instance - a second library instance must not silently
+     * share the first one's blitter. Created by `PrepareDeviceResources`, and
+     * null until then, which is why every draw below guards on it exactly as
+     * Carbon's `if( s_blitter )` does.
+     */
+    #blitter = null;
+
+    /**
+     * Creates the device-dependent resources, the blitter among them.
+     *
+     * Carbon `PrepareDeviceResources` (`Tr2Renderer.cpp:1273-1281`), which makes
+     * the blitter HERE rather than at startup and says why: it loads an effect,
+     * so the device has to exist and the shader model has to be settled first.
+     * That holds for us too - there is always a device by this point, the stub
+     * backend included, which is a real device and not an absence.
+     *
+     * Carbon also allocates its quad vertex and index buffers and its debug line
+     * set here. Those are not ported; this creates the blitter only.
+     *
+     * @param {object} [renderContext] The context to prepare the blitter against.
+     * @returns {Tr2Blitter} The renderer's blitter.
+     */
+    PrepareDeviceResources(renderContext = null) {
+      this.#blitter ??= new Tr2Blitter();
+      if (renderContext) this.#blitter.PrepareResources(renderContext);
+      return this.#blitter;
+    }
+
+    /**
+     * Returns the blitter, or null before `PrepareDeviceResources` has run.
+     *
+     * @returns {Tr2Blitter|null} The renderer's blitter.
+     */
+    GetBlitter() {
+      return this.#blitter;
+    }
+
+    /**
+     * Draws a fullscreen quad with a material.
+     *
+     * Carbon `DrawScreenQuad( renderContext, Tr2Material* )`
+     * (`Tr2Renderer.cpp:1006-1012`).
+     *
+     * TEXTURE COORDINATES ARE NOT VIEWPORT-CORRECTED HERE, and that is Carbon's
+     * behaviour rather than an omission: only the `DrawTexture` family adjusts
+     * them. `AdjustTextureCoordsToViewport` records what the correction is and
+     * why folding it into the blitter would move every screen-quad draw.
+     *
+     * @param {object} renderContext The context to draw through.
+     * @param {object} material The material to draw with.
+     * @returns {boolean} Whether the quad was drawn.
+     */
+    DrawScreenQuad(renderContext, material) {
+      if (!this.#blitter) return false;
+      return this.#blitter.Draw(renderContext, material);
+    }
+
+    /**
+     * Draws a quad with an effect over an explicit screen rectangle.
+     *
+     * Carbon `DrawScreenQuad( renderContext, Tr2Effect*, topLeft, bottomRight )`
+     * (`Tr2Renderer.cpp:1014-1020`), which passes the full [0,1] TEXTURE range and
+     * the caller's corners as the VERTEX rectangle. Carbon distinguishes the two
+     * by overload; JavaScript has no overloads, so the rectangle form is named.
+     *
+     * @param {object} renderContext The context to draw through.
+     * @param {object} effect The effect to draw with.
+     * @param {Array<number>} topLeft Top-left vertex corner.
+     * @param {Array<number>} bottomRight Bottom-right vertex corner.
+     * @returns {boolean} Whether the quad was drawn.
+     */
+    DrawScreenQuadRect(renderContext, effect, topLeft, bottomRight) {
+      if (!this.#blitter) return false;
+      return this.#blitter.Draw(renderContext, effect, null, {
+        tlTexCoord: [0, 0],
+        brTexCoord: [1, 1],
+        tlVertexCoord: topLeft,
+        brVertexCoord: bottomRight
+      });
+    }
+
+    /**
+     * Draws the quad in camera space rather than screen space.
+     *
+     * Carbon `DrawCameraSpaceScreenQuad` (`Tr2Renderer.cpp:1022-1028`).
+     *
+     * @param {object} renderContext The context to draw through.
+     * @param {object} shader The shader state interface to run.
+     * @param {object} material The material supplying its parameters.
+     * @returns {boolean} Whether the quad was drawn.
+     */
+    DrawCameraSpaceScreenQuad(renderContext, shader, material) {
+      if (!this.#blitter) return false;
+      return this.#blitter.DrawInCameraSpace(renderContext, shader, material);
+    }
+
+    /**
+     * Draws a unit quad with the given material and no texture.
+     *
+     * Carbon `DrawFullScreenWithShader` (`Tr2Renderer.cpp:768-775`).
+     *
+     * @param {object} renderContext The context to draw through.
+     * @param {object} material The material to draw with.
+     * @returns {boolean} Whether the quad was drawn.
+     */
+    DrawFullScreenWithShader(renderContext, material) {
+      if (!this.#blitter) return false;
+      return this.#blitter.Draw(renderContext, material);
+    }
+
+    /**
+     * Blits a texture, correcting its coordinates for the device viewport.
+     *
+     * Carbon's four `DrawTexture` overloads (`Tr2Renderer.cpp:750-834`) collapse
+     * into one: the material is optional, and without one the filter selects a
+     * built-in blit effect. THIS family adjusts the texture coordinates where
+     * `DrawScreenQuad` does not - Carbon draws that distinction and it is load
+     * bearing.
+     *
+     * @param {object} renderContext The context to draw through.
+     * @param {object} texture The texture to blit.
+     * @param {object} [options] `material`, `tlTexCoord`, `brTexCoord`, `filter`.
+     * @returns {boolean} Whether the quad was drawn.
+     */
+    DrawTexture(renderContext, texture, options = {}) {
+      if (!this.#blitter) return false;
+      const {
+        tlTexCoord,
+        brTexCoord
+      } = AdjustTextureCoordsToViewport(renderContext, options.tlTexCoord ?? [0, 0], options.brTexCoord ?? [1, 1]);
+      return options.material ? this.#blitter.Draw(renderContext, options.material, texture, {
+        tlTexCoord,
+        brTexCoord
+      }) : this.#blitter.DrawTexture(renderContext, texture, {
+        tlTexCoord,
+        brTexCoord
+      }, options.filter);
+    }
+
     /** Carbon's `Tr2RenderContextEnum::PIXEL_SHADER`, the one stage that differs. */
   }];
   PIXEL_SHADER = 1;

package/dist/trinity/core/Tr2Renderer.js.map

@@ -1 +1 @@
-{"version":3,"file":"Tr2Renderer.js","sources":["../../../../src/trinity/core/Tr2Renderer.js"],"sourcesContent":["// Source: trinity/trinity/Tr2Renderer.h\n// Source: trinity/trinity/Tr2Renderer.cpp\n//\n// The renderer-wide facade: the constant-buffer register map, the frame clock,\n// and the projection and view state every pass reads.\n//\n// ONE DELIBERATE DEPARTURE, DECIDED BY THE OPERATOR ON 2026-09-05. Carbon's\n// `Tr2Renderer` is entirely STATIC - a process-wide singleton. Ours is an\n// instance the composition root creates and hands out. Two reasons, and the\n// second is the one that matters:\n//\n// - a page is unlikely to want two backends at once, so the singleton is not\n//   buying much;\n// - but this runtime already supports more than one library instance with its\n//   own resource manager, and a static renderer would silently make the second\n//   one share the first one's frame clock and projection. That is a bug nobody\n//   would look for.\n//\n// The composition root creating one is not the same as the composition root\n// BECOMING a renderer, which `runtime/docs/core/roadmap.md` rules out: this\n// class holds GPU-free state and the library composes it, exactly as it\n// composes a resource manager it does not implement.\n//\n// WHY THE REGISTER MAP IS HERE AND NOT IN AN ENGINE. Carbon keeps these six\n// numbers as `Tr2Renderer` statics (`Tr2Renderer.cpp:38-43`), because they are\n// the contract between Trinity and EVERY backend rather than one backend's\n// detail. They lived in the WebGPU engine until now, where a second backend\n// could not have reached them without copying them.\n\nimport { carbon, impl, type } from \"#schema\";\n\n\n/** perFrameVS, owned by the scene. */\nexport const PER_FRAME_VS = 1;\n\n/** perFramePS, owned by the scene. */\nexport const PER_FRAME_PS = 2;\n\n/** The effect's own constants. */\nexport const EFFECT_CONSTANTS = 0;\n\n/** perObjectVS, owned by the object being drawn. */\nexport const PER_OBJECT_VS = 3;\n\n/** perObjectPS, owned by the object being drawn. */\nexport const PER_OBJECT_PS = 4;\n\n// THERE WAS A REVERSE MAP HERE AND IT IS GONE. A register-number-to-name table\n// looked necessary because a caller reading a pipeline's DECLARED bindings has a\n// number and wants to know what it means. It is not: the numbers are fixed and\n// this class owns them, so the question is answered by comparing against the\n// accessors below - which is how Carbon answers it, and why Carbon has no such\n// table. The names only ever reached a diagnostic string.\n\n\n/**\n * Renderer-wide state: the register map now, the frame clock and camera later.\n *\n * NOT A `CjsModel`, and the reason is CATEGORY RATHER THAN COST. Operator,\n * 2026-09-05: \"CjsModel is only for things that actually need to hydrate\", and\n * \"there should be little cost in making something a CjsModel\". Both are true\n * at once, and the second is why the first has to be stated as a rule - if the\n * base were expensive, nobody would need telling.\n *\n * A model is an object that arrives from a `.red`/`.black` values graph. This\n * one is composed at runtime by the library, carries no `@io` field, and is\n * named as a type by nothing, so a hydration identity describes something that\n * can never happen. The same goes for the abstraction layer and the resource\n * and GPU classes - none of them is ever part of a serialized object. The AL\n * family already complies.\n *\n * IT IS STILL DECORATED, and that is the point worth keeping straight:\n * decorators are not only hydration. `@type.define` gives the class an\n * identity that tooling and the UI read, and `@carbon.method` is how the\n * parity audit sees a method at all. Dropping `CjsModel` costs neither.\n */\n@type.define({ className: \"Tr2Renderer\", family: \"trinityCore\" })\nexport class Tr2Renderer\n{\n  // Carbon's header calls these the defaults \"for the currently set shader\n  // model\" and they are mutable statics, but nothing ever reassigns them, so\n  // they are constants in practice. Kept as fields rather than inlined so a\n  // shader model that did move them has somewhere to move them to.\n\n  /** s_perFrameVSStartRegister */\n  #perFrameVSStartRegister = PER_FRAME_VS;\n\n  /** s_perFramePSStartRegister */\n  #perFramePSStartRegister = PER_FRAME_PS;\n\n  /** s_perObjectVSStartRegister */\n  #perObjectVSStartRegister = PER_OBJECT_VS;\n\n  /** s_perObjectPSStartRegister */\n  #perObjectPSStartRegister = PER_OBJECT_PS;\n\n  /** s_perObjectRTVertexBufferDataRegister */\n  #perObjectRTVertexBufferDataRegister = 5;\n\n  /** s_perObjectVSGUIStartRegister */\n  #perObjectVSGUIStartRegister = 6;\n\n  /**\n   * The register the scene's per-frame vertex constants bind at.\n   *\n   * @returns {number} A constant-buffer register.\n   */\n  @carbon.method\n  @impl.implemented\n  GetPerFrameVSStartRegister()\n  {\n    return this.#perFrameVSStartRegister;\n  }\n\n  /**\n   * The register the scene's per-frame pixel constants bind at.\n   *\n   * @returns {number} A constant-buffer register.\n   */\n  @carbon.method\n  @impl.implemented\n  GetPerFramePSStartRegister()\n  {\n    return this.#perFramePSStartRegister;\n  }\n\n  /**\n   * The register an object's per-object vertex constants bind at.\n   *\n   * @returns {number} A constant-buffer register.\n   */\n  @carbon.method\n  @impl.implemented\n  GetPerObjectVSStartRegister()\n  {\n    return this.#perObjectVSStartRegister;\n  }\n\n  /**\n   * The register an object's per-object pixel constants bind at.\n   *\n   * @returns {number} A constant-buffer register.\n   */\n  @carbon.method\n  @impl.implemented\n  GetPerObjectPSStartRegister()\n  {\n    return this.#perObjectPSStartRegister;\n  }\n\n  /**\n   * The register ray-traced vertex-buffer data binds at.\n   *\n   * @returns {number} A constant-buffer register.\n   */\n  @carbon.method\n  @impl.implemented\n  GetPerObjectRTVertexBufferDataRegister()\n  {\n    return this.#perObjectRTVertexBufferDataRegister;\n  }\n\n  /**\n   * The register the GUI's per-object vertex constants bind at.\n   *\n   * @returns {number} A constant-buffer register.\n   */\n  @carbon.method\n  @impl.implemented\n  GetPerObjectVSGUIStartRegister()\n  {\n    return this.#perObjectVSGUIStartRegister;\n  }\n\n  /**\n   * The per-object register for one shader stage.\n   *\n   * Carbon's overload pair collapses to a default: the pixel stage has its own\n   * register and every other stage shares the vertex one\n   * (`Tr2Renderer.h:65-81`).\n   *\n   * @param {number} [shaderType] A Carbon `ShaderType` value.\n   * @returns {number} A constant-buffer register.\n   */\n  @carbon.method\n  @impl.adapted\n  GetPerObjectStartRegister(shaderType = 0)\n  {\n    return shaderType === Tr2Renderer.PIXEL_SHADER\n      ? this.GetPerObjectPSStartRegister()\n      : this.GetPerObjectVSStartRegister();\n  }\n\n  /** Carbon's `Tr2RenderContextEnum::PIXEL_SHADER`, the one stage that differs. */\n  static PIXEL_SHADER = 1;\n}\n"],"names":["PER_FRAME_VS","PER_FRAME_PS","EFFECT_CONSTANTS","PER_OBJECT_VS","PER_OBJECT_PS","_Tr2Renderer","_identity","Tr2Renderer","e","_initProto","c","_initClass","_applyDecs","type","define","className","family","carbon","method","impl","implemented","adapted","GetPerFrameVSStartRegister","GetPerFramePSStartRegister","GetPerObjectVSStartRegister","GetPerObjectPSStartRegister","GetPerObjectRTVertexBufferDataRegister","GetPerObjectVSGUIStartRegister","GetPerObjectStartRegister","shaderType","PIXEL_SHADER","constructor"],"mappings":"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"}
+{"version":3,"file":"Tr2Renderer.js","sources":["../../../../src/trinity/core/Tr2Renderer.js"],"sourcesContent":["// Source: trinity/trinity/Tr2Renderer.h\n// Source: trinity/trinity/Tr2Renderer.cpp\n//\n// The renderer-wide facade: the constant-buffer register map, the frame clock,\n// and the projection and view state every pass reads.\n//\n// ONE DELIBERATE DEPARTURE, DECIDED BY THE OPERATOR ON 2026-09-05. Carbon's\n// `Tr2Renderer` is entirely STATIC - a process-wide singleton. Ours is an\n// instance the composition root creates and hands out. Two reasons, and the\n// second is the one that matters:\n//\n// - a page is unlikely to want two backends at once, so the singleton is not\n//   buying much;\n// - but this runtime already supports more than one library instance with its\n//   own resource manager, and a static renderer would silently make the second\n//   one share the first one's frame clock and projection. That is a bug nobody\n//   would look for.\n//\n// The composition root creating one is not the same as the composition root\n// BECOMING a renderer, which `runtime/docs/core/roadmap.md` rules out: this\n// class holds GPU-free state and the library composes it, exactly as it\n// composes a resource manager it does not implement.\n//\n// WHY THE REGISTER MAP IS HERE AND NOT IN AN ENGINE. Carbon keeps these six\n// numbers as `Tr2Renderer` statics (`Tr2Renderer.cpp:38-43`), because they are\n// the contract between Trinity and EVERY backend rather than one backend's\n// detail. They lived in the WebGPU engine until now, where a second backend\n// could not have reached them without copying them.\n\nimport { carbon, impl, type } from \"#schema\";\nimport { Tr2Blitter } from \"./Tr2Blitter.js\";\nimport { AdjustTextureCoordsToViewport } from \"./Tr2RenderUtils.js\";\n\n\n/** perFrameVS, owned by the scene. */\nexport const PER_FRAME_VS = 1;\n\n/** perFramePS, owned by the scene. */\nexport const PER_FRAME_PS = 2;\n\n/** The effect's own constants. */\nexport const EFFECT_CONSTANTS = 0;\n\n/** perObjectVS, owned by the object being drawn. */\nexport const PER_OBJECT_VS = 3;\n\n/** perObjectPS, owned by the object being drawn. */\nexport const PER_OBJECT_PS = 4;\n\n// THERE WAS A REVERSE MAP HERE AND IT IS GONE. A register-number-to-name table\n// looked necessary because a caller reading a pipeline's DECLARED bindings has a\n// number and wants to know what it means. It is not: the numbers are fixed and\n// this class owns them, so the question is answered by comparing against the\n// accessors below - which is how Carbon answers it, and why Carbon has no such\n// table. The names only ever reached a diagnostic string.\n\n\n/**\n * Renderer-wide state: the register map now, the frame clock and camera later.\n *\n * NOT A `CjsModel`, and the reason is CATEGORY RATHER THAN COST. Operator,\n * 2026-09-05: \"CjsModel is only for things that actually need to hydrate\", and\n * \"there should be little cost in making something a CjsModel\". Both are true\n * at once, and the second is why the first has to be stated as a rule - if the\n * base were expensive, nobody would need telling.\n *\n * A model is an object that arrives from a `.red`/`.black` values graph. This\n * one is composed at runtime by the library, carries no `@io` field, and is\n * named as a type by nothing, so a hydration identity describes something that\n * can never happen. The same goes for the abstraction layer and the resource\n * and GPU classes - none of them is ever part of a serialized object. The AL\n * family already complies.\n *\n * IT IS STILL DECORATED, and that is the point worth keeping straight:\n * decorators are not only hydration. `@type.define` gives the class an\n * identity that tooling and the UI read, and `@carbon.method` is how the\n * parity audit sees a method at all. Dropping `CjsModel` costs neither.\n */\n@type.define({ className: \"Tr2Renderer\", family: \"trinityCore\" })\nexport class Tr2Renderer\n{\n  // Carbon's header calls these the defaults \"for the currently set shader\n  // model\" and they are mutable statics, but nothing ever reassigns them, so\n  // they are constants in practice. Kept as fields rather than inlined so a\n  // shader model that did move them has somewhere to move them to.\n\n  /** s_perFrameVSStartRegister */\n  #perFrameVSStartRegister = PER_FRAME_VS;\n\n  /** s_perFramePSStartRegister */\n  #perFramePSStartRegister = PER_FRAME_PS;\n\n  /** s_perObjectVSStartRegister */\n  #perObjectVSStartRegister = PER_OBJECT_VS;\n\n  /** s_perObjectPSStartRegister */\n  #perObjectPSStartRegister = PER_OBJECT_PS;\n\n  /** s_perObjectRTVertexBufferDataRegister */\n  #perObjectRTVertexBufferDataRegister = 5;\n\n  /** s_perObjectVSGUIStartRegister */\n  #perObjectVSGUIStartRegister = 6;\n\n  /**\n   * The register the scene's per-frame vertex constants bind at.\n   *\n   * @returns {number} A constant-buffer register.\n   */\n  @carbon.method\n  @impl.implemented\n  GetPerFrameVSStartRegister()\n  {\n    return this.#perFrameVSStartRegister;\n  }\n\n  /**\n   * The register the scene's per-frame pixel constants bind at.\n   *\n   * @returns {number} A constant-buffer register.\n   */\n  @carbon.method\n  @impl.implemented\n  GetPerFramePSStartRegister()\n  {\n    return this.#perFramePSStartRegister;\n  }\n\n  /**\n   * The register an object's per-object vertex constants bind at.\n   *\n   * @returns {number} A constant-buffer register.\n   */\n  @carbon.method\n  @impl.implemented\n  GetPerObjectVSStartRegister()\n  {\n    return this.#perObjectVSStartRegister;\n  }\n\n  /**\n   * The register an object's per-object pixel constants bind at.\n   *\n   * @returns {number} A constant-buffer register.\n   */\n  @carbon.method\n  @impl.implemented\n  GetPerObjectPSStartRegister()\n  {\n    return this.#perObjectPSStartRegister;\n  }\n\n  /**\n   * The register ray-traced vertex-buffer data binds at.\n   *\n   * @returns {number} A constant-buffer register.\n   */\n  @carbon.method\n  @impl.implemented\n  GetPerObjectRTVertexBufferDataRegister()\n  {\n    return this.#perObjectRTVertexBufferDataRegister;\n  }\n\n  /**\n   * The register the GUI's per-object vertex constants bind at.\n   *\n   * @returns {number} A constant-buffer register.\n   */\n  @carbon.method\n  @impl.implemented\n  GetPerObjectVSGUIStartRegister()\n  {\n    return this.#perObjectVSGUIStartRegister;\n  }\n\n  /**\n   * The per-object register for one shader stage.\n   *\n   * Carbon's overload pair collapses to a default: the pixel stage has its own\n   * register and every other stage shares the vertex one\n   * (`Tr2Renderer.h:65-81`).\n   *\n   * @param {number} [shaderType] A Carbon `ShaderType` value.\n   * @returns {number} A constant-buffer register.\n   */\n  @carbon.method\n  @impl.adapted\n  GetPerObjectStartRegister(shaderType = 0)\n  {\n    return shaderType === Tr2Renderer.PIXEL_SHADER\n      ? this.GetPerObjectPSStartRegister()\n      : this.GetPerObjectVSStartRegister();\n  }\n\n  /**\n   * Carbon's `s_blitter`: the blitter every screen-space draw runs through.\n   *\n   * An INSTANCE field rather than Carbon's module global, for the reason this\n   * whole class is an instance - a second library instance must not silently\n   * share the first one's blitter. Created by `PrepareDeviceResources`, and\n   * null until then, which is why every draw below guards on it exactly as\n   * Carbon's `if( s_blitter )` does.\n   */\n  #blitter = null;\n\n  /**\n   * Creates the device-dependent resources, the blitter among them.\n   *\n   * Carbon `PrepareDeviceResources` (`Tr2Renderer.cpp:1273-1281`), which makes\n   * the blitter HERE rather than at startup and says why: it loads an effect,\n   * so the device has to exist and the shader model has to be settled first.\n   * That holds for us too - there is always a device by this point, the stub\n   * backend included, which is a real device and not an absence.\n   *\n   * Carbon also allocates its quad vertex and index buffers and its debug line\n   * set here. Those are not ported; this creates the blitter only.\n   *\n   * @param {object} [renderContext] The context to prepare the blitter against.\n   * @returns {Tr2Blitter} The renderer's blitter.\n   */\n  @carbon.method\n  @impl.adapted\n  @impl.reason(\"Carbon also allocates the quad vertex and index buffers and the debug line set here; only the blitter is ported.\")\n  PrepareDeviceResources(renderContext = null)\n  {\n    this.#blitter ??= new Tr2Blitter();\n    if (renderContext) this.#blitter.PrepareResources(renderContext);\n    return this.#blitter;\n  }\n\n  /**\n   * Returns the blitter, or null before `PrepareDeviceResources` has run.\n   *\n   * @returns {Tr2Blitter|null} The renderer's blitter.\n   */\n  GetBlitter()\n  {\n    return this.#blitter;\n  }\n\n  /**\n   * Draws a fullscreen quad with a material.\n   *\n   * Carbon `DrawScreenQuad( renderContext, Tr2Material* )`\n   * (`Tr2Renderer.cpp:1006-1012`).\n   *\n   * TEXTURE COORDINATES ARE NOT VIEWPORT-CORRECTED HERE, and that is Carbon's\n   * behaviour rather than an omission: only the `DrawTexture` family adjusts\n   * them. `AdjustTextureCoordsToViewport` records what the correction is and\n   * why folding it into the blitter would move every screen-quad draw.\n   *\n   * @param {object} renderContext The context to draw through.\n   * @param {object} material The material to draw with.\n   * @returns {boolean} Whether the quad was drawn.\n   */\n  @carbon.method\n  @impl.implemented\n  DrawScreenQuad(renderContext, material)\n  {\n    if (!this.#blitter) return false;\n    return this.#blitter.Draw(renderContext, material);\n  }\n\n  /**\n   * Draws a quad with an effect over an explicit screen rectangle.\n   *\n   * Carbon `DrawScreenQuad( renderContext, Tr2Effect*, topLeft, bottomRight )`\n   * (`Tr2Renderer.cpp:1014-1020`), which passes the full [0,1] TEXTURE range and\n   * the caller's corners as the VERTEX rectangle. Carbon distinguishes the two\n   * by overload; JavaScript has no overloads, so the rectangle form is named.\n   *\n   * @param {object} renderContext The context to draw through.\n   * @param {object} effect The effect to draw with.\n   * @param {Array<number>} topLeft Top-left vertex corner.\n   * @param {Array<number>} bottomRight Bottom-right vertex corner.\n   * @returns {boolean} Whether the quad was drawn.\n   */\n  @carbon.method\n  @impl.adapted\n  @impl.reason(\"Carbon distinguishes this from the material form by overload; JavaScript has none, so the rectangle form carries its own name.\")\n  DrawScreenQuadRect(renderContext, effect, topLeft, bottomRight)\n  {\n    if (!this.#blitter) return false;\n    return this.#blitter.Draw(renderContext, effect, null, {\n      tlTexCoord: [ 0, 0 ],\n      brTexCoord: [ 1, 1 ],\n      tlVertexCoord: topLeft,\n      brVertexCoord: bottomRight\n    });\n  }\n\n  /**\n   * Draws the quad in camera space rather than screen space.\n   *\n   * Carbon `DrawCameraSpaceScreenQuad` (`Tr2Renderer.cpp:1022-1028`).\n   *\n   * @param {object} renderContext The context to draw through.\n   * @param {object} shader The shader state interface to run.\n   * @param {object} material The material supplying its parameters.\n   * @returns {boolean} Whether the quad was drawn.\n   */\n  @carbon.method\n  @impl.implemented\n  DrawCameraSpaceScreenQuad(renderContext, shader, material)\n  {\n    if (!this.#blitter) return false;\n    return this.#blitter.DrawInCameraSpace(renderContext, shader, material);\n  }\n\n  /**\n   * Draws a unit quad with the given material and no texture.\n   *\n   * Carbon `DrawFullScreenWithShader` (`Tr2Renderer.cpp:768-775`).\n   *\n   * @param {object} renderContext The context to draw through.\n   * @param {object} material The material to draw with.\n   * @returns {boolean} Whether the quad was drawn.\n   */\n  @carbon.method\n  @impl.implemented\n  DrawFullScreenWithShader(renderContext, material)\n  {\n    if (!this.#blitter) return false;\n    return this.#blitter.Draw(renderContext, material);\n  }\n\n  /**\n   * Blits a texture, correcting its coordinates for the device viewport.\n   *\n   * Carbon's four `DrawTexture` overloads (`Tr2Renderer.cpp:750-834`) collapse\n   * into one: the material is optional, and without one the filter selects a\n   * built-in blit effect. THIS family adjusts the texture coordinates where\n   * `DrawScreenQuad` does not - Carbon draws that distinction and it is load\n   * bearing.\n   *\n   * @param {object} renderContext The context to draw through.\n   * @param {object} texture The texture to blit.\n   * @param {object} [options] `material`, `tlTexCoord`, `brTexCoord`, `filter`.\n   * @returns {boolean} Whether the quad was drawn.\n   */\n  @carbon.method\n  @impl.adapted\n  @impl.reason(\"Carbon's four overloads differ only in an optional material and optional coordinates, which are defaults here.\")\n  DrawTexture(renderContext, texture, options = {})\n  {\n    if (!this.#blitter) return false;\n\n    const { tlTexCoord, brTexCoord } = AdjustTextureCoordsToViewport(\n      renderContext,\n      options.tlTexCoord ?? [ 0, 0 ],\n      options.brTexCoord ?? [ 1, 1 ]\n    );\n\n    return options.material\n      ? this.#blitter.Draw(renderContext, options.material, texture, { tlTexCoord, brTexCoord })\n      : this.#blitter.DrawTexture(renderContext, texture, { tlTexCoord, brTexCoord }, options.filter);\n  }\n\n  /** Carbon's `Tr2RenderContextEnum::PIXEL_SHADER`, the one stage that differs. */\n  static PIXEL_SHADER = 1;\n}\n"],"names":["PER_FRAME_VS","PER_FRAME_PS","EFFECT_CONSTANTS","PER_OBJECT_VS","PER_OBJECT_PS","_Tr2Renderer","_identity","Tr2Renderer","e","_initProto","c","_initClass","_applyDecs","type","define","className","family","carbon","method","impl","implemented","adapted","reason","GetPerFrameVSStartRegister","GetPerFramePSStartRegister","GetPerObjectVSStartRegister","GetPerObjectPSStartRegister","GetPerObjectRTVertexBufferDataRegister","GetPerObjectVSGUIStartRegister","GetPerObjectStartRegister","shaderType","PIXEL_SHADER","PrepareDeviceResources","renderContext","Tr2Blitter","PrepareResources","GetBlitter","DrawScreenQuad","material","Draw","DrawScreenQuadRect","effect","topLeft","bottomRight","tlTexCoord","brTexCoord","tlVertexCoord","brVertexCoord","DrawCameraSpaceScreenQuad","shader","DrawInCameraSpace","DrawFullScreenWithShader","DrawTexture","texture","options","AdjustTextureCoordsToViewport","filter","constructor"],"mappings":";;;;;;;AAkCA;AACO,MAAMA,YAAY,GAAG;;AAE5B;AACO,MAAMC,YAAY,GAAG;;AAE5B;AACO,MAAMC,gBAAgB,GAAG;;AAEhC;AACO,MAAMC,aAAa,GAAG;;AAE7B;AACO,MAAMC,aAAa,GAAG;;AAE7B;AACA;AACA;AACA;AACA;AACA;;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AApBA,IAAAC;AAAA,IAAA,cAAAC,SAAA,CAAA;EAAA,QAqBA,MAAAC,WAAA,CAEA;AAAA,IAAA;AAAA,MAAA,CAAA;AAAAC,QAAAA,CAAA,GAAAC,UAAA,CAAA;QAAAC,CAAA,EAAA,CAAAL,YAAA,EAAAM,UAAA;AAAA,OAAA,GAAAC,cAAA,CAAA,IAAA,EAAA,CAFCC,IAAI,CAACC,MAAM,CAAC;AAAEC,QAAAA,SAAS,EAAE,aAAa;AAAEC,QAAAA,MAAM,EAAE;AAAc,OAAC,CAAC,CAAA,EAAA,CAAA,CAAA,CA+B9DC,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,WAAW,CAAA,EAAA,EAAA,EAAA,4BAAA,CAAA,EAAA,CAAA,CAWhBH,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,WAAW,wCAWhBH,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,WAAW,yCAWhBH,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,WAAW,CAAA,EAAA,EAAA,EAAA,6BAAA,CAAA,EAAA,CAAA,CAWhBH,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,WAAW,CAAA,EAAA,EAAA,EAAA,wCAAA,CAAA,EAAA,CAAA,CAWhBH,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,WAAW,4CAgBhBH,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACE,OAAO,uCAkCZJ,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACE,OAAO,EAAA,MAAA,EACZF,IAAI,CAACG,MAAM,CAAC,kHAAkH,CAAC,oCAiC/HL,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,WAAW,CAAA,EAAA,EAAA,EAAA,gBAAA,CAAA,EAAA,CAAA,CAqBhBH,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACE,OAAO,EAAA,MAAA,EACZF,IAAI,CAACG,MAAM,CAAC,gIAAgI,CAAC,gCAsB7IL,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,WAAW,uCAgBhBH,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACC,WAAW,CAAA,EAAA,EAAA,EAAA,0BAAA,CAAA,EAAA,CAAA,CAqBhBH,MAAM,EAANA,MAAM,CAACC,MAAM,EACbC,IAAI,EAAJA,IAAI,CAACE,OAAO,EAAA,MAAA,EACZF,IAAI,CAACG,MAAM,CAAC,gHAAgH,CAAC,CAAA,EAAA,EAAA,EAAA,aAAA,CAAA,CAAA,CAAA;AAAA;AAtQ9H;AACA;AACA;AACA;;AAEA;AACA,IAAA,wBAAwB,IAAAb,UAAA,CAAA,IAAA,CAAA,EAAGT,YAAY;;AAEvC;IACA,wBAAwB,GAAGC,YAAY;;AAEvC;IACA,yBAAyB,GAAGE,aAAa;;AAEzC;IACA,yBAAyB,GAAGC,aAAa;;AAEzC;IACA,oCAAoC,GAAG,CAAC;;AAExC;IACA,4BAA4B,GAAG,CAAC;;AAEhC;AACF;AACA;AACA;AACA;AAGEmB,IAAAA,0BAA0BA,GAC1B;MACE,OAAO,IAAI,CAAC,wBAAwB;AACtC,IAAA;;AAEA;AACF;AACA;AACA;AACA;AAGEC,IAAAA,0BAA0BA,GAC1B;MACE,OAAO,IAAI,CAAC,wBAAwB;AACtC,IAAA;;AAEA;AACF;AACA;AACA;AACA;AAGEC,IAAAA,2BAA2BA,GAC3B;MACE,OAAO,IAAI,CAAC,yBAAyB;AACvC,IAAA;;AAEA;AACF;AACA;AACA;AACA;AAGEC,IAAAA,2BAA2BA,GAC3B;MACE,OAAO,IAAI,CAAC,yBAAyB;AACvC,IAAA;;AAEA;AACF;AACA;AACA;AACA;AAGEC,IAAAA,sCAAsCA,GACtC;MACE,OAAO,IAAI,CAAC,oCAAoC;AAClD,IAAA;;AAEA;AACF;AACA;AACA;AACA;AAGEC,IAAAA,8BAA8BA,GAC9B;MACE,OAAO,IAAI,CAAC,4BAA4B;AAC1C,IAAA;;AAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AAGEC,IAAAA,yBAAyBA,CAACC,UAAU,GAAG,CAAC,EACxC;AACE,MAAA,OAAOA,UAAU,KAAKvB,YAAW,CAACwB,YAAY,GAC1C,IAAI,CAACL,2BAA2B,EAAE,GAClC,IAAI,CAACD,2BAA2B,EAAE;AACxC,IAAA;;AAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;IACE,QAAQ,GAAG,IAAI;;AAEf;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AAIEO,IAAAA,sBAAsBA,CAACC,aAAa,GAAG,IAAI,EAC3C;AACE,MAAA,IAAI,CAAC,QAAQ,KAAK,IAAIC,UAAU,EAAE;MAClC,IAAID,aAAa,EAAE,IAAI,CAAC,QAAQ,CAACE,gBAAgB,CAACF,aAAa,CAAC;MAChE,OAAO,IAAI,CAAC,QAAQ;AACtB,IAAA;;AAEA;AACF;AACA;AACA;AACA;AACEG,IAAAA,UAAUA,GACV;MACE,OAAO,IAAI,CAAC,QAAQ;AACtB,IAAA;;AAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AAGEC,IAAAA,cAAcA,CAACJ,aAAa,EAAEK,QAAQ,EACtC;AACE,MAAA,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,KAAK;MAChC,OAAO,IAAI,CAAC,QAAQ,CAACC,IAAI,CAACN,aAAa,EAAEK,QAAQ,CAAC;AACpD,IAAA;;AAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;IAIEE,kBAAkBA,CAACP,aAAa,EAAEQ,MAAM,EAAEC,OAAO,EAAEC,WAAW,EAC9D;AACE,MAAA,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,KAAK;AAChC,MAAA,OAAO,IAAI,CAAC,QAAQ,CAACJ,IAAI,CAACN,aAAa,EAAEQ,MAAM,EAAE,IAAI,EAAE;AACrDG,QAAAA,UAAU,EAAE,CAAE,CAAC,EAAE,CAAC,CAAE;AACpBC,QAAAA,UAAU,EAAE,CAAE,CAAC,EAAE,CAAC,CAAE;AACpBC,QAAAA,aAAa,EAAEJ,OAAO;AACtBK,QAAAA,aAAa,EAAEJ;AACjB,OAAC,CAAC;AACJ,IAAA;;AAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AAGEK,IAAAA,yBAAyBA,CAACf,aAAa,EAAEgB,MAAM,EAAEX,QAAQ,EACzD;AACE,MAAA,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,KAAK;AAChC,MAAA,OAAO,IAAI,CAAC,QAAQ,CAACY,iBAAiB,CAACjB,aAAa,EAAEgB,MAAM,EAAEX,QAAQ,CAAC;AACzE,IAAA;;AAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AAGEa,IAAAA,wBAAwBA,CAAClB,aAAa,EAAEK,QAAQ,EAChD;AACE,MAAA,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,KAAK;MAChC,OAAO,IAAI,CAAC,QAAQ,CAACC,IAAI,CAACN,aAAa,EAAEK,QAAQ,CAAC;AACpD,IAAA;;AAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;IAIEc,WAAWA,CAACnB,aAAa,EAAEoB,OAAO,EAAEC,OAAO,GAAG,EAAE,EAChD;AACE,MAAA,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,KAAK;MAEhC,MAAM;QAAEV,UAAU;AAAEC,QAAAA;OAAY,GAAGU,6BAA6B,CAC9DtB,aAAa,EACbqB,OAAO,CAACV,UAAU,IAAI,CAAE,CAAC,EAAE,CAAC,CAAE,EAC9BU,OAAO,CAACT,UAAU,IAAI,CAAE,CAAC,EAAE,CAAC,CAC9B,CAAC;AAED,MAAA,OAAOS,OAAO,CAAChB,QAAQ,GACnB,IAAI,CAAC,QAAQ,CAACC,IAAI,CAACN,aAAa,EAAEqB,OAAO,CAAChB,QAAQ,EAAEe,OAAO,EAAE;QAAET,UAAU;AAAEC,QAAAA;AAAW,OAAC,CAAC,GACxF,IAAI,CAAC,QAAQ,CAACO,WAAW,CAACnB,aAAa,EAAEoB,OAAO,EAAE;QAAET,UAAU;AAAEC,QAAAA;AAAW,OAAC,EAAES,OAAO,CAACE,MAAM,CAAC;AACnG,IAAA;;AAEA;GAED;AADQzB,EAAAA,YAAY,GAAG,CAAC;EAAC0B,WAAAA,GAAA;IAAA,KAAA,CAAApD,YAAA,GAAAM,UAAA,EAAA;AAAA,EAAA;AAAA,CAAA,EAAA;;;;"}

package/dist/trinity/core/Tr2ShadowMap.js

@@ -4,8 +4,9 @@ import { CjsModel } from '#model';
 import { mat4 } from '#math/mat4';
 import { vec3 } from '#math/vec3';
 import { vec4 } from '#math/vec4';
+import { PixelFormat, Tr2GpuUsage, TextureType } from '#consts/render-context';
 import { Tr2Effect as _Tr2Effect } from '../shader/Tr2Effect.js';
-import { Tr2Denoiser as _Tr2Denoiser } from '../generated/trinityCore/Tr2Denoiser.js';
+import { Tr2Denoiser as _Tr2Denoiser } from './Tr2Denoiser.js';
 import { Tr2VariableStore as _Tr2VariableStore } from './variable/Tr2VariableStore.js';
 import { TriFrustumOrtho } from './view/TriFrustumOrtho.js';
 
@@ -54,8 +55,14 @@ function createSplitSetup() {
 function createShadowEffect() {
   const effect = new _Tr2Effect();
   effect.SetEffectPathName("res:/graphics/effect/managed/space/system/ShadowDepth.fx");
-  effect.AddResourceTexture2D("EveSpaceSceneCascadedShadowMap");
-  effect.AddResourceTexture2D("DepthMap");
+
+  // DECLARED BY CLEARING, which is Carbon (`cpp:41-42`), not by
+  // AddResourceTexture2D. The difference is not cosmetic: a res-path slot and a
+  // runtime slot are different classes, so declaring the res-path kind here left
+  // SetParameter unable to find a runtime slot to update - it added a new one on
+  // every call, and a per-frame resolve grew the resource list without bound.
+  effect.SetParameter("EveSpaceSceneCascadedShadowMap", null);
+  effect.SetParameter("DepthMap", null);
   return effect;
 }
 
@@ -123,7 +130,7 @@ new class extends _identity {
       } = _applyDecs2311(this, [type.define({
         className: "Tr2ShadowMap",
         family: "trinityCore"
-      })], [[[io, io.notify, io, io.persist, type, type.int32, void 0, type.enum("ShadowSplitMode")], 16, "shadowSplitMode"], [[io, io.readwrite, void 0, type.objectRef("Tr2Denoiser")], 16, "denoiser"], [[io, io.readwrite, void 0, type.objectRef("Tr2Effect")], 16, "cascadeEffect"], [[io, io.notify, io, io.read, type, type.uint32], 16, "splitCount"], [[io, io.notify, io, io.readwrite, type, type.boolean], 16, "debugColorSplit"], [[io, io.readwrite, type, type.float32], 16, "SplitNr15"], [[io, io.readwrite, type, type.float32], 16, "SplitNr8"], [[io, io.readwrite, type, type.float32], 16, "SplitNr6"], [[io, io.readwrite, type, type.float32], 16, "SplitNr5"], [[io, io.readwrite, type, type.float32], 16, "SplitNr14"], [[io, io.readwrite, type, type.float32], 16, "SplitNr10"], [[io, io.readwrite, type, type.float32], 16, "SplitNr13"], [[io, io.readwrite, type, type.float32], 16, "SplitNr4"], [[io, io.readwrite, type, type.float32], 16, "SplitNr3"], [[io, io.readwrite, type, type.float32], 16, "SplitNr7"], [[io, io.readwrite, type, type.float32], 16, "SplitNr1"], [[io, io.readwrite, type, type.float32], 16, "SplitNr9"], [[io, io.readwrite, type, type.float32], 16, "SplitNr0"], [[io, io.readwrite, type, type.float32], 16, "SplitNr11"], [[io, io.readwrite, type, type.float32], 16, "SplitNr12"], [[io, io.readwrite, type, type.float32], 16, "SplitNr2"], [[io, io.notify, io, io.readwrite, type, type.boolean], 16, "disableShimmer"], [[io, io.readwrite, type, type.uint32], 16, "size"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("The fixed PerSplitData arrays make split counts above Carbon's 16-slot capacity fail immediately instead of corrupting adjacent native memory.")], 18, "Setup"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("CjsModel notifications expose settled state rather than Be::Var identity, so this compares the two notify-backed values against their cached state.")], 18, "OnModified"], [[carbon, carbon.method, impl, impl.implemented], 18, "ShouldUseDenoiser"], [[impl, impl.custom, void 0, impl.reason("The nominal engine executor needs Carbon's private denoiser-use decision without reading implementation fields.")], 18, "GetUseDenoiser"], [[carbon, carbon.method, impl, impl.implemented], 18, "UpdateSplitValues"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("The caller supplies owned JS output containers; matrix bytes stay in logical gl-matrix form and are never pre-transposed.")], 26, "CalculateAABB"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Carbon stores Transpose(lightViewProjection) and returns SplitSetup by value; Trinity stores the logical matrix for RawData's terminal transpose and reuses one allocation-free result per split.")], 18, "SetupShadowSplit"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("GPU pool allocation is realized by the nominal shadow executor installed on the render context.")], 18, "PrepareShadowRendering"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Viewport and physical depth-target state are engine realization details.")], 18, "BeginShadowRendering"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Physical render-state restoration is owned by the engine executor.")], 18, "EndShadowRendering"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("The engine owns temporary targets, fullscreen drawing and physical denoising.")], 18, "DrawToShadowMapResult"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetShadowSplitCount"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetShadowMapSize"], [[impl, impl.custom, void 0, impl.reason("The nominal engine executor needs Carbon's private fixed atlas width without reading implementation fields.")], 18, "GetShadowMapWidth"], [[impl, impl.custom, void 0, impl.reason("The nominal engine executor needs Carbon's private fixed atlas height without reading implementation fields.")], 18, "GetShadowMapHeight"], [[impl, impl.custom, void 0, impl.reason("The scene needs a nominal direct accessor to Carbon's public PerSplitData without structural probing.")], 18, "GetPerSplitData"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetShadowEffect"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetDebugSplitValue"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetDebugColors"]], 0, void 0, CjsModel));
+      })], [[[io, io.notify, io, io.persist, type, type.int32, void 0, type.enum("ShadowSplitMode")], 16, "shadowSplitMode"], [[io, io.readwrite, void 0, type.objectRef("Tr2Denoiser")], 16, "denoiser"], [[io, io.readwrite, void 0, type.objectRef("Tr2Effect")], 16, "cascadeEffect"], [[io, io.notify, io, io.read, type, type.uint32], 16, "splitCount"], [[io, io.notify, io, io.readwrite, type, type.boolean], 16, "debugColorSplit"], [[io, io.readwrite, type, type.float32], 16, "SplitNr15"], [[io, io.readwrite, type, type.float32], 16, "SplitNr8"], [[io, io.readwrite, type, type.float32], 16, "SplitNr6"], [[io, io.readwrite, type, type.float32], 16, "SplitNr5"], [[io, io.readwrite, type, type.float32], 16, "SplitNr14"], [[io, io.readwrite, type, type.float32], 16, "SplitNr10"], [[io, io.readwrite, type, type.float32], 16, "SplitNr13"], [[io, io.readwrite, type, type.float32], 16, "SplitNr4"], [[io, io.readwrite, type, type.float32], 16, "SplitNr3"], [[io, io.readwrite, type, type.float32], 16, "SplitNr7"], [[io, io.readwrite, type, type.float32], 16, "SplitNr1"], [[io, io.readwrite, type, type.float32], 16, "SplitNr9"], [[io, io.readwrite, type, type.float32], 16, "SplitNr0"], [[io, io.readwrite, type, type.float32], 16, "SplitNr11"], [[io, io.readwrite, type, type.float32], 16, "SplitNr12"], [[io, io.readwrite, type, type.float32], 16, "SplitNr2"], [[io, io.notify, io, io.readwrite, type, type.boolean], 16, "disableShimmer"], [[io, io.readwrite, type, type.uint32], 16, "size"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("The fixed PerSplitData arrays make split counts above Carbon's 16-slot capacity fail immediately instead of corrupting adjacent native memory.")], 18, "Setup"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("CjsModel notifications expose settled state rather than Be::Var identity, so this compares the two notify-backed values against their cached state.")], 18, "OnModified"], [[carbon, carbon.method, impl, impl.implemented], 18, "ShouldUseDenoiser"], [[impl, impl.custom, void 0, impl.reason("The nominal engine executor needs Carbon's private denoiser-use decision without reading implementation fields.")], 18, "GetUseDenoiser"], [[carbon, carbon.method, impl, impl.implemented], 18, "UpdateSplitValues"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("The caller supplies owned JS output containers; matrix bytes stay in logical gl-matrix form and are never pre-transposed.")], 26, "CalculateAABB"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Carbon stores Transpose(lightViewProjection) and returns SplitSetup by value; Trinity stores the logical matrix for RawData's terminal transpose and reuses one allocation-free result per split.")], 18, "SetupShadowSplit"], [[carbon, carbon.method, impl, impl.implemented], 18, "PrepareShadowRendering"], [[carbon, carbon.method, impl, impl.implemented], 18, "BeginShadowRendering"], [[carbon, carbon.method, impl, impl.implemented], 18, "EndShadowRendering"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Carbon reaches the blitter and the reversed-depth projection through static Tr2Renderer; ours are an instance and the render context, so the renderer is passed in.")], 18, "DrawToShadowMapResult"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetShadowSplitCount"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetShadowMapSize"], [[impl, impl.custom, void 0, impl.reason("The nominal engine executor needs Carbon's private fixed atlas width without reading implementation fields.")], 18, "GetShadowMapWidth"], [[impl, impl.custom, void 0, impl.reason("The nominal engine executor needs Carbon's private fixed atlas height without reading implementation fields.")], 18, "GetShadowMapHeight"], [[impl, impl.custom, void 0, impl.reason("The scene needs a nominal direct accessor to Carbon's public PerSplitData without structural probing.")], 18, "GetPerSplitData"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetShadowEffect"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetDebugSplitValue"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetDebugColors"]], 0, void 0, CjsModel));
       _initStatic(this);
     }
     shadowSplitMode = (_initProto(this), _init_shadowSplitMode(this, 0));
@@ -331,24 +338,138 @@ new class extends _identity {
       return setup;
     }
 
-    /** Delegates physical atlas allocation and setup to the installed engine. */
-    PrepareShadowRendering(renderContext) {
-      return renderContext.GetShadowMapExecutor().PrepareShadowRendering(this, renderContext);
+    /**
+     * Allocates the cascaded depth surface and makes it the render target.
+     *
+     * @param {object} gpuResourcePool The pool to borrow the surface from.
+     * @param {object} renderContext The context to set state on.
+     * @returns {object|null} The borrowed depth texture, or null when the pool
+     *   could not supply one - which Carbon notes happens on a lost device.
+     */
+    PrepareShadowRendering(gpuResourcePool, renderContext) {
+      const cascadedShadowDepth = gpuResourcePool.GetTempTexture("cascadedShadowDepth", {
+        width: this.size * this.#width,
+        height: this.size * this.#height,
+        format: PixelFormat.PIXEL_FORMAT_D32_FLOAT,
+        gpuUsage: Tr2GpuUsage.DEPTH_STENCIL | Tr2GpuUsage.SHADER_RESOURCE
+      });
+      if (!cascadedShadowDepth || !cascadedShadowDepth.IsValid()) return null;
+      const esm = renderContext.GetEffectStateManager();
+
+      // The depth stencil IS the shadow map, so the colour target is pushed EMPTY -
+      // Carbon passes a default-constructed Tr2TextureAL and comments it "empty
+      // texture" (`cpp:238`). Null is that argument here. Omitting it would only
+      // save the slot and leave the scene's colour target bound underneath the
+      // whole shadow pass, which is what this line used to do.
+      esm.PushViewport();
+      esm.PushRenderTarget(null);
+      esm.PushDepthStencilBuffer(cascadedShadowDepth);
+      esm.UpdateRenderTargetViewport(cascadedShadowDepth.Get().GetWidth(), cascadedShadowDepth.Get().GetHeight());
+
+      // Carbon wants a clean depth buffer for this pass and says so.
+      renderContext.Clear({
+        depth: true,
+        clearDepth: 1,
+        clearStencil: 0
+      });
+      renderContext.SetReadOnlyDepth(false);
+      return cascadedShadowDepth;
     }
 
-    /** Delegates one atlas-cell render-pass begin to the installed engine. */
+    /**
+     * Points the viewport at one split's cell in the atlas.
+     *
+     * Eight cells per row: splits 0-7 fill the top row and 8 onward wrap to a
+     * second, which is why the row index is `splitIndex % 8` and the y offset is
+     * either zero or one cell down.
+     *
+     * @param {object} renderContext The context to set the viewport on.
+     * @param {number} splitIndex Which cascade split.
+     */
     BeginShadowRendering(renderContext, splitIndex) {
-      return renderContext.GetShadowMapExecutor().BeginShadowRendering(this, splitIndex, renderContext);
+      const esm = renderContext.GetEffectStateManager();
+      const topRow = splitIndex < 8;
+      esm.SetViewport({
+        width: this.size,
+        height: this.size,
+        x: (topRow ? splitIndex : splitIndex % 8) * this.size,
+        y: topRow ? 0 : this.size,
+        minZ: 0,
+        maxZ: 1
+      });
     }
 
-    /** Delegates shadow rendering teardown to the installed engine. */
+    /**
+     * Unwinds everything `PrepareShadowRendering` pushed, in reverse.
+     *
+     * @param {object} renderContext The context to restore.
+     */
     EndShadowRendering(renderContext) {
-      return renderContext.GetShadowMapExecutor().EndShadowRendering(this, renderContext);
+      renderContext.SetReadOnlyDepth(false);
+      const esm = renderContext.GetEffectStateManager();
+      esm.PopRenderTarget();
+      esm.PopDepthStencilBuffer();
+      esm.PopViewport();
     }
 
-    /** Delegates shadow-result realization and optional denoising to the engine. */
-    DrawToShadowMapResult(renderContext, depthMap, cascadedShadowDepth, upscaling) {
-      return renderContext.GetShadowMapExecutor().DrawToShadowMapResult(this, depthMap, cascadedShadowDepth, upscaling, renderContext);
+    /**
+     * Resolves the cascaded depth into a screen-space shadow factor.
+     *
+     * Carbon `DrawToShadowMapResult` (`cpp:278-305`). Borrow an R8 target the
+     * size of the scene depth, bind it, run the shadow effect over a fullscreen
+     * quad with the atlas and the depth map bound, then optionally denoise.
+     *
+     * THE DEPTH BUFFER IS PUSHED EMPTY, not merely saved. Carbon passes a
+     * default-constructed Tr2TextureAL (`cpp:285`), which unbinds it - this pass
+     * writes a full-screen factor and must not be depth-tested against the very
+     * buffer it is reading.
+     *
+     * THE EFFECT'S TEXTURES ARE CLEARED IMMEDIATELY AFTER THE DRAW, as Carbon
+     * does (`cpp:290-291`), so a later pass cannot inherit the atlas or the
+     * scene depth from this one.
+     *
+     * `cascadeEffect` is Carbon's `m_shadowEffect` under our name - same
+     * ShadowDepth.fx path, same two parameters (`cpp:39-42`).
+     *
+     * @param {object} renderContext The context to draw against.
+     * @param {object} gpuResourcePool The pool to borrow the result target from.
+     * @param {object} depthMap The scene depth.
+     * @param {object} cascadedShadowDepth The atlas produced by this pass.
+     * @param {number} upscaling The denoiser's upscaling factor.
+     * @param {object} renderer The renderer owning the blitter.
+     * @returns {object|null} The shadow-factor target, or null without a pool.
+     */
+    DrawToShadowMapResult(renderContext, gpuResourcePool, depthMap, cascadedShadowDepth, upscaling, renderer) {
+      let shadowMapResult = gpuResourcePool.GetTempTexture("shadowMapResult", {
+        type: TextureType.TEX_TYPE_2D,
+        width: depthMap.GetWidth(),
+        height: depthMap.GetHeight(),
+        depth: 1,
+        mipCount: 1,
+        format: PixelFormat.PIXEL_FORMAT_R8_UNORM,
+        gpuUsage: Tr2GpuUsage.RENDER_TARGET | Tr2GpuUsage.SHADER_RESOURCE
+      });
+      const esm = renderContext.GetEffectStateManager();
+      esm.PushRenderTarget(shadowMapResult.Get());
+      esm.PushDepthStencilBuffer(null);
+      try {
+        this.cascadeEffect.SetParameter("EveSpaceSceneCascadedShadowMap", cascadedShadowDepth);
+        this.cascadeEffect.SetParameter("DepthMap", depthMap);
+        renderer.DrawScreenQuad(renderContext, this.cascadeEffect);
+        this.cascadeEffect.SetParameter("EveSpaceSceneCascadedShadowMap", null);
+        this.cascadeEffect.SetParameter("DepthMap", null);
+
+        // Carbon gates on all three (`cpp:296`). Setup() nulls the denoiser when
+        // it is disabled, so the useDenoiser flag and a present denoiser are not
+        // the same question.
+        if (this.denoiser && this.#useDenoiser && depthMap.IsValid()) {
+          shadowMapResult = this.denoiser.Apply(shadowMapResult, depthMap, null, renderContext.GetReversedDepthProjectionTransform(), upscaling, gpuResourcePool, renderContext, renderer);
+        }
+        return shadowMapResult;
+      } finally {
+        esm.PopRenderTarget();
+        esm.PopDepthStencilBuffer();
+      }
     }
     /** Returns the number of active cascade splits. */
     GetShadowSplitCount() {