Reorgnaize namespaces, rename class names and add various other improvements

CHANGELOG.md

@@ -17,6 +17,9 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 - A constructor with a boolean argument in `Blowfish`.
 - `Workspace` parameter in deserialize methods in `Toolkit`.
 - Helper methods for `VersionInfo`.
+- Helper version crc calculator method for `MetaClass`.
+- Better `TTArchive` compression detection.
+- A dedicated `Compression` class.
 
 ### Changed
 - Rename the following MetaStream implementations: `MetaStreamReader`/`MetaStreamWriter` to  `BinaryMetaStreamReader`/`BinaryMetaStreamWriter`.
@@ -28,6 +31,8 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 - Reorganize some namespaces.
 - Make the default serializer not throw errors and use logger instead.
 - `Serialize` from `MetaStream` now automatically preserializes.
+- Namespaces organization. (#24)
+- Various class names. (#24)
 
 ### Fixed
 - A regression that did not allow files being copied to the output folder.
@@ -39,6 +44,7 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 - `AreSymbolsHashed` from `GameProfile` as symbols are always hashed.
 - `PreSerialize` from `MetaStream`.
 - Redundant `Version` from `MetaStreamParams`.
+- Unused `ISymbolResolver` interface.
 
 ## [0.2.0] - 2026-05-28
 

samples/VersionDatabaseCreator/Program.cs

@@ -4,13 +4,14 @@
 using System.Text.Encodings.Web;
 using System.Text.Json;
 using TelltaleToolKit;
-using TelltaleToolKit.GamesDatabase;
-using TelltaleToolKit.Reflection;
-using TelltaleToolKit.Serialization;
-using TelltaleToolKit.Serialization.Binary;
-using TelltaleToolKit.TelltaleArchives;
-using TelltaleToolKit.Utility.Blowfish;
-using TelltaleToolKit.Utility.Lua;
+using TelltaleToolKit.Encryption;
+using TelltaleToolKit.Games;
+using TelltaleToolKit.IO.Archives;
+using TelltaleToolKit.Lua;
+using TelltaleToolKit.Meta;
+using TelltaleToolKit.Meta.Reflection;
+using TelltaleToolKit.Meta.Serialization;
+using TelltaleToolKit.Meta.Serialization.Binary;
 
 // !!!IMPORTANT!!!
 // This project creates ONLY the VERSION DATABASE for a specific game.

src/TelltaleToolKit/Utility/Blowfish/Blowfish.cs → src/TelltaleToolKit/Encryption/Blowfish.cs

@@ -1,7 +1,7 @@
 using System.Buffers.Binary;
 using System.Text;
 
-namespace TelltaleToolKit.Utility.Blowfish;
+namespace TelltaleToolKit.Encryption;
 
 /// <summary>
 ///     Class that provides 'Blowfish' encryption.

src/TelltaleToolKit/Utility/Blowfish/BlowfishConstants.cs → src/TelltaleToolKit/Encryption/BlowfishConstants.cs

@@ -1,4 +1,4 @@
-namespace TelltaleToolKit.Utility.Blowfish;
+namespace TelltaleToolKit.Encryption;
 
 public static class BlowfishConstants
 {

src/TelltaleToolKit/Serialization/Binary/LegacyEncryption.cs → src/TelltaleToolKit/Encryption/LegacyEncryption.cs

@@ -1,8 +1,7 @@
 using System.Buffers;
-using System.Buffers.Binary;
-using TelltaleToolKit.Utility.Blowfish;
+using TelltaleToolKit.Meta.Serialization;
 
-namespace TelltaleToolKit.Serialization.Binary;
+namespace TelltaleToolKit.Encryption;
 
 /// <summary>
 ///     Provides static helpers to encrypt and decrypt legacy Telltale MetaStream files

src/TelltaleToolKit/Utility/Blowfish/T3BlowfishKey.cs → src/TelltaleToolKit/Encryption/T3BlowfishKey.cs

@@ -1,6 +1,6 @@
 using System.ComponentModel.DataAnnotations;
 
-namespace TelltaleToolKit.Utility.Blowfish;
+namespace TelltaleToolKit.Encryption;
 
 /// <summary>
 /// Enum representing the various Telltale games which use different blowfish keys.

src/TelltaleToolKit/Utility/Blowfish/T3BlowfishKeyExtensions.cs → src/TelltaleToolKit/Encryption/T3BlowfishKeyExtensions.cs

@@ -1,11 +1,11 @@
 using System.ComponentModel.DataAnnotations;
 using System.Reflection;
 
-namespace TelltaleToolKit.Utility.Blowfish;
+namespace TelltaleToolKit.Encryption;
 
 public static class T3BlowfishKeyExtensions
 {
-    // TODO: In C#13 there is a feature that makes adding extensions easier.
+    // TODO: In C#14 there is a feature that makes adding extensions easier.
 
     /// <summary>
     /// Gets the display name of <see cref="T3BlowfishKey"></see>.
@@ -198,4 +198,4 @@ public static string GetBlowfishKey(this T3BlowfishKey game)
             _ => throw new NotImplementedException("Game is not supported or the key is invalid.")
         };
     }
-}
+}

