@woosh/meep-engine 3.11.0 → 3.11.2

package/package.json

@@ -6,7 +6,7 @@
   "description": "Pure JavaScript game engine. Fully featured and production ready.",
   "type": "module",
   "author": "Alexander Goldring",
-  "version": "3.11.0",
+  "version": "3.11.2",
   "exports": {
     "./build/*": "./build/*",
     "./src/*": "./src/*",

package/src/engine/ecs/storage/populateEngineSerializationRegistry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"populateEngineSerializationRegistry.d.ts","sourceRoot":"","sources":["../../../../../src/engine/ecs/storage/populateEngineSerializationRegistry.js"],"names":[],"mappings":"AA+KA;;;;;;;;GAQG;AACH,iGAyGC"}
+{"version":3,"file":"populateEngineSerializationRegistry.d.ts","sourceRoot":"","sources":["../../../../../src/engine/ecs/storage/populateEngineSerializationRegistry.js"],"names":[],"mappings":"AAkLA;;;;;;;;GAQG;AACH,iGA0GC"}

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

@@ -1,290 +1,294 @@
-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/sopra/legacy/SoundEmitter.js";
-import { SoundEmitterSerializationAdapter } from "../../sound/sopra/legacy/SoundEmitterSerializationAdapter.js";
-import {
-    SoundEmitterSerializationUpgrader_0_1
-} from "../../sound/sopra/legacy/SoundEmitterSerializationUpgrader_0_1.js";
-import {
-    SoundEmitterSerializationUpgrader_1_2
-} from "../../sound/sopra/legacy/SoundEmitterSerializationUpgrader_1_2.js";
-import { SoundControllerSerializationAdapter } from "../../sound/sopra/legacy/SoundController.js";
-import { SoundListenerSerializationAdapter } from "../../sound/ecs/SoundListener.js";
-import { AudioEmitterSerializationAdapter } from "../../sound/ecs/audio/AudioEmitterSerializationAdapter.js";
-import {
-    AudioEventTriggerSerializationAdapter
-} from "../../sound/ecs/trigger/AudioEventTriggerSerializationAdapter.js";
-import {
-    populateAcousticSerializationRegistry
-} from "../../sound/simulation/serialization/populateAcousticSerializationRegistry.js";
-import {
-    populateSopraSerializationRegistry
-} from "../../sound/sopra/serialization/populateSopraSerializationRegistry.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) {
-
-    // Value types the component adapters below reach through the engine's BinaryObjectSerializationAdapter,
-    // which is built from THIS registry: an AudioEmitter's EventDescription owns a polymorphic clip graph
-    // (sample / sequence / random / switch / blend) plus effects, and the acoustic components carry
-    // materials / media / directivity. Without these the object adapter cannot name those types and an
-    // AudioEmitter cannot be written at all. Registered first so a host that also calls one of them gets the
-    // engine's registration rather than a duplicate warning.
-    populateSopraSerializationRegistry(registry);
-    populateAcousticSerializationRegistry(registry);
-
-    registry.registerAdapters([
-        new TransformSerializationAdapter(),
-        new NameSerializationAdapter(),
-        new TeamSerializationAdapter(),
-        new PathFollowerSerializationAdapter(),
-        new PathSerializationAdapter(),
-        new TagSerializationAdapter(),
-        new ParticleEmitterSerializationAdapter(),
-        new SoundEmitterSerializationAdapter(),
-        new SoundControllerSerializationAdapter(),
-        new SoundListenerSerializationAdapter(),
-        new AudioEmitterSerializationAdapter(),
-        new AudioEventTriggerSerializationAdapter(),
-        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());
-}
+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 {
+    ParticipatingMediaSerializationAdapter
+} from "../../graphics3/ParticipatingMediaSerializationAdapter.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/sopra/legacy/SoundEmitter.js";
+import { SoundEmitterSerializationAdapter } from "../../sound/sopra/legacy/SoundEmitterSerializationAdapter.js";
+import {
+    SoundEmitterSerializationUpgrader_0_1
+} from "../../sound/sopra/legacy/SoundEmitterSerializationUpgrader_0_1.js";
+import {
+    SoundEmitterSerializationUpgrader_1_2
+} from "../../sound/sopra/legacy/SoundEmitterSerializationUpgrader_1_2.js";
+import { SoundControllerSerializationAdapter } from "../../sound/sopra/legacy/SoundController.js";
+import { SoundListenerSerializationAdapter } from "../../sound/ecs/SoundListener.js";
+import { AudioEmitterSerializationAdapter } from "../../sound/ecs/audio/AudioEmitterSerializationAdapter.js";
+import {
+    AudioEventTriggerSerializationAdapter
+} from "../../sound/ecs/trigger/AudioEventTriggerSerializationAdapter.js";
+import {
+    populateAcousticSerializationRegistry
+} from "../../sound/simulation/serialization/populateAcousticSerializationRegistry.js";
+import {
+    populateSopraSerializationRegistry
+} from "../../sound/sopra/serialization/populateSopraSerializationRegistry.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) {
+
+    // Value types the component adapters below reach through the engine's BinaryObjectSerializationAdapter,
+    // which is built from THIS registry: an AudioEmitter's EventDescription owns a polymorphic clip graph
+    // (sample / sequence / random / switch / blend) plus effects, and the acoustic components carry
+    // materials / media / directivity. Without these the object adapter cannot name those types and an
+    // AudioEmitter cannot be written at all. Registered first so a host that also calls one of them gets the
+    // engine's registration rather than a duplicate warning.
+    populateSopraSerializationRegistry(registry);
+    populateAcousticSerializationRegistry(registry);
+
+    registry.registerAdapters([
+        new TransformSerializationAdapter(),
+        new NameSerializationAdapter(),
+        new TeamSerializationAdapter(),
+        new PathFollowerSerializationAdapter(),
+        new PathSerializationAdapter(),
+        new TagSerializationAdapter(),
+        new ParticleEmitterSerializationAdapter(),
+        new SoundEmitterSerializationAdapter(),
+        new SoundControllerSerializationAdapter(),
+        new SoundListenerSerializationAdapter(),
+        new AudioEmitterSerializationAdapter(),
+        new AudioEventTriggerSerializationAdapter(),
+        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(),
+        new ParticipatingMediaSerializationAdapter()
+    ]);
+
+    // 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());
+}