@carbonenginejs/runtime-trinity 0.4.3 → 0.5.0

package/dist/eve/scene/EveSpaceScene.js

@@ -1,18 +1,77 @@
 import { identity as _identity, applyDecs2311 as _applyDecs2311 } from '../../_virtual/_rollupPluginBabelHelpers.js';
 import { io, type, carbon, impl, schema } from '@carbonenginejs/core-types/schema';
 import { CjsModel } from '@carbonenginejs/core-types/model';
+import { mat4 } from '@carbonenginejs/core-math/mat4';
 import { quat } from '@carbonenginejs/core-math/quat';
 import { vec3 } from '@carbonenginejs/core-math/vec3';
 import { vec4 } from '@carbonenginejs/core-math/vec4';
 import { EveEntity as _EveEntity } from '../../generated/eve/EveEntity.js';
 import { EveComponentRegistry as _EveComponentRegistry } from '../../generated/eve/scene/EveComponentRegistry.js';
+import { Tr2PostProcess2 as _Tr2PostProcess } from '../../postProcess/Tr2PostProcess2.js';
+import { Tr2PostProcessAttributes as _Tr2PostProcessAttrib } from '../../postProcess/Tr2PostProcessAttributes.js';
+import { EveComponentType } from '../EveComponentTypes.js';
 import { EveUpdateContext as _EveUpdateContext } from '../EveUpdateContext.js';
+import { EveEffectRoot2 as _EveEffectRoot } from '../spaceObject/EveEffectRoot2.js';
 
 let _initProto, _initClass, _init_visualizeMethod, _init_extra_visualizeMethod, _init_envMap1ResPath, _init_extra_envMap1ResPath, _init_envMap2ResPath, _init_extra_envMap2ResPath, _init_envMap3ResPath, _init_extra_envMap3ResPath, _init_lowQualityNebulaResPath, _init_extra_lowQualityNebulaResPath, _init_lowQualityNebulaMixResPath, _init_extra_lowQualityNebulaMixResPath, _init_envMapResPath, _init_extra_envMapResPath, _init_fogColor, _init_extra_fogColor, _init_sunDirection, _init_extra_sunDirection, _init_ambientColor, _init_extra_ambientColor, _init_shLightingManager, _init_extra_shLightingManager, _init_combinedPostProcessAttributes, _init_extra_combinedPostProcessAttributes, _init_dataTextureMgr, _init_extra_dataTextureMgr, _init_dynamicObjectReflectionEnabled, _init_extra_dynamicObjectReflectionEnabled, _init_componentRegistry, _init_extra_componentRegistry, _init_cameraAttachmentParent, _init_extra_cameraAttachmentParent, _init_postProcessDebug, _init_extra_postProcessDebug, _init_curveSets, _init_extra_curveSets, _init_defaultDiffuseRoughness, _init_extra_defaultDiffuseRoughness, _init_fogStart, _init_extra_fogStart, _init_fogEnd, _init_extra_fogEnd, _init_reflectionIntensity, _init_extra_reflectionIntensity, _init_distanceFields, _init_extra_distanceFields, _init_backgroundEffect, _init_extra_backgroundEffect, _init_backgroundReflectionIntensity, _init_extra_backgroundReflectionIntensity, _init_nebulaIntensity, _init_extra_nebulaIntensity, _init_display, _init_extra_display, _init_backgroundRenderingEnabled, _init_extra_backgroundRenderingEnabled, _init_update, _init_extra_update, _init_impostorManager, _init_extra_impostorManager, _init_lensflares, _init_extra_lensflares, _init_externalParameters, _init_extra_externalParameters, _init_fogMax, _init_extra_fogMax, _init_staticParticles, _init_extra_staticParticles, _init_debugRenderer, _init_extra_debugRenderer, _init_objects, _init_extra_objects, _init_uiObjects, _init_extra_uiObjects, _init_backgroundObjects, _init_extra_backgroundObjects, _init_planets, _init_extra_planets, _init_raytracingManager, _init_extra_raytracingManager, _init_reflectionBackLightingColor, _init_extra_reflectionBackLightingColor, _init_reflectionBackLightingContrast, _init_extra_reflectionBackLightingContrast, _init_reflectionProbe, _init_extra_reflectionProbe, _init_volumetricsRenderer, _init_extra_volumetricsRenderer, _init_starfield, _init_extra_starfield, _init_planetScale, _init_extra_planetScale, _init_planetCameraScale, _init_extra_planetCameraScale, _init_subSurfaceScattering, _init_extra_subSurfaceScattering, _init_shadowQualitySetting, _init_extra_shadowQualitySetting, _init_sunDiffuseColor, _init_extra_sunDiffuseColor, _init_sunDiffuseColorWithDynamicLights, _init_extra_sunDiffuseColorWithDynamicLights, _init_envMapRotation, _init_extra_envMapRotation, _init_ballpark, _init_extra_ballpark, _init_name, _init_extra_name, _init_sunBall, _init_extra_sunBall, _init_postprocess, _init_extra_postprocess, _init_virtualCameraSystem, _init_extra_virtualCameraSystem, _init_warpTunnel, _init_extra_warpTunnel, _init_perFrameDebug, _init_extra_perFrameDebug, _init_cascadedShadowMap, _init_extra_cascadedShadowMap, _init_updateTime, _init_extra_updateTime, _init_useSunDiffuseColorWithDynamicLights, _init_extra_useSunDiffuseColorWithDynamicLights, _init_envMap, _init_extra_envMap, _init_envMap2, _init_extra_envMap2, _init_envMap3, _init_extra_envMap3;
 
 // Module scratch for the per-frame sun-direction read (assume-dirty).
 const sunDirectionScratch = vec3.create();
 
