feat: Add Spear of Destiny demo support with dedicated asset registry and entity definitions

- Introduced SpearDemoAssetRegistry for managing assets specific to the Spear of Destiny demo.
- Created SpearDemoEntityModule to define enemy animations with adjusted sprite ranges.
- Implemented SpearDemoHudModule and SpearDemoMenuPicModule for HUD and menu assets.
- Added SpearDemoSfxModule for sound effect mappings specific to the demo version.
- Updated enemy classes (Guard, Mutant, Officer, SS) to support custom animation sets.
- Modified entity registry to accept a custom AssetRegistry for spawning entities.
- Enhanced rendering with CRT phosphor bloom effect in GLSL shaders.
- Adjusted ASCII and software renderer layouts for improved UI spacing.
- Added tests for SpearDemoAssetRegistry to ensure correct asset resolution and enemy spawning.

Signed-off-by: Hans Kokx <hans.d.kokx@gmail.com>

packages/wolf_3d_dart/lib/src/synth/wolf_3d_audio.dart

@@ -152,6 +152,20 @@ class WolfAudio implements EngineAudio {
   Future<void> playSoundEffect(SoundEffect effect) async {
     final data = activeGame;
     if (data == null) return;
+
+    final resolved = data.registry.sfx.resolve(effect);
+    if (resolved != null) {
+      await playSoundEffectId(resolved.slotIndex);
+      return;
+    }
+
+    // Spear demo/shareware has a much smaller digitized table than retail.
+    // If a sound is not explicitly mapped for that variant, skip it rather
+    // than probing an invalid or unrelated slot.
+    if (data.version == GameVersion.spearOfDestinyDemo) {
+      return;
+    }
+
     await playSoundEffectId(effect.idFor(data.version));
   }