Implement theme management and settings dialog in PLib video library manager. Add theme service for light/dark/system themes, integrate settings dialog for user preferences, and update app configuration to include appearance options. Enhance thumbnail caching with new methods for cache size and clearing. Update README.md to reflect new features and settings.

2026-08-08 12:04:53 +03:00
parent 625eae7ead
commit 37c5feb2a6
24 changed files with 1099 additions and 185 deletions
@@ -1,31 +1,37 @@
-namespace PLib.Application.Abstractions;
-
-/// <summary>Produces (and caches on disk) a poster frame for a video file.</summary>
-public interface IThumbnailGenerator
-{
-    /// <summary>
-    /// Returns the absolute path of the poster frame for <paramref name="videoPath"/>,
-    /// generating it if it is not cached yet. Returns <c>null</c> when no frame could be
-    /// extracted; a missing thumbnail is a normal outcome, not an error.
-    /// </summary>
-    Task<string?> GetOrCreateAsync(
-        string videoPath,
-        TimeSpan? duration,
-        CancellationToken cancellationToken = default);
-
-    /// <summary>
-    /// True when a previously generated poster frame is still present in the cache. The
-    /// cache directory is ordinary user-writable storage, so a path the library remembers
-    /// is not proof that the file behind it still exists.
-    /// </summary>
-    bool IsAvailable(string? thumbnailPath);
-
-    /// <summary>
-    /// Deletes cached frames that no library item points at any more, and returns how many
-    /// files were removed. Call only after a complete scan: anything not in
-    /// <paramref name="inUsePaths"/> is treated as garbage.
-    /// </summary>
-    Task<int> PurgeUnusedAsync(
-        IReadOnlyCollection<string> inUsePaths,
-        CancellationToken cancellationToken = default);
-}
+namespace PLib.Application.Abstractions;
+
+/// <summary>Produces (and caches on disk) a poster frame for a video file.</summary>
+public interface IThumbnailGenerator
+{
+    /// <summary>
+    /// Returns the absolute path of the poster frame for <paramref name="videoPath"/>,
+    /// generating it if it is not cached yet. Returns <c>null</c> when no frame could be
+    /// extracted; a missing thumbnail is a normal outcome, not an error.
+    /// </summary>
+    Task<string?> GetOrCreateAsync(
+        string videoPath,
+        TimeSpan? duration,
+        CancellationToken cancellationToken = default);
+
+    /// <summary>
+    /// True when a previously generated poster frame is still present in the cache. The
+    /// cache directory is ordinary user-writable storage, so a path the library remembers
+    /// is not proof that the file behind it still exists.
+    /// </summary>
+    bool IsAvailable(string? thumbnailPath);
+
+    /// <summary>
+    /// Deletes cached frames that no library item points at any more, and returns how many
+    /// files were removed. Call only after a complete scan: anything not in
+    /// <paramref name="inUsePaths"/> is treated as garbage.
+    /// </summary>
+    Task<int> PurgeUnusedAsync(
+        IReadOnlyCollection<string> inUsePaths,
+        CancellationToken cancellationToken = default);
+
+    /// <summary>How much disk the cache currently occupies, in bytes.</summary>
+    Task<long> GetCacheSizeInBytesAsync(CancellationToken cancellationToken = default);
+
+    /// <summary>Empties the cache completely. Returns how many files were removed.</summary>
+    Task<int> ClearAsync(CancellationToken cancellationToken = default);
+}