@mathers101/react-native-render-rich-text 0.1.10 → 0.1.14

package/ios/views/ENRMTiptapTextView.h

@@ -1,25 +1,25 @@
-#pragma once
-#import "ENRMUIKit.h"
-
-#import "ENRMLinkContextMenus.h"
-
-#if !TARGET_OS_OSX
-NS_ASSUME_NONNULL_BEGIN
-
-/**
- * The read-only text view tiptap renders into. A link pill is one placeholder character
- * in text storage; what the system reads for the selection (Look Up, Translate, Share,
- * drag, the Copy key command) is answered here with the link text the pill stands for.
- *
- * It also presents the menu of a pill that has one, taken from a delegate that is an
- * `ENRMLinkContextMenuSource`: UIKit lifts a pressed text item on a tinted box of its own,
- * which hides the pill's look.
- */
-@interface ENRMTiptapTextView : UITextView <ENRMLinkMenuPresenting>
-/// Copies a selection the way the menu Copy does. Set by the hosting view, which knows the
-/// source Tiptap and style; without it the Copy key command writes plain text and RTF only.
-@property (nonatomic, copy, nullable) void (^copySelectionHandler)(NSRange selectedRange);
-@end
-
-NS_ASSUME_NONNULL_END
-#endif
+#pragma once
+#import "ENRMUIKit.h"
+
+#import "ENRMLinkContextMenus.h"
+
+#if !TARGET_OS_OSX
+NS_ASSUME_NONNULL_BEGIN
+
+/**
+ * The read-only text view tiptap renders into. A link pill is one placeholder character
+ * in text storage; what the system reads for the selection (Look Up, Translate, Share,
+ * drag, the Copy key command) is answered here with the link text the pill stands for.
+ *
+ * It also presents the menu of a pill that has one, taken from a delegate that is an
+ * `ENRMLinkContextMenuSource`: UIKit lifts a pressed text item on a tinted box of its own,
+ * which hides the pill's look.
+ */
+@interface ENRMTiptapTextView : UITextView <ENRMLinkMenuPresenting>
+/// Copies a selection the way the menu Copy does. Set by the hosting view, which knows the
+/// source Tiptap and style; without it the Copy key command writes plain text and RTF only.
+@property (nonatomic, copy, nullable) void (^copySelectionHandler)(NSRange selectedRange);
+@end
+
+NS_ASSUME_NONNULL_END
+#endif

package/ios/views/ENRMTiptapTextView.m

