chore: checkpoint current milestone work

2026-05-22 13:28:53 +08:00
parent 6d196d64e5
commit 5698aeaead
68 changed files with 5694 additions and 3291 deletions
@@ -167,6 +167,43 @@ public struct RDEPUBTextOffsetRangeInfo: Codable, Equatable {
    }
 }

+public enum RDEPUBTextPageBreakReason: String, Codable, Equatable {
+    case chapterEnd
+    case frameLimit
+    case blockBoundary
+    case attachmentBoundary
+}
+
+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 trailingFragmentID: String?
+    public var diagnostics: [String]
+
+    public init(
+        breakReason: RDEPUBTextPageBreakReason,
+        blockRange: NSRange? = nil,
+        attachmentRanges: [NSRange] = [],
+        attachmentKinds: [RDEPUBTextAttachmentKind] = [],
+        trailingFragmentID: String? = nil,
+        diagnostics: [String] = []
+    ) {
+        self.breakReason = breakReason
+        self.blockRange = blockRange
+        self.attachmentRanges = attachmentRanges
+        self.attachmentKinds = attachmentKinds
+        self.trailingFragmentID = trailingFragmentID
+        self.diagnostics = diagnostics
+    }
+}
+
 public struct RDEPUBHighlight: Codable, Equatable {
    public var id: String
    public var bookIdentifier: String?