Epub阅读器0.0.1

2026-05-21 19:40:51 +08:00
commit daa36d8fe7
559 changed files with 106266 additions and 0 deletions
@@ -0,0 +1,101 @@
+//
+//  WRPageUnderline.h
+//  WeRead (微信读书)
+//  Reverse-engineered header
+//
+//  Annotation model for text underlines. 10 methods identified from binary.
+//  Supports multiple underline styles (solid, dashed, wavy, etc.)
+//  and is associated with a text range in a chapter.
+//
+
+#import <Foundation/Foundation.h>
+#import <UIKit/UIKit.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+@class WRBookmark;
+
+// ---------------------------------------------------------------------------
+// Underline styles
+// ---------------------------------------------------------------------------
+typedef NS_ENUM(NSInteger, WRUnderlineStyle) {
+    WRUnderlineStyleSolid  = 0,  // ____
+    WRUnderlineStyleDashed = 1,  // ----
+    WRUnderlineStyleWavy   = 2,  // ~~~~
+    WRUnderlineStyleDotted = 3,  // ....
+};
+
+// ---------------------------------------------------------------------------
+// WRPageUnderline
+// ---------------------------------------------------------------------------
+@interface WRPageUnderline : NSObject
+
+@property (nonatomic, copy)   NSString *underlineId;
+@property (nonatomic, copy)   NSString *bookId;
+@property (nonatomic, copy)   NSString *chapterUid;
+@property (nonatomic, assign) NSInteger startPos;
+@property (nonatomic, assign) NSInteger endPos;
+@property (nonatomic, assign) NSInteger chapterOffset;
+@property (nonatomic, copy)   NSString *markedText;
+@property (nonatomic, assign) WRUnderlineStyle style;
+@property (nonatomic, strong, nullable) UIColor *color;
+@property (nonatomic, assign) NSInteger pageIndex;
+@property (nonatomic, assign) NSTimeInterval createTime;
+@property (nonatomic, assign) BOOL isSynced;
+@property (nonatomic, copy, nullable) NSString *noteContent; // attached note
+
+#pragma mark - Initialization
+
+/// Initialize with text range and style.
+- (instancetype)initWithBookId:(NSString *)bookId
+                    chapterUid:(NSString *)chapterUid
+                      startPos:(NSInteger)startPos
+                        endPos:(NSInteger)endPos
+                          text:(NSString *)text
+                         style:(WRUnderlineStyle)style;
+
+#pragma mark - Conversion
+
+/// Convert to a WRBookmark for persistence/sync.
+- (WRBookmark *)toBookmark;
+
+/// Create from an existing bookmark.
+ (nullable instancetype)fromBookmark:(WRBookmark *)bookmark;
+
+#pragma mark - Drawing
+
+/// Return the underline path for rendering in a given rect.
+- (UIBezierPath *)underlinePathForRect:(CGRect)rect;
+
+/// Return the underline color.
+- (UIColor *)underlineColor;
+
+#pragma mark - Methods (10 identified from binary, reconstructed)
+
+/// Update the underline style.
+- (void)setStyle:(WRUnderlineStyle)style;
+
+/// Update the note content attached to this underline.
+- (void)setNote:(NSString *)note;
+
+/// Check if a given position falls within this underline's range.
+- (BOOL)containsPosition:(NSInteger)position;
+
+/// Merge with another underline (adjacent ranges).
+- (BOOL)mergeWithUnderline:(WRPageUnderline *)other;
+
+/// Return the text range length.
+- (NSInteger)rangeLength;
+
+/// Return a serialized dictionary.
+- (NSDictionary *)toDictionary;
+
+/// Create from a serialized dictionary.
+ (nullable instancetype)fromDictionary:(NSDictionary *)dict;
+
+/// Compare two underlines for ordering (by start position).
+- (NSComparisonResult)compareTo:(WRPageUnderline *)other;
+
+@end
+
+NS_ASSUME_NONNULL_END