@@ -1,247 +1,247 @@
-#import "ENRMTiptapTextView.h"
-#import "ENRMLinkPillAttachment.h"
-#import "ENRMLinkPillText.h"
-#import "ENRMTextHitTest.h"
-#import "LinkTapUtils.h"
-#import "PasteboardUtils.h"
-
-#if !TARGET_OS_OSX
-@interface ENRMTiptapTextView () <UIContextMenuInteractionDelegate>
-@end
-
-@implementation ENRMTiptapTextView {
-  ENRMLinkMenuLift *_pillLift;
-  // The pill whose menu is being presented. It draws nothing for as long as its lifted image
-  // stands in for it: it would show through that image.
-  ENRMLinkPillAttachment *_liftedPill;
-  NSUInteger _pillMenuIndex;
-}
-
-- (instancetype)initWithFrame:(CGRect)frame textContainer:(NSTextContainer *)textContainer
-{
-  if (self = [super initWithFrame:frame textContainer:textContainer]) {
-    _pillLift = [[ENRMLinkMenuLift alloc] init];
-    __weak ENRMTiptapTextView *weakSelf = self;
-    _pillLift.onEnd = ^{ [weakSelf restoreLiftedPill]; };
-    [self addInteraction:[[UIContextMenuInteraction alloc] initWithDelegate:self]];
-  }
-  return self;
-}
-
-/// A tap places the caret, and UITextView then scrolls that caret into view. This view is
-/// already sized to its text and sits in the screen's scroll view, so that scroll shifts
-/// the page and the tapped line jumps toward the top. Scrolling stays off, and these
-/// requests are dropped. Copy and selection are unchanged.
-- (void)setContentOffset:(CGPoint)contentOffset
-{
-  if (!self.scrollEnabled && !CGPointEqualToPoint(contentOffset, CGPointZero)) {
-    if (!CGPointEqualToPoint(self.contentOffset, CGPointZero)) {
-      [super setContentOffset:CGPointZero];
-    }
-    return;
-  }
-  [super setContentOffset:contentOffset];
-}
-
-- (void)setContentOffset:(CGPoint)contentOffset animated:(BOOL)animated
-{
-  if (!self.scrollEnabled) {
-    [self setContentOffset:CGPointZero];
-    return;
-  }
-  [super setContentOffset:contentOffset animated:animated];
-}
-
-- (void)scrollRangeToVisible:(NSRange)range
-{
-  if (self.scrollEnabled)
-    [super scrollRangeToVisible:range];
-}
-
-- (void)scrollRectToVisible:(CGRect)rect animated:(BOOL)animated
-{
-  if (self.scrollEnabled)
-    [super scrollRectToVisible:rect animated:animated];
-}
-
-/// New text moves or replaces the pill under its lifted image.
-- (void)setAttributedText:(NSAttributedString *)attributedText
-{
-  [_pillLift end];
-  [super setAttributedText:attributedText];
-}
-
-/// The selection with pills expanded, or nil when `range` is not the selection or holds no pill.
-/// Only the selection is rewritten: UIKit also reads arbitrary ranges to find word boundaries,
-/// and those must keep matching storage offsets.
-- (nullable NSAttributedString *)expandedSelectionForRange:(UITextRange *)range
-{
-  UITextRange *selection = self.selectedTextRange;
-  if (!range || !selection || selection.isEmpty || ![range isEqual:selection])
-    return nil;
-  NSRange selected = self.selectedRange;
-  NSTextStorage *storage = self.textStorage;
-  if (selected.location == NSNotFound || NSMaxRange(selected) > storage.length)
-    return nil;
-  NSAttributedString *text = [storage attributedSubstringFromRange:selected];
-  NSAttributedString *expanded = ENRMAttributedStringByExpandingLinkPills(text, NULL);
-  return expanded == text ? nil : expanded;
-}
-
-- (NSString *)textInRange:(UITextRange *)range
-{
-  return [self expandedSelectionForRange:range].string ?: [super textInRange:range];
-}
-
-- (NSAttributedString *)attributedTextInRange:(UITextRange *)range
-{
-  return [self expandedSelectionForRange:range] ?: [super attributedTextInRange:range];
-}
-
-/// The menu's Copy is already replaced by the library's own action; this covers the key command.
-- (void)copy:(id)sender
-{
-  NSRange selected = self.selectedRange;
-  if (self.copySelectionHandler && selected.location != NSNotFound && selected.length > 0) {
-    self.copySelectionHandler(selected);
-    return;
-  }
-  NSAttributedString *expanded = [self expandedSelectionForRange:self.selectedTextRange];
-  if (!expanded) {
-    [super copy:sender];
-    return;
-  }
-  copyAttributedStringToPasteboard(expanded, nil, nil);
-}
-
-#pragma mark - Pill menus
-
-- (nullable ENRMLinkContextMenus *)linkContextMenus
-{
-  id delegate = self.delegate;
-  return [delegate conformsToProtocol:@protocol(ENRMLinkContextMenuSource)]
-             ? [(id<ENRMLinkContextMenuSource>)delegate linkContextMenusForTextView:self]
-             : nil;
-}
-
-/// Where the pill at `index` is drawn, in the text view's coordinates.
-- (CGRect)pillFrameAtIndex:(NSUInteger)index
-{
-  NSLayoutManager *layoutManager = self.layoutManager;
-  NSUInteger glyph = [layoutManager glyphIndexForCharacterAtIndex:index];
-  CGSize size = [layoutManager attachmentSizeForGlyphAtIndex:glyph];
-  if (size.width <= 0 || size.height <= 0)
-    return CGRectNull;
-  CGRect line = [layoutManager lineFragmentRectForGlyphAtIndex:glyph effectiveRange:NULL];
-  // TextKit places an attachment glyph at the bottom edge of its bounds.
-  CGPoint location = [layoutManager locationForGlyphAtIndex:glyph];
-  UIEdgeInsets inset = self.textContainerInset;
-  return CGRectMake(inset.left + line.origin.x + location.x, inset.top + line.origin.y + location.y - size.height,
-                    size.width, size.height);
-}
-
-/// Whether the character at `index` is a pill whose link has a menu.
-- (BOOL)presentsLinkMenuAtIndex:(NSUInteger)index
-{
-  ENRMLinkContextMenus *menus = [self linkContextMenus];
-  NSTextStorage *storage = self.textStorage;
-  if (menus.entries.count == 0 || index >= storage.length)
-    return NO;
-  id attachment = [storage attribute:NSAttachmentAttributeName atIndex:index effectiveRange:NULL];
-  return [attachment isKindOfClass:ENRMLinkPillAttachment.class] &&
-         [menus hasMenuForURL:linkURLAtRange(self, NSMakeRange(index, 1))];
-}
-
-/// The character index of the pill under `point` when its link has a menu, else NSNotFound.
-- (NSUInteger)menuPillIndexAtPoint:(CGPoint)point
-{
-  if ([self linkContextMenus].entries.count == 0)
-    return NSNotFound;
-  NSUInteger index = ENRMCharacterIndexAtPoint(self, point);
-  if (index == NSNotFound || ![self presentsLinkMenuAtIndex:index] ||
-      !CGRectContainsPoint([self pillFrameAtIndex:index], point))
-    return NSNotFound;
-  return index;
-}
-
-- (void)setPill:(ENRMLinkPillAttachment *)pill lifted:(BOOL)lifted
-{
-  pill.lifted = lifted;
-  NSTextStorage *storage = self.textStorage;
-  [storage enumerateAttribute:NSAttachmentAttributeName
-                      inRange:NSMakeRange(0, storage.length)
-                      options:0
-                   usingBlock:^(id value, NSRange range, BOOL *stop) {
-                     if (value != pill)
-                       return;
-                     [self.layoutManager invalidateDisplayForCharacterRange:range];
-                     *stop = YES;
-                   }];
-}
-
-- (void)restoreLiftedPill
-{
-  if (_liftedPill)
-    [self setPill:_liftedPill lifted:NO];
-  _liftedPill = nil;
-}
-
-- (UIContextMenuConfiguration *)contextMenuInteraction:(UIContextMenuInteraction *)interaction
-                        configurationForMenuAtLocation:(CGPoint)location
-{
-  [_pillLift end];
-  _pillMenuIndex = [self menuPillIndexAtPoint:location];
-  if (_pillMenuIndex == NSNotFound)
-    return nil;
-  UIMenu *menu = [[self linkContextMenus] menuForURL:linkURLAtRange(self, NSMakeRange(_pillMenuIndex, 1))
-                                               title:linkTitleAtIndex(self.textStorage, _pillMenuIndex)];
-  if (!menu)
-    return nil;
-  return [UIContextMenuConfiguration
-      configurationWithIdentifier:nil
-                  previewProvider:nil
-                   actionProvider:^UIMenu *(NSArray<UIMenuElement *> *suggestedActions) { return menu; }];
-}
-
-/// The pill is lifted as an image of itself, see `ENRMLinkMenuLift`.
-- (UITargetedPreview *)pillMenuPreview
-{
-  if (![_pillLift isOverView:self]) {
-    NSTextStorage *storage = self.textStorage;
-    if (self.window == nil || _pillMenuIndex >= storage.length)
-      return nil;
-    id attachment = [storage attribute:NSAttachmentAttributeName atIndex:_pillMenuIndex effectiveRange:NULL];
-    CGRect frame = [self pillFrameAtIndex:_pillMenuIndex];
-    if (![attachment isKindOfClass:ENRMLinkPillAttachment.class] || CGRectIsNull(frame))
-      return nil;
-    UIImage *image = [(ENRMLinkPillAttachment *)attachment imageForBounds:(CGRect){CGPointZero, frame.size}
-                                                            textContainer:self.textContainer
-                                                           characterIndex:_pillMenuIndex];
-    [_pillLift layImage:image atFrame:frame overView:self];
-    _liftedPill = attachment;
-    [self setPill:_liftedPill lifted:YES];
-  }
-  return [_pillLift previewWithCornerRadius:_liftedPill.cornerRadius backgroundColor:UIColor.clearColor];
-}
-
-- (UITargetedPreview *)contextMenuInteraction:(UIContextMenuInteraction *)interaction
-    previewForHighlightingMenuWithConfiguration:(UIContextMenuConfiguration *)configuration
-{
-  return [self pillMenuPreview];
-}
-
-- (UITargetedPreview *)contextMenuInteraction:(UIContextMenuInteraction *)interaction
-    previewForDismissingMenuWithConfiguration:(UIContextMenuConfiguration *)configuration
-{
-  return [self pillMenuPreview];
-}
-
-- (void)contextMenuInteraction:(UIContextMenuInteraction *)interaction
-       willEndForConfiguration:(UIContextMenuConfiguration *)configuration
-                      animator:(id<UIContextMenuInteractionAnimating>)animator
-{
-  [_pillLift endWithAnimator:animator];
-}
-
-@end
-#endif
+#import "ENRMTiptapTextView.h"
+#import "ENRMLinkPillAttachment.h"
+#import "ENRMLinkPillText.h"
+#import "ENRMTextHitTest.h"
+#import "LinkTapUtils.h"
+#import "PasteboardUtils.h"
+
+#if !TARGET_OS_OSX
+@interface ENRMTiptapTextView () <UIContextMenuInteractionDelegate>
+@end
+
+@implementation ENRMTiptapTextView {
+  ENRMLinkMenuLift *_pillLift;
+  // The pill whose menu is being presented. It draws nothing for as long as its lifted image
+  // stands in for it: it would show through that image.
+  ENRMLinkPillAttachment *_liftedPill;
+  NSUInteger _pillMenuIndex;
+}
+
+- (instancetype)initWithFrame:(CGRect)frame textContainer:(NSTextContainer *)textContainer
+{
+  if (self = [super initWithFrame:frame textContainer:textContainer]) {
+    _pillLift = [[ENRMLinkMenuLift alloc] init];
+    __weak ENRMTiptapTextView *weakSelf = self;
+    _pillLift.onEnd = ^{ [weakSelf restoreLiftedPill]; };
+    [self addInteraction:[[UIContextMenuInteraction alloc] initWithDelegate:self]];
+  }
+  return self;
+}
+
+/// A tap places the caret, and UITextView then scrolls that caret into view. This view is
+/// already sized to its text and sits in the screen's scroll view, so that scroll shifts
+/// the page and the tapped line jumps toward the top. Scrolling stays off, and these
+/// requests are dropped. Copy and selection are unchanged.
+- (void)setContentOffset:(CGPoint)contentOffset
+{
+  if (!self.scrollEnabled && !CGPointEqualToPoint(contentOffset, CGPointZero)) {
+    if (!CGPointEqualToPoint(self.contentOffset, CGPointZero)) {
+      [super setContentOffset:CGPointZero];
+    }
+    return;
+  }
+  [super setContentOffset:contentOffset];
+}
+
+- (void)setContentOffset:(CGPoint)contentOffset animated:(BOOL)animated
+{
+  if (!self.scrollEnabled) {
+    [self setContentOffset:CGPointZero];
+    return;
+  }
+  [super setContentOffset:contentOffset animated:animated];
+}
+
+- (void)scrollRangeToVisible:(NSRange)range
+{
+  if (self.scrollEnabled)
+    [super scrollRangeToVisible:range];
+}
+
+- (void)scrollRectToVisible:(CGRect)rect animated:(BOOL)animated
+{
+  if (self.scrollEnabled)
+    [super scrollRectToVisible:rect animated:animated];
+}
+
+/// New text moves or replaces the pill under its lifted image.
+- (void)setAttributedText:(NSAttributedString *)attributedText
+{
+  [_pillLift end];
+  [super setAttributedText:attributedText];
+}
+
+/// The selection with pills expanded, or nil when `range` is not the selection or holds no pill.
+/// Only the selection is rewritten: UIKit also reads arbitrary ranges to find word boundaries,
+/// and those must keep matching storage offsets.
+- (nullable NSAttributedString *)expandedSelectionForRange:(UITextRange *)range
+{
+  UITextRange *selection = self.selectedTextRange;
+  if (!range || !selection || selection.isEmpty || ![range isEqual:selection])
+    return nil;
+  NSRange selected = self.selectedRange;
+  NSTextStorage *storage = self.textStorage;
+  if (selected.location == NSNotFound || NSMaxRange(selected) > storage.length)
+    return nil;
+  NSAttributedString *text = [storage attributedSubstringFromRange:selected];
+  NSAttributedString *expanded = ENRMAttributedStringByExpandingLinkPills(text, NULL);
+  return expanded == text ? nil : expanded;
+}
+
+- (NSString *)textInRange:(UITextRange *)range
+{
+  return [self expandedSelectionForRange:range].string ?: [super textInRange:range];
+}
+
+- (NSAttributedString *)attributedTextInRange:(UITextRange *)range
+{
+  return [self expandedSelectionForRange:range] ?: [super attributedTextInRange:range];
+}
+
+/// The menu's Copy is already replaced by the library's own action; this covers the key command.
+- (void)copy:(id)sender
+{
+  NSRange selected = self.selectedRange;
+  if (self.copySelectionHandler && selected.location != NSNotFound && selected.length > 0) {
+    self.copySelectionHandler(selected);
+    return;
+  }
+  NSAttributedString *expanded = [self expandedSelectionForRange:self.selectedTextRange];
+  if (!expanded) {
+    [super copy:sender];
+    return;
+  }
+  copyAttributedStringToPasteboard(expanded, nil, nil);
+}
+
+#pragma mark - Pill menus
+
+- (nullable ENRMLinkContextMenus *)linkContextMenus
+{
+  id delegate = self.delegate;
+  return [delegate conformsToProtocol:@protocol(ENRMLinkContextMenuSource)]
+             ? [(id<ENRMLinkContextMenuSource>)delegate linkContextMenusForTextView:self]
+             : nil;
+}
+
+/// Where the pill at `index` is drawn, in the text view's coordinates.
+- (CGRect)pillFrameAtIndex:(NSUInteger)index
+{
+  NSLayoutManager *layoutManager = self.layoutManager;
+  NSUInteger glyph = [layoutManager glyphIndexForCharacterAtIndex:index];
+  CGSize size = [layoutManager attachmentSizeForGlyphAtIndex:glyph];
+  if (size.width <= 0 || size.height <= 0)
+    return CGRectNull;
+  CGRect line = [layoutManager lineFragmentRectForGlyphAtIndex:glyph effectiveRange:NULL];
+  // TextKit places an attachment glyph at the bottom edge of its bounds.
+  CGPoint location = [layoutManager locationForGlyphAtIndex:glyph];
+  UIEdgeInsets inset = self.textContainerInset;
+  return CGRectMake(inset.left + line.origin.x + location.x, inset.top + line.origin.y + location.y - size.height,
+                    size.width, size.height);
+}
+
+/// Whether the character at `index` is a pill whose link has a menu.
+- (BOOL)presentsLinkMenuAtIndex:(NSUInteger)index
+{
+  ENRMLinkContextMenus *menus = [self linkContextMenus];
+  NSTextStorage *storage = self.textStorage;
+  if (menus.entries.count == 0 || index >= storage.length)
+    return NO;
+  id attachment = [storage attribute:NSAttachmentAttributeName atIndex:index effectiveRange:NULL];
+  return [attachment isKindOfClass:ENRMLinkPillAttachment.class] &&
+         [menus hasMenuForURL:linkURLAtRange(self, NSMakeRange(index, 1))];
+}
+
+/// The character index of the pill under `point` when its link has a menu, else NSNotFound.
+- (NSUInteger)menuPillIndexAtPoint:(CGPoint)point
+{
+  if ([self linkContextMenus].entries.count == 0)
+    return NSNotFound;
+  NSUInteger index = ENRMCharacterIndexAtPoint(self, point);
+  if (index == NSNotFound || ![self presentsLinkMenuAtIndex:index] ||
+      !CGRectContainsPoint([self pillFrameAtIndex:index], point))
+    return NSNotFound;
+  return index;
+}
+
+- (void)setPill:(ENRMLinkPillAttachment *)pill lifted:(BOOL)lifted
+{
+  pill.lifted = lifted;
+  NSTextStorage *storage = self.textStorage;
+  [storage enumerateAttribute:NSAttachmentAttributeName
+                      inRange:NSMakeRange(0, storage.length)
+                      options:0
+                   usingBlock:^(id value, NSRange range, BOOL *stop) {
+                     if (value != pill)
+                       return;
+                     [self.layoutManager invalidateDisplayForCharacterRange:range];
+                     *stop = YES;
+                   }];
+}
+
+- (void)restoreLiftedPill
+{
+  if (_liftedPill)
+    [self setPill:_liftedPill lifted:NO];
+  _liftedPill = nil;
+}
+
+- (UIContextMenuConfiguration *)contextMenuInteraction:(UIContextMenuInteraction *)interaction
+                        configurationForMenuAtLocation:(CGPoint)location
+{
+  [_pillLift end];
+  _pillMenuIndex = [self menuPillIndexAtPoint:location];
+  if (_pillMenuIndex == NSNotFound)
+    return nil;
+  UIMenu *menu = [[self linkContextMenus] menuForURL:linkURLAtRange(self, NSMakeRange(_pillMenuIndex, 1))
+                                               title:linkTitleAtIndex(self.textStorage, _pillMenuIndex)];
+  if (!menu)
+    return nil;
+  return [UIContextMenuConfiguration
+      configurationWithIdentifier:nil
+                  previewProvider:nil
+                   actionProvider:^UIMenu *(NSArray<UIMenuElement *> *suggestedActions) { return menu; }];
+}
+
+/// The pill is lifted as an image of itself, see `ENRMLinkMenuLift`.
+- (UITargetedPreview *)pillMenuPreview
+{
+  if (![_pillLift isOverView:self]) {
+    NSTextStorage *storage = self.textStorage;
+    if (self.window == nil || _pillMenuIndex >= storage.length)
+      return nil;
+    id attachment = [storage attribute:NSAttachmentAttributeName atIndex:_pillMenuIndex effectiveRange:NULL];
+    CGRect frame = [self pillFrameAtIndex:_pillMenuIndex];
+    if (![attachment isKindOfClass:ENRMLinkPillAttachment.class] || CGRectIsNull(frame))
+      return nil;
+    UIImage *image = [(ENRMLinkPillAttachment *)attachment imageForBounds:(CGRect){CGPointZero, frame.size}
+                                                            textContainer:self.textContainer
+                                                           characterIndex:_pillMenuIndex];
+    [_pillLift layImage:image atFrame:frame overView:self];
+    _liftedPill = attachment;
+    [self setPill:_liftedPill lifted:YES];
+  }
+  return [_pillLift previewWithCornerRadius:_liftedPill.cornerRadius backgroundColor:UIColor.clearColor];
+}
+
+- (UITargetedPreview *)contextMenuInteraction:(UIContextMenuInteraction *)interaction
+    previewForHighlightingMenuWithConfiguration:(UIContextMenuConfiguration *)configuration
+{
+  return [self pillMenuPreview];
+}
+
+- (UITargetedPreview *)contextMenuInteraction:(UIContextMenuInteraction *)interaction
+    previewForDismissingMenuWithConfiguration:(UIContextMenuConfiguration *)configuration
+{
+  return [self pillMenuPreview];
+}
+
+- (void)contextMenuInteraction:(UIContextMenuInteraction *)interaction
+       willEndForConfiguration:(UIContextMenuConfiguration *)configuration
+                      animator:(id<UIContextMenuInteractionAnimating>)animator
+{
+  [_pillLift endWithAnimator:animator];
+}
+
+@end
+#endif