@woosh/meep-engine 3.2.0 → 3.3.0

package/src/engine/ecs/storage/populateEngineSerializationRegistry.js

@@ -1,265 +1,269 @@
-import { AnimationSerializationAdapter } from "../animation/AnimationSerializationAdapter.js";
-import { PropertySetSerializationAdapter } from "../components/PropertySetSerializationAdapter.js";
-import {
-    SerializationMetadataSerializationAdapter
-} from "../components/SerializationMetadataSerializationAdapter.js";
-import { Tag } from "../components/Tag.js";
-import { TagSerializationAdapter } from "../components/TagSerializationAdapter.js";
-import { TagSerializationUpgrader_0_1 } from "../components/TagSerializationUpgrader_0_1.js";
-import { FogOfWar } from "../fow/FogOfWar.js";
-import {
-    FogOfWarRevealerSerializationAdapter
-} from "../fow/serialization/FogOfWarRevealerSerializationAdapter.js";
-import { FogOfWarSerializationAdapter } from "../fow/serialization/FogOfWarSerializationAdapter.js";
-import { FogOfWarSerializationUpdater_0_1 } from "../fow/serialization/FogOfWarSerializationUpdater_0_1.js";
-import { GUIElementSerializationAdapter } from "../gui/GUIElementSerializationAdapter.js";
-import { HeadsUpDisplaySerializationAdapter } from "../gui/hud/HeadsUpDisplaySerializationAdapter.js";
-import {
-    ViewportPositionSerializationAdapter
-} from "../gui/position/ViewportPositionSerializationAdapter.js";
-import { InverseKinematicsSerializationAdapter } from "../ik/InverseKinematicsSerializationAdapter.js";
-import { NameSerializationAdapter } from "../name/NameSerializationAdapter.js";
-import { TeamSerializationAdapter } from "../team/TeamSerializationAdapter.js";
-import ClingToTerrain from "../terrain/ecs/cling/ClingToTerrain.js";
-import {
-    ClingToTerrainSerializationAdapter
-} from "../terrain/ecs/cling/ClingToTerrainSerializationAdapter.js";
-import {
-    ClingToTerrainSerializationUpgrader_0_1
-} from "../terrain/ecs/cling/ClingToTerrainSerializationUpgrader_0_1.js";
-import Terrain from "../terrain/ecs/Terrain.js";
-import { TerrainSerializationAdapter } from "../terrain/serialization/TerrainSerializationAdapter.js";
-import {
-    TerrainSerializationUpgrader_0_1
-} from "../terrain/serialization/TerrainSerializationUpgrader_0_1.js";
-import {
-    TerrainSerializationUpgrader_1_2
-} from "../terrain/serialization/TerrainSerializationUpgrader_1_2.js";
-import { TooltipComponentSerializationAdapter } from "../tooltip/TooltipComponentSerializationAdapter.js";
-import { PickableSerializationAdapter } from "../../graphics3/Pickable.js";
-import { Transform } from "../transform/Transform.js";
-import { TransformSerializationAdapter } from "../transform/TransformSerializationAdapter.js";
-import { TransformSerializationUpgrader_0_1 } from "../transform/TransformSerializationUpgrader_0_1.js";
-import {
-    AnimationControllerSerializationAdapter
-} from "../../graphics/ecs/animation/AnimationControllerSerializationAdapter.js";
-import { Camera } from "../../graphics/ecs/camera/Camera.js";
-import {
-    CameraSerializationAdapter
-} from "../../graphics/ecs/camera/serialization/CameraSerializationAdapter.js";
-import {
-    CameraSerializationUpgrader_0_1
-} from "../../graphics/ecs/camera/serialization/CameraSerializationUpgrader_0_1.js";
-import TopDownCameraController from "../../graphics/ecs/camera/topdown/TopDownCameraController.js";
-import {
-    TopDownCameraControllerSerializationAdapter
-} from "../../graphics/ecs/camera/topdown/TopDownCameraControllerSerializationAdapter.js";
-import {
-    TopDownCameraControllerSerializationUpgrader_0_1
-} from "../../graphics/ecs/camera/topdown/TopDownCameraControllerSerializationUpgrader_0_1.js";
-import {
-    TopDownCameraLanderSerializationAdapter
-} from "../../graphics/ecs/camera/topdown/TopDownCameraLander.js";
-import { Decal } from "../../graphics/ecs/decal/v2/Decal.js";
-import { DecalSerializationAdapter } from "../../graphics/ecs/decal/v2/DecalSerializationAdapter.js";
-import {
-    DecalSerializationUpgrader_0_1
-} from "../../graphics/ecs/decal/v2/DecalSerializationUpgrader_0_1.js";
-import Highlight from "../../graphics/ecs/highlight/Highlight.js";
-import { HighlightSerializationAdapter } from "../../graphics/ecs/highlight/HighlightSerializationAdapter.js";
-import {
-    HighlightSerializationUpgrader_0_1
-} from "../../graphics/ecs/highlight/HighlightSerializationUpgrader_0_1.js";
-import { LightSerializationAdapter } from "../../graphics/ecs/light/LightSerializationAdapter.js";
-import {
-    SGMeshSerializationAdapter
-} from "../../graphics/ecs/mesh-v2/aggregate/serialization/SGMeshSerializationAdapter.js";
-import Water from "../../graphics/ecs/water/Water.js";
-import { WaterSerializationAdapter } from "../../graphics/ecs/water/WaterSerializationAdapter.js";
-import { WaterSerializationUpgrader_0_1 } from "../../graphics/ecs/water/WaterSerializationUpgrader_0_1.js";
-import { ParticleEmitter } from "../../graphics/particles/particular/engine/emitter/ParticleEmitter.js";
-import {
-    ParticleEmitterSerializationAdapter
-} from "../../graphics/particles/particular/engine/emitter/serde/ParticleEmitterSerializationAdapter.js";
-import {
-    ParticleEmitterSerializationUpgrader_0_1
-} from "../../graphics/particles/particular/engine/emitter/serde/ParticleEmitterSerializationUpgrader_0_1.js";
-import { GridPosition2Transform } from "../../grid/grid2transform/GridPosition2Transform.js";
-import {
-    GridPosition2TransformSerializationAdapter
-} from "../../grid/grid2transform/GridPosition2TransformSerializationAdapter.js";
-import {
-    GridPosition2TransformSerializationUpgrader_0_1
-} from "../../grid/grid2transform/GridPosition2TransformSerializationUpgrader_0_1.js";
-import { GridObstacleSerializationAdapter } from "../../grid/obstacle/GridObstacleSerializationAdapter.js";
-import GridPosition from "../../grid/position/GridPosition.js";
-import { GridPositionSerializationAdapter } from "../../grid/position/GridPositionSerializationAdapter.js";
-import {
-    GridPositionSerializationUpdater_0_1
-} from "../../grid/position/GridPositionSerializationUpdater_0_1.js";
-import {
-    ParallelBehaviorSerializationAdapter
-} from "../../intelligence/behavior/composite/ParallelBehaviorSerializationAdapter.js";
-import {
-    SequenceBehaviorSerializationAdapter
-} from "../../intelligence/behavior/composite/SequenceBehaviorSerializationAdapter.js";
-import {
-    InvertStatusBehaviorSerializationAdapter
-} from "../../intelligence/behavior/decorator/InvertStatusBehaviorSerializationAdapter.js";
-import {
-    RepeatBehaviorSerializationAdapter
-} from "../../intelligence/behavior/decorator/RepeatBehaviorSerializationAdapter.js";
-import {
-    BehaviorComponentSerializationAdapter
-} from "../../intelligence/behavior/ecs/BehaviorComponentSerializationAdapter.js";
-import {
-    WaitForEventBehaviorSerializationAdapter
-} from "../../intelligence/behavior/ecs/WaitForEventBehaviorSerializationAdapter.js";
-import {
-    FailingBehaviorSerializationAdapter
-} from "../../intelligence/behavior/primitive/FailingBehaviorSerializationAdapter.js";
-import {
-    SucceedingBehaviorSerializationAdapter
-} from "../../intelligence/behavior/primitive/SucceedingBehaviorSerializationAdapter.js";
-import { BlackboardSerializationAdapter } from "../../intelligence/blackboard/BlackboardSerializationAdapter.js";
-import Path from "../../navigation/ecs/components/Path.js";
-import { PathSerializationAdapter } from "../../navigation/ecs/components/PathSerializationAdapter.js";
-import {
-    PathSerializationUpgrader_0_1
-} from "../../navigation/ecs/components/PathSerializationUpgrader_0_1.js";
-import {
-    PathSerializationUpgrader_1_2
-} from "../../navigation/ecs/components/PathSerializationUpgrader_1_2.js";
-import {
-    PathSerializationUpgrader_2_3
-} from "../../navigation/ecs/components/PathSerializationUpgrader_2_3.js";
-import PathFollower from "../../navigation/ecs/path_following/PathFollower.js";
-import {
-    PathFollowerSerializationAdapter
-} from "../../navigation/ecs/path_following/PathFollowerSerializationAdapter.js";
-import {
-    PathFollowerSerializationUpgrader_0_1
-} from "../../navigation/ecs/path_following/PathFollowerSerializationUpgrader_0_1.js";
-import {
-    PathFollowerSerializationUpgrader_1_2
-} from "../../navigation/ecs/path_following/PathFollowerSerializationUpgrader_1_2.js";
-import {
-    PathFollowerSerializationUpgrader_2_3
-} from "../../navigation/ecs/path_following/PathFollowerSerializationUpgrader_2_3.js";
-import {
-    PathFollowerSerializationUpgrader_3_4
-} from "../../navigation/ecs/path_following/PathFollowerSerializationUpgrader_3_4.js";
-import { SoundEmitter } from "../../sound/ecs/emitter/SoundEmitter.js";
-import { SoundEmitterSerializationAdapter } from "../../sound/ecs/emitter/SoundEmitterSerializationAdapter.js";
-import {
-    SoundEmitterSerializationUpgrader_0_1
-} from "../../sound/ecs/emitter/SoundEmitterSerializationUpgrader_0_1.js";
-import {
-    SoundEmitterSerializationUpgrader_1_2
-} from "../../sound/ecs/emitter/SoundEmitterSerializationUpgrader_1_2.js";
-import { SoundControllerSerializationAdapter } from "../../sound/ecs/SoundController.js";
-import { SoundListenerSerializationAdapter } from "../../sound/ecs/SoundListener.js";
-
-/**
- * Registers the serialization adapters and upgraders for every engine-side component type.
- *
- * This is the single source of truth for engine serialization coverage: hosts layer their own
- * component adapters on top and must not re-register engine types (the registry keeps the first
- * registration and warns on duplicates).
- *
- * @param {BinarySerializationRegistry} registry
- */
-export function populateEngineSerializationRegistry(registry) {
-
-    registry.registerAdapters([
-        new TransformSerializationAdapter(),
-        new NameSerializationAdapter(),
-        new TeamSerializationAdapter(),
-        new PathFollowerSerializationAdapter(),
-        new PathSerializationAdapter(),
-        new TagSerializationAdapter(),
-        new ParticleEmitterSerializationAdapter(),
-        new SoundEmitterSerializationAdapter(),
-        new SoundControllerSerializationAdapter(),
-        new SoundListenerSerializationAdapter(),
-        new AnimationSerializationAdapter(),
-        new SGMeshSerializationAdapter(),
-        new TopDownCameraControllerSerializationAdapter(),
-        new TopDownCameraLanderSerializationAdapter(),
-        new CameraSerializationAdapter(),
-        new ClingToTerrainSerializationAdapter(),
-        new TerrainSerializationAdapter(),
-        new WaterSerializationAdapter(),
-        new GridPosition2TransformSerializationAdapter(),
-        new GridObstacleSerializationAdapter(),
-        new GridPositionSerializationAdapter(),
-        new HighlightSerializationAdapter(),
-        new LightSerializationAdapter(),
-        new AnimationControllerSerializationAdapter(),
-        new PropertySetSerializationAdapter(),
-        new FogOfWarSerializationAdapter(),
-        new FogOfWarRevealerSerializationAdapter(),
-        new BlackboardSerializationAdapter(),
-        new SerializationMetadataSerializationAdapter(),
-        new ViewportPositionSerializationAdapter(),
-        new GUIElementSerializationAdapter(),
-        new HeadsUpDisplaySerializationAdapter(),
-        new BehaviorComponentSerializationAdapter(),
-        new InverseKinematicsSerializationAdapter(),
-        new TooltipComponentSerializationAdapter(),
-        new DecalSerializationAdapter(),
-        new PickableSerializationAdapter()
-    ]);
-
-    // behaviors
-    registry.registerAdapters([
-        //primitives
-        new FailingBehaviorSerializationAdapter(),
-        new SucceedingBehaviorSerializationAdapter(),
-
-        //composite
-        new SequenceBehaviorSerializationAdapter(),
-        new ParallelBehaviorSerializationAdapter(),
-
-        //decorators
-        new InvertStatusBehaviorSerializationAdapter(),
-        new RepeatBehaviorSerializationAdapter(),
-
-        //ECS
-        new WaitForEventBehaviorSerializationAdapter()
-    ]);
-
-    //upgraders
-    registry.registerUpgrader(GridPosition2Transform.typeName, new GridPosition2TransformSerializationUpgrader_0_1());
-    registry.registerUpgrader(GridPosition.typeName, new GridPositionSerializationUpdater_0_1());
-    registry.registerUpgrader(Transform.typeName, new TransformSerializationUpgrader_0_1());
-    registry.registerUpgrader(Tag.typeName, new TagSerializationUpgrader_0_1());
-    registry.registerUpgrader(Decal.typeName, new DecalSerializationUpgrader_0_1());
-
-    registry.registerUpgrader(FogOfWar.typeName, new FogOfWarSerializationUpdater_0_1());
-
-    registry.registerUpgrader(Camera.typeName, new CameraSerializationUpgrader_0_1());
-
-    registry.registerUpgrader(Path.typeName, new PathSerializationUpgrader_0_1());
-    registry.registerUpgrader(Path.typeName, new PathSerializationUpgrader_1_2());
-    registry.registerUpgrader(Path.typeName, new PathSerializationUpgrader_2_3());
-
-    registry.registerUpgrader(PathFollower.typeName, new PathFollowerSerializationUpgrader_0_1());
-    registry.registerUpgrader(PathFollower.typeName, new PathFollowerSerializationUpgrader_1_2());
-    registry.registerUpgrader(PathFollower.typeName, new PathFollowerSerializationUpgrader_2_3());
-    registry.registerUpgrader(PathFollower.typeName, new PathFollowerSerializationUpgrader_3_4());
-
-    registry.registerUpgrader(Terrain.typeName, new TerrainSerializationUpgrader_0_1());
-    registry.registerUpgrader(Terrain.typeName, new TerrainSerializationUpgrader_1_2());
-    registry.registerUpgrader(Highlight.typeName, new HighlightSerializationUpgrader_0_1());
-    registry.registerUpgrader(Water.typeName, new WaterSerializationUpgrader_0_1());
-
-    registry.registerUpgrader(SoundEmitter.typeName, new SoundEmitterSerializationUpgrader_0_1());
-    registry.registerUpgrader(SoundEmitter.typeName, new SoundEmitterSerializationUpgrader_1_2());
-
-    registry.registerUpgrader(ParticleEmitter.typeName, new ParticleEmitterSerializationUpgrader_0_1());
-
-    registry.registerUpgrader(TopDownCameraController.typeName, new TopDownCameraControllerSerializationUpgrader_0_1());
-
-    registry.registerUpgrader(ClingToTerrain.typeName, new ClingToTerrainSerializationUpgrader_0_1());
-}
+import { AnimationSerializationAdapter } from "../animation/AnimationSerializationAdapter.js";
+import { PropertySetSerializationAdapter } from "../components/PropertySetSerializationAdapter.js";
+import {
+    SerializationMetadataSerializationAdapter
+} from "../components/SerializationMetadataSerializationAdapter.js";
+import { Tag } from "../components/Tag.js";
+import { TagSerializationAdapter } from "../components/TagSerializationAdapter.js";
+import { TagSerializationUpgrader_0_1 } from "../components/TagSerializationUpgrader_0_1.js";
+import { FogOfWar } from "../fow/FogOfWar.js";
+import {
+    FogOfWarRevealerSerializationAdapter
+} from "../fow/serialization/FogOfWarRevealerSerializationAdapter.js";
+import { FogOfWarSerializationAdapter } from "../fow/serialization/FogOfWarSerializationAdapter.js";
+import { FogOfWarSerializationUpdater_0_1 } from "../fow/serialization/FogOfWarSerializationUpdater_0_1.js";
+import { GUIElementSerializationAdapter } from "../gui/GUIElementSerializationAdapter.js";
+import { HeadsUpDisplaySerializationAdapter } from "../gui/hud/HeadsUpDisplaySerializationAdapter.js";
+import {
+    ViewportPositionSerializationAdapter
+} from "../gui/position/ViewportPositionSerializationAdapter.js";
+import { InverseKinematicsSerializationAdapter } from "../ik/InverseKinematicsSerializationAdapter.js";
+import { NameSerializationAdapter } from "../name/NameSerializationAdapter.js";
+import { TeamSerializationAdapter } from "../team/TeamSerializationAdapter.js";
+import ClingToTerrain from "../terrain/ecs/cling/ClingToTerrain.js";
+import {
+    ClingToTerrainSerializationAdapter
+} from "../terrain/ecs/cling/ClingToTerrainSerializationAdapter.js";
+import {
+    ClingToTerrainSerializationUpgrader_0_1
+} from "../terrain/ecs/cling/ClingToTerrainSerializationUpgrader_0_1.js";
+import Terrain from "../terrain/ecs/Terrain.js";
+import { TerrainSerializationAdapter } from "../terrain/serialization/TerrainSerializationAdapter.js";
+import {
+    TerrainSerializationUpgrader_0_1
+} from "../terrain/serialization/TerrainSerializationUpgrader_0_1.js";
+import {
+    TerrainSerializationUpgrader_1_2
+} from "../terrain/serialization/TerrainSerializationUpgrader_1_2.js";
+import { TooltipComponentSerializationAdapter } from "../tooltip/TooltipComponentSerializationAdapter.js";
+import { PickableSerializationAdapter } from "../../graphics3/Pickable.js";
+import {
+    VolumetricLightMapSerializationAdapter
+} from "../../graphics3/VolumetricLightMapSerializationAdapter.js";
+import { Transform } from "../transform/Transform.js";
+import { TransformSerializationAdapter } from "../transform/TransformSerializationAdapter.js";
+import { TransformSerializationUpgrader_0_1 } from "../transform/TransformSerializationUpgrader_0_1.js";
+import {
+    AnimationControllerSerializationAdapter
+} from "../../graphics/ecs/animation/AnimationControllerSerializationAdapter.js";
+import { Camera } from "../../graphics/ecs/camera/Camera.js";
+import {
+    CameraSerializationAdapter
+} from "../../graphics/ecs/camera/serialization/CameraSerializationAdapter.js";
+import {
+    CameraSerializationUpgrader_0_1
+} from "../../graphics/ecs/camera/serialization/CameraSerializationUpgrader_0_1.js";
+import TopDownCameraController from "../../graphics/ecs/camera/topdown/TopDownCameraController.js";
+import {
+    TopDownCameraControllerSerializationAdapter
+} from "../../graphics/ecs/camera/topdown/TopDownCameraControllerSerializationAdapter.js";
+import {
+    TopDownCameraControllerSerializationUpgrader_0_1
+} from "../../graphics/ecs/camera/topdown/TopDownCameraControllerSerializationUpgrader_0_1.js";
+import {
+    TopDownCameraLanderSerializationAdapter
+} from "../../graphics/ecs/camera/topdown/TopDownCameraLander.js";
+import { Decal } from "../../graphics/ecs/decal/v2/Decal.js";
+import { DecalSerializationAdapter } from "../../graphics/ecs/decal/v2/DecalSerializationAdapter.js";
+import {
+    DecalSerializationUpgrader_0_1
+} from "../../graphics/ecs/decal/v2/DecalSerializationUpgrader_0_1.js";
+import Highlight from "../../graphics/ecs/highlight/Highlight.js";
+import { HighlightSerializationAdapter } from "../../graphics/ecs/highlight/HighlightSerializationAdapter.js";
+import {
+    HighlightSerializationUpgrader_0_1
+} from "../../graphics/ecs/highlight/HighlightSerializationUpgrader_0_1.js";
+import { LightSerializationAdapter } from "../../graphics/ecs/light/LightSerializationAdapter.js";
+import {
+    SGMeshSerializationAdapter
+} from "../../graphics/ecs/mesh-v2/aggregate/serialization/SGMeshSerializationAdapter.js";
+import Water from "../../graphics/ecs/water/Water.js";
+import { WaterSerializationAdapter } from "../../graphics/ecs/water/WaterSerializationAdapter.js";
+import { WaterSerializationUpgrader_0_1 } from "../../graphics/ecs/water/WaterSerializationUpgrader_0_1.js";
+import { ParticleEmitter } from "../../graphics/particles/particular/engine/emitter/ParticleEmitter.js";
+import {
+    ParticleEmitterSerializationAdapter
+} from "../../graphics/particles/particular/engine/emitter/serde/ParticleEmitterSerializationAdapter.js";
+import {
+    ParticleEmitterSerializationUpgrader_0_1
+} from "../../graphics/particles/particular/engine/emitter/serde/ParticleEmitterSerializationUpgrader_0_1.js";
+import { GridPosition2Transform } from "../../grid/grid2transform/GridPosition2Transform.js";
+import {
+    GridPosition2TransformSerializationAdapter
+} from "../../grid/grid2transform/GridPosition2TransformSerializationAdapter.js";
+import {
+    GridPosition2TransformSerializationUpgrader_0_1
+} from "../../grid/grid2transform/GridPosition2TransformSerializationUpgrader_0_1.js";
+import { GridObstacleSerializationAdapter } from "../../grid/obstacle/GridObstacleSerializationAdapter.js";
+import GridPosition from "../../grid/position/GridPosition.js";
+import { GridPositionSerializationAdapter } from "../../grid/position/GridPositionSerializationAdapter.js";
+import {
+    GridPositionSerializationUpdater_0_1
+} from "../../grid/position/GridPositionSerializationUpdater_0_1.js";
+import {
+    ParallelBehaviorSerializationAdapter
+} from "../../intelligence/behavior/composite/ParallelBehaviorSerializationAdapter.js";
+import {
+    SequenceBehaviorSerializationAdapter
+} from "../../intelligence/behavior/composite/SequenceBehaviorSerializationAdapter.js";
+import {
+    InvertStatusBehaviorSerializationAdapter
+} from "../../intelligence/behavior/decorator/InvertStatusBehaviorSerializationAdapter.js";
+import {
+    RepeatBehaviorSerializationAdapter
+} from "../../intelligence/behavior/decorator/RepeatBehaviorSerializationAdapter.js";
+import {
+    BehaviorComponentSerializationAdapter
+} from "../../intelligence/behavior/ecs/BehaviorComponentSerializationAdapter.js";
+import {
+    WaitForEventBehaviorSerializationAdapter
+} from "../../intelligence/behavior/ecs/WaitForEventBehaviorSerializationAdapter.js";
+import {
+    FailingBehaviorSerializationAdapter
+} from "../../intelligence/behavior/primitive/FailingBehaviorSerializationAdapter.js";
+import {
+    SucceedingBehaviorSerializationAdapter
+} from "../../intelligence/behavior/primitive/SucceedingBehaviorSerializationAdapter.js";
+import { BlackboardSerializationAdapter } from "../../intelligence/blackboard/BlackboardSerializationAdapter.js";
+import Path from "../../navigation/ecs/components/Path.js";
+import { PathSerializationAdapter } from "../../navigation/ecs/components/PathSerializationAdapter.js";
+import {
+    PathSerializationUpgrader_0_1
+} from "../../navigation/ecs/components/PathSerializationUpgrader_0_1.js";
+import {
+    PathSerializationUpgrader_1_2
+} from "../../navigation/ecs/components/PathSerializationUpgrader_1_2.js";
+import {
+    PathSerializationUpgrader_2_3
+} from "../../navigation/ecs/components/PathSerializationUpgrader_2_3.js";
+import PathFollower from "../../navigation/ecs/path_following/PathFollower.js";
+import {
+    PathFollowerSerializationAdapter
+} from "../../navigation/ecs/path_following/PathFollowerSerializationAdapter.js";
+import {
+    PathFollowerSerializationUpgrader_0_1
+} from "../../navigation/ecs/path_following/PathFollowerSerializationUpgrader_0_1.js";
+import {
+    PathFollowerSerializationUpgrader_1_2
+} from "../../navigation/ecs/path_following/PathFollowerSerializationUpgrader_1_2.js";
+import {
+    PathFollowerSerializationUpgrader_2_3
+} from "../../navigation/ecs/path_following/PathFollowerSerializationUpgrader_2_3.js";
+import {
+    PathFollowerSerializationUpgrader_3_4
+} from "../../navigation/ecs/path_following/PathFollowerSerializationUpgrader_3_4.js";
+import { SoundEmitter } from "../../sound/ecs/emitter/SoundEmitter.js";
+import { SoundEmitterSerializationAdapter } from "../../sound/ecs/emitter/SoundEmitterSerializationAdapter.js";
+import {
+    SoundEmitterSerializationUpgrader_0_1
+} from "../../sound/ecs/emitter/SoundEmitterSerializationUpgrader_0_1.js";
+import {
+    SoundEmitterSerializationUpgrader_1_2
+} from "../../sound/ecs/emitter/SoundEmitterSerializationUpgrader_1_2.js";
+import { SoundControllerSerializationAdapter } from "../../sound/ecs/SoundController.js";
+import { SoundListenerSerializationAdapter } from "../../sound/ecs/SoundListener.js";
+
+/**
+ * Registers the serialization adapters and upgraders for every engine-side component type.
+ *
+ * This is the single source of truth for engine serialization coverage: hosts layer their own
+ * component adapters on top and must not re-register engine types (the registry keeps the first
+ * registration and warns on duplicates).
+ *
+ * @param {BinarySerializationRegistry} registry
+ */
+export function populateEngineSerializationRegistry(registry) {
+
+    registry.registerAdapters([
+        new TransformSerializationAdapter(),
+        new NameSerializationAdapter(),
+        new TeamSerializationAdapter(),
+        new PathFollowerSerializationAdapter(),
+        new PathSerializationAdapter(),
+        new TagSerializationAdapter(),
+        new ParticleEmitterSerializationAdapter(),
+        new SoundEmitterSerializationAdapter(),
+        new SoundControllerSerializationAdapter(),
+        new SoundListenerSerializationAdapter(),
+        new AnimationSerializationAdapter(),
+        new SGMeshSerializationAdapter(),
+        new TopDownCameraControllerSerializationAdapter(),
+        new TopDownCameraLanderSerializationAdapter(),
+        new CameraSerializationAdapter(),
+        new ClingToTerrainSerializationAdapter(),
+        new TerrainSerializationAdapter(),
+        new WaterSerializationAdapter(),
+        new GridPosition2TransformSerializationAdapter(),
+        new GridObstacleSerializationAdapter(),
+        new GridPositionSerializationAdapter(),
+        new HighlightSerializationAdapter(),
+        new LightSerializationAdapter(),
+        new AnimationControllerSerializationAdapter(),
+        new PropertySetSerializationAdapter(),
+        new FogOfWarSerializationAdapter(),
+        new FogOfWarRevealerSerializationAdapter(),
+        new BlackboardSerializationAdapter(),
+        new SerializationMetadataSerializationAdapter(),
+        new ViewportPositionSerializationAdapter(),
+        new GUIElementSerializationAdapter(),
+        new HeadsUpDisplaySerializationAdapter(),
+        new BehaviorComponentSerializationAdapter(),
+        new InverseKinematicsSerializationAdapter(),
+        new TooltipComponentSerializationAdapter(),
+        new DecalSerializationAdapter(),
+        new PickableSerializationAdapter(),
+        new VolumetricLightMapSerializationAdapter()
+    ]);
+
+    // behaviors
+    registry.registerAdapters([
+        //primitives
+        new FailingBehaviorSerializationAdapter(),
+        new SucceedingBehaviorSerializationAdapter(),
+
+        //composite
+        new SequenceBehaviorSerializationAdapter(),
+        new ParallelBehaviorSerializationAdapter(),
+
+        //decorators
+        new InvertStatusBehaviorSerializationAdapter(),
+        new RepeatBehaviorSerializationAdapter(),
+
+        //ECS
+        new WaitForEventBehaviorSerializationAdapter()
+    ]);
+
+    //upgraders
+    registry.registerUpgrader(GridPosition2Transform.typeName, new GridPosition2TransformSerializationUpgrader_0_1());
+    registry.registerUpgrader(GridPosition.typeName, new GridPositionSerializationUpdater_0_1());
+    registry.registerUpgrader(Transform.typeName, new TransformSerializationUpgrader_0_1());
+    registry.registerUpgrader(Tag.typeName, new TagSerializationUpgrader_0_1());
+    registry.registerUpgrader(Decal.typeName, new DecalSerializationUpgrader_0_1());
+
+    registry.registerUpgrader(FogOfWar.typeName, new FogOfWarSerializationUpdater_0_1());
+
+    registry.registerUpgrader(Camera.typeName, new CameraSerializationUpgrader_0_1());
+
+    registry.registerUpgrader(Path.typeName, new PathSerializationUpgrader_0_1());
+    registry.registerUpgrader(Path.typeName, new PathSerializationUpgrader_1_2());
+    registry.registerUpgrader(Path.typeName, new PathSerializationUpgrader_2_3());
+
+    registry.registerUpgrader(PathFollower.typeName, new PathFollowerSerializationUpgrader_0_1());
+    registry.registerUpgrader(PathFollower.typeName, new PathFollowerSerializationUpgrader_1_2());
+    registry.registerUpgrader(PathFollower.typeName, new PathFollowerSerializationUpgrader_2_3());
+    registry.registerUpgrader(PathFollower.typeName, new PathFollowerSerializationUpgrader_3_4());
+
+    registry.registerUpgrader(Terrain.typeName, new TerrainSerializationUpgrader_0_1());
+    registry.registerUpgrader(Terrain.typeName, new TerrainSerializationUpgrader_1_2());
+    registry.registerUpgrader(Highlight.typeName, new HighlightSerializationUpgrader_0_1());
+    registry.registerUpgrader(Water.typeName, new WaterSerializationUpgrader_0_1());
+
+    registry.registerUpgrader(SoundEmitter.typeName, new SoundEmitterSerializationUpgrader_0_1());
+    registry.registerUpgrader(SoundEmitter.typeName, new SoundEmitterSerializationUpgrader_1_2());
+
+    registry.registerUpgrader(ParticleEmitter.typeName, new ParticleEmitterSerializationUpgrader_0_1());
+
+    registry.registerUpgrader(TopDownCameraController.typeName, new TopDownCameraControllerSerializationUpgrader_0_1());
+
+    registry.registerUpgrader(ClingToTerrain.typeName, new ClingToTerrainSerializationUpgrader_0_1());
+}