src/TelltaleToolKit/GamesDatabase/GameProfile.cs → src/TelltaleToolKit/Games/GameProfile.cs

@@ -1,10 +1,9 @@
-using TelltaleToolKit.Reflection;
-using TelltaleToolKit.Serialization;
-using TelltaleToolKit.TelltaleArchives;
-using TelltaleToolKit.Utility.Blowfish;
-using TelltaleToolKit.Utility.Lua;
+using TelltaleToolKit.Encryption;
+using TelltaleToolKit.IO.Archives;
+using TelltaleToolKit.Lua;
+using TelltaleToolKit.Meta.Reflection;
 
-namespace TelltaleToolKit.GamesDatabase;
+namespace TelltaleToolKit.Games;
 
 /// <summary>
 ///     Represents a registry entry for a Telltale game configuration.

src/TelltaleToolKit/GamesDatabase/GameProfileJsonConverter.cs → src/TelltaleToolKit/Games/GameProfileJsonConverter.cs

@@ -1,10 +1,10 @@
 using System.Text.Json;
 using System.Text.Json.Serialization;
-using TelltaleToolKit.TelltaleArchives;
-using TelltaleToolKit.Utility.Blowfish;
-using TelltaleToolKit.Utility.Lua;
+using TelltaleToolKit.Encryption;
+using TelltaleToolKit.IO.Archives;
+using TelltaleToolKit.Lua;
 
-namespace TelltaleToolKit.GamesDatabase;
+namespace TelltaleToolKit.Games;
 
 /// <summary>
 ///     Custom JSON converter for <see cref="GameProfile" /> objects.

src/TelltaleToolKit/GamesDatabase/GameProfileJsonExtensions.cs → src/TelltaleToolKit/Games/GameProfileJsonExtensions.cs

@@ -1,7 +1,7 @@
 using System.Text.Json;
-using TelltaleToolKit.Reflection;
+using TelltaleToolKit.Meta.Reflection;
 
