230 lines
7.7 KiB
Swift
230 lines
7.7 KiB
Swift
import Foundation
|
||
|
||
public enum RDEPUBTextPageBreakReason: String, Codable, Equatable {
|
||
/// 章节自然结束
|
||
case chapterEnd
|
||
/// 达到帧容量限制
|
||
case frameLimit
|
||
/// 块级元素边界（如段落、标题）
|
||
case blockBoundary
|
||
/// 附件（图片等）边界
|
||
case attachmentBoundary
|
||
/// 语义边界（如列表、引用块）
|
||
case semanticBoundary
|
||
}
|
||
|
||
/// 文本附件类型
|
||
public enum RDEPUBTextAttachmentKind: String, Codable, Equatable {
|
||
/// 图片附件
|
||
case image
|
||
/// 通用附件
|
||
case generic
|
||
}
|
||
|
||
/// 文本页元数据，记录分页时的上下文信息
|
||
/// 用于调试分页问题和优化分页质量
|
||
public struct RDEPUBTextPageMetadata: Codable, Equatable {
|
||
/// 分页截断原因
|
||
public var breakReason: RDEPUBTextPageBreakReason
|
||
/// 本页覆盖的块级元素范围
|
||
public var blockRange: NSRange?
|
||
/// 本页包含的附件范围列表
|
||
public var attachmentRanges: [NSRange]
|
||
/// 附件类型列表
|
||
public var attachmentKinds: [RDEPUBTextAttachmentKind]
|
||
/// 块级元素类型列表
|
||
public var blockKinds: [RDEPUBTextBlockKind]
|
||
/// 语义提示信息
|
||
public var semanticHints: [RDEPUBTextSemanticHint]
|
||
/// 附件布局位置信息
|
||
public var attachmentPlacements: [RDEPUBTextAttachmentPlacement]
|
||
/// 本页末尾的 fragment ID（用于恢复位置）
|
||
public var trailingFragmentID: String?
|
||
/// 诊断信息列表（调试用）
|
||
public var diagnostics: [String]
|
||
|
||
public init(
|
||
breakReason: RDEPUBTextPageBreakReason,
|
||
blockRange: NSRange? = nil,
|
||
attachmentRanges: [NSRange] = [],
|
||
attachmentKinds: [RDEPUBTextAttachmentKind] = [],
|
||
blockKinds: [RDEPUBTextBlockKind] = [],
|
||
semanticHints: [RDEPUBTextSemanticHint] = [],
|
||
attachmentPlacements: [RDEPUBTextAttachmentPlacement] = [],
|
||
trailingFragmentID: String? = nil,
|
||
diagnostics: [String] = []
|
||
) {
|
||
self.breakReason = breakReason
|
||
self.blockRange = blockRange
|
||
self.attachmentRanges = attachmentRanges
|
||
self.attachmentKinds = attachmentKinds
|
||
self.blockKinds = blockKinds
|
||
self.semanticHints = semanticHints
|
||
self.attachmentPlacements = attachmentPlacements
|
||
self.trailingFragmentID = trailingFragmentID
|
||
self.diagnostics = diagnostics
|
||
}
|
||
}
|
||
|
||
/// 高亮模型，表示用户在阅读中标记的文本片段
|
||
public struct EPUBChapterInfo: Codable, Equatable {
|
||
/// 对应的 spine 索引
|
||
public var spineIndex: Int
|
||
/// 章节标题
|
||
public var title: String
|
||
/// 该章节的总页数
|
||
public var pageCount: Int
|
||
|
||
public init(spineIndex: Int, title: String, pageCount: Int) {
|
||
self.spineIndex = spineIndex
|
||
self.title = title
|
||
self.pageCount = pageCount
|
||
}
|
||
}
|
||
|
||
/// 页面模型，描述单页的完整信息
|
||
/// 由 RDEPUBReadingSession 根据分页结果构建，是翻页容器层的数据单元
|
||
public struct EPUBPage: Codable, Equatable {
|
||
/// 对应的 spine 索引
|
||
public var spineIndex: Int
|
||
/// 章节索引（从 0 开始的章节序号）
|
||
public var chapterIndex: Int
|
||
/// 页在章节中的索引（从 0 开始）
|
||
public var pageIndexInChapter: Int
|
||
/// 该章节的总页数
|
||
public var totalPagesInChapter: Int
|
||
/// 章节标题
|
||
public var chapterTitle: String
|
||
/// 固定版式 Spread 数据（仅 fixed layout 书籍有值）
|
||
public var fixedSpread: EPUBFixedSpread?
|
||
|
||
public init(
|
||
spineIndex: Int,
|
||
chapterIndex: Int,
|
||
pageIndexInChapter: Int,
|
||
totalPagesInChapter: Int,
|
||
chapterTitle: String,
|
||
fixedSpread: EPUBFixedSpread?
|
||
) {
|
||
self.spineIndex = spineIndex
|
||
self.chapterIndex = chapterIndex
|
||
self.pageIndexInChapter = pageIndexInChapter
|
||
self.totalPagesInChapter = totalPagesInChapter
|
||
self.chapterTitle = chapterTitle
|
||
self.fixedSpread = fixedSpread
|
||
}
|
||
}
|
||
|
||
/// 固定版式 Spread 中的单个资源
|
||
public struct EPUBFixedSpreadResource: Codable, Equatable {
|
||
/// 对应的 spine 索引
|
||
public var spineIndex: Int
|
||
/// 资源路径
|
||
public var href: String
|
||
/// 资源标题
|
||
public var title: String
|
||
/// 在 spread 中的位置偏好
|
||
public var pageSpread: RDEPUBPageSpread?
|
||
|
||
public init(spineIndex: Int, href: String, title: String, pageSpread: RDEPUBPageSpread? = nil) {
|
||
self.spineIndex = spineIndex
|
||
self.href = href
|
||
self.title = title
|
||
self.pageSpread = pageSpread
|
||
}
|
||
}
|
||
|
||
/// 固定版式 Spread（双页展开）模型
|
||
/// 将 1-2 个 spine 资源组合为一个显示单元
|
||
public struct EPUBFixedSpread: Codable, Equatable {
|
||
/// 该 spread 包含的资源列表（通常 1-2 个）
|
||
public var resources: [EPUBFixedSpreadResource]
|
||
|
||
public init(resources: [EPUBFixedSpreadResource]) {
|
||
self.resources = resources
|
||
}
|
||
|
||
/// 主资源（列表中的第一个），用于标识和定位
|
||
public var primaryResource: EPUBFixedSpreadResource {
|
||
resources.first ?? EPUBFixedSpreadResource(spineIndex: 0, href: "", title: "")
|
||
}
|
||
|
||
/// 判断指定 href 的资源是否属于此 spread
|
||
/// - Parameters:
|
||
/// - normalizedHref: 标准化后的 href
|
||
/// - normalizer: href 标准化函数
|
||
/// - Returns: 是否包含该资源
|
||
public func contains(normalizedHref: String, normalizer: (String) -> String?) -> Bool {
|
||
resources.contains { resource in
|
||
normalizer(resource.href) == normalizedHref
|
||
}
|
||
}
|
||
|
||
/// 根据 spine 列表和 spread 设置生成 Spread 数组
|
||
/// 根据 pageSpread 属性（left/right/center）决定资源配对
|
||
/// - Parameters:
|
||
/// - spine: spine 项列表
|
||
/// - spreadEnabled: 是否启用 spread 模式
|
||
/// - Returns: spread 数组
|
||
public static func makeSpreads(spine: [RDEPUBSpineItem], spreadEnabled: Bool) -> [EPUBFixedSpread] {
|
||
let resources = spine.enumerated().map { index, item in
|
||
EPUBFixedSpreadResource(
|
||
spineIndex: index,
|
||
href: item.href,
|
||
title: item.title,
|
||
pageSpread: item.pageSpread
|
||
)
|
||
}
|
||
|
||
guard spreadEnabled, resources.count > 1 else {
|
||
return resources.map { EPUBFixedSpread(resources: [$0]) }
|
||
}
|
||
|
||
var spreads: [EPUBFixedSpread] = []
|
||
var cursor = 0
|
||
|
||
while cursor < resources.count {
|
||
let current = resources[cursor]
|
||
|
||
guard cursor + 1 < resources.count else {
|
||
spreads.append(EPUBFixedSpread(resources: [current]))
|
||
break
|
||
}
|
||
|
||
let next = resources[cursor + 1]
|
||
if shouldPair(current: current, next: next) {
|
||
spreads.append(EPUBFixedSpread(resources: [current, next]))
|
||
cursor += 2
|
||
} else {
|
||
spreads.append(EPUBFixedSpread(resources: [current]))
|
||
cursor += 1
|
||
}
|
||
}
|
||
|
||
return spreads
|
||
}
|
||
|
||
/// 便捷方法：从 parser 构建 spread
|
||
public static func makeSpreads(parser: RDEPUBParser, spreadEnabled: Bool) -> [EPUBFixedSpread] {
|
||
makeSpreads(spine: parser.spine, spreadEnabled: spreadEnabled)
|
||
}
|
||
|
||
/// 判断两个资源是否应该配对为一个 spread
|
||
/// center 类型不参与配对，left+right 或 right+left 配对
|
||
private static func shouldPair(current: EPUBFixedSpreadResource, next: EPUBFixedSpreadResource) -> Bool {
|
||
if current.pageSpread == .center || next.pageSpread == .center {
|
||
return false
|
||
}
|
||
|
||
switch (current.pageSpread, next.pageSpread) {
|
||
case (.left, .right), (.right, .left):
|
||
return true
|
||
case (.left, .left), (.right, .right):
|
||
return false
|
||
default:
|
||
return true
|
||
}
|
||
}
|
||
}
|
||
|