@mathers101/react-native-render-rich-text 0.0.0-stage → 0.1.10

package/ios/renderer/FactoidRenderer.m

@@ -0,0 +1,130 @@
+#import "FactoidRenderer.h"
+#import "FactoidBackground.h"
+#import "TiptapASTNode.h"
+#import "RenderContext.h"
+#import "RendererFactory.h"
+#import "StyleConfig.h"
+
+static RCTUIColor *ENRMColorFromString(NSString *value)
+{
+  if (value.length == 0)
+    return nil;
+
+  NSString *trimmed = [value stringByTrimmingCharactersInSet:[NSCharacterSet whitespaceAndNewlineCharacterSet]];
+  if (trimmed.length == 0)
+    return nil;
+
+  if ([trimmed characterAtIndex:0] == '#') {
+    NSString *hex = [trimmed substringFromIndex:1];
+    if (hex.length != 6 && hex.length != 8)
+      return nil;
+    unsigned int rgba = 0;
+    NSScanner *scanner = [NSScanner scannerWithString:hex];
+    if (![scanner scanHexInt:&rgba] || !scanner.isAtEnd)
+      return nil;
+    CGFloat alpha = 1.0;
+    CGFloat red;
+    CGFloat green;
+    CGFloat blue;
+    if (hex.length == 8) {
+      alpha = ((rgba >> 24) & 0xFF) / 255.0;
+      red = ((rgba >> 16) & 0xFF) / 255.0;
+      green = ((rgba >> 8) & 0xFF) / 255.0;
+      blue = (rgba & 0xFF) / 255.0;
+    } else {
+      red = ((rgba >> 16) & 0xFF) / 255.0;
+      green = ((rgba >> 8) & 0xFF) / 255.0;
+      blue = (rgba & 0xFF) / 255.0;
+    }
+    return [RCTUIColor colorWithRed:red green:green blue:blue alpha:alpha];
+  }
+
+  static NSDictionary<NSString *, RCTUIColor *> *namedColors;
+  static dispatch_once_t onceToken;
+  dispatch_once(&onceToken, ^{
+    namedColors = @{
+      @"black" : [RCTUIColor blackColor],
+      @"darkgray" : [RCTUIColor darkGrayColor],
+      @"darkgrey" : [RCTUIColor darkGrayColor],
+      @"gray" : [RCTUIColor grayColor],
+      @"grey" : [RCTUIColor grayColor],
+      @"lightgray" : [RCTUIColor lightGrayColor],
+      @"lightgrey" : [RCTUIColor lightGrayColor],
+      @"white" : [RCTUIColor whiteColor],
+      @"red" : [RCTUIColor redColor],
+      @"green" : [RCTUIColor greenColor],
+      @"blue" : [RCTUIColor blueColor],
+      @"yellow" : [RCTUIColor yellowColor],
+      @"cyan" : [RCTUIColor cyanColor],
+      @"aqua" : [RCTUIColor cyanColor],
+      @"magenta" : [RCTUIColor magentaColor],
+      @"fuchsia" : [RCTUIColor magentaColor],
+      @"lime" : [RCTUIColor colorWithRed:0 green:1 blue:0 alpha:1],
+      @"maroon" : [RCTUIColor colorWithRed:0.5 green:0 blue:0 alpha:1],
+      @"navy" : [RCTUIColor colorWithRed:0 green:0 blue:0.5 alpha:1],
+      @"olive" : [RCTUIColor colorWithRed:0.5 green:0.5 blue:0 alpha:1],
+      @"purple" : [RCTUIColor colorWithRed:0.5 green:0 blue:0.5 alpha:1],
+      @"silver" : [RCTUIColor colorWithRed:0.75 green:0.75 blue:0.75 alpha:1],
+      @"teal" : [RCTUIColor colorWithRed:0 green:0.5 blue:0.5 alpha:1],
+    };
+  });
+  return namedColors[trimmed.lowercaseString];
+}
+
+static RCTUIColor *ENRMFactoidColor(NSString *value, RCTUIColor *styleColor, unsigned int rgb)
+{
+  RCTUIColor *parsed = ENRMColorFromString(value);
+  if (parsed)
+    return parsed;
+  if (styleColor)
+    return styleColor;
+  return [RCTUIColor colorWithRed:((rgb >> 16) & 0xFF) / 255.0
+                           green:((rgb >> 8) & 0xFF) / 255.0
+                            blue:(rgb & 0xFF) / 255.0
+                           alpha:1.0];
+}
+
+@implementation FactoidRenderer
+
+- (id)takeContextSnapshot:(RenderContext *)context
+{
+  return [context snapshotScope];
+}
+
+- (void)renderNodeContent:(TiptapASTNode *)node
+                     into:(NSMutableAttributedString *)output
+                  context:(RenderContext *)context
+{
+  NSString *factoidId = node.attributes[@"id"] ?: @"";
+  // A node attribute replaces the matching textStyle.factoid color. The RGB values are the
+  // same defaults JS applies when textStyle.factoid omits a color.
+  RCTUIColor *textColor = ENRMFactoidColor(node.attributes[@"color"], _config.factoidColor, 0x205710);
+  RCTUIColor *backgroundColor =
+    ENRMFactoidColor(node.attributes[@"backgroundColor"], _config.factoidBackgroundColor, 0x9BFC6E);
+  RCTUIColor *borderColor =
+    ENRMFactoidColor(node.attributes[@"borderColor"], _config.factoidBorderColor, 0x23670D);
+
+  // Inline children keep the surrounding font. The text color becomes their base color.
+  BlockStyle *block = [context getBlockStyle];
+  UIFont *font = block.cachedFont;
+  if (!font) {
+    font = [context cachedFontForSize:block.fontSize family:block.fontFamily weight:block.fontWeight];
+  }
+  [context setBlockStyle:context.currentBlockType
+                    font:font
+                   color:textColor
+            headingLevel:context.currentHeadingLevel];
+
+  NSUInteger start = output.length;
+  [_rendererFactory renderChildrenOfNode:node into:output context:context];
+  NSRange range = NSMakeRange(start, output.length > start ? output.length - start : 0);
+  if (range.length == 0)
+    return;
+
+  [output addAttribute:FactoidAttributeName value:@YES range:range];
+  [output addAttribute:FactoidIdAttributeName value:factoidId range:range];
+  [output addAttribute:FactoidBackgroundColorAttributeName value:backgroundColor range:range];
+  [output addAttribute:FactoidBorderColorAttributeName value:borderColor range:range];
+}
+
+@end

