Refactor and enhance documentation across the Wolf3D project

- Updated library imports to use the correct package paths for consistency.
- Added detailed documentation comments to various classes and methods, improving code readability and maintainability.
- Refined the GameSelectScreen, SpriteGallery, and VgaGallery classes with clearer descriptions of their functionality.
- Enhanced the CliInput class to better explain the input handling process and its interaction with the engine.
- Improved the SixelRasterizer and Opl2Emulator classes with comprehensive comments on their operations and state management.
- Removed the deprecated wolf_3d.dart file and consolidated its functionality into wolf_3d_flutter.dart for a cleaner architecture.
- Updated the Wolf3dFlutterInput class to clarify its role in merging keyboard and pointer events.
- Enhanced the rendering classes to provide better context on their purpose and usage within the Flutter framework.

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

packages/wolf_3d_dart/lib/wolf_3d_engine.dart

@@ -1,6 +1,8 @@
-/// Support for doing something awesome.
+/// Public engine exports for the Wolfenstein 3D runtime.
 ///
-/// More dartdocs go here.
+/// Import this library when building a host around the core simulation.
+/// It re-exports the frame-based engine, audio abstractions, input DTOs,
+/// state managers, and player model needed by CLI, Flutter, and tests.
 library;
 
 export 'src/engine/audio/engine_audio.dart';