Code Quality: Added comments for the IThumbnail contracts

Author: workbysaran

src/Files.App/Data/Contracts/IThumbnailCache.cs

@@ -1,20 +1,37 @@
 // Copyright (c) Files Community
 // Licensed under the MIT License.
 
-using Files.App.Data.Enums;
-
 namespace Files.App.Data.Contracts
 {
+	/// <summary>
+	/// Stores and retrieves cached thumbnails.
+	/// </summary>
 	public interface IThumbnailCache
 	{
+		/// <summary>
+		/// Retrieves a cached thumbnail.
+		/// </summary>
+		/// <returns>Thumbnail bytes, or null if not cached.</returns>
 		Task<byte[]?> GetAsync(string path, int size, IconOptions options, CancellationToken ct);
 
+		/// <summary>
+		/// Stores a thumbnail in the cache.
+		/// </summary>
 		Task SetAsync(string path, int size, IconOptions options, byte[] thumbnail, CancellationToken ct);
 
+		/// <summary>
+		/// Gets the current cache size in bytes.
+		/// </summary>
 		Task<long> GetSizeAsync();
 
+		/// <summary>
+		/// Reduces cache size to the specified target in bytes.
+		/// </summary>
 		Task EvictToSizeAsync(long targetSizeBytes);
 
+		/// <summary>
+		/// Removes all cached thumbnails.
+		/// </summary>
 		Task ClearAsync();
 	}
 }

src/Files.App/Data/Contracts/IThumbnailGenerator.cs

@@ -3,10 +3,20 @@
 
 namespace Files.App.Data.Contracts
 {
+	/// <summary>
+	/// Generates thumbnails for specific file types.
+	/// </summary>
 	public interface IThumbnailGenerator
 	{
+		/// <summary>
+		/// Gets the file extensions this generator supports.
+		/// </summary>
 		IEnumerable<string> SupportedTypes { get; }
 
+		/// <summary>
+		/// Generates a thumbnail for the specified path.
+		/// </summary>
+		/// <returns>Thumbnail bytes, or null if generation fails.</returns>
 		Task<byte[]?> GenerateAsync(
 			string path,
 			int size,

src/Files.App/Data/Contracts/IThumbnailService.cs

@@ -3,21 +3,40 @@
 
 namespace Files.App.Data.Contracts
 {
+	/// <summary>
+	/// Provides thumbnail retrieval and cache management.
+	/// </summary>
 	public interface IThumbnailService
 	{
+		/// <summary>
+		/// Gets a thumbnail for the specified path.
+		/// </summary>
+		/// <returns>Thumbnail bytes, or null if unavailable.</returns>
 		Task<byte[]?> GetThumbnailAsync(
 			string path,
 			int size,
 			bool isFolder,
 			IconOptions options = IconOptions.None,
 			CancellationToken ct = default);
 
+		/// <summary>
+		/// Registers a thumbnail generator.
+		/// </summary>
 		void RegisterGenerator(IThumbnailGenerator generator);
 
+		/// <summary>
+		/// Clears all cached thumbnails.
+		/// </summary>
 		Task ClearCacheAsync();
 
+		/// <summary>
+		/// Gets the current cache size in bytes.
+		/// </summary>
 		Task<long> GetCacheSizeAsync();
 
+		/// <summary>
+		/// Reduces cache size to the specified target in bytes.
+		/// </summary>
 		Task EvictCacheAsync(long targetSizeBytes);
 	}
 }