feat: complete large-book pagination runtime and UI coverage

2026-06-03 17:47:16 +08:00
parent 584976ac5f
commit feb05eaf87
53 changed files with 6307 additions and 5126 deletions
@@ -13,18 +13,12 @@ import Foundation
 extension RDEPUBReaderController {
    /// 解析当前阅读位置对应的目录项，按页码或 href 匹配
    func resolvedCurrentTableOfContentsItem() -> RDEPUBReaderTableOfContentsItem? {
-        let items = flattenedTableOfContents
+        let items = flattenedTableOfContentsItems(
+            from: publication?.tableOfContents ?? [],
+            includePageNumbers: false
+        )
        guard !items.isEmpty else { return nil }

-        let currentPageNumber = max(readerView.currentPage + 1, 1)
-        let pageAnchoredMatch = items.last { item in
-            guard let pageNumber = item.pageNumber else { return false }
-            return pageNumber <= currentPageNumber
-        }
-        if let pageAnchoredMatch {
-            return pageAnchoredMatch
-        }
-
        guard let publication,
              let currentLocation = currentVisibleLocation(),
              let normalizedCurrentHref = publication.resourceResolver.normalizedHref(currentLocation.href) else {
@@ -60,28 +54,12 @@ extension RDEPUBReaderController {
    /// 将嵌套目录树递归扁平化为线性列表，并计算每项目标页码
    func flattenedTableOfContentsItems(
        from items: [EPUBTableOfContentsItem],
-        depth: Int = 0
+        depth: Int = 0,
+        includePageNumbers: Bool = true
    ) -> [RDEPUBReaderTableOfContentsItem] {
        items.flatMap { item in
            let location = RDEPUBLocation(bookIdentifier: currentBookIdentifier, href: item.href, progression: 0)
-            let pageNumber: Int?
-            if let textBook, let publication,
-               let chapterData = textBook.chapterData(for: location, resolver: publication.resourceResolver, bookIdentifier: currentBookIdentifier) {
-                let normalizedLocation = publication.resourceResolver.normalizedLocation(
-                    location,
-                    bookIdentifier: currentBookIdentifier
-                ) ?? location
-                pageNumber = chapterData.pageNumber(for: normalizedLocation)
-                    ?? textBook.pageNumber(
-                        for: location,
-                        resolver: publication.resourceResolver,
-                        bookIdentifier: currentBookIdentifier
-                    )
-            } else if let readingSession {
-                pageNumber = readingSession.pageIndex(for: location, bookIdentifier: currentBookIdentifier).map { $0 + 1 }
-            } else {
-                pageNumber = nil
-            }
+            let pageNumber = includePageNumbers ? resolvedTableOfContentsPageNumber(for: location) : nil

            let current = RDEPUBReaderTableOfContentsItem(
                title: item.title,
@@ -89,8 +67,53 @@ extension RDEPUBReaderController {
                depth: depth,
                pageNumber: pageNumber
            )
-            return [current] + flattenedTableOfContentsItems(from: item.children, depth: depth + 1)
+            return [current] + flattenedTableOfContentsItems(
+                from: item.children,
+                depth: depth + 1,
+                includePageNumbers: includePageNumbers
+            )
        }
    }
-}

+    private func resolvedTableOfContentsPageNumber(for location: RDEPUBLocation) -> Int? {
+        if let publication,
+           let bookPageMap = readerContext.bookPageMap,
+           let spineIndex = readerContext.normalizedSpineIndex(for: location),
+           let entry = bookPageMap.entry(forSpineIndex: spineIndex) {
+            let normalizedLocation = publication.resourceResolver.normalizedLocation(
+                location,
+                bookIdentifier: currentBookIdentifier
+            ) ?? location
+            let localPageIndex: Int
+            if let summary = readerContext.chapterSummary(forSpineIndex: spineIndex) {
+                let offset = chapterOffset(for: normalizedLocation, fallbackEntry: entry)
+                localPageIndex = summary.pageRanges.firstIndex {
+                    let range = $0.nsRange
+                    return offset >= range.location && offset <= max(range.location + range.length - 1, range.location)
+                } ?? fallbackLocalPageIndex(for: normalizedLocation, pageCount: entry.pageCount)
+            } else {
+                localPageIndex = fallbackLocalPageIndex(for: normalizedLocation, pageCount: entry.pageCount)
+            }
+            return bookPageMap.absolutePageIndex(
+                spineIndex: spineIndex,
+                localPageIndex: min(max(localPageIndex, 0), max(entry.pageCount - 1, 0))
+            ).map { $0 + 1 }
+        }
+
+        if let textBook, let publication,
+           let chapterData = textBook.chapterData(for: location, resolver: publication.resourceResolver, bookIdentifier: currentBookIdentifier) {
+            let normalizedLocation = publication.resourceResolver.normalizedLocation(
+                location,
+                bookIdentifier: currentBookIdentifier
+            ) ?? location
+            return chapterData.pageNumber(for: normalizedLocation)
+                ?? textBook.pageNumber(
+                    for: location,
+                    resolver: publication.resourceResolver,
+                    bookIdentifier: currentBookIdentifier
+                )
+        }
+
+        return readingSession?.pageIndex(for: location, bookIdentifier: currentBookIdentifier).map { $0 + 1 }
+    }
+}