Windows (#291)

* Centralize library management logic and introduce support for plain text and HTML formats

* Centralize library management logic and introduce support for plain text and HTML formats

* Expand unit test coverage for library state management, UI models, and MainViewModel features.

* Add comprehensive unit tests for PDF reader core logic, preferences, and data persistence

* Add unit tests for EPUB parsing, content loading, search functionality, and reader JavaScript bridges.

* Add unit tests for OPDS parsing and Smart Collection engine, and integrate Kover plugin

* Add comprehensive unit tests

* Centralize library snapshot serialization in the `shared` module and improve filtering and sorting logic.

* Implement text selection, highlighting, and reading state persistence for PDF and EPUB engines in desktop version

* Folder import support for desktop app

* Introduce Smart Shelves with rule-based filtering in desktop version

* Implement shared EPUB annotation serialization and highlight rendering

* Centralize file type capabilities and platform-specific support logic

* Refactor reader state management to use a central reducer

* Implement customizable reader toolbar and advanced formatting settings in shared

* Implement locator-based navigation and customizable highlight palette for desktop app

* Enhance reader customization and expand search functionality in desktop app

* Redesign reader settings and tools into a tabbed control panel in desktop app

* Enhance reader navigation and highlight precision in desktop app

* Implement bidirectional position synchronization and dynamic highlights in the desktop reader

* Implement shared state management and enhanced search for the PDF reader in desktop app

* Add vertical scroll support to the desktop PDF reader

* Implement ink, text, and eraser annotation support in desktop PDF viewer

* Implement PDF bookmarks, Table of Contents, and annotation editing in desktop app

* Implement link handling and navigation for PDF and EPUB readers in desktop app

* Implement PDF jump history for navigation in desktop app

* Enhance PDF ink rendering and annotation capabilities in desktop app

* Implement advanced PDF text annotations with inline editing and rich styling in desktop app

* Add move handle and movement logic for PDF text annotations in desktop app

* Implement local folder synchronization and metadata sidecar support in desktop app

* Implement book metadata extraction and drag-and-drop import for Desktop

* Implement dynamic and custom app theme management for desktop

* Introduce canonical PDF annotation codec and support for multi-segment highlights

* Implement rich text editing and pagination support for the PDF reader in desktop app

* Improve PDF rich text pagination, synchronization, and observability in desktop

* Hide trailing structural page breaks in rich text editor

* Implement a unified JVM book loader and expand supported formats on Desktop

* Add comic archive support for Desktop and enhance MOBI parsing

* Implement shared OPDS catalog support and UI for Android and Desktop

* Improve native WebView lifecycle and surface transition management on Desktop

* Enable Compose Swing interop blending and simplify Desktop WebView management

* Integrate BYOK AI features and Cloud TTS for desktop

* Enhance Desktop TTS with streaming audio and improved secure storage for AI key

* Implement scoped Cloud TTS with synchronized highlighting for EPUB and PDF in desktop app

* Implement custom font management and utility screens in desktop app

* Implement PDFium-based PDF annotation export

* Remove PdfBox dependency and standardize PDF export via Pdfium

* Implement local audio caching and playback controls for Gemini Cloud TTS in desktop app

* Implement reader themes and custom texture support in desktop app

* Redesign non-reader UI with responsive navigation and enhanced library management in desktop app

* Introduce ReaderWorkspaceShell to unify EPUB and PDF reader layouts in desktop app

* Exclude manual-only files from automated sync and import

* Implement customizable Text-to-Speech (TTS) word replacements

* Optimize reader performance with persistent layout caching and decoupled theme rendering

* Improve position restoration during reader reconfiguration in epub pagination

* Use independent thickness for eraser tool and stylus override

app/src/test/java/com/aryan/reader/data/RecentFileItemReadingPositionMappingTest.kt

@@ -0,0 +1,54 @@
+package com.aryan.reader.data
+
+import com.aryan.reader.FileType
+import org.junit.Assert.assertEquals
+import org.junit.Test
+
+class RecentFileItemReadingPositionMappingTest {
+
+    @Test
+    fun `recent file entity mapping preserves epub cfi locator and progress fields`() {
+        val item = recentFileItem()
+
+        val roundTripped = item.toRecentFileEntity().toRecentFileItem()
+
+        assertEquals(item.lastPositionCfi, roundTripped.lastPositionCfi)
+        assertEquals(item.lastChapterIndex, roundTripped.lastChapterIndex)
+        assertEquals(item.locatorBlockIndex, roundTripped.locatorBlockIndex)
+        assertEquals(item.locatorCharOffset, roundTripped.locatorCharOffset)
+        assertEquals(item.progressPercentage, roundTripped.progressPercentage)
+    }
+
+    @Test
+    fun `cloud metadata mapping preserves epub cfi locator and progress fields`() {
+        val item = recentFileItem()
+
+        val roundTripped = item.toBookMetadata().toRecentFileItem()
+
+        assertEquals(item.lastPositionCfi, roundTripped.lastPositionCfi)
+        assertEquals(item.lastChapterIndex, roundTripped.lastChapterIndex)
+        assertEquals(item.locatorBlockIndex, roundTripped.locatorBlockIndex)
+        assertEquals(item.locatorCharOffset, roundTripped.locatorCharOffset)
+        assertEquals(item.progressPercentage, roundTripped.progressPercentage)
+    }
+
+    private fun recentFileItem(): RecentFileItem {
+        return RecentFileItem(
+            bookId = "book-1",
+            uriString = "content://books/one",
+            type = FileType.EPUB,
+            displayName = "One.epub",
+            timestamp = 1_000L,
+            title = "One",
+            author = "Author",
+            lastChapterIndex = 4,
+            lastPositionCfi = "/4/2/6:88",
+            locatorBlockIndex = 30,
+            locatorCharOffset = 88,
+            progressPercentage = 61.5f,
+            lastModifiedTimestamp = 2_000L,
+            bookmarksJson = """[{"cfi":"/4/2"}]""",
+            highlightsJson = """[{"cfi":"/4/2/6:88"}]"""
+        )
+    }
+}