package/ios/renderer/HeadingRenderer.h

@@ -0,0 +1,6 @@
+#import "BaseRenderer.h"
+#import "TiptapASTNode.h"
+#import "RenderContext.h"
+
+@interface HeadingRenderer : BaseRenderer
+@end

package/ios/renderer/HeadingRenderer.m

@@ -0,0 +1,103 @@
+#import "HeadingRenderer.h"
+#import "ENRMLinkPillText.h"
+#import "FontUtils.h"
+#import "ParagraphStyleUtils.h"
+#import "RenderContext.h"
+#import "RendererFactory.h"
+#import "RuntimeKeys.h"
+#import "StyleConfig.h"
+
+// Lightweight struct to hold style data without object overhead
+typedef struct {
+  __unsafe_unretained UIFont *font;
+  __unsafe_unretained RCTUIColor *color;
+  CGFloat marginTop;
+  CGFloat marginBottom;
+  CGFloat lineHeight;
+  NSTextAlignment textAlign;
+} HeadingStyle;
+
+static NSString *const kHeadingTypes[] = {nil,          @"heading-1", @"heading-2", @"heading-3",
+                                          @"heading-4", @"heading-5", @"heading-6"};
+
+@implementation HeadingRenderer
+
+- (id)takeContextSnapshot:(RenderContext *)context
+{
+  return [context snapshotScope];
+}
+
+- (void)renderNodeContent:(TiptapASTNode *)node
+                     into:(NSMutableAttributedString *)output
+                  context:(RenderContext *)context
+{
+  if (output.length > 0 && ![output.string hasSuffix:@"\n"]) {
+    [output appendAttributedString:kNewlineAttributedString];
+  }
+
+  NSInteger level = [node.attributes[@"level"] integerValue];
+  if (level < 1 || level > 6)
+    level = 1;
+
+  HeadingStyle style = [self styleForLevel:level];
+  [context setBlockStyle:BlockTypeHeading font:style.font color:style.color headingLevel:level];
+
+  NSUInteger start = output.length;
+  NSUInteger contentStart = start;
+
+  // Spacing at the very start of the document requires a spacer character (index 0 check)
+  if (start == 0) {
+    NSUInteger offset = applyBlockSpacingBefore(output, 0, style.marginTop);
+    contentStart += offset;
+    start += offset;
+  }
+
+  [_rendererFactory renderChildrenOfNode:node into:output context:context];
+
+  NSRange range = NSMakeRange(start, output.length - start);
+  if (range.length == 0)
+    return;
+
+  // Register heading for accessibility
+  NSString *headingText = ENRMStringByExpandingLinkPills([output attributedSubstringFromRange:range]);
+  [context registerHeadingRange:range level:level text:headingText];
+
+  // Metadata attribute used for post-processing (e.g., Export to Tiptap/HTML)
+  [output addAttribute:TiptapTypeAttributeName value:kHeadingTypes[level] range:range];
+
+  applyLineHeight(output, range, style.lineHeight);
+  applyBaselineOffset(output, range);
+  applyTextAlignment(output, range, style.textAlign);
+
+  // Skip marginTop for the first block — already handled by applyBlockSpacingBefore above
+  if (contentStart != 1) {
+    NSUInteger inserted = applyParagraphSpacingBefore(output, range, style.marginTop);
+    start += inserted;
+  }
+  applyParagraphSpacingAfter(output, start, style.marginBottom);
+}
+
+#pragma mark - Style Mapping
+
+- (HeadingStyle)styleForLevel:(NSInteger)level
+{
+  StyleConfig *c = _config;
+  switch (level) {
+    case 1:
+      return (HeadingStyle){c.h1Font, c.h1Color, c.h1MarginTop, c.h1MarginBottom, c.h1LineHeight, c.h1TextAlign};
+    case 2:
+      return (HeadingStyle){c.h2Font, c.h2Color, c.h2MarginTop, c.h2MarginBottom, c.h2LineHeight, c.h2TextAlign};
+    case 3:
+      return (HeadingStyle){c.h3Font, c.h3Color, c.h3MarginTop, c.h3MarginBottom, c.h3LineHeight, c.h3TextAlign};
+    case 4:
+      return (HeadingStyle){c.h4Font, c.h4Color, c.h4MarginTop, c.h4MarginBottom, c.h4LineHeight, c.h4TextAlign};
+    case 5:
+      return (HeadingStyle){c.h5Font, c.h5Color, c.h5MarginTop, c.h5MarginBottom, c.h5LineHeight, c.h5TextAlign};
+    case 6:
+      return (HeadingStyle){c.h6Font, c.h6Color, c.h6MarginTop, c.h6MarginBottom, c.h6LineHeight, c.h6TextAlign};
+    default:
+      return [self styleForLevel:1];
+  }
+}
+
+@end

