First attempt for proper koreader xpath generation / resolution

2026-02-25 22:34:11 +01:00
parent 1ad1c2a0af
commit 7e8bd70f3c
4 changed files with 578 additions and 36 deletions
@@ -0,0 +1,43 @@
+#pragma once
+
+#include <Epub.h>
+
+#include <memory>
+#include <string>
+
+/**
+ * Builds element-level XPath anchors for a spine item and picks the best match
+ * for an intra-spine progress value.
+ */
+class ChapterXPathIndexer {
+ public:
+  /**
+   * @param epub Loaded EPUB instance
+   * @param spineIndex Current spine item index
+   * @param intraSpineProgress Position within the spine item [0.0, 1.0]
+   * @return Best matching XPath, or empty string on failure
+   */
+  static std::string findXPathForProgress(const std::shared_ptr<Epub>& epub, int spineIndex, float intraSpineProgress);
+
+  /**
+   * Resolve a KOReader XPath to an intra-spine progress value.
+   *
+   * @param epub Loaded EPUB instance
+   * @param spineIndex Spine item index to parse
+   * @param xpath Incoming KOReader XPath
+   * @param outIntraSpineProgress Resolved position within spine [0.0, 1.0]
+   * @param outExactMatch True when an exact anchor match was found
+   * @return true if an exact or ancestor match was resolved
+   */
+  static bool findProgressForXPath(const std::shared_ptr<Epub>& epub, int spineIndex, const std::string& xpath,
+                                   float& outIntraSpineProgress, bool& outExactMatch);
+
+  /**
+   * Parse the DocFragment index from a KOReader-style XPath.
+   *
+   * @param xpath KOReader XPath
+   * @param outSpineIndex Parsed DocFragment index (0-based)
+   * @return true when DocFragment[...] is present and valid
+   */
+  static bool tryExtractSpineIndexFromXPath(const std::string& xpath, int& outSpineIndex);
+};