refactor(pipeline): MP1a - MeshExtractor extracted to AcDream.Content (verbatim move)

src/AcDream.Content/IDatReaderWriter.cs

@@ -0,0 +1,121 @@
+using DatReaderWriter;
+using DatReaderWriter.Enums;
+using DatReaderWriter.Lib.IO;
+using System.Collections.ObjectModel;
+using System.Diagnostics.CodeAnalysis;
+
+// Phase O-T7: verbatim copy of WorldBuilder.Shared.Services.IDatReaderWriter +
+// IDatDatabase into the AcDream.App.Rendering.Wb namespace so the
+// WorldBuilder.Shared project reference can be dropped.
+// The only consumer of IDatReaderWriter in acdream is DatCollectionAdapter +
+// ObjectMeshManager, both already in this namespace.
+//
+// MP1a (2026-07-05, Task 4): moved to AcDream.Content, namespace only —
+// MeshExtractor's constructor takes IDatReaderWriter and must be GL-free.
+// DatCollectionAdapter (the concrete DatCollection-backed implementation)
+// stays in AcDream.App; it now implements this Content-namespaced interface.
+
+namespace AcDream.Content;
+
+/// <summary>
+/// Interface for the dat reader/writer
+/// </summary>
+public interface IDatReaderWriter : IDisposable {
+    /// <summary>
+    /// Gets the source directory of the DAT files.
+    /// </summary>
+    string SourceDirectory { get; }
+
+    /// <summary>
+    /// Tries to get the raw bytes of a file from a specific region database.
+    /// </summary>
+    bool TryGetFileBytes(uint regionId, uint fileId, ref byte[] bytes, out int bytesRead);
+
+    /// <summary>
+    /// The portal database
+    /// </summary>
+    IDatDatabase Portal { get; }
+
+    /// <summary>
+    /// The cell region databases. Each key is a cell region ID
+    /// </summary>
+    ReadOnlyDictionary<uint, IDatDatabase> CellRegions { get; }
+
+    /// <summary>
+    /// The high res database
+    /// </summary>
+    IDatDatabase HighRes { get; }
+
+    /// <summary>
+    /// The language database
+    /// </summary>
+    IDatDatabase Language { get; }
+
+    /// <summary>
+    /// A mapping of region ids to region dat file entry ids. key: region id, value: region dat file entry
+    /// </summary>
+    ReadOnlyDictionary<uint, uint> RegionFileMap { get; }
+
+    /// <summary>
+    /// Gets the current portal iteration.
+    /// </summary>
+    int PortalIteration { get; }
+
+    /// <summary>
+    /// Gets the current cell iteration (from the first cell region).
+    /// </summary>
+    int CellIteration { get; }
+
+    /// <summary>
+    /// Gets the current high res iteration.
+    /// </summary>
+    int HighResIteration { get; }
+
+    /// <summary>
+    /// Gets the current language iteration.
+    /// </summary>
+    int LanguageIteration { get; }
+
+    // Write-path methods — preserved from WB's interface for verbatim
+    // compatibility but not exercised by ObjectMeshManager in acdream.
+    /// <summary>Attempts to save a database object to the appropriate DAT.</summary>
+    bool TrySave<T>(T obj, int iteration = 0) where T : IDBObj;
+
+    /// <summary>Attempts to save a database object to the appropriate DAT for a specific region.</summary>
+    bool TrySave<T>(uint regionId, T obj, int iteration = 0) where T : IDBObj;
+
+    /// <summary>
+    /// Resolution of a data ID to a database and type
+    /// </summary>
+    public record IdResolution(IDatDatabase Database, DBObjType Type);
+
+    /// <summary>
+    /// Resolves a data ID to all possible databases and types.
+    /// </summary>
+    public IEnumerable<IdResolution> ResolveId(uint id);
+}
+
+/// <summary>
+/// Interface for a dat database, providing methods to retrieve files and objects.
+/// </summary>
+public interface IDatDatabase : IDisposable {
+    DatDatabase Db { get; }
+
+    /// <summary>Retrieves the current iteration of the database.</summary>
+    int Iteration { get; }
+
+    /// <summary>Retrieves all file IDs of a specific type.</summary>
+    public IEnumerable<uint> GetAllIdsOfType<T>() where T : IDBObj;
+
+    /// <summary>Attempts to retrieve a database object by its file ID.</summary>
+    public bool TryGet<T>(uint fileId, [MaybeNullWhen(false)] out T value) where T : IDBObj;
+
+    /// <summary>Attempts to retrieve the raw bytes of a file by its ID.</summary>
+    bool TryGetFileBytes(uint fileId, [MaybeNullWhen(false)] out byte[] value);
+
+    /// <summary>Attempts to retrieve the raw bytes of a file by its ID into a provided buffer.</summary>
+    bool TryGetFileBytes(uint fileId, ref byte[] bytes, out int bytesRead);
+
+    /// <summary>Attempts to save a database object.</summary>
+    bool TrySave<T>(T obj, int iteration = 0) where T : IDBObj;
+}