@carbonenginejs/runtime 0.1.0-alpha.2 → 0.1.0-alpha.4

package/dist/trinity/shader/Tr2Effect.js

@@ -1,5 +1,5 @@
 import { identity as _identity, applyDecs2311 as _applyDecs2311 } from '../../_virtual/_rollupPluginBabelHelpers.js';
-import { io, type, carbon, impl, CjsSchema } from '#schema';
+import { edit, type, carbon, impl, CjsSchema } from '#schema';
 import { Tr2ResourceSetDescriptionAL, Tr2RegisterMapAL } from '#trinityal';
 import { Tr2Material as _Tr2Material } from './Tr2Material.js';
 import { vec4 } from '#math/vec4';
@@ -11,11 +11,15 @@ import { ShaderStageType, Tr2EffectRes, Tr2Shader, Tr2EffectConstant } from '#re
 import { Tr2EffectParam as _Tr2EffectParam } from './material/Tr2EffectParam.js';
 import { Tr2EffectPassParameters as _Tr2EffectPassParamet } from './material/Tr2EffectPassParameters.js';
 import { Tr2EffectTechniqueInputs as _Tr2EffectTechniqueIn } from './material/Tr2EffectTechniqueInputs.js';
-import { CjsResMan, ResourceRequirement } from '#resource';
+import { ResourceRequirement } from '#resource';
+import { blue } from '#blue';
+import { BLUELISTEVENT } from '#consts/blue';
 import { GetEffectPathDefaults, NormalizeResourcePath, ResolveEffectPath } from '#utils/effectPath';
 import { Tr2EffectStateManager as _Tr2EffectStateManage } from './Tr2EffectStateManager.js';
 import { Tr2ShaderOption as _Tr2ShaderOption } from './reflection/Tr2ShaderOption.js';
 import { Tr2SamplerOverride as _Tr2SamplerOverride } from './sampler/Tr2SamplerOverride.js';
+import { ITriEffectResourceParameter } from './parameter/ITriEffectResourceParameter.js';
+import { ITriReroutable } from '../core/ITriReroutable.js';
 import { Tr2RuntimeTextureParameter as _Tr2RuntimeTexturePar } from './parameter/Tr2RuntimeTextureParameter.js';
 import { Tr2Vector2Parameter as _Tr2Vector2Parameter } from './parameter/Tr2Vector2Parameter.js';
 import { Tr2Vector3Parameter as _Tr2Vector3Parameter } from './parameter/Tr2Vector3Parameter.js';
@@ -24,7 +28,7 @@ import { TriFloatArrayParameter as _TriFloatArrayParamet } from './parameter/Tri
 import { TriTextureParameter as _TriTextureParameter } from './parameter/TriTextureParameter.js';
 import { TriVariableParameter as _TriVariableParameter } from './parameter/TriVariableParameter.js';
 import { TriVector4 as _TriVector } from './parameter/TriVector4.js';
-import { CjsParameter } from './parameter/CjsParameter.js';
+import { CjsParameter as _CjsParameter } from './parameter/CjsParameter.js';
 import { ResourceFlags } from './parameter/ITr2EffectValue.js';
 import { Tr2VariableStore as _Tr2VariableStore } from '../core/variable/Tr2VariableStore.js';
 
@@ -41,10 +45,10 @@ function IsTextureLike(value) {
   return typeof value === "object" && value !== null && typeof value.length !== "number" && (typeof value.IsValid === "function" || typeof value.GetTexture === "function");
 }
 
-/**
- * Carbon's overload set, resolved by value (`Tr2Effect.h:93-100`).
- *
- * Each width has its own parameter class, matching Carbon's overload per type.
+/**
+ * Carbon's overload set, resolved by value (`Tr2Effect.h:93-100`).
+ *
+ * Each width has its own parameter class, matching Carbon's overload per type.
  */
 function ParameterClassFor(value) {
   if (typeof value === "number") return _Tr2FloatParameter;
@@ -74,7 +78,7 @@ new class extends _identity {
       } = _applyDecs2311(this, [type.define({
         className: "Tr2Effect",
         family: "shader"
-      })], [[[io, io.notify, void 0, io.rebuild("pipeline"), io, io.always, io, io.persist, type, type.string], 16, "effectFilePath"], [[void 0, io.rebuild("pipeline"), io, io.persist, void 0, type.list("Tr2ShaderOption")], 16, "options"], [[io, io.persist, type, type.string], 16, "name"], [[void 0, io.rebuild("bindings"), io, io.persist, void 0, type.list("Tr2ConstantEffectParameter")], 16, "constParameters"], [[void 0, io.rebuild("bindings"), io, io.persist, void 0, type.list("ITriEffectParameter")], 16, "parameters"], [[void 0, io.rebuild("bindings"), io, io.persist, void 0, type.list("ITriEffectResourceParameter")], 16, "resources"], [[io, io.read, void 0, type.objectRef("Tr2EffectRes")], 16, "effectResource"], [[io, io.read, type, type.string], 16, "actualEffectFilePath"], [[void 0, io.rebuild("bindings"), io, io.persist, void 0, type.list("Tr2SamplerOverride")], 16, "samplerOverrides"], [[carbon, carbon.method, impl, impl.adapted], 18, "RebuildCachedData"], [[carbon, carbon.method, impl, impl.implemented], 18, "RebuildCachedDataAsync"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetVariableStore"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetVariableStore"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetConstParameters"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetHashValue"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetParameterAnnotations"], [[carbon, carbon.method, impl, impl.adapted], 18, "PopulateParameters"], [[carbon, carbon.method, impl, impl.implemented], 18, "EndUpdate"], [[carbon, carbon.method, impl, impl.adapted], 18, "PruneParameters"], [[carbon, carbon.method, impl, impl.implemented], 18, "IsParameterUsedByTechnique"], [[carbon, carbon.method, impl, impl.implemented], 18, "StartUpdate"], [[impl, impl.adapted, void 0, impl.reason("Device-free JS reflection supplies stage signatures in authored order; pass descriptions allocate their map here and sampler states are seeded by the applying context.")], 18, "BuildParametersForPasses", function () {
+      })], [[[edit, edit.notify, edit, edit.persist, type, type.string], 16, "effectFilePath"], [[edit, edit.persist, void 0, type.list("Tr2ShaderOption")], 16, "options"], [[edit, edit.persist, type, type.string], 16, "name"], [[edit, edit.persist, void 0, type.list("Tr2ConstantEffectParameter")], 16, "constParameters"], [[edit, edit.persist, void 0, type.list("ITriEffectParameter")], 16, "parameters"], [[edit, edit.persist, void 0, type.list("ITriEffectResourceParameter")], 16, "resources"], [[edit, edit.read, void 0, type.objectRef("Tr2EffectRes")], 16, "effectResource"], [[edit, edit.read, type, type.string], 16, "actualEffectFilePath"], [[edit, edit.persist, void 0, type.list("Tr2SamplerOverride")], 16, "samplerOverrides"], [[carbon, carbon.method, impl, impl.adapted], 18, "RebuildCachedData"], [[carbon, carbon.method, impl, impl.implemented], 18, "RebuildCachedDataAsync"], [[carbon, carbon.method, impl, impl.implemented], 18, "SetVariableStore"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetVariableStore"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetConstParameters"], [[carbon, carbon.method, impl, impl.adapted], 18, "GetHashValue"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetParameterAnnotations"], [[carbon, carbon.method, impl, impl.adapted], 18, "PopulateParameters"], [[carbon, carbon.method, impl, impl.implemented], 18, "EndUpdate"], [[carbon, carbon.method, impl, impl.adapted], 18, "PruneParameters"], [[carbon, carbon.method, impl, impl.implemented], 18, "IsParameterUsedByTechnique"], [[carbon, carbon.method, impl, impl.implemented], 18, "StartUpdate"], [[impl, impl.adapted, void 0, impl.reason("Device-free JS reflection supplies stage signatures in authored order; pass descriptions allocate their map here and sampler states are seeded by the applying context.")], 18, "BuildParametersForPasses", function () {
         // Carbon's `m_parametersForPasses.clear()` (Tr2Effect.cpp:693) tears down
         // value members: each stage's constant buffer and each pass's resource
         // set die with it. Ours are device objects behind handles, so they are
@@ -133,25 +137,29 @@ new class extends _identity {
           }
           this.parametersForPasses.push(inputs);
         }
-      }], [[carbon, carbon.method, impl, impl.adapted], 18, "SetResourceTexture2D"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("JS explicitly rebuilds the cached CPU effect data after Carbon's Vector4 parameter reuse-or-append policy because plain array mutation has no Blue list notification.")], 18, "SetParameter"]], 0, _ => #BuildParametersForPasses in _, _Tr2Material));
+      }], [[carbon, carbon.method, impl, impl.implemented], 18, "OnListModified"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetResourceTexture2D"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("JS explicitly rebuilds the cached CPU effect data after Carbon's Vector4 parameter reuse-or-append policy because plain array mutation has no Blue list notification.")], 18, "SetParameter"]], 0, _ => #BuildParametersForPasses in _, _Tr2Material));
     }
     #BuildParametersForPasses = _call_BuildParametersForPasses;
     /** m_effectFilePath (std::string) [READWRITE, PERSIST, NOTIFY] */
     effectFilePath = (_initProto(this), _init_effectFilePath(this, ""));
 
     /** m_options (PTr2ShaderOptionStructureList) [READ, PERSIST] */
