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,168 @@
+//
+//  WRPageView.h
+//  WeRead (微信读书)
+//
+//  Reverse-engineered header reconstruction.
+//  The page rendering view. Inherits UIView. Uses CoreText direct drawing
+//  via drawRect: — does NOT use UILabel or UITextView for body text.
+//  Handles text selection via CoreText hit testing.
+//
+
+#import <UIKit/UIKit.h>
+
+@class WRActivityIndicator;
+@class WRLoadingProgressView;
+@class WRFriendReviewsButton;
+@class WRCoreTextLayoutFrame;
+@class WRChapterData;
+
+NS_ASSUME_NONNULL_BEGIN
+
+// ============================================================================
+#pragma mark - WRPageViewDelegate
+// ============================================================================
+
+@protocol WRPageViewDelegate <NSObject>
+@optional
+
+/// Called when the user taps a link or internal reference.
+- (void)pageView:(WRPageView *)pageView didTapLinkWithURL:(NSURL *)url;
+
+/// Called when the user long-presses to initiate text selection.
+- (void)pageView:(WRPageView *)pageView didBeginSelectionAtPoint:(CGPoint)point;
+
+/// Called when text selection changes.
+- (void)pageView:(WRPageView *)pageView selectionDidChangeWithRange:(NSRange)range;
+
+/// Called when the user taps the friend reviews button.
+- (void)pageView:(WRPageView *)pageView didTapFriendReviewsWithCount:(NSUInteger)count;
+
+/// Called when the page needs to reload its content.
+- (void)pageViewNeedsReload:(WRPageView *)pageView;
+
+@end
+
+// ============================================================================
+#pragma mark - WRPageView
+// ============================================================================
+
+@interface WRPageView : UIView
+
+// ---- Delegate ----
+@property (nonatomic, weak, nullable) id<WRPageViewDelegate> delegate;
+
+// ---- Content ----
+/// The chapter data driving this page's content.
+@property (nonatomic, strong, nullable) WRChapterData *chapterData;
+
+/// The page index within the chapter (0-based).
+@property (nonatomic, assign) NSUInteger pageIndex;
+
+/// The layout frame used for CoreText rendering.
+@property (nonatomic, strong, nullable) WRCoreTextLayoutFrame *layoutFrame;
+
+// ---- Ivars reconstructed from binary (NSArray, NSMutableArray, etc.) ----
+/// Array of attachment image descriptors (rects, image refs) for inline images.
+@property (nonatomic, strong, nullable) NSArray *imageAttachments;
+
+/// Mutable array tracking visible highlight/underline ranges.
+@property (nonatomic, strong, nullable) NSMutableArray *visibleHighlights;
+
+/// Timer for auto-read advance.
+@property (nonatomic, strong, nullable) NSTimer *autoReadTimer;
+
+/// Timer for loading timeout.
+@property (nonatomic, strong, nullable) NSTimer *loadingTimeoutTimer;
+
+/// Current chapter identifier string.
+@property (nonatomic, copy, nullable) NSString *chapterId;
+
+// ---- UI Elements (non-text, overlaid on the CoreText layer) ----
+/// Header label showing chapter title or page number.
+@property (nonatomic, strong, nullable) UILabel *headerLabel;
+
+/// Background/decorative image view.
+@property (nonatomic, strong, nullable) UIImageView *backgroundImageView;
+
+/// Loading activity indicator.
+@property (nonatomic, strong, nullable) WRActivityIndicator *activityIndicator;
+
+/// Error / empty-state message label.
+@property (nonatomic, strong, nullable) UILabel *statusLabel;
+
+/// Retry button shown on error.
+@property (nonatomic, strong, nullable) QMUIButton *retryButton;
+
+/// Share button.
+@property (nonatomic, strong, nullable) QMUIButton *shareButton;
+
+/// Loading progress view (thin bar at top or bottom).
+@property (nonatomic, strong, nullable) WRLoadingProgressView *loadingProgressView;
+
+/// Bookmark toggle button.
+@property (nonatomic, strong, nullable) QMUIButton *bookmarkButton;
+
+/// Font size increase button (toolbar).
+@property (nonatomic, strong, nullable) QMUIButton *fontSizeUpButton;
+
+/// Font size decrease button (toolbar).
+@property (nonatomic, strong, nullable) QMUIButton *fontSizeDownButton;
+
+/// Friend reviews / notes button.
+@property (nonatomic, strong, nullable) WRFriendReviewsButton *friendReviewsButton;
+
+// ---- Selection state ----
+/// Whether the view is currently in text-selection mode.
+@property (nonatomic, assign, readonly) BOOL isSelecting;
+
+/// The currently selected string range (NSNotFound if none).
+@property (nonatomic, assign, readonly) NSRange selectedRange;
+
+// ---- CoreText Drawing ----
+
+/// Main drawing entry point. Draws text and inline images directly into the
+/// CGContext using CoreText. Called by UIKit from -drawRect:.
+- (void)drawInContext:(CGContextRef)context
+            withData:(WRChapterData *)chapterData
+                size:(CGSize)size
+              inRect:(CGRect)rect
+            position:(CGPoint)position;
+
+// ---- Accessibility ----
+
+/// Overridden to provide a plain-text representation of the page content.
+- (nullable NSString *)accessibilityValue;
+
+/// Overridden to support VoiceOver page-scroll gestures.
+- (BOOL)accessibilityScroll:(UIAccessibilityScrollDirection)direction;
+
+// ---- Friend Reviews ----
+
+/// Updates the friend reviews button with the current count.
+- (void)friendReviewsCount:(NSUInteger)count;
+
+// ---- Loading / Error States ----
+
+/// Shows the loading indicator and optional progress bar.
+- (void)showLoadingWithProgress:(float)progress;
+
+/// Hides loading indicators.
+- (void)hideLoading;
+
+/// Shows an error state with a message and retry button.
+- (void)showErrorWithMessage:(NSString *)message;
+
+// ---- Text Selection (CoreText hit-testing) ----
+
+/// Converts a point in the view to a string index using CTLineGetStringIndexForPosition.
+- (NSInteger)stringIndexForPoint:(CGPoint)point;
+
+/// Returns the character range for the line containing the given string index.
+- (NSRange)lineRangeForStringIndex:(NSInteger)index;
+
+/// Clears the current selection.
+- (void)clearSelection;
+
+@end
+
+NS_ASSUME_NONNULL_END