package/src/engine/graphics3/VolumetricLightMap.d.ts

@@ -0,0 +1,90 @@
+/**
+ * A baked volumetric lightmap, as the bytes the GPU wants and nothing else.
+ *
+ * **The scene has one of these, and this component is which one.** Shade keeps a single
+ * `Brick4LightMap` per scene — one buffer, read by every indirect-lighting pass while the renderer
+ * is in Brick4 mode — so a level's lightmap is a property of the level, not of a thing standing in
+ * it. Making it a component is what gives it a lifetime an entity already has: it arrives when the
+ * level's entity is built, it is saved with it, and it goes away when the entity does. See
+ * {@link VolumetricLightMapSystem3} for what happens when two entities claim the scene at once.
+ *
+ * **The payload is opaque here on purpose.** It is brick4's own GPU structure — the format
+ * `brick4_to_gpu_structure` writes and the indirect-lighting shaders read — and everything inside
+ * it, the node layout, the probe section, the SH encoding, is the renderer's business. This
+ * component neither validates it nor knows how to make one; a bake writes it, a load reads it off
+ * disk, and this carries it.
+ *
+ * **It is not placed by the entity's transform, and does not need one.** A brick4 structure begins
+ * with the world-space bounds it was baked against, so the map already knows where it is. Moving
+ * the entity that carries it moves nothing.
+ *
+ * @see VolumetricLightMapSystem3
+ * @see Brick4LightMap
+ */
+export class VolumetricLightMap {
+    /**
+     * @param {*} json
+     * @returns {VolumetricLightMap}
+     */
+    static fromJSON(json: any): VolumetricLightMap;
+    /**
+     * @param {ArrayBuffer|null} value
+     */
+    set data(arg: ArrayBuffer);
+    /**
+     * The baked structure, or `null` while there isn't one.
+     *
+     * `null` is a normal state, not a broken one: the component says the entity carries the scene's
+     * lightmap, and the bytes may still be loading. A `null` map lights the scene with nothing.
+     *
+     * @returns {ArrayBuffer|null}
+     */
+    get data(): ArrayBuffer;
+    /**
+     * Bumped every time {@link data} is assigned.
+     *
+     * What the system watches to decide whether the GPU is behind. A megabyte-scale upload per frame
+     * would be the alternative, and comparing the buffers to avoid it costs a full read of both.
+     *
+     * **Assignment is the only thing that moves this.** Writing into the `ArrayBuffer` in place goes
+     * unnoticed — publish such a change by assigning `data` again, even to the same buffer.
+     *
+     * @returns {number}
+     */
+    get version(): number;
+    /**
+     * The bytes, base64'd.
+     *
+     * A lightmap runs to megabytes and base64 adds a third on top of that, so this is the expensive
+     * way to move one and the binary adapter is the cheap one. It exists because a blueprint that
+     * silently dropped the map would be worse than a large blueprint.
+     *
+     * @see VolumetricLightMapSerializationAdapter
+     */
+    toJSON(): {
+        data: string;
+    };
+    /**
+     * @param {string|null} [data]
+     */
+    fromJSON({ data }?: string | null): void;
+    /**
+     * The byte length, and deliberately not the bytes.
+     *
+     * Hashing megabytes to answer "are these two the same component" is not a trade worth making,
+     * and a hash is allowed to collide. {@link equals} is the one that reads the buffer.
+     *
+     * @returns {number}
+     */
+    hash(): number;
+    /**
+     * @param {VolumetricLightMap} other
+     * @returns {boolean}
+     */
+    equals(other: VolumetricLightMap): boolean;
+    #private;
+}
+export namespace VolumetricLightMap {
+    let typeName: string;
+}
+//# sourceMappingURL=VolumetricLightMap.d.ts.map