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、状态机、内存警告、预加载、位置恢复等
86 lines
1.9 KiB
Swift
86 lines
1.9 KiB
Swift
import Foundation
|
|
|
|
public enum RDEPUBNoteKind: String, Codable, Equatable {
|
|
|
|
case footnote
|
|
|
|
case endnote
|
|
|
|
case rearnote
|
|
|
|
case unknown
|
|
}
|
|
|
|
public struct RDEPUBNoteReference: Codable, Equatable {
|
|
|
|
public var sourceHref: String
|
|
|
|
public var sourceCFI: String?
|
|
|
|
public var targetHref: String
|
|
|
|
public var targetFragment: String?
|
|
|
|
public var targetCFI: String?
|
|
|
|
public var label: String?
|
|
|
|
public var kind: RDEPUBNoteKind
|
|
|
|
public init(
|
|
sourceHref: String,
|
|
sourceCFI: String? = nil,
|
|
targetHref: String,
|
|
targetFragment: String? = nil,
|
|
targetCFI: String? = nil,
|
|
label: String? = nil,
|
|
kind: RDEPUBNoteKind = .unknown
|
|
) {
|
|
self.sourceHref = sourceHref
|
|
self.sourceCFI = sourceCFI
|
|
self.targetHref = targetHref
|
|
self.targetFragment = targetFragment
|
|
self.targetCFI = targetCFI
|
|
self.label = label?.rdNoteNilIfEmpty
|
|
self.kind = kind
|
|
}
|
|
}
|
|
|
|
public struct RDEPUBResolvedNote: Equatable {
|
|
|
|
public var reference: RDEPUBNoteReference
|
|
|
|
public var sourceLocation: RDEPUBLocation?
|
|
|
|
public var targetLocation: RDEPUBLocation
|
|
|
|
public var title: String?
|
|
|
|
public var html: String
|
|
|
|
public var plainText: String
|
|
|
|
public init(
|
|
reference: RDEPUBNoteReference,
|
|
sourceLocation: RDEPUBLocation? = nil,
|
|
targetLocation: RDEPUBLocation,
|
|
title: String? = nil,
|
|
html: String,
|
|
plainText: String
|
|
) {
|
|
self.reference = reference
|
|
self.sourceLocation = sourceLocation
|
|
self.targetLocation = targetLocation
|
|
self.title = title?.rdNoteNilIfEmpty
|
|
self.html = html
|
|
self.plainText = plainText
|
|
}
|
|
}
|
|
|
|
private extension String {
|
|
var rdNoteNilIfEmpty: String? {
|
|
let trimmed = trimmingCharacters(in: .whitespacesAndNewlines)
|
|
return trimmed.isEmpty ? nil : trimmed
|
|
}
|
|
}
|