package/ios/renderer/HighlightRenderer.h

@@ -0,0 +1,7 @@
+#pragma once
+#import "BaseRenderer.h"
+
+extern NSString *const HighlightAttributeName;
+
+@interface HighlightRenderer : BaseRenderer
+@end

package/ios/renderer/HighlightRenderer.m

@@ -0,0 +1,33 @@
+#import "HighlightRenderer.h"
+#import "TiptapASTNode.h"
+#import "RenderContext.h"
+#import "RendererFactory.h"
+#import "StyleConfig.h"
+
+NSString *const HighlightAttributeName = @"EnrichedTiptapHighlight";
+
+@implementation HighlightRenderer
+
+#pragma mark - Rendering
+
+- (void)renderNodeContent:(TiptapASTNode *)node
+                     into:(NSMutableAttributedString *)output
+                  context:(RenderContext *)context
+{
+  NSUInteger start = output.length;
+  [_rendererFactory renderChildrenOfNode:node into:output context:context];
+
+  NSRange range = NSMakeRange(start, output.length - start);
+  if (range.length == 0)
+    return;
+
+  BlockStyle *blockStyle = [context getBlockStyle];
+  RCTUIColor *foregroundColor = [RenderContext calculateHighlightColor:[_config highlightColor]
+                                                        paragraphColor:[_config paragraphColor]
+                                                            blockColor:blockStyle.color];
+  [output addAttribute:NSForegroundColorAttributeName value:foregroundColor range:range];
+  [output addAttribute:NSBackgroundColorAttributeName value:[_config highlightBackgroundColor] range:range];
+  [output addAttribute:HighlightAttributeName value:@YES range:range];
+}
+
+@end

package/ios/renderer/LinkRenderer.h

@@ -0,0 +1,6 @@
+#import "BaseRenderer.h"
+#import "TiptapASTNode.h"
+#import "RenderContext.h"
+
+@interface LinkRenderer : BaseRenderer
+@end

