refactor!: rebuild the "refresh" system into expanded "sync" system

[CyanVoxel]

Important

Blocked by #1499 in order to finalize migration and resolve failing migration tests.

Note

This PR is targeting the dev branch for release with Alpha v9.7.

Summary

This is a complete rebuild of the "refresh" system into an expanded "sync" system that removes longstanding design constraints like modal progress bars that block the app, addresses important edge cases such as Unicode normalization and filesystem case-insensitivity, and finally adds automatic relinking with the help of cached file stats (won't relink 100% of files, but is still more than the previous system while being automatic).

Much of the performance and code consolidation was inspired by #1242 along with the NFD research stemming directly from that PR, with additional notes taken from #1495. Completes this system's task for #1460.

Half of this PR centers around the new sync system (and a bunch of tests) and how it stores up-to-date file metadata to aid in searches and the relinking process, and the other half is a whoooole lot of UI code for a new notification and banner that displays progress of sync operations without blocking the app. I poured a lot of polish into since I'm aiming for a v10 level of completion with this system, and two years of temporary progress bar modals was just too much.

Directory scanning, file metadata updates, and automatic relinking operations all now run in the background, letting you use TagStudio while these operations complete. Because syncing no longer has the blocking impact it did previously, I've also added a dismissable banner message that displays on app startup encouraging users to turn on the "sync library on startup" setting. Since it's still valid to not want your filesystem hit or library modified when opening a library, I've kept the setting around.

What I haven't done in this PR is completely remove the old "Fix Unlined Entries" modal/system, only integrating it with the new sync system. That whole thing needs its own rework with the addition of manually relinking files, but those additions out of the scope of this PR (yes, this PR actually has a scope...)

---

Full Breakdown

Unicode Normalization Form D (NFD) + Windows Case-Insensitivity Enforcement

• NFD is now enforced on the library side and for all filepath comparisons (mainly from the library cache) to fix current issues and prevent future issues with comparing non-normalized paths.
• Filesystem case-insensitivity is now also lightly respected, with Windows users expecting to be on a case-insensitive system, and therefore filepath comparisons to filepaths with different cases will be allowed on Windows. This is a barebones implementation, but is a start to this level of filesystem awareness.
• Because Unicode normalization was not previously enforced, there may be libraries with duplicate entries for the same path on disk. These are cases are handled or raised by the sync step, where it may be required to manually search and relink. Entries affected by this will be merged together, just as normal duplicate entries are.

Non-Blocking UI Banner

• Syncing now runs as a background task with progress shown in a new animated banner widget at the top of the entry grid, replacing the old blocking modal progress dialogs.
• Progress-bound operations can now be cancelled, and automatically cancel when switching or closing a library.

Reworked Refresh (Now Called Sync) System

• Replaced the old RefreshTracker and UnlinkedRegistry with a single LibrarySyncEngine.
  • One pass now handles new file discovery, unlinked detection, automatic relinking, and stat refresh together instead of separate disconnected steps.
  • A single cache of filepaths mapped to entry IDs is now stored in the library for other systems to use (again)
  • Menu action renamed from "Refresh Directories" to "Sync Library" and still keeps the Ctrl+R shortcut (Ctrl+S to sync doesn't feel right, and Ctrl+R still feels appropreiate).
  • Renamed "Automatically Load New Files" setting to "Sync Library on Open".
  • Added a dismissable banner message that displays on app startup encouraging users to turn on the setting.
• Entries now store date created, date modified, and file size in the database, and existing entry paths are normalized to Unicode Normalization Form D (NFD). These values are kept up to date automatically during the sync process.

Automatic Relinking

• Added an automatic relinking phase that matches unlinked entries to new files using filename plus date modified and file size, falling back to date modified and file size alone for renamed files.
• Added a handy table in the library documentation that goes over every possible file change scenario and describes if these can be handled by the auto-relink system or not. These case numbers are also referenced in code comments and test docstrings so every edge case remains tracked and highly visible. The auto-relink system can currently handle:
  • Moved + Renamed + 1:1 Match (Case 3)
  • Moved + Modified + 1:1 Match (Case 6)
  • Moved + 1:1 Match (Case 7)
  • Renamed + 1:1 Match (Case 11)

Sort by File Size, Date Created, Date Modified

• Search results can now be sorted by date created, date modified, and file size.

---

Supersedes #1242, #1330, and #1495
Fixes #1252
Fixes #1279
Fixes #1450
Closes #610
Closes #1212
Closes #1218

Tasks Completed

• Platforms Tested:
  • Windows x86
  • Windows ARM
  • macOS x86
  • macOS ARM
  • Linux x86
  • Linux ARM
• Tested For:
  • Basic functionality
  • PyInstaller executable