+
     options = (_init_extra_effectFilePath(this), _init_options(this, []));
 
     /** m_name (std::string) [READWRITE, PERSIST] */
     name = (_init_extra_options(this), _init_name(this, ""));
 
     /** m_constParameters (PTr2ConstantEffectParameterStructureList) [READ, PERSIST] */
+
     constParameters = (_init_extra_name(this), _init_constParameters(this, []));
 
     /** m_parameters (PITriEffectParameterVector) [READ, PERSIST] */
+
     parameters = (_init_extra_constParameters(this), _init_parameters(this, []));
 
     /** m_resources (PITriEffectResourceParameterVector) [READ, PERSIST] */
+
     resources = (_init_extra_parameters(this), _init_resources(this, []));
 
     /** m_effectResource (Tr2EffectResPtr) [READ] */
@@ -161,14 +169,15 @@ new class extends _identity {
     actualEffectFilePath = (_init_extra_effectResource(this), _init_actualEffectFilePath(this, ""));
 
     /** m_samplerOverrides (PTr2SamplerOverrideStructureList) [READ, PERSIST] */
+
     samplerOverrides = (_init_extra_actualEffectFilePath(this), _init_samplerOverrides(this, []));
     parameterHash = (_init_extra_samplerOverrides(this), 0xffffffff);
     display = true;
 
-    /**
-     * Carbon keeps m_variableStore null and falls back to the GLOBAL store at
-     * call time, so a later global-store swap is seen by existing effects.
-     * Read through GetVariableStore(); never capture the global eagerly.
+    /**
+     * Carbon keeps m_variableStore null and falls back to the GLOBAL store at
+     * call time, so a later global-store swap is seen by existing effects.
+     * Read through GetVariableStore(); never capture the global eagerly.
      */
     variableStore = null;
     insideStartUpdate = false;
@@ -178,10 +187,10 @@ new class extends _identity {
       this.RebuildCachedDataInternal();
     }
 
-    /**
-     * The resource-arrival overload: Carbon temporarily clears
-     * insideStartUpdate so a shader arriving during a batched Start/EndUpdate
-     * still rebuilds immediately.
+    /**
+     * The resource-arrival overload: Carbon temporarily clears
+     * insideStartUpdate so a shader arriving during a batched Start/EndUpdate
+     * still rebuilds immediately.
      */
     RebuildCachedDataAsync() {
       const wasInsideStartUpdate = this.insideStartUpdate;
@@ -190,25 +199,25 @@ new class extends _identity {
       this.insideStartUpdate = wasInsideStartUpdate;
     }
 
-    /**
-     * Overrides the store this effect's TriVariableParameter values resolve
-     * against; passing null restores the fallback to the global store.
+    /**
+     * Overrides the store this effect's TriVariableParameter values resolve
+     * against; passing null restores the fallback to the global store.
      */
     SetVariableStore(store) {
       this.variableStore = store ?? null;
     }
 
-    /**
-     * An autoregistered name from whichever global store holds it.
-     *
-     * Carbon's autoregistration IS Tr2VariableStore::GetVariable: a miss
-     * RESERVES the name with the INVALID type, and that reserved variable is the
-     * shared slot the scene fills later - which is how EveSpaceSceneShadowMap
-     * reaches an effect at all. Tr2ShadowMap registers into this same global
-     * store, so a registration and a lookup now meet.
-     *
-     * @param {string} name Variable name.
-     * @returns {object|null} The variable, reserved if it did not exist.
+    /**
+     * An autoregistered name from whichever global store holds it.
+     *
+     * Carbon's autoregistration IS Tr2VariableStore::GetVariable: a miss
+     * RESERVES the name with the INVALID type, and that reserved variable is the
+     * shared slot the scene fills later - which is how EveSpaceSceneShadowMap
+     * reaches an effect at all. Tr2ShadowMap registers into this same global
+     * store, so a registration and a lookup now meet.
+     *
+     * @param {string} name Variable name.
+     * @returns {object|null} The variable, reserved if it did not exist.
      */
 
     /** The effect's store, falling back to the global store at call time. */
@@ -216,33 +225,33 @@ new class extends _identity {
       return this.variableStore ?? _Tr2VariableStore.GlobalStore();
     }
 
-    /**
-     * The authored constant-parameter list itself, not a copy - callers that
-     * mutate it mutate the effect.
+    /**
+     * The authored constant-parameter list itself, not a copy - callers that
+     * mutate it mutate the effect.
      */
     GetConstParameters() {
       return this.constParameters;
     }
 
-    /**
-     * Content hash over the shader path, options, constant parameters, and
-     * every parameter/resource - Carbon's effect dedup/batching key. Only
-     * hashes authored content; values coming from a variable store are not
-     * included. Not lightweight - do not call every frame.
+    /**
+     * Content hash over the shader path, options, constant parameters, and
+     * every parameter/resource - Carbon's effect dedup/batching key. Only
+     * hashes authored content; values coming from a variable store are not
+     * included. Not lightweight - do not call every frame.
      */
     GetHashValue() {
       let hash = 0;
       const path = this.actualEffectFilePath || this.effectFilePath;
       if (path) {
-        hash = CjsParameter.hashFnv1String(path);
+        hash = _CjsParameter.hashFnv1String(path);
       }
       for (const option of this.options) {
-        hash = CjsParameter.hashFnv1String(option?.name ?? "", hash);
-        hash = CjsParameter.hashFnv1String(option?.value ?? "", hash);
+        hash = _CjsParameter.hashFnv1String(option?.name ?? "", hash);
+        hash = _CjsParameter.hashFnv1String(option?.value ?? "", hash);
       }
       for (const parameter of this.constParameters) {
-        hash = CjsParameter.hashFnv1String(parameter?.name ?? "", hash);
-        hash = CjsParameter.hashFnv1Floats(parameter?.value ?? [0, 0, 0, 0], hash);
+        hash = _CjsParameter.hashFnv1String(parameter?.name ?? "", hash);
+        hash = _CjsParameter.hashFnv1Floats(parameter?.value ?? [0, 0, 0, 0], hash);
       }
       for (const parameter of this.parameters) {
         hash = parameter?.GetHashValue?.(hash) ?? hash;
@@ -255,7 +264,7 @@ new class extends _identity {
 
     /** Carbon method GetParameterAnnotations -> PyGetParameterAnnotations (MAP_METHOD). */
     GetParameterAnnotations(parameterName) {
-      return CjsParameter.getEffectAnnotations(this.shader, parameterName);
+      return _CjsParameter.getEffectAnnotations(this.shader, parameterName);
     }
 
     /** Carbon method PopulateParameters (MAP_METHOD_AND_WRAP). */
@@ -303,9 +312,9 @@ new class extends _identity {
       if (!this.shader) {
         return false;
       }
-      this.parameters = this.parameters.filter(parameter => this.#isShaderParameterVisible(CjsParameter.getNamedValue(parameter)));
+      this.parameters = this.parameters.filter(parameter => this.#isShaderParameterVisible(_CjsParameter.getNamedValue(parameter)));
       this.constParameters = this.constParameters.filter(parameter => this.#isShaderParameterVisible(parameter?.name));
-      this.resources = this.resources.filter(parameter => this.#isShaderParameterVisible(CjsParameter.getNamedValue(parameter)));
+      this.resources = this.resources.filter(parameter => this.#isShaderParameterVisible(_CjsParameter.getNamedValue(parameter)));
       return true;
     }
 
@@ -319,13 +328,16 @@ new class extends _identity {
       this.insideStartUpdate = true;
     }
 
-    /**
-     * Attaches every resource to this material, derives actualEffectFilePath from
-     * the authored path, and rebuilds cached shader data.
+    /**
+     * Attaches every resource to this material, derives actualEffectFilePath from
+     * the authored path, and rebuilds cached shader data.
      */
     Initialize() {
       for (const resource of this.resources) {
-        resource?.OnAddedToMaterial?.(this);
+        // Tr2Effect.cpp:378-381 calls straight through the typed list. A cast
+        // here would have no else branch, which makes it a hedge: an entry
+        // lacking the hook would silently do nothing instead of saying so.
+        resource.OnAddedToMaterial(this);
       }
       this.actualEffectFilePath = this.effectFilePath ? _Tr2Effect.convertEffectPath(this.effectFilePath) : "";
       this.#AcquireEffectResource();
@@ -333,43 +345,42 @@ new class extends _identity {
       return true;
     }
 
-    /**
-     * Builds the per-technique, per-pass parameter mapping from the resolved
-     * shader (Carbon `Tr2Effect::RebuildCachedDataInternal`, Tr2Effect.cpp:693-795).
-     *
-     * The outer list is per TECHNIQUE, each holding `passes` and `libraries`.
-     * That is the shape `Tr2Material`'s readers already expect, so this
-     * assembles the existing material models rather than inventing a structure.
-     *
-     * Device work is deliberately absent. Carbon creates a constant buffer, a
-     * resource set and sampler-state objects in this same loop; here only the
-     * CPU mirror is allocated, through `Tr2MaterialStageInput`'s own
-     * `AllocateConstants` / `GetSharedConstantBuffer`, which exist for exactly
-     * this reason. An engine realizes the rest from what is recorded.
-     *
-     * @returns {void}
+    /**
+     * Builds the per-technique, per-pass parameter mapping from the resolved
+     * shader (Carbon `Tr2Effect::RebuildCachedDataInternal`, Tr2Effect.cpp:693-795).
+     *
+     * The outer list is per TECHNIQUE, each holding `passes` and `libraries`.
+     * That is the shape `Tr2Material`'s readers already expect, so this
+     * assembles the existing material models rather than inventing a structure.
+     *
+     * Device work is NOT PORTED. Carbon creates a constant buffer, a resource set
+     * and sampler-state objects in this same loop; here only the CPU mirror is
+     * allocated, through `Tr2MaterialStageInput`'s own `AllocateConstants` /
+     * `GetSharedConstantBuffer`. The rest is unported.
+     *
+     * @returns {void}
      */
 
-    /**
-     * Maps one stage's authored constants onto byte offsets in its CPU mirror
-     * (Carbon `MapPassParameters`, Tr2Effect.cpp:1722-2025).
-     *
-     * `registerIndex` and `registerCount` on a stored parameter are BYTE OFFSET
-     * and BYTE SIZE, not a register index and count. Carbon's field names are
-     * historical and mean something different here than they do for resources.
-     *
-     * Every constant contributes to the buffer size whether or not anything
-     * binds it, because the shader may sample an unbound constant and expect a
-     * default. `GetConstantBufferSize` already carries that rule.
-     *
-     * A stage whose values are entirely static takes a shared, deduplicated
-     * mirror; one with variable parameters gets its own. That split is Carbon's
-     * and it is why `Tr2MaterialStageInput` has both methods.
-     *
-     * @param {object} stage Reflected stage input.
-     * @param {object} stageInput Material stage input to populate.
-     * @param {object} passParameters Owning pass parameters.
-     * @returns {void}
+    /**
+     * Maps one stage's authored constants onto byte offsets in its CPU mirror
+     * (Carbon `MapPassParameters`, Tr2Effect.cpp:1722-2025).
+     *
+     * `registerIndex` and `registerCount` on a stored parameter are BYTE OFFSET
+     * and BYTE SIZE, not a register index and count. Carbon's field names are
+     * historical and mean something different here than they do for resources.
+     *
+     * Every constant contributes to the buffer size whether or not anything
+     * binds it, because the shader may sample an unbound constant and expect a
+     * default. `GetConstantBufferSize` already carries that rule.
+     *
+     * A stage whose values are entirely static takes a shared, deduplicated
+     * mirror; one with variable parameters gets its own. That split is Carbon's
+     * and it is why `Tr2MaterialStageInput` has both methods.
+     *
+     * @param {object} stage Reflected stage input.
+     * @param {object} stageInput Material stage input to populate.
+     * @param {object} passParameters Owning pass parameters.
+     * @returns {void}
      */
     #MapPassParameters(stage, stageInput, passParameters) {
       const constantSize = stage.GetConstantBufferSize?.() ?? 0;
@@ -418,21 +429,21 @@ new class extends _identity {
       }
     }
 
-    /**
-     * Maps a stage's texture or UAV registers onto authored values
-     * (Carbon `MapPassResources`, Tr2Effect.cpp:1436-1489).
-     *
-     * Here `registerIndex` really is the register, and `registerCount` is
-     * overloaded as a flag word carrying only the sRGB bit. Unresolved names
-     * produce no entry, so this vector is sparse where the constant one is not.
-     *
-     * Binding from the effect's own resources or from an effect parameter clears
-     * GDR compatibility, because a general draw cannot know those values.
-     *
-     * @param {Map} resources Register-keyed reflected resources.
-     * @param {Array} into Parameter vector to fill.
-     * @param {object} passParameters Owning pass parameters.
-     * @returns {void}
+    /**
+     * Maps a stage's texture or UAV registers onto authored values
+     * (Carbon `MapPassResources`, Tr2Effect.cpp:1436-1489).
+     *
+     * Here `registerIndex` really is the register, and `registerCount` is
+     * overloaded as a flag word carrying only the sRGB bit. Unresolved names
+     * produce no entry, so this vector is sparse where the constant one is not.
+     *
+     * Binding from the effect's own resources or from an effect parameter clears
+     * GDR compatibility, because a general draw cannot know those values.
+     *
+     * @param {Map} resources Register-keyed reflected resources.
+     * @param {Array} into Parameter vector to fill.
+     * @param {object} passParameters Owning pass parameters.
+     * @returns {void}
      */
     #MapPassResources(resources, into, passParameters) {
       if (!resources || typeof resources.entries !== "function") return;
@@ -465,12 +476,12 @@ new class extends _identity {
       }
     }
 
-    /**
-     * Resolves a named effect resource and records the pass's use of it.
-     *
-     * @param {string} name Constant name.
-     * @param {object} passParameters Owning pass parameters.
-     * @returns {object|null} Resolved value.
+    /**
+     * Resolves a named effect resource and records the pass's use of it.
+     *
+     * @param {string} name Constant name.
+     * @param {object} passParameters Owning pass parameters.
+     * @returns {object|null} Resolved value.
      */
     #ResolveResourceValue(name, passParameters) {
       const resource = this.GetResourceByName(name);
@@ -480,45 +491,44 @@ new class extends _identity {
       return resource;
     }
 
-    /**
-     * Bakes authored constant-parameter values into a stage mirror.
-     *
-     * @param {Uint8Array} mirror Stage constant mirror.
-     * @param {Array} constants Reflected constants.
-     * @param {Array} constParameters Authored constant parameters.
-     * @returns {void}
+    /**
+     * Bakes authored constant-parameter values into a stage mirror.
+     *
+     * @param {Uint8Array} mirror Stage constant mirror.
+     * @param {Array} constants Reflected constants.
+     * @param {Array} constParameters Authored constant parameters.
+     * @returns {void}
      */
 
-    /**
-     * Acquires the effect resource for the resolved path, if a manager is
-     * installed and this effect has not been handed one already.
-     *
-     * Carbon fetches through the process-wide manager and registers a notify
-     * target (`BeResMan->GetResource(...)` then `AddNotifyTarget(this)`,
-     * Tr2Effect.cpp:397-402). That mechanism is not ported: this runtime replaced
-     * notify targets with events, `CjsResource` is a `CjsEventEmitter`, and
-     * nothing in `src` has an `AddNotifyTarget`. The equivalent is subscribing to
-     * the resource's `completed` event through `OnCompleted`, which replays for a
-     * late subscriber - so a resource that is already prepared rebuilds
-     * immediately rather than waiting for a state change that has been and gone.
-     *
-     * The resource owns the subscription, which is what keeps Trinity out of the
-     * lifecycle; `shader.test.js` asserts exactly that by throwing from an
-     * `AddNotifyTarget` on a test resource.
-     *
-     * Does nothing when no manager is installed or the path did not resolve.
-     * Both are real states - a caller composing by hand assigns `effectResource`
-     * itself, and an unresolved path means no backend is committed - and neither
-     * is an error worth throwing during hydration.
-     *
-     * @returns {void}
+    /**
+     * Acquires the effect resource for the resolved path, if a manager is
+     * installed and this effect has not been handed one already.
+     *
+     * Carbon fetches through the process-wide manager and registers a notify
+     * target (`BeResMan->GetResource(...)` then `AddNotifyTarget(this)`,
+     * Tr2Effect.cpp:397-402). That mechanism is not ported: this runtime replaced
+     * notify targets with events, `CjsResource` is a `CjsEventEmitter`, and
+     * nothing in `src` has an `AddNotifyTarget`. The equivalent is subscribing to
+     * the resource's `completed` event through `OnCompleted`, which replays for a
+     * late subscriber - so a resource that is already prepared rebuilds
+     * immediately rather than waiting for a state change that has been and gone.
+     *
+     * The resource owns the subscription, which is what keeps Trinity out of the
+     * lifecycle; `shader.test.js` asserts exactly that by throwing from an
+     * `AddNotifyTarget` on a test resource.
+     *
+     * Does nothing when no manager is installed or the path did not resolve.
+     * Both are real states - a caller composing by hand assigns `effectResource`
+     * itself, and an unresolved path means no backend is committed - and neither
+     * is an error worth throwing during hydration.
+     *
+     * @returns {void}
      */
     #AcquireEffectResource() {
-      const resourceManager = CjsResMan.GetGlobal();
-      if (!resourceManager || !this.actualEffectFilePath) return;
+      if (!this.actualEffectFilePath) return;
       // A caller that assigned a resource by hand owns it; do not replace it.
       if (this.effectResource !== null) return;
-      const resource = resourceManager.GetResource(this.actualEffectFilePath, {
+      const resource = blue.resMan.GetResource(this.actualEffectFilePath, {
         requirement: ResourceRequirement.SHADER
       });
       this.effectResource = resource;
@@ -534,29 +544,36 @@ new class extends _identity {
       return true;
     }
 
-    /**
-     * Keeps list membership consistent: a removed entry has its reroute
-     * destination cleared and is detached from the material, an inserted one is
-     * attached, and cached data is rebuilt either way.
+    /**
+     * Keeps list membership consistent: a removed entry has its reroute
+     * destination cleared and is detached from the material, an inserted one is
+     * attached, and cached data is rebuilt either way.
      */
     OnListModified(event, _key, _key2, value) {
-      if (value?.SetDestination && String(event).includes("REMOVED")) {
-        value.SetDestination(null, 0);
-      }
-      if (value?.OnRemovedFromMaterial && String(event).includes("REMOVED")) {
-        value.OnRemovedFromMaterial(this);
-      }
-      if (value?.OnAddedToMaterial && String(event).includes("INSERTED")) {
-        value.OnAddedToMaterial(this);
+      if (event & BLUELISTEVENT.BELIST_LOADING) return;
+      const kind = event & BLUELISTEVENT.BELIST_EVENTMASK;
+      // Tr2Effect.cpp:905-928 asks the value what it is rather than what it
+      // answers to: ITriReroutable for the destination clear, then
+      // ITriEffectResourceParameter for the material hooks.
+      const resource = CjsSchema.cast(value, ITriEffectResourceParameter);
+      if (kind === BLUELISTEVENT.BELIST_REMOVED) {
+        const reroutable = CjsSchema.cast(value, ITriReroutable);
+        if (reroutable) reroutable.SetDestination(null, 0);
+        if (resource) resource.OnRemovedFromMaterial(this);
+      }
+      if (resource && kind === BLUELISTEVENT.BELIST_INSERTED) {
+        resource.OnAddedToMaterial(this);
+      }
+      if (kind === BLUELISTEVENT.BELIST_REMOVED || kind === BLUELISTEVENT.BELIST_INSERTED || kind === BLUELISTEVENT.BELIST_SWAPPED || kind === BLUELISTEVENT.BELIST_MOVED) {
+        this.RebuildCachedDataInternal();
       }
-      this.RebuildCachedDataInternal();
     }
 
-    /**
-     * Re-resolves the shader for the current option set and re-binds every
-     * parameter and resource to it, rebuilding the screen-size LOD texture list on
-     * the way; a no-op while a StartUpdate batch is open. Resolves shader metadata
-     * only - no GPU program is created.
+    /**
+     * Re-resolves the shader for the current option set and re-binds every
+     * parameter and resource to it, rebuilding the screen-size LOD texture list on
+     * the way; a no-op while a StartUpdate batch is open. Resolves shader metadata
+     * only - no GPU program is created.
      */
     RebuildCachedDataInternal() {
       if (this.insideStartUpdate) {
@@ -598,9 +615,9 @@ new class extends _identity {
       }
     }
 
-    /**
-     * Drops the resolved shader and clears every parameter's and resource's effect
-     * handles by rebuilding them against null.
+    /**
+     * Drops the resolved shader and clears every parameter's and resource's effect
+     * handles by rebuilding them against null.
      */
     ReleaseCachedData() {
       this.shader = null;
@@ -613,9 +630,9 @@ new class extends _identity {
       this.lodTextureParameters = [];
     }
 
-    /**
-     * Sets the authored effect path through SetValues so the pipeline rebuild flag
-     * fires; returns whether anything changed.
+    /**
+     * Sets the authored effect path through values transport. Equal writes still
+     * initialize; the return value reports whether the path changed.
      */
     SetEffectPathName(path) {
       return this.SetValues({
@@ -626,17 +643,17 @@ new class extends _identity {
       });
     }
 
-    /**
-     * The authored path, not the slash-normalized actualEffectFilePath that
-     * Initialize derives from it.
+    /**
+     * The authored path, not the slash-normalized actualEffectFilePath that
+     * Initialize derives from it.
      */
     GetEffectPathName() {
       return this.effectFilePath;
     }
 
-    /**
-     * The effect resource the shader is resolved from, or null before one has been
-     * assigned.
+    /**
+     * The effect resource the shader is resolved from, or null before one has been
+     * assigned.
      */
     GetEffectRes() {
       return this.effectResource;
@@ -647,34 +664,45 @@ new class extends _identity {
       return this.name;
     }
 
-    /**
-     * Appends a resource parameter, attaches it to this material and rebuilds
-     * cached data; does not check for a duplicate name and always returns true.
+    /**
+     * Appends a resource parameter, attaches it to this material and rebuilds
+     * cached data; does not check for a duplicate name and always returns true.
      */
     AddResource(parameter) {
+      // Carbon's signature takes ITriEffectParameter* (h:84) but appends to a
+      // list typed to resource parameters, so a non-resource parameter cannot
+      // reach the list at all. Refuse it at the door rather than pushing first
+      // and attaching after: a failed attach used to leave the parameter in the
+      // list permanently unhooked, which is a half-state, not a failure.
+      const resource = CjsSchema.cast(parameter, ITriEffectResourceParameter);
+      if (!resource) {
+        throw new TypeError("Tr2Effect.AddResource requires an ITriEffectResourceParameter.");
+      }
       this.resources.push(parameter);
-      parameter?.OnAddedToMaterial?.(this);
+      // The push fires no list event, so this stands in for the INSERTED arm
+      // that would have run (Tr2Effect.cpp:922-925).
+      resource.OnAddedToMaterial(this);
       this.RebuildCachedDataInternal();
       return true;
     }
 
-    /**
-     * Creates and attaches a TriTextureParameter for the name, returning false
-     * when a resource already uses that name.
+    /**
+     * Creates and attaches a TriTextureParameter for the name, returning false
+     * when a resource already uses that name.
      */
     AddResourceTexture2D(name, resourcePath = "") {
       if (this.GetResourceByName(name)) {
         return false;
       }
       const parameter = new _TriTextureParameter();
-      parameter.SetParameterName?.(name);
-      parameter.SetResourcePath?.(resourcePath);
+      parameter.SetParameterName(name);
+      parameter.SetResourcePath(resourcePath);
       return this.AddResource(parameter);
     }
 
-    /**
-     * Carbon's SetResourceTexture2D - assigns the texture path on the named
-     * resource, creating the TriTextureParameter when absent.
+    /**
+     * Carbon's SetResourceTexture2D - assigns the texture path on the named
+     * resource, creating the TriTextureParameter when absent.
      */
     SetResourceTexture2D(name, resourcePath = "") {
       const updated = this.#setNamedTexture(name, resourcePath);
@@ -684,10 +712,10 @@ new class extends _identity {
       return updated;
     }
 
-    /**
-     * Adds a sampler override for the named resource using Carbon's authoring
-     * defaults for the fields not passed in (addressW 1, filter 3, mipFilter 2);
-     * returns false when an override of that name already exists.
+    /**
+     * Adds a sampler override for the named resource using Carbon's authoring
+     * defaults for the fields not passed in (addressW 1, filter 3, mipFilter 2);
+     * returns false when an override of that name already exists.
      */
     AddSamplerOverride(name, addressU = 1, addressV = addressU) {
       if (this.HasSamplerOverride(name)) {
@@ -705,10 +733,10 @@ new class extends _identity {
       return true;
     }
 
-    /**
-     * Adds an authored constant parameter, cloning the value so the caller's
-     * vector is not aliased; returns false when a constant of that name already
-     * exists.
+    /**
+     * Adds an authored constant parameter, cloning the value so the caller's
+     * vector is not aliased; returns false when a constant of that name already
+     * exists.
      */
     AddParameterVector4(name, value = vec4.create()) {
       if (this.HasParameter(name)) {
@@ -722,26 +750,26 @@ new class extends _identity {
       return true;
     }
 
-    /**
-     * Adds a constant parameter with the scalar splatted across all four
-     * components, matching Carbon's float authoring.
+    /**
+     * Adds a constant parameter with the scalar splatted across all four
+     * components, matching Carbon's float authoring.
      */
     AddParameterFloat(name, value = 0) {
       return this.AddParameterVector4(name, vec4.fromValues(value, value, value, value));
     }
 
-    /**
-     * Adds a constant parameter from a colour vector; behaviourally identical to
-     * AddParameterVector4.
+    /**
+     * Adds a constant parameter from a colour vector; behaviourally identical to
+     * AddParameterVector4.
      */
     AddParameterColor(name, value) {
       return this.AddParameterVector4(name, value);
     }
 
-    /**
-     * JS convenience over the Carbon lists: the effect collections also accept
-     * unique-name plain-object maps. Canonical arrays keep the inherited
-     * CjsModel path untouched; `textures` is an input alias for `resources`.
+    /**
+     * JS convenience over the Carbon lists: the effect collections also accept
+     * unique-name plain-object maps. Canonical arrays keep the inherited
+     * CjsModel path untouched; `textures` is an input alias for `resources`.
      */
     SetValues(values = {}, options = {}) {
       const source = values && typeof values === "object" ? values : {};
@@ -772,10 +800,10 @@ new class extends _identity {
       return options?.returnBoolean === true ? changed.size > 0 : changed;
     }
 
-    /**
-     * Merges dynamic parameters by unique name. Values may be raw
-     * (number/vector/matrix/res path string) or explicit `{ type, ... }`
-     * descriptors; `null` removes. Texture values route to `resources`.
+    /**
+     * Merges dynamic parameters by unique name. Values may be raw
+     * (number/vector/matrix/res path string) or explicit `{ type, ... }`
+     * descriptors; `null` removes. Texture values route to `resources`.
      */
     SetParameters(values = {}) {
       let updated = false;
@@ -796,9 +824,9 @@ new class extends _identity {
       return updated;
     }
 
-    /**
-     * Sets one named dynamic parameter. Carbon exposes this singular facade and
-     * smart-light meshes use it while stamping their resolved group color.
+    /**
+     * Sets one named dynamic parameter. Carbon exposes this singular facade and
+     * smart-light meshes use it while stamping their resolved group color.
      */
     SetParameter(name, value, uavMipLevel = 0) {
       const parameterName = String(name ?? "");
@@ -813,7 +841,7 @@ new class extends _identity {
       if (!Parameter) {
         throw new TypeError(`Tr2Effect.SetParameter: no Carbon overload takes ${describe(value)} for "${parameterName}"`);
       }
-      const existing = CjsParameter.findByName(this.parameters, parameterName);
+      const existing = _CjsParameter.findByName(this.parameters, parameterName);
       let parameter = existing instanceof Parameter ? existing : null;
       if (!parameter) {
         // A same-name parameter of the WRONG TYPE is left in place and a new one
@@ -867,9 +895,9 @@ new class extends _identity {
       return updated;
     }
 
-    /**
-     * Merges authored constant parameters by unique name. Numbers splat to a
-     * vec4, matching Carbon's AddParameterFloat authoring behavior.
+    /**
+     * Merges authored constant parameters by unique name. Numbers splat to a
+     * vec4, matching Carbon's AddParameterFloat authoring behavior.
      */
     SetConstParameters(values = {}) {
       let updated = false;
@@ -884,7 +912,7 @@ new class extends _identity {
         if (!vector) {
           throw new TypeError(`Tr2Effect.SetConstParameters cannot read a vec4 value for "${name}".`);
         }
-        const existing = CjsParameter.findByName(this.constParameters, name);
+        const existing = _CjsParameter.findByName(this.constParameters, name);
         if (existing) {
           vec4.copy(existing.value, vector);
         } else {
@@ -911,7 +939,7 @@ new class extends _identity {
           updated = this.#removeNamed(this.samplerOverrides, name) || updated;
           continue;
         }
-        const existing = CjsParameter.findByName(this.samplerOverrides, name);
+        const existing = _CjsParameter.findByName(this.samplerOverrides, name);
         if (value instanceof _Tr2SamplerOverride) {
           if (!value.name) {
             value.name = String(name);
@@ -946,10 +974,10 @@ new class extends _identity {
       return updated;
     }
 
-    /**
-     * Creates a parameter model from a raw value using the class-declared
-     * isValue claims, or from an explicit `{ type, ... }` descriptor.
-     * Returns null when no registered parameter class claims the value.
+    /**
+     * Creates a parameter model from a raw value using the class-declared
+     * isValue claims, or from an explicit `{ type, ... }` descriptor.
+     * Returns null when no registered parameter class claims the value.
      */
     static CreateParameterFromValue(name, value) {
       if (value && typeof value === "object" && !Array.isArray(value) && !ArrayBuffer.isView(value)) {
@@ -965,7 +993,7 @@ new class extends _identity {
         } = value;
         const parameter = new ExplicitClass();
         parameter.SetValues(fields);
-        if (name && !CjsParameter.getNamedValue(parameter)) {
+        if (name && !_CjsParameter.getNamedValue(parameter)) {
           parameter.SetValues({
             name: String(name)
           });
@@ -992,34 +1020,34 @@ new class extends _identity {
       return null;
     }
 
-    /**
-     * Removes the named entry from one of the effect's collections, detaching it
-     * from the material first when the list is `resources`; returns whether
-     * anything was removed.
+    /**
+     * Removes the named entry from one of the effect's collections, detaching it
+     * from the material first when the list is `resources`; returns whether
+     * anything was removed.
      */
     #removeNamed(list, name) {
-      const existing = CjsParameter.findByName(list, name);
+      const existing = _CjsParameter.findByName(list, name);
       if (!existing) {
         return false;
       }
       if (list === this.resources) {
-        existing?.OnRemovedFromMaterial?.(this);
+        existing.OnRemovedFromMaterial(this);
       }
       list.splice(list.indexOf(existing), 1);
       return true;
     }
 
-    /**
-     * Assigns a dynamic parameter by name, reusing the existing model when its
-     * class claims the value and otherwise creating one and replacing the old
-     * entry; string values route to the texture resource list instead. Throws
-     * TypeError when no registered parameter class can represent the value.
+    /**
+     * Assigns a dynamic parameter by name, reusing the existing model when its
+     * class claims the value and otherwise creating one and replacing the old
+     * entry; string values route to the texture resource list instead. Throws
+     * TypeError when no registered parameter class can represent the value.
      */
     #setNamedParameter(name, value) {
       if (typeof value === "string") {
         return this.#setNamedTexture(name, value);
       }
-      const existing = CjsParameter.findByName(this.parameters, name);
+      const existing = _CjsParameter.findByName(this.parameters, name);
       if (existing && existing.constructor.isValue?.(value)) {
         existing.SetValue(value);
         return true;
@@ -1028,15 +1056,15 @@ new class extends _identity {
       if (!created) {
         throw new TypeError(`Tr2Effect.SetParameters cannot infer a parameter type for "${name}".`);
       }
-      if (created instanceof _TriTextureParameter) {
-        const existingResource = CjsParameter.findByName(this.resources, name);
+      if (CjsSchema.cast(created, _TriTextureParameter)) {
+        const existingResource = _CjsParameter.findByName(this.resources, name);
         if (existingResource) {
-          existingResource?.OnRemovedFromMaterial?.(this);
+          existingResource.OnRemovedFromMaterial(this);
           this.resources[this.resources.indexOf(existingResource)] = created;
         } else {
           this.resources.push(created);
         }
-        created?.OnAddedToMaterial?.(this);
+        created.OnAddedToMaterial(this);
         return true;
       }
       if (existing) {
@@ -1047,50 +1075,44 @@ new class extends _identity {
       return true;
     }
 
-    /**
-     * Points the named texture resource at a res path, creating and attaching a
-     * TriTextureParameter when absent; returns false when the path is already that
-     * value, and throws TypeError for non-string values.
+    /**
+     * Points the named texture resource at a res path, creating and attaching a
+     * TriTextureParameter when absent; returns false when the path is already that
+     * value, and throws TypeError for non-string values.
      */
     #setNamedTexture(name, value) {
       if (typeof value !== "string") {
         throw new TypeError(`Tr2Effect.SetTextures requires res path strings for "${name}".`);
       }
-      const existing = CjsParameter.findByName(this.resources, name);
-      if (existing) {
-        if (existing.resourcePath === value) {
+      // Tr2Effect.cpp:2257-2268 casts, and a resource that is not a texture
+      // parameter falls through to AddResourceTexture2D, which refuses a name
+      // already taken - so a non-texture resource of that name is a no-op.
+      const texture = CjsSchema.cast(this.GetResourceByName(name), _TriTextureParameter);
+      if (texture) {
+        if (texture.resourcePath === value) {
           return false;
         }
-        if (existing.SetResourcePath) {
-          existing.SetResourcePath(value);
-        } else {
-          existing.resourcePath = value;
-        }
+        texture.SetResourcePath(value);
         return true;
       }
-      const parameter = new _TriTextureParameter();
-      parameter.SetParameterName?.(name);
-      parameter.SetResourcePath?.(value);
-      this.resources.push(parameter);
-      parameter?.OnAddedToMaterial?.(this);
-      return true;
+      return this.AddResourceTexture2D(name, value);
     }
 
-    /**
-     * Resolves a descriptor's `Type`/`type`/`_type` field to a parameter
-     * constructor, directly or through the schema registry; returns null when no
-     * type field is present and throws TypeError for an unregistered class name.
+    /**
+     * Resolves a descriptor's `Type`/`type`/`_type` field to a parameter
+     * constructor, directly or through the schema registry; returns null when no
+     * type field is present and throws TypeError for an unregistered class name.
      */
 
-    /**
-     * Coerces a number (splatted to all four components), a four-number array, or
-     * a `{ value }` wrapper into a new vec4; returns null when no vec4 can be
-     * read.
+    /**
+     * Coerces a number (splatted to all four components), a four-number array, or
+     * a `{ value }` wrapper into a new vec4; returns null when no vec4 can be
+     * read.
      */
 
-    /**
-     * Empties both the constant and dynamic parameter lists inside one
-     * StartUpdate/EndUpdate batch, so cached data rebuilds once at the end.
+    /**
+     * Empties both the constant and dynamic parameter lists inside one
+     * StartUpdate/EndUpdate batch, so cached data rebuilds once at the end.
      */
     ClearAllParameters() {
       this.StartUpdate();
@@ -1099,25 +1121,26 @@ new class extends _identity {
       this.EndUpdate();
     }
 
-    /**
-     * Detaches every resource from this material and empties the resource list,
-     * then rebuilds cached data.
+    /**
+     * Detaches every resource from this material and empties the resource list,
+     * then rebuilds cached data.
      */
     ClearAllResources() {
       for (const resource of this.resources) {
-        resource?.OnRemovedFromMaterial?.(this);
+        // Tr2Effect.cpp:270-273 calls through the typed list, as above.
+        resource.OnRemovedFromMaterial(this);
       }
       this.resources = [];
       this.RebuildCachedDataInternal();
     }
 
-    /**
-     * Sets a shader option, adding it when absent; cached data is rebuilt only
-     * when the value actually changes, since options select the shader
-     * permutation.
+    /**
+     * Sets a shader option, adding it when absent; cached data is rebuilt only
+     * when the value actually changes, since options select the shader
+     * permutation.
      */
     SetOption(name, value) {
-      const existing = CjsParameter.findByName(this.options, name);
+      const existing = _CjsParameter.findByName(this.options, name);
       if (existing) {
         if (existing.value !== value) {
           existing.value = String(value);
@@ -1132,9 +1155,9 @@ new class extends _identity {
       this.RebuildCachedDataInternal();
     }
 
-    /**
-     * Drops the named option so the shader resolves with its default permutation
-     * again.
+    /**
+     * Drops the named option so the shader resolves with its default permutation
+     * again.
      */
     ResetOption(name) {
       this.options = this.options.filter(option => option?.name !== name);
@@ -1143,28 +1166,28 @@ new class extends _identity {
 
     /** The option's value, or the empty string when the option is not set. */
     GetOption(name) {
-      return CjsParameter.findByName(this.options, name)?.value ?? "";
+      return _CjsParameter.findByName(this.options, name)?.value ?? "";
     }
 
-    /**
-     * Looks the name up in the dynamic parameters first, then the resources;
-     * authored constant parameters are not searched.
+    /**
+     * Looks the name up in the dynamic parameters first, then the resources;
+     * authored constant parameters are not searched.
      */
     GetParameterByName(name) {
       return this.FindParameterByName(name) ?? this.GetResourceByName(name);
     }
 
-    /**
-     * The dynamic parameter with this shader name, or null; resources and constant
-     * parameters are not consulted.
+    /**
+     * The dynamic parameter with this shader name, or null; resources and constant
+     * parameters are not consulted.
      */
     FindParameterByName(name) {
-      return this.parameters.find(parameter => CjsParameter.getNamedValue(parameter) === name) ?? null;
+      return this.parameters.find(parameter => _CjsParameter.getNamedValue(parameter) === name) ?? null;
     }
 
     /** The resource parameter with this shader name, or null. */
     GetResourceByName(name) {
-      return this.resources.find(parameter => CjsParameter.getNamedValue(parameter) === name) ?? null;
+      return this.resources.find(parameter => _CjsParameter.getNamedValue(parameter) === name) ?? null;
     }
 
     /** Whether a sampler override is authored for this resource name. */
@@ -1172,25 +1195,25 @@ new class extends _identity {
       return this.samplerOverrides.some(value => value?.name === name);
     }
 
-    /**
-     * Whether an authored constant parameter uses this name; dynamic parameters
-     * and resources do not count.
+    /**
+     * Whether an authored constant parameter uses this name; dynamic parameters
+     * and resources do not count.
      */
     HasParameter(name) {
       return this.constParameters.some(value => value?.name === name);
     }
 
-    /**
-     * Whether any collection - parameters, resources or constant parameters -
-     * already claims the name; the duplicate guard PopulateParameters uses.
+    /**
+     * Whether any collection - parameters, resources or constant parameters -
+     * already claims the name; the duplicate guard PopulateParameters uses.
      */
     #hasParameterLike(name) {
       return !!(this.GetParameterByName(name) || this.HasParameter(name));
     }
 
-    /**
-     * Whether the resolved shader both marks the name SasUiVisible and exposes it
-     * as a constant or resource; the predicate PruneParameters filters on.
+    /**
+     * Whether the resolved shader both marks the name SasUiVisible and exposes it
+     * as a constant or resource; the predicate PruneParameters filters on.
      */
     #isShaderParameterVisible(name) {
       if (!name) {
@@ -1200,26 +1223,26 @@ new class extends _identity {
       return _Tr2Effect.getBool(shader, name, "SasUiVisible", false) && !!(shader.GetConstant(name) || shader.GetResource(name));
     }
 
-    /**
-     * Resolves an authored effect path to the compiled path a backend loads.
-     *
-     * Carbon's `ConvertEffectPath` (Tr2Effect.cpp:309-370) does three things:
-     * lowercases, substitutes `/effect/` for `/effect.<platform>/`, and replaces
-     * the extension with the shader-model suffix. This did only the first half of
-     * the first one - a backslash swap - so `actualEffectFilePath` still ended in
-     * `.fx` and no extension route could ever match it.
-     *
-     * Carbon returns false when it cannot substitute, and `Initialize` then
-     * blanks the path rather than fetching. The same happens here: with no
-     * platform name installed there is no committed backend, so an authored
-     * `/effect/*.fx` has no compiled tree to resolve into and yields "". The
-     * resolver itself throws in that case by design, and that loud failure is
-     * right for a caller that named a path deliberately; it is wrong for
-     * hydration, which may build an effect long before a backend exists.
-     *
-     * @param {string} path Authored effect path.
-     * @param {object} [options] Overrides for the installed configuration.
-     * @returns {string} Compiled path, or "" when none can be resolved.
+    /**
+     * Resolves an authored effect path to the compiled path a backend loads.
+     *
+     * Carbon's `ConvertEffectPath` (Tr2Effect.cpp:309-370) does three things:
+     * lowercases, substitutes `/effect/` for `/effect.<platform>/`, and replaces
+     * the extension with the shader-model suffix. This did only the first half of
+     * the first one - a backslash swap - so `actualEffectFilePath` still ended in
+     * `.fx` and no extension route could ever match it.
+     *
+     * Carbon returns false when it cannot substitute, and `Initialize` then
+     * blanks the path rather than fetching. The same happens here: with no
+     * platform name installed there is no committed backend, so an authored
+     * `/effect/*.fx` has no compiled tree to resolve into and yields "". The
+     * resolver itself throws in that case by design, and that loud failure is
+     * right for a caller that named a path deliberately; it is wrong for
+     * hydration, which may build an effect long before a backend exists.
+     *
+     * @param {string} path Authored effect path.
+     * @param {object} [options] Overrides for the installed configuration.
+     * @returns {string} Compiled path, or "" when none can be resolved.
      */
     static convertEffectPath(path, options = {}) {
       const authored = String(path ?? "");
@@ -1237,8 +1260,8 @@ new class extends _identity {
       });
     }
 
-    /**
-     * Flattens a canonical shader's technique/pass tree into stage inputs.
+    /**
+     * Flattens a canonical shader's technique/pass tree into stage inputs.
      */
     static iterateShaderStages(shader) {
       const stages = [];
@@ -1251,8 +1274,8 @@ new class extends _identity {
       return stages;
     }
 
-    /**
-     * Returns a canonical stage resource map's descriptions in iteration order.
+    /**
+     * Returns a canonical stage resource map's descriptions in iteration order.
      */
     static iterateResources(values) {
       if (!(values instanceof Map)) {
@@ -1261,9 +1284,9 @@ new class extends _identity {
       return [...values.values()];
     }
 
-    /**
-     * Reads a boolean shader annotation off a parameter, tolerating Map/array/object annotation containers and the several value field names reflection data uses.
-     * @returns {boolean} defaultValue when the annotation is absent
+    /**
+     * Reads a boolean shader annotation off a parameter, tolerating Map/array/object annotation containers and the several value field names reflection data uses.
+     * @returns {boolean} defaultValue when the annotation is absent
      */
     static getBool(shader, parameterName, annotationName, defaultValue = false) {
       const annotations = requireShader(shader).GetParameterAnnotations(parameterName);
@@ -1275,12 +1298,12 @@ new class extends _identity {
       return Boolean(annotation.boolValue ?? annotation.value ?? annotation.booleanValue ?? defaultValue);
     }
 
-    /**
-     * Builds the parameter model matching a reflected shader constant - float
-     * array, matrix, vector or scalar - seeded with the shader-authored defaults;
-     * a 16-component constant whose name contains `Reflection` becomes an
-     * EnvMapTransform variable parameter instead. Returns null for non-FLOAT
-     * constants, which Carbon does not surface as parameters.
+    /**
+     * Builds the parameter model matching a reflected shader constant - float
+     * array, matrix, vector or scalar - seeded with the shader-authored defaults;
+     * a 16-component constant whose name contains `Reflection` becomes an
+     * EnvMapTransform variable parameter instead. Returns null for non-FLOAT
+     * constants, which Carbon does not surface as parameters.
      */
     static convertEffectConstant(constant, constantValues) {
       // Carbon only populates parameters for FLOAT constants; INT/UINT/BOOL
@@ -1341,14 +1364,14 @@ new class extends _identity {
       return parameter;
     }
 
-    /**
-     * Builds a TriTextureParameter for texture resources and a
-     * Tr2GeometryBufferParameter for everything else.
+    /**
+     * Builds a TriTextureParameter for texture resources and a
+     * Tr2GeometryBufferParameter for everything else.
      */
     static convertEffectResource(resource) {
       if (_Tr2Effect.isTextureResource(resource)) {
         const parameter = new _TriTextureParameter();
-        parameter.SetParameterName?.(resource.name ?? "");
+        parameter.SetParameterName(resource.name ?? "");
         return parameter;
       }
       const parameter = new _Tr2GeometryBufferPar();
@@ -1356,10 +1379,10 @@ new class extends _identity {
       return parameter;
     }
 
-    /**
-     * Classifies a reflected resource as a texture: string types containing
-     * TEXTURE but not BUFFER, or numeric types 1..5 (TEXTURE_1D through
-     * TEXTURE_TYPELESS); buffer types start at 6.
+    /**
+     * Classifies a reflected resource as a texture: string types containing
+     * TEXTURE but not BUFFER, or numeric types 1..5 (TEXTURE_1D through
+     * TEXTURE_TYPELESS); buffer types start at 6.
      */
     static isTextureResource(resource) {
       const type = resource?.type;
@@ -1371,10 +1394,10 @@ new class extends _identity {
       return Number(type) >= 1 && Number(type) <= 5;
     }
 
-    /**
-     * Reads a constant's shader-authored default scalar, preferring an inline
-     * value and otherwise a little-endian float32 at the constant's offset into
-     * the stage's constantValues; 0 when neither is available.
+    /**
+     * Reads a constant's shader-authored default scalar, preferring an inline
+     * value and otherwise a little-endian float32 at the constant's offset into
+     * the stage's constantValues; 0 when neither is available.
      */
     static readScalar(constant, values) {
       if (typeof constant.value === "number") {
@@ -1389,10 +1412,10 @@ new class extends _identity {
       return 0;
     }
 
-    /**
-     * Reads the shader-authored default components for a constant into the
-     * parameter's value slot (Carbon reads them straight from constantValues
-     * at the constant's offset). Missing data leaves the class default.
+    /**
+     * Reads the shader-authored default components for a constant into the
+     * parameter's value slot (Carbon reads them straight from constantValues
+     * at the constant's offset). Missing data leaves the class default.
      */
     static readComponents(out, constant, values, count) {
       if (constant.value && typeof constant.value.length === "number") {
@@ -1413,10 +1436,10 @@ new class extends _identity {
       return out;
     }
 
-    /**
-     * Reads the shader-authored default vec4 for one element of a constant out of the stage's constantValues (16 bytes per element), or from the constant's inline value when it has one.
-     * @param element zero-based array element index; ignored when the constant carries an inline value
-     * @returns {vec4} a newly allocated vector; components outside the buffer stay 0
+    /**
+     * Reads the shader-authored default vec4 for one element of a constant out of the stage's constantValues (16 bytes per element), or from the constant's inline value when it has one.
+     * @param element zero-based array element index; ignored when the constant carries an inline value
+     * @returns {vec4} a newly allocated vector; components outside the buffer stay 0
      */
     static readVector4(constant, values, element) {
       if (constant.value && typeof constant.value.length === "number") {
@@ -1466,7 +1489,7 @@ new class extends _identity {
     if (typeof value === "number") {
       return vec4.fromValues(value, value, value, value);
     }
-    if (CjsParameter.isNumberArrayValue(value, 4)) {
+    if (_CjsParameter.isNumberArrayValue(value, 4)) {
       return vec4.clone(value);
     }
     if (value && typeof value === "object" && !Array.isArray(value) && "value" in value) {