+// The scene-root parent transform for the visibility pass (Carbon
+// EveSpaceScene.cpp:1441 `const Matrix& identity = IdentityMatrix()`). Module
+// const, NEVER mutated - objects in m_objects are scene roots.
+const IDENTITY = mat4.create();
+
+// ---------------------------------------------------------------------------
+// DRIVER-ORDER CONTRACT (per frame) - the CPU visibility/gather drive.
+// Carbon runs steps 5-12 inside EveSpaceScene::BeginRender/GatherBatches
+// (EveSpaceScene.cpp:1295-1427/1433-1525); CarbonEngineJS splits them into
+// scene-owned methods that an engine driver calls in this exact order:
+//
+//  1. Host stamps `updateContext.renderContext` (view -> derived inverse-view
+//     + viewPos) and `updateContext.device`.
+//  2. Driver derives the frustum:
+//     `frustum.DeriveFrustum(view, viewPos, projection, viewport)` from that
+//     same renderContext state (Carbon cpp:476).
+//  3. `scene.StampFrameContext({ frustum, thresholds..., lodFactor,
+//     raytracingEnabled })`.
+//  4. `scene.Update(realTime, simTime)` - internally ends with
+//     `UpdatePostProcessAttributes()` then the sun-direction read (Carbon
+//     cpp:584 -> 589).
+//  5. `scene.BlendLightingOverrides()` - BeginRender phase, before any gather
+//     (Carbon cpp:1333, before GatherBatches cpp:1387).
+//  6. (engine) volumetrics `UpdateFogSettings(scene.componentRegistry,
+//     scene.updateContext)` - engine reads "FroxelFogSettings"; not scene
+//     work (cpp:1365-1370).
+//  7. `scene.UpdateVisibility(updateContext.renderContext
+//     .GetInverseViewTransform())` - the cpp:1443-1467 block.
+//  8. `const renderables = scene.GetRenderables([])` - pre-culled
+//     (cpp:1470-1507 minus impostors).
+//  9. `batchManager.Collect(renderables, reason, updateContext.renderContext)`
+//     - with engine-registered collectors covering Carbon's [QUADS]
+//     (cpp:1509-1511) and [INSTANCED] (cpp:1516-1520; the instanced collector
+//     reads "InstancedMeshProvider" from `scene.componentRegistry`);
+//     `Finalize` inside Collect = Carbon FinalizeBatches cpp:1522.
+// 10. `scene.GatherLights(lightManager)` - AFTER step 9 (Carbon cpp:1396-1416
+//     runs after GatherBatches cpp:1387).
+// 11. (driver/engine, optional) `for (const lf of scene.lensflares)
+//     lf?.PrepareRender?.(frustum)` (cpp:1419-1422; the JS lensflare shell has
+//     no method yet - pure no-op today).
+// 12. (engine) reads registry collections directly: "ShadowCaster" (cascade
+//     gate cpp:614-621, RT push cpp:1544-1547), "VolumetricRenderable",
+//     "FroxelFogSettings", "MeshMorph" (engine may call
+//     `scene.componentRegistry.Clear("MeshMorph")` after bake),
+//     "ReflectionRenderable" (secondary gather cpp:1886-1895).
+//
+// One-shot registration trigger: after graph build/mutation call
+// `scene.ReregisterEntities()` - covers objects + backgroundObjects + planets
+// (entity-guarded) + cameraAttachmentParent (cpp:4064-4089, matching what
+// OnListModified registers incrementally, cpp:3435-3491). uiObjects are
+// intentionally excluded everywhere (cpp:3462 gate) - Carbon never registers
+// or culls them.
+// ---------------------------------------------------------------------------
+
 /** EveSpaceScene (eve/scene) - hand-maintained from schema shapeHash 571234b0.... */
 let _EveSpaceScene;
 new class extends _identity {
@@ -24,7 +83,7 @@ new class extends _identity {
       } = _applyDecs2311(this, [type.define({
         className: "EveSpaceScene",
         family: "eve/scene"
-      })], [[[io, io.readwrite, type, type.int32, void 0, schema.enum("EveVisualizeMethod")], 16, "visualizeMethod"], [[io, io.notify, io, io.persist, type, type.string], 16, "envMap1ResPath"], [[io, io.notify, io, io.persist, type, type.string], 16, "envMap2ResPath"], [[io, io.notify, io, io.persist, type, type.string], 16, "envMap3ResPath"], [[io, io.notify, io, io.persist, type, type.string], 16, "lowQualityNebulaResPath"], [[io, io.notify, io, io.persist, type, type.string], 16, "lowQualityNebulaMixResPath"], [[io, io.notify, io, io.persist, type, type.string], 16, "envMapResPath"], [[io, io.persist, type, type.color], 16, "fogColor"], [[io, io.persist, type, type.vec3], 16, "sunDirection"], [[io, io.persist, type, type.color], 16, "ambientColor"], [[io, io.persistOnly, void 0, type.model("Tr2ShLightingManager")], 16, "shLightingManager"], [[io, io.read, void 0, type.objectRef("Tr2PostProcessAttributes")], 16, "combinedPostProcessAttributes"], [[io, io.read, void 0, type.objectRef("Tr2DataTextureManager")], 16, "dataTextureMgr"], [[io, io.readwrite, type, type.boolean], 16, "dynamicObjectReflectionEnabled"], [[io, io.read, void 0, type.objectRef("EveComponentRegistry")], 16, "componentRegistry"], [type.model("EveEffectRoot2"), 0, "cameraAttachmentParent"], [type.rawStruct("BluePy"), 0, "postProcessDebug"], [[io, io.persist, void 0, type.list("TriCurveSet")], 16, "curveSets"], [[io, io.persist, type, type.float32], 16, "defaultDiffuseRoughness"], [[io, io.persist, type, type.float32], 16, "fogStart"], [[io, io.persist, type, type.float32], 16, "fogEnd"], [[io, io.notify, io, io.persist, type, type.float32], 16, "reflectionIntensity"], [[io, io.read, void 0, type.list("EveDistanceField")], 16, "distanceFields"], [[io, io.persist, void 0, type.model("Tr2Effect")], 16, "backgroundEffect"], [[io, io.persist, type, type.float32], 16, "backgroundReflectionIntensity"], [[io, io.persist, type, type.float32], 16, "nebulaIntensity"], [[io, io.persist, type, type.boolean], 16, "display"], [[io, io.persist, type, type.boolean], 16, "backgroundRenderingEnabled"], [[io, io.persist, type, type.boolean], 16, "update"], [[io, io.readwrite, void 0, type.objectRef("Tr2ImpostorManager")], 16, "impostorManager"], [[io, io.persist, void 0, type.list("EveLensflare")], 16, "lensflares"], [[io, io.persist, void 0, type.list("Tr2ExternalParameter")], 16, "externalParameters"], [[io, io.persist, type, type.float32], 16, "fogMax"], [[io, io.read, void 0, type.list("EveSceneStaticParticles")], 16, "staticParticles"], [[io, io.readwrite, void 0, type.objectRef("Tr2DebugRenderer")], 16, "debugRenderer"], [[io, io.persist, void 0, type.list("IEveSpaceObject2")], 16, "objects"], [[io, io.persist, void 0, type.list("IEveSpaceObject2")], 16, "uiObjects"], [[io, io.persist, void 0, type.list("IEveSpaceObject2")], 16, "backgroundObjects"], [[io, io.persist, void 0, type.list("EvePlanet")], 16, "planets"], [[io, io.readwrite, void 0, type.objectRef("Tr2RaytracingManager")], 16, "raytracingManager"], [[io, io.notify, io, io.persist, type, type.color], 16, "reflectionBackLightingColor"], [[io, io.notify, io, io.persist, type, type.float32], 16, "reflectionBackLightingContrast"], [[io, io.notify, io, io.readwrite, void 0, type.objectRef("Tr2ReflectionProbe")], 16, "reflectionProbe"], [[io, io.read, void 0, type.objectRef("Tr2VolumetricsRenderer")], 16, "volumetricsRenderer"], [[io, io.persist, void 0, type.model("EveStarfield")], 16, "starfield"], [[io, io.persist, type, type.float32], 16, "planetScale"], [[io, io.persist, type, type.float32], 16, "planetCameraScale"], [[io, io.read, void 0, type.objectRef("Tr2SSSSS")], 16, "subSurfaceScattering"], [[io, io.notify, io, io.readwrite, type, type.int32, void 0, schema.enum("ShadowQuality")], 16, "shadowQualitySetting"], [[io, io.persist, type, type.color], 16, "sunDiffuseColor"], [[io, io.persist, type, type.color], 16, "sunDiffuseColorWithDynamicLights"], [[io, io.persist, type, type.quat], 16, "envMapRotation"], [[io, io.readwrite, void 0, type.objectRef("IEveBallpark")], 16, "ballpark"], [[io, io.persist, type, type.string], 16, "name"], [[io, io.persist, void 0, type.model("ITriVectorFunction")], 16, "sunBall"], [[io, io.persist, void 0, type.model("Tr2PostProcess2")], 16, "postprocess"], [[io, io.persist, void 0, type.model("EveVirtualCameraSystem")], 16, "virtualCameraSystem"], [[io, io.readwrite, void 0, type.objectRef("IEveSpaceObject2")], 16, "warpTunnel"], [[io, io.readwrite, type, type.float32], 16, "perFrameDebug"], [[io, io.persist, void 0, type.model("Tr2ShadowMap")], 16, "cascadedShadowMap"], [[io, io.read, type, type.float64], 16, "updateTime"], [[io, io.persist, type, type.boolean], 16, "useSunDiffuseColorWithDynamicLights"], [[io, io.read, void 0, type.objectRef("ITr2TextureProvider")], 16, "envMap1"], [[io, io.read, void 0, type.objectRef("ITr2TextureProvider")], 16, "envMap2"], [[io, io.read, void 0, type.objectRef("ITr2TextureProvider")], 16, "envMap3"], [[carbon, carbon.method, impl, impl.adapted], 18, "Update"], [[carbon, carbon.method, impl, impl.notImplemented], 18, "PickObject"], [[carbon, carbon.method, impl, impl.notImplemented], 18, "PickAsyncObject"], [[carbon, carbon.method, impl, impl.notImplemented], 18, "PickObjectAndAreaID"], [[carbon, carbon.method, impl, impl.notImplemented], 18, "PickInfinity"], [[carbon, carbon.method, impl, impl.implemented], 18, "ReregisterEntities"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetPostProcessDebug"], [[carbon, carbon.method, impl, impl.implemented], 18, "UpdateScene"]], 0, void 0, CjsModel));
+      })], [[[io, io.readwrite, type, type.int32, void 0, schema.enum("EveVisualizeMethod")], 16, "visualizeMethod"], [[io, io.notify, io, io.persist, type, type.string], 16, "envMap1ResPath"], [[io, io.notify, io, io.persist, type, type.string], 16, "envMap2ResPath"], [[io, io.notify, io, io.persist, type, type.string], 16, "envMap3ResPath"], [[io, io.notify, io, io.persist, type, type.string], 16, "lowQualityNebulaResPath"], [[io, io.notify, io, io.persist, type, type.string], 16, "lowQualityNebulaMixResPath"], [[io, io.notify, io, io.persist, type, type.string], 16, "envMapResPath"], [[io, io.persist, type, type.color], 16, "fogColor"], [[io, io.persist, type, type.vec3], 16, "sunDirection"], [[io, io.persist, type, type.color], 16, "ambientColor"], [[io, io.persistOnly, void 0, type.model("Tr2ShLightingManager")], 16, "shLightingManager"], [[io, io.read, void 0, type.objectRef("Tr2PostProcessAttributes")], 16, "combinedPostProcessAttributes"], [[io, io.read, void 0, type.objectRef("Tr2DataTextureManager")], 16, "dataTextureMgr"], [[io, io.readwrite, type, type.boolean], 16, "dynamicObjectReflectionEnabled"], [[io, io.read, void 0, type.objectRef("EveComponentRegistry")], 16, "componentRegistry"], [type.model("EveEffectRoot2"), 0, "cameraAttachmentParent"], [type.rawStruct("BluePy"), 0, "postProcessDebug"], [[io, io.persist, void 0, type.list("TriCurveSet")], 16, "curveSets"], [[io, io.persist, type, type.float32], 16, "defaultDiffuseRoughness"], [[io, io.persist, type, type.float32], 16, "fogStart"], [[io, io.persist, type, type.float32], 16, "fogEnd"], [[io, io.notify, io, io.persist, type, type.float32], 16, "reflectionIntensity"], [[io, io.read, void 0, type.list("EveDistanceField")], 16, "distanceFields"], [[io, io.persist, void 0, type.model("Tr2Effect")], 16, "backgroundEffect"], [[io, io.persist, type, type.float32], 16, "backgroundReflectionIntensity"], [[io, io.persist, type, type.float32], 16, "nebulaIntensity"], [[io, io.persist, type, type.boolean], 16, "display"], [[io, io.persist, type, type.boolean], 16, "backgroundRenderingEnabled"], [[io, io.persist, type, type.boolean], 16, "update"], [[io, io.readwrite, void 0, type.objectRef("Tr2ImpostorManager")], 16, "impostorManager"], [[io, io.persist, void 0, type.list("EveLensflare")], 16, "lensflares"], [[io, io.persist, void 0, type.list("Tr2ExternalParameter")], 16, "externalParameters"], [[io, io.persist, type, type.float32], 16, "fogMax"], [[io, io.read, void 0, type.list("EveSceneStaticParticles")], 16, "staticParticles"], [[io, io.readwrite, void 0, type.objectRef("Tr2DebugRenderer")], 16, "debugRenderer"], [[io, io.persist, void 0, type.list("IEveSpaceObject2")], 16, "objects"], [[io, io.persist, void 0, type.list("IEveSpaceObject2")], 16, "uiObjects"], [[io, io.persist, void 0, type.list("IEveSpaceObject2")], 16, "backgroundObjects"], [[io, io.persist, void 0, type.list("EvePlanet")], 16, "planets"], [[io, io.readwrite, void 0, type.objectRef("Tr2RaytracingManager")], 16, "raytracingManager"], [[io, io.notify, io, io.persist, type, type.color], 16, "reflectionBackLightingColor"], [[io, io.notify, io, io.persist, type, type.float32], 16, "reflectionBackLightingContrast"], [[io, io.notify, io, io.readwrite, void 0, type.objectRef("Tr2ReflectionProbe")], 16, "reflectionProbe"], [[io, io.read, void 0, type.objectRef("Tr2VolumetricsRenderer")], 16, "volumetricsRenderer"], [[io, io.persist, void 0, type.model("EveStarfield")], 16, "starfield"], [[io, io.persist, type, type.float32], 16, "planetScale"], [[io, io.persist, type, type.float32], 16, "planetCameraScale"], [[io, io.read, void 0, type.objectRef("Tr2SSSSS")], 16, "subSurfaceScattering"], [[io, io.notify, io, io.readwrite, type, type.int32, void 0, schema.enum("ShadowQuality")], 16, "shadowQualitySetting"], [[io, io.persist, type, type.color], 16, "sunDiffuseColor"], [[io, io.persist, type, type.color], 16, "sunDiffuseColorWithDynamicLights"], [[io, io.persist, type, type.quat], 16, "envMapRotation"], [[io, io.readwrite, void 0, type.objectRef("IEveBallpark")], 16, "ballpark"], [[io, io.persist, type, type.string], 16, "name"], [[io, io.persist, void 0, type.model("ITriVectorFunction")], 16, "sunBall"], [[io, io.persist, void 0, type.model("Tr2PostProcess2")], 16, "postprocess"], [[io, io.persist, void 0, type.model("EveVirtualCameraSystem")], 16, "virtualCameraSystem"], [[io, io.readwrite, void 0, type.objectRef("IEveSpaceObject2")], 16, "warpTunnel"], [[io, io.readwrite, type, type.float32], 16, "perFrameDebug"], [[io, io.persist, void 0, type.model("Tr2ShadowMap")], 16, "cascadedShadowMap"], [[io, io.read, type, type.float64], 16, "updateTime"], [[io, io.persist, type, type.boolean], 16, "useSunDiffuseColorWithDynamicLights"], [[io, io.read, void 0, type.objectRef("ITr2TextureProvider")], 16, "envMap1"], [[io, io.read, void 0, type.objectRef("ITr2TextureProvider")], 16, "envMap2"], [[io, io.read, void 0, type.objectRef("ITr2TextureProvider")], 16, "envMap3"], [[carbon, carbon.method, impl, impl.adapted], 18, "Update"], [[carbon, carbon.method, impl, impl.notImplemented], 18, "PickObject"], [[carbon, carbon.method, impl, impl.notImplemented], 18, "PickAsyncObject"], [[carbon, carbon.method, impl, impl.notImplemented], 18, "PickObjectAndAreaID"], [[carbon, carbon.method, impl, impl.notImplemented], 18, "PickInfinity"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Carbon's g_enablePostProcessDebugging global becomes the scene-scoped enablePostProcessDebugging field; the debug payload is a plain object, null when off.")], 18, "UpdatePostProcessAttributes"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetPostProcess"], [[carbon, carbon.method, impl, impl.implemented], 18, "ReregisterEntities"], [[carbon, carbon.method, impl, impl.implemented], 18, "ClearComponentRegistry"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetPostProcessDebug"], [[carbon, carbon.method, impl, impl.implemented], 18, "UpdateScene"]], 0, void 0, CjsModel));
     }
     /** m_visualizeMethod (EveVisualizeMethod - enum EveVisualizeMethod) [READWRITE, ENUM] */
     visualizeMethod = (_initProto(this), _init_visualizeMethod(this, 0));
@@ -59,8 +118,10 @@ new class extends _identity {
     /** m_shLightingManager (Tr2ShLightingManagerPtr) [PERSISTONLY] */
     shLightingManager = (_init_extra_ambientColor(this), _init_shLightingManager(this, null));
 
-    /** m_combinedPostProcessAttributes (Tr2PostProcessAttributesPtr) [READ] */
-    combinedPostProcessAttributes = (_init_extra_shLightingManager(this), _init_combinedPostProcessAttributes(this, null));
+    /** m_combinedPostProcessAttributes (Tr2PostProcessAttributesPtr) [READ] -
+     * default-constructed like Carbon's ctor CreateInstance (cpp:297); refreshed
+     * by UpdatePostProcessAttributes' re-export at MEDIUM_PRIORITY (cpp:407). */
+    combinedPostProcessAttributes = (_init_extra_shLightingManager(this), _init_combinedPostProcessAttributes(this, new _Tr2PostProcessAttrib()));
 
     /** m_dataTextureMgr (Tr2DataTextureManagerPtr) [READ] */
     dataTextureMgr = (_init_extra_combinedPostProcessAttributes(this), _init_dataTextureMgr(this, null));
@@ -71,8 +132,11 @@ new class extends _identity {
     /** m_componentRegistry (EveComponentRegistryPtr) [READ] */
     componentRegistry = (_init_extra_dynamicObjectReflectionEnabled(this), _init_componentRegistry(this, new _EveComponentRegistry()));
 
-    /** m_cameraAttachmentParent (EveEffectRoot2Ptr) - protected Carbon scene entity. */
-    cameraAttachmentParent = (_init_extra_componentRegistry(this), _init_cameraAttachmentParent(this, null));
+    /** m_cameraAttachmentParent (EveEffectRoot2Ptr) - protected Carbon scene
+     * entity, default-constructed like Carbon's ctor CreateInstance (cpp:287, no
+     * further setup applied). Consumers still optional-chain - deserialization
+     * may null it. */
+    cameraAttachmentParent = (_init_extra_componentRegistry(this), _init_cameraAttachmentParent(this, new _EveEffectRoot()));
 
     /** m_postProcessDebug (BluePy) - protected Carbon debug payload. */
     postProcessDebug = (_init_extra_cameraAttachmentParent(this), _init_postProcessDebug(this, null));
@@ -228,6 +292,74 @@ new class extends _identity {
     // Tr2Renderer view statics.
     updateContext = (_init_extra_envMap3(this), new _EveUpdateContext());
 
+    // Carbon m_sceneDefaultPostProcessAttributes (EveSpaceScene.h:640, ctor
+    // CreateInstance cpp:296): the scene default's attribute snapshot, refreshed
+    // by UpdatePostProcessAttributes each frame.
+    #sceneDefaultPostProcessAttributes = new _Tr2PostProcessAttrib();
+
+    // Carbon m_combinedPostProcess (EveSpaceScene.h:636): the merged output
+    // post-process, lazily constructed on first combine (cpp:367-370).
+    #combinedPostProcess = null;
+
+    // Carbon m_currentSunColor / m_currentNebulaIntensity /
+    // m_currentReflectionIntensity (EveSpaceScene.h:492-493/650, protected):
+    // outputs of the BeginRender lighting-override blend (cpp:1360-1362).
+    currentSunColor = vec4.create();
+    currentNebulaIntensity = 0;
+    currentReflectionIntensity = 0;
+
+    // Carbon g_eveSpaceSceneDynamicLighting (registered setting
+    // "eveSpaceSceneDynamicLighting", cpp:109-110, default false) - scoped to
+    // the scene instead of a module global.
+    dynamicLightingEnabled = false;
+
+    // Carbon g_enablePostProcessDebugging (registered setting
+    // "enablePostProcessDebugging", cpp:118-119, default false) - scoped to the
+    // scene instead of a module global.
+    enablePostProcessDebugging = false;
+
+    /**
+     * Stamps the per-frame frustum/threshold/LOD state onto the scene-owned
+     * update context (Carbon EveSpaceScene::Update cpp:475-484, identical to the
+     * already-updated fast path cpp:448-457). Carbon derives the frustum from
+     * the Tr2Renderer view statics and reads the thresholds from console vars
+     * divided by m_upscalingAmount (=1 by default, cpp:221); in CarbonEngineJS
+     * the driver derives the frustum from the same renderContext state it
+     * stamped and supplies the thresholds explicitly (pre-divided if it ever
+     * upscales). Defaults are the Carbon console-var defaults (cpp:75-84).
+     * The raytracing flag is Carbon's `m_shadowQuality == SHADOW_RAYTRACED &&
+     * m_enableShadows` (cpp:457/484) - the driver computes it; the scene does
+     * not. Stamps unconditionally: Carbon's same-frame fast path restamps
+     * regardless of m_update (cpp:444-462); only the cold path skips stamping
+     * when !m_update (cpp:466 precedes 475) - benign divergence.
+     * @param {Object} [options]
+     * @param {Object|null} [options.frustum] - a ready TriFrustum, held by reference
+     * @param {Number} [options.visibilityThreshold]
+     * @param {Number} [options.lowDetailThreshold]
+     * @param {Number} [options.mediumDetailThreshold]
+     * @param {Number} [options.highDetailThreshold]
+     * @param {Number} [options.lodFactor]
+     * @param {Boolean} [options.raytracingEnabled]
+     */
+    StampFrameContext({
+      frustum = null,
+      visibilityThreshold = 5,
+      lowDetailThreshold = 100,
+      mediumDetailThreshold = 400,
+      highDetailThreshold = 800,
+      lodFactor = 1,
+      raytracingEnabled = false
+    } = {}) {
+      const context = this.updateContext;
+      context.SetFrustum(frustum);
+      context.SetHighDetailThreshold(highDetailThreshold);
+      context.SetMediumDetailThreshold(mediumDetailThreshold);
+      context.SetLowDetailThreshold(lowDetailThreshold);
+      context.SetVisibilityThreshold(visibilityThreshold);
+      context.SetLodFactor(lodFactor);
+      context.raytracingEnabled = !!raytracingEnabled;
+    }
+
     /**
      * Per-frame scene update, ported from Carbon EveSpaceScene::Update: stamps the
      * scene-owned frame context (time, origin, data-texture manager), then drives
@@ -235,14 +367,14 @@ new class extends _identity {
      * starfield, static particles, data textures, distance fields, lensflares,
      * virtual camera system, curve sets, then all space/UI objects synchronous
      * first and asynchronous second (Carbon parallelizes the async pass on a task
-     * group; JS runs it sequentially). Finally reads the sun direction from the
-     * sun ball.
+     * group; JS runs it sequentially). Then combines the post-process attributes
+     * (cpp:584) and finally reads the sun direction from the sun ball
+     * (cpp:589-596).
      *
-     * Adapted - deferred vs Carbon: the recording-frame dedup fast path, frustum
-     * derivation (TriFrustum unported; context.frustum stays null), detail
-     * threshold / LOD stamping (console-var globals + upscaling), raytracing flag,
-     * planet update (planet view-matrix swap unported), post-process attribute
-     * combine, and main-thread action flush.
+     * Adapted - deferred vs Carbon: the recording-frame dedup fast path,
+     * frustum/threshold/LOD/raytracing stamping (now the driver's job via
+     * StampFrameContext, called BEFORE Update), planet update (planet
+     * view-matrix swap unported), and main-thread action flush (N/A).
      * @param {Number} realTime
      * @param {Number} simTime
      */
@@ -292,6 +424,10 @@ new class extends _identity {
         object?.UpdateAsyncronous?.(context);
       }
 
+      // Combine the post-process attributes (Carbon cpp:584, after the async
+      // pass + ExecuteMainThreadActions cpp:581 and before the sun read).
+      this.UpdatePostProcessAttributes();
+
       // Sun direction from the sun ball: the normalized sun position, negated
       // (Carbon: m_sunData.DirWorld = -Normalize(sunDirection)).
       if (this.sunBall?.Update) {
@@ -322,18 +458,240 @@ new class extends _identity {
       throw new Error("EveSpaceScene.PickInfinity is not implemented in CarbonEngineJS.");
     }
 
+    /**
+     * The per-frame CPU visibility pass, ported from the [VISIBILITY] block of
+     * Carbon EveSpaceScene::GatherBatches (EveSpaceScene.cpp:1443-1467; the
+     * enclosing display gate is BeginRender cpp:1299-1302). Carbon's
+     * Tr2ParallelDo loops (objects cpp:1445-1447, staticParticles cpp:1454-1456,
+     * planets cpp:1458-1460) run sequentially in the same order; the lensflare
+     * loop is sequential in Carbon too (cpp:1462-1466). LOD stamping (lodLevel,
+     * isVisible, pixel diameters) happens INSIDE each object's UpdateVisibility;
+     * per-object display gates live there too - the scene does not pre-filter.
+     * uiObjects are never visited (Carbon never culls them). The camera parent's
+     * SetTransform is pure decomposition (EveEffectRoot2.cpp:677-680 Decompose)
+     * - no composition, so no row-vector operand swap here; this per-gather
+     * Sync/Async pair is the camera parent's ONLY update, so its world transform
+     * is the camera pose of the frame being gathered (cpp:1449-1452).
+     * @param {Float32Array} inverseView - the inverse view matrix
+     *   (updateContext.renderContext.GetInverseViewTransform(); Carbon reads the
+     *   Tr2Renderer static at cpp:1449)
+     */
+    UpdateVisibility(inverseView) {
+      if (!this.display) {
+        return;
+      }
+      for (const object of this.objects) {
+        object?.UpdateVisibility?.(this.updateContext, IDENTITY);
+      }
+      this.cameraAttachmentParent?.SetTransform?.(inverseView);
+      this.cameraAttachmentParent?.UpdateSyncronous?.(this.updateContext);
+      this.cameraAttachmentParent?.UpdateAsyncronous?.(this.updateContext);
+      this.cameraAttachmentParent?.UpdateVisibility?.(this.updateContext, IDENTITY);
+      for (const staticParticles of this.staticParticles) {
+        staticParticles?.UpdateVisibility?.(this.updateContext);
+      }
+      for (const planet of this.planets) {
+        planet?.UpdateZOnlyVisibility?.(this.updateContext);
+      }
+
+      // Sequential in Carbon too: "until we have proper support for multiple
+      // lensflares we just do it in a list" (cpp:1462-1466).
+      for (const lensflare of this.lensflares) {
+        lensflare?.UpdateVisibility?.(this.updateContext);
+      }
+    }
+
     /** Gathers batchable renderables from the scene's objects for the batch
-     * collection pass. Carbon gathers these inline in EveSpaceScene::GatherBatches
-     * (EveSpaceScene.cpp:1433-1514): objects self-filter on the visibility flags
-     * stamped by the update pass, so this aggregation stays GPU-free. */
+     * collection pass - the [GATHER] block of Carbon
+     * EveSpaceScene::GatherBatches (EveSpaceScene.cpp:1470-1507): m_objects in
+     * list order (cpp:1470-1475), then cameraAttachmentParent pushed LAST
+     * (cpp:1476), then the staticParticles leg (cpp:1504-1507; Carbon signature
+     * `GetRenderables(frustum, renderables)`, EveSceneStaticParticles.h - kept
+     * with the out-parameter last per convention). Objects self-filter on the
+     * visibility flags stamped by UpdateVisibility, so the array handed to
+     * CjsBatchManager.Collect is pre-culled and this aggregation stays GPU-free.
+     * The impostor-manager argument (cpp:1478-1502) is dropped - engine-owned.
+     * Gather order matters downstream: the opaque accumulator receives batches
+     * in gather order before Finalize sorts. */
     GetRenderables(out = []) {
+      if (!this.display) {
+        return out;
+      }
       for (const object of this.objects) object?.GetRenderables?.(out);
       this.cameraAttachmentParent?.GetRenderables?.(out);
+      for (const staticParticles of this.staticParticles) {
+        staticParticles?.GetRenderables?.(this.updateContext.GetFrustum(), out);
+      }
       return out;
     }
 
-    /** Carbon method ReregisterEntities (MAP_METHOD_AND_WRAP). */
+    /**
+     * Refreshes the scene default's attribute snapshot, gathers every registered
+     * PostProcessOwner's attributes, priority-blends them into the combined
+     * post-process, copies the six engine effects through from the scene
+     * default, and re-exports the result (Carbon
+     * EveSpaceScene::UpdatePostProcessAttributes, EveSpaceScene.cpp:346-413).
+     * Sort is descending by priority (cpp:372-377); Carbon's std::sort is
+     * unstable while JS sort is stable - equal-priority ties keep registry
+     * insertion order, which is blend-order-independent for every Sum-accumulated
+     * attribute (the whole tie group is normalized together); only MaxWeight
+     * ties at exactly equal weight (string paths / bools / DoF shape) could
+     * differ from C++.
+     */
+    UpdatePostProcessAttributes() {
+      if (!this.display) {
+        return;
+      }
+
+      // Scene default refreshed BEFORE the gather (cpp:354); FromPostProcess
+      // handles a null postprocess (reset + return).
+      this.#sceneDefaultPostProcessAttributes.FromPostProcess(this.postprocess, _Tr2PostProcessAttrib.SCENE_DEFAULT_PRIORITY, 1.0);
+      const sources = [];
+      for (const owner of this.componentRegistry?.GetComponents(EveComponentType.PostProcessOwner) ?? []) {
+        // Carbon pushes unguarded (cpp:358-361); JS ducks may return null.
+        const attributes = owner?.GetPostProcessAttributes?.();
+        if (attributes) {
+          sources.push(attributes);
+        }
+      }
+
+      // Scene default appended LAST (cpp:363).
+      sources.push(this.#sceneDefaultPostProcessAttributes);
+
+      // The list is never empty (default always pushed) so Carbon's else-branch
+      // (cpp:411) is unreachable; the guard is kept for shape fidelity.
+      if (sources.length) {
+        this.#combinedPostProcess ??= new _Tr2PostProcess();
+        sources.sort((a, b) => b.priority - a.priority);
+        if (this.enablePostProcessDebugging) {
+          const observer = _Tr2PostProcessAttrib.CreateDebugObserver();
+          _Tr2PostProcessAttrib.MergeInto(this.#combinedPostProcess, sources, observer);
+          this.postProcessDebug = observer.GetDict();
+        } else {
+          _Tr2PostProcessAttrib.MergeInto(this.#combinedPostProcess, sources);
+          this.postProcessDebug = null;
+        }
+
+        // Engine-effect copy-through from the scene default only - NOT blended
+        // (cpp:389-406).
+        if (this.postprocess) {
+          this.#combinedPostProcess.SetDynamicExposure(this.postprocess.GetDynamicExposureIfAvailable?.() ?? null);
+          this.#combinedPostProcess.SetTaa(this.postprocess.GetTaaIfAvailable?.() ?? null);
+          this.#combinedPostProcess.SetTonemapping(this.postprocess.GetTonemappingIfAvailable?.() ?? null);
+          this.#combinedPostProcess.SetFog(this.postprocess.GetFogIfAvailable?.() ?? null);
+          this.#combinedPostProcess.SetGodRays(this.postprocess.GetGodRaysIfAvailable?.() ?? null);
+          this.#combinedPostProcess.SetGenericEffect(this.postprocess.GetGenericEffectIfAvailable?.() ?? null);
+        } else {
+          this.#combinedPostProcess.SetDynamicExposure(null);
+          this.#combinedPostProcess.SetTaa(null);
+          this.#combinedPostProcess.SetTonemapping(null);
+          this.#combinedPostProcess.SetFog(null);
+          this.#combinedPostProcess.SetGodRays(null);
+          this.#combinedPostProcess.SetGenericEffect(null);
+        }
+
+        // Re-export the combined result as an attributes object at
+        // MEDIUM_PRIORITY - consumed by nested-scene composition (cpp:407).
+        (this.combinedPostProcessAttributes ??= new _Tr2PostProcessAttrib()).FromPostProcess(this.#combinedPostProcess, _Tr2PostProcessAttrib.MEDIUM_PRIORITY, 1.0);
+      } else {
+        this.#combinedPostProcess = null;
+      }
+    }
+
+    /** Carbon method GetPostProcess (EveSpaceScene.cpp:420-427): the combined
+     * post-process, or null while the scene is not displayed. */
+    GetPostProcess() {
+      if (!this.display) {
+        return null;
+      }
+      return this.#combinedPostProcess;
+    }
+
+    /**
+     * Blends every registered EveLightingOverride against the scene baseline and
+     * stamps currentSunColor / currentNebulaIntensity /
+     * currentReflectionIntensity - the lighting-override block of Carbon
+     * EveSpaceScene::BeginRender (EveSpaceScene.cpp:1333-1363). The baseline is
+     * appended AFTER the sort at raw priority -1 - one below
+     * SCENE_DEFAULT_PRIORITY=0, outside the legal enum range (Carbon casts -1,
+     * cpp:1343) - so it always sits last. Scalar/color math only - no matrix
+     * compositions, no row-vector swaps anywhere in this method. Same
+     * stable-sort note as UpdatePostProcessAttributes - here fully benign, the
+     * blend is symmetric within a tie group.
+     */
+    BlendLightingOverrides() {
+      if (!this.display) {
+        return;
+      }
+      const overrides = [];
+      for (const component of this.componentRegistry?.GetComponents(EveComponentType.EveLightingOverride) ?? []) {
+        overrides.push(component.GetOverrides());
+      }
+      overrides.sort((a, b) => b.priority - a.priority);
+
+      // Baseline (cpp:1342-1357): the scene's own sun/nebula/reflection state,
+      // sun color normalized by its max channel (all four components scaled).
+      const sunColorSource = this.useSunDiffuseColorWithDynamicLights && this.dynamicLightingEnabled ? this.sunDiffuseColorWithDynamicLights : this.sunDiffuseColor;
+      const sunIntensity = Math.max(sunColorSource[0], sunColorSource[1], sunColorSource[2]);
+      const baselineSunColor = vec4.create();
+      if (sunIntensity !== 0) {
+        vec4.scale(baselineSunColor, sunColorSource, 1 / sunIntensity);
+      } else {
+        vec4.copy(baselineSunColor, sunColorSource);
+      }
+      overrides.push({
+        priority: -1,
+        intensity: 1,
+        value: {
+          sunColor: baselineSunColor,
+          sunIntensity,
+          backgroundIntensity: this.nebulaIntensity,
+          reflectionIntensity: this.reflectionIntensity
+        }
+      });
+      const over = _EveSpaceScene.#SimplePriorityBlend(overrides);
+      vec4.scale(this.currentSunColor, over.sunColor, over.sunIntensity);
+      this.currentNebulaIntensity = over.backgroundIntensity;
+      this.currentReflectionIntensity = over.reflectionIntensity;
+    }
+
+    /**
+     * Drives the injected light manager through Carbon's dynamic-light gather
+     * (EveSpaceScene::BeginRender, EveSpaceScene.cpp:1396-1416, AFTER
+     * GatherBatches cpp:1387): shadow quality, clear (runs even with zero owners
+     * - stale lights must drop), frustum, LOD cutoff, then every registered
+     * LightOwner's GetLights (Carbon Tr2ParallelFor chunk-20 cpp:1405-1413; JS
+     * sequential in collection order), then ResolveLightData. No JS
+     * Tr2LightManager class exists - the manager is a duck and every manager
+     * call is optional-chained so a partial duck still gets the owner loop.
+     * Carbon runs the block only when a manager instance exists (dynamic
+     * lighting on) - a null manager is a no-op. The recording frame number
+     * Carbon passes to SetShadowQuality and the renderContext it passes to Clear
+     * are engine recording state - the JS Clear receives the frame's
+     * renderContext for ducks that want it.
+     * @param {Object|null} lightManager
+     */
+    GatherLights(lightManager) {
+      if (!lightManager || !this.display) {
+        return;
+      }
+      lightManager.SetShadowQuality?.(this.shadowQualitySetting);
+      lightManager.Clear?.(this.updateContext.renderContext);
+      lightManager.SetFrustum?.(this.updateContext.GetFrustum());
+      lightManager.AdjustLightCutoff?.(this.updateContext.GetLodFactor());
+      for (const owner of this.componentRegistry?.GetComponents(EveComponentType.LightOwner) ?? []) {
+        owner?.GetLights?.(lightManager);
+      }
+      lightManager.ResolveLightData?.();
+    }
+
+    /** Carbon method ReregisterEntities (MAP_METHOD_AND_WRAP, cpp:4064-4089).
+     * Guarded no-op after ClearComponentRegistry has nulled the registry
+     * (destroy-only path; Carbon would never call this afterwards). */
     ReregisterEntities() {
+      if (!this.componentRegistry) {
+        return;
+      }
       for (const collection of [this.objects, this.backgroundObjects, this.planets]) {
         for (const object of collection) {
           if (object instanceof _EveEntity) {
@@ -346,6 +704,17 @@ new class extends _identity {
       }
     }
 
+    /** Carbon method ClearComponentRegistry (EveSpaceScene.cpp:4091-4099, called
+     * from the destructor cpp:322). Entity component-state is deliberately NOT
+     * cleared beyond what Clear() does - either the scene is being destroyed
+     * (entities go too) or entities move to another scene and re-register there.
+     * The JS registry Clear() additionally detaches entity.registry when it
+     * points at this registry - strictly more hygienic than Carbon; kept. */
+    ClearComponentRegistry() {
+      this.componentRegistry?.Clear();
+      this.componentRegistry = null;
+    }
+
     /** Carbon method GetPostProcessDebug (MAP_METHOD_AND_WRAP). */
     GetPostProcessDebug() {
       return this.postProcessDebug;
@@ -355,6 +724,23 @@ new class extends _identity {
     UpdateScene(time) {
       return this.Update(time, time);
     }
+
+    /**
+     * Carbon SimplePriorityBlend (PriorityBlend.h:371-413) specialized to the
+     * IEveLightingOverride::Overrides value type
+     * { sunColor: vec4, sunIntensity, backgroundIntensity, reflectionIntensity }
+     * (EveChildLightingOverride.h:15-32) - `+` and `* weight` componentwise.
+     * Walks the (already priority-desc-sorted) list in equal-priority groups:
+     *   factor = (1 / max(groupTotal, 1)) * remainingWeight
+     * then subtracts the UNCLAMPED group total from remainingWeight. Two quirks
+     * preserved exactly: (a) a group with total intensity 0.3 contributes at
+     * weight 0.3*remaining and leaves 0.7 for lower priorities; (b) a group with
+     * total 2 is normalized to consume exactly remainingWeight and terminates
+     * (remaining goes to -1).
+     * @param {Array} sources - [{ priority, intensity, value }] sorted high->low
+     * @returns {{ sunColor: Float32Array, sunIntensity: Number,
+     *   backgroundIntensity: Number, reflectionIntensity: Number }}
+     */
   }];
   EveVisualizeMethod = Object.freeze({
     VM_NONE: 0,
@@ -372,6 +758,47 @@ new class extends _identity {
     SHADOW_HIGH: 2,
     SHADOW_RAYTRACED: 3
   });
+  #SimplePriorityBlend(sources) {
+    const result = {
+      sunColor: vec4.create(),
+      sunIntensity: 0,
+      backgroundIntensity: 0,
+      reflectionIntensity: 0
+    };
+    let remainingWeight = 1;
+    for (let first = 0; first < sources.length;) {
+      // The range of sources sharing the current priority.
+      let last = first + 1;
+      while (last < sources.length && sources[last].priority === sources[first].priority) {
+        last++;
+      }
+      let totalPriorityIntensity = 0;
+      for (let index = first; index < last; index++) {
+        totalPriorityIntensity += sources[index].intensity;
+      }
+      if (totalPriorityIntensity === 0) {
+        first = last;
+        continue;
+      }
+      const normalizationFactor = 1 / Math.max(totalPriorityIntensity, 1) * remainingWeight;
+      for (let index = first; index < last; index++) {
+        const weight = sources[index].intensity * normalizationFactor;
+        const value = sources[index].value;
+        vec4.scaleAndAdd(result.sunColor, result.sunColor, value.sunColor, weight);
+        result.sunIntensity += value.sunIntensity * weight;
+        result.backgroundIntensity += value.backgroundIntensity * weight;
+        result.reflectionIntensity += value.reflectionIntensity * weight;
+      }
+
+      // Subtracts the UNCLAMPED total (PriorityBlend.h:405).
+      remainingWeight -= totalPriorityIntensity;
+      first = last;
+      if (remainingWeight <= 0) {
+        break;
+      }
+    }
+    return result;
+  }
   constructor() {
     super(_EveSpaceScene), _initClass();
   }