7de661eb54
Phase 1: Context 拆分 - 新增 RDEPUBReaderState/RDEPUBReaderEnvironment/RDEPUBReaderServices - RDEPUBReaderContext 改为过渡门面，代理到 State/Environment/Services Phase 2: Runtime 拆分 - 新增 RDEPUBPresentationRuntime 处理分页状态管理 - 新增 RDEPUBChapterWarmupOrchestrator 处理章节预热与加载编排 - RDEPUBReaderRuntime 从 1277 行收缩，公共 API 转发到新 facade Phase 0.5: 性能优化 - prepareOnDemandChapter 支持异步模式（allowSynchronousLoad: false） - extendPartialBookPageMapIfNeeded 改为 DispatchGroup 并发加载 - RDEPUBChapterOffsetMap.cfiMap 加 NSLock 保护数据竞争 - CFI Map 构建延迟到后台队列（scheduleDeferredCFIMapBuildIfNeeded） - RDEPUBTextPageRenderView 引入静态位图缓存 - RDEPUBTextContentView 新增 loadingSpinner 占位页 Phase 3: 状态机 - 新增 RDEPUBNavigationStateMachine（含 DEBUG 合法转换校验） - 新增 RDEPUBPaginationState 记录分页来源 Review 修复 - makeSummary 重复方法合并 - ensureNavigationTargetAvailable 同步路径加注释标记 UI 测试 - 新增 AsyncChapterLoadingTests（20 个测试，覆盖全部架构整改场景） - 跨章节翻页、延迟 CFI、状态机、内存警告、预加载、位置恢复等
131 lines
3.1 KiB
Swift
131 lines
3.1 KiB
Swift
import Foundation
|
|
|
|
public struct RDEPUBLocation: Codable, Equatable {
|
|
|
|
public var bookIdentifier: String?
|
|
|
|
public var href: String
|
|
|
|
public var progression: Double
|
|
|
|
public var lastProgression: Double?
|
|
|
|
public var fragment: String?
|
|
|
|
public var rangeAnchor: RDEPUBTextRangeAnchor?
|
|
|
|
public var cfi: String?
|
|
|
|
public var lastCFI: String?
|
|
|
|
public var rangeCFI: String?
|
|
|
|
public init(
|
|
bookIdentifier: String? = nil,
|
|
href: String,
|
|
progression: Double,
|
|
lastProgression: Double? = nil,
|
|
fragment: String? = nil,
|
|
rangeAnchor: RDEPUBTextRangeAnchor? = nil,
|
|
cfi: String? = nil,
|
|
lastCFI: String? = nil,
|
|
rangeCFI: String? = nil
|
|
) {
|
|
self.bookIdentifier = bookIdentifier
|
|
self.href = href
|
|
self.progression = Self.clamp(progression)
|
|
self.lastProgression = lastProgression.map(Self.clamp)
|
|
self.fragment = fragment?.nilIfEmpty
|
|
self.rangeAnchor = rangeAnchor
|
|
self.cfi = cfi?.nilIfEmpty
|
|
self.lastCFI = lastCFI?.nilIfEmpty
|
|
self.rangeCFI = rangeCFI?.nilIfEmpty
|
|
}
|
|
|
|
public var navigationProgression: Double {
|
|
let end = lastProgression ?? progression
|
|
if end.isNaN || end.isInfinite {
|
|
return progression
|
|
}
|
|
return Self.clamp((progression + end) / 2.0)
|
|
}
|
|
|
|
private static func clamp(_ value: Double) -> Double {
|
|
guard value.isFinite else { return 0 }
|
|
return min(1, max(0, value))
|
|
}
|
|
}
|
|
|
|
public struct RDEPUBViewportResource: Codable, Equatable {
|
|
|
|
public var href: String
|
|
|
|
public var spineIndex: Int
|
|
|
|
public var progression: Double
|
|
|
|
public var lastProgression: Double?
|
|
|
|
public var fragment: String?
|
|
|
|
public init(
|
|
href: String,
|
|
spineIndex: Int,
|
|
progression: Double,
|
|
lastProgression: Double? = nil,
|
|
fragment: String? = nil
|
|
) {
|
|
self.href = href
|
|
self.spineIndex = spineIndex
|
|
self.progression = progression
|
|
self.lastProgression = lastProgression
|
|
self.fragment = fragment
|
|
}
|
|
}
|
|
|
|
public struct RDEPUBViewport: Codable, Equatable {
|
|
|
|
public var resources: [RDEPUBViewportResource]
|
|
|
|
public var visiblePageNumber: Int
|
|
|
|
public var chapterIndex: Int?
|
|
|
|
public var isFixedLayout: Bool
|
|
|
|
public init(
|
|
resources: [RDEPUBViewportResource],
|
|
visiblePageNumber: Int,
|
|
chapterIndex: Int? = nil,
|
|
isFixedLayout: Bool
|
|
) {
|
|
self.resources = resources
|
|
self.visiblePageNumber = visiblePageNumber
|
|
self.chapterIndex = chapterIndex
|
|
self.isFixedLayout = isFixedLayout
|
|
}
|
|
}
|
|
|
|
public struct RDEPUBReadingContext: Codable, Equatable {
|
|
|
|
public var location: RDEPUBLocation
|
|
|
|
public var viewport: RDEPUBViewport
|
|
|
|
public var pageNumber: Int
|
|
|
|
public var chapterIndex: Int?
|
|
|
|
public init(
|
|
location: RDEPUBLocation,
|
|
viewport: RDEPUBViewport,
|
|
pageNumber: Int,
|
|
chapterIndex: Int? = nil
|
|
) {
|
|
self.location = location
|
|
self.viewport = viewport
|
|
self.pageNumber = pageNumber
|
|
self.chapterIndex = chapterIndex
|
|
}
|
|
}
|