package/ios/renderer/LinkRenderer.m

@@ -0,0 +1,158 @@
+#import "LinkRenderer.h"
+#import "CodeBackground.h"
+#import "ENRMLinkPillAttachment.h"
+#import "ENRMSpoilerTapUtils.h"
+#import "ENRMTextLinkAttributes.h"
+#import "FontUtils.h"
+#import "RenderContext.h"
+#import "RendererFactory.h"
+#import "StyleConfig.h"
+#import <React/RCTFont.h>
+
+#if !TARGET_OS_OSX
+static BOOL ENRMRangeHasAttribute(NSAttributedString *text, NSRange range, NSAttributedStringKey key)
+{
+  __block BOOL found = NO;
+  [text enumerateAttribute:key
+                   inRange:range
+                   options:0
+                usingBlock:^(id value, NSRange subrange, BOOL *stop) {
+                  if (value) {
+                    found = YES;
+                    *stop = YES;
+                  }
+                }];
+  return found;
+}
+
+/// Replaces the rendered link content with one attachment character and returns its range.
+static NSRange ENRMCollapseLinkIntoPill(NSMutableAttributedString *output, NSRange range, NSString *url,
+                                        LinkVariantConfig *variant, StyleConfig *config, RenderContext *context)
+{
+  LinkPillContent *content = [config linkPillContent][url];
+  BOOL hasOwnIcon = content.iconUri.length > 0;
+  // A tint set for the link wins. The variant's tint is for the variant's own icon, not for an
+  // icon supplied per link (an avatar would become a silhouette).
+  RCTUIColor *iconTint = content.iconTintColor ?: (hasOwnIcon ? nil : variant.pill.iconTintColor);
+  NSDictionary<NSAttributedStringKey, id> *attributes = [output attributesAtIndex:range.location effectiveRange:NULL];
+  ENRMLinkPillAttachment *pill = [[ENRMLinkPillAttachment alloc]
+      initWithOriginalText:[output attributedSubstringFromRange:range]
+                   variant:variant
+                     label:content.label.length > 0 ? content.label : variant.pill.label
+                   iconUri:hasOwnIcon ? content.iconUri : variant.pill.iconUri
+             iconTintColor:iconTint
+                      font:attributes[NSFontAttributeName] ?: [context getBlockStyle].cachedFont
+            requestHeaders:[config imageRequestHeaders]];
+  pill.lineHeight = [config lineHeightForLinkPill:variant.pill];
+
+  // The placeholder keeps the block context of the text it replaces. The pill draws its own
+  // background, underline and label, so inline decoration of that text must not show around it.
+  NSMutableDictionary<NSAttributedStringKey, id> *placeholder = [attributes mutableCopy];
+  [placeholder removeObjectsForKeys:@[
+    NSBackgroundColorAttributeName, NSUnderlineStyleAttributeName, NSUnderlineColorAttributeName,
+    NSStrikethroughStyleAttributeName, CodeAttributeName
+  ]];
+  placeholder[NSAttachmentAttributeName] = pill;
+  [output replaceCharactersInRange:range
+              withAttributedString:[[NSAttributedString alloc] initWithString:@"\uFFFC" attributes:placeholder]];
+  return NSMakeRange(range.location, 1);
+}
+#endif
+
+@implementation LinkRenderer
+
+#pragma mark - Rendering
+
+- (void)renderNodeContent:(TiptapASTNode *)node
+                     into:(NSMutableAttributedString *)output
+                  context:(RenderContext *)context
+{
+  BOOL recognizedLink = [node.attributes[@"recognizedLink"] isEqualToString:@"true"];
+  NSUInteger start = output.length;
+
+  // 1. Render children first to establish base attributes
+  [_rendererFactory renderChildrenOfNode:node into:output context:context];
+
+  NSRange range = NSMakeRange(start, output.length - start);
+  if (range.length == 0)
+    return;
+
+  // 2. Extract configuration
+  NSString *url = node.attributes[@"url"] ?: @"";
+  LinkVariantConfig *variant = [_config effectiveLinkVariantForURL:url];
+
+  RCTUIColor *linkColor = variant.color ?: [_config linkColor];
+  BOOL linkUnderline = variant ? variant.underline : [_config linkUnderline];
+  NSString *linkFontFamily = variant.fontFamily.length > 0 ? variant.fontFamily : [_config linkFontFamily];
+  RCTUIColor *backgroundColor = variant ? variant.backgroundColor : [_config linkBackgroundColor];
+
+  NSNumber *underlineStyle = @(linkUnderline ? NSUnderlineStyleSingle : NSUnderlineStyleNone);
+
+  // 3. Apply core link functionality (non-destructive)
+  [output addAttribute:NSLinkAttributeName value:url range:range];
+
+  // 4. Optimize visual attributes via enumeration to avoid redundant updates
+  [output enumerateAttributesInRange:range
+                             options:NSAttributedStringEnumerationLongestEffectiveRangeNotRequired
+                          usingBlock:^(NSDictionary<NSAttributedStringKey, id> *attrs, NSRange subrange, BOOL *stop) {
+                            NSMutableDictionary *newAttributes = [NSMutableDictionary dictionary];
+                            if (recognizedLink) {
+                              newAttributes[ENRMRecognizedLinkAttributeName] = @YES;
+                              newAttributes[ENRMRecognizedLinkOriginalUnderlineAttributeName] =
+                                  attrs[NSUnderlineStyleAttributeName] ?: @0;
+                            }
+
+                            // Only apply link color if the subrange isn't already colored by the link style
+                            if (linkColor && ![attrs[NSForegroundColorAttributeName] isEqual:linkColor]) {
+                              newAttributes[NSForegroundColorAttributeName] = linkColor;
+                              newAttributes[NSUnderlineColorAttributeName] = linkColor;
+                            }
+
+                            // Only update underline style if it differs from the config
+                            if (![attrs[NSUnderlineStyleAttributeName] isEqual:underlineStyle]) {
+                              newAttributes[NSUnderlineStyleAttributeName] = underlineStyle;
+                            }
+
+                            if (linkFontFamily.length > 0) {
+                              UIFont *currentFont = attrs[NSFontAttributeName];
+                              if (currentFont) {
+                                UIFont *linkFont = [RCTFont updateFont:currentFont
+                                                            withFamily:linkFontFamily
+                                                                  size:nil
+                                                                weight:nil
+                                                                 style:nil
+                                                               variant:nil
+                                                       scaleMultiplier:1.0];
+                                if (linkFont && ![currentFont isEqual:linkFont]) {
+                                  newAttributes[NSFontAttributeName] = linkFont;
+                                }
+                              }
+                            }
+
+                            if (newAttributes.count > 0) {
+                              [output addAttributes:newAttributes range:subrange];
+                            }
+                          }];
+
+#if !TARGET_OS_OSX
+  // A pill is one line and one unit: links holding attachments or a line break stay ordinary links.
+  // So do links holding a spoiler, whose hidden text the label would show.
+  BOOL willBePill =
+      variant.pill != nil && !ENRMRangeHasAttribute(output, range, NSAttachmentAttributeName) &&
+      !ENRMRangeHasAttribute(output, range, SpoilerAttributeName) &&
+      [output.string rangeOfCharacterFromSet:NSCharacterSet.newlineCharacterSet options:0 range:range].location ==
+          NSNotFound;
+#else
+  BOOL willBePill = NO;
+#endif
+  if (backgroundColor && !willBePill)
+    [output addAttribute:NSBackgroundColorAttributeName value:backgroundColor range:range];
+
+#if !TARGET_OS_OSX
+  if (willBePill)
+    range = ENRMCollapseLinkIntoPill(output, range, url, variant, _config, context);
+#endif
+  [context registerLinkRange:range url:url];
+}
+
+@end

package/ios/renderer/ListItemRenderer.h

@@ -0,0 +1,24 @@
+#import "BaseRenderer.h"
+#import "RenderContext.h"
+
+extern NSString *const ListDepthAttribute;
+extern NSString *const ListTypeAttribute;
+extern NSString *const ListItemNumberAttribute;
+extern NSString *const ListItemMarkerStartAttribute;
+
+extern NSString *const TaskItemAttribute;
+extern NSString *const TaskCheckedAttribute;
+extern NSString *const TaskIndexAttribute;
+
+@interface ENRMListMarkerDescriptor : NSObject
+@property (nonatomic, assign) BOOL isTask;
+@property (nonatomic, assign) BOOL isChecked;
+@property (nonatomic, assign) NSInteger taskIndex;
+@property (nonatomic, assign) ListType listType;
+@property (nonatomic, assign) NSInteger number;
+@property (nonatomic, assign) NSInteger depth;
+@property (nonatomic, assign) CGFloat indent;
+@end
+
+@interface ListItemRenderer : BaseRenderer
+@end