-namespace TelltaleToolKit.GamesDatabase;
+namespace TelltaleToolKit.Games;
 
 public class GameProfileJsonExtensions
 {

src/TelltaleToolKit/Utility/Hashing/Crc64.cs → src/TelltaleToolKit/Hashing/Crc64.cs

@@ -1,6 +1,6 @@
 using System.Diagnostics;
 
-namespace TelltaleToolKit.Utility.Hashing;
+namespace TelltaleToolKit.Hashing;
 
 public static class Crc64
 {

src/TelltaleToolKit/HashDatabase/HashDatabase.cs → src/TelltaleToolKit/Hashing/HashDatabase.cs

@@ -1,15 +1,14 @@
 using System.Collections.Concurrent;
 using System.Text;
 using TelltaleToolKit.T3Types;
-using TelltaleToolKit.Utility.Hashing;
 
-namespace TelltaleToolKit.HashDatabase;
+namespace TelltaleToolKit.Hashing;
 
 /// <summary>
 /// An in-memory, thread-safe hash database for storing and resolving <see cref="Symbol"/> entries.
 /// Supports loading from text files and automatic caching.
 /// </summary>
-public class HashDatabase : ISymbolResolver
+public class HashDatabase
 {
     private readonly ConcurrentDictionary<ulong, string> _symbols = new();
 
@@ -326,20 +325,13 @@ public void ExportToFile(string filePath, IEnumerable<KeyValuePair<ulong, string
     /// <summary>
     /// Merges another hash database into this one.
     /// </summary>
-    public void Merge(ISymbolResolver other)
+    public void Merge(HashDatabase other)
     {
         if (other == null) throw new ArgumentNullException(nameof(other));
 
-        if (other is HashDatabase memoryDb)
+        foreach (KeyValuePair<ulong, string> kvp in other._symbols)
         {
-            foreach (KeyValuePair<ulong, string> kvp in memoryDb._symbols)
-            {
-                AddSymbol(kvp.Key, kvp.Value);
-            }
-        }
-        else
-        {
-            throw new NotImplementedException("Merging with non-HashDatabase not yet implemented");
+            AddSymbol(kvp.Key, kvp.Value);
         }
     }
 }

src/TelltaleToolKit/TelltaleArchives/Archive.cs → src/TelltaleToolKit/IO/Archives/Archive.cs

@@ -1,10 +1,10 @@
 using System.IO.Enumeration;
+using TelltaleToolKit.Encryption;
+using TelltaleToolKit.Hashing;
+using TelltaleToolKit.IO.Archives.Formats;
 using TelltaleToolKit.T3Types;
-using TelltaleToolKit.TelltaleArchives.Formats;
-using TelltaleToolKit.Utility.Blowfish;
-using TelltaleToolKit.Utility.Hashing;
 
-namespace TelltaleToolKit.TelltaleArchives;
+namespace TelltaleToolKit.IO.Archives;
 
 /// <summary>
 ///     Base class for all Telltale archive formats (<c>.ttarch</c>, <c>.ttarch2</c>, PK2).

src/TelltaleToolKit/TelltaleArchives/ArchiveFlags.cs → src/TelltaleToolKit/IO/Archives/ArchiveFlags.cs

@@ -1,4 +1,4 @@
-namespace TelltaleToolKit.TelltaleArchives;
+namespace TelltaleToolKit.IO.Archives;
 
 /// <summary>
 ///     Flags that describe the encryption and compression state of a Telltale archive.

src/TelltaleToolKit/TelltaleArchives/ArchiveInfo.cs → src/TelltaleToolKit/IO/Archives/ArchiveInfo.cs

@@ -1,4 +1,4 @@
-namespace TelltaleToolKit.TelltaleArchives;
+namespace TelltaleToolKit.IO.Archives;
 
 /// <summary>
 ///     Contains metadata about a Telltale archive, including its container type,

src/TelltaleToolKit/TelltaleArchives/ArchiveWriteOptions.cs → src/TelltaleToolKit/IO/Archives/ArchiveWriteOptions.cs

@@ -1,7 +1,6 @@
-using TelltaleToolKit.Serialization;
-using TelltaleToolKit.Utility.Compression;
+using TelltaleToolKit.IO.Streams;
 
-namespace TelltaleToolKit.TelltaleArchives;
+namespace TelltaleToolKit.IO.Archives;
 
 /// <summary>
 ///     Controls how an archive is written or repacked.
@@ -27,9 +26,9 @@ public sealed class ArchiveWriteOptions
 
     /// <summary>
     ///     Gets or sets the compression algorithm to use.
-    ///     Defaults to <see cref="Compression.Deflate" />.
+    ///     Defaults to <see cref="Compression.Mode.Deflate" />.
     /// </summary>
-    public Compression Algorithm { get; set; } = Compression.Deflate;
+    public Compression.Mode Compression { get; set; } = IO.Compression.Mode.Deflate;
 
     /// <summary>
     ///     Gets or sets the decompressed size of each chunk in bytes.

src/TelltaleToolKit/TelltaleArchives/Formats/PK2.cs → src/TelltaleToolKit/IO/Archives/Formats/PK2.cs

@@ -1,4 +1,4 @@
-namespace TelltaleToolKit.TelltaleArchives.Formats;
+namespace TelltaleToolKit.IO.Archives.Formats;
 
 // TODO: PK2 for CSI.
 public class Pk2TTArchive : Archive