feat(epub): complete wxread parity scope

2026-05-26 09:19:37 +08:00
parent 23182e8b5a
commit 0e7d952fe5
31 changed files with 2619 additions and 1533 deletions
@@ -179,6 +179,13 @@ public enum RDEPUBHighlightStyle: String, Codable {
    case underline
 }

+/// 统一标注类型，对标 WXRead 的 WRBookmark 语义分层。
+public enum RDEPUBAnnotationKind: String, Codable, Equatable {
+    case bookmark
+    case highlight
+    case underline
+}
+
 /// 标注菜单操作类型，用于用户长按选中文本后的操作选项
 public enum RDEPUBAnnotationMenuAction: Equatable {
    case copy
@@ -396,6 +403,10 @@ public struct RDEPUBHighlight: Codable, Equatable {
        try container.encodeIfPresent(note, forKey: .note)
        try container.encode(createdAt, forKey: .createdAt)
    }
+
+    public var annotation: RDEPUBAnnotation {
+        RDEPUBAnnotation(highlight: self)
+    }
 }

 /// 书签模型，记录用户标记的阅读位置
@@ -433,6 +444,108 @@ public struct RDEPUBBookmark: Codable, Equatable {
    public var hasNote: Bool {
        note?.trimmingCharacters(in: .whitespacesAndNewlines).isEmpty == false
    }
+
+    public var annotation: RDEPUBAnnotation {
+        RDEPUBAnnotation(bookmark: self)
+    }
+}
+
+/// 统一标注模型，对标 WXRead 的 WRBookmark。
+public struct RDEPUBAnnotation: Codable, Equatable {
+    public var id: String
+    public var bookIdentifier: String?
+    public var kind: RDEPUBAnnotationKind
+    public var location: RDEPUBLocation
+    public var text: String?
+    public var rangeInfo: String?
+    public var color: String?
+    public var chapterTitle: String?
+    public var note: String?
+    public var createdAt: Date
+
+    public init(
+        id: String = UUID().uuidString,
+        bookIdentifier: String? = nil,
+        kind: RDEPUBAnnotationKind,
+        location: RDEPUBLocation,
+        text: String? = nil,
+        rangeInfo: String? = nil,
+        color: String? = nil,
+        chapterTitle: String? = nil,
+        note: String? = nil,
+        createdAt: Date = Date()
+    ) {
+        self.id = id
+        self.bookIdentifier = bookIdentifier
+        self.kind = kind
+        self.location = location
+        self.text = text?.nilIfEmpty
+        self.rangeInfo = rangeInfo?.nilIfEmpty
+        self.color = color?.nilIfEmpty
+        self.chapterTitle = chapterTitle?.nilIfEmpty
+        self.note = note?.nilIfEmpty
+        self.createdAt = createdAt
+    }
+
+    public init(highlight: RDEPUBHighlight) {
+        self.init(
+            id: highlight.id,
+            bookIdentifier: highlight.bookIdentifier,
+            kind: highlight.style == .underline ? .underline : .highlight,
+            location: highlight.location,
+            text: highlight.text,
+            rangeInfo: highlight.rangeInfo,
+            color: highlight.color,
+            chapterTitle: nil,
+            note: highlight.note,
+            createdAt: highlight.createdAt
+        )
+    }
+
+    public init(bookmark: RDEPUBBookmark) {
+        self.init(
+            id: bookmark.id,
+            bookIdentifier: bookmark.bookIdentifier,
+            kind: .bookmark,
+            location: bookmark.location,
+            text: nil,
+            rangeInfo: nil,
+            color: nil,
+            chapterTitle: bookmark.chapterTitle,
+            note: bookmark.note,
+            createdAt: bookmark.createdAt
+        )
+    }
+
+    public var bookmark: RDEPUBBookmark? {
+        guard kind == .bookmark else { return nil }
+        return RDEPUBBookmark(
+            id: id,
+            bookIdentifier: bookIdentifier,
+            location: location,
+            chapterTitle: chapterTitle,
+            note: note,
+            createdAt: createdAt
+        )
+    }
+
+    public var highlight: RDEPUBHighlight? {
+        guard kind == .highlight || kind == .underline,
+              let text else {
+            return nil
+        }
+        return RDEPUBHighlight(
+            id: id,
+            bookIdentifier: bookIdentifier,
+            location: location,
+            text: text,
+            rangeInfo: rangeInfo,
+            style: kind == .underline ? .underline : .highlight,
+            color: color ?? "#F8E16C",
+            note: note,
+            createdAt: createdAt
+        )
+    }
 }

 /// 章节信息模型，描述单个章节的元数据