Initial commit

app/src/main/java/com/aryan/reader/epub/EpubXMLFileParser.kt

@@ -0,0 +1,55 @@
+package com.aryan.reader.epub
+
+import timber.log.Timber
+import org.jsoup.Jsoup
+
+/**
+ * Parses an XML/HTML file from an EPUB archive, primarily to extract a title
+ * and determine the effective path for WebView (including fragments).
+ *
+ * @property fileRelativePath The relative path of the HTML file within the EPUB's extraction directory.
+ * @property data The raw data (content) of the HTML file.
+ * @property fragmentId Optional ID of the fragment to link to within the HTML file.
+ */
+class EpubXMLFileParser(
+    val fileRelativePath: String, // e.g., "OEBPS/chapter1.xhtml"
+    val data: ByteArray,
+    private val fragmentId: String? = null
+) {
+
+    companion object {
+        private const val TAG = "EpubXMLFileParser"
+    }
+
+    /**
+     * Represents the output of the parsing.
+     *
+     * @property title The extracted title of the HTML document (e.g., from h1-h6 tags).
+     * @property effectiveHtmlPath The relative path to the HTML file, including any fragment identifier.
+     *                             This path is relative to the book's extraction base.
+     */
+    data class Output(val title: String?, val effectiveHtmlPath: String)
+
+    /**
+     * Parses the HTML data to extract a title and construct the effective HTML path.
+     *
+     * @return [Output] The title and effective HTML path.
+     */
+    fun parseForTitleAndPath(): Output {
+        Timber.d("Parsing for title and path: $fileRelativePath, fragment: $fragmentId")
+        val document = Jsoup.parse(data.inputStream(), "UTF-8", "")
+        val extractedTitle = document.selectFirst("h1, h2, h3, h4, h5, h6")?.text()?.trim()
+
+        val pathWithFragment = if (fragmentId != null) {
+            "$fileRelativePath#$fragmentId"
+        } else {
+            fileRelativePath
+        }
+        Timber.d("Effective HTML path: $pathWithFragment for file: $fileRelativePath")
+
+        return Output(
+            title = extractedTitle,
+            effectiveHtmlPath = pathWithFragment
+        